@wwdrew/expo-spotify-sdk 2.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,6 +1,6 @@
 {
   "name": "@wwdrew/expo-spotify-sdk",
-  "version": "2.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",
@@ -19,7 +19,7 @@
     "build:plugin": "tsc -p plugin/tsconfig.json",
     "clean": "rm -rf build plugin/build",
     "lint": "eslint src",
-    "test": "jest --rootDir plugin --config plugin/jest.config.js",
+    "test": "jest --config jest.config.js",
     "prepublishOnly": "yarn clean && yarn build && yarn build:plugin",
     "typecheck": "tsc --noEmit",
     "open:ios": "open -a \"Xcode\" example/ios",
@@ -33,6 +33,8 @@
     "Spotify"
   ],
   "files": [
+    "plugin/index.js",
+    "plugin/index.d.ts",
     "plugin/build",
     "build",
     "android",

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;