@beworke/pixel 0.1.0-rc.1 → 0.1.0-rc.6

package/dist/{pixel-CbeF25mD.d.mts → pixel-BxZZx8l5.d.ts}

@@ -1,3 +1,5 @@
+import { U as UrlContextConfig } from './url-context-BjAsQoVl.js';
+
 type MetaBrowserDestinationConfig = {
     enabled: boolean;
     pixelIds: string[];
@@ -184,12 +186,54 @@ type SelectorFormConfig = string[] | {
 };
 
 /**
- * Contratos globais de commerce (catálogo, checkout inicial, mappings).
- * Vivem em `conversion.commerce`, fora de `auto`.
- * Runtime: ProductCatalog + CommerceState + Extractors +
- * CommerceResolver + OrderCalculator (Etapas 12C–12F).
+ * Contrato de fontes independentes para auto detectors (Etapa 14).
+ * Um evento automático pode ter várias sources; cada uma vira um detector.
  */
-type ProductType = 'main' | 'order_bump' | 'upsell' | 'downsell' | 'cross_sell' | 'addon' | 'subscription' | 'custom';
+
+type AutoSourceType = 'selector' | 'form' | 'payment' | 'lifecycle' | 'url';
+type AutoSourceBase = {
+    name: string;
+    type: AutoSourceType;
+    enabled?: boolean;
+    fireOnce?: boolean;
+    debounceMs?: number;
+    cooldownMs?: number;
+};
+type SelectorAutoSource = AutoSourceBase & {
+    type: 'selector';
+    selector: SelectorConfig;
+    selectorType?: SelectorType;
+    trigger?: 'click' | 'submit';
+};
+type FormAutoSource = AutoSourceBase & {
+    type: 'form';
+    selectorForm: SelectorFormConfig;
+    /** Opcional: restringe a fonte form a um target específico. */
+    selector?: SelectorConfig;
+    selectorType?: SelectorType;
+};
+type PaymentAutoSource = AutoSourceBase & {
+    type: 'payment';
+    paymentMethod?: PaymentMethod | (string & {});
+    cardDetection?: boolean;
+    autoDispatch?: boolean;
+    formSelector?: string;
+};
+type LifecycleAutoSource = AutoSourceBase & {
+    type: 'lifecycle';
+    trigger: 'init' | 'ready';
+};
+type UrlAutoSource = AutoSourceBase & {
+    type: 'url';
+    patterns: string[];
+};
+type AutoTrackSource = SelectorAutoSource | FormAutoSource | PaymentAutoSource | LifecycleAutoSource | UrlAutoSource;
+
+/**
+ * Contratos globais de commerce (root `PixelConfig.commerce`).
+ * Não pertencem a conversion — representam o contexto comercial da página/fluxo.
+ */
+type ProductType = 'main' | 'order_bump' | 'upsell' | 'downsell' | 'cross_sell' | 'addon' | 'subscription' | 'custom' | 'other';
 type CommerceProduct = {
     id: string;
     name?: string;
@@ -203,7 +247,7 @@ type CommerceProduct = {
     brand?: string;
     metadata?: Record<string, unknown>;
 };
-type CommerceItem = {
+type CommerceCartItem = {
     productId: string;
     quantity?: number;
     price?: number;
@@ -211,36 +255,76 @@ type CommerceItem = {
     selected?: boolean;
     metadata?: Record<string, unknown>;
 };
-type CommerceCheckoutMode = 'single_product' | 'multi_product' | 'cart' | 'funnel';
-type CommerceCalculateValueFrom = 'selected_items' | 'event_items' | 'manual';
+type CommerceCartMode = 'landing_page' | 'single_product' | 'multi_product' | 'checkout' | 'upsell' | 'custom' | 'cart' | 'funnel';
+type CommerceCalculateValueFrom = 'cart' | 'event' | 'manual' | 'catalog';
+type CommerceEnrichmentSource = 'cart' | 'event' | 'event_or_cart' | 'catalog';
+type CommerceEventEnrichmentConfig = {
+    enabled: boolean;
+    source?: CommerceEnrichmentSource;
+};
+type CommerceEnrichmentConfig = {
+    pageView?: CommerceEventEnrichmentConfig;
+    viewContent?: CommerceEventEnrichmentConfig;
+    lead?: CommerceEventEnrichmentConfig;
+    addToCart?: CommerceEventEnrichmentConfig;
+    removeFromCart?: CommerceEventEnrichmentConfig;
+    initiateCheckout?: CommerceEventEnrichmentConfig;
+    addPaymentInfo?: CommerceEventEnrichmentConfig;
+    purchase?: CommerceEventEnrichmentConfig;
+};
+type ProductCatalogConfig = {
+    products?: CommerceProduct[];
+};
+type CommerceCartConfig = {
+    mode?: CommerceCartMode;
+    /** Seed inicial do carrinho — não é estado vivo. */
+    initialItems?: CommerceCartItem[];
+    allowDynamicItems?: boolean;
+    calculateValueFrom?: CommerceCalculateValueFrom;
+    metadata?: Record<string, unknown>;
+};
+type CommerceMappingsConfig = {
+    attributes?: Record<string, string[]>;
+    fields?: Record<string, string[]>;
+};
 type CommerceConfig = {
+    enabled?: boolean;
     currency?: string;
-    catalog?: {
-        products?: CommerceProduct[];
-    };
-    checkout?: {
-        mode?: CommerceCheckoutMode;
-        selectedItems?: CommerceItem[];
-        calculateValueFrom?: CommerceCalculateValueFrom;
-        allowDynamicItems?: boolean;
-    };
-    mappings?: {
-        attributes?: Record<string, string[]>;
-        fields?: Record<string, string[]>;
-    };
+    catalog?: ProductCatalogConfig;
+    cart?: CommerceCartConfig;
+    mappings?: CommerceMappingsConfig;
+    enrichment?: CommerceEnrichmentConfig;
 };
-/** Default seguro: sem produtos, sem itens, sem auto-disparo implícito. */
+declare const DEFAULT_COMMERCE_ENRICHMENT: Required<CommerceEnrichmentConfig>;
+/** Default seguro: commerce off, sem produtos, sem itens. */
 declare const DEFAULT_COMMERCE_CONFIG: CommerceConfig;
+/** Normaliza calculateValueFrom (inclui aliases legado em runtime). */
+declare function normalizeCalculateValueFrom(value: CommerceCalculateValueFrom | string | undefined): 'cart' | 'event' | 'manual' | 'catalog';
 
+/** Limites de nível do Engagement Runtime (Etapa 19). */
 type EngagementThresholds = {
-    low: number;
-    medium: number;
+    /** Score máximo (inclusive) do nível `low`. */
+    lowMax: number;
+    /** Score máximo (inclusive) do nível `medium`. */
+    mediumMax: number;
 };
 
+/** Pesos positivos do Engagement Runtime (Etapa 19). */
 type EngagementWeights = {
+    activeTime: number;
     scroll: number;
     click: number;
-    time: number;
+    viewport: number;
+    visibility: number;
+    heartbeat: number;
+};
+
+/** Penalidades do Engagement Runtime (Etapa 19). */
+type EngagementPenalties = {
+    /** Penalidade proporcional ao tempo ocioso (0..1). */
+    idle: number;
+    /** Penalidade proporcional a rage clicks (0..1). */
+    rageClick: number;
 };
 
 type ScrollBehaviorConfig = {
@@ -266,24 +350,129 @@ type VisibilityBehaviorConfig = {
 type ExitIntentBehaviorConfig = {
     enabled: boolean;
 };
+/**
+ * Alvo observado pelo ViewportTracker (Etapa 18).
+ * `key` deve ser único dentro de `targets`.
+ */
+type ViewportTargetConfig = {
+    readonly key: string;
+    /** Seletor CSS oficial. */
+    readonly selector: string;
+    /** Ratio mínimo para confirmar entrada (0..1). Default 0.5. */
+    readonly enterThreshold?: number;
+    /** Ratio no qual sai (0..enterThreshold). Default 0. */
+    readonly exitThreshold?: number;
+    /** Tempo mínimo contínuo acima do enterThreshold. Default 0. */
+    readonly minVisibleMs?: number;
+    /** Emite VIEWPORT_EXIT após entrada. Default true. */
+    readonly trackExit?: boolean;
+    /** Um único ciclo válido por elemento. Default false. */
+    readonly once?: boolean;
+    /** Inclui descritor sanitizado do elemento. Default false. */
+    readonly includeElement?: boolean;
+};
+/**
+ * Viewport Tracker — contrato oficial em `trackers.viewport`.
+ */
 type ViewportBehaviorConfig = {
-    enabled: boolean;
-    selector: string;
-    selectorType: SelectorType;
-    visibilityThreshold: number;
+    readonly enabled: boolean;
+    readonly targets: readonly ViewportTargetConfig[];
+    readonly rootMargin: string;
+    readonly observeMutations: boolean;
+    readonly mutationDebounceMs: number;
+    readonly maxObservedElements: number;
 };
-type HeartbeatBehaviorConfig = {
+/**
+ * Heartbeat Runtime Engine (único contrato oficial).
+ * Não faz parte de `trackers`.
+ */
+type HeartbeatModuleConfig = {
     enabled: boolean;
     intervalMs: number;
     hiddenIntervalMs: number;
+    emitWhenHidden: boolean;
+    emitWhenIdle: boolean;
+    includeSnapshot: boolean;
+    fireImmediately: boolean;
+    minActivityWindowMs?: number;
 };
+/**
+ * Engagement Runtime Engine (Etapa 19) — contrato oficial em
+ * `modules.behavior.engagement`. Não faz parte de `trackers`.
+ */
 type EngagementBehaviorConfig = {
     enabled: boolean;
+    /** Intervalo de avaliação periódica via ManagedScheduler. */
+    evaluationIntervalMs: number;
+    /** Emite ENGAGEMENT_UPDATE apenas quando o score muda o suficiente. */
+    emitOnChange: boolean;
+    /** Delta mínimo de score para emitir um novo ENGAGEMENT_UPDATE. */
+    minScoreDelta: number;
+    /** Emite ENGAGEMENT_SUMMARY (uma vez) no destroy. */
+    emitSummaryOnDestroy: boolean;
     weights: EngagementWeights;
+    penalties: EngagementPenalties;
     thresholds: EngagementThresholds;
 };
+/**
+ * Behavior Rate Limiter (Etapa 20) — limitador interno por instância.
+ * Protege o runtime de bursts de sinais; não é rate limit de Transport.
+ */
+type RateLimitBehaviorConfig = {
+    enabled: boolean;
+    /** Janela deslizante (ms). */
+    windowMs: number;
+    /** Máximo de sinais aceitos por janela. */
+    maxSignalsPerWindow: number;
+    /** Sinais críticos (IDLE/ACTIVITY/VISIBLE/HIDDEN/EXIT_INTENT) ignoram o limite. */
+    criticalBypass: boolean;
+};
+/** Estratégia de descarte quando o buffer atinge `maxSize`. */
+type BufferDropStrategy = 'drop_oldest' | 'drop_newest' | 'compress_similar';
+/**
+ * Behavior Buffer (Etapa 20) — agregação interna de sinais normalizados.
+ * NÃO é a Transport Queue: sem persistência, retry, batch HTTP ou sendBeacon.
+ */
+type BufferBehaviorConfig = {
+    enabled: boolean;
+    /** Capacidade máxima de entries antes de aplicar a drop strategy. */
+    maxSize: number;
+    /** Idade máxima (ms) de um entry antes do flush por idade (0 = desabilitado). */
+    maxAgeMs: number;
+    /** Tamanho que dispara flush por tamanho. */
+    flushSize: number;
+    dropStrategy: BufferDropStrategy;
+    /** Flush automático quando a página fica hidden. */
+    flushOnHidden: boolean;
+};
+/**
+ * Behavior State Machine (Etapa 20) — estado do runtime por instância.
+ */
+type StateMachineBehaviorConfig = {
+    enabled: boolean;
+    /** Tamanho máximo do histórico de transições retido. */
+    historyLimit: number;
+};
+/**
+ * Behavior Session Summary (Etapa 20) — resumo consolidado da sessão.
+ */
+type SessionSummaryBehaviorConfig = {
+    enabled: boolean;
+    /** Emite BEHAVIOR_SESSION_SUMMARY quando a página fica hidden. */
+    emitOnHidden: boolean;
+    /** Emite BEHAVIOR_SESSION_SUMMARY no destroy. */
+    emitOnDestroy: boolean;
+    /** Duração mínima da sessão (ms) para emitir o summary. */
+    minimumSessionMs: number;
+};
 type BehaviorModuleConfig = {
     enabled: boolean;
+    heartbeat: HeartbeatModuleConfig;
+    engagement: EngagementBehaviorConfig;
+    rateLimit: RateLimitBehaviorConfig;
+    buffer: BufferBehaviorConfig;
+    stateMachine: StateMachineBehaviorConfig;
+    sessionSummary: SessionSummaryBehaviorConfig;
     trackers: {
         scroll: ScrollBehaviorConfig;
         click: ClickBehaviorConfig;
@@ -291,8 +480,6 @@ type BehaviorModuleConfig = {
         visibility: VisibilityBehaviorConfig;
         exitIntent: ExitIntentBehaviorConfig;
         viewport: ViewportBehaviorConfig;
-        heartbeat: HeartbeatBehaviorConfig;
-        engagement: EngagementBehaviorConfig;
     };
 };
 
@@ -311,46 +498,33 @@ type ManualConversionConfig = {
     viewContent: ManualEventConfig;
 };
 /**
- * Base compartilhada pelos auto detectors baseados em selector.
- * `selectorType` é fallback para strings sem prefixo (DEFAULT_SELECTOR_TYPE = css).
+ * Config de um auto detector — fontes independentes em `sources[]`.
  */
-type ConfiguredAutoDetectorConfig = {
-    enabled: boolean;
-    selector?: SelectorConfig;
-    selectorType?: SelectorType;
-};
-/**
- * Detectors que podem exigir condição de formulário (`selectorForm`)
- * para liberar o disparo — não é fonte de dados de produto.
- */
-type FormCapableAutoDetectorConfig = ConfiguredAutoDetectorConfig & {
-    selectorForm?: SelectorFormConfig;
-};
-type LeadAutoDetectorConfig = FormCapableAutoDetectorConfig;
-type AddToCartAutoDetectorConfig = FormCapableAutoDetectorConfig;
-type InitiateCheckoutAutoDetectorConfig = FormCapableAutoDetectorConfig;
-type PurchaseAutoDetectorConfig = ConfiguredAutoDetectorConfig;
-type RemoveFromCartAutoDetectorConfig = ConfiguredAutoDetectorConfig;
-type SearchAutoDetectorConfig = ConfiguredAutoDetectorConfig;
-type ViewContentAutoDetectorConfig = ConfiguredAutoDetectorConfig;
-type AddPaymentInfoAutoDetectorConfig = {
-    enabled: boolean;
-    paymentMethod: PaymentMethod;
-    cardDetection: boolean;
-    autoDispatch: boolean;
+type AutoDetectorConfig = {
+    enabled: boolean;
+    sources: AutoTrackSource[];
+};
+type LeadAutoDetectorConfig = AutoDetectorConfig;
+type AddToCartAutoDetectorConfig = AutoDetectorConfig;
+type InitiateCheckoutAutoDetectorConfig = AutoDetectorConfig;
+type PurchaseAutoDetectorConfig = AutoDetectorConfig;
+type RemoveFromCartAutoDetectorConfig = AutoDetectorConfig;
+type SearchAutoDetectorConfig = AutoDetectorConfig;
+type ViewContentAutoDetectorConfig = AutoDetectorConfig;
+type AddPaymentInfoAutoDetectorConfig = AutoDetectorConfig;
+type ConversionAutoDetectorsConfig = {
+    lead: AutoDetectorConfig;
+    addToCart: AutoDetectorConfig;
+    removeFromCart: AutoDetectorConfig;
+    initiateCheckout: AutoDetectorConfig;
+    purchase: AutoDetectorConfig;
+    addPaymentInfo: AutoDetectorConfig;
+    search: AutoDetectorConfig;
+    viewContent: AutoDetectorConfig;
 };
 type AutoConversionConfig = {
     enabled: boolean;
-    detectors: {
-        lead: LeadAutoDetectorConfig;
-        purchase: PurchaseAutoDetectorConfig;
-        addToCart: AddToCartAutoDetectorConfig;
-        removeFromCart: RemoveFromCartAutoDetectorConfig;
-        initiateCheckout: InitiateCheckoutAutoDetectorConfig;
-        addPaymentInfo: AddPaymentInfoAutoDetectorConfig;
-        search: SearchAutoDetectorConfig;
-        viewContent: ViewContentAutoDetectorConfig;
-    };
+    detectors: ConversionAutoDetectorsConfig;
 };
 type ConversionRulesConfig = {
     enabled: boolean;
@@ -366,12 +540,10 @@ type ConversionRulesConfig = {
 };
 /**
  * Config do módulo de conversion.
- * `commerce` é global ao módulo (manual + auto), fora de `auto`.
+ * Commerce é root (`PixelConfig.commerce`) — não vive aqui.
  */
 type ConversionModuleConfig = {
     enabled: boolean;
-    /** Catálogo, checkout inicial e mappings — compartilhado por manual e auto. */
-    commerce: CommerceConfig;
     manual: ManualConversionConfig;
     auto: AutoConversionConfig;
     rules: ConversionRulesConfig;
@@ -427,6 +599,8 @@ type CoreModuleConfig = {
     dedupe: DedupeConfig;
     coordination: CoordinationConfig;
     ordering: OrderingConfig;
+    /** Core UrlContext — off por default. */
+    urlContext?: UrlContextConfig;
 };
 
 type PrivacyConsentConfig = {
@@ -549,7 +723,9 @@ type PixelConfig = {
     transport: TransportConfig;
     storage: StorageConfig;
     attribution: AttributionConfig;
+    /** Contexto comercial global da página/fluxo (fora dos módulos). */
+    commerce: CommerceConfig;
     modules: ModulesConfig;
 };
 
-export { type FingerprintConfig as $, type AttributionStoragePersistence as A, type BehaviorModuleConfig as B, type ConversionModuleConfig as C, DEFAULT_SELECTOR_TYPE as D, type EngagementThresholds as E, type FingerprintMode as F, DEFAULT_COMMERCE_CONFIG as G, getPrimarySelectorValue as H, type IntegrationsModuleConfig as I, resolveSelectorTypeFallback as J, type AddPaymentInfoAutoDetectorConfig as K, type AddToCartAutoDetectorConfig as L, type AnonymizationConfig as M, type AutoConversionConfig as N, type ClickBehaviorConfig as O, type PixelConfig as P, type QueueStoragePersistence as Q, type ConfiguredAutoDetectorConfig as R, type SessionStoragePersistence as S, type TransportModuleConfig as T, type ConsentConfig as U, type VisitorStoragePersistence as V, type ConversionRulesConfig as W, type CoordinationConfig as X, type DedupeConfig as Y, type EngagementBehaviorConfig as Z, type ExitIntentBehaviorConfig as _, type AttributionConfig as a, type FormCapableAutoDetectorConfig as a0, type GoogleBrowserDestinationConfig as a1, type GoogleIntegrationConfig as a2, type HeartbeatBehaviorConfig as a3, type IdleBehaviorConfig as a4, type InitiateCheckoutAutoDetectorConfig as a5, type IntegrationTestDestinationConfig as a6, type LeadAutoDetectorConfig as a7, type ManualConversionConfig as a8, type ManualEventConfig as a9, type MetaBrowserDestinationConfig as aa, type MetaIntegrationConfig as ab, type ModulesConfig as ac, type TikTokBrowserDestinationConfig as ad, type OrderingConfig as ae, type PageViewConfig as af, type PiiConfig as ag, type PrivacyConsentConfig as ah, type PurchaseAutoDetectorConfig as ai, type RemoveFromCartAutoDetectorConfig as aj, type ScrollBehaviorConfig as ak, type SearchAutoDetectorConfig as al, type SessionConfig as am, type TransportBatchConfig as an, type TransportFlushConfig as ao, type TransportOfflineConfig as ap, type TransportRetryConfig as aq, type TransportTimeoutConfig as ar, type ViewContentAutoDetectorConfig as as, type ViewportBehaviorConfig as at, type VisibilityBehaviorConfig as au, type VisitorConfig as av, type CoreModuleConfig as b, type PrivacyModuleConfig as c, type AppConfig as d, type PixelEnvironment as e, type PixelSource as f, type PixelTarget as g, type IdentityConfig as h, type TransportConfig as i, type StorageConfig as j, type StorageKeysConfig as k, type EngagementWeights as l, type PaymentMethod as m, type SelectorConfig as n, type SelectorDescriptor as o, type SelectorInput as p, type SelectorType as q, type SelectorFormConfig as r, type SelectorFormMode as s, type SelectorFormTrigger as t, type CommerceCalculateValueFrom as u, type CommerceCheckoutMode as v, type CommerceConfig as w, type CommerceItem as x, type CommerceProduct as y, type ProductType as z };
+export { DEFAULT_COMMERCE_CONFIG as $, type AttributionStoragePersistence as A, type BehaviorModuleConfig as B, type ConversionModuleConfig as C, type SelectorFormTrigger as D, type EngagementThresholds as E, type FingerprintMode as F, type CommerceCalculateValueFrom as G, type CommerceCartConfig as H, type IntegrationsModuleConfig as I, type CommerceCartItem as J, type CommerceCartMode as K, type LifecycleAutoSource as L, type CommerceConfig as M, type CommerceEnrichmentConfig as N, type CommerceEnrichmentSource as O, type PixelConfig as P, type QueueStoragePersistence as Q, type CommerceEventEnrichmentConfig as R, type SessionStoragePersistence as S, type TransportModuleConfig as T, type CommerceMappingsConfig as U, type VisitorStoragePersistence as V, type CommerceProduct as W, type ProductCatalogConfig as X, type ProductType as Y, type UrlAutoSource as Z, DEFAULT_SELECTOR_TYPE as _, type AttributionConfig as a, DEFAULT_COMMERCE_ENRICHMENT as a0, getPrimarySelectorValue as a1, normalizeCalculateValueFrom as a2, resolveSelectorTypeFallback as a3, type AddPaymentInfoAutoDetectorConfig as a4, type AddToCartAutoDetectorConfig as a5, type AnonymizationConfig as a6, type AutoConversionConfig as a7, type AutoDetectorConfig as a8, type ClickBehaviorConfig as a9, type RemoveFromCartAutoDetectorConfig as aA, type ScrollBehaviorConfig as aB, type SearchAutoDetectorConfig as aC, type SessionConfig as aD, type TransportBatchConfig as aE, type TransportFlushConfig as aF, type TransportOfflineConfig as aG, type TransportRetryConfig as aH, type TransportTimeoutConfig as aI, type ViewContentAutoDetectorConfig as aJ, type ViewportBehaviorConfig as aK, type ViewportTargetConfig as aL, type VisibilityBehaviorConfig as aM, type VisitorConfig as aN, type ConsentConfig as aa, type ConversionAutoDetectorsConfig as ab, type ConversionRulesConfig as ac, type CoordinationConfig as ad, type DedupeConfig as ae, type EngagementBehaviorConfig as af, type ExitIntentBehaviorConfig as ag, type FingerprintConfig as ah, type GoogleBrowserDestinationConfig as ai, type GoogleIntegrationConfig as aj, type HeartbeatModuleConfig as ak, type IdleBehaviorConfig as al, type InitiateCheckoutAutoDetectorConfig as am, type IntegrationTestDestinationConfig as an, type LeadAutoDetectorConfig as ao, type ManualConversionConfig as ap, type ManualEventConfig as aq, type MetaBrowserDestinationConfig as ar, type MetaIntegrationConfig as as, type ModulesConfig as at, type TikTokBrowserDestinationConfig as au, type OrderingConfig as av, type PageViewConfig as aw, type PiiConfig as ax, type PrivacyConsentConfig as ay, type PurchaseAutoDetectorConfig as az, type CoreModuleConfig as b, type PrivacyModuleConfig as c, type AppConfig as d, type PixelEnvironment as e, type PixelSource as f, type PixelTarget as g, type IdentityConfig as h, type TransportConfig as i, type StorageConfig as j, type StorageKeysConfig as k, type AutoSourceBase as l, type AutoSourceType as m, type AutoTrackSource as n, type EngagementWeights as o, type EngagementPenalties as p, type FormAutoSource as q, type PaymentAutoSource as r, type PaymentMethod as s, type SelectorAutoSource as t, type SelectorConfig as u, type SelectorDescriptor as v, type SelectorInput as w, type SelectorType as x, type SelectorFormConfig as y, type SelectorFormMode as z };