@incodetech/core 2.2.0 → 2.3.0-rc.1

package/dist/flow-events.d.ts

@@ -1,2 +1,2 @@
-import { a as FlowEventListener, c as FlowModuleStartedEvent, i as FlowEvent, l as FlowReadyEvent, n as FlowCompletedEvent, o as FlowEventSubscribable, r as FlowErrorEvent, s as FlowModuleCompletedEvent, t as FlowClosedEvent, u as FlowStartedEvent } from "./index-CLMF0QLQ.js";
+import { a as FlowEventListener, c as FlowModuleStartedEvent, i as FlowEvent, l as FlowReadyEvent, n as FlowCompletedEvent, o as FlowEventSubscribable, r as FlowErrorEvent, s as FlowModuleCompletedEvent, t as FlowClosedEvent, u as FlowStartedEvent } from "./index-DLcJT5YP.js";
 export type { FlowClosedEvent, FlowCompletedEvent, FlowErrorEvent, FlowEvent, FlowEventListener, FlowEventSubscribable, FlowModuleCompletedEvent, FlowModuleStartedEvent, FlowReadyEvent, FlowStartedEvent };

package/dist/flow.d.ts

@@ -1,21 +1,207 @@
-import { n as WasmPipeline } from "./warmup-Dv2alr2-.js";
+import { c as WasmPipeline } from "./warmup-Cis2p6O0.js";
 import { A as StateMachine, _ as MachineContext, c as AnyEventObject, l as AnyStateMachine, p as EventObject, v as MetaObject, y as NonReducibleUnknown } from "./spawn-D9jgw9pW.js";
 import "./StateMachine-EDpYWy0i.js";
 import { t as Manager } from "./Manager-CQQ99QOI.js";
-import { a as ElectronicSignatureConfig } from "./types-DVmXIdzW.js";
+import { a as ElectronicSignatureConfig } from "./types-D0gekt4U.js";
 import { t as EkycConfig } from "./types-Bk_6dmDa.js";
-import { i as FlowModuleConfig, n as Flow, r as FlowModule } from "./types-KPvmag_B.js";
-import { t as AuthenticationConfig } from "./types-EELWyWpd.js";
-import { r as DocumentCaptureConfig } from "./types-DelMqZLe.js";
+import { i as FlowModuleConfig, n as Flow, r as FlowModule } from "./types-Do5rEXij.js";
+import { t as AuthenticationConfig } from "./types-ChAowIxT.js";
+import { r as DocumentCaptureConfig } from "./types-BjSly8cp.js";
 import { t as DynamicFormsConfig } from "./types-BSBzhHRH.js";
 import { t as EkybConfig } from "./types-BfHiko5D.js";
-import { c as IdCaptureConfig } from "./types-Bdf8_LYB2.js";
-import { r as MandatoryConsentConfig } from "./types-BX_XkMsQ2.js";
-import { t as IdOcrConfig } from "./types-CJ7Yl9K-2.js";
+import { u as IdCaptureConfig } from "./types-byBHOzCG2.js";
+import { r as MandatoryConsentConfig } from "./types-9_esGTPj.js";
+import { t as IdOcrConfig } from "./types-CJ7Yl9K-.js";
 import { t as RedirectToMobileConfig } from "./types-DPIDuhut.js";
 import { a as TotalScore, c as getTotalScoreStatus, n as FinishStatus, o as classifyScoreStatus, r as GetFinishStatusFn, t as FinishScreenVariant } from "./flowCompletionService-BlAHsKyv.js";
-import { o as FlowEventSubscribable } from "./index-CLMF0QLQ.js";
-import { n as ModuleRegistry } from "./types-BfgmV7s72.js";
+import { o as FlowEventSubscribable } from "./index-DLcJT5YP.js";
+import { n as ModuleRegistry } from "./types-BfgmV7s7.js";
+//#region src/modules/flow/orchestratedFlowStateMachine.d.ts
+type GetFlowFn = (signal: AbortSignal) => Promise<Flow>;
+type LazyModuleRegistry = {
+  [key: string]: (() => Promise<AnyStateMachine | {
+    default: AnyStateMachine;
+  }>) | undefined;
+};
+type OrchestratedFlowInput = {
+  getFlow: GetFlowFn;
+  modules?: ModuleRegistry;
+  lazyModules?: LazyModuleRegistry;
+  getFinishStatus?: GetFinishStatusFn;
+  enableHome?: boolean;
+  /**
+   * The flow was fetched with `getFlow(..., { deferActivation: true })`: the
+   * machine completes activation itself (feature-management flow id, then
+   * MANDATORY_CONSENT from the device fingerprint) right before the first
+   * module runs — on the Start tap when there is a home screen — so neither
+   * the flow fetch nor the home screen waits for feature-config, Statsig or
+   * the fingerprint.
+   */
+  deferActivation?: boolean;
+};
+type OrchestratedFlowEvent = {
+  type: 'LOAD';
+} | {
+  type: 'CANCEL';
+} | {
+  type: 'RESET';
+} | {
+  type: 'MODULE_COMPLETE';
+  output?: unknown;
+} | {
+  type: 'COMPLETE_FLOW';
+} | {
+  type: 'FINISH_FLOW';
+} | {
+  type: 'HOME_CONTINUE';
+} | {
+  type: '*';
+  [key: string]: unknown;
+} | {
+  type: string;
+  [key: string]: unknown;
+};
+//#endregion
+//#region src/modules/flow/orchestratedFlowManager.d.ts
+type OrchestratedFlowHomeScreen = {
+  visible: boolean;
+  isContinueLoading: boolean;
+};
+type OrchestratedFlowPresentation = {
+  isAwaitingReady: boolean;
+  lazyModuleKey: string | undefined;
+  shouldPrefetchHome: boolean;
+};
+type OrchestratedFlowIdleState = {
+  status: 'idle';
+  homeScreen: OrchestratedFlowHomeScreen;
+  presentation: OrchestratedFlowPresentation;
+};
+type OrchestratedFlowLoadingState = {
+  status: 'loading';
+  homeScreen: OrchestratedFlowHomeScreen;
+  presentation: OrchestratedFlowPresentation;
+};
+type OrchestratedFlowCompletingState = {
+  status: 'completing';
+  homeScreen: OrchestratedFlowHomeScreen;
+  presentation: OrchestratedFlowPresentation;
+};
+type OrchestratedFlowReadyState = {
+  status: 'ready';
+  flow: Flow;
+  steps: string[];
+  currentStepIndex: number;
+  currentStep: string | undefined;
+  config: unknown;
+  moduleState: unknown;
+  homeScreen: OrchestratedFlowHomeScreen;
+  presentation: OrchestratedFlowPresentation;
+};
+type OrchestratedFlowFinishedState = {
+  status: 'finished';
+  flow: Flow;
+  finishStatus: {
+    redirectionUrl: string;
+    action: 'approved' | 'rejected' | 'none';
+    scoreStatus: 'OK' | 'WARN' | 'MANUAL_OK' | 'FAIL' | 'UNKNOWN' | 'MANUAL_FAIL';
+    endScreenTitle: string | null;
+    endScreenText: string | null;
+  };
+  homeScreen: OrchestratedFlowHomeScreen;
+  presentation: OrchestratedFlowPresentation;
+};
+type OrchestratedFlowErrorState = {
+  status: 'error';
+  error?: string;
+  errorCode?: number;
+  moduleErrorCode?: string;
+  homeScreen: OrchestratedFlowHomeScreen;
+  presentation: OrchestratedFlowPresentation;
+};
+type OrchestratedFlowState = OrchestratedFlowIdleState | OrchestratedFlowLoadingState | OrchestratedFlowCompletingState | OrchestratedFlowReadyState | OrchestratedFlowFinishedState | OrchestratedFlowErrorState;
+type CreateOrchestratedFlowActorOptions = {
+  getFlow?: GetFlowFn;
+  modules?: ModuleRegistry;
+  lazyModules?: LazyModuleRegistry;
+  getFinishStatus?: OrchestratedFlowInput['getFinishStatus'];
+  enableHome?: boolean;
+  deferActivation?: OrchestratedFlowInput['deferActivation'];
+};
+declare function createOrchestratedFlowManager(options: CreateOrchestratedFlowActorOptions): Manager<OrchestratedFlowState> & {
+  /**
+   * Start loading the flow configuration from the backend.
+   */
+  load(): void;
+  /**
+   * Cancel an in-progress flow load.
+   */
+  cancel(): void;
+  /**
+   * Reset the flow to its initial idle state.
+   */
+  reset(): void;
+  /**
+   * Signal that the current module has completed successfully.
+   * Call this from your UI component's `onFinish` callback.
+   *
+   * @example
+   * ```tsx
+   * <Phone
+   *   config={config}
+   *   onFinish={() => flowManager.completeModule()}
+   * />
+   * ```
+   */
+  completeModule(output?: unknown): void;
+  /**
+   * Skip all remaining modules and complete the flow now, notifying the
+   * backend (getFinishStatus) on the way to the completion step.
+   */
+  completeFlow(): void;
+  /**
+   * Finish the flow because the onboarding was already completed externally —
+   * e.g. the REDIRECT_TO_MOBILE handoff finished end-to-end on mobile. Lands
+   * on the completion screen WITHOUT calling getFinishStatus: mobile already
+   * notified the backend, and the desktop never reached its own finish.
+   * Use this (not `completeFlow`) from REDIRECT_TO_MOBILE's `onFinish`.
+   */
+  finishFlow(): void;
+  /**
+   * Signal that the current module encountered a terminal error, optionally
+   * with its machine-readable `moduleErrorCode`. The flow machine decides what
+   * to do: an advanceable terminal error (e.g. `NONEXISTENT_CUSTOMER`,
+   * `HINT_NOT_PROVIDED`) advances to the next step; 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.
+   *
+   * @param error - Error message describing what went wrong. Omit it 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.
+   * @param moduleErrorCode - Optional machine-readable error code (a
+   *   `FaceErrorCode`) used by the flow machine to decide advance vs terminate
+   */
+  errorModule(error?: string, moduleErrorCode?: string): void;
+  /**
+   * Send a raw event to the flow state machine.
+   * Prefer using the typed methods (completeModule, errorModule) when possible.
+   */
+  send(event: OrchestratedFlowEvent): void;
+  readonly canNext: boolean;
+  getModuleConfig: <T = unknown>(moduleKey: string) => T | undefined;
+  isModuleEnabled: (moduleKey: string) => boolean;
+  isAwaitingOrchestratorReady(): boolean;
+  /**
+   * Resolve once the orchestrator has finished loading the flow and the first
+   * module is ready to render. Useful for gating an initialization spinner
+   * alongside other parallel async work (e.g. theme fetching).
+   */
+  waitForReady(): Promise<void>;
+  getLazyModuleKey(): string | undefined;
+  shouldRenderHomeScreen(): boolean;
+  continueFromHome(): Promise<void>;
+} & FlowEventSubscribable;
+//#endregion
 //#region src/modules/flow/flowUtils.d.ts
 type NormalizeFlowModulesOptions = {
   isDesktop?: boolean;
@@ -45,6 +231,12 @@ declare function enrichFlowModuleConfig(module: FlowModule, flow: Flow): Record<
  * ```
  */
 declare function getRequiredWasmPipelines(flow: Flow): WasmPipeline[];
+/**
+ * The current capture requirement, then one capture ahead once it is ready.
+ * Home never looks past its first capture, and redirects stop lookahead.
+ * @internal Used by the shared flow shell after rendering.
+ */
+declare function getNextRequiredWasmPipelines(state: Pick<OrchestratedFlowReadyState, 'flow' | 'currentStepIndex' | 'homeScreen'>, loadedPipelines?: readonly WasmPipeline[]): WasmPipeline[];
 /**
  * Normalizes flow modules by expanding TUTORIAL_ID into ID + SECOND_ID
  * based on configuration flags. Matches legacy flowService behavior.
@@ -68,6 +260,15 @@ type GetFlowOptions = {
   authHint?: string;
   lang?: string;
   useCPF?: boolean;
+  /**
+   * Return the flow as soon as it is fetched and normalized, without waiting
+   * for session activation: the Statsig `flow_id` update and the
+   * mandatory-consent injection (which rides on the device fingerprint) are
+   * left to `completeDeferredActivation`, which the caller must run before the
+   * first module starts — the orchestrated flow machine does this on the Start
+   * tap when there is a home screen, right after loading otherwise.
+   */
+  deferActivation?: boolean;
 };
 type GetFlow = (signal: AbortSignal, options?: GetFlowOptions) => Promise<Flow>;
 type DashboardResolvedModuleConfigMap = {
@@ -245,178 +446,4 @@ interface ModuleLoader {
 }
 declare function createModuleLoader(registry: ModuleLoaderRegistry): ModuleLoader;
 //#endregion
-//#region src/modules/flow/orchestratedFlowStateMachine.d.ts
-type GetFlowFn = (signal: AbortSignal) => Promise<Flow>;
-type LazyModuleRegistry = {
-  [key: string]: (() => Promise<AnyStateMachine | {
-    default: AnyStateMachine;
-  }>) | undefined;
-};
-type OrchestratedFlowInput = {
-  getFlow: GetFlowFn;
-  modules?: ModuleRegistry;
-  lazyModules?: LazyModuleRegistry;
-  getFinishStatus?: GetFinishStatusFn;
-  enableHome?: boolean;
-};
-type OrchestratedFlowEvent = {
-  type: 'LOAD';
-} | {
-  type: 'CANCEL';
-} | {
-  type: 'RESET';
-} | {
-  type: 'MODULE_COMPLETE';
-  output?: unknown;
-} | {
-  type: 'COMPLETE_FLOW';
-} | {
-  type: 'FINISH_FLOW';
-} | {
-  type: 'HOME_CONTINUE';
-} | {
-  type: '*';
-  [key: string]: unknown;
-} | {
-  type: string;
-  [key: string]: unknown;
-};
-//#endregion
-//#region src/modules/flow/orchestratedFlowManager.d.ts
-type OrchestratedFlowHomeScreen = {
-  visible: boolean;
-  isContinueLoading: boolean;
-};
-type OrchestratedFlowPresentation = {
-  isAwaitingReady: boolean;
-  lazyModuleKey: string | undefined;
-  shouldPrefetchHome: boolean;
-};
-type OrchestratedFlowIdleState = {
-  status: 'idle';
-  homeScreen: OrchestratedFlowHomeScreen;
-  presentation: OrchestratedFlowPresentation;
-};
-type OrchestratedFlowLoadingState = {
-  status: 'loading';
-  homeScreen: OrchestratedFlowHomeScreen;
-  presentation: OrchestratedFlowPresentation;
-};
-type OrchestratedFlowCompletingState = {
-  status: 'completing';
-  homeScreen: OrchestratedFlowHomeScreen;
-  presentation: OrchestratedFlowPresentation;
-};
-type OrchestratedFlowReadyState = {
-  status: 'ready';
-  flow: Flow;
-  steps: string[];
-  currentStepIndex: number;
-  currentStep: string | undefined;
-  config: unknown;
-  moduleState: unknown;
-  homeScreen: OrchestratedFlowHomeScreen;
-  presentation: OrchestratedFlowPresentation;
-};
-type OrchestratedFlowFinishedState = {
-  status: 'finished';
-  flow: Flow;
-  finishStatus: {
-    redirectionUrl: string;
-    action: 'approved' | 'rejected' | 'none';
-    scoreStatus: 'OK' | 'WARN' | 'MANUAL_OK' | 'FAIL' | 'UNKNOWN' | 'MANUAL_FAIL';
-    endScreenTitle: string | null;
-    endScreenText: string | null;
-  };
-  homeScreen: OrchestratedFlowHomeScreen;
-  presentation: OrchestratedFlowPresentation;
-};
-type OrchestratedFlowErrorState = {
-  status: 'error';
-  error: string;
-  errorCode?: number;
-  moduleErrorCode?: string;
-  homeScreen: OrchestratedFlowHomeScreen;
-  presentation: OrchestratedFlowPresentation;
-};
-type OrchestratedFlowState = OrchestratedFlowIdleState | OrchestratedFlowLoadingState | OrchestratedFlowCompletingState | OrchestratedFlowReadyState | OrchestratedFlowFinishedState | OrchestratedFlowErrorState;
-type CreateOrchestratedFlowActorOptions = {
-  getFlow?: GetFlowFn;
-  modules?: ModuleRegistry;
-  lazyModules?: LazyModuleRegistry;
-  getFinishStatus?: OrchestratedFlowInput['getFinishStatus'];
-  enableHome?: boolean;
-};
-declare function createOrchestratedFlowManager(options: CreateOrchestratedFlowActorOptions): Manager<OrchestratedFlowState> & {
-  /**
-   * Start loading the flow configuration from the backend.
-   */
-  load(): void;
-  /**
-   * Cancel an in-progress flow load.
-   */
-  cancel(): void;
-  /**
-   * Reset the flow to its initial idle state.
-   */
-  reset(): void;
-  /**
-   * Signal that the current module has completed successfully.
-   * Call this from your UI component's `onFinish` callback.
-   *
-   * @example
-   * ```tsx
-   * <Phone
-   *   config={config}
-   *   onFinish={() => flowManager.completeModule()}
-   * />
-   * ```
-   */
-  completeModule(output?: unknown): void;
-  /**
-   * Skip all remaining modules and complete the flow now, notifying the
-   * backend (getFinishStatus) on the way to the completion step.
-   */
-  completeFlow(): void;
-  /**
-   * Finish the flow because the onboarding was already completed externally —
-   * e.g. the REDIRECT_TO_MOBILE handoff finished end-to-end on mobile. Lands
-   * on the completion screen WITHOUT calling getFinishStatus: mobile already
-   * notified the backend, and the desktop never reached its own finish.
-   * Use this (not `completeFlow`) from REDIRECT_TO_MOBILE's `onFinish`.
-   */
-  finishFlow(): void;
-  /**
-   * Signal that the current module encountered a terminal error, optionally
-   * with its machine-readable `moduleErrorCode`. The flow machine decides what
-   * to do: an advanceable terminal error (e.g. `NONEXISTENT_CUSTOMER`,
-   * `HINT_NOT_PROVIDED`) advances to the next step; 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.
-   *
-   * @param error - Error message describing what went wrong
-   * @param moduleErrorCode - Optional machine-readable error code (a
-   *   `FaceErrorCode`) used by the flow machine to decide advance vs terminate
-   */
-  errorModule(error: string, moduleErrorCode?: string): void;
-  /**
-   * Send a raw event to the flow state machine.
-   * Prefer using the typed methods (completeModule, errorModule) when possible.
-   */
-  send(event: OrchestratedFlowEvent): void;
-  readonly canNext: boolean;
-  getModuleConfig: <T = unknown>(moduleKey: string) => T | undefined;
-  isModuleEnabled: (moduleKey: string) => boolean;
-  isAwaitingOrchestratorReady(): boolean;
-  /**
-   * Resolve once the orchestrator has finished loading the flow and the first
-   * module is ready to render. Useful for gating an initialization spinner
-   * alongside other parallel async work (e.g. theme fetching).
-   */
-  waitForReady(): Promise<void>;
-  getLazyModuleKey(): string | undefined;
-  shouldRenderHomeScreen(): boolean;
-  continueFromHome(): Promise<void>;
-} & FlowEventSubscribable;
-//#endregion
-export { type DeepPartial, type FinishScreenVariant, type FinishStatus, type Flow, type FlowModule, type FlowModuleConfig, type FlowReadyState, type FlowState, type LazyModule, type LazyModuleRegistry, type ModuleLoader, type ModuleLoaderRegistry, type ModuleRegistry, type OrchestratedFlowCompletingState, type OrchestratedFlowFinishedState, type OrchestratedFlowHomeScreen, type OrchestratedFlowInput, type OrchestratedFlowPresentation, type OrchestratedFlowReadyState, type OrchestratedFlowState, type ResolveDashboardModuleConfigOptions, type ResolvedDashboardModuleConfig, type TotalScore, classifyScoreStatus, createFlowManager, createModuleLoader, createOrchestratedFlowManager, enrichFlowModuleConfig, getFlow, getRequiredWasmPipelines, getTotalScoreStatus, mergeDashboardConfig, noOpFlowModuleMachine, normalizeFlowModules, preloadDashboardFlow, resolveDashboardModuleConfig };
+export { type DeepPartial, type FinishScreenVariant, type FinishStatus, type Flow, type FlowModule, type FlowModuleConfig, type FlowReadyState, type FlowState, type LazyModule, type LazyModuleRegistry, type ModuleLoader, type ModuleLoaderRegistry, type ModuleRegistry, type OrchestratedFlowCompletingState, type OrchestratedFlowFinishedState, type OrchestratedFlowHomeScreen, type OrchestratedFlowInput, type OrchestratedFlowPresentation, type OrchestratedFlowReadyState, type OrchestratedFlowState, type ResolveDashboardModuleConfigOptions, type ResolvedDashboardModuleConfig, type TotalScore, classifyScoreStatus, createFlowManager, createModuleLoader, createOrchestratedFlowManager, enrichFlowModuleConfig, getFlow, getNextRequiredWasmPipelines, getRequiredWasmPipelines, getTotalScoreStatus, mergeDashboardConfig, noOpFlowModuleMachine, normalizeFlowModules, preloadDashboardFlow, resolveDashboardModuleConfig };