@livekit/rtc-node 0.13.21 → 0.13.23

package/dist/async_queue.cjs

@@ -0,0 +1,80 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var async_queue_exports = {};
+__export(async_queue_exports, {
+  AsyncQueue: () => AsyncQueue
+});
+module.exports = __toCommonJS(async_queue_exports);
+var import_deque = require("@datastructures-js/deque");
+class AsyncQueue {
+  constructor(capacity = Infinity) {
+    this.capacity = capacity;
+    this.items = [];
+    this.waitingProducers = new import_deque.Deque();
+    this.waitingConsumers = new import_deque.Deque();
+    this.closed = false;
+  }
+  async put(item) {
+    if (this.closed) throw new Error("Queue closed");
+    while (this.items.length >= this.capacity) {
+      await new Promise(
+        (resolve, reject) => this.waitingProducers.pushBack({ resolve, reject })
+      );
+      if (this.closed) throw new Error("Queue closed");
+    }
+    this.items.push(item);
+    if (this.waitingConsumers.size() > 0) {
+      const resolve = this.waitingConsumers.popFront();
+      resolve();
+    }
+  }
+  get() {
+    const item = this.items.shift();
+    if (this.waitingProducers.size() > 0) {
+      const producer = this.waitingProducers.popFront();
+      producer.resolve();
+    }
+    return item;
+  }
+  /**
+   * Wait until an item is available or the queue is closed.
+   * Returns immediately if items are already available.
+   */
+  async waitForItem() {
+    if (this.items.length > 0 || this.closed) {
+      return;
+    }
+    await new Promise((resolve) => this.waitingConsumers.pushBack(resolve));
+  }
+  close() {
+    this.closed = true;
+    this.waitingProducers.toArray().forEach((producer) => producer.reject(new Error("Queue closed")));
+    this.waitingConsumers.toArray().forEach((resolve) => resolve());
+    this.waitingProducers.clear();
+    this.waitingConsumers.clear();
+  }
+  get length() {
+    return this.items.length;
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  AsyncQueue
+});
+//# sourceMappingURL=async_queue.cjs.map

package/dist/async_queue.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/async_queue.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2025 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nimport { Deque } from '@datastructures-js/deque';\n\n/**\n * AsyncQueue is a bounded queue with async support for both producers and consumers.\n *\n * This queue simplifies the AudioMixer implementation by handling backpressure and\n * synchronization automatically:\n * - Producers can await put() until the queue has space (when queue is full)\n * - Consumers can await waitForItem() until data is available (when queue is empty)\n *\n * This eliminates the need for manual coordination logic, polling loops, and\n * complex state management throughout the rest of the codebase.\n */\nexport class AsyncQueue<T> {\n  private items: T[] = [];\n  private waitingProducers = new Deque<{ resolve: () => void; reject: (err: Error) => void }>();\n  private waitingConsumers = new Deque<() => void>();\n  closed = false;\n\n  constructor(private capacity: number = Infinity) {}\n\n  async put(item: T) {\n    if (this.closed) throw new Error('Queue closed');\n\n    while (this.items.length >= this.capacity) {\n      await new Promise<void>((resolve, reject) =>\n        this.waitingProducers.pushBack({ resolve, reject }),\n      );\n      // Re-check if closed after waking up\n      if (this.closed) throw new Error('Queue closed');\n    }\n\n    this.items.push(item);\n\n    // Wake up one waiting consumer\n    if (this.waitingConsumers.size() > 0) {\n      const resolve = this.waitingConsumers.popFront()!;\n      resolve();\n    }\n  }\n\n  get(): T | undefined {\n    const item = this.items.shift();\n    if (this.waitingProducers.size() > 0) {\n      const producer = this.waitingProducers.popFront()!;\n      producer.resolve(); // wakes up one waiting producer\n    }\n    return item;\n  }\n\n  /**\n   * Wait until an item is available or the queue is closed.\n   * Returns immediately if items are already available.\n   */\n  async waitForItem(): Promise<void> {\n    if (this.items.length > 0 || this.closed) {\n      return;\n    }\n    await new Promise<void>((resolve) => this.waitingConsumers.pushBack(resolve));\n  }\n\n  close() {\n    this.closed = true;\n    // Reject all waiting producers with an error\n    this.waitingProducers\n      .toArray()\n      .forEach((producer) => producer.reject(new Error('Queue closed')));\n    // Resolve all waiting consumers so they can see the queue is closed\n    this.waitingConsumers.toArray().forEach((resolve) => resolve());\n    this.waitingProducers.clear();\n    this.waitingConsumers.clear();\n  }\n\n  get length() {\n    return this.items.length;\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAGA,mBAAsB;AAaf,MAAM,WAAc;AAAA,EAMzB,YAAoB,WAAmB,UAAU;AAA7B;AALpB,SAAQ,QAAa,CAAC;AACtB,SAAQ,mBAAmB,IAAI,mBAA6D;AAC5F,SAAQ,mBAAmB,IAAI,mBAAkB;AACjD,kBAAS;AAAA,EAEyC;AAAA,EAElD,MAAM,IAAI,MAAS;AACjB,QAAI,KAAK,OAAQ,OAAM,IAAI,MAAM,cAAc;AAE/C,WAAO,KAAK,MAAM,UAAU,KAAK,UAAU;AACzC,YAAM,IAAI;AAAA,QAAc,CAAC,SAAS,WAChC,KAAK,iBAAiB,SAAS,EAAE,SAAS,OAAO,CAAC;AAAA,MACpD;AAEA,UAAI,KAAK,OAAQ,OAAM,IAAI,MAAM,cAAc;AAAA,IACjD;AAEA,SAAK,MAAM,KAAK,IAAI;AAGpB,QAAI,KAAK,iBAAiB,KAAK,IAAI,GAAG;AACpC,YAAM,UAAU,KAAK,iBAAiB,SAAS;AAC/C,cAAQ;AAAA,IACV;AAAA,EACF;AAAA,EAEA,MAAqB;AACnB,UAAM,OAAO,KAAK,MAAM,MAAM;AAC9B,QAAI,KAAK,iBAAiB,KAAK,IAAI,GAAG;AACpC,YAAM,WAAW,KAAK,iBAAiB,SAAS;AAChD,eAAS,QAAQ;AAAA,IACnB;AACA,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAM,cAA6B;AACjC,QAAI,KAAK,MAAM,SAAS,KAAK,KAAK,QAAQ;AACxC;AAAA,IACF;AACA,UAAM,IAAI,QAAc,CAAC,YAAY,KAAK,iBAAiB,SAAS,OAAO,CAAC;AAAA,EAC9E;AAAA,EAEA,QAAQ;AACN,SAAK,SAAS;AAEd,SAAK,iBACF,QAAQ,EACR,QAAQ,CAAC,aAAa,SAAS,OAAO,IAAI,MAAM,cAAc,CAAC,CAAC;AAEnE,SAAK,iBAAiB,QAAQ,EAAE,QAAQ,CAAC,YAAY,QAAQ,CAAC;AAC9D,SAAK,iBAAiB,MAAM;AAC5B,SAAK,iBAAiB,MAAM;AAAA,EAC9B;AAAA,EAEA,IAAI,SAAS;AACX,WAAO,KAAK,MAAM;AAAA,EACpB;AACF;","names":[]}

package/dist/async_queue.d.cts

@@ -0,0 +1,30 @@
+/**
+ * AsyncQueue is a bounded queue with async support for both producers and consumers.
+ *
+ * This queue simplifies the AudioMixer implementation by handling backpressure and
+ * synchronization automatically:
+ * - Producers can await put() until the queue has space (when queue is full)
+ * - Consumers can await waitForItem() until data is available (when queue is empty)
+ *
+ * This eliminates the need for manual coordination logic, polling loops, and
+ * complex state management throughout the rest of the codebase.
+ */
+declare class AsyncQueue<T> {
+    private capacity;
+    private items;
+    private waitingProducers;
+    private waitingConsumers;
+    closed: boolean;
+    constructor(capacity?: number);
+    put(item: T): Promise<void>;
+    get(): T | undefined;
+    /**
+     * Wait until an item is available or the queue is closed.
+     * Returns immediately if items are already available.
+     */
+    waitForItem(): Promise<void>;
+    close(): void;
+    get length(): number;
+}
+
+export { AsyncQueue };

package/dist/async_queue.d.ts

@@ -0,0 +1,30 @@
+/**
+ * AsyncQueue is a bounded queue with async support for both producers and consumers.
+ *
+ * This queue simplifies the AudioMixer implementation by handling backpressure and
+ * synchronization automatically:
+ * - Producers can await put() until the queue has space (when queue is full)
+ * - Consumers can await waitForItem() until data is available (when queue is empty)
+ *
+ * This eliminates the need for manual coordination logic, polling loops, and
+ * complex state management throughout the rest of the codebase.
+ */
+declare class AsyncQueue<T> {
+    private capacity;
+    private items;
+    private waitingProducers;
+    private waitingConsumers;
+    closed: boolean;
+    constructor(capacity?: number);
+    put(item: T): Promise<void>;
+    get(): T | undefined;
+    /**
+     * Wait until an item is available or the queue is closed.
+     * Returns immediately if items are already available.
+     */
+    waitForItem(): Promise<void>;
+    close(): void;
+    get length(): number;
+}
+
+export { AsyncQueue };

package/dist/async_queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"async_queue.d.ts","sourceRoot":"","sources":["../src/async_queue.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;GAUG;AACH,qBAAa,UAAU,CAAC,CAAC;IAMX,OAAO,CAAC,QAAQ;IAL5B,OAAO,CAAC,KAAK,CAAW;IACxB,OAAO,CAAC,gBAAgB,CAAsE;IAC9F,OAAO,CAAC,gBAAgB,CAA2B;IACnD,MAAM,UAAS;gBAEK,QAAQ,GAAE,MAAiB;IAEzC,GAAG,CAAC,IAAI,EAAE,CAAC;IAoBjB,GAAG,IAAI,CAAC,GAAG,SAAS;IASpB;;;OAGG;IACG,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAOlC,KAAK;IAYL,IAAI,MAAM,WAET;CACF"}

package/dist/async_queue.js

@@ -0,0 +1,56 @@
+import { Deque } from "@datastructures-js/deque";
+class AsyncQueue {
+  constructor(capacity = Infinity) {
+    this.capacity = capacity;
+    this.items = [];
+    this.waitingProducers = new Deque();
+    this.waitingConsumers = new Deque();
+    this.closed = false;
+  }
+  async put(item) {
+    if (this.closed) throw new Error("Queue closed");
+    while (this.items.length >= this.capacity) {
+      await new Promise(
+        (resolve, reject) => this.waitingProducers.pushBack({ resolve, reject })
+      );
+      if (this.closed) throw new Error("Queue closed");
+    }
+    this.items.push(item);
+    if (this.waitingConsumers.size() > 0) {
+      const resolve = this.waitingConsumers.popFront();
+      resolve();
+    }
+  }
+  get() {
+    const item = this.items.shift();
+    if (this.waitingProducers.size() > 0) {
+      const producer = this.waitingProducers.popFront();
+      producer.resolve();
+    }
+    return item;
+  }
+  /**
+   * Wait until an item is available or the queue is closed.
+   * Returns immediately if items are already available.
+   */
+  async waitForItem() {
+    if (this.items.length > 0 || this.closed) {
+      return;
+    }
+    await new Promise((resolve) => this.waitingConsumers.pushBack(resolve));
+  }
+  close() {
+    this.closed = true;
+    this.waitingProducers.toArray().forEach((producer) => producer.reject(new Error("Queue closed")));
+    this.waitingConsumers.toArray().forEach((resolve) => resolve());
+    this.waitingProducers.clear();
+    this.waitingConsumers.clear();
+  }
+  get length() {
+    return this.items.length;
+  }
+}
+export {
+  AsyncQueue
+};
+//# sourceMappingURL=async_queue.js.map

package/dist/async_queue.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/async_queue.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2025 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nimport { Deque } from '@datastructures-js/deque';\n\n/**\n * AsyncQueue is a bounded queue with async support for both producers and consumers.\n *\n * This queue simplifies the AudioMixer implementation by handling backpressure and\n * synchronization automatically:\n * - Producers can await put() until the queue has space (when queue is full)\n * - Consumers can await waitForItem() until data is available (when queue is empty)\n *\n * This eliminates the need for manual coordination logic, polling loops, and\n * complex state management throughout the rest of the codebase.\n */\nexport class AsyncQueue<T> {\n  private items: T[] = [];\n  private waitingProducers = new Deque<{ resolve: () => void; reject: (err: Error) => void }>();\n  private waitingConsumers = new Deque<() => void>();\n  closed = false;\n\n  constructor(private capacity: number = Infinity) {}\n\n  async put(item: T) {\n    if (this.closed) throw new Error('Queue closed');\n\n    while (this.items.length >= this.capacity) {\n      await new Promise<void>((resolve, reject) =>\n        this.waitingProducers.pushBack({ resolve, reject }),\n      );\n      // Re-check if closed after waking up\n      if (this.closed) throw new Error('Queue closed');\n    }\n\n    this.items.push(item);\n\n    // Wake up one waiting consumer\n    if (this.waitingConsumers.size() > 0) {\n      const resolve = this.waitingConsumers.popFront()!;\n      resolve();\n    }\n  }\n\n  get(): T | undefined {\n    const item = this.items.shift();\n    if (this.waitingProducers.size() > 0) {\n      const producer = this.waitingProducers.popFront()!;\n      producer.resolve(); // wakes up one waiting producer\n    }\n    return item;\n  }\n\n  /**\n   * Wait until an item is available or the queue is closed.\n   * Returns immediately if items are already available.\n   */\n  async waitForItem(): Promise<void> {\n    if (this.items.length > 0 || this.closed) {\n      return;\n    }\n    await new Promise<void>((resolve) => this.waitingConsumers.pushBack(resolve));\n  }\n\n  close() {\n    this.closed = true;\n    // Reject all waiting producers with an error\n    this.waitingProducers\n      .toArray()\n      .forEach((producer) => producer.reject(new Error('Queue closed')));\n    // Resolve all waiting consumers so they can see the queue is closed\n    this.waitingConsumers.toArray().forEach((resolve) => resolve());\n    this.waitingProducers.clear();\n    this.waitingConsumers.clear();\n  }\n\n  get length() {\n    return this.items.length;\n  }\n}\n"],"mappings":"AAGA,SAAS,aAAa;AAaf,MAAM,WAAc;AAAA,EAMzB,YAAoB,WAAmB,UAAU;AAA7B;AALpB,SAAQ,QAAa,CAAC;AACtB,SAAQ,mBAAmB,IAAI,MAA6D;AAC5F,SAAQ,mBAAmB,IAAI,MAAkB;AACjD,kBAAS;AAAA,EAEyC;AAAA,EAElD,MAAM,IAAI,MAAS;AACjB,QAAI,KAAK,OAAQ,OAAM,IAAI,MAAM,cAAc;AAE/C,WAAO,KAAK,MAAM,UAAU,KAAK,UAAU;AACzC,YAAM,IAAI;AAAA,QAAc,CAAC,SAAS,WAChC,KAAK,iBAAiB,SAAS,EAAE,SAAS,OAAO,CAAC;AAAA,MACpD;AAEA,UAAI,KAAK,OAAQ,OAAM,IAAI,MAAM,cAAc;AAAA,IACjD;AAEA,SAAK,MAAM,KAAK,IAAI;AAGpB,QAAI,KAAK,iBAAiB,KAAK,IAAI,GAAG;AACpC,YAAM,UAAU,KAAK,iBAAiB,SAAS;AAC/C,cAAQ;AAAA,IACV;AAAA,EACF;AAAA,EAEA,MAAqB;AACnB,UAAM,OAAO,KAAK,MAAM,MAAM;AAC9B,QAAI,KAAK,iBAAiB,KAAK,IAAI,GAAG;AACpC,YAAM,WAAW,KAAK,iBAAiB,SAAS;AAChD,eAAS,QAAQ;AAAA,IACnB;AACA,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAM,cAA6B;AACjC,QAAI,KAAK,MAAM,SAAS,KAAK,KAAK,QAAQ;AACxC;AAAA,IACF;AACA,UAAM,IAAI,QAAc,CAAC,YAAY,KAAK,iBAAiB,SAAS,OAAO,CAAC;AAAA,EAC9E;AAAA,EAEA,QAAQ;AACN,SAAK,SAAS;AAEd,SAAK,iBACF,QAAQ,EACR,QAAQ,CAAC,aAAa,SAAS,OAAO,IAAI,MAAM,cAAc,CAAC,CAAC;AAEnE,SAAK,iBAAiB,QAAQ,EAAE,QAAQ,CAAC,YAAY,QAAQ,CAAC;AAC9D,SAAK,iBAAiB,MAAM;AAC5B,SAAK,iBAAiB,MAAM;AAAA,EAC9B;AAAA,EAEA,IAAI,SAAS;AACX,WAAO,KAAK,MAAM;AAAA,EACpB;AACF;","names":[]}

package/dist/audio_frame.cjs

@@ -31,6 +31,7 @@ class AudioFrame {
   // it is recommended to use buffer.subarray instead.
   // XXX(nbsp): add this when writing proper docs
   constructor(data, sampleRate, channels, samplesPerChannel) {
+    this._userdata = {};
     this.data = data;
     this.sampleRate = sampleRate;
     this.channels = channels;
@@ -62,6 +63,10 @@ class AudioFrame {
       samplesPerChannel: this.samplesPerChannel
     });
   }
+  /** Returns the user data associated with the audio frame. */
+  get userdata() {
+    return this._userdata;
+  }
 }
 const combineAudioFrames = (buffer) => {
   if (!Array.isArray(buffer)) {

package/dist/audio_frame.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/audio_frame.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2024 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nimport { FfiClient, FfiHandle } from './ffi_client.js';\nimport type { OwnedAudioFrameBuffer } from './proto/audio_frame_pb.js';\nimport { AudioFrameBufferInfo } from './proto/audio_frame_pb.js';\n\nexport class AudioFrame {\n  data: Int16Array;\n  sampleRate: number;\n  channels: number;\n  samplesPerChannel: number;\n\n  // note: if converting from Uint8Array to Int16Array, *do not* use buffer.slice!\n  // it is marked unstable by Node and can cause undefined behaviour, such as massive chunks of\n  // noise being added to the end.\n  // it is recommended to use buffer.subarray instead.\n  // XXX(nbsp): add this when writing proper docs\n  constructor(data: Int16Array, sampleRate: number, channels: number, samplesPerChannel: number) {\n    this.data = data;\n    this.sampleRate = sampleRate;\n    this.channels = channels;\n    this.samplesPerChannel = samplesPerChannel;\n  }\n\n  static create(sampleRate: number, channels: number, samplesPerChannel: number): AudioFrame {\n    const data = new Int16Array(channels * samplesPerChannel);\n    return new AudioFrame(data, sampleRate, channels, samplesPerChannel);\n  }\n\n  /** @internal */\n  static fromOwnedInfo(owned: OwnedAudioFrameBuffer): AudioFrame {\n    const info = owned.info!;\n    const len = info.numChannels! * info.samplesPerChannel! * 2; // c_int16\n    const data = FfiClient.instance.copyBuffer(info.dataPtr!, len);\n    new FfiHandle(owned.handle!.id!).dispose();\n    return new AudioFrame(\n      new Int16Array(data.buffer),\n      info.sampleRate!,\n      info.numChannels!,\n      info.samplesPerChannel!,\n    );\n  }\n\n  /** @internal */\n  protoInfo(): AudioFrameBufferInfo {\n    return new AudioFrameBufferInfo({\n      dataPtr: FfiClient.instance.retrievePtr(new Uint8Array(this.data.buffer)),\n      sampleRate: this.sampleRate,\n      numChannels: this.channels,\n      samplesPerChannel: this.samplesPerChannel,\n    });\n  }\n}\n\n/**\n * Combines one or more `rtc.AudioFrame` objects into a single `rtc.AudioFrame`.\n *\n * This function concatenates the audio data from multiple frames, ensuring that all frames have\n * the same sample rate and number of channels. It efficiently merges the data by preallocating the\n * necessary memory and copying the frame data without unnecessary reallocations.\n *\n * @param buffer - a single AudioFrame or list thereof\n */\nexport const combineAudioFrames = (buffer: AudioFrame | AudioFrame[]): AudioFrame => {\n  if (!Array.isArray(buffer)) {\n    return buffer;\n  }\n  buffer = buffer as AudioFrame[];\n\n  if (buffer.length === 0) {\n    throw new Error('buffer is empty');\n  }\n\n  const sampleRate = buffer[0]!.sampleRate;\n  const channels = buffer[0]!.channels;\n\n  let totalSamplesPerChannel = 0;\n  for (const frame of buffer) {\n    if (frame.sampleRate != sampleRate) {\n      throw new Error(`sample rate mismatch: expected ${sampleRate}, got ${frame.sampleRate}`);\n    }\n\n    if (frame.channels != channels) {\n      throw new Error(`channel mismatch: expected ${channels}, got ${frame.channels}`);\n    }\n\n    totalSamplesPerChannel += frame.samplesPerChannel;\n  }\n\n  const data = new Int16Array(buffer.map((x) => [...x.data]).flat());\n  return new AudioFrame(data, sampleRate, channels, totalSamplesPerChannel);\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAGA,wBAAqC;AAErC,4BAAqC;AAE9B,MAAM,WAAW;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAWtB,YAAY,MAAkB,YAAoB,UAAkB,mBAA2B;AAC7F,SAAK,OAAO;AACZ,SAAK,aAAa;AAClB,SAAK,WAAW;AAChB,SAAK,oBAAoB;AAAA,EAC3B;AAAA,EAEA,OAAO,OAAO,YAAoB,UAAkB,mBAAuC;AACzF,UAAM,OAAO,IAAI,WAAW,WAAW,iBAAiB;AACxD,WAAO,IAAI,WAAW,MAAM,YAAY,UAAU,iBAAiB;AAAA,EACrE;AAAA;AAAA,EAGA,OAAO,cAAc,OAA0C;AAC7D,UAAM,OAAO,MAAM;AACnB,UAAM,MAAM,KAAK,cAAe,KAAK,oBAAqB;AAC1D,UAAM,OAAO,4BAAU,SAAS,WAAW,KAAK,SAAU,GAAG;AAC7D,QAAI,4BAAU,MAAM,OAAQ,EAAG,EAAE,QAAQ;AACzC,WAAO,IAAI;AAAA,MACT,IAAI,WAAW,KAAK,MAAM;AAAA,MAC1B,KAAK;AAAA,MACL,KAAK;AAAA,MACL,KAAK;AAAA,IACP;AAAA,EACF;AAAA;AAAA,EAGA,YAAkC;AAChC,WAAO,IAAI,2CAAqB;AAAA,MAC9B,SAAS,4BAAU,SAAS,YAAY,IAAI,WAAW,KAAK,KAAK,MAAM,CAAC;AAAA,MACxE,YAAY,KAAK;AAAA,MACjB,aAAa,KAAK;AAAA,MAClB,mBAAmB,KAAK;AAAA,IAC1B,CAAC;AAAA,EACH;AACF;AAWO,MAAM,qBAAqB,CAAC,WAAkD;AACnF,MAAI,CAAC,MAAM,QAAQ,MAAM,GAAG;AAC1B,WAAO;AAAA,EACT;AACA,WAAS;AAET,MAAI,OAAO,WAAW,GAAG;AACvB,UAAM,IAAI,MAAM,iBAAiB;AAAA,EACnC;AAEA,QAAM,aAAa,OAAO,CAAC,EAAG;AAC9B,QAAM,WAAW,OAAO,CAAC,EAAG;AAE5B,MAAI,yBAAyB;AAC7B,aAAW,SAAS,QAAQ;AAC1B,QAAI,MAAM,cAAc,YAAY;AAClC,YAAM,IAAI,MAAM,kCAAkC,UAAU,SAAS,MAAM,UAAU,EAAE;AAAA,IACzF;AAEA,QAAI,MAAM,YAAY,UAAU;AAC9B,YAAM,IAAI,MAAM,8BAA8B,QAAQ,SAAS,MAAM,QAAQ,EAAE;AAAA,IACjF;AAEA,8BAA0B,MAAM;AAAA,EAClC;AAEA,QAAM,OAAO,IAAI,WAAW,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,KAAK,CAAC;AACjE,SAAO,IAAI,WAAW,MAAM,YAAY,UAAU,sBAAsB;AAC1E;","names":[]}
+{"version":3,"sources":["../src/audio_frame.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2024 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nimport { FfiClient, FfiHandle } from './ffi_client.js';\nimport type { OwnedAudioFrameBuffer } from './proto/audio_frame_pb.js';\nimport { AudioFrameBufferInfo } from './proto/audio_frame_pb.js';\n\nexport class AudioFrame {\n  data: Int16Array;\n  sampleRate: number;\n  channels: number;\n  samplesPerChannel: number;\n\n  private _userdata: Record<string, unknown> = {};\n\n  // note: if converting from Uint8Array to Int16Array, *do not* use buffer.slice!\n  // it is marked unstable by Node and can cause undefined behaviour, such as massive chunks of\n  // noise being added to the end.\n  // it is recommended to use buffer.subarray instead.\n  // XXX(nbsp): add this when writing proper docs\n  constructor(data: Int16Array, sampleRate: number, channels: number, samplesPerChannel: number) {\n    this.data = data;\n    this.sampleRate = sampleRate;\n    this.channels = channels;\n    this.samplesPerChannel = samplesPerChannel;\n  }\n\n  static create(sampleRate: number, channels: number, samplesPerChannel: number): AudioFrame {\n    const data = new Int16Array(channels * samplesPerChannel);\n    return new AudioFrame(data, sampleRate, channels, samplesPerChannel);\n  }\n\n  /** @internal */\n  static fromOwnedInfo(owned: OwnedAudioFrameBuffer): AudioFrame {\n    const info = owned.info!;\n    const len = info.numChannels! * info.samplesPerChannel! * 2; // c_int16\n    const data = FfiClient.instance.copyBuffer(info.dataPtr!, len);\n    new FfiHandle(owned.handle!.id!).dispose();\n    return new AudioFrame(\n      new Int16Array(data.buffer),\n      info.sampleRate!,\n      info.numChannels!,\n      info.samplesPerChannel!,\n    );\n  }\n\n  /** @internal */\n  protoInfo(): AudioFrameBufferInfo {\n    return new AudioFrameBufferInfo({\n      dataPtr: FfiClient.instance.retrievePtr(new Uint8Array(this.data.buffer)),\n      sampleRate: this.sampleRate,\n      numChannels: this.channels,\n      samplesPerChannel: this.samplesPerChannel,\n    });\n  }\n\n  /** Returns the user data associated with the audio frame. */\n  get userdata() {\n    return this._userdata;\n  }\n}\n\n/**\n * Combines one or more `rtc.AudioFrame` objects into a single `rtc.AudioFrame`.\n *\n * This function concatenates the audio data from multiple frames, ensuring that all frames have\n * the same sample rate and number of channels. It efficiently merges the data by preallocating the\n * necessary memory and copying the frame data without unnecessary reallocations.\n *\n * @param buffer - a single AudioFrame or list thereof\n */\nexport const combineAudioFrames = (buffer: AudioFrame | AudioFrame[]): AudioFrame => {\n  if (!Array.isArray(buffer)) {\n    return buffer;\n  }\n  buffer = buffer as AudioFrame[];\n\n  if (buffer.length === 0) {\n    throw new Error('buffer is empty');\n  }\n\n  const sampleRate = buffer[0]!.sampleRate;\n  const channels = buffer[0]!.channels;\n\n  let totalSamplesPerChannel = 0;\n  for (const frame of buffer) {\n    if (frame.sampleRate != sampleRate) {\n      throw new Error(`sample rate mismatch: expected ${sampleRate}, got ${frame.sampleRate}`);\n    }\n\n    if (frame.channels != channels) {\n      throw new Error(`channel mismatch: expected ${channels}, got ${frame.channels}`);\n    }\n\n    totalSamplesPerChannel += frame.samplesPerChannel;\n  }\n\n  const data = new Int16Array(buffer.map((x) => [...x.data]).flat());\n  return new AudioFrame(data, sampleRate, channels, totalSamplesPerChannel);\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAGA,wBAAqC;AAErC,4BAAqC;AAE9B,MAAM,WAAW;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAatB,YAAY,MAAkB,YAAoB,UAAkB,mBAA2B;AAP/F,SAAQ,YAAqC,CAAC;AAQ5C,SAAK,OAAO;AACZ,SAAK,aAAa;AAClB,SAAK,WAAW;AAChB,SAAK,oBAAoB;AAAA,EAC3B;AAAA,EAEA,OAAO,OAAO,YAAoB,UAAkB,mBAAuC;AACzF,UAAM,OAAO,IAAI,WAAW,WAAW,iBAAiB;AACxD,WAAO,IAAI,WAAW,MAAM,YAAY,UAAU,iBAAiB;AAAA,EACrE;AAAA;AAAA,EAGA,OAAO,cAAc,OAA0C;AAC7D,UAAM,OAAO,MAAM;AACnB,UAAM,MAAM,KAAK,cAAe,KAAK,oBAAqB;AAC1D,UAAM,OAAO,4BAAU,SAAS,WAAW,KAAK,SAAU,GAAG;AAC7D,QAAI,4BAAU,MAAM,OAAQ,EAAG,EAAE,QAAQ;AACzC,WAAO,IAAI;AAAA,MACT,IAAI,WAAW,KAAK,MAAM;AAAA,MAC1B,KAAK;AAAA,MACL,KAAK;AAAA,MACL,KAAK;AAAA,IACP;AAAA,EACF;AAAA;AAAA,EAGA,YAAkC;AAChC,WAAO,IAAI,2CAAqB;AAAA,MAC9B,SAAS,4BAAU,SAAS,YAAY,IAAI,WAAW,KAAK,KAAK,MAAM,CAAC;AAAA,MACxE,YAAY,KAAK;AAAA,MACjB,aAAa,KAAK;AAAA,MAClB,mBAAmB,KAAK;AAAA,IAC1B,CAAC;AAAA,EACH;AAAA;AAAA,EAGA,IAAI,WAAW;AACb,WAAO,KAAK;AAAA,EACd;AACF;AAWO,MAAM,qBAAqB,CAAC,WAAkD;AACnF,MAAI,CAAC,MAAM,QAAQ,MAAM,GAAG;AAC1B,WAAO;AAAA,EACT;AACA,WAAS;AAET,MAAI,OAAO,WAAW,GAAG;AACvB,UAAM,IAAI,MAAM,iBAAiB;AAAA,EACnC;AAEA,QAAM,aAAa,OAAO,CAAC,EAAG;AAC9B,QAAM,WAAW,OAAO,CAAC,EAAG;AAE5B,MAAI,yBAAyB;AAC7B,aAAW,SAAS,QAAQ;AAC1B,QAAI,MAAM,cAAc,YAAY;AAClC,YAAM,IAAI,MAAM,kCAAkC,UAAU,SAAS,MAAM,UAAU,EAAE;AAAA,IACzF;AAEA,QAAI,MAAM,YAAY,UAAU;AAC9B,YAAM,IAAI,MAAM,8BAA8B,QAAQ,SAAS,MAAM,QAAQ,EAAE;AAAA,IACjF;AAEA,8BAA0B,MAAM;AAAA,EAClC;AAEA,QAAM,OAAO,IAAI,WAAW,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,KAAK,CAAC;AACjE,SAAO,IAAI,WAAW,MAAM,YAAY,UAAU,sBAAsB;AAC1E;","names":[]}

package/dist/audio_frame.d.cts

@@ -10,12 +10,15 @@ declare class AudioFrame {
     sampleRate: number;
     channels: number;
     samplesPerChannel: number;
+    private _userdata;
     constructor(data: Int16Array, sampleRate: number, channels: number, samplesPerChannel: number);
     static create(sampleRate: number, channels: number, samplesPerChannel: number): AudioFrame;
     /** @internal */
     static fromOwnedInfo(owned: OwnedAudioFrameBuffer): AudioFrame;
     /** @internal */
     protoInfo(): AudioFrameBufferInfo;
+    /** Returns the user data associated with the audio frame. */
+    get userdata(): Record<string, unknown>;
 }
 /**
  * Combines one or more `rtc.AudioFrame` objects into a single `rtc.AudioFrame`.

package/dist/audio_frame.d.ts

@@ -10,12 +10,15 @@ declare class AudioFrame {
     sampleRate: number;
     channels: number;
     samplesPerChannel: number;
+    private _userdata;
     constructor(data: Int16Array, sampleRate: number, channels: number, samplesPerChannel: number);
     static create(sampleRate: number, channels: number, samplesPerChannel: number): AudioFrame;
     /** @internal */
     static fromOwnedInfo(owned: OwnedAudioFrameBuffer): AudioFrame;
     /** @internal */
     protoInfo(): AudioFrameBufferInfo;
+    /** Returns the user data associated with the audio frame. */
+    get userdata(): Record<string, unknown>;
 }
 /**
  * Combines one or more `rtc.AudioFrame` objects into a single `rtc.AudioFrame`.

package/dist/audio_frame.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"audio_frame.d.ts","sourceRoot":"","sources":["../src/audio_frame.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AACvE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAEjE,qBAAa,UAAU;IACrB,IAAI,EAAE,UAAU,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,iBAAiB,EAAE,MAAM,CAAC;gBAOd,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM;IAO7F,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,GAAG,UAAU;IAK1F,gBAAgB;IAChB,MAAM,CAAC,aAAa,CAAC,KAAK,EAAE,qBAAqB,GAAG,UAAU;IAa9D,gBAAgB;IAChB,SAAS,IAAI,oBAAoB;CAQlC;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,kBAAkB,GAAI,QAAQ,UAAU,GAAG,UAAU,EAAE,KAAG,UA4BtE,CAAC"}
+{"version":3,"file":"audio_frame.d.ts","sourceRoot":"","sources":["../src/audio_frame.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AACvE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAEjE,qBAAa,UAAU;IACrB,IAAI,EAAE,UAAU,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,iBAAiB,EAAE,MAAM,CAAC;IAE1B,OAAO,CAAC,SAAS,CAA+B;gBAOpC,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM;IAO7F,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,GAAG,UAAU;IAK1F,gBAAgB;IAChB,MAAM,CAAC,aAAa,CAAC,KAAK,EAAE,qBAAqB,GAAG,UAAU;IAa9D,gBAAgB;IAChB,SAAS,IAAI,oBAAoB;IASjC,6DAA6D;IAC7D,IAAI,QAAQ,4BAEX;CACF;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,kBAAkB,GAAI,QAAQ,UAAU,GAAG,UAAU,EAAE,KAAG,UA4BtE,CAAC"}

package/dist/audio_frame.js

@@ -7,6 +7,7 @@ class AudioFrame {
   // it is recommended to use buffer.subarray instead.
   // XXX(nbsp): add this when writing proper docs
   constructor(data, sampleRate, channels, samplesPerChannel) {
+    this._userdata = {};
     this.data = data;
     this.sampleRate = sampleRate;
     this.channels = channels;
@@ -38,6 +39,10 @@ class AudioFrame {
       samplesPerChannel: this.samplesPerChannel
     });
   }
+  /** Returns the user data associated with the audio frame. */
+  get userdata() {
+    return this._userdata;
+  }
 }
 const combineAudioFrames = (buffer) => {
   if (!Array.isArray(buffer)) {

package/dist/audio_frame.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/audio_frame.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2024 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nimport { FfiClient, FfiHandle } from './ffi_client.js';\nimport type { OwnedAudioFrameBuffer } from './proto/audio_frame_pb.js';\nimport { AudioFrameBufferInfo } from './proto/audio_frame_pb.js';\n\nexport class AudioFrame {\n  data: Int16Array;\n  sampleRate: number;\n  channels: number;\n  samplesPerChannel: number;\n\n  // note: if converting from Uint8Array to Int16Array, *do not* use buffer.slice!\n  // it is marked unstable by Node and can cause undefined behaviour, such as massive chunks of\n  // noise being added to the end.\n  // it is recommended to use buffer.subarray instead.\n  // XXX(nbsp): add this when writing proper docs\n  constructor(data: Int16Array, sampleRate: number, channels: number, samplesPerChannel: number) {\n    this.data = data;\n    this.sampleRate = sampleRate;\n    this.channels = channels;\n    this.samplesPerChannel = samplesPerChannel;\n  }\n\n  static create(sampleRate: number, channels: number, samplesPerChannel: number): AudioFrame {\n    const data = new Int16Array(channels * samplesPerChannel);\n    return new AudioFrame(data, sampleRate, channels, samplesPerChannel);\n  }\n\n  /** @internal */\n  static fromOwnedInfo(owned: OwnedAudioFrameBuffer): AudioFrame {\n    const info = owned.info!;\n    const len = info.numChannels! * info.samplesPerChannel! * 2; // c_int16\n    const data = FfiClient.instance.copyBuffer(info.dataPtr!, len);\n    new FfiHandle(owned.handle!.id!).dispose();\n    return new AudioFrame(\n      new Int16Array(data.buffer),\n      info.sampleRate!,\n      info.numChannels!,\n      info.samplesPerChannel!,\n    );\n  }\n\n  /** @internal */\n  protoInfo(): AudioFrameBufferInfo {\n    return new AudioFrameBufferInfo({\n      dataPtr: FfiClient.instance.retrievePtr(new Uint8Array(this.data.buffer)),\n      sampleRate: this.sampleRate,\n      numChannels: this.channels,\n      samplesPerChannel: this.samplesPerChannel,\n    });\n  }\n}\n\n/**\n * Combines one or more `rtc.AudioFrame` objects into a single `rtc.AudioFrame`.\n *\n * This function concatenates the audio data from multiple frames, ensuring that all frames have\n * the same sample rate and number of channels. It efficiently merges the data by preallocating the\n * necessary memory and copying the frame data without unnecessary reallocations.\n *\n * @param buffer - a single AudioFrame or list thereof\n */\nexport const combineAudioFrames = (buffer: AudioFrame | AudioFrame[]): AudioFrame => {\n  if (!Array.isArray(buffer)) {\n    return buffer;\n  }\n  buffer = buffer as AudioFrame[];\n\n  if (buffer.length === 0) {\n    throw new Error('buffer is empty');\n  }\n\n  const sampleRate = buffer[0]!.sampleRate;\n  const channels = buffer[0]!.channels;\n\n  let totalSamplesPerChannel = 0;\n  for (const frame of buffer) {\n    if (frame.sampleRate != sampleRate) {\n      throw new Error(`sample rate mismatch: expected ${sampleRate}, got ${frame.sampleRate}`);\n    }\n\n    if (frame.channels != channels) {\n      throw new Error(`channel mismatch: expected ${channels}, got ${frame.channels}`);\n    }\n\n    totalSamplesPerChannel += frame.samplesPerChannel;\n  }\n\n  const data = new Int16Array(buffer.map((x) => [...x.data]).flat());\n  return new AudioFrame(data, sampleRate, channels, totalSamplesPerChannel);\n};\n"],"mappings":"AAGA,SAAS,WAAW,iBAAiB;AAErC,SAAS,4BAA4B;AAE9B,MAAM,WAAW;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAWtB,YAAY,MAAkB,YAAoB,UAAkB,mBAA2B;AAC7F,SAAK,OAAO;AACZ,SAAK,aAAa;AAClB,SAAK,WAAW;AAChB,SAAK,oBAAoB;AAAA,EAC3B;AAAA,EAEA,OAAO,OAAO,YAAoB,UAAkB,mBAAuC;AACzF,UAAM,OAAO,IAAI,WAAW,WAAW,iBAAiB;AACxD,WAAO,IAAI,WAAW,MAAM,YAAY,UAAU,iBAAiB;AAAA,EACrE;AAAA;AAAA,EAGA,OAAO,cAAc,OAA0C;AAC7D,UAAM,OAAO,MAAM;AACnB,UAAM,MAAM,KAAK,cAAe,KAAK,oBAAqB;AAC1D,UAAM,OAAO,UAAU,SAAS,WAAW,KAAK,SAAU,GAAG;AAC7D,QAAI,UAAU,MAAM,OAAQ,EAAG,EAAE,QAAQ;AACzC,WAAO,IAAI;AAAA,MACT,IAAI,WAAW,KAAK,MAAM;AAAA,MAC1B,KAAK;AAAA,MACL,KAAK;AAAA,MACL,KAAK;AAAA,IACP;AAAA,EACF;AAAA;AAAA,EAGA,YAAkC;AAChC,WAAO,IAAI,qBAAqB;AAAA,MAC9B,SAAS,UAAU,SAAS,YAAY,IAAI,WAAW,KAAK,KAAK,MAAM,CAAC;AAAA,MACxE,YAAY,KAAK;AAAA,MACjB,aAAa,KAAK;AAAA,MAClB,mBAAmB,KAAK;AAAA,IAC1B,CAAC;AAAA,EACH;AACF;AAWO,MAAM,qBAAqB,CAAC,WAAkD;AACnF,MAAI,CAAC,MAAM,QAAQ,MAAM,GAAG;AAC1B,WAAO;AAAA,EACT;AACA,WAAS;AAET,MAAI,OAAO,WAAW,GAAG;AACvB,UAAM,IAAI,MAAM,iBAAiB;AAAA,EACnC;AAEA,QAAM,aAAa,OAAO,CAAC,EAAG;AAC9B,QAAM,WAAW,OAAO,CAAC,EAAG;AAE5B,MAAI,yBAAyB;AAC7B,aAAW,SAAS,QAAQ;AAC1B,QAAI,MAAM,cAAc,YAAY;AAClC,YAAM,IAAI,MAAM,kCAAkC,UAAU,SAAS,MAAM,UAAU,EAAE;AAAA,IACzF;AAEA,QAAI,MAAM,YAAY,UAAU;AAC9B,YAAM,IAAI,MAAM,8BAA8B,QAAQ,SAAS,MAAM,QAAQ,EAAE;AAAA,IACjF;AAEA,8BAA0B,MAAM;AAAA,EAClC;AAEA,QAAM,OAAO,IAAI,WAAW,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,KAAK,CAAC;AACjE,SAAO,IAAI,WAAW,MAAM,YAAY,UAAU,sBAAsB;AAC1E;","names":[]}
+{"version":3,"sources":["../src/audio_frame.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2024 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nimport { FfiClient, FfiHandle } from './ffi_client.js';\nimport type { OwnedAudioFrameBuffer } from './proto/audio_frame_pb.js';\nimport { AudioFrameBufferInfo } from './proto/audio_frame_pb.js';\n\nexport class AudioFrame {\n  data: Int16Array;\n  sampleRate: number;\n  channels: number;\n  samplesPerChannel: number;\n\n  private _userdata: Record<string, unknown> = {};\n\n  // note: if converting from Uint8Array to Int16Array, *do not* use buffer.slice!\n  // it is marked unstable by Node and can cause undefined behaviour, such as massive chunks of\n  // noise being added to the end.\n  // it is recommended to use buffer.subarray instead.\n  // XXX(nbsp): add this when writing proper docs\n  constructor(data: Int16Array, sampleRate: number, channels: number, samplesPerChannel: number) {\n    this.data = data;\n    this.sampleRate = sampleRate;\n    this.channels = channels;\n    this.samplesPerChannel = samplesPerChannel;\n  }\n\n  static create(sampleRate: number, channels: number, samplesPerChannel: number): AudioFrame {\n    const data = new Int16Array(channels * samplesPerChannel);\n    return new AudioFrame(data, sampleRate, channels, samplesPerChannel);\n  }\n\n  /** @internal */\n  static fromOwnedInfo(owned: OwnedAudioFrameBuffer): AudioFrame {\n    const info = owned.info!;\n    const len = info.numChannels! * info.samplesPerChannel! * 2; // c_int16\n    const data = FfiClient.instance.copyBuffer(info.dataPtr!, len);\n    new FfiHandle(owned.handle!.id!).dispose();\n    return new AudioFrame(\n      new Int16Array(data.buffer),\n      info.sampleRate!,\n      info.numChannels!,\n      info.samplesPerChannel!,\n    );\n  }\n\n  /** @internal */\n  protoInfo(): AudioFrameBufferInfo {\n    return new AudioFrameBufferInfo({\n      dataPtr: FfiClient.instance.retrievePtr(new Uint8Array(this.data.buffer)),\n      sampleRate: this.sampleRate,\n      numChannels: this.channels,\n      samplesPerChannel: this.samplesPerChannel,\n    });\n  }\n\n  /** Returns the user data associated with the audio frame. */\n  get userdata() {\n    return this._userdata;\n  }\n}\n\n/**\n * Combines one or more `rtc.AudioFrame` objects into a single `rtc.AudioFrame`.\n *\n * This function concatenates the audio data from multiple frames, ensuring that all frames have\n * the same sample rate and number of channels. It efficiently merges the data by preallocating the\n * necessary memory and copying the frame data without unnecessary reallocations.\n *\n * @param buffer - a single AudioFrame or list thereof\n */\nexport const combineAudioFrames = (buffer: AudioFrame | AudioFrame[]): AudioFrame => {\n  if (!Array.isArray(buffer)) {\n    return buffer;\n  }\n  buffer = buffer as AudioFrame[];\n\n  if (buffer.length === 0) {\n    throw new Error('buffer is empty');\n  }\n\n  const sampleRate = buffer[0]!.sampleRate;\n  const channels = buffer[0]!.channels;\n\n  let totalSamplesPerChannel = 0;\n  for (const frame of buffer) {\n    if (frame.sampleRate != sampleRate) {\n      throw new Error(`sample rate mismatch: expected ${sampleRate}, got ${frame.sampleRate}`);\n    }\n\n    if (frame.channels != channels) {\n      throw new Error(`channel mismatch: expected ${channels}, got ${frame.channels}`);\n    }\n\n    totalSamplesPerChannel += frame.samplesPerChannel;\n  }\n\n  const data = new Int16Array(buffer.map((x) => [...x.data]).flat());\n  return new AudioFrame(data, sampleRate, channels, totalSamplesPerChannel);\n};\n"],"mappings":"AAGA,SAAS,WAAW,iBAAiB;AAErC,SAAS,4BAA4B;AAE9B,MAAM,WAAW;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAatB,YAAY,MAAkB,YAAoB,UAAkB,mBAA2B;AAP/F,SAAQ,YAAqC,CAAC;AAQ5C,SAAK,OAAO;AACZ,SAAK,aAAa;AAClB,SAAK,WAAW;AAChB,SAAK,oBAAoB;AAAA,EAC3B;AAAA,EAEA,OAAO,OAAO,YAAoB,UAAkB,mBAAuC;AACzF,UAAM,OAAO,IAAI,WAAW,WAAW,iBAAiB;AACxD,WAAO,IAAI,WAAW,MAAM,YAAY,UAAU,iBAAiB;AAAA,EACrE;AAAA;AAAA,EAGA,OAAO,cAAc,OAA0C;AAC7D,UAAM,OAAO,MAAM;AACnB,UAAM,MAAM,KAAK,cAAe,KAAK,oBAAqB;AAC1D,UAAM,OAAO,UAAU,SAAS,WAAW,KAAK,SAAU,GAAG;AAC7D,QAAI,UAAU,MAAM,OAAQ,EAAG,EAAE,QAAQ;AACzC,WAAO,IAAI;AAAA,MACT,IAAI,WAAW,KAAK,MAAM;AAAA,MAC1B,KAAK;AAAA,MACL,KAAK;AAAA,MACL,KAAK;AAAA,IACP;AAAA,EACF;AAAA;AAAA,EAGA,YAAkC;AAChC,WAAO,IAAI,qBAAqB;AAAA,MAC9B,SAAS,UAAU,SAAS,YAAY,IAAI,WAAW,KAAK,KAAK,MAAM,CAAC;AAAA,MACxE,YAAY,KAAK;AAAA,MACjB,aAAa,KAAK;AAAA,MAClB,mBAAmB,KAAK;AAAA,IAC1B,CAAC;AAAA,EACH;AAAA;AAAA,EAGA,IAAI,WAAW;AACb,WAAO,KAAK;AAAA,EACd;AACF;AAWO,MAAM,qBAAqB,CAAC,WAAkD;AACnF,MAAI,CAAC,MAAM,QAAQ,MAAM,GAAG;AAC1B,WAAO;AAAA,EACT;AACA,WAAS;AAET,MAAI,OAAO,WAAW,GAAG;AACvB,UAAM,IAAI,MAAM,iBAAiB;AAAA,EACnC;AAEA,QAAM,aAAa,OAAO,CAAC,EAAG;AAC9B,QAAM,WAAW,OAAO,CAAC,EAAG;AAE5B,MAAI,yBAAyB;AAC7B,aAAW,SAAS,QAAQ;AAC1B,QAAI,MAAM,cAAc,YAAY;AAClC,YAAM,IAAI,MAAM,kCAAkC,UAAU,SAAS,MAAM,UAAU,EAAE;AAAA,IACzF;AAEA,QAAI,MAAM,YAAY,UAAU;AAC9B,YAAM,IAAI,MAAM,8BAA8B,QAAQ,SAAS,MAAM,QAAQ,EAAE;AAAA,IACjF;AAEA,8BAA0B,MAAM;AAAA,EAClC;AAEA,QAAM,OAAO,IAAI,WAAW,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,KAAK,CAAC;AACjE,SAAO,IAAI,WAAW,MAAM,YAAY,UAAU,sBAAsB;AAC1E;","names":[]}

package/dist/audio_mixer.cjs

@@ -0,0 +1,281 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var audio_mixer_exports = {};
+__export(audio_mixer_exports, {
+  AsyncQueue: () => import_async_queue2.AsyncQueue,
+  AudioMixer: () => AudioMixer
+});
+module.exports = __toCommonJS(audio_mixer_exports);
+var import_async_queue = require("./async_queue.cjs");
+var import_audio_frame = require("./audio_frame.cjs");
+var import_async_queue2 = require("./async_queue.cjs");
+class AudioMixer {
+  /**
+   * Initialize the AudioMixer.
+   *
+   * @param sampleRate - The audio sample rate in Hz.
+   * @param numChannels - The number of audio channels.
+   * @param options - Optional configuration for the mixer.
+   */
+  constructor(sampleRate, numChannels, options = {}) {
+    this.streams = /* @__PURE__ */ new Set();
+    this.buffers = /* @__PURE__ */ new Map();
+    this.streamIterators = /* @__PURE__ */ new Map();
+    this.sampleRate = sampleRate;
+    this.numChannels = numChannels;
+    this.chunkSize = options.blocksize && options.blocksize > 0 ? options.blocksize : Math.floor(sampleRate / 10);
+    this.streamTimeoutMs = options.streamTimeoutMs ?? 100;
+    this.queue = new import_async_queue.AsyncQueue(options.capacity ?? 100);
+    this.streamSignal = new import_async_queue.AsyncQueue(1);
+    this.ending = false;
+    this.closed = false;
+    this.mixerTask = this.mixer();
+  }
+  /**
+   * Add an audio stream to the mixer.
+   *
+   * The stream is added to the internal set of streams and an empty buffer is initialized for it,
+   * if not already present.
+   *
+   * @param stream - An async iterable that produces AudioFrame objects.
+   * @throws Error if the mixer has been closed.
+   */
+  addStream(stream) {
+    if (this.ending) {
+      throw new Error("Cannot add stream after mixer has been closed");
+    }
+    this.streams.add(stream);
+    if (!this.buffers.has(stream)) {
+      this.buffers.set(stream, new Int16Array(0));
+    }
+    this.streamSignal.put(void 0).catch(() => {
+    });
+  }
+  /**
+   * Remove an audio stream from the mixer.
+   *
+   * This method removes the specified stream and its associated buffer from the mixer.
+   *
+   * @param stream - The audio stream to remove.
+   */
+  removeStream(stream) {
+    this.streams.delete(stream);
+    this.buffers.delete(stream);
+    this.streamIterators.delete(stream);
+  }
+  /**
+   * Returns an async iterator for the mixed audio frames.
+   */
+  [Symbol.asyncIterator]() {
+    return {
+      next: async () => {
+        const frame = await this.getNextFrame();
+        if (frame === null) {
+          return { done: true, value: void 0 };
+        }
+        return { done: false, value: frame };
+      }
+    };
+  }
+  /**
+   * Immediately stop mixing and close the mixer.
+   *
+   * This stops the mixing task, and any unconsumed output in the queue may be dropped.
+   */
+  async aclose() {
+    if (this.closed) {
+      return;
+    }
+    this.closed = true;
+    this.ending = true;
+    this.streamSignal.close();
+    this.queue.close();
+    await this.mixerTask;
+  }
+  /**
+   * Signal that no more streams will be added.
+   *
+   * This method marks the mixer as closed so that it flushes any remaining buffered output before ending.
+   * Note that existing streams will still be processed until exhausted.
+   */
+  endInput() {
+    this.ending = true;
+  }
+  async getNextFrame() {
+    while (true) {
+      const frame = this.queue.get();
+      if (frame !== void 0) {
+        return frame;
+      }
+      if (this.queue.closed || this.ending && this.streams.size === 0) {
+        return null;
+      }
+      await this.queue.waitForItem();
+    }
+  }
+  async mixer() {
+    while (true) {
+      if (this.ending && this.streams.size === 0) {
+        break;
+      }
+      if (this.streams.size === 0) {
+        await this.streamSignal.waitForItem();
+        this.streamSignal.get();
+        continue;
+      }
+      const streamArray = Array.from(this.streams);
+      const promises = streamArray.map((stream) => this.getContribution(stream));
+      const results = await Promise.all(
+        promises.map(
+          (p) => p.then((value) => ({ status: "fulfilled", value })).catch((reason) => ({ status: "rejected", reason }))
+        )
+      );
+      const contributions = [];
+      let anyData = false;
+      const removals = [];
+      for (const result of results) {
+        if (result.status !== "fulfilled") {
+          console.warn("AudioMixer: Stream contribution failed:", result.reason);
+          continue;
+        }
+        const contrib = result.value;
+        contributions.push(contrib.data);
+        this.buffers.set(contrib.stream, contrib.buffer);
+        if (contrib.hadData) {
+          anyData = true;
+        }
+        if (contrib.exhausted && contrib.buffer.length === 0) {
+          removals.push(contrib.stream);
+        }
+      }
+      for (const stream of removals) {
+        this.removeStream(stream);
+      }
+      if (!anyData) {
+        await this.sleep(1);
+        continue;
+      }
+      const mixed = this.mixAudio(contributions);
+      const frame = new import_audio_frame.AudioFrame(mixed, this.sampleRate, this.numChannels, this.chunkSize);
+      if (this.closed) {
+        break;
+      }
+      try {
+        await this.queue.put(frame);
+      } catch {
+        break;
+      }
+    }
+    this.queue.close();
+  }
+  async getContribution(stream) {
+    let buf = this.buffers.get(stream) ?? new Int16Array(0);
+    const initialBufferLength = buf.length;
+    let exhausted = false;
+    let receivedDataInThisCall = false;
+    let iterator = this.streamIterators.get(stream);
+    if (!iterator) {
+      iterator = stream[Symbol.asyncIterator]();
+      this.streamIterators.set(stream, iterator);
+    }
+    while (buf.length < this.chunkSize * this.numChannels && !exhausted && !this.closed) {
+      try {
+        const result = await Promise.race([iterator.next(), this.timeout(this.streamTimeoutMs)]);
+        if (result === "timeout") {
+          console.warn(`AudioMixer: stream timeout after ${this.streamTimeoutMs}ms`);
+          break;
+        }
+        if (result.done) {
+          exhausted = true;
+          break;
+        }
+        const frame = result.value;
+        const newData = frame.data;
+        receivedDataInThisCall = true;
+        if (buf.length === 0) {
+          buf = newData;
+        } else {
+          const combined = new Int16Array(buf.length + newData.length);
+          combined.set(buf);
+          combined.set(newData, buf.length);
+          buf = combined;
+        }
+      } catch (error) {
+        console.error(`AudioMixer: Error reading from stream:`, error);
+        exhausted = true;
+        break;
+      }
+    }
+    let contrib;
+    const samplesNeeded = this.chunkSize * this.numChannels;
+    if (buf.length >= samplesNeeded) {
+      contrib = buf.subarray(0, samplesNeeded);
+      buf = buf.subarray(samplesNeeded);
+    } else {
+      const padded = new Int16Array(samplesNeeded);
+      padded.set(buf);
+      contrib = padded;
+      buf = new Int16Array(0);
+    }
+    const hadData = initialBufferLength > 0 || receivedDataInThisCall || buf.length > 0;
+    return {
+      stream,
+      data: contrib,
+      buffer: buf,
+      hadData,
+      exhausted
+    };
+  }
+  mixAudio(contributions) {
+    if (contributions.length === 0) {
+      return new Int16Array(this.chunkSize * this.numChannels);
+    }
+    const length = this.chunkSize * this.numChannels;
+    const mixed = new Int16Array(length);
+    for (const contrib of contributions) {
+      for (let i = 0; i < length; i++) {
+        const val = contrib[i];
+        if (val !== void 0) {
+          mixed[i] = (mixed[i] ?? 0) + val;
+        }
+      }
+    }
+    for (let i = 0; i < length; i++) {
+      const val = mixed[i] ?? 0;
+      if (val > 32767) {
+        mixed[i] = 32767;
+      } else if (val < -32768) {
+        mixed[i] = -32768;
+      }
+    }
+    return mixed;
+  }
+  sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+  }
+  timeout(ms) {
+    return new Promise((resolve) => setTimeout(() => resolve("timeout"), ms));
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  AsyncQueue,
+  AudioMixer
+});
+//# sourceMappingURL=audio_mixer.cjs.map