@idealyst/audio 1.2.76 → 1.2.78

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@idealyst/audio",
-  "version": "1.2.76",
+  "version": "1.2.78",
   "description": "Unified cross-platform audio for React and React Native - recording, playback, and PCM streaming",
   "documentation": "https://github.com/IdealystIO/idealyst-framework/tree/main/packages/audio#readme",
   "readme": "README.md",

package/src/hooks/usePlayer.ts

@@ -104,6 +104,14 @@ export function usePlayer(options: UsePlayerOptions = {}): UsePlayerResult {
     }
   }, []);
 
+  // Clear buffer (immediately stops all buffered/scheduled audio)
+  const clearBuffer = useCallback(() => {
+    const player = playerRef.current;
+    if (player) {
+      player.clearBuffer();
+    }
+  }, []);
+
   // Play
   const play = useCallback(async () => {
     const player = getPlayer();
@@ -233,6 +241,7 @@ export function usePlayer(options: UsePlayerOptions = {}): UsePlayerResult {
     loadPCMStream,
     feedPCMData,
     flush,
+    clearBuffer,
 
     // Playback control
     play,

package/src/playback/Player.native.ts

@@ -49,6 +49,7 @@ export class NativePlayer implements IPlayer {
   private isStreaming: boolean = false;
   private streamScheduleInterval: ReturnType<typeof setInterval> | null = null;
   private nextScheduleTime: number = 0;
+  private scheduledSources: RNAudioBufferSourceNode[] = [];
 
   // Position tracking
   private positionIntervalId: ReturnType<typeof setInterval> | null = null;
@@ -193,6 +194,24 @@ export class NativePlayer implements IPlayer {
     }
   }
 
+  clearBuffer(): void {
+    // Clear pending PCM chunks
+    this.pcmBuffer = [];
+
+    // Stop all scheduled sources that haven't finished playing
+    this.stopScheduledSources();
+
+    // Reset schedule time to now so new audio plays immediately
+    const ctx = this.audioContext.getContext() as RNAudioContext;
+    if (ctx) {
+      this.nextScheduleTime = ctx.currentTime;
+    }
+
+    // Update buffer status
+    this._status.buffered = 0;
+    this.notifyBufferChange(0);
+  }
+
   async play(): Promise<void> {
     const ctx = this.audioContext.getContext() as RNAudioContext;
     if (!ctx) {
@@ -367,6 +386,18 @@ export class NativePlayer implements IPlayer {
     source.buffer = audioBuffer;
     source.connect(this.gainNode);
 
+    // Track this source so we can stop it on clearBuffer()
+    this.scheduledSources.push(source);
+
+    // Clean up reference when source ends (use timeout as fallback since onended may not be supported)
+    const duration = audioBuffer.duration * 1000;
+    setTimeout(() => {
+      const idx = this.scheduledSources.indexOf(source);
+      if (idx !== -1) {
+        this.scheduledSources.splice(idx, 1);
+      }
+    }, duration + 100);
+
     const scheduleTime = Math.max(this.nextScheduleTime, ctx.currentTime);
     source.start(scheduleTime);
 
@@ -412,9 +443,22 @@ export class NativePlayer implements IPlayer {
     this.stopPositionTracking();
     this.stopStreamScheduler();
     this.stopSourceNode();
+    this.stopScheduledSources();
     this.isStreaming = false;
   }
 
+  private stopScheduledSources(): void {
+    for (const source of this.scheduledSources) {
+      try {
+        source.stop();
+        source.disconnect();
+      } catch {
+        // Ignore errors
+      }
+    }
+    this.scheduledSources = [];
+  }
+
   private updateState(state: PlayerState): void {
     this._status.state = state;
     this._status.isPlaying = state === 'playing';

package/src/playback/Player.web.ts

@@ -43,6 +43,7 @@ export class WebPlayer implements IPlayer {
   private isStreaming: boolean = false;
   private streamScheduleInterval: ReturnType<typeof setInterval> | null = null;
   private nextScheduleTime: number = 0;
+  private scheduledSources: AudioBufferSourceNode[] = [];
 
   // Position tracking
   private positionIntervalId: ReturnType<typeof setInterval> | null = null;
@@ -187,6 +188,24 @@ export class WebPlayer implements IPlayer {
     }
   }
 
+  clearBuffer(): void {
+    // Clear pending PCM chunks
+    this.pcmBuffer = [];
+
+    // Stop all scheduled sources that haven't finished playing
+    this.stopScheduledSources();
+
+    // Reset schedule time to now so new audio plays immediately
+    const ctx = this.audioContext.getContext() as AudioContext;
+    if (ctx) {
+      this.nextScheduleTime = ctx.currentTime;
+    }
+
+    // Update buffer status
+    this._status.buffered = 0;
+    this.notifyBufferChange(0);
+  }
+
   async play(): Promise<void> {
     const ctx = this.audioContext.getContext() as AudioContext;
     if (!ctx) {
@@ -368,6 +387,15 @@ export class WebPlayer implements IPlayer {
     source.buffer = audioBuffer;
     source.connect(this.gainNode);
 
+    // Track this source so we can stop it on clearBuffer()
+    this.scheduledSources.push(source);
+    source.onended = () => {
+      const idx = this.scheduledSources.indexOf(source);
+      if (idx !== -1) {
+        this.scheduledSources.splice(idx, 1);
+      }
+    };
+
     const scheduleTime = Math.max(this.nextScheduleTime, ctx.currentTime);
     source.start(scheduleTime);
 
@@ -413,9 +441,22 @@ export class WebPlayer implements IPlayer {
     this.stopPositionTracking();
     this.stopStreamScheduler();
     this.stopSourceNode();
+    this.stopScheduledSources();
     this.isStreaming = false;
   }
 
+  private stopScheduledSources(): void {
+    for (const source of this.scheduledSources) {
+      try {
+        source.stop();
+        source.disconnect();
+      } catch {
+        // Ignore errors
+      }
+    }
+    this.scheduledSources = [];
+  }
+
   private updateState(state: PlayerState): void {
     this._status.state = state;
     this._status.isPlaying = state === 'playing';

package/src/types.ts

@@ -234,6 +234,7 @@ export interface IPlayer {
   loadPCMStream(config: AudioConfig): Promise<void>;
   feedPCMData(data: ArrayBuffer | Int16Array): void;
   flush(): Promise<void>;
+  clearBuffer(): void;
 
   // Playback control
   play(): Promise<void>;
@@ -438,6 +439,7 @@ export interface UsePlayerResult {
   loadPCMStream: (config: AudioConfig) => Promise<void>;
   feedPCMData: (data: ArrayBuffer | Int16Array) => void;
   flush: () => Promise<void>;
+  clearBuffer: () => void;
 
   // Playback control
   play: () => Promise<void>;