cdp-edge 1.23.2 → 1.24.0

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

@@ -0,0 +1,186 @@
+/**
+ * CDP Edge — Utilities
+ * Funções puras sem dependências externas.
+ * Importadas por todos os outros módulos.
+ */
+
+// ── Tipos ───────────────────────────────────────────────────────────────────────
+export interface FunnelStageResult {
+  depth: string;
+  funnelDepth: string;
+}
+
+export interface MetaSignalWeights {
+  intent: number;
+  ltv: number;
+  dist: number;
+}
+
+export type DistanceBucket = 'very_close' | 'close' | 'nearby' | 'moderate' | 'far';
+
+export type FunnelLevel = 'top' | 'mid' | 'bottom' | 'conversion' | 'unknown';
+
+export type MetaSignalBucket = 'hot' | 'warm' | 'cold';
+
+// ── CORS ──────────────────────────────────────────────────────────────────────
+export function isAllowedOrigin(origin: string | null, siteDomain: string | null): boolean {
+  if (!origin || !siteDomain) return false;
+  return origin === `https://${siteDomain}`
+    || origin.endsWith(`.${siteDomain}`)
+    || origin === 'http://localhost:3000'
+    || origin === 'http://localhost:5173';
+}
+
+export function corsHeaders(origin: string | null, siteDomain: string | null): Record<string, string> {
+  const allowed = isAllowedOrigin(origin, siteDomain) ? origin : (siteDomain ? `https://${siteDomain}` : '*');
+  return {
+    'Access-Control-Allow-Origin':  allowed || '*',
+    'Access-Control-Allow-Methods': 'POST, GET, OPTIONS',
+    'Access-Control-Allow-Headers': 'Content-Type, X-Requested-With',
+    'Access-Control-Max-Age':       '86400',
+  };
+}
+
+// ── SHA-256 via WebCrypto (obrigatório no Cloudflare Workers) ─────────────────
+export async function sha256(value: string | null | undefined): Promise<string | undefined> {
+  if (!value) return undefined;
+  const clean = String(value).toLowerCase().trim();
+  if (!clean) return undefined;
+  const buf = await crypto.subtle.digest(
+    'SHA-256',
+    new TextEncoder().encode(clean)
+  );
+  return Array.from(new Uint8Array(buf))
+    .map(b => b.toString(16).padStart(2, '0'))
+    .join('');
+}
+
+// ── Normalização de telefone → somente dígitos + DDI 55 ──────────────────────
+export function normalizePhone(phone: string | null | undefined): string | undefined {
+  if (!phone) return undefined;
+  let digits = String(phone).replace(/\D/g, '');
+  if (digits.length === 11 && !digits.startsWith('55')) digits = '55' + digits;
+  if (digits.length === 10 && !digits.startsWith('55')) digits = '55' + digits;
+  return digits.length >= 10 ? digits : undefined;
+}
+
+// ── Normalização de cidade → lowercase sem acentos ────────────────────────────
+export function normalizeCity(city: string | null | undefined): string | undefined {
+  if (!city) return undefined;
+  return String(city)
+    .toLowerCase()
+    .normalize('NFD')
+    .replace(/[\u0300-\u036f]/g, '')
+    .replace(/[^a-z0-9]/g, '');
+}
+
+// ── Parse seguro de JSON armazenado como TEXT no D1 ───────────────────────────
+export function tryParseJson<T = any>(str: string | null, fallback?: T): T | null {
+  if (!str) return fallback !== undefined ? fallback : null;
+  try { return JSON.parse(str); } catch { return fallback !== undefined ? fallback : null; }
+}
+
+// ── Mapa Meta → GA4 event names ───────────────────────────────────────────────
+export const META_TO_GA4: Record<string, string> = {
+  PageView:             'page_view',
+  ViewContent:          'view_item',
+  Lead:                 'generate_lead',
+  Contact:              'generate_lead',
+  Schedule:             'generate_lead',
+  InitiateCheckout:     'begin_checkout',
+  AddToCart:            'add_to_cart',
+  AddPaymentInfo:       'add_payment_info',
+  Purchase:             'purchase',
+  CompleteRegistration: 'sign_up',
+  Subscribe:            'subscribe',
+  StartTrial:           'start_trial',
+  Search:               'search',
+  AddToWishlist:        'add_to_wishlist',
+};
+
+// ── Lista canônica de eventos válidos (19 eventos) ────────────────────────────
+export const VALID_EVENT_NAMES = new Set([
+  'PageView','ViewContent','Lead','Purchase','InitiateCheckout',
+  'AddToCart','CompleteRegistration','Contact','Schedule',
+  'StartTrial','Subscribe','SubmitApplication','Search',
+  'video_start','video_25','video_50','video_75','video_complete',
+  // Imóveis — intenção de visita física, financiamento e favoritar
+  'FindLocation','CustomizeProduct','AddToWishlist',
+]);
+
+// ── Taxonomia de funil (funnel_stage → profundidade semântica) ────────────────
+// Fonte de verdade para interpretar funnel_stage em qualquer ponto do sistema.
+export const FUNNEL_TAXONOMY = {
+  top:        ['scroll_50', 'time_30s', 'page_view', 'gallery_view', 'AddToWishlist'],
+  mid:        ['map_view', 'gallery_click', 'price_hover', 'time_3min', 'FindLocation'],
+  bottom:     ['route_click', 'whatsapp_click', 'cta_hover', 'CustomizeProduct'],
+  conversion: ['schedule_confirmed', 'lead_form', 'purchase', 'visit_booked'],
+};
+
+// Índice invertido: funnel_stage → depth (construído uma vez, zero custo em runtime)
+const _STAGE_TO_DEPTH: Record<string, FunnelLevel> = Object.entries(FUNNEL_TAXONOMY).reduce((acc, [depth, stages]) => {
+  stages.forEach(s => { acc[s] = depth as FunnelLevel; });
+  return acc;
+}, {} as Record<string, FunnelLevel>);
+
+/**
+ * Resolve funnel_stage em funnelDepth semântico.
+ * bottom_intent  = intenção forte (route_click, whatsapp_click)
+ * bottom_conversion = ação confirmada (schedule_confirmed, lead_form)
+ */
+export function resolveFunnelStage(funnel_stage: string | null | undefined): FunnelStageResult {
+  const depth = _STAGE_TO_DEPTH[funnel_stage || ''] || 'unknown';
+  const funnelDepth = depth === 'conversion' ? 'bottom_conversion'
+                    : depth === 'bottom'     ? 'bottom_intent'
+                    : depth;
+  return { depth, funnelDepth };
+}
+
+// ── Normalização de intent_score → 0.0–1.0 ───────────────────────────────────
+// Aceita: string ('high'/'medium'/'low'), numérico 0-1 ou numérico 0-100
+const _INTENT_STRING_MAP: Record<string, number> = { high: 0.92, medium: 0.65, low: 0.30 };
+
+export function resolveIntentScore(value: string | number | null | undefined): number | null {
+  if (value === null || value === undefined) return null;
+  if (typeof value === 'string') return _INTENT_STRING_MAP[value.toLowerCase()] ?? null;
+  const num = parseFloat(String(value));
+  if (isNaN(num)) return null;
+  const normalized = num > 1 ? num / 100 : num;  // escala 0-100 → 0-1
+  return Math.min(1, Math.max(0, Math.round(normalized * 100) / 100));
+}
+
+/**
+ * Distância (distanceBucket) → peso numérico para meta_signal.
+ * very_close=1.0 ... far=0.1 ... sem dado=0.3 (neutro)
+ */
+export function distanceBucketWeight(bucket: string | null | undefined): number {
+  const map: Record<DistanceBucket, number> = { very_close: 1.0, close: 0.75, nearby: 0.5, moderate: 0.25, far: 0.1 };
+  return map[bucket as DistanceBucket] ?? 0.3;
+}
+
+/**
+ * Pesos dinâmicos do meta_signal por profundidade de funil.
+ * Fundo: comportamento pesa mais (intent + dist).
+ * Topo: perfil pesa mais (ltv).
+ * Default (mid/unknown): balanceado.
+ */
+export function computeMetaSignalWeights(funnelLevel: FunnelLevel | string | null | undefined): MetaSignalWeights {
+  if (funnelLevel === 'bottom' || funnelLevel === 'conversion') {
+    return { intent: 0.5, ltv: 0.2, dist: 0.3 };
+  }
+  if (funnelLevel === 'top') {
+    return { intent: 0.2, ltv: 0.6, dist: 0.2 };
+  }
+  return { intent: 0.4, ltv: 0.4, dist: 0.2 };
+}
+
+/**
+ * Quantiza meta_signal contínuo em bucket legível.
+ * Usado em criação de públicos e leitura de BI.
+ */
+export function metaSignalBucket(score: number | null | undefined): MetaSignalBucket {
+  if (!score) return 'cold';
+  if (score >= 0.8) return 'hot';
+  if (score >= 0.6) return 'warm';
+  return 'cold';
+}

package/server-edge-tracker/schema-ltv-feedback.sql

@@ -0,0 +1,11 @@
+-- CDP Edge — Schema LTV Feedback Loop
+-- Fecha o ciclo preditivo: Purchase real → corrige predicted_ltv_value
+-- Execução: wrangler d1 execute cdp-edge-db --file=schema-ltv-feedback.sql --remote
+--
+-- Idempotência: ALTER TABLE não suporta IF NOT EXISTS no SQLite.
+-- Se a coluna já existir, o comando gera erro mas não afeta dados existentes.
+-- Seguro executar mais de uma vez.
+
+ALTER TABLE user_profiles ADD COLUMN real_ltv_value  REAL;
+ALTER TABLE user_profiles ADD COLUMN ltv_accuracy    REAL;   -- 1 - |pred-real|/real  (0–1, maior = melhor)
+ALTER TABLE user_profiles ADD COLUMN ltv_feedback_at TEXT;   -- timestamp do último feedback

package/server-edge-tracker/types.ts

@@ -0,0 +1,251 @@
+/**
+ * CDP Edge — Server Types
+ * Tipos para o Cloudflare Worker e bindings
+ */
+
+import { D1Database, KVNamespace, R2Bucket } from '@cloudflare/workers-types';
+
+// ── Environment Bindings ─────────────────────────────────────────────────────
+export interface Env {
+  // D1 Database
+  DB?: D1Database;
+
+  // KV Namespace
+  GEO_CACHE?: KVNamespace;
+
+  // R2 Bucket
+  AUDIT_LOGS?: R2Bucket;
+
+  // Workers AI
+  AI?: any;
+
+  // Rate Limiter
+  RATE_LIMITER?: any;
+
+  // Public Variables
+  META_PIXEL_ID?: string;
+  GA4_MEASUREMENT_ID?: string;
+  TIKTOK_PIXEL_ID?: string;
+  SITE_DOMAIN?: string;
+
+  // Secrets
+  META_ACCESS_TOKEN?: string;
+  GA4_API_SECRET?: string;
+  TIKTOK_ACCESS_TOKEN?: string;
+  WA_WEBHOOK_VERIFY_TOKEN?: string;
+  WHATSAPP_ACCESS_TOKEN?: string;
+  WHATSAPP_PHONE_NUMBER_ID?: string;
+  WA_NOTIFY_NUMBER?: string;
+  CALLMEBOT_PHONE?: string;
+  WEBHOOK_SECRET_TICTO?: string;
+  WEBHOOK_SECRET_HOTMART?: string;
+  WEBHOOK_SECRET_KIWIFY?: string;
+  META_TEST_CODE?: string;
+  META_AD_ACCOUNT_ID?: string;
+  META_AUDIENCE_ID?: string;
+  PINTEREST_ACCESS_TOKEN?: string;
+  PINTEREST_AD_ACCOUNT_ID?: string;
+  REDDIT_ACCESS_TOKEN?: string;
+  REDDIT_AD_ACCOUNT_ID?: string;
+  LINKEDIN_ACCESS_TOKEN?: string;
+  LINKEDIN_CONVERSION_ID?: string;
+  LINKEDIN_AD_ACCOUNT_ID?: string;
+  SPOTIFY_ACCESS_TOKEN?: string;
+  SPOTIFY_AD_ACCOUNT_ID?: string;
+
+  // Email and Notification
+  RESEND_API_KEY?: string;
+  RESEND_FROM_EMAIL?: string;
+  CALLMEBOT_APIKEY?: string;
+}
+
+// ── Event Payload Types ───────────────────────────────────────────────────────
+export interface TrackPayload {
+  eventName?: string;
+  eventId?: string;
+  event_id?: string;
+  userId?: string;
+  email?: string | null;
+  phone?: string | null;
+  firstName?: string | null;
+  lastName?: string | null;
+  city?: string | null;
+  state?: string | null;
+  zip?: string | null;
+  country?: string | null;
+  dob?: string | null;
+
+  // Identifiers
+  fbp?: string | null;
+  fbc?: string | null;
+  ttp?: string | null;
+  gaClientId?: string | null;
+
+  // Parameters
+  value?: number | null;
+  currency?: string | null;
+  contentIds?: string[] | null;
+  contentName?: string | null;
+  contentType?: string | null;
+  pageUrl?: string | null;
+  orderId?: string | null;
+  productName?: string | null;
+
+  // Quantum Tracking Details
+  intent_score?: string | number | null;
+  intentScoreNum?: number | null;
+  intent_bucket?: string | null;
+  intent_penalized?: boolean;
+  metaSignal?: number | null;
+  metaSignalBucket?: string | null;
+  distanceBucket?: string | null;
+  distanceKm?: number | null;
+  funnel_stage?: string | null;
+  funnelDepth?: string | null;
+  funnelLevel?: string | null;
+  internalEvent?: string | null;
+  botScore?: number | null;
+
+  // Real Estate
+  property_lat?: string | number | null;
+  propertyLat?: string | number | null;
+  property_lng?: string | number | null;
+  propertyLng?: string | number | null;
+
+  // Engagement
+  engagementScore?: number | null;
+  intentionLevel?: string | null;
+  userScore?: number | null;
+  scrollScore?: number | null;
+  timeLevel?: string | null;
+
+  // UTM
+  utmSource?: string | null;
+  utmMedium?: string | null;
+  utmCampaign?: string | null;
+  utmContent?: string | null;
+  utmTerm?: string | null;
+  utmRestored?: boolean;
+
+  // LTV
+  ltvClass?: string | null;
+  ltvScore?: number | null;
+
+  // Additional fields
+  [key: string]: any;
+}
+
+export interface BehavioralData {
+  engagement_score?: number;
+  totalScore?: number;
+  intention_level?: string;
+  user_score?: number;
+  scroll_score?: number;
+  time_level?: string;
+  email?: string | null;
+  phone?: string | null;
+  first_name?: string | null;
+  firstName?: string | null;
+  last_name?: string | null;
+  lastName?: string | null;
+  city?: string | null;
+  state?: string | null;
+  zip?: string | null;
+  dob?: string | null;
+}
+
+// ── Webhook Types ─────────────────────────────────────────────────────────────
+export interface HotmartWebhook {
+  data?: {
+    buyer?: {
+      email?: string;
+      phone?: string;
+      name?: string;
+    };
+    purchase?: {
+      status?: string;
+      transaction?: string;
+      price?: {
+        value?: number;
+        currency_value?: string;
+      };
+    };
+    product?: {
+      id?: string;
+      ucode?: string;
+      name?: string;
+    };
+  };
+  [key: string]: any;
+}
+
+export interface KiwifyWebhook {
+  order_status?: string;
+  order_id?: string;
+  order_value?: string;
+  Customer?: {
+    email?: string;
+    mobile?: string;
+    full_name?: string;
+  };
+  Product?: {
+    product_id?: string;
+    product_name?: string;
+  };
+  [key: string]: any;
+}
+
+export interface TictoWebhook {
+  status?: string;
+  customer?: {
+    email?: string;
+    phone?: string;
+    name?: string;
+  };
+  order?: {
+    hash?: string;
+    transaction_hash?: string;
+    id?: string;
+    paid_amount?: number;
+    total?: number;
+    amount?: number;
+  };
+  item?: {
+    product_id?: string;
+    product_name?: string;
+  };
+  tracking?: {
+    user_id?: string;
+    fbclid?: string;
+    utm_source?: string;
+    src?: string;
+    utm_medium?: string;
+    utm_campaign?: string;
+    utm_content?: string;
+  };
+  url_params?: {
+    user_id?: string;
+    fbclid?: string;
+    utm_source?: string;
+    src?: string;
+    utm_medium?: string;
+    utm_campaign?: string;
+    utm_content?: string;
+  };
+  [key: string]: any;
+}
+
+// ── Queue Message Types ───────────────────────────────────────────────────────
+export interface QueueMessage {
+  eventType: string;
+  payload: TrackPayload;
+  platform: string;
+  attempt?: number;
+}
+
+// ── Promise Settled Result Helpers ─────────────────────────────────────────────
+export interface PromiseResult<T> {
+  status: 'fulfilled' | 'rejected';
+  value?: T;
+  reason?: Error | string;
+}

package/server-edge-tracker/wrangler.toml

@@ -1,9 +1,10 @@
 name = "server-edge-tracker"
 # Entry point: worker.js (monólito original, 100% compatível)
-# Para usar a versão modular ES Modules: altere para main = "index.js"
-main = "index.js"
+# Para usar a versão modular ES Modules: altere para main = "index.ts"
+main = "index.ts"
 compatibility_date = "2025-01-01"
 compatibility_flags = ["nodejs_compat"]
+workers_dev = true
 
 # ── Worker Routes — same-domain tracking (imune a bloqueios) ─────────────────
 # Substituir SEU_DOMINIO pelo domínio do cliente antes do deploy
@@ -25,10 +26,10 @@ zone_name = "lancamentosabc.com.br"
 
 # ── Variáveis públicas (não são segredos) ─────────────────────────────────────
 [vars]
-META_PIXEL_ID      = "SEU_META_PIXEL_ID"
-GA4_MEASUREMENT_ID = "G-XXXXXXXXXX"
-TIKTOK_PIXEL_ID    = "CXXXXXXXXXXXXXXX"
-SITE_DOMAIN        = "SEU_DOMINIO"
+META_PIXEL_ID      = ""
+GA4_MEASUREMENT_ID = ""
+TIKTOK_PIXEL_ID    = ""
+SITE_DOMAIN        = "lancamentosabc.com.br"
 
 # ── Banco D1 ──────────────────────────────────────────────────────────────────
 # Após criar o banco com "wrangler d1 create cdp-edge-db",
@@ -95,6 +96,22 @@ namespace_id = "1001"
 limit  = 60
 period = 60
 
+# ── Observabilidade — Logs + Traces persistidos no painel Cloudflare ─────────
+[observability]
+enabled            = false
+head_sampling_rate = 1
+
+[observability.logs]
+enabled            = true
+head_sampling_rate = 1
+persist            = true
+invocation_logs    = true
+
+[observability.traces]
+enabled            = false
+persist            = true
+head_sampling_rate = 1
+
 # ── Secrets (NÃO ficam aqui — configurar via CLI) ─────────────────────────────
 # wrangler secret put META_ACCESS_TOKEN     ← token Meta CAPI (obrigatório)
 # wrangler secret put GA4_API_SECRET        ← secret GA4 Measurement Protocol (obrigatório)
@@ -107,6 +124,7 @@ period = 60
 # wrangler secret put RESEND_API_KEY            ← API Key do Resend (resend.com)
 # wrangler secret put RESEND_FROM_EMAIL         ← Remetente verificado ex: "CDP Edge <noreply@seudominio.com.br>"
 # wrangler secret put WA_WEBHOOK_VERIFY_TOKEN   ← Token de verificação do webhook WhatsApp (você define — qualquer string segura)
+# wrangler secret put WEBHOOK_SECRET_TICTO      ← HMAC-SHA256 Ticto
 # wrangler secret put PINTEREST_ACCESS_TOKEN    ← Bearer token Pinterest Conversions API
 # wrangler secret put PINTEREST_AD_ACCOUNT_ID   ← ID da conta de anúncios Pinterest (ex: 549755813XXX)
 # wrangler secret put REDDIT_ACCESS_TOKEN       ← Bearer token Reddit Conversions API