@wwdrew/expo-spotify-sdk 1.0.0 → 2.1.0

package/ios/SpotifyAppRemoteErrors.swift

@@ -0,0 +1,221 @@
+import ExpoModulesCore
+import Foundation
+
+// MARK: — App Remote error types
+
+enum AppRemoteError: Error {
+  case connectionFailed(String)
+  case connectionLost(String)
+  case notConnected(String)
+  case unknown(String)
+
+  var code: String {
+    switch self {
+    case .connectionFailed: return "CONNECTION_FAILED"
+    case .connectionLost: return "CONNECTION_LOST"
+    case .notConnected: return "NOT_CONNECTED"
+    case .unknown: return "UNKNOWN"
+    }
+  }
+
+  var message: String {
+    switch self {
+    case .connectionFailed(let m): return m
+    case .connectionLost(let m): return m
+    case .notConnected(let m): return m
+    case .unknown(let m): return m
+    }
+  }
+}
+
+/// Bridges an `AppRemoteError` through expo-modules-core's exception system so
+/// JS callers receive a structured `code` and `reason`, not "undefined reason".
+final class AppRemoteException: Exception, @unchecked Sendable {
+  private let appRemoteCode: String
+  private let appRemoteMessage: String
+
+  init(_ error: AppRemoteError, file: String = #fileID, line: UInt = #line, function: String = #function) {
+    self.appRemoteCode = error.code
+    self.appRemoteMessage = error.message
+    super.init(file: file, line: line, function: function)
+  }
+
+  override var code: String { appRemoteCode }
+  override var reason: String { appRemoteMessage }
+}
+
+// MARK: — Player error types
+
+enum NativePlayerError: Error {
+  case notConnected(String)
+  case connectionLost(String)
+  case premiumRequired(String)
+  case invalidURI(String)
+  case invalidParameter(String)
+  case operationNotAllowed(String)
+  case unknown(String)
+
+  var code: String {
+    switch self {
+    case .notConnected: return "NOT_CONNECTED"
+    case .connectionLost: return "CONNECTION_LOST"
+    case .premiumRequired: return "PREMIUM_REQUIRED"
+    case .invalidURI: return "INVALID_URI"
+    case .invalidParameter: return "INVALID_PARAMETER"
+    case .operationNotAllowed: return "OPERATION_NOT_ALLOWED"
+    case .unknown: return "UNKNOWN"
+    }
+  }
+
+  var message: String {
+    switch self {
+    case .notConnected(let m): return m
+    case .connectionLost(let m): return m
+    case .premiumRequired(let m): return m
+    case .invalidURI(let m): return m
+    case .invalidParameter(let m): return m
+    case .operationNotAllowed(let m): return m
+    case .unknown(let m): return m
+    }
+  }
+}
+
+final class PlayerException: Exception, @unchecked Sendable {
+  private let playerCode: String
+  private let playerMessage: String
+
+  init(_ error: NativePlayerError, file: String = #fileID, line: UInt = #line, function: String = #function) {
+    self.playerCode = error.code
+    self.playerMessage = error.message
+    super.init(file: file, line: line, function: function)
+  }
+
+  override var code: String { playerCode }
+  override var reason: String { playerMessage }
+}
+
+// MARK: — User error types
+
+enum NativeUserError: Error {
+  case notConnected(String)
+  case connectionLost(String)
+  case invalidURI(String)
+  case operationNotAllowed(String)
+  case unknown(String)
+
+  var code: String {
+    switch self {
+    case .notConnected: return "NOT_CONNECTED"
+    case .connectionLost: return "CONNECTION_LOST"
+    case .invalidURI: return "INVALID_URI"
+    case .operationNotAllowed: return "OPERATION_NOT_ALLOWED"
+    case .unknown: return "UNKNOWN"
+    }
+  }
+
+  var message: String {
+    switch self {
+    case .notConnected(let m): return m
+    case .connectionLost(let m): return m
+    case .invalidURI(let m): return m
+    case .operationNotAllowed(let m): return m
+    case .unknown(let m): return m
+    }
+  }
+}
+
+final class UserException: Exception, @unchecked Sendable {
+  private let userCode: String
+  private let userMessage: String
+
+  init(_ error: NativeUserError, file: String = #fileID, line: UInt = #line, function: String = #function) {
+    self.userCode = error.code
+    self.userMessage = error.message
+    super.init(file: file, line: line, function: function)
+  }
+
+  override var code: String { userCode }
+  override var reason: String { userMessage }
+}
+
+// MARK: — Content error types
+
+enum NativeContentError: Error {
+  case notConnected(String)
+  case connectionLost(String)
+  case contentAPIUnavailable(String)
+  case unknown(String)
+
+  var code: String {
+    switch self {
+    case .notConnected: return "NOT_CONNECTED"
+    case .connectionLost: return "CONNECTION_LOST"
+    case .contentAPIUnavailable: return "CONTENT_API_UNAVAILABLE"
+    case .unknown: return "UNKNOWN"
+    }
+  }
+
+  var message: String {
+    switch self {
+    case .notConnected(let m): return m
+    case .connectionLost(let m): return m
+    case .contentAPIUnavailable(let m): return m
+    case .unknown(let m): return m
+    }
+  }
+}
+
+final class ContentException: Exception, @unchecked Sendable {
+  private let contentCode: String
+  private let contentMessage: String
+
+  init(_ error: NativeContentError, file: String = #fileID, line: UInt = #line, function: String = #function) {
+    self.contentCode = error.code
+    self.contentMessage = error.message
+    super.init(file: file, line: line, function: function)
+  }
+
+  override var code: String { contentCode }
+  override var reason: String { contentMessage }
+}
+
+// MARK: — Images error types
+
+enum NativeImagesError: Error {
+  case notConnected(String)
+  case invalidURI(String)
+  case imageLoadFailed(String)
+  case unknown(String)
+
+  var code: String {
+    switch self {
+    case .notConnected: return "NOT_CONNECTED"
+    case .invalidURI: return "INVALID_URI"
+    case .imageLoadFailed: return "IMAGE_LOAD_FAILED"
+    case .unknown: return "UNKNOWN"
+    }
+  }
+
+  var message: String {
+    switch self {
+    case .notConnected(let m): return m
+    case .invalidURI(let m): return m
+    case .imageLoadFailed(let m): return m
+    case .unknown(let m): return m
+    }
+  }
+}
+
+final class ImagesException: Exception, @unchecked Sendable {
+  private let imagesCode: String
+  private let imagesMessage: String
+
+  init(_ error: NativeImagesError, file: String = #fileID, line: UInt = #line, function: String = #function) {
+    self.imagesCode = error.code
+    self.imagesMessage = error.message
+    super.init(file: file, line: line, function: function)
+  }
+
+  override var code: String { imagesCode }
+  override var reason: String { imagesMessage }
+}

package/ios/SpotifyAppRemoteMappers.swift

@@ -0,0 +1,88 @@
+import Foundation
+import SpotifyiOS
+import UIKit
+
+/// Serializes Spotify App Remote SDK objects into NSDictionary-compatible payloads
+/// for the Expo JS bridge.
+enum SpotifyAppRemoteMappers {
+  static func playerStateToMap(_ state: any SPTAppRemotePlayerState) -> [String: Any] {
+    let track = state.track
+    let restrictions = state.playbackRestrictions
+    let options = state.playbackOptions
+    return [
+      "track": [
+        "uri": track.uri,
+        "name": track.name,
+        "imageIdentifier": track.imageIdentifier,
+        "duration": track.duration,
+        "artist": ["name": track.artist.name, "uri": track.artist.uri],
+        "album": ["name": track.album.name, "uri": track.album.uri],
+        "isSaved": track.isSaved,
+        "isEpisode": track.isEpisode,
+        "isPodcast": track.isPodcast,
+        "isAdvertisement": track.isAdvertisement,
+      ] as [String: Any],
+      "playbackPosition": state.playbackPosition,
+      "playbackSpeed": state.playbackSpeed,
+      "isPaused": state.isPaused,
+      "playbackOptions": [
+        "isShuffling": options.isShuffling,
+        "repeatMode": options.repeatMode.rawValue,
+      ] as [String: Any],
+      "playbackRestrictions": [
+        "canSkipNext": restrictions.canSkipNext,
+        "canSkipPrevious": restrictions.canSkipPrevious,
+        "canRepeatTrack": restrictions.canRepeatTrack,
+        "canRepeatContext": restrictions.canRepeatContext,
+        "canToggleShuffle": restrictions.canToggleShuffle,
+        "canSeek": restrictions.canSeek,
+      ] as [String: Any],
+      "contextTitle": state.contextTitle,
+      "contextUri": state.contextURI.absoluteString,
+    ]
+  }
+
+  static func capabilitiesToMap(_ capabilities: any SPTAppRemoteUserCapabilities) -> [String: Any] {
+    ["canPlayOnDemand": capabilities.canPlayOnDemand]
+  }
+
+  static func libraryStateToMap(_ state: any SPTAppRemoteLibraryState) -> [String: Any] {
+    ["uri": state.uri, "isAdded": state.isAdded, "canAdd": state.canAdd]
+  }
+
+  static func mapContentType(_ type: String) -> String {
+    switch type {
+    case "navigation": return SPTAppRemoteContentTypeNavigation
+    case "fitness": return SPTAppRemoteContentTypeFitness
+    case "gaming": return SPTAppRemoteContentTypeGaming
+    default: return SPTAppRemoteContentTypeDefault
+    }
+  }
+
+  static func mapImageSize(_ size: String) -> CGSize {
+    switch size {
+    case "small": return CGSize(width: 64, height: 64)
+    case "medium": return CGSize(width: 300, height: 300)
+    default: return CGSize(width: 640, height: 640)
+    }
+  }
+
+  static func contentItemToMap(_ item: any SPTAppRemoteContentItem) -> [String: Any] {
+    var map: [String: Any] = [
+      "title": item.title as Any,
+      "subtitle": item.subtitle as Any,
+      "contentDescription": item.contentDescription as Any,
+      "identifier": item.identifier,
+      "uri": item.uri,
+      "imageIdentifier": item.imageIdentifier,
+      "isAvailableOffline": item.isAvailableOffline,
+      "isPlayable": item.isPlayable,
+      "isContainer": item.isContainer,
+      "isPinned": item.isPinned,
+    ]
+    if let children = item.children {
+      map["children"] = children.map(contentItemToMap)
+    }
+    return map
+  }
+}

package/package.json

@@ -1,18 +1,27 @@
 {
   "name": "@wwdrew/expo-spotify-sdk",
-  "version": "1.0.0",
+  "version": "2.1.0",
   "description": "Expo module wrapping the native Spotify iOS (v5) and Android (v4) SDKs for OAuth authentication and App Remote playback control",
   "main": "build/index.js",
   "types": "build/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./build/index.d.ts",
+      "default": "./build/index.js"
+    },
+    "./plugin": {
+      "types": "./plugin/build/index.d.ts",
+      "default": "./plugin/index.js"
+    }
+  },
   "scripts": {
-    "build": "expo-module build",
-    "clean": "expo-module clean",
-    "lint": "expo-module lint",
-    "test": "expo-module test plugin",
-    "prepare": "expo-module prepare",
-    "prepublishOnly": "expo-module prepublishOnly",
-    "typecheck": "expo-module typecheck",
-    "expo-module": "expo-module",
+    "build": "tsc",
+    "build:plugin": "tsc -p plugin/tsconfig.json",
+    "clean": "rm -rf build plugin/build",
+    "lint": "eslint src",
+    "test": "jest --config jest.config.js",
+    "prepublishOnly": "yarn clean && yarn build && yarn build:plugin",
+    "typecheck": "tsc --noEmit",
     "open:ios": "open -a \"Xcode\" example/ios",
     "open:android": "open -a \"Android Studio\" example/android"
   },
@@ -24,6 +33,8 @@
     "Spotify"
   ],
   "files": [
+    "plugin/index.js",
+    "plugin/index.d.ts",
     "plugin/build",
     "build",
     "android",
@@ -39,13 +50,16 @@
   "license": "MIT",
   "homepage": "https://github.com/wwdrew/expo-spotify-sdk#readme",
   "devDependencies": {
-    "@expo/config-plugins": "^55.0.8",
-    "@types/react": "^18.0.25",
+    "@babel/runtime": "^7.29.7",
+    "@expo/config-plugins": "^56.0.8",
+    "@types/react": "^19.0.0",
+    "babel-preset-expo": "~56.0.0",
     "eslint": "^9.0.0",
-    "expo-module-scripts": "^55.0.2",
-    "expo-modules-core": "^3.0.30",
+    "expo-module-scripts": "^56.0.2",
+    "expo-modules-core": "^56.0.13",
     "jest": "^29.7.0",
-    "prettier": "^3.0.0"
+    "prettier": "^3.0.0",
+    "typescript": "^5.9.0"
   },
   "peerDependencies": {
     "expo": "*",

package/plugin/build/index.d.ts

@@ -1,4 +1,21 @@
-import { ConfigPlugin } from "@expo/config-plugins";
 import { SpotifyConfig } from "./types";
-export declare const withSpotifySdkConfig: ConfigPlugin<SpotifyConfig>;
-export default withSpotifySdkConfig;
+/**
+ * Typed config plugin helper for `app.config.ts` (Expo SDK 56+).
+ *
+ * @example
+ * import withSpotifySdk from "@wwdrew/expo-spotify-sdk/plugin";
+ *
+ * export default ({ config }) => ({
+ *   ...config,
+ *   plugins: [
+ *     withSpotifySdk({
+ *       clientID: "your-spotify-client-id",
+ *       scheme: "myapp",
+ *       host: "spotify-auth",
+ *     }),
+ *   ],
+ * });
+ */
+declare const _default: (props: SpotifyConfig) => [string, SpotifyConfig];
+export default _default;
+export type { SpotifyConfig, SpotifyScopes } from "./types";

package/plugin/build/index.js

@@ -1,27 +1,24 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.withSpotifySdkConfig = void 0;
-const withSpotifyAndroidAppBuildGradle_1 = require("./android/withSpotifyAndroidAppBuildGradle");
-const withSpotifyConfigValues_1 = require("./ios/withSpotifyConfigValues");
-const withSpotifyQueryScheme_1 = require("./ios/withSpotifyQueryScheme");
-const withSpotifyURLScheme_1 = require("./ios/withSpotifyURLScheme");
-const withSpotifySdkConfig = (config, spotifyConfig) => {
-    if (!spotifyConfig.host) {
-        throw new Error("Missing required Spotify config value: host");
-    }
-    if (!spotifyConfig.scheme) {
-        throw new Error("Missing required Spotify config value: scheme");
-    }
-    if (!spotifyConfig.clientID) {
-        throw new Error("Missing required Spotify config value: clientID");
-    }
-    // Android specific
-    config = (0, withSpotifyAndroidAppBuildGradle_1.withSpotifyAndroidAppBuildGradle)(config, spotifyConfig);
-    // iOS specific
-    config = (0, withSpotifyConfigValues_1.withSpotifyConfigValues)(config, spotifyConfig);
-    config = (0, withSpotifyQueryScheme_1.withSpotifyQueryScheme)(config, spotifyConfig);
-    config = (0, withSpotifyURLScheme_1.withSpotifyURLScheme)(config, spotifyConfig);
-    return config;
-};
-exports.withSpotifySdkConfig = withSpotifySdkConfig;
-exports.default = exports.withSpotifySdkConfig;
+const PACKAGE_NAME = "@wwdrew/expo-spotify-sdk";
+/**
+ * Typed config plugin helper for `app.config.ts` (Expo SDK 56+).
+ *
+ * @example
+ * import withSpotifySdk from "@wwdrew/expo-spotify-sdk/plugin";
+ *
+ * export default ({ config }) => ({
+ *   ...config,
+ *   plugins: [
+ *     withSpotifySdk({
+ *       clientID: "your-spotify-client-id",
+ *       scheme: "myapp",
+ *       host: "spotify-auth",
+ *     }),
+ *   ],
+ * });
+ */
+exports.default = (props) => [
+    PACKAGE_NAME,
+    props,
+];

package/plugin/build/types.d.ts

@@ -8,7 +8,23 @@ export type SpotifyScopes = "ugc-image-upload" | "user-read-playback-state" | "u
  * Configuration accepted by the `@wwdrew/expo-spotify-sdk` Expo config plugin.
  *
  * @example
- * // app.config.ts
+ * // app.config.ts (Expo SDK 56+ — typed import)
+ * import withSpotifySdk from "@wwdrew/expo-spotify-sdk/plugin";
+ *
+ * export default ({ config }) => ({
+ *   ...config,
+ *   plugins: [
+ *     withSpotifySdk({
+ *       clientID: "<spotify-client-id>",
+ *       scheme: "myapp",
+ *       host: "spotify-auth",
+ *       redirectPathPattern: ".*",
+ *     }),
+ *   ],
+ * });
+ *
+ * @example
+ * // app.config.ts / app.json (string tuple — all SDK versions)
  * export default {
  *   plugins: [
  *     ["@wwdrew/expo-spotify-sdk", {

package/plugin/build/withSpotifySdkConfig.d.ts

@@ -0,0 +1,4 @@
+import { ConfigPlugin } from "@expo/config-plugins";
+import { SpotifyConfig } from "./types";
+export declare const withSpotifySdkConfig: ConfigPlugin<SpotifyConfig>;
+export default withSpotifySdkConfig;

package/plugin/build/withSpotifySdkConfig.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.withSpotifySdkConfig = void 0;
+const withSpotifyAndroidAppBuildGradle_1 = require("./android/withSpotifyAndroidAppBuildGradle");
+const withSpotifyConfigValues_1 = require("./ios/withSpotifyConfigValues");
+const withSpotifyQueryScheme_1 = require("./ios/withSpotifyQueryScheme");
+const withSpotifyURLScheme_1 = require("./ios/withSpotifyURLScheme");
+const withSpotifySdkConfig = (config, spotifyConfig) => {
+    if (!spotifyConfig.host) {
+        throw new Error("Missing required Spotify config value: host");
+    }
+    if (!spotifyConfig.scheme) {
+        throw new Error("Missing required Spotify config value: scheme");
+    }
+    if (!spotifyConfig.clientID) {
+        throw new Error("Missing required Spotify config value: clientID");
+    }
+    // Android specific
+    config = (0, withSpotifyAndroidAppBuildGradle_1.withSpotifyAndroidAppBuildGradle)(config, spotifyConfig);
+    // iOS specific
+    config = (0, withSpotifyConfigValues_1.withSpotifyConfigValues)(config, spotifyConfig);
+    config = (0, withSpotifyQueryScheme_1.withSpotifyQueryScheme)(config, spotifyConfig);
+    config = (0, withSpotifyURLScheme_1.withSpotifyURLScheme)(config, spotifyConfig);
+    return config;
+};
+exports.withSpotifySdkConfig = withSpotifySdkConfig;
+exports.default = exports.withSpotifySdkConfig;

package/plugin/index.d.ts

@@ -0,0 +1,2 @@
+export { default } from "./build/index";
+export type { SpotifyConfig, SpotifyScopes } from "./build/types";

package/plugin/index.js

@@ -0,0 +1 @@
+module.exports = require("./build").default;