@a4anthony/proctorkit-vue 0.1.5 → 0.2.0

package/README.md

@@ -314,13 +314,15 @@ Slots:
 
 Use `ProctoringSystemCheck` directly only when you need a custom preflight UI or
 framework wrapper. Normal Vue integrations should not need to import
-`createNestDetectFace`, build `engineOptions`, or manually check preflight
+`createBrowserDetectFace`, build `engineOptions`, or manually check preflight
 outcomes.
 
 When you mount `ProctoringSystemCheck` directly, either serve the VAD assets at
 `/vad/` and `/ort/`, or pass the same `vad-assets` object shown above. Direct
 wizard mounts do not know your API base URL, so they cannot infer the backend
-asset routes automatically.
+asset routes automatically. The in-browser face detector's assets default to
+`/sdk-assets/vision/<version>/` at the ingest URL's origin; pass `vision-assets`
+to serve them elsewhere.
 
 ## Media question components
 
@@ -372,25 +374,189 @@ import { AudioPlayer, AudioRecorder, VideoRecorder } from "@a4anthony/proctorkit
       <AudioRecorder
         :client="client"
         title="Speaking answer"
+        :clip-id="question.currentAudioClipId"
         :max-duration-ms="120000"
-        @uploaded="({ clipNumber }) => saveAnswer({ clipNumber })"
-        @dropped="({ reason }) => showUploadError(reason)"
+        @uploaded="
+          ({ kind, clipId, clipNumber, delivery }) =>
+            saveAnswer({ kind, clipId, clipNumber, delivery })
+        "
+        @dropped="({ clipId, code, reason }) => showUploadError({ clipId, code, reason })"
       />
 
       <VideoRecorder
         :client="client"
         title="Video answer"
+        :clip-id="question.currentVideoClipId"
         :max-duration-ms="120000"
         :stream="candidateCameraStream"
         :video-bitrate="1500000"
-        @uploaded="({ clipNumber }) => saveAnswer({ clipNumber })"
-        @dropped="({ reason }) => showUploadError(reason)"
+        @uploaded="
+          ({ kind, clipId, clipNumber, delivery }) =>
+            saveAnswer({ kind, clipId, clipNumber, delivery })
+        "
+        @dropped="({ clipId, code, reason }) => showUploadError({ clipId, code, reason })"
       />
     </template>
   </ProctoredAssessment>
 </template>
 ```
 
+`clip-id` is optional. When omitted, ProctorKit generates a stable opaque ID
+for the current take only. Generated IDs are not persisted across a component
+or client recreation. Persist the accepted `clipId` with the logical answer so
+you can correlate stored results across a reload. A reload cannot resume an
+in-progress recording or its retry bytes: start a new take with a new ID after a
+reload or new component/client instance, even with the same answer mapping.
+Reuse an ID only for the exact retained bytes of a retry. When the host provides
+an ID, use a fresh 1–200-character ASCII token for every
+distinct retake (for example,
+`speaking-q31-<unique-value>.webm`); `.webm` and `.opus` suffixes are allowed.
+Reuse an ID only to retry the same media bytes. A different recording with the
+same ID produces a `dropped` payload with `code: "conflict"` and
+`reason: "clip-id-conflict"`. Update the current ID before the candidate starts
+another distinct take.
+
+All recorder lifecycle payloads — `started`, `stopped`, `uploaded`, `dropped`,
+and `clip-mirror-failed` — contain `clipId`. Use a persisted accepted ID to
+correlate a stored answer with its question across a reload; never re-supply it
+for different media. `started` and `stopped` carry a provisional `clipNumber`.
+`uploaded` also carries `delivery`:
+
+| `delivery`     | `clipNumber`                                                                            | Persist                                                                               |
+| -------------- | --------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------- |
+| `"client"`     | Provisional because the host `sendClip` completes before ProctorKit allocates a number. | Use `clipId` as the stable answer and evidence correlation key.                       |
+| `"fallback"`   | Canonical within the session and media kind.                                            | Store `kind`, `clipId`, `clipNumber`, `answerReference`, `contentSha256`, and `fallbackSelection`; it is emitted only after the server records the exact durable fallback selection. |
+| `"proctorkit"` | Canonical within the session and media kind.                                            | Save `kind`, `clipId`, and `clipNumber` for ProctorKit lookup.                        |
+| `"local"`      | Provisional and non-canonical. No client or `sendClip` received the bytes.              | Do not treat it as an uploaded answer; use this mode only for non-proctored local UI. |
+
+The clip ID is never used as a storage path or trusted as a media-type
+extension. Deploy the clip-ID-aware server before upgrading clients: an older
+or misrouted server is surfaced as `dropped` with `code: "server-error"` and
+`reason: "invalid-response"`, rather than a false success.
+
+### Host-primary recording upload
+
+`sendClip` delivers each finalized recording to your backend as the primary
+upload. Its optional second argument lets the component render upload progress
+internally:
+
+```ts
+import type { MediaClipDataSink } from "@a4anthony/proctorkit-vue";
+
+const sendClip: MediaClipDataSink = (clip, context) =>
+  new Promise<void>((resolve, reject) => {
+    const request = new XMLHttpRequest();
+    const signal = context?.signal;
+    const abort = () => request.abort();
+    const cleanup = () => signal?.removeEventListener("abort", abort);
+    request.upload.onprogress = ({ lengthComputable, loaded, total }) => {
+      if (lengthComputable && total > 0) {
+        context?.reportProgress?.((loaded / total) * 100);
+      }
+    };
+    request.onload = () => {
+      cleanup();
+      if (request.status >= 200 && request.status < 300) resolve();
+      else reject(new Error(`Upload failed: ${request.status}`));
+    };
+    request.onerror = () => {
+      cleanup();
+      reject(new Error("Upload failed"));
+    };
+    request.onabort = () => {
+      cleanup();
+      reject(new DOMException("Upload aborted", "AbortError"));
+    };
+    request.open("POST", "/api/recordings");
+    request.setRequestHeader("Content-Type", clip.mimeType);
+    request.setRequestHeader("X-Clip-ID", clip.clipId);
+    if (signal?.aborted) {
+      cleanup();
+      reject(new DOMException("Upload aborted", "AbortError"));
+      return;
+    }
+    signal?.addEventListener("abort", abort, { once: true });
+    request.send(clip.blob);
+  });
+```
+
+Existing one-argument callbacks remain valid. With an active ProctorKit client,
+your `sendClip` and the ProctorKit evidence upload start together. The component
+waits for your callback, then emits `uploaded` with `delivery: "client"`; the
+candidate may move to the next question without waiting for the evidence copy.
+The indicator therefore represents `sendClip` and becomes determinate when it
+calls `reportProgress`. Values are rounded and clamped to `0`–`100`.
+
+The ProctorKit upload is background evidence while `sendClip` is present. Its
+failure does not emit a candidate-facing drop, error, or retry control and does
+not change a successful client upload. It continues after a recorder unmount
+while the same session client remains alive. A genuine session end gives it a
+bounded drain period; closing or reloading the page does not preserve a pending
+browser upload. Without `sendClip`, ProctorKit stays primary only when an active
+or explicit client is available, and `uploaded` reports `delivery:
+"proctorkit"`. Without a client, local standalone completion reports
+`delivery: "local"`; it has not uploaded bytes anywhere.
+
+If `sendClip` rejects, the component emits the historical
+`clip-mirror-failed` event name and holds the exact finalized Blob for **Retry
+upload**. It does not report success just because the background ProctorKit copy
+succeeds. The retried callback receives the same bytes, `clipId`, duration, and
+provisional `clipNumber`; it does not record again. An empty recording has no
+bytes and is not retryable. When ProctorKit is primary because `sendClip` is
+unset, rejected and conflicting ProctorKit requests are also not retryable. The
+`signal` is aborted on component unmount, allowing a host transport to cancel
+its request.
+
+### Audio fallback for a failed host upload
+
+`AudioRecorder` has an audio-only `proctoringFallback` prop for integrations
+that can recover a missing answer later through the server-to-server
+[`GET /v1/sessions/:id/audio-clips`](../docs-content/customer/api/sessions.md#recover-mapped-speaking-recordings)
+read. Pass the host’s original question and answer filename with the primary
+sink:
+
+```vue
+<AudioRecorder
+  :client="client"
+  :send-clip="sendAnswerToYourBackend"
+  :proctoring-fallback="{
+    questionId: String(question.id),
+    answerFileName: question.upload.file_name,
+  }"
+  @uploaded="onAudioUploaded"
+/>
+```
+
+The client destination remains the priority. Its success emits `delivery:
+"client"` immediately. If it fails, the component waits for the mapped
+ProctorKit request, then for the server to persist an immutable selection of
+that exact ready clip. It emits `delivery: "fallback"` only after that
+acknowledgement, with canonical `clipId`, `clipNumber`, `answerReference`,
+`contentSha256`, and `fallbackSelection: { source: "client_reported",
+selectedAt }`. Use the exported
+`isAudioClipFallbackUploadedPayload(payload)` guard before accepting that path.
+If both destinations fail, **Retry upload** retries the same finalized take and
+its retryable ProctorKit upload or selection acknowledgement. This does not
+create a fake client upload or place the file in the host’s storage. A fallback
+selection does not establish that the host's next-question API accepted the
+answer. `ProctoredAssessment` supplies its per-tab owner token automatically;
+direct SDK integrations pass it as `sessionOwnerToken` for stale-tab
+concurrency checks. See the [AudioRecorder reference](../docs-content/customer/ui/audio-recorder.md#durable-fallback-for-a-failed-client-upload)
+for the complete contract and recovery safety rules.
+
+For browser ProctorKit uploads, the deadline is progress-aware: it allows 30
+seconds without upload progress and 30 seconds for the response after upload
+completion. Continued progress avoids a fixed whole-upload timeout. The SDK is
+still uploading the completed Blob, not performing end-to-end request streaming.
+
+The circular UI is customizable through `uploadProgressContainer`,
+`uploadProgressLabel`, `uploadProgress`, and `uploadProgressIndicator`. The
+`controls` and `meta` slots receive `mirrorUploading`, `mirrorProgress`,
+`mirrorFailure`, `retrying`, `retryable`, `retryTarget`, and `retryUpload`.
+`retryTarget` is `canonical`, `client`, or `null`; the `mirror*` names are kept
+for slot compatibility and describe the client delivery when `sendClip` exists.
+A custom `controls` slot owns its retry affordance.
+
 ### Media UI customization
 
 Set media design tokens and part classes once when creating the Vue app:
@@ -456,5 +622,7 @@ to the system default output.
 `client.recordVideoClip()`.
 `AudioRecorder` and `VideoRecorder` accept an optional `stream` prop when your
 assessment already owns a microphone/camera stream. The video component previews
-that stream but does not stop its tracks. All four components clean up active
-handles when the component unmounts.
+that stream but does not stop its tracks. Components release their active UI and
+capture resources on unmount. When `sendClip` made ProctorKit an active session
+client's background evidence copy, that session-owned upload continues after the
+recorder unmounts until it settles or the session reaches its bounded end drain.

package/dist/ProctoredAssessment.vue.d.ts

@@ -1,5 +1,6 @@
 import { type PropType } from "vue";
-import { type CheckpointConfig } from "@a4anthony/proctorkit-sdk";
+import { type AudioKeepAliveOptions, type CheckpointConfig, type WebcamSnapshotJsonObject, type CandidateIssueReporter } from "@a4anthony/proctorkit-sdk";
+import { type VisionAssets } from "./browser-face-detector.js";
 import { type IntegrityClearInfo, type IntegrityHoldInfo } from "./proctored-assessment/integrity-hold.js";
 import { type PreflightMessages } from "./messages.js";
 import { type Candidate, type ProctoredAssessmentPreset, type ProctoringPolicyInput } from "./proctored-assessment/policy.js";
@@ -21,6 +22,16 @@ type __VLS_Slots = {
     ended?: (props: ProctoredAssessmentEndedSlotProps) => unknown;
 };
 declare const __VLS_component: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+    /** Experimental output preparation; disabled by default. */
+    audioKeepAlive: {
+        type: PropType<AudioKeepAliveOptions>;
+        default: undefined;
+    };
+    /** Share this reporter with host-owned identity operations. */
+    issueReporter: {
+        type: PropType<CandidateIssueReporter>;
+        default: undefined;
+    };
     appId: {
         type: StringConstructor;
         required: true;
@@ -29,6 +40,10 @@ declare const __VLS_component: import("vue").DefineComponent<import("vue").Extra
         type: StringConstructor;
         required: true;
     };
+    sessionMetadata: {
+        type: PropType<Record<string, string | boolean> | undefined>;
+        default: undefined;
+    };
     candidate: {
         type: PropType<Candidate | undefined>;
         default: undefined;
@@ -53,6 +68,15 @@ declare const __VLS_component: import("vue").DefineComponent<import("vue").Extra
         type: PropType<ProctoringPolicyInput | undefined>;
         default: undefined;
     };
+    /**
+     * Read live host context for each random webcam snapshot. The current
+     * callback is invoked at frame-capture time, so reactive question, view and
+     * section values are frozen with the photo they describe.
+     */
+    getSnapshotMetadata: {
+        type: PropType<() => WebcamSnapshotJsonObject | null | undefined>;
+        default: undefined;
+    };
     apiBaseUrl: {
         type: StringConstructor;
         default: string;
@@ -120,6 +144,14 @@ declare const __VLS_component: import("vue").DefineComponent<import("vue").Extra
         type: PropType<(info: IntegrityClearInfo) => void | Promise<void>>;
         default: undefined;
     };
+    /**
+     * Where the in-browser face detector's runtime and model are served.
+     * Defaults to `<apiBaseUrl>/sdk-assets/vision/<version>/`.
+     */
+    visionAssets: {
+        type: PropType<VisionAssets | undefined>;
+        default: undefined;
+    };
     vadAssets: {
         type: PropType<{
             baseAssetPath?: string;
@@ -210,6 +242,16 @@ declare const __VLS_component: import("vue").DefineComponent<import("vue").Extra
     "integrity-hold": (info: IntegrityHoldInfo) => any;
     "integrity-cleared": (info: IntegrityClearInfo) => any;
 }, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+    /** Experimental output preparation; disabled by default. */
+    audioKeepAlive: {
+        type: PropType<AudioKeepAliveOptions>;
+        default: undefined;
+    };
+    /** Share this reporter with host-owned identity operations. */
+    issueReporter: {
+        type: PropType<CandidateIssueReporter>;
+        default: undefined;
+    };
     appId: {
         type: StringConstructor;
         required: true;
@@ -218,6 +260,10 @@ declare const __VLS_component: import("vue").DefineComponent<import("vue").Extra
         type: StringConstructor;
         required: true;
     };
+    sessionMetadata: {
+        type: PropType<Record<string, string | boolean> | undefined>;
+        default: undefined;
+    };
     candidate: {
         type: PropType<Candidate | undefined>;
         default: undefined;
@@ -242,6 +288,15 @@ declare const __VLS_component: import("vue").DefineComponent<import("vue").Extra
         type: PropType<ProctoringPolicyInput | undefined>;
         default: undefined;
     };
+    /**
+     * Read live host context for each random webcam snapshot. The current
+     * callback is invoked at frame-capture time, so reactive question, view and
+     * section values are frozen with the photo they describe.
+     */
+    getSnapshotMetadata: {
+        type: PropType<() => WebcamSnapshotJsonObject | null | undefined>;
+        default: undefined;
+    };
     apiBaseUrl: {
         type: StringConstructor;
         default: string;
@@ -309,6 +364,14 @@ declare const __VLS_component: import("vue").DefineComponent<import("vue").Extra
         type: PropType<(info: IntegrityClearInfo) => void | Promise<void>>;
         default: undefined;
     };
+    /**
+     * Where the in-browser face detector's runtime and model are served.
+     * Defaults to `<apiBaseUrl>/sdk-assets/vision/<version>/`.
+     */
+    visionAssets: {
+        type: PropType<VisionAssets | undefined>;
+        default: undefined;
+    };
     vadAssets: {
         type: PropType<{
             baseAssetPath?: string;
@@ -409,16 +472,21 @@ declare const __VLS_component: import("vue").DefineComponent<import("vue").Extra
     } | undefined;
     ingestUrl: string;
     preferredLocale: string;
+    visionAssets: VisionAssets | undefined;
     submitCandidateIntake: CandidateIntakeSubmitter | undefined;
+    checkpoint: CheckpointConfig | undefined;
     preset: ProctoredAssessmentPreset | undefined;
+    audioKeepAlive: AudioKeepAliveOptions;
+    issueReporter: CandidateIssueReporter;
+    sessionMetadata: Record<string, string | boolean> | undefined;
     policyOverrides: ProctoringPolicyInput | undefined;
+    getSnapshotMetadata: () => WebcamSnapshotJsonObject | null | undefined;
     apiBaseUrl: string;
     assessmentSlug: string;
     autoStartPreflight: boolean;
     preflightUi: PreflightUi;
     fullscreenExitModal: boolean;
     workerUrl: string | URL | undefined;
-    checkpoint: CheckpointConfig | undefined;
     onIntegrityHold: (info: IntegrityHoldInfo) => void | Promise<void>;
     onIntegrityCleared: (info: IntegrityClearInfo) => void | Promise<void>;
     contentClass: string;

package/dist/ProctoredAssessment.vue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ProctoredAssessment.vue.d.ts","sourceRoot":"","sources":["../src/ProctoredAssessment.vue"],"names":[],"mappings":"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"}
+{"version":3,"file":"ProctoredAssessment.vue.d.ts","sourceRoot":"","sources":["../src/ProctoredAssessment.vue"],"names":[],"mappings":"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"}

package/dist/ProctoringDeviceSettings.vue.d.ts

@@ -2,6 +2,8 @@ import { type DeepCameraCheckOptions, type RuntimeDeviceKind, type RuntimeDevice
 import { type ProctoringDeviceSettingsMessages as CentralDeviceSettingsMessages } from "@a4anthony/proctorkit-content";
 import { type PreflightMessages } from "./messages.js";
 import type { MediaHelpTopicId } from "./i18n/media-help.js";
+import { type MicrophoneCheckMessages } from "./runtime-devices/microphone-check-messages.js";
+import { type VisionAssets } from "./browser-face-detector.js";
 export type ProctoringDeviceSettingsKind = RuntimeDeviceKind;
 export interface ProctoringDeviceSettingsOption {
     deviceId: string;
@@ -29,8 +31,13 @@ type __VLS_Props = {
     devices?: Partial<Record<ProctoringDeviceSettingsKind, ProctoringDeviceSettingsOption[]>>;
     /** @deprecated The shared MicStep, SpeakerStep, and CameraStep own verification. */
     testDevice?: ProctoringDeviceSettingsTestFn;
-    /** Face detector used by the shared CameraStep verifier. */
+    /**
+     * Face detector used by the shared CameraStep verifier. Defaults to
+     * the in-browser detector loaded from `visionAssets`.
+     */
     detectFace?: ProctoringDeviceSettingsDetectFace;
+    /** Where the in-browser face detector's runtime and model are served. */
+    visionAssets?: VisionAssets;
     /** VAD and ONNX Runtime asset paths used by the shared MicStep verifier. */
     vadAssets?: {
         baseAssetPath?: string;
@@ -39,6 +46,21 @@ type __VLS_Props = {
     messages?: Partial<ProctoringDeviceSettingsMessages>;
     /** Candidate wizard copy used by the shared device steps. */
     wizardMessages?: Partial<PreflightMessages>;
+    /**
+     * Offer virtual devices (OBS, Zoom, VB-Cable, …) in the pickers. Pass the
+     * value the policy resolves through the SDK's `resolveAllowVirtualDevices`
+     * so this panel agrees with preflight and the resume check. Default false.
+     */
+    allowVirtualDevices?: boolean;
+    /**
+     * Opened to check a device that may not be working (a recorder's "Check
+     * microphone"): the first device's card opens straight away, and the
+     * microphone re-runs its speech check on the microphone already in use
+     * instead of offering selection only.
+     */
+    checkCurrent?: boolean;
+    /** Copy for the alert shown at the top of a microphone-only check. */
+    microphoneCheckMessages?: Partial<MicrophoneCheckMessages>;
 };
 declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     error: (error: Error) => any;
@@ -55,15 +77,19 @@ declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {
     messages: Partial<ProctoringDeviceSettingsMessages>;
     open: boolean;
     dark: boolean;
+    allowVirtualDevices: boolean;
     vadAssets: {
         baseAssetPath?: string;
         onnxWASMBasePath?: string;
     };
     detectFace: ProctoringDeviceSettingsDetectFace;
+    visionAssets: VisionAssets;
     client: ProctoringDeviceSettingsClient | null;
     kinds: ProctoringDeviceSettingsKind[];
     testDevice: ProctoringDeviceSettingsTestFn;
     wizardMessages: Partial<PreflightMessages>;
+    checkCurrent: boolean;
+    microphoneCheckMessages: Partial<MicrophoneCheckMessages>;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 export default _default;
 //# sourceMappingURL=ProctoringDeviceSettings.vue.d.ts.map

package/dist/ProctoringDeviceSettings.vue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ProctoringDeviceSettings.vue.d.ts","sourceRoot":"","sources":["../src/ProctoringDeviceSettings.vue"],"names":[],"mappings":"AAuiBA,OAAO,EAGL,KAAK,sBAAsB,EAC3B,KAAK,iBAAiB,EACtB,KAAK,yBAAyB,EAC9B,KAAK,eAAe,EAErB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EAGL,KAAK,gCAAgC,IAAI,6BAA6B,EACvE,MAAM,+BAA+B,CAAC;AAGvC,OAAO,EAAoB,KAAK,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAEzE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAc7D,MAAM,MAAM,4BAA4B,GAAG,iBAAiB,CAAC;AAE7D,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,8BAA8B;IAC7C,kBAAkB,IAAI,OAAO,CAAC,eAAe,CAAC,CAAC;IAC/C,gBAAgB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAAC;IAC/E,aAAa,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAAC;IAC5E,YAAY,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAAC;CAC5E;AAED,sFAAsF;AACtF,MAAM,MAAM,8BAA8B,GAAG,CAC3C,IAAI,EAAE,4BAA4B,EAClC,QAAQ,EAAE,MAAM,KACb,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAEhD,MAAM,MAAM,kCAAkC,GAAG,WAAW,CAAC,sBAAsB,CAAC,YAAY,CAAC,CAAC,CAAC;AACnG,MAAM,MAAM,gCAAgC,GAAG,6BAA6B,CAAC;AAE7E,KAAK,WAAW,GAAG;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,8BAA8B,GAAG,IAAI,CAAC;IAC/C,KAAK,CAAC,EAAE,4BAA4B,EAAE,CAAC;IACvC,8EAA8E;IAC9E,OAAO,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,4BAA4B,EAAE,8BAA8B,EAAE,CAAC,CAAC,CAAC;IAC1F,oFAAoF;IACpF,UAAU,CAAC,EAAE,8BAA8B,CAAC;IAC5C,4DAA4D;IAC5D,UAAU,CAAC,EAAE,kCAAkC,CAAC;IAChD,4EAA4E;IAC5E,SAAS,CAAC,EAAE;QACV,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;KAC3B,CAAC;IACF,QAAQ,CAAC,EAAE,OAAO,CAAC,gCAAgC,CAAC,CAAC;IACrD,6DAA6D;IAC7D,cAAc,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAC;CAC7C,CAAC;;;;;;;;;;;;aAbU,OAAO,CAAC,MAAM,CAAC,4BAA4B,EAAE,8BAA8B,EAAE,CAAC,CAAC;cAU9E,OAAO,CAAC,gCAAgC,CAAC;UAf7C,OAAO;UACP,OAAO;eAUF;QACV,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;KAC3B;gBALY,kCAAkC;YAPtC,8BAA8B,GAAG,IAAI;WACtC,4BAA4B,EAAE;gBAIzB,8BAA8B;oBAU1B,OAAO,CAAC,iBAAiB,CAAC;;AAq1B/C,wBAQG"}
+{"version":3,"file":"ProctoringDeviceSettings.vue.d.ts","sourceRoot":"","sources":["../src/ProctoringDeviceSettings.vue"],"names":[],"mappings":"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"}

package/dist/ProctoringSystemCheck.vue.d.ts

@@ -1,16 +1,18 @@
+import { type PreparationFeedback } from "./proctored-assessment/preparation-feedback.js";
 import { type PropType } from "vue";
 import type { CheckKind, FailCode, SimulatedCheckResult } from "@a4anthony/proctorkit-sdk";
 import { type SystemCheckMode, type SystemCheckOptions } from "./usePreflightCheck.js";
 import { type PreflightMessages } from "./messages.js";
 import { type CandidateIntakeConfig, type CandidateIntakeSubmission, type CandidateIntakeSubmitter } from "./candidate-intake.js";
+import { type VisionAssets } from "./browser-face-detector.js";
 import type { PreflightUi } from "./preflight-ui.js";
-declare var __VLS_5: {}, __VLS_10: {}, __VLS_87: {};
+declare var __VLS_5: {}, __VLS_10: {}, __VLS_89: {};
 type __VLS_Slots = {} & {
     'top-left'?: (props: typeof __VLS_5) => any;
 } & {
     'top-right'?: (props: typeof __VLS_10) => any;
 } & {
-    'footer-extras'?: (props: typeof __VLS_87) => any;
+    'footer-extras'?: (props: typeof __VLS_89) => any;
 };
 declare const __VLS_component: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
     mode: {
@@ -66,6 +68,10 @@ declare const __VLS_component: import("vue").DefineComponent<import("vue").Extra
      * with the button spinning while a session starts, instead of swapping to a
      * separate "starting" screen.
      */
+    preparationError: {
+        type: PropType<PreparationFeedback>;
+        default: undefined;
+    };
     starting: {
         type: BooleanConstructor;
         default: boolean;
@@ -90,10 +96,9 @@ declare const __VLS_component: import("vue").DefineComponent<import("vue").Extra
     };
     /**
      * By default the wizard waits for the final preflight telemetry
-     * flush before emitting `pass`. Wrappers that immediately start
-     * runtime proctoring from the final wizard actions can disable this
-     * so browser user activation is still available for fullscreen /
-     * screen-share prompts. Telemetry still flushes with keepalive.
+     * acknowledgement before emitting `pass`. Standalone integrations can
+     * opt out when they own confirmation themselves. ProctoredAssessment
+     * always requires acknowledgement before preparing runtime delivery.
      */
     flushBeforePass: {
         type: BooleanConstructor;
@@ -106,6 +111,15 @@ declare const __VLS_component: import("vue").DefineComponent<import("vue").Extra
         }>;
         default: undefined;
     };
+    /**
+     * Where the in-browser face detector's runtime and model are served.
+     * Defaults to the ProctorKit API at the ingest URL's origin
+     * (`/sdk-assets/vision/<version>/`).
+     */
+    visionAssets: {
+        type: PropType<VisionAssets>;
+        default: undefined;
+    };
     runtimeScreenShareRequired: {
         type: BooleanConstructor;
         default: boolean;
@@ -240,6 +254,10 @@ declare const __VLS_component: import("vue").DefineComponent<import("vue").Extra
      * with the button spinning while a session starts, instead of swapping to a
      * separate "starting" screen.
      */
+    preparationError: {
+        type: PropType<PreparationFeedback>;
+        default: undefined;
+    };
     starting: {
         type: BooleanConstructor;
         default: boolean;
@@ -264,10 +282,9 @@ declare const __VLS_component: import("vue").DefineComponent<import("vue").Extra
     };
     /**
      * By default the wizard waits for the final preflight telemetry
-     * flush before emitting `pass`. Wrappers that immediately start
-     * runtime proctoring from the final wizard actions can disable this
-     * so browser user activation is still available for fullscreen /
-     * screen-share prompts. Telemetry still flushes with keepalive.
+     * acknowledgement before emitting `pass`. Standalone integrations can
+     * opt out when they own confirmation themselves. ProctoredAssessment
+     * always requires acknowledgement before preparing runtime delivery.
      */
     flushBeforePass: {
         type: BooleanConstructor;
@@ -280,6 +297,15 @@ declare const __VLS_component: import("vue").DefineComponent<import("vue").Extra
         }>;
         default: undefined;
     };
+    /**
+     * Where the in-browser face detector's runtime and model are served.
+     * Defaults to the ProctorKit API at the ingest URL's origin
+     * (`/sdk-assets/vision/<version>/`).
+     */
+    visionAssets: {
+        type: PropType<VisionAssets>;
+        default: undefined;
+    };
     runtimeScreenShareRequired: {
         type: BooleanConstructor;
         default: boolean;
@@ -362,6 +388,7 @@ declare const __VLS_component: import("vue").DefineComponent<import("vue").Extra
     "onCandidate-intake-submitted"?: ((submission: CandidateIntakeSubmission) => any) | undefined;
 }>, {
     candidateIntake: CandidateIntakeConfig | undefined;
+    mode: SystemCheckMode;
     autoStart: boolean;
     candidate: {
         id: string;
@@ -369,7 +396,6 @@ declare const __VLS_component: import("vue").DefineComponent<import("vue").Extra
         email?: string;
         metadata?: Record<string, unknown>;
     };
-    mode: SystemCheckMode;
     fullPolicy: Record<string, unknown>;
     messages: Partial<PreflightMessages>;
     dark: boolean;
@@ -382,12 +408,14 @@ declare const __VLS_component: import("vue").DefineComponent<import("vue").Extra
     appId: string;
     autoResumeSeconds: number;
     starting: boolean;
+    preparationError: PreparationFeedback;
     engineOptions: Omit<SystemCheckOptions, "mode">;
     preferredLocale: string;
     goodReferencePhoto: string;
     simulateResults: SimulatedCheckResult[];
     allowDevSkip: boolean;
     flushBeforePass: boolean;
+    visionAssets: VisionAssets;
     runtimeScreenShareRequired: boolean;
     runtimeScreenShareState: "pending" | "error" | "active" | "idle";
     runtimeScreenShareError: string;

package/dist/ProctoringSystemCheck.vue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ProctoringSystemCheck.vue.d.ts","sourceRoot":"","sources":["../src/ProctoringSystemCheck.vue"],"names":[],"mappings":"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"}
+{"version":3,"file":"ProctoringSystemCheck.vue.d.ts","sourceRoot":"","sources":["../src/ProctoringSystemCheck.vue"],"names":[],"mappings":"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"}