{"version":3,"file":"media-recorder.cjs","names":[],"sources":["../../src/capture/media-recorder.ts"],"sourcesContent":["/**\n * @tempest-limits function-lines — the engine behind both the audio and the video\n * recorder: MIME negotiation, the state machine MediaRecorder does not give you, and\n * the clock kept by hand because a fresh WebM reports no duration. The clock has to\n * pause and resume with the state machine, so they are one closure.\n */\n/** Lifecycle of a recording. */\nexport type MediaRecorderStatus = \"idle\" | \"recording\" | \"paused\" | \"stopped\";\n\n/** What a track carries — used only to word the errors this engine throws. */\nexport type MediaRecordingKind = \"audio\" | \"video\";\n\n/** A finished recording, whatever it was made of. */\nexport interface MediaRecording {\n /** The bytes. Wrap with `useObjectUrl` to play it, or POST it as-is. */\n blob: Blob;\n /** What the browser actually produced — not necessarily what you asked for. */\n mimeType: string;\n /** Recorded length, excluding time spent paused. */\n durationMs: number;\n}\n\n/** Options for {@link createMediaRecorder}. */\nexport interface MediaRecordingOptions {\n /**\n * Container candidates, best first. Required: this engine has no opinion about\n * codecs — the audio and video wrappers own that list.\n */\n candidates: readonly string[];\n /** Wording for the thrown messages (\"cannot record any supported *video* container\"). */\n kind: MediaRecordingKind;\n /** Force a container, bypassing the negotiation. Throws when unsupported. */\n mimeType?: string;\n /** Target audio bitrate. */\n audioBitsPerSecond?: number;\n /** Target video bitrate. Ignored by the browser on an audio-only stream. */\n videoBitsPerSecond?: number;\n /**\n * Emit a chunk every N ms through `onChunk`, for streaming upload.\n *\n * Without it the whole recording is buffered in memory until `stop()`.\n */\n timesliceMs?: number;\n /** Receives each chunk when `timesliceMs` is set. Chunks are **not** independently playable. */\n onChunk?: (chunk: Blob) => void;\n /** Recorder-level failure (device unplugged mid-recording, encoder error). */\n onError?: (error: unknown) => void;\n}\n\n/** Imperative recorder over one `MediaStream`. */\nexport interface MediaRecorderHandle {\n /** Begin recording. No-op when already recording or paused. */\n start: () => void;\n /** Pause. The clock stops; `durationMs` freezes. */\n pause: () => void;\n /** Resume after `pause()`. */\n resume: () => void;\n /** Stop and resolve with the assembled recording. */\n stop: () => Promise;\n /** Stop and throw the bytes away. */\n cancel: () => void;\n status: () => MediaRecorderStatus;\n /** Recorded length so far, excluding paused time. */\n durationMs: () => number;\n /** The negotiated container. */\n mimeType: string;\n}\n\n/**\n * First container in `preferred` the browser can actually produce, or `null`.\n *\n * @param preferred - Candidates, best first.\n * @returns A supported MIME type, or `null` when none is.\n */\nexport function pickRecordingMimeType(preferred: readonly string[]): string | null {\n if (typeof MediaRecorder === \"undefined\") return null;\n // Older WebViews ship `MediaRecorder` without the static probe. Assume the first\n // candidate rather than refusing outright — the constructor will tell us.\n if (typeof MediaRecorder.isTypeSupported !== \"function\") return preferred[0] ?? null;\n return preferred.find((type) => MediaRecorder.isTypeSupported(type)) ?? null;\n}\n\n/**\n * Wrap a `MediaStream` in a recorder with a real state machine and an honest clock.\n *\n * This is the engine behind both `createAudioRecorder` and `createVideoRecorder`; the\n * only thing it does not decide is which containers to try, because that is the one\n * part that genuinely differs between the two.\n *\n * Two things `MediaRecorder` does not give you:\n *\n * - **A duration.** It reports none, and the `Blob` has no reliable one either —\n * WebM written by `MediaRecorder` carries no duration in its header, which is why\n * `