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

package/dist/core/index.d.cts

@@ -1,5 +1,5 @@
-import { C as CameraErrorKind } from '../capture-session-v3-CAoWM8iT.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-CAoWM8iT.cjs';
+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';
 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-BJ8ciaWl.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-BJ8ciaWl.js';
+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';
 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-LOTAJDRE.js";
+} from "../chunk-EWRNPKTR.js";
 import {
   DEFAULT_TIER_ORDER,
   DEFAULT_V3_ASSET_BASE_URL,

package/dist/{create-verification-EnZ13uY4.d.cts → create-verification-Ce1y5kJR.d.ts}

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

package/dist/{create-verification-CjLnJ0w6.d.ts → create-verification-Dkb2tXuY.d.cts}

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

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 };

package/dist/index.cjs

@@ -862,10 +862,12 @@ var V3_GATE_DEFAULTS = Object.freeze({
   MOTION_TAU_S: 0.4,
   MOTION_DEADBAND_IOD_PER_S: 0.1,
   READY_WINDOW_MS: 500,
-  // 0.7→0.75 with the trimmed window: trimming forgives exactly ONE flaky
-  // tick; the raised mean keeps a SECOND bad tick (a real sustained wobble)
-  // from diluting through at 10 Hz cadences.
-  READY_MEAN_Q: 0.75,
+  // (READY_MEAN_Q, the former 0.75 window MEAN, is gone — 2026-10-17 field
+  // bug: a steady q anywhere in [Q_GOOD, 0.75) saturated p at 1, passed every
+  // guide ("hold still") and could never reach the mean, so the ring sat full
+  // and green with nothing recording. Readiness now checks the window against
+  // Q_GOOD, which keeps the one-flaky-tick forgiveness and the second-bad-tick
+  // block without a dead band above the rise threshold.)
   GUIDE_SIZE: 0.6,
   GUIDE_CENTERING: 0.6,
   GUIDE_POSE: 0.6,
@@ -943,15 +945,15 @@ var FaceGateV3 = class {
       const worstIndex = windowSamples.indexOf(worst);
       windowSamples = windowSamples.filter((_, index) => index !== worstIndex);
     }
-    const windowMean = windowSamples.reduce((sum, value) => sum + value, 0) / Math.max(1, windowSamples.length);
-    const ready = this.p >= 1 && windowMean >= this.t.READY_MEAN_Q;
+    const ready = this.p >= 1 && windowSamples.every((sample) => sample >= this.t.Q_GOOD);
     return {
       at: timestampMs,
       q,
       p: this.p,
       factors,
       guidanceKey: this.guidanceOf(factors, quality, q),
-      ready
+      ready,
+      accepted: q >= this.t.Q_GOOD
     };
   }
   geometryOf(observation, input) {
@@ -1069,6 +1071,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 = [];
@@ -1123,6 +1130,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") {
@@ -1132,6 +1143,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) {
@@ -1147,6 +1159,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 } : {}
@@ -1246,6 +1259,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,
@@ -1259,6 +1273,7 @@ var CaptureSessionV3 = class {
     }
     if (tick.ready && this.stateValue === "positioning") {
       this.fired = true;
+      this.captureCompleteAt = tick.at;
       void this.fire(attempt);
     }
   }
@@ -1353,7 +1368,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) {
@@ -1562,6 +1591,14 @@ function createLivenessCaptureInternal(options, internals = {}) {
   let animations = "full";
   let recordingStartedAt = null;
   let frozenAt = null;
+  let frameWidth = 0;
+  let frameHeight = 0;
+  const latchFrameSize = () => {
+    if (options.video.videoWidth > 0 && options.video.videoHeight > 0) {
+      frameWidth = options.video.videoWidth;
+      frameHeight = options.video.videoHeight;
+    }
+  };
   const setState = (next) => {
     state = next;
     emitter.emit("state", next);
@@ -1582,10 +1619,13 @@ function createLivenessCaptureInternal(options, internals = {}) {
         faceDetected = false;
         recordingStartedAt = null;
         frozenAt = null;
+        frameWidth = 0;
+        frameHeight = 0;
       }
       setState(next);
       syncProfile();
       if (next === "recording") {
+        latchFrameSize();
         recordingStartedAt = now();
         hint = "hold";
         progress = 1;
@@ -1593,6 +1633,7 @@ function createLivenessCaptureInternal(options, internals = {}) {
       }
     }),
     engine.on("checks", (payload) => {
+      latchFrameSize();
       progress = payload.progress;
       faceDetected = payload.factors.presence > 0;
       emitGate();
@@ -1612,11 +1653,16 @@ function createLivenessCaptureInternal(options, internals = {}) {
         keyframe: artifacts.keyframe,
         ...artifacts.clip !== void 0 ? { clip: artifacts.clip } : {},
         ...artifacts.clipMimeType !== void 0 ? { clipMime: artifacts.clipMimeType } : {},
-        width: options.video.videoWidth,
-        height: options.video.videoHeight,
+        width: options.video.videoWidth || frameWidth,
+        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 }) => {
@@ -2191,7 +2237,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 }
       );
     },
@@ -2202,6 +2253,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) => {