@wwdrew/expo-spotify-sdk 0.7.1 → 1.0.0

package/build/ExpoSpotifySDK.types.d.ts

@@ -28,6 +28,18 @@ export interface SpotifyRefreshConfig {
     refreshToken: string;
     /** URL of your token refresh server endpoint. */
     tokenRefreshURL: string;
+    /**
+     * Scopes that were granted by the previous session. Used as a fallback
+     * when the refresh response omits the `scope` field (which most
+     * `accounts.spotify.com` refresh responses do — Spotify only returns
+     * `scope` when the granted scope set has changed).
+     *
+     * If omitted, the returned `SpotifySession.scopes` will be `[]` whenever
+     * the refresh response also omits `scope` — silently losing scope
+     * information you held a moment ago. Pass through the previous session's
+     * `scopes` to avoid that.
+     */
+    scopes?: SpotifyScope[];
 }
 /**
  * Configuration accepted by `authenticateAsync`.

package/build/ExpoSpotifySDK.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ExpoSpotifySDK.types.d.ts","sourceRoot":"","sources":["../src/ExpoSpotifySDK.types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,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;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,kEAAkE;IAClE,YAAY,EAAE,MAAM,CAAC;IACrB,iDAAiD;IACjD,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,gEAAgE;IAChE,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;;GAGG;AACH,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;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GACxB,gBAAgB,GAChB,kBAAkB,GAClB,gBAAgB,GAChB,eAAe,GACf,mBAAmB,GACnB,wBAAwB,GACxB,uBAAuB,GACvB,YAAY,GACZ,SAAS,CAAC;AAEd;;;;;;GAMG;AACH,MAAM,MAAM,yBAAyB,GACjC;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,gBAAgB,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,CAAC;AAE5E;;;GAGG;AACH,qBAAa,YAAa,SAAQ,KAAK;IACrC,SAAgB,IAAI,EAAE,gBAAgB,CAAC;gBAE3B,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM;CAKpD"}
+{"version":3,"file":"ExpoSpotifySDK.types.d.ts","sourceRoot":"","sources":["../src/ExpoSpotifySDK.types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,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;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,kEAAkE;IAClE,YAAY,EAAE,MAAM,CAAC;IACrB,iDAAiD;IACjD,eAAe,EAAE,MAAM,CAAC;IACxB;;;;;;;;;;OAUG;IACH,MAAM,CAAC,EAAE,YAAY,EAAE,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,gEAAgE;IAChE,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;;GAGG;AACH,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;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GACxB,gBAAgB,GAChB,kBAAkB,GAClB,gBAAgB,GAChB,eAAe,GACf,mBAAmB,GACnB,wBAAwB,GACxB,uBAAuB,GACvB,YAAY,GACZ,SAAS,CAAC;AAEd;;;;;;GAMG;AACH,MAAM,MAAM,yBAAyB,GACjC;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,gBAAgB,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,CAAC;AAE5E;;;GAGG;AACH,qBAAa,YAAa,SAAQ,KAAK;IACrC,SAAgB,IAAI,EAAE,gBAAgB,CAAC;gBAE3B,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM;CAKpD"}

package/build/ExpoSpotifySDK.types.js.map

@@ -1 +1 @@
-{"version":3,"file":"ExpoSpotifySDK.types.js","sourceRoot":"","sources":["../src/ExpoSpotifySDK.types.ts"],"names":[],"mappings":"AA+GA;;;GAGG;AACH,MAAM,OAAO,YAAa,SAAQ,KAAK;IACrB,IAAI,CAAmB;IAEvC,YAAY,IAAsB,EAAE,OAAe;QACjD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;QAC3B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF","sourcesContent":["/**\n * Result of a successful Spotify authentication.\n *\n * The shape is identical across iOS and Android. On the Android implicit\n * (TOKEN) flow `refreshToken` is `null` and `scopes` reflects what was\n * *requested*, not granted — see the README's \"Android implicit flow is not\n * recommended\" section.\n */\nexport interface SpotifySession {\n  /** OAuth access token. */\n  accessToken: string;\n  /**\n   * OAuth refresh token. `null` on Android when no `tokenSwapURL` is provided\n   * (the Spotify Android SDK does not expose a refresh token for implicit\n   * grants — see the README).\n   */\n  refreshToken: string | null;\n  /** Expiration timestamp as Unix epoch milliseconds. */\n  expirationDate: number;\n  /** Scopes the access token was granted (or requested, on Android implicit). */\n  scopes: SpotifyScope[];\n}\n\n/**\n * Configuration accepted by `refreshSessionAsync`.\n */\nexport interface SpotifyRefreshConfig {\n  /** The refresh token from a previous `authenticateAsync` call. */\n  refreshToken: string;\n  /** URL of your token refresh server endpoint. */\n  tokenRefreshURL: string;\n}\n\n/**\n * Configuration accepted by `authenticateAsync`.\n */\nexport interface SpotifyConfig {\n  /** OAuth scopes to request. Must contain at least one entry. */\n  scopes: SpotifyScope[];\n  /**\n   * If supplied, requests an authorization code rather than an implicit\n   * token, then POSTs the code to this URL to exchange it for tokens.\n   * **Required on Android** to receive a usable `refreshToken`.\n   */\n  tokenSwapURL?: string;\n  /**\n   * Used by the iOS SDK to refresh access tokens automatically, and by\n   * `refreshSessionAsync` on both platforms.\n   */\n  tokenRefreshURL?: string;\n  /**\n   * If `true`, forces Spotify to show the authorization dialog even when\n   * the user already has an active session. Defaults to `false`.\n   *\n   * Maps to `SPTSessionManager.alwaysShowAuthorizationDialog` on iOS and\n   * `AuthorizationRequest.Builder.setShowDialog(true)` on Android.\n   */\n  showDialog?: boolean;\n}\n\n/**\n * Spotify OAuth scope identifiers that are valid through the iOS, Android\n * and Web auth flows. See https://developer.spotify.com/documentation/web-api/concepts/scopes\n */\nexport type SpotifyScope =\n  | \"ugc-image-upload\"\n  | \"user-read-playback-state\"\n  | \"user-modify-playback-state\"\n  | \"user-read-currently-playing\"\n  | \"app-remote-control\"\n  | \"streaming\"\n  | \"playlist-read-private\"\n  | \"playlist-read-collaborative\"\n  | \"playlist-modify-private\"\n  | \"playlist-modify-public\"\n  | \"user-follow-modify\"\n  | \"user-follow-read\"\n  | \"user-top-read\"\n  | \"user-read-recently-played\"\n  | \"user-library-modify\"\n  | \"user-library-read\"\n  | \"user-read-email\"\n  | \"user-read-private\";\n\n/**\n * JS-side error code constants thrown via `Promise.reject(new Error(...))`\n * by the native modules.\n */\nexport type SpotifyErrorCode =\n  | \"USER_CANCELLED\"\n  | \"AUTH_IN_PROGRESS\"\n  | \"INVALID_CONFIG\"\n  | \"NETWORK_ERROR\"\n  | \"TOKEN_SWAP_FAILED\"\n  | \"TOKEN_SWAP_PARSE_ERROR\"\n  | \"SPOTIFY_NOT_INSTALLED\"\n  | \"AUTH_ERROR\"\n  | \"UNKNOWN\";\n\n/**\n * Payload delivered to `addSessionChangeListener` subscribers.\n *\n * - `didInitiate` — a new session was created by `authenticateAsync`\n * - `didRenew`    — an existing session was refreshed by `refreshSessionAsync`\n * - `didFail`     — an auth or refresh attempt failed\n */\nexport type SpotifySessionChangeEvent =\n  | { type: \"didInitiate\"; session: SpotifySession }\n  | { type: \"didRenew\"; session: SpotifySession }\n  | { type: \"didFail\"; error: { code: SpotifyErrorCode; message: string } };\n\n/**\n * Error subclass thrown by `authenticateAsync` and `refreshSessionAsync`\n * carrying a structured `code` field for branching.\n */\nexport class SpotifyError extends Error {\n  public readonly code: SpotifyErrorCode;\n\n  constructor(code: SpotifyErrorCode, message: string) {\n    super(message);\n    this.name = \"SpotifyError\";\n    this.code = code;\n  }\n}\n"]}
+{"version":3,"file":"ExpoSpotifySDK.types.js","sourceRoot":"","sources":["../src/ExpoSpotifySDK.types.ts"],"names":[],"mappings":"AA2HA;;;GAGG;AACH,MAAM,OAAO,YAAa,SAAQ,KAAK;IACrB,IAAI,CAAmB;IAEvC,YAAY,IAAsB,EAAE,OAAe;QACjD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;QAC3B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF","sourcesContent":["/**\n * Result of a successful Spotify authentication.\n *\n * The shape is identical across iOS and Android. On the Android implicit\n * (TOKEN) flow `refreshToken` is `null` and `scopes` reflects what was\n * *requested*, not granted — see the README's \"Android implicit flow is not\n * recommended\" section.\n */\nexport interface SpotifySession {\n  /** OAuth access token. */\n  accessToken: string;\n  /**\n   * OAuth refresh token. `null` on Android when no `tokenSwapURL` is provided\n   * (the Spotify Android SDK does not expose a refresh token for implicit\n   * grants — see the README).\n   */\n  refreshToken: string | null;\n  /** Expiration timestamp as Unix epoch milliseconds. */\n  expirationDate: number;\n  /** Scopes the access token was granted (or requested, on Android implicit). */\n  scopes: SpotifyScope[];\n}\n\n/**\n * Configuration accepted by `refreshSessionAsync`.\n */\nexport interface SpotifyRefreshConfig {\n  /** The refresh token from a previous `authenticateAsync` call. */\n  refreshToken: string;\n  /** URL of your token refresh server endpoint. */\n  tokenRefreshURL: string;\n  /**\n   * Scopes that were granted by the previous session. Used as a fallback\n   * when the refresh response omits the `scope` field (which most\n   * `accounts.spotify.com` refresh responses do — Spotify only returns\n   * `scope` when the granted scope set has changed).\n   *\n   * If omitted, the returned `SpotifySession.scopes` will be `[]` whenever\n   * the refresh response also omits `scope` — silently losing scope\n   * information you held a moment ago. Pass through the previous session's\n   * `scopes` to avoid that.\n   */\n  scopes?: SpotifyScope[];\n}\n\n/**\n * Configuration accepted by `authenticateAsync`.\n */\nexport interface SpotifyConfig {\n  /** OAuth scopes to request. Must contain at least one entry. */\n  scopes: SpotifyScope[];\n  /**\n   * If supplied, requests an authorization code rather than an implicit\n   * token, then POSTs the code to this URL to exchange it for tokens.\n   * **Required on Android** to receive a usable `refreshToken`.\n   */\n  tokenSwapURL?: string;\n  /**\n   * Used by the iOS SDK to refresh access tokens automatically, and by\n   * `refreshSessionAsync` on both platforms.\n   */\n  tokenRefreshURL?: string;\n  /**\n   * If `true`, forces Spotify to show the authorization dialog even when\n   * the user already has an active session. Defaults to `false`.\n   *\n   * Maps to `SPTSessionManager.alwaysShowAuthorizationDialog` on iOS and\n   * `AuthorizationRequest.Builder.setShowDialog(true)` on Android.\n   */\n  showDialog?: boolean;\n}\n\n/**\n * Spotify OAuth scope identifiers that are valid through the iOS, Android\n * and Web auth flows. See https://developer.spotify.com/documentation/web-api/concepts/scopes\n */\nexport type SpotifyScope =\n  | \"ugc-image-upload\"\n  | \"user-read-playback-state\"\n  | \"user-modify-playback-state\"\n  | \"user-read-currently-playing\"\n  | \"app-remote-control\"\n  | \"streaming\"\n  | \"playlist-read-private\"\n  | \"playlist-read-collaborative\"\n  | \"playlist-modify-private\"\n  | \"playlist-modify-public\"\n  | \"user-follow-modify\"\n  | \"user-follow-read\"\n  | \"user-top-read\"\n  | \"user-read-recently-played\"\n  | \"user-library-modify\"\n  | \"user-library-read\"\n  | \"user-read-email\"\n  | \"user-read-private\";\n\n/**\n * JS-side error code constants thrown via `Promise.reject(new Error(...))`\n * by the native modules.\n */\nexport type SpotifyErrorCode =\n  | \"USER_CANCELLED\"\n  | \"AUTH_IN_PROGRESS\"\n  | \"INVALID_CONFIG\"\n  | \"NETWORK_ERROR\"\n  | \"TOKEN_SWAP_FAILED\"\n  | \"TOKEN_SWAP_PARSE_ERROR\"\n  | \"SPOTIFY_NOT_INSTALLED\"\n  | \"AUTH_ERROR\"\n  | \"UNKNOWN\";\n\n/**\n * Payload delivered to `addSessionChangeListener` subscribers.\n *\n * - `didInitiate` — a new session was created by `authenticateAsync`\n * - `didRenew`    — an existing session was refreshed by `refreshSessionAsync`\n * - `didFail`     — an auth or refresh attempt failed\n */\nexport type SpotifySessionChangeEvent =\n  | { type: \"didInitiate\"; session: SpotifySession }\n  | { type: \"didRenew\"; session: SpotifySession }\n  | { type: \"didFail\"; error: { code: SpotifyErrorCode; message: string } };\n\n/**\n * Error subclass thrown by `authenticateAsync` and `refreshSessionAsync`\n * carrying a structured `code` field for branching.\n */\nexport class SpotifyError extends Error {\n  public readonly code: SpotifyErrorCode;\n\n  constructor(code: SpotifyErrorCode, message: string) {\n    super(message);\n    this.name = \"SpotifyError\";\n    this.code = code;\n  }\n}\n"]}

package/build/ExpoSpotifySDKModule.web.d.ts

@@ -2,6 +2,29 @@ declare const _default: {
     isAvailable(): boolean;
     authenticateAsync(): Promise<never>;
     refreshSessionAsync(): Promise<never>;
+    appRemoteConnect(): Promise<never>;
+    appRemoteDisconnect(): Promise<never>;
+    appRemoteIsConnected(): boolean;
+    appRemoteGetConnectionState(): Promise<"disconnected">;
+    playerPlay(): Promise<never>;
+    playerPause(): Promise<never>;
+    playerResume(): Promise<never>;
+    playerSkipNext(): Promise<never>;
+    playerSkipPrevious(): Promise<never>;
+    playerSeekTo(): Promise<never>;
+    playerSetShuffle(): Promise<never>;
+    playerSetRepeatMode(): Promise<never>;
+    playerSetPodcastPlaybackSpeed(): Promise<never>;
+    playerQueue(): Promise<never>;
+    playerGetPlayerState(): Promise<never>;
+    playerGetCrossfadeState(): Promise<never>;
+    userGetCapabilities(): Promise<never>;
+    userGetLibraryState(): Promise<never>;
+    userAddToLibrary(): Promise<never>;
+    userRemoveFromLibrary(): Promise<never>;
+    contentGetRecommendedContentItems(): Promise<never>;
+    contentGetChildren(): Promise<never>;
+    imagesLoad(): Promise<never>;
     addListener(): {
         remove(): void;
     };

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

@@ -1 +1 @@
-{"version":3,"file":"ExpoSpotifySDKModule.web.d.ts","sourceRoot":"","sources":["../src/ExpoSpotifySDKModule.web.ts"],"names":[],"mappings":";mBAUiB,OAAO;yBAGD,OAAO,CAAC,KAAK,CAAC;2BAGZ,OAAO,CAAC,KAAK,CAAC;mBAGtB;QAAE,MAAM,IAAI,IAAI,CAAA;KAAE;uBAGd,IAAI;;AAbzB,wBAgBE"}
+{"version":3,"file":"ExpoSpotifySDKModule.web.d.ts","sourceRoot":"","sources":["../src/ExpoSpotifySDKModule.web.ts"],"names":[],"mappings":";mBAQiB,OAAO;yBAGD,OAAO,CAAC,KAAK,CAAC;2BAGZ,OAAO,CAAC,KAAK,CAAC;wBAGjB,OAAO,CAAC,KAAK,CAAC;2BAGX,OAAO,CAAC,KAAK,CAAC;4BAGb,OAAO;mCAGA,OAAO,CAAC,cAAc,CAAC;kBAGxC,OAAO,CAAC,KAAK,CAAC;mBAGb,OAAO,CAAC,KAAK,CAAC;oBAGb,OAAO,CAAC,KAAK,CAAC;sBAGZ,OAAO,CAAC,KAAK,CAAC;0BAGV,OAAO,CAAC,KAAK,CAAC;oBAGpB,OAAO,CAAC,KAAK,CAAC;wBAGV,OAAO,CAAC,KAAK,CAAC;2BAGX,OAAO,CAAC,KAAK,CAAC;qCAGJ,OAAO,CAAC,KAAK,CAAC;mBAGhC,OAAO,CAAC,KAAK,CAAC;4BAGL,OAAO,CAAC,KAAK,CAAC;+BAGX,OAAO,CAAC,KAAK,CAAC;2BAGlB,OAAO,CAAC,KAAK,CAAC;2BAGd,OAAO,CAAC,KAAK,CAAC;wBAGjB,OAAO,CAAC,KAAK,CAAC;6BAGT,OAAO,CAAC,KAAK,CAAC;yCAGF,OAAO,CAAC,KAAK,CAAC;0BAG7B,OAAO,CAAC,KAAK,CAAC;kBAGtB,OAAO,CAAC,KAAK,CAAC;mBAGb;QAAE,MAAM,IAAI,IAAI,CAAA;KAAE;uBAGd,IAAI;;AAlFzB,wBAqFE"}

package/build/ExpoSpotifySDKModule.web.js

@@ -1,16 +1,85 @@
-import { SpotifyError } from "./ExpoSpotifySDK.types";
-function notImplementedReject(method) {
-    return new SpotifyError("INVALID_CONFIG", `expo-spotify-sdk: ${method} is not implemented on web yet (planned for v0.7.0).`);
+function unsupported(method) {
+    return new Error(`[expo-spotify-sdk] ${method} is not supported on web. ` +
+        "This library targets iOS and Android only.");
 }
 export default {
     isAvailable() {
         return false;
     },
     authenticateAsync() {
-        return Promise.reject(notImplementedReject("authenticateAsync"));
+        return Promise.reject(unsupported("authenticateAsync"));
     },
     refreshSessionAsync() {
-        return Promise.reject(notImplementedReject("refreshSessionAsync"));
+        return Promise.reject(unsupported("refreshSessionAsync"));
+    },
+    appRemoteConnect() {
+        return Promise.reject(unsupported("appRemoteConnect"));
+    },
+    appRemoteDisconnect() {
+        return Promise.reject(unsupported("appRemoteDisconnect"));
+    },
+    appRemoteIsConnected() {
+        return false;
+    },
+    appRemoteGetConnectionState() {
+        return Promise.resolve("disconnected");
+    },
+    playerPlay() {
+        return Promise.reject(unsupported("playerPlay"));
+    },
+    playerPause() {
+        return Promise.reject(unsupported("playerPause"));
+    },
+    playerResume() {
+        return Promise.reject(unsupported("playerResume"));
+    },
+    playerSkipNext() {
+        return Promise.reject(unsupported("playerSkipNext"));
+    },
+    playerSkipPrevious() {
+        return Promise.reject(unsupported("playerSkipPrevious"));
+    },
+    playerSeekTo() {
+        return Promise.reject(unsupported("playerSeekTo"));
+    },
+    playerSetShuffle() {
+        return Promise.reject(unsupported("playerSetShuffle"));
+    },
+    playerSetRepeatMode() {
+        return Promise.reject(unsupported("playerSetRepeatMode"));
+    },
+    playerSetPodcastPlaybackSpeed() {
+        return Promise.reject(unsupported("playerSetPodcastPlaybackSpeed"));
+    },
+    playerQueue() {
+        return Promise.reject(unsupported("playerQueue"));
+    },
+    playerGetPlayerState() {
+        return Promise.reject(unsupported("playerGetPlayerState"));
+    },
+    playerGetCrossfadeState() {
+        return Promise.reject(unsupported("playerGetCrossfadeState"));
+    },
+    userGetCapabilities() {
+        return Promise.reject(unsupported("userGetCapabilities"));
+    },
+    userGetLibraryState() {
+        return Promise.reject(unsupported("userGetLibraryState"));
+    },
+    userAddToLibrary() {
+        return Promise.reject(unsupported("userAddToLibrary"));
+    },
+    userRemoveFromLibrary() {
+        return Promise.reject(unsupported("userRemoveFromLibrary"));
+    },
+    contentGetRecommendedContentItems() {
+        return Promise.reject(unsupported("contentGetRecommendedContentItems"));
+    },
+    contentGetChildren() {
+        return Promise.reject(unsupported("contentGetChildren"));
+    },
+    imagesLoad() {
+        return Promise.reject(unsupported("imagesLoad"));
     },
     addListener() {
         return { remove() { } };

package/build/ExpoSpotifySDKModule.web.js.map

@@ -1 +1 @@
-{"version":3,"file":"ExpoSpotifySDKModule.web.js","sourceRoot":"","sources":["../src/ExpoSpotifySDKModule.web.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAEtD,SAAS,oBAAoB,CAAC,MAAc;IAC1C,OAAO,IAAI,YAAY,CACrB,gBAAgB,EAChB,qBAAqB,MAAM,sDAAsD,CAClF,CAAC;AACJ,CAAC;AAED,eAAe;IACb,WAAW;QACT,OAAO,KAAK,CAAC;IACf,CAAC;IACD,iBAAiB;QACf,OAAO,OAAO,CAAC,MAAM,CAAC,oBAAoB,CAAC,mBAAmB,CAAC,CAAC,CAAC;IACnE,CAAC;IACD,mBAAmB;QACjB,OAAO,OAAO,CAAC,MAAM,CAAC,oBAAoB,CAAC,qBAAqB,CAAC,CAAC,CAAC;IACrE,CAAC;IACD,WAAW;QACT,OAAO,EAAE,MAAM,KAAI,CAAC,EAAE,CAAC;IACzB,CAAC;IACD,eAAe;QACb,WAAW;IACb,CAAC;CACF,CAAC","sourcesContent":["import { SpotifyError } from \"./ExpoSpotifySDK.types\";\n\nfunction notImplementedReject(method: string): SpotifyError {\n  return new SpotifyError(\n    \"INVALID_CONFIG\",\n    `expo-spotify-sdk: ${method} is not implemented on web yet (planned for v0.7.0).`,\n  );\n}\n\nexport default {\n  isAvailable(): boolean {\n    return false;\n  },\n  authenticateAsync(): Promise<never> {\n    return Promise.reject(notImplementedReject(\"authenticateAsync\"));\n  },\n  refreshSessionAsync(): Promise<never> {\n    return Promise.reject(notImplementedReject(\"refreshSessionAsync\"));\n  },\n  addListener(): { remove(): void } {\n    return { remove() {} };\n  },\n  removeListeners(): void {\n    /* no-op */\n  },\n};\n"]}
+{"version":3,"file":"ExpoSpotifySDKModule.web.js","sourceRoot":"","sources":["../src/ExpoSpotifySDKModule.web.ts"],"names":[],"mappings":"AAAA,SAAS,WAAW,CAAC,MAAc;IACjC,OAAO,IAAI,KAAK,CACd,sBAAsB,MAAM,4BAA4B;QACtD,4CAA4C,CAC/C,CAAC;AACJ,CAAC;AAED,eAAe;IACb,WAAW;QACT,OAAO,KAAK,CAAC;IACf,CAAC;IACD,iBAAiB;QACf,OAAO,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,mBAAmB,CAAC,CAAC,CAAC;IAC1D,CAAC;IACD,mBAAmB;QACjB,OAAO,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,qBAAqB,CAAC,CAAC,CAAC;IAC5D,CAAC;IACD,gBAAgB;QACd,OAAO,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,kBAAkB,CAAC,CAAC,CAAC;IACzD,CAAC;IACD,mBAAmB;QACjB,OAAO,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,qBAAqB,CAAC,CAAC,CAAC;IAC5D,CAAC;IACD,oBAAoB;QAClB,OAAO,KAAK,CAAC;IACf,CAAC;IACD,2BAA2B;QACzB,OAAO,OAAO,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;IACzC,CAAC;IACD,UAAU;QACR,OAAO,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC,CAAC;IACnD,CAAC;IACD,WAAW;QACT,OAAO,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC,CAAC;IACpD,CAAC;IACD,YAAY;QACV,OAAO,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,cAAc,CAAC,CAAC,CAAC;IACrD,CAAC;IACD,cAAc;QACZ,OAAO,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,gBAAgB,CAAC,CAAC,CAAC;IACvD,CAAC;IACD,kBAAkB;QAChB,OAAO,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,oBAAoB,CAAC,CAAC,CAAC;IAC3D,CAAC;IACD,YAAY;QACV,OAAO,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,cAAc,CAAC,CAAC,CAAC;IACrD,CAAC;IACD,gBAAgB;QACd,OAAO,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,kBAAkB,CAAC,CAAC,CAAC;IACzD,CAAC;IACD,mBAAmB;QACjB,OAAO,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,qBAAqB,CAAC,CAAC,CAAC;IAC5D,CAAC;IACD,6BAA6B;QAC3B,OAAO,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,+BAA+B,CAAC,CAAC,CAAC;IACtE,CAAC;IACD,WAAW;QACT,OAAO,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC,CAAC;IACpD,CAAC;IACD,oBAAoB;QAClB,OAAO,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,sBAAsB,CAAC,CAAC,CAAC;IAC7D,CAAC;IACD,uBAAuB;QACrB,OAAO,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,yBAAyB,CAAC,CAAC,CAAC;IAChE,CAAC;IACD,mBAAmB;QACjB,OAAO,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,qBAAqB,CAAC,CAAC,CAAC;IAC5D,CAAC;IACD,mBAAmB;QACjB,OAAO,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,qBAAqB,CAAC,CAAC,CAAC;IAC5D,CAAC;IACD,gBAAgB;QACd,OAAO,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,kBAAkB,CAAC,CAAC,CAAC;IACzD,CAAC;IACD,qBAAqB;QACnB,OAAO,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,uBAAuB,CAAC,CAAC,CAAC;IAC9D,CAAC;IACD,iCAAiC;QAC/B,OAAO,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,mCAAmC,CAAC,CAAC,CAAC;IAC1E,CAAC;IACD,kBAAkB;QAChB,OAAO,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,oBAAoB,CAAC,CAAC,CAAC;IAC3D,CAAC;IACD,UAAU;QACR,OAAO,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC,CAAC;IACnD,CAAC;IACD,WAAW;QACT,OAAO,EAAE,MAAM,KAAI,CAAC,EAAE,CAAC;IACzB,CAAC;IACD,eAAe;QACb,WAAW;IACb,CAAC;CACF,CAAC","sourcesContent":["function unsupported(method: string): Error {\n  return new Error(\n    `[expo-spotify-sdk] ${method} is not supported on web. ` +\n      \"This library targets iOS and Android only.\",\n  );\n}\n\nexport default {\n  isAvailable(): boolean {\n    return false;\n  },\n  authenticateAsync(): Promise<never> {\n    return Promise.reject(unsupported(\"authenticateAsync\"));\n  },\n  refreshSessionAsync(): Promise<never> {\n    return Promise.reject(unsupported(\"refreshSessionAsync\"));\n  },\n  appRemoteConnect(): Promise<never> {\n    return Promise.reject(unsupported(\"appRemoteConnect\"));\n  },\n  appRemoteDisconnect(): Promise<never> {\n    return Promise.reject(unsupported(\"appRemoteDisconnect\"));\n  },\n  appRemoteIsConnected(): boolean {\n    return false;\n  },\n  appRemoteGetConnectionState(): Promise<\"disconnected\"> {\n    return Promise.resolve(\"disconnected\");\n  },\n  playerPlay(): Promise<never> {\n    return Promise.reject(unsupported(\"playerPlay\"));\n  },\n  playerPause(): Promise<never> {\n    return Promise.reject(unsupported(\"playerPause\"));\n  },\n  playerResume(): Promise<never> {\n    return Promise.reject(unsupported(\"playerResume\"));\n  },\n  playerSkipNext(): Promise<never> {\n    return Promise.reject(unsupported(\"playerSkipNext\"));\n  },\n  playerSkipPrevious(): Promise<never> {\n    return Promise.reject(unsupported(\"playerSkipPrevious\"));\n  },\n  playerSeekTo(): Promise<never> {\n    return Promise.reject(unsupported(\"playerSeekTo\"));\n  },\n  playerSetShuffle(): Promise<never> {\n    return Promise.reject(unsupported(\"playerSetShuffle\"));\n  },\n  playerSetRepeatMode(): Promise<never> {\n    return Promise.reject(unsupported(\"playerSetRepeatMode\"));\n  },\n  playerSetPodcastPlaybackSpeed(): Promise<never> {\n    return Promise.reject(unsupported(\"playerSetPodcastPlaybackSpeed\"));\n  },\n  playerQueue(): Promise<never> {\n    return Promise.reject(unsupported(\"playerQueue\"));\n  },\n  playerGetPlayerState(): Promise<never> {\n    return Promise.reject(unsupported(\"playerGetPlayerState\"));\n  },\n  playerGetCrossfadeState(): Promise<never> {\n    return Promise.reject(unsupported(\"playerGetCrossfadeState\"));\n  },\n  userGetCapabilities(): Promise<never> {\n    return Promise.reject(unsupported(\"userGetCapabilities\"));\n  },\n  userGetLibraryState(): Promise<never> {\n    return Promise.reject(unsupported(\"userGetLibraryState\"));\n  },\n  userAddToLibrary(): Promise<never> {\n    return Promise.reject(unsupported(\"userAddToLibrary\"));\n  },\n  userRemoveFromLibrary(): Promise<never> {\n    return Promise.reject(unsupported(\"userRemoveFromLibrary\"));\n  },\n  contentGetRecommendedContentItems(): Promise<never> {\n    return Promise.reject(unsupported(\"contentGetRecommendedContentItems\"));\n  },\n  contentGetChildren(): Promise<never> {\n    return Promise.reject(unsupported(\"contentGetChildren\"));\n  },\n  imagesLoad(): Promise<never> {\n    return Promise.reject(unsupported(\"imagesLoad\"));\n  },\n  addListener(): { remove(): void } {\n    return { remove() {} };\n  },\n  removeListeners(): void {\n    /* no-op */\n  },\n};\n"]}

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

@@ -0,0 +1,8 @@
+import { SpotifyError } from "../error";
+export type AppRemoteErrorCode = "CONNECTION_FAILED" | "CONNECTION_LOST" | "NOT_CONNECTED" | "UNKNOWN";
+export declare class AppRemoteError extends SpotifyError {
+    readonly namespace: "AppRemote";
+    readonly code: AppRemoteErrorCode;
+    constructor(code: AppRemoteErrorCode, message: string);
+}
+//# sourceMappingURL=error.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../../src/app-remote/error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAExC,MAAM,MAAM,kBAAkB,GAC1B,mBAAmB,GACnB,iBAAiB,GACjB,eAAe,GACf,SAAS,CAAC;AAEd,qBAAa,cAAe,SAAQ,YAAY;IAC9C,QAAQ,CAAC,SAAS,EAAG,WAAW,CAAU;IAC1C,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;gBAEtB,IAAI,EAAE,kBAAkB,EAAE,OAAO,EAAE,MAAM;CAItD"}

package/build/app-remote/error.js

@@ -0,0 +1,10 @@
+import { SpotifyError } from "../error";
+export class AppRemoteError extends SpotifyError {
+    namespace = "AppRemote";
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+    }
+}
+//# sourceMappingURL=error.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"error.js","sourceRoot":"","sources":["../../src/app-remote/error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAQxC,MAAM,OAAO,cAAe,SAAQ,YAAY;IACrC,SAAS,GAAG,WAAoB,CAAC;IACjC,IAAI,CAAqB;IAElC,YAAY,IAAwB,EAAE,OAAe;QACnD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF","sourcesContent":["import { SpotifyError } from \"../error\";\n\nexport type AppRemoteErrorCode =\n  | \"CONNECTION_FAILED\"\n  | \"CONNECTION_LOST\"\n  | \"NOT_CONNECTED\"\n  | \"UNKNOWN\";\n\nexport class AppRemoteError extends SpotifyError {\n  readonly namespace = \"AppRemote\" as const;\n  readonly code: AppRemoteErrorCode;\n\n  constructor(code: AppRemoteErrorCode, message: string) {\n    super(message);\n    this.code = code;\n  }\n}\n"]}

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

@@ -0,0 +1,79 @@
+import { EventSubscription } from "expo-modules-core";
+import { AppRemoteErrorCode } from "./error";
+export type { AppRemoteErrorCode } from "./error";
+export { AppRemoteError } from "./error";
+/** Current state of the IPC connection to the Spotify app. */
+export type ConnectionState = "disconnected" | "connecting" | "connected";
+/** Payload of the `connectionStateChange` event. */
+export interface ConnectionStateChangeEvent {
+    state: ConnectionState;
+}
+/** Payload of the `connectionError` event. */
+export interface ConnectionErrorEvent {
+    code: AppRemoteErrorCode;
+    message: string;
+}
+/**
+ * Spotify App Remote namespace. Manages the IPC connection to the running
+ * Spotify app. All `Player`, `User`, `Content`, and `Images` calls require an
+ * active connection established via `AppRemote.connect()`.
+ *
+ * @example
+ * ```ts
+ * import { AppRemote } from "@wwdrew/expo-spotify-sdk";
+ *
+ * // Connect using the access token from Auth.authenticate()
+ * await AppRemote.connect(session.accessToken);
+ *
+ * const sub = AppRemote.addListener("connectionStateChange", ({ state }) => {
+ *   console.log("connection state:", state);
+ * });
+ *
+ * // later:
+ * await AppRemote.disconnect();
+ * sub.remove();
+ * ```
+ */
+export declare const AppRemote: {
+    /**
+     * Opens a connection to the running Spotify app using the provided access
+     * token. Resolves when the connection is established; rejects with an
+     * {@link AppRemoteError} if the connection fails.
+     *
+     * **Android note:** The access token is accepted for API parity with iOS but
+     * the Android App Remote SDK does not accept it directly — it uses the
+     * session cached in the Spotify app from your earlier `Auth.authenticate()`
+     * call. Ensure `Auth.authenticate()` has succeeded before calling `connect()`.
+     *
+     * Calling `connect()` while already connected is a no-op.
+     */
+    readonly connect: (accessToken: string) => Promise<void>;
+    /**
+     * Disconnects from the Spotify app. Safe to call when already disconnected.
+     * Resolves once the disconnection is complete.
+     */
+    readonly disconnect: () => Promise<void>;
+    /**
+     * Returns `true` if currently connected to the Spotify app.
+     * This is a synchronous snapshot — subscribe to `"connectionStateChange"`
+     * for reactive updates.
+     */
+    readonly isConnected: () => boolean;
+    /**
+     * Returns the current {@link ConnectionState} synchronously.
+     * Subscribe to `"connectionStateChange"` for reactive updates.
+     */
+    readonly getConnectionState: () => Promise<ConnectionState>;
+    /**
+     * Subscribes to connection lifecycle events.
+     *
+     * | Event | Payload | When |
+     * |---|---|---|
+     * | `"connectionStateChange"` | `{ state: ConnectionState }` | State transitions |
+     * | `"connectionError"` | `{ code, message }` | Connection failures and drops |
+     *
+     * Returns a `Subscription` — call `.remove()` to unsubscribe.
+     */
+    readonly addListener: <E extends "connectionStateChange" | "connectionError">(event: E, listener: E extends "connectionStateChange" ? (event: ConnectionStateChangeEvent) => void : (event: ConnectionErrorEvent) => void) => EventSubscription;
+};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/app-remote/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAGtD,OAAO,EAAkB,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAE7D,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"}

package/build/app-remote/index.js

@@ -0,0 +1,110 @@
+import ExpoSpotifySDKModule from "../ExpoSpotifySDKModule";
+import { AppRemoteError } from "./error";
+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));
+}
+// ---------------------------------------------------------------------------
+// AppRemote namespace
+// ---------------------------------------------------------------------------
+/**
+ * Spotify App Remote namespace. Manages the IPC connection to the running
+ * Spotify app. All `Player`, `User`, `Content`, and `Images` calls require an
+ * active connection established via `AppRemote.connect()`.
+ *
+ * @example
+ * ```ts
+ * import { AppRemote } from "@wwdrew/expo-spotify-sdk";
+ *
+ * // Connect using the access token from Auth.authenticate()
+ * await AppRemote.connect(session.accessToken);
+ *
+ * const sub = AppRemote.addListener("connectionStateChange", ({ state }) => {
+ *   console.log("connection state:", state);
+ * });
+ *
+ * // later:
+ * await AppRemote.disconnect();
+ * sub.remove();
+ * ```
+ */
+export const AppRemote = {
+    /**
+     * Opens a connection to the running Spotify app using the provided access
+     * token. Resolves when the connection is established; rejects with an
+     * {@link AppRemoteError} if the connection fails.
+     *
+     * **Android note:** The access token is accepted for API parity with iOS but
+     * the Android App Remote SDK does not accept it directly — it uses the
+     * session cached in the Spotify app from your earlier `Auth.authenticate()`
+     * call. Ensure `Auth.authenticate()` has succeeded before calling `connect()`.
+     *
+     * Calling `connect()` while already connected is a no-op.
+     */
+    connect(accessToken) {
+        return ExpoSpotifySDKModule.appRemoteConnect(accessToken).catch(rethrowAsAppRemoteError);
+    },
+    /**
+     * Disconnects from the Spotify app. Safe to call when already disconnected.
+     * Resolves once the disconnection is complete.
+     */
+    disconnect() {
+        return ExpoSpotifySDKModule.appRemoteDisconnect();
+    },
+    /**
+     * Returns `true` if currently connected to the Spotify app.
+     * This is a synchronous snapshot — subscribe to `"connectionStateChange"`
+     * for reactive updates.
+     */
+    isConnected() {
+        return ExpoSpotifySDKModule.appRemoteIsConnected();
+    },
+    /**
+     * Returns the current {@link ConnectionState} synchronously.
+     * Subscribe to `"connectionStateChange"` for reactive updates.
+     */
+    getConnectionState() {
+        return ExpoSpotifySDKModule.appRemoteGetConnectionState();
+    },
+    /**
+     * Subscribes to connection lifecycle events.
+     *
+     * | Event | Payload | When |
+     * |---|---|---|
+     * | `"connectionStateChange"` | `{ state: ConnectionState }` | State transitions |
+     * | `"connectionError"` | `{ code, message }` | Connection failures and drops |
+     *
+     * Returns a `Subscription` — call `.remove()` to unsubscribe.
+     */
+    addListener(event, listener) {
+        const nativeEvent = event === "connectionStateChange"
+            ? "onConnectionStateChange"
+            : "onConnectionError";
+        return ExpoSpotifySDKModule.addListener(nativeEvent, listener);
+    },
+};
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +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,EAAsB,MAAM,SAAS,CAAC;AAG7D,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 { EventSubscription } from \"expo-modules-core\";\n\nimport ExpoSpotifySDKModule from \"../ExpoSpotifySDKModule\";\nimport { AppRemoteError, 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"]}

package/build/auth/error.d.ts

@@ -0,0 +1,8 @@
+import { SpotifyError } from "../error";
+export type AuthErrorCode = "USER_CANCELLED" | "AUTH_IN_PROGRESS" | "INVALID_CONFIG" | "NETWORK_ERROR" | "TOKEN_SWAP_FAILED" | "TOKEN_SWAP_PARSE_ERROR" | "SPOTIFY_NOT_INSTALLED" | "AUTH_ERROR" | "UNKNOWN";
+export declare class AuthError extends SpotifyError {
+    readonly namespace: "Auth";
+    readonly code: AuthErrorCode;
+    constructor(code: AuthErrorCode, message: string);
+}
+//# sourceMappingURL=error.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../../src/auth/error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAExC,MAAM,MAAM,aAAa,GACrB,gBAAgB,GAChB,kBAAkB,GAClB,gBAAgB,GAChB,eAAe,GACf,mBAAmB,GACnB,wBAAwB,GACxB,uBAAuB,GACvB,YAAY,GACZ,SAAS,CAAC;AAEd,qBAAa,SAAU,SAAQ,YAAY;IACzC,QAAQ,CAAC,SAAS,EAAG,MAAM,CAAU;IACrC,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;gBAEjB,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM;CAIjD"}

package/build/auth/error.js

@@ -0,0 +1,10 @@
+import { SpotifyError } from "../error";
+export class AuthError extends SpotifyError {
+    namespace = "Auth";
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+    }
+}
+//# sourceMappingURL=error.js.map

package/build/auth/error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.js","sourceRoot":"","sources":["../../src/auth/error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAaxC,MAAM,OAAO,SAAU,SAAQ,YAAY;IAChC,SAAS,GAAG,MAAe,CAAC;IAC5B,IAAI,CAAgB;IAE7B,YAAY,IAAmB,EAAE,OAAe;QAC9C,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF","sourcesContent":["import { SpotifyError } from \"../error\";\n\nexport type AuthErrorCode =\n  | \"USER_CANCELLED\"\n  | \"AUTH_IN_PROGRESS\"\n  | \"INVALID_CONFIG\"\n  | \"NETWORK_ERROR\"\n  | \"TOKEN_SWAP_FAILED\"\n  | \"TOKEN_SWAP_PARSE_ERROR\"\n  | \"SPOTIFY_NOT_INSTALLED\"\n  | \"AUTH_ERROR\"\n  | \"UNKNOWN\";\n\nexport class AuthError extends SpotifyError {\n  readonly namespace = \"Auth\" as const;\n  readonly code: AuthErrorCode;\n\n  constructor(code: AuthErrorCode, message: string) {\n    super(message);\n    this.code = code;\n  }\n}\n"]}

package/build/auth/index.d.ts

@@ -0,0 +1,124 @@
+import { EventSubscription } from "expo-modules-core";
+import { AuthErrorCode } from "./error";
+export type { AuthErrorCode } from "./error";
+export { AuthError } from "./error";
+export interface SpotifySession {
+    /** OAuth access token. */
+    accessToken: string;
+    /**
+     * OAuth refresh token. `null` on Android when no `tokenSwapURL` is provided
+     * (the Spotify Android SDK does not expose a refresh token for implicit
+     * grants).
+     */
+    refreshToken: string | null;
+    /** Expiration timestamp as Unix epoch milliseconds. */
+    expirationDate: number;
+    /** Scopes the access token was granted (or requested, on Android implicit). */
+    scopes: SpotifyScope[];
+}
+export type SpotifyScope = "ugc-image-upload" | "user-read-playback-state" | "user-modify-playback-state" | "user-read-currently-playing" | "app-remote-control" | "streaming" | "playlist-read-private" | "playlist-read-collaborative" | "playlist-modify-private" | "playlist-modify-public" | "user-follow-modify" | "user-follow-read" | "user-top-read" | "user-read-recently-played" | "user-library-modify" | "user-library-read" | "user-read-email" | "user-read-private";
+export interface AuthenticateConfig {
+    /** OAuth scopes to request. Must contain at least one entry. */
+    scopes: SpotifyScope[];
+    /**
+     * If supplied, requests an authorization code rather than an implicit
+     * token, then POSTs the code to this URL to exchange it for tokens.
+     * **Required on Android** to receive a usable `refreshToken`.
+     */
+    tokenSwapURL?: string;
+    /**
+     * Used by the iOS SDK to refresh access tokens automatically, and by
+     * `Auth.refresh()` on both platforms.
+     */
+    tokenRefreshURL?: string;
+    /**
+     * If `true`, forces Spotify to show the authorization dialog even when the
+     * user already has an active session. Defaults to `false`.
+     */
+    showDialog?: boolean;
+}
+export interface RefreshConfig {
+    /** The refresh token from a previous `Auth.authenticate()` call. */
+    refreshToken: string;
+    /** URL of your token refresh server endpoint. */
+    tokenRefreshURL: string;
+    /**
+     * Scopes that were granted by the previous session. Used as a fallback when
+     * the refresh response omits the `scope` field.
+     */
+    scopes?: SpotifyScope[];
+}
+/**
+ * Payload delivered to `Auth.addListener("sessionChange", ...)` subscribers.
+ */
+export type SessionChangeEvent = {
+    type: "didInitiate";
+    session: SpotifySession;
+} | {
+    type: "didRenew";
+    session: SpotifySession;
+} | {
+    type: "didFail";
+    error: {
+        code: AuthErrorCode;
+        message: string;
+    };
+};
+/**
+ * Spotify Auth namespace. Handles OAuth authentication and session lifecycle.
+ *
+ * @example
+ * ```ts
+ * import { Auth } from "@wwdrew/expo-spotify-sdk";
+ *
+ * const session = await Auth.authenticate({ scopes: ["streaming"] });
+ * ```
+ */
+export declare const Auth: {
+    /**
+     * Returns `true` if the Spotify app is installed on the device.
+     */
+    readonly isAvailable: () => boolean;
+    /**
+     * Starts a Spotify OAuth flow. Resolves with a {@link SpotifySession};
+     * rejects with an {@link AuthError} carrying a `code`.
+     */
+    readonly authenticate: (config: AuthenticateConfig) => Promise<SpotifySession>;
+    /**
+     * Exchanges a refresh token for a new access token via your token refresh
+     * server. Resolves with a fresh {@link SpotifySession}; rejects with an
+     * {@link AuthError}.
+     */
+    readonly refresh: (config: RefreshConfig) => Promise<SpotifySession>;
+    /**
+     * Forcibly cancel any in-flight `Auth.authenticate()` call. No-op on
+     * Android (the Android coordinator self-cleans via structured concurrency).
+     *
+     * Use before `Auth.authenticate()` to defensively clear any leaked iOS
+     * coordinator state (the `SPTSessionManager` delegate callbacks are not
+     * guaranteed to fire).
+     */
+    readonly cancelPending: () => Promise<void>;
+    /**
+     * Subscribes to session lifecycle events.
+     *
+     * Events fire for every `Auth.authenticate()` and `Auth.refresh()` call,
+     * regardless of whether the call was awaited. Useful for persisting tokens
+     * in a central store without coupling the store to the call sites.
+     *
+     * Returns a `Subscription` — call `.remove()` to unsubscribe.
+     *
+     * @example
+     * ```ts
+     * const sub = Auth.addListener("sessionChange", (event) => {
+     *   if (event.type === "didInitiate" || event.type === "didRenew") {
+     *     store.setSession(event.session);
+     *   }
+     * });
+     * // later:
+     * sub.remove();
+     * ```
+     */
+    readonly addListener: (event: "sessionChange", listener: (event: SessionChangeEvent) => void) => EventSubscription;
+};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/auth/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAY,MAAM,mBAAmB,CAAC;AAGhE,OAAO,EAAa,aAAa,EAAE,MAAM,SAAS,CAAC;AAEnD,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"}