@zaplier/sdk 1.6.2 → 1.6.3

package/dist/index.d.ts

@@ -1356,6 +1356,7 @@ declare function hash32(input: string): string;
 declare function hashFingerprint(components: Record<string, any>, debug?: boolean): string;
 /**
  * Generate a visitor ID from fingerprint hash
+ * Returns a proper UUID v4 format for database compatibility
  */
 declare function generateVisitorId(fingerprintHash: string): string;
 

package/dist/index.esm.js

@@ -199,10 +199,19 @@ function hashFingerprint(components, debug = false) {
 }
 /**
  * Generate a visitor ID from fingerprint hash
+ * Returns a proper UUID v4 format for database compatibility
  */
 function generateVisitorId(fingerprintHash) {
-    // Use first 16 characters of the hash for visitor ID
-    return "vis_" + fingerprintHash.substring(0, 16);
+    // Generate UUID v4 format from fingerprint hash
+    const hash = fingerprintHash.length >= 32 ? fingerprintHash : (fingerprintHash + fingerprintHash + fingerprintHash + fingerprintHash).substring(0, 32);
+    // Extract bytes for UUID construction
+    const hex = hash.substring(0, 32);
+    // Set version 4 and variant bits according to RFC 4122
+    const chars = hex.split('');
+    chars[12] = '4'; // Version 4
+    chars[16] = (parseInt(chars[16] || '0', 16) & 0x3 | 0x8).toString(16); // Variant 10
+    // Format as UUID: xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx
+    return `${chars.slice(0, 8).join('')}-${chars.slice(8, 12).join('')}-${chars.slice(12, 16).join('')}-${chars.slice(16, 20).join('')}-${chars.slice(20, 32).join('')}`;
 }
 /**
  * Check if a key represents an unstable component that should be excluded from hashing
@@ -19763,9 +19772,27 @@ PersistenceManager.memoryStore = new Map();
  */
 class VisitorIdentityManager {
     generateVisitorId() {
-        return "vis_" + Array.from(crypto.getRandomValues(new Uint8Array(16)))
-            .map(b => b.toString(16).padStart(2, '0'))
-            .join('');
+        // Generate UUID v4 format instead of vis_ prefix
+        const bytes = crypto.getRandomValues(new Uint8Array(16));
+        // Set version 4
+        bytes[6] = (bytes[6] & 0x0f) | 0x40;
+        // Set variant
+        bytes[8] = (bytes[8] & 0x3f) | 0x80;
+        const hex = Array.from(bytes).map(b => b.toString(16).padStart(2, '0')).join('');
+        return `${hex.substr(0, 8)}-${hex.substr(8, 4)}-${hex.substr(12, 4)}-${hex.substr(16, 4)}-${hex.substr(20, 12)}`;
+    }
+    generateVisitorIdFromHash(hash) {
+        // Generate deterministic UUID v4 format from fingerprint hash
+        // This ensures same fingerprint = same visitor ID
+        const hashExtended = hash.length >= 32 ? hash : (hash + hash + hash + hash).substring(0, 32);
+        // Extract hex characters for UUID construction
+        const hex = hashExtended.substring(0, 32);
+        const chars = hex.split('');
+        // Set version 4 and variant bits according to RFC 4122
+        chars[12] = '4'; // Version 4
+        chars[16] = (parseInt(chars[16] || '0', 16) & 0x3 | 0x8).toString(16); // Variant 10
+        // Format as UUID: xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx
+        return `${chars.slice(0, 8).join('')}-${chars.slice(8, 12).join('')}-${chars.slice(12, 16).join('')}-${chars.slice(16, 20).join('')}-${chars.slice(20, 32).join('')}`;
     }
     generateSessionId() {
         return "ses_" + Array.from(crypto.getRandomValues(new Uint8Array(8)))
@@ -19824,11 +19851,13 @@ class VisitorIdentityManager {
                 };
             }
         }
-        // Create new visitor identity
-        const newVisitorId = this.generateVisitorId();
+        // Create new visitor identity (deterministic from fingerprint)
+        // Use stableCoreHash for deterministic visitor ID generation
+        // This ensures same fingerprint = same visitor ID across devices and sessions
+        const deterministicVisitorId = this.generateVisitorIdFromHash(params.stableCoreHash);
         const newSessionId = params.sessionId || this.generateSessionId();
         const newIdentity = {
-            visitorId: newVisitorId,
+            visitorId: deterministicVisitorId,
             sessionId: newSessionId,
             stableCoreHash,
             deviceFingerprint: params.deviceFingerprint,
@@ -19839,7 +19868,7 @@ class VisitorIdentityManager {
             reused: false,
         };
         // Store in camouflaged format
-        const camouflageData = this.createCamouflageData(newVisitorId, newSessionId, stableCoreHash);
+        const camouflageData = this.createCamouflageData(deterministicVisitorId, newSessionId, stableCoreHash);
         const { method: storageMethod } = PersistenceManager.set(STORAGE_KEYS.prefs, JSON.stringify(camouflageData));
         newIdentity.persistenceMethod = storageMethod;
         // Also store device fingerprint cache for faster lookups