@beworke/pixel-bemony 0.1.0-rc.1

package/dist/index.d.mts

@@ -0,0 +1,320 @@
+import { B as BemonyPublicPageContext, a as BemonyScenario } from './createBemonyPixel-BGRD66p-.mjs';
+export { J as BEMONY_BROWSER_AUTO_INIT_DEFAULTS, K as BEMONY_DEFAULT_ALLOWED_DOMAINS, L as BEMONY_DEFAULT_API_ENDPOINT, M as BEMONY_DEFAULT_BROWSER_ENVIRONMENT, N as BEMONY_DEFAULT_BROWSER_SCENARIO, O as BEMONY_DEFAULT_NAMESPACE, P as BEMONY_DEFAULT_PIXEL_ID, G as BEMONY_ENVIRONMENTS, A as BEMONY_PAYMENT_METHODS, Q as BEMONY_PLATFORM_DEFAULTS, m as BEMONY_SCENARIOS, S as BEMONY_STORAGE_PREFIX, E as BemonyCheckoutInput, s as BemonyCommerceIdentityInput, T as BemonyCommerceInput, b as BemonyConfigOverrides, i as BemonyCorePixel, n as BemonyDeclineUpsellOptions, F as BemonyEnvironment, u as BemonyLeadInput, g as BemonyLifecycleError, j as BemonyLifecycleErrorCode, p as BemonyOfferInput, o as BemonyOneClickConfirmationInput, U as BemonyPageContextInput, z as BemonyPaymentMethod, y as BemonyPaymentMethodInput, h as BemonyPixel, k as BemonyPixelConstructOptions, e as BemonyPixelOptions, l as BemonyPixelState, I as BemonyPlatformOptions, W as BemonyValidationError, V as BemonyValidationErrorCode, C as CreateBemonyPixelConfigOptions, f as CreateBemonyPixelOptions, R as ResolvePriceCodeResult, d as createBemonyPixel, c as createBemonyPixelConfig, X as isBemonyPageContextInput, q as isCompleteBemonyOffer, v as isValidBemonyLead, D as isValidBemonyPaymentMethod, w as leadFingerprint, Y as normalizeBemonyPageContextInput, H as resolveBemonyEnvironment, t as resolvePriceCode, r as resolvePriceCodeFromAcceptElement, x as sanitizeLeadFields } from './createBemonyPixel-BGRD66p-.mjs';
+import { PixelConfig } from '@beworke/pixel';
+import { CommerceCartMode, UrlLinkDecorationConfig, UrlManagedParamConfig, UrlContextConfig, LinkAutoSource } from '@beworke/pixel/config';
+import '@beworke/pixel/events';
+
+type OfferPageCartMode = Extract<CommerceCartMode, 'landing_page' | 'single_product'>;
+type ApplyOfferPageScenarioOptions = {
+    allowedDomains?: readonly string[];
+    currency?: string;
+    cartMode?: OfferPageCartMode;
+    products?: NonNullable<PixelConfig['commerce']['catalog']>['products'];
+};
+/**
+ * Preset do cenário `offer-page` (domínio do cliente / VSL).
+ *
+ * - target `landing`
+ * - commerce `landing_page` | `single_product`
+ * - PAGE_VIEW pelo Core
+ * - conversion manual: viewContent + addToCart
+ * - UrlContext (sid + afid) por allowedDomains
+ * - LinkAutoSource: ADD_TO_CART em segmentos `pri*` sem data attributes
+ */
+declare function applyOfferPageScenario(base: PixelConfig, options?: ApplyOfferPageScenarioOptions): PixelConfig;
+
+type ApplyCheckoutScenarioOptions = {
+    allowedDomains?: readonly string[];
+    currency?: string;
+    products?: NonNullable<PixelConfig['commerce']['catalog']>['products'];
+    /**
+     * Quando false, não registra o detector lifecycle de INITIATE_CHECKOUT.
+     * O wrapper também respeita a mesma flag em `maybeAutoInitiateCheckout`.
+     * Default: true.
+     */
+    autoInitiateCheckout?: boolean;
+    /**
+     * Quando false, não inclui o managed param `oid`. Default: true.
+     */
+    includeOidManagedParam?: boolean;
+};
+/**
+ * Preset do cenário `checkout` (domínio Bemony).
+ *
+ * - target `checkout`
+ * - commerce mode `checkout`
+ * - PAGE_VIEW pelo Core
+ * - INITIATE_CHECKOUT via wrapper (auto pós-init, idempotente)
+ * - manual: lead, addToCart, removeFromCart, addPaymentInfo
+ * - purchase manual desabilitado (browser não emite purchase)
+ */
+declare function applyCheckoutScenario(base: PixelConfig, options?: ApplyCheckoutScenarioOptions): PixelConfig;
+
+/** Base: buy `/pri*` + offer-page legado. No-thanks entra via `buildUpsellLinkSelector`. */
+declare const BEMONY_UPSELL_BUY_LINK_SELECTOR = "a[href*=\"pri\"], [data-bemony-offer][href]";
+/**
+ * Selector estático sem no-thanks (compat / testes sem URL).
+ * Preferir `buildUpsellLinkSelector(noThanksUrl)` quando `data-no-thanks` existir no script.
+ */
+declare const BEMONY_UPSELL_LINK_SELECTOR = "a[href*=\"pri\"], [data-bemony-offer][href]";
+/**
+ * Política de decoração upsell/downsell.
+ * - buy: `href` com `pri*`
+ * - no-thanks: âncora cujo `href` coincide com `data-no-thanks` do script
+ */
+declare function buildUpsellLinkSelector(noThanksUrl?: string): string;
+/**
+ * Compara href do link com a URL do script (`data-no-thanks`),
+ * resolvendo relativos contra a página atual.
+ */
+declare function hrefMatchesNoThanksUrl(href: string | null | undefined, noThanksUrl: string, baseHref?: string): boolean;
+type ApplyUpsellOfferScenarioOptions = {
+    allowedDomains?: readonly string[];
+    currency?: string;
+    products?: NonNullable<PixelConfig['commerce']['catalog']>['products'];
+    includeOidManagedParam?: boolean;
+    /** URL de recusa (`data-no-thanks` no script) — entra no selector de decoração. */
+    noThanksUrl?: string;
+};
+/**
+ * Preset do cenário `upsell-offer` (domínio do cliente, pós-compra).
+ *
+ * - target `custom`
+ * - commerce mode `upsell` (sem catálogo obrigatório; priceCode via URL)
+ * - PAGE_VIEW pelo Core
+ * - conversion: ADD_TO_CART automático em links `/pri*` (mesmo source do offer-page)
+ * - UrlContext decora buy `/pri*` + no-thanks (href = script data-no-thanks)
+ *
+ * GAP: sem evento de decline no Core — `declineUpsell` não emite conversion.
+ */
+declare function applyUpsellOfferScenario(base: PixelConfig, options?: ApplyUpsellOfferScenarioOptions): PixelConfig;
+
+type ApplyOneClickCheckoutScenarioOptions = {
+    allowedDomains?: readonly string[];
+    currency?: string;
+    products?: NonNullable<PixelConfig['commerce']['catalog']>['products'];
+};
+/**
+ * Preset do cenário `one-click-checkout`.
+ *
+ * Tracking apenas: PAGE_VIEW + INITIATE_CHECKOUT.
+ * Pagamento e PURCHASE ficam no backend/app — o Pixel não é SDK de pagamentos.
+ */
+declare function applyOneClickCheckoutScenario(base: PixelConfig, options?: ApplyOneClickCheckoutScenarioOptions): PixelConfig;
+
+type ApplyThankYouScenarioOptions = {
+    allowedDomains?: readonly string[];
+    currency?: string;
+};
+/**
+ * Preset do cenário `thank-you`.
+ *
+ * - target `custom`
+ * - PAGE_VIEW no init (Core)
+ * - sem PURCHASE browser
+ * - sem auto checkout / conversion manual
+ * - contexto público mínimo (pageId; publicOrderId só no domínio do app)
+ */
+declare function applyThankYouScenario(base: PixelConfig, options?: ApplyThankYouScenarioOptions): PixelConfig;
+
+/**
+ * Contratos conceituais backend ↔ Pixel (B7).
+ *
+ * PLACEHOLDER: estes tipos NÃO são o contrato HTTP final da API Bemony.
+ * Devem ser alinhados com a API real antes de uso em produção.
+ * Endpoint browser confirmado no Core: `{apiEndpoint}/pixels/public/event`
+ * (server purchase pode usar canal distinto — confirmar).
+ */
+/** Params públicos seguros para Location de redirect 302. */
+type BemonyPublicRedirectParams = {
+    sid?: string;
+    public_order_id?: string;
+    funnel_id?: string;
+    offer_id?: string;
+    /** UTM / click ids aprovados — não incluir token/PII. */
+    attribution?: Record<string, string>;
+};
+/**
+ * Payload conceitual de PURCHASE server-side.
+ * @deprecated-contract PLACEHOLDER — alinhar com API real.
+ */
+type BemonyServerPurchasePayloadPlaceholder = {
+    type: 'PURCHASE';
+    event_id: string;
+    occurred_at: string;
+    sid?: string;
+    public_order_id?: string;
+    transaction_id?: string;
+    value?: number;
+    currency?: string;
+    items?: ReadonlyArray<{
+        id: string;
+        name?: string;
+        price?: number;
+        quantity?: number;
+        type?: string;
+    }>;
+    attribution?: Record<string, unknown>;
+    page_context?: Record<string, unknown>;
+};
+/** Chave de idempotência one-click (conceitual). */
+type BemonyOneClickIdempotencyKeyPlaceholder = {
+    one_click_token: string;
+    offer_id: string;
+    public_order_id: string;
+};
+type BemonyOneClickBackendResultPlaceholder = {
+    status: 'success';
+    /** Destino seguro pós-compra (thank-you / próxima etapa). */
+    redirectTo: string;
+    /** event_id do PURCHASE server, se aplicável. */
+    purchaseEventId?: string;
+} | {
+    status: 'failure';
+    /** Mensagem sanitizada para o app — sem token/PAN. */
+    errorCode: string;
+    retryable?: boolean;
+};
+/**
+ * Dedupe futuro browser+server (fora da V1).
+ * PLACEHOLDER: exige evolução contratual compartilhando event_id.
+ */
+type BemonyBrowserServerDedupePlaceholder = {
+    sharedEventId: string;
+    source: 'browser' | 'server';
+};
+
+/**
+ * Valida o formato conceitual do payload de PURCHASE server-side.
+ * PLACEHOLDER — não afirma compatibilidade com a API HTTP final.
+ */
+declare function validateBemonyServerPurchasePlaceholder(payload: unknown): BemonyServerPurchasePayloadPlaceholder;
+/**
+ * Garante que params de redirect 302 não incluem segredos.
+ */
+declare function assertSafePublicRedirectParams(params: BemonyPublicRedirectParams): BemonyPublicRedirectParams;
+/**
+ * Monta query string pública para Location (conceitual).
+ * Não inventa host/path — só serializa params já aprovados.
+ */
+declare function buildPublicRedirectQuery(params: BemonyPublicRedirectParams): string;
+
+type ResolveBemonyPageContextSources = {
+    /** Precedência 1 — input explícito do app. */
+    input?: BemonyPublicPageContext;
+    /** Precedência 2 — params públicos já filtrados da URL. */
+    urlParams?: Readonly<Record<string, string>>;
+    /** Precedência 3 — metadata declarativa da página. */
+    pageMetadata?: BemonyPublicPageContext;
+    /** Precedência 4 — defaults do cenário. */
+    scenarioDefaults?: BemonyPublicPageContext;
+};
+/**
+ * Resolve contexto público com precedência:
+ * input explícito → URL permitida → metadata da página → default do cenário.
+ *
+ * Não gerencia sid, attribution, storage nem token efêmero.
+ */
+declare function resolveBemonyPageContext(sources?: ResolveBemonyPageContextSources): BemonyPublicPageContext;
+
+/** Campos públicos obrigatórios por cenário (contrato B1). */
+declare const REQUIRED_PUBLIC_FIELDS: Record<BemonyScenario, readonly (keyof BemonyPublicPageContext)[]>;
+type ValidateBemonyPageContextOptions = {
+    scenario: BemonyScenario;
+    publicContext: BemonyPublicPageContext;
+    /** Quando true, aplica trim/charset aos IDs públicos. Default: true. */
+    sanitize?: boolean;
+};
+/**
+ * Valida obrigatoriedade por cenário e rejeita IDs públicos inválidos.
+ */
+declare function validateBemonyPageContext(options: ValidateBemonyPageContextOptions): BemonyPublicPageContext;
+
+/**
+ * Política de decoração de links Bemony.
+ * `allowedDomains` filtra destinos; `selector` opcional restringe quais âncoras.
+ */
+type BemonyLinkPolicy = {
+    /** Domínios aprovados para decoração (`sid`, `afid`, forwards). */
+    allowedDomains: string[];
+    /**
+     * CSS selector de CTAs (ex.: upsell accept/decline).
+     * Sem selector, o Core usa `a[href]` e filtra só por domínio.
+     */
+    selector?: string;
+    strategy: NonNullable<UrlLinkDecorationConfig['strategy']>;
+    preserveExisting: boolean;
+    overwriteExisting: boolean;
+    decorateMailto: boolean;
+    decorateTel: boolean;
+    decorateHashLinks: boolean;
+    mergeDefaultExcludedDomains: boolean;
+    mergeDefaultExcludeSelectors: boolean;
+    excludeSelectors?: string[];
+};
+/** Selector legado de offer-page (export estável). */
+declare const DEFAULT_BEMONY_LINK_SELECTOR = "[data-bemony-offer][href]";
+type CreateBemonyLinkPolicyOptions = {
+    allowedDomains?: readonly string[];
+    /** Restringe decoração a CTAs (ex.: `BEMONY_UPSELL_LINK_SELECTOR`). */
+    selector?: string;
+    strategy?: BemonyLinkPolicy['strategy'];
+    preserveExisting?: boolean;
+    overwriteExisting?: boolean;
+    excludeSelectors?: readonly string[];
+};
+/**
+ * Normaliza domínio: lowercase, sem protocolo/path/query/hash/porta.
+ */
+declare function normalizeAllowedDomain(domain: string): string;
+/**
+ * Normaliza, deduplica e remove entradas vazias.
+ */
+declare function normalizeAllowedDomains(domains: readonly string[]): string[];
+declare function createBemonyLinkPolicy(options?: CreateBemonyLinkPolicyOptions): BemonyLinkPolicy;
+
+/** Managed param oficial do sid público (≠ session_id interno). */
+declare const BEMONY_SID_MANAGED_PARAM: UrlManagedParamConfig;
+/**
+ * Managed param oficial do afiliado (`afid`).
+ * Nunca possui generator — o Pixel não cria afiliado.
+ */
+declare const BEMONY_AFID_MANAGED_PARAM: UrlManagedParamConfig;
+/**
+ * Params que nunca devem ser capturados/encaminhados pelo UrlContext.
+ */
+declare const BEMONY_FORWARD_DENYLIST: readonly string[];
+type ConfigureBemonyLinksOptions = CreateBemonyLinkPolicyOptions & {
+    /** Quando false, não inclui o managed param `sid`. Default: true. */
+    includeSidManagedParam?: boolean;
+    /** Quando false, não inclui o managed param `afid`. Default: true. */
+    includeAfidManagedParam?: boolean;
+    /** Quando false, não inclui o managed param `oid`. Default: true (todos os scenarios). */
+    includeOidManagedParam?: boolean;
+    /** Quando false, não inclui `fid`/`fsid`. Default: true. */
+    includeFunnelManagedParams?: boolean;
+};
+/**
+ * Produz `PixelConfig.modules.core.urlContext` para cenários Bemony.
+ */
+declare function configureBemonyLinks(options?: ConfigureBemonyLinksOptions): UrlContextConfig;
+
+/**
+ * Cria a `LinkAutoSource` oficial de ofertas Bemony.
+ *
+ * - Match por hostname permitido + segmento de path `pri*`
+ * - Extrai `priceCode` do último segmento do path
+ * - Sem catálogo: o Core recebe priceCode via binding; o mapper usa-o como identidade
+ */
+declare function createBemonyOfferLinkSource(allowedDomains: readonly string[]): LinkAutoSource;
+
+/**
+ * Extrai o priceCode público (`pri*`) do pathname de uma URL.
+ *
+ * - Usa somente pathname (ignora query e hash)
+ * - Suporta barra final
+ * - Não faz fetch nem consulta catálogo
+ */
+declare function extractPriceCodeFromUrl(url: string | URL): string | null;
+
+export { BEMONY_AFID_MANAGED_PARAM, BEMONY_FORWARD_DENYLIST, BEMONY_SID_MANAGED_PARAM, BEMONY_UPSELL_BUY_LINK_SELECTOR, BEMONY_UPSELL_LINK_SELECTOR, type BemonyBrowserServerDedupePlaceholder, type BemonyLinkPolicy, type BemonyOneClickBackendResultPlaceholder, type BemonyOneClickIdempotencyKeyPlaceholder, BemonyPublicPageContext, type BemonyPublicRedirectParams, BemonyScenario, type BemonyServerPurchasePayloadPlaceholder, type ConfigureBemonyLinksOptions, DEFAULT_BEMONY_LINK_SELECTOR, type OfferPageCartMode, REQUIRED_PUBLIC_FIELDS, type ResolveBemonyPageContextSources, type ValidateBemonyPageContextOptions, applyCheckoutScenario, applyOfferPageScenario, applyOneClickCheckoutScenario, applyThankYouScenario, applyUpsellOfferScenario, assertSafePublicRedirectParams, buildPublicRedirectQuery, buildUpsellLinkSelector, configureBemonyLinks, createBemonyLinkPolicy, createBemonyOfferLinkSource, extractPriceCodeFromUrl, hrefMatchesNoThanksUrl, normalizeAllowedDomain, normalizeAllowedDomains, resolveBemonyPageContext, validateBemonyPageContext, validateBemonyServerPurchasePlaceholder };

package/dist/index.d.ts

@@ -0,0 +1,320 @@
+import { B as BemonyPublicPageContext, a as BemonyScenario } from './createBemonyPixel-BGRD66p-.js';
+export { J as BEMONY_BROWSER_AUTO_INIT_DEFAULTS, K as BEMONY_DEFAULT_ALLOWED_DOMAINS, L as BEMONY_DEFAULT_API_ENDPOINT, M as BEMONY_DEFAULT_BROWSER_ENVIRONMENT, N as BEMONY_DEFAULT_BROWSER_SCENARIO, O as BEMONY_DEFAULT_NAMESPACE, P as BEMONY_DEFAULT_PIXEL_ID, G as BEMONY_ENVIRONMENTS, A as BEMONY_PAYMENT_METHODS, Q as BEMONY_PLATFORM_DEFAULTS, m as BEMONY_SCENARIOS, S as BEMONY_STORAGE_PREFIX, E as BemonyCheckoutInput, s as BemonyCommerceIdentityInput, T as BemonyCommerceInput, b as BemonyConfigOverrides, i as BemonyCorePixel, n as BemonyDeclineUpsellOptions, F as BemonyEnvironment, u as BemonyLeadInput, g as BemonyLifecycleError, j as BemonyLifecycleErrorCode, p as BemonyOfferInput, o as BemonyOneClickConfirmationInput, U as BemonyPageContextInput, z as BemonyPaymentMethod, y as BemonyPaymentMethodInput, h as BemonyPixel, k as BemonyPixelConstructOptions, e as BemonyPixelOptions, l as BemonyPixelState, I as BemonyPlatformOptions, W as BemonyValidationError, V as BemonyValidationErrorCode, C as CreateBemonyPixelConfigOptions, f as CreateBemonyPixelOptions, R as ResolvePriceCodeResult, d as createBemonyPixel, c as createBemonyPixelConfig, X as isBemonyPageContextInput, q as isCompleteBemonyOffer, v as isValidBemonyLead, D as isValidBemonyPaymentMethod, w as leadFingerprint, Y as normalizeBemonyPageContextInput, H as resolveBemonyEnvironment, t as resolvePriceCode, r as resolvePriceCodeFromAcceptElement, x as sanitizeLeadFields } from './createBemonyPixel-BGRD66p-.js';
+import { PixelConfig } from '@beworke/pixel';
+import { CommerceCartMode, UrlLinkDecorationConfig, UrlManagedParamConfig, UrlContextConfig, LinkAutoSource } from '@beworke/pixel/config';
+import '@beworke/pixel/events';
+
+type OfferPageCartMode = Extract<CommerceCartMode, 'landing_page' | 'single_product'>;
+type ApplyOfferPageScenarioOptions = {
+    allowedDomains?: readonly string[];
+    currency?: string;
+    cartMode?: OfferPageCartMode;
+    products?: NonNullable<PixelConfig['commerce']['catalog']>['products'];
+};
+/**
+ * Preset do cenário `offer-page` (domínio do cliente / VSL).
+ *
+ * - target `landing`
+ * - commerce `landing_page` | `single_product`
+ * - PAGE_VIEW pelo Core
+ * - conversion manual: viewContent + addToCart
+ * - UrlContext (sid + afid) por allowedDomains
+ * - LinkAutoSource: ADD_TO_CART em segmentos `pri*` sem data attributes
+ */
+declare function applyOfferPageScenario(base: PixelConfig, options?: ApplyOfferPageScenarioOptions): PixelConfig;
+
+type ApplyCheckoutScenarioOptions = {
+    allowedDomains?: readonly string[];
+    currency?: string;
+    products?: NonNullable<PixelConfig['commerce']['catalog']>['products'];
+    /**
+     * Quando false, não registra o detector lifecycle de INITIATE_CHECKOUT.
+     * O wrapper também respeita a mesma flag em `maybeAutoInitiateCheckout`.
+     * Default: true.
+     */
+    autoInitiateCheckout?: boolean;
+    /**
+     * Quando false, não inclui o managed param `oid`. Default: true.
+     */
+    includeOidManagedParam?: boolean;
+};
+/**
+ * Preset do cenário `checkout` (domínio Bemony).
+ *
+ * - target `checkout`
+ * - commerce mode `checkout`
+ * - PAGE_VIEW pelo Core
+ * - INITIATE_CHECKOUT via wrapper (auto pós-init, idempotente)
+ * - manual: lead, addToCart, removeFromCart, addPaymentInfo
+ * - purchase manual desabilitado (browser não emite purchase)
+ */
+declare function applyCheckoutScenario(base: PixelConfig, options?: ApplyCheckoutScenarioOptions): PixelConfig;
+
+/** Base: buy `/pri*` + offer-page legado. No-thanks entra via `buildUpsellLinkSelector`. */
+declare const BEMONY_UPSELL_BUY_LINK_SELECTOR = "a[href*=\"pri\"], [data-bemony-offer][href]";
+/**
+ * Selector estático sem no-thanks (compat / testes sem URL).
+ * Preferir `buildUpsellLinkSelector(noThanksUrl)` quando `data-no-thanks` existir no script.
+ */
+declare const BEMONY_UPSELL_LINK_SELECTOR = "a[href*=\"pri\"], [data-bemony-offer][href]";
+/**
+ * Política de decoração upsell/downsell.
+ * - buy: `href` com `pri*`
+ * - no-thanks: âncora cujo `href` coincide com `data-no-thanks` do script
+ */
+declare function buildUpsellLinkSelector(noThanksUrl?: string): string;
+/**
+ * Compara href do link com a URL do script (`data-no-thanks`),
+ * resolvendo relativos contra a página atual.
+ */
+declare function hrefMatchesNoThanksUrl(href: string | null | undefined, noThanksUrl: string, baseHref?: string): boolean;
+type ApplyUpsellOfferScenarioOptions = {
+    allowedDomains?: readonly string[];
+    currency?: string;
+    products?: NonNullable<PixelConfig['commerce']['catalog']>['products'];
+    includeOidManagedParam?: boolean;
+    /** URL de recusa (`data-no-thanks` no script) — entra no selector de decoração. */
+    noThanksUrl?: string;
+};
+/**
+ * Preset do cenário `upsell-offer` (domínio do cliente, pós-compra).
+ *
+ * - target `custom`
+ * - commerce mode `upsell` (sem catálogo obrigatório; priceCode via URL)
+ * - PAGE_VIEW pelo Core
+ * - conversion: ADD_TO_CART automático em links `/pri*` (mesmo source do offer-page)
+ * - UrlContext decora buy `/pri*` + no-thanks (href = script data-no-thanks)
+ *
+ * GAP: sem evento de decline no Core — `declineUpsell` não emite conversion.
+ */
+declare function applyUpsellOfferScenario(base: PixelConfig, options?: ApplyUpsellOfferScenarioOptions): PixelConfig;
+
+type ApplyOneClickCheckoutScenarioOptions = {
+    allowedDomains?: readonly string[];
+    currency?: string;
+    products?: NonNullable<PixelConfig['commerce']['catalog']>['products'];
+};
+/**
+ * Preset do cenário `one-click-checkout`.
+ *
+ * Tracking apenas: PAGE_VIEW + INITIATE_CHECKOUT.
+ * Pagamento e PURCHASE ficam no backend/app — o Pixel não é SDK de pagamentos.
+ */
+declare function applyOneClickCheckoutScenario(base: PixelConfig, options?: ApplyOneClickCheckoutScenarioOptions): PixelConfig;
+
+type ApplyThankYouScenarioOptions = {
+    allowedDomains?: readonly string[];
+    currency?: string;
+};
+/**
+ * Preset do cenário `thank-you`.
+ *
+ * - target `custom`
+ * - PAGE_VIEW no init (Core)
+ * - sem PURCHASE browser
+ * - sem auto checkout / conversion manual
+ * - contexto público mínimo (pageId; publicOrderId só no domínio do app)
+ */
+declare function applyThankYouScenario(base: PixelConfig, options?: ApplyThankYouScenarioOptions): PixelConfig;
+
+/**
+ * Contratos conceituais backend ↔ Pixel (B7).
+ *
+ * PLACEHOLDER: estes tipos NÃO são o contrato HTTP final da API Bemony.
+ * Devem ser alinhados com a API real antes de uso em produção.
+ * Endpoint browser confirmado no Core: `{apiEndpoint}/pixels/public/event`
+ * (server purchase pode usar canal distinto — confirmar).
+ */
+/** Params públicos seguros para Location de redirect 302. */
+type BemonyPublicRedirectParams = {
+    sid?: string;
+    public_order_id?: string;
+    funnel_id?: string;
+    offer_id?: string;
+    /** UTM / click ids aprovados — não incluir token/PII. */
+    attribution?: Record<string, string>;
+};
+/**
+ * Payload conceitual de PURCHASE server-side.
+ * @deprecated-contract PLACEHOLDER — alinhar com API real.
+ */
+type BemonyServerPurchasePayloadPlaceholder = {
+    type: 'PURCHASE';
+    event_id: string;
+    occurred_at: string;
+    sid?: string;
+    public_order_id?: string;
+    transaction_id?: string;
+    value?: number;
+    currency?: string;
+    items?: ReadonlyArray<{
+        id: string;
+        name?: string;
+        price?: number;
+        quantity?: number;
+        type?: string;
+    }>;
+    attribution?: Record<string, unknown>;
+    page_context?: Record<string, unknown>;
+};
+/** Chave de idempotência one-click (conceitual). */
+type BemonyOneClickIdempotencyKeyPlaceholder = {
+    one_click_token: string;
+    offer_id: string;
+    public_order_id: string;
+};
+type BemonyOneClickBackendResultPlaceholder = {
+    status: 'success';
+    /** Destino seguro pós-compra (thank-you / próxima etapa). */
+    redirectTo: string;
+    /** event_id do PURCHASE server, se aplicável. */
+    purchaseEventId?: string;
+} | {
+    status: 'failure';
+    /** Mensagem sanitizada para o app — sem token/PAN. */
+    errorCode: string;
+    retryable?: boolean;
+};
+/**
+ * Dedupe futuro browser+server (fora da V1).
+ * PLACEHOLDER: exige evolução contratual compartilhando event_id.
+ */
+type BemonyBrowserServerDedupePlaceholder = {
+    sharedEventId: string;
+    source: 'browser' | 'server';
+};
+
+/**
+ * Valida o formato conceitual do payload de PURCHASE server-side.
+ * PLACEHOLDER — não afirma compatibilidade com a API HTTP final.
+ */
+declare function validateBemonyServerPurchasePlaceholder(payload: unknown): BemonyServerPurchasePayloadPlaceholder;
+/**
+ * Garante que params de redirect 302 não incluem segredos.
+ */
+declare function assertSafePublicRedirectParams(params: BemonyPublicRedirectParams): BemonyPublicRedirectParams;
+/**
+ * Monta query string pública para Location (conceitual).
+ * Não inventa host/path — só serializa params já aprovados.
+ */
+declare function buildPublicRedirectQuery(params: BemonyPublicRedirectParams): string;
+
+type ResolveBemonyPageContextSources = {
+    /** Precedência 1 — input explícito do app. */
+    input?: BemonyPublicPageContext;
+    /** Precedência 2 — params públicos já filtrados da URL. */
+    urlParams?: Readonly<Record<string, string>>;
+    /** Precedência 3 — metadata declarativa da página. */
+    pageMetadata?: BemonyPublicPageContext;
+    /** Precedência 4 — defaults do cenário. */
+    scenarioDefaults?: BemonyPublicPageContext;
+};
+/**
+ * Resolve contexto público com precedência:
+ * input explícito → URL permitida → metadata da página → default do cenário.
+ *
+ * Não gerencia sid, attribution, storage nem token efêmero.
+ */
+declare function resolveBemonyPageContext(sources?: ResolveBemonyPageContextSources): BemonyPublicPageContext;
+
+/** Campos públicos obrigatórios por cenário (contrato B1). */
+declare const REQUIRED_PUBLIC_FIELDS: Record<BemonyScenario, readonly (keyof BemonyPublicPageContext)[]>;
+type ValidateBemonyPageContextOptions = {
+    scenario: BemonyScenario;
+    publicContext: BemonyPublicPageContext;
+    /** Quando true, aplica trim/charset aos IDs públicos. Default: true. */
+    sanitize?: boolean;
+};
+/**
+ * Valida obrigatoriedade por cenário e rejeita IDs públicos inválidos.
+ */
+declare function validateBemonyPageContext(options: ValidateBemonyPageContextOptions): BemonyPublicPageContext;
+
+/**
+ * Política de decoração de links Bemony.
+ * `allowedDomains` filtra destinos; `selector` opcional restringe quais âncoras.
+ */
+type BemonyLinkPolicy = {
+    /** Domínios aprovados para decoração (`sid`, `afid`, forwards). */
+    allowedDomains: string[];
+    /**
+     * CSS selector de CTAs (ex.: upsell accept/decline).
+     * Sem selector, o Core usa `a[href]` e filtra só por domínio.
+     */
+    selector?: string;
+    strategy: NonNullable<UrlLinkDecorationConfig['strategy']>;
+    preserveExisting: boolean;
+    overwriteExisting: boolean;
+    decorateMailto: boolean;
+    decorateTel: boolean;
+    decorateHashLinks: boolean;
+    mergeDefaultExcludedDomains: boolean;
+    mergeDefaultExcludeSelectors: boolean;
+    excludeSelectors?: string[];
+};
+/** Selector legado de offer-page (export estável). */
+declare const DEFAULT_BEMONY_LINK_SELECTOR = "[data-bemony-offer][href]";
+type CreateBemonyLinkPolicyOptions = {
+    allowedDomains?: readonly string[];
+    /** Restringe decoração a CTAs (ex.: `BEMONY_UPSELL_LINK_SELECTOR`). */
+    selector?: string;
+    strategy?: BemonyLinkPolicy['strategy'];
+    preserveExisting?: boolean;
+    overwriteExisting?: boolean;
+    excludeSelectors?: readonly string[];
+};
+/**
+ * Normaliza domínio: lowercase, sem protocolo/path/query/hash/porta.
+ */
+declare function normalizeAllowedDomain(domain: string): string;
+/**
+ * Normaliza, deduplica e remove entradas vazias.
+ */
+declare function normalizeAllowedDomains(domains: readonly string[]): string[];
+declare function createBemonyLinkPolicy(options?: CreateBemonyLinkPolicyOptions): BemonyLinkPolicy;
+
+/** Managed param oficial do sid público (≠ session_id interno). */
+declare const BEMONY_SID_MANAGED_PARAM: UrlManagedParamConfig;
+/**
+ * Managed param oficial do afiliado (`afid`).
+ * Nunca possui generator — o Pixel não cria afiliado.
+ */
+declare const BEMONY_AFID_MANAGED_PARAM: UrlManagedParamConfig;
+/**
+ * Params que nunca devem ser capturados/encaminhados pelo UrlContext.
+ */
+declare const BEMONY_FORWARD_DENYLIST: readonly string[];
+type ConfigureBemonyLinksOptions = CreateBemonyLinkPolicyOptions & {
+    /** Quando false, não inclui o managed param `sid`. Default: true. */
+    includeSidManagedParam?: boolean;
+    /** Quando false, não inclui o managed param `afid`. Default: true. */
+    includeAfidManagedParam?: boolean;
+    /** Quando false, não inclui o managed param `oid`. Default: true (todos os scenarios). */
+    includeOidManagedParam?: boolean;
+    /** Quando false, não inclui `fid`/`fsid`. Default: true. */
+    includeFunnelManagedParams?: boolean;
+};
+/**
+ * Produz `PixelConfig.modules.core.urlContext` para cenários Bemony.
+ */
+declare function configureBemonyLinks(options?: ConfigureBemonyLinksOptions): UrlContextConfig;
+
+/**
+ * Cria a `LinkAutoSource` oficial de ofertas Bemony.
+ *
+ * - Match por hostname permitido + segmento de path `pri*`
+ * - Extrai `priceCode` do último segmento do path
+ * - Sem catálogo: o Core recebe priceCode via binding; o mapper usa-o como identidade
+ */
+declare function createBemonyOfferLinkSource(allowedDomains: readonly string[]): LinkAutoSource;
+
+/**
+ * Extrai o priceCode público (`pri*`) do pathname de uma URL.
+ *
+ * - Usa somente pathname (ignora query e hash)
+ * - Suporta barra final
+ * - Não faz fetch nem consulta catálogo
+ */
+declare function extractPriceCodeFromUrl(url: string | URL): string | null;
+
+export { BEMONY_AFID_MANAGED_PARAM, BEMONY_FORWARD_DENYLIST, BEMONY_SID_MANAGED_PARAM, BEMONY_UPSELL_BUY_LINK_SELECTOR, BEMONY_UPSELL_LINK_SELECTOR, type BemonyBrowserServerDedupePlaceholder, type BemonyLinkPolicy, type BemonyOneClickBackendResultPlaceholder, type BemonyOneClickIdempotencyKeyPlaceholder, BemonyPublicPageContext, type BemonyPublicRedirectParams, BemonyScenario, type BemonyServerPurchasePayloadPlaceholder, type ConfigureBemonyLinksOptions, DEFAULT_BEMONY_LINK_SELECTOR, type OfferPageCartMode, REQUIRED_PUBLIC_FIELDS, type ResolveBemonyPageContextSources, type ValidateBemonyPageContextOptions, applyCheckoutScenario, applyOfferPageScenario, applyOneClickCheckoutScenario, applyThankYouScenario, applyUpsellOfferScenario, assertSafePublicRedirectParams, buildPublicRedirectQuery, buildUpsellLinkSelector, configureBemonyLinks, createBemonyLinkPolicy, createBemonyOfferLinkSource, extractPriceCodeFromUrl, hrefMatchesNoThanksUrl, normalizeAllowedDomain, normalizeAllowedDomains, resolveBemonyPageContext, validateBemonyPageContext, validateBemonyServerPurchasePlaceholder };