@ain1084/audio-worklet-stream 1.0.3 → 1.0.5

package/dist/write-strategy/timed-strategy.js

@@ -0,0 +1,92 @@
+import { FrameBufferWriter } from '../frame-buffer/buffer-writer';
+/**
+ * PlayContext class
+ * Manages the buffer filling process using a timer.
+ */
+class PlayContext {
+    _timerId = 0;
+    /**
+     * Creates an instance of PlayContext.
+     * @param node - The OutputStreamNode instance.
+     * @param writer - The FrameBufferWriter instance.
+     * @param filler - The FrameBufferFiller instance.
+     * @param fillInterval - The interval in milliseconds for filling the buffer.
+     */
+    constructor(node, writer, filler, fillInterval) {
+        this._timerId = window.setInterval(() => {
+            if (!this._timerId || !node.isStart) {
+                return;
+            }
+            try {
+                if (!filler.fill(writer)) {
+                    node.stop(writer.totalFrames);
+                }
+            }
+            catch {
+                this.cleanup();
+                node.stop();
+            }
+        }, fillInterval);
+    }
+    /**
+     * Cleans up the timer.
+     */
+    cleanup() {
+        if (this._timerId) {
+            clearInterval(this._timerId);
+            this._timerId = 0;
+        }
+    }
+}
+/**
+ * TimedBufferWriteStrategy class
+ * Implements the BufferWriteStrategy interface using a timer to manage buffer filling.
+ */
+export class TimedBufferWriteStrategy {
+    _writer;
+    _filler;
+    _interval;
+    _isContinuePlayback;
+    _context = null;
+    /**
+     * Creates an instance of TimedBufferWriteStrategy.
+     * @param config - The configuration for the filler frame buffer.
+     * @param filler - The FrameBufferFiller instance.
+     */
+    constructor(config, filler) {
+        this._writer = new FrameBufferWriter(config);
+        this._filler = filler;
+        this._interval = config.fillInterval;
+        this._isContinuePlayback = this._filler.fill(this._writer);
+    }
+    /**
+     * Initializes the strategy.
+     * @returns A promise that resolves to true when initialization is complete.
+     */
+    async onInit( /* node: OutputStreamNode */) {
+        return true;
+    }
+    /**
+     * Starts the strategy.
+     * @param node - The OutputStreamNode instance.
+     * @returns A boolean indicating whether the strategy started successfully.
+     */
+    onStart(node) {
+        if (this._context) {
+            throw new Error('Invalid state: context is not null.');
+        }
+        if (!this._isContinuePlayback) {
+            return false;
+        }
+        this._context = new PlayContext(node, this._writer, this._filler, this._interval);
+        return true;
+    }
+    /**
+     * Stops the strategy.
+     */
+    onStopped() {
+        this._context?.cleanup();
+        this._context = null;
+    }
+}
+//# sourceMappingURL=timed-strategy.js.map

package/dist/write-strategy/timed-strategy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timed-strategy.js","sourceRoot":"","sources":["../../src/write-strategy/timed-strategy.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAA;AAIjE;;;GAGG;AACH,MAAM,WAAW;IACP,QAAQ,GAAW,CAAC,CAAA;IAE5B;;;;;;OAMG;IACH,YAAY,IAAsB,EAAE,MAAyB,EAAE,MAAyB,EAAE,YAAoB;QAC5G,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,WAAW,CAAC,GAAG,EAAE;YACtC,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;gBACpC,OAAM;YACR,CAAC;YACD,IAAI,CAAC;gBACH,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;oBACzB,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,CAAA;gBAC/B,CAAC;YACH,CAAC;YACD,MAAM,CAAC;gBACL,IAAI,CAAC,OAAO,EAAE,CAAA;gBACd,IAAI,CAAC,IAAI,EAAE,CAAA;YACb,CAAC;QACH,CAAC,EAAE,YAAY,CAAC,CAAA;IAClB,CAAC;IAED;;OAEG;IACI,OAAO;QACZ,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;YAC5B,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAA;QACnB,CAAC;IACH,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,wBAAwB;IAClB,OAAO,CAAmB;IAC1B,OAAO,CAAmB;IAC1B,SAAS,CAAQ;IACjB,mBAAmB,CAAS;IACrC,QAAQ,GAAuB,IAAI,CAAA;IAE3C;;;;OAIG;IACH,YAAY,MAA+B,EAAE,MAAyB;QACpE,IAAI,CAAC,OAAO,GAAG,IAAI,iBAAiB,CAAC,MAAM,CAAC,CAAA;QAC5C,IAAI,CAAC,OAAO,GAAG,MAAM,CAAA;QACrB,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,YAAY,CAAA;QACpC,IAAI,CAAC,mBAAmB,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IAC5D,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,MAAM,EAAC,4BAA4B;QACvC,OAAO,IAAI,CAAA;IACb,CAAC;IAED;;;;OAIG;IACH,OAAO,CAAC,IAAsB;QAC5B,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAA;QACxD,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE,CAAC;YAC9B,OAAO,KAAK,CAAA;QACd,CAAC;QACD,IAAI,CAAC,QAAQ,GAAG,IAAI,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,CAAA;QACjF,OAAO,IAAI,CAAA;IACb,CAAC;IAED;;OAEG;IACH,SAAS;QACP,IAAI,CAAC,QAAQ,EAAE,OAAO,EAAE,CAAA;QACxB,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAA;IACtB,CAAC;CACF"}

package/dist/write-strategy/worker/worker-strategy.d.ts

@@ -0,0 +1,34 @@
+import type { BufferWriteStrategy } from '../strategy';
+import type { FillerFrameBufferConfig } from '../../frame-buffer/buffer-config';
+import type { OutputStreamNode } from '../../output-stream-node';
+/**
+ * WorkerBufferWriteStrategy class
+ * Implements the BufferWriteStrategy interface using a web worker to manage buffer filling.
+ */
+export declare class WorkerBufferWriteStrategy<FillerParam> implements BufferWriteStrategy {
+    private readonly _createPlayContext;
+    private _context;
+    /**
+     * Creates an instance of WorkerBufferWriteStrategy.
+     * @param config - The configuration for the filler frame buffer.
+     * @param workerConstructor - The constructor for the Worker.
+     * @param fillerParam - The parameters for the FrameBufferFiller.
+     */
+    constructor(config: FillerFrameBufferConfig, workerConstructor: new () => Worker, fillerParam: FillerParam);
+    /**
+     * Initializes the strategy.
+     * @param node - The OutputStreamNode instance.
+     * @returns A promise that resolves to true when initialization is complete.
+     */
+    onInit(node: OutputStreamNode): Promise<boolean>;
+    /**
+     * Starts the strategy.
+     * @param node - The OutputStreamNode instance.
+     * @returns A boolean indicating whether the strategy started successfully.
+     */
+    onStart(): boolean;
+    /**
+     * Stops the strategy.
+     */
+    onStopped(): void;
+}

package/dist/write-strategy/worker/worker-strategy.js

@@ -0,0 +1,125 @@
+/**
+ * PlayContext class
+ * Manages the buffer filling process within a web worker.
+ */
+class Context {
+    _node;
+    _config;
+    _fillerParam;
+    _worker;
+    /**
+     * Creates an instance of PlayContext.
+     * @param params - The parameters for the PlayContext.
+     */
+    constructor(params) {
+        this._node = params.node;
+        this._config = params.config;
+        this._worker = new params.workerConstructor();
+        this._fillerParam = params.fillerParam;
+        this._worker.onmessage = this.handleWorkerMessage.bind(this);
+    }
+    /**
+     * Creates and initializes an instance of PlayContext.
+     * @param params - The parameters for the PlayContext.
+     * @returns A promise that resolves to an instance of PlayContext.
+     */
+    static async create(params) {
+        const instance = new Context(params);
+        await instance.init();
+        return instance;
+    }
+    /**
+     * Handles messages from the worker.
+     * @param ev - The message event from the worker.
+     */
+    handleWorkerMessage(ev) {
+        if (ev.data.type === 'stop') {
+            this._node.stop(ev.data.stopFrames);
+        }
+    }
+    /**
+     * Initializes the PlayContext by sending the 'init' message to the worker.
+     * @returns A promise that resolves when initialization is complete.
+     */
+    init() {
+        return new Promise((resolve) => {
+            const message = {
+                type: 'init',
+                config: this._config,
+                fillerParams: this._fillerParam,
+            };
+            this._worker.postMessage(message);
+            const listener = (ev) => {
+                if (ev.data.type === 'init-done') {
+                    this._worker.removeEventListener('message', listener);
+                    resolve();
+                }
+            };
+            this._worker.addEventListener('message', listener);
+        });
+    }
+    /**
+     * Starts the buffer filling process by sending the 'start' message to the worker.
+     */
+    start() {
+        const message = {
+            type: 'start',
+        };
+        this._worker.postMessage(message);
+    }
+    /**
+     * Stops the worker and terminates it.
+     */
+    stopped() {
+        this._worker.onmessage = null;
+        this._worker.terminate();
+    }
+}
+/**
+ * WorkerBufferWriteStrategy class
+ * Implements the BufferWriteStrategy interface using a web worker to manage buffer filling.
+ */
+export class WorkerBufferWriteStrategy {
+    _createPlayContext;
+    _context = null;
+    /**
+     * Creates an instance of WorkerBufferWriteStrategy.
+     * @param config - The configuration for the filler frame buffer.
+     * @param workerConstructor - The constructor for the Worker.
+     * @param fillerParam - The parameters for the FrameBufferFiller.
+     */
+    constructor(config, workerConstructor, fillerParam) {
+        this._createPlayContext = (node) => Context.create({ node, config, workerConstructor, fillerParam });
+    }
+    /**
+     * Initializes the strategy.
+     * @param node - The OutputStreamNode instance.
+     * @returns A promise that resolves to true when initialization is complete.
+     */
+    async onInit(node) {
+        this._context = await this._createPlayContext(node);
+        return true;
+    }
+    /**
+     * Starts the strategy.
+     * @param node - The OutputStreamNode instance.
+     * @returns A boolean indicating whether the strategy started successfully.
+     */
+    onStart( /* node: OutputStreamNode */) {
+        if (!this._context) {
+            throw new Error('Invalid state: context is null.');
+        }
+        this._context.start();
+        return true;
+    }
+    /**
+     * Stops the strategy.
+     */
+    onStopped() {
+        if (!this._context) {
+            throw new Error('Invalid state: context is null.');
+        }
+        this._context.stopped();
+    }
+}
+//# sourceMappingURL=worker-strategy.js.map

package/dist/write-strategy/worker/worker-strategy.js.map

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

package/dist/write-strategy/worker/worker.d.ts

@@ -2,14 +2,16 @@ import type { FrameBufferFiller } from '../../frame-buffer/buffer-filler';
 /**
  * BufferFillWorker class
  * Manages the communication between the main thread and the worker.
- */
+ *
+ * @template FillerParams - The parameters used by the FrameBufferFiller in the worker.
+*/
 export declare class BufferFillWorker<FillerParams> {
     private _context;
     private _frameBufferFillerGenerator;
     private _init?;
     /**
      * Creates an instance of BufferFillWorker.
-     * @param generator - A generator function to create the FrameBufferFiller instance.
+     * @param generator - A constructor function to create an instance of the FrameBufferFiller class.
      * @param init - An optional initialization function.
      */
     constructor(generator: new (params: FillerParams) => FrameBufferFiller, init?: () => Promise<void>);

package/dist/write-strategy/worker/worker.js

@@ -1,4 +1,4 @@
-import { createFrameBufferWriter } from '../../frame-buffer/buffer-config';
+import { FrameBufferWriter } from '../../frame-buffer/buffer-writer';
 /**
  * Context class
  * Manages the buffer filling process within a web worker.
@@ -15,7 +15,7 @@ class Context {
      * @param frameBufferFiller - The FrameBufferFiller instance.
      */
     constructor(config, frameBufferFiller) {
-        this._frameBufferWriter = createFrameBufferWriter(config);
+        this._frameBufferWriter = new FrameBufferWriter(config);
         this._frameBufferFiller = frameBufferFiller;
         this._fillInterval = config.fillInterval;
         this._isContinuePlayback = this.fillBuffer();
@@ -66,14 +66,16 @@ class Context {
 /**
  * BufferFillWorker class
  * Manages the communication between the main thread and the worker.
- */
+ *
+ * @template FillerParams - The parameters used by the FrameBufferFiller in the worker.
+*/
 export class BufferFillWorker {
     _context = null;
     _frameBufferFillerGenerator;
     _init;
     /**
      * Creates an instance of BufferFillWorker.
-     * @param generator - A generator function to create the FrameBufferFiller instance.
+     * @param generator - A constructor function to create an instance of the FrameBufferFiller class.
      * @param init - An optional initialization function.
      */
     constructor(generator, init) {

package/dist/write-strategy/worker/worker.js.map

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

package/dist/write-strategy/worker-strategy.d.ts

@@ -0,0 +1,34 @@
+import type { BufferWriteStrategy } from './strategy';
+import type { FillerFrameBufferConfig } from '../frame-buffer/buffer-config';
+import type { OutputStreamNode } from '../output-stream-node';
+/**
+ * WorkerBufferWriteStrategy class
+ * Implements the BufferWriteStrategy interface using a web worker to manage buffer filling.
+ */
+export declare class WorkerBufferWriteStrategy<FillerParam> implements BufferWriteStrategy {
+    private readonly _createPlayContext;
+    private _context;
+    /**
+     * Creates an instance of WorkerBufferWriteStrategy.
+     * @param config - The configuration for the filler frame buffer.
+     * @param workerConstructor - The constructor for the Worker.
+     * @param fillerParam - The parameters for the FrameBufferFiller.
+     */
+    constructor(config: FillerFrameBufferConfig, workerConstructor: new () => Worker, fillerParam: FillerParam);
+    /**
+     * Initializes the strategy.
+     * @param node - The OutputStreamNode instance.
+     * @returns A promise that resolves to true when initialization is complete.
+     */
+    onInit(node: OutputStreamNode): Promise<boolean>;
+    /**
+     * Starts the strategy.
+     * @param node - The OutputStreamNode instance.
+     * @returns A boolean indicating whether the strategy started successfully.
+     */
+    onStart(): boolean;
+    /**
+     * Stops the strategy.
+     */
+    onStopped(): void;
+}

package/dist/write-strategy/worker-strategy.js

@@ -0,0 +1,125 @@
+/**
+ * PlayContext class
+ * Manages the buffer filling process within a web worker.
+ */
+class Context {
+    _node;
+    _config;
+    _fillerParam;
+    _worker;
+    /**
+     * Creates an instance of PlayContext.
+     * @param params - The parameters for the PlayContext.
+     */
+    constructor(params) {
+        this._node = params.node;
+        this._config = params.config;
+        this._worker = new params.workerConstructor();
+        this._fillerParam = params.fillerParam;
+        this._worker.onmessage = this.handleWorkerMessage.bind(this);
+    }
+    /**
+     * Creates and initializes an instance of PlayContext.
+     * @param params - The parameters for the PlayContext.
+     * @returns A promise that resolves to an instance of PlayContext.
+     */
+    static async create(params) {
+        const instance = new Context(params);
+        await instance.init();
+        return instance;
+    }
+    /**
+     * Handles messages from the worker.
+     * @param ev - The message event from the worker.
+     */
+    handleWorkerMessage(ev) {
+        if (ev.data.type === 'stop') {
+            this._node.stop(ev.data.stopFrames);
+        }
+    }
+    /**
+     * Initializes the PlayContext by sending the 'init' message to the worker.
+     * @returns A promise that resolves when initialization is complete.
+     */
+    init() {
+        return new Promise((resolve) => {
+            const message = {
+                type: 'init',
+                config: this._config,
+                fillerParams: this._fillerParam,
+            };
+            this._worker.postMessage(message);
+            const listener = (ev) => {
+                if (ev.data.type === 'init-done') {
+                    this._worker.removeEventListener('message', listener);
+                    resolve();
+                }
+            };
+            this._worker.addEventListener('message', listener);
+        });
+    }
+    /**
+     * Starts the buffer filling process by sending the 'start' message to the worker.
+     */
+    start() {
+        const message = {
+            type: 'start',
+        };
+        this._worker.postMessage(message);
+    }
+    /**
+     * Stops the worker and terminates it.
+     */
+    stopped() {
+        this._worker.onmessage = null;
+        this._worker.terminate();
+    }
+}
+/**
+ * WorkerBufferWriteStrategy class
+ * Implements the BufferWriteStrategy interface using a web worker to manage buffer filling.
+ */
+export class WorkerBufferWriteStrategy {
+    _createPlayContext;
+    _context = null;
+    /**
+     * Creates an instance of WorkerBufferWriteStrategy.
+     * @param config - The configuration for the filler frame buffer.
+     * @param workerConstructor - The constructor for the Worker.
+     * @param fillerParam - The parameters for the FrameBufferFiller.
+     */
+    constructor(config, workerConstructor, fillerParam) {
+        this._createPlayContext = (node) => Context.create({ node, config, workerConstructor, fillerParam });
+    }
+    /**
+     * Initializes the strategy.
+     * @param node - The OutputStreamNode instance.
+     * @returns A promise that resolves to true when initialization is complete.
+     */
+    async onInit(node) {
+        this._context = await this._createPlayContext(node);
+        return true;
+    }
+    /**
+     * Starts the strategy.
+     * @param node - The OutputStreamNode instance.
+     * @returns A boolean indicating whether the strategy started successfully.
+     */
+    onStart( /* node: OutputStreamNode */) {
+        if (!this._context) {
+            throw new Error('Invalid state: context is null.');
+        }
+        this._context.start();
+        return true;
+    }
+    /**
+     * Stops the strategy.
+     */
+    onStopped() {
+        if (!this._context) {
+            throw new Error('Invalid state: context is null.');
+        }
+        this._context.stopped();
+    }
+}
+//# sourceMappingURL=worker-strategy.js.map

package/dist/write-strategy/worker-strategy.js.map

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

package/package.json

@@ -1,7 +1,6 @@
 {
   "name": "@ain1084/audio-worklet-stream",
-  "version": "1.0.3",
-  "main": "dist/index.js",
+  "version": "1.0.5",
   "module": "dist/index.js",
   "types": "dist/index.d.ts",
   "files": [
@@ -31,7 +30,7 @@
   "bugs": {
     "url": "https://github.com/ain1084/audio-worklet-stream/issues"
   },
-  "homepage": "https://github.com/ain1084/audio-worklet-stream#readme",
+  "homepage": "https://ain1084.github.io/audio-worklet-stream/",
   "scripts": {
     "build": "tsc",
     "watch": "tsc --watch",
@@ -41,14 +40,17 @@
   },
   "devDependencies": {
     "@stylistic/eslint-plugin": "^2.9.0",
-    "@types/audioworklet": "^0.0.61",
-    "@types/node": "^22.7.6",
-    "@typescript-eslint/parser": "^8.9.0",
-    "eslint": "^9.12.0",
+    "@types/audioworklet": "^0.0.62",
+    "@types/node": "^22.8.4",
+    "@typescript-eslint/parser": "^8.12.2",
+    "eslint": "^9.13.0",
     "globals": "^15.11.0",
     "typedoc": "^0.26.10",
     "typescript": "^5.6.3",
-    "typescript-eslint": "^8.9.0",
-    "vite": "^5.4.9"
+    "typescript-eslint": "^8.12.2",
+    "vite": "^5.4.10"
+  },
+  "dependencies": {
+    "@ain1084/array-buffer-partitioner": "^0.0.3"
   }
 }

package/src/frame-buffer/buffer-config.ts

@@ -1,5 +1,4 @@
-import { FrameBuffer } from './buffer'
-import { FrameBufferWriter } from './buffer-writer'
+import { createArrayBufferViews } from '@ain1084/array-buffer-partitioner'
 
 /**
  * The default number of chunks in the frame buffer when
@@ -74,18 +73,6 @@ export type FillerFrameBufferConfig = FrameBufferConfig & Readonly<{
   fillInterval: number
 }>
 
-/**
- * Creates a FrameBufferWriter instance.
- * @param config - The configuration for the FrameBuffer.
- * @returns A new instance of FrameBufferWriter.
- */
-export const createFrameBufferWriter = (config: FrameBufferConfig): FrameBufferWriter => {
-  return new FrameBufferWriter(
-    new FrameBuffer(config.sampleBuffer, config.samplesPerFrame),
-    config.usedFramesInBuffer, config.totalWriteFrames,
-  )
-}
-
 /**
  * Creates a FrameBufferConfig instance.
  * @param params - The parameters for the FrameBuffer.
@@ -93,13 +80,13 @@ export const createFrameBufferWriter = (config: FrameBufferConfig): FrameBufferW
  */
 export const createFrameBufferConfig = (params: FrameBufferParams): FrameBufferConfig => {
   return {
-    sampleBuffer: new Float32Array(
-      new SharedArrayBuffer(params.frameBufferSize * params.channelCount * Float32Array.BYTES_PER_ELEMENT),
-    ),
+    ...createArrayBufferViews(SharedArrayBuffer, {
+      sampleBuffer: [Float32Array, params.frameBufferSize * params.channelCount],
+      usedFramesInBuffer: [Uint32Array, 1],
+      totalReadFrames: [BigUint64Array, 1],
+      totalWriteFrames: [BigUint64Array, 1],
+    }),
     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)),
   }
 }
 

package/src/frame-buffer/buffer-reader.ts

@@ -1,4 +1,5 @@
 import { FrameBuffer } from './buffer'
+import { FrameBufferConfig } from './buffer-config'
 
 /**
  * FrameBufferReader class
@@ -12,15 +13,18 @@ export class FrameBufferReader {
   private _index: number = 0
 
   /**
+   * @internal
    * Creates an instance of FrameBufferReader.
-   * @param frameBuffer - The shared buffer to read from.
-   * @param usedFramesInBuffer - The Uint32Array tracking the usage of the buffer.
-   * @param totalFrames - The BigUint64Array tracking the total frames read from the buffer.
+   * @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(frameBuffer: FrameBuffer, usedFramesInBuffer: Uint32Array, totalFrames: BigUint64Array) {
-    this._frameBuffer = frameBuffer
-    this._usedFramesInBuffer = usedFramesInBuffer
-    this._totalFrames = totalFrames
+  constructor(config: FrameBufferConfig) {
+    this._frameBuffer = new FrameBuffer(config.sampleBuffer, config.samplesPerFrame)
+    this._usedFramesInBuffer = config.usedFramesInBuffer
+    this._totalFrames = config.totalReadFrames
   }
 
   /**

package/src/frame-buffer/buffer-writer.ts

@@ -1,4 +1,5 @@
 import { FrameBuffer } from './buffer'
+import { FrameBufferConfig } from './buffer-config'
 
 /**
  * FrameBufferWriter class
@@ -12,15 +13,18 @@ export class FrameBufferWriter {
   private _index: number = 0
 
   /**
+   * @internal
    * Creates an instance of FrameBufferWriter.
-   * @param frameBuffer - The shared buffer to write to.
-   * @param usedFramesInBuffer - The Uint32Array tracking the usage of the buffer.
-   * @param totalFrames - The BigUint64Array tracking the total frames written to the buffer.
+   * @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(frameBuffer: FrameBuffer, usedFramesInBuffer: Uint32Array, totalFrames: BigUint64Array) {
-    this._frameBuffer = frameBuffer
-    this._usedFramesInBuffer = usedFramesInBuffer
-    this._totalFrames = totalFrames
+  constructor(config: FrameBufferConfig) {
+    this._frameBuffer = new FrameBuffer(config.sampleBuffer, config.samplesPerFrame)
+    this._usedFramesInBuffer = config.usedFramesInBuffer
+    this._totalFrames = config.totalWriteFrames
   }
 
   /**

package/src/index.ts

@@ -5,5 +5,6 @@ export type { FrameBufferFiller } from './frame-buffer/buffer-filler'
 export { StreamNodeFactory,
   type ManualBufferNodeParams,
   type TimedBufferNodeParams,
+  type WorkerBufferNodeParams,
 } from './stream-node-factory'
 export { BufferFillWorker } from './write-strategy/worker/worker'