@incodetech/core 2.2.0 → 2.3.0-rc.0

package/dist/watchlistForBusinessManager-CpuuB1J2.esm.js

@@ -0,0 +1,107 @@
+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 watchlistForBusinessMachine } from "./watchlistForBusinessStateMachine-DEzgjz7C.esm.js";
+//#region src/modules/watchlist-for-business/watchlistForBusinessActor.ts
+function createWatchlistForBusinessActor() {
+	return createActor(watchlistForBusinessMachine).start();
+}
+//#endregion
+//#region src/modules/watchlist-for-business/watchlistForBusinessManager.ts
+/**
+* Maps a Watchlist-for-Business state-machine snapshot to the exact Figma
+* "Tracked Events" screen name. Source: Watchlist for Business Figma
+* file (`https://www.figma.com/design/BfHifNPAvPTpBlnMEDfg4J/Watchlist-for-Business---Latest-Design?node-id=3031-82920`).
+* Family is `watchlist.*`, shared with global watchlist and custom
+* watchlist — each manager keeps its own module token per the
+* AdSign/QSign precedent.
+*
+* `idle` and `finished` are intentionally unmapped — the Figma canvas does
+* not define screens for them; `finished` collapses into `moduleClosed`.
+*/
+function getWatchlistForBusinessScreenName(snapshot) {
+	const stateName = topLevelStateName(snapshot.value);
+	if (stateName === void 0) return void 0;
+	switch (stateName) {
+		case "form": return snapshot.context.isValid ? "watchlist.filled" : "watchlist.default";
+		case "submitting": return "watchlist.processing";
+		case "success": return "watchlist.success";
+		default: return;
+	}
+}
+function mapState(snapshot) {
+	const typedSnapshot = snapshot;
+	const { context } = typedSnapshot;
+	if (typedSnapshot.matches("form")) return {
+		status: "form",
+		country: context.country,
+		businessName: context.businessName,
+		isValid: context.isValid,
+		validationErrors: context.validationErrors,
+		canSubmit: Object.keys(context.validationErrors ?? {}).length === 0
+	};
+	if (typedSnapshot.matches("submitting")) return { status: "submitting" };
+	if (typedSnapshot.matches("success")) return { status: "success" };
+	if (typedSnapshot.matches("finished")) return { status: "finished" };
+	return { status: "idle" };
+}
+function createApi({ actor, trackElementClicked }) {
+	return {
+		/** Transitions from `idle` to the form. Must be called before any other method. */
+		load() {
+			actor.send({ type: "LOAD" });
+		},
+		/** Updates the selected country code (ISO 3166-1 alpha-2). */
+		setCountry(country) {
+			actor.send({
+				type: "SET_COUNTRY",
+				country
+			});
+		},
+		/** Updates the business name field and recomputes validity. */
+		setBusinessName(value) {
+			actor.send({
+				type: "SET_BUSINESS_NAME",
+				value
+			});
+		},
+		/** Submits the form. Only transitions when `isValid` is true. */
+		submit() {
+			trackElementClicked?.("submit");
+			actor.send({ type: "SUBMIT" });
+		}
+	};
+}
+/**
+* Creates a watchlist-for-business manager for headless or UI-driven usage.
+*
+* On API error the module completes silently (fire-and-forget).
+*
+* @example Headless usage
+* ```typescript
+* import { createWatchlistForBusinessManager } from '@incodetech/core/watchlist-for-business';
+*
+* const manager = createWatchlistForBusinessManager();
+* manager.subscribe((state) => {
+*   if (state.status === 'finished') console.log('Done');
+* });
+* manager.load();
+* manager.setCountry('MX');
+* manager.setBusinessName('Acme Corp');
+* manager.submit();
+* manager.stop();
+* ```
+*/
+function createWatchlistForBusinessManager() {
+	return createWatchlistForBusinessManagerFromActor(createWatchlistForBusinessActor());
+}
+function createWatchlistForBusinessManagerFromActor(actor) {
+	return createManager({
+		actor,
+		mapState,
+		createApi,
+		instrumentation: createManagerInstrumentation(eventModuleNames.watchlistForBusiness, { getEventScreenName: getWatchlistForBusinessScreenName })
+	});
+}
+//#endregion
+export { createWatchlistForBusinessManagerFromActor as n, createWatchlistForBusinessManager as t };

package/dist/watchlistForBusinessManager-CsnJnG-C.d.ts

@@ -0,0 +1,99 @@
+import { i as ActorRefFrom } from "./spawn-D9jgw9pW.js";
+import { t as Manager } from "./Manager-CQQ99QOI.js";
+import "./Actor-iTq7YY48.js";
+//#region src/modules/watchlist-for-business/watchlistForBusinessStateMachine.d.ts
+declare const watchlistForBusinessMachine: any;
+type WatchlistForBusinessMachine = typeof watchlistForBusinessMachine;
+//#endregion
+//#region src/modules/watchlist-for-business/watchlistForBusinessActor.d.ts
+type WatchlistForBusinessActor = ActorRefFrom<WatchlistForBusinessMachine>;
+//#endregion
+//#region src/modules/watchlist-for-business/types.d.ts
+/**
+ * Configuration for the watchlist-for-business module.
+ *
+ * No server-side configuration is required — the module collects
+ * country and business name from the user and submits them to the
+ * business watchlist endpoint.
+ */
+type WatchlistForBusinessConfig = Record<string, never>;
+type WatchlistForBusinessValidationErrors = {
+  businessName?: string;
+};
+//#endregion
+//#region src/modules/watchlist-for-business/watchlistForBusinessManager.d.ts
+/** Waiting for `load()` to be called. */
+type WatchlistForBusinessIdleState = {
+  status: 'idle';
+};
+/** Form is ready — use `setCountry()`, `setBusinessName()`, and `submit()`. */
+type WatchlistForBusinessFormState = {
+  status: 'form';
+  country: string;
+  businessName: string;
+  isValid: boolean;
+  validationErrors?: WatchlistForBusinessValidationErrors;
+  canSubmit: boolean;
+};
+/** API request in flight. */
+type WatchlistForBusinessSubmittingState = {
+  status: 'submitting';
+};
+/**
+ * API succeeded — success screen visible for ~3 s before transitioning
+ * to `finished`.
+ */
+type WatchlistForBusinessSuccessState = {
+  status: 'success';
+};
+/** Module complete. Fires regardless of API outcome (fire-and-forget). */
+type WatchlistForBusinessFinishedState = {
+  status: 'finished';
+};
+/**
+ * Discriminated union of all possible watchlist-for-business manager states.
+ */
+type WatchlistForBusinessState = WatchlistForBusinessIdleState | WatchlistForBusinessFormState | WatchlistForBusinessSubmittingState | WatchlistForBusinessSuccessState | WatchlistForBusinessFinishedState;
+/**
+ * Creates a watchlist-for-business manager for headless or UI-driven usage.
+ *
+ * On API error the module completes silently (fire-and-forget).
+ *
+ * @example Headless usage
+ * ```typescript
+ * import { createWatchlistForBusinessManager } from '@incodetech/core/watchlist-for-business';
+ *
+ * const manager = createWatchlistForBusinessManager();
+ * manager.subscribe((state) => {
+ *   if (state.status === 'finished') console.log('Done');
+ * });
+ * manager.load();
+ * manager.setCountry('MX');
+ * manager.setBusinessName('Acme Corp');
+ * manager.submit();
+ * manager.stop();
+ * ```
+ */
+declare function createWatchlistForBusinessManager(): Manager<WatchlistForBusinessState> & {
+  /** Transitions from `idle` to the form. Must be called before any other method. */
+  load(): void;
+  /** Updates the selected country code (ISO 3166-1 alpha-2). */
+  setCountry(country: string): void;
+  /** Updates the business name field and recomputes validity. */
+  setBusinessName(value: string): void;
+  /** Submits the form. Only transitions when `isValid` is true. */
+  submit(): void;
+};
+declare function createWatchlistForBusinessManagerFromActor(actor: WatchlistForBusinessActor): Manager<WatchlistForBusinessState> & {
+  /** Transitions from `idle` to the form. Must be called before any other method. */
+  load(): void;
+  /** Updates the selected country code (ISO 3166-1 alpha-2). */
+  setCountry(country: string): void;
+  /** Updates the business name field and recomputes validity. */
+  setBusinessName(value: string): void;
+  /** Submits the form. Only transitions when `isValid` is true. */
+  submit(): void;
+};
+type WatchlistForBusinessManager = ReturnType<typeof createWatchlistForBusinessManager>;
+//#endregion
+export { createWatchlistForBusinessManager as a, WatchlistForBusinessValidationErrors as c, WatchlistForBusinessState as i, WatchlistForBusinessActor as l, WatchlistForBusinessFormState as n, createWatchlistForBusinessManagerFromActor as o, WatchlistForBusinessManager as r, WatchlistForBusinessConfig as s, WatchlistForBusinessFinishedState as t, watchlistForBusinessMachine as u };

package/dist/{watchlistForBusinessStateMachine-CxFnlshm.esm.js → watchlistForBusinessStateMachine-DEzgjz7C.esm.js}

@@ -1,5 +1,5 @@
 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-D3B9mUHh.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";
 //#region src/modules/watchlist-for-business/watchlistForBusinessServices.ts
@@ -14,6 +14,7 @@ const DEFAULT_COUNTRY = "US";
 function computeIsValid(businessName) {
 	return businessName.trim().length > 0;
 }
+const BUSINESS_NAME_REQUIRED_ERROR = "dynamicForms.fieldRequired";
 const watchlistForBusinessMachine = setup({
 	types: {
 		context: {},
@@ -33,7 +34,12 @@ const watchlistForBusinessMachine = setup({
 				businessName: value,
 				isValid: computeIsValid(value)
 			};
-		})
+		}),
+		clearBusinessNameValidationError: assign(({ context, event }) => {
+			if (event.type !== "SET_BUSINESS_NAME" || !context.validationErrors?.businessName) return {};
+			return { validationErrors: void 0 };
+		}),
+		setValidationErrors: assign(({ context }) => ({ validationErrors: computeIsValid(context.businessName) ? void 0 : { businessName: BUSINESS_NAME_REQUIRED_ERROR } }))
 	},
 	guards: { isValid: ({ context }) => context.isValid }
 }).createMachine({
@@ -42,17 +48,18 @@ const watchlistForBusinessMachine = setup({
 	context: {
 		country: DEFAULT_COUNTRY,
 		businessName: "",
-		isValid: false
+		isValid: false,
+		validationErrors: void 0
 	},
 	states: {
 		idle: { on: { LOAD: { target: "form" } } },
 		form: { on: {
 			SET_COUNTRY: { actions: "setCountry" },
-			SET_BUSINESS_NAME: { actions: "setBusinessName" },
-			SUBMIT: {
+			SET_BUSINESS_NAME: { actions: ["setBusinessName", "clearBusinessNameValidationError"] },
+			SUBMIT: [{
 				target: "submitting",
 				guard: "isValid"
-			}
+			}, { actions: "setValidationErrors" }]
 		} },
 		submitting: { invoke: {
 			id: "submitWatchlistForBusiness",

package/dist/{watchlistManager-LoNZH9qm.esm.js → watchlistManager-CI8BHFob.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 watchlistMachine } from "./watchlistStateMachine-DIKQDoUT.esm.js";
+import { t as watchlistMachine } from "./watchlistStateMachine-DvOby3a-.esm.js";
 //#region src/modules/watchlist/watchlistActor.ts
 function createWatchlistActor() {
 	return createActor(watchlistMachine).start();

package/dist/{watchlistStateMachine-DIKQDoUT.esm.js → watchlistStateMachine-DvOby3a-.esm.js}

@@ -1,5 +1,5 @@
 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-D3B9mUHh.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";
 //#region src/modules/watchlist/watchlistServices.ts

package/dist/workflow.d.ts

@@ -3,8 +3,8 @@ import { t as CallbackActorLogic } from "./callback-645_omgz.js";
 import "./StateMachine-EDpYWy0i.js";
 import { t as Manager } from "./Manager-CQQ99QOI.js";
 import { a as TotalScore, i as GetTotalScoreStatusFn, n as FinishStatus, r as GetFinishStatusFn } from "./flowCompletionService-BlAHsKyv.js";
-import { o as FlowEventSubscribable } from "./index-CLMF0QLQ.js";
-import { a as WorkflowModuleRegistry, i as RunChildModuleInput, r as RunChildModuleEvent, t as ModuleConfigMappers } from "./types-BfgmV7s72.js";
+import { o as FlowEventSubscribable } from "./index-DLcJT5YP.js";
+import { a as WorkflowModuleRegistry, i as RunChildModuleInput, r as RunChildModuleEvent, t as ModuleConfigMappers } from "./types-BfgmV7s7.js";
 //#region src/modules/workflow/types.d.ts
 /** Possible node types returned by the workflow server. */
 type WorkflowNodeType = 'MODULE' | 'FINISH' | 'ASYNC_RESOLUTION';
@@ -111,7 +111,7 @@ type WorkflowClosedState = {
 };
 type WorkflowErrorState = {
   status: 'error';
-  error: string;
+  error?: string;
   errorCode?: number;
   moduleErrorCode?: string;
 };
@@ -161,8 +161,12 @@ declare function createWorkflowManager(options?: CreateWorkflowManagerOptions):
    * `HINT_NOT_PROVIDED`) advances via `processNode`; any other error
    * transitions to the terminal error state. Callers always forward the code
    * and let core classify — no per-module branching in the UI.
+   *
+   * Omit `error` to let the UI fall back to its own generic error copy (e.g.
+   * TerminalErrorPage's `common.unexpectedError`) instead of surfacing a
+   * raw/technical string.
    */
-  errorModule(error: string, moduleErrorCode?: string): void;
+  errorModule(error?: string, moduleErrorCode?: string): void;
   /**
    * Advance from the launch (home) screen into the first workflow node.
    * No-op when the workflow is not currently waiting on the home screen
@@ -330,10 +334,6 @@ declare const workflowMachine: StateMachine<WorkflowContext, {
     id: string | undefined;
   };
 }>, Values<{
-  setError: {
-    type: "setError";
-    params: NonReducibleUnknown;
-  };
   setLoadingResult: {
     type: "setLoadingResult";
     params: NonReducibleUnknown;
@@ -366,6 +366,10 @@ declare const workflowMachine: StateMachine<WorkflowContext, {
     type: "setFinishStatusFailed";
     params: NonReducibleUnknown;
   };
+  setError: {
+    type: "setError";
+    params: NonReducibleUnknown;
+  };
   setModuleError: {
     type: "setModuleError";
     params: NonReducibleUnknown;

package/dist/workflow.esm.js

@@ -1,45 +1,46 @@
-import { E as updateFeatureManagementUser } from "./feature-management-CPQ4qv3F.esm.js";
+import { E as updateFeatureManagementUser } from "./feature-management-B0sGlozZ.esm.js";
 import { t as api } from "./api-Bx3gKW_y.esm.js";
-import { l as trueSightLog } from "./trueSightService---iW2KKJ.esm.js";
-import { n as eventModuleNames, o as createManagerInstrumentation, v as addEvent } from "./events-DYiyoSlx.esm.js";
-import { i as initializeSession, r as getSessionFingerprintResult } from "./sessionInitializer-dlfDehHk.esm.js";
-import { t as endpoints } from "./endpoints-CCzL3XD_.esm.js";
-import "./trueSight-B_icM8r2.esm.js";
-import { r as toIncodeApiError } from "./apiError-BA1d_au0.esm.js";
-import { g as toEkybConfig } from "./flowServices-f5Ruz7R9.esm.js";
+import { l as trueSightLog } from "./trueSightService-CKrrfV0Q.esm.js";
+import { n as eventModuleNames, o as createManagerInstrumentation, v as addEvent } from "./events-ijlbX_Wx.esm.js";
+import { i as initializeSession, r as getSessionFingerprintResult } from "./sessionInitializer-BLoK7SP9.esm.js";
+import { t as endpoints } from "./endpoints-D3B9mUHh.esm.js";
+import { i as toIncodeApiError } from "./apiError-D0v5hFyN.esm.js";
+import { v as toEkybConfig } from "./flowServices-B5FwukTQ.esm.js";
 import { i as toEkycConfig } from "./ekycUtils-Dew1rBG0.esm.js";
 import { i as assign, s as createActor, t as setup, u as createManager } from "./xstate.esm-BuFLFuzz.esm.js";
 import { n as fromPromise } from "./xstate-actors.esm-BXeQ-Ucz.esm.js";
-import { r as electronicSignatureMachine } from "./electronicSignatureManager-DGbAJ00W.esm.js";
+import { r as electronicSignatureMachine } from "./electronicSignatureManager-DzulxM4_.esm.js";
 import "./ae-signature.esm.js";
-import { t as antifraudMachine } from "./antifraudStateMachine-Bf_JVNwn.esm.js";
-import { t as authenticationMachine } from "./authenticationStateMachine-xzi-vnvE.esm.js";
-import { t as certificateIssuanceMachine } from "./certificateIssuanceStateMachine-D_R92TYu.esm.js";
-import { t as consentMachine } from "./consentStateMachine-D9D4ON8Z.esm.js";
-import { t as curpValidationMachine } from "./curpValidationStateMachine-Ds7KMacK.esm.js";
-import { t as customWatchlistMachine } from "./customWatchlistStateMachine-YWSgKLbF.esm.js";
-import { t as documentCaptureMachine } from "./documentCaptureStateMachine-BM4Ex_5x.esm.js";
-import { t as dynamicFormsMachine } from "./dynamicFormsStateMachine-D6D7oEYk.esm.js";
-import { t as ekybMachine } from "./ekybStateMachine-3nlnqdlr.esm.js";
-import { t as ekycMachine } from "./ekycStateMachine-CQwqiR-R.esm.js";
-import { t as emailMachine } from "./emailStateMachine-Crw8QVmc.esm.js";
-import { t as selfieMachine } from "./selfieStateMachine-CHV_WNst.esm.js";
-import { t as idCaptureMachine } from "./idCaptureStateMachine-kZ5OpdfM.esm.js";
-import { t as phoneMachine } from "./phoneStateMachine-Ba0wKHyX.esm.js";
-import { t as watchlistMachine } from "./watchlistStateMachine-DIKQDoUT.esm.js";
-import { n as identityReuseMachine } from "./identityReuseStateMachine-DyulxDjP.esm.js";
-import { t as mandatoryConsentMachine } from "./mandatoryConsentStateMachine-B4-1u-L8.esm.js";
-import { t as idOcrStateMachine } from "./idOcrStateMachine-cSxzHpHt.esm.js";
-import { n as redirectToMobileMachine } from "./redirectToMobileStateMachine-Cyv2x0PP.esm.js";
-import { t as signatureMachine } from "./signatureStateMachine-K1LMRrxG.esm.js";
-import { t as geolocationMachine } from "./geolocationStateMachine-DmbWFely.esm.js";
-import { t as idVerificationMachine } from "./idVerificationStateMachine-nPeUNyFq.esm.js";
-import { t as faceMatchMachine } from "./faceMatchStateMachine-20DdZ3jg.esm.js";
-import { n as getFinishStatus, r as getTotalScoreStatus } from "./flowCompletionService-tfeoGre9.esm.js";
-import { n as isAdvanceableError, r as attachFlowEventEmitter, t as runChildModule } from "./runChildModule-Dukuw23X.esm.js";
-import { t as governmentValidationMachine } from "./governmentValidationStateMachine-CK9DrZXX.esm.js";
+import { t as antifraudMachine } from "./antifraudStateMachine-BHxehiJZ.esm.js";
+import { t as authenticationMachine } from "./authenticationStateMachine-DJ0zUm-A.esm.js";
+import { t as certificateIssuanceMachine } from "./certificateIssuanceStateMachine-BBD5h8c4.esm.js";
+import { t as consentMachine } from "./consentStateMachine-DbUmqWgV.esm.js";
+import { t as curpValidationMachine } from "./curpValidationStateMachine-DvUPC_8S.esm.js";
+import { t as customWatchlistMachine } from "./customWatchlistStateMachine-qZVgkKgP.esm.js";
+import { t as documentCaptureMachine } from "./documentCaptureStateMachine-CWOATHfE.esm.js";
+import { t as dynamicFormsMachine } from "./dynamicFormsStateMachine-obKr4IIp.esm.js";
+import { t as ekybMachine } from "./ekybStateMachine-DjhHQXZ8.esm.js";
+import { t as ekycMachine } from "./ekycStateMachine-CmdW2gVm.esm.js";
+import { t as emailMachine } from "./emailStateMachine-CyPFZ7dW.esm.js";
+import { t as selfieMachine } from "./selfieStateMachine-fwMmNtOi.esm.js";
+import { t as idCaptureMachine } from "./idCaptureStateMachine-CmqihkUy.esm.js";
+import { t as phoneMachine } from "./phoneStateMachine-jl8LJKCo.esm.js";
+import { t as watchlistMachine } from "./watchlistStateMachine-DvOby3a-.esm.js";
+import { t as watchlistForBusinessMachine } from "./watchlistForBusinessStateMachine-DEzgjz7C.esm.js";
+import { n as identityReuseMachine } from "./identityReuseStateMachine-CQgnATo5.esm.js";
+import { t as mandatoryConsentMachine } from "./mandatoryConsentStateMachine-DSDAk7WZ.esm.js";
+import { t as idOcrStateMachine } from "./idOcrStateMachine-33UvRAHE.esm.js";
+import { n as redirectToMobileMachine } from "./redirectToMobileStateMachine-v3otpT-L.esm.js";
+import { t as signatureMachine } from "./signatureStateMachine-BHPwkJZS.esm.js";
+import { t as geolocationMachine } from "./geolocationStateMachine-DpG0TFOU.esm.js";
+import { t as governmentValidationMachine } from "./governmentValidationStateMachine-D1ZnEqdd.esm.js";
+import { t as idVerificationMachine } from "./idVerificationStateMachine-BPGrQZEm.esm.js";
+import { t as faceMatchMachine } from "./faceMatchStateMachine-BUc5FXYy.esm.js";
+import { n as getFinishStatus, r as getTotalScoreStatus } from "./flowCompletionService-CLtbWhSK.esm.js";
+import { n as attachFlowEventEmitter, t as runChildModule } from "./runChildModule-TuyGE00X.esm.js";
+import { n as isAdvanceableError } from "./advanceableErrors-CpF2cBy6.esm.js";
 import "./qe-signature.esm.js";
-import { t as watchlistForBusinessMachine } from "./watchlistForBusinessStateMachine-CxFnlshm.esm.js";
+import { t as videoSelfieFlowModuleMachine } from "./videoSelfieFlowModuleMachine-BUe2uACW.esm.js";
 //#region src/internal/orchestration/defaultModules.ts
 /**
 * Shared default module registry — single source of truth for module key → machine mappings.
@@ -81,7 +82,8 @@ const DEFAULT_MODULE_REGISTRY = {
 	INCODE_WATCHLIST: customWatchlistMachine,
 	CERTIFICATE_ISSUANCE: certificateIssuanceMachine,
 	IDENTITY_REUSE: identityReuseMachine,
-	DYNAMIC_FORMS: dynamicFormsMachine
+	DYNAMIC_FORMS: dynamicFormsMachine,
+	VIDEO_ONBOARDING: videoSelfieFlowModuleMachine
 };
 /**
 * Per-module config mappers for orchestrators (workflow / flow).
@@ -352,7 +354,10 @@ const workflowMachine = setup({
 				errorCode: code
 			};
 		}),
-		setModuleError: assign(({ event }) => ({ error: String(event.error) })),
+		setModuleError: assign(({ event }) => {
+			const rawError = event.error;
+			return { error: rawError === void 0 ? void 0 : String(rawError) };
+		}),
 		setModuleErrorCode: assign(({ event }) => ({ moduleErrorCode: event.moduleErrorCode })),
 		trackAdvanceableModuleError: ({ context, event }) => {
 			const moduleErrorCode = event.moduleErrorCode;
@@ -750,7 +755,7 @@ function mapState(snapshot) {
 	if (snapshot.matches("closed")) return { status: "closed" };
 	if (snapshot.matches("error")) return {
 		status: "error",
-		error: context.error ?? "Unknown error",
+		error: context.error,
 		errorCode: context.errorCode,
 		moduleErrorCode: context.moduleErrorCode
 	};
@@ -807,6 +812,10 @@ function createApi({ actor, getSnapshot, trackElementClicked }) {
 		* `HINT_NOT_PROVIDED`) advances via `processNode`; any other error
 		* transitions to the terminal error state. Callers always forward the code
 		* and let core classify — no per-module branching in the UI.
+		*
+		* Omit `error` to let the UI fall back to its own generic error copy (e.g.
+		* TerminalErrorPage's `common.unexpectedError`) instead of surfacing a
+		* raw/technical string.
 		*/
 		errorModule(error, moduleErrorCode) {
 			actor.send({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@incodetech/core",
-  "version": "2.2.0",
+  "version": "2.3.0-rc.0",
   "license": "ISC",
   "repository": {
     "type": "git",
@@ -140,11 +140,6 @@
       "types": "./dist/home.d.ts",
       "import": "./dist/home.esm.js"
     },
-    "./document-upload": {
-      "source": "./src/modules/document-upload/index.ts",
-      "types": "./dist/document-upload.d.ts",
-      "import": "./dist/document-upload.esm.js"
-    },
     "./document-capture": {
       "source": "./src/modules/document-capture/index.ts",
       "types": "./dist/document-capture.d.ts",
@@ -272,13 +267,12 @@
     }
   },
   "files": [
-    "dist"
+    "dist",
+    "THIRD_PARTY_NOTICES.txt"
   ],
-  "dependencies": {
-    "@zxing/browser": "0.1.5"
-  },
   "devDependencies": {
     "@vitest/coverage-v8": "4.1.10",
+    "@zxing/browser": "0.1.5",
     "tsdown": "^0.22.8",
     "typescript": "^5.9.3",
     "vitest": "4.1.10",

package/dist/BrowserStorageProvider-k-FDkC4W.esm.js

@@ -1,67 +0,0 @@
-import { t as resolveLocalStorage } from "./safeStorage-Ep56I-f_.esm.js";
-//#region ../infra/src/providers/browser/BrowserStorageProvider.ts
-/**
-* Browser-based storage provider wrapping localStorage.
-* Handles JSON serialization/deserialization automatically.
-*
-* Degrades silently when the host makes localStorage unreachable: reads return
-* `null` and writes are no-ops. Deliberately quiet — hosts that harden against
-* self-XSS by deleting the global would otherwise see a warning on every call.
-*/
-var BrowserStorageProvider = class {
-	/**
-	* Retrieves a value from localStorage.
-	* @param key - The storage key
-	* @returns The stored value, or null if not found or storage is unavailable
-	* @throws Error if stored value is invalid JSON
-	*/
-	async get(key) {
-		const storage = resolveLocalStorage();
-		if (!storage) return null;
-		try {
-			const item = storage.getItem(key);
-			if (item === null) return null;
-			return JSON.parse(item);
-		} catch (error) {
-			if (error instanceof SyntaxError) throw new Error(`Invalid JSON stored at key "${key}": ${error.message}`);
-			throw error;
-		}
-	}
-	/**
-	* Stores a value in localStorage. No-op when storage is unavailable.
-	* @param key - The storage key
-	* @param value - The value to store (will be serialized as JSON)
-	* @throws Error if value cannot be serialized or quota is exceeded
-	*/
-	async set(key, value) {
-		const storage = resolveLocalStorage();
-		if (!storage) return;
-		try {
-			const serialized = JSON.stringify(value);
-			storage.setItem(key, serialized);
-		} catch (error) {
-			if ((error instanceof DOMException || error.name === "QuotaExceededError") && error.name === "QuotaExceededError") throw new Error(`Storage quota exceeded for key "${key}"`);
-			if (error instanceof TypeError) throw new Error(`Failed to serialize value for key "${key}": ${error.message}`);
-			throw error;
-		}
-	}
-	/**
-	* Removes a value from localStorage. No-op when storage is unavailable.
-	* @param key - The storage key to remove
-	*/
-	async remove(key) {
-		const storage = resolveLocalStorage();
-		if (!storage) return;
-		storage.removeItem(key);
-	}
-	/**
-	* Clears all values from localStorage. No-op when storage is unavailable.
-	*/
-	async clear() {
-		const storage = resolveLocalStorage();
-		if (!storage) return;
-		storage.clear();
-	}
-};
-//#endregion
-export { BrowserStorageProvider as t };