@wwdrew/expo-spotify-sdk 2.0.0 → 2.2.0

package/android/spotify-native-sdk.gradle

@@ -0,0 +1,118 @@
+// Downloads Spotify App Remote AAR at Gradle build time (pinned in ios/spotify-native-sdk-versions.json).
+def spotifyNativeVersionsFile = file("${projectDir}/../ios/spotify-native-sdk-versions.json")
+if (!spotifyNativeVersionsFile.exists()) {
+  throw new GradleException(
+    "Missing ${spotifyNativeVersionsFile}. Native SDK versions must be pinned in ios/spotify-native-sdk-versions.json."
+  )
+}
+
+def spotifyNative = new groovy.json.JsonSlurper().parse(spotifyNativeVersionsFile)
+def androidSdk = spotifyNative.android
+if (androidSdk == null) {
+  throw new GradleException("ios/spotify-native-sdk-versions.json is missing an \"android\" section.")
+}
+
+def appRemoteVersion = androidSdk.appRemoteVersion as String
+def appRemoteReleaseTag = androidSdk.appRemoteReleaseTag as String
+def appRemoteSha256 = androidSdk.appRemoteSha256 as String
+
+if (!appRemoteVersion || !appRemoteReleaseTag || !appRemoteSha256) {
+  throw new GradleException(
+    "ios/spotify-native-sdk-versions.json android section is missing required fields: " +
+      "appRemoteVersion, appRemoteReleaseTag, appRemoteSha256"
+  )
+}
+
+def libsDir = file("${projectDir}/libs")
+def aarFile = file("${libsDir}/spotify-app-remote-release-${appRemoteVersion}.aar")
+def versionMarker = file("${libsDir}/.version")
+def downloadUrl =
+  "https://github.com/spotify/android-sdk/releases/download/${appRemoteReleaseTag}/spotify-app-remote-release-${appRemoteVersion}.aar"
+
+def sha256File = { File f ->
+  def digest = java.security.MessageDigest.getInstance("SHA-256")
+  f.withInputStream { stream ->
+    def buffer = new byte[8192]
+    int read
+    while ((read = stream.read(buffer)) > 0) {
+      digest.update(buffer, 0, read)
+    }
+  }
+  digest.digest().collect { String.format("%02x", it) }.join("")
+}
+
+def appRemoteAarUpToDate = {
+  if (!aarFile.exists()) {
+    return false
+  }
+  if (!versionMarker.exists() || versionMarker.text.trim() != appRemoteVersion) {
+    return false
+  }
+  sha256File(aarFile) == appRemoteSha256
+}
+
+tasks.register("downloadSpotifyAppRemoteAar") {
+  group = "spotify"
+  description = "Download Spotify App Remote AAR from GitHub releases"
+
+  outputs.file(aarFile)
+  outputs.file(versionMarker)
+
+  onlyIf {
+    !appRemoteAarUpToDate()
+  }
+
+  doLast {
+    libsDir.mkdirs()
+    logger.lifecycle("ExpoSpotifySDK: downloading Spotify App Remote ${appRemoteVersion}")
+
+    def tmp = File.createTempFile("spotify-app-remote", ".aar")
+    try {
+      ant.get(
+        src: downloadUrl,
+        dest: tmp,
+        verbose: true,
+        connecttimeout: 30000,
+        readtimeout: 60000
+      )
+      def actual = sha256File(tmp)
+      if (actual != appRemoteSha256) {
+        throw new GradleException(
+          "Spotify App Remote AAR checksum mismatch\n" +
+            "  expected ${appRemoteSha256}\n" +
+            "  actual   ${actual}"
+        )
+      }
+
+      libsDir.listFiles()?.each { f ->
+        if (f.name.endsWith(".aar") && f.name != aarFile.name) {
+          f.delete()
+        }
+      }
+
+      if (aarFile.exists()) {
+        aarFile.delete()
+      }
+
+      if (!tmp.renameTo(aarFile)) {
+        tmp.withInputStream { input ->
+          aarFile.withOutputStream { output ->
+            output << input
+          }
+        }
+      }
+
+      versionMarker.text = appRemoteVersion
+    } finally {
+      tmp.delete()
+    }
+
+    logger.lifecycle("ExpoSpotifySDK: Spotify App Remote AAR ready at ${aarFile}")
+  }
+}
+
+ext.spotifyAppRemoteAarFile = aarFile
+
+tasks.named("preBuild").configure {
+  dependsOn("downloadSpotifyAppRemoteAar")
+}

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

@@ -8,7 +8,7 @@ import expo.modules.kotlin.functions.Coroutine
 import expo.modules.kotlin.modules.Module
 import expo.modules.kotlin.modules.ModuleDefinition
 
-private const val SDK_VERSION = "2.0.0" // x-release-please-version
+private const val SDK_VERSION = "2.2.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"
@@ -141,11 +141,10 @@ class ExpoSpotifySDKModule : Module() {
               ?: throw InvalidConfigException(
                 "Received CODE response but no tokenSwapURL was configured",
               )
-            val client = SpotifyTokenSwapClient(SDK_VERSION, manifest.clientId)
+            val client = SpotifyTokenSwapClient(SDK_VERSION)
             client.swap(
               code = response.code
                 ?: throw TokenSwapParseException("Spotify returned CODE without a code"),
-              redirectUri = manifest.redirectUri,
               tokenSwapURL = swapURL,
               requestedScopes = config.scopes,
             )
@@ -177,8 +176,7 @@ class ExpoSpotifySDKModule : Module() {
         if (options.tokenRefreshURL.isBlank()) {
           throw InvalidConfigException("`tokenRefreshURL` is required")
         }
-        val manifest = readManifestConfig()
-        val client = SpotifyTokenSwapClient(SDK_VERSION, manifest.clientId)
+        val client = SpotifyTokenSwapClient(SDK_VERSION)
         val payload = client.refresh(
           refreshToken = options.refreshToken,
           tokenRefreshURL = options.tokenRefreshURL,
@@ -204,6 +202,17 @@ class ExpoSpotifySDKModule : Module() {
       )
     }
 
+    AsyncFunction("appRemoteAuthorizeAndPlay") Coroutine { accessToken: String, uri: String ->
+      val manifest = readManifestConfig()
+      appRemoteCoordinator.authorizeAndPlay(
+        context = context,
+        clientId = manifest.clientId,
+        redirectUri = manifest.redirectUri,
+        accessToken = accessToken,
+        uri = uri,
+      )
+    }
+
     AsyncFunction("appRemoteDisconnect") Coroutine { ->
       appRemoteCoordinator.disconnect()
     }

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

@@ -18,7 +18,6 @@ import com.spotify.protocol.types.ListItems
 import com.spotify.protocol.types.PlayerState
 import com.spotify.protocol.types.PlaybackSpeed
 import com.spotify.protocol.types.Repeat
-import expo.modules.kotlin.exception.CodedException
 import kotlinx.coroutines.suspendCancellableCoroutine
 import kotlinx.coroutines.sync.Mutex
 import java.io.File
@@ -132,6 +131,38 @@ class SpotifyAppRemoteCoordinator {
     }
   }
 
+  /**
+   * Wakes the Spotify app and starts playback, then ensures an active App
+   * Remote connection — the cross-platform counterpart of iOS
+   * `authorizeAndPlayURI`.
+   *
+   * On Android there is no dedicated "authorize and play" entry point:
+   * [SpotifyAppRemote.connect] already launches/wakes the Spotify service when
+   * it is installed, so this simply connects (if not already connected) and
+   * then issues a play (or resume, for an empty [uri]) command. The resulting
+   * playback keeps Spotify alive, mirroring the iOS behaviour.
+   *
+   * @param uri Spotify URI to play, or empty to resume the last/contextual track.
+   */
+  suspend fun authorizeAndPlay(
+    context: Context,
+    clientId: String,
+    redirectUri: String,
+    accessToken: String,
+    uri: String,
+  ) {
+    if (appRemote?.isConnected != true) {
+      connect(context, clientId, redirectUri, accessToken)
+    }
+    if (uri.isEmpty()) {
+      requireConnected("AppRemote.authorizeAndPlay").playerApi.resume()
+        .awaitVoid("AppRemote.authorizeAndPlay")
+    } else {
+      requireConnected("AppRemote.authorizeAndPlay").playerApi.play(uri)
+        .awaitVoid("AppRemote.authorizeAndPlay")
+    }
+  }
+
   /**
    * Disconnects from the Spotify app. Safe to call when already disconnected.
    */
@@ -336,7 +367,7 @@ class SpotifyAppRemoteCoordinator {
     suspendCancellableCoroutine { continuation ->
       setResultCallback { continuation.resume(Unit) }
       setErrorCallback { throwable ->
-        continuation.resumeWithException(normalizePlayerError(throwable, callsite))
+        continuation.resumeWithException(SpotifyAppRemoteErrorMapping.mapPlayerError(throwable, callsite))
       }
     }
   }
@@ -347,7 +378,7 @@ class SpotifyAppRemoteCoordinator {
     return suspendCancellableCoroutine { continuation ->
       setResultCallback { result -> continuation.resume(result) }
       setErrorCallback { throwable ->
-        continuation.resumeWithException(normalizePlayerError(throwable, callsite))
+        continuation.resumeWithException(SpotifyAppRemoteErrorMapping.mapPlayerError(throwable, callsite))
       }
     }
   }
@@ -357,7 +388,7 @@ class SpotifyAppRemoteCoordinator {
     return suspendCancellableCoroutine { continuation ->
       setResultCallback { result -> continuation.resume(result) }
       setErrorCallback { throwable ->
-        continuation.resumeWithException(normalizeUserError(throwable, callsite, uri))
+        continuation.resumeWithException(SpotifyAppRemoteErrorMapping.mapUserError(throwable, callsite, uri))
       }
     }
   }
@@ -366,7 +397,7 @@ class SpotifyAppRemoteCoordinator {
     return suspendCancellableCoroutine { continuation ->
       setResultCallback { result -> continuation.resume(result) }
       setErrorCallback { throwable ->
-        continuation.resumeWithException(normalizeUserError(throwable, callsite, ""))
+        continuation.resumeWithException(SpotifyAppRemoteErrorMapping.mapUserError(throwable, callsite, ""))
       }
     }
   }
@@ -375,7 +406,7 @@ class SpotifyAppRemoteCoordinator {
     return suspendCancellableCoroutine { continuation ->
       setResultCallback { result -> continuation.resume(result) }
       setErrorCallback { throwable ->
-        continuation.resumeWithException(normalizeContentError(throwable, callsite))
+        continuation.resumeWithException(SpotifyAppRemoteErrorMapping.mapContentError(throwable, callsite))
       }
     }
   }
@@ -384,68 +415,11 @@ class SpotifyAppRemoteCoordinator {
     return suspendCancellableCoroutine { continuation ->
       setResultCallback { result -> continuation.resume(result) }
       setErrorCallback { throwable ->
-        continuation.resumeWithException(normalizeImagesError(throwable, callsite))
+        continuation.resumeWithException(SpotifyAppRemoteErrorMapping.mapImagesError(throwable, callsite))
       }
     }
   }
 
-  private fun normalizePlayerError(throwable: Throwable, callsite: String): CodedException {
-    val msg = throwable.message ?: "Unknown error"
-    return when {
-      msg.contains("premium", ignoreCase = true) -> PlayerPremiumRequiredException(callsite)
-      msg.contains("disconnected", ignoreCase = true) ||
-        msg.contains("not connected", ignoreCase = true) ->
-        PlayerConnectionLostException("$callsite: $msg", throwable)
-      msg.contains("not allowed", ignoreCase = true) ||
-        msg.contains("restriction", ignoreCase = true) ->
-        PlayerOperationNotAllowedException("$callsite: $msg", throwable)
-      else -> PlayerUnknownException("$callsite: $msg", throwable)
-    }
-  }
-
-  private fun normalizeUserError(throwable: Throwable, callsite: String, uri: String): CodedException {
-    val msg = throwable.message ?: "Unknown error"
-    return when {
-      msg.contains("disconnected", ignoreCase = true) ||
-        msg.contains("not connected", ignoreCase = true) ->
-        UserConnectionLostException("$callsite: $msg", throwable)
-      msg.contains("uri", ignoreCase = true) ||
-        msg.contains("invalid", ignoreCase = true) ->
-        UserInvalidURIException(uri, throwable)
-      msg.contains("not allowed", ignoreCase = true) ||
-        msg.contains("restriction", ignoreCase = true) ->
-        UserOperationNotAllowedException("$callsite: $msg", throwable)
-      else -> UserUnknownException("$callsite: $msg", throwable)
-    }
-  }
-
-  private fun normalizeContentError(throwable: Throwable, callsite: String): CodedException {
-    val msg = throwable.message ?: "Unknown error"
-    return when {
-      msg.contains("disconnected", ignoreCase = true) ||
-        msg.contains("not connected", ignoreCase = true) ->
-        ContentConnectionLostException("$callsite: $msg", throwable)
-      msg.contains("not supported", ignoreCase = true) ||
-        msg.contains("unsupported", ignoreCase = true) ->
-        ContentApiUnavailableException("$callsite: content API unavailable on this Spotify app version", throwable)
-      else -> ContentUnknownException("$callsite: $msg", throwable)
-    }
-  }
-
-  private fun normalizeImagesError(throwable: Throwable, callsite: String): CodedException {
-    val msg = throwable.message ?: "Unknown error"
-    return when {
-      msg.contains("disconnected", ignoreCase = true) ||
-        msg.contains("not connected", ignoreCase = true) ->
-        ImagesNotConnectedException(callsite)
-      msg.contains("invalid", ignoreCase = true) ->
-        ImagesInvalidURIException("$callsite: invalid image identifier", throwable)
-      msg.contains("load", ignoreCase = true) || msg.contains("image", ignoreCase = true) ->
-        ImagesLoadFailedException("$callsite: $msg", throwable)
-      else -> ImagesUnknownException("$callsite: $msg", throwable)
-    }
-  }
-
   private fun writeBitmapToTempFile(bitmap: Bitmap, cacheDir: File): File {
     val out = File(cacheDir, "expo-spotify-image-${System.currentTimeMillis()}-${(0..9999).random()}.png")
     FileOutputStream(out).use { stream ->

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

@@ -0,0 +1,106 @@
+package expo.modules.spotifysdk
+
+import com.spotify.android.appremote.api.error.SpotifyConnectionTerminatedException
+import com.spotify.android.appremote.api.error.SpotifyDisconnectedException
+import com.spotify.android.appremote.api.error.SpotifyRemoteServiceException
+import com.spotify.protocol.client.error.RemoteClientException
+import com.spotify.protocol.error.SpotifyAppRemoteException
+import expo.modules.kotlin.exception.CodedException
+
+/**
+ * Maps Spotify App Remote SDK throwables into per-namespace [CodedException] types.
+ *
+ * Typed SDK exceptions are checked first; message heuristics are a fallback aligned
+ * with [ios/SpotifyAppRemoteErrorMapping.swift]. See [docs/app-remote-error-mapping.md].
+ */
+object SpotifyAppRemoteErrorMapping {
+  private fun connectionLostMessage(callsite: String): String =
+    "$callsite: connection to Spotify app was terminated"
+
+  private fun isConnectionTerminated(throwable: Throwable): Boolean =
+    throwable is SpotifyConnectionTerminatedException ||
+      throwable is SpotifyDisconnectedException
+
+  private fun messageIndicatesConnectionLost(message: String): Boolean {
+    val lower = message.lowercase()
+    return lower.contains("disconnected") || lower.contains("not connected")
+  }
+
+  private fun containsRestriction(message: String): Boolean {
+    val lower = message.lowercase()
+    return lower.contains("not allowed") || lower.contains("restriction")
+  }
+
+  /** Request-level failures from the Spotify protocol layer (mirrors iOS `requestFailedError`). */
+  private fun isRequestFailed(throwable: Throwable): Boolean =
+    throwable is RemoteClientException ||
+      throwable is SpotifyAppRemoteException ||
+      throwable is SpotifyRemoteServiceException
+
+  fun mapPlayerError(throwable: Throwable, callsite: String): CodedException {
+    val message = throwable.message ?: "Unknown error"
+    if (isConnectionTerminated(throwable) || messageIndicatesConnectionLost(message)) {
+      return PlayerConnectionLostException(connectionLostMessage(callsite), throwable)
+    }
+    if (message.contains("premium", ignoreCase = true)) {
+      return PlayerPremiumRequiredException(
+        "$callsite: Spotify Premium is required for on-demand playback",
+      )
+    }
+    if (containsRestriction(message)) {
+      return PlayerOperationNotAllowedException("$callsite: $message", throwable)
+    }
+    if (isRequestFailed(throwable) && message.contains("invalid", ignoreCase = true)) {
+      return PlayerInvalidParameterException("$callsite: $message", throwable)
+    }
+    return PlayerUnknownException("$callsite: $message", throwable)
+  }
+
+  fun mapUserError(throwable: Throwable, callsite: String, uri: String): CodedException {
+    val message = throwable.message ?: "Unknown error"
+    if (isConnectionTerminated(throwable) || messageIndicatesConnectionLost(message)) {
+      return UserConnectionLostException(connectionLostMessage(callsite), throwable)
+    }
+    if (
+      isRequestFailed(throwable) &&
+      (message.contains("uri", ignoreCase = true) || message.contains("invalid", ignoreCase = true))
+    ) {
+      return UserInvalidURIException(uri, throwable)
+    }
+    if (containsRestriction(message)) {
+      return UserOperationNotAllowedException("$callsite: $message", throwable)
+    }
+    return UserUnknownException("$callsite: $message", throwable)
+  }
+
+  fun mapContentError(throwable: Throwable, callsite: String): CodedException {
+    val message = throwable.message ?: "Unknown error"
+    if (isConnectionTerminated(throwable) || messageIndicatesConnectionLost(message)) {
+      return ContentConnectionLostException(connectionLostMessage(callsite), throwable)
+    }
+    if (isRequestFailed(throwable)) {
+      val lower = message.lowercase()
+      if (lower.contains("not supported") || lower.contains("unsupported")) {
+        return ContentApiUnavailableException(
+          "$callsite: content API is unavailable on this Spotify app version",
+          throwable,
+        )
+      }
+    }
+    return ContentUnknownException("$callsite: $message", throwable)
+  }
+
+  fun mapImagesError(throwable: Throwable, callsite: String): CodedException {
+    val message = throwable.message ?: "Unknown error"
+    if (isConnectionTerminated(throwable) || messageIndicatesConnectionLost(message)) {
+      return ImagesNotConnectedException(connectionLostMessage(callsite))
+    }
+    if (isRequestFailed(throwable) && message.contains("invalid", ignoreCase = true)) {
+      return ImagesInvalidURIException("$callsite: invalid image identifier", throwable)
+    }
+    if (isRequestFailed(throwable)) {
+      return ImagesLoadFailedException("$callsite: Spotify rejected image request", throwable)
+    }
+    return ImagesUnknownException("$callsite: $message", throwable)
+  }
+}

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

@@ -20,16 +20,15 @@ import kotlin.coroutines.resumeWithException
  *
  * Server contract:
  *   POST {tokenSwapURL}
- *     body: code=<auth-code>&redirect_uri=<redirect-uri>&client_id=<client-id>
+ *     body: code=<auth-code>
  *     200 -> { access_token, expires_in, refresh_token?, scope? }
  *
  *   POST {tokenRefreshURL}
- *     body: refresh_token=<token>&client_id=<client-id>
+ *     body: refresh_token=<token>
  *     200 -> { access_token, expires_in, refresh_token?, scope? }
  */
 class SpotifyTokenSwapClient(
   private val sdkVersion: String,
-  private val clientId: String,
 ) {
   private val client: OkHttpClient = OkHttpClient.Builder()
     .connectTimeout(30, TimeUnit.SECONDS)
@@ -41,14 +40,11 @@ class SpotifyTokenSwapClient(
 
   suspend fun swap(
     code: String,
-    redirectUri: String,
     tokenSwapURL: String,
     requestedScopes: List<String>,
   ): SpotifySessionPayload {
     val body = FormBody.Builder()
       .add("code", code)
-      .add("redirect_uri", redirectUri)
-      .add("client_id", clientId)
       .build()
     val request = Request.Builder()
       .url(tokenSwapURL)
@@ -66,7 +62,6 @@ class SpotifyTokenSwapClient(
   ): SpotifySessionPayload {
     val body = FormBody.Builder()
       .add("refresh_token", refreshToken)
-      .add("client_id", clientId)
       .build()
     val request = Request.Builder()
       .url(tokenRefreshURL)

package/build/app-remote/index.d.ts

@@ -48,6 +48,40 @@ export declare const AppRemote: {
      * Calling `connect()` while already connected is a no-op.
      */
     readonly connect: (accessToken: string) => Promise<void>;
+    /**
+     * Wakes the Spotify app — launching it if it has been suspended in the
+     * background — starts playback, and then establishes the App Remote
+     * connection. This is the recommended way to (re)connect when Spotify may
+     * not currently be running.
+     *
+     * Why this exists: {@link connect} only attaches to an *already-running*
+     * Spotify process. If Spotify has been suspended (e.g. iOS reclaims a
+     * backgrounded app that isn't playing audio, or the connection dropped
+     * ~30s after the user paused), `connect()` rejects with `CONNECTION_FAILED`
+     * and there is no way to revive Spotify from `connect()` alone.
+     * `authorizeAndPlay()` performs an app-switch to Spotify
+     * (iOS `authorizeAndPlayURI`; Android wakes the App Remote service and
+     * issues a play command), which both revives Spotify and keeps it alive by
+     * starting audio.
+     *
+     * Trade-offs:
+     * - It **always starts (or resumes) playback** — it cannot wake Spotify
+     *   silently.
+     * - It briefly **switches to the Spotify app** and back; the OS does not
+     *   allow waking another app without a foreground app-switch.
+     * - Requires Spotify Premium for on-demand playback of a specific `uri`.
+     *
+     * @param accessToken Access token from `Auth.authenticate()`. On Android this
+     *   is an iOS-parity parameter (see {@link connect}); on iOS the token
+     *   returned by the authorization redirect is used to complete the connection.
+     * @param uri Spotify URI to play. Pass an empty string (the default) to
+     *   resume the user's last track or play a contextual/random track.
+     *
+     * Resolves once Spotify is connected and the play command has been issued;
+     * rejects with an {@link AppRemoteError} if Spotify is not installed or the
+     * authorization is denied.
+     */
+    readonly authorizeAndPlay: (accessToken: string, uri?: string) => Promise<void>;
     /**
      * Disconnects from the Spotify app. Safe to call when already disconnected.
      * Resolves once the disconnection is complete.

package/build/app-remote/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/app-remote/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAG3D,OAAO,EAAkB,KAAK,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAElE,YAAY,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAMzC,8DAA8D;AAC9D,MAAM,MAAM,eAAe,GAAG,cAAc,GAAG,YAAY,GAAG,WAAW,CAAC;AAE1E,oDAAoD;AACpD,MAAM,WAAW,0BAA0B;IACzC,KAAK,EAAE,eAAe,CAAC;CACxB;AAED,8CAA8C;AAC9C,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,kBAAkB,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;CACjB;AAqCD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,SAAS;IACpB;;;;;;;;;;;OAWG;oCACkB,MAAM,KAAG,OAAO,CAAC,IAAI,CAAC;IAM3C;;;OAGG;+BACW,OAAO,CAAC,IAAI,CAAC;IAI3B;;;;OAIG;gCACY,OAAO;IAItB;;;OAGG;uCACmB,OAAO,CAAC,eAAe,CAAC;IAI9C;;;;;;;;;OASG;2BACS,CAAC,SAAS,uBAAuB,GAAG,iBAAiB,SACxD,CAAC,YACE,CAAC,SAAS,uBAAuB,GACvC,CAAC,KAAK,EAAE,0BAA0B,KAAK,IAAI,GAC3C,CAAC,KAAK,EAAE,oBAAoB,KAAK,IAAI,KACxC,iBAAiB;CAUZ,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/app-remote/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAG3D,OAAO,EAAkB,KAAK,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAGlE,YAAY,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAMzC,8DAA8D;AAC9D,MAAM,MAAM,eAAe,GAAG,cAAc,GAAG,YAAY,GAAG,WAAW,CAAC;AAE1E,oDAAoD;AACpD,MAAM,WAAW,0BAA0B;IACzC,KAAK,EAAE,eAAe,CAAC;CACxB;AAED,8CAA8C;AAC9C,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,kBAAkB,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;CACjB;AAqBD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,SAAS;IACpB;;;;;;;;;;;OAWG;oCACkB,MAAM,KAAG,OAAO,CAAC,IAAI,CAAC;IAM3C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAgCG;6CAC2B,MAAM,QAAO,MAAM,KAAQ,OAAO,CAAC,IAAI,CAAC;IAOtE;;;OAGG;+BACW,OAAO,CAAC,IAAI,CAAC;IAI3B;;;;OAIG;gCACY,OAAO;IAItB;;;OAGG;uCACmB,OAAO,CAAC,eAAe,CAAC;IAI9C;;;;;;;;;OASG;2BACS,CAAC,SAAS,uBAAuB,GAAG,iBAAiB,SACxD,CAAC,YACE,CAAC,SAAS,uBAAuB,GACvC,CAAC,KAAK,EAAE,0BAA0B,KAAK,IAAI,GAC3C,CAAC,KAAK,EAAE,oBAAoB,KAAK,IAAI,KACxC,iBAAiB;CAUZ,CAAC"}

package/build/app-remote/index.js

@@ -1,33 +1,20 @@
 import ExpoSpotifySDKModule from "../ExpoSpotifySDKModule";
 import { AppRemoteError } from "./error";
+import { createNativeErrorRethrow } from "../internal/native-errors";
 export { AppRemoteError } from "./error";
 // ---------------------------------------------------------------------------
 // Internal helpers
 // ---------------------------------------------------------------------------
-const VALID_APPREMOTE_CODES = new Set([
-    "CONNECTION_FAILED",
-    "CONNECTION_LOST",
-    "NOT_CONNECTED",
-    "UNKNOWN",
-]);
-const CAUSE_SEPARATOR = "→ Caused by: ";
-function unwrapReason(message) {
-    const idx = message.lastIndexOf(CAUSE_SEPARATOR);
-    return idx === -1 ? message : message.slice(idx + CAUSE_SEPARATOR.length);
-}
-function rethrowAsAppRemoteError(err) {
-    if (err instanceof AppRemoteError)
-        throw err;
-    if (err instanceof Error) {
-        const reason = unwrapReason(err.message);
-        const maybeCode = err.code;
-        if (maybeCode && VALID_APPREMOTE_CODES.has(maybeCode)) {
-            throw new AppRemoteError(maybeCode, reason);
-        }
-        throw new AppRemoteError("UNKNOWN", reason);
-    }
-    throw new AppRemoteError("UNKNOWN", String(err));
-}
+const rethrowAsAppRemoteError = createNativeErrorRethrow({
+    ErrorClass: AppRemoteError,
+    unknownCode: "UNKNOWN",
+    validCodes: new Set([
+        "CONNECTION_FAILED",
+        "CONNECTION_LOST",
+        "NOT_CONNECTED",
+        "UNKNOWN",
+    ]),
+});
 // ---------------------------------------------------------------------------
 // AppRemote namespace
 // ---------------------------------------------------------------------------
@@ -68,6 +55,42 @@ export const AppRemote = {
     connect(accessToken) {
         return ExpoSpotifySDKModule.appRemoteConnect(accessToken).catch(rethrowAsAppRemoteError);
     },
+    /**
+     * Wakes the Spotify app — launching it if it has been suspended in the
+     * background — starts playback, and then establishes the App Remote
+     * connection. This is the recommended way to (re)connect when Spotify may
+     * not currently be running.
+     *
+     * Why this exists: {@link connect} only attaches to an *already-running*
+     * Spotify process. If Spotify has been suspended (e.g. iOS reclaims a
+     * backgrounded app that isn't playing audio, or the connection dropped
+     * ~30s after the user paused), `connect()` rejects with `CONNECTION_FAILED`
+     * and there is no way to revive Spotify from `connect()` alone.
+     * `authorizeAndPlay()` performs an app-switch to Spotify
+     * (iOS `authorizeAndPlayURI`; Android wakes the App Remote service and
+     * issues a play command), which both revives Spotify and keeps it alive by
+     * starting audio.
+     *
+     * Trade-offs:
+     * - It **always starts (or resumes) playback** — it cannot wake Spotify
+     *   silently.
+     * - It briefly **switches to the Spotify app** and back; the OS does not
+     *   allow waking another app without a foreground app-switch.
+     * - Requires Spotify Premium for on-demand playback of a specific `uri`.
+     *
+     * @param accessToken Access token from `Auth.authenticate()`. On Android this
+     *   is an iOS-parity parameter (see {@link connect}); on iOS the token
+     *   returned by the authorization redirect is used to complete the connection.
+     * @param uri Spotify URI to play. Pass an empty string (the default) to
+     *   resume the user's last track or play a contextual/random track.
+     *
+     * Resolves once Spotify is connected and the play command has been issued;
+     * rejects with an {@link AppRemoteError} if Spotify is not installed or the
+     * authorization is denied.
+     */
+    authorizeAndPlay(accessToken, uri = "") {
+        return ExpoSpotifySDKModule.appRemoteAuthorizeAndPlay(accessToken, uri).catch(rethrowAsAppRemoteError);
+    },
     /**
      * Disconnects from the Spotify app. Safe to call when already disconnected.
      * Resolves once the disconnection is complete.

package/build/app-remote/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/app-remote/index.ts"],"names":[],"mappings":"AAEA,OAAO,oBAAoB,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAA2B,MAAM,SAAS,CAAC;AAGlE,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAoBzC,8EAA8E;AAC9E,mBAAmB;AACnB,8EAA8E;AAE9E,MAAM,qBAAqB,GAAG,IAAI,GAAG,CAAqB;IACxD,mBAAmB;IACnB,iBAAiB;IACjB,eAAe;IACf,SAAS;CACV,CAAC,CAAC;AAEH,MAAM,eAAe,GAAG,eAAe,CAAC;AAExC,SAAS,YAAY,CAAC,OAAe;IACnC,MAAM,GAAG,GAAG,OAAO,CAAC,WAAW,CAAC,eAAe,CAAC,CAAC;IACjD,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;AAC5E,CAAC;AAED,SAAS,uBAAuB,CAAC,GAAY;IAC3C,IAAI,GAAG,YAAY,cAAc;QAAE,MAAM,GAAG,CAAC;IAC7C,IAAI,GAAG,YAAY,KAAK,EAAE,CAAC;QACzB,MAAM,MAAM,GAAG,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACzC,MAAM,SAAS,GAAI,GAAiC,CAAC,IAAI,CAAC;QAC1D,IAAI,SAAS,IAAI,qBAAqB,CAAC,GAAG,CAAC,SAA+B,CAAC,EAAE,CAAC;YAC5E,MAAM,IAAI,cAAc,CAAC,SAA+B,EAAE,MAAM,CAAC,CAAC;QACpE,CAAC;QACD,MAAM,IAAI,cAAc,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IAC9C,CAAC;IACD,MAAM,IAAI,cAAc,CAAC,SAAS,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;AACnD,CAAC;AAED,8EAA8E;AAC9E,sBAAsB;AACtB,8EAA8E;AAE9E;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,WAAmB;QACzB,OAAO,oBAAoB,CAAC,gBAAgB,CAAC,WAAW,CAAC,CAAC,KAAK,CAC7D,uBAAuB,CACxB,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,UAAU;QACR,OAAO,oBAAoB,CAAC,mBAAmB,EAAE,CAAC;IACpD,CAAC;IAED;;;;OAIG;IACH,WAAW;QACT,OAAO,oBAAoB,CAAC,oBAAoB,EAAE,CAAC;IACrD,CAAC;IAED;;;OAGG;IACH,kBAAkB;QAChB,OAAO,oBAAoB,CAAC,2BAA2B,EAAE,CAAC;IAC5D,CAAC;IAED;;;;;;;;;OASG;IACH,WAAW,CACT,KAAQ,EACR,QAEyC;QAEzC,MAAM,WAAW,GACf,KAAK,KAAK,uBAAuB;YAC/B,CAAC,CAAC,yBAAyB;YAC3B,CAAC,CAAC,mBAAmB,CAAC;QAC1B,OAAO,oBAAoB,CAAC,WAAW,CACrC,WAAW,EACX,QAAoC,CAChB,CAAC;IACzB,CAAC;CACO,CAAC","sourcesContent":["import type { EventSubscription } from \"expo-modules-core\";\n\nimport ExpoSpotifySDKModule from \"../ExpoSpotifySDKModule\";\nimport { AppRemoteError, type AppRemoteErrorCode } from \"./error\";\n\nexport type { AppRemoteErrorCode } from \"./error\";\nexport { AppRemoteError } from \"./error\";\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\n/** Current state of the IPC connection to the Spotify app. */\nexport type ConnectionState = \"disconnected\" | \"connecting\" | \"connected\";\n\n/** Payload of the `connectionStateChange` event. */\nexport interface ConnectionStateChangeEvent {\n  state: ConnectionState;\n}\n\n/** Payload of the `connectionError` event. */\nexport interface ConnectionErrorEvent {\n  code: AppRemoteErrorCode;\n  message: string;\n}\n\n// ---------------------------------------------------------------------------\n// Internal helpers\n// ---------------------------------------------------------------------------\n\nconst VALID_APPREMOTE_CODES = new Set<AppRemoteErrorCode>([\n  \"CONNECTION_FAILED\",\n  \"CONNECTION_LOST\",\n  \"NOT_CONNECTED\",\n  \"UNKNOWN\",\n]);\n\nconst CAUSE_SEPARATOR = \"→ Caused by: \";\n\nfunction unwrapReason(message: string): string {\n  const idx = message.lastIndexOf(CAUSE_SEPARATOR);\n  return idx === -1 ? message : message.slice(idx + CAUSE_SEPARATOR.length);\n}\n\nfunction rethrowAsAppRemoteError(err: unknown): never {\n  if (err instanceof AppRemoteError) throw err;\n  if (err instanceof Error) {\n    const reason = unwrapReason(err.message);\n    const maybeCode = (err as Error & { code?: string }).code;\n    if (maybeCode && VALID_APPREMOTE_CODES.has(maybeCode as AppRemoteErrorCode)) {\n      throw new AppRemoteError(maybeCode as AppRemoteErrorCode, reason);\n    }\n    throw new AppRemoteError(\"UNKNOWN\", reason);\n  }\n  throw new AppRemoteError(\"UNKNOWN\", String(err));\n}\n\n// ---------------------------------------------------------------------------\n// AppRemote namespace\n// ---------------------------------------------------------------------------\n\n/**\n * Spotify App Remote namespace. Manages the IPC connection to the running\n * Spotify app. All `Player`, `User`, `Content`, and `Images` calls require an\n * active connection established via `AppRemote.connect()`.\n *\n * @example\n * ```ts\n * import { AppRemote } from \"@wwdrew/expo-spotify-sdk\";\n *\n * // Connect using the access token from Auth.authenticate()\n * await AppRemote.connect(session.accessToken);\n *\n * const sub = AppRemote.addListener(\"connectionStateChange\", ({ state }) => {\n *   console.log(\"connection state:\", state);\n * });\n *\n * // later:\n * await AppRemote.disconnect();\n * sub.remove();\n * ```\n */\nexport const AppRemote = {\n  /**\n   * Opens a connection to the running Spotify app using the provided access\n   * token. Resolves when the connection is established; rejects with an\n   * {@link AppRemoteError} if the connection fails.\n   *\n   * **Android note:** The access token is accepted for API parity with iOS but\n   * the Android App Remote SDK does not accept it directly — it uses the\n   * session cached in the Spotify app from your earlier `Auth.authenticate()`\n   * call. Ensure `Auth.authenticate()` has succeeded before calling `connect()`.\n   *\n   * Calling `connect()` while already connected is a no-op.\n   */\n  connect(accessToken: string): Promise<void> {\n    return ExpoSpotifySDKModule.appRemoteConnect(accessToken).catch(\n      rethrowAsAppRemoteError,\n    );\n  },\n\n  /**\n   * Disconnects from the Spotify app. Safe to call when already disconnected.\n   * Resolves once the disconnection is complete.\n   */\n  disconnect(): Promise<void> {\n    return ExpoSpotifySDKModule.appRemoteDisconnect();\n  },\n\n  /**\n   * Returns `true` if currently connected to the Spotify app.\n   * This is a synchronous snapshot — subscribe to `\"connectionStateChange\"`\n   * for reactive updates.\n   */\n  isConnected(): boolean {\n    return ExpoSpotifySDKModule.appRemoteIsConnected();\n  },\n\n  /**\n   * Returns the current {@link ConnectionState} synchronously.\n   * Subscribe to `\"connectionStateChange\"` for reactive updates.\n   */\n  getConnectionState(): Promise<ConnectionState> {\n    return ExpoSpotifySDKModule.appRemoteGetConnectionState();\n  },\n\n  /**\n   * Subscribes to connection lifecycle events.\n   *\n   * | Event | Payload | When |\n   * |---|---|---|\n   * | `\"connectionStateChange\"` | `{ state: ConnectionState }` | State transitions |\n   * | `\"connectionError\"` | `{ code, message }` | Connection failures and drops |\n   *\n   * Returns a `Subscription` — call `.remove()` to unsubscribe.\n   */\n  addListener<E extends \"connectionStateChange\" | \"connectionError\">(\n    event: E,\n    listener: E extends \"connectionStateChange\"\n      ? (event: ConnectionStateChangeEvent) => void\n      : (event: ConnectionErrorEvent) => void,\n  ): EventSubscription {\n    const nativeEvent =\n      event === \"connectionStateChange\"\n        ? \"onConnectionStateChange\"\n        : \"onConnectionError\";\n    return ExpoSpotifySDKModule.addListener(\n      nativeEvent,\n      listener as (event: unknown) => void,\n    ) as EventSubscription;\n  },\n} as const;\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/app-remote/index.ts"],"names":[],"mappings":"AAEA,OAAO,oBAAoB,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAA2B,MAAM,SAAS,CAAC;AAClE,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AAGrE,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAoBzC,8EAA8E;AAC9E,mBAAmB;AACnB,8EAA8E;AAE9E,MAAM,uBAAuB,GAAG,wBAAwB,CAAC;IACvD,UAAU,EAAE,cAAc;IAC1B,WAAW,EAAE,SAAS;IACtB,UAAU,EAAE,IAAI,GAAG,CAAqB;QACtC,mBAAmB;QACnB,iBAAiB;QACjB,eAAe;QACf,SAAS;KACV,CAAC;CACH,CAAC,CAAC;AAEH,8EAA8E;AAC9E,sBAAsB;AACtB,8EAA8E;AAE9E;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,WAAmB;QACzB,OAAO,oBAAoB,CAAC,gBAAgB,CAAC,WAAW,CAAC,CAAC,KAAK,CAC7D,uBAAuB,CACxB,CAAC;IACJ,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAgCG;IACH,gBAAgB,CAAC,WAAmB,EAAE,MAAc,EAAE;QACpD,OAAO,oBAAoB,CAAC,yBAAyB,CACnD,WAAW,EACX,GAAG,CACJ,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC;IACnC,CAAC;IAED;;;OAGG;IACH,UAAU;QACR,OAAO,oBAAoB,CAAC,mBAAmB,EAAE,CAAC;IACpD,CAAC;IAED;;;;OAIG;IACH,WAAW;QACT,OAAO,oBAAoB,CAAC,oBAAoB,EAAE,CAAC;IACrD,CAAC;IAED;;;OAGG;IACH,kBAAkB;QAChB,OAAO,oBAAoB,CAAC,2BAA2B,EAAE,CAAC;IAC5D,CAAC;IAED;;;;;;;;;OASG;IACH,WAAW,CACT,KAAQ,EACR,QAEyC;QAEzC,MAAM,WAAW,GACf,KAAK,KAAK,uBAAuB;YAC/B,CAAC,CAAC,yBAAyB;YAC3B,CAAC,CAAC,mBAAmB,CAAC;QAC1B,OAAO,oBAAoB,CAAC,WAAW,CACrC,WAAW,EACX,QAAoC,CAChB,CAAC;IACzB,CAAC;CACO,CAAC","sourcesContent":["import type { EventSubscription } from \"expo-modules-core\";\n\nimport ExpoSpotifySDKModule from \"../ExpoSpotifySDKModule\";\nimport { AppRemoteError, type AppRemoteErrorCode } from \"./error\";\nimport { createNativeErrorRethrow } from \"../internal/native-errors\";\n\nexport type { AppRemoteErrorCode } from \"./error\";\nexport { AppRemoteError } from \"./error\";\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\n/** Current state of the IPC connection to the Spotify app. */\nexport type ConnectionState = \"disconnected\" | \"connecting\" | \"connected\";\n\n/** Payload of the `connectionStateChange` event. */\nexport interface ConnectionStateChangeEvent {\n  state: ConnectionState;\n}\n\n/** Payload of the `connectionError` event. */\nexport interface ConnectionErrorEvent {\n  code: AppRemoteErrorCode;\n  message: string;\n}\n\n// ---------------------------------------------------------------------------\n// Internal helpers\n// ---------------------------------------------------------------------------\n\nconst rethrowAsAppRemoteError = createNativeErrorRethrow({\n  ErrorClass: AppRemoteError,\n  unknownCode: \"UNKNOWN\",\n  validCodes: new Set<AppRemoteErrorCode>([\n    \"CONNECTION_FAILED\",\n    \"CONNECTION_LOST\",\n    \"NOT_CONNECTED\",\n    \"UNKNOWN\",\n  ]),\n});\n\n// ---------------------------------------------------------------------------\n// AppRemote namespace\n// ---------------------------------------------------------------------------\n\n/**\n * Spotify App Remote namespace. Manages the IPC connection to the running\n * Spotify app. All `Player`, `User`, `Content`, and `Images` calls require an\n * active connection established via `AppRemote.connect()`.\n *\n * @example\n * ```ts\n * import { AppRemote } from \"@wwdrew/expo-spotify-sdk\";\n *\n * // Connect using the access token from Auth.authenticate()\n * await AppRemote.connect(session.accessToken);\n *\n * const sub = AppRemote.addListener(\"connectionStateChange\", ({ state }) => {\n *   console.log(\"connection state:\", state);\n * });\n *\n * // later:\n * await AppRemote.disconnect();\n * sub.remove();\n * ```\n */\nexport const AppRemote = {\n  /**\n   * Opens a connection to the running Spotify app using the provided access\n   * token. Resolves when the connection is established; rejects with an\n   * {@link AppRemoteError} if the connection fails.\n   *\n   * **Android note:** The access token is accepted for API parity with iOS but\n   * the Android App Remote SDK does not accept it directly — it uses the\n   * session cached in the Spotify app from your earlier `Auth.authenticate()`\n   * call. Ensure `Auth.authenticate()` has succeeded before calling `connect()`.\n   *\n   * Calling `connect()` while already connected is a no-op.\n   */\n  connect(accessToken: string): Promise<void> {\n    return ExpoSpotifySDKModule.appRemoteConnect(accessToken).catch(\n      rethrowAsAppRemoteError,\n    );\n  },\n\n  /**\n   * Wakes the Spotify app — launching it if it has been suspended in the\n   * background — starts playback, and then establishes the App Remote\n   * connection. This is the recommended way to (re)connect when Spotify may\n   * not currently be running.\n   *\n   * Why this exists: {@link connect} only attaches to an *already-running*\n   * Spotify process. If Spotify has been suspended (e.g. iOS reclaims a\n   * backgrounded app that isn't playing audio, or the connection dropped\n   * ~30s after the user paused), `connect()` rejects with `CONNECTION_FAILED`\n   * and there is no way to revive Spotify from `connect()` alone.\n   * `authorizeAndPlay()` performs an app-switch to Spotify\n   * (iOS `authorizeAndPlayURI`; Android wakes the App Remote service and\n   * issues a play command), which both revives Spotify and keeps it alive by\n   * starting audio.\n   *\n   * Trade-offs:\n   * - It **always starts (or resumes) playback** — it cannot wake Spotify\n   *   silently.\n   * - It briefly **switches to the Spotify app** and back; the OS does not\n   *   allow waking another app without a foreground app-switch.\n   * - Requires Spotify Premium for on-demand playback of a specific `uri`.\n   *\n   * @param accessToken Access token from `Auth.authenticate()`. On Android this\n   *   is an iOS-parity parameter (see {@link connect}); on iOS the token\n   *   returned by the authorization redirect is used to complete the connection.\n   * @param uri Spotify URI to play. Pass an empty string (the default) to\n   *   resume the user's last track or play a contextual/random track.\n   *\n   * Resolves once Spotify is connected and the play command has been issued;\n   * rejects with an {@link AppRemoteError} if Spotify is not installed or the\n   * authorization is denied.\n   */\n  authorizeAndPlay(accessToken: string, uri: string = \"\"): Promise<void> {\n    return ExpoSpotifySDKModule.appRemoteAuthorizeAndPlay(\n      accessToken,\n      uri,\n    ).catch(rethrowAsAppRemoteError);\n  },\n\n  /**\n   * Disconnects from the Spotify app. Safe to call when already disconnected.\n   * Resolves once the disconnection is complete.\n   */\n  disconnect(): Promise<void> {\n    return ExpoSpotifySDKModule.appRemoteDisconnect();\n  },\n\n  /**\n   * Returns `true` if currently connected to the Spotify app.\n   * This is a synchronous snapshot — subscribe to `\"connectionStateChange\"`\n   * for reactive updates.\n   */\n  isConnected(): boolean {\n    return ExpoSpotifySDKModule.appRemoteIsConnected();\n  },\n\n  /**\n   * Returns the current {@link ConnectionState} synchronously.\n   * Subscribe to `\"connectionStateChange\"` for reactive updates.\n   */\n  getConnectionState(): Promise<ConnectionState> {\n    return ExpoSpotifySDKModule.appRemoteGetConnectionState();\n  },\n\n  /**\n   * Subscribes to connection lifecycle events.\n   *\n   * | Event | Payload | When |\n   * |---|---|---|\n   * | `\"connectionStateChange\"` | `{ state: ConnectionState }` | State transitions |\n   * | `\"connectionError\"` | `{ code, message }` | Connection failures and drops |\n   *\n   * Returns a `Subscription` — call `.remove()` to unsubscribe.\n   */\n  addListener<E extends \"connectionStateChange\" | \"connectionError\">(\n    event: E,\n    listener: E extends \"connectionStateChange\"\n      ? (event: ConnectionStateChangeEvent) => void\n      : (event: ConnectionErrorEvent) => void,\n  ): EventSubscription {\n    const nativeEvent =\n      event === \"connectionStateChange\"\n        ? \"onConnectionStateChange\"\n        : \"onConnectionError\";\n    return ExpoSpotifySDKModule.addListener(\n      nativeEvent,\n      listener as (event: unknown) => void,\n    ) as EventSubscription;\n  },\n} as const;\n"]}

package/build/auth/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/auth/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAI3D,OAAO,EAAa,KAAK,aAAa,EAAE,MAAM,SAAS,CAAC;AAExD,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAMpC,MAAM,WAAW,cAAc;IAC7B,0BAA0B;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,uDAAuD;IACvD,cAAc,EAAE,MAAM,CAAC;IACvB,+EAA+E;IAC/E,MAAM,EAAE,YAAY,EAAE,CAAC;CACxB;AAED,MAAM,MAAM,YAAY,GACpB,kBAAkB,GAClB,0BAA0B,GAC1B,4BAA4B,GAC5B,6BAA6B,GAC7B,oBAAoB,GACpB,WAAW,GACX,uBAAuB,GACvB,6BAA6B,GAC7B,yBAAyB,GACzB,wBAAwB,GACxB,oBAAoB,GACpB,kBAAkB,GAClB,eAAe,GACf,2BAA2B,GAC3B,qBAAqB,GACrB,mBAAmB,GACnB,iBAAiB,GACjB,mBAAmB,CAAC;AAExB,MAAM,WAAW,kBAAkB;IACjC,gEAAgE;IAChE,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,oEAAoE;IACpE,YAAY,EAAE,MAAM,CAAC;IACrB,iDAAiD;IACjD,eAAe,EAAE,MAAM,CAAC;IACxB;;;OAGG;IACH,MAAM,CAAC,EAAE,YAAY,EAAE,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAC1B;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,OAAO,EAAE,cAAc,CAAA;CAAE,GAChD;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,OAAO,EAAE,cAAc,CAAA;CAAE,GAC7C;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE;QAAE,IAAI,EAAE,aAAa,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,CAAC;AAgFzE;;;;;;;;;GASG;AACH,eAAO,MAAM,IAAI;IACf;;OAEG;gCACY,OAAO;IAItB;;;OAGG;oCACkB,kBAAkB,KAAG,OAAO,CAAC,cAAc,CAAC;IAmBjE;;;;OAIG;+BACa,aAAa,KAAG,OAAO,CAAC,cAAc,CAAC;IAgBvD;;;;;;;OAOG;kCACc,OAAO,CAAC,IAAI,CAAC;IAO9B;;;;;;;;;;;;;;;;;;;OAmBG;kCAEM,eAAe,YACZ,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,KAC5C,iBAAiB;CAMZ,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/auth/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAI3D,OAAO,EAAa,KAAK,aAAa,EAAE,MAAM,SAAS,CAAC;AAGxD,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAMpC,MAAM,WAAW,cAAc;IAC7B,0BAA0B;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,uDAAuD;IACvD,cAAc,EAAE,MAAM,CAAC;IACvB,+EAA+E;IAC/E,MAAM,EAAE,YAAY,EAAE,CAAC;CACxB;AAED,MAAM,MAAM,YAAY,GACpB,kBAAkB,GAClB,0BAA0B,GAC1B,4BAA4B,GAC5B,6BAA6B,GAC7B,oBAAoB,GACpB,WAAW,GACX,uBAAuB,GACvB,6BAA6B,GAC7B,yBAAyB,GACzB,wBAAwB,GACxB,oBAAoB,GACpB,kBAAkB,GAClB,eAAe,GACf,2BAA2B,GAC3B,qBAAqB,GACrB,mBAAmB,GACnB,iBAAiB,GACjB,mBAAmB,CAAC;AAExB,MAAM,WAAW,kBAAkB;IACjC,gEAAgE;IAChE,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,oEAAoE;IACpE,YAAY,EAAE,MAAM,CAAC;IACrB,iDAAiD;IACjD,eAAe,EAAE,MAAM,CAAC;IACxB;;;OAGG;IACH,MAAM,CAAC,EAAE,YAAY,EAAE,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAC1B;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,OAAO,EAAE,cAAc,CAAA;CAAE,GAChD;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,OAAO,EAAE,cAAc,CAAA;CAAE,GAC7C;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE;QAAE,IAAI,EAAE,aAAa,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,CAAC;AA+DzE;;;;;;;;;GASG;AACH,eAAO,MAAM,IAAI;IACf;;OAEG;gCACY,OAAO;IAItB;;;OAGG;oCACkB,kBAAkB,KAAG,OAAO,CAAC,cAAc,CAAC;IAsBjE;;;;OAIG;+BACa,aAAa,KAAG,OAAO,CAAC,cAAc,CAAC;IAgBvD;;;;;;;OAOG;kCACc,OAAO,CAAC,IAAI,CAAC;IAO9B;;;;;;;;;;;;;;;;;;;OAmBG;kCAEM,eAAe,YACZ,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,KAC5C,iBAAiB;CAMZ,CAAC"}