soundcloud-api-ts 1.12.0 → 1.13.1

package/dist/{chunk-D7AF372V.js → chunk-RS2J5LTS.js}

@@ -355,6 +355,14 @@ var RawClient = class {
   }
 };
 
+// src/utils/base64.ts
+var toBase64 = (value) => {
+  if (typeof Buffer !== "undefined") {
+    return Buffer.from(value).toString("base64");
+  }
+  return btoa(value);
+};
+
 // src/client/SoundCloudClient.ts
 function resolveToken(tokenGetter, explicit) {
   const t = explicit ?? tokenGetter();
@@ -561,9 +569,7 @@ exports.SoundCloudClient = class _SoundCloudClient {
      * @see https://developers.soundcloud.com/docs/api/explorer/open-api#/oauth2/post_oauth2_token
      */
     async getClientToken() {
-      const basicAuth = Buffer.from(
-        `${this.config.clientId}:${this.config.clientSecret}`
-      ).toString("base64");
+      const basicAuth = toBase64(`${this.config.clientId}:${this.config.clientSecret}`);
       return this.fetch({
         path: "/oauth/token",
         method: "POST",
@@ -622,13 +628,15 @@ exports.SoundCloudClient = class _SoundCloudClient {
      * @see https://developers.soundcloud.com/docs/api/explorer/open-api#/oauth2/post_oauth2_token
      */
     async refreshUserToken(refreshToken) {
+      const basicAuth = toBase64(`${this.config.clientId}:${this.config.clientSecret}`);
       return this.fetch({
         path: "/oauth/token",
         method: "POST",
+        headers: {
+          Authorization: `Basic ${basicAuth}`
+        },
         body: new URLSearchParams({
           grant_type: "refresh_token",
-          client_id: this.config.clientId,
-          client_secret: this.config.clientSecret,
           redirect_uri: this.config.redirectUri,
           refresh_token: refreshToken
         })
@@ -874,6 +882,27 @@ exports.SoundCloudClient = class _SoundCloudClient {
       const t = resolveToken(this.getToken, options?.token);
       return this.fetch({ path: `/me/tracks?${limit ? `limit=${limit}&` : ""}linked_partitioning=true`, method: "GET", token: t });
     }
+    /**
+     * List the authenticated user's connected external social accounts.
+     *
+     * @param options - Optional token override
+     * @returns Array of connection objects for linked social services (Twitter, Facebook, etc.)
+     * @throws {SoundCloudError} When the API returns an error
+     *
+     * @remarks This endpoint may require elevated API access or app approval.
+     *
+     * @example
+     * ```ts
+     * const connections = await sc.me.getConnections();
+     * connections.forEach(c => console.log(c.service, c.display_name));
+     * ```
+     *
+     * @see https://developers.soundcloud.com/docs/api/explorer/open-api#/me/get_me_connections
+     */
+    async getConnections(options) {
+      const t = resolveToken(this.getToken, options?.token);
+      return this.fetch({ path: "/me/connections", method: "GET", token: t });
+    }
   }
   SoundCloudClient2.Me = Me;
   class Users {
@@ -1045,6 +1074,34 @@ exports.SoundCloudClient = class _SoundCloudClient {
       const t = resolveToken(this.getToken, options?.token);
       return this.fetch({ path: `/tracks/${trackId}`, method: "GET", token: t });
     }
+    /**
+     * Fetch multiple tracks by their IDs in a single request.
+     *
+     * @param ids - Array of track IDs (numeric or string URNs)
+     * @param options - Optional token override
+     * @returns Array of track objects (may be shorter than `ids` if some tracks are unavailable)
+     * @throws {SoundCloudError} When the API returns an error
+     * @throws {Error} When more than 200 IDs are provided
+     *
+     * @remarks
+     * SoundCloud's API likely caps at ~200 IDs per request. Passing more than 200 IDs
+     * will throw immediately without making a network request.
+     *
+     * @example
+     * ```ts
+     * const tracks = await sc.tracks.getTracks([123456, 234567, 345678]);
+     * tracks.forEach(t => console.log(t.title));
+     * ```
+     *
+     * @see https://developers.soundcloud.com/docs/api/explorer/open-api#/tracks/get_tracks
+     */
+    async getTracks(ids, options) {
+      if (ids.length > 200) {
+        throw new Error("getTracks: SoundCloud API supports a maximum of 200 IDs per request");
+      }
+      const t = resolveToken(this.getToken, options?.token);
+      return this.fetch({ path: `/tracks?ids=${ids.join(",")}`, method: "GET", token: t });
+    }
     /**
      * Get stream URLs for a track.
      *
@@ -1641,6 +1698,7 @@ var IMPLEMENTED_OPERATIONS = [
   "get_me_followers",
   "get_me_playlists",
   "get_me_tracks",
+  "get_me_connections",
   // Users
   "get_users_user_id",
   "get_users_user_id_followers",
@@ -1685,7 +1743,7 @@ var IMPLEMENTED_OPERATIONS = [
 
 // src/auth/getClientToken.ts
 var getClientToken = (clientId, clientSecret) => {
-  const basicAuth = Buffer.from(`${clientId}:${clientSecret}`).toString("base64");
+  const basicAuth = toBase64(`${clientId}:${clientSecret}`);
   return scFetch({
     path: "/oauth/token",
     method: "POST",
@@ -1717,13 +1775,15 @@ var getUserToken = (clientId, clientSecret, redirectUri, code, codeVerifier) =>
 
 // src/auth/refreshUserToken.ts
 var refreshUserToken = (clientId, clientSecret, redirectUri, refreshToken) => {
+  const basicAuth = toBase64(`${clientId}:${clientSecret}`);
   return scFetch({
     path: "/oauth/token",
     method: "POST",
+    headers: {
+      Authorization: `Basic ${basicAuth}`
+    },
     body: new URLSearchParams({
       grant_type: "refresh_token",
-      client_id: clientId,
-      client_secret: clientSecret,
       redirect_uri: redirectUri,
       refresh_token: refreshToken
     })
@@ -1802,6 +1862,18 @@ var getUserWebProfiles = (token, userId) => scFetch({ path: `/users/${userId}/we
 // src/tracks/getTrack.ts
 var getTrack = (token, trackId) => scFetch({ path: `/tracks/${trackId}`, method: "GET", token });
 
+// src/tracks/getTracks.ts
+var getTracks = (token, ids) => {
+  if (ids.length > 200) {
+    throw new Error("getTracks: SoundCloud API supports a maximum of 200 IDs per request");
+  }
+  return scFetch({
+    path: `/tracks?ids=${ids.join(",")}`,
+    method: "GET",
+    token
+  });
+};
+
 // src/tracks/getComments.ts
 var getTrackComments = (token, trackId, limit) => scFetch({ path: `/tracks/${trackId}/comments?threaded=1&filter_replies=0${limit ? `&limit=${limit}` : ""}&linked_partitioning=true`, method: "GET", token });
 
@@ -1920,6 +1992,9 @@ var getMePlaylists = (token, limit) => scFetch({ path: `/me/playlists?${limit ?
 // src/me/tracks.ts
 var getMeTracks = (token, limit) => scFetch({ path: `/me/tracks?${limit ? `limit=${limit}&` : ""}linked_partitioning=true`, method: "GET", token });
 
+// src/me/connections.ts
+var getMeConnections = (token) => scFetch({ path: "/me/connections", method: "GET", token });
+
 // src/likes/index.ts
 var likePlaylist = async (token, playlistId) => {
   try {
@@ -1994,6 +2069,7 @@ exports.getMe = getMe;
 exports.getMeActivities = getMeActivities;
 exports.getMeActivitiesOwn = getMeActivitiesOwn;
 exports.getMeActivitiesTracks = getMeActivitiesTracks;
+exports.getMeConnections = getMeConnections;
 exports.getMeFollowers = getMeFollowers;
 exports.getMeFollowings = getMeFollowings;
 exports.getMeFollowingsTracks = getMeFollowingsTracks;
@@ -2011,6 +2087,7 @@ exports.getTrackComments = getTrackComments;
 exports.getTrackLikes = getTrackLikes;
 exports.getTrackReposts = getTrackReposts;
 exports.getTrackStreams = getTrackStreams;
+exports.getTracks = getTracks;
 exports.getUser = getUser;
 exports.getUserLikesPlaylists = getUserLikesPlaylists;
 exports.getUserLikesTracks = getUserLikesTracks;
@@ -2039,5 +2116,5 @@ exports.unrepostPlaylist = unrepostPlaylist;
 exports.unrepostTrack = unrepostTrack;
 exports.updatePlaylist = updatePlaylist;
 exports.updateTrack = updateTrack;
-//# sourceMappingURL=chunk-D7AF372V.js.map
-//# sourceMappingURL=chunk-D7AF372V.js.map
+//# sourceMappingURL=chunk-RS2J5LTS.js.map
+//# sourceMappingURL=chunk-RS2J5LTS.js.map