@wwdrew/expo-spotify-sdk 0.3.1 → 0.4.1

package/README.md

@@ -4,7 +4,7 @@ An Expo Module for the native [iOS](https://github.com/spotify/ios-sdk/) and [An
 
 ## Supported Features
 
-- Authentication (currently iOS only, Android coming soon)
+- Authentication
 
 More to come...
 
@@ -52,13 +52,15 @@ authenticateAsync(config: SpotifyConfig): Promise<SpotifySession>
 
 Starts the authentication process. Requires an array of OAuth scopes. If the Spotify app is installed on the target device it will interact directly with it, otherwise it will open a web view to authenticate with the Spotify website.
 
+**Note for Android:** If not providing a token swap or refresh URL, the Spotify session response access token will expire after 60 minutes and will not include a refresh token. This is due to a limitation in the Android Spotify SDK. It's recommended to [implement a token swap endpoint](#token-swap) for this reason.
+
 ### Parameters
 
 - `tokenSwapURL` (optional): &lt;string&gt; The URL to use for attempting to swap an authorization code for an access token
 - `tokenRefreshURL` (optional): &lt;string&gt; The URL to use for attempting to renew an access token with a refresh token
 - `scopes`: An array of OAuth scopes that declare how your app wants to access a user's account. See [Spotify Scopes](https://developer.spotify.com/web-api/using-scopes/) for more information.
 
-  **Note**: The following scopes are not available to Expo Spotify SDK:
+**Note:** The following scopes are not available to Expo Spotify SDK:
 
   - user-read-playback-position
   - user-soa-link
@@ -78,9 +80,8 @@ interface SpotifyConfig {
 
 interface SpotifySession {
   accessToken: string;
-  refreshToken: string;
+  refreshToken: string | null;
   expirationDate: number;
-  isExpired: boolean;
   scopes: SpotifyScopes[];
 }
 
@@ -105,6 +106,38 @@ type SpotifyScopes =
   | "user-read-private";
 ```
 
+## Token Swap Example
+
+An example token swap endpoint has been provided in the `example` project. For it to work it needs your Spotify client details to be included.
+
+1. Open the `server.js` file and add your client details:
+
+```javascript
+const CLIENT_ID = "<your-client-id>";
+const CLIENT_SECRET = "<your-client-secret>";
+```
+
+These values can be found in your [Spotify Developer Dashboard](https://developer.spotify.com/dashboard). You will need an existing Spotify app for this.
+
+2. Run the server
+
+```sh
+node server.js
+```
+
+3. Set the `tokenSwapURL` value in your `authenticateAsync` call:
+
+```javascript
+const session = await authenticateAsync({
+  tokenSwapURL: "http://192.168.1.120:3000/swap",
+  scopes: [
+    ...
+  ]
+});
+```
+
+All authentication requests will now be sent through the token swap server.
+
 ## Acknowledgments
 
 This project has been heavily inspired by the following projects:

package/android/build.gradle

@@ -0,0 +1,49 @@
+apply plugin: 'com.android.library'
+
+group = 'expo.modules.spotifysdk'
+version = '0.1.0'
+
+def expoModulesCorePlugin = new File(project(":expo-modules-core").projectDir.absolutePath, "ExpoModulesCorePlugin.gradle")
+apply from: expoModulesCorePlugin
+applyKotlinExpoModulesCorePlugin()
+useCoreDependencies()
+useExpoPublishing()
+
+// If you want to use the managed Android SDK versions from expo-modules-core, set this to true.
+// The Android SDK versions will be bumped from time to time in SDK releases and may introduce breaking changes in your module code.
+// Most of the time, you may like to manage the Android SDK versions yourself.
+def useManagedAndroidSdkVersions = false
+if (useManagedAndroidSdkVersions) {
+  useDefaultAndroidSdkVersions()
+} else {
+  buildscript {
+    // Simple helper that allows the root project to override versions declared by this library.
+    ext.safeExtGet = { prop, fallback ->
+      rootProject.ext.has(prop) ? rootProject.ext.get(prop) : fallback
+    }
+  }
+  project.android {
+    compileSdkVersion safeExtGet("compileSdkVersion", 34)
+    defaultConfig {
+      minSdkVersion safeExtGet("minSdkVersion", 21)
+      targetSdkVersion safeExtGet("targetSdkVersion", 34)
+    }
+  }
+}
+
+android {
+  namespace "expo.modules.spotifysdk"
+  defaultConfig {
+    versionCode 1
+    versionName "0.1.0"
+  }
+  lintOptions {
+    abortOnError false
+  }
+}
+
+dependencies {
+   implementation 'androidx.browser:browser:1.8.0'
+   implementation 'com.squareup.okhttp3:okhttp:4.9.2'
+   implementation files("../external/android/SpotifySDK/auth-lib/spotify-auth-release-2.1.0.aar")
+}

package/android/src/main/AndroidManifest.xml

@@ -0,0 +1,11 @@
+<?xml version="1.0" encoding="utf-8"?>
+<manifest xmlns:android="http://schemas.android.com/apk/res/android">
+    <application>
+        <meta-data
+            android:name="spotifyClientId"
+            android:value="${spotifyClientId}" />
+        <meta-data
+            android:name="spotifyRedirectUri"
+            android:value="${spotifyRedirectUri}" />
+    </application>
+</manifest>

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

@@ -0,0 +1,180 @@
+package expo.modules.spotifysdk
+
+import android.content.pm.PackageManager
+import expo.modules.kotlin.Promise
+import expo.modules.kotlin.modules.Module
+import expo.modules.kotlin.modules.ModuleDefinition
+import com.spotify.sdk.android.auth.AuthorizationClient
+import com.spotify.sdk.android.auth.AuthorizationRequest
+import com.spotify.sdk.android.auth.AuthorizationResponse
+import com.spotify.sdk.android.auth.app.SpotifyNativeAuthUtil
+import expo.modules.kotlin.exception.Exceptions
+import expo.modules.kotlin.records.Field
+import expo.modules.kotlin.records.Record
+
+import okhttp3.OkHttpClient
+import okhttp3.FormBody
+import okhttp3.Request
+import okhttp3.Callback
+import okhttp3.Call
+import okhttp3.Response
+
+import java.io.IOException
+import org.json.JSONObject
+
+class SpotifyConfigOptions : Record {
+  @Field
+  val scopes: List<String> = emptyList()
+
+  @Field
+  val tokenSwapURL: String? = null
+
+  @Field
+  val tokenRefreshURL: String? = null
+}
+
+class ExpoSpotifySDKModule : Module() {
+
+  private val requestCode = 2095
+  private var requestConfig: SpotifyConfigOptions? = null
+  private var authPromise: Promise? = null
+  private val context
+    get() = appContext.reactContext ?: throw Exceptions.ReactContextLost()
+  private val currentActivity
+    get() = appContext.currentActivity ?: throw Exceptions.MissingActivity()
+
+  override fun definition() = ModuleDefinition {
+
+    Name("ExpoSpotifySDK")
+
+    Function("isAvailable") {
+      return@Function SpotifyNativeAuthUtil.isSpotifyInstalled(context)
+    }
+
+    AsyncFunction("authenticateAsync") { config: SpotifyConfigOptions, promise: Promise ->
+      try {
+        val packageInfo =
+          context.packageManager.getPackageInfo(context.packageName, PackageManager.GET_META_DATA)
+        val applicationInfo = packageInfo.applicationInfo
+        val metaData = applicationInfo.metaData
+        val clientId = metaData.getString("spotifyClientId")
+        val redirectUri = metaData.getString("spotifyRedirectUri")
+
+        requestConfig = config
+
+        if (clientId == null || redirectUri == null) {
+          promise.reject(
+            "ERR_EXPO_SPOTIFY_SDK",
+            "Missing Spotify configuration in AndroidManifest.xml. Ensure SPOTIFY_CLIENT_ID and SPOTIFY_REDIRECT_URI are set.",
+            null
+          )
+          return@AsyncFunction
+        }
+
+        val responseType = if (config.tokenSwapURL != null || config.tokenRefreshURL != null) {
+          AuthorizationResponse.Type.CODE
+        } else {
+          AuthorizationResponse.Type.TOKEN
+        }
+
+        val request = AuthorizationRequest.Builder(
+          clientId,
+          responseType,
+          redirectUri
+        )
+          .setScopes(config.scopes.toTypedArray())
+          .build()
+
+        authPromise = promise
+        AuthorizationClient.openLoginActivity(currentActivity, requestCode, request)
+
+      } catch (e: PackageManager.NameNotFoundException) {
+        promise.reject(
+          "ERR_EXPO_SPOTIFY_SDK",
+          "Missing Spotify configuration in AndroidManifest.xml",
+          e
+        )
+      }
+    }
+
+    OnActivityResult { _, payload ->
+      if (payload.requestCode == requestCode) {
+        val authResponse = AuthorizationClient.getResponse(payload.resultCode, payload.data)
+
+        when (authResponse.type) {
+          AuthorizationResponse.Type.TOKEN -> {
+            val expirationDate = System.currentTimeMillis() + authResponse.expiresIn * 1000
+
+            authPromise?.resolve(
+              mapOf(
+                "accessToken" to authResponse.accessToken,
+                "refreshToken" to null, // Spotify SDK does not return refresh token
+                "expirationDate" to expirationDate,
+                "scope" to requestConfig?.scopes
+              )
+            )
+          }
+
+          AuthorizationResponse.Type.CODE -> {
+            val client = OkHttpClient()
+            val requestBody = FormBody.Builder()
+              .add("code", authResponse.code)
+              .build()
+
+            val request = Request.Builder()
+              .url(requestConfig?.tokenSwapURL!!)
+              .post(requestBody)
+              .header("Content-Type", "application/x-www-form-urlencoded")
+              .build()
+
+            client.newCall(request).enqueue(object : Callback {
+              override fun onFailure(call: Call, e: IOException) {
+                authPromise?.reject("ERR_EXPO_SPOTIFY_SDK", e.message, e)
+                authPromise = null
+              }
+
+              override fun onResponse(call: Call, response: Response) {
+                if (!response.isSuccessful) {
+                  authPromise?.reject("ERR_EXPO_SPOTIFY_SDK", "Failed to swap code for token", null)
+                  authPromise = null
+                  return
+                }
+
+                response.body?.string()?.let { body ->
+                  val json = JSONObject(body)
+                  val accessToken = json.getString("access_token")
+                  val refreshToken = json.getString("refresh_token")
+                  val expiresIn = json.getInt("expires_in")
+                  val scope = json.getString("scope")
+                  val expirationDate = System.currentTimeMillis() + expiresIn * 1000
+
+                  authPromise?.resolve(
+                    mapOf(
+                      "accessToken" to accessToken,
+                      "refreshToken" to refreshToken,
+                      "expirationDate" to expirationDate,
+                      "scope" to scope.split(' ')
+                    )
+                  )
+                } ?: run {
+                  authPromise?.reject("ERR_EXPO_SPOTIFY_SDK", "Empty response body", null)
+                }
+                authPromise = null
+              }
+            })
+          }
+
+          AuthorizationResponse.Type.ERROR -> {
+            authPromise?.reject("ERR_EXPO_SPOTIFY_SDK", authResponse.error, null)
+            authPromise = null
+          }
+
+          else -> {
+            authPromise?.reject("ERR_EXPO_SPOTIFY_SDK", "Unknown response type", null)
+            authPromise = null
+          }
+        }
+      }
+    }
+  }
+}

package/build/ExpoSpotifySDK.types.d.ts

@@ -2,7 +2,6 @@ export interface SpotifySession {
     accessToken: string;
     refreshToken: string;
     expirationDate: number;
-    isExpired: boolean;
     scopes: SpotifyScope[];
 }
 export interface SpotifyConfig {

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,SAAS,EAAE,OAAO,CAAC;IACnB,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;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"}
+{"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"}

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  isExpired: boolean;\n  scopes: SpotifyScope[];\n}\n\nexport interface SpotifyConfig {\n  scopes: SpotifyScope[];\n  tokenSwapURL?: string;\n  tokenRefreshURL?: string;\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":"","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"]}

package/ios/ExpoSpotifySDKModule.swift

@@ -27,13 +27,11 @@ public class ExpoSpotifySDKModule: Module {
                     "accessToken": session.accessToken,
                     "refreshToken": session.refreshToken,
                     "expirationDate": Int(session.expirationDate.timeIntervalSince1970 * 1000),
-                    "scopes": SPTScopeSerializer.serializeScopes(session.scope),
-                    "isExpired": session.isExpired
+                    "scopes": SPTScopeSerializer.serializeScopes(session.scope)
                 ])
             }.catch { error in
                 promise.reject(error)
             }
         }
-
     }
 }

package/ios/ExpoSpotifySessionManager.swift

@@ -46,8 +46,8 @@ final class ExpoSpotifySessionManager: NSObject {
 
     func authenticate(scopes: [String], tokenSwapURL: String?, tokenRefreshURL: String?) -> PromiseKit.Promise<SPTSession> {
         return Promise { seal in
-            guard let clientID = expoSpotifyConfiguration?.clientID,
-                  let redirectURL = expoSpotifyConfiguration?.redirectURL else {
+            guard let clientID = self.expoSpotifyConfiguration?.clientID,
+                  let redirectURL = self.expoSpotifyConfiguration?.redirectURL else {
                 NSLog("Invalid Spotify configuration")
                 seal.reject(SessionManagerError.invalidConfiguration)
                 return
@@ -68,7 +68,7 @@ final class ExpoSpotifySessionManager: NSObject {
             self.sessionManager = SPTSessionManager(configuration: configuration, delegate: self)
 
             DispatchQueue.main.sync {
-                sessionManager?.initiateSession(with: SPTScopeSerializer.deserializeScopes(scopes), options: .default)
+                sessionManager?.initiateSession(with: SPTScopeSerializer.deserializeScopes(scopes), options: .default, campaign: nil)
             }
         }
     }

package/ios/SpotifySDK/SpotifyiOS.xcframework/Info.plist

@@ -5,31 +5,35 @@
 	<key>AvailableLibraries</key>
 	<array>
 		<dict>
+			<key>BinaryPath</key>
+			<string>SpotifyiOS.framework/SpotifyiOS</string>
 			<key>LibraryIdentifier</key>
-			<string>ios-arm64</string>
+			<string>ios-arm64_x86_64-simulator</string>
 			<key>LibraryPath</key>
 			<string>SpotifyiOS.framework</string>
 			<key>SupportedArchitectures</key>
 			<array>
 				<string>arm64</string>
+				<string>x86_64</string>
 			</array>
 			<key>SupportedPlatform</key>
 			<string>ios</string>
+			<key>SupportedPlatformVariant</key>
+			<string>simulator</string>
 		</dict>
 		<dict>
+			<key>BinaryPath</key>
+			<string>SpotifyiOS.framework/SpotifyiOS</string>
 			<key>LibraryIdentifier</key>
-			<string>ios-arm64_x86_64-simulator</string>
+			<string>ios-arm64</string>
 			<key>LibraryPath</key>
 			<string>SpotifyiOS.framework</string>
 			<key>SupportedArchitectures</key>
 			<array>
 				<string>arm64</string>
-				<string>x86_64</string>
 			</array>
 			<key>SupportedPlatform</key>
 			<string>ios</string>
-			<key>SupportedPlatformVariant</key>
-			<string>simulator</string>
 		</dict>
 	</array>
 	<key>CFBundlePackageType</key>

package/ios/SpotifySDK/SpotifyiOS.xcframework/ios-arm64/SpotifyiOS.framework/Headers/SPTAppRemote.h

@@ -166,24 +166,26 @@ typedef NS_ENUM(NSUInteger, SPTAppRemoteLogLevel) {
  * The passed URI will start playing unless Spotify is already playing.
  *
  * @param URI The URI to play. Use a blank string to attempt to play the user's last song
+ * @param completionHandler `YES` if the Spotify app is installed and an authorization attempt can be made, otherwise `NO`.
  *
- * @return `YES` if the Spotify app is installed and an authorization attempt can be made, otherwise `NO`.
  * Note: The return `BOOL` here is not a measure of whether or not authentication succeeded, only a check if
  * the Spotify app is installed and can attempt to handle the authorization request.
  */
-- (BOOL)authorizeAndPlayURI:(NSString *)URI;
+- (void)authorizeAndPlayURI:(NSString *)URI completionHandler:(void (^ __nullable)(BOOL success))completionHandler;
 
 /**
  * Open Spotify app to obtain access token and start playback.
  *
  * @param playURI The URI to play. Use a blank string to attempt to play the user's last song
  * @param asRadio `YES` to start radio for the given URI.
+ * @param completionHandler `YES` if the Spotify app is installed and an authorization attempt can be made, otherwise `NO`.
  *
- * @return `YES` if the Spotify app is installed and an authorization attempt can be made, otherwise `NO`.
  * Note: The return `BOOL` here is not a measure of whether or not authentication succeeded, only a check if
  * the Spotify app is installed and can attempt to handle the authorization request.
  */
-- (BOOL)authorizeAndPlayURI:(NSString *)playURI asRadio:(BOOL)asRadio;
+- (void)authorizeAndPlayURI:(NSString *)playURI
+                    asRadio:(BOOL)asRadio
+          completionHandler:(void (^ __nullable)(BOOL success))completionHandler;
 
 /**
 * Open Spotify app to obtain access token and start playback.
@@ -191,14 +193,15 @@ typedef NS_ENUM(NSUInteger, SPTAppRemoteLogLevel) {
 * @param playURI The URI to play. Use a blank string to attempt to play the user's last song
 * @param asRadio `YES` to start radio for the given URI.
 * @param additionalScopes An array of scopes in addition to `app-remote-control`. Can be nil if you only need `app-remote-control`
+* @param completionHandler `YES` if the Spotify app is installed and an authorization attempt can be made, otherwise `NO`.
 *
-* @return `YES` if the Spotify app is installed and an authorization attempt can be made, otherwise `NO`.
 * Note: The return `BOOL` here is not a measure of whether or not authentication succeeded, only a check if
 * the Spotify app is installed and can attempt to handle the authorization request.
 */
-- (BOOL)authorizeAndPlayURI:(NSString *)playURI
+- (void)authorizeAndPlayURI:(NSString *)playURI
                     asRadio:(BOOL)asRadio
-           additionalScopes:(nullable NSArray<NSString *> *)additionalScopes;
+           additionalScopes:(nullable NSArray<NSString *> *)additionalScopes
+          completionHandler:(void (^ __nullable)(BOOL success))completionHandler;
 
 /**
  * Open Spotify app to obtain access token and start playback.
@@ -209,15 +212,16 @@ typedef NS_ENUM(NSUInteger, SPTAppRemoteLogLevel) {
  * @param sessionIdentifier An optional unique identifier for this specific session, which is used for analytics purposes. Every new attempt to
  * connect to the Spotify app should have a new identifier, but the identifier used here should then be reused for the accompanied call to
  * `connectWithSessionIdentifier:`.
+ * @param completionHandler `YES` if the Spotify app is installed and an authorization attempt can be made, otherwise `NO`.
  *
- * @return `YES` if the Spotify app is installed and an authorization attempt can be made, otherwise `NO`.
  * Note: The return `BOOL` here is not a measure of whether or not authentication succeeded, only a check if
  * the Spotify app is installed and can attempt to handle the authorization request.
 */
-- (BOOL)authorizeAndPlayURI:(NSString *)playURI
+- (void)authorizeAndPlayURI:(NSString *)playURI
                     asRadio:(BOOL)asRadio
            additionalScopes:(nullable NSArray<NSString *> *)additionalScopes
-          sessionIdentifier:(nullable NSUUID *)sessionIdentifier;
+          sessionIdentifier:(nullable NSUUID *)sessionIdentifier
+          completionHandler:(void (^ __nullable)(BOOL success))completionHandler;
 /**
  * Parse out an access token or error description from a url passed to application:openURL:options:
  *

package/ios/SpotifySDK/SpotifyiOS.xcframework/ios-arm64/SpotifyiOS.framework/Headers/SPTAppRemoteContentItem.h

@@ -33,6 +33,9 @@ NS_ASSUME_NONNULL_BEGIN
 /// Returns `YES` if the item is expected to contain children, otherwise `NO`.
 @property (nonatomic, assign, readonly, getter=isContainer) BOOL container;
 
+/// Returns `YES` if the item is pinned in Your Library, otherwise `NO`. 
+@property (nonatomic, assign, readonly, getter=isPinned) BOOL pinnned;
+
 /**
  A list of the content item's children.
 

package/ios/SpotifySDK/SpotifyiOS.xcframework/ios-arm64/SpotifyiOS.framework/Headers/SPTSessionManager.h

@@ -44,26 +44,16 @@ typedef NSString * const SPTAuthorizationCode;
 - (instancetype)init NS_UNAVAILABLE;
 
 /**
- Initiate the authorization process on iOS 11 and later.
+ Initiate the authorization process
 
  @param scope The scope to request, e.g. `SPTPlaylistReadPrivateScope`|`SPTUserReadEmailScope` if you wish to request read access to private playlists, and read access to the user's email address.
  @param options Options bitmask that informs authorization behavior.
- See `SPTSessionManagerDelegate` for messages regarding changes in session state.
- */
-- (void)initiateSessionWithScope:(SPTScope)scope
-                         options:(SPTAuthorizationOptions)options NS_AVAILABLE_IOS(11_0);
-
-/**
- Initiate the authorization process on iOS versions < 11.
-
- @param scope The scope to request, e.g. `SPTPlaylistReadPrivateScope`|`SPTUserReadEmailScope` if you wish to request read access to private playlists, and read access to the user's email address.
- @param options Options bitmask that informs authorization behavior.
- @param presentingViewController The `UIViewController` to present the login `SFSafariViewController` on
+ @param campaign The campaign identifier, to help attribute where the account linking was initiated from.
  See `SPTSessionManagerDelegate` for messages regarding changes in session state.
  */
 - (void)initiateSessionWithScope:(SPTScope)scope
                          options:(SPTAuthorizationOptions)options
-        presentingViewController: (UIViewController *)presentingViewController NS_DEPRECATED_IOS(9_0, 11_0);
+                        campaign:(nullable NSString *)campaign;
 
 /// Attempt to renew the access token, using the refresh token in the current `SPTSession` which must be valid.
 - (void)renewSession;

package/ios/SpotifySDK/SpotifyiOS.xcframework/ios-arm64/SpotifyiOS.framework/Headers/SpotifyAppRemote.h

@@ -24,6 +24,8 @@
 #import "SPTAppRemoteLibraryState.h"
 #import "SPTAppRemoteContentItem.h"
 #import "SPTAppRemotePodcastPlaybackSpeed.h"
+#import "SPTAppRemoteConnectivityAPI.h"
+#import "SPTAppRemoteConnectivityState.h"
 
 #import "SPTConfiguration.h"
 

package/ios/SpotifySDK/SpotifyiOS.xcframework/ios-arm64/SpotifyiOS.framework/Modules/module.modulemap

@@ -1,6 +1,6 @@
 framework module SpotifyiOS {
   umbrella header "SpotifyiOS.h"
-
   export *
+
   module * { export * }
 }

package/ios/SpotifySDK/SpotifyiOS.xcframework/ios-arm64/SpotifyiOS.framework/PrivacyInfo.xcprivacy

@@ -0,0 +1,14 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>NSPrivacyCollectedDataTypes</key>
+	<array/>
+	<key>NSPrivacyAccessedAPITypes</key>
+	<array/>
+	<key>NSPrivacyTrackingDomains</key>
+	<array/>
+	<key>NSPrivacyTracking</key>
+	<false/>
+</dict>
+</plist>

package/ios/SpotifySDK/SpotifyiOS.xcframework/ios-arm64_x86_64-simulator/SpotifyiOS.framework/Headers/SPTAppRemote.h

@@ -166,24 +166,26 @@ typedef NS_ENUM(NSUInteger, SPTAppRemoteLogLevel) {
  * The passed URI will start playing unless Spotify is already playing.
  *
  * @param URI The URI to play. Use a blank string to attempt to play the user's last song
+ * @param completionHandler `YES` if the Spotify app is installed and an authorization attempt can be made, otherwise `NO`.
  *
- * @return `YES` if the Spotify app is installed and an authorization attempt can be made, otherwise `NO`.
  * Note: The return `BOOL` here is not a measure of whether or not authentication succeeded, only a check if
  * the Spotify app is installed and can attempt to handle the authorization request.
  */
-- (BOOL)authorizeAndPlayURI:(NSString *)URI;
+- (void)authorizeAndPlayURI:(NSString *)URI completionHandler:(void (^ __nullable)(BOOL success))completionHandler;
 
 /**
  * Open Spotify app to obtain access token and start playback.
  *
  * @param playURI The URI to play. Use a blank string to attempt to play the user's last song
  * @param asRadio `YES` to start radio for the given URI.
+ * @param completionHandler `YES` if the Spotify app is installed and an authorization attempt can be made, otherwise `NO`.
  *
- * @return `YES` if the Spotify app is installed and an authorization attempt can be made, otherwise `NO`.
  * Note: The return `BOOL` here is not a measure of whether or not authentication succeeded, only a check if
  * the Spotify app is installed and can attempt to handle the authorization request.
  */
-- (BOOL)authorizeAndPlayURI:(NSString *)playURI asRadio:(BOOL)asRadio;
+- (void)authorizeAndPlayURI:(NSString *)playURI
+                    asRadio:(BOOL)asRadio
+          completionHandler:(void (^ __nullable)(BOOL success))completionHandler;
 
 /**
 * Open Spotify app to obtain access token and start playback.
@@ -191,14 +193,15 @@ typedef NS_ENUM(NSUInteger, SPTAppRemoteLogLevel) {
 * @param playURI The URI to play. Use a blank string to attempt to play the user's last song
 * @param asRadio `YES` to start radio for the given URI.
 * @param additionalScopes An array of scopes in addition to `app-remote-control`. Can be nil if you only need `app-remote-control`
+* @param completionHandler `YES` if the Spotify app is installed and an authorization attempt can be made, otherwise `NO`.
 *
-* @return `YES` if the Spotify app is installed and an authorization attempt can be made, otherwise `NO`.
 * Note: The return `BOOL` here is not a measure of whether or not authentication succeeded, only a check if
 * the Spotify app is installed and can attempt to handle the authorization request.
 */
-- (BOOL)authorizeAndPlayURI:(NSString *)playURI
+- (void)authorizeAndPlayURI:(NSString *)playURI
                     asRadio:(BOOL)asRadio
-           additionalScopes:(nullable NSArray<NSString *> *)additionalScopes;
+           additionalScopes:(nullable NSArray<NSString *> *)additionalScopes
+          completionHandler:(void (^ __nullable)(BOOL success))completionHandler;
 
 /**
  * Open Spotify app to obtain access token and start playback.
@@ -209,15 +212,16 @@ typedef NS_ENUM(NSUInteger, SPTAppRemoteLogLevel) {
  * @param sessionIdentifier An optional unique identifier for this specific session, which is used for analytics purposes. Every new attempt to
  * connect to the Spotify app should have a new identifier, but the identifier used here should then be reused for the accompanied call to
  * `connectWithSessionIdentifier:`.
+ * @param completionHandler `YES` if the Spotify app is installed and an authorization attempt can be made, otherwise `NO`.
  *
- * @return `YES` if the Spotify app is installed and an authorization attempt can be made, otherwise `NO`.
  * Note: The return `BOOL` here is not a measure of whether or not authentication succeeded, only a check if
  * the Spotify app is installed and can attempt to handle the authorization request.
 */
-- (BOOL)authorizeAndPlayURI:(NSString *)playURI
+- (void)authorizeAndPlayURI:(NSString *)playURI
                     asRadio:(BOOL)asRadio
            additionalScopes:(nullable NSArray<NSString *> *)additionalScopes
-          sessionIdentifier:(nullable NSUUID *)sessionIdentifier;
+          sessionIdentifier:(nullable NSUUID *)sessionIdentifier
+          completionHandler:(void (^ __nullable)(BOOL success))completionHandler;
 /**
  * Parse out an access token or error description from a url passed to application:openURL:options:
  *

package/ios/SpotifySDK/SpotifyiOS.xcframework/ios-arm64_x86_64-simulator/SpotifyiOS.framework/Headers/SPTAppRemoteContentItem.h

@@ -33,6 +33,9 @@ NS_ASSUME_NONNULL_BEGIN
 /// Returns `YES` if the item is expected to contain children, otherwise `NO`.
 @property (nonatomic, assign, readonly, getter=isContainer) BOOL container;
 
+/// Returns `YES` if the item is pinned in Your Library, otherwise `NO`. 
+@property (nonatomic, assign, readonly, getter=isPinned) BOOL pinnned;
+
 /**
  A list of the content item's children.