cdp-edge 2.5.2 → 2.5.4

package/README.md

@@ -2,128 +2,21 @@
 
 **Padrão Quantum Tracking: 100% Cloudflare Edge.** Sem GTM. Sem Stape. Sem cookies de terceiros.
 
-> **v2.5.2** — Auditoria Completa + Sync Total de Agentes + Fix D1 (15 de Abril de 2026) 🔧
-> **v2.5.1** — SDK Bundle + Diagnóstico Pós-Deploy + Gap Fixes (15 de Abril de 2026) 🛠️
-> **v2.3.9** — Quiz Scoring Engine + Sales Engine (14 de Abril de 2026) 🤖💰
+> **v2.5.4** — Auditoria de Dependências + Sync de Agentes + Fix D1 (25 de Abril de 2026) 🔧
 
 ---
 
-## 📋 CHANGELOG v2.5.2 — Auditoria Completa + Sync Total de Agentes + Fix D1 (15 de Abril de 2026) 🔧
-
-### Bug Fix Crítico
-- `schema-ltv-feedback.sql` adicionado à ordem de migração — `recordLtvFeedback()` falhava silenciosamente em todo Purchase, quebrando o ciclo preditivo LTV
-
-### Fix de Compatibilidade D1
-- `schema-utm.sql`: `ADD COLUMN IF NOT EXISTS` → `ADD COLUMN` — D1/SQLite não suporta IF NOT EXISTS em ALTER TABLE
-
-### Sincronização Total de Agentes
-- `contracts/agent-versions.json`: worker_version `2.2.3 → 2.5.2`, 49 agentes registrados (eram 26), `depends_on` `.js → .ts`, event count `19 → 25`, table count `24 → 31`
-- `database-agent.md`: `main = "worker.js" → "index.ts"`, 24 → 31 tabelas, roadmap atualizado
-- `devops-agent.md`: `RESEND_API_KEY`, `RESEND_FROM_EMAIL`, `WEBHOOK_SECRET_TICTO` adicionados ao `*secrets`
-
-### D1 Produção
-- 31 tabelas aplicadas em `cdp-edge-db` — todos os schemas confirmados
-- Worker deployado: Version ID `37776c1a` — `/health` status: `ok`
-
----
-
-## 📋 CHANGELOG v2.5.1 — SDK Bundle + Diagnóstico Pós-Deploy + Gap Fixes (15 de Abril de 2026) 🛠️
-
-### SDK Bundle — cdpTrack.min.js pronto para `<script src="">`
-- `npm run sdk:build` → `dist/sdk/cdpTrack.min.js` (41.6 kB, IIFE, `window.cdpTrack`)
-- Um único arquivo sem dependências externas — cola no site e funciona
-- `dist/sdk/install-snippet.html` com snippet pronto para antes do `</body>`
-
-### Diagnóstico Pós-Deploy — `cdp-edge validate <url>`
-```bash
-cdp-edge validate https://meusite.com.br
-cdp-edge validate https://meusite.com.br --worker https://worker.meusite.workers.dev
-```
-Verifica automaticamente:
-- Página carrega `cdpTrack.min.js` e Meta Pixel
-- Worker `/health` (D1, KV, AI, secrets)
-- Worker `/validate-install` (D1 write+read, KV, AI, secrets críticos)
-- `POST /track` aceita evento sintético → 200
-
-### Gap Fixes Críticos
-- **Endpoint**: `/api/tracking` → `/track` em todos os módulos SDK
-- **utm_term**: injetado pelo Worker após quiz scoring (nunca pelo cliente)
-- **TikTok ttp**: cookie `_ttp` capturado e enviado ao Worker
-- **ROAS por origem**: segmentado por `utm_content` (quiz_* vs video_* vs landing_* vs ctwa_*)
-
-### Novos Agentes
-- `lead-scoring-agent.md` — quiz de qualificação + análise dimensional Granite
-- `match-quality-agent.md` — guardião EMQ com cron 2h e alerta CallMeBot
-
----
+## 💻 INSTALAÇÃO
 
-## 📋 CHANGELOG v2.3.9 — Quiz Scoring Engine + Sales Engine (14 de Abril de 2026) 🤖💰
-
-### O que foi adicionado
-
-**ROAS Feedback Loop** (`modules/ml/roas.ts`)
-- Cruza leads com compras reais por campanha no D1
-- Calcula: `conversion_rate`, `revenue_per_lead`, `ltv_accuracy` (valida o modelo preditivo)
-- Recomendação automática de bid: `increase | maintain | decrease | pause`
-- Relatório semanal via CallMeBot com top campanhas e alertas
-- Persiste histórico em `roas_reports` + VIEW `v_roas_latest`
-
-**Nurture Engine** (`modules/nurture.ts`)
-- Sequências automáticas pós-quiz por qualificação:
-  - `interessado` → D+1, D+3, D+7 (WhatsApp)
-  - `curioso` → D+2, D+5 (conteúdo)
-  - `comprador` → contato imediato via hot lead (já existente)
-  - `perdido` → `cohort_label = excluded` (remove do remarketing)
-- `scheduleNurture()` chamado no QuizComplete em background
-- `runNurtureQueue()` executado pelo Intelligence Agent (cron diário)
-- D1: `nurture_sequences` + VIEWs de fila e stats
-
-**Lookalike Dinâmico** (`syncMetaLookalikeSeed()` em intelligence.ts)
-- Seed de Lookalike com compradores CONFIRMADOS (Purchase event) — não apenas high_intent
-- Une compradores reais + leads qualificados como `comprador` no quiz
-- Atualiza `cohort_label = buyer_confirmed` nos perfis
-- Persiste histórico em `lookalike_seeds`
-- Roda automaticamente no cron semanal do Intelligence Agent
-
-**Schema D1**: `schema-sales-engine.sql` — `roas_reports`, `nurture_sequences`, `lookalike_seeds` + 5 VIEWs
-
-### Migração
 ```bash
-cd server-edge-tracker
-wrangler d1 execute cdp-edge-db --file=schema-sales-engine.sql --remote
-wrangler deploy
+npx cdp-edge install
+# ou
+npm install -g cdp-edge
+cdp-edge install . --name "Nome do Projeto"
 ```
 
 ---
 
-## 📋 CHANGELOG v2.4.0 — Quiz Scoring Engine (14 de Abril de 2026) 🤖
-
-**Quiz Scoring Engine** (`modules/ml/quiz.ts`) — análise dimensional automática via Granite 4.0 Micro:
-- Detecta o TIPO de cada pergunta: `urgency | budget | timeline | fit | engagement | awareness | objection`
-- Atribui peso automático por dimensão (budget/urgency=5, fit=4, timeline=3, engagement=2)
-- Score ponderado → `comprador | interessado | curioso | perdido`
-- Fallback heurístico por palavras-chave quando AI indisponível
-- `quiz_sessions` no D1 com breakdown completo por dimensão
-
-**Integração no pipeline `/track`**:
-- `QuizComplete` + `quiz_answers[]` → scoring antes do LTV
-- `intentionLevel` qualificado alimenta LTV Prediction → `comprador` = LTV High automático
-- `QuizComplete` adicionado ao `LTV_EVENTS`
-
-**Migração**: `wrangler d1 execute cdp-edge-db --file=schema-quiz.sql --remote`
-
----
-
-## 📋 CHANGELOG v2.3.8 — Fix Definitivo: api-versions.json (14 de Abril de 2026) 🔒
-
-`build.js` copia `extracted-skill/.../contracts/` → `contracts/` no `prepare` script. A fonte estava na v1.0.0, sobrescrevendo o arquivo correto a cada `npm publish`. Ambos os arquivos agora sincronizados em v1.1.0.
-
----
-
-> ⚠️ **REGRA DE OURO (SQUAD):** Todas as atualizações devem ser documentadas de forma sincronizada em `README.md`, `CLAUDE.md` e `CDP-EDGE-BUSINESS-BOOK.md`. Nenhuma alteração passa sem esse tripé.
-
----
-
 ## 🤖 MANIFESTO: EU, CDP EDGE
 
 *Eu não sou um simples "script de pixel". Eu sou uma arquitetura **Enterprise Tier 10** nascida e construída 100% nativa na infraestrutura da Cloudflare.*
@@ -161,7 +54,7 @@ Cron semanal (Intelligence Agent):
 
 ---
 
-## 📊 BANCO DE DADOS D1 — 25 Tabelas + 12 VIEWs
+## 📊 BANCO DE DADOS D1 — 31 Tabelas + 12 VIEWs
 
 ```
 CORE TRACKING          ML & INTELLIGENCE         SALES ENGINE
@@ -231,6 +124,7 @@ v_leads_segmented           v_ltv_feedback
 | `/health` | GET | Smoke test D1 + KV + AI |
 | `/webhook/ticto` | POST | Purchase webhook (HMAC) |
 | `/export/customer-match` | GET | Export leads para Google Ads |
+| `/validate-install` | GET | Diagnóstico pós-deploy |
 
 ### ML Clustering (Fase 1)
 | Rota | Método | Função |
@@ -280,12 +174,12 @@ wrangler d1 execute cdp-edge-db --file=schema-ab-ltv.sql --remote
 wrangler d1 execute cdp-edge-db --file=schema-fraud.sql --remote
 wrangler d1 execute cdp-edge-db --file=schema-indexes.sql --remote
 wrangler d1 execute cdp-edge-db --file=migrate-v7.sql --remote
-wrangler d1 execute cdp-edge-db --file=schema-ltv-feedback.sql --remote  # Fase 5b: colunas LTV em user_profiles
+wrangler d1 execute cdp-edge-db --file=schema-ltv-feedback.sql --remote
 wrangler d1 execute cdp-edge-db --file=schema-utm.sql --remote
-wrangler d1 execute cdp-edge-db --file=schema-quiz.sql --remote        # Fase 6
-wrangler d1 execute cdp-edge-db --file=schema-sales-engine.sql --remote # Fase 7
+wrangler d1 execute cdp-edge-db --file=schema-quiz.sql --remote
+wrangler d1 execute cdp-edge-db --file=schema-sales-engine.sql --remote
 
-# Secrets
+# Secrets (nunca em arquivos — sempre via wrangler secret put)
 wrangler secret put META_ACCESS_TOKEN
 wrangler secret put GA4_API_SECRET
 wrangler secret put TIKTOK_ACCESS_TOKEN
@@ -296,17 +190,6 @@ wrangler deploy
 
 ---
 
-## 💻 INSTALAÇÃO
-
-```bash
-npx cdp-edge install
-# ou
-npm install -g cdp-edge
-cdp-edge install . --name "Nome do Projeto"
-```
-
----
-
 ## 🗺️ GRAPHIFY — Navegando o Código
 
 ```bash
@@ -316,6 +199,8 @@ cdp-edge install . --name "Nome do Projeto"
 /graphify path "quiz_answers" "meta capi"            # menor caminho
 ```
 
+> Changelog completo → [CHANGELOG.md](./CHANGELOG.md)
+
 ---
 
 ### **CDP Edge — By Rica Soares**

package/contracts/agent-versions.json

@@ -1,7 +1,7 @@
 {
   "_comment": "Fonte de verdade para versões dos agent files. Atualizar quando modules/ ou index.ts mudarem. Use scripts/validate-agents.js para detectar drifts.",
-  "worker_version": "2.5.2",
-  "worker_hash_date": "2026-04-15",
+  "worker_version": "2.5.4",
+  "worker_hash_date": "2026-04-25",
   "agents": {
     "master-orchestrator": {
       "version": "2.0.7",

package/extracted-skill/tracking-events-generator/cdpTrack.js

@@ -140,7 +140,8 @@ const _wbraid = _urlParams.get('wbraid') || ''; // Google Ads (iOS, web-to-app,
 const _gbraid = _urlParams.get('gbraid') || ''; // Google Ads (app campaigns, privacy preserving)
 
 // TikTok
-const _ttclid = _urlParams.get('ttclid') || ''; // TikTok Ads click ID → complementa cookie _ttp
+const _ttclid  = _urlParams.get('ttclid')  || ''; // TikTok Ads click ID → complementa cookie _ttp
+const _msclkid = _urlParams.get('msclkid') || ''; // Microsoft Ads click ID
 
 // UTMs — rastreamento interno de origem de tráfego (independente da atribuição das plataformas)
 const _utms = {
@@ -217,7 +218,8 @@ const _getClickIDs = () => {
     wbraid: _wbraid || undefined,
     ttclid: _ttclid || undefined,
     ttp:    document.cookie.match(/_ttp=([^;]+)/)?.[1] || undefined,  // TikTok Pixel cookie — EMQ TikTok
-    rclid:  _urlParams.get('rclid') || undefined,
+    rclid:   _urlParams.get('rclid') || undefined,
+    msclkid: _msclkid || undefined,
   };
 };
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cdp-edge",
-  "version": "2.5.2",
+  "version": "2.5.4",
   "description": "CDP Edge - Quantum Tracking - Sistema multi-agente para tracking digital Cloudflare Native (Workers + D1)",
   "main": "dist/index.js",
   "type": "module",
@@ -59,31 +59,31 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/ricardosoli777/CDP-Edge-Premium"
+    "url": "https://github.com/ricardosoli777/CDP-Edge-Premium.ts"
   },
   "bugs": {
-    "url": "https://github.com/ricardosoli777/CDP-Edge-Premium/issues"
+    "url": "https://github.com/ricardosoli777/CDP-Edge-Premium.ts/issues"
   },
-  "homepage": "https://github.com/ricardosoli777/CDP-Edge-Premium#readme",
+  "homepage": "https://github.com/ricardosoli777/CDP-Edge-Premium.ts#readme",
   "engines": {
     "node": ">=18.0.0"
   },
   "dependencies": {
     "chalk": "^5.3.0",
-    "commander": "^12.0.0",
-    "inquirer": "^9.2.0",
-    "ora": "^8.0.0"
+    "commander": "^14.0.3",
+    "inquirer": "^13.4.2",
+    "ora": "^9.4.0"
   },
   "devDependencies": {
-    "@cloudflare/workers-types": "^4.20260412.1",
+    "@cloudflare/workers-types": "^4.20260425.1",
     "@semantic-release/changelog": "^6.0.3",
     "@semantic-release/commit-analyzer": "^13.0.1",
     "@semantic-release/github": "^12.0.6",
     "@semantic-release/npm": "^13.1.5",
     "@semantic-release/release-notes-generator": "^14.1.0",
-    "@types/node": "^20.19.39",
+    "@types/node": "^25.6.0",
     "esbuild": "^0.28.0",
     "semantic-release": "^25.0.3",
-    "typescript": "^6.0.2"
+    "typescript": "^6.0.3"
   }
 }

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

@@ -0,0 +1,5 @@
+DATABASE_ID=
+SITE_DOMAIN=
+META_PIXEL_ID=
+GA4_MEASUREMENT_ID=
+TIKTOK_PIXEL_ID=

package/server-edge-tracker/index.ts

@@ -371,9 +371,12 @@ export default {
                           'utmSource','utmMedium','utmCampaign','utmContent','utmTerm',
                           'fbclid','ttclid','gclid','transactionId','productName','currency'];
 
-      const { eventName, behavioral_data, ...payload } = body as { eventName?: string; behavioral_data?: BehavioralData; [key: string]: any };
+      const { eventName: _bodyEventName, behavioral_data, ...payload } = body as { eventName?: string; behavioral_data?: BehavioralData; [key: string]: any };
       const trackPayload: TrackPayload = payload;
 
+      // Aceita eventName (camelCase) ou event_name (snake_case — formato cdpTrack.js SDK)
+      const eventName = _bodyEventName || (payload.event_name as string | undefined);
+
       // ── Extrair click_ids e utms de sub-objetos (formato cdpTrack.js) ────────
       // cdpTrack.js envia fbp/fbc/fbclid dentro de click_ids{} e UTMs dentro de utms{}
       // O Worker trabalha com campos no nível raiz — esta extração resolve o mismatch.
@@ -383,8 +386,11 @@ export default {
         if (!trackPayload.fbc    && c.fbc)    trackPayload.fbc    = c.fbc;
         if (!trackPayload.fbclid && c.fbclid) trackPayload.fbclid = c.fbclid;
         if (!trackPayload.gclid  && c.gclid)  trackPayload.gclid  = c.gclid;
+        if (!trackPayload.wbraid && c.wbraid) trackPayload.wbraid = c.wbraid;
+        if (!trackPayload.gbraid && c.gbraid) trackPayload.gbraid = c.gbraid;
         if (!trackPayload.ttclid && c.ttclid) trackPayload.ttclid = c.ttclid;
-        if (!trackPayload.ttp    && c.ttp)    trackPayload.ttp    = c.ttp;    // TikTok Pixel cookie
+        if (!trackPayload.ttp     && c.ttp)     trackPayload.ttp     = c.ttp;
+        if (!trackPayload.msclkid && c.msclkid) trackPayload.msclkid = c.msclkid;
       }
       if (payload.utms && typeof payload.utms === 'object') {
         const u = payload.utms as Record<string, string>;
@@ -395,6 +401,12 @@ export default {
         if (!trackPayload.utmTerm     && u.utm_term)     trackPayload.utmTerm     = u.utm_term;
       }
 
+      // ── Normalizar campos snake_case → camelCase (formato cdpTrack.js SDK) ──
+      if (!trackPayload.userId    && payload.user_id)    trackPayload.userId    = payload.user_id;
+      if (!trackPayload.eventId   && payload.event_id)   trackPayload.eventId   = payload.event_id;
+      if (!trackPayload.pageUrl   && payload.page_url)   trackPayload.pageUrl   = payload.page_url;
+      if (!trackPayload.sessionId && payload.session_id) trackPayload.sessionId = payload.session_id;
+
       // ── Validação de eventName ────────────────────────────────────────
       if (!eventName) {
         return new Response(JSON.stringify({ error: 'eventName é obrigatório' }), { status: 400, headers });
@@ -750,6 +762,21 @@ export default {
         ctx.waitUntil(resolveDeviceGraph(env.DB, payload.userId, payload.email, payload.phone));
       }
 
+      // Deduplicação server-side — INSERT OR IGNORE retorna changes=0 para duplicatas
+      if (env.DB && payload.eventId) {
+        try {
+          const dedup = await env.DB.prepare(
+            `INSERT OR IGNORE INTO events (event_id, event_name, user_id, created_at)
+             VALUES (?, ?, ?, datetime('now'))`
+          ).bind(payload.eventId, eventName, payload.userId || null).run();
+          if (dedup.meta.changes === 0) {
+            return new Response(JSON.stringify({ ok: true, skipped: 'duplicate' }), { status: 200, headers });
+          }
+        } catch {
+          // Tabela ausente ou erro de DB — não bloqueia o pipeline
+        }
+      }
+
       // R2 Audit Log — background
       ctx.waitUntil(writeAuditLog(env, eventName, payload, geoData));
 

package/server-edge-tracker/modules/db.ts

@@ -115,6 +115,7 @@ export async function upsertProfile(env: Env, eventName: string, payload: TrackP
     const {
       userId, email, phone,
       fbp, fbc, ttp, gclid, ttclid, gaClientId,
+      wbraid, gbraid, msclkid,
       city, state, country,
       engagementScore, userScore,
     } = payload;
@@ -131,8 +132,9 @@ export async function upsertProfile(env: Env, eventName: string, payload: TrackP
     await env.DB.prepare(`
       INSERT INTO user_profiles
         (user_id, email, phone, fbp, fbc, ttp, gclid, ttclid, ga_client_id,
+         wbraid, gbraid, msclkid,
          city, state, country, score, cohort_label, created_at, updated_at)
-      VALUES (?,?,?,?,?,?,?,?,?,?,?,?,?,?,datetime('now'),datetime('now'))
+      VALUES (?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,datetime('now'),datetime('now'))
       ON CONFLICT(user_id) DO UPDATE SET
         email        = COALESCE(excluded.email,        user_profiles.email),
         phone        = COALESCE(excluded.phone,        user_profiles.phone),
@@ -142,6 +144,9 @@ export async function upsertProfile(env: Env, eventName: string, payload: TrackP
         gclid        = COALESCE(excluded.gclid,        user_profiles.gclid),
         ttclid       = COALESCE(excluded.ttclid,       user_profiles.ttclid),
         ga_client_id = COALESCE(excluded.ga_client_id, user_profiles.ga_client_id),
+        wbraid       = COALESCE(excluded.wbraid,       user_profiles.wbraid),
+        gbraid       = COALESCE(excluded.gbraid,       user_profiles.gbraid),
+        msclkid      = COALESCE(excluded.msclkid,      user_profiles.msclkid),
         city         = COALESCE(excluded.city,         user_profiles.city),
         state        = COALESCE(excluded.state,        user_profiles.state),
         country      = COALESCE(excluded.country,      user_profiles.country),
@@ -158,6 +163,9 @@ export async function upsertProfile(env: Env, eventName: string, payload: TrackP
       gclid              || null,
       ttclid             || null,
       gaClientId         || null,
+      wbraid             || null,
+      gbraid             || null,
+      msclkid            || null,
       city               || null,
       state              || null,
       (country           || (request as any).cf?.country || null),

package/server-edge-tracker/modules/dispatch/whatsapp.ts

@@ -99,9 +99,9 @@ export async function sendWhatsApp(env: Env, tipo: string, payload: TrackPayload
   }
 
   // Text fallback (dentro da janela de 24h)
-  const nome    = [payload.firstName, payload.lastName].filter(Boolean).join(' ') || 'sem nome';
-  const valor   = payload.value ? `R$ ${parseFloat(String(payload.value)).toFixed(2)}` : '—';
-  const utm     = payload.utmSource || 'direto';
+  const nome = [payload.firstName, payload.lastName].filter(Boolean).join(' ') || 'sem nome';
+  const valor = payload.value ? `R$ ${parseFloat(String(payload.value)).toFixed(2)}` : '—';
+  const utm = payload.utmSource || 'direto';
   const produto = payload.contentName || '';
 
   let texto = '';
@@ -127,7 +127,7 @@ export async function sendWhatsApp(env: Env, tipo: string, payload: TrackPayload
 async function _sendWARequest(env: Env, body: Record<string, any>): Promise<any> {
   try {
     const phoneNumberId = resolvePhoneNumberId(env);
-    const accessToken   = resolveAccessToken(env);
+    const accessToken = resolveAccessToken(env);
     const res = await fetch(`https://graph.facebook.com/v22.0/${phoneNumberId}/messages`, {
       method: 'POST',
       headers: { 'Content-Type': 'application/json', 'Authorization': `Bearer ${accessToken}` },
@@ -169,14 +169,14 @@ export async function processWhatsAppWebhook(env: Env, body: any, request: Reque
   const results: any[] = [];
 
   for (const message of messages) {
-    const phone       = message.from;
-    const wamid       = message.id;
-    const referral    = message.referral || {};
-    const ctwaClid    = referral.ctwa_clid  || null;
-    const adId        = referral.source_id  || null;
-    const sourceUrl   = referral.source_url || null;
-    const headline    = referral.headline   || null;
-    const messageBody = message.text?.body  || message.type || '';
+    const phone = message.from;
+    const wamid = message.id;
+    const referral = message.referral || {};
+    const ctwaClid = referral.ctwa_clid || null;
+    const adId = referral.source_id || null;
+    const sourceUrl = referral.source_url || null;
+    const headline = referral.headline || null;
+    const messageBody = message.text?.body || message.type || '';
 
     if (!phone) { results.push({ skipped: 'no phone' }); continue; }
 
@@ -202,9 +202,9 @@ export async function processWhatsAppWebhook(env: Env, body: any, request: Reque
     }
 
     const capiEvent: Record<string, any> = {
-      event_name:    'Contact',
-      event_time:    Math.floor(Date.now() / 1000),
-      event_id:      eventId,
+      event_name: 'Contact',
+      event_time: Math.floor(Date.now() / 1000),
+      event_id: eventId,
       action_source: 'chat',
       user_data: {
         ph: phoneHash,

package/server-edge-tracker/schema.sql

@@ -79,6 +79,22 @@ CREATE INDEX IF NOT EXISTS idx_profiles_fbp      ON user_profiles(fbp);
 CREATE INDEX IF NOT EXISTS idx_profiles_msclkid  ON user_profiles(msclkid);
 CREATE INDEX IF NOT EXISTS idx_profiles_li_fat   ON user_profiles(li_fat_id);
 
+-- ── Tabela de Eventos (Deduplicação + Label ML) ──────────────────────────────
+-- Registra cada evento processado com sucesso.
+-- Duplo uso: (1) deduplicação server-side via event_id UNIQUE;
+--            (2) label de LTV para treinamento ML (lead comprou depois?)
+CREATE TABLE IF NOT EXISTS events (
+  id           INTEGER PRIMARY KEY AUTOINCREMENT,
+  event_id     TEXT    UNIQUE,              -- deduplicação: INSERT OR IGNORE descarta duplicatas
+  event_name   TEXT    NOT NULL,
+  user_id      TEXT,
+  created_at   TEXT    NOT NULL DEFAULT (datetime('now'))
+);
+
+CREATE INDEX IF NOT EXISTS idx_events_user_id    ON events(user_id);
+CREATE INDEX IF NOT EXISTS idx_events_event_name ON events(event_name);
+CREATE INDEX IF NOT EXISTS idx_events_created    ON events(created_at);
+
 -- ── Tabela de LOG de Webhooks Offline ─────────────────────────────────────────
 CREATE TABLE IF NOT EXISTS webhook_events (
   id             INTEGER PRIMARY KEY AUTOINCREMENT,

package/server-edge-tracker/types.ts

@@ -85,8 +85,17 @@ export interface TrackPayload {
   // Identifiers
   fbp?: string | null;
   fbc?: string | null;
+  fbclid?: string | null;
   ttp?: string | null;
+  gclid?: string | null;
+  wbraid?: string | null;
+  gbraid?: string | null;
+  ttclid?: string | null;
+  rclid?: string | null;
+  msclkid?: string | null;
+  li_fat_id?: string | null;
   gaClientId?: string | null;
+  sessionId?: string | null;
 
   // Parameters
   value?: number | null;

package/docs/installation.md

@@ -1,155 +0,0 @@
-# CDP Edge — Instalação em Projetos de Clientes
-
-Como integrar o CDP Edge em qualquer projeto para que Claude Code, VS Code, Cursor e outras IDEs com IA o reconheçam automaticamente.
-
----
-
-## Estrutura recomendada
-
-```
-meu-projeto-cliente/          ← abrir esta pasta no Claude Code / VS Code
-├── CLAUDE.md                 ← ⭐ faz o Claude Code ativar o CDP Edge automaticamente
-├── .cursorrules              ← (opcional) para Cursor IDE
-├── cdp-edge/                 ← CDP Edge instalado aqui
-│   ├── extracted-skill/
-│   ├── server-edge-tracker/
-│   ├── templates/
-│   └── docs/
-├── src/                      ← código do projeto do cliente
-└── ...
-```
-
----
-
-## Passo 1 — Instalar o CDP Edge na pasta do projeto
-
-```bash
-# Dentro da pasta do projeto do cliente:
-cd meu-projeto-cliente
-
-# Opção A — clonar o CDP Edge como subpasta
-git clone https://github.com/ricardosoli777/CDP-Edge-Premium cdp-edge
-
-# Opção B — copiar manualmente
-# Copiar a pasta CDP-Edge inteira e renomear para cdp-edge/
-```
-
----
-
-## Passo 2 — Criar o CLAUDE.md na raiz do projeto
-
-Copiar o template de ativação:
-
-```bash
-cp cdp-edge/templates/install/CLAUDE.md ./CLAUDE.md
-```
-
-Editar o `CLAUDE.md` e substituir `[NOME DO PROJETO]` pelo nome real do projeto.
-
-**Por que isso funciona:**
-O Claude Code lê o `CLAUDE.md` da raiz do diretório aberto automaticamente. Quando encontra a instrução de leitura do `master-orchestrator.md`, ativa o sistema imediatamente na abertura da sessão.
-
----
-
-## Passo 3 — Abrir o projeto no Claude Code
-
-```bash
-# Na pasta do projeto (não dentro do cdp-edge):
-claude .
-```
-
-O Claude Code vai:
-1. Ler o `CLAUDE.md` da raiz
-2. Encontrar a instrução de ativação do CDP Edge
-3. Carregar o `master-orchestrator.md`
-4. Exibir a mensagem de boas-vindas automaticamente
-
----
-
-## Para VS Code com extensão Claude
-
-O mesmo mecanismo funciona. O `CLAUDE.md` é lido pela extensão Claude Code no VS Code quando você abre a pasta do projeto.
-
-```bash
-code meu-projeto-cliente/
-```
-
----
-
-## Para Cursor IDE
-
-Criar adicionalmente um `.cursorrules` na raiz:
-
-```bash
-cp cdp-edge/templates/install/CLAUDE.md .cursorrules
-```
-
-O Cursor lê `.cursorrules` automaticamente e aplica as instruções ao agente AI.
-
----
-
-## Para qualquer outra IDE com AI
-
-Qualquer IDE que suporte arquivos de instrução (`.aidioms`, `system-prompt.md`, etc.) pode usar o mesmo conteúdo do `CLAUDE.md` adaptado para o formato da IDE.
-
----
-
-## Verificar se funcionou
-
-Ao abrir o projeto no Claude Code, você deve ver imediatamente:
-
-```
-👋 Olá! Bem-vindo ao CDP Edge — Quantum Tracking.
-
-Sou o seu Orquestrador de Rastreamento. Vou configurar toda a
-infraestrutura de tracking server-side para o seu projeto...
-```
-
-Se não aparecer automaticamente, digitar:
-
-```
-/cdp
-```
-
-ou simplesmente:
-
-```
-ative o master orchestrator do cdp edge
-```
-
----
-
-## Se o CDP Edge estiver em um caminho diferente
-
-Editar o `CLAUDE.md` na raiz e ajustar o path:
-
-```markdown
-<!-- Padrão: -->
-Leia o arquivo: `cdp-edge/extracted-skill/tracking-events-generator/agents/master-orchestrator.md`
-
-<!-- Se instalado em outro lugar: -->
-Leia o arquivo: `ferramentas/cdp/extracted-skill/tracking-events-generator/agents/master-orchestrator.md`
-```
-
----
-
-## Estrutura de múltiplos projetos (workspace compartilhado)
-
-Se você trabalha com vários clientes e quer uma instalação única do CDP Edge:
-
-```
-workspace/
-├── cdp-edge/                 ← instalação única compartilhada
-├── cliente-1/
-│   ├── CLAUDE.md             ← aponta para ../cdp-edge/...
-│   └── src/
-├── cliente-2/
-│   ├── CLAUDE.md             ← aponta para ../cdp-edge/...
-│   └── src/
-```
-
-No `CLAUDE.md` de cada cliente, usar path relativo:
-
-```markdown
-Leia o arquivo: `../cdp-edge/extracted-skill/tracking-events-generator/agents/master-orchestrator.md`
-```

package/docs/quick-start.md

@@ -1,185 +0,0 @@
-# CDP Edge — Quick Start
-> Do zero ao primeiro evento em produção.
-
----
-
-## Pré-requisitos
-
-| Ferramenta | Instalar |
-|---|---|
-| Node.js 18+ | nodejs.org |
-| Wrangler CLI | `npm install -g wrangler` |
-| Conta Cloudflare | cloudflare.com (plano gratuito suficiente) |
-| Conta Meta (Pixel + token CAPI) | business.facebook.com |
-
----
-
-## 1. Autenticar no Cloudflare
-
-```bash
-wrangler login
-```
-
----
-
-## 2. Criar o banco D1
-
-```bash
-wrangler d1 create cdp-edge-db
-```
-
-Copie o `database_id` retornado e cole no `wrangler.toml`:
-
-```toml
-[[d1_databases]]
-binding      = "DB"
-database_name = "cdp-edge-db"
-database_id  = "COLE_O_ID_AQUI"
-```
-
----
-
-## 3. Aplicar o schema
-
-```bash
-cd server-edge-tracker
-
-wrangler d1 execute cdp-edge-db --file=schema.sql --remote
-wrangler d1 execute cdp-edge-db --file=migrate-v2.sql --remote
-wrangler d1 execute cdp-edge-db --file=migrate-v3.sql --remote
-wrangler d1 execute cdp-edge-db --file=migrate-v4.sql --remote
-wrangler d1 execute cdp-edge-db --file=migrate-v5.sql --remote
-wrangler d1 execute cdp-edge-db --file=migrate-v6.sql --remote
-```
-
----
-
-## 4. Configurar secrets
-
-```bash
-wrangler secret put META_ACCESS_TOKEN
-wrangler secret put GA4_API_SECRET
-wrangler secret put TIKTOK_ACCESS_TOKEN
-```
-
-Para WhatsApp CTWA (opcional):
-```bash
-wrangler secret put WA_WEBHOOK_VERIFY_TOKEN
-wrangler secret put WHATSAPP_TOKEN
-wrangler secret put WHATSAPP_PHONE_NUMBER_ID
-```
-
----
-
-## 5. Atualizar variáveis públicas no wrangler.toml
-
-```toml
-[vars]
-META_PIXEL_ID      = "SEU_PIXEL_ID"
-GA4_MEASUREMENT_ID = "G-XXXXXXXXXX"
-TIKTOK_PIXEL_ID    = "CXXXXXXXXXXXXXXX"
-SITE_DOMAIN        = "seudominio.com.br"
-```
-
----
-
-## 6. Deploy
-
-```bash
-wrangler deploy
-```
-
-O Worker ficará disponível em:
-```
-https://server-edge-tracker.SEU-USUARIO.workers.dev
-```
-
----
-
-## 7. Testar o Worker
-
-```bash
-# Health check
-curl https://server-edge-tracker.SEU-USUARIO.workers.dev/health
-
-# Evento de teste
-curl -X POST https://server-edge-tracker.SEU-USUARIO.workers.dev/track \
-  -H "Content-Type: application/json" \
-  -d '{
-    "event": "PageView",
-    "url": "https://seudominio.com.br/",
-    "email": "teste@exemplo.com"
-  }'
-```
-
-Resposta esperada: `{"success":true}`
-
----
-
-## 8. Instalar o SDK no site
-
-```html
-<!-- No <head> de todas as páginas -->
-<script>
-  window.CDP_CONFIG = {
-    endpoint: 'https://server-edge-tracker.SEU-USUARIO.workers.dev/track',
-    pixelId: 'SEU_PIXEL_ID'
-  };
-</script>
-<script src="/js/cdpTrack.js" type="module" async></script>
-```
-
-O SDK inicializa automaticamente e dispara `PageView` ao carregar.
-
----
-
-## 9. Verificar no Meta Events Manager
-
-```
-Meta Business Suite
-  → Gerenciador de Eventos
-  → Seu Pixel
-  → Atividade de Teste
-  → Filtrar por "Servidor"
-```
-
-Você deve ver o `PageView` chegando com `action_source: website`.
-
----
-
-## 10. (Opcional) Conectar domínio próprio
-
-Para máxima eficácia (cookie first-party no domínio do cliente):
-
-```
-Cloudflare Dashboard → DNS → Add record
-  Type:   CNAME
-  Name:   track
-  Target: server-edge-tracker.SEU-USUARIO.workers.dev
-  Proxy:  ✅ (nuvem laranja)
-```
-
-Adicionar ao `wrangler.toml`:
-```toml
-[[routes]]
-pattern   = "track.seudominio.com.br/*"
-zone_name = "seudominio.com.br"
-```
-
-```bash
-wrangler deploy
-```
-
-Ver detalhes: `agents/domain-setup-agent.md`
-
----
-
-## Próximos passos
-
-| O que fazer | Onde está |
-|---|---|
-| Configurar WhatsApp CTWA | `agents/whatsapp-ctwa-setup-agent.md` |
-| Ativar R2 audit log | `agents/r2-setup-agent.md` |
-| Configurar gateways de pagamento | `agents/webhook-agent.md` |
-| Ver todos os eventos disponíveis | `docs/events-reference.md` |
-| Ver API do SDK browser | `docs/sdk-reference.md` |