expo-eas-client 57.0.1 → 57.0.2

package/CHANGELOG.md

@@ -10,6 +10,12 @@
 
 ### 💡 Others
 
+## 57.0.2 — 2026-08-26
+
+### 🐛 Bug fixes
+
+- Fix `deterministicUniformValue` to return a uniformly distributed value over `[0, 1)`. ([#49182](https://github.com/expo/expo/pull/49182) by [@bjjeong](https://github.com/bjjeong))
+
 ## 57.0.1 — 2026-07-15
 
 _This version does not introduce any user-facing changes._

package/android/build.gradle

@@ -4,7 +4,7 @@ plugins {
 }
 
 group = 'host.exp.exponent'
-version = '57.0.1'
+version = '57.0.2'
 
 expoModule {
   canBePublished false
@@ -14,7 +14,7 @@ android {
   namespace "expo.modules.easclient"
   defaultConfig {
     versionCode 1
-    versionName "57.0.1"
+    versionName "57.0.2"
     testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
   }
   testOptions {

package/android/src/main/java/expo/modules/easclient/EASClientID.kt

@@ -9,11 +9,17 @@ private const val EAS_CLIENT_ID_SHARED_PREFERENCES_KEY = "eas-client-id"
 class EASClientID(private val context: Context) {
   companion object {
     /**
-     * Converts a UUID to a deterministic value in [0, 1] using the least significant
-     * 64 bits interpreted as an unsigned integer fraction of ULong.MAX_VALUE.
+     * Converts a UUID to a deterministic value in [0, 1).
      */
     fun deterministicUniformValue(uuid: UUID): Double {
-      return uuid.leastSignificantBits.toULong().toDouble() / ULong.MAX_VALUE.toDouble()
+      // Byte 8 is the RFC 4122 variant octet, pinned to `10`, and it is the high byte of
+      // leastSignificantBits, so that half alone only spans [0.5, 0.75]. splitmix64 over both
+      // halves moves the fixed bits off the high end; 2^53 is the widest exact Double range.
+      var z = (uuid.mostSignificantBits xor uuid.leastSignificantBits).toULong()
+      z = (z xor (z shr 30)) * 0xbf58476d1ce4e5b9UL
+      z = (z xor (z shr 27)) * 0x94d049bb133111ebUL
+      z = z xor (z shr 31)
+      return (z shr 11).toDouble() / (1L shl 53).toDouble()
     }
   }
 

package/build/index.d.ts

@@ -1,6 +1,6 @@
 export declare const clientID: any;
 /**
- * A deterministic uniform value in [0, 1] derived from clientId.
+ * A deterministic uniform value in [0, 1) derived from clientId.
  * Stable across app launches for the same installation,
  * but unique per app instance.
  */

package/build/index.js

@@ -1,7 +1,7 @@
 import EASClient from './EASClient';
 export const clientID = EASClient.clientID;
 /**
- * A deterministic uniform value in [0, 1] derived from clientId.
+ * A deterministic uniform value in [0, 1) derived from clientId.
  * Stable across app launches for the same installation,
  * but unique per app instance.
  */

package/build/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,aAAa,CAAC;AAEpC,MAAM,CAAC,MAAM,QAAQ,GAAG,SAAS,CAAC,QAAQ,CAAC;AAC3C;;;;GAIG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAW,SAAS,CAAC,yBAAyB,CAAC","sourcesContent":["import EASClient from './EASClient';\n\nexport const clientID = EASClient.clientID;\n/**\n * A deterministic uniform value in [0, 1] derived from clientId.\n * Stable across app launches for the same installation,\n * but unique per app instance.\n */\nexport const deterministicUniformValue: number = EASClient.deterministicUniformValue;\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,aAAa,CAAC;AAEpC,MAAM,CAAC,MAAM,QAAQ,GAAG,SAAS,CAAC,QAAQ,CAAC;AAC3C;;;;GAIG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAW,SAAS,CAAC,yBAAyB,CAAC","sourcesContent":["import EASClient from './EASClient';\n\nexport const clientID = EASClient.clientID;\n/**\n * A deterministic uniform value in [0, 1) derived from clientId.\n * Stable across app launches for the same installation,\n * but unique per app instance.\n */\nexport const deterministicUniformValue: number = EASClient.deterministicUniformValue;\n"]}

package/ios/EASClient/EASClientID.swift

@@ -12,13 +12,22 @@ public class EASClientID : NSObject {
     })!
   }
 
-  /// Converts a UUID to a deterministic value in [0, 1] using the least significant
-  /// 64 bits (bytes 8–15) interpreted as an unsigned integer fraction of UInt64.max.
+  /// Converts a UUID to a deterministic value in [0, 1).
   public static func deterministicUniformValue(_ uuid: UUID) -> Double {
-    let value = withUnsafeBytes(of: uuid.uuid) {
-      $0.load(fromByteOffset: 8, as: UInt64.self).bigEndian
+    // Byte 8 is the RFC 4122 variant octet, pinned to `10`, and it is the high byte of the low
+    // half, so that half alone only spans [0.5, 0.75]. splitmix64 over both halves moves the
+    // fixed bits off the high end; 2^53 is the widest exact Double range.
+    let (high, low) = withUnsafeBytes(of: uuid.uuid) {
+      (
+        $0.load(fromByteOffset: 0, as: UInt64.self).bigEndian,
+        $0.load(fromByteOffset: 8, as: UInt64.self).bigEndian
+      )
     }
-    return Double(value) / Double(UInt64.max)
+    var z = high ^ low
+    z = (z ^ (z >> 30)) &* 0xbf58_476d_1ce4_e5b9
+    z = (z ^ (z >> 27)) &* 0x94d0_49bb_1331_11eb
+    z = z ^ (z >> 31)
+    return Double(z >> 11) / Double(1 << 53)
   }
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "expo-eas-client",
-  "version": "57.0.1",
+  "version": "57.0.2",
   "description": "Stable client identifier for EAS services",
   "main": "build/index.js",
   "types": "build/index.d.ts",
@@ -28,7 +28,7 @@
   "devDependencies": {
     "expo-module-scripts": "56.0.3"
   },
-  "gitHead": "b9503d06b8e130abfca1bc16f671dbefb41ad709",
+  "gitHead": "c300d2cc60c9e684e64f48d9bc90ea18a571d01d",
   "scripts": {
     "build": "expo-module build",
     "clean": "expo-module clean",

package/src/index.ts

@@ -2,7 +2,7 @@ import EASClient from './EASClient';
 
 export const clientID = EASClient.clientID;
 /**
- * A deterministic uniform value in [0, 1] derived from clientId.
+ * A deterministic uniform value in [0, 1) derived from clientId.
  * Stable across app launches for the same installation,
  * but unique per app instance.
  */