@incodetech/core 2.1.0-rc.0 → 2.1.0-rc.2

package/dist/{BrowserStorageProvider-BpJM-gIl.esm.js → BrowserStorageProvider-D5xc7Lqo.esm.js}

@@ -4,6 +4,23 @@ function setWasmDsFlagSync(enabled) {
 	localStorage.setItem("ds", enabled ? "1" : "0");
 }
 
+//#endregion
+//#region ../infra/src/providers/browser/BrowserVisibilityObserverProvider.ts
+var BrowserVisibilityObserverProvider = class {
+	isVisible() {
+		return !document.hidden;
+	}
+	onVisibilityChange(listener) {
+		const handler = () => {
+			listener(!document.hidden);
+		};
+		document.addEventListener("visibilitychange", handler);
+		return () => {
+			document.removeEventListener("visibilitychange", handler);
+		};
+	}
+};
+
 //#endregion
 //#region ../infra/src/providers/browser/BrowserStorageProvider.ts
 /**
@@ -59,4 +76,4 @@ var BrowserStorageProvider = class {
 };
 
 //#endregion
-export { setWasmDsFlagSync as n, BrowserStorageProvider as t };
+export { BrowserVisibilityObserverProvider as n, setWasmDsFlagSync as r, BrowserStorageProvider as t };

package/dist/{Manager-BHn8wH8K.d.ts → Manager-B2OEDYqf.d.ts}

@@ -1,4 +1,7 @@
+import { AnyStateMachine, StateMachine, fromCallback, fromPromise } from "xstate";
+
 //#region ../infra/src/manager/Manager.d.ts
+
 /**
  * Base manager interface providing state access, subscriptions, and lifecycle control.
  * @template TPublicState - The public state type exposed to consumers
@@ -16,4 +19,4 @@ type Manager<TPublicState> = {
   stop(): void;
 };
 //#endregion
-export { Manager as t };
+export { fromPromise as a, fromCallback as i, AnyStateMachine as n, StateMachine as r, Manager as t };

package/dist/{OpenViduRecordingProvider-O4GjBseO.esm.js → OpenViduRecordingProvider-DF7A4ZNJ.esm.js}

@@ -1,4 +1,4 @@
-import { t as loadOpenVidu } from "./openviduLazy-Dh14JNJc.esm.js";
+import { t as loadOpenVidu } from "./openviduLazy-oAXXI9w_.esm.js";
 
 //#region ../infra/src/providers/browser/OpenViduRecordingProvider.ts
 function createHiddenContainer() {

package/dist/{StreamCanvasCapture-yyl20qd9.d.ts → StreamCanvasCapture-Ctgyx-oD.d.ts}

@@ -1,4 +1,4 @@
-import { t as CameraStream } from "./camera-SRBpPq2X.js";
+import { t as CameraStream } from "./camera-biGPWlmx.js";
 
 //#region ../infra/src/media/canvas.d.ts
 /**

package/dist/{StreamCanvasCapture-ImiDQdVA.esm.js → StreamCanvasCapture-Dr5n_iK1.esm.js}

@@ -1,4 +1,4 @@
-import { t as IncodeCanvas } from "./canvas-SKcRBxsk.esm.js";
+import { t as IncodeCanvas } from "./canvas-7uX2izHb.esm.js";
 
 //#region ../infra/src/media/StreamCanvasCapture.ts
 var StreamCanvasCapture = class {

package/dist/{WasmUtilProvider-CiEN7Gjn.esm.js → WasmUtilProvider-CIu373BZ.esm.js}

@@ -711,6 +711,13 @@ var MlWasmJSApi = class MlWasmJSApi {
 		if (!this.modelsBuffers) await this.loadModels();
 		this.workflowApiUtilities.initializeWorkflows();
 	}
+	/**
+	* Sets the native (C++) utility API's production mode. When `true`, the WASM
+	* module suppresses its verbose debug logging; when `false`, it emits it.
+	*
+	* @param productionMode - `true` to silence WASM logs, `false` to emit them.
+	* @throws If the WASM C++ API has not been initialized yet.
+	*/
 	async setProductionMode(productionMode) {
 		this.checkWasmInitialization("Unable to set production mode, cpp API hasn't been initialized");
 		this.utilityApi.setProductionMode(productionMode);
@@ -912,6 +919,7 @@ let loadingPromise = null;
 let wasmError = null;
 let loadedPipelines = [];
 let lastConfig = null;
+let pipelinesInFlight = [];
 function mapPipelineToWasmType(pipeline) {
 	switch (pipeline) {
 		case "selfie": return WasmPipelineType.SelfieWithQualityMetrics;
@@ -978,13 +986,18 @@ function buildPipelinesMap(pipelines, modelsBasePath, customModels) {
 async function warmupWasm(config) {
 	const pipelines = config.pipelines ?? [...WASM_PIPELINES];
 	const modelsBasePath = config.modelsBasePath ?? deriveModelsBasePath(config.wasmPath);
-	if (state === "loading" && loadingPromise) return loadingPromise;
+	if (state === "loading" && loadingPromise) {
+		const inFlight = loadingPromise;
+		if (pipelines.filter((p) => !pipelinesInFlight.includes(p)).length === 0) return inFlight;
+		return inFlight.then(() => warmupWasm(config));
+	}
 	if (state === "ready") {
 		if (pipelines.filter((p) => !loadedPipelines.includes(p)).length === 0) return;
 		if (!lastConfig) throw new Error("Cannot add pipelines: original warmup config not available");
 		if (lastConfig.wasmPath !== config.wasmPath || lastConfig.glueCodePath !== config.glueCodePath || (lastConfig.wasmSimdPath ?? lastConfig.wasmPath) !== (config.wasmSimdPath ?? config.wasmPath) || (lastConfig.glueCodeSimdPath ?? "") !== (config.glueCodeSimdPath ?? "") || (lastConfig.useSimd ?? true) !== (config.useSimd ?? true)) throw new Error("Cannot add pipelines: WASM config mismatch. Use same wasmPath, glueCodePath, and useSimd settings.");
 		const combinedPipelines = [...new Set([...loadedPipelines, ...pipelines])];
 		state = "loading";
+		pipelinesInFlight = combinedPipelines;
 		wasmError = null;
 		loadingPromise = (async () => {
 			try {
@@ -1003,12 +1016,14 @@ async function warmupWasm(config) {
 				state = "error";
 				wasmError = error instanceof Error ? error : new Error(String(error));
 				loadingPromise = null;
+				pipelinesInFlight = [];
 				throw wasmError;
 			}
 		})();
 		return loadingPromise;
 	}
 	state = "loading";
+	pipelinesInFlight = [...pipelines];
 	wasmError = null;
 	loadingPromise = (async () => {
 		try {
@@ -1027,6 +1042,7 @@ async function warmupWasm(config) {
 			state = "error";
 			wasmError = error instanceof Error ? error : new Error(String(error));
 			loadingPromise = null;
+			pipelinesInFlight = [];
 			throw wasmError;
 		}
 	})();
@@ -1224,6 +1240,18 @@ var WasmUtilProvider = class WasmUtilProvider extends BaseWasmProvider {
 		this.ensureInitialized();
 		mlWasmJSApi_default.setInspectorOpened(opened);
 	}
+	/**
+	* Toggles the WASM module's production mode. When `true`, the native module
+	* suppresses its verbose debug logging/console output; when `false`, those
+	* logs are emitted. The SDK forces this to `true` by default and only flips
+	* it off when the caller opts in via `setup({ wasm: { showLogs: true } })`.
+	*
+	* @param productionMode - `true` to silence WASM logs, `false` to emit them.
+	*/
+	async setProductionMode(productionMode) {
+		this.ensureInitialized();
+		await mlWasmJSApi_default.setProductionMode(productionMode);
+	}
 	getMetadata() {
 		this.ensureInitialized();
 		return mlWasmJSApi_default.getMetadata();

package/dist/{addressSearch-DvmWXKZg.esm.js → addressSearch-BH96a3fq.esm.js}

@@ -1,7 +1,7 @@
-import { t as BrowserTimerProvider } from "./BrowserTimerProvider-DhNc_x02.esm.js";
-import { t as api } from "./api-CESGtpbH.esm.js";
-import { t as endpoints } from "./endpoints-BeTK0Mlt.esm.js";
-import { i as fromCallback } from "./xstate.esm-C9wncMQa.esm.js";
+import { t as BrowserTimerProvider } from "./BrowserTimerProvider-BVgutW_b.esm.js";
+import { t as api } from "./api-DUZwyz0o.esm.js";
+import { t as endpoints } from "./endpoints-BM2_j_IE.esm.js";
+import { i as fromCallback } from "./xstate.esm-Dkm1jy5u.esm.js";
 
 //#region src/shared/usStates.ts
 const usStates = {

package/dist/{ae-signature-BFZta3TZ.esm.js → ae-signature-CDEN8y-w.esm.js}

@@ -1,4 +1,4 @@
-import { t as createElectronicSignatureManager } from "./electronicSignatureManager-BaECdJ1u.esm.js";
+import { t as createElectronicSignatureManager } from "./electronicSignatureManager-B63aAuI5.esm.js";
 
 //#region src/modules/ae-signature/index.ts
 function createAeSignatureManager(options) {

package/dist/ae-signature.d.ts

@@ -1,6 +1,6 @@
-import { t as Manager } from "./Manager-BHn8wH8K.js";
-import "./Actor-Y0_Fj-KL.js";
-import { a as AE_CONSENT_KEYS, c as ConsentKey, g as getDefaultConsentChecks, i as electronicSignatureMachine, l as ElectronicSignatureConfig, m as areAllConsented, n as ElectronicSignatureState, s as ConsentChecks, u as ElectronicSignatureDocument } from "./index-B9NysVDB.js";
+import { t as Manager } from "./Manager-B2OEDYqf.js";
+import "./Actor-fIPLXfoi.js";
+import { a as AE_CONSENT_KEYS, c as ConsentKey, g as getDefaultConsentChecks, i as electronicSignatureMachine, l as ElectronicSignatureConfig, m as areAllConsented, n as ElectronicSignatureState, s as ConsentChecks, u as ElectronicSignatureDocument } from "./index-DV134v62.js";
 
 //#region src/modules/ae-signature/index.d.ts
 

package/dist/ae-signature.esm.js

@@ -1,9 +1,11 @@
-import "./api-CESGtpbH.esm.js";
-import "./events-Dvvriq9l.esm.js";
-import "./endpoints-BeTK0Mlt.esm.js";
-import "./xstate.esm-C9wncMQa.esm.js";
-import "./apiError-B-j-gyDx.esm.js";
-import { a as areAllConsented, n as electronicSignatureMachine, r as AE_CONSENT_KEYS, s as getDefaultConsentChecks } from "./electronicSignatureManager-BaECdJ1u.esm.js";
-import { t as createAeSignatureManager } from "./ae-signature-BFZta3TZ.esm.js";
+import "./api-DUZwyz0o.esm.js";
+import "./events-DN-u67gb.esm.js";
+import "./endpoints-BM2_j_IE.esm.js";
+import "./xstate.esm-Dkm1jy5u.esm.js";
+import "./apiError-D-GTvFrH.esm.js";
+import "./urlUtils-8RNHyW3x.esm.js";
+import "./externalFetch-crimxkN9.esm.js";
+import { a as areAllConsented, n as electronicSignatureMachine, r as AE_CONSENT_KEYS, s as getDefaultConsentChecks } from "./electronicSignatureManager-B63aAuI5.esm.js";
+import { t as createAeSignatureManager } from "./ae-signature-CDEN8y-w.esm.js";
 
 export { AE_CONSENT_KEYS, electronicSignatureMachine as aeSignatureMachine, areAllConsented, createAeSignatureManager, getDefaultConsentChecks };

package/dist/antifraud.d.ts

@@ -1,6 +1,6 @@
-import "./Manager-BHn8wH8K.js";
-import "./Actor-Y0_Fj-KL.js";
-import { i as createAntifraudManagerFromActor, n as AntifraudState, o as antifraudMachine, r as createAntifraudManager, t as AntifraudManager } from "./antifraudManager-CznnhyvD.js";
+import "./Manager-B2OEDYqf.js";
+import "./Actor-fIPLXfoi.js";
+import { i as createAntifraudManagerFromActor, n as AntifraudState, o as antifraudMachine, r as createAntifraudManager, t as AntifraudManager } from "./antifraudManager-B7WQTIdu.js";
 
 //#region src/modules/antifraud/types.d.ts
 

package/dist/antifraud.esm.js

@@ -1,8 +1,8 @@
-import "./api-CESGtpbH.esm.js";
-import "./events-Dvvriq9l.esm.js";
-import "./endpoints-BeTK0Mlt.esm.js";
-import "./xstate.esm-C9wncMQa.esm.js";
-import { t as antifraudMachine } from "./antifraudStateMachine-Ccrb-Jxc.esm.js";
-import { n as createAntifraudManagerFromActor, t as createAntifraudManager } from "./antifraudManager-CkV4u-LE.esm.js";
+import "./api-DUZwyz0o.esm.js";
+import "./events-DN-u67gb.esm.js";
+import "./endpoints-BM2_j_IE.esm.js";
+import "./xstate.esm-Dkm1jy5u.esm.js";
+import { t as antifraudMachine } from "./antifraudStateMachine-DlKrK2hL.esm.js";
+import { n as createAntifraudManagerFromActor, t as createAntifraudManager } from "./antifraudManager-DZifA5zX.esm.js";
 
 export { antifraudMachine, createAntifraudManager, createAntifraudManagerFromActor };

package/dist/{antifraudManager-CznnhyvD.d.ts → antifraudManager-B7WQTIdu.d.ts}

@@ -1,5 +1,5 @@
-import { t as Manager } from "./Manager-BHn8wH8K.js";
-import { t as ActorRefFrom } from "./Actor-Y0_Fj-KL.js";
+import { t as Manager } from "./Manager-B2OEDYqf.js";
+import { t as ActorRefFrom } from "./Actor-fIPLXfoi.js";
 
 //#region src/modules/antifraud/antifraudStateMachine.d.ts
 declare const antifraudMachine: any;

package/dist/antifraudManager-DZifA5zX.esm.js

@@ -0,0 +1,83 @@
+import { n as eventModuleNames, o as topLevelStateName, s as createManagerInstrumentation } from "./events-DN-u67gb.esm.js";
+import { c as createManager, s as createActor } from "./xstate.esm-Dkm1jy5u.esm.js";
+import { t as antifraudMachine } from "./antifraudStateMachine-DlKrK2hL.esm.js";
+
+//#region src/modules/antifraud/antifraudActor.ts
+function createAntifraudActor() {
+	return createActor(antifraudMachine).start();
+}
+
+//#endregion
+//#region src/modules/antifraud/antifraudManager.ts
+/**
+* Maps an Antifraud state-machine snapshot to the exact Figma
+* "Tracked Events" screen name. Source: Antifraud Module Figma file
+* (`https://www.figma.com/design/oimuzKmoozQf59PCC0TNys/Antifraud-Module---Latest-Design?node-id=2026-30075`).
+*
+* Figma defines exactly two surfaces with mixed casing: `Antifraud.processing`
+* (PascalCase) and `antifraud.success` (lowercase). The mapper returns the
+* Figma-verbatim string, and the adapter emits it as-is on `event.screen`.
+* See `docs/patterns/INSTRUMENTATION.md`.
+*
+* Antifraud is fire-and-forget by design — `processing.onDone` and
+* `processing.onError` both go to `finished`. The SM does not distinguish
+* success from error, so `finished` is mapped to `antifraud.success`
+* regardless of underlying outcome. If product wants a true success/error
+* split later, the SM would need a new state.
+*
+* `idle` is intentionally unmapped — Figma defines no entry screen; it
+* falls back to the default `antifraud.idle` segment.
+*/
+function getAntifraudScreenName(snapshot) {
+	const stateName = topLevelStateName(snapshot.value);
+	if (stateName === void 0) return void 0;
+	switch (stateName) {
+		case "processing": return "Antifraud.processing";
+		case "finished": return "antifraud.success";
+		default: return;
+	}
+}
+function mapState(snapshot) {
+	const typedSnapshot = snapshot;
+	if (typedSnapshot.matches("processing")) return { status: "processing" };
+	if (typedSnapshot.matches("finished")) return { status: "finished" };
+	return { status: "idle" };
+}
+function createApi({ actor }) {
+	return { load() {
+		actor.send({ type: "LOAD" });
+	} };
+}
+/**
+* Creates an antifraud manager for headless or UI-driven usage.
+*
+* @example Headless usage
+* ```typescript
+* const manager = createAntifraudManager();
+* manager.subscribe((state) => console.log(state.status));
+* manager.load();
+* ```
+*/
+function createAntifraudManager() {
+	return createManager({
+		actor: createAntifraudActor(),
+		mapState,
+		createApi,
+		instrumentation: createManagerInstrumentation(eventModuleNames.antifraud, { getEventScreenName: getAntifraudScreenName })
+	});
+}
+/**
+* Creates an antifraud manager from a pre-built actor.
+* Use this when overriding the machine via `.provide()` for custom backends or testing.
+*/
+function createAntifraudManagerFromActor(actor) {
+	return createManager({
+		actor,
+		mapState,
+		createApi,
+		instrumentation: createManagerInstrumentation(eventModuleNames.antifraud, { getEventScreenName: getAntifraudScreenName })
+	});
+}
+
+//#endregion
+export { createAntifraudManagerFromActor as n, createAntifraudManager as t };

package/dist/{antifraudStateMachine-Ccrb-Jxc.esm.js → antifraudStateMachine-DlKrK2hL.esm.js}

@@ -1,6 +1,6 @@
-import { t as api } from "./api-CESGtpbH.esm.js";
-import { t as endpoints } from "./endpoints-BeTK0Mlt.esm.js";
-import { a as fromPromise, t as setup } from "./xstate.esm-C9wncMQa.esm.js";
+import { t as api } from "./api-DUZwyz0o.esm.js";
+import { t as endpoints } from "./endpoints-BM2_j_IE.esm.js";
+import { a as fromPromise, t as setup } from "./xstate.esm-Dkm1jy5u.esm.js";
 
 //#region src/modules/antifraud/antifraudServices.ts
 async function processAntifraud(signal) {

package/dist/authentication.d.ts

@@ -1,14 +1,13 @@
-import "./warmup-Dg8Lh-50.js";
-import "./Manager-BHn8wH8K.js";
-import "./Actor-Y0_Fj-KL.js";
-import "./StateMachine-BC_nGvrc.js";
-import { D as authenticationMachine, S as AuthenticationConfig, b as CreateAuthenticationActorOptions, x as createAuthenticationActor, y as AuthenticationActor } from "./faceCaptureManagerFactory-C_hRHx8a.js";
-import "./camera-SRBpPq2X.js";
-import "./types-Bj9hdFjU.js";
-import "./types-DvGZI7BF.js";
-import "./types-DOUhndhT.js";
-import "./deepsightService-B7ShOkWL.js";
-import "./types-ya0LN_MX.js";
-import "./StreamCanvasCapture-yyl20qd9.js";
-import { n as AuthenticationState, r as createAuthenticationManager, t as AuthenticationManager } from "./authenticationManager-CIVY80H9.js";
+import "./warmup--6HA3yUR.js";
+import "./Manager-B2OEDYqf.js";
+import "./Actor-fIPLXfoi.js";
+import "./deepsightService-ByNKY5Jv.js";
+import { D as authenticationMachine, S as AuthenticationConfig, b as CreateAuthenticationActorOptions, x as createAuthenticationActor, y as AuthenticationActor } from "./faceCaptureManagerFactory-CL-7T_vH.js";
+import "./camera-biGPWlmx.js";
+import "./types-Z9wv19v2.js";
+import "./types-DYZja-k9.js";
+import "./types-Dv-9WPJX.js";
+import "./types-F0IXbaCB.js";
+import "./StreamCanvasCapture-Ctgyx-oD.js";
+import { n as AuthenticationState, r as createAuthenticationManager, t as AuthenticationManager } from "./authenticationManager-Dve7mGLe.js";
 export { type AuthenticationActor, type AuthenticationConfig, type AuthenticationManager, type AuthenticationState, type CreateAuthenticationActorOptions, authenticationMachine, createAuthenticationActor, createAuthenticationManager };

package/dist/authentication.esm.js

@@ -1,29 +1,29 @@
-import "./WasmUtilProvider-CiEN7Gjn.esm.js";
-import "./api-CESGtpbH.esm.js";
-import "./events-Dvvriq9l.esm.js";
-import "./endpoints-BeTK0Mlt.esm.js";
-import "./stats-BMNUG1AU.esm.js";
-import "./browserSimulation-B1dWiXp7.esm.js";
-import "./platform-SKvEfCBh.esm.js";
-import "./getBrowser-C8DP7oTB.esm.js";
-import "./xstate.esm-C9wncMQa.esm.js";
-import "./BrowserStorageProvider-BpJM-gIl.esm.js";
-import "./MotionSensorProvider-Bx7Mpzt0.esm.js";
-import "./permissionServices-CG3bMSfG.esm.js";
-import "./camera-DJWm3V4g.esm.js";
-import "./faceCaptureManagerFactory-kqbUqtrr.esm.js";
-import "./recordingService-Bn9EdCmz.esm.js";
-import "./ITimerCapability-CB0I1Uf2.esm.js";
-import "./canvas-SKcRBxsk.esm.js";
-import "./backCameraStream-D7Wo4Nbx.esm.js";
-import "./deepsightService-CrHmvx8X.esm.js";
-import "./getDeviceClass-C0olyNFS.esm.js";
-import "./getDeviceClass-C8Do2qYu.esm.js";
-import "./types-DsnEVMhr.esm.js";
-import "./StreamCanvasCapture-ImiDQdVA.esm.js";
-import "./permissionGuards-C1ispV96.esm.js";
-import "./faceCaptureSetup-CtvHWd3x.esm.js";
-import { t as authenticationMachine } from "./authenticationStateMachine-DksVbF_H.esm.js";
-import { r as createAuthenticationActor, t as createAuthenticationManager } from "./authenticationManager-ZNotsWnC.esm.js";
+import "./WasmUtilProvider-CIu373BZ.esm.js";
+import "./api-DUZwyz0o.esm.js";
+import "./events-DN-u67gb.esm.js";
+import "./endpoints-BM2_j_IE.esm.js";
+import "./stats-DntyIiGr.esm.js";
+import "./browserSimulation-CGjpdNA1.esm.js";
+import "./platform-BfoqeM61.esm.js";
+import "./getBrowser-Dv8LZyHE.esm.js";
+import "./xstate.esm-Dkm1jy5u.esm.js";
+import "./BrowserStorageProvider-D5xc7Lqo.esm.js";
+import "./MotionSensorProvider-C9fPAJdS.esm.js";
+import "./permissionServices-CPDboRoE.esm.js";
+import "./camera-x4LjGTjZ.esm.js";
+import "./faceCaptureManagerFactory-BNXZchWX.esm.js";
+import "./recordingService-CxMJP4tQ.esm.js";
+import "./ITimerCapability-BvH0pDwp.esm.js";
+import "./canvas-7uX2izHb.esm.js";
+import "./backCameraStream-iftkf3rd.esm.js";
+import "./deepsightService-CEZrdiW0.esm.js";
+import "./getDeviceClass-C0zrM97a.esm.js";
+import "./getDeviceClass-rXKlXywy.esm.js";
+import "./types-BdVOWGGW.esm.js";
+import "./StreamCanvasCapture-Dr5n_iK1.esm.js";
+import "./permissionGuards-D-Z-lgNj.esm.js";
+import "./faceCaptureSetup-Dqb09D24.esm.js";
+import { t as authenticationMachine } from "./authenticationStateMachine-Chx3ySdT.esm.js";
+import { r as createAuthenticationActor, t as createAuthenticationManager } from "./authenticationManager-BM4LzyV7.esm.js";
 
 export { authenticationMachine, createAuthenticationActor, createAuthenticationManager };

package/dist/{authenticationManager-ZNotsWnC.esm.js → authenticationManager-BM4LzyV7.esm.js}

@@ -1,9 +1,9 @@
-import { t as WasmUtilProvider } from "./WasmUtilProvider-CiEN7Gjn.esm.js";
-import { n as eventModuleNames } from "./events-Dvvriq9l.esm.js";
-import { s as createActor } from "./xstate.esm-C9wncMQa.esm.js";
-import { t as BrowserStorageProvider } from "./BrowserStorageProvider-BpJM-gIl.esm.js";
-import { t as createFaceCaptureManagerFromActor } from "./faceCaptureManagerFactory-kqbUqtrr.esm.js";
-import { t as authenticationMachine } from "./authenticationStateMachine-DksVbF_H.esm.js";
+import { t as WasmUtilProvider } from "./WasmUtilProvider-CIu373BZ.esm.js";
+import { n as eventModuleNames } from "./events-DN-u67gb.esm.js";
+import { s as createActor } from "./xstate.esm-Dkm1jy5u.esm.js";
+import { t as BrowserStorageProvider } from "./BrowserStorageProvider-D5xc7Lqo.esm.js";
+import { t as createFaceCaptureManagerFromActor } from "./faceCaptureManagerFactory-BNXZchWX.esm.js";
+import { t as authenticationMachine } from "./authenticationStateMachine-Chx3ySdT.esm.js";
 
 //#region src/modules/authentication/authenticationActor.ts
 function createAuthenticationActor(options) {
@@ -20,8 +20,17 @@ function createAuthenticationActor(options) {
 
 //#endregion
 //#region src/modules/authentication/authenticationManager.ts
-function createAuthenticationManagerFromActor(actor) {
-	return createFaceCaptureManagerFromActor(actor, eventModuleNames.authFace);
+/**
+* Wraps an authentication actor in a face-capture manager.
+*
+* `visibilityObserver` is an optional override escape-hatch — first-party
+* callers omit it and the downstream factory defaults to
+* `BrowserVisibilityObserverProvider`. Pass a custom or no-op observer to
+* disable `background`/`foreground` tracking or to run in a non-DOM
+* environment (e.g. SSR / tests).
+*/
+function createAuthenticationManagerFromActor(actor, visibilityObserver) {
+	return createFaceCaptureManagerFromActor(actor, eventModuleNames.authFace, visibilityObserver);
 }
 /**
 * Creates an authentication manager instance for handling face authentication flow.

package/dist/{authenticationManager-CIVY80H9.d.ts → authenticationManager-Dve7mGLe.d.ts}

@@ -1,9 +1,19 @@
-import { t as Manager } from "./Manager-BHn8wH8K.js";
-import { b as CreateAuthenticationActorOptions, n as FaceCaptureManagerState, t as FaceCaptureManager, y as AuthenticationActor } from "./faceCaptureManagerFactory-C_hRHx8a.js";
+import { t as Manager } from "./Manager-B2OEDYqf.js";
+import { u as IVisibilityObserverCapability } from "./deepsightService-ByNKY5Jv.js";
+import { b as CreateAuthenticationActorOptions, n as FaceCaptureManagerState, t as FaceCaptureManager, y as AuthenticationActor } from "./faceCaptureManagerFactory-CL-7T_vH.js";
 
 //#region src/modules/authentication/authenticationManager.d.ts
 type AuthenticationState = FaceCaptureManagerState;
-declare function createAuthenticationManagerFromActor(actor: AuthenticationActor): Manager<FaceCaptureManagerState> & {
+/**
+ * Wraps an authentication actor in a face-capture manager.
+ *
+ * `visibilityObserver` is an optional override escape-hatch — first-party
+ * callers omit it and the downstream factory defaults to
+ * `BrowserVisibilityObserverProvider`. Pass a custom or no-op observer to
+ * disable `background`/`foreground` tracking or to run in a non-DOM
+ * environment (e.g. SSR / tests).
+ */
+declare function createAuthenticationManagerFromActor(actor: AuthenticationActor, visibilityObserver?: IVisibilityObserverCapability): Manager<FaceCaptureManagerState> & {
   load(): void;
   nextStep(): Promise<void>;
   requestPermission(): void;

package/dist/{authenticationStateMachine-DksVbF_H.esm.js → authenticationStateMachine-Chx3ySdT.esm.js}

@@ -1,11 +1,11 @@
-import { t as api } from "./api-CESGtpbH.esm.js";
-import { t as endpoints } from "./endpoints-BeTK0Mlt.esm.js";
-import { t as addDeviceStats } from "./stats-BMNUG1AU.esm.js";
-import { a as fromPromise, r as assign } from "./xstate.esm-C9wncMQa.esm.js";
-import { a as defaultPrepareFaceUpload, c as prepareOnDeviceFaceUpload, o as isOnDeviceMode, s as postOnDeviceFaceResults } from "./recordingService-Bn9EdCmz.esm.js";
-import { t as getDeviceClass } from "./getDeviceClass-C8Do2qYu.esm.js";
-import { t as FACE_ERROR_CODES } from "./types-DsnEVMhr.esm.js";
-import { t as faceCaptureMachine } from "./faceCaptureSetup-CtvHWd3x.esm.js";
+import { t as api } from "./api-DUZwyz0o.esm.js";
+import { t as endpoints } from "./endpoints-BM2_j_IE.esm.js";
+import { t as addDeviceStats } from "./stats-DntyIiGr.esm.js";
+import { a as fromPromise, r as assign } from "./xstate.esm-Dkm1jy5u.esm.js";
+import { a as defaultPrepareFaceUpload, c as prepareOnDeviceFaceUpload, o as isOnDeviceMode, s as postOnDeviceFaceResults } from "./recordingService-CxMJP4tQ.esm.js";
+import { t as getDeviceClass } from "./getDeviceClass-rXKlXywy.esm.js";
+import { t as FACE_ERROR_CODES } from "./types-BdVOWGGW.esm.js";
+import { t as faceCaptureMachine } from "./faceCaptureSetup-Dqb09D24.esm.js";
 
 //#region src/modules/authentication/authenticationErrorUtils.ts
 const AUTH_ERROR_MAP = {
@@ -85,6 +85,11 @@ const getAuthErrorCodeFromHttpError = (error) => {
 
 //#endregion
 //#region src/modules/authentication/authenticationStateMachine.ts
+/**
+* Narrow the base machine's opaque `uploadResponse` (Record<string, unknown>)
+* to the auth response shape. Centralizes the one cast the auth variant needs.
+*/
+const authUploadResponse = (context) => context.uploadResponse;
 const _authenticationMachine = faceCaptureMachine.provide({
 	actors: {
 		prepareFaceUpload: fromPromise(async ({ input }) => {
@@ -109,38 +114,30 @@ const _authenticationMachine = faceCaptureMachine.provide({
 	actions: {
 		setUploadErrorFromUploadValidation: assign({ uploadError: ({ context }) => {
 			if (isOnDeviceMode(context.config)) return;
-			const resp = context.uploadResponse;
-			return validateAuthUploadResponse(resp) ?? FACE_ERROR_CODES.SERVER;
+			return validateAuthUploadResponse(authUploadResponse(context)) ?? FACE_ERROR_CODES.SERVER;
 		} }),
 		setTerminalError: assign({ error: ({ context }) => {
-			const resp = context.uploadResponse;
-			const moduleErrorCode = resp ? AUTH_ERROR_MAP[resp.error?.name] : void 0;
 			if (context.attemptsRemaining <= 0) return {
 				type: "FACE_AUTH_ERROR",
 				message: "No more attempts remaining",
-				moduleErrorCode
-			};
-			if (!resp) return {
-				type: "FACE_AUTH_ERROR",
-				message: "Authentication failed"
+				moduleErrorCode: FACE_ERROR_CODES.NO_MORE_ATTEMPTS
 			};
+			const resp = authUploadResponse(context);
 			return {
 				type: "FACE_AUTH_ERROR",
-				message: resp.error?.message ?? resp.error?.name ?? "Face authentication error",
-				moduleErrorCode
+				message: resp?.error.message ?? resp?.error.name ?? "Face authentication error",
+				moduleErrorCode: resp ? AUTH_ERROR_MAP[resp.error.name] : void 0
 			};
 		} })
 	},
 	guards: {
 		hasUploadValidationError: ({ context }) => {
 			if (isOnDeviceMode(context.config)) return false;
-			const resp = context.uploadResponse;
-			return validateAuthUploadResponse(resp) !== void 0;
+			return validateAuthUploadResponse(authUploadResponse(context)) !== void 0;
 		},
 		isTerminalUploadError: ({ context }) => {
 			if (isOnDeviceMode(context.config)) return false;
-			const resp = context.uploadResponse;
-			return isTerminalAuthError(resp, context.attemptsRemaining);
+			return isTerminalAuthError(authUploadResponse(context), context.attemptsRemaining);
 		},
 		isNoAttemptsTerminal: () => true
 	}

package/dist/{backCameraStream-D7Wo4Nbx.esm.js → backCameraStream-iftkf3rd.esm.js}

@@ -1,6 +1,6 @@
-import { a as isIPhone14OrHigher, o as isSafari, r as isIOS, t as isAndroid } from "./platform-SKvEfCBh.esm.js";
-import { i as stopCameraStream, n as enumerateVideoDevices, r as requestCameraAccess, t as applyTrackConstraints } from "./camera-DJWm3V4g.esm.js";
-import { t as sleep } from "./ITimerCapability-CB0I1Uf2.esm.js";
+import { a as isIPhone14OrHigher, o as isSafari, r as isIOS, t as isAndroid } from "./platform-BfoqeM61.esm.js";
+import { i as stopCameraStream, n as enumerateVideoDevices, r as requestCameraAccess, t as applyTrackConstraints } from "./camera-x4LjGTjZ.esm.js";
+import { t as sleep } from "./ITimerCapability-BvH0pDwp.esm.js";
 
 //#region src/internal/camera/backCameraStream.ts
 const BACK_CAMERA_KEYWORDS = [