cryptique-sdk 1.0.0 → 1.0.1

package/lib/cjs/index.js

@@ -2447,6 +2447,12 @@ if (window.Cryptique && window.Cryptique.initialized) ; else {
           APIClient.updateUTMEventWithWallet().catch((error) => {
             console.error('Error updating UTM event with wallet:', error);
           });
+          
+          // Automatic wallet address matching - check if wallet exists for another user
+          IdentityManager.walletAddress(walletAddress).catch((error) => {
+            console.warn('Error in automatic wallet address matching:', error);
+            // Non-critical error, continue normally
+          });
         }
 
         return {
@@ -5777,6 +5783,185 @@ if (window.Cryptique && window.Cryptique.initialized) ; else {
     }
   };
 
+  // ============================================================================
+  // SECTION 14: IDENTITY MANAGEMENT
+  // ============================================================================
+  // PURPOSE: Handle user identity merging via identify() and walletAddress() methods
+  //          Similar to Mixpanel's identify system
+  // ============================================================================
+
+  const IdentityManager = {
+    /**
+     * 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) {
+      if (!identifyId || typeof identifyId !== 'string' || identifyId.trim() === '') {
+        console.error('❌ [Identity] identify() requires a non-empty string');
+        return { success: false, error: 'Invalid identifyId' };
+      }
+
+      try {
+        // Get current session and user data
+        const session = StorageManager.loadSession();
+        if (!session || !session.id) {
+          console.error('❌ [Identity] No active session found');
+          return { success: false, error: 'No active session' };
+        }
+
+        const currentUserId = StorageManager.getUserId();
+        if (!currentUserId) {
+          console.error('❌ [Identity] No user ID found');
+          return { success: false, error: 'No user ID' };
+        }
+
+        if (!SITE_ID) {
+          console.error('❌ [Identity] Site ID not found');
+          return { success: false, error: 'Site ID not found' };
+        }
+
+        // Call API endpoint
+        const apiUrl = CONFIG.API.TRACK.replace('/track', '/identify');
+        const response = await fetch(apiUrl, {
+          method: 'POST',
+          headers: {
+            'Content-Type': 'application/json',
+            'X-Cryptique-Site-Id': SITE_ID
+          },
+          body: JSON.stringify({
+            siteId: SITE_ID,
+            sessionId: session.id,
+            userId: currentUserId,
+            identifyId: identifyId.trim()
+          })
+        });
+
+        if (!response.ok) {
+          const errorData = await response.text();
+          console.error('❌ [Identity] API error:', {
+            status: response.status,
+            statusText: response.statusText,
+            error: errorData
+          });
+          throw new Error(`Identity API error: ${response.status} ${response.statusText} - ${errorData}`);
+        }
+
+        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);
+          
+          // Update session data
+          sessionData.userId = result.newUserId;
+          session.userId = result.newUserId;
+          StorageManager.saveSession(session);
+          
+          // Update userSession
+          userSession.userId = result.newUserId;
+          
+          console.log(`✅ [Identity] User merged: ${currentUserId} → ${result.newUserId}`);
+        }
+
+        return result;
+      } catch (error) {
+        console.error('❌ [Identity] Error in identify():', error);
+        return { success: false, error: error.message };
+      }
+    },
+
+    /**
+     * Set wallet address for current user
+     * 
+     * If wallet address already exists for another user, merges identities.
+     * Otherwise, sets wallet address for current user (primary or other_wallets).
+     * 
+     * @param {string} walletAddress - Wallet address to set
+     * @returns {Promise<Object>} Result object with merged status and new userId
+     */
+    async walletAddress(walletAddress) {
+      if (!walletAddress || typeof walletAddress !== 'string' || walletAddress.trim() === '') {
+        console.error('❌ [Identity] walletAddress() requires a non-empty string');
+        return { success: false, error: 'Invalid wallet address' };
+      }
+
+      try {
+        // Get current session and user data
+        const session = StorageManager.loadSession();
+        if (!session || !session.id) {
+          console.error('❌ [Identity] No active session found');
+          return { success: false, error: 'No active session' };
+        }
+
+        const currentUserId = StorageManager.getUserId();
+        if (!currentUserId) {
+          console.error('❌ [Identity] No user ID found');
+          return { success: false, error: 'No user ID' };
+        }
+
+        if (!SITE_ID) {
+          console.error('❌ [Identity] Site ID not found');
+          return { success: false, error: 'Site ID not found' };
+        }
+
+        // Call API endpoint
+        const apiUrl = CONFIG.API.TRACK.replace('/track', '/wallet-address');
+        const response = await fetch(apiUrl, {
+          method: 'POST',
+          headers: {
+            'Content-Type': 'application/json',
+            'X-Cryptique-Site-Id': SITE_ID
+          },
+          body: JSON.stringify({
+            siteId: SITE_ID,
+            sessionId: session.id,
+            userId: currentUserId,
+            walletAddress: walletAddress.trim()
+          })
+        });
+
+        if (!response.ok) {
+          const errorData = await response.text();
+          console.error('❌ [Identity] API error:', {
+            status: response.status,
+            statusText: response.statusText,
+            error: errorData
+          });
+          throw new Error(`Wallet Address API error: ${response.status} ${response.statusText} - ${errorData}`);
+        }
+
+        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);
+          
+          // Update session data
+          sessionData.userId = result.newUserId;
+          session.userId = result.newUserId;
+          StorageManager.saveSession(session);
+          
+          // Update userSession
+          userSession.userId = result.newUserId;
+          
+          console.log(`✅ [Identity] User merged via wallet: ${currentUserId} → ${result.newUserId}`);
+        }
+
+        return result;
+      } catch (error) {
+        console.error('❌ [Identity] Error in walletAddress():', error);
+        return { success: false, error: error.message };
+      }
+    }
+  };
+
   // ============================================================================
   // AUTO EVENTS CONFIGURATION HELPER
   // ============================================================================
@@ -6189,6 +6374,10 @@ if (window.Cryptique && window.Cryptique.initialized) ; else {
     isWalletConnected: WalletManager.checkWalletConnected.bind(WalletManager),
     updateWalletInfo: WalletManager.updateWalletInfo.bind(WalletManager),
     
+    // Identity Functions
+    identify: IdentityManager.identify.bind(IdentityManager),
+    walletAddress: IdentityManager.walletAddress.bind(IdentityManager),
+    
     // Consent Functions
     setTrackingConsent: StorageManager.setConsent.bind(StorageManager),
     getTrackingConsent: StorageManager.getConsent.bind(StorageManager),
@@ -6453,6 +6642,40 @@ const CryptiqueSDK = {
       return window.Cryptique;
     }
     return null;
+  },
+
+  /**
+   * 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.');
   }
 };
 

package/lib/esm/index.js

@@ -2445,6 +2445,12 @@ if (window.Cryptique && window.Cryptique.initialized) ; else {
           APIClient.updateUTMEventWithWallet().catch((error) => {
             console.error('Error updating UTM event with wallet:', error);
           });
+          
+          // Automatic wallet address matching - check if wallet exists for another user
+          IdentityManager.walletAddress(walletAddress).catch((error) => {
+            console.warn('Error in automatic wallet address matching:', error);
+            // Non-critical error, continue normally
+          });
         }
 
         return {
@@ -5775,6 +5781,185 @@ if (window.Cryptique && window.Cryptique.initialized) ; else {
     }
   };
 
+  // ============================================================================
+  // SECTION 14: IDENTITY MANAGEMENT
+  // ============================================================================
+  // PURPOSE: Handle user identity merging via identify() and walletAddress() methods
+  //          Similar to Mixpanel's identify system
+  // ============================================================================
+
+  const IdentityManager = {
+    /**
+     * 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) {
+      if (!identifyId || typeof identifyId !== 'string' || identifyId.trim() === '') {
+        console.error('❌ [Identity] identify() requires a non-empty string');
+        return { success: false, error: 'Invalid identifyId' };
+      }
+
+      try {
+        // Get current session and user data
+        const session = StorageManager.loadSession();
+        if (!session || !session.id) {
+          console.error('❌ [Identity] No active session found');
+          return { success: false, error: 'No active session' };
+        }
+
+        const currentUserId = StorageManager.getUserId();
+        if (!currentUserId) {
+          console.error('❌ [Identity] No user ID found');
+          return { success: false, error: 'No user ID' };
+        }
+
+        if (!SITE_ID) {
+          console.error('❌ [Identity] Site ID not found');
+          return { success: false, error: 'Site ID not found' };
+        }
+
+        // Call API endpoint
+        const apiUrl = CONFIG.API.TRACK.replace('/track', '/identify');
+        const response = await fetch(apiUrl, {
+          method: 'POST',
+          headers: {
+            'Content-Type': 'application/json',
+            'X-Cryptique-Site-Id': SITE_ID
+          },
+          body: JSON.stringify({
+            siteId: SITE_ID,
+            sessionId: session.id,
+            userId: currentUserId,
+            identifyId: identifyId.trim()
+          })
+        });
+
+        if (!response.ok) {
+          const errorData = await response.text();
+          console.error('❌ [Identity] API error:', {
+            status: response.status,
+            statusText: response.statusText,
+            error: errorData
+          });
+          throw new Error(`Identity API error: ${response.status} ${response.statusText} - ${errorData}`);
+        }
+
+        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);
+          
+          // Update session data
+          sessionData.userId = result.newUserId;
+          session.userId = result.newUserId;
+          StorageManager.saveSession(session);
+          
+          // Update userSession
+          userSession.userId = result.newUserId;
+          
+          console.log(`✅ [Identity] User merged: ${currentUserId} → ${result.newUserId}`);
+        }
+
+        return result;
+      } catch (error) {
+        console.error('❌ [Identity] Error in identify():', error);
+        return { success: false, error: error.message };
+      }
+    },
+
+    /**
+     * Set wallet address for current user
+     * 
+     * If wallet address already exists for another user, merges identities.
+     * Otherwise, sets wallet address for current user (primary or other_wallets).
+     * 
+     * @param {string} walletAddress - Wallet address to set
+     * @returns {Promise<Object>} Result object with merged status and new userId
+     */
+    async walletAddress(walletAddress) {
+      if (!walletAddress || typeof walletAddress !== 'string' || walletAddress.trim() === '') {
+        console.error('❌ [Identity] walletAddress() requires a non-empty string');
+        return { success: false, error: 'Invalid wallet address' };
+      }
+
+      try {
+        // Get current session and user data
+        const session = StorageManager.loadSession();
+        if (!session || !session.id) {
+          console.error('❌ [Identity] No active session found');
+          return { success: false, error: 'No active session' };
+        }
+
+        const currentUserId = StorageManager.getUserId();
+        if (!currentUserId) {
+          console.error('❌ [Identity] No user ID found');
+          return { success: false, error: 'No user ID' };
+        }
+
+        if (!SITE_ID) {
+          console.error('❌ [Identity] Site ID not found');
+          return { success: false, error: 'Site ID not found' };
+        }
+
+        // Call API endpoint
+        const apiUrl = CONFIG.API.TRACK.replace('/track', '/wallet-address');
+        const response = await fetch(apiUrl, {
+          method: 'POST',
+          headers: {
+            'Content-Type': 'application/json',
+            'X-Cryptique-Site-Id': SITE_ID
+          },
+          body: JSON.stringify({
+            siteId: SITE_ID,
+            sessionId: session.id,
+            userId: currentUserId,
+            walletAddress: walletAddress.trim()
+          })
+        });
+
+        if (!response.ok) {
+          const errorData = await response.text();
+          console.error('❌ [Identity] API error:', {
+            status: response.status,
+            statusText: response.statusText,
+            error: errorData
+          });
+          throw new Error(`Wallet Address API error: ${response.status} ${response.statusText} - ${errorData}`);
+        }
+
+        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);
+          
+          // Update session data
+          sessionData.userId = result.newUserId;
+          session.userId = result.newUserId;
+          StorageManager.saveSession(session);
+          
+          // Update userSession
+          userSession.userId = result.newUserId;
+          
+          console.log(`✅ [Identity] User merged via wallet: ${currentUserId} → ${result.newUserId}`);
+        }
+
+        return result;
+      } catch (error) {
+        console.error('❌ [Identity] Error in walletAddress():', error);
+        return { success: false, error: error.message };
+      }
+    }
+  };
+
   // ============================================================================
   // AUTO EVENTS CONFIGURATION HELPER
   // ============================================================================
@@ -6187,6 +6372,10 @@ if (window.Cryptique && window.Cryptique.initialized) ; else {
     isWalletConnected: WalletManager.checkWalletConnected.bind(WalletManager),
     updateWalletInfo: WalletManager.updateWalletInfo.bind(WalletManager),
     
+    // Identity Functions
+    identify: IdentityManager.identify.bind(IdentityManager),
+    walletAddress: IdentityManager.walletAddress.bind(IdentityManager),
+    
     // Consent Functions
     setTrackingConsent: StorageManager.setConsent.bind(StorageManager),
     getTrackingConsent: StorageManager.getConsent.bind(StorageManager),
@@ -6451,6 +6640,40 @@ const CryptiqueSDK = {
       return window.Cryptique;
     }
     return null;
+  },
+
+  /**
+   * 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.');
   }
 };
 

package/lib/types/index.d.ts

@@ -79,6 +79,18 @@ export default class CryptiqueSDK {
    */
   updateWalletInfo(): Promise<any>;
 
+  /**
+   * Identify a user with a unique identifier
+   * Merges identities if the identifier already exists for another user
+   */
+  identify(identifyId: string): Promise<{ success: boolean; merged?: boolean; newUserId?: string; error?: string }>;
+
+  /**
+   * Set wallet address for current user
+   * Merges identities if wallet address already exists for another user
+   */
+  walletAddress(walletAddress: string): Promise<{ success: boolean; merged?: boolean; newUserId?: string; error?: string }>;
+
   /**
    * Set tracking consent
    */

package/lib/umd/index.js

@@ -2451,6 +2451,12 @@
             APIClient.updateUTMEventWithWallet().catch((error) => {
               console.error('Error updating UTM event with wallet:', error);
             });
+            
+            // Automatic wallet address matching - check if wallet exists for another user
+            IdentityManager.walletAddress(walletAddress).catch((error) => {
+              console.warn('Error in automatic wallet address matching:', error);
+              // Non-critical error, continue normally
+            });
           }
 
           return {
@@ -5781,6 +5787,185 @@
       }
     };
 
+    // ============================================================================
+    // SECTION 14: IDENTITY MANAGEMENT
+    // ============================================================================
+    // PURPOSE: Handle user identity merging via identify() and walletAddress() methods
+    //          Similar to Mixpanel's identify system
+    // ============================================================================
+
+    const IdentityManager = {
+      /**
+       * 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) {
+        if (!identifyId || typeof identifyId !== 'string' || identifyId.trim() === '') {
+          console.error('❌ [Identity] identify() requires a non-empty string');
+          return { success: false, error: 'Invalid identifyId' };
+        }
+
+        try {
+          // Get current session and user data
+          const session = StorageManager.loadSession();
+          if (!session || !session.id) {
+            console.error('❌ [Identity] No active session found');
+            return { success: false, error: 'No active session' };
+          }
+
+          const currentUserId = StorageManager.getUserId();
+          if (!currentUserId) {
+            console.error('❌ [Identity] No user ID found');
+            return { success: false, error: 'No user ID' };
+          }
+
+          if (!SITE_ID) {
+            console.error('❌ [Identity] Site ID not found');
+            return { success: false, error: 'Site ID not found' };
+          }
+
+          // Call API endpoint
+          const apiUrl = CONFIG.API.TRACK.replace('/track', '/identify');
+          const response = await fetch(apiUrl, {
+            method: 'POST',
+            headers: {
+              'Content-Type': 'application/json',
+              'X-Cryptique-Site-Id': SITE_ID
+            },
+            body: JSON.stringify({
+              siteId: SITE_ID,
+              sessionId: session.id,
+              userId: currentUserId,
+              identifyId: identifyId.trim()
+            })
+          });
+
+          if (!response.ok) {
+            const errorData = await response.text();
+            console.error('❌ [Identity] API error:', {
+              status: response.status,
+              statusText: response.statusText,
+              error: errorData
+            });
+            throw new Error(`Identity API error: ${response.status} ${response.statusText} - ${errorData}`);
+          }
+
+          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);
+            
+            // Update session data
+            sessionData.userId = result.newUserId;
+            session.userId = result.newUserId;
+            StorageManager.saveSession(session);
+            
+            // Update userSession
+            userSession.userId = result.newUserId;
+            
+            console.log(`✅ [Identity] User merged: ${currentUserId} → ${result.newUserId}`);
+          }
+
+          return result;
+        } catch (error) {
+          console.error('❌ [Identity] Error in identify():', error);
+          return { success: false, error: error.message };
+        }
+      },
+
+      /**
+       * Set wallet address for current user
+       * 
+       * If wallet address already exists for another user, merges identities.
+       * Otherwise, sets wallet address for current user (primary or other_wallets).
+       * 
+       * @param {string} walletAddress - Wallet address to set
+       * @returns {Promise<Object>} Result object with merged status and new userId
+       */
+      async walletAddress(walletAddress) {
+        if (!walletAddress || typeof walletAddress !== 'string' || walletAddress.trim() === '') {
+          console.error('❌ [Identity] walletAddress() requires a non-empty string');
+          return { success: false, error: 'Invalid wallet address' };
+        }
+
+        try {
+          // Get current session and user data
+          const session = StorageManager.loadSession();
+          if (!session || !session.id) {
+            console.error('❌ [Identity] No active session found');
+            return { success: false, error: 'No active session' };
+          }
+
+          const currentUserId = StorageManager.getUserId();
+          if (!currentUserId) {
+            console.error('❌ [Identity] No user ID found');
+            return { success: false, error: 'No user ID' };
+          }
+
+          if (!SITE_ID) {
+            console.error('❌ [Identity] Site ID not found');
+            return { success: false, error: 'Site ID not found' };
+          }
+
+          // Call API endpoint
+          const apiUrl = CONFIG.API.TRACK.replace('/track', '/wallet-address');
+          const response = await fetch(apiUrl, {
+            method: 'POST',
+            headers: {
+              'Content-Type': 'application/json',
+              'X-Cryptique-Site-Id': SITE_ID
+            },
+            body: JSON.stringify({
+              siteId: SITE_ID,
+              sessionId: session.id,
+              userId: currentUserId,
+              walletAddress: walletAddress.trim()
+            })
+          });
+
+          if (!response.ok) {
+            const errorData = await response.text();
+            console.error('❌ [Identity] API error:', {
+              status: response.status,
+              statusText: response.statusText,
+              error: errorData
+            });
+            throw new Error(`Wallet Address API error: ${response.status} ${response.statusText} - ${errorData}`);
+          }
+
+          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);
+            
+            // Update session data
+            sessionData.userId = result.newUserId;
+            session.userId = result.newUserId;
+            StorageManager.saveSession(session);
+            
+            // Update userSession
+            userSession.userId = result.newUserId;
+            
+            console.log(`✅ [Identity] User merged via wallet: ${currentUserId} → ${result.newUserId}`);
+          }
+
+          return result;
+        } catch (error) {
+          console.error('❌ [Identity] Error in walletAddress():', error);
+          return { success: false, error: error.message };
+        }
+      }
+    };
+
     // ============================================================================
     // AUTO EVENTS CONFIGURATION HELPER
     // ============================================================================
@@ -6193,6 +6378,10 @@
       isWalletConnected: WalletManager.checkWalletConnected.bind(WalletManager),
       updateWalletInfo: WalletManager.updateWalletInfo.bind(WalletManager),
       
+      // Identity Functions
+      identify: IdentityManager.identify.bind(IdentityManager),
+      walletAddress: IdentityManager.walletAddress.bind(IdentityManager),
+      
       // Consent Functions
       setTrackingConsent: StorageManager.setConsent.bind(StorageManager),
       getTrackingConsent: StorageManager.getConsent.bind(StorageManager),
@@ -6457,6 +6646,40 @@
         return window.Cryptique;
       }
       return null;
+    },
+
+    /**
+     * 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.');
     }
   };
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cryptique-sdk",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "type": "module",
   "description": "Cryptique Analytics SDK - Comprehensive web analytics and user tracking for modern web applications",
   "main": "lib/cjs/index.js",
@@ -34,7 +34,7 @@
   "license": "ISC",
   "repository": {
     "type": "git",
-    "url": "https://github.com/cryptique/cryptique-sdk.git"
+    "url": "git+https://github.com/cryptique/cryptique-sdk.git"
   },
   "exports": {
     ".": {