@incodetech/core 2.0.1-rc.0 → 2.1.0-rc.0

package/dist/{index-DZoqeAo9.d.ts → index-B9NysVDB.d.ts}

@@ -1,5 +1,5 @@
-import { t as Manager } from "./Manager-C8PrhBOx.js";
-import * as xstate978 from "xstate";
+import { t as Manager } from "./Manager-BHn8wH8K.js";
+import * as xstate1112 from "xstate";
 
 //#region src/modules/electronic-signature/types.d.ts
 type ElectronicSignatureVariant = 'ae' | 'qe';
@@ -36,6 +36,14 @@ type ElectronicSignatureContext = {
   fileName: string | null;
   fileSize: number | null;
   fileUrl: string | null;
+  /**
+   * Upload destination for the single document this session may hold.
+   * Generated exactly once (`POST /generateDocumentUploadUrl` creates a
+   * server-side document) and reused across upload retries so a session can
+   * never accumulate more than one document — see the AES "two documents"
+   * bug where a retry created a second, unremovable document.
+   */
+  preSignedUrl: string | null;
   consentChecks: ConsentChecks;
   viewingDocumentUrl: string | null;
   errorMessage: string;
@@ -47,7 +55,7 @@ type ElectronicSignatureInput = {
 };
 //#endregion
 //#region src/modules/electronic-signature/electronicSignatureStateMachine.d.ts
-declare const electronicSignatureMachine: xstate978.StateMachine<ElectronicSignatureContext, {
+declare const electronicSignatureMachine: xstate1112.StateMachine<ElectronicSignatureContext, {
   type: "LOAD";
 } | {
   type: "SELECT_FILE";
@@ -76,59 +84,74 @@ declare const electronicSignatureMachine: xstate978.StateMachine<ElectronicSigna
 } | {
   type: "CLOSE";
 }, {
-  [x: string]: xstate978.ActorRefFromLogic<xstate978.PromiseActorLogic<void, {
-    getFileData: () => ArrayBuffer | null;
-  }, xstate978.EventObject>> | xstate978.ActorRefFromLogic<xstate978.PromiseActorLogic<UnsignedDocsResponse, void, xstate978.EventObject>> | xstate978.ActorRefFromLogic<xstate978.PromiseActorLogic<SignedDocument[], {
+  [x: string]: xstate1112.ActorRefFromLogic<xstate1112.PromiseActorLogic<UnsignedDocsResponse, void, xstate1112.EventObject>> | xstate1112.ActorRefFromLogic<xstate1112.PromiseActorLogic<SignedDocument[], {
     documents: ElectronicSignatureDocument[];
     variant: ElectronicSignatureVariant;
-  }, xstate978.EventObject>> | undefined;
-}, xstate978.Values<{
-  uploadDocument: {
-    src: "uploadDocument";
-    logic: xstate978.PromiseActorLogic<void, {
-      getFileData: () => ArrayBuffer | null;
-    }, xstate978.EventObject>;
-    id: string | undefined;
-  };
+  }, xstate1112.EventObject>> | xstate1112.ActorRefFromLogic<xstate1112.PromiseActorLogic<{
+    preSignedUrl: string;
+  }, void, xstate1112.EventObject>> | xstate1112.ActorRefFromLogic<xstate1112.PromiseActorLogic<void, {
+    preSignedUrl: string;
+    getFileData: () => ArrayBuffer | null;
+  }, xstate1112.EventObject>> | undefined;
+}, xstate1112.Values<{
   fetchUnsignedDocs: {
     src: "fetchUnsignedDocs";
-    logic: xstate978.PromiseActorLogic<UnsignedDocsResponse, void, xstate978.EventObject>;
+    logic: xstate1112.PromiseActorLogic<UnsignedDocsResponse, void, xstate1112.EventObject>;
     id: string | undefined;
   };
   signDocuments: {
     src: "signDocuments";
-    logic: xstate978.PromiseActorLogic<SignedDocument[], {
+    logic: xstate1112.PromiseActorLogic<SignedDocument[], {
       documents: ElectronicSignatureDocument[];
       variant: ElectronicSignatureVariant;
-    }, xstate978.EventObject>;
+    }, xstate1112.EventObject>;
+    id: string | undefined;
+  };
+  generateUploadUrl: {
+    src: "generateUploadUrl";
+    logic: xstate1112.PromiseActorLogic<{
+      preSignedUrl: string;
+    }, void, xstate1112.EventObject>;
     id: string | undefined;
   };
-}>, xstate978.Values<{
+  uploadFile: {
+    src: "uploadFile";
+    logic: xstate1112.PromiseActorLogic<void, {
+      preSignedUrl: string;
+      getFileData: () => ArrayBuffer | null;
+    }, xstate1112.EventObject>;
+    id: string | undefined;
+  };
+}>, xstate1112.Values<{
   setDocuments: {
     type: "setDocuments";
-    params: xstate978.NonReducibleUnknown;
+    params: xstate1112.NonReducibleUnknown;
   };
   setSignedDocuments: {
     type: "setSignedDocuments";
-    params: xstate978.NonReducibleUnknown;
+    params: xstate1112.NonReducibleUnknown;
   };
   setFile: {
     type: "setFile";
-    params: xstate978.NonReducibleUnknown;
+    params: xstate1112.NonReducibleUnknown;
+  };
+  setUploadUrl: {
+    type: "setUploadUrl";
+    params: xstate1112.NonReducibleUnknown;
   };
   updateConsent: {
     type: "updateConsent";
-    params: xstate978.NonReducibleUnknown;
+    params: xstate1112.NonReducibleUnknown;
   };
   setViewingDocument: {
     type: "setViewingDocument";
-    params: xstate978.NonReducibleUnknown;
+    params: xstate1112.NonReducibleUnknown;
   };
   clearViewingDocument: {
     type: "clearViewingDocument";
-    params: xstate978.NonReducibleUnknown;
+    params: xstate1112.NonReducibleUnknown;
   };
-}>, xstate978.Values<{
+}>, xstate1112.Values<{
   errorFromUpload: {
     type: "errorFromUpload";
     params: unknown;
@@ -141,8 +164,8 @@ declare const electronicSignatureMachine: xstate978.StateMachine<ElectronicSigna
     type: "shouldUpload";
     params: unknown;
   };
-  shouldDownload: {
-    type: "shouldDownload";
+  hasUploadUrl: {
+    type: "hasUploadUrl";
     params: unknown;
   };
   allConsented: {
@@ -161,99 +184,132 @@ declare const electronicSignatureMachine: xstate978.StateMachine<ElectronicSigna
     type: "allSignedAndDownload";
     params: unknown;
   };
-}>, never, "error" | "signing" | "idle" | "uploading" | "fetchingDocs" | "reviewing" | "closed" | "uploadingFile" | "processing" | "successDownload" | "success" | "finished", string, ElectronicSignatureInput, xstate978.NonReducibleUnknown, xstate978.EventObject, xstate978.MetaObject, {
+  isRetryableSignError: {
+    type: "isRetryableSignError";
+    params: unknown;
+  };
+}>, never, "error" | "signing" | "idle" | "uploading" | "fetchingDocs" | "reviewing" | "closed" | "uploadingFile" | "generatingUploadUrl" | "processing" | "successDownload" | "success" | "failed" | "finished", string, ElectronicSignatureInput, xstate1112.NonReducibleUnknown, xstate1112.EventObject, xstate1112.MetaObject, {
   readonly id: "electronicSignature";
   readonly initial: "idle";
   readonly context: ({
     input
   }: {
     spawn: {
-      <TSrc extends "uploadDocument" | "fetchUnsignedDocs" | "signDocuments">(logic: TSrc, ...[options]: ({
-        src: "uploadDocument";
-        logic: xstate978.PromiseActorLogic<void, {
-          getFileData: () => ArrayBuffer | null;
-        }, xstate978.EventObject>;
+      <TSrc extends "fetchUnsignedDocs" | "signDocuments" | "generateUploadUrl" | "uploadFile">(logic: TSrc, ...[options]: ({
+        src: "fetchUnsignedDocs";
+        logic: xstate1112.PromiseActorLogic<UnsignedDocsResponse, void, xstate1112.EventObject>;
         id: string | undefined;
       } extends infer T ? T extends {
-        src: "uploadDocument";
-        logic: xstate978.PromiseActorLogic<void, {
-          getFileData: () => ArrayBuffer | null;
-        }, xstate978.EventObject>;
+        src: "fetchUnsignedDocs";
+        logic: xstate1112.PromiseActorLogic<UnsignedDocsResponse, void, xstate1112.EventObject>;
         id: string | undefined;
       } ? T extends {
         src: TSrc;
-      } ? xstate978.ConditionalRequired<[options?: ({
+      } ? xstate1112.ConditionalRequired<[options?: ({
         id?: T["id"] | undefined;
         systemId?: string;
-        input?: xstate978.InputFrom<T["logic"]> | undefined;
+        input?: xstate1112.InputFrom<T["logic"]> | undefined;
         syncSnapshot?: boolean;
-      } & { [K in xstate978.RequiredActorOptions<T>]: unknown }) | undefined], xstate978.IsNotNever<xstate978.RequiredActorOptions<T>>> : never : never : never) | ({
-        src: "fetchUnsignedDocs";
-        logic: xstate978.PromiseActorLogic<UnsignedDocsResponse, void, xstate978.EventObject>;
+      } & { [K in xstate1112.RequiredActorOptions<T>]: unknown }) | undefined], xstate1112.IsNotNever<xstate1112.RequiredActorOptions<T>>> : never : never : never) | ({
+        src: "signDocuments";
+        logic: xstate1112.PromiseActorLogic<SignedDocument[], {
+          documents: ElectronicSignatureDocument[];
+          variant: ElectronicSignatureVariant;
+        }, xstate1112.EventObject>;
         id: string | undefined;
       } extends infer T_1 ? T_1 extends {
-        src: "fetchUnsignedDocs";
-        logic: xstate978.PromiseActorLogic<UnsignedDocsResponse, void, xstate978.EventObject>;
+        src: "signDocuments";
+        logic: xstate1112.PromiseActorLogic<SignedDocument[], {
+          documents: ElectronicSignatureDocument[];
+          variant: ElectronicSignatureVariant;
+        }, xstate1112.EventObject>;
         id: string | undefined;
       } ? T_1 extends {
         src: TSrc;
-      } ? xstate978.ConditionalRequired<[options?: ({
+      } ? xstate1112.ConditionalRequired<[options?: ({
         id?: T_1["id"] | undefined;
         systemId?: string;
-        input?: xstate978.InputFrom<T_1["logic"]> | undefined;
+        input?: xstate1112.InputFrom<T_1["logic"]> | undefined;
         syncSnapshot?: boolean;
-      } & { [K_1 in xstate978.RequiredActorOptions<T_1>]: unknown }) | undefined], xstate978.IsNotNever<xstate978.RequiredActorOptions<T_1>>> : never : never : never) | ({
-        src: "signDocuments";
-        logic: xstate978.PromiseActorLogic<SignedDocument[], {
-          documents: ElectronicSignatureDocument[];
-          variant: ElectronicSignatureVariant;
-        }, xstate978.EventObject>;
+      } & { [K_1 in xstate1112.RequiredActorOptions<T_1>]: unknown }) | undefined], xstate1112.IsNotNever<xstate1112.RequiredActorOptions<T_1>>> : never : never : never) | ({
+        src: "generateUploadUrl";
+        logic: xstate1112.PromiseActorLogic<{
+          preSignedUrl: string;
+        }, void, xstate1112.EventObject>;
         id: string | undefined;
       } extends infer T_2 ? T_2 extends {
-        src: "signDocuments";
-        logic: xstate978.PromiseActorLogic<SignedDocument[], {
-          documents: ElectronicSignatureDocument[];
-          variant: ElectronicSignatureVariant;
-        }, xstate978.EventObject>;
+        src: "generateUploadUrl";
+        logic: xstate1112.PromiseActorLogic<{
+          preSignedUrl: string;
+        }, void, xstate1112.EventObject>;
         id: string | undefined;
       } ? T_2 extends {
         src: TSrc;
-      } ? xstate978.ConditionalRequired<[options?: ({
+      } ? xstate1112.ConditionalRequired<[options?: ({
         id?: T_2["id"] | undefined;
         systemId?: string;
-        input?: xstate978.InputFrom<T_2["logic"]> | undefined;
+        input?: xstate1112.InputFrom<T_2["logic"]> | undefined;
         syncSnapshot?: boolean;
-      } & { [K_2 in xstate978.RequiredActorOptions<T_2>]: unknown }) | undefined], xstate978.IsNotNever<xstate978.RequiredActorOptions<T_2>>> : never : never : never)): xstate978.ActorRefFromLogic<xstate978.GetConcreteByKey<xstate978.Values<{
-        uploadDocument: {
-          src: "uploadDocument";
-          logic: xstate978.PromiseActorLogic<void, {
-            getFileData: () => ArrayBuffer | null;
-          }, xstate978.EventObject>;
-          id: string | undefined;
-        };
+      } & { [K_2 in xstate1112.RequiredActorOptions<T_2>]: unknown }) | undefined], xstate1112.IsNotNever<xstate1112.RequiredActorOptions<T_2>>> : never : never : never) | ({
+        src: "uploadFile";
+        logic: xstate1112.PromiseActorLogic<void, {
+          preSignedUrl: string;
+          getFileData: () => ArrayBuffer | null;
+        }, xstate1112.EventObject>;
+        id: string | undefined;
+      } extends infer T_3 ? T_3 extends {
+        src: "uploadFile";
+        logic: xstate1112.PromiseActorLogic<void, {
+          preSignedUrl: string;
+          getFileData: () => ArrayBuffer | null;
+        }, xstate1112.EventObject>;
+        id: string | undefined;
+      } ? T_3 extends {
+        src: TSrc;
+      } ? xstate1112.ConditionalRequired<[options?: ({
+        id?: T_3["id"] | undefined;
+        systemId?: string;
+        input?: xstate1112.InputFrom<T_3["logic"]> | undefined;
+        syncSnapshot?: boolean;
+      } & { [K_3 in xstate1112.RequiredActorOptions<T_3>]: unknown }) | undefined], xstate1112.IsNotNever<xstate1112.RequiredActorOptions<T_3>>> : never : never : never)): xstate1112.ActorRefFromLogic<xstate1112.GetConcreteByKey<xstate1112.Values<{
         fetchUnsignedDocs: {
           src: "fetchUnsignedDocs";
-          logic: xstate978.PromiseActorLogic<UnsignedDocsResponse, void, xstate978.EventObject>;
+          logic: xstate1112.PromiseActorLogic<UnsignedDocsResponse, void, xstate1112.EventObject>;
           id: string | undefined;
         };
         signDocuments: {
           src: "signDocuments";
-          logic: xstate978.PromiseActorLogic<SignedDocument[], {
+          logic: xstate1112.PromiseActorLogic<SignedDocument[], {
             documents: ElectronicSignatureDocument[];
             variant: ElectronicSignatureVariant;
-          }, xstate978.EventObject>;
+          }, xstate1112.EventObject>;
+          id: string | undefined;
+        };
+        generateUploadUrl: {
+          src: "generateUploadUrl";
+          logic: xstate1112.PromiseActorLogic<{
+            preSignedUrl: string;
+          }, void, xstate1112.EventObject>;
+          id: string | undefined;
+        };
+        uploadFile: {
+          src: "uploadFile";
+          logic: xstate1112.PromiseActorLogic<void, {
+            preSignedUrl: string;
+            getFileData: () => ArrayBuffer | null;
+          }, xstate1112.EventObject>;
           id: string | undefined;
         };
       }>, "src", TSrc>["logic"]>;
-      <TLogic extends xstate978.AnyActorLogic>(src: TLogic, ...[options]: xstate978.ConditionalRequired<[options?: ({
+      <TLogic extends xstate1112.AnyActorLogic>(src: TLogic, ...[options]: xstate1112.ConditionalRequired<[options?: ({
         id?: never;
         systemId?: string;
-        input?: xstate978.InputFrom<TLogic> | undefined;
+        input?: xstate1112.InputFrom<TLogic> | undefined;
         syncSnapshot?: boolean;
-      } & { [K in xstate978.RequiredLogicInput<TLogic>]: unknown }) | undefined], xstate978.IsNotNever<xstate978.RequiredLogicInput<TLogic>>>): xstate978.ActorRefFromLogic<TLogic>;
+      } & { [K in xstate1112.RequiredLogicInput<TLogic>]: unknown }) | undefined], xstate1112.IsNotNever<xstate1112.RequiredLogicInput<TLogic>>>): xstate1112.ActorRefFromLogic<TLogic>;
     };
     input: ElectronicSignatureInput;
-    self: xstate978.ActorRef<xstate978.MachineSnapshot<ElectronicSignatureContext, {
+    self: xstate1112.ActorRef<xstate1112.MachineSnapshot<ElectronicSignatureContext, {
       type: "LOAD";
     } | {
       type: "SELECT_FILE";
@@ -281,7 +337,7 @@ declare const electronicSignatureMachine: xstate978.StateMachine<ElectronicSigna
       type: "RETRY";
     } | {
       type: "CLOSE";
-    }, Record<string, xstate978.AnyActorRef | undefined>, xstate978.StateValue, string, unknown, any, any>, {
+    }, Record<string, xstate1112.AnyActorRef | undefined>, xstate1112.StateValue, string, unknown, any, any>, {
       type: "LOAD";
     } | {
       type: "SELECT_FILE";
@@ -309,7 +365,7 @@ declare const electronicSignatureMachine: xstate978.StateMachine<ElectronicSigna
       type: "RETRY";
     } | {
       type: "CLOSE";
-    }, xstate978.AnyEventObject>;
+    }, xstate1112.AnyEventObject>;
   }) => {
     config: ElectronicSignatureConfig;
     getFileData: () => ArrayBuffer | null;
@@ -318,6 +374,7 @@ declare const electronicSignatureMachine: xstate978.StateMachine<ElectronicSigna
     fileName: null;
     fileSize: null;
     fileUrl: null;
+    preSignedUrl: null;
     consentChecks: Partial<Record<ConsentKey, boolean>>;
     viewingDocumentUrl: null;
     errorMessage: string;
@@ -349,7 +406,7 @@ declare const electronicSignatureMachine: xstate978.StateMachine<ElectronicSigna
       readonly on: {
         readonly REPLACE_FILE: {
           readonly target: "uploading";
-          readonly actions: xstate978.ActionFunction<ElectronicSignatureContext, {
+          readonly actions: xstate1112.ActionFunction<ElectronicSignatureContext, {
             type: "REPLACE_FILE";
           }, {
             type: "LOAD";
@@ -379,41 +436,123 @@ declare const electronicSignatureMachine: xstate978.StateMachine<ElectronicSigna
             type: "RETRY";
           } | {
             type: "CLOSE";
-          }, undefined, xstate978.Values<{
-            uploadDocument: {
-              src: "uploadDocument";
-              logic: xstate978.PromiseActorLogic<void, {
-                getFileData: () => ArrayBuffer | null;
-              }, xstate978.EventObject>;
-              id: string | undefined;
-            };
+          }, undefined, xstate1112.Values<{
             fetchUnsignedDocs: {
               src: "fetchUnsignedDocs";
-              logic: xstate978.PromiseActorLogic<UnsignedDocsResponse, void, xstate978.EventObject>;
+              logic: xstate1112.PromiseActorLogic<UnsignedDocsResponse, void, xstate1112.EventObject>;
               id: string | undefined;
             };
             signDocuments: {
               src: "signDocuments";
-              logic: xstate978.PromiseActorLogic<SignedDocument[], {
+              logic: xstate1112.PromiseActorLogic<SignedDocument[], {
                 documents: ElectronicSignatureDocument[];
                 variant: ElectronicSignatureVariant;
-              }, xstate978.EventObject>;
+              }, xstate1112.EventObject>;
+              id: string | undefined;
+            };
+            generateUploadUrl: {
+              src: "generateUploadUrl";
+              logic: xstate1112.PromiseActorLogic<{
+                preSignedUrl: string;
+              }, void, xstate1112.EventObject>;
+              id: string | undefined;
+            };
+            uploadFile: {
+              src: "uploadFile";
+              logic: xstate1112.PromiseActorLogic<void, {
+                preSignedUrl: string;
+                getFileData: () => ArrayBuffer | null;
+              }, xstate1112.EventObject>;
               id: string | undefined;
             };
           }>, never, never, never, never>;
         };
-        readonly CONFIRM_FILE: {
+        readonly CONFIRM_FILE: readonly [{
           readonly target: "uploadingFile";
-        };
+          readonly guard: "hasUploadUrl";
+        }, {
+          readonly target: "generatingUploadUrl";
+        }];
         readonly CLOSE: {
           readonly target: "closed";
         };
       };
     };
+    readonly generatingUploadUrl: {
+      readonly invoke: {
+        readonly id: "generateUploadUrl";
+        readonly src: "generateUploadUrl";
+        readonly onDone: {
+          readonly target: "uploadingFile";
+          readonly actions: "setUploadUrl";
+        };
+        readonly onError: {
+          readonly target: "error";
+          readonly actions: xstate1112.ActionFunction<ElectronicSignatureContext, xstate1112.ErrorActorEvent<unknown, string>, {
+            type: "LOAD";
+          } | {
+            type: "SELECT_FILE";
+            fileName: string;
+            fileSize: number;
+            fileUrl: string;
+          } | {
+            type: "REPLACE_FILE";
+          } | {
+            type: "CONFIRM_FILE";
+          } | {
+            type: "SET_CONSENT";
+            name: ConsentKey;
+            checked: boolean;
+          } | {
+            type: "VIEW_DOCUMENT";
+            url: string;
+          } | {
+            type: "CLOSE_DOCUMENT_VIEW";
+          } | {
+            type: "SIGN";
+          } | {
+            type: "FINISH";
+          } | {
+            type: "RETRY";
+          } | {
+            type: "CLOSE";
+          }, undefined, xstate1112.Values<{
+            fetchUnsignedDocs: {
+              src: "fetchUnsignedDocs";
+              logic: xstate1112.PromiseActorLogic<UnsignedDocsResponse, void, xstate1112.EventObject>;
+              id: string | undefined;
+            };
+            signDocuments: {
+              src: "signDocuments";
+              logic: xstate1112.PromiseActorLogic<SignedDocument[], {
+                documents: ElectronicSignatureDocument[];
+                variant: ElectronicSignatureVariant;
+              }, xstate1112.EventObject>;
+              id: string | undefined;
+            };
+            generateUploadUrl: {
+              src: "generateUploadUrl";
+              logic: xstate1112.PromiseActorLogic<{
+                preSignedUrl: string;
+              }, void, xstate1112.EventObject>;
+              id: string | undefined;
+            };
+            uploadFile: {
+              src: "uploadFile";
+              logic: xstate1112.PromiseActorLogic<void, {
+                preSignedUrl: string;
+                getFileData: () => ArrayBuffer | null;
+              }, xstate1112.EventObject>;
+              id: string | undefined;
+            };
+          }>, never, never, never, never>;
+        };
+      };
+    };
     readonly uploadingFile: {
       readonly invoke: {
-        readonly id: "uploadDocument";
-        readonly src: "uploadDocument";
+        readonly id: "uploadFile";
+        readonly src: "uploadFile";
         readonly input: ({
           context
         }: {
@@ -447,7 +586,7 @@ declare const electronicSignatureMachine: xstate978.StateMachine<ElectronicSigna
           } | {
             type: "CLOSE";
           };
-          self: xstate978.ActorRef<xstate978.MachineSnapshot<ElectronicSignatureContext, {
+          self: xstate1112.ActorRef<xstate1112.MachineSnapshot<ElectronicSignatureContext, {
             type: "LOAD";
           } | {
             type: "SELECT_FILE";
@@ -475,7 +614,7 @@ declare const electronicSignatureMachine: xstate978.StateMachine<ElectronicSigna
             type: "RETRY";
           } | {
             type: "CLOSE";
-          }, Record<string, xstate978.AnyActorRef>, xstate978.StateValue, string, unknown, any, any>, {
+          }, Record<string, xstate1112.AnyActorRef>, xstate1112.StateValue, string, unknown, any, any>, {
             type: "LOAD";
           } | {
             type: "SELECT_FILE";
@@ -503,8 +642,9 @@ declare const electronicSignatureMachine: xstate978.StateMachine<ElectronicSigna
             type: "RETRY";
           } | {
             type: "CLOSE";
-          }, xstate978.AnyEventObject>;
+          }, xstate1112.AnyEventObject>;
         }) => {
+          preSignedUrl: string;
           getFileData: () => ArrayBuffer | null;
         };
         readonly onDone: {
@@ -512,7 +652,7 @@ declare const electronicSignatureMachine: xstate978.StateMachine<ElectronicSigna
         };
         readonly onError: {
           readonly target: "error";
-          readonly actions: xstate978.ActionFunction<ElectronicSignatureContext, xstate978.ErrorActorEvent<unknown, string>, {
+          readonly actions: xstate1112.ActionFunction<ElectronicSignatureContext, xstate1112.ErrorActorEvent<unknown, string>, {
             type: "LOAD";
           } | {
             type: "SELECT_FILE";
@@ -540,25 +680,33 @@ declare const electronicSignatureMachine: xstate978.StateMachine<ElectronicSigna
             type: "RETRY";
           } | {
             type: "CLOSE";
-          }, undefined, xstate978.Values<{
-            uploadDocument: {
-              src: "uploadDocument";
-              logic: xstate978.PromiseActorLogic<void, {
-                getFileData: () => ArrayBuffer | null;
-              }, xstate978.EventObject>;
-              id: string | undefined;
-            };
+          }, undefined, xstate1112.Values<{
             fetchUnsignedDocs: {
               src: "fetchUnsignedDocs";
-              logic: xstate978.PromiseActorLogic<UnsignedDocsResponse, void, xstate978.EventObject>;
+              logic: xstate1112.PromiseActorLogic<UnsignedDocsResponse, void, xstate1112.EventObject>;
               id: string | undefined;
             };
             signDocuments: {
               src: "signDocuments";
-              logic: xstate978.PromiseActorLogic<SignedDocument[], {
+              logic: xstate1112.PromiseActorLogic<SignedDocument[], {
                 documents: ElectronicSignatureDocument[];
                 variant: ElectronicSignatureVariant;
-              }, xstate978.EventObject>;
+              }, xstate1112.EventObject>;
+              id: string | undefined;
+            };
+            generateUploadUrl: {
+              src: "generateUploadUrl";
+              logic: xstate1112.PromiseActorLogic<{
+                preSignedUrl: string;
+              }, void, xstate1112.EventObject>;
+              id: string | undefined;
+            };
+            uploadFile: {
+              src: "uploadFile";
+              logic: xstate1112.PromiseActorLogic<void, {
+                preSignedUrl: string;
+                getFileData: () => ArrayBuffer | null;
+              }, xstate1112.EventObject>;
               id: string | undefined;
             };
           }>, never, never, never, never>;
@@ -575,7 +723,7 @@ declare const electronicSignatureMachine: xstate978.StateMachine<ElectronicSigna
           readonly actions: "setDocuments";
         }, {
           readonly target: "error";
-          readonly actions: xstate978.ActionFunction<ElectronicSignatureContext, xstate978.DoneActorEvent<UnsignedDocsResponse, string>, {
+          readonly actions: xstate1112.ActionFunction<ElectronicSignatureContext, xstate1112.DoneActorEvent<UnsignedDocsResponse, string>, {
             type: "LOAD";
           } | {
             type: "SELECT_FILE";
@@ -603,32 +751,40 @@ declare const electronicSignatureMachine: xstate978.StateMachine<ElectronicSigna
             type: "RETRY";
           } | {
             type: "CLOSE";
-          }, undefined, xstate978.Values<{
-            uploadDocument: {
-              src: "uploadDocument";
-              logic: xstate978.PromiseActorLogic<void, {
-                getFileData: () => ArrayBuffer | null;
-              }, xstate978.EventObject>;
-              id: string | undefined;
-            };
+          }, undefined, xstate1112.Values<{
             fetchUnsignedDocs: {
               src: "fetchUnsignedDocs";
-              logic: xstate978.PromiseActorLogic<UnsignedDocsResponse, void, xstate978.EventObject>;
+              logic: xstate1112.PromiseActorLogic<UnsignedDocsResponse, void, xstate1112.EventObject>;
               id: string | undefined;
             };
             signDocuments: {
               src: "signDocuments";
-              logic: xstate978.PromiseActorLogic<SignedDocument[], {
+              logic: xstate1112.PromiseActorLogic<SignedDocument[], {
                 documents: ElectronicSignatureDocument[];
                 variant: ElectronicSignatureVariant;
-              }, xstate978.EventObject>;
+              }, xstate1112.EventObject>;
+              id: string | undefined;
+            };
+            generateUploadUrl: {
+              src: "generateUploadUrl";
+              logic: xstate1112.PromiseActorLogic<{
+                preSignedUrl: string;
+              }, void, xstate1112.EventObject>;
+              id: string | undefined;
+            };
+            uploadFile: {
+              src: "uploadFile";
+              logic: xstate1112.PromiseActorLogic<void, {
+                preSignedUrl: string;
+                getFileData: () => ArrayBuffer | null;
+              }, xstate1112.EventObject>;
               id: string | undefined;
             };
           }>, never, never, never, never>;
         }];
         readonly onError: {
           readonly target: "error";
-          readonly actions: xstate978.ActionFunction<ElectronicSignatureContext, xstate978.ErrorActorEvent<unknown, string>, {
+          readonly actions: xstate1112.ActionFunction<ElectronicSignatureContext, xstate1112.ErrorActorEvent<unknown, string>, {
             type: "LOAD";
           } | {
             type: "SELECT_FILE";
@@ -656,25 +812,33 @@ declare const electronicSignatureMachine: xstate978.StateMachine<ElectronicSigna
             type: "RETRY";
           } | {
             type: "CLOSE";
-          }, undefined, xstate978.Values<{
-            uploadDocument: {
-              src: "uploadDocument";
-              logic: xstate978.PromiseActorLogic<void, {
-                getFileData: () => ArrayBuffer | null;
-              }, xstate978.EventObject>;
-              id: string | undefined;
-            };
+          }, undefined, xstate1112.Values<{
             fetchUnsignedDocs: {
               src: "fetchUnsignedDocs";
-              logic: xstate978.PromiseActorLogic<UnsignedDocsResponse, void, xstate978.EventObject>;
+              logic: xstate1112.PromiseActorLogic<UnsignedDocsResponse, void, xstate1112.EventObject>;
               id: string | undefined;
             };
             signDocuments: {
               src: "signDocuments";
-              logic: xstate978.PromiseActorLogic<SignedDocument[], {
+              logic: xstate1112.PromiseActorLogic<SignedDocument[], {
                 documents: ElectronicSignatureDocument[];
                 variant: ElectronicSignatureVariant;
-              }, xstate978.EventObject>;
+              }, xstate1112.EventObject>;
+              id: string | undefined;
+            };
+            generateUploadUrl: {
+              src: "generateUploadUrl";
+              logic: xstate1112.PromiseActorLogic<{
+                preSignedUrl: string;
+              }, void, xstate1112.EventObject>;
+              id: string | undefined;
+            };
+            uploadFile: {
+              src: "uploadFile";
+              logic: xstate1112.PromiseActorLogic<void, {
+                preSignedUrl: string;
+                getFileData: () => ArrayBuffer | null;
+              }, xstate1112.EventObject>;
               id: string | undefined;
             };
           }>, never, never, never, never>;
@@ -738,7 +902,7 @@ declare const electronicSignatureMachine: xstate978.StateMachine<ElectronicSigna
           } | {
             type: "CLOSE";
           };
-          self: xstate978.ActorRef<xstate978.MachineSnapshot<ElectronicSignatureContext, {
+          self: xstate1112.ActorRef<xstate1112.MachineSnapshot<ElectronicSignatureContext, {
             type: "LOAD";
           } | {
             type: "SELECT_FILE";
@@ -766,7 +930,7 @@ declare const electronicSignatureMachine: xstate978.StateMachine<ElectronicSigna
             type: "RETRY";
           } | {
             type: "CLOSE";
-          }, Record<string, xstate978.AnyActorRef>, xstate978.StateValue, string, unknown, any, any>, {
+          }, Record<string, xstate1112.AnyActorRef>, xstate1112.StateValue, string, unknown, any, any>, {
             type: "LOAD";
           } | {
             type: "SELECT_FILE";
@@ -794,7 +958,7 @@ declare const electronicSignatureMachine: xstate978.StateMachine<ElectronicSigna
             type: "RETRY";
           } | {
             type: "CLOSE";
-          }, xstate978.AnyEventObject>;
+          }, xstate1112.AnyEventObject>;
         }) => {
           documents: ElectronicSignatureDocument[];
           variant: ElectronicSignatureVariant;
@@ -809,7 +973,7 @@ declare const electronicSignatureMachine: xstate978.StateMachine<ElectronicSigna
           readonly actions: "setSignedDocuments";
         }, {
           readonly target: "error";
-          readonly actions: xstate978.ActionFunction<ElectronicSignatureContext, xstate978.DoneActorEvent<SignedDocument[], string>, {
+          readonly actions: xstate1112.ActionFunction<ElectronicSignatureContext, xstate1112.DoneActorEvent<SignedDocument[], string>, {
             type: "LOAD";
           } | {
             type: "SELECT_FILE";
@@ -837,32 +1001,41 @@ declare const electronicSignatureMachine: xstate978.StateMachine<ElectronicSigna
             type: "RETRY";
           } | {
             type: "CLOSE";
-          }, undefined, xstate978.Values<{
-            uploadDocument: {
-              src: "uploadDocument";
-              logic: xstate978.PromiseActorLogic<void, {
-                getFileData: () => ArrayBuffer | null;
-              }, xstate978.EventObject>;
-              id: string | undefined;
-            };
+          }, undefined, xstate1112.Values<{
             fetchUnsignedDocs: {
               src: "fetchUnsignedDocs";
-              logic: xstate978.PromiseActorLogic<UnsignedDocsResponse, void, xstate978.EventObject>;
+              logic: xstate1112.PromiseActorLogic<UnsignedDocsResponse, void, xstate1112.EventObject>;
               id: string | undefined;
             };
             signDocuments: {
               src: "signDocuments";
-              logic: xstate978.PromiseActorLogic<SignedDocument[], {
+              logic: xstate1112.PromiseActorLogic<SignedDocument[], {
                 documents: ElectronicSignatureDocument[];
                 variant: ElectronicSignatureVariant;
-              }, xstate978.EventObject>;
+              }, xstate1112.EventObject>;
+              id: string | undefined;
+            };
+            generateUploadUrl: {
+              src: "generateUploadUrl";
+              logic: xstate1112.PromiseActorLogic<{
+                preSignedUrl: string;
+              }, void, xstate1112.EventObject>;
+              id: string | undefined;
+            };
+            uploadFile: {
+              src: "uploadFile";
+              logic: xstate1112.PromiseActorLogic<void, {
+                preSignedUrl: string;
+                getFileData: () => ArrayBuffer | null;
+              }, xstate1112.EventObject>;
               id: string | undefined;
             };
           }>, never, never, never, never>;
         }];
-        readonly onError: {
+        readonly onError: readonly [{
           readonly target: "error";
-          readonly actions: xstate978.ActionFunction<ElectronicSignatureContext, xstate978.ErrorActorEvent<unknown, string>, {
+          readonly guard: "isRetryableSignError";
+          readonly actions: xstate1112.ActionFunction<ElectronicSignatureContext, xstate1112.ErrorActorEvent<unknown, string>, {
             type: "LOAD";
           } | {
             type: "SELECT_FILE";
@@ -890,29 +1063,97 @@ declare const electronicSignatureMachine: xstate978.StateMachine<ElectronicSigna
             type: "RETRY";
           } | {
             type: "CLOSE";
-          }, undefined, xstate978.Values<{
-            uploadDocument: {
-              src: "uploadDocument";
-              logic: xstate978.PromiseActorLogic<void, {
+          }, undefined, xstate1112.Values<{
+            fetchUnsignedDocs: {
+              src: "fetchUnsignedDocs";
+              logic: xstate1112.PromiseActorLogic<UnsignedDocsResponse, void, xstate1112.EventObject>;
+              id: string | undefined;
+            };
+            signDocuments: {
+              src: "signDocuments";
+              logic: xstate1112.PromiseActorLogic<SignedDocument[], {
+                documents: ElectronicSignatureDocument[];
+                variant: ElectronicSignatureVariant;
+              }, xstate1112.EventObject>;
+              id: string | undefined;
+            };
+            generateUploadUrl: {
+              src: "generateUploadUrl";
+              logic: xstate1112.PromiseActorLogic<{
+                preSignedUrl: string;
+              }, void, xstate1112.EventObject>;
+              id: string | undefined;
+            };
+            uploadFile: {
+              src: "uploadFile";
+              logic: xstate1112.PromiseActorLogic<void, {
+                preSignedUrl: string;
                 getFileData: () => ArrayBuffer | null;
-              }, xstate978.EventObject>;
+              }, xstate1112.EventObject>;
               id: string | undefined;
             };
+          }>, never, never, never, never>;
+        }, {
+          readonly target: "failed";
+          readonly actions: xstate1112.ActionFunction<ElectronicSignatureContext, xstate1112.ErrorActorEvent<unknown, string>, {
+            type: "LOAD";
+          } | {
+            type: "SELECT_FILE";
+            fileName: string;
+            fileSize: number;
+            fileUrl: string;
+          } | {
+            type: "REPLACE_FILE";
+          } | {
+            type: "CONFIRM_FILE";
+          } | {
+            type: "SET_CONSENT";
+            name: ConsentKey;
+            checked: boolean;
+          } | {
+            type: "VIEW_DOCUMENT";
+            url: string;
+          } | {
+            type: "CLOSE_DOCUMENT_VIEW";
+          } | {
+            type: "SIGN";
+          } | {
+            type: "FINISH";
+          } | {
+            type: "RETRY";
+          } | {
+            type: "CLOSE";
+          }, undefined, xstate1112.Values<{
             fetchUnsignedDocs: {
               src: "fetchUnsignedDocs";
-              logic: xstate978.PromiseActorLogic<UnsignedDocsResponse, void, xstate978.EventObject>;
+              logic: xstate1112.PromiseActorLogic<UnsignedDocsResponse, void, xstate1112.EventObject>;
               id: string | undefined;
             };
             signDocuments: {
               src: "signDocuments";
-              logic: xstate978.PromiseActorLogic<SignedDocument[], {
+              logic: xstate1112.PromiseActorLogic<SignedDocument[], {
                 documents: ElectronicSignatureDocument[];
                 variant: ElectronicSignatureVariant;
-              }, xstate978.EventObject>;
+              }, xstate1112.EventObject>;
+              id: string | undefined;
+            };
+            generateUploadUrl: {
+              src: "generateUploadUrl";
+              logic: xstate1112.PromiseActorLogic<{
+                preSignedUrl: string;
+              }, void, xstate1112.EventObject>;
+              id: string | undefined;
+            };
+            uploadFile: {
+              src: "uploadFile";
+              logic: xstate1112.PromiseActorLogic<void, {
+                preSignedUrl: string;
+                getFileData: () => ArrayBuffer | null;
+              }, xstate1112.EventObject>;
               id: string | undefined;
             };
           }>, never, never, never, never>;
-        };
+        }];
       };
     };
     readonly success: {
@@ -935,7 +1176,7 @@ declare const electronicSignatureMachine: xstate978.StateMachine<ElectronicSigna
         readonly RETRY: readonly [{
           readonly target: "uploading";
           readonly guard: "errorFromUpload";
-          readonly actions: xstate978.ActionFunction<ElectronicSignatureContext, {
+          readonly actions: xstate1112.ActionFunction<ElectronicSignatureContext, {
             type: "RETRY";
           }, {
             type: "LOAD";
@@ -965,32 +1206,40 @@ declare const electronicSignatureMachine: xstate978.StateMachine<ElectronicSigna
             type: "RETRY";
           } | {
             type: "CLOSE";
-          }, undefined, xstate978.Values<{
-            uploadDocument: {
-              src: "uploadDocument";
-              logic: xstate978.PromiseActorLogic<void, {
-                getFileData: () => ArrayBuffer | null;
-              }, xstate978.EventObject>;
-              id: string | undefined;
-            };
+          }, undefined, xstate1112.Values<{
             fetchUnsignedDocs: {
               src: "fetchUnsignedDocs";
-              logic: xstate978.PromiseActorLogic<UnsignedDocsResponse, void, xstate978.EventObject>;
+              logic: xstate1112.PromiseActorLogic<UnsignedDocsResponse, void, xstate1112.EventObject>;
               id: string | undefined;
             };
             signDocuments: {
               src: "signDocuments";
-              logic: xstate978.PromiseActorLogic<SignedDocument[], {
+              logic: xstate1112.PromiseActorLogic<SignedDocument[], {
                 documents: ElectronicSignatureDocument[];
                 variant: ElectronicSignatureVariant;
-              }, xstate978.EventObject>;
+              }, xstate1112.EventObject>;
+              id: string | undefined;
+            };
+            generateUploadUrl: {
+              src: "generateUploadUrl";
+              logic: xstate1112.PromiseActorLogic<{
+                preSignedUrl: string;
+              }, void, xstate1112.EventObject>;
+              id: string | undefined;
+            };
+            uploadFile: {
+              src: "uploadFile";
+              logic: xstate1112.PromiseActorLogic<void, {
+                preSignedUrl: string;
+                getFileData: () => ArrayBuffer | null;
+              }, xstate1112.EventObject>;
               id: string | undefined;
             };
           }>, never, never, never, never>;
         }, {
           readonly target: "signing";
           readonly guard: "errorFromSigning";
-          readonly actions: xstate978.ActionFunction<ElectronicSignatureContext, {
+          readonly actions: xstate1112.ActionFunction<ElectronicSignatureContext, {
             type: "RETRY";
           }, {
             type: "LOAD";
@@ -1020,31 +1269,39 @@ declare const electronicSignatureMachine: xstate978.StateMachine<ElectronicSigna
             type: "RETRY";
           } | {
             type: "CLOSE";
-          }, undefined, xstate978.Values<{
-            uploadDocument: {
-              src: "uploadDocument";
-              logic: xstate978.PromiseActorLogic<void, {
-                getFileData: () => ArrayBuffer | null;
-              }, xstate978.EventObject>;
-              id: string | undefined;
-            };
+          }, undefined, xstate1112.Values<{
             fetchUnsignedDocs: {
               src: "fetchUnsignedDocs";
-              logic: xstate978.PromiseActorLogic<UnsignedDocsResponse, void, xstate978.EventObject>;
+              logic: xstate1112.PromiseActorLogic<UnsignedDocsResponse, void, xstate1112.EventObject>;
               id: string | undefined;
             };
             signDocuments: {
               src: "signDocuments";
-              logic: xstate978.PromiseActorLogic<SignedDocument[], {
+              logic: xstate1112.PromiseActorLogic<SignedDocument[], {
                 documents: ElectronicSignatureDocument[];
                 variant: ElectronicSignatureVariant;
-              }, xstate978.EventObject>;
+              }, xstate1112.EventObject>;
+              id: string | undefined;
+            };
+            generateUploadUrl: {
+              src: "generateUploadUrl";
+              logic: xstate1112.PromiseActorLogic<{
+                preSignedUrl: string;
+              }, void, xstate1112.EventObject>;
+              id: string | undefined;
+            };
+            uploadFile: {
+              src: "uploadFile";
+              logic: xstate1112.PromiseActorLogic<void, {
+                preSignedUrl: string;
+                getFileData: () => ArrayBuffer | null;
+              }, xstate1112.EventObject>;
               id: string | undefined;
             };
           }>, never, never, never, never>;
         }, {
           readonly target: "fetchingDocs";
-          readonly actions: xstate978.ActionFunction<ElectronicSignatureContext, {
+          readonly actions: xstate1112.ActionFunction<ElectronicSignatureContext, {
             type: "RETRY";
           }, {
             type: "LOAD";
@@ -1074,25 +1331,33 @@ declare const electronicSignatureMachine: xstate978.StateMachine<ElectronicSigna
             type: "RETRY";
           } | {
             type: "CLOSE";
-          }, undefined, xstate978.Values<{
-            uploadDocument: {
-              src: "uploadDocument";
-              logic: xstate978.PromiseActorLogic<void, {
-                getFileData: () => ArrayBuffer | null;
-              }, xstate978.EventObject>;
-              id: string | undefined;
-            };
+          }, undefined, xstate1112.Values<{
             fetchUnsignedDocs: {
               src: "fetchUnsignedDocs";
-              logic: xstate978.PromiseActorLogic<UnsignedDocsResponse, void, xstate978.EventObject>;
+              logic: xstate1112.PromiseActorLogic<UnsignedDocsResponse, void, xstate1112.EventObject>;
               id: string | undefined;
             };
             signDocuments: {
               src: "signDocuments";
-              logic: xstate978.PromiseActorLogic<SignedDocument[], {
+              logic: xstate1112.PromiseActorLogic<SignedDocument[], {
                 documents: ElectronicSignatureDocument[];
                 variant: ElectronicSignatureVariant;
-              }, xstate978.EventObject>;
+              }, xstate1112.EventObject>;
+              id: string | undefined;
+            };
+            generateUploadUrl: {
+              src: "generateUploadUrl";
+              logic: xstate1112.PromiseActorLogic<{
+                preSignedUrl: string;
+              }, void, xstate1112.EventObject>;
+              id: string | undefined;
+            };
+            uploadFile: {
+              src: "uploadFile";
+              logic: xstate1112.PromiseActorLogic<void, {
+                preSignedUrl: string;
+                getFileData: () => ArrayBuffer | null;
+              }, xstate1112.EventObject>;
               id: string | undefined;
             };
           }>, never, never, never, never>;
@@ -1108,6 +1373,9 @@ declare const electronicSignatureMachine: xstate978.StateMachine<ElectronicSigna
     readonly closed: {
       readonly type: "final";
     };
+    readonly failed: {
+      readonly type: "final";
+    };
   };
 }>;
 //#endregion
@@ -1146,17 +1414,23 @@ type ElectronicSignatureSuccessState = {
   signedDocuments: SignedDocument[];
   downloadDocument: boolean;
 };
+/** Recoverable: SDK shows Try Again; `onError` does NOT fire. */
 type ElectronicSignatureErrorState = {
   status: 'error';
   errorMessage: string;
 };
+/** Terminal: SDK renders nothing; `onError` fires once and host takes over. */
+type ElectronicSignatureFailedState = {
+  status: 'failed';
+  errorMessage: string;
+};
 type ElectronicSignatureFinishedState = {
   status: 'finished';
 };
 type ElectronicSignatureClosedState = {
   status: 'closed';
 };
-type ElectronicSignatureState = ElectronicSignatureLoadingState | ElectronicSignatureUploadingState | ElectronicSignatureReviewingState | ElectronicSignatureSigningState | ElectronicSignatureProcessingState | ElectronicSignatureSuccessState | ElectronicSignatureErrorState | ElectronicSignatureFinishedState | ElectronicSignatureClosedState;
+type ElectronicSignatureState = ElectronicSignatureLoadingState | ElectronicSignatureUploadingState | ElectronicSignatureReviewingState | ElectronicSignatureSigningState | ElectronicSignatureProcessingState | ElectronicSignatureSuccessState | ElectronicSignatureErrorState | ElectronicSignatureFailedState | ElectronicSignatureFinishedState | ElectronicSignatureClosedState;
 declare function createElectronicSignatureManager(options: {
   config: CreateElectronicSignatureActorOptions['config'];
 }): Manager<ElectronicSignatureState> & {