cdp-edge 2.5.1 → 2.5.2

package/extracted-skill/tracking-events-generator/agents/tiktok-agent.md

@@ -23,7 +23,7 @@ Especialista exclusivo em TikTok Pixel (browser via cdpTrack) + TikTok Events AP
 
 ### PASSO 0 — Ler Versões Atuais
 
-```javascript
+```typescript
 // Ler versões do arquivo centralizado
 const apiVersions = await readJSON('contracts/api-versions.json');
 const tiktokVersion = apiVersions.tiktok;
@@ -85,7 +85,7 @@ Conforme `contracts/api-versions.json`, a TikTok Events API tem limites estritos
 
 ### Implementação de Throttling no Worker
 
-```javascript
+```typescript
 // Rate limit KV key: 'tiktok_rate_{pixel_id}_{minute}'
 async function dispatchTikTokWithRateLimit(env, events, pixelId, accessToken) {
   const now = new Date();
@@ -161,7 +161,7 @@ async function dispatchTikTokWithRateLimit(env, events, pixelId, accessToken) {
 {
   "arquivos_gerados": {
     "browser": "cdpTrack.js (eventos TikTok injetados)",
-    "server": "cloudflare/tiktok-events.js"
+    "server": "modules/dispatch/tiktok.ts"
   },
   "versao_api": "v1.3",
   "endpoint": "/open_api/v1.3/event/track/",

package/extracted-skill/tracking-events-generator/agents/tracking-plan-agent.md

@@ -28,7 +28,7 @@ Gerar um tracking plan **validado e verificável** que elimine:
 
 ### 1.1 Verificar Cobertura de Eventos
 
-```javascript
+```typescript
 // Comparar eventos do Page Analyzer com outputs dos agentes
 function validateEventCoverage(pageAnalysis, agentOutputs) {
   const pageEvents = new Set();
@@ -89,7 +89,7 @@ function validateEventCoverage(pageAnalysis, agentOutputs) {
 
 ### 1.2 Verificar Consistência de Parâmetros
 
-```javascript
+```typescript
 // Verificar se eventos de conversão têm todos os campos críticos
 function validateConversionParameters(events, apiVersions) {
   const criticalFields = ['value', 'currency', 'content_ids', 'transaction_id'];
@@ -118,7 +118,7 @@ function validateConversionParameters(events, apiVersions) {
 
 ### 1.3 Verificar Seletores Implementados
 
-```javascript
+```typescript
 // Verificar se seletores no tracking plan existem no código
 function validateSelectorsExist(trackingPlan, pageAnalysis) {
   const missingSelectors = [];
@@ -158,7 +158,7 @@ function validateSelectorsExist(trackingPlan, pageAnalysis) {
 
 ### 1.4 Verificar Versões de API
 
-```javascript
+```typescript
 // Ler api-versions.json e verificar consistência
 async function validateApiVersions(trackingPlan) {
   const apiVersions = await readJSON('contracts/api-versions.json');
@@ -200,7 +200,7 @@ async function validateApiVersions(trackingPlan) {
 
 ### 1.5 Validação Cruzada Completa (runFullValidation)
 
-```javascript
+```typescript
 /**
  * Ponto de entrada principal — executa TODAS as validações em sequência
  * e retorna um relatório consolidado com status PASS | WARN | BLOCK

package/extracted-skill/tracking-events-generator/agents/validator-agent.md

@@ -78,7 +78,7 @@ Quando detectar erro, emitir bloco `CORRECTION_ROUTE` com formato:
         "test_url": "https://graph.facebook.com/v22.0/{PIXEL_ID}/events",
         "response_expected": "200 OK com payload válido"
       },
-      "files_affected": ["worker.js", "meta-capi-dispatcher.js"],
+      "files_affected": ["index.ts", "modules/dispatch/meta.ts"],
       "auto_fix_available": true,
       "user_action_required": false
     },
@@ -95,7 +95,7 @@ Quando detectar erro, emitir bloco `CORRECTION_ROUTE` com formato:
         "fallback": "gerar novo UUID se não existir",
         "required_for_events": ["purchase", "initiate_checkout"]
       },
-      "files_affected": ["ga4-dispatcher.js", "worker.js"],
+      "files_affected": ["modules/dispatch/ga4.ts", "index.ts"],
       "auto_fix_available": false,
       "user_action_required": true,
       "user_instruction": "Verificar se o D1 está persistindo corretamente o ga_client_id nos cookies do visitante"
@@ -123,7 +123,7 @@ Para correções com `auto_fix_available: true`, o Validator Agent DEVE:
 
 #### PASSO 1 — Executar Fix Automático
 
-```javascript
+```typescript
 // Exemplo: correção automática de versão de API
 async function applyAutoFix(correction) {
   const { files_affected, check_pattern, expected_pattern } = correction;
@@ -142,7 +142,7 @@ async function applyAutoFix(correction) {
 
 #### PASSO 2 — Re-validar após Fix
 
-```javascript
+```typescript
 // Após aplicar fix, re-executar validação específica
 async function reValidateAfterFix(correction) {
   const { validation_criteria, files_affected } = correction;
@@ -171,14 +171,14 @@ Para correções com `user_action_required: true`, emitir instrução estruturad
 
 **Agente Responsável:** meta-agent
 **Prioridade:** 🔴 CRÍTICO
-**Arquivos Afetados:** worker.js, meta-capi-dispatcher.js
+**Arquivos Afetados:** index.ts, modules/dispatch/meta.ts
 
 ### Problema Detectado:
 Meta CAPI está usando versão v21.0 (desatualizada) — isso causará rejeição de eventos pela Meta.
 
 ### O que precisa ser feito:
 
-1. **Abrir o arquivo:** `worker.js`
+1. **Abrir o arquivo:** `modules/dispatch/meta.ts`
 2. **Localizar:** Todas as ocorrências de `/v21.0/`
 3. **Substituir por:** `/v22.0/`
 4. **Testar:** Fazer uma requisição de teste para https://graph.facebook.com/v22.0/{SEU_PIXEL_ID}/events
@@ -201,7 +201,7 @@ Após cada correção (auto ou manual), o Validator Agent DEVE executar validaç
 
 #### Para Correções de API Version:
 
-```javascript
+```typescript
 {
   "revalidation_checklist": {
     "version_correct": true,  // Check: endpoint usa versão correta
@@ -214,7 +214,7 @@ Após cada correção (auto ou manual), o Validator Agent DEVE executar validaç
 
 #### Para Correções de Missing Fields:
 
-```javascript
+```typescript
 {
   "revalidation_checklist": {
     "field_present": true,  // Check: campo existe no payload
@@ -227,7 +227,7 @@ Após cada correção (auto ou manual), o Validator Agent DEVE executar validaç
 
 #### Para Correções de Seletores:
 
-```javascript
+```typescript
 {
   "revalidation_checklist": {
     "selector_exists": true,  // Check: seletor encontrado no HTML/JS

package/extracted-skill/tracking-events-generator/agents/webhook-agent.md

@@ -16,7 +16,7 @@ Você é o especialista em Webhooks do CDP Edge. Sua missão é capturar vendas
 
 Antes de qualquer dispatch para CAPI, normalizar e hashear PII extraída do webhook:
 
-```javascript
+```typescript
 // Hashing SHA-256 para PII — usar WebCrypto (disponível em Cloudflare Workers)
 async function hashPII(value) {
   if (!value) return null;
@@ -99,7 +99,7 @@ Webhook (Hotmart/Kiwify/Ticto/Stripe)
 
 ### Código de Integração (webhook handler)
 
-```javascript
+```typescript
 // No handler de webhook, após validação e dedup:
 ctx.waitUntil(Promise.allSettled([
   // [5] CAPI dispatch
@@ -124,8 +124,8 @@ ctx.waitUntil(Promise.allSettled([
 ]));
 ```
 
-> **Nota:** `sendEmail()` é implementada pelo Email Agent em `cloudflare/email-service.js`.
-> `syncToCRM()` é implementada pelo CRM Integration Agent em `cloudflare/crm-service.js`.
+> **Nota:** `sendEmail()` é implementada pelo Email Agent em `modules/email-service.ts`.
+> `syncToCRM()` é implementada pelo CRM Integration Agent em `modules/crm-service.ts`.
 
 ---
 

package/extracted-skill/tracking-events-generator/agents/whatsapp-agent.md

@@ -66,7 +66,7 @@ WhatsApp Agent dispara notificação ao dono via Meta Cloud API v22.0
 
 ### O que este agente gera para o fluxo CTWA
 
-```javascript
+```typescript
 // sendWhatsApp() — notificação ao dono quando chega lead CTWA
 async function notifyOwnerNewCtwaLead(env, contactData) {
   const message = `📲 Novo Lead CTWA!\n\nNome: ${contactData.name || 'Desconhecido'}\nTelefone: ${contactData.phone}\nAnúncio: ${contactData.headline || '-'}\nMensagem: "${contactData.messageBody?.slice(0, 80) || '-'}"`;

package/extracted-skill/tracking-events-generator/agents/whatsapp-ctwa-setup-agent.md

@@ -183,7 +183,7 @@ message_body | Olá, vi o anúncio e tenho interesse
 3. `META_APP_SECRET`
 
 **O agente gera/descobre o restante automaticamente:**
-```javascript
+```typescript
 // WA_WEBHOOK_VERIFY_TOKEN — gerado pelo agente antes de registrar o webhook
 const WA_WEBHOOK_VERIFY_TOKEN = crypto.randomUUID().replace(/-/g, '') + crypto.randomUUID().replace(/-/g, '');
 // Exemplo: "a3f8c1d2e4b5a6f7c8d9e0f1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b1"
@@ -504,7 +504,7 @@ echo "{META_APP_SECRET}"   | wrangler secret put META_APP_SECRET
 echo "{META_ACCESS_TOKEN}" | wrangler secret put META_ACCESS_TOKEN
 
 # ── Secrets para Auto-Resposta WhatsApp (enviar mensagens de saída) ─────────
-# Necessários para: worker.js → auto-resposta após Lead/Purchase
+# Necessários para: index.ts → auto-resposta após Lead/Purchase
 # WHATSAPP_ACCESS_TOKEN      = mesmo token Meta (Cloud API) — pode reutilizar META_ACCESS_TOKEN
 # WHATSAPP_PHONE_NUMBER_ID = mesmo {PHONE_ID} descoberto acima
 echo "{META_ACCESS_TOKEN}" | wrangler secret put WHATSAPP_ACCESS_TOKEN
@@ -682,7 +682,7 @@ PRÓXIMO PASSO:
 
 | Arquivo | Função |
 |---------|--------|
-| `server-edge-tracker/worker.js` | `processWhatsAppWebhook()` (linha ~943) + rotas `GET/POST /webhook/whatsapp` (linha ~2182) |
+| `server-edge-tracker/index.ts` | `processWhatsAppWebhook()` + rotas `GET/POST /webhook/whatsapp` |
 | `server-edge-tracker/migrate-v6.sql` | Criação da tabela `whatsapp_contacts` com índices |
 | `server-edge-tracker/wrangler.toml` | Configuração do worker + lista de secrets documentados |
 | `docs/whatsapp-ctwa.md` | Documentação técnica completa do módulo CTWA |

package/extracted-skill/tracking-events-generator/agents/youtube-agent.md

@@ -33,7 +33,7 @@ YouTube Ad (TrueView / Bumper / Non-skip)
 
 ### PASSO 0 — Ler Versões Atuais
 
-```javascript
+```typescript
 const apiVersions = await readJSON('contracts/api-versions.json');
 const googleVersions = apiVersions.google;
 
@@ -253,7 +253,7 @@ cdpTrack.updateConsent({ analytics: true, ads: true });
 
 ---
 
-## 🛠️ IMPLEMENTAÇÃO SERVER — worker.js
+## 🛠️ IMPLEMENTAÇÃO SERVER — index.ts
 
 ### 1. Extrair e persistir Click IDs do YouTube
 
@@ -262,7 +262,7 @@ O `upsertProfile()` já persiste `gclid`, `wbraid`, `gbraid` no D1.
 
 Para verificar persistência correta:
 
-```javascript
+```typescript
 // D1: user_profiles — colunas já existentes
 // gclid   TEXT  — Google Ads standard click ID
 // wbraid  TEXT  — iOS privacy-preserving (YouTube)
@@ -271,7 +271,7 @@ Para verificar persistência correta:
 
 ### 2. GA4 Measurement Protocol — Eventos de Vídeo
 
-```javascript
+```typescript
 // No sendGA4Mp() — adicionar mapeamento de eventos YouTube
 const VIDEO_GA4_MAP = {
   video_start:    'video_start',
@@ -293,7 +293,7 @@ const videoParams = {
 
 ### 3. Google Ads Enhanced Conversions — Lead de Vídeo
 
-```javascript
+```typescript
 // Conversão de Lead gerada por campanha YouTube
 // Envia para GA4 MP com user_data para Enhanced Conversions
 const enhancedConversionPayload = {
@@ -326,7 +326,7 @@ const enhancedConversionPayload = {
 Para campanhas Bumper/Non-skip, o usuário converte DEPOIS sem clicar.
 O Worker detecta isso quando um Lead chega SEM gclid mas com histórico de impressão YouTube:
 
-```javascript
+```typescript
 // No upsertProfile() — verificar se perfil tem impressão YouTube recente
 // (requer webhook do Google Ads — avançado, Fase 5)
 // Por ora: registrar ausência de gclid + utm_source=youtube como view-through candidate
@@ -418,7 +418,7 @@ const YOUTUBE_AUDIENCES_IMOVEIS = {
 
 ### Customer Match — Exportar leads do D1 para Google Ads
 
-```javascript
+```typescript
 // Endpoint no Worker: GET /export/customer-match
 // Gera CSV criptografado para upload no Google Ads
 
@@ -449,7 +449,7 @@ async function exportCustomerMatchList(env) {
 
 O Intelligence Agent (cron semanal) deve incluir check de YouTube:
 
-```javascript
+```typescript
 // Adicionar ao checkApiVersionsIntelligence():
 // Verificar se wbraid/gbraid estão chegando nos leads
 // (indica que campanhas YouTube iOS estão funcionando)
@@ -518,7 +518,7 @@ if (youtubeMobileLeads.count === 0) {
 {
   "arquivos_gerados": {
     "browser": "cdpTrack.js (eventos YouTube + IFrame API listener)",
-    "server": "cloudflare/google-mp.js (já inclui YouTube via GA4)"
+    "server": "modules/dispatch/ga4.ts (já inclui YouTube via GA4)"
   },
   "eventos_implementados": [
     "video_start",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cdp-edge",
-  "version": "2.5.1",
+  "version": "2.5.2",
   "description": "CDP Edge - Quantum Tracking - Sistema multi-agente para tracking digital Cloudflare Native (Workers + D1)",
   "main": "dist/index.js",
   "type": "module",

package/server-edge-tracker/schema-utm.sql

@@ -32,9 +32,11 @@ CREATE INDEX IF NOT EXISTS idx_utm_category ON utm_mappings(category);
 -- ============================================================================
 -- ALTER: leads (adicionar colunas de segmentação)
 -- ============================================================================
-ALTER TABLE leads ADD COLUMN IF NOT EXISTS faixa_obfuscada TEXT;       -- Hash da faixa de valor (vem da URL)
-ALTER TABLE leads ADD COLUMN IF NOT EXISTS faixa_real TEXT;            -- Valor real de-obfuscado (ex: "700k-1M")
-ALTER TABLE leads ADD COLUMN IF NOT EXISTS faixa_category TEXT;         -- Categoria do produto (ex: "imovel")
+-- Nota: D1/SQLite não suporta ADD COLUMN IF NOT EXISTS. Executar uma vez.
+-- Se as colunas já existirem, o erro "duplicate column name" é inofensivo — banco continua OK.
+ALTER TABLE leads ADD COLUMN faixa_obfuscada TEXT;       -- Hash da faixa de valor (vem da URL)
+ALTER TABLE leads ADD COLUMN faixa_real TEXT;            -- Valor real de-obfuscado (ex: "700k-1M")
+ALTER TABLE leads ADD COLUMN faixa_category TEXT;        -- Categoria do produto (ex: "imovel")
 
 -- ============================================================================
 -- ÍNDICES: leads (novas colunas para segmentação)

package/server-edge-tracker/wrangler.toml

@@ -37,7 +37,7 @@ SITE_DOMAIN        = "SEU_DOMINIO"
 [[d1_databases]]
 binding      = "DB"
 database_name = "cdp-edge-db"
-database_id  = "SEU_DATABASE_ID"
+database_id  = "7867d38f-5fa8-4c17-b465-386211422c09"
 
 # ── Queues — Retry + Dead Letter Queue ───────────────────────────────────────
 # Produtor: worker envia eventos com falha para cdp-edge-retry

package/extracted-skill/tracking-events-generator/agents/intelligence-scheduling.md

@@ -1,10 +0,0 @@
-# Intelligence Agent — Scheduling (REDIRECIONAMENTO)
-
-> ⚠️ **Este arquivo foi consolidado.**
->
-> Todo o conteúdo de scheduling automático do Intelligence Agent foi unificado em:
-> **[intelligence-agent.md](./intelligence-agent.md)**
->
-> Consulte a seção `## 📅 PROTOCOLO DE SCHEDULING` dentro de `intelligence-agent.md`.
-
-Motivo: duplicação eliminada para manter uma única fonte de verdade.