react-native-audio-browser 0.2.0-next.8 → 0.2.0

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

@@ -1,63 +1,12 @@
 import type { FormattedNavigationError } from '../types/browser';
 import { NativeUpdatedValue } from '../utils/NativeUpdatedValue';
 export type { FormattedNavigationError } from '../types/browser';
-/**
- * Normalized, cross-platform classification of a playback failure.
- *
- * Both platforms map their native failure onto this set, so consumers can
- * branch on it without knowing whether the error came from AVFoundation or
- * ExoPlayer. Use this — not `code` — for anything user-visible.
- *
- * - `'offline'` - The device had no network connection at the moment of
- *   failure. The stream itself may be fine.
- * - `'unreachable'` - The stream host could not be reached: DNS failure,
- *   connection refused, timed out, or the connection dropped while loading.
- * - `'not-found'` - The server said this stream is gone (HTTP 404 / 410).
- *   Retrying will not help; the station is dead.
- * - `'rejected'` - The server refused the request (HTTP 401 / 403), e.g.
- *   geo-blocking or an expired token.
- * - `'server-error'` - The server responded with 5xx. Usually transient.
- * - `'unplayable'` - The stream was fetched but cannot be played: unknown
- *   container, unsupported codec, or a decoder failure.
- * - `'stalled'` - Playback had started and then stopped, and the player
- *   exhausted its recovery budget without recovering.
- * - `'unknown'` - The failure could not be classified. Inspect `code`.
- */
-export type PlaybackErrorKind = 'offline' | 'unreachable' | 'not-found' | 'rejected' | 'server-error' | 'unplayable' | 'stalled' | 'unknown';
 export type PlaybackError = {
-    /** Normalized classification. Branch on this, not on `code`. */
-    kind: PlaybackErrorKind;
-    /**
-     * The raw native failure identifier, for diagnostics and telemetry only.
-     * Platform-specific and unstable: loader cases on iOS
-     * (`failed-to-load`, `playback-failed`, …), lower-cased ExoPlayer error
-     * names on Android (`io-bad-http-status`, `parsing-container-malformed`, …).
-     */
     code: string;
     message: string;
-    /** HTTP status code, when the failure came from an HTTP response. */
-    statusCode?: number;
-    /**
-     * True while the player is still retrying this failure in the background.
-     *
-     * A retrying error arrives via `onPlaybackChanged` with the playback state
-     * still `loading`/`buffering` (or `paused`) — show it as advisory ("Stream
-     * unreachable" over a spinner), because playback may yet recover. It clears
-     * (the next `Playback` carries no error) once data flows again, and hardens
-     * into a terminal error (state `error`, `retrying` absent) when the retry
-     * budget runs out. Absent when retry is disabled: every error is then
-     * terminal. Native platforms only — the web implementation has no automatic
-     * retry, so its errors are always terminal.
-     */
-    retrying?: boolean;
 };
 /**
  * Emitted when a playback error occurs.
- *
- * Terminal errors only: this fires on both edges of the `error` state —
- * entering it (with the error) and leaving it (with `error` undefined).
- * Errors the player is still retrying (`retrying: true`) are surfaced through
- * `onPlaybackChanged` instead, attached to the `loading`/`buffering` state.
  */
 export interface PlaybackErrorEvent {
     error?: PlaybackError;
@@ -73,12 +22,8 @@ export interface PlaybackErrorEvent {
  * - `'callback-error'` - The browse callback returned an error (e.g., `{ error: 'message' }`).
  *   Use this for business logic errors like authentication failures or subscription requirements.
  * - `'unknown-error'` - An unexpected error occurred (e.g., invalid configuration).
- * - `'empty-content'` - The path resolved successfully but the container has no children (e.g. an
- *   empty Favorites tab, a search with no results).
- * - `'timeout'` - The resolve did not complete within the allotted time (a stalled request or
- *   unresponsive bridge). Surfaced on External surfaces that render their own browse list.
  */
-export type NavigationErrorType = 'content-not-found' | 'network-error' | 'http-error' | 'callback-error' | 'unknown-error' | 'empty-content' | 'timeout';
+export type NavigationErrorType = 'content-not-found' | 'network-error' | 'http-error' | 'callback-error' | 'unknown-error';
 export type NavigationError = {
     code: NavigationErrorType;
     message: string;
@@ -101,7 +46,7 @@ export declare function getPlaybackError(): PlaybackError | undefined;
 /**
  * Subscribes to playback error events.
  * @param callback - Called when a playback error occurs
- * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
+ * @returns Cleanup function to unsubscribe
  */
 export declare const onPlaybackError: NativeUpdatedValue<PlaybackErrorEvent>;
 /**
@@ -117,7 +62,7 @@ export declare function getNavigationError(): NavigationError | undefined;
 /**
  * Subscribes to navigation error events.
  * @param callback - Called when a navigation error occurs
- * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
+ * @returns Cleanup function to unsubscribe
  */
 export declare const onNavigationError: NativeUpdatedValue<NavigationErrorEvent>;
 /**
@@ -136,14 +81,14 @@ export declare function getFormattedNavigationError(): FormattedNavigationError
 /**
  * Subscribes to formatted navigation error changes.
  * @param callback - Called when the formatted navigation error changes
- * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
+ * @returns Cleanup function to unsubscribe
  */
 export declare const onFormattedNavigationError: NativeUpdatedValue<FormattedNavigationError | undefined>;
 /**
  * Hook that returns the current navigation error formatted for display.
  *
  * Native formats the error using the `formatNavigationError` callback configured
- * in `BrowserConfiguration`, or falls back to default English messages.
+ * in {@link BrowserConfiguration}, or falls back to default English messages.
  *
  * The same formatted error is used by CarPlay and Android Auto error dialogs,
  * ensuring consistent error presentation across your app and external controllers.
@@ -184,7 +129,7 @@ export declare const onFormattedNavigationError: NativeUpdatedValue<FormattedNav
  * })
  * ```
  *
- * @see `BrowserConfiguration.formatNavigationError` - Configure custom error formatting
+ * @see {@link BrowserConfiguration.formatNavigationError} - Configure custom error formatting
  * @see {@link useNavigationError} - Access the raw error with code and status details
  */
 export declare function useFormattedNavigationError(): FormattedNavigationError | undefined;

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

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../../src/features/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAA;AAEhE,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAA;AAIhE,YAAY,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAA;AAEhE;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,MAAM,iBAAiB,GACzB,SAAS,GACT,aAAa,GACb,WAAW,GACX,UAAU,GACV,cAAc,GACd,YAAY,GACZ,SAAS,GACT,SAAS,CAAA;AAEb,MAAM,MAAM,aAAa,GAAG;IAC1B,gEAAgE;IAChE,IAAI,EAAE,iBAAiB,CAAA;IACvB;;;;;OAKG;IACH,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,qEAAqE;IACrE,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB,CAAA;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,EAAE,aAAa,CAAA;CACtB;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,mBAAmB,GAC3B,mBAAmB,GACnB,eAAe,GACf,YAAY,GACZ,gBAAgB,GAChB,eAAe,GACf,eAAe,GACf,SAAS,CAAA;AAEb,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,mBAAmB,CAAA;IACzB,OAAO,EAAE,MAAM,CAAA;IACf,iDAAiD;IACjD,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,+FAA+F;IAC/F,iBAAiB,CAAC,EAAE,OAAO,CAAA;CAC5B,CAAA;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,KAAK,CAAC,EAAE,eAAe,CAAA;CACxB;AAID;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,aAAa,GAAG,SAAS,CAE5D;AAID;;;;GAIG;AACH,eAAO,MAAM,eAAe,wCAGzB,CAAA;AAIH;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,aAAa,GAAG,SAAS,CAE5D;AAID;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,eAAe,GAAG,SAAS,CAGhE;AAED;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,0CAG3B,CAAA;AAEH;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,eAAe,GAAG,SAAS,CAEhE;AAID;;;;;;GAMG;AACH,wBAAgB,2BAA2B,IACvC,wBAAwB,GACxB,SAAS,CAEZ;AAED;;;;GAIG;AACH,eAAO,MAAM,0BAA0B,0DAEmB,CAAA;AAE1D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AACH,wBAAgB,2BAA2B,IACvC,wBAAwB,GACxB,SAAS,CAKZ"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../../src/features/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAA;AAEhE,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAA;AAIhE,YAAY,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAA;AAEhE,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;CAChB,CAAA;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,EAAE,aAAa,CAAA;CACtB;AAED;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,mBAAmB,GAC3B,mBAAmB,GACnB,eAAe,GACf,YAAY,GACZ,gBAAgB,GAChB,eAAe,CAAA;AAEnB,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,mBAAmB,CAAA;IACzB,OAAO,EAAE,MAAM,CAAA;IACf,iDAAiD;IACjD,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,+FAA+F;IAC/F,iBAAiB,CAAC,EAAE,OAAO,CAAA;CAC5B,CAAA;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,KAAK,CAAC,EAAE,eAAe,CAAA;CACxB;AAID;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,aAAa,GAAG,SAAS,CAE5D;AAID;;;;GAIG;AACH,eAAO,MAAM,eAAe,wCAGzB,CAAA;AAIH;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,aAAa,GAAG,SAAS,CAE5D;AAID;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,eAAe,GAAG,SAAS,CAGhE;AAED;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,0CAG3B,CAAA;AAEH;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,eAAe,GAAG,SAAS,CAEhE;AAID;;;;;;GAMG;AACH,wBAAgB,2BAA2B,IACvC,wBAAwB,GACxB,SAAS,CAEZ;AAED;;;;GAIG;AACH,eAAO,MAAM,0BAA0B,0DAEmB,CAAA;AAE1D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AACH,wBAAgB,2BAA2B,IACvC,wBAAwB,GACxB,SAAS,CAKZ"}

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

@@ -66,7 +66,7 @@ export interface FavoriteChangedEvent {
  * 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 An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
+ * @returns Cleanup function to unsubscribe
  *
  * @example
  * ```ts

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

@@ -11,9 +11,7 @@ export * from './playback';
 export * from './player';
 export * from './queue';
 export * from './battery';
-export * from './gate';
 export * from './browser';
-export * from './carConnection';
 export * from './equalizer';
 export * from './errors';
 export * from './favorites';

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

@@ -1 +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,QAAQ,CAAA;AACtB,cAAc,WAAW,CAAA;AACzB,cAAc,iBAAiB,CAAA;AAC/B,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"}
+{"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

@@ -1,4 +1,6 @@
+import type { Rating } from './rating';
 import { NativeUpdatedValue } from '../utils/NativeUpdatedValue';
+export type RatingType = 'heart' | 'thumbs-up-down' | 'three-stars' | 'four-stars' | 'five-stars' | 'percentage' | 'none';
 export interface TrackMetadataBase {
     /** The track title */
     title?: string;
@@ -16,6 +18,8 @@ export interface TrackMetadataBase {
     mediaId?: string;
     /** The track genre */
     genre?: string;
+    /** The track rating */
+    rating?: Rating;
 }
 export interface NowPlayingMetadata extends TrackMetadataBase {
     elapsedTime?: number;
@@ -30,12 +34,6 @@ export type NowPlayingUpdate = {
     title?: string;
     /** Artist shown in notification */
     artist?: string;
-    /**
-     * Album line, on surfaces that render one (CarPlay's third line, some
-     * Bluetooth head units). Never shown on the iOS lock screen or the Android
-     * notification.
-     */
-    album?: string;
 };
 /**
  * Timed metadata received during playback.
@@ -87,19 +85,19 @@ export interface ChapterMetadata {
 /**
  * Subscribes to chapter metadata events.
  * @param callback - Called when chapter metadata is received
- * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
+ * @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 An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
+ * @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 An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
+ * @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

@@ -1 +1 @@
-{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../../../../src/features/metadata.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAA;AAIhE,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;CACf;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;IACf;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;CACf,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"}
+{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../../../../src/features/metadata.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AAEtC,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAA;AAIhE,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

@@ -7,7 +7,7 @@ export declare function getOnline(): boolean;
 /**
  * Subscribes to network connectivity changes.
  * @param callback - Called when network state changes
- * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
+ * @returns Cleanup function to unsubscribe
  */
 export declare const onOnlineChanged: NativeUpdatedValue<boolean>;
 /**

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

@@ -21,38 +21,11 @@ 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;
-/**
- * Temporarily replaces now-playing fields for `durationMs`, then reverts to
- * the live metadata. The flash outranks the now-playing formatter and the
- * `updateNowPlaying` override while active (live metadata can't stomp it),
- * and the revert runs on a native timer — JS timers pause in a backgrounded
- * host (the lock screen case) — so it fires reliably. A track change clears
- * the flash early; repeated calls restart the window.
- *
- * The feedback channel for refused remote commands: external surfaces have
- * no toast primitive, so a transient metadata swap is the only way to talk
- * to the user there.
- *
- * @example
- * ```ts
- * // A radio product with an hourly skip allowance:
- * handleRemoteNext(() => {
- *   if (skipsRemaining() > 0) skipToNext()
- *   else flashNowPlaying({ artist: 'Skip limit reached' }, 3000)
- * })
- * ```
- */
-export declare function flashNowPlaying(update: NowPlayingUpdate, durationMs: number): void;
-/**
- * Clears an active flash immediately, reverting to the live metadata.
- * No-op when no flash is active.
- */
-export declare function clearNowPlayingFlash(): void;
 /**
  * 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 An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
+ * @returns Cleanup function to unsubscribe
  */
 export declare const onNowPlayingChanged: NativeUpdatedValue<NowPlayingMetadata>;
 /**

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

@@ -1 +1 @@
-{"version":3,"file":"nowPlaying.d.ts","sourceRoot":"","sources":["../../../../src/features/nowPlaying.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAEtE,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAA;AAKhE;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,GAAG,IAAI,CAEtE;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,kBAAkB,GAAG,SAAS,CAE9D;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,gBAAgB,EACxB,UAAU,EAAE,MAAM,GACjB,IAAI,CAEN;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,IAAI,CAE3C;AAID;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,wCAG7B,CAAA;AAIH;;;GAGG;AACH,wBAAgB,aAAa,IAAI,kBAAkB,GAAG,SAAS,CAE9D"}
+{"version":3,"file":"nowPlaying.d.ts","sourceRoot":"","sources":["../../../../src/features/nowPlaying.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAEtE,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAA;AAKhE;;;;;;;;;;;;;;;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

@@ -1,38 +1,28 @@
-import type { Output, OutputType } from '../specs/audio-browser.nitro';
+import type { IosOutput, IosOutputType } from '../specs/audio-browser.nitro';
 import { NativeUpdatedValue } from '../utils/NativeUpdatedValue';
-export type { Output, OutputType };
+export type { IosOutput, IosOutputType };
 /**
- * Presents the system audio output switcher so the listener can move playback to
- * another output. Cross-platform:
- * - **iOS** — the system route picker (Bluetooth, AirPlay / Sonos-via-AirPlay,
- *   speaker). Always available.
- * - **Android** — the system Output Switcher (Bluetooth / speaker / Cast list) on
- *   Android 11+. No-op on older Android — gate on {@link supportsOutputSwitcher}.
- * - **Web** — no-op.
+ * Opens the system output picker (iOS only).
+ * Allows users to select output device (speaker, AirPlay, Bluetooth, etc.).
+ * No-op on Android.
  */
-export declare function openOutputPicker(): void;
+export declare function openIosOutputPicker(): void;
 /**
- * Whether {@link openOutputPicker} can present a switcher on this device — use it
- * to decide whether to surface the output control in your UI.
- * `true` on iOS and Android 11+ (API 30); `false` on older Android and web.
+ * Gets the current audio output info.
+ * Always returns a value on iOS, undefined on Android.
  */
-export declare function supportsOutputSwitcher(): boolean;
+export declare function getIosOutput(): IosOutput | undefined;
 /**
- * The current audio output, or `undefined` when unknown. iOS reports one while a
- * session is active; Android reports the active output route via AudioManager
- * (the `type` is coarse — e.g. wired headphones may report as `speaker`). Guard
- * for `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 function getOutput(): Output | undefined;
+export declare const onIosOutputChanged: NativeUpdatedValue<IosOutput>;
 /**
- * Subscribes to current-output changes (headphones unplugged, Bluetooth speaker
- * connected, AirPlay/route selected). Fires on iOS and Android 11+; never below.
- * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
+ * 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 const onOutputChanged: NativeUpdatedValue<Output>;
-/**
- * Reactive current audio output; re-renders when it changes (e.g. AirPods
- * connect, a Bluetooth speaker is selected). `undefined` when unknown.
- */
-export declare function useOutput(): Output | undefined;
+export declare function useIosOutput(): IosOutput | undefined;
 //# sourceMappingURL=output.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../../../src/features/output.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAA;AAEtE,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAA;AAGhE,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,CAAA;AAIlC;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAEvC;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,IAAI,OAAO,CAEhD;AAID;;;;;GAKG;AACH,wBAAgB,SAAS,IAAI,MAAM,GAAG,SAAS,CAE9C;AAID;;;;GAIG;AACH,eAAO,MAAM,eAAe,4BAE3B,CAAA;AAID;;;GAGG;AACH,wBAAgB,SAAS,IAAI,MAAM,GAAG,SAAS,CAE9C"}
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../../../src/features/output.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAA;AAE5E,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

@@ -32,11 +32,6 @@ export declare function retry(): void;
  * @param position - The position to seek to in seconds.
  */
 export declare function seekTo(position: number): void;
-/**
- * Jump to the live edge of the current track. No-op for non-live tracks; for
- * live, seeks to the window end (HLS) or reconnects (non-seekable streams).
- */
-export declare function seekToLiveEdge(): void;
 /**
  * Seeks by a relative time offset in the current track.
  * @param offset - The time offset to seek by in seconds.

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

@@ -1 +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,cAAc,IAAI,IAAI,CAErC;AAED;;;GAGG;AACH,wBAAgB,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAE3C"}
+{"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

@@ -3,7 +3,6 @@ export * from './state';
 export * from './playing';
 export * from './playWhenReady';
 export * from './progress';
-export * from './trackPlaybackTime';
 export * from './rate';
 export * from './volume';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +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,qBAAqB,CAAA;AACnC,cAAc,QAAQ,CAAA;AACtB,cAAc,UAAU,CAAA"}
+{"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

@@ -19,7 +19,7 @@ export declare function setPlayWhenReady(playWhenReady: boolean): void;
 /**
  * Subscribes to play when ready changes.
  * @param callback - Called when playWhenReady changes
- * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
+ * @returns Cleanup function to unsubscribe
  */
 export declare const onPlayWhenReadyChanged: NativeUpdatedValue<PlaybackPlayWhenReadyChangedEvent>;
 /**

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

@@ -10,7 +10,7 @@ export declare function getPlayingState(): PlayingState;
 /**
  * Subscribes to playing state changes.
  * @param callback - Called when playing or buffering state changes
- * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
+ * @returns Cleanup function to unsubscribe
  */
 export declare const onPlayingState: NativeUpdatedValue<PlayingState>;
 /**

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

@@ -29,7 +29,7 @@ export declare function getProgress(): Progress;
 /**
  * Subscribes to playback progress updates.
  * @param callback - Called periodically with playback progress updates
- * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
+ * @returns Cleanup function to unsubscribe
  */
 export declare const onProgressUpdated: NativeUpdatedValue<PlaybackProgressUpdatedEvent>;
 /**
@@ -44,9 +44,6 @@ export declare function useProgress(): Progress;
  *
  * Use this when you need custom polling behavior instead of event-based updates.
  *
- * Skips updates while the app is backgrounded and refreshes once it becomes
- * active again.
- *
  * @param updateInterval - Update interval in milliseconds (default: 1000)
  * @returns The current playback progress
  */

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

@@ -1 +1 @@
-{"version":3,"file":"progress.d.ts","sourceRoot":"","sources":["../../../../../src/features/playback/progress.ts"],"names":[],"mappings":"AAGA,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;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,cAAc,SAAO,GAAG,QAAQ,CA8DjE"}
+{"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/state.d.ts

@@ -32,7 +32,7 @@ export declare function getPlayback(): Playback;
 /**
  * Subscribes to playback state changes.
  * @param callback - Called when the playback state changes
- * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
+ * @returns Cleanup function to unsubscribe
  */
 export declare const onPlaybackChanged: NativeUpdatedValue<Playback>;
 /**

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

@@ -15,13 +15,13 @@ export declare function setVolume(level: number): void;
 /**
  * Sets the system volume.
  * @param level - The volume as a number between 0 and 1.
- * @remarks On iOS this is a no-op as Apple doesn't provide a public API to set system volume.
+ * @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 An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
+ * @returns Cleanup function to unsubscribe
  */
 export declare const onSystemVolumeChanged: NativeUpdatedValue<number>;
 /**