cdp-edge 1.24.0 → 1.24.2

package/README.md

@@ -2,7 +2,7 @@
 
 **Padrão Quantum Tracking: 100% Cloudflare Edge.** Sem GTM. Sem Stape. Sem cookies de terceiros.
 
-> **v2.2.5** — Versão Dinâmica · Correção de banner e CLI · Cloudflare Workers · Meta CAPI v22.0 · GA4 MP · TikTok Events API v1.3
+> **v2.3.0** — TypeScript Nativo · Worker 100% tipado · `types.ts` centralizado · `tsconfig.json` · `tsc --noEmit` zero erros · Cloudflare Workers · Meta CAPI v22.0 · GA4 MP · TikTok Events API v1.3
 
 > ⚠️ **REGRA DE OURO (SQUAD):** Todas as atualizações, correções ou novas features devem OBRIGATORIAMENTE ser documentadas de forma sincronizada neste `README.md`, no arquivo de instruções `CLAUDE.md` e no dossiê de diretoria `CDP-EDGE-BUSINESS-BOOK.md`. Nenhuma alteração passa sem esse tripé.
 
@@ -27,28 +27,33 @@ Meu ecossistema opera como um Cérebro de Conversão Privado na borda. Quando um
 
 ---
 
-## 📋 CHANGELOG v2.2.5+ — Migração TypeScript (12 de Abril de 2026)
+## 📋 CHANGELOG v2.3.0 — TypeScript Nativo (12 de Abril de 2026)
 
 ### 🔷 Worker 100% TypeScript — Migração Completa
 
-Todo o código server-side (`server-edge-tracker/`) foi migrado de JavaScript para **TypeScript nativo**. O Wrangler compila diretamente o `.ts` sem etapa de build separada.
+Todo o código server-side (`server-edge-tracker/`) foi migrado de JavaScript para **TypeScript nativo**. O Wrangler compila diretamente o `.ts` via esbuild — sem etapa de build separada, sem configuração extra.
 
-**Arquivos migrados (JS → TS):**
-- `index.ts` — entry point do Worker (era `index.js`)
-- `types.ts` — novo arquivo centralizado com `Env`, `TrackPayload`, tipos de webhook
+**Por que TypeScript muda o jogo no CDP Edge:**
+- **Env tipado** — typos em nomes de secrets (`META_ACCESS_TOKEN`, `GEO_CACHE`, `DB`) viram erros em build time, nunca em produção
+- **TrackPayload contratado** — o shape do payload entre browser e Worker é garantido pelo compilador
+- **Cloudflare types nativos** — D1, KV, R2, Workers AI com autocomplete e validação de métodos
+- **Fraud Gate e ML seguros** — `checkFraudGate(env: Env, request: Request, payload: TrackPayload)` — nenhum `undefined` passa despercebido
+- **Refatoração segura** — renomear qualquer campo do `TrackPayload` lista automaticamente todos os pontos de quebra
+
+**Arquivos migrados (JS → TS) — 16 módulos:**
+- `index.ts` — entry point do Worker
+- `types.ts` — **novo** — contratos centralizados: `Env`, `TrackPayload`, `BehavioralData`, `HotmartWebhook`, `KiwifyWebhook`, `TictoWebhook`, `QueueMessage`, `PromiseResult<T>`
 - `modules/utils.ts`, `modules/db.ts`, `modules/intelligence.ts`
 - `modules/dispatch/` — `meta.ts`, `ga4.ts`, `tiktok.ts`, `platforms.ts`, `whatsapp.ts`
 - `modules/ml/` — `ltv.ts`, `fraud.ts`, `bidding.ts`, `segmentation.ts`, `logistic.ts`, `matchquality.ts`
 
 **Infraestrutura:**
-- `tsconfig.json` adicionado (`target: ESNext`, `moduleResolution: bundler`, `strict: true`)
-- `wrangler.toml` — `main = "index.ts"` (TypeScript nativo, sem transpile manual)
-- `npm run typecheck` — novo script para validação de tipos (`tsc --noEmit`)
-
-**Testes de integração:**
-- `tests/integration/setup.js` atualizado para compilar o `.ts` com esbuild em memória antes de passar ao Miniflare (esbuild já é dep transitiva do Miniflare 3)
+- `tsconfig.json` — `target: ESNext`, `moduleResolution: "bundler"`, `strict: true`, `@cloudflare/workers-types`
+- `wrangler.toml` — `main = "index.ts"` (TypeScript nativo via wrangler/esbuild)
+- `contracts/types.ts` — tipos públicos exportados no pacote NPM: `QuantumEventPayload`, `AgencyContext`, `ApiVersionsConfig`
+- `npm run typecheck` — `tsc --noEmit` (225 testes passando, zero erros de compilação)
 
-**Breaking change:** nenhuma — API HTTP e comportamento em runtime são idênticos.
+**Breaking change:** nenhuma — API HTTP e comportamento em runtime são idênticos. TypeScript é invisível para o Cloudflare.
 
 ---
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cdp-edge",
-  "version": "1.24.0",
+  "version": "1.24.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/index.ts

@@ -218,8 +218,8 @@ export default {
         META_ACCESS_TOKEN:        env.META_ACCESS_TOKEN        ? 'set' : 'MISSING',
         GA4_API_SECRET:           env.GA4_API_SECRET           ? 'set' : 'MISSING',
         WA_WEBHOOK_VERIFY_TOKEN:  env.WA_WEBHOOK_VERIFY_TOKEN  ? 'set' : 'MISSING',
-        WHATSAPP_ACCESS_TOKEN:    env.WHATSAPP_ACCESS_TOKEN    ? 'set' : 'not set (optional - only for auto-reply)',
-        WHATSAPP_PHONE_NUMBER_ID: env.WHATSAPP_PHONE_NUMBER_ID ? 'set' : 'not set (optional - only for auto-reply)',
+        WHATSAPP_ACCESS_TOKEN:    (env.WHATSAPP_ACCESS_TOKEN || env.WA_ACCESS_TOKEN)       ? 'set' : 'not set (optional - only for auto-reply)',
+        WHATSAPP_PHONE_NUMBER_ID: (env.WHATSAPP_PHONE_NUMBER_ID || env.WA_PHONE_ID)         ? 'set' : 'not set (optional - only for auto-reply)',
         WA_NOTIFY_NUMBER:         env.WA_NOTIFY_NUMBER         ? 'set' : 'not set (optional - only for auto-reply)',
         TIKTOK_ACCESS_TOKEN:      env.TIKTOK_ACCESS_TOKEN      ? 'set' : 'not set (optional)',
         CALLMEBOT_PHONE:          env.CALLMEBOT_PHONE          ? 'set' : 'not set (optional)',

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

@@ -40,9 +40,19 @@ interface WhatsAppMessage {
   };
 }
 
+// ── Resolvedores de secrets (canônico + legado) ────────────────────────────────
+// Meta Cloud API v22.0 usa PHONE_NUMBER_ID e ACCESS_TOKEN como termos oficiais.
+// Suportamos ambos os nomes para compatibilidade com secrets já configurados.
+function resolvePhoneNumberId(env: Env): string | undefined {
+  return env.WHATSAPP_PHONE_NUMBER_ID || env.WA_PHONE_ID;
+}
+function resolveAccessToken(env: Env): string | undefined {
+  return env.WHATSAPP_ACCESS_TOKEN || env.WA_ACCESS_TOKEN;
+}
+
 // ── sendWhatsApp — envia mensagem via Meta Cloud API ──────────────────────────
 export async function sendWhatsApp(env: Env, tipo: string, payload: TrackPayload, options: WhatsAppOptions = {}): Promise<any> {
-  if (!env.WHATSAPP_PHONE_NUMBER_ID || !env.WHATSAPP_ACCESS_TOKEN || !env.WA_NOTIFY_NUMBER) {
+  if (!resolvePhoneNumberId(env) || !resolveAccessToken(env) || !env.WA_NOTIFY_NUMBER) {
     return { skipped: 'WhatsApp não configurado' };
   }
 
@@ -116,9 +126,11 @@ export async function sendWhatsApp(env: Env, tipo: string, payload: TrackPayload
 // ── _sendWARequest — executor interno ─────────────────────────────────────────
 async function _sendWARequest(env: Env, body: Record<string, any>): Promise<any> {
   try {
-    const res = await fetch(`https://graph.facebook.com/v22.0/${env.WHATSAPP_PHONE_NUMBER_ID}/messages`, {
+    const phoneNumberId = resolvePhoneNumberId(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 ${env.WHATSAPP_ACCESS_TOKEN}` },
+      headers: { 'Content-Type': 'application/json', 'Authorization': `Bearer ${accessToken}` },
       body: JSON.stringify(body),
     });
     const data = await res.json();

package/server-edge-tracker/types.ts

@@ -33,8 +33,12 @@ export interface Env {
   GA4_API_SECRET?: string;
   TIKTOK_ACCESS_TOKEN?: string;
   WA_WEBHOOK_VERIFY_TOKEN?: string;
-  WHATSAPP_ACCESS_TOKEN?: string;
-  WHATSAPP_PHONE_NUMBER_ID?: string;
+  // WhatsApp Cloud API — nomes canônicos (Meta Cloud API v22.0)
+  WHATSAPP_ACCESS_TOKEN?: string;       // canonical: Bearer token do System User
+  WHATSAPP_PHONE_NUMBER_ID?: string;    // canonical: ID numérico do número no Meta Business
+  // WhatsApp Cloud API — nomes legados (backwards compat)
+  WA_ACCESS_TOKEN?: string;
+  WA_PHONE_ID?: string;
   WA_NOTIFY_NUMBER?: string;
   CALLMEBOT_PHONE?: string;
   WEBHOOK_SECRET_TICTO?: string;

package/server-edge-tracker/wrangler.toml

@@ -17,19 +17,19 @@ workers_dev = true
 # zone_name = "SEU_DOMINIO"
 
 [[routes]]
-pattern  = "lancamentosabc.com.br/track*"
-zone_name = "lancamentosabc.com.br"
+pattern  = "SEU_DOMINIO/track*"
+zone_name = "SEU_DOMINIO"
 
 [[routes]]
-pattern  = "*.lancamentosabc.com.br/track*"
-zone_name = "lancamentosabc.com.br"
+pattern  = "*.SEU_DOMINIO/track*"
+zone_name = "SEU_DOMINIO"
 
 # ── Variáveis públicas (não são segredos) ─────────────────────────────────────
 [vars]
 META_PIXEL_ID      = ""
 GA4_MEASUREMENT_ID = ""
 TIKTOK_PIXEL_ID    = ""
-SITE_DOMAIN        = "lancamentosabc.com.br"
+SITE_DOMAIN        = "SEU_DOMINIO"
 
 # ── Banco D1 ──────────────────────────────────────────────────────────────────
 # Após criar o banco com "wrangler d1 create cdp-edge-db",
@@ -37,7 +37,7 @@ SITE_DOMAIN        = "lancamentosabc.com.br"
 [[d1_databases]]
 binding      = "DB"
 database_name = "cdp-edge-db"
-database_id  = "7867d38f-5fa8-4c17-b465-386211422c09"
+database_id  = "SEU_DATABASE_ID"
 
 # ── Queues — Retry + Dead Letter Queue ───────────────────────────────────────
 # Produtor: worker envia eventos com falha para cdp-edge-retry