cdp-edge 1.2.0 → 1.3.0

package/extracted-skill/tracking-events-generator/route-intent-capture.js

@@ -0,0 +1,222 @@
+/**
+ * CDP Edge — Route Intent Capture
+ * @version 2.0.0
+ *
+ * Fluxo:
+ *   1. Usuário clica em "Ver rota" → Google Maps abre normalmente
+ *   2. Widget aparece com um botão de WhatsApp
+ *   3. Usuário clica → WhatsApp abre com mensagem pré-escrita
+ *   4. Usuário envia → corretor recebe e responde
+ *
+ * Uso:
+ *   initRouteIntentCapture({
+ *     whatsappNumber: '5511999999999',   // número do plantão/corretor
+ *     propertyName:   'Reserva do Jardim',
+ *     propertyId:     'rj-001',
+ *     propertyLat:    -23.6519,
+ *     propertyLng:    -46.5330,
+ *   });
+ */
+
+const isBrowser = typeof window !== 'undefined';
+
+/**
+ * @param {object} options
+ * @param {string}   options.whatsappNumber   Número do plantão (ex: '5511999999999')
+ * @param {string}  [options.propertyName]    Nome do empreendimento
+ * @param {string}  [options.propertyId]      ID interno do imóvel
+ * @param {number}  [options.propertyLat]     Latitude
+ * @param {number}  [options.propertyLng]     Longitude
+ * @param {string}  [options.routeSelector]   CSS selector dos botões de rota (default auto)
+ * @param {string}  [options.distanceBucket]  'very_close'|'close'|'nearby'|'moderate'|'far'
+ * @param {number}  [options.distanceKm]      Distância em km — exibe tempo estimado
+ * @param {string}  [options.metaSignalBucket] 'hot'|'warm'|'cold'
+ * @param {string}  [options.brokerName]       Nome do corretor de plantão (ex: 'Ramon')
+ */
+export function initRouteIntentCapture(options = {}) {
+  if (!isBrowser) return;
+
+  const {
+    whatsappNumber,
+    propertyName    = 'o imóvel',
+    propertyId      = null,
+    propertyLat     = null,
+    propertyLng     = null,
+    routeSelector   = '[data-route-intent], a[href*="maps/dir"], a[href*="maps?q="]',
+    distanceBucket  = null,
+    distanceKm      = null,
+    metaSignalBucket = null,
+    brokerName      = null,
+  } = options;
+
+  if (!whatsappNumber) {
+    console.warn('[RouteIntent] whatsappNumber é obrigatório.');
+    return;
+  }
+
+  _injectStyles();
+
+  document.addEventListener('click', (e) => {
+    const btn = e.target.closest(routeSelector);
+    if (!btn) return;
+    _showWidget(btn, { whatsappNumber, propertyName, propertyId, propertyLat, propertyLng, distanceBucket, distanceKm, metaSignalBucket, brokerName });
+  }, true);
+}
+
+// ── Widget ────────────────────────────────────────────────────────────────────
+
+function _showWidget(anchorEl, opts) {
+  document.getElementById('cdp-ri-widget')?.remove();
+
+  const travelMinutes = _estimateTravelMinutes(opts.distanceKm);
+  const travelText    = travelMinutes
+    ? `<p class="cdp-ri-travel">📍 Você está a cerca de <strong>${travelMinutes} min</strong> daqui</p>`
+    : '';
+
+  const brokerLine = opts.brokerName
+    ? `<p class="cdp-ri-broker">Ao chegar, pergunte pelo <strong>${opts.brokerName}</strong> — ele vai estar te aguardando com tudo pronto 🤝</p>`
+    : '';
+
+  const widget = document.createElement('div');
+  widget.id = 'cdp-ri-widget';
+  widget.innerHTML = `
+    <div class="cdp-ri-inner">
+      ${travelText}
+      <p class="cdp-ri-headline">Vi que você quer visitar o local! Confirme sua vinda enviando a mensagem abaixo — nossa equipe já fica de prontidão pra te receber 👇</p>
+      ${brokerLine}
+      <button id="cdp-ri-btn" type="button">
+        ${_waIcon()} Confirmar minha visita
+      </button>
+      <button id="cdp-ri-dismiss" type="button" class="cdp-ri-dismiss">Agora não</button>
+    </div>
+  `;
+
+  anchorEl.insertAdjacentElement('afterend', widget);
+  setTimeout(() => widget.scrollIntoView({ behavior: 'smooth', block: 'nearest' }), 150);
+
+  document.getElementById('cdp-ri-btn').addEventListener('click', () => _handleClick(widget, opts));
+  document.getElementById('cdp-ri-dismiss').addEventListener('click', () => {
+    window.cdpTrack?.track?.('ViewContent', {
+      content_name:       'rota_dispensada',
+      property_id:        opts.propertyId,
+      funnel_stage:       'route_dismiss',
+      intent_score:       'medium',
+      distance_bucket:    opts.distanceBucket  || undefined,
+      meta_signal_bucket: opts.metaSignalBucket || undefined,
+    });
+    widget.remove();
+  });
+}
+
+// ── Click — dispara evento e abre WhatsApp ────────────────────────────────────
+
+async function _handleClick(widget, opts) {
+  const btn = document.getElementById('cdp-ri-btn');
+  if (btn) btn.disabled = true;
+
+  // Evento Contact → Worker: LTV + hot lead trigger + CAPI
+  // Phone capturado depois via webhook quando a mensagem chegar
+  window.cdpTrack?.track?.('Contact', {
+    content_name:       'aviso_chegada_whatsapp',
+    property_id:        opts.propertyId,
+    property_lat:       opts.propertyLat,
+    property_lng:       opts.propertyLng,
+    funnel_stage:       'route_click',
+    intent_score:       'high',
+    distance_bucket:    opts.distanceBucket   || undefined,
+    meta_signal_bucket: opts.metaSignalBucket || undefined,
+  });
+
+  // Monta mensagem — acolhedora, foco em confirmar chegada
+  const travelMinutes = _estimateTravelMinutes(opts.distanceKm);
+  const travelLine    = travelMinutes ? `Estou a cerca de ${travelMinutes} minutos daí.` : '';
+  const brokerLine    = opts.brokerName
+    ? `Vou procurar pelo ${opts.brokerName} ao chegar.`
+    : '';
+
+  const msg = [
+    `Oi! Estou interessado(a) em visitar o ${opts.propertyName} e gostaria de confirmar minha visita.`,
+    travelLine,
+    brokerLine || `Vocês conseguem me receber agora ou preciso marcar horário?`,
+  ].filter(Boolean).join(' ');
+
+  _showSuccess(widget, opts.whatsappNumber, msg);
+}
+
+// ── Tela de confirmação ───────────────────────────────────────────────────────
+
+function _showSuccess(widget, whatsappNumber, msg) {
+  widget.innerHTML = `
+    <div class="cdp-ri-inner cdp-ri-ok">
+      <span class="cdp-ri-check">✅</span>
+      <p><strong>Abrindo WhatsApp...</strong><br><span>A equipe já foi avisada!</span></p>
+    </div>
+  `;
+  setTimeout(() => {
+    window.open(`https://wa.me/${whatsappNumber}?text=${encodeURIComponent(msg)}`, '_blank');
+    setTimeout(() => widget?.remove(), 3500);
+  }, 600);
+}
+
+// ── Helpers ───────────────────────────────────────────────────────────────────
+
+function _estimateTravelMinutes(distanceKm) {
+  if (!distanceKm || distanceKm <= 0) return null;
+  return Math.max(5, Math.round((distanceKm * 60 / 25) / 5) * 5);
+}
+
+function _waIcon() {
+  return `<svg width="18" height="18" viewBox="0 0 24 24" fill="currentColor" aria-hidden="true">
+    <path d="M17.472 14.382c-.297-.149-1.758-.867-2.03-.967-.273-.099-.471-.148-.67.15-.197.297-.767.966-.94 1.164-.173.199-.347.223-.644.075-.297-.15-1.255-.463-2.39-1.475-.883-.788-1.48-1.761-1.653-2.059-.173-.297-.018-.458.13-.606.134-.133.298-.347.446-.52.149-.174.198-.298.298-.497.099-.198.05-.371-.025-.52-.075-.149-.669-1.612-.916-2.207-.242-.579-.487-.5-.669-.51-.173-.008-.371-.01-.57-.01-.198 0-.52.074-.792.372-.272.297-1.04 1.016-1.04 2.479 0 1.462 1.065 2.875 1.213 3.074.149.198 2.096 3.2 5.077 4.487.709.306 1.262.489 1.694.625.712.227 1.36.195 1.871.118.571-.085 1.758-.719 2.006-1.413.248-.694.248-1.289.173-1.413-.074-.124-.272-.198-.57-.347z"/>
+    <path d="M12 0C5.373 0 0 5.373 0 12c0 2.122.554 4.118 1.528 5.852L0 24l6.335-1.513A11.933 11.933 0 0012 24c6.627 0 12-5.373 12-12S18.627 0 12 0zm0 21.818a9.818 9.818 0 01-5.002-1.368l-.359-.213-3.722.888.924-3.617-.234-.372A9.818 9.818 0 012.182 12C2.182 6.57 6.57 2.182 12 2.182S21.818 6.57 21.818 12 17.43 21.818 12 21.818z"/>
+  </svg>`;
+}
+
+// ── Estilos ───────────────────────────────────────────────────────────────────
+
+function _injectStyles() {
+  if (document.getElementById('cdp-ri-styles')) return;
+  const s = document.createElement('style');
+  s.id = 'cdp-ri-styles';
+  s.textContent = `
+    #cdp-ri-widget {
+      margin-top: 12px;
+      padding: 16px 18px;
+      background: #f0fdf4;
+      border: 1.5px solid #22c55e;
+      border-radius: 12px;
+      font-family: Arial, sans-serif;
+      animation: cdp-ri-in .25s ease;
+    }
+    @keyframes cdp-ri-in {
+      from { opacity: 0; transform: translateY(-8px); }
+      to   { opacity: 1; transform: translateY(0); }
+    }
+    .cdp-ri-inner         { display: flex; flex-direction: column; gap: 10px; }
+    .cdp-ri-travel        { margin: 0; font-size: 13px; color: #555; }
+    .cdp-ri-travel strong { color: #0f766e; }
+    .cdp-ri-headline      { margin: 0; font-size: 14px; color: #15803d; font-weight: bold; line-height: 1.4; }
+    .cdp-ri-broker        { margin: 0; font-size: 13px; color: #555; line-height: 1.4; }
+    .cdp-ri-broker strong { color: #0f766e; }
+    #cdp-ri-btn {
+      display: flex; align-items: center; justify-content: center; gap: 8px;
+      width: 100%; padding: 13px 16px;
+      background: #25D366; color: #fff;
+      border: none; border-radius: 10px;
+      font-size: 15px; font-weight: bold; cursor: pointer;
+    }
+    #cdp-ri-btn:hover    { background: #1ebe5a; }
+    #cdp-ri-btn:disabled { background: #86efac; cursor: not-allowed; }
+    .cdp-ri-dismiss {
+      background: none; border: none;
+      color: #aaa; font-size: 12px;
+      cursor: pointer; padding: 2px 0; text-align: center;
+    }
+    .cdp-ri-dismiss:hover { color: #666; }
+    .cdp-ri-ok   { align-items: center; text-align: center; gap: 8px; }
+    .cdp-ri-check { font-size: 28px; }
+    .cdp-ri-ok p  { margin: 0; font-size: 14px; color: #15803d; line-height: 1.5; }
+    .cdp-ri-ok span { font-size: 13px; color: #555; }
+  `;
+  document.head.appendChild(s);
+}

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

@@ -10,9 +10,9 @@
 const CONFIG = {
   // ── Endpoint do Cloudflare Worker ────────────────────────────────────────────
   // Same-domain: evita ad-blockers e CORS.
-  // Em produção: seu-dominio.com.br/api/tracking (Worker roteado)
-  // Em dev: use o URL do Worker diretamente
-  endpoint: '/api/tracking',
+  // Em produção: seu-dominio.com.br/track (Worker roteado via Custom Domain)
+  // Em dev: use o URL do Worker diretamente (ex: https://worker.seu-dominio.workers.dev/track)
+  endpoint: '/track',
 
   // ── Plataformas de checkout habilitadas ──────────────────────────────────────
   // Controla quais plataformas recebem passCheckoutParams() automaticamente.

package/package.json

@@ -1,75 +1,89 @@
-{
-  "name": "cdp-edge",
-  "version": "1.2.0",
-  "description": "CDP Edge - Quantum Tracking - Sistema multi-agente para tracking digital Cloudflare Native (Workers + D1)",
-  "main": "dist/index.js",
-  "type": "module",
-  "bin": {
-    "cdp-edge": "./bin/cdp-edge.js",
-    "pb": "./bin/cdp-edge.js"
-  },
-  "files": [
-    "bin",
-    "dist",
-    "templates",
-    "contracts",
-    "extracted-skill",
-    "server-edge-tracker",
-    "docs",
-    "README.md"
-  ],
-  "scripts": {
-    "build": "node build.js",
-    "dev": "node build.js --watch",
-    "test": "node test.js",
-    "test:unit": "node tests/unit/*.test.js",
-    "test:unit:normalize": "node tests/unit/normalization.test.js",
-    "test:unit:hash": "node tests/unit/hashing.test.js",
-    "test:unit:dedup": "node tests/unit/deduplication.test.js",
-    "test:unit:payload": "node tests/unit/payload-validation.test.js",
-    "test:all": "npm run test:unit"
-  },
-  "keywords": [
-    "pixel",
-    "tracking",
-    "meta",
-    "caut",
-    "capi",
-    "tiktok",
-    "ga4",
-    "cloudflare",
-    "workers",
-    "d1",
-    "analytics",
-    "conversion",
-    "server-side"
-  ],
-  "author": "CDP Edge",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/ricardosoli777/CDP-Edge-Premium"
-  },
-  "bugs": {
-    "url": "https://github.com/ricardosoli777/CDP-Edge-Premium/issues"
-  },
-  "homepage": "https://github.com/ricardosoli777/CDP-Edge-Premium#readme",
-  "engines": {
-    "node": ">=18.0.0"
-  },
-  "dependencies": {
-    "chalk": "^5.3.0",
-    "commander": "^12.0.0",
-    "inquirer": "^9.2.0",
-    "ora": "^8.0.0"
-  },
-  "devDependencies": {
-    "@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.0.0",
-    "semantic-release": "^25.0.3"
-  }
-}
+{
+  "name": "cdp-edge",
+  "version": "1.3.0",
+  "description": "CDP Edge - Quantum Tracking - Sistema multi-agente para tracking digital Cloudflare Native (Workers + D1)",
+  "main": "dist/index.js",
+  "type": "module",
+  "bin": {
+    "cdp-edge": "./bin/cdp-edge.js",
+    "pb": "./bin/cdp-edge.js"
+  },
+  "files": [
+    "bin",
+    "dist",
+    "templates",
+    "contracts",
+    "extracted-skill",
+    "server-edge-tracker",
+    "scripts/build-sdk.js",
+    "docs",
+    "README.md"
+  ],
+  "scripts": {
+    "prepare": "node build.js",
+    "build": "node build.js",
+    "dev": "node build.js --watch",
+    "test": "node test.js",
+    "test:unit": "node tests/unit/normalization.test.js && node tests/unit/hashing.test.js && node tests/unit/deduplication.test.js && node tests/unit/payload-validation.test.js && node tests/unit/new-features.test.js && node tests/unit/utils.test.js",
+    "test:unit:normalize": "node tests/unit/normalization.test.js",
+    "test:unit:hash": "node tests/unit/hashing.test.js",
+    "test:unit:dedup": "node tests/unit/deduplication.test.js",
+    "test:unit:payload": "node tests/unit/payload-validation.test.js",
+    "test:unit:utils": "node tests/unit/utils.test.js",
+    "test:all": "npm run test:unit",
+    "test:integration": "cd tests/integration && npx vitest run",
+    "agents:check": "node scripts/validate-agents.js",
+    "agents:sync": "node scripts/sync-agents.js",
+    "agents:sync:list": "node scripts/sync-agents.js --list",
+    "agents:sync:all": "node scripts/sync-agents.js --apply-all",
+    "sdk:build": "node scripts/build-sdk.js",
+    "sdk:build:debug": "node scripts/build-sdk.js --debug",
+    "typecheck": "tsc --noEmit"
+  },
+  "keywords": [
+    "pixel",
+    "tracking",
+    "meta",
+    "caut",
+    "capi",
+    "tiktok",
+    "ga4",
+    "cloudflare",
+    "workers",
+    "d1",
+    "analytics",
+    "conversion",
+    "server-side"
+  ],
+  "author": "CDP Edge",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ricardosoli777/CDP-Edge-Premium.ts"
+  },
+  "bugs": {
+    "url": "https://github.com/ricardosoli777/CDP-Edge-Premium.ts/issues"
+  },
+  "homepage": "https://github.com/ricardosoli777/CDP-Edge-Premium.ts#readme",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "chalk": "^5.3.0",
+    "commander": "^14.0.3",
+    "inquirer": "^13.4.2",
+    "ora": "^9.4.0"
+  },
+  "devDependencies": {
+    "@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": "^25.6.0",
+    "esbuild": "^0.28.0",
+    "semantic-release": "^25.0.3",
+    "typescript": "^6.0.3"
+  }
+}

package/scripts/build-sdk.js

@@ -0,0 +1,106 @@
+/**
+ * CDP Edge — SDK Build Script
+ *
+ * Gera cdpTrack.min.js: bundle único pronto para <script src=""> em qualquer site.
+ * Entrada: extracted-skill/tracking-events-generator/cdpTrack.js (ES Module)
+ * Saída:   dist/sdk/cdpTrack.min.js   — minificado (produção)
+ *          dist/sdk/cdpTrack.js       — legível (debug)
+ *
+ * Uso:
+ *   node scripts/build-sdk.js
+ *   node scripts/build-sdk.js --debug   (só versão legível)
+ */
+
+import { build } from 'esbuild';
+import { readFileSync, writeFileSync, mkdirSync } from 'fs';
+import { resolve, dirname } from 'path';
+import { fileURLToPath } from 'url';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const ROOT = resolve(__dirname, '..');
+const SDK_DIR = resolve(ROOT, 'extracted-skill/tracking-events-generator');
+const OUT_DIR = resolve(ROOT, 'dist/sdk');
+
+const debugOnly = process.argv.includes('--debug');
+
+// Garante que o diretório de saída existe
+mkdirSync(OUT_DIR, { recursive: true });
+
+// ── Banner do bundle ──────────────────────────────────────────────────────────
+const pkg = JSON.parse(readFileSync(resolve(ROOT, 'package.json'), 'utf-8'));
+const banner = `/*!
+ * CDP Edge SDK v${pkg.version}
+ * (c) ${new Date().getFullYear()} CDP Edge — Quantum Tracking
+ * Gerado em: ${new Date().toISOString()}
+ * Endpoint padrão: /track (mesmo domínio — anti-adblock)
+ */`;
+
+// ── Configuração base do esbuild ──────────────────────────────────────────────
+const baseConfig = {
+  entryPoints: [resolve(SDK_DIR, 'cdpTrack.js')],
+  bundle: true,
+  format: 'iife',           // <script> tag — expõe window.cdpTrack
+  globalName: 'cdpTrack',   // window.cdpTrack após carregar
+  platform: 'browser',
+  target: ['es2018'],       // suporta Safari 12+, Chrome 69+, Firefox 62+
+  banner: { js: banner },
+  define: {
+    'process.env.NODE_ENV': '"production"',
+  },
+  // Resolve módulos locais pelo diretório do SDK
+  absWorkingDir: SDK_DIR,
+};
+
+async function buildSDK() {
+  console.log('🏗️  Buildando CDP Edge SDK...\n');
+
+  // ── Versão debug (legível) ────────────────────────────────────────────────
+  console.log('📦 Gerando cdpTrack.js (debug)...');
+  await build({
+    ...baseConfig,
+    outfile: resolve(OUT_DIR, 'cdpTrack.js'),
+    minify: false,
+    sourcemap: false,
+  });
+  const debugSize = (readFileSync(resolve(OUT_DIR, 'cdpTrack.js')).length / 1024).toFixed(1);
+  console.log(`   ✓ dist/sdk/cdpTrack.js — ${debugSize} kB`);
+
+  if (!debugOnly) {
+    // ── Versão produção (minificada) ────────────────────────────────────────
+    console.log('📦 Gerando cdpTrack.min.js (produção)...');
+    await build({
+      ...baseConfig,
+      outfile: resolve(OUT_DIR, 'cdpTrack.min.js'),
+      minify: true,
+      sourcemap: false,
+    });
+    const minSize = (readFileSync(resolve(OUT_DIR, 'cdpTrack.min.js')).length / 1024).toFixed(1);
+    console.log(`   ✓ dist/sdk/cdpTrack.min.js — ${minSize} kB`);
+  }
+
+  // ── Gera snippet de instalação ────────────────────────────────────────────
+  const snippet = `<!-- CDP Edge SDK v${pkg.version} — instalar antes do </body> -->
+<script src="/cdpTrack.min.js"></script>
+<script>
+  // Inicializar após carregar
+  document.addEventListener('DOMContentLoaded', function() {
+    if (window.cdpTrack && window.cdpTrack.init) {
+      window.cdpTrack.init();
+    }
+  });
+</script>`;
+
+  writeFileSync(resolve(OUT_DIR, 'install-snippet.html'), snippet, 'utf-8');
+  console.log(`   ✓ dist/sdk/install-snippet.html — snippet de instalação\n`);
+
+  console.log('✅ SDK build concluído!');
+  console.log('\n📋 Próximos passos para o cliente:');
+  console.log('   1. Copiar dist/sdk/cdpTrack.min.js para a raiz do site');
+  console.log('   2. Adicionar snippet de dist/sdk/install-snippet.html antes de </body>');
+  console.log('   3. O Worker deve estar no mesmo domínio (Custom Domain Cloudflare → /track)\n');
+}
+
+buildSDK().catch(err => {
+  console.error('❌ Build falhou:', err.message);
+  process.exit(1);
+});

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

@@ -0,0 +1,14 @@
+# CDP Edge — Variáveis do cliente para deploy
+# Copie este arquivo para .client.env e preencha com os dados reais.
+# .client.env é gitignored — NUNCA commitado.
+
+# Cloudflare D1 — obter com: wrangler d1 list
+DATABASE_ID=SEU_DATABASE_ID
+
+# Domínio do projeto (sem https://)
+SITE_DOMAIN=seudominio.com.br
+
+# Pixels de rastreamento (opcional — deixar vazio se não usar)
+META_PIXEL_ID=
+GA4_MEASUREMENT_ID=
+TIKTOK_PIXEL_ID=