@wwdrew/expo-spotify-sdk 0.5.0 → 0.7.0

package/build/ExpoSpotifySDK.types.d.ts

@@ -1,13 +1,96 @@
+/**
+ * Result of a successful Spotify authentication.
+ *
+ * The shape is identical across iOS and Android. On the Android implicit
+ * (TOKEN) flow `refreshToken` is `null` and `scopes` reflects what was
+ * *requested*, not granted — see the README's "Android implicit flow is not
+ * recommended" section.
+ */
 export interface SpotifySession {
+    /** OAuth access token. */
     accessToken: string;
-    refreshToken: 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 — see the README).
+     */
+    refreshToken: string | null;
+    /** Expiration timestamp as Unix epoch milliseconds. */
     expirationDate: number;
+    /** Scopes the access token was granted (or requested, on Android implicit). */
     scopes: SpotifyScope[];
 }
+/**
+ * Configuration accepted by `refreshSessionAsync`.
+ */
+export interface SpotifyRefreshConfig {
+    /** The refresh token from a previous `authenticateAsync` call. */
+    refreshToken: string;
+    /** URL of your token refresh server endpoint. */
+    tokenRefreshURL: string;
+}
+/**
+ * Configuration accepted by `authenticateAsync`.
+ */
 export interface SpotifyConfig {
+    /** 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
+     * `refreshSessionAsync` 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`.
+     *
+     * Maps to `SPTSessionManager.alwaysShowAuthorizationDialog` on iOS and
+     * `AuthorizationRequest.Builder.setShowDialog(true)` on Android.
+     */
+    showDialog?: boolean;
 }
+/**
+ * Spotify OAuth scope identifiers that are valid through the iOS, Android
+ * and Web auth flows. See https://developer.spotify.com/documentation/web-api/concepts/scopes
+ */
 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";
+/**
+ * JS-side error code constants thrown via `Promise.reject(new Error(...))`
+ * by the native modules.
+ */
+export type SpotifyErrorCode = "USER_CANCELLED" | "AUTH_IN_PROGRESS" | "INVALID_CONFIG" | "NETWORK_ERROR" | "TOKEN_SWAP_FAILED" | "TOKEN_SWAP_PARSE_ERROR" | "SPOTIFY_NOT_INSTALLED" | "AUTH_ERROR" | "UNKNOWN";
+/**
+ * Payload delivered to `addSessionChangeListener` subscribers.
+ *
+ * - `didInitiate` — a new session was created by `authenticateAsync`
+ * - `didRenew`    — an existing session was refreshed by `refreshSessionAsync`
+ * - `didFail`     — an auth or refresh attempt failed
+ */
+export type SpotifySessionChangeEvent = {
+    type: "didInitiate";
+    session: SpotifySession;
+} | {
+    type: "didRenew";
+    session: SpotifySession;
+} | {
+    type: "didFail";
+    error: {
+        code: SpotifyErrorCode;
+        message: string;
+    };
+};
+/**
+ * Error subclass thrown by `authenticateAsync` and `refreshSessionAsync`
+ * carrying a structured `code` field for branching.
+ */
+export declare class SpotifyError extends Error {
+    readonly code: SpotifyErrorCode;
+    constructor(code: SpotifyErrorCode, message: string);
+}
 //# sourceMappingURL=ExpoSpotifySDK.types.d.ts.map

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,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,YAAY,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAMD,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"}
+{"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"}

package/build/ExpoSpotifySDK.types.js

@@ -1,2 +1,13 @@
-export {};
+/**
+ * Error subclass thrown by `authenticateAsync` and `refreshSessionAsync`
+ * carrying a structured `code` field for branching.
+ */
+export class SpotifyError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.name = "SpotifyError";
+        this.code = code;
+    }
+}
 //# sourceMappingURL=ExpoSpotifySDK.types.js.map

package/build/ExpoSpotifySDK.types.js.map

@@ -1 +1 @@
-{"version":3,"file":"ExpoSpotifySDK.types.js","sourceRoot":"","sources":["../src/ExpoSpotifySDK.types.ts"],"names":[],"mappings":"","sourcesContent":["export interface SpotifySession {\n  accessToken: string;\n  refreshToken: string;\n  expirationDate: number;\n  scopes: SpotifyScope[];\n}\n\nexport interface SpotifyConfig {\n  scopes: SpotifyScope[];\n  tokenSwapURL?: string;\n  tokenRefreshURL?: string;\n}\n\n// export interface AndroidSpotifyConfig extends SpotifyConfig {\n//   responseType: \"token\" | \"code\";\n// }\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"]}
+{"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"]}

package/build/ExpoSpotifySDKModule.web.d.ts

@@ -1,7 +1,11 @@
 declare const _default: {
-    PI: number;
-    setValueAsync(value: string): Promise<void>;
-    hello(): string;
+    isAvailable(): boolean;
+    authenticateAsync(): Promise<never>;
+    refreshSessionAsync(): Promise<never>;
+    addListener(): {
+        remove(): void;
+    };
+    removeListeners(): void;
 };
 export default _default;
 //# sourceMappingURL=ExpoSpotifySDKModule.web.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"ExpoSpotifySDKModule.web.d.ts","sourceRoot":"","sources":["../src/ExpoSpotifySDKModule.web.ts"],"names":[],"mappings":";;yBAM6B,MAAM,GAAG,QAAQ,IAAI,CAAC;;;AAFnD,wBAQE"}
+{"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"}

package/build/ExpoSpotifySDKModule.web.js

@@ -1,12 +1,22 @@
-import { EventEmitter } from "expo-modules-core";
-const emitter = new EventEmitter({});
+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).`);
+}
 export default {
-    PI: Math.PI,
-    async setValueAsync(value) {
-        emitter.emit("onChange", { value });
+    isAvailable() {
+        return false;
     },
-    hello() {
-        return "Hello world! 👋";
+    authenticateAsync() {
+        return Promise.reject(notImplementedReject("authenticateAsync"));
+    },
+    refreshSessionAsync() {
+        return Promise.reject(notImplementedReject("refreshSessionAsync"));
+    },
+    addListener() {
+        return { remove() { } };
+    },
+    removeListeners() {
+        /* no-op */
     },
 };
 //# sourceMappingURL=ExpoSpotifySDKModule.web.js.map

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,mBAAmB,CAAC;AAEjD,MAAM,OAAO,GAAG,IAAI,YAAY,CAAC,EAAS,CAAC,CAAC;AAE5C,eAAe;IACb,EAAE,EAAE,IAAI,CAAC,EAAE;IACX,KAAK,CAAC,aAAa,CAAC,KAAa;QAC/B,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;IACtC,CAAC;IACD,KAAK;QACH,OAAO,iBAAiB,CAAC;IAC3B,CAAC;CACF,CAAC","sourcesContent":["import { EventEmitter } from \"expo-modules-core\";\n\nconst emitter = new EventEmitter({} as any);\n\nexport default {\n  PI: Math.PI,\n  async setValueAsync(value: string): Promise<void> {\n    emitter.emit(\"onChange\", { value });\n  },\n  hello() {\n    return \"Hello world! 👋\";\n  },\n};\n"]}
+{"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"]}

package/build/index.d.ts

@@ -1,8 +1,45 @@
-import { SpotifyConfig, SpotifySession } from "./ExpoSpotifySDK.types";
+import { EventSubscription } from "expo-modules-core";
+import { SpotifyConfig, SpotifyError, SpotifyRefreshConfig, SpotifySession, SpotifySessionChangeEvent } from "./ExpoSpotifySDK.types";
+/**
+ * Returns `true` if the Spotify app is installed on the device.
+ * Always returns `false` on web.
+ */
 declare function isAvailable(): boolean;
+/**
+ * Starts a Spotify OAuth flow. Resolves with a {@link SpotifySession};
+ * rejects with a {@link SpotifyError} carrying a `code`.
+ */
 declare function authenticateAsync(config: SpotifyConfig): Promise<SpotifySession>;
+/**
+ * Exchanges a refresh token for a new access token via your token refresh
+ * server. Resolves with a fresh {@link SpotifySession}; rejects with a
+ * {@link SpotifyError}.
+ */
+declare function refreshSessionAsync(config: SpotifyRefreshConfig): Promise<SpotifySession>;
+/**
+ * Subscribes to session lifecycle events emitted by the native module.
+ *
+ * Events are fired for every `authenticateAsync` and `refreshSessionAsync`
+ * 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 {@link Subscription} — call `.remove()` to unsubscribe.
+ *
+ * @example
+ * ```ts
+ * const sub = addSessionChangeListener((event) => {
+ *   if (event.type === "didInitiate" || event.type === "didRenew") {
+ *     store.setSession(event.session);
+ *   }
+ * });
+ * // later:
+ * sub.remove();
+ * ```
+ */
+declare function addSessionChangeListener(listener: (event: SpotifySessionChangeEvent) => void): EventSubscription;
 declare const Authenticate: {
     authenticateAsync: typeof authenticateAsync;
 };
-export { isAvailable, Authenticate };
+export { isAvailable, authenticateAsync, refreshSessionAsync, addSessionChangeListener, Authenticate, SpotifyError, };
+export type { SpotifyConfig, SpotifyRefreshConfig, SpotifySession, SpotifySessionChangeEvent, SpotifyErrorCode, SpotifyScope, } from "./ExpoSpotifySDK.types";
 //# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAGvE,iBAAS,WAAW,IAAI,OAAO,CAE9B;AAED,iBAAS,iBAAiB,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC,CAMzE;AAED,QAAA,MAAM,YAAY;;CAEjB,CAAC;AAEF,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAY,MAAM,mBAAmB,CAAC;AAEhE,OAAO,EACL,aAAa,EACb,YAAY,EAEZ,oBAAoB,EACpB,cAAc,EACd,yBAAyB,EAC1B,MAAM,wBAAwB,CAAC;AAWhC;;;GAGG;AACH,iBAAS,WAAW,IAAI,OAAO,CAE9B;AAED;;;GAGG;AACH,iBAAS,iBAAiB,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC,CAqBzE;AAgCD;;;;GAIG;AACH,iBAAS,mBAAmB,CAC1B,MAAM,EAAE,oBAAoB,GAC3B,OAAO,CAAC,cAAc,CAAC,CAczB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,iBAAS,wBAAwB,CAC/B,QAAQ,EAAE,CAAC,KAAK,EAAE,yBAAyB,KAAK,IAAI,GACnD,iBAAiB,CAKnB;AAgCD,QAAA,MAAM,YAAY;;CAEjB,CAAC;AAEF,OAAO,EACL,WAAW,EACX,iBAAiB,EACjB,mBAAmB,EACnB,wBAAwB,EACxB,YAAY,EACZ,YAAY,GACb,CAAC;AACF,YAAY,EACV,aAAa,EACb,oBAAoB,EACpB,cAAc,EACd,yBAAyB,EACzB,gBAAgB,EAChB,YAAY,GACb,MAAM,wBAAwB,CAAC"}

package/build/index.js

@@ -1,15 +1,128 @@
+import { Platform } from "expo-modules-core";
+import { SpotifyError, } from "./ExpoSpotifySDK.types";
 import ExpoSpotifySDKModule from "./ExpoSpotifySDKModule";
+const ANDROID_TOKEN_FLOW_WARNING = "[expo-spotify-sdk] You are using authenticateAsync on Android without a " +
+    "tokenSwapURL. The Spotify Android SDK does NOT return a refresh token or " +
+    "the actual granted scopes through this path; see the README's " +
+    "'Android implicit (TOKEN) flow is not recommended' section.";
+let warnedAboutAndroidTokenFlow = false;
+/**
+ * Returns `true` if the Spotify app is installed on the device.
+ * Always returns `false` on web.
+ */
 function isAvailable() {
     return ExpoSpotifySDKModule.isAvailable();
 }
+/**
+ * Starts a Spotify OAuth flow. Resolves with a {@link SpotifySession};
+ * rejects with a {@link SpotifyError} carrying a `code`.
+ */
 function authenticateAsync(config) {
-    if (!config.scopes || config.scopes?.length === 0) {
-        throw new Error("scopes are required");
+    if (!config.scopes || config.scopes.length === 0) {
+        return Promise.reject(new SpotifyError("INVALID_CONFIG", "scopes must contain at least one entry"));
     }
-    return ExpoSpotifySDKModule.authenticateAsync(config);
+    if (Platform.OS === "android" &&
+        !config.tokenSwapURL &&
+        !warnedAboutAndroidTokenFlow) {
+        warnedAboutAndroidTokenFlow = true;
+        console.warn(ANDROID_TOKEN_FLOW_WARNING);
+    }
+    return ExpoSpotifySDKModule.authenticateAsync(config)
+        .then(normaliseSession)
+        .catch(rethrowAsSpotifyError);
+}
+function normaliseSession(raw) {
+    if (!raw || typeof raw !== "object") {
+        throw new SpotifyError("UNKNOWN", "Native module returned a non-object session");
+    }
+    const r = raw;
+    const accessToken = r.accessToken;
+    if (typeof accessToken !== "string" || accessToken.length === 0) {
+        throw new SpotifyError("UNKNOWN", "Session is missing accessToken");
+    }
+    const expirationDate = r.expirationDate;
+    if (typeof expirationDate !== "number") {
+        throw new SpotifyError("UNKNOWN", "Session is missing expirationDate");
+    }
+    const refreshTokenRaw = r.refreshToken;
+    const refreshToken = typeof refreshTokenRaw === "string" && refreshTokenRaw.length > 0
+        ? refreshTokenRaw
+        : null;
+    const scopesRaw = r.scopes;
+    const scopes = Array.isArray(scopesRaw)
+        ? scopesRaw.filter((s) => typeof s === "string")
+        : [];
+    return { accessToken, refreshToken, expirationDate, scopes };
+}
+/**
+ * Exchanges a refresh token for a new access token via your token refresh
+ * server. Resolves with a fresh {@link SpotifySession}; rejects with a
+ * {@link SpotifyError}.
+ */
+function refreshSessionAsync(config) {
+    if (!config.refreshToken) {
+        return Promise.reject(new SpotifyError("INVALID_CONFIG", "refreshToken is required"));
+    }
+    if (!config.tokenRefreshURL) {
+        return Promise.reject(new SpotifyError("INVALID_CONFIG", "tokenRefreshURL is required"));
+    }
+    return ExpoSpotifySDKModule.refreshSessionAsync(config)
+        .then(normaliseSession)
+        .catch(rethrowAsSpotifyError);
+}
+/**
+ * Subscribes to session lifecycle events emitted by the native module.
+ *
+ * Events are fired for every `authenticateAsync` and `refreshSessionAsync`
+ * 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 {@link Subscription} — call `.remove()` to unsubscribe.
+ *
+ * @example
+ * ```ts
+ * const sub = addSessionChangeListener((event) => {
+ *   if (event.type === "didInitiate" || event.type === "didRenew") {
+ *     store.setSession(event.session);
+ *   }
+ * });
+ * // later:
+ * sub.remove();
+ * ```
+ */
+function addSessionChangeListener(listener) {
+    return ExpoSpotifySDKModule.addListener("onSessionChange", listener);
+}
+const ERROR_PREFIX_RE = /^([A-Z_][A-Z0-9_]*):\s*(.*)$/s;
+const VALID_CODES = new Set([
+    "USER_CANCELLED",
+    "AUTH_IN_PROGRESS",
+    "INVALID_CONFIG",
+    "NETWORK_ERROR",
+    "TOKEN_SWAP_FAILED",
+    "TOKEN_SWAP_PARSE_ERROR",
+    "SPOTIFY_NOT_INSTALLED",
+    "AUTH_ERROR",
+    "UNKNOWN",
+]);
+function rethrowAsSpotifyError(err) {
+    if (err instanceof SpotifyError)
+        throw err;
+    if (err instanceof Error) {
+        const m = err.message.match(ERROR_PREFIX_RE);
+        if (m && VALID_CODES.has(m[1])) {
+            throw new SpotifyError(m[1], m[2]);
+        }
+        const maybeCode = err.code;
+        if (maybeCode && VALID_CODES.has(maybeCode)) {
+            throw new SpotifyError(maybeCode, err.message);
+        }
+        throw new SpotifyError("UNKNOWN", err.message);
+    }
+    throw new SpotifyError("UNKNOWN", String(err));
 }
 const Authenticate = {
     authenticateAsync,
 };
-export { isAvailable, Authenticate };
+export { isAvailable, authenticateAsync, refreshSessionAsync, addSessionChangeListener, Authenticate, SpotifyError, };
 //# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,oBAAoB,MAAM,wBAAwB,CAAC;AAE1D,SAAS,WAAW;IAClB,OAAO,oBAAoB,CAAC,WAAW,EAAE,CAAC;AAC5C,CAAC;AAED,SAAS,iBAAiB,CAAC,MAAqB;IAC9C,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,KAAK,CAAC,EAAE,CAAC;QAClD,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;IACzC,CAAC;IAED,OAAO,oBAAoB,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC;AACxD,CAAC;AAED,MAAM,YAAY,GAAG;IACnB,iBAAiB;CAClB,CAAC;AAEF,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,CAAC","sourcesContent":["import { SpotifyConfig, SpotifySession } from \"./ExpoSpotifySDK.types\";\nimport ExpoSpotifySDKModule from \"./ExpoSpotifySDKModule\";\n\nfunction isAvailable(): boolean {\n  return ExpoSpotifySDKModule.isAvailable();\n}\n\nfunction authenticateAsync(config: SpotifyConfig): Promise<SpotifySession> {\n  if (!config.scopes || config.scopes?.length === 0) {\n    throw new Error(\"scopes are required\");\n  }\n\n  return ExpoSpotifySDKModule.authenticateAsync(config);\n}\n\nconst Authenticate = {\n  authenticateAsync,\n};\n\nexport { isAvailable, Authenticate };\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAEhE,OAAO,EAEL,YAAY,GAKb,MAAM,wBAAwB,CAAC;AAChC,OAAO,oBAAoB,MAAM,wBAAwB,CAAC;AAE1D,MAAM,0BAA0B,GAC9B,0EAA0E;IAC1E,2EAA2E;IAC3E,gEAAgE;IAChE,6DAA6D,CAAC;AAEhE,IAAI,2BAA2B,GAAG,KAAK,CAAC;AAExC;;;GAGG;AACH,SAAS,WAAW;IAClB,OAAO,oBAAoB,CAAC,WAAW,EAAE,CAAC;AAC5C,CAAC;AAED;;;GAGG;AACH,SAAS,iBAAiB,CAAC,MAAqB;IAC9C,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjD,OAAO,OAAO,CAAC,MAAM,CACnB,IAAI,YAAY,CACd,gBAAgB,EAChB,wCAAwC,CACzC,CACF,CAAC;IACJ,CAAC;IACD,IACE,QAAQ,CAAC,EAAE,KAAK,SAAS;QACzB,CAAC,MAAM,CAAC,YAAY;QACpB,CAAC,2BAA2B,EAC5B,CAAC;QACD,2BAA2B,GAAG,IAAI,CAAC;QAEnC,OAAO,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;IAC3C,CAAC;IACD,OAAO,oBAAoB,CAAC,iBAAiB,CAAC,MAAM,CAAC;SAClD,IAAI,CAAC,gBAAgB,CAAC;SACtB,KAAK,CAAC,qBAAqB,CAAC,CAAC;AAClC,CAAC;AAED,SAAS,gBAAgB,CAAC,GAAY;IACpC,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QACpC,MAAM,IAAI,YAAY,CACpB,SAAS,EACT,6CAA6C,CAC9C,CAAC;IACJ,CAAC;IACD,MAAM,CAAC,GAAG,GAA8B,CAAC;IACzC,MAAM,WAAW,GAAG,CAAC,CAAC,WAAW,CAAC;IAClC,IAAI,OAAO,WAAW,KAAK,QAAQ,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAChE,MAAM,IAAI,YAAY,CAAC,SAAS,EAAE,gCAAgC,CAAC,CAAC;IACtE,CAAC;IACD,MAAM,cAAc,GAAG,CAAC,CAAC,cAAc,CAAC;IACxC,IAAI,OAAO,cAAc,KAAK,QAAQ,EAAE,CAAC;QACvC,MAAM,IAAI,YAAY,CAAC,SAAS,EAAE,mCAAmC,CAAC,CAAC;IACzE,CAAC;IACD,MAAM,eAAe,GAAG,CAAC,CAAC,YAAY,CAAC;IACvC,MAAM,YAAY,GAChB,OAAO,eAAe,KAAK,QAAQ,IAAI,eAAe,CAAC,MAAM,GAAG,CAAC;QAC/D,CAAC,CAAC,eAAe;QACjB,CAAC,CAAC,IAAI,CAAC;IACX,MAAM,SAAS,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3B,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC;QACrC,CAAC,CAAE,SAAS,CAAC,MAAM,CACf,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CACA;QAChC,CAAC,CAAC,EAAE,CAAC;IACP,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,EAAE,CAAC;AAC/D,CAAC;AAED;;;;GAIG;AACH,SAAS,mBAAmB,CAC1B,MAA4B;IAE5B,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC;QACzB,OAAO,OAAO,CAAC,MAAM,CACnB,IAAI,YAAY,CAAC,gBAAgB,EAAE,0BAA0B,CAAC,CAC/D,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,eAAe,EAAE,CAAC;QAC5B,OAAO,OAAO,CAAC,MAAM,CACnB,IAAI,YAAY,CAAC,gBAAgB,EAAE,6BAA6B,CAAC,CAClE,CAAC;IACJ,CAAC;IACD,OAAO,oBAAoB,CAAC,mBAAmB,CAAC,MAAM,CAAC;SACpD,IAAI,CAAC,gBAAgB,CAAC;SACtB,KAAK,CAAC,qBAAqB,CAAC,CAAC;AAClC,CAAC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,SAAS,wBAAwB,CAC/B,QAAoD;IAEpD,OAAO,oBAAoB,CAAC,WAAW,CACrC,iBAAiB,EACjB,QAAQ,CACY,CAAC;AACzB,CAAC;AAED,MAAM,eAAe,GAAG,+BAA+B,CAAC;AAExD,MAAM,WAAW,GAAkC,IAAI,GAAG,CAAmB;IAC3E,gBAAgB;IAChB,kBAAkB;IAClB,gBAAgB;IAChB,eAAe;IACf,mBAAmB;IACnB,wBAAwB;IACxB,uBAAuB;IACvB,YAAY;IACZ,SAAS;CACV,CAAC,CAAC;AAEH,SAAS,qBAAqB,CAAC,GAAY;IACzC,IAAI,GAAG,YAAY,YAAY;QAAE,MAAM,GAAG,CAAC;IAC3C,IAAI,GAAG,YAAY,KAAK,EAAE,CAAC;QACzB,MAAM,CAAC,GAAG,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;QAC7C,IAAI,CAAC,IAAI,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAqB,CAAC,EAAE,CAAC;YACnD,MAAM,IAAI,YAAY,CAAC,CAAC,CAAC,CAAC,CAAqB,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACzD,CAAC;QACD,MAAM,SAAS,GAAI,GAAiC,CAAC,IAAI,CAAC;QAC1D,IAAI,SAAS,IAAI,WAAW,CAAC,GAAG,CAAC,SAA6B,CAAC,EAAE,CAAC;YAChE,MAAM,IAAI,YAAY,CAAC,SAA6B,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;QACrE,CAAC;QACD,MAAM,IAAI,YAAY,CAAC,SAAS,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;IACjD,CAAC;IACD,MAAM,IAAI,YAAY,CAAC,SAAS,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;AACjD,CAAC;AAED,MAAM,YAAY,GAAG;IACnB,iBAAiB;CAClB,CAAC;AAEF,OAAO,EACL,WAAW,EACX,iBAAiB,EACjB,mBAAmB,EACnB,wBAAwB,EACxB,YAAY,EACZ,YAAY,GACb,CAAC","sourcesContent":["import { EventSubscription, Platform } from \"expo-modules-core\";\n\nimport {\n  SpotifyConfig,\n  SpotifyError,\n  SpotifyErrorCode,\n  SpotifyRefreshConfig,\n  SpotifySession,\n  SpotifySessionChangeEvent,\n} from \"./ExpoSpotifySDK.types\";\nimport ExpoSpotifySDKModule from \"./ExpoSpotifySDKModule\";\n\nconst ANDROID_TOKEN_FLOW_WARNING =\n  \"[expo-spotify-sdk] You are using authenticateAsync on Android without a \" +\n  \"tokenSwapURL. The Spotify Android SDK does NOT return a refresh token or \" +\n  \"the actual granted scopes through this path; see the README's \" +\n  \"'Android implicit (TOKEN) flow is not recommended' section.\";\n\nlet warnedAboutAndroidTokenFlow = false;\n\n/**\n * Returns `true` if the Spotify app is installed on the device.\n * Always returns `false` on web.\n */\nfunction isAvailable(): boolean {\n  return ExpoSpotifySDKModule.isAvailable();\n}\n\n/**\n * Starts a Spotify OAuth flow. Resolves with a {@link SpotifySession};\n * rejects with a {@link SpotifyError} carrying a `code`.\n */\nfunction authenticateAsync(config: SpotifyConfig): Promise<SpotifySession> {\n  if (!config.scopes || config.scopes.length === 0) {\n    return Promise.reject(\n      new SpotifyError(\n        \"INVALID_CONFIG\",\n        \"scopes must contain at least one entry\",\n      ),\n    );\n  }\n  if (\n    Platform.OS === \"android\" &&\n    !config.tokenSwapURL &&\n    !warnedAboutAndroidTokenFlow\n  ) {\n    warnedAboutAndroidTokenFlow = true;\n\n    console.warn(ANDROID_TOKEN_FLOW_WARNING);\n  }\n  return ExpoSpotifySDKModule.authenticateAsync(config)\n    .then(normaliseSession)\n    .catch(rethrowAsSpotifyError);\n}\n\nfunction normaliseSession(raw: unknown): SpotifySession {\n  if (!raw || typeof raw !== \"object\") {\n    throw new SpotifyError(\n      \"UNKNOWN\",\n      \"Native module returned a non-object session\",\n    );\n  }\n  const r = raw as Record<string, unknown>;\n  const accessToken = r.accessToken;\n  if (typeof accessToken !== \"string\" || accessToken.length === 0) {\n    throw new SpotifyError(\"UNKNOWN\", \"Session is missing accessToken\");\n  }\n  const expirationDate = r.expirationDate;\n  if (typeof expirationDate !== \"number\") {\n    throw new SpotifyError(\"UNKNOWN\", \"Session is missing expirationDate\");\n  }\n  const refreshTokenRaw = r.refreshToken;\n  const refreshToken =\n    typeof refreshTokenRaw === \"string\" && refreshTokenRaw.length > 0\n      ? refreshTokenRaw\n      : null;\n  const scopesRaw = r.scopes;\n  const scopes = Array.isArray(scopesRaw)\n    ? (scopesRaw.filter(\n        (s) => typeof s === \"string\",\n      ) as SpotifySession[\"scopes\"])\n    : [];\n  return { accessToken, refreshToken, expirationDate, scopes };\n}\n\n/**\n * Exchanges a refresh token for a new access token via your token refresh\n * server. Resolves with a fresh {@link SpotifySession}; rejects with a\n * {@link SpotifyError}.\n */\nfunction refreshSessionAsync(\n  config: SpotifyRefreshConfig,\n): Promise<SpotifySession> {\n  if (!config.refreshToken) {\n    return Promise.reject(\n      new SpotifyError(\"INVALID_CONFIG\", \"refreshToken is required\"),\n    );\n  }\n  if (!config.tokenRefreshURL) {\n    return Promise.reject(\n      new SpotifyError(\"INVALID_CONFIG\", \"tokenRefreshURL is required\"),\n    );\n  }\n  return ExpoSpotifySDKModule.refreshSessionAsync(config)\n    .then(normaliseSession)\n    .catch(rethrowAsSpotifyError);\n}\n\n/**\n * Subscribes to session lifecycle events emitted by the native module.\n *\n * Events are fired for every `authenticateAsync` and `refreshSessionAsync`\n * call, regardless of whether the call was awaited. Useful for persisting\n * tokens in a central store without coupling the store to the call sites.\n *\n * Returns a {@link Subscription} — call `.remove()` to unsubscribe.\n *\n * @example\n * ```ts\n * const sub = addSessionChangeListener((event) => {\n *   if (event.type === \"didInitiate\" || event.type === \"didRenew\") {\n *     store.setSession(event.session);\n *   }\n * });\n * // later:\n * sub.remove();\n * ```\n */\nfunction addSessionChangeListener(\n  listener: (event: SpotifySessionChangeEvent) => void,\n): EventSubscription {\n  return ExpoSpotifySDKModule.addListener(\n    \"onSessionChange\",\n    listener,\n  ) as EventSubscription;\n}\n\nconst ERROR_PREFIX_RE = /^([A-Z_][A-Z0-9_]*):\\s*(.*)$/s;\n\nconst VALID_CODES: ReadonlySet<SpotifyErrorCode> = new Set<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\nfunction rethrowAsSpotifyError(err: unknown): never {\n  if (err instanceof SpotifyError) throw err;\n  if (err instanceof Error) {\n    const m = err.message.match(ERROR_PREFIX_RE);\n    if (m && VALID_CODES.has(m[1] as SpotifyErrorCode)) {\n      throw new SpotifyError(m[1] as SpotifyErrorCode, m[2]);\n    }\n    const maybeCode = (err as Error & { code?: string }).code;\n    if (maybeCode && VALID_CODES.has(maybeCode as SpotifyErrorCode)) {\n      throw new SpotifyError(maybeCode as SpotifyErrorCode, err.message);\n    }\n    throw new SpotifyError(\"UNKNOWN\", err.message);\n  }\n  throw new SpotifyError(\"UNKNOWN\", String(err));\n}\n\nconst Authenticate = {\n  authenticateAsync,\n};\n\nexport {\n  isAvailable,\n  authenticateAsync,\n  refreshSessionAsync,\n  addSessionChangeListener,\n  Authenticate,\n  SpotifyError,\n};\nexport type {\n  SpotifyConfig,\n  SpotifyRefreshConfig,\n  SpotifySession,\n  SpotifySessionChangeEvent,\n  SpotifyErrorCode,\n  SpotifyScope,\n} from \"./ExpoSpotifySDK.types\";\n"]}

package/expo-module.config.json

@@ -2,7 +2,7 @@
   "platforms": ["ios", "android", "web"],
   "ios": {
     "modules": ["ExpoSpotifySDKModule"],
-    "appDelegateSubscribers": ["ExpoSpotifyAuthDelegate"]
+    "appDelegateSubscribers": ["ExpoSpotifyAppDelegate"]
   },
   "android": {
     "modules": ["expo.modules.spotifysdk.ExpoSpotifySDKModule"]

package/ios/ExpoSpotifyAppDelegate.swift

@@ -0,0 +1,14 @@
+import ExpoModulesCore
+import SpotifyiOS
+
+/// Delivers Spotify auth redirect URLs received via the legacy
+/// `application(_:open:url:)` AppDelegate path.
+public class ExpoSpotifyAppDelegate: ExpoAppDelegateSubscriber {
+  public func application(
+    _ app: UIApplication,
+    open url: URL,
+    options: [UIApplication.OpenURLOptionsKey: Any] = [:]
+  ) -> Bool {
+    return SpotifyAuthCoordinator.shared?.handleOpenURL(url, options: options) ?? false
+  }
+}

package/ios/ExpoSpotifyConfiguration.swift

@@ -1,20 +1,38 @@
+import Foundation
 import SpotifyiOS
 
-struct ExpoSpotifyConfiguration: Codable {
-    let clientID: String
-    let host: String
-    let scheme: String
-    
-    var redirectURL: URL? {
-        return URL(string: "\(scheme)://\(host)")
+/// Strongly-typed view of the `ExpoSpotifySDK` Info.plist dictionary written
+/// by the Expo config plugin. Values are validated up-front; missing or empty
+/// entries return nil so callers can fail with a structured error.
+struct ExpoSpotifyConfiguration {
+  let clientID: String
+  let host: String
+  let scheme: String
+
+  var redirectURL: URL? {
+    return URL(string: "\(scheme)://\(host)")
+  }
+
+  var sptConfiguration: SPTConfiguration? {
+    guard let redirectURL = redirectURL else { return nil }
+    return SPTConfiguration(clientID: clientID, redirectURL: redirectURL)
+  }
+
+  static func fromInfoPlist(bundle: Bundle = .main) -> ExpoSpotifyConfiguration? {
+    guard let dict = bundle.object(forInfoDictionaryKey: "ExpoSpotifySDK") as? [String: Any] else {
+      return nil
     }
-    
-    init(clientID: String = "defaultClientID",
-         host: String = "defaultHost",
-         scheme: String = "defaultScheme"
-    ) {
-        self.clientID = clientID
-        self.host = host
-        self.scheme = scheme
+    guard
+      let clientID = (dict["clientID"] as? String)?.nilIfEmpty,
+      let host = (dict["host"] as? String)?.nilIfEmpty,
+      let scheme = (dict["scheme"] as? String)?.nilIfEmpty
+    else {
+      return nil
     }
+    return ExpoSpotifyConfiguration(clientID: clientID, host: host, scheme: scheme)
+  }
+}
+
+private extension String {
+  var nilIfEmpty: String? { isEmpty ? nil : self }
 }

package/ios/ExpoSpotifySDK.podspec

@@ -10,15 +10,13 @@ Pod::Spec.new do |s|
   s.license        = package['license']
   s.author         = package['author']
   s.homepage       = package['homepage']
-  s.platform       = :ios, '13.0'
-  s.swift_version  = '5.4'
+  s.platform       = :ios, '15.1'
+  s.swift_version  = '5.9'
   s.source         = { git: 'https://github.com/wwdrew/expo-spotify-sdk' }
   s.static_framework = true
 
   s.dependency 'ExpoModulesCore'
-  s.dependency 'PromiseKit', "~> 6.8"
 
-  # Swift/Objective-C compatibility
   s.pod_target_xcconfig = {
     'DEFINES_MODULE' => 'YES',
     'SWIFT_COMPILATION_MODE' => 'wholemodule'