react-native-shield-fraud-plugin 1.0.10 → 2.0.0

package/android/src/main/java/com/shieldfraudplugin/ShieldFraudPluginPackage.java

@@ -2,27 +2,77 @@ package com.shieldfraudplugin;
 
 import androidx.annotation.NonNull;
 
-import com.facebook.react.ReactPackage;
+import com.facebook.react.TurboReactPackage;
 import com.facebook.react.bridge.NativeModule;
 import com.facebook.react.bridge.ReactApplicationContext;
-import com.facebook.react.uimanager.ViewManager;
-
-import java.util.ArrayList;
-import java.util.Collections;
-import java.util.List;
-
-public class ShieldFraudPluginPackage implements ReactPackage {
-  @NonNull
-  @Override
-  public List<NativeModule> createNativeModules(@NonNull ReactApplicationContext reactContext) {
-    List<NativeModule> modules = new ArrayList<>();
-    modules.add(new ShieldFraudPluginModule(reactContext));
-    return modules;
-  }
-
-  @NonNull
-  @Override
-  public List<ViewManager> createViewManagers(@NonNull ReactApplicationContext reactContext) {
-    return Collections.emptyList();
-  }
+import com.facebook.react.module.model.ReactModuleInfo;
+import com.facebook.react.module.model.ReactModuleInfoProvider;
+
+import java.util.HashMap;
+import java.util.Map;
+
+/**
+ * Package registration for ShieldFraudPlugin — works on both architectures.
+ *
+ * Why TurboReactPackage instead of ReactPackage
+ * ─────────────────────────────────────────────
+ * TurboReactPackage is a drop-in replacement for the legacy ReactPackage that
+ * adds support for Turbo Modules (New Architecture) while remaining fully
+ * backward-compatible with the Old Architecture bridge.
+ *
+ * On Old Architecture the isTurboModule flag in ReactModuleInfo is simply
+ * ignored and the module is loaded via the bridge as normal.
+ * On New Architecture the flag tells the runtime to resolve the module through
+ * the Turbo Module system (JSI) instead of the bridge.
+ *
+ * The isTurboModule flag is driven by BuildConfig.IS_NEW_ARCHITECTURE_ENABLED,
+ * which build.gradle sets to true/false based on the newArchEnabled property:
+ *
+ *   buildConfigField "boolean", "IS_NEW_ARCHITECTURE_ENABLED",
+ *                    isNewArchitectureEnabled().toString()
+ */
+public class ShieldFraudPluginPackage extends TurboReactPackage {
+
+    // =========================================================================
+    // Module instantiation
+    // =========================================================================
+
+    @Override
+    public NativeModule getModule(@NonNull String name,
+                                  @NonNull ReactApplicationContext reactContext) {
+        if (name.equals(ShieldFraudPluginModule.NAME)) {
+            return new ShieldFraudPluginModule(reactContext);
+        }
+        return null;
+    }
+
+    // =========================================================================
+    // Module metadata
+    //
+    // ReactModuleInfoProvider returns the metadata the runtime needs to decide
+    // how to load the module:
+    //   • Old Arch  → isTurboModule=false → loaded via JS bridge
+    //   • New Arch  → isTurboModule=true  → loaded via JSI (Turbo Module)
+    // =========================================================================
+
+    @Override
+    public ReactModuleInfoProvider getReactModuleInfoProvider() {
+        return () -> {
+            final boolean isTurboModule = BuildConfig.IS_NEW_ARCHITECTURE_ENABLED;
+            Map<String, ReactModuleInfo> moduleInfos = new HashMap<>();
+            moduleInfos.put(
+                ShieldFraudPluginModule.NAME,
+                new ReactModuleInfo(
+                    ShieldFraudPluginModule.NAME,  // name
+                    ShieldFraudPluginModule.NAME,  // className
+                    false,                          // canOverrideExistingModule
+                    false,                          // needsEagerInit
+                    true,                           // hasConstants
+                    false,                          // isCxxModule
+                    isTurboModule                   // isTurboModule
+                )
+            );
+            return moduleInfos;
+        };
+    }
 }

package/android/src/newarch/java/com/shieldfraudplugin/ShieldFraudPluginSpec.java

@@ -0,0 +1,41 @@
+package com.shieldfraudplugin;
+
+import com.facebook.react.bridge.ReactApplicationContext;
+
+/**
+ * New Architecture base class for ShieldFraudPluginModule.
+ *
+ * Selected by Gradle when newArchEnabled=true.
+ * Extends NativeShieldFraudPluginSpec — the abstract class generated by React
+ * Native's codegen from the TypeScript spec at src/NativeShieldFraudPlugin.ts.
+ *
+ * How the source-set swap works
+ * ─────────────────────────────
+ * build.gradle adds either src/oldarch or src/newarch to the Java source
+ * directories depending on the newArchEnabled project property:
+ *
+ *   sourceSets {
+ *     main {
+ *       if (isNewArchitectureEnabled()) {
+ *         java.srcDirs += ['src/newarch']   // this file is included
+ *       } else {
+ *         java.srcDirs += ['src/oldarch']   // this file is excluded
+ *       }
+ *     }
+ *   }
+ *
+ * ShieldFraudPluginModule (in src/main/) always extends ShieldFraudPluginSpec,
+ * so it compiles correctly regardless of which shim is selected.
+ *
+ * NativeShieldFraudPluginSpec is generated at build time by the React Native
+ * Gradle plugin (com.facebook.react) when New Architecture is enabled.
+ * It declares all methods from the TypeScript spec as abstract — this shim
+ * exists purely to bridge the inheritance chain so ShieldFraudPluginModule
+ * does not need to import the codegen class directly.
+ */
+abstract class ShieldFraudPluginSpec extends NativeShieldFraudPluginSpec {
+
+    protected ShieldFraudPluginSpec(ReactApplicationContext context) {
+        super(context);
+    }
+}

package/android/src/oldarch/java/com/shieldfraudplugin/ShieldFraudPluginSpec.java

@@ -0,0 +1,36 @@
+package com.shieldfraudplugin;
+
+import com.facebook.react.bridge.ReactApplicationContext;
+import com.facebook.react.bridge.ReactContextBaseJavaModule;
+
+/**
+ * Old Architecture base class for ShieldFraudPluginModule.
+ *
+ * Selected by Gradle when newArchEnabled=false (the default).
+ * Extends ReactContextBaseJavaModule — the standard base class for modules
+ * that communicate with JS over the legacy bridge.
+ *
+ * How the source-set swap works
+ * ─────────────────────────────
+ * build.gradle adds either src/oldarch or src/newarch to the Java source
+ * directories depending on the newArchEnabled project property:
+ *
+ *   sourceSets {
+ *     main {
+ *       if (isNewArchitectureEnabled()) {
+ *         java.srcDirs += ['src/newarch']   // this file is excluded
+ *       } else {
+ *         java.srcDirs += ['src/oldarch']   // this file is included
+ *       }
+ *     }
+ *   }
+ *
+ * ShieldFraudPluginModule (in src/main/) always extends ShieldFraudPluginSpec,
+ * so it compiles correctly regardless of which shim is selected.
+ */
+abstract class ShieldFraudPluginSpec extends ReactContextBaseJavaModule {
+
+    protected ShieldFraudPluginSpec(ReactApplicationContext context) {
+        super(context);
+    }
+}

package/ios/ShieldFraudPlugin.h

@@ -1,13 +1,22 @@
 
 #ifdef RCT_NEW_ARCH_ENABLED
+// New Architecture: conform to the codegen-generated spec protocol.
+// RCTEventEmitter is still used as the base so that sendEventWithName: works.
+#import <React/RCTEventEmitter.h>
 #import "RNShieldFraudPluginSpec.h"
 
-@interface ShieldFraudPlugin : NSObject <NativeShieldFraudPluginSpec>
+// Forward-declare the protocol — the full definition is imported in the .mm file.
+// A forward declaration is sufficient for the @interface conformance declaration.
+@protocol DeviceShieldCallback;
+
+@interface ShieldFraudPlugin : RCTEventEmitter <NativeShieldFraudPluginSpec, DeviceShieldCallback>
 #else
+// Old Architecture: standard bridge module + event emitter.
 #import <React/RCTBridgeModule.h>
 #import <React/RCTEventEmitter.h>
 
-@import ShieldFraud;
+// Forward-declare the protocol — full definition imported in the .mm file.
+@protocol DeviceShieldCallback;
 
 @interface ShieldFraudPlugin : RCTEventEmitter <RCTBridgeModule, DeviceShieldCallback>
 #endif

package/ios/ShieldFraudPlugin.mm

@@ -0,0 +1,289 @@
+#import "ShieldFraudPlugin.h"
+
+// Import the auto-generated Swift→ObjC header.
+// This exposes all Swift-exported types (Configuration, Shield, BlockedDialog,
+// LogLevel, Environment, ShieldCrossPlatformHelper, DeviceShieldCallback, …)
+// without requiring Clang module syntax (@import), which fails in Obj-C++ files
+// when C++ modules are not enabled (e.g. when the New Architecture codegen
+// headers are included and the file is compiled as Obj-C++).
+#import <ShieldFraud/ShieldFraud-Swift.h>
+
+@implementation ShieldFraudPlugin
+
+static BOOL isShieldInitialized = NO;
+
+RCT_EXPORT_MODULE();
+
+// =============================================================================
+// MARK: - Shared methods (Old Architecture & New Architecture)
+//
+// These methods have identical signatures in both architectures.
+// RCT_EXPORT_METHOD registers them with the bridge for Old Arch, and the
+// matching Obj-C selectors satisfy the codegen protocol for New Arch.
+// =============================================================================
+
+// Cross-platform SDK metadata (React Native wrapper version / name)
+RCT_EXPORT_METHOD(setCrossPlatformParameters:(NSString *)crossPlatformName
+                  crossPlatformVersion:(NSString *)crossPlatformVersion)
+{
+    ShieldCrossPlatformParams *params = [[ShieldCrossPlatformParams alloc]
+                                            initWithName:crossPlatformName
+                                            version:crossPlatformVersion];
+    [ShieldCrossPlatformHelper setCrossPlatformParameters:params];
+}
+
+// Retrieve the most-recently-computed device result
+RCT_EXPORT_METHOD(getLatestDeviceResult:(RCTResponseSenderBlock)successCallback
+                  errorCallback:(RCTResponseSenderBlock)errorCallback)
+{
+    NSDictionary<NSString *, id> *result = [[Shield shared] getLatestDeviceResult];
+    if (result != NULL) {
+        successCallback(@[result]);
+        return;
+    }
+
+    NSError *error = [[Shield shared] getErrorResponse];
+    if (error != NULL) {
+        errorCallback(@[[error localizedDescription]]);
+        return;
+    }
+
+    errorCallback(@[@"No device result available yet."]);
+}
+
+// Subscribe to real-time device-result state changes
+RCT_EXPORT_METHOD(setDeviceResultStateListener)
+{
+    double delayInSeconds = 1.5;
+    dispatch_time_t popTime = dispatch_time(DISPATCH_TIME_NOW,
+                                            (int64_t)(delayInSeconds * NSEC_PER_SEC));
+    dispatch_after(popTime, dispatch_get_main_queue(), ^(void) {
+        [[Shield shared] setDeviceResultStateListener:^{
+            [self sendEventWithName:@"device_result_state"
+                              body:@{@"status": @"isSDKReady"}];
+        }];
+    });
+}
+
+// Attach arbitrary screen-level attributes
+RCT_EXPORT_METHOD(sendAttributes:(NSString *)screenName
+                  data:(NSDictionary *)data)
+{
+    [[Shield shared] sendAttributesWithScreenName:screenName data:data];
+}
+
+RCT_EXPORT_METHOD(sendAttributesWithCallback:(NSString *)screenName
+                  data:(NSDictionary *)data
+                  successCallback:(RCTResponseSenderBlock)successCallback
+                  errorCallback:(RCTResponseSenderBlock)errorCallback)
+{
+    [[Shield shared] sendAttributesWithScreenName:screenName
+                                             data:data
+                                                :^(BOOL success, NSError *error) {
+        dispatch_async(dispatch_get_main_queue(), ^{
+            if (success) {
+                successCallback(@[@(YES)]);
+                return;
+            }
+
+            NSString *errorMessage = error != nil
+                ? [error localizedDescription]
+                : @"Failed to send attributes.";
+            errorCallback(@[errorMessage]);
+        });
+    }];
+}
+
+// Trigger a device signature computation for a given screen name.
+// The completionHandler fires when the SDK is done; results and errors
+// are read back from getLatestDeviceResult / getErrorResponse.
+RCT_EXPORT_METHOD(sendDeviceSignature:(NSString *)screenName
+                  successCallback:(RCTResponseSenderBlock)successCallback
+                  errorCallback:(RCTResponseSenderBlock)errorCallback)
+{
+    [[Shield shared] sendDeviceSignatureWithScreenName:screenName
+                                    completionHandler:^{
+        dispatch_async(dispatch_get_main_queue(), ^{
+            NSDictionary<NSString *, id> *deviceResult = [[Shield shared] getLatestDeviceResult];
+            if (deviceResult != nil) {
+                successCallback(@[deviceResult]);
+                return;
+            }
+
+            NSError *error = [[Shield shared] getErrorResponse];
+            if (error != nil) {
+                errorCallback(@[[error localizedDescription]]);
+                return;
+            }
+
+            errorCallback(@[@"No device result available."]);
+        });
+    }];
+}
+
+// RCTEventEmitter — declare the events this module can emit
+- (NSArray<NSString *> *)supportedEvents
+{
+    return @[@"success", @"error", @"device_result_state"];
+}
+
+// RCTEventEmitter — required overrides (no-op wrappers keep the base class happy)
+- (void)addListener:(NSString *)eventName
+{
+    [super addListener:eventName];
+}
+
+- (void)removeListeners:(double)count
+{
+    [super removeListeners:count];
+}
+
+// DeviceShieldCallback delegate — forwarded as JS events
+- (void)didErrorWithError:(NSError *)error
+{
+    [self sendEventWithName:@"error" body:[error localizedDescription]];
+}
+
+- (void)didSuccessWithResult:(NSDictionary<NSString *, id> *)result
+{
+    [self sendEventWithName:@"success" body:result];
+}
+
+
+// =============================================================================
+// MARK: - Architecture-specific methods
+// =============================================================================
+
+#ifdef RCT_NEW_ARCH_ENABLED
+
+// -----------------------------------------------------------------------------
+// New Architecture  (Turbo Modules / JSI)
+//
+// Methods are implemented as plain Obj-C methods to directly satisfy the
+// codegen-generated NativeShieldFraudPluginSpec protocol.
+//
+// Key differences from Old Arch:
+//   • initShield  — logLevel/environmentInfo are `double` (JS numbers are
+//                   always doubles); resolve/reject blocks are added for the
+//                   Promise<void> return type declared in the TS spec.
+//   • getSessionId / isShieldInitialized — synchronous return values are
+//                   supported natively by JSI (no blocking-synchronous macro).
+//   • isShieldInitialized — protocol requires NSNumber* so JSI can marshal
+//                   the boolean; returning plain BOOL would be a type mismatch.
+//   • getTurboModule: — wires this Obj-C class into the JSI runtime.
+// -----------------------------------------------------------------------------
+
+- (void)initShield:(NSString *)siteID
+         secretKey:(NSString *)secretKey
+isOptimizedListener:(BOOL)isOptimizedListener
+     blockedDialog:(NSDictionary * _Nullable)blockedDialog
+          logLevel:(double)logLevel
+   environmentInfo:(double)environmentInfo
+blockScreenRecording:(BOOL)blockScreenRecording
+           resolve:(RCTPromiseResolveBlock)resolve
+            reject:(RCTPromiseRejectBlock)reject
+{
+    if (!isShieldInitialized) {
+        Configuration *config = [[Configuration alloc] initWithSiteId:siteID
+                                                            secretKey:secretKey];
+        if (isOptimizedListener) {
+            config.deviceShieldCallback = self;
+        }
+
+        if (blockedDialog != nil) {
+            NSString *title = [blockedDialog objectForKey:@"title"];
+            NSString *body  = [blockedDialog objectForKey:@"body"];
+            config.defaultBlockedDialog = [[BlockedDialog alloc] initWithTitle:title
+                                                                          body:body];
+        }
+
+        // JS numbers arrive as double; cast explicitly to Swift-bridged enum types.
+        config.logLevel    = (LogLevel)(NSInteger)logLevel;
+        config.environment = (Environment)(NSInteger)environmentInfo;
+
+        [Shield setUpWith:config];
+        isShieldInitialized = YES;
+    }
+    resolve(nil);
+}
+
+- (NSString *)getSessionId
+{
+    return [[Shield shared] sessionId];
+}
+
+- (NSNumber *)isShieldInitialized
+{
+    return @(isShieldInitialized);
+}
+
+// Wires this Obj-C class into the JSI runtime.
+// The generated class name follows the codegenConfig "name" in package.json:
+//   "RNShieldFraudPluginSpec"  →  NativeShieldFraudPluginSpecJSI
+- (std::shared_ptr<facebook::react::TurboModule>)getTurboModule:
+    (const facebook::react::ObjCTurboModule::InitParams &)params
+{
+    return std::make_shared<facebook::react::NativeShieldFraudPluginSpecJSI>(params);
+}
+
+#else
+
+// -----------------------------------------------------------------------------
+// Old Architecture  (Bridge)
+//
+// RCT_EXPORT_METHOD      — registers void-return methods with the JS bridge.
+// RCT_EXPORT_BLOCKING_SYNCHRONOUS_METHOD — bridge-only macro for synchronous
+//   return values; has no JSI equivalent and must stay inside #else.
+//
+// Key differences from New Arch:
+//   • initShield  — logLevel/environmentInfo are NSInteger (bridge coerces
+//                   from NSNumber); no resolve/reject (bridge wraps the void
+//                   return automatically).
+//   • getSessionId / isShieldInitialized — must use the blocking-synchronous
+//                   macro so the bridge returns the value to JS synchronously.
+// -----------------------------------------------------------------------------
+
+RCT_EXPORT_METHOD(initShield:(NSString *)siteID
+                  secretKey:(NSString *)secretKey
+                  isOptimizedListener:(BOOL)isOptimizedListener
+                  blockedDialog:(NSDictionary *)blockedDialog
+                  logLevel:(NSInteger)logLevel
+                  environmentInfo:(NSInteger)environmentInfo
+                  blockScreenRecording:(BOOL)blockScreenRecording)
+{
+    if (!isShieldInitialized) {
+        Configuration *config = [[Configuration alloc] initWithSiteId:siteID
+                                                            secretKey:secretKey];
+        if (isOptimizedListener) {
+            config.deviceShieldCallback = self;
+        }
+
+        if (blockedDialog != nil) {
+            NSString *title = [blockedDialog objectForKey:@"title"];
+            NSString *body  = [blockedDialog objectForKey:@"body"];
+            config.defaultBlockedDialog = [[BlockedDialog alloc] initWithTitle:title
+                                                                          body:body];
+        }
+
+        // Cast NSInteger to Swift-bridged enum types explicitly.
+        config.logLevel    = (LogLevel)logLevel;
+        config.environment = (Environment)environmentInfo;
+
+        [Shield setUpWith:config];
+        isShieldInitialized = YES;
+    }
+}
+
+RCT_EXPORT_BLOCKING_SYNCHRONOUS_METHOD(getSessionId)
+{
+    return [[Shield shared] sessionId];
+}
+
+RCT_EXPORT_BLOCKING_SYNCHRONOUS_METHOD(isShieldInitialized)
+{
+    return @(isShieldInitialized);
+}
+
+#endif  // RCT_NEW_ARCH_ENABLED
+
+@end

package/lib/commonjs/NativeShieldFraudPlugin.js

@@ -0,0 +1,15 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _reactNative = require("react-native");
+/**
+ * TypeScript spec for the ShieldFraudPlugin Turbo Module.
+ * This file is used by React Native codegen to auto-generate
+ * native interface code for both iOS and Android.
+ */
+var _default = _reactNative.TurboModuleRegistry.getEnforcing('ShieldFraudPlugin');
+exports.default = _default;
+//# sourceMappingURL=NativeShieldFraudPlugin.js.map

package/lib/commonjs/NativeShieldFraudPlugin.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_reactNative","require","_default","TurboModuleRegistry","getEnforcing","exports","default"],"sourceRoot":"../../src","sources":["NativeShieldFraudPlugin.ts"],"mappings":";;;;;;AACA,IAAAA,YAAA,GAAAC,OAAA;AAEA;AACA;AACA;AACA;AACA;AAJA,IAAAC,QAAA,GAiFeC,gCAAmB,CAACC,YAAY,CAAO,mBAAmB,CAAC;AAAAC,OAAA,CAAAC,OAAA,GAAAJ,QAAA"}

package/lib/commonjs/index.js

@@ -5,10 +5,17 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.default = exports.LogLevel = exports.EnvironmentInfo = void 0;
 var _reactNative = require("react-native");
+/**
+ * Resolve the native module through TurboModuleRegistry (New Architecture)
+ * with a fallback to NativeModules bridge (Old Architecture).
+ */
+const ShieldFraudPluginNativeModule = _reactNative.TurboModuleRegistry.get("ShieldFraudPlugin") ?? _reactNative.NativeModules.ShieldFraudPlugin;
+
 /**
  * Enum representing the log levels for ShieldFraud.
  */
 let LogLevel = /*#__PURE__*/function (LogLevel) {
+  LogLevel[LogLevel["LogLevelVerbose"] = 4] = "LogLevelVerbose";
   LogLevel[LogLevel["LogLevelDebug"] = 3] = "LogLevelDebug";
   LogLevel[LogLevel["LogLevelInfo"] = 2] = "LogLevelInfo";
   LogLevel[LogLevel["LogLevelNone"] = 1] = "LogLevelNone";
@@ -21,9 +28,9 @@ exports.LogLevel = LogLevel;
 let EnvironmentInfo = /*#__PURE__*/function (EnvironmentInfo) {
   EnvironmentInfo[EnvironmentInfo["EnvironmentProd"] = 0] = "EnvironmentProd";
   EnvironmentInfo[EnvironmentInfo["EnvironmentDev"] = 1] = "EnvironmentDev";
-  EnvironmentInfo[EnvironmentInfo["EnvironmentStag"] = 2] = "EnvironmentStag";
+  EnvironmentInfo[EnvironmentInfo["EnvironmentStaging"] = 2] = "EnvironmentStaging";
   return EnvironmentInfo;
-}({});
+}({}); // Environment.STAGING
 /**
  * Configuration object for initializing ShieldFraud.
  */
@@ -45,8 +52,10 @@ exports.EnvironmentInfo = EnvironmentInfo;
 class ShieldFraud {
   /**
    * The native module for accessing the ShieldFraudPlugin.
+   * Resolved via TurboModuleRegistry on New Architecture, with
+   * a NativeModules bridge fallback for Old Architecture.
    */
-  static PlatformWrapper = _reactNative.NativeModules.ShieldFraudPlugin;
+  static PlatformWrapper = ShieldFraudPluginNativeModule;
 
   /**
    * The event emitter for listening to success and error events.
@@ -68,14 +77,32 @@ class ShieldFraud {
     // Set default values if environmentInfo is not provided
     const environmentInfo = config.environmentInfo || EnvironmentInfo.EnvironmentProd;
 
+    // Set cross-platform parameters internally (React Native and version from package.json)
+    ShieldFraud.setCrossPlatformParameters();
+
+    // blockScreenRecording is Android-only; iOS native ignores the value.
+    // Always send a real boolean — the Old Arch bridge cannot handle null
+    // for boolean parameters (causes NPE in ReadableNativeArray.getBoolean).
+    const blockScreenRecording = _reactNative.Platform.OS === "android" ? config.blockScreenRecording ?? false : false;
+
     // Call the native method to initialize ShieldFraud with the provided configuration.
-    await ShieldFraud.PlatformWrapper.initShield(config.siteID, config.secretKey, isOptimizedListener, config.blockedDialog, logLevel, environmentInfo);
+    await ShieldFraud.PlatformWrapper.initShield(config.siteID, config.secretKey, isOptimizedListener, config.blockedDialog ?? null, logLevel, environmentInfo, blockScreenRecording);
     if (isOptimizedListener) {
       // Set up listeners for success and error events if callbacks are provided.
       ShieldFraud.listeners(callbacks);
     }
   }
 
+  /**
+   * Private method to set cross-platform parameters.
+   * The cross-platform name and the version is fetched from package.json.
+   */
+  static setCrossPlatformParameters() {
+    const crossPlatformName = "react-native-shield-fraud-plugin";
+    const crossPlatformVersion = "2.0.0";
+    ShieldFraud.PlatformWrapper.setCrossPlatformParameters(crossPlatformName, crossPlatformVersion);
+  }
+
   /**
    * Sets up event listeners for success and error events.
    *
@@ -116,12 +143,22 @@ class ShieldFraud {
   }
 
   /**
-   * Checks if the ShieldFraud SDK is ready and invokes the provided callback with the readiness state.
+   * iOS only — checks if the ShieldFraud SDK is ready and invokes the provided
+   * callback with the readiness state.
+   *
+   * On Android (SDK 2.x) device result events fire automatically via the
+   * Sentinel inside createShieldWithCallback. There is no subscription call
+   * and no reliable way to intercept the event after the fact, so this method
+   * is a no-op on Android. Use the `callbacks` parameter of `initShield`
+   * instead to receive device results on Android.
    *
    * @param callback - A callback function to be invoked with the readiness state.
-   *   - `isReady` (boolean): A boolean value indicating whether the ShieldFraud SDK is ready.
+   *   - `isReady` (boolean): true when the SDK has produced a device result.
    */
   static async isSDKready(callback) {
+    if (_reactNative.Platform.OS !== "ios") {
+      return;
+    }
     try {
       // Adding a timeout of 100 milliseconds
       await new Promise(resolve => setTimeout(resolve, 100));
@@ -138,6 +175,8 @@ class ShieldFraud {
         }
       };
       ShieldFraud.eventEmitter.addListener("device_result_state", deviceResultListener);
+
+      // Trigger the SDK subscription — iOS 1.x requires this explicit call.
       ShieldFraud.PlatformWrapper.setDeviceResultStateListener();
     } catch (error) {
       console.error("An error occurred:", error);
@@ -155,6 +194,23 @@ class ShieldFraud {
     ShieldFraud.PlatformWrapper.sendAttributes(screenName, data);
   }
 
+  /**
+   * Sends attributes and resolves with `true` when the native SDK confirms success.
+   *
+   * @param screenName - The name of the screen.
+   * @param data - The attribute data object.
+   * @returns A Promise that resolves to true on success and rejects on error.
+   */
+  static sendAttributesWithCallback(screenName, data) {
+    return new Promise((resolve, reject) => {
+      ShieldFraud.PlatformWrapper.sendAttributesWithCallback(screenName, data, result => {
+        resolve(!!result);
+      }, error => {
+        reject(error);
+      });
+    });
+  }
+
   /**
    * Retrieves the latest device result from the ShieldFraud plugin.
    *
@@ -163,10 +219,26 @@ class ShieldFraud {
   static getLatestDeviceResult() {
     return new Promise((resolve, reject) => {
       ShieldFraud.PlatformWrapper.getLatestDeviceResult(result => {
-        // Handle success with the result object
         resolve(result);
       }, error => {
-        // Handle error with the error object
+        reject(error);
+      });
+    });
+  }
+
+  /**
+   * Triggers a device signature computation for a given screen name.
+   * On success, resolves with the latest device result object.
+   * On failure, rejects with the error message.
+   *
+   * @param screenName - The name of the screen triggering the signature.
+   * @returns A Promise that resolves with the device result or rejects with an error.
+   */
+  static sendDeviceSignature(screenName) {
+    return new Promise((resolve, reject) => {
+      ShieldFraud.PlatformWrapper.sendDeviceSignature(screenName, result => {
+        resolve(result);
+      }, error => {
         reject(error);
       });
     });