react-native-audio-browser 0.1.1 → 0.2.0-next.10

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

@@ -1,28 +1,38 @@
-import type { IosOutput, IosOutputType } from '../specs/audio-browser.nitro';
+import type { Output, OutputType } from '../specs/audio-browser.nitro';
 import { NativeUpdatedValue } from '../utils/NativeUpdatedValue';
-export type { IosOutput, IosOutputType };
+export type { Output, OutputType };
 /**
- * Opens the system output picker (iOS only).
- * Allows users to select output device (speaker, AirPlay, Bluetooth, etc.).
- * No-op on Android.
+ * 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.
  */
-export declare function openIosOutputPicker(): void;
+export declare function openOutputPicker(): void;
 /**
- * Gets the current audio output info.
- * Always returns a value on iOS, undefined on Android.
+ * 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.
  */
-export declare function getIosOutput(): IosOutput | undefined;
+export declare function supportsOutputSwitcher(): boolean;
 /**
- * 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
+ * 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`.
  */
-export declare const onIosOutputChanged: NativeUpdatedValue<IosOutput>;
+export declare function getOutput(): Output | undefined;
 /**
- * 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.
+ * 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
  */
-export declare function useIosOutput(): IosOutput | undefined;
+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;
 //# 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,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"}
+{"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"}

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

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

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

@@ -3,6 +3,7 @@ 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,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,qBAAqB,CAAA;AACnC,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 Cleanup function to unsubscribe
+ * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
  */
 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 Cleanup function to unsubscribe
+ * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
  */
 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 Cleanup function to unsubscribe
+ * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
  */
 export declare const onProgressUpdated: NativeUpdatedValue<PlaybackProgressUpdatedEvent>;
 /**
@@ -44,6 +44,9 @@ 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":"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"}
+{"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"}

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 Cleanup function to unsubscribe
+ * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
  */
 export declare const onPlaybackChanged: NativeUpdatedValue<Playback>;
 /**

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

@@ -0,0 +1,34 @@
+import type { Track } from '../../types/browser-nodes';
+export interface PlaybackElapsed {
+    /** Cumulative seconds spent `playing` since this subscription started. */
+    total: number;
+    /** Seconds played since the previous callback (≈ `period`). */
+    sinceLast: number;
+    /** The currently playing track (id / src / url / title …), if any. */
+    track?: Track;
+}
+/**
+ * Calls `callback` every `period` seconds of cumulative playback — time spent in
+ * the `playing` state. The clock advances only while playing and freezes on
+ * pause/buffering/stop, resuming where it left off; it is never reset (cancel and
+ * re-subscribe for a fresh `total`). Coarse, best-effort cadence (~1s resolution),
+ * not a precise timer.
+ *
+ * Typical use is a periodic "still listening" signal: fire an analytics ping, a
+ * listen-check, or a heartbeat every N seconds of *actual* listening, so paused
+ * time doesn't inflate the count.
+ *
+ * Note this counts cumulative play time across the whole session, NOT per track:
+ * `total` keeps climbing through track changes, and `track` only tells you what
+ * was playing at the moment each callback fired. To measure playtime per track,
+ * subscribe to {@link onActiveTrackChanged} and cancel + re-subscribe here on each
+ * change, so every track gets a fresh `total` starting at zero.
+ *
+ * @param callback Invoked once per elapsed `period`, with cumulative play time
+ *                 and the currently playing track.
+ * @param period  Seconds of playback between calls. Must be >= 1.
+ * @returns A function that cancels this subscription (idempotent — safe to call
+ *          more than once).
+ */
+export declare function trackPlaybackTime(callback: (elapsed: PlaybackElapsed) => void, period: number): () => void;
+//# sourceMappingURL=trackPlaybackTime.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"trackPlaybackTime.d.ts","sourceRoot":"","sources":["../../../../../src/features/playback/trackPlaybackTime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,2BAA2B,CAAA;AAMtD,MAAM,WAAW,eAAe;IAC9B,0EAA0E;IAC1E,KAAK,EAAE,MAAM,CAAA;IACb,+DAA+D;IAC/D,SAAS,EAAE,MAAM,CAAA;IACjB,sEAAsE;IACtE,KAAK,CAAC,EAAE,KAAK,CAAA;CACd;AA4CD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,CAAC,OAAO,EAAE,eAAe,KAAK,IAAI,EAC5C,MAAM,EAAE,MAAM,GACb,MAAM,IAAI,CAiBZ"}

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.
- * @note On iOS this is a no-op as Apple doesn't provide a public API to set system volume.
+ * @remarks 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
+ * @returns An emitter — subscribe with `addListener(callback)`, which returns a cleanup function
  */
 export declare const onSystemVolumeChanged: NativeUpdatedValue<number>;
 /**