How fingerprintjs/fingerprint-pro-akamai-proxy-integration works
Project Type and Purpose
• This is an open-source integration tool (“Fingerprint Pro Akamai Proxy Integration”) written in TypeScript/Node.js that generates Akamai Property Manager rules and patch payloads.
• It helps enterprise customers proxy identification and agent-download requests from their website through Akamai to Fingerprint’s APIs, via Terraform or the Akamai Property Manager API.
File Structure Analysis
• Top-level config: .eslintrc.json, tsconfig.json, .prettierrc, .releaserc.json, package.json, pnpm-lock.yaml.
• Source code:
• generators/ — TS modules to programmatically build Terraform rules or patch bodies.
• scripts/ — utility scripts to build, test, and apply rules (e.g., deployRules.ts, createProperty.ts, clearProperties.ts).
• assets/ — JSON templates (rulesTemplate.json, variables.json, patch bodies) for merging with generated output.
• build.ts — orchestrates local builds (dist/terraform/json, dist/patch-body).
• Tests: test/e2e, playwright.config.ts, scripts/mockTests.ts — E2E and mock tests against a local Akamai‐like environment.
• CI/CD: .github/workflows/* (lint, tests, release), husky hooks, commitlint.
• README.md + examples.tf — user‐facing documentation and code snippets for Terraform integration.
README Insights
• Two installation mechanisms: Terraform template integration and Akamai Property Manager API patch.
• Emphasis on generating JSON artifacts that the customer’s IaC or API tooling consumes.
• Build commands (pnpm build --type terraform or --type patchBody) produce distributable JSON and example.tf.
Detail
• Configuration parameters: integration-path, agent-path, result-path, proxy-secret.
• CI steps: lint → test → build → release.
• Versioning flow: tag → build → release → consumer pin version.