cdp-edge 1.17.0 → 2.0.0

package/extracted-skill/tracking-events-generator/advanced-matching.js

@@ -1,364 +1,364 @@
-/**
- * ADVANCED MATCHING MAXIMUM - CDP Edge (Quantum Tier)
- *
- * Sistema de normalização e hashing de PII (Personally Identifiable Information)
- * para máxima precisão de atribuição em Meta CAPI v22.0.
- *
- * @version 1.0.0
- */
-
-// ── Guards ────────────────────────────────────────────────
-const isBrowser = typeof window !== 'undefined';
-
-// ── Configurações de Normalização ─────────────────────
-
-const NORMALIZATION_CONFIG = {
-  email: {
-    trim: true,
-    lowercase: true,
-    removeDots: false, // Gmail: user.name@gmail.com vs username@gmail.com (diferentes)
-    removePlus: true // Gmail: user+tag@gmail.com = user@gmail.com (mesmo)
-  },
-  phone: {
-    keepOnlyDigits: true,
-    addCountryCode: true, // Adiciona DDI se não tiver (55 para Brasil)
-    defaultCountryCode: '55'
-  },
-  name: {
-    trim: true,
-    lowercase: true,
-    removeAccents: true,
-    removeExtraSpaces: true,
-    maxLength: 100
-  },
-  city: {
-    trim: true,
-    lowercase: true,
-    removeAccents: true,
-    maxLength: 50
-  },
-  state: {
-    trim: true,
-    lowercase: true,
-    removeAccents: true,
-    maxLength: 50
-  },
-  zip: {
-    trim: true,
-    keepOnlyDigits: true,
-    maxLength: 10
-  }
-};
-
-// ── Funções de Normalização ──────────────────────────────
-
-/**
- * Normaliza e-mail para máximo match
- *
- * Gmail Plus: user+tag@gmail.com = user@gmail.com (mesmo usuário)
- * Lowercase: USER@GMAIL.COM = user@gmail.com (case-insensitive)
- * Trim: remove espaços
- *
- * @param {string} email - E-mail bruto
- * @returns {string} E-mail normalizado
- */
-function normalizeEmail(email) {
-  if (!email || typeof email !== 'string') return '';
-
-  let normalized = email.trim();
-
-  // Gmail: remover tudo após + (plus addressing)
-  if (normalized.includes('@gmail.com')) {
-    normalized = normalized.split('+')[0] + '@gmail.com';
-  }
-  // GMR (Google Mail): remover plus
-  if (normalized.includes('@googlemail.com')) {
-    normalized = normalized.split('+')[0] + '@googlemail.com';
-  }
-
-  return normalized.toLowerCase();
-}
-
-/**
- * Normaliza telefone para máximo match
- *
- * Remove caracteres não numéricos
- * Adiciona código do país (55 para Brasil) se não tiver
- *
- * @param {string} phone - Telefone bruto
- * @returns {string} Telefone normalizado (apenas números)
- */
-function normalizePhone(phone) {
-  if (!phone || typeof phone !== 'string') return '';
-
-  // Remove tudo que não é número
-  let normalized = phone.replace(/\D/g, '');
-
-  // Se não tem DDI, adiciona 55 (Brasil)
-  if (normalized.length === 11 || normalized.length === 10) {
-    normalized = '55' + normalized;
-  }
-
-  // Limita a 15 dígitos (máximo internacional)
-  return normalized.substring(0, 15);
-}
-
-/**
- * Normaliza nome para máximo match
- *
- * Remove acentos, converte para minúsculas, remove espaços extras
- *
- * @param {string} name - Nome bruto
- * @returns {string} Nome normalizado
- */
-function normalizeName(name) {
-  if (!name || typeof name !== 'string') return '';
-
-  let normalized = name.trim();
-
-  // Remove acentos
-  normalized = normalized.normalize('NFD').replace(/[\u0300-\u036f]/g, '');
-
-  // Converte para minúsculas
-  normalized = normalized.toLowerCase();
-
-  // Remove espaços extras (múltiplos espaços vira um)
-  normalized = normalized.replace(/\s+/g, ' ');
-
-  // Limita tamanho
-  return normalized.substring(0, NORMALIZATION_CONFIG.name.maxLength);
-}
-
-/**
- * Normaliza cidade para Meta AM (Advanced Matching)
- *
- * @param {string} city - Cidade bruta
- * @returns {string} Cidade normalizada
- */
-function normalizeCity(city) {
-  if (!city || typeof city !== 'string') return '';
-
-  let normalized = city.trim();
-
-  // Remove acentos
-  normalized = normalized.normalize('NFD').replace(/[\u0300-\u036f]/g, '');
-
-  // Converte para minúsculas
-  normalized = normalized.toLowerCase();
-
-  // Remove espaços extras
-  normalized = normalized.replace(/\s+/g, ' ');
-
-  return normalized.substring(0, NORMALIZATION_CONFIG.city.maxLength);
-}
-
-/**
- * Normaliza estado para Meta AM
- *
- * @param {string} state - Estado bruto
- * @returns {string} Estado normalizado
- */
-function normalizeState(state) {
-  if (!state || typeof state !== 'string') return '';
-
-  let normalized = state.trim();
-
-  // Remove acentos
-  normalized = normalized.normalize('NFD').replace(/[\u0300-\u036f]/g, '');
-
-  // Converte para minúsculas
-  normalized = normalized.toLowerCase();
-
-  return normalized.substring(0, NORMALIZATION_CONFIG.state.maxLength);
-}
-
-/**
- * Normaliza CEP para Meta AM
- *
- * @param {string} zip - CEP bruto
- * @returns {string} CEP normalizado (apenas números)
- */
-function normalizeZip(zip) {
-  if (!zip || typeof zip !== 'string') return '';
-
-  // Remove tudo que não é número
-  const normalized = zip.replace(/\D/g, '');
-
-  return normalized.substring(0, NORMALIZATION_CONFIG.zip.maxLength);
-}
-
-/**
- * Normaliza data de nascimento para Meta AM
- *
- * Formato esperado: YYYYMMDD
- *
- * @param {string} dob - Data de nascimento bruta
- * @returns {string} Data normalizada (YYYYMMDD)
- */
-function normalizeDOB(dob) {
-  if (!dob || typeof dob !== 'string') return '';
-
-  // Tenta diferentes formatos
-  const formats = [
-    /(\d{4})-(\d{2})-(\d{2})/, // YYYY-MM-DD
-    /(\d{2})\/(\d{2})\/(\d{4})/, // DD/MM/YYYY
-    /(\d{2})-(\d{2})-(\d{4})/  // DD-MM-YYYY
-  ];
-
-  for (const format of formats) {
-    const match = dob.match(format);
-    if (match) {
-      let year, month, day;
-      if (match[1].length === 4) {
-        // YYYY-MM-DD
-        [year, month, day] = [match[1], match[2], match[3]];
-      } else {
-        // DD/MM/YYYY
-        [day, month, year] = [match[1], match[2], match[3]];
-      }
-      return `${year}${month}${day}`;
-    }
-  }
-
-  return '';
-}
-
-// ── Browser-Side: Dados Crus para Worker ───────────
-
-/**
- * Extrai dados PII de um formulário HTML para Advanced Matching
- *
- * @param {HTMLFormElement} form - Elemento do formulário
- * @returns {object} Dados normalizados para envio ao Worker
- */
-export function extractFormPII(form) {
-  if (!form || typeof form.elements !== 'object') return {};
-
-  const formData = new FormData(form);
-  const piiData = {};
-
-  // Campo de e-mail
-  const email = formData.get('email') || formData.get('user_email') || formData.get('useremail');
-  if (email) piiData.email = normalizeEmail(email);
-
-  // Campo de telefone
-  const phone = formData.get('phone') || formData.get('telephone') || formData.get('telefone') || formData.get('celular');
-  if (phone) piiData.phone = normalizePhone(phone);
-
-  // Campos de nome
-  const firstName = formData.get('first_name') || formData.get('nome') || formData.get('firstname');
-  const lastName = formData.get('last_name') || formData.get('sobrenome') || formData.get('lastname');
-  const fullName = formData.get('name') || formData.get('fullname') || formData.get('nome_completo');
-
-  if (fullName) {
-    const names = fullName.split(' ');
-    piiData.first_name = normalizeName(names[0]);
-    piiData.last_name = normalizeName(names.slice(1).join(' '));
-  } else {
-    if (firstName) piiData.first_name = normalizeName(firstName);
-    if (lastName) piiData.last_name = normalizeName(lastName);
-  }
-
-  // Campos de endereço (Meta AM)
-  const city = formData.get('city') || formData.get('cidade');
-  if (city) piiData.city = normalizeCity(city);
-
-  const state = formData.get('state') || formData.get('estado') || formData.get('uf');
-  if (state) piiData.state = normalizeState(state);
-
-  const zip = formData.get('zip') || formData.get('cep') || formData.get('postalcode');
-  if (zip) piiData.zip = normalizeZip(zip);
-
-  const dob = formData.get('dob') || formData.get('date_of_birth') || formData.get('nascimento');
-  if (dob) piiData.dob = normalizeDOB(dob);
-
-  return piiData;
-}
-
-/**
- * Captura dados PII de qualquer elemento (input, button click, etc.)
- *
- * @param {HTMLElement} element - Elemento DOM
- * @returns {object} Dados PII normalizados
- */
-export function capturePII(element) {
-  if (!element) return {};
-
-  const piiData = {};
-
-  // Se for input, extrair valor
-  if (element.tagName === 'INPUT' || element.tagName === 'TEXTAREA') {
-    const name = element.name.toLowerCase();
-    const value = element.value;
-
-    if (name.includes('email') && value) {
-      piiData.email = normalizeEmail(value);
-    } else if (name.includes('phone') || name.includes('telefone') || name.includes('celular')) {
-      if (value) piiData.phone = normalizePhone(value);
-    } else if (name.includes('name') || name.includes('nome')) {
-      if (value) piiData.full_name = normalizeName(value);
-    } else if (name.includes('city') || name.includes('cidade')) {
-      if (value) piiData.city = normalizeCity(value);
-    } else if (name.includes('state') || name.includes('estado')) {
-      if (value) piiData.state = normalizeState(value);
-    } else if (name.includes('zip') || name.includes('cep')) {
-      if (value) piiData.zip = normalizeZip(value);
-    }
-  }
-
-  return piiData;
-}
-
-/**
- * Valida se os dados PII são válidos para envio
- *
- * @param {object} piiData - Dados PII normalizados
- * @returns {boolean} True se tiver dados válidos
- */
-export function isValidPII(piiData) {
-  if (!piiData || typeof piiData !== 'object') return false;
-
-  const hasEmail = piiData.email && piiData.email.includes('@');
-  const hasPhone = piiData.phone && piiData.phone.length >= 10;
-
-  return hasEmail || hasPhone;
-}
-
-// ── Browser-Side: Hashing (Opcional - para debug) ────────
-
-/**
- * Calcula SHA256 de um valor (browser-side)
- *
- * AVISO: Para máxima segurança, o hashing deve ser feito no Worker.
- * Esta função é apenas para debug/visualização.
- *
- * @param {string} value - Valor para hash
- * @returns {Promise<string>} Hash SHA256 em hexadecimal
- */
-export async function hashPII(value) {
-  if (!value || !isBrowser) return '';
-
-  try {
-    const encoder = new TextEncoder();
-    const data = encoder.encode(value);
-    const hashBuffer = await crypto.subtle.digest('SHA-256', data);
-    const hashArray = Array.from(new Uint8Array(hashBuffer));
-    return hashArray.map(byte => byte.toString(16).padStart(2, '0')).join('');
-  } catch (error) {
-    console.error('Erro ao calcular SHA256 no browser:', error);
-    return '';
-  }
-}
-
-// ── Exportações ────────────────────────────────────────────────
-
-export {
-  normalizeEmail,
-  normalizePhone,
-  normalizeName,
-  normalizeCity,
-  normalizeState,
-  normalizeZip,
-  normalizeDOB,
-  NORMALIZATION_CONFIG
-};
+/**
+ * ADVANCED MATCHING MAXIMUM - CDP Edge (Quantum Tier)
+ *
+ * Sistema de normalização e hashing de PII (Personally Identifiable Information)
+ * para máxima precisão de atribuição em Meta CAPI v22.0.
+ *
+ * @version 1.0.0
+ */
+
+// ── Guards ────────────────────────────────────────────────
+const isBrowser = typeof window !== 'undefined';
+
+// ── Configurações de Normalização ─────────────────────
+
+const NORMALIZATION_CONFIG = {
+  email: {
+    trim: true,
+    lowercase: true,
+    removeDots: false, // Gmail: user.name@gmail.com vs username@gmail.com (diferentes)
+    removePlus: true // Gmail: user+tag@gmail.com = user@gmail.com (mesmo)
+  },
+  phone: {
+    keepOnlyDigits: true,
+    addCountryCode: true, // Adiciona DDI se não tiver (55 para Brasil)
+    defaultCountryCode: '55'
+  },
+  name: {
+    trim: true,
+    lowercase: true,
+    removeAccents: true,
+    removeExtraSpaces: true,
+    maxLength: 100
+  },
+  city: {
+    trim: true,
+    lowercase: true,
+    removeAccents: true,
+    maxLength: 50
+  },
+  state: {
+    trim: true,
+    lowercase: true,
+    removeAccents: true,
+    maxLength: 50
+  },
+  zip: {
+    trim: true,
+    keepOnlyDigits: true,
+    maxLength: 10
+  }
+};
+
+// ── Funções de Normalização ──────────────────────────────
+
+/**
+ * Normaliza e-mail para máximo match
+ *
+ * Gmail Plus: user+tag@gmail.com = user@gmail.com (mesmo usuário)
+ * Lowercase: USER@GMAIL.COM = user@gmail.com (case-insensitive)
+ * Trim: remove espaços
+ *
+ * @param {string} email - E-mail bruto
+ * @returns {string} E-mail normalizado
+ */
+function normalizeEmail(email) {
+  if (!email || typeof email !== 'string') return '';
+
+  let normalized = email.trim();
+
+  // Gmail: remover tudo após + (plus addressing)
+  if (normalized.includes('@gmail.com')) {
+    normalized = normalized.split('+')[0] + '@gmail.com';
+  }
+  // GMR (Google Mail): remover plus
+  if (normalized.includes('@googlemail.com')) {
+    normalized = normalized.split('+')[0] + '@googlemail.com';
+  }
+
+  return normalized.toLowerCase();
+}
+
+/**
+ * Normaliza telefone para máximo match
+ *
+ * Remove caracteres não numéricos
+ * Adiciona código do país (55 para Brasil) se não tiver
+ *
+ * @param {string} phone - Telefone bruto
+ * @returns {string} Telefone normalizado (apenas números)
+ */
+function normalizePhone(phone) {
+  if (!phone || typeof phone !== 'string') return '';
+
+  // Remove tudo que não é número
+  let normalized = phone.replace(/\D/g, '');
+
+  // Se não tem DDI, adiciona 55 (Brasil)
+  if (normalized.length === 11 || normalized.length === 10) {
+    normalized = '55' + normalized;
+  }
+
+  // Limita a 15 dígitos (máximo internacional)
+  return normalized.substring(0, 15);
+}
+
+/**
+ * Normaliza nome para máximo match
+ *
+ * Remove acentos, converte para minúsculas, remove espaços extras
+ *
+ * @param {string} name - Nome bruto
+ * @returns {string} Nome normalizado
+ */
+function normalizeName(name) {
+  if (!name || typeof name !== 'string') return '';
+
+  let normalized = name.trim();
+
+  // Remove acentos
+  normalized = normalized.normalize('NFD').replace(/[\u0300-\u036f]/g, '');
+
+  // Converte para minúsculas
+  normalized = normalized.toLowerCase();
+
+  // Remove espaços extras (múltiplos espaços vira um)
+  normalized = normalized.replace(/\s+/g, ' ');
+
+  // Limita tamanho
+  return normalized.substring(0, NORMALIZATION_CONFIG.name.maxLength);
+}
+
+/**
+ * Normaliza cidade para Meta AM (Advanced Matching)
+ *
+ * @param {string} city - Cidade bruta
+ * @returns {string} Cidade normalizada
+ */
+function normalizeCity(city) {
+  if (!city || typeof city !== 'string') return '';
+
+  let normalized = city.trim();
+
+  // Remove acentos
+  normalized = normalized.normalize('NFD').replace(/[\u0300-\u036f]/g, '');
+
+  // Converte para minúsculas
+  normalized = normalized.toLowerCase();
+
+  // Remove espaços extras
+  normalized = normalized.replace(/\s+/g, ' ');
+
+  return normalized.substring(0, NORMALIZATION_CONFIG.city.maxLength);
+}
+
+/**
+ * Normaliza estado para Meta AM
+ *
+ * @param {string} state - Estado bruto
+ * @returns {string} Estado normalizado
+ */
+function normalizeState(state) {
+  if (!state || typeof state !== 'string') return '';
+
+  let normalized = state.trim();
+
+  // Remove acentos
+  normalized = normalized.normalize('NFD').replace(/[\u0300-\u036f]/g, '');
+
+  // Converte para minúsculas
+  normalized = normalized.toLowerCase();
+
+  return normalized.substring(0, NORMALIZATION_CONFIG.state.maxLength);
+}
+
+/**
+ * Normaliza CEP para Meta AM
+ *
+ * @param {string} zip - CEP bruto
+ * @returns {string} CEP normalizado (apenas números)
+ */
+function normalizeZip(zip) {
+  if (!zip || typeof zip !== 'string') return '';
+
+  // Remove tudo que não é número
+  const normalized = zip.replace(/\D/g, '');
+
+  return normalized.substring(0, NORMALIZATION_CONFIG.zip.maxLength);
+}
+
+/**
+ * Normaliza data de nascimento para Meta AM
+ *
+ * Formato esperado: YYYYMMDD
+ *
+ * @param {string} dob - Data de nascimento bruta
+ * @returns {string} Data normalizada (YYYYMMDD)
+ */
+function normalizeDOB(dob) {
+  if (!dob || typeof dob !== 'string') return '';
+
+  // Tenta diferentes formatos
+  const formats = [
+    /(\d{4})-(\d{2})-(\d{2})/, // YYYY-MM-DD
+    /(\d{2})\/(\d{2})\/(\d{4})/, // DD/MM/YYYY
+    /(\d{2})-(\d{2})-(\d{4})/  // DD-MM-YYYY
+  ];
+
+  for (const format of formats) {
+    const match = dob.match(format);
+    if (match) {
+      let year, month, day;
+      if (match[1].length === 4) {
+        // YYYY-MM-DD
+        [year, month, day] = [match[1], match[2], match[3]];
+      } else {
+        // DD/MM/YYYY
+        [day, month, year] = [match[1], match[2], match[3]];
+      }
+      return `${year}${month}${day}`;
+    }
+  }
+
+  return '';
+}
+
+// ── Browser-Side: Dados Crus para Worker ───────────
+
+/**
+ * Extrai dados PII de um formulário HTML para Advanced Matching
+ *
+ * @param {HTMLFormElement} form - Elemento do formulário
+ * @returns {object} Dados normalizados para envio ao Worker
+ */
+export function extractFormPII(form) {
+  if (!form || typeof form.elements !== 'object') return {};
+
+  const formData = new FormData(form);
+  const piiData = {};
+
+  // Campo de e-mail
+  const email = formData.get('email') || formData.get('user_email') || formData.get('useremail');
+  if (email) piiData.email = normalizeEmail(email);
+
+  // Campo de telefone
+  const phone = formData.get('phone') || formData.get('telephone') || formData.get('telefone') || formData.get('celular');
+  if (phone) piiData.phone = normalizePhone(phone);
+
+  // Campos de nome
+  const firstName = formData.get('first_name') || formData.get('nome') || formData.get('firstname');
+  const lastName = formData.get('last_name') || formData.get('sobrenome') || formData.get('lastname');
+  const fullName = formData.get('name') || formData.get('fullname') || formData.get('nome_completo');
+
+  if (fullName) {
+    const names = fullName.split(' ');
+    piiData.first_name = normalizeName(names[0]);
+    piiData.last_name = normalizeName(names.slice(1).join(' '));
+  } else {
+    if (firstName) piiData.first_name = normalizeName(firstName);
+    if (lastName) piiData.last_name = normalizeName(lastName);
+  }
+
+  // Campos de endereço (Meta AM)
+  const city = formData.get('city') || formData.get('cidade');
+  if (city) piiData.city = normalizeCity(city);
+
+  const state = formData.get('state') || formData.get('estado') || formData.get('uf');
+  if (state) piiData.state = normalizeState(state);
+
+  const zip = formData.get('zip') || formData.get('cep') || formData.get('postalcode');
+  if (zip) piiData.zip = normalizeZip(zip);
+
+  const dob = formData.get('dob') || formData.get('date_of_birth') || formData.get('nascimento');
+  if (dob) piiData.dob = normalizeDOB(dob);
+
+  return piiData;
+}
+
+/**
+ * Captura dados PII de qualquer elemento (input, button click, etc.)
+ *
+ * @param {HTMLElement} element - Elemento DOM
+ * @returns {object} Dados PII normalizados
+ */
+export function capturePII(element) {
+  if (!element) return {};
+
+  const piiData = {};
+
+  // Se for input, extrair valor
+  if (element.tagName === 'INPUT' || element.tagName === 'TEXTAREA') {
+    const name = element.name.toLowerCase();
+    const value = element.value;
+
+    if (name.includes('email') && value) {
+      piiData.email = normalizeEmail(value);
+    } else if (name.includes('phone') || name.includes('telefone') || name.includes('celular')) {
+      if (value) piiData.phone = normalizePhone(value);
+    } else if (name.includes('name') || name.includes('nome')) {
+      if (value) piiData.full_name = normalizeName(value);
+    } else if (name.includes('city') || name.includes('cidade')) {
+      if (value) piiData.city = normalizeCity(value);
+    } else if (name.includes('state') || name.includes('estado')) {
+      if (value) piiData.state = normalizeState(value);
+    } else if (name.includes('zip') || name.includes('cep')) {
+      if (value) piiData.zip = normalizeZip(value);
+    }
+  }
+
+  return piiData;
+}
+
+/**
+ * Valida se os dados PII são válidos para envio
+ *
+ * @param {object} piiData - Dados PII normalizados
+ * @returns {boolean} True se tiver dados válidos
+ */
+export function isValidPII(piiData) {
+  if (!piiData || typeof piiData !== 'object') return false;
+
+  const hasEmail = piiData.email && piiData.email.includes('@');
+  const hasPhone = piiData.phone && piiData.phone.length >= 10;
+
+  return hasEmail || hasPhone;
+}
+
+// ── Browser-Side: Hashing (Opcional - para debug) ────────
+
+/**
+ * Calcula SHA256 de um valor (browser-side)
+ *
+ * AVISO: Para máxima segurança, o hashing deve ser feito no Worker.
+ * Esta função é apenas para debug/visualização.
+ *
+ * @param {string} value - Valor para hash
+ * @returns {Promise<string>} Hash SHA256 em hexadecimal
+ */
+export async function hashPII(value) {
+  if (!value || !isBrowser) return '';
+
+  try {
+    const encoder = new TextEncoder();
+    const data = encoder.encode(value);
+    const hashBuffer = await crypto.subtle.digest('SHA-256', data);
+    const hashArray = Array.from(new Uint8Array(hashBuffer));
+    return hashArray.map(byte => byte.toString(16).padStart(2, '0')).join('');
+  } catch (error) {
+    console.error('Erro ao calcular SHA256 no browser:', error);
+    return '';
+  }
+}
+
+// ── Exportações ────────────────────────────────────────────────
+
+export {
+  normalizeEmail,
+  normalizePhone,
+  normalizeName,
+  normalizeCity,
+  normalizeState,
+  normalizeZip,
+  normalizeDOB,
+  NORMALIZATION_CONFIG
+};