react-native-audio-api 0.11.0-nightly-b30bac9-20260114 → 0.11.0

package/src/system/notification/RecordingNotificationManager.ts

@@ -1,133 +1,58 @@
-import { Platform } from 'react-native';
 import { AudioEventEmitter, AudioEventSubscription } from '../../events';
 import { NativeAudioAPIModule } from '../../specs';
 import type {
-  NotificationEvents,
+  RecordingNotificationEvent,
   NotificationManager,
-  RecordingControlName,
   RecordingNotificationEventName,
   RecordingNotificationInfo,
 } from './types';
 
-/// Manager for recording notifications with controls.
+import { AudioApiError } from '../../errors';
+
 class RecordingNotificationManager
   implements
     NotificationManager<
-      RecordingNotificationInfo,
       RecordingNotificationInfo,
       RecordingNotificationEventName
     >
 {
-  private isRegistered_ = false;
-  private isShown_ = false;
-
-  private notificationKey = 'recording';
+  private notificationKey = 'react-native-audio-api-recording';
   private audioEventEmitter: AudioEventEmitter;
-  private isIOS = Platform.OS === 'ios';
 
   constructor() {
     this.audioEventEmitter = new AudioEventEmitter(global.AudioEventEmitter);
   }
 
-  /// Register the recording notification (must be called before showing).
-  async register(): Promise<void> {
-    if (this.isRegistered_) {
-      console.warn('RecordingNotification is already registered');
-      return;
-    }
-
-    // Recording notifications are only supported on Android
-    if (this.isIOS) {
-      this.isRegistered_ = true;
-      return;
-    }
-
-    if (!NativeAudioAPIModule) {
-      throw new Error('NativeAudioAPIModule is not available');
-    }
-
-    const result = await NativeAudioAPIModule.registerNotification(
-      'recording',
-      this.notificationKey
-    );
-
-    if (result.error) {
-      throw new Error(result.error);
-    }
-
-    this.isRegistered_ = true;
-  }
-
-  /// Show the notification with initial metadata.
+  /**
+   * Show the notification with metadata or update if already visible.
+   *
+   * @param info - The info to be displayed.
+   * @returns Promise that resolves after creating notification.
+   */
   async show(info: RecordingNotificationInfo): Promise<void> {
-    if (!this.isRegistered_) {
-      throw new Error(
-        'RecordingNotification must be registered before showing. Call register() first.'
-      );
-    }
-
-    // Recording notifications are only supported on Android
-    if (this.isIOS) {
-      this.isShown_ = true;
-      return;
-    }
-
     if (!NativeAudioAPIModule) {
-      throw new Error('NativeAudioAPIModule is not available');
+      throw new AudioApiError('NativeAudioAPIModule is not available');
     }
 
     const result = await NativeAudioAPIModule.showNotification(
+      'recording',
       this.notificationKey,
       info as Record<string, string | number | boolean | undefined>
     );
 
     if (result.error) {
-      throw new Error(result.error);
-    }
-
-    this.isShown_ = true;
-  }
-
-  /// Update the notification with new metadata or state.
-  async update(info: RecordingNotificationInfo): Promise<void> {
-    if (!this.isShown_) {
-      console.warn('RecordingNotification is not shown. Call show() first.');
-      return;
-    }
-
-    // Recording notifications are only supported on Android
-    if (this.isIOS) {
-      return;
-    }
-
-    if (!NativeAudioAPIModule) {
-      throw new Error('NativeAudioAPIModule is not available');
-    }
-
-    const result = await NativeAudioAPIModule.updateNotification(
-      this.notificationKey,
-      info as Record<string, string | number | boolean | undefined>
-    );
-
-    if (result.error) {
-      throw new Error(result.error);
+      throw new AudioApiError(result.error);
     }
   }
 
-  /// Hide the notification (can be shown again later).
+  /**
+   * Hide the notification.
+   *
+   * @returns Promise that resolves after hiding notification.
+   */
   async hide(): Promise<void> {
-    if (!this.isShown_) {
-      return;
-    }
-
-    // Recording notifications are only supported on Android
-    if (this.isIOS) {
-      this.isShown_ = false;
-      return;
-    }
-
     if (!NativeAudioAPIModule) {
-      throw new Error('NativeAudioAPIModule is not available');
+      throw new AudioApiError('NativeAudioAPIModule is not available');
     }
 
     const result = await NativeAudioAPIModule.hideNotification(
@@ -135,80 +60,16 @@ class RecordingNotificationManager
     );
 
     if (result.error) {
-      throw new Error(result.error);
-    }
-
-    this.isShown_ = false;
-  }
-
-  /// Unregister the notification (must register again to use).
-  async unregister(): Promise<void> {
-    if (!this.isRegistered_) {
-      return;
-    }
-
-    if (this.isShown_) {
-      await this.hide();
-    }
-
-    // Recording notifications are only supported on Android
-    if (this.isIOS) {
-      this.isRegistered_ = false;
-      return;
-    }
-
-    if (!NativeAudioAPIModule) {
-      throw new Error('NativeAudioAPIModule is not available');
-    }
-
-    const result = await NativeAudioAPIModule.unregisterNotification(
-      this.notificationKey
-    );
-
-    if (result.error) {
-      throw new Error(result.error);
-    }
-
-    this.isRegistered_ = false;
-  }
-
-  /// Enable or disable a specific recording control.
-  async enableControl(
-    control: RecordingControlName,
-    enabled: boolean
-  ): Promise<void> {
-    if (!this.isRegistered_) {
-      console.warn('RecordingNotification is not registered');
-      return;
-    }
-
-    // Recording notifications are only supported on Android
-    if (this.isIOS) {
-      return;
-    }
-
-    if (!NativeAudioAPIModule) {
-      throw new Error('NativeAudioAPIModule is not available');
-    }
-
-    const params = { control, enabled };
-    const result = await NativeAudioAPIModule.updateNotification(
-      this.notificationKey,
-      params as Record<string, string | number | boolean | undefined>
-    );
-
-    if (result.error) {
-      throw new Error(result.error);
+      throw new AudioApiError(result.error);
     }
   }
 
-  /// Check if the notification is currently active.
+  /**
+   * Check if the notification is currently active.
+   *
+   * @returns Promise that resolves to whether notification is active.
+   */
   async isActive(): Promise<boolean> {
-    // Recording notifications are only supported on Android
-    if (this.isIOS) {
-      return this.isShown_;
-    }
-
     if (!NativeAudioAPIModule) {
       return false;
     }
@@ -218,30 +79,19 @@ class RecordingNotificationManager
     );
   }
 
-  isRegistered(): boolean {
-    return this.isRegistered_;
-  }
-
-  /// Add an event listener for notification actions.
+  /**
+   * Add an event listener for notification actions.
+   *
+   * @param eventName - The event name to listen for.
+   * @param callback - The callback to invoke on event.
+   * @returns Class that represents the subscription.
+   */
   addEventListener<T extends RecordingNotificationEventName>(
     eventName: T,
-    callback: (event: NotificationEvents[T]) => void
+    callback: (event: RecordingNotificationEvent[T]) => void
   ): AudioEventSubscription {
-    // Recording notifications are only supported on Android
-    if (this.isIOS) {
-      // Return a dummy subscription for iOS
-      return {
-        remove: () => {},
-      } as unknown as AudioEventSubscription;
-    }
-
     return this.audioEventEmitter.addAudioEventListener(eventName, callback);
   }
-
-  /** Remove an event listener. */
-  removeEventListener(subscription: AudioEventSubscription): void {
-    subscription.remove();
-  }
 }
 
 export default new RecordingNotificationManager();

package/src/system/notification/index.ts

@@ -1,4 +1,3 @@
 export { default as PlaybackNotificationManager } from './PlaybackNotificationManager';
 export { default as RecordingNotificationManager } from './RecordingNotificationManager';
-export { default as SimpleNotificationManager } from './SimpleNotificationManager';
 export * from './types';

package/src/system/notification/types.ts

@@ -5,24 +5,15 @@ import { EventEmptyType, EventTypeWithValue } from '../../events/types';
 /// Provides a consistent API for managing notification lifecycle and events.
 export interface NotificationManager<
   TShowOptions,
-  TUpdateOptions,
   TEventName extends NotificationEventName,
 > {
-  /// Register the notification (must be called before showing).
-  register(): Promise<void>;
-
-  /// Show the notification with initial options.
+  /// Show the notification with options or update if already visible.
+  /// Automatically creates the notification instance on first call.
   show(options: TShowOptions): Promise<void>;
 
-  /// Update the notification with new options.
-  update(options: TUpdateOptions): Promise<void>;
-
-  /// Hide the notification (can be shown again later).
+  /// Hide the notification.
   hide(): Promise<void>;
 
-  /// Unregister the notification (must register again to use).
-  unregister(): Promise<void>;
-
   /// Check if the notification is currently active.
   isActive(): Promise<boolean>;
 
@@ -31,9 +22,6 @@ export interface NotificationManager<
     eventName: T,
     callback: NotificationCallback<T>
   ): AudioEventSubscription | undefined;
-
-  /// Remove an event listener.
-  removeEventListener(subscription: AudioEventSubscription): void;
 }
 
 /// Metadata and state information for playback notifications.
@@ -71,28 +59,24 @@ interface PlaybackNotificationEvent {
   playbackNotificationDismissed: EventEmptyType;
 }
 
-export type PlaybackNotificationEventName = keyof PlaybackNotificationEvent;
-
-/// Metadata and state information for recording notifications.
 export interface RecordingNotificationInfo {
   title?: string;
-  description?: string;
-  artwork?: string | { uri: string };
-  state?: 'recording' | 'stopped';
-  control?: RecordingControlName;
-  enabled?: boolean;
+  contentText?: string;
+  paused?: boolean;
+  smallIconResourceName?: string;
+  largeIconResourceName?: string;
+  pauseIconResourceName?: string;
+  resumeIconResourceName?: string;
+  color?: number;
 }
 
-/// Available recording control actions.
-export type RecordingControlName = 'start' | 'stop';
-
-/// Event names for recording notification actions.
-interface RecordingNotificationEvent {
-  recordingNotificationStart: EventEmptyType;
-  recordingNotificationStop: EventEmptyType;
-  recordingNotificationDismissed: EventEmptyType;
+export interface RecordingNotificationEvent {
+  recordingNotificationPause: EventEmptyType;
+  recordingNotificationResume: EventEmptyType;
 }
 
+export type PlaybackNotificationEventName = keyof PlaybackNotificationEvent;
+
 export type RecordingNotificationEventName = keyof RecordingNotificationEvent;
 
 export type NotificationEvents = PlaybackNotificationEvent &
@@ -103,9 +87,3 @@ export type NotificationEventName = keyof NotificationEvents;
 export type NotificationCallback<Name extends NotificationEventName> = (
   event: NotificationEvents[Name]
 ) => void;
-
-/// Options for a simple notification with title and text.
-export interface SimpleNotificationOptions {
-  title?: string;
-  text?: string;
-}

package/src/types.ts

@@ -149,3 +149,5 @@ export interface IIRFilterNodeOptions {
   feedforward: number[];
   feedback: number[];
 }
+
+export type DecodeDataInput = number | string | ArrayBuffer;

package/src/utils/index.ts

@@ -1,14 +1,15 @@
 import AudioAPIModule from '../AudioAPIModule';
+import { AudioApiError } from '../errors';
 
 export function assertWorkletsEnabled() {
   if (!AudioAPIModule.areWorkletsAvailable) {
-    throw new Error(
+    throw new AudioApiError(
       '[react-native-audio-api]: Worklets are not available. Please install react-native-worklets to use this feature.'
     );
   }
 
   if (!AudioAPIModule.isWorkletsVersionSupported) {
-    throw new Error(
+    throw new AudioApiError(
       `[react-native-audio-api]: Worklets version ${AudioAPIModule.workletsVersion} is not supported.
       Please install react-native-worklets of one of the following versions: [${AudioAPIModule.supportedWorkletsVersion.join(', ')}] to use this feature.`
     );

package/src/utils/paths.ts

@@ -0,0 +1,11 @@
+export function isRemoteSource(url: string): boolean {
+  return url.startsWith('http://') || url.startsWith('https://');
+}
+
+export function isBase64Source(data: string): boolean {
+  return data.startsWith('data:audio/') && data.includes(';base64,');
+}
+
+export function isDataBlobString(data: string): boolean {
+  return data.startsWith('blob:');
+}

package/src/web-core/AudioContext.tsx

@@ -1,28 +1,29 @@
+import { InvalidAccessError, NotSupportedError } from '../errors';
 import {
-  ContextState,
-  PeriodicWaveConstraints,
-  AudioContextOptions,
   AudioBufferBaseSourceNodeOptions,
+  AudioContextOptions,
+  ContextState,
+  DecodeDataInput,
   IIRFilterNodeOptions,
+  PeriodicWaveConstraints,
 } from '../types';
-import { InvalidAccessError, NotSupportedError } from '../errors';
-import BaseAudioContext from './BaseAudioContext';
 import AnalyserNode from './AnalyserNode';
-import AudioDestinationNode from './AudioDestinationNode';
 import AudioBuffer from './AudioBuffer';
 import AudioBufferSourceNode from './AudioBufferSourceNode';
+import AudioDestinationNode from './AudioDestinationNode';
+import BaseAudioContext from './BaseAudioContext';
 import BiquadFilterNode from './BiquadFilterNode';
-import IIRFilterNode from './IIRFilterNode';
+import ConvolverNode from './ConvolverNode';
+import { ConvolverNodeOptions } from './ConvolverNodeOptions';
+import DelayNode from './DelayNode';
 import GainNode from './GainNode';
+import IIRFilterNode from './IIRFilterNode';
 import OscillatorNode from './OscillatorNode';
 import PeriodicWave from './PeriodicWave';
 import StereoPannerNode from './StereoPannerNode';
-import ConvolverNode from './ConvolverNode';
-import DelayNode from './DelayNode';
-import { ConvolverNodeOptions } from './ConvolverNodeOptions';
 
-import { globalWasmPromise, globalTag } from './custom/LoadCustomWasm';
 import ConstantSourceNode from './ConstantSourceNode';
+import { globalTag, globalWasmPromise } from './custom/LoadCustomWasm';
 import WaveShaperNode from './WaveShaperNode';
 
 export default class AudioContext implements BaseAudioContext {
@@ -180,16 +181,30 @@ export default class AudioContext implements BaseAudioContext {
     return new WaveShaperNode(this, this.context.createWaveShaper());
   }
 
-  async decodeAudioDataSource(source: string): Promise<AudioBuffer> {
-    const arrayBuffer = await fetch(source).then((response) =>
-      response.arrayBuffer()
-    );
+  async decodeAudioData(
+    source: DecodeDataInput,
+    fetchOptions?: RequestInit
+  ): Promise<AudioBuffer> {
+    if (source instanceof ArrayBuffer) {
+      const decodedData = await this.context.decodeAudioData(source);
+      return new AudioBuffer(decodedData);
+    }
 
-    return this.decodeAudioData(arrayBuffer);
-  }
+    if (typeof source === 'string') {
+      const response = await fetch(source, fetchOptions);
+
+      if (!response.ok) {
+        throw new InvalidAccessError(
+          `Failed to fetch audio data from the provided source: ${source}`
+        );
+      }
+
+      const arrayBuffer = await response.arrayBuffer();
+      const decodedData = await this.context.decodeAudioData(arrayBuffer);
+      return new AudioBuffer(decodedData);
+    }
 
-  async decodeAudioData(arrayBuffer: ArrayBuffer): Promise<AudioBuffer> {
-    return new AudioBuffer(await this.context.decodeAudioData(arrayBuffer));
+    throw new TypeError('Unsupported source for decodeAudioData: ' + source);
   }
 
   async close(): Promise<void> {

package/src/web-core/BaseAudioContext.tsx

@@ -1,21 +1,21 @@
 import {
   ContextState,
-  PeriodicWaveConstraints,
   IIRFilterNodeOptions,
+  PeriodicWaveConstraints,
 } from '../types';
 import AnalyserNode from './AnalyserNode';
-import AudioDestinationNode from './AudioDestinationNode';
 import AudioBuffer from './AudioBuffer';
 import AudioBufferSourceNode from './AudioBufferSourceNode';
+import AudioDestinationNode from './AudioDestinationNode';
 import BiquadFilterNode from './BiquadFilterNode';
+import ConstantSourceNode from './ConstantSourceNode';
+import ConvolverNode from './ConvolverNode';
 import DelayNode from './DelayNode';
-import IIRFilterNode from './IIRFilterNode';
 import GainNode from './GainNode';
+import IIRFilterNode from './IIRFilterNode';
 import OscillatorNode from './OscillatorNode';
 import PeriodicWave from './PeriodicWave';
 import StereoPannerNode from './StereoPannerNode';
-import ConstantSourceNode from './ConstantSourceNode';
-import ConvolverNode from './ConvolverNode';
 import WaveShaperNode from './WaveShaperNode';
 
 export default interface BaseAudioContext {
@@ -47,6 +47,8 @@ export default interface BaseAudioContext {
   ): PeriodicWave;
   createAnalyser(): AnalyserNode;
   createWaveShaper(): WaveShaperNode;
-  decodeAudioDataSource(source: string): Promise<AudioBuffer>;
-  decodeAudioData(arrayBuffer: ArrayBuffer): Promise<AudioBuffer>;
+  decodeAudioData(
+    arrayBuffer: ArrayBuffer,
+    fetchOptions?: RequestInit
+  ): Promise<AudioBuffer>;
 }

package/src/web-system/notification/PlaybackNotificationManager.ts

@@ -14,11 +14,7 @@ import type {
 /// Mock Manager for playback notifications. Does nothing.
 class PlaybackNotificationManager
   implements
-    NotificationManager<
-      PlaybackNotificationInfo,
-      PlaybackNotificationInfo,
-      PlaybackNotificationEventName
-    >
+    NotificationManager<PlaybackNotificationInfo, PlaybackNotificationEventName>
 {
   private isRegistered_ = false;
   private isShown_ = false;
@@ -57,8 +53,6 @@ class PlaybackNotificationManager
       remove: () => {},
     } as unknown as AudioEventSubscription;
   }
-
-  removeEventListener(subscription: AudioEventSubscription): void {}
 }
 
 export default new PlaybackNotificationManager();

package/src/web-system/notification/RecordingNotificationManager.ts

@@ -6,16 +6,14 @@ import type { AudioEventSubscription } from '../../events';
 import type {
   NotificationEvents,
   NotificationManager,
-  RecordingControlName,
   RecordingNotificationEventName,
   RecordingNotificationInfo,
 } from '../../system';
 
-/// Mock Manager for recording notifications. Does nothing.
+/// Mock Manager for playback notifications. Does nothing.
 class RecordingNotificationManager
   implements
     NotificationManager<
-      RecordingNotificationInfo,
       RecordingNotificationInfo,
       RecordingNotificationEventName
     >
@@ -25,21 +23,10 @@ class RecordingNotificationManager
 
   constructor() {}
 
-  async register(): Promise<void> {}
-
   async show(info: RecordingNotificationInfo): Promise<void> {}
 
-  async update(info: RecordingNotificationInfo): Promise<void> {}
-
   async hide(): Promise<void> {}
 
-  async unregister(): Promise<void> {}
-
-  async enableControl(
-    control: RecordingControlName,
-    enabled: boolean
-  ): Promise<void> {}
-
   async isActive(): Promise<boolean> {
     return this.isShown_;
   }
@@ -57,8 +44,6 @@ class RecordingNotificationManager
       remove: () => {},
     } as unknown as AudioEventSubscription;
   }
-
-  removeEventListener(subscription: AudioEventSubscription): void {}
 }
 
 export default new RecordingNotificationManager();

package/android/src/main/java/com/swmansion/audioapi/core/NativeAudioPlayer.kt

@@ -1,26 +0,0 @@
-package com.swmansion.audioapi.core
-
-import com.facebook.common.internal.DoNotStrip
-import com.swmansion.audioapi.system.ForegroundServiceManager
-import java.util.UUID
-
-@DoNotStrip
-class NativeAudioPlayer {
-  private var playerId: String? = null
-
-  @DoNotStrip
-  fun start() {
-    if (playerId == null) {
-      playerId = UUID.randomUUID().toString()
-      ForegroundServiceManager.subscribe("player_$playerId")
-    }
-  }
-
-  @DoNotStrip
-  fun stop() {
-    playerId?.let {
-      ForegroundServiceManager.unsubscribe("player_$it")
-      playerId = null
-    }
-  }
-}

package/android/src/main/java/com/swmansion/audioapi/core/NativeAudioRecorder.kt

@@ -1,26 +0,0 @@
-package com.swmansion.audioapi.core
-
-import com.facebook.common.internal.DoNotStrip
-import com.swmansion.audioapi.system.ForegroundServiceManager
-import java.util.UUID
-
-@DoNotStrip
-class NativeAudioRecorder {
-  private var recorderId: String? = null
-
-  @DoNotStrip
-  fun start() {
-    if (recorderId == null) {
-      recorderId = UUID.randomUUID().toString()
-      ForegroundServiceManager.subscribe("recorder_$recorderId")
-    }
-  }
-
-  @DoNotStrip
-  fun stop() {
-    recorderId?.let {
-      ForegroundServiceManager.unsubscribe("recorder_$it")
-      recorderId = null
-    }
-  }
-}