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

package/dist/{pixel-CKc4OQUx.d.mts → pixel-C93c-0M2.d.mts}

@@ -1,4 +1,4 @@
-import { U as UrlContextConfig } from './url-context-BjAsQoVl.mjs';
+import { U as UrlContextConfig } from './url-context-Ck2LK18V.mjs';
 
 type MetaBrowserDestinationConfig = {
     enabled: boolean;
@@ -77,15 +77,104 @@ type AttributionConfig = {
     readonly customClickIdParams?: string[];
 };
 
-type TransportConfig = {
-    apiEndpoint: string;
-    apiKey?: string;
-    timeoutMs?: number;
-    batch?: {
-        enabled: boolean;
-        flushIntervalMs: number;
-        maxBatchSize: number;
+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';
@@ -186,12 +275,16 @@ type SelectorFormConfig = string[] | {
 };
 
 /**
- * Contrato de fontes independentes para auto detectors (Etapa 14).
+ * 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';
+type AutoSourceType = 'selector' | 'form' | 'payment' | 'lifecycle' | 'url' | 'link';
 type AutoSourceBase = {
+    /** Nome estável da source (obrigatório). */
     name: string;
     type: AutoSourceType;
     enabled?: boolean;
@@ -199,11 +292,17 @@ type AutoSourceBase = {
     debounceMs?: number;
     cooldownMs?: number;
 };
+type SelectorAutoTrigger = 'click' | 'submit' | 'hover' | 'visible';
 type SelectorAutoSource = AutoSourceBase & {
     type: 'selector';
     selector: SelectorConfig;
     selectorType?: SelectorType;
-    trigger?: 'click' | 'submit';
+    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';
@@ -223,11 +322,128 @@ 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[];
 };
-type AutoTrackSource = SelectorAutoSource | FormAutoSource | PaymentAutoSource | LifecycleAutoSource | UrlAutoSource;
+/** 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`).
@@ -296,7 +512,10 @@ type CommerceConfig = {
     enrichment?: CommerceEnrichmentConfig;
 };
 declare const DEFAULT_COMMERCE_ENRICHMENT: Required<CommerceEnrichmentConfig>;
-/** Default seguro: commerce off, sem produtos, sem itens. */
+/**
+ * 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';
@@ -623,96 +842,10 @@ type PrivacyModuleConfig = {
     anonymization: AnonymizationConfig;
 };
 
-type TransportRetryConfig = {
-    enabled: boolean;
-    maxAttempts: number;
-    baseDelayMs: number;
-    maxDelayMs: number;
-    multiplier: number;
-};
-type TransportBatchConfig = {
-    enabled: boolean;
-    batchSize: number;
-    flushIntervalMs: number;
-    maxWaitMs: number;
-};
-type TransportTimeoutConfig = {
-    enabled: boolean;
-    timeoutMs: number;
-};
-type TransportOfflineConfig = {
-    enabled: boolean;
-};
-type TransportFlushConfig = {
-    enabled: boolean;
-    flushIntervalMs: number;
-    flushOnDestroy: boolean;
-    prepareUnloadHooks: boolean;
-};
-type TransportSenderMode = 'mock' | 'http';
-type TransportSenderConfig = {
-    mode: TransportSenderMode;
-};
-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 TransportModuleConfig = {
-    enabled: boolean;
-    /** @deprecated Use sender.mode instead */
-    mockSender: {
-        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 ModulesConfig = {
     core: CoreModuleConfig;
     behavior: BehaviorModuleConfig;
     conversion: ConversionModuleConfig;
-    transport: TransportModuleConfig;
     integrations: IntegrationsModuleConfig;
     privacy: PrivacyModuleConfig;
 };
@@ -728,4 +861,4 @@ type PixelConfig = {
     modules: ModulesConfig;
 };
 
-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 };
+export { type LinkValueBinding as $, type AttributionStoragePersistence as A, type BehaviorModuleConfig as B, type CommerceConfig as C, type TransportTestSenderConfig as D, type TransportTimeoutConfig as E, type StorageKeysConfig as F, type AutoSourceBase as G, type AutoSourceType as H, type IdentityConfig as I, type AutoTrackSource as J, type EngagementThresholds as K, type EngagementWeights as L, type ModulesConfig as M, type EngagementPenalties as N, type FingerprintMode as O, type PixelConfig as P, type QueueStoragePersistence as Q, type FormAutoSource as R, type SessionStoragePersistence as S, type TransportConfig as T, type LifecycleAutoSource as U, type VisitorStoragePersistence as V, type LinkAutoSource as W, type LinkMatchProtocol as X, type LinkQueryCondition as Y, type LinkQueryMatch as Z, type LinkTargetMatch as _, type AppConfig as a, type ScrollBehaviorConfig as a$, type LinkValueResolver as a0, type LinkValueTransform as a1, type PaymentAutoSource as a2, type PaymentMethod as a3, type SelectorAutoSource as a4, type SelectorAutoTrigger as a5, type SelectorConfig as a6, type SelectorDescriptor as a7, type SelectorInput as a8, type SelectorType as a9, type ClickBehaviorConfig as aA, type ConsentConfig as aB, type ConversionAutoDetectorsConfig as aC, type ConversionRulesConfig as aD, type CoordinationConfig as aE, type DedupeConfig as aF, type EngagementBehaviorConfig as aG, type ExitIntentBehaviorConfig as aH, type FingerprintConfig as aI, type GoogleBrowserDestinationConfig as aJ, type GoogleIntegrationConfig as aK, type HeartbeatModuleConfig as aL, type IdleBehaviorConfig as aM, type InitiateCheckoutAutoDetectorConfig as aN, type IntegrationTestDestinationConfig as aO, type LeadAutoDetectorConfig as aP, type ManualConversionConfig as aQ, type ManualEventConfig as aR, type MetaBrowserDestinationConfig as aS, type MetaIntegrationConfig 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 RemoveFromCartAutoDetectorConfig as a_, type SelectorFormConfig as aa, type SelectorFormMode as ab, type SelectorFormTrigger as ac, type CommerceCalculateValueFrom as ad, type CommerceCartConfig as ae, type CommerceCartItem as af, type CommerceCartMode as ag, type CommerceEnrichmentConfig as ah, type CommerceEnrichmentSource as ai, type CommerceEventEnrichmentConfig as aj, type CommerceMappingsConfig as ak, type CommerceProduct as al, type ProductCatalogConfig as am, type ProductType as an, type UrlAutoSource as ao, DEFAULT_SELECTOR_TYPE as ap, DEFAULT_COMMERCE_CONFIG as aq, DEFAULT_COMMERCE_ENRICHMENT as ar, getPrimarySelectorValue as as, normalizeCalculateValueFrom as at, resolveSelectorTypeFallback as au, type AddPaymentInfoAutoDetectorConfig as av, type AddToCartAutoDetectorConfig as aw, type AnonymizationConfig as ax, type AutoConversionConfig as ay, type AutoDetectorConfig as az, type TransportSenderConfig as b, type SearchAutoDetectorConfig as b0, type SessionConfig as b1, type ViewContentAutoDetectorConfig as b2, type ViewportBehaviorConfig as b3, type ViewportTargetConfig as b4, type VisibilityBehaviorConfig as b5, type VisitorConfig as b6, 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 PixelEnvironment as i, type PixelSource as j, type PixelTarget as k, type TransportBackpressureConfig as l, type TransportBackpressurePolicy as m, type TransportBatchConfig as n, type TransportCircuitBreakerConfig as o, type TransportCompressionConfig as p, type TransportCoordinationConfig as q, type TransportDeadLetterConfig as r, type TransportExternalSenderConfig as s, type TransportFlushConfig as t, type TransportInternalSenderConfig as u, type TransportOfflineConfig as v, type TransportOrderingConfig as w, type TransportPersistenceConfig as x, type TransportReplayConfig as y, type TransportRetryConfig as z };