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

package/dist/browser/index.d.mts

@@ -0,0 +1,55 @@
+import { P as PixelSettings } from '../pixel-settings-BhfJqA92.mjs';
+import { P as Pixel } from '../Pixel-CqbgC_72.mjs';
+import { P as PixelConfig } from '../pixel-C93c-0M2.mjs';
+import '../index-BxT2d-TK.mjs';
+import '../url-context-Ck2LK18V.mjs';
+import '../PixelLogger-B21lEjep.mjs';
+import '../types-C2dsBog1.mjs';
+import '../types-C0J9KUQg.mjs';
+
+type BootstrapPixelControls = {
+    /**
+     * Destrói a instância bootstrapada (se houver) e cria outra.
+     * A primeira chamada sem `force` é dona da instância na `window`.
+     */
+    force?: boolean;
+    /**
+     * Gate de consentimento. Executado antes de criar a instância.
+     * Se retornar `false`, o bootstrap aborta com `CONSENT_DENIED`.
+     */
+    waitForConsent?: () => boolean | Promise<boolean>;
+};
+type PixelBrowserFactory = {
+    (settings: PixelSettings): Promise<Pixel>;
+    create(settings: PixelSettings): Promise<Pixel>;
+    bootstrap(settings: PixelSettings, controls?: BootstrapPixelControls): Promise<Pixel>;
+    getInstance(): Pixel | null;
+    getPending(): Promise<Pixel> | null;
+    destroy(): Promise<void>;
+    readonly Client: typeof Pixel;
+    readonly DEFAULT_PIXEL_CONFIG: PixelConfig;
+};
+
+/**
+ * Uma instância por `window`. Sem `force`, a primeira chamada é dona da
+ * configuração; chamadas posteriores reutilizam pending/instância.
+ *
+ * Não é `async`: o retorno é a Promise do store para chamadas concorrentes
+ * compartilharem a mesma referência.
+ *
+ * Para trocar a configuração, use `force: true` ou `destroyBootstrappedPixel()`.
+ * Chamadas concorrentes compartilham a configuração da primeira que iniciou.
+ */
+declare function bootstrapPixel(settings: PixelSettings, controls?: BootstrapPixelControls): Promise<Pixel>;
+declare function getBootstrappedPixel(): Pixel | null;
+declare function getBootstrappedPixelPending(): Promise<Pixel> | null;
+declare function destroyBootstrappedPixel(): Promise<void>;
+
+type PixelBootstrapErrorCode = 'NOT_BROWSER' | 'CONSENT_DENIED' | 'INIT_FAILED';
+declare class PixelBootstrapError extends Error {
+    readonly code: PixelBootstrapErrorCode;
+    readonly cause?: unknown;
+    constructor(message: string, code: PixelBootstrapErrorCode, cause?: unknown);
+}
+
+export { type BootstrapPixelControls, PixelBootstrapError, type PixelBootstrapErrorCode, type PixelBrowserFactory, bootstrapPixel, destroyBootstrappedPixel, getBootstrappedPixel, getBootstrappedPixelPending };

package/dist/browser/index.d.ts

@@ -0,0 +1,55 @@
+import { P as PixelSettings } from '../pixel-settings-C0qPFTii.js';
+import { P as Pixel } from '../Pixel-CCgGk43j.js';
+import { P as PixelConfig } from '../pixel-DVy4rzj8.js';
+import '../index-B8u_3PGG.js';
+import '../url-context-Ck2LK18V.js';
+import '../PixelLogger-B21lEjep.js';
+import '../types-DcaBYgVI.js';
+import '../types-B2aUNHb3.js';
+
+type BootstrapPixelControls = {
+    /**
+     * Destrói a instância bootstrapada (se houver) e cria outra.
+     * A primeira chamada sem `force` é dona da instância na `window`.
+     */
+    force?: boolean;
+    /**
+     * Gate de consentimento. Executado antes de criar a instância.
+     * Se retornar `false`, o bootstrap aborta com `CONSENT_DENIED`.
+     */
+    waitForConsent?: () => boolean | Promise<boolean>;
+};
+type PixelBrowserFactory = {
+    (settings: PixelSettings): Promise<Pixel>;
+    create(settings: PixelSettings): Promise<Pixel>;
+    bootstrap(settings: PixelSettings, controls?: BootstrapPixelControls): Promise<Pixel>;
+    getInstance(): Pixel | null;
+    getPending(): Promise<Pixel> | null;
+    destroy(): Promise<void>;
+    readonly Client: typeof Pixel;
+    readonly DEFAULT_PIXEL_CONFIG: PixelConfig;
+};
+
+/**
+ * Uma instância por `window`. Sem `force`, a primeira chamada é dona da
+ * configuração; chamadas posteriores reutilizam pending/instância.
+ *
+ * Não é `async`: o retorno é a Promise do store para chamadas concorrentes
+ * compartilharem a mesma referência.
+ *
+ * Para trocar a configuração, use `force: true` ou `destroyBootstrappedPixel()`.
+ * Chamadas concorrentes compartilham a configuração da primeira que iniciou.
+ */
+declare function bootstrapPixel(settings: PixelSettings, controls?: BootstrapPixelControls): Promise<Pixel>;
+declare function getBootstrappedPixel(): Pixel | null;
+declare function getBootstrappedPixelPending(): Promise<Pixel> | null;
+declare function destroyBootstrappedPixel(): Promise<void>;
+
+type PixelBootstrapErrorCode = 'NOT_BROWSER' | 'CONSENT_DENIED' | 'INIT_FAILED';
+declare class PixelBootstrapError extends Error {
+    readonly code: PixelBootstrapErrorCode;
+    readonly cause?: unknown;
+    constructor(message: string, code: PixelBootstrapErrorCode, cause?: unknown);
+}
+
+export { type BootstrapPixelControls, PixelBootstrapError, type PixelBootstrapErrorCode, type PixelBrowserFactory, bootstrapPixel, destroyBootstrappedPixel, getBootstrappedPixel, getBootstrappedPixelPending };