@sekyro/web 0.1.0-rc.4 → 0.1.0-rc.6

package/dist/core/index.d.cts

@@ -1,5 +1,5 @@
-import { C as CameraErrorKind } from '../capture-session-v3-DEInCOUg.cjs';
-export { a as CLIP_MS, b as CaptureArtifacts, c as CaptureErrorKind, d as CaptureSessionEvents, e as CaptureSessionV3, f as CaptureSessionV3Events, g as CaptureSessionV3Options, h as CaptureState, i as CaptureTiming, j as ClipError, k as ClipErrorKind, l as ClipRecorder, m as ClipResult, D as DEFAULT_CLIP_MIME, n as DEVICE_PROFILES, o as DeviceClass, p as DeviceProbe, q as DeviceProfile, r as DeviceProfiler, E as EscalationClipArtifact, s as EscalationHook, F as FaceGateV3, G as GateChecks, K as KEYFRAME_CANDIDATES, t as KEYFRAME_WINDOW_MS, M as MAX_CLIP_BYTES, u as MIME_CANDIDATES, S as STOP_GRACE_MS, T as TIMESLICE_MS, V as V3ChecksPayload, v as V3GateFactor, w as V3GateQuality, x as V3GateThresholds, y as V3GateTick, z as V3GateTickInput, A as V3TelemetryEvent, B as V3_GATE_DEFAULTS, H as VIDEO_BPS, I as buildLivenessV2FormData, J as cameraPreflight, L as classifyDevice, N as extForMime, O as isClipTooLarge, P as isMediaRecorderSupported, Q as mapGetUserMediaError, R as pickMimeType, U as probeDevice } from '../capture-session-v3-DEInCOUg.cjs';
+import { C as CameraErrorKind } from '../capture-session-v3-UQU_WjO2.cjs';
+export { a as CLIP_MS, b as CaptureArtifacts, c as CaptureErrorKind, d as CaptureSessionEvents, e as CaptureSessionV3, f as CaptureSessionV3Events, g as CaptureSessionV3Options, h as CaptureSessionV3StartOptions, i as CaptureState, j as CaptureTiming, k as ClipError, l as ClipErrorKind, m as ClipRecorder, n as ClipResult, D as DEFAULT_CLIP_MIME, o as DEVICE_PROFILES, p as DeviceClass, q as DeviceProbe, r as DeviceProfile, s as DeviceProfiler, E as EscalationClipArtifact, t as EscalationHook, F as FaceGateV3, G as GateChecks, K as KEYFRAME_CANDIDATES, u as KEYFRAME_WINDOW_MS, M as MAX_CLIP_BYTES, v as MIME_CANDIDATES, S as STOP_GRACE_MS, T as TIMESLICE_MS, V as V3ChecksPayload, w as V3GateFactor, x as V3GateQuality, y as V3GateThresholds, z as V3GateTick, A as V3GateTickInput, B as V3TelemetryEvent, H as V3_GATE_DEFAULTS, I as VIDEO_BPS, J as buildLivenessV2FormData, L as cameraPreflight, N as classifyDevice, O as extForMime, P as isClipTooLarge, Q as isMediaRecorderSupported, R as mapGetUserMediaError, U as pickMimeType, W as probeDevice } from '../capture-session-v3-UQU_WjO2.cjs';
 export { C as CENTERED_FACTOR, a as CIRCLE_RADIUS_FACTOR, I as IN_CIRCLE_FACTOR, b as buildCaptureConstraints, d as detectIsMobile } from '../capture-constraints-BujkZcfb.cjs';
 export { C as CreateDetectorOptions, D as DEFAULT_TIER_ORDER, a as DEFAULT_V3_ASSET_BASE_URL, b as Detector, c as DetectorLadderError, F as FaceObservation, d as createDetector, i as intrinsicSize, t as toStreamPixels } from '../detect-worker-CKXHlXx9.cjs';
 

package/dist/core/index.d.ts

@@ -1,5 +1,5 @@
-import { C as CameraErrorKind } from '../capture-session-v3-uXJr1Wlm.js';
-export { a as CLIP_MS, b as CaptureArtifacts, c as CaptureErrorKind, d as CaptureSessionEvents, e as CaptureSessionV3, f as CaptureSessionV3Events, g as CaptureSessionV3Options, h as CaptureState, i as CaptureTiming, j as ClipError, k as ClipErrorKind, l as ClipRecorder, m as ClipResult, D as DEFAULT_CLIP_MIME, n as DEVICE_PROFILES, o as DeviceClass, p as DeviceProbe, q as DeviceProfile, r as DeviceProfiler, E as EscalationClipArtifact, s as EscalationHook, F as FaceGateV3, G as GateChecks, K as KEYFRAME_CANDIDATES, t as KEYFRAME_WINDOW_MS, M as MAX_CLIP_BYTES, u as MIME_CANDIDATES, S as STOP_GRACE_MS, T as TIMESLICE_MS, V as V3ChecksPayload, v as V3GateFactor, w as V3GateQuality, x as V3GateThresholds, y as V3GateTick, z as V3GateTickInput, A as V3TelemetryEvent, B as V3_GATE_DEFAULTS, H as VIDEO_BPS, I as buildLivenessV2FormData, J as cameraPreflight, L as classifyDevice, N as extForMime, O as isClipTooLarge, P as isMediaRecorderSupported, Q as mapGetUserMediaError, R as pickMimeType, U as probeDevice } from '../capture-session-v3-uXJr1Wlm.js';
+import { C as CameraErrorKind } from '../capture-session-v3-Okq0EQHG.js';
+export { a as CLIP_MS, b as CaptureArtifacts, c as CaptureErrorKind, d as CaptureSessionEvents, e as CaptureSessionV3, f as CaptureSessionV3Events, g as CaptureSessionV3Options, h as CaptureSessionV3StartOptions, i as CaptureState, j as CaptureTiming, k as ClipError, l as ClipErrorKind, m as ClipRecorder, n as ClipResult, D as DEFAULT_CLIP_MIME, o as DEVICE_PROFILES, p as DeviceClass, q as DeviceProbe, r as DeviceProfile, s as DeviceProfiler, E as EscalationClipArtifact, t as EscalationHook, F as FaceGateV3, G as GateChecks, K as KEYFRAME_CANDIDATES, u as KEYFRAME_WINDOW_MS, M as MAX_CLIP_BYTES, v as MIME_CANDIDATES, S as STOP_GRACE_MS, T as TIMESLICE_MS, V as V3ChecksPayload, w as V3GateFactor, x as V3GateQuality, y as V3GateThresholds, z as V3GateTick, A as V3GateTickInput, B as V3TelemetryEvent, H as V3_GATE_DEFAULTS, I as VIDEO_BPS, J as buildLivenessV2FormData, L as cameraPreflight, N as classifyDevice, O as extForMime, P as isClipTooLarge, Q as isMediaRecorderSupported, R as mapGetUserMediaError, U as pickMimeType, W as probeDevice } from '../capture-session-v3-Okq0EQHG.js';
 export { C as CENTERED_FACTOR, a as CIRCLE_RADIUS_FACTOR, I as IN_CIRCLE_FACTOR, b as buildCaptureConstraints, d as detectIsMobile } from '../capture-constraints-BujkZcfb.js';
 export { C as CreateDetectorOptions, D as DEFAULT_TIER_ORDER, a as DEFAULT_V3_ASSET_BASE_URL, b as Detector, c as DetectorLadderError, F as FaceObservation, d as createDetector, i as intrinsicSize, t as toStreamPixels } from '../detect-worker-CKXHlXx9.js';
 

package/dist/core/index.js

@@ -31,7 +31,7 @@ import {
   mapGetUserMediaError,
   pickMimeType,
   probeDevice
-} from "../chunk-EWRNPKTR.js";
+} from "../chunk-TG5IE552.js";
 import {
   DEFAULT_TIER_ORDER,
   DEFAULT_V3_ASSET_BASE_URL,

package/dist/{create-verification-Dkb2tXuY.d.cts → create-verification-BKc9NFQj.d.cts}

@@ -1,5 +1,6 @@
-import { h as CaptureState$1, f as CaptureSessionV3Events, g as CaptureSessionV3Options, c as CaptureErrorKind$1 } from './capture-session-v3-DEInCOUg.cjs';
-import { C as CheckReason, c as HostedSessionView, g as HostedClient, A as AttestationInput, h as SessionView, b as CheckType } from './hosted-client-DWzCRYJK.cjs';
+import { b as Detector } from './detect-worker-CKXHlXx9.cjs';
+import { i as CaptureState$1, f as CaptureSessionV3Events, g as CaptureSessionV3Options, c as CaptureErrorKind$1 } from './capture-session-v3-UQU_WjO2.cjs';
+import { C as CheckReason, f as HostedVoiceView, c as HostedSessionView, i as HostedClient, A as AttestationInput, j as SessionView, b as CheckType } from './hosted-client-DJXq_CB9.cjs';
 
 /** Gate guidance code. `'hold'` is emitted while the clip records. */
 type GateHint = "center" | "closer" | "farther" | "light" | "still" | "hold";
@@ -110,14 +111,28 @@ interface LivenessCaptureEvents {
         animations: "full" | "reduced";
     };
 }
+/** Which camera to open: the selfie camera (`'user'`) or the rear one (`'environment'`). */
+type CameraFacing = "user" | "environment";
+/** Options of {@link LivenessCaptureHandle.start}. */
+interface LivenessStartOptions {
+    /**
+     * Camera for this attempt and its retries; default: the current one
+     * ({@link LivenessCaptureOptions.facing}, else `'user'`). Use `switchCamera()`
+     * to change camera mid-capture.
+     */
+    facing?: CameraFacing;
+}
 /** Live capture handle returned by {@link createLivenessCapture} / {@link Verification.liveness}. */
 interface LivenessCaptureHandle {
     /** Current {@link CaptureState}. */
     readonly state: CaptureState;
     /** Subscribe; returns the unsubscribe function. */
     on<K extends keyof LivenessCaptureEvents>(event: K, handler: (payload: LivenessCaptureEvents[K]) => void): () => void;
-    /** Ask for the camera and start gating. Resolves once the attempt is running or failed. */
-    start(): Promise<void>;
+    /**
+     * Ask for the camera and start gating. Resolves once the attempt is running or failed.
+     * `options.facing` picks the camera for this attempt and later retries.
+     */
+    start(options?: LivenessStartOptions): Promise<void>;
     /** Fresh attempt: resets the engine and restarts the camera. */
     retry(): void;
     /** Toggle user/environment camera (gate restarts from zero). */
@@ -129,10 +144,18 @@ interface LivenessCaptureHandle {
 interface LivenessCaptureOptions {
     /** Host-owned `<video playsInline muted>` element. */
     video: HTMLVideoElement;
-    /** Initial camera; default `'user'`. */
-    facing?: "user" | "environment";
+    /** Initial camera; default `'user'`. `start({ facing })` overrides it. */
+    facing?: CameraFacing;
     /** Base URL of the detector assets (tasks-vision wasm + tflite); default `/models-v3`. */
     assetBaseUrl?: string;
+    /**
+     * Hold a Screen Wake Lock while the camera is live (`starting` / `gating` /
+     * `recording`) so the phone does not dim or lock mid-capture; re-taken when
+     * the page becomes visible again. Best-effort: unsupported browsers or a
+     * refused request (e.g. an iframe without `allow="screen-wake-lock"`) never
+     * affect the capture. Default `true`; `false` never requests the lock.
+     */
+    keepScreenAwake?: boolean;
 }
 /**
  * SDK-side failure reasons (status `'unavailable'`):
@@ -208,6 +231,13 @@ interface Verification {
     startRegistry(): Promise<void>;
     /** Start a liveness capture bound to this verification; the SDK uploads + submits on `captured`. */
     liveness(options: LivenessCaptureOptions): LivenessCaptureHandle;
+    /**
+     * The session's Sekyro-hosted voice clips (`view.voice`), bootstrapping the
+     * hosted view when it has not been fetched yet. Resolves `null` when the
+     * session has no active clip set, the API predates the field, the bootstrap
+     * fails, or the verification was destroyed. Never rejects.
+     */
+    voiceClips(): Promise<HostedVoiceView | null>;
     /** Subscribe; returns the unsubscribe function. */
     on<K extends keyof VerificationEvents>(event: K, handler: (payload: VerificationEvents[K]) => void): () => void;
     /** Destroy the active capture and drop all listeners. */
@@ -218,7 +248,10 @@ interface Verification {
 interface CaptureEngine {
     readonly state: CaptureState$1;
     on<K extends keyof CaptureSessionV3Events>(event: K, handler: (payload: CaptureSessionV3Events[K]) => void): () => void;
-    start(): Promise<void>;
+    /** `facingMode` sets the camera for this attempt and later retries. */
+    start(options?: {
+        facingMode?: "user" | "environment";
+    }): Promise<void>;
     retry(): void;
     switchCamera(): void;
     destroy(): void;
@@ -253,6 +286,57 @@ declare function createLivenessCaptureInternal(options: LivenessCaptureOptions,
  */
 declare function createLivenessCapture(options: LivenessCaptureOptions): LivenessCaptureHandle;
 
+/** Preload state per asset base URL. */
+type LivenessAssetsStatus = "idle" | "loading" | "ready" | "failed";
+/** Options of {@link preloadLivenessAssets}. */
+interface PreloadLivenessAssetsOptions {
+    /** Same value as the capture's `assetBaseUrl`; default `/models-v3`. */
+    assetBaseUrl?: string;
+    /** Defer the load to browser idle time (`requestIdleCallback`, 1.2 s timeout fallback). Default `false`. */
+    idle?: boolean;
+    /** Skip when the browser asks to save data (`navigator.connection.saveData`). Default `false`. */
+    respectSaveData?: boolean;
+}
+/** Blaze init deadline for the preload — generous: a slow ~11 MB wasm download must finish. */
+declare const PRELOAD_BLAZE_INIT_TIMEOUT_MS = 120000;
+/** Outer budget reclaiming only a genuinely hung load (≥ the init deadline + slack). */
+declare const PRELOAD_BUDGET_MS = 130000;
+type Loader = (base: string) => Promise<Detector>;
+/** @internal Test seam: replace the detector loader (null restores the real one). */
+declare function setPreloadLoaderForTests(next: Loader | null): void;
+/** @internal Test seam: drop every entry (destroying warmed detectors). */
+declare function resetLivenessAssetsForTests(): void;
+/**
+ * Warm the face detector for `assetBaseUrl` so the capture starts instantly.
+ * Idempotent per base URL and never rejects: resolves the settled status.
+ * `'idle'` means nothing was preloaded here (SSR, no camera API, Data-Saver
+ * skip) — start normally. Calling again after `'failed'` retries the load.
+ * With `idle: true` the load is deferred (status stays `'idle'` until it
+ * starts); a later non-idle call — or a capture mounting meanwhile — starts it
+ * at once, and {@link releaseLivenessAssets} cancels it.
+ */
+declare function preloadLivenessAssets(options?: PreloadLivenessAssetsOptions): Promise<LivenessAssetsStatus>;
+/** Current preload status for `assetBaseUrl` (default `/models-v3`). */
+declare function getLivenessAssetsStatus(assetBaseUrl?: string): LivenessAssetsStatus;
+/**
+ * Subscribe to status changes for `assetBaseUrl`; returns the unsubscribe
+ * function. Does NOT emit the current status on subscribe (read it with
+ * {@link getLivenessAssetsStatus}) — the
+ * `useSyncExternalStore(subscribe, getSnapshot)` contract, so it plugs into
+ * that hook directly.
+ */
+declare function subscribeLivenessAssets(listener: (status: LivenessAssetsStatus) => void, assetBaseUrl?: string): () => void;
+/** Free the warmed detector (an SPA leaving the flow). Never call while a capture is mounted. */
+declare function releaseLivenessAssets(assetBaseUrl?: string): void;
+/**
+ * @internal The capture engine's detector source when a preload exists for
+ * `assetBaseUrl`: a non-owning view of the warm instance (waiting for an
+ * in-flight load), or — once that load failed — a cold detector OWNED by the
+ * session (default ladder + deadline). `undefined` when nothing was preloaded.
+ * Invoking it on an idle-scheduled preload starts that load now and joins it.
+ */
+declare function preloadedDetectorFactory(assetBaseUrl?: string): (() => Promise<Detector>) | undefined;
+
 /** The client surface the flow needs — `HostedClient` or a test fake. */
 type HostedClientLike = Pick<HostedClient, "getSession" | "recordConsent" | "presign" | "uploadToSpaces" | "completeMedia" | "submitCheck">;
 /** The presign policy allowlist for `kind: 'clip'` (media.policy.ts mirror). */
@@ -368,4 +452,4 @@ declare function createVerification(options: VerificationOptions): Verification;
 /** {@link createVerification} with construction seams (tests / Sekyro-internal hosts). */
 declare function createVerificationInternal(options: VerificationOptions, internals: VerificationInternals): Verification;
 
-export { AttestationError as A, type VerificationInternals as B, type CaptureChannel as C, DEFAULT_API_ORIGIN as D, createLivenessCaptureInternal as E, createVerificationInternal as F, type GateHint as G, type HostedClientLike as H, mapEngineState as I, mapErrorKind as J, mapGuidanceHint as K, type LivenessCaptureEvents as L, randomUuid as M, runLivenessFlow as N, runSubmission as O, PROCESSING_POLL_DELAY_MS as P, type ReasonCode as R, type SdkFailureReason as S, TRANSPORT_REPLAY_ATTEMPTS as T, type Verification as V, type CaptureEngineId as a, type CaptureError as b, type CaptureErrorKind as c, type CaptureState as d, type CapturedArtifacts as e, type GateUpdate as f, type LivenessCaptureHandle as g, type LivenessCaptureOptions as h, type VerificationEvents as i, type VerificationLocale as j, type VerificationOptions as k, type VerificationResult as l, type VerificationStatus as m, createLivenessCapture as n, createVerification as o, CLIP_MIME_ALLOWLIST as p, type CaptureEngine as q, type LivenessCaptureInternalHandle as r, type LivenessCaptureInternals as s, type LivenessFlowDeps as t, type LivenessFlowOutcome as u, PROCESSING_POLL_MAX as v, REGISTRY_RETRY_DELAY_MS as w, type SubmitExecutor as x, type SubmitRuntime as y, TRANSPORT_REPLAY_DELAY_MS as z };
+export { preloadedDetectorFactory as $, AttestationError as A, type LivenessFlowDeps as B, type CameraFacing as C, DEFAULT_API_ORIGIN as D, type LivenessFlowOutcome as E, PRELOAD_BLAZE_INIT_TIMEOUT_MS as F, type GateHint as G, type HostedClientLike as H, PRELOAD_BUDGET_MS as I, PROCESSING_POLL_DELAY_MS as J, PROCESSING_POLL_MAX as K, type LivenessAssetsStatus as L, REGISTRY_RETRY_DELAY_MS as M, type SubmitExecutor as N, type SubmitRuntime as O, type PreloadLivenessAssetsOptions as P, TRANSPORT_REPLAY_DELAY_MS as Q, type ReasonCode as R, type SdkFailureReason as S, TRANSPORT_REPLAY_ATTEMPTS as T, type VerificationInternals as U, type Verification as V, createLivenessCaptureInternal as W, createVerificationInternal as X, mapEngineState as Y, mapErrorKind as Z, mapGuidanceHint as _, type CaptureChannel as a, randomUuid as a0, resetLivenessAssetsForTests as a1, runLivenessFlow as a2, runSubmission as a3, setPreloadLoaderForTests as a4, type CaptureEngineId as b, type CaptureError as c, type CaptureErrorKind as d, type CaptureState as e, type CapturedArtifacts as f, type GateUpdate as g, type LivenessCaptureEvents as h, type LivenessCaptureHandle as i, type LivenessCaptureOptions as j, type LivenessStartOptions as k, type VerificationEvents as l, type VerificationLocale as m, type VerificationOptions as n, type VerificationResult as o, type VerificationStatus as p, createLivenessCapture as q, createVerification as r, getLivenessAssetsStatus as s, preloadLivenessAssets as t, releaseLivenessAssets as u, subscribeLivenessAssets as v, CLIP_MIME_ALLOWLIST as w, type CaptureEngine as x, type LivenessCaptureInternalHandle as y, type LivenessCaptureInternals as z };

package/dist/{create-verification-Ce1y5kJR.d.ts → create-verification-DjcMZHAQ.d.ts}

@@ -1,5 +1,6 @@
-import { h as CaptureState$1, f as CaptureSessionV3Events, g as CaptureSessionV3Options, c as CaptureErrorKind$1 } from './capture-session-v3-uXJr1Wlm.js';
-import { C as CheckReason, c as HostedSessionView, g as HostedClient, A as AttestationInput, h as SessionView, b as CheckType } from './hosted-client-DWzCRYJK.js';
+import { b as Detector } from './detect-worker-CKXHlXx9.js';
+import { i as CaptureState$1, f as CaptureSessionV3Events, g as CaptureSessionV3Options, c as CaptureErrorKind$1 } from './capture-session-v3-Okq0EQHG.js';
+import { C as CheckReason, f as HostedVoiceView, c as HostedSessionView, i as HostedClient, A as AttestationInput, j as SessionView, b as CheckType } from './hosted-client-DJXq_CB9.js';
 
 /** Gate guidance code. `'hold'` is emitted while the clip records. */
 type GateHint = "center" | "closer" | "farther" | "light" | "still" | "hold";
@@ -110,14 +111,28 @@ interface LivenessCaptureEvents {
         animations: "full" | "reduced";
     };
 }
+/** Which camera to open: the selfie camera (`'user'`) or the rear one (`'environment'`). */
+type CameraFacing = "user" | "environment";
+/** Options of {@link LivenessCaptureHandle.start}. */
+interface LivenessStartOptions {
+    /**
+     * Camera for this attempt and its retries; default: the current one
+     * ({@link LivenessCaptureOptions.facing}, else `'user'`). Use `switchCamera()`
+     * to change camera mid-capture.
+     */
+    facing?: CameraFacing;
+}
 /** Live capture handle returned by {@link createLivenessCapture} / {@link Verification.liveness}. */
 interface LivenessCaptureHandle {
     /** Current {@link CaptureState}. */
     readonly state: CaptureState;
     /** Subscribe; returns the unsubscribe function. */
     on<K extends keyof LivenessCaptureEvents>(event: K, handler: (payload: LivenessCaptureEvents[K]) => void): () => void;
-    /** Ask for the camera and start gating. Resolves once the attempt is running or failed. */
-    start(): Promise<void>;
+    /**
+     * Ask for the camera and start gating. Resolves once the attempt is running or failed.
+     * `options.facing` picks the camera for this attempt and later retries.
+     */
+    start(options?: LivenessStartOptions): Promise<void>;
     /** Fresh attempt: resets the engine and restarts the camera. */
     retry(): void;
     /** Toggle user/environment camera (gate restarts from zero). */
@@ -129,10 +144,18 @@ interface LivenessCaptureHandle {
 interface LivenessCaptureOptions {
     /** Host-owned `<video playsInline muted>` element. */
     video: HTMLVideoElement;
-    /** Initial camera; default `'user'`. */
-    facing?: "user" | "environment";
+    /** Initial camera; default `'user'`. `start({ facing })` overrides it. */
+    facing?: CameraFacing;
     /** Base URL of the detector assets (tasks-vision wasm + tflite); default `/models-v3`. */
     assetBaseUrl?: string;
+    /**
+     * Hold a Screen Wake Lock while the camera is live (`starting` / `gating` /
+     * `recording`) so the phone does not dim or lock mid-capture; re-taken when
+     * the page becomes visible again. Best-effort: unsupported browsers or a
+     * refused request (e.g. an iframe without `allow="screen-wake-lock"`) never
+     * affect the capture. Default `true`; `false` never requests the lock.
+     */
+    keepScreenAwake?: boolean;
 }
 /**
  * SDK-side failure reasons (status `'unavailable'`):
@@ -208,6 +231,13 @@ interface Verification {
     startRegistry(): Promise<void>;
     /** Start a liveness capture bound to this verification; the SDK uploads + submits on `captured`. */
     liveness(options: LivenessCaptureOptions): LivenessCaptureHandle;
+    /**
+     * The session's Sekyro-hosted voice clips (`view.voice`), bootstrapping the
+     * hosted view when it has not been fetched yet. Resolves `null` when the
+     * session has no active clip set, the API predates the field, the bootstrap
+     * fails, or the verification was destroyed. Never rejects.
+     */
+    voiceClips(): Promise<HostedVoiceView | null>;
     /** Subscribe; returns the unsubscribe function. */
     on<K extends keyof VerificationEvents>(event: K, handler: (payload: VerificationEvents[K]) => void): () => void;
     /** Destroy the active capture and drop all listeners. */
@@ -218,7 +248,10 @@ interface Verification {
 interface CaptureEngine {
     readonly state: CaptureState$1;
     on<K extends keyof CaptureSessionV3Events>(event: K, handler: (payload: CaptureSessionV3Events[K]) => void): () => void;
-    start(): Promise<void>;
+    /** `facingMode` sets the camera for this attempt and later retries. */
+    start(options?: {
+        facingMode?: "user" | "environment";
+    }): Promise<void>;
     retry(): void;
     switchCamera(): void;
     destroy(): void;
@@ -253,6 +286,57 @@ declare function createLivenessCaptureInternal(options: LivenessCaptureOptions,
  */
 declare function createLivenessCapture(options: LivenessCaptureOptions): LivenessCaptureHandle;
 
+/** Preload state per asset base URL. */
+type LivenessAssetsStatus = "idle" | "loading" | "ready" | "failed";
+/** Options of {@link preloadLivenessAssets}. */
+interface PreloadLivenessAssetsOptions {
+    /** Same value as the capture's `assetBaseUrl`; default `/models-v3`. */
+    assetBaseUrl?: string;
+    /** Defer the load to browser idle time (`requestIdleCallback`, 1.2 s timeout fallback). Default `false`. */
+    idle?: boolean;
+    /** Skip when the browser asks to save data (`navigator.connection.saveData`). Default `false`. */
+    respectSaveData?: boolean;
+}
+/** Blaze init deadline for the preload — generous: a slow ~11 MB wasm download must finish. */
+declare const PRELOAD_BLAZE_INIT_TIMEOUT_MS = 120000;
+/** Outer budget reclaiming only a genuinely hung load (≥ the init deadline + slack). */
+declare const PRELOAD_BUDGET_MS = 130000;
+type Loader = (base: string) => Promise<Detector>;
+/** @internal Test seam: replace the detector loader (null restores the real one). */
+declare function setPreloadLoaderForTests(next: Loader | null): void;
+/** @internal Test seam: drop every entry (destroying warmed detectors). */
+declare function resetLivenessAssetsForTests(): void;
+/**
+ * Warm the face detector for `assetBaseUrl` so the capture starts instantly.
+ * Idempotent per base URL and never rejects: resolves the settled status.
+ * `'idle'` means nothing was preloaded here (SSR, no camera API, Data-Saver
+ * skip) — start normally. Calling again after `'failed'` retries the load.
+ * With `idle: true` the load is deferred (status stays `'idle'` until it
+ * starts); a later non-idle call — or a capture mounting meanwhile — starts it
+ * at once, and {@link releaseLivenessAssets} cancels it.
+ */
+declare function preloadLivenessAssets(options?: PreloadLivenessAssetsOptions): Promise<LivenessAssetsStatus>;
+/** Current preload status for `assetBaseUrl` (default `/models-v3`). */
+declare function getLivenessAssetsStatus(assetBaseUrl?: string): LivenessAssetsStatus;
+/**
+ * Subscribe to status changes for `assetBaseUrl`; returns the unsubscribe
+ * function. Does NOT emit the current status on subscribe (read it with
+ * {@link getLivenessAssetsStatus}) — the
+ * `useSyncExternalStore(subscribe, getSnapshot)` contract, so it plugs into
+ * that hook directly.
+ */
+declare function subscribeLivenessAssets(listener: (status: LivenessAssetsStatus) => void, assetBaseUrl?: string): () => void;
+/** Free the warmed detector (an SPA leaving the flow). Never call while a capture is mounted. */
+declare function releaseLivenessAssets(assetBaseUrl?: string): void;
+/**
+ * @internal The capture engine's detector source when a preload exists for
+ * `assetBaseUrl`: a non-owning view of the warm instance (waiting for an
+ * in-flight load), or — once that load failed — a cold detector OWNED by the
+ * session (default ladder + deadline). `undefined` when nothing was preloaded.
+ * Invoking it on an idle-scheduled preload starts that load now and joins it.
+ */
+declare function preloadedDetectorFactory(assetBaseUrl?: string): (() => Promise<Detector>) | undefined;
+
 /** The client surface the flow needs — `HostedClient` or a test fake. */
 type HostedClientLike = Pick<HostedClient, "getSession" | "recordConsent" | "presign" | "uploadToSpaces" | "completeMedia" | "submitCheck">;
 /** The presign policy allowlist for `kind: 'clip'` (media.policy.ts mirror). */
@@ -368,4 +452,4 @@ declare function createVerification(options: VerificationOptions): Verification;
 /** {@link createVerification} with construction seams (tests / Sekyro-internal hosts). */
 declare function createVerificationInternal(options: VerificationOptions, internals: VerificationInternals): Verification;
 
-export { AttestationError as A, type VerificationInternals as B, type CaptureChannel as C, DEFAULT_API_ORIGIN as D, createLivenessCaptureInternal as E, createVerificationInternal as F, type GateHint as G, type HostedClientLike as H, mapEngineState as I, mapErrorKind as J, mapGuidanceHint as K, type LivenessCaptureEvents as L, randomUuid as M, runLivenessFlow as N, runSubmission as O, PROCESSING_POLL_DELAY_MS as P, type ReasonCode as R, type SdkFailureReason as S, TRANSPORT_REPLAY_ATTEMPTS as T, type Verification as V, type CaptureEngineId as a, type CaptureError as b, type CaptureErrorKind as c, type CaptureState as d, type CapturedArtifacts as e, type GateUpdate as f, type LivenessCaptureHandle as g, type LivenessCaptureOptions as h, type VerificationEvents as i, type VerificationLocale as j, type VerificationOptions as k, type VerificationResult as l, type VerificationStatus as m, createLivenessCapture as n, createVerification as o, CLIP_MIME_ALLOWLIST as p, type CaptureEngine as q, type LivenessCaptureInternalHandle as r, type LivenessCaptureInternals as s, type LivenessFlowDeps as t, type LivenessFlowOutcome as u, PROCESSING_POLL_MAX as v, REGISTRY_RETRY_DELAY_MS as w, type SubmitExecutor as x, type SubmitRuntime as y, TRANSPORT_REPLAY_DELAY_MS as z };
+export { preloadedDetectorFactory as $, AttestationError as A, type LivenessFlowDeps as B, type CameraFacing as C, DEFAULT_API_ORIGIN as D, type LivenessFlowOutcome as E, PRELOAD_BLAZE_INIT_TIMEOUT_MS as F, type GateHint as G, type HostedClientLike as H, PRELOAD_BUDGET_MS as I, PROCESSING_POLL_DELAY_MS as J, PROCESSING_POLL_MAX as K, type LivenessAssetsStatus as L, REGISTRY_RETRY_DELAY_MS as M, type SubmitExecutor as N, type SubmitRuntime as O, type PreloadLivenessAssetsOptions as P, TRANSPORT_REPLAY_DELAY_MS as Q, type ReasonCode as R, type SdkFailureReason as S, TRANSPORT_REPLAY_ATTEMPTS as T, type VerificationInternals as U, type Verification as V, createLivenessCaptureInternal as W, createVerificationInternal as X, mapEngineState as Y, mapErrorKind as Z, mapGuidanceHint as _, type CaptureChannel as a, randomUuid as a0, resetLivenessAssetsForTests as a1, runLivenessFlow as a2, runSubmission as a3, setPreloadLoaderForTests as a4, type CaptureEngineId as b, type CaptureError as c, type CaptureErrorKind as d, type CaptureState as e, type CapturedArtifacts as f, type GateUpdate as g, type LivenessCaptureEvents as h, type LivenessCaptureHandle as i, type LivenessCaptureOptions as j, type LivenessStartOptions as k, type VerificationEvents as l, type VerificationLocale as m, type VerificationOptions as n, type VerificationResult as o, type VerificationStatus as p, createLivenessCapture as q, createVerification as r, getLivenessAssetsStatus as s, preloadLivenessAssets as t, releaseLivenessAssets as u, subscribeLivenessAssets as v, CLIP_MIME_ALLOWLIST as w, type CaptureEngine as x, type LivenessCaptureInternalHandle as y, type LivenessCaptureInternals as z };

package/dist/{hosted-client-DWzCRYJK.d.cts → hosted-client-DJXq_CB9.d.cts}

@@ -67,6 +67,28 @@ interface HostedStepView {
     /** phone_otp only: the display-safe OTP send/config surface (never the verifToken). */
     otp?: HostedOtpView;
 }
+/** A locale the Sekyro-hosted voice clips are recorded in. */
+type HostedVoiceLocale = "ar" | "fr" | "en";
+/**
+ * The session's Sekyro-hosted voice-guidance clips (the active clip set).
+ *
+ * `clips[locale]` maps a voice key (`fcv3.*`, the `@sekyro/react` voice-key
+ * namespace) to an ABSOLUTE URL on the Sekyro assets host
+ * (`https://assets.sekyro.ai/voice/<setId>/<locale>/<name>.mp3`; staging:
+ * `assets-staging.sekyro.ai`). URLs are immutable per `setId`. A locale or key
+ * may be missing — the player falls back to the device voice for it.
+ *
+ * A page with a Content-Security-Policy must allow the assets origin in
+ * `media-src` for the clips to play (see the partner web-SDK guide, CSP note).
+ */
+interface HostedVoiceView {
+    /** Identifier of the active clip set (part of every clip URL). */
+    setId: string;
+    /** Per-locale map of voice key (`fcv3.*`) → absolute clip URL. */
+    clips: {
+        readonly [L in HostedVoiceLocale]?: Readonly<Record<string, string>>;
+    };
+}
 /**
  * Token-addressed hosted-page bootstrap (`GET /hosted/session`). A separate
  * shape from the partner `SessionView`: `sessionId` instead of `id`,
@@ -110,6 +132,12 @@ interface HostedSessionView {
      * valid (additive field, always on the wire from Task 8 onward).
      */
     nniBound?: boolean;
+    /**
+     * The Sekyro-hosted voice-guidance clips of this session, or `null` when no
+     * clip set is active (the device voice is used). Optional: older APIs omit
+     * the field — treat absent like `null`.
+     */
+    voice?: HostedVoiceView | null;
 }
 /** `POST /hosted/consent` result — 201 on first record, 200 `{alreadyRecorded: true}` on replay. */
 interface RecordConsentResult {
@@ -418,4 +446,4 @@ declare class HostedClient {
     private api;
 }
 
-export { type AttestationInput as A, type CheckReason as C, type DocReason as D, type FaceMatchReason as F, type HostedOtpView as H, type LivenessReason as L, type MediaCheckType as M, type PhoneOtpReason as P, type RecordConsentResult as R, type SessionOutcome as S, type UploadMedia as U, type CheckState as a, type CheckType as b, type HostedSessionView as c, type HostedStepView as d, type PopulationReason as e, type SessionStatus as f, HostedClient as g, type SessionView as h, type CheckInputByType as i, type CompleteMediaResult as j, type ConsentLocale as k, type DocOcrInput as l, type DocSide as m, type FaceMatchInput as n, type HostedClientOptions as o, type LivenessCaptureInput as p, type LivenessInput as q, type MediaKind as r, type PhoneOtpInput as s, type PopulationInput as t, type PresignRequest as u, type PresignUploadResult as v, type SessionStepView as w, type SubmitCheckBody as x, type SubmitOptions as y, stripMimeParams as z };
+export { type AttestationInput as A, type SubmitOptions as B, type CheckReason as C, type DocReason as D, stripMimeParams as E, type FaceMatchReason as F, type HostedOtpView as H, type LivenessReason as L, type MediaCheckType as M, type PhoneOtpReason as P, type RecordConsentResult as R, type SessionOutcome as S, type UploadMedia as U, type CheckState as a, type CheckType as b, type HostedSessionView as c, type HostedStepView as d, type HostedVoiceLocale as e, type HostedVoiceView as f, type PopulationReason as g, type SessionStatus as h, HostedClient as i, type SessionView as j, type CheckInputByType as k, type CompleteMediaResult as l, type ConsentLocale as m, type DocOcrInput as n, type DocSide as o, type FaceMatchInput as p, type HostedClientOptions as q, type LivenessCaptureInput as r, type LivenessInput as s, type MediaKind as t, type PhoneOtpInput as u, type PopulationInput as v, type PresignRequest as w, type PresignUploadResult as x, type SessionStepView as y, type SubmitCheckBody as z };

package/dist/{hosted-client-DWzCRYJK.d.ts → hosted-client-DJXq_CB9.d.ts}

@@ -67,6 +67,28 @@ interface HostedStepView {
     /** phone_otp only: the display-safe OTP send/config surface (never the verifToken). */
     otp?: HostedOtpView;
 }
+/** A locale the Sekyro-hosted voice clips are recorded in. */
+type HostedVoiceLocale = "ar" | "fr" | "en";
+/**
+ * The session's Sekyro-hosted voice-guidance clips (the active clip set).
+ *
+ * `clips[locale]` maps a voice key (`fcv3.*`, the `@sekyro/react` voice-key
+ * namespace) to an ABSOLUTE URL on the Sekyro assets host
+ * (`https://assets.sekyro.ai/voice/<setId>/<locale>/<name>.mp3`; staging:
+ * `assets-staging.sekyro.ai`). URLs are immutable per `setId`. A locale or key
+ * may be missing — the player falls back to the device voice for it.
+ *
+ * A page with a Content-Security-Policy must allow the assets origin in
+ * `media-src` for the clips to play (see the partner web-SDK guide, CSP note).
+ */
+interface HostedVoiceView {
+    /** Identifier of the active clip set (part of every clip URL). */
+    setId: string;
+    /** Per-locale map of voice key (`fcv3.*`) → absolute clip URL. */
+    clips: {
+        readonly [L in HostedVoiceLocale]?: Readonly<Record<string, string>>;
+    };
+}
 /**
  * Token-addressed hosted-page bootstrap (`GET /hosted/session`). A separate
  * shape from the partner `SessionView`: `sessionId` instead of `id`,
@@ -110,6 +132,12 @@ interface HostedSessionView {
      * valid (additive field, always on the wire from Task 8 onward).
      */
     nniBound?: boolean;
+    /**
+     * The Sekyro-hosted voice-guidance clips of this session, or `null` when no
+     * clip set is active (the device voice is used). Optional: older APIs omit
+     * the field — treat absent like `null`.
+     */
+    voice?: HostedVoiceView | null;
 }
 /** `POST /hosted/consent` result — 201 on first record, 200 `{alreadyRecorded: true}` on replay. */
 interface RecordConsentResult {
@@ -418,4 +446,4 @@ declare class HostedClient {
     private api;
 }
 
-export { type AttestationInput as A, type CheckReason as C, type DocReason as D, type FaceMatchReason as F, type HostedOtpView as H, type LivenessReason as L, type MediaCheckType as M, type PhoneOtpReason as P, type RecordConsentResult as R, type SessionOutcome as S, type UploadMedia as U, type CheckState as a, type CheckType as b, type HostedSessionView as c, type HostedStepView as d, type PopulationReason as e, type SessionStatus as f, HostedClient as g, type SessionView as h, type CheckInputByType as i, type CompleteMediaResult as j, type ConsentLocale as k, type DocOcrInput as l, type DocSide as m, type FaceMatchInput as n, type HostedClientOptions as o, type LivenessCaptureInput as p, type LivenessInput as q, type MediaKind as r, type PhoneOtpInput as s, type PopulationInput as t, type PresignRequest as u, type PresignUploadResult as v, type SessionStepView as w, type SubmitCheckBody as x, type SubmitOptions as y, stripMimeParams as z };
+export { type AttestationInput as A, type SubmitOptions as B, type CheckReason as C, type DocReason as D, stripMimeParams as E, type FaceMatchReason as F, type HostedOtpView as H, type LivenessReason as L, type MediaCheckType as M, type PhoneOtpReason as P, type RecordConsentResult as R, type SessionOutcome as S, type UploadMedia as U, type CheckState as a, type CheckType as b, type HostedSessionView as c, type HostedStepView as d, type HostedVoiceLocale as e, type HostedVoiceView as f, type PopulationReason as g, type SessionStatus as h, HostedClient as i, type SessionView as j, type CheckInputByType as k, type CompleteMediaResult as l, type ConsentLocale as m, type DocOcrInput as n, type DocSide as o, type FaceMatchInput as p, type HostedClientOptions as q, type LivenessCaptureInput as r, type LivenessInput as s, type MediaKind as t, type PhoneOtpInput as u, type PopulationInput as v, type PresignRequest as w, type PresignUploadResult as x, type SessionStepView as y, type SubmitCheckBody as z };