cdp-edge 1.23.2 → 1.24.0

package/server-edge-tracker/{index.js → index.ts}

@@ -1,22 +1,29 @@
 /**
- * CDP Edge — index.js (ES Module Entry Point)
+ * CDP Edge — index.ts (ES Module Entry Point)
  *
  * Este arquivo é o novo entry point modular do Worker.
  * Para usá-lo, altere em wrangler.toml:
- *   main = "worker.js"   →   main = "index.js"
+ *   main = "worker.js"   →   main = "index.ts"
  *
  * O worker.js original permanece intacto como fallback.
  * Todos os módulos ficam em ./modules/
  */
 
+import { ExecutionContext } from '@cloudflare/workers-types';
+import { Env, TrackPayload, BehavioralData, HotmartWebhook, KiwifyWebhook, TictoWebhook } from './types';
+
 // ── Utilitários base ──────────────────────────────────────────────────────────
 import {
-  isAllowedOrigin,
   corsHeaders,
   sha256,
   META_TO_GA4,
   VALID_EVENT_NAMES,
-} from './modules/utils.js';
+  resolveFunnelStage,
+  resolveIntentScore,
+  distanceBucketWeight,
+  computeMetaSignalWeights,
+  metaSignalBucket,
+} from './modules/utils';
 
 // ── Banco de dados (D1) ───────────────────────────────────────────────────────
 import {
@@ -31,23 +38,24 @@ import {
   saveEdgeFingerprint,
   resurrectUTM,
   upsertLtvProfile,
-} from './modules/db.js';
+  recordLtvFeedback,
+} from './modules/db';
 
 // ── Dispatch — plataformas de ads ─────────────────────────────────────────────
-import { sendMetaCapi }    from './modules/dispatch/meta.js';
-import { sendGA4Mp }       from './modules/dispatch/ga4.js';
-import { sendTikTokApi }   from './modules/dispatch/tiktok.js';
+import { sendMetaCapi }    from './modules/dispatch/meta';
+import { sendGA4Mp }       from './modules/dispatch/ga4';
+import { sendTikTokApi }   from './modules/dispatch/tiktok';
 import {
   sendPinterestCapi,
   sendRedditCapi,
   sendLinkedInCapi,
   sendSpotifyCapi,
-} from './modules/dispatch/platforms.js';
+} from './modules/dispatch/platforms';
 import {
   sendWhatsApp,
   processWhatsAppWebhook,
   verifyHmac,
-} from './modules/dispatch/whatsapp.js';
+} from './modules/dispatch/whatsapp';
 
 // ── ML — LTV + A/B Testing ────────────────────────────────────────────────────
 import {
@@ -58,7 +66,7 @@ import {
   handleLtvAbTestList,
   handleLtvAbTestResults,
   handleLtvAbTestWinner,
-} from './modules/ml/ltv.js';
+} from './modules/ml/ltv';
 
 // ── ML — Segmentação ──────────────────────────────────────────────────────────
 import {
@@ -66,14 +74,14 @@ import {
   handleSegmentationList,
   handleSegmentationOutliers,
   handleSegmentationUpdate,
-} from './modules/ml/segmentation.js';
+} from './modules/ml/segmentation';
 
 // ── ML — Bidding ──────────────────────────────────────────────────────────────
 import {
   handleBiddingRecommend,
   handleBiddingHistory,
   handleBiddingStatus,
-} from './modules/ml/bidding.js';
+} from './modules/ml/bidding';
 
 // ── ML — Fraud Detection ──────────────────────────────────────────────────────
 import {
@@ -84,25 +92,40 @@ import {
   handleFraudBlocklistAdd,
   handleFraudBlocklistRemove,
   handleFraudStats,
-} from './modules/ml/fraud.js';
+} from './modules/ml/fraud';
 
 // ── Intelligence Agent (Cron) ─────────────────────────────────────────────────
 import {
   runIntelligenceAgent,
   buildGoogleCustomerMatchExport,
-} from './modules/intelligence.js';
+} from './modules/intelligence';
+
+// ── Haversine distance (km) — sem dependência externa ────────────────────────
+function haversineKm(lat1: number | string | null | undefined, lon1: number | string | null | undefined, lat2: number | string | null | undefined, lon2: number | string | null | undefined): number {
+  const R    = 6371;
+  const lat1Num = parseFloat(String(lat1 ?? '0'));
+  const lon1Num = parseFloat(String(lon1 ?? '0'));
+  const lat2Num = parseFloat(String(lat2 ?? '0'));
+  const lon2Num = parseFloat(String(lon2 ?? '0'));
+  const dLat = (lat2Num - lat1Num) * Math.PI / 180;
+  const dLon = (lon2Num - lon1Num) * Math.PI / 180;
+  const a    = Math.sin(dLat / 2) ** 2 +
+    Math.cos(lat1Num * Math.PI / 180) * Math.cos(lat2Num * Math.PI / 180) * Math.sin(dLon / 2) ** 2;
+  return R * 2 * Math.atan2(Math.sqrt(a), Math.sqrt(1 - a));
+}
 
 // ─────────────────────────────────────────────────────────────────────────────
 // HANDLER PRINCIPAL
 // ─────────────────────────────────────────────────────────────────────────────
 export default {
 
-  async fetch(request, env, ctx) {
+  async fetch(request: Request, env: Env, ctx: ExecutionContext) {
     const origin  = request.headers.get('Origin') || '';
-    const headers = {
+    const headersObj = {
       'Content-Type': 'application/json',
-      ...corsHeaders(origin, env.SITE_DOMAIN),
+      ...corsHeaders(origin, env.SITE_DOMAIN || null),
     };
+    const headers = new Headers(headersObj);
 
     // Preflight CORS
     if (request.method === 'OPTIONS') {
@@ -126,10 +149,10 @@ export default {
     // Roda ANTES de qualquer processamento de evento
     // Silent drop (200) — bots não sabem que foram detectados
     if (url.pathname === '/track' && request.method === 'POST') {
-      let trackBodyForFraud;
+      let trackBodyForFraud: TrackPayload = {};
       try {
         const cloned = request.clone();
-        trackBodyForFraud = await cloned.json().catch(() => ({}));
+        trackBodyForFraud = await cloned.json().catch(() => ({})) as TrackPayload;
       } catch { trackBodyForFraud = {}; }
 
       const fraudResult = await checkFraudGate(env, request, trackBodyForFraud);
@@ -158,30 +181,30 @@ export default {
 
     // ── GET /health ───────────────────────────────────────────────────────────
     if (request.method === 'GET' && url.pathname === '/health') {
-      const results = {};
+      const results: Record<string, string> = {};
 
       try {
-        await env.DB.prepare('SELECT 1').run();
+        await env.DB?.prepare('SELECT 1').run();
         results.d1 = 'ok';
-      } catch (err) {
-        results.d1 = `FAILED: ${err.message}`;
+      } catch (err: any) {
+        results.d1 = `FAILED: ${err?.message || String(err)}`;
       }
 
       try {
-        await env.GEO_CACHE.get('__health_check__');
+        await env.GEO_CACHE?.get('__health_check__');
         results.kv = 'ok';
-      } catch (err) {
-        results.kv = `FAILED: ${err.message}`;
+      } catch (err: any) {
+        results.kv = `FAILED: ${err?.message || String(err)}`;
       }
 
       try {
-        await env.AI.run('@cf/meta/llama-3.1-8b-instruct', {
+        await env.AI?.run('@cf/ibm-granite/granite-4.0-h-micro', {
           messages: [{ role: 'user', content: 'ping' }],
           max_tokens: 1,
         });
         results.ai = 'ok';
-      } catch (err) {
-        results.ai = `FAILED: ${err.message}`;
+      } catch (err: any) {
+        results.ai = `FAILED: ${err?.message || String(err)}`;
       }
 
       const vars = {
@@ -239,7 +262,8 @@ export default {
                           'utmSource','utmMedium','utmCampaign','utmContent','utmTerm',
                           'fbclid','ttclid','gclid','transactionId','productName','currency'];
 
-      const { eventName, behavioral_data, ...payload } = body;
+      const { eventName, behavioral_data, ...payload } = body as { eventName?: string; behavioral_data?: BehavioralData; [key: string]: any };
+      const trackPayload: TrackPayload = payload;
 
       if (!eventName) {
         return new Response(JSON.stringify({ error: 'eventName é obrigatório' }), { status: 400, headers });
@@ -250,19 +274,19 @@ export default {
       }
 
       for (const field of STR_FIELDS) {
-        if (payload[field] !== undefined && payload[field] !== null) {
-          if (typeof payload[field] !== 'string' || payload[field].length > 512) {
+        if (trackPayload[field as keyof TrackPayload] !== undefined && trackPayload[field as keyof TrackPayload] !== null) {
+          if (typeof trackPayload[field as keyof TrackPayload] !== 'string' || String(trackPayload[field as keyof TrackPayload]).length > 512) {
             return new Response(JSON.stringify({ error: `Campo inválido: ${field}` }), { status: 400, headers });
           }
         }
       }
 
-      if (payload.value !== undefined && payload.value !== null) {
-        const v = Number(payload.value);
+      if (trackPayload.value !== undefined && trackPayload.value !== null) {
+        const v = Number(trackPayload.value);
         if (isNaN(v) || v < 0 || v > 9_999_999) {
           return new Response(JSON.stringify({ error: 'value fora do intervalo permitido' }), { status: 400, headers });
         }
-        payload.value = v;
+        trackPayload.value = v;
       }
 
       // ── Extrair dados comportamentais do browser ──────────────────────────
@@ -270,6 +294,9 @@ export default {
         payload.engagementScore = behavioral_data.engagement_score ?? behavioral_data.totalScore ?? null;
         payload.intentionLevel  = behavioral_data.intention_level  ?? null;
         payload.userScore       = behavioral_data.user_score       ?? null;
+        // Sinais de engajamento profundo — usados no anti-falso-positivo e no LTV
+        payload.scrollScore     = behavioral_data.scroll_score     ?? null;
+        payload.timeLevel       = behavioral_data.time_level       ?? null;
         payload.email     = payload.email     || behavioral_data.email      || null;
         payload.phone     = payload.phone     || behavioral_data.phone      || null;
         payload.firstName = payload.firstName || behavioral_data.first_name  || behavioral_data.firstName || null;
@@ -280,11 +307,40 @@ export default {
         payload.dob       = payload.dob       || behavioral_data.dob         || null;
       }
 
+      // ── Normalização de intent_score → 0.0–1.0 ──────────────────────────
+      // Aceita string ('high'/'medium'/'low'), 0-1 ou 0-100 enviados pelo front.
+      // intent_bucket mantém a label legível para D1 e logs.
+      const intentScoreNum = resolveIntentScore(payload.intent_score);
+      if (intentScoreNum !== null) {
+        payload.intent_score  = intentScoreNum;
+        payload.intentScoreNum = intentScoreNum;
+        payload.intent_bucket = intentScoreNum >= 0.8 ? 'high'
+                              : intentScoreNum >= 0.5 ? 'medium' : 'low';
+      } else {
+        payload.intentScoreNum = null;
+      }
+
+      // ── Anti-falso-positivo ───────────────────────────────────────────────
+      // Penaliza intent se engajamento insuficiente: scroll raso E tempo curto.
+      // scroll_score < 2.0 ≈ não passou de 50% da página.
+      // time_level 'curioso' = menos de 60 segundos na página.
+      if (payload.intentScoreNum !== null) {
+        const isShallowScroll = payload.scrollScore !== null && payload.scrollScore < 2.0;
+        const isShallowTime   = payload.timeLevel === 'curioso';
+        if (isShallowScroll && isShallowTime) {
+          const penalized = Math.round(payload.intentScoreNum * 0.7 * 100) / 100;
+          payload.intentScoreNum    = penalized;
+          payload.intent_score      = penalized;
+          payload.intent_bucket     = penalized >= 0.8 ? 'high' : penalized >= 0.5 ? 'medium' : 'low';
+          payload.intent_penalized  = true;  // flag auditável — visível no D1 e logs
+        }
+      }
+
       // ── Edge Fingerprint + UTM Resurrection ──────────────────────────────
       const fingerprint = await generateEdgeFingerprint(request);
       payload.utmRestored = false;
 
-      if (fingerprint) {
+      if (fingerprint && env.DB) {
         if (payload.utmSource) {
           ctx.waitUntil(saveEdgeFingerprint(env.DB, fingerprint, payload.userId, payload));
         } else {
@@ -301,13 +357,13 @@ export default {
       }
 
       // ── Bot Mitigation ────────────────────────────────────────────────────
-      const botScoreStr = request.cf?.botManagement?.score;
-      const cfBotScore  = botScoreStr !== undefined ? parseInt(botScoreStr) : 100;
+      const botScoreStr = (request as any).cf?.botManagement?.score;
+      const cfBotScore  = botScoreStr !== undefined ? parseInt(String(botScoreStr)) : 100;
       const ua          = (request.headers.get('User-Agent') || '').toLowerCase();
       const isBotPattern = /bot|crawler|spider|lighthouse|postman|curl|inspect|headless/i.test(ua);
 
       const isBot = cfBotScore < 30 || isBotPattern;
-      payload.botScore = isBot ? 2 : (cfBotScore < 60 ? 1 : 0);
+      trackPayload.botScore = isBot ? 2 : (cfBotScore < 60 ? 1 : 0);
 
       if (isBot && !['Contact', 'Lead', 'Purchase'].includes(eventName)) {
         return new Response(JSON.stringify({ ok: true, skipped_due_to_bot: true }), { status: 200, headers });
@@ -324,6 +380,34 @@ export default {
 
       const ga4Name = META_TO_GA4[eventName] || eventName.toLowerCase();
 
+      // ── Dual-layer semantics ─────────────────────────────────────────────
+      // Meta sempre recebe o nome canônico (Schedule, Lead, etc.).
+      // Internamente o CDP usa semântica de funil precisa via FUNNEL_TAXONOMY.
+      if (payload.funnel_stage) {
+        const { depth, funnelDepth } = resolveFunnelStage(payload.funnel_stage);
+        payload.funnelDepth = funnelDepth;  // ex: 'bottom_intent', 'bottom_conversion'
+        payload.funnelLevel = depth;        // ex: 'bottom', 'conversion', 'mid'
+      }
+      if (eventName === 'Schedule' && payload.funnel_stage === 'route_click') {
+        payload.internalEvent = 'IntentToVisit';
+      }
+
+      // ── Real Estate Distance Enrichment ──────────────────────────────────
+      // Calcula distância entre o IP do usuário (via Cloudflare) e o imóvel.
+      // Ativa quando o evento carrega property_lat + property_lng (ex: Schedule de rota).
+      const propLat = parseFloat(String(trackPayload.property_lat ?? trackPayload.propertyLat));
+      const propLng = parseFloat(String(trackPayload.property_lng ?? trackPayload.propertyLng));
+      const userLat = parseFloat(String(request.cf?.latitude ?? '0'));
+      const userLng = parseFloat(String(request.cf?.longitude ?? '0'));
+      if (!isNaN(propLat) && !isNaN(propLng) && !isNaN(userLat) && !isNaN(userLng)) {
+        const distKm = haversineKm(userLat, userLng, propLat, propLng);
+        trackPayload.distanceKm     = Math.round(distKm * 10) / 10;
+        trackPayload.distanceBucket = distKm <  5 ? 'very_close' :
+                                       distKm < 15 ? 'close'      :
+                                       distKm < 30 ? 'nearby'     :
+                                       distKm < 60 ? 'moderate'   : 'far';
+      }
+
       // ── LTV Prediction (+ A/B Testing de Prompts) ─────────────────────────
       const LTV_EVENTS = ['Lead', 'Contact', 'Schedule', 'CompleteRegistration'];
       if (LTV_EVENTS.includes(eventName) && !payload.value) {
@@ -342,16 +426,45 @@ export default {
             recordAbAssignment(
               env,
               payload.userId,
-              abVariation.variation_id,
+              abVariation.id,
               abVariation.test_id,
               ltv.value,
               ltv.class,
-              emailHash,
+              emailHash ?? null,
             )
           );
         }
       }
 
+      // ── LTV Feedback Loop — fecha o ciclo preditivo ──────────────────────
+      // Quando uma compra real acontece, registra o valor real e recalcula accuracy.
+      // Alimenta ltv_ab_variations.accuracy_score → autoDecideAbWinner usa isso.
+      if (eventName === 'Purchase' && payload.value > 0) {
+        ctx.waitUntil(recordLtvFeedback(env, payload.userId, payload.value));
+      }
+
+      // ── Meta Signal Score (composite, pesos dinâmicos) ───────────────────
+      // Pesos variam por profundidade de funil: fundo = comportamento pesa mais.
+      {
+        const w  = computeMetaSignalWeights(payload.funnelLevel);
+        const iW = payload.intentScoreNum ?? 0.5;
+        const lW = payload.ltvScore ? payload.ltvScore / 100 : 0.5;
+        const dW = distanceBucketWeight(payload.distanceBucket);
+        payload.metaSignal       = Math.round(((iW * w.intent) + (lW * w.ltv) + (dW * w.dist)) * 100) / 100;
+        payload.metaSignalBucket = metaSignalBucket(payload.metaSignal);  // 'hot'/'warm'/'cold'
+      }
+
+      // ── Hot Lead Trigger (timing + sinal) ────────────────────────────────
+      // Reage em tempo real: WhatsApp apenas quando comportamento + sinal justificam.
+      // Critérios: rota + muito próximo + (intent alto OU meta_signal alto)
+      //            + (janela de decisão BRT 18–22h OU sinal excepcional ≥ 0.9)
+      const hourBRT  = (new Date().getUTCHours() - 3 + 24) % 24;
+      const inWindow = hourBRT >= 18 && hourBRT <= 22;
+      const isHotLead = payload.funnel_stage === 'route_click'
+                     && payload.distanceBucket === 'very_close'
+                     && ((payload.intentScoreNum ?? 0) >= 0.8 || payload.metaSignal >= 0.85)
+                     && (inWindow || payload.metaSignal >= 0.9);
+
       // Cross-Device Graph — background
       if (env.DB && payload.userId && (payload.email || payload.phone)) {
         ctx.waitUntil(resolveDeviceGraph(env.DB, payload.userId, payload.email, payload.phone));
@@ -366,36 +479,37 @@ export default {
         sendMetaCapi(env, eventName, payload, request, ctx),
         sendGA4Mp(env, ga4Name, payload, ctx),
         sendTikTokApi(env, eventName, payload, request, ctx),
-        saveLead(env, eventName, payload, request, 'website'),
+        saveLead(env, payload.internalEvent || eventName, payload, request, 'website'),
         upsertProfile(env, eventName, payload, request),
-        ...(WHATSAPP_NOTIFY_EVENTS.includes(eventName)
-          ? [sendWhatsApp(env, eventName, payload)]
+        ...(WHATSAPP_NOTIFY_EVENTS.includes(eventName) || isHotLead
+          ? [sendWhatsApp(env, isHotLead ? 'hot_lead_intent_to_visit' : eventName, payload)]
           : []),
       ]);
 
       // Automação de mensagens
       const AUTOMATION_EVENTS = ['Lead', 'Purchase', 'InitiateCheckout'];
       if (AUTOMATION_EVENTS.includes(eventName) && env.DB) {
+        const db = env.DB; // Captura em variável local
         ctx.waitUntil(
           (async () => {
             try {
-              const lastLead = await env.DB
+              const lastLead = await db
                 .prepare(`SELECT id FROM leads WHERE event_id = ?1 LIMIT 1`)
-                .bind(payload.eventId || payload.event_id || '')
-                .first();
-              const leadId = lastLead?.id ?? null;
-              if (leadId) await fireAutomation(env, eventName, leadId, payload);
-            } catch (e) { console.error('[Automation] lead lookup error:', e.message); }
+                .bind(trackPayload.eventId || trackPayload.event_id || '')
+                .first() as any;
+              const leadId = lastLead?.id ? Number(lastLead.id) : null;
+              if (leadId) await fireAutomation(env, eventName, leadId, trackPayload);
+            } catch (e: any) { console.error('[Automation] lead lookup error:', e?.message || String(e)); }
           })()
         );
       }
 
       // Edge Personalization
       let currentScore = 0;
-      if (env.DB && payload.userId) {
+      if (env.DB && trackPayload.userId) {
         try {
-          const profileRow = await env.DB.prepare('SELECT score FROM user_profiles WHERE user_id = ?').bind(payload.userId).first();
-          if (profileRow) currentScore = profileRow.score;
+          const profileRow = await env.DB.prepare('SELECT score FROM user_profiles WHERE user_id = ?').bind(trackPayload.userId).first();
+          if (profileRow) currentScore = Number(profileRow.score) || 0;
         } catch {}
       }
 
@@ -405,9 +519,9 @@ export default {
       return new Response(JSON.stringify({
         ok:          true,
         userProfile: { score: currentScore, user_id: finalUserId },
-        meta:        metaRes.value  ?? { error: metaRes.reason?.message },
-        ga4:         ga4Res.value   ?? { error: ga4Res.reason?.message },
-        tiktok:      ttRes.value    ?? { error: ttRes.reason?.message },
+        meta:        metaRes.status === 'fulfilled' ? metaRes.value : { error: metaRes.reason?.message },
+        ga4:         ga4Res.status === 'fulfilled' ? ga4Res.value : { error: ga4Res.reason?.message },
+        tiktok:      ttRes.status === 'fulfilled' ? ttRes.value : { error: ttRes.reason?.message },
       }), { status: 200, headers: resHeaders });
     }
 
@@ -420,8 +534,8 @@ export default {
         }
       }
 
-      let wh;
-      try { wh = await request.json(); } catch {
+      let wh: HotmartWebhook;
+      try { wh = await request.json() as HotmartWebhook; } catch {
         return new Response('JSON inválido', { status: 400 });
       }
 
@@ -498,8 +612,8 @@ export default {
         }
       }
 
-      let wh;
-      try { wh = await request.json(); } catch {
+      let wh: KiwifyWebhook;
+      try { wh = await request.json() as KiwifyWebhook; } catch {
         return new Response('JSON inválido', { status: 400 });
       }
 
@@ -520,8 +634,8 @@ export default {
       }
 
       const customer = wh.Customer || {};
-      const product  = wh.Product  || {};
-      const profile  = await getProfileByEmail(env, customer.email);
+      const product  = wh.Product || {};
+      const profile  = await getProfileByEmail(env, customer.email || '');
 
       const payload = {
         email:       customer.email,
@@ -582,8 +696,8 @@ export default {
         }
       }
 
-      let wh;
-      try { wh = JSON.parse(rawBody); } catch {
+      let wh: TictoWebhook;
+      try { wh = JSON.parse(rawBody) as TictoWebhook; } catch {
         return new Response('JSON inválido', { status: 400 });
       }
 
@@ -598,7 +712,7 @@ export default {
       const tracking = wh.tracking  || wh.url_params || {};
 
       const valueRaw      = order.paid_amount ?? order.total ?? order.amount;
-      const value         = valueRaw ? parseFloat(valueRaw) / 100 : undefined;
+      const value         = valueRaw ? parseFloat(String(valueRaw)) / 100 : undefined;
       const transactionId = order.hash || order.transaction_hash || order.id;
       const tcTxId        = String(order.hash || order.transaction_hash || order.id || '');
 
@@ -614,7 +728,7 @@ export default {
       }
 
       const urlUserId = tracking.user_id || wh.url_params?.user_id;
-      let profile = await getProfileByEmail(env, customer.email);
+      let profile = await getProfileByEmail(env, customer.email || '');
       if (!profile && urlUserId && env.DB) {
         try {
           profile = await env.DB.prepare(
@@ -760,7 +874,7 @@ export default {
   },
 
   // ── Cron Handler — Intelligence Agent ────────────────────────────────────────
-  async scheduled(event, env, ctx) {
+  async scheduled(event: any, env: Env, ctx: ExecutionContext) {
     const cron      = event.cron;
     const isMonthly = cron === '0 3 1 * *';
 
@@ -768,9 +882,9 @@ export default {
   },
 
   // ── Queue Consumer — Retry de eventos com falha ───────────────────────────────
-  async queue(batch, env) {
+  async queue(batch: any, env: Env) {
     for (const message of batch.messages) {
-      const { eventType, payload, platform, attempt = 1 } = message.body;
+      const { eventType, payload, platform } = message.body as { eventType: string; payload: TrackPayload; platform: string; attempt?: number };
 
 
       try {
@@ -779,8 +893,8 @@ export default {
         if (platform === 'tiktok') await sendTikTokApi(env, eventType, payload, null, null);
 
         message.ack();
-      } catch (err) {
-        console.error(`[Queue] Falha ao reprocessar ${platform}/${eventType}:`, err.message);
+      } catch (err: any) {
+        console.error(`[Queue] Falha ao reprocessar ${platform}/${eventType}:`, err?.message || String(err));
         message.retry();
       }
     }