react-native-audio-api 0.12.0-nightly-75589dc-20260121 → 0.12.0-nightly-6993a06-20260122

package/lib/typescript/web-core/AudioScheduledSourceNode.d.ts

@@ -2,8 +2,10 @@ import AudioNode from './AudioNode';
 import { EventEmptyType } from '../events/types';
 export default class AudioScheduledSourceNode extends AudioNode {
     protected hasBeenStarted: boolean;
+    private onEndedCallback?;
     start(when?: number): void;
     stop(when?: number): void;
+    get onEnded(): ((event: EventEmptyType) => void) | undefined;
     set onEnded(callback: (event: EventEmptyType) => void | null);
 }
 //# sourceMappingURL=AudioScheduledSourceNode.d.ts.map

package/lib/typescript/web-core/AudioScheduledSourceNode.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AudioScheduledSourceNode.d.ts","sourceRoot":"","sources":["../../../src/web-core/AudioScheduledSourceNode.tsx"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAGjD,MAAM,CAAC,OAAO,OAAO,wBAAyB,SAAQ,SAAS;IAC7D,SAAS,CAAC,cAAc,EAAE,OAAO,CAAS;IAEnC,KAAK,CAAC,IAAI,GAAE,MAAU,GAAG,IAAI;IAe7B,IAAI,CAAC,IAAI,GAAE,MAAU,GAAG,IAAI;IAiBnC,IAAW,OAAO,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,GAAG,IAAI,EAElE;CACF"}
+{"version":3,"file":"AudioScheduledSourceNode.d.ts","sourceRoot":"","sources":["../../../src/web-core/AudioScheduledSourceNode.tsx"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAGjD,MAAM,CAAC,OAAO,OAAO,wBAAyB,SAAQ,SAAS;IAC7D,SAAS,CAAC,cAAc,EAAE,OAAO,CAAS;IAC1C,OAAO,CAAC,eAAe,CAAC,CAAkC;IAEnD,KAAK,CAAC,IAAI,GAAE,MAAU,GAAG,IAAI;IAe7B,IAAI,CAAC,IAAI,GAAE,MAAU,GAAG,IAAI;IAgBnC,IAAW,OAAO,IAAI,CAAC,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC,GAAG,SAAS,CAElE;IAED,IAAW,OAAO,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,GAAG,IAAI,EAGlE;CACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-audio-api",
-  "version": "0.12.0-nightly-75589dc-20260121",
+  "version": "0.12.0-nightly-6993a06-20260122",
   "description": "react-native-audio-api provides system for controlling audio in React Native environment compatible with Web Audio API specification",
   "bin": {
     "setup-rn-audio-api-web": "./scripts/setup-rn-audio-api-web.js"

package/src/core/AudioBufferQueueSourceNode.ts

@@ -5,8 +5,13 @@ import { RangeError } from '../errors';
 import BaseAudioContext from './BaseAudioContext';
 import { TBaseAudioBufferSourceOptions } from '../types';
 import { BaseAudioBufferSourceOptions } from '../defaults';
+import { AudioEventSubscription } from '../events';
+import { OnBufferEndEventType } from '../events/types';
 
 export default class AudioBufferQueueSourceNode extends AudioBufferBaseSourceNode {
+  private onBufferEndedSubscription?: AudioEventSubscription;
+  private onBufferEndedCallback?: (event: OnBufferEndEventType) => void;
+
   constructor(
     context: BaseAudioContext,
     options?: TBaseAudioBufferSourceOptions
@@ -65,6 +70,32 @@ export default class AudioBufferQueueSourceNode extends AudioBufferBaseSourceNod
     (this.node as IAudioBufferQueueSourceNode).stop(when);
   }
 
+  public get onBufferEnded():
+    | ((event: OnBufferEndEventType) => void)
+    | undefined {
+    return this.onBufferEndedCallback;
+  }
+
+  public set onBufferEnded(
+    callback: ((event: OnBufferEndEventType) => void) | null
+  ) {
+    if (!callback) {
+      (this.node as IAudioBufferQueueSourceNode).onBufferEnded = '0';
+      this.onBufferEndedSubscription?.remove();
+      this.onBufferEndedSubscription = undefined;
+      this.onBufferEndedCallback = undefined;
+
+      return;
+    }
+
+    this.onBufferEndedCallback = callback;
+    this.onBufferEndedSubscription =
+      this.audioEventEmitter.addAudioEventListener('bufferEnded', callback);
+
+    (this.node as IAudioBufferQueueSourceNode).onBufferEnded =
+      this.onBufferEndedSubscription.subscriptionId;
+  }
+
   public pause(): void {
     (this.node as IAudioBufferQueueSourceNode).pause();
   }

package/src/core/AudioBufferSourceNode.ts

@@ -97,16 +97,6 @@ export default class AudioBufferSourceNode extends AudioBufferBaseSourceNode {
     (this.node as IAudioBufferSourceNode).start(when, offset, duration);
   }
 
-  public override get onEnded(): ((event: EventEmptyType) => void) | undefined {
-    return super.onEnded as ((event: EventEmptyType) => void) | undefined;
-  }
-
-  public override set onEnded(
-    callback: ((event: EventEmptyType) => void) | null
-  ) {
-    super.onEnded = callback;
-  }
-
   public get onLoopEnded(): ((event: EventEmptyType) => void) | undefined {
     return this.onLoopEndedCallback;
   }

package/src/core/AudioScheduledSourceNode.ts

@@ -1,7 +1,7 @@
 import { IAudioScheduledSourceNode } from '../interfaces';
 import AudioNode from './AudioNode';
 import { InvalidStateError, RangeError } from '../errors';
-import { OnEndedEventType } from '../events/types';
+import { EventEmptyType } from '../events/types';
 import { AudioEventEmitter, AudioEventSubscription } from '../events';
 
 export default class AudioScheduledSourceNode extends AudioNode {
@@ -11,7 +11,7 @@ export default class AudioScheduledSourceNode extends AudioNode {
   );
 
   private onEndedSubscription?: AudioEventSubscription;
-  private onEndedCallback?: (event: OnEndedEventType) => void;
+  private onEndedCallback?: (event: EventEmptyType) => void;
 
   public start(when: number = 0): void {
     if (when < 0) {
@@ -44,11 +44,11 @@ export default class AudioScheduledSourceNode extends AudioNode {
     (this.node as IAudioScheduledSourceNode).stop(when);
   }
 
-  public get onEnded(): ((event: OnEndedEventType) => void) | undefined {
+  public get onEnded(): ((event: EventEmptyType) => void) | undefined {
     return this.onEndedCallback;
   }
 
-  public set onEnded(callback: ((event: OnEndedEventType) => void) | null) {
+  public set onEnded(callback: ((event: EventEmptyType) => void) | null) {
     if (!callback) {
       (this.node as IAudioScheduledSourceNode).onEnded = '0';
       this.onEndedSubscription?.remove();

package/src/core/BaseAudioContext.ts

@@ -158,10 +158,10 @@ export default class BaseAudioContext {
     return new BiquadFilterNode(this);
   }
 
-  createBufferSource(options: {
-    pitchCorrection?: boolean;
+  createBufferSource(options?: {
+    pitchCorrection: boolean;
   }): AudioBufferSourceNode {
-    if (options.pitchCorrection !== undefined) {
+    if (options !== undefined) {
       return new AudioBufferSourceNode(this, options);
     } else {
       return new AudioBufferSourceNode(this);
@@ -195,10 +195,10 @@ export default class BaseAudioContext {
     return new IIRFilterNode(this, { feedforward, feedback });
   }
 
-  createBufferQueueSource(options: {
-    pitchCorrection?: boolean;
+  createBufferQueueSource(options?: {
+    pitchCorrection: boolean;
   }): AudioBufferQueueSourceNode {
-    if (options.pitchCorrection !== undefined) {
+    if (options !== undefined) {
       return new AudioBufferQueueSourceNode(this, options);
     } else {
       return new AudioBufferQueueSourceNode(this);

package/src/core/OscillatorNode.ts

@@ -4,7 +4,6 @@ import AudioParam from './AudioParam';
 import BaseAudioContext from './BaseAudioContext';
 import PeriodicWave from './PeriodicWave';
 import { InvalidStateError } from '../errors';
-import { EventEmptyType } from '../events/types';
 import { OscillatorOptions } from '../defaults';
 import { TOscillatorOptions } from '../types';
 
@@ -46,14 +45,4 @@ export default class OscillatorNode extends AudioScheduledSourceNode {
   public setPeriodicWave(wave: PeriodicWave): void {
     (this.node as IOscillatorNode).setPeriodicWave(wave.periodicWave);
   }
-
-  public override get onEnded(): ((event: EventEmptyType) => void) | undefined {
-    return super.onEnded as ((event: EventEmptyType) => void) | undefined;
-  }
-
-  public override set onEnded(
-    callback: ((event: EventEmptyType) => void) | null
-  ) {
-    super.onEnded = callback;
-  }
 }

package/src/events/types.ts

@@ -46,12 +46,13 @@ interface RemoteCommandEvents {
 type SystemEvents = RemoteCommandEvents & {
   volumeChange: EventTypeWithValue;
   interruption: OnInterruptionEventType;
+  duck: EventEmptyType;
   routeChange: OnRouteChangeEventType;
 };
 
-export interface OnEndedEventType extends EventEmptyType {
-  bufferId: string | undefined;
-  isLast: boolean | undefined;
+export interface OnBufferEndEventType {
+  bufferId: string;
+  isLastBufferInQueue: boolean;
 }
 
 /**
@@ -79,10 +80,11 @@ export interface OnAudioReadyEventType {
 }
 
 interface AudioAPIEvents {
-  ended: OnEndedEventType;
+  ended: EventEmptyType;
   loopEnded: EventEmptyType;
   audioReady: OnAudioReadyEventType;
   positionChanged: EventTypeWithValue;
+  bufferEnded: OnBufferEndEventType;
   audioError: EventEmptyType; // to change
   systemStateChanged: EventEmptyType; // to change
   recorderError: OnRecorderErrorEventType;

package/src/interfaces.ts

@@ -229,6 +229,9 @@ export interface IAudioBufferQueueSourceNode
   enqueueBuffer: (audioBuffer: IAudioBuffer) => string;
   start: (when?: number, offset?: number) => void;
   pause: () => void;
+
+  // passing subscriptionId(uint_64 in cpp, string in js) to the cpp
+  onBufferEnded: string;
 }
 
 export interface IConvolverNode extends IAudioNode {

package/src/specs/NativeAudioAPIModule.ts

@@ -6,6 +6,11 @@ import { AudioDevicesInfo, PermissionStatus } from '../system/types';
 type OptionsMap = { [key: string]: string | boolean | number | undefined };
 type NotificationOpResponse = { success: boolean; error?: string };
 type NotificationType = 'playback' | 'recording' | 'simple';
+type AudioFocusType =
+  | 'gain'
+  | 'gainTransient'
+  | 'gainTransientExclusive'
+  | 'gainTransientMayDuck';
 
 interface Spec extends TurboModule {
   install(): boolean;
@@ -22,7 +27,7 @@ interface Spec extends TurboModule {
   disableSessionManagement(): void;
 
   // Remote commands, system events and interruptions
-  observeAudioInterruptions(enabled: boolean): void;
+  observeAudioInterruptions(focusType: AudioFocusType, enabled: boolean): void;
   activelyReclaimSession(enabled: boolean): void;
   observeVolumeChanges(enabled: boolean): void;
 

package/src/specs/NativeAudioAPIModule.web.ts

@@ -1,5 +1,9 @@
 import { TurboModule } from 'react-native';
-import { AudioDevicesInfo, PermissionStatus } from '../system/types';
+import {
+  AudioDevicesInfo,
+  AudioFocusType,
+  PermissionStatus,
+} from '../system/types';
 
 // copy of spec from NativeAudioAPIModule.ts
 type OptionsMap = {
@@ -23,7 +27,7 @@ interface Spec extends TurboModule {
   disableSessionManagement(): void;
 
   // Remote commands, system events and interruptions
-  observeAudioInterruptions(enabled: boolean): void;
+  observeAudioInterruptions(focusType: AudioFocusType, enabled: boolean): void;
   activelyReclaimSession(enabled: boolean): void;
   observeVolumeChanges(enabled: boolean): void;
 

package/src/system/AudioManager.ts

@@ -7,6 +7,7 @@ import {
   IAudioManager,
   PermissionStatus,
   SessionOptions,
+  AudioFocusType,
 } from './types';
 
 class AudioManager implements IAudioManager {
@@ -43,8 +44,13 @@ class AudioManager implements IAudioManager {
     NativeAudioAPIModule.disableSessionManagement();
   }
 
-  observeAudioInterruptions(enabled: boolean) {
-    NativeAudioAPIModule.observeAudioInterruptions(enabled);
+  observeAudioInterruptions(param: AudioFocusType | boolean | null) {
+    if (typeof param === 'string') {
+      NativeAudioAPIModule.observeAudioInterruptions(param, true);
+    } else {
+      // audiofocusgain as default value if not provided
+      NativeAudioAPIModule.observeAudioInterruptions('gain', param === true);
+    }
   }
 
   /**

package/src/system/types.ts

@@ -30,6 +30,12 @@ export type IOSOption =
   | 'overrideMutedMicrophoneInterruption'
   | 'interruptSpokenAudioAndMixWithOthers';
 
+export type AudioFocusType =
+  | 'gain'
+  | 'gainTransient'
+  | 'gainTransientExclusive'
+  | 'gainTransientMayDuck';
+
 export interface SessionOptions {
   iosMode?: IOSMode;
   iosOptions?: IOSOption[];
@@ -60,7 +66,7 @@ export interface IAudioManager {
   disableSessionManagement(): void;
   observeAudioInterruptions(enabled: boolean): void;
   activelyReclaimSession(enabled: boolean): void;
-  observeVolumeChanges(enabled: boolean): void;
+  observeAudioInterruptions(param: AudioFocusType | boolean | null): void;
   addSystemEventListener<Name extends SystemEventName>(
     name: Name,
     callback: SystemEventCallback<Name>

package/src/web-core/AudioScheduledSourceNode.tsx

@@ -4,6 +4,7 @@ import { RangeError, InvalidStateError } from '../errors';
 
 export default class AudioScheduledSourceNode extends AudioNode {
   protected hasBeenStarted: boolean = false;
+  private onEndedCallback?: (event: EventEmptyType) => void;
 
   public start(when: number = 0): void {
     if (when < 0) {
@@ -36,8 +37,12 @@ export default class AudioScheduledSourceNode extends AudioNode {
     (this.node as globalThis.AudioScheduledSourceNode).stop(when);
   }
 
-  // eslint-disable-next-line accessor-pairs
+  public get onEnded(): ((event: EventEmptyType) => void) | undefined {
+    return this.onEndedCallback;
+  }
+
   public set onEnded(callback: (event: EventEmptyType) => void | null) {
     (this.node as globalThis.AudioScheduledSourceNode).onended = callback;
+    this.onEndedCallback = callback;
   }
 }