@wwdrew/expo-apple-music 1.0.0

package/build/rest/library-mutations-rest-client.js

@@ -0,0 +1,37 @@
+import { mapPlaylist } from '../mappers/apple-music-json-mapper';
+import * as errors from '../web/apple-music-errors';
+import { buildIdsQuery } from './resource-ids-query';
+/** Library write/mutation Apple Music REST. */
+export class LibraryMutationsRestClient {
+    transport;
+    constructor(transport) {
+        this.transport = transport;
+    }
+    async addToLibrary(musicUserToken, resourceIds) {
+        await this.transport.request('POST', '/v1/me/library', buildIdsQuery(resourceIds), undefined, musicUserToken);
+    }
+    async createLibraryPlaylist(musicUserToken, name, description, isPublic, tracks) {
+        const attributes = { name, isPublic };
+        if (description?.trim()) {
+            attributes.description = { standard: description };
+        }
+        const payload = { attributes };
+        if (tracks?.length) {
+            payload.relationships = {
+                tracks: {
+                    data: tracks.map((track) => ({ id: track.id, type: track.type })),
+                },
+            };
+        }
+        const json = await this.transport.request('POST', '/v1/me/library/playlists', {}, payload, musicUserToken);
+        const data = Array.isArray(json.data) ? json.data[0] : null;
+        if (!data) {
+            throw errors.apiError('Create playlist returned no data');
+        }
+        return mapPlaylist(data);
+    }
+    async addTracksToLibraryPlaylist(musicUserToken, playlistId, tracks) {
+        await this.transport.request('POST', `/v1/me/library/playlists/${playlistId}/tracks`, {}, { data: tracks.map((track) => ({ id: track.id, type: track.type })) }, musicUserToken);
+    }
+}
+//# sourceMappingURL=library-mutations-rest-client.js.map

package/build/rest/library-mutations-rest-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"library-mutations-rest-client.js","sourceRoot":"","sources":["../../src/rest/library-mutations-rest-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAA8B,MAAM,oCAAoC,CAAC;AAC7F,OAAO,KAAK,MAAM,MAAM,2BAA2B,CAAC;AAEpD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD,+CAA+C;AAC/C,MAAM,OAAO,0BAA0B;IACR;IAA7B,YAA6B,SAAkC;QAAlC,cAAS,GAAT,SAAS,CAAyB;IAAG,CAAC;IAEnE,KAAK,CAAC,YAAY,CAAC,cAAsB,EAAE,WAAqC;QAC9E,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,EAAE,gBAAgB,EAAE,aAAa,CAAC,WAAW,CAAC,EAAE,SAAS,EAAE,cAAc,CAAC,CAAC;IAChH,CAAC;IAED,KAAK,CAAC,qBAAqB,CACzB,cAAsB,EACtB,IAAY,EACZ,WAA0B,EAC1B,QAAiB,EACjB,MAA6C;QAE7C,MAAM,UAAU,GAA4B,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;QAC/D,IAAI,WAAW,EAAE,IAAI,EAAE,EAAE,CAAC;YACxB,UAAU,CAAC,WAAW,GAAG,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC;QACrD,CAAC;QACD,MAAM,OAAO,GAA4B,EAAE,UAAU,EAAE,CAAC;QACxD,IAAI,MAAM,EAAE,MAAM,EAAE,CAAC;YACnB,OAAO,CAAC,aAAa,GAAG;gBACtB,MAAM,EAAE;oBACN,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;iBAClE;aACF,CAAC;QACJ,CAAC;QACD,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,CACvC,MAAM,EACN,0BAA0B,EAC1B,EAAE,EACF,OAAO,EACP,cAAc,CACf,CAAC;QACF,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAC5D,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,MAAM,CAAC,QAAQ,CAAC,kCAAkC,CAAC,CAAC;QAC5D,CAAC;QACD,OAAO,WAAW,CAAC,IAA6B,CAAC,CAAC;IACpD,CAAC;IAED,KAAK,CAAC,0BAA0B,CAC9B,cAAsB,EACtB,UAAkB,EAClB,MAAsC;QAEtC,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,CAC1B,MAAM,EACN,4BAA4B,UAAU,SAAS,EAC/C,EAAE,EACF,EAAE,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,EACrE,cAAc,CACf,CAAC;IACJ,CAAC;CACF","sourcesContent":["import { mapPlaylist, type AppleMusicApiResource } from '../mappers/apple-music-json-mapper';\nimport * as errors from '../web/apple-music-errors';\nimport type { AppleMusicRestTransport } from './apple-music-rest-transport';\nimport { buildIdsQuery } from './resource-ids-query';\n\n/** Library write/mutation Apple Music REST. */\nexport class LibraryMutationsRestClient {\n  constructor(private readonly transport: AppleMusicRestTransport) {}\n\n  async addToLibrary(musicUserToken: string, resourceIds: Record<string, string[]>) {\n    await this.transport.request('POST', '/v1/me/library', buildIdsQuery(resourceIds), undefined, musicUserToken);\n  }\n\n  async createLibraryPlaylist(\n    musicUserToken: string,\n    name: string,\n    description: string | null,\n    isPublic: boolean,\n    tracks: { id: string; type: string }[] | null,\n  ) {\n    const attributes: Record<string, unknown> = { name, isPublic };\n    if (description?.trim()) {\n      attributes.description = { standard: description };\n    }\n    const payload: Record<string, unknown> = { attributes };\n    if (tracks?.length) {\n      payload.relationships = {\n        tracks: {\n          data: tracks.map((track) => ({ id: track.id, type: track.type })),\n        },\n      };\n    }\n    const json = await this.transport.request(\n      'POST',\n      '/v1/me/library/playlists',\n      {},\n      payload,\n      musicUserToken,\n    );\n    const data = Array.isArray(json.data) ? json.data[0] : null;\n    if (!data) {\n      throw errors.apiError('Create playlist returned no data');\n    }\n    return mapPlaylist(data as AppleMusicApiResource);\n  }\n\n  async addTracksToLibraryPlaylist(\n    musicUserToken: string,\n    playlistId: string,\n    tracks: { id: string; type: string }[],\n  ) {\n    await this.transport.request(\n      'POST',\n      `/v1/me/library/playlists/${playlistId}/tracks`,\n      {},\n      { data: tracks.map((track) => ({ id: track.id, type: track.type })) },\n      musicUserToken,\n    );\n  }\n}\n"]}

package/build/rest/library-rest-client.d.ts

@@ -0,0 +1,59 @@
+import type { LibrarySearchType } from '../types/library-search';
+import type { AppleMusicRestTransport } from './apple-music-rest-transport';
+export type LibrarySearchResult = {
+    songs: Record<string, unknown>[];
+    albums: Record<string, unknown>[];
+    artists: Record<string, unknown>[];
+    playlists: Record<string, unknown>[];
+    musicVideos: Record<string, unknown>[];
+};
+/** Library-domain Apple Music REST (user collection reads + playback id resolution). */
+export declare class LibraryRestClient {
+    private readonly transport;
+    constructor(transport: AppleMusicRestTransport);
+    getLibraryPlaylists(musicUserToken: string, limit: number, offset: number): Promise<{
+        id: string;
+        name: string;
+        description: string;
+        artworkUrl: string;
+        trackCount: number;
+    }[]>;
+    getLibrarySongs(musicUserToken: string, limit: number, offset: number): Promise<{
+        id: string;
+        title: string;
+        artistName: string;
+        artworkUrl: string;
+        duration: number;
+    }[]>;
+    getPlaylistTracks(musicUserToken: string, playlistId: string): Promise<{
+        id: string;
+        title: string;
+        artistName: string;
+        artworkUrl: string;
+        duration: number;
+    }[]>;
+    getLibraryArtists(musicUserToken: string, limit: number, offset: number): Promise<{
+        id: string;
+        name: string;
+        artworkUrl: string;
+    }[]>;
+    getLibraryAlbums(musicUserToken: string, limit: number, offset: number): Promise<{
+        id: string;
+        title: string;
+        artistName: string;
+        artworkUrl: string;
+        trackCount: number;
+    }[]>;
+    getLibraryMusicVideos(musicUserToken: string, limit: number, offset: number): Promise<{
+        id: string;
+        title: string;
+        artistName: string;
+        artworkUrl: string;
+        duration: number;
+    }[]>;
+    searchLibrary(musicUserToken: string, term: string, types: LibrarySearchType[], limit: number, offset: number): Promise<LibrarySearchResult>;
+    probeLibraryAccess(musicUserToken: string): Promise<boolean>;
+    resolveCatalogPlaybackId(musicUserToken: string, libraryId: string, mediaType: string): Promise<string>;
+    resolveLibrarySongCatalogIds(musicUserToken: string, playlistId: string): Promise<string[]>;
+}
+//# sourceMappingURL=library-rest-client.d.ts.map

package/build/rest/library-rest-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"library-rest-client.d.ts","sourceRoot":"","sources":["../../src/rest/library-rest-client.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAEjE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAG5E,MAAM,MAAM,mBAAmB,GAAG;IAChC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IACjC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IAClC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IACnC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IACrC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;CACxC,CAAC;AAyBF,wFAAwF;AACxF,qBAAa,iBAAiB;IAChB,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAAT,SAAS,EAAE,uBAAuB;IAEzD,mBAAmB,CAAC,cAAc,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;;;;;;;IAQzE,eAAe,CAAC,cAAc,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;;;;;;;IAQrE,iBAAiB,CAAC,cAAc,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM;;;;;;;IAY5D,iBAAiB,CAAC,cAAc,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;;;;;IAQvE,gBAAgB,CAAC,cAAc,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;;;;;;;IAQtE,qBAAqB,CAAC,cAAc,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;;;;;;;IAQ3E,aAAa,CACjB,cAAc,EAAE,MAAM,EACtB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,iBAAiB,EAAE,EAC1B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,mBAAmB,CAAC;IAuBzB,kBAAkB,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAS5D,wBAAwB,CAAC,cAAc,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAyBvG,4BAA4B,CAAC,cAAc,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;CAoBlG"}

package/build/rest/library-rest-client.js

@@ -0,0 +1,141 @@
+import { catalogPlaybackId, mapAlbum, mapArtist, mapMusicVideo, mapPlaylist, mapSong, } from '../mappers/apple-music-json-mapper';
+import * as errors from '../web/apple-music-errors';
+import { mapResourceArray, mapTopLevelResourceArray, parseDataArray } from './rest-json';
+function librarySearchTypeParam(type) {
+    switch (type) {
+        case 'library-songs':
+        case 'songs':
+            return 'library-songs';
+        case 'library-albums':
+        case 'albums':
+            return 'library-albums';
+        case 'library-artists':
+        case 'artists':
+            return 'library-artists';
+        case 'library-playlists':
+        case 'playlists':
+            return 'library-playlists';
+        case 'library-music-videos':
+        case 'music-videos':
+        case 'musicVideos':
+            return 'library-music-videos';
+        default:
+            return null;
+    }
+}
+/** Library-domain Apple Music REST (user collection reads + playback id resolution). */
+export class LibraryRestClient {
+    transport;
+    constructor(transport) {
+        this.transport = transport;
+    }
+    async getLibraryPlaylists(musicUserToken, limit, offset) {
+        const json = await this.transport.getJson('/v1/me/library/playlists', {
+            limit: String(limit),
+            offset: String(offset),
+        }, musicUserToken);
+        return mapTopLevelResourceArray(json.data, mapPlaylist);
+    }
+    async getLibrarySongs(musicUserToken, limit, offset) {
+        const json = await this.transport.getJson('/v1/me/library/songs', {
+            limit: String(limit),
+            offset: String(offset),
+        }, musicUserToken);
+        return mapTopLevelResourceArray(json.data, mapSong);
+    }
+    async getPlaylistTracks(musicUserToken, playlistId) {
+        const json = await this.transport.getJson(`/v1/me/library/playlists/${playlistId}/tracks`, {}, musicUserToken);
+        const data = parseDataArray(json.data);
+        return data
+            .filter((item) => String(item.type ?? '').includes('song'))
+            .map((item) => mapSong(item));
+    }
+    async getLibraryArtists(musicUserToken, limit, offset) {
+        const json = await this.transport.getJson('/v1/me/library/artists', {
+            limit: String(limit),
+            offset: String(offset),
+        }, musicUserToken);
+        return mapTopLevelResourceArray(json.data, mapArtist);
+    }
+    async getLibraryAlbums(musicUserToken, limit, offset) {
+        const json = await this.transport.getJson('/v1/me/library/albums', {
+            limit: String(limit),
+            offset: String(offset),
+        }, musicUserToken);
+        return mapTopLevelResourceArray(json.data, mapAlbum);
+    }
+    async getLibraryMusicVideos(musicUserToken, limit, offset) {
+        const json = await this.transport.getJson('/v1/me/library/music-videos', {
+            limit: String(limit),
+            offset: String(offset),
+        }, musicUserToken);
+        return mapTopLevelResourceArray(json.data, mapMusicVideo);
+    }
+    async searchLibrary(musicUserToken, term, types, limit, offset) {
+        const typeParam = [...new Set(types.map(librarySearchTypeParam).filter(Boolean))].sort().join(',');
+        const typesQuery = typeParam || 'library-songs,library-albums';
+        const json = await this.transport.getJson('/v1/me/library/search', {
+            term,
+            types: typesQuery,
+            limit: String(limit),
+            offset: String(offset),
+        }, musicUserToken);
+        const results = (json.results ?? {});
+        return {
+            songs: mapResourceArray(results['library-songs']?.data, mapSong),
+            albums: mapResourceArray(results['library-albums']?.data, mapAlbum),
+            artists: mapResourceArray(results['library-artists']?.data, mapArtist),
+            playlists: mapResourceArray(results['library-playlists']?.data, mapPlaylist),
+            musicVideos: mapResourceArray(results['library-music-videos']?.data, mapMusicVideo),
+        };
+    }
+    async probeLibraryAccess(musicUserToken) {
+        try {
+            await this.transport.getJson('/v1/me/library/songs', { limit: '1' }, musicUserToken);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async resolveCatalogPlaybackId(musicUserToken, libraryId, mediaType) {
+        const path = mediaType === 'song'
+            ? `/v1/me/library/songs/${libraryId}`
+            : mediaType === 'album'
+                ? `/v1/me/library/albums/${libraryId}`
+                : mediaType === 'playlist'
+                    ? `/v1/me/library/playlists/${libraryId}`
+                    : null;
+        if (!path) {
+            throw errors.unknownMediaType(mediaType);
+        }
+        const json = await this.transport.getJson(path, {}, musicUserToken);
+        const rows = parseDataArray(json.data);
+        const data = rows[0];
+        if (!data) {
+            throw errors.itemNotFound(mediaType, true);
+        }
+        const catalogId = catalogPlaybackId(data);
+        if (!catalogId) {
+            throw errors.itemNotFound(mediaType, true);
+        }
+        return catalogId;
+    }
+    async resolveLibrarySongCatalogIds(musicUserToken, playlistId) {
+        const json = await this.transport.getJson(`/v1/me/library/playlists/${playlistId}/tracks`, {}, musicUserToken);
+        const data = parseDataArray(json.data);
+        const ids = [];
+        for (const item of data) {
+            const resource = item;
+            if (!String(resource.type ?? '').includes('song')) {
+                continue;
+            }
+            const catalogId = catalogPlaybackId(resource);
+            if (catalogId) {
+                ids.push(catalogId);
+            }
+        }
+        return ids;
+    }
+}
+//# sourceMappingURL=library-rest-client.js.map

package/build/rest/library-rest-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"library-rest-client.js","sourceRoot":"","sources":["../../src/rest/library-rest-client.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  catalogPlaybackId,\n  mapAlbum,\n  mapArtist,\n  mapMusicVideo,\n  mapPlaylist,\n  mapSong,\n  type AppleMusicApiResource,\n} from '../mappers/apple-music-json-mapper';\nimport type { LibrarySearchType } from '../types/library-search';\nimport * as errors from '../web/apple-music-errors';\nimport type { AppleMusicRestTransport } from './apple-music-rest-transport';\nimport { mapResourceArray, mapTopLevelResourceArray, parseDataArray } from './rest-json';\n\nexport type LibrarySearchResult = {\n  songs: Record<string, unknown>[];\n  albums: Record<string, unknown>[];\n  artists: Record<string, unknown>[];\n  playlists: Record<string, unknown>[];\n  musicVideos: Record<string, unknown>[];\n};\n\nfunction librarySearchTypeParam(type: string): string | null {\n  switch (type) {\n    case 'library-songs':\n    case 'songs':\n      return 'library-songs';\n    case 'library-albums':\n    case 'albums':\n      return 'library-albums';\n    case 'library-artists':\n    case 'artists':\n      return 'library-artists';\n    case 'library-playlists':\n    case 'playlists':\n      return 'library-playlists';\n    case 'library-music-videos':\n    case 'music-videos':\n    case 'musicVideos':\n      return 'library-music-videos';\n    default:\n      return null;\n  }\n}\n\n/** Library-domain Apple Music REST (user collection reads + playback id resolution). */\nexport class LibraryRestClient {\n  constructor(private readonly transport: AppleMusicRestTransport) {}\n\n  async getLibraryPlaylists(musicUserToken: string, limit: number, offset: number) {\n    const json = await this.transport.getJson('/v1/me/library/playlists', {\n      limit: String(limit),\n      offset: String(offset),\n    }, musicUserToken);\n    return mapTopLevelResourceArray(json.data, mapPlaylist);\n  }\n\n  async getLibrarySongs(musicUserToken: string, limit: number, offset: number) {\n    const json = await this.transport.getJson('/v1/me/library/songs', {\n      limit: String(limit),\n      offset: String(offset),\n    }, musicUserToken);\n    return mapTopLevelResourceArray(json.data, mapSong);\n  }\n\n  async getPlaylistTracks(musicUserToken: string, playlistId: string) {\n    const json = await this.transport.getJson(\n      `/v1/me/library/playlists/${playlistId}/tracks`,\n      {},\n      musicUserToken,\n    );\n    const data = parseDataArray(json.data);\n    return data\n      .filter((item) => String((item as AppleMusicApiResource).type ?? '').includes('song'))\n      .map((item) => mapSong(item as AppleMusicApiResource));\n  }\n\n  async getLibraryArtists(musicUserToken: string, limit: number, offset: number) {\n    const json = await this.transport.getJson('/v1/me/library/artists', {\n      limit: String(limit),\n      offset: String(offset),\n    }, musicUserToken);\n    return mapTopLevelResourceArray(json.data, mapArtist);\n  }\n\n  async getLibraryAlbums(musicUserToken: string, limit: number, offset: number) {\n    const json = await this.transport.getJson('/v1/me/library/albums', {\n      limit: String(limit),\n      offset: String(offset),\n    }, musicUserToken);\n    return mapTopLevelResourceArray(json.data, mapAlbum);\n  }\n\n  async getLibraryMusicVideos(musicUserToken: string, limit: number, offset: number) {\n    const json = await this.transport.getJson('/v1/me/library/music-videos', {\n      limit: String(limit),\n      offset: String(offset),\n    }, musicUserToken);\n    return mapTopLevelResourceArray(json.data, mapMusicVideo);\n  }\n\n  async searchLibrary(\n    musicUserToken: string,\n    term: string,\n    types: LibrarySearchType[],\n    limit: number,\n    offset: number,\n  ): Promise<LibrarySearchResult> {\n    const typeParam = [...new Set(types.map(librarySearchTypeParam).filter(Boolean))].sort().join(\n      ',',\n    );\n    const typesQuery = typeParam || 'library-songs,library-albums';\n\n    const json = await this.transport.getJson('/v1/me/library/search', {\n      term,\n      types: typesQuery,\n      limit: String(limit),\n      offset: String(offset),\n    }, musicUserToken);\n\n    const results = (json.results ?? {}) as Record<string, { data?: AppleMusicApiResource[] }>;\n    return {\n      songs: mapResourceArray(results['library-songs']?.data, mapSong),\n      albums: mapResourceArray(results['library-albums']?.data, mapAlbum),\n      artists: mapResourceArray(results['library-artists']?.data, mapArtist),\n      playlists: mapResourceArray(results['library-playlists']?.data, mapPlaylist),\n      musicVideos: mapResourceArray(results['library-music-videos']?.data, mapMusicVideo),\n    };\n  }\n\n  async probeLibraryAccess(musicUserToken: string): Promise<boolean> {\n    try {\n      await this.transport.getJson('/v1/me/library/songs', { limit: '1' }, musicUserToken);\n      return true;\n    } catch {\n      return false;\n    }\n  }\n\n  async resolveCatalogPlaybackId(musicUserToken: string, libraryId: string, mediaType: string): Promise<string> {\n    const path =\n      mediaType === 'song'\n        ? `/v1/me/library/songs/${libraryId}`\n        : mediaType === 'album'\n          ? `/v1/me/library/albums/${libraryId}`\n          : mediaType === 'playlist'\n            ? `/v1/me/library/playlists/${libraryId}`\n            : null;\n    if (!path) {\n      throw errors.unknownMediaType(mediaType);\n    }\n    const json = await this.transport.getJson(path, {}, musicUserToken);\n    const rows = parseDataArray(json.data);\n    const data = rows[0];\n    if (!data) {\n      throw errors.itemNotFound(mediaType, true);\n    }\n    const catalogId = catalogPlaybackId(data as AppleMusicApiResource);\n    if (!catalogId) {\n      throw errors.itemNotFound(mediaType, true);\n    }\n    return catalogId;\n  }\n\n  async resolveLibrarySongCatalogIds(musicUserToken: string, playlistId: string): Promise<string[]> {\n    const json = await this.transport.getJson(\n      `/v1/me/library/playlists/${playlistId}/tracks`,\n      {},\n      musicUserToken,\n    );\n    const data = parseDataArray(json.data);\n    const ids: string[] = [];\n    for (const item of data) {\n      const resource = item as AppleMusicApiResource;\n      if (!String(resource.type ?? '').includes('song')) {\n        continue;\n      }\n      const catalogId = catalogPlaybackId(resource);\n      if (catalogId) {\n        ids.push(catalogId);\n      }\n    }\n    return ids;\n  }\n}\n"]}

package/build/rest/ratings-rest-client.d.ts

@@ -0,0 +1,18 @@
+import type { AppleMusicRestTransport } from './apple-music-rest-transport';
+/** Ratings and favorites Apple Music REST. */
+export declare class RatingsRestClient {
+    private readonly transport;
+    constructor(transport: AppleMusicRestTransport);
+    getRating(musicUserToken: string, resourceType: string, id: string): Promise<{
+        id: string;
+        value: number;
+    } | null>;
+    setRating(musicUserToken: string, resourceType: string, id: string, value: number): Promise<{
+        id: string;
+        value: number;
+    } | null>;
+    clearRating(musicUserToken: string, resourceType: string, id: string): Promise<void>;
+    addToFavorites(musicUserToken: string, resourceIds: Record<string, string[]>): Promise<void>;
+    removeFromFavorites(musicUserToken: string, resourceIds: Record<string, string[]>): Promise<void>;
+}
+//# sourceMappingURL=ratings-rest-client.d.ts.map

package/build/rest/ratings-rest-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ratings-rest-client.d.ts","sourceRoot":"","sources":["../../src/rest/ratings-rest-client.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAG5E,8CAA8C;AAC9C,qBAAa,iBAAiB;IAChB,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAAT,SAAS,EAAE,uBAAuB;IAEzD,SAAS,CAAC,cAAc,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM;;;;IAiBlE,SAAS,CAAC,cAAc,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;;;;IAWjF,WAAW,CAAC,cAAc,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM;IAIpE,cAAc,CAAC,cAAc,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;IAI5E,mBAAmB,CAAC,cAAc,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;CAGxF"}

package/build/rest/ratings-rest-client.js

@@ -0,0 +1,37 @@
+import { mapRating } from '../mappers/apple-music-json-mapper';
+import { getErrorMessage } from '../utils/get-error-message';
+import { buildIdsQuery } from './resource-ids-query';
+/** Ratings and favorites Apple Music REST. */
+export class RatingsRestClient {
+    transport;
+    constructor(transport) {
+        this.transport = transport;
+    }
+    async getRating(musicUserToken, resourceType, id) {
+        try {
+            const json = await this.transport.getJson(`/v1/me/ratings/${resourceType}/${id}`, {}, musicUserToken);
+            return mapRating(json);
+        }
+        catch (error) {
+            const message = getErrorMessage(error);
+            if (message.includes('404')) {
+                return null;
+            }
+            throw error;
+        }
+    }
+    async setRating(musicUserToken, resourceType, id, value) {
+        const json = await this.transport.request('PUT', `/v1/me/ratings/${resourceType}/${id}`, {}, { type: 'rating', attributes: { value } }, musicUserToken);
+        return mapRating(json);
+    }
+    async clearRating(musicUserToken, resourceType, id) {
+        await this.transport.request('DELETE', `/v1/me/ratings/${resourceType}/${id}`, {}, undefined, musicUserToken);
+    }
+    async addToFavorites(musicUserToken, resourceIds) {
+        await this.transport.request('POST', '/v1/me/favorites', buildIdsQuery(resourceIds), undefined, musicUserToken);
+    }
+    async removeFromFavorites(musicUserToken, resourceIds) {
+        await this.transport.request('DELETE', '/v1/me/favorites', buildIdsQuery(resourceIds), undefined, musicUserToken);
+    }
+}
+//# sourceMappingURL=ratings-rest-client.js.map

package/build/rest/ratings-rest-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ratings-rest-client.js","sourceRoot":"","sources":["../../src/rest/ratings-rest-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,oCAAoC,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAE7D,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD,8CAA8C;AAC9C,MAAM,OAAO,iBAAiB;IACC;IAA7B,YAA6B,SAAkC;QAAlC,cAAS,GAAT,SAAS,CAAyB;IAAG,CAAC;IAEnE,KAAK,CAAC,SAAS,CAAC,cAAsB,EAAE,YAAoB,EAAE,EAAU;QACtE,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,CACvC,kBAAkB,YAAY,IAAI,EAAE,EAAE,EACtC,EAAE,EACF,cAAc,CACf,CAAC;YACF,OAAO,SAAS,CAAC,IAAuC,CAAC,CAAC;QAC5D,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,OAAO,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;YACvC,IAAI,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC5B,OAAO,IAAI,CAAC;YACd,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,cAAsB,EAAE,YAAoB,EAAE,EAAU,EAAE,KAAa;QACrF,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,CACvC,KAAK,EACL,kBAAkB,YAAY,IAAI,EAAE,EAAE,EACtC,EAAE,EACF,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,EAAE,EACzC,cAAc,CACf,CAAC;QACF,OAAO,SAAS,CAAC,IAAuC,CAAC,CAAC;IAC5D,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,cAAsB,EAAE,YAAoB,EAAE,EAAU;QACxE,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,QAAQ,EAAE,kBAAkB,YAAY,IAAI,EAAE,EAAE,EAAE,EAAE,EAAE,SAAS,EAAE,cAAc,CAAC,CAAC;IAChH,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,cAAsB,EAAE,WAAqC;QAChF,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,EAAE,kBAAkB,EAAE,aAAa,CAAC,WAAW,CAAC,EAAE,SAAS,EAAE,cAAc,CAAC,CAAC;IAClH,CAAC;IAED,KAAK,CAAC,mBAAmB,CAAC,cAAsB,EAAE,WAAqC;QACrF,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,QAAQ,EAAE,kBAAkB,EAAE,aAAa,CAAC,WAAW,CAAC,EAAE,SAAS,EAAE,cAAc,CAAC,CAAC;IACpH,CAAC;CACF","sourcesContent":["import { mapRating } from '../mappers/apple-music-json-mapper';\nimport { getErrorMessage } from '../utils/get-error-message';\nimport type { AppleMusicRestTransport } from './apple-music-rest-transport';\nimport { buildIdsQuery } from './resource-ids-query';\n\n/** Ratings and favorites Apple Music REST. */\nexport class RatingsRestClient {\n  constructor(private readonly transport: AppleMusicRestTransport) {}\n\n  async getRating(musicUserToken: string, resourceType: string, id: string) {\n    try {\n      const json = await this.transport.getJson(\n        `/v1/me/ratings/${resourceType}/${id}`,\n        {},\n        musicUserToken,\n      );\n      return mapRating(json as Parameters<typeof mapRating>[0]);\n    } catch (error) {\n      const message = getErrorMessage(error);\n      if (message.includes('404')) {\n        return null;\n      }\n      throw error;\n    }\n  }\n\n  async setRating(musicUserToken: string, resourceType: string, id: string, value: number) {\n    const json = await this.transport.request(\n      'PUT',\n      `/v1/me/ratings/${resourceType}/${id}`,\n      {},\n      { type: 'rating', attributes: { value } },\n      musicUserToken,\n    );\n    return mapRating(json as Parameters<typeof mapRating>[0]);\n  }\n\n  async clearRating(musicUserToken: string, resourceType: string, id: string) {\n    await this.transport.request('DELETE', `/v1/me/ratings/${resourceType}/${id}`, {}, undefined, musicUserToken);\n  }\n\n  async addToFavorites(musicUserToken: string, resourceIds: Record<string, string[]>) {\n    await this.transport.request('POST', '/v1/me/favorites', buildIdsQuery(resourceIds), undefined, musicUserToken);\n  }\n\n  async removeFromFavorites(musicUserToken: string, resourceIds: Record<string, string[]>) {\n    await this.transport.request('DELETE', '/v1/me/favorites', buildIdsQuery(resourceIds), undefined, musicUserToken);\n  }\n}\n"]}

package/build/rest/recommendations-rest-client.d.ts

@@ -0,0 +1,32 @@
+import type { AppleMusicRestTransport } from './apple-music-rest-transport';
+/** Recommendations and Replay Apple Music REST. */
+export declare class RecommendationsRestClient {
+    private readonly transport;
+    constructor(transport: AppleMusicRestTransport);
+    getRecommendations(musicUserToken: string, ids: string[] | null): Promise<{
+        id: string;
+        title: string;
+        resourceTypes: string[];
+        playlists: {
+            id: string;
+            name: string;
+            description: string;
+            artworkUrl: string;
+            trackCount: number;
+        }[];
+        albums: {
+            id: string;
+            title: string;
+            artistName: string;
+            artworkUrl: string;
+            trackCount: number;
+        }[];
+        stations: {
+            id: string;
+            name: string;
+            artworkUrl: string;
+        }[];
+    }[]>;
+    getReplay(musicUserToken: string, year: number | null): Promise<Record<string, unknown>[]>;
+}
+//# sourceMappingURL=recommendations-rest-client.d.ts.map

package/build/rest/recommendations-rest-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recommendations-rest-client.d.ts","sourceRoot":"","sources":["../../src/rest/recommendations-rest-client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAG5E,mDAAmD;AACnD,qBAAa,yBAAyB;IACxB,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAAT,SAAS,EAAE,uBAAuB;IAEzD,kBAAkB,CAAC,cAAc,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI;;;;;;;;;;;;;;;;;;;;;;;;IAS/D,SAAS,CAAC,cAAc,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;CAQ5D"}

package/build/rest/recommendations-rest-client.js

@@ -0,0 +1,26 @@
+import { mapRecommendation, mapReplaySummary } from '../mappers/apple-music-json-mapper';
+import { mapTopLevelResourceArray } from './rest-json';
+/** Recommendations and Replay Apple Music REST. */
+export class RecommendationsRestClient {
+    transport;
+    constructor(transport) {
+        this.transport = transport;
+    }
+    async getRecommendations(musicUserToken, ids) {
+        const query = {};
+        if (ids?.length) {
+            query.ids = ids.join(',');
+        }
+        const json = await this.transport.getJson('/v1/me/recommendations', query, musicUserToken);
+        return mapTopLevelResourceArray(json.data, mapRecommendation);
+    }
+    async getReplay(musicUserToken, year) {
+        const query = {};
+        if (year != null) {
+            query['filter[year]'] = String(year);
+        }
+        const json = await this.transport.getJson('/v1/me/music-summaries', query, musicUserToken);
+        return mapTopLevelResourceArray(json.data, mapReplaySummary);
+    }
+}
+//# sourceMappingURL=recommendations-rest-client.js.map

package/build/rest/recommendations-rest-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recommendations-rest-client.js","sourceRoot":"","sources":["../../src/rest/recommendations-rest-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AAEzF,OAAO,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAEvD,mDAAmD;AACnD,MAAM,OAAO,yBAAyB;IACP;IAA7B,YAA6B,SAAkC;QAAlC,cAAS,GAAT,SAAS,CAAyB;IAAG,CAAC;IAEnE,KAAK,CAAC,kBAAkB,CAAC,cAAsB,EAAE,GAAoB;QACnE,MAAM,KAAK,GAA2B,EAAE,CAAC;QACzC,IAAI,GAAG,EAAE,MAAM,EAAE,CAAC;YAChB,KAAK,CAAC,GAAG,GAAG,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC5B,CAAC;QACD,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,wBAAwB,EAAE,KAAK,EAAE,cAAc,CAAC,CAAC;QAC3F,OAAO,wBAAwB,CAAC,IAAI,CAAC,IAAI,EAAE,iBAAiB,CAAC,CAAC;IAChE,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,cAAsB,EAAE,IAAmB;QACzD,MAAM,KAAK,GAA2B,EAAE,CAAC;QACzC,IAAI,IAAI,IAAI,IAAI,EAAE,CAAC;YACjB,KAAK,CAAC,cAAc,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;QACvC,CAAC;QACD,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,wBAAwB,EAAE,KAAK,EAAE,cAAc,CAAC,CAAC;QAC3F,OAAO,wBAAwB,CAAC,IAAI,CAAC,IAAI,EAAE,gBAAgB,CAAC,CAAC;IAC/D,CAAC;CACF","sourcesContent":["import { mapRecommendation, mapReplaySummary } from '../mappers/apple-music-json-mapper';\nimport type { AppleMusicRestTransport } from './apple-music-rest-transport';\nimport { mapTopLevelResourceArray } from './rest-json';\n\n/** Recommendations and Replay Apple Music REST. */\nexport class RecommendationsRestClient {\n  constructor(private readonly transport: AppleMusicRestTransport) {}\n\n  async getRecommendations(musicUserToken: string, ids: string[] | null) {\n    const query: Record<string, string> = {};\n    if (ids?.length) {\n      query.ids = ids.join(',');\n    }\n    const json = await this.transport.getJson('/v1/me/recommendations', query, musicUserToken);\n    return mapTopLevelResourceArray(json.data, mapRecommendation);\n  }\n\n  async getReplay(musicUserToken: string, year: number | null) {\n    const query: Record<string, string> = {};\n    if (year != null) {\n      query['filter[year]'] = String(year);\n    }\n    const json = await this.transport.getJson('/v1/me/music-summaries', query, musicUserToken);\n    return mapTopLevelResourceArray(json.data, mapReplaySummary);\n  }\n}\n"]}

package/build/rest/resource-ids-query.d.ts

@@ -0,0 +1,2 @@
+export declare function buildIdsQuery(resourceIds: Record<string, string[]>): Record<string, string>;
+//# sourceMappingURL=resource-ids-query.d.ts.map

package/build/rest/resource-ids-query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-ids-query.d.ts","sourceRoot":"","sources":["../../src/rest/resource-ids-query.ts"],"names":[],"mappings":"AAAA,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAQ3F"}

package/build/rest/resource-ids-query.js

@@ -0,0 +1,10 @@
+export function buildIdsQuery(resourceIds) {
+    const query = {};
+    for (const [type, ids] of Object.entries(resourceIds)) {
+        if (ids.length > 0) {
+            query[`ids[${type}]`] = ids.join(',');
+        }
+    }
+    return query;
+}
+//# sourceMappingURL=resource-ids-query.js.map

package/build/rest/resource-ids-query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-ids-query.js","sourceRoot":"","sources":["../../src/rest/resource-ids-query.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,aAAa,CAAC,WAAqC;IACjE,MAAM,KAAK,GAA2B,EAAE,CAAC;IACzC,KAAK,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;QACtD,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACnB,KAAK,CAAC,OAAO,IAAI,GAAG,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACxC,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC","sourcesContent":["export function buildIdsQuery(resourceIds: Record<string, string[]>): Record<string, string> {\n  const query: Record<string, string> = {};\n  for (const [type, ids] of Object.entries(resourceIds)) {\n    if (ids.length > 0) {\n      query[`ids[${type}]`] = ids.join(',');\n    }\n  }\n  return query;\n}\n"]}

package/build/rest/rest-json.d.ts

@@ -0,0 +1,11 @@
+import type { AppleMusicApiResource } from '../mappers/apple-music-json-mapper';
+/** Top-level list responses must include a `data` array (may be empty). */
+export declare function parseDataArray(data: unknown): AppleMusicApiResource[];
+/**
+ * Map a `data` array (or optional nested search bucket).
+ * `undefined` / `null` → empty (type omitted from search). Non-array → reject.
+ */
+export declare function mapResourceArray<T>(data: unknown, mapper: (resource: AppleMusicApiResource) => T): T[];
+/** Parse required top-level `data`, then map resources. */
+export declare function mapTopLevelResourceArray<T>(data: unknown, mapper: (resource: AppleMusicApiResource) => T): T[];
+//# sourceMappingURL=rest-json.d.ts.map

package/build/rest/rest-json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rest-json.d.ts","sourceRoot":"","sources":["../../src/rest/rest-json.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAGhF,2EAA2E;AAC3E,wBAAgB,cAAc,CAAC,IAAI,EAAE,OAAO,GAAG,qBAAqB,EAAE,CAQrE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAChC,IAAI,EAAE,OAAO,EACb,MAAM,EAAE,CAAC,QAAQ,EAAE,qBAAqB,KAAK,CAAC,GAC7C,CAAC,EAAE,CAQL;AAED,2DAA2D;AAC3D,wBAAgB,wBAAwB,CAAC,CAAC,EACxC,IAAI,EAAE,OAAO,EACb,MAAM,EAAE,CAAC,QAAQ,EAAE,qBAAqB,KAAK,CAAC,GAC7C,CAAC,EAAE,CAEL"}

package/build/rest/rest-json.js

@@ -0,0 +1,29 @@
+import * as errors from '../web/apple-music-errors';
+/** Top-level list responses must include a `data` array (may be empty). */
+export function parseDataArray(data) {
+    if (data === undefined || data === null) {
+        throw errors.apiError('Apple Music API response missing "data"');
+    }
+    if (!Array.isArray(data)) {
+        throw errors.apiError('Apple Music API response "data" is not an array');
+    }
+    return data;
+}
+/**
+ * Map a `data` array (or optional nested search bucket).
+ * `undefined` / `null` → empty (type omitted from search). Non-array → reject.
+ */
+export function mapResourceArray(data, mapper) {
+    if (data === undefined || data === null) {
+        return [];
+    }
+    if (!Array.isArray(data)) {
+        throw errors.apiError('Apple Music API response "data" is not an array');
+    }
+    return data.map((item) => mapper(item));
+}
+/** Parse required top-level `data`, then map resources. */
+export function mapTopLevelResourceArray(data, mapper) {
+    return mapResourceArray(parseDataArray(data), mapper);
+}
+//# sourceMappingURL=rest-json.js.map

package/build/rest/rest-json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rest-json.js","sourceRoot":"","sources":["../../src/rest/rest-json.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,MAAM,MAAM,2BAA2B,CAAC;AAEpD,2EAA2E;AAC3E,MAAM,UAAU,cAAc,CAAC,IAAa;IAC1C,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QACxC,MAAM,MAAM,CAAC,QAAQ,CAAC,yCAAyC,CAAC,CAAC;IACnE,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACzB,MAAM,MAAM,CAAC,QAAQ,CAAC,iDAAiD,CAAC,CAAC;IAC3E,CAAC;IACD,OAAO,IAA+B,CAAC;AACzC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAC9B,IAAa,EACb,MAA8C;IAE9C,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QACxC,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACzB,MAAM,MAAM,CAAC,QAAQ,CAAC,iDAAiD,CAAC,CAAC;IAC3E,CAAC;IACD,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,IAA6B,CAAC,CAAC,CAAC;AACnE,CAAC;AAED,2DAA2D;AAC3D,MAAM,UAAU,wBAAwB,CACtC,IAAa,EACb,MAA8C;IAE9C,OAAO,gBAAgB,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC;AACxD,CAAC","sourcesContent":["import type { AppleMusicApiResource } from '../mappers/apple-music-json-mapper';\nimport * as errors from '../web/apple-music-errors';\n\n/** Top-level list responses must include a `data` array (may be empty). */\nexport function parseDataArray(data: unknown): AppleMusicApiResource[] {\n  if (data === undefined || data === null) {\n    throw errors.apiError('Apple Music API response missing \"data\"');\n  }\n  if (!Array.isArray(data)) {\n    throw errors.apiError('Apple Music API response \"data\" is not an array');\n  }\n  return data as AppleMusicApiResource[];\n}\n\n/**\n * Map a `data` array (or optional nested search bucket).\n * `undefined` / `null` → empty (type omitted from search). Non-array → reject.\n */\nexport function mapResourceArray<T>(\n  data: unknown,\n  mapper: (resource: AppleMusicApiResource) => T,\n): T[] {\n  if (data === undefined || data === null) {\n    return [];\n  }\n  if (!Array.isArray(data)) {\n    throw errors.apiError('Apple Music API response \"data\" is not an array');\n  }\n  return data.map((item) => mapper(item as AppleMusicApiResource));\n}\n\n/** Parse required top-level `data`, then map resources. */\nexport function mapTopLevelResourceArray<T>(\n  data: unknown,\n  mapper: (resource: AppleMusicApiResource) => T,\n): T[] {\n  return mapResourceArray(parseDataArray(data), mapper);\n}\n"]}

package/build/rest/storefront-rest-client.d.ts

@@ -0,0 +1,14 @@
+import type { AppleMusicRestTransport } from './apple-music-rest-transport';
+export type StorefrontResolver = () => Promise<string | null | undefined>;
+/** Resolves and caches the user's Apple Music storefront id for catalog paths. */
+export declare class StorefrontRestClient {
+    private readonly transport;
+    private readonly resolveFromMusicKit?;
+    private cachedStorefront;
+    constructor(transport: AppleMusicRestTransport, resolveFromMusicKit?: StorefrontResolver | undefined);
+    /** Catalog storefront — MusicKit instance or locale fallback (no music user token). */
+    getStorefront(): Promise<string>;
+    /** User storefront from `/v1/me/storefront` (requires music user token). */
+    getUserStorefront(musicUserToken: string): Promise<string>;
+}
+//# sourceMappingURL=storefront-rest-client.d.ts.map

package/build/rest/storefront-rest-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storefront-rest-client.d.ts","sourceRoot":"","sources":["../../src/rest/storefront-rest-client.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAE5E,MAAM,MAAM,kBAAkB,GAAG,MAAM,OAAO,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;AAE1E,kFAAkF;AAClF,qBAAa,oBAAoB;IAI7B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAC;IAJvC,OAAO,CAAC,gBAAgB,CAAuB;gBAG5B,SAAS,EAAE,uBAAuB,EAClC,mBAAmB,CAAC,EAAE,kBAAkB,YAAA;IAG3D,uFAAuF;IACjF,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC;IAetC,4EAA4E;IACtE,iBAAiB,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CASjE"}

package/build/rest/storefront-rest-client.js

@@ -0,0 +1,36 @@
+import { parseStorefrontId } from '../web/music-kit-api';
+import * as errors from '../web/apple-music-errors';
+/** Resolves and caches the user's Apple Music storefront id for catalog paths. */
+export class StorefrontRestClient {
+    transport;
+    resolveFromMusicKit;
+    cachedStorefront = null;
+    constructor(transport, resolveFromMusicKit) {
+        this.transport = transport;
+        this.resolveFromMusicKit = resolveFromMusicKit;
+    }
+    /** Catalog storefront — MusicKit instance or locale fallback (no music user token). */
+    async getStorefront() {
+        if (this.cachedStorefront) {
+            return this.cachedStorefront;
+        }
+        const fromMusicKit = this.resolveFromMusicKit ? await this.resolveFromMusicKit() : null;
+        if (fromMusicKit) {
+            this.cachedStorefront = fromMusicKit;
+            return fromMusicKit;
+        }
+        this.cachedStorefront = 'us';
+        return 'us';
+    }
+    /** User storefront from `/v1/me/storefront` (requires music user token). */
+    async getUserStorefront(musicUserToken) {
+        const json = await this.transport.getJson('/v1/me/storefront', {}, musicUserToken);
+        const id = parseStorefrontId(json);
+        if (!id) {
+            throw errors.apiError('Storefront response missing id');
+        }
+        this.cachedStorefront = id;
+        return id;
+    }
+}
+//# sourceMappingURL=storefront-rest-client.js.map

package/build/rest/storefront-rest-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storefront-rest-client.js","sourceRoot":"","sources":["../../src/rest/storefront-rest-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,KAAK,MAAM,MAAM,2BAA2B,CAAC;AAKpD,kFAAkF;AAClF,MAAM,OAAO,oBAAoB;IAIZ;IACA;IAJX,gBAAgB,GAAkB,IAAI,CAAC;IAE/C,YACmB,SAAkC,EAClC,mBAAwC;QADxC,cAAS,GAAT,SAAS,CAAyB;QAClC,wBAAmB,GAAnB,mBAAmB,CAAqB;IACxD,CAAC;IAEJ,uFAAuF;IACvF,KAAK,CAAC,aAAa;QACjB,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAC1B,OAAO,IAAI,CAAC,gBAAgB,CAAC;QAC/B,CAAC;QAED,MAAM,YAAY,GAAG,IAAI,CAAC,mBAAmB,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,mBAAmB,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QACxF,IAAI,YAAY,EAAE,CAAC;YACjB,IAAI,CAAC,gBAAgB,GAAG,YAAY,CAAC;YACrC,OAAO,YAAY,CAAC;QACtB,CAAC;QAED,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC;QAC7B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,4EAA4E;IAC5E,KAAK,CAAC,iBAAiB,CAAC,cAAsB;QAC5C,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,mBAAmB,EAAE,EAAE,EAAE,cAAc,CAAC,CAAC;QACnF,MAAM,EAAE,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;QACnC,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,MAAM,MAAM,CAAC,QAAQ,CAAC,gCAAgC,CAAC,CAAC;QAC1D,CAAC;QACD,IAAI,CAAC,gBAAgB,GAAG,EAAE,CAAC;QAC3B,OAAO,EAAE,CAAC;IACZ,CAAC;CACF","sourcesContent":["import { parseStorefrontId } from '../web/music-kit-api';\nimport * as errors from '../web/apple-music-errors';\nimport type { AppleMusicRestTransport } from './apple-music-rest-transport';\n\nexport type StorefrontResolver = () => Promise<string | null | undefined>;\n\n/** Resolves and caches the user's Apple Music storefront id for catalog paths. */\nexport class StorefrontRestClient {\n  private cachedStorefront: string | null = null;\n\n  constructor(\n    private readonly transport: AppleMusicRestTransport,\n    private readonly resolveFromMusicKit?: StorefrontResolver,\n  ) {}\n\n  /** Catalog storefront — MusicKit instance or locale fallback (no music user token). */\n  async getStorefront(): Promise<string> {\n    if (this.cachedStorefront) {\n      return this.cachedStorefront;\n    }\n\n    const fromMusicKit = this.resolveFromMusicKit ? await this.resolveFromMusicKit() : null;\n    if (fromMusicKit) {\n      this.cachedStorefront = fromMusicKit;\n      return fromMusicKit;\n    }\n\n    this.cachedStorefront = 'us';\n    return 'us';\n  }\n\n  /** User storefront from `/v1/me/storefront` (requires music user token). */\n  async getUserStorefront(musicUserToken: string): Promise<string> {\n    const json = await this.transport.getJson('/v1/me/storefront', {}, musicUserToken);\n    const id = parseStorefrontId(json);\n    if (!id) {\n      throw errors.apiError('Storefront response missing id');\n    }\n    this.cachedStorefront = id;\n    return id;\n  }\n}\n"]}

package/build/types/album.d.ts

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

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

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

package/build/types/album.js

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

package/build/types/album.js.map

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

package/build/types/albums-response.d.ts

@@ -0,0 +1,5 @@
+import type { Album } from './album';
+export interface AlbumsResponse {
+    albums: Album[];
+}
+//# sourceMappingURL=albums-response.d.ts.map

package/build/types/albums-response.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"albums-response.d.ts","sourceRoot":"","sources":["../../src/types/albums-response.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAErC,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,KAAK,EAAE,CAAC;CACjB"}

package/build/types/albums-response.js

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

package/build/types/albums-response.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"albums-response.js","sourceRoot":"","sources":["../../src/types/albums-response.ts"],"names":[],"mappings":"","sourcesContent":["import type { Album } from './album';\n\nexport interface AlbumsResponse {\n  albums: Album[];\n}\n"]}