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

package/dist/pixel-DNGbAN5C.d.ts

@@ -0,0 +1,871 @@
+import { U as UrlContextConfig } from './url-context-Ck2LK18V.js';
+
+type MetaBrowserDestinationConfig = {
+    enabled: boolean;
+    pixelIds: string[];
+    autoPageView: boolean;
+    loadScript: boolean;
+};
+type GoogleBrowserDestinationConfig = {
+    enabled: boolean;
+    tagIds: string[];
+    autoPageView: boolean;
+    loadScript: boolean;
+};
+type TikTokBrowserDestinationConfig = {
+    enabled: boolean;
+    pixelIds: string[];
+    autoPageView: boolean;
+    loadScript: boolean;
+};
+type IntegrationTestDestinationConfig = {
+    enabled: boolean;
+};
+/**
+ * Integration Engine — browser destinations only (pageview externo).
+ * Attribution is independent (`config.attribution`).
+ * Conversões/CAPI/server-side pertencem ao backend.
+ */
+type IntegrationsModuleConfig = {
+    enabled: boolean;
+    debug: boolean;
+    concurrency: number;
+    timeoutMs: number;
+    continueOnError: boolean;
+    destinations: {
+        console: IntegrationTestDestinationConfig;
+        memory: IntegrationTestDestinationConfig;
+        mock: IntegrationTestDestinationConfig;
+        meta: MetaBrowserDestinationConfig;
+        google: GoogleBrowserDestinationConfig;
+        tiktok: TikTokBrowserDestinationConfig;
+    };
+};
+/** @deprecated use MetaBrowserDestinationConfig */
+type MetaIntegrationConfig = MetaBrowserDestinationConfig;
+/** @deprecated use GoogleBrowserDestinationConfig */
+type GoogleIntegrationConfig = GoogleBrowserDestinationConfig;
+
+/** Valores conhecidos — autocomplete. Qualquer outra string também é válida. */
+type KnownPixelSource = 'pageus' | 'gomarke' | 'bemony' | 'custom';
+type PixelSource = KnownPixelSource | (string & {});
+type PixelTarget = 'landing' | 'checkout' | 'editor' | 'preview' | 'dashboard' | 'custom';
+/** Checkout/vendor da página. Autocomplete para conhecidos; string livre ok. */
+type KnownPixelPlatform = 'buygoods';
+type PixelPlatform = KnownPixelPlatform | (string & {});
+type PixelEnvironment = 'production' | 'staging' | 'development';
+type AppConfig = {
+    source: PixelSource;
+    target: PixelTarget;
+    /** Vendor/plataforma do checkout ou da página. Default `''`. */
+    platform: PixelPlatform;
+    environment: PixelEnvironment;
+    debug: boolean;
+};
+
+type IdentityConfig = {
+    readonly pixelId: string;
+    organizationId?: string;
+    workspaceId?: string;
+    projectId?: string;
+    pageId?: string;
+    funnelId?: string;
+    funnelStepId?: string;
+    offerId?: string;
+    checkoutId?: string;
+};
+
+type AttributionConfig = {
+    readonly enabled: boolean;
+    readonly ttlDays?: number;
+    readonly persist?: boolean;
+    readonly captureUrlParams?: boolean;
+    readonly captureCookies?: boolean;
+    readonly customClickIdParams?: string[];
+};
+
+type TransportTestSenderConfig = {
+    mode: 'test';
+    capture?: boolean;
+    response?: 'success' | 'failure';
+    delayMs?: number;
+};
+type TransportInternalSenderConfig = {
+    mode: 'internal';
+    baseUrl?: string;
+};
+type TransportExternalSenderConfig = {
+    mode: 'external';
+    endpoints: {
+        event: string;
+        batch?: string;
+    };
+    /**
+     * Public browser-visible headers only. Backend secrets must be proxied by a
+     * trusted server and must never be embedded in browser configuration.
+     */
+    headers?: Readonly<Record<string, string>>;
+    batchFallback?: 'single' | 'error';
+};
+type TransportSenderConfig = TransportTestSenderConfig | TransportInternalSenderConfig | TransportExternalSenderConfig;
+type TransportPersistenceConfig = {
+    enabled: boolean;
+};
+type TransportReplayConfig = {
+    enabled: boolean;
+};
+type TransportOrderingConfig = {
+    enabled: boolean;
+};
+type TransportCoordinationConfig = {
+    enabled: boolean;
+};
+type TransportCircuitBreakerConfig = {
+    enabled: boolean;
+    failureThreshold: number;
+    resetTimeoutMs: number;
+    halfOpenMaxAttempts: number;
+};
+type TransportBackpressurePolicy = 'drop_oldest' | 'drop_newest' | 'reject_new' | 'sample' | 'none';
+type TransportBackpressureConfig = {
+    enabled: boolean;
+    maxQueueSize: number;
+    policy: TransportBackpressurePolicy;
+    sampleRate?: number;
+};
+type TransportDeadLetterConfig = {
+    enabled: boolean;
+    maxEntries: number;
+};
+type TransportCompressionConfig = {
+    enabled: boolean;
+    strategy: 'identity';
+};
+type TransportRetryConfig = {
+    enabled: boolean;
+    maxAttempts: number;
+    baseDelayMs: number;
+    maxDelayMs: number;
+    multiplier: number;
+};
+type TransportBatchConfig = {
+    enabled: boolean;
+    batchSize: number;
+    maxWaitMs: number;
+};
+type TransportTimeoutConfig = {
+    enabled: boolean;
+    timeoutMs: number;
+};
+type TransportOfflineConfig = {
+    enabled: boolean;
+};
+type TransportFlushConfig = {
+    enabled: boolean;
+    flushIntervalMs: number;
+    flushOnDestroy: boolean;
+    prepareUnloadHooks: boolean;
+};
+type TransportConfig = {
+    enabled: boolean;
+    sender: TransportSenderConfig;
+    persistence: TransportPersistenceConfig;
+    replay: TransportReplayConfig;
+    ordering: TransportOrderingConfig;
+    coordination: TransportCoordinationConfig;
+    circuitBreaker: TransportCircuitBreakerConfig;
+    backpressure: TransportBackpressureConfig;
+    deadLetter: TransportDeadLetterConfig;
+    compression: TransportCompressionConfig;
+    retry: TransportRetryConfig;
+    batch: TransportBatchConfig;
+    timeout: TransportTimeoutConfig;
+    offline: TransportOfflineConfig;
+    flush: TransportFlushConfig;
+};
+
+type VisitorStoragePersistence = 'memory' | 'cookie' | 'localStorage' | 'cookie_localStorage';
+type SessionStoragePersistence = 'memory' | 'sessionStorage' | 'localStorage';
+type AttributionStoragePersistence = 'memory' | 'localStorage' | 'cookie' | 'cookie_localStorage';
+type QueueStoragePersistence = 'memory' | 'localStorage' | 'indexedDB';
+
+type StorageKeysConfig = {
+    visitor?: string;
+    session?: string;
+    queue?: string;
+    pendingEvents?: string;
+    heartbeat?: string;
+    fingerprint?: string;
+    attribution?: string;
+    custom?: Record<string, string>;
+};
+type StorageConfig = {
+    /**
+     * Identificador lógico do pixel para composição de chaves de storage.
+     * Ex.: `"bemony-checkout"` → `__gmk:bemony-checkout:vid`
+     */
+    namespace: string;
+    /**
+     * Prefixo global das chaves de storage.
+     * Ex.: `"__gmk"` → `__gmk:bemony-checkout:vid`
+     */
+    prefix?: string;
+    persistence?: {
+        visitor?: VisitorStoragePersistence;
+        session?: SessionStoragePersistence;
+        attribution?: AttributionStoragePersistence;
+    };
+    queue?: {
+        enabled: boolean;
+        persistence: QueueStoragePersistence;
+        index?: boolean;
+    };
+    keys?: StorageKeysConfig;
+};
+
+type FingerprintMode = 'light' | 'full';
+
+type PaymentMethod = 'CREDIT_CARD' | 'PIX' | 'BANK_SLIP';
+
+/**
+ * Tipo padrão/fallback para interpretar selectors string sem prefixo.
+ *
+ * Ordem de resolução (`SelectorResolver`):
+ * 1. Objeto → selector.type
+ * 2. String com prefixo (css:, id:, class:, attr:, attribute:, text:) → prefixo
+ * 3. String sem prefixo → selectorType
+ * 4. Sem selectorType → css (DEFAULT_SELECTOR_TYPE)
+ */
+type SelectorType = 'css' | 'id' | 'class' | 'attribute' | 'text';
+/** Fallback quando `selectorType` é omitido. */
+declare const DEFAULT_SELECTOR_TYPE: SelectorType;
+/**
+ * Forma avançada de um seletor individual.
+ * `exact` / `caseSensitive` aplicam-se principalmente a `type: 'text'`.
+ * `closest` restringe a busca a um ancestral CSS (resolvido na etapa do Resolver).
+ */
+type SelectorDescriptor = {
+    type: SelectorType;
+    value: string;
+    exact?: boolean;
+    caseSensitive?: boolean;
+    closest?: string;
+};
+/** Um seletor: string simples/prefixada ou descritor tipado. */
+type SelectorInput = string | SelectorDescriptor;
+/** Um ou vários seletores (OR — qualquer match dispara). */
+type SelectorConfig = SelectorInput | SelectorInput[];
+/**
+ * Extrai o valor primário de um `SelectorConfig` (utilitário de config).
+ * Para match/query no DOM, use `SelectorResolver`.
+ */
+declare function getPrimarySelectorValue(selector: SelectorConfig | undefined): string | null;
+/**
+ * Resolve o `selectorType` efetivo: config explícita → tipo do descriptor → css.
+ */
+declare function resolveSelectorTypeFallback(selector: SelectorConfig | undefined, selectorType?: SelectorType): SelectorType;
+
+/**
+ * Condição de formulário para liberar o disparo de um evento auto.
+ * Não representa dados de produto — apenas campos/triggers necessários.
+ */
+type SelectorFormTrigger = 'input' | 'change' | 'submit' | 'click' | 'auto';
+type SelectorFormMode = 'all' | 'any';
+type SelectorFormConfig = string[] | {
+    fields: string[];
+    mode?: SelectorFormMode;
+    minRequired?: number;
+    formSelector?: string;
+    trigger?: SelectorFormTrigger;
+    debounceMs?: number;
+    fireOnce?: boolean;
+};
+
+/**
+ * Contrato de fontes independentes para auto detectors (Etapa 14+).
+ * Um evento automático pode ter várias sources; cada uma vira um detector.
+ *
+ * A source `url` observa a URL da página (`window.location`) / rotas.
+ * A source `link` observa o destino de um `<a href>` clicado.
+ */
+
+type AutoSourceType = 'selector' | 'form' | 'payment' | 'lifecycle' | 'url' | 'link';
+type AutoSourceBase = {
+    /** Nome estável da source (obrigatório). */
+    name: string;
+    type: AutoSourceType;
+    enabled?: boolean;
+    fireOnce?: boolean;
+    debounceMs?: number;
+    cooldownMs?: number;
+};
+type SelectorAutoTrigger = 'click' | 'submit' | 'hover' | 'visible';
+type SelectorAutoSource = AutoSourceBase & {
+    type: 'selector';
+    selector: SelectorConfig;
+    selectorType?: SelectorType;
+    trigger?: SelectorAutoTrigger;
+    /**
+     * Só para `trigger: 'visible'`. Fração visível 0–1.
+     * Default `0` (qualquer parte na viewport).
+     */
+    visibleThreshold?: number;
+};
+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';
+};
+/**
+ * Observa a URL da página atual (location / history).
+ * Não confundir com `LinkAutoSource` (destino de um clique em âncora).
+ */
+type UrlAutoSource = AutoSourceBase & {
+    type: 'url';
+    patterns: string[];
+};
+/** Protocols HTTP suportados pelo matcher de links. */
+type LinkMatchProtocol = 'http:' | 'https:';
+/**
+ * Condição de query string para match de destino.
+ * Sem regex arbitrária / callbacks.
+ */
+type LinkQueryCondition = {
+    key: string;
+    operator: 'exists' | 'absent';
+} | {
+    key: string;
+    operator: 'equals' | 'starts_with';
+    value: string;
+    caseSensitive?: boolean;
+} | {
+    key: string;
+    operator: 'one_of';
+    value: string[];
+    caseSensitive?: boolean;
+};
+type LinkQueryMatch = {
+    /** Default: `all`. */
+    mode?: 'all' | 'any';
+    conditions: LinkQueryCondition[];
+};
+/**
+ * Regras para reconhecer o destino do link (AND entre grupos configurados).
+ * Arrays dentro de um grupo usam OR.
+ */
+type LinkTargetMatch = {
+    protocols?: LinkMatchProtocol[];
+    /** Origins absolutas normalizadas (sem `/` final), ex.: `https://checkout.example.com`. */
+    origins?: string[];
+    /** Hostnames em lowercase, ex.: `checkout.example.com`. */
+    hostnames?: string[];
+    path?: {
+        exact?: string[];
+        prefixes?: string[];
+        /**
+         * Prefixo de **segmento** do path (não do pathname inteiro).
+         * Ex.: `pri` casa `/pri6670988`, `/pri_123` e `/examples/security/pri6670988.html`,
+         * mas não `/privacy` (próximo char precisa ser dígito ou `_`+dígito).
+         */
+        segmentPrefixes?: string[];
+        /**
+         * Template simples: `/pay/:offerId`.
+         * `:param` captura um segmento; literais devem casar exatamente.
+         */
+        template?: string;
+    };
+    query?: LinkQueryMatch;
+};
+/**
+ * Origem de um valor resolvido a partir do link / elemento.
+ */
+type LinkValueResolver = {
+    source: 'query';
+    key: string;
+} | {
+    source: 'pathParam';
+    key: string;
+} | {
+    source: 'pathSegment';
+    /**
+     * Índice do segmento (0 = primeiro).
+     * Índice negativo conta do fim (`-1` = último segmento).
+     */
+    index: number;
+} | {
+    source: 'attribute';
+    name: string;
+} | {
+    source: 'dataset';
+    /** Chave camelCase do `dataset` (`data-product-id` → `productId`). */
+    key: string;
+} | {
+    source: 'static';
+    value: string | number | boolean | null;
+} | {
+    source: 'href' | 'origin' | 'hostname' | 'pathname' | 'text';
+};
+type LinkValueTransform = 'trim' | 'lowercase' | 'uppercase' | 'number';
+type LinkValueBinding = {
+    from: LinkValueResolver | LinkValueResolver[];
+    required?: boolean;
+    transform?: LinkValueTransform;
+};
+/**
+ * Source automática baseada no destino de um link clicado.
+ *
+ * `match` decide se o destino corresponde.
+ * `bindings` resolve valores genéricos (incluindo chaves semânticas
+ * como `productId` reconhecidas pelo mapper do evento).
+ */
+type LinkAutoSource = AutoSourceBase & {
+    type: 'link';
+    /** Somente click nesta etapa. Default: `click`. */
+    trigger?: 'click';
+    /**
+     * Restrição opcional sobre o elemento.
+     * Sem selector, usa o `<a href>` ancestral mais próximo do clique.
+     */
+    selector?: SelectorConfig;
+    selectorType?: SelectorType;
+    /** Regras de reconhecimento do destino. */
+    match: LinkTargetMatch;
+    /**
+     * Valores extraídos do link / elemento / configuração.
+     * Chaves são genéricas; o mapper do evento reconhece semântica
+     * opcional (`productId`, `query`, etc.).
+     */
+    bindings?: Record<string, LinkValueBinding>;
+};
+type AutoTrackSource = SelectorAutoSource | FormAutoSource | PaymentAutoSource | LifecycleAutoSource | UrlAutoSource | LinkAutoSource;
+
+/**
+ * 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;
+    sku?: string;
+    type?: ProductType;
+    price?: number;
+    currency?: string;
+    quantity?: number;
+    category?: string;
+    variant?: string;
+    brand?: string;
+    metadata?: Record<string, unknown>;
+};
+type CommerceCartItem = {
+    productId: string;
+    quantity?: number;
+    price?: number;
+    currency?: string;
+    selected?: boolean;
+    metadata?: Record<string, unknown>;
+};
+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?: ProductCatalogConfig;
+    cart?: CommerceCartConfig;
+    mappings?: CommerceMappingsConfig;
+    enrichment?: CommerceEnrichmentConfig;
+};
+declare const DEFAULT_COMMERCE_ENRICHMENT: Required<CommerceEnrichmentConfig>;
+/**
+ * Commerce on by default so catalog/cart enrichment runs when products exist.
+ * Empty catalog / empty cart is a no-op.
+ */
+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 = {
+    /** 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;
+    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 = {
+    enabled: boolean;
+    thresholds: number[];
+    debounceMs: number;
+};
+type ClickBehaviorConfig = {
+    enabled: boolean;
+    rageClick: {
+        enabled: boolean;
+        threshold: number;
+        windowMs: number;
+    };
+};
+type IdleBehaviorConfig = {
+    enabled: boolean;
+    thresholdMs: number;
+};
+type VisibilityBehaviorConfig = {
+    enabled: boolean;
+};
+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 = {
+    readonly enabled: boolean;
+    readonly targets: readonly ViewportTargetConfig[];
+    readonly rootMargin: string;
+    readonly observeMutations: boolean;
+    readonly mutationDebounceMs: number;
+    readonly maxObservedElements: number;
+};
+/**
+ * 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;
+        idle: IdleBehaviorConfig;
+        visibility: VisibilityBehaviorConfig;
+        exitIntent: ExitIntentBehaviorConfig;
+        viewport: ViewportBehaviorConfig;
+    };
+};
+
+type ManualEventConfig = {
+    enabled: boolean;
+};
+type ManualConversionConfig = {
+    pageView: ManualEventConfig;
+    purchase: ManualEventConfig;
+    lead: ManualEventConfig;
+    addToCart: ManualEventConfig;
+    removeFromCart: ManualEventConfig;
+    initiateCheckout: ManualEventConfig;
+    addPaymentInfo: ManualEventConfig;
+    search: ManualEventConfig;
+    viewContent: ManualEventConfig;
+};
+/**
+ * Config de um auto detector — fontes independentes em `sources[]`.
+ */
+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: ConversionAutoDetectorsConfig;
+};
+type ConversionRulesConfig = {
+    enabled: boolean;
+    selectors: string[];
+    texts: string[];
+    urlPatterns: string[];
+    checkout: {
+        enabled: boolean;
+    };
+    card: {
+        enabled: boolean;
+    };
+};
+/**
+ * Config do módulo de conversion.
+ * Commerce é root (`PixelConfig.commerce`) — não vive aqui.
+ */
+type ConversionModuleConfig = {
+    enabled: boolean;
+    manual: ManualConversionConfig;
+    auto: AutoConversionConfig;
+    rules: ConversionRulesConfig;
+};
+
+type PageViewConfig = {
+    enabled: boolean;
+    trackInitialPageView: boolean;
+    spa: boolean;
+    dedupeMs: number;
+};
+type VisitorConfig = {
+    enabled: boolean;
+    persistence: VisitorStoragePersistence;
+    renew: boolean;
+};
+type SessionConfig = {
+    enabled: boolean;
+    ttlMs: number;
+    renewOnActivity: boolean;
+    renewOnPageView: boolean;
+};
+type FingerprintConfig = {
+    enabled: boolean;
+    mode: FingerprintMode;
+    cache: boolean;
+};
+type ConsentConfig = {
+    enabled: boolean;
+    required: boolean;
+    waitForConsent: boolean;
+};
+type DedupeConfig = {
+    enabled: boolean;
+    windowMs: number;
+};
+type CoordinationConfig = {
+    enabled: boolean;
+    leaderElection: boolean;
+    broadcastChannel: boolean;
+};
+type OrderingConfig = {
+    enabled: boolean;
+    preserveOrder: boolean;
+};
+type CoreModuleConfig = {
+    enabled: boolean;
+    pageView: PageViewConfig;
+    visitor: VisitorConfig;
+    session: SessionConfig;
+    fingerprint: FingerprintConfig;
+    consent: ConsentConfig;
+    dedupe: DedupeConfig;
+    coordination: CoordinationConfig;
+    ordering: OrderingConfig;
+    /** Core UrlContext — off por default. */
+    urlContext?: UrlContextConfig;
+};
+
+type PrivacyConsentConfig = {
+    enabled: boolean;
+    required: boolean;
+};
+type PiiConfig = {
+    enabled: boolean;
+    hashEmail: boolean;
+    hashPhone: boolean;
+};
+type AnonymizationConfig = {
+    enabled: boolean;
+    anonymizeIp: boolean;
+};
+type PrivacyModuleConfig = {
+    enabled: boolean;
+    consent: PrivacyConsentConfig;
+    pii: PiiConfig;
+    anonymization: AnonymizationConfig;
+};
+
+type ModulesConfig = {
+    core: CoreModuleConfig;
+    behavior: BehaviorModuleConfig;
+    conversion: ConversionModuleConfig;
+    integrations: IntegrationsModuleConfig;
+    privacy: PrivacyModuleConfig;
+};
+
+type PixelConfig = {
+    app: AppConfig;
+    identity: IdentityConfig;
+    transport: TransportConfig;
+    storage: StorageConfig;
+    attribution: AttributionConfig;
+    /** Contexto comercial global da página/fluxo (fora dos módulos). */
+    commerce: CommerceConfig;
+    modules: ModulesConfig;
+};
+
+export { type LinkQueryCondition as $, type AttributionStoragePersistence as A, type BehaviorModuleConfig as B, type CommerceConfig as C, type TransportReplayConfig as D, type TransportRetryConfig as E, type TransportTestSenderConfig as F, type TransportTimeoutConfig as G, type StorageKeysConfig as H, type IdentityConfig as I, type AutoSourceBase as J, type KnownPixelPlatform as K, type AutoSourceType as L, type ModulesConfig as M, type AutoTrackSource as N, type EngagementThresholds as O, type PixelConfig as P, type QueueStoragePersistence as Q, type EngagementWeights as R, type SessionStoragePersistence as S, type TransportConfig as T, type EngagementPenalties as U, type VisitorStoragePersistence as V, type FingerprintMode as W, type FormAutoSource as X, type LifecycleAutoSource as Y, type LinkAutoSource as Z, type LinkMatchProtocol as _, type AppConfig as a, type PrivacyConsentConfig as a$, type LinkQueryMatch as a0, type LinkTargetMatch as a1, type LinkValueBinding as a2, type LinkValueResolver as a3, type LinkValueTransform as a4, type PaymentAutoSource as a5, type PaymentMethod as a6, type SelectorAutoSource as a7, type SelectorAutoTrigger as a8, type SelectorConfig as a9, type AnonymizationConfig as aA, type AutoConversionConfig as aB, type AutoDetectorConfig as aC, type ClickBehaviorConfig as aD, type ConsentConfig as aE, type ConversionAutoDetectorsConfig as aF, type ConversionRulesConfig as aG, type CoordinationConfig as aH, type DedupeConfig as aI, type EngagementBehaviorConfig as aJ, type ExitIntentBehaviorConfig as aK, type FingerprintConfig as aL, type GoogleBrowserDestinationConfig as aM, type GoogleIntegrationConfig as aN, type HeartbeatModuleConfig as aO, type IdleBehaviorConfig as aP, type InitiateCheckoutAutoDetectorConfig as aQ, type IntegrationTestDestinationConfig as aR, type LeadAutoDetectorConfig as aS, type ManualConversionConfig as aT, type ManualEventConfig as aU, type MetaBrowserDestinationConfig as aV, type MetaIntegrationConfig as aW, type TikTokBrowserDestinationConfig as aX, type OrderingConfig as aY, type PageViewConfig as aZ, type PiiConfig as a_, type SelectorDescriptor as aa, type SelectorInput as ab, type SelectorType as ac, type SelectorFormConfig as ad, type SelectorFormMode as ae, type SelectorFormTrigger as af, type CommerceCalculateValueFrom as ag, type CommerceCartConfig as ah, type CommerceCartItem as ai, type CommerceCartMode as aj, type CommerceEnrichmentConfig as ak, type CommerceEnrichmentSource as al, type CommerceEventEnrichmentConfig as am, type CommerceMappingsConfig as an, type CommerceProduct as ao, type ProductCatalogConfig as ap, type ProductType as aq, type UrlAutoSource as ar, DEFAULT_SELECTOR_TYPE as as, DEFAULT_COMMERCE_CONFIG as at, DEFAULT_COMMERCE_ENRICHMENT as au, getPrimarySelectorValue as av, normalizeCalculateValueFrom as aw, resolveSelectorTypeFallback as ax, type AddPaymentInfoAutoDetectorConfig as ay, type AddToCartAutoDetectorConfig as az, type TransportSenderConfig as b, type PurchaseAutoDetectorConfig as b0, type RemoveFromCartAutoDetectorConfig as b1, type ScrollBehaviorConfig as b2, type SearchAutoDetectorConfig as b3, type SessionConfig as b4, type ViewContentAutoDetectorConfig as b5, type ViewportBehaviorConfig as b6, type ViewportTargetConfig as b7, type VisibilityBehaviorConfig as b8, type VisitorConfig as b9, type StorageConfig as c, type AttributionConfig as d, type ConversionModuleConfig as e, type CoreModuleConfig as f, type IntegrationsModuleConfig as g, type PrivacyModuleConfig as h, type KnownPixelSource as i, type PixelEnvironment as j, type PixelPlatform as k, type PixelSource as l, type PixelTarget as m, type TransportBackpressureConfig as n, type TransportBackpressurePolicy as o, type TransportBatchConfig as p, type TransportCircuitBreakerConfig as q, type TransportCompressionConfig as r, type TransportCoordinationConfig as s, type TransportDeadLetterConfig as t, type TransportExternalSenderConfig as u, type TransportFlushConfig as v, type TransportInternalSenderConfig as w, type TransportOfflineConfig as x, type TransportOrderingConfig as y, type TransportPersistenceConfig as z };