@wwdrew/expo-apple-music 1.0.0

package/android/src/main/java/expo/modules/applemusic/StorefrontRestClient.kt

@@ -0,0 +1,44 @@
+package expo.modules.applemusic
+
+import java.util.Locale
+import kotlinx.coroutines.Dispatchers
+import kotlinx.coroutines.withContext
+
+/** Resolves and caches the user's Apple Music storefront id for catalog paths. */
+internal class StorefrontRestClient(
+  private val transport: AppleMusicRestTransport,
+) {
+  suspend fun getStorefront(musicUserToken: String): String =
+    resolveStorefront(musicUserToken, allowLocaleFallback = true)
+
+  /** Catalog REST paths — cached storefront or device locale (no music user token). */
+  fun getCatalogStorefront(): String =
+    AuthenticatedSessionCache.storefrontId ?: localeStorefrontId()
+
+  /** Resolves storefront from `/v1/me/storefront` only — required before library playback. */
+  suspend fun requireUserStorefront(musicUserToken: String): String =
+    resolveStorefront(musicUserToken, allowLocaleFallback = false)
+
+  private suspend fun resolveStorefront(musicUserToken: String, allowLocaleFallback: Boolean): String =
+    withContext(Dispatchers.IO) {
+      AuthenticatedSessionCache.storefrontId?.let { return@withContext it }
+      try {
+        val json = transport.getJson(musicUserToken, "/v1/me/storefront")
+        val id = json.getJSONArray("data").getJSONObject(0).getString("id")
+        AuthenticatedSessionCache.storefrontId = id
+        id
+      } catch (error: Exception) {
+        if (allowLocaleFallback) {
+          localeStorefrontId()
+        } else {
+          throw error
+        }
+      }
+    }
+
+  /** Fallback when `/v1/me/storefront` is unavailable (mirrors iOS [StorefrontService]). */
+  fun localeStorefrontId(): String {
+    val region = Locale.getDefault().country
+    return if (region.isNotEmpty()) region.lowercase(Locale.US) else "us"
+  }
+}

package/android/src/main/java/expo/modules/applemusic/bridge/ExpoBridgeAuth.kt

@@ -0,0 +1,69 @@
+package expo.modules.applemusic.bridge
+
+import android.content.Context
+import expo.modules.applemusic.AndroidDeveloperToken
+import expo.modules.applemusic.AndroidPlaybackController
+import expo.modules.applemusic.AndroidSubscriptionService
+import expo.modules.applemusic.BridgeResponses
+import expo.modules.applemusic.MusicKitAuthInput
+import expo.modules.applemusic.MusicKitAuthOutput
+import expo.modules.applemusic.MusicKitAuthStorage
+import expo.modules.kotlin.activityresult.AppContextActivityResultLauncher
+import expo.modules.kotlin.functions.Coroutine
+import expo.modules.kotlin.modules.ModuleDefinitionBuilder
+
+internal fun ModuleDefinitionBuilder.registerAuthBridge(
+  reactContext: () -> Context,
+  authLauncher: () -> AppContextActivityResultLauncher<MusicKitAuthInput, MusicKitAuthOutput>,
+  subscriptionService: () -> AndroidSubscriptionService,
+  libraryService: () -> expo.modules.applemusic.AndroidLibraryService,
+) {
+  AsyncFunction("setDeveloperToken") { token: String ->
+    val trimmed = token.trim()
+    require(trimmed.isNotEmpty()) { "Developer token must not be empty" }
+    val context = reactContext()
+    MusicKitAuthStorage.saveDeveloperToken(context, trimmed)
+    AndroidPlaybackController.getInstance(context).attachPendingListenersAfterDeveloperTokenStored()
+  }
+
+  AsyncFunction("authorization") Coroutine {
+    developerToken: String?,
+    startScreenMessage: String?,
+    hideStartScreen: Boolean?,
+  ->
+    val context = reactContext()
+    val token = AndroidDeveloperToken.require(developerToken)
+    MusicKitAuthStorage.saveDeveloperToken(context, token)
+    AndroidPlaybackController.getInstance(context).attachPendingListenersAfterDeveloperTokenStored()
+    val message = startScreenMessage?.trim()?.takeIf { it.isNotEmpty() }
+    val result =
+      authLauncher().launch(
+        MusicKitAuthInput(
+          developerToken = token,
+          startScreenMessage = message,
+          hideStartScreen = hideStartScreen ?: false,
+        ),
+      )
+
+    if (result.status == "authorized") {
+      result.musicUserToken?.let { userToken ->
+        MusicKitAuthStorage.saveMusicUserToken(context, userToken)
+        AndroidPlaybackController.getInstance(context).applyMusicUserToken(userToken)
+      }
+      AndroidPlaybackController.warmUp(context)
+    }
+
+    mapOf(
+      "status" to result.status,
+      "musicUserToken" to result.musicUserToken,
+    )
+  }
+
+  AsyncFunction("checkSubscription") Coroutine { musicUserToken: String ->
+    subscriptionService().checkSubscription(musicUserToken)
+  }
+
+  AsyncFunction("getStorefront") Coroutine { musicUserToken: String ->
+    BridgeResponses.storefront(libraryService().getStorefrontId(musicUserToken))
+  }
+}

package/android/src/main/java/expo/modules/applemusic/bridge/ExpoBridgeCatalog.kt

@@ -0,0 +1,76 @@
+package expo.modules.applemusic.bridge
+
+import expo.modules.applemusic.AndroidCatalogService
+import expo.modules.applemusic.AppleMusicErrors
+import expo.modules.applemusic.BridgeResponses
+import expo.modules.applemusic.PaginationOptions
+import expo.modules.kotlin.functions.Coroutine
+import expo.modules.kotlin.modules.ModuleDefinitionBuilder
+
+internal fun ModuleDefinitionBuilder.registerCatalogBridge(
+  catalogService: () -> AndroidCatalogService,
+) {
+  AsyncFunction("catalogSearch") Coroutine { term: String, types: List<String>, options: Map<String, Any?> ->
+    val pagination = PaginationOptions.fromMap(options)
+    BridgeResponses.catalogSearch(catalogService().search(term, types, pagination))
+  }
+
+  AsyncFunction("getCatalogSong") Coroutine { id: String ->
+    catalogService().getSong(id)
+  }
+
+  AsyncFunction("getCatalogAlbum") Coroutine { id: String ->
+    catalogService().getAlbum(id)
+  }
+
+  AsyncFunction("getCatalogArtist") Coroutine { id: String ->
+    catalogService().getArtist(id)
+  }
+
+  AsyncFunction("getCatalogPlaylist") Coroutine { id: String ->
+    catalogService().getPlaylist(id)
+  }
+
+  AsyncFunction("getCatalogStation") Coroutine { id: String ->
+    catalogService().getStation(id)
+  }
+
+  AsyncFunction("getCatalogMusicVideo") Coroutine { id: String ->
+    catalogService().getMusicVideo(id)
+  }
+
+  AsyncFunction("getCatalogAlbumTracks") Coroutine { albumId: String, options: Map<String, Any?> ->
+    val pagination = PaginationOptions.fromMap(options)
+    BridgeResponses.songs(catalogService().getAlbumTracks(albumId, pagination))
+  }
+
+  AsyncFunction("getCatalogArtistAlbums") Coroutine { artistId: String, options: Map<String, Any?> ->
+    val pagination = PaginationOptions.fromMap(options)
+    BridgeResponses.albums(catalogService().getArtistAlbums(artistId, pagination))
+  }
+
+  AsyncFunction("getCatalogPlaylistTracks") Coroutine { playlistId: String, options: Map<String, Any?> ->
+    val pagination = PaginationOptions.fromMap(options)
+    BridgeResponses.songs(catalogService().getPlaylistTracks(playlistId, pagination))
+  }
+
+  AsyncFunction("getCatalogCharts") Coroutine { types: List<String>, options: Map<String, Any?> ->
+    val pagination = PaginationOptions.fromMap(options)
+    val genre = options["genre"] as? String
+    val chart = options["chart"] as? String
+    BridgeResponses.catalogCharts(catalogService().getCharts(types, pagination, genre, chart))
+  }
+
+  AsyncFunction("getCatalogResources") Coroutine { type: String, ids: List<String> ->
+    val items = catalogService().getResources(type, ids)
+    when (type) {
+      "songs" -> BridgeResponses.songs(items)
+      "albums" -> BridgeResponses.albums(items)
+      "artists" -> BridgeResponses.artists(items)
+      "playlists" -> BridgeResponses.playlists(items)
+      "stations" -> BridgeResponses.stations(items)
+      "music-videos" -> BridgeResponses.musicVideos(items)
+      else -> throw AppleMusicErrors.unknownMediaType(type)
+    }
+  }
+}

package/android/src/main/java/expo/modules/applemusic/bridge/ExpoBridgeHistory.kt

@@ -0,0 +1,35 @@
+package expo.modules.applemusic.bridge
+
+import expo.modules.applemusic.AndroidHistoryService
+import expo.modules.applemusic.BridgeResponses
+import expo.modules.applemusic.PaginationOptions
+import expo.modules.kotlin.functions.Coroutine
+import expo.modules.kotlin.modules.ModuleDefinitionBuilder
+
+internal fun ModuleDefinitionBuilder.registerHistoryBridge(
+  historyService: () -> AndroidHistoryService,
+) {
+  AsyncFunction("getRecentlyPlayedResources") Coroutine { musicUserToken: String ->
+    BridgeResponses.recentlyPlayedResources(historyService().getRecentlyPlayedResources(musicUserToken))
+  }
+
+  AsyncFunction("getRecentlyPlayedTracks") Coroutine { musicUserToken: String, options: Map<String, Any?> ->
+    val pagination = PaginationOptions.fromMap(options)
+    BridgeResponses.songs(historyService().getRecentlyPlayedTracks(musicUserToken, pagination))
+  }
+
+  AsyncFunction("getHeavyRotation") Coroutine { musicUserToken: String, options: Map<String, Any?> ->
+    val pagination = PaginationOptions.fromMap(options)
+    BridgeResponses.recentItems(historyService().getHeavyRotation(musicUserToken, pagination))
+  }
+
+  AsyncFunction("getRecentlyPlayedStations") Coroutine { musicUserToken: String, options: Map<String, Any?> ->
+    val pagination = PaginationOptions.fromMap(options)
+    BridgeResponses.stations(historyService().getRecentlyPlayedStations(musicUserToken, pagination))
+  }
+
+  AsyncFunction("getRecentlyAdded") Coroutine { musicUserToken: String, options: Map<String, Any?> ->
+    val pagination = PaginationOptions.fromMap(options)
+    BridgeResponses.recentItems(historyService().getRecentlyAdded(musicUserToken, pagination))
+  }
+}

package/android/src/main/java/expo/modules/applemusic/bridge/ExpoBridgeLibrary.kt

@@ -0,0 +1,54 @@
+package expo.modules.applemusic.bridge
+
+import expo.modules.applemusic.AndroidLibraryService
+import expo.modules.applemusic.BridgeResponses
+import expo.modules.applemusic.PaginationOptions
+import expo.modules.kotlin.functions.Coroutine
+import expo.modules.kotlin.modules.ModuleDefinitionBuilder
+
+internal fun ModuleDefinitionBuilder.registerLibraryBridge(
+  libraryService: () -> AndroidLibraryService,
+) {
+  AsyncFunction("getUserPlaylists") Coroutine { musicUserToken: String, options: Map<String, Any?> ->
+    val pagination = PaginationOptions.fromMap(options)
+    BridgeResponses.playlists(libraryService().getPlaylists(musicUserToken, pagination))
+  }
+
+  AsyncFunction("getLibrarySongs") Coroutine { musicUserToken: String, options: Map<String, Any?> ->
+    val pagination = PaginationOptions.fromMap(options)
+    BridgeResponses.songs(libraryService().getSongs(musicUserToken, pagination))
+  }
+
+  AsyncFunction("getPlaylistSongs") Coroutine {
+      musicUserToken: String,
+      playlistId: String,
+      options: Map<String, Any?>,
+    ->
+    BridgeResponses.songs(libraryService().getPlaylistSongs(musicUserToken, playlistId))
+  }
+
+  AsyncFunction("getLibraryArtists") Coroutine { musicUserToken: String, options: Map<String, Any?> ->
+    val pagination = PaginationOptions.fromMap(options)
+    BridgeResponses.artists(libraryService().getArtists(musicUserToken, pagination))
+  }
+
+  AsyncFunction("getLibraryAlbums") Coroutine { musicUserToken: String, options: Map<String, Any?> ->
+    val pagination = PaginationOptions.fromMap(options)
+    BridgeResponses.albums(libraryService().getAlbums(musicUserToken, pagination))
+  }
+
+  AsyncFunction("getLibraryMusicVideos") Coroutine { musicUserToken: String, options: Map<String, Any?> ->
+    val pagination = PaginationOptions.fromMap(options)
+    BridgeResponses.musicVideos(libraryService().getMusicVideos(musicUserToken, pagination))
+  }
+
+  AsyncFunction("librarySearch") Coroutine {
+      musicUserToken: String,
+      term: String,
+      types: List<String>,
+      options: Map<String, Any?>,
+    ->
+    val pagination = PaginationOptions.fromMap(options)
+    BridgeResponses.librarySearch(libraryService().search(musicUserToken, term, types, pagination))
+  }
+}

package/android/src/main/java/expo/modules/applemusic/bridge/ExpoBridgeLibraryMutations.kt

@@ -0,0 +1,30 @@
+package expo.modules.applemusic.bridge
+
+import expo.modules.applemusic.AndroidLibraryMutationsService
+import expo.modules.kotlin.functions.Coroutine
+import expo.modules.kotlin.modules.ModuleDefinitionBuilder
+
+internal fun ModuleDefinitionBuilder.registerLibraryMutationsBridge(
+  libraryMutationsService: () -> AndroidLibraryMutationsService,
+) {
+  AsyncFunction("addToLibrary") Coroutine { musicUserToken: String, resourceIds: Map<String, List<String>> ->
+    libraryMutationsService().addToLibrary(musicUserToken, resourceIds)
+  }
+
+  AsyncFunction("createLibraryPlaylist") Coroutine { musicUserToken: String, options: Map<String, Any?> ->
+    val name = options["name"] as? String ?: ""
+    val description = options["description"] as? String
+    val isPublic = options["isPublic"] as? Boolean ?: false
+    @Suppress("UNCHECKED_CAST")
+    val tracks = options["tracks"] as? List<Map<String, String>>
+    libraryMutationsService().createPlaylist(musicUserToken, name, description, isPublic, tracks)
+  }
+
+  AsyncFunction("addTracksToLibraryPlaylist") Coroutine {
+      musicUserToken: String,
+      playlistId: String,
+      tracks: List<Map<String, String>>,
+    ->
+    libraryMutationsService().addTracksToPlaylist(musicUserToken, playlistId, tracks)
+  }
+}

package/android/src/main/java/expo/modules/applemusic/bridge/ExpoBridgePlayer.kt

@@ -0,0 +1,89 @@
+package expo.modules.applemusic.bridge
+
+import com.apple.android.music.playback.model.MediaPlayerException
+import expo.modules.applemusic.AndroidPlaybackController
+import expo.modules.applemusic.AndroidQueueService
+import expo.modules.kotlin.functions.Coroutine
+import expo.modules.kotlin.modules.ModuleDefinitionBuilder
+import kotlinx.coroutines.CoroutineScope
+import kotlinx.coroutines.launch
+
+internal fun ModuleDefinitionBuilder.registerPlayerBridge(
+  moduleScope: CoroutineScope,
+  playbackController: () -> AndroidPlaybackController,
+  queueService: () -> AndroidQueueService,
+  emitPlaybackError: (Exception, String) -> Unit,
+  emitPlaybackTimeUpdate: (Double) -> Unit,
+) {
+  AsyncFunction("setPlaybackQueue") Coroutine { itemId: String, type: String ->
+    try {
+      queueService().setQueue(itemId, type)
+      "Track(s) added to queue"
+    } catch (error: Exception) {
+      throw AndroidPlaybackController.mapPlaybackException(error)
+    }
+  }
+
+  AsyncFunction("playLibrarySong") Coroutine { musicUserToken: String, songId: String ->
+    queueService().playLibrarySong(musicUserToken, songId)
+    "Library song added to queue"
+  }
+
+  AsyncFunction("playLibraryPlaylist") Coroutine { musicUserToken: String, playlistId: String, startingAt: Int ->
+    queueService().playLibraryPlaylist(musicUserToken, playlistId, startingAt)
+    "Library playlist added to queue"
+  }
+
+  AsyncFunction("configurePlayer") { mixWithOthers: Boolean ->
+    playbackController().configurePlayer(mixWithOthers)
+  }
+
+  AsyncFunction("getCurrentState") {
+    playbackController().currentState()
+  }
+
+  Function("play") {
+    runPlayback(moduleScope, emitPlaybackError, "play") { playbackController().play() }
+  }
+
+  Function("pause") {
+    playbackController().pause()
+  }
+
+  Function("skipToNextEntry") {
+    runPlayback(moduleScope, emitPlaybackError, "skipToNext") { playbackController().skipToNext() }
+  }
+
+  Function("skipToPreviousEntry") {
+    runPlayback(moduleScope, emitPlaybackError, "skipToPrevious") { playbackController().skipToPrevious() }
+  }
+
+  Function("restartCurrentEntry") {
+    playbackController().restartCurrentEntry { time -> emitPlaybackTimeUpdate(time) }
+  }
+
+  Function("seekToTime") { time: Double ->
+    playbackController().seekToTime(time) { actual -> emitPlaybackTimeUpdate(actual) }
+  }
+
+  Function("togglePlayerState") {
+    runPlayback(moduleScope, emitPlaybackError, "togglePlayback") { playbackController().togglePlayback() }
+  }
+}
+
+private fun runPlayback(
+  scope: CoroutineScope,
+  emitPlaybackError: (Exception, String) -> Unit,
+  operation: String,
+  block: () -> Unit,
+) {
+  scope.launch {
+    try {
+      block()
+    } catch (error: MediaPlayerException) {
+      emitPlaybackError(error, operation)
+    } catch (error: Exception) {
+      emitPlaybackError(error, operation)
+    }
+  }
+}

package/android/src/main/java/expo/modules/applemusic/bridge/ExpoBridgeRatings.kt

@@ -0,0 +1,29 @@
+package expo.modules.applemusic.bridge
+
+import expo.modules.applemusic.AndroidRatingsService
+import expo.modules.kotlin.functions.Coroutine
+import expo.modules.kotlin.modules.ModuleDefinitionBuilder
+
+internal fun ModuleDefinitionBuilder.registerRatingsBridge(
+  ratingsService: () -> AndroidRatingsService,
+) {
+  AsyncFunction("getRating") Coroutine { musicUserToken: String, resourceType: String, id: String ->
+    ratingsService().getRating(musicUserToken, resourceType, id)
+  }
+
+  AsyncFunction("setRating") Coroutine { musicUserToken: String, resourceType: String, id: String, value: Int ->
+    ratingsService().setRating(musicUserToken, resourceType, id, value)
+  }
+
+  AsyncFunction("clearRating") Coroutine { musicUserToken: String, resourceType: String, id: String ->
+    ratingsService().clearRating(musicUserToken, resourceType, id)
+  }
+
+  AsyncFunction("addToFavorites") Coroutine { musicUserToken: String, resourceIds: Map<String, List<String>> ->
+    ratingsService().addToFavorites(musicUserToken, resourceIds)
+  }
+
+  AsyncFunction("removeFromFavorites") Coroutine { musicUserToken: String, resourceIds: Map<String, List<String>> ->
+    ratingsService().removeFromFavorites(musicUserToken, resourceIds)
+  }
+}

package/android/src/main/java/expo/modules/applemusic/bridge/ExpoBridgeRecommendations.kt

@@ -0,0 +1,18 @@
+package expo.modules.applemusic.bridge
+
+import expo.modules.applemusic.AndroidRecommendationsService
+import expo.modules.applemusic.BridgeResponses
+import expo.modules.kotlin.functions.Coroutine
+import expo.modules.kotlin.modules.ModuleDefinitionBuilder
+
+internal fun ModuleDefinitionBuilder.registerRecommendationsBridge(
+  recommendationsService: () -> AndroidRecommendationsService,
+) {
+  AsyncFunction("getRecommendations") Coroutine { musicUserToken: String, ids: List<String>? ->
+    BridgeResponses.recommendations(recommendationsService().getRecommendations(musicUserToken, ids))
+  }
+
+  AsyncFunction("getReplay") Coroutine { musicUserToken: String, year: Int? ->
+    BridgeResponses.replaySummaries(recommendationsService().getReplay(musicUserToken, year))
+  }
+}

package/app.plugin.js

@@ -0,0 +1 @@
+module.exports = require('./plugin/build/with-expo-apple-music');

package/build/ExpoAppleMusicModule.web.d.ts

@@ -0,0 +1,15 @@
+import { NativeModule } from 'expo-modules-core';
+export declare class ExpoAppleMusicModule extends NativeModule {
+    __expo_module_name__: string;
+    private readonly api;
+    private readonly subscription;
+    private readonly queue;
+    private readonly playback;
+    private readonly playbackObserver;
+    constructor();
+    startObserving(): void;
+    stopObserving(): void;
+}
+declare const moduleInstance: ExpoAppleMusicModule;
+export default moduleInstance;
+//# sourceMappingURL=ExpoAppleMusicModule.web.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ExpoAppleMusicModule.web.d.ts","sourceRoot":"","sources":["../src/ExpoAppleMusicModule.web.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAqB,MAAM,mBAAmB,CAAC;AASpE,qBAAa,oBAAqB,SAAQ,YAAY;IACpD,oBAAoB,SAAoB;IAExC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAgC;IACpD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAwC;IACrE,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAiC;IACvD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA+B;IACxD,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAA6B;;IAe9D,cAAc,IAAI,IAAI;IAItB,aAAa,IAAI,IAAI;CAGtB;AAED,QAAA,MAAM,cAAc,EAGJ,oBAAoB,CAAC;AAErC,eAAe,cAAc,CAAC"}

package/build/ExpoAppleMusicModule.web.js

@@ -0,0 +1,33 @@
+import { NativeModule, registerWebModule } from 'expo-modules-core';
+import { createWebBridgeHandlers } from './bridge/handlers';
+import { WebAppleMusicApiClient } from './web/WebAppleMusicApiClient';
+import { WebPlaybackController } from './web/WebPlaybackController';
+import { WebPlaybackObserver } from './web/WebPlaybackObserver';
+import { WebQueueService } from './web/WebQueueService';
+import { WebSubscriptionService } from './web/WebSubscriptionService';
+export class ExpoAppleMusicModule extends NativeModule {
+    __expo_module_name__ = 'ExpoAppleMusic';
+    api = new WebAppleMusicApiClient();
+    subscription = new WebSubscriptionService(this.api);
+    queue = new WebQueueService(this.api);
+    playback = new WebPlaybackController();
+    playbackObserver = new WebPlaybackObserver();
+    constructor() {
+        super();
+        Object.assign(this, createWebBridgeHandlers({
+            api: this.api,
+            subscription: this.subscription,
+            queue: this.queue,
+            playback: this.playback,
+        }));
+    }
+    startObserving() {
+        this.playbackObserver.start(this);
+    }
+    stopObserving() {
+        this.playbackObserver.stop();
+    }
+}
+const moduleInstance = registerWebModule(ExpoAppleMusicModule, 'ExpoAppleMusic');
+export default moduleInstance;
+//# sourceMappingURL=ExpoAppleMusicModule.web.js.map

package/build/ExpoAppleMusicModule.web.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExpoAppleMusicModule.web.js","sourceRoot":"","sources":["../src/ExpoAppleMusicModule.web.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAEpE,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AACtE,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AAEtE,MAAM,OAAO,oBAAqB,SAAQ,YAAY;IACpD,oBAAoB,GAAG,gBAAgB,CAAC;IAEvB,GAAG,GAAG,IAAI,sBAAsB,EAAE,CAAC;IACnC,YAAY,GAAG,IAAI,sBAAsB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACpD,KAAK,GAAG,IAAI,eAAe,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACtC,QAAQ,GAAG,IAAI,qBAAqB,EAAE,CAAC;IACvC,gBAAgB,GAAG,IAAI,mBAAmB,EAAE,CAAC;IAE9D;QACE,KAAK,EAAE,CAAC;QACR,MAAM,CAAC,MAAM,CACX,IAAI,EACJ,uBAAuB,CAAC;YACtB,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,QAAQ,EAAE,IAAI,CAAC,QAAQ;SACxB,CAAC,CACH,CAAC;IACJ,CAAC;IAED,cAAc;QACZ,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC;IAED,aAAa;QACX,IAAI,CAAC,gBAAgB,CAAC,IAAI,EAAE,CAAC;IAC/B,CAAC;CACF;AAED,MAAM,cAAc,GAAG,iBAAiB,CACtC,oBAAoB,EACpB,gBAAgB,CACkB,CAAC;AAErC,eAAe,cAAc,CAAC","sourcesContent":["import { NativeModule, registerWebModule } from 'expo-modules-core';\n\nimport { createWebBridgeHandlers } from './bridge/handlers';\nimport { WebAppleMusicApiClient } from './web/WebAppleMusicApiClient';\nimport { WebPlaybackController } from './web/WebPlaybackController';\nimport { WebPlaybackObserver } from './web/WebPlaybackObserver';\nimport { WebQueueService } from './web/WebQueueService';\nimport { WebSubscriptionService } from './web/WebSubscriptionService';\n\nexport class ExpoAppleMusicModule extends NativeModule {\n  __expo_module_name__ = 'ExpoAppleMusic';\n\n  private readonly api = new WebAppleMusicApiClient();\n  private readonly subscription = new WebSubscriptionService(this.api);\n  private readonly queue = new WebQueueService(this.api);\n  private readonly playback = new WebPlaybackController();\n  private readonly playbackObserver = new WebPlaybackObserver();\n\n  constructor() {\n    super();\n    Object.assign(\n      this,\n      createWebBridgeHandlers({\n        api: this.api,\n        subscription: this.subscription,\n        queue: this.queue,\n        playback: this.playback,\n      }),\n    );\n  }\n\n  startObserving(): void {\n    this.playbackObserver.start(this);\n  }\n\n  stopObserving(): void {\n    this.playbackObserver.stop();\n  }\n}\n\nconst moduleInstance = registerWebModule(\n  ExpoAppleMusicModule,\n  'ExpoAppleMusic',\n) as unknown as ExpoAppleMusicModule;\n\nexport default moduleInstance;\n"]}

package/build/api/call-native.d.ts

@@ -0,0 +1,6 @@
+import type { AppleMusicError } from '../utils/apple-music-error';
+export declare function callNative<T>(operation: string, fn: () => Promise<T>): Promise<T>;
+export declare function normalizeNativeError(operation: string, error: unknown): AppleMusicError;
+export declare function invalidLibraryIdError(label: string, id: string): AppleMusicError;
+export declare function throwInvalidLibraryIdError(label: string, id: string): never;
+//# sourceMappingURL=call-native.d.ts.map

package/build/api/call-native.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"call-native.d.ts","sourceRoot":"","sources":["../../src/api/call-native.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAGlE,wBAAsB,UAAU,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAMvF;AAED,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,eAAe,CAkBvF;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,eAAe,CAKhF;AAED,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,KAAK,CAE3E"}

package/build/api/call-native.js

@@ -0,0 +1,35 @@
+import { AppleMusicErrorCode } from '../constants/apple-music-error-codes';
+import { asThrownAppleMusicError, isAppleMusicError } from '../utils/apple-music-error';
+export async function callNative(operation, fn) {
+    try {
+        return await fn();
+    }
+    catch (error) {
+        throw asThrownAppleMusicError(normalizeNativeError(operation, error));
+    }
+}
+export function normalizeNativeError(operation, error) {
+    if (isAppleMusicError(error)) {
+        return error.operation ? error : { ...error, operation };
+    }
+    const coded = error;
+    if (typeof coded.code === 'string' && typeof coded.message === 'string') {
+        return { code: coded.code, message: coded.message, operation };
+    }
+    const message = error instanceof Error
+        ? error.message
+        : typeof error === 'string'
+            ? error
+            : 'Unknown Apple Music error';
+    return { code: AppleMusicErrorCode.error, message, operation };
+}
+export function invalidLibraryIdError(label, id) {
+    return {
+        code: AppleMusicErrorCode.invalidLibraryId,
+        message: `Expected a library resource id (i., l., or p. prefix) for ${label}, got "${id}"`,
+    };
+}
+export function throwInvalidLibraryIdError(label, id) {
+    throw asThrownAppleMusicError(invalidLibraryIdError(label, id));
+}
+//# sourceMappingURL=call-native.js.map

package/build/api/call-native.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"call-native.js","sourceRoot":"","sources":["../../src/api/call-native.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAE3E,OAAO,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAExF,MAAM,CAAC,KAAK,UAAU,UAAU,CAAI,SAAiB,EAAE,EAAoB;IACzE,IAAI,CAAC;QACH,OAAO,MAAM,EAAE,EAAE,CAAC;IACpB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,uBAAuB,CAAC,oBAAoB,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC;IACxE,CAAC;AACH,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,SAAiB,EAAE,KAAc;IACpE,IAAI,iBAAiB,CAAC,KAAK,CAAC,EAAE,CAAC;QAC7B,OAAO,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,SAAS,EAAE,CAAC;IAC3D,CAAC;IAED,MAAM,KAAK,GAAG,KAA8C,CAAC;IAC7D,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;QACxE,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,SAAS,EAAE,CAAC;IACjE,CAAC;IAED,MAAM,OAAO,GACX,KAAK,YAAY,KAAK;QACpB,CAAC,CAAC,KAAK,CAAC,OAAO;QACf,CAAC,CAAC,OAAO,KAAK,KAAK,QAAQ;YACzB,CAAC,CAAC,KAAK;YACP,CAAC,CAAC,2BAA2B,CAAC;IAEpC,OAAO,EAAE,IAAI,EAAE,mBAAmB,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;AACjE,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,KAAa,EAAE,EAAU;IAC7D,OAAO;QACL,IAAI,EAAE,mBAAmB,CAAC,gBAAgB;QAC1C,OAAO,EAAE,6DAA6D,KAAK,UAAU,EAAE,GAAG;KAC3F,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,KAAa,EAAE,EAAU;IAClE,MAAM,uBAAuB,CAAC,qBAAqB,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC;AAClE,CAAC","sourcesContent":["import { AppleMusicErrorCode } from '../constants/apple-music-error-codes';\nimport type { AppleMusicError } from '../utils/apple-music-error';\nimport { asThrownAppleMusicError, isAppleMusicError } from '../utils/apple-music-error';\n\nexport async function callNative<T>(operation: string, fn: () => Promise<T>): Promise<T> {\n  try {\n    return await fn();\n  } catch (error) {\n    throw asThrownAppleMusicError(normalizeNativeError(operation, error));\n  }\n}\n\nexport function normalizeNativeError(operation: string, error: unknown): AppleMusicError {\n  if (isAppleMusicError(error)) {\n    return error.operation ? error : { ...error, operation };\n  }\n\n  const coded = error as { code?: unknown; message?: unknown };\n  if (typeof coded.code === 'string' && typeof coded.message === 'string') {\n    return { code: coded.code, message: coded.message, operation };\n  }\n\n  const message =\n    error instanceof Error\n      ? error.message\n      : typeof error === 'string'\n        ? error\n        : 'Unknown Apple Music error';\n\n  return { code: AppleMusicErrorCode.error, message, operation };\n}\n\nexport function invalidLibraryIdError(label: string, id: string): AppleMusicError {\n  return {\n    code: AppleMusicErrorCode.invalidLibraryId,\n    message: `Expected a library resource id (i., l., or p. prefix) for ${label}, got \"${id}\"`,\n  };\n}\n\nexport function throwInvalidLibraryIdError(label: string, id: string): never {\n  throw asThrownAppleMusicError(invalidLibraryIdError(label, id));\n}\n"]}

package/build/api/decode-jwt-exp.d.ts

@@ -0,0 +1,5 @@
+/** Decode JWT `exp` (seconds since epoch). Returns null if missing or malformed. */
+export declare function decodeJwtExpSeconds(token: string): number | null;
+/** True when `exp` is within `bufferSeconds` of now (or `exp` is missing). */
+export declare function isJwtExpired(token: string, bufferSeconds?: number): boolean;
+//# sourceMappingURL=decode-jwt-exp.d.ts.map

package/build/api/decode-jwt-exp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decode-jwt-exp.d.ts","sourceRoot":"","sources":["../../src/api/decode-jwt-exp.ts"],"names":[],"mappings":"AAEA,oFAAoF;AACpF,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAchE;AAED,8EAA8E;AAC9E,wBAAgB,YAAY,CAC1B,KAAK,EAAE,MAAM,EACb,aAAa,GAAE,MAAuC,GACrD,OAAO,CAOT"}

package/build/api/decode-jwt-exp.js

@@ -0,0 +1,28 @@
+const DEFAULT_REFRESH_BUFFER_SECONDS = 300;
+/** Decode JWT `exp` (seconds since epoch). Returns null if missing or malformed. */
+export function decodeJwtExpSeconds(token) {
+    const parts = token.trim().split('.');
+    const encodedPayload = parts[1];
+    if (parts.length < 2 || encodedPayload == null) {
+        return null;
+    }
+    try {
+        const payload = encodedPayload.replace(/-/g, '+').replace(/_/g, '/');
+        const padded = payload + '='.repeat((4 - (payload.length % 4)) % 4);
+        const json = JSON.parse(atob(padded));
+        return typeof json.exp === 'number' && Number.isFinite(json.exp) ? json.exp : null;
+    }
+    catch {
+        return null;
+    }
+}
+/** True when `exp` is within `bufferSeconds` of now (or `exp` is missing). */
+export function isJwtExpired(token, bufferSeconds = DEFAULT_REFRESH_BUFFER_SECONDS) {
+    const exp = decodeJwtExpSeconds(token);
+    if (exp == null) {
+        return false;
+    }
+    const now = Math.floor(Date.now() / 1000);
+    return exp <= now + bufferSeconds;
+}
+//# sourceMappingURL=decode-jwt-exp.js.map

package/build/api/decode-jwt-exp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decode-jwt-exp.js","sourceRoot":"","sources":["../../src/api/decode-jwt-exp.ts"],"names":[],"mappings":"AAAA,MAAM,8BAA8B,GAAG,GAAG,CAAC;AAE3C,oFAAoF;AACpF,MAAM,UAAU,mBAAmB,CAAC,KAAa;IAC/C,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACtC,MAAM,cAAc,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IAChC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,cAAc,IAAI,IAAI,EAAE,CAAC;QAC/C,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,cAAc,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QACrE,MAAM,MAAM,GAAG,OAAO,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QACpE,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAsB,CAAC;QAC3D,OAAO,OAAO,IAAI,CAAC,GAAG,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;IACrF,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,YAAY,CAC1B,KAAa,EACb,gBAAwB,8BAA8B;IAEtD,MAAM,GAAG,GAAG,mBAAmB,CAAC,KAAK,CAAC,CAAC;IACvC,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC;QAChB,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;IAC1C,OAAO,GAAG,IAAI,GAAG,GAAG,aAAa,CAAC;AACpC,CAAC","sourcesContent":["const DEFAULT_REFRESH_BUFFER_SECONDS = 300;\n\n/** Decode JWT `exp` (seconds since epoch). Returns null if missing or malformed. */\nexport function decodeJwtExpSeconds(token: string): number | null {\n  const parts = token.trim().split('.');\n  const encodedPayload = parts[1];\n  if (parts.length < 2 || encodedPayload == null) {\n    return null;\n  }\n  try {\n    const payload = encodedPayload.replace(/-/g, '+').replace(/_/g, '/');\n    const padded = payload + '='.repeat((4 - (payload.length % 4)) % 4);\n    const json = JSON.parse(atob(padded)) as { exp?: unknown };\n    return typeof json.exp === 'number' && Number.isFinite(json.exp) ? json.exp : null;\n  } catch {\n    return null;\n  }\n}\n\n/** True when `exp` is within `bufferSeconds` of now (or `exp` is missing). */\nexport function isJwtExpired(\n  token: string,\n  bufferSeconds: number = DEFAULT_REFRESH_BUFFER_SECONDS,\n): boolean {\n  const exp = decodeJwtExpSeconds(token);\n  if (exp == null) {\n    return false;\n  }\n  const now = Math.floor(Date.now() / 1000);\n  return exp <= now + bufferSeconds;\n}\n"]}

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

@@ -0,0 +1,4 @@
+/** True when `id` uses an Apple Music library prefix (`i.`, `l.`, `p.`). */
+export declare function isLibraryId(id: string): boolean;
+export declare function assertLibraryId(id: string, label: string): void;
+//# sourceMappingURL=library-ids.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"library-ids.d.ts","sourceRoot":"","sources":["../../src/api/library-ids.ts"],"names":[],"mappings":"AAEA,4EAA4E;AAC5E,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAE/C;AAED,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAI/D"}

package/build/api/library-ids.js

@@ -0,0 +1,11 @@
+import { throwInvalidLibraryIdError } from './call-native';
+/** True when `id` uses an Apple Music library prefix (`i.`, `l.`, `p.`). */
+export function isLibraryId(id) {
+    return id.startsWith('l.') || id.startsWith('i.') || id.startsWith('p.');
+}
+export function assertLibraryId(id, label) {
+    if (!isLibraryId(id)) {
+        throwInvalidLibraryIdError(label, id);
+    }
+}
+//# sourceMappingURL=library-ids.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"library-ids.js","sourceRoot":"","sources":["../../src/api/library-ids.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,MAAM,eAAe,CAAC;AAE3D,4EAA4E;AAC5E,MAAM,UAAU,WAAW,CAAC,EAAU;IACpC,OAAO,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;AAC3E,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,EAAU,EAAE,KAAa;IACvD,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,EAAE,CAAC;QACrB,0BAA0B,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACxC,CAAC;AACH,CAAC","sourcesContent":["import { throwInvalidLibraryIdError } from './call-native';\n\n/** True when `id` uses an Apple Music library prefix (`i.`, `l.`, `p.`). */\nexport function isLibraryId(id: string): boolean {\n  return id.startsWith('l.') || id.startsWith('i.') || id.startsWith('p.');\n}\n\nexport function assertLibraryId(id: string, label: string): void {\n  if (!isLibraryId(id)) {\n    throwInvalidLibraryIdError(label, id);\n  }\n}\n"]}