@sekyro/web 0.1.0-rc.3 → 0.1.0-rc.5

package/dist/core/index.d.cts

@@ -1,5 +1,5 @@
-import { C as CameraErrorKind } from '../capture-session-v3-COIO_F2w.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 ClipError, j as ClipErrorKind, k as ClipRecorder, l as ClipResult, D as DEFAULT_CLIP_MIME, m as DEVICE_PROFILES, n as DeviceClass, o as DeviceProbe, p as DeviceProfile, q as DeviceProfiler, E as EscalationClipArtifact, r as EscalationHook, F as FaceGateV3, G as GateChecks, K as KEYFRAME_CANDIDATES, s as KEYFRAME_WINDOW_MS, M as MAX_CLIP_BYTES, t as MIME_CANDIDATES, S as STOP_GRACE_MS, T as TIMESLICE_MS, V as V3ChecksPayload, u as V3GateFactor, v as V3GateQuality, w as V3GateThresholds, x as V3GateTick, y as V3GateTickInput, z as V3TelemetryEvent, A as V3_GATE_DEFAULTS, B as VIDEO_BPS, H as buildLivenessV2FormData, I as cameraPreflight, J as classifyDevice, L as extForMime, N as isClipTooLarge, O as isMediaRecorderSupported, P as mapGetUserMediaError, Q as pickMimeType, R as probeDevice } from '../capture-session-v3-COIO_F2w.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-CvIfcwST.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 ClipError, j as ClipErrorKind, k as ClipRecorder, l as ClipResult, D as DEFAULT_CLIP_MIME, m as DEVICE_PROFILES, n as DeviceClass, o as DeviceProbe, p as DeviceProfile, q as DeviceProfiler, E as EscalationClipArtifact, r as EscalationHook, F as FaceGateV3, G as GateChecks, K as KEYFRAME_CANDIDATES, s as KEYFRAME_WINDOW_MS, M as MAX_CLIP_BYTES, t as MIME_CANDIDATES, S as STOP_GRACE_MS, T as TIMESLICE_MS, V as V3ChecksPayload, u as V3GateFactor, v as V3GateQuality, w as V3GateThresholds, x as V3GateTick, y as V3GateTickInput, z as V3TelemetryEvent, A as V3_GATE_DEFAULTS, B as VIDEO_BPS, H as buildLivenessV2FormData, I as cameraPreflight, J as classifyDevice, L as extForMime, N as isClipTooLarge, O as isMediaRecorderSupported, P as mapGetUserMediaError, Q as pickMimeType, R as probeDevice } from '../capture-session-v3-CvIfcwST.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-7TC6TOZ4.js";
+} from "../chunk-TG5IE552.js";
 import {
   DEFAULT_TIER_ORDER,
   DEFAULT_V3_ASSET_BASE_URL,

package/dist/{create-verification-CswF2As-.d.ts → create-verification-CA-3szPI.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-CvIfcwST.js';
-import { C as CheckReason, c as HostedSessionView, g as HostedClient, A as AttestationInput, h as SessionView, b as CheckType } from './hosted-client-BpvBqu9f.js';
+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, c as HostedSessionView, g as HostedClient, A as AttestationInput, h as SessionView, b as CheckType } from './hosted-client-DWzCRYJK.cjs';
 
 /** Gate guidance code. `'hold'` is emitted while the clip records. */
 type GateHint = "center" | "closer" | "farther" | "light" | "still" | "hold";
@@ -47,7 +48,30 @@ interface CapturedArtifacts {
     captureChannel: CaptureChannel;
     /** Set when the browser has no MediaRecorder: a keyframe-only capture. */
     degraded?: "NO_RECORDER";
+    /** The capture engine that produced the artifacts (`'v3'` for this SDK). Always set by the SDK; optional in the type so host-built fixtures stay valid. */
+    engine?: CaptureEngineId;
+    /**
+     * Camera request (`getUserMedia`) → the preview is live, in whole
+     * milliseconds measured with `performance.now()`. Part of the face-capture
+     * timing the SDK forwards to the backend as `input.capture` on the liveness
+     * submission; absent when the phase was not observed.
+     */
+    cameraReadyMs?: number;
+    /**
+     * Camera ready → the first face ACCEPTED by the gate (present and with
+     * size, centering and quality good enough to make progress — not merely
+     * detected), whole ms. Absent when no face was ever accepted.
+     */
+    faceAcquireMs?: number;
+    /**
+     * Face-capture duration: FIRST accepted face → gate progress 100 % (capture
+     * complete, before the clip window and any upload), whole ms. A face lost
+     * and re-acquired keeps the first acceptance as its start.
+     */
+    captureMs?: number;
 }
+/** Capture engine identifier carried on {@link CapturedArtifacts.engine}. */
+type CaptureEngineId = "v1" | "v3";
 /** Camera / engine failure kinds — collapsed to the public six. */
 type CaptureErrorKind = "permission" | "notfound" | "inuse" | "insecure" | "unsupported" | "generic";
 /** Camera / engine failure payload (`on('error')`). */
@@ -87,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). */
@@ -106,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'`):
@@ -195,7 +241,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;
@@ -230,6 +279,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). */
@@ -345,4 +445,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, createLivenessCaptureInternal as B, type CaptureChannel as C, DEFAULT_API_ORIGIN as D, createVerificationInternal as E, mapEngineState as F, type GateHint as G, type HostedClientLike as H, mapErrorKind as I, mapGuidanceHint as J, randomUuid as K, type LivenessCaptureEvents as L, runLivenessFlow as M, runSubmission as N, PROCESSING_POLL_DELAY_MS as P, type ReasonCode as R, type SdkFailureReason as S, TRANSPORT_REPLAY_ATTEMPTS as T, type Verification as V, type CaptureError as a, type CaptureErrorKind as b, type CaptureState as c, type CapturedArtifacts as d, type GateUpdate as e, type LivenessCaptureHandle as f, type LivenessCaptureOptions as g, type VerificationEvents as h, type VerificationLocale as i, type VerificationOptions as j, type VerificationResult as k, type VerificationStatus as l, createLivenessCapture as m, createVerification as n, CLIP_MIME_ALLOWLIST as o, type CaptureEngine as p, type LivenessCaptureInternalHandle as q, type LivenessCaptureInternals as r, type LivenessFlowDeps as s, type LivenessFlowOutcome as t, PROCESSING_POLL_MAX as u, REGISTRY_RETRY_DELAY_MS as v, type SubmitExecutor as w, type SubmitRuntime as x, TRANSPORT_REPLAY_DELAY_MS as y, type VerificationInternals 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-CP18eq1Q.d.cts → create-verification-c98uAxbl.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-COIO_F2w.cjs';
-import { C as CheckReason, c as HostedSessionView, g as HostedClient, A as AttestationInput, h as SessionView, b as CheckType } from './hosted-client-BpvBqu9f.cjs';
+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, c as HostedSessionView, g as HostedClient, A as AttestationInput, h as SessionView, b as CheckType } from './hosted-client-DWzCRYJK.js';
 
 /** Gate guidance code. `'hold'` is emitted while the clip records. */
 type GateHint = "center" | "closer" | "farther" | "light" | "still" | "hold";
@@ -47,7 +48,30 @@ interface CapturedArtifacts {
     captureChannel: CaptureChannel;
     /** Set when the browser has no MediaRecorder: a keyframe-only capture. */
     degraded?: "NO_RECORDER";
+    /** The capture engine that produced the artifacts (`'v3'` for this SDK). Always set by the SDK; optional in the type so host-built fixtures stay valid. */
+    engine?: CaptureEngineId;
+    /**
+     * Camera request (`getUserMedia`) → the preview is live, in whole
+     * milliseconds measured with `performance.now()`. Part of the face-capture
+     * timing the SDK forwards to the backend as `input.capture` on the liveness
+     * submission; absent when the phase was not observed.
+     */
+    cameraReadyMs?: number;
+    /**
+     * Camera ready → the first face ACCEPTED by the gate (present and with
+     * size, centering and quality good enough to make progress — not merely
+     * detected), whole ms. Absent when no face was ever accepted.
+     */
+    faceAcquireMs?: number;
+    /**
+     * Face-capture duration: FIRST accepted face → gate progress 100 % (capture
+     * complete, before the clip window and any upload), whole ms. A face lost
+     * and re-acquired keeps the first acceptance as its start.
+     */
+    captureMs?: number;
 }
+/** Capture engine identifier carried on {@link CapturedArtifacts.engine}. */
+type CaptureEngineId = "v1" | "v3";
 /** Camera / engine failure kinds — collapsed to the public six. */
 type CaptureErrorKind = "permission" | "notfound" | "inuse" | "insecure" | "unsupported" | "generic";
 /** Camera / engine failure payload (`on('error')`). */
@@ -87,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). */
@@ -106,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'`):
@@ -195,7 +241,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;
@@ -230,6 +279,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). */
@@ -345,4 +445,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, createLivenessCaptureInternal as B, type CaptureChannel as C, DEFAULT_API_ORIGIN as D, createVerificationInternal as E, mapEngineState as F, type GateHint as G, type HostedClientLike as H, mapErrorKind as I, mapGuidanceHint as J, randomUuid as K, type LivenessCaptureEvents as L, runLivenessFlow as M, runSubmission as N, PROCESSING_POLL_DELAY_MS as P, type ReasonCode as R, type SdkFailureReason as S, TRANSPORT_REPLAY_ATTEMPTS as T, type Verification as V, type CaptureError as a, type CaptureErrorKind as b, type CaptureState as c, type CapturedArtifacts as d, type GateUpdate as e, type LivenessCaptureHandle as f, type LivenessCaptureOptions as g, type VerificationEvents as h, type VerificationLocale as i, type VerificationOptions as j, type VerificationResult as k, type VerificationStatus as l, createLivenessCapture as m, createVerification as n, CLIP_MIME_ALLOWLIST as o, type CaptureEngine as p, type LivenessCaptureInternalHandle as q, type LivenessCaptureInternals as r, type LivenessFlowDeps as s, type LivenessFlowOutcome as t, PROCESSING_POLL_MAX as u, REGISTRY_RETRY_DELAY_MS as v, type SubmitExecutor as w, type SubmitRuntime as x, TRANSPORT_REPLAY_DELAY_MS as y, type VerificationInternals 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-BpvBqu9f.d.cts → hosted-client-DWzCRYJK.d.cts}

@@ -190,6 +190,19 @@ interface LivenessInput {
      *  Client-declared by design (not a security boundary); absent = legacy
      *  clients, treated as mobile server-side during the rollout window. */
     captureChannel?: 'mobile' | 'desktop';
+    /** Capture metadata (engine, dimensions, clip length, face-capture timing)
+     *  — the backend's allowlisted, non-PII `capture` block (session insights). */
+    capture?: LivenessCaptureInput;
+}
+/** `LivenessInput.capture`: what the SDK's `captured` event measured. All ms are whole, ≥ 0. */
+interface LivenessCaptureInput {
+    engine?: 'v1' | 'v3';
+    width?: number;
+    height?: number;
+    clipMs?: number;
+    cameraReadyMs?: number;
+    faceAcquireMs?: number;
+    captureMs?: number;
 }
 /**
  * population_registry adapter input. `nni` is the 10-digit NNI for an UNBOUND
@@ -405,4 +418,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 LivenessInput as p, type MediaKind as q, type PhoneOtpInput as r, type PopulationInput as s, type PresignRequest as t, type PresignUploadResult as u, type SessionStepView as v, type SubmitCheckBody as w, type SubmitOptions as x, stripMimeParams as y };
+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 };

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

@@ -190,6 +190,19 @@ interface LivenessInput {
      *  Client-declared by design (not a security boundary); absent = legacy
      *  clients, treated as mobile server-side during the rollout window. */
     captureChannel?: 'mobile' | 'desktop';
+    /** Capture metadata (engine, dimensions, clip length, face-capture timing)
+     *  — the backend's allowlisted, non-PII `capture` block (session insights). */
+    capture?: LivenessCaptureInput;
+}
+/** `LivenessInput.capture`: what the SDK's `captured` event measured. All ms are whole, ≥ 0. */
+interface LivenessCaptureInput {
+    engine?: 'v1' | 'v3';
+    width?: number;
+    height?: number;
+    clipMs?: number;
+    cameraReadyMs?: number;
+    faceAcquireMs?: number;
+    captureMs?: number;
 }
 /**
  * population_registry adapter input. `nni` is the 10-digit NNI for an UNBOUND
@@ -405,4 +418,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 LivenessInput as p, type MediaKind as q, type PhoneOtpInput as r, type PopulationInput as s, type PresignRequest as t, type PresignUploadResult as u, type SessionStepView as v, type SubmitCheckBody as w, type SubmitOptions as x, stripMimeParams as y };
+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 };