@wwdrew/expo-apple-music 1.0.0

package/build/modules/ratings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ratings.js","sourceRoot":"","sources":["../../src/modules/ratings.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AAExE,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AAEvE,MAAM,OAAO;IACJ,MAAM,CAAC,KAAK,CAAC,SAAS,CAC3B,cAAsB,EACtB,YAAgC,EAChC,EAAU;QAEV,qBAAqB,CAAC,cAAc,EAAE,mBAAmB,CAAC,CAAC;QAC3D,OAAO,UAAU,CAAC,mBAAmB,EAAE,KAAK,IAAI,EAAE;YAChD,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,SAAS,CAAC,cAAc,EAAE,YAAY,EAAE,EAAE,CAAC,CAAC;YAC7E,OAAQ,MAAwB,IAAI,IAAI,CAAC;QAC3C,CAAC,CAAC,CAAC;IACL,CAAC;IAEM,MAAM,CAAC,KAAK,CAAC,SAAS,CAC3B,cAAsB,EACtB,YAAgC,EAChC,EAAU,EACV,KAAkB;QAElB,qBAAqB,CAAC,cAAc,EAAE,mBAAmB,CAAC,CAAC;QAC3D,OAAO,UAAU,CAAC,mBAAmB,EAAE,KAAK,IAAI,EAAE,CAChD,CAAC,MAAM,WAAW,CAAC,SAAS,CAAC,cAAc,EAAE,YAAY,EAAE,EAAE,EAAE,KAAK,CAAC,CAAW,CACjF,CAAC;IACJ,CAAC;IAEM,MAAM,CAAC,KAAK,CAAC,WAAW,CAC7B,cAAsB,EACtB,YAAgC,EAChC,EAAU;QAEV,qBAAqB,CAAC,cAAc,EAAE,qBAAqB,CAAC,CAAC;QAC7D,MAAM,UAAU,CAAC,qBAAqB,EAAE,KAAK,IAAI,EAAE;YACjD,MAAM,WAAW,CAAC,WAAW,CAAC,cAAc,EAAE,YAAY,EAAE,EAAE,CAAC,CAAC;QAClE,CAAC,CAAC,CAAC;IACL,CAAC;IAEM,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,cAAsB,EAAE,WAAwB;QACjF,qBAAqB,CAAC,cAAc,EAAE,wBAAwB,CAAC,CAAC;QAChE,MAAM,UAAU,CAAC,wBAAwB,EAAE,KAAK,IAAI,EAAE;YACpD,MAAM,WAAW,CAAC,cAAc,CAAC,cAAc,EAAE,oBAAoB,CAAC,WAAW,CAAC,CAAC,CAAC;QACtF,CAAC,CAAC,CAAC;IACL,CAAC;IAEM,MAAM,CAAC,KAAK,CAAC,mBAAmB,CACrC,cAAsB,EACtB,WAAwB;QAExB,qBAAqB,CAAC,cAAc,EAAE,6BAA6B,CAAC,CAAC;QACrE,MAAM,UAAU,CAAC,6BAA6B,EAAE,KAAK,IAAI,EAAE;YACzD,MAAM,WAAW,CAAC,mBAAmB,CAAC,cAAc,EAAE,oBAAoB,CAAC,WAAW,CAAC,CAAC,CAAC;QAC3F,CAAC,CAAC,CAAC;IACL,CAAC;CACF;AAED,eAAe,OAAO,CAAC","sourcesContent":["import { callNative } from '../api/call-native';\nimport { requireMusicUserToken } from '../api/require-music-user-token';\nimport type { Rating, RatingResourceType, RatingValue, ResourceIds } from '../types/rating';\nimport { MusicModule } from '../native-module';\nimport { normalizeResourceIds } from '../utils/normalize-resource-ids';\n\nclass Ratings {\n  public static async getRating(\n    musicUserToken: string,\n    resourceType: RatingResourceType,\n    id: string,\n  ): Promise<Rating | null> {\n    requireMusicUserToken(musicUserToken, 'Ratings.getRating');\n    return callNative('Ratings.getRating', async () => {\n      const result = await MusicModule.getRating(musicUserToken, resourceType, id);\n      return (result as Rating | null) ?? null;\n    });\n  }\n\n  public static async setRating(\n    musicUserToken: string,\n    resourceType: RatingResourceType,\n    id: string,\n    value: RatingValue,\n  ): Promise<Rating> {\n    requireMusicUserToken(musicUserToken, 'Ratings.setRating');\n    return callNative('Ratings.setRating', async () =>\n      (await MusicModule.setRating(musicUserToken, resourceType, id, value)) as Rating,\n    );\n  }\n\n  public static async clearRating(\n    musicUserToken: string,\n    resourceType: RatingResourceType,\n    id: string,\n  ): Promise<void> {\n    requireMusicUserToken(musicUserToken, 'Ratings.clearRating');\n    await callNative('Ratings.clearRating', async () => {\n      await MusicModule.clearRating(musicUserToken, resourceType, id);\n    });\n  }\n\n  public static async addToFavorites(musicUserToken: string, resourceIds: ResourceIds): Promise<void> {\n    requireMusicUserToken(musicUserToken, 'Ratings.addToFavorites');\n    await callNative('Ratings.addToFavorites', async () => {\n      await MusicModule.addToFavorites(musicUserToken, normalizeResourceIds(resourceIds));\n    });\n  }\n\n  public static async removeFromFavorites(\n    musicUserToken: string,\n    resourceIds: ResourceIds,\n  ): Promise<void> {\n    requireMusicUserToken(musicUserToken, 'Ratings.removeFromFavorites');\n    await callNative('Ratings.removeFromFavorites', async () => {\n      await MusicModule.removeFromFavorites(musicUserToken, normalizeResourceIds(resourceIds));\n    });\n  }\n}\n\nexport default Ratings;\n"]}

package/build/modules/recommendations.d.ts

@@ -0,0 +1,7 @@
+import type { RecommendationsOptions, RecommendationsResponse, ReplayOptions, ReplayResponse } from '../types/recommendation';
+declare class Recommendations {
+    static get(musicUserToken: string, options?: RecommendationsOptions): Promise<RecommendationsResponse>;
+    static getReplay(musicUserToken: string, options?: ReplayOptions): Promise<ReplayResponse>;
+}
+export default Recommendations;
+//# sourceMappingURL=recommendations.d.ts.map

package/build/modules/recommendations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recommendations.d.ts","sourceRoot":"","sources":["../../src/modules/recommendations.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,sBAAsB,EACtB,uBAAuB,EACvB,aAAa,EACb,cAAc,EACf,MAAM,yBAAyB,CAAC;AAGjC,cAAM,eAAe;WACC,GAAG,CACrB,cAAc,EAAE,MAAM,EACtB,OAAO,CAAC,EAAE,sBAAsB,GAC/B,OAAO,CAAC,uBAAuB,CAAC;WAOf,SAAS,CAC3B,cAAc,EAAE,MAAM,EACtB,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,cAAc,CAAC;CAM3B;AAED,eAAe,eAAe,CAAC"}

package/build/modules/recommendations.js

@@ -0,0 +1,15 @@
+import { callNative } from '../api/call-native';
+import { requireMusicUserToken } from '../api/require-music-user-token';
+import { MusicModule } from '../native-module';
+class Recommendations {
+    static async get(musicUserToken, options) {
+        requireMusicUserToken(musicUserToken, 'Recommendations.get');
+        return callNative('Recommendations.get', async () => (await MusicModule.getRecommendations(musicUserToken, options?.ids)));
+    }
+    static async getReplay(musicUserToken, options) {
+        requireMusicUserToken(musicUserToken, 'Recommendations.getReplay');
+        return callNative('Recommendations.getReplay', async () => (await MusicModule.getReplay(musicUserToken, options?.year)));
+    }
+}
+export default Recommendations;
+//# sourceMappingURL=recommendations.js.map

package/build/modules/recommendations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recommendations.js","sourceRoot":"","sources":["../../src/modules/recommendations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AAOxE,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,MAAM,eAAe;IACZ,MAAM,CAAC,KAAK,CAAC,GAAG,CACrB,cAAsB,EACtB,OAAgC;QAEhC,qBAAqB,CAAC,cAAc,EAAE,qBAAqB,CAAC,CAAC;QAC7D,OAAO,UAAU,CAAC,qBAAqB,EAAE,KAAK,IAAI,EAAE,CAClD,CAAC,MAAM,WAAW,CAAC,kBAAkB,CAAC,cAAc,EAAE,OAAO,EAAE,GAAG,CAAC,CAA4B,CAChG,CAAC;IACJ,CAAC;IAEM,MAAM,CAAC,KAAK,CAAC,SAAS,CAC3B,cAAsB,EACtB,OAAuB;QAEvB,qBAAqB,CAAC,cAAc,EAAE,2BAA2B,CAAC,CAAC;QACnE,OAAO,UAAU,CAAC,2BAA2B,EAAE,KAAK,IAAI,EAAE,CACxD,CAAC,MAAM,WAAW,CAAC,SAAS,CAAC,cAAc,EAAE,OAAO,EAAE,IAAI,CAAC,CAAmB,CAC/E,CAAC;IACJ,CAAC;CACF;AAED,eAAe,eAAe,CAAC","sourcesContent":["import { callNative } from '../api/call-native';\nimport { requireMusicUserToken } from '../api/require-music-user-token';\nimport type {\n  RecommendationsOptions,\n  RecommendationsResponse,\n  ReplayOptions,\n  ReplayResponse,\n} from '../types/recommendation';\nimport { MusicModule } from '../native-module';\n\nclass Recommendations {\n  public static async get(\n    musicUserToken: string,\n    options?: RecommendationsOptions,\n  ): Promise<RecommendationsResponse> {\n    requireMusicUserToken(musicUserToken, 'Recommendations.get');\n    return callNative('Recommendations.get', async () =>\n      (await MusicModule.getRecommendations(musicUserToken, options?.ids)) as RecommendationsResponse,\n    );\n  }\n\n  public static async getReplay(\n    musicUserToken: string,\n    options?: ReplayOptions,\n  ): Promise<ReplayResponse> {\n    requireMusicUserToken(musicUserToken, 'Recommendations.getReplay');\n    return callNative('Recommendations.getReplay', async () =>\n      (await MusicModule.getReplay(musicUserToken, options?.year)) as ReplayResponse,\n    );\n  }\n}\n\nexport default Recommendations;\n"]}

package/build/native-module.d.ts

@@ -0,0 +1,5 @@
+import { LegacyEventEmitter } from 'expo-modules-core';
+export declare const UNSUPPORTED_PLATFORM = "UNSUPPORTED_PLATFORM";
+export declare const MusicModule: any;
+export declare const musicEventEmitter: LegacyEventEmitter;
+//# sourceMappingURL=native-module.d.ts.map

package/build/native-module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-module.d.ts","sourceRoot":"","sources":["../src/native-module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAuB,MAAM,mBAAmB,CAAC;AAE5E,eAAO,MAAM,oBAAoB,yBAAyB,CAAC;AAE3D,eAAO,MAAM,WAAW,KAAwC,CAAC;AAEjE,eAAO,MAAM,iBAAiB,oBAAsC,CAAC"}

package/build/native-module.js

@@ -0,0 +1,5 @@
+import { LegacyEventEmitter, requireNativeModule } from 'expo-modules-core';
+export const UNSUPPORTED_PLATFORM = 'UNSUPPORTED_PLATFORM';
+export const MusicModule = requireNativeModule('ExpoAppleMusic');
+export const musicEventEmitter = new LegacyEventEmitter(MusicModule);
+//# sourceMappingURL=native-module.js.map

package/build/native-module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-module.js","sourceRoot":"","sources":["../src/native-module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAE5E,MAAM,CAAC,MAAM,oBAAoB,GAAG,sBAAsB,CAAC;AAE3D,MAAM,CAAC,MAAM,WAAW,GAAG,mBAAmB,CAAC,gBAAgB,CAAC,CAAC;AAEjE,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,kBAAkB,CAAC,WAAW,CAAC,CAAC","sourcesContent":["import { LegacyEventEmitter, requireNativeModule } from 'expo-modules-core';\n\nexport const UNSUPPORTED_PLATFORM = 'UNSUPPORTED_PLATFORM';\n\nexport const MusicModule = requireNativeModule('ExpoAppleMusic');\n\nexport const musicEventEmitter = new LegacyEventEmitter(MusicModule);\n"]}

package/build/native-module.web.d.ts

@@ -0,0 +1,11 @@
+import { LegacyEventEmitter } from 'expo-modules-core';
+import { type ExpoAppleMusicModule as ExpoAppleMusicModuleType } from './ExpoAppleMusicModule.web';
+export declare const UNSUPPORTED_PLATFORM = "UNSUPPORTED_PLATFORM";
+/**
+ * On web, `requireNativeModule` only resolves when `ExpoDomWebView` is set (see
+ * expo-modules-core `requireNativeModule.web.ts`). Import the `registerWebModule`
+ * singleton directly — same pattern as expo-font's `ExpoFontLoader.web.ts`.
+ */
+export declare const MusicModule: ExpoAppleMusicModuleType;
+export declare const musicEventEmitter: LegacyEventEmitter;
+//# sourceMappingURL=native-module.web.d.ts.map

package/build/native-module.web.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-module.web.d.ts","sourceRoot":"","sources":["../src/native-module.web.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEvD,OAA6B,EAAE,KAAK,oBAAoB,IAAI,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAEzH,eAAO,MAAM,oBAAoB,yBAAyB,CAAC;AAE3D;;;;GAIG;AACH,eAAO,MAAM,WAAW,EAAE,wBAA+C,CAAC;AAE1E,eAAO,MAAM,iBAAiB,oBAAsC,CAAC"}

package/build/native-module.web.js

@@ -0,0 +1,11 @@
+import { LegacyEventEmitter } from 'expo-modules-core';
+import ExpoAppleMusicModule, {} from './ExpoAppleMusicModule.web';
+export const UNSUPPORTED_PLATFORM = 'UNSUPPORTED_PLATFORM';
+/**
+ * On web, `requireNativeModule` only resolves when `ExpoDomWebView` is set (see
+ * expo-modules-core `requireNativeModule.web.ts`). Import the `registerWebModule`
+ * singleton directly — same pattern as expo-font's `ExpoFontLoader.web.ts`.
+ */
+export const MusicModule = ExpoAppleMusicModule;
+export const musicEventEmitter = new LegacyEventEmitter(MusicModule);
+//# sourceMappingURL=native-module.web.js.map

package/build/native-module.web.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-module.web.js","sourceRoot":"","sources":["../src/native-module.web.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEvD,OAAO,oBAAoB,EAAE,EAAyD,MAAM,4BAA4B,CAAC;AAEzH,MAAM,CAAC,MAAM,oBAAoB,GAAG,sBAAsB,CAAC;AAE3D;;;;GAIG;AACH,MAAM,CAAC,MAAM,WAAW,GAA6B,oBAAoB,CAAC;AAE1E,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,kBAAkB,CAAC,WAAW,CAAC,CAAC","sourcesContent":["import { LegacyEventEmitter } from 'expo-modules-core';\n\nimport ExpoAppleMusicModule, { type ExpoAppleMusicModule as ExpoAppleMusicModuleType } from './ExpoAppleMusicModule.web';\n\nexport const UNSUPPORTED_PLATFORM = 'UNSUPPORTED_PLATFORM';\n\n/**\n * On web, `requireNativeModule` only resolves when `ExpoDomWebView` is set (see\n * expo-modules-core `requireNativeModule.web.ts`). Import the `registerWebModule`\n * singleton directly — same pattern as expo-font's `ExpoFontLoader.web.ts`.\n */\nexport const MusicModule: ExpoAppleMusicModuleType = ExpoAppleMusicModule;\n\nexport const musicEventEmitter = new LegacyEventEmitter(MusicModule);\n"]}

package/build/rest/apple-music-rest-stack.d.ts

@@ -0,0 +1,21 @@
+import { CatalogRestClient } from './catalog-rest-client';
+import { HistoryRestClient } from './history-rest-client';
+import { LibraryMutationsRestClient } from './library-mutations-rest-client';
+import { LibraryRestClient } from './library-rest-client';
+import { RatingsRestClient } from './ratings-rest-client';
+import { RecommendationsRestClient } from './recommendations-rest-client';
+import { StorefrontRestClient } from './storefront-rest-client';
+import type { AppleMusicRestTransport } from './apple-music-rest-transport';
+import type { StorefrontResolver } from './storefront-rest-client';
+export type AppleMusicRestStack = {
+    transport: AppleMusicRestTransport;
+    storefront: StorefrontRestClient;
+    catalog: CatalogRestClient;
+    library: LibraryRestClient;
+    history: HistoryRestClient;
+    ratings: RatingsRestClient;
+    libraryMutations: LibraryMutationsRestClient;
+    recommendations: RecommendationsRestClient;
+};
+export declare function createAppleMusicRestStack(transport: AppleMusicRestTransport, storefrontResolver?: StorefrontResolver): AppleMusicRestStack;
+//# sourceMappingURL=apple-music-rest-stack.d.ts.map

package/build/rest/apple-music-rest-stack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apple-music-rest-stack.d.ts","sourceRoot":"","sources":["../../src/rest/apple-music-rest-stack.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAC;AAC7E,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,yBAAyB,EAAE,MAAM,+BAA+B,CAAC;AAC1E,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAC5E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAEnE,MAAM,MAAM,mBAAmB,GAAG;IAChC,SAAS,EAAE,uBAAuB,CAAC;IACnC,UAAU,EAAE,oBAAoB,CAAC;IACjC,OAAO,EAAE,iBAAiB,CAAC;IAC3B,OAAO,EAAE,iBAAiB,CAAC;IAC3B,OAAO,EAAE,iBAAiB,CAAC;IAC3B,OAAO,EAAE,iBAAiB,CAAC;IAC3B,gBAAgB,EAAE,0BAA0B,CAAC;IAC7C,eAAe,EAAE,yBAAyB,CAAC;CAC5C,CAAC;AAEF,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,uBAAuB,EAClC,kBAAkB,CAAC,EAAE,kBAAkB,GACtC,mBAAmB,CAYrB"}

package/build/rest/apple-music-rest-stack.js

@@ -0,0 +1,21 @@
+import { CatalogRestClient } from './catalog-rest-client';
+import { HistoryRestClient } from './history-rest-client';
+import { LibraryMutationsRestClient } from './library-mutations-rest-client';
+import { LibraryRestClient } from './library-rest-client';
+import { RatingsRestClient } from './ratings-rest-client';
+import { RecommendationsRestClient } from './recommendations-rest-client';
+import { StorefrontRestClient } from './storefront-rest-client';
+export function createAppleMusicRestStack(transport, storefrontResolver) {
+    const storefront = new StorefrontRestClient(transport, storefrontResolver);
+    return {
+        transport,
+        storefront,
+        catalog: new CatalogRestClient(transport, storefront),
+        library: new LibraryRestClient(transport),
+        history: new HistoryRestClient(transport),
+        ratings: new RatingsRestClient(transport),
+        libraryMutations: new LibraryMutationsRestClient(transport),
+        recommendations: new RecommendationsRestClient(transport),
+    };
+}
+//# sourceMappingURL=apple-music-rest-stack.js.map

package/build/rest/apple-music-rest-stack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apple-music-rest-stack.js","sourceRoot":"","sources":["../../src/rest/apple-music-rest-stack.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAC;AAC7E,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,yBAAyB,EAAE,MAAM,+BAA+B,CAAC;AAC1E,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAehE,MAAM,UAAU,yBAAyB,CACvC,SAAkC,EAClC,kBAAuC;IAEvC,MAAM,UAAU,GAAG,IAAI,oBAAoB,CAAC,SAAS,EAAE,kBAAkB,CAAC,CAAC;IAC3E,OAAO;QACL,SAAS;QACT,UAAU;QACV,OAAO,EAAE,IAAI,iBAAiB,CAAC,SAAS,EAAE,UAAU,CAAC;QACrD,OAAO,EAAE,IAAI,iBAAiB,CAAC,SAAS,CAAC;QACzC,OAAO,EAAE,IAAI,iBAAiB,CAAC,SAAS,CAAC;QACzC,OAAO,EAAE,IAAI,iBAAiB,CAAC,SAAS,CAAC;QACzC,gBAAgB,EAAE,IAAI,0BAA0B,CAAC,SAAS,CAAC;QAC3D,eAAe,EAAE,IAAI,yBAAyB,CAAC,SAAS,CAAC;KAC1D,CAAC;AACJ,CAAC","sourcesContent":["import { CatalogRestClient } from './catalog-rest-client';\nimport { HistoryRestClient } from './history-rest-client';\nimport { LibraryMutationsRestClient } from './library-mutations-rest-client';\nimport { LibraryRestClient } from './library-rest-client';\nimport { RatingsRestClient } from './ratings-rest-client';\nimport { RecommendationsRestClient } from './recommendations-rest-client';\nimport { StorefrontRestClient } from './storefront-rest-client';\nimport type { AppleMusicRestTransport } from './apple-music-rest-transport';\nimport type { StorefrontResolver } from './storefront-rest-client';\n\nexport type AppleMusicRestStack = {\n  transport: AppleMusicRestTransport;\n  storefront: StorefrontRestClient;\n  catalog: CatalogRestClient;\n  library: LibraryRestClient;\n  history: HistoryRestClient;\n  ratings: RatingsRestClient;\n  libraryMutations: LibraryMutationsRestClient;\n  recommendations: RecommendationsRestClient;\n};\n\nexport function createAppleMusicRestStack(\n  transport: AppleMusicRestTransport,\n  storefrontResolver?: StorefrontResolver,\n): AppleMusicRestStack {\n  const storefront = new StorefrontRestClient(transport, storefrontResolver);\n  return {\n    transport,\n    storefront,\n    catalog: new CatalogRestClient(transport, storefront),\n    library: new LibraryRestClient(transport),\n    history: new HistoryRestClient(transport),\n    ratings: new RatingsRestClient(transport),\n    libraryMutations: new LibraryMutationsRestClient(transport),\n    recommendations: new RecommendationsRestClient(transport),\n  };\n}\n"]}

package/build/rest/apple-music-rest-transport.d.ts

@@ -0,0 +1,8 @@
+import type { MusicKitApiResponse } from '../web/musickit-types';
+export type AppleMusicHttpMethod = 'GET' | 'POST' | 'PUT' | 'DELETE';
+/** Platform HTTP adapter for Apple Music REST paths (`/v1/...`). */
+export interface AppleMusicRestTransport {
+    request(method: AppleMusicHttpMethod, path: string, query?: Record<string, string>, body?: Record<string, unknown>, musicUserToken?: string): Promise<MusicKitApiResponse>;
+    getJson(path: string, query?: Record<string, string>, musicUserToken?: string): Promise<MusicKitApiResponse>;
+}
+//# sourceMappingURL=apple-music-rest-transport.d.ts.map

package/build/rest/apple-music-rest-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apple-music-rest-transport.d.ts","sourceRoot":"","sources":["../../src/rest/apple-music-rest-transport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAEjE,MAAM,MAAM,oBAAoB,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,CAAC;AAErE,oEAAoE;AACpE,MAAM,WAAW,uBAAuB;IACtC,OAAO,CACL,MAAM,EAAE,oBAAoB,EAC5B,IAAI,EAAE,MAAM,EACZ,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC9B,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAEhC,OAAO,CACL,IAAI,EAAE,MAAM,EACZ,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC9B,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,mBAAmB,CAAC,CAAC;CACjC"}

package/build/rest/apple-music-rest-transport.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=apple-music-rest-transport.js.map

package/build/rest/apple-music-rest-transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apple-music-rest-transport.js","sourceRoot":"","sources":["../../src/rest/apple-music-rest-transport.ts"],"names":[],"mappings":"","sourcesContent":["import type { MusicKitApiResponse } from '../web/musickit-types';\n\nexport type AppleMusicHttpMethod = 'GET' | 'POST' | 'PUT' | 'DELETE';\n\n/** Platform HTTP adapter for Apple Music REST paths (`/v1/...`). */\nexport interface AppleMusicRestTransport {\n  request(\n    method: AppleMusicHttpMethod,\n    path: string,\n    query?: Record<string, string>,\n    body?: Record<string, unknown>,\n    musicUserToken?: string,\n  ): Promise<MusicKitApiResponse>;\n\n  getJson(\n    path: string,\n    query?: Record<string, string>,\n    musicUserToken?: string,\n  ): Promise<MusicKitApiResponse>;\n}\n"]}

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

@@ -0,0 +1,38 @@
+import type { CatalogResourceType } from '../types/catalog-resource-type';
+import type { AppleMusicRestTransport } from './apple-music-rest-transport';
+import { StorefrontRestClient } from './storefront-rest-client';
+export type CatalogSearchResult = {
+    songs: Record<string, unknown>[];
+    albums: Record<string, unknown>[];
+    artists: Record<string, unknown>[];
+    playlists: Record<string, unknown>[];
+    stations: Record<string, unknown>[];
+    musicVideos: Record<string, unknown>[];
+};
+export type CatalogChartsResult = {
+    songs: Record<string, unknown>[];
+    albums: Record<string, unknown>[];
+    playlists: Record<string, unknown>[];
+    musicVideos: Record<string, unknown>[];
+};
+/** Catalog-domain Apple Music REST (search, resources, charts). */
+export declare class CatalogRestClient {
+    private readonly transport;
+    private readonly storefront;
+    constructor(transport: AppleMusicRestTransport, storefront: StorefrontRestClient);
+    catalogSearch(term: string, types: string[], limit: number, offset: number): Promise<CatalogSearchResult>;
+    private getCatalogResource;
+    getCatalogSong(id: string): Promise<Record<string, unknown>>;
+    getCatalogAlbum(id: string): Promise<Record<string, unknown>>;
+    getCatalogArtist(id: string): Promise<Record<string, unknown>>;
+    getCatalogPlaylist(id: string): Promise<Record<string, unknown>>;
+    getCatalogStation(id: string): Promise<Record<string, unknown>>;
+    getCatalogMusicVideo(id: string): Promise<Record<string, unknown>>;
+    getCatalogResources(type: CatalogResourceType, ids: string[]): Promise<Record<string, unknown>[]>;
+    private getCatalogRelationship;
+    getCatalogAlbumTracks(albumId: string, limit: number, offset: number): Promise<Record<string, unknown>[]>;
+    getCatalogArtistAlbums(artistId: string, limit: number, offset: number): Promise<Record<string, unknown>[]>;
+    getCatalogPlaylistTracks(playlistId: string, limit: number, offset: number): Promise<Record<string, unknown>[]>;
+    getCatalogCharts(types: string[], limit: number, offset: number, genre?: string | null, chart?: string | null): Promise<CatalogChartsResult>;
+}
+//# sourceMappingURL=catalog-rest-client.d.ts.map

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

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

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

@@ -0,0 +1,189 @@
+import { mapAlbum, mapArtist, mapMusicVideo, mapPlaylist, mapSong, mapStation, } from '../mappers/apple-music-json-mapper';
+import * as errors from '../web/apple-music-errors';
+import { mapResourceArray, mapTopLevelResourceArray } from './rest-json';
+import { StorefrontRestClient } from './storefront-rest-client';
+function catalogSearchTypeParam(type) {
+    switch (type) {
+        case 'songs':
+        case 'song':
+            return 'songs';
+        case 'albums':
+        case 'album':
+            return 'albums';
+        case 'artists':
+        case 'artist':
+            return 'artists';
+        case 'playlists':
+        case 'playlist':
+            return 'playlists';
+        case 'stations':
+        case 'station':
+            return 'stations';
+        case 'music-videos':
+        case 'musicVideos':
+        case 'musicVideo':
+            return 'music-videos';
+        default:
+            return null;
+    }
+}
+function catalogChartTypeParam(type) {
+    switch (type) {
+        case 'songs':
+        case 'song':
+            return 'songs';
+        case 'albums':
+        case 'album':
+            return 'albums';
+        case 'playlists':
+        case 'playlist':
+            return 'playlists';
+        case 'music-videos':
+        case 'musicVideos':
+        case 'musicVideo':
+            return 'music-videos';
+        default:
+            return null;
+    }
+}
+function catalogResourceMapper(type) {
+    switch (type) {
+        case 'songs':
+            return mapSong;
+        case 'albums':
+            return mapAlbum;
+        case 'artists':
+            return mapArtist;
+        case 'playlists':
+            return mapPlaylist;
+        case 'stations':
+            return mapStation;
+        case 'music-videos':
+            return mapMusicVideo;
+        default:
+            throw errors.unknownMediaType(type);
+    }
+}
+/** Catalog-domain Apple Music REST (search, resources, charts). */
+export class CatalogRestClient {
+    transport;
+    storefront;
+    constructor(transport, storefront) {
+        this.transport = transport;
+        this.storefront = storefront;
+    }
+    async catalogSearch(term, types, limit, offset) {
+        const storefrontId = await this.storefront.getStorefront();
+        const typeParam = types
+            .map((t) => catalogSearchTypeParam(t))
+            .filter((t) => t !== null)
+            .filter((t, i, arr) => arr.indexOf(t) === i)
+            .join(',') || 'songs,albums';
+        const json = await this.transport.getJson(`/v1/catalog/${storefrontId}/search`, {
+            term,
+            types: typeParam,
+            limit: String(limit),
+            offset: String(offset),
+        });
+        const results = json.results ?? {};
+        return {
+            songs: mapResourceArray(results.songs?.data, mapSong),
+            albums: mapResourceArray(results.albums?.data, mapAlbum),
+            artists: mapResourceArray(results.artists?.data, mapArtist),
+            playlists: mapResourceArray(results.playlists?.data, mapPlaylist),
+            stations: mapResourceArray(results.stations?.data, mapStation),
+            musicVideos: mapResourceArray(results['music-videos']?.data, mapMusicVideo),
+        };
+    }
+    async getCatalogResource(path, mapper) {
+        const json = await this.transport.getJson(path);
+        const data = Array.isArray(json.data) ? json.data[0] : null;
+        if (!data) {
+            throw errors.itemNotFound('Catalog item', false);
+        }
+        return mapper(data);
+    }
+    async getCatalogSong(id) {
+        const storefrontId = await this.storefront.getStorefront();
+        return this.getCatalogResource(`/v1/catalog/${storefrontId}/songs/${id}`, mapSong);
+    }
+    async getCatalogAlbum(id) {
+        const storefrontId = await this.storefront.getStorefront();
+        return this.getCatalogResource(`/v1/catalog/${storefrontId}/albums/${id}`, mapAlbum);
+    }
+    async getCatalogArtist(id) {
+        const storefrontId = await this.storefront.getStorefront();
+        return this.getCatalogResource(`/v1/catalog/${storefrontId}/artists/${id}`, mapArtist);
+    }
+    async getCatalogPlaylist(id) {
+        const storefrontId = await this.storefront.getStorefront();
+        return this.getCatalogResource(`/v1/catalog/${storefrontId}/playlists/${id}`, mapPlaylist);
+    }
+    async getCatalogStation(id) {
+        const storefrontId = await this.storefront.getStorefront();
+        return this.getCatalogResource(`/v1/catalog/${storefrontId}/stations/${id}`, mapStation);
+    }
+    async getCatalogMusicVideo(id) {
+        const storefrontId = await this.storefront.getStorefront();
+        return this.getCatalogResource(`/v1/catalog/${storefrontId}/music-videos/${id}`, mapMusicVideo);
+    }
+    async getCatalogResources(type, ids) {
+        const trimmed = ids.map((id) => id.trim()).filter((id) => id.length > 0);
+        if (trimmed.length === 0) {
+            return [];
+        }
+        const storefrontId = await this.storefront.getStorefront();
+        const json = await this.transport.getJson(`/v1/catalog/${storefrontId}/${type}`, {
+            ids: trimmed.join(','),
+        });
+        const mapper = catalogResourceMapper(type);
+        return mapTopLevelResourceArray(json.data, mapper);
+    }
+    async getCatalogRelationship(path, limit, offset, mapper) {
+        const json = await this.transport.getJson(path, {
+            limit: String(limit),
+            offset: String(offset),
+        });
+        return mapTopLevelResourceArray(json.data, mapper);
+    }
+    async getCatalogAlbumTracks(albumId, limit, offset) {
+        const storefrontId = await this.storefront.getStorefront();
+        return this.getCatalogRelationship(`/v1/catalog/${storefrontId}/albums/${albumId}/tracks`, limit, offset, mapSong);
+    }
+    async getCatalogArtistAlbums(artistId, limit, offset) {
+        const storefrontId = await this.storefront.getStorefront();
+        return this.getCatalogRelationship(`/v1/catalog/${storefrontId}/artists/${artistId}/albums`, limit, offset, mapAlbum);
+    }
+    async getCatalogPlaylistTracks(playlistId, limit, offset) {
+        const storefrontId = await this.storefront.getStorefront();
+        return this.getCatalogRelationship(`/v1/catalog/${storefrontId}/playlists/${playlistId}/tracks`, limit, offset, mapSong);
+    }
+    async getCatalogCharts(types, limit, offset, genre, chart) {
+        const storefrontId = await this.storefront.getStorefront();
+        const typeParam = types
+            .map((t) => catalogChartTypeParam(t))
+            .filter((t) => t !== null)
+            .filter((t, i, arr) => arr.indexOf(t) === i)
+            .join(',') || 'songs,albums';
+        const query = {
+            types: typeParam,
+            limit: String(limit),
+            offset: String(offset),
+        };
+        if (genre) {
+            query.genre = genre;
+        }
+        if (chart) {
+            query.chart = chart;
+        }
+        const json = await this.transport.getJson(`/v1/catalog/${storefrontId}/charts`, query);
+        const results = json.results ?? {};
+        return {
+            songs: mapResourceArray(results.songs?.data, mapSong),
+            albums: mapResourceArray(results.albums?.data, mapAlbum),
+            playlists: mapResourceArray(results.playlists?.data, mapPlaylist),
+            musicVideos: mapResourceArray(results['music-videos']?.data, mapMusicVideo),
+        };
+    }
+}
+//# sourceMappingURL=catalog-rest-client.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-rest-client.js","sourceRoot":"","sources":["../../src/rest/catalog-rest-client.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  mapAlbum,\n  mapArtist,\n  mapMusicVideo,\n  mapPlaylist,\n  mapSong,\n  mapStation,\n  type AppleMusicApiResource,\n} from '../mappers/apple-music-json-mapper';\nimport * as errors from '../web/apple-music-errors';\nimport type { CatalogResourceType } from '../types/catalog-resource-type';\nimport type { AppleMusicRestTransport } from './apple-music-rest-transport';\nimport { mapResourceArray, mapTopLevelResourceArray } from './rest-json';\nimport { StorefrontRestClient } from './storefront-rest-client';\n\nexport type CatalogSearchResult = {\n  songs: Record<string, unknown>[];\n  albums: Record<string, unknown>[];\n  artists: Record<string, unknown>[];\n  playlists: Record<string, unknown>[];\n  stations: Record<string, unknown>[];\n  musicVideos: Record<string, unknown>[];\n};\n\nexport type CatalogChartsResult = {\n  songs: Record<string, unknown>[];\n  albums: Record<string, unknown>[];\n  playlists: Record<string, unknown>[];\n  musicVideos: Record<string, unknown>[];\n};\n\nfunction catalogSearchTypeParam(type: string): string | null {\n  switch (type) {\n    case 'songs':\n    case 'song':\n      return 'songs';\n    case 'albums':\n    case 'album':\n      return 'albums';\n    case 'artists':\n    case 'artist':\n      return 'artists';\n    case 'playlists':\n    case 'playlist':\n      return 'playlists';\n    case 'stations':\n    case 'station':\n      return 'stations';\n    case 'music-videos':\n    case 'musicVideos':\n    case 'musicVideo':\n      return 'music-videos';\n    default:\n      return null;\n  }\n}\n\nfunction catalogChartTypeParam(type: string): string | null {\n  switch (type) {\n    case 'songs':\n    case 'song':\n      return 'songs';\n    case 'albums':\n    case 'album':\n      return 'albums';\n    case 'playlists':\n    case 'playlist':\n      return 'playlists';\n    case 'music-videos':\n    case 'musicVideos':\n    case 'musicVideo':\n      return 'music-videos';\n    default:\n      return null;\n  }\n}\n\nfunction catalogResourceMapper(\n  type: CatalogResourceType,\n): (resource: AppleMusicApiResource) => Record<string, unknown> {\n  switch (type) {\n    case 'songs':\n      return mapSong;\n    case 'albums':\n      return mapAlbum;\n    case 'artists':\n      return mapArtist;\n    case 'playlists':\n      return mapPlaylist;\n    case 'stations':\n      return mapStation;\n    case 'music-videos':\n      return mapMusicVideo;\n    default:\n      throw errors.unknownMediaType(type);\n  }\n}\n\n/** Catalog-domain Apple Music REST (search, resources, charts). */\nexport class CatalogRestClient {\n  constructor(\n    private readonly transport: AppleMusicRestTransport,\n    private readonly storefront: StorefrontRestClient,\n  ) {}\n\n  async catalogSearch(\n    term: string,\n    types: string[],\n    limit: number,\n    offset: number,\n  ): Promise<CatalogSearchResult> {\n    const storefrontId = await this.storefront.getStorefront();\n    const typeParam =\n      types\n        .map((t) => catalogSearchTypeParam(t))\n        .filter((t): t is string => t !== null)\n        .filter((t, i, arr) => arr.indexOf(t) === i)\n        .join(',') || 'songs,albums';\n\n    const json = await this.transport.getJson(`/v1/catalog/${storefrontId}/search`, {\n      term,\n      types: typeParam,\n      limit: String(limit),\n      offset: String(offset),\n    });\n\n    const results = json.results ?? {};\n    return {\n      songs: mapResourceArray(results.songs?.data, mapSong),\n      albums: mapResourceArray(results.albums?.data, mapAlbum),\n      artists: mapResourceArray(results.artists?.data, mapArtist),\n      playlists: mapResourceArray(results.playlists?.data, mapPlaylist),\n      stations: mapResourceArray(results.stations?.data, mapStation),\n      musicVideos: mapResourceArray(results['music-videos']?.data, mapMusicVideo),\n    };\n  }\n\n  private async getCatalogResource(\n    path: string,\n    mapper: (resource: AppleMusicApiResource) => Record<string, unknown>,\n  ): Promise<Record<string, unknown>> {\n    const json = await this.transport.getJson(path);\n    const data = Array.isArray(json.data) ? json.data[0] : null;\n    if (!data) {\n      throw errors.itemNotFound('Catalog item', false);\n    }\n    return mapper(data as AppleMusicApiResource);\n  }\n\n  async getCatalogSong(id: string): Promise<Record<string, unknown>> {\n    const storefrontId = await this.storefront.getStorefront();\n    return this.getCatalogResource(`/v1/catalog/${storefrontId}/songs/${id}`, mapSong);\n  }\n\n  async getCatalogAlbum(id: string): Promise<Record<string, unknown>> {\n    const storefrontId = await this.storefront.getStorefront();\n    return this.getCatalogResource(`/v1/catalog/${storefrontId}/albums/${id}`, mapAlbum);\n  }\n\n  async getCatalogArtist(id: string): Promise<Record<string, unknown>> {\n    const storefrontId = await this.storefront.getStorefront();\n    return this.getCatalogResource(`/v1/catalog/${storefrontId}/artists/${id}`, mapArtist);\n  }\n\n  async getCatalogPlaylist(id: string): Promise<Record<string, unknown>> {\n    const storefrontId = await this.storefront.getStorefront();\n    return this.getCatalogResource(`/v1/catalog/${storefrontId}/playlists/${id}`, mapPlaylist);\n  }\n\n  async getCatalogStation(id: string): Promise<Record<string, unknown>> {\n    const storefrontId = await this.storefront.getStorefront();\n    return this.getCatalogResource(`/v1/catalog/${storefrontId}/stations/${id}`, mapStation);\n  }\n\n  async getCatalogMusicVideo(id: string): Promise<Record<string, unknown>> {\n    const storefrontId = await this.storefront.getStorefront();\n    return this.getCatalogResource(`/v1/catalog/${storefrontId}/music-videos/${id}`, mapMusicVideo);\n  }\n\n  async getCatalogResources(\n    type: CatalogResourceType,\n    ids: string[],\n  ): Promise<Record<string, unknown>[]> {\n    const trimmed = ids.map((id) => id.trim()).filter((id) => id.length > 0);\n    if (trimmed.length === 0) {\n      return [];\n    }\n    const storefrontId = await this.storefront.getStorefront();\n    const json = await this.transport.getJson(`/v1/catalog/${storefrontId}/${type}`, {\n      ids: trimmed.join(','),\n    });\n    const mapper = catalogResourceMapper(type);\n    return mapTopLevelResourceArray(json.data, mapper);\n  }\n\n  private async getCatalogRelationship(\n    path: string,\n    limit: number,\n    offset: number,\n    mapper: (resource: AppleMusicApiResource) => Record<string, unknown>,\n  ): Promise<Record<string, unknown>[]> {\n    const json = await this.transport.getJson(path, {\n      limit: String(limit),\n      offset: String(offset),\n    });\n    return mapTopLevelResourceArray(json.data, mapper);\n  }\n\n  async getCatalogAlbumTracks(\n    albumId: string,\n    limit: number,\n    offset: number,\n  ): Promise<Record<string, unknown>[]> {\n    const storefrontId = await this.storefront.getStorefront();\n    return this.getCatalogRelationship(\n      `/v1/catalog/${storefrontId}/albums/${albumId}/tracks`,\n      limit,\n      offset,\n      mapSong,\n    );\n  }\n\n  async getCatalogArtistAlbums(\n    artistId: string,\n    limit: number,\n    offset: number,\n  ): Promise<Record<string, unknown>[]> {\n    const storefrontId = await this.storefront.getStorefront();\n    return this.getCatalogRelationship(\n      `/v1/catalog/${storefrontId}/artists/${artistId}/albums`,\n      limit,\n      offset,\n      mapAlbum,\n    );\n  }\n\n  async getCatalogPlaylistTracks(\n    playlistId: string,\n    limit: number,\n    offset: number,\n  ): Promise<Record<string, unknown>[]> {\n    const storefrontId = await this.storefront.getStorefront();\n    return this.getCatalogRelationship(\n      `/v1/catalog/${storefrontId}/playlists/${playlistId}/tracks`,\n      limit,\n      offset,\n      mapSong,\n    );\n  }\n\n  async getCatalogCharts(\n    types: string[],\n    limit: number,\n    offset: number,\n    genre?: string | null,\n    chart?: string | null,\n  ): Promise<CatalogChartsResult> {\n    const storefrontId = await this.storefront.getStorefront();\n    const typeParam =\n      types\n        .map((t) => catalogChartTypeParam(t))\n        .filter((t): t is string => t !== null)\n        .filter((t, i, arr) => arr.indexOf(t) === i)\n        .join(',') || 'songs,albums';\n\n    const query: Record<string, string> = {\n      types: typeParam,\n      limit: String(limit),\n      offset: String(offset),\n    };\n    if (genre) {\n      query.genre = genre;\n    }\n    if (chart) {\n      query.chart = chart;\n    }\n    const json = await this.transport.getJson(`/v1/catalog/${storefrontId}/charts`, query);\n    const results = json.results ?? {};\n    return {\n      songs: mapResourceArray(results.songs?.data, mapSong),\n      albums: mapResourceArray(results.albums?.data, mapAlbum),\n      playlists: mapResourceArray(results.playlists?.data, mapPlaylist),\n      musicVideos: mapResourceArray(results['music-videos']?.data, mapMusicVideo),\n    };\n  }\n}\n"]}

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

@@ -0,0 +1,37 @@
+import type { AppleMusicRestTransport } from './apple-music-rest-transport';
+/** History-domain Apple Music REST (recently played, heavy rotation). */
+export declare class HistoryRestClient {
+    private readonly transport;
+    constructor(transport: AppleMusicRestTransport);
+    getRecentlyPlayed(musicUserToken: string): Promise<{
+        id: string;
+        title: string;
+        subtitle: string;
+        type: string;
+    }[]>;
+    getRecentlyPlayedTracks(musicUserToken: string, limit: number): Promise<{
+        id: string;
+        title: string;
+        artistName: string;
+        artworkUrl: string;
+        duration: number;
+    }[]>;
+    getHeavyRotation(musicUserToken: string, limit: number): Promise<{
+        id: string;
+        title: string;
+        subtitle: string;
+        type: string;
+    }[]>;
+    getRecentlyPlayedStations(musicUserToken: string, limit: number): Promise<{
+        id: string;
+        name: string;
+        artworkUrl: string;
+    }[]>;
+    getRecentlyAdded(musicUserToken: string, limit: number, offset: number): Promise<{
+        id: string;
+        title: string;
+        subtitle: string;
+        type: string;
+    }[]>;
+}
+//# sourceMappingURL=history-rest-client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"history-rest-client.d.ts","sourceRoot":"","sources":["../../src/rest/history-rest-client.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAG5E,yEAAyE;AACzE,qBAAa,iBAAiB;IAChB,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAAT,SAAS,EAAE,uBAAuB;IAEzD,iBAAiB,CAAC,cAAc,EAAE,MAAM;;;;;;IAKxC,uBAAuB,CAAC,cAAc,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;;;;;;;IAS7D,gBAAgB,CAAC,cAAc,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;;;;;;IAStD,yBAAyB,CAAC,cAAc,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;;;;;IAS/D,gBAAgB,CAAC,cAAc,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;;;;;;CAQ7E"}

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

@@ -0,0 +1,30 @@
+import { mapRecentlyPlayed, mapRecentResource, mapSong, mapStation, } from '../mappers/apple-music-json-mapper';
+import { mapTopLevelResourceArray } from './rest-json';
+/** History-domain Apple Music REST (recently played, heavy rotation). */
+export class HistoryRestClient {
+    transport;
+    constructor(transport) {
+        this.transport = transport;
+    }
+    async getRecentlyPlayed(musicUserToken) {
+        const json = await this.transport.getJson('/v1/me/recent/played', { limit: '10' }, musicUserToken);
+        return mapTopLevelResourceArray(json.data, mapRecentlyPlayed);
+    }
+    async getRecentlyPlayedTracks(musicUserToken, limit) {
+        const json = await this.transport.getJson('/v1/me/recent/played/tracks', { limit: String(limit) }, musicUserToken);
+        return mapTopLevelResourceArray(json.data, mapSong);
+    }
+    async getHeavyRotation(musicUserToken, limit) {
+        const json = await this.transport.getJson('/v1/me/history/heavy-rotation', { limit: String(limit) }, musicUserToken);
+        return mapTopLevelResourceArray(json.data, mapRecentResource);
+    }
+    async getRecentlyPlayedStations(musicUserToken, limit) {
+        const json = await this.transport.getJson('/v1/me/recent/radio-stations', { limit: String(limit) }, musicUserToken);
+        return mapTopLevelResourceArray(json.data, mapStation);
+    }
+    async getRecentlyAdded(musicUserToken, limit, offset) {
+        const json = await this.transport.getJson('/v1/me/library/recently-added', { limit: String(limit), offset: String(offset) }, musicUserToken);
+        return mapTopLevelResourceArray(json.data, mapRecentResource);
+    }
+}
+//# sourceMappingURL=history-rest-client.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"history-rest-client.js","sourceRoot":"","sources":["../../src/rest/history-rest-client.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,OAAO,EACP,UAAU,GACX,MAAM,oCAAoC,CAAC;AAE5C,OAAO,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAEvD,yEAAyE;AACzE,MAAM,OAAO,iBAAiB;IACC;IAA7B,YAA6B,SAAkC;QAAlC,cAAS,GAAT,SAAS,CAAyB;IAAG,CAAC;IAEnE,KAAK,CAAC,iBAAiB,CAAC,cAAsB;QAC5C,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,sBAAsB,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,cAAc,CAAC,CAAC;QACnG,OAAO,wBAAwB,CAAC,IAAI,CAAC,IAAI,EAAE,iBAAiB,CAAC,CAAC;IAChE,CAAC;IAED,KAAK,CAAC,uBAAuB,CAAC,cAAsB,EAAE,KAAa;QACjE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,CACvC,6BAA6B,EAC7B,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,EACxB,cAAc,CACf,CAAC;QACF,OAAO,wBAAwB,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACtD,CAAC;IAED,KAAK,CAAC,gBAAgB,CAAC,cAAsB,EAAE,KAAa;QAC1D,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,CACvC,+BAA+B,EAC/B,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,EACxB,cAAc,CACf,CAAC;QACF,OAAO,wBAAwB,CAAC,IAAI,CAAC,IAAI,EAAE,iBAAiB,CAAC,CAAC;IAChE,CAAC;IAED,KAAK,CAAC,yBAAyB,CAAC,cAAsB,EAAE,KAAa;QACnE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,CACvC,8BAA8B,EAC9B,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,EACxB,cAAc,CACf,CAAC;QACF,OAAO,wBAAwB,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IACzD,CAAC;IAED,KAAK,CAAC,gBAAgB,CAAC,cAAsB,EAAE,KAAa,EAAE,MAAc;QAC1E,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,CACvC,+BAA+B,EAC/B,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,EAChD,cAAc,CACf,CAAC;QACF,OAAO,wBAAwB,CAAC,IAAI,CAAC,IAAI,EAAE,iBAAiB,CAAC,CAAC;IAChE,CAAC;CACF","sourcesContent":["import {\n  mapRecentlyPlayed,\n  mapRecentResource,\n  mapSong,\n  mapStation,\n} from '../mappers/apple-music-json-mapper';\nimport type { AppleMusicRestTransport } from './apple-music-rest-transport';\nimport { mapTopLevelResourceArray } from './rest-json';\n\n/** History-domain Apple Music REST (recently played, heavy rotation). */\nexport class HistoryRestClient {\n  constructor(private readonly transport: AppleMusicRestTransport) {}\n\n  async getRecentlyPlayed(musicUserToken: string) {\n    const json = await this.transport.getJson('/v1/me/recent/played', { limit: '10' }, musicUserToken);\n    return mapTopLevelResourceArray(json.data, mapRecentlyPlayed);\n  }\n\n  async getRecentlyPlayedTracks(musicUserToken: string, limit: number) {\n    const json = await this.transport.getJson(\n      '/v1/me/recent/played/tracks',\n      { limit: String(limit) },\n      musicUserToken,\n    );\n    return mapTopLevelResourceArray(json.data, mapSong);\n  }\n\n  async getHeavyRotation(musicUserToken: string, limit: number) {\n    const json = await this.transport.getJson(\n      '/v1/me/history/heavy-rotation',\n      { limit: String(limit) },\n      musicUserToken,\n    );\n    return mapTopLevelResourceArray(json.data, mapRecentResource);\n  }\n\n  async getRecentlyPlayedStations(musicUserToken: string, limit: number) {\n    const json = await this.transport.getJson(\n      '/v1/me/recent/radio-stations',\n      { limit: String(limit) },\n      musicUserToken,\n    );\n    return mapTopLevelResourceArray(json.data, mapStation);\n  }\n\n  async getRecentlyAdded(musicUserToken: string, limit: number, offset: number) {\n    const json = await this.transport.getJson(\n      '/v1/me/library/recently-added',\n      { limit: String(limit), offset: String(offset) },\n      musicUserToken,\n    );\n    return mapTopLevelResourceArray(json.data, mapRecentResource);\n  }\n}\n"]}

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

@@ -0,0 +1,2 @@
+export { isLibraryId } from '../api/library-ids';
+//# sourceMappingURL=library-ids.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"library-ids.d.ts","sourceRoot":"","sources":["../../src/rest/library-ids.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC"}

package/build/rest/library-ids.js

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"library-ids.js","sourceRoot":"","sources":["../../src/rest/library-ids.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC","sourcesContent":["export { isLibraryId } from '../api/library-ids';\n"]}

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

@@ -0,0 +1,22 @@
+import type { AppleMusicRestTransport } from './apple-music-rest-transport';
+/** Library write/mutation Apple Music REST. */
+export declare class LibraryMutationsRestClient {
+    private readonly transport;
+    constructor(transport: AppleMusicRestTransport);
+    addToLibrary(musicUserToken: string, resourceIds: Record<string, string[]>): Promise<void>;
+    createLibraryPlaylist(musicUserToken: string, name: string, description: string | null, isPublic: boolean, tracks: {
+        id: string;
+        type: string;
+    }[] | null): Promise<{
+        id: string;
+        name: string;
+        description: string;
+        artworkUrl: string;
+        trackCount: number;
+    }>;
+    addTracksToLibraryPlaylist(musicUserToken: string, playlistId: string, tracks: {
+        id: string;
+        type: string;
+    }[]): Promise<void>;
+}
+//# sourceMappingURL=library-mutations-rest-client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"library-mutations-rest-client.d.ts","sourceRoot":"","sources":["../../src/rest/library-mutations-rest-client.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAG5E,+CAA+C;AAC/C,qBAAa,0BAA0B;IACzB,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAAT,SAAS,EAAE,uBAAuB;IAEzD,YAAY,CAAC,cAAc,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;IAI1E,qBAAqB,CACzB,cAAc,EAAE,MAAM,EACtB,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,GAAG,IAAI,EAC1B,QAAQ,EAAE,OAAO,EACjB,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,GAAG,IAAI;;;;;;;IA4BzC,0BAA0B,CAC9B,cAAc,EAAE,MAAM,EACtB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE;CAUzC"}