@hifilabs/pixel 0.0.7 → 0.0.9

package/dist/index.esm.d.ts

@@ -1 +1,60 @@
 export declare function BalanceAnalytics(): null;
+
+// SSR-safe wrapper function type declarations
+export declare const track: (eventName: string, properties?: Record<string, any>) => void;
+export declare const identify: (email: string, traits?: Record<string, any>) => Promise<void>;
+export declare const page: (options?: { title?: string; url?: string }) => void;
+export declare const purchase: (revenue: number, currency?: string, properties?: Record<string, any>) => void;
+export declare const getSessionId: () => string | null;
+export declare const getFanIdHash: () => string | null;
+export declare const getAttribution: () => Record<string, string>;
+export declare const setConsent: (preferences: {
+  analytics: boolean;
+  marketing: boolean;
+  personalization: boolean;
+  timestamp: string;
+  ip_address?: string;
+  user_agent?: string;
+}) => void;
+export declare const getConsent: () => any;
+export declare const hasConsent: (type: 'analytics' | 'marketing' | 'personalization') => boolean;
+
+// useBalanceIdentify hook - consent-aware identify wrapper
+export declare function useBalanceIdentify(): {
+  /**
+   * Identify a user with BALANCE pixel.
+   * Handles consent checks, queuing, and storage tier automatically.
+   * @param email - User's email address
+   * @param traits - Optional additional user traits
+   * @returns true if identify was called immediately, false if queued or blocked
+   */
+  identify: (email: string, traits?: Record<string, unknown>) => boolean;
+  /**
+   * Check if analytics consent is currently granted
+   */
+  hasAnalyticsConsent: () => boolean;
+};
+
+// Storage types
+export type StorageTier = 'session' | 'local';
+
+export interface StorageConfig {
+  prefix: string;
+  tier: StorageTier;
+}
+
+// StorageManager class for tiered storage
+export declare class StorageManager {
+  constructor(config?: Partial<StorageConfig>);
+  getTier(): StorageTier;
+  upgradeTier(newTier: StorageTier): void;
+  downgradeTier(newTier: StorageTier): void;
+  getItem(key: string): string | null;
+  setItem(key: string, value: string): void;
+  removeItem(key: string): void;
+  getJSON<T>(key: string): T | null;
+  setJSON<T>(key: string, value: T): void;
+}
+
+export declare function getStorageManager(): StorageManager;
+export declare function initStorageWithConsent(hasAnalyticsConsent: boolean): StorageManager;

package/dist/index.esm.js

@@ -1,22 +1,461 @@
 'use client';
+var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField = (obj, key, value) => {
+  __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+  return value;
+};
+
 // src/react/BalanceAnalytics.tsx
-import React, { useEffect, Suspense } from "react";
+import React, { useEffect, useRef, Suspense } from "react";
 import { usePathname, useSearchParams } from "next/navigation";
 function BalanceAnalyticsInner() {
   const pathname = usePathname();
   const searchParams = useSearchParams();
+  const isFirstRender = useRef(true);
+  const lastTrackedPath = useRef(null);
   useEffect(() => {
-    if (typeof window !== "undefined" && window.balance) {
-      const url = window.location.href;
-      const title = document.title;
-      window.balance.page({ url, title });
+    if (typeof window === "undefined" || !window.balance)
+      return;
+    const currentPath = pathname + (searchParams?.toString() || "");
+    if (lastTrackedPath.current === currentPath) {
+      return;
+    }
+    if (isFirstRender.current) {
+      isFirstRender.current = false;
+      if (window._balanceInitialPageviewFired) {
+        lastTrackedPath.current = currentPath;
+        console.log("[BalanceAnalytics] Skipping initial pageview (script already fired)");
+        return;
+      }
     }
+    const url = window.location.href;
+    const title = document.title;
+    lastTrackedPath.current = currentPath;
+    window.balance.page({ url, title });
   }, [pathname, searchParams]);
   return null;
 }
 function BalanceAnalytics() {
   return /* @__PURE__ */ React.createElement(Suspense, { fallback: null }, /* @__PURE__ */ React.createElement(BalanceAnalyticsInner, null));
 }
+
+// src/react/useBalanceIdentify.ts
+import { useCallback, useEffect as useEffect2, useRef as useRef2 } from "react";
+
+// src/storage/StorageManager.ts
+var DEFAULT_PREFIX = "balance_";
+var StorageManager = class {
+  constructor(config) {
+    __publicField(this, "prefix");
+    __publicField(this, "currentTier");
+    this.prefix = config?.prefix ?? DEFAULT_PREFIX;
+    this.currentTier = config?.tier ?? "session";
+  }
+  /**
+   * Get the appropriate storage based on current tier
+   */
+  getStorage() {
+    if (typeof window === "undefined")
+      return null;
+    try {
+      return this.currentTier === "local" ? localStorage : sessionStorage;
+    } catch {
+      return null;
+    }
+  }
+  /**
+   * Get current storage tier
+   */
+  getTier() {
+    return this.currentTier;
+  }
+  /**
+   * Upgrade storage tier (e.g., when user gives consent)
+   * Automatically migrates data from sessionStorage to localStorage
+   */
+  upgradeTier(newTier) {
+    if (typeof window === "undefined")
+      return;
+    if (this.currentTier === newTier)
+      return;
+    const oldTier = this.currentTier;
+    if (oldTier === "session" && newTier === "local") {
+      this.migrateToLocal();
+    }
+    this.currentTier = newTier;
+    console.log(`[StorageManager] Upgraded tier: ${oldTier} -> ${newTier}`);
+  }
+  /**
+   * Downgrade storage tier (e.g., when user revokes consent)
+   * Clears localStorage data and falls back to sessionStorage
+   */
+  downgradeTier(newTier) {
+    if (typeof window === "undefined")
+      return;
+    if (this.currentTier === newTier)
+      return;
+    const oldTier = this.currentTier;
+    if (oldTier === "local" && newTier === "session") {
+      this.clearLocalStorage();
+    }
+    this.currentTier = newTier;
+    console.log(`[StorageManager] Downgraded tier: ${oldTier} -> ${newTier}`);
+  }
+  /**
+   * Migrate all prefixed data from sessionStorage to localStorage
+   */
+  migrateToLocal() {
+    if (typeof window === "undefined")
+      return;
+    try {
+      const keysToMigrate = [];
+      for (let i = 0; i < sessionStorage.length; i++) {
+        const key = sessionStorage.key(i);
+        if (key?.startsWith(this.prefix)) {
+          keysToMigrate.push(key);
+        }
+      }
+      for (const key of keysToMigrate) {
+        const value = sessionStorage.getItem(key);
+        if (value) {
+          localStorage.setItem(key, value);
+          console.log(`[StorageManager] Migrated: ${key}`);
+        }
+      }
+      for (const key of keysToMigrate) {
+        sessionStorage.removeItem(key);
+      }
+      console.log(`[StorageManager] Migration complete: ${keysToMigrate.length} items`);
+    } catch (error) {
+      console.error("[StorageManager] Migration failed:", error);
+    }
+  }
+  /**
+   * Clear all prefixed data from localStorage
+   */
+  clearLocalStorage() {
+    if (typeof window === "undefined")
+      return;
+    try {
+      const keysToRemove = [];
+      for (let i = 0; i < localStorage.length; i++) {
+        const key = localStorage.key(i);
+        if (key?.startsWith(this.prefix)) {
+          keysToRemove.push(key);
+        }
+      }
+      for (const key of keysToRemove) {
+        localStorage.removeItem(key);
+      }
+      console.log(`[StorageManager] Cleared ${keysToRemove.length} items from localStorage`);
+    } catch (error) {
+      console.error("[StorageManager] Clear failed:", error);
+    }
+  }
+  /**
+   * Get item from current storage tier
+   */
+  getItem(key) {
+    const storage = this.getStorage();
+    if (!storage)
+      return null;
+    try {
+      const fullKey = this.prefix + key;
+      let value = storage.getItem(fullKey);
+      if (!value && this.currentTier === "session") {
+        try {
+          value = localStorage.getItem(fullKey);
+        } catch {
+        }
+      }
+      return value;
+    } catch {
+      return null;
+    }
+  }
+  /**
+   * Set item in current storage tier
+   */
+  setItem(key, value) {
+    const storage = this.getStorage();
+    if (!storage)
+      return;
+    try {
+      const fullKey = this.prefix + key;
+      storage.setItem(fullKey, value);
+    } catch (error) {
+      console.error("[StorageManager] setItem failed:", error);
+    }
+  }
+  /**
+   * Remove item from all storage tiers
+   */
+  removeItem(key) {
+    if (typeof window === "undefined")
+      return;
+    const fullKey = this.prefix + key;
+    try {
+      sessionStorage.removeItem(fullKey);
+    } catch {
+    }
+    try {
+      localStorage.removeItem(fullKey);
+    } catch {
+    }
+  }
+  /**
+   * Get JSON-parsed item
+   */
+  getJSON(key) {
+    const value = this.getItem(key);
+    if (!value)
+      return null;
+    try {
+      return JSON.parse(value);
+    } catch {
+      return null;
+    }
+  }
+  /**
+   * Set JSON-stringified item
+   */
+  setJSON(key, value) {
+    try {
+      this.setItem(key, JSON.stringify(value));
+    } catch {
+    }
+  }
+};
+var storageManagerInstance = null;
+function getStorageManager() {
+  if (!storageManagerInstance) {
+    storageManagerInstance = new StorageManager();
+  }
+  return storageManagerInstance;
+}
+function initStorageWithConsent(hasAnalyticsConsent) {
+  const manager = getStorageManager();
+  if (hasAnalyticsConsent) {
+    manager.upgradeTier("local");
+  } else {
+    manager.downgradeTier("session");
+  }
+  return manager;
+}
+
+// src/react/useBalanceIdentify.ts
+var PENDING_IDENTIFY_KEY = "pending_identify";
+var MAX_PENDING_AGE_MS = 30 * 60 * 1e3;
+function checkAnalyticsConsent() {
+  if (typeof window === "undefined")
+    return false;
+  try {
+    if (window.balance?.hasConsent) {
+      return window.balance.hasConsent("analytics");
+    }
+    const stored = localStorage.getItem("balance_consent");
+    if (stored) {
+      const consent = JSON.parse(stored);
+      return consent?.preferences?.analytics !== false;
+    }
+    return true;
+  } catch {
+    return true;
+  }
+}
+function useBalanceIdentify() {
+  const pollIntervalRef = useRef2(null);
+  const hasProcessedPending = useRef2(false);
+  const storageManager = typeof window !== "undefined" ? getStorageManager() : null;
+  const getPendingIdentify = useCallback(() => {
+    if (!storageManager)
+      return null;
+    const pending = storageManager.getJSON(PENDING_IDENTIFY_KEY);
+    if (!pending)
+      return null;
+    if (Date.now() - pending.timestamp > MAX_PENDING_AGE_MS) {
+      storageManager.removeItem(PENDING_IDENTIFY_KEY);
+      return null;
+    }
+    return pending;
+  }, [storageManager]);
+  const setPendingIdentify = useCallback((email, traits) => {
+    if (!storageManager)
+      return;
+    storageManager.setJSON(PENDING_IDENTIFY_KEY, {
+      email,
+      traits,
+      timestamp: Date.now()
+    });
+  }, [storageManager]);
+  const clearPendingIdentify = useCallback(() => {
+    if (!storageManager)
+      return;
+    storageManager.removeItem(PENDING_IDENTIFY_KEY);
+  }, [storageManager]);
+  const identify2 = useCallback((email, traits) => {
+    const hasConsent2 = checkAnalyticsConsent();
+    if (!hasConsent2) {
+      console.log("[useBalanceIdentify] Skipping identify - user declined analytics consent");
+      return false;
+    }
+    if (storageManager) {
+      initStorageWithConsent(hasConsent2);
+    }
+    if (typeof window !== "undefined" && window.balance?.identify) {
+      window.balance.identify(email, traits);
+      console.log("[useBalanceIdentify] User identified:", email.split("@")[0] + "***");
+      clearPendingIdentify();
+      return true;
+    }
+    console.log("[useBalanceIdentify] Pixel not ready, queueing identify");
+    setPendingIdentify(email, traits);
+    return false;
+  }, [storageManager, clearPendingIdentify, setPendingIdentify]);
+  const processPendingIdentify = useCallback(() => {
+    if (hasProcessedPending.current)
+      return;
+    const pending = getPendingIdentify();
+    if (!pending)
+      return;
+    if (typeof window !== "undefined" && window.balance?.identify) {
+      const hasConsent2 = checkAnalyticsConsent();
+      if (!hasConsent2) {
+        console.log("[useBalanceIdentify] Clearing pending identify - user declined analytics consent");
+        clearPendingIdentify();
+        hasProcessedPending.current = true;
+        return;
+      }
+      if (storageManager) {
+        initStorageWithConsent(hasConsent2);
+      }
+      console.log("[useBalanceIdentify] Processing pending identify");
+      window.balance.identify(pending.email, pending.traits);
+      clearPendingIdentify();
+      hasProcessedPending.current = true;
+    }
+  }, [getPendingIdentify, clearPendingIdentify, storageManager]);
+  useEffect2(() => {
+    processPendingIdentify();
+    const pending = getPendingIdentify();
+    if (pending && !hasProcessedPending.current) {
+      pollIntervalRef.current = setInterval(() => {
+        processPendingIdentify();
+        if (hasProcessedPending.current || !getPendingIdentify()) {
+          if (pollIntervalRef.current) {
+            clearInterval(pollIntervalRef.current);
+            pollIntervalRef.current = null;
+          }
+        }
+      }, 500);
+    }
+    return () => {
+      if (pollIntervalRef.current) {
+        clearInterval(pollIntervalRef.current);
+        pollIntervalRef.current = null;
+      }
+    };
+  }, [processPendingIdentify, getPendingIdentify]);
+  return {
+    /**
+     * Identify a user with BALANCE pixel.
+     * Handles consent checks, queuing, and storage tier automatically.
+     */
+    identify: identify2,
+    /**
+     * Check if analytics consent is currently granted
+     */
+    hasAnalyticsConsent: checkAnalyticsConsent
+  };
+}
+
+// src/index.esm.ts
+var track = (eventName, properties) => {
+  if (typeof window === "undefined")
+    return;
+  if (window.balance) {
+    window.balance.track(eventName, properties);
+  } else {
+    console.warn("[Balance Pixel] track() called before pixel initialized:", eventName);
+  }
+};
+var identify = (email, traits) => {
+  if (typeof window === "undefined")
+    return Promise.resolve();
+  if (window.balance) {
+    return window.balance.identify(email, traits);
+  } else {
+    console.warn("[Balance Pixel] identify() called before pixel initialized");
+    return Promise.resolve();
+  }
+};
+var page = (options) => {
+  if (typeof window === "undefined")
+    return;
+  if (window.balance) {
+    window.balance.page(options);
+  } else {
+    console.warn("[Balance Pixel] page() called before pixel initialized");
+  }
+};
+var purchase = (revenue, currency, properties) => {
+  if (typeof window === "undefined")
+    return;
+  if (window.balance) {
+    window.balance.purchase(revenue, currency, properties);
+  } else {
+    console.warn("[Balance Pixel] purchase() called before pixel initialized");
+  }
+};
+var getSessionId = () => {
+  if (typeof window === "undefined")
+    return null;
+  return window.balance?.getSessionId() ?? null;
+};
+var getFanIdHash = () => {
+  if (typeof window === "undefined")
+    return null;
+  return window.balance?.getFanIdHash() ?? null;
+};
+var getAttribution = () => {
+  if (typeof window === "undefined")
+    return {};
+  return window.balance?.getAttribution() ?? {};
+};
+var setConsent = (preferences) => {
+  if (typeof window === "undefined")
+    return;
+  if (window.balance) {
+    window.balance.setConsent(preferences);
+  } else {
+    console.warn("[Balance Pixel] setConsent() called before pixel initialized");
+  }
+};
+var getConsent = () => {
+  if (typeof window === "undefined")
+    return null;
+  return window.balance?.getConsent() ?? null;
+};
+var hasConsent = (type) => {
+  if (typeof window === "undefined")
+    return false;
+  return window.balance?.hasConsent(type) ?? false;
+};
 export {
-  BalanceAnalytics
+  BalanceAnalytics,
+  StorageManager,
+  getAttribution,
+  getConsent,
+  getFanIdHash,
+  getSessionId,
+  getStorageManager,
+  hasConsent,
+  identify,
+  initStorageWithConsent,
+  page,
+  purchase,
+  setConsent,
+  track,
+  useBalanceIdentify
 };

package/dist/index.js

@@ -56,12 +56,27 @@ var BalancePixel = (() => {
   function BalanceAnalyticsInner() {
     const pathname = (0, import_navigation.usePathname)();
     const searchParams = (0, import_navigation.useSearchParams)();
+    const isFirstRender = (0, import_react.useRef)(true);
+    const lastTrackedPath = (0, import_react.useRef)(null);
     (0, import_react.useEffect)(() => {
-      if (typeof window !== "undefined" && window.balance) {
-        const url = window.location.href;
-        const title = document.title;
-        window.balance.page({ url, title });
+      if (typeof window === "undefined" || !window.balance)
+        return;
+      const currentPath = pathname + (searchParams?.toString() || "");
+      if (lastTrackedPath.current === currentPath) {
+        return;
+      }
+      if (isFirstRender.current) {
+        isFirstRender.current = false;
+        if (window._balanceInitialPageviewFired) {
+          lastTrackedPath.current = currentPath;
+          console.log("[BalanceAnalytics] Skipping initial pageview (script already fired)");
+          return;
+        }
       }
+      const url = window.location.href;
+      const title = document.title;
+      lastTrackedPath.current = currentPath;
+      window.balance.page({ url, title });
     }, [pathname, searchParams]);
     return null;
   }
@@ -80,12 +95,13 @@ var BalancePixel = (() => {
       console.error("[BALANCE Pixel] Error: data-artist-id attribute is required");
       return;
     }
-    const SESSION_KEY = "balance_session_id";
-    const SESSION_TIMESTAMP_KEY = "balance_session_timestamp";
-    const ATTRIBUTION_KEY = "balance_attribution";
-    const FAN_ID_KEY = "balance_fan_id_hash";
+    const SESSION_KEY = "session_id";
+    const SESSION_TIMESTAMP_KEY = "session_timestamp";
+    const ATTRIBUTION_KEY = "attribution";
+    const FAN_ID_KEY = "fan_id_hash";
     const CONSENT_STORAGE_KEY = "balance_consent";
     const SESSION_DURATION = 60 * 60 * 1e3;
+    const STORAGE_PREFIX = "balance_";
     const API_ENDPOINT = useEmulator ? `http://localhost:5001/artist-os-distro/us-central1/pixelEndpoint` : `https://us-central1-artist-os-distro.cloudfunctions.net/pixelEndpoint`;
     let sessionId = null;
     let fanIdHash = null;
@@ -93,10 +109,72 @@ var BalancePixel = (() => {
     let attribution = {};
     let eventQueue = [];
     let flushTimer = null;
+    let currentStorageTier = "session";
     const log = (...args) => {
       if (debug)
         console.log("[BALANCE Pixel]", ...args);
     };
+    function getStorage() {
+      try {
+        return currentStorageTier === "local" ? localStorage : sessionStorage;
+      } catch {
+        return null;
+      }
+    }
+    function storageGet(key) {
+      const storage = getStorage();
+      if (!storage)
+        return null;
+      try {
+        const fullKey = STORAGE_PREFIX + key;
+        let value = storage.getItem(fullKey);
+        if (!value && currentStorageTier === "session") {
+          try {
+            value = localStorage.getItem(fullKey);
+          } catch {
+          }
+        }
+        return value;
+      } catch {
+        return null;
+      }
+    }
+    function storageSet(key, value) {
+      const storage = getStorage();
+      if (!storage)
+        return;
+      try {
+        storage.setItem(STORAGE_PREFIX + key, value);
+      } catch {
+      }
+    }
+    function upgradeStorageTier() {
+      if (currentStorageTier === "local")
+        return;
+      log("Upgrading storage tier: session -> local");
+      try {
+        const keysToMigrate = [];
+        for (let i = 0; i < sessionStorage.length; i++) {
+          const key = sessionStorage.key(i);
+          if (key?.startsWith(STORAGE_PREFIX)) {
+            keysToMigrate.push(key);
+          }
+        }
+        for (const key of keysToMigrate) {
+          const value = sessionStorage.getItem(key);
+          if (value) {
+            localStorage.setItem(key, value);
+          }
+        }
+        for (const key of keysToMigrate) {
+          sessionStorage.removeItem(key);
+        }
+        currentStorageTier = "local";
+        log(`Storage tier upgraded, migrated ${keysToMigrate.length} items`);
+      } catch (error) {
+        console.error("[BALANCE Pixel] Storage migration failed:", error);
+      }
+    }
     function generateUUID() {
       if (crypto && crypto.randomUUID) {
         return crypto.randomUUID();
@@ -109,18 +187,18 @@ var BalancePixel = (() => {
     }
     function getOrCreateSession() {
       try {
-        const stored = localStorage.getItem(SESSION_KEY);
-        const timestamp = localStorage.getItem(SESSION_TIMESTAMP_KEY);
+        const stored = storageGet(SESSION_KEY);
+        const timestamp = storageGet(SESSION_TIMESTAMP_KEY);
         if (stored && timestamp) {
           const age = Date.now() - parseInt(timestamp, 10);
           if (age < SESSION_DURATION) {
-            localStorage.setItem(SESSION_TIMESTAMP_KEY, Date.now().toString());
+            storageSet(SESSION_TIMESTAMP_KEY, Date.now().toString());
             return stored;
           }
         }
         const newId = generateUUID();
-        localStorage.setItem(SESSION_KEY, newId);
-        localStorage.setItem(SESSION_TIMESTAMP_KEY, Date.now().toString());
+        storageSet(SESSION_KEY, newId);
+        storageSet(SESSION_TIMESTAMP_KEY, Date.now().toString());
         return newId;
       } catch (e) {
         return generateUUID();
@@ -138,7 +216,7 @@ var BalancePixel = (() => {
     }
     function captureAttribution() {
       try {
-        const stored = localStorage.getItem(ATTRIBUTION_KEY);
+        const stored = storageGet(ATTRIBUTION_KEY);
         if (stored) {
           attribution = JSON.parse(stored);
           log("Loaded attribution:", attribution);
@@ -147,7 +225,7 @@ var BalancePixel = (() => {
         const utm = extractUTM();
         if (Object.keys(utm).length > 0) {
           attribution = utm;
-          localStorage.setItem(ATTRIBUTION_KEY, JSON.stringify(utm));
+          storageSet(ATTRIBUTION_KEY, JSON.stringify(utm));
           log("Captured attribution:", attribution);
         }
       } catch (e) {
@@ -155,7 +233,7 @@ var BalancePixel = (() => {
     }
     function loadFanId() {
       try {
-        fanIdHash = localStorage.getItem(FAN_ID_KEY);
+        fanIdHash = storageGet(FAN_ID_KEY);
       } catch (e) {
       }
     }
@@ -184,6 +262,9 @@ var BalancePixel = (() => {
       } catch (e) {
         console.error("[BALANCE Pixel] Could not save consent:", e);
       }
+      if (preferences.analytics === true) {
+        upgradeStorageTier();
+      }
       const event = buildEvent({
         event_name: "consent_updated",
         metadata: {
@@ -285,15 +366,23 @@ var BalancePixel = (() => {
     }
     async function identify2(email, traits = {}) {
       try {
+        if (consent && consent.analytics === false) {
+          log("Identify skipped - user declined analytics consent");
+          return;
+        }
         fanIdHash = await hashEmail(email);
-        localStorage.setItem(FAN_ID_KEY, fanIdHash);
+        if (consent?.analytics === true) {
+          upgradeStorageTier();
+        }
+        storageSet(FAN_ID_KEY, fanIdHash);
         const emailParts = email.split("@");
         const maskedEmail = emailParts[0].charAt(0) + "***@" + (emailParts[1] || "");
         log("Fan identified:", {
           name: traits.name || "(no name)",
           email: maskedEmail,
           hash: fanIdHash.substring(0, 16) + "...",
-          traits
+          traits,
+          storageTier: currentStorageTier
         });
         const event = buildEvent({
           event_name: "identify",
@@ -301,7 +390,8 @@ var BalancePixel = (() => {
           metadata: {
             email_sha256: fanIdHash,
             traits,
-            consent_preferences: consent || void 0
+            consent_preferences: consent || void 0,
+            storage_tier: currentStorageTier
           }
         });
         enqueueEvent(event);
@@ -321,9 +411,16 @@ var BalancePixel = (() => {
       enqueueEvent(event);
     }
     function init() {
+      loadConsent();
+      if (consent?.analytics === true) {
+        currentStorageTier = "local";
+        log("Storage tier: local (analytics consent granted)");
+      } else {
+        currentStorageTier = "session";
+        log("Storage tier: session (privacy by default)");
+      }
       sessionId = getOrCreateSession();
       loadFanId();
-      loadConsent();
       if (!consent) {
         consent = {
           analytics: true,
@@ -332,6 +429,7 @@ var BalancePixel = (() => {
           timestamp: (/* @__PURE__ */ new Date()).toISOString()
         };
         log("Default consent enabled (all tracking):", consent);
+        upgradeStorageTier();
       }
       captureAttribution();
       startFlushTimer();
@@ -341,9 +439,11 @@ var BalancePixel = (() => {
         sessionId,
         fanIdHash,
         consent,
+        storageTier: currentStorageTier,
         useEmulator,
         endpoint: API_ENDPOINT
       });
+      window._balanceInitialPageviewFired = true;
       trackPageView();
       window.addEventListener("beforeunload", () => {
         flush();

package/dist/index.min.js

@@ -1 +1 @@
-var BalancePixel=(()=>{var V=Object.create;var x=Object.defineProperty;var W=Object.getOwnPropertyDescriptor;var X=Object.getOwnPropertyNames;var Z=Object.getPrototypeOf,ee=Object.prototype.hasOwnProperty;var T=(n=>typeof require<"u"?require:typeof Proxy<"u"?new Proxy(n,{get:(r,o)=>(typeof require<"u"?require:r)[o]}):n)(function(n){if(typeof require<"u")return require.apply(this,arguments);throw Error('Dynamic require of "'+n+'" is not supported')});var ne=(n,r)=>{for(var o in r)x(n,o,{get:r[o],enumerable:!0})},B=(n,r,o,u)=>{if(r&&typeof r=="object"||typeof r=="function")for(let f of X(r))!ee.call(n,f)&&f!==o&&x(n,f,{get:()=>r[f],enumerable:!(u=W(r,f))||u.enumerable});return n};var te=(n,r,o)=>(o=n!=null?V(Z(n)):{},B(r||!n||!n.__esModule?x(o,"default",{value:n,enumerable:!0}):o,n)),re=n=>B(x({},"__esModule",{value:!0}),n);var me={};ne(me,{BalanceAnalytics:()=>R,getAttribution:()=>ue,getConsent:()=>ge,getFanIdHash:()=>de,getSessionId:()=>le,hasConsent:()=>pe,identify:()=>ae,page:()=>se,purchase:()=>ce,setConsent:()=>fe,track:()=>ie});var g=te(T("react")),b=T("next/navigation");function oe(){let n=(0,b.usePathname)(),r=(0,b.useSearchParams)();return(0,g.useEffect)(()=>{if(typeof window<"u"&&window.balance){let o=window.location.href,u=document.title;window.balance.page({url:o,title:u})}},[n,r]),null}function R(){return g.default.createElement(g.Suspense,{fallback:null},g.default.createElement(oe,null))}(function(){let n=document.currentScript,r=n?.dataset.artistId,o=n?.dataset.projectId,u=n?.dataset.emulator==="true",f=n?.dataset.debug==="true";if(!r){console.error("[BALANCE Pixel] Error: data-artist-id attribute is required");return}let P="balance_session_id",S="balance_session_timestamp",E="balance_attribution",C="balance_fan_id_hash",A="balance_consent",D=60*60*1e3,I=u?"http://localhost:5001/artist-os-distro/us-central1/pixelEndpoint":"https://us-central1-artist-os-distro.cloudfunctions.net/pixelEndpoint",h=null,l=null,s=null,p={},d=[],_=null,c=(...e)=>{f&&console.log("[BALANCE Pixel]",...e)};function N(){return crypto&&crypto.randomUUID?crypto.randomUUID():"xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g,e=>{let t=Math.random()*16|0;return(e==="x"?t:t&3|8).toString(16)})}function L(){try{let e=localStorage.getItem(P),t=localStorage.getItem(S);if(e&&t&&Date.now()-parseInt(t,10)<D)return localStorage.setItem(S,Date.now().toString()),e;let i=N();return localStorage.setItem(P,i),localStorage.setItem(S,Date.now().toString()),i}catch{return N()}}function z(){let e=new URLSearchParams(window.location.search),t={};return["source","medium","campaign","content","term"].forEach(i=>{let a=e.get(`utm_${i}`);a&&(t[`utm_${i}`]=a)}),t}function U(){try{let e=localStorage.getItem(E);if(e){p=JSON.parse(e),c("Loaded attribution:",p);return}let t=z();Object.keys(t).length>0&&(p=t,localStorage.setItem(E,JSON.stringify(t)),c("Captured attribution:",p))}catch{}}function F(){try{l=localStorage.getItem(C)}catch{}}function j(){try{let e=localStorage.getItem(A);e&&(s=JSON.parse(e).preferences||null,c("Loaded consent:",s))}catch{}}function H(e){let t=s;s=e;try{let a={preferences:e,method:"explicit",version:1};localStorage.setItem(A,JSON.stringify(a)),c("Consent saved:",e)}catch(a){console.error("[BALANCE Pixel] Could not save consent:",a)}let i=m({event_name:"consent_updated",metadata:{consent_preferences:e,consent_method:"explicit",previous_consent:t||void 0}});w(i)}function M(){return s}function J(e){return s?.[e]===!0}async function K(e){let t=e.toLowerCase().trim(),a=new TextEncoder().encode(t),v=await crypto.subtle.digest("SHA-256",a);return Array.from(new Uint8Array(v)).map(Q=>Q.toString(16).padStart(2,"0")).join("")}function m(e){let t={artist_id:r,fan_session_id:h,fan_id_hash:l||void 0,timestamp:new Date().toISOString(),source_url:window.location.href,referrer_url:document.referrer||void 0,user_agent:navigator.userAgent,...e,...p};return o&&!e.projectId&&(t.projectId=o),t}function w(e){d.push(e),c("Event queued:",e.event_name,"(queue:",d.length,")"),d.length>=10&&y()}async function y(){if(d.length===0)return;let e=[...d];d=[],c("Flushing",e.length,"events to",I);try{let t=await fetch(I,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({events:e}),keepalive:!0});if(!t.ok)throw new Error(`HTTP ${t.status}`);c("Events sent successfully")}catch(t){console.error("[BALANCE Pixel] Failed to send events:",t),d.length<50&&d.push(...e)}}function Y(){_&&clearInterval(_),_=window.setInterval(()=>{d.length>0&&y()},5e3)}function k(e={}){let t=m({event_name:"pageview",page_title:e.title||document.title,source_url:e.url||window.location.href});w(t)}function q(e,t={}){let i=m({event_name:"custom",metadata:{event_type:e,...t}});w(i)}async function $(e,t={}){try{l=await K(e),localStorage.setItem(C,l);let i=e.split("@"),a=i[0].charAt(0)+"***@"+(i[1]||"");c("Fan identified:",{name:t.name||"(no name)",email:a,hash:l.substring(0,16)+"...",traits:t});let v=m({event_name:"identify",fan_id_hash:l,metadata:{email_sha256:l,traits:t,consent_preferences:s||void 0}});w(v)}catch(i){console.error("[BALANCE Pixel] Failed to identify:",i)}}function G(e,t="USD",i={}){let a=m({event_name:"purchase",metadata:{revenue:e,currency:t,...i}});w(a)}function O(){h=L(),F(),j(),s||(s={analytics:!0,marketing:!0,personalization:!0,timestamp:new Date().toISOString()},c("Default consent enabled (all tracking):",s)),U(),Y(),c("Initialized",{artistId:r,projectId:o||"(none - will track to all projects)",sessionId:h,fanIdHash:l,consent:s,useEmulator:u,endpoint:I}),k(),window.addEventListener("beforeunload",()=>{y()}),document.addEventListener("visibilitychange",()=>{document.visibilityState==="hidden"&&y()})}window.balance={track:q,identify:$,page:k,purchase:G,getSessionId:()=>h,getFanIdHash:()=>l,getAttribution:()=>p,setConsent:H,getConsent:M,hasConsent:J},document.readyState==="loading"?document.addEventListener("DOMContentLoaded",O):O(),c("Pixel script loaded")})();var ie=(n,r)=>{typeof window>"u"||(window.balance?window.balance.track(n,r):console.warn("[Balance Pixel] track() called before pixel initialized:",n))},ae=(n,r)=>typeof window>"u"?Promise.resolve():window.balance?window.balance.identify(n,r):(console.warn("[Balance Pixel] identify() called before pixel initialized"),Promise.resolve()),se=n=>{typeof window>"u"||(window.balance?window.balance.page(n):console.warn("[Balance Pixel] page() called before pixel initialized"))},ce=(n,r,o)=>{typeof window>"u"||(window.balance?window.balance.purchase(n,r,o):console.warn("[Balance Pixel] purchase() called before pixel initialized"))},le=()=>typeof window>"u"?null:window.balance?.getSessionId()??null,de=()=>typeof window>"u"?null:window.balance?.getFanIdHash()??null,ue=()=>typeof window>"u"?{}:window.balance?.getAttribution()??{},fe=n=>{typeof window>"u"||(window.balance?window.balance.setConsent(n):console.warn("[Balance Pixel] setConsent() called before pixel initialized"))},ge=()=>typeof window>"u"?null:window.balance?.getConsent()??null,pe=n=>typeof window>"u"?!1:window.balance?.hasConsent(n)??!1;return re(me);})();
+var BalancePixel=(()=>{var te=Object.create;var _=Object.defineProperty;var re=Object.getOwnPropertyDescriptor;var ie=Object.getOwnPropertyNames;var oe=Object.getPrototypeOf,ae=Object.prototype.hasOwnProperty;var z=(t=>typeof require<"u"?require:typeof Proxy<"u"?new Proxy(t,{get:(i,o)=>(typeof require<"u"?require:i)[o]}):t)(function(t){if(typeof require<"u")return require.apply(this,arguments);throw Error('Dynamic require of "'+t+'" is not supported')});var se=(t,i)=>{for(var o in i)_(t,o,{get:i[o],enumerable:!0})},U=(t,i,o,d)=>{if(i&&typeof i=="object"||typeof i=="function")for(let l of ie(i))!ae.call(t,l)&&l!==o&&_(t,l,{get:()=>i[l],enumerable:!(d=re(i,l))||d.enumerable});return t};var ce=(t,i,o)=>(o=t!=null?te(oe(t)):{},U(i||!t||!t.__esModule?_(o,"default",{value:t,enumerable:!0}):o,t)),le=t=>U(_({},"__esModule",{value:!0}),t);var Se={};se(Se,{BalanceAnalytics:()=>j,getAttribution:()=>ye,getConsent:()=>xe,getFanIdHash:()=>me,getSessionId:()=>we,hasConsent:()=>be,identify:()=>ge,page:()=>fe,purchase:()=>pe,setConsent:()=>he,track:()=>de});var u=ce(z("react")),P=z("next/navigation");function ue(){let t=(0,P.usePathname)(),i=(0,P.useSearchParams)(),o=(0,u.useRef)(!0),d=(0,u.useRef)(null);return(0,u.useEffect)(()=>{if(typeof window>"u"||!window.balance)return;let l=t+(i?.toString()||"");if(d.current===l)return;if(o.current&&(o.current=!1,window._balanceInitialPageviewFired)){d.current=l,console.log("[BalanceAnalytics] Skipping initial pageview (script already fired)");return}let b=window.location.href,m=document.title;d.current=l,window.balance.page({url:b,title:m})},[t,i]),null}function j(){return u.default.createElement(u.Suspense,{fallback:null},u.default.createElement(ue,null))}(function(){let t=document.currentScript,i=t?.dataset.artistId,o=t?.dataset.projectId,d=t?.dataset.emulator==="true",l=t?.dataset.debug==="true";if(!i){console.error("[BALANCE Pixel] Error: data-artist-id attribute is required");return}let b="session_id",m="session_timestamp",N="attribution",R="fan_id_hash",O="balance_consent",H=60*60*1e3,E="balance_",A=d?"http://localhost:5001/artist-os-distro/us-central1/pixelEndpoint":"https://us-central1-artist-os-distro.cloudfunctions.net/pixelEndpoint",S=null,g=null,c=null,w={},f=[],C=null,p="session",s=(...e)=>{l&&console.log("[BALANCE Pixel]",...e)};function B(){try{return p==="local"?localStorage:sessionStorage}catch{return null}}function v(e){let n=B();if(!n)return null;try{let r=E+e,a=n.getItem(r);if(!a&&p==="session")try{a=localStorage.getItem(r)}catch{}return a}catch{return null}}function y(e,n){let r=B();if(r)try{r.setItem(E+e,n)}catch{}}function k(){if(p!=="local"){s("Upgrading storage tier: session -> local");try{let e=[];for(let n=0;n<sessionStorage.length;n++){let r=sessionStorage.key(n);r?.startsWith(E)&&e.push(r)}for(let n of e){let r=sessionStorage.getItem(n);r&&localStorage.setItem(n,r)}for(let n of e)sessionStorage.removeItem(n);p="local",s(`Storage tier upgraded, migrated ${e.length} items`)}catch(e){console.error("[BALANCE Pixel] Storage migration failed:",e)}}}function F(){return crypto&&crypto.randomUUID?crypto.randomUUID():"xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g,e=>{let n=Math.random()*16|0;return(e==="x"?n:n&3|8).toString(16)})}function M(){try{let e=v(b),n=v(m);if(e&&n&&Date.now()-parseInt(n,10)<H)return y(m,Date.now().toString()),e;let r=F();return y(b,r),y(m,Date.now().toString()),r}catch{return F()}}function K(){let e=new URLSearchParams(window.location.search),n={};return["source","medium","campaign","content","term"].forEach(r=>{let a=e.get(`utm_${r}`);a&&(n[`utm_${r}`]=a)}),n}function J(){try{let e=v(N);if(e){w=JSON.parse(e),s("Loaded attribution:",w);return}let n=K();Object.keys(n).length>0&&(w=n,y(N,JSON.stringify(n)),s("Captured attribution:",w))}catch{}}function Y(){try{g=v(R)}catch{}}function q(){try{let e=localStorage.getItem(O);e&&(c=JSON.parse(e).preferences||null,s("Loaded consent:",c))}catch{}}function $(e){let n=c;c=e;try{let a={preferences:e,method:"explicit",version:1};localStorage.setItem(O,JSON.stringify(a)),s("Consent saved:",e)}catch(a){console.error("[BALANCE Pixel] Could not save consent:",a)}e.analytics===!0&&k();let r=h({event_name:"consent_updated",metadata:{consent_preferences:e,consent_method:"explicit",previous_consent:n||void 0}});x(r)}function G(){return c}function W(e){return c?.[e]===!0}async function Q(e){let n=e.toLowerCase().trim(),a=new TextEncoder().encode(n),T=await crypto.subtle.digest("SHA-256",a);return Array.from(new Uint8Array(T)).map(ne=>ne.toString(16).padStart(2,"0")).join("")}function h(e){let n={artist_id:i,fan_session_id:S,fan_id_hash:g||void 0,timestamp:new Date().toISOString(),source_url:window.location.href,referrer_url:document.referrer||void 0,user_agent:navigator.userAgent,...e,...w};return o&&!e.projectId&&(n.projectId=o),n}function x(e){f.push(e),s("Event queued:",e.event_name,"(queue:",f.length,")"),f.length>=10&&I()}async function I(){if(f.length===0)return;let e=[...f];f=[],s("Flushing",e.length,"events to",A);try{let n=await fetch(A,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({events:e}),keepalive:!0});if(!n.ok)throw new Error(`HTTP ${n.status}`);s("Events sent successfully")}catch(n){console.error("[BALANCE Pixel] Failed to send events:",n),f.length<50&&f.push(...e)}}function V(){C&&clearInterval(C),C=window.setInterval(()=>{f.length>0&&I()},5e3)}function L(e={}){let n=h({event_name:"pageview",page_title:e.title||document.title,source_url:e.url||window.location.href});x(n)}function X(e,n={}){let r=h({event_name:"custom",metadata:{event_type:e,...n}});x(r)}async function Z(e,n={}){try{if(c&&c.analytics===!1){s("Identify skipped - user declined analytics consent");return}g=await Q(e),c?.analytics===!0&&k(),y(R,g);let r=e.split("@"),a=r[0].charAt(0)+"***@"+(r[1]||"");s("Fan identified:",{name:n.name||"(no name)",email:a,hash:g.substring(0,16)+"...",traits:n,storageTier:p});let T=h({event_name:"identify",fan_id_hash:g,metadata:{email_sha256:g,traits:n,consent_preferences:c||void 0,storage_tier:p}});x(T)}catch(r){console.error("[BALANCE Pixel] Failed to identify:",r)}}function ee(e,n="USD",r={}){let a=h({event_name:"purchase",metadata:{revenue:e,currency:n,...r}});x(a)}function D(){q(),c?.analytics===!0?(p="local",s("Storage tier: local (analytics consent granted)")):(p="session",s("Storage tier: session (privacy by default)")),S=M(),Y(),c||(c={analytics:!0,marketing:!0,personalization:!0,timestamp:new Date().toISOString()},s("Default consent enabled (all tracking):",c),k()),J(),V(),s("Initialized",{artistId:i,projectId:o||"(none - will track to all projects)",sessionId:S,fanIdHash:g,consent:c,storageTier:p,useEmulator:d,endpoint:A}),window._balanceInitialPageviewFired=!0,L(),window.addEventListener("beforeunload",()=>{I()}),document.addEventListener("visibilitychange",()=>{document.visibilityState==="hidden"&&I()})}window.balance={track:X,identify:Z,page:L,purchase:ee,getSessionId:()=>S,getFanIdHash:()=>g,getAttribution:()=>w,setConsent:$,getConsent:G,hasConsent:W},document.readyState==="loading"?document.addEventListener("DOMContentLoaded",D):D(),s("Pixel script loaded")})();var de=(t,i)=>{typeof window>"u"||(window.balance?window.balance.track(t,i):console.warn("[Balance Pixel] track() called before pixel initialized:",t))},ge=(t,i)=>typeof window>"u"?Promise.resolve():window.balance?window.balance.identify(t,i):(console.warn("[Balance Pixel] identify() called before pixel initialized"),Promise.resolve()),fe=t=>{typeof window>"u"||(window.balance?window.balance.page(t):console.warn("[Balance Pixel] page() called before pixel initialized"))},pe=(t,i,o)=>{typeof window>"u"||(window.balance?window.balance.purchase(t,i,o):console.warn("[Balance Pixel] purchase() called before pixel initialized"))},we=()=>typeof window>"u"?null:window.balance?.getSessionId()??null,me=()=>typeof window>"u"?null:window.balance?.getFanIdHash()??null,ye=()=>typeof window>"u"?{}:window.balance?.getAttribution()??{},he=t=>{typeof window>"u"||(window.balance?window.balance.setConsent(t):console.warn("[Balance Pixel] setConsent() called before pixel initialized"))},xe=()=>typeof window>"u"?null:window.balance?.getConsent()??null,be=t=>typeof window>"u"?!1:window.balance?.hasConsent(t)??!1;return le(Se);})();

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@hifilabs/pixel",
-  "version": "0.0.7",
+  "version": "0.0.9",
   "description": "BALANCE Pixel - Lightweight browser tracking script for artist fan analytics",
   "main": "./dist/index.js",
   "module": "./dist/index.esm.js",
   "types": "./dist/index.esm.d.ts",
   "publishConfig": {
-    "access": "public"
+    "access": "restricted"
   },
   "files": [
     "dist"