@ain1084/audio-worklet-stream 0.1.6 → 0.1.7

package/README.md

@@ -12,29 +12,41 @@ This library was created for use in my project [fbdplay_wasm](https://github.com
 ## Features
 
 - **Manual Buffer Writing**: Provides the ability to manually write audio frames to a buffer.
-- **Multiple Buffer Writing Strategies**: Includes support for various strategies like manual, timer-based, and worker-based buffer writing.
-- **Worker-Based Stability**: Utilizes Workers to ensure stable and consistent audio playback.
+- **Multiple Buffer Writing Strategies**: Includes support for manual, timer-based, and worker-based buffer writing.
+- **Worker-Based Stability**: Utilizes Workers to ensure stable and consistent audio playback, reducing the impact of UI thread throttling.
 - **Vite Integration**: Leverages Vite for easy worker loading and configuration without complex setup.
 - **Audio Worklet Integration**: Seamlessly integrates with the Web Audio API's Audio Worklet for real-time audio processing.
+- **Optimized Performance**: Designed for efficient real-time audio processing with batch frame handling.
 
-## Confirmed Browser Support
+## Browser Compatibility
+
+<details>
+<summary>Click to expand browser compatibility details</summary>
+
+This library uses modern Web APIs and is designed for contemporary browsers only. Tested and confirmed working on:
 
 |Feature|Chrome|Chrome (Android)|Firefox|Safari (macOS)|Safari (iOS)|Edge|Opera|
 |:--|:--:|:--:|:--:|:--:|:--:|:--:|:--:|
-|Basic Support|![Chrome](https://img.icons8.com/color/24/000000/chrome.png)|![Chrome](https://img.icons8.com/color/24/000000/chrome.png)|![Firefox](https://img.icons8.com/color/24/000000/firefox.png)|![Safari](https://img.icons8.com/color/24/000000/safari--v2.png)|![Safari](https://img.icons8.com/color/24/000000/safari--v2.png)|![Edge](https://img.icons8.com/color/24/000000/ms-edge.png)|![Opera](https://img.icons8.com/color/24/000000/opera.png)|
+|Basic Support|✅|✅|✅|✅|❓|✅|❓|
 |Manual Buffer Writing|✅|✅|✅|✅|❓|✅|❓|
 |Timer-Based Buffer Writing|✅|✅|✅|🔺|❓|✅|❓|
 |Worker-Based Stability|✅|✅|✅|✅|❓|✅|❓|
 
-### Legend
+Legend:
 - ✅: Confirmed and working without issues
 - 🔺: Confirmed with limitations (e.g., unstable in background operation)
 - ❓: Not yet confirmed
 
+Note: Compatibility with Safari on iOS has not been confirmed due to lack of test devices.
+
+To check compatibility in your environment, please run the demo in the example directory.
+
+</details>
+
 ## Prerequisites
 
 - **Node.js** and **npm**: Make sure you have Node.js (version 20 or higher) and npm installed. This library hasn't been tested on versions below 20.
-- **Vite**: This library uses Vite as the bundler for its simplicity in loading and configuring workers. The developer uses Nuxt3, which is compatible with Vite.
+- **Vite**: This library uses Vite as the bundler for its simplicity in loading and configuring workers.
 
 ## Installation
 
@@ -44,6 +56,9 @@ To install the library, run:
 npm install @ain1084/audio-worklet-stream
 ```
 
+<details>
+<summary>Click to view configuration details</summary>
+
 You need to add `@ain1084/audio-worklet-stream` to the optimizeDeps.exclude section in `vite.config.ts`. Furthermore, include the necessary CORS settings to enable the use of `SharedArrayBuffer`.
 
 **vite.config.ts**
@@ -91,14 +106,6 @@ export default defineNuxtConfig({
       },
     ],
   },
-})
-```
-
-Additionally, add the Nitro configuration (needed when running `npm run build`).
-
-**nuxt.config.ts**
-```typescript
-export default defineNuxtConfig({
   nitro: {
     rollupConfig: {
       external: '@ain1084/audio-worklet-stream',
@@ -116,114 +123,117 @@ export default defineNuxtConfig({
 })
 ```
 
+</details>
+
 ## Usage
 
+<details>
+<summary>Click to expand usage details</summary>
+
 ### Overview
 
-This library continuously plays audio sample frames using `AudioWorkletNode`. The audio sample frames need to be supplied externally via a ring buffer. The library provides functionality to retrieve the number of written and read (played) frames and allows stopping playback at a specified frame.
+This library continuously plays audio sample frames using AudioWorkletNode. The audio sample frames need to be supplied externally via a ring buffer. The library provides functionality to retrieve the number of written and read (played) frames and allows stopping playback at a specified frame.
 
-### Buffer Writing Methods
+The output-only AudioNode is implemented by the OutputStreamNode class, which inherits from AudioWorkletNode. This class adds functionalities such as stream playback, stopping, and retrieving playback position to the AudioWorkletNode.
 
-- **Manual**: The consumer is responsible for writing to the ring buffer. If the buffer becomes empty, silence is played. This method requires active management to ensure the buffer is always filled with audio data.
-  - *Example*：
-    ```typescript
-    const writer = await main.createManualNode();
-    // Write arbitrary audio frames
-    writer.write(...);
-    main.start();
-    ```
-
-- **Timed**: Uses a UI thread timer to periodically write to the buffer. Frames to be written to the buffer are requested through `FrameBufferFiller`.
-  - *Example*：
-    ```typescript
-    await main.createTimedNode();
-    main.start();
-    ```
-
-- **Worker**: Similar to Timed but uses a timer in a Worker instead of the UI thread. This approach provides more stable playback by avoiding UI thread throttling. See the [MDN Web Docs on setInterval delay restrictions](https://developer.mozilla.org/en-US/docs/Web/API/setInterval#delay_restrictions) for more details.
-  - *Example*：
-    ```typescript
-    await main.createWorkerNode();
-    main.start();
-    ```
-
-Below is a reference implementation of `main` used in the examples.
-
-Note: The imported `sine-wave-frame-buffer-filler` and `worker` can be found in the `example/src/` directory.
+Instances of OutputStreamNode cannot be constructed directly. First, an instance of StreamNodeFactory needs to be created. The StreamNodeFactory is instantiated by calling its static create method with a BaseAudioContext as an argument. This method internally loads the necessary modules. Then, through the returned instance, the construction of OutputStreamNode becomes possible.
 
+The library does not handle the construction or destruction of AudioContext. When constructing AudioContext, be sure to do so in response to a user interaction, such as a UI event (e.g., button press).
+
+Example:
 ```typescript
-import { StreamNodeFactory, type OutputStreamNode } from '@ain1084/audio-worklet-stream';
-import worker from './worker?worker';
-import type { FillerParameters } from './sine-wave-frame-buffer-filler';
-import { SineWaveFrameBufferFiller } from './sine-wave-frame-buffer-filler';
-
-class Main {
-  private factory: StreamNodeFactory | null = null;
-  private streamNode: OutputStreamNode | null = null;
-
-  // Initialize the AudioContext and StreamNodeFactory
-  async init() {
-    const audioContext = new AudioContext();
-    this.factory = await StreamNodeFactory.create(audioContext);
-  }
+let audioContext: AudioContext | null = null
+let factory: StreamNodeFactory | null = null
 
-  // Create a manual buffer node
-  async createManualNode() {
-    if (!this.factory) throw new Error('Factory not initialized');
-    const [node, writer] = await this.factory.createManualBufferNode({
-      channelCount: 2,
-      frameBufferSize: 4096,
-    });
-    this.streamNode = node;
-    return writer;
+const clicked = async () => {
+  if (!audioContext) {
+    audioContext = new AudioContext()
+    factory = await StreamNodeFactory.create(audioContext)
   }
+  const node = await factory.createManualBufferNode( { channelCount: 2, frameBufferSize: 4096 })
+}
+```
 
-  // Create a timed buffer node
-  async createTimedNode() {
-    if (!this.factory) throw new Error('Factory not initialized');
-    const filler = new SineWaveFrameBufferFiller({ frequency: 440, sampleRate: 44100 });
-    this.streamNode = await this.factory.createTimedBufferNode(filler, {
-      channelCount: 2,
-      fillInterval: 20,
-      sampleRate: 44100,
-    });
-  }
+### Buffer Writing Methods
 
-  // Create a worker buffer node
-  async createWorkerNode() {
-    if (!this.factory) throw new Error('Factory not initialized');
-    this.streamNode = await this.factory.createWorkerBufferNode<FillerParameters>(worker, {
-      channelCount: 2,
-      fillInterval: 20,
-      sampleRate: 44100,
-      fillerParams: { frequency: 440, sampleRate: 44100 },
-    });
-  }
+As outlined in the overview, OutputStreamNode requires external audio samples. These samples must be written to a ring buffer, and there are several methods to achieve this.
 
-  // Start the audio stream
-  // Node’s streaming process (such as timer activation) does not start until start() is called.
-  start() {
-    if (!this.streamNode) throw new Error('Stream node not created');
-    this.streamNode.connect(this.streamNode.context.destination);
-    this.streamNode.start();
-  }
+#### Manual
 
-  // Stop the audio stream
-  // stop() internally calls node.disconnect(). Since inter-thread communication may take some time, it returns a Promise.
-  stop() {
-    if (!this.streamNode) throw new Error('Stream node not created');
-    return this.streamNode.stop();
-  }
-}
+- This method involves manually writing to the ring buffer. Use the `OutputStreamFactory.createManualBufferNode` method, specifying the number of channels and frames.
+- When the OutputStreamNode is first constructed, the ring buffer is empty. Typically, you need to write to the ring buffer before starting playback. While the node is playing, you must continue writing to the ring buffer to prevent audio frame depletion.
+- If the audio frames run out, the stream playback continues with the node outputting silence.
+- To stop the stream playback, call the `stop()` method of OutputStreamNode. You can specify the frame at which to stop playback. If you want to play all the written frames, you can specify the total number of written frames, which can be obtained via the FrameBufferWriter.
 
-export default new Main();
-```
+#### Timed
+
+- This method writes to the ring buffer using a timer initiated on the UI thread. Create it using the `OutputStreamFactory.createTimedBufferNode()` method, specifying the number of channels, timer interval, and the FrameBufferFiller that supplies samples to the buffer.
+- Writing to the ring buffer is handled by the FrameBufferFiller. The timer periodically calls the `fill` method of the FrameBufferFiller, which supplies audio frames via the FrameBufferWriter.
+- If the audio frames run out, the stream playback continues with the node outputting silence.
+- If the `fill` method of the FrameBufferFiller returns false, it indicates the end of the audio frame supply. Once OutputStreamNode outputs all the written frames, the stream automatically stops and disconnects.
+- Like the Manual method, you can also stop playback at any time using the `stop()` method.
+
+#### Worker
+
+- Similar to the Timed method, this method uses a timer to write to the ring buffer, but the timer runs within a Worker. This approach reduces the impact of UI thread throttling, providing more stable playback.
+- Create it using the `OutputStreamFactory.createWorkerBufferNode()` method.
+- Writing to the ring buffer occurs within the Worker.
+- While the ring buffer writing is still managed by the FrameBufferFiller, the instance must be created and used within the Worker.
+- The instantiation of the FrameBufferFiller implementation class is done within the Worker.
+- You need to create a custom Worker, but helper implementations are available, simplifying this process. Essentially, you only need to specify the FrameBufferFiller implementation class within the Worker.
+- Depending on how you implement the FrameBufferFiller class, you can use the same implementation as the Timed method.
+
+</details>
 
-## Documentation
+## Buffer Underrun Handling
 
-For more detailed documentation, visit the [API documentation](https://ain1084.github.io/audio-worklet-stream/).
+- When the buffer becomes empty, silent audio is output instead of throwing an error.
+- The AudioNode continues to operate and consume CPU resources even during silent output.
+- Normal audio output resumes automatically when new audio data is supplied.
+- An UnderrunEvent is emitted upon recovery from an underrun, reporting the duration of silence (note: this is a post-event notification).
 
-## Provided Example
+## Details of Configuration Parameters
+
+<details>
+<summary>Click to view details about configuration parameters</summary>
+
+Understanding these parameters is crucial for optimal audio performance:
+
+### channelCount (All strategies)
+- Specifies the number of audio channels (e.g., 2 for stereo).
+- Determines the sample composition within each frame.
+
+### frameBufferSize (Manual strategy only)
+- Defines the size of the ring buffer in frames.
+- For continuous streaming, new frames must be supplied before buffer depletion.
+- Larger size: Less susceptible to interruptions, but increases latency.
+- Smaller size: Requires more frequent writes, potentially increasing CPU load.
+- Manual strategy: Must be specified.
+- Timed/Worker strategies: Calculated internally based on fillInterval.
+
+### fillInterval (Timed and Worker strategies only)
+- Specifies the interval for buffer refill timer.
+- Default: 20ms.
+
+### frameBufferChunks (Timed and Worker strategies only)
+- Specifies the number of chunks in the total buffer size.
+- Default: 5.
+
+Example calculation:
+For 48kHz sample rate and 20ms fillInterval:
+- One chunk size = 48000 * 0.02 = 960 frames
+- Total buffer size with default 5 chunks = 960 * 5 = 4800 frames
+
+The actual values may slightly differ from the above because they are rounded up to 128 sample units.
+
+</details>
+
+## Example
+
+<details>
+<summary>Click to view example details</summary>
+
+The example can be found at [https://github.com/ain1084/audio-worklet-stream/tree/main/example](https://github.com/ain1084/audio-worklet-stream/tree/main/example).
 
 The provided example demonstrates how to use the library to manually write audio frames to a buffer. It includes:
 
@@ -233,11 +243,199 @@ The provided example demonstrates how to use the library to manually write audio
 - **Worker** (`example/src/worker.ts`): Sets up a worker to handle buffer filling tasks.
 - **HTML Entry Point** (`example/index.html`): Provides the HTML structure and buttons to control the audio stream.
 
-For more details, refer to the `example/README.md`.
+For more details, refer to the [example/README.md](https://github.com/ain1084/audio-worklet-stream/tree/main/example/README.md).
+
+</details>
+
+## Performance Optimization Guide
+
+<details>
+<summary>Click to expand performance optimization details</summary>
+
+This guide provides tips and best practices for optimizing the performance of your audio application using the Audio Worklet Stream Library.
+
+### Batch Processing
+
+Our library is optimized for processing audio frames in large batches. To maximize performance:
+
+1. When implementing your own audio generation or processing logic, work with larger chunks of audio data whenever possible.
+2. Utilize the library's ability to handle multiple frames at once in your buffer filling strategies.
+
+### Buffer Size Considerations
+
+- Larger buffer sizes can improve performance but may increase latency.
+- Experiment with different buffer sizes to find the optimal balance between performance and latency for your specific use case.
+
+### Worker-Based Strategy
+
+For the most stable playback, especially in scenarios where the main thread might be busy:
+
+1. Use the Worker-based buffer writing strategy.
+2. Implement computationally intensive tasks within the Worker to avoid impacting the main thread.
+
+### Memory Management
+
+- When working with multiple audio streams, be mindful of memory usage.
+- For scenarios requiring numerous concurrent audio streams, pay attention to the creation and resource management of each stream. Consider properly releasing unused streams when necessary.
+
+### Avoid Frequent AudioContext Creation
+
+- Creating new AudioContext instances is expensive. Reuse existing contexts when possible.
+- If your application requires multiple audio streams, try to use a single AudioContext for all of them.
+
+### Profiling and Monitoring
+
+- Use browser developer tools to profile your application and identify performance bottlenecks.
+- Monitor CPU usage and audio underruns to ensure smooth playback.
+
+By following these guidelines, you can ensure that your audio application runs efficiently and provides a smooth user experience.
+
+</details>
+
+## Advanced Usage Guide
+
+<details>
+<summary>Click to expand advanced usage details</summary>
+
+This guide covers advanced usage scenarios and techniques for the Audio Worklet Stream Library.
+
+### Custom Buffer Filling Strategies
+
+While the library provides manual, timed, and worker-based strategies, you can create custom strategies:
+
+1. Implement the `BufferWriteStrategy` interface.
+2. Override the `onInit`, `onStart`, and `onStopped` methods to define your custom behavior.
+
+Example:
+```typescript
+class CustomStrategy implements BufferWriteStrategy {
+  async onInit(node: OutputStreamNode): Promise<boolean> {
+    // Custom initialization logic
+  }
+
+  onStart(node: OutputStreamNode): boolean {
+    // Custom start logic
+  }
+
+  onStopped(): void {
+    // Custom stop logic
+  }
+}
+```
+
+### Advanced Worker Usage
+
+For complex audio processing tasks:
+
+1. Create a custom Worker that extends `BufferFillWorker`.
+2. Implement advanced audio processing algorithms within the Worker.
+3. Use `SharedArrayBuffer` for efficient data sharing between the main thread and the Worker.
+
+### Handling Multiple Audio Streams
+
+When working with multiple audio streams:
+
+1. Create separate `OutputStreamNode` instances for each stream.
+2. Manage their lifecycle and synchronization carefully.
+3. Consider implementing a mixer if you need to combine multiple streams.
+
+### Integrating with Other Web Audio API Features
+
+You can combine this library with other Web Audio API features:
+
+1. Connect the `OutputStreamNode` to other AudioNodes for additional processing.
+2. Use AnalyserNode for visualizations.
+3. Implement spatial audio using PannerNode.
+
+### Error Handling and Debugging
+
+For robust applications:
+
+1. Implement comprehensive error handling, especially for Worker-based strategies.
+2. Use the UnderrunEvent to detect and handle buffer underruns.
+3. Implement logging or metrics collection for performance monitoring.
+
+These advanced techniques will help you leverage the full power of the Audio Worklet Stream Library in complex audio applications.
+
+</details>
+
+## Troubleshooting Guide
+
+<details>
+<summary>Click to expand troubleshooting details</summary>
+
+This guide helps you troubleshoot common issues when using the Audio Worklet Stream Library.
+
+### Audio Playback Issues
+
+#### No Sound
+
+1. Check if your AudioContext is in the 'running' state. It may need to be resumed after user interaction.
+2. Ensure your OutputStreamNode is properly connected to the AudioContext destination.
+3. Verify that you're writing audio data to the buffer correctly.
+
+#### Choppy or Glitchy Playback
+
+1. Increase your buffer size to reduce the chance of underruns.
+2. If using the Timed strategy, consider switching to the Worker strategy for more stable playback.
+3. Check your system's CPU usage. High CPU usage can cause audio glitches.
+
+### Buffer Underruns
+
+If you're experiencing frequent UnderrunEvents:
+
+1. Increase your buffer size.
+2. Optimize your audio data generation/loading process.
+3. If using the Manual strategy, ensure you're writing to the buffer frequently enough.
+
+### Worker-Related Issues
+
+#### Worker Not Starting
+
+1. Ensure your Worker file is in the correct location and properly bundled.
+2. Check for any console errors related to Worker initialization.
+
+#### Data Not Being Processed in Worker
+
+1. Verify that your FrameBufferFiller implementation in the Worker is correct.
+2. Check the message passing between the main thread and the Worker.
+
+### Browser Compatibility Issues
+
+#### Feature Not Working in Specific Browsers
+
+1. Refer to the Browser Compatibility table in the README.
+2. Ensure you're using the latest version of the browser.
+3. Check if the required features (like SharedArrayBuffer) are enabled in the browser.
+
+### Build and Integration Issues
+
+#### Module Not Found Errors
+
+1. Ensure `@ain1084/audio-worklet-stream` is properly installed.
+2. Check your bundler configuration, especially the `optimizeDeps.exclude` setting in Vite.
+
+#### CORS Errors
+
+1. Verify that you've set the correct CORS headers as described in the installation instructions.
+2. If using a development server, ensure it's configured to send the required headers.
+
+### Performance Issues
+
+If you're experiencing poor performance:
+
+1. Profile your application using browser developer tools.
+2. Consider using the Worker strategy for computationally intensive tasks.
+3. Optimize your audio processing algorithms.
+
+If you're still facing issues after trying these solutions, please open an issue on our GitHub repository with a detailed description of the problem and steps to reproduce it.
+
+</details>
 
 ## Known Issues and Workarounds
 
-*Note: Some content overlaps with previous sections.*
+<details>
+<summary>Click to view known issues and workarounds</summary>
 
 ### SSR and Import Errors with ESM Modules
 
@@ -323,18 +521,15 @@ export default defineNuxtConfig({
 })
 ```
 
-## Future Plans and Known Issues
+</details>
+
+## Future Plans
 
-### Future Plans
-1. **Enhanced Documentation**: Improve the documentation with more examples and detailed explanations.
+We are considering potential enhancements for future releases, including:
 
-### Known Issues
-1. **Buffer Underruns**: Occasional buffer underruns under heavy CPU load.
-2. **Limited Worker Support**: Advanced features in workers might not be fully supported across all browsers.
-3. **Overhead at the Start of Playback**: The ring buffer is being generated each time.
-4. **Overhead during Worker Playback**: It seems that the Worker is being loaded every time playback starts (although it hits the cache).
+- Buffer management optimization: We are considering ways to improve memory efficiency and initialization time, especially when dealing with multiple audio streams.
 
-We are continuously working on these areas to improve the library. Contributions and suggestions are always welcome!
+Please note that these are just considerations and may or may not be implemented in future versions. We always aim to balance new features with maintaining the library's stability and simplicity.
 
 ## Notes
 
@@ -342,7 +537,6 @@ We are continuously working on these areas to improve the library. Contributions
 
 - **Security Requirements**: Since this library uses `SharedArrayBuffer`, ensuring browser compatibility requires meeting specific security requirements. For more details, refer to the [MDN Web Docs on SharedArrayBuffer Security Requirements](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/SharedArrayBuffer#security_requirements).
 
-
 ## Contribution
 
 Contributions are welcome! Please open an issue or submit a pull request on GitHub.

package/dist/frame-buffer/buffer.js

@@ -27,7 +27,7 @@ export class FrameBuffer {
      */
     setFrames(index, samples, sampleStart = 0, sampleCount) {
         index *= this._samplesPerFrame;
-        const sampleEnd = Math.min((sampleCount !== undefined) ? (sampleStart + sampleCount) : samples.length, samples.length);
+        const sampleEnd = (sampleCount !== undefined) ? Math.min(sampleStart + sampleCount, samples.length) : samples.length;
         const frames = (sampleEnd - sampleStart) / this._samplesPerFrame;
         if (!Number.isInteger(frames)) {
             throw new Error(`Error: The number of samples per frame does not match the specified number of samples. Expected samples per frame: ${this._samplesPerFrame}, but got: ${sampleEnd - sampleStart}.`);

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

@@ -1 +1 @@
-{"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,OAAO,CAAQ;IAEhC;;;;OAIG;IACH,YAAmB,MAAoB,EAAE,eAAuB;QAC9D,IAAI,CAAC,OAAO,GAAG,MAAM,CAAA;QACrB,IAAI,CAAC,gBAAgB,GAAG,eAAe,CAAA;QACvC,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,eAAe,CAAC,CAAA;IAC5D,CAAC;IAED;;;;;;;;OAQG;IACI,SAAS,CAAC,KAAa,EAAE,OAAqB,EAAE,cAAsB,CAAC,EAAE,WAAoB;QAClG,KAAK,IAAI,IAAI,CAAC,gBAAgB,CAAA;QAC9B,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,CAAA;QACtH,MAAM,MAAM,GAAG,CAAC,SAAS,GAAG,WAAW,CAAC,GAAG,IAAI,CAAC,gBAAgB,CAAA;QAChE,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CAAC,sHAAsH,IAAI,CAAC,gBAAgB,cAAc,SAAS,GAAG,WAAW,GAAG,CAAC,CAAA;QACtM,CAAC;QACD,KAAK,IAAI,WAAW,GAAG,WAAW,EAAE,WAAW,GAAG,SAAS,EAAE,EAAE,WAAW,EAAE,EAAE,KAAK,EAAE,CAAC;YACpF,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,CAAA;QAC5C,CAAC;QACD,OAAO,MAAM,CAAA;IACf,CAAC;IAED;;;;;;;;OAQG;IACI,eAAe,CAAC,UAAkB,EAAE,MAAc,EAAE,MAAsB,EAAE,YAAoB;QACrG,MAAM,eAAe,GAAG,IAAI,CAAC,gBAAgB,CAAA;QAC7C,MAAM,CAAC,OAAO,CAAC,CAAC,aAAa,EAAE,aAAa,EAAE,EAAE;YAC9C,KAAK,IAAI,CAAC,GAAG,aAAa,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,EAAE,CAAC,IAAI,eAAe,EAAE,EAAE,CAAC,EAAE,CAAC;gBACzE,aAAa,CAAC,YAAY,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,GAAG,CAAC,CAAC,CAAA;YAChE,CAAC;QACH,CAAC,CAAC,CAAA;IACJ,CAAC;IAED;;;OAGG;IACH,IAAW,MAAM;QACf,OAAO,IAAI,CAAC,OAAO,CAAA;IACrB,CAAC;CACF"}
+{"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,OAAO,CAAQ;IAEhC;;;;OAIG;IACH,YAAmB,MAAoB,EAAE,eAAuB;QAC9D,IAAI,CAAC,OAAO,GAAG,MAAM,CAAA;QACrB,IAAI,CAAC,gBAAgB,GAAG,eAAe,CAAA;QACvC,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,eAAe,CAAC,CAAA;IAC5D,CAAC;IAED;;;;;;;;OAQG;IACI,SAAS,CAAC,KAAa,EAAE,OAAqB,EAAE,cAAsB,CAAC,EAAE,WAAoB;QAClG,KAAK,IAAI,IAAI,CAAC,gBAAgB,CAAA;QAC9B,MAAM,SAAS,GAAG,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,WAAW,GAAG,WAAW,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAA;QACpH,MAAM,MAAM,GAAG,CAAC,SAAS,GAAG,WAAW,CAAC,GAAG,IAAI,CAAC,gBAAgB,CAAA;QAChE,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CAAC,sHAAsH,IAAI,CAAC,gBAAgB,cAAc,SAAS,GAAG,WAAW,GAAG,CAAC,CAAA;QACtM,CAAC;QACD,KAAK,IAAI,WAAW,GAAG,WAAW,EAAE,WAAW,GAAG,SAAS,EAAE,EAAE,WAAW,EAAE,EAAE,KAAK,EAAE,CAAC;YACpF,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,CAAA;QAC5C,CAAC;QACD,OAAO,MAAM,CAAA;IACf,CAAC;IAED;;;;;;;;OAQG;IACI,eAAe,CAAC,UAAkB,EAAE,MAAc,EAAE,MAAsB,EAAE,YAAoB;QACrG,MAAM,eAAe,GAAG,IAAI,CAAC,gBAAgB,CAAA;QAC7C,MAAM,CAAC,OAAO,CAAC,CAAC,aAAa,EAAE,aAAa,EAAE,EAAE;YAC9C,KAAK,IAAI,CAAC,GAAG,aAAa,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,EAAE,CAAC,IAAI,eAAe,EAAE,EAAE,CAAC,EAAE,CAAC;gBACzE,aAAa,CAAC,YAAY,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,GAAG,CAAC,CAAC,CAAA;YAChE,CAAC;QACH,CAAC,CAAC,CAAA;IACJ,CAAC;IAED;;;OAGG;IACH,IAAW,MAAM;QACf,OAAO,IAAI,CAAC,OAAO,CAAA;IACrB,CAAC;CACF"}

package/dist/output-stream-node.js

@@ -77,6 +77,10 @@ export class OutputStreamNode extends AudioWorkletNode {
             case 'ready':
                 this.handleStopped();
                 break;
+            case 'stopped':
+                break;
+            case 'stopping':
+                break;
             default:
                 throw new Error(`Cannot stop playback. Current state: ${this._state}`);
         }

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

@@ -1 +1 @@
-{"version":3,"file":"output-stream-node.js","sourceRoot":"","sources":["../src/output-stream-node.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAC5C,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAkBnD;;;;GAIG;AACH,MAAM,OAAO,gBAAiB,SAAQ,gBAAgB;IACnC,iBAAiB,CAAgB;IACjC,gBAAgB,CAAgB;IAChC,SAAS,CAAqB;IACvC,MAAM,GAAgB,OAAO,CAAA;IAErC;;;;;OAKG;IACH,YACE,gBAAkC,EAClC,YAA+B,EAC/B,QAA6B;QAE7B,MAAM,gBAAgB,GAAiC;YACrD,GAAG,YAAY;YACf,WAAW,EAAE,YAAY,CAAC,eAAe;SAC1C,CAAA;QACD,KAAK,CAAC,gBAAgB,EAAE,cAAc,EAAE;YACtC,kBAAkB,EAAE,CAAC,YAAY,CAAC,eAAe,CAAC;YAClD,gBAAgB;SACjB,CAAC,CAAA;QACF,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAA;QACzB,IAAI,CAAC,iBAAiB,GAAG,YAAY,CAAC,gBAAgB,CAAA;QACtD,IAAI,CAAC,gBAAgB,GAAG,YAAY,CAAC,eAAe,CAAA;QACpD,IAAI,CAAC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACrD,CAAC;IAED;;;;;;OAMG;IACI,KAAK;QACV,IAAI,IAAI,CAAC,eAAe,KAAK,CAAC,EAAE,CAAC;YAC/B,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAA;QAClE,CAAC;QACD,QAAQ,IAAI,CAAC,MAAM,EAAE,CAAC;YACpB,KAAK,OAAO;gBACV,IAAI,CAAC,MAAM,GAAG,SAAS,CAAA;gBACvB,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;oBAClC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAA;gBAClC,CAAC;gBACD,OAAO,IAAI,CAAA;YACb,KAAK,SAAS;gBACZ,OAAO,KAAK,CAAA;YACd;gBACE,MAAM,IAAI,KAAK,CAAC,yCAAyC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAA;QAC3E,CAAC;IACH,CAAC;IAED;;;;;;;;OAQG;IACI,IAAI,CAAC,SAAiB,MAAM,CAAC,CAAC,CAAC;QACpC,QAAQ,IAAI,CAAC,MAAM,EAAE,CAAC;YACpB,KAAK,SAAS;gBACZ,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;oBAC7B,IAAI,CAAC,MAAM,GAAG,UAAU,CAAA;oBACxB,MAAM,OAAO,GAAuB,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAA;oBAC5D,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAA;oBAC9B,IAAI,CAAC,gBAAgB,CAAC,SAAS,CAAC,IAAI,EAAE,GAAG,EAAE;wBACzC,OAAO,EAAE,CAAA;oBACX,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAA;gBACpB,CAAC,CAAC,CAAA;YACJ,KAAK,OAAO;gBACV,IAAI,CAAC,aAAa,EAAE,CAAA;gBACpB,MAAK;YACP;gBACE,MAAM,IAAI,KAAK,CAAC,wCAAwC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAA;QAC1E,CAAC;QACD,OAAO,OAAO,CAAC,OAAO,EAAE,CAAA;IAC1B,CAAC;IAED;;;OAGG;IACK,aAAa,CAAC,KAAuC;QAC3D,QAAQ,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YACxB,KAAK,MAAM;gBACT,IAAI,CAAC,aAAa,EAAE,CAAA;gBACpB,IAAI,CAAC,aAAa,CAAC,IAAI,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAA;gBACpD,MAAK;YACP,KAAK,UAAU;gBACb,IAAI,CAAC,aAAa,CAAC,IAAI,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAA;gBACxD,MAAK;YACP;gBACE,MAAM,IAAI,KAAK,CAAC,2BAA2B,KAAK,CAAC,IAAI,EAAE,CAAC,CAAA;QAC5D,CAAC;IACH,CAAC;IAED;;;OAGG;IACK,aAAa;QACnB,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,CAAA;QAC1B,IAAI,CAAC,UAAU,EAAE,CAAA;QACjB,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAA;QACjB,IAAI,CAAC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAA;QAC1B,IAAI,CAAC,MAAM,GAAG,SAAS,CAAA;IACzB,CAAC;IAED;;;OAGG;IACH,IAAW,OAAO;QAChB,OAAO,IAAI,CAAC,MAAM,KAAK,SAAS,CAAA;IAClC,CAAC;IAED;;;;;;;;;;;OAWG;IACH,IAAW,eAAe;QACxB,OAAO,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,CAAC,CAAC,CAAA;IAC/C,CAAC;IAED;;;;;;OAMG;IACH,IAAW,gBAAgB;QACzB,OAAO,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE,CAAC,CAAC,CAAA;IAChD,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,uBAAwB,SAAQ,gBAAgB;IAC3D;;;;;;OAMG;IACI,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,YAA8B,EAAE,IAAuB,EAAE,QAA6B;QAC/G,MAAM,IAAI,GAAG,IAAI,uBAAuB,CAAC,YAAY,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAA;QACtE,IAAI,CAAC,CAAC,MAAM,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;YACnC,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAA;QACzC,CAAC;QACD,OAAO,IAAI,CAAA;IACb,CAAC;CACF"}
+{"version":3,"file":"output-stream-node.js","sourceRoot":"","sources":["../src/output-stream-node.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ain1084/audio-worklet-stream",
-  "version": "0.1.6",
+  "version": "0.1.7",
   "main": "dist/index.js",
   "module": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/frame-buffer/buffer.ts

@@ -29,7 +29,7 @@ export class FrameBuffer {
    */
   public setFrames(index: number, samples: Float32Array, sampleStart: number = 0, sampleCount?: number): number {
     index *= this._samplesPerFrame
-    const sampleEnd = Math.min((sampleCount !== undefined) ? (sampleStart + sampleCount) : samples.length, samples.length)
+    const sampleEnd = (sampleCount !== undefined) ? Math.min(sampleStart + sampleCount, samples.length) : samples.length
     const frames = (sampleEnd - sampleStart) / this._samplesPerFrame
     if (!Number.isInteger(frames)) {
       throw new Error(`Error: The number of samples per frame does not match the specified number of samples. Expected samples per frame: ${this._samplesPerFrame}, but got: ${sampleEnd - sampleStart}.`)

package/src/output-stream-node.ts

@@ -103,6 +103,10 @@ export class OutputStreamNode extends AudioWorkletNode {
       case 'ready':
         this.handleStopped()
         break
+      case 'stopped':
+        break
+      case 'stopping':
+        break
       default:
         throw new Error(`Cannot stop playback. Current state: ${this._state}`)
     }