@prelude.so/react-native-sdk 0.3.2 → 0.3.4

package/CHANGELOG.md

@@ -0,0 +1,12 @@
+# Change Log
+
+Prelude React Native SDK Change Log
+
+## [0.3.4] - 2025-12-17
+- Expose `max_retries` argument to allow for customizing the number of automatic retries for network requests
+- Update native components to Android version 0.2.4 and iOS version 0.2.5. New defaults for timeouts and retries included
+- Updated method documentation
+
+## [0.3.3] - 2025-09-23
+
+- Update native components to Android version 0.2.3 and iOS version 0.2.4 which added Silent Verification support for Bouygues

package/android/build.gradle

@@ -1,7 +1,7 @@
 apply plugin: 'com.android.library'
 
 group = 'so.prelude.reactnative.sdk'
-version = '0.2.2'
+version = '0.2.4'
 
 def expoModulesCorePlugin = new File(project(":expo-modules-core").projectDir.absolutePath, "ExpoModulesCorePlugin.gradle")
 apply from: expoModulesCorePlugin
@@ -44,5 +44,5 @@ android {
 
 dependencies {
   compileOnly('com.squareup.okhttp3:okhttp:4.12.0')
-  implementation('so.prelude.android:sdk:0.2.2')
+  implementation('so.prelude.android:sdk:0.2.4')
 }

package/android/src/main/java/so/prelude/reactnative/sdk/PreludeReactNativeSdkModule.kt

@@ -16,12 +16,19 @@ class PreludeReactNativeSdkModule : Module() {
             Name("PreludeReactNativeSdk")
 
             AsyncFunction("dispatchSignals") Coroutine {
-                sdkKey: String,
-                endpointUrl: String?,
-                timeoutMilliseconds: Long?,
-                implementedFeaturesRawValue: Long?,
+                    sdkKey: String,
+                    endpointUrl: String?,
+                    timeoutMilliseconds: Long?,
+                    implementedFeaturesRawValue: Long?,
+                    maxRetries: Int?,
                 ->
-                dispatchSignals(endpointUrl, sdkKey, timeoutMilliseconds, implementedFeaturesRawValue ?: 0L)
+                dispatchSignals(
+                    endpointUrl,
+                    sdkKey,
+                    timeoutMilliseconds ?: 10000L,
+                    implementedFeaturesRawValue ?: 0L,
+                    maxRetries ?: 3
+                )
             }
 
             AsyncFunction("verifySilent") Coroutine { sdkKey: String, requestUrl: String ->
@@ -35,8 +42,9 @@ class PreludeReactNativeSdkModule : Module() {
     private suspend fun dispatchSignals(
         endpointUrl: String?,
         sdkKey: String,
-        timeoutMilliseconds: Long?,
+        timeoutMilliseconds: Long,
         implementedFeaturesRawValue: Long = 0L,
+        maxRetries: Int,
     ): String {
         val endpoint: Endpoint =
             endpointUrl?.let {
@@ -56,8 +64,9 @@ class PreludeReactNativeSdkModule : Module() {
                 context = context.applicationContext,
                 sdkKey = sdkKey,
                 endpoint = endpoint,
-                requestTimeout = timeoutMilliseconds ?: DEFAULT_REQUEST_TIMEOUT,
+                requestTimeout = timeoutMilliseconds,
                 implementedFeatures = Features.fromRawValue(implementedFeaturesRawValue),
+                maxRetries = maxRetries,
             )
         val prelude = Prelude(config)
 

package/build/index.d.ts

@@ -1,9 +1,29 @@
+/**
+ * Dispatches signals to the Prelude service.
+ *
+ * @param configuration - Configuration options for dispatching signals
+ * @param configuration.sdk_key - Your Prelude SDK key
+ * @param configuration.timeout_milliseconds - Optional timeout in milliseconds for the network requests
+ * @param configuration.implemented_features - Optional array of implemented features. Required for certain features like Silent Verification
+ * @param configuration.max_retries - Optional maximum number of automatic network retries in case of server failures
+ * @returns A promise that resolves with the dispatchId result
+ */
 export declare function dispatchSignals(configuration?: {
     sdk_key: string;
     endpoint?: string;
     timeout_milliseconds?: number;
     implemented_features?: Features[];
+    max_retries?: number;
 }): Promise<string>;
+/**
+ * Initiates a silent verification process of the user's phone number.
+ *  The signals have to be dispatched beforehand using `dispatchSignals` with the `SilentVerification` feature enabled.
+ *
+ * @param configuration - Configuration options for verification
+ * @param configuration.sdk_key - Your Prelude SDK key
+ * @param configuration.request_url - The URL to verify
+ * @returns A promise that resolves with the verification result
+ */
 export declare function verifySilent(configuration: {
     sdk_key: string;
     request_url: string;

package/build/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,wBAAsB,eAAe,CACnC,aAAa,GAAE;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,oBAAoB,CAAC,EAAE,QAAQ,EAAE,CAAC;CACnB,GAAG,OAAO,CAAC,MAAM,CAAC,CAOpC;AAED,wBAAsB,YAAY,CAAC,aAAa,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAE3G;AAED,oBAAY,QAAQ;IAClB,kBAAkB,IAAS;CAC5B"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AACH,wBAAsB,eAAe,CACnC,aAAa,GAAE;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,oBAAoB,CAAC,EAAE,QAAQ,EAAE,CAAC;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;CACN,GAAG,OAAO,CAAC,MAAM,CAAC,CAQpC;AAED;;;;;;;;GAQG;AACH,wBAAsB,YAAY,CAAC,aAAa,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAE3G;AAED,oBAAY,QAAQ;IAClB,kBAAkB,IAAS;CAC5B"}

package/build/index.js

@@ -1,7 +1,26 @@
 import PreludeReactNativeSdkModule from './PreludeReactNativeSdkModule';
+/**
+ * Dispatches signals to the Prelude service.
+ *
+ * @param configuration - Configuration options for dispatching signals
+ * @param configuration.sdk_key - Your Prelude SDK key
+ * @param configuration.timeout_milliseconds - Optional timeout in milliseconds for the network requests
+ * @param configuration.implemented_features - Optional array of implemented features. Required for certain features like Silent Verification
+ * @param configuration.max_retries - Optional maximum number of automatic network retries in case of server failures
+ * @returns A promise that resolves with the dispatchId result
+ */
 export async function dispatchSignals(configuration = { sdk_key: '' }) {
-    return await PreludeReactNativeSdkModule.dispatchSignals(configuration.sdk_key, configuration.endpoint, configuration.timeout_milliseconds, toRawValue(configuration.implemented_features || []));
+    return await PreludeReactNativeSdkModule.dispatchSignals(configuration.sdk_key, configuration.endpoint, configuration.timeout_milliseconds, toRawValue(configuration.implemented_features || []), configuration.max_retries);
 }
+/**
+ * Initiates a silent verification process of the user's phone number.
+ *  The signals have to be dispatched beforehand using `dispatchSignals` with the `SilentVerification` feature enabled.
+ *
+ * @param configuration - Configuration options for verification
+ * @param configuration.sdk_key - Your Prelude SDK key
+ * @param configuration.request_url - The URL to verify
+ * @returns A promise that resolves with the verification result
+ */
 export async function verifySilent(configuration) {
     return await PreludeReactNativeSdkModule.verifySilent(configuration.sdk_key, configuration.request_url);
 }

package/build/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,2BAA2B,MAAM,+BAA+B,CAAC;AAExE,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,gBAKI,EAAC,OAAO,EAAE,EAAE,EAAC;IACjB,OAAO,MAAM,2BAA2B,CAAC,eAAe,CACpD,aAAa,CAAC,OAAO,EACrB,aAAa,CAAC,QAAQ,EACtB,aAAa,CAAC,oBAAoB,EAClC,UAAU,CAAC,aAAa,CAAC,oBAAoB,IAAI,EAAE,CAAC,CACvD,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,aAAuD;IACxF,OAAO,MAAM,2BAA2B,CAAC,YAAY,CAAC,aAAa,CAAC,OAAO,EAAE,aAAa,CAAC,WAAW,CAAC,CAAC;AAC1G,CAAC;AAED,MAAM,CAAN,IAAY,QAEX;AAFD,WAAY,QAAQ;IAClB,mEAA2B,CAAA;AAC7B,CAAC,EAFW,QAAQ,KAAR,QAAQ,QAEnB;AAED,SAAS,UAAU,CAAC,QAAoB;IACtC,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,OAAO,EAAE,EAAE,CAAC,GAAG,GAAG,OAAO,EAAE,CAAC,CAAC,CAAC;AAC7D,CAAC","sourcesContent":["import PreludeReactNativeSdkModule from './PreludeReactNativeSdkModule';\n\nexport async function dispatchSignals(\n  configuration: {\n    sdk_key: string;\n    endpoint?: string;\n    timeout_milliseconds?: number;\n    implemented_features?: Features[];\n  } = {sdk_key: ''}): Promise<string> {\n  return await PreludeReactNativeSdkModule.dispatchSignals(\n      configuration.sdk_key,\n      configuration.endpoint,\n      configuration.timeout_milliseconds,\n      toRawValue(configuration.implemented_features || []),\n  );\n}\n\nexport async function verifySilent(configuration: { sdk_key: string, request_url: string }): Promise<string> {\n  return await PreludeReactNativeSdkModule.verifySilent(configuration.sdk_key, configuration.request_url);\n}\n\nexport enum Features {\n  SilentVerification = 1 << 0,\n}\n\nfunction toRawValue(features: Features[]): number {\n  return features.reduce((acc, feature) => acc | feature, 0);\n}"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,2BAA2B,MAAM,+BAA+B,CAAC;AAExE;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,gBAMI,EAAC,OAAO,EAAE,EAAE,EAAC;IACjB,OAAO,MAAM,2BAA2B,CAAC,eAAe,CACpD,aAAa,CAAC,OAAO,EACrB,aAAa,CAAC,QAAQ,EACtB,aAAa,CAAC,oBAAoB,EAClC,UAAU,CAAC,aAAa,CAAC,oBAAoB,IAAI,EAAE,CAAC,EACpD,aAAa,CAAC,WAAW,CAC5B,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,aAAuD;IACxF,OAAO,MAAM,2BAA2B,CAAC,YAAY,CAAC,aAAa,CAAC,OAAO,EAAE,aAAa,CAAC,WAAW,CAAC,CAAC;AAC1G,CAAC;AAED,MAAM,CAAN,IAAY,QAEX;AAFD,WAAY,QAAQ;IAClB,mEAA2B,CAAA;AAC7B,CAAC,EAFW,QAAQ,KAAR,QAAQ,QAEnB;AAED,SAAS,UAAU,CAAC,QAAoB;IACtC,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,OAAO,EAAE,EAAE,CAAC,GAAG,GAAG,OAAO,EAAE,CAAC,CAAC,CAAC;AAC7D,CAAC","sourcesContent":["import PreludeReactNativeSdkModule from './PreludeReactNativeSdkModule';\n\n/**\n * Dispatches signals to the Prelude service.\n *\n * @param configuration - Configuration options for dispatching signals\n * @param configuration.sdk_key - Your Prelude SDK key\n * @param configuration.timeout_milliseconds - Optional timeout in milliseconds for the network requests\n * @param configuration.implemented_features - Optional array of implemented features. Required for certain features like Silent Verification\n * @param configuration.max_retries - Optional maximum number of automatic network retries in case of server failures\n * @returns A promise that resolves with the dispatchId result\n */\nexport async function dispatchSignals(\n  configuration: {\n    sdk_key: string;\n    endpoint?: string;\n    timeout_milliseconds?: number;\n    implemented_features?: Features[];\n    max_retries?: number;\n  } = {sdk_key: ''}): Promise<string> {\n  return await PreludeReactNativeSdkModule.dispatchSignals(\n      configuration.sdk_key,\n      configuration.endpoint,\n      configuration.timeout_milliseconds,\n      toRawValue(configuration.implemented_features || []),\n      configuration.max_retries\n  );\n}\n\n/**\n * Initiates a silent verification process of the user's phone number.\n *  The signals have to be dispatched beforehand using `dispatchSignals` with the `SilentVerification` feature enabled.\n *\n * @param configuration - Configuration options for verification\n * @param configuration.sdk_key - Your Prelude SDK key\n * @param configuration.request_url - The URL to verify\n * @returns A promise that resolves with the verification result\n */\nexport async function verifySilent(configuration: { sdk_key: string, request_url: string }): Promise<string> {\n  return await PreludeReactNativeSdkModule.verifySilent(configuration.sdk_key, configuration.request_url);\n}\n\nexport enum Features {\n  SilentVerification = 1 << 0,\n}\n\nfunction toRawValue(features: Features[]): number {\n  return features.reduce((acc, feature) => acc | feature, 0);\n}"]}

package/ios/PreludeReactNativeSdkModule.swift

@@ -4,10 +4,10 @@ public class PreludeReactNativeSdkModule: Module {
     public func definition() -> ModuleDefinition {
         Name("PreludeReactNativeSdk")
 
-        AsyncFunction("dispatchSignals") { (sdkKey: String, endpointUrl: String?, timeoutMilliseconds: Int64?, implementedFeaturesRawValue: Int64?) in
+        AsyncFunction("dispatchSignals") { (sdkKey: String, endpointUrl: String?, timeoutMilliseconds: Int64?, implementedFeaturesRawValue: Int64?, maxRetries: Int?) in
             let endpoint = endpointUrl != nil ? Endpoint.custom(endpointUrl!) : .default
-            let timeout = timeoutMilliseconds != nil ? TimeInterval(timeoutMilliseconds!) / 1000 : 2.0
-            
+            let timeout = timeoutMilliseconds != nil ? TimeInterval(timeoutMilliseconds!) / 1000 : 10.0
+
             let implementedFeatures: Features
             if let rawValue = implementedFeaturesRawValue {
                 let uintRawValue = rawValue >= 0 ? rawValue : 0
@@ -15,12 +15,14 @@ public class PreludeReactNativeSdkModule: Module {
             } else {
                 implementedFeatures = []
             }
+            let maxRetries = maxRetries ?? 3
 
             let configuration = Configuration(
                 sdkKey: sdkKey,
                 endpoint: endpoint,
                 implementedFeatures: implementedFeatures,
-                timeout: timeout
+                timeout: timeout,
+                maxRetries: maxRetries
             )
 
             let prelude = Prelude(configuration)
@@ -32,21 +34,19 @@ public class PreludeReactNativeSdkModule: Module {
             if sdkKey.isEmpty || requestUrl.isEmpty {
                 throw Exception(name: "IllegalArguments",
                                 description: "SDK Key and Request URL must both be provided.",
-                                code: "ILLEGAL_ARGUMENTS_EMPTY_FIELD"
-                )
+                                code: "ILLEGAL_ARGUMENTS_EMPTY_FIELD")
             }
 
             let configuration = Configuration(
-                sdkKey: sdkKey,
-                )
+                sdkKey: sdkKey
+            )
 
             let prelude = Prelude(configuration)
 
             guard let url = URL(string: requestUrl) else {
                 throw Exception(name: "IllegalArguments",
                                 description: "Request URL must be a valid URL.",
-                                code: "ILLEGAL_ARGUMENTS_INVALID_URL"
-                )
+                                code: "ILLEGAL_ARGUMENTS_INVALID_URL")
             }
 
             return try await prelude.verifySilent(url: url)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@prelude.so/react-native-sdk",
-  "version": "0.3.2",
+  "version": "0.3.4",
   "description": "Prelude SDK for React Native",
   "main": "build/index.js",
   "types": "build/index.d.ts",
@@ -30,7 +30,8 @@
     "scripts/*",
     "src/*",
     "expo-module.config.json",
-    "tsconfig.json"
+    "tsconfig.json",
+    "CHANGELOG.md"
   ],
   "repository": "https://github.com/prelude-so/react-native-sdk",
   "bugs": {
@@ -53,6 +54,6 @@
     "react-native": "*"
   },
   "so_prelude": {
-    "apple_sdk_tag": "0.2.3"
+    "apple_sdk_tag": "0.2.5"
   }
 }

package/src/index.ts

@@ -1,20 +1,41 @@
 import PreludeReactNativeSdkModule from './PreludeReactNativeSdkModule';
 
+/**
+ * Dispatches signals to the Prelude service.
+ *
+ * @param configuration - Configuration options for dispatching signals
+ * @param configuration.sdk_key - Your Prelude SDK key
+ * @param configuration.timeout_milliseconds - Optional timeout in milliseconds for the network requests
+ * @param configuration.implemented_features - Optional array of implemented features. Required for certain features like Silent Verification
+ * @param configuration.max_retries - Optional maximum number of automatic network retries in case of server failures
+ * @returns A promise that resolves with the dispatchId result
+ */
 export async function dispatchSignals(
   configuration: {
     sdk_key: string;
     endpoint?: string;
     timeout_milliseconds?: number;
     implemented_features?: Features[];
+    max_retries?: number;
   } = {sdk_key: ''}): Promise<string> {
   return await PreludeReactNativeSdkModule.dispatchSignals(
       configuration.sdk_key,
       configuration.endpoint,
       configuration.timeout_milliseconds,
       toRawValue(configuration.implemented_features || []),
+      configuration.max_retries
   );
 }
 
+/**
+ * Initiates a silent verification process of the user's phone number.
+ *  The signals have to be dispatched beforehand using `dispatchSignals` with the `SilentVerification` feature enabled.
+ *
+ * @param configuration - Configuration options for verification
+ * @param configuration.sdk_key - Your Prelude SDK key
+ * @param configuration.request_url - The URL to verify
+ * @returns A promise that resolves with the verification result
+ */
 export async function verifySilent(configuration: { sdk_key: string, request_url: string }): Promise<string> {
   return await PreludeReactNativeSdkModule.verifySilent(configuration.sdk_key, configuration.request_url);
 }