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

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-CA-3szPI.d.cts}

@@ -1,4 +1,5 @@
-import { h as CaptureState$1, f as CaptureSessionV3Events, g as CaptureSessionV3Options, c as CaptureErrorKind$1 } from './capture-session-v3-DEInCOUg.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, 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. */
@@ -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'`):
@@ -218,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;
@@ -253,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). */
@@ -368,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, 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-c98uAxbl.d.ts}

@@ -1,4 +1,5 @@
-import { h as CaptureState$1, f as CaptureSessionV3Events, g as CaptureSessionV3Options, c as CaptureErrorKind$1 } from './capture-session-v3-uXJr1Wlm.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, 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. */
@@ -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'`):
@@ -218,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;
@@ -253,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). */
@@ -368,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, 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 };