@ain1084/audio-worklet-stream 0.1.8 → 1.0.0

package/dist/stream-node-factory.js

@@ -1,6 +1,6 @@
 import processor from './output-stream-processor?worker&url';
 import { ManualBufferWriteStrategy } from './write-strategy/manual';
-import { FrameBufferFactory } from './frame-buffer/buffer-factory';
+import { createFillerFrameBufferConfig, createFrameBufferConfig } from './frame-buffer/buffer-config';
 import { TimedBufferWriteStrategy } from './write-strategy/timed';
 import { WorkerBufferWriteStrategy } from './write-strategy/worker/strategy';
 /**
@@ -34,7 +34,7 @@ export class StreamNodeFactory {
                 context.audioWorklet.addModule(processor),
                 import('./output-stream-node'),
             ]);
-            return new StreamNodeFactory(context, loadResults[1].OutputStreamNodeFactory);
+            return new StreamNodeFactory(context, loadResults[1].OutputStreamNode);
         }
         catch (error) {
             throw new Error('Failed to load modules: ' + error);
@@ -52,9 +52,9 @@ export class StreamNodeFactory {
         if (params.frameBufferSize <= 0 || !Number.isInteger(params.frameBufferSize)) {
             throw new Error('Invalid frameBufferSize: must be a positive integer.');
         }
-        const bufferConfig = FrameBufferFactory.createFrameBufferConfig({ ...params });
-        const strategy = new ManualBufferWriteStrategy(bufferConfig);
-        return [await this._outputStreamNodeFactory.create(this.audioContext, bufferConfig, strategy), strategy.writer];
+        const config = createFrameBufferConfig({ ...params });
+        const strategy = new ManualBufferWriteStrategy(config);
+        return [await this._outputStreamNodeFactory.create(this.audioContext, config, strategy), strategy.writer];
     }
     /**
      * Creates an OutputStreamNode with timed buffer writing strategy.
@@ -63,13 +63,13 @@ export class StreamNodeFactory {
      * @returns A promise that resolves to an OutputStreamNode instance.
      */
     async createTimedBufferNode(frameFiller, params) {
-        StreamNodeFactory.validateTimedBufferNodeParams(params);
         if (typeof frameFiller !== 'object' || frameFiller === null) {
             throw new Error('Invalid frameFiller: must be an object.');
         }
-        const config = FrameBufferFactory.createFillerFrameBufferConfig(this._audioContext.sampleRate, { ...params });
-        const strategy = new TimedBufferWriteStrategy(config, frameFiller);
-        return this._outputStreamNodeFactory.create(this.audioContext, config, strategy);
+        StreamNodeFactory.validateTimedBufferNodeParams(params);
+        const paramsWithSampleRate = StreamNodeFactory.applySampleRateToParams(params, this._audioContext.sampleRate);
+        const config = createFillerFrameBufferConfig(paramsWithSampleRate);
+        return this._outputStreamNodeFactory.create(this.audioContext, config, new TimedBufferWriteStrategy(config, frameFiller));
     }
     /**
      * Creates an OutputStreamNode with worker buffer writing strategy.
@@ -79,9 +79,9 @@ export class StreamNodeFactory {
      */
     async createWorkerBufferNode(worker, params) {
         StreamNodeFactory.validateTimedBufferNodeParams(params);
-        const config = FrameBufferFactory.createFillerFrameBufferConfig(this._audioContext.sampleRate, { ...params });
-        const strategy = new WorkerBufferWriteStrategy(config, worker, params.fillerParams);
-        return this._outputStreamNodeFactory.create(this._audioContext, config, strategy);
+        const paramsWithSampleRate = StreamNodeFactory.applySampleRateToParams(params, this._audioContext.sampleRate);
+        const config = createFillerFrameBufferConfig(paramsWithSampleRate);
+        return this._outputStreamNodeFactory.create(this._audioContext, config, new WorkerBufferWriteStrategy(config, worker, params.fillerParams));
     }
     /**
      * Validates the parameters for timed buffer node creation.
@@ -102,6 +102,21 @@ export class StreamNodeFactory {
             throw new Error('Invalid frameBufferChunks: must be a positive integer.');
         }
     }
+    /**
+     * Applies a default sample rate to the given parameters if the sampleRate is undefined.
+     * This function creates a new TimedBufferNodeParams object with the specified sampleRate,
+     * while keeping other properties unchanged.
+     *
+     * @param params - The original parameters for the TimedBufferNode.
+     * @param defaultSampleRate - The default sample rate to use if params.sampleRate is undefined.
+     * @returns A new TimedBufferNodeParams object with the sample rate applied.
+     */
+    static applySampleRateToParams(params, defaultSampleRate) {
+        return {
+            ...params,
+            sampleRate: params.sampleRate ?? defaultSampleRate,
+        };
+    }
     /**
      * Get the AudioContext associated with this factory.
      * @returns The AudioContext instance.

package/dist/stream-node-factory.js.map

@@ -1 +1 @@
-{"version":3,"file":"stream-node-factory.js","sourceRoot":"","sources":["../src/stream-node-factory.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,sCAAsC,CAAA;AAC5D,OAAO,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAA;AACnE,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAA;AAElE,OAAO,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAA;AAGjE,OAAO,EAAE,yBAAyB,EAAE,MAAM,kCAAkC,CAAA;AAkC5E;;;;;GAKG;AACH,MAAM,OAAO,iBAAiB;IACpB,aAAa,CAAc;IAClB,wBAAwB,CAAgC;IAEzE;;;;OAIG;IACH,YAAoB,OAAqB,EAAE,uBAAuD;QAChG,IAAI,CAAC,aAAa,GAAG,OAAO,CAAA;QAC5B,IAAI,CAAC,wBAAwB,GAAG,uBAAuB,CAAA;IACzD,CAAC;IAED;;;;;;OAMG;IACI,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,OAAqB;QAC9C,IAAI,CAAC;YACH,MAAM,WAAW,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;gBACpC,OAAO,CAAC,YAAY,CAAC,SAAS,CAAC,SAAS,CAAC;gBACzC,MAAM,CAAC,sBAAsB,CAAC;aAC/B,CAAC,CAAA;YACF,OAAO,IAAI,iBAAiB,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAA;QAC/E,CAAC;QACD,OAAO,KAAK,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,0BAA0B,GAAG,KAAK,CAAC,CAAA;QACrD,CAAC;IACH,CAAC;IAED;;;;OAIG;IACI,KAAK,CAAC,sBAAsB,CAAC,MAA8B;QAChE,IAAI,MAAM,CAAC,YAAY,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC;YACvE,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAA;QACtE,CAAC;QACD,IAAI,MAAM,CAAC,eAAe,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,eAAe,CAAC,EAAE,CAAC;YAC7E,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAA;QACzE,CAAC;QACD,MAAM,YAAY,GAAG,kBAAkB,CAAC,uBAAuB,CAAC,EAAE,GAAG,MAAM,EAAE,CAAC,CAAA;QAC9E,MAAM,QAAQ,GAAG,IAAI,yBAAyB,CAAC,YAAY,CAAC,CAAA;QAC5D,OAAO,CAAC,MAAM,IAAI,CAAC,wBAAwB,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,EAAE,YAAY,EAAE,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAA;IACjH,CAAC;IAED;;;;;OAKG;IACI,KAAK,CAAC,qBAAqB,CAChC,WAA8B,EAAE,MAA6B;QAE7D,iBAAiB,CAAC,6BAA6B,CAAC,MAAM,CAAC,CAAA;QACvD,IAAI,OAAO,WAAW,KAAK,QAAQ,IAAI,WAAW,KAAK,IAAI,EAAE,CAAC;YAC5D,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAA;QAC5D,CAAC;QACD,MAAM,MAAM,GAAG,kBAAkB,CAAC,6BAA6B,CAAC,IAAI,CAAC,aAAa,CAAC,UAAU,EAAE,EAAE,GAAG,MAAM,EAAE,CAAC,CAAA;QAC7G,MAAM,QAAQ,GAAG,IAAI,wBAAwB,CAAC,MAAM,EAAE,WAAW,CAAC,CAAA;QAClE,OAAO,IAAI,CAAC,wBAAwB,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAA;IAClF,CAAC;IAED;;;;;OAKG;IACI,KAAK,CAAC,sBAAsB,CACjC,MAAwB,EAAE,MAA4C;QAEtE,iBAAiB,CAAC,6BAA6B,CAAC,MAAM,CAAC,CAAA;QACvD,MAAM,MAAM,GAAG,kBAAkB,CAAC,6BAA6B,CAAC,IAAI,CAAC,aAAa,CAAC,UAAU,EAAE,EAAE,GAAG,MAAM,EAAE,CAAC,CAAA;QAC7G,MAAM,QAAQ,GAAG,IAAI,yBAAyB,CAAe,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,YAAY,CAAC,CAAA;QACjG,OAAO,IAAI,CAAC,wBAAwB,CAAC,MAAM,CAAC,IAAI,CAAC,aAAa,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAA;IACnF,CAAC;IAED;;;;OAIG;IACK,MAAM,CAAC,6BAA6B,CAAC,MAA6B;QACxE,gDAAgD;QAChD,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,MAAM,CAAC,YAAY,IAAI,CAAC,EAAE,CAAC;YACvE,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAA;QACtE,CAAC;QAED,2DAA2D;QAC3D,IAAI,MAAM,CAAC,YAAY,KAAK,SAAS,IAAI,CAAC,OAAO,MAAM,CAAC,YAAY,KAAK,QAAQ,IAAI,MAAM,CAAC,YAAY,IAAI,CAAC,CAAC,EAAE,CAAC;YAC/G,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAA;QACrE,CAAC;QAED,iEAAiE;QACjE,IAAI,MAAM,CAAC,iBAAiB,KAAK,SAAS,IAAI,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,iBAAiB,CAAC,IAAI,MAAM,CAAC,iBAAiB,IAAI,CAAC,CAAC,EAAE,CAAC;YAC7H,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAA;QAC3E,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,IAAW,YAAY;QACrB,OAAO,IAAI,CAAC,aAAa,CAAA;IAC3B,CAAC;CACF"}
+{"version":3,"file":"stream-node-factory.js","sourceRoot":"","sources":["../src/stream-node-factory.ts"],"names":[],"mappings":"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"}

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

@@ -1,5 +1,5 @@
 import { BufferWriteStrategy } from './strategy';
-import { FrameBufferConfig } from '../frame-buffer/buffer-factory';
+import { FrameBufferConfig } from '../frame-buffer/buffer-config';
 import { FrameBufferWriter } from '../frame-buffer/buffer-writer';
 /**
   * ManualBufferWriteStrategy class

package/dist/write-strategy/manual.js

@@ -1,4 +1,4 @@
-import { createFrameBufferWriter } from '../frame-buffer/buffer-factory';
+import { createFrameBufferWriter } from '../frame-buffer/buffer-config';
 /**
   * ManualBufferWriteStrategy class
   * Implements the BufferWriteStrategy interface for manually writing to the buffer.

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

@@ -1 +1 @@
-{"version":3,"file":"manual.js","sourceRoot":"","sources":["../../src/write-strategy/manual.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,uBAAuB,EAAqB,MAAM,gCAAgC,CAAA;AAG3F;;;IAGI;AACJ,MAAM,OAAO,yBAAyB;IACnB,OAAO,CAAmB;IAE3C;;;OAGG;IACH,YAAY,MAAyB;QACnC,IAAI,CAAC,OAAO,GAAG,uBAAuB,CAAC,MAAM,CAAC,CAAA;IAChD,CAAC;IAED;;;OAGG;IACH,IAAW,MAAM;QACf,OAAO,IAAI,CAAC,OAAO,CAAA;IACrB,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,MAAM,EAAC,4BAA4B;QACvC,OAAO,IAAI,CAAA;IACb,CAAC;IAED;;;;OAIG;IACH,OAAO,EAAC,4BAA4B;QAClC,OAAO,IAAI,CAAA;IACb,CAAC;IAED;;OAEG;IACH,SAAS,KAAU,CAAC;CACrB"}
+{"version":3,"file":"manual.js","sourceRoot":"","sources":["../../src/write-strategy/manual.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,uBAAuB,EAAqB,MAAM,+BAA+B,CAAA;AAG1F;;;IAGI;AACJ,MAAM,OAAO,yBAAyB;IACnB,OAAO,CAAmB;IAE3C;;;OAGG;IACH,YAAY,MAAyB;QACnC,IAAI,CAAC,OAAO,GAAG,uBAAuB,CAAC,MAAM,CAAC,CAAA;IAChD,CAAC;IAED;;;OAGG;IACH,IAAW,MAAM;QACf,OAAO,IAAI,CAAC,OAAO,CAAA;IACrB,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,MAAM,EAAC,4BAA4B;QACvC,OAAO,IAAI,CAAA;IACb,CAAC;IAED;;;;OAIG;IACH,OAAO,EAAC,4BAA4B;QAClC,OAAO,IAAI,CAAA;IACb,CAAC;IAED;;OAEG;IACH,SAAS,KAAU,CAAC;CACrB"}

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

@@ -1,5 +1,5 @@
 import { BufferWriteStrategy } from './strategy';
-import { FillerFrameBufferConfig } from '../frame-buffer/buffer-factory';
+import { FillerFrameBufferConfig } from '../frame-buffer/buffer-config';
 import { FrameBufferFiller } from '../frame-buffer/buffer-filler';
 import { OutputStreamNode } from '../output-stream-node';
 /**

package/dist/write-strategy/timed.js

@@ -1,4 +1,4 @@
-import { createFrameBufferWriter } from '../frame-buffer/buffer-factory';
+import { createFrameBufferWriter } from '../frame-buffer/buffer-config';
 /**
  * PlayContext class
  * Manages the buffer filling process using a timer.

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

@@ -1 +1 @@
-{"version":3,"file":"timed.js","sourceRoot":"","sources":["../../src/write-strategy/timed.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,uBAAuB,EAA2B,MAAM,gCAAgC,CAAA;AAKjG;;;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,uBAAuB,CAAC,MAAM,CAAC,CAAA;QAC9C,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"}
+{"version":3,"file":"timed.js","sourceRoot":"","sources":["../../src/write-strategy/timed.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,uBAAuB,EAA2B,MAAM,+BAA+B,CAAA;AAKhG;;;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,uBAAuB,CAAC,MAAM,CAAC,CAAA;QAC9C,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/message.d.ts

@@ -1,4 +1,4 @@
-import type { FillerFrameBufferConfig } from '../../frame-buffer/buffer-factory';
+import type { FillerFrameBufferConfig } from '../../frame-buffer/buffer-config';
 /**
  * Message sent from the main thread to the worker.
  *

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

@@ -1,5 +1,5 @@
 import type { BufferWriteStrategy } from '../strategy';
-import type { FillerFrameBufferConfig } from '../../frame-buffer/buffer-factory';
+import type { FillerFrameBufferConfig } from '../../frame-buffer/buffer-config';
 import type { OutputStreamNode } from '../../output-stream-node';
 /**
  * WorkerBufferWriteStrategy class

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

@@ -1,4 +1,4 @@
-import { createFrameBufferWriter } from '../../frame-buffer/buffer-factory';
+import { createFrameBufferWriter } from '../../frame-buffer/buffer-config';
 /**
  * Context class
  * Manages the buffer filling process within a web worker.

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ain1084/audio-worklet-stream",
-  "version": "0.1.8",
+  "version": "1.0.0",
   "main": "dist/index.js",
   "module": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -41,14 +41,14 @@
   },
   "devDependencies": {
     "@stylistic/eslint-plugin": "^2.9.0",
-    "@types/audioworklet": "^0.0.60",
-    "@types/node": "^22.7.5",
-    "@typescript-eslint/parser": "^8.8.1",
+    "@types/audioworklet": "^0.0.61",
+    "@types/node": "^22.7.6",
+    "@typescript-eslint/parser": "^8.9.0",
     "eslint": "^9.12.0",
-    "globals": "^15.10.0",
-    "typedoc": "^0.26.8",
-    "typescript": "^5.6.2",
-    "typescript-eslint": "^8.8.1",
-    "vite": "^5.4.8"
+    "globals": "^15.11.0",
+    "typedoc": "^0.26.10",
+    "typescript": "^5.6.3",
+    "typescript-eslint": "^8.9.0",
+    "vite": "^5.4.9"
   }
 }

package/src/events.ts

@@ -8,9 +8,9 @@ export class StopEvent extends Event {
   public static readonly type = STOP_EVENT_TYPE
   /**
    * Creates an instance of StopEvent.
-   * @param frames - The position in the audio stream where the stop occurred.
+   * @param stoppedAtFrame - The position in the audio stream where the stop occurred.
    */
-  public constructor(readonly frames: bigint) {
+  public constructor(readonly stoppedAtFrame: bigint) {
     super(StopEvent.type)
   }
 }
@@ -24,9 +24,9 @@ export class UnderrunEvent extends Event {
   public static readonly type = UNDERRUN_EVENT_TYPE
   /**
    * Creates an instance of UnderrunEvent.
-   * @param frames - The number of frames that were not processed due to the underrun.
+   * @param frameCount - The number of frames that were not processed due to the underrun.
    */
-  public constructor(readonly frames: number) {
+  public constructor(readonly frameCount: number) {
     super(UnderrunEvent.type)
   }
 }

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

@@ -0,0 +1,129 @@
+import { FrameBuffer } from './buffer'
+import { FrameBufferWriter } from './buffer-writer'
+
+/**
+ * The default number of chunks in the frame buffer when
+ * FillerFrameBufferParams.frameBufferChunks is not provided.
+ * A frame buffer sufficient to hold fillInterval * frameBufferChunks of playback time is allocated.
+ */
+const DEFAULT_FILL_INTERVAL_MS = 20
+
+/**
+ * The default number of chunks in the frame buffer when
+ * FillerFrameBufferParams.frameBufferChunks is not provided.
+ * The total frame buffer size will be fillInterval * frameBufferChunks.
+ */
+const DEFAULT_FRAME_BUFFER_CHUNKS = 5
+
+/**
+ * The unit for rounding up the frame buffer size.
+ * This value is aligned with the audio data block size used by the AudioWorkletProcessor.
+ * Reference: https://developer.mozilla.org/en-US/docs/Web/API/AudioWorkletProcessor/process
+ */
+const AUDIO_WORKLET_BLOCK_SIZE = 128
+
+/**
+ * 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 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.
+ * @returns A new instance of FrameBufferConfig.
+ */
+export const createFrameBufferConfig = (params: FrameBufferParams): FrameBufferConfig => {
+  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.
+ */
+export const createFillerFrameBufferConfig = (params: FillerFrameBufferParams): FillerFrameBufferConfig => {
+  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 ?? DEFAULT_FILL_INTERVAL_MS
+  const frameBufferSize = Math.floor(
+    sampleRate * intervalMillisecond / 1000 + (AUDIO_WORKLET_BLOCK_SIZE - 1),
+  ) & ~(AUDIO_WORKLET_BLOCK_SIZE - 1)
+  const frameBufferChunkCount = params.frameBufferChunks ?? DEFAULT_FRAME_BUFFER_CHUNKS
+  const config = createFrameBufferConfig(
+    { frameBufferSize: frameBufferSize * frameBufferChunkCount, channelCount: params.channelCount })
+  return {
+    ...config,
+    sampleRate,
+    fillInterval: intervalMillisecond,
+  }
+}

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

@@ -1,4 +1,3 @@
-import { enumFrames, type FrameCallback } from './buffer-utils'
 import { FrameBuffer } from './buffer'
 
 /**
@@ -8,19 +7,19 @@ import { FrameBuffer } from './buffer'
  */
 export class FrameBufferReader {
   private readonly _frameBuffer: FrameBuffer
-  private readonly _usedFrameInBuffer: Uint32Array
+  private readonly _usedFramesInBuffer: Uint32Array
   private readonly _totalFrames: BigUint64Array
   private _index: number = 0
 
   /**
    * Creates an instance of FrameBufferReader.
    * @param frameBuffer - The shared buffer to read from.
-   * @param usedFrameInBuffer - The Uint32Array tracking the usage of the buffer.
+   * @param usedFramesInBuffer - The Uint32Array tracking the usage of the buffer.
    * @param totalFrames - The BigUint64Array tracking the total frames read from the buffer.
    */
-  constructor(frameBuffer: FrameBuffer, usedFrameInBuffer: Uint32Array, totalFrames: BigUint64Array) {
+  constructor(frameBuffer: FrameBuffer, usedFramesInBuffer: Uint32Array, totalFrames: BigUint64Array) {
     this._frameBuffer = frameBuffer
-    this._usedFrameInBuffer = usedFrameInBuffer
+    this._usedFramesInBuffer = usedFramesInBuffer
     this._totalFrames = totalFrames
   }
 
@@ -28,29 +27,51 @@ export class FrameBufferReader {
    * Get the number of available frames in the buffer.
    * @returns The number of available frames in the buffer.
    */
-  public get available(): number {
-    return Atomics.load(this._usedFrameInBuffer, 0)
+  public get availableFrames(): number {
+    return Atomics.load(this._usedFramesInBuffer, 0)
   }
 
   /**
    * Get the total number of frames read from the buffer.
+   *
    * @returns The total number of frames read.
    */
   public get totalFrames(): bigint {
+    // 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 and processes it using the provided callback.
-   * @param frameCallback - The callback function to process each section of the buffer.
-   * @returns The number of frames processed.
-   * @throws RangeError - If the processed length exceeds the part length.
+   * 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.
+   *
    */
-  public read(frameCallback: FrameCallback): number {
-    const result = enumFrames(this._frameBuffer, this._index, this.available, frameCallback)
+  public read(processFrameSegment: (buffer: Float32Array, offset: number) => number): number {
+    const result = this._frameBuffer.enumFrameSegments(this._index, this.availableFrames, processFrameSegment)
     this._index = result.nextIndex
-    Atomics.sub(this._usedFrameInBuffer, 0, result.frames)
-    Atomics.add(this._totalFrames, 0, BigInt(result.frames))
-    return result.frames
+    Atomics.sub(this._usedFramesInBuffer, 0, result.totalProcessedFrames)
+    Atomics.add(this._totalFrames, 0, BigInt(result.totalProcessedFrames))
+    return result.totalProcessedFrames
   }
 }

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

@@ -1,4 +1,3 @@
-import { enumFrames, type FrameCallback } from './buffer-utils'
 import { FrameBuffer } from './buffer'
 
 /**
@@ -8,49 +7,71 @@ import { FrameBuffer } from './buffer'
  */
 export class FrameBufferWriter {
   private readonly _frameBuffer: FrameBuffer
-  private readonly _usedFrameInBuffer: Uint32Array
+  private readonly _usedFramesInBuffer: Uint32Array
   private readonly _totalFrames: BigUint64Array
   private _index: number = 0
 
   /**
    * Creates an instance of FrameBufferWriter.
    * @param frameBuffer - The shared buffer to write to.
-   * @param usedFrameInBuffer - The Uint32Array tracking the usage of the buffer.
+   * @param usedFramesInBuffer - The Uint32Array tracking the usage of the buffer.
    * @param totalFrames - The BigUint64Array tracking the total frames written to the buffer.
    */
-  constructor(frameBuffer: FrameBuffer, usedFrameInBuffer: Uint32Array, totalFrames: BigUint64Array) {
+  constructor(frameBuffer: FrameBuffer, usedFramesInBuffer: Uint32Array, totalFrames: BigUint64Array) {
     this._frameBuffer = frameBuffer
-    this._usedFrameInBuffer = usedFrameInBuffer
+    this._usedFramesInBuffer = usedFramesInBuffer
     this._totalFrames = totalFrames
   }
 
   /**
-   * Get the number of available spaces in the buffer.
-   * @returns The number of available spaces in the buffer.
+   * 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.
    */
-  public get available(): number {
-    return this._frameBuffer.length - Atomics.load(this._usedFrameInBuffer, 0)
+  public get availableFrames(): number {
+    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.
    */
   public get totalFrames(): bigint {
+    // This class is not used concurrently by multiple threads,
+    // so `Atomics` is not necessary when reading `totalFrames`.
     return this._totalFrames[0]
   }
 
   /**
-   * Write audio frame data to the buffer using the provided frameCallback.
-   * @param frameCallback - The frameCallback function to process each section of the buffer.
-   * @returns The number of frames processed.
-   * @throws RangeError - If the processed length exceeds the part length.
+   * 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.
    */
-  public write(frameCallback: FrameCallback): number {
-    const result = enumFrames(this._frameBuffer, this._index, this.available, frameCallback)
+  public write(processFrameSegment: (buffer: Float32Array, offset: number) => number): number {
+    const result = this._frameBuffer.enumFrameSegments(this._index, this.availableFrames, processFrameSegment)
     this._index = result.nextIndex
-    Atomics.add(this._usedFrameInBuffer, 0, result.frames)
-    Atomics.add(this._totalFrames, 0, BigInt(result.frames))
-    return result.frames
+    Atomics.add(this._usedFramesInBuffer, 0, result.totalProcessedFrames)
+    Atomics.add(this._totalFrames, 0, BigInt(result.totalProcessedFrames))
+    return result.totalProcessedFrames
   }
 }