react-native-audio-api 0.11.0-nightly-95f9c99-20251215 → 0.11.0-nightly-dd83923-20251216

package/lib/typescript/types.d.ts

@@ -1,8 +1,14 @@
 import AudioBuffer from './core/AudioBuffer';
+export type Result<T> = ({
+    status: 'success';
+} & T) | {
+    status: 'error';
+    message: string;
+};
 export type ChannelCountMode = 'max' | 'clamped-max' | 'explicit';
 export type ChannelInterpretation = 'speakers' | 'discrete';
 export type BiquadFilterType = 'lowpass' | 'highpass' | 'bandpass' | 'lowshelf' | 'highshelf' | 'peaking' | 'notch' | 'allpass';
-export type ContextState = 'running' | 'closed' | `suspended`;
+export type ContextState = 'running' | 'closed' | 'suspended';
 export type AudioWorkletRuntime = 'AudioRuntime' | 'UIRuntime';
 export type OscillatorType = 'sine' | 'square' | 'sawtooth' | 'triangle' | 'custom';
 export interface PeriodicWaveConstraints {
@@ -16,9 +22,60 @@ export interface OfflineAudioContextOptions {
     length: number;
     sampleRate: number;
 }
-export interface AudioRecorderOptions {
+export declare enum FileDirectory {
+    Document = 0,
+    Cache = 1
+}
+export declare enum FileFormat {
+    Wav = 0,
+    Caf = 1,
+    M4A = 2,
+    Flac = 3
+}
+export declare enum IOSAudioQuality {
+    Min = 0,
+    Low = 1,
+    Medium = 2,
+    High = 3,
+    Max = 4
+}
+export declare enum BitDepth {
+    Bit16 = 0,
+    Bit24 = 1,
+    Bit32 = 2
+}
+export declare enum FlacCompressionLevel {
+    L0 = 0,
+    L1 = 1,
+    L2 = 2,
+    L3 = 3,
+    L4 = 4,
+    L5 = 5,
+    L6 = 6,
+    L7 = 7,
+    L8 = 8
+}
+export interface FilePresetType {
+    bitRate: number;
     sampleRate: number;
-    bufferLengthInSamples: number;
+    bitDepth: BitDepth;
+    iosQuality: IOSAudioQuality;
+    flacCompressionLevel: FlacCompressionLevel;
+}
+export interface AudioRecorderFileOptions {
+    channelCount?: number;
+    batchDurationSeconds?: number;
+    format?: FileFormat;
+    preset?: FilePresetType;
+    directory?: FileDirectory;
+    subDirectory?: string;
+    fileNamePrefix?: string;
+    androidFlushIntervalMs?: number;
+}
+export interface FileInfo {
+    path: string;
+    size: number;
+    duration: number;
 }
 export type WindowType = 'blackman' | 'hann';
 export interface AudioBufferBaseSourceNodeOptions {
@@ -29,6 +86,25 @@ export interface ConvolverNodeOptions {
     buffer?: AudioBuffer | null;
     disableNormalization?: boolean;
 }
+export interface AudioRecorderCallbackOptions {
+    /**
+     * The desired sample rate (in Hz) for audio buffers delivered to the
+     * recording callback. Common values include 44100 or 48000 Hz. The actual
+     * sample rate may differ depending on hardware and system capabilities.
+     */
+    sampleRate: number;
+    /**
+     * The preferred size of each audio buffer, expressed as the number of samples
+     * per channel. Smaller buffers reduce latency but increase CPU load, while
+     * larger buffers improve efficiency at the cost of higher latency.
+     */
+    bufferLength: number;
+    /**
+     * The desired number of audio channels per buffer. Typically 1 for mono or 2
+     * for stereo recordings.
+     */
+    channelCount: number;
+}
 export interface IIRFilterNodeOptions {
     feedforward: number[];
     feedback: number[];

package/lib/typescript/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,WAAW,MAAM,oBAAoB,CAAC;AAE7C,MAAM,MAAM,gBAAgB,GAAG,KAAK,GAAG,aAAa,GAAG,UAAU,CAAC;AAElE,MAAM,MAAM,qBAAqB,GAAG,UAAU,GAAG,UAAU,CAAC;AAE5D,MAAM,MAAM,gBAAgB,GACxB,SAAS,GACT,UAAU,GACV,UAAU,GACV,UAAU,GACV,WAAW,GACX,SAAS,GACT,OAAO,GACP,SAAS,CAAC;AAEd,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,QAAQ,GAAG,WAAW,CAAC;AAE9D,MAAM,MAAM,mBAAmB,GAAG,cAAc,GAAG,WAAW,CAAC;AAE/D,MAAM,MAAM,cAAc,GACtB,MAAM,GACN,QAAQ,GACR,UAAU,GACV,UAAU,GACV,QAAQ,CAAC;AAEb,MAAM,WAAW,uBAAuB;IACtC,oBAAoB,EAAE,OAAO,CAAC;CAC/B;AAED,MAAM,WAAW,mBAAmB;IAClC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,0BAA0B;IACzC,gBAAgB,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,qBAAqB,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,MAAM,UAAU,GAAG,UAAU,GAAG,MAAM,CAAC;AAE7C,MAAM,WAAW,gCAAgC;IAC/C,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,MAAM,aAAa,GAAG,gBAAgB,GAAG,gBAAgB,CAAC;AAEhE,MAAM,WAAW,oBAAoB;IACnC,MAAM,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;IAC5B,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC;AAED,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"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"}

package/lib/typescript/utils/filePresets.d.ts

@@ -0,0 +1,9 @@
+import { FilePresetType } from '../types';
+declare const FilePreset: {
+    readonly Low: FilePresetType;
+    readonly Medium: FilePresetType;
+    readonly High: FilePresetType;
+    readonly Lossless: FilePresetType;
+};
+export default FilePreset;
+//# sourceMappingURL=filePresets.d.ts.map

package/lib/typescript/utils/filePresets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filePresets.d.ts","sourceRoot":"","sources":["../../../src/utils/filePresets.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,cAAc,EAGf,MAAM,UAAU,CAAC;AAkClB,QAAA,MAAM,UAAU;;;;;CAKN,CAAC;AAEX,eAAe,UAAU,CAAC"}

package/lib/typescript/web-system/notification/PlaybackNotificationManager.d.ts

@@ -1,8 +1,8 @@
 import type { AudioEventSubscription } from '../../events';
-import type { NotificationManager, PlaybackNotificationInfo, PlaybackControlName, PlaybackNotificationEventName, NotificationEvents } from '../../system';
+import type { NotificationEvents, NotificationManager, PlaybackControlName, PlaybackNotificationEventName, PlaybackNotificationInfo } from '../../system';
 declare class PlaybackNotificationManager implements NotificationManager<PlaybackNotificationInfo, PlaybackNotificationInfo, PlaybackNotificationEventName> {
-    private isRegistered;
-    private isShown;
+    private isRegistered_;
+    private isShown_;
     constructor();
     register(): Promise<void>;
     show(info: PlaybackNotificationInfo): Promise<void>;
@@ -11,6 +11,7 @@ declare class PlaybackNotificationManager implements NotificationManager<Playbac
     unregister(): Promise<void>;
     enableControl(control: PlaybackControlName, enabled: boolean): Promise<void>;
     isActive(): Promise<boolean>;
+    isRegistered(): boolean;
     addEventListener<T extends PlaybackNotificationEventName>(eventName: T, callback: (event: NotificationEvents[T]) => void): AudioEventSubscription;
     removeEventListener(subscription: AudioEventSubscription): void;
 }

package/lib/typescript/web-system/notification/PlaybackNotificationManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PlaybackNotificationManager.d.ts","sourceRoot":"","sources":["../../../../src/web-system/notification/PlaybackNotificationManager.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAC3D,OAAO,KAAK,EACV,mBAAmB,EACnB,wBAAwB,EACxB,mBAAmB,EACnB,6BAA6B,EAC7B,kBAAkB,EACnB,MAAM,cAAc,CAAC;AAGtB,cAAM,2BACJ,YACE,mBAAmB,CACjB,wBAAwB,EACxB,wBAAwB,EACxB,6BAA6B,CAC9B;IAEH,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,OAAO,CAAS;;IAIlB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAEzB,IAAI,CAAC,IAAI,EAAE,wBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC;IAEnD,MAAM,CAAC,IAAI,EAAE,wBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC;IAErD,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAErB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAE3B,aAAa,CACjB,OAAO,EAAE,mBAAmB,EAC5B,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,IAAI,CAAC;IAEV,QAAQ,IAAI,OAAO,CAAC,OAAO,CAAC;IAIlC,gBAAgB,CAAC,CAAC,SAAS,6BAA6B,EACtD,SAAS,EAAE,CAAC,EACZ,QAAQ,EAAE,CAAC,KAAK,EAAE,kBAAkB,CAAC,CAAC,CAAC,KAAK,IAAI,GAC/C,sBAAsB;IAOzB,mBAAmB,CAAC,YAAY,EAAE,sBAAsB,GAAG,IAAI;CAChE;;AAED,wBAAiD"}
+{"version":3,"file":"PlaybackNotificationManager.d.ts","sourceRoot":"","sources":["../../../../src/web-system/notification/PlaybackNotificationManager.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAC3D,OAAO,KAAK,EACV,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EACnB,6BAA6B,EAC7B,wBAAwB,EACzB,MAAM,cAAc,CAAC;AAGtB,cAAM,2BACJ,YACE,mBAAmB,CACjB,wBAAwB,EACxB,wBAAwB,EACxB,6BAA6B,CAC9B;IAEH,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAS;;IAInB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAEzB,IAAI,CAAC,IAAI,EAAE,wBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC;IAEnD,MAAM,CAAC,IAAI,EAAE,wBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC;IAErD,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAErB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAE3B,aAAa,CACjB,OAAO,EAAE,mBAAmB,EAC5B,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,IAAI,CAAC;IAEV,QAAQ,IAAI,OAAO,CAAC,OAAO,CAAC;IAIlC,YAAY,IAAI,OAAO;IAIvB,gBAAgB,CAAC,CAAC,SAAS,6BAA6B,EACtD,SAAS,EAAE,CAAC,EACZ,QAAQ,EAAE,CAAC,KAAK,EAAE,kBAAkB,CAAC,CAAC,CAAC,KAAK,IAAI,GAC/C,sBAAsB;IAOzB,mBAAmB,CAAC,YAAY,EAAE,sBAAsB,GAAG,IAAI;CAChE;;AAED,wBAAiD"}

package/lib/typescript/web-system/notification/RecordingNotificationManager.d.ts

@@ -1,8 +1,8 @@
 import type { AudioEventSubscription } from '../../events';
-import type { NotificationManager, RecordingNotificationInfo, RecordingControlName, RecordingNotificationEventName, NotificationEvents } from '../../system';
+import type { NotificationEvents, NotificationManager, RecordingControlName, RecordingNotificationEventName, RecordingNotificationInfo } from '../../system';
 declare class RecordingNotificationManager implements NotificationManager<RecordingNotificationInfo, RecordingNotificationInfo, RecordingNotificationEventName> {
-    private isRegistered;
-    private isShown;
+    private isRegistered_;
+    private isShown_;
     constructor();
     register(): Promise<void>;
     show(info: RecordingNotificationInfo): Promise<void>;
@@ -11,6 +11,7 @@ declare class RecordingNotificationManager implements NotificationManager<Record
     unregister(): Promise<void>;
     enableControl(control: RecordingControlName, enabled: boolean): Promise<void>;
     isActive(): Promise<boolean>;
+    isRegistered(): boolean;
     addEventListener<T extends RecordingNotificationEventName>(eventName: T, callback: (event: NotificationEvents[T]) => void): AudioEventSubscription;
     removeEventListener(subscription: AudioEventSubscription): void;
 }

package/lib/typescript/web-system/notification/RecordingNotificationManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RecordingNotificationManager.d.ts","sourceRoot":"","sources":["../../../../src/web-system/notification/RecordingNotificationManager.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAC3D,OAAO,KAAK,EACV,mBAAmB,EACnB,yBAAyB,EACzB,oBAAoB,EACpB,8BAA8B,EAC9B,kBAAkB,EACnB,MAAM,cAAc,CAAC;AAGtB,cAAM,4BACJ,YACE,mBAAmB,CACjB,yBAAyB,EACzB,yBAAyB,EACzB,8BAA8B,CAC/B;IAEH,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,OAAO,CAAS;;IAIlB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAEzB,IAAI,CAAC,IAAI,EAAE,yBAAyB,GAAG,OAAO,CAAC,IAAI,CAAC;IAEpD,MAAM,CAAC,IAAI,EAAE,yBAAyB,GAAG,OAAO,CAAC,IAAI,CAAC;IAEtD,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAErB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAE3B,aAAa,CACjB,OAAO,EAAE,oBAAoB,EAC7B,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,IAAI,CAAC;IAEV,QAAQ,IAAI,OAAO,CAAC,OAAO,CAAC;IAIlC,gBAAgB,CAAC,CAAC,SAAS,8BAA8B,EACvD,SAAS,EAAE,CAAC,EACZ,QAAQ,EAAE,CAAC,KAAK,EAAE,kBAAkB,CAAC,CAAC,CAAC,KAAK,IAAI,GAC/C,sBAAsB;IAOzB,mBAAmB,CAAC,YAAY,EAAE,sBAAsB,GAAG,IAAI;CAChE;;AAED,wBAAkD"}
+{"version":3,"file":"RecordingNotificationManager.d.ts","sourceRoot":"","sources":["../../../../src/web-system/notification/RecordingNotificationManager.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAC3D,OAAO,KAAK,EACV,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,8BAA8B,EAC9B,yBAAyB,EAC1B,MAAM,cAAc,CAAC;AAGtB,cAAM,4BACJ,YACE,mBAAmB,CACjB,yBAAyB,EACzB,yBAAyB,EACzB,8BAA8B,CAC/B;IAEH,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAS;;IAInB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAEzB,IAAI,CAAC,IAAI,EAAE,yBAAyB,GAAG,OAAO,CAAC,IAAI,CAAC;IAEpD,MAAM,CAAC,IAAI,EAAE,yBAAyB,GAAG,OAAO,CAAC,IAAI,CAAC;IAEtD,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAErB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAE3B,aAAa,CACjB,OAAO,EAAE,oBAAoB,EAC7B,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,IAAI,CAAC;IAEV,QAAQ,IAAI,OAAO,CAAC,OAAO,CAAC;IAIlC,YAAY,IAAI,OAAO;IAIvB,gBAAgB,CAAC,CAAC,SAAS,8BAA8B,EACvD,SAAS,EAAE,CAAC,EACZ,QAAQ,EAAE,CAAC,KAAK,EAAE,kBAAkB,CAAC,CAAC,CAAC,KAAK,IAAI,GAC/C,sBAAsB;IAOzB,mBAAmB,CAAC,YAAY,EAAE,sBAAsB,GAAG,IAAI;CAChE;;AAED,wBAAkD"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-audio-api",
-  "version": "0.11.0-nightly-95f9c99-20251215",
+  "version": "0.11.0-nightly-dd83923-20251216",
   "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"
@@ -90,7 +90,7 @@
     "@babel/core": "^7.25.2",
     "@babel/preset-env": "^7.25.3",
     "@babel/types": "^7.20.0",
-    "@commitlint/config-conventional": "^17.0.2",
+    "@commitlint/config-conventional": "17.0.2",
     "@evilmartians/lefthook": "^1.5.0",
     "@expo/config-plugins": "^9.0.0",
     "@expo/config-types": "^53.0.4",
@@ -108,7 +108,7 @@
     "@types/react-test-renderer": "^19.1.0",
     "@types/semver": "7.7.1",
     "babel-plugin-module-resolver": "^4.1.0",
-    "commitlint": "^17.0.2",
+    "commitlint": "17.0.2",
     "del-cli": "^5.1.0",
     "eslint": "^8.57.0",
     "eslint-config-prettier": "^8.3.0",
@@ -130,7 +130,7 @@
     "react-native": "0.82.0",
     "react-native-builder-bob": "0.33.1",
     "turbo": "^1.10.7",
-    "typescript": "5.8.3"
+    "typescript": "~5.8.3"
   },
   "react-native-builder-bob": {
     "source": "src",

package/src/AudioAPIModule/globals.d.ts

@@ -6,7 +6,6 @@ import type {
   IAudioStretcher,
   IOfflineAudioContext,
 } from '../interfaces';
-import type { AudioRecorderOptions } from '../types';
 
 /* eslint-disable no-var */
 declare global {
@@ -23,7 +22,7 @@ declare global {
     audioWorkletRuntime: any
   ) => IOfflineAudioContext;
 
-  var createAudioRecorder: (options: AudioRecorderOptions) => IAudioRecorder;
+  var createAudioRecorder: () => IAudioRecorder;
 
   var createAudioDecoder: () => IAudioDecoder;
 

package/src/api.ts

@@ -25,49 +25,28 @@ export { default as StreamerNode } from './core/StreamerNode';
 export { default as WorkletNode } from './core/WorkletNode';
 export { default as WorkletProcessingNode } from './core/WorkletProcessingNode';
 export { default as WorkletSourceNode } from './core/WorkletSourceNode';
+
 export { default as useSystemVolume } from './hooks/useSystemVolume';
 export { default as AudioManager } from './system';
 
+export * from './errors';
+export * from './system/types';
+export * from './types';
+export { default as FilePreset } from './utils/filePresets';
+
 // Notification System
 export {
   PlaybackNotificationManager,
   RecordingNotificationManager,
 } from './system/notification';
 
-export {
-  AudioWorkletRuntime,
-  BiquadFilterType,
-  ChannelCountMode,
-  ChannelInterpretation,
-  ContextState,
-  OscillatorType,
-  PeriodicWaveConstraints,
-  WindowType,
-} from './types';
-
-export {
-  IOSCategory,
-  IOSMode,
-  IOSOption,
-  PermissionStatus,
-  SessionOptions,
-} from './system/types';
-
 export {
   NotificationManager,
-  PlaybackNotificationInfo,
   PlaybackControlName,
   PlaybackNotificationEventName,
-  RecordingNotificationInfo,
+  PlaybackNotificationInfo,
   RecordingControlName,
   RecordingNotificationEventName,
+  RecordingNotificationInfo,
   SimpleNotificationOptions,
 } from './system/notification';
-
-export {
-  IndexSizeError,
-  InvalidAccessError,
-  InvalidStateError,
-  NotSupportedError,
-  RangeError,
-} from './errors';

package/src/core/AudioRecorder.ts

@@ -1,57 +1,229 @@
+import { AudioEventEmitter, AudioEventSubscription } from '../events';
+import {
+  OnAudioReadyEventType,
+  OnRecorderErrorEventType,
+} from '../events/types';
 import { IAudioRecorder } from '../interfaces';
-import { AudioRecorderOptions } from '../types';
+import {
+  AudioRecorderCallbackOptions,
+  AudioRecorderFileOptions,
+  FileDirectory,
+  FileFormat,
+  FileInfo,
+  Result,
+} from '../types';
+import FilePreset from '../utils/filePresets';
 import AudioBuffer from './AudioBuffer';
-import { OnAudioReadyEventType } from '../events/types';
-import { AudioEventEmitter } from '../events';
 import RecorderAdapterNode from './RecorderAdapterNode';
 
+// Enforces default options, making sure that all properties are defined
+// for the contract with native code.
+function withDefaultOptions(
+  inOptions: AudioRecorderFileOptions
+): Required<AudioRecorderFileOptions> {
+  return {
+    directory: FileDirectory.Cache,
+    subDirectory: 'AudioAPI',
+    fileNamePrefix: 'recording_',
+    channelCount: 2,
+    format: FileFormat.M4A,
+    batchDurationSeconds: 0,
+    preset: FilePreset.High,
+    androidFlushIntervalMs: 500,
+    ...inOptions,
+  };
+}
+
 export default class AudioRecorder {
+  protected onAudioReadySubscription: AudioEventSubscription | null = null;
+  protected onErrorSubscription: AudioEventSubscription | null = null;
   protected readonly recorder: IAudioRecorder;
+  protected options_: AudioRecorderFileOptions | null = null;
+  private isFileOutputEnabled: boolean = false;
 
-  private readonly audioEventEmitter = new AudioEventEmitter(
+  protected readonly audioEventEmitter = new AudioEventEmitter(
     global.AudioEventEmitter
   );
 
-  constructor(options: AudioRecorderOptions) {
-    this.recorder = global.createAudioRecorder(options);
+  constructor() {
+    this.recorder = global.createAudioRecorder();
+  }
+
+  enableFileOutput(
+    // TODO: Re-enable 'batchDurationSeconds' once supported
+    options?: Omit<AudioRecorderFileOptions, 'batchDurationSeconds'>
+  ): Result<{ path: string }> {
+    this.options_ = options || {};
+    const parsedOptions = withDefaultOptions(this.options_);
+    const result = this.recorder.enableFileOutput(parsedOptions);
+    this.isFileOutputEnabled = true;
+
+    return result;
   }
 
-  public start(): void {
-    this.recorder.start();
+  public get options(): AudioRecorderFileOptions | null {
+    return this.options_;
   }
 
-  public stop(): void {
-    this.recorder.stop();
+  disableFileOutput(): void {
+    this.options_ = null;
+    this.recorder.disableFileOutput();
+    this.isFileOutputEnabled = false;
   }
 
-  public connect(node: RecorderAdapterNode): void {
+  /** Starts the audio recording process with configured output options */
+  start(): Result<{ path: string }> {
+    if (!this.isFileOutputEnabled) {
+      this.recorder.start();
+      return { status: 'success', path: '' };
+    }
+
+    return this.recorder.start();
+  }
+
+  /** Stops the audio recording process and releases internal resources */
+  stop(): Result<FileInfo> {
+    return this.recorder.stop();
+  }
+
+  /** Pauses the audio recording process without tearing down anything */
+  pause(): void {
+    this.recorder.pause();
+  }
+
+  /** Resumes the audio recording process after being paused */
+  resume(): void {
+    this.recorder.resume();
+  }
+
+  /**
+   * Connects a {@link RecorderAdapterNode} to the recorder’s audio graph.
+   *
+   * Each node can only be connected once. Attempting to connect a node multiple
+   * times will throw an error.
+   *
+   * @param node - The adapter node to connect to the recorder.
+   * @throws If the node has already been connected.
+   */
+  connect(node: RecorderAdapterNode): void {
     if (node.wasConnected) {
       throw new Error(
         'RecorderAdapterNode cannot be connected more than once. Refer to the documentation for more details.'
       );
     }
+
     node.wasConnected = true;
     this.recorder.connect(node.getNode());
   }
 
-  public disconnect(): void {
+  /**
+   * Disconnects the recorder from all connected adapter nodes.
+   *
+   * After calling this method, any connected {@link RecorderAdapterNode} will no
+   * longer receive audio data until reconnected.
+   */
+  disconnect(): void {
     this.recorder.disconnect();
   }
 
-  public onAudioReady(callback: (event: OnAudioReadyEventType) => void): void {
-    const onAudioReadyCallback = (event: OnAudioReadyEventType) => {
-      callback({
-        buffer: new AudioBuffer(event.buffer),
-        numFrames: event.numFrames,
-        when: event.when,
+  /**
+   * Registers a callback to receive raw audio data during an active recording
+   * session.
+   *
+   * The callback is periodically invoked with audio buffers that match the
+   * preferred configuration provided in `options`. These parameters (sample
+   * rate, buffer length, and channel count) guide how audio data is chunked and
+   * delivered, though the exact values may vary depending on device
+   * capabilities. Values may vary depending on device capabilities.
+   *
+   * @param options - Preferred configuration for the audio buffers delivered to
+   *   the callback.
+   * @param callback - Function invoked each time a new audio buffer is
+   *   available. The callback receives an {@link OnAudioReadyEventType} object
+   *   containing the audio data and associated metadata.
+   */
+  onAudioReady(
+    options: AudioRecorderCallbackOptions,
+    callback: (event: OnAudioReadyEventType) => void
+  ): Result<void> {
+    if (this.onAudioReadySubscription) {
+      this.recorder.clearOnAudioReady();
+      this.onAudioReadySubscription.remove();
+      this.onAudioReadySubscription = null;
+    }
+
+    this.onAudioReadySubscription =
+      this.audioEventEmitter.addAudioEventListener('audioReady', (event) => {
+        const audioBuffer = new AudioBuffer(event.buffer);
+        callback({
+          ...event,
+          buffer: audioBuffer,
+        });
       });
-    };
 
-    const subscription = this.audioEventEmitter.addAudioEventListener(
-      'audioReady',
-      onAudioReadyCallback
+    return this.recorder.setOnAudioReady({
+      sampleRate: options.sampleRate,
+      bufferLength: options.bufferLength,
+      channelCount: options.channelCount,
+      callbackId: this.onAudioReadySubscription.subscriptionId,
+    });
+  }
+
+  /**
+   * Removes the previously registered audio data callback, if any.
+   *
+   * This stops further `onAudioReady` events from being delivered during
+   * recording. Calling this method is safe even if no callback is currently
+   * registered.
+   */
+  clearOnAudioReady(): void {
+    if (!this.onAudioReadySubscription) {
+      return;
+    }
+
+    this.recorder.clearOnAudioReady();
+
+    this.onAudioReadySubscription.remove();
+    this.onAudioReadySubscription = null;
+  }
+
+  isRecording(): boolean {
+    return this.recorder.isRecording();
+  }
+
+  isPaused(): boolean {
+    return this.recorder.isPaused();
+  }
+
+  getCurrentDuration(): number {
+    return this.recorder.getCurrentDuration();
+  }
+
+  onError(callback: (error: OnRecorderErrorEventType) => void): void {
+    if (this.onErrorSubscription) {
+      this.recorder.clearOnError();
+      this.onErrorSubscription.remove();
+      this.onErrorSubscription = null;
+    }
+
+    this.onErrorSubscription = this.audioEventEmitter.addAudioEventListener(
+      'recorderError',
+      callback
     );
 
-    this.recorder.onAudioReady = subscription.subscriptionId;
+    this.recorder.setOnError({
+      callbackId: this.onErrorSubscription.subscriptionId,
+    });
+  }
+
+  clearOnError(): void {
+    if (!this.onErrorSubscription) {
+      return;
+    }
+
+    this.recorder.clearOnError();
+
+    this.onErrorSubscription.remove();
+    this.onErrorSubscription = null;
   }
 }

package/src/events/types.ts

@@ -9,7 +9,7 @@ export interface EventTypeWithValue {
 
 interface OnInterruptionEventType {
   type: 'ended' | 'began';
-  isTransient: boolean;
+  shouldResume: boolean;
 }
 
 interface OnRouteChangeEventType {
@@ -24,7 +24,26 @@ interface OnRouteChangeEventType {
     | 'NoSuitableRouteForCategory';
 }
 
-type SystemEvents = {
+export interface OnRecorderErrorEventType {
+  message: string;
+}
+
+interface RemoteCommandEvents {
+  remotePlay: EventEmptyType;
+  remotePause: EventEmptyType;
+  remoteStop: EventEmptyType;
+  remoteTogglePlayPause: EventEmptyType;
+  remoteChangePlaybackRate: EventTypeWithValue;
+  remoteNextTrack: EventEmptyType;
+  remotePreviousTrack: EventEmptyType;
+  remoteSkipForward: EventTypeWithValue;
+  remoteSkipBackward: EventTypeWithValue;
+  remoteSeekForward: EventEmptyType;
+  remoteSeekBackward: EventEmptyType;
+  remoteChangePlaybackPosition: EventTypeWithValue;
+}
+
+type SystemEvents = RemoteCommandEvents & {
   volumeChange: EventTypeWithValue;
   interruption: OnInterruptionEventType;
   routeChange: OnRouteChangeEventType;
@@ -35,9 +54,27 @@ export interface OnEndedEventType extends EventEmptyType {
   isLast: boolean | undefined;
 }
 
+/**
+ * Represents the data payload received by the audio recorder callback each time
+ * a new audio buffer becomes available during recording.
+ */
 export interface OnAudioReadyEventType {
+  /**
+   * The audio buffer containing the recorded PCM data. This buffer includes one
+   * or more channels of floating-point samples in the range of -1.0 to 1.0.
+   */
   buffer: AudioBuffer;
+
+  /**
+   * The number of audio frames contained in this buffer. A frame represents a
+   * single sample across all channels.
+   */
   numFrames: number;
+
+  /**
+   * The timestamp (in seconds) indicating when this buffer was captured,
+   * relative to the start of the recording session.
+   */
   when: number;
 }
 
@@ -48,6 +85,7 @@ interface AudioAPIEvents {
   positionChanged: EventTypeWithValue;
   audioError: EventEmptyType; // to change
   systemStateChanged: EventEmptyType; // to change
+  recorderError: OnRecorderErrorEventType;
 }
 
 type AudioEvents = SystemEvents & AudioAPIEvents & NotificationEvents;