@incodetech/core 2.1.0-rc.1 → 2.1.0-rc.3

package/dist/StreamCanvasCapture-DS1TOoiH.d.ts

@@ -0,0 +1,42 @@
+import { t as CameraStream } from "./camera-CNVUo-bC.js";
+import { t as IncodeCanvas } from "./canvas-CJUmoXSD.js";
+
+//#region ../infra/src/media/StreamCanvasCapture.d.ts
+type StreamCanvasCaptureOptions = {
+  fps?: number;
+  width?: number;
+  height?: number;
+};
+type StreamCanvasCaptureEventMap = {
+  frame: Event;
+};
+declare class StreamCanvasCapture {
+  private video;
+  private canvas;
+  private ctx;
+  private rafId;
+  private lastFrameTimeSeconds;
+  private lastTickTimeMs;
+  private hasFrame;
+  private disposed;
+  private eventTarget;
+  constructor(stream: CameraStream, options?: StreamCanvasCaptureOptions);
+  addEventListener(type: keyof StreamCanvasCaptureEventMap, listener: EventListenerOrEventListenerObject | null, options?: boolean | AddEventListenerOptions): void;
+  removeEventListener(type: keyof StreamCanvasCaptureEventMap, listener: EventListenerOrEventListenerObject | null, options?: boolean | EventListenerOptions): void;
+  /**
+   * Returns the latest cached frame as an {@link IncodeCanvas}.
+   */
+  getLatestCanvas(): IncodeCanvas | null;
+  /**
+   * Returns the latest cached frame as raw {@link ImageData}.
+   */
+  getLatestFrame(): ImageData | null;
+  /**
+   * Disposes internal resources and stops the capture loop.
+   */
+  dispose(): void;
+  private rafLoop;
+  private tick;
+}
+//#endregion
+export { StreamCanvasCapture as t };

package/dist/{WasmUtilProvider-BKWm8rSA.esm.js → WasmUtilProvider-ADG54T6M.esm.js}

@@ -765,6 +765,9 @@ var MlWasmJSApi = class MlWasmJSApi {
 	setInspectorOpened(inspectorOpened) {
 		this.inspectorOpened_ = inspectorOpened;
 	}
+	getInspectorOpened() {
+		return this.inspectorOpened_;
+	}
 	setBackgroundMode(backgroundMode) {
 		this.checkWasmInitialization("Unable to set background mode, cpp API hasn't been initialized");
 		this.utilityApi.setBackgroundMode(backgroundMode);
@@ -912,18 +915,28 @@ const DEFAULT_PIPELINE_MODELS = {
 		"ondevice_physical_liveness_v2_1_fp16.ortmodelv2",
 		"age_estimation_v2_2_2_fp16.ortmodelv2"
 	],
-	idCapture: ["id_capture_2_01_fp16.ortmodelv2", "id_fiqa_19a81a0b9bf6492eb03b4667f6db4c85_fp16.ortmodelv2"]
+	idCapture: ["id_capture_2_01_fp16.ortmodelv2", "id_fiqa_19a81a0b9bf6492eb03b4667f6db4c85_fp16.ortmodelv2"],
+	videoSelfie: [
+		"selfie_bf_angles_192x192_opset9_fp16.ortmodelv2",
+		"face_attributes_v1_3_fp16.ortmodelv2",
+		"mls_regressor_4773007c657b4f05a460321456740d0f_fp16.ortmodelv2",
+		"face_occlusion_v0_2_fp16.ortmodelv2"
+	],
+	videoSelfieId: ["id_capture_2_01_fp16.ortmodelv2"]
 };
 let state = "idle";
 let loadingPromise = null;
 let wasmError = null;
 let loadedPipelines = [];
 let lastConfig = null;
+let pipelinesInFlight = [];
 function mapPipelineToWasmType(pipeline) {
 	switch (pipeline) {
 		case "selfie": return WasmPipelineType.SelfieWithQualityMetrics;
 		case "onDeviceSelfie": return WasmPipelineType.OnDeviceSelfieWorkflow;
 		case "idCapture": return WasmPipelineType.IdBlurGlarePipeline;
+		case "videoSelfie": return WasmPipelineType.SelfieWithAggregationMetrics;
+		case "videoSelfieId": return WasmPipelineType.IdVideoSelfiePipeline;
 		default: throw new Error(`Unknown pipeline: ${pipeline}`);
 	}
 }
@@ -985,13 +998,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 {
@@ -1010,12 +1028,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 {
@@ -1034,6 +1054,7 @@ async function warmupWasm(config) {
 			state = "error";
 			wasmError = error instanceof Error ? error : new Error(String(error));
 			loadingPromise = null;
+			pipelinesInFlight = [];
 			throw wasmError;
 		}
 	})();
@@ -1231,6 +1252,9 @@ var WasmUtilProvider = class WasmUtilProvider extends BaseWasmProvider {
 		this.ensureInitialized();
 		mlWasmJSApi_default.setInspectorOpened(opened);
 	}
+	getInspectorOpened() {
+		return mlWasmJSApi_default.getInspectorOpened();
+	}
 	/**
 	* Toggles the WASM module's production mode. When `true`, the native module
 	* suppresses its verbose debug logging/console output; when `false`, those

package/dist/{addressSearch-DvmWXKZg.esm.js → addressSearch-DJyNTg5S.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-CHloo0eQ.esm.js";
+import { t as api } from "./api-DsbUi7TO.esm.js";
+import { t as endpoints } from "./endpoints-BzMJFAPV.esm.js";
+import { i as fromCallback } from "./xstate.esm-Bomq1a0z.esm.js";
 
 //#region src/shared/usStates.ts
 const usStates = {

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

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

package/dist/ae-signature.d.ts

@@ -1,6 +1,7 @@
-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 "./StateMachine-C_AY4cs7.js";
+import { t as Manager } from "./Manager-CJ3G2zqi.js";
+import "./Actor-CGEelYtQ.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-Icld-cKW.js";
 
 //#region src/modules/ae-signature/index.d.ts
 

package/dist/ae-signature.esm.js

@@ -1,9 +1,12 @@
-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-DsbUi7TO.esm.js";
+import "./events-CqGY1yMq.esm.js";
+import "./types-ElOJAGaM.esm.js";
+import "./endpoints-BzMJFAPV.esm.js";
+import "./xstate.esm-Bomq1a0z.esm.js";
+import "./urlUtils-BZqFU9rR.esm.js";
+import "./externalFetch-CyhBfD-n.esm.js";
+import "./apiError-DNS2OCEX.esm.js";
+import { a as areAllConsented, n as electronicSignatureMachine, r as AE_CONSENT_KEYS, s as getDefaultConsentChecks } from "./electronicSignatureManager-DjzUzqZj.esm.js";
+import { t as createAeSignatureManager } from "./ae-signature-DlElqFrZ.esm.js";
 
 export { AE_CONSENT_KEYS, electronicSignatureMachine as aeSignatureMachine, areAllConsented, createAeSignatureManager, getDefaultConsentChecks };

package/dist/antifraud.d.ts

@@ -1,6 +1,7 @@
-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 "./StateMachine-C_AY4cs7.js";
+import "./Manager-CJ3G2zqi.js";
+import "./Actor-CGEelYtQ.js";
+import { i as createAntifraudManagerFromActor, n as AntifraudState, o as antifraudMachine, r as createAntifraudManager, t as AntifraudManager } from "./antifraudManager-DpIvbrZP.js";
 
 //#region src/modules/antifraud/types.d.ts
 

package/dist/antifraud.esm.js

@@ -1,8 +1,9 @@
-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-DsbUi7TO.esm.js";
+import "./events-CqGY1yMq.esm.js";
+import "./types-ElOJAGaM.esm.js";
+import "./endpoints-BzMJFAPV.esm.js";
+import "./xstate.esm-Bomq1a0z.esm.js";
+import { t as antifraudMachine } from "./antifraudStateMachine-C0NGnP9W.esm.js";
+import { n as createAntifraudManagerFromActor, t as createAntifraudManager } from "./antifraudManager-BKdQoMFf.esm.js";
 
 export { antifraudMachine, createAntifraudManager, createAntifraudManagerFromActor };

package/dist/antifraudManager-BKdQoMFf.esm.js

@@ -0,0 +1,84 @@
+import { n as createManagerInstrumentation, t as topLevelStateName } from "./events-CqGY1yMq.esm.js";
+import { n as eventModuleNames } from "./types-ElOJAGaM.esm.js";
+import { l as createManager, s as createActor } from "./xstate.esm-Bomq1a0z.esm.js";
+import { t as antifraudMachine } from "./antifraudStateMachine-C0NGnP9W.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/{antifraudManager-CznnhyvD.d.ts → antifraudManager-DpIvbrZP.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-CJ3G2zqi.js";
+import { t as ActorRefFrom } from "./Actor-CGEelYtQ.js";
 
 //#region src/modules/antifraud/antifraudStateMachine.d.ts
 declare const antifraudMachine: any;

package/dist/{antifraudStateMachine-Ccrb-Jxc.esm.js → antifraudStateMachine-C0NGnP9W.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-DsbUi7TO.esm.js";
+import { t as endpoints } from "./endpoints-BzMJFAPV.esm.js";
+import { a as fromPromise, t as setup } from "./xstate.esm-Bomq1a0z.esm.js";
 
 //#region src/modules/antifraud/antifraudServices.ts
 async function processAntifraud(signal) {

package/dist/{api-CESGtpbH.esm.js → api-DsbUi7TO.esm.js}

@@ -21,13 +21,32 @@ function resetApi() {
 	client = null;
 	currentToken = null;
 }
+/**
+* Header-precedence contract: when a caller passes
+* `X-Incode-Hardware-Id` in `config.headers`, their value wins over
+* `currentToken`. Spreading `config?.headers` LAST achieves that
+* (later keys overwrite earlier ones in object spread).
+*
+* Existing call sites that already pass an explicit
+* `X-Incode-Hardware-Id` header (`recordingsRepository.uploadDeepsightVideo`,
+* `internal/virtualCameraCheck.logFrame`) now use the value they
+* passed in unconditionally — previously the auto-injection silently
+* clobbered them. Both call sites pass tokens that are already
+* supposed to be the active session token, so behaviour is
+* unchanged in practice; the change unblocks personhood (which
+* needs to attach its own slot's token) without bypassing the
+* shared `api` wrapper.
+*
+* Regression coverage lives in `api.test.ts → "should let explicit
+* X-Incode-Hardware-Id override the auto-injected token"`.
+*/
 function addTokenHeader(config) {
 	if (!currentToken) return config ?? {};
 	return {
 		...config,
 		headers: {
-			...config?.headers,
-			"X-Incode-Hardware-Id": currentToken
+			"X-Incode-Hardware-Id": currentToken,
+			...config?.headers
 		}
 	};
 }

package/dist/authentication.d.ts

@@ -1,14 +1,20 @@
-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-CjdBUS6s.js";
-import "./camera-SRBpPq2X.js";
-import "./types-Bj9hdFjU.js";
-import "./types-DvGZI7BF.js";
-import "./types-DOUhndhT.js";
-import "./deepsightService-Dh5P-hLf.js";
-import "./types-ya0LN_MX.js";
-import "./StreamCanvasCapture-yyl20qd9.js";
-import { n as AuthenticationState, r as createAuthenticationManager, t as AuthenticationManager } from "./authenticationManager-CaiQbp-q.js";
+import "./warmup-BJZPQIiX.js";
+import "./StateMachine-C_AY4cs7.js";
+import "./Manager-CJ3G2zqi.js";
+import "./Actor-CGEelYtQ.js";
+import "./IVisibilityObserverCapability-BbWjgpiF.js";
+import { S as authenticationMachine, b as createAuthenticationActor, v as AuthenticationActor, x as AuthenticationConfig, y as CreateAuthenticationActorOptions } from "./faceCaptureManagerFactory-CGKbf7zt.js";
+import "./camera-CNVUo-bC.js";
+import "./types-DgGlgyZT.js";
+import "./types-D_IceWxT.js";
+import "./canvas-CJUmoXSD.js";
+import "./createFaceAvatar-B8pFpy6o.js";
+import "./types-BsYXnC5s.js";
+import "./IWasmUtilCapability-d2XvzaCk.js";
+import "./types-Duy2rDxF.js";
+import "./types-CxW2e0Ar.js";
+import "./FaceDetectionProvider-B78455D4.js";
+import "./StreamCanvasCapture-DS1TOoiH.js";
+import "./deepsightService-CMB9XjES.js";
+import { n as AuthenticationState, r as createAuthenticationManager, t as AuthenticationManager } from "./authenticationManager-CdPbNS2H.js";
 export { type AuthenticationActor, type AuthenticationConfig, type AuthenticationManager, type AuthenticationState, type CreateAuthenticationActorOptions, authenticationMachine, createAuthenticationActor, createAuthenticationManager };

package/dist/authentication.esm.js

@@ -1,29 +1,35 @@
-import "./WasmUtilProvider-BKWm8rSA.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-Doec4X5L.esm.js";
-import "./camera-DJWm3V4g.esm.js";
-import "./faceCaptureManagerFactory-ej2j1LMr.esm.js";
-import "./recordingService-yRw7hfzU.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-D0wGddy7.esm.js";
-import "./faceCaptureSetup-B9t6bYze.esm.js";
-import { t as authenticationMachine } from "./authenticationStateMachine-DkcGUMw5.esm.js";
-import { r as createAuthenticationActor, t as createAuthenticationManager } from "./authenticationManager-BlR6mSaG.esm.js";
+import "./WasmUtilProvider-ADG54T6M.esm.js";
+import "./api-DsbUi7TO.esm.js";
+import "./events-CqGY1yMq.esm.js";
+import "./types-ElOJAGaM.esm.js";
+import "./endpoints-BzMJFAPV.esm.js";
+import "./stats-CYcScXcO.esm.js";
+import "./browserSimulation-TsSoavQv.esm.js";
+import "./thumbmarkAdapter-fHBUDlAP.esm.js";
+import "./platform-uIVQUnJP.esm.js";
+import "./xstate.esm-Bomq1a0z.esm.js";
+import "./faceCaptureSetup-CDUVU1nl.esm.js";
+import "./BrowserVisibilityObserverProvider-rim9Jrz-.esm.js";
+import "./MotionSensorProvider-DCbId4De.esm.js";
+import "./permissionServices-BJhGL13R.esm.js";
+import "./camera-DUkgmYMo.esm.js";
+import "./faceCaptureManagerFactory-2brKTzMb.esm.js";
+import "./BrowserStorageProvider-CrrN540a.esm.js";
+import "./onDeviceFaceResults-DVBggeq8.esm.js";
+import "./ITimerCapability-pltuG1E8.esm.js";
+import "./canvas-_I95hkPg.esm.js";
+import "./backCameraStream-ZyqrFyjO.esm.js";
+import "./video-C2WIj6TS.esm.js";
+import "./getDeviceClass-DavNdcxh.esm.js";
+import "./deepsightService-CDahSjGP.esm.js";
+import "./getDeviceClass-DGGzzfqm.esm.js";
+import "./types-CMcxlSmH.esm.js";
+import "./createFaceAvatar-BOHDKQRq.esm.js";
+import "./StreamCanvasCapture-Bz17q4FP.esm.js";
+import "./permissionGuards-BR2oN573.esm.js";
+import "./recordingService-m_1xCthr.esm.js";
+import "./mediaRecorderOptions-C3NAkVgK.esm.js";
+import { t as authenticationMachine } from "./authenticationStateMachine-D-hOlg8p.esm.js";
+import { r as createAuthenticationActor, t as createAuthenticationManager } from "./authenticationManager-Dtl1vcET.esm.js";
 
 export { authenticationMachine, createAuthenticationActor, createAuthenticationManager };

package/dist/{authenticationManager-CaiQbp-q.d.ts → authenticationManager-CdPbNS2H.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-CjdBUS6s.js";
+import { t as Manager } from "./Manager-CJ3G2zqi.js";
+import { t as IVisibilityObserverCapability } from "./IVisibilityObserverCapability-BbWjgpiF.js";
+import { n as FaceCaptureManagerState, t as FaceCaptureManager, v as AuthenticationActor, y as CreateAuthenticationActorOptions } from "./faceCaptureManagerFactory-CGKbf7zt.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/{authenticationManager-BlR6mSaG.esm.js → authenticationManager-Dtl1vcET.esm.js}

@@ -1,9 +1,9 @@
-import { t as WasmUtilProvider } from "./WasmUtilProvider-BKWm8rSA.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-ej2j1LMr.esm.js";
-import { t as authenticationMachine } from "./authenticationStateMachine-DkcGUMw5.esm.js";
+import { t as WasmUtilProvider } from "./WasmUtilProvider-ADG54T6M.esm.js";
+import { n as eventModuleNames } from "./types-ElOJAGaM.esm.js";
+import { s as createActor } from "./xstate.esm-Bomq1a0z.esm.js";
+import { t as createFaceCaptureManagerFromActor } from "./faceCaptureManagerFactory-2brKTzMb.esm.js";
+import { t as BrowserStorageProvider } from "./BrowserStorageProvider-CrrN540a.esm.js";
+import { t as authenticationMachine } from "./authenticationStateMachine-D-hOlg8p.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/{authenticationStateMachine-DkcGUMw5.esm.js → authenticationStateMachine-D-hOlg8p.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-yRw7hfzU.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-B9t6bYze.esm.js";
+import { t as api } from "./api-DsbUi7TO.esm.js";
+import { t as endpoints } from "./endpoints-BzMJFAPV.esm.js";
+import { t as addDeviceStats } from "./stats-CYcScXcO.esm.js";
+import { a as fromPromise, r as assign } from "./xstate.esm-Bomq1a0z.esm.js";
+import { t as faceCaptureMachine } from "./faceCaptureSetup-CDUVU1nl.esm.js";
+import { i as prepareOnDeviceFaceUpload, n as isOnDeviceMode, r as postOnDeviceFaceResults, t as defaultPrepareFaceUpload } from "./onDeviceFaceResults-DVBggeq8.esm.js";
+import { t as getDeviceClass } from "./getDeviceClass-DGGzzfqm.esm.js";
+import { t as FACE_ERROR_CODES } from "./types-CMcxlSmH.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/avatar.d.ts

@@ -0,0 +1,3 @@
+import "./canvas-CJUmoXSD.js";
+import { i as createFaceAvatar, n as FaceAvatarHandle, o as AvatarFaceState, r as FaceAvatarOptions, t as AvatarId } from "./createFaceAvatar-B8pFpy6o.js";
+export { type AvatarFaceState, type AvatarId, type FaceAvatarHandle, type FaceAvatarOptions, createFaceAvatar };

package/dist/avatar.esm.js

@@ -0,0 +1,3 @@
+import { t as createFaceAvatar } from "./createFaceAvatar-BOHDKQRq.esm.js";
+
+export { createFaceAvatar };

package/dist/{backCameraStream-D7Wo4Nbx.esm.js → backCameraStream-ZyqrFyjO.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-uIVQUnJP.esm.js";
+import { a as stopCameraStream, n as enumerateVideoDevices, r as requestCameraAccess, t as applyTrackConstraints } from "./camera-DUkgmYMo.esm.js";
+import { t as sleep } from "./ITimerCapability-pltuG1E8.esm.js";
 
 //#region src/internal/camera/backCameraStream.ts
 const BACK_CAMERA_KEYWORDS = [