cryptique-sdk 1.2.23 → 1.2.24

package/lib/cjs/index.js

@@ -8172,6 +8172,12 @@ if (window.Cryptique && window.Cryptique.initialized) ; else {
         },
         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 });
         }
       };
     },
@@ -8474,620 +8480,624 @@ if (window.Cryptique && window.Cryptique.initialized) ; else {
 
 }
 
-/**
- * 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;
 }
 
 module.exports = CryptiqueSDK;