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

package/dist/types-D0KVsgzs.d.mts

@@ -0,0 +1,293 @@
+import { P as PixelEvent, b as PixelItem, S as StorageService, B as BrowserMetadataService, c as BaseEventBuilder, A as AttributionService, U as UrlContextService } from './index-BxT2d-TK.mjs';
+import { ao as CommerceProduct, ai as CommerceCartItem, ag as CommerceCalculateValueFrom, al as CommerceEnrichmentSource, C as CommerceConfig, am as CommerceEventEnrichmentConfig, aw as normalizeCalculateValueFrom, an as CommerceMappingsConfig } from './pixel-_BSDpx4M.mjs';
+
+interface DispatcherService {
+    dispatch(event: PixelEvent): void;
+    subscribe(listener: (event: PixelEvent) => void): () => void;
+    clear(): void;
+    getListenerCount(): number;
+    getLastEvent(): PixelEvent | null;
+}
+
+type ProductCatalogOptions = {
+    readonly defaultCurrency?: string;
+};
+type ProductCatalogSnapshot = {
+    readonly products: CommerceProduct[];
+    readonly count: number;
+};
+/**
+ * Catálogo de produtos configurados em `config.commerce.catalog`.
+ * Isolado por instância — sem estado global / module-level.
+ * Não acessa DOM, Transport nem altera payloads de eventos.
+ */
+declare class ProductCatalog {
+    private readonly productsById;
+    private readonly productsBySku;
+    private readonly orderedIds;
+    constructor(products?: readonly CommerceProduct[] | undefined, options?: ProductCatalogOptions);
+    list(): CommerceProduct[];
+    getById(id: string): CommerceProduct | null;
+    getBySku(sku: string): CommerceProduct | null;
+    hasProduct(id: string): boolean;
+    getSnapshot(): ProductCatalogSnapshot;
+    private indexProducts;
+    private normalizeProduct;
+    private cloneProduct;
+}
+
+type CommerceStateOptions = {
+    /**
+     * Quando `false`, `upsertItem` só atualiza itens já presentes
+     * (não adiciona novos productIds). Default: `true`.
+     */
+    readonly allowDynamicItems?: boolean;
+};
+type CommerceStateSnapshot = {
+    /**
+     * Estado vivo do carrinho (runtime).
+     * Não confundir com `commerce.cart.initialItems` da config.
+     */
+    readonly selectedItems: CommerceCartItem[];
+    readonly count: number;
+};
+/**
+ * Estado em memória do cart da instância.
+ * Inicializado com `config.commerce.cart.initialItems`.
+ * Não persiste, não acessa DOM/Transport e não dispara eventos.
+ */
+declare class CommerceState {
+    private readonly itemsByProductId;
+    private readonly allowDynamicItems;
+    constructor(initialItems?: readonly CommerceCartItem[] | undefined, options?: CommerceStateOptions);
+    getSelectedItems(): CommerceCartItem[];
+    hasItem(productId: string): boolean;
+    getItem(productId: string): CommerceCartItem | null;
+    /**
+     * Insere ou atualiza item.
+     * - Sem `productId` → no-op
+     * - `selected === false` → remove se existir / não adiciona
+     * - `quantity <= 0` → remove
+     * - `allowDynamicItems === false` e item novo → no-op
+     */
+    upsertItem(item: CommerceCartItem): void;
+    removeItem(productId: string): void;
+    /**
+     * Atualiza quantidade. `quantity <= 0` remove o item.
+     */
+    updateQuantity(productId: string, quantity: number): void;
+    clear(): void;
+    getSnapshot(): CommerceStateSnapshot;
+    private seed;
+    private seedItem;
+    private normalizeQuantity;
+    private cloneItem;
+}
+
+/**
+ * Calcula value/currency a partir de items resolvidos.
+ * Não conhece DOM, detectors, Transport nem Dispatcher.
+ * Não muta o input.
+ */
+type ResolvedCommerceItem = {
+    productId?: string;
+    sku?: string;
+    productName?: string;
+    price?: number;
+    quantity?: number;
+    currency?: string;
+    category?: string;
+    variant?: string;
+    brand?: string;
+    type?: string;
+    metadata?: Record<string, unknown>;
+};
+type OrderCalculationInput = {
+    items?: ResolvedCommerceItem[];
+    value?: number;
+    currency?: string;
+    defaultCurrency?: string;
+};
+type OrderCalculationResult = {
+    items: ResolvedCommerceItem[];
+    value?: number;
+    currency?: string;
+};
+declare class OrderCalculator {
+    calculate(input: OrderCalculationInput): OrderCalculationResult;
+    private sumValue;
+    /**
+     * Ordem: currency manual → primeiro item com currency → defaultCurrency.
+     * Multi-currency: determinístico — usa o primeiro item com currency
+     * (não normaliza conversão entre moedas nesta etapa).
+     */
+    private resolveCurrency;
+    private cloneItem;
+}
+
+type CommerceEventType = 'ADD_TO_CART' | 'REMOVE_FROM_CART' | 'INITIATE_CHECKOUT' | 'PURCHASE' | 'VIEW_CONTENT' | 'ADD_PAYMENT_INFO';
+type ExtractedProductInput = {
+    productId?: string;
+    productName?: string;
+    price?: number;
+    quantity?: number;
+    currency?: string;
+    sku?: string;
+};
+type CommerceResolverInput = {
+    eventType: CommerceEventType;
+    payload?: Record<string, unknown>;
+    extractedProduct?: ExtractedProductInput;
+    enrichmentSource?: CommerceEnrichmentSource;
+    items?: Array<{
+        productId?: string;
+        id?: string;
+        sku?: string;
+        name?: string;
+        productName?: string;
+        price?: number;
+        quantity?: number;
+        currency?: string;
+        category?: string;
+    }>;
+};
+type CommerceResolverResult = {
+    data: Record<string, unknown>;
+    items?: ResolvedCommerceItem[];
+    value?: number;
+    currency?: string;
+};
+type CommerceResolverOptions = {
+    catalog: ProductCatalog;
+    state: CommerceState;
+    calculator: OrderCalculator;
+    defaultCurrency?: string;
+    calculateValueFrom?: CommerceCalculateValueFrom;
+};
+/**
+ * Combina payload + extracted + state + catalog + defaults.
+ * Não dispara eventos, não escreve em CommerceState, não conhece DOM/Transport.
+ *
+ * Prioridade de merge por campo:
+ * manual payload > extractedProduct > commerce state > catalog > defaults
+ */
+declare class CommerceResolver {
+    private readonly catalog;
+    private readonly state;
+    private readonly calculator;
+    private readonly defaultCurrency?;
+    private readonly calculateValueFrom;
+    constructor(options: CommerceResolverOptions);
+    resolve(input: CommerceResolverInput): CommerceResolverResult;
+    private resolveAddToCart;
+    /**
+     * Escolhe o item principal do cart runtime:
+     * 1. único item → esse
+     * 2. múltiplos → preferir catalog.type === 'main'
+     * 3. senão → primeiro do cart
+     * 4. cart vazio → null
+     */
+    private resolvePrimaryCartItem;
+    private resolveRemoveFromCart;
+    private resolveCheckoutLike;
+    private resolveViewContent;
+    /**
+     * null = payload não trouxe items (usar state conforme calculateValueFrom)
+     * [] = payload trouxe items vazios
+     */
+    private readPayloadItems;
+    private resolveItemsSource;
+    private enrichItem;
+    private toPixelItem;
+    private normalizeLooseItem;
+    private lookupIdBySku;
+    private lookupProductBySku;
+}
+
+type CommerceEnrichmentEvent = 'pageView' | 'viewContent' | 'lead' | 'addToCart' | 'removeFromCart' | 'initiateCheckout' | 'addPaymentInfo' | 'purchase';
+type PageViewCommercePayload = {
+    readonly value?: number;
+    readonly currency?: string;
+    readonly items?: PixelItem[];
+    readonly contentId?: string;
+    readonly contentName?: string;
+};
+/**
+ * Serviço compartilhado de commerce (root config).
+ * Usado por Core (PAGE_VIEW) e Conversion sem dependência circular
+ * entre os módulos.
+ */
+declare class CommerceService {
+    readonly enabled: boolean;
+    readonly config: CommerceConfig;
+    readonly catalog: ProductCatalog;
+    readonly state: CommerceState;
+    private readonly resolver;
+    constructor(config: CommerceConfig | undefined);
+    getEnrichment(event: CommerceEnrichmentEvent): CommerceEventEnrichmentConfig;
+    isEnabled(): boolean;
+    isEnrichmentEnabled(event: CommerceEnrichmentEvent): boolean;
+    getEnrichmentSource(event: CommerceEnrichmentEvent): CommerceEnrichmentSource;
+    /**
+     * Resolve payload de commerce para um evento conversion.
+     * Retorna null quando enrichment está desabilitado (caller usa payload original).
+     */
+    resolveForEvent(event: CommerceEnrichmentEvent, eventType: 'ADD_TO_CART' | 'REMOVE_FROM_CART' | 'INITIATE_CHECKOUT' | 'PURCHASE' | 'VIEW_CONTENT' | 'ADD_PAYMENT_INFO', payload?: Record<string, unknown>): Record<string, unknown> | null;
+    /**
+     * Payload de commerce para PAGE_VIEW quando enrichment.pageView.enabled.
+     * Não depende de ConversionEngine.
+     */
+    resolvePageViewEnrichment(): PageViewCommercePayload | null;
+    getResolver(): CommerceResolver;
+    getCalculateValueFrom(): ReturnType<typeof normalizeCalculateValueFrom>;
+    getMappings(): CommerceMappingsConfig | undefined;
+}
+
+interface FingerprintService {
+    getFingerprint(): string | null;
+    ensureFingerprint(): string;
+}
+
+interface SessionData {
+    readonly sessionId: string;
+    readonly lastActivityAt: number;
+    readonly createdAt: number;
+}
+type EnsureSessionResult = {
+    readonly sessionId: string;
+    readonly expired: boolean;
+    readonly previousSessionId?: string;
+    readonly created: boolean;
+};
+interface SessionService {
+    getSessionId(): string | null;
+    getSessionData(): SessionData | null;
+    getLastActivityAt(): number | null;
+    isExpired(ttlMs: number): boolean;
+    ensureSession(ttlMs: number): EnsureSessionResult;
+    ensureSessionId(): string;
+    touchActivity(): void;
+    renew(): string;
+    clear(): void;
+}
+
+interface VisitorService {
+    getVisitorId(): string | null;
+    ensureVisitorId(): string;
+    clearVisitorId(): void;
+}
+
+type PixelRuntimeServices = {
+    readonly storage: StorageService;
+    readonly visitor: VisitorService;
+    readonly session: SessionService;
+    readonly fingerprint: FingerprintService;
+    readonly dispatcher: DispatcherService;
+    readonly browserMetadata: BrowserMetadataService;
+    readonly eventBuilder: BaseEventBuilder;
+    readonly attribution: AttributionService;
+    readonly commerce: CommerceService;
+    readonly urlContext: UrlContextService;
+};
+
+export { CommerceResolver as C, type DispatcherService as D, type EnsureSessionResult as E, type FingerprintService as F, OrderCalculator as O, type PixelRuntimeServices as P, type ResolvedCommerceItem as R, type SessionService as S, type VisitorService as V, type SessionData as a, CommerceService as b, CommerceState as c, ProductCatalog as d, type CommerceEnrichmentEvent as e, type CommerceEventType as f, type CommerceResolverInput as g, type CommerceResolverOptions as h, type CommerceResolverResult as i, type CommerceStateOptions as j, type CommerceStateSnapshot as k, type ExtractedProductInput as l, type OrderCalculationInput as m, type OrderCalculationResult as n, type PageViewCommercePayload as o, type ProductCatalogOptions as p, type ProductCatalogSnapshot as q };

package/dist/types-D3kJ9bfT.d.ts

@@ -0,0 +1,293 @@
+import { P as PixelEvent, b as PixelItem, S as StorageService, B as BrowserMetadataService, c as BaseEventBuilder, A as AttributionService, U as UrlContextService } from './index-B8u_3PGG.js';
+import { ao as CommerceProduct, ai as CommerceCartItem, ag as CommerceCalculateValueFrom, al as CommerceEnrichmentSource, C as CommerceConfig, am as CommerceEventEnrichmentConfig, aw as normalizeCalculateValueFrom, an as CommerceMappingsConfig } from './pixel-DNGbAN5C.js';
+
+interface DispatcherService {
+    dispatch(event: PixelEvent): void;
+    subscribe(listener: (event: PixelEvent) => void): () => void;
+    clear(): void;
+    getListenerCount(): number;
+    getLastEvent(): PixelEvent | null;
+}
+
+type ProductCatalogOptions = {
+    readonly defaultCurrency?: string;
+};
+type ProductCatalogSnapshot = {
+    readonly products: CommerceProduct[];
+    readonly count: number;
+};
+/**
+ * Catálogo de produtos configurados em `config.commerce.catalog`.
+ * Isolado por instância — sem estado global / module-level.
+ * Não acessa DOM, Transport nem altera payloads de eventos.
+ */
+declare class ProductCatalog {
+    private readonly productsById;
+    private readonly productsBySku;
+    private readonly orderedIds;
+    constructor(products?: readonly CommerceProduct[] | undefined, options?: ProductCatalogOptions);
+    list(): CommerceProduct[];
+    getById(id: string): CommerceProduct | null;
+    getBySku(sku: string): CommerceProduct | null;
+    hasProduct(id: string): boolean;
+    getSnapshot(): ProductCatalogSnapshot;
+    private indexProducts;
+    private normalizeProduct;
+    private cloneProduct;
+}
+
+type CommerceStateOptions = {
+    /**
+     * Quando `false`, `upsertItem` só atualiza itens já presentes
+     * (não adiciona novos productIds). Default: `true`.
+     */
+    readonly allowDynamicItems?: boolean;
+};
+type CommerceStateSnapshot = {
+    /**
+     * Estado vivo do carrinho (runtime).
+     * Não confundir com `commerce.cart.initialItems` da config.
+     */
+    readonly selectedItems: CommerceCartItem[];
+    readonly count: number;
+};
+/**
+ * Estado em memória do cart da instância.
+ * Inicializado com `config.commerce.cart.initialItems`.
+ * Não persiste, não acessa DOM/Transport e não dispara eventos.
+ */
+declare class CommerceState {
+    private readonly itemsByProductId;
+    private readonly allowDynamicItems;
+    constructor(initialItems?: readonly CommerceCartItem[] | undefined, options?: CommerceStateOptions);
+    getSelectedItems(): CommerceCartItem[];
+    hasItem(productId: string): boolean;
+    getItem(productId: string): CommerceCartItem | null;
+    /**
+     * Insere ou atualiza item.
+     * - Sem `productId` → no-op
+     * - `selected === false` → remove se existir / não adiciona
+     * - `quantity <= 0` → remove
+     * - `allowDynamicItems === false` e item novo → no-op
+     */
+    upsertItem(item: CommerceCartItem): void;
+    removeItem(productId: string): void;
+    /**
+     * Atualiza quantidade. `quantity <= 0` remove o item.
+     */
+    updateQuantity(productId: string, quantity: number): void;
+    clear(): void;
+    getSnapshot(): CommerceStateSnapshot;
+    private seed;
+    private seedItem;
+    private normalizeQuantity;
+    private cloneItem;
+}
+
+/**
+ * Calcula value/currency a partir de items resolvidos.
+ * Não conhece DOM, detectors, Transport nem Dispatcher.
+ * Não muta o input.
+ */
+type ResolvedCommerceItem = {
+    productId?: string;
+    sku?: string;
+    productName?: string;
+    price?: number;
+    quantity?: number;
+    currency?: string;
+    category?: string;
+    variant?: string;
+    brand?: string;
+    type?: string;
+    metadata?: Record<string, unknown>;
+};
+type OrderCalculationInput = {
+    items?: ResolvedCommerceItem[];
+    value?: number;
+    currency?: string;
+    defaultCurrency?: string;
+};
+type OrderCalculationResult = {
+    items: ResolvedCommerceItem[];
+    value?: number;
+    currency?: string;
+};
+declare class OrderCalculator {
+    calculate(input: OrderCalculationInput): OrderCalculationResult;
+    private sumValue;
+    /**
+     * Ordem: currency manual → primeiro item com currency → defaultCurrency.
+     * Multi-currency: determinístico — usa o primeiro item com currency
+     * (não normaliza conversão entre moedas nesta etapa).
+     */
+    private resolveCurrency;
+    private cloneItem;
+}
+
+type CommerceEventType = 'ADD_TO_CART' | 'REMOVE_FROM_CART' | 'INITIATE_CHECKOUT' | 'PURCHASE' | 'VIEW_CONTENT' | 'ADD_PAYMENT_INFO';
+type ExtractedProductInput = {
+    productId?: string;
+    productName?: string;
+    price?: number;
+    quantity?: number;
+    currency?: string;
+    sku?: string;
+};
+type CommerceResolverInput = {
+    eventType: CommerceEventType;
+    payload?: Record<string, unknown>;
+    extractedProduct?: ExtractedProductInput;
+    enrichmentSource?: CommerceEnrichmentSource;
+    items?: Array<{
+        productId?: string;
+        id?: string;
+        sku?: string;
+        name?: string;
+        productName?: string;
+        price?: number;
+        quantity?: number;
+        currency?: string;
+        category?: string;
+    }>;
+};
+type CommerceResolverResult = {
+    data: Record<string, unknown>;
+    items?: ResolvedCommerceItem[];
+    value?: number;
+    currency?: string;
+};
+type CommerceResolverOptions = {
+    catalog: ProductCatalog;
+    state: CommerceState;
+    calculator: OrderCalculator;
+    defaultCurrency?: string;
+    calculateValueFrom?: CommerceCalculateValueFrom;
+};
+/**
+ * Combina payload + extracted + state + catalog + defaults.
+ * Não dispara eventos, não escreve em CommerceState, não conhece DOM/Transport.
+ *
+ * Prioridade de merge por campo:
+ * manual payload > extractedProduct > commerce state > catalog > defaults
+ */
+declare class CommerceResolver {
+    private readonly catalog;
+    private readonly state;
+    private readonly calculator;
+    private readonly defaultCurrency?;
+    private readonly calculateValueFrom;
+    constructor(options: CommerceResolverOptions);
+    resolve(input: CommerceResolverInput): CommerceResolverResult;
+    private resolveAddToCart;
+    /**
+     * Escolhe o item principal do cart runtime:
+     * 1. único item → esse
+     * 2. múltiplos → preferir catalog.type === 'main'
+     * 3. senão → primeiro do cart
+     * 4. cart vazio → null
+     */
+    private resolvePrimaryCartItem;
+    private resolveRemoveFromCart;
+    private resolveCheckoutLike;
+    private resolveViewContent;
+    /**
+     * null = payload não trouxe items (usar state conforme calculateValueFrom)
+     * [] = payload trouxe items vazios
+     */
+    private readPayloadItems;
+    private resolveItemsSource;
+    private enrichItem;
+    private toPixelItem;
+    private normalizeLooseItem;
+    private lookupIdBySku;
+    private lookupProductBySku;
+}
+
+type CommerceEnrichmentEvent = 'pageView' | 'viewContent' | 'lead' | 'addToCart' | 'removeFromCart' | 'initiateCheckout' | 'addPaymentInfo' | 'purchase';
+type PageViewCommercePayload = {
+    readonly value?: number;
+    readonly currency?: string;
+    readonly items?: PixelItem[];
+    readonly contentId?: string;
+    readonly contentName?: string;
+};
+/**
+ * Serviço compartilhado de commerce (root config).
+ * Usado por Core (PAGE_VIEW) e Conversion sem dependência circular
+ * entre os módulos.
+ */
+declare class CommerceService {
+    readonly enabled: boolean;
+    readonly config: CommerceConfig;
+    readonly catalog: ProductCatalog;
+    readonly state: CommerceState;
+    private readonly resolver;
+    constructor(config: CommerceConfig | undefined);
+    getEnrichment(event: CommerceEnrichmentEvent): CommerceEventEnrichmentConfig;
+    isEnabled(): boolean;
+    isEnrichmentEnabled(event: CommerceEnrichmentEvent): boolean;
+    getEnrichmentSource(event: CommerceEnrichmentEvent): CommerceEnrichmentSource;
+    /**
+     * Resolve payload de commerce para um evento conversion.
+     * Retorna null quando enrichment está desabilitado (caller usa payload original).
+     */
+    resolveForEvent(event: CommerceEnrichmentEvent, eventType: 'ADD_TO_CART' | 'REMOVE_FROM_CART' | 'INITIATE_CHECKOUT' | 'PURCHASE' | 'VIEW_CONTENT' | 'ADD_PAYMENT_INFO', payload?: Record<string, unknown>): Record<string, unknown> | null;
+    /**
+     * Payload de commerce para PAGE_VIEW quando enrichment.pageView.enabled.
+     * Não depende de ConversionEngine.
+     */
+    resolvePageViewEnrichment(): PageViewCommercePayload | null;
+    getResolver(): CommerceResolver;
+    getCalculateValueFrom(): ReturnType<typeof normalizeCalculateValueFrom>;
+    getMappings(): CommerceMappingsConfig | undefined;
+}
+
+interface FingerprintService {
+    getFingerprint(): string | null;
+    ensureFingerprint(): string;
+}
+
+interface SessionData {
+    readonly sessionId: string;
+    readonly lastActivityAt: number;
+    readonly createdAt: number;
+}
+type EnsureSessionResult = {
+    readonly sessionId: string;
+    readonly expired: boolean;
+    readonly previousSessionId?: string;
+    readonly created: boolean;
+};
+interface SessionService {
+    getSessionId(): string | null;
+    getSessionData(): SessionData | null;
+    getLastActivityAt(): number | null;
+    isExpired(ttlMs: number): boolean;
+    ensureSession(ttlMs: number): EnsureSessionResult;
+    ensureSessionId(): string;
+    touchActivity(): void;
+    renew(): string;
+    clear(): void;
+}
+
+interface VisitorService {
+    getVisitorId(): string | null;
+    ensureVisitorId(): string;
+    clearVisitorId(): void;
+}
+
+type PixelRuntimeServices = {
+    readonly storage: StorageService;
+    readonly visitor: VisitorService;
+    readonly session: SessionService;
+    readonly fingerprint: FingerprintService;
+    readonly dispatcher: DispatcherService;
+    readonly browserMetadata: BrowserMetadataService;
+    readonly eventBuilder: BaseEventBuilder;
+    readonly attribution: AttributionService;
+    readonly commerce: CommerceService;
+    readonly urlContext: UrlContextService;
+};
+
+export { CommerceResolver as C, type DispatcherService as D, type EnsureSessionResult as E, type FingerprintService as F, OrderCalculator as O, type PixelRuntimeServices as P, type ResolvedCommerceItem as R, type SessionService as S, type VisitorService as V, type SessionData as a, CommerceService as b, CommerceState as c, ProductCatalog as d, type CommerceEnrichmentEvent as e, type CommerceEventType as f, type CommerceResolverInput as g, type CommerceResolverOptions as h, type CommerceResolverResult as i, type CommerceStateOptions as j, type CommerceStateSnapshot as k, type ExtractedProductInput as l, type OrderCalculationInput as m, type OrderCalculationResult as n, type PageViewCommercePayload as o, type ProductCatalogOptions as p, type ProductCatalogSnapshot as q };

package/dist/types-Dfi9C49l.d.ts

@@ -0,0 +1,19 @@
+import { P as PixelConfig } from './pixel-DNGbAN5C.js';
+import { P as PixelLogger } from './PixelLogger-B21lEjep.js';
+import { P as PixelRuntimeServices } from './types-D3kJ9bfT.js';
+
+type PixelRuntimeContext = {
+    readonly config: PixelConfig;
+    readonly logger: PixelLogger;
+    readonly services: PixelRuntimeServices;
+};
+
+type ModuleName = 'privacy' | 'core' | 'behavior' | 'conversion' | 'transport' | 'integrations' | 'diagnostics';
+
+interface PixelModule {
+    readonly name: ModuleName;
+    init(context: PixelRuntimeContext): void | Promise<void>;
+    destroy?(): void | Promise<void>;
+}
+
+export type { ModuleName as M, PixelModule as P, PixelRuntimeContext as a };

package/dist/url-context-Ck2LK18V.d.mts

@@ -0,0 +1,87 @@
+/**
+ * Contratos de Core UrlContext — captura, gestão e propagação de params de URL.
+ * `sid` público ≠ `session_id` interno do Pixel.
+ */
+type UrlContextMode = 'allowlist' | 'all_except';
+type UrlContextSource = 'url' | 'cookie' | 'storage' | 'generated'
+/** Valor definido após o init via API pública (ex.: oid no checkout). */
+ | 'manual';
+type UrlContextWriteStrategy = 'replaceState' | 'none';
+type UrlContextLinkDecorationStrategy = 'on_click' | 'on_init' | 'both';
+type UrlManagedParamMode = 'read_only' | 'write_only' | 'read_write';
+type UrlQueryParamsConfig = {
+    enabled?: boolean;
+    mode?: UrlContextMode;
+    allowlist?: string[];
+    denylist?: string[];
+    mergeDefaultDenylist?: boolean;
+};
+type UrlManagedParamGeneratorConfig = {
+    type: 'public_id';
+    prefix?: string;
+};
+type UrlManagedParamCookieConfig = {
+    enabled?: boolean;
+    name?: string;
+    domain?: 'auto' | string;
+    path?: string;
+    sameSite?: 'Lax' | 'Strict' | 'None';
+    secure?: boolean;
+    maxAgeMs?: number;
+};
+type UrlManagedParamPersistenceConfig = {
+    enabled?: boolean;
+    strategy?: 'storage' | 'cookie' | 'localStorage_cookie';
+    storageKey?: string;
+    cookie?: UrlManagedParamCookieConfig;
+};
+type UrlManagedParamConfig = {
+    key: string;
+    param: string;
+    mode?: UrlManagedParamMode;
+    writeStrategy?: UrlContextWriteStrategy;
+    generator?: UrlManagedParamGeneratorConfig;
+    persistence?: UrlManagedParamPersistenceConfig;
+    decorateLinks?: boolean;
+};
+type UrlForwardParamsConfig = {
+    enabled?: boolean;
+    mode?: UrlContextMode;
+    allowlist?: string[];
+    denylist?: string[];
+    mergeDefaultDenylist?: boolean;
+};
+type UrlLinkDecorationConfig = {
+    enabled?: boolean;
+    strategy?: UrlContextLinkDecorationStrategy;
+    selector?: string;
+    allowedDomains?: '*' | string[];
+    excludedDomains?: string[];
+    mergeDefaultExcludedDomains?: boolean;
+    excludeSelectors?: string[];
+    mergeDefaultExcludeSelectors?: boolean;
+    preserveExisting?: boolean;
+    overwriteExisting?: boolean;
+    decorateHashLinks?: boolean;
+    decorateMailto?: boolean;
+    decorateTel?: boolean;
+};
+type UrlContextConfig = {
+    enabled?: boolean;
+    queryParams?: UrlQueryParamsConfig;
+    managedParams?: UrlManagedParamConfig[];
+    forwardParams?: UrlForwardParamsConfig;
+    linkDecoration?: UrlLinkDecorationConfig;
+};
+/** Payload interno (camelCase) anexado pelo EventBuilder. */
+type UrlContextPayload = {
+    managed?: Record<string, string>;
+    forwarded?: Record<string, string>;
+    source?: Record<string, UrlContextSource>;
+};
+type UrlContextSnapshot = {
+    queryParams: Record<string, string>;
+    urlContext: UrlContextPayload;
+};
+
+export type { UrlContextConfig as U, UrlContextSnapshot as a, UrlContextLinkDecorationStrategy as b, UrlContextMode as c, UrlContextPayload as d, UrlContextSource as e, UrlContextWriteStrategy as f, UrlForwardParamsConfig as g, UrlLinkDecorationConfig as h, UrlManagedParamConfig as i, UrlManagedParamMode as j, UrlQueryParamsConfig as k };