cdp-edge 2.5.9 → 2.6.1

package/extracted-skill/tracking-events-generator/integration-test.js

@@ -1,4 +1,4 @@
-/**
+/**
  * INTEGRATION TEST - CDP Edge (Quantum Tier)
  *
  * Sistema de validação end-to-end do Premium Tracking Intelligence
@@ -13,8 +13,8 @@ const isBrowser = typeof window !== 'undefined';
 // ── Configurações de Teste ─────────────────────────────
 
 const TEST_CONFIG = {
-  endpoint: '/api/tracking',
-  healthEndpoint: '/api/health',
+  endpoint: '/track',
+  healthEndpoint: '/health',
   timeout: 10000, // 10 segundos
   testEvents: [
     'PageView',

package/extracted-skill/tracking-events-generator/knowledge-base.md

@@ -1523,7 +1523,7 @@ Obrigado        → PageView (+ Lead apenas se não foi disparado no formulário
 
 ## PASSO 6 — MODO SERVER-SIDE (quando solicitado)
 
-> **Quando usar:** o usuário pede tracking server-side, CAPI, Measurement Protocol, "evitar bloqueio de adblocker", ou quer o endpoint `/api/tracking`.
+> **Quando usar:** o usuário pede tracking server-side, CAPI, Measurement Protocol, "evitar bloqueio de adblocker", ou quer o endpoint `/track`.
 
 ### Por que server-side existe
 
@@ -1537,9 +1537,9 @@ Browser (tracking.js)
   ├── gera event_id único
   ├── lê cookies: _fbp, _fbc, _ttp, _ga
   ├── captura UTMs da URL (utm_source, utm_medium, utm_campaign, utm_content, utm_term)
-  └── POST /api/tracking → { event_name, event_id, cookies, utms, user_data, page_url }
+  └── POST /track → { event_name, event_id, cookies, utms, user_data, page_url }
 
-Servidor Node.js (/api/tracking)
+Servidor Node.js (/track)
   ├── recebe payload do browser
   ├── adiciona: IP real, User-Agent do header
   ├── SHA256 hash: email, phone, nome, cidade, estado, CEP, país
@@ -1615,7 +1615,7 @@ const getCookies = () => ({
 const sendServerEvent = (eventName, eventId, payload = {}) => {
   if (!isBrowser) return;
   // Não usar await — deixar rodar em paralelo com o event client-side
-  fetch('/api/tracking', {
+  fetch('/track', {
     method: 'POST',
     headers: { 'Content-Type': 'application/json' },
     body: JSON.stringify({
@@ -1662,12 +1662,12 @@ export const trackLead = async (params = {}) => {
 
 ---
 
-### PASSO 6.3 — Endpoint `/api/tracking` (Node.js / Next.js API Route)
+### PASSO 6.3 — Endpoint `/track` (Node.js / Next.js API Route)
 
 ```js
-// Node.js Express: src/api/tracking.js
-// Next.js App Router: app/api/tracking/route.js
-// Next.js Pages Router: pages/api/tracking.js
+// Node.js Express: src/track.js
+// Next.js App Router: app/track/route.js
+// Next.js Pages Router: pages/track.js
 
 import crypto from 'crypto';
 import CONFIG from '../tracking/tracking.config.js';  // ajustar path
@@ -1984,7 +1984,7 @@ O CDP Edge recomenda o uso de **Cloudflare Workers (Quantum Tier)** como endpoin
 
 ## PASSO 6.6 — Cloudflare Workers + D1 (Full Core Tracking)
 
-> **Quando usar:** O padrão ouro do CDP Edge. Roda o endpoint `/api/tracking` no Cloudflare Workers e salva todos os eventos e perfis no banco D1 para atribuição precisa.
+> **Quando usar:** O padrão ouro do CDP Edge. Roda o endpoint `/track` no Cloudflare Workers e salva todos os eventos e perfis no banco D1 para atribuição precisa.
 
 ### Vantagens da Infraestrutura Cloudflare Native
 
@@ -2465,7 +2465,7 @@ wrangler deploy
 # URL gerada: https://cdp-edge-tracking.SEU_USUARIO.workers.dev
 ```
 
-> Após o deploy, o Worker fica disponível em `https://cdp-edge-tracking.SEU_USUARIO.workers.dev`. Para usar `/api/tracking` no site, criar um **Custom Domain** nas configurações do Worker ou usar a URL completa.
+> Após o deploy, o Worker fica disponível em `https://cdp-edge-tracking.SEU_USUARIO.workers.dev`. Para usar `/track` no site, criar um **Custom Domain** nas configurações do Worker ou usar a URL completa.
 
 ---
 
@@ -2474,7 +2474,7 @@ wrangler deploy
 Se o site e o Worker estão em domínios diferentes, mudar a URL no `tracking.js`:
 
 ```js
-// Em vez de '/api/tracking' (mesmo domínio — Next.js / Vite server)
+// Em vez de '/track' (mesmo domínio — Next.js / Vite server)
 // usar a URL do Worker:
 const TRACKING_ENDPOINT = 'https://cdp-edge-tracking.SEU_USUARIO.workers.dev';
 
@@ -2496,7 +2496,7 @@ const sendServerEvent = (eventName, eventId, payload = {}) => {
 };
 ```
 
-> Se o site rodar em **Cloudflare Pages**, usar `functions/api/tracking.js` — o código do Worker é idêntico, só muda o handler para `export async function onRequestPost({ request, env, waitUntil })`.
+> Se o site rodar em **Cloudflare Pages**, usar `functions/track.js` — o código do Worker é idêntico, só muda o handler para `export async function onRequestPost({ request, env, waitUntil })`.
 
 ---
 

package/extracted-skill/tracking-events-generator/models/checkout-proprio.md

@@ -31,7 +31,7 @@ Este script captura dados à medida que o usuário preenche o formulário.
 ```javascript
 <script>
 (function() {
-  const WORKER_URL = 'https://api.seusite.com/api/tracking';
+  const WORKER_URL = 'https://api.seusite.com/track';
   
   // Atualização de identidade ao sair do campo (Blur Event)
   const inputs = document.querySelectorAll('input[type="email"], input[type="tel"]');

package/extracted-skill/tracking-events-generator/models/multi-step-checkout.md

@@ -50,7 +50,7 @@ Step 4: Confirmação / Obrigado
 <script src="/js/cdpTrack.js" async></script>
 <script>
   window.cdpConfig = {
-    workerUrl: '/api/tracking',  // Same-Domain (furtivo)
+    workerUrl: '/track',  // Same-Domain (furtivo)
     metaId: 'SEU_PIXEL_ID',
     ga4Id: 'G-XXXXXXXX',
     tiktokId: 'C4XXXXXXXXXXXXXXX',
@@ -204,7 +204,7 @@ document.addEventListener('visibilitychange', async () => {
     const cdp_uid = document.cookie.match(/cdp_uid=([^;]+)/)?.[1] || '';
 
     // Usa navigator.sendBeacon para garantir envio mesmo se browser encerrar
-    navigator.sendBeacon('/api/tracking', JSON.stringify({
+    navigator.sendBeacon('/track', JSON.stringify({
       event_name: 'CheckoutAbandonment',
       cdp_uid,
       step: checkoutState.step,
@@ -236,7 +236,7 @@ export default {
       return new Response(null, { headers: cors });
     }
 
-    if (url.pathname === '/api/tracking') {
+    if (url.pathname === '/track') {
       return handleTracking(request, env, ctx);
     }
 
@@ -589,7 +589,7 @@ CREATE INDEX IF NOT EXISTS idx_events_created ON events_log(created_at);
 - [ ] CheckoutAbandonment usa `navigator.sendBeacon` para garantir envio
 
 ### Cloudflare Worker
-- [ ] Endpoint `/api/tracking` configurado como Route no Cloudflare
+- [ ] Endpoint `/track` configurado como Route no Cloudflare
 - [ ] Identity Graph atualizado progressivamente conforme usuário preenche campos
 - [ ] Meta CAPI v25.0 endpoint correto
 - [ ] TikTok Events API v1.3 endpoint correto

package/extracted-skill/tracking-events-generator/models/reddit/conversions-api-template.js

@@ -183,7 +183,7 @@ function generateEventId() {
  * @param {Object} data - Dados completos do evento
  */
 async function sendToServer(eventName, data) {
-  const serverUrl = '/api/track'; // ou URL configurada
+  const serverUrl = '/track'; // ou URL configurada
 
   await fetch(serverUrl, {
     method: 'POST',

package/extracted-skill/tracking-events-generator/models/scenarios/behavior-engine.js

@@ -299,7 +299,7 @@ const BehaviorEngine = {
             fields_count: formInteracted.size,
             meta_intensity: 'medium',
           });
-          navigator.sendBeacon('/api/tracking', new Blob([data], { type: 'application/json' }));
+          navigator.sendBeacon('/track', new Blob([data], { type: 'application/json' }));
         }
       }
     });

package/extracted-skill/tracking-events-generator/models/scenarios/sales-page-logic.md

@@ -19,7 +19,7 @@ Mede a eficácia do vídeo de vendas antes do botão de compra aparecer.
 *   **Ação**: Disparar `ViewContent` (25/50/75) e `AddToCart` (100% ou clique no botão).
 
 ### 3. Adblock Immunity (Stealth Tracking)
-Utiliza rotas no mesmo domínio (ex: `/api/tracking`) para garantir que o script de rastreamento não seja bloqueado por uBlock ou Ghostery.
+Utiliza rotas no mesmo domínio (ex: `/track`) para garantir que o script de rastreamento não seja bloqueado por uBlock ou Ghostery.
 
 ---
 

package/extracted-skill/tracking-events-generator/models/trafego-direto.md

@@ -34,7 +34,7 @@
 ┌─────────────────────────────────────────────────────────────┐
 │ Cloudflare Worker (Quantum Tier)                            │
 │
-│  Endpoint: /api/tracking (Same-Domain)                 │
+│  Endpoint: /track (Same-Domain)                 │
 │  - Recebe eventos do browser                            │
 │  - Salva sessão no D1 (fbp, fbc, ttp, UTMs)       │
 │  - Despacha para APIs: Meta, GA4, TikTok              │
@@ -78,7 +78,7 @@
 <script src="/js/cdpTrack.js" async></script>
 <script>
   window.cdpConfig = {
-    workerUrl: '/api/tracking',  // Same-Domain (furtivo)
+    workerUrl: '/track',  // Same-Domain (furtivo)
     metaId: 'SEU_PIXEL_ID',
     ga4Id: 'G-XXXXXXXX',
     tiktokId: 'C4XXXXXXXXXXXXXXX',
@@ -182,7 +182,7 @@ export default {
     }
 
     // Endpoint principal de tracking
-    if (url.pathname === '/api/tracking') {
+    if (url.pathname === '/track') {
       return handleTracking(request, env, ctx);
     }
 
@@ -500,13 +500,13 @@ CREATE INDEX IF NOT EXISTS idx_fbc ON identity_graph(fbc);
 
 ### Browser
 - [ ] cdp_uid gerado no primeiro acesso e persistido por 1 ano
-- [ ] PageView disparado via Fetch para `/api/tracking`
+- [ ] PageView disparado via Fetch para `/track`
 - [ ] InitiateCheckout disparado antes do redirecionamento
 - [ ] cdp_uid injetado na URL do checkout (xcod/sck/src)
 - [ ] UTMs capturados e salvos no D1
 
 ### Cloudflare Worker
-- [ ] Endpoint `/api/tracking` configurado como Route no Cloudflare
+- [ ] Endpoint `/track` configurado como Route no Cloudflare
 - [ ] Endpoint `/api/wh/{plataforma}` para webhooks
 - [ ] Salvar sessão no D1 com todos os cookies
 - [ ] D1 lookup pelo cdp_uid ao receber webhook
@@ -527,13 +527,13 @@ CREATE INDEX IF NOT EXISTS idx_fbc ON identity_graph(fbc);
 ```
 1. Visitante acessa a página de vendas
    └── JS: gera cdp_uid → salva cookie (1 ano)
-   └── JS: dispara PageView → /api/tracking
+   └── JS: dispara PageView → /track
    └── Worker: salva sessão no D1 (fbp, fbc, ttp, UTMs, IP)
    └── Worker: dispatch → Meta, GA4, TikTok (PageView)
 
 2. Visitante clica no botão de compra
    └── JS: intercepta clique → previne redirecionamento
-   └── JS: dispara InitiateCheckout → /api/tracking
+   └── JS: dispara InitiateCheckout → /track
    └── Worker: atualiza sessão no D1
    └── Worker: dispatch → Meta, GA4, TikTok (InitiateCheckout)
    └── JS: injeta cdp_uid na URL (xcod/sck/src)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cdp-edge",
-  "version": "2.5.9",
+  "version": "2.6.1",
   "description": "CDP Edge - Quantum Tracking - Sistema multi-agente para tracking digital Cloudflare Native (Workers + D1)",
   "main": "dist/index.js",
   "type": "module",
@@ -24,7 +24,7 @@
     "build": "node build.js",
     "dev": "node build.js --watch",
     "test": "node test.js",
-    "test:unit": "node tests/unit/normalization.test.js && node tests/unit/hashing.test.js && node tests/unit/deduplication.test.js && node tests/unit/payload-validation.test.js && node tests/unit/new-features.test.js && node tests/unit/utils.test.js",
+    "test:unit": "node tests/unit/normalization.test.js && node tests/unit/hashing.test.js && node tests/unit/deduplication.test.js && node tests/unit/payload-validation.test.js && node tests/unit/new-features.test.js && node tests/unit/utils.test.js && node tests/unit/contracts.test.js",
     "test:unit:normalize": "node tests/unit/normalization.test.js",
     "test:unit:hash": "node tests/unit/hashing.test.js",
     "test:unit:dedup": "node tests/unit/deduplication.test.js",

package/server-edge-tracker/.client.env.example

@@ -12,3 +12,8 @@ SITE_DOMAIN=seudominio.com.br
 META_PIXEL_ID=
 GA4_MEASUREMENT_ID=
 TIKTOK_PIXEL_ID=
+
+# ZapMan SDR (opcional)
+ZAPMAN_API_URL=
+ZAPMAN_CRM_INSTANCE=
+ZAPMAN_WEBHOOK_URL=

package/server-edge-tracker/deploy-client.cjs

@@ -1,39 +1,39 @@
 #!/usr/bin/env node
 /**
- * CDP Edge — deploy-client.js
+ * CDP Edge - deploy-client.js
  *
- * Deploy do Worker com variáveis reais do cliente, sem commitar credenciais no repo.
- * Lê de .client.env (gitignored) e gera um wrangler.deploy.toml temporário.
+ * Deploy the Worker with client-specific values without committing credentials.
+ * Reads .client.env (gitignored) and writes a temporary wrangler.deploy.toml.
  *
- * Uso:
- *   node deploy-client.js           → deploy completo
- *   node deploy-client.js --dry-run → valida sem subir ao Cloudflare
+ * Usage:
+ *   node deploy-client.cjs           -> full deploy
+ *   node deploy-client.cjs --dry-run -> validate without deploying
  *
  * Setup:
  *   cp .client.env.example .client.env
- *   # edite .client.env com os valores do cliente
- *   node deploy-client.js
+ *   # edit .client.env with the client values
+ *   node deploy-client.cjs --dry-run
  */
 
-const fs   = require('fs');
+const fs = require('fs');
 const path = require('path');
 const { execSync } = require('child_process');
 
-const ROOT    = __dirname;
-const TOML    = path.join(ROOT, 'wrangler.toml');
-const DEPLOY  = path.join(ROOT, 'wrangler.deploy.toml');
-const ENV     = path.join(ROOT, '.client.env');
+const ROOT = __dirname;
+const TOML = path.join(ROOT, 'wrangler.toml');
+const DEPLOY = path.join(ROOT, 'wrangler.deploy.toml');
+const ENV = path.join(ROOT, '.client.env');
 const DRY_RUN = process.argv.includes('--dry-run');
 
-// ── Carregar .client.env ──────────────────────────────────────────────────────
 if (!fs.existsSync(ENV)) {
-  console.error('\n❌  .client.env não encontrado.');
-  console.error('   cp .client.env.example .client.env  e preencha os valores do cliente.\n');
+  console.error('\nERROR: .client.env not found.');
+  console.error('Run: cp .client.env.example .client.env');
+  console.error('Then fill in the client values.\n');
   process.exit(1);
 }
 
 const env = {};
-fs.readFileSync(ENV, 'utf8').split('\n').forEach(line => {
+fs.readFileSync(ENV, 'utf8').split('\n').forEach((line) => {
   const trimmed = line.trim();
   if (!trimmed || trimmed.startsWith('#')) return;
   const [key, ...rest] = trimmed.split('=');
@@ -41,36 +41,52 @@ fs.readFileSync(ENV, 'utf8').split('\n').forEach(line => {
 });
 
 const required = ['DATABASE_ID', 'SITE_DOMAIN'];
-const missing  = required.filter(k => !env[k]);
+const missing = required.filter((key) => !env[key]);
 if (missing.length > 0) {
-  console.error(`\n❌  Variáveis obrigatórias faltando no .client.env: ${missing.join(', ')}\n`);
+  console.error(`\nERROR: missing required .client.env values: ${missing.join(', ')}\n`);
   process.exit(1);
 }
 
-// ── Substituir placeholders no wrangler.toml → wrangler.deploy.toml ───────────
+const invalid = [];
+if (env.DATABASE_ID === 'SEU_DATABASE_ID') invalid.push('DATABASE_ID');
+if (env.SITE_DOMAIN === 'SEU_DOMINIO' || env.SITE_DOMAIN === 'seudominio.com.br') {
+  invalid.push('SITE_DOMAIN');
+}
+
+if (invalid.length > 0) {
+  console.error(`\nERROR: placeholder values remain in .client.env: ${invalid.join(', ')}\n`);
+  process.exit(1);
+}
+
+function tomlString(value) {
+  return String(value || '').replace(/\\/g, '\\\\').replace(/"/g, '\\"');
+}
+
 let toml = fs.readFileSync(TOML, 'utf8');
 
 toml = toml
-  .replace(/SEU_DATABASE_ID/g,  env.DATABASE_ID)
-  .replace(/SEU_DOMINIO/g,       env.SITE_DOMAIN)
-  .replace(/META_PIXEL_ID\s*=\s*""/,      `META_PIXEL_ID      = "${env.META_PIXEL_ID      || ''}"`)
-  .replace(/GA4_MEASUREMENT_ID\s*=\s*""/,  `GA4_MEASUREMENT_ID = "${env.GA4_MEASUREMENT_ID || ''}"`)
-  .replace(/TIKTOK_PIXEL_ID\s*=\s*""/,     `TIKTOK_PIXEL_ID    = "${env.TIKTOK_PIXEL_ID    || ''}"`);
+  .replace(/database_id\s*=\s*"[^"]*"/, `database_id  = "${tomlString(env.DATABASE_ID)}"`)
+  .replace(/SEU_DATABASE_ID/g, tomlString(env.DATABASE_ID))
+  .replace(/SEU_DOMINIO/g, tomlString(env.SITE_DOMAIN))
+  .replace(/META_PIXEL_ID\s*=\s*"[^"]*"/, `META_PIXEL_ID        = "${tomlString(env.META_PIXEL_ID)}"`)
+  .replace(/GA4_MEASUREMENT_ID\s*=\s*"[^"]*"/, `GA4_MEASUREMENT_ID   = "${tomlString(env.GA4_MEASUREMENT_ID)}"`)
+  .replace(/TIKTOK_PIXEL_ID\s*=\s*"[^"]*"/, `TIKTOK_PIXEL_ID      = "${tomlString(env.TIKTOK_PIXEL_ID)}"`)
+  .replace(/ZAPMAN_API_URL\s*=\s*"[^"]*"/, `ZAPMAN_API_URL       = "${tomlString(env.ZAPMAN_API_URL)}"`)
+  .replace(/ZAPMAN_CRM_INSTANCE\s*=\s*"[^"]*"/, `ZAPMAN_CRM_INSTANCE  = "${tomlString(env.ZAPMAN_CRM_INSTANCE)}"`)
+  .replace(/ZAPMAN_WEBHOOK_URL\s*=\s*"[^"]*"/, `ZAPMAN_WEBHOOK_URL   = "${tomlString(env.ZAPMAN_WEBHOOK_URL)}"`);
 
 fs.writeFileSync(DEPLOY, toml);
 
-// ── Executar wrangler deploy ──────────────────────────────────────────────────
 const cmd = `wrangler deploy --config wrangler.deploy.toml${DRY_RUN ? ' --dry-run' : ''}`;
-console.log(`\n🚀  ${DRY_RUN ? '[DRY-RUN] ' : ''}Deploying com config do cliente...\n`);
+console.log(`\n${DRY_RUN ? '[DRY-RUN] ' : ''}Deploying with client config...\n`);
 
 try {
   execSync(cmd, { stdio: 'inherit', cwd: ROOT });
-  console.log(`\n✅  Deploy ${DRY_RUN ? '(dry-run) ' : ''}concluído.\n`);
+  console.log(`\nDeploy ${DRY_RUN ? '(dry-run) ' : ''}completed.\n`);
 } catch (err) {
-  console.error('\n❌  Deploy falhou.\n');
+  console.error('\nDeploy failed.\n');
   process.exit(1);
 } finally {
-  // sempre remove o arquivo temporário
   if (fs.existsSync(DEPLOY)) fs.unlinkSync(DEPLOY);
-  console.log('🧹  wrangler.deploy.toml removido.\n');
+  console.log('Removed temporary wrangler.deploy.toml.\n');
 }