@wwdrew/expo-spotify-sdk 0.8.0 → 2.0.0

package/android/build.gradle

@@ -16,10 +16,10 @@ buildscript {
 }
 
 project.android {
-  compileSdkVersion safeExtGet("compileSdkVersion", 35)
+  compileSdkVersion safeExtGet("compileSdkVersion", 36)
   defaultConfig {
     minSdkVersion safeExtGet("minSdkVersion", 24)
-    targetSdkVersion safeExtGet("targetSdkVersion", 35)
+    targetSdkVersion safeExtGet("targetSdkVersion", 36)
   }
   compileOptions {
     sourceCompatibility JavaVersion.VERSION_17
@@ -48,6 +48,16 @@ repositories {
 
 dependencies {
   implementation "com.spotify.android:auth:4.0.1"
+
+  // Spotify App Remote SDK — NOT on Maven Central.
+  // Download spotify-app-remote-release-0.8.0.aar from
+  // https://github.com/spotify/android-sdk/releases and place it in android/libs/.
+  // See android/libs/SETUP.md for full instructions.
+  implementation files('libs/spotify-app-remote-release-0.8.0.aar')
+  // App Remote is consumed as a local AAR, so transitive deps like Gson must
+  // be declared explicitly to avoid NoClassDefFoundError at runtime.
+  implementation "com.google.code.gson:gson:2.11.0"
+
   implementation "com.squareup.okhttp3:okhttp:4.12.0"
   implementation "org.jetbrains.kotlinx:kotlinx-coroutines-core:1.8.1"
   implementation "org.jetbrains.kotlinx:kotlinx-coroutines-android:1.8.1"

package/android/consumer-rules.pro

@@ -3,6 +3,11 @@
 -keepclassmembers class com.spotify.sdk.android.auth.** { *; }
 -dontwarn com.spotify.sdk.android.auth.**
 
+# Keep Spotify App Remote SDK classes
+-keep class com.spotify.android.appremote.** { *; }
+-keepclassmembers class com.spotify.android.appremote.** { *; }
+-dontwarn com.spotify.android.appremote.**
+
 # Keep our module's data classes
 -keep class expo.modules.spotifysdk.** { *; }
 -keepclassmembers class expo.modules.spotifysdk.** { *; }

package/android/libs/SETUP.md

@@ -0,0 +1,29 @@
+# Android App Remote SDK setup
+
+The Spotify App Remote SDK for Android is not published to Maven Central and must be
+downloaded manually.
+
+## Steps
+
+1. Go to <https://github.com/spotify/android-sdk/releases>
+2. Download the latest release archive (e.g. `spotify-android-sdk-x.x.x.zip`)
+3. Extract `spotify-app-remote-release-x.x.x.aar` from the archive
+4. Rename it to `spotify-app-remote-release-0.8.0.aar` (or update the version in
+   `android/build.gradle` to match the downloaded version)
+5. Place the `.aar` file in this directory (`android/libs/`)
+
+The `flatDir` repository in `android/build.gradle` will pick it up automatically.
+
+## Why not Maven?
+
+The Spotify Auth SDK (`com.spotify.android:auth`) is on Maven Central, but the App Remote
+SDK is distributed exclusively via GitHub releases. This directory follows the same pattern
+as the iOS side, where `SpotifyiOS.xcframework` is committed directly to `ios/SpotifySDK/`.
+
+## Proguard
+
+`consumer-rules.pro` already keeps the App Remote classes:
+
+```
+-keep class com.spotify.android.appremote.** { *; }
+```

package/android/src/main/java/expo/modules/spotifysdk/ExpoSpotifySDKModule.kt

@@ -8,13 +8,18 @@ import expo.modules.kotlin.functions.Coroutine
 import expo.modules.kotlin.modules.Module
 import expo.modules.kotlin.modules.ModuleDefinition
 
-private const val SDK_VERSION = "0.8.0" // x-release-please-version
+private const val SDK_VERSION = "2.0.0" // x-release-please-version
 private const val EVENT_SESSION_CHANGE = "onSessionChange"
+private const val EVENT_CONNECTION_STATE_CHANGE = "onConnectionStateChange"
+private const val EVENT_CONNECTION_ERROR = "onConnectionError"
+private const val EVENT_PLAYER_STATE_CHANGE = "onPlayerStateChange"
+private const val EVENT_CAPABILITIES_CHANGE = "onCapabilitiesChange"
 
 class ExpoSpotifySDKModule : Module() {
 
   private lateinit var authLauncher: AppContextActivityResultLauncher<SpotifyAuthInput, AuthorizationResponse>
-  private val coordinator = SpotifyAuthCoordinator()
+  private val authCoordinator = SpotifyAuthCoordinator()
+  private val appRemoteCoordinator = SpotifyAppRemoteCoordinator()
 
   private val context
     get() = appContext.reactContext ?: throw Exceptions.ReactContextLost()
@@ -58,17 +63,41 @@ class ExpoSpotifySDKModule : Module() {
     )
   }
 
-  private fun emitError(type: String, code: String, message: String) {
+  private fun emitSessionError(code: String, message: String) {
     sendEvent(
       EVENT_SESSION_CHANGE,
-      mapOf("type" to type, "error" to mapOf("code" to code, "message" to message)),
+      mapOf("type" to "didFail", "error" to mapOf("code" to code, "message" to message)),
     )
   }
 
   override fun definition() = ModuleDefinition {
     Name("ExpoSpotifySDK")
 
-    Events(EVENT_SESSION_CHANGE)
+    Events(
+      EVENT_SESSION_CHANGE,
+      EVENT_CONNECTION_STATE_CHANGE,
+      EVENT_CONNECTION_ERROR,
+      EVENT_PLAYER_STATE_CHANGE,
+      EVENT_CAPABILITIES_CHANGE,
+    )
+
+    // Wire up App Remote coordinator event callbacks once the module is alive.
+    OnCreate {
+      appRemoteCoordinator.onConnectionStateChange = { state ->
+        sendEvent(EVENT_CONNECTION_STATE_CHANGE, mapOf("state" to state))
+      }
+      appRemoteCoordinator.onConnectionError = { code, message ->
+        sendEvent(EVENT_CONNECTION_ERROR, mapOf("code" to code, "message" to message))
+      }
+      appRemoteCoordinator.onPlayerStateChange = { stateMap ->
+        sendEvent(EVENT_PLAYER_STATE_CHANGE, stateMap)
+      }
+      appRemoteCoordinator.onCapabilitiesChange = { capabilities ->
+        sendEvent(EVENT_CAPABILITIES_CHANGE, capabilities)
+      }
+    }
+
+    // ── Auth ────────────────────────────────────────────────────────────────
 
     Function("isAvailable") {
       isSpotifyInstalled()
@@ -97,7 +126,7 @@ class ExpoSpotifySDKModule : Module() {
           showDialog = config.showDialog,
         )
 
-        val response = coordinator.authenticate(authLauncher, input)
+        val response = authCoordinator.authenticate(authLauncher, input)
 
         val payload = when (response.type) {
           AuthorizationResponse.Type.TOKEN -> SpotifySessionPayload(
@@ -128,14 +157,14 @@ class ExpoSpotifySDKModule : Module() {
           AuthorizationResponse.Type.ERROR -> throw SpotifyAuthErrorException(
             response.error ?: "Spotify returned an unspecified error",
           )
-          AuthorizationResponse.Type.UNKNOWN, null -> throw UnknownSpotifyException(
+          AuthorizationResponse.Type.UNKNOWN -> throw UnknownSpotifyException(
             "Unknown Spotify authorization response type",
           )
         }
         emitSession("didInitiate", payload)
         payload.toMap()
       } catch (e: expo.modules.kotlin.exception.CodedException) {
-        emitError("didFail", e.code ?: "UNKNOWN", e.localizedMessage ?: e.code ?: "Unknown error")
+        emitSessionError(e.code ?: "UNKNOWN", e.localizedMessage ?: e.code ?: "Unknown error")
         throw e
       }
     }
@@ -158,9 +187,117 @@ class ExpoSpotifySDKModule : Module() {
         emitSession("didRenew", payload)
         payload.toMap()
       } catch (e: expo.modules.kotlin.exception.CodedException) {
-        emitError("didFail", e.code ?: "UNKNOWN", e.localizedMessage ?: e.code ?: "Unknown error")
+        emitSessionError(e.code ?: "UNKNOWN", e.localizedMessage ?: e.code ?: "Unknown error")
         throw e
       }
     }
+
+    // ── App Remote ──────────────────────────────────────────────────────────
+
+    AsyncFunction("appRemoteConnect") Coroutine { accessToken: String ->
+      val manifest = readManifestConfig()
+      appRemoteCoordinator.connect(
+        context = context,
+        clientId = manifest.clientId,
+        redirectUri = manifest.redirectUri,
+        accessToken = accessToken,
+      )
+    }
+
+    AsyncFunction("appRemoteDisconnect") Coroutine { ->
+      appRemoteCoordinator.disconnect()
+    }
+
+    Function("appRemoteIsConnected") {
+      appRemoteCoordinator.isConnected()
+    }
+
+    AsyncFunction("appRemoteGetConnectionState") Coroutine { ->
+      appRemoteCoordinator.getConnectionState()
+    }
+
+    // ── Player ──────────────────────────────────────────────────────────────
+
+    AsyncFunction("playerPlay") Coroutine { uri: String ->
+      appRemoteCoordinator.playerPlay(uri)
+    }
+
+    AsyncFunction("playerPause") Coroutine { ->
+      appRemoteCoordinator.playerPause()
+    }
+
+    AsyncFunction("playerResume") Coroutine { ->
+      appRemoteCoordinator.playerResume()
+    }
+
+    AsyncFunction("playerSkipNext") Coroutine { ->
+      appRemoteCoordinator.playerSkipNext()
+    }
+
+    AsyncFunction("playerSkipPrevious") Coroutine { ->
+      appRemoteCoordinator.playerSkipPrevious()
+    }
+
+    AsyncFunction("playerSeekTo") Coroutine { positionMs: Long ->
+      appRemoteCoordinator.playerSeekTo(positionMs)
+    }
+
+    AsyncFunction("playerSetShuffle") Coroutine { enabled: Boolean ->
+      appRemoteCoordinator.playerSetShuffle(enabled)
+    }
+
+    AsyncFunction("playerSetRepeatMode") Coroutine { mode: Int ->
+      appRemoteCoordinator.playerSetRepeatMode(mode)
+    }
+
+    AsyncFunction("playerSetPodcastPlaybackSpeed") Coroutine { value: Double ->
+      appRemoteCoordinator.playerSetPodcastPlaybackSpeed(value.toFloat())
+    }
+
+    AsyncFunction("playerQueue") Coroutine { uri: String ->
+      appRemoteCoordinator.playerQueue(uri)
+    }
+
+    AsyncFunction("playerGetPlayerState") Coroutine { ->
+      appRemoteCoordinator.playerGetPlayerState()
+    }
+
+    AsyncFunction("playerGetCrossfadeState") Coroutine { ->
+      appRemoteCoordinator.playerGetCrossfadeState()
+    }
+
+    // ── User ────────────────────────────────────────────────────────────────
+
+    AsyncFunction("userGetCapabilities") Coroutine { ->
+      appRemoteCoordinator.userGetCapabilities()
+    }
+
+    AsyncFunction("userGetLibraryState") Coroutine { uri: String ->
+      appRemoteCoordinator.userGetLibraryState(uri)
+    }
+
+    AsyncFunction("userAddToLibrary") Coroutine { uri: String ->
+      appRemoteCoordinator.userAddToLibrary(uri)
+    }
+
+    AsyncFunction("userRemoveFromLibrary") Coroutine { uri: String ->
+      appRemoteCoordinator.userRemoveFromLibrary(uri)
+    }
+
+    // ── Content ───────────────────────────────────────────────────────────────
+
+    AsyncFunction("contentGetRecommendedContentItems") Coroutine { type: String ->
+      appRemoteCoordinator.contentGetRecommendedContentItems(type)
+    }
+
+    AsyncFunction("contentGetChildren") Coroutine { item: Map<String, Any?> ->
+      appRemoteCoordinator.contentGetChildren(item)
+    }
+
+    // ── Images ────────────────────────────────────────────────────────────────
+
+    AsyncFunction("imagesLoad") Coroutine { imageIdentifier: String, size: String ->
+      appRemoteCoordinator.imagesLoad(imageIdentifier, size, context.cacheDir)
+    }
   }
 }