@symbiote-native/audio 0.1.0

package/build/core/native-module.d.ts

@@ -0,0 +1,134 @@
+import { SharedObject } from 'expo-modules-core';
+import type { PermissionResponse } from 'expo-modules-core';
+import type { IAudioMetadata, IAudioMode, IAudioPlaylistLoopMode, IAudioSample, IAudioSource, IAudioStatus, IAudioLockScreenOptions, IAudioPlaylistStatus, IPitchCorrectionQuality, IRecorderState, IRecordingInput, IRecordingOptions, IRecordingStartOptions, IRecordingStatus } from './types';
+export type NativeAudioPlayerEvents = {
+    playbackStatusUpdate(status: IAudioStatus): void;
+    audioSampleUpdate(data: IAudioSample): void;
+};
+export declare class NativeAudioPlayer extends SharedObject<NativeAudioPlayerEvents> {
+    constructor(source: IAudioSource, updateInterval: number, keepAudioSessionActive: boolean, preferredForwardBufferDuration: number);
+    id: string;
+    playing: boolean;
+    muted: boolean;
+    loop: boolean;
+    paused: boolean;
+    isLoaded: boolean;
+    isAudioSamplingSupported: boolean;
+    isBuffering: boolean;
+    currentTime: number;
+    duration: number;
+    volume: number;
+    playbackRate: number;
+    shouldCorrectPitch: boolean;
+    currentStatus: IAudioStatus;
+    play(): void;
+    pause(): void;
+    replace(source: IAudioSource): void;
+    seekTo(seconds: number, toleranceMillisBefore?: number, toleranceMillisAfter?: number): Promise<void>;
+    setPlaybackRate(rate: number, pitchCorrectionQuality?: IPitchCorrectionQuality): void;
+    setAudioSamplingEnabled(enabled: boolean): void;
+    setActiveForLockScreen(active: boolean, metadata?: IAudioMetadata, options?: IAudioLockScreenOptions): void;
+    updateLockScreenMetadata(metadata: IAudioMetadata): void;
+    clearLockScreenControls(): void;
+    remove(): void;
+}
+export type NativeAudioRecorderEvents = {
+    recordingStatusUpdate: (status: IRecordingStatus) => void;
+};
+export declare class NativeAudioRecorder extends SharedObject<NativeAudioRecorderEvents> {
+    constructor(options: Partial<IRecordingOptions>);
+    id: string;
+    currentTime: number;
+    isRecording: boolean;
+    uri: string | null;
+    record(options?: IRecordingStartOptions): void;
+    stop(): Promise<void>;
+    pause(): void;
+    getAvailableInputs(): IRecordingInput[];
+    getCurrentInput(): Promise<IRecordingInput>;
+    setInput(inputUid: string): void;
+    getStatus(): IRecorderState;
+    /** @deprecated Use `record({ atTime: seconds })` instead. */
+    startRecordingAtTime(seconds: number): void;
+    prepareToRecordAsync(options?: Partial<IRecordingOptions>): Promise<void>;
+    /** @deprecated Use `record({ forDuration: seconds })` instead. */
+    recordForDuration(seconds: number): void;
+}
+export type NativeAudioPlaylistEvents = {
+    playlistStatusUpdate(status: IAudioPlaylistStatus): void;
+    trackChanged(data: {
+        previousIndex: number;
+        currentIndex: number;
+    }): void;
+};
+export declare class NativeAudioPlaylist extends SharedObject<NativeAudioPlaylistEvents> {
+    constructor(sources: IAudioSource[], updateInterval: number, loop: IAudioPlaylistLoopMode);
+    id: string;
+    readonly currentIndex: number;
+    readonly trackCount: number;
+    readonly sources: {
+        uri?: string;
+        name?: string;
+    }[];
+    playing: boolean;
+    muted: boolean;
+    isLoaded: boolean;
+    isBuffering: boolean;
+    currentTime: number;
+    duration: number;
+    volume: number;
+    playbackRate: number;
+    loop: IAudioPlaylistLoopMode;
+    currentStatus: IAudioPlaylistStatus;
+    play(): void;
+    pause(): void;
+    next(): void;
+    previous(): void;
+    skipTo(index: number): void;
+    seekTo(seconds: number): Promise<void>;
+    add(source: IAudioSource): void;
+    insert(source: IAudioSource, index: number): void;
+    remove(index: number): void;
+    clear(): void;
+    destroy(): void;
+}
+export type NativeAudioStreamEvents = {
+    audioStreamBuffer(buffer: {
+        data: ArrayBuffer;
+        sampleRate: number;
+        channels: number;
+        timestamp: number;
+    }): void;
+    audioStreamStatus(status: {
+        isStreaming: boolean;
+    }): void;
+};
+export declare class NativeAudioStream extends SharedObject<NativeAudioStreamEvents> {
+    constructor(options: {
+        sampleRate: number;
+        channels: number;
+        encoding: string;
+    });
+    id: string;
+    readonly sampleRate: number;
+    readonly channels: number;
+    readonly isStreaming: boolean;
+    start(): Promise<void>;
+    stop(): void;
+}
+export type INativeAudioModule = {
+    readonly AudioPlayer: typeof NativeAudioPlayer;
+    readonly AudioRecorder: typeof NativeAudioRecorder;
+    readonly AudioPlaylist: typeof NativeAudioPlaylist;
+    readonly AudioStream: typeof NativeAudioStream;
+    setIsAudioActiveAsync(active: boolean): Promise<void>;
+    setAudioModeAsync(mode: Partial<IAudioMode>): Promise<void>;
+    requestRecordingPermissionsAsync(): Promise<PermissionResponse>;
+    requestNotificationPermissionsAsync(): Promise<PermissionResponse>;
+    getRecordingPermissionsAsync(): Promise<PermissionResponse>;
+    preload(source: IAudioSource, preferredForwardBufferDuration: number): Promise<void>;
+    clearPreloadedSource(source: IAudioSource): Promise<void>;
+    clearAllPreloadedSources(): Promise<void>;
+    getPreloadedSources(): Promise<string[]>;
+};
+export declare const expoAudio: INativeAudioModule;

package/build/core/native-module.js

@@ -0,0 +1,2 @@
+import { requireNativeModule, SharedObject } from 'expo-modules-core';
+export const expoAudio = requireNativeModule('ExpoAudio');

package/build/core/recording-presets.d.ts

@@ -0,0 +1,50 @@
+import type { IRecordingOptions } from './types';
+/** @platform ios */
+export declare enum IOSOutputFormat {
+    LINEARPCM = "lpcm",
+    AC3 = "ac-3",
+    '60958AC3' = "cac3",
+    APPLEIMA4 = "ima4",
+    MPEG4AAC = "aac ",
+    MPEG4CELP = "celp",
+    MPEG4HVXC = "hvxc",
+    MPEG4TWINVQ = "twvq",
+    MACE3 = "MAC3",
+    MACE6 = "MAC6",
+    ULAW = "ulaw",
+    ALAW = "alaw",
+    QDESIGN = "QDMC",
+    QDESIGN2 = "QDM2",
+    QUALCOMM = "Qclp",
+    MPEGLAYER1 = ".mp1",
+    MPEGLAYER2 = ".mp2",
+    MPEGLAYER3 = ".mp3",
+    APPLELOSSLESS = "alac",
+    MPEG4AAC_HE = "aach",
+    MPEG4AAC_LD = "aacl",
+    MPEG4AAC_ELD = "aace",
+    MPEG4AAC_ELD_SBR = "aacf",
+    MPEG4AAC_ELD_V2 = "aacg",
+    MPEG4AAC_HE_V2 = "aacp",
+    MPEG4AAC_SPATIAL = "aacs",
+    AMR = "samr",
+    AMR_WB = "sawb",
+    AUDIBLE = "AUDB",
+    ILBC = "ilbc",
+    DVIINTELIMA = 1836253201,
+    MICROSOFTGSM = 1836253233,
+    AES3 = "aes3",
+    ENHANCEDAC3 = "ec-3"
+}
+export declare enum AudioQuality {
+    MIN = 0,
+    LOW = 32,
+    MEDIUM = 64,
+    HIGH = 96,
+    MAX = 127
+}
+/** The two preset `IRecordingOptions` bundles expo-audio ships. */
+export declare const RecordingPresets: {
+    readonly HIGH_QUALITY: IRecordingOptions;
+    readonly LOW_QUALITY: IRecordingOptions;
+};

package/build/core/recording-presets.js

@@ -0,0 +1,94 @@
+/** @platform ios */
+export var IOSOutputFormat;
+(function (IOSOutputFormat) {
+    IOSOutputFormat["LINEARPCM"] = "lpcm";
+    IOSOutputFormat["AC3"] = "ac-3";
+    IOSOutputFormat["60958AC3"] = "cac3";
+    IOSOutputFormat["APPLEIMA4"] = "ima4";
+    IOSOutputFormat["MPEG4AAC"] = "aac ";
+    IOSOutputFormat["MPEG4CELP"] = "celp";
+    IOSOutputFormat["MPEG4HVXC"] = "hvxc";
+    IOSOutputFormat["MPEG4TWINVQ"] = "twvq";
+    IOSOutputFormat["MACE3"] = "MAC3";
+    IOSOutputFormat["MACE6"] = "MAC6";
+    IOSOutputFormat["ULAW"] = "ulaw";
+    IOSOutputFormat["ALAW"] = "alaw";
+    IOSOutputFormat["QDESIGN"] = "QDMC";
+    IOSOutputFormat["QDESIGN2"] = "QDM2";
+    IOSOutputFormat["QUALCOMM"] = "Qclp";
+    IOSOutputFormat["MPEGLAYER1"] = ".mp1";
+    IOSOutputFormat["MPEGLAYER2"] = ".mp2";
+    IOSOutputFormat["MPEGLAYER3"] = ".mp3";
+    IOSOutputFormat["APPLELOSSLESS"] = "alac";
+    IOSOutputFormat["MPEG4AAC_HE"] = "aach";
+    IOSOutputFormat["MPEG4AAC_LD"] = "aacl";
+    IOSOutputFormat["MPEG4AAC_ELD"] = "aace";
+    IOSOutputFormat["MPEG4AAC_ELD_SBR"] = "aacf";
+    IOSOutputFormat["MPEG4AAC_ELD_V2"] = "aacg";
+    IOSOutputFormat["MPEG4AAC_HE_V2"] = "aacp";
+    IOSOutputFormat["MPEG4AAC_SPATIAL"] = "aacs";
+    IOSOutputFormat["AMR"] = "samr";
+    IOSOutputFormat["AMR_WB"] = "sawb";
+    IOSOutputFormat["AUDIBLE"] = "AUDB";
+    IOSOutputFormat["ILBC"] = "ilbc";
+    IOSOutputFormat[IOSOutputFormat["DVIINTELIMA"] = 1836253201] = "DVIINTELIMA";
+    IOSOutputFormat[IOSOutputFormat["MICROSOFTGSM"] = 1836253233] = "MICROSOFTGSM";
+    IOSOutputFormat["AES3"] = "aes3";
+    IOSOutputFormat["ENHANCEDAC3"] = "ec-3";
+})(IOSOutputFormat || (IOSOutputFormat = {}));
+export var AudioQuality;
+(function (AudioQuality) {
+    AudioQuality[AudioQuality["MIN"] = 0] = "MIN";
+    AudioQuality[AudioQuality["LOW"] = 32] = "LOW";
+    AudioQuality[AudioQuality["MEDIUM"] = 64] = "MEDIUM";
+    AudioQuality[AudioQuality["HIGH"] = 96] = "HIGH";
+    AudioQuality[AudioQuality["MAX"] = 127] = "MAX";
+})(AudioQuality || (AudioQuality = {}));
+const HIGH_QUALITY = {
+    extension: '.m4a',
+    sampleRate: 44100,
+    numberOfChannels: 2,
+    bitRate: 128000,
+    android: {
+        outputFormat: 'mpeg4',
+        audioEncoder: 'aac',
+    },
+    ios: {
+        outputFormat: IOSOutputFormat.MPEG4AAC,
+        audioQuality: AudioQuality.MAX,
+        linearPCMBitDepth: 16,
+        linearPCMIsBigEndian: false,
+        linearPCMIsFloat: false,
+    },
+    web: {
+        mimeType: 'audio/webm',
+        bitsPerSecond: 128000,
+    },
+};
+const LOW_QUALITY = {
+    extension: '.m4a',
+    sampleRate: 44100,
+    numberOfChannels: 2,
+    bitRate: 64000,
+    android: {
+        extension: '.3gp',
+        outputFormat: '3gp',
+        audioEncoder: 'amr_nb',
+    },
+    ios: {
+        audioQuality: AudioQuality.MIN,
+        outputFormat: IOSOutputFormat.MPEG4AAC,
+        linearPCMBitDepth: 16,
+        linearPCMIsBigEndian: false,
+        linearPCMIsFloat: false,
+    },
+    web: {
+        mimeType: 'audio/webm',
+        bitsPerSecond: 128000,
+    },
+};
+/** The two preset `IRecordingOptions` bundles expo-audio ships. */
+export const RecordingPresets = {
+    HIGH_QUALITY,
+    LOW_QUALITY,
+};

package/build/core/resolve-source.d.ts

@@ -0,0 +1,10 @@
+import type { IAudioSource } from './types';
+/**
+ * Normalizes a source into the shape the native player accepts. A `number` (a `require()`'d
+ * local asset) resolves via `@symbiote-native/engine`'s `resolveAssetSource` seam — RN's own
+ * generic asset-registry lookup, wired by `bootstrapHost`. An actual `expo-asset` `Asset`
+ * instance is still not ported, see `types.ts`'s header comment on `IAudioSource`. A plain
+ * string is treated as a URI, matching upstream.
+ */
+export declare function resolveSource(source?: IAudioSource): IAudioSource | null;
+export declare function resolveSources(sources: IAudioSource[]): NonNullable<IAudioSource>[];

package/build/core/resolve-source.js

@@ -0,0 +1,31 @@
+import { resolveAssetSource } from '@symbiote-native/engine';
+// resolveAssetSource returns `unknown` by design (the seam serves every require()'d-asset
+// consumer, not just this package) — narrow it instead of casting.
+function isAudioSourceObject(value) {
+    return typeof value === 'object' && value !== null;
+}
+/**
+ * Normalizes a source into the shape the native player accepts. A `number` (a `require()`'d
+ * local asset) resolves via `@symbiote-native/engine`'s `resolveAssetSource` seam — RN's own
+ * generic asset-registry lookup, wired by `bootstrapHost`. An actual `expo-asset` `Asset`
+ * instance is still not ported, see `types.ts`'s header comment on `IAudioSource`. A plain
+ * string is treated as a URI, matching upstream.
+ */
+export function resolveSource(source) {
+    if (source == null) {
+        return null;
+    }
+    if (typeof source === 'number') {
+        const resolved = resolveAssetSource(source);
+        return isAudioSourceObject(resolved) ? resolved : null;
+    }
+    if (typeof source === 'string') {
+        return { uri: source };
+    }
+    return source;
+}
+export function resolveSources(sources) {
+    return sources
+        .map(source => resolveSource(source))
+        .filter((source) => source != null);
+}

package/build/core/types.d.ts

@@ -0,0 +1,218 @@
+import type { AudioQuality, IOSOutputFormat } from './recording-presets';
+/** Audio source information returned from native when reading sources from a queue. */
+export type IAudioSourceInfo = {
+    uri?: string;
+    name?: string;
+};
+/**
+ * A URI string, an object describing a remote/local (by URI) audio source, or the numeric asset
+ * id `require('./song.mp3')` produces — resolved via `resolveSource`/`resolveSources`.
+ */
+export type IAudioSource = string | number | null | {
+    uri?: string;
+    headers?: Record<string, string>;
+    name?: string;
+};
+export type IAudioPlayerOptions = {
+    /** How often (in milliseconds) to emit playback status updates. @default 500 */
+    updateInterval?: number;
+    /** @platform web */
+    crossOrigin?: 'anonymous' | 'use-credentials';
+    /**
+     * If `true`, the audio session is not deactivated when this player pauses or finishes.
+     * @platform ios
+     * @default false
+     */
+    keepAudioSessionActive?: boolean;
+    /**
+     * Seconds to buffer ahead of the current playback position.
+     * @platform ios
+     * @platform android
+     * @default 0
+     */
+    preferredForwardBufferDuration?: number;
+};
+export type IPreloadOptions = {
+    /** @default 10 */
+    preferredForwardBufferDuration?: number;
+};
+export type IRecordingInput = {
+    name: string;
+    type: string;
+    uid: string;
+};
+export type IPitchCorrectionQuality = 'low' | 'medium' | 'high';
+export type IAudioStatus = {
+    id: string;
+    currentTime: number;
+    playbackState: string;
+    timeControlStatus: string;
+    reasonForWaitingToPlay: string;
+    mute: boolean;
+    duration: number;
+    playing: boolean;
+    loop: boolean;
+    didJustFinish: boolean;
+    isBuffering: boolean;
+    isLoaded: boolean;
+    playbackRate: number;
+    shouldCorrectPitch: boolean;
+    /** @platform ios */
+    mediaServicesDidReset?: boolean;
+    isLive: boolean;
+    currentOffsetFromLive: number | null;
+    error: string | null;
+};
+export type IRecordingStatus = {
+    id: string;
+    isFinished: boolean;
+    hasError: boolean;
+    error: string | null;
+    url: string | null;
+    /** @platform ios */
+    mediaServicesDidReset?: boolean;
+};
+export type IRecorderState = {
+    canRecord: boolean;
+    isRecording: boolean;
+    durationMillis: number;
+    mediaServicesDidReset: boolean;
+    metering?: number;
+    url: string | null;
+};
+/** @platform android */
+export type IAndroidOutputFormat = 'default' | '3gp' | 'mpeg4' | 'amrnb' | 'amrwb' | 'aac_adts' | 'mpeg2ts' | 'webm';
+/** @platform android */
+export type IAndroidAudioEncoder = 'default' | 'amr_nb' | 'amr_wb' | 'aac' | 'he_aac' | 'aac_eld';
+export type IRecordingStartOptions = {
+    /** @platform ios @platform android @platform web */
+    forDuration?: number;
+    /** @platform ios */
+    atTime?: number;
+};
+/** @platform android @platform ios */
+export type IRecordingDirectory = 'cache' | 'document';
+export type IRecordingOptionsWeb = {
+    mimeType?: string;
+    bitsPerSecond?: number;
+};
+/** @platform ios */
+export type IRecordingOptionsIos = {
+    extension?: string;
+    sampleRate?: number;
+    outputFormat?: string | IOSOutputFormat | number;
+    audioQuality: AudioQuality | number;
+    bitRateStrategy?: number;
+    bitDepthHint?: number;
+    linearPCMBitDepth?: number;
+    linearPCMIsBigEndian?: boolean;
+    linearPCMIsFloat?: boolean;
+};
+/** @platform android */
+export type IRecordingSource = 'camcorder' | 'default' | 'mic' | 'remote_submix' | 'unprocessed' | 'voice_communication' | 'voice_performance' | 'voice_recognition';
+/** @platform android */
+export type IRecordingOptionsAndroid = {
+    extension?: string;
+    sampleRate?: number;
+    outputFormat: IAndroidOutputFormat;
+    audioEncoder: IAndroidAudioEncoder;
+    maxFileSize?: number;
+    audioSource?: IRecordingSource;
+};
+export type IRecordingOptions = {
+    /** @default 'cache' */
+    directory?: IRecordingDirectory;
+    isMeteringEnabled?: boolean;
+    extension: string;
+    sampleRate: number;
+    numberOfChannels: number;
+    bitRate: number;
+    android: IRecordingOptionsAndroid;
+    ios: IRecordingOptionsIos;
+    web: IRecordingOptionsWeb;
+};
+export type IAudioMode = {
+    /** @default true */
+    playsInSilentMode: boolean;
+    /** @default 'mixWithOthers' */
+    interruptionMode: IInterruptionMode;
+    /** @default false @platform ios */
+    allowsRecording: boolean;
+    /** @default false */
+    shouldPlayInBackground: boolean;
+    /** @default false */
+    shouldRouteThroughEarpiece: boolean;
+    /** @default false @platform ios @platform android */
+    allowsBackgroundRecording?: boolean;
+};
+export type IInterruptionMode = 'mixWithOthers' | 'doNotMix' | 'duckOthers';
+export type IAudioMetadata = {
+    title?: string;
+    artist?: string;
+    albumTitle?: string;
+    artworkUrl?: string;
+};
+export type IAudioPlaylistLoopMode = 'none' | 'single' | 'all';
+export type IAudioPlaylistOptions = {
+    /** @default [] */
+    sources?: IAudioSource[];
+    /** @default 500 */
+    updateInterval?: number;
+    /** @default 'none' */
+    loop?: IAudioPlaylistLoopMode;
+    /** @platform web */
+    crossOrigin?: 'anonymous' | 'use-credentials';
+};
+export type IAudioPlaylistStatus = {
+    id: string;
+    currentIndex: number;
+    trackCount: number;
+    currentTime: number;
+    duration: number;
+    playing: boolean;
+    isBuffering: boolean;
+    isLoaded: boolean;
+    playbackRate: number;
+    muted: boolean;
+    volume: number;
+    loop: IAudioPlaylistLoopMode;
+    didJustFinish: boolean;
+};
+/** From AudioConstants.ts — which lock-screen controls to show while a player is active. */
+export type IAudioLockScreenOptions = {
+    showSeekForward?: boolean;
+    showSeekBackward?: boolean;
+    isLiveStream?: boolean;
+};
+export type IAudioSample = {
+    channels: {
+        frames: number[];
+    }[];
+    timestamp: number;
+};
+export type IAudioStreamEncoding = 'float32' | 'int16';
+export type IAudioStreamOptions = {
+    /** @default 48000 */
+    sampleRate?: number;
+    /** @default 1 */
+    channels?: number;
+    /** @default 'float32' */
+    encoding?: IAudioStreamEncoding;
+};
+export type IAudioStreamBuffer = {
+    data: ArrayBuffer;
+    sampleRate: number;
+    channels: number;
+    timestamp: number;
+};
+export type IAudioStreamStatus = {
+    isStreaming: boolean;
+};
+/** From AudioEventKeys.ts — event names the `SharedObject` classes' `addListener` accepts. */
+export declare const PLAYBACK_STATUS_UPDATE = "playbackStatusUpdate";
+export declare const AUDIO_SAMPLE_UPDATE = "audioSampleUpdate";
+export declare const RECORDING_STATUS_UPDATE = "recordingStatusUpdate";
+export declare const PLAYLIST_STATUS_UPDATE = "playlistStatusUpdate";
+export declare const TRACK_CHANGED = "trackChanged";
+export declare const AUDIO_STREAM_BUFFER = "audioStreamBuffer";
+export declare const AUDIO_STREAM_STATUS = "audioStreamStatus";

package/build/core/types.js

@@ -0,0 +1,8 @@
+/** From AudioEventKeys.ts — event names the `SharedObject` classes' `addListener` accepts. */
+export const PLAYBACK_STATUS_UPDATE = 'playbackStatusUpdate';
+export const AUDIO_SAMPLE_UPDATE = 'audioSampleUpdate';
+export const RECORDING_STATUS_UPDATE = 'recordingStatusUpdate';
+export const PLAYLIST_STATUS_UPDATE = 'playlistStatusUpdate';
+export const TRACK_CHANGED = 'trackChanged';
+export const AUDIO_STREAM_BUFFER = 'audioStreamBuffer';
+export const AUDIO_STREAM_STATUS = 'audioStreamStatus';

package/build-ngc/angular/index.d.ts

@@ -0,0 +1 @@
+export * from '../core';

package/build-ngc/angular/index.js

@@ -0,0 +1,5 @@
+// @symbiote-native/audio/angular: the Angular entry over the framework-agnostic core. Same
+// reasoning as the React/Vue entries — every export here is a plain class/function with no
+// framework-specific lifecycle to wrap, so this is a plain re-export.
+export * from '../core';
+//# sourceMappingURL=index.js.map

package/build-ngc/angular/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/angular/index.ts"],"names":[],"mappings":"AAAA,2FAA2F;AAC3F,2FAA2F;AAC3F,sEAAsE;AACtE,cAAc,SAAS,CAAC"}

package/build-ngc/core/audio-module.d.ts

@@ -0,0 +1,26 @@
+import { type PermissionResponse } from 'expo-modules-core';
+import type { IAudioMode, IAudioSource, IPreloadOptions } from './types';
+/** Enables or disables the audio subsystem globally — pauses all playback when set to `false`. */
+export declare function setIsAudioActiveAsync(active: boolean): Promise<void>;
+/** Configures the global audio session — background playback, mixing, interruption handling. */
+export declare function setAudioModeAsync(mode: Partial<IAudioMode>): Promise<void>;
+/** Requests microphone-access permission required for recording. */
+export declare function requestRecordingPermissionsAsync(): Promise<PermissionResponse>;
+/**
+ * Requests permission to post notifications on Android, needed for lock-screen/notification-shade
+ * playback controls. @platform android — throws on every other platform.
+ */
+export declare function requestNotificationPermissionsAsync(): Promise<PermissionResponse>;
+/** Checks the current recording-permission status without prompting. */
+export declare function getRecordingPermissionsAsync(): Promise<PermissionResponse>;
+/**
+ * Preloads an audio source for near-instant playback later — call at module scope, before any
+ * player is created from the same source.
+ */
+export declare function preload(source: IAudioSource, options?: IPreloadOptions): Promise<void>;
+/** Releases a specific preloaded source (must match what was passed to `preload`). */
+export declare function clearPreloadedSource(source: IAudioSource): Promise<void>;
+/** Releases every preloaded source. */
+export declare function clearAllPreloadedSources(): Promise<void>;
+/** URIs of every source currently in the preload cache. */
+export declare function getPreloadedSources(): Promise<string[]>;

package/build-ngc/core/audio-module.js

@@ -0,0 +1,65 @@
+import { Platform } from 'expo-modules-core';
+import { expoAudio } from './native-module';
+import { resolveSource } from './resolve-source';
+/** Enables or disables the audio subsystem globally — pauses all playback when set to `false`. */
+export async function setIsAudioActiveAsync(active) {
+    return expoAudio.setIsAudioActiveAsync(active);
+}
+/** Configures the global audio session — background playback, mixing, interruption handling. */
+export async function setAudioModeAsync(mode) {
+    const audioMode = Platform.OS === 'ios'
+        ? mode
+        : {
+            shouldPlayInBackground: mode.shouldPlayInBackground,
+            shouldRouteThroughEarpiece: mode.shouldRouteThroughEarpiece,
+            interruptionMode: mode.interruptionMode,
+            allowsBackgroundRecording: mode.allowsBackgroundRecording,
+            playsInSilentMode: mode.playsInSilentMode,
+        };
+    return expoAudio.setAudioModeAsync(audioMode);
+}
+/** Requests microphone-access permission required for recording. */
+export async function requestRecordingPermissionsAsync() {
+    return expoAudio.requestRecordingPermissionsAsync();
+}
+/**
+ * Requests permission to post notifications on Android, needed for lock-screen/notification-shade
+ * playback controls. @platform android — throws on every other platform.
+ */
+export async function requestNotificationPermissionsAsync() {
+    if (Platform.OS !== 'android') {
+        throw new Error('expo-audio: `requestNotificationPermissionsAsync` is only available on Android.');
+    }
+    return expoAudio.requestNotificationPermissionsAsync();
+}
+/** Checks the current recording-permission status without prompting. */
+export async function getRecordingPermissionsAsync() {
+    return expoAudio.getRecordingPermissionsAsync();
+}
+/**
+ * Preloads an audio source for near-instant playback later — call at module scope, before any
+ * player is created from the same source.
+ */
+export async function preload(source, options = {}) {
+    const resolved = resolveSource(source);
+    if (!resolved)
+        return;
+    const { preferredForwardBufferDuration = 10 } = options;
+    return expoAudio.preload(resolved, preferredForwardBufferDuration);
+}
+/** Releases a specific preloaded source (must match what was passed to `preload`). */
+export async function clearPreloadedSource(source) {
+    const resolved = resolveSource(source);
+    if (!resolved)
+        return;
+    return expoAudio.clearPreloadedSource(resolved);
+}
+/** Releases every preloaded source. */
+export async function clearAllPreloadedSources() {
+    return expoAudio.clearAllPreloadedSources();
+}
+/** URIs of every source currently in the preload cache. */
+export async function getPreloadedSources() {
+    return expoAudio.getPreloadedSources();
+}
+//# sourceMappingURL=audio-module.js.map

package/build-ngc/core/audio-module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio-module.js","sourceRoot":"","sources":["../../src/core/audio-module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAA2B,MAAM,mBAAmB,CAAC;AACtE,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAGjD,kGAAkG;AAClG,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,MAAe;IACzD,OAAO,SAAS,CAAC,qBAAqB,CAAC,MAAM,CAAC,CAAC;AACjD,CAAC;AAED,gGAAgG;AAChG,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,IAAyB;IAEzB,MAAM,SAAS,GACb,QAAQ,CAAC,EAAE,KAAK,KAAK;QACnB,CAAC,CAAC,IAAI;QACN,CAAC,CAAC;YACE,sBAAsB,EAAE,IAAI,CAAC,sBAAsB;YACnD,0BAA0B,EAAE,IAAI,CAAC,0BAA0B;YAC3D,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;YACvC,yBAAyB,EAAE,IAAI,CAAC,yBAAyB;YACzD,iBAAiB,EAAE,IAAI,CAAC,iBAAiB;SAC1C,CAAC;IACR,OAAO,SAAS,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC;AAChD,CAAC;AAED,oEAAoE;AACpE,MAAM,CAAC,KAAK,UAAU,gCAAgC;IACpD,OAAO,SAAS,CAAC,gCAAgC,EAAE,CAAC;AACtD,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,mCAAmC;IACvD,IAAI,QAAQ,CAAC,EAAE,KAAK,SAAS,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CACb,iFAAiF,CAClF,CAAC;IACJ,CAAC;IACD,OAAO,SAAS,CAAC,mCAAmC,EAAE,CAAC;AACzD,CAAC;AAED,wEAAwE;AACxE,MAAM,CAAC,KAAK,UAAU,4BAA4B;IAChD,OAAO,SAAS,CAAC,4BAA4B,EAAE,CAAC;AAClD,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,MAAoB,EACpB,UAA2B,EAAE;IAE7B,MAAM,QAAQ,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;IACvC,IAAI,CAAC,QAAQ;QAAE,OAAO;IACtB,MAAM,EAAE,8BAA8B,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC;IACxD,OAAO,SAAS,CAAC,OAAO,CAAC,QAAQ,EAAE,8BAA8B,CAAC,CAAC;AACrE,CAAC;AAED,sFAAsF;AACtF,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,MAAoB;IAEpB,MAAM,QAAQ,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;IACvC,IAAI,CAAC,QAAQ;QAAE,OAAO;IACtB,OAAO,SAAS,CAAC,oBAAoB,CAAC,QAAQ,CAAC,CAAC;AAClD,CAAC;AAED,uCAAuC;AACvC,MAAM,CAAC,KAAK,UAAU,wBAAwB;IAC5C,OAAO,SAAS,CAAC,wBAAwB,EAAE,CAAC;AAC9C,CAAC;AAED,2DAA2D;AAC3D,MAAM,CAAC,KAAK,UAAU,mBAAmB;IACvC,OAAO,SAAS,CAAC,mBAAmB,EAAE,CAAC;AACzC,CAAC"}