@nuclearplayer/plugin-sdk 2.0.0 → 2.1.1

package/README.md

@@ -100,6 +100,22 @@ export default {
 };
 ```
 
+## Domain APIs
+
+The `api` object passed to lifecycle hooks provides access to these domain APIs:
+
+| API | Description |
+|-----|-------------|
+| `api.Settings` | Define, read, and persist plugin settings |
+| `api.Queue` | Read and manipulate the playback queue |
+| `api.Favorites` | Manage the user's favorite tracks |
+| `api.Providers` | Register and unregister providers |
+| `api.Streaming` | Resolve audio stream URLs for tracks |
+| `api.Metadata` | Search and fetch artist/album/track details |
+| `api.Dashboard` | Fetch dashboard content (top tracks, new releases, etc.) |
+
+See the [full documentation](https://docs.nuclearplayer.com/nuclear-xrd) for detailed guides on each API.
+
 ## Permissions
 
 Declare what your plugin does in the `permissions` array. Permissions are currently informational. Future versions might show UI for this.

package/dist/index.d.ts

@@ -73,6 +73,13 @@ export declare type ArtworkSet = {
     items: Artwork[];
 };
 
+export declare type AttributedResult<T> = {
+    providerId: string;
+    metadataProviderId?: string;
+    providerName: string;
+    items: T[];
+};
+
 export declare type BooleanSettingDefinition = {
     id: string;
     title: string;
@@ -89,6 +96,36 @@ export declare type BooleanWidget = {
     type: 'toggle';
 };
 
+export declare class DashboardAPI {
+    #private;
+    constructor(host?: DashboardHost);
+    fetchTopTracks(providerId?: string): Promise<AttributedResult<Track>[]>;
+    fetchTopArtists(providerId?: string): Promise<AttributedResult<ArtistRef>[]>;
+    fetchTopAlbums(providerId?: string): Promise<AttributedResult<AlbumRef>[]>;
+    fetchEditorialPlaylists(providerId?: string): Promise<AttributedResult<PlaylistRef>[]>;
+    fetchNewReleases(providerId?: string): Promise<AttributedResult<AlbumRef>[]>;
+}
+
+export declare type DashboardCapability = 'topTracks' | 'topArtists' | 'topAlbums' | 'editorialPlaylists' | 'newReleases';
+
+export declare type DashboardHost = {
+    fetchTopTracks: (providerId?: string) => Promise<AttributedResult<Track>[]>;
+    fetchTopArtists: (providerId?: string) => Promise<AttributedResult<ArtistRef>[]>;
+    fetchTopAlbums: (providerId?: string) => Promise<AttributedResult<AlbumRef>[]>;
+    fetchEditorialPlaylists: (providerId?: string) => Promise<AttributedResult<PlaylistRef>[]>;
+    fetchNewReleases: (providerId?: string) => Promise<AttributedResult<AlbumRef>[]>;
+};
+
+export declare type DashboardProvider = ProviderDescriptor<'dashboard'> & {
+    metadataProviderId?: string;
+    capabilities: DashboardCapability[];
+    fetchTopTracks?: () => Promise<Track[]>;
+    fetchTopArtists?: () => Promise<ArtistRef[]>;
+    fetchTopAlbums?: () => Promise<AlbumRef[]>;
+    fetchEditorialPlaylists?: () => Promise<PlaylistRef[]>;
+    fetchNewReleases?: () => Promise<AlbumRef[]>;
+};
+
 export declare type EnumOption = {
     value: string;
     label: string;
@@ -260,7 +297,7 @@ export declare type MetadataProvider = ProviderDescriptor<'metadata'> & {
 };
 
 export declare class MissingCapabilityError extends Error {
-    constructor(capability: string);
+    constructor(capability: string, providerName: string);
 }
 
 export declare class NuclearAPI {
@@ -273,6 +310,7 @@ export declare class NuclearAPI {
     readonly Ytdlp: YtdlpAPI;
     readonly Favorites: FavoritesAPI;
     readonly Logger: LoggerAPI;
+    readonly Dashboard: DashboardAPI;
     constructor(opts?: {
         settingsHost?: SettingsHost;
         providersHost?: ProvidersHost;
@@ -283,6 +321,7 @@ export declare class NuclearAPI {
         ytdlpHost?: YtdlpHost;
         favoritesHost?: FavoritesHost;
         loggerHost?: LoggerHost;
+        dashboardHost?: DashboardHost;
     });
 }
 
@@ -1027,7 +1066,7 @@ export declare type ProviderDescriptor<K extends ProviderKind = ProviderKind> =
     pluginId?: string;
 };
 
-export declare type ProviderKind = 'metadata' | 'streaming' | 'lyrics' | (string & {});
+export declare type ProviderKind = 'metadata' | 'streaming' | 'lyrics' | 'dashboard' | (string & {});
 
 export declare type ProviderRef = {
     provider: string;
@@ -1041,14 +1080,14 @@ declare class Providers {
     register<T extends ProviderDescriptor>(p: T): string;
     unregister(id: string): boolean;
     list<K extends ProviderKind = ProviderKind>(kind?: K): ProviderDescriptor<K>[];
-    get<T extends ProviderDescriptor>(id: string): T | undefined;
+    get<T extends ProviderDescriptor>(id: string, kind: ProviderKind): T | undefined;
 }
 
 export declare type ProvidersHost = {
     register<T extends ProviderDescriptor>(provider: T): string;
     unregister(providerId: string): boolean;
     list<K extends ProviderKind = ProviderKind>(kind?: K): ProviderDescriptor<K>[];
-    get<T extends ProviderDescriptor>(providerId: string): T | undefined;
+    get<T extends ProviderDescriptor>(providerId: string, kind: ProviderKind): T | undefined;
     clear(): void;
 };
 

package/dist/index.js

@@ -1,5 +1,32 @@
 import { useState as Se, useEffect as Ce, useMemo as Ie } from "react";
 class Ne {
+  #t;
+  constructor(e) {
+    this.#t = e;
+  }
+  #e(e) {
+    const t = this.#t;
+    if (!t)
+      throw new Error("Dashboard host not available");
+    return e(t);
+  }
+  fetchTopTracks(e) {
+    return this.#e((t) => t.fetchTopTracks(e));
+  }
+  fetchTopArtists(e) {
+    return this.#e((t) => t.fetchTopArtists(e));
+  }
+  fetchTopAlbums(e) {
+    return this.#e((t) => t.fetchTopAlbums(e));
+  }
+  fetchEditorialPlaylists(e) {
+    return this.#e((t) => t.fetchEditorialPlaylists(e));
+  }
+  fetchNewReleases(e) {
+    return this.#e((t) => t.fetchNewReleases(e));
+  }
+}
+class Oe {
   #t;
   constructor(e) {
     this.#t = e;
@@ -50,7 +77,7 @@ class Ne {
     return this.#e((t) => t.subscribe(e));
   }
 }
-const Oe = (r) => {
+const Re = (r) => {
   if (r instanceof Headers) {
     const e = {};
     return r.forEach((t, s) => {
@@ -59,9 +86,9 @@ const Oe = (r) => {
   }
   return Array.isArray(r) ? Object.fromEntries(r) : r;
 };
-function Re(r) {
+function Ze(r) {
   return async (e, t) => {
-    const s = String(e instanceof Request ? e.url : e), a = t?.headers ? Oe(t.headers) : void 0, n = typeof t?.body == "string" ? t.body : void 0, i = await r.fetch(s, {
+    const s = String(e instanceof Request ? e.url : e), a = t?.headers ? Re(t.headers) : void 0, n = typeof t?.body == "string" ? t.body : void 0, i = await r.fetch(s, {
       method: t?.method,
       headers: a,
       body: n
@@ -72,27 +99,27 @@ function Re(r) {
     });
   };
 }
-const Ze = {
+const Ee = {
   fetch: async () => ({
     status: 501,
     headers: {},
     body: "HTTP host not configured"
   })
 };
-class Ee {
+class je {
   fetch;
   constructor(e) {
-    this.fetch = Re(e ?? Ze);
+    this.fetch = Ze(e ?? Ee);
   }
 }
-const je = {
+const $e = {
   log: () => {
   }
 };
-class $e {
+class Me {
   host;
   constructor(e) {
-    this.host = e ?? je;
+    this.host = e ?? $e;
   }
   trace(e) {
     this.host.log("trace", e);
@@ -113,7 +140,7 @@ class $e {
     this.host.log(e, t);
   }
 }
-class Me {
+class Pe {
   #t;
   constructor(e) {
     this.#t = e;
@@ -153,7 +180,7 @@ class Me {
     return this.#e((s) => s.fetchAlbumDetails(e, t));
   }
 }
-class Pe {
+class Ve {
   #t;
   constructor(e) {
     this.#t = e;
@@ -173,11 +200,11 @@ class Pe {
   list(e) {
     return this.#e((t) => t.list(e));
   }
-  get(e) {
-    return this.#e((t) => t.get(e));
+  get(e, t) {
+    return this.#e((s) => s.get(e, t));
   }
 }
-class Ve {
+class Le {
   #t;
   constructor(e) {
     this.#t = e;
@@ -243,7 +270,7 @@ class Ve {
     return this.#e((t) => t.subscribeToCurrentItem(e));
   }
 }
-class Le {
+class ze {
   #t;
   constructor(e) {
     this.#t = e;
@@ -267,7 +294,7 @@ class Le {
     return this.#e((s) => s.subscribe(e, t));
   }
 }
-class ze {
+class De {
   #t;
   constructor(e) {
     this.#t = e;
@@ -285,7 +312,7 @@ class ze {
     return this.#e((t) => t.resolveStreamForCandidate(e));
   }
 }
-class De {
+class Fe {
   host;
   constructor(e) {
     this.host = e;
@@ -304,7 +331,7 @@ class De {
     return this.host.getStream(e);
   }
 }
-class Fe {
+class Be {
   Settings;
   Providers;
   Queue;
@@ -314,18 +341,21 @@ class Fe {
   Ytdlp;
   Favorites;
   Logger;
+  Dashboard;
   constructor(e) {
-    this.Settings = new Le(e?.settingsHost), this.Providers = new Pe(e?.providersHost), this.Queue = new Ve(e?.queueHost), this.Streaming = new ze(e?.streamingHost), this.Metadata = new Me(e?.metadataHost), this.Http = new Ee(e?.httpHost), this.Ytdlp = new De(e?.ytdlpHost), this.Favorites = new Ne(e?.favoritesHost), this.Logger = new $e(e?.loggerHost);
+    this.Settings = new ze(e?.settingsHost), this.Providers = new Ve(e?.providersHost), this.Queue = new Le(e?.queueHost), this.Streaming = new De(e?.streamingHost), this.Metadata = new Pe(e?.metadataHost), this.Http = new je(e?.httpHost), this.Ytdlp = new Fe(e?.ytdlpHost), this.Favorites = new Oe(e?.favoritesHost), this.Logger = new Me(e?.loggerHost), this.Dashboard = new Ne(e?.dashboardHost);
   }
 }
-class bt extends Fe {
+class wt extends Be {
 }
-class wt extends Error {
-  constructor(e) {
-    super(`Missing capability: ${e}`), this.name = "MissingCapabilityError";
+class At extends Error {
+  constructor(e, t) {
+    super(
+      `Missing capability: Provider "${t}" declared capability "${e}" but does not implement it`
+    ), this.name = "MissingCapabilityError";
   }
 }
-const At = (r, e) => {
+const Tt = (r, e) => {
   const [t, s] = Se(void 0);
   Ce(() => {
     if (!r)
@@ -348,7 +378,7 @@ const At = (r, e) => {
   );
   return [t, a];
 };
-function Tt(r, e, t) {
+function St(r, e, t) {
   if (!r?.items?.length)
     return;
   const s = r.items.filter((o) => !(o.purpose && o.purpose !== e || !o.url));
@@ -600,11 +630,11 @@ const X = (r, e) => {
   }
   return { message: t };
 };
-let Be = X;
-function Ue() {
-  return Be;
+let Ue = X;
+function He() {
+  return Ue;
 }
-const He = (r) => {
+const We = (r) => {
   const { data: e, path: t, errorMaps: s, issueData: a } = r, n = [...t, ...a.path || []], i = {
     ...a,
     path: n
@@ -626,7 +656,7 @@ const He = (r) => {
   };
 };
 function c(r, e) {
-  const t = Ue(), s = He({
+  const t = He(), s = We({
     issueData: e,
     data: r.data,
     path: r.path,
@@ -908,7 +938,7 @@ class v {
     });
   }
   brand() {
-    return new mt({
+    return new pt({
       typeName: p.ZodBranded,
       type: this,
       ...g(this._def)
@@ -943,28 +973,28 @@ class v {
     return this.safeParse(null).success;
   }
 }
-const We = /^c[^\s-]{8,}$/i, qe = /^[0-9a-z]+$/, Qe = /^[0-9A-HJKMNP-TV-Z]{26}$/i, Ye = /^[0-9a-fA-F]{8}\b-[0-9a-fA-F]{4}\b-[0-9a-fA-F]{4}\b-[0-9a-fA-F]{4}\b-[0-9a-fA-F]{12}$/i, Je = /^[a-z0-9_-]{21}$/i, Ge = /^[A-Za-z0-9-_]+\.[A-Za-z0-9-_]+\.[A-Za-z0-9-_]*$/, Xe = /^[-+]?P(?!$)(?:(?:[-+]?\d+Y)|(?:[-+]?\d+[.,]\d+Y$))?(?:(?:[-+]?\d+M)|(?:[-+]?\d+[.,]\d+M$))?(?:(?:[-+]?\d+W)|(?:[-+]?\d+[.,]\d+W$))?(?:(?:[-+]?\d+D)|(?:[-+]?\d+[.,]\d+D$))?(?:T(?=[\d+-])(?:(?:[-+]?\d+H)|(?:[-+]?\d+[.,]\d+H$))?(?:(?:[-+]?\d+M)|(?:[-+]?\d+[.,]\d+M$))?(?:[-+]?\d+(?:[.,]\d+)?S)?)??$/, Ke = /^(?!\.)(?!.*\.\.)([A-Z0-9_'+\-\.]*)[A-Z0-9_+-]@([A-Z0-9][A-Z0-9\-]*\.)+[A-Z]{2,}$/i, et = "^(\\p{Extended_Pictographic}|\\p{Emoji_Component})+$";
+const qe = /^c[^\s-]{8,}$/i, Qe = /^[0-9a-z]+$/, Ye = /^[0-9A-HJKMNP-TV-Z]{26}$/i, Je = /^[0-9a-fA-F]{8}\b-[0-9a-fA-F]{4}\b-[0-9a-fA-F]{4}\b-[0-9a-fA-F]{4}\b-[0-9a-fA-F]{12}$/i, Ge = /^[a-z0-9_-]{21}$/i, Xe = /^[A-Za-z0-9-_]+\.[A-Za-z0-9-_]+\.[A-Za-z0-9-_]*$/, Ke = /^[-+]?P(?!$)(?:(?:[-+]?\d+Y)|(?:[-+]?\d+[.,]\d+Y$))?(?:(?:[-+]?\d+M)|(?:[-+]?\d+[.,]\d+M$))?(?:(?:[-+]?\d+W)|(?:[-+]?\d+[.,]\d+W$))?(?:(?:[-+]?\d+D)|(?:[-+]?\d+[.,]\d+D$))?(?:T(?=[\d+-])(?:(?:[-+]?\d+H)|(?:[-+]?\d+[.,]\d+H$))?(?:(?:[-+]?\d+M)|(?:[-+]?\d+[.,]\d+M$))?(?:[-+]?\d+(?:[.,]\d+)?S)?)??$/, et = /^(?!\.)(?!.*\.\.)([A-Z0-9_'+\-\.]*)[A-Z0-9_+-]@([A-Z0-9][A-Z0-9\-]*\.)+[A-Z]{2,}$/i, tt = "^(\\p{Extended_Pictographic}|\\p{Emoji_Component})+$";
 let G;
-const tt = /^(?:(?:25[0-5]|2[0-4][0-9]|1[0-9][0-9]|[1-9][0-9]|[0-9])\.){3}(?:25[0-5]|2[0-4][0-9]|1[0-9][0-9]|[1-9][0-9]|[0-9])$/, st = /^(?:(?:25[0-5]|2[0-4][0-9]|1[0-9][0-9]|[1-9][0-9]|[0-9])\.){3}(?:25[0-5]|2[0-4][0-9]|1[0-9][0-9]|[1-9][0-9]|[0-9])\/(3[0-2]|[12]?[0-9])$/, rt = /^(([0-9a-fA-F]{1,4}:){7,7}[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,7}:|([0-9a-fA-F]{1,4}:){1,6}:[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,5}(:[0-9a-fA-F]{1,4}){1,2}|([0-9a-fA-F]{1,4}:){1,4}(:[0-9a-fA-F]{1,4}){1,3}|([0-9a-fA-F]{1,4}:){1,3}(:[0-9a-fA-F]{1,4}){1,4}|([0-9a-fA-F]{1,4}:){1,2}(:[0-9a-fA-F]{1,4}){1,5}|[0-9a-fA-F]{1,4}:((:[0-9a-fA-F]{1,4}){1,6})|:((:[0-9a-fA-F]{1,4}){1,7}|:)|fe80:(:[0-9a-fA-F]{0,4}){0,4}%[0-9a-zA-Z]{1,}|::(ffff(:0{1,4}){0,1}:){0,1}((25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])\.){3,3}(25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])|([0-9a-fA-F]{1,4}:){1,4}:((25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])\.){3,3}(25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9]))$/, at = /^(([0-9a-fA-F]{1,4}:){7,7}[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,7}:|([0-9a-fA-F]{1,4}:){1,6}:[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,5}(:[0-9a-fA-F]{1,4}){1,2}|([0-9a-fA-F]{1,4}:){1,4}(:[0-9a-fA-F]{1,4}){1,3}|([0-9a-fA-F]{1,4}:){1,3}(:[0-9a-fA-F]{1,4}){1,4}|([0-9a-fA-F]{1,4}:){1,2}(:[0-9a-fA-F]{1,4}){1,5}|[0-9a-fA-F]{1,4}:((:[0-9a-fA-F]{1,4}){1,6})|:((:[0-9a-fA-F]{1,4}){1,7}|:)|fe80:(:[0-9a-fA-F]{0,4}){0,4}%[0-9a-zA-Z]{1,}|::(ffff(:0{1,4}){0,1}:){0,1}((25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])\.){3,3}(25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])|([0-9a-fA-F]{1,4}:){1,4}:((25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])\.){3,3}(25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9]))\/(12[0-8]|1[01][0-9]|[1-9]?[0-9])$/, nt = /^([0-9a-zA-Z+/]{4})*(([0-9a-zA-Z+/]{2}==)|([0-9a-zA-Z+/]{3}=))?$/, it = /^([0-9a-zA-Z-_]{4})*(([0-9a-zA-Z-_]{2}(==)?)|([0-9a-zA-Z-_]{3}(=)?))?$/, xe = "((\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-((0[13578]|1[02])-(0[1-9]|[12]\\d|3[01])|(0[469]|11)-(0[1-9]|[12]\\d|30)|(02)-(0[1-9]|1\\d|2[0-8])))", ot = new RegExp(`^${xe}$`);
+const st = /^(?:(?:25[0-5]|2[0-4][0-9]|1[0-9][0-9]|[1-9][0-9]|[0-9])\.){3}(?:25[0-5]|2[0-4][0-9]|1[0-9][0-9]|[1-9][0-9]|[0-9])$/, rt = /^(?:(?:25[0-5]|2[0-4][0-9]|1[0-9][0-9]|[1-9][0-9]|[0-9])\.){3}(?:25[0-5]|2[0-4][0-9]|1[0-9][0-9]|[1-9][0-9]|[0-9])\/(3[0-2]|[12]?[0-9])$/, at = /^(([0-9a-fA-F]{1,4}:){7,7}[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,7}:|([0-9a-fA-F]{1,4}:){1,6}:[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,5}(:[0-9a-fA-F]{1,4}){1,2}|([0-9a-fA-F]{1,4}:){1,4}(:[0-9a-fA-F]{1,4}){1,3}|([0-9a-fA-F]{1,4}:){1,3}(:[0-9a-fA-F]{1,4}){1,4}|([0-9a-fA-F]{1,4}:){1,2}(:[0-9a-fA-F]{1,4}){1,5}|[0-9a-fA-F]{1,4}:((:[0-9a-fA-F]{1,4}){1,6})|:((:[0-9a-fA-F]{1,4}){1,7}|:)|fe80:(:[0-9a-fA-F]{0,4}){0,4}%[0-9a-zA-Z]{1,}|::(ffff(:0{1,4}){0,1}:){0,1}((25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])\.){3,3}(25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])|([0-9a-fA-F]{1,4}:){1,4}:((25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])\.){3,3}(25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9]))$/, nt = /^(([0-9a-fA-F]{1,4}:){7,7}[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,7}:|([0-9a-fA-F]{1,4}:){1,6}:[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,5}(:[0-9a-fA-F]{1,4}){1,2}|([0-9a-fA-F]{1,4}:){1,4}(:[0-9a-fA-F]{1,4}){1,3}|([0-9a-fA-F]{1,4}:){1,3}(:[0-9a-fA-F]{1,4}){1,4}|([0-9a-fA-F]{1,4}:){1,2}(:[0-9a-fA-F]{1,4}){1,5}|[0-9a-fA-F]{1,4}:((:[0-9a-fA-F]{1,4}){1,6})|:((:[0-9a-fA-F]{1,4}){1,7}|:)|fe80:(:[0-9a-fA-F]{0,4}){0,4}%[0-9a-zA-Z]{1,}|::(ffff(:0{1,4}){0,1}:){0,1}((25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])\.){3,3}(25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])|([0-9a-fA-F]{1,4}:){1,4}:((25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])\.){3,3}(25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9]))\/(12[0-8]|1[01][0-9]|[1-9]?[0-9])$/, it = /^([0-9a-zA-Z+/]{4})*(([0-9a-zA-Z+/]{2}==)|([0-9a-zA-Z+/]{3}=))?$/, ot = /^([0-9a-zA-Z-_]{4})*(([0-9a-zA-Z-_]{2}(==)?)|([0-9a-zA-Z-_]{3}(=)?))?$/, xe = "((\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-((0[13578]|1[02])-(0[1-9]|[12]\\d|3[01])|(0[469]|11)-(0[1-9]|[12]\\d|30)|(02)-(0[1-9]|1\\d|2[0-8])))", dt = new RegExp(`^${xe}$`);
 function ke(r) {
   let e = "[0-5]\\d";
   r.precision ? e = `${e}\\.\\d{${r.precision}}` : r.precision == null && (e = `${e}(\\.\\d+)?`);
   const t = r.precision ? "+" : "?";
   return `([01]\\d|2[0-3]):[0-5]\\d(:${e})${t}`;
 }
-function dt(r) {
+function ct(r) {
   return new RegExp(`^${ke(r)}$`);
 }
-function ct(r) {
+function ut(r) {
   let e = `${xe}T${ke(r)}`;
   const t = [];
   return t.push(r.local ? "Z?" : "Z"), r.offset && t.push("([+-]\\d{2}:?\\d{2})"), e = `${e}(${t.join("|")})`, new RegExp(`^${e}$`);
 }
-function ut(r, e) {
-  return !!((e === "v4" || !e) && tt.test(r) || (e === "v6" || !e) && rt.test(r));
-}
 function lt(r, e) {
-  if (!Ge.test(r))
+  return !!((e === "v4" || !e) && st.test(r) || (e === "v6" || !e) && at.test(r));
+}
+function ht(r, e) {
+  if (!Xe.test(r))
     return !1;
   try {
     const [t] = r.split(".");
@@ -976,8 +1006,8 @@ function lt(r, e) {
     return !1;
   }
 }
-function ht(r, e) {
-  return !!((e === "v4" || !e) && st.test(r) || (e === "v6" || !e) && at.test(r));
+function ft(r, e) {
+  return !!((e === "v4" || !e) && rt.test(r) || (e === "v6" || !e) && nt.test(r));
 }
 class C extends v {
   _parse(e) {
@@ -1028,43 +1058,43 @@ class C extends v {
           message: n.message
         }), s.dirty());
       } else if (n.kind === "email")
-        Ke.test(e.data) || (a = this._getOrReturnCtx(e, a), c(a, {
+        et.test(e.data) || (a = this._getOrReturnCtx(e, a), c(a, {
           validation: "email",
           code: d.invalid_string,
           message: n.message
         }), s.dirty());
       else if (n.kind === "emoji")
-        G || (G = new RegExp(et, "u")), G.test(e.data) || (a = this._getOrReturnCtx(e, a), c(a, {
+        G || (G = new RegExp(tt, "u")), G.test(e.data) || (a = this._getOrReturnCtx(e, a), c(a, {
           validation: "emoji",
           code: d.invalid_string,
           message: n.message
         }), s.dirty());
       else if (n.kind === "uuid")
-        Ye.test(e.data) || (a = this._getOrReturnCtx(e, a), c(a, {
+        Je.test(e.data) || (a = this._getOrReturnCtx(e, a), c(a, {
           validation: "uuid",
           code: d.invalid_string,
           message: n.message
         }), s.dirty());
       else if (n.kind === "nanoid")
-        Je.test(e.data) || (a = this._getOrReturnCtx(e, a), c(a, {
+        Ge.test(e.data) || (a = this._getOrReturnCtx(e, a), c(a, {
           validation: "nanoid",
           code: d.invalid_string,
           message: n.message
         }), s.dirty());
       else if (n.kind === "cuid")
-        We.test(e.data) || (a = this._getOrReturnCtx(e, a), c(a, {
+        qe.test(e.data) || (a = this._getOrReturnCtx(e, a), c(a, {
           validation: "cuid",
           code: d.invalid_string,
           message: n.message
         }), s.dirty());
       else if (n.kind === "cuid2")
-        qe.test(e.data) || (a = this._getOrReturnCtx(e, a), c(a, {
+        Qe.test(e.data) || (a = this._getOrReturnCtx(e, a), c(a, {
           validation: "cuid2",
           code: d.invalid_string,
           message: n.message
         }), s.dirty());
       else if (n.kind === "ulid")
-        Qe.test(e.data) || (a = this._getOrReturnCtx(e, a), c(a, {
+        Ye.test(e.data) || (a = this._getOrReturnCtx(e, a), c(a, {
           validation: "ulid",
           code: d.invalid_string,
           message: n.message
@@ -1095,39 +1125,39 @@ class C extends v {
         code: d.invalid_string,
         validation: { endsWith: n.value },
         message: n.message
-      }), s.dirty()) : n.kind === "datetime" ? ct(n).test(e.data) || (a = this._getOrReturnCtx(e, a), c(a, {
+      }), s.dirty()) : n.kind === "datetime" ? ut(n).test(e.data) || (a = this._getOrReturnCtx(e, a), c(a, {
         code: d.invalid_string,
         validation: "datetime",
         message: n.message
-      }), s.dirty()) : n.kind === "date" ? ot.test(e.data) || (a = this._getOrReturnCtx(e, a), c(a, {
+      }), s.dirty()) : n.kind === "date" ? dt.test(e.data) || (a = this._getOrReturnCtx(e, a), c(a, {
         code: d.invalid_string,
         validation: "date",
         message: n.message
-      }), s.dirty()) : n.kind === "time" ? dt(n).test(e.data) || (a = this._getOrReturnCtx(e, a), c(a, {
+      }), s.dirty()) : n.kind === "time" ? ct(n).test(e.data) || (a = this._getOrReturnCtx(e, a), c(a, {
         code: d.invalid_string,
         validation: "time",
         message: n.message
-      }), s.dirty()) : n.kind === "duration" ? Xe.test(e.data) || (a = this._getOrReturnCtx(e, a), c(a, {
+      }), s.dirty()) : n.kind === "duration" ? Ke.test(e.data) || (a = this._getOrReturnCtx(e, a), c(a, {
         validation: "duration",
         code: d.invalid_string,
         message: n.message
-      }), s.dirty()) : n.kind === "ip" ? ut(e.data, n.version) || (a = this._getOrReturnCtx(e, a), c(a, {
+      }), s.dirty()) : n.kind === "ip" ? lt(e.data, n.version) || (a = this._getOrReturnCtx(e, a), c(a, {
         validation: "ip",
         code: d.invalid_string,
         message: n.message
-      }), s.dirty()) : n.kind === "jwt" ? lt(e.data, n.alg) || (a = this._getOrReturnCtx(e, a), c(a, {
+      }), s.dirty()) : n.kind === "jwt" ? ht(e.data, n.alg) || (a = this._getOrReturnCtx(e, a), c(a, {
         validation: "jwt",
         code: d.invalid_string,
         message: n.message
-      }), s.dirty()) : n.kind === "cidr" ? ht(e.data, n.version) || (a = this._getOrReturnCtx(e, a), c(a, {
+      }), s.dirty()) : n.kind === "cidr" ? ft(e.data, n.version) || (a = this._getOrReturnCtx(e, a), c(a, {
         validation: "cidr",
         code: d.invalid_string,
         message: n.message
-      }), s.dirty()) : n.kind === "base64" ? nt.test(e.data) || (a = this._getOrReturnCtx(e, a), c(a, {
+      }), s.dirty()) : n.kind === "base64" ? it.test(e.data) || (a = this._getOrReturnCtx(e, a), c(a, {
         validation: "base64",
         code: d.invalid_string,
         message: n.message
-      }), s.dirty()) : n.kind === "base64url" ? it.test(e.data) || (a = this._getOrReturnCtx(e, a), c(a, {
+      }), s.dirty()) : n.kind === "base64url" ? ot.test(e.data) || (a = this._getOrReturnCtx(e, a), c(a, {
         validation: "base64url",
         code: d.invalid_string,
         message: n.message
@@ -1362,7 +1392,7 @@ C.create = (r) => new C({
   coerce: r?.coerce ?? !1,
   ...g(r)
 });
-function ft(r, e) {
+function mt(r, e) {
   const t = (r.toString().split(".")[1] || "").length, s = (e.toString().split(".")[1] || "").length, a = t > s ? t : s, n = Number.parseInt(r.toFixed(a).replace(".", "")), i = Number.parseInt(e.toFixed(a).replace(".", ""));
   return n % i / 10 ** a;
 }
@@ -1401,7 +1431,7 @@ class M extends v {
         inclusive: n.inclusive,
         exact: !1,
         message: n.message
-      }), a.dirty()) : n.kind === "multipleOf" ? ft(e.data, n.value) !== 0 && (s = this._getOrReturnCtx(e, s), c(s, {
+      }), a.dirty()) : n.kind === "multipleOf" ? mt(e.data, n.value) !== 0 && (s = this._getOrReturnCtx(e, s), c(s, {
         code: d.not_multiple_of,
         multipleOf: n.value,
         message: n.message
@@ -2897,7 +2927,7 @@ _e.create = (r) => new _e({
   typeName: p.ZodNaN,
   ...g(r)
 });
-class mt extends v {
+class pt extends v {
   _parse(e) {
     const { ctx: t } = this._processInputParams(e), s = t.data;
     return this._def.type._parse({
@@ -2974,7 +3004,7 @@ const z = A.create, R = k.create;
 q.create;
 Q.create;
 E.create;
-const pt = P.create;
+const gt = P.create;
 Y.create;
 I.create;
 L.create;
@@ -2982,29 +3012,29 @@ const J = R({
   provider: x(),
   id: x(),
   url: x().optional()
-}), gt = R({
+}), yt = R({
   url: x(),
   width: U().optional(),
   height: U().optional(),
-  purpose: pt(["avatar", "cover", "background", "thumbnail"]).optional(),
+  purpose: gt(["avatar", "cover", "background", "thumbnail"]).optional(),
   source: J.optional()
 }), Ae = R({
-  items: z(gt)
-}), yt = R({
+  items: z(yt)
+}), vt = R({
   name: x(),
   roles: z(x()),
   source: J.optional()
-}), vt = R({
+}), _t = R({
   title: x(),
-  artists: z(yt),
+  artists: z(vt),
   durationMs: U().optional(),
   source: J
-}).passthrough(), _t = R({
+}).passthrough(), xt = R({
   id: x(),
-  track: vt,
+  track: _t,
   note: x().optional(),
   addedAtIso: x()
-}), St = R({
+}), Ct = R({
   id: x(),
   name: x(),
   description: x().optional(),
@@ -3015,8 +3045,8 @@ const J = R({
   origin: J.optional(),
   isReadOnly: we(),
   parentId: x().optional(),
-  items: z(_t)
-}), xt = R({
+  items: z(xt)
+}), kt = R({
   id: x(),
   name: x(),
   createdAtIso: x(),
@@ -3025,18 +3055,19 @@ const J = R({
   artwork: Ae.optional(),
   itemCount: U(),
   totalDurationMs: U()
-}), Ct = z(xt);
+}), It = z(kt);
 export {
-  Ne as FavoritesAPI,
-  Ee as HttpAPI,
-  $e as LoggerAPI,
-  wt as MissingCapabilityError,
-  Fe as NuclearAPI,
-  bt as NuclearPluginAPI,
-  De as YtdlpAPI,
-  Tt as pickArtwork,
-  xt as playlistIndexEntrySchema,
-  Ct as playlistIndexSchema,
-  St as playlistSchema,
-  At as useSetting
+  Ne as DashboardAPI,
+  Oe as FavoritesAPI,
+  je as HttpAPI,
+  Me as LoggerAPI,
+  At as MissingCapabilityError,
+  Be as NuclearAPI,
+  wt as NuclearPluginAPI,
+  Fe as YtdlpAPI,
+  St as pickArtwork,
+  kt as playlistIndexEntrySchema,
+  It as playlistIndexSchema,
+  Ct as playlistSchema,
+  Tt as useSetting
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nuclearplayer/plugin-sdk",
-  "version": "2.0.0",
+  "version": "2.1.1",
   "description": "Plugin SDK for Nuclear music player",
   "type": "module",
   "main": "./dist/index.js",