@wwdrew/expo-apple-music 1.0.0

package/build/types/rating.d.ts

@@ -0,0 +1,34 @@
+/** Apple Music API path segment for `GET/PUT/DELETE /v1/me/ratings/{type}/{id}`. */
+export declare const RatingResourceType: {
+    readonly SONG: "songs";
+    readonly ALBUM: "albums";
+    readonly PLAYLIST: "playlists";
+    readonly MUSIC_VIDEO: "music-videos";
+    readonly STATION: "stations";
+    readonly LIBRARY_SONG: "library-songs";
+    readonly LIBRARY_ALBUM: "library-albums";
+    readonly LIBRARY_PLAYLIST: "library-playlists";
+    readonly LIBRARY_MUSIC_VIDEO: "library-music-videos";
+};
+export type RatingResourceType = (typeof RatingResourceType)[keyof typeof RatingResourceType];
+/** Like (`1`) or dislike (`-1`) — only values Apple accepts. */
+export declare const RatingValue: {
+    readonly LIKE: 1;
+    readonly DISLIKE: -1;
+};
+export type RatingValue = (typeof RatingValue)[keyof typeof RatingValue];
+export interface Rating {
+    id: string;
+    value: RatingValue;
+}
+/** Query keys for `ids[{type}]` on favorites and add-to-library endpoints. */
+export declare const LibraryResourceType: {
+    readonly SONGS: "songs";
+    readonly ALBUMS: "albums";
+    readonly PLAYLISTS: "playlists";
+    readonly MUSIC_VIDEOS: "music-videos";
+    readonly STATIONS: "stations";
+};
+export type LibraryResourceType = (typeof LibraryResourceType)[keyof typeof LibraryResourceType];
+export type ResourceIds = Partial<Record<LibraryResourceType, string[]>>;
+//# sourceMappingURL=rating.d.ts.map

package/build/types/rating.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rating.d.ts","sourceRoot":"","sources":["../../src/types/rating.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,eAAO,MAAM,kBAAkB;;;;;;;;;;CAUrB,CAAC;AAEX,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,OAAO,kBAAkB,CAAC,CAAC;AAE9F,gEAAgE;AAChE,eAAO,MAAM,WAAW;;;CAGd,CAAC;AAEX,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,OAAO,WAAW,CAAC,CAAC;AAEzE,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,WAAW,CAAC;CACpB;AAED,8EAA8E;AAC9E,eAAO,MAAM,mBAAmB;;;;;;CAMtB,CAAC;AAEX,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,OAAO,mBAAmB,CAAC,CAAC;AAEjG,MAAM,MAAM,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,mBAAmB,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC"}

package/build/types/rating.js

@@ -0,0 +1,26 @@
+/** Apple Music API path segment for `GET/PUT/DELETE /v1/me/ratings/{type}/{id}`. */
+export const RatingResourceType = {
+    SONG: 'songs',
+    ALBUM: 'albums',
+    PLAYLIST: 'playlists',
+    MUSIC_VIDEO: 'music-videos',
+    STATION: 'stations',
+    LIBRARY_SONG: 'library-songs',
+    LIBRARY_ALBUM: 'library-albums',
+    LIBRARY_PLAYLIST: 'library-playlists',
+    LIBRARY_MUSIC_VIDEO: 'library-music-videos',
+};
+/** Like (`1`) or dislike (`-1`) — only values Apple accepts. */
+export const RatingValue = {
+    LIKE: 1,
+    DISLIKE: -1,
+};
+/** Query keys for `ids[{type}]` on favorites and add-to-library endpoints. */
+export const LibraryResourceType = {
+    SONGS: 'songs',
+    ALBUMS: 'albums',
+    PLAYLISTS: 'playlists',
+    MUSIC_VIDEOS: 'music-videos',
+    STATIONS: 'stations',
+};
+//# sourceMappingURL=rating.js.map

package/build/types/rating.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rating.js","sourceRoot":"","sources":["../../src/types/rating.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,IAAI,EAAE,OAAO;IACb,KAAK,EAAE,QAAQ;IACf,QAAQ,EAAE,WAAW;IACrB,WAAW,EAAE,cAAc;IAC3B,OAAO,EAAE,UAAU;IACnB,YAAY,EAAE,eAAe;IAC7B,aAAa,EAAE,gBAAgB;IAC/B,gBAAgB,EAAE,mBAAmB;IACrC,mBAAmB,EAAE,sBAAsB;CACnC,CAAC;AAIX,gEAAgE;AAChE,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,IAAI,EAAE,CAAC;IACP,OAAO,EAAE,CAAC,CAAC;CACH,CAAC;AASX,8EAA8E;AAC9E,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,KAAK,EAAE,OAAO;IACd,MAAM,EAAE,QAAQ;IAChB,SAAS,EAAE,WAAW;IACtB,YAAY,EAAE,cAAc;IAC5B,QAAQ,EAAE,UAAU;CACZ,CAAC","sourcesContent":["/** Apple Music API path segment for `GET/PUT/DELETE /v1/me/ratings/{type}/{id}`. */\nexport const RatingResourceType = {\n  SONG: 'songs',\n  ALBUM: 'albums',\n  PLAYLIST: 'playlists',\n  MUSIC_VIDEO: 'music-videos',\n  STATION: 'stations',\n  LIBRARY_SONG: 'library-songs',\n  LIBRARY_ALBUM: 'library-albums',\n  LIBRARY_PLAYLIST: 'library-playlists',\n  LIBRARY_MUSIC_VIDEO: 'library-music-videos',\n} as const;\n\nexport type RatingResourceType = (typeof RatingResourceType)[keyof typeof RatingResourceType];\n\n/** Like (`1`) or dislike (`-1`) — only values Apple accepts. */\nexport const RatingValue = {\n  LIKE: 1,\n  DISLIKE: -1,\n} as const;\n\nexport type RatingValue = (typeof RatingValue)[keyof typeof RatingValue];\n\nexport interface Rating {\n  id: string;\n  value: RatingValue;\n}\n\n/** Query keys for `ids[{type}]` on favorites and add-to-library endpoints. */\nexport const LibraryResourceType = {\n  SONGS: 'songs',\n  ALBUMS: 'albums',\n  PLAYLISTS: 'playlists',\n  MUSIC_VIDEOS: 'music-videos',\n  STATIONS: 'stations',\n} as const;\n\nexport type LibraryResourceType = (typeof LibraryResourceType)[keyof typeof LibraryResourceType];\n\nexport type ResourceIds = Partial<Record<LibraryResourceType, string[]>>;\n"]}

package/build/types/recent-resource.d.ts

@@ -0,0 +1,11 @@
+/** Album, playlist, or station from history / heavy-rotation / recently-added endpoints. */
+export interface RecentResource {
+    id: string;
+    title: string;
+    subtitle: string;
+    type: string;
+}
+export interface RecentResourcesResponse {
+    items: RecentResource[];
+}
+//# sourceMappingURL=recent-resource.d.ts.map

package/build/types/recent-resource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recent-resource.d.ts","sourceRoot":"","sources":["../../src/types/recent-resource.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,cAAc,EAAE,CAAC;CACzB"}

package/build/types/recent-resource.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=recent-resource.js.map

package/build/types/recent-resource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recent-resource.js","sourceRoot":"","sources":["../../src/types/recent-resource.ts"],"names":[],"mappings":"","sourcesContent":["/** Album, playlist, or station from history / heavy-rotation / recently-added endpoints. */\nexport interface RecentResource {\n  id: string;\n  title: string;\n  subtitle: string;\n  type: string;\n}\n\nexport interface RecentResourcesResponse {\n  items: RecentResource[];\n}\n"]}

package/build/types/recommendation.d.ts

@@ -0,0 +1,37 @@
+import type { Album } from './album';
+import type { Artist } from './artist';
+import type { Playlist } from './playlist';
+import type { Song } from './song';
+import type { Station } from './station';
+export interface Recommendation {
+    id: string;
+    title: string;
+    resourceTypes: string[];
+    playlists: Playlist[];
+    albums: Album[];
+    stations: Station[];
+}
+export interface RecommendationsResponse {
+    recommendations: Recommendation[];
+}
+export interface ReplaySummary {
+    id: string;
+    type: string;
+    name: string;
+    year?: number;
+    topSongs: Song[];
+    topAlbums: Album[];
+    topArtists: Artist[];
+}
+export interface ReplayResponse {
+    summaries: ReplaySummary[];
+}
+export interface RecommendationsOptions {
+    /** Personal-recommendation ids (e.g. `6-27s5hU6azhJY`). Omit to fetch all via native/REST. */
+    ids?: string[];
+}
+export interface ReplayOptions {
+    /** Calendar year; omit for the latest eligible year Apple returns. */
+    year?: number;
+}
+//# sourceMappingURL=recommendation.d.ts.map

package/build/types/recommendation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recommendation.d.ts","sourceRoot":"","sources":["../../src/types/recommendation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AACnC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,QAAQ,EAAE,OAAO,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,uBAAuB;IACtC,eAAe,EAAE,cAAc,EAAE,CAAC;CACnC;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,IAAI,EAAE,CAAC;IACjB,SAAS,EAAE,KAAK,EAAE,CAAC;IACnB,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,aAAa,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,sBAAsB;IACrC,8FAA8F;IAC9F,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,sEAAsE;IACtE,IAAI,CAAC,EAAE,MAAM,CAAC;CACf"}

package/build/types/recommendation.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=recommendation.js.map

package/build/types/recommendation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recommendation.js","sourceRoot":"","sources":["../../src/types/recommendation.ts"],"names":[],"mappings":"","sourcesContent":["import type { Album } from './album';\nimport type { Artist } from './artist';\nimport type { Playlist } from './playlist';\nimport type { Song } from './song';\nimport type { Station } from './station';\n\nexport interface Recommendation {\n  id: string;\n  title: string;\n  resourceTypes: string[];\n  playlists: Playlist[];\n  albums: Album[];\n  stations: Station[];\n}\n\nexport interface RecommendationsResponse {\n  recommendations: Recommendation[];\n}\n\nexport interface ReplaySummary {\n  id: string;\n  type: string;\n  name: string;\n  year?: number;\n  topSongs: Song[];\n  topAlbums: Album[];\n  topArtists: Artist[];\n}\n\nexport interface ReplayResponse {\n  summaries: ReplaySummary[];\n}\n\nexport interface RecommendationsOptions {\n  /** Personal-recommendation ids (e.g. `6-27s5hU6azhJY`). Omit to fetch all via native/REST. */\n  ids?: string[];\n}\n\nexport interface ReplayOptions {\n  /** Calendar year; omit for the latest eligible year Apple returns. */\n  year?: number;\n}\n"]}

package/build/types/song.d.ts

@@ -0,0 +1,8 @@
+export interface Song {
+    artistName: string;
+    title: string;
+    artworkUrl: string;
+    id: string;
+    duration: number;
+}
+//# sourceMappingURL=song.d.ts.map

package/build/types/song.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"song.d.ts","sourceRoot":"","sources":["../../src/types/song.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,IAAI;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;CAClB"}

package/build/types/song.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=song.js.map

package/build/types/song.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"song.js","sourceRoot":"","sources":["../../src/types/song.ts"],"names":[],"mappings":"","sourcesContent":["export interface Song {\n  artistName: string;\n  title: string;\n  artworkUrl: string;\n  id: string;\n  duration: number;\n}\n"]}

package/build/types/station.d.ts

@@ -0,0 +1,9 @@
+export interface Station {
+    id: string;
+    name: string;
+    artworkUrl: string;
+}
+export interface StationsResponse {
+    stations: Station[];
+}
+//# sourceMappingURL=station.d.ts.map

package/build/types/station.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"station.d.ts","sourceRoot":"","sources":["../../src/types/station.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,OAAO,EAAE,CAAC;CACrB"}

package/build/types/station.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=station.js.map

package/build/types/station.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"station.js","sourceRoot":"","sources":["../../src/types/station.ts"],"names":[],"mappings":"","sourcesContent":["export interface Station {\n  id: string;\n  name: string;\n  artworkUrl: string;\n}\n\nexport interface StationsResponse {\n  stations: Station[];\n}\n"]}

package/build/types/storefront.d.ts

@@ -0,0 +1,4 @@
+export interface Storefront {
+    id: string;
+}
+//# sourceMappingURL=storefront.d.ts.map

package/build/types/storefront.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storefront.d.ts","sourceRoot":"","sources":["../../src/types/storefront.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;CACZ"}

package/build/types/storefront.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=storefront.js.map

package/build/types/storefront.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storefront.js","sourceRoot":"","sources":["../../src/types/storefront.ts"],"names":[],"mappings":"","sourcesContent":["export interface Storefront {\n  id: string;\n}\n"]}

package/build/types/tracks-from-library.d.ts

@@ -0,0 +1,11 @@
+import type { MusicItem } from './music-item';
+export interface UserTrack {
+    id: string;
+    title: string;
+    subtitle: string;
+    type: MusicItem | string;
+}
+export interface TracksFromLibrary {
+    recentlyPlayedItems: UserTrack[];
+}
+//# sourceMappingURL=tracks-from-library.d.ts.map

package/build/types/tracks-from-library.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracks-from-library.d.ts","sourceRoot":"","sources":["../../src/types/tracks-from-library.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,SAAS,GAAG,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,iBAAiB;IAChC,mBAAmB,EAAE,SAAS,EAAE,CAAC;CAClC"}

package/build/types/tracks-from-library.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=tracks-from-library.js.map

package/build/types/tracks-from-library.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracks-from-library.js","sourceRoot":"","sources":["../../src/types/tracks-from-library.ts"],"names":[],"mappings":"","sourcesContent":["import type { MusicItem } from './music-item';\n\nexport interface UserTrack {\n  id: string;\n  title: string;\n  subtitle: string;\n  type: MusicItem | string;\n}\n\nexport interface TracksFromLibrary {\n  recentlyPlayedItems: UserTrack[];\n}\n"]}

package/build/utils/apple-music-error.d.ts

@@ -0,0 +1,10 @@
+export type AppleMusicError = {
+    code: string;
+    message: string;
+    operation?: string;
+};
+export type AppleMusicErrorInstance = Error & AppleMusicError;
+export declare function isAppleMusicError(error: unknown): error is AppleMusicError;
+/** Throw shape for bridge rejections — `instanceof Error` and readable `String(error)`. */
+export declare function asThrownAppleMusicError(error: AppleMusicError): AppleMusicErrorInstance;
+//# sourceMappingURL=apple-music-error.d.ts.map

package/build/utils/apple-music-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apple-music-error.d.ts","sourceRoot":"","sources":["../../src/utils/apple-music-error.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG,KAAK,GAAG,eAAe,CAAC;AAE9D,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,eAAe,CAS1E;AAED,2FAA2F;AAC3F,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,eAAe,GAAG,uBAAuB,CAEvF"}

package/build/utils/apple-music-error.js

@@ -0,0 +1,13 @@
+export function isAppleMusicError(error) {
+    return (typeof error === 'object' &&
+        error !== null &&
+        'code' in error &&
+        'message' in error &&
+        typeof error.code === 'string' &&
+        typeof error.message === 'string');
+}
+/** Throw shape for bridge rejections — `instanceof Error` and readable `String(error)`. */
+export function asThrownAppleMusicError(error) {
+    return Object.assign(new Error(error.message), error);
+}
+//# sourceMappingURL=apple-music-error.js.map

package/build/utils/apple-music-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apple-music-error.js","sourceRoot":"","sources":["../../src/utils/apple-music-error.ts"],"names":[],"mappings":"AAQA,MAAM,UAAU,iBAAiB,CAAC,KAAc;IAC9C,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,MAAM,IAAI,KAAK;QACf,SAAS,IAAI,KAAK;QAClB,OAAQ,KAAyB,CAAC,IAAI,KAAK,QAAQ;QACnD,OAAQ,KAAyB,CAAC,OAAO,KAAK,QAAQ,CACvD,CAAC;AACJ,CAAC;AAED,2FAA2F;AAC3F,MAAM,UAAU,uBAAuB,CAAC,KAAsB;IAC5D,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,KAAK,CAAC,CAAC;AACxD,CAAC","sourcesContent":["export type AppleMusicError = {\n  code: string;\n  message: string;\n  operation?: string;\n};\n\nexport type AppleMusicErrorInstance = Error & AppleMusicError;\n\nexport function isAppleMusicError(error: unknown): error is AppleMusicError {\n  return (\n    typeof error === 'object' &&\n    error !== null &&\n    'code' in error &&\n    'message' in error &&\n    typeof (error as AppleMusicError).code === 'string' &&\n    typeof (error as AppleMusicError).message === 'string'\n  );\n}\n\n/** Throw shape for bridge rejections — `instanceof Error` and readable `String(error)`. */\nexport function asThrownAppleMusicError(error: AppleMusicError): AppleMusicErrorInstance {\n  return Object.assign(new Error(error.message), error);\n}\n"]}

package/build/utils/get-error-message.d.ts

@@ -0,0 +1,2 @@
+export declare const getErrorMessage: (error: unknown, fallback?: string) => string;
+//# sourceMappingURL=get-error-message.d.ts.map

package/build/utils/get-error-message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-error-message.d.ts","sourceRoot":"","sources":["../../src/utils/get-error-message.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,eAAe,GAAI,OAAO,OAAO,EAAE,iBAA0B,KAAG,MAsB5E,CAAC"}

package/build/utils/get-error-message.js

@@ -0,0 +1,21 @@
+import { AppleMusicErrorCode } from '../constants/apple-music-error-codes';
+import { isAppleMusicError } from './apple-music-error';
+export const getErrorMessage = (error, fallback = 'Unknown error') => {
+    if (isAppleMusicError(error)) {
+        const prefix = error.code && error.code !== AppleMusicErrorCode.error ? `${error.code}: ` : '';
+        const operation = error.operation ? ` (${error.operation})` : '';
+        return `${prefix}${error.message}${operation}`;
+    }
+    if (error instanceof Error && error.message.trim().length > 0) {
+        return error.message;
+    }
+    const e = error;
+    if (typeof e?.message === 'string' && e.message.trim().length > 0) {
+        return e.message;
+    }
+    if (typeof error === 'string' && error.trim().length > 0) {
+        return error;
+    }
+    return fallback;
+};
+//# sourceMappingURL=get-error-message.js.map

package/build/utils/get-error-message.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-error-message.js","sourceRoot":"","sources":["../../src/utils/get-error-message.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAC3E,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,KAAc,EAAE,QAAQ,GAAG,eAAe,EAAU,EAAE;IACpF,IAAI,iBAAiB,CAAC,KAAK,CAAC,EAAE,CAAC;QAC7B,MAAM,MAAM,GACV,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,KAAK,mBAAmB,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QAClF,MAAM,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QACjE,OAAO,GAAG,MAAM,GAAG,KAAK,CAAC,OAAO,GAAG,SAAS,EAAE,CAAC;IACjD,CAAC;IAED,IAAI,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9D,OAAO,KAAK,CAAC,OAAO,CAAC;IACvB,CAAC;IAED,MAAM,CAAC,GAAG,KAA6B,CAAC;IACxC,IAAI,OAAO,CAAC,EAAE,OAAO,KAAK,QAAQ,IAAI,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAClE,OAAO,CAAC,CAAC,OAAO,CAAC;IACnB,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC,CAAC","sourcesContent":["import { AppleMusicErrorCode } from '../constants/apple-music-error-codes';\nimport { isAppleMusicError } from './apple-music-error';\n\nexport const getErrorMessage = (error: unknown, fallback = 'Unknown error'): string => {\n  if (isAppleMusicError(error)) {\n    const prefix =\n      error.code && error.code !== AppleMusicErrorCode.error ? `${error.code}: ` : '';\n    const operation = error.operation ? ` (${error.operation})` : '';\n    return `${prefix}${error.message}${operation}`;\n  }\n\n  if (error instanceof Error && error.message.trim().length > 0) {\n    return error.message;\n  }\n\n  const e = error as { message?: string };\n  if (typeof e?.message === 'string' && e.message.trim().length > 0) {\n    return e.message;\n  }\n\n  if (typeof error === 'string' && error.trim().length > 0) {\n    return error;\n  }\n\n  return fallback;\n};\n"]}

package/build/utils/is-library-item.d.ts

@@ -0,0 +1,2 @@
+export declare const isLibraryItem: (id: string) => boolean;
+//# sourceMappingURL=is-library-item.d.ts.map

package/build/utils/is-library-item.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-library-item.d.ts","sourceRoot":"","sources":["../../src/utils/is-library-item.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,aAAa,GAAI,IAAI,MAAM,KAAG,OAED,CAAC"}

package/build/utils/is-library-item.js

@@ -0,0 +1,4 @@
+export const isLibraryItem = (id) => 
+// Library items typically start with 'i.' or 'l.' or contain non-numeric characters
+/^[a-z]\./.test(id) || !/^\d+$/.test(id);
+//# sourceMappingURL=is-library-item.js.map

package/build/utils/is-library-item.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-library-item.js","sourceRoot":"","sources":["../../src/utils/is-library-item.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,EAAU,EAAW,EAAE;AACnD,oFAAoF;AACpF,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC","sourcesContent":["export const isLibraryItem = (id: string): boolean =>\n  // Library items typically start with 'i.' or 'l.' or contain non-numeric characters\n  /^[a-z]\\./.test(id) || !/^\\d+$/.test(id);\n"]}

package/build/utils/normalize-resource-ids.d.ts

@@ -0,0 +1,4 @@
+import type { ResourceIds } from '../types/rating';
+/** Drops empty type keys before sending to native REST helpers. */
+export declare function normalizeResourceIds(resourceIds: ResourceIds): Record<string, string[]>;
+//# sourceMappingURL=normalize-resource-ids.d.ts.map

package/build/utils/normalize-resource-ids.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize-resource-ids.d.ts","sourceRoot":"","sources":["../../src/utils/normalize-resource-ids.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEnD,mEAAmE;AACnE,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CASvF"}

package/build/utils/normalize-resource-ids.js

@@ -0,0 +1,12 @@
+/** Drops empty type keys before sending to native REST helpers. */
+export function normalizeResourceIds(resourceIds) {
+    const result = {};
+    for (const [type, ids] of Object.entries(resourceIds)) {
+        const filtered = ids?.filter((id) => id.length > 0) ?? [];
+        if (filtered.length > 0) {
+            result[type] = filtered;
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=normalize-resource-ids.js.map

package/build/utils/normalize-resource-ids.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize-resource-ids.js","sourceRoot":"","sources":["../../src/utils/normalize-resource-ids.ts"],"names":[],"mappings":"AAEA,mEAAmE;AACnE,MAAM,UAAU,oBAAoB,CAAC,WAAwB;IAC3D,MAAM,MAAM,GAA6B,EAAE,CAAC;IAC5C,KAAK,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;QACtD,MAAM,QAAQ,GAAG,GAAG,EAAE,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;QAC1D,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxB,MAAM,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC;QAC1B,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC","sourcesContent":["import type { ResourceIds } from '../types/rating';\n\n/** Drops empty type keys before sending to native REST helpers. */\nexport function normalizeResourceIds(resourceIds: ResourceIds): Record<string, string[]> {\n  const result: Record<string, string[]> = {};\n  for (const [type, ids] of Object.entries(resourceIds)) {\n    const filtered = ids?.filter((id) => id.length > 0) ?? [];\n    if (filtered.length > 0) {\n      result[type] = filtered;\n    }\n  }\n  return result;\n}\n"]}

package/build/web/MusicKitLoader.d.ts

@@ -0,0 +1,11 @@
+import type { MusicKitInstance } from './musickit-types';
+export declare function getStoredDeveloperToken(): string | null;
+export declare function configureMusicKit(token: string): Promise<MusicKitInstance>;
+export declare function isMusicKitConfigured(): boolean;
+/** Returns null when `authorize()` has not configured MusicKit yet (or configure failed). */
+export declare function getMusicIfConfigured(): Promise<MusicKitInstance | null>;
+export declare function getMusic(): Promise<MusicKitInstance>;
+/** Prefer after `authorize()` — MusicKit may update the singleton instance in place. */
+export declare function getMusicKitInstance(): Promise<MusicKitInstance>;
+export declare function resetMusicKitForTests(): void;
+//# sourceMappingURL=MusicKitLoader.d.ts.map

package/build/web/MusicKitLoader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MusicKitLoader.d.ts","sourceRoot":"","sources":["../../src/web/MusicKitLoader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAkB,MAAM,kBAAkB,CAAC;AAmFzE,wBAAgB,uBAAuB,IAAI,MAAM,GAAG,IAAI,CAEvD;AAED,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA6BhF;AAED,wBAAgB,oBAAoB,IAAI,OAAO,CAE9C;AAED,6FAA6F;AAC7F,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAS7E;AAED,wBAAsB,QAAQ,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAM1D;AAED,wFAAwF;AACxF,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAOrE;AAED,wBAAgB,qBAAqB,IAAI,IAAI,CAG5C"}

package/build/web/MusicKitLoader.js

@@ -0,0 +1,135 @@
+const MUSIC_KIT_SCRIPT = 'https://js-cdn.music.apple.com/musickit/v3/musickit.js';
+const MUSIC_KIT_LOADED_EVENT = 'musickitloaded';
+let configurePromise = null;
+let configuredToken = null;
+function assertBrowser() {
+    if (typeof window === 'undefined') {
+        throw new Error('Apple Music web APIs require a browser environment');
+    }
+}
+/**
+ * Expo / Metro define `process.env` in the browser but often omit `process.versions`.
+ * MusicKit JS tests `null !== process.versions` (true when `versions` is `undefined`), then
+ * reads `process.versions.node` and throws. Force a null `versions` so it picks `window.Buffer`.
+ */
+function patchProcessForMusicKit() {
+    if (typeof process === 'undefined') {
+        return;
+    }
+    if (process.versions == null) {
+        // Intentionally null — see docstring above.
+        Object.assign(process, { versions: null });
+    }
+}
+function waitForMusicKitLoaded() {
+    return new Promise((resolve, reject) => {
+        const onLoaded = () => {
+            cleanup();
+            resolve();
+        };
+        const onError = () => {
+            cleanup();
+            reject(new Error('MusicKit JS failed to load'));
+        };
+        const cleanup = () => {
+            document.removeEventListener(MUSIC_KIT_LOADED_EVENT, onLoaded);
+            document.removeEventListener('musickiterror', onError);
+        };
+        document.addEventListener(MUSIC_KIT_LOADED_EVENT, onLoaded, { once: true });
+        document.addEventListener('musickiterror', onError, { once: true });
+        // Script may have fired the event before we subscribed.
+        if (window.MusicKit?.configure) {
+            cleanup();
+            resolve();
+        }
+    });
+}
+async function loadMusicKitScript() {
+    assertBrowser();
+    patchProcessForMusicKit();
+    if (window.MusicKit?.configure) {
+        return window.MusicKit;
+    }
+    const existing = document.querySelector(`script[src="${MUSIC_KIT_SCRIPT}"]`);
+    if (!existing) {
+        await new Promise((resolve, reject) => {
+            const script = document.createElement('script');
+            script.src = MUSIC_KIT_SCRIPT;
+            script.async = true;
+            script.onload = () => resolve();
+            script.onerror = () => reject(new Error('MusicKit JS failed to load'));
+            document.head.appendChild(script);
+        });
+    }
+    await waitForMusicKitLoaded();
+    if (!window.MusicKit?.configure) {
+        throw new Error('MusicKit JS is unavailable after script load');
+    }
+    return window.MusicKit;
+}
+export function getStoredDeveloperToken() {
+    return configuredToken;
+}
+export async function configureMusicKit(token) {
+    assertBrowser();
+    const trimmed = token.trim();
+    const tokenChanged = configuredToken !== null && configuredToken !== trimmed;
+    configuredToken = trimmed;
+    if (configurePromise && tokenChanged) {
+        configurePromise = null;
+    }
+    if (!configurePromise) {
+        configurePromise = (async () => {
+            const MusicKit = await loadMusicKitScript();
+            await MusicKit.configure({
+                developerToken: trimmed,
+                app: {
+                    name: 'Expo Apple Music',
+                    build: '0.1.0',
+                },
+            });
+            const instance = MusicKit.getInstance();
+            if (!instance) {
+                throw new Error('MusicKit JS did not return an instance after configure()');
+            }
+            return instance;
+        })();
+    }
+    return configurePromise;
+}
+export function isMusicKitConfigured() {
+    return configurePromise !== null;
+}
+/** Returns null when `authorize()` has not configured MusicKit yet (or configure failed). */
+export async function getMusicIfConfigured() {
+    if (!configurePromise) {
+        return null;
+    }
+    try {
+        return await configurePromise;
+    }
+    catch {
+        return null;
+    }
+}
+export async function getMusic() {
+    const music = await getMusicIfConfigured();
+    if (!music) {
+        throw new Error('MusicKit is not configured. Call Auth.authorize(developerToken) first.');
+    }
+    return music;
+}
+/** Prefer after `authorize()` — MusicKit may update the singleton instance in place. */
+export async function getMusicKitInstance() {
+    const MusicKit = await loadMusicKitScript();
+    const instance = MusicKit.getInstance();
+    if (!instance) {
+        throw new Error('MusicKit JS did not return an instance');
+    }
+    return instance;
+}
+export function resetMusicKitForTests() {
+    configurePromise = null;
+    configuredToken = null;
+}
+//# sourceMappingURL=MusicKitLoader.js.map

package/build/web/MusicKitLoader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MusicKitLoader.js","sourceRoot":"","sources":["../../src/web/MusicKitLoader.ts"],"names":[],"mappings":"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","sourcesContent":["import type { MusicKitInstance, MusicKitStatic } from './musickit-types';\n\nconst MUSIC_KIT_SCRIPT = 'https://js-cdn.music.apple.com/musickit/v3/musickit.js';\nconst MUSIC_KIT_LOADED_EVENT = 'musickitloaded';\n\nlet configurePromise: Promise<MusicKitInstance> | null = null;\nlet configuredToken: string | null = null;\n\nfunction assertBrowser(): void {\n  if (typeof window === 'undefined') {\n    throw new Error('Apple Music web APIs require a browser environment');\n  }\n}\n\n/**\n * Expo / Metro define `process.env` in the browser but often omit `process.versions`.\n * MusicKit JS tests `null !== process.versions` (true when `versions` is `undefined`), then\n * reads `process.versions.node` and throws. Force a null `versions` so it picks `window.Buffer`.\n */\nfunction patchProcessForMusicKit(): void {\n  if (typeof process === 'undefined') {\n    return;\n  }\n  if (process.versions == null) {\n    // Intentionally null — see docstring above.\n    Object.assign(process, { versions: null });\n  }\n}\n\nfunction waitForMusicKitLoaded(): Promise<void> {\n  return new Promise((resolve, reject) => {\n    const onLoaded = () => {\n      cleanup();\n      resolve();\n    };\n    const onError = () => {\n      cleanup();\n      reject(new Error('MusicKit JS failed to load'));\n    };\n    const cleanup = () => {\n      document.removeEventListener(MUSIC_KIT_LOADED_EVENT, onLoaded);\n      document.removeEventListener('musickiterror', onError);\n    };\n\n    document.addEventListener(MUSIC_KIT_LOADED_EVENT, onLoaded, { once: true });\n    document.addEventListener('musickiterror', onError, { once: true });\n\n    // Script may have fired the event before we subscribed.\n    if (window.MusicKit?.configure) {\n      cleanup();\n      resolve();\n    }\n  });\n}\n\nasync function loadMusicKitScript(): Promise<MusicKitStatic> {\n  assertBrowser();\n  patchProcessForMusicKit();\n\n  if (window.MusicKit?.configure) {\n    return window.MusicKit;\n  }\n\n  const existing = document.querySelector(`script[src=\"${MUSIC_KIT_SCRIPT}\"]`);\n  if (!existing) {\n    await new Promise<void>((resolve, reject) => {\n      const script = document.createElement('script');\n      script.src = MUSIC_KIT_SCRIPT;\n      script.async = true;\n      script.onload = () => resolve();\n      script.onerror = () => reject(new Error('MusicKit JS failed to load'));\n      document.head.appendChild(script);\n    });\n  }\n\n  await waitForMusicKitLoaded();\n\n  if (!window.MusicKit?.configure) {\n    throw new Error('MusicKit JS is unavailable after script load');\n  }\n  return window.MusicKit;\n}\n\nexport function getStoredDeveloperToken(): string | null {\n  return configuredToken;\n}\n\nexport async function configureMusicKit(token: string): Promise<MusicKitInstance> {\n  assertBrowser();\n  const trimmed = token.trim();\n  const tokenChanged = configuredToken !== null && configuredToken !== trimmed;\n  configuredToken = trimmed;\n\n  if (configurePromise && tokenChanged) {\n    configurePromise = null;\n  }\n\n  if (!configurePromise) {\n    configurePromise = (async () => {\n      const MusicKit = await loadMusicKitScript();\n      await MusicKit.configure({\n        developerToken: trimmed,\n        app: {\n          name: 'Expo Apple Music',\n          build: '0.1.0',\n        },\n      });\n      const instance = MusicKit.getInstance();\n      if (!instance) {\n        throw new Error('MusicKit JS did not return an instance after configure()');\n      }\n      return instance;\n    })();\n  }\n\n  return configurePromise;\n}\n\nexport function isMusicKitConfigured(): boolean {\n  return configurePromise !== null;\n}\n\n/** Returns null when `authorize()` has not configured MusicKit yet (or configure failed). */\nexport async function getMusicIfConfigured(): Promise<MusicKitInstance | null> {\n  if (!configurePromise) {\n    return null;\n  }\n  try {\n    return await configurePromise;\n  } catch {\n    return null;\n  }\n}\n\nexport async function getMusic(): Promise<MusicKitInstance> {\n  const music = await getMusicIfConfigured();\n  if (!music) {\n    throw new Error('MusicKit is not configured. Call Auth.authorize(developerToken) first.');\n  }\n  return music;\n}\n\n/** Prefer after `authorize()` — MusicKit may update the singleton instance in place. */\nexport async function getMusicKitInstance(): Promise<MusicKitInstance> {\n  const MusicKit = await loadMusicKitScript();\n  const instance = MusicKit.getInstance();\n  if (!instance) {\n    throw new Error('MusicKit JS did not return an instance');\n  }\n  return instance;\n}\n\nexport function resetMusicKitForTests(): void {\n  configurePromise = null;\n  configuredToken = null;\n}\n"]}