@rntp/player 5.0.0-beta.2 → 5.0.0-beta.4

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';

package/src/interfaces/BrowseTree.ts

@@ -3,17 +3,52 @@
  * Commercial use requires a license. See https://rntp.dev/pricing
  */
 
-import type { MediaItem } from './MediaItem';
+import type { MediaUrl } from './MediaItem';
 
 /**
- * A category in the media browse tree shown in Android Auto / media browsers.
- * Each category appears as a top-level tab/section; its items are playable leaves.
+ * An item in the browse tree — either a playable track or a browsable container.
+ *
+ * - `url` present → playable track (leaf node)
+ * - `children` present (no `url`) → browsable container (tapping drills down)
+ * - `url` takes precedence if both are present
+ *
+ * Maximum nesting depth: 4 levels (matching CarPlay's navigation stack limit).
+ */
+export interface BrowseItem {
+  /** Unique identifier for this item. */
+  mediaId: string;
+  /** Display title. */
+  title: string;
+  /** Artist or subtitle. */
+  artist?: string;
+  /** Artwork image URL. */
+  artworkUrl?: MediaUrl;
+
+  // Playable fields
+  /** Audio source URL. If present, this item is playable. */
+  url?: MediaUrl;
+  /** Duration hint in seconds. */
+  duration?: number;
+  /** Whether this is a live stream. */
+  isLive?: boolean;
+  /** MIME type hint for format detection. */
+  mimeType?: string;
+
+  // Browsable fields
+  /** Child items. If present (and no `url`), this item is browsable. */
+  children?: BrowseItem[];
+}
+
+/**
+ * A top-level category in the browse tree.
+ * On Android Auto, each category is a browsable folder.
+ * On CarPlay, each category is a tab (max 4; overflow creates a "More" tab).
  */
 export interface BrowseCategory {
   /** Unique identifier for this category. */
   mediaId: string;
   /** Display title for the category (e.g. "Albums", "Podcasts"). */
   title: string;
-  /** Playable media items within this category. */
-  items: MediaItem[];
+  /** Items within this category — can be playable tracks or browsable containers. */
+  items: BrowseItem[];
 }