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

package/dist/index.d.cts

@@ -1,6 +1,28 @@
-export { C as CaptureChannel, a as CaptureError, b as CaptureErrorKind, c as CaptureState, d as CapturedArtifacts, D as DEFAULT_API_ORIGIN, G as GateHint, e as GateUpdate, L as LivenessCaptureEvents, f as LivenessCaptureHandle, g as LivenessCaptureOptions, R as ReasonCode, S as SdkFailureReason, V as Verification, h as VerificationEvents, i as VerificationLocale, j as VerificationOptions, k as VerificationResult, l as VerificationStatus, m as createLivenessCapture, n as createVerification } from './create-verification-CP18eq1Q.cjs';
+export { C as CameraFacing, a as CaptureChannel, b as CaptureEngineId, c as CaptureError, d as CaptureErrorKind, e as CaptureState, f as CapturedArtifacts, D as DEFAULT_API_ORIGIN, G as GateHint, g as GateUpdate, L as LivenessAssetsStatus, h as LivenessCaptureEvents, i as LivenessCaptureHandle, j as LivenessCaptureOptions, k as LivenessStartOptions, P as PreloadLivenessAssetsOptions, R as ReasonCode, S as SdkFailureReason, V as Verification, l as VerificationEvents, m as VerificationLocale, n as VerificationOptions, o as VerificationResult, p as VerificationStatus, q as createLivenessCapture, r as createVerification, s as getLivenessAssetsStatus, t as preloadLivenessAssets, u as releaseLivenessAssets, v as subscribeLivenessAssets } from './create-verification-CA-3szPI.cjs';
 export { OpenHostedOptions, PopupBlocked, PopupHandle, SEKYRO_EVENTS, SekyroEvent, SekyroEventName, openHosted } from './popup/index.cjs';
 export { HostedApiError, KNOWN_CODES, KnownCode, isKnownCode } from './client/index.cjs';
-export { C as CheckReason, a as CheckState, b as CheckType, D as DocReason, F as FaceMatchReason, H as HostedOtpView, c as HostedSessionView, d as HostedStepView, L as LivenessReason, P as PhoneOtpReason, e as PopulationReason, S as SessionOutcome, f as SessionStatus } from './hosted-client-BpvBqu9f.cjs';
-import './capture-session-v3-COIO_F2w.cjs';
+export { C as CheckReason, a as CheckState, b as CheckType, D as DocReason, F as FaceMatchReason, H as HostedOtpView, c as HostedSessionView, d as HostedStepView, L as LivenessReason, P as PhoneOtpReason, e as PopulationReason, S as SessionOutcome, f as SessionStatus } from './hosted-client-DWzCRYJK.cjs';
 import './detect-worker-CKXHlXx9.cjs';
+import './capture-session-v3-UQU_WjO2.cjs';
+
+/** Camera permission as the Permissions API reports it; `'unknown'` where it cannot tell. */
+type CameraPermissionState = "granted" | "prompt" | "denied" | "unknown";
+/** One-shot camera permission read. */
+declare function queryCameraPermission(): Promise<CameraPermissionState>;
+/**
+ * Subscribe to camera-permission changes; returns the unsubscribe function.
+ * Unlike {@link subscribeLivenessAssets}, it DOES emit the current state first
+ * (as soon as the Permissions API answers — asynchronously, `'unknown'` where
+ * unsupported), then on every change. Not a `useSyncExternalStore` source:
+ * there is no synchronous snapshot — drive a `useState` from it.
+ */
+declare function subscribeCameraPermission(listener: (state: CameraPermissionState) => void): () => void;
+/**
+ * Whether a front/back choice makes sense: phones and tablets (UA, incl. iPadOS's
+ * desktop UA) always have both; otherwise ≥ 2 `videoinput` devices. Before a
+ * permission was ever granted some desktops report a single placeholder — the
+ * in-capture switch remains available either way.
+ */
+declare function hasMultipleCameras(): Promise<boolean>;
+
+export { type CameraPermissionState, hasMultipleCameras, queryCameraPermission, subscribeCameraPermission };

package/dist/index.d.ts

@@ -1,6 +1,28 @@
-export { C as CaptureChannel, a as CaptureError, b as CaptureErrorKind, c as CaptureState, d as CapturedArtifacts, D as DEFAULT_API_ORIGIN, G as GateHint, e as GateUpdate, L as LivenessCaptureEvents, f as LivenessCaptureHandle, g as LivenessCaptureOptions, R as ReasonCode, S as SdkFailureReason, V as Verification, h as VerificationEvents, i as VerificationLocale, j as VerificationOptions, k as VerificationResult, l as VerificationStatus, m as createLivenessCapture, n as createVerification } from './create-verification-CswF2As-.js';
+export { C as CameraFacing, a as CaptureChannel, b as CaptureEngineId, c as CaptureError, d as CaptureErrorKind, e as CaptureState, f as CapturedArtifacts, D as DEFAULT_API_ORIGIN, G as GateHint, g as GateUpdate, L as LivenessAssetsStatus, h as LivenessCaptureEvents, i as LivenessCaptureHandle, j as LivenessCaptureOptions, k as LivenessStartOptions, P as PreloadLivenessAssetsOptions, R as ReasonCode, S as SdkFailureReason, V as Verification, l as VerificationEvents, m as VerificationLocale, n as VerificationOptions, o as VerificationResult, p as VerificationStatus, q as createLivenessCapture, r as createVerification, s as getLivenessAssetsStatus, t as preloadLivenessAssets, u as releaseLivenessAssets, v as subscribeLivenessAssets } from './create-verification-c98uAxbl.js';
 export { OpenHostedOptions, PopupBlocked, PopupHandle, SEKYRO_EVENTS, SekyroEvent, SekyroEventName, openHosted } from './popup/index.js';
 export { HostedApiError, KNOWN_CODES, KnownCode, isKnownCode } from './client/index.js';
-export { C as CheckReason, a as CheckState, b as CheckType, D as DocReason, F as FaceMatchReason, H as HostedOtpView, c as HostedSessionView, d as HostedStepView, L as LivenessReason, P as PhoneOtpReason, e as PopulationReason, S as SessionOutcome, f as SessionStatus } from './hosted-client-BpvBqu9f.js';
-import './capture-session-v3-CvIfcwST.js';
+export { C as CheckReason, a as CheckState, b as CheckType, D as DocReason, F as FaceMatchReason, H as HostedOtpView, c as HostedSessionView, d as HostedStepView, L as LivenessReason, P as PhoneOtpReason, e as PopulationReason, S as SessionOutcome, f as SessionStatus } from './hosted-client-DWzCRYJK.js';
 import './detect-worker-CKXHlXx9.js';
+import './capture-session-v3-Okq0EQHG.js';
+
+/** Camera permission as the Permissions API reports it; `'unknown'` where it cannot tell. */
+type CameraPermissionState = "granted" | "prompt" | "denied" | "unknown";
+/** One-shot camera permission read. */
+declare function queryCameraPermission(): Promise<CameraPermissionState>;
+/**
+ * Subscribe to camera-permission changes; returns the unsubscribe function.
+ * Unlike {@link subscribeLivenessAssets}, it DOES emit the current state first
+ * (as soon as the Permissions API answers — asynchronously, `'unknown'` where
+ * unsupported), then on every change. Not a `useSyncExternalStore` source:
+ * there is no synchronous snapshot — drive a `useState` from it.
+ */
+declare function subscribeCameraPermission(listener: (state: CameraPermissionState) => void): () => void;
+/**
+ * Whether a front/back choice makes sense: phones and tablets (UA, incl. iPadOS's
+ * desktop UA) always have both; otherwise ≥ 2 `videoinput` devices. Before a
+ * permission was ever granted some desktops report a single placeholder — the
+ * in-capture switch remains available either way.
+ */
+declare function hasMultipleCameras(): Promise<boolean>;
+
+export { type CameraPermissionState, hasMultipleCameras, queryCameraPermission, subscribeCameraPermission };

package/dist/index.js

@@ -5,9 +5,13 @@ import {
 import {
   DEFAULT_API_ORIGIN,
   createLivenessCapture,
-  createVerification
-} from "./chunk-FIXX2AXC.js";
-import "./chunk-7TC6TOZ4.js";
+  createVerification,
+  getLivenessAssetsStatus,
+  preloadLivenessAssets,
+  releaseLivenessAssets,
+  subscribeLivenessAssets
+} from "./chunk-SGDXLAXR.js";
+import "./chunk-TG5IE552.js";
 import {
   HostedApiError,
   KNOWN_CODES,
@@ -15,6 +19,52 @@ import {
 } from "./chunk-YVFF4Q4G.js";
 import "./chunk-NWF46H7K.js";
 import "./chunk-MWNFSNMP.js";
+
+// src/capture/camera-probe.ts
+async function permissionStatus() {
+  try {
+    if (typeof navigator === "undefined" || typeof navigator.permissions?.query !== "function") return null;
+    return await navigator.permissions.query({ name: "camera" });
+  } catch {
+    return null;
+  }
+}
+function asState(state) {
+  return state === "granted" || state === "prompt" || state === "denied" ? state : "unknown";
+}
+async function queryCameraPermission() {
+  const status = await permissionStatus();
+  return status === null ? "unknown" : asState(status.state);
+}
+function subscribeCameraPermission(listener) {
+  let stopped = false;
+  let status = null;
+  const onChange = () => {
+    if (!stopped && status !== null) listener(asState(status.state));
+  };
+  void permissionStatus().then((resolved) => {
+    if (stopped) return;
+    status = resolved;
+    listener(resolved === null ? "unknown" : asState(resolved.state));
+    resolved?.addEventListener?.("change", onChange);
+  });
+  return () => {
+    stopped = true;
+    status?.removeEventListener?.("change", onChange);
+  };
+}
+async function hasMultipleCameras() {
+  if (typeof navigator === "undefined") return false;
+  const ua = String(navigator.userAgent ?? "");
+  if (/Android|iPhone|iPad|iPod/i.test(ua)) return true;
+  if (/Macintosh/.test(ua) && (navigator.maxTouchPoints ?? 0) > 1) return true;
+  try {
+    const devices = await navigator.mediaDevices?.enumerateDevices?.() ?? [];
+    return devices.filter((device) => device.kind === "videoinput").length >= 2;
+  } catch {
+    return false;
+  }
+}
 export {
   DEFAULT_API_ORIGIN,
   HostedApiError,
@@ -22,7 +72,14 @@ export {
   SEKYRO_EVENTS,
   createLivenessCapture,
   createVerification,
+  getLivenessAssetsStatus,
+  hasMultipleCameras,
   isKnownCode,
-  openHosted
+  openHosted,
+  preloadLivenessAssets,
+  queryCameraPermission,
+  releaseLivenessAssets,
+  subscribeCameraPermission,
+  subscribeLivenessAssets
 };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}
+{"version":3,"sources":["../src/capture/camera-probe.ts"],"sourcesContent":["// Camera probes for pre-capture UI (spec D6, D7). Every function is SSR-safe and\n// never throws: a missing / throwing API (Safari < 16 on {name:'camera'},\n// Firefox) degrades to 'unknown' / false.\n\n/** Camera permission as the Permissions API reports it; `'unknown'` where it cannot tell. */\nexport type CameraPermissionState = \"granted\" | \"prompt\" | \"denied\" | \"unknown\";\n\nasync function permissionStatus(): Promise<PermissionStatus | null> {\n  try {\n    if (typeof navigator === \"undefined\" || typeof navigator.permissions?.query !== \"function\") return null;\n    return await navigator.permissions.query({ name: \"camera\" as PermissionName });\n  } catch {\n    return null;\n  }\n}\n\nfunction asState(state: string): CameraPermissionState {\n  return state === \"granted\" || state === \"prompt\" || state === \"denied\" ? state : \"unknown\";\n}\n\n/** One-shot camera permission read. */\nexport async function queryCameraPermission(): Promise<CameraPermissionState> {\n  const status = await permissionStatus();\n  return status === null ? \"unknown\" : asState(status.state);\n}\n\n/**\n * Subscribe to camera-permission changes; returns the unsubscribe function.\n * Unlike {@link subscribeLivenessAssets}, it DOES emit the current state first\n * (as soon as the Permissions API answers — asynchronously, `'unknown'` where\n * unsupported), then on every change. Not a `useSyncExternalStore` source:\n * there is no synchronous snapshot — drive a `useState` from it.\n */\nexport function subscribeCameraPermission(listener: (state: CameraPermissionState) => void): () => void {\n  let stopped = false;\n  let status: PermissionStatus | null = null;\n  const onChange = (): void => {\n    if (!stopped && status !== null) listener(asState(status.state));\n  };\n  void permissionStatus().then((resolved) => {\n    if (stopped) return;\n    status = resolved;\n    listener(resolved === null ? \"unknown\" : asState(resolved.state));\n    resolved?.addEventListener?.(\"change\", onChange);\n  });\n  return () => {\n    stopped = true;\n    status?.removeEventListener?.(\"change\", onChange);\n  };\n}\n\n/**\n * Whether a front/back choice makes sense: phones and tablets (UA, incl. iPadOS's\n * desktop UA) always have both; otherwise ≥ 2 `videoinput` devices. Before a\n * permission was ever granted some desktops report a single placeholder — the\n * in-capture switch remains available either way.\n */\nexport async function hasMultipleCameras(): Promise<boolean> {\n  if (typeof navigator === \"undefined\") return false;\n  const ua = String(navigator.userAgent ?? \"\");\n  if (/Android|iPhone|iPad|iPod/i.test(ua)) return true;\n  if (/Macintosh/.test(ua) && (navigator.maxTouchPoints ?? 0) > 1) return true;\n  try {\n    const devices = (await navigator.mediaDevices?.enumerateDevices?.()) ?? [];\n    return devices.filter((device) => device.kind === \"videoinput\").length >= 2;\n  } catch {\n    return false;\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAOA,eAAe,mBAAqD;AAClE,MAAI;AACF,QAAI,OAAO,cAAc,eAAe,OAAO,UAAU,aAAa,UAAU,WAAY,QAAO;AACnG,WAAO,MAAM,UAAU,YAAY,MAAM,EAAE,MAAM,SAA2B,CAAC;AAAA,EAC/E,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAEA,SAAS,QAAQ,OAAsC;AACrD,SAAO,UAAU,aAAa,UAAU,YAAY,UAAU,WAAW,QAAQ;AACnF;AAGA,eAAsB,wBAAwD;AAC5E,QAAM,SAAS,MAAM,iBAAiB;AACtC,SAAO,WAAW,OAAO,YAAY,QAAQ,OAAO,KAAK;AAC3D;AASO,SAAS,0BAA0B,UAA8D;AACtG,MAAI,UAAU;AACd,MAAI,SAAkC;AACtC,QAAM,WAAW,MAAY;AAC3B,QAAI,CAAC,WAAW,WAAW,KAAM,UAAS,QAAQ,OAAO,KAAK,CAAC;AAAA,EACjE;AACA,OAAK,iBAAiB,EAAE,KAAK,CAAC,aAAa;AACzC,QAAI,QAAS;AACb,aAAS;AACT,aAAS,aAAa,OAAO,YAAY,QAAQ,SAAS,KAAK,CAAC;AAChE,cAAU,mBAAmB,UAAU,QAAQ;AAAA,EACjD,CAAC;AACD,SAAO,MAAM;AACX,cAAU;AACV,YAAQ,sBAAsB,UAAU,QAAQ;AAAA,EAClD;AACF;AAQA,eAAsB,qBAAuC;AAC3D,MAAI,OAAO,cAAc,YAAa,QAAO;AAC7C,QAAM,KAAK,OAAO,UAAU,aAAa,EAAE;AAC3C,MAAI,4BAA4B,KAAK,EAAE,EAAG,QAAO;AACjD,MAAI,YAAY,KAAK,EAAE,MAAM,UAAU,kBAAkB,KAAK,EAAG,QAAO;AACxE,MAAI;AACF,UAAM,UAAW,MAAM,UAAU,cAAc,mBAAmB,KAAM,CAAC;AACzE,WAAO,QAAQ,OAAO,CAAC,WAAW,OAAO,SAAS,YAAY,EAAE,UAAU;AAAA,EAC5E,QAAQ;AACN,WAAO;AAAA,EACT;AACF;","names":[]}

package/dist/internal/index.cjs

@@ -1105,6 +1105,8 @@ __export(internal_exports, {
   IN_CIRCLE_FACTOR: () => IN_CIRCLE_FACTOR,
   MRZ_BAND_DEFAULTS: () => MRZ_BAND_DEFAULTS,
   MR_DOC_CATALOG: () => MR_DOC_CATALOG,
+  PRELOAD_BLAZE_INIT_TIMEOUT_MS: () => PRELOAD_BLAZE_INIT_TIMEOUT_MS,
+  PRELOAD_BUDGET_MS: () => PRELOAD_BUDGET_MS,
   PROCESSING_POLL_DELAY_MS: () => PROCESSING_POLL_DELAY_MS,
   PROCESSING_POLL_MAX: () => PROCESSING_POLL_MAX,
   REGISTRY_RETRY_DELAY_MS: () => REGISTRY_RETRY_DELAY_MS,
@@ -1129,14 +1131,17 @@ __export(internal_exports, {
   mapGuidanceHint: () => mapGuidanceHint,
   mapSessionResult: () => mapSessionResult,
   mergeSessionView: () => mergeSessionView,
+  preloadedDetectorFactory: () => preloadedDetectorFactory,
   quadAreaFrac: () => quadAreaFrac,
   quadBounds: () => quadBounds,
   quadIou: () => quadIou,
   quadTiltRatio: () => quadTiltRatio,
   randomUuid: () => randomUuid,
+  resetLivenessAssetsForTests: () => resetLivenessAssetsForTests,
   resetTurnstileForTests: () => resetTurnstileForTests,
   runLivenessFlow: () => runLivenessFlow,
   runSubmission: () => runSubmission,
+  setPreloadLoaderForTests: () => setPreloadLoaderForTests,
   specularFraction: () => specularFraction,
   stepOf: () => stepOf,
   warmDocDetector: () => warmDocDetector
@@ -2556,7 +2561,8 @@ var FaceGateV3 = class {
       p: this.p,
       factors,
       guidanceKey: this.guidanceOf(factors, quality, q),
-      ready
+      ready,
+      accepted: q >= this.t.Q_GOOD
     };
   }
   geometryOf(observation, input) {
@@ -2675,6 +2681,11 @@ var CaptureSessionV3 = class {
     this.profiler = null;
     this.lastGuidanceKey = null;
     this.positioningStartedAt = 0;
+    // Face-capture timing marks of the CURRENT attempt (engine clock; reset per run).
+    this.cameraRequestedAt = null;
+    this.cameraReadyAt = null;
+    this.faceAcquiredAt = null;
+    this.captureCompleteAt = null;
     this.fired = false;
     this.carriedDegrade = 0;
     this.carriedMeans = [];
@@ -2701,10 +2712,15 @@ var CaptureSessionV3 = class {
       handler(payload);
     }
   }
-  async start() {
+  async start(options = {}) {
+    if (options.facingMode !== void 0) this.facing = options.facingMode;
     this.attempt += 1;
     await this.run(this.attempt);
   }
+  /** The camera the current/next attempt requests (start option, switchCamera toggles). */
+  get facingMode() {
+    return this.facing;
+  }
   /** Full reset + camera restart — the documented recovery path (v1 parity). */
   retry() {
     this.teardownAttempt();
@@ -2729,6 +2745,10 @@ var CaptureSessionV3 = class {
     this.lastGuidanceKey = null;
     this.carriedDegrade = 0;
     this.carriedMeans = [];
+    this.cameraRequestedAt = null;
+    this.cameraReadyAt = null;
+    this.faceAcquiredAt = null;
+    this.captureCompleteAt = null;
     this.setState("preflight");
     const preflight = cameraPreflight();
     if (preflight !== "OK") {
@@ -2738,6 +2758,7 @@ var CaptureSessionV3 = class {
     this.setState("acquiring");
     const getUserMedia = options.getUserMedia ?? ((constraints) => navigator.mediaDevices.getUserMedia(constraints));
     let stream;
+    this.cameraRequestedAt = this.now();
     try {
       stream = await getUserMedia(buildCaptureConstraints(detectIsMobile(), this.facing));
     } catch (err) {
@@ -2753,6 +2774,7 @@ var CaptureSessionV3 = class {
     options.video.srcObject = stream;
     await options.video.play().catch(() => void 0);
     if (attempt !== this.attempt) return;
+    this.cameraReadyAt = this.now();
     if (this.detector === null) {
       const ladderOptions = {
         ...options.v3AssetBaseUrl !== void 0 ? { v3AssetBaseUrl: options.v3AssetBaseUrl } : {}
@@ -2852,6 +2874,7 @@ var CaptureSessionV3 = class {
       frameWidth: video.videoWidth,
       frameHeight: video.videoHeight
     });
+    if (tick.accepted && this.faceAcquiredAt === null) this.faceAcquiredAt = tick.at;
     this.emit("checks", {
       engine: "v3",
       progress: tick.p,
@@ -2865,6 +2888,7 @@ var CaptureSessionV3 = class {
     }
     if (tick.ready && this.stateValue === "positioning") {
       this.fired = true;
+      this.captureCompleteAt = tick.at;
       void this.fire(attempt);
     }
   }
@@ -2959,7 +2983,21 @@ var CaptureSessionV3 = class {
   finishCapture(artifacts) {
     this.stopTracks();
     this.setState("captured");
-    this.emit("artifacts", artifacts);
+    const timing = this.captureTiming();
+    this.emit("artifacts", timing === void 0 ? artifacts : { ...artifacts, timing });
+  }
+  /** The attempt's capture-phase timing (whole ms, ≥ 0); undefined when no mark landed. */
+  captureTiming() {
+    const span = (from, to) => from !== null && to !== null ? Math.max(0, Math.round(to - from)) : void 0;
+    const cameraReadyMs = span(this.cameraRequestedAt, this.cameraReadyAt);
+    const faceAcquireMs = span(this.cameraReadyAt, this.faceAcquiredAt);
+    const captureMs = span(this.faceAcquiredAt, this.captureCompleteAt);
+    const timing = {
+      ...cameraReadyMs !== void 0 ? { cameraReadyMs } : {},
+      ...faceAcquireMs !== void 0 ? { faceAcquireMs } : {},
+      ...captureMs !== void 0 ? { captureMs } : {}
+    };
+    return Object.keys(timing).length > 0 ? timing : void 0;
   }
   // ── defaults for the canvas-bound seams ────────────────────────────────────
   async defaultKeyframe(video) {
@@ -3090,6 +3128,179 @@ function createEmitter() {
   };
 }
 
+// src/capture/preload.ts
+var PRELOAD_BLAZE_INIT_TIMEOUT_MS = 12e4;
+var PRELOAD_BUDGET_MS = 13e4;
+var REGISTRY_KEY = /* @__PURE__ */ Symbol.for("@sekyro/web.preload.v1");
+function registry() {
+  const host = globalThis;
+  host[REGISTRY_KEY] ?? (host[REGISTRY_KEY] = /* @__PURE__ */ new Map());
+  return host[REGISTRY_KEY];
+}
+function normalizeBase(assetBaseUrl) {
+  const base = (assetBaseUrl ?? DEFAULT_V3_ASSET_BASE_URL).replace(/\/+$/, "");
+  return base === "" ? "/" : base;
+}
+function setStatus(entry, next) {
+  if (entry.status === next) return;
+  entry.status = next;
+  for (const listener of [...entry.listeners]) listener(next);
+}
+var defaultLoader = (base) => createDetector({ preferred: ["blaze"], v3AssetBaseUrl: base, blazeInitTimeoutMs: PRELOAD_BLAZE_INIT_TIMEOUT_MS });
+var loader = defaultLoader;
+function setPreloadLoaderForTests(next) {
+  loader = next ?? defaultLoader;
+}
+function resetLivenessAssetsForTests() {
+  for (const entry of registry().values()) entry.detector?.destroy();
+  registry().clear();
+  loader = defaultLoader;
+}
+function begin(entry, base) {
+  if ((entry.status === "loading" || entry.status === "ready") && entry.promise !== null) return entry.promise;
+  setStatus(entry, "loading");
+  const detectorPromise = new Promise((resolve) => resolve(loader(base)));
+  entry.detectorPromise = detectorPromise;
+  let timer;
+  const budget = new Promise((_2, reject) => {
+    timer = setTimeout(() => {
+      detectorPromise.then((late) => late.destroy(), () => void 0);
+      reject(new Error(`detector preload exceeded ${PRELOAD_BUDGET_MS} ms`));
+    }, PRELOAD_BUDGET_MS);
+  });
+  const settled = Promise.race([detectorPromise, budget]).then(
+    (detector) => {
+      if (entry.detectorPromise !== detectorPromise) {
+        detector.destroy();
+        return entry.status;
+      }
+      entry.detector = detector;
+      setStatus(entry, "ready");
+      return "ready";
+    },
+    (err) => {
+      if (entry.detectorPromise === detectorPromise) {
+        entry.detectorPromise = null;
+        entry.detector = null;
+        setStatus(entry, "failed");
+        console.warn("[@sekyro/web] face-detector preload failed:", err);
+      }
+      return entry.status;
+    }
+  );
+  const promise = settled.finally(() => clearTimeout(timer));
+  entry.promise = promise;
+  entry.scheduled?.settle(promise);
+  return promise;
+}
+function nonOwningView(shared) {
+  return {
+    get tier() {
+      return shared.tier;
+    },
+    get fallbackReason() {
+      return shared.fallbackReason;
+    },
+    detect: (...args) => shared.detect(...args),
+    destroy: () => {
+    }
+  };
+}
+function preloadedDetectorFactory(assetBaseUrl) {
+  const base = normalizeBase(assetBaseUrl);
+  const entry = registry().get(base);
+  if (entry === void 0 || entry.detector === null && entry.detectorPromise === null && entry.scheduled === null) {
+    return void 0;
+  }
+  return async () => {
+    if (entry.scheduled !== null) void begin(entry, base);
+    let waitingOn = entry.promise;
+    while (entry.detector === null && waitingOn !== null) {
+      await waitingOn;
+      if (entry.promise === waitingOn) break;
+      waitingOn = entry.promise;
+    }
+    return entry.detector !== null ? nonOwningView(entry.detector) : createDetector({ v3AssetBaseUrl: base });
+  };
+}
+
+// src/capture/wake-lock.ts
+function wakeLockApi() {
+  if (typeof navigator === "undefined" || !("wakeLock" in navigator)) return null;
+  const api = navigator.wakeLock;
+  return typeof api?.request === "function" ? api : null;
+}
+function isVisible() {
+  return typeof document === "undefined" || document.visibilityState === "visible";
+}
+function releaseQuietly(sentinel) {
+  try {
+    void sentinel.release().catch(() => void 0);
+  } catch {
+  }
+}
+function createScreenWakeLock(options = {}) {
+  if (options.enabled === false) return { setActive: () => void 0 };
+  let wanted = false;
+  let sentinel = null;
+  let inFlight = false;
+  let listening = false;
+  const acquire = () => {
+    if (!wanted || inFlight || sentinel !== null && !sentinel.released) return;
+    const api = wakeLockApi();
+    if (api === null || !isVisible()) return;
+    let request;
+    try {
+      request = api.request("screen");
+    } catch {
+      return;
+    }
+    inFlight = true;
+    request.then(
+      (granted) => {
+        inFlight = false;
+        if (!wanted) {
+          releaseQuietly(granted);
+          return;
+        }
+        sentinel = granted;
+        granted.addEventListener?.("release", () => {
+          if (sentinel === granted) sentinel = null;
+        });
+      },
+      () => {
+        inFlight = false;
+      }
+    );
+  };
+  const onVisibilityChange = () => {
+    if (isVisible()) acquire();
+  };
+  const listen = (on) => {
+    if (typeof document === "undefined" || on === listening) return;
+    listening = on;
+    if (on) document.addEventListener("visibilitychange", onVisibilityChange);
+    else document.removeEventListener("visibilitychange", onVisibilityChange);
+  };
+  return {
+    setActive: (active) => {
+      wanted = active;
+      if (active) {
+        if (wakeLockApi() === null) return;
+        listen(true);
+        acquire();
+        return;
+      }
+      listen(false);
+      if (sentinel !== null) {
+        const held = sentinel;
+        sentinel = null;
+        releaseQuietly(held);
+      }
+    }
+  };
+}
+
 // src/capture/create-liveness-capture.ts
 function mapGuidanceHint(key) {
   switch (key) {
@@ -3153,12 +3364,22 @@ function createLivenessCaptureInternal(options, internals = {}) {
   const now = internals.now ?? (() => performance.now());
   const emitter = createEmitter();
   const degraded = !isMediaRecorderSupported();
+  const hostSeams = internals.engineOptions;
+  const preloadAware = hostSeams?.createDetector === void 0 && hostSeams?.createWorker === void 0 ? {
+    createDetector: () => {
+      const warmed = preloadedDetectorFactory(options.assetBaseUrl);
+      return warmed !== void 0 ? warmed() : createDetector(
+        options.assetBaseUrl !== void 0 ? { v3AssetBaseUrl: options.assetBaseUrl } : {}
+      );
+    }
+  } : {};
   const engineOptions = {
     video: options.video,
     mode: degraded ? "photo" : "clip",
     ...options.facing !== void 0 ? { facingMode: options.facing } : {},
     ...options.assetBaseUrl !== void 0 ? { v3AssetBaseUrl: options.assetBaseUrl } : {},
-    ...internals.engineOptions ?? {}
+    ...internals.engineOptions ?? {},
+    ...preloadAware
   };
   const engine = internals.createEngine?.(engineOptions) ?? new CaptureSessionV3(engineOptions);
   let state = "idle";
@@ -3176,8 +3397,10 @@ function createLivenessCaptureInternal(options, internals = {}) {
       frameHeight = options.video.videoHeight;
     }
   };
+  const wakeLock = createScreenWakeLock({ enabled: options.keepScreenAwake !== false });
   const setState = (next) => {
     state = next;
+    wakeLock.setActive(next === "starting" || next === "gating" || next === "recording");
     emitter.emit("state", next);
   };
   const emitGate = () => emitter.emit("gate", { progress, hint, faceDetected });
@@ -3234,7 +3457,12 @@ function createLivenessCaptureInternal(options, internals = {}) {
         height: options.video.videoHeight || frameHeight,
         ...clipMs !== void 0 ? { clipMs } : {},
         captureChannel: detectIsMobile() ? "mobile" : "desktop",
-        ...degraded ? { degraded: "NO_RECORDER" } : {}
+        ...degraded ? { degraded: "NO_RECORDER" } : {},
+        engine: "v3",
+        // Face-capture timing: the engine's marks, forwarded flat (absent → absent).
+        ...artifacts.timing?.cameraReadyMs !== void 0 ? { cameraReadyMs: artifacts.timing.cameraReadyMs } : {},
+        ...artifacts.timing?.faceAcquireMs !== void 0 ? { faceAcquireMs: artifacts.timing.faceAcquireMs } : {},
+        ...artifacts.timing?.captureMs !== void 0 ? { captureMs: artifacts.timing.captureMs } : {}
       });
     }),
     engine.on("error", ({ kind, retryable }) => {
@@ -3246,11 +3474,12 @@ function createLivenessCaptureInternal(options, internals = {}) {
       return state;
     },
     on: (event, handler) => emitter.on(event, handler),
-    start: () => engine.start(),
+    start: (startOptions) => engine.start(startOptions?.facing !== void 0 ? { facingMode: startOptions.facing } : {}),
     retry: () => engine.retry(),
     switchCamera: () => engine.switchCamera(),
     destroy: () => {
       for (const unsubscribe of unsubscribes) unsubscribe();
+      wakeLock.setActive(false);
       engine.destroy();
       emitter.clear();
     }
@@ -3733,7 +3962,12 @@ function buildLivenessSubmit(deps, clip, bareMime) {
       deps.onPhase("checking");
       return client.submitCheck(
         "liveness",
-        { clipKey, attestation, captureChannel: deps.artifacts.captureChannel },
+        {
+          clipKey,
+          attestation,
+          captureChannel: deps.artifacts.captureChannel,
+          capture: captureInputOf(deps.artifacts)
+        },
         { idempotencyKey }
       );
     },
@@ -3744,6 +3978,17 @@ function buildLivenessSubmit(deps, clip, bareMime) {
     }
   );
 }
+function captureInputOf(artifacts) {
+  return {
+    ...artifacts.engine !== void 0 ? { engine: artifacts.engine } : {},
+    width: artifacts.width,
+    height: artifacts.height,
+    ...artifacts.clipMs !== void 0 ? { clipMs: artifacts.clipMs } : {},
+    ...artifacts.cameraReadyMs !== void 0 ? { cameraReadyMs: artifacts.cameraReadyMs } : {},
+    ...artifacts.faceAcquireMs !== void 0 ? { faceAcquireMs: artifacts.faceAcquireMs } : {},
+    ...artifacts.captureMs !== void 0 ? { captureMs: artifacts.captureMs } : {}
+  };
+}
 function buildFaceMatchSubmit(deps, keyframe) {
   let imageKey = null;
   return () => runSubmission(deps, async (client, idempotencyKey) => {
@@ -3942,7 +4187,7 @@ function createVerificationInternal(options, internals) {
     }
     emitter.emit("result", result);
   };
-  let registry = null;
+  let registry2 = null;
   let registryFailed = false;
   let registryUnbound = false;
   const submitRegistry = () => runSubmission(
@@ -3977,8 +4222,8 @@ function createVerificationInternal(options, internals) {
     if (view !== null && isTerminalView(view)) emitResult(mapSessionResult(view, { autoRetry }));
   };
   const startRegistry = () => {
-    registry ?? (registry = runRegistry());
-    return registry;
+    registry2 ?? (registry2 = runRegistry());
+    return registry2;
   };
   const getAttestation = async () => {
     const current = await ensureView();
@@ -4093,7 +4338,7 @@ function createVerificationInternal(options, internals) {
         return inner.state;
       },
       on: (event, handler) => inner.on(event, handler),
-      start: () => inner.start(),
+      start: (startOptions) => inner.start(startOptions),
       retry: () => inner.retry(),
       switchCamera: () => inner.switchCamera(),
       destroy: () => {
@@ -4140,6 +4385,8 @@ function createVerificationInternal(options, internals) {
   IN_CIRCLE_FACTOR,
   MRZ_BAND_DEFAULTS,
   MR_DOC_CATALOG,
+  PRELOAD_BLAZE_INIT_TIMEOUT_MS,
+  PRELOAD_BUDGET_MS,
   PROCESSING_POLL_DELAY_MS,
   PROCESSING_POLL_MAX,
   REGISTRY_RETRY_DELAY_MS,
@@ -4164,14 +4411,17 @@ function createVerificationInternal(options, internals) {
   mapGuidanceHint,
   mapSessionResult,
   mergeSessionView,
+  preloadedDetectorFactory,
   quadAreaFrac,
   quadBounds,
   quadIou,
   quadTiltRatio,
   randomUuid,
+  resetLivenessAssetsForTests,
   resetTurnstileForTests,
   runLivenessFlow,
   runSubmission,
+  setPreloadLoaderForTests,
   specularFraction,
   stepOf,
   warmDocDetector