@incodetech/core 2.2.0 → 2.3.0-rc.1

package/dist/device.esm.js

@@ -1,7 +1,66 @@
-import { a as isIPad, c as isTabletWithoutAndroid } from "./platform-BJrm5nzZ.esm.js";
-import { t as getBrowser } from "./getBrowser-DNrQeL4T.esm.js";
+import { a as isIOS, f as isTabletWithoutAndroid, l as isIslandBrowser, n as isAndroidWebView, o as isIOSWebView, r as isBraveBrowser, s as isIPad } from "./platform-DkcRc9JV.esm.js";
+import { n as getUserAgentBrands, t as getUserAgent } from "./getBrowser-CBiibsL-.esm.js";
+import { t as getBrowser } from "./getBrowser-Cbe1C4Tn.esm.js";
 import { t as getDeviceInfo } from "./getDeviceClass-CeBiEayS.esm.js";
-import { t as getDeviceClass } from "./getDeviceClass-9y-kbVDw.esm.js";
+import { t as getDeviceClass } from "./getDeviceClass-5NYZg9s6.esm.js";
+//#region src/internal/device/browserSupportClassification.ts
+/**
+* Third-party in-app browsers. These are real WebViews — `isAndroidWebView` and
+* `isIOSWebView` both report them as such — but their hosts restrict camera
+* capture, so they are rejected before the WebView allowance below.
+*/
+const IN_APP_BROWSER_TOKEN = /\b(?:FBAN|FBAV|FB_IAB|FB4A|Instagram|LinkedInApp|Twitter|BytedanceWebview|musical_ly)(?:[/\s;\]_]|$)/i;
+/**
+* Client Hint brands for the Chromium builds that are supported. `Chromium`
+* covers vanilla and automation builds, which do not carry the Google Chrome
+* brand. Support is an allowlist: an unknown fork reports neither brand and is
+* rejected, rather than being supported until someone denylists it.
+*/
+const SUPPORTED_CHROMIUM_BRANDS = /* @__PURE__ */ new Set(["Google Chrome", "Chromium"]);
+/**
+* Forks that report a Chrome-compatible UA *and* claim a supported brand. A
+* second guard on top of the allowlist, not a substitute for it.
+*/
+const UNSUPPORTED_CHROMIUM_BRANDS = /* @__PURE__ */ new Set([
+	"Brave",
+	"Microsoft Edge",
+	"Opera"
+]);
+/** iOS/iPadOS/macOS — the only platforms where Safari is a supported option. */
+function isApplePlatform() {
+	const userAgent = getUserAgent();
+	return isIOS(userAgent) || /Mac OS/i.test(userAgent);
+}
+/**
+* Whether capture/WASM are known to work in the current browser.
+*
+* Native Android and iOS WebViews are supported; third-party in-app browsers
+* are not, on either platform. Outside a WebView, only Chrome is supported on
+* every platform and Safari is supported on Apple platforms.
+*
+* The rejections run first, because a browser that is unsupported on its own is
+* still unsupported when it hosts the page as a WebView (ENG-51674).
+*
+* Identity comes from the user agent, plus `navigator.brave`/`navigator.island`
+* and Client Hint brands where available. `navigator.island` is load-bearing:
+* Island can be configured (or itself strip) the "Island Browser" UA token and
+* still report Chrome-only Client Hint brands, so the UA and brands alone are
+* not sufficient (ENG-51674). A browser that spoofs a Chrome user agent, exposes
+* no Client Hints, and identifies itself nowhere else cannot be distinguished
+* here.
+*/
+function isSupportedBrowser() {
+	const userAgent = getUserAgent();
+	if (isBraveBrowser() || isIslandBrowser() || IN_APP_BROWSER_TOKEN.test(userAgent)) return false;
+	if (isAndroidWebView(userAgent) || isIOSWebView(userAgent)) return true;
+	const browser = getBrowser();
+	if (browser === "safari") return isApplePlatform();
+	if (browser !== "chrome") return false;
+	const brands = getUserAgentBrands();
+	if (brands === void 0) return true;
+	return brands.some((brand) => SUPPORTED_CHROMIUM_BRANDS.has(brand)) && !brands.some((brand) => UNSUPPORTED_CHROMIUM_BRANDS.has(brand));
+}
+//#endregion
 //#region src/internal/device/redirectDeviceClassification.ts
 /**
 * Conservative redirect-specific check. A mobile identity must also expose an
@@ -39,11 +98,14 @@ function createScreenOrientationObserver(provider, deviceClass) {
 //#region ../infra/src/providers/browser/ScreenOrientationProvider.ts
 function isPortrait() {
 	if (typeof window === "undefined" || typeof screen === "undefined") return true;
-	if (typeof window.matchMedia === "function") return !window.matchMedia("(orientation: landscape)").matches;
 	if (screen.orientation?.type?.includes("portrait")) return true;
-	if (screen.orientation?.type?.includes("landscape")) return false;
+	if (screen.orientation?.type?.includes("landscape")) return isViewportPortrait();
 	const orientation = window.orientation;
-	if (typeof orientation === "number") return Math.abs(orientation) === 0;
+	if (typeof orientation === "number") return Math.abs(orientation) === 0 || isViewportPortrait();
+	if (typeof window.matchMedia === "function") return !window.matchMedia("(orientation: landscape)").matches;
+	return isViewportPortrait();
+}
+function isViewportPortrait() {
 	return window.innerHeight >= window.innerWidth;
 }
 function toState(portrait) {
@@ -104,4 +166,4 @@ var ScreenOrientationProvider = class {
 	}
 };
 //#endregion
-export { ScreenOrientationProvider, createScreenOrientationObserver, getBrowser, getDeviceClass, isDesktopDeviceEmulation, isDesktopOrEmulated, isIPad };
+export { ScreenOrientationProvider, createScreenOrientationObserver, getBrowser, getDeviceClass, isApplePlatform, isDesktopDeviceEmulation, isDesktopOrEmulated, isIPad, isSupportedBrowser };

package/dist/document-capture.d.ts

@@ -1,3 +1,3 @@
-import { a as DocumentCaptureErrorCode, c as DocumentType, n as DOCUMENT_CAPTURE_ERROR_CODES, r as DocumentCaptureConfig, s as DocumentCaptureNextPageType } from "./types-DelMqZLe.js";
-import { a as DocumentCaptureActor, i as createDocumentCaptureManagerFromActor, n as DocumentCaptureState, o as documentCaptureMachine, r as createDocumentCaptureManager, t as DocumentCaptureManager } from "./documentCaptureManager-B3t0ydtg.js";
+import { a as DocumentCaptureErrorCode, c as DocumentType, n as DOCUMENT_CAPTURE_ERROR_CODES, r as DocumentCaptureConfig, s as DocumentCaptureNextPageType } from "./types-BjSly8cp.js";
+import { a as DocumentCaptureActor, i as createDocumentCaptureManagerFromActor, n as DocumentCaptureState, o as documentCaptureMachine, r as createDocumentCaptureManager, t as DocumentCaptureManager } from "./documentCaptureManager-DensIj5F.js";
 export { DOCUMENT_CAPTURE_ERROR_CODES, type DocumentCaptureActor, type DocumentCaptureConfig, type DocumentCaptureErrorCode, type DocumentCaptureManager, type DocumentCaptureNextPageType, type DocumentCaptureState, type DocumentType, createDocumentCaptureManager, createDocumentCaptureManagerFromActor, documentCaptureMachine };

package/dist/document-capture.esm.js

@@ -1,3 +1,3 @@
-import { n as DOCUMENT_CAPTURE_ERROR_CODES, t as documentCaptureMachine } from "./documentCaptureStateMachine-BM4Ex_5x.esm.js";
-import { n as createDocumentCaptureManagerFromActor, t as createDocumentCaptureManager } from "./documentCaptureManager-DsQQhWry.esm.js";
+import { n as DOCUMENT_CAPTURE_ERROR_CODES, t as documentCaptureMachine } from "./documentCaptureStateMachine-DfGOBapD.esm.js";
+import { n as createDocumentCaptureManagerFromActor, t as createDocumentCaptureManager } from "./documentCaptureManager-CwAiM9WY.esm.js";
 export { DOCUMENT_CAPTURE_ERROR_CODES, createDocumentCaptureManager, createDocumentCaptureManagerFromActor, documentCaptureMachine };

package/dist/{documentCaptureManager-DsQQhWry.esm.js → documentCaptureManager-CwAiM9WY.esm.js}

@@ -1,7 +1,7 @@
-import { n as eventModuleNames, o as createManagerInstrumentation } from "./events-DYiyoSlx.esm.js";
+import { n as eventModuleNames, o as createManagerInstrumentation } from "./events-ijlbX_Wx.esm.js";
 import { t as topLevelStateName } from "./topLevelStateName-B5i2avbh.esm.js";
 import { s as createActor, u as createManager } from "./xstate.esm-BuFLFuzz.esm.js";
-import { n as DOCUMENT_CAPTURE_ERROR_CODES, t as documentCaptureMachine } from "./documentCaptureStateMachine-BM4Ex_5x.esm.js";
+import { n as DOCUMENT_CAPTURE_ERROR_CODES, t as documentCaptureMachine } from "./documentCaptureStateMachine-DfGOBapD.esm.js";
 //#region src/modules/document-capture/documentCaptureActor.ts
 function createDocumentCaptureActor(options) {
 	return createActor(documentCaptureMachine, { input: { config: options.config } }).start();

package/dist/{documentCaptureManager-B3t0ydtg.d.ts → documentCaptureManager-DensIj5F.d.ts}

@@ -3,7 +3,7 @@ import "./StateMachine-EDpYWy0i.js";
 import { t as Manager } from "./Manager-CQQ99QOI.js";
 import "./Actor-iTq7YY48.js";
 import { n as PermissionStatus, t as PermissionResult } from "./types-BEwVKkLJ.js";
-import { a as DocumentCaptureErrorCode, c as DocumentType, i as DocumentCaptureContext, l as DocumentUploadResponse, o as DocumentCaptureInput, r as DocumentCaptureConfig, s as DocumentCaptureNextPageType, t as CapturedDocument, u as FinalizeDocumentResponse } from "./types-DelMqZLe.js";
+import { a as DocumentCaptureErrorCode, c as DocumentType, i as DocumentCaptureContext, l as DocumentUploadResponse, o as DocumentCaptureInput, r as DocumentCaptureConfig, s as DocumentCaptureNextPageType, t as CapturedDocument, u as FinalizeDocumentResponse } from "./types-BjSly8cp.js";
 //#region src/modules/document-capture/documentCaptureStateMachine.d.ts
 declare const documentCaptureMachine: StateMachine<DocumentCaptureContext, {
   type: "CAPTURE";
@@ -52,14 +52,14 @@ declare const documentCaptureMachine: StateMachine<DocumentCaptureContext, {
 } | {
   type: "CLOSE";
 }, {
-  [x: string]: ActorRefFromLogic<PromiseActorLogic<MediaStream, void, EventObject>> | ActorRefFromLogic<PromiseActorLogic<DocumentUploadResponse, {
+  [x: string]: ActorRefFromLogic<PromiseActorLogic<DocumentUploadResponse, {
     capturedDocument: NonNullable<DocumentCaptureContext["capturedDocument"]>;
     processingType: string;
     onProgress: (progress: number) => void;
   }, EventObject>> | ActorRefFromLogic<PromiseActorLogic<PermissionResult, {
     permissionResult?: PermissionResult;
     requestMotionPermission: boolean;
-  }, EventObject>> | ActorRefFromLogic<PromiseActorLogic<PermissionResult, void, EventObject>> | ActorRefFromLogic<PromiseActorLogic<FinalizeDocumentResponse, {
+  }, EventObject>> | ActorRefFromLogic<PromiseActorLogic<PermissionResult, void, EventObject>> | ActorRefFromLogic<PromiseActorLogic<MediaStream, void, EventObject>> | ActorRefFromLogic<PromiseActorLogic<FinalizeDocumentResponse, {
     processingType: string;
   }, EventObject>> | undefined;
 }, Values<{
@@ -72,11 +72,6 @@ declare const documentCaptureMachine: StateMachine<DocumentCaptureContext, {
     }, EventObject>;
     id: string | undefined;
   };
-  initCamera: {
-    src: "initCamera";
-    logic: PromiseActorLogic<MediaStream, void, EventObject>;
-    id: string | undefined;
-  };
   requestPermission: {
     src: "requestPermission";
     logic: PromiseActorLogic<PermissionResult, {
@@ -90,6 +85,11 @@ declare const documentCaptureMachine: StateMachine<DocumentCaptureContext, {
     logic: PromiseActorLogic<PermissionResult, void, EventObject>;
     id: string | undefined;
   };
+  initCamera: {
+    src: "initCamera";
+    logic: PromiseActorLogic<MediaStream, void, EventObject>;
+    id: string | undefined;
+  };
   finalizeDocumentRequest: {
     src: "finalizeDocumentRequest";
     logic: PromiseActorLogic<FinalizeDocumentResponse, {
@@ -102,20 +102,12 @@ declare const documentCaptureMachine: StateMachine<DocumentCaptureContext, {
     type: "decrementAttemptsRemaining";
     params: NonReducibleUnknown;
   };
-  setStream: {
-    type: "setStream";
-    params: NonReducibleUnknown;
-  };
-  setProgress: {
-    type: "setProgress";
-    params: NonReducibleUnknown;
-  };
   clearError: {
     type: "clearError";
     params: NonReducibleUnknown;
   };
-  stopStream: {
-    type: "stopStream";
+  setStream: {
+    type: "setStream";
     params: NonReducibleUnknown;
   };
   setCapturedDocument: {
@@ -126,6 +118,10 @@ declare const documentCaptureMachine: StateMachine<DocumentCaptureContext, {
     type: "setFileTooLargeError";
     params: NonReducibleUnknown;
   };
+  setProgress: {
+    type: "setProgress";
+    params: NonReducibleUnknown;
+  };
   setUploadError: {
     type: "setUploadError";
     params: NonReducibleUnknown;
@@ -190,6 +186,10 @@ declare const documentCaptureMachine: StateMachine<DocumentCaptureContext, {
     type: "resetProgress";
     params: NonReducibleUnknown;
   };
+  stopStream: {
+    type: "stopStream";
+    params: NonReducibleUnknown;
+  };
 }>, Values<{
   allowSkip: {
     type: "allowSkip";
@@ -251,14 +251,14 @@ declare const documentCaptureMachine: StateMachine<DocumentCaptureContext, {
     type: "fileSizeOkForNonGallery";
     params: unknown;
   };
-}>, never, "uploading" | "closed" | "success" | "finished" | "initCamera" | "capturing" | "tutorial" | "preview" | "failure" | "nextPage" | "finalizing" | {
+}>, never, "uploading" | "closed" | "success" | "finished" | "initCamera" | "tutorial" | "capturing" | "preview" | "failure" | "nextPage" | "finalizing" | {
   permissions: "idle" | "denied" | "waitingForUser" | "requesting" | "learnMore";
 }, string, DocumentCaptureInput, NonReducibleUnknown, EventObject, MetaObject, {
   readonly id: "documentCapture";
   readonly initial: "tutorial";
   readonly context: ({ input }: {
     spawn: {
-      <TSrc extends "uploadDocument" | "initCamera" | "requestPermission" | "checkPermission" | "finalizeDocumentRequest">(logic: TSrc, ...[options]: ({
+      <TSrc extends "uploadDocument" | "requestPermission" | "checkPermission" | "initCamera" | "finalizeDocumentRequest">(logic: TSrc, ...[options]: ({
         src: "uploadDocument";
         logic: PromiseActorLogic<DocumentUploadResponse, {
           capturedDocument: NonNullable<DocumentCaptureContext["capturedDocument"]>;
@@ -282,12 +282,18 @@ declare const documentCaptureMachine: StateMachine<DocumentCaptureContext, {
         input?: InputFrom<T["logic"]> | undefined;
         syncSnapshot?: boolean;
       } & { [K in RequiredActorOptions<T>]: unknown; }) | undefined], IsNotNever<RequiredActorOptions<T>>> : never : never : never) | ({
-        src: "initCamera";
-        logic: PromiseActorLogic<MediaStream, void, EventObject>;
+        src: "requestPermission";
+        logic: PromiseActorLogic<PermissionResult, {
+          permissionResult?: PermissionResult;
+          requestMotionPermission: boolean;
+        }, EventObject>;
         id: string | undefined;
       } extends (infer T_1) ? T_1 extends {
-        src: "initCamera";
-        logic: PromiseActorLogic<MediaStream, void, EventObject>;
+        src: "requestPermission";
+        logic: PromiseActorLogic<PermissionResult, {
+          permissionResult?: PermissionResult;
+          requestMotionPermission: boolean;
+        }, EventObject>;
         id: string | undefined;
       } ? T_1 extends {
         src: TSrc;
@@ -297,18 +303,12 @@ declare const documentCaptureMachine: StateMachine<DocumentCaptureContext, {
         input?: InputFrom<T_1["logic"]> | undefined;
         syncSnapshot?: boolean;
       } & { [K_1 in RequiredActorOptions<T_1>]: unknown; }) | undefined], IsNotNever<RequiredActorOptions<T_1>>> : never : never : never) | ({
-        src: "requestPermission";
-        logic: PromiseActorLogic<PermissionResult, {
-          permissionResult?: PermissionResult;
-          requestMotionPermission: boolean;
-        }, EventObject>;
+        src: "checkPermission";
+        logic: PromiseActorLogic<PermissionResult, void, EventObject>;
         id: string | undefined;
       } extends (infer T_2) ? T_2 extends {
-        src: "requestPermission";
-        logic: PromiseActorLogic<PermissionResult, {
-          permissionResult?: PermissionResult;
-          requestMotionPermission: boolean;
-        }, EventObject>;
+        src: "checkPermission";
+        logic: PromiseActorLogic<PermissionResult, void, EventObject>;
         id: string | undefined;
       } ? T_2 extends {
         src: TSrc;
@@ -318,12 +318,12 @@ declare const documentCaptureMachine: StateMachine<DocumentCaptureContext, {
         input?: InputFrom<T_2["logic"]> | undefined;
         syncSnapshot?: boolean;
       } & { [K_2 in RequiredActorOptions<T_2>]: unknown; }) | undefined], IsNotNever<RequiredActorOptions<T_2>>> : never : never : never) | ({
-        src: "checkPermission";
-        logic: PromiseActorLogic<PermissionResult, void, EventObject>;
+        src: "initCamera";
+        logic: PromiseActorLogic<MediaStream, void, EventObject>;
         id: string | undefined;
       } extends (infer T_3) ? T_3 extends {
-        src: "checkPermission";
-        logic: PromiseActorLogic<PermissionResult, void, EventObject>;
+        src: "initCamera";
+        logic: PromiseActorLogic<MediaStream, void, EventObject>;
         id: string | undefined;
       } ? T_3 extends {
         src: TSrc;
@@ -361,11 +361,6 @@ declare const documentCaptureMachine: StateMachine<DocumentCaptureContext, {
           }, EventObject>;
           id: string | undefined;
         };
-        initCamera: {
-          src: "initCamera";
-          logic: PromiseActorLogic<MediaStream, void, EventObject>;
-          id: string | undefined;
-        };
         requestPermission: {
           src: "requestPermission";
           logic: PromiseActorLogic<PermissionResult, {
@@ -379,6 +374,11 @@ declare const documentCaptureMachine: StateMachine<DocumentCaptureContext, {
           logic: PromiseActorLogic<PermissionResult, void, EventObject>;
           id: string | undefined;
         };
+        initCamera: {
+          src: "initCamera";
+          logic: PromiseActorLogic<MediaStream, void, EventObject>;
+          id: string | undefined;
+        };
         finalizeDocumentRequest: {
           src: "finalizeDocumentRequest";
           logic: PromiseActorLogic<FinalizeDocumentResponse, {
@@ -621,11 +621,6 @@ declare const documentCaptureMachine: StateMachine<DocumentCaptureContext, {
                   }, EventObject>;
                   id: string | undefined;
                 };
-                initCamera: {
-                  src: "initCamera";
-                  logic: PromiseActorLogic<MediaStream, void, EventObject>;
-                  id: string | undefined;
-                };
                 requestPermission: {
                   src: "requestPermission";
                   logic: PromiseActorLogic<PermissionResult, {
@@ -639,6 +634,11 @@ declare const documentCaptureMachine: StateMachine<DocumentCaptureContext, {
                   logic: PromiseActorLogic<PermissionResult, void, EventObject>;
                   id: string | undefined;
                 };
+                initCamera: {
+                  src: "initCamera";
+                  logic: PromiseActorLogic<MediaStream, void, EventObject>;
+                  id: string | undefined;
+                };
                 finalizeDocumentRequest: {
                   src: "finalizeDocumentRequest";
                   logic: PromiseActorLogic<FinalizeDocumentResponse, {
@@ -706,11 +706,6 @@ declare const documentCaptureMachine: StateMachine<DocumentCaptureContext, {
                   }, EventObject>;
                   id: string | undefined;
                 };
-                initCamera: {
-                  src: "initCamera";
-                  logic: PromiseActorLogic<MediaStream, void, EventObject>;
-                  id: string | undefined;
-                };
                 requestPermission: {
                   src: "requestPermission";
                   logic: PromiseActorLogic<PermissionResult, {
@@ -724,6 +719,11 @@ declare const documentCaptureMachine: StateMachine<DocumentCaptureContext, {
                   logic: PromiseActorLogic<PermissionResult, void, EventObject>;
                   id: string | undefined;
                 };
+                initCamera: {
+                  src: "initCamera";
+                  logic: PromiseActorLogic<MediaStream, void, EventObject>;
+                  id: string | undefined;
+                };
                 finalizeDocumentRequest: {
                   src: "finalizeDocumentRequest";
                   logic: PromiseActorLogic<FinalizeDocumentResponse, {
@@ -790,11 +790,6 @@ declare const documentCaptureMachine: StateMachine<DocumentCaptureContext, {
                   }, EventObject>;
                   id: string | undefined;
                 };
-                initCamera: {
-                  src: "initCamera";
-                  logic: PromiseActorLogic<MediaStream, void, EventObject>;
-                  id: string | undefined;
-                };
                 requestPermission: {
                   src: "requestPermission";
                   logic: PromiseActorLogic<PermissionResult, {
@@ -808,6 +803,11 @@ declare const documentCaptureMachine: StateMachine<DocumentCaptureContext, {
                   logic: PromiseActorLogic<PermissionResult, void, EventObject>;
                   id: string | undefined;
                 };
+                initCamera: {
+                  src: "initCamera";
+                  logic: PromiseActorLogic<MediaStream, void, EventObject>;
+                  id: string | undefined;
+                };
                 finalizeDocumentRequest: {
                   src: "finalizeDocumentRequest";
                   logic: PromiseActorLogic<FinalizeDocumentResponse, {
@@ -875,11 +875,6 @@ declare const documentCaptureMachine: StateMachine<DocumentCaptureContext, {
                   }, EventObject>;
                   id: string | undefined;
                 };
-                initCamera: {
-                  src: "initCamera";
-                  logic: PromiseActorLogic<MediaStream, void, EventObject>;
-                  id: string | undefined;
-                };
                 requestPermission: {
                   src: "requestPermission";
                   logic: PromiseActorLogic<PermissionResult, {
@@ -893,6 +888,11 @@ declare const documentCaptureMachine: StateMachine<DocumentCaptureContext, {
                   logic: PromiseActorLogic<PermissionResult, void, EventObject>;
                   id: string | undefined;
                 };
+                initCamera: {
+                  src: "initCamera";
+                  logic: PromiseActorLogic<MediaStream, void, EventObject>;
+                  id: string | undefined;
+                };
                 finalizeDocumentRequest: {
                   src: "finalizeDocumentRequest";
                   logic: PromiseActorLogic<FinalizeDocumentResponse, {
@@ -1129,11 +1129,6 @@ declare const documentCaptureMachine: StateMachine<DocumentCaptureContext, {
                   }, EventObject>;
                   id: string | undefined;
                 };
-                initCamera: {
-                  src: "initCamera";
-                  logic: PromiseActorLogic<MediaStream, void, EventObject>;
-                  id: string | undefined;
-                };
                 requestPermission: {
                   src: "requestPermission";
                   logic: PromiseActorLogic<PermissionResult, {
@@ -1147,6 +1142,11 @@ declare const documentCaptureMachine: StateMachine<DocumentCaptureContext, {
                   logic: PromiseActorLogic<PermissionResult, void, EventObject>;
                   id: string | undefined;
                 };
+                initCamera: {
+                  src: "initCamera";
+                  logic: PromiseActorLogic<MediaStream, void, EventObject>;
+                  id: string | undefined;
+                };
                 finalizeDocumentRequest: {
                   src: "finalizeDocumentRequest";
                   logic: PromiseActorLogic<FinalizeDocumentResponse, {
@@ -1214,11 +1214,6 @@ declare const documentCaptureMachine: StateMachine<DocumentCaptureContext, {
                   }, EventObject>;
                   id: string | undefined;
                 };
-                initCamera: {
-                  src: "initCamera";
-                  logic: PromiseActorLogic<MediaStream, void, EventObject>;
-                  id: string | undefined;
-                };
                 requestPermission: {
                   src: "requestPermission";
                   logic: PromiseActorLogic<PermissionResult, {
@@ -1232,6 +1227,11 @@ declare const documentCaptureMachine: StateMachine<DocumentCaptureContext, {
                   logic: PromiseActorLogic<PermissionResult, void, EventObject>;
                   id: string | undefined;
                 };
+                initCamera: {
+                  src: "initCamera";
+                  logic: PromiseActorLogic<MediaStream, void, EventObject>;
+                  id: string | undefined;
+                };
                 finalizeDocumentRequest: {
                   src: "finalizeDocumentRequest";
                   logic: PromiseActorLogic<FinalizeDocumentResponse, {
@@ -1298,11 +1298,6 @@ declare const documentCaptureMachine: StateMachine<DocumentCaptureContext, {
                   }, EventObject>;
                   id: string | undefined;
                 };
-                initCamera: {
-                  src: "initCamera";
-                  logic: PromiseActorLogic<MediaStream, void, EventObject>;
-                  id: string | undefined;
-                };
                 requestPermission: {
                   src: "requestPermission";
                   logic: PromiseActorLogic<PermissionResult, {
@@ -1316,6 +1311,11 @@ declare const documentCaptureMachine: StateMachine<DocumentCaptureContext, {
                   logic: PromiseActorLogic<PermissionResult, void, EventObject>;
                   id: string | undefined;
                 };
+                initCamera: {
+                  src: "initCamera";
+                  logic: PromiseActorLogic<MediaStream, void, EventObject>;
+                  id: string | undefined;
+                };
                 finalizeDocumentRequest: {
                   src: "finalizeDocumentRequest";
                   logic: PromiseActorLogic<FinalizeDocumentResponse, {
@@ -1433,11 +1433,6 @@ declare const documentCaptureMachine: StateMachine<DocumentCaptureContext, {
               }, EventObject>;
               id: string | undefined;
             };
-            initCamera: {
-              src: "initCamera";
-              logic: PromiseActorLogic<MediaStream, void, EventObject>;
-              id: string | undefined;
-            };
             requestPermission: {
               src: "requestPermission";
               logic: PromiseActorLogic<PermissionResult, {
@@ -1451,6 +1446,11 @@ declare const documentCaptureMachine: StateMachine<DocumentCaptureContext, {
               logic: PromiseActorLogic<PermissionResult, void, EventObject>;
               id: string | undefined;
             };
+            initCamera: {
+              src: "initCamera";
+              logic: PromiseActorLogic<MediaStream, void, EventObject>;
+              id: string | undefined;
+            };
             finalizeDocumentRequest: {
               src: "finalizeDocumentRequest";
               logic: PromiseActorLogic<FinalizeDocumentResponse, {

package/dist/{documentCaptureStateMachine-BM4Ex_5x.esm.js → documentCaptureStateMachine-DfGOBapD.esm.js}

@@ -1,11 +1,11 @@
 import { t as api } from "./api-Bx3gKW_y.esm.js";
-import { t as endpoints } from "./endpoints-CCzL3XD_.esm.js";
+import { t as endpoints } from "./endpoints-B-3Q-LUw.esm.js";
 import { i as assign, t as setup } from "./xstate.esm-BuFLFuzz.esm.js";
 import { n as fromPromise } from "./xstate-actors.esm-BXeQ-Ucz.esm.js";
-import { a as stopCameraStream } from "./camera-_2sXMXiF.esm.js";
-import { n as invokeRequestPermissionActor, t as checkPermission } from "./permissionServices-UvUcOSRb.esm.js";
-import { n as getBackCameraStream } from "./backCameraStream-CUeYm5eu.esm.js";
-import { r as resolveStoredPermissionResult, t as isReadyForCaptureFromPermission } from "./permissionGuards-KINpmKtI.esm.js";
+import { o as stopCameraStream } from "./camera-sIa9ceW2.esm.js";
+import { n as invokeRequestPermissionActor, t as checkPermission } from "./permissionServices-Bj_fyWtv.esm.js";
+import { r as resolveStoredPermissionResult, t as isReadyForCaptureFromPermission } from "./permissionGuards-uYZYFu4J.esm.js";
+import { n as getBackCameraStream } from "./backCameraStream-BOtyQowf.esm.js";
 //#region src/modules/document-capture/types.ts
 const PROCESSING_TYPE_MAP = {
 	processV5CLogbook: "v5cMultiPageLogbook",

package/dist/dynamic-forms.d.ts

@@ -1,3 +1,3 @@
 import { i as Screen, n as InputType, r as Question, t as DynamicFormsConfig } from "./types-BSBzhHRH.js";
-import { c as DynamicFormsValidationErrors, n as DynamicFormsState, o as DynamicFormsResult, r as createDynamicFormsManager, s as dynamicFormsMachine, t as DynamicFormsManager } from "./dynamicFormsManager-fhK0yINk.js";
+import { c as DynamicFormsValidationErrors, n as DynamicFormsState, o as DynamicFormsResult, r as createDynamicFormsManager, s as dynamicFormsMachine, t as DynamicFormsManager } from "./dynamicFormsManager-D5R_uxLQ.js";
 export { type DynamicFormsConfig, type DynamicFormsManager, type DynamicFormsResult, type DynamicFormsState, type DynamicFormsValidationErrors, type InputType, type Question, type Screen, createDynamicFormsManager, dynamicFormsMachine };

package/dist/dynamic-forms.esm.js

@@ -1,3 +1,3 @@
-import { t as dynamicFormsMachine } from "./dynamicFormsStateMachine-D6D7oEYk.esm.js";
-import { t as createDynamicFormsManager } from "./dynamicFormsManager-fFVIRBNv.esm.js";
+import { t as dynamicFormsMachine } from "./dynamicFormsStateMachine-D8zHBCh4.esm.js";
+import { t as createDynamicFormsManager } from "./dynamicFormsManager-BbS-XMFc.esm.js";
 export { createDynamicFormsManager, dynamicFormsMachine };

package/dist/{dynamicFormsManager-fFVIRBNv.esm.js → dynamicFormsManager-BbS-XMFc.esm.js}

@@ -1,7 +1,7 @@
-import { n as eventModuleNames, o as createManagerInstrumentation } from "./events-DYiyoSlx.esm.js";
+import { n as eventModuleNames, o as createManagerInstrumentation } from "./events-ijlbX_Wx.esm.js";
 import { t as topLevelStateName } from "./topLevelStateName-B5i2avbh.esm.js";
 import { s as createActor, u as createManager } from "./xstate.esm-BuFLFuzz.esm.js";
-import { t as dynamicFormsMachine } from "./dynamicFormsStateMachine-D6D7oEYk.esm.js";
+import { t as dynamicFormsMachine } from "./dynamicFormsStateMachine-D8zHBCh4.esm.js";
 //#region src/modules/dynamic-forms/dynamicFormsActor.ts
 function createDynamicFormsActor(options) {
 	return createActor(dynamicFormsMachine, { input: { config: options.config } }).start();
@@ -51,8 +51,8 @@ function hasAnyAnswer(answers) {
 * (`https://www.figma.com/design/N6otHMuY2Hha5eBqRz0uC3/Forms-and-Data-entry---Latest-Designs?node-id=53-60567`).
 * Family is `forms.*` with a single longform sub-family.
 *
-* `idle`, `loadingScreens`, `submitting`, `misconfigured`, and `closed` are
-* intentionally unmapped — the Figma canvas does not define discrete
+* `idle`, `loadingScreens`, `submitting`, `submitFailed`, `misconfigured`, and
+* `closed` are intentionally unmapped — the Figma canvas does not define discrete
 * tracked-event surfaces for them. They fall back to the generic
 * `<module>.<state>` default.
 */
@@ -97,6 +97,7 @@ function mapState(snapshot) {
 			nonEditableQuestionIds: context.nonEditableQuestionIds
 		};
 	}
+	if (typedSnapshot.matches("submitFailed")) return { status: "submitFailed" };
 	if (typedSnapshot.matches("success")) return { status: "success" };
 	if (typedSnapshot.matches("finished")) return {
 		status: "finished",
@@ -162,13 +163,23 @@ function createApi({ actor, trackElementClicked }) {
 		/**
 		* Submits the current screen's answers.
 		* Transitions to 'submitting', then advances to the next screen or 'finished'.
-		* Answer submission failures are fire-and-forget and do not block progression.
+		* Answer-content rejections (4xx) are fire-and-forget and do not block
+		* progression; a server-side failure (5xx / no round-trip) lands in
+		* 'submitFailed', where `retry()` re-submits.
 		*/
 		submit() {
 			trackElementClicked?.("submit");
 			actor.send({ type: "SUBMIT" });
 		},
 		/**
+		* Re-submits the current screen after a server-side submission failure.
+		* Valid only in the 'submitFailed' state; ignored elsewhere.
+		*/
+		retry() {
+			trackElementClicked?.("retry");
+			actor.send({ type: "RETRY" });
+		},
+		/**
 		* Dismisses the module from 'misconfigured' state.
 		* Fix the config (provide `screens` or `flowId`) rather than calling `reset()`.
 		*/

package/dist/{dynamicFormsManager-fhK0yINk.d.ts → dynamicFormsManager-D5R_uxLQ.d.ts}

@@ -74,6 +74,14 @@ type DynamicFormsSubmittingState = {
   /** questionIds prefilled with a non-editable value — render read-only. */
   nonEditableQuestionIds: string[];
 };
+/**
+ * An answer POST failed on the server's side — HTTP 5xx, or a request that
+ * never completed a round-trip (offline / DNS / TLS). Retryable: call `retry()`
+ * to re-submit.
+ */
+type DynamicFormsSubmitFailedState = {
+  status: 'submitFailed';
+};
 /**
  * All screens submitted — success screen visible for ~3 s before
  * transitioning to `finished`.
@@ -112,7 +120,7 @@ type DynamicFormsAttemptsExhaustedState = {
 /**
  * Union of all possible dynamic forms manager states.
  */
-type DynamicFormsState = DynamicFormsIdleState | DynamicFormsLoadingState | DynamicFormsInputtingState | DynamicFormsSubmittingState | DynamicFormsSuccessState | DynamicFormsFinishedState | DynamicFormsMisconfiguredState | DynamicFormsClosedState | DynamicFormsAttemptsExhaustedState;
+type DynamicFormsState = DynamicFormsIdleState | DynamicFormsLoadingState | DynamicFormsInputtingState | DynamicFormsSubmittingState | DynamicFormsSubmitFailedState | DynamicFormsSuccessState | DynamicFormsFinishedState | DynamicFormsMisconfiguredState | DynamicFormsClosedState | DynamicFormsAttemptsExhaustedState;
 /**
  * Creates a dynamic forms manager for headless or UI-driven usage.
  *
@@ -156,9 +164,16 @@ declare function createDynamicFormsManager(options: CreateDynamicFormsActorOptio
   /**
    * Submits the current screen's answers.
    * Transitions to 'submitting', then advances to the next screen or 'finished'.
-   * Answer submission failures are fire-and-forget and do not block progression.
+   * Answer-content rejections (4xx) are fire-and-forget and do not block
+   * progression; a server-side failure (5xx / no round-trip) lands in
+   * 'submitFailed', where `retry()` re-submits.
    */
   submit(): void;
+  /**
+   * Re-submits the current screen after a server-side submission failure.
+   * Valid only in the 'submitFailed' state; ignored elsewhere.
+   */
+  retry(): void;
   /**
    * Dismisses the module from 'misconfigured' state.
    * Fix the config (provide `screens` or `flowId`) rather than calling `reset()`.
@@ -200,9 +215,16 @@ declare function createDynamicFormsManagerFromActor(actor: DynamicFormsActor): M
   /**
    * Submits the current screen's answers.
    * Transitions to 'submitting', then advances to the next screen or 'finished'.
-   * Answer submission failures are fire-and-forget and do not block progression.
+   * Answer-content rejections (4xx) are fire-and-forget and do not block
+   * progression; a server-side failure (5xx / no round-trip) lands in
+   * 'submitFailed', where `retry()` re-submits.
    */
   submit(): void;
+  /**
+   * Re-submits the current screen after a server-side submission failure.
+   * Valid only in the 'submitFailed' state; ignored elsewhere.
+   */
+  retry(): void;
   /**
    * Dismisses the module from 'misconfigured' state.
    * Fix the config (provide `screens` or `flowId`) rather than calling `reset()`.