expo-eas-client 55.0.2 → 55.0.3

package/CHANGELOG.md

@@ -10,6 +10,12 @@
 
 ### 💡 Others
 
+## 55.0.3 — 2026-03-27
+
+### 🎉 New features
+
+- Add `deterministicUniformValue` constant ([#44075](https://github.com/expo/expo/pull/44075) by [@Ubax](https://github.com/Ubax))
+
 ## 55.0.2 — 2026-01-26
 
 _This version does not introduce any user-facing changes._

package/android/build.gradle

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

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

@@ -7,6 +7,16 @@ private const val PREFERENCES_FILE_NAME = "dev.expo.EASSharedPreferences"
 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.
+     */
+    fun deterministicUniformValue(uuid: UUID): Double {
+      return uuid.leastSignificantBits.toULong().toDouble() / ULong.MAX_VALUE.toDouble()
+    }
+  }
+
   val uuid: UUID by lazy {
     val sharedPreferences = context.getSharedPreferences(PREFERENCES_FILE_NAME, Context.MODE_PRIVATE)
     var clientId = sharedPreferences.getString(EAS_CLIENT_ID_SHARED_PREFERENCES_KEY, null)

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

@@ -13,5 +13,7 @@ class EASClientModule : Module() {
     Name("EASClient")
 
     Constant("clientID") { EASClientID(context).uuid.toString() }
+
+    Constant("deterministicUniformValue") { EASClientID.deterministicUniformValue(EASClientID(context).uuid) }
   }
 }

package/build/index.d.ts

@@ -1,2 +1,8 @@
 export declare const clientID: any;
+/**
+ * A deterministic uniform value in [0, 1] derived from clientId.
+ * Stable across app launches for the same installation,
+ * but unique per app instance.
+ */
+export declare const deterministicUniformValue: number;
 //# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,QAAQ,KAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,QAAQ,KAAqB,CAAC;AAC3C;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,EAAE,MAA4C,CAAC"}

package/build/index.js

@@ -1,3 +1,9 @@
 import EASClient from './EASClient';
 export const clientID = EASClient.clientID;
+/**
+ * A deterministic uniform value in [0, 1] derived from clientId.
+ * Stable across app launches for the same installation,
+ * but unique per app instance.
+ */
+export const deterministicUniformValue = EASClient.deterministicUniformValue;
 //# sourceMappingURL=index.js.map

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","sourcesContent":["import EASClient from './EASClient';\n\nexport const clientID = EASClient.clientID;\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

@@ -11,6 +11,15 @@ public class EASClientID : NSObject {
       UUID.init().uuidString
     })!
   }
+
+  /// 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.
+  public static func deterministicUniformValue(_ uuid: UUID) -> Double {
+    let value = withUnsafeBytes(of: uuid.uuid) {
+      $0.load(fromByteOffset: 8, as: UInt64.self).bigEndian
+    }
+    return Double(value) / Double(UInt64.max)
+  }
 }
 
 extension UserDefaults {

package/ios/EASClient/EASClientModule.swift

@@ -7,5 +7,7 @@ public class EASClientModule: Module {
     Name("EASClient")
 
     Constant("clientID") { EASClientID.uuid().uuidString }
+
+    Constant("deterministicUniformValue") { EASClientID.deterministicUniformValue(EASClientID.uuid()) }
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "expo-eas-client",
-  "version": "55.0.2",
+  "version": "55.0.3",
   "description": "Stable client identifier for EAS services",
   "main": "build/index.js",
   "types": "build/index.d.ts",
@@ -37,5 +37,5 @@
   "devDependencies": {
     "expo-module-scripts": "^55.0.2"
   },
-  "gitHead": "7d7f6762fc6907c27a329953c682134a84410dea"
+  "gitHead": "f63217deac00dcd278f75d9846933c11e5c6f9a3"
 }

package/src/index.ts

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