@thisbefine/analytics 0.1.0

package/dist/core/privacy.js

@@ -0,0 +1,94 @@
+import { STORAGE_KEYS } from "./types";
+/**
+ * Privacy manager handles:
+ * - Do Not Track (DNT) detection
+ * - Global Privacy Control (GPC) detection
+ * - User opt-out/opt-in state
+ */
+export class Privacy {
+    constructor(storage, respectDNT, debug = false) {
+        this.storage = storage;
+        this.respectDNT = respectDNT;
+        this.debug = debug;
+    }
+    /**
+     * Check if Do Not Track is enabled in the browser
+     */
+    isDNTEnabled() {
+        if (typeof navigator === "undefined")
+            return false;
+        const dnt = navigator.doNotTrack ||
+            window.doNotTrack ||
+            navigator.msDoNotTrack;
+        return dnt === "1" || dnt === "yes";
+    }
+    /**
+     * Check if Global Privacy Control is enabled
+     * GPC is a newer standard that's gaining adoption
+     */
+    isGPCEnabled() {
+        if (typeof navigator === "undefined")
+            return false;
+        return (navigator
+            .globalPrivacyControl === true);
+    }
+    /**
+     * Check if the user has explicitly opted out
+     */
+    isOptedOut() {
+        return this.storage.get(STORAGE_KEYS.OPT_OUT) === "true";
+    }
+    /**
+     * Opt out of tracking
+     */
+    optOut() {
+        this.storage.set(STORAGE_KEYS.OPT_OUT, "true");
+        this.log("User opted out of tracking");
+    }
+    /**
+     * Opt back in to tracking
+     */
+    optIn() {
+        this.storage.remove(STORAGE_KEYS.OPT_OUT);
+        this.log("User opted in to tracking");
+    }
+    /**
+     * Check if tracking should be allowed based on all privacy signals
+     */
+    shouldTrack() {
+        if (this.isOptedOut()) {
+            this.log("Tracking blocked: user opted out");
+            return false;
+        }
+        if (this.respectDNT && this.isDNTEnabled()) {
+            this.log("Tracking blocked: DNT enabled");
+            return false;
+        }
+        if (this.respectDNT && this.isGPCEnabled()) {
+            this.log("Tracking blocked: GPC enabled");
+            return false;
+        }
+        return true;
+    }
+    /**
+     * Get a summary of privacy signals for debugging
+     */
+    getPrivacyStatus() {
+        return {
+            dntEnabled: this.isDNTEnabled(),
+            gpcEnabled: this.isGPCEnabled(),
+            optedOut: this.isOptedOut(),
+            respectDNT: this.respectDNT,
+            trackingAllowed: this.shouldTrack(),
+        };
+    }
+    /**
+     * Debug logger
+     */
+    log(...args) {
+        if (this.debug && typeof console !== "undefined") {
+            console.log("[Thisbefine Privacy]", ...args);
+        }
+    }
+}
+//# sourceMappingURL=privacy.js.map

package/dist/core/privacy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"privacy.js","sourceRoot":"","sources":["../../src/core/privacy.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC;;;;;GAKG;AACH,MAAM,OAAO,OAAO;IAKnB,YAAY,OAAyB,EAAE,UAAmB,EAAE,KAAK,GAAG,KAAK;QACxE,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACpB,CAAC;IAED;;OAEG;IACH,YAAY;QACX,IAAI,OAAO,SAAS,KAAK,WAAW;YAAE,OAAO,KAAK,CAAC;QAEnD,MAAM,GAAG,GACR,SAAS,CAAC,UAAU;YACnB,MAA6C,CAAC,UAAU;YACxD,SAAkD,CAAC,YAAY,CAAC;QAElE,OAAO,GAAG,KAAK,GAAG,IAAI,GAAG,KAAK,KAAK,CAAC;IACrC,CAAC;IAED;;;OAGG;IACH,YAAY;QACX,IAAI,OAAO,SAAS,KAAK,WAAW;YAAE,OAAO,KAAK,CAAC;QAEnD,OAAO,CACL,SAA2D;aAC1D,oBAAoB,KAAK,IAAI,CAC/B,CAAC;IACH,CAAC;IAED;;OAEG;IACH,UAAU;QACT,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,OAAO,CAAC,KAAK,MAAM,CAAC;IAC1D,CAAC;IAED;;OAEG;IACH,MAAM;QACL,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC/C,IAAI,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC;IACxC,CAAC;IAED;;OAEG;IACH,KAAK;QACJ,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;QAC1C,IAAI,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC;IACvC,CAAC;IAED;;OAEG;IACH,WAAW;QACV,IAAI,IAAI,CAAC,UAAU,EAAE,EAAE,CAAC;YACvB,IAAI,CAAC,GAAG,CAAC,kCAAkC,CAAC,CAAC;YAC7C,OAAO,KAAK,CAAC;QACd,CAAC;QAED,IAAI,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,YAAY,EAAE,EAAE,CAAC;YAC5C,IAAI,CAAC,GAAG,CAAC,+BAA+B,CAAC,CAAC;YAC1C,OAAO,KAAK,CAAC;QACd,CAAC;QAED,IAAI,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,YAAY,EAAE,EAAE,CAAC;YAC5C,IAAI,CAAC,GAAG,CAAC,+BAA+B,CAAC,CAAC;YAC1C,OAAO,KAAK,CAAC;QACd,CAAC;QAED,OAAO,IAAI,CAAC;IACb,CAAC;IAED;;OAEG;IACH,gBAAgB;QAOf,OAAO;YACN,UAAU,EAAE,IAAI,CAAC,YAAY,EAAE;YAC/B,UAAU,EAAE,IAAI,CAAC,YAAY,EAAE;YAC/B,QAAQ,EAAE,IAAI,CAAC,UAAU,EAAE;YAC3B,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,eAAe,EAAE,IAAI,CAAC,WAAW,EAAE;SACnC,CAAC;IACH,CAAC;IAED;;OAEG;IACK,GAAG,CAAC,GAAG,IAAe;QAC7B,IAAI,IAAI,CAAC,KAAK,IAAI,OAAO,OAAO,KAAK,WAAW,EAAE,CAAC;YAClD,OAAO,CAAC,GAAG,CAAC,sBAAsB,EAAE,GAAG,IAAI,CAAC,CAAC;QAC9C,CAAC;IACF,CAAC;CACD"}

package/dist/core/queue.d.ts

@@ -0,0 +1,59 @@
+import type { AnalyticsEvent, ResolvedConfig } from "./types";
+/**
+ * Event queue with batching, automatic flushing, and retry logic
+ *
+ * Features:
+ * - Batches events up to flushAt threshold
+ * - Flushes automatically after flushInterval
+ * - Uses sendBeacon on page unload for reliability
+ * - Exponential backoff retry on failure
+ */
+export declare class Queue {
+    private items;
+    private timer;
+    private flushPromise;
+    private visibilityFlushPending;
+    private config;
+    private logger;
+    constructor(config: ResolvedConfig);
+    /**
+     * Set up handlers for page unload to ensure events are sent
+     */
+    private setupUnloadHandlers;
+    /**
+     * Add an event to the queue
+     */
+    push(event: AnalyticsEvent): void;
+    /**
+     * Flush the queue, sending all pending events
+     *
+     * @param useBeacon - Use sendBeacon for page unload scenarios
+     * @param depth - Internal recursion depth counter (prevents stack overflow)
+     */
+    flush(useBeacon?: boolean, depth?: number): Promise<void>;
+    /**
+     * Send events using sendBeacon (for page unload)
+     */
+    private sendWithBeacon;
+    /**
+     * Send events using fetch with keepalive (for page unload fallback)
+     */
+    private sendWithKeepalive;
+    /**
+     * Send events with exponential backoff retry
+     */
+    private sendWithRetry;
+    /**
+     * Format events into batch payload for the API
+     */
+    private formatBatchPayload;
+    /**
+     * Sleep helper for retry backoff
+     */
+    private sleep;
+    /**
+     * Get the number of events in the queue
+     */
+    get length(): number;
+}
+//# sourceMappingURL=queue.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"queue.d.ts","sourceRoot":"","sources":["../../src/core/queue.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE9D;;;;;;;;GAQG;AACH,qBAAa,KAAK;IACjB,OAAO,CAAC,KAAK,CAAwB;IACrC,OAAO,CAAC,KAAK,CAA8C;IAC3D,OAAO,CAAC,YAAY,CAA8B;IAClD,OAAO,CAAC,sBAAsB,CAAS;IACvC,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,MAAM,CAAS;gBAEX,MAAM,EAAE,cAAc;IAOlC;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAuB3B;;OAEG;IACH,IAAI,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI;IAmBjC;;;;;OAKG;IACG,KAAK,CAAC,SAAS,UAAQ,EAAE,KAAK,SAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IA0DxD;;OAEG;IACH,OAAO,CAAC,cAAc;IAmBtB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAiBzB;;OAEG;YACW,aAAa;IA+C3B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IA4D1B;;OAEG;IACH,OAAO,CAAC,KAAK;IAIb;;OAEG;IACH,IAAI,MAAM,IAAI,MAAM,CAEnB;CACD"}

package/dist/core/queue.js

@@ -0,0 +1,263 @@
+import { createLogger } from "./logger";
+/**
+ * Event queue with batching, automatic flushing, and retry logic
+ *
+ * Features:
+ * - Batches events up to flushAt threshold
+ * - Flushes automatically after flushInterval
+ * - Uses sendBeacon on page unload for reliability
+ * - Exponential backoff retry on failure
+ */
+export class Queue {
+    constructor(config) {
+        this.items = [];
+        this.timer = null;
+        this.flushPromise = null;
+        this.visibilityFlushPending = false;
+        this.config = config;
+        this.logger = createLogger("Queue", config.debug);
+        this.setupUnloadHandlers();
+    }
+    /**
+     * Set up handlers for page unload to ensure events are sent
+     */
+    setupUnloadHandlers() {
+        if (typeof window === "undefined")
+            return;
+        document.addEventListener("visibilitychange", () => {
+            if (document.visibilityState === "hidden") {
+                if (this.visibilityFlushPending)
+                    return;
+                this.visibilityFlushPending = true;
+                this.flush(true);
+                setTimeout(() => {
+                    this.visibilityFlushPending = false;
+                }, 1000);
+            }
+        });
+        window.addEventListener("beforeunload", () => {
+            this.flush(true);
+        });
+        window.addEventListener("pagehide", () => {
+            this.flush(true);
+        });
+    }
+    /**
+     * Add an event to the queue
+     */
+    push(event) {
+        this.items.push(event);
+        this.logger.log("Event queued:", event.type, "event" in event ? event.event : "");
+        if (this.items.length >= this.config.flushAt) {
+            this.logger.log("Batch size reached, flushing...");
+            this.flush();
+        }
+        else if (!this.timer) {
+            this.timer = setTimeout(() => {
+                this.logger.log("Flush interval reached, flushing...");
+                this.flush();
+            }, this.config.flushInterval);
+        }
+    }
+    /**
+     * Flush the queue, sending all pending events
+     *
+     * @param useBeacon - Use sendBeacon for page unload scenarios
+     * @param depth - Internal recursion depth counter (prevents stack overflow)
+     */
+    async flush(useBeacon = false, depth = 0) {
+        const MAX_FLUSH_DEPTH = 3;
+        if (depth >= MAX_FLUSH_DEPTH) {
+            this.logger.warn(`Max flush depth (${MAX_FLUSH_DEPTH}) reached, ${this.items.length} events remain queued`);
+            if (this.items.length > 0 && !this.timer) {
+                this.timer = setTimeout(() => {
+                    this.flush();
+                }, this.config.flushInterval);
+            }
+            return;
+        }
+        if (this.timer) {
+            clearTimeout(this.timer);
+            this.timer = null;
+        }
+        if (this.items.length === 0) {
+            return;
+        }
+        if (this.flushPromise) {
+            this.logger.log("Flush in progress, waiting...");
+            await this.flushPromise;
+            if (this.items.length > 0) {
+                return this.flush(useBeacon, depth + 1);
+            }
+            return;
+        }
+        const batch = this.items.splice(0);
+        this.logger.log(`Flushing ${batch.length} events...`);
+        this.flushPromise = (async () => {
+            try {
+                if (useBeacon) {
+                    this.sendWithBeacon(batch);
+                }
+                else {
+                    await this.sendWithRetry(batch);
+                }
+                this.logger.log("Flush successful");
+            }
+            catch (error) {
+                this.items.unshift(...batch);
+                this.logger.log("Flush failed, re-queued events:", error);
+            }
+        })();
+        try {
+            await this.flushPromise;
+        }
+        finally {
+            this.flushPromise = null;
+        }
+    }
+    /**
+     * Send events using sendBeacon (for page unload)
+     */
+    sendWithBeacon(batch) {
+        if (typeof navigator === "undefined" || !navigator.sendBeacon) {
+            this.sendWithKeepalive(batch);
+            return;
+        }
+        const url = `${this.config.host}/api/v1/track`;
+        const payload = this.formatBatchPayload(batch);
+        const blob = new Blob([JSON.stringify(payload)], {
+            type: "application/json",
+        });
+        const urlWithKey = `${url}?key=${encodeURIComponent(this.config.apiKey)}`;
+        const success = navigator.sendBeacon(urlWithKey, blob);
+        this.logger.log("sendBeacon result:", success);
+    }
+    /**
+     * Send events using fetch with keepalive (for page unload fallback)
+     */
+    sendWithKeepalive(batch) {
+        if (typeof fetch === "undefined")
+            return;
+        const url = `${this.config.host}/api/v1/track`;
+        const payload = this.formatBatchPayload(batch);
+        fetch(url, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                "X-API-Key": this.config.apiKey,
+            },
+            body: JSON.stringify(payload),
+            keepalive: true,
+        }).catch(() => { });
+    }
+    /**
+     * Send events with exponential backoff retry
+     */
+    async sendWithRetry(batch) {
+        const url = `${this.config.host}/api/v1/track`;
+        const payload = this.formatBatchPayload(batch);
+        for (let attempt = 0; attempt <= this.config.maxRetries; 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) {
+                    return;
+                }
+                if (response.status >= 400 && response.status < 500) {
+                    if (response.status === 429) {
+                        this.logger.log("Rate limited, retrying...");
+                    }
+                    else {
+                        throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+                    }
+                }
+                if (attempt === this.config.maxRetries) {
+                    throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+                }
+            }
+            catch (error) {
+                if (attempt === this.config.maxRetries) {
+                    throw error;
+                }
+            }
+            const baseDelay = 2 ** attempt * 1000;
+            const jitter = Math.random() * 1000;
+            const delay = baseDelay + jitter;
+            this.logger.log(`Retry ${attempt + 1}/${this.config.maxRetries} in ${delay}ms`);
+            await this.sleep(delay);
+        }
+    }
+    /**
+     * Format events into batch payload for the API
+     */
+    formatBatchPayload(batch) {
+        return {
+            sentAt: new Date().toISOString(),
+            batch: batch.map((event) => {
+                const base = {
+                    timestamp: event.timestamp,
+                    anonymousId: event.anonymousId,
+                    userId: event.userId,
+                    sessionId: event.sessionId,
+                    accountId: event.accountId,
+                };
+                switch (event.type) {
+                    case "track":
+                        return {
+                            ...base,
+                            event: event.event,
+                            properties: event.properties,
+                            url: event.context?.page?.url,
+                            referrer: event.context?.page?.referrer,
+                        };
+                    case "page":
+                        return {
+                            ...base,
+                            event: "$pageview",
+                            properties: {
+                                ...event.properties,
+                                name: event.name,
+                                title: event.context?.page?.title,
+                            },
+                            url: event.url,
+                            referrer: event.referrer,
+                        };
+                    case "identify":
+                        return {
+                            ...base,
+                            event: "$identify",
+                            properties: event.traits,
+                        };
+                    case "group":
+                        return {
+                            ...base,
+                            event: "$group",
+                            accountId: event.accountId,
+                            properties: event.traits,
+                        };
+                    default:
+                        return base;
+                }
+            }),
+        };
+    }
+    /**
+     * Sleep helper for retry backoff
+     */
+    sleep(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+    /**
+     * Get the number of events in the queue
+     */
+    get length() {
+        return this.items.length;
+    }
+}
+//# sourceMappingURL=queue.js.map

package/dist/core/queue.js.map

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

package/dist/core/session.d.ts

@@ -0,0 +1,90 @@
+import type { AccountTraits, StorageInterface, UserState, UserTraits } from "./types";
+/**
+ * Session manager handles:
+ * - Anonymous ID generation and persistence
+ * - User ID management
+ * - Session ID with timeout-based regeneration
+ * - User traits storage
+ * - Cross-tab synchronization via BroadcastChannel
+ */
+export declare class Session {
+    private storage;
+    private sessionTimeout;
+    private currentSessionId;
+    private logger;
+    private broadcastChannel;
+    constructor(storage: StorageInterface, sessionTimeout: number, debug?: boolean);
+    /**
+     * Set up cross-tab session synchronization using BroadcastChannel
+     */
+    private setupCrossTabSync;
+    /**
+     * Handle messages from other tabs
+     */
+    private handleBroadcastMessage;
+    /**
+     * Broadcast a message to other tabs
+     */
+    private broadcastMessage;
+    /**
+     * Get the anonymous ID, generating one if it doesn't exist
+     */
+    getAnonymousId(): string;
+    /**
+     * Get the current user ID (if identified)
+     */
+    getUserId(): string | undefined;
+    /**
+     * Set the user ID (called during identify)
+     */
+    setUserId(userId: string): void;
+    /**
+     * Get user traits
+     */
+    getUserTraits(): UserTraits | undefined;
+    /**
+     * Set user traits (merges with existing traits)
+     */
+    setUserTraits(traits: UserTraits): void;
+    /**
+     * Get the current account ID (if grouped)
+     */
+    getAccountId(): string | undefined;
+    /**
+     * Set the account ID (called during group)
+     */
+    setAccountId(accountId: string): void;
+    /**
+     * Get account traits
+     */
+    getAccountTraits(): AccountTraits | undefined;
+    /**
+     * Set account traits (merges with existing traits)
+     */
+    setAccountTraits(traits: AccountTraits): void;
+    /**
+     * Get the current session ID, creating a new one if the session has expired
+     */
+    getSessionId(): string;
+    /**
+     * Check if the session has expired and create a new one if needed
+     */
+    private ensureSession;
+    /**
+     * Update the last activity timestamp
+     */
+    updateLastActivity(): void;
+    /**
+     * Reset the session (clear user, account, and session data)
+     */
+    reset(): void;
+    /**
+     * Clean up resources (call when destroying the analytics instance)
+     */
+    destroy(): void;
+    /**
+     * Get the full user state
+     */
+    getUserState(): UserState;
+}
+//# sourceMappingURL=session.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/core/session.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACX,aAAa,EACb,gBAAgB,EAChB,SAAS,EACT,UAAU,EACV,MAAM,SAAS,CAAC;AAYjB;;;;;;;GAOG;AACH,qBAAa,OAAO;IACnB,OAAO,CAAC,OAAO,CAAmB;IAClC,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,gBAAgB,CAAuB;IAC/C,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,gBAAgB,CAAiC;gBAGxD,OAAO,EAAE,gBAAgB,EACzB,cAAc,EAAE,MAAM,EACtB,KAAK,UAAQ;IAUd;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAqBzB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IA6B9B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAMxB;;OAEG;IACH,cAAc,IAAI,MAAM;IAYxB;;OAEG;IACH,SAAS,IAAI,MAAM,GAAG,SAAS;IAI/B;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAM/B;;OAEG;IACH,aAAa,IAAI,UAAU,GAAG,SAAS;IAWvC;;OAEG;IACH,aAAa,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI;IAOvC;;OAEG;IACH,YAAY,IAAI,MAAM,GAAG,SAAS;IAIlC;;OAEG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAKrC;;OAEG;IACH,gBAAgB,IAAI,aAAa,GAAG,SAAS;IAW7C;;OAEG;IACH,gBAAgB,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI;IAO7C;;OAEG;IACH,YAAY,IAAI,MAAM;IAUtB;;OAEG;IACH,OAAO,CAAC,aAAa;IAwBrB;;OAEG;IACH,kBAAkB,IAAI,IAAI;IAI1B;;OAEG;IACH,KAAK,IAAI,IAAI;IAwBb;;OAEG;IACH,OAAO,IAAI,IAAI;IAOf;;OAEG;IACH,YAAY,IAAI,SAAS;CASzB"}