@thisbefine/analytics 0.1.0

package/dist/core/session.js

@@ -0,0 +1,246 @@
+import { createLogger } from "./logger";
+import { generateId } from "./storage";
+import { STORAGE_KEYS } from "./types";
+const BROADCAST_CHANNEL_NAME = "thisbefine_session";
+/**
+ * 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 class Session {
+    constructor(storage, sessionTimeout, debug = false) {
+        this.currentSessionId = null;
+        this.broadcastChannel = null;
+        this.storage = storage;
+        this.sessionTimeout = sessionTimeout;
+        this.logger = createLogger("Session", debug);
+        this.ensureSession();
+        this.setupCrossTabSync();
+    }
+    /**
+     * Set up cross-tab session synchronization using BroadcastChannel
+     */
+    setupCrossTabSync() {
+        if (typeof BroadcastChannel === "undefined") {
+            this.logger.log("BroadcastChannel not available, cross-tab sync disabled");
+            return;
+        }
+        try {
+            this.broadcastChannel = new BroadcastChannel(BROADCAST_CHANNEL_NAME);
+            this.broadcastChannel.onmessage = (event) => {
+                this.handleBroadcastMessage(event.data);
+            };
+            this.logger.log("Cross-tab sync enabled");
+        }
+        catch {
+            this.logger.log("Failed to create BroadcastChannel");
+        }
+    }
+    /**
+     * Handle messages from other tabs
+     */
+    handleBroadcastMessage(message) {
+        switch (message.type) {
+            case "reset":
+                this.currentSessionId = this.storage.get(STORAGE_KEYS.SESSION_ID);
+                this.logger.log("Session synced from another tab (reset)");
+                break;
+            case "identify":
+                this.logger.log("User identified in another tab:", message.userId);
+                break;
+            case "sync_request":
+                this.broadcastMessage({
+                    type: "sync_response",
+                    sessionId: this.currentSessionId ?? undefined,
+                    anonymousId: this.storage.get(STORAGE_KEYS.ANONYMOUS_ID) ?? undefined,
+                    userId: this.storage.get(STORAGE_KEYS.USER_ID) ?? undefined,
+                });
+                break;
+            case "sync_response":
+                if (message.sessionId && message.sessionId !== this.currentSessionId) {
+                    this.currentSessionId = message.sessionId;
+                    this.logger.log("Session synced from another tab");
+                }
+                break;
+        }
+    }
+    /**
+     * Broadcast a message to other tabs
+     */
+    broadcastMessage(message) {
+        try {
+            this.broadcastChannel?.postMessage(message);
+        }
+        catch { }
+    }
+    /**
+     * Get the anonymous ID, generating one if it doesn't exist
+     */
+    getAnonymousId() {
+        let anonymousId = this.storage.get(STORAGE_KEYS.ANONYMOUS_ID);
+        if (!anonymousId) {
+            anonymousId = generateId();
+            this.storage.set(STORAGE_KEYS.ANONYMOUS_ID, anonymousId);
+            this.logger.log("Generated new anonymous ID:", anonymousId);
+        }
+        return anonymousId;
+    }
+    /**
+     * Get the current user ID (if identified)
+     */
+    getUserId() {
+        return this.storage.get(STORAGE_KEYS.USER_ID) ?? undefined;
+    }
+    /**
+     * Set the user ID (called during identify)
+     */
+    setUserId(userId) {
+        this.storage.set(STORAGE_KEYS.USER_ID, userId);
+        this.logger.log("User ID set:", userId);
+        this.broadcastMessage({ type: "identify", userId });
+    }
+    /**
+     * Get user traits
+     */
+    getUserTraits() {
+        const traitsJson = this.storage.get(STORAGE_KEYS.USER_TRAITS);
+        if (!traitsJson)
+            return undefined;
+        try {
+            return JSON.parse(traitsJson);
+        }
+        catch {
+            return undefined;
+        }
+    }
+    /**
+     * Set user traits (merges with existing traits)
+     */
+    setUserTraits(traits) {
+        const existingTraits = this.getUserTraits() ?? {};
+        const mergedTraits = { ...existingTraits, ...traits };
+        this.storage.set(STORAGE_KEYS.USER_TRAITS, JSON.stringify(mergedTraits));
+        this.logger.log("User traits updated:", mergedTraits);
+    }
+    /**
+     * Get the current account ID (if grouped)
+     */
+    getAccountId() {
+        return this.storage.get(STORAGE_KEYS.ACCOUNT_ID) ?? undefined;
+    }
+    /**
+     * Set the account ID (called during group)
+     */
+    setAccountId(accountId) {
+        this.storage.set(STORAGE_KEYS.ACCOUNT_ID, accountId);
+        this.logger.log("Account ID set:", accountId);
+    }
+    /**
+     * Get account traits
+     */
+    getAccountTraits() {
+        const traitsJson = this.storage.get(STORAGE_KEYS.ACCOUNT_TRAITS);
+        if (!traitsJson)
+            return undefined;
+        try {
+            return JSON.parse(traitsJson);
+        }
+        catch {
+            return undefined;
+        }
+    }
+    /**
+     * Set account traits (merges with existing traits)
+     */
+    setAccountTraits(traits) {
+        const existingTraits = this.getAccountTraits() ?? {};
+        const mergedTraits = { ...existingTraits, ...traits };
+        this.storage.set(STORAGE_KEYS.ACCOUNT_TRAITS, JSON.stringify(mergedTraits));
+        this.logger.log("Account traits updated:", mergedTraits);
+    }
+    /**
+     * Get the current session ID, creating a new one if the session has expired
+     */
+    getSessionId() {
+        this.ensureSession();
+        if (!this.currentSessionId) {
+            this.currentSessionId = generateId();
+            this.storage.set(STORAGE_KEYS.SESSION_ID, this.currentSessionId);
+        }
+        return this.currentSessionId;
+    }
+    /**
+     * Check if the session has expired and create a new one if needed
+     */
+    ensureSession() {
+        const storedSessionId = this.storage.get(STORAGE_KEYS.SESSION_ID);
+        const lastActivityStr = this.storage.get(STORAGE_KEYS.LAST_ACTIVITY);
+        const lastActivity = lastActivityStr ? parseInt(lastActivityStr, 10) : 0;
+        const now = Date.now();
+        const sessionExpired = now - lastActivity > this.sessionTimeout;
+        if (!storedSessionId || sessionExpired) {
+            this.currentSessionId = generateId();
+            this.storage.set(STORAGE_KEYS.SESSION_ID, this.currentSessionId);
+            this.logger.log(sessionExpired
+                ? "Session expired, created new:"
+                : "Created new session:", this.currentSessionId);
+        }
+        else {
+            this.currentSessionId = storedSessionId;
+        }
+        this.updateLastActivity();
+    }
+    /**
+     * Update the last activity timestamp
+     */
+    updateLastActivity() {
+        this.storage.set(STORAGE_KEYS.LAST_ACTIVITY, Date.now().toString());
+    }
+    /**
+     * Reset the session (clear user, account, and session data)
+     */
+    reset() {
+        this.storage.remove(STORAGE_KEYS.USER_ID);
+        this.storage.remove(STORAGE_KEYS.USER_TRAITS);
+        this.storage.remove(STORAGE_KEYS.ACCOUNT_ID);
+        this.storage.remove(STORAGE_KEYS.ACCOUNT_TRAITS);
+        const newAnonymousId = generateId();
+        this.storage.set(STORAGE_KEYS.ANONYMOUS_ID, newAnonymousId);
+        const newSessionId = generateId();
+        this.currentSessionId = newSessionId;
+        this.storage.set(STORAGE_KEYS.SESSION_ID, newSessionId);
+        this.updateLastActivity();
+        this.broadcastMessage({
+            type: "reset",
+            sessionId: newSessionId,
+            anonymousId: newAnonymousId,
+        });
+        this.logger.log("Session reset. New anonymous ID:", newAnonymousId);
+    }
+    /**
+     * Clean up resources (call when destroying the analytics instance)
+     */
+    destroy() {
+        try {
+            this.broadcastChannel?.close();
+            this.broadcastChannel = null;
+        }
+        catch { }
+    }
+    /**
+     * Get the full user state
+     */
+    getUserState() {
+        return {
+            anonymousId: this.getAnonymousId(),
+            userId: this.getUserId(),
+            traits: this.getUserTraits(),
+            accountId: this.getAccountId(),
+            accountTraits: this.getAccountTraits(),
+        };
+    }
+}
+//# sourceMappingURL=session.js.map

package/dist/core/session.js.map

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

package/dist/core/storage.d.ts

@@ -0,0 +1,64 @@
+import type { StorageInterface } from "./types";
+/**
+ * Storage implementation with fallback chain:
+ * 1. localStorage (persists across sessions)
+ * 2. sessionStorage (per-tab)
+ * 3. Cookie (cross-subdomain support, 365 day expiry)
+ * 4. Memory (final fallback, lost on refresh)
+ */
+export declare class Storage implements StorageInterface {
+    private memoryStorage;
+    private storageType;
+    private cookieDomain?;
+    constructor(cookieDomain?: string);
+    /**
+     * Detect the best available storage mechanism
+     */
+    private detectStorageType;
+    /**
+     * Check if localStorage is available
+     */
+    private isLocalStorageAvailable;
+    /**
+     * Check if sessionStorage is available
+     */
+    private isSessionStorageAvailable;
+    /**
+     * Check if cookies are available and can be set with expiry
+     */
+    private areCookiesAvailable;
+    /**
+     * Get a value from storage
+     */
+    get(key: string): string | null;
+    /**
+     * Set a value in storage
+     */
+    set(key: string, value: string): void;
+    /**
+     * Clear old analytics data to free up quota
+     */
+    private clearOldData;
+    /**
+     * Remove a value from storage
+     */
+    remove(key: string): void;
+    /**
+     * Get a cookie value
+     */
+    private getCookie;
+    /**
+     * Set a cookie value (365 day expiry)
+     */
+    private setCookie;
+    /**
+     * Delete a cookie
+     */
+    private deleteCookie;
+    /**
+     * Get the current storage type being used
+     */
+    getStorageType(): string;
+}
+export declare const generateId: () => string;
+//# sourceMappingURL=storage.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../src/core/storage.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAEhD;;;;;;GAMG;AACH,qBAAa,OAAQ,YAAW,gBAAgB;IAC/C,OAAO,CAAC,aAAa,CAAkC;IACvD,OAAO,CAAC,WAAW,CAA0D;IAC7E,OAAO,CAAC,YAAY,CAAC,CAAS;gBAElB,YAAY,CAAC,EAAE,MAAM;IAKjC;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAoBzB;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAa/B;;OAEG;IACH,OAAO,CAAC,yBAAyB;IAajC;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAsB3B;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAoB/B;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IA2CrC;;OAEG;IACH,OAAO,CAAC,YAAY;IAsBpB;;OAEG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAuBzB;;OAEG;IACH,OAAO,CAAC,SAAS;IAajB;;OAEG;IACH,OAAO,CAAC,SAAS;IAgBjB;;OAEG;IACH,OAAO,CAAC,YAAY;IAapB;;OAEG;IACH,cAAc,IAAI,MAAM;CAGxB;AAED,eAAO,MAAM,UAAU,QAAO,MAAkB,CAAC"}

package/dist/core/storage.js

@@ -0,0 +1,242 @@
+import { v7 as uuidv7 } from "uuid";
+/**
+ * Storage implementation with fallback chain:
+ * 1. localStorage (persists across sessions)
+ * 2. sessionStorage (per-tab)
+ * 3. Cookie (cross-subdomain support, 365 day expiry)
+ * 4. Memory (final fallback, lost on refresh)
+ */
+export class Storage {
+    constructor(cookieDomain) {
+        this.memoryStorage = new Map();
+        this.cookieDomain = cookieDomain;
+        this.storageType = this.detectStorageType();
+    }
+    /**
+     * Detect the best available storage mechanism
+     */
+    detectStorageType() {
+        if (this.isLocalStorageAvailable()) {
+            return "localStorage";
+        }
+        if (this.isSessionStorageAvailable()) {
+            return "sessionStorage";
+        }
+        if (this.areCookiesAvailable()) {
+            return "cookie";
+        }
+        return "memory";
+    }
+    /**
+     * Check if localStorage is available
+     */
+    isLocalStorageAvailable() {
+        if (typeof window === "undefined")
+            return false;
+        try {
+            const testKey = "__tif_storage_test__";
+            window.localStorage.setItem(testKey, testKey);
+            window.localStorage.removeItem(testKey);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Check if sessionStorage is available
+     */
+    isSessionStorageAvailable() {
+        if (typeof window === "undefined")
+            return false;
+        try {
+            const testKey = "__tif_storage_test__";
+            window.sessionStorage.setItem(testKey, testKey);
+            window.sessionStorage.removeItem(testKey);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Check if cookies are available and can be set with expiry
+     */
+    areCookiesAvailable() {
+        if (typeof document === "undefined")
+            return false;
+        if (typeof navigator !== "undefined" && !navigator.cookieEnabled) {
+            return false;
+        }
+        try {
+            const testKey = "__tif_cookie_test__";
+            const testValue = "1";
+            const expires = new Date(Date.now() + 60000).toUTCString();
+            // biome-ignore lint/suspicious/noDocumentCookie: Cookie storage requires direct cookie access
+            document.cookie = `${testKey}=${testValue}; expires=${expires}; path=/; SameSite=Lax`;
+            const result = document.cookie.includes(`${testKey}=${testValue}`);
+            // biome-ignore lint/suspicious/noDocumentCookie: Cookie storage requires direct cookie access
+            document.cookie = `${testKey}=; expires=Thu, 01 Jan 1970 00:00:00 UTC; path=/`;
+            return result;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Get a value from storage
+     */
+    get(key) {
+        try {
+            switch (this.storageType) {
+                case "localStorage":
+                    return window.localStorage.getItem(key);
+                case "sessionStorage":
+                    return window.sessionStorage.getItem(key);
+                case "cookie":
+                    return this.getCookie(key);
+                case "memory":
+                    return this.memoryStorage.get(key) ?? null;
+            }
+        }
+        catch {
+            return this.memoryStorage.get(key) ?? null;
+        }
+    }
+    /**
+     * Set a value in storage
+     */
+    set(key, value) {
+        try {
+            switch (this.storageType) {
+                case "localStorage":
+                    window.localStorage.setItem(key, value);
+                    break;
+                case "sessionStorage":
+                    window.sessionStorage.setItem(key, value);
+                    break;
+                case "cookie":
+                    this.setCookie(key, value);
+                    break;
+                case "memory":
+                    this.memoryStorage.set(key, value);
+                    break;
+            }
+        }
+        catch (error) {
+            if (error instanceof Error &&
+                (error.name === "QuotaExceededError" ||
+                    error.name === "NS_ERROR_DOM_QUOTA_REACHED" ||
+                    error.message.includes("quota"))) {
+                this.clearOldData();
+                try {
+                    switch (this.storageType) {
+                        case "localStorage":
+                            window.localStorage.setItem(key, value);
+                            return;
+                        case "sessionStorage":
+                            window.sessionStorage.setItem(key, value);
+                            return;
+                    }
+                }
+                catch { }
+            }
+            this.memoryStorage.set(key, value);
+        }
+    }
+    /**
+     * Clear old analytics data to free up quota
+     */
+    clearOldData() {
+        const storage = this.storageType === "localStorage"
+            ? window.localStorage
+            : this.storageType === "sessionStorage"
+                ? window.sessionStorage
+                : null;
+        if (!storage)
+            return;
+        const keysToCheck = ["tif_user_traits", "tif_account_traits"];
+        for (const key of keysToCheck) {
+            try {
+                const value = storage.getItem(key);
+                if (value && value.length > 10000) {
+                    storage.removeItem(key);
+                }
+            }
+            catch { }
+        }
+    }
+    /**
+     * Remove a value from storage
+     */
+    remove(key) {
+        this.memoryStorage.delete(key);
+        try {
+            switch (this.storageType) {
+                case "localStorage":
+                    window.localStorage.removeItem(key);
+                    break;
+                case "sessionStorage":
+                    window.sessionStorage.removeItem(key);
+                    break;
+                case "cookie":
+                    this.deleteCookie(key);
+                    break;
+                case "memory":
+                    break;
+            }
+        }
+        catch { }
+    }
+    /**
+     * Get a cookie value
+     */
+    getCookie(name) {
+        if (typeof document === "undefined")
+            return null;
+        const cookies = document.cookie.split(";");
+        for (const cookie of cookies) {
+            const [cookieName, cookieValue] = cookie.split("=").map((c) => c.trim());
+            if (cookieName === name) {
+                return decodeURIComponent(cookieValue);
+            }
+        }
+        return null;
+    }
+    /**
+     * Set a cookie value (365 day expiry)
+     */
+    setCookie(name, value) {
+        if (typeof document === "undefined")
+            return;
+        const expires = new Date();
+        expires.setTime(expires.getTime() + 365 * 24 * 60 * 60 * 1000);
+        let cookie = `${name}=${encodeURIComponent(value)}; expires=${expires.toUTCString()}; path=/; SameSite=Lax`;
+        if (this.cookieDomain) {
+            cookie += `; domain=${this.cookieDomain}`;
+        }
+        // biome-ignore lint/suspicious/noDocumentCookie: Cookie storage requires direct cookie access
+        document.cookie = cookie;
+    }
+    /**
+     * Delete a cookie
+     */
+    deleteCookie(name) {
+        if (typeof document === "undefined")
+            return;
+        let cookie = `${name}=; expires=Thu, 01 Jan 1970 00:00:00 UTC; path=/`;
+        if (this.cookieDomain) {
+            cookie += `; domain=${this.cookieDomain}`;
+        }
+        // biome-ignore lint/suspicious/noDocumentCookie: Cookie storage requires direct cookie access
+        document.cookie = cookie;
+    }
+    /**
+     * Get the current storage type being used
+     */
+    getStorageType() {
+        return this.storageType;
+    }
+}
+export const generateId = () => uuidv7();
+//# sourceMappingURL=storage.js.map

package/dist/core/storage.js.map

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