@incodetech/core 2.4.0 → 2.4.1-agentic.1

package/dist/{documentCaptureManager-DkyDtm3Y.d.ts → documentCaptureManager-CD5iQiUI.d.ts}

@@ -2,7 +2,7 @@ import { A as StateMachine, C as StateValue, D as PromiseActorLogic, a as ActorR
 import { t as Manager } from "./Manager-C9T5amUN.js";
 import "./Actor-DpTj5PFb.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-DUnFZ08M.js";
+import { a as DocumentCaptureErrorCode, c as DocumentType, d as FinalizeDocumentResponse, i as DocumentCaptureContext, l as DocumentUploadResponse, o as DocumentCaptureInput, r as DocumentCaptureConfig, s as DocumentCaptureNextPageType, t as CapturedDocument, u as DocumentUploadStatus } from "./types-CyNndVAT.js";
 //#region src/modules/document-capture/documentCaptureStateMachine.d.ts
 declare const documentCaptureMachine: StateMachine<DocumentCaptureContext, {
   type: "CAPTURE";
@@ -55,6 +55,7 @@ declare const documentCaptureMachine: StateMachine<DocumentCaptureContext, {
     capturedDocument: NonNullable<DocumentCaptureContext["capturedDocument"]>;
     processingType: string;
     sendBase64: boolean;
+    title: string | undefined;
     onProgress: (progress: number) => void;
   }, EventObject>> | ActorRefFromLogic<PromiseActorLogic<PermissionResult, {
     permissionResult?: PermissionResult;
@@ -69,6 +70,7 @@ declare const documentCaptureMachine: StateMachine<DocumentCaptureContext, {
       capturedDocument: NonNullable<DocumentCaptureContext["capturedDocument"]>;
       processingType: string;
       sendBase64: boolean;
+      title: string | undefined;
       onProgress: (progress: number) => void;
     }, EventObject>;
     id: string | undefined;
@@ -131,6 +133,10 @@ declare const documentCaptureMachine: StateMachine<DocumentCaptureContext, {
     type: "setFinalizeError";
     params: NonReducibleUnknown;
   };
+  setRejectionStatus: {
+    type: "setRejectionStatus";
+    params: NonReducibleUnknown;
+  };
   setCaptureMethodFile: {
     type: "setCaptureMethodFile";
     params: NonReducibleUnknown;
@@ -192,6 +198,10 @@ declare const documentCaptureMachine: StateMachine<DocumentCaptureContext, {
     params: NonReducibleUnknown;
   };
 }>, Values<{
+  isOutOfAttempts: {
+    type: "isOutOfAttempts";
+    params: unknown;
+  };
   allowSkip: {
     type: "allowSkip";
     params: unknown;
@@ -260,7 +270,7 @@ declare const documentCaptureMachine: StateMachine<DocumentCaptureContext, {
   readonly on: {
     readonly CLOSE: ".closed";
   };
-  readonly context: ({ input }: {
+  readonly context: ({ input, self }: {
     spawn: {
       <TSrc extends "uploadDocument" | "requestPermission" | "checkPermission" | "initCamera" | "finalizeDocumentRequest">(logic: TSrc, ...[options]: ({
         src: "uploadDocument";
@@ -268,6 +278,7 @@ declare const documentCaptureMachine: StateMachine<DocumentCaptureContext, {
           capturedDocument: NonNullable<DocumentCaptureContext["capturedDocument"]>;
           processingType: string;
           sendBase64: boolean;
+          title: string | undefined;
           onProgress: (progress: number) => void;
         }, EventObject>;
         id: string | undefined;
@@ -277,6 +288,7 @@ declare const documentCaptureMachine: StateMachine<DocumentCaptureContext, {
           capturedDocument: NonNullable<DocumentCaptureContext["capturedDocument"]>;
           processingType: string;
           sendBase64: boolean;
+          title: string | undefined;
           onProgress: (progress: number) => void;
         }, EventObject>;
         id: string | undefined;
@@ -364,6 +376,7 @@ declare const documentCaptureMachine: StateMachine<DocumentCaptureContext, {
             capturedDocument: NonNullable<DocumentCaptureContext["capturedDocument"]>;
             processingType: string;
             sendBase64: boolean;
+            title: string | undefined;
             onProgress: (progress: number) => void;
           }, EventObject>;
           id: string | undefined;
@@ -518,12 +531,17 @@ declare const documentCaptureMachine: StateMachine<DocumentCaptureContext, {
     helpOpen: false;
     progress: number;
     error: undefined;
+    rejectionStatus: undefined;
     attemptsRemaining: number;
     pageNumber: number;
     nextPageType: "none";
   };
   readonly states: {
     readonly tutorial: {
+      readonly always: {
+        readonly target: "finished";
+        readonly guard: "isOutOfAttempts";
+      };
       readonly on: {
         readonly OPEN_METHOD_SELECTION: {
           readonly actions: "openMethodSelection";
@@ -622,6 +640,7 @@ declare const documentCaptureMachine: StateMachine<DocumentCaptureContext, {
                     capturedDocument: NonNullable<DocumentCaptureContext["capturedDocument"]>;
                     processingType: string;
                     sendBase64: boolean;
+                    title: string | undefined;
                     onProgress: (progress: number) => void;
                   }, EventObject>;
                   id: string | undefined;
@@ -708,6 +727,7 @@ declare const documentCaptureMachine: StateMachine<DocumentCaptureContext, {
                     capturedDocument: NonNullable<DocumentCaptureContext["capturedDocument"]>;
                     processingType: string;
                     sendBase64: boolean;
+                    title: string | undefined;
                     onProgress: (progress: number) => void;
                   }, EventObject>;
                   id: string | undefined;
@@ -793,6 +813,7 @@ declare const documentCaptureMachine: StateMachine<DocumentCaptureContext, {
                     capturedDocument: NonNullable<DocumentCaptureContext["capturedDocument"]>;
                     processingType: string;
                     sendBase64: boolean;
+                    title: string | undefined;
                     onProgress: (progress: number) => void;
                   }, EventObject>;
                   id: string | undefined;
@@ -879,6 +900,7 @@ declare const documentCaptureMachine: StateMachine<DocumentCaptureContext, {
                     capturedDocument: NonNullable<DocumentCaptureContext["capturedDocument"]>;
                     processingType: string;
                     sendBase64: boolean;
+                    title: string | undefined;
                     onProgress: (progress: number) => void;
                   }, EventObject>;
                   id: string | undefined;
@@ -1134,6 +1156,7 @@ declare const documentCaptureMachine: StateMachine<DocumentCaptureContext, {
                     capturedDocument: NonNullable<DocumentCaptureContext["capturedDocument"]>;
                     processingType: string;
                     sendBase64: boolean;
+                    title: string | undefined;
                     onProgress: (progress: number) => void;
                   }, EventObject>;
                   id: string | undefined;
@@ -1220,6 +1243,7 @@ declare const documentCaptureMachine: StateMachine<DocumentCaptureContext, {
                     capturedDocument: NonNullable<DocumentCaptureContext["capturedDocument"]>;
                     processingType: string;
                     sendBase64: boolean;
+                    title: string | undefined;
                     onProgress: (progress: number) => void;
                   }, EventObject>;
                   id: string | undefined;
@@ -1305,6 +1329,7 @@ declare const documentCaptureMachine: StateMachine<DocumentCaptureContext, {
                     capturedDocument: NonNullable<DocumentCaptureContext["capturedDocument"]>;
                     processingType: string;
                     sendBase64: boolean;
+                    title: string | undefined;
                     onProgress: (progress: number) => void;
                   }, EventObject>;
                   id: string | undefined;
@@ -1441,6 +1466,7 @@ declare const documentCaptureMachine: StateMachine<DocumentCaptureContext, {
                 capturedDocument: NonNullable<DocumentCaptureContext["capturedDocument"]>;
                 processingType: string;
                 sendBase64: boolean;
+                title: string | undefined;
                 onProgress: (progress: number) => void;
               }, EventObject>;
               id: string | undefined;
@@ -1681,6 +1707,7 @@ declare const documentCaptureMachine: StateMachine<DocumentCaptureContext, {
           capturedDocument: CapturedDocument;
           processingType: DocumentType;
           sendBase64: boolean;
+          title: string | undefined;
           onProgress: (progress: number) => void;
         };
         readonly onDone: {
@@ -1689,7 +1716,7 @@ declare const documentCaptureMachine: StateMachine<DocumentCaptureContext, {
         };
         readonly onError: {
           readonly target: "failure";
-          readonly actions: readonly ["setUploadError", "decrementAttemptsRemaining", "stopStream"];
+          readonly actions: readonly ["setUploadError", "setRejectionStatus", "decrementAttemptsRemaining", "stopStream"];
         };
       };
       readonly on: {
@@ -1883,7 +1910,7 @@ declare const documentCaptureMachine: StateMachine<DocumentCaptureContext, {
         };
         readonly onError: {
           readonly target: "failure";
-          readonly actions: readonly ["setFinalizeError", "decrementAttemptsRemaining"];
+          readonly actions: readonly ["setFinalizeError", "setRejectionStatus", "decrementAttemptsRemaining"];
         };
       };
     };
@@ -1951,6 +1978,8 @@ type DocumentCaptureCapturingState = {
   pageNumber: number;
   /** Resolved max upload size in bytes (defaults to 10MB when unconfigured). */
   maxFileSize: number;
+  title: string | undefined;
+  text: string | undefined;
 };
 type DocumentCapturePreviewState = {
   status: 'preview';
@@ -1975,6 +2004,8 @@ type DocumentCaptureSuccessState = {
 type DocumentCaptureFailureState = {
   status: 'failure';
   error: DocumentCaptureErrorCode;
+  /** Server status that rejected the document (v3), when the server sent one. */
+  rejectionStatus?: DocumentUploadStatus;
   attemptsRemaining: number;
 };
 type DocumentCaptureFinishedState = {
@@ -1985,6 +2016,8 @@ type DocumentCaptureClosedState = {
 };
 type DocumentCaptureNextPageState = {
   status: 'nextPage';
+  title: string | undefined;
+  text: string | undefined;
   imageBase64: string;
   fileType: string;
   fileName: string;

package/dist/{documentCaptureManager-DUJwpKC5.esm.js → documentCaptureManager-DLPqruXJ.esm.js}

@@ -1,7 +1,7 @@
-import { n as eventModuleNames, o as createManagerInstrumentation } from "./events-Du2A4-Qr.esm.js";
+import { n as eventModuleNames, o as createManagerInstrumentation } from "./events-ggpBBaZ8.esm.js";
 import { t as topLevelStateName } from "./topLevelStateName-B5i2avbh.esm.js";
 import { s as createActor, u as createManager } from "./xstate.esm-DSajW7CJ.esm.js";
-import { n as DEFAULT_MAX_FILE_SIZE, r as DOCUMENT_CAPTURE_ERROR_CODES, t as documentCaptureMachine } from "./documentCaptureStateMachine-B8i7GnLh.esm.js";
+import { n as DEFAULT_MAX_FILE_SIZE, r as DOCUMENT_CAPTURE_ERROR_CODES, t as documentCaptureMachine } from "./documentCaptureStateMachine-DCvWQhFG.esm.js";
 //#region src/modules/document-capture/documentCaptureActor.ts
 function createDocumentCaptureActor(options) {
 	return createActor(documentCaptureMachine, { input: { config: options.config } }).start();
@@ -90,25 +90,30 @@ function getPermissionStatus(snapshot) {
 	if (snapshot.matches({ permissions: "idle" })) return "checking";
 	return "idle";
 }
+function getPageCopy(config, pageNumber) {
+	return pageNumber > 1 ? {
+		title: config.step2Title,
+		text: config.step2Text
+	} : {
+		title: config.title,
+		text: config.text
+	};
+}
 function mapState(snapshot) {
 	const typedSnapshot = snapshot;
 	const { context } = typedSnapshot;
-	if (typedSnapshot.matches("tutorial")) {
-		const isSecondPage = context.pageNumber > 1;
-		return {
-			status: "tutorial",
-			title: isSecondPage ? context.config.step2Title ?? context.config.title : context.config.title,
-			text: isSecondPage ? context.config.step2Text ?? context.config.text : context.config.text,
-			allowSkipDocumentCapture: context.config.allowSkipDocumentCapture && context.pageNumber === 1,
-			onlyCapture: context.config.onlyCapture,
-			onlyUpload: context.config.onlyUpload,
-			methodSelectionOpen: context.methodSelectionOpen,
-			onlyPdf: context.config.onlyPdf,
-			error: context.error,
-			pageNumber: context.pageNumber,
-			maxFileSize: context.config.maxFileSize
-		};
-	}
+	if (typedSnapshot.matches("tutorial")) return {
+		status: "tutorial",
+		...getPageCopy(context.config, context.pageNumber),
+		allowSkipDocumentCapture: context.config.allowSkipDocumentCapture && context.pageNumber === 1,
+		onlyCapture: context.config.onlyCapture,
+		onlyUpload: context.config.onlyUpload,
+		methodSelectionOpen: context.methodSelectionOpen,
+		onlyPdf: context.config.onlyPdf,
+		error: context.error,
+		pageNumber: context.pageNumber,
+		maxFileSize: context.config.maxFileSize
+	};
 	if (typedSnapshot.matches("permissions")) return {
 		status: "permissions",
 		permissionStatus: getPermissionStatus(typedSnapshot)
@@ -124,7 +129,8 @@ function mapState(snapshot) {
 		onlyPdf: context.config.onlyPdf,
 		error: context.error,
 		pageNumber: context.pageNumber,
-		maxFileSize: context.config.maxFileSize
+		maxFileSize: context.config.maxFileSize,
+		...getPageCopy(context.config, context.pageNumber)
 	};
 	if (typedSnapshot.matches("preview")) return {
 		status: "preview",
@@ -149,12 +155,14 @@ function mapState(snapshot) {
 	if (typedSnapshot.matches("failure")) return {
 		status: "failure",
 		error: context.error ?? DOCUMENT_CAPTURE_ERROR_CODES.UPLOAD_FAILED,
+		rejectionStatus: context.rejectionStatus,
 		attemptsRemaining: context.attemptsRemaining
 	};
 	if (typedSnapshot.matches("finished")) return { status: "finished" };
 	if (typedSnapshot.matches("closed")) return { status: "closed" };
 	if (typedSnapshot.matches("nextPage")) return {
 		status: "nextPage",
+		...getPageCopy(context.config, context.pageNumber + 1),
 		imageBase64: context.capturedDocument?.imageBase64 ?? "",
 		fileType: context.capturedDocument?.fileType ?? "",
 		fileName: context.capturedDocument?.file.name ?? "",

package/dist/{documentCaptureStateMachine-B8i7GnLh.esm.js → documentCaptureStateMachine-DCvWQhFG.esm.js}

@@ -1,10 +1,11 @@
-import { t as api, u as endpoints } from "./api-Cz90EHyu.esm.js";
+import { t as api, u as endpoints } from "./api-CpP4PS4S.esm.js";
 import { i as assign, t as setup } from "./xstate.esm-DSajW7CJ.esm.js";
 import { n as fromPromise } from "./xstate-actors.esm-8Gzepa_A.esm.js";
-import { o as stopCameraStream } from "./camera-sIa9ceW2.esm.js";
-import { n as invokeRequestPermissionActor, t as checkPermission } from "./permissionServices-Ca-tSNhT.esm.js";
-import { r as resolveStoredPermissionResult, t as isReadyForCaptureFromPermission } from "./permissionGuards-gcy3U0SL.esm.js";
-import { n as getBackCameraStream } from "./backCameraStream-CMvXj4X4.esm.js";
+import { a as stopCameraStream } from "./camera-E_Kcre4O.esm.js";
+import { n as invokeRequestPermissionActor, t as checkPermission } from "./permissionServices-D190ATGD.esm.js";
+import { r as resolveStoredPermissionResult, t as isReadyForCaptureFromPermission } from "./permissionGuards-DFV-Ws0a.esm.js";
+import { t as carryAttempts } from "./attemptCarry-WOkfvFMw.esm.js";
+import { n as getBackCameraStream } from "./backCameraStream-DS1oDiUq.esm.js";
 //#region src/modules/document-capture/types.ts
 const PROCESSING_TYPE_MAP = {
 	processV5CLogbook: "v5cMultiPageLogbook",
@@ -17,13 +18,27 @@ const PROCESSING_TYPE_MAP = {
 	processW8BenOcr: "w8Ben",
 	processW8BenEOcr: "w8BenE"
 };
+const V3_TYPES = /* @__PURE__ */ new Set([
+	"signature",
+	"document",
+	"medicalDoc",
+	"thirdId",
+	"contract",
+	"v5cMultiPageLogbook",
+	"carInvoice",
+	"financeSettlement",
+	"circulationCard",
+	"w8Ben",
+	"w8BenE"
+]);
 const MULTI_PAGE_TYPES = [
 	"v5cMultiPageLogbook",
+	"carInvoice",
 	"circulationCard",
 	"financeSettlement",
 	"w8BenE"
 ];
-const V3_SINGLE_PAGE_TYPES = /* @__PURE__ */ new Set(["w8Ben"]);
+const ASYNC_LEGACY_TYPES = /* @__PURE__ */ new Set(["asyncProcessCarInvoice", "asyncProcessCirculationCard"]);
 const DEFAULT_MAX_FILE_SIZE = 10 * 1024 * 1024;
 const OTHER_DOCUMENT_TYPES = /* @__PURE__ */ new Set([
 	"otherDocument1",
@@ -37,6 +52,17 @@ const DOCUMENT_CAPTURE_ERROR_CODES = {
 const DOCUMENT_CAPTURE_FINALIZE_ERROR_CODES = { UNEXPECTED_ERROR: "UNEXPECTED_ERROR" };
 //#endregion
 //#region src/modules/document-capture/documentCaptureUploadService.ts
+/** Thrown when the server answers 2xx but rejects the document with a status. */
+var DocumentUploadRejectedError = class extends Error {
+	constructor(message, status) {
+		super(message);
+		this.name = "DocumentUploadRejectedError";
+		this.status = status;
+	}
+};
+function getRejectionStatus(error) {
+	return error instanceof DocumentUploadRejectedError ? error.status : void 0;
+}
 const ADDRESS_STATEMENT_PROCESSING_TYPES = /* @__PURE__ */ new Set([
 	"processPoaOcr",
 	"processLoaOcr",
@@ -52,23 +78,30 @@ function isMultiPageDocumentType(processingType) {
 function normalizeProcessingType(processingType) {
 	return PROCESSING_TYPE_MAP[processingType] ?? processingType;
 }
-function buildUrl(baseUrl, type, format) {
-	return `${baseUrl}?type=${encodeURIComponent(type)}&format=${format}`;
+function buildUrl(baseUrl, type, format, extraParams = {}) {
+	const params = new URLSearchParams({
+		type,
+		format
+	});
+	for (const [key, value] of Object.entries(extraParams)) if (value) params.set(key, value);
+	return `${baseUrl}?${params.toString()}`;
 }
-function resolveUploadUrl(processingType, fileFormat, sendBase64 = false) {
+function resolveUploadUrl(processingType, fileFormat, sendBase64 = false, { title } = {}) {
 	const format = fileFormat === "application/pdf" ? "pdf" : "image";
 	const resolvedType = normalizeProcessingType(processingType);
-	if (isMultiPageDocumentType(resolvedType)) return buildUrl(endpoints.documentV3, resolvedType, format);
-	if (V3_SINGLE_PAGE_TYPES.has(resolvedType)) return buildUrl(endpoints.documentV3, resolvedType, format);
-	if (resolvedType === "carInvoice") return buildUrl(endpoints.cfdi, resolvedType, format);
-	if (ADDRESS_STATEMENT_PROCESSING_TYPES.has(resolvedType)) return buildUrl(endpoints.addressStatement, resolvedType, format);
-	if (!sendBase64) return buildUrl(endpoints.documentLegacy, OTHER_DOCUMENT_TYPES.has(resolvedType) ? resolvedType : "addressStatement", format);
-	if (OTHER_DOCUMENT_TYPES.has(resolvedType)) return buildUrl(endpoints.addDocument, resolvedType, format);
-	if (resolvedType === "addressStatement" || !resolvedType) return buildUrl(endpoints.addressStatement, resolvedType || "addressStatement", format);
-	return buildUrl(endpoints.addressStatement, processingType, format);
+	if (ASYNC_LEGACY_TYPES.has(processingType)) return buildUrl(endpoints.cfdi, resolvedType, format, { title });
+	if (V3_TYPES.has(resolvedType)) return buildUrl(endpoints.documentV3, resolvedType, format, {
+		processingMethod: resolvedType === "carInvoice" ? "sync" : void 0,
+		title
+	});
+	if (ADDRESS_STATEMENT_PROCESSING_TYPES.has(resolvedType)) return buildUrl(endpoints.addressStatement, resolvedType, format, { title });
+	if (!sendBase64) return buildUrl(endpoints.documentLegacy, OTHER_DOCUMENT_TYPES.has(resolvedType) ? resolvedType : "addressStatement", format, { title });
+	if (OTHER_DOCUMENT_TYPES.has(resolvedType)) return buildUrl(endpoints.addDocument, resolvedType, format, { title });
+	if (resolvedType === "addressStatement" || !resolvedType) return buildUrl(endpoints.addressStatement, resolvedType || "addressStatement", format, { title });
+	return buildUrl(endpoints.addressStatement, processingType, format, { title });
 }
-async function uploadDocumentCapture({ file, base64Image, sendBase64 = false, processingType, fileFormat, onProgress, signal }) {
-	const url = resolveUploadUrl(processingType, fileFormat, sendBase64);
+async function uploadDocumentCapture({ file, base64Image, sendBase64 = false, processingType, fileFormat, title, onProgress, signal }) {
+	const url = resolveUploadUrl(processingType, fileFormat, sendBase64, { title });
 	const useBase64 = !url.startsWith(`${endpoints.documentLegacy}?`);
 	const body = useBase64 ? { base64Image: base64Image.includes(",") ? base64Image.split(",")[1] : base64Image } : file;
 	const response = await api.post(url, body, {
@@ -77,7 +110,7 @@ async function uploadDocumentCapture({ file, base64Image, sendBase64 = false, pr
 		onUploadProgress: onProgress
 	});
 	if (!response.ok) throw new Error(`Document upload failed: ${response.status}`);
-	if (!(response.data.success || response.data.status === "SUCCESS" || response.data.status === "ADD_NEXT_PAGE" || response.data.status === "OPTIONAL_PAGE_CAPTURE")) throw new Error("Document upload rejected by server");
+	if (!(response.data.success || response.data.status === "SUCCESS" || response.data.status === "ADD_NEXT_PAGE" || response.data.status === "OPTIONAL_PAGE_CAPTURE")) throw new DocumentUploadRejectedError("Document upload rejected by server", response.data.status);
 	return response.data;
 }
 function resolveMultiPageDocumentType(processingType) {
@@ -91,10 +124,7 @@ async function finalizeDocument({ processingType, signal }) {
 	if (!response.ok) throw new Error(`Document finalize failed: ${response.status}`);
 	const data = response.data;
 	if (!data) throw new Error("Document finalize rejected by server");
-	if (!(data.success || data.status === "SUCCESS")) {
-		const serverStatus = typeof data.status === "string" ? data.status : "unknown";
-		throw new Error(`Document finalize rejected by server (status: ${serverStatus})`);
-	}
+	if (!(data.success || data.status === "SUCCESS")) throw new DocumentUploadRejectedError(`Document finalize rejected by server (status: ${data.status ?? "unknown"})`, data.status);
 	return data;
 }
 //#endregion
@@ -123,6 +153,7 @@ const documentCaptureMachine = setup({
 				sendBase64: input.sendBase64,
 				processingType: input.processingType,
 				fileFormat: input.capturedDocument.fileType,
+				title: input.title,
 				onProgress: input.onProgress,
 				signal
 			});
@@ -151,6 +182,7 @@ const documentCaptureMachine = setup({
 		setProgress: assign(({ event }) => ({ progress: event.progress })),
 		setUploadError: assign({ error: () => DOCUMENT_CAPTURE_ERROR_CODES.UPLOAD_FAILED }),
 		setFinalizeError: assign({ error: () => DOCUMENT_CAPTURE_FINALIZE_ERROR_CODES.UNEXPECTED_ERROR }),
+		setRejectionStatus: assign(({ event }) => ({ rejectionStatus: getRejectionStatus(event.error) })),
 		decrementAttemptsRemaining: assign(({ context }) => ({ attemptsRemaining: context.attemptsRemaining - 1 })),
 		setCaptureMethodFile: assign({ captureMethod: () => "file" }),
 		setCaptureMethodCamera: assign({ captureMethod: () => "camera" }),
@@ -185,7 +217,10 @@ const documentCaptureMachine = setup({
 			nextPageType: "none",
 			captureMethod: void 0
 		})),
-		clearError: assign({ error: () => void 0 }),
+		clearError: assign({
+			error: () => void 0,
+			rejectionStatus: () => void 0
+		}),
 		resetProgress: assign({ progress: () => 0 }),
 		stopStream: assign(({ context }) => {
 			if (context.stream) stopCameraStream(context.stream);
@@ -193,6 +228,7 @@ const documentCaptureMachine = setup({
 		})
 	},
 	guards: {
+		isOutOfAttempts: ({ context }) => context.attemptsRemaining <= 0 && context.attemptsRemaining < context.config.captureAttempts,
 		allowSkip: ({ context }) => context.config.allowSkipDocumentCapture && context.pageNumber === 1,
 		fileSizeOk: ({ context, event }) => {
 			return event.file.size <= context.config.maxFileSize;
@@ -222,7 +258,7 @@ const documentCaptureMachine = setup({
 	id: "documentCapture",
 	initial: "tutorial",
 	on: { CLOSE: ".closed" },
-	context: ({ input }) => {
+	context: ({ input, self }) => {
 		const { processingType = "addressStatement", captureMode, allowSkipDocumentCapture, disableSkipPoa, captureAttempts = 3, sendBase64 = false, maxFileSize = DEFAULT_MAX_FILE_SIZE, onlyPdf = false, title, text, step2Title, step2Text } = input.config;
 		return {
 			config: {
@@ -247,42 +283,49 @@ const documentCaptureMachine = setup({
 			helpOpen: false,
 			progress: 0,
 			error: void 0,
-			attemptsRemaining: captureAttempts,
+			rejectionStatus: void 0,
+			attemptsRemaining: carryAttempts("documentCapture", self, (s) => ({ attemptsRemaining: s.context.attemptsRemaining })).attemptsRemaining ?? captureAttempts,
 			pageNumber: 1,
 			nextPageType: "none"
 		};
 	},
 	states: {
-		tutorial: { on: {
-			OPEN_METHOD_SELECTION: { actions: "openMethodSelection" },
-			CLOSE_METHOD_SELECTION: { actions: ["closeMethodSelection", "clearCaptureMethod"] },
-			SELECT_UPLOAD_METHOD: { actions: "setCaptureMethodFile" },
-			DESELECT_UPLOAD_METHOD: { actions: "clearCaptureMethod" },
-			CAPTURE: [{
-				target: "permissions",
-				guard: "allowsCameraCapture",
-				actions: ["closeMethodSelection", "clearCaptureMethod"]
-			}, {
-				target: "capturing",
-				actions: ["closeMethodSelection", "clearCaptureMethod"]
-			}],
-			FILE_SELECTED: [{
-				target: "preview",
-				guard: "fileSizeOk",
-				actions: [
-					"setCapturedDocument",
-					"setCaptureMethodFile",
-					"closeMethodSelection"
-				]
-			}, {
-				target: "tutorial",
-				actions: ["setFileTooLargeError", "closeMethodSelection"]
-			}],
-			SKIP: {
+		tutorial: {
+			always: {
 				target: "finished",
-				guard: "allowSkip"
+				guard: "isOutOfAttempts"
+			},
+			on: {
+				OPEN_METHOD_SELECTION: { actions: "openMethodSelection" },
+				CLOSE_METHOD_SELECTION: { actions: ["closeMethodSelection", "clearCaptureMethod"] },
+				SELECT_UPLOAD_METHOD: { actions: "setCaptureMethodFile" },
+				DESELECT_UPLOAD_METHOD: { actions: "clearCaptureMethod" },
+				CAPTURE: [{
+					target: "permissions",
+					guard: "allowsCameraCapture",
+					actions: ["closeMethodSelection", "clearCaptureMethod"]
+				}, {
+					target: "capturing",
+					actions: ["closeMethodSelection", "clearCaptureMethod"]
+				}],
+				FILE_SELECTED: [{
+					target: "preview",
+					guard: "fileSizeOk",
+					actions: [
+						"setCapturedDocument",
+						"setCaptureMethodFile",
+						"closeMethodSelection"
+					]
+				}, {
+					target: "tutorial",
+					actions: ["setFileTooLargeError", "closeMethodSelection"]
+				}],
+				SKIP: {
+					target: "finished",
+					guard: "allowSkip"
+				}
 			}
-		} },
+		},
 		permissions: {
 			initial: "idle",
 			states: {
@@ -421,6 +464,7 @@ const documentCaptureMachine = setup({
 						capturedDocument: context.capturedDocument,
 						processingType: context.config.processingType,
 						sendBase64: context.config.sendBase64,
+						title: context.config.title,
 						onProgress: (progress) => {
 							self.send({
 								type: "UPLOAD_PROGRESS",
@@ -437,6 +481,7 @@ const documentCaptureMachine = setup({
 					target: "failure",
 					actions: [
 						"setUploadError",
+						"setRejectionStatus",
 						"decrementAttemptsRemaining",
 						"stopStream"
 					]
@@ -476,7 +521,11 @@ const documentCaptureMachine = setup({
 			onDone: { target: "finished" },
 			onError: {
 				target: "failure",
-				actions: ["setFinalizeError", "decrementAttemptsRemaining"]
+				actions: [
+					"setFinalizeError",
+					"setRejectionStatus",
+					"decrementAttemptsRemaining"
+				]
 			}
 		} },
 		failure: { on: {

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-BSBzhHRH2.js";
-import { c as DynamicFormsValidationErrors, n as DynamicFormsState, o as DynamicFormsResult, r as createDynamicFormsManager, s as dynamicFormsMachine, t as DynamicFormsManager } from "./dynamicFormsManager-C0dHs1ty.js";
+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-9kwY8Bf5.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-DEI45xYW.esm.js";
-import { t as createDynamicFormsManager } from "./dynamicFormsManager-DiKYjcF3.esm.js";
+import { t as dynamicFormsMachine } from "./dynamicFormsStateMachine-USQMB-uV.esm.js";
+import { t as createDynamicFormsManager } from "./dynamicFormsManager-DfqCEPg9.esm.js";
 export { createDynamicFormsManager, dynamicFormsMachine };

package/dist/{dynamicFormsManager-C0dHs1ty.d.ts → dynamicFormsManager-9kwY8Bf5.d.ts}

@@ -1,7 +1,7 @@
 import { i as ActorRefFrom } from "./spawn-D9jgw9pW.js";
 import { t as Manager } from "./Manager-C9T5amUN.js";
 import "./Actor-DpTj5PFb.js";
-import { i as Screen, t as DynamicFormsConfig } from "./types-BSBzhHRH2.js";
+import { i as Screen, t as DynamicFormsConfig } from "./types-BSBzhHRH.js";
 //#region src/modules/dynamic-forms/dynamicFormsFields.d.ts
 /** Map of `questionId` → currently-displayed i18n error key. */
 type DynamicFormsValidationErrors = Partial<Record<string, string>>;

package/dist/{dynamicFormsManager-DiKYjcF3.esm.js → dynamicFormsManager-DfqCEPg9.esm.js}

@@ -1,7 +1,7 @@
-import { n as eventModuleNames, o as createManagerInstrumentation } from "./events-Du2A4-Qr.esm.js";
+import { n as eventModuleNames, o as createManagerInstrumentation } from "./events-ggpBBaZ8.esm.js";
 import { t as topLevelStateName } from "./topLevelStateName-B5i2avbh.esm.js";
 import { s as createActor, u as createManager } from "./xstate.esm-DSajW7CJ.esm.js";
-import { t as dynamicFormsMachine } from "./dynamicFormsStateMachine-DEI45xYW.esm.js";
+import { t as dynamicFormsMachine } from "./dynamicFormsStateMachine-USQMB-uV.esm.js";
 //#region src/modules/dynamic-forms/dynamicFormsActor.ts
 function createDynamicFormsActor(options) {
 	return createActor(dynamicFormsMachine, { input: { config: options.config } }).start();

package/dist/{dynamicFormsStateMachine-DEI45xYW.esm.js → dynamicFormsStateMachine-USQMB-uV.esm.js}

@@ -1,5 +1,5 @@
-import { t as api, u as endpoints } from "./api-Cz90EHyu.esm.js";
-import { i as toIncodeApiError, r as isServerError, t as IncodeApiError } from "./apiError-DPwFas2f.esm.js";
+import { t as api, u as endpoints } from "./api-CpP4PS4S.esm.js";
+import { i as toIncodeApiError, r as isServerError, t as IncodeApiError } from "./apiError-DH-CH4Nz.esm.js";
 import { i as assign, t as setup } from "./xstate.esm-DSajW7CJ.esm.js";
 import { n as fromPromise } from "./xstate-actors.esm-8Gzepa_A.esm.js";
 import { t as isoDateToMs } from "./dateUtils-CvG0FvK8.esm.js";

package/dist/ekyb.d.ts

@@ -1,8 +1,8 @@
 import "./Manager-C9T5amUN.js";
-import { c as AddressSuggestion } from "./types-BvLo3U4u.js";
-import { i as FlowModuleConfig } from "./types-B6HsSzpk.js";
-import { a as EkybValidationError, n as EkybCountry, o as EkybValidationErrors, r as EkybFieldDef, s as UboEntry, t as EkybConfig } from "./types-0L-eFDmr.js";
-import { n as EkybState, o as ekybMachine, r as createEkybManager, t as EkybManager } from "./ekybManager-BaZ_7CEu.js";
+import { n as AddressSuggestion } from "./textRules-D4NRinKY.js";
+import { i as FlowModuleConfig } from "./types-CRaFu6wS.js";
+import { a as EkybValidationError, n as EkybCountry, o as EkybValidationErrors, r as EkybFieldDef, s as UboEntry, t as EkybConfig } from "./types-BgRHw-dR.js";
+import { n as EkybState, o as ekybMachine, r as createEkybManager, t as EkybManager } from "./ekybManager-BLOkwmWO.js";
 //#region src/modules/ekyb/ekybServices.d.ts
 type EkybFlowConfig = FlowModuleConfig['EKYB'];
 //#endregion

package/dist/ekyb.esm.js

@@ -1,4 +1,4 @@
-import { A as isSupportedCountry, O as SUPPORTED_COUNTRIES, b as ALL_COUNTRIES, v as toEkybConfig, w as DEV_ONLY_COUNTRIES } from "./flowServices-roD0oIQL.esm.js";
-import { t as ekybMachine } from "./ekybStateMachine-BLRT45Ex.esm.js";
-import { t as createEkybManager } from "./ekybManager-8WLkNcqg.esm.js";
+import { c as ALL_COUNTRIES, f as SUPPORTED_COUNTRIES, l as DEV_ONLY_COUNTRIES, m as isSupportedCountry, o as toEkybConfig } from "./ekybUtils-Cw8Ta9Qi.esm.js";
+import { t as ekybMachine } from "./ekybStateMachine-kHwdz6hm.esm.js";
+import { t as createEkybManager } from "./ekybManager-CR8YSYux.esm.js";
 export { ALL_COUNTRIES, DEV_ONLY_COUNTRIES, SUPPORTED_COUNTRIES, createEkybManager, ekybMachine, isSupportedCountry, toEkybConfig };

package/dist/{ekybManager-BaZ_7CEu.d.ts → ekybManager-BLOkwmWO.d.ts}

@@ -1,8 +1,8 @@
 import { i as ActorRefFrom } from "./spawn-D9jgw9pW.js";
 import { t as Manager } from "./Manager-C9T5amUN.js";
 import "./Actor-DpTj5PFb.js";
-import { c as AddressSuggestion } from "./types-BvLo3U4u.js";
-import { i as EkybFormValues, o as EkybValidationErrors, r as EkybFieldDef, s as UboEntry, t as EkybConfig } from "./types-0L-eFDmr.js";
+import { n as AddressSuggestion } from "./textRules-D4NRinKY.js";
+import { i as EkybFormValues, o as EkybValidationErrors, r as EkybFieldDef, s as UboEntry, t as EkybConfig } from "./types-BgRHw-dR.js";
 //#region src/modules/ekyb/ekybStateMachine.d.ts
 declare const ekybMachine: any;
 type EkybMachine = typeof ekybMachine;