soundcloud-api-ts 1.11.1 → 1.12.0

package/dist/{chunk-DGZEPXIQ.mjs → chunk-JLRQJWU5.mjs}

@@ -15,7 +15,7 @@ function getRetryDelay(response, attempt, config) {
     const retryAfter = response.headers.get("retry-after");
     if (retryAfter) {
       const seconds = Number(retryAfter);
-      if (!Number.isNaN(seconds)) return seconds * 1e3;
+      if (!Number.isNaN(seconds)) return Math.min(seconds * 1e3, 6e4);
     }
   }
   const base = config.retryBaseDelay * Math.pow(2, attempt);
@@ -91,9 +91,26 @@ async function scFetch(options, refreshCtx, onRequest) {
         return void 0;
       }
       if (response.ok) {
-        const result = response.json();
+        const data = await response.json();
+        if (typeof data === "object" && data !== null) {
+          const metaHeaders = {};
+          if (typeof response.headers.forEach === "function") {
+            response.headers.forEach((value, key) => {
+              metaHeaders[key] = value;
+            });
+          }
+          try {
+            Object.defineProperty(data, "_meta", {
+              value: { status: response.status, headers: metaHeaders },
+              enumerable: false,
+              configurable: true,
+              writable: true
+            });
+          } catch {
+          }
+        }
         emitTelemetry();
-        return result;
+        return data;
       }
       if (!isRetryable(response.status)) {
         const body2 = await parseErrorBody(response);
@@ -108,6 +125,13 @@ async function scFetch(options, refreshCtx, onRequest) {
         retryConfig.onDebug?.(
           `Retry ${attempt + 1}/${retryConfig.maxRetries} after ${Math.round(delayMs)}ms (status ${response.status})`
         );
+        retryConfig.onRetry?.({
+          attempt: retryCount,
+          delayMs,
+          reason: `${response.status} ${response.statusText}`,
+          status: response.status,
+          url
+        });
         await delay(delayMs);
       }
     }
@@ -161,9 +185,26 @@ async function scFetchUrl(url, token, retryConfig, onRequest) {
       return void 0;
     }
     if (response.ok) {
-      const result = response.json();
+      const data = await response.json();
+      if (typeof data === "object" && data !== null) {
+        const metaHeaders = {};
+        if (typeof response.headers.forEach === "function") {
+          response.headers.forEach((value, key) => {
+            metaHeaders[key] = value;
+          });
+        }
+        try {
+          Object.defineProperty(data, "_meta", {
+            value: { status: response.status, headers: metaHeaders },
+            enumerable: false,
+            configurable: true,
+            writable: true
+          });
+        } catch {
+        }
+      }
       emitTelemetry();
-      return result;
+      return data;
     }
     if (!isRetryable(response.status)) {
       const body2 = await parseErrorBody(response);
@@ -178,6 +219,13 @@ async function scFetchUrl(url, token, retryConfig, onRequest) {
       config.onDebug?.(
         `Retry ${attempt + 1}/${config.maxRetries} after ${Math.round(delayMs)}ms (status ${response.status})`
       );
+      config.onRetry?.({
+        attempt: retryCount,
+        delayMs,
+        reason: `${response.status} ${response.statusText}`,
+        status: response.status,
+        url
+      });
       await delay(delayMs);
     }
   }
@@ -215,6 +263,96 @@ async function fetchAll(firstPage, fetchNext, options) {
   return result;
 }
 
+// src/client/raw.ts
+var RawClient = class {
+  constructor(baseUrl, getToken, fetchFn) {
+    this.baseUrl = baseUrl;
+    this.getToken = getToken;
+    this.fetchFn = fetchFn;
+  }
+  /**
+   * Make a raw HTTP request. Path template placeholders like `{id}` are substituted
+   * from matching keys in `query` before the remaining query params are appended to
+   * the URL as search parameters.
+   */
+  async request({
+    method,
+    path,
+    query,
+    body,
+    token
+  }) {
+    let resolvedPath = path;
+    const remainingQuery = {};
+    if (query) {
+      for (const [key, value] of Object.entries(query)) {
+        if (value === void 0) continue;
+        const placeholder = `{${key}}`;
+        if (resolvedPath.includes(placeholder)) {
+          resolvedPath = resolvedPath.replace(new RegExp(`\\{${key}\\}`, "g"), String(value));
+        } else {
+          remainingQuery[key] = String(value);
+        }
+      }
+    }
+    const fullUrl = resolvedPath.startsWith("http") ? new URL(resolvedPath) : new URL(resolvedPath, this.baseUrl);
+    for (const [key, value] of Object.entries(remainingQuery)) {
+      fullUrl.searchParams.set(key, value);
+    }
+    const headers = {
+      Accept: "application/json"
+    };
+    const authToken = token ?? this.getToken();
+    if (authToken) {
+      headers["Authorization"] = `OAuth ${authToken}`;
+    }
+    let fetchBody;
+    if (body !== void 0) {
+      headers["Content-Type"] = "application/json";
+      fetchBody = JSON.stringify(body);
+    }
+    const response = await this.fetchFn(fullUrl.toString(), {
+      method,
+      headers,
+      body: fetchBody
+    });
+    const responseHeaders = {};
+    if (typeof response.headers.forEach === "function") {
+      response.headers.forEach((value, key) => {
+        responseHeaders[key] = value;
+      });
+    }
+    let data;
+    const contentLength = response.headers.get("content-length");
+    if (response.status === 204 || contentLength === "0") {
+      data = void 0;
+    } else {
+      try {
+        data = await response.json();
+      } catch {
+        data = void 0;
+      }
+    }
+    return { data, status: response.status, headers: responseHeaders };
+  }
+  /** GET shorthand */
+  get(path, params) {
+    return this.request({ method: "GET", path, query: params });
+  }
+  /** POST shorthand */
+  post(path, body) {
+    return this.request({ method: "POST", path, body });
+  }
+  /** PUT shorthand */
+  put(path, body) {
+    return this.request({ method: "PUT", path, body });
+  }
+  /** DELETE shorthand */
+  delete(path) {
+    return this.request({ method: "DELETE", path });
+  }
+};
+
 // src/client/SoundCloudClient.ts
 function resolveToken(tokenGetter, explicit) {
   const t = explicit ?? tokenGetter();
@@ -243,6 +381,8 @@ var SoundCloudClient = class _SoundCloudClient {
   likes;
   /** Repost/unrepost actions (/reposts) */
   reposts;
+  /** Low-level raw HTTP client — returns status/headers without throwing on non-2xx */
+  raw;
   /**
    * Creates a new SoundCloudClient instance.
    *
@@ -254,7 +394,8 @@ var SoundCloudClient = class _SoundCloudClient {
     const retryConfig = {
       maxRetries: config.maxRetries ?? 3,
       retryBaseDelay: config.retryBaseDelay ?? 1e3,
-      onDebug: config.onDebug
+      onDebug: config.onDebug,
+      onRetry: config.onRetry
     };
     const refreshCtx = config.onTokenRefresh ? {
       getToken,
@@ -283,6 +424,7 @@ var SoundCloudClient = class _SoundCloudClient {
     this.resolve = new _SoundCloudClient.Resolve(getToken, refreshCtx);
     this.likes = new _SoundCloudClient.Likes(getToken, refreshCtx);
     this.reposts = new _SoundCloudClient.Reposts(getToken, refreshCtx);
+    this.raw = new RawClient("https://api.soundcloud.com", getToken, config.fetch ?? globalThis.fetch);
   }
   /**
    * Store an access token (and optionally refresh token) on this client instance.
@@ -417,13 +559,17 @@ var 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");
       return this.fetch({
         path: "/oauth/token",
         method: "POST",
+        headers: {
+          Authorization: `Basic ${basicAuth}`
+        },
         body: new URLSearchParams({
-          grant_type: "client_credentials",
-          client_id: this.config.clientId,
-          client_secret: this.config.clientSecret
+          grant_type: "client_credentials"
         })
       });
     }
@@ -1452,6 +1598,89 @@ var SoundCloudClient = class _SoundCloudClient {
   SoundCloudClient2.Reposts = Reposts;
 })(SoundCloudClient || (SoundCloudClient = {}));
 
+// src/client/dedupe.ts
+var InFlightDeduper = class {
+  inFlight = /* @__PURE__ */ new Map();
+  /**
+   * Return an existing in-flight promise for `key`, or start a new one via `factory`.
+   * The entry is removed from the map once the promise settles (resolve or reject).
+   */
+  add(key, factory) {
+    const existing = this.inFlight.get(key);
+    if (existing) return existing;
+    const promise = factory().finally(() => {
+      this.inFlight.delete(key);
+    });
+    this.inFlight.set(key, promise);
+    return promise;
+  }
+  /** Number of currently in-flight requests */
+  get size() {
+    return this.inFlight.size;
+  }
+};
+
+// src/client/registry.ts
+var IMPLEMENTED_OPERATIONS = [
+  // Auth
+  "post_oauth2_token",
+  "delete_oauth2_token",
+  // Me
+  "get_me",
+  "get_me_activities",
+  "get_me_activities_own",
+  "get_me_activities_tracks",
+  "get_me_likes_tracks",
+  "get_me_likes_playlists",
+  "get_me_followings",
+  "get_me_followings_tracks",
+  "post_me_followings_user_id",
+  "delete_me_followings_user_id",
+  "get_me_followers",
+  "get_me_playlists",
+  "get_me_tracks",
+  // Users
+  "get_users_user_id",
+  "get_users_user_id_followers",
+  "get_users_user_id_followings",
+  "get_users_user_id_tracks",
+  "get_users_user_id_playlists",
+  "get_users_user_id_likes_tracks",
+  "get_users_user_id_likes_playlists",
+  "get_users_user_id_web_profiles",
+  // Tracks
+  "get_tracks_track_id",
+  "put_tracks_track_id",
+  "delete_tracks_track_id",
+  "get_tracks_track_id_comments",
+  "post_tracks_track_id_comments",
+  "get_tracks_track_id_likes",
+  "get_tracks_track_id_reposts",
+  "get_tracks_track_id_related",
+  "get_tracks_track_id_streams",
+  "post_likes_tracks_track_id",
+  "delete_likes_tracks_track_id",
+  "post_reposts_tracks_track_id",
+  "delete_reposts_tracks_track_id",
+  // Playlists
+  "get_playlists_playlist_id",
+  "post_playlists",
+  "put_playlists_playlist_id",
+  "delete_playlists_playlist_id",
+  "get_playlists_playlist_id_tracks",
+  "get_playlists_playlist_id_reposts",
+  "post_likes_playlists_playlist_id",
+  "delete_likes_playlists_playlist_id",
+  "post_reposts_playlists_playlist_id",
+  "delete_reposts_playlists_playlist_id",
+  // Search
+  "get_tracks",
+  "get_users",
+  "get_playlists",
+  // Resolve
+  "get_resolve"
+];
+
 // src/auth/getClientToken.ts
 var getClientToken = (clientId, clientSecret) => {
   const basicAuth = Buffer.from(`${clientId}:${clientSecret}`).toString("base64");
@@ -1744,6 +1973,6 @@ var unrepostPlaylist = async (token, playlistId) => {
 // src/utils/widget.ts
 var getSoundCloudWidgetUrl = (trackId) => `https%3A//api.soundcloud.com/tracks/${trackId}&show_teaser=false&color=%2300a99d&inverse=false&show_user=false&sharing=false&buying=false&liking=false&show_artwork=false&show_name=false`;
 
-export { SoundCloudClient, createPlaylist, createTrackComment, deletePlaylist, deleteTrack, fetchAll, followUser, generateCodeChallenge, generateCodeVerifier, getAuthorizationUrl, getClientToken, getFollowers, getFollowings, getMe, getMeActivities, getMeActivitiesOwn, getMeActivitiesTracks, getMeFollowers, getMeFollowings, getMeFollowingsTracks, getMeLikesPlaylists, getMeLikesTracks, getMePlaylists, getMeTracks, getPlaylist, getPlaylistReposts, getPlaylistTracks, getRelatedTracks, getSoundCloudWidgetUrl, getTrack, getTrackComments, getTrackLikes, getTrackReposts, getTrackStreams, getUser, getUserLikesPlaylists, getUserLikesTracks, getUserPlaylists, getUserToken, getUserTracks, getUserWebProfiles, likePlaylist, likeTrack, paginate, paginateItems, refreshUserToken, repostPlaylist, repostTrack, resolveUrl, scFetch, scFetchUrl, searchPlaylists, searchTracks, searchUsers, signOut, unfollowUser, unlikePlaylist, unlikeTrack, unrepostPlaylist, unrepostTrack, updatePlaylist, updateTrack };
-//# sourceMappingURL=chunk-DGZEPXIQ.mjs.map
-//# sourceMappingURL=chunk-DGZEPXIQ.mjs.map
+export { IMPLEMENTED_OPERATIONS, InFlightDeduper, RawClient, SoundCloudClient, createPlaylist, createTrackComment, deletePlaylist, deleteTrack, fetchAll, followUser, generateCodeChallenge, generateCodeVerifier, getAuthorizationUrl, getClientToken, getFollowers, getFollowings, getMe, getMeActivities, getMeActivitiesOwn, getMeActivitiesTracks, getMeFollowers, getMeFollowings, getMeFollowingsTracks, getMeLikesPlaylists, getMeLikesTracks, getMePlaylists, getMeTracks, getPlaylist, getPlaylistReposts, getPlaylistTracks, getRelatedTracks, getSoundCloudWidgetUrl, getTrack, getTrackComments, getTrackLikes, getTrackReposts, getTrackStreams, getUser, getUserLikesPlaylists, getUserLikesTracks, getUserPlaylists, getUserToken, getUserTracks, getUserWebProfiles, likePlaylist, likeTrack, paginate, paginateItems, refreshUserToken, repostPlaylist, repostTrack, resolveUrl, scFetch, scFetchUrl, searchPlaylists, searchTracks, searchUsers, signOut, unfollowUser, unlikePlaylist, unlikeTrack, unrepostPlaylist, unrepostTrack, updatePlaylist, updateTrack };
+//# sourceMappingURL=chunk-JLRQJWU5.mjs.map
+//# sourceMappingURL=chunk-JLRQJWU5.mjs.map