@wwdrew/expo-spotify-sdk 0.3.0 → 0.4.0

package/README.md

@@ -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 generally 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/build/ExpoSpotifySDK.types.d.ts

@@ -2,14 +2,12 @@ export interface SpotifySession {
     accessToken: string;
     refreshToken: string;
     expirationDate: number;
-    isExpired: boolean;
     scopes: SpotifyScope[];
 }
 export interface SpotifyConfig {
     scopes: SpotifyScope[];
     tokenSwapURL?: string;
     tokenRefreshURL?: string;
-    shouldRequestAccessToken?: boolean;
 }
 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";
 //# 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,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;IACzB,wBAAwB,CAAC,EAAE,OAAO,CAAC;CACpC;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  shouldRequestAccessToken?: boolean;\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

@@ -2,44 +2,36 @@ import ExpoModulesCore
 import SpotifyiOS
 
 public class ExpoSpotifySDKModule: Module {
-    
+
     public func definition() -> ModuleDefinition {
-        
+
         let spotifySession = ExpoSpotifySessionManager.shared
-        
+
         Name("ExpoSpotifySDK")
-        
+
         Function("isAvailable") {
             return spotifySession.spotifyAppInstalled()
         }
-        
+
         AsyncFunction("authenticateAsync") { (config: [String: Any], promise: Promise) in
             guard let scopes = config["scopes"] as? [String] else {
                 promise.reject("INVALID_CONFIG", "Invalid SpotifyConfig object")
                 return
             }
-            
+
             let tokenSwapURL = config["tokenSwapURL"] as? String
             let tokenRefreshURL = config["tokenRefreshURL"] as? String
-            let shouldRequestAccessToken = config["shouldRequestAccessToken"] as? Bool ?? true
-            
-            spotifySession.authenticate(scopes: scopes, tokenSwapURL: tokenSwapURL, tokenRefreshURL: tokenRefreshURL, shouldRequestAccessToken: shouldRequestAccessToken).done { result in
-                switch result {
-                case .session(let session):
-                    promise.resolve([
-                        "accessToken": session.accessToken,
-                        "refreshToken": session.refreshToken,
-                        "expirationDate": Int(session.expirationDate.timeIntervalSince1970 * 1000),
-                        "scopes": SPTScopeSerializer.serializeScopes(session.scope),
-                        "isExpired": session.isExpired
-                    ])
-                case .authorizationCode(let code):
-                    promise.resolve(["code": code])
-                }
+
+            spotifySession.authenticate(scopes: scopes, tokenSwapURL: tokenSwapURL, tokenRefreshURL: tokenRefreshURL).done { session in
+                promise.resolve([
+                    "accessToken": session.accessToken,
+                    "refreshToken": session.refreshToken,
+                    "expirationDate": Int(session.expirationDate.timeIntervalSince1970 * 1000),
+                    "scopes": SPTScopeSerializer.serializeScopes(session.scope)
+                ])
             }.catch { error in
                 promise.reject(error)
             }
         }
-        
     }
 }

package/ios/ExpoSpotifySessionManager+SessionManagerDelegate.swift

@@ -3,9 +3,7 @@ import SpotifyiOS
 
 extension ExpoSpotifySessionManager: SPTSessionManagerDelegate {
     public func sessionManager(manager _: SPTSessionManager, didInitiate session: SPTSession) {
-        if shouldRequestAccessToken {
-            authPromiseSeal?.fulfill(AuthenticationResult.session(session))
-        }
+        authPromiseSeal?.fulfill(session)
     }
     
     public func sessionManager(manager _: SPTSessionManager, didFailWith error: Error) {
@@ -13,14 +11,6 @@ extension ExpoSpotifySessionManager: SPTSessionManagerDelegate {
     }
     
     public func sessionManager(manager _: SPTSessionManager, didRenew session: SPTSession) {
-        authPromiseSeal?.fulfill(AuthenticationResult.session(session))
-    }
-    
-    public func sessionManager(manager: SPTSessionManager, shouldRequestAccessTokenWith code: String) -> Bool {
-        if !shouldRequestAccessToken {
-            authPromiseSeal?.fulfill(AuthenticationResult.authorizationCode(code))
-        }
-        
-        return shouldRequestAccessToken
+        authPromiseSeal?.fulfill(session)
     }
 }

package/ios/ExpoSpotifySessionManager.swift

@@ -2,11 +2,6 @@ import ExpoModulesCore
 import SpotifyiOS
 import PromiseKit
 
-enum AuthenticationResult {
-    case session(SPTSession)
-    case authorizationCode(String)
-}
-
 enum SessionManagerError: Error {
     case notInitialized
     case invalidConfiguration
@@ -14,12 +9,10 @@ enum SessionManagerError: Error {
 
 final class ExpoSpotifySessionManager: NSObject {
     weak var module: ExpoSpotifySDKModule?
-    var authPromiseSeal: Resolver<AuthenticationResult>?
-    
-    var shouldRequestAccessToken: Bool = true
-    
+    var authPromiseSeal: Resolver<SPTSession>?
+
     static let shared = ExpoSpotifySessionManager()
-    
+
     private var expoSpotifyConfiguration: ExpoSpotifyConfiguration? {
         guard let expoSpotifySdkDict = Bundle.main.object(forInfoDictionaryKey: "ExpoSpotifySDK") as? [String: String],
               let clientID = expoSpotifySdkDict["clientID"],
@@ -28,71 +21,70 @@ final class ExpoSpotifySessionManager: NSObject {
         {
             return nil
         }
-        
+
         return ExpoSpotifyConfiguration(clientID: clientID, host: host, scheme: scheme)
     }
-    
+
     lazy var configuration: SPTConfiguration? = {
         guard let clientID = expoSpotifyConfiguration?.clientID,
               let redirectURL = expoSpotifyConfiguration?.redirectURL else {
             NSLog("Invalid Spotify configuration")
             return nil
         }
-        
+
         return SPTConfiguration(clientID: clientID, redirectURL: redirectURL)
     }()
-    
+
     lazy var sessionManager: SPTSessionManager? = {
         guard let configuration = configuration else {
             return nil
         }
-        
+
         return SPTSessionManager(configuration: configuration, delegate: self)
     }()
-    
-    
-    func authenticate(scopes: [String], tokenSwapURL: String?, tokenRefreshURL: String?, shouldRequestAccessToken: Bool = true) -> PromiseKit.Promise<AuthenticationResult> {
+
+
+    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
             }
-            let configuration = SPTConfiguration(clientID: clientID, redirectURL: redirectURL)
             
+            let configuration = SPTConfiguration(clientID: clientID, redirectURL: redirectURL)
+
             if (tokenSwapURL != nil) {
                 configuration.tokenSwapURL = URL(string: tokenSwapURL ?? "")
             }
-            
+
             if (tokenRefreshURL != nil) {
                 configuration.tokenRefreshURL = URL(string: tokenRefreshURL ?? "")
             }
-            
-            self.shouldRequestAccessToken = shouldRequestAccessToken
+
+            self.authPromiseSeal = seal
             self.configuration = configuration
             self.sessionManager = SPTSessionManager(configuration: configuration, delegate: self)
-            
-            self.authPromiseSeal = seal
-            
+
             DispatchQueue.main.sync {
-                sessionManager?.initiateSession(with: SPTScopeSerializer.deserializeScopes(scopes), options: .default)
+                sessionManager?.initiateSession(with: SPTScopeSerializer.deserializeScopes(scopes), options: .default, campaign: nil)
             }
         }
     }
-    
+
     func spotifyAppInstalled() -> Bool {
         guard let sessionManager = sessionManager else {
             NSLog("SPTSessionManager not initialized")
             return false
         }
-        
+
         var isInstalled = false
-        
+
         DispatchQueue.main.sync {
             isInstalled = sessionManager.isSpotifyAppInstalled
         }
-        
+
         return isInstalled
     }
 }

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.
 

package/ios/SpotifySDK/SpotifyiOS.xcframework/ios-arm64_x86_64-simulator/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_x86_64-simulator/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_x86_64-simulator/SpotifyiOS.framework/Modules/module.modulemap

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