cryptique-sdk 1.2.22 → 1.2.24

package/lib/umd/index.js

@@ -572,47 +572,6 @@
         });
       },
 
-      /**
-       * Call backend to migrate all sessions from old userId to new UUID
-       * 
-       * This ensures that when a user's localStorage userId is migrated from old format
-       * to UUID v4, all their existing sessions in the database are also updated to use
-       * the new UUID, preventing session splitting.
-       * 
-       * @param {string} siteId - The site ID
-       * @param {string} oldUserId - Old format userId (e.g., "usr_abc123xyz")
-       * @param {string} newUserId - New UUID v4 userId
-       * @returns {Promise<Object>} Migration result with success status and updated count
-       */
-      async migrateUserIdOnBackend(siteId, oldUserId, newUserId) {
-        try {
-          // Construct migration endpoint URL from track endpoint
-          const migrationUrl = CONFIG.API.TRACK.replace('/track', '/migrate-user-id');
-          
-          const response = await _nativeFetch(migrationUrl, {
-            method: 'POST',
-            headers: {
-              'Content-Type': 'application/json'
-            },
-            body: JSON.stringify({
-              siteId: siteId,
-              oldUserId: oldUserId,
-              newUserId: newUserId
-            })
-          });
-          
-          if (!response.ok) {
-            const errorText = await response.text();
-            throw new Error(`Migration failed: ${response.status} - ${errorText}`);
-          }
-          
-          const result = await response.json();
-          return result;
-        } catch (error) {
-          throw error;
-        }
-      },
-
       /**
        * Get or create persistent user ID
        * 
@@ -625,11 +584,8 @@
        * - Globally unique across all sites and teams
        * - Cryptographically secure
        * - No collisions possible
-       * 
-       * MIGRATION:
-       * - Automatically migrates old format ("usr_abc123xyz") to UUID v4
-       * - Calls backend to migrate all existing sessions to new UUID
-       * - Validates UUID format on retrieval
+       *
+       * Non-UUID values in storage are replaced with a new UUID v4.
        */
       getUserId() {
         try {
@@ -640,39 +596,8 @@
             userId = this.generateUUIDv4();
             localStorage.setItem(CONFIG.STORAGE_KEYS.USER_ID, userId);
           } else {
-            // Validate format and migrate if needed
             const uuidRegex = /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
-            const oldFormatRegex = /^usr_[a-z0-9]{9}$/;
-            const oldTempFormatRegex = /^usr_temp_[a-z0-9]{9}$/;
-            
-            // Check if old format detected
-            if (oldFormatRegex.test(userId) || oldTempFormatRegex.test(userId)) {
-              const oldUserId = userId; // Store old before migration
-              const newUserId = this.generateUUIDv4(); // Generate new UUID
-              
-              
-              // CRITICAL: Store new UUID in localStorage IMMEDIATELY
-              // This prevents multiple migrations if getUserId() is called again
-              localStorage.setItem(CONFIG.STORAGE_KEYS.USER_ID, newUserId);
-              
-              // Call backend to migrate all sessions (non-blocking)
-              if (SITE_ID) {
-                this.migrateUserIdOnBackend(SITE_ID, oldUserId, newUserId)
-                  .then((result) => {
-                    if (result.success) {
-                    } else {
-                      console.warn('⚠️ Migration failed, but continuing with new UUID');
-                    }
-                  })
-                  .catch((err) => {
-                    // UUID already stored in localStorage, migration can happen later
-                  });
-              }
-              
-              // Return new UUID immediately (already stored in localStorage)
-              userId = newUserId;
-            } else if (!uuidRegex.test(userId)) {
-              // Invalid format - regenerate
+            if (!uuidRegex.test(userId)) {
               userId = this.generateUUIDv4();
               localStorage.setItem(CONFIG.STORAGE_KEYS.USER_ID, userId);
             }
@@ -2020,8 +1945,8 @@
       initialize() {
         // Ensure all required fields exist (some may already be set)
         if (!sessionData.sessionId) sessionData.sessionId = null;
-        // Get current SITE_ID (may have been set via init() after SDK loaded)
-        const currentSiteId = SITE_ID || window.Cryptique?.siteId || window.__CRYPTIQUE_SITE_ID__ || null;
+        // May have been set via init() after SDK loaded
+        const currentSiteId = getCurrentSiteId();
         if (!sessionData.siteId) sessionData.siteId = currentSiteId;
         if (!sessionData.teamId) sessionData.teamId = null;
         if (!sessionData.userId) sessionData.userId = null;
@@ -4115,7 +4040,7 @@
             utm_id: utmData.utm_id,
             session_id: sessionData.sessionId,
             wallet_address: sessionData.wallet_address,
-            siteId: SITE_ID
+            siteId: getCurrentSiteId()
           };
 
           // Send PATCH request to update wallet address
@@ -6855,7 +6780,7 @@
             return { success: false, error: 'No user ID' };
           }
 
-          if (!SITE_ID) {
+          if (!getCurrentSiteId()) {
             console.error('❌ [Identity] Site ID not found');
             return { success: false, error: 'Site ID not found' };
           }
@@ -7638,7 +7563,7 @@
           const session = StorageManager.loadSession();
           const currentDistinctId = StorageManager.getDistinctId();
           
-          if (!session || !currentDistinctId || !SITE_ID) {
+          if (!session || !currentDistinctId || !getCurrentSiteId()) {
             console.error('❌ [People] No active session or distinct ID found');
             return { success: false, error: 'No active session' };
           }
@@ -7687,7 +7612,7 @@
           const session = StorageManager.loadSession();
           const currentDistinctId = StorageManager.getDistinctId();
           
-          if (!session || !currentDistinctId || !SITE_ID) {
+          if (!session || !currentDistinctId || !getCurrentSiteId()) {
             console.error('❌ [People] No active session or distinct ID found');
             return { success: false, error: 'No active session' };
           }
@@ -7736,7 +7661,7 @@
           const session = StorageManager.loadSession();
           const currentDistinctId = StorageManager.getDistinctId();
           
-          if (!session || !currentDistinctId || !SITE_ID) {
+          if (!session || !currentDistinctId || !getCurrentSiteId()) {
             console.error('❌ [People] No active session or distinct ID found');
             return { success: false, error: 'No active session' };
           }
@@ -7791,7 +7716,7 @@
           const session = StorageManager.loadSession();
           const currentDistinctId = StorageManager.getDistinctId();
           
-          if (!session || !currentDistinctId || !SITE_ID) {
+          if (!session || !currentDistinctId || !getCurrentSiteId()) {
             console.error('❌ [People] No active session or distinct ID found');
             return { success: false, error: 'No active session' };
           }
@@ -7847,7 +7772,7 @@
           const session = StorageManager.loadSession();
           const currentDistinctId = StorageManager.getDistinctId();
           
-          if (!session || !currentDistinctId || !SITE_ID) {
+          if (!session || !currentDistinctId || !getCurrentSiteId()) {
             console.error('❌ [People] No active session or distinct ID found');
             return { success: false, error: 'No active session' };
           }
@@ -7903,7 +7828,7 @@
           const session = StorageManager.loadSession();
           const currentDistinctId = StorageManager.getDistinctId();
           
-          if (!session || !currentDistinctId || !SITE_ID) {
+          if (!session || !currentDistinctId || !getCurrentSiteId()) {
             console.error('❌ [People] No active session or distinct ID found');
             return { success: false, error: 'No active session' };
           }
@@ -7959,7 +7884,7 @@
           const session = StorageManager.loadSession();
           const currentDistinctId = StorageManager.getDistinctId();
           
-          if (!session || !currentDistinctId || !SITE_ID) {
+          if (!session || !currentDistinctId || !getCurrentSiteId()) {
             console.error('❌ [People] No active session or distinct ID found');
             return { success: false, error: 'No active session' };
           }
@@ -8010,7 +7935,7 @@
           const session = StorageManager.loadSession();
           const currentDistinctId = StorageManager.getDistinctId();
           
-          if (!session || !currentDistinctId || !SITE_ID) {
+          if (!session || !currentDistinctId || !getCurrentSiteId()) {
             console.error('❌ [People] No active session or distinct ID found');
             return { success: false, error: 'No active session' };
           }
@@ -8054,7 +7979,7 @@
           const session = StorageManager.loadSession();
           const currentDistinctId = StorageManager.getDistinctId();
           
-          if (!session || !currentDistinctId || !SITE_ID) {
+          if (!session || !currentDistinctId || !getCurrentSiteId()) {
             console.error('❌ [People] No active session or distinct ID found');
             return { success: false, error: 'No active session' };
           }
@@ -8096,7 +8021,7 @@
           const session = StorageManager.loadSession();
           const currentDistinctId = StorageManager.getDistinctId();
           
-          if (!session || !currentDistinctId || !SITE_ID) {
+          if (!session || !currentDistinctId || !getCurrentSiteId()) {
             console.error('❌ [People] No active session or distinct ID found');
             return { success: false, error: 'No active session' };
           }
@@ -8251,6 +8176,12 @@
           },
           delete() {
             return mgr._profileCall('delete', groupKey, groupId, {});
+          },
+          increment(property, value = 1) {
+            return mgr._profileCall('increment', groupKey, groupId, { property, value });
+          },
+          append(property, value) {
+            return mgr._profileCall('append', groupKey, groupId, { property, value });
           }
         };
       },
@@ -8263,7 +8194,7 @@
         try {
           const session = StorageManager.loadSession();
           const currentDistinctId = StorageManager.getDistinctId();
-          if (!session || !currentDistinctId || !SITE_ID) {
+          if (!session || !currentDistinctId || !getCurrentSiteId()) {
             console.error('❌ [Groups] No active session or distinct ID found');
             return { success: false, error: 'No active session' };
           }
@@ -8553,620 +8484,624 @@
 
   }
 
-  /**
-   * Cryptique Analytics SDK - NPM Module Entry Point
-   * 
-   * This is a thin wrapper around script/script.js that exports the SDK
-   * as a module for npm usage. All functionality remains in script.js.
-   * 
-   * The script.js file is inlined during the build process by Rollup.
-   */
-
-
-  // Create a wrapper that provides programmatic initialization
-  const CryptiqueSDK = {
-    /**
-     * Initialize the SDK programmatically
-     * @param {Object} options - Configuration options
-     * @param {string} options.siteId - Site ID (required)
-     * @param {boolean} [options.autoEvents] - Enable auto events (default: false)
-     * @param {string[]} [options.disabledPaths] - Paths to disable auto events
-     * @param {string[]} [options.disabledEvents] - Auto events to disable
-     */
-    init(options = {}) {
-      if (typeof window === 'undefined') {
-        console.warn('Cryptique SDK requires a browser environment');
-        return Promise.resolve(null);
-      }
-
-      if (!options.siteId) {
-        throw new Error('siteId is required');
-      }
-
-      // Wait for SDK to be available on window
-      const checkSDK = () => {
-        if (window.Cryptique) {
-          // Set site ID
-          window.Cryptique.siteId = options.siteId;
-
-          // Configure auto events if provided
-          if (options.autoEvents !== undefined) {
-            if (options.autoEvents) {
-              window.Cryptique.enableAutoEvents();
-            } else {
-              window.Cryptique.disableAutoEvents();
-            }
-          }
-
-          // Set disabled paths if provided
-          if (options.disabledPaths) {
-            if (window.Cryptique.setAutoEventsDisabledPaths) {
-              window.Cryptique.setAutoEventsDisabledPaths(options.disabledPaths);
-            }
-          }
-
-          // Set disabled events if provided
-          if (options.disabledEvents) {
-            if (window.Cryptique.setAutoEventsDisabledEvents) {
-              window.Cryptique.setAutoEventsDisabledEvents(options.disabledEvents);
-            }
-          }
-
-          return window.Cryptique;
-        }
-        return null;
-      };
-
-      // If SDK is already loaded, configure and return ready promise
-      if (window.Cryptique) {
-        checkSDK();
-        // Return ready() so await Cryptique.init() waits for full initialization
-        return window.Cryptique.ready ? window.Cryptique.ready() : Promise.resolve(window.Cryptique);
-      }
-
-      // Otherwise, wait for SDK to load then configure and wait for ready
-      return new Promise((resolve) => {
-        const maxAttempts = 50;
-        let attempts = 0;
-        const interval = setInterval(() => {
-          attempts++;
-          const sdk = checkSDK();
-          if (sdk) {
-            clearInterval(interval);
-            // Wait for full initialization
-            const readyPromise = sdk.ready ? sdk.ready() : Promise.resolve(sdk);
-            resolve(readyPromise);
-          } else if (attempts >= maxAttempts) {
-            clearInterval(interval);
-            resolve(null);
-          }
-        }, 100);
-      });
-    },
-
-    /**
-     * Get the SDK instance
-     * Returns window.Cryptique if available
-     */
-    getInstance() {
-      if (typeof window !== 'undefined' && window.Cryptique) {
-        return window.Cryptique;
-      }
-      return null;
-    },
-
-    /**
-     * Wait for SDK to be fully initialized
-     * Returns a Promise that resolves when initialization is complete
-     * @returns {Promise<void>}
-     */
-    ready() {
-      const instance = this.getInstance();
-      if (instance && instance.ready) {
-        return instance.ready();
-      }
-      return Promise.resolve();
-    },
-
-    /**
-     * Identify a user with a unique identifier
-     * 
-     * When called, checks if this identify_id exists for another user.
-     * If found, merges the current user_id with the existing user_id.
-     * 
-     * @param {string} identifyId - Unique identifier for the user
-     * @returns {Promise<Object>} Result object with merged status and new userId
-     */
-    async identify(identifyId) {
-      const instance = this.getInstance();
-      if (instance && instance.identify) {
-        return await instance.identify(identifyId);
-      }
-      throw new Error('SDK not initialized. Call init() first.');
-    },
-
-    /**
-     * Set wallet address for current user
-     * 
-     * If wallet address already exists for another user, merges identities.
-     * Otherwise, sets wallet address for current user.
-     * 
-     * @param {string} walletAddress - Wallet address to set
-     * @returns {Promise<Object>} Result object with merged status and new userId
-     */
-    async walletAddress(walletAddress) {
-      const instance = this.getInstance();
-      if (instance && instance.walletAddress) {
-        return await instance.walletAddress(walletAddress);
-      }
-      throw new Error('SDK not initialized. Call init() first.');
-    },
-
-    /**
-     * Reset user identity to anonymous
-     * 
-     * Generates a new anonymous distinct_id and clears identification.
-     * Useful for privacy/GDPR compliance when user wants to reset their identity.
-     * 
-     * @returns {Promise<Object>} Result object with success status and new distinctId
-     */
-    async reset() {
-      const instance = this.getInstance();
-      if (instance && instance.reset) {
-        return await instance.reset();
-      }
-      throw new Error('SDK not initialized. Call init() first.');
-    },
-
-    /**
-     * Track a custom event
-     * @param {string} eventName - Name of the event
-     * @param {Object} [properties] - Event properties
-     * @param {Object} [options] - Event options
-     * @returns {Promise<void>}
-     */
-    async track(eventName, properties, options) {
-      const instance = this.getInstance();
-      if (instance && instance.track) {
-        return await instance.track(eventName, properties, options);
-      }
-      throw new Error('SDK not initialized. Call init() first.');
-    },
-
-    /**
-     * Track a custom event (alias for track)
-     * @param {string} eventName - Name of the event
-     * @param {Object} [properties] - Event properties
-     * @param {Object} [options] - Event options
-     * @returns {Promise<void>}
-     */
-    async trackEvent(eventName, properties, options) {
-      const instance = this.getInstance();
-      if (instance && instance.trackEvent) {
-        return await instance.trackEvent(eventName, properties, options);
-      }
-      throw new Error('SDK not initialized. Call init() first.');
-    },
-
-    /**
-     * Track an auto event
-     * @param {string} eventName - Name of the auto event
-     * @param {Object} [autoEventData] - Auto event data
-     * @param {Object} [elementData] - Element data
-     * @returns {Promise<void>}
-     */
-    async trackAutoEvent(eventName, autoEventData, elementData) {
-      const instance = this.getInstance();
-      if (instance && instance.trackAutoEvent) {
-        return await instance.trackAutoEvent(eventName, autoEventData, elementData);
-      }
-      throw new Error('SDK not initialized. Call init() first.');
-    },
-
-    /**
-     * Connect wallet
-     * @returns {Promise<string|null>} Wallet address or null
-     */
-    async connectWallet() {
-      const instance = this.getInstance();
-      if (instance && instance.connectWallet) {
-        return await instance.connectWallet();
-      }
-      throw new Error('SDK not initialized. Call init() first.');
-    },
-
-    /**
-     * Check if wallet is connected
-     * @returns {Promise<boolean>}
-     */
-    async isWalletConnected() {
-      const instance = this.getInstance();
-      if (instance && instance.isWalletConnected) {
-        return await instance.isWalletConnected();
-      }
-      throw new Error('SDK not initialized. Call init() first.');
-    },
-
-    /**
-     * Update wallet info
-     * @returns {Promise<any>}
-     */
-    async updateWalletInfo() {
-      const instance = this.getInstance();
-      if (instance && instance.updateWalletInfo) {
-        return await instance.updateWalletInfo();
-      }
-      throw new Error('SDK not initialized. Call init() first.');
-    },
-
-    /**
-     * Set tracking consent
-     * @param {boolean} consent - Consent value
-     */
-    setTrackingConsent(consent) {
-      const instance = this.getInstance();
-      if (instance && instance.setTrackingConsent) {
-        return instance.setTrackingConsent(consent);
-      }
-      throw new Error('SDK not initialized. Call init() first.');
-    },
-
-    /**
-     * Get tracking consent
-     * @returns {boolean}
-     */
-    getTrackingConsent() {
-      const instance = this.getInstance();
-      if (instance && instance.getTrackingConsent) {
-        return instance.getTrackingConsent();
-      }
-      return false;
-    },
-
-    /**
-     * Get session data
-     * @returns {Object}
-     */
-    getSessionData() {
-      const instance = this.getInstance();
-      if (instance && instance.getSessionData) {
-        return instance.getSessionData();
-      }
-      return null;
-    },
-
-    /**
-     * Get chronological interactions
-     * @returns {Array}
-     */
-    getChronologicalInteractions() {
-      const instance = this.getInstance();
-      if (instance && instance.getChronologicalInteractions) {
-        return instance.getChronologicalInteractions();
-      }
-      return [];
-    },
-
-    /**
-     * Sort interactions chronologically (alias)
-     * @returns {Array}
-     */
-    sortInteractionsChronologically() {
-      const instance = this.getInstance();
-      if (instance && instance.sortInteractionsChronologically) {
-        return instance.sortInteractionsChronologically();
-      }
-      return [];
-    },
-
-    /**
-     * Enable auto events
-     */
-    enableAutoEvents() {
-      const instance = this.getInstance();
-      if (instance && instance.enableAutoEvents) {
-        return instance.enableAutoEvents();
-      }
-    },
-
-    /**
-     * Disable auto events
-     */
-    disableAutoEvents() {
-      const instance = this.getInstance();
-      if (instance && instance.disableAutoEvents) {
-        return instance.disableAutoEvents();
-      }
-    },
-
-    /**
-     * Set auto events disabled paths
-     * @param {string|string[]} paths - Paths to disable
-     */
-    setAutoEventsDisabledPaths(paths) {
-      const instance = this.getInstance();
-      if (instance && instance.setAutoEventsDisabledPaths) {
-        return instance.setAutoEventsDisabledPaths(paths);
-      }
-    },
-
-    /**
-     * Disable specific auto events
-     * @param {string|string[]} events - Event name(s) to disable
-     */
-    disableAutoEvent(events) {
-      const instance = this.getInstance();
-      if (instance && instance.disableAutoEvent) {
-        return instance.disableAutoEvent(events);
-      }
-    },
-
-    /**
-     * Enable specific auto events
-     * @param {string|string[]} events - Event name(s) to enable
-     */
-    enableAutoEvent(events) {
-      const instance = this.getInstance();
-      if (instance && instance.enableAutoEvent) {
-        return instance.enableAutoEvent(events);
-      }
-    },
-
-    /**
-     * Set auto events disabled events
-     * @param {string[]} events - Array of event names to disable
-     */
-    setAutoEventsDisabledEvents(events) {
-      const instance = this.getInstance();
-      if (instance && instance.setAutoEventsDisabledEvents) {
-        return instance.setAutoEventsDisabledEvents(events);
-      }
-    },
-
-    /**
-     * Get available auto events
-     * @returns {string[]}
-     */
-    getAvailableAutoEvents() {
-      const instance = this.getInstance();
-      if (instance && instance.getAvailableAutoEvents) {
-        return instance.getAvailableAutoEvents();
-      }
-      return [];
-    },
-
-    /**
-     * Get auto events configuration
-     * @returns {Object}
-     */
-    getAutoEventsConfig() {
-      const instance = this.getInstance();
-      if (instance && instance.getAutoEventsConfig) {
-        return instance.getAutoEventsConfig();
-      }
-      return null;
-    },
-
-    /**
-     * People object for managing user properties
-     */
-    get people() {
-      const instance = this.getInstance();
-      if (instance && instance.people) {
-        return instance.people;
-      }
-      // Return a stub object that will work once SDK is initialized
-      return {
-        set: async (properties) => {
-          const inst = this.getInstance();
-          if (inst && inst.people && inst.people.set) {
-            return await inst.people.set(properties);
-          }
-          throw new Error('SDK not initialized. Call init() first.');
-        },
-        setOnce: async (properties) => {
-          const inst = this.getInstance();
-          if (inst && inst.people && inst.people.setOnce) {
-            return await inst.people.setOnce(properties);
-          }
-          throw new Error('SDK not initialized. Call init() first.');
-        },
-        unset: async (properties) => {
-          const inst = this.getInstance();
-          if (inst && inst.people && inst.people.unset) {
-            return await inst.people.unset(properties);
-          }
-          throw new Error('SDK not initialized. Call init() first.');
-        },
-        increment: async (properties) => {
-          const inst = this.getInstance();
-          if (inst && inst.people && inst.people.increment) {
-            return await inst.people.increment(properties);
-          }
-          throw new Error('SDK not initialized. Call init() first.');
-        },
-        append: async (properties) => {
-          const inst = this.getInstance();
-          if (inst && inst.people && inst.people.append) {
-            return await inst.people.append(properties);
-          }
-          throw new Error('SDK not initialized. Call init() first.');
-        },
-        union: async (properties) => {
-          const inst = this.getInstance();
-          if (inst && inst.people && inst.people.union) {
-            return await inst.people.union(properties);
-          }
-          throw new Error('SDK not initialized. Call init() first.');
-        },
-        remove: async (properties) => {
-          const inst = this.getInstance();
-          if (inst && inst.people && inst.people.remove) {
-            return await inst.people.remove(properties);
-          }
-          throw new Error('SDK not initialized. Call init() first.');
-        },
-        trackCharge: async (amount, properties) => {
-          const inst = this.getInstance();
-          if (inst && inst.people && inst.people.trackCharge) {
-            return await inst.people.trackCharge(amount, properties);
-          }
-          throw new Error('SDK not initialized. Call init() first.');
-        },
-        clearCharges: async () => {
-          const inst = this.getInstance();
-          if (inst && inst.people && inst.people.clearCharges) {
-            return await inst.people.clearCharges();
-          }
-          throw new Error('SDK not initialized. Call init() first.');
-        },
-        deleteUser: async () => {
-          const inst = this.getInstance();
-          if (inst && inst.people && inst.people.deleteUser) {
-            return await inst.people.deleteUser();
-          }
-          throw new Error('SDK not initialized. Call init() first.');
-        }
-      };
-    },
-
-    // -------------------------------------------------------------------------
-    // Group Methods
-    // -------------------------------------------------------------------------
-
-    /**
-     * Set (overwrite) the user's group membership for a given key.
-     * @param {string} groupKey  - The group type key (e.g. 'company_id')
-     * @param {string|string[]} groupId - The group ID(s) to assign
-     * @returns {Promise<Object>}
-     */
-    async set_group(groupKey, groupId) {
-      const instance = this.getInstance();
-      if (instance && instance.set_group) {
-        return await instance.set_group(groupKey, groupId);
-      }
-      throw new Error('SDK not initialized. Call init() first.');
-    },
-
-    /**
-     * Add a group ID to an existing group key without removing current memberships.
-     * @param {string} groupKey - The group type key (e.g. 'company_id')
-     * @param {string} groupId  - The single group ID to add
-     * @returns {Promise<Object>}
-     */
-    async add_group(groupKey, groupId) {
-      const instance = this.getInstance();
-      if (instance && instance.add_group) {
-        return await instance.add_group(groupKey, groupId);
-      }
-      throw new Error('SDK not initialized. Call init() first.');
-    },
-
-    /**
-     * Remove a specific group ID from the user's group membership.
-     * @param {string} groupKey - The group type key (e.g. 'company_id')
-     * @param {string} groupId  - The group ID to remove
-     * @returns {Promise<Object>}
-     */
-    async remove_group(groupKey, groupId) {
-      const instance = this.getInstance();
-      if (instance && instance.remove_group) {
-        return await instance.remove_group(groupKey, groupId);
-      }
-      throw new Error('SDK not initialized. Call init() first.');
-    },
-
-    /**
-     * Get a group profile reference object for performing profile operations.
-     *
-     * Returns a synchronous object with the following methods:
-     *   .set(properties)           – Set group profile properties
-     *   .set_once(properties)      – Set properties only if not already set
-     *   .union(listName, values)   – Add values to a list property (no duplicates)
-     *   .remove(listName, value)   – Remove a value from a list property
-     *   .unset(property)           – Remove a property from the group profile
-     *   .delete()                  – Delete the entire group profile
-     *
-     * @param {string} groupKey - The group type key (e.g. 'company_id')
-     * @param {string} groupId  - The specific group ID
-     * @returns {Object} Group profile reference object
-     *
-     * @example
-     * const group = Cryptique.get_group('company', 'acme-corp');
-     * await group.set({ plan: 'enterprise', employees: 500 });
-     * await group.set_once({ created_at: new Date().toISOString() });
-     * await group.union('tags', ['b2b', 'saas']);
-     * await group.unset('old_property');
-     * await group.delete();
-     */
-    get_group(groupKey, groupId) {
-      const instance = this.getInstance();
-      if (instance && instance.get_group) {
-        return instance.get_group(groupKey, groupId);
-      }
-      // Return a stub whose methods all throw if SDK not yet ready
-      const notReady = () => { throw new Error('SDK not initialized. Call init() first.'); };
-      return {
-        set: notReady,
-        set_once: notReady,
-        union: notReady,
-        remove: notReady,
-        unset: notReady,
-        delete: notReady
-      };
-    }
-  };
-
-  // Proxy all methods from window.Cryptique to our export
-  // This will be populated after script.js loads
-  // Also sync properties that might not be methods
-  const syncMethods = () => {
-    if (typeof window !== 'undefined' && window.Cryptique) {
-      Object.keys(window.Cryptique).forEach(key => {
-        // Skip if we already have a custom implementation
-        if (['people', 'set_group', 'add_group', 'remove_group', 'get_group'].includes(key) || CryptiqueSDK.hasOwnProperty(key)) {
-          return;
-        }
-        
-        if (typeof window.Cryptique[key] === 'function') {
-          CryptiqueSDK[key] = window.Cryptique[key].bind(window.Cryptique);
-        } else {
-          CryptiqueSDK[key] = window.Cryptique[key];
-        }
-      });
-
-      // Sync version and siteId properties
-      if (window.Cryptique.version) {
-        CryptiqueSDK.version = window.Cryptique.version;
-      }
-      if (window.Cryptique.siteId) {
-        CryptiqueSDK.siteId = window.Cryptique.siteId;
-      }
-      if (window.Cryptique.sessionData) {
-        CryptiqueSDK.sessionData = window.Cryptique.sessionData;
-      }
-    }
-  };
-
-  // Try to sync immediately if SDK is already loaded
-  if (typeof window !== 'undefined') {
-    syncMethods();
-    
-    // Also sync after DOM loads (in case script loads async)
-    if (window.addEventListener) {
-      window.addEventListener('load', syncMethods);
-      if (document.readyState === 'loading') {
-        document.addEventListener('DOMContentLoaded', syncMethods);
-      } else {
-        syncMethods();
-      }
-    }
-  }
-
-  // Export for CommonJS
-  if (typeof module !== 'undefined' && module.exports) {
-    module.exports = CryptiqueSDK;
-    module.exports.default = CryptiqueSDK;
+  /**
+   * Cryptique Analytics SDK - NPM Module Entry Point
+   * 
+   * This is a thin wrapper around script/script.js that exports the SDK
+   * as a module for npm usage. All functionality remains in script.js.
+   * 
+   * The script.js file is inlined during the build process by Rollup.
+   */
+
+
+  // Create a wrapper that provides programmatic initialization
+  const CryptiqueSDK = {
+    /**
+     * Initialize the SDK programmatically
+     * @param {Object} options - Configuration options
+     * @param {string} options.siteId - Site ID (required)
+     * @param {boolean} [options.autoEvents] - Enable auto events (default: false)
+     * @param {string[]} [options.disabledPaths] - Paths to disable auto events
+     * @param {string[]} [options.disabledEvents] - Auto events to disable
+     */
+    init(options = {}) {
+      if (typeof window === 'undefined') {
+        console.warn('Cryptique SDK requires a browser environment');
+        return Promise.resolve(null);
+      }
+
+      if (!options.siteId) {
+        throw new Error('siteId is required');
+      }
+
+      // Wait for SDK to be available on window
+      const checkSDK = () => {
+        if (window.Cryptique) {
+          // Set site ID
+          window.Cryptique.siteId = options.siteId;
+
+          // Configure auto events if provided
+          if (options.autoEvents !== undefined) {
+            if (options.autoEvents) {
+              window.Cryptique.enableAutoEvents();
+            } else {
+              window.Cryptique.disableAutoEvents();
+            }
+          }
+
+          // Set disabled paths if provided
+          if (options.disabledPaths) {
+            if (window.Cryptique.setAutoEventsDisabledPaths) {
+              window.Cryptique.setAutoEventsDisabledPaths(options.disabledPaths);
+            }
+          }
+
+          // Set disabled events if provided
+          if (options.disabledEvents) {
+            if (window.Cryptique.setAutoEventsDisabledEvents) {
+              window.Cryptique.setAutoEventsDisabledEvents(options.disabledEvents);
+            }
+          }
+
+          return window.Cryptique;
+        }
+        return null;
+      };
+
+      // If SDK is already loaded, configure and return ready promise
+      if (window.Cryptique) {
+        checkSDK();
+        // Return ready() so await Cryptique.init() waits for full initialization
+        return window.Cryptique.ready ? window.Cryptique.ready() : Promise.resolve(window.Cryptique);
+      }
+
+      // Otherwise, wait for SDK to load then configure and wait for ready
+      return new Promise((resolve) => {
+        const maxAttempts = 50;
+        let attempts = 0;
+        const interval = setInterval(() => {
+          attempts++;
+          const sdk = checkSDK();
+          if (sdk) {
+            clearInterval(interval);
+            // Wait for full initialization
+            const readyPromise = sdk.ready ? sdk.ready() : Promise.resolve(sdk);
+            resolve(readyPromise);
+          } else if (attempts >= maxAttempts) {
+            clearInterval(interval);
+            resolve(null);
+          }
+        }, 100);
+      });
+    },
+
+    /**
+     * Get the SDK instance
+     * Returns window.Cryptique if available
+     */
+    getInstance() {
+      if (typeof window !== 'undefined' && window.Cryptique) {
+        return window.Cryptique;
+      }
+      return null;
+    },
+
+    /**
+     * Wait for SDK to be fully initialized
+     * Returns a Promise that resolves when initialization is complete
+     * @returns {Promise<void>}
+     */
+    ready() {
+      const instance = this.getInstance();
+      if (instance && instance.ready) {
+        return instance.ready();
+      }
+      return Promise.resolve();
+    },
+
+    /**
+     * Identify a user with a unique identifier
+     * 
+     * When called, checks if this identify_id exists for another user.
+     * If found, merges the current user_id with the existing user_id.
+     * 
+     * @param {string} identifyId - Unique identifier for the user
+     * @returns {Promise<Object>} Result object with merged status and new userId
+     */
+    async identify(identifyId) {
+      const instance = this.getInstance();
+      if (instance && instance.identify) {
+        return await instance.identify(identifyId);
+      }
+      throw new Error('SDK not initialized. Call init() first.');
+    },
+
+    /**
+     * Set wallet address for current user
+     * 
+     * If wallet address already exists for another user, merges identities.
+     * Otherwise, sets wallet address for current user.
+     * 
+     * @param {string} walletAddress - Wallet address to set
+     * @returns {Promise<Object>} Result object with merged status and new userId
+     */
+    async walletAddress(walletAddress) {
+      const instance = this.getInstance();
+      if (instance && instance.walletAddress) {
+        return await instance.walletAddress(walletAddress);
+      }
+      throw new Error('SDK not initialized. Call init() first.');
+    },
+
+    /**
+     * Reset user identity to anonymous
+     * 
+     * Generates a new anonymous distinct_id and clears identification.
+     * Useful for privacy/GDPR compliance when user wants to reset their identity.
+     * 
+     * @returns {Promise<Object>} Result object with success status and new distinctId
+     */
+    async reset() {
+      const instance = this.getInstance();
+      if (instance && instance.reset) {
+        return await instance.reset();
+      }
+      throw new Error('SDK not initialized. Call init() first.');
+    },
+
+    /**
+     * Track a custom event
+     * @param {string} eventName - Name of the event
+     * @param {Object} [properties] - Event properties
+     * @param {Object} [options] - Event options
+     * @returns {Promise<void>}
+     */
+    async track(eventName, properties, options) {
+      const instance = this.getInstance();
+      if (instance && instance.track) {
+        return await instance.track(eventName, properties, options);
+      }
+      throw new Error('SDK not initialized. Call init() first.');
+    },
+
+    /**
+     * Track a custom event (alias for track)
+     * @param {string} eventName - Name of the event
+     * @param {Object} [properties] - Event properties
+     * @param {Object} [options] - Event options
+     * @returns {Promise<void>}
+     */
+    async trackEvent(eventName, properties, options) {
+      const instance = this.getInstance();
+      if (instance && instance.trackEvent) {
+        return await instance.trackEvent(eventName, properties, options);
+      }
+      throw new Error('SDK not initialized. Call init() first.');
+    },
+
+    /**
+     * Track an auto event
+     * @param {string} eventName - Name of the auto event
+     * @param {Object} [autoEventData] - Auto event data
+     * @param {Object} [elementData] - Element data
+     * @returns {Promise<void>}
+     */
+    async trackAutoEvent(eventName, autoEventData, elementData) {
+      const instance = this.getInstance();
+      if (instance && instance.trackAutoEvent) {
+        return await instance.trackAutoEvent(eventName, autoEventData, elementData);
+      }
+      throw new Error('SDK not initialized. Call init() first.');
+    },
+
+    /**
+     * Connect wallet
+     * @returns {Promise<string|null>} Wallet address or null
+     */
+    async connectWallet() {
+      const instance = this.getInstance();
+      if (instance && instance.connectWallet) {
+        return await instance.connectWallet();
+      }
+      throw new Error('SDK not initialized. Call init() first.');
+    },
+
+    /**
+     * Check if wallet is connected
+     * @returns {Promise<boolean>}
+     */
+    async isWalletConnected() {
+      const instance = this.getInstance();
+      if (instance && instance.isWalletConnected) {
+        return await instance.isWalletConnected();
+      }
+      throw new Error('SDK not initialized. Call init() first.');
+    },
+
+    /**
+     * Update wallet info
+     * @returns {Promise<any>}
+     */
+    async updateWalletInfo() {
+      const instance = this.getInstance();
+      if (instance && instance.updateWalletInfo) {
+        return await instance.updateWalletInfo();
+      }
+      throw new Error('SDK not initialized. Call init() first.');
+    },
+
+    /**
+     * Set tracking consent
+     * @param {boolean} consent - Consent value
+     */
+    setTrackingConsent(consent) {
+      const instance = this.getInstance();
+      if (instance && instance.setTrackingConsent) {
+        return instance.setTrackingConsent(consent);
+      }
+      throw new Error('SDK not initialized. Call init() first.');
+    },
+
+    /**
+     * Get tracking consent
+     * @returns {boolean}
+     */
+    getTrackingConsent() {
+      const instance = this.getInstance();
+      if (instance && instance.getTrackingConsent) {
+        return instance.getTrackingConsent();
+      }
+      return false;
+    },
+
+    /**
+     * Get session data
+     * @returns {Object}
+     */
+    getSessionData() {
+      const instance = this.getInstance();
+      if (instance && instance.getSessionData) {
+        return instance.getSessionData();
+      }
+      return null;
+    },
+
+    /**
+     * Get chronological interactions
+     * @returns {Array}
+     */
+    getChronologicalInteractions() {
+      const instance = this.getInstance();
+      if (instance && instance.getChronologicalInteractions) {
+        return instance.getChronologicalInteractions();
+      }
+      return [];
+    },
+
+    /**
+     * Sort interactions chronologically (alias)
+     * @returns {Array}
+     */
+    sortInteractionsChronologically() {
+      const instance = this.getInstance();
+      if (instance && instance.sortInteractionsChronologically) {
+        return instance.sortInteractionsChronologically();
+      }
+      return [];
+    },
+
+    /**
+     * Enable auto events
+     */
+    enableAutoEvents() {
+      const instance = this.getInstance();
+      if (instance && instance.enableAutoEvents) {
+        return instance.enableAutoEvents();
+      }
+    },
+
+    /**
+     * Disable auto events
+     */
+    disableAutoEvents() {
+      const instance = this.getInstance();
+      if (instance && instance.disableAutoEvents) {
+        return instance.disableAutoEvents();
+      }
+    },
+
+    /**
+     * Set auto events disabled paths
+     * @param {string|string[]} paths - Paths to disable
+     */
+    setAutoEventsDisabledPaths(paths) {
+      const instance = this.getInstance();
+      if (instance && instance.setAutoEventsDisabledPaths) {
+        return instance.setAutoEventsDisabledPaths(paths);
+      }
+    },
+
+    /**
+     * Disable specific auto events
+     * @param {string|string[]} events - Event name(s) to disable
+     */
+    disableAutoEvent(events) {
+      const instance = this.getInstance();
+      if (instance && instance.disableAutoEvent) {
+        return instance.disableAutoEvent(events);
+      }
+    },
+
+    /**
+     * Enable specific auto events
+     * @param {string|string[]} events - Event name(s) to enable
+     */
+    enableAutoEvent(events) {
+      const instance = this.getInstance();
+      if (instance && instance.enableAutoEvent) {
+        return instance.enableAutoEvent(events);
+      }
+    },
+
+    /**
+     * Set auto events disabled events
+     * @param {string[]} events - Array of event names to disable
+     */
+    setAutoEventsDisabledEvents(events) {
+      const instance = this.getInstance();
+      if (instance && instance.setAutoEventsDisabledEvents) {
+        return instance.setAutoEventsDisabledEvents(events);
+      }
+    },
+
+    /**
+     * Get available auto events
+     * @returns {string[]}
+     */
+    getAvailableAutoEvents() {
+      const instance = this.getInstance();
+      if (instance && instance.getAvailableAutoEvents) {
+        return instance.getAvailableAutoEvents();
+      }
+      return [];
+    },
+
+    /**
+     * Get auto events configuration
+     * @returns {Object}
+     */
+    getAutoEventsConfig() {
+      const instance = this.getInstance();
+      if (instance && instance.getAutoEventsConfig) {
+        return instance.getAutoEventsConfig();
+      }
+      return null;
+    },
+
+    /**
+     * People object for managing user properties
+     */
+    get people() {
+      const instance = this.getInstance();
+      if (instance && instance.people) {
+        return instance.people;
+      }
+      // Return a stub object that will work once SDK is initialized
+      return {
+        set: async (properties) => {
+          const inst = this.getInstance();
+          if (inst && inst.people && inst.people.set) {
+            return await inst.people.set(properties);
+          }
+          throw new Error('SDK not initialized. Call init() first.');
+        },
+        setOnce: async (properties) => {
+          const inst = this.getInstance();
+          if (inst && inst.people && inst.people.setOnce) {
+            return await inst.people.setOnce(properties);
+          }
+          throw new Error('SDK not initialized. Call init() first.');
+        },
+        unset: async (properties) => {
+          const inst = this.getInstance();
+          if (inst && inst.people && inst.people.unset) {
+            return await inst.people.unset(properties);
+          }
+          throw new Error('SDK not initialized. Call init() first.');
+        },
+        increment: async (key, amount) => {
+          const inst = this.getInstance();
+          if (inst && inst.people && inst.people.increment) {
+            return await inst.people.increment(key, amount);
+          }
+          throw new Error('SDK not initialized. Call init() first.');
+        },
+        append: async (key, values) => {
+          const inst = this.getInstance();
+          if (inst && inst.people && inst.people.append) {
+            return await inst.people.append(key, values);
+          }
+          throw new Error('SDK not initialized. Call init() first.');
+        },
+        union: async (key, values) => {
+          const inst = this.getInstance();
+          if (inst && inst.people && inst.people.union) {
+            return await inst.people.union(key, values);
+          }
+          throw new Error('SDK not initialized. Call init() first.');
+        },
+        remove: async (key, values) => {
+          const inst = this.getInstance();
+          if (inst && inst.people && inst.people.remove) {
+            return await inst.people.remove(key, values);
+          }
+          throw new Error('SDK not initialized. Call init() first.');
+        },
+        trackCharge: async (amount, properties) => {
+          const inst = this.getInstance();
+          if (inst && inst.people && inst.people.trackCharge) {
+            return await inst.people.trackCharge(amount, properties);
+          }
+          throw new Error('SDK not initialized. Call init() first.');
+        },
+        clearCharges: async () => {
+          const inst = this.getInstance();
+          if (inst && inst.people && inst.people.clearCharges) {
+            return await inst.people.clearCharges();
+          }
+          throw new Error('SDK not initialized. Call init() first.');
+        },
+        deleteUser: async () => {
+          const inst = this.getInstance();
+          if (inst && inst.people && inst.people.deleteUser) {
+            return await inst.people.deleteUser();
+          }
+          throw new Error('SDK not initialized. Call init() first.');
+        }
+      };
+    },
+
+    // -------------------------------------------------------------------------
+    // Group Methods
+    // -------------------------------------------------------------------------
+
+    /**
+     * Set (overwrite) the user's group membership for a given key.
+     * @param {string} groupKey  - The group type key (e.g. 'company_id')
+     * @param {string|string[]} groupId - The group ID(s) to assign
+     * @returns {Promise<Object>}
+     */
+    async set_group(groupKey, groupId) {
+      const instance = this.getInstance();
+      if (instance && instance.set_group) {
+        return await instance.set_group(groupKey, groupId);
+      }
+      throw new Error('SDK not initialized. Call init() first.');
+    },
+
+    /**
+     * Add a group ID to an existing group key without removing current memberships.
+     * @param {string} groupKey - The group type key (e.g. 'company_id')
+     * @param {string} groupId  - The single group ID to add
+     * @returns {Promise<Object>}
+     */
+    async add_group(groupKey, groupId) {
+      const instance = this.getInstance();
+      if (instance && instance.add_group) {
+        return await instance.add_group(groupKey, groupId);
+      }
+      throw new Error('SDK not initialized. Call init() first.');
+    },
+
+    /**
+     * Remove a specific group ID from the user's group membership.
+     * @param {string} groupKey - The group type key (e.g. 'company_id')
+     * @param {string} groupId  - The group ID to remove
+     * @returns {Promise<Object>}
+     */
+    async remove_group(groupKey, groupId) {
+      const instance = this.getInstance();
+      if (instance && instance.remove_group) {
+        return await instance.remove_group(groupKey, groupId);
+      }
+      throw new Error('SDK not initialized. Call init() first.');
+    },
+
+    /**
+     * Get a group profile reference object for performing profile operations.
+     *
+     * Returns a synchronous object with the following methods:
+     *   .set(properties)           – Set group profile properties
+     *   .set_once(properties)      – Set properties only if not already set
+     *   .union(listName, values)   – Add values to a list property (no duplicates)
+     *   .remove(listName, value)   – Remove a value from a list property
+     *   .unset(property)           – Remove a property from the group profile
+     *   .increment(property, value) – Increment a numeric group property (default +1)
+     *   .append(property, value)   – Append a value to a list property on the group
+     *   .delete()                  – Delete the entire group profile
+     *
+     * @param {string} groupKey - The group type key (e.g. 'company_id')
+     * @param {string} groupId  - The specific group ID
+     * @returns {Object} Group profile reference object
+     *
+     * @example
+     * const group = Cryptique.get_group('company', 'acme-corp');
+     * await group.set({ plan: 'enterprise', employees: 500 });
+     * await group.set_once({ created_at: new Date().toISOString() });
+     * await group.union('tags', ['b2b', 'saas']);
+     * await group.unset('old_property');
+     * await group.delete();
+     */
+    get_group(groupKey, groupId) {
+      const instance = this.getInstance();
+      if (instance && instance.get_group) {
+        return instance.get_group(groupKey, groupId);
+      }
+      // Return a stub whose methods all throw if SDK not yet ready
+      const notReady = () => { throw new Error('SDK not initialized. Call init() first.'); };
+      return {
+        set: notReady,
+        set_once: notReady,
+        union: notReady,
+        remove: notReady,
+        unset: notReady,
+        increment: notReady,
+        append: notReady,
+        delete: notReady
+      };
+    }
+  };
+
+  // Proxy all methods from window.Cryptique to our export
+  // This will be populated after script.js loads
+  // Also sync properties that might not be methods
+  const syncMethods = () => {
+    if (typeof window !== 'undefined' && window.Cryptique) {
+      Object.keys(window.Cryptique).forEach(key => {
+        // Skip if we already have a custom implementation
+        if (['people', 'set_group', 'add_group', 'remove_group', 'get_group'].includes(key) || CryptiqueSDK.hasOwnProperty(key)) {
+          return;
+        }
+        
+        if (typeof window.Cryptique[key] === 'function') {
+          CryptiqueSDK[key] = window.Cryptique[key].bind(window.Cryptique);
+        } else {
+          CryptiqueSDK[key] = window.Cryptique[key];
+        }
+      });
+
+      // Sync version and siteId properties
+      if (window.Cryptique.version) {
+        CryptiqueSDK.version = window.Cryptique.version;
+      }
+      if (window.Cryptique.siteId) {
+        CryptiqueSDK.siteId = window.Cryptique.siteId;
+      }
+      if (window.Cryptique.sessionData) {
+        CryptiqueSDK.sessionData = window.Cryptique.sessionData;
+      }
+    }
+  };
+
+  // Try to sync immediately if SDK is already loaded
+  if (typeof window !== 'undefined') {
+    syncMethods();
+    
+    // Also sync after DOM loads (in case script loads async)
+    if (window.addEventListener) {
+      window.addEventListener('load', syncMethods);
+      if (document.readyState === 'loading') {
+        document.addEventListener('DOMContentLoaded', syncMethods);
+      } else {
+        syncMethods();
+      }
+    }
+  }
+
+  // Export for CommonJS
+  if (typeof module !== 'undefined' && module.exports) {
+    module.exports = CryptiqueSDK;
+    module.exports.default = CryptiqueSDK;
   }
 
   return CryptiqueSDK;