@wwdrew/expo-apple-music 1.0.0

package/ios/bridge/ExpoBridgeLibrary.swift

@@ -0,0 +1,93 @@
+import Foundation
+
+@available(iOS 16.0, *)
+enum ExpoBridgeLibrary {
+  static func getUserPlaylists(
+    service: LibraryService,
+    musicUserToken: String,
+    options: NSDictionary
+  ) async throws -> [String: Any] {
+    try await AppleMusicBridgeError.rethrow {
+      let pagination = BridgePagination(from: options)
+      let playlists = try await service.getPlaylists(musicUserToken: musicUserToken, options: pagination)
+      return BridgeResponses.playlists(playlists)
+    }
+  }
+
+  static func getLibrarySongs(
+    service: LibraryService,
+    musicUserToken: String,
+    options: NSDictionary
+  ) async throws -> [String: Any] {
+    try await AppleMusicBridgeError.rethrow {
+      let pagination = BridgePagination(from: options)
+      let songs = try await service.getSongs(musicUserToken: musicUserToken, options: pagination)
+      return BridgeResponses.songs(songs)
+    }
+  }
+
+  static func getPlaylistSongs(
+    service: LibraryService,
+    musicUserToken: String,
+    playlistId: String
+  ) async throws -> [String: Any] {
+    try await AppleMusicBridgeError.rethrow {
+      let songs = try await service.getPlaylistSongs(musicUserToken: musicUserToken, playlistId: playlistId)
+      return BridgeResponses.songs(songs)
+    }
+  }
+
+  static func getLibraryArtists(
+    service: LibraryService,
+    musicUserToken: String,
+    options: NSDictionary
+  ) async throws -> [String: Any] {
+    try await AppleMusicBridgeError.rethrow {
+      let pagination = BridgePagination(from: options)
+      let artists = try await service.getArtists(musicUserToken: musicUserToken, options: pagination)
+      return BridgeResponses.artists(artists)
+    }
+  }
+
+  static func getLibraryAlbums(
+    service: LibraryService,
+    musicUserToken: String,
+    options: NSDictionary
+  ) async throws -> [String: Any] {
+    try await AppleMusicBridgeError.rethrow {
+      let pagination = BridgePagination(from: options)
+      let albums = try await service.getAlbums(musicUserToken: musicUserToken, options: pagination)
+      return BridgeResponses.albums(albums)
+    }
+  }
+
+  static func getLibraryMusicVideos(
+    service: LibraryService,
+    musicUserToken: String,
+    options: NSDictionary
+  ) async throws -> [String: Any] {
+    try await AppleMusicBridgeError.rethrow {
+      let pagination = BridgePagination(from: options)
+      let musicVideos = try await service.getMusicVideos(musicUserToken: musicUserToken, options: pagination)
+      return BridgeResponses.musicVideos(musicVideos)
+    }
+  }
+
+  static func librarySearch(
+    service: LibraryService,
+    musicUserToken: String,
+    term: String,
+    types: [String],
+    options: NSDictionary
+  ) async throws -> [String: Any] {
+    try await AppleMusicBridgeError.rethrow {
+      let pagination = BridgePagination(from: options)
+      let result = try await service.search(
+        musicUserToken: musicUserToken,
+        term: term,
+        types: types,
+        options: pagination)
+      return BridgeResponses.librarySearch(result)
+    }
+  }
+}

package/ios/bridge/ExpoBridgeRecommendations.swift

@@ -0,0 +1,28 @@
+import Foundation
+
+@available(iOS 16.0, *)
+enum ExpoBridgeRecommendations {
+  static func getRecommendations(
+    service: RecommendationsService,
+    musicUserToken: String,
+    ids: [String]?
+  ) async throws -> [String: Any] {
+    try await AppleMusicBridgeError.rethrow {
+      let recommendations = try await service.getRecommendations(
+        musicUserToken: musicUserToken,
+        ids: ids)
+      return BridgeResponses.recommendations(recommendations)
+    }
+  }
+
+  static func getReplay(
+    service: RecommendationsService,
+    musicUserToken: String,
+    year: Int?
+  ) async throws -> [String: Any] {
+    try await AppleMusicBridgeError.rethrow {
+      let summaries = try await service.getReplay(musicUserToken: musicUserToken, year: year)
+      return BridgeResponses.replaySummaries(summaries)
+    }
+  }
+}

package/package.json

@@ -0,0 +1,89 @@
+{
+  "name": "@wwdrew/expo-apple-music",
+  "version": "1.0.0",
+  "description": "Apple MusicKit wrapper for Expo",
+  "main": "build/index.js",
+  "types": "build/index.d.ts",
+  "scripts": {
+    "build": "expo-module build && expo-module build plugin",
+    "clean": "expo-module clean",
+    "lint": "expo-module lint",
+    "test": "jest --watchman=false",
+    "test:expo": "expo-module test",
+    "prepare": "expo-module prepare",
+    "prepublishOnly": "node scripts/npm-prepublish.mjs && expo-module prepublishOnly",
+    "pack:check": "npm run build && node scripts/verify-npm-pack.mjs",
+    "expo-module": "expo-module",
+    "dev-token": "node scripts/generate-developer-token.mjs",
+    "sync:fixtures": "node scripts/sync-android-fixtures.mjs",
+    "open:ios": "xed example/ios",
+    "open:android": "open -a \"Android Studio\" example/android"
+  },
+  "keywords": [
+    "react-native",
+    "expo",
+    "expo-module",
+    "apple-music",
+    "music-kit",
+    "musickit",
+    "ios",
+    "android",
+    "web"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/wwdrew/expo-apple-music.git"
+  },
+  "bugs": {
+    "url": "https://github.com/wwdrew/expo-apple-music/issues"
+  },
+  "author": "Drew <49833875+wwdrew@users.noreply.github.com> (https://github.com/wwdrew)",
+  "license": "Apache-2.0",
+  "homepage": "https://github.com/wwdrew/expo-apple-music/tree/main/docs",
+  "files": [
+    "app.plugin.js",
+    "expo-module.config.json",
+    "build",
+    "plugin/build",
+    "ios",
+    "android/build.gradle",
+    "android/src/main",
+    "android/libs",
+    "LICENSE",
+    "NOTICE",
+    "ATTRIBUTION.md"
+  ],
+  "expo": {
+    "plugin": "./app.plugin.js"
+  },
+  "devDependencies": {
+    "@expo/config-plugins": "^56.0.7",
+    "@types/node": "^22.10.0",
+    "@types/react": "~19.1.1",
+    "eslint": "^9.39.0",
+    "expo": "^56.0.3",
+    "expo-module-scripts": "^56.0.2",
+    "jest": "^29.7.0",
+    "react": "^19.1.0",
+    "react-native": "^0.85.3",
+    "ts-jest": "^29.2.5",
+    "typescript": "~6.0.3"
+  },
+  "exports": {
+    ".": {
+      "types": "./build/index.d.ts",
+      "default": "./build/index.js"
+    },
+    "./plugin": {
+      "types": "./plugin/build/index.d.ts",
+      "default": "./plugin/build/index.js"
+    }
+  },
+  "peerDependencies": {
+    "@expo/config-plugins": ">=9.0.0",
+    "expo": "^56.0.0",
+    "expo-modules-core": "*",
+    "react": "*",
+    "react-native": "*"
+  }
+}

package/plugin/build/index.d.ts

@@ -0,0 +1,5 @@
+import type { ExpoAppleMusicPluginProps } from "./with-expo-apple-music";
+export type { ExpoAppleMusicPluginProps } from "./with-expo-apple-music";
+export { DEFAULT_MUSIC_USAGE } from "./with-expo-apple-music";
+/** Typed `app.config` plugin entry (Expo SDK 56+). */
+export default function expoAppleMusic(props?: ExpoAppleMusicPluginProps): ["@wwdrew/expo-apple-music", ExpoAppleMusicPluginProps | void];

package/plugin/build/index.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_MUSIC_USAGE = void 0;
+exports.default = expoAppleMusic;
+var with_expo_apple_music_1 = require("./with-expo-apple-music");
+Object.defineProperty(exports, "DEFAULT_MUSIC_USAGE", { enumerable: true, get: function () { return with_expo_apple_music_1.DEFAULT_MUSIC_USAGE; } });
+/** Typed `app.config` plugin entry (Expo SDK 56+). */
+function expoAppleMusic(props) {
+    return ["@wwdrew/expo-apple-music", props];
+}

package/plugin/build/with-expo-apple-music.d.ts

@@ -0,0 +1,10 @@
+import { type ConfigPlugin } from "@expo/config-plugins";
+export declare const DEFAULT_MUSIC_USAGE = "Allow $(PRODUCT_NAME) to access Apple Music.";
+export type ExpoAppleMusicPluginProps = {
+    /**
+     * Sets `NSAppleMusicUsageDescription` in the generated iOS Info.plist.
+     */
+    musicUsageDescription?: string;
+};
+declare const withExpoAppleMusic: ConfigPlugin<ExpoAppleMusicPluginProps | void>;
+export default withExpoAppleMusic;

package/plugin/build/with-expo-apple-music.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_MUSIC_USAGE = void 0;
+const config_plugins_1 = require("@expo/config-plugins");
+/** MusicKit APIs used by this module require iOS 16.4+ (Expo SDK 56 minimum). */
+const IOS_DEPLOYMENT_TARGET = "16.4";
+const withIosDeploymentTargetPodfile = config_plugins_1.IOSConfig.BuildProperties.createBuildPodfilePropsConfigPlugin([
+    {
+        propName: "ios.deploymentTarget",
+        propValueGetter: () => IOS_DEPLOYMENT_TARGET,
+    },
+], "withExpoAppleMusicIosDeploymentTargetPodfile");
+const withIosDeploymentTargetXcodeProject = (config) => {
+    return (0, config_plugins_1.withXcodeProject)(config, (c) => {
+        const { Target, XcodeUtils } = config_plugins_1.IOSConfig;
+        const project = c.modResults;
+        const targetBuildConfigListIds = Target.getNativeTargets(project)
+            .filter(([_, target]) => Target.isTargetOfType(target, Target.TargetType.APPLICATION))
+            .map(([_, target]) => target.buildConfigurationList);
+        for (const buildConfigListId of targetBuildConfigListIds) {
+            for (const [, configurations] of XcodeUtils.getBuildConfigurationsForListId(project, buildConfigListId)) {
+                const { buildSettings } = configurations;
+                if (buildSettings?.IPHONEOS_DEPLOYMENT_TARGET) {
+                    buildSettings.IPHONEOS_DEPLOYMENT_TARGET = IOS_DEPLOYMENT_TARGET;
+                }
+            }
+        }
+        return c;
+    });
+};
+exports.DEFAULT_MUSIC_USAGE = "Allow $(PRODUCT_NAME) to access Apple Music.";
+const withExpoAppleMusic = (config, props) => {
+    const { musicUsageDescription } = props ?? {};
+    config = withIosDeploymentTargetPodfile(config);
+    config = withIosDeploymentTargetXcodeProject(config);
+    return (0, config_plugins_1.withInfoPlist)(config, (c) => {
+        const current = c.modResults.NSAppleMusicUsageDescription;
+        const hasCurrent = typeof current === "string" && current.trim().length > 0;
+        const hasOption = typeof musicUsageDescription === "string" &&
+            musicUsageDescription.trim().length > 0;
+        if (hasOption) {
+            c.modResults.NSAppleMusicUsageDescription = musicUsageDescription;
+        }
+        else if (!hasCurrent) {
+            c.modResults.NSAppleMusicUsageDescription = exports.DEFAULT_MUSIC_USAGE;
+        }
+        return c;
+    });
+};
+exports.default = withExpoAppleMusic;