react-native-shield-fraud-plugin 1.0.4 → 1.0.6

package/README.md

@@ -4,7 +4,7 @@ React Native Plugin for Shield Fraud (www.shield.com)
 
 React Native Shield Fraud Plugin helps developers to assess malicious activities performed on mobile devices and return risk intelligence based on user's behaviour. It collects device's fingerprint, social metrics and network information. 
 
-There are four steps to getting started with the SHIELD SDK:
+There are few steps to getting started with the SHIELD SDK:
 
 1. [Integrate the SDK](#integrate-the-sdk)
 
@@ -16,6 +16,9 @@ There are four steps to getting started with the SHIELD SDK:
 
 5. [Send Custom Attributes](#send-custom-attributes)
 
+6. [Migration from BRIDGE CODE to PLUGIN](#migration-from-bridge-code-to-plugin)
+
+
 
 ### Integrate the SDK
 
@@ -158,4 +161,56 @@ ShieldFraud.isSDKready(async (isReady: boolean) => {
 }
 ```
 
+### Migration from BRIDGE CODE to PLUGIN
+If you've been using the old method of integrating the React Native bridge code for the Shield Fraud SDK on iOS and Android, follow these steps to migrate to our plugin.
+
+#### iOS Migration Steps
+
+**1. Remove Old Pod Dependency:**
+Open your iOS project's Podfile and remove the line `pod 'ShieldFraud'`. Then, in your project's root directory, run `pod deintegrate` followed by `pod install` to ensure the old ShieldFraud dependency is completely removed.
+
+**2. Remove Old Bridge Code Files:**
+In your Xcode project's file explorer, locate and remove the files `ShieldModule.h` and `ShieldModule.m`. Remove all these references as they are no longer needed.
+
+**3. Clean the Project:**
+Open your Xcode project. Go to `"Product"` in the top menu and select `"Clean Build Folder"` to make sure any residual build artifacts related to the old ShieldFraud library are removed.
+
+**4. Update React Native Project:**
+In your React Native project, search for any code that references the old `ShieldModule`. Remove all these references as they are no longer needed.
+
+**5. Follow Plugin Integration Steps:**
+Now that you've cleaned up the old bridge code, follow the integration steps outlined in the documentation under "Integrate the SDK" section, starting from the step of installing the plugin using npm or yarn.
+
+#### Android Migration Steps
+If you've been using the old method of integrating the React Native bridge code for the Shield Fraud SDK on Android, follow these steps to migrate to our plugin.
+
+**1. Remove Old Dependencies:**
+In your `app/build.gradle` file, locate and remove the line:
+```
+implementation 'com.shield.android:shield-fraud:1.5.+'
+```
+
+**2. Update Android Settings:**
+In your `settings.gradle` or project level `build.gradle` file from the `repositories` block, locate and remove the `maven url`:
+```
+allprojects {
+  repositories {
+    maven {
+      url "https://cashshield-sdk.s3.amazonaws.com/release/"
+    }
+    ...
+  }
+}
+```
+This is the maven url that you no longer need with the new plugin approach.
+
+**3. Remove Old Bridge Code:**
+In your Android project, if you have a ShieldModule.java file as part of the old bridge code integration, you can safely remove it.
+
+**4. Update React Native Project:**
+In your React Native project, search for any code that references the old ShieldModule in Java code. Also remove ShieldModule from ReactPackage, Remove all these references as they are no longer needed.
+
+**5. Follow Plugin Integration Steps:**
+Now that you've cleaned up the old bridge code, follow the integration steps outlined in the documentation under "Integrate the SDK" section, starting from the step of installing the plugin using npm or yarn.
 
+By following these steps, you'll successfully migrate your React Native project from the old bridge code integration to the new Shield Fraud plugin. This migration will make your project more maintainable and allow you to take advantage of the new features and improvements offered by the plugin.

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

@@ -4,10 +4,12 @@ import android.app.Activity;
 
 import androidx.annotation.NonNull;
 
+import com.facebook.react.bridge.Arguments;
 import com.facebook.react.bridge.Promise;
 import com.facebook.react.bridge.ReactApplicationContext;
 import com.facebook.react.bridge.ReactContextBaseJavaModule;
 import com.facebook.react.bridge.ReactMethod;
+import com.facebook.react.bridge.WritableMap;
 import com.facebook.react.module.annotations.ReactModule;
 
 import com.facebook.react.bridge.Callback;
@@ -42,7 +44,8 @@ public class ShieldFraudPluginModule extends ReactContextBaseJavaModule implemen
     return NAME;
   }
 
-  private boolean isShieldInitialized() {
+  @ReactMethod(isBlockingSynchronousMethod = true)
+  public boolean isShieldInitialized() {
     try {
       return Shield.getInstance() != null;
     } catch (IllegalStateException e) {
@@ -120,17 +123,23 @@ public class ShieldFraudPluginModule extends ReactContextBaseJavaModule implemen
   }
 
   @ReactMethod
-  public void setDeviceResultStateListener(Callback callback) {
+  public void setDeviceResultStateListener() {
     Shield.getInstance().setDeviceResultStateListener(new Shield.DeviceResultStateListener() {
       @Override
       public void isReady() {
-        // Invoke the callback when the device is ready
-        callback.invoke();
+        // Emit an event when the device is ready
+        WritableMap params = Arguments.createMap();
+        params.putString("status", "isSDKReady");
+
+        reactContext
+                .getJSModule(DeviceEventManagerModule.RCTDeviceEventEmitter.class)
+                .emit("device_result_state", params);
       }
     });
   }
 
 
+
   @ReactMethod(isBlockingSynchronousMethod = true)
   public String getSessionId() {
     return Shield.getInstance().getSessionId();
@@ -161,13 +170,7 @@ public class ShieldFraudPluginModule extends ReactContextBaseJavaModule implemen
     for (Map.Entry<String, Object> entry : json.toHashMap().entrySet()) {
       data.put(entry.getKey(), (String) entry.getValue());
     }
-    Shield.getInstance().setDeviceResultStateListener(new Shield.DeviceResultStateListener(){
-      // check whether device fingerprinting is completed
-      @Override
-      public void isReady() {
-        Shield.getInstance().sendAttributes(screenName, data);
-      }
-    });
+    Shield.getInstance().sendAttributes(screenName, data);
   }
 
   @ReactMethod

package/ios/ShieldFraudPlugin.m

@@ -34,6 +34,10 @@ RCT_EXPORT_BLOCKING_SYNCHRONOUS_METHOD(getSessionId) {
     return [[Shield shared]sessionId];
 }
 
+RCT_EXPORT_BLOCKING_SYNCHRONOUS_METHOD(isShieldInitialized) {
+    return @(isShieldInitialized);
+}
+
 // get device result to shield
 RCT_EXPORT_METHOD(getLatestDeviceResult:(RCTResponseSenderBlock)successCallback errorCallback: (RCTResponseSenderBlock)errorCallback)
 {
@@ -48,20 +52,15 @@ RCT_EXPORT_METHOD(getLatestDeviceResult:(RCTResponseSenderBlock)successCallback
     }
 }
 
-RCT_EXPORT_METHOD(setDeviceResultStateListener:(RCTResponseSenderBlock)callback)
+RCT_EXPORT_METHOD(setDeviceResultStateListener)
 {
-    
-    NSTimeInterval delayInSeconds = 2.0;
-    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:^{
-            callback(@[]);
-        }];
-    });
+    [[Shield shared] setDeviceResultStateListener:^{
+        [self sendEventWithName:@"device_result_state" body:@{@"status": @"isSDKReady"}];
+    }];
 }
 
 - (NSArray<NSString *> *)supportedEvents {
-    return @[@"success", @"error"];
+    return @[@"success", @"error", @"device_result_state"];
 }
 
 - (void)didErrorWithError:(NSError *)error

package/ios/ShieldFraudPlugin.xcodeproj/xcuserdata/deepakraj.xcuserdatad/xcschemes/xcschememanagement.plist

@@ -7,7 +7,7 @@
 		<key>ShieldFraudPlugin.xcscheme_^#shared#^_</key>
 		<dict>
 			<key>orderHint</key>
-			<integer>2</integer>
+			<integer>0</integer>
 		</dict>
 	</dict>
 </dict>

package/lib/commonjs/index.js

@@ -59,7 +59,7 @@ class ShieldFraud {
    * @param config - The configuration object containing the required properties.
    * @param callbacks - (Optional) The callback functions for success and failure events.
    */
-  static initShield(config, callbacks) {
+  static async initShield(config, callbacks) {
     const isOptimizedListener = !!callbacks;
 
     // Set default values if logLevel is not provided
@@ -69,7 +69,7 @@ class ShieldFraud {
     const environmentInfo = config.environmentInfo || EnvironmentInfo.EnvironmentProd;
 
     // Call the native method to initialize ShieldFraud with the provided configuration.
-    ShieldFraud.PlatformWrapper.initShield(config.siteID, config.secretKey, isOptimizedListener, config.blockedDialog, logLevel, environmentInfo);
+    await ShieldFraud.PlatformWrapper.initShield(config.siteID, config.secretKey, isOptimizedListener, config.blockedDialog, logLevel, environmentInfo);
     if (isOptimizedListener ?? false) {
       // Set up listeners for success and error events if callbacks are provided.
       ShieldFraud.listeners(callbacks);
@@ -107,15 +107,39 @@ class ShieldFraud {
   }
 
   /**
-   * Checks if the ShieldFraud SDK is ready and invokes the provided callback with the
-   * readiness state.
+   * Checks whether the ShieldFraud plugin is initialized.
    *
-   * @param callback - The callback function to be invoked with the readiness state.
-   */
-  static isSDKready(callback) {
-    ShieldFraud.PlatformWrapper.setDeviceResultStateListener(() => {
-      callback(true);
-    });
+   * @returns A Promise that resolves with a boolean value indicating whether the ShieldFraud plugin is initialized (true) or not (false).
+  */
+  static isShieldInitialized() {
+    return ShieldFraud.PlatformWrapper.isShieldInitialized();
+  }
+
+  /**
+   * Checks if the ShieldFraud SDK is ready and invokes the provided callback with the readiness state.
+   *
+   * @param callback - A callback function to be invoked with the readiness state.
+   *   - `isReady` (boolean): A boolean value indicating whether the ShieldFraud SDK is ready.
+  */
+  static async isSDKready(callback) {
+    try {
+      const isInitialized = await this.isShieldInitialized();
+      if (!isInitialized) {
+        callback(false);
+        return;
+      }
+      const deviceResultListener = event => {
+        if (event.status === 'isSDKReady') {
+          ShieldFraud.eventEmitter.removeAllListeners('device_result_state');
+          callback(true);
+        }
+      };
+      ShieldFraud.eventEmitter.addListener('device_result_state', deviceResultListener);
+      ShieldFraud.PlatformWrapper.setDeviceResultStateListener();
+    } catch (error) {
+      console.error("An error occurred:", error);
+      callback(false);
+    }
   }
 
   /**

package/lib/commonjs/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["_reactNative","require","LogLevel","exports","EnvironmentInfo","ShieldFraud","PlatformWrapper","NativeModules","ShieldFraudPlugin","eventEmitter","NativeEventEmitter","initShield","config","callbacks","isOptimizedListener","logLevel","LogLevelNone","environmentInfo","EnvironmentProd","siteID","secretKey","blockedDialog","listeners","addListener","data","onSuccess","error","onFailure","getSessionId","isSDKready","callback","setDeviceResultStateListener","sendAttributes","screenName","getLatestDeviceResult","Promise","resolve","reject","result","_default","default"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":"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"}
+{"version":3,"names":["_reactNative","require","LogLevel","exports","EnvironmentInfo","ShieldFraud","PlatformWrapper","NativeModules","ShieldFraudPlugin","eventEmitter","NativeEventEmitter","initShield","config","callbacks","isOptimizedListener","logLevel","LogLevelNone","environmentInfo","EnvironmentProd","siteID","secretKey","blockedDialog","listeners","addListener","data","onSuccess","error","onFailure","getSessionId","isShieldInitialized","isSDKready","callback","isInitialized","deviceResultListener","event","status","removeAllListeners","setDeviceResultStateListener","console","sendAttributes","screenName","getLatestDeviceResult","Promise","resolve","reject","result","_default","default"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":"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"}

package/lib/module/index.js

@@ -58,7 +58,7 @@ class ShieldFraud {
    * @param config - The configuration object containing the required properties.
    * @param callbacks - (Optional) The callback functions for success and failure events.
    */
-  static initShield(config, callbacks) {
+  static async initShield(config, callbacks) {
     const isOptimizedListener = !!callbacks;
 
     // Set default values if logLevel is not provided
@@ -68,7 +68,7 @@ class ShieldFraud {
     const environmentInfo = config.environmentInfo || EnvironmentInfo.EnvironmentProd;
 
     // Call the native method to initialize ShieldFraud with the provided configuration.
-    ShieldFraud.PlatformWrapper.initShield(config.siteID, config.secretKey, isOptimizedListener, config.blockedDialog, logLevel, environmentInfo);
+    await ShieldFraud.PlatformWrapper.initShield(config.siteID, config.secretKey, isOptimizedListener, config.blockedDialog, logLevel, environmentInfo);
     if (isOptimizedListener ?? false) {
       // Set up listeners for success and error events if callbacks are provided.
       ShieldFraud.listeners(callbacks);
@@ -106,15 +106,39 @@ class ShieldFraud {
   }
 
   /**
-   * Checks if the ShieldFraud SDK is ready and invokes the provided callback with the
-   * readiness state.
+   * Checks whether the ShieldFraud plugin is initialized.
    *
-   * @param callback - The callback function to be invoked with the readiness state.
-   */
-  static isSDKready(callback) {
-    ShieldFraud.PlatformWrapper.setDeviceResultStateListener(() => {
-      callback(true);
-    });
+   * @returns A Promise that resolves with a boolean value indicating whether the ShieldFraud plugin is initialized (true) or not (false).
+  */
+  static isShieldInitialized() {
+    return ShieldFraud.PlatformWrapper.isShieldInitialized();
+  }
+
+  /**
+   * Checks if the ShieldFraud SDK is ready and invokes the provided callback with the readiness state.
+   *
+   * @param callback - A callback function to be invoked with the readiness state.
+   *   - `isReady` (boolean): A boolean value indicating whether the ShieldFraud SDK is ready.
+  */
+  static async isSDKready(callback) {
+    try {
+      const isInitialized = await this.isShieldInitialized();
+      if (!isInitialized) {
+        callback(false);
+        return;
+      }
+      const deviceResultListener = event => {
+        if (event.status === 'isSDKReady') {
+          ShieldFraud.eventEmitter.removeAllListeners('device_result_state');
+          callback(true);
+        }
+      };
+      ShieldFraud.eventEmitter.addListener('device_result_state', deviceResultListener);
+      ShieldFraud.PlatformWrapper.setDeviceResultStateListener();
+    } catch (error) {
+      console.error("An error occurred:", error);
+      callback(false);
+    }
   }
 
   /**

package/lib/module/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["NativeModules","NativeEventEmitter","LogLevel","EnvironmentInfo","ShieldFraud","PlatformWrapper","ShieldFraudPlugin","eventEmitter","initShield","config","callbacks","isOptimizedListener","logLevel","LogLevelNone","environmentInfo","EnvironmentProd","siteID","secretKey","blockedDialog","listeners","addListener","data","onSuccess","error","onFailure","getSessionId","isSDKready","callback","setDeviceResultStateListener","sendAttributes","screenName","getLatestDeviceResult","Promise","resolve","reject","result"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":"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"}
+{"version":3,"names":["NativeModules","NativeEventEmitter","LogLevel","EnvironmentInfo","ShieldFraud","PlatformWrapper","ShieldFraudPlugin","eventEmitter","initShield","config","callbacks","isOptimizedListener","logLevel","LogLevelNone","environmentInfo","EnvironmentProd","siteID","secretKey","blockedDialog","listeners","addListener","data","onSuccess","error","onFailure","getSessionId","isShieldInitialized","isSDKready","callback","isInitialized","deviceResultListener","event","status","removeAllListeners","setDeviceResultStateListener","console","sendAttributes","screenName","getLatestDeviceResult","Promise","resolve","reject","result"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":"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"}

package/lib/typescript/index.d.ts

@@ -62,7 +62,7 @@ declare class ShieldFraud {
      * @param config - The configuration object containing the required properties.
      * @param callbacks - (Optional) The callback functions for success and failure events.
      */
-    static initShield(config: Config, callbacks?: ShieldCallback): void;
+    static initShield(config: Config, callbacks?: ShieldCallback): Promise<void>;
     /**
      * Sets up event listeners for success and error events.
      *
@@ -76,12 +76,18 @@ declare class ShieldFraud {
      */
     static getSessionId(): Promise<string>;
     /**
-     * Checks if the ShieldFraud SDK is ready and invokes the provided callback with the
-     * readiness state.
+     * Checks whether the ShieldFraud plugin is initialized.
      *
-     * @param callback - The callback function to be invoked with the readiness state.
-     */
-    static isSDKready(callback: (isReady: boolean) => void): void;
+     * @returns A Promise that resolves with a boolean value indicating whether the ShieldFraud plugin is initialized (true) or not (false).
+    */
+    static isShieldInitialized(): Promise<Boolean>;
+    /**
+     * Checks if the ShieldFraud SDK is ready and invokes the provided callback with the readiness state.
+     *
+     * @param callback - A callback function to be invoked with the readiness state.
+     *   - `isReady` (boolean): A boolean value indicating whether the ShieldFraud SDK is ready.
+    */
+    static isSDKready(callback: (isReady: boolean) => void): Promise<void>;
     /**
      * Sends attributes to the ShieldFraud plugin for a specific screen.
      *

package/lib/typescript/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.tsx"],"names":[],"mappings":"AAEA;;GAEG;AACH,oBAAY,QAAQ;IAClB,aAAa,IAAI;IACjB,YAAY,IAAI;IAChB,YAAY,IAAI;CACjB;AAED;;GAEG;AACH,oBAAY,eAAe;IACzB,eAAe,IAAI;IACnB,cAAc,IAAI;IAClB,eAAe,IAAI;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,MAAM;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE;QACd,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;KACd,GAAG,IAAI,CAAC;IACT,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,eAAe,CAAC,EAAE,eAAe,CAAC;CACnC;AAED;;GAEG;AACH,KAAK,eAAe,GAAG,CAAC,IAAI,EAAE,GAAG,KAAK,IAAI,CAAC;AAE3C;;GAEG;AACH,KAAK,eAAe,GAAG,CAAC,KAAK,EAAE,GAAG,KAAK,IAAI,CAAC;AAE5C;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,SAAS,CAAC,EAAE,eAAe,CAAC;CAC7B,CAAC;AAEF;;;;GAIG;AACH,cAAM,WAAW;IACf;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,eAAe,CAAmC;IAEjE;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,YAAY,CAAuD;IAElF;;;;;OAKG;WACW,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,cAAc,GAAG,IAAI;IAyB1E;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,SAAS;IAgBxB;;;;OAIG;WACW,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC;IAI7C;;;;;OAKG;WACW,UAAU,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI;IAMpE;;;;;OAKG;WACW,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAIpE;;;;OAIG;WACW,qBAAqB,IAAI,OAAO,CAAC,MAAM,CAAC;CAcvD;AAED,eAAe,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.tsx"],"names":[],"mappings":"AAEA;;GAEG;AACH,oBAAY,QAAQ;IAClB,aAAa,IAAI;IACjB,YAAY,IAAI;IAChB,YAAY,IAAI;CACjB;AAED;;GAEG;AACH,oBAAY,eAAe;IACzB,eAAe,IAAI;IACnB,cAAc,IAAI;IAClB,eAAe,IAAI;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,MAAM;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE;QACd,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;KACd,GAAG,IAAI,CAAC;IACT,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,eAAe,CAAC,EAAE,eAAe,CAAC;CACnC;AAED;;GAEG;AACH,KAAK,eAAe,GAAG,CAAC,IAAI,EAAE,GAAG,KAAK,IAAI,CAAC;AAE3C;;GAEG;AACH,KAAK,eAAe,GAAG,CAAC,KAAK,EAAE,GAAG,KAAK,IAAI,CAAC;AAE5C;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,SAAS,CAAC,EAAE,eAAe,CAAC;CAC7B,CAAC;AAEF;;;;GAIG;AACH,cAAM,WAAW;IACf;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,eAAe,CAAmC;IAEjE;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,YAAY,CAAuD;IAElF;;;;;OAKG;WACiB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAyBzF;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,SAAS;IAgBxB;;;;OAIG;WACW,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC;IAI7C;;;;MAIE;WACY,mBAAmB,IAAI,OAAO,CAAC,OAAO,CAAC;IAIrD;;;;;MAKE;WACkB,UAAU,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAyBnF;;;;;OAKG;WACW,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAIpE;;;;OAIG;WACW,qBAAqB,IAAI,OAAO,CAAC,MAAM,CAAC;CAcvD;AAED,eAAe,WAAW,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-shield-fraud-plugin",
-  "version": "1.0.4",
+  "version": "1.0.6",
   "description": "React Native Shield Fraud Plugin helps developers to assess malicious activities performed on mobile devices and return risk intelligence based on user's behaviour. It collects device's fingerprint, social metrics and network information.",
   "main": "lib/commonjs/index",
   "module": "lib/module/index",

package/src/index.tsx

@@ -72,17 +72,17 @@ class ShieldFraud {
    * @param config - The configuration object containing the required properties.
    * @param callbacks - (Optional) The callback functions for success and failure events.
    */
-  public static initShield(config: Config, callbacks?: ShieldCallback): void {
+  public static async initShield(config: Config, callbacks?: ShieldCallback): Promise<void> {
     const isOptimizedListener = !!callbacks;
 
-      // Set default values if logLevel is not provided
+    // Set default values if logLevel is not provided
     const logLevel = config.logLevel || LogLevel.LogLevelNone;
 
     // Set default values if environmentInfo is not provided
     const environmentInfo = config.environmentInfo || EnvironmentInfo.EnvironmentProd;
 
     // Call the native method to initialize ShieldFraud with the provided configuration.
-    ShieldFraud.PlatformWrapper.initShield(
+    await ShieldFraud.PlatformWrapper.initShield(
       config.siteID,
       config.secretKey,
       isOptimizedListener,
@@ -128,16 +128,44 @@ class ShieldFraud {
   }
 
   /**
-   * Checks if the ShieldFraud SDK is ready and invokes the provided callback with the
-   * readiness state.
+   * Checks whether the ShieldFraud plugin is initialized.
    *
-   * @param callback - The callback function to be invoked with the readiness state.
-   */
-  public static isSDKready(callback: (isReady: boolean) => void): void {
-    ShieldFraud.PlatformWrapper.setDeviceResultStateListener(() => {
-      callback(true);
-    });
+   * @returns A Promise that resolves with a boolean value indicating whether the ShieldFraud plugin is initialized (true) or not (false).
+  */
+  public static isShieldInitialized(): Promise<Boolean> {
+    return ShieldFraud.PlatformWrapper.isShieldInitialized();
+  }
+
+  /**
+   * Checks if the ShieldFraud SDK is ready and invokes the provided callback with the readiness state.
+   *
+   * @param callback - A callback function to be invoked with the readiness state.
+   *   - `isReady` (boolean): A boolean value indicating whether the ShieldFraud SDK is ready.
+  */
+  public static async isSDKready(callback: (isReady: boolean) => void): Promise<void> {
+    try {
+      const isInitialized = await this.isShieldInitialized();
+      
+      if (!isInitialized) {
+        callback(false);
+        return;
+      }
+  
+      const deviceResultListener = (event: { status: string }) => {
+        if (event.status === 'isSDKReady') {
+          ShieldFraud.eventEmitter.removeAllListeners('device_result_state');
+          callback(true);
+        }
+      };
+      
+      ShieldFraud.eventEmitter.addListener('device_result_state', deviceResultListener);
+      ShieldFraud.PlatformWrapper.setDeviceResultStateListener();
+    } catch (error) {
+      console.error("An error occurred:", error);    
+      callback(false); 
+    }
   }
+  
 
   /**
    * Sends attributes to the ShieldFraud plugin for a specific screen.