cryptique-sdk 1.0.3 → 1.0.4

package/lib/cjs/index.js

@@ -65,6 +65,7 @@ if (window.Cryptique && window.Cryptique.initialized) ; else {
       SESSION: 'cryptique_session',                    // Primary session storage (sessionStorage)
       SESSION_BACKUP: 'cryptique_session_backup',      // Backup session (localStorage)
       USER_ID: 'mtm_user_id',                          // Persistent user ID (localStorage)
+      DISTINCT_ID: 'cryptique_distinct_id',            // Primary identity (sessionStorage)
       CONSENT: 'mtm_consent',                          // User consent flag (localStorage)
       REFERRER: 'referrer',                            // Stored referrer (localStorage)
       LAST_SESSION: 'cryptique_last_session'           // Last session backup (localStorage)
@@ -483,6 +484,71 @@ if (window.Cryptique && window.Cryptique.initialized) ; else {
       }
     },
 
+    /**
+     * Generate anonymous distinct_id (long and unique)
+     * Format: anon_{timestamp}_{userId}_{uuid}_{random}
+     * 
+     * @param {string} userId - User ID to include in distinct_id
+     * @returns {string} Anonymous distinct_id
+     */
+    generateAnonymousDistinctId(userId) {
+      const timestamp = Date.now();
+      const random = Math.random().toString(36).substring(2, 18);
+      const uuid = this.generateUUIDv4();
+      return `anon_${timestamp}_${userId}_${uuid}_${random}`;
+    },
+
+    /**
+     * Generate identified distinct_id
+     * Format: id_{identifyId}
+     * 
+     * @param {string} identifyId - Identify ID (email, username, etc.)
+     * @returns {string} Identified distinct_id
+     */
+    generateIdentifiedDistinctId(identifyId) {
+      return `id_${identifyId}`;
+    },
+
+    /**
+     * Get or create distinct_id
+     * Checks sessionStorage first, then generates new anonymous distinct_id if not found
+     * 
+     * @returns {string} Current distinct_id
+     */
+    getDistinctId() {
+      try {
+        // Check sessionStorage first (primary source)
+        let distinctId = sessionStorage.getItem(CONFIG.STORAGE_KEYS.DISTINCT_ID);
+        
+        if (!distinctId) {
+          // Generate new anonymous distinct_id
+          const userId = this.getUserId();
+          distinctId = this.generateAnonymousDistinctId(userId);
+          sessionStorage.setItem(CONFIG.STORAGE_KEYS.DISTINCT_ID, distinctId);
+        }
+        
+        return distinctId;
+      } catch (err) {
+        // Fallback: generate temporary distinct_id
+        console.warn('Failed to access sessionStorage for distinct_id:', err);
+        const userId = this.getUserId();
+        return this.generateAnonymousDistinctId(userId);
+      }
+    },
+
+    /**
+     * Set distinct_id in sessionStorage
+     * 
+     * @param {string} distinctId - Distinct ID to set
+     */
+    setDistinctId(distinctId) {
+      try {
+        sessionStorage.setItem(CONFIG.STORAGE_KEYS.DISTINCT_ID, distinctId);
+      } catch (err) {
+        console.warn('Failed to set distinct_id:', err);
+      }
+    },
+
     /**
      * Get user consent status
      * 
@@ -5877,6 +5943,9 @@ if (window.Cryptique && window.Cryptique.initialized) ; else {
           return { success: false, error: 'Site ID not found' };
         }
 
+        // Get current distinct_id
+        const currentDistinctId = StorageManager.getDistinctId();
+
         // Call API endpoint
         const apiUrl = CONFIG.API.TRACK.replace('/track', '/identify');
         const response = await fetch(apiUrl, {
@@ -5889,6 +5958,7 @@ if (window.Cryptique && window.Cryptique.initialized) ; else {
             siteId: getCurrentSiteId(),
             sessionId: session.id,
             userId: currentUserId,
+            distinctId: currentDistinctId, // NEW: Pass distinct_id
             identifyId: identifyId.trim()
           })
         });
@@ -5905,20 +5975,31 @@ if (window.Cryptique && window.Cryptique.initialized) ; else {
 
         const result = await response.json();
 
-        // If merge occurred, update localStorage and session data
-        if (result.merged && result.newUserId) {
-          // Update localStorage with new user ID
-          localStorage.setItem(CONFIG.STORAGE_KEYS.USER_ID, result.newUserId);
+        // If merge occurred or distinct_id changed, update sessionStorage and session data
+        if (result.merged && result.newDistinctId) {
+          // Update sessionStorage with new distinct_id
+          StorageManager.setDistinctId(result.newDistinctId);
           
           // Update session data
-          sessionData.userId = result.newUserId;
-          session.userId = result.newUserId;
-          StorageManager.saveSession(session);
+          if (sessionData) {
+            sessionData.distinctId = result.newDistinctId;
+            sessionData.anonymous = false;
+            sessionData.identified = true;
+          }
           
-          // Update userSession
-          userSession.userId = result.newUserId;
+          console.log(`✅ [Identity] Distinct ID merged: ${currentDistinctId} → ${result.newDistinctId}`);
+        } else if (result.distinctId) {
+          // Update to identified distinct_id
+          StorageManager.setDistinctId(result.distinctId);
+          
+          // Update session data
+          if (sessionData) {
+            sessionData.distinctId = result.distinctId;
+            sessionData.anonymous = false;
+            sessionData.identified = true;
+          }
           
-          console.log(`✅ [Identity] User merged: ${currentUserId} → ${result.newUserId}`);
+          console.log(`✅ [Identity] Distinct ID updated: ${currentDistinctId} → ${result.distinctId}`);
         }
 
         return result;
@@ -5928,6 +6009,53 @@ if (window.Cryptique && window.Cryptique.initialized) ; else {
       }
     },
 
+    /**
+     * Reset identity (logout/anonymous)
+     * Generates new anonymous distinct_id and clears identified state
+     * 
+     * @returns {Promise<Object>} Result object with new distinct_id
+     */
+    async reset() {
+      try {
+        // Generate new anonymous distinct_id
+        const userId = StorageManager.getUserId();
+        const newDistinctId = StorageManager.generateAnonymousDistinctId(userId);
+        
+        // Update sessionStorage
+        StorageManager.setDistinctId(newDistinctId);
+        
+        // Update session data
+        const session = StorageManager.loadSession();
+        if (session) {
+          session.distinctId = newDistinctId;
+          session.anonymous = true;
+          session.identified = false;
+          StorageManager.saveSession(session);
+        }
+        
+        // Update sessionData if available
+        if (sessionData) {
+          sessionData.distinctId = newDistinctId;
+          sessionData.anonymous = true;
+          sessionData.identified = false;
+        }
+        
+        // Clear identify_id from storage (if stored separately)
+        try {
+          sessionStorage.removeItem('cryptique_identify_id');
+        } catch (err) {
+          // Ignore errors
+        }
+        
+        console.log(`🔄 [Identity] Reset to anonymous: ${newDistinctId}`);
+        
+        return { success: true, distinctId: newDistinctId };
+      } catch (error) {
+        console.error('❌ [Identity] Error in reset():', error);
+        return { success: false, error: error.message };
+      }
+    },
+
     /**
      * Set wallet address for current user
      * 
@@ -5975,6 +6103,9 @@ if (window.Cryptique && window.Cryptique.initialized) ; else {
 
         console.log(`✅ [Identity] Wallet address set in sessionData: ${trimmedWalletAddress}`);
 
+        // Get current distinct_id
+        const currentDistinctId = StorageManager.getDistinctId();
+
         // Call API endpoint to update user_identity and session in database
         // This handles merging and immediate session update if session exists
         const apiUrl = CONFIG.API.TRACK.replace('/track', '/wallet-address');
@@ -5988,6 +6119,7 @@ if (window.Cryptique && window.Cryptique.initialized) ; else {
             siteId: getCurrentSiteId(),
             sessionId: session.id,
             userId: currentUserId,
+            distinctId: currentDistinctId, // NEW: Pass distinct_id
             walletAddress: trimmedWalletAddress
           })
         });
@@ -6976,6 +7108,7 @@ if (window.Cryptique && window.Cryptique.initialized) ; else {
     // Identity Functions
     identify: IdentityManager.identify.bind(IdentityManager),
     walletAddress: IdentityManager.walletAddress.bind(IdentityManager),
+    reset: IdentityManager.reset.bind(IdentityManager),
     
     // People Functions (Custom Properties)
     people: {
@@ -7291,6 +7424,22 @@ const CryptiqueSDK = {
     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

package/lib/esm/index.js

@@ -63,6 +63,7 @@ if (window.Cryptique && window.Cryptique.initialized) ; else {
       SESSION: 'cryptique_session',                    // Primary session storage (sessionStorage)
       SESSION_BACKUP: 'cryptique_session_backup',      // Backup session (localStorage)
       USER_ID: 'mtm_user_id',                          // Persistent user ID (localStorage)
+      DISTINCT_ID: 'cryptique_distinct_id',            // Primary identity (sessionStorage)
       CONSENT: 'mtm_consent',                          // User consent flag (localStorage)
       REFERRER: 'referrer',                            // Stored referrer (localStorage)
       LAST_SESSION: 'cryptique_last_session'           // Last session backup (localStorage)
@@ -481,6 +482,71 @@ if (window.Cryptique && window.Cryptique.initialized) ; else {
       }
     },
 
+    /**
+     * Generate anonymous distinct_id (long and unique)
+     * Format: anon_{timestamp}_{userId}_{uuid}_{random}
+     * 
+     * @param {string} userId - User ID to include in distinct_id
+     * @returns {string} Anonymous distinct_id
+     */
+    generateAnonymousDistinctId(userId) {
+      const timestamp = Date.now();
+      const random = Math.random().toString(36).substring(2, 18);
+      const uuid = this.generateUUIDv4();
+      return `anon_${timestamp}_${userId}_${uuid}_${random}`;
+    },
+
+    /**
+     * Generate identified distinct_id
+     * Format: id_{identifyId}
+     * 
+     * @param {string} identifyId - Identify ID (email, username, etc.)
+     * @returns {string} Identified distinct_id
+     */
+    generateIdentifiedDistinctId(identifyId) {
+      return `id_${identifyId}`;
+    },
+
+    /**
+     * Get or create distinct_id
+     * Checks sessionStorage first, then generates new anonymous distinct_id if not found
+     * 
+     * @returns {string} Current distinct_id
+     */
+    getDistinctId() {
+      try {
+        // Check sessionStorage first (primary source)
+        let distinctId = sessionStorage.getItem(CONFIG.STORAGE_KEYS.DISTINCT_ID);
+        
+        if (!distinctId) {
+          // Generate new anonymous distinct_id
+          const userId = this.getUserId();
+          distinctId = this.generateAnonymousDistinctId(userId);
+          sessionStorage.setItem(CONFIG.STORAGE_KEYS.DISTINCT_ID, distinctId);
+        }
+        
+        return distinctId;
+      } catch (err) {
+        // Fallback: generate temporary distinct_id
+        console.warn('Failed to access sessionStorage for distinct_id:', err);
+        const userId = this.getUserId();
+        return this.generateAnonymousDistinctId(userId);
+      }
+    },
+
+    /**
+     * Set distinct_id in sessionStorage
+     * 
+     * @param {string} distinctId - Distinct ID to set
+     */
+    setDistinctId(distinctId) {
+      try {
+        sessionStorage.setItem(CONFIG.STORAGE_KEYS.DISTINCT_ID, distinctId);
+      } catch (err) {
+        console.warn('Failed to set distinct_id:', err);
+      }
+    },
+
     /**
      * Get user consent status
      * 
@@ -5875,6 +5941,9 @@ if (window.Cryptique && window.Cryptique.initialized) ; else {
           return { success: false, error: 'Site ID not found' };
         }
 
+        // Get current distinct_id
+        const currentDistinctId = StorageManager.getDistinctId();
+
         // Call API endpoint
         const apiUrl = CONFIG.API.TRACK.replace('/track', '/identify');
         const response = await fetch(apiUrl, {
@@ -5887,6 +5956,7 @@ if (window.Cryptique && window.Cryptique.initialized) ; else {
             siteId: getCurrentSiteId(),
             sessionId: session.id,
             userId: currentUserId,
+            distinctId: currentDistinctId, // NEW: Pass distinct_id
             identifyId: identifyId.trim()
           })
         });
@@ -5903,20 +5973,31 @@ if (window.Cryptique && window.Cryptique.initialized) ; else {
 
         const result = await response.json();
 
-        // If merge occurred, update localStorage and session data
-        if (result.merged && result.newUserId) {
-          // Update localStorage with new user ID
-          localStorage.setItem(CONFIG.STORAGE_KEYS.USER_ID, result.newUserId);
+        // If merge occurred or distinct_id changed, update sessionStorage and session data
+        if (result.merged && result.newDistinctId) {
+          // Update sessionStorage with new distinct_id
+          StorageManager.setDistinctId(result.newDistinctId);
           
           // Update session data
-          sessionData.userId = result.newUserId;
-          session.userId = result.newUserId;
-          StorageManager.saveSession(session);
+          if (sessionData) {
+            sessionData.distinctId = result.newDistinctId;
+            sessionData.anonymous = false;
+            sessionData.identified = true;
+          }
           
-          // Update userSession
-          userSession.userId = result.newUserId;
+          console.log(`✅ [Identity] Distinct ID merged: ${currentDistinctId} → ${result.newDistinctId}`);
+        } else if (result.distinctId) {
+          // Update to identified distinct_id
+          StorageManager.setDistinctId(result.distinctId);
+          
+          // Update session data
+          if (sessionData) {
+            sessionData.distinctId = result.distinctId;
+            sessionData.anonymous = false;
+            sessionData.identified = true;
+          }
           
-          console.log(`✅ [Identity] User merged: ${currentUserId} → ${result.newUserId}`);
+          console.log(`✅ [Identity] Distinct ID updated: ${currentDistinctId} → ${result.distinctId}`);
         }
 
         return result;
@@ -5926,6 +6007,53 @@ if (window.Cryptique && window.Cryptique.initialized) ; else {
       }
     },
 
+    /**
+     * Reset identity (logout/anonymous)
+     * Generates new anonymous distinct_id and clears identified state
+     * 
+     * @returns {Promise<Object>} Result object with new distinct_id
+     */
+    async reset() {
+      try {
+        // Generate new anonymous distinct_id
+        const userId = StorageManager.getUserId();
+        const newDistinctId = StorageManager.generateAnonymousDistinctId(userId);
+        
+        // Update sessionStorage
+        StorageManager.setDistinctId(newDistinctId);
+        
+        // Update session data
+        const session = StorageManager.loadSession();
+        if (session) {
+          session.distinctId = newDistinctId;
+          session.anonymous = true;
+          session.identified = false;
+          StorageManager.saveSession(session);
+        }
+        
+        // Update sessionData if available
+        if (sessionData) {
+          sessionData.distinctId = newDistinctId;
+          sessionData.anonymous = true;
+          sessionData.identified = false;
+        }
+        
+        // Clear identify_id from storage (if stored separately)
+        try {
+          sessionStorage.removeItem('cryptique_identify_id');
+        } catch (err) {
+          // Ignore errors
+        }
+        
+        console.log(`🔄 [Identity] Reset to anonymous: ${newDistinctId}`);
+        
+        return { success: true, distinctId: newDistinctId };
+      } catch (error) {
+        console.error('❌ [Identity] Error in reset():', error);
+        return { success: false, error: error.message };
+      }
+    },
+
     /**
      * Set wallet address for current user
      * 
@@ -5973,6 +6101,9 @@ if (window.Cryptique && window.Cryptique.initialized) ; else {
 
         console.log(`✅ [Identity] Wallet address set in sessionData: ${trimmedWalletAddress}`);
 
+        // Get current distinct_id
+        const currentDistinctId = StorageManager.getDistinctId();
+
         // Call API endpoint to update user_identity and session in database
         // This handles merging and immediate session update if session exists
         const apiUrl = CONFIG.API.TRACK.replace('/track', '/wallet-address');
@@ -5986,6 +6117,7 @@ if (window.Cryptique && window.Cryptique.initialized) ; else {
             siteId: getCurrentSiteId(),
             sessionId: session.id,
             userId: currentUserId,
+            distinctId: currentDistinctId, // NEW: Pass distinct_id
             walletAddress: trimmedWalletAddress
           })
         });
@@ -6974,6 +7106,7 @@ if (window.Cryptique && window.Cryptique.initialized) ; else {
     // Identity Functions
     identify: IdentityManager.identify.bind(IdentityManager),
     walletAddress: IdentityManager.walletAddress.bind(IdentityManager),
+    reset: IdentityManager.reset.bind(IdentityManager),
     
     // People Functions (Custom Properties)
     people: {
@@ -7289,6 +7422,22 @@ const CryptiqueSDK = {
     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

package/lib/types/index.d.ts

@@ -149,6 +149,12 @@ export default class CryptiqueSDK {
    */
   walletAddress(walletAddress: string): Promise<{ success: boolean; merged?: boolean; newUserId?: string; error?: string }>;
 
+  /**
+   * Reset user identity to anonymous
+   * Generates a new anonymous distinct_id and clears identification
+   */
+  reset(): Promise<{ success: boolean; distinctId?: string; error?: string }>;
+
   /**
    * Set tracking consent
    */

package/lib/umd/index.js

@@ -69,6 +69,7 @@
         SESSION: 'cryptique_session',                    // Primary session storage (sessionStorage)
         SESSION_BACKUP: 'cryptique_session_backup',      // Backup session (localStorage)
         USER_ID: 'mtm_user_id',                          // Persistent user ID (localStorage)
+        DISTINCT_ID: 'cryptique_distinct_id',            // Primary identity (sessionStorage)
         CONSENT: 'mtm_consent',                          // User consent flag (localStorage)
         REFERRER: 'referrer',                            // Stored referrer (localStorage)
         LAST_SESSION: 'cryptique_last_session'           // Last session backup (localStorage)
@@ -487,6 +488,71 @@
         }
       },
 
+      /**
+       * Generate anonymous distinct_id (long and unique)
+       * Format: anon_{timestamp}_{userId}_{uuid}_{random}
+       * 
+       * @param {string} userId - User ID to include in distinct_id
+       * @returns {string} Anonymous distinct_id
+       */
+      generateAnonymousDistinctId(userId) {
+        const timestamp = Date.now();
+        const random = Math.random().toString(36).substring(2, 18);
+        const uuid = this.generateUUIDv4();
+        return `anon_${timestamp}_${userId}_${uuid}_${random}`;
+      },
+
+      /**
+       * Generate identified distinct_id
+       * Format: id_{identifyId}
+       * 
+       * @param {string} identifyId - Identify ID (email, username, etc.)
+       * @returns {string} Identified distinct_id
+       */
+      generateIdentifiedDistinctId(identifyId) {
+        return `id_${identifyId}`;
+      },
+
+      /**
+       * Get or create distinct_id
+       * Checks sessionStorage first, then generates new anonymous distinct_id if not found
+       * 
+       * @returns {string} Current distinct_id
+       */
+      getDistinctId() {
+        try {
+          // Check sessionStorage first (primary source)
+          let distinctId = sessionStorage.getItem(CONFIG.STORAGE_KEYS.DISTINCT_ID);
+          
+          if (!distinctId) {
+            // Generate new anonymous distinct_id
+            const userId = this.getUserId();
+            distinctId = this.generateAnonymousDistinctId(userId);
+            sessionStorage.setItem(CONFIG.STORAGE_KEYS.DISTINCT_ID, distinctId);
+          }
+          
+          return distinctId;
+        } catch (err) {
+          // Fallback: generate temporary distinct_id
+          console.warn('Failed to access sessionStorage for distinct_id:', err);
+          const userId = this.getUserId();
+          return this.generateAnonymousDistinctId(userId);
+        }
+      },
+
+      /**
+       * Set distinct_id in sessionStorage
+       * 
+       * @param {string} distinctId - Distinct ID to set
+       */
+      setDistinctId(distinctId) {
+        try {
+          sessionStorage.setItem(CONFIG.STORAGE_KEYS.DISTINCT_ID, distinctId);
+        } catch (err) {
+          console.warn('Failed to set distinct_id:', err);
+        }
+      },
+
       /**
        * Get user consent status
        * 
@@ -5881,6 +5947,9 @@
             return { success: false, error: 'Site ID not found' };
           }
 
+          // Get current distinct_id
+          const currentDistinctId = StorageManager.getDistinctId();
+
           // Call API endpoint
           const apiUrl = CONFIG.API.TRACK.replace('/track', '/identify');
           const response = await fetch(apiUrl, {
@@ -5893,6 +5962,7 @@
               siteId: getCurrentSiteId(),
               sessionId: session.id,
               userId: currentUserId,
+              distinctId: currentDistinctId, // NEW: Pass distinct_id
               identifyId: identifyId.trim()
             })
           });
@@ -5909,20 +5979,31 @@
 
           const result = await response.json();
 
-          // If merge occurred, update localStorage and session data
-          if (result.merged && result.newUserId) {
-            // Update localStorage with new user ID
-            localStorage.setItem(CONFIG.STORAGE_KEYS.USER_ID, result.newUserId);
+          // If merge occurred or distinct_id changed, update sessionStorage and session data
+          if (result.merged && result.newDistinctId) {
+            // Update sessionStorage with new distinct_id
+            StorageManager.setDistinctId(result.newDistinctId);
             
             // Update session data
-            sessionData.userId = result.newUserId;
-            session.userId = result.newUserId;
-            StorageManager.saveSession(session);
+            if (sessionData) {
+              sessionData.distinctId = result.newDistinctId;
+              sessionData.anonymous = false;
+              sessionData.identified = true;
+            }
             
-            // Update userSession
-            userSession.userId = result.newUserId;
+            console.log(`✅ [Identity] Distinct ID merged: ${currentDistinctId} → ${result.newDistinctId}`);
+          } else if (result.distinctId) {
+            // Update to identified distinct_id
+            StorageManager.setDistinctId(result.distinctId);
+            
+            // Update session data
+            if (sessionData) {
+              sessionData.distinctId = result.distinctId;
+              sessionData.anonymous = false;
+              sessionData.identified = true;
+            }
             
-            console.log(`✅ [Identity] User merged: ${currentUserId} → ${result.newUserId}`);
+            console.log(`✅ [Identity] Distinct ID updated: ${currentDistinctId} → ${result.distinctId}`);
           }
 
           return result;
@@ -5932,6 +6013,53 @@
         }
       },
 
+      /**
+       * Reset identity (logout/anonymous)
+       * Generates new anonymous distinct_id and clears identified state
+       * 
+       * @returns {Promise<Object>} Result object with new distinct_id
+       */
+      async reset() {
+        try {
+          // Generate new anonymous distinct_id
+          const userId = StorageManager.getUserId();
+          const newDistinctId = StorageManager.generateAnonymousDistinctId(userId);
+          
+          // Update sessionStorage
+          StorageManager.setDistinctId(newDistinctId);
+          
+          // Update session data
+          const session = StorageManager.loadSession();
+          if (session) {
+            session.distinctId = newDistinctId;
+            session.anonymous = true;
+            session.identified = false;
+            StorageManager.saveSession(session);
+          }
+          
+          // Update sessionData if available
+          if (sessionData) {
+            sessionData.distinctId = newDistinctId;
+            sessionData.anonymous = true;
+            sessionData.identified = false;
+          }
+          
+          // Clear identify_id from storage (if stored separately)
+          try {
+            sessionStorage.removeItem('cryptique_identify_id');
+          } catch (err) {
+            // Ignore errors
+          }
+          
+          console.log(`🔄 [Identity] Reset to anonymous: ${newDistinctId}`);
+          
+          return { success: true, distinctId: newDistinctId };
+        } catch (error) {
+          console.error('❌ [Identity] Error in reset():', error);
+          return { success: false, error: error.message };
+        }
+      },
+
       /**
        * Set wallet address for current user
        * 
@@ -5979,6 +6107,9 @@
 
           console.log(`✅ [Identity] Wallet address set in sessionData: ${trimmedWalletAddress}`);
 
+          // Get current distinct_id
+          const currentDistinctId = StorageManager.getDistinctId();
+
           // Call API endpoint to update user_identity and session in database
           // This handles merging and immediate session update if session exists
           const apiUrl = CONFIG.API.TRACK.replace('/track', '/wallet-address');
@@ -5992,6 +6123,7 @@
               siteId: getCurrentSiteId(),
               sessionId: session.id,
               userId: currentUserId,
+              distinctId: currentDistinctId, // NEW: Pass distinct_id
               walletAddress: trimmedWalletAddress
             })
           });
@@ -6980,6 +7112,7 @@
       // Identity Functions
       identify: IdentityManager.identify.bind(IdentityManager),
       walletAddress: IdentityManager.walletAddress.bind(IdentityManager),
+      reset: IdentityManager.reset.bind(IdentityManager),
       
       // People Functions (Custom Properties)
       people: {
@@ -7295,6 +7428,22 @@
       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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cryptique-sdk",
-  "version": "1.0.3",
+  "version": "1.0.4",
   "type": "module",
   "description": "Cryptique Analytics SDK - Comprehensive web analytics and user tracking for modern web applications",
   "main": "lib/cjs/index.js",