@thegrizzlylabs/react-native-genius-scan 5.17.0 → 6.0.0-beta01

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

@@ -281,9 +281,7 @@ typedef unsigned int swift_uint4  __attribute__((__ext_vector_type__(4)));
 #if __has_warning("-Watimport-in-framework-header")
 #pragma clang diagnostic ignored "-Watimport-in-framework-header"
 #endif
-@import AVFoundation;
 @import CoreFoundation;
-@import CoreGraphics;
 @import Dispatch;
 @import Foundation;
 @import ObjectiveC;
@@ -312,14 +310,6 @@ typedef unsigned int swift_uint4  __attribute__((__ext_vector_type__(4)));
 
 #if defined(__OBJC__)
 
-SWIFT_PROTOCOL("_TtP5GSSDK20CGImageRepresentable_")
-@protocol CGImageRepresentable
-- (CGImageRef _Nullable)CGImageRepresentation SWIFT_WARN_UNUSED_RESULT;
-@end
-
-@interface AVCapturePhoto (SWIFT_EXTENSION(GSSDK)) <CGImageRepresentable>
-@end
-
 @class NSString;
 /// Entry point of the SDK. Use this to initialize the SDK with your license key.
 SWIFT_CLASS("_TtC5GSSDK3GSK")
@@ -351,96 +341,218 @@ SWIFT_CLASS_PROPERTY(@property (nonatomic, class, readonly, copy) NSString * _No
 - (nonnull instancetype)init OBJC_DESIGNATED_INITIALIZER;
 @end
 
-@class AVCaptureDevice;
-@class AVCaptureSession;
-enum GSKCameraSessionFlashStatus : NSInteger;
-enum GSKCameraSessionDocumentDetection : NSInteger;
-@class GSKCameraSessionConfiguration;
-SWIFT_CLASS("_TtC5GSSDK16GSKCameraSession")
-@interface GSKCameraSession : NSObject
-/// Minimum duration in <code>.aboutToTrigger</code> state before triggering the photo.
-/// This can be used to coordinate animations.
-SWIFT_CLASS_PROPERTY(@property (nonatomic, class, readonly) NSTimeInterval minDurationInAboutToTriggerForTrigger;)
-+ (NSTimeInterval)minDurationInAboutToTriggerForTrigger SWIFT_WARN_UNUSED_RESULT;
-/// Public for legacy reasons, not to be used directly.
-@property (nonatomic, strong) AVCaptureDevice * _Nullable captureDevice;
-/// Public for legacy reasons, not to be used directly.
-@property (nonatomic, strong) AVCaptureSession * _Nullable captureSession;
-/// The flash mode. Default is .auto.
-@property (nonatomic) enum GSKCameraSessionFlashStatus flashStatus;
-/// Returns the current status of the document detection.
-/// This is a computed property that maps to the new activeDetectionMode property for backward compatibility.
-/// Observable.
-/// important:
-/// This property is deprecated. Use <code>activeDetectionMode</code> instead, which supports both document and readable
-/// code detection modes.
-@property (nonatomic) enum GSKCameraSessionDocumentDetection activeDocumentDetection SWIFT_DEPRECATED_MSG("Use activeDetectionMode instead");
-/// True for the duration of taking the photo and processing it. Observable.
-@property (nonatomic, readonly) BOOL isTakingPhoto;
-/// Returns false if flash isn’t supported on this device configuration.
-@property (nonatomic, readonly) BOOL supportsFlash;
-/// Public to be accessible from Objective-C, but should be private otherwise.
-@property (nonatomic, readonly, strong) dispatch_queue_t _Nullable captureSessionQueue;
-@property (nonatomic, readonly, strong) dispatch_queue_t _Nonnull takePhotoQueue;
-- (nonnull instancetype)initWithConfiguration:(GSKCameraSessionConfiguration * _Nonnull)configuration;
-- (void)pauseSession;
-- (void)resumeSession;
+/// A barcode such as 1D barcodes or QR codes.
+SWIFT_CLASS("_TtC5GSSDK10GSKBarcode")
+@interface GSKBarcode : NSObject
 - (nonnull instancetype)init SWIFT_UNAVAILABLE;
 + (nonnull instancetype)new SWIFT_UNAVAILABLE_MSG("-init is unavailable");
 @end
 
-@class AVCaptureMetadataOutput;
-@class AVMetadataObject;
-@class AVCaptureConnection;
-@interface GSKCameraSession (SWIFT_EXTENSION(GSSDK)) <AVCaptureMetadataOutputObjectsDelegate>
-- (void)captureOutput:(AVCaptureMetadataOutput * _Nonnull)output didOutputMetadataObjects:(NSArray<AVMetadataObject *> * _Nonnull)metadataObjects fromConnection:(AVCaptureConnection * _Nonnull)connection;
+@interface GSKBarcode (SWIFT_EXTENSION(GSSDK))
+- (BOOL)isEqual:(id _Nullable)object SWIFT_WARN_UNUSED_RESULT;
 @end
 
-@interface GSKCameraSession (SWIFT_EXTENSION(GSSDK))
-/// Manually take a photo
-/// If autoTriggerEnabled is true, the photo is taken automatically when the frame is detected.
-/// Otherwise, if you want to let the user manually trigger the photo, you can use this method.
-/// This method can be called even when activeDetectionMode is higlightAndTrigger and will force taking the
-/// photo.
-/// This method is thread-safe.
-/// IMPORTANT: Taking the photo will pause the session. You have to resume the session will <code>resumeSession</code> once
-/// you are done processing the result.
-- (void)takePhoto;
+@interface GSKBarcode (SWIFT_EXTENSION(GSSDK))
+@property (nonatomic, readonly) NSUInteger hash;
+@end
+
+@class GSKBarcodeScanFlowConfiguration;
+@class UIViewController;
+@class GSKBarcodeScanFlowResult;
+/// A flow for scanning barcodes and QR codes.
+SWIFT_CLASS("_TtC5GSSDK18GSKBarcodeScanFlow")
+@interface GSKBarcodeScanFlow : NSObject
+/// Initializes a new barcode scan flow
+/// \param configuration Configuration for the barcode scanning
+///
+- (nonnull instancetype)initWithConfiguration:(GSKBarcodeScanFlowConfiguration * _Nonnull)configuration OBJC_DESIGNATED_INITIALIZER;
+/// Starts the barcode scanning flow by presenting a full-screen camera interface.
+/// This method presents a camera view controller that continuously scans for barcodes and QR codes.
+/// The scanning process respects the code types specified in the flow’s configuration.
+/// The method uses Swift’s async/await pattern, suspending until either:
+/// <ul>
+///   <li>
+///     A barcode is successfully detected (except in batch mode)
+///   </li>
+///   <li>
+///     The user taps the done button (batch mode)
+///   </li>
+///   <li>
+///     The user cancels the operation
+///   </li>
+///   <li>
+///     An error occurs during setup or scanning
+///   </li>
+/// </ul>
+/// The behavior varies based on the configuration’s isBatchModeEnabled:
+/// <ul>
+///   <li>
+///     <code>false</code>: Returns immediately after detecting one or more codes in a single frame
+///   </li>
+///   <li>
+///     <code>true</code>: Collects unique codes over time until the user taps the done button
+///   </li>
+/// </ul>
+/// Example usage:
+/// \code
+/// let flow = GSKBarcodeScanFlow()
+/// do {
+///     let result = try await flow.resultByStarting(fromViewController: self)
+///     print("Scanned codes: \(result.barcodes.map { $0.value })")
+/// } catch GSKBarcodeScanFlowError.userCancellation {
+///     print("User canceled scanning")
+/// } catch {
+///     print("Scanning failed: \(error)")
+/// }
+///
+/// \endcodeimportant:
+/// This method requires camera permissions. Ensure your app’s Info.plist includes
+/// the <code>NSCameraUsageDescription</code> key with an appropriate description.
+/// note:
+/// The camera interface is presented with <code>modalPresentationStyle</code> set to <code>.fullScreen</code>
+/// for an immersive scanning experience.
+/// \param viewController The view controller from which to present the camera interface.
+/// This should typically be the currently visible view controller.
+///
+///
+/// throws:
+///
+/// <ul>
+///   <li>
+///     Typically throws a <code>GSKBarcodeScanFlowError</code>
+///   </li>
+/// </ul>
+///
+/// returns:
+/// A <code>GSKBarcodeScanFlowResult</code> containing the detected barcodes with their
+/// decoded values and format types.
+- (void)resultByStartingFromViewController:(UIViewController * _Nonnull)viewController completionHandler:(void (^ _Nonnull)(GSKBarcodeScanFlowResult * _Nullable, NSError * _Nullable))completionHandler;
+- (nonnull instancetype)init SWIFT_UNAVAILABLE;
++ (nonnull instancetype)new SWIFT_UNAVAILABLE_MSG("-init is unavailable");
 @end
 
-@class AVCapturePhotoOutput;
-@class AVCaptureResolvedPhotoSettings;
-@interface GSKCameraSession (SWIFT_EXTENSION(GSSDK)) <AVCapturePhotoCaptureDelegate>
-- (void)captureOutput:(AVCapturePhotoOutput * _Nonnull)output willBeginCaptureForResolvedSettings:(AVCaptureResolvedPhotoSettings * _Nonnull)resolvedSettings;
-- (void)captureOutput:(AVCapturePhotoOutput * _Nonnull)output willCapturePhotoForResolvedSettings:(AVCaptureResolvedPhotoSettings * _Nonnull)resolvedSettings;
-- (void)captureOutput:(AVCapturePhotoOutput * _Nonnull)output didCapturePhotoForResolvedSettings:(AVCaptureResolvedPhotoSettings * _Nonnull)resolvedSettings;
-- (void)captureOutput:(AVCapturePhotoOutput * _Nonnull)output didFinishProcessingPhoto:(AVCapturePhoto * _Nonnull)photo error:(NSError * _Nullable)error;
-- (void)captureOutput:(AVCapturePhotoOutput * _Nonnull)output didFinishCaptureForResolvedSettings:(AVCaptureResolvedPhotoSettings * _Nonnull)resolvedSettings error:(NSError * _Nullable)error;
+@class NSError;
+@interface GSKBarcodeScanFlow (SWIFT_EXTENSION(GSSDK))
+/// Instantiates a <code>GSKBarcodeScanFlow</code> instance with the provided configuration.
+/// This initializer is only available from Objective-C.
++ (nonnull instancetype)barcodeScanFlowWithConfiguration:(GSKBarcodeScanFlowConfiguration * _Nonnull)configuration SWIFT_WARN_UNUSED_RESULT;
+/// Starts the barcode scanning flow.
+/// @param viewController The view controller to present the barcode scanning interface from.
+/// @param successBlock A completion block/closure that will be called on the main
+/// thread upon successful completion of the scan flow. It receives a <code>GSKBarcodeScanFlowResult</code> object as
+/// a parameter. This object gives you access to the scanned codes.
+/// @param failureBlock A block/closure called if an error was encountered.
+/// This method is only available from Objective-C.
+- (void)startFromViewController:(UIViewController * _Nonnull)viewController success:(void (^ _Nonnull)(GSKBarcodeScanFlowResult * _Nonnull))successBlock failure:(void (^ _Nonnull)(NSError * _Nonnull))failureBlock;
 @end
 
-/// The configuration for a camera session.
-SWIFT_CLASS("_TtC5GSSDK29GSKCameraSessionConfiguration")
-@interface GSKCameraSessionConfiguration : NSObject
-/// note:
-/// Deprecated in favor of <code>init(detectionMode:)</code> which allows for more flexible detection modes.
-/// \param documentDetection The type of real-time document detection to apply.
+@class UIColor;
+/// Configuration for the UI barcode scanning flow
+/// This class allows customization of which barcode and QR code formats should be detected
+/// during the scanning process. By default, all supported formats are enabled.
+SWIFT_CLASS("_TtC5GSSDK31GSKBarcodeScanFlowConfiguration")
+@interface GSKBarcodeScanFlowConfiguration : NSObject
+/// Whether batch mode is enabled for code detection.
+/// This setting controls how codes are detected and when they are returned:
+/// <ul>
+///   <li>
+///     <code>false</code>: Detect multiple codes simultaneously in a single frame and return immediately (default)
+///   </li>
+///   <li>
+///     <code>true</code>: Collect multiple codes over time before returning when user taps Done
+///   </li>
+/// </ul>
+/// Example:
+/// \code
+/// // Standard mode - return codes immediately (default)
+/// let standardConfig = GSKBarcodeScanFlowConfiguration(isBatchModeEnabled: false)
 ///
-- (nonnull instancetype)initWithDocumentDetection:(enum GSKCameraSessionDocumentDetection)documentDetection OBJC_DESIGNATED_INITIALIZER SWIFT_DEPRECATED_MSG("Use init(detectionMode:) instead");
-/// A session configuration where the document detection is <code>.highlightAndAutoCapture</code>
-- (nonnull instancetype)init;
+/// // Batch mode - collect codes over time
+/// let batchConfig = GSKBarcodeScanFlowConfiguration(isBatchModeEnabled: true)
+///
+/// \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.
+@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).
+@property (nonatomic, strong) UIColor * _Nullable menuColor;
+/// Creates a new barcode scan flow configuration with default values
+- (nonnull instancetype)init OBJC_DESIGNATED_INITIALIZER;
+@end
+
+@class NSDictionary;
+@interface GSKBarcodeScanFlowConfiguration (SWIFT_EXTENSION(GSSDK))
+/// Create a configuration from a dictionary.
+/// This is used for interfacing with cross-platform plugins but shouldn’t
+/// be used in native projects.
++ (GSKBarcodeScanFlowConfiguration * _Nullable)configurationWithDictionary:(NSDictionary * _Nonnull)dictionary error:(NSError * _Nullable * _Nullable)error SWIFT_WARN_UNUSED_RESULT;
+/// Create a configuration from JSON data.
+/// This is used for interfacing with cross-platform plugins but shouldn’t
+/// be used in native projects.
++ (GSKBarcodeScanFlowConfiguration * _Nullable)configurationWithJSON:(NSString * _Nonnull)json error:(NSError * _Nullable * _Nullable)error SWIFT_WARN_UNUSED_RESULT;
 @end
 
-/// The style of document detection to be used during a camera session.
-typedef SWIFT_ENUM(NSInteger, GSKCameraSessionDocumentDetection, open) {
-/// The session doesn’t attempt to detect documents.
-  GSKCameraSessionDocumentDetectionNone = 0,
-/// The session detects documents and produces quadrangles
-/// to be used for highlighting the document in the video frames.
-  GSKCameraSessionDocumentDetectionHighlight = 1,
-/// The session detects documents and snaps the photo when
-/// the detection is stable.
-  GSKCameraSessionDocumentDetectionHighlightAndTrigger = 2,
+/// 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.
+SWIFT_CLASS("_TtC5GSSDK24GSKBarcodeScanFlowResult")
+@interface GSKBarcodeScanFlowResult : NSObject
+/// The detected barcodes containing their decoded values and types.
+/// This property provides access to an array of detected codes, each containing
+/// both the string content and format type (e.g., QR code, Code 128, EAN-13, etc.).
+/// <ul>
+///   <li>
+///     For standard mode: Contains all codes detected in a single frame
+///   </li>
+///   <li>
+///     For batch mode: Contains all codes collected over the scanning session
+///   </li>
+/// </ul>
+@property (nonatomic, readonly, copy) NSArray<GSKBarcode *> * _Nonnull barcodes;
+/// Creates a new barcode scan flow result.
+/// \param barcodes The detected barcodes.
+///
+- (nonnull instancetype)initWithBarcodes:(NSArray<GSKBarcode *> * _Nonnull)barcodes OBJC_DESIGNATED_INITIALIZER;
+- (nonnull instancetype)init SWIFT_UNAVAILABLE;
++ (nonnull instancetype)new SWIFT_UNAVAILABLE_MSG("-init is unavailable");
+@end
+
+@interface GSKBarcodeScanFlowResult (SWIFT_EXTENSION(GSSDK))
+/// Returns a dictionary representation of the result
+/// The dictionary contains:
+/// <ul>
+///   <li>
+///     barcodes: An array of code dictionaries, each containing:
+///     <ul>
+///       <li>
+///         value: The decoded string value
+///       </li>
+///       <li>
+///         type: The code type as a string (e.g., “qr”, “code128”)
+///       </li>
+///     </ul>
+///   </li>
+/// </ul>
+@property (nonatomic, readonly, copy) NSDictionary<NSString *, id> * _Nonnull dictionary;
+/// Returns a JSON representation of the result.
+/// See <code>dictionary</code> for an explanation of the JSON data’s structure.
+- (NSString * _Nonnull)json SWIFT_WARN_UNUSED_RESULT;
+@end
 
 /// Represents an error raised by the camera session
 typedef SWIFT_ENUM(NSInteger, GSKCameraSessionError, open) {
@@ -455,59 +567,179 @@ typedef SWIFT_ENUM(NSInteger, GSKCameraSessionError, open) {
   GSKCameraSessionErrorWarnLockDevice = -1003,
 };
 
-typedef SWIFT_ENUM(NSInteger, GSKCameraSessionFlashStatus, open) {
-  GSKCameraSessionFlashStatusAuto = 0,
-  GSKCameraSessionFlashStatusOn = 1,
-  GSKCameraSessionFlashStatusOff = 2,
-};
-
 @class NSCoder;
-@protocol UIViewControllerTransitionCoordinator;
 @class NSBundle;
-/// A ready-to-use camera interface for scanning documents.
+/// 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.
+/// note:
+///
+/// When a photo of a document is taken, whether manually or automatically, the capture session is paused
+/// and a delegate callback (<code>cameraViewController(_:didGenerateScan:)</code>) is called when the photo is ready.
+/// 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>.
 SWIFT_CLASS("_TtC5GSSDK23GSKCameraViewController")
 @interface GSKCameraViewController : UIViewController
 - (nullable instancetype)initWithCoder:(NSCoder * _Nonnull)coder OBJC_DESIGNATED_INITIALIZER SWIFT_UNAVAILABLE;
-- (nonnull instancetype)initWithCameraSession:(GSKCameraSession * _Nonnull)cameraSession OBJC_DESIGNATED_INITIALIZER;
-@property (nonatomic, readonly) BOOL prefersStatusBarHidden;
-- (void)loadView;
 - (void)viewDidLoad;
 - (void)viewWillAppear:(BOOL)animated;
 - (void)viewWillDisappear:(BOOL)animated;
-- (void)viewWillTransitionToSize:(CGSize)size withTransitionCoordinator:(id <UIViewControllerTransitionCoordinator> _Nonnull)coordinator;
+/// Manually trigger a photo.
+/// Use this to handle the user tapping on a “take photo” button, or your own
+/// custom logic to take a photo.
+- (void)takePhoto;
 - (nonnull instancetype)initWithNibName:(NSString * _Nullable)nibNameOrNil bundle:(NSBundle * _Nullable)nibBundleOrNil SWIFT_UNAVAILABLE;
 @end
 
-@class GSKView;
-@interface GSKCameraViewController (SWIFT_EXTENSION(GSSDK)) <GSKViewDelegate>
-- (void)cameraView:(GSKView * _Nonnull)cameraView requestedFocusAtPoint:(CGPoint)focusPoint;
+@interface GSKCameraViewController (SWIFT_EXTENSION(GSSDK))
 @end
 
+/// A document detection mode
+/// When detecting a document, the camera controller can just highlight the document, or also
+/// highlight and trigger the photo when the detection is stable enough.
+typedef SWIFT_ENUM(NSInteger, DocumentDetectionMode, open) {
+/// Visual highlighting only.
+/// The camera will detect document edges and provide visual feedback by drawing
+/// a document overlay, but will not automatically capture photos. Users must
+/// manually trigger photo capture.
+  DocumentDetectionModeHighlightOnly = 0,
+/// Highlighting with automatic capture.
+/// Similar to <code>highlightOnly</code>, but the camera will automatically take a photo
+/// when a stable document is detected for a sufficient duration. This provides
+/// a hands-free scanning experience.
+  DocumentDetectionModeHighlightAndAutoCapture = 1,
+};
+
 @interface GSKCameraViewController (SWIFT_EXTENSION(GSSDK))
-/// Snap the photo
-- (void)takePhoto;
 @end
 
-@class GSKScan;
-@class GSKQuadrangle;
+/// Constants indicating an interruption reason for the camera session.
+typedef SWIFT_ENUM(NSInteger, InterruptionReason, open) {
+/// An interruption caused by the app being sent to the background while using a camera.
+  InterruptionReasonVideoDeviceNotAvailableInBackground = 0,
+/// An interruption caused by the audio hardware temporarily being made unavailable, for instance,
+/// for a phone call, or alarm.
+  InterruptionReasonAudioDeviceInUseByAnotherClient = 1,
+/// An interruption caused by the video device temporarily being made unavailable, for instance,
+/// when stolen away by another app.
+  InterruptionReasonVideoDeviceInUseByAnotherClient = 2,
+/// An interruption caused when the app is running in a multi-app layout, causing resource contention
+/// and degraded recording quality of service. Given your present session configuration, the
+/// session may only be run if your app occupies the full screen.
+  InterruptionReasonVideoDeviceNotAvailableWithMultipleForegroundApps = 3,
+/// An interruption caused by the video device temporarily being made unavailable due to system pressure,
+/// such as thermal duress.
+  InterruptionReasonVideoDeviceNotAvailableDueToSystemPressure = 4,
+  InterruptionReasonUnknown = 5,
+};
+
 @interface GSKCameraViewController (SWIFT_EXTENSION(GSSDK))
-- (void)cameraSessionDidSetup:(GSKCameraSession * _Nonnull)cameraSession;
-- (void)cameraSession:(GSKCameraSession * _Nonnull)cameraSession setupFailedWithError:(NSError * _Nonnull)error;
-- (void)cameraSessionWillSnapPhoto:(GSKCameraSession * _Nonnull)cameraSession;
-- (void)cameraSessionDidSnapPhoto:(GSKCameraSession * _Nonnull)cameraSession;
-- (void)cameraSession:(GSKCameraSession * _Nonnull)cameraSession didFailToSnapPhotoWithError:(NSError * _Nonnull)error;
-- (void)cameraSession:(GSKCameraSession * _Nonnull)cameraSession didGenerateScan:(GSKScan * _Nonnull)scan;
-- (void)cameraSession:(GSKCameraSession * _Nonnull)cameraSession didEncounterFailureWithError:(NSError * _Nonnull)error;
-- (void)cameraSession:(GSKCameraSession * _Nonnull)cameraSession didFailWithError:(NSError * _Nonnull)error;
-- (void)cameraSessionIsSearchingQuadrangle:(GSKCameraSession * _Nonnull)cameraSession;
-- (void)cameraSessionIsAboutToChooseQuadrangle:(GSKCameraSession * _Nonnull)cameraSession;
-- (void)cameraSession:(GSKCameraSession * _Nonnull)cameraSession willAutoTriggerWithQuadrangle:(GSKQuadrangle * _Nonnull)quadrangle;
-- (void)cameraSession:(GSKCameraSession * _Nonnull)cameraSession didFindQuadrangle:(GSKQuadrangle * _Nonnull)quadrangle;
-- (void)cameraSessionFailedToFindQuadrangle:(GSKCameraSession * _Nonnull)cameraSession;
-- (void)cameraSessionDidStart:(GSKCameraSession * _Nonnull)cameraSession;
-- (void)cameraSessionDidStop:(GSKCameraSession * _Nonnull)cameraSession;
-- (void)cameraSession:(GSKCameraSession * _Nonnull)cameraSession wasInterruptedWithReason:(enum AVCaptureSessionInterruptionReason)reason;
-- (void)cameraSessionInterruptionEnded:(GSKCameraSession * _Nonnull)cameraSession;
+/// Factory method for a camera view controller with document detection.
+/// This is only to be used from Objective-C. From Swift, prefer using <code>init(configuration:)</code> instead.
+/// \param documentDetectionMode The document detection mode.
+///
+/// \param documentOverlayColor The color of the document overlay.
+///
++ (void)makeCameraViewControllerWithDocumentDetectionMode:(enum DocumentDetectionMode)documentDetectionMode documentOverlayColor:(UIColor * _Nonnull)documentOverlayColor completionHandler:(void (^ _Nonnull)(GSKCameraViewController * _Nullable, NSError * _Nullable))completionHandler;
+@end
+
+@class GSKQuadrangle;
+@class GSKScan;
+SWIFT_PROTOCOL("_TtP5GSSDK31GSKCameraViewControllerDelegate_")
+@protocol GSKCameraViewControllerDelegate
+@optional
+/// The camera view controller failed with an error.
+/// \param cameraViewController The camera view controller
+///
+/// \param error The encountered error.
+///
+- (void)cameraViewController:(GSKCameraViewController * _Nonnull)cameraViewController didFailWithError:(NSError * _Nonnull)error;
+/// The camera view controller encountered a non-fatal error.
+/// \param cameraViewController The camera view controller
+///
+/// \param error The encountered error.
+///
+- (void)cameraViewController:(GSKCameraViewController * _Nonnull)cameraViewController didEncounterNonCriticalError:(NSError * _Nonnull)error;
+/// The camera view controller started running
+/// \param cameraViewController The camera view controller
+///
+- (void)cameraViewControllerDidStart:(GSKCameraViewController * _Nonnull)cameraViewController;
+/// The camera view controller stopped running
+/// \param cameraViewController The camera view controller
+///
+- (void)cameraViewControllerDidStop:(GSKCameraViewController * _Nonnull)cameraViewController;
+/// The camera view controller was interrupted.
+/// This can happen in various cases, including when the user goes to Split View mode on iPad.
+/// \param cameraViewController The camera view controller
+///
+/// \param reason The reason why the camera view controller was interrupted.
+///
+- (void)cameraViewController:(GSKCameraViewController * _Nonnull)cameraViewController wasInterruptedWithReason:(enum InterruptionReason)reason;
+/// The camera view controller resumes after interruption
+/// \param cameraViewController The camera view controller
+///
+- (void)cameraViewControllerInterruptionDidEnd:(GSKCameraViewController * _Nonnull)cameraViewController;
+/// The camera view controller is still looking for a quadrangle.
+/// This is a general notification about the status of the search: we may or may not have identified
+/// its edges. If you want to act on identified edges, listen to the <code>cameraViewController:didFindDocumentWithQuadrangle:</code>
+/// delegate method.
+/// <ul>
+///   <li>
+///     Parameters:
+///   </li>
+///   <li>
+///     cameraViewController: The camera view controller
+///   </li>
+/// </ul>
+- (void)cameraViewControllerIsSearchingForDocument:(GSKCameraViewController * _Nonnull)cameraViewController;
+/// The camera view controller identified a document in the last frame of the photo stream
+/// \param cameraViewController The camera view controller
+///
+/// \param quadrangle The quadrangle of the document that has been found.
+///
+- (void)cameraViewController:(GSKCameraViewController * _Nonnull)cameraViewController didFindDocumentWithQuadrangle:(GSKQuadrangle * _Nonnull)quadrangle;
+/// The camera view controller couldn’t identify a document in the last frame of the photo stream.
+/// This doesn’t mean that the camera view controller has stopped searching for documents or failed.
+/// It just means no document has been identified. In this case, you want to clear any overlay.
+/// \param cameraViewController The camera view controller
+///
+- (void)cameraViewControllerFailedToFindDocument:(GSKCameraViewController * _Nonnull)cameraViewController;
+/// The camera view controller real-time document detection will soon take the photo of a quadrangle, but if the document
+/// detection is not stable enough, the process can still be
+/// cancelled.
+/// It’s a good time to tell the user to remain stable.
+/// Only called when the document detection is set to .highlightAndAutoCapture.
+/// \param cameraViewController The camera view controller
+///
+- (void)cameraViewControllerPhotoStabilizationDidStart:(GSKCameraViewController * _Nonnull)cameraViewController;
+/// The camera view controller is going to automatically take a photo because the detection was stable enough.
+/// The photo taking is underway and cannot be interrupted at this stage.
+/// \param cameraViewController The camera view controller
+///
+/// \param quadrangle The quadrangle of the document that will be photographed.
+///
+- (void)cameraViewController:(GSKCameraViewController * _Nonnull)cameraViewController willSnapPhotoWithQuadrangle:(GSKQuadrangle * _Nonnull)quadrangle;
+/// The camera view controller just took a photo, but it hasn’t been post-processed it yet
+/// \param cameraViewController The camera view controller
+///
+- (void)cameraViewControllerDidSnapPhoto:(GSKCameraViewController * _Nonnull)cameraViewController;
+/// The camera view controller has finished processing the photo we just took.
+/// \param cameraViewController The camera view controller
+///
+/// \param scan The scan object that has been generated. The image contained in the scan object is the full,
+/// unprocessed image in which the document was detected. Use <code>GSKScanProcessor</code> to process and
+/// warp and enhance the scanned document.
+///
+- (void)cameraViewController:(GSKCameraViewController * _Nonnull)cameraViewController didGenerateScan:(GSKScan * _Nonnull)scan;
+/// Camera view controller has detected barcodes.
+/// \param cameraViewController The camera view controller
+///
+/// \param barcodes The detected barcodes
+///
+- (void)cameraViewController:(GSKCameraViewController * _Nonnull)cameraViewController didFindBarcodes:(NSArray<GSKBarcode *> * _Nonnull)barcodes;
 @end
 
 /// The type of document detected by the document finder.
@@ -629,6 +861,36 @@ SWIFT_PROTOCOL("_TtP5GSSDK25GSKDocumentImageProcessor_")
 - (NSString * _Nullable)process:(NSString * _Nonnull)inputFilePath SWIFT_WARN_UNUSED_RESULT;
 @end
 
+@class UIImage;
+@class UIView;
+SWIFT_CLASS("_TtC5GSSDK26GSKEditFrameViewController")
+@interface GSKEditFrameViewController : UIViewController
+/// The image on which the quadrangle is overlaid.
+@property (nonatomic, strong) UIImage * _Nonnull image;
+@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;
+/// 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.
+@property (nonatomic, strong) UIColor * _Nonnull outsideShadeColor;
+/// Customize the color of the line used to draw the quadrangle.
+@property (nonatomic, strong) UIColor * _Nonnull lineColor;
+/// Customize the width of the corner handles.
+@property (nonatomic) CGFloat handleWidth;
+/// 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.
+///
+/// \param quadrangle The initial quadrangle to display.
+///
+- (nonnull instancetype)initWithImage:(UIImage * _Nonnull)image quadrangle:(GSKQuadrangle * _Nonnull)quadrangle OBJC_DESIGNATED_INITIALIZER;
+- (nullable instancetype)initWithCoder:(NSCoder * _Nonnull)coder OBJC_DESIGNATED_INITIALIZER SWIFT_UNAVAILABLE;
+- (void)setQuadrangle:(GSKQuadrangle * _Nonnull)quadrangle animated:(BOOL)animated;
+- (void)viewDidLoad;
+- (nonnull instancetype)initWithNibName:(NSString * _Nullable)nibNameOrNil bundle:(NSBundle * _Nullable)nibBundleOrNil SWIFT_UNAVAILABLE;
+@end
+
 /// A configuration to specify the background cleaning to apply with GSKScanProcessor.
 SWIFT_CLASS("_TtC5GSSDK40GSKFilterBackgroundCleaningConfiguration")
 @interface GSKFilterBackgroundCleaningConfiguration : NSObject
@@ -794,6 +1056,12 @@ SWIFT_CLASS_PROPERTY(@property (nonatomic, class, readonly, strong) GSKFilterLig
 - (BOOL)isEqual:(id _Nullable)object SWIFT_WARN_UNUSED_RESULT;
 @end
 
+typedef SWIFT_ENUM(NSInteger, GSKFlashStatus, open) {
+  GSKFlashStatusAuto = 0,
+  GSKFlashStatusOn = 1,
+  GSKFlashStatusOff = 2,
+};
+
 enum GSKIntegrationFramework : NSInteger;
 SWIFT_CLASS_NAMED("GSKIntegrationContext")
 @interface GSKIntegrationContext : NSObject
@@ -928,186 +1196,6 @@ SWIFT_CLASS("_TtC5GSSDK10GSKPDFSize")
 + (nonnull instancetype)new SWIFT_UNAVAILABLE_MSG("-init is unavailable");
 @end
 
-@class GSKReadableCodeFlowConfiguration;
-@class GSKReadableCodeFlowResult;
-/// A flow for scanning readable codes (barcodes, QR codes, etc.)
-SWIFT_CLASS("_TtC5GSSDK19GSKReadableCodeFlow")
-@interface GSKReadableCodeFlow : NSObject
-/// Initializes a new readable code flow
-/// \param configuration Configuration for the readable code scanning
-///
-- (nonnull instancetype)initWithConfiguration:(GSKReadableCodeFlowConfiguration * _Nonnull)configuration OBJC_DESIGNATED_INITIALIZER;
-/// Starts the readable code scanning flow by presenting a full-screen camera interface.
-/// This method presents a camera view controller that continuously scans for barcodes and QR codes.
-/// The scanning process respects the code types specified in the flow’s configuration.
-/// The method uses Swift’s async/await pattern, suspending until either:
-/// <ul>
-///   <li>
-///     A readable code is successfully detected (except in batch mode)
-///   </li>
-///   <li>
-///     The user taps the done button (batch mode)
-///   </li>
-///   <li>
-///     The user cancels the operation
-///   </li>
-///   <li>
-///     An error occurs during setup or scanning
-///   </li>
-/// </ul>
-/// The behavior varies based on the configuration’s isBatchModeEnabled:
-/// <ul>
-///   <li>
-///     <code>false</code>: Returns immediately after detecting one or more codes in a single frame
-///   </li>
-///   <li>
-///     <code>true</code>: Collects unique codes over time until the user taps the done button
-///   </li>
-/// </ul>
-/// Example usage:
-/// \code
-/// let flow = GSKReadableCodeFlow()
-/// do {
-///     let result = try await flow.resultByStarting(fromViewController: self)
-///     print("Scanned codes: \(result.readableCodes.map { $0.value })")
-/// } catch GSKReadableCodeFlowError.userCancellation {
-///     print("User canceled scanning")
-/// } catch {
-///     print("Scanning failed: \(error)")
-/// }
-///
-/// \endcodeimportant:
-/// This method requires camera permissions. Ensure your app’s Info.plist includes
-/// the <code>NSCameraUsageDescription</code> key with an appropriate description.
-/// note:
-/// The camera interface is presented with <code>modalPresentationStyle</code> set to <code>.fullScreen</code>
-/// for an immersive scanning experience.
-/// \param viewController The view controller from which to present the camera interface.
-/// This should typically be the currently visible view controller.
-///
-///
-/// throws:
-///
-/// <ul>
-///   <li>
-///     Typically throws a <code>GSKReadableCodeFlowError</code>
-///   </li>
-/// </ul>
-///
-/// returns:
-/// A <code>GSKReadableCodeFlowResult</code> containing the detected readable codes with their
-/// decoded values and format types.
-- (void)resultByStartingFromViewController:(UIViewController * _Nonnull)viewController completionHandler:(void (^ _Nonnull)(GSKReadableCodeFlowResult * _Nullable, NSError * _Nullable))completionHandler;
-- (nonnull instancetype)init SWIFT_UNAVAILABLE;
-+ (nonnull instancetype)new SWIFT_UNAVAILABLE_MSG("-init is unavailable");
-@end
-
-@class NSError;
-@interface GSKReadableCodeFlow (SWIFT_EXTENSION(GSSDK))
-/// Instantiates a <code>GSKReadableCodeFlow</code> instance with the provided configuration.
-/// This initializer is only available from Objective-C.
-+ (nonnull instancetype)readableCodeFlowWithConfiguration:(GSKReadableCodeFlowConfiguration * _Nonnull)configuration SWIFT_WARN_UNUSED_RESULT;
-/// Starts the readable code scanning flow.
-/// @param viewController The view controller to present the readable code scanning interface from.
-/// @param successBlock A completion block/closure that will be called on the main
-/// thread upon successful completion of the scan flow. It receives a <code>GSKReadableCodeFlowResult</code> object as
-/// a parameter. This object gives you access to the scanned codes.
-/// @param failureBlock A block/closure called if an error was encountered.
-/// This method is only available from Objective-C.
-- (void)startFromViewController:(UIViewController * _Nonnull)viewController success:(void (^ _Nonnull)(GSKReadableCodeFlowResult * _Nonnull))successBlock failure:(void (^ _Nonnull)(NSError * _Nonnull))failureBlock;
-@end
-
-@class UIColor;
-/// Configuration for the UI readable code scanning flow
-/// This class allows customization of which barcode and QR code formats should be detected
-/// during the scanning process. By default, all supported formats are enabled.
-SWIFT_CLASS("_TtC5GSSDK32GSKReadableCodeFlowConfiguration")
-@interface GSKReadableCodeFlowConfiguration : NSObject
-/// Whether batch mode is enabled for code detection.
-/// This setting controls how codes are detected and when they are returned:
-/// <ul>
-///   <li>
-///     <code>false</code>: Detect multiple codes simultaneously in a single frame and return immediately (default)
-///   </li>
-///   <li>
-///     <code>true</code>: Collect multiple codes over time before returning when user taps Done
-///   </li>
-/// </ul>
-/// Example:
-/// \code
-/// // Standard mode - return codes immediately (default)
-/// let standardConfig = GSKReadableCodeFlowConfiguration(isBatchModeEnabled: false)
-///
-/// // Batch mode - collect codes over time
-/// let batchConfig = GSKReadableCodeFlowConfiguration(isBatchModeEnabled: true)
-///
-/// \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.
-@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).
-@property (nonatomic, strong) UIColor * _Nullable menuColor;
-/// Creates a new readable code flow configuration with default values
-- (nonnull instancetype)init OBJC_DESIGNATED_INITIALIZER;
-@end
-
-@interface GSKReadableCodeFlowConfiguration (SWIFT_EXTENSION(GSSDK))
-/// Create a configuration from a dictionary.
-/// This is used for interfacing with cross-platform plugins but shouldn’t
-/// be used in native projects.
-+ (GSKReadableCodeFlowConfiguration * _Nullable)configurationWithDictionary:(NSDictionary * _Nonnull)dictionary error:(NSError * _Nullable * _Nullable)error SWIFT_WARN_UNUSED_RESULT;
-/// Create a configuration from JSON data.
-/// This is used for interfacing with cross-platform plugins but shouldn’t
-/// be used in native projects.
-+ (GSKReadableCodeFlowConfiguration * _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 readable code flow.
-typedef SWIFT_ENUM(NSInteger, GSKReadableCodeFlowError, open) {
-/// User has canceled the readable code flow
-  GSKReadableCodeFlowUserCancelationError SWIFT_COMPILE_NAME("userCancellation") = 0,
-/// A general error due to a bad configuration parameter
-  GSKReadableCodeFlowConfigurationError SWIFT_COMPILE_NAME("configuration") = 1,
-/// Camera permission was denied
-  GSKReadableCodeFlowPermissionDeniedError SWIFT_COMPILE_NAME("permissionDenied") = 2,
-/// Failed to initialize the barcode detector
-  GSKReadableCodeFlowDetectorError SWIFT_COMPILE_NAME("detectorError") = 3,
-};
-static NSString * _Nonnull const GSKReadableCodeFlowErrorDomain = @"GSSDK.GSKReadableCodeFlowError";
-
-/// The result of a readable code scanning flow
-/// This class encapsulates the successful outcome of a readable code scanning session,
-/// containing the detected barcode or QR code data.
-SWIFT_CLASS("_TtC5GSSDK25GSKReadableCodeFlowResult")
-@interface GSKReadableCodeFlowResult : NSObject
-- (nonnull instancetype)init SWIFT_UNAVAILABLE;
-+ (nonnull instancetype)new SWIFT_UNAVAILABLE_MSG("-init is unavailable");
-@end
-
-@interface GSKReadableCodeFlowResult (SWIFT_EXTENSION(GSSDK))
-/// Returns a dictionary representation of the result
-/// The dictionary contains:
-/// <ul>
-///   <li>
-///     readableCodes: An array of code dictionaries, each containing:
-///     <ul>
-///       <li>
-///         value: The decoded string value
-///       </li>
-///       <li>
-///         type: The code type as a string (e.g., “qr”, “code128”)
-///       </li>
-///     </ul>
-///   </li>
-/// </ul>
-@property (nonatomic, readonly, copy) NSDictionary<NSString *, id> * _Nonnull dictionary;
-/// Returns a JSON representation of the result.
-/// See <code>dictionary</code> for an explanation of the JSON data’s structure.
-- (NSString * _Nonnull)json SWIFT_WARN_UNUSED_RESULT;
-@end
-
 typedef SWIFT_ENUM(NSInteger, GSKReceiptCategory, open) {
   GSKReceiptCategoryGas = 0,
   GSKReceiptCategoryTransportation = 1,
@@ -1257,7 +1345,7 @@ typedef SWIFT_ENUM(NSInteger, GSKScanFlowError, open) {
 };
 
 /// The different possible filters for the scanner UI.
-/// All cases match <code>GSKFilterType</code> values except <code>.automatic</code>.
+/// Each case maps to a predefined filter configuration except <code>.automatic</code>.
 typedef SWIFT_ENUM(NSInteger, GSKScanFlowFilterType, open) {
   GSKScanFlowFilterNone SWIFT_COMPILE_NAME("none") = 0,
 /// Automatic filter
@@ -1373,7 +1461,7 @@ SWIFT_CLASS("_TtC5GSSDK15GSKScanFlowScan")
 /// If OCR was performed, the recognized text.
 @property (nonatomic, strong) GSKScanFlowOCRResult * _Nullable ocrResult;
 /// If structured data extraction was performed, the structured data.
-@property (nonatomic, strong) GSKScanFlowStructuredDataResult * _Nullable structuredDataResult;
+@property (nonatomic, strong) GSKScanFlowStructuredDataResult * _Nullable structuredData;
 - (nonnull instancetype)initWithOriginalFilePath:(NSString * _Nonnull)originalFilePath enhancedFilePath:(NSString * _Nonnull)enhancedFilePath OBJC_DESIGNATED_INITIALIZER;
 - (nonnull instancetype)init SWIFT_UNAVAILABLE;
 + (nonnull instancetype)new SWIFT_UNAVAILABLE_MSG("-init is unavailable");
@@ -1403,6 +1491,8 @@ SWIFT_CLASS("_TtC5GSSDK31GSKScanFlowStructuredDataResult")
 /// Present if receipt extraction was requested and a receipt/invoice was
 /// successfully extracted, <code>nil</code> otherwise.
 @property (nonatomic, strong) GSKStructuredDataReceipt * _Nullable receipt;
+/// Present if barcode extraction was requested and codes were successfully extracted, empty otherwise.
+@property (nonatomic, copy) NSArray<GSKBarcode *> * _Nonnull barcodes;
 - (nonnull instancetype)init OBJC_DESIGNATED_INITIALIZER;
 @end
 
@@ -1571,12 +1661,6 @@ SWIFT_CLASS_PROPERTY(@property (nonatomic, class, readonly, strong) GSKUIBackgro
 - (nonnull instancetype)init OBJC_DESIGNATED_INITIALIZER;
 @end
 
-@interface GSKView (SWIFT_EXTENSION(GSSDK))
-- (void)startSearchAnimation;
-- (void)startSnapAnimationWithDuration:(NSTimeInterval)duration;
-- (void)endSnapAnimation;
-@end
-
 SWIFT_CLASS("_TtC5GSSDK14GSSDKResources")
 @interface GSSDKResources : NSObject
 SWIFT_CLASS_PROPERTY(@property (nonatomic, class, readonly, strong) NSBundle * _Nonnull bundle;)