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

package/dist/core/index.cjs

@@ -777,7 +777,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) {
@@ -1170,6 +1171,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 = [];
@@ -1196,10 +1202,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();
@@ -1224,6 +1235,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") {
@@ -1233,6 +1248,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) {
@@ -1248,6 +1264,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 } : {}
@@ -1347,6 +1364,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,
@@ -1360,6 +1378,7 @@ var CaptureSessionV3 = class {
     }
     if (tick.ready && this.stateValue === "positioning") {
       this.fired = true;
+      this.captureCompleteAt = tick.at;
       void this.fire(attempt);
     }
   }
@@ -1454,7 +1473,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) {