teqo-backup/src/lib/facebookPixel.ts
Francisco Solla c723d6accf
merge(OPS75): convergência Forgejo→GitHub — GitHub como fonte única
* deploy: limpeza pós-deploy do build cache e tags locais antigas (INF3/F2)

O deploy compila no homeserver e acumulava build cache + tags locais
antigas no disco raiz (incidente 19/08: 45G de cache). Após o smoke:
docker builder prune -f + remoção das tags locais teqo-1313 exceto o
SHA em uso (best-effort, registry preserva o rollback).

* feat(S9): captura de novidades da campanha na home pública (form + CTA do hero)

Seção 'Receba as novidades da campanha' acima do rodapé: nome + WhatsApp
obrigatórios, e-mail/estado/cidade/comentário opcionais, toggle pré-selecionado
'Quero fazer parte do time' gravado como subscription.campaignLevel
(time|esporadico). CTA secundário do hero vira o atalho (#novidades, scroll
suave). Contact + Subscription em withPayloadTransaction com consentimento
novo fail-closed por chave estável 'campanha-novidades' — nada é gravado sem o
texto aprovado no admin. Migration 20260819_192605 (state de contact nullable
+ coluna campaign_level). Impl plan, changelog, int + e2e.

* plans(C141,C143,C142): permissões granulares por assessor + responsáveis de demanda + UI por perfil

* plans(C141,C143,C142): permissões granulares por assessor + responsáveis de demanda + UI por perfil

* feat(S8): seção 'Nossa história' na home — vídeo da trajetória embutido do YouTube (Closes #91)

* docs(S8): resolução do conflito com S9 (história → newsletter) + nota do guard e2e dev-only

* feat(S10): pixel do Meta na página pública de campanha (campo admin em SiteSettings + PageView na home + Lead no sucesso da captura)

Campo tracking.facebookPixelId no global SiteSettings (mesma validação/normalização do precedente Petition, regra centralizada em facebookPixel.ts); home (grupo (home)) injeta o base code + PageView quando o ID está configurado (fail-closed) e o CampaignNewsletterForm dispara exatamente um Lead no sucesso do S9. Migration 20260819_213947_add_site_settings_facebook_pixel_id. Closes #94

* refactor(S10): simplify pass — Lead wiring unit-tested e raças de estado compartilhado do e2e resolvidas

e2e: stub hermético de connect.facebook.net no guard compartilhado (specs paralelos renderizam a home com o pixel); advisory lock no Postgres serializando o login do usuário de teste (Payload perde sessão em login concorrente read-modify-write — classe documentada no webauthn); seedTestUser vira create-if-missing (sem janela de usuário ausente nem reset de senha); Lead do form protegido do catch de erro (tracking nunca falha uma captura commitada); descrição do campo compartilhada; unidade nova campaignNewsletterLead cobre exatamente um Lead no sucesso.

* feat(C141): perfis de permissão por assessor — Visão × Edição configuráveis, enforcement fail-closed (Closes #105)

* chore(C141): regenera changelog agregado após rebase com S10

* plans(C144): options write-scoped para formulários de escrita pós-C141

---------

Co-authored-by: Francisco Solla <admin@solla.dev>
2026-08-21 01:41:18 -03:00

49 lines
1.7 KiB
TypeScript

const FACEBOOK_PIXEL_ID_PATTERN = /^\d{5,20}$/
// Shared admin copy: every surface that takes a Pixel ID must say the same
// thing — only the numeric ID, never the full snippet (drift would invite XSS).
export const FACEBOOK_PIXEL_ID_DESCRIPTION =
'Cole somente o ID numérico do Events Manager (ex.: 123456789012345), não o snippet HTML completo.'
export function isValidFacebookPixelId(value: string | null | undefined): boolean {
if (value == null || value === '') return false
return FACEBOOK_PIXEL_ID_PATTERN.test(value)
}
export function normalizeFacebookPixelId(value: string | null | undefined): string | null {
if (value == null) return null
const trimmed = value.trim()
if (!trimmed) return null
return isValidFacebookPixelId(trimmed) ? trimmed : null
}
// Payload field validation shared by every admin surface that takes a Pixel ID
// (petition + site settings): optional field, digits only when present.
export function validateFacebookPixelId(value: string | null | undefined): true | string {
if (!value) return true
if (!normalizeFacebookPixelId(String(value))) {
return 'Informe somente o ID numérico do Pixel (5 a 20 dígitos), sem HTML ou script.'
}
return true
}
declare global {
interface Window {
fbq?: (
command: 'track',
eventName: string,
params?: Record<string, string>,
options?: { eventID: string },
) => void
}
}
export function trackMetaLead(pixelId: string, contentName: string, eventID: string): void {
if (typeof window === 'undefined') return
if (!isValidFacebookPixelId(pixelId)) return
const fbq = window.fbq
if (!fbq) return
fbq('track', 'Lead', { content_name: contentName }, { eventID })
}