@incodetech/core 0.0.0-dev-20260402-7cf9db4 → 0.0.0-dev-20260402-0dc2fb9

package/dist/document-capture.d.ts

@@ -1,7 +1,7 @@
 import "./Actor-phIcsUhv.js";
 import { t as CameraStream } from "./camera-Dv2WEhGe.js";
 import { t as Manager } from "./Manager-BndLda4_.js";
-import * as xstate67 from "xstate";
+import * as xstate131 from "xstate";
 
 //#region src/modules/document-capture/types.d.ts
 type DocumentType = 'addressStatement' | 'otherDocument1' | 'otherDocument2' | 'otherDocument3' | 'v5cMultiPageLogbook' | 'circulationCard' | 'financeSettlement' | 'carInvoice' | 'capture' | 'processPoaOcr' | 'processLoaOcr' | 'processAsylumSeekerVisaZaf' | 'processBankStatementOCR' | 'processBankCheck' | 'processV5CLogbook' | 'processCarInvoice' | 'processCirculationCard' | 'processFinanceSettlement';
@@ -9,7 +9,11 @@ declare const DOCUMENT_CAPTURE_ERROR_CODES: {
   readonly FILE_TOO_LARGE: "FILE_TOO_LARGE";
   readonly UPLOAD_FAILED: "UPLOAD_FAILED";
 };
+declare const DOCUMENT_CAPTURE_FINALIZE_ERROR_CODES: {
+  readonly UNEXPECTED_ERROR: "UNEXPECTED_ERROR";
+};
 type DocumentCaptureErrorCode = (typeof DOCUMENT_CAPTURE_ERROR_CODES)[keyof typeof DOCUMENT_CAPTURE_ERROR_CODES];
+type DocumentCaptureFinalizeErrorCode = (typeof DOCUMENT_CAPTURE_FINALIZE_ERROR_CODES)[keyof typeof DOCUMENT_CAPTURE_FINALIZE_ERROR_CODES];
 /**
  * Configuration for the document capture module.
  * Parameterized to support both DOCUMENT_CAPTURE and ADDRESS flows.
@@ -43,7 +47,11 @@ type CapturedDocument = {
 };
 type DocumentUploadResponse = {
   success: boolean;
-  status?: 'ADD_NEXT_PAGE' | 'SUCCESS';
+  status?: 'ADD_NEXT_PAGE' | 'OPTIONAL_PAGE_CAPTURE' | 'SUCCESS';
+};
+type FinalizeDocumentResponse = {
+  status?: string;
+  success?: boolean;
 };
 type DocumentCaptureResolvedConfig = {
   processingType: DocumentType;
@@ -57,23 +65,24 @@ type DocumentCaptureResolvedConfig = {
   step2Title: string | undefined;
   step2Text: string | undefined;
 };
+type DocumentCaptureNextPageType = 'none' | 'required' | 'optional';
 type DocumentCaptureContext = {
   config: DocumentCaptureResolvedConfig;
   stream: CameraStream | undefined;
   capturedDocument: CapturedDocument | undefined;
-  captureMethod: 'camera' | 'file' | undefined;
+  captureMethod: 'camera' | 'file' | 'gallery' | undefined;
   progress: number;
-  error: DocumentCaptureErrorCode | undefined;
+  error: DocumentCaptureErrorCode | DocumentCaptureFinalizeErrorCode | undefined;
   attemptsRemaining: number;
   pageNumber: number;
-  pendingNextPage: boolean;
+  nextPageType: DocumentCaptureNextPageType;
 };
 type DocumentCaptureInput = {
   config: DocumentCaptureConfig;
 };
 //#endregion
 //#region src/modules/document-capture/documentCaptureStateMachine.d.ts
-declare const documentCaptureMachine: xstate67.StateMachine<DocumentCaptureContext, {
+declare const documentCaptureMachine: xstate131.StateMachine<DocumentCaptureContext, {
   type: "CAPTURE";
 } | {
   type: "FILE_SELECTED";
@@ -91,89 +100,116 @@ declare const documentCaptureMachine: xstate67.StateMachine<DocumentCaptureConte
   type: "RETRY";
 } | {
   type: "CONTINUE";
+} | {
+  type: "NEXT_PAGE_CAMERA";
+} | {
+  type: "NEXT_PAGE_PHOTO_LIBRARY";
+} | {
+  type: "ALL_PAGES_CAPTURED";
 } | {
   type: "SKIP";
 } | {
   type: "CLOSE";
 }, {
-  [x: string]: xstate67.ActorRefFromLogic<xstate67.PromiseActorLogic<MediaStream, void, xstate67.EventObject>> | xstate67.ActorRefFromLogic<xstate67.PromiseActorLogic<DocumentUploadResponse, {
+  [x: string]: xstate131.ActorRefFromLogic<xstate131.PromiseActorLogic<MediaStream, void, xstate131.EventObject>> | xstate131.ActorRefFromLogic<xstate131.PromiseActorLogic<DocumentUploadResponse, {
     capturedDocument: NonNullable<DocumentCaptureContext["capturedDocument"]>;
     processingType: string;
     onProgress: (progress: number) => void;
-  }, xstate67.EventObject>> | undefined;
-}, xstate67.Values<{
+  }, xstate131.EventObject>> | xstate131.ActorRefFromLogic<xstate131.PromiseActorLogic<FinalizeDocumentResponse, {
+    processingType: string;
+  }, xstate131.EventObject>> | undefined;
+}, xstate131.Values<{
   initCamera: {
     src: "initCamera";
-    logic: xstate67.PromiseActorLogic<MediaStream, void, xstate67.EventObject>;
+    logic: xstate131.PromiseActorLogic<MediaStream, void, xstate131.EventObject>;
     id: string | undefined;
   };
   uploadDocument: {
     src: "uploadDocument";
-    logic: xstate67.PromiseActorLogic<DocumentUploadResponse, {
+    logic: xstate131.PromiseActorLogic<DocumentUploadResponse, {
       capturedDocument: NonNullable<DocumentCaptureContext["capturedDocument"]>;
       processingType: string;
       onProgress: (progress: number) => void;
-    }, xstate67.EventObject>;
+    }, xstate131.EventObject>;
     id: string | undefined;
   };
-}>, xstate67.Values<{
-  clearError: {
-    type: "clearError";
-    params: xstate67.NonReducibleUnknown;
+  finalizeDocumentRequest: {
+    src: "finalizeDocumentRequest";
+    logic: xstate131.PromiseActorLogic<FinalizeDocumentResponse, {
+      processingType: string;
+    }, xstate131.EventObject>;
+    id: string | undefined;
   };
+}>, xstate131.Values<{
   setStream: {
     type: "setStream";
-    params: xstate67.NonReducibleUnknown;
+    params: xstate131.NonReducibleUnknown;
+  };
+  setProgress: {
+    type: "setProgress";
+    params: xstate131.NonReducibleUnknown;
+  };
+  clearError: {
+    type: "clearError";
+    params: xstate131.NonReducibleUnknown;
+  };
+  stopStream: {
+    type: "stopStream";
+    params: xstate131.NonReducibleUnknown;
   };
   setCapturedDocument: {
     type: "setCapturedDocument";
-    params: xstate67.NonReducibleUnknown;
+    params: xstate131.NonReducibleUnknown;
   };
   setFileTooLargeError: {
     type: "setFileTooLargeError";
-    params: xstate67.NonReducibleUnknown;
-  };
-  setProgress: {
-    type: "setProgress";
-    params: xstate67.NonReducibleUnknown;
+    params: xstate131.NonReducibleUnknown;
   };
   setUploadError: {
     type: "setUploadError";
-    params: xstate67.NonReducibleUnknown;
+    params: xstate131.NonReducibleUnknown;
+  };
+  setFinalizeError: {
+    type: "setFinalizeError";
+    params: xstate131.NonReducibleUnknown;
   };
   decrementAttemptsRemaining: {
     type: "decrementAttemptsRemaining";
-    params: xstate67.NonReducibleUnknown;
+    params: xstate131.NonReducibleUnknown;
   };
   setCaptureMethodFile: {
     type: "setCaptureMethodFile";
-    params: xstate67.NonReducibleUnknown;
+    params: xstate131.NonReducibleUnknown;
   };
   setCaptureMethodCamera: {
     type: "setCaptureMethodCamera";
-    params: xstate67.NonReducibleUnknown;
+    params: xstate131.NonReducibleUnknown;
+  };
+  setCaptureMethodGallery: {
+    type: "setCaptureMethodGallery";
+    params: xstate131.NonReducibleUnknown;
   };
   clearCapturedDocument: {
     type: "clearCapturedDocument";
-    params: xstate67.NonReducibleUnknown;
+    params: xstate131.NonReducibleUnknown;
+  };
+  clearCapturedDocumentGalleryRetake: {
+    type: "clearCapturedDocumentGalleryRetake";
+    params: xstate131.NonReducibleUnknown;
   };
-  setPendingNextPage: {
-    type: "setPendingNextPage";
-    params: xstate67.NonReducibleUnknown;
+  setNextPageType: {
+    type: "setNextPageType";
+    params: xstate131.NonReducibleUnknown;
   };
   clearForNextPage: {
     type: "clearForNextPage";
-    params: xstate67.NonReducibleUnknown;
+    params: xstate131.NonReducibleUnknown;
   };
   resetProgress: {
     type: "resetProgress";
-    params: xstate67.NonReducibleUnknown;
-  };
-  stopStream: {
-    type: "stopStream";
-    params: xstate67.NonReducibleUnknown;
+    params: xstate131.NonReducibleUnknown;
   };
-}>, xstate67.Values<{
+}>, xstate131.Values<{
   allowSkip: {
     type: "allowSkip";
     params: unknown;
@@ -182,10 +218,6 @@ declare const documentCaptureMachine: xstate67.StateMachine<DocumentCaptureConte
     type: "fileSizeOk";
     params: unknown;
   };
-  hasAttemptsRemaining: {
-    type: "hasAttemptsRemaining";
-    params: unknown;
-  };
   canRetryCamera: {
     type: "canRetryCamera";
     params: unknown;
@@ -202,84 +234,134 @@ declare const documentCaptureMachine: xstate67.StateMachine<DocumentCaptureConte
     type: "isCameraMode";
     params: unknown;
   };
+  isCaptureMethodCamera: {
+    type: "isCaptureMethodCamera";
+    params: unknown;
+  };
+  isCaptureMethodGallery: {
+    type: "isCaptureMethodGallery";
+    params: unknown;
+  };
   isCaptureMethodFile: {
     type: "isCaptureMethodFile";
     params: unknown;
   };
-  isPendingNextPage: {
-    type: "isPendingNextPage";
+  isNextPageOptional: {
+    type: "isNextPageOptional";
     params: unknown;
   };
-}>, never, "finished" | "initCamera" | "tutorial" | "capturing" | "preview" | "closed" | "failure" | "uploading" | "success", string, DocumentCaptureInput, xstate67.NonReducibleUnknown, xstate67.EventObject, xstate67.MetaObject, {
+  isNextPageRequired: {
+    type: "isNextPageRequired";
+    params: unknown;
+  };
+  canFinalizeOptionalPages: {
+    type: "canFinalizeOptionalPages";
+    params: unknown;
+  };
+  fileSizeOkForGallery: {
+    type: "fileSizeOkForGallery";
+    params: unknown;
+  };
+  fileSizeOkForNonGallery: {
+    type: "fileSizeOkForNonGallery";
+    params: unknown;
+  };
+}>, never, "initCamera" | "capturing" | "closed" | "uploading" | "finished" | "tutorial" | "preview" | "failure" | "success" | "nextPage" | "finalizing", string, DocumentCaptureInput, xstate131.NonReducibleUnknown, xstate131.EventObject, xstate131.MetaObject, {
   readonly id: "documentCapture";
   readonly initial: "tutorial";
   readonly context: ({
     input
   }: {
     spawn: {
-      <TSrc extends "initCamera" | "uploadDocument">(logic: TSrc, ...[options]: ({
+      <TSrc extends "initCamera" | "uploadDocument" | "finalizeDocumentRequest">(logic: TSrc, ...[options]: ({
         src: "initCamera";
-        logic: xstate67.PromiseActorLogic<MediaStream, void, xstate67.EventObject>;
+        logic: xstate131.PromiseActorLogic<MediaStream, void, xstate131.EventObject>;
         id: string | undefined;
       } extends infer T ? T extends {
         src: "initCamera";
-        logic: xstate67.PromiseActorLogic<MediaStream, void, xstate67.EventObject>;
+        logic: xstate131.PromiseActorLogic<MediaStream, void, xstate131.EventObject>;
         id: string | undefined;
       } ? T extends {
         src: TSrc;
-      } ? xstate67.ConditionalRequired<[options?: ({
+      } ? xstate131.ConditionalRequired<[options?: ({
         id?: T["id"] | undefined;
         systemId?: string;
-        input?: xstate67.InputFrom<T["logic"]> | undefined;
+        input?: xstate131.InputFrom<T["logic"]> | undefined;
         syncSnapshot?: boolean;
-      } & { [K in xstate67.RequiredActorOptions<T>]: unknown }) | undefined], xstate67.IsNotNever<xstate67.RequiredActorOptions<T>>> : never : never : never) | ({
+      } & { [K in xstate131.RequiredActorOptions<T>]: unknown }) | undefined], xstate131.IsNotNever<xstate131.RequiredActorOptions<T>>> : never : never : never) | ({
         src: "uploadDocument";
-        logic: xstate67.PromiseActorLogic<DocumentUploadResponse, {
+        logic: xstate131.PromiseActorLogic<DocumentUploadResponse, {
           capturedDocument: NonNullable<DocumentCaptureContext["capturedDocument"]>;
           processingType: string;
           onProgress: (progress: number) => void;
-        }, xstate67.EventObject>;
+        }, xstate131.EventObject>;
         id: string | undefined;
       } extends infer T_1 ? T_1 extends {
         src: "uploadDocument";
-        logic: xstate67.PromiseActorLogic<DocumentUploadResponse, {
+        logic: xstate131.PromiseActorLogic<DocumentUploadResponse, {
           capturedDocument: NonNullable<DocumentCaptureContext["capturedDocument"]>;
           processingType: string;
           onProgress: (progress: number) => void;
-        }, xstate67.EventObject>;
+        }, xstate131.EventObject>;
         id: string | undefined;
       } ? T_1 extends {
         src: TSrc;
-      } ? xstate67.ConditionalRequired<[options?: ({
+      } ? xstate131.ConditionalRequired<[options?: ({
         id?: T_1["id"] | undefined;
         systemId?: string;
-        input?: xstate67.InputFrom<T_1["logic"]> | undefined;
+        input?: xstate131.InputFrom<T_1["logic"]> | undefined;
+        syncSnapshot?: boolean;
+      } & { [K_1 in xstate131.RequiredActorOptions<T_1>]: unknown }) | undefined], xstate131.IsNotNever<xstate131.RequiredActorOptions<T_1>>> : never : never : never) | ({
+        src: "finalizeDocumentRequest";
+        logic: xstate131.PromiseActorLogic<FinalizeDocumentResponse, {
+          processingType: string;
+        }, xstate131.EventObject>;
+        id: string | undefined;
+      } extends infer T_2 ? T_2 extends {
+        src: "finalizeDocumentRequest";
+        logic: xstate131.PromiseActorLogic<FinalizeDocumentResponse, {
+          processingType: string;
+        }, xstate131.EventObject>;
+        id: string | undefined;
+      } ? T_2 extends {
+        src: TSrc;
+      } ? xstate131.ConditionalRequired<[options?: ({
+        id?: T_2["id"] | undefined;
+        systemId?: string;
+        input?: xstate131.InputFrom<T_2["logic"]> | undefined;
         syncSnapshot?: boolean;
-      } & { [K_1 in xstate67.RequiredActorOptions<T_1>]: unknown }) | undefined], xstate67.IsNotNever<xstate67.RequiredActorOptions<T_1>>> : never : never : never)): xstate67.ActorRefFromLogic<xstate67.GetConcreteByKey<xstate67.Values<{
+      } & { [K_2 in xstate131.RequiredActorOptions<T_2>]: unknown }) | undefined], xstate131.IsNotNever<xstate131.RequiredActorOptions<T_2>>> : never : never : never)): xstate131.ActorRefFromLogic<xstate131.GetConcreteByKey<xstate131.Values<{
         initCamera: {
           src: "initCamera";
-          logic: xstate67.PromiseActorLogic<MediaStream, void, xstate67.EventObject>;
+          logic: xstate131.PromiseActorLogic<MediaStream, void, xstate131.EventObject>;
           id: string | undefined;
         };
         uploadDocument: {
           src: "uploadDocument";
-          logic: xstate67.PromiseActorLogic<DocumentUploadResponse, {
+          logic: xstate131.PromiseActorLogic<DocumentUploadResponse, {
             capturedDocument: NonNullable<DocumentCaptureContext["capturedDocument"]>;
             processingType: string;
             onProgress: (progress: number) => void;
-          }, xstate67.EventObject>;
+          }, xstate131.EventObject>;
+          id: string | undefined;
+        };
+        finalizeDocumentRequest: {
+          src: "finalizeDocumentRequest";
+          logic: xstate131.PromiseActorLogic<FinalizeDocumentResponse, {
+            processingType: string;
+          }, xstate131.EventObject>;
           id: string | undefined;
         };
       }>, "src", TSrc>["logic"]>;
-      <TLogic extends xstate67.AnyActorLogic>(src: TLogic, ...[options]: xstate67.ConditionalRequired<[options?: ({
+      <TLogic extends xstate131.AnyActorLogic>(src: TLogic, ...[options]: xstate131.ConditionalRequired<[options?: ({
         id?: never;
         systemId?: string;
-        input?: xstate67.InputFrom<TLogic> | undefined;
+        input?: xstate131.InputFrom<TLogic> | undefined;
         syncSnapshot?: boolean;
-      } & { [K in xstate67.RequiredLogicInput<TLogic>]: unknown }) | undefined], xstate67.IsNotNever<xstate67.RequiredLogicInput<TLogic>>>): xstate67.ActorRefFromLogic<TLogic>;
+      } & { [K in xstate131.RequiredLogicInput<TLogic>]: unknown }) | undefined], xstate131.IsNotNever<xstate131.RequiredLogicInput<TLogic>>>): xstate131.ActorRefFromLogic<TLogic>;
     };
     input: DocumentCaptureInput;
-    self: xstate67.ActorRef<xstate67.MachineSnapshot<DocumentCaptureContext, {
+    self: xstate131.ActorRef<xstate131.MachineSnapshot<DocumentCaptureContext, {
       type: "CAPTURE";
     } | {
       type: "FILE_SELECTED";
@@ -297,11 +379,17 @@ declare const documentCaptureMachine: xstate67.StateMachine<DocumentCaptureConte
       type: "RETRY";
     } | {
       type: "CONTINUE";
+    } | {
+      type: "NEXT_PAGE_CAMERA";
+    } | {
+      type: "NEXT_PAGE_PHOTO_LIBRARY";
+    } | {
+      type: "ALL_PAGES_CAPTURED";
     } | {
       type: "SKIP";
     } | {
       type: "CLOSE";
-    }, Record<string, xstate67.AnyActorRef | undefined>, xstate67.StateValue, string, unknown, any, any>, {
+    }, Record<string, xstate131.AnyActorRef | undefined>, xstate131.StateValue, string, unknown, any, any>, {
       type: "CAPTURE";
     } | {
       type: "FILE_SELECTED";
@@ -319,11 +407,17 @@ declare const documentCaptureMachine: xstate67.StateMachine<DocumentCaptureConte
       type: "RETRY";
     } | {
       type: "CONTINUE";
+    } | {
+      type: "NEXT_PAGE_CAMERA";
+    } | {
+      type: "NEXT_PAGE_PHOTO_LIBRARY";
+    } | {
+      type: "ALL_PAGES_CAPTURED";
     } | {
       type: "SKIP";
     } | {
       type: "CLOSE";
-    }, xstate67.AnyEventObject>;
+    }, xstate131.AnyEventObject>;
   }) => {
     config: {
       processingType: DocumentType;
@@ -344,7 +438,7 @@ declare const documentCaptureMachine: xstate67.StateMachine<DocumentCaptureConte
     error: undefined;
     attemptsRemaining: number;
     pageNumber: number;
-    pendingNextPage: false;
+    nextPageType: "none";
   };
   readonly states: {
     readonly tutorial: {
@@ -396,7 +490,11 @@ declare const documentCaptureMachine: xstate67.StateMachine<DocumentCaptureConte
       readonly on: {
         readonly FILE_SELECTED: readonly [{
           readonly target: "preview";
-          readonly guard: "fileSizeOk";
+          readonly guard: "fileSizeOkForGallery";
+          readonly actions: "setCapturedDocument";
+        }, {
+          readonly target: "preview";
+          readonly guard: "fileSizeOkForNonGallery";
           readonly actions: readonly ["setCapturedDocument", "setCaptureMethodCamera"];
         }, {
           readonly target: "capturing";
@@ -418,6 +516,10 @@ declare const documentCaptureMachine: xstate67.StateMachine<DocumentCaptureConte
           readonly target: "tutorial";
           readonly guard: "isCaptureMethodFile";
           readonly actions: "clearCapturedDocument";
+        }, {
+          readonly target: "capturing";
+          readonly guard: "isCaptureMethodGallery";
+          readonly actions: "clearCapturedDocumentGalleryRetake";
         }, {
           readonly target: "capturing";
           readonly actions: "clearCapturedDocument";
@@ -455,12 +557,18 @@ declare const documentCaptureMachine: xstate67.StateMachine<DocumentCaptureConte
             type: "RETRY";
           } | {
             type: "CONTINUE";
+          } | {
+            type: "NEXT_PAGE_CAMERA";
+          } | {
+            type: "NEXT_PAGE_PHOTO_LIBRARY";
+          } | {
+            type: "ALL_PAGES_CAPTURED";
           } | {
             type: "SKIP";
           } | {
             type: "CLOSE";
           };
-          self: xstate67.ActorRef<xstate67.MachineSnapshot<DocumentCaptureContext, {
+          self: xstate131.ActorRef<xstate131.MachineSnapshot<DocumentCaptureContext, {
             type: "CAPTURE";
           } | {
             type: "FILE_SELECTED";
@@ -478,11 +586,17 @@ declare const documentCaptureMachine: xstate67.StateMachine<DocumentCaptureConte
             type: "RETRY";
           } | {
             type: "CONTINUE";
+          } | {
+            type: "NEXT_PAGE_CAMERA";
+          } | {
+            type: "NEXT_PAGE_PHOTO_LIBRARY";
+          } | {
+            type: "ALL_PAGES_CAPTURED";
           } | {
             type: "SKIP";
           } | {
             type: "CLOSE";
-          }, Record<string, xstate67.AnyActorRef>, xstate67.StateValue, string, unknown, any, any>, {
+          }, Record<string, xstate131.AnyActorRef>, xstate131.StateValue, string, unknown, any, any>, {
             type: "CAPTURE";
           } | {
             type: "FILE_SELECTED";
@@ -500,11 +614,17 @@ declare const documentCaptureMachine: xstate67.StateMachine<DocumentCaptureConte
             type: "RETRY";
           } | {
             type: "CONTINUE";
+          } | {
+            type: "NEXT_PAGE_CAMERA";
+          } | {
+            type: "NEXT_PAGE_PHOTO_LIBRARY";
+          } | {
+            type: "ALL_PAGES_CAPTURED";
           } | {
             type: "SKIP";
           } | {
             type: "CLOSE";
-          }, xstate67.AnyEventObject>;
+          }, xstate131.AnyEventObject>;
         }) => {
           capturedDocument: CapturedDocument;
           processingType: DocumentType;
@@ -512,7 +632,7 @@ declare const documentCaptureMachine: xstate67.StateMachine<DocumentCaptureConte
         };
         readonly onDone: {
           readonly target: "success";
-          readonly actions: readonly ["setPendingNextPage", "stopStream"];
+          readonly actions: readonly ["setNextPageType", "stopStream"];
         };
         readonly onError: {
           readonly target: "failure";
@@ -528,12 +648,144 @@ declare const documentCaptureMachine: xstate67.StateMachine<DocumentCaptureConte
     readonly success: {
       readonly on: {
         readonly CONTINUE: readonly [{
-          readonly target: "tutorial";
-          readonly guard: "isPendingNextPage";
-          readonly actions: "clearForNextPage";
+          readonly target: "nextPage";
+          readonly guard: "isNextPageOptional";
+        }, {
+          readonly target: "nextPage";
+          readonly guard: "isNextPageRequired";
         }, {
           readonly target: "finished";
         }];
+        readonly CLOSE: {
+          readonly target: "closed";
+        };
+      };
+    };
+    readonly nextPage: {
+      readonly on: {
+        readonly NEXT_PAGE_CAMERA: {
+          readonly target: "initCamera";
+          readonly actions: readonly ["clearForNextPage", "setCaptureMethodCamera"];
+        };
+        readonly NEXT_PAGE_PHOTO_LIBRARY: {
+          readonly target: "capturing";
+          readonly actions: readonly ["clearForNextPage", "setCaptureMethodGallery"];
+        };
+        readonly ALL_PAGES_CAPTURED: readonly [{
+          readonly target: "finalizing";
+          readonly guard: "canFinalizeOptionalPages";
+        }, {
+          readonly target: "finished";
+        }];
+        readonly CLOSE: {
+          readonly target: "closed";
+        };
+      };
+    };
+    readonly finalizing: {
+      readonly invoke: {
+        readonly id: "finalizeDocument";
+        readonly src: "finalizeDocumentRequest";
+        readonly input: ({
+          context
+        }: {
+          context: DocumentCaptureContext;
+          event: {
+            type: "CAPTURE";
+          } | {
+            type: "FILE_SELECTED";
+            file: File;
+            imageBase64: string;
+            fileType: string;
+          } | {
+            type: "ACCEPT";
+          } | {
+            type: "RETAKE";
+          } | {
+            type: "UPLOAD_PROGRESS";
+            progress: number;
+          } | {
+            type: "RETRY";
+          } | {
+            type: "CONTINUE";
+          } | {
+            type: "NEXT_PAGE_CAMERA";
+          } | {
+            type: "NEXT_PAGE_PHOTO_LIBRARY";
+          } | {
+            type: "ALL_PAGES_CAPTURED";
+          } | {
+            type: "SKIP";
+          } | {
+            type: "CLOSE";
+          };
+          self: xstate131.ActorRef<xstate131.MachineSnapshot<DocumentCaptureContext, {
+            type: "CAPTURE";
+          } | {
+            type: "FILE_SELECTED";
+            file: File;
+            imageBase64: string;
+            fileType: string;
+          } | {
+            type: "ACCEPT";
+          } | {
+            type: "RETAKE";
+          } | {
+            type: "UPLOAD_PROGRESS";
+            progress: number;
+          } | {
+            type: "RETRY";
+          } | {
+            type: "CONTINUE";
+          } | {
+            type: "NEXT_PAGE_CAMERA";
+          } | {
+            type: "NEXT_PAGE_PHOTO_LIBRARY";
+          } | {
+            type: "ALL_PAGES_CAPTURED";
+          } | {
+            type: "SKIP";
+          } | {
+            type: "CLOSE";
+          }, Record<string, xstate131.AnyActorRef>, xstate131.StateValue, string, unknown, any, any>, {
+            type: "CAPTURE";
+          } | {
+            type: "FILE_SELECTED";
+            file: File;
+            imageBase64: string;
+            fileType: string;
+          } | {
+            type: "ACCEPT";
+          } | {
+            type: "RETAKE";
+          } | {
+            type: "UPLOAD_PROGRESS";
+            progress: number;
+          } | {
+            type: "RETRY";
+          } | {
+            type: "CONTINUE";
+          } | {
+            type: "NEXT_PAGE_CAMERA";
+          } | {
+            type: "NEXT_PAGE_PHOTO_LIBRARY";
+          } | {
+            type: "ALL_PAGES_CAPTURED";
+          } | {
+            type: "SKIP";
+          } | {
+            type: "CLOSE";
+          }, xstate131.AnyEventObject>;
+        }) => {
+          processingType: DocumentType;
+        };
+        readonly onDone: {
+          readonly target: "finished";
+        };
+        readonly onError: {
+          readonly target: "failure";
+          readonly actions: "setFinalizeError";
+        };
       };
     };
     readonly failure: {
@@ -589,6 +841,7 @@ type DocumentCaptureCapturingState = {
   status: 'capturing';
   stream: MediaStream | undefined;
   captureMode: 'file' | 'camera';
+  captureMethod: 'camera' | 'file' | 'gallery' | undefined;
   error: DocumentCaptureErrorCode | undefined;
   pageNumber: number;
 };
@@ -610,7 +863,7 @@ type DocumentCaptureSuccessState = {
   imageBase64: string;
   fileType: string;
   fileName: string;
-  pendingNextPage: boolean;
+  nextPageType: DocumentCaptureNextPageType;
 };
 type DocumentCaptureFailureState = {
   status: 'failure';
@@ -623,7 +876,20 @@ type DocumentCaptureFinishedState = {
 type DocumentCaptureClosedState = {
   status: 'closed';
 };
-type DocumentCaptureState = DocumentCaptureTutorialState | DocumentCaptureInitializingCameraState | DocumentCaptureCapturingState | DocumentCapturePreviewState | DocumentCaptureUploadingState | DocumentCaptureSuccessState | DocumentCaptureFailureState | DocumentCaptureFinishedState | DocumentCaptureClosedState;
+type DocumentCaptureNextPageState = {
+  status: 'nextPage';
+  imageBase64: string;
+  fileType: string;
+  fileName: string;
+  pageNumber: number;
+  nextPageType: Exclude<DocumentCaptureNextPageType, 'none'>;
+  captureMode: 'file' | 'camera';
+};
+/** Confirming optional multi-page capture with the backend (short-lived). */
+type DocumentCaptureFinalizingState = {
+  status: 'finalizing';
+};
+type DocumentCaptureState = DocumentCaptureTutorialState | DocumentCaptureInitializingCameraState | DocumentCaptureCapturingState | DocumentCapturePreviewState | DocumentCaptureUploadingState | DocumentCaptureSuccessState | DocumentCaptureFailureState | DocumentCaptureFinishedState | DocumentCaptureClosedState | DocumentCaptureNextPageState | DocumentCaptureFinalizingState;
 declare function createDocumentCaptureManager(options: CreateDocumentCaptureActorOptions): Manager<DocumentCaptureState> & {
   capture(): void;
   setFile(file: File, imageBase64: string): void;
@@ -633,7 +899,10 @@ declare function createDocumentCaptureManager(options: CreateDocumentCaptureActo
   continue(): void;
   skip(): void;
   close(): void;
+  captureNextPageFromCamera(): void;
+  captureNextPageFromFile(): void;
+  finishPageCapture(): void;
 };
 type DocumentCaptureManager = ReturnType<typeof createDocumentCaptureManager>;
 //#endregion
-export { DOCUMENT_CAPTURE_ERROR_CODES, type DocumentCaptureConfig, type DocumentCaptureErrorCode, type DocumentCaptureManager, type DocumentCaptureState, type DocumentType, createDocumentCaptureManager, documentCaptureMachine };
+export { DOCUMENT_CAPTURE_ERROR_CODES, type DocumentCaptureConfig, type DocumentCaptureErrorCode, type DocumentCaptureManager, type DocumentCaptureNextPageType, type DocumentCaptureState, type DocumentType, createDocumentCaptureManager, documentCaptureMachine };