@thegrizzlylabs/react-native-genius-scan 6.0.0-beta02 → 6.0.0-beta03

package/README.md

@@ -193,6 +193,27 @@ RNGeniusScan.scanWithConfiguration({ source: 'image', sourceImageUrl: imageUri }
 })
 ```
 
+### Error handling
+
+Errors are rejected with a structured payload:
+
+- `code`: standardized error code
+- `message`: user-facing message
+- `recovery_message`: recovery suggestion (may be empty)
+- `underlying_error`: stringified underlying error (may be empty)
+
+Example:
+
+```javascript
+RNGeniusScan.scanWithConfiguration({ source: 'camera' })
+.catch((error) => {
+	console.log(error.code);
+	console.log(error.message);
+	console.log(error.recovery_message);
+	console.log(error.underlying_error);
+})
+```
+
 # FAQ
 
 ## How do I get the UI translated to another language?

package/android/build.gradle

@@ -42,5 +42,5 @@ rootProject.allprojects {
 
 dependencies {
     implementation 'com.facebook.react:react-native:+'
-    implementation 'com.geniusscansdk:gssdk:6.0.0-beta02'
+    implementation 'com.geniusscansdk:gssdk:6.0.0-beta03'
 }

package/android/src/main/java/com/geniusscansdk/reactnative/RNGeniusScanModule.java

@@ -42,7 +42,12 @@ public class RNGeniusScanModule extends ReactContextBaseJavaModule {
   // We don't work directly with Promise here as it is a React Native Bridge module
   private void resolvePromiseWithPromiseResult(Promise promise, PromiseResult promiseResult) {
     if (promiseResult.isError) {
-      promise.reject(promiseResult.errorCode, promiseResult.errorMessage);
+      Map<String, String> error = promiseResult.error;
+      if (error != null) {
+        promise.reject(error.get("code"), error.get("message"), Arguments.makeNativeMap(error));
+      } else {
+        promise.reject("internal_error", "No error payload");
+      }
     } else if (promiseResult.result == null) {
       promise.resolve(null);
     } else {

package/ios/GSSDK/GSSDK.xcframework/Info.plist

@@ -10,15 +10,18 @@
 			<key>DebugSymbolsPath</key>
 			<string>dSYMs</string>
 			<key>LibraryIdentifier</key>
-			<string>ios-arm64</string>
+			<string>ios-arm64_x86_64-simulator</string>
 			<key>LibraryPath</key>
 			<string>GSSDK.framework</string>
 			<key>SupportedArchitectures</key>
 			<array>
 				<string>arm64</string>
+				<string>x86_64</string>
 			</array>
 			<key>SupportedPlatform</key>
 			<string>ios</string>
+			<key>SupportedPlatformVariant</key>
+			<string>simulator</string>
 		</dict>
 		<dict>
 			<key>BinaryPath</key>
@@ -26,18 +29,15 @@
 			<key>DebugSymbolsPath</key>
 			<string>dSYMs</string>
 			<key>LibraryIdentifier</key>
-			<string>ios-arm64_x86_64-simulator</string>
+			<string>ios-arm64</string>
 			<key>LibraryPath</key>
 			<string>GSSDK.framework</string>
 			<key>SupportedArchitectures</key>
 			<array>
 				<string>arm64</string>
-				<string>x86_64</string>
 			</array>
 			<key>SupportedPlatform</key>
 			<string>ios</string>
-			<key>SupportedPlatformVariant</key>
-			<string>simulator</string>
 		</dict>
 	</array>
 	<key>CFBundlePackageType</key>

package/ios/GSSDK/GSSDK.xcframework/ios-arm64/GSSDK.framework/Headers/GSKScanFlowError+PluginPayload.h

@@ -0,0 +1,11 @@
+#import <Foundation/Foundation.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+@interface GSKScanFlowErrorPayload : NSObject
+
++ (NSDictionary<NSString *, NSString *> *)payloadFromNSError:(NSError *)error;
+
+@end
+
+NS_ASSUME_NONNULL_END

package/ios/GSSDK/GSSDK.xcframework/ios-arm64/GSSDK.framework/Headers/GSSDK-Swift.h

@@ -1379,6 +1379,12 @@ typedef SWIFT_ENUM(NSInteger, GSKScanFlowErrorCode, open) {
   GSKScanFlowInternalErrorCode SWIFT_COMPILE_NAME("internal") = 9999,
 };
 
+SWIFT_CLASS("_TtC5GSSDK26GSKScanFlowErrorCodeBridge")
+@interface GSKScanFlowErrorCodeBridge : NSObject
++ (NSString * _Nonnull)stringCodeForRawValue:(NSInteger)rawValue SWIFT_WARN_UNUSED_RESULT;
+- (nonnull instancetype)init OBJC_DESIGNATED_INITIALIZER;
+@end
+
 /// The different possible filters for the scanner UI.
 /// Each case maps to a predefined filter configuration except <code>.automatic</code>.
 typedef SWIFT_ENUM(NSInteger, GSKScanFlowFilterType, open) {

package/ios/GSSDK/GSSDK.xcframework/ios-arm64/GSSDK.framework/Headers/GSSDK.h

@@ -36,6 +36,7 @@ FOUNDATION_EXPORT const unsigned char GSSDKVersionString[];
 #import <GSSDK/GSKRotationConfiguration.h>
 #import <GSSDK/GSKScan.h>
 #import <GSSDK/GSKScanFlowErrorDomain.h>
+#import <GSSDK/GSKScanFlowError+PluginPayload.h>
 #import <GSSDK/GSKScanFlowOCROutputFormats.h>
 #import <GSSDK/GSKScanFlowPostProcessingActions.h>
 #import <GSSDK/GSKScanFlowStructuredData.h>

package/ios/GSSDK/GSSDK.xcframework/ios-arm64/GSSDK.framework/Modules/GSSDK.swiftmodule/arm64-apple-ios.abi.json

@@ -10982,6 +10982,30 @@
         "declKind": "Import",
         "moduleName": "GSSDK"
       },
+      {
+        "kind": "Import",
+        "name": "Foundation",
+        "printedName": "Foundation",
+        "declKind": "Import",
+        "moduleName": "GSSDK"
+      },
+      {
+        "kind": "Import",
+        "name": "GSSDKObjC",
+        "printedName": "GSSDKObjC",
+        "declKind": "Import",
+        "moduleName": "GSSDK",
+        "declAttributes": [
+          "ImplementationOnly"
+        ]
+      },
+      {
+        "kind": "Import",
+        "name": "Foundation",
+        "printedName": "Foundation",
+        "declKind": "Import",
+        "moduleName": "GSSDK"
+      },
       {
         "kind": "Import",
         "name": "GSSDKObjC",
@@ -21531,6 +21555,13 @@
         "declKind": "Import",
         "moduleName": "GSSDK"
       },
+      {
+        "kind": "Import",
+        "name": "Foundation",
+        "printedName": "Foundation",
+        "declKind": "Import",
+        "moduleName": "GSSDK"
+      },
       {
         "kind": "Import",
         "name": "GSSDKObjC",
@@ -25659,6 +25690,149 @@
           }
         ]
       },
+      {
+        "kind": "TypeDecl",
+        "name": "GSKScanFlowErrorCodeBridge",
+        "printedName": "GSKScanFlowErrorCodeBridge",
+        "children": [
+          {
+            "kind": "Function",
+            "name": "stringCode",
+            "printedName": "stringCode(forRawValue:)",
+            "children": [
+              {
+                "kind": "TypeNominal",
+                "name": "String",
+                "printedName": "Swift.String",
+                "usr": "s:SS"
+              },
+              {
+                "kind": "TypeNominal",
+                "name": "Int",
+                "printedName": "Swift.Int",
+                "usr": "s:Si"
+              }
+            ],
+            "declKind": "Func",
+            "usr": "c:@M@GSSDK@objc(cs)GSKScanFlowErrorCodeBridge(cm)stringCodeForRawValue:",
+            "mangledName": "$s5GSSDK26GSKScanFlowErrorCodeBridgeC06stringE011forRawValueSSSi_tFZ",
+            "moduleName": "GSSDK",
+            "static": true,
+            "declAttributes": [
+              "Final",
+              "AccessControl",
+              "ObjC"
+            ],
+            "funcSelfKind": "NonMutating"
+          },
+          {
+            "kind": "Constructor",
+            "name": "init",
+            "printedName": "init()",
+            "children": [
+              {
+                "kind": "TypeNominal",
+                "name": "GSKScanFlowErrorCodeBridge",
+                "printedName": "GSSDK.GSKScanFlowErrorCodeBridge",
+                "usr": "c:@M@GSSDK@objc(cs)GSKScanFlowErrorCodeBridge"
+              }
+            ],
+            "declKind": "Constructor",
+            "usr": "c:@M@GSSDK@objc(cs)GSKScanFlowErrorCodeBridge(im)init",
+            "mangledName": "$s5GSSDK26GSKScanFlowErrorCodeBridgeCACycfc",
+            "moduleName": "GSSDK",
+            "overriding": true,
+            "implicit": true,
+            "objc_name": "init",
+            "declAttributes": [
+              "Dynamic",
+              "ObjC",
+              "Override"
+            ],
+            "init_kind": "Designated"
+          }
+        ],
+        "declKind": "Class",
+        "usr": "c:@M@GSSDK@objc(cs)GSKScanFlowErrorCodeBridge",
+        "mangledName": "$s5GSSDK26GSKScanFlowErrorCodeBridgeC",
+        "moduleName": "GSSDK",
+        "declAttributes": [
+          "Final",
+          "AccessControl",
+          "ObjCMembers",
+          "ObjC"
+        ],
+        "superclassUsr": "c:objc(cs)NSObject",
+        "inheritsConvenienceInitializers": true,
+        "superclassNames": [
+          "ObjectiveC.NSObject"
+        ],
+        "conformances": [
+          {
+            "kind": "Conformance",
+            "name": "Copyable",
+            "printedName": "Copyable",
+            "usr": "s:s8CopyableP",
+            "mangledName": "$ss8CopyableP"
+          },
+          {
+            "kind": "Conformance",
+            "name": "Escapable",
+            "printedName": "Escapable",
+            "usr": "s:s9EscapableP",
+            "mangledName": "$ss9EscapableP"
+          },
+          {
+            "kind": "Conformance",
+            "name": "Equatable",
+            "printedName": "Equatable",
+            "usr": "s:SQ",
+            "mangledName": "$sSQ"
+          },
+          {
+            "kind": "Conformance",
+            "name": "Hashable",
+            "printedName": "Hashable",
+            "usr": "s:SH",
+            "mangledName": "$sSH"
+          },
+          {
+            "kind": "Conformance",
+            "name": "CVarArg",
+            "printedName": "CVarArg",
+            "usr": "s:s7CVarArgP",
+            "mangledName": "$ss7CVarArgP"
+          },
+          {
+            "kind": "Conformance",
+            "name": "_KeyValueCodingAndObservingPublishing",
+            "printedName": "_KeyValueCodingAndObservingPublishing",
+            "usr": "s:10Foundation37_KeyValueCodingAndObservingPublishingP",
+            "mangledName": "$s10Foundation37_KeyValueCodingAndObservingPublishingP"
+          },
+          {
+            "kind": "Conformance",
+            "name": "_KeyValueCodingAndObserving",
+            "printedName": "_KeyValueCodingAndObserving",
+            "usr": "s:10Foundation27_KeyValueCodingAndObservingP",
+            "mangledName": "$s10Foundation27_KeyValueCodingAndObservingP"
+          },
+          {
+            "kind": "Conformance",
+            "name": "CustomStringConvertible",
+            "printedName": "CustomStringConvertible",
+            "usr": "s:s23CustomStringConvertibleP",
+            "mangledName": "$ss23CustomStringConvertibleP"
+          },
+          {
+            "kind": "Conformance",
+            "name": "CustomDebugStringConvertible",
+            "printedName": "CustomDebugStringConvertible",
+            "usr": "s:s28CustomDebugStringConvertibleP",
+            "mangledName": "$ss28CustomDebugStringConvertibleP"
+          }
+        ]
+      },
       {
         "kind": "Import",
         "name": "Foundation",
@@ -31813,6 +31987,13 @@
         "declKind": "Import",
         "moduleName": "GSSDK"
       },
+      {
+        "kind": "Import",
+        "name": "UIKit",
+        "printedName": "UIKit",
+        "declKind": "Import",
+        "moduleName": "GSSDK"
+      },
       {
         "kind": "Import",
         "name": "AVFoundation",
@@ -40387,6 +40568,13 @@
       "length": 4,
       "value": "true"
     },
+    {
+      "filePath": "\/Users\/distiller\/project\/prj-ios\/GSSDK\/ScanFlow\/GSKScanFlowFeatureFlags.swift",
+      "kind": "StringLiteral",
+      "offset": 574,
+      "length": 18,
+      "value": "\"improvedScanFlow\""
+    },
     {
       "filePath": "\/Users\/distiller\/project\/prj-ios\/GSSDK\/ScanFlow\/Models\/GSKScanFlowConfiguration.swift",
       "kind": "BooleanLiteral",
@@ -40796,14 +40984,14 @@
     {
       "filePath": "\/Users\/distiller\/project\/prj-ios\/GSSDK\/ScanFlow\/Utils\/UIButton+iOS26.swift",
       "kind": "BooleanLiteral",
-      "offset": 469,
+      "offset": 518,
       "length": 4,
       "value": "true"
     },
     {
       "filePath": "\/Users\/distiller\/project\/prj-ios\/GSSDK\/ScanFlow\/Utils\/UIButton+iOS26.swift",
       "kind": "BooleanLiteral",
-      "offset": 2440,
+      "offset": 2791,
       "length": 5,
       "value": "false"
     },
@@ -40926,24 +41114,31 @@
       "length": 1,
       "value": "0"
     },
+    {
+      "filePath": "\/Users\/distiller\/project\/prj-ios\/GSSDK\/ScanFlow\/View Controllers\/GSKUIDocumentCameraViewController.swift",
+      "kind": "IntegerLiteral",
+      "offset": 1266,
+      "length": 1,
+      "value": "1"
+    },
     {
       "filePath": "\/Users\/distiller\/project\/prj-ios\/GSSDK\/ScanFlow\/View Controllers\/GSKUIDocumentCameraViewController.swift",
       "kind": "FloatLiteral",
-      "offset": 5153,
+      "offset": 6489,
       "length": 4,
       "value": "62.0"
     },
     {
       "filePath": "\/Users\/distiller\/project\/prj-ios\/GSSDK\/ScanFlow\/View Controllers\/GSKUIDocumentCameraViewController.swift",
       "kind": "FloatLiteral",
-      "offset": 5257,
+      "offset": 6593,
       "length": 4,
       "value": "44.0"
     },
     {
       "filePath": "\/Users\/distiller\/project\/prj-ios\/GSSDK\/ScanFlow\/View Controllers\/GSKUIEditFrameViewController.swift",
       "kind": "Array",
-      "offset": 2871,
+      "offset": 3473,
       "length": 66,
       "value": "[\\.<NOT_IMPLEMENTED>, \\.<NOT_IMPLEMENTED>, \\.<NOT_IMPLEMENTED>, \\.<NOT_IMPLEMENTED>]"
     },
@@ -40964,42 +41159,42 @@
     {
       "filePath": "\/Users\/distiller\/project\/prj-ios\/GSSDK\/ScanFlow\/View Controllers\/GSKUIPostProcessingViewController.swift",
       "kind": "IntegerLiteral",
-      "offset": 12731,
+      "offset": 13017,
       "length": 1,
       "value": "0"
     },
     {
       "filePath": "\/Users\/distiller\/project\/prj-ios\/GSSDK\/ScanFlow\/View Controllers\/GSKUIPostProcessingViewController.swift",
       "kind": "IntegerLiteral",
-      "offset": 12737,
+      "offset": 13023,
       "length": 1,
       "value": "0"
     },
     {
       "filePath": "\/Users\/distiller\/project\/prj-ios\/GSSDK\/ScanFlow\/View Controllers\/GSKUIPostProcessingViewController.swift",
       "kind": "IntegerLiteral",
-      "offset": 12747,
+      "offset": 13033,
       "length": 3,
       "value": "320"
     },
     {
       "filePath": "\/Users\/distiller\/project\/prj-ios\/GSSDK\/ScanFlow\/View Controllers\/GSKUIPostProcessingViewController.swift",
       "kind": "IntegerLiteral",
-      "offset": 12760,
+      "offset": 13046,
       "length": 2,
       "value": "44"
     },
     {
       "filePath": "\/Users\/distiller\/project\/prj-ios\/GSSDK\/ScanFlow\/View Controllers\/GSKUIPostProcessingViewController.swift",
       "kind": "IntegerLiteral",
-      "offset": 12811,
+      "offset": 13097,
       "length": 2,
       "value": "12"
     },
     {
       "filePath": "\/Users\/distiller\/project\/prj-ios\/GSSDK\/ScanFlow\/View Controllers\/GSKUIPostProcessingViewController.swift",
       "kind": "BooleanLiteral",
-      "offset": 13060,
+      "offset": 13346,
       "length": 5,
       "value": "false"
     },
@@ -41017,6 +41212,20 @@
       "length": 1,
       "value": "0"
     },
+    {
+      "filePath": "\/Users\/distiller\/project\/prj-ios\/GSSDK\/ScanFlow\/Views\/GSKUIScanCollectionView.swift",
+      "kind": "IntegerLiteral",
+      "offset": 515,
+      "length": 1,
+      "value": "2"
+    },
+    {
+      "filePath": "\/Users\/distiller\/project\/prj-ios\/GSSDK\/ScanFlow\/Views\/GSKUIScanCollectionView.swift",
+      "kind": "StringLiteral",
+      "offset": 2753,
+      "length": 30,
+      "value": "\"GSKUIScanCollectionView.Cell\""
+    },
     {
       "filePath": "\/Users\/distiller\/project\/prj-ios\/GSSDK\/ScanFlow\/Views\/GSKUIShutterButton.swift",
       "kind": "StringLiteral",
@@ -41055,7 +41264,7 @@
     {
       "filePath": "\/Users\/distiller\/project\/prj-ios\/GSSDK\/ScanFlow\/Views\/GSKUIToolbar.swift",
       "kind": "IntegerLiteral",
-      "offset": 3437,
+      "offset": 3469,
       "length": 1,
       "value": "0"
     },
@@ -41069,28 +41278,28 @@
     {
       "filePath": "\/Users\/distiller\/project\/prj-ios\/GSSDK\/ScanFlow\/Views\/GSKUserGuidanceLabel.swift",
       "kind": "IntegerLiteral",
-      "offset": 2164,
+      "offset": 2286,
       "length": 1,
       "value": "3"
     },
     {
       "filePath": "\/Users\/distiller\/project\/prj-ios\/GSSDK\/ScanFlow\/Views\/GSKUserGuidanceLabel.swift",
       "kind": "FloatLiteral",
-      "offset": 2243,
+      "offset": 2365,
       "length": 3,
       "value": "5.0"
     },
     {
       "filePath": "\/Users\/distiller\/project\/prj-ios\/GSSDK\/ScanFlow\/Views\/GSKUserGuidanceLabel.swift",
       "kind": "IntegerLiteral",
-      "offset": 2300,
+      "offset": 2422,
       "length": 1,
       "value": "2"
     },
     {
       "filePath": "\/Users\/distiller\/project\/prj-ios\/GSSDK\/ScanFlow\/Views\/GSKUserGuidanceLabel.swift",
       "kind": "IntegerLiteral",
-      "offset": 2349,
+      "offset": 2471,
       "length": 2,
       "value": "20"
     },

package/ios/GSSDK/GSSDK.xcframework/ios-arm64/GSSDK.framework/Modules/GSSDK.swiftmodule/arm64-apple-ios.private.swiftinterface

@@ -889,6 +889,11 @@ public struct GSKScanFlowError : Swift.Error {
     get
   }
 }
+@objc @_inheritsConvenienceInitializers @objcMembers final public class GSKScanFlowErrorCodeBridge : ObjectiveC.NSObject {
+  @objc public static func stringCode(forRawValue rawValue: Swift.Int) -> Swift.String
+  @objc override dynamic public init()
+  @objc deinit
+}
 extension GSSDK.GSKScanFlowError : Foundation.CustomNSError {
   public static let errorDomain: Swift.String
   public var errorCode: Swift.Int {

package/ios/GSSDK/GSSDK.xcframework/ios-arm64/GSSDK.framework/Modules/GSSDK.swiftmodule/arm64-apple-ios.swiftinterface

@@ -889,6 +889,11 @@ public struct GSKScanFlowError : Swift.Error {
     get
   }
 }
+@objc @_inheritsConvenienceInitializers @objcMembers final public class GSKScanFlowErrorCodeBridge : ObjectiveC.NSObject {
+  @objc public static func stringCode(forRawValue rawValue: Swift.Int) -> Swift.String
+  @objc override dynamic public init()
+  @objc deinit
+}
 extension GSSDK.GSKScanFlowError : Foundation.CustomNSError {
   public static let errorDomain: Swift.String
   public var errorCode: Swift.Int {

package/ios/GSSDK/GSSDK.xcframework/ios-arm64_x86_64-simulator/GSSDK.framework/Headers/GSKScanFlowError+PluginPayload.h

@@ -0,0 +1,11 @@
+#import <Foundation/Foundation.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+@interface GSKScanFlowErrorPayload : NSObject
+
++ (NSDictionary<NSString *, NSString *> *)payloadFromNSError:(NSError *)error;
+
+@end
+
+NS_ASSUME_NONNULL_END

package/ios/GSSDK/GSSDK.xcframework/ios-arm64_x86_64-simulator/GSSDK.framework/Headers/GSSDK-Swift.h

@@ -1379,6 +1379,12 @@ typedef SWIFT_ENUM(NSInteger, GSKScanFlowErrorCode, open) {
   GSKScanFlowInternalErrorCode SWIFT_COMPILE_NAME("internal") = 9999,
 };
 
+SWIFT_CLASS("_TtC5GSSDK26GSKScanFlowErrorCodeBridge")
+@interface GSKScanFlowErrorCodeBridge : NSObject
++ (NSString * _Nonnull)stringCodeForRawValue:(NSInteger)rawValue SWIFT_WARN_UNUSED_RESULT;
+- (nonnull instancetype)init OBJC_DESIGNATED_INITIALIZER;
+@end
+
 /// The different possible filters for the scanner UI.
 /// Each case maps to a predefined filter configuration except <code>.automatic</code>.
 typedef SWIFT_ENUM(NSInteger, GSKScanFlowFilterType, open) {
@@ -3098,6 +3104,12 @@ typedef SWIFT_ENUM(NSInteger, GSKScanFlowErrorCode, open) {
   GSKScanFlowInternalErrorCode SWIFT_COMPILE_NAME("internal") = 9999,
 };
 
+SWIFT_CLASS("_TtC5GSSDK26GSKScanFlowErrorCodeBridge")
+@interface GSKScanFlowErrorCodeBridge : NSObject
++ (NSString * _Nonnull)stringCodeForRawValue:(NSInteger)rawValue SWIFT_WARN_UNUSED_RESULT;
+- (nonnull instancetype)init OBJC_DESIGNATED_INITIALIZER;
+@end
+
 /// The different possible filters for the scanner UI.
 /// Each case maps to a predefined filter configuration except <code>.automatic</code>.
 typedef SWIFT_ENUM(NSInteger, GSKScanFlowFilterType, open) {

package/ios/GSSDK/GSSDK.xcframework/ios-arm64_x86_64-simulator/GSSDK.framework/Headers/GSSDK.h

@@ -36,6 +36,7 @@ FOUNDATION_EXPORT const unsigned char GSSDKVersionString[];
 #import <GSSDK/GSKRotationConfiguration.h>
 #import <GSSDK/GSKScan.h>
 #import <GSSDK/GSKScanFlowErrorDomain.h>
+#import <GSSDK/GSKScanFlowError+PluginPayload.h>
 #import <GSSDK/GSKScanFlowOCROutputFormats.h>
 #import <GSSDK/GSKScanFlowPostProcessingActions.h>
 #import <GSSDK/GSKScanFlowStructuredData.h>