@rntp/player 5.0.0-beta.1 → 5.0.0-beta.3

package/lib/typescript/src/audio.d.ts

@@ -137,17 +137,59 @@ export declare function setShuffleEnabled(enabled: boolean): void;
 /** Update the HTTP headers used for progress sync POST requests. */
 export declare function updateProgressSyncHeaders(headers: Record<string, string>): void;
 /**
- * Set the media browse tree for Android Auto and other media browsers.
- * Each category becomes a top-level browsable folder; its items are playable leaves.
+ * Set the media browse tree for Android Auto and CarPlay.
+ * Each category becomes a top-level browsable folder (Android Auto) or tab (CarPlay);
+ * its items are playable leaves.
  *
- * When a user selects an item in Android Auto, the native player loads and plays it
+ * When a user selects an item, the native player loads and plays it
  * without JS intervention.
  *
  * @remarks
- * - On iOS this is a no-op (CarPlay uses MPPlayableContentManager, not MediaBrowserService)
+ * - On CarPlay, a maximum of 4 tabs are shown. If more than 4 categories are provided,
+ *   the first 3 become tabs and the rest are grouped under a "More" tab.
  * - Call again to update the tree (e.g. after loading new content)
  */
 export declare function setBrowseTree(categories: BrowseCategory[]): void;
+/**
+ * Sets a countdown sleep timer. Playback pauses after `seconds` of wall clock time.
+ * The timer keeps counting even if playback is paused.
+ *
+ * @param seconds Duration in seconds before playback pauses.
+ * @param options.fadeOutSeconds Gradually reduce volume over the last N seconds.
+ *   Clamped to `seconds` if it exceeds it. Defaults to 0 (no fade).
+ *
+ * @remarks Cancels any existing sleep timer (last one wins).
+ */
+export declare function sleepAfterTime(seconds: number, options?: {
+    fadeOutSeconds?: number;
+}): void;
+/**
+ * Pauses playback after the media item at `index` finishes playing.
+ *
+ * @param index Queue index of the target media item. Defaults to the active item.
+ *
+ * @remarks
+ * - Cancels any existing sleep timer (last one wins).
+ * - Index is absolute — queue mutations after setting may shift which item it points to.
+ * - No fade-out support (no known time horizon).
+ */
+export declare function sleepAfterMediaItemAtIndex(index?: number): void;
+/**
+ * Returns the current sleep timer state, or `null` if none is active.
+ */
+export declare function getSleepTimer(): {
+    type: 'time';
+    remainingSeconds: number;
+    fadeOutSeconds: number;
+} | {
+    type: 'mediaItem';
+    index: number;
+} | null;
+/**
+ * Cancels the active sleep timer. If a volume fade is in progress,
+ * restores the original volume immediately.
+ */
+export declare function cancelSleepTimer(): void;
 /**
  * Tears down the player and releases all resources.
  * After calling this, you must call `setupPlayer()` again to use the player.

package/lib/typescript/src/audio.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"audio.d.ts","sourceRoot":"","sources":["../../../src/audio.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"audio.d.ts","sourceRoot":"","sources":["../../../src/audio.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAML,KAAK,mBAAmB,EACzB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,mBAAmB,EACxB,KAAK,cAAc,EACnB,KAAK,SAAS,EACd,KAAK,QAAQ,EACb,KAAK,QAAQ,EACb,KAAK,UAAU,EAIhB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,KAAK,EACL,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACrB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,UAAU,CAAC;AAuD9C,MAAM,MAAM,sBAAsB,GAAG,CAAC,KAAK,EAAE,eAAe,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AA2B/E;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,OAAO,GAAE,YAAiB,GAAG,IAAI,CAS5D;AAED;;;;;;;GAOG;AACH,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,MAAM,sBAAsB,GACpC,IAAI,CAQN;AAID,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,KAAK,EAC9C,KAAK,EAAE,CAAC,EACR,QAAQ,EAAE,mBAAmB,CAAC,CAAC,CAAC,SAAS,KAAK,GAC1C,MAAM,IAAI,GACV,CAAC,KAAK,EAAE,mBAAmB,CAAC,CAAC,CAAC,KAAK,IAAI,GAC1C,mBAAmB,CAErB;AAID,sBAAsB;AACtB,wBAAgB,IAAI,IAAI,IAAI,CAE3B;AAED,sBAAsB;AACtB,wBAAgB,KAAK,IAAI,IAAI,CAE5B;AAED,4DAA4D;AAC5D,wBAAgB,IAAI,IAAI,IAAI,CAE3B;AAED,qCAAqC;AACrC,wBAAgB,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAE7C;AAED,gEAAgE;AAChE,wBAAgB,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAE3C;AAED,0CAA0C;AAC1C,wBAAgB,UAAU,IAAI,IAAI,CAEjC;AAED;;;GAGG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAErC;AAED,6CAA6C;AAC7C,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAE/C;AAED;;;;GAIG;AACH,wBAAgB,KAAK,IAAI,IAAI,CAE5B;AAED,6CAA6C;AAC7C,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAEpD;AAED,0CAA0C;AAC1C,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAE9C;AAID;;;GAGG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI,CAEvD;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,SAAS,EAAE,EAAE,UAAU,SAAI,GAAG,IAAI,CAE3E;AAED,mDAAmD;AACnD,wBAAgB,YAAY,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI,CAEvD;AAED,kDAAkD;AAClD,wBAAgB,aAAa,CAAC,UAAU,EAAE,SAAS,EAAE,GAAG,IAAI,CAE3D;AAED,8CAA8C;AAC9C,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,GAAG,IAAI,CAEzE;AAED,sDAAsD;AACtD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,GAAG,IAAI,CAE7E;AAED,gDAAgD;AAChD,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAEnD;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAEzE;AAED,4CAA4C;AAC5C,wBAAgB,KAAK,IAAI,IAAI,CAE5B;AAED,qFAAqF;AACrF,wBAAgB,UAAU,IAAI,IAAI,CAEjC;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,GAAG,IAAI,CAE1E;AAED,sDAAsD;AACtD,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAEtE;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE;IACR,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,QAAQ,CAAC;CACvB,GACA,IAAI,CAMN;AAID,uCAAuC;AACvC,wBAAgB,gBAAgB,IAAI,aAAa,CAEhD;AAED,8DAA8D;AAC9D,wBAAgB,SAAS,IAAI,OAAO,CAEnC;AAED,kFAAkF;AAClF,wBAAgB,WAAW,IAAI,QAAQ,CAQtC;AAED,uCAAuC;AACvC,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED,mDAAmD;AACnD,wBAAgB,SAAS,IAAI,MAAM,CAElC;AAED,6DAA6D;AAC7D,wBAAgB,kBAAkB,IAAI,SAAS,GAAG,IAAI,CAErD;AAED,0EAA0E;AAC1E,wBAAgB,uBAAuB,IAAI,MAAM,GAAG,IAAI,CAEvD;AAED,yCAAyC;AACzC,wBAAgB,QAAQ,IAAI,SAAS,EAAE,CAEtC;AAED,oCAAoC;AACpC,wBAAgB,aAAa,IAAI,UAAU,CAE1C;AAED,kCAAkC;AAClC,wBAAgB,gBAAgB,IAAI,OAAO,CAE1C;AAID;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,mBAAmB,GAAG,IAAI,CAE/D;AAED,2BAA2B;AAC3B,wBAAgB,aAAa,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,CAEpD;AAED,iCAAiC;AACjC,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAExD;AAID,oEAAoE;AACpE,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC9B,IAAI,CAEN;AAID;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,cAAc,EAAE,GAAG,IAAI,CAMhE;AAID;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;IAAE,cAAc,CAAC,EAAE,MAAM,CAAA;CAAE,GACpC,IAAI,CAEN;AAED;;;;;;;;;GASG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAG/D;AAED;;GAEG;AACH,wBAAgB,aAAa,IACzB;IACE,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;CACxB,GACD;IACE,IAAI,EAAE,WAAW,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACf,GACD,IAAI,CAIP;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAEvC;AAID;;;GAGG;AACH,wBAAgB,OAAO,IAAI,IAAI,CAG9B"}

package/lib/typescript/src/events/SleepTimerTriggered.d.ts

@@ -0,0 +1,5 @@
+export interface SleepTimerTriggeredEvent {
+    /** Which sleep timer mode triggered: countdown or media-item boundary. */
+    type: 'time' | 'mediaItem';
+}
+//# sourceMappingURL=SleepTimerTriggered.d.ts.map

package/lib/typescript/src/events/SleepTimerTriggered.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SleepTimerTriggered.d.ts","sourceRoot":"","sources":["../../../../src/events/SleepTimerTriggered.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,wBAAwB;IACvC,0EAA0E;IAC1E,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;CAC5B"}

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

@@ -10,6 +10,7 @@ import type { RemotePlayEvent, RemotePauseEvent, RemoteNextEvent, RemotePrevious
 import type { PlaybackErrorEvent } from './PlaybackError';
 import type { PlaybackProgressUpdatedEvent } from './PlaybackProgressUpdated';
 import type { QueueChangedEvent } from './QueueChanged';
+import type { SleepTimerTriggeredEvent } from './SleepTimerTriggered';
 export declare enum Event {
     PlaybackStateChanged = "event.playback-state-changed",
     IsPlayingChanged = "event.is-playing-changed",
@@ -25,7 +26,8 @@ export declare enum Event {
     RemoteStop = "event.remote-stop",
     RemoteSeek = "event.remote-seek",
     RemoteSkipForward = "event.remote-skip-forward",
-    RemoteSkipBackward = "event.remote-skip-backward"
+    RemoteSkipBackward = "event.remote-skip-backward",
+    SleepTimerTriggered = "event.sleep-timer-triggered"
 }
 export type EventPayloadByEvent = {
     [Event.PlaybackStateChanged]: PlaybackStateChangedEvent;
@@ -43,6 +45,7 @@ export type EventPayloadByEvent = {
     [Event.RemoteSeek]: RemoteSeekEvent;
     [Event.RemoteSkipForward]: RemoteSkipForwardEvent;
     [Event.RemoteSkipBackward]: RemoteSkipBackwardEvent;
+    [Event.SleepTimerTriggered]: SleepTimerTriggeredEvent;
 };
 type Simplify<T> = {
     [KeyType in keyof T]: T[KeyType];
@@ -64,4 +67,5 @@ export * from './RemoteControl';
 export * from './PlaybackError';
 export * from './PlaybackProgressUpdated';
 export * from './QueueChanged';
+export * from './SleepTimerTriggered';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/events/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/events/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rntp/player",
-  "version": "5.0.0-beta.1",
+  "version": "5.0.0-beta.3",
   "description": "The premium audio player for React Native",
   "source": "./src/index.tsx",
   "react-native": "./src/index.tsx",

package/src/NativeTrackPlayer.ts

@@ -76,6 +76,12 @@ export interface Spec extends TurboModule {
   // Progress Sync
   updateProgressSyncHeaders(headers: UnsafeObject): void;
 
+  // Sleep Timer
+  sleepAfterTime(seconds: number, fadeOutSeconds: number): void;
+  sleepAfterMediaItemAtIndex(index: number): void;
+  getSleepTimer(): UnsafeObject | null;
+  cancelSleepTimer(): void;
+
   // Destroy
   destroy(): void;
 

package/src/audio.ts

@@ -413,19 +413,19 @@ export function updateProgressSyncHeaders(
 // ─── Browse Tree ─────────────────────────────────────
 
 /**
- * Set the media browse tree for Android Auto and other media browsers.
- * Each category becomes a top-level browsable folder; its items are playable leaves.
+ * Set the media browse tree for Android Auto and CarPlay.
+ * Each category becomes a top-level browsable folder (Android Auto) or tab (CarPlay);
+ * its items are playable leaves.
  *
- * When a user selects an item in Android Auto, the native player loads and plays it
+ * When a user selects an item, the native player loads and plays it
  * without JS intervention.
  *
  * @remarks
- * - On iOS this is a no-op (CarPlay uses MPPlayableContentManager, not MediaBrowserService)
+ * - On CarPlay, a maximum of 4 tabs are shown. If more than 4 categories are provided,
+ *   the first 3 become tabs and the rest are grouped under a "More" tab.
  * - Call again to update the tree (e.g. after loading new content)
  */
 export function setBrowseTree(categories: BrowseCategory[]): void {
-  if (Platform.OS !== 'android') return;
-
   const resolved = categories.map((cat) => ({
     ...cat,
     items: cat.items.map(resolveMediaItem),
@@ -433,6 +433,67 @@ export function setBrowseTree(categories: BrowseCategory[]): void {
   TrackPlayer.setBrowseTree(resolved);
 }
 
+// ─── Sleep Timer ─────────────────────────────────────
+
+/**
+ * Sets a countdown sleep timer. Playback pauses after `seconds` of wall clock time.
+ * The timer keeps counting even if playback is paused.
+ *
+ * @param seconds Duration in seconds before playback pauses.
+ * @param options.fadeOutSeconds Gradually reduce volume over the last N seconds.
+ *   Clamped to `seconds` if it exceeds it. Defaults to 0 (no fade).
+ *
+ * @remarks Cancels any existing sleep timer (last one wins).
+ */
+export function sleepAfterTime(
+  seconds: number,
+  options?: { fadeOutSeconds?: number }
+): void {
+  TrackPlayer.sleepAfterTime(seconds, options?.fadeOutSeconds ?? 0);
+}
+
+/**
+ * Pauses playback after the media item at `index` finishes playing.
+ *
+ * @param index Queue index of the target media item. Defaults to the active item.
+ *
+ * @remarks
+ * - Cancels any existing sleep timer (last one wins).
+ * - Index is absolute — queue mutations after setting may shift which item it points to.
+ * - No fade-out support (no known time horizon).
+ */
+export function sleepAfterMediaItemAtIndex(index?: number): void {
+  const resolvedIndex = index ?? getActiveMediaItemIndex() ?? 0;
+  TrackPlayer.sleepAfterMediaItemAtIndex(resolvedIndex);
+}
+
+/**
+ * Returns the current sleep timer state, or `null` if none is active.
+ */
+export function getSleepTimer():
+  | {
+      type: 'time';
+      remainingSeconds: number;
+      fadeOutSeconds: number;
+    }
+  | {
+      type: 'mediaItem';
+      index: number;
+    }
+  | null {
+  const result = TrackPlayer.getSleepTimer();
+  if (result == null) return null;
+  return result as any;
+}
+
+/**
+ * Cancels the active sleep timer. If a volume fade is in progress,
+ * restores the original volume immediately.
+ */
+export function cancelSleepTimer(): void {
+  TrackPlayer.cancelSleepTimer();
+}
+
 // ─── Destroy ─────────────────────────────────────────
 
 /**

package/src/events/SleepTimerTriggered.ts

@@ -0,0 +1,4 @@
+export interface SleepTimerTriggeredEvent {
+  /** Which sleep timer mode triggered: countdown or media-item boundary. */
+  type: 'time' | 'mediaItem';
+}

package/src/events/index.ts

@@ -20,6 +20,7 @@ import type {
 import type { PlaybackErrorEvent } from './PlaybackError';
 import type { PlaybackProgressUpdatedEvent } from './PlaybackProgressUpdated';
 import type { QueueChangedEvent } from './QueueChanged';
+import type { SleepTimerTriggeredEvent } from './SleepTimerTriggered';
 
 export enum Event {
   PlaybackStateChanged = 'event.playback-state-changed',
@@ -37,6 +38,7 @@ export enum Event {
   RemoteSeek = 'event.remote-seek',
   RemoteSkipForward = 'event.remote-skip-forward',
   RemoteSkipBackward = 'event.remote-skip-backward',
+  SleepTimerTriggered = 'event.sleep-timer-triggered',
 }
 
 export type EventPayloadByEvent = {
@@ -55,6 +57,7 @@ export type EventPayloadByEvent = {
   [Event.RemoteSeek]: RemoteSeekEvent;
   [Event.RemoteSkipForward]: RemoteSkipForwardEvent;
   [Event.RemoteSkipBackward]: RemoteSkipBackwardEvent;
+  [Event.SleepTimerTriggered]: SleepTimerTriggeredEvent;
 };
 
 type Simplify<T> = { [KeyType in keyof T]: T[KeyType] } & {};
@@ -77,3 +80,4 @@ export * from './RemoteControl';
 export * from './PlaybackError';
 export * from './PlaybackProgressUpdated';
 export * from './QueueChanged';
+export * from './SleepTimerTriggered';