cdp-edge 1.23.2 → 1.24.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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cdp-edge",
-  "version": "1.23.2",
+  "version": "1.24.0",
   "description": "CDP Edge - Quantum Tracking - Sistema multi-agente para tracking digital Cloudflare Native (Workers + D1)",
   "main": "dist/index.js",
   "type": "module",
@@ -23,17 +23,19 @@
     "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",
+    "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"
+    "agents:sync:all": "node scripts/sync-agents.js --apply-all",
+    "typecheck": "tsc --noEmit"
   },
   "keywords": [
     "pixel",
@@ -70,12 +72,14 @@
     "ora": "^8.0.0"
   },
   "devDependencies": {
+    "@cloudflare/workers-types": "^4.20260412.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": "^20.0.0",
-    "semantic-release": "^25.0.3"
+    "@types/node": "^20.19.39",
+    "semantic-release": "^25.0.3",
+    "typescript": "^6.0.2"
   }
 }

package/server-edge-tracker/INSTALAR.md

@@ -298,7 +298,7 @@ wrangler d1 execute cdp-edge-db --remote --command="SELECT event_name, email, ci
 ```
 ERROR: Can't deploy routes that are assigned to another worker.
 "server-edge-tracker" is already assigned to routes:
-  - lancamentosabc.com.br/track*
+  - SEU_DOMINIO/track*
 ```
 
 ### SOLUÇÃO 1 — Via Painel Cloudflare (RECOMENDADO):
@@ -306,7 +306,7 @@ ERROR: Can't deploy routes that are assigned to another worker.
 1. Acesse: https://dash.cloudflare.com/[ID_DA_CONTA]/workers/overview
 2. Clique no worker que está usando as rotas do seu domínio
 3. Vá em Settings → Triggers → Routes
-4. Clique "Delete" nas rotas do domínio `lancamentosabc.com.br`
+4. Clique "Delete" nas rotas do domínio `SEU_DOMINIO`
 5. Repita o `wrangler deploy`
 
 ### SOLUÇÃO 2 — Via Wrangler CLI:
@@ -325,11 +325,11 @@ Se não quiser remover rotas existentes, use sufixo:
 
 ```toml
 [[routes]]
-pattern = "lancamentosabc.com.br/track-worker-novo*"
-zone_name = "lancamentosabc.com.br"
+pattern = "SEU_DOMINIO/track-worker-novo*"
+zone_name = "SEU_DOMINIO"
 ```
 
-**URL do tracking:** `https://lancamentosabc.com.br/track-worker-novo`
+**URL do tracking:** `https://SEU_DOMINIO/track-worker-novo`
 
 ---