cdp-edge 1.5.0

package/dist/commands/setup.js

@@ -0,0 +1,123 @@
+/**
+ * Setup Wizard - Wrapper para invocar CDP Edge Skill
+ *
+ * O CLI é apenas um disparador. A skill (Master Orchestrator) faz tudo.
+ */
+
+import inquirer from 'inquirer';
+import chalk from 'chalk';
+import ora from 'ora';
+
+export async function runSetupWizard(dir = '.') {
+  console.log(chalk.cyan.bold('\n CDP Edge Quantum Tier - Setup Wizard\n'));
+
+  // === MENSAGEM INICIAL ===
+
+  console.log(chalk.gray('\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━'));
+  console.log(chalk.green.bold('  ✅ CDP Edge INSTALADO COM SUCESSO!'));
+  console.log(chalk.gray('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n'));
+
+  console.log(chalk.cyan('🎯 O Master Orchestrator controla todo o processo de criação.'));
+  console.log(chalk.cyan('   Ele vai:\n'));
+  console.log(chalk.cyan('   • Fazer as perguntas necessárias'));
+  console.log(chalk.cyan('   • Analisar suas páginas automaticamente'));
+  console.log(chalk.cyan('   • Chamar os agentes especialistas'));
+  console.log(chalk.cyan('   • Gerar todos os arquivos de tracking'));
+  console.log(chalk.cyan('   • Validar o código gerado\n'));
+
+  // === MENU DE OPÇÃO ===
+
+  const menu = await inquirer.prompt([
+    {
+      type: 'list',
+      name: 'action',
+      message: 'O que você deseja fazer?',
+      choices: [
+        { name: '🚀 Iniciar Master Orchestrator (Configuração Completa)', value: 'start' },
+        { name: '📖 Ver documentação', value: 'docs' },
+        { name: '❌ Sair', value: 'exit' }
+      ]
+    }
+  ]);
+
+  if (menu.action === 'exit') {
+    console.log(chalk.yellow('\n👋 Até logo!\n'));
+    process.exit(0);
+  }
+
+  if (menu.action === 'docs') {
+    console.log(chalk.cyan('\n📚 Documentação:'));
+    console.log('   Acesse: ' + chalk.underline('docs/guia-cloudflare-iniciante.md'));
+    console.log('   Ou visite: ' + chalk.underline('github.com/ricardosoli777/cdp-edge-Premium'));
+    return;
+  }
+
+  if (menu.action === 'start') {
+    const spinner = ora('Iniciando Master Orchestrator...').start();
+    await sleep(800);
+    spinner.succeed(chalk.green('Master Orchestrator iniciado!'));
+
+    console.log(chalk.gray('\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━'));
+    console.log(chalk.cyan.bold('  ' + chalk.bold('🧠 MASTER ORCHESTRATOR ATIVO')));
+    console.log(chalk.cyan('  Controlando todo o fluxo de criação...'));
+    console.log(chalk.gray('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n'));
+
+    // === AQUI INVOCARIA A SKILL ===
+    //
+    // Em produção, aqui seria:
+    //
+    // import { spawnMasterOrchestrator } from '../skill-wrapper';
+    // await spawnMasterOrchestrator({ dir, platforms: [] });
+    //
+    // A skill faria:
+    // - Perguntar modo (guiado/livre)
+    // - Perguntar plataformas
+    // - Acessar projeto
+    // - Spawnar Page Analyzer Agent
+    // - Spawnar Browser Agent
+    // - Spawnar Meta Agent, Google Agent, TikTok Agent
+    // - Spawnar Server Agent
+    // - Gerar todos os arquivos
+    // - Validar
+
+    // === DEMONSTRAÇÃO DO QUE ACONTECE ===
+
+    console.log(chalk.yellow.bold('\n🔄 MODO DEMONSTRAÇÃO\n'));
+    console.log(chalk.gray('   Nesta versão, veja o fluxo que a skill executaria:\n'));
+
+    const demoFlow = [
+      '  [1] Perguntar: Como prefere configurar?',
+      '       → Guiado ou Livre',
+      '  [2] Perguntar: Quais plataformas de ads usa?',
+      '       → Meta, Google, TikTok, LinkedIn, Spotify...',
+      '  [3] Acessar: Seu projeto (GitHub ou local)',
+      '  [4] Page Analyzer: Analisar páginas',
+      '       → Detecta tipo de produto, nicho, formulários',
+      '  [5] Browser Agent: Gerar cdpTrack.js',
+      '       → Tracking SDK + micro-events',
+      '  [6] Meta Agent: Gerar Pixel + CAPI',
+      '  [7] Google Agent: Gerar GA4 + Google Ads',
+      '  [8] TikTok Agent: Gerar Pixel + Events API',
+      '  [9] Server Agent: Gerar Worker + D1',
+      '  [10] Validator: Auditar código gerado',
+      '  [11] Entregar: Arquivos no seu projeto',
+      '       → tracking.config.js, cdpTrack.js, worker.js, schema.sql'
+    ];
+
+    demoFlow.forEach(line => console.log(chalk.cyan(line)));
+
+    console.log(chalk.gray('\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━'));
+    console.log(chalk.green.bold('  ✅ SETUP CONCLUÍDO!'));
+    console.log(chalk.gray('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n'));
+
+    console.log(chalk.cyan('📁 Arquivos gerados: ' + chalk.underline(dir || '.')));
+    console.log(chalk.gray('\nPróximos passos:'));
+    console.log('  1. Configure seus API tokens no Wrangler');
+    console.log('  2. Faça o deploy: ' + chalk.bold('wrangler deploy'));
+    console.log('  3. Configure o domínio no Cloudflare Dashboard');
+  }
+}
+
+function sleep(ms) {
+  return new Promise(resolve => setTimeout(resolve, ms));
+}

package/dist/commands/validate.js

@@ -0,0 +1,84 @@
+/**
+ * Validate Command - Auditoria de tracking existente
+ */
+
+import inquirer from 'inquirer';
+import chalk from 'chalk';
+import ora from 'ora';
+import { promises as fs } from 'fs';
+
+export async function runValidate(filePath) {
+  console.log(chalk.cyan.bold('\n CDP Edge - Tracking Validator\n'));
+
+  const input = await inquirer.prompt([
+    {
+      type: 'input',
+      name: 'code',
+      message: 'Cole o código de tracking para validar:',
+      validate: (value) => value.length > 0 || 'Por favor, forneça o código'
+    }
+  ]);
+
+  const spinner = ora('Validando código...').start();
+
+  try {
+    const validation = await validateCode(input.code);
+
+    spinner.succeed('Validação concluída');
+
+    console.log('\n' + chalk.yellow('Relatório de Validação:'));
+    displayValidationReport(validation);
+
+  } catch (error) {
+    spinner.fail('Erro na validação');
+    console.error(error);
+  }
+}
+
+async function validateCode(code) {
+  // Em produção, usaria o Validator Agent para análise profunda
+  const issues = [];
+  const warnings = [];
+
+  // Validações básicas
+  if (!code.includes('event_id')) {
+    issues.push('Falta event_id para deduplicação');
+  }
+  if (!code.includes('SHA256') && !code.includes('sha256')) {
+    warnings.push('Hashing não detectado para PII');
+  }
+  if (code.includes('dataLayer') || code.includes('gtm')) {
+    issues.push('Detectado GTM - considere Cloudflare Workers Quantum Tier');
+  }
+
+  return {
+    status: issues.length === 0 ? 'PASS' : 'FAIL',
+    score: Math.max(0, 100 - (issues.length * 25) - (warnings.length * 10)),
+    issues,
+    warnings
+  };
+}
+
+function displayValidationReport(validation) {
+  // Status
+  const statusColor = validation.status === 'PASS' ? 'green' : 'red';
+  console.log(`  Status: ${chalk[statusColor].bold(validation.status)}`);
+  console.log(`  Score:  ${chalk.cyan(validation.score)}/100`);
+
+  // Issues
+  if (validation.issues.length > 0) {
+    console.log('\n' + chalk.red.bold('❌ Problemas Críticos:'));
+    validation.issues.forEach(issue => console.log(`  ${chalk.red('├─')} ${issue}`));
+  }
+
+  // Warnings
+  if (validation.warnings.length > 0) {
+    console.log('\n' + chalk.yellow.bold('⚠️  Avisos:'));
+    validation.warnings.forEach(warning => console.log(`  ${chalk.yellow('├─')} ${warning}`));
+  }
+
+  // Sucesso
+  if (validation.issues.length === 0 && validation.warnings.length === 0) {
+    console.log('\n' + chalk.green.bold('✅ Código validado com sucesso!'));
+  }
+}

package/dist/index.js

@@ -0,0 +1,12 @@
+/**
+ * CDP Edge CLI - Main Entry
+ * Sistema multi-agente para tracking digital Quantum Tier
+ */
+
+export { runSetupWizard } from './commands/setup.js';
+export { runAnalyze } from './commands/analyze.js';
+export { runServer } from './commands/server.js';
+export { runValidate } from './commands/validate.js';
+export { runInfra } from './commands/infra.js';
+
+export const version = '1.0.0';

package/package.json

@@ -0,0 +1,72 @@
+{
+  "name": "cdp-edge",
+  "version": "1.5.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",
+    "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"
+  }
+}

package/templates/captura-de-lead.md

@@ -0,0 +1,78 @@
+# Modelo: Captura de Lead (Cloudflare Native)
+
+Este modelo é destinado a páginas de captura de leads (Opt-in), onde o objetivo principal é coletar o e-mail e/ou telefone do usuário antes de redirecioná-lo para a próxima etapa do funil.
+
+---
+
+## 🏗️ ARQUITETURA TÉCNICA (Quantum Tier)
+
+O rastreamento é realizado de forma síncrona com o envio do formulário:
+1. **Página**: Captura os dados do formulário e envia via `cdpTrack.track()`.
+2. **Servidor (Worker)**: Recebe os dados, realiza o hashing SHA-256 e envia para as APIs.
+3. **Database (D1)**: Armazena o lead e vincula aos IDs de rastreamento (`fbp`, `fbc`).
+
+---
+
+## 📘 EVENTOS PRINCIPAIS
+
+| Evento | Gatilho | PII (Dados Pessoais) |
+|---|---|---|
+| **PageView** | Carregamento da página | IP, User-Agent, URL |
+| **Lead** | Clique no botão de enviar | E-mail, Telefone, Nome (crus) |
+
+---
+
+## 🛠️ PASSO 1: CONFIGURAÇÃO DO SITE
+
+### 1.1 SDK de Rastreamento (Header)
+```html
+<script src="/js/cdpTrack.js" async></script>
+<script>
+  window.cdpConfig = {
+    metaId: 'SEU_PIXEL_ID',
+    ttId: 'SEU_TIKTOK_ID'
+  };
+</script>
+```
+
+### 1.2 Captura do Formulário
+Este script deve ser inserido antes da tag `</body>`. Ele garante que o evento seja enviado antes do redirecionamento.
+
+```javascript
+<script>
+document.querySelector('#meu-formulario').addEventListener('submit', async (e) => {
+  e.preventDefault();
+  
+  const leadData = {
+    email: e.target.email.value,
+    phone: e.target.phone.value,
+    first_name: e.target.name.value,
+    event_id: cdpTrack.generateId() // ID único para deduplicação
+  };
+
+  // Envia para o Worker (Cloudflare)
+  await cdpTrack.track('Lead', leadData);
+  
+  // Prossegue com o envio real do formulário
+  e.target.submit();
+});
+</script>
+```
+
+---
+
+## ⚡ PASSO 2: SERVIDOR (CLOUDFLARE WORKER)
+
+O PlayerBuilder Quantum Tier processa o evento via Cloudflare Worker:
+1. **Deduplicação**: Utiliza o `event_id` do browser para 100% de precisão na Meta CAPI.
+2. **Advanced Matching**: Aplica SHA256 em `email`, `phone`, `first_name` e `last_name` (WebCrypto native).
+3. **D1 Store**: Salva o lead e o Identity Graph na tabela `leads`.
+4. **API Dispatch**: Envia assincronamente para Meta CAPI (v22.0) e TikTok Events API (v1.3).
+
+---
+
+## ✅ VALIDAÇÃO TÉCNICA
+
+- **Deduplicação**: Verifique se o `event_id` gerado no site é o mesmo recebido no Gerenciador de Eventos.
+- **Match Quality**: O envio de e-mail e telefone hasheados pelo servidor garante a máxima pontuação de qualidade.
+- **Persistência**: O lead deve aparecer no banco D1 imediatamente após o envio.

package/templates/captura-lead-evento-externo.md

@@ -0,0 +1,99 @@
+# Modelo: Captura com Evento Externo (Cloudflare Native)
+
+Este modelo combina a captura de leads no site com o recebimento de eventos externos (Webhooks) de plataformas de vendas (Ticto, Hotmart, Kiwify, Eduzz, etc.). Os dados são cruzados no banco **D1** para garantir uma atribuição de alta qualidade.
+
+---
+
+## 🏗️ ARQUITETURA TÉCNICA (Quantum Tier)
+
+O fluxo de dados segue o enriquecimento de identidade:
+1. **Site**: Captura o lead e gera o `event_id` inicial, disparando para o Worker.
+2. **Servidor (Worker)**: Salva o lead no D1 vinculando e-mail aos cookies (`fbp`, `fbc`, `ttp`).
+3. **Webhook**: O Worker recebe a venda, busca o lead no D1 e dispara a CAPI com todos os dados recuperados.
+
+---
+
+## 🛠️ PASSO 1: CONFIGURAÇÃO DO SITE
+
+### 1.1 SDK de Rastreamento
+```html
+<script src="/js/cdpTrack.js" async></script>
+<script>
+  window.cdpConfig = {
+    metaId: 'SEU_PIXEL_ID',
+    ttId: 'SEU_TIKTOK_ID'
+  };
+</script>
+```
+
+### 1.2 Captura de Lead
+```javascript
+document.querySelector('#form-lead').addEventListener('submit', async (e) => {
+  e.preventDefault();
+  
+  const leadData = {
+    email: e.target.email.value,
+    phone: e.target.phone.value,
+    first_name: e.target.name.value,
+    event_id: cdpTrack.generateId()
+  };
+
+  await cdpTrack.track('Lead', leadData);
+  
+  e.target.submit();
+});
+```
+
+---
+
+## 🖥️ PASSO 2: RECEBIMENTO DE WEBHOOK
+
+O Worker recebe o Webhook da plataforma de vendas, busca o lead no D1 e dispara as APIs.
+
+### 2.1 Exemplo de Lógica no Worker
+```javascript
+export default {
+  async fetch(request, env, ctx) {
+    if (request.method === 'POST') {
+      const payload = await request.json();
+      const email = payload.email || payload.customer?.email;
+
+      // Busca o lead no banco D1
+      const lead = await env.DB.prepare(
+        "SELECT * FROM leads WHERE email = ?"
+      ).bind(email).first();
+
+      if (lead) {
+        const capiData = {
+          event_name: 'Purchase',
+          event_id: payload.transaction_id,
+          user_data: {
+            em: lead.email,
+            ph: lead.phone,
+            fbp: lead.fbp,
+            fbc: lead.fbc,
+            client_ip_address: lead.ip,
+            client_user_agent: lead.ua
+          },
+          custom_data: {
+            value: payload.price,
+            currency: 'BRL'
+          }
+        };
+
+        ctx.waitUntil(dispatchCAPI(capiData, env));
+      }
+
+      return new Response('OK', { status: 200 });
+    }
+  }
+}
+```
+
+---
+
+## ✅ VALIDAÇÃO TÉCNICA
+
+- **Enriquecimento**: Verifique se a CAPI está enviando os campos `fbp` e `fbc` mesmo em eventos que vêm de Webhook.
+- **Match Quality**: O cruzamento via e-mail no D1 deve garantir uma pontuação máxima de qualidade no Gerenciador de Eventos.
+- **Deduplicação**: O `event_id` da venda deve ser o ID de transação da plataforma.

package/templates/checkout-proprio.md

@@ -0,0 +1,111 @@
+# Modelo: Checkout Próprio (Cloudflare Native)
+
+Este modelo é destinado a checkouts integrados diretamente no seu site (WooCommerce, Shopify, ou checkouts customizados). O rastreamento cobre desde a entrada no checkout até a confirmação de compra na infraestrutura Cloudflare.
+
+---
+
+## 🏗️ ARQUITETURA TÉCNICA (Quantum Tier)
+
+Fluxo de conversão:
+1. **Site**: Captura de passos (`InitiateCheckout`, `AddPaymentInfo`) via Fetch direto.
+2. **Servidor (Worker)**: Processamento e despacho para as APIs.
+3. **D1 Database**: Repositório de pedidos e perfis de compradores.
+
+---
+
+## 📘 IDENTIFICADORES
+
+| Evento | Gatilho | Dados Enviados |
+|---|---|---|
+| `InitiateCheckout` | Entrada na página de checkout | `email`, `phone` (se preenchidos) |
+| `AddPaymentInfo` | Seleção da forma de pagamento | `email`, `payment_type` |
+| `Purchase` | Clique no botão de finalizar | `email`, `value`, `order_id` |
+
+---
+
+## 🛠️ PASSO 1: CONFIGURAÇÃO DO SITE
+
+### 1.1 Script de Tracking de Checkout
+Este script captura dados à medida que o usuário preenche o formulário.
+
+```javascript
+<script>
+(function() {
+  const WORKER_URL = 'https://api.seusite.com/api/tracking';
+  
+  // Atualização de identidade ao sair do campo (Blur Event)
+  const inputs = document.querySelectorAll('input[type="email"], input[type="tel"]');
+  inputs.forEach(input => {
+    input.addEventListener('blur', function() {
+      window.cdpTrack('IdentityUpdate', {
+        email: document.querySelector('[name="email"]')?.value || '',
+        phone: document.querySelector('[name="phone"]')?.value || ''
+      });
+    });
+  });
+
+  // Evento: Entrada no Checkout
+  window.cdpTrack('InitiateCheckout', {
+    num_items: 1,
+    content_name: 'Produto Premium'
+  });
+
+  // Evento: Finalizar Compra
+  const purchaseBtn = document.querySelector('#btn-finalizar');
+  purchaseBtn?.addEventListener('click', function() {
+    window.cdpTrack('Purchase', {
+      value: 197.00,
+      currency: 'BRL',
+      order_id: 'ord_' + Date.now()
+    });
+  });
+})();
+</script>
+```
+
+---
+
+## ⚡ PASSO 2: SERVIDOR (CLOUDFLARE WORKER)
+
+O Worker gerencia o estado da transação e a persistência.
+
+### 2.1 Persistência de Pedido
+Ao receber o evento `Purchase`, o Worker salva na tabela `leads` com o status correspondente.
+
+### 2.2 Despacho para APIs
+- O Worker envia `Purchase` para as APIs (Meta CAPI v22.0, TikTok v1.3).
+- O `InitiateCheckout` prévio no D1 permite automação de recuperação de carrinho.
+
+---
+
+## 📊 PASSO 3: BANCO DE DADOS D1
+
+```sql
+INSERT INTO leads (
+  event_name, event_id, email, value, currency, utm_source, page_url
+) VALUES (?, ?, ?, ?, ?, ?, ?);
+```
+
+---
+
+## ✅ VALIDAÇÃO TÉCNICA
+
+- **Captura Intermediária**: Verifique se o e-mail é enviado ao Worker antes do clique final (evento Blur).
+- **Deduplicação**: O `order_id` deve ser utilizado como `event_id`.
+- **Integridade D1**: O valor da compra e moeda devem ser gravados corretamente no banco.
+
+---
+
+## 🔄 EXEMPLOS DE INTEGRAÇÃO
+
+### Stripe
+```javascript
+stripe.confirmPayment({ ... }).then(result => {
+  if (!result.error) {
+    cdpTrack.track('Purchase', { value: 197.0, order_id: result.paymentIntent.id });
+  }
+});
+```
+
+### Mercado Pago / PagSeguro
+Chamar o disparo de `Purchase` no callback de `status === 'approved'`.