@incodetech/core 2.3.2 → 2.4.0-rc.0

package/dist/workflow.d.ts

@@ -1,10 +1,9 @@
 import { A as StateMachine, C as StateValue, D as PromiseActorLogic, a as ActorRefFromLogic, b as RequiredActorOptions, c as AnyEventObject, g as IsNotNever, h as InputFrom, k as MachineSnapshot, l as AnyStateMachine, m as GetConcreteByKey, o as AnyActorLogic, p as EventObject, r as ActorRef, s as AnyActorRef, u as ConditionalRequired, v as MetaObject, w as Values, x as RequiredLogicInput, y as NonReducibleUnknown } from "./spawn-D9jgw9pW.js";
 import { t as CallbackActorLogic } from "./callback-645_omgz.js";
-import "./StateMachine-EDpYWy0i.js";
-import { t as Manager } from "./Manager-CQQ99QOI.js";
+import { t as Manager } from "./Manager-C9T5amUN.js";
 import { a as TotalScore, i as GetTotalScoreStatusFn, n as FinishStatus, r as GetFinishStatusFn } from "./flowCompletionService-BlAHsKyv.js";
-import { o as FlowEventSubscribable } from "./index-CeaC32qI.js";
-import { a as WorkflowModuleRegistry, i as RunChildModuleInput, r as RunChildModuleEvent, t as ModuleConfigMappers } from "./types-BfgmV7s7.js";
+import { o as FlowEventSubscribable } from "./index-DfEuu-Ew.js";
+import { a as WorkflowModuleRegistry, i as RunChildModuleInput, r as RunChildModuleEvent, t as ModuleConfigMappers } from "./types-BQA7lRDV.js";
 //#region src/modules/workflow/types.d.ts
 /** Possible node types returned by the workflow server. */
 type WorkflowNodeType = 'MODULE' | 'FINISH' | 'ASYNC_RESOLUTION';
@@ -82,6 +81,12 @@ type WorkflowIdleState = {
 type WorkflowLoadingState = {
   status: 'loading';
   homeScreen: WorkflowHomeScreen;
+  /**
+   * Set once the workflow config has loaded, so the UI can apply server flags
+   * (e.g. `disableUnsupportedBrowserScreen`) before the first module, including
+   * while the home screen shows.
+   */
+  workflowConfig?: WorkflowConfig;
 };
 type WorkflowCompletingState = {
   status: 'completing';
@@ -123,6 +128,19 @@ type CreateWorkflowManagerOptions = {
   interviewId?: string;
   /** Whether the device is a desktop. Determines desktop-to-mobile redirect injection. Defaults to true. */
   isDesktop?: boolean;
+  /**
+   * Set when mounting on the return leg of a full-page redirect a module
+   * started, such as the digital-ID bank redirect. Skips the launch screen and
+   * the desktop-to-mobile handoff, which the user already went through before
+   * leaving, so the workflow resumes on its current node. Defaults to false.
+   */
+  isReturnLeg?: boolean;
+  /**
+   * Override for the finish-status fetch. Lets a caller overlay values the
+   * `/omni/finish-status` response never carries (e.g. the dashboard-configured
+   * `endScreenTitle`/`endScreenText`, only available from `POST /omni/start`).
+   */
+  getFinishStatus?: GetFinishStatusFn;
 };
 /**
  * Creates a workflow manager for server-driven onboarding flows.
@@ -251,6 +269,8 @@ type WorkflowContext = {
   isInjectedNode: boolean;
   isHomeContinueLoading: boolean;
   hasShownHome: boolean;
+  /** See `WorkflowInput.isReturnLeg`. */
+  isReturnLeg: boolean;
   getFinishStatus: GetFinishStatusFn;
   getTotalScoreStatus: GetTotalScoreStatusFn;
 };
@@ -269,6 +289,14 @@ type WorkflowInput = {
   interviewId?: string;
   /** Whether the device is a desktop. Determines desktop-to-mobile redirect injection. Defaults to true. */
   isDesktop?: boolean;
+  /**
+   * The host re-mounted this workflow on the return leg of a full-page
+   * redirect a module started (today: the digital-ID bank redirect). The user
+   * already went through the pre-node screens before leaving, so the launch
+   * screen and the desktop-to-mobile handoff are not shown again and the
+   * workflow lands straight on its current node. Defaults to false.
+   */
+  isReturnLeg?: boolean;
 };
 declare const workflowMachine: StateMachine<WorkflowContext, {
   type: "LOAD";
@@ -662,7 +690,8 @@ declare const workflowMachine: StateMachine<WorkflowContext, {
     isDesktop: boolean;
     isInjectedNode: false;
     isHomeContinueLoading: false;
-    hasShownHome: false;
+    hasShownHome: boolean;
+    isReturnLeg: boolean;
     getFinishStatus: GetFinishStatusFn;
     getTotalScoreStatus: GetTotalScoreStatusFn;
   };

package/dist/workflow.esm.js

@@ -1,46 +1,46 @@
-import { l as trueSightLog } from "./trueSightService-M5VpCo96.esm.js";
-import { E as updateFeatureManagementUser } from "./feature-management-C8CuN0os.esm.js";
+import { l as trueSightLog } from "./trueSightService-BWgRVGIT.esm.js";
+import { n as eventModuleNames, o as createManagerInstrumentation, v as addEvent } from "./events-CAgFE-k3.esm.js";
 import { t as api } from "./api-Bx3gKW_y.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-CnhAkMUN.esm.js";
-import { t as endpoints } from "./endpoints-B-3Q-LUw.esm.js";
-import { i as toIncodeApiError } from "./apiError-CmGEmaGU.esm.js";
-import { v as toEkybConfig } from "./flowServices-CdsWsppG.esm.js";
-import { i as toEkycConfig } from "./ekycUtils-D6wfSpPN.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-yYUc30na.esm.js";
+import { t as endpoints } from "./endpoints-DHzlkQNe.esm.js";
+import { i as initializeSession, r as getSessionFingerprintResult } from "./sessionInitializer-jxbfCnE-.esm.js";
+import { E as updateFeatureManagementUser } from "./feature-management-BTbYruNe.esm.js";
+import { i as toIncodeApiError } from "./apiError-DcSWedC6.esm.js";
+import { v as toEkybConfig } from "./flowServices-DA64AEZC.esm.js";
+import { a as toEkycConfig } from "./ekycUtils-zY8CdKJL.esm.js";
+import { i as assign, s as createActor, t as setup, u as createManager } from "./xstate.esm-DSajW7CJ.esm.js";
+import { n as fromPromise } from "./xstate-actors.esm-8Gzepa_A.esm.js";
+import { r as electronicSignatureMachine } from "./electronicSignatureManager-Bc8spG8p.esm.js";
 import "./ae-signature.esm.js";
-import { t as antifraudMachine } from "./antifraudStateMachine-DBeq47D2.esm.js";
-import { t as authenticationMachine } from "./authenticationStateMachine-Dfo34ZiI.esm.js";
-import { t as certificateIssuanceMachine } from "./certificateIssuanceStateMachine-CxqS_nD-.esm.js";
-import { t as consentMachine } from "./consentStateMachine-DTSfdGiW.esm.js";
-import { t as curpValidationMachine } from "./curpValidationStateMachine-g5kMfuLj.esm.js";
-import { t as customWatchlistMachine } from "./customWatchlistStateMachine-DOQou6TW.esm.js";
-import { t as documentCaptureMachine } from "./documentCaptureStateMachine-D312sSIu.esm.js";
-import { t as dynamicFormsMachine } from "./dynamicFormsStateMachine-DGI_F2PP.esm.js";
-import { t as ekybMachine } from "./ekybStateMachine-D1IJ1Z72.esm.js";
-import { t as ekycMachine } from "./ekycStateMachine-UeJRO8_p.esm.js";
-import { t as emailMachine } from "./emailStateMachine-Bc_6oIYw.esm.js";
-import { t as selfieMachine } from "./selfieStateMachine-DY7vJVNY.esm.js";
-import { t as idCaptureMachine } from "./idCaptureStateMachine-BbiZD3uf.esm.js";
-import { t as phoneMachine } from "./phoneStateMachine-CXdXufKg.esm.js";
-import { t as watchlistMachine } from "./watchlistStateMachine-CBqk2w-h.esm.js";
-import { t as watchlistForBusinessMachine } from "./watchlistForBusinessStateMachine-CJ-MvUre.esm.js";
-import { n as identityReuseMachine } from "./identityReuseStateMachine-BhAkuIra.esm.js";
-import { t as mandatoryConsentMachine } from "./mandatoryConsentStateMachine-DC5Mo6M1.esm.js";
-import { t as idOcrStateMachine } from "./idOcrStateMachine-Bt_abXQQ.esm.js";
-import { n as redirectToMobileMachine } from "./redirectToMobileStateMachine-CSWWgUTO.esm.js";
-import { t as signatureMachine } from "./signatureStateMachine-ce_XMA3l.esm.js";
-import { t as geolocationMachine } from "./geolocationStateMachine-CdEb1Gn0.esm.js";
-import { t as governmentValidationMachine } from "./governmentValidationStateMachine-CoaZOSTP.esm.js";
-import { t as idVerificationMachine } from "./idVerificationStateMachine-DbDVIh9t.esm.js";
-import { t as faceMatchMachine } from "./faceMatchStateMachine-mRIHQ3dA.esm.js";
-import { n as getFinishStatus, r as getTotalScoreStatus } from "./flowCompletionService-DccgtDnm.esm.js";
-import { n as attachFlowEventEmitter, t as runChildModule } from "./runChildModule-B2Y_hlix.esm.js";
-import { n as isAdvanceableError } from "./advanceableErrors-CpF2cBy6.esm.js";
+import { t as antifraudMachine } from "./antifraudStateMachine-DoJVzblM.esm.js";
+import { t as authenticationMachine } from "./authenticationStateMachine-CHSxmV7z.esm.js";
+import { t as certificateIssuanceMachine } from "./certificateIssuanceStateMachine-Cs64QmYH.esm.js";
+import { t as consentMachine } from "./consentStateMachine-BCj5Jb3g.esm.js";
+import { t as curpValidationMachine } from "./curpValidationStateMachine-DAxImy8p.esm.js";
+import { t as customWatchlistMachine } from "./customWatchlistStateMachine-D9gI5uu7.esm.js";
+import { t as documentCaptureMachine } from "./documentCaptureStateMachine-BHDsCfhL.esm.js";
+import { t as dynamicFormsMachine } from "./dynamicFormsStateMachine-DQmok084.esm.js";
+import { t as ekybMachine } from "./ekybStateMachine-hstiCNmW.esm.js";
+import { t as ekycMachine } from "./ekycStateMachine-x6Klot8g.esm.js";
+import { t as emailMachine } from "./emailStateMachine-5Neq3rE5.esm.js";
+import { t as selfieMachine } from "./selfieStateMachine-BhfKsl3I.esm.js";
+import { t as idCaptureMachine } from "./idCaptureStateMachine-PJt0yzom.esm.js";
+import { t as phoneMachine } from "./phoneStateMachine-CEm2y7yG.esm.js";
+import { t as watchlistMachine } from "./watchlistStateMachine-Dgfm42w2.esm.js";
+import { t as watchlistForBusinessMachine } from "./watchlistForBusinessStateMachine-121XK-Et.esm.js";
+import { n as identityReuseMachine } from "./identityReuseStateMachine-BrBUpfn5.esm.js";
+import { t as mandatoryConsentMachine } from "./mandatoryConsentStateMachine-CoaSB7P7.esm.js";
+import { t as idOcrStateMachine } from "./idOcrStateMachine-kPn7DB2I.esm.js";
+import { n as redirectToMobileMachine } from "./redirectToMobileStateMachine--Sr9NEVT.esm.js";
+import { t as signatureMachine } from "./signatureStateMachine-BkRSrkKp.esm.js";
+import { t as geolocationMachine } from "./geolocationStateMachine-D-cQi7ar.esm.js";
+import { t as governmentValidationMachine } from "./governmentValidationStateMachine-C3YQ8yCZ.esm.js";
+import { t as idVerificationMachine } from "./idVerificationStateMachine-0HTVVxse.esm.js";
+import { t as faceMatchMachine } from "./faceMatchStateMachine-B9ZUnlyU.esm.js";
+import { n as getFinishStatus, r as getTotalScoreStatus } from "./flowCompletionService-xnn_SlJU.esm.js";
+import { n as attachFlowEventEmitter, t as runChildModule } from "./runChildModule-vdxQMCmO.esm.js";
+import { n as isAdvanceableError } from "./advanceableErrors-q_pfU3Cn.esm.js";
 import "./qe-signature.esm.js";
-import { t as videoSelfieFlowModuleMachine } from "./videoSelfieFlowModuleMachine-BUe2uACW.esm.js";
+import { t as videoSelfieFlowModuleMachine } from "./videoSelfieFlowModuleMachine-BCFVHBQ1.esm.js";
 //#region src/internal/orchestration/defaultModules.ts
 /**
 * Shared default module registry — single source of truth for module key → machine mappings.
@@ -289,6 +289,10 @@ async function resolveModule(input) {
 * consumers and the UI see the same config.
 */
 function applyWorkflowNodeOverlays(moduleKey, config, skipFaceMatch) {
+	if (moduleKey === "ID_CAPTURE" || moduleKey === "TUTORIAL_ID") return {
+		...config,
+		isSecondId: config.isSecondId === true || config.idRank === "SECOND_ID"
+	};
 	if (moduleKey === "SELFIE") return {
 		...config,
 		skipProcessFace: true
@@ -301,6 +305,14 @@ function applyWorkflowNodeOverlays(moduleKey, config, skipFaceMatch) {
 }
 //#endregion
 //#region src/modules/workflow/workflowStateMachine.ts
+/**
+* Whether the desktop-to-mobile handoff may be injected. It is a pre-node
+* step, so on a return leg the user has already been through it: a desktop
+* return only exists when they chose to continue on desktop.
+*/
+function canOfferDeviceHandoff(context) {
+	return context.isDesktop && !context.isReturnLeg;
+}
 function extractErrorInfo(err) {
 	const error = err;
 	return {
@@ -458,7 +470,8 @@ const workflowMachine = setup({
 		isDesktop: input.isDesktop ?? true,
 		isInjectedNode: false,
 		isHomeContinueLoading: false,
-		hasShownHome: false,
+		hasShownHome: input.isReturnLeg ?? false,
+		isReturnLeg: input.isReturnLeg ?? false,
 		getFinishStatus: input.getFinishStatus ?? getFinishStatus,
 		getTotalScoreStatus: input.getTotalScoreStatus ?? getTotalScoreStatus
 	}),
@@ -467,7 +480,7 @@ const workflowMachine = setup({
 		loading: { invoke: {
 			id: "loadWorkflow",
 			src: "loadWorkflow",
-			input: ({ context }) => ({ isDesktop: context.isDesktop }),
+			input: ({ context }) => ({ isDesktop: canOfferDeviceHandoff(context) }),
 			onDone: [
 				{
 					target: "home",
@@ -613,7 +626,7 @@ const workflowMachine = setup({
 				workflowDisableSmsOption: context.workflowConfig?.disableSmsOption ?? false,
 				workflowAddContinueToDesktop: context.workflowConfig?.addContinueToDesktop ?? false,
 				workflowQrPhishingResistance: context.workflowConfig?.qrPhishingResistance ?? false,
-				isDesktop: context.isDesktop
+				isDesktop: canOfferDeviceHandoff(context)
 			}),
 			onDone: [
 				{
@@ -683,7 +696,9 @@ function createWorkflowActor(options) {
 		configMappers: options.configMappers,
 		customModuleCallback: options.customModuleCallback,
 		interviewId: options.interviewId,
-		isDesktop: options.isDesktop
+		isDesktop: options.isDesktop,
+		isReturnLeg: options.isReturnLeg,
+		getFinishStatus: options.getFinishStatus
 	} }).start();
 }
 //#endregion
@@ -776,7 +791,8 @@ function mapState(snapshot) {
 	};
 	return {
 		status: "loading",
-		homeScreen
+		homeScreen,
+		workflowConfig: context.workflowConfig
 	};
 }
 function createApi({ actor, getSnapshot, trackElementClicked }) {
@@ -873,7 +889,9 @@ function createWorkflowManager(options = {}) {
 			configMappers: DEFAULT_MODULE_CONFIG_MAPPERS,
 			customModuleCallback: options.customModuleCallback,
 			interviewId: options.interviewId,
-			isDesktop: options.isDesktop
+			isDesktop: options.isDesktop,
+			isReturnLeg: options.isReturnLeg,
+			getFinishStatus: options.getFinishStatus
 		}),
 		mapState,
 		createApi,

package/dist/{xstate-actors.esm-BXeQ-Ucz.esm.js → xstate-actors.esm-8Gzepa_A.esm.js}

@@ -1,4 +1,4 @@
-import { a as XSTATE_STOP } from "./xstate.esm-BuFLFuzz.esm.js";
+import { a as XSTATE_STOP } from "./xstate.esm-DSajW7CJ.esm.js";
 const instanceStates = /* #__PURE__ */ new WeakMap();
 /**
 * Represents an actor created by `fromCallback`.

package/dist/{xstate.esm-BuFLFuzz.esm.js → xstate.esm-DSajW7CJ.esm.js}

@@ -45,20 +45,21 @@ function createManager(options) {
 		return () => subscription.unsubscribe();
 	}
 	let currentScreenName = instrumentation?.getScreenName(getSnapshot());
+	let currentStateName = instrumentation?.getStateName?.(getSnapshot());
 	let currentErrorName = instrumentation?.getErrorName(getSnapshot());
 	let currentErrorPayload = instrumentation?.getErrorPayload(getSnapshot());
 	const api = createApi({
 		actor,
 		getSnapshot,
 		trackElementClicked: instrumentation ? (elementName, payload) => {
-			instrumentation.onElementClicked?.(instrumentation.moduleName, currentScreenName, {
+			instrumentation.onElementClicked?.(instrumentation.moduleName, currentStateName ?? currentScreenName, {
 				element: elementName,
 				action: payload?.action,
 				metadata: payload?.metadata
 			});
 		} : void 0,
 		trackCaptureAttemptFinished: instrumentation ? (payload) => {
-			instrumentation.onCaptureAttemptFinished?.(instrumentation.moduleName, currentScreenName, { logs: payload.logs });
+			instrumentation.onCaptureAttemptFinished?.(instrumentation.moduleName, currentStateName ?? currentScreenName, { logs: payload.logs });
 		} : void 0
 	});
 	instrumentation?.onModuleOpened(instrumentation.moduleName);
@@ -76,7 +77,11 @@ function createManager(options) {
 		const nextScreenName = instrumentation.getScreenName(snapshot);
 		const nextErrorName = instrumentation.getErrorName(snapshot);
 		const nextErrorPayload = instrumentation.getErrorPayload(snapshot);
+		const nextStateName = instrumentation.getStateName?.(snapshot);
 		if (currentScreenName === nextScreenName) {
+			const previousStateName = currentStateName;
+			currentStateName = nextStateName;
+			if (currentScreenName !== void 0 && nextStateName !== void 0 && nextStateName !== previousStateName) instrumentation.onStateChanged?.(instrumentation.moduleName, currentScreenName, nextStateName);
 			if (nextErrorName !== void 0 && nextErrorName !== currentErrorName) instrumentation.onErrorTriggered(instrumentation.moduleName, nextErrorName, currentScreenName, nextErrorPayload);
 			currentErrorName = nextErrorName;
 			currentErrorPayload = nextErrorPayload;
@@ -85,6 +90,7 @@ function createManager(options) {
 		if (currentScreenName !== void 0) instrumentation.onScreenClosed(instrumentation.moduleName, currentScreenName);
 		if (nextScreenName !== void 0) instrumentation.onScreenOpened(instrumentation.moduleName, nextScreenName);
 		currentScreenName = nextScreenName;
+		currentStateName = nextStateName;
 		if (nextErrorName !== void 0 && nextErrorName !== currentErrorName) instrumentation.onErrorTriggered(instrumentation.moduleName, nextErrorName, nextScreenName, nextErrorPayload);
 		currentErrorName = nextErrorName;
 		currentErrorPayload = nextErrorPayload;
@@ -96,14 +102,22 @@ function createManager(options) {
 		stop() {
 			if (isStopped) return;
 			isStopped = true;
-			actorSubscription?.unsubscribe();
-			stopVisibility?.();
-			if (instrumentation && currentScreenName !== void 0) instrumentation.onScreenClosed(instrumentation.moduleName, currentScreenName);
-			currentScreenName = void 0;
-			currentErrorName = void 0;
-			currentErrorPayload = void 0;
-			instrumentation?.onModuleClosed(instrumentation.moduleName);
-			actor.stop();
+			try {
+				if (actor.getSnapshot().status === "active") options.beforeStop?.();
+			} finally {
+				try {
+					actorSubscription?.unsubscribe();
+					stopVisibility?.();
+					if (instrumentation && currentScreenName !== void 0) instrumentation.onScreenClosed(instrumentation.moduleName, currentScreenName);
+					currentScreenName = void 0;
+					currentStateName = void 0;
+					currentErrorName = void 0;
+					currentErrorPayload = void 0;
+					instrumentation?.onModuleClosed(instrumentation.moduleName);
+				} finally {
+					actor.stop();
+				}
+			}
 		}
 	}, Object.getOwnPropertyDescriptors(api));
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@incodetech/core",
-  "version": "2.3.2",
+  "version": "2.4.0-rc.0",
   "license": "ISC",
   "repository": {
     "type": "git",
@@ -60,6 +60,11 @@
       "types": "./dist/phone.d.ts",
       "import": "./dist/phone.esm.js"
     },
+    "./phone-number": {
+      "source": "./src/modules/phone-number/index.ts",
+      "types": "./dist/phone-number.d.ts",
+      "import": "./dist/phone-number.esm.js"
+    },
     "./email": {
       "source": "./src/modules/email/index.ts",
       "types": "./dist/email.d.ts",
@@ -267,23 +272,26 @@
   ],
   "devDependencies": {
     "@vitest/coverage-v8": "4.1.10",
-    "@zxing/browser": "0.1.5",
+    "@zxing/library": "0.21.3",
     "tsdown": "^0.22.8",
     "typescript": "^5.9.3",
     "vitest": "4.1.10",
+    "@incodetech/form-definitions": "0.0.0",
     "@incodetech/config": "1.0.2",
     "@incodetech/infra": "1.4.0"
   },
   "scripts": {
-    "build": "tsdown -c tsdown.config.ts",
-    "build:cdn": "tsdown -c tsdown.config.ts --minify",
+    "build": "tsdown -c tsdown.config.ts && pnpm check:dist-types",
+    "build:cdn": "tsdown -c tsdown.config.ts --minify && pnpm check:dist-types",
     "build:dev": "tsdown -c tsdown.config.ts",
+    "check:dist-types": "tsgo -p tsconfig.dist-types.json",
     "test": "vitest run",
     "coverage": "vitest run --coverage",
     "lint": "eslint .",
     "lint:fix": "eslint . --fix",
     "format": "prettier --write . --ignore-path ../../.prettierignore",
     "format:check": "prettier --check . --ignore-path ../../.prettierignore",
-    "typecheck": "tsgo -p tsconfig.json --noEmit"
+    "typecheck": "tsgo -p tsconfig.json --noEmit",
+    "parity:record": "PARITY_RECORD=1 vitest run __parity__"
   }
 }

package/dist/Actor-iTq7YY48.d.ts

@@ -1 +0,0 @@
-import "./StateMachine-EDpYWy0i.js";

package/dist/StateMachine-EDpYWy0i.d.ts

@@ -1,6 +0,0 @@
-//#region ../../node_modules/.pnpm/xstate@5.24.0/node_modules/xstate/dist/declarations/src/index.d.ts
-declare global {
-  interface SymbolConstructor {
-    readonly observable: symbol;
-  }
-}