@livekit/rtc-node 0.13.32 → 0.13.34

package/dist/utils.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/utils.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2024 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\n\n/** convert bigints to numbers preserving undefined values */\nexport function bigIntToNumber<T extends bigint | undefined>(\n  value: T,\n): T extends bigint ? number : undefined {\n  return (value !== undefined ? Number(value) : undefined) as T extends bigint ? number : undefined;\n}\n\n/** convert numbers to bigints preserving undefined values */\nexport function numberToBigInt<T extends number | undefined>(\n  value: T,\n): T extends number ? bigint : undefined {\n  return (value !== undefined ? BigInt(value) : undefined) as T extends number ? bigint : undefined;\n}\n\nexport function splitUtf8(s: string, n: number): Uint8Array[] {\n  if (n < 4) {\n    throw new Error('n must be at least 4 due to utf8 encoding rules');\n  }\n  // adapted from https://stackoverflow.com/a/6043797\n  const result: Uint8Array[] = [];\n  let encoded = new TextEncoder().encode(s);\n  while (encoded.length > n) {\n    let k = n;\n    while (k > 0) {\n      const byte = encoded[k];\n      if (byte !== undefined && (byte & 0xc0) !== 0x80) {\n        break;\n      }\n      k--;\n    }\n    result.push(encoded.slice(0, k));\n    encoded = encoded.slice(k);\n  }\n  if (encoded.length > 0) {\n    result.push(encoded);\n  }\n  return result;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAKO,SAAS,eACd,OACuC;AACvC,SAAQ,UAAU,SAAY,OAAO,KAAK,IAAI;AAChD;AAGO,SAAS,eACd,OACuC;AACvC,SAAQ,UAAU,SAAY,OAAO,KAAK,IAAI;AAChD;AAEO,SAAS,UAAU,GAAW,GAAyB;AAC5D,MAAI,IAAI,GAAG;AACT,UAAM,IAAI,MAAM,iDAAiD;AAAA,EACnE;AAEA,QAAM,SAAuB,CAAC;AAC9B,MAAI,UAAU,IAAI,YAAY,EAAE,OAAO,CAAC;AACxC,SAAO,QAAQ,SAAS,GAAG;AACzB,QAAI,IAAI;AACR,WAAO,IAAI,GAAG;AACZ,YAAM,OAAO,QAAQ,CAAC;AACtB,UAAI,SAAS,WAAc,OAAO,SAAU,KAAM;AAChD;AAAA,MACF;AACA;AAAA,IACF;AACA,WAAO,KAAK,QAAQ,MAAM,GAAG,CAAC,CAAC;AAC/B,cAAU,QAAQ,MAAM,CAAC;AAAA,EAC3B;AACA,MAAI,QAAQ,SAAS,GAAG;AACtB,WAAO,KAAK,OAAO;AAAA,EACrB;AACA,SAAO;AACT;","names":[]}
+{"version":3,"sources":["../src/utils.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2024 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nimport type {\n  ByteStreamInfo as ProtoByteStreamInfo,\n  TextStreamInfo as ProtoTextStreamInfo,\n} from '@livekit/rtc-ffi-bindings';\nimport type { ByteStreamInfo, TextStreamInfo } from './data_streams/types.js';\n\n/** convert bigints to numbers preserving undefined values */\nexport function bigIntToNumber<T extends bigint | undefined>(\n  value: T,\n): T extends bigint ? number : undefined {\n  return (value !== undefined ? Number(value) : undefined) as T extends bigint ? number : undefined;\n}\n\n/** convert numbers to bigints preserving undefined values */\nexport function numberToBigInt<T extends number | undefined>(\n  value: T,\n): T extends number ? bigint : undefined {\n  return (value !== undefined ? BigInt(value) : undefined) as T extends number ? bigint : undefined;\n}\n\nexport function splitUtf8(s: string, n: number): Uint8Array[] {\n  if (n < 4) {\n    throw new Error('n must be at least 4 due to utf8 encoding rules');\n  }\n  // adapted from https://stackoverflow.com/a/6043797\n  const result: Uint8Array[] = [];\n  let encoded = new TextEncoder().encode(s);\n  while (encoded.length > n) {\n    let k = n;\n    while (k > 0) {\n      const byte = encoded[k];\n      if (byte !== undefined && (byte & 0xc0) !== 0x80) {\n        break;\n      }\n      k--;\n    }\n    result.push(encoded.slice(0, k));\n    encoded = encoded.slice(k);\n  }\n  if (encoded.length > 0) {\n    result.push(encoded);\n  }\n  return result;\n}\n\n/** @internal */\nexport function textStreamInfoFromProto(info: ProtoTextStreamInfo): TextStreamInfo {\n  return {\n    streamId: info.streamId!,\n    mimeType: info.mimeType!,\n    topic: info.topic!,\n    timestamp: bigIntToNumber(info.timestamp!),\n    totalSize: info.totalLength ? bigIntToNumber(info.totalLength) : undefined,\n    attributes: info.attributes,\n  };\n}\n\n/** @internal */\nexport function byteStreamInfoFromProto(info: ProtoByteStreamInfo): ByteStreamInfo {\n  return {\n    streamId: info.streamId!,\n    name: info.name ?? 'unknown',\n    mimeType: info.mimeType!,\n    topic: info.topic!,\n    timestamp: bigIntToNumber(info.timestamp!),\n    totalSize: info.totalLength !== undefined ? bigIntToNumber(info.totalLength) : undefined,\n    attributes: info.attributes,\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAUO,SAAS,eACd,OACuC;AACvC,SAAQ,UAAU,SAAY,OAAO,KAAK,IAAI;AAChD;AAGO,SAAS,eACd,OACuC;AACvC,SAAQ,UAAU,SAAY,OAAO,KAAK,IAAI;AAChD;AAEO,SAAS,UAAU,GAAW,GAAyB;AAC5D,MAAI,IAAI,GAAG;AACT,UAAM,IAAI,MAAM,iDAAiD;AAAA,EACnE;AAEA,QAAM,SAAuB,CAAC;AAC9B,MAAI,UAAU,IAAI,YAAY,EAAE,OAAO,CAAC;AACxC,SAAO,QAAQ,SAAS,GAAG;AACzB,QAAI,IAAI;AACR,WAAO,IAAI,GAAG;AACZ,YAAM,OAAO,QAAQ,CAAC;AACtB,UAAI,SAAS,WAAc,OAAO,SAAU,KAAM;AAChD;AAAA,MACF;AACA;AAAA,IACF;AACA,WAAO,KAAK,QAAQ,MAAM,GAAG,CAAC,CAAC;AAC/B,cAAU,QAAQ,MAAM,CAAC;AAAA,EAC3B;AACA,MAAI,QAAQ,SAAS,GAAG;AACtB,WAAO,KAAK,OAAO;AAAA,EACrB;AACA,SAAO;AACT;AAGO,SAAS,wBAAwB,MAA2C;AACjF,SAAO;AAAA,IACL,UAAU,KAAK;AAAA,IACf,UAAU,KAAK;AAAA,IACf,OAAO,KAAK;AAAA,IACZ,WAAW,eAAe,KAAK,SAAU;AAAA,IACzC,WAAW,KAAK,cAAc,eAAe,KAAK,WAAW,IAAI;AAAA,IACjE,YAAY,KAAK;AAAA,EACnB;AACF;AAGO,SAAS,wBAAwB,MAA2C;AACjF,SAAO;AAAA,IACL,UAAU,KAAK;AAAA,IACf,MAAM,KAAK,QAAQ;AAAA,IACnB,UAAU,KAAK;AAAA,IACf,OAAO,KAAK;AAAA,IACZ,WAAW,eAAe,KAAK,SAAU;AAAA,IACzC,WAAW,KAAK,gBAAgB,SAAY,eAAe,KAAK,WAAW,IAAI;AAAA,IAC/E,YAAY,KAAK;AAAA,EACnB;AACF;","names":[]}

package/dist/utils.d.cts

@@ -1,7 +1,14 @@
+import { ByteStreamInfo, TextStreamInfo } from '@livekit/rtc-ffi-bindings';
+import { b as ByteStreamInfo$1, e as TextStreamInfo$1 } from './types-f7wTlFjs.cjs';
+
 /** convert bigints to numbers preserving undefined values */
 declare function bigIntToNumber<T extends bigint | undefined>(value: T): T extends bigint ? number : undefined;
 /** convert numbers to bigints preserving undefined values */
 declare function numberToBigInt<T extends number | undefined>(value: T): T extends number ? bigint : undefined;
 declare function splitUtf8(s: string, n: number): Uint8Array[];
+/** @internal */
+declare function textStreamInfoFromProto(info: TextStreamInfo): TextStreamInfo$1;
+/** @internal */
+declare function byteStreamInfoFromProto(info: ByteStreamInfo): ByteStreamInfo$1;
 
-export { bigIntToNumber, numberToBigInt, splitUtf8 };
+export { bigIntToNumber, byteStreamInfoFromProto, numberToBigInt, splitUtf8, textStreamInfoFromProto };

package/dist/utils.d.ts

@@ -1,7 +1,12 @@
+import type { ByteStreamInfo as ProtoByteStreamInfo, TextStreamInfo as ProtoTextStreamInfo } from '@livekit/rtc-ffi-bindings';
+import type { ByteStreamInfo, TextStreamInfo } from './data_streams/types.js';
 /** convert bigints to numbers preserving undefined values */
-declare function bigIntToNumber<T extends bigint | undefined>(value: T): T extends bigint ? number : undefined;
+export declare function bigIntToNumber<T extends bigint | undefined>(value: T): T extends bigint ? number : undefined;
 /** convert numbers to bigints preserving undefined values */
-declare function numberToBigInt<T extends number | undefined>(value: T): T extends number ? bigint : undefined;
-declare function splitUtf8(s: string, n: number): Uint8Array[];
-
-export { bigIntToNumber, numberToBigInt, splitUtf8 };
+export declare function numberToBigInt<T extends number | undefined>(value: T): T extends number ? bigint : undefined;
+export declare function splitUtf8(s: string, n: number): Uint8Array[];
+/** @internal */
+export declare function textStreamInfoFromProto(info: ProtoTextStreamInfo): TextStreamInfo;
+/** @internal */
+export declare function byteStreamInfoFromProto(info: ProtoByteStreamInfo): ByteStreamInfo;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAIA,6DAA6D;AAC7D,wBAAgB,cAAc,CAAC,CAAC,SAAS,MAAM,GAAG,SAAS,EACzD,KAAK,EAAE,CAAC,GACP,CAAC,SAAS,MAAM,GAAG,MAAM,GAAG,SAAS,CAEvC;AAED,6DAA6D;AAC7D,wBAAgB,cAAc,CAAC,CAAC,SAAS,MAAM,GAAG,SAAS,EACzD,KAAK,EAAE,CAAC,GACP,CAAC,SAAS,MAAM,GAAG,MAAM,GAAG,SAAS,CAEvC;AAED,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,UAAU,EAAE,CAuB5D"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,cAAc,IAAI,mBAAmB,EACrC,cAAc,IAAI,mBAAmB,EACtC,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAE9E,6DAA6D;AAC7D,wBAAgB,cAAc,CAAC,CAAC,SAAS,MAAM,GAAG,SAAS,EACzD,KAAK,EAAE,CAAC,GACP,CAAC,SAAS,MAAM,GAAG,MAAM,GAAG,SAAS,CAEvC;AAED,6DAA6D;AAC7D,wBAAgB,cAAc,CAAC,CAAC,SAAS,MAAM,GAAG,SAAS,EACzD,KAAK,EAAE,CAAC,GACP,CAAC,SAAS,MAAM,GAAG,MAAM,GAAG,SAAS,CAEvC;AAED,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,UAAU,EAAE,CAuB5D;AAED,gBAAgB;AAChB,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,mBAAmB,GAAG,cAAc,CASjF;AAED,gBAAgB;AAChB,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,mBAAmB,GAAG,cAAc,CAUjF"}

package/dist/version.cjs

@@ -21,7 +21,7 @@ __export(version_exports, {
   SDK_VERSION: () => SDK_VERSION
 });
 module.exports = __toCommonJS(version_exports);
-const SDK_VERSION = "0.13.32";
+const SDK_VERSION = "0.13.34";
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   SDK_VERSION

package/dist/version.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/version.ts"],"sourcesContent":["export const SDK_VERSION = \"0.13.32\";\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAO,MAAM,cAAc;","names":[]}
+{"version":3,"sources":["../src/version.ts"],"sourcesContent":["export const SDK_VERSION = \"0.13.34\";\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAO,MAAM,cAAc;","names":[]}

package/dist/version.d.cts

@@ -1,3 +1,3 @@
-declare const SDK_VERSION = "0.13.32";
+declare const SDK_VERSION = "0.13.34";
 
 export { SDK_VERSION };

package/dist/version.d.ts

@@ -1,3 +1,2 @@
-declare const SDK_VERSION = "0.13.32";
-
-export { SDK_VERSION };
+export declare const SDK_VERSION = "0.13.34";
+//# sourceMappingURL=version.d.ts.map

package/dist/video_frame.d.ts

@@ -1,6 +1,6 @@
-import { VideoBufferType, VideoBufferInfo, OwnedVideoBuffer } from '@livekit/rtc-ffi-bindings';
-
-declare class VideoFrame {
+import type { OwnedVideoBuffer } from '@livekit/rtc-ffi-bindings';
+import { VideoBufferInfo, VideoBufferType } from '@livekit/rtc-ffi-bindings';
+export declare class VideoFrame {
     data: Uint8Array;
     width: number;
     height: number;
@@ -15,5 +15,4 @@ declare class VideoFrame {
     getPlane(planeNth: number): Uint8Array | void;
     convert(dstType: VideoBufferType, flipY?: boolean): VideoFrame;
 }
-
-export { VideoFrame };
+//# sourceMappingURL=video_frame.d.ts.map

package/dist/video_source.d.ts

@@ -1,9 +1,8 @@
-import { VideoSourceInfo, FfiHandle, VideoRotation } from '@livekit/rtc-ffi-bindings';
-import './ffi_client.js';
-import { VideoFrame } from './video_frame.js';
-import '@livekit/typed-emitter';
-
-declare class VideoSource {
+import type { VideoSourceInfo } from '@livekit/rtc-ffi-bindings';
+import { VideoRotation } from '@livekit/rtc-ffi-bindings';
+import { FfiHandle } from './ffi_client.js';
+import type { VideoFrame } from './video_frame.js';
+export declare class VideoSource {
     /** @internal */
     info?: VideoSourceInfo;
     /** @internal */
@@ -16,5 +15,4 @@ declare class VideoSource {
     captureFrame(frame: VideoFrame, timestampUs?: bigint, rotation?: VideoRotation): void;
     close(): Promise<void>;
 }
-
-export { VideoSource };
+//# sourceMappingURL=video_source.d.ts.map

package/dist/video_stream.d.cts

@@ -1,5 +1,5 @@
 import { VideoRotation } from '@livekit/rtc-ffi-bindings';
-import { T as Track } from './audio_stream-4M8XlO4-.cjs';
+import { T as Track } from './audio_stream-BNVaONuH.cjs';
 import { VideoFrame } from './video_frame.cjs';
 import 'node:stream/web';
 import './audio_frame.cjs';
@@ -7,7 +7,7 @@ import './frame_processor.cjs';
 import './audio_source.cjs';
 import './ffi_client.cjs';
 import '@livekit/typed-emitter';
-import './types-_PdPVish.cjs';
+import './types-f7wTlFjs.cjs';
 import './e2ee.cjs';
 import '@livekit/mutex';
 import 'node:fs';

package/dist/video_stream.d.ts

@@ -1,29 +1,12 @@
-import { VideoRotation } from '@livekit/rtc-ffi-bindings';
-import { T as Track } from './audio_stream-CTyN1Ldy.js';
+import type { VideoRotation } from '@livekit/rtc-ffi-bindings';
+import type { Track } from './track.js';
 import { VideoFrame } from './video_frame.js';
-import 'node:stream/web';
-import './audio_frame.js';
-import './frame_processor.js';
-import './audio_source.js';
-import './ffi_client.js';
-import '@livekit/typed-emitter';
-import './types-_PdPVish.js';
-import './e2ee.js';
-import '@livekit/mutex';
-import 'node:fs';
-import './data_streams/stream_writer.js';
-import './rpc.js';
-import './transcription.js';
-import './types.js';
-import './video_source.js';
-
-type VideoFrameEvent = {
+export type VideoFrameEvent = {
     frame: VideoFrame;
     timestampUs: bigint;
     rotation: VideoRotation;
 };
-declare class VideoStream extends ReadableStream<VideoFrameEvent> {
+export declare class VideoStream extends ReadableStream<VideoFrameEvent> {
     constructor(track: Track);
 }
-
-export { type VideoFrameEvent, VideoStream };
+//# sourceMappingURL=video_stream.d.ts.map

package/package.json

@@ -3,10 +3,9 @@
   "description": "LiveKit RTC Node",
   "license": "Apache-2.0",
   "author": "LiveKit",
-  "version": "0.13.32",
-  "main": "dist/index.js",
-  "require": "dist/index.cjs",
-  "types": "dist/index.d.ts",
+  "version": "0.13.34",
+  "main": "dist/index.cjs",
+  "types": "dist/index.d.cts",
   "exports": {
     ".": {
       "import": {
@@ -32,7 +31,7 @@
   "dependencies": {
     "@datastructures-js/deque": "1.0.8",
     "@livekit/mutex": "^1.0.0",
-    "@livekit/rtc-ffi-bindings": "0.12.68",
+    "@livekit/rtc-ffi-bindings": "0.12.73",
     "@livekit/typed-emitter": "^3.0.0",
     "pino": "^9.0.0",
     "pino-pretty": "^13.0.0"
@@ -44,14 +43,14 @@
     "tsup": "^8.3.5",
     "typescript": "5.8.2",
     "vitest": "^4.0.0",
-    "livekit-server-sdk": "2.17.0"
+    "livekit-server-sdk": "2.18.0"
   },
   "engines": {
     "node": ">= 18"
   },
   "scripts": {
     "prebuild": "node -p \"'export const SDK_VERSION = ' + JSON.stringify(require('./package.json').version) + ';'\" > src/version.ts",
-    "build": "pnpm prebuild && tsup --onSuccess \"tsc --declaration --emitDeclarationOnly\"",
+    "build": "pnpm prebuild && tsup && node scripts/postbuild.mjs",
     "lint": "eslint -f unix \"src/**/*.ts\" --ignore-pattern \"src/proto/*\"",
     "test": "vitest run src",
     "test:e2e": "node scripts/run-e2e.mjs"

package/src/audio_stream_room_lifecycle.test.ts

@@ -146,12 +146,15 @@ function makeEndTrackingStream(): { stream: AudioStreamSource; endCount: () => n
 
 function makeLocalParticipant(identity: string): LocalParticipant {
   // Bypass the FFI-touching constructor; set only the fields the lifecycle
-  // paths read (identity getter + trackPublications map).
+  // paths read (identity getter, trackPublications map, and the open data
+  // stream writers that disconnect cleanup disposes).
   const p = Object.create(LocalParticipant.prototype) as LocalParticipant;
   // eslint-disable-next-line @typescript-eslint/no-explicit-any
   (p as any).info = { identity };
   // eslint-disable-next-line @typescript-eslint/no-explicit-any
   (p as any).trackPublications = new Map();
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  (p as any).openStreamWriters = new Set();
   return p;
 }
 

package/src/data_streams/stream_reader.ts

@@ -3,7 +3,6 @@
 // SPDX-License-Identifier: Apache-2.0
 import type { DataStream_Chunk } from '@livekit/rtc-ffi-bindings';
 import { log } from '../log.js';
-import { bigIntToNumber } from '../utils.js';
 import type { BaseStreamInfo, ByteStreamInfo, TextStreamInfo } from './types.js';
 
 abstract class BaseStreamReader<T extends BaseStreamInfo> {
@@ -15,6 +14,12 @@ abstract class BaseStreamReader<T extends BaseStreamInfo> {
 
   protected bytesReceived: number;
 
+  private closed = false;
+
+  // The reader held by an in-progress iteration. Cancelling has to go through
+  // it, since it holds the stream's lock.
+  private activeReader: ReadableStreamDefaultReader<DataStream_Chunk> | null = null;
+
   get info() {
     return this._info;
   }
@@ -26,7 +31,68 @@ abstract class BaseStreamReader<T extends BaseStreamInfo> {
     this.bytesReceived = 0;
   }
 
-  protected abstract handleChunkReceived(chunk: DataStream_Chunk): void;
+  protected handleChunkReceived(chunk: DataStream_Chunk) {
+    this.bytesReceived += chunk.content!.byteLength;
+    const currentProgress = this.totalByteSize
+      ? this.bytesReceived / this.totalByteSize
+      : undefined;
+    this.onProgress?.(currentProgress);
+  }
+
+  /** Takes the stream's reader for an iteration, remembering it so that
+   * close() can cancel a read that is still in flight. */
+  protected acquireReader(): ReadableStreamDefaultReader<DataStream_Chunk> {
+    const reader = this.reader.getReader();
+    this.activeReader = reader;
+    return reader;
+  }
+
+  /** Releases the stream lock after an iteration ended on its own — because a
+   * read reported end-of-stream, or because the stream itself errored. Either
+   * way the stream is in a terminal state and the FFI subscription behind it
+   * was already dropped by that terminal event, so there is nothing to cancel.
+   *
+   * An error raised *around* a read rather than by it — a chunk that failed to
+   * process — leaves the stream live, so it has to go through close() instead. */
+  protected finishIteration(reader: ReadableStreamDefaultReader<DataStream_Chunk>) {
+    this.closed = true;
+    if (this.activeReader === reader) {
+      this.activeReader = null;
+    }
+    reader.releaseLock();
+  }
+
+  /**
+   * Stops receiving this stream and releases the resources behind it.
+   *
+   * A reader is subscribed to FFI events from the moment it is handed to a
+   * stream handler, and only unsubscribes once a read consumes the stream's
+   * end-of-stream event. So a reader that is abandoned part-way through, or
+   * that a handler never reads at all, has to be closed here or its
+   * subscription lives for the rest of the process. Reading to completion — or
+   * breaking out of a `for await` — closes the reader for you, and closing an
+   * already-closed reader is a no-op.
+   */
+  async close(): Promise<void> {
+    if (this.closed) {
+      return;
+    }
+    this.closed = true;
+    const active = this.activeReader;
+    this.activeReader = null;
+    try {
+      if (active) {
+        await active.cancel();
+        active.releaseLock();
+      } else {
+        await this.reader.cancel();
+      }
+    } catch (error: unknown) {
+      // The stream was already closed or errored (e.g. the room disconnected
+      // mid-stream), in which case its subscription is already gone.
+      log.debug('error closing stream reader: %s', error);
+    }
+  }
 
   onProgress?: (progress: number | undefined) => void;
 
@@ -37,41 +103,48 @@ abstract class BaseStreamReader<T extends BaseStreamInfo> {
  * A class to read chunks from a ReadableStream and provide them in a structured format.
  */
 export class ByteStreamReader extends BaseStreamReader<ByteStreamInfo> {
-  protected handleChunkReceived(chunk: DataStream_Chunk) {
-    this.bytesReceived += chunk.content!.byteLength;
-    const currentProgress = this.totalByteSize
-      ? this.bytesReceived / this.totalByteSize
-      : undefined;
-    this.onProgress?.(currentProgress);
-  }
-
   [Symbol.asyncIterator]() {
-    const reader = this.reader.getReader();
+    const reader = this.acquireReader();
 
     return {
       next: async (): Promise<IteratorResult<Uint8Array>> => {
+        let read: Awaited<ReturnType<typeof reader.read>>;
         try {
-          const { done, value } = await reader.read();
-          if (done) {
-            // Release the lock when the stream is exhausted so the
-            // underlying ReadableStream can be garbage-collected.
-            reader.releaseLock();
-            return { done: true, value: undefined as unknown };
-          } else {
-            this.handleChunkReceived(value);
-            return { done: false, value: value.content! };
-          }
+          read = await reader.read();
         } catch (error: unknown) {
-          // Release the lock on error so it doesn't stay held when the
-          // consumer never calls return() (e.g. breaking out of for-await).
-          reader.releaseLock();
-          log.error('error processing stream update: %s', error);
+          // The stream errored, which is terminal: release the lock so it
+          // doesn't stay held when the consumer never calls return() (a
+          // rejecting next() doesn't trigger it).
+          this.finishIteration(reader);
+          log.error('error reading stream: %s', error);
+          // Propagate abnormal termination (e.g. remote abort, payload over
+          // the receiver's size limit) instead of presenting the truncated
+          // payload as a clean EOF.
+          throw error;
+        }
+
+        if (read.done) {
+          // Release the lock when the stream is exhausted so the
+          // underlying ReadableStream can be garbage-collected.
+          this.finishIteration(reader);
           return { done: true, value: undefined as unknown };
         }
+
+        try {
+          this.handleChunkReceived(read.value);
+          return { done: false, value: read.value.content! };
+        } catch (error: unknown) {
+          // The chunk arrived fine but handling it threw (e.g. a consumer's
+          // onProgress callback). The stream is still live, so it has to be
+          // cancelled to release its FFI subscription.
+          await this.close();
+          log.error('error processing stream update: %s', error);
+          throw error;
+        }
       },
 
-      return(): IteratorResult<Uint8Array> {
-        reader.releaseLock();
+      return: async (): Promise<IteratorResult<Uint8Array>> => {
+        await this.close();
         return { done: true, value: undefined };
       },
     };
@@ -90,77 +163,54 @@ export class ByteStreamReader extends BaseStreamReader<ByteStreamInfo> {
  * A class to read chunks from a ReadableStream and provide them in a structured format.
  */
 export class TextStreamReader extends BaseStreamReader<TextStreamInfo> {
-  private receivedChunks: Map<number, DataStream_Chunk>;
-
-  /**
-   * A TextStreamReader instance can be used as an AsyncIterator that returns the entire string
-   * that has been received up to the current point in time.
-   */
-  constructor(
-    info: TextStreamInfo,
-    stream: ReadableStream<DataStream_Chunk>,
-    totalChunkCount?: number,
-  ) {
-    super(info, stream, totalChunkCount);
-    this.receivedChunks = new Map();
-  }
-
-  protected handleChunkReceived(chunk: DataStream_Chunk) {
-    const index = bigIntToNumber(chunk.chunkIndex!);
-    const previousChunkAtIndex = this.receivedChunks.get(index!);
-    if (previousChunkAtIndex && previousChunkAtIndex.version! > chunk.version!) {
-      // we have a newer version already, dropping the old one
-      return;
-    }
-    this.receivedChunks.set(index, chunk);
-    const currentProgress = this.totalByteSize
-      ? this.receivedChunks.size / this.totalByteSize
-      : undefined;
-    this.onProgress?.(currentProgress);
-  }
-
   /**
    * Async iterator implementation to allow usage of `for await...of` syntax.
    * Yields structured chunks from the stream.
    *
    */
   [Symbol.asyncIterator]() {
-    const reader = this.reader.getReader();
+    const reader = this.acquireReader();
     const decoder = new TextDecoder();
-    const receivedChunks = this.receivedChunks;
 
     return {
       next: async (): Promise<IteratorResult<string>> => {
+        let read: Awaited<ReturnType<typeof reader.read>>;
         try {
-          const { done, value } = await reader.read();
-          if (done) {
-            // Release the lock when the stream is exhausted so the
-            // underlying ReadableStream can be garbage-collected.
-            reader.releaseLock();
-            // Clear received chunks so the buffered data can be GC'd.
-            receivedChunks.clear();
-            return { done: true, value: undefined };
-          } else {
-            this.handleChunkReceived(value);
-            return {
-              done: false,
-              value: decoder.decode(value.content!),
-            };
-          }
+          read = await reader.read();
         } catch (error: unknown) {
-          // Release the lock on error so it doesn't stay held when the
-          // consumer never calls return() (e.g. breaking out of for-await).
-          reader.releaseLock();
-          receivedChunks.clear();
-          log.error('error processing stream update: %s', error);
+          // The stream errored, which is terminal: release the lock so it
+          // doesn't stay held when the consumer never calls return() (a
+          // rejecting next() doesn't trigger it).
+          this.finishIteration(reader);
+          log.error('error reading stream: %s', error);
+          // Propagate abnormal termination (e.g. remote abort, payload over
+          // the receiver's size limit) instead of presenting the truncated
+          // payload as a clean EOF.
+          throw error;
+        }
+
+        if (read.done) {
+          // Release the lock when the stream is exhausted so the
+          // underlying ReadableStream can be garbage-collected.
+          this.finishIteration(reader);
           return { done: true, value: undefined };
         }
+
+        try {
+          this.handleChunkReceived(read.value);
+          return { done: false, value: decoder.decode(read.value.content!) };
+        } catch (error: unknown) {
+          // The chunk arrived fine but handling it threw (e.g. a consumer's
+          // onProgress callback). The stream is still live, so it has to be
+          // cancelled to release its FFI subscription.
+          await this.close();
+          log.error('error processing stream update: %s', error);
+          throw error;
+        }
       },
 
-      return(): IteratorResult<string> {
-        reader.releaseLock();
-        // Clear received chunks so the buffered data can be GC'd.
-        receivedChunks.clear();
+      return: async (): Promise<IteratorResult<string>> => {
+        await this.close();
         return { done: true, value: undefined };
       },
     };

package/src/data_streams/types.ts

@@ -42,6 +42,12 @@ export interface TextStreamOptions extends DataStreamOptions {
 export interface ByteStreamOptions extends DataStreamOptions {
   name?: string;
   onProgress?: (progress: number) => void;
+  /**
+   * Whether the payload may be compressed on the wire. Defaults to true;
+   * compression is only applied when it actually reduces the payload size
+   * and every recipient supports it.
+   */
+  compress?: boolean;
 }
 
 export type ByteStreamHandler = (

package/src/e2ee.ts

@@ -17,6 +17,7 @@ import {
   FrameCryptorSetKeyIndexRequest,
   GetKeyRequest,
   GetSharedKeyRequest,
+  KeyDerivationFunction,
   RatchetKeyRequest,
   RatchetSharedKeyRequest,
   SetKeyRequest,
@@ -27,18 +28,24 @@ import { FfiClient } from './ffi_client.js';
 const DEFAULT_RATCHET_SALT = new TextEncoder().encode('LKFrameEncryptionKey');
 const DEFAULT_RATCHET_WINDOW_SIZE = 16;
 const DEFAULT_FAILURE_TOLERANCE = -1;
+const DEFAULT_KEY_RING_SIZE = 16;
+const DEFAULT_KEY_DERIVATION_FUNCTION = KeyDerivationFunction.PBKDF2;
 
 export interface KeyProviderOptions {
   sharedKey?: Uint8Array;
   ratchetSalt?: Uint8Array;
   ratchetWindowSize?: number;
   failureTolerance?: number;
+  keyRingSize?: number;
+  keyDerivationFunction?: KeyDerivationFunction;
 }
 
 export const defaultKeyProviderOptions: KeyProviderOptions = {
   ratchetSalt: DEFAULT_RATCHET_SALT,
   ratchetWindowSize: DEFAULT_RATCHET_WINDOW_SIZE,
   failureTolerance: DEFAULT_FAILURE_TOLERANCE,
+  keyRingSize: DEFAULT_KEY_RING_SIZE,
+  keyDerivationFunction: DEFAULT_KEY_DERIVATION_FUNCTION,
 };
 
 export interface E2EEOptions {

package/src/index.ts

@@ -36,7 +36,14 @@ export {
   TrackSource,
 } from '@livekit/rtc-ffi-bindings';
 export { VideoBufferType, VideoCodec, VideoRotation } from '@livekit/rtc-ffi-bindings';
-export { ConnectError, Room, RoomEvent, type RoomOptions, type RtcConfiguration } from './room.js';
+export {
+  ConnectError,
+  Room,
+  RoomEvent,
+  type RoomDataStreamOptions,
+  type RoomOptions,
+  type RtcConfiguration,
+} from './room.js';
 export { RpcError, type PerformRpcParams, type RpcInvocationData } from './rpc.js';
 export {
   LocalAudioTrack,