@a4anthony/proctorkit-vue 0.1.5 → 0.2.0

package/dist/media-controls/VideoRecorder.vue.d.ts

@@ -1,7 +1,8 @@
 import type { ProctoringClient } from "@a4anthony/proctorkit-sdk";
+import { type LostTrackKind } from "../runtime-devices/useTrackLoss.js";
 import type { MediaClipDataSink, MediaClipDroppedPayload, MediaClipErrorPayload, MediaClipMirrorErrorPayload, MediaClipStartedPayload, MediaClipStoppedPayload, MediaClipUploadedPayload } from "./types.js";
 import { type MediaPartClasses, type MediaPartStyles, type ProctoringMediaTheme, type VideoRecorderPart, type VideoRecorderUi } from "./ui-config.js";
-type VideoRecorderClient = Pick<ProctoringClient, "recordVideoClip">;
+type VideoRecorderClient = Pick<ProctoringClient, "recordVideoClip"> & Partial<Pick<ProctoringClient, "holdAudioForCapture">>;
 type __VLS_Props = {
     client?: VideoRecorderClient;
     title?: string;
@@ -32,6 +33,11 @@ type __VLS_Props = {
      * retried.
      */
     allowedRetakes?: number | null;
+    /**
+     * Stable opaque identity for this recording. Filename-like values with an
+     * extension are accepted. Use a fresh value for each distinct retake.
+     */
+    clipId?: string;
     disabled?: boolean;
     maxDurationMs?: number;
     /** Include a microphone track in the clip. Default true. */
@@ -51,13 +57,17 @@ type __VLS_Props = {
     stream?: MediaStream;
     unavailableMessage?: string;
     /**
-     * Mirror each finalized clip to your own backend, IN ADDITION to
-     * the proctoring server. Receives the recorded video as a Blob plus
-     * `{ mimeType, durationMs, clipNumber }`; resolve when your upload
-     * succeeds, throw/reject when it fails. A failure here is non-fatal
-     * — the clip still uploads to the proctoring server and `uploaded`
-     * still fires; the rejection surfaces on `clip-mirror-failed`. The
-     * two uploads run in parallel, so the mirror never delays `uploaded`.
+     * Deliver each finalized clip to your own backend as the primary upload.
+     * Receives video as a Blob plus
+     * `{ mimeType, durationMs, clipId, clipNumber }`; resolve when your upload
+     * succeeds, throw/reject when it fails. `uploaded` waits for this sink and
+     * reports `delivery: "client"`; a rejection remains retryable and does not
+     * become successful merely because the independent ProctorKit copy succeeds.
+     * With an active client, ProctorKit uploads in the background and never
+     * changes the candidate-facing result. In standalone mode ProctorKit is not used.
+     * The optional second callback argument exposes `reportProgress` and
+     * an unmount `signal`. Progress drives the circular indicator when
+     * `sendClip` is the primary delivery path; ProctorKit progress is not shown.
      */
     sendClip?: MediaClipDataSink;
     /**
@@ -78,7 +88,14 @@ type __VLS_Props = {
     styles?: MediaPartStyles<VideoRecorderPart>;
     unstyled?: boolean;
     theme?: ProctoringMediaTheme;
+    /**
+     * Shown when the camera or microphone disconnects mid-take. `{device}` is
+     * replaced with "camera" or "microphone". The take is stopped and does not
+     * use up a retake.
+     */
+    deviceLostMessage?: string;
 };
+declare function retryPrimaryUpload(): Promise<void>;
 declare function toggleRecording(): Promise<void>;
 declare var __VLS_1: {
     recording: boolean;
@@ -103,16 +120,32 @@ declare var __VLS_1: {
     recording: boolean;
     starting: boolean;
     stopping: boolean;
+    retrying: boolean;
+    retryable: boolean;
+    retryTarget: "client" | "canonical" | null;
+    mirrorUploading: boolean;
+    mirrorProgress: number | null;
+    mirrorFailure: {
+        kind: import("./types.js", { with: { "resolution-mode": "import" } }).MediaClipKind;
+        clipId: string;
+        clipNumber: number;
+        error: Error;
+        message: string;
+    } | null;
     busyLabel: string | null;
+    uploadLabel: any;
     uploadedLabel: string | null;
     actionLabel: string;
     actionDisabled: boolean;
     showAction: boolean;
     toggle: typeof toggleRecording;
-}, __VLS_30: {
+    retryUpload: typeof retryPrimaryUpload;
+}, __VLS_40: {
     clipNumber: number | null;
     uploaded: {
         kind: import("./types.js", { with: { "resolution-mode": "import" } }).MediaClipKind;
+        clipId: string;
+        delivery: "client" | "fallback" | "proctorkit" | "local";
         clipNumber: number;
         byteSize: number;
         durationMs: number;
@@ -127,10 +160,27 @@ declare var __VLS_1: {
             peakDb: number;
             silentRatio: number;
             lowVolumeRatio: number;
+            inputLiveness?: {
+                digitalSilenceRatio: number;
+                longestDigitalSilenceMs: number;
+                longestMutedMs: number;
+                suspendedMs: number;
+                noInput: boolean;
+            } | undefined;
+        } | undefined;
+        answerReference?: {
+            questionId: string;
+            answerFileName: string;
         } | undefined;
+        fallbackSelection?: {
+            readonly source: "client_reported";
+            readonly selectedAt: string;
+        } | undefined;
+        contentSha256?: string | undefined;
     } | null;
     dropped: {
         kind: import("./types.js", { with: { "resolution-mode": "import" } }).MediaClipKind;
+        clipId: string;
         clipNumber: number;
         code: import("./types.js", { with: { "resolution-mode": "import" } }).MediaClipDropCode;
         reason: string;
@@ -145,6 +195,13 @@ declare var __VLS_1: {
             peakDb: number;
             silentRatio: number;
             lowVolumeRatio: number;
+            inputLiveness?: {
+                digitalSilenceRatio: number;
+                longestDigitalSilenceMs: number;
+                longestMutedMs: number;
+                suspendedMs: number;
+                noInput: boolean;
+            } | undefined;
         } | undefined;
     } | null;
     error: {
@@ -156,6 +213,19 @@ declare var __VLS_1: {
     recording: boolean;
     starting: boolean;
     stopping: boolean;
+    retrying: boolean;
+    retryable: boolean;
+    retryTarget: "client" | "canonical" | null;
+    retryUpload: typeof retryPrimaryUpload;
+    mirrorUploading: boolean;
+    mirrorProgress: number | null;
+    mirrorFailure: {
+        kind: import("./types.js", { with: { "resolution-mode": "import" } }).MediaClipKind;
+        clipId: string;
+        clipNumber: number;
+        error: Error;
+        message: string;
+    } | null;
     elapsedMs: number;
     remainingMs: number;
     maxDurationMs: number;
@@ -175,7 +245,7 @@ type __VLS_Slots = {} & {
 } & {
     controls?: (props: typeof __VLS_13) => any;
 } & {
-    meta?: (props: typeof __VLS_30) => any;
+    meta?: (props: typeof __VLS_40) => any;
 };
 declare const __VLS_component: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     error: (payload: MediaClipErrorPayload) => any;
@@ -184,6 +254,10 @@ declare const __VLS_component: import("vue").DefineComponent<__VLS_Props, {}, {}
     uploaded: (payload: MediaClipUploadedPayload) => any;
     dropped: (payload: MediaClipDroppedPayload) => any;
     "clip-mirror-failed": (payload: MediaClipMirrorErrorPayload) => any;
+    deviceLost: (payload: {
+        kind: LostTrackKind;
+        clipId: string | null;
+    }) => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
     onError?: ((payload: MediaClipErrorPayload) => any) | undefined;
     onStopped?: ((payload: MediaClipStoppedPayload) => any) | undefined;
@@ -191,6 +265,10 @@ declare const __VLS_component: import("vue").DefineComponent<__VLS_Props, {}, {}
     onUploaded?: ((payload: MediaClipUploadedPayload) => any) | undefined;
     onDropped?: ((payload: MediaClipDroppedPayload) => any) | undefined;
     "onClip-mirror-failed"?: ((payload: MediaClipMirrorErrorPayload) => any) | undefined;
+    onDeviceLost?: ((payload: {
+        kind: LostTrackKind;
+        clipId: string | null;
+    }) => any) | undefined;
 }>, {
     autoStart: boolean;
     title: string;
@@ -198,6 +276,7 @@ declare const __VLS_component: import("vue").DefineComponent<__VLS_Props, {}, {}
     disabled: boolean;
     audio: boolean;
     maxDurationMs: number;
+    clipId: string;
     stream: MediaStream;
     videoBitrate: number;
     stopLabel: string;
@@ -209,6 +288,7 @@ declare const __VLS_component: import("vue").DefineComponent<__VLS_Props, {}, {}
     unavailableMessage: string;
     sendClip: MediaClipDataSink;
     startRecording: boolean;
+    deviceLostMessage: string;
     cameraDeviceId: string | null;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: __VLS_WithSlots<typeof __VLS_component, __VLS_Slots>;

package/dist/media-controls/VideoRecorder.vue.d.ts.map

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

package/dist/media-controls/audio-recorder-messages.d.ts

@@ -0,0 +1,15 @@
+/** Copy for `<AudioRecorder>`'s microphone hints, shown below the recorder. */
+export interface AudioRecorderMicrophoneMessages {
+    /** The microphone would not open, so the take did not start. */
+    unavailable: string;
+    /** A finished take was silent and the candidate may record again. */
+    silentTake: string;
+    /** A finished take was silent and no retake is left. */
+    silentTakeNoRetake: string;
+    /** During a take, with `liveInputHint`: no input for a few seconds. */
+    noInput: string;
+    /** Opens Device settings with only the microphone. */
+    checkMicrophone: string;
+}
+export declare const DEFAULT_AUDIO_RECORDER_MICROPHONE_MESSAGES: AudioRecorderMicrophoneMessages;
+//# sourceMappingURL=audio-recorder-messages.d.ts.map

package/dist/media-controls/audio-recorder-messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio-recorder-messages.d.ts","sourceRoot":"","sources":["../../src/media-controls/audio-recorder-messages.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,MAAM,WAAW,+BAA+B;IAC9C,gEAAgE;IAChE,WAAW,EAAE,MAAM,CAAC;IACpB,qEAAqE;IACrE,UAAU,EAAE,MAAM,CAAC;IACnB,wDAAwD;IACxD,kBAAkB,EAAE,MAAM,CAAC;IAC3B,uEAAuE;IACvE,OAAO,EAAE,MAAM,CAAC;IAChB,sDAAsD;IACtD,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,eAAO,MAAM,0CAA0C,EAAE,+BAMxD,CAAC"}

package/dist/media-controls/local-media-playback-client.d.ts

@@ -1,11 +1,7 @@
-import type { ProctoringClient } from "@a4anthony/proctorkit-sdk";
-/**
- * Local fallbacks for `<AudioPlayer>` / `<VideoPlayer>` used when no SDK
- * client is supplied (docs examples, Storybook standalone stories,
- * pre-session UIs). Same handle surface as the SDK helpers, no telemetry.
- */
+import { type ProctoringClient } from "@a4anthony/proctorkit-sdk";
 export type AudioPlaybackClient = Pick<ProctoringClient, "playAudioFile">;
 export type VideoPlaybackClient = Pick<ProctoringClient, "playVideoFile">;
+/** Standalone components use the SDK recovery engine without session telemetry. */
 export declare function createLocalAudioPlaybackClient(): AudioPlaybackClient;
 export declare function createLocalVideoPlaybackClient(): VideoPlaybackClient;
 //# sourceMappingURL=local-media-playback-client.d.ts.map

package/dist/media-controls/local-media-playback-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"local-media-playback-client.d.ts","sourceRoot":"","sources":["../../src/media-controls/local-media-playback-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAIV,gBAAgB,EAEjB,MAAM,2BAA2B,CAAC;AAEnC;;;;GAIG;AAEH,MAAM,MAAM,mBAAmB,GAAG,IAAI,CAAC,gBAAgB,EAAE,eAAe,CAAC,CAAC;AAC1E,MAAM,MAAM,mBAAmB,GAAG,IAAI,CAAC,gBAAgB,EAAE,eAAe,CAAC,CAAC;AAE1E,wBAAgB,8BAA8B,IAAI,mBAAmB,CASpE;AAED,wBAAgB,8BAA8B,IAAI,mBAAmB,CAkBpE"}
+{"version":3,"file":"local-media-playback-client.d.ts","sourceRoot":"","sources":["../../src/media-controls/local-media-playback-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,gBAAgB,EACtB,MAAM,2BAA2B,CAAC;AAEnC,MAAM,MAAM,mBAAmB,GAAG,IAAI,CAAC,gBAAgB,EAAE,eAAe,CAAC,CAAC;AAC1E,MAAM,MAAM,mBAAmB,GAAG,IAAI,CAAC,gBAAgB,EAAE,eAAe,CAAC,CAAC;AAE1E,mFAAmF;AACnF,wBAAgB,8BAA8B,IAAI,mBAAmB,CAEpE;AAED,wBAAgB,8BAA8B,IAAI,mBAAmB,CAEpE"}

package/dist/media-controls/local-media-recording-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"local-media-recording-client.d.ts","sourceRoot":"","sources":["../../src/media-controls/local-media-recording-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGV,gBAAgB,EAEjB,MAAM,2BAA2B,CAAC;AAEnC;;;;;;;;;;;;;;;;;GAiBG;AAEH,MAAM,MAAM,uBAAuB,GAAG,IAAI,CAAC,gBAAgB,EAAE,iBAAiB,CAAC,CAAC;AAChF,MAAM,MAAM,uBAAuB,GAAG,IAAI,CAAC,gBAAgB,EAAE,iBAAiB,CAAC,CAAC;AA8BhF,wBAAgB,+BAA+B,IAAI,uBAAuB,CAgHzE;AAmBD;;;;;;;;;;;;GAYG;AACH,wBAAgB,+BAA+B,IAAI,uBAAuB,CA2GzE"}
+{"version":3,"file":"local-media-recording-client.d.ts","sourceRoot":"","sources":["../../src/media-controls/local-media-recording-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGV,gBAAgB,EAEjB,MAAM,2BAA2B,CAAC;AAMnC;;;;;;;;;;;;;;;;;GAiBG;AAEH,MAAM,MAAM,uBAAuB,GAAG,IAAI,CAAC,gBAAgB,EAAE,iBAAiB,CAAC,CAAC;AAChF,MAAM,MAAM,uBAAuB,GAAG,IAAI,CAAC,gBAAgB,EAAE,iBAAiB,CAAC,CAAC;AAoChF,wBAAgB,+BAA+B,IAAI,uBAAuB,CAgIzE;AAiCD;;;;;;;;;;;;GAYG;AACH,wBAAgB,+BAA+B,IAAI,uBAAuB,CA4HzE"}

package/dist/media-controls/media-recovery-story.d.ts

@@ -0,0 +1,9 @@
+/** Controlled, permission-free previews of recovery controls. */
+export declare function mediaRecoveryStory(kind: "audio" | "video", scenario: "primary-loading" | "fallback-loading" | "both-failed" | "retry-recovery"): {
+    render: () => {
+        setup(): () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
+            [key: string]: any;
+        }>;
+    };
+};
+//# sourceMappingURL=media-recovery-story.d.ts.map

package/dist/media-controls/media-recovery-story.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-recovery-story.d.ts","sourceRoot":"","sources":["../../src/media-controls/media-recovery-story.ts"],"names":[],"mappings":"AASA,iEAAiE;AACjE,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,OAAO,GAAG,OAAO,EACvB,QAAQ,EAAE,iBAAiB,GAAG,kBAAkB,GAAG,aAAa,GAAG,gBAAgB;;;;;;EAqGpF"}

package/dist/media-controls/storybook-mock-client.d.ts

@@ -25,5 +25,7 @@ export declare function createTimeline(limit?: number): {
 export declare function createMockProctoringClient(options: {
     addEvent: (kind: string, detail: string, tone?: TimelineItem["tone"]) => void;
     shouldDropUpload?: () => boolean;
+    uploadDelayMs?: () => number;
+    retryDelayMs?: () => number;
 }): ProctoringClient;
 //# sourceMappingURL=storybook-mock-client.d.ts.map

package/dist/media-controls/storybook-mock-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"storybook-mock-client.d.ts","sourceRoot":"","sources":["../../src/media-controls/storybook-mock-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,uBAAuB,EAEvB,gBAAgB,EAEjB,MAAM,2BAA2B,CAAC;AAInC,MAAM,MAAM,YAAY,GAAG;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,SAAS,GAAG,SAAS,GAAG,MAAM,CAAC;CACtC,CAAC;AA+GF,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,uBAAuB,GAAG,IAAI,GAAG,SAAS,GACnD,MAAM,CAKR;AAED,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,uBAAuB,GAAG,IAAI,GAAG,SAAS,GACnD,YAAY,CAAC,MAAM,CAAC,CAGtB;AAED,wBAAgB,cAAc,CAAC,KAAK,SAAK;qBAK/B,MAAM,UACJ,MAAM,SACR,YAAY,CAAC,MAAM,CAAC;;;YA1IxB,MAAM;cACJ,MAAM;gBACJ,MAAM;cACR,SAAS,GAAG,SAAS,GAAG,MAAM;;YAHhC,MAAM;cACJ,MAAM;gBACJ,MAAM;cACR,SAAS,GAAG,SAAS,GAAG,MAAM;;EAmJrC;AAED,wBAAgB,0BAA0B,CAAC,OAAO,EAAE;IAClD,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,YAAY,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC;IAC9E,gBAAgB,CAAC,EAAE,MAAM,OAAO,CAAC;CAClC,GAAG,gBAAgB,CAgUnB"}
+{"version":3,"file":"storybook-mock-client.d.ts","sourceRoot":"","sources":["../../src/media-controls/storybook-mock-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,uBAAuB,EAIvB,gBAAgB,EAEjB,MAAM,2BAA2B,CAAC;AASnC,MAAM,MAAM,YAAY,GAAG;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,SAAS,GAAG,SAAS,GAAG,MAAM,CAAC;CACtC,CAAC;AAkHF,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,uBAAuB,GAAG,IAAI,GAAG,SAAS,GACnD,MAAM,CAUR;AAED,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,uBAAuB,GAAG,IAAI,GAAG,SAAS,GACnD,YAAY,CAAC,MAAM,CAAC,CAGtB;AAED,wBAAgB,cAAc,CAAC,KAAK,SAAK;qBAIf,MAAM,UAAU,MAAM,SAAQ,YAAY,CAAC,MAAM,CAAC;;;YA/ItE,MAAM;cACJ,MAAM;gBACJ,MAAM;cACR,SAAS,GAAG,SAAS,GAAG,MAAM;;YAHhC,MAAM;cACJ,MAAM;gBACJ,MAAM;cACR,SAAS,GAAG,SAAS,GAAG,MAAM;;EAuJrC;AAED,wBAAgB,0BAA0B,CAAC,OAAO,EAAE;IAClD,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,YAAY,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC;IAC9E,gBAAgB,CAAC,EAAE,MAAM,OAAO,CAAC;IACjC,aAAa,CAAC,EAAE,MAAM,MAAM,CAAC;IAC7B,YAAY,CAAC,EAAE,MAAM,MAAM,CAAC;CAC7B,GAAG,gBAAgB,CAsZnB"}

package/dist/media-controls/types.d.ts

@@ -1,25 +1,60 @@
-import type { AudioClipVolumeAnalysis, ClipDropCode, ClipStartErrorCode, SessionEvent } from "@a4anthony/proctorkit-sdk";
+import type { AudioClipAnswerReference, AudioClipFallbackSelection, AudioClipVolumeAnalysis, ClipDropCode, ClipStartErrorCode, SessionEvent } from "@a4anthony/proctorkit-sdk";
 export type MediaClipKind = "audio" | "video";
+export type AudioClipProctoringFallback = AudioClipAnswerReference;
 /** Stable codes re-exported from the SDK for the media event payloads. */
 export type MediaClipDropCode = ClipDropCode;
 export type MediaClipErrorCode = ClipStartErrorCode;
 export interface MediaClipStartedPayload {
     kind: MediaClipKind;
+    /** Stable opaque identity supplied by the host or generated by ProctorKit. */
+    clipId: string;
+    /** Provisional until the upload response allocates the canonical number. */
     clipNumber: number;
 }
 export interface MediaClipStoppedPayload {
     kind: MediaClipKind;
+    clipId: string;
+    /** Provisional until the upload response allocates the canonical number. */
     clipNumber: number;
 }
 export interface MediaClipUploadedPayload {
     kind: MediaClipKind;
+    clipId: string;
+    /**
+     * Destination that accepted the recording and caused this component result.
+     * `client` means the host-supplied `sendClip`; `proctorkit` means ProctorKit
+     * stored the clip; `local` is the standalone simulated result with no upload.
+     */
+    delivery: "client" | "fallback" | "proctorkit" | "local";
+    /**
+     * Provisional for `delivery: "client"` or `"local"`; canonical and
+     * session-scoped for `delivery: "fallback"` or `"proctorkit"`. Use clipId
+     * as the stable key.
+     */
     clipNumber: number;
     byteSize: number;
     durationMs: number;
     volumeAnalysis?: AudioClipVolumeAnalysis;
+    /** Present when ProctorKit durably stored the client answer mapping. */
+    answerReference?: AudioClipAnswerReference;
+    /** Present only after the server persisted the client-reported selection. */
+    fallbackSelection?: AudioClipFallbackSelection;
+    /** Content digest from the server's exact fallback-selection receipt. */
+    contentSha256?: string;
 }
+/** The narrowed payload emitted after a mapped ProctorKit fallback is durable. */
+export type AudioClipFallbackUploadedPayload = MediaClipUploadedPayload & {
+    kind: "audio";
+    delivery: "fallback";
+    answerReference: AudioClipAnswerReference;
+    fallbackSelection: AudioClipFallbackSelection;
+    contentSha256: string;
+};
+/** Narrow a generic recorder upload event to the durable audio fallback contract. */
+export declare function isAudioClipFallbackUploadedPayload(payload: MediaClipUploadedPayload): payload is AudioClipFallbackUploadedPayload;
 export interface MediaClipDroppedPayload {
     kind: MediaClipKind;
+    clipId: string;
     clipNumber: number;
     /** Stable, machine-readable classification of the drop. */
     code: MediaClipDropCode;
@@ -52,26 +87,47 @@ export interface MediaPlaybackThrownErrorPayload {
     message: string;
 }
 /**
- * The finalized clip handed to a host-supplied mirror. Receives a Blob
+ * The finalized clip handed to a host-supplied primary destination. Receives a Blob
  * (drop straight into fetch/FormData or a presigned PUT) plus the
  * metadata needed to associate it on the host's side. Resolve = the
- * mirror succeeded; reject/throw = it failed (non-fatal — see
+ * client delivery succeeded; reject/throw = it failed (see
  * MediaClipMirrorErrorPayload).
  */
 export interface MediaClipData {
     blob: Blob;
     mimeType: string;
     durationMs: number;
+    clipId: string;
     clipNumber: number;
+    /** Audio-only analysis when the recorder could calculate it. */
+    volumeAnalysis?: AudioClipVolumeAnalysis;
+}
+/**
+ * Optional controls supplied to a host `sendClip` implementation.
+ *
+ * Call `reportProgress` with a percentage from 0 to 100 when the transport
+ * exposes upload progress. Values outside that range are clamped by the
+ * recorder. If progress is never reported, the recorder keeps its internal
+ * indicator indeterminate. `signal` is aborted when the recorder unmounts;
+ * transports that support cancellation may observe it.
+ */
+export interface MediaClipSendContext {
+    reportProgress?: (percentage: number) => void;
+    signal?: AbortSignal;
 }
-export type MediaClipDataSink = (clip: MediaClipData) => Promise<unknown>;
 /**
- * Emitted when a host-supplied clip mirror rejects. The clip itself is
- * still uploaded to the proctoring server, so this is informational —
- * it never accompanies a `dropped`.
+ * Host primary delivery for a finalized recording. The optional second
+ * argument is backward-compatible with existing one-argument sinks.
+ */
+export type MediaClipDataSink = (clip: MediaClipData, context?: MediaClipSendContext) => Promise<unknown>;
+/**
+ * Emitted when a host-supplied `sendClip` rejects. The recording remains
+ * available for an exact-byte retry. The historical name is retained for
+ * compatibility even though `sendClip` is now the primary destination.
  */
 export interface MediaClipMirrorErrorPayload {
     kind: MediaClipKind;
+    clipId: string;
     clipNumber: number;
     error: Error;
     message: string;

package/dist/media-controls/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/media-controls/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,uBAAuB,EACvB,YAAY,EACZ,kBAAkB,EAClB,YAAY,EACb,MAAM,2BAA2B,CAAC;AAEnC,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,OAAO,CAAC;AAE9C,0EAA0E;AAC1E,MAAM,MAAM,iBAAiB,GAAG,YAAY,CAAC;AAC7C,MAAM,MAAM,kBAAkB,GAAG,kBAAkB,CAAC;AAEpD,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,aAAa,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,aAAa,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,aAAa,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,uBAAuB,CAAC;CAC1C;AAED,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,aAAa,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,2DAA2D;IAC3D,IAAI,EAAE,iBAAiB,CAAC;IACxB,sEAAsE;IACtE,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,uBAAuB,CAAC;CAC1C;AAED;;;;;GAKG;AACH,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,aAAa,CAAC;IACpB,+DAA+D;IAC/D,IAAI,EAAE,kBAAkB,CAAC;IACzB,KAAK,EAAE,KAAK,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;GAKG;AACH,MAAM,WAAW,+BAA+B;IAC9C,IAAI,EAAE,UAAU,CAAC;IACjB,KAAK,EAAE,KAAK,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,IAAI,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,iBAAiB,GAAG,CAAC,IAAI,EAAE,aAAa,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;AAE1E;;;;GAIG;AACH,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,aAAa,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,KAAK,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,YAAY,CAAC,SAAS,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,yBAA0B,SAAQ,yBAAyB;IAC1E,KAAK,EAAE,KAAK,CAAC;CACd;AAED,MAAM,WAAW,8BAA8B;IAC7C,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,yBAAyB,GAAG,yBAAyB,CAAC;AAClE,MAAM,MAAM,yBAAyB,GAAG,yBAAyB,CAAC;AAClE,MAAM,MAAM,8BAA8B,GAAG,8BAA8B,CAAC;AAE5E,MAAM,MAAM,yBAAyB,GAAG,yBAAyB,CAAC;AAClE,MAAM,MAAM,yBAAyB,GAAG,yBAAyB,CAAC;AAClE,MAAM,MAAM,8BAA8B,GAAG,8BAA8B,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/media-controls/types.ts"],"names":[],"mappings":"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"}

package/dist/media-controls/ui-config.d.ts

@@ -5,8 +5,8 @@ export type MediaPartClasses<TPart extends string> = Partial<Record<TPart, Media
 export type MediaPartStyles<TPart extends string> = Partial<Record<TPart, CSSProperties>>;
 export type AudioPlayerPart = "root" | "surface" | "content" | "icon" | "media" | "timeline" | "time" | "progress" | "buffered" | "elapsed" | "metadata" | "error" | "controls" | "action" | "meta";
 export type VideoPlayerPart = "root" | "surface" | "viewport" | "media" | "buffering" | "bufferingIcon" | "timeline" | "time" | "progress" | "buffered" | "elapsed" | "metadata" | "error" | "controls" | "action" | "meta";
-export type AudioRecorderPart = "root" | "waveform" | "waveformTrack" | "waveformBar" | "surface" | "content" | "icon" | "timeline" | "time" | "progress" | "elapsed" | "metadata" | "error" | "controls" | "status" | "action" | "meta";
-export type VideoRecorderPart = "root" | "surface" | "viewport" | "media" | "placeholder" | "placeholderIcon" | "timeline" | "time" | "progress" | "elapsed" | "error" | "controls" | "status" | "action" | "meta";
+export type AudioRecorderPart = "root" | "waveform" | "waveformTrack" | "waveformBar" | "surface" | "content" | "icon" | "timeline" | "time" | "progress" | "elapsed" | "metadata" | "error" | "controls" | "status" | "uploadProgressContainer" | "uploadProgress" | "uploadProgressLabel" | "uploadProgressIndicator" | "action" | "meta" | "microphoneHint" | "microphoneCheck";
+export type VideoRecorderPart = "root" | "surface" | "viewport" | "media" | "placeholder" | "placeholderIcon" | "timeline" | "time" | "progress" | "elapsed" | "error" | "controls" | "status" | "uploadProgressContainer" | "uploadProgress" | "uploadProgressLabel" | "uploadProgressIndicator" | "action" | "meta";
 export interface ProctoringMediaTheme {
     colors?: {
         brand?: string;

package/dist/media-controls/ui-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ui-config.d.ts","sourceRoot":"","sources":["../../src/media-controls/ui-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,cAAc,EAEnB,KAAK,gBAAgB,EACrB,KAAK,MAAM,EACZ,MAAM,KAAK,CAAC;AAGb,MAAM,MAAM,kBAAkB,GAC1B,aAAa,GACb,aAAa,GACb,eAAe,GACf,eAAe,CAAC;AAEpB,MAAM,MAAM,eAAe,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;AACtD,MAAM,MAAM,gBAAgB,CAAC,KAAK,SAAS,MAAM,IAAI,OAAO,CAC1D,MAAM,CAAC,KAAK,EAAE,eAAe,CAAC,CAC/B,CAAC;AACF,MAAM,MAAM,eAAe,CAAC,KAAK,SAAS,MAAM,IAAI,OAAO,CACzD,MAAM,CAAC,KAAK,EAAE,aAAa,CAAC,CAC7B,CAAC;AAEF,MAAM,MAAM,eAAe,GACvB,MAAM,GACN,SAAS,GACT,SAAS,GACT,MAAM,GACN,OAAO,GACP,UAAU,GACV,MAAM,GACN,UAAU,GACV,UAAU,GACV,SAAS,GACT,UAAU,GACV,OAAO,GACP,UAAU,GACV,QAAQ,GACR,MAAM,CAAC;AAEX,MAAM,MAAM,eAAe,GACvB,MAAM,GACN,SAAS,GACT,UAAU,GACV,OAAO,GACP,WAAW,GACX,eAAe,GACf,UAAU,GACV,MAAM,GACN,UAAU,GACV,UAAU,GACV,SAAS,GACT,UAAU,GACV,OAAO,GACP,UAAU,GACV,QAAQ,GACR,MAAM,CAAC;AAEX,MAAM,MAAM,iBAAiB,GACzB,MAAM,GACN,UAAU,GACV,eAAe,GACf,aAAa,GACb,SAAS,GACT,SAAS,GACT,MAAM,GACN,UAAU,GACV,MAAM,GACN,UAAU,GACV,SAAS,GACT,UAAU,GACV,OAAO,GACP,UAAU,GACV,QAAQ,GACR,QAAQ,GACR,MAAM,CAAC;AAEX,MAAM,MAAM,iBAAiB,GACzB,MAAM,GACN,SAAS,GACT,UAAU,GACV,OAAO,GACP,aAAa,GACb,iBAAiB,GACjB,UAAU,GACV,MAAM,GACN,UAAU,GACV,SAAS,GACT,OAAO,GACP,UAAU,GACV,QAAQ,GACR,QAAQ,GACR,MAAM,CAAC;AAEX,MAAM,WAAW,oBAAoB;IACnC,MAAM,CAAC,EAAE;QACP,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,KAAK,CAAC,EAAE;QACN,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;IACF,KAAK,CAAC,EAAE;QACN,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IACF;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC,KAAK,MAAM,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;CACvD;AAED,MAAM,WAAW,gBAAgB,CAAC,KAAK,SAAS,MAAM;IACpD,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,mEAAmE;IACnE,UAAU,CAAC,EAAE,gBAAgB,CAAC,KAAK,CAAC,CAAC;IACrC,uDAAuD;IACvD,MAAM,CAAC,EAAE,eAAe,CAAC,KAAK,CAAC,CAAC;IAChC,uCAAuC;IACvC,KAAK,CAAC,EAAE,oBAAoB,CAAC;CAC9B;AAED,MAAM,WAAW,uBAAuB;IACtC,KAAK,CAAC,EAAE,oBAAoB,CAAC;IAC7B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE;QACX,WAAW,CAAC,EAAE,gBAAgB,CAAC,eAAe,CAAC,CAAC;QAChD,WAAW,CAAC,EAAE,gBAAgB,CAAC,eAAe,CAAC,CAAC;QAChD,aAAa,CAAC,EAAE,gBAAgB,CAAC,iBAAiB,CAAC,CAAC;QACpD,aAAa,CAAC,EAAE,gBAAgB,CAAC,iBAAiB,CAAC,CAAC;KACrD,CAAC;CACH;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,EAAE,uBAAuB,CAAC;CACjC;AAED,MAAM,MAAM,aAAa,GAAG,gBAAgB,CAAC,eAAe,CAAC,CAAC;AAC9D,MAAM,MAAM,aAAa,GAAG,gBAAgB,CAAC,eAAe,CAAC,CAAC;AAC9D,MAAM,MAAM,eAAe,GAAG,gBAAgB,CAAC,iBAAiB,CAAC,CAAC;AAClE,MAAM,MAAM,eAAe,GAAG,gBAAgB,CAAC,iBAAiB,CAAC,CAAC;AAclE;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,GAAE,kBAAuB,GAAG,MAAM,CAS1E;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,gBAAgB,CAAC,uBAAuB,GAAG,SAAS,CAAC,GAC5D,WAAW,CAAC,uBAAuB,CAAC,CAUtC;AAED,MAAM,WAAW,wBAAwB,CAAC,KAAK,SAAS,MAAM;IAC5D,QAAQ,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;IAC/B,UAAU,EAAE,WAAW,CAAC,aAAa,CAAC,CAAC;IACvC,SAAS,EAAE,CACT,IAAI,EAAE,KAAK,EACX,YAAY,CAAC,EAAE,eAAe,EAC9B,UAAU,CAAC,EAAE,eAAe,KACzB,eAAe,CAAC;IACrB,SAAS,EAAE,CACT,IAAI,EAAE,KAAK,EACX,YAAY,CAAC,EAAE,aAAa,KACzB,aAAa,GAAG,SAAS,CAAC;CAChC;AAED,wBAAgB,mBAAmB,CAAC,KAAK,SAAS,MAAM,EACtD,SAAS,EAAE,kBAAkB,EAC7B,KAAK,EAAE,MAAM,gBAAgB,CAAC,KAAK,CAAC,GAAG,SAAS,GAC/C,wBAAwB,CAAC,KAAK,CAAC,CA6CjC;AAED,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,uBAAuB,EAC7B,QAAQ,EAAE,uBAAuB,GAChC,uBAAuB,CAwBzB;AAED,wBAAgB,qBAAqB,CAAC,KAAK,SAAS,MAAM,EACxD,GAAG,MAAM,EAAE,KAAK,CAAC,gBAAgB,CAAC,KAAK,CAAC,GAAG,SAAS,CAAC,GACpD,gBAAgB,CAAC,KAAK,CAAC,CAUzB"}
+{"version":3,"file":"ui-config.d.ts","sourceRoot":"","sources":["../../src/media-controls/ui-config.ts"],"names":[],"mappings":"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"}

package/dist/media-controls/useLiveInputCheck.d.ts

@@ -0,0 +1,18 @@
+import { type Ref } from "vue";
+/**
+ * Live version of the SDK's passive input-liveness rule, for a take that is
+ * recording. `noInput` turns true while the input has stayed digitally silent
+ * (or muted) long enough to be worth a hint, and false again as soon as any
+ * input arrives. It reads the stream the recorder already holds; it never
+ * opens a microphone of its own.
+ *
+ * It is a hint signal only. The rule cannot tell a dead microphone from a
+ * noise-gated one, so nothing may block on it.
+ */
+export declare function useLiveInputCheck(options: {
+    stream: Ref<MediaStream | undefined>;
+    active: Ref<boolean>;
+}): {
+    noInput: Ref<boolean, boolean>;
+};
+//# sourceMappingURL=useLiveInputCheck.d.ts.map

package/dist/media-controls/useLiveInputCheck.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useLiveInputCheck.d.ts","sourceRoot":"","sources":["../../src/media-controls/useLiveInputCheck.ts"],"names":[],"mappings":"AACA,OAAO,EAA+B,KAAK,GAAG,EAAE,MAAM,KAAK,CAAC;AAM5D;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE;IACzC,MAAM,EAAE,GAAG,CAAC,WAAW,GAAG,SAAS,CAAC,CAAC;IACrC,MAAM,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;CACtB;;EAwEA"}