@ain1084/audio-worklet-stream 0.1.2

package/dist/write-strategy/timed.js

@@ -0,0 +1,92 @@
+import { createFrameBufferWriter } from '../frame-buffer/buffer-factory';
+/**
+ * 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 (error) {
+                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 = createFrameBufferWriter(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.js.map

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

@@ -0,0 +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,OAAO,KAAK,EAAE,CAAC;gBACb,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

@@ -0,0 +1,54 @@
+import type { FillerFrameBufferConfig } from '../../frame-buffer/buffer-factory';
+/**
+ * Message sent from the main thread to the worker.
+ *
+ * @typeParam FillerParams - The type of the parameters for the FrameBufferFiller.
+ *
+ * For 'init' messages:
+ * @property config - The configuration for the filler frame buffer.
+ * @property fillerParams - The parameters for the FrameBufferFiller.
+ *
+ * For 'start' messages:
+ *
+ * For 'stop' messages:
+ *
+ * Example:
+ * ```typescript
+ * const message: MessageToWorker<YourFillerParams> = {
+ *   type: 'init',
+ *   config: yourConfig,
+ *   fillerParams: yourFillerParams,
+ * };
+ * ```
+ */
+export type MessageToWorker<FillerParams> = {
+    type: 'init';
+    config: FillerFrameBufferConfig;
+    fillerParams: FillerParams;
+} | {
+    type: 'start';
+} | {
+    type: 'stop';
+};
+/**
+ * Message sent from the worker to the main thread.
+ *
+ * For 'init-done' messages:
+ *
+ * For 'stop' messages:
+ * @property stopFrames - The position in frames to stop at.
+ *
+ * Example:
+ * ```typescript
+ * const message: MessageToStrategy = {
+ *   type: 'stop',
+ *   stopFrames: 1000n,
+ * };
+ * ```
+ */
+export type MessageToStrategy = {
+    type: 'init-done';
+} | {
+    type: 'stop';
+    stopFrames: bigint;
+};

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"message.js","sourceRoot":"","sources":["../../../src/write-strategy/worker/message.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,34 @@
+import type { BufferWriteStrategy } from '../strategy';
+import type { FillerFrameBufferConfig } from '../../frame-buffer/buffer-factory';
+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=strategy.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"strategy.js","sourceRoot":"","sources":["../../../src/write-strategy/worker/strategy.ts"],"names":[],"mappings":"AAmBA;;;GAGG;AACH,MAAM,OAAO;IACM,KAAK,CAAkB;IACvB,OAAO,CAAyB;IAChC,YAAY,CAAc;IAC1B,OAAO,CAAQ;IAEhC;;;OAGG;IACH,YAAoB,MAAyC;QAC3D,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,IAAI,CAAA;QACxB,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,MAAM,CAAA;QAC5B,IAAI,CAAC,OAAO,GAAG,IAAI,MAAM,CAAC,iBAAiB,EAAE,CAAA;QAC7C,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC,WAAW,CAAA;QACtC,IAAI,CAAC,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAC9D,CAAC;IAED;;;;OAIG;IACI,MAAM,CAAC,KAAK,CAAC,MAAM,CAAe,MAAyC;QAChF,MAAM,QAAQ,GAAG,IAAI,OAAO,CAAC,MAAM,CAAC,CAAA;QACpC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAA;QACrB,OAAO,QAAQ,CAAA;IACjB,CAAC;IAED;;;OAGG;IACK,mBAAmB,CAAC,EAAmC;QAC7D,IAAI,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YAC5B,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;QACrC,CAAC;IACH,CAAC;IAED;;;OAGG;IACK,IAAI;QACV,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YACnC,MAAM,OAAO,GAAkC;gBAC7C,IAAI,EAAE,MAAM;gBACZ,MAAM,EAAE,IAAI,CAAC,OAAO;gBACpB,YAAY,EAAE,IAAI,CAAC,YAAY;aAChC,CAAA;YACD,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,CAAA;YACjC,MAAM,QAAQ,GAAG,CAAC,EAAmC,EAAE,EAAE;gBACvD,IAAI,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;oBACjC,IAAI,CAAC,OAAO,CAAC,mBAAmB,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAA;oBACrD,OAAO,EAAE,CAAA;gBACX,CAAC;YACH,CAAC,CAAA;YACD,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAA;QACpD,CAAC,CAAC,CAAA;IACJ,CAAC;IAED;;OAEG;IACI,KAAK;QACV,MAAM,OAAO,GAAkC;YAC7C,IAAI,EAAE,OAAO;SACd,CAAA;QACD,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,CAAA;IACnC,CAAC;IAED;;OAEG;IACI,OAAO;QACZ,IAAI,CAAC,OAAO,CAAC,SAAS,GAAG,IAAI,CAAA;QAC7B,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAA;IAC1B,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,yBAAyB;IACnB,kBAAkB,CAA2D;IACtF,QAAQ,GAAgC,IAAI,CAAA;IAEpD;;;;;OAKG;IACH,YAAY,MAA+B,EAAE,iBAAmC,EAAE,WAAwB;QACxG,IAAI,CAAC,kBAAkB,GAAG,CAAC,IAAsB,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAc,EAAE,IAAI,EAAE,MAAM,EAAE,iBAAiB,EAAE,WAAW,EAAE,CAAC,CAAA;IACrI,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,MAAM,CAAC,IAAsB;QACjC,IAAI,CAAC,QAAQ,GAAG,MAAM,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAA;QACnD,OAAO,IAAI,CAAA;IACb,CAAC;IAED;;;;OAIG;IACH,OAAO,EAAC,4BAA4B;QAClC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAA;QACpD,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAA;QACrB,OAAO,IAAI,CAAA;IACb,CAAC;IAED;;OAEG;IACH,SAAS;QACP,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAA;QACpD,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAA;IACzB,CAAC;CACF"}

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

@@ -0,0 +1,35 @@
+import type { FrameBufferFiller } from '../../frame-buffer/buffer-filler';
+/**
+ * BufferFillWorker class
+ * Manages the communication between the main thread and 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 init - An optional initialization function.
+     */
+    constructor(generator: new (params: FillerParams) => FrameBufferFiller, init?: () => Promise<void>);
+    /**
+     * Handles incoming messages from the main thread.
+     * @param event - The message event from the main thread.
+     */
+    private handleMessage;
+    /**
+     * Initializes the worker context.
+     * @param config - The configuration for the filler frame buffer.
+     * @param params - The parameters for the FrameBufferFiller.
+     */
+    private init;
+    /**
+     * Starts the buffer filling process.
+     */
+    private start;
+    /**
+     * Stops the buffer filling process.
+     */
+    private stop;
+}

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

@@ -0,0 +1,135 @@
+import { createFrameBufferWriter } from '../../frame-buffer/buffer-factory';
+/**
+ * Context class
+ * Manages the buffer filling process within a web worker.
+ */
+class Context {
+    _frameBufferWriter;
+    _isContinuePlayback;
+    _frameBufferFiller;
+    _fillInterval;
+    _timerId = 0;
+    /**
+     * Creates an instance ofContext.
+     * @param config - The configuration for the filler frame buffer.
+     * @param frameBufferFiller - The FrameBufferFiller instance.
+     */
+    constructor(config, frameBufferFiller) {
+        this._frameBufferWriter = createFrameBufferWriter(config);
+        this._frameBufferFiller = frameBufferFiller;
+        this._fillInterval = config.fillInterval;
+        this._isContinuePlayback = this.fillBuffer();
+    }
+    /**
+     * Starts the buffer filling process.
+     */
+    start() {
+        if (!this._isContinuePlayback) {
+            this.stopFrames();
+            return;
+        }
+        this._timerId = self.setInterval(() => {
+            if (!this._frameBufferFiller.fill(this._frameBufferWriter)) {
+                this.stopFrames();
+                self.clearInterval(this._timerId);
+                this._timerId = 0;
+            }
+        }, this._fillInterval);
+    }
+    /**
+     * Stops the buffer filling process.
+     */
+    stopFrames() {
+        const message = {
+            type: 'stop',
+            stopFrames: this._frameBufferWriter.totalFrames,
+        };
+        self.postMessage(message);
+    }
+    /**
+     * Stops the buffer filling process and clears the interval timer.
+     */
+    stop() {
+        if (this._timerId) {
+            self.clearInterval(this._timerId);
+            this._timerId = 0;
+        }
+    }
+    /**
+     * Fill the buffer with audio frames.
+     * @returns A boolean indicating whether to continue playback.
+     */
+    fillBuffer() {
+        return this._frameBufferFiller.fill(this._frameBufferWriter);
+    }
+}
+/**
+ * BufferFillWorker class
+ * Manages the communication between the main thread and 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 init - An optional initialization function.
+     */
+    constructor(generator, init) {
+        this._frameBufferFillerGenerator = generator;
+        this._init = init;
+        self.onmessage = this.handleMessage.bind(this);
+    }
+    /**
+     * Handles incoming messages from the main thread.
+     * @param event - The message event from the main thread.
+     */
+    async handleMessage(event) {
+        switch (event.data.type) {
+            case 'init':
+                this.init(event.data.config, event.data.fillerParams);
+                break;
+            case 'start':
+                this.start();
+                break;
+            case 'stop':
+                this.stop();
+                break;
+            default:
+                throw new Error(`Unknown message type: ${event.data}`);
+        }
+    }
+    /**
+     * Initializes the worker context.
+     * @param config - The configuration for the filler frame buffer.
+     * @param params - The parameters for the FrameBufferFiller.
+     */
+    async init(config, params) {
+        if (this._context) {
+            throw new Error('Error: Context is already created.');
+        }
+        await this._init?.();
+        this._context = new Context(config, new this._frameBufferFillerGenerator(params));
+        self.postMessage({ type: 'init-done' });
+    }
+    /**
+     * Starts the buffer filling process.
+     */
+    start() {
+        if (!this._context) {
+            throw new Error('Error: Context is not created.');
+        }
+        this._context.start();
+    }
+    /**
+     * Stops the buffer filling process.
+     */
+    stop() {
+        if (!this._context) {
+            throw new Error('Error: Context is not created.');
+        }
+        this._context.stop();
+    }
+}
+//# sourceMappingURL=worker.js.map

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

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

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@ain1084/audio-worklet-stream",
+  "version": "0.1.2",
+  "main": "dist/index.js",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "src",
+    "LICENSE",
+    "README.md"
+  ],
+  "description": "A library for handling audio output stream processing using AudioWorklet in the browser. It provides functionalities for real-time audio output processing with customizable buffer management, ideal for developers working on web-based audio applications.",
+  "keywords": [
+    "audio",
+    "stream",
+    "worklet",
+    "processor",
+    "real-time",
+    "web-audio",
+    "audio processing",
+    "ring buffer",
+    "audio context"
+  ],
+  "author": "Seiji Ainoguchi <seiji.ainoguchi@gmail.com>",
+  "license": "(MIT OR Apache-2.0)",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ain1084/audio-worklet-stream.git"
+  },
+  "bugs": {
+    "url": "https://github.com/ain1084/audio-worklet-stream/issues"
+  },
+  "homepage": "https://github.com/ain1084/audio-worklet-stream#readme",
+  "scripts": {
+    "build": "tsc",
+    "watch": "tsc --watch",
+    "lint": "eslint .",
+    "prepublishOnly": "npm run build",
+    "docs": "typedoc"
+  },
+  "devDependencies": {
+    "@stylistic/eslint-plugin": "^2.3.0",
+    "@types/audioworklet": "^0.0.57",
+    "@types/node": "^20.14.10",
+    "@typescript-eslint/parser": "^7.16.0",
+    "eslint": "^8.57.0",
+    "globals": "^15.8.0",
+    "typedoc": "^0.26.4",
+    "typescript": "^5.5.3",
+    "typescript-eslint": "^7.16.0",
+    "vite": "^5.3.3"
+  }
+}

package/src/constants.ts

@@ -0,0 +1,18 @@
+// Constants file
+
+const PREFIX = '@ain1084/audio-worklet-stream'
+
+/**
+ * The name of the output stream processor, used as the name of the AudioWorkletProcessor.
+ */
+export const PROCESSOR_NAME = `${PREFIX}/output-stream-processor`
+
+/**
+ * The event type for the stop event.
+ */
+export const STOP_EVENT_TYPE = `${PREFIX}/stop`
+
+/**
+ * The event type for the underrun event.
+ */
+export const UNDERRUN_EVENT_TYPE = `${PREFIX}/underrun`

package/src/events.ts

@@ -0,0 +1,43 @@
+import { STOP_EVENT_TYPE, UNDERRUN_EVENT_TYPE } from './constants'
+
+/**
+ * Represents a custom event indicating that the audio processing has stopped.
+ * This event is dispatched when the audio processing stops.
+ */
+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.
+   */
+  public constructor(readonly frames: bigint) {
+    super(StopEvent.type)
+  }
+}
+
+/**
+ * Represents a custom event indicating that an underrun occurred in the audio processing.
+ * UnderrunEvent is triggered not at the moment the underrun occurs, but when the underrun is resolved
+ * or just before the node stops.
+ */
+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.
+   */
+  public constructor(readonly frames: number) {
+    super(UnderrunEvent.type)
+  }
+}
+
+/**
+ * Extends the AudioWorkletNodeEventMap interface to include the custom events.
+ * This allows the custom events to be used in the context of AudioWorkletNode.
+ */
+declare global {
+  interface AudioWorkletNodeEventMap {
+    [StopEvent.type]: StopEvent
+    [UnderrunEvent.type]: UnderrunEvent
+  }
+}