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

package/lib/typescript/src/web/TrackPlayer/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/web/TrackPlayer/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAA;AACxB,cAAc,kBAAkB,CAAA;AAChC,cAAc,cAAc,CAAA;AAC5B,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAA"}

package/lib/typescript/src/web/browser/BrowserManager.d.ts

@@ -0,0 +1,154 @@
+import type { Track, ResolvedTrack } from '../../types';
+import type { NativeBrowserConfiguration } from '../../types/browser-native';
+import type { HttpClient } from '../http/HttpClient';
+import type { FavoriteManager } from './FavoriteManager';
+import type { NavigationErrorManager } from './NavigationErrorManager';
+/**
+ * Manages browser navigation, route resolution, and content loading.
+ * Coordinates between HTTP client, favorite manager, and error manager.
+ * Matches Android's BrowserManager architecture.
+ */
+export declare class BrowserManager {
+    private httpClient;
+    private favoriteManager;
+    private navigationErrorManager;
+    private _path;
+    private _tabs;
+    private _content;
+    private _configuration;
+    private router;
+    private currentNavigationId;
+    private _queueSourcePath;
+    onPathChanged: (path: string) => void;
+    onContentChanged: (content: ResolvedTrack | undefined) => void;
+    onTabsChanged: (tabs: Track[]) => void;
+    constructor(httpClient: HttpClient, favoriteManager: FavoriteManager, navigationErrorManager: NavigationErrorManager);
+    /**
+     * Handles navigation errors by extracting error details and setting the navigation error.
+     * Extracts code, message, and statusCode from typed errors, or falls back to generic network error.
+     */
+    private handleNavigationError;
+    /**
+     * Gets the current navigation path.
+     */
+    get path(): string | undefined;
+    /**
+     * Sets the navigation path and triggers navigation.
+     */
+    set path(value: string | undefined);
+    /**
+     * Gets the current tabs.
+     */
+    get tabs(): Track[] | undefined;
+    /**
+     * Gets the current content.
+     */
+    get content(): ResolvedTrack | undefined;
+    /**
+     * Gets the current browser configuration.
+     */
+    get configuration(): NativeBrowserConfiguration;
+    /**
+     * Gets the current queue source path.
+     * Used to track where the current playback queue came from.
+     */
+    get queueSourcePath(): string | undefined;
+    /**
+     * Sets the queue source path.
+     */
+    set queueSourcePath(value: string | undefined);
+    /**
+     * Sets the browser configuration and triggers initial navigation.
+     */
+    set configuration(value: NativeBrowserConfiguration);
+    /**
+     * Navigates to a specific path.
+     */
+    navigatePath(path: string): Promise<void>;
+    /**
+     * Navigates to a track's URL.
+     */
+    navigateTrack(track: Track): Promise<void>;
+    /**
+     * Notifies that content at a specific path has changed.
+     * If the path is currently displayed, triggers a refresh.
+     */
+    notifyContentChanged(path: string): void;
+    /**
+     * Main navigation logic.
+     * Resolves content for the given path and updates state.
+     * Uses navigation ID to prevent race conditions (matches Android's BrowserManager.kt:586-607).
+     */
+    private navigate;
+    /**
+     * Resolves search content from a search path.
+     * Returns a ResolvedTrack with raw children (no contextual URLs).
+     * Matches Android's BrowserManager.search() which bypasses resolve() entirely.
+     *
+     * @param searchPath The search path (format: /__search?q=query)
+     * @returns ResolvedTrack containing search results as children
+     */
+    private resolveSearchContent;
+    /**
+     * Transforms artwork URLs for content and its children.
+     * Supports both static config and resolve/transform callbacks.
+     * Matches Android's artwork URL transformation with full Track access.
+     */
+    private transformArtworkForContent;
+    /**
+     * Resolves content from a route using browseCallback, browseStatic, or browseConfig.
+     * Single source of truth for route resolution logic.
+     *
+     * @param route The route configuration to resolve
+     * @param path The path being navigated to
+     * @param routeParams Extracted route parameters
+     * @param errorContext Context string for error logging
+     * @returns ResolvedTrack or undefined if resolution fails
+     */
+    private resolveRouteContent;
+    /**
+     * Resolves content for a specific path using configured routes.
+     */
+    private resolveContent;
+    /**
+     * Queries tabs from the __tabs__ route.
+     */
+    private queryTabs;
+    /**
+     * Checks if the configuration has valid routes.
+     */
+    private hasValidConfiguration;
+    /**
+     * Expands a queue from a contextual URL.
+     * Resolves the parent container to get all siblings.
+     * Matches Android's BrowserManager.expandQueueFromContextualUrl() behavior.
+     *
+     * @param contextualUrl The contextual URL (format: /path?__trackId=trackSrc)
+     * @returns Object with tracks and selectedIndex, or undefined if expansion fails
+     */
+    expandQueueFromContextualUrl(contextualUrl: string): Promise<{
+        tracks: Track[];
+        selectedIndex: number;
+    } | undefined>;
+    /**
+     * Resolves media items for playback with queue expansion support.
+     * Handles search results, contextual URLs, and fallback to single track.
+     * Matches Android's BrowserManager.resolveMediaItemsForPlayback() behavior.
+     *
+     * @param tracks The tracks to resolve
+     * @param startIndex The starting index
+     * @param startPositionMs The starting position in milliseconds
+     * @param searchQuery Optional search query that generated these tracks
+     * @returns Object with expanded tracks and starting index
+     */
+    resolveMediaItemsForPlayback(tracks: Track[], startIndex: number, startPositionMs: number, searchQuery?: string): Promise<{
+        tracks: Track[];
+        startIndex: number;
+        startPositionMs: number;
+    }>;
+    /**
+     * Gets the default navigation path (first tab URL or '/').
+     */
+    private getDefaultPath;
+}
+//# sourceMappingURL=BrowserManager.d.ts.map

package/lib/typescript/src/web/browser/BrowserManager.d.ts.map

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

package/lib/typescript/src/web/browser/FavoriteManager.d.ts

@@ -0,0 +1,42 @@
+import type { Track, ResolvedTrack } from '../../types';
+/**
+ * Manages favorite state for tracks.
+ * Matches Android's favorite hydration behavior.
+ */
+export declare class FavoriteManager {
+    private favorites;
+    /**
+     * Sets the favorites cache from an array of track src values.
+     * This is typically called when favorites are loaded from storage.
+     */
+    setFavorites(favorites: string[]): void;
+    /**
+     * Checks if a track is favorited based on its src.
+     */
+    isFavorited(src: string): boolean;
+    /**
+     * Adds a track src to the favorites cache.
+     */
+    addFavorite(src: string): void;
+    /**
+     * Removes a track src from the favorites cache.
+     */
+    removeFavorite(src: string): void;
+    /**
+     * Hydrates the favorited property on a track based on the native favorites cache.
+     * Matches Android's hydrateFavorite behavior.
+     *
+     * @param track Track to hydrate
+     * @returns Track with favorited property set if found in cache
+     */
+    hydrateFavorite(track: Track): Track;
+    /**
+     * Hydrates favorites on all children of a ResolvedTrack.
+     * Matches Android's hydrateChildren behavior.
+     *
+     * @param resolvedTrack ResolvedTrack with children to hydrate
+     * @returns ResolvedTrack with favorited properties set on children
+     */
+    hydrateChildren(resolvedTrack: ResolvedTrack): ResolvedTrack;
+}
+//# sourceMappingURL=FavoriteManager.d.ts.map

package/lib/typescript/src/web/browser/FavoriteManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FavoriteManager.d.ts","sourceRoot":"","sources":["../../../../../src/web/browser/FavoriteManager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAEvD;;;GAGG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,SAAS,CAAoB;IAErC;;;OAGG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,IAAI;IAIvC;;OAEG;IACH,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIjC;;OAEG;IACH,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAI9B;;OAEG;IACH,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAIjC;;;;;;OAMG;IACH,eAAe,CAAC,KAAK,EAAE,KAAK,GAAG,KAAK;IAcpC;;;;;;OAMG;IACH,eAAe,CAAC,aAAa,EAAE,aAAa,GAAG,aAAa;CAY7D"}

package/lib/typescript/src/web/browser/NavigationErrorManager.d.ts

@@ -0,0 +1,40 @@
+import type { NavigationError, NavigationErrorType, FormattedNavigationError, NavigationErrorEvent } from '../../features';
+import type { NativeBrowserConfiguration } from '../../types/browser-native';
+/**
+ * Manages navigation error state and formatting.
+ * Handles both raw error objects and formatted user-facing error messages.
+ */
+export declare class NavigationErrorManager {
+    private _navigationError;
+    private _formattedNavigationError;
+    private formatCallback?;
+    onNavigationError: (data: NavigationErrorEvent) => void;
+    onFormattedNavigationError: (formattedError: FormattedNavigationError | undefined) => void;
+    /**
+     * Sets the custom error formatter callback from configuration.
+     */
+    setFormatCallback(callback: NativeBrowserConfiguration['formatNavigationError']): void;
+    /**
+     * Clears the current navigation error and emits clear events.
+     */
+    clearNavigationError(): void;
+    /**
+     * Sets a navigation error with the given code and message.
+     * Automatically formats the error using the configured formatter or default formatting.
+     *
+     * @param code Error type code
+     * @param message Error message
+     * @param path Optional path where the error occurred
+     * @param statusCode Optional HTTP status code for http-error types
+     */
+    setNavigationError(code: NavigationErrorType, message: string, path?: string, statusCode?: number): void;
+    /**
+     * Gets the current raw navigation error.
+     */
+    getNavigationError(): NavigationError | undefined;
+    /**
+     * Gets the current formatted navigation error.
+     */
+    getFormattedNavigationError(): FormattedNavigationError | undefined;
+}
+//# sourceMappingURL=NavigationErrorManager.d.ts.map

package/lib/typescript/src/web/browser/NavigationErrorManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NavigationErrorManager.d.ts","sourceRoot":"","sources":["../../../../../src/web/browser/NavigationErrorManager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,mBAAmB,EACnB,wBAAwB,EACxB,oBAAoB,EACrB,MAAM,gBAAgB,CAAA;AACvB,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAA;AAU5E;;;GAGG;AACH,qBAAa,sBAAsB;IACjC,OAAO,CAAC,gBAAgB,CAA6B;IACrD,OAAO,CAAC,yBAAyB,CAAsC;IACvE,OAAO,CAAC,cAAc,CAAC,CAAqD;IAG5E,iBAAiB,EAAE,CAAC,IAAI,EAAE,oBAAoB,KAAK,IAAI,CAAW;IAClE,0BAA0B,EAAE,CAC1B,cAAc,EAAE,wBAAwB,GAAG,SAAS,KACjD,IAAI,CAAW;IAEpB;;OAEG;IACH,iBAAiB,CACf,QAAQ,EAAE,0BAA0B,CAAC,uBAAuB,CAAC,GAC5D,IAAI;IAIP;;OAEG;IACH,oBAAoB,IAAI,IAAI;IAY5B;;;;;;;;OAQG;IACH,kBAAkB,CAChB,IAAI,EAAE,mBAAmB,EACzB,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,MAAM,EACb,UAAU,CAAC,EAAE,MAAM,GAClB,IAAI;IAoCP;;OAEG;IACH,kBAAkB,IAAI,eAAe,GAAG,SAAS;IAIjD;;OAEG;IACH,2BAA2B,IAAI,wBAAwB,GAAG,SAAS;CAGpE"}

package/lib/typescript/src/web/browser/SearchManager.d.ts

@@ -0,0 +1,22 @@
+import type { Track, SearchParams } from '../../types';
+import type { HttpClient } from '../http/HttpClient';
+import type { BrowserManager } from './BrowserManager';
+/**
+ * Manages search functionality.
+ * Resolves search queries using configured __search__ route.
+ * Matches Android's search architecture.
+ */
+export declare class SearchManager {
+    private browserManager;
+    private httpClient;
+    constructor(browserManager: BrowserManager, httpClient: HttpClient);
+    /**
+     * Executes a search query using the __search__ route configuration.
+     * Matches Android's BrowserManager.search(params: SearchParams) behavior.
+     *
+     * @param params Search parameters (query is required, other fields optional)
+     * @returns Array of matching tracks
+     */
+    search(params: SearchParams): Promise<Track[]>;
+}
+//# sourceMappingURL=SearchManager.d.ts.map

package/lib/typescript/src/web/browser/SearchManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SearchManager.d.ts","sourceRoot":"","sources":["../../../../../src/web/browser/SearchManager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AACtD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AACpD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAGtD;;;;GAIG;AACH,qBAAa,aAAa;IAEtB,OAAO,CAAC,cAAc;IACtB,OAAO,CAAC,UAAU;gBADV,cAAc,EAAE,cAAc,EAC9B,UAAU,EAAE,UAAU;IAGhC;;;;;;OAMG;IACG,MAAM,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;CAgErD"}

package/lib/typescript/src/web/http/HttpClient.d.ts

@@ -0,0 +1,25 @@
+import type { RequestConfig, TransformableRequestConfig } from '../../types';
+/**
+ * HTTP client for making browser API requests.
+ * Mirrors Android's HttpClient.kt
+ * Uses RequestConfigBuilder for URL building and config merging.
+ */
+export declare class HttpClient {
+    private baseRequestConfig;
+    constructor(baseRequestConfig?: Partial<TransformableRequestConfig>);
+    /**
+     * Updates the base request configuration used for all requests.
+     */
+    setBaseRequestConfig(config: Partial<TransformableRequestConfig>): void;
+    /**
+     * Merges multiple request configs with proper header and query parameter merging.
+     * Uses RequestConfigBuilder for consistent merging behavior.
+     */
+    mergeRequestConfig(base: Partial<TransformableRequestConfig>, overrides: Partial<RequestConfig>): RequestConfig;
+    /**
+     * Executes an HTTP request and returns the JSON response.
+     * Throws navigation errors for HTTP and network failures.
+     */
+    executeRequest(config: RequestConfig): Promise<unknown>;
+}
+//# sourceMappingURL=HttpClient.d.ts.map

package/lib/typescript/src/web/http/HttpClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HttpClient.d.ts","sourceRoot":"","sources":["../../../../../src/web/http/HttpClient.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAA;AAqB5E;;;;GAIG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,iBAAiB,CAAqC;gBAElD,iBAAiB,GAAE,OAAO,CAAC,0BAA0B,CAAM;IAIvE;;OAEG;IACH,oBAAoB,CAAC,MAAM,EAAE,OAAO,CAAC,0BAA0B,CAAC,GAAG,IAAI;IAIvE;;;OAGG;IACH,kBAAkB,CAChB,IAAI,EAAE,OAAO,CAAC,0BAA0B,CAAC,EACzC,SAAS,EAAE,OAAO,CAAC,aAAa,CAAC,GAChC,aAAa;IAahB;;;OAGG;IACG,cAAc,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC;CA2D9D"}

package/lib/typescript/src/web/http/RequestConfigBuilder.d.ts

@@ -0,0 +1,98 @@
+import type { RequestConfig, TransformableRequestConfig, MediaRequestConfig, ArtworkRequestConfig, ImageSource, Track, ImageContext } from '../../types';
+/**
+ * Builds and merges request configurations.
+ * Mirrors Android's RequestConfigBuilder.kt
+ */
+export declare const RequestConfigBuilder: {
+    /**
+     * Builds a complete URL from a request config.
+     * Uses BrowserPathHelper for consistent URL building.
+     */
+    readonly buildUrl: (config: RequestConfig) => string;
+    /**
+     * Merges two RequestConfigs, with override values taking precedence.
+     * Headers and query params are merged (not replaced).
+     */
+    readonly mergeConfig: (base: RequestConfig, override: RequestConfig) => RequestConfig;
+    /**
+     * Merges a base RequestConfig with a MediaRequestConfig.
+     * Returns the merged config for use in media URL resolution.
+     * Supports the transform callback like Android's RequestConfigBuilder.
+     *
+     * Note: MediaRequestConfig inherits transform from TransformableRequestConfig,
+     * which takes (request, routeParams?) directly, not MediaTransformParams.
+     */
+    readonly mergeMediaConfig: (base: RequestConfig, override: MediaRequestConfig) => Promise<RequestConfig>;
+    /**
+     * Merges a base RequestConfig with an ArtworkRequestConfig.
+     * Returns the merged config for use in artwork URL resolution.
+     */
+    readonly mergeArtworkConfig: (base: RequestConfig, override: ArtworkRequestConfig) => RequestConfig;
+    /**
+     * Converts a TransformableRequestConfig to a plain RequestConfig.
+     */
+    readonly toRequestConfig: (config: TransformableRequestConfig | MediaRequestConfig | ArtworkRequestConfig) => RequestConfig;
+    /**
+     * Resolves a media URL using the media configuration.
+     * Creates a RequestConfig with the track's src as the path, then builds the URL.
+     * Supports the transform callback for URL manipulation.
+     *
+     * @param src The track's src value (may be relative or absolute)
+     * @param mediaConfig The media request configuration
+     * @returns The resolved absolute URL
+     */
+    readonly resolveMediaUrl: (src: string, mediaConfig: MediaRequestConfig | undefined) => Promise<string>;
+    /**
+     * Resolves an artwork URL and creates an ImageSource.
+     * Matches Android's artwork URL transformation behavior.
+     *
+     * @param artworkUrl The artwork URL (may be relative or absolute)
+     * @param artworkConfig The artwork request configuration
+     * @returns ImageSource with resolved URI, or undefined if no artwork
+     */
+    readonly resolveArtworkSource: (artworkUrl: string | undefined, artworkConfig: ArtworkRequestConfig | undefined) => ImageSource | undefined;
+    /**
+     * Resolves an artwork URL asynchronously with full Track access.
+     * Supports resolve and transform callbacks from ArtworkRequestConfig.
+     * Matches Android's CoilBitmapLoader.transformArtworkUrlForTrack() behavior.
+     *
+     * The resolution order is:
+     * 1. If resolve callback exists, call it with the track to get per-track config
+     * 2. Merge base config + resolved config
+     * 3. Apply imageQueryParams if context has dimensions
+     * 4. Apply transform callback if present
+     *
+     * @param track The track to resolve artwork for (full Track object)
+     * @param artworkConfig The artwork request configuration
+     * @param imageContext Optional image context with size hints (width/height)
+     * @returns ImageSource with resolved URI, or undefined if no artwork
+     */
+    readonly resolveArtworkSourceAsync: (track: Track, artworkConfig: ArtworkRequestConfig | undefined, imageContext?: ImageContext) => Promise<ImageSource | undefined>;
+    /**
+     * Transforms a track's artwork URL and populates artworkSource.
+     * Leaves the original artwork property unchanged.
+     * Matches Android's transformArtworkUrl behavior.
+     *
+     * @param track The track to transform
+     * @param artworkConfig The artwork request configuration
+     * @returns Track with artworkSource populated
+     */
+    readonly transformTrackArtwork: (track: Track, artworkConfig: ArtworkRequestConfig | undefined) => Track;
+    /**
+     * Transforms artwork URLs for an array of tracks.
+     *
+     * @param tracks Array of tracks to transform
+     * @param artworkConfig The artwork request configuration
+     * @returns Tracks with artworkSource populated
+     */
+    readonly transformTracksArtwork: (tracks: Track[], artworkConfig: ArtworkRequestConfig | undefined) => Track[];
+    /**
+     * Merges header maps, with override values taking precedence.
+     */
+    readonly mergeHeaders: (base: Record<string, string> | undefined, override: Record<string, string> | undefined) => Record<string, string> | undefined;
+    /**
+     * Merges query parameter maps, with override values taking precedence.
+     */
+    readonly mergeQuery: (base: Record<string, string> | undefined, override: Record<string, string> | undefined) => Record<string, string> | undefined;
+};
+//# sourceMappingURL=RequestConfigBuilder.d.ts.map

package/lib/typescript/src/web/http/RequestConfigBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RequestConfigBuilder.d.ts","sourceRoot":"","sources":["../../../../../src/web/http/RequestConfigBuilder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,0BAA0B,EAC1B,kBAAkB,EAClB,oBAAoB,EACpB,WAAW,EACX,KAAK,EACL,YAAY,EAEb,MAAM,aAAa,CAAA;AAgDpB;;;GAGG;AACH,eAAO,MAAM,oBAAoB;IAC/B;;;OAGG;gCACc,aAAa,KAAG,MAAM;IAWvC;;;OAGG;iCACe,aAAa,YAAY,aAAa,KAAG,aAAa;IAaxE;;;;;;;OAOG;sCAEK,aAAa,YACT,kBAAkB,KAC3B,OAAO,CAAC,aAAa,CAAC;IAoBzB;;;OAGG;wCAEK,aAAa,YACT,oBAAoB,KAC7B,aAAa;IAKhB;;OAEG;uCAGG,0BAA0B,GAC1B,kBAAkB,GAClB,oBAAoB,KACvB,aAAa;IAahB;;;;;;;;OAQG;oCAEI,MAAM,eACE,kBAAkB,GAAG,SAAS,KAC1C,OAAO,CAAC,MAAM,CAAC;IASlB;;;;;;;OAOG;gDAEW,MAAM,GAAG,SAAS,iBACf,oBAAoB,GAAG,SAAS,KAC9C,WAAW,GAAG,SAAS;IAmB1B;;;;;;;;;;;;;;;OAeG;gDAEM,KAAK,iBACG,oBAAoB,GAAG,SAAS,iBAChC,YAAY,KAC1B,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC;IAkEnC;;;;;;;;OAQG;4CAEM,KAAK,iBACG,oBAAoB,GAAG,SAAS,KAC9C,KAAK;IAgBR;;;;;;OAMG;8CAEO,KAAK,EAAE,iBACA,oBAAoB,GAAG,SAAS,KAC9C,KAAK,EAAE;IAMV;;OAEG;kCAEK,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,YAC9B,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,KAC3C,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS;IAMrC;;OAEG;gCAEK,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,YAC9B,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,KAC3C,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS;CAK7B,CAAA"}

package/lib/typescript/src/web/player/NowPlayingManager.d.ts

@@ -0,0 +1,34 @@
+import type { NowPlayingUpdate, NowPlayingMetadata } from '../../features';
+import type { Track } from '../../types';
+/**
+ * Manages now playing metadata overrides.
+ * Allows temporary metadata changes for the currently playing track
+ * (e.g., updating stream metadata for live radio).
+ */
+export declare class NowPlayingManager {
+    private override;
+    onNowPlayingChanged: (metadata: NowPlayingMetadata) => void;
+    /**
+     * Updates the now playing metadata with an override.
+     * Pass null or undefined to clear overrides and revert to track metadata.
+     *
+     * @param update Metadata override or null/undefined to clear
+     * @param currentTrack Current track for base metadata
+     * @param duration Current track duration
+     */
+    updateNowPlaying(update: NowPlayingUpdate | undefined, currentTrack: Track | undefined, duration: number): void;
+    /**
+     * Gets the current now playing metadata (with override applied if set).
+     *
+     * @param currentTrack Current track for base metadata
+     * @param duration Current track duration
+     * @returns Now playing metadata or undefined if no track
+     */
+    getNowPlaying(currentTrack: Track | undefined, duration: number): NowPlayingMetadata | undefined;
+    /**
+     * Clears the current metadata override.
+     * Should be called when the track changes.
+     */
+    clearNowPlayingOverride(): void;
+}
+//# sourceMappingURL=NowPlayingManager.d.ts.map

package/lib/typescript/src/web/player/NowPlayingManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NowPlayingManager.d.ts","sourceRoot":"","sources":["../../../../../src/web/player/NowPlayingManager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAA;AAC1E,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AAExC;;;;GAIG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAA8B;IAG9C,mBAAmB,EAAE,CAAC,QAAQ,EAAE,kBAAkB,KAAK,IAAI,CAAW;IAEtE;;;;;;;OAOG;IACH,gBAAgB,CACd,MAAM,EAAE,gBAAgB,GAAG,SAAS,EACpC,YAAY,EAAE,KAAK,GAAG,SAAS,EAC/B,QAAQ,EAAE,MAAM,GACf,IAAI;IA8BP;;;;;;OAMG;IACH,aAAa,CACX,YAAY,EAAE,KAAK,GAAG,SAAS,EAC/B,QAAQ,EAAE,MAAM,GACf,kBAAkB,GAAG,SAAS;IAejC;;;OAGG;IACH,uBAAuB,IAAI,IAAI;CAGhC"}

package/lib/typescript/src/web/player/OptionsManager.d.ts

@@ -0,0 +1,32 @@
+import type { NativeUpdateOptions, UpdateOptions, Options, RepeatMode as RepeatModeType } from '../../features';
+/**
+ * Manages player options and configuration.
+ * Handles option updates and change detection.
+ */
+export declare class OptionsManager {
+    private options;
+    onOptionsChanged: (options: Options) => void;
+    /**
+     * Updates player options with change detection.
+     * Emits onOptionsChanged event after updating.
+     *
+     * @param options Partial options to update
+     */
+    updateOptions(options: NativeUpdateOptions): void;
+    /**
+     * Gets current player options (excluding repeatMode).
+     */
+    getOptions(): UpdateOptions;
+    /**
+     * Gets the current repeat mode.
+     */
+    getRepeatMode(): RepeatModeType;
+    /**
+     * Sets the repeat mode.
+     * Updates internal state but does not emit events - caller should handle that.
+     *
+     * @param mode New repeat mode
+     */
+    setRepeatMode(mode: RepeatModeType): void;
+}
+//# sourceMappingURL=OptionsManager.d.ts.map

package/lib/typescript/src/web/player/OptionsManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OptionsManager.d.ts","sourceRoot":"","sources":["../../../../../src/web/player/OptionsManager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EACnB,aAAa,EACb,OAAO,EACP,UAAU,IAAI,cAAc,EAC7B,MAAM,gBAAgB,CAAA;AAOvB;;;GAGG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAMd;IAGD,gBAAgB,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAW;IAEvD;;;;;OAKG;IACH,aAAa,CAAC,OAAO,EAAE,mBAAmB,GAAG,IAAI;IAuCjD;;OAEG;IACH,UAAU,IAAI,aAAa;IAS3B;;OAEG;IACH,aAAa,IAAI,cAAc;IAI/B;;;;;OAKG;IACH,aAAa,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI;CAG1C"}

package/lib/typescript/src/web/util/BrowserPathHelper.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Utility for handling browser paths and contextual URLs in the media browser system.
+ * Mirrors Android's BrowserPathHelper.kt
+ *
+ * Handles two types of special paths:
+ * 1. System paths (prefixed with `/__`): Root, recent, and search paths
+ * 2. Contextual URLs: Embed parent context in track identifiers for Media3 integration
+ *
+ * Contextual URL format: `{parentPath}?__trackId={trackSrc}`
+ * Example: "/library/radio?__trackId=song.mp3"
+ *
+ * This allows:
+ * - Media3 to reference playable-only tracks (tracks with `src` but no `url`)
+ * - Cache lookup to work consistently
+ * - Parent context to be preserved for queue restoration
+ */
+export declare const BrowserPathHelper: {
+    /** Search path prefix (full path is /__search?q=query) */
+    readonly SEARCH_PATH_PREFIX: "/__search";
+    /** Query parameter name for contextual track identifiers */
+    readonly CONTEXTUAL_TRACK_PARAM: "__trackId";
+    /**
+     * Create a search path for a given query
+     */
+    readonly createSearchPath: (query: string) => string;
+    /**
+     * Checks if a path contains a contextual track identifier.
+     *
+     * @param path The URL path to check
+     * @returns true if the path contains the contextual track parameter
+     */
+    readonly isContextual: (path: string) => boolean;
+    /**
+     * Strips the __trackId parameter from a contextual URL to get the parent path.
+     * If the URL is not contextual, returns it unchanged.
+     *
+     * @param url The URL to process
+     * @returns The URL without the __trackId parameter
+     *
+     * Example: "/library/radio?__trackId=song.mp3" → "/library/radio"
+     * Example: "/search?q=jazz&__trackId=song.mp3" → "/search?q=jazz"
+     */
+    readonly stripTrackId: (url: string) => string;
+    /**
+     * Extracts the track ID from a contextual URL.
+     * Returns undefined if the URL is not contextual or doesn't contain the track ID parameter.
+     *
+     * @param path The contextual URL to parse
+     * @returns The extracted track ID, or undefined if not found
+     *
+     * Example: "/library/radio?__trackId=song.mp3" → "song.mp3"
+     */
+    readonly extractTrackId: (path: string) => string | undefined;
+    /**
+     * Combines a base URL with a path, ensuring proper slash handling.
+     *
+     * @param baseUrl The base URL (can be undefined)
+     * @param path The path to append
+     * @returns The combined URL with proper slash handling
+     *
+     * Examples:
+     * - buildUrl("http://example.com", "api/test") → "http://example.com/api/test"
+     * - buildUrl("http://example.com/", "/api/test") → "http://example.com/api/test"
+     * - buildUrl(undefined, "/api/test") → "/api/test"
+     * - buildUrl(undefined, "http://full.url") → "http://full.url"
+     */
+    readonly buildUrl: (baseUrl: string | undefined, path: string) => string;
+};
+//# sourceMappingURL=BrowserPathHelper.d.ts.map

package/lib/typescript/src/web/util/BrowserPathHelper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BrowserPathHelper.d.ts","sourceRoot":"","sources":["../../../../../src/web/util/BrowserPathHelper.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,iBAAiB;IAC5B,0DAA0D;;IAG1D,4DAA4D;;IAG5D;;OAEG;uCACqB,MAAM,KAAG,MAAM;IAKvC;;;;;OAKG;kCACgB,MAAM,KAAG,OAAO;IAOnC;;;;;;;;;OASG;iCACe,MAAM,KAAG,MAAM;IAmCjC;;;;;;;;OAQG;oCACkB,MAAM,KAAG,MAAM,GAAG,SAAS;IAoBhD;;;;;;;;;;;;OAYG;iCACe,MAAM,GAAG,SAAS,QAAQ,MAAM,KAAG,MAAM;CAgBnD,CAAA"}

package/lib/typescript/src/web/util/shuffle.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Shuffles an array in place using the Fisher-Yates algorithm.
+ * https://en.wikipedia.org/wiki/Fisher%E2%80%93Yates_shuffle
+ *
+ * @param array The array to shuffle (mutated in place)
+ */
+export declare function fisherYatesShuffle<T>(array: T[]): void;
+//# sourceMappingURL=shuffle.d.ts.map

package/lib/typescript/src/web/util/shuffle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shuffle.d.ts","sourceRoot":"","sources":["../../../../../src/web/util/shuffle.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,IAAI,CAOtD"}

package/nitrogen/generated/android/AudioBrowser+autolinking.cmake

@@ -36,13 +36,11 @@ target_sources(
   ../nitrogen/generated/shared/c++/HybridAudioBrowserSpec.cpp
   # Android-specific Nitrogen C++ sources
   ../nitrogen/generated/android/c++/JHybridAudioBrowserSpec.cpp
-  ../nitrogen/generated/android/c++/JVariant_String_ArtworkVariants.cpp
-  ../nitrogen/generated/android/c++/JVariant_ResolvedTrack_BrowseError_Promise_BrowseResult_.cpp
   ../nitrogen/generated/android/c++/JBrowseResult.cpp
   ../nitrogen/generated/android/c++/JSleepTimer.cpp
-  ../nitrogen/generated/android/c++/JVariant_NullType_RemoteButtonLayout.cpp
+  ../nitrogen/generated/android/c++/JVariant_HeartRating_ThumbsRating_StarRating_PercentageRating.cpp
+  ../nitrogen/generated/android/c++/JVariant_NullType_NotificationButtonLayout.cpp
   ../nitrogen/generated/android/c++/JVariant_NullType_Double.cpp
-  ../nitrogen/generated/android/c++/JVariant_Boolean_FavoriteConfig.cpp
   ../nitrogen/generated/android/c++/JVariant_Boolean_AndroidAudioOffloadSettings.cpp
   ../nitrogen/generated/android/c++/JVariant_Boolean_RetryConfig.cpp
 )