@zaplier/sdk 1.0.8 → 1.0.9

package/dist/index.esm.js

@@ -5646,7 +5646,9 @@ async function collectFingerprint(options = {}) {
             platform: (browser?.platform || "unknown").toLowerCase(),
             // PRIORITY 5: Device type (critical for differentiation, ultra-stable)
             deviceType,
-            // PRIORITY 6: Enhanced screen resolution buckets with 2024 display trends
+            // PRIORITY 6: Enhanced screen resolution with exact dimensions for mobile differentiation
+            // For mobile devices, we NEED exact dimensions to differentiate between similar models (S22 vs A54)
+            // For desktop, bucketing is sufficient as hardware varies more
             screen: screen
                 ? (() => {
                     // Use enhanced screen buckets for modern display landscape
@@ -5741,6 +5743,19 @@ async function collectFingerprint(options = {}) {
                             return "enhanced"; // Slightly enhanced DPI
                         return "standard"; // Standard 1x displays
                     };
+                    // CRITICAL: Do NOT include exact dimensions in stableCoreVector for mobile!
+                    // Reason: Screen dimensions change when:
+                    // - Chrome address bar appears/disappears (scroll behavior)
+                    // - Virtual keyboard opens/closes
+                    // - Screen rotates (portrait ↔ landscape)
+                    // - Browser zoom changes
+                    // These changes would cause stableCoreHash to change, breaking visitor identification
+                    //
+                    // INSTEAD: Use ONLY stable screen characteristics (bucket, aspect, density)
+                    // For device differentiation (S22 vs A54), use:
+                    // - screenFrame (bezel measurements)
+                    // - Combination of bucket + hardware + display
+                    // - Vector similarity in IdentityResolver
                     return {
                         bucket: getScreenBucket(width),
                         aspectClass: getAspectRatioClass(width, height),
@@ -5757,6 +5772,11 @@ async function collectFingerprint(options = {}) {
                                     : width >= 768
                                         ? "tablet"
                                         : "mobile",
+                        // ❌ REMOVED: exact dimensions (causes instability on mobile)
+                        // Device differentiation is now handled by:
+                        // 1. screenFrame (bezel measurements - stable)
+                        // 2. hardware + display combination
+                        // 3. Vector similarity in IdentityResolver
                     };
                 })()
                 : {
@@ -5885,7 +5905,18 @@ async function collectFingerprint(options = {}) {
                         : "none",
                 };
             })(),
-            // PRIORITY 8: Enhanced color and display capabilities bucketing
+            // PRIORITY 8: Screen frame (bezel measurements) for mobile device differentiation
+            // CRITICAL: This is STABLE across page loads and provides device-specific fingerprint
+            // Samsung S22 vs A54 have different screen frames despite similar resolutions
+            screenFrame: deviceSignals$1?.screenFrame
+                ? {
+                    top: deviceSignals$1.screenFrame.top || 0,
+                    right: deviceSignals$1.screenFrame.right || 0,
+                    bottom: deviceSignals$1.screenFrame.bottom || 0,
+                    left: deviceSignals$1.screenFrame.left || 0,
+                }
+                : undefined,
+            // PRIORITY 9: Enhanced color and display capabilities bucketing
             display: (() => {
                 const depth = deviceSignals$1.colorDepth;
                 const gamut = deviceSignals$1.colorGamut;