@5stones/react-native-audio-browser 0.1.0

package/lib/typescript/src/features/favorites.d.ts

@@ -0,0 +1,84 @@
+import type { Track } from '../types';
+import { NativeUpdatedValue } from '../utils/NativeUpdatedValue';
+/**
+ * Sets the favorited state of the currently playing track.
+ * Updates the heart icon in media controllers (notification, Android Auto).
+ *
+ * Use this for programmatic favorite changes (e.g., from a favorite button in your app).
+ * For heart button taps from media controllers, use `onFavoriteChanged` instead -
+ * the native side handles those automatically.
+ *
+ * @param favorited - Whether the track is favorited
+ *
+ * @example
+ * ```ts
+ * setActiveTrackFavorited(true)
+ * ```
+ */
+export declare function setActiveTrackFavorited(favorited: boolean): void;
+/**
+ * Toggles the favorited state of the currently playing track.
+ *
+ * @example
+ * ```ts
+ * // In a button handler
+ * toggleActiveTrackFavorited()
+ * ```
+ */
+export declare function toggleActiveTrackFavorited(): void;
+/**
+ * Sets the list of favorited track source identifiers.
+ *
+ * This syncs your app's favorites with the native favorites cache, enabling
+ * the heart button in media controllers (notification, Android Auto, CarPlay)
+ * to show the correct state.
+ *
+ * Note: This is only needed if the tracks provided to AudioBrowser do not
+ * include the `favorited` field. If your API already includes favorite state in
+ * track responses, the native favorites cache is populated automatically during browsing.
+ *
+ * When the heart button is tapped in media controllers or when you call
+ * `setActiveTrackFavorited()`, the native favorites cache is automatically
+ * updated. You only need to call this on app launch to hydrate the cache.
+ *
+ * @param favorites - Array of favorited track `src` values
+ *
+ * @example
+ * ```ts
+ * const favoriteSrcs = await loadFavoritesFromStorage()
+ * setFavorites(favoriteSrcs)
+ * ```
+ */
+export declare function setFavorites(favorites: string[]): void;
+/**
+ * Event data for when the favorite state of the active track changes.
+ * Emitted when the user taps the heart button in a media controller (notification, Android Auto, CarPlay).
+ */
+export interface FavoriteChangedEvent {
+    /** The track whose favorite state changed. */
+    track: Track;
+    /** The new favorite state. */
+    favorited: boolean;
+}
+/**
+ * Subscribes to favorite state change events.
+ * Called when the user taps the heart button in a media controller.
+ * The native side has already updated the track's favorite state and UI.
+ *
+ * @param callback - Called with the track and its new favorite state
+ * @returns Cleanup function to unsubscribe
+ *
+ * @example
+ * ```ts
+ * const unsubscribe = onFavoriteChanged.addListener(({ track, favorited }) => {
+ *   // Persist the change to your backend/storage
+ *   if (favorited) {
+ *     addToFavorites(track)
+ *   } else {
+ *     removeFromFavorites(track)
+ *   }
+ * })
+ * ```
+ */
+export declare const onFavoriteChanged: NativeUpdatedValue<FavoriteChangedEvent>;
+//# sourceMappingURL=favorites.d.ts.map

package/lib/typescript/src/features/favorites.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"favorites.d.ts","sourceRoot":"","sources":["../../../../src/features/favorites.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,UAAU,CAAA;AACrC,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAA;AAIhE;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,OAAO,GAAG,IAAI,CAEhE;AAED;;;;;;;;GAQG;AACH,wBAAgB,0BAA0B,IAAI,IAAI,CAEjD;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,IAAI,CAEtD;AAID;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,8CAA8C;IAC9C,KAAK,EAAE,KAAK,CAAA;IACZ,8BAA8B;IAC9B,SAAS,EAAE,OAAO,CAAA;CACnB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,iBAAiB,0CAG3B,CAAA"}

package/lib/typescript/src/features/index.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Feature-based exports - each feature includes:
+ * - Event types
+ * - Getters (get*)
+ * - Setters (set*)
+ * - Event callbacks (on*)
+ * - React hooks (use*)
+ */
+export * from './output';
+export * from './playback';
+export * from './player';
+export * from './queue';
+export * from './battery';
+export * from './browser';
+export * from './equalizer';
+export * from './errors';
+export * from './favorites';
+export * from './metadata';
+export * from './network';
+export * from './nowPlaying';
+export * from './remoteControls';
+export * from './sleepTimer';
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/src/features/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/features/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,cAAc,UAAU,CAAA;AACxB,cAAc,YAAY,CAAA;AAC1B,cAAc,UAAU,CAAA;AACxB,cAAc,SAAS,CAAA;AACvB,cAAc,WAAW,CAAA;AACzB,cAAc,WAAW,CAAA;AACzB,cAAc,aAAa,CAAA;AAC3B,cAAc,UAAU,CAAA;AACxB,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA;AAC1B,cAAc,WAAW,CAAA;AACzB,cAAc,cAAc,CAAA;AAC5B,cAAc,kBAAkB,CAAA;AAChC,cAAc,cAAc,CAAA"}

package/lib/typescript/src/features/metadata.d.ts

@@ -0,0 +1,103 @@
+import { NativeUpdatedValue } from '../utils/NativeUpdatedValue';
+import type { Rating } from './rating';
+export type RatingType = 'heart' | 'thumbs-up-down' | 'three-stars' | 'four-stars' | 'five-stars' | 'percentage' | 'none';
+export interface TrackMetadataBase {
+    /** The track title */
+    title?: string;
+    /** The track album */
+    album?: string;
+    /** The track artist */
+    artist?: string;
+    /** The track duration in seconds */
+    duration?: number;
+    /** The track artwork */
+    artwork?: string;
+    /** track description */
+    description?: string;
+    /** track mediaId */
+    mediaId?: string;
+    /** The track genre */
+    genre?: string;
+    /** The track rating */
+    rating?: Rating;
+}
+export interface NowPlayingMetadata extends TrackMetadataBase {
+    elapsedTime?: number;
+}
+/**
+ * Metadata update for the now playing notification.
+ * Pass to `updateNowPlaying()` to override what's shown in the notification/lock screen.
+ * Pass `null` to clear overrides and revert to track metadata.
+ */
+export type NowPlayingUpdate = {
+    /** Title shown in notification */
+    title?: string;
+    /** Artist shown in notification */
+    artist?: string;
+};
+/**
+ * Timed metadata received during playback.
+ * Contains metadata from ICY streams (radio) or ID3 frames.
+ */
+export interface TimedMetadata {
+    title?: string;
+    artist?: string;
+    album?: string;
+    date?: string;
+    genre?: string;
+}
+/**
+ * Static track metadata from the media file.
+ * Contains standardized metadata fields.
+ */
+export interface TrackMetadata {
+    title?: string;
+    artist?: string;
+    albumTitle?: string;
+    subtitle?: string;
+    description?: string;
+    artworkUri?: string;
+    trackNumber?: string;
+    composer?: string;
+    conductor?: string;
+    genre?: string;
+    compilation?: string;
+    station?: string;
+    mediaType?: string;
+    creationDate?: string;
+    creationYear?: string;
+    url?: string;
+}
+/**
+ * Chapter metadata with time range.
+ * Used for podcast chapters, audiobook chapters, etc.
+ */
+export interface ChapterMetadata {
+    /** Chapter start time in seconds */
+    startTime: number;
+    /** Chapter end time in seconds */
+    endTime: number;
+    /** Chapter title */
+    title?: string;
+    /** URL associated with the chapter */
+    url?: string;
+}
+/**
+ * Subscribes to chapter metadata events.
+ * @param callback - Called when chapter metadata is received
+ * @returns Cleanup function to unsubscribe
+ */
+export declare const onChapterMetadata: NativeUpdatedValue<ChapterMetadata[]>;
+/**
+ * Subscribes to track metadata events.
+ * @param callback - Called when static track metadata is received
+ * @returns Cleanup function to unsubscribe
+ */
+export declare const onTrackMetadata: NativeUpdatedValue<TrackMetadata>;
+/**
+ * Subscribes to timed metadata events (ICY/ID3 from live streams).
+ * @param callback - Called when stream metadata is received (title, artist from ICY/ID3 tags)
+ * @returns Cleanup function to unsubscribe
+ */
+export declare const onTimedMetadata: NativeUpdatedValue<TimedMetadata>;
+//# sourceMappingURL=metadata.d.ts.map

package/lib/typescript/src/features/metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../../../../src/features/metadata.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAA;AAChE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AAItC,MAAM,MAAM,UAAU,GAClB,OAAO,GACP,gBAAgB,GAChB,aAAa,GACb,YAAY,GACZ,YAAY,GACZ,YAAY,GACZ,MAAM,CAAA;AAEV,MAAM,WAAW,iBAAiB;IAChC,sBAAsB;IACtB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,sBAAsB;IACtB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,uBAAuB;IACvB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,oCAAoC;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,wBAAwB;IACxB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,wBAAwB;IACxB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,oBAAoB;IACpB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,sBAAsB;IACtB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,uBAAuB;IACvB,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,kBAAmB,SAAQ,iBAAiB;IAC3D,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,kCAAkC;IAClC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,mCAAmC;IACnC,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB,CAAA;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,GAAG,CAAC,EAAE,MAAM,CAAA;CACb;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,oCAAoC;IACpC,SAAS,EAAE,MAAM,CAAA;IACjB,kCAAkC;IAClC,OAAO,EAAE,MAAM,CAAA;IACf,oBAAoB;IACpB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,sCAAsC;IACtC,GAAG,CAAC,EAAE,MAAM,CAAA;CACb;AAID;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,uCAEmB,CAAA;AAEjD;;;;GAIG;AACH,eAAO,MAAM,eAAe,mCAE3B,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,eAAe,mCAE3B,CAAA"}

package/lib/typescript/src/features/network.d.ts

@@ -0,0 +1,18 @@
+import { NativeUpdatedValue } from '../utils/NativeUpdatedValue';
+/**
+ * Gets the current network connectivity state.
+ * @returns true if the device is online, false otherwise
+ */
+export declare function getOnline(): boolean;
+/**
+ * Subscribes to network connectivity changes.
+ * @param callback - Called when network state changes
+ * @returns Cleanup function to unsubscribe
+ */
+export declare const onOnlineChanged: NativeUpdatedValue<boolean>;
+/**
+ * Hook that returns the current network connectivity state and updates when it changes.
+ * @returns true if the device is online, false otherwise
+ */
+export declare function useOnline(): boolean;
+//# sourceMappingURL=network.d.ts.map

package/lib/typescript/src/features/network.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"network.d.ts","sourceRoot":"","sources":["../../../../src/features/network.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAA;AAKhE;;;GAGG;AACH,wBAAgB,SAAS,IAAI,OAAO,CAEnC;AAID;;;;GAIG;AACH,eAAO,MAAM,eAAe,6BAE3B,CAAA;AAID;;;GAGG;AACH,wBAAgB,SAAS,IAAI,OAAO,CAEnC"}

package/lib/typescript/src/features/nowPlaying.d.ts

@@ -0,0 +1,36 @@
+import { NativeUpdatedValue } from '../utils/NativeUpdatedValue';
+import type { NowPlayingMetadata, NowPlayingUpdate } from './metadata';
+/**
+ * Updates the now playing notification metadata.
+ * Pass null/undefined to clear overrides and revert to track metadata.
+ *
+ * @example
+ * ```ts
+ * // Override notification with stream metadata
+ * updateNowPlaying({
+ *   title: streamMetadata.title,
+ *   artist: streamMetadata.artist,
+ * })
+ *
+ * // Clear overrides, revert to track metadata
+ * updateNowPlaying(null)
+ * ```
+ */
+export declare function updateNowPlaying(update: NowPlayingUpdate | null): void;
+/**
+ * Gets the current now playing metadata (override if set, else track metadata).
+ */
+export declare function getNowPlaying(): NowPlayingMetadata | undefined;
+/**
+ * Subscribes to now playing metadata change events.
+ * Fires when updateNowPlaying is called or when the track changes.
+ * @param callback - Called when now playing metadata changes
+ * @returns Cleanup function to unsubscribe
+ */
+export declare const onNowPlayingChanged: NativeUpdatedValue<NowPlayingMetadata>;
+/**
+ * Hook that returns the current now playing metadata and updates when it changes.
+ * @returns The current now playing metadata or undefined
+ */
+export declare function useNowPlaying(): NowPlayingMetadata | undefined;
+//# sourceMappingURL=nowPlaying.d.ts.map

package/lib/typescript/src/features/nowPlaying.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nowPlaying.d.ts","sourceRoot":"","sources":["../../../../src/features/nowPlaying.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAA;AAEhE,OAAO,KAAK,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAItE;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,GAAG,IAAI,CAEtE;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,kBAAkB,GAAG,SAAS,CAE9D;AAID;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,wCAG7B,CAAA;AAIH;;;GAGG;AACH,wBAAgB,aAAa,IAAI,kBAAkB,GAAG,SAAS,CAE9D"}

package/lib/typescript/src/features/output.d.ts

@@ -0,0 +1,28 @@
+import type { IosOutput, IosOutputType } from '../specs/audio-browser.nitro';
+import { NativeUpdatedValue } from '../utils/NativeUpdatedValue';
+export type { IosOutput, IosOutputType };
+/**
+ * Opens the system output picker (iOS only).
+ * Allows users to select output device (speaker, AirPlay, Bluetooth, etc.).
+ * No-op on Android.
+ */
+export declare function openIosOutputPicker(): void;
+/**
+ * Gets the current audio output info.
+ * Always returns a value on iOS, undefined on Android.
+ */
+export declare function getIosOutput(): IosOutput | undefined;
+/**
+ * Subscribes to output state changes (iOS only).
+ * Never fires on Android.
+ * @param callback - Called with output info when output changes
+ * @returns Cleanup function to unsubscribe
+ */
+export declare const onIosOutputChanged: NativeUpdatedValue<IosOutput>;
+/**
+ * Hook that returns the current audio output info.
+ * Updates when the output changes (e.g., AirPods connected/disconnected).
+ * Always returns a value on iOS, undefined on Android.
+ */
+export declare function useIosOutput(): IosOutput | undefined;
+//# sourceMappingURL=output.d.ts.map

package/lib/typescript/src/features/output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../../../src/features/output.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAA;AAC5E,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAA;AAGhE,YAAY,EAAE,SAAS,EAAE,aAAa,EAAE,CAAA;AAIxC;;;;GAIG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C;AAID;;;GAGG;AACH,wBAAgB,YAAY,IAAI,SAAS,GAAG,SAAS,CAEpD;AAID;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,+BAE9B,CAAA;AAID;;;;GAIG;AACH,wBAAgB,YAAY,IAAI,SAAS,GAAG,SAAS,CAEpD"}

package/lib/typescript/src/features/playback/controls.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Resets the player stopping the current track and clearing the queue.
+ */
+export declare function reset(): void;
+/**
+ * Plays or resumes the current track.
+ */
+export declare function play(): void;
+/**
+ * Pauses the current track.
+ */
+export declare function pause(): void;
+/**
+ * Toggles playback between play and pause.
+ */
+export declare function togglePlayback(): void;
+/**
+ * Stops playback and resets position to the beginning.
+ * The track remains loaded and can be resumed with play().
+ * For live streams, position is not reset.
+ */
+export declare function stop(): void;
+/**
+ * Retries playing the current item when the playback state is `'error'`.
+ *
+ * @see {@link PlaybackState}
+ * @see {@link usePlayback}
+ */
+export declare function retry(): void;
+/**
+ * Seeks to a specified time position in the current track.
+ * @param position - The position to seek to in seconds.
+ */
+export declare function seekTo(position: number): void;
+/**
+ * Seeks by a relative time offset in the current track.
+ * @param offset - The time offset to seek by in seconds.
+ */
+export declare function seekBy(offset: number): void;
+//# sourceMappingURL=controls.d.ts.map

package/lib/typescript/src/features/playback/controls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"controls.d.ts","sourceRoot":"","sources":["../../../../../src/features/playback/controls.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,wBAAgB,KAAK,IAAI,IAAI,CAE5B;AAED;;GAEG;AACH,wBAAgB,IAAI,IAAI,IAAI,CAE3B;AAED;;GAEG;AACH,wBAAgB,KAAK,IAAI,IAAI,CAE5B;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAErC;AAED;;;;GAIG;AACH,wBAAgB,IAAI,IAAI,IAAI,CAE3B;AAED;;;;;GAKG;AACH,wBAAgB,KAAK,IAAI,IAAI,CAE5B;AAED;;;GAGG;AACH,wBAAgB,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAE7C;AAED;;;GAGG;AACH,wBAAgB,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAE3C"}

package/lib/typescript/src/features/playback/index.d.ts

@@ -0,0 +1,8 @@
+export * from './controls';
+export * from './state';
+export * from './playing';
+export * from './playWhenReady';
+export * from './progress';
+export * from './rate';
+export * from './volume';
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/src/features/playback/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/features/playback/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,cAAc,SAAS,CAAA;AACvB,cAAc,WAAW,CAAA;AACzB,cAAc,iBAAiB,CAAA;AAC/B,cAAc,YAAY,CAAA;AAC1B,cAAc,QAAQ,CAAA;AACtB,cAAc,UAAU,CAAA"}

package/lib/typescript/src/features/playback/playWhenReady.d.ts

@@ -0,0 +1,30 @@
+import { NativeUpdatedValue } from '../../utils/NativeUpdatedValue';
+/**
+ * Event data for when playWhenReady changes.
+ */
+export interface PlaybackPlayWhenReadyChangedEvent {
+    /** Whether the player will play when ready */
+    playWhenReady: boolean;
+}
+/**
+ * Gets whether the player will play automatically when it is ready to do so.
+ */
+export declare function getPlayWhenReady(): boolean;
+/**
+ * Sets whether the player will play automatically when it is ready to do so.
+ * This is the equivalent of calling `play()` when `playWhenReady = true`
+ * or `pause()` when `playWhenReady = false`.
+ */
+export declare function setPlayWhenReady(playWhenReady: boolean): void;
+/**
+ * Subscribes to play when ready changes.
+ * @param callback - Called when playWhenReady changes
+ * @returns Cleanup function to unsubscribe
+ */
+export declare const onPlayWhenReadyChanged: NativeUpdatedValue<PlaybackPlayWhenReadyChangedEvent>;
+/**
+ * Hook that returns the current playWhenReady state and updates when it changes.
+ * @returns The current playWhenReady state
+ */
+export declare function usePlayWhenReady(): boolean;
+//# sourceMappingURL=playWhenReady.d.ts.map

package/lib/typescript/src/features/playback/playWhenReady.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"playWhenReady.d.ts","sourceRoot":"","sources":["../../../../../src/features/playback/playWhenReady.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAA;AAGnE;;GAEG;AACH,MAAM,WAAW,iCAAiC;IAChD,8CAA8C;IAC9C,aAAa,EAAE,OAAO,CAAA;CACvB;AAID;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,OAAO,CAE1C;AAID;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,aAAa,EAAE,OAAO,GAAG,IAAI,CAE7D;AAID;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,uDAGhC,CAAA;AAIH;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,OAAO,CAM1C"}

package/lib/typescript/src/features/playback/playing.d.ts

@@ -0,0 +1,21 @@
+import { NativeUpdatedValue } from '../../utils/NativeUpdatedValue';
+export type PlayingState = {
+    playing: boolean;
+    buffering: boolean;
+};
+/**
+ * Gets the playing state (playing and buffering flags).
+ */
+export declare function getPlayingState(): PlayingState;
+/**
+ * Subscribes to playing state changes.
+ * @param callback - Called when playing or buffering state changes
+ * @returns Cleanup function to unsubscribe
+ */
+export declare const onPlayingState: NativeUpdatedValue<PlayingState>;
+/**
+ * Hook that returns the current playing state and updates when it changes.
+ * @returns The current playing state (playing and buffering flags)
+ */
+export declare function usePlayingState(): PlayingState;
+//# sourceMappingURL=playing.d.ts.map

package/lib/typescript/src/features/playback/playing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"playing.d.ts","sourceRoot":"","sources":["../../../../../src/features/playback/playing.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAA;AAKnE,MAAM,MAAM,YAAY,GAAG;IACzB,OAAO,EAAE,OAAO,CAAA;IAChB,SAAS,EAAE,OAAO,CAAA;CACnB,CAAA;AAID;;GAEG;AACH,wBAAgB,eAAe,IAAI,YAAY,CAE9C;AAID;;;;GAIG;AACH,eAAO,MAAM,cAAc,kCAE1B,CAAA;AAID;;;GAGG;AACH,wBAAgB,eAAe,IAAI,YAAY,CAE9C"}

package/lib/typescript/src/features/playback/progress.d.ts

@@ -0,0 +1,51 @@
+import { NativeUpdatedValue } from '../../utils/NativeUpdatedValue';
+export interface Progress {
+    /**
+     * The playback position of the current track in seconds.
+     **/
+    position: number;
+    /**
+     * The duration of the current track in seconds.
+     **/
+    duration: number;
+    /**
+     * The buffered position of the current track in seconds.
+     **/
+    buffered: number;
+}
+/**
+ * Event data for playback progress updates.
+ */
+export interface PlaybackProgressUpdatedEvent extends Progress {
+    /** The current track index */
+    track: number;
+}
+/**
+ * Gets information on the progress of the currently active track, including its
+ * current playback position in seconds, buffered position in seconds and
+ * duration in seconds.
+ */
+export declare function getProgress(): Progress;
+/**
+ * Subscribes to playback progress updates.
+ * @param callback - Called periodically with playback progress updates
+ * @returns Cleanup function to unsubscribe
+ */
+export declare const onProgressUpdated: NativeUpdatedValue<PlaybackProgressUpdatedEvent>;
+/**
+ * Hook that returns the current playback progress and updates when it changes.
+ *
+ * Progress update frequency is controlled globally via `updateOptions({ progressUpdateEventInterval })`.
+ * @returns The current playback progress
+ */
+export declare function useProgress(): Progress;
+/**
+ * Hook that returns the current playback progress and updates via polling.
+ *
+ * Use this when you need custom polling behavior instead of event-based updates.
+ *
+ * @param updateInterval - Update interval in milliseconds (default: 1000)
+ * @returns The current playback progress
+ */
+export declare function usePolledProgress(updateInterval?: number): Progress;
+//# sourceMappingURL=progress.d.ts.map

package/lib/typescript/src/features/playback/progress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress.d.ts","sourceRoot":"","sources":["../../../../../src/features/playback/progress.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAA;AAMnE,MAAM,WAAW,QAAQ;IACvB;;QAEI;IACJ,QAAQ,EAAE,MAAM,CAAA;IAChB;;QAEI;IACJ,QAAQ,EAAE,MAAM,CAAA;IAChB;;QAEI;IACJ,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,4BAA6B,SAAQ,QAAQ;IAC5D,8BAA8B;IAC9B,KAAK,EAAE,MAAM,CAAA;CACd;AAID;;;;GAIG;AACH,wBAAgB,WAAW,IAAI,QAAQ,CAEtC;AAID;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,kDAG3B,CAAA;AAIH;;;;;GAKG;AACH,wBAAgB,WAAW,IAAI,QAAQ,CAEtC;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,cAAc,SAAO,GAAG,QAAQ,CA+CjE"}

package/lib/typescript/src/features/playback/rate.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Gets the playback rate where 0.5 would be half speed, 1 would be
+ * regular speed and 2 would be double speed etc.
+ */
+export declare function getRate(): number;
+/**
+ * Sets the playback rate.
+ * @param rate - The playback rate to change to, where 0.5 would be half speed,
+ * 1 would be regular speed, 2 would be double speed etc.
+ */
+export declare function setRate(rate: number): void;
+//# sourceMappingURL=rate.d.ts.map

package/lib/typescript/src/features/playback/rate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate.d.ts","sourceRoot":"","sources":["../../../../../src/features/playback/rate.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,wBAAgB,OAAO,IAAI,MAAM,CAEhC;AAID;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAE1C"}

package/lib/typescript/src/features/playback/state.d.ts

@@ -0,0 +1,43 @@
+import { NativeUpdatedValue } from '../../utils/NativeUpdatedValue';
+import type { PlaybackError } from '../errors';
+/**
+ * PlaybackState options:
+ * - `'none'`: Indicates that the player is idle (initial state, or no track
+ *   loaded)
+ * - `'ready'`: Indicates that the player has loaded a track and is ready to
+ *   play (but paused)
+ * - `'playing'`: Indicates that the player is currently playing
+ * - `'paused'`: Indicates that the player is currently paused
+ * - `'stopped'`: Indicates that the player is currently stopped
+ * - `'loading'`: Indicates that the initial load of the item is occurring.
+ * - `'buffering'`: Indicates that the player is currently loading more data
+ *   before it can continue playing or is ready to start playing.
+ * - `'error'`: Indicates that playback of the current item failed. Call
+ *   `AudioBrowser.getError()` to get more information on the type of error that
+ *   occurred. Call `AudioBrowser.retry()` or `AudioBrowser.play()` to try to play
+ *   the item again.
+ * - `'ended'`: Indicates that playback stopped due to the end of the queue
+ *   being reached.
+ */
+export type PlaybackState = 'none' | 'ready' | 'playing' | 'paused' | 'stopped' | 'loading' | 'buffering' | 'error' | 'ended';
+export type Playback = {
+    state: PlaybackState;
+    error?: PlaybackError;
+};
+/**
+ * Gets the playback state and error (if any) of the player.
+ * @see {@link PlaybackState} for possible state values
+ */
+export declare function getPlayback(): Playback;
+/**
+ * Subscribes to playback state changes.
+ * @param callback - Called when the playback state changes
+ * @returns Cleanup function to unsubscribe
+ */
+export declare const onPlaybackChanged: NativeUpdatedValue<Playback>;
+/**
+ * Hook that returns the current playback state and updates when it changes.
+ * @returns The current playback state
+ */
+export declare function usePlayback(): Playback;
+//# sourceMappingURL=state.d.ts.map

package/lib/typescript/src/features/playback/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../../../src/features/playback/state.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAA;AAEnE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AAI9C;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,MAAM,aAAa,GACrB,MAAM,GACN,OAAO,GACP,SAAS,GACT,QAAQ,GACR,SAAS,GACT,SAAS,GACT,WAAW,GACX,OAAO,GACP,OAAO,CAAA;AAEX,MAAM,MAAM,QAAQ,GAAG;IACrB,KAAK,EAAE,aAAa,CAAA;IACpB,KAAK,CAAC,EAAE,aAAa,CAAA;CACtB,CAAA;AAID;;;GAGG;AACH,wBAAgB,WAAW,IAAI,QAAQ,CAEtC;AAID;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,8BAE7B,CAAA;AAID;;;GAGG;AACH,wBAAgB,WAAW,IAAI,QAAQ,CAEtC"}

package/lib/typescript/src/features/playback/volume.d.ts

@@ -0,0 +1,32 @@
+import { NativeUpdatedValue } from '../../utils/NativeUpdatedValue';
+/**
+ * Gets the volume of the player as a number between 0 and 1.
+ */
+export declare function getVolume(): number;
+/**
+ * Gets the current system volume as a number between 0 and 1.
+ */
+export declare function getSystemVolume(): number;
+/**
+ * Sets the volume of the player.
+ * @param level - The volume as a number between 0 and 1.
+ */
+export declare function setVolume(level: number): void;
+/**
+ * Sets the system volume.
+ * @param level - The volume as a number between 0 and 1.
+ * @note On iOS this is a no-op as Apple doesn't provide a public API to set system volume.
+ */
+export declare function setSystemVolume(level: number): void;
+/**
+ * Subscribes to system volume changes.
+ * @param callback - Called when the system volume changes
+ * @returns Cleanup function to unsubscribe
+ */
+export declare const onSystemVolumeChanged: NativeUpdatedValue<number>;
+/**
+ * Hook that returns the current system volume and updates when it changes.
+ * @returns The current system volume (0 to 1)
+ */
+export declare function useSystemVolume(): number;
+//# sourceMappingURL=volume.d.ts.map

package/lib/typescript/src/features/playback/volume.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"volume.d.ts","sourceRoot":"","sources":["../../../../../src/features/playback/volume.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAA;AAGnE;;GAEG;AACH,wBAAgB,SAAS,IAAI,MAAM,CAElC;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAID;;;GAGG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAE7C;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAEnD;AAID;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,4BAEjC,CAAA;AAID;;;GAGG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAExC"}

package/lib/typescript/src/features/player/index.d.ts

@@ -0,0 +1,3 @@
+export * from './setup';
+export * from './options';
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/src/features/player/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/features/player/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAA;AACvB,cAAc,WAAW,CAAA"}