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

package/dist/index.d.cts

@@ -1,6 +1,28 @@
-export { C as CaptureChannel, a as CaptureEngineId, b as CaptureError, c as CaptureErrorKind, d as CaptureState, e as CapturedArtifacts, D as DEFAULT_API_ORIGIN, G as GateHint, f as GateUpdate, L as LivenessCaptureEvents, g as LivenessCaptureHandle, h as LivenessCaptureOptions, R as ReasonCode, S as SdkFailureReason, V as Verification, i as VerificationEvents, j as VerificationLocale, k as VerificationOptions, l as VerificationResult, m as VerificationStatus, n as createLivenessCapture, o as createVerification } from './create-verification-Dkb2tXuY.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-DWzCRYJK.cjs';
-import './capture-session-v3-DEInCOUg.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 CaptureEngineId, b as CaptureError, c as CaptureErrorKind, d as CaptureState, e as CapturedArtifacts, D as DEFAULT_API_ORIGIN, G as GateHint, f as GateUpdate, L as LivenessCaptureEvents, g as LivenessCaptureHandle, h as LivenessCaptureOptions, R as ReasonCode, S as SdkFailureReason, V as Verification, i as VerificationEvents, j as VerificationLocale, k as VerificationOptions, l as VerificationResult, m as VerificationStatus, n as createLivenessCapture, o as createVerification } from './create-verification-Ce1y5kJR.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-DWzCRYJK.js';
-import './capture-session-v3-uXJr1Wlm.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-TBANUT3X.js";
-import "./chunk-EWRNPKTR.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
@@ -2707,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();
@@ -3118,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) {
@@ -3181,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";
@@ -3204,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 });
@@ -3279,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();
     }
@@ -3991,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(
@@ -4026,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();
@@ -4142,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: () => {
@@ -4189,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,
@@ -4213,14 +4411,17 @@ function createVerificationInternal(options, internals) {
   mapGuidanceHint,
   mapSessionResult,
   mergeSessionView,
+  preloadedDetectorFactory,
   quadAreaFrac,
   quadBounds,
   quadIou,
   quadTiltRatio,
   randomUuid,
+  resetLivenessAssetsForTests,
   resetTurnstileForTests,
   runLivenessFlow,
   runSubmission,
+  setPreloadLoaderForTests,
   specularFraction,
   stepOf,
   warmDocDetector