@thegrizzlylabs/react-native-genius-scan 6.0.0-beta01 → 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-beta01'
+    implementation 'com.geniusscansdk:gssdk:6.0.0-beta03'
 }

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

@@ -15,7 +15,7 @@ import com.facebook.react.bridge.ReactMethod;
 import com.facebook.react.bridge.ReadableMap;
 import com.facebook.react.bridge.WritableMap;
 import com.facebook.react.bridge.WritableNativeMap;
-import com.geniusscansdk.barcodeflow.BarcodeFlow;
+import com.geniusscansdk.barcodeflow.BarcodeScanFlow;
 import com.geniusscansdk.scanflow.PluginBridge;
 import com.geniusscansdk.scanflow.PromiseResult;
 import com.geniusscansdk.scanflow.ScanFlow;
@@ -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 {
@@ -57,10 +62,10 @@ public class RNGeniusScanModule extends ReactContextBaseJavaModule {
       PromiseResult promiseResult = PluginBridge.getPromiseResultFromActivityResult(requestCode, resultCode, intent);
       if (promiseResult != null) {
         Promise promise = null;
-        if (requestCode == ScanFlow.SCAN_REQUEST) {
+        if (requestCode == ScanFlow.REQUEST_CODE) {
           promise = mScanPromise;
           mScanPromise = null;
-        } else if (requestCode == BarcodeFlow.REQUEST_CODE) {
+        } else if (requestCode == BarcodeScanFlow.REQUEST_CODE) {
           promise = mBarcodeScanPromise;
           mBarcodeScanPromise = null;
         }

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

@@ -52,6 +52,8 @@ NS_ASSUME_NONNULL_BEGIN
 @end
 
 /**
+ Detects the frame of a document in an image.
+
  - Performance:
     A document detector can be expensive to create: it's recommended to keep a reference to it if it's needed several times in a row.
  */
@@ -61,12 +63,12 @@ NS_ASSUME_NONNULL_BEGIN
 - (instancetype)init;
 
 /**
- Detects the quadrangle corresponding to the edges of a document in video frame
+ Detects the quadrangle corresponding to the edges of a document in a video frame
 
  @param sampleBuffer a YCbCr sample buffer of a video frame. Make sure the video output generating these frames is configured with the pixel format kCVPixelFormatType_420YpCbCr8BiPlanarFullRange
  @param error On input, a pointer to an error object. If an error occurs, this pointer is set to an actual error object containing the error information. You may specify nil for this parameter if you do not want the error information.
 
- @return The detected quadrangle or nil if an error occured.
+ @return The detected quadrangle or nil if an error occurred.
  */
 - (GSKDocumentDetectionResult * _Nullable)detectDocumentInSampleBuffer:(CMSampleBufferRef)sampleBuffer error:(NSError * _Nullable *)error;
 
@@ -76,7 +78,7 @@ NS_ASSUME_NONNULL_BEGIN
  @param image The photo to detect a document in
  @param error On input, a pointer to an error object. If an error occurs, this pointer is set to an actual error object containing the error information. You may specify nil for this parameter if you do not want the error information.
 
- @return The detected quadrangle or nil if an error occured.
+ @return The detected quadrangle or nil if an error occurred.
  */
 - (GSKDocumentDetectionResult * _Nullable)detectDocumentInImage:(UIImage *)image error:(NSError * _Nullable *)error;
 

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

@@ -9,14 +9,8 @@
 
 #import <Foundation/Foundation.h>
 #import <CoreGraphics/CoreGraphics.h>
-
+#import <GSSDK/GSKRotation.h>
 #import <UIKit/UIKit.h>
-#import "GSKRotation.h"
-
-extern const CGPoint GSKQuadrangleTopRightPoint;
-extern const CGPoint GSKQuadrangleTopLeftPoint;
-extern const CGPoint GSKQuadrangleBottomLeftPoint;
-extern const CGPoint GSKQuadrangleBottomRightPoint;
 
 NS_ASSUME_NONNULL_BEGIN
 

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/GSKScanProcessor.h

@@ -32,9 +32,11 @@ NS_ASSUME_NONNULL_BEGIN
   The document processor is the central class of the GSSDK's image processing algorithms.
 
   With the document processor, you can correct the distortion in your documents, as well as improve their legibility.
-  If you are only interested in the detecting a document in an image, please refer to GSKDocumentDetector.
+  The scan processor can also analyze the scan and evaluate its readability.
 
-  Warning: `GSKScanProcessor` is not thread-safe; you shouldn't reuse the same instance accross threads.
+  If you are only interested in detecting a document in an image, please refer to ``GSKDocumentDetector``. If you are looking to detect whether an image contains a document, use ``GSKDocumentFinder`` instead.
+
+  Warning: `GSKScanProcessor` is not thread-safe; you shouldn't reuse the same instance across threads.
 */
 @interface GSKScanProcessor : NSObject
 
@@ -44,8 +46,8 @@ NS_ASSUME_NONNULL_BEGIN
 
  @param configuration The configuration of the different steps of the processing.
 
- @returns The result of the processing, nil if there is an error. The results includes the parameters that have been selected for the different processing steps,
- as well as the temporary path were the output was written. The output is written in a temporary folder. The caller can take ownership of this file.
+ @returns The result of the processing, nil if there is an error. The result includes the parameters that have been selected for the different processing steps,
+ as well as the temporary path where the output was written. The output is written in a temporary folder. The caller can take ownership of this file.
  By default, the best output format will be chosen by this method. For instance, if the monochrome enhancement was selected, the output will not
  be saved as JPEG but as a 1-bit PNG image. The result's processedImagePath file extension will reflect this.
  */

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

@@ -1,6 +1,6 @@
 #if 0
 #elif defined(__arm64__) && __arm64__
-// Generated by Apple Swift version 6.2 effective-5.10 (swiftlang-6.2.0.19.9 clang-1700.3.19.1)
+// Generated by Apple Swift version 6.2.3 effective-5.10 (swiftlang-6.2.3.3.21 clang-1700.6.3.2)
 #ifndef GSSDK_SWIFT_H
 #define GSSDK_SWIFT_H
 #pragma clang diagnostic push
@@ -359,7 +359,14 @@ SWIFT_CLASS("_TtC5GSSDK10GSKBarcode")
 @class GSKBarcodeScanFlowConfiguration;
 @class UIViewController;
 @class GSKBarcodeScanFlowResult;
-/// A flow for scanning barcodes and QR codes.
+/// A UI flow for scanning barcodes and QR codes using the device camera.
+/// Configure the flow with <code>GSKBarcodeScanFlowConfiguration</code> to select the
+/// barcode types to detect and whether batch mode is enabled. Present it from
+/// a view controller and await a <code>GSKBarcodeScanFlowResult</code> containing the
+/// decoded barcodes.
+/// important:
+/// Camera access requires <code>NSCameraUsageDescription</code> in
+/// <code>Info.plist</code>.
 SWIFT_CLASS("_TtC5GSSDK18GSKBarcodeScanFlow")
 @interface GSKBarcodeScanFlow : NSObject
 /// Initializes a new barcode scan flow
@@ -399,7 +406,7 @@ SWIFT_CLASS("_TtC5GSSDK18GSKBarcodeScanFlow")
 /// do {
 ///     let result = try await flow.resultByStarting(fromViewController: self)
 ///     print("Scanned codes: \(result.barcodes.map { $0.value })")
-/// } catch GSKBarcodeScanFlowError.userCancellation {
+/// } catch GSKScanFlowError.cancellation {
 ///     print("User canceled scanning")
 /// } catch {
 ///     print("Scanning failed: \(error)")
@@ -419,7 +426,7 @@ SWIFT_CLASS("_TtC5GSSDK18GSKBarcodeScanFlow")
 ///
 /// <ul>
 ///   <li>
-///     Typically throws a <code>GSKBarcodeScanFlowError</code>
+///     A <code>GSKScanFlowError</code>
 ///   </li>
 /// </ul>
 ///
@@ -473,7 +480,7 @@ SWIFT_CLASS("_TtC5GSSDK31GSKBarcodeScanFlowConfiguration")
 /// \endcode
 @property (nonatomic) BOOL isBatchModeEnabled;
 /// The highlight color used for the UI (overlay). Defaults
-/// to <code>.green</code>. For good constrast, we recommend using a bright color.
+/// to <code>.green</code>. For good contrast, we recommend using a bright color.
 @property (nonatomic, strong) UIColor * _Nonnull highlightColor;
 /// The menu color used for the UI. Defaults to <code>nil</code>, meaning that the system
 /// default color will be used (blue on iOS, for example).
@@ -494,19 +501,6 @@ SWIFT_CLASS("_TtC5GSSDK31GSKBarcodeScanFlowConfiguration")
 + (GSKBarcodeScanFlowConfiguration * _Nullable)configurationWithJSON:(NSString * _Nonnull)json error:(NSError * _Nullable * _Nullable)error SWIFT_WARN_UNUSED_RESULT;
 @end
 
-/// Enum that defines various errors that can occur during a barcode scan flow.
-typedef SWIFT_ENUM(NSInteger, GSKBarcodeScanFlowError, open) {
-/// User has canceled the barcode scan flow
-  GSKBarcodeScanFlowUserCancelationError SWIFT_COMPILE_NAME("userCancellation") = 0,
-/// A general error due to a bad configuration parameter
-  GSKBarcodeScanFlowConfigurationError SWIFT_COMPILE_NAME("configuration") = 1,
-/// Camera permission was denied
-  GSKBarcodeScanFlowPermissionDeniedError SWIFT_COMPILE_NAME("permissionDenied") = 2,
-/// Failed to initialize the barcode detector
-  GSKBarcodeScanFlowDetectorError SWIFT_COMPILE_NAME("detectorError") = 3,
-};
-static NSString * _Nonnull const GSKBarcodeScanFlowErrorDomain = @"GSSDK.GSKBarcodeScanFlowError";
-
 /// The result of a barcode scanning flow.
 /// This class encapsulates the successful outcome of a barcode or QR code scanning session,
 /// containing the detected barcode or QR code data.
@@ -572,7 +566,7 @@ typedef SWIFT_ENUM(NSInteger, GSKCameraSessionError, open) {
 /// A camera view controller to scan documents or barcodes.
 /// Inherit from this view controller to create a custom scanning experience. Lay out the <code>cameraView</code> as desired:
 /// By default, <code>cameraView</code> fills the entire screen. You can disable its resizing mask
-/// (<code>cameraView.translateAutoresizingMaskIntoConstraints</code>) and use Auto Layout constraints.
+/// (<code>cameraView.translatesAutoresizingMaskIntoConstraints</code>) and use Auto Layout constraints.
 /// note:
 ///
 /// When a photo of a document is taken, whether manually or automatically, the capture session is paused
@@ -580,9 +574,16 @@ typedef SWIFT_ENUM(NSInteger, GSKCameraSessionError, open) {
 /// In this callback, you can decide whether to exit the camera view controller (if you just need to scan a
 /// single page), or keep scanning more images (to support a “batch scanning” flow). For the latter scenario,
 /// you will need to resume the camera session (see <code>resume()</code>). You also need to “reveal” the shutter screen
-/// (see <code>hideShutterView(animated:)</code>.
+/// (see <code>hideShutterView(animated:)</code>).
 SWIFT_CLASS("_TtC5GSSDK23GSKCameraViewController")
 @interface GSKCameraViewController : UIViewController
+/// Requests camera access if needed.
+/// This returns immediately when access is already determined. It only shows the system prompt
+/// when access has not been requested yet.
+///
+/// returns:
+/// <code>true</code> when access is authorized.
++ (void)requestCameraAccessWithCompletionHandler:(void (^ _Nonnull)(BOOL))completionHandler;
 - (nullable instancetype)initWithCoder:(NSCoder * _Nonnull)coder OBJC_DESIGNATED_INITIALIZER SWIFT_UNAVAILABLE;
 - (void)viewDidLoad;
 - (void)viewWillAppear:(BOOL)animated;
@@ -746,24 +747,24 @@ SWIFT_PROTOCOL("_TtP5GSSDK31GSKCameraViewControllerDelegate_")
 typedef SWIFT_ENUM(NSInteger, GSKDocumentFinderImageType, closed) {
 /// No document present in the image
   GSKDocumentFinderImageTypeNoDocument = 0,
-/// A document present in the image, but no crop, perspective correction have been applied
+/// A document is present in the image, but no crop or perspective correction has been applied.
   GSKDocumentFinderImageTypeUnwarped = 1,
-/// A document present in the image, and crop, perspective correction have been applied
+/// A document is present in the image, and crop and perspective correction have been applied.
   GSKDocumentFinderImageTypeWarped = 2,
-/// A document present in the image, crop/perspective correction and
-/// enhanced have been applied.
+/// A document is present in the image, and crop/perspective correction and
+/// enhancement have been applied.
   GSKDocumentFinderImageTypeEnhanced = 3,
 };
 
 @class GSKPDFDocument;
 @protocol GSKDocumentImageProcessor;
 @class GSKDocumentGeneratorConfiguration;
-/// This class exposes the capacility to generate a PDF document file.
+/// This class exposes the capability to generate a PDF or TIFF multi-page document file.
 SWIFT_CLASS("_TtC5GSSDK20GSKDocumentGenerator")
 @interface GSKDocumentGenerator : NSObject
 - (nonnull instancetype)init OBJC_DESIGNATED_INITIALIZER;
 /// Generates a document file based on a document model and a generator configuration.
-/// \param document The source document to generate as PDF.
+/// \param document The source document to generate as PDF or TIFF depending on the configuration.
 ///
 /// \param imageProcessor An object used to process each source document’s image before inserting it in the resulting document.
 /// Only used when generating a PDF document
@@ -772,7 +773,7 @@ SWIFT_CLASS("_TtC5GSSDK20GSKDocumentGenerator")
 ///
 - (BOOL)generate:(GSKPDFDocument * _Nonnull)document imageProcessor:(id <GSKDocumentImageProcessor> _Nonnull)imageProcessor configuration:(GSKDocumentGeneratorConfiguration * _Nonnull)configuration error:(NSError * _Nullable * _Nullable)error;
 /// Generates a document file based on a document model and a generator configuration.
-/// \param document The source document to generate as PDF.
+/// \param document The source document to generate as PDF or TIFF depending on the configuration.
 ///
 /// \param configuration The configuration for the document generation.
 ///
@@ -786,7 +787,7 @@ SWIFT_CLASS("_TtC5GSSDK33GSKDocumentGeneratorConfiguration")
 @interface GSKDocumentGeneratorConfiguration : NSObject
 + (GSKDocumentGeneratorConfiguration * _Nonnull)pdfConfigurationWithOutputFilePath:(NSString * _Nonnull)outputFilePath SWIFT_WARN_UNUSED_RESULT;
 + (GSKDocumentGeneratorConfiguration * _Nonnull)tiffConfigurationWithOutputFilePath:(NSString * _Nonnull)outputFilePath SWIFT_WARN_UNUSED_RESULT;
-/// The output file format of the document generator. Must be .pdf or .tif.
+/// The output file format of the document generator. Must be .pdf or .tiff.
 @property (nonatomic, readonly) enum GSKDocumentGeneratorFileFormat outputFileFormat;
 /// The path where the generated document will be written. The extension will not be validated.
 @property (nonatomic, readonly, copy) NSString * _Nonnull outputFilePath;
@@ -817,7 +818,7 @@ SWIFT_CLASS("_TtC5GSSDK33GSKDocumentGeneratorConfiguration")
 
 SWIFT_CLASS("_TtC5GSSDK38GSKDocumentGeneratorDebugConfiguration")
 @interface GSKDocumentGeneratorDebugConfiguration : NSObject
-/// If true, OCR’ed text will visible on the PDF.
+/// If true, OCR’ed text will be visible on the PDF.
 /// Defaults to false. Use this for debug only
 @property (nonatomic, readonly) BOOL isOCRTextShownOnPDF;
 - (nonnull instancetype)initWithIsOCRTextShownOnPDF:(BOOL)isOCRTextShownOnPDF OBJC_DESIGNATED_INITIALIZER;
@@ -863,6 +864,16 @@ SWIFT_PROTOCOL("_TtP5GSSDK25GSKDocumentImageProcessor_")
 
 @class UIImage;
 @class UIView;
+/// A view controller that displays a scanned image with an interactive quadrangle overlay
+/// for manual cropping and perspective adjustment.
+/// <code>GSKEditFrameViewController</code> presents an image and allows the user to refine the detected
+/// document boundaries by dragging the quadrangle’s corner handles. As the user edits the
+/// quadrangle, changes are reflected in the <code>quadrangle</code> property, which is Key-Value
+/// Observing (KVO) compliant.
+/// The overlay’s appearance—including colors, handle size, transparency, and magnifier
+/// behavior—can be customized through the exposed properties. This view controller is
+/// typically used after automatic document detection, to let the user fine-tune the crop
+/// before further processing (such as perspective correction or export).
 SWIFT_CLASS("_TtC5GSSDK26GSKEditFrameViewController")
 @interface GSKEditFrameViewController : UIViewController
 /// The image on which the quadrangle is overlaid.
@@ -870,6 +881,10 @@ SWIFT_CLASS("_TtC5GSSDK26GSKEditFrameViewController")
 @property (nonatomic, readonly, strong) UIView * _Nonnull frameView;
 /// Used to set the quadrangle to display in the view controller, and to retrieve the new quadrangle edited by the user.
 @property (nonatomic, strong) GSKQuadrangle * _Nonnull quadrangle;
+/// Insets applied around the image.
+/// By default this matches half the quadrangle overlay handle width, so handles remain visible even when
+/// the corners are on the edge of the image.
+@property (nonatomic) CGFloat inset;
 /// Customize the color of the shade within the quadrangle.
 @property (nonatomic, strong) UIColor * _Nonnull shadeColor SWIFT_DEPRECATED_MSG("Deprecated in favor of frameView.imageSelection.insideShadeColor.");
 /// Customize the color of the shade outside the quadrangle.
@@ -878,6 +893,8 @@ SWIFT_CLASS("_TtC5GSSDK26GSKEditFrameViewController")
 @property (nonatomic, strong) UIColor * _Nonnull lineColor;
 /// Customize the width of the corner handles.
 @property (nonatomic) CGFloat handleWidth;
+/// Customize the transparency of the entire overlay
+@property (nonatomic) CGFloat overlayAlpha;
 /// Customize the magnifier center style shown while dragging corners.
 @property (nonatomic) GSKMagnifierViewCenterStyle magnifierViewCenterStyle;
 /// \param image The image on which to draw the quadrangle. This is typically the original photo from the camera.
@@ -1101,14 +1118,14 @@ SWIFT_CLASS("_TtC5GSSDK6GSKOCR")
 /// The OCR decides what post-processing to apply for the best results.
 ///
 /// \param configuration Configuration for the OCR process, in particular the language in which the OCR is
-/// performed. Note that you must provided the appropriate trained data.
+/// performed. Note that you must provide the appropriate trained data.
 ///
 /// \param progressBlock The progress between 0 and 1. Called on the same thread.
 ///
 ///
 /// returns:
 /// An OCR result.
-- (void)recognizeTextForImageAtPath:(NSString * _Nonnull)imagePath ocrConfiguration:(GSKOCRConfiguration * _Nonnull)configuration onProgress:(void (^ _Nullable)(float))progressBlock completionHandler:(void (^ _Nonnull)(GSKOCRResult * _Nullable, NSError * _Nullable))completionHandler;
+- (void)recognizeTextForImageAtPath:(NSString * _Nonnull)imagePath configuration:(GSKOCRConfiguration * _Nonnull)configuration onProgress:(void (^ _Nullable)(float))progressBlock completionHandler:(void (^ _Nonnull)(GSKOCRResult * _Nullable, NSError * _Nullable))completionHandler;
 @end
 
 /// The configuration for an OCR operation.
@@ -1214,9 +1231,15 @@ SWIFT_CLASS("_TtC5GSSDK13GSKReceiptVAT")
 @end
 
 @class GSKScanFlowConfiguration;
-/// A high-level scanner module.
-/// You present it and when the user is done, you obtain a result object containing the scanned documents.
-/// The scan flow can be customized with a <code>GSKScanFlowConfiguration</code> instance.
+/// A UI-driven scan flow for turning physical documents into processed digital pages.
+/// Create an instance with <code>GSKScanFlowConfiguration</code> to choose the source
+/// (camera, photo library, or image URL), multi-page behavior, output format,
+/// filters, OCR, and structured-data extraction. Present the flow from a view
+/// controller and await a <code>GSKScanFlowResult</code> with the captured pages and the
+/// optional multi-page document.
+/// important:
+/// If you start a scan flow with the camera, your app must declare the
+/// <code>NSCameraUsageDescription</code> key in <code>Info.plist</code>.
 SWIFT_CLASS("_TtC5GSSDK11GSKScanFlow")
 @interface GSKScanFlow : NSObject
 - (nonnull instancetype)initWithConfiguration:(GSKScanFlowConfiguration * _Nonnull)configuration OBJC_DESIGNATED_INITIALIZER;
@@ -1335,15 +1358,33 @@ SWIFT_CLASS("_TtC5GSSDK24GSKScanFlowConfiguration")
 + (nullable instancetype)configurationWithJSON:(NSString * _Nonnull)json error:(NSError * _Nullable * _Nullable)error SWIFT_WARN_UNUSED_RESULT;
 @end
 
-/// Enum that defines various errors that can occur during a scan flow.
-typedef SWIFT_ENUM(NSInteger, GSKScanFlowError, open) {
+/// Enum that defines various numeric error codes that can occur during a scan flow.
+typedef SWIFT_ENUM(NSInteger, GSKScanFlowErrorCode, open) {
 /// User has canceled the scan flow
-  GSKScanFlowUserCancelationError SWIFT_COMPILE_NAME("userCancellation") = 999,
-/// A general error due to a bad input parameter. Verify that your
+  GSKScanFlowCancellationErrorCode SWIFT_COMPILE_NAME("cancellation") = 999,
+/// A general error due to an incorrect configuration. Verify that your
 /// inputs match the API requirements.
-  GSKScanFlowBadInputError SWIFT_COMPILE_NAME("badInput") = 1000,
+  GSKScanFlowConfigurationErrorCode SWIFT_COMPILE_NAME("configuration") = 1000,
+/// A licensing error. This is a developer error and you should contact the
+/// Genius Scan SDK support team to make sure you have a valid license key.
+  GSKScanFlowLicensingErrorCode SWIFT_COMPILE_NAME("licensing") = 1001,
+/// An error that happened while capturing the scans. This can sometimes be recovered
+/// by restarting the device.
+  GSKScanFlowCaptureErrorCode SWIFT_COMPILE_NAME("capture") = 1002,
+/// An error caused by low storage space. This can be recovered by cleaning up
+/// storage space and trying again.
+  GSKScanFlowStorageSpaceErrorCode SWIFT_COMPILE_NAME("storageSpace") = 1003,
+/// An internal error. This is a catch-all category, and the underlying error will
+/// give more details.
+  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) {
@@ -1386,8 +1427,8 @@ typedef SWIFT_ENUM(NSUInteger, GSKScanFlowFlashMode, open) {
 /// The format of the exported document.
 typedef SWIFT_ENUM(NSUInteger, GSKScanFlowMultiPageFormat, open) {
   GSKScanFlowNone SWIFT_COMPILE_NAME("none") = 0,
-  GSKScanFlowPDF SWIFT_COMPILE_NAME("PDF") = 1,
-  GSKScanFlowTIFF SWIFT_COMPILE_NAME("TIFF") = 2,
+  GSKScanFlowPDF SWIFT_COMPILE_NAME("pdf") = 1,
+  GSKScanFlowTIFF SWIFT_COMPILE_NAME("tiff") = 2,
 };
 
 /// The configuration for text recognition
@@ -1426,9 +1467,9 @@ typedef SWIFT_ENUM(NSUInteger, GSKScanFlowPDFPageSize, open) {
 SWIFT_CLASS("_TtC5GSSDK17GSKScanFlowResult")
 @interface GSKScanFlowResult : NSObject
 /// Document containing the pages that were scanned during the scan
-/// flow. The format is specified by <code>multiPageFormat</code> property of
-/// the used <code>GSKScanFlowConfiguration</code>. Is <code>nil</code> if no format was
-/// specified or if generation failed.
+/// flow. The format is specified by the <code>multiPageFormat</code> property of
+/// the <code>GSKScanFlowConfiguration</code> used for the scan flow. This is <code>nil</code>
+/// when <code>multiPageFormat</code> is <code>.none</code> or if document generation failed.
 @property (nonatomic, copy) NSURL * _Nullable multiPageDocumentURL;
 /// The individual scans taken during the scan flow.
 /// Each scan object contains both the original and the enhanced scans.
@@ -1632,23 +1673,19 @@ SWIFT_CLASS("_TtC5GSSDK13GSKTextLayout")
 + (nonnull instancetype)new SWIFT_UNAVAILABLE_MSG("-init is unavailable");
 @end
 
-@class GSKTextLayoutToTextConverterResult;
+/// Converts an OCR text layout into plain text.
+/// A <code>GSKOCRResult</code> contains both raw text and a <code>GSKTextLayout</code>, which preserves spatial information such as
+/// bounding boxes and line/word positions. This converter reconstructs the raw text from a <code>GSKTextLayout</code> by
+/// traversing its bounding boxes in reading order and grouping content into paragraphs.
+/// Use this when you want to retain only the spatial representation (for highlighting, selection, reflow, etc.)
+/// and regenerate the plain-text representation on demand, rather than storing both.
 SWIFT_CLASS("_TtC5GSSDK28GSKTextLayoutToTextConverter")
 @interface GSKTextLayoutToTextConverter : NSObject
-- (GSKTextLayoutToTextConverterResult * _Nullable)convert:(GSKTextLayout * _Nonnull)textLayout error:(NSError * _Nullable * _Nullable)error SWIFT_WARN_UNUSED_RESULT;
 - (nonnull instancetype)init OBJC_DESIGNATED_INITIALIZER;
 @end
 
 SWIFT_CLASS("_TtC5GSSDK34GSKTextLayoutToTextConverterResult")
 @interface GSKTextLayoutToTextConverterResult : NSObject
-/// The text reconstructed from the text layout.
-@property (nonatomic, readonly, copy) NSString * _Nonnull text;
-/// The average word confidence of the recognized text.
-/// A value between 0 and 100
-@property (nonatomic, readonly) NSInteger averageWordConfidence;
-/// The number of words in the recognized text.
-/// This is the number of words on which the average word confidence has been computed.
-@property (nonatomic, readonly) NSInteger wordCount;
 - (nonnull instancetype)init SWIFT_UNAVAILABLE;
 + (nonnull instancetype)new SWIFT_UNAVAILABLE_MSG("-init is unavailable");
 @end

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

@@ -18,7 +18,6 @@ FOUNDATION_EXPORT const unsigned char GSSDKVersionString[];
 #import <GSSDK/GSKDocumentComposition.h>
 #import <GSSDK/GSKDocumentDetector.h>
 #import <GSSDK/GSKEdgeCleaning.h>
-#import <GSSDK/GSKEditableFrame.h>
 #import <GSSDK/GSKEnhancementConfiguration.h>
 #import <GSSDK/GSKError.h>
 #import <GSSDK/GSKFilterColorPalette.h>
@@ -26,7 +25,6 @@ FOUNDATION_EXPORT const unsigned char GSSDKVersionString[];
 #import <GSSDK/GSKLicenseKeyChecker.h>
 #import <GSSDK/GSKLog.h>
 #import <GSSDK/GSKLoggerSeverity.h>
-#import <GSSDK/GSKMBProgressHUD.h>
 #import <GSSDK/GSKMagnifierView.h>
 #import <GSSDK/GSKOutputConfiguration.h>
 #import <GSSDK/GSKPerspectiveCorrectionConfiguration.h>
@@ -38,11 +36,11 @@ 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>
 #import <GSSDK/GSKScanProcessor.h>
-#import <GSSDK/GSKShutterView.h>
 #import <GSSDK/UIImage+GSKUtils.h>
 #import <GSSDK/GSKReadabilityLevel.h>
 #import <GSSDK/GSKReadabilityConfiguration.h>

package/ios/GSSDK/GSSDK.xcframework/ios-arm64/GSSDK.framework/Headers/UIImage+GSKUtils.h

@@ -27,7 +27,7 @@ typedef NS_ENUM(NSUInteger, GSKRotationDirection) {
  @param maxSize The square to fit the image in. The largest image dimension will fit maxSize.
  @param quality The quality of the interpolation.
  @param scale The scale (density) of the resulting image.
- @param error An optional error pointer filled when the scaling fails.
+ @param error An optional error pointer filled if the input image is invalid or the scaling fails.
  */
 - (nullable UIImage *)gsk_scaleWithMaxSize:(CGFloat)maxSize
                                    quality:(CGInterpolationQuality)quality
@@ -36,6 +36,8 @@ typedef NS_ENUM(NSUInteger, GSKRotationDirection) {
 
 /**
  Rotates the image according to its orientation. The resulting image orientation will be "up".
+
+ @param error An optional error pointer filled if the input image is invalid or cannot be rotated.
  */
 - (nullable UIImage *)gsk_upOrientedImageWithError:(NSError * _Nullable __autoreleasing * _Nullable)error NS_SWIFT_NAME(gsk_upOriented());
 
@@ -47,6 +49,8 @@ typedef NS_ENUM(NSUInteger, GSKRotationDirection) {
  orientation by the system methods.
 
  Should you want to actually rotate the image, you can apply `gsk_upOrientedImage` after rotating it.
+
+ @param error An optional error pointer filled if the input image is invalid or cannot be rotated.
  */
 - (nullable UIImage *)gsk_rotate:(GSKRotationDirection)direction
                            error:(NSError * _Nullable __autoreleasing * _Nullable)error NS_SWIFT_NAME(gsk_rotate(_:));