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

package/README.md

@@ -1,51 +1,59 @@
 # Readme
 ## Using the Expo React Native SDK
 
-The Expo React Native SDK allows you to capture certain device signals (both in Android and iOS) that will be reported back to Prelude and perform silent verification of mobile devices.
+The Expo React Native SDK allows you to gather device signals and perform silent verification of mobile devices.
+
+### Gathering Device Signals
+The SDK allows you to capture certain device signals (both in Android and iOS) that will be reported back to Prelude.
 
 It is provided as an Expo module that you can integrate into your React Native Expo Application.
 
-The Android `minSdkVersion` value in the SDK is set to 26 (Android 8.0). If your application has a lower value you may need to update it.
+The Android `minSdkVersion` value in the SDK is set to 26 (Android 8.0). If you application has a lower value you may need to update it.
+
+#### Configuring the project
 
-You can install the SDK dependency directly from npm:
+First install the SDK dependency in your app:
 
 ```
 npm install @prelude.so/react-native-sdk
 ```
 
-You will need to have the Prelude SDK key that you generate in the Prelude dashboard for your account.
-
-***Important: When you generate the SDK key in the Prelude dashboard you will be able to copy it and you should store it somewhere secure, as the dashboard will not allow you to display the same key again.***
-
-### Gathering Device Signals
-
-**Note**: Starting with v0.3.0 of the SDK, we have removed the status event and made the `dispatchSignals` function return a promise that resolves to the dispatch identifier, simplifying its usage.
-
-To collect the device signals in your application you can use code like this:
+Then, where ever in your application you want to report the device signals you can use code like this:
 
 ```
 ...
+// Import the react state types
+import { useEffect, useState } from "react";
 // Import the SDK types
 import * as PreludeReactNativeSdk from '@prelude.so/react-native-sdk';
 ...
 
+// Define a state to receive status updates
+const [dispatchStatus, setDispatchStatus] = useState({ dispatchID: "", status: "" });
+
+...
+// Subscribe to the event
+useEffect(() => {
+    const subscription = PreludeReactNativeSdk.onDispatchingSignals((dispatchingSignalsStatus) => {
+      console.log("Dispatch status: " + dispatchingSignalsStatus.status + ". Id: " + dispatchingSignalsStatus.dispatchID);
+      setDispatchStatus(dispatchingSignalsStatus);
+    });
+
+    return () => {
+      subscription.remove();
+    }
+  }, [dispatchStatus]);
+
 ...
 // Submit the signals in any of your app event handlers (here is a button example)
-<Button title={`Dispatch Signals`} onPress={ async () =>
-  {
-    try {
-        const dispatchId = await PreludeReactNativeSdk.dispatchSignals({
-          sdk_key: "YOUR_SDK_KEY", // Replace with your Prelude SDK key
-        });
-
-        // Handle the dispatch ID as needed,
-        // e.g., store it or continue with verification here
-        alert(`Dispatch ID: ${dispatchId}`);
-    } catch (error) {
-        alert(`Signals dispatch error: ${error.message}`);
-    }
-  }}
-/>
+<Button title={`Dispatch Signals`} onPress={() =>
+  PreludeReactNativeSdk.dispatchSignals({
+      sdk_key: "YOUR-SDK-KEY"
+    })
+    .catch((error) => {
+        console.log("Dispatch error: " + error);
+    })
+} />
 
 ```
 
@@ -61,16 +69,41 @@ or
 npx expo run:android
 ```
 
-Once you get the dispatch identifier through the event, you can report it back to your own API to be forwarded in subsequent network calls.
-
-There is no restriction on when to call this API, you just need to take this action before you need to report back the dispatch ID.
+Once you get the dispatch ID through the event, you can report it back to your own API to be forwarded in subsequent network calls.
 
-The recommended way of integrating it is to call the `dispatchSignals` function before displaying the phone number verification screen in your application. This way you can ensure that the device signals are captured and the `dispatchID` can be sent to your back-end with the phone number. Your back-end will then perform the verification call to Prelude with the phone number and the dispatch identifier.
+There is no restriction on when to call this API, you just need to take this action before you need to report back the dispatch ID. It is advisable to make the request early on during the user onboarding process to have the dispatch id available when required.
 
 ### Silent Verification
 
-The Silent Verification feature allows you to verify a phone number without requiring the user to manually enter a verification code.
+The Silent Verification feature allows you to verify a phone number without requiring the user to enter a verification code. It is available for certain carriers and requires a server-side service to handle the verification process.
 
-It is available for certain carriers and requires a server-side service to handle the verification process. For this verification method to work properly, you *must* collect the device signals mentioned before and report the dispatch identifier to your back-end (usually in your APIs verification endpoint).
+The SDK provides a simple API to initiate the verification process and handle the response.
 
-Please refer to the [Silent Verification documentation](https://docs.prelude.so/verify/silent/overview) for more information on how to implement this feature.
+We assume here that you have a server-side service that exposes the 2 endpoints, one to start the verification and another to check the final code. In this sample code we expose those endpoints via an `Api` module that will call each endpoint via a separate function.
+
+When calling the verification API, you will need to provide the phone number to verify. The API will return a request URL that the SDK will navigate to in order to complete the verification process.
+
+```typescript
+// Import the SDK types and your API module
+import * as PreludeReactNativeSdk from '@prelude.so/react-native-sdk';
+import * as Api from './YourBackendApi';
+
+// Call the verification endpoint with the phone number.
+// If the phone number is compatible with the Silent Verification feature, 
+// the API will return a request URL that the SDK will navigate to.
+const request_url = await Api.verify(phone_number);
+
+// Then call the verifySilent method with the SDK key and the request URL.
+// If the verification is successful, the SDK will return a code that you 
+// can use to check the verification status.
+var code = await PreludeReactNativeSdk.verifySilent({
+    sdk_key: sdk_key,
+    request_url: request_url,
+});
+
+// Finally, call the checkSilent method with the phone number and the code
+// Your API should handle the check and return the verification status.
+const check_status = await Api.check(phone_number, code);
+
+// Handle the verification status as needed in your application
+```

package/android/build.gradle

@@ -1,7 +1,7 @@
 apply plugin: 'com.android.library'
 
 group = 'so.prelude.reactnative.sdk'
-version = '0.2.0'
+version = '0.2.2'
 
 def expoModulesCorePlugin = new File(project(":expo-modules-core").projectDir.absolutePath, "ExpoModulesCorePlugin.gradle")
 apply from: expoModulesCorePlugin
@@ -35,7 +35,7 @@ android {
   namespace "so.prelude.reactnative.sdk"
   defaultConfig {
     versionCode 1
-    versionName "0.2.0"
+    versionName version
   }
   lintOptions {
     abortOnError false
@@ -43,5 +43,6 @@ android {
 }
 
 dependencies {
-  implementation('so.prelude.android:sdk:0.2.0')
+  compileOnly('com.squareup.okhttp3:okhttp:4.12.0')
+  implementation('so.prelude.android:sdk:0.2.2')
 }

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

@@ -6,47 +6,61 @@ import expo.modules.kotlin.modules.ModuleDefinition
 import so.prelude.android.sdk.Configuration
 import so.prelude.android.sdk.Configuration.Companion.DEFAULT_REQUEST_TIMEOUT
 import so.prelude.android.sdk.Endpoint
+import so.prelude.android.sdk.Features
 import so.prelude.android.sdk.Prelude
 import java.net.URL
 
 class PreludeReactNativeSdkModule : Module() {
-    override fun definition() = ModuleDefinition {
-        Name("PreludeReactNativeSdk")
+    override fun definition() =
+        ModuleDefinition {
+            Name("PreludeReactNativeSdk")
 
-        AsyncFunction("dispatchSignals") Coroutine { sdkKey: String, endpointUrl: String?, timeoutMilliseconds: Long? ->
-            dispatchSignals(endpointUrl, sdkKey, timeoutMilliseconds)
-        }
+            AsyncFunction("dispatchSignals") Coroutine {
+                sdkKey: String,
+                endpointUrl: String?,
+                timeoutMilliseconds: Long?,
+                implementedFeaturesRawValue: Long?,
+                ->
+                dispatchSignals(endpointUrl, sdkKey, timeoutMilliseconds, implementedFeaturesRawValue ?: 0L)
+            }
 
-        AsyncFunction("verifySilent") Coroutine { sdkKey: String, requestUrl: String ->
-            verifySilent(
-                sdkKey = sdkKey,
-                requestUrl = requestUrl
-            )
+            AsyncFunction("verifySilent") Coroutine { sdkKey: String, requestUrl: String ->
+                verifySilent(
+                    sdkKey = sdkKey,
+                    requestUrl = requestUrl,
+                )
+            }
         }
-    }
 
     private suspend fun dispatchSignals(
         endpointUrl: String?,
         sdkKey: String,
-        timeoutMilliseconds: Long?
+        timeoutMilliseconds: Long?,
+        implementedFeaturesRawValue: Long = 0L,
     ): String {
-        val endpoint: Endpoint = endpointUrl?.let {
-            Endpoint.Custom(it)
-        } ?: Endpoint.Default
+        val endpoint: Endpoint =
+            endpointUrl?.let {
+                Endpoint.Custom(
+                    address = it,
+                )
+            } ?: Endpoint.Default
 
-        val context = appContext.reactContext
-            ?: throw IllegalStateException(
-                "Invalid React Android Context. Cannot dispatch signals"
-            )
+        val context =
+            appContext.reactContext
+                ?: throw IllegalStateException(
+                    "Invalid React Android Context. Cannot dispatch signals",
+                )
 
-        val config = Configuration(
-            context.applicationContext,
-            sdkKey,
-            endpoint,
-            requestTimeout = timeoutMilliseconds ?: DEFAULT_REQUEST_TIMEOUT
-        )
+        val config =
+            Configuration(
+                context = context.applicationContext,
+                sdkKey = sdkKey,
+                endpoint = endpoint,
+                requestTimeout = timeoutMilliseconds ?: DEFAULT_REQUEST_TIMEOUT,
+                implementedFeatures = Features.fromRawValue(implementedFeaturesRawValue),
+            )
         val prelude = Prelude(config)
-                
+
         return prelude.dispatchSignals().getOrThrow()
     }
 
@@ -54,10 +68,11 @@ class PreludeReactNativeSdkModule : Module() {
         sdkKey: String,
         requestUrl: String,
     ): String {
-        val context = appContext.reactContext
-            ?: throw IllegalStateException(
-                "Invalid React Android Context. Cannot perform silent verification"
-            )
+        val context =
+            appContext.reactContext
+                ?: throw IllegalStateException(
+                    "Invalid React Android Context. Cannot perform silent verification",
+                )
 
         if (sdkKey.isBlank() || requestUrl.isBlank()) {
             throw IllegalArgumentException("SDK Key and Request URL must both be provided.")

package/build/index.d.ts

@@ -1,10 +1,14 @@
-export declare function dispatchSignals(configuration: {
+export declare function dispatchSignals(configuration?: {
     sdk_key: string;
     endpoint?: string;
     timeout_milliseconds?: number;
+    implemented_features?: Features[];
 }): Promise<string>;
 export declare function verifySilent(configuration: {
     sdk_key: string;
     request_url: string;
 }): Promise<string>;
+export declare enum Features {
+    SilentVerification = 1
+}
 //# 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,wBAAsB,eAAe,CACnC,aAAa,EAAE;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B,GAAG,OAAO,CAAC,MAAM,CAAC,CAEpB;AAED,wBAAsB,YAAY,CAAC,aAAa,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAE3G"}
+{"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"}

package/build/index.js

@@ -1,8 +1,15 @@
 import PreludeReactNativeSdkModule from './PreludeReactNativeSdkModule';
-export async function dispatchSignals(configuration) {
-    return await PreludeReactNativeSdkModule.dispatchSignals(configuration.sdk_key, configuration.endpoint, configuration.timeout_milliseconds);
+export async function dispatchSignals(configuration = { sdk_key: '' }) {
+    return await PreludeReactNativeSdkModule.dispatchSignals(configuration.sdk_key, configuration.endpoint, configuration.timeout_milliseconds, toRawValue(configuration.implemented_features || []));
 }
 export async function verifySilent(configuration) {
     return await PreludeReactNativeSdkModule.verifySilent(configuration.sdk_key, configuration.request_url);
 }
+export var Features;
+(function (Features) {
+    Features[Features["SilentVerification"] = 1] = "SilentVerification";
+})(Features || (Features = {}));
+function toRawValue(features) {
+    return features.reduce((acc, feature) => acc | feature, 0);
+}
 //# 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,2BAA2B,MAAM,+BAA+B,CAAC;AAExE,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,aAIC;IACD,OAAO,MAAM,2BAA2B,CAAC,eAAe,CAAC,aAAa,CAAC,OAAO,EAAE,aAAa,CAAC,QAAQ,EAAE,aAAa,CAAC,oBAAoB,CAAC,CAAC;AAC9I,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","sourcesContent":["import PreludeReactNativeSdkModule from './PreludeReactNativeSdkModule';\n\nexport async function dispatchSignals(\n  configuration: {\n    sdk_key: string;\n    endpoint?: string;\n    timeout_milliseconds?: number;\n  }): Promise<string> {\n  return await PreludeReactNativeSdkModule.dispatchSignals(configuration.sdk_key, configuration.endpoint, configuration.timeout_milliseconds);\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"]}
+{"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}"]}

package/ios/PreludeReactNativeSdkModule.swift

@@ -1,46 +1,55 @@
 import ExpoModulesCore
 
 public class PreludeReactNativeSdkModule: Module {
-  public func definition() -> ModuleDefinition {
-    Name("PreludeReactNativeSdk")
-
-    AsyncFunction("dispatchSignals") { (sdkKey: String, endpointUrl: String?, timeoutMilliseconds: Int64?) in
-        let endpoint = endpointUrl != nil ? Endpoint.custom(endpointUrl!) : .default
-        let timeout = timeoutMilliseconds != nil ? TimeInterval(timeoutMilliseconds!) / 1000 : 2.0
-        
-        let configuration = Configuration(
-            sdkKey: sdkKey,
-            endpoint: endpoint,
-            timeout: timeout
-        )
-
-        let prelude = Prelude(configuration)
-
-        return try await prelude.dispatchSignals()
-    }
-      
-    AsyncFunction("verifySilent") { (sdkKey: String, requestUrl: String) in
-        if sdkKey.isEmpty || requestUrl.isEmpty {
-            throw Exception(name: "IllegalArguments",
-                      description: "SDK Key and Request URL must both be provided.",
-                      code: "ILLEGAL_ARGUMENTS_EMPTY_FIELD"
+    public func definition() -> ModuleDefinition {
+        Name("PreludeReactNativeSdk")
+
+        AsyncFunction("dispatchSignals") { (sdkKey: String, endpointUrl: String?, timeoutMilliseconds: Int64?, implementedFeaturesRawValue: Int64?) in
+            let endpoint = endpointUrl != nil ? Endpoint.custom(endpointUrl!) : .default
+            let timeout = timeoutMilliseconds != nil ? TimeInterval(timeoutMilliseconds!) / 1000 : 2.0
+            
+            let implementedFeatures: Features
+            if let rawValue = implementedFeaturesRawValue {
+                let uintRawValue = rawValue >= 0 ? rawValue : 0
+                implementedFeatures = Features(rawValue: UInt64(uintRawValue))
+            } else {
+                implementedFeatures = []
+            }
+
+            let configuration = Configuration(
+                sdkKey: sdkKey,
+                endpoint: endpoint,
+                implementedFeatures: implementedFeatures,
+                timeout: timeout
             )
+
+            let prelude = Prelude(configuration)
+
+            return try await prelude.dispatchSignals()
         }
-        
-        let configuration = Configuration(
-            sdkKey: sdkKey,
-        )
 
-        let prelude = Prelude(configuration)
+        AsyncFunction("verifySilent") { (sdkKey: String, requestUrl: String) in
+            if sdkKey.isEmpty || requestUrl.isEmpty {
+                throw Exception(name: "IllegalArguments",
+                                description: "SDK Key and Request URL must both be provided.",
+                                code: "ILLEGAL_ARGUMENTS_EMPTY_FIELD"
+                )
+            }
 
-        guard let url = URL(string: requestUrl) else {
-            throw Exception(name: "IllegalArguments",
-                      description: "Request URL must be a valid URL.",
-                      code: "ILLEGAL_ARGUMENTS_INVALID_URL"
-            )
+            let configuration = Configuration(
+                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"
+                )
+            }
+
+            return try await prelude.verifySilent(url: url)
         }
-        
-        return try await prelude.verifySilent(url: url)
     }
-  }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@prelude.so/react-native-sdk",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "description": "Prelude SDK for React Native",
   "main": "build/index.js",
   "types": "build/index.d.ts",
@@ -53,6 +53,6 @@
     "react-native": "*"
   },
   "so_prelude": {
-    "apple_sdk_tag": "0.2.1"
+    "apple_sdk_tag": "0.2.3"
   }
 }

package/src/index.ts

@@ -5,10 +5,24 @@ export async function dispatchSignals(
     sdk_key: string;
     endpoint?: string;
     timeout_milliseconds?: number;
-  }): Promise<string> {
-  return await PreludeReactNativeSdkModule.dispatchSignals(configuration.sdk_key, configuration.endpoint, configuration.timeout_milliseconds);
+    implemented_features?: Features[];
+  } = {sdk_key: ''}): Promise<string> {
+  return await PreludeReactNativeSdkModule.dispatchSignals(
+      configuration.sdk_key,
+      configuration.endpoint,
+      configuration.timeout_milliseconds,
+      toRawValue(configuration.implemented_features || []),
+  );
 }
 
 export async function verifySilent(configuration: { sdk_key: string, request_url: string }): Promise<string> {
   return await PreludeReactNativeSdkModule.verifySilent(configuration.sdk_key, configuration.request_url);
 }
+
+export enum Features {
+  SilentVerification = 1 << 0,
+}
+
+function toRawValue(features: Features[]): number {
+  return features.reduce((acc, feature) => acc | feature, 0);
+}