@thisbefine/analytics 0.1.0

package/dist/core/errors.js

@@ -0,0 +1,420 @@
+import { createLogger } from "./logger";
+/**
+ * Cyrb53 hash - a fast, high-quality 53-bit hash function.
+ * Better distribution than FNV-1a, and we call it twice with
+ * different seeds to get a 106-bit hash for lower collision probability.
+ */
+const cyrb53 = (str, seed = 0) => {
+    let h1 = 0xdeadbeef ^ seed;
+    let h2 = 0x41c6ce57 ^ seed;
+    for (let i = 0; i < str.length; i++) {
+        const ch = str.charCodeAt(i);
+        h1 = Math.imul(h1 ^ ch, 2654435761);
+        h2 = Math.imul(h2 ^ ch, 1597334677);
+    }
+    h1 = Math.imul(h1 ^ (h1 >>> 16), 2246822507);
+    h1 ^= Math.imul(h2 ^ (h2 >>> 13), 3266489909);
+    h2 = Math.imul(h2 ^ (h2 >>> 16), 2246822507);
+    h2 ^= Math.imul(h1 ^ (h1 >>> 13), 3266489909);
+    return 4294967296 * (2097151 & h2) + (h1 >>> 0);
+};
+/**
+ * Generate a 128-bit hash by running cyrb53 with two different seeds
+ */
+const hashString = (str) => {
+    const h1 = cyrb53(str, 0);
+    const h2 = cyrb53(str, 1);
+    return h1.toString(16).padStart(14, "0") + h2.toString(16).padStart(14, "0");
+};
+/**
+ * Extract the top stack frame from a stack trace string
+ */
+const extractTopFrame = (stack) => {
+    if (!stack)
+        return "";
+    const lines = stack.split("\n").filter((l) => l.trim().startsWith("at "));
+    return lines[0]?.trim() ?? "";
+};
+/**
+ * Normalize error message for fingerprinting.
+ * Removes dynamic values like IDs, timestamps, etc.
+ */
+const normalizeMessage = (message) => {
+    return message
+        .replace(/[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}/gi, "<uuid>")
+        .replace(/\b\d{5,}\b/g, "<id>")
+        .replace(/"[^"]*\d+[^"]*"/g, '"<dynamic>"')
+        .replace(/\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}/g, "<timestamp>")
+        .replace(/\s+/g, " ")
+        .trim();
+};
+/**
+ * Generate a fingerprint for error grouping
+ */
+const generateFingerprint = (type, message, stack) => {
+    const topFrame = extractTopFrame(stack);
+    const normalizedMessage = normalizeMessage(message);
+    const input = `${type ?? "Error"}:${normalizedMessage}:${topFrame}`;
+    return hashString(input);
+};
+/**
+ * Truncate a string to a maximum length without allocating if not needed
+ */
+const truncate = (str, maxLen) => str.length > maxLen ? str.slice(0, maxLen) : str;
+/**
+ * Extract meaningful text from an element efficiently.
+ * Avoids getting huge textContent from container elements.
+ */
+const getElementText = (el, maxLen) => {
+    if (el instanceof HTMLInputElement || el instanceof HTMLTextAreaElement) {
+        return truncate(el.value || el.placeholder || "", maxLen);
+    }
+    const ariaLabel = el.getAttribute("aria-label");
+    if (ariaLabel) {
+        return truncate(ariaLabel.trim(), maxLen);
+    }
+    if (el.childNodes.length <= 3) {
+        let text = "";
+        for (const node of el.childNodes) {
+            if (node.nodeType === Node.TEXT_NODE) {
+                text += node.textContent || "";
+            }
+        }
+        text = text.trim();
+        if (text) {
+            return truncate(text, maxLen);
+        }
+    }
+    if (el.tagName === "BUTTON" ||
+        el.tagName === "A" ||
+        el.getAttribute("role") === "button") {
+        const firstLine = el.innerText?.split("\n")[0]?.trim() ?? "";
+        return truncate(firstLine, maxLen);
+    }
+    return "";
+};
+/**
+ * Error capture module for the analytics SDK.
+ *
+ * Captures unhandled exceptions, unhandled promise rejections,
+ * and records breadcrumbs (clicks, navigation, console, network).
+ */
+export class ErrorCapture {
+    constructor(config, session, errorConfig) {
+        this.breadcrumbs = [];
+        this.installed = false;
+        this.originalOnError = null;
+        this.originalConsoleError = null;
+        this.originalFetch = null;
+        this.unhandledRejectionHandler = null;
+        this.clickHandler = null;
+        this.lastClickTarget = null;
+        this.lastClickTime = 0;
+        this.originalPushState = null;
+        this.originalReplaceState = null;
+        this.popstateHandler = null;
+        this.config = config;
+        this.session = session;
+        this.logger = createLogger("Errors", config.debug);
+        this.errorConfig = {
+            enabled: errorConfig?.enabled ?? true,
+            captureConsoleErrors: errorConfig?.captureConsoleErrors ?? false,
+            captureNetworkErrors: errorConfig?.captureNetworkErrors ?? false,
+            maxBreadcrumbs: errorConfig?.maxBreadcrumbs ?? 25,
+            beforeSend: errorConfig?.beforeSend,
+        };
+    }
+    /**
+     * Install global error handlers and breadcrumb collectors
+     */
+    install() {
+        if (this.installed || typeof window === "undefined")
+            return;
+        if (!this.errorConfig.enabled)
+            return;
+        this.installErrorHandler();
+        this.installUnhandledRejectionHandler();
+        this.installClickBreadcrumbs();
+        this.installNavigationBreadcrumbs();
+        if (this.errorConfig.captureConsoleErrors) {
+            this.installConsoleBreadcrumbs();
+        }
+        if (this.errorConfig.captureNetworkErrors) {
+            this.installNetworkBreadcrumbs();
+        }
+        this.installed = true;
+        this.logger.log("Error capture installed");
+    }
+    /**
+     * Remove all handlers and restore originals
+     */
+    uninstall() {
+        if (!this.installed || typeof window === "undefined")
+            return;
+        window.onerror = this.originalOnError;
+        this.originalOnError = null;
+        if (this.unhandledRejectionHandler) {
+            window.removeEventListener("unhandledrejection", this.unhandledRejectionHandler);
+            this.unhandledRejectionHandler = null;
+        }
+        if (this.clickHandler) {
+            document.removeEventListener("click", this.clickHandler, true);
+            this.clickHandler = null;
+        }
+        if (this.originalPushState) {
+            history.pushState = this.originalPushState;
+            this.originalPushState = null;
+        }
+        if (this.originalReplaceState) {
+            history.replaceState = this.originalReplaceState;
+            this.originalReplaceState = null;
+        }
+        if (this.popstateHandler) {
+            window.removeEventListener("popstate", this.popstateHandler);
+            this.popstateHandler = null;
+        }
+        if (this.originalConsoleError) {
+            console.error = this.originalConsoleError;
+            this.originalConsoleError = null;
+        }
+        if (this.originalFetch) {
+            window.fetch = this.originalFetch;
+            this.originalFetch = null;
+        }
+        this.installed = false;
+        this.logger.log("Error capture uninstalled");
+    }
+    /**
+     * Add a breadcrumb manually
+     */
+    addBreadcrumb(breadcrumb) {
+        this.pushBreadcrumb({
+            ...breadcrumb,
+            timestamp: new Date().toISOString(),
+        });
+    }
+    /**
+     * Clear all breadcrumbs
+     */
+    clearBreadcrumbs() {
+        this.breadcrumbs = [];
+    }
+    /**
+     * Capture an exception and send it to the API
+     */
+    captureException(error, context) {
+        const message = error.message || String(error);
+        const stack = error.stack;
+        const type = error.name || "Error";
+        const fingerprint = generateFingerprint(type, message, stack);
+        this.sendError({
+            message,
+            stack,
+            type,
+            level: "error",
+            fingerprint,
+            context,
+        });
+    }
+    /**
+     * Capture a message as an error event
+     */
+    captureMessage(message, level = "error", context) {
+        const fingerprint = generateFingerprint(undefined, message, undefined);
+        this.sendError({
+            message,
+            level,
+            fingerprint,
+            context,
+        });
+    }
+    installErrorHandler() {
+        this.originalOnError = window.onerror;
+        window.onerror = (message, source, lineno, colno, error) => {
+            if (error) {
+                this.captureException(error);
+            }
+            else {
+                const msg = typeof message === "string" ? message : "Unknown error";
+                this.captureMessage(msg);
+            }
+            if (typeof this.originalOnError === "function") {
+                return this.originalOnError.call(window, message, source, lineno, colno, error);
+            }
+            return false;
+        };
+    }
+    installUnhandledRejectionHandler() {
+        this.unhandledRejectionHandler = (event) => {
+            const reason = event.reason;
+            if (reason instanceof Error) {
+                this.captureException(reason);
+            }
+            else {
+                const message = typeof reason === "string" ? reason : "Unhandled promise rejection";
+                this.captureMessage(message);
+            }
+        };
+        window.addEventListener("unhandledrejection", this.unhandledRejectionHandler);
+    }
+    installClickBreadcrumbs() {
+        this.clickHandler = (event) => {
+            const target = event.target;
+            if (!target)
+                return;
+            const now = Date.now();
+            if (target === this.lastClickTarget && now - this.lastClickTime < 100) {
+                return;
+            }
+            this.lastClickTarget = target;
+            this.lastClickTime = now;
+            const tag = target.tagName?.toLowerCase() ?? "unknown";
+            const id = target.id ? `#${target.id}` : "";
+            const text = getElementText(target, 50);
+            const message = `${tag}${id}${text ? ` "${text}"` : ""}`;
+            this.pushBreadcrumb({
+                type: "click",
+                message,
+                timestamp: new Date().toISOString(),
+                data: {
+                    tagName: tag,
+                    id: target.id || undefined,
+                    className: typeof target.className === "string"
+                        ? truncate(target.className, 100)
+                        : undefined,
+                },
+            });
+        };
+        document.addEventListener("click", this.clickHandler, true);
+    }
+    installNavigationBreadcrumbs() {
+        const addNavBreadcrumb = (url) => {
+            this.pushBreadcrumb({
+                type: "navigation",
+                message: url,
+                timestamp: new Date().toISOString(),
+            });
+        };
+        this.originalPushState = history.pushState.bind(history);
+        history.pushState = (...args) => {
+            this.originalPushState?.(...args);
+            addNavBreadcrumb(window.location.href);
+        };
+        this.originalReplaceState = history.replaceState.bind(history);
+        history.replaceState = (...args) => {
+            this.originalReplaceState?.(...args);
+            addNavBreadcrumb(window.location.href);
+        };
+        this.popstateHandler = () => {
+            addNavBreadcrumb(window.location.href);
+        };
+        window.addEventListener("popstate", this.popstateHandler);
+    }
+    installConsoleBreadcrumbs() {
+        this.originalConsoleError = console.error.bind(console);
+        console.error = (...args) => {
+            this.pushBreadcrumb({
+                type: "console",
+                message: args.map((a) => String(a)).join(" "),
+                timestamp: new Date().toISOString(),
+            });
+            this.originalConsoleError?.(...args);
+        };
+    }
+    installNetworkBreadcrumbs() {
+        this.originalFetch = window.fetch.bind(window);
+        window.fetch = async (input, init) => {
+            const url = typeof input === "string"
+                ? input
+                : input instanceof URL
+                    ? input.toString()
+                    : input.url;
+            const method = init?.method ?? "GET";
+            try {
+                if (!this.originalFetch) {
+                    throw new Error("originalFetch is not available");
+                }
+                const response = await this.originalFetch(input, init);
+                if (!response.ok) {
+                    this.pushBreadcrumb({
+                        type: "network",
+                        message: `${method} ${url} → ${response.status}`,
+                        timestamp: new Date().toISOString(),
+                        data: { method, url, status: response.status },
+                    });
+                }
+                return response;
+            }
+            catch (error) {
+                this.pushBreadcrumb({
+                    type: "network",
+                    message: `${method} ${url} → failed`,
+                    timestamp: new Date().toISOString(),
+                    data: {
+                        method,
+                        url,
+                        error: error instanceof Error ? error.message : "Unknown",
+                    },
+                });
+                throw error;
+            }
+        };
+    }
+    pushBreadcrumb(breadcrumb) {
+        this.breadcrumbs.push(breadcrumb);
+        if (this.breadcrumbs.length > this.errorConfig.maxBreadcrumbs) {
+            this.breadcrumbs.shift();
+        }
+    }
+    sendError(partial) {
+        const payload = {
+            ...partial,
+            url: typeof window !== "undefined" ? window.location.href : undefined,
+            breadcrumbs: [...this.breadcrumbs],
+            anonymousId: this.session.getAnonymousId(),
+            userId: this.session.getUserId(),
+            sessionId: this.session.getSessionId(),
+            timestamp: new Date().toISOString(),
+        };
+        const finalPayload = this.errorConfig.beforeSend
+            ? this.errorConfig.beforeSend(payload)
+            : payload;
+        if (!finalPayload) {
+            this.logger.log("Error discarded by beforeSend");
+            return;
+        }
+        this.postError(finalPayload);
+    }
+    async postError(payload) {
+        const url = `${this.config.host}/api/v1/error`;
+        for (let attempt = 0; attempt < 2; attempt++) {
+            try {
+                const response = await fetch(url, {
+                    method: "POST",
+                    headers: {
+                        "Content-Type": "application/json",
+                        "X-API-Key": this.config.apiKey,
+                    },
+                    body: JSON.stringify(payload),
+                });
+                if (response.ok) {
+                    this.logger.log("Error sent:", payload.message);
+                    return;
+                }
+                if (response.status >= 400 &&
+                    response.status < 500 &&
+                    response.status !== 429) {
+                    this.logger.log("Error rejected (client error):", response.status);
+                    return;
+                }
+            }
+            catch {
+                this.logger.log("Error send failed, attempt", attempt + 1);
+            }
+            if (attempt === 0) {
+                await new Promise((r) => setTimeout(r, 1000));
+            }
+        }
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/core/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"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"}

package/dist/core/logger.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Shared debug logger factory for SDK modules
+ *
+ * Creates a consistent logging interface across all SDK components.
+ * Logs are only output when debug mode is enabled.
+ */
+export interface Logger {
+    log: (...args: unknown[]) => void;
+    warn: (...args: unknown[]) => void;
+    error: (...args: unknown[]) => void;
+}
+/**
+ * Create a namespaced debug logger
+ *
+ * @param prefix - Module name (e.g., "Queue", "Session", "Errors")
+ * @param debug - Whether debug mode is enabled
+ * @returns Logger interface with log, warn, and error methods
+ *
+ * @example
+ * ```typescript
+ * const logger = createLogger("Queue", this.config.debug);
+ * logger.log("Event queued:", event.type);
+ * logger.warn("Queue is full, dropping oldest event");
+ * logger.error("Failed to send batch:", error);
+ * ```
+ */
+export declare const createLogger: (prefix: string, debug: boolean) => Logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/core/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/core/logger.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,MAAM;IACtB,GAAG,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;IAClC,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;IACnC,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;CACpC;AAED;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,YAAY,GAAI,QAAQ,MAAM,EAAE,OAAO,OAAO,KAAG,MAoB7D,CAAC"}

package/dist/core/logger.js

@@ -0,0 +1,36 @@
+/**
+ * Create a namespaced debug logger
+ *
+ * @param prefix - Module name (e.g., "Queue", "Session", "Errors")
+ * @param debug - Whether debug mode is enabled
+ * @returns Logger interface with log, warn, and error methods
+ *
+ * @example
+ * ```typescript
+ * const logger = createLogger("Queue", this.config.debug);
+ * logger.log("Event queued:", event.type);
+ * logger.warn("Queue is full, dropping oldest event");
+ * logger.error("Failed to send batch:", error);
+ * ```
+ */
+export const createLogger = (prefix, debug) => {
+    const shouldLog = debug && typeof console !== "undefined";
+    return {
+        log: (...args) => {
+            if (shouldLog) {
+                console.log(`[Thisbefine ${prefix}]`, ...args);
+            }
+        },
+        warn: (...args) => {
+            if (shouldLog) {
+                console.warn(`[Thisbefine ${prefix}]`, ...args);
+            }
+        },
+        error: (...args) => {
+            if (typeof console !== "undefined") {
+                console.error(`[Thisbefine ${prefix}]`, ...args);
+            }
+        },
+    };
+};
+//# sourceMappingURL=logger.js.map

package/dist/core/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/core/logger.ts"],"names":[],"mappings":"AAYA;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,MAAc,EAAE,KAAc,EAAU,EAAE;IACtE,MAAM,SAAS,GAAG,KAAK,IAAI,OAAO,OAAO,KAAK,WAAW,CAAC;IAE1D,OAAO;QACN,GAAG,EAAE,CAAC,GAAG,IAAe,EAAE,EAAE;YAC3B,IAAI,SAAS,EAAE,CAAC;gBACf,OAAO,CAAC,GAAG,CAAC,eAAe,MAAM,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;YAChD,CAAC;QACF,CAAC;QACD,IAAI,EAAE,CAAC,GAAG,IAAe,EAAE,EAAE;YAC5B,IAAI,SAAS,EAAE,CAAC;gBACf,OAAO,CAAC,IAAI,CAAC,eAAe,MAAM,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;YACjD,CAAC;QACF,CAAC;QACD,KAAK,EAAE,CAAC,GAAG,IAAe,EAAE,EAAE;YAC7B,IAAI,OAAO,OAAO,KAAK,WAAW,EAAE,CAAC;gBACpC,OAAO,CAAC,KAAK,CAAC,eAAe,MAAM,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;YAClD,CAAC;QACF,CAAC;KACD,CAAC;AACH,CAAC,CAAC"}

package/dist/core/logging.d.ts

@@ -0,0 +1,12 @@
+import type { Analytics } from "./types";
+export type LogLevel = "debug" | "info" | "warn" | "error" | "fatal";
+/**
+ * Send a structured log event through the analytics track pipeline.
+ * Logs are stored as track events with name "$log".
+ *
+ * Note: The event timestamp is set by track() - no need to duplicate it.
+ * Metadata keys "message" and "level" are reserved and will be prefixed
+ * with "meta_" to avoid conflicts.
+ */
+export declare const log: (analytics: Analytics, message: string, level: LogLevel, metadata?: Record<string, unknown>) => void;
+//# sourceMappingURL=logging.d.ts.map

package/dist/core/logging.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logging.d.ts","sourceRoot":"","sources":["../../src/core/logging.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEzC,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;AAQrE;;;;;;;GAOG;AACH,eAAO,MAAM,GAAG,GACf,WAAW,SAAS,EACpB,SAAS,MAAM,EACf,OAAO,QAAQ,EACf,WAAW,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAChC,IAmBF,CAAC"}

package/dist/core/logging.js

@@ -0,0 +1,33 @@
+/**
+ * Reserved property names that cannot be used in log metadata.
+ * These are used by the logging system itself.
+ */
+const RESERVED_KEYS = ["message", "level"];
+/**
+ * Send a structured log event through the analytics track pipeline.
+ * Logs are stored as track events with name "$log".
+ *
+ * Note: The event timestamp is set by track() - no need to duplicate it.
+ * Metadata keys "message" and "level" are reserved and will be prefixed
+ * with "meta_" to avoid conflicts.
+ */
+export const log = (analytics, message, level, metadata) => {
+    let sanitizedMetadata;
+    if (metadata) {
+        sanitizedMetadata = {};
+        for (const [key, value] of Object.entries(metadata)) {
+            if (RESERVED_KEYS.includes(key)) {
+                sanitizedMetadata[`meta_${key}`] = value;
+            }
+            else {
+                sanitizedMetadata[key] = value;
+            }
+        }
+    }
+    analytics.track("$log", {
+        message,
+        level,
+        ...sanitizedMetadata,
+    });
+};
+//# sourceMappingURL=logging.js.map

package/dist/core/logging.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logging.js","sourceRoot":"","sources":["../../src/core/logging.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,MAAM,aAAa,GAAG,CAAC,SAAS,EAAE,OAAO,CAAU,CAAC;AAEpD;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,GAAG,GAAG,CAClB,SAAoB,EACpB,OAAe,EACf,KAAe,EACf,QAAkC,EAC3B,EAAE;IACT,IAAI,iBAAsD,CAAC;IAE3D,IAAI,QAAQ,EAAE,CAAC;QACd,iBAAiB,GAAG,EAAE,CAAC;QACvB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;YACrD,IAAI,aAAa,CAAC,QAAQ,CAAC,GAAqC,CAAC,EAAE,CAAC;gBACnE,iBAAiB,CAAC,QAAQ,GAAG,EAAE,CAAC,GAAG,KAAK,CAAC;YAC1C,CAAC;iBAAM,CAAC;gBACP,iBAAiB,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;YAChC,CAAC;QACF,CAAC;IACF,CAAC;IAED,SAAS,CAAC,KAAK,CAAC,MAAM,EAAE;QACvB,OAAO;QACP,KAAK;QACL,GAAG,iBAAiB;KACpB,CAAC,CAAC;AACJ,CAAC,CAAC"}

package/dist/core/privacy.d.ts

@@ -0,0 +1,53 @@
+import type { StorageInterface } from "./types";
+/**
+ * Privacy manager handles:
+ * - Do Not Track (DNT) detection
+ * - Global Privacy Control (GPC) detection
+ * - User opt-out/opt-in state
+ */
+export declare class Privacy {
+    private storage;
+    private respectDNT;
+    private debug;
+    constructor(storage: StorageInterface, respectDNT: boolean, debug?: boolean);
+    /**
+     * Check if Do Not Track is enabled in the browser
+     */
+    isDNTEnabled(): boolean;
+    /**
+     * Check if Global Privacy Control is enabled
+     * GPC is a newer standard that's gaining adoption
+     */
+    isGPCEnabled(): boolean;
+    /**
+     * Check if the user has explicitly opted out
+     */
+    isOptedOut(): boolean;
+    /**
+     * Opt out of tracking
+     */
+    optOut(): void;
+    /**
+     * Opt back in to tracking
+     */
+    optIn(): void;
+    /**
+     * Check if tracking should be allowed based on all privacy signals
+     */
+    shouldTrack(): boolean;
+    /**
+     * Get a summary of privacy signals for debugging
+     */
+    getPrivacyStatus(): {
+        dntEnabled: boolean;
+        gpcEnabled: boolean;
+        optedOut: boolean;
+        respectDNT: boolean;
+        trackingAllowed: boolean;
+    };
+    /**
+     * Debug logger
+     */
+    private log;
+}
+//# sourceMappingURL=privacy.d.ts.map

package/dist/core/privacy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"privacy.d.ts","sourceRoot":"","sources":["../../src/core/privacy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAGhD;;;;;GAKG;AACH,qBAAa,OAAO;IACnB,OAAO,CAAC,OAAO,CAAmB;IAClC,OAAO,CAAC,UAAU,CAAU;IAC5B,OAAO,CAAC,KAAK,CAAU;gBAEX,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,OAAO,EAAE,KAAK,UAAQ;IAMzE;;OAEG;IACH,YAAY,IAAI,OAAO;IAWvB;;;OAGG;IACH,YAAY,IAAI,OAAO;IASvB;;OAEG;IACH,UAAU,IAAI,OAAO;IAIrB;;OAEG;IACH,MAAM,IAAI,IAAI;IAKd;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb;;OAEG;IACH,WAAW,IAAI,OAAO;IAmBtB;;OAEG;IACH,gBAAgB,IAAI;QACnB,UAAU,EAAE,OAAO,CAAC;QACpB,UAAU,EAAE,OAAO,CAAC;QACpB,QAAQ,EAAE,OAAO,CAAC;QAClB,UAAU,EAAE,OAAO,CAAC;QACpB,eAAe,EAAE,OAAO,CAAC;KACzB;IAUD;;OAEG;IACH,OAAO,CAAC,GAAG;CAKX"}