@incodetech/core 2.1.1 → 2.2.0-rc.0

package/dist/feature-management.d.ts

@@ -0,0 +1,173 @@
+import { a as FeatureManagementParameterStore, c as FeatureManagementRedactedUserInfo, i as FeatureManagementLayer, l as FeatureManagementUserUpdate, n as FeatureManagementExperiment, o as FeatureManagementParameterStoreEvaluationOptions, r as FeatureManagementGate, s as FeatureManagementReadStatus, t as FeatureManagementEventMetadata } from "./IFeatureManagementCapability-DdEUp6tB.js";
+//#region src/integrations/feature-management/featureManagement.d.ts
+/**
+ * Name of the shared Statsig parameter store fronting SDK-module
+ * experiments that need mutual exclusion. Callers read only this store via
+ * {@link getFeatureParameterStore} (or the UI's `useFeatureManagement`) —
+ * each param is wired, in the Statsig console, to a Layer's param, which in
+ * turn delegates to the individual Experiment; the Layer guarantees at most
+ * one experiment sharing it is ever allocated for a given user, so callers
+ * reading different experiments from different surfaces don't need to
+ * coordinate that themselves. See the ID module's `useIdExperiment`
+ * (`packages/ui/src/modules/id/experiments/`) for the reference
+ * integration.
+ */
+declare const ONBOARDING_WEB_SDK_PARAMETER_STORE = "onboarding_web_sdk_ps";
+/**
+ * Subscribes to changes in the FeatureManagement user identity (readiness
+ * settling, `updateFeatureManagementUser`, or `resetFeatureManagement`).
+ * Returns an unsubscribe function. Intended for UI to re-read
+ * gates/experiments/layers whenever the shared identity changes, no matter
+ * which caller triggered the change — see `getFeatureManagementVersion`.
+ */
+declare function subscribeFeatureManagement(listener: () => void): () => void;
+/**
+ * Monotonically increasing revision of the FeatureManagement user identity.
+ * Pair with {@link subscribeFeatureManagement} (e.g. via
+ * `useSyncExternalStore`) to force a re-read after any identity change.
+ * The number itself carries no meaning beyond "has this changed since my
+ * last read".
+ */
+declare function getFeatureManagementVersion(): number;
+/**
+ * Resolves once feature-management boot for the current SDK lifecycle has
+ * settled.
+ */
+declare function getIsFeatureManagementInitialized(): Promise<boolean>;
+/**
+ * Merges additional randomization-unit custom IDs (and, optionally,
+ * analytics/targeting-only `custom` attributes) into the active
+ * FeatureManagement user and re-evaluates.
+ *
+ * `flow_id` is populated from the flow response before `getFlow` resolves;
+ * `workflow_id` is populated from the workflow configuration before
+ * `loadWorkflow` resolves. `custom` lets callers enrich identity with
+ * attributes discovered later in the session (e.g. a backend-driven flag)
+ * without needing a randomization unit — unlike `customIDs`, `custom`
+ * values never bucket experiments, only affect targeting conditions and
+ * event annotation.
+ *
+ * `undefined` values in `customIDs` are dropped before merging — they mean
+ * "not yet known", never "clear this ID". No-op when every `customIDs`
+ * value is `undefined` and no `custom` is supplied, or when
+ * `initializeFeatureManagement` was never called (or failed).
+ */
+declare function updateFeatureManagementUser(update: FeatureManagementUserUpdate): Promise<void>;
+/** Evaluates a feature gate. Returns a fallback-only result before initialization. */
+declare function getFeatureGate(name: string): FeatureManagementGate;
+/** Evaluates an experiment. Returns a fallback-only result before initialization. */
+declare function getExperiment(name: string): FeatureManagementExperiment;
+/** Evaluates a layer. Returns a fallback-only result before initialization. Exposure is logged natively per-parameter on `.get()`. */
+declare function getLayer(name: string): FeatureManagementLayer;
+/** Evaluates a parameter store. Returns a fallback-only result before initialization. Exposure is logged natively for the mapped source on `.get()`. */
+declare function getFeatureParameterStore(name: string, options?: FeatureManagementParameterStoreEvaluationOptions): FeatureManagementParameterStore;
+/** Evaluates a dynamic config. Returns `null` before initialization or if the config is unknown. */
+declare function getFeatureDynamicConfig(name: string): Record<string, unknown> | null;
+/**
+ * Logs a custom analytics event to the FeatureManagement provider. No-op
+ * before initialization.
+ *
+ * `type: 'scheduled'` (default) batches the event with the underlying
+ * SDK's normal flush cadence. `type: 'immediate'` logs then flushes right
+ * away — use for events that must reach the backend even if the page is
+ * about to unload (e.g. a one-time experiment-assignment event).
+ */
+declare function logEvent(name: string, value?: string | number, options?: {
+  metadata?: FeatureManagementEventMetadata;
+  type?: 'scheduled' | 'immediate';
+}): void;
+//#endregion
+//#region src/integrations/feature-management/experiments.d.ts
+/** Statsig object payload for a v1 experiment param. */
+type ExperimentTransportV1 = {
+  schema: 'v1';
+  status: 'ongoing' | 'completed' | 'not_allocated';
+  arm: string;
+  flagKey: string;
+  experimentId: string;
+  experimentName: string;
+  params: Record<string, unknown>;
+};
+type ExperimentSpec<P> = {
+  storeParam: string;
+  defaults: P;
+  parseParams(raw: Record<string, unknown>): Partial<P> | null;
+};
+type ExperimentAssignedPayload = {
+  flagKey: string;
+  experimentId: string;
+  experimentName: string;
+  variant: string;
+  conditions?: Record<string, boolean | number | string>;
+};
+type ResolvedExperiment<P> = {
+  params: P;
+  /** Null when not reportable: notAllocated, shipped, unavailable, or gate off. */
+  assignment: ExperimentAssignedPayload | null;
+};
+type ResolveExperimentOptions = {
+  /** When omitted, a fresh store read is performed with exposure suppressed. */
+  store?: FeatureManagementParameterStore;
+};
+/**
+ * Non-null fallback compared by reference. A `null` code fallback disables
+ * Statsig validation; this sentinel distinguishes `unavailable` from console
+ * `not_allocated`.
+ */
+declare const EXPERIMENT_UNAVAILABLE_SENTINEL: Readonly<{
+  schema: "v1";
+  status: "not_allocated";
+  arm: "";
+  flagKey: "";
+  experimentId: "";
+  experimentName: "";
+  params: {};
+}>;
+/**
+ * Resolves an object-shaped experiment param with exposure suppressed (phase 1).
+ * Pass `store` when the caller already holds a reactive parameter-store handle
+ * (UI hooks) so the read logs exposure through that handle instead.
+ */
+declare function resolveExperiment<P extends object>(spec: ExperimentSpec<P>, options?: ResolveExperimentOptions): ResolvedExperiment<P>;
+/**
+ * Phase 1 (core). Memoized for the SDK session: the first resolution is the arm
+ * the user actually experiences, so later identity changes cannot retroactively
+ * rewrite it. Exposure suppressed.
+ */
+declare function resolveExperimentOnce<P extends object>(spec: ExperimentSpec<P>): ResolvedExperiment<P>;
+/**
+ * Phase 2 (core). Performs the exposing read for its Statsig side effect at
+ * most once per SDK session (keyed by `storeParam`), then returns the memoized
+ * phase-1 assignment so analytics reports what the user saw.
+ */
+declare function exposeExperimentOnce<P extends object>(spec: ExperimentSpec<P>): ExperimentAssignedPayload | null;
+//#endregion
+//#region src/integrations/feature-management/experimentParams.d.ts
+type ExperimentParamValue = boolean | number | string;
+/** One declared param: its default and the guard that admits a store value. */
+type ExperimentParamDescriptor<T extends ExperimentParamValue> = {
+  default: T;
+  isValid: (value: unknown) => value is T;
+};
+type ExperimentParamsSchema = Record<string, ExperimentParamDescriptor<ExperimentParamValue>>;
+/** The params map a schema implies — the single source of truth for `P`. */
+type InferExperimentParams<S extends ExperimentParamsSchema> = { [K in keyof S]: S[K] extends ExperimentParamDescriptor<infer T> ? T : never; };
+type NumberParamBounds = {
+  min?: number;
+  max?: number;
+  integer?: boolean;
+};
+declare const booleanParam: (defaultValue: boolean) => ExperimentParamDescriptor<boolean>;
+declare const numberParam: (defaultValue: number, bounds?: NumberParamBounds) => ExperimentParamDescriptor<number>;
+/** Empty strings are console mistakes, not values. */
+declare const stringParam: (defaultValue: string) => ExperimentParamDescriptor<string>;
+declare const enumParam: <const T extends readonly string[]>(defaultValue: T[number], allowed: T) => ExperimentParamDescriptor<T[number]>;
+/**
+ * Derives the `defaults` / `parseParams` half of an `ExperimentSpec` from a
+ * schema. An omitted param keeps its code default (control users still get
+ * shipped behavior); a present-but-invalid param rejects the whole payload so
+ * a corrupt console edit can never produce a half-applied treatment.
+ */
+declare function defineExperimentParams<S extends ExperimentParamsSchema>(schema: S): Pick<ExperimentSpec<InferExperimentParams<S>>, 'defaults' | 'parseParams'>;
+//#endregion
+export { EXPERIMENT_UNAVAILABLE_SENTINEL, type ExperimentAssignedPayload, type ExperimentParamDescriptor, type ExperimentParamValue, type ExperimentParamsSchema, type ExperimentSpec, type ExperimentTransportV1, type FeatureManagementExperiment, type FeatureManagementGate, type FeatureManagementLayer, type FeatureManagementParameterStore, type FeatureManagementParameterStoreEvaluationOptions, type FeatureManagementReadStatus, type FeatureManagementRedactedUserInfo, type FeatureManagementUserUpdate, type InferExperimentParams, type NumberParamBounds, ONBOARDING_WEB_SDK_PARAMETER_STORE, type ResolveExperimentOptions, type ResolvedExperiment, booleanParam, defineExperimentParams, enumParam, exposeExperimentOnce, getExperiment, getFeatureDynamicConfig, getFeatureGate, getFeatureManagementVersion, getFeatureParameterStore, getIsFeatureManagementInitialized, getLayer, logEvent, numberParam, resolveExperiment, resolveExperimentOnce, stringParam, subscribeFeatureManagement, updateFeatureManagementUser };

package/dist/feature-management.esm.js

@@ -0,0 +1,2 @@
+import { E as updateFeatureManagementUser, T as subscribeFeatureManagement, _ as getIsFeatureManagementInitialized, a as stringParam, d as ONBOARDING_WEB_SDK_PARAMETER_STORE, f as getExperiment, g as getFeatureParameterStore, h as getFeatureManagementVersion, i as numberParam, l as resolveExperiment, m as getFeatureGate, n as defineExperimentParams, o as EXPERIMENT_UNAVAILABLE_SENTINEL, p as getFeatureDynamicConfig, r as enumParam, s as exposeExperimentOnce, t as booleanParam, u as resolveExperimentOnce, x as logEvent, y as getLayer } from "./feature-management-DS_Nj5Gg.esm.js";
+export { EXPERIMENT_UNAVAILABLE_SENTINEL, ONBOARDING_WEB_SDK_PARAMETER_STORE, booleanParam, defineExperimentParams, enumParam, exposeExperimentOnce, getExperiment, getFeatureDynamicConfig, getFeatureGate, getFeatureManagementVersion, getFeatureParameterStore, getIsFeatureManagementInitialized, getLayer, logEvent, numberParam, resolveExperiment, resolveExperimentOnce, stringParam, subscribeFeatureManagement, updateFeatureManagementUser };

package/dist/field-comparison.d.ts

@@ -1,5 +1,2 @@
-import "./StateMachine-D5WO6lHS.js";
-import "./Manager-goNPc_h_.js";
-import "./Actor-BwgmOPkb.js";
-import { a as FieldComparisonActor, c as FieldComparisonFields, i as createFieldComparisonManagerFromActor, n as FieldComparisonState, o as fieldComparisonMachine, r as createFieldComparisonManager, s as FieldComparisonConfig, t as FieldComparisonManager } from "./fieldComparisonManager-OLKVsG2Z.js";
+import { a as FieldComparisonActor, c as FieldComparisonFields, i as createFieldComparisonManagerFromActor, n as FieldComparisonState, o as fieldComparisonMachine, r as createFieldComparisonManager, s as FieldComparisonConfig, t as FieldComparisonManager } from "./fieldComparisonManager-CBvEGxFx.js";
 export { type FieldComparisonActor, type FieldComparisonConfig, type FieldComparisonFields, type FieldComparisonManager, type FieldComparisonState, createFieldComparisonManager, createFieldComparisonManagerFromActor, fieldComparisonMachine };

package/dist/field-comparison.esm.js

@@ -1,7 +1,2 @@
-import "./api-DsbUi7TO.esm.js";
-import "./events-1wxZ97yf.esm.js";
-import "./endpoints-CwrFQfW7.esm.js";
-import "./xstate.esm-nY3M5UYm.esm.js";
-import { n as createFieldComparisonManagerFromActor, r as fieldComparisonMachine, t as createFieldComparisonManager } from "./fieldComparisonManager-Cw4uzD7S.esm.js";
-
-export { createFieldComparisonManager, createFieldComparisonManagerFromActor, fieldComparisonMachine };
+import { n as createFieldComparisonManagerFromActor, r as fieldComparisonMachine, t as createFieldComparisonManager } from "./fieldComparisonManager-DhnYdYZ2.esm.js";
+export { createFieldComparisonManager, createFieldComparisonManagerFromActor, fieldComparisonMachine };

package/dist/{fieldComparisonManager-OLKVsG2Z.d.ts → fieldComparisonManager-CBvEGxFx.d.ts}

@@ -1,8 +1,7 @@
-import { t as Manager } from "./Manager-goNPc_h_.js";
-import { t as ActorRefFrom } from "./Actor-BwgmOPkb.js";
-
+import { i as ActorRefFrom } from "./spawn-D9jgw9pW.js";
+import { t as Manager } from "./Manager-CQQ99QOI.js";
+import "./Actor-iTq7YY48.js";
 //#region src/modules/field-comparison/types.d.ts
-
 /**
  * Configuration options for the field comparison module.
  *
@@ -16,7 +15,6 @@ type FieldComparisonFields = {
 };
 //#endregion
 //#region src/modules/field-comparison/fieldComparisonStateMachine.d.ts
-
 declare const fieldComparisonMachine: any;
 type FieldComparisonMachine = typeof fieldComparisonMachine;
 //#endregion

package/dist/{fieldComparisonManager-Cw4uzD7S.esm.js → fieldComparisonManager-DhnYdYZ2.esm.js}

@@ -1,8 +1,8 @@
-import { t as api } from "./api-DsbUi7TO.esm.js";
-import { n as eventModuleNames, s as createManagerInstrumentation } from "./events-1wxZ97yf.esm.js";
-import { t as endpoints } from "./endpoints-CwrFQfW7.esm.js";
-import { a as fromPromise, l as createManager, r as assign, s as createActor, t as setup } from "./xstate.esm-nY3M5UYm.esm.js";
-
+import { t as api } from "./api-Bx3gKW_y.esm.js";
+import { n as eventModuleNames, o as createManagerInstrumentation } from "./events-CxfNJVZW.esm.js";
+import { t as endpoints } from "./endpoints-CCzL3XD_.esm.js";
+import { c as createManager, o as createActor, r as assign, t as setup } from "./xstate.esm-Cf4e0Cfd.esm.js";
+import { n as fromPromise } from "./xstate-actors.esm-CtI5S0f4.esm.js";
 //#region src/modules/field-comparison/fieldComparisonServices.ts
 /** Submit first and last name for backend field comparison. Throws on failure. */
 async function submitFieldComparison(params, signal) {
@@ -10,14 +10,12 @@ async function submitFieldComparison(params, signal) {
 	if (!res.ok) throw new Error(`POST ${endpoints.addCustomFields} failed: ${res.status} ${res.statusText}`);
 	return res.data;
 }
-
 //#endregion
 //#region src/modules/field-comparison/fieldComparisonUtils.ts
 /** Returns true when both first and last name are non-empty after trimming. */
 function isFormComplete(fields) {
 	return fields.firstName.trim() !== "" && fields.lastName.trim() !== "";
 }
-
 //#endregion
 //#region src/modules/field-comparison/fieldComparisonStateMachine.ts
 const emptyFields = () => ({
@@ -78,7 +76,6 @@ const fieldComparisonMachine = setup({
 		finished: { type: "final" }
 	}
 });
-
 //#endregion
 //#region src/modules/field-comparison/fieldComparisonActor.ts
 /**
@@ -89,7 +86,6 @@ const fieldComparisonMachine = setup({
 function createFieldComparisonActor(options = {}) {
 	return createActor(fieldComparisonMachine, { input: { config: options.config ?? {} } }).start();
 }
-
 //#endregion
 //#region src/modules/field-comparison/fieldComparisonManager.ts
 function mapState(snapshot) {
@@ -157,6 +153,5 @@ function createFieldComparisonManagerFromActor(actor) {
 		instrumentation: createManagerInstrumentation(eventModuleNames.fieldComparison)
 	});
 }
-
 //#endregion
-export { createFieldComparisonManagerFromActor as n, fieldComparisonMachine as r, createFieldComparisonManager as t };
+export { createFieldComparisonManagerFromActor as n, fieldComparisonMachine as r, createFieldComparisonManager as t };

package/dist/fiscal-qr.d.ts

@@ -1,9 +1,4 @@
-import "./StateMachine-D5WO6lHS.js";
-import { t as Manager } from "./Manager-goNPc_h_.js";
-import "./camera-CKU96nwJ.js";
-import "./canvas-90BqS0NF.js";
-import "./StreamCanvasCapture-DHaWferF.js";
-
+import { t as Manager } from "./Manager-CQQ99QOI.js";
 //#region src/modules/fiscal-qr/types.d.ts
 /**
  * Configuration options for the Fiscal QR module.

package/dist/fiscal-qr.esm.js

@@ -1,26 +1,17 @@
-import { t as BrowserTimerProvider } from "./BrowserTimerProvider-CHloo0eQ.esm.js";
-import { t as api } from "./api-DsbUi7TO.esm.js";
-import { g as addEvent, n as eventModuleNames, s as createManagerInstrumentation } from "./events-1wxZ97yf.esm.js";
-import { t as endpoints } from "./endpoints-CwrFQfW7.esm.js";
-import "./platform-0Ot-bF_a.esm.js";
-import { a as fromPromise, i as fromCallback, l as createManager, r as assign, s as createActor, t as setup } from "./xstate.esm-nY3M5UYm.esm.js";
-import { a as stopCameraStream } from "./camera-CxxXV0VN.esm.js";
-import "./ITimerCapability-DJ73P4RK.esm.js";
-import "./canvas-Pi10hG_l.esm.js";
-import { n as getBackCameraStream } from "./backCameraStream-ChrMTJv-.esm.js";
-import { t as StreamCanvasCapture } from "./StreamCanvasCapture-CAqUdVkM.esm.js";
-import "./http-CnsKEaJY.esm.js";
+import { t as BrowserTimerProvider } from "./BrowserTimerProvider-BXhgNxLt.esm.js";
+import { t as api } from "./api-Bx3gKW_y.esm.js";
+import { n as eventModuleNames, o as createManagerInstrumentation, v as addEvent } from "./events-CxfNJVZW.esm.js";
+import { t as endpoints } from "./endpoints-CCzL3XD_.esm.js";
+import { c as createManager, o as createActor, r as assign, t as setup } from "./xstate.esm-Cf4e0Cfd.esm.js";
+import { n as fromPromise, t as fromCallback } from "./xstate-actors.esm-CtI5S0f4.esm.js";
+import { a as stopCameraStream } from "./camera-_2sXMXiF.esm.js";
+import { n as getBackCameraStream } from "./backCameraStream-CUeYm5eu.esm.js";
+import { t as StreamCanvasCapture } from "./StreamCanvasCapture-D2XcXCZ4.esm.js";
 import { BrowserQRCodeReader } from "@zxing/browser";
-
 //#region src/modules/fiscal-qr/fiscalQrConstants.ts
-const QR_SCAN_FPS = 10;
-const INITIAL_FOCUS_DELAY_MS = 800;
-const SCAN_INTERVAL_MS = 500;
 const SUCCESS_DISPLAY_MS = 1500;
 const PROCESSING_DISPLAY_MS = 3e3;
 const ERROR_DISPLAY_MS = 3e3;
-const MAX_ATTEMPTS = 3;
-
 //#endregion
 //#region src/modules/fiscal-qr/qrCodeDecoder.ts
 function createQrCodeDecoder() {
@@ -34,7 +25,6 @@ function createQrCodeDecoder() {
 		}
 	} };
 }
-
 //#endregion
 //#region src/modules/fiscal-qr/fiscalQrUtils.ts
 /**
@@ -76,9 +66,9 @@ function startQrScan(frameCapturer, onDetected, applyFocusDelay = true) {
 	};
 	const beginScanning = () => {
 		scan();
-		scanInterval = timer.setInterval(scan, SCAN_INTERVAL_MS);
+		scanInterval = timer.setInterval(scan, 500);
 	};
-	if (applyFocusDelay) focusDelay = timer.setTimeout(beginScanning, INITIAL_FOCUS_DELAY_MS);
+	if (applyFocusDelay) focusDelay = timer.setTimeout(beginScanning, 800);
 	else beginScanning();
 	return () => {
 		disposed = true;
@@ -86,7 +76,6 @@ function startQrScan(frameCapturer, onDetected, applyFocusDelay = true) {
 		if (scanInterval !== void 0) timer.clearInterval(scanInterval);
 	};
 }
-
 //#endregion
 //#region src/modules/fiscal-qr/fiscalQrServices.ts
 /**
@@ -102,7 +91,6 @@ async function submitFiscalQrLink(params, signal) {
 	if (res.data?.success !== true) throw new Error("Fiscal QR link was not accepted");
 	return res.data;
 }
-
 //#endregion
 //#region src/modules/fiscal-qr/fiscalQrStateMachine.ts
 const fiscalQrMachine = setup({
@@ -116,7 +104,7 @@ const fiscalQrMachine = setup({
 			const { stream } = await getBackCameraStream(void 0);
 			return {
 				stream,
-				frameCapturer: new StreamCanvasCapture(stream, { fps: QR_SCAN_FPS })
+				frameCapturer: new StreamCanvasCapture(stream, { fps: 10 })
 			};
 		}),
 		submitFiscalQrLink: fromPromise(async ({ input, signal }) => {
@@ -168,7 +156,7 @@ const fiscalQrMachine = setup({
 			module: eventModuleNames.fiscalQr
 		})
 	},
-	guards: { isMaxAttemptsReached: ({ context }) => context.attempts + 1 >= MAX_ATTEMPTS }
+	guards: { isMaxAttemptsReached: ({ context }) => context.attempts + 1 >= 3 }
 }).createMachine({
 	id: "fiscalQr",
 	initial: "idle",
@@ -251,7 +239,6 @@ const fiscalQrMachine = setup({
 		}
 	}
 });
-
 //#endregion
 //#region src/modules/fiscal-qr/fiscalQrActor.ts
 /**
@@ -261,7 +248,6 @@ const fiscalQrMachine = setup({
 function createFiscalQrActor(options) {
 	return createActor(fiscalQrMachine, { input: { config: options.config } }).start();
 }
-
 //#endregion
 //#region src/modules/fiscal-qr/fiscalQrManager.ts
 function mapState(snapshot) {
@@ -318,6 +304,5 @@ function createFiscalQrManager(options) {
 		instrumentation: createManagerInstrumentation(eventModuleNames.fiscalQr)
 	});
 }
-
 //#endregion
-export { createFiscalQrManager, fiscalQrMachine };
+export { createFiscalQrManager, fiscalQrMachine };

package/dist/flow-events.d.ts

@@ -1,9 +1,2 @@
-import "./camera-CKU96nwJ.js";
-import "./types-DV3wkhQ4.js";
-import "./types-BgjMAEXl.js";
-import "./canvas-90BqS0NF.js";
-import "./createFaceAvatar-CpdYp9Iy.js";
-import "./types-BUgeB2X6.js";
-import "./flowCompletionService-BOSTlAWo.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-DrpWp15Z.js";
-export { FlowClosedEvent, FlowCompletedEvent, FlowErrorEvent, FlowEvent, FlowEventListener, FlowEventSubscribable, FlowModuleCompletedEvent, FlowModuleStartedEvent, FlowReadyEvent, FlowStartedEvent };
+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";
+export type { FlowClosedEvent, FlowCompletedEvent, FlowErrorEvent, FlowEvent, FlowEventListener, FlowEventSubscribable, FlowModuleCompletedEvent, FlowModuleStartedEvent, FlowReadyEvent, FlowStartedEvent };

package/dist/flow.d.ts

@@ -1,17 +1,21 @@
-import { n as WasmPipeline } from "./warmup-Dd0iq6KF.js";
-import { t as AnyStateMachine } from "./StateMachine-D5WO6lHS.js";
-import { t as Manager } from "./Manager-goNPc_h_.js";
-import "./camera-CKU96nwJ.js";
-import "./types-DV3wkhQ4.js";
-import "./types-BgjMAEXl.js";
-import "./canvas-90BqS0NF.js";
-import "./createFaceAvatar-CpdYp9Iy.js";
-import { i as FlowModuleConfig, n as Flow, r as FlowModule } from "./types-BUgeB2X6.js";
-import { a as TotalScore, c as getTotalScoreStatus, n as FinishStatus, o as classifyScoreStatus, r as GetFinishStatusFn, t as FinishScreenVariant } from "./flowCompletionService-BOSTlAWo.js";
-import { o as FlowEventSubscribable } from "./index-DrpWp15Z.js";
-import { n as ModuleRegistry } from "./types-D8Cl1N2Z.js";
-import * as xstate690 from "xstate";
-
+import { n as WasmPipeline } from "./warmup-Dv2alr2-.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 { 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 { t as DynamicFormsConfig } from "./types-BSBzhHRH.js";
+import { t as EkybConfig } from "./types-BfHiko5D.js";
+import { c as IdCaptureConfig } from "./types-M6eb82ra2.js";
+import { r as MandatoryConsentConfig } from "./types-BX_XkMsQ2.js";
+import { t as IdOcrConfig } from "./types-CJ7Yl9K-2.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";
 //#region src/modules/flow/flowUtils.d.ts
 type NormalizeFlowModulesOptions = {
   isDesktop?: boolean;
@@ -20,6 +24,7 @@ type NormalizeFlowModulesOptions = {
   useCPF?: boolean;
 };
 type FlowForNormalization = Pick<Flow, 'flowId' | 'flowModules' | 'redirectDesktopToMobile' | 'disableSmsOption' | 'addContinueToDesktop' | 'qrPhishingResistance'>;
+declare function enrichFlowModuleConfig(module: FlowModule, flow: Flow): Record<string, unknown>;
 /**
  * Analyzes a flow configuration and returns the WASM pipelines needed.
  * Use this to conditionally warmup WASM only when required by the flow.
@@ -51,6 +56,12 @@ declare function getRequiredWasmPipelines(flow: Flow): WasmPipeline[];
  */
 declare function normalizeFlowModules(flow: FlowForNormalization, options?: NormalizeFlowModulesOptions): FlowModule[];
 //#endregion
+//#region src/modules/flow/dashboardConfig.d.ts
+type DeepPartialValue<T> = T extends Record<string, unknown> ? DeepPartial<T> : T;
+type PreserveArray<T> = T extends readonly unknown[] ? T : DeepPartialValue<T>;
+type DeepPartial<T> = { [K in keyof T]?: PreserveArray<T[K]>; };
+declare function mergeDashboardConfig<T>(dashboardConfig: T, localConfig: DeepPartial<T> | undefined): T;
+//#endregion
 //#region src/modules/flow/flowServices.d.ts
 type GetFlowOptions = {
   isDesktop?: boolean;
@@ -59,10 +70,36 @@ type GetFlowOptions = {
   useCPF?: boolean;
 };
 type GetFlow = (signal: AbortSignal, options?: GetFlowOptions) => Promise<Flow>;
+type DashboardResolvedModuleConfigMap = {
+  ADDRESS: DocumentCaptureConfig;
+  AE_SIGNATURE: Omit<ElectronicSignatureConfig, 'variant'>;
+  AUTHENTICATION: AuthenticationConfig;
+  DOCUMENT_CAPTURE: DocumentCaptureConfig;
+  DYNAMIC_FORMS: DynamicFormsConfig;
+  EKYB: EkybConfig;
+  EXTERNAL_VERIFICATION: EkycConfig;
+  ID: IdCaptureConfig;
+  ID_OCR: IdOcrConfig;
+  MANDATORY_CONSENT: MandatoryConsentConfig;
+  ML_CONSENT: MandatoryConsentConfig;
+  QE_SIGNATURE: Omit<ElectronicSignatureConfig, 'variant'>;
+  REDIRECT_TO_MOBILE: RedirectToMobileConfig;
+  SECOND_ID: IdCaptureConfig;
+  TUTORIAL_ID: IdCaptureConfig;
+};
+type ResolvedDashboardModuleConfig<K extends keyof FlowModuleConfig> = K extends keyof DashboardResolvedModuleConfigMap ? DashboardResolvedModuleConfigMap[K] : FlowModuleConfig[K];
+type ResolveDashboardModuleConfigOptions<K extends keyof FlowModuleConfig> = {
+  moduleKey: K;
+  config?: DeepPartial<ResolvedDashboardModuleConfig<K>>;
+  occurrence?: number;
+  signal?: AbortSignal;
+};
+declare function preloadDashboardFlow(signal?: AbortSignal): Promise<Flow>;
 declare const getFlow: GetFlow;
+declare function resolveDashboardModuleConfig<K extends keyof FlowModuleConfig>(options: ResolveDashboardModuleConfigOptions<K>): Promise<ResolvedDashboardModuleConfig<K>>;
 //#endregion
 //#region src/modules/flow/noOpFlowModuleMachine.d.ts
-declare const noOpFlowModuleMachine: xstate690.StateMachine<xstate690.MachineContext, xstate690.AnyEventObject, {}, never, never, never, never, "finished", string, xstate690.NonReducibleUnknown, xstate690.NonReducibleUnknown, xstate690.EventObject, xstate690.MetaObject, {
+declare const noOpFlowModuleMachine: StateMachine<MachineContext, AnyEventObject, {}, never, never, never, never, "finished", string, NonReducibleUnknown, NonReducibleUnknown, EventObject, MetaObject, {
   readonly id: "noOpFlowModule";
   readonly initial: "finished";
   readonly states: {
@@ -185,7 +222,7 @@ declare function createFlowManager(options?: CreateFlowActorOptions): Manager<Fl
    * @param moduleKey - The unique key identifier of the module
    * @returns The module configuration or `undefined` if not found or not in `ready` state
    */
-  getModuleConfig: <T$1 = unknown>(moduleKey: string) => T$1 | undefined;
+  getModuleConfig: <T = unknown>(moduleKey: string) => T | undefined;
   /**
    * Checks if a module is enabled in the current flow.
    * @param moduleKey - The unique key identifier of the module
@@ -195,14 +232,14 @@ declare function createFlowManager(options?: CreateFlowActorOptions): Manager<Fl
 } & FlowEventSubscribable;
 //#endregion
 //#region src/modules/flow/moduleLoader.d.ts
-type LazyModule<T$1> = () => Promise<T$1>;
+type LazyModule<T> = () => Promise<T>;
 type ModuleLoaderRegistry = {
   [key: string]: LazyModule<{
     default: unknown;
   }>;
 };
 interface ModuleLoader {
-  load<T$1>(moduleKey: string): Promise<T$1>;
+  load<T>(moduleKey: string): Promise<T>;
   prefetch(moduleKey: string): void;
   isLoaded(moduleKey: string): boolean;
 }
@@ -230,6 +267,7 @@ type OrchestratedFlowEvent = {
   type: 'RESET';
 } | {
   type: 'MODULE_COMPLETE';
+  output?: unknown;
 } | {
   type: 'COMPLETE_FLOW';
 } | {
@@ -334,7 +372,7 @@ declare function createOrchestratedFlowManager(options: CreateOrchestratedFlowAc
    * />
    * ```
    */
-  completeModule(): void;
+  completeModule(output?: unknown): void;
   /**
    * Skip all remaining modules and complete the flow now, notifying the
    * backend (getFinishStatus) on the way to the completion step.
@@ -367,7 +405,7 @@ declare function createOrchestratedFlowManager(options: CreateOrchestratedFlowAc
    */
   send(event: OrchestratedFlowEvent): void;
   readonly canNext: boolean;
-  getModuleConfig: <T$1 = unknown>(moduleKey: string) => T$1 | undefined;
+  getModuleConfig: <T = unknown>(moduleKey: string) => T | undefined;
   isModuleEnabled: (moduleKey: string) => boolean;
   isAwaitingOrchestratorReady(): boolean;
   /**
@@ -381,4 +419,4 @@ declare function createOrchestratedFlowManager(options: CreateOrchestratedFlowAc
   continueFromHome(): Promise<void>;
 } & FlowEventSubscribable;
 //#endregion
-export { 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 TotalScore, classifyScoreStatus, createFlowManager, createModuleLoader, createOrchestratedFlowManager, getFlow, getRequiredWasmPipelines, getTotalScoreStatus, noOpFlowModuleMachine, normalizeFlowModules };
+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 };