soundcloud-api-ts 1.13.3 → 1.14.0

package/dist/index.d.ts

@@ -1,6 +1,84 @@
 import { S as SoundCloudTrack, a as SoundCloudPlaylist, b as SoundCloudToken, c as SoundCloudPaginatedResponse, d as SoundCloudMe, e as SoundCloudActivitiesResponse, f as SoundCloudUser, g as SoundCloudConnection, h as SoundCloudWebProfile, i as SoundCloudStreams, j as SoundCloudComment } from './index-DX6Anc1-.js';
 export { k as SoundCloudActivity, l as SoundCloudCommentUser, m as SoundCloudError, n as SoundCloudQuota, o as SoundCloudSubscription, p as SoundCloudSubscriptionProduct } from './index-DX6Anc1-.js';
 
+/**
+ * Deduplicates concurrent in-flight requests with the same key.
+ *
+ * When multiple callers request the same resource simultaneously,
+ * only one underlying promise is created — all callers share the result.
+ * The key is cleaned up automatically once the promise settles.
+ *
+ * @example
+ * ```ts
+ * const deduper = new InFlightDeduper();
+ *
+ * // Both calls share a single fetch:
+ * const [a, b] = await Promise.all([
+ *   deduper.add('track:123', () => fetchTrack(123)),
+ *   deduper.add('track:123', () => fetchTrack(123)),
+ * ]);
+ * // a === b (same resolved value)
+ * ```
+ */
+declare class InFlightDeduper {
+    private inFlight;
+    /**
+     * 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<T>(key: string, factory: () => Promise<T>): Promise<T>;
+    /** Number of currently in-flight requests */
+    get size(): number;
+}
+
+/**
+ * A cache entry with an expiration timestamp.
+ */
+interface SoundCloudCacheEntry<T> {
+    /** The cached value */
+    value: T;
+    /** Unix timestamp (ms) when this entry expires */
+    expiresAt: number;
+}
+/**
+ * Cache interface for SoundCloud API responses.
+ *
+ * Implement this interface to plug in any caching backend (in-memory, Redis, etc.).
+ * Pass an instance as `cache` in {@link SoundCloudClientConfig} to enable caching.
+ *
+ * @example
+ * ```ts
+ * // Simple in-memory implementation
+ * class SimpleCache implements SoundCloudCache {
+ *   private store = new Map<string, SoundCloudCacheEntry<unknown>>();
+ *
+ *   get<T>(key: string): T | undefined {
+ *     const entry = this.store.get(key) as SoundCloudCacheEntry<T> | undefined;
+ *     if (!entry || Date.now() > entry.expiresAt) return undefined;
+ *     return entry.value;
+ *   }
+ *
+ *   set<T>(key: string, value: T, { ttlMs }: { ttlMs: number }): void {
+ *     this.store.set(key, { value, expiresAt: Date.now() + ttlMs });
+ *   }
+ *
+ *   delete(key: string): void {
+ *     this.store.delete(key);
+ *   }
+ * }
+ * ```
+ */
+interface SoundCloudCache {
+    /** Retrieve a cached value by key, or `undefined` if missing or expired */
+    get<T>(key: string): Promise<T | undefined> | T | undefined;
+    /** Store a value with a TTL in milliseconds */
+    set<T>(key: string, value: T, options: {
+        ttlMs: number;
+    }): Promise<void> | void;
+    /** Remove a cached entry */
+    delete(key: string): Promise<void> | void;
+}
+
 /**
  * Options for making a request to the SoundCloud API via {@link scFetch}.
  */
@@ -81,6 +159,14 @@ interface AutoRefreshContext {
     retry?: RetryConfig;
     /** Called after every API request with structured telemetry */
     onRequest?: (telemetry: SCRequestTelemetry) => void;
+    /** Custom fetch implementation (defaults to `globalThis.fetch`) */
+    fetchImpl?: typeof globalThis.fetch;
+    /** Deduplicates concurrent identical GET requests when set */
+    deduper?: InFlightDeduper;
+    /** Optional cache backend for GET responses */
+    cache?: SoundCloudCache;
+    /** TTL in milliseconds for cached GET responses (default: 60000) */
+    cacheTtlMs?: number;
 }
 /**
  * Make a request to the SoundCloud API using native `fetch`.
@@ -129,7 +215,7 @@ declare function scFetch<T>(options: RequestOptions, refreshCtx?: AutoRefreshCon
  * );
  * ```
  */
-declare function scFetchUrl<T>(url: string, token?: string, retryConfig?: RetryConfig, onRequest?: (telemetry: SCRequestTelemetry) => void): Promise<T>;
+declare function scFetchUrl<T>(url: string, token?: string, retryConfig?: RetryConfig, onRequest?: (telemetry: SCRequestTelemetry) => void, fetchImpl?: typeof globalThis.fetch): Promise<T>;
 
 /**
  * Raw response from the SoundCloud API, including status code and headers.
@@ -180,54 +266,6 @@ declare class RawClient {
     delete<T = unknown>(path: string): Promise<RawResponse<T>>;
 }
 
-/**
- * A cache entry with an expiration timestamp.
- */
-interface SoundCloudCacheEntry<T> {
-    /** The cached value */
-    value: T;
-    /** Unix timestamp (ms) when this entry expires */
-    expiresAt: number;
-}
-/**
- * Cache interface for SoundCloud API responses.
- *
- * Implement this interface to plug in any caching backend (in-memory, Redis, etc.).
- * Pass an instance as `cache` in {@link SoundCloudClientConfig} to enable caching.
- *
- * @example
- * ```ts
- * // Simple in-memory implementation
- * class SimpleCache implements SoundCloudCache {
- *   private store = new Map<string, SoundCloudCacheEntry<unknown>>();
- *
- *   get<T>(key: string): T | undefined {
- *     const entry = this.store.get(key) as SoundCloudCacheEntry<T> | undefined;
- *     if (!entry || Date.now() > entry.expiresAt) return undefined;
- *     return entry.value;
- *   }
- *
- *   set<T>(key: string, value: T, { ttlMs }: { ttlMs: number }): void {
- *     this.store.set(key, { value, expiresAt: Date.now() + ttlMs });
- *   }
- *
- *   delete(key: string): void {
- *     this.store.delete(key);
- *   }
- * }
- * ```
- */
-interface SoundCloudCache {
-    /** Retrieve a cached value by key, or `undefined` if missing or expired */
-    get<T>(key: string): Promise<T | undefined> | T | undefined;
-    /** Store a value with a TTL in milliseconds */
-    set<T>(key: string, value: T, options: {
-        ttlMs: number;
-    }): Promise<void> | void;
-    /** Remove a cached entry */
-    delete(key: string): Promise<void> | void;
-}
-
 /**
  * Parameters for updating a track's metadata via {@link updateTrack}.
  */
@@ -437,11 +475,11 @@ interface SoundCloudClientConfig {
     onRequest?: (telemetry: SCRequestTelemetry) => void;
     /** Custom fetch implementation (defaults to `globalThis.fetch`) */
     fetch?: typeof globalThis.fetch;
-    /** Deduplicate concurrent identical requests (default: true) */
+    /** Deduplicate concurrent identical GET requests (default: true) */
     dedupe?: boolean;
-    /** Optional cache backend for API responses */
+    /** Optional cache backend for GET responses */
     cache?: SoundCloudCache;
-    /** Default TTL in milliseconds for cached responses (default: 60000) */
+    /** Default TTL in milliseconds for cached GET responses (default: 60000) */
     cacheTtlMs?: number;
     /** Called before each retry attempt with structured retry info */
     onRetry?: (info: RetryInfo) => void;
@@ -1477,36 +1515,6 @@ declare namespace SoundCloudClient {
     }
 }
 
-/**
- * Deduplicates concurrent in-flight requests with the same key.
- *
- * When multiple callers request the same resource simultaneously,
- * only one underlying promise is created — all callers share the result.
- * The key is cleaned up automatically once the promise settles.
- *
- * @example
- * ```ts
- * const deduper = new InFlightDeduper();
- *
- * // Both calls share a single fetch:
- * const [a, b] = await Promise.all([
- *   deduper.add('track:123', () => fetchTrack(123)),
- *   deduper.add('track:123', () => fetchTrack(123)),
- * ]);
- * // a === b (same resolved value)
- * ```
- */
-declare class InFlightDeduper {
-    private inFlight;
-    /**
-     * 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<T>(key: string, factory: () => Promise<T>): Promise<T>;
-    /** Number of currently in-flight requests */
-    get size(): number;
-}
-
 /**
  * List of operation IDs currently implemented by soundcloud-api-ts.
  * Used for OpenAPI coverage reporting.

package/dist/index.js

@@ -1,277 +1,277 @@
 'use strict';
 
-var chunkZOHFLO4B_js = require('./chunk-ZOHFLO4B.js');
+var chunkYBNVXQ2E_js = require('./chunk-YBNVXQ2E.js');
 var chunkMLVA534Z_js = require('./chunk-MLVA534Z.js');
 
 
 
 Object.defineProperty(exports, "IMPLEMENTED_OPERATIONS", {
   enumerable: true,
-  get: function () { return chunkZOHFLO4B_js.IMPLEMENTED_OPERATIONS; }
+  get: function () { return chunkYBNVXQ2E_js.IMPLEMENTED_OPERATIONS; }
 });
 Object.defineProperty(exports, "InFlightDeduper", {
   enumerable: true,
-  get: function () { return chunkZOHFLO4B_js.InFlightDeduper; }
+  get: function () { return chunkYBNVXQ2E_js.InFlightDeduper; }
 });
 Object.defineProperty(exports, "RawClient", {
   enumerable: true,
-  get: function () { return chunkZOHFLO4B_js.RawClient; }
+  get: function () { return chunkYBNVXQ2E_js.RawClient; }
 });
 Object.defineProperty(exports, "SoundCloudClient", {
   enumerable: true,
-  get: function () { return chunkZOHFLO4B_js.SoundCloudClient; }
+  get: function () { return chunkYBNVXQ2E_js.SoundCloudClient; }
 });
 Object.defineProperty(exports, "createPlaylist", {
   enumerable: true,
-  get: function () { return chunkZOHFLO4B_js.createPlaylist; }
+  get: function () { return chunkYBNVXQ2E_js.createPlaylist; }
 });
 Object.defineProperty(exports, "createTrackComment", {
   enumerable: true,
-  get: function () { return chunkZOHFLO4B_js.createTrackComment; }
+  get: function () { return chunkYBNVXQ2E_js.createTrackComment; }
 });
 Object.defineProperty(exports, "deletePlaylist", {
   enumerable: true,
-  get: function () { return chunkZOHFLO4B_js.deletePlaylist; }
+  get: function () { return chunkYBNVXQ2E_js.deletePlaylist; }
 });
 Object.defineProperty(exports, "deleteTrack", {
   enumerable: true,
-  get: function () { return chunkZOHFLO4B_js.deleteTrack; }
+  get: function () { return chunkYBNVXQ2E_js.deleteTrack; }
 });
 Object.defineProperty(exports, "fetchAll", {
   enumerable: true,
-  get: function () { return chunkZOHFLO4B_js.fetchAll; }
+  get: function () { return chunkYBNVXQ2E_js.fetchAll; }
 });
 Object.defineProperty(exports, "followUser", {
   enumerable: true,
-  get: function () { return chunkZOHFLO4B_js.followUser; }
+  get: function () { return chunkYBNVXQ2E_js.followUser; }
 });
 Object.defineProperty(exports, "generateCodeChallenge", {
   enumerable: true,
-  get: function () { return chunkZOHFLO4B_js.generateCodeChallenge; }
+  get: function () { return chunkYBNVXQ2E_js.generateCodeChallenge; }
 });
 Object.defineProperty(exports, "generateCodeVerifier", {
   enumerable: true,
-  get: function () { return chunkZOHFLO4B_js.generateCodeVerifier; }
+  get: function () { return chunkYBNVXQ2E_js.generateCodeVerifier; }
 });
 Object.defineProperty(exports, "getAuthorizationUrl", {
   enumerable: true,
-  get: function () { return chunkZOHFLO4B_js.getAuthorizationUrl; }
+  get: function () { return chunkYBNVXQ2E_js.getAuthorizationUrl; }
 });
 Object.defineProperty(exports, "getClientToken", {
   enumerable: true,
-  get: function () { return chunkZOHFLO4B_js.getClientToken; }
+  get: function () { return chunkYBNVXQ2E_js.getClientToken; }
 });
 Object.defineProperty(exports, "getFollowers", {
   enumerable: true,
-  get: function () { return chunkZOHFLO4B_js.getFollowers; }
+  get: function () { return chunkYBNVXQ2E_js.getFollowers; }
 });
 Object.defineProperty(exports, "getFollowings", {
   enumerable: true,
-  get: function () { return chunkZOHFLO4B_js.getFollowings; }
+  get: function () { return chunkYBNVXQ2E_js.getFollowings; }
 });
 Object.defineProperty(exports, "getMe", {
   enumerable: true,
-  get: function () { return chunkZOHFLO4B_js.getMe; }
+  get: function () { return chunkYBNVXQ2E_js.getMe; }
 });
 Object.defineProperty(exports, "getMeActivities", {
   enumerable: true,
-  get: function () { return chunkZOHFLO4B_js.getMeActivities; }
+  get: function () { return chunkYBNVXQ2E_js.getMeActivities; }
 });
 Object.defineProperty(exports, "getMeActivitiesOwn", {
   enumerable: true,
-  get: function () { return chunkZOHFLO4B_js.getMeActivitiesOwn; }
+  get: function () { return chunkYBNVXQ2E_js.getMeActivitiesOwn; }
 });
 Object.defineProperty(exports, "getMeActivitiesTracks", {
   enumerable: true,
-  get: function () { return chunkZOHFLO4B_js.getMeActivitiesTracks; }
+  get: function () { return chunkYBNVXQ2E_js.getMeActivitiesTracks; }
 });
 Object.defineProperty(exports, "getMeConnections", {
   enumerable: true,
-  get: function () { return chunkZOHFLO4B_js.getMeConnections; }
+  get: function () { return chunkYBNVXQ2E_js.getMeConnections; }
 });
 Object.defineProperty(exports, "getMeFollowers", {
   enumerable: true,
-  get: function () { return chunkZOHFLO4B_js.getMeFollowers; }
+  get: function () { return chunkYBNVXQ2E_js.getMeFollowers; }
 });
 Object.defineProperty(exports, "getMeFollowings", {
   enumerable: true,
-  get: function () { return chunkZOHFLO4B_js.getMeFollowings; }
+  get: function () { return chunkYBNVXQ2E_js.getMeFollowings; }
 });
 Object.defineProperty(exports, "getMeFollowingsTracks", {
   enumerable: true,
-  get: function () { return chunkZOHFLO4B_js.getMeFollowingsTracks; }
+  get: function () { return chunkYBNVXQ2E_js.getMeFollowingsTracks; }
 });
 Object.defineProperty(exports, "getMeLikesPlaylists", {
   enumerable: true,
-  get: function () { return chunkZOHFLO4B_js.getMeLikesPlaylists; }
+  get: function () { return chunkYBNVXQ2E_js.getMeLikesPlaylists; }
 });
 Object.defineProperty(exports, "getMeLikesTracks", {
   enumerable: true,
-  get: function () { return chunkZOHFLO4B_js.getMeLikesTracks; }
+  get: function () { return chunkYBNVXQ2E_js.getMeLikesTracks; }
 });
 Object.defineProperty(exports, "getMePlaylists", {
   enumerable: true,
-  get: function () { return chunkZOHFLO4B_js.getMePlaylists; }
+  get: function () { return chunkYBNVXQ2E_js.getMePlaylists; }
 });
 Object.defineProperty(exports, "getMeTracks", {
   enumerable: true,
-  get: function () { return chunkZOHFLO4B_js.getMeTracks; }
+  get: function () { return chunkYBNVXQ2E_js.getMeTracks; }
 });
 Object.defineProperty(exports, "getPlaylist", {
   enumerable: true,
-  get: function () { return chunkZOHFLO4B_js.getPlaylist; }
+  get: function () { return chunkYBNVXQ2E_js.getPlaylist; }
 });
 Object.defineProperty(exports, "getPlaylistReposts", {
   enumerable: true,
-  get: function () { return chunkZOHFLO4B_js.getPlaylistReposts; }
+  get: function () { return chunkYBNVXQ2E_js.getPlaylistReposts; }
 });
 Object.defineProperty(exports, "getPlaylistTracks", {
   enumerable: true,
-  get: function () { return chunkZOHFLO4B_js.getPlaylistTracks; }
+  get: function () { return chunkYBNVXQ2E_js.getPlaylistTracks; }
 });
 Object.defineProperty(exports, "getRelatedTracks", {
   enumerable: true,
-  get: function () { return chunkZOHFLO4B_js.getRelatedTracks; }
+  get: function () { return chunkYBNVXQ2E_js.getRelatedTracks; }
 });
 Object.defineProperty(exports, "getSoundCloudWidgetUrl", {
   enumerable: true,
-  get: function () { return chunkZOHFLO4B_js.getSoundCloudWidgetUrl; }
+  get: function () { return chunkYBNVXQ2E_js.getSoundCloudWidgetUrl; }
 });
 Object.defineProperty(exports, "getTrack", {
   enumerable: true,
-  get: function () { return chunkZOHFLO4B_js.getTrack; }
+  get: function () { return chunkYBNVXQ2E_js.getTrack; }
 });
 Object.defineProperty(exports, "getTrackComments", {
   enumerable: true,
-  get: function () { return chunkZOHFLO4B_js.getTrackComments; }
+  get: function () { return chunkYBNVXQ2E_js.getTrackComments; }
 });
 Object.defineProperty(exports, "getTrackLikes", {
   enumerable: true,
-  get: function () { return chunkZOHFLO4B_js.getTrackLikes; }
+  get: function () { return chunkYBNVXQ2E_js.getTrackLikes; }
 });
 Object.defineProperty(exports, "getTrackReposts", {
   enumerable: true,
-  get: function () { return chunkZOHFLO4B_js.getTrackReposts; }
+  get: function () { return chunkYBNVXQ2E_js.getTrackReposts; }
 });
 Object.defineProperty(exports, "getTrackStreams", {
   enumerable: true,
-  get: function () { return chunkZOHFLO4B_js.getTrackStreams; }
+  get: function () { return chunkYBNVXQ2E_js.getTrackStreams; }
 });
 Object.defineProperty(exports, "getTracks", {
   enumerable: true,
-  get: function () { return chunkZOHFLO4B_js.getTracks; }
+  get: function () { return chunkYBNVXQ2E_js.getTracks; }
 });
 Object.defineProperty(exports, "getUser", {
   enumerable: true,
-  get: function () { return chunkZOHFLO4B_js.getUser; }
+  get: function () { return chunkYBNVXQ2E_js.getUser; }
 });
 Object.defineProperty(exports, "getUserLikesPlaylists", {
   enumerable: true,
-  get: function () { return chunkZOHFLO4B_js.getUserLikesPlaylists; }
+  get: function () { return chunkYBNVXQ2E_js.getUserLikesPlaylists; }
 });
 Object.defineProperty(exports, "getUserLikesTracks", {
   enumerable: true,
-  get: function () { return chunkZOHFLO4B_js.getUserLikesTracks; }
+  get: function () { return chunkYBNVXQ2E_js.getUserLikesTracks; }
 });
 Object.defineProperty(exports, "getUserPlaylists", {
   enumerable: true,
-  get: function () { return chunkZOHFLO4B_js.getUserPlaylists; }
+  get: function () { return chunkYBNVXQ2E_js.getUserPlaylists; }
 });
 Object.defineProperty(exports, "getUserToken", {
   enumerable: true,
-  get: function () { return chunkZOHFLO4B_js.getUserToken; }
+  get: function () { return chunkYBNVXQ2E_js.getUserToken; }
 });
 Object.defineProperty(exports, "getUserTracks", {
   enumerable: true,
-  get: function () { return chunkZOHFLO4B_js.getUserTracks; }
+  get: function () { return chunkYBNVXQ2E_js.getUserTracks; }
 });
 Object.defineProperty(exports, "getUserWebProfiles", {
   enumerable: true,
-  get: function () { return chunkZOHFLO4B_js.getUserWebProfiles; }
+  get: function () { return chunkYBNVXQ2E_js.getUserWebProfiles; }
 });
 Object.defineProperty(exports, "likePlaylist", {
   enumerable: true,
-  get: function () { return chunkZOHFLO4B_js.likePlaylist; }
+  get: function () { return chunkYBNVXQ2E_js.likePlaylist; }
 });
 Object.defineProperty(exports, "likeTrack", {
   enumerable: true,
-  get: function () { return chunkZOHFLO4B_js.likeTrack; }
+  get: function () { return chunkYBNVXQ2E_js.likeTrack; }
 });
 Object.defineProperty(exports, "paginate", {
   enumerable: true,
-  get: function () { return chunkZOHFLO4B_js.paginate; }
+  get: function () { return chunkYBNVXQ2E_js.paginate; }
 });
 Object.defineProperty(exports, "paginateItems", {
   enumerable: true,
-  get: function () { return chunkZOHFLO4B_js.paginateItems; }
+  get: function () { return chunkYBNVXQ2E_js.paginateItems; }
 });
 Object.defineProperty(exports, "refreshUserToken", {
   enumerable: true,
-  get: function () { return chunkZOHFLO4B_js.refreshUserToken; }
+  get: function () { return chunkYBNVXQ2E_js.refreshUserToken; }
 });
 Object.defineProperty(exports, "repostPlaylist", {
   enumerable: true,
-  get: function () { return chunkZOHFLO4B_js.repostPlaylist; }
+  get: function () { return chunkYBNVXQ2E_js.repostPlaylist; }
 });
 Object.defineProperty(exports, "repostTrack", {
   enumerable: true,
-  get: function () { return chunkZOHFLO4B_js.repostTrack; }
+  get: function () { return chunkYBNVXQ2E_js.repostTrack; }
 });
 Object.defineProperty(exports, "resolveUrl", {
   enumerable: true,
-  get: function () { return chunkZOHFLO4B_js.resolveUrl; }
+  get: function () { return chunkYBNVXQ2E_js.resolveUrl; }
 });
 Object.defineProperty(exports, "scFetch", {
   enumerable: true,
-  get: function () { return chunkZOHFLO4B_js.scFetch; }
+  get: function () { return chunkYBNVXQ2E_js.scFetch; }
 });
 Object.defineProperty(exports, "scFetchUrl", {
   enumerable: true,
-  get: function () { return chunkZOHFLO4B_js.scFetchUrl; }
+  get: function () { return chunkYBNVXQ2E_js.scFetchUrl; }
 });
 Object.defineProperty(exports, "searchPlaylists", {
   enumerable: true,
-  get: function () { return chunkZOHFLO4B_js.searchPlaylists; }
+  get: function () { return chunkYBNVXQ2E_js.searchPlaylists; }
 });
 Object.defineProperty(exports, "searchTracks", {
   enumerable: true,
-  get: function () { return chunkZOHFLO4B_js.searchTracks; }
+  get: function () { return chunkYBNVXQ2E_js.searchTracks; }
 });
 Object.defineProperty(exports, "searchUsers", {
   enumerable: true,
-  get: function () { return chunkZOHFLO4B_js.searchUsers; }
+  get: function () { return chunkYBNVXQ2E_js.searchUsers; }
 });
 Object.defineProperty(exports, "signOut", {
   enumerable: true,
-  get: function () { return chunkZOHFLO4B_js.signOut; }
+  get: function () { return chunkYBNVXQ2E_js.signOut; }
 });
 Object.defineProperty(exports, "unfollowUser", {
   enumerable: true,
-  get: function () { return chunkZOHFLO4B_js.unfollowUser; }
+  get: function () { return chunkYBNVXQ2E_js.unfollowUser; }
 });
 Object.defineProperty(exports, "unlikePlaylist", {
   enumerable: true,
-  get: function () { return chunkZOHFLO4B_js.unlikePlaylist; }
+  get: function () { return chunkYBNVXQ2E_js.unlikePlaylist; }
 });
 Object.defineProperty(exports, "unlikeTrack", {
   enumerable: true,
-  get: function () { return chunkZOHFLO4B_js.unlikeTrack; }
+  get: function () { return chunkYBNVXQ2E_js.unlikeTrack; }
 });
 Object.defineProperty(exports, "unrepostPlaylist", {
   enumerable: true,
-  get: function () { return chunkZOHFLO4B_js.unrepostPlaylist; }
+  get: function () { return chunkYBNVXQ2E_js.unrepostPlaylist; }
 });
 Object.defineProperty(exports, "unrepostTrack", {
   enumerable: true,
-  get: function () { return chunkZOHFLO4B_js.unrepostTrack; }
+  get: function () { return chunkYBNVXQ2E_js.unrepostTrack; }
 });
 Object.defineProperty(exports, "updatePlaylist", {
   enumerable: true,
-  get: function () { return chunkZOHFLO4B_js.updatePlaylist; }
+  get: function () { return chunkYBNVXQ2E_js.updatePlaylist; }
 });
 Object.defineProperty(exports, "updateTrack", {
   enumerable: true,
-  get: function () { return chunkZOHFLO4B_js.updateTrack; }
+  get: function () { return chunkYBNVXQ2E_js.updateTrack; }
 });
 Object.defineProperty(exports, "SoundCloudError", {
   enumerable: true,

package/dist/index.mjs

@@ -1,4 +1,4 @@
-export { IMPLEMENTED_OPERATIONS, InFlightDeduper, RawClient, SoundCloudClient, createPlaylist, createTrackComment, deletePlaylist, deleteTrack, fetchAll, followUser, generateCodeChallenge, generateCodeVerifier, getAuthorizationUrl, getClientToken, getFollowers, getFollowings, getMe, getMeActivities, getMeActivitiesOwn, getMeActivitiesTracks, getMeConnections, getMeFollowers, getMeFollowings, getMeFollowingsTracks, getMeLikesPlaylists, getMeLikesTracks, getMePlaylists, getMeTracks, getPlaylist, getPlaylistReposts, getPlaylistTracks, getRelatedTracks, getSoundCloudWidgetUrl, getTrack, getTrackComments, getTrackLikes, getTrackReposts, getTrackStreams, getTracks, 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 } from './chunk-QNL6UJL5.mjs';
+export { IMPLEMENTED_OPERATIONS, InFlightDeduper, RawClient, SoundCloudClient, createPlaylist, createTrackComment, deletePlaylist, deleteTrack, fetchAll, followUser, generateCodeChallenge, generateCodeVerifier, getAuthorizationUrl, getClientToken, getFollowers, getFollowings, getMe, getMeActivities, getMeActivitiesOwn, getMeActivitiesTracks, getMeConnections, getMeFollowers, getMeFollowings, getMeFollowingsTracks, getMeLikesPlaylists, getMeLikesTracks, getMePlaylists, getMeTracks, getPlaylist, getPlaylistReposts, getPlaylistTracks, getRelatedTracks, getSoundCloudWidgetUrl, getTrack, getTrackComments, getTrackLikes, getTrackReposts, getTrackStreams, getTracks, 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 } from './chunk-4FNI5QIN.mjs';
 export { SoundCloudError } from './chunk-QYYEWUIJ.mjs';
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map

package/llms.txt

@@ -1,4 +1,4 @@
-# soundcloud-api-ts v1.13.2
+# soundcloud-api-ts v1.14.0
 
 > A TypeScript client for the SoundCloud API. Zero dependencies, native fetch, full OAuth 2.1 + PKCE support via `secure.soundcloud.com`.
 
@@ -39,7 +39,7 @@ Paginated responses return `SoundCloudPaginatedResponse<T>` with `collection: T[
     refreshUserToken(refreshToken: string): Promise<SoundCloudToken>
     signOut(accessToken: string): Promise<void>
 
-> **Note (v1.13.2+)**: All token endpoints (`client_credentials`, `refresh_token`, `authorization_code`) send `client_id` and `client_secret` in the request body, not via `Authorization: Basic`. SoundCloud rejects Basic Auth on `/oauth/token` with 403/400 as of early 2026.
+> **Note (v1.13.3+)**: SoundCloud's `/oauth/token` requirements differ **per grant type**: `client_credentials` requires `Authorization: Basic` (body credentials return `401 invalid_client`), while `refresh_token` and `authorization_code` require `client_id`/`client_secret` in the request body. `getClientToken` sends Basic Auth; `refreshUserToken`/`getUserToken` send body credentials. (v1.13.2 briefly used body credentials for all grants — reversed for `client_credentials` in v1.13.3.)
 
 ### PKCE Helpers (standalone exports)
 
@@ -49,7 +49,7 @@ Paginated responses return `SoundCloudPaginatedResponse<T>` with `collection: T[
 ### Tracks (sc.tracks)
 
     getTrack(trackId: string | number): Promise<SoundCloudTrack>
-    getTracks(ids: (string | number)[]): Promise<SoundCloudTrack[]>  // batch fetch by IDs
+    getTracks(ids: (string | number)[]): Promise<SoundCloudTrack[]>  // batch fetch by IDs; max 200 (throws above)
     getStreams(trackId: string | number): Promise<SoundCloudStreams>
     getComments(trackId: string | number, limit?: number): Promise<SoundCloudPaginatedResponse<SoundCloudComment>>
     createComment(trackId: string | number, body: string, timestamp?: number): Promise<SoundCloudComment>
@@ -202,7 +202,7 @@ const sc = new SoundCloudClient({
 });
 ```
 
-`SCRequestTelemetry`: `{ method, path, durationMs, status, retryCount, error? }` — fires after every request including pagination and retries.
+`SCRequestTelemetry`: `{ method, path, durationMs, status, retryCount, error? }` — fires after every client-namespace request including pagination and retries. Not emitted for `sc.raw.*` or `auth.signOut`.
 
 ## Raw API
 ```ts
@@ -223,16 +223,16 @@ const sc = new SoundCloudClient({
 });
 ```
 `SoundCloudCache`: `{ get<T>(key): T|undefined; set<T>(key, value, {ttlMs}): void; delete(key): void }`
+Applies to GETs made through the client namespaces. `sc.raw.*` and pagination `next_href` fetches are not deduped/cached. (Note: these options existed but were not wired up in v1.12.0–v1.13.4.)
 
 ## Fetch Injection & Runtime Portability
 ```ts
 const sc = new SoundCloudClient({
   clientId: '...', clientSecret: '...',
-  fetch: customFetch,            // custom fetch implementation
-  AbortController: customAbort,  // custom AbortController
+  fetch: customFetch,  // custom fetch implementation (defaults to globalThis.fetch)
 });
 ```
-No Node-only APIs. Works in Cloudflare Workers, Bun, Deno, Edge runtimes.
+No Node-only APIs. Works in Cloudflare Workers, Bun, Deno, Edge runtimes. There is no `AbortController` config option — pass a pre-wired `fetch` if you need cancellation/timeouts.
 
 ## Retry Hook
 ```ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "soundcloud-api-ts",
-  "version": "1.13.3",
+  "version": "1.14.0",
   "description": "TypeScript-first SoundCloud API client for accessing tracks, users, playlists, and search endpoints. Zero dependencies, native fetch, full OAuth 2.1 + PKCE support.",
   "bin": {
     "sc-cli": "./dist/cli.js",
@@ -61,9 +61,15 @@
     "node"
   ],
   "license": "MIT",
+  "packageManager": "pnpm@10.23.0",
   "engines": {
     "node": ">=20"
   },
+  "pnpm": {
+    "onlyBuiltDependencies": [
+      "esbuild"
+    ]
+  },
   "devDependencies": {
     "@types/node": "^25.2.3",
     "@typescript-eslint/eslint-plugin": "^8.55.0",