@beworke/pixel-bemony 0.1.0-rc.1

package/dist/browser/index.d.mts

@@ -0,0 +1,184 @@
+import { f as CreateBemonyPixelOptions, h as BemonyPixel, F as BemonyEnvironment, a as BemonyScenario, I as BemonyPlatformOptions } from '../createBemonyPixel-BGRD66p-.mjs';
+import '@beworke/pixel';
+import '@beworke/pixel/events';
+
+type BootstrapBemonyPixelOptions = CreateBemonyPixelOptions & {
+    /**
+     * Destrói a instância atual (se houver) e cria outra.
+     * Útil para HMR / reinit controlado.
+     */
+    force?: boolean;
+    /**
+     * Gate de consentimento. Se retornar `false`, o bootstrap aborta.
+     */
+    waitForConsent?: () => boolean | Promise<boolean>;
+};
+/**
+ * Bootstrap explícito: uma instância por `window`.
+ * SSR-safe no sentido de falhar com erro claro fora do browser.
+ */
+declare function bootstrapBemonyPixel(options: BootstrapBemonyPixelOptions): Promise<BemonyPixel>;
+declare function getBootstrappedBemonyPixel(): BemonyPixel | null;
+/**
+ * Promise pendente do bootstrap atual (se houver).
+ */
+declare function getBootstrappedBemonyPixelPending(): Promise<BemonyPixel> | null;
+/**
+ * Destroi a instância bootstrapada (se existir) e limpa o store da window.
+ */
+declare function destroyBootstrappedBemonyPixel(): Promise<void>;
+
+/**
+ * Config global opcional (`window.BemonyPixelConfig`).
+ * Apenas campos públicos — sem token efêmero.
+ * Campos omitidos herdam `BEMONY_BROWSER_AUTO_INIT_DEFAULTS`.
+ */
+type BemonyPixelGlobalConfig = {
+    environment?: BemonyEnvironment;
+    scenario?: BemonyScenario;
+    /** Parcial — campos omitidos herdam defaults oficiais. */
+    platform?: Partial<BemonyPlatformOptions>;
+    page?: CreateBemonyPixelOptions['page'];
+    commerce?: CreateBemonyPixelOptions['commerce'];
+    overrides?: CreateBemonyPixelOptions['overrides'];
+    autoInitiateCheckout?: boolean;
+    /** URL de “No Thanks” (upsell/downsell). */
+    noThanksUrl?: string;
+};
+/**
+ * Fontes de configuração do auto-init.
+ * Precedência (menor → maior): default → window-config → data-attributes → explicit.
+ */
+type BemonyConfigSource = 'default' | 'window-config' | 'data-attributes' | 'explicit' | 'merged';
+/** Atributos que nunca podem aparecer em data-* (token / segredos). */
+declare const BEMONY_FORBIDDEN_DATA_ATTRIBUTES: readonly string[];
+declare const SCRIPT_SELECTOR = "script[data-bemony-pixel]";
+/**
+ * Parse de boolean em data-*.
+ * Aceita: true/false/1/0 e atributo vazio (= true) quando aplicável.
+ */
+declare function parseBooleanAttr(value: string | null): boolean | undefined;
+/**
+ * Interpreta `data-auto-init` no entry global.
+ * Ausência do atributo → true (auto-init por padrão).
+ */
+declare function isAutoInitEnabledFromAttr(value: string | null | undefined): boolean;
+/**
+ * Merge campo a campo — nunca apaga irmãos de objetos aninhados.
+ * Strings vazias não apagam defaults obrigatórios.
+ */
+declare function mergeBemonyPixelOptions(base: CreateBemonyPixelOptions, overlay: Partial<CreateBemonyPixelOptions> | BemonyPixelGlobalConfig): CreateBemonyPixelOptions;
+/**
+ * Lê overrides públicos de um elemento script (campos parciais).
+ * Não exige environment/scenario — ausentes usam defaults no merge.
+ */
+declare function parseBemonyScriptAttributes(el: Element): Partial<CreateBemonyPixelOptions>;
+type ResolveAutoInitConfigResult = {
+    options: CreateBemonyPixelOptions;
+    source: BemonyConfigSource;
+    /** Fontes que participaram do merge (menor → maior prioridade). */
+    sources: readonly BemonyConfigSource[];
+    script: Element | null;
+};
+type ResolveAutoInitConfigInput = {
+    /** Config explícita (maior precedência). */
+    config?: CreateBemonyPixelOptions;
+    /** Documento / raiz para buscar scripts (default: document). */
+    root?: ParentNode;
+    /**
+     * Script já resolvido (ex.: pelo entry global).
+     * Se omitido, tenta `resolveBemonyExecutingScript`.
+     */
+    script?: HTMLScriptElement | null;
+    /**
+     * Quando true, aplica defaults browser mesmo sem fonte.
+     * Default: true (auto-init com defaults oficiais).
+     */
+    applyDefaults?: boolean;
+};
+/**
+ * Resolve opções com defaults + merge campo a campo.
+ *
+ * Precedência (menor → maior):
+ * 1. BEMONY_BROWSER_AUTO_INIT_DEFAULTS
+ * 2. window.BemonyPixelConfig
+ * 3. atributos data-* do script executado
+ * 4. config explícita
+ */
+declare function resolveAutoInitConfig(input?: ResolveAutoInitConfigInput): ResolveAutoInitConfigResult | null;
+
+type InstallBemonyPixelAutoInitOptions = {
+    /**
+     * Config explícita (maior precedência no merge).
+     */
+    config?: CreateBemonyPixelOptions;
+    root?: ParentNode;
+    /**
+     * Script já resolvido (entry global). Se omitido, resolve automaticamente.
+     */
+    script?: HTMLScriptElement | null;
+    /**
+     * Gate de consentimento. Se retornar `false`, lança CONSENT_DENIED.
+     */
+    waitForConsent?: () => boolean | Promise<boolean>;
+    /**
+     * Reinit controlado (HMR).
+     */
+    force?: boolean;
+    /**
+     * Se true, não aplica defaults browser e retorna null sem fonte.
+     * Default: false — auto-init usa `BEMONY_BROWSER_AUTO_INIT_DEFAULTS`.
+     */
+    applyDefaults?: boolean;
+    /**
+     * @deprecated Preferir opt-out via `data-auto-init="false"` no entry global.
+     * Mantido por compatibilidade.
+     */
+    requireDataAutoInit?: boolean;
+};
+type InstallBemonyPixelAutoInitResult = {
+    pixel: BemonyPixel;
+    source: BemonyConfigSource;
+};
+/**
+ * Instalação do auto-init.
+ * No entry principal ESM não roda sozinha — só quando chamada (ou via IIFE global).
+ */
+declare function installBemonyPixelAutoInit(options?: InstallBemonyPixelAutoInitOptions): Promise<InstallBemonyPixelAutoInitResult | null>;
+
+/** Nome do arquivo do bundle IIFE global. */
+declare const BEMONY_GLOBAL_BUNDLE_FILENAME: "pixel-bemony.global.js";
+type ResolveBemonyExecutingScriptInput = {
+    /** Override de `document.currentScript` (testes). */
+    currentScript?: HTMLScriptElement | SVGScriptElement | null;
+    /** Documento / raiz para fallbacks (default: `document`). */
+    root?: ParentNode;
+};
+/**
+ * Verifica se o `src` do script aponta para o bundle global Bemony.
+ * Suporta URL absoluta, relativa, query string e hash.
+ */
+declare function isBemonyGlobalBundleSrc(src: string | null | undefined): boolean;
+/**
+ * Localiza o `<script>` que está executando o bundle Bemony.
+ *
+ * Prioridade:
+ * 1. `document.currentScript` (HTMLScriptElement)
+ * 2. fallback por `src` contendo `pixel-bemony.global.js`
+ * 3. legado `script[data-bemony-pixel]`
+ */
+declare function resolveBemonyExecutingScript(input?: ResolveBemonyExecutingScriptInput): HTMLScriptElement | null;
+
+type BemonyBootstrapErrorCode = 'NOT_BROWSER' | 'CONSENT_DENIED' | 'INVALID_ATTRIBUTES' | 'FORBIDDEN_ATTRIBUTE' | 'MULTIPLE_SCRIPTS' | 'AMBIGUOUS_SCRIPT' | 'SCRIPT_NOT_FOUND' | 'MISSING_CONFIG' | 'INVALID_CONFIG' | 'AUTO_INIT_DISABLED' | 'AUTO_INIT_FAILED' | 'MISSING_ENDPOINT';
+declare class BemonyBootstrapError extends Error {
+    readonly code: BemonyBootstrapErrorCode;
+    readonly cause?: unknown;
+    constructor(message: string, code: BemonyBootstrapErrorCode, cause?: unknown);
+}
+
+declare const BEMONY_PIXEL_READY_EVENT: "bemony:pixel:ready";
+declare const BEMONY_PIXEL_ERROR_EVENT: "bemony:pixel:error";
+declare const BEMONY_PIXEL_INITIALIZING_EVENT: "bemony:pixel:initializing";
+declare const BEMONY_PIXEL_DESTROYED_EVENT: "bemony:pixel:destroyed";
+
+export { BEMONY_FORBIDDEN_DATA_ATTRIBUTES, BEMONY_GLOBAL_BUNDLE_FILENAME, BEMONY_PIXEL_DESTROYED_EVENT, BEMONY_PIXEL_ERROR_EVENT, BEMONY_PIXEL_INITIALIZING_EVENT, BEMONY_PIXEL_READY_EVENT, SCRIPT_SELECTOR as BEMONY_PIXEL_SCRIPT_SELECTOR, BemonyBootstrapError, type BemonyBootstrapErrorCode, type BemonyConfigSource, type BemonyPixelGlobalConfig, type BootstrapBemonyPixelOptions, type InstallBemonyPixelAutoInitOptions, type InstallBemonyPixelAutoInitResult, type ResolveAutoInitConfigInput, type ResolveAutoInitConfigResult, type ResolveBemonyExecutingScriptInput, bootstrapBemonyPixel, destroyBootstrappedBemonyPixel, getBootstrappedBemonyPixel, getBootstrappedBemonyPixelPending, installBemonyPixelAutoInit, isAutoInitEnabledFromAttr, isBemonyGlobalBundleSrc, mergeBemonyPixelOptions, parseBemonyScriptAttributes, parseBooleanAttr, resolveAutoInitConfig, resolveBemonyExecutingScript };

package/dist/browser/index.d.ts

@@ -0,0 +1,184 @@
+import { f as CreateBemonyPixelOptions, h as BemonyPixel, F as BemonyEnvironment, a as BemonyScenario, I as BemonyPlatformOptions } from '../createBemonyPixel-BGRD66p-.js';
+import '@beworke/pixel';
+import '@beworke/pixel/events';
+
+type BootstrapBemonyPixelOptions = CreateBemonyPixelOptions & {
+    /**
+     * Destrói a instância atual (se houver) e cria outra.
+     * Útil para HMR / reinit controlado.
+     */
+    force?: boolean;
+    /**
+     * Gate de consentimento. Se retornar `false`, o bootstrap aborta.
+     */
+    waitForConsent?: () => boolean | Promise<boolean>;
+};
+/**
+ * Bootstrap explícito: uma instância por `window`.
+ * SSR-safe no sentido de falhar com erro claro fora do browser.
+ */
+declare function bootstrapBemonyPixel(options: BootstrapBemonyPixelOptions): Promise<BemonyPixel>;
+declare function getBootstrappedBemonyPixel(): BemonyPixel | null;
+/**
+ * Promise pendente do bootstrap atual (se houver).
+ */
+declare function getBootstrappedBemonyPixelPending(): Promise<BemonyPixel> | null;
+/**
+ * Destroi a instância bootstrapada (se existir) e limpa o store da window.
+ */
+declare function destroyBootstrappedBemonyPixel(): Promise<void>;
+
+/**
+ * Config global opcional (`window.BemonyPixelConfig`).
+ * Apenas campos públicos — sem token efêmero.
+ * Campos omitidos herdam `BEMONY_BROWSER_AUTO_INIT_DEFAULTS`.
+ */
+type BemonyPixelGlobalConfig = {
+    environment?: BemonyEnvironment;
+    scenario?: BemonyScenario;
+    /** Parcial — campos omitidos herdam defaults oficiais. */
+    platform?: Partial<BemonyPlatformOptions>;
+    page?: CreateBemonyPixelOptions['page'];
+    commerce?: CreateBemonyPixelOptions['commerce'];
+    overrides?: CreateBemonyPixelOptions['overrides'];
+    autoInitiateCheckout?: boolean;
+    /** URL de “No Thanks” (upsell/downsell). */
+    noThanksUrl?: string;
+};
+/**
+ * Fontes de configuração do auto-init.
+ * Precedência (menor → maior): default → window-config → data-attributes → explicit.
+ */
+type BemonyConfigSource = 'default' | 'window-config' | 'data-attributes' | 'explicit' | 'merged';
+/** Atributos que nunca podem aparecer em data-* (token / segredos). */
+declare const BEMONY_FORBIDDEN_DATA_ATTRIBUTES: readonly string[];
+declare const SCRIPT_SELECTOR = "script[data-bemony-pixel]";
+/**
+ * Parse de boolean em data-*.
+ * Aceita: true/false/1/0 e atributo vazio (= true) quando aplicável.
+ */
+declare function parseBooleanAttr(value: string | null): boolean | undefined;
+/**
+ * Interpreta `data-auto-init` no entry global.
+ * Ausência do atributo → true (auto-init por padrão).
+ */
+declare function isAutoInitEnabledFromAttr(value: string | null | undefined): boolean;
+/**
+ * Merge campo a campo — nunca apaga irmãos de objetos aninhados.
+ * Strings vazias não apagam defaults obrigatórios.
+ */
+declare function mergeBemonyPixelOptions(base: CreateBemonyPixelOptions, overlay: Partial<CreateBemonyPixelOptions> | BemonyPixelGlobalConfig): CreateBemonyPixelOptions;
+/**
+ * Lê overrides públicos de um elemento script (campos parciais).
+ * Não exige environment/scenario — ausentes usam defaults no merge.
+ */
+declare function parseBemonyScriptAttributes(el: Element): Partial<CreateBemonyPixelOptions>;
+type ResolveAutoInitConfigResult = {
+    options: CreateBemonyPixelOptions;
+    source: BemonyConfigSource;
+    /** Fontes que participaram do merge (menor → maior prioridade). */
+    sources: readonly BemonyConfigSource[];
+    script: Element | null;
+};
+type ResolveAutoInitConfigInput = {
+    /** Config explícita (maior precedência). */
+    config?: CreateBemonyPixelOptions;
+    /** Documento / raiz para buscar scripts (default: document). */
+    root?: ParentNode;
+    /**
+     * Script já resolvido (ex.: pelo entry global).
+     * Se omitido, tenta `resolveBemonyExecutingScript`.
+     */
+    script?: HTMLScriptElement | null;
+    /**
+     * Quando true, aplica defaults browser mesmo sem fonte.
+     * Default: true (auto-init com defaults oficiais).
+     */
+    applyDefaults?: boolean;
+};
+/**
+ * Resolve opções com defaults + merge campo a campo.
+ *
+ * Precedência (menor → maior):
+ * 1. BEMONY_BROWSER_AUTO_INIT_DEFAULTS
+ * 2. window.BemonyPixelConfig
+ * 3. atributos data-* do script executado
+ * 4. config explícita
+ */
+declare function resolveAutoInitConfig(input?: ResolveAutoInitConfigInput): ResolveAutoInitConfigResult | null;
+
+type InstallBemonyPixelAutoInitOptions = {
+    /**
+     * Config explícita (maior precedência no merge).
+     */
+    config?: CreateBemonyPixelOptions;
+    root?: ParentNode;
+    /**
+     * Script já resolvido (entry global). Se omitido, resolve automaticamente.
+     */
+    script?: HTMLScriptElement | null;
+    /**
+     * Gate de consentimento. Se retornar `false`, lança CONSENT_DENIED.
+     */
+    waitForConsent?: () => boolean | Promise<boolean>;
+    /**
+     * Reinit controlado (HMR).
+     */
+    force?: boolean;
+    /**
+     * Se true, não aplica defaults browser e retorna null sem fonte.
+     * Default: false — auto-init usa `BEMONY_BROWSER_AUTO_INIT_DEFAULTS`.
+     */
+    applyDefaults?: boolean;
+    /**
+     * @deprecated Preferir opt-out via `data-auto-init="false"` no entry global.
+     * Mantido por compatibilidade.
+     */
+    requireDataAutoInit?: boolean;
+};
+type InstallBemonyPixelAutoInitResult = {
+    pixel: BemonyPixel;
+    source: BemonyConfigSource;
+};
+/**
+ * Instalação do auto-init.
+ * No entry principal ESM não roda sozinha — só quando chamada (ou via IIFE global).
+ */
+declare function installBemonyPixelAutoInit(options?: InstallBemonyPixelAutoInitOptions): Promise<InstallBemonyPixelAutoInitResult | null>;
+
+/** Nome do arquivo do bundle IIFE global. */
+declare const BEMONY_GLOBAL_BUNDLE_FILENAME: "pixel-bemony.global.js";
+type ResolveBemonyExecutingScriptInput = {
+    /** Override de `document.currentScript` (testes). */
+    currentScript?: HTMLScriptElement | SVGScriptElement | null;
+    /** Documento / raiz para fallbacks (default: `document`). */
+    root?: ParentNode;
+};
+/**
+ * Verifica se o `src` do script aponta para o bundle global Bemony.
+ * Suporta URL absoluta, relativa, query string e hash.
+ */
+declare function isBemonyGlobalBundleSrc(src: string | null | undefined): boolean;
+/**
+ * Localiza o `<script>` que está executando o bundle Bemony.
+ *
+ * Prioridade:
+ * 1. `document.currentScript` (HTMLScriptElement)
+ * 2. fallback por `src` contendo `pixel-bemony.global.js`
+ * 3. legado `script[data-bemony-pixel]`
+ */
+declare function resolveBemonyExecutingScript(input?: ResolveBemonyExecutingScriptInput): HTMLScriptElement | null;
+
+type BemonyBootstrapErrorCode = 'NOT_BROWSER' | 'CONSENT_DENIED' | 'INVALID_ATTRIBUTES' | 'FORBIDDEN_ATTRIBUTE' | 'MULTIPLE_SCRIPTS' | 'AMBIGUOUS_SCRIPT' | 'SCRIPT_NOT_FOUND' | 'MISSING_CONFIG' | 'INVALID_CONFIG' | 'AUTO_INIT_DISABLED' | 'AUTO_INIT_FAILED' | 'MISSING_ENDPOINT';
+declare class BemonyBootstrapError extends Error {
+    readonly code: BemonyBootstrapErrorCode;
+    readonly cause?: unknown;
+    constructor(message: string, code: BemonyBootstrapErrorCode, cause?: unknown);
+}
+
+declare const BEMONY_PIXEL_READY_EVENT: "bemony:pixel:ready";
+declare const BEMONY_PIXEL_ERROR_EVENT: "bemony:pixel:error";
+declare const BEMONY_PIXEL_INITIALIZING_EVENT: "bemony:pixel:initializing";
+declare const BEMONY_PIXEL_DESTROYED_EVENT: "bemony:pixel:destroyed";
+
+export { BEMONY_FORBIDDEN_DATA_ATTRIBUTES, BEMONY_GLOBAL_BUNDLE_FILENAME, BEMONY_PIXEL_DESTROYED_EVENT, BEMONY_PIXEL_ERROR_EVENT, BEMONY_PIXEL_INITIALIZING_EVENT, BEMONY_PIXEL_READY_EVENT, SCRIPT_SELECTOR as BEMONY_PIXEL_SCRIPT_SELECTOR, BemonyBootstrapError, type BemonyBootstrapErrorCode, type BemonyConfigSource, type BemonyPixelGlobalConfig, type BootstrapBemonyPixelOptions, type InstallBemonyPixelAutoInitOptions, type InstallBemonyPixelAutoInitResult, type ResolveAutoInitConfigInput, type ResolveAutoInitConfigResult, type ResolveBemonyExecutingScriptInput, bootstrapBemonyPixel, destroyBootstrappedBemonyPixel, getBootstrappedBemonyPixel, getBootstrappedBemonyPixelPending, installBemonyPixelAutoInit, isAutoInitEnabledFromAttr, isBemonyGlobalBundleSrc, mergeBemonyPixelOptions, parseBemonyScriptAttributes, parseBooleanAttr, resolveAutoInitConfig, resolveBemonyExecutingScript };