@harmonia-audio/codec 0.1.0

package/dist/index.cjs

@@ -0,0 +1,526 @@
+'use strict';
+
+var native = require('@harmonia-audio/native');
+var stream = require('stream');
+
+// src/encoder.ts
+
+// src/errors.ts
+var HarmoniaCodecError = class extends Error {
+  /**
+   * Machine-readable error code.
+   */
+  code;
+  /**
+   * Additional context about the error.
+   */
+  context;
+  constructor(code, message, context = {}) {
+    super(message);
+    this.name = "HarmoniaCodecError";
+    this.code = code;
+    this.context = context;
+  }
+};
+
+// src/encoder.ts
+var APPLICATION_MAP = {
+  voip: "Voip",
+  audio: "Audio",
+  restricted_lowdelay: "RestrictedLowDelay"
+};
+var OpusEncoder = class {
+  native;
+  _sampleRate;
+  _channels;
+  _application;
+  constructor(options) {
+    this._sampleRate = options.sampleRate;
+    this._channels = options.channels;
+    this._application = options.application;
+    try {
+      this.native = new native.OpusEncoder(
+        options.sampleRate,
+        options.channels,
+        APPLICATION_MAP[options.application]
+      );
+    } catch (error) {
+      throw new HarmoniaCodecError(
+        "ENCODER_INIT_FAILED",
+        `Failed to create Opus encoder: ${error instanceof Error ? error.message : String(error)}`,
+        { sampleRate: options.sampleRate, channels: options.channels }
+      );
+    }
+    if (options.bitrate !== void 0) {
+      this.setBitrate(options.bitrate);
+    }
+    if (options.complexity !== void 0) {
+      this.setComplexity(options.complexity);
+    }
+    if (options.fec !== void 0) {
+      this.setFec(options.fec);
+    }
+    if (options.packetLossPercent !== void 0) {
+      this.setPacketLossPercent(options.packetLossPercent);
+    }
+    if (options.dtx !== void 0) {
+      this.setDtx(options.dtx);
+    }
+    if (options.vbr !== void 0) {
+      this.setVbr(options.vbr);
+    }
+    if (options.signal !== void 0) {
+      this.setSignal(options.signal);
+    }
+  }
+  /**
+   * Encode 16-bit PCM audio to Opus.
+   *
+   * @param pcm - Buffer containing interleaved 16-bit signed integer PCM samples
+   * @returns Encoded Opus packet
+   *
+   * @example
+   * ```ts
+   * const opus = encoder.encode(pcmBuffer);
+   * ```
+   */
+  encode(pcm) {
+    try {
+      return this.native.encode(pcm);
+    } catch (error) {
+      throw new HarmoniaCodecError(
+        "ENCODE_FAILED",
+        `Opus encode failed: ${error instanceof Error ? error.message : String(error)}`,
+        { inputSize: pcm.length }
+      );
+    }
+  }
+  /**
+   * Encode 32-bit float PCM audio to Opus.
+   *
+   * @param pcm - Buffer containing interleaved 32-bit float PCM samples
+   * @returns Encoded Opus packet
+   *
+   * @example
+   * ```ts
+   * const opus = encoder.encodeFloat(floatPcmBuffer);
+   * ```
+   */
+  encodeFloat(pcm) {
+    try {
+      return this.native.encodeFloat(pcm);
+    } catch (error) {
+      throw new HarmoniaCodecError(
+        "ENCODE_FLOAT_FAILED",
+        `Opus float encode failed: ${error instanceof Error ? error.message : String(error)}`,
+        { inputSize: pcm.length }
+      );
+    }
+  }
+  /**
+   * Set the encoder bitrate in bits per second.
+   *
+   * @example
+   * ```ts
+   * encoder.setBitrate(128000);
+   * ```
+   */
+  setBitrate(bitrate) {
+    this.native.setBitrate(bitrate);
+  }
+  /**
+   * Get the current encoder bitrate.
+   *
+   * @example
+   * ```ts
+   * const bitrate = encoder.getBitrate();
+   * ```
+   */
+  getBitrate() {
+    return this.native.getBitrate();
+  }
+  /**
+   * Set encoding complexity (0-10, higher = better quality but slower).
+   *
+   * @example
+   * ```ts
+   * encoder.setComplexity(10);
+   * ```
+   */
+  setComplexity(complexity) {
+    this.native.setComplexity(complexity);
+  }
+  /**
+   * Get the current encoding complexity.
+   *
+   * @example
+   * ```ts
+   * const complexity = encoder.getComplexity();
+   * ```
+   */
+  getComplexity() {
+    return this.native.getComplexity();
+  }
+  /**
+   * Enable or disable forward error correction.
+   *
+   * @example
+   * ```ts
+   * encoder.setFec(true);
+   * ```
+   */
+  setFec(enabled) {
+    this.native.setFec(enabled);
+  }
+  /**
+   * Check if FEC is enabled.
+   *
+   * @example
+   * ```ts
+   * const fecEnabled = encoder.getFec();
+   * ```
+   */
+  getFec() {
+    return this.native.getFec();
+  }
+  /**
+   * Set expected packet loss percentage for FEC optimization.
+   *
+   * @example
+   * ```ts
+   * encoder.setPacketLossPercent(10);
+   * ```
+   */
+  setPacketLossPercent(percent) {
+    this.native.setPacketLossPercent(percent);
+  }
+  /**
+   * Enable or disable discontinuous transmission.
+   *
+   * @example
+   * ```ts
+   * encoder.setDtx(true);
+   * ```
+   */
+  setDtx(enabled) {
+    this.native.setDtx(enabled);
+  }
+  /**
+   * Enable or disable variable bitrate.
+   *
+   * @example
+   * ```ts
+   * encoder.setVbr(true);
+   * ```
+   */
+  setVbr(enabled) {
+    this.native.setVbr(enabled);
+  }
+  /**
+   * Set the signal type hint.
+   *
+   * @example
+   * ```ts
+   * encoder.setSignal('music');
+   * ```
+   */
+  setSignal(signal) {
+    this.native.setSignal(signal);
+  }
+  /**
+   * Reset the encoder state.
+   *
+   * @example
+   * ```ts
+   * encoder.reset();
+   * ```
+   */
+  reset() {
+    this.native.reset();
+  }
+  /** The sample rate this encoder operates at. */
+  get sampleRate() {
+    return this._sampleRate;
+  }
+  /** The number of channels this encoder operates with. */
+  get channels() {
+    return this._channels;
+  }
+  /** The application mode this encoder was configured with. */
+  get application() {
+    return this._application;
+  }
+};
+var OpusDecoder = class {
+  native;
+  _sampleRate;
+  _channels;
+  constructor(options) {
+    this._sampleRate = options.sampleRate;
+    this._channels = options.channels;
+    try {
+      this.native = new native.OpusDecoder(options.sampleRate, options.channels);
+    } catch (error) {
+      throw new HarmoniaCodecError(
+        "DECODER_INIT_FAILED",
+        `Failed to create Opus decoder: ${error instanceof Error ? error.message : String(error)}`,
+        { sampleRate: options.sampleRate, channels: options.channels }
+      );
+    }
+  }
+  /**
+   * Decode an Opus packet to 16-bit PCM.
+   *
+   * @param opusData - The Opus-encoded packet
+   * @returns Buffer containing decoded 16-bit PCM samples
+   *
+   * @example
+   * ```ts
+   * const pcm = decoder.decode(opusPacket);
+   * ```
+   */
+  decode(opusData) {
+    try {
+      return this.native.decode(opusData);
+    } catch (error) {
+      throw new HarmoniaCodecError(
+        "DECODE_FAILED",
+        `Opus decode failed: ${error instanceof Error ? error.message : String(error)}`,
+        { inputSize: opusData.length }
+      );
+    }
+  }
+  /**
+   * Decode an Opus packet to 32-bit float PCM.
+   *
+   * @param opusData - The Opus-encoded packet
+   * @returns Buffer containing decoded 32-bit float PCM samples
+   *
+   * @example
+   * ```ts
+   * const pcm = decoder.decodeFloat(opusPacket);
+   * ```
+   */
+  decodeFloat(opusData) {
+    try {
+      return this.native.decodeFloat(opusData);
+    } catch (error) {
+      throw new HarmoniaCodecError(
+        "DECODE_FLOAT_FAILED",
+        `Opus float decode failed: ${error instanceof Error ? error.message : String(error)}`,
+        { inputSize: opusData.length }
+      );
+    }
+  }
+  /**
+   * Decode with forward error correction from a previous packet.
+   *
+   * @param opusData - The Opus packet to attempt FEC recovery from
+   * @param frameSize - Number of samples per channel expected
+   * @returns Buffer containing recovered PCM
+   *
+   * @example
+   * ```ts
+   * const recovered = decoder.decodeFec(previousPacket, 960);
+   * ```
+   */
+  decodeFec(opusData, frameSize) {
+    try {
+      return this.native.decodeFec(opusData, frameSize);
+    } catch (error) {
+      throw new HarmoniaCodecError(
+        "DECODE_FEC_FAILED",
+        `Opus FEC decode failed: ${error instanceof Error ? error.message : String(error)}`,
+        { inputSize: opusData.length, frameSize }
+      );
+    }
+  }
+  /**
+   * Perform packet loss concealment (no input packet available).
+   *
+   * @param frameSize - Number of samples per channel to generate
+   * @returns Buffer containing concealed PCM
+   *
+   * @example
+   * ```ts
+   * const concealed = decoder.decodePlc(960);
+   * ```
+   */
+  decodePlc(frameSize) {
+    try {
+      return this.native.decodePlc(frameSize);
+    } catch (error) {
+      throw new HarmoniaCodecError(
+        "PLC_FAILED",
+        `Opus PLC failed: ${error instanceof Error ? error.message : String(error)}`,
+        { frameSize }
+      );
+    }
+  }
+  /**
+   * Reset the decoder state.
+   *
+   * @example
+   * ```ts
+   * decoder.reset();
+   * ```
+   */
+  reset() {
+    this.native.reset();
+  }
+  /** The sample rate this decoder operates at. */
+  get sampleRate() {
+    return this._sampleRate;
+  }
+  /** The number of channels this decoder produces. */
+  get channels() {
+    return this._channels;
+  }
+};
+
+// src/constants.ts
+var OPUS_SAMPLE_RATES = [8e3, 12e3, 16e3, 24e3, 48e3];
+var OPUS_CHANNELS = [1, 2];
+var OPUS_FRAME_DURATIONS = [2.5, 5, 10, 20, 40, 60];
+var DISCORD_OPUS_SAMPLE_RATE = 48e3;
+var DISCORD_OPUS_CHANNELS = 2;
+var DISCORD_OPUS_FRAME_DURATION = 20;
+var DISCORD_OPUS_FRAME_SIZE = 960;
+
+// src/streams.ts
+var OpusEncoderStream = class extends stream.Transform {
+  encoder;
+  frameSize;
+  frameSizeBytes;
+  pendingBuffer;
+  constructor(options) {
+    super({
+      readableObjectMode: true
+    });
+    this.encoder = new OpusEncoder(options);
+    this.frameSize = DISCORD_OPUS_FRAME_SIZE;
+    this.frameSizeBytes = this.frameSize * options.channels * 2;
+    this.pendingBuffer = Buffer.alloc(0);
+  }
+  _transform(chunk, _encoding, callback) {
+    this.pendingBuffer = Buffer.concat([this.pendingBuffer, chunk]);
+    while (this.pendingBuffer.length >= this.frameSizeBytes) {
+      const frame = this.pendingBuffer.subarray(0, this.frameSizeBytes);
+      this.pendingBuffer = this.pendingBuffer.subarray(this.frameSizeBytes);
+      try {
+        const encoded = this.encoder.encode(frame);
+        this.push(encoded);
+      } catch (error) {
+        callback(error instanceof Error ? error : new Error(String(error)));
+        return;
+      }
+    }
+    callback();
+  }
+  _flush(callback) {
+    if (this.pendingBuffer.length > 0) {
+      const padded = Buffer.alloc(this.frameSizeBytes);
+      this.pendingBuffer.copy(padded);
+      try {
+        const encoded = this.encoder.encode(padded);
+        this.push(encoded);
+      } catch (error) {
+        callback(error instanceof Error ? error : new Error(String(error)));
+        return;
+      }
+    }
+    callback();
+  }
+};
+var OpusDecoderStream = class extends stream.Transform {
+  decoder;
+  constructor(options) {
+    super({
+      writableObjectMode: true
+    });
+    this.decoder = new OpusDecoder(options);
+  }
+  _transform(chunk, _encoding, callback) {
+    try {
+      const decoded = this.decoder.decode(chunk);
+      this.push(decoded);
+      callback();
+    } catch (error) {
+      callback(error instanceof Error ? error : new Error(String(error)));
+    }
+  }
+};
+var OpusPacket = class {
+  /**
+   * Get the number of channels from an Opus packet header.
+   *
+   * @example
+   * ```ts
+   * const channels = OpusPacket.getChannels(opusPacket);
+   * ```
+   */
+  static getChannels(packet) {
+    try {
+      return native.opusPacketGetNbChannelsNative(packet);
+    } catch (error) {
+      throw new HarmoniaCodecError(
+        "PACKET_INSPECT_FAILED",
+        `Failed to get channels: ${error instanceof Error ? error.message : String(error)}`
+      );
+    }
+  }
+  /**
+   * Get the number of frames in an Opus packet.
+   *
+   * @example
+   * ```ts
+   * const frameCount = OpusPacket.getFrameCount(opusPacket);
+   * ```
+   */
+  static getFrameCount(packet) {
+    try {
+      return native.opusPacketGetNbFramesNative(packet);
+    } catch (error) {
+      throw new HarmoniaCodecError(
+        "PACKET_INSPECT_FAILED",
+        `Failed to get frame count: ${error instanceof Error ? error.message : String(error)}`
+      );
+    }
+  }
+  /**
+   * Get samples per frame for a given sample rate.
+   *
+   * @example
+   * ```ts
+   * const spf = OpusPacket.getSamplesPerFrame(opusPacket, 48000);
+   * ```
+   */
+  static getSamplesPerFrame(packet, sampleRate) {
+    try {
+      return native.opusPacketGetSamplesPerFrameNative(packet, sampleRate);
+    } catch (error) {
+      throw new HarmoniaCodecError(
+        "PACKET_INSPECT_FAILED",
+        `Failed to get samples per frame: ${error instanceof Error ? error.message : String(error)}`
+      );
+    }
+  }
+  constructor() {
+  }
+};
+
+exports.DISCORD_OPUS_CHANNELS = DISCORD_OPUS_CHANNELS;
+exports.DISCORD_OPUS_FRAME_DURATION = DISCORD_OPUS_FRAME_DURATION;
+exports.DISCORD_OPUS_FRAME_SIZE = DISCORD_OPUS_FRAME_SIZE;
+exports.DISCORD_OPUS_SAMPLE_RATE = DISCORD_OPUS_SAMPLE_RATE;
+exports.HarmoniaCodecError = HarmoniaCodecError;
+exports.OPUS_CHANNELS = OPUS_CHANNELS;
+exports.OPUS_FRAME_DURATIONS = OPUS_FRAME_DURATIONS;
+exports.OPUS_SAMPLE_RATES = OPUS_SAMPLE_RATES;
+exports.OpusDecoder = OpusDecoder;
+exports.OpusDecoderStream = OpusDecoderStream;
+exports.OpusEncoder = OpusEncoder;
+exports.OpusEncoderStream = OpusEncoderStream;
+exports.OpusPacket = OpusPacket;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/errors.ts","../src/encoder.ts","../src/decoder.ts","../src/constants.ts","../src/streams.ts","../src/packet.ts"],"names":["NativeOpusEncoder","NativeOpusDecoder","Transform","opusPacketGetNbChannelsNative","opusPacketGetNbFramesNative","opusPacketGetSamplesPerFrameNative"],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * Error thrown by Opus codec operations.\n *\n * @example\n * ```ts\n * try {\n *   encoder.encode(buffer);\n * } catch (error) {\n *   if (error instanceof HarmoniaCodecError) {\n *     console.error(error.code, error.message);\n *   }\n * }\n * ```\n */\nexport class HarmoniaCodecError extends Error {\n\t/**\n\t * Machine-readable error code.\n\t */\n\tpublic readonly code: string;\n\n\t/**\n\t * Additional context about the error.\n\t */\n\tpublic readonly context: Record<string, unknown>;\n\n\tconstructor(\n\t\tcode: string,\n\t\tmessage: string,\n\t\tcontext: Record<string, unknown> = {},\n\t) {\n\t\tsuper(message);\n\t\tthis.name = \"HarmoniaCodecError\";\n\t\tthis.code = code;\n\t\tthis.context = context;\n\t}\n}\n","import {\n\tOpusEncoder as NativeOpusEncoder,\n} from \"@harmonia-audio/native\";\nimport type { OpusApplication, OpusEncoderOptions, OpusSignalType } from \"./constants.js\";\nimport { HarmoniaCodecError } from \"./errors.js\";\n\nconst APPLICATION_MAP: Record<OpusApplication, string> = {\n\tvoip: \"Voip\",\n\taudio: \"Audio\",\n\trestricted_lowdelay: \"RestrictedLowDelay\",\n} as const;\n\n/**\n * High-performance Opus encoder backed by native Rust bindings.\n *\n * @example\n * ```ts\n * import { OpusEncoder } from '@harmonia/codec';\n *\n * const encoder = new OpusEncoder({\n *   sampleRate: 48000,\n *   channels: 2,\n *   application: 'audio',\n * });\n *\n * const encoded = encoder.encode(pcmBuffer);\n * ```\n */\nexport class OpusEncoder {\n\tprivate readonly native: NativeOpusEncoder;\n\tprivate readonly _sampleRate: number;\n\tprivate readonly _channels: number;\n\tprivate readonly _application: OpusApplication;\n\n\tconstructor(options: OpusEncoderOptions) {\n\t\tthis._sampleRate = options.sampleRate;\n\t\tthis._channels = options.channels;\n\t\tthis._application = options.application;\n\n\t\ttry {\n\t\t\tthis.native = new NativeOpusEncoder(\n\t\t\t\toptions.sampleRate,\n\t\t\t\toptions.channels,\n\t\t\t\tAPPLICATION_MAP[options.application] as \"Voip\" | \"Audio\" | \"RestrictedLowDelay\",\n\t\t\t);\n\t\t} catch (error) {\n\t\t\tthrow new HarmoniaCodecError(\n\t\t\t\t\"ENCODER_INIT_FAILED\",\n\t\t\t\t`Failed to create Opus encoder: ${error instanceof Error ? error.message : String(error)}`,\n\t\t\t\t{ sampleRate: options.sampleRate, channels: options.channels },\n\t\t\t);\n\t\t}\n\n\t\tif (options.bitrate !== undefined) {\n\t\t\tthis.setBitrate(options.bitrate);\n\t\t}\n\t\tif (options.complexity !== undefined) {\n\t\t\tthis.setComplexity(options.complexity);\n\t\t}\n\t\tif (options.fec !== undefined) {\n\t\t\tthis.setFec(options.fec);\n\t\t}\n\t\tif (options.packetLossPercent !== undefined) {\n\t\t\tthis.setPacketLossPercent(options.packetLossPercent);\n\t\t}\n\t\tif (options.dtx !== undefined) {\n\t\t\tthis.setDtx(options.dtx);\n\t\t}\n\t\tif (options.vbr !== undefined) {\n\t\t\tthis.setVbr(options.vbr);\n\t\t}\n\t\tif (options.signal !== undefined) {\n\t\t\tthis.setSignal(options.signal);\n\t\t}\n\t}\n\n\t/**\n\t * Encode 16-bit PCM audio to Opus.\n\t *\n\t * @param pcm - Buffer containing interleaved 16-bit signed integer PCM samples\n\t * @returns Encoded Opus packet\n\t *\n\t * @example\n\t * ```ts\n\t * const opus = encoder.encode(pcmBuffer);\n\t * ```\n\t */\n\tencode(pcm: Buffer): Buffer {\n\t\ttry {\n\t\t\treturn this.native.encode(pcm);\n\t\t} catch (error) {\n\t\t\tthrow new HarmoniaCodecError(\n\t\t\t\t\"ENCODE_FAILED\",\n\t\t\t\t`Opus encode failed: ${error instanceof Error ? error.message : String(error)}`,\n\t\t\t\t{ inputSize: pcm.length },\n\t\t\t);\n\t\t}\n\t}\n\n\t/**\n\t * Encode 32-bit float PCM audio to Opus.\n\t *\n\t * @param pcm - Buffer containing interleaved 32-bit float PCM samples\n\t * @returns Encoded Opus packet\n\t *\n\t * @example\n\t * ```ts\n\t * const opus = encoder.encodeFloat(floatPcmBuffer);\n\t * ```\n\t */\n\tencodeFloat(pcm: Buffer): Buffer {\n\t\ttry {\n\t\t\treturn this.native.encodeFloat(pcm);\n\t\t} catch (error) {\n\t\t\tthrow new HarmoniaCodecError(\n\t\t\t\t\"ENCODE_FLOAT_FAILED\",\n\t\t\t\t`Opus float encode failed: ${error instanceof Error ? error.message : String(error)}`,\n\t\t\t\t{ inputSize: pcm.length },\n\t\t\t);\n\t\t}\n\t}\n\n\t/**\n\t * Set the encoder bitrate in bits per second.\n\t *\n\t * @example\n\t * ```ts\n\t * encoder.setBitrate(128000);\n\t * ```\n\t */\n\tsetBitrate(bitrate: number): void {\n\t\tthis.native.setBitrate(bitrate);\n\t}\n\n\t/**\n\t * Get the current encoder bitrate.\n\t *\n\t * @example\n\t * ```ts\n\t * const bitrate = encoder.getBitrate();\n\t * ```\n\t */\n\tgetBitrate(): number {\n\t\treturn this.native.getBitrate();\n\t}\n\n\t/**\n\t * Set encoding complexity (0-10, higher = better quality but slower).\n\t *\n\t * @example\n\t * ```ts\n\t * encoder.setComplexity(10);\n\t * ```\n\t */\n\tsetComplexity(complexity: number): void {\n\t\tthis.native.setComplexity(complexity);\n\t}\n\n\t/**\n\t * Get the current encoding complexity.\n\t *\n\t * @example\n\t * ```ts\n\t * const complexity = encoder.getComplexity();\n\t * ```\n\t */\n\tgetComplexity(): number {\n\t\treturn this.native.getComplexity();\n\t}\n\n\t/**\n\t * Enable or disable forward error correction.\n\t *\n\t * @example\n\t * ```ts\n\t * encoder.setFec(true);\n\t * ```\n\t */\n\tsetFec(enabled: boolean): void {\n\t\tthis.native.setFec(enabled);\n\t}\n\n\t/**\n\t * Check if FEC is enabled.\n\t *\n\t * @example\n\t * ```ts\n\t * const fecEnabled = encoder.getFec();\n\t * ```\n\t */\n\tgetFec(): boolean {\n\t\treturn this.native.getFec();\n\t}\n\n\t/**\n\t * Set expected packet loss percentage for FEC optimization.\n\t *\n\t * @example\n\t * ```ts\n\t * encoder.setPacketLossPercent(10);\n\t * ```\n\t */\n\tsetPacketLossPercent(percent: number): void {\n\t\tthis.native.setPacketLossPercent(percent);\n\t}\n\n\t/**\n\t * Enable or disable discontinuous transmission.\n\t *\n\t * @example\n\t * ```ts\n\t * encoder.setDtx(true);\n\t * ```\n\t */\n\tsetDtx(enabled: boolean): void {\n\t\tthis.native.setDtx(enabled);\n\t}\n\n\t/**\n\t * Enable or disable variable bitrate.\n\t *\n\t * @example\n\t * ```ts\n\t * encoder.setVbr(true);\n\t * ```\n\t */\n\tsetVbr(enabled: boolean): void {\n\t\tthis.native.setVbr(enabled);\n\t}\n\n\t/**\n\t * Set the signal type hint.\n\t *\n\t * @example\n\t * ```ts\n\t * encoder.setSignal('music');\n\t * ```\n\t */\n\tsetSignal(signal: OpusSignalType): void {\n\t\tthis.native.setSignal(signal);\n\t}\n\n\t/**\n\t * Reset the encoder state.\n\t *\n\t * @example\n\t * ```ts\n\t * encoder.reset();\n\t * ```\n\t */\n\treset(): void {\n\t\tthis.native.reset();\n\t}\n\n\t/** The sample rate this encoder operates at. */\n\tget sampleRate(): number {\n\t\treturn this._sampleRate;\n\t}\n\n\t/** The number of channels this encoder operates with. */\n\tget channels(): number {\n\t\treturn this._channels;\n\t}\n\n\t/** The application mode this encoder was configured with. */\n\tget application(): OpusApplication {\n\t\treturn this._application;\n\t}\n}\n","import { OpusDecoder as NativeOpusDecoder } from \"@harmonia-audio/native\";\nimport type { OpusDecoderOptions } from \"./constants.js\";\nimport { HarmoniaCodecError } from \"./errors.js\";\n\n/**\n * High-performance Opus decoder backed by native Rust bindings.\n *\n * @example\n * ```ts\n * import { OpusDecoder } from '@harmonia/codec';\n *\n * const decoder = new OpusDecoder({ sampleRate: 48000, channels: 2 });\n * const pcm = decoder.decode(opusPacket);\n * ```\n */\nexport class OpusDecoder {\n\tprivate readonly native: NativeOpusDecoder;\n\tprivate readonly _sampleRate: number;\n\tprivate readonly _channels: number;\n\n\tconstructor(options: OpusDecoderOptions) {\n\t\tthis._sampleRate = options.sampleRate;\n\t\tthis._channels = options.channels;\n\n\t\ttry {\n\t\t\tthis.native = new NativeOpusDecoder(options.sampleRate, options.channels);\n\t\t} catch (error) {\n\t\t\tthrow new HarmoniaCodecError(\n\t\t\t\t\"DECODER_INIT_FAILED\",\n\t\t\t\t`Failed to create Opus decoder: ${error instanceof Error ? error.message : String(error)}`,\n\t\t\t\t{ sampleRate: options.sampleRate, channels: options.channels },\n\t\t\t);\n\t\t}\n\t}\n\n\t/**\n\t * Decode an Opus packet to 16-bit PCM.\n\t *\n\t * @param opusData - The Opus-encoded packet\n\t * @returns Buffer containing decoded 16-bit PCM samples\n\t *\n\t * @example\n\t * ```ts\n\t * const pcm = decoder.decode(opusPacket);\n\t * ```\n\t */\n\tdecode(opusData: Buffer): Buffer {\n\t\ttry {\n\t\t\treturn this.native.decode(opusData);\n\t\t} catch (error) {\n\t\t\tthrow new HarmoniaCodecError(\n\t\t\t\t\"DECODE_FAILED\",\n\t\t\t\t`Opus decode failed: ${error instanceof Error ? error.message : String(error)}`,\n\t\t\t\t{ inputSize: opusData.length },\n\t\t\t);\n\t\t}\n\t}\n\n\t/**\n\t * Decode an Opus packet to 32-bit float PCM.\n\t *\n\t * @param opusData - The Opus-encoded packet\n\t * @returns Buffer containing decoded 32-bit float PCM samples\n\t *\n\t * @example\n\t * ```ts\n\t * const pcm = decoder.decodeFloat(opusPacket);\n\t * ```\n\t */\n\tdecodeFloat(opusData: Buffer): Buffer {\n\t\ttry {\n\t\t\treturn this.native.decodeFloat(opusData);\n\t\t} catch (error) {\n\t\t\tthrow new HarmoniaCodecError(\n\t\t\t\t\"DECODE_FLOAT_FAILED\",\n\t\t\t\t`Opus float decode failed: ${error instanceof Error ? error.message : String(error)}`,\n\t\t\t\t{ inputSize: opusData.length },\n\t\t\t);\n\t\t}\n\t}\n\n\t/**\n\t * Decode with forward error correction from a previous packet.\n\t *\n\t * @param opusData - The Opus packet to attempt FEC recovery from\n\t * @param frameSize - Number of samples per channel expected\n\t * @returns Buffer containing recovered PCM\n\t *\n\t * @example\n\t * ```ts\n\t * const recovered = decoder.decodeFec(previousPacket, 960);\n\t * ```\n\t */\n\tdecodeFec(opusData: Buffer, frameSize: number): Buffer {\n\t\ttry {\n\t\t\treturn this.native.decodeFec(opusData, frameSize);\n\t\t} catch (error) {\n\t\t\tthrow new HarmoniaCodecError(\n\t\t\t\t\"DECODE_FEC_FAILED\",\n\t\t\t\t`Opus FEC decode failed: ${error instanceof Error ? error.message : String(error)}`,\n\t\t\t\t{ inputSize: opusData.length, frameSize },\n\t\t\t);\n\t\t}\n\t}\n\n\t/**\n\t * Perform packet loss concealment (no input packet available).\n\t *\n\t * @param frameSize - Number of samples per channel to generate\n\t * @returns Buffer containing concealed PCM\n\t *\n\t * @example\n\t * ```ts\n\t * const concealed = decoder.decodePlc(960);\n\t * ```\n\t */\n\tdecodePlc(frameSize: number): Buffer {\n\t\ttry {\n\t\t\treturn this.native.decodePlc(frameSize);\n\t\t} catch (error) {\n\t\t\tthrow new HarmoniaCodecError(\n\t\t\t\t\"PLC_FAILED\",\n\t\t\t\t`Opus PLC failed: ${error instanceof Error ? error.message : String(error)}`,\n\t\t\t\t{ frameSize },\n\t\t\t);\n\t\t}\n\t}\n\n\t/**\n\t * Reset the decoder state.\n\t *\n\t * @example\n\t * ```ts\n\t * decoder.reset();\n\t * ```\n\t */\n\treset(): void {\n\t\tthis.native.reset();\n\t}\n\n\t/** The sample rate this decoder operates at. */\n\tget sampleRate(): number {\n\t\treturn this._sampleRate;\n\t}\n\n\t/** The number of channels this decoder produces. */\n\tget channels(): number {\n\t\treturn this._channels;\n\t}\n}\n","/**\n * Opus application modes.\n *\n * @example\n * ```ts\n * const encoder = new OpusEncoder({\n *   sampleRate: 48000,\n *   channels: 2,\n *   application: 'audio',\n * });\n * ```\n */\nexport type OpusApplication = \"voip\" | \"audio\" | \"restricted_lowdelay\";\n\n/**\n * Opus signal type hints.\n *\n * @example\n * ```ts\n * encoder.setSignal('music');\n * ```\n */\nexport type OpusSignalType = \"voice\" | \"music\";\n\n/**\n * Configuration options for creating an Opus encoder.\n *\n * @example\n * ```ts\n * const options: OpusEncoderOptions = {\n *   sampleRate: 48000,\n *   channels: 2,\n *   application: 'audio',\n *   bitrate: 128000,\n * };\n * ```\n */\nexport interface OpusEncoderOptions {\n\treadonly sampleRate: (typeof OPUS_SAMPLE_RATES)[number];\n\treadonly channels: (typeof OPUS_CHANNELS)[number];\n\treadonly application: OpusApplication;\n\treadonly bitrate?: number;\n\treadonly complexity?: number;\n\treadonly fec?: boolean;\n\treadonly packetLossPercent?: number;\n\treadonly dtx?: boolean;\n\treadonly vbr?: boolean;\n\treadonly signal?: OpusSignalType;\n}\n\n/**\n * Configuration options for creating an Opus decoder.\n *\n * @example\n * ```ts\n * const decoder = new OpusDecoder({ sampleRate: 48000, channels: 2 });\n * ```\n */\nexport interface OpusDecoderOptions {\n\treadonly sampleRate: (typeof OPUS_SAMPLE_RATES)[number];\n\treadonly channels: (typeof OPUS_CHANNELS)[number];\n}\n\n/** Valid Opus sample rates. */\nexport const OPUS_SAMPLE_RATES = [8000, 12000, 16000, 24000, 48000] as const;\n\n/** Valid Opus channel counts. */\nexport const OPUS_CHANNELS = [1, 2] as const;\n\n/** Valid Opus frame durations in milliseconds. */\nexport const OPUS_FRAME_DURATIONS = [2.5, 5, 10, 20, 40, 60] as const;\n\n/** Discord's required Opus sample rate. */\nexport const DISCORD_OPUS_SAMPLE_RATE = 48000 as const;\n\n/** Discord's required Opus channel count (stereo). */\nexport const DISCORD_OPUS_CHANNELS = 2 as const;\n\n/** Discord's standard Opus frame duration in milliseconds. */\nexport const DISCORD_OPUS_FRAME_DURATION = 20 as const;\n\n/** Discord Opus frame size in samples per channel. */\nexport const DISCORD_OPUS_FRAME_SIZE = 960 as const;\n","import { Transform, type TransformCallback } from \"node:stream\";\nimport { OpusDecoder } from \"./decoder.js\";\nimport { OpusEncoder } from \"./encoder.js\";\nimport type { OpusApplication, OpusDecoderOptions, OpusEncoderOptions } from \"./constants.js\";\nimport { DISCORD_OPUS_FRAME_SIZE } from \"./constants.js\";\n\n/**\n * Transform stream that encodes PCM to Opus.\n *\n * @example\n * ```ts\n * import { OpusEncoderStream } from '@harmonia/codec';\n *\n * const stream = new OpusEncoderStream({\n *   sampleRate: 48000,\n *   channels: 2,\n *   application: 'audio',\n * });\n *\n * pcmSource.pipe(stream).on('data', (opusPacket) => {\n *   // handle encoded packet\n * });\n * ```\n */\nexport class OpusEncoderStream extends Transform {\n\tprivate readonly encoder: OpusEncoder;\n\tprivate readonly frameSize: number;\n\tprivate readonly frameSizeBytes: number;\n\tprivate pendingBuffer: Buffer;\n\n\tconstructor(options: OpusEncoderOptions) {\n\t\tsuper({\n\t\t\treadableObjectMode: true,\n\t\t});\n\t\tthis.encoder = new OpusEncoder(options);\n\t\tthis.frameSize = DISCORD_OPUS_FRAME_SIZE;\n\t\tthis.frameSizeBytes = this.frameSize * options.channels * 2;\n\t\tthis.pendingBuffer = Buffer.alloc(0);\n\t}\n\n\toverride _transform(\n\t\tchunk: Buffer,\n\t\t_encoding: BufferEncoding,\n\t\tcallback: TransformCallback,\n\t): void {\n\t\tthis.pendingBuffer = Buffer.concat([this.pendingBuffer, chunk]);\n\n\t\twhile (this.pendingBuffer.length >= this.frameSizeBytes) {\n\t\t\tconst frame = this.pendingBuffer.subarray(0, this.frameSizeBytes);\n\t\t\tthis.pendingBuffer = this.pendingBuffer.subarray(this.frameSizeBytes);\n\n\t\t\ttry {\n\t\t\t\tconst encoded = this.encoder.encode(frame);\n\t\t\t\tthis.push(encoded);\n\t\t\t} catch (error) {\n\t\t\t\tcallback(error instanceof Error ? error : new Error(String(error)));\n\t\t\t\treturn;\n\t\t\t}\n\t\t}\n\n\t\tcallback();\n\t}\n\n\toverride _flush(callback: TransformCallback): void {\n\t\tif (this.pendingBuffer.length > 0) {\n\t\t\tconst padded = Buffer.alloc(this.frameSizeBytes);\n\t\t\tthis.pendingBuffer.copy(padded);\n\t\t\ttry {\n\t\t\t\tconst encoded = this.encoder.encode(padded);\n\t\t\t\tthis.push(encoded);\n\t\t\t} catch (error) {\n\t\t\t\tcallback(error instanceof Error ? error : new Error(String(error)));\n\t\t\t\treturn;\n\t\t\t}\n\t\t}\n\t\tcallback();\n\t}\n}\n\n/**\n * Transform stream that decodes Opus to PCM.\n *\n * @example\n * ```ts\n * import { OpusDecoderStream } from '@harmonia/codec';\n *\n * const stream = new OpusDecoderStream({ sampleRate: 48000, channels: 2 });\n *\n * opusSource.pipe(stream).on('data', (pcm) => {\n *   // handle decoded PCM\n * });\n * ```\n */\nexport class OpusDecoderStream extends Transform {\n\tprivate readonly decoder: OpusDecoder;\n\n\tconstructor(options: OpusDecoderOptions) {\n\t\tsuper({\n\t\t\twritableObjectMode: true,\n\t\t});\n\t\tthis.decoder = new OpusDecoder(options);\n\t}\n\n\toverride _transform(\n\t\tchunk: Buffer,\n\t\t_encoding: BufferEncoding,\n\t\tcallback: TransformCallback,\n\t): void {\n\t\ttry {\n\t\t\tconst decoded = this.decoder.decode(chunk);\n\t\t\tthis.push(decoded);\n\t\t\tcallback();\n\t\t} catch (error) {\n\t\t\tcallback(error instanceof Error ? error : new Error(String(error)));\n\t\t}\n\t}\n}\n","import {\n\topusPacketGetNbChannelsNative,\n\topusPacketGetNbFramesNative,\n\topusPacketGetSamplesPerFrameNative,\n} from \"@harmonia-audio/native\";\nimport { HarmoniaCodecError } from \"./errors.js\";\n\n/**\n * Utilities for inspecting Opus packets without decoding.\n *\n * @example\n * ```ts\n * import { OpusPacket } from '@harmonia/codec';\n *\n * const channels = OpusPacket.getChannels(opusData);\n * const frames = OpusPacket.getFrameCount(opusData);\n * ```\n */\nexport class OpusPacket {\n\t/**\n\t * Get the number of channels from an Opus packet header.\n\t *\n\t * @example\n\t * ```ts\n\t * const channels = OpusPacket.getChannels(opusPacket);\n\t * ```\n\t */\n\tstatic getChannels(packet: Buffer): number {\n\t\ttry {\n\t\t\treturn opusPacketGetNbChannelsNative(packet);\n\t\t} catch (error) {\n\t\t\tthrow new HarmoniaCodecError(\n\t\t\t\t\"PACKET_INSPECT_FAILED\",\n\t\t\t\t`Failed to get channels: ${error instanceof Error ? error.message : String(error)}`,\n\t\t\t);\n\t\t}\n\t}\n\n\t/**\n\t * Get the number of frames in an Opus packet.\n\t *\n\t * @example\n\t * ```ts\n\t * const frameCount = OpusPacket.getFrameCount(opusPacket);\n\t * ```\n\t */\n\tstatic getFrameCount(packet: Buffer): number {\n\t\ttry {\n\t\t\treturn opusPacketGetNbFramesNative(packet);\n\t\t} catch (error) {\n\t\t\tthrow new HarmoniaCodecError(\n\t\t\t\t\"PACKET_INSPECT_FAILED\",\n\t\t\t\t`Failed to get frame count: ${error instanceof Error ? error.message : String(error)}`,\n\t\t\t);\n\t\t}\n\t}\n\n\t/**\n\t * Get samples per frame for a given sample rate.\n\t *\n\t * @example\n\t * ```ts\n\t * const spf = OpusPacket.getSamplesPerFrame(opusPacket, 48000);\n\t * ```\n\t */\n\tstatic getSamplesPerFrame(packet: Buffer, sampleRate: number): number {\n\t\ttry {\n\t\t\treturn opusPacketGetSamplesPerFrameNative(packet, sampleRate);\n\t\t} catch (error) {\n\t\t\tthrow new HarmoniaCodecError(\n\t\t\t\t\"PACKET_INSPECT_FAILED\",\n\t\t\t\t`Failed to get samples per frame: ${error instanceof Error ? error.message : String(error)}`,\n\t\t\t);\n\t\t}\n\t}\n\n\tprivate constructor() {\n\t\t// Static-only class\n\t}\n}\n"]}