@voltkit-rtc/client 0.5.0 → 0.6.0

package/dist/esm/recording.js

@@ -0,0 +1,471 @@
+export class RecordingError extends Error {
+    status;
+    constructor(message, status = 0) {
+        super(message);
+        this.status = status;
+        this.name = "RecordingError";
+    }
+}
+const delay = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+export async function recordingRequest(base, path, body, token) {
+    const response = await fetch(`${base.replace(/\/$/, "")}/recording/upload${path}`, {
+        method: "POST",
+        credentials: "omit",
+        headers: {
+            "Content-Type": "application/json",
+            ...(token ? { Authorization: `Bearer ${token}` } : {}),
+        },
+        body: JSON.stringify(body),
+        signal: AbortSignal.timeout(path.endsWith("/complete") ? 180000 : 15000),
+    });
+    const result = (await response.json());
+    if (!response.ok || !result.success || !result.data)
+        throw new RecordingError(result.error?.message ?? "Recording request failed", response.status);
+    return result.data;
+}
+/** Bounded uploader, also usable with an externally encoded native/file source. */
+export class RecordingUploader {
+    session;
+    options;
+    queue = [];
+    pendingBytes = 0;
+    bytes = 0;
+    uploaded = 0;
+    number = 0;
+    active = new Set();
+    reserve = Promise.resolve();
+    failure = null;
+    finishing = false;
+    sealed = false;
+    canceled = false;
+    aborter = new AbortController();
+    constructor(session, options) {
+        this.session = session;
+        this.options = options;
+    }
+    static async create(options, roomToken, mimeType) {
+        const url = new URL(options.apiUrl);
+        if (url.protocol !== "https:" &&
+            !["localhost", "127.0.0.1", "[::1]"].includes(url.hostname))
+            throw new RecordingError("Recording API must use HTTPS");
+        const requestId = crypto.randomUUID();
+        let session;
+        for (let attempt = 0; attempt < 3; attempt++) {
+            try {
+                session = await recordingRequest(options.apiUrl, "/sessions", {
+                    roomToken,
+                    requestId,
+                    mimeType,
+                    ...(options.chunkMiB ? { chunkMiB: options.chunkMiB } : {}),
+                });
+                break;
+            }
+            catch (error) {
+                if (attempt === 2 ||
+                    (error instanceof RecordingError &&
+                        ![409, 429, 503].includes(error.status)))
+                    throw error;
+                await delay(500 * (attempt + 1));
+            }
+        }
+        if (!session ||
+            ![5 * 1048576, 10 * 1048576].includes(session.chunkBytes) ||
+            session.maxBufferBytes < session.chunkBytes * 2 ||
+            session.maxBufferBytes > 100 * 1048576 ||
+            session.uploadConcurrency < 1 ||
+            session.uploadConcurrency > 4)
+            throw new RecordingError("Invalid recording upload policy");
+        return new RecordingUploader(session, options);
+    }
+    get bufferedBytes() {
+        return this.bytes;
+    }
+    get uploadedBytes() {
+        return this.uploaded;
+    }
+    get hasCapacity() {
+        return (!this.failure &&
+            !this.canceled &&
+            this.bytes < this.session.maxBufferBytes - this.session.chunkBytes);
+    }
+    emit(state, error) {
+        try {
+            this.options.onState?.({
+                state,
+                bufferedBytes: this.bytes,
+                uploadedBytes: this.uploaded,
+                recordingId: this.session.recording.id,
+                ...(error ? { error } : {}),
+            });
+        }
+        catch {
+            /* UI callbacks never break accounting/cleanup. */
+        }
+    }
+    append(blob) {
+        if (this.finishing || this.canceled)
+            throw new RecordingError("Recording upload has ended");
+        if (this.failure)
+            throw this.failure;
+        if (!blob.size)
+            return;
+        if (blob.size > this.session.maxBufferBytes - this.bytes)
+            throw new RecordingError("Recording buffer limit reached; stop recording without stopping the live stream");
+        this.queue.push(blob);
+        this.pendingBytes += blob.size;
+        this.bytes += blob.size;
+        this.pump();
+        this.emit(this.hasCapacity ? "recording" : "backpressure");
+    }
+    take(size) {
+        const blobs = [];
+        let remaining = size;
+        while (remaining > 0) {
+            const blob = this.queue.shift();
+            const length = Math.min(remaining, blob.size);
+            blobs.push(blob.slice(0, length));
+            if (length < blob.size)
+                this.queue.unshift(blob.slice(length));
+            remaining -= length;
+        }
+        this.pendingBytes -= size;
+        return new Blob(blobs);
+    }
+    pump() {
+        while (!this.failure &&
+            !this.canceled &&
+            this.active.size < this.session.uploadConcurrency &&
+            this.pendingBytes >= this.session.chunkBytes)
+            this.upload(this.take(this.session.chunkBytes), false);
+    }
+    upload(blob, final) {
+        const number = ++this.number;
+        // Reserve in sequence, while PUT bodies upload concurrently.
+        const signed = this.reserve.then(() => recordingRequest(this.options.apiUrl, `/sessions/${this.session.recording.id}/parts`, { number, bytes: blob.size, final }, this.session.token));
+        this.reserve = signed;
+        let task;
+        task = (async () => {
+            let url = (await signed).url;
+            for (let attempt = 0; attempt < 4; attempt++) {
+                if (this.canceled)
+                    throw new RecordingError("Recording canceled");
+                try {
+                    const response = await fetch(url, {
+                        method: "PUT",
+                        body: blob,
+                        credentials: "omit",
+                        signal: AbortSignal.any([
+                            this.aborter.signal,
+                            AbortSignal.timeout(45000),
+                        ]),
+                    });
+                    if (!response.ok)
+                        throw new RecordingError("R2 upload failed", response.status);
+                    this.bytes -= blob.size;
+                    this.uploaded += blob.size;
+                    return;
+                }
+                catch (error) {
+                    if (this.canceled || attempt === 3)
+                        throw error;
+                    await delay(500 * 2 ** attempt);
+                    url = (await recordingRequest(this.options.apiUrl, `/sessions/${this.session.recording.id}/parts`, { number, bytes: blob.size, final }, this.session.token)).url;
+                }
+            }
+        })()
+            .catch((error) => {
+            this.failure =
+                error instanceof Error
+                    ? error
+                    : new RecordingError("Recording upload failed");
+            this.emit("error", this.failure);
+        })
+            .finally(() => {
+            this.active.delete(task);
+            this.pump();
+            this.emit(this.failure
+                ? "error"
+                : this.hasCapacity
+                    ? "recording"
+                    : "backpressure");
+        });
+        this.active.add(task);
+    }
+    async waitForCapacity() {
+        while (!this.hasCapacity) {
+            if (this.failure)
+                throw this.failure;
+            if (this.canceled)
+                throw new RecordingError("Recording canceled");
+            await Promise.race(this.active);
+        }
+    }
+    async seal() {
+        if (this.sealed)
+            return;
+        this.finishing = true;
+        this.emit("uploading");
+        while (this.active.size) {
+            await Promise.all(this.active);
+            if (this.failure)
+                throw this.failure;
+        }
+        if (this.pendingBytes) {
+            this.upload(this.take(this.pendingBytes), true);
+            await Promise.all(this.active);
+        }
+        if (this.failure)
+            throw this.failure;
+        if (!this.number) {
+            await this.abort();
+            throw new RecordingError("No video was recorded");
+        }
+        this.sealed = true;
+    }
+    async complete() {
+        await this.seal();
+        const file = await recordingRequest(this.options.apiUrl, `/sessions/${this.session.recording.id}/complete`, {}, this.session.token);
+        this.emit("ready");
+        return file;
+    }
+    async abort() {
+        this.canceled = true;
+        this.aborter.abort();
+        await Promise.all(this.active);
+        this.queue = [];
+        this.bytes = 0;
+        this.pendingBytes = 0;
+        await recordingRequest(this.options.apiUrl, `/sessions/${this.session.recording.id}/abort`, {}, this.session.token);
+        this.emit("stopped");
+    }
+}
+/** Encodes a downscaled COPY of local camera/mic. Never changes RTC tracks. */
+export class CameraRecording {
+    getStream;
+    getRoomToken;
+    options;
+    stopped = false;
+    stopSegment = null;
+    done = null;
+    files = new Map();
+    finalizers = new Set();
+    finalFailure = null;
+    segmentNumber = 0;
+    constructor(getStream, getRoomToken, options) {
+        this.getStream = getStream;
+        this.getRoomToken = getRoomToken;
+        this.options = options;
+    }
+    start() {
+        const stream = this.getStream();
+        if (!stream
+            ?.getVideoTracks()
+            .some((track) => track.readyState === "live" && track.enabled))
+            throw new RecordingError("Publish an enabled camera before recording");
+        if (this.done)
+            throw new RecordingError("Recording is already started");
+        let ready, reject;
+        const started = new Promise((yes, no) => {
+            ready = yes;
+            reject = no;
+        });
+        this.done = this.run(ready)
+            .then((files) => {
+            ready();
+            return files;
+        })
+            .catch((error) => {
+            reject(error);
+            this.stopped = true;
+            try {
+                this.options.onState?.({
+                    state: "error",
+                    bufferedBytes: 0,
+                    uploadedBytes: 0,
+                    error: error instanceof Error
+                        ? error
+                        : new RecordingError("Recording failed"),
+                });
+            }
+            catch { }
+            throw error;
+        });
+        void this.done.catch(() => undefined);
+        return started;
+    }
+    async stop() {
+        this.stopped = true;
+        this.stopSegment?.();
+        return this.done ?? [];
+    }
+    async run(ready) {
+        while (!this.stopped) {
+            const stream = this.getStream(), camera = stream?.getVideoTracks()[0];
+            if (!stream || !camera || camera.readyState !== "live" || !camera.enabled)
+                break;
+            const mimeType = ["video/webm;codecs=vp8,opus", "video/mp4"].find((type) => MediaRecorder.isTypeSupported(type));
+            if (!mimeType)
+                throw new RecordingError("This browser cannot encode supported recording video");
+            const uploader = await RecordingUploader.create(this.options, this.getRoomToken(), mimeType);
+            let video = null, encoded = null, timer, segmentTimer;
+            try {
+                if (this.stopped) {
+                    await uploader.abort();
+                    break;
+                }
+                const policy = uploader.session.recording;
+                video = document.createElement("video");
+                video.srcObject = stream;
+                video.muted = true;
+                video.playsInline = true;
+                await video.play();
+                if (this.stopped) {
+                    await uploader.abort();
+                    break;
+                }
+                const portrait = (video.videoHeight || camera.getSettings().height || policy.height) >
+                    (video.videoWidth || camera.getSettings().width || policy.width);
+                const canvas = document.createElement("canvas");
+                canvas.width = portrait ? policy.height : policy.width;
+                canvas.height = portrait ? policy.width : policy.height;
+                const context = canvas.getContext("2d");
+                if (!context)
+                    throw new RecordingError("Recording canvas unavailable");
+                encoded = canvas.captureStream(policy.frameRate);
+                for (const track of stream.getAudioTracks())
+                    encoded.addTrack(track.clone());
+                const recorder = new MediaRecorder(encoded, {
+                    mimeType,
+                    videoBitsPerSecond: policy.videoBitrate,
+                    audioBitsPerSecond: policy.audioBitrate,
+                });
+                let failure = null;
+                const finished = new Promise((resolve, reject) => {
+                    recorder.onstop = () => (failure ? reject(failure) : resolve());
+                    recorder.onerror = () => {
+                        failure = new RecordingError("Recording encoder failed");
+                        if (recorder.state !== "inactive")
+                            recorder.stop();
+                        else
+                            reject(failure);
+                    };
+                });
+                const stop = () => {
+                    if (recorder.state !== "inactive")
+                        recorder.stop();
+                };
+                this.stopSegment = stop;
+                recorder.ondataavailable = (event) => {
+                    try {
+                        uploader.append(event.data);
+                        if (!uploader.hasCapacity && recorder.state === "recording") {
+                            recorder.pause();
+                            void uploader
+                                .waitForCapacity()
+                                .then(() => {
+                                if (!this.stopped && recorder.state === "paused")
+                                    recorder.resume();
+                            })
+                                .catch((error) => {
+                                failure = error;
+                                stop();
+                            });
+                        }
+                    }
+                    catch (error) {
+                        failure =
+                            error instanceof Error
+                                ? error
+                                : new RecordingError("Recording buffer failed");
+                        stop();
+                    }
+                };
+                const draw = () => {
+                    const current = this.getStream();
+                    const track = current?.getVideoTracks()[0];
+                    if (!track || track.readyState !== "live" || !track.enabled) {
+                        this.stopped = true;
+                        stop();
+                        return;
+                    }
+                    // A camera flip gets a separate file; WebRTC is untouched.
+                    if (current !== stream) {
+                        stop();
+                        return;
+                    }
+                    encoded.getAudioTracks().forEach((audio, index) => {
+                        audio.enabled = stream.getAudioTracks()[index]?.enabled ?? false;
+                    });
+                    context.fillStyle = "#000";
+                    context.fillRect(0, 0, canvas.width, canvas.height);
+                    if (video.readyState >= 2) {
+                        const scale = Math.min(canvas.width / video.videoWidth, canvas.height / video.videoHeight), w = video.videoWidth * scale, h = video.videoHeight * scale;
+                        context.drawImage(video, (canvas.width - w) / 2, (canvas.height - h) / 2, w, h);
+                    }
+                };
+                recorder.start(1000);
+                draw();
+                ready();
+                timer = setInterval(draw, 1000 / policy.frameRate);
+                segmentTimer = setTimeout(stop, uploader.session.segmentSeconds * 1000);
+                await finished;
+                if (timer)
+                    clearInterval(timer);
+                if (segmentTimer)
+                    clearTimeout(segmentTimer);
+                encoded.getTracks().forEach((track) => track.stop());
+                video.pause();
+                video.srcObject = null;
+                await uploader.seal();
+                const index = this.segmentNumber++;
+                let finalize;
+                finalize = uploader
+                    .complete()
+                    .then((file) => {
+                    this.files.set(index, file);
+                    try {
+                        this.options.onRecordingReady?.(file);
+                    }
+                    catch { }
+                })
+                    .catch((error) => {
+                    this.finalFailure =
+                        error instanceof Error
+                            ? error
+                            : new RecordingError("Recording validation failed");
+                    this.stopped = true;
+                    this.stopSegment?.();
+                })
+                    .finally(() => this.finalizers.delete(finalize));
+                this.finalizers.add(finalize);
+                // Uploaded files hold no pending media buffers; validate in the
+                // background while the next segment records. Bound pending jobs too.
+                if (this.finalizers.size >= 2)
+                    await Promise.race(this.finalizers);
+            }
+            catch (error) {
+                await uploader.abort().catch(() => undefined);
+                throw error;
+            }
+            finally {
+                if (timer)
+                    clearInterval(timer);
+                if (segmentTimer)
+                    clearTimeout(segmentTimer);
+                this.stopSegment = null;
+                encoded?.getTracks().forEach((track) => track.stop());
+                if (video) {
+                    video.pause();
+                    video.srcObject = null;
+                }
+            }
+        }
+        await Promise.all(this.finalizers);
+        if (this.finalFailure)
+            throw this.finalFailure;
+        return [...this.files.entries()]
+            .sort((a, b) => a[0] - b[0])
+            .map(([, file]) => file);
+    }
+}
+//# sourceMappingURL=recording.js.map

package/dist/esm/recording.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voltkit-rtc/client",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "Browser SDK for VoltKit RTC: realtime audio/video rooms, chat and live broadcast publishing.",
   "keywords": [
     "voltkit",

package/src/index.ts

@@ -1,3 +1,4 @@
+import { CameraRecording, type RecordingOptions, type RecordingFile } from './recording.js';
 /**
  * Thin client SDK over the orchestrator's signaling protocol.
  *
@@ -58,6 +59,8 @@ import {
   type VideoSendStats,
 } from './stats.js';
 
+export { CameraRecording, RecordingUploader, RecordingError } from './recording.js';
+export type { RecordingOptions, RecordingEvent, RecordingState, RecordingSession, RecordingFile } from './recording.js';
 export { BroadcastPublisher, WhipError, whipEnd, whipOffer } from './broadcast.js';
 export { AudioMixer, MusicSource } from './music.js';
 export type { MusicInput, MusicOptions, TrackSource } from './music.js';
@@ -324,6 +327,7 @@ export class StreamClient {
   private token: string;
   private joinResult: JoinResult | null = null;
   private localStream: MediaStream | null = null;
+  private recording: CameraRecording | null = null;
   // A reconnect tears down every transport and producer. Without remembering
   // that this client was publishing -- and what it was publishing with -- a
   // broadcaster that reconnects rejoins silently, which is worse than being
@@ -599,6 +603,7 @@ export class StreamClient {
   }
 
   close(): void {
+    void this.stopRecording().catch(() => undefined);
     // Only an app closing a live session is 'left'; kicked, room-closed and the
     // others have already reported themselves and set closedByUs.
     const wasOpen = !this.closedByUs;
@@ -1745,6 +1750,7 @@ export class StreamClient {
 
   /** Stop publishing entirely and release the local devices. */
   async unpublish(): Promise<void> {
+    void this.stopRecording().catch(error => this.emit('error', error as Error));
     // All of it takes effect now; only telling the server is waited for. So
     // publish() and unpublish() act in the order they are called: a publish
     // called while this still waits is not undone by it, and one already
@@ -1777,6 +1783,19 @@ export class StreamClient {
     }
   }
 
+  /** Paid camera recording; project opt-in, quotas and quality are checked by the backend. */
+  async startRecording(options: RecordingOptions): Promise<void> {
+    if (this.recording) throw new Error('Recording is already active');
+    if (!this.localStream || !this.joinResult || !['host', 'cohost'].includes(this.joinResult.role)) throw new Error('Publish your camera before recording');
+    const recording = new CameraRecording(() => this.camEnabled ? this.localStream : null, () => this.token, options);
+    this.recording = recording;
+    try { await recording.start(); } catch (error) { if (this.recording === recording) this.recording = null; throw error; }
+  }
+  async stopRecording(): Promise<RecordingFile[]> {
+    const recording = this.recording; this.recording = null;
+    return recording ? recording.stop() : [];
+  }
+
   get local(): MediaStream | null {
     return this.localStream;
   }