v15.1.0 release

Author: RN SDK Release User

.editorconfig

@@ -0,0 +1,5 @@
+[*]
+indent_size = 2
+
+[*.java]
+indent_size = 4

CHANGELOG.md

@@ -5,6 +5,12 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/)
 and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.html).
 
+## Future version
+
+### Fixed:
+
+- Fixed Kosovo XKX country code support
+
 ## [15.0.0] - 2025-08-06
 
 ### Changed:

README.md

@@ -667,6 +667,27 @@ For example:
 }
 ```
 
+### User analytics
+
+#### Implementation
+1. Provide a custom callback using `Onfido.addAnalyticsCallback`
+
+```typescript
+
+type Event = {
+  type: string
+  properties: Record<string, string>
+} |  {
+  name: string
+  properties: Record<string, string>
+}
+
+Onfido.addAnalyticsCallback((event:Event) => {});
+```
+
+Please see the documentation for the [ios](https://documentation.onfido.com/sdk/ios/#user-analytics) and
+[android](https://documentation.onfido.com/sdk/android/#kotlin-15) event structure.
+
 ### Custom biometric token storage
 
 When using the authentication with local storage solution, by default the SDK manages biometric token storage. The SDK also allows the clients to take control of the token lifecycle and exposes an API to override the default implementation to read and write the token, so it can be stored on device, in cloud, in a keystore or on your premises.

android/src/main/AndroidManifest.xml

@@ -8,6 +8,6 @@
 
         <meta-data
             android:name="onfido_integration_version"
-            android:value="15.0.0" />
+            android:value="15.1.0" />
     </application>
 </manifest>

android/src/main/java/com/onfido/reactnative/sdk/AnalyticsCallbackBridge.java

@@ -0,0 +1,36 @@
+package com.onfido.reactnative.sdk;
+
+import androidx.annotation.NonNull;
+
+import com.facebook.react.bridge.Arguments;
+import com.facebook.react.bridge.ReactApplicationContext;
+import com.facebook.react.modules.core.DeviceEventManagerModule;
+import com.onfido.android.sdk.capture.analytics.OnfidoAnalyticsEvent;
+import com.onfido.android.sdk.capture.analytics.OnfidoAnalyticsEventListener;
+
+public class AnalyticsCallbackBridge implements OnfidoAnalyticsEventListener {
+
+    public static final String CALLBACK_NAME = "onfidoAnalyticsCallback";
+    private final ReactApplicationContext reactContext;
+
+    public AnalyticsCallbackBridge(ReactApplicationContext reactContext) {
+        this.reactContext = reactContext;
+    }
+
+    @Override
+    public void onEvent(@NonNull OnfidoAnalyticsEvent event) {
+
+        var properties = Arguments.createMap();
+        for (var entry : event.getProperties().entrySet()) {
+            properties.putString(entry.getKey().toString(), entry.getValue());
+        }
+
+        var params = Arguments.createMap();
+        params.putString("type", event.getType().toString());
+        params.putMap("properties", properties);
+
+        reactContext
+            .getJSModule(DeviceEventManagerModule.RCTDeviceEventEmitter.class)
+            .emit(CALLBACK_NAME, params);
+    }
+}

android/src/main/java/com/onfido/reactnative/sdk/OnfidoSdkModule.java

@@ -3,6 +3,8 @@
 import android.annotation.SuppressLint;
 import android.app.Activity;
 
+import androidx.annotation.NonNull;
+
 import com.facebook.react.bridge.Promise;
 import com.facebook.react.bridge.ReactApplicationContext;
 import com.facebook.react.bridge.ReactContextBaseJavaModule;
@@ -17,6 +19,8 @@
 import com.onfido.android.sdk.capture.OnfidoConfig;
 import com.onfido.android.sdk.capture.OnfidoFactory;
 import com.onfido.android.sdk.capture.OnfidoTheme;
+import com.onfido.android.sdk.capture.analytics.OnfidoAnalyticsEvent;
+import com.onfido.android.sdk.capture.analytics.OnfidoAnalyticsEventListener;
 import com.onfido.android.sdk.capture.config.BiometricTokenCallback;
 import com.onfido.android.sdk.capture.config.MediaCallback;
 import com.onfido.android.sdk.capture.errors.EnterpriseFeatureNotEnabledException;
@@ -38,7 +42,8 @@
 // Analytics to be re-added once payloads are harmonised across platforms
 enum CallbackType {
     MEDIA,
-    BIOMETRIC_TOKEN
+    BIOMETRIC_TOKEN,
+    ANALYTICS
 }
 
 public class OnfidoSdkModule extends ReactContextBaseJavaModule {
@@ -89,16 +94,14 @@ public void start(final ReadableMap config, final Promise promise) {
             try {
                 sdkToken = getSdkTokenFromConfig(config);
             } catch (Exception e) {
-                currentPromise.reject("config_error", e);
-                currentPromise = null;
-                return;
+              reject("config_error", e);
+              return;
             }
 
             Activity currentActivity = getCurrentActivityInParentClass();
             if (currentActivity == null) {
-                currentPromise.reject("error", new Exception("Android activity does not exist"));
-                currentPromise = null;
-                return;
+              reject("error", new Exception("Android activity does not exist"));
+              return;
             }
 
             try {
@@ -110,25 +113,26 @@ public void start(final ReadableMap config, final Promise promise) {
                     defaultSDKConfiguration(config, currentActivity, sdkToken);
                 }
             } catch (final EnterpriseFeaturesInvalidLogoCobrandingException e) {
-                currentPromise.reject("error", new EnterpriseFeaturesInvalidLogoCobrandingException());
-                currentPromise = null;
+              reject("error", new EnterpriseFeaturesInvalidLogoCobrandingException());
             } catch (final EnterpriseFeatureNotEnabledException e) {
-                currentPromise.reject("error", e);
-                currentPromise = null;
+              reject("error", e);
             } catch (final Exception e) {
-                currentPromise.reject("error", new Exception(e.getMessage(), e));
-                currentPromise = null;
+              reject("error", new Exception(e.getMessage(), e));
             }
 
         } catch (final Exception e) {
             e.printStackTrace();
             // Wrap all unexpected exceptions.
-            currentPromise.reject("error", new Exception("Unexpected error starting Onfido page", e));
-            currentPromise = null;
+          reject("error", new Exception("Unexpected error starting Onfido page", e));
         }
     }
 
-    @SuppressLint("UnsafeOptInUsageError")
+  private void reject(String config_error, Exception e) {
+    currentPromise.reject(config_error, e);
+    currentPromise = null;
+  }
+
+  @SuppressLint("UnsafeOptInUsageError")
     private void workflowSDKConfiguration(final ReadableMap config, Activity currentActivity, String sdkToken) throws Exception {
         final String workflowRunId = getWorkflowRunIdFromConfig(config);
 
@@ -149,6 +153,10 @@ private void workflowSDKConfiguration(final ReadableMap config, Activity current
             onfidoConfigBuilder.withBiometricTokenCallback(addBiometricTokenCallback());
         }
 
+        if (callbackTypeList.contains(CallbackType.ANALYTICS)) {
+            onfidoConfigBuilder.withAnalyticsEventListener(new AnalyticsCallbackBridge(getReactApplicationContext()));
+        }
+
         OnfidoTheme onfidoTheme = getThemeFromConfig(config);
         if (onfidoTheme != null) {
             onfidoConfigBuilder.withTheme(onfidoTheme);
@@ -182,6 +190,10 @@ private void defaultSDKConfiguration(final ReadableMap config, Activity currentA
             onfidoConfigBuilder.withMediaCallback(addMediaCallback());
         }
 
+        if (callbackTypeList.contains(CallbackType.ANALYTICS)) {
+            onfidoConfigBuilder.withAnalyticsEventListener(new AnalyticsCallbackBridge(getReactApplicationContext()));
+        }
+
         NFCOptions nfcOption = getNFCOptionFromConfig(config);
         onfidoConfigBuilder.withNFC(nfcOption);
 
@@ -215,9 +227,8 @@ private EnterpriseFeatures.Builder getEnterpriseFeatures(final ReadableMap confi
                     currentActivity.getApplicationContext().getPackageName()
             );
             if (cobrandLogoLight == 0 || cobrandLogoDark == 0) {
-                currentPromise.reject("error", new Exception("Cobrand logos were not found"));
-                currentPromise = null;
-                return null;
+              reject("error", new Exception("Cobrand logos were not found"));
+              return null;
             }
             enterpriseFeaturesBuilder.withCobrandingLogo(cobrandLogoLight, cobrandLogoDark);
             hasSetEnterpriseFeatures = true;
@@ -532,6 +543,11 @@ public void withBiometricTokenCallback() {
         callbackTypeList.add(CallbackType.BIOMETRIC_TOKEN);
     }
 
+    @ReactMethod
+    public void withAnalyticsCallback() {
+        callbackTypeList.add(CallbackType.ANALYTICS);
+    }
+
     @ReactMethod
     public void provideBiometricToken(String biometricToken) {
         biometricTokenCallback.provideToken(biometricToken);