@ain1084/audio-worklet-stream 1.0.5 → 2.0.0

package/dist/frame-buffer/buffer-factory.d.ts

@@ -1,76 +0,0 @@
-import { FrameBufferWriter } from './buffer-writer';
-/**
- * Parameters for creating a FrameBuffer.
- * @property frameBufferSize - The size of the frame buffer.
- * @property channelCount - The number of audio channels.
- */
-export type FrameBufferParams = Readonly<{
-    frameBufferSize: number;
-    channelCount: number;
-}>;
-/**
- * Parameters for creating a FillerFrameBuffer.
- * @property channelCount - The number of audio channels.
- * @property fillInterval - The interval in milliseconds for filling the buffer.
- * @property sampleRate - The sample rate of the audio context.
- * @property frameBufferChunks - The number of chunks in the frame buffer.
- */
-export type FillerFrameBufferParams = Readonly<{
-    channelCount: number;
-    fillInterval?: number;
-    sampleRate?: number;
-    frameBufferChunks?: number;
-}>;
-/**
- * Configuration for a FrameBuffer.
- * This configuration is returned by the createFrameBufferConfig function.
- * @property sampleBuffer - The shared buffer for audio data frames.
- * @property samplesPerFrame - The number of samples per frame.
- * @property usedFramesInBuffer - The usage count of the frames in the buffer.
- * @property totalReadFrames - The total frames read from the buffer.
- * @property totalWriteFrames - The total frames written to the buffer.
- */
-export type FrameBufferConfig = Readonly<{
-    sampleBuffer: Float32Array;
-    samplesPerFrame: number;
-    usedFramesInBuffer: Uint32Array;
-    totalReadFrames: BigUint64Array;
-    totalWriteFrames: BigUint64Array;
-}>;
-/**
- * Configuration for a FillerFrameBuffer.
- * This configuration is returned by the createFillerFrameBufferConfig function.
- * @property sampleRate - The sample rate of the audio context.
- * @property fillInterval - The interval in milliseconds for filling the buffer.
- */
-export type FillerFrameBufferConfig = FrameBufferConfig & Readonly<{
-    sampleRate: number;
-    fillInterval: number;
-}>;
-/**
- * Creates a FrameBufferWriter instance.
- * @param config - The configuration for the FrameBuffer.
- * @returns A new instance of FrameBufferWriter.
- */
-export declare const createFrameBufferWriter: (config: FrameBufferConfig) => FrameBufferWriter;
-/**
- * FrameBufferFactory class
- * Provides static methods to create frame buffer configurations and writers.
- */
-export declare class FrameBufferFactory {
-    static readonly DEFAULT_FILL_INTERVAL_MS = 20;
-    static readonly DEFAULT_FRAME_BUFFER_CHUNKS = 5;
-    static readonly PROCESS_UNIT = 128;
-    /**
-     * Creates a FrameBufferConfig instance.
-     * @param params - The parameters for the FrameBuffer.
-     * @returns A new instance of FrameBufferConfig.
-     */
-    static createFrameBufferConfig(params: FrameBufferParams): FrameBufferConfig;
-    /**
-     * Creates a FillerFrameBufferConfig instance.
-     * @param params - The parameters for the FillerFrameBuffer.
-     * @returns A new instance of FillerFrameBufferConfig.
-     */
-    static createFillerFrameBufferConfig(params: FillerFrameBufferParams): FillerFrameBufferConfig;
-}

package/dist/frame-buffer/buffer-factory.js

@@ -1,55 +0,0 @@
-import { FrameBuffer } from './buffer';
-import { FrameBufferWriter } from './buffer-writer';
-/**
- * Creates a FrameBufferWriter instance.
- * @param config - The configuration for the FrameBuffer.
- * @returns A new instance of FrameBufferWriter.
- */
-export const createFrameBufferWriter = (config) => {
-    return new FrameBufferWriter(new FrameBuffer(config.sampleBuffer, config.samplesPerFrame), config.usedFramesInBuffer, config.totalWriteFrames);
-};
-/**
- * FrameBufferFactory class
- * Provides static methods to create frame buffer configurations and writers.
- */
-export class FrameBufferFactory {
-    static DEFAULT_FILL_INTERVAL_MS = 20;
-    static DEFAULT_FRAME_BUFFER_CHUNKS = 5;
-    static PROCESS_UNIT = 128;
-    /**
-     * Creates a FrameBufferConfig instance.
-     * @param params - The parameters for the FrameBuffer.
-     * @returns A new instance of FrameBufferConfig.
-     */
-    static createFrameBufferConfig(params) {
-        return {
-            sampleBuffer: new Float32Array(new SharedArrayBuffer(params.frameBufferSize * params.channelCount * Float32Array.BYTES_PER_ELEMENT)),
-            samplesPerFrame: params.channelCount,
-            usedFramesInBuffer: new Uint32Array(new SharedArrayBuffer(Uint32Array.BYTES_PER_ELEMENT)),
-            totalReadFrames: new BigUint64Array(new SharedArrayBuffer(BigUint64Array.BYTES_PER_ELEMENT)),
-            totalWriteFrames: new BigUint64Array(new SharedArrayBuffer(BigUint64Array.BYTES_PER_ELEMENT)),
-        };
-    }
-    /**
-     * Creates a FillerFrameBufferConfig instance.
-     * @param params - The parameters for the FillerFrameBuffer.
-     * @returns A new instance of FillerFrameBufferConfig.
-     */
-    static createFillerFrameBufferConfig(params) {
-        const sampleRate = params.sampleRate;
-        // Check if 'sampleRate' is a positive integer
-        if (sampleRate === undefined || (!Number.isInteger(sampleRate) || sampleRate <= 0)) {
-            throw new Error('Invalid sampleRate: must be a positive integer.');
-        }
-        const intervalMillisecond = params.fillInterval ?? FrameBufferFactory.DEFAULT_FILL_INTERVAL_MS;
-        const frameBufferSize = Math.floor(sampleRate * intervalMillisecond / 1000 + (FrameBufferFactory.PROCESS_UNIT - 1)) & ~(FrameBufferFactory.PROCESS_UNIT - 1);
-        const frameBufferChunkCount = params.frameBufferChunks ?? FrameBufferFactory.DEFAULT_FRAME_BUFFER_CHUNKS;
-        const config = FrameBufferFactory.createFrameBufferConfig({ frameBufferSize: frameBufferSize * frameBufferChunkCount, channelCount: params.channelCount });
-        return {
-            ...config,
-            sampleRate,
-            fillInterval: intervalMillisecond,
-        };
-    }
-}
-//# sourceMappingURL=buffer-factory.js.map

package/dist/frame-buffer/buffer-factory.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"buffer-factory.js","sourceRoot":"","sources":["../../src/frame-buffer/buffer-factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AACtC,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AAsDnD;;;;GAIG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,MAAyB,EAAqB,EAAE;IACtF,OAAO,IAAI,iBAAiB,CAC1B,IAAI,WAAW,CAAC,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,eAAe,CAAC,EAC5D,MAAM,CAAC,kBAAkB,EAAE,MAAM,CAAC,gBAAgB,CACnD,CAAA;AACH,CAAC,CAAA;AAED;;;GAGG;AACH,MAAM,OAAO,kBAAkB;IACtB,MAAM,CAAU,wBAAwB,GAAG,EAAE,CAAA;IAC7C,MAAM,CAAU,2BAA2B,GAAG,CAAC,CAAA;IAC/C,MAAM,CAAU,YAAY,GAAG,GAAG,CAAA;IAEzC;;;;OAIG;IACI,MAAM,CAAC,uBAAuB,CAAC,MAAyB;QAC7D,OAAO;YACL,YAAY,EAAE,IAAI,YAAY,CAC5B,IAAI,iBAAiB,CAAC,MAAM,CAAC,eAAe,GAAG,MAAM,CAAC,YAAY,GAAG,YAAY,CAAC,iBAAiB,CAAC,CACrG;YACD,eAAe,EAAE,MAAM,CAAC,YAAY;YACpC,kBAAkB,EAAE,IAAI,WAAW,CAAC,IAAI,iBAAiB,CAAC,WAAW,CAAC,iBAAiB,CAAC,CAAC;YACzF,eAAe,EAAE,IAAI,cAAc,CAAC,IAAI,iBAAiB,CAAC,cAAc,CAAC,iBAAiB,CAAC,CAAC;YAC5F,gBAAgB,EAAE,IAAI,cAAc,CAAC,IAAI,iBAAiB,CAAC,cAAc,CAAC,iBAAiB,CAAC,CAAC;SAC9F,CAAA;IACH,CAAC;IAED;;;;OAIG;IACI,MAAM,CAAC,6BAA6B,CAAC,MAA+B;QACzE,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,CAAA;QACpC,8CAA8C;QAC9C,IAAI,UAAU,KAAK,SAAS,IAAI,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,UAAU,CAAC,IAAI,UAAU,IAAI,CAAC,CAAC,EAAE,CAAC;YACnF,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAA;QACpE,CAAC;QACD,MAAM,mBAAmB,GAAG,MAAM,CAAC,YAAY,IAAI,kBAAkB,CAAC,wBAAwB,CAAA;QAC9F,MAAM,eAAe,GAAG,IAAI,CAAC,KAAK,CAChC,UAAU,GAAG,mBAAmB,GAAG,IAAI,GAAG,CAAC,kBAAkB,CAAC,YAAY,GAAG,CAAC,CAAC,CAChF,GAAG,CAAC,CAAC,kBAAkB,CAAC,YAAY,GAAG,CAAC,CAAC,CAAA;QAC1C,MAAM,qBAAqB,GAAG,MAAM,CAAC,iBAAiB,IAAI,kBAAkB,CAAC,2BAA2B,CAAA;QACxG,MAAM,MAAM,GAAG,kBAAkB,CAAC,uBAAuB,CACvD,EAAE,eAAe,EAAE,eAAe,GAAG,qBAAqB,EAAE,YAAY,EAAE,MAAM,CAAC,YAAY,EAAE,CAAC,CAAA;QAClG,OAAO;YACL,GAAG,MAAM;YACT,UAAU;YACV,YAAY,EAAE,mBAAmB;SAClC,CAAA;IACH,CAAC"}

package/dist/frame-buffer/buffer-filler.js

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=buffer-filler.js.map

package/dist/frame-buffer/buffer-filler.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"buffer-filler.js","sourceRoot":"","sources":["../../src/frame-buffer/buffer-filler.ts"],"names":[],"mappings":""}

package/dist/frame-buffer/buffer-reader.d.ts

@@ -1,60 +0,0 @@
-import { FrameBufferConfig } from './buffer-config';
-/**
- * FrameBufferReader class
- * This class reads audio frame data from a shared Float32Array buffer and processes it.
- * The buffer usage is tracked using a Uint32Array.
- */
-export declare class FrameBufferReader {
-    private readonly _frameBuffer;
-    private readonly _usedFramesInBuffer;
-    private readonly _totalFrames;
-    private _index;
-    /**
-     * @internal
-     * Creates an instance of FrameBufferReader.
-     * @param config - The configuration object containing:
-     *   - `sampleBuffer`: The shared buffer to read audio data frames from.
-     *   - `samplesPerFrame`: The number of samples per frame.
-     *   - `usedFramesInBuffer`: A Uint32Array tracking the usage of frames in the buffer.
-     *   - `totalReadFrames`: A BigUint64Array tracking the total frames read from the buffer.
-     */
-    constructor(config: FrameBufferConfig);
-    /**
-     * Get the number of available frames in the buffer.
-     * @returns The number of available frames in the buffer.
-     */
-    get availableFrames(): number;
-    /**
-     * Get the total number of frames read from the buffer.
-     *
-     * @returns The total number of frames read.
-     */
-    get totalFrames(): bigint;
-    /**
-     * Reads audio frame data from the buffer using the provided callback.
-     * This method handles one or more readable segments within the ring buffer
-     * and invokes the callback for each segment.
-     *
-     * @param processFrameSegment - The callback function invoked for each readable segment
-     *   of the ring buffer. It receives:
-     *   1. `buffer`: A Float32Array representing the readable segment of the buffer.
-     *   2. `offset`: The cumulative number of frames processed so far, used as the starting index
-     *      for the current segment relative to the entire data.
-     *
-     *   The callback must return the number of frames it successfully processed.
-     *   If the callback processes fewer frames than available in the current segment,
-     *   processing will stop early.
-     *
-     * @returns The total number of frames processed across all segments.
-     *   Note: The return value is in frames, not in samples.
-     *
-     * @throws RangeError - If the processFrameSegment callback returns a processed length greater than the available frames in the current segment.
-     *
-     * @remarks The buffer is an array of samples, but it is always provided in frame-sized segments.
-     * Each frame consists of multiple samples (e.g., for stereo, a frame contains a sample for the left channel
-     * and one for the right channel). You must access and process the buffer in frame-sized chunks,
-     * based on the structure of the frames.
-     *
-     */
-    read(processFrameSegment: (buffer: Float32Array, offset: number) => number): number;
-}

package/dist/frame-buffer/buffer-reader.js

@@ -1,77 +0,0 @@
-import { FrameBuffer } from './buffer';
-/**
- * FrameBufferReader class
- * This class reads audio frame data from a shared Float32Array buffer and processes it.
- * The buffer usage is tracked using a Uint32Array.
- */
-export class FrameBufferReader {
-    _frameBuffer;
-    _usedFramesInBuffer;
-    _totalFrames;
-    _index = 0;
-    /**
-     * @internal
-     * Creates an instance of FrameBufferReader.
-     * @param config - The configuration object containing:
-     *   - `sampleBuffer`: The shared buffer to read audio data frames from.
-     *   - `samplesPerFrame`: The number of samples per frame.
-     *   - `usedFramesInBuffer`: A Uint32Array tracking the usage of frames in the buffer.
-     *   - `totalReadFrames`: A BigUint64Array tracking the total frames read from the buffer.
-     */
-    constructor(config) {
-        this._frameBuffer = new FrameBuffer(config.sampleBuffer, config.samplesPerFrame);
-        this._usedFramesInBuffer = config.usedFramesInBuffer;
-        this._totalFrames = config.totalReadFrames;
-    }
-    /**
-     * Get the number of available frames in the buffer.
-     * @returns The number of available frames in the buffer.
-     */
-    get availableFrames() {
-        return Atomics.load(this._usedFramesInBuffer, 0);
-    }
-    /**
-     * Get the total number of frames read from the buffer.
-     *
-     * @returns The total number of frames read.
-     */
-    get totalFrames() {
-        // This class is not used concurrently by multiple threads,
-        // so `Atomics` is not necessary when reading `totalFrames`.
-        return this._totalFrames[0];
-    }
-    /**
-     * Reads audio frame data from the buffer using the provided callback.
-     * This method handles one or more readable segments within the ring buffer
-     * and invokes the callback for each segment.
-     *
-     * @param processFrameSegment - The callback function invoked for each readable segment
-     *   of the ring buffer. It receives:
-     *   1. `buffer`: A Float32Array representing the readable segment of the buffer.
-     *   2. `offset`: The cumulative number of frames processed so far, used as the starting index
-     *      for the current segment relative to the entire data.
-     *
-     *   The callback must return the number of frames it successfully processed.
-     *   If the callback processes fewer frames than available in the current segment,
-     *   processing will stop early.
-     *
-     * @returns The total number of frames processed across all segments.
-     *   Note: The return value is in frames, not in samples.
-     *
-     * @throws RangeError - If the processFrameSegment callback returns a processed length greater than the available frames in the current segment.
-     *
-     * @remarks The buffer is an array of samples, but it is always provided in frame-sized segments.
-     * Each frame consists of multiple samples (e.g., for stereo, a frame contains a sample for the left channel
-     * and one for the right channel). You must access and process the buffer in frame-sized chunks,
-     * based on the structure of the frames.
-     *
-     */
-    read(processFrameSegment) {
-        const result = this._frameBuffer.enumFrameSegments(this._index, this.availableFrames, processFrameSegment);
-        this._index = result.nextIndex;
-        Atomics.sub(this._usedFramesInBuffer, 0, result.totalProcessedFrames);
-        Atomics.add(this._totalFrames, 0, BigInt(result.totalProcessedFrames));
-        return result.totalProcessedFrames;
-    }
-}
-//# sourceMappingURL=buffer-reader.js.map

package/dist/frame-buffer/buffer-reader.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"buffer-reader.js","sourceRoot":"","sources":["../../src/frame-buffer/buffer-reader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AAGtC;;;;GAIG;AACH,MAAM,OAAO,iBAAiB;IACX,YAAY,CAAa;IACzB,mBAAmB,CAAa;IAChC,YAAY,CAAgB;IACrC,MAAM,GAAW,CAAC,CAAA;IAE1B;;;;;;;;OAQG;IACH,YAAY,MAAyB;QACnC,IAAI,CAAC,YAAY,GAAG,IAAI,WAAW,CAAC,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,eAAe,CAAC,CAAA;QAChF,IAAI,CAAC,mBAAmB,GAAG,MAAM,CAAC,kBAAkB,CAAA;QACpD,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC,eAAe,CAAA;IAC5C,CAAC;IAED;;;OAGG;IACH,IAAW,eAAe;QACxB,OAAO,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE,CAAC,CAAC,CAAA;IAClD,CAAC;IAED;;;;OAIG;IACH,IAAW,WAAW;QACpB,2DAA2D;QAC3D,4DAA4D;QAC5D,OAAO,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;IAC7B,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACI,IAAI,CAAC,mBAAqE;QAC/E,MAAM,MAAM,GAAG,IAAI,CAAC,YAAY,CAAC,iBAAiB,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,eAAe,EAAE,mBAAmB,CAAC,CAAA;QAC1G,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,SAAS,CAAA;QAC9B,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,mBAAmB,EAAE,CAAC,EAAE,MAAM,CAAC,oBAAoB,CAAC,CAAA;QACrE,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC,CAAA;QACtE,OAAO,MAAM,CAAC,oBAAoB,CAAA;IACpC,CAAC;CACF"}

package/dist/frame-buffer/buffer-utils.d.ts

@@ -1,34 +0,0 @@
-import type { FrameBuffer } from './buffer';
-/**
- * Type definition for the callback function used in enumFrames.
- * The callback processes each section of the frame buffer.
- * @param frame - An object containing:
- *                - buffer: The FrameBuffer instance.
- *                - index: The starting index in the buffer.
- *                - frames: The number of frames in the section.
- * @param offset - The offset in the buffer from the start of processing.
- * @returns The number of frames processed.
- */
-export type FrameCallback = (frame: {
-    buffer: FrameBuffer;
-    index: number;
-    frames: number;
-}, offset: number) => number;
-/**
- * Processes sections of a Float32Array buffer using a callback function.
- * This function is intended for internal use only.
- *
- * @param buffer - The FrameBuffer to process. This buffer is expected to be shared.
- * @param startIndex - The starting index in the buffer from where processing should begin.
- * @param availableFrames - The total number of frames available to process in the buffer.
- * @param frameCallback - The callback function to process each section of the buffer.
- *                          It should return the number of frames processed.
- * @returns An object containing:
- *          - frames: The number of frames successfully processed.
- *          - nextIndex: The index in the buffer for the next processing cycle.
- * @throws RangeError - If the frameCallback returns a processed length greater than the part length.
- */
-export declare const enumFrames: (buffer: FrameBuffer, startIndex: number, availableFrames: number, frameCallback: FrameCallback) => {
-    frames: number;
-    nextIndex: number;
-};

package/dist/frame-buffer/buffer-utils.js

@@ -1,34 +0,0 @@
-/**
- * Processes sections of a Float32Array buffer using a callback function.
- * This function is intended for internal use only.
- *
- * @param buffer - The FrameBuffer to process. This buffer is expected to be shared.
- * @param startIndex - The starting index in the buffer from where processing should begin.
- * @param availableFrames - The total number of frames available to process in the buffer.
- * @param frameCallback - The callback function to process each section of the buffer.
- *                          It should return the number of frames processed.
- * @returns An object containing:
- *          - frames: The number of frames successfully processed.
- *          - nextIndex: The index in the buffer for the next processing cycle.
- * @throws RangeError - If the frameCallback returns a processed length greater than the part length.
- */
-export const enumFrames = (buffer, startIndex, availableFrames, frameCallback) => {
-    let totalFrames = 0;
-    while (totalFrames < availableFrames) {
-        // Determine the length of the current section to process
-        const sectionFrames = Math.min(buffer.frameCount - startIndex, availableFrames - totalFrames);
-        // Process the current section using the frameCallback function
-        const processedFrames = frameCallback({ buffer, index: startIndex, frames: sectionFrames }, totalFrames);
-        // Ensure the processed length does not exceed the section length
-        if (processedFrames > sectionFrames) {
-            throw new RangeError(`Processed frames (${processedFrames}) exceeds section frames (${sectionFrames})`);
-        }
-        totalFrames += processedFrames;
-        startIndex = (startIndex + processedFrames) % buffer.frameCount;
-        if (processedFrames < sectionFrames) {
-            break;
-        }
-    }
-    return { frames: totalFrames, nextIndex: startIndex };
-};
-//# sourceMappingURL=buffer-utils.js.map

package/dist/frame-buffer/buffer-utils.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"buffer-utils.js","sourceRoot":"","sources":["../../src/frame-buffer/buffer-utils.ts"],"names":[],"mappings":"AAcA;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,MAAmB,EAAE,UAAkB,EAAE,eAAuB,EAAE,aAA4B,EACnF,EAAE;IACtC,IAAI,WAAW,GAAG,CAAC,CAAA;IACnB,OAAO,WAAW,GAAG,eAAe,EAAE,CAAC;QACrC,yDAAyD;QACzD,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,UAAU,GAAG,UAAU,EAAE,eAAe,GAAG,WAAW,CAAC,CAAA;QAC7F,+DAA+D;QAC/D,MAAM,eAAe,GAAG,aAAa,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,aAAa,EAAE,EAAE,WAAW,CAAC,CAAA;QACxG,iEAAiE;QACjE,IAAI,eAAe,GAAG,aAAa,EAAE,CAAC;YACpC,MAAM,IAAI,UAAU,CAAC,qBAAqB,eAAe,6BAA6B,aAAa,GAAG,CAAC,CAAA;QACzG,CAAC;QACD,WAAW,IAAI,eAAe,CAAA;QAC9B,UAAU,GAAG,CAAC,UAAU,GAAG,eAAe,CAAC,GAAG,MAAM,CAAC,UAAU,CAAA;QAC/D,IAAI,eAAe,GAAG,aAAa,EAAE,CAAC;YACpC,MAAK;QACP,CAAC;IACH,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,UAAU,EAAE,CAAA;AACvD,CAAC,CAAA"}

package/dist/frame-buffer/buffer-writer.d.ts

@@ -1,60 +0,0 @@
-import { FrameBufferConfig } from './buffer-config';
-/**
- * FrameBufferWriter class
- * This class writes audio frame data to a shared Float32Array buffer.
- * The buffer usage is tracked using a Uint32Array.
- */
-export declare class FrameBufferWriter {
-    private readonly _frameBuffer;
-    private readonly _usedFramesInBuffer;
-    private readonly _totalFrames;
-    private _index;
-    /**
-     * @internal
-     * Creates an instance of FrameBufferWriter.
-     * @param config - The configuration object containing:
-     *   - `sampleBuffer`: The shared buffer to write audio data frames.
-     *   - `samplesPerFrame`: The number of samples per frame.
-     *   - `usedFramesInBuffer`: A Uint32Array tracking the usage of frames in the buffer.
-     *   - `totalWriteFrames`: A BigUint64Array tracking the total frames written to the buffer.
-     */
-    constructor(config: FrameBufferConfig);
-    /**
-     * Get the number of available frames in the buffer.
-     * This represents the number of frames that can be written before the buffer is full.
-     * @returns The number of available frames in the buffer.
-     */
-    get availableFrames(): number;
-    /**
-     * Get the total number of frames written to the buffer.
-     *
-     * @returns The total number of frames written.
-     */
-    get totalFrames(): bigint;
-    /**
-     * Writes audio frame data into the buffer using the provided callback.
-     * This method handles one or more writable segments within the ring buffer
-     * and invokes the callback for each segment.
-     *
-     * @param processFrameSegment - The callback function invoked for each writable segment
-     *   of the ring buffer. It receives:
-     *   1. `buffer`: A Float32Array representing the writable segment of the buffer.
-     *   2. `offset`: The cumulative number of frames processed so far, used as the starting index
-     *      for the current segment relative to the entire data.
-     *
-     *   The callback must return the number of frames it successfully wrote.
-     *   If the callback writes fewer frames than available in the current segment,
-     *   processing will stop early.
-     *
-     * @returns The total number of frames written across all segments.
-     *   Note: The return value is in frames, not in samples.
-     *
-     * @throws RangeError - If the processFrameSegment callback returns a written length greater than the available space in the current segment.
-     *
-     * @remarks The buffer is an array of samples, but it is always provided in frame-sized segments.
-     * Each frame consists of multiple samples (e.g., for stereo, a frame contains a sample for the left channel
-     * and one for the right channel). You must access and process the buffer in frame-sized chunks,
-     * based on the structure of the frames.
-     */
-    write(processFrameSegment: (buffer: Float32Array, offset: number) => number): number;
-}

package/dist/frame-buffer/buffer-writer.js

@@ -1,77 +0,0 @@
-import { FrameBuffer } from './buffer';
-/**
- * FrameBufferWriter class
- * This class writes audio frame data to a shared Float32Array buffer.
- * The buffer usage is tracked using a Uint32Array.
- */
-export class FrameBufferWriter {
-    _frameBuffer;
-    _usedFramesInBuffer;
-    _totalFrames;
-    _index = 0;
-    /**
-     * @internal
-     * Creates an instance of FrameBufferWriter.
-     * @param config - The configuration object containing:
-     *   - `sampleBuffer`: The shared buffer to write audio data frames.
-     *   - `samplesPerFrame`: The number of samples per frame.
-     *   - `usedFramesInBuffer`: A Uint32Array tracking the usage of frames in the buffer.
-     *   - `totalWriteFrames`: A BigUint64Array tracking the total frames written to the buffer.
-     */
-    constructor(config) {
-        this._frameBuffer = new FrameBuffer(config.sampleBuffer, config.samplesPerFrame);
-        this._usedFramesInBuffer = config.usedFramesInBuffer;
-        this._totalFrames = config.totalWriteFrames;
-    }
-    /**
-     * Get the number of available frames in the buffer.
-     * This represents the number of frames that can be written before the buffer is full.
-     * @returns The number of available frames in the buffer.
-     */
-    get availableFrames() {
-        return this._frameBuffer.frameCount - Atomics.load(this._usedFramesInBuffer, 0);
-    }
-    /**
-     * Get the total number of frames written to the buffer.
-     *
-     * @returns The total number of frames written.
-     */
-    get totalFrames() {
-        // This class is not used concurrently by multiple threads,
-        // so `Atomics` is not necessary when reading `totalFrames`.
-        return this._totalFrames[0];
-    }
-    /**
-     * Writes audio frame data into the buffer using the provided callback.
-     * This method handles one or more writable segments within the ring buffer
-     * and invokes the callback for each segment.
-     *
-     * @param processFrameSegment - The callback function invoked for each writable segment
-     *   of the ring buffer. It receives:
-     *   1. `buffer`: A Float32Array representing the writable segment of the buffer.
-     *   2. `offset`: The cumulative number of frames processed so far, used as the starting index
-     *      for the current segment relative to the entire data.
-     *
-     *   The callback must return the number of frames it successfully wrote.
-     *   If the callback writes fewer frames than available in the current segment,
-     *   processing will stop early.
-     *
-     * @returns The total number of frames written across all segments.
-     *   Note: The return value is in frames, not in samples.
-     *
-     * @throws RangeError - If the processFrameSegment callback returns a written length greater than the available space in the current segment.
-     *
-     * @remarks The buffer is an array of samples, but it is always provided in frame-sized segments.
-     * Each frame consists of multiple samples (e.g., for stereo, a frame contains a sample for the left channel
-     * and one for the right channel). You must access and process the buffer in frame-sized chunks,
-     * based on the structure of the frames.
-     */
-    write(processFrameSegment) {
-        const result = this._frameBuffer.enumFrameSegments(this._index, this.availableFrames, processFrameSegment);
-        this._index = result.nextIndex;
-        Atomics.add(this._usedFramesInBuffer, 0, result.totalProcessedFrames);
-        Atomics.add(this._totalFrames, 0, BigInt(result.totalProcessedFrames));
-        return result.totalProcessedFrames;
-    }
-}
-//# sourceMappingURL=buffer-writer.js.map

package/dist/frame-buffer/buffer-writer.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"buffer-writer.js","sourceRoot":"","sources":["../../src/frame-buffer/buffer-writer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AAGtC;;;;GAIG;AACH,MAAM,OAAO,iBAAiB;IACX,YAAY,CAAa;IACzB,mBAAmB,CAAa;IAChC,YAAY,CAAgB;IACrC,MAAM,GAAW,CAAC,CAAA;IAE1B;;;;;;;;OAQG;IACH,YAAY,MAAyB;QACnC,IAAI,CAAC,YAAY,GAAG,IAAI,WAAW,CAAC,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,eAAe,CAAC,CAAA;QAChF,IAAI,CAAC,mBAAmB,GAAG,MAAM,CAAC,kBAAkB,CAAA;QACpD,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC,gBAAgB,CAAA;IAC7C,CAAC;IAED;;;;OAIG;IACH,IAAW,eAAe;QACxB,OAAO,IAAI,CAAC,YAAY,CAAC,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE,CAAC,CAAC,CAAA;IACjF,CAAC;IAED;;;;OAIG;IACH,IAAW,WAAW;QACpB,2DAA2D;QAC3D,4DAA4D;QAC5D,OAAO,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;IAC7B,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACI,KAAK,CAAC,mBAAqE;QAChF,MAAM,MAAM,GAAG,IAAI,CAAC,YAAY,CAAC,iBAAiB,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,eAAe,EAAE,mBAAmB,CAAC,CAAA;QAC1G,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,SAAS,CAAA;QAC9B,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,mBAAmB,EAAE,CAAC,EAAE,MAAM,CAAC,oBAAoB,CAAC,CAAA;QACrE,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC,CAAA;QACtE,OAAO,MAAM,CAAC,oBAAoB,CAAA;IACpC,CAAC;CACF"}

package/dist/frame-buffer/buffer.d.ts

@@ -1,51 +0,0 @@
-/**
- * FrameBuffer class
- * This class manages a buffer of audio frames.
- */
-export declare class FrameBuffer {
-    private readonly _buffer;
-    private readonly _samplesPerFrame;
-    private readonly _frameCount;
-    /**
-     * Creates an instance of FrameBuffer.
-     * @param buffer - The Float32Array buffer to manage.
-     * @param samplesPerFrame - The number of samples per frame.
-     */
-    constructor(buffer: Float32Array, samplesPerFrame: number);
-    /**
-     * Gets the count of the buffer in frames.
-     * @returns The count of the buffer in frames.
-     */
-    get frameCount(): number;
-    private getFrames;
-    /**
-     * Processes sections of a Float32Array buffer using a callback function.
-     * This function handles one or more segments within the ring buffer and invokes
-     * the provided callback for each segment. It is intended for internal use only.
-     *
-     * @param startIndex - The starting index in the buffer from where processing should begin.
-     * @param availableFrames - The total number of frames available to process in the buffer.
-     * @param processFrameSegment - The callback function invoked for each segment
-     *   of the ring buffer during enumeration. It receives:
-     *   1. `buffer`: A Float32Array representing the segment to process. The buffer is an array
-     *      of samples but is always provided in frame-sized segments.
-     *   2. `offset`: The cumulative number of frames processed so far, used as the starting index
-     *      for the current segment relative to the entire data.
-     *   The callback must return the number of frames it successfully processed.
-     *   If the callback processes fewer frames than available in the current segment,
-     *   processing will stop early.
-     *
-     * @returns An object containing:
-     *          - totalProcessedFrames: The number of frames successfully processed.
-     *          - nextIndex: The index in the buffer for the next processing cycle.
-     *
-     * @throws RangeError - If the processFrameSegment callback returns a processed length greater than the available section length.
-     *
-     * @remarks The buffer is always provided in frame-sized segments, meaning that the buffer contains complete frames.
-     * You must process the buffer in frame-sized chunks based on the structure of the frames.
-     */
-    enumFrameSegments(startIndex: number, availableFrames: number, processFrameSegment: (buffer: Float32Array, offset: number) => number): {
-        totalProcessedFrames: number;
-        nextIndex: number;
-    };
-}

package/dist/frame-buffer/buffer.js

@@ -1,75 +0,0 @@
-/**
- * FrameBuffer class
- * This class manages a buffer of audio frames.
- */
-export class FrameBuffer {
-    _buffer;
-    _samplesPerFrame;
-    _frameCount;
-    /**
-     * Creates an instance of FrameBuffer.
-     * @param buffer - The Float32Array buffer to manage.
-     * @param samplesPerFrame - The number of samples per frame.
-     */
-    constructor(buffer, samplesPerFrame) {
-        this._buffer = buffer;
-        this._samplesPerFrame = samplesPerFrame;
-        this._frameCount = Math.floor(buffer.length / samplesPerFrame);
-    }
-    /**
-     * Gets the count of the buffer in frames.
-     * @returns The count of the buffer in frames.
-     */
-    get frameCount() {
-        return this._frameCount;
-    }
-    getFrames(index, count) {
-        return this._buffer.subarray(index * this._samplesPerFrame, (index + count) * this._samplesPerFrame);
-    }
-    /**
-     * Processes sections of a Float32Array buffer using a callback function.
-     * This function handles one or more segments within the ring buffer and invokes
-     * the provided callback for each segment. It is intended for internal use only.
-     *
-     * @param startIndex - The starting index in the buffer from where processing should begin.
-     * @param availableFrames - The total number of frames available to process in the buffer.
-     * @param processFrameSegment - The callback function invoked for each segment
-     *   of the ring buffer during enumeration. It receives:
-     *   1. `buffer`: A Float32Array representing the segment to process. The buffer is an array
-     *      of samples but is always provided in frame-sized segments.
-     *   2. `offset`: The cumulative number of frames processed so far, used as the starting index
-     *      for the current segment relative to the entire data.
-     *   The callback must return the number of frames it successfully processed.
-     *   If the callback processes fewer frames than available in the current segment,
-     *   processing will stop early.
-     *
-     * @returns An object containing:
-     *          - totalProcessedFrames: The number of frames successfully processed.
-     *          - nextIndex: The index in the buffer for the next processing cycle.
-     *
-     * @throws RangeError - If the processFrameSegment callback returns a processed length greater than the available section length.
-     *
-     * @remarks The buffer is always provided in frame-sized segments, meaning that the buffer contains complete frames.
-     * You must process the buffer in frame-sized chunks based on the structure of the frames.
-     */
-    enumFrameSegments(startIndex, availableFrames, processFrameSegment) {
-        let totalProcessedFrames = 0;
-        while (totalProcessedFrames < availableFrames) {
-            // Determine the length of the current section to process
-            const sectionFrames = Math.min(this.frameCount - startIndex, availableFrames - totalProcessedFrames);
-            // Process the current section using the frameCallback function
-            const processedFrames = processFrameSegment(this.getFrames(startIndex, sectionFrames), totalProcessedFrames);
-            // Ensure the processed length does not exceed the section length
-            if (processedFrames > sectionFrames) {
-                throw new RangeError(`Processed frames (${processedFrames}) exceeds section frames (${sectionFrames})`);
-            }
-            totalProcessedFrames += processedFrames;
-            startIndex = (startIndex + processedFrames) % this.frameCount;
-            if (processedFrames < sectionFrames) {
-                break;
-            }
-        }
-        return { totalProcessedFrames, nextIndex: startIndex };
-    }
-}
-//# sourceMappingURL=buffer.js.map

package/dist/frame-buffer/buffer.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"buffer.js","sourceRoot":"","sources":["../../src/frame-buffer/buffer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,OAAO,WAAW;IACL,OAAO,CAAc;IACrB,gBAAgB,CAAQ;IACxB,WAAW,CAAQ;IAEpC;;;;OAIG;IACH,YAAmB,MAAoB,EAAE,eAAuB;QAC9D,IAAI,CAAC,OAAO,GAAG,MAAM,CAAA;QACrB,IAAI,CAAC,gBAAgB,GAAG,eAAe,CAAA;QACvC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,eAAe,CAAC,CAAA;IAChE,CAAC;IAED;;;OAGG;IACH,IAAW,UAAU;QACnB,OAAO,IAAI,CAAC,WAAW,CAAA;IACzB,CAAC;IAEO,SAAS,CAAC,KAAa,EAAE,KAAa;QAC5C,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,GAAG,IAAI,CAAC,gBAAgB,EAAE,CAAC,KAAK,GAAG,KAAK,CAAC,GAAG,IAAI,CAAC,gBAAgB,CAAC,CAAA;IACtG,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACI,iBAAiB,CAAC,UAAkB,EAAE,eAAuB,EAClE,mBAAqE;QACrE,IAAI,oBAAoB,GAAG,CAAC,CAAA;QAC5B,OAAO,oBAAoB,GAAG,eAAe,EAAE,CAAC;YAC9C,yDAAyD;YACzD,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,GAAG,UAAU,EAAE,eAAe,GAAG,oBAAoB,CAAC,CAAA;YACpG,+DAA+D;YAC/D,MAAM,eAAe,GAAG,mBAAmB,CAAC,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,aAAa,CAAC,EAAE,oBAAoB,CAAC,CAAA;YAC5G,iEAAiE;YACjE,IAAI,eAAe,GAAG,aAAa,EAAE,CAAC;gBACpC,MAAM,IAAI,UAAU,CAAC,qBAAqB,eAAe,6BAA6B,aAAa,GAAG,CAAC,CAAA;YACzG,CAAC;YACD,oBAAoB,IAAI,eAAe,CAAA;YACvC,UAAU,GAAG,CAAC,UAAU,GAAG,eAAe,CAAC,GAAG,IAAI,CAAC,UAAU,CAAA;YAC7D,IAAI,eAAe,GAAG,aAAa,EAAE,CAAC;gBACpC,MAAK;YACP,CAAC;QACH,CAAC;QACD,OAAO,EAAE,oBAAoB,EAAE,SAAS,EAAE,UAAU,EAAE,CAAA;IACxD,CAAC;CACF"}