soundcloud-api-ts 1.10.2 → 1.11.0

package/dist/index.d.ts

@@ -18,6 +18,23 @@ interface RequestOptions {
     /** Override the Content-Type header (defaults to "application/json" for object bodies) */
     contentType?: string;
 }
+/**
+ * Structured telemetry emitted after every API request.
+ */
+interface SCRequestTelemetry {
+    /** HTTP method used */
+    method: "GET" | "POST" | "PUT" | "DELETE";
+    /** API path or full URL */
+    path: string;
+    /** Total duration including retries, in milliseconds */
+    durationMs: number;
+    /** Final HTTP status code */
+    status: number;
+    /** Number of retries performed (0 = succeeded on first attempt) */
+    retryCount: number;
+    /** Error message if the request ultimately failed */
+    error?: string;
+}
 /**
  * Configuration for automatic retry with exponential backoff on transient errors.
  */
@@ -45,6 +62,8 @@ interface AutoRefreshContext {
     setToken: (accessToken: string, refreshToken?: string) => void;
     /** Retry configuration for this context */
     retry?: RetryConfig;
+    /** Called after every API request with structured telemetry */
+    onRequest?: (telemetry: SCRequestTelemetry) => void;
 }
 /**
  * Make a request to the SoundCloud API using native `fetch`.
@@ -71,7 +90,7 @@ interface AutoRefreshContext {
  *
  * @see https://developers.soundcloud.com/docs/api/explorer/open-api
  */
-declare function scFetch<T>(options: RequestOptions, refreshCtx?: AutoRefreshContext): Promise<T>;
+declare function scFetch<T>(options: RequestOptions, refreshCtx?: AutoRefreshContext, onRequest?: (telemetry: SCRequestTelemetry) => void): Promise<T>;
 /**
  * Fetch an absolute URL (e.g. `next_href` from paginated responses).
  *
@@ -93,7 +112,7 @@ declare function scFetch<T>(options: RequestOptions, refreshCtx?: AutoRefreshCon
  * );
  * ```
  */
-declare function scFetchUrl<T>(url: string, token?: string, retryConfig?: RetryConfig): Promise<T>;
+declare function scFetchUrl<T>(url: string, token?: string, retryConfig?: RetryConfig, onRequest?: (telemetry: SCRequestTelemetry) => void): Promise<T>;
 
 /**
  * Parameters for updating a track's metadata via {@link updateTrack}.
@@ -300,6 +319,8 @@ interface SoundCloudClientConfig {
     retryBaseDelay?: number;
     /** Optional debug logger callback for retry attempts and other internal events */
     onDebug?: (message: string) => void;
+    /** Called after every API request with structured telemetry (timing, status, retries) */
+    onRequest?: (telemetry: SCRequestTelemetry) => void;
 }
 /**
  * Optional token override that can be passed as the last parameter to client methods.
@@ -2441,4 +2462,4 @@ declare const unrepostPlaylist: (token: string, playlistId: string | number) =>
  */
 declare const getSoundCloudWidgetUrl: (trackId: string | number) => string;
 
-export { type CreatePlaylistParams, type RequestOptions, type RetryConfig, SoundCloudActivitiesResponse, SoundCloudClient, type SoundCloudClientConfig, SoundCloudComment, SoundCloudMe, SoundCloudPaginatedResponse, SoundCloudPlaylist, SoundCloudStreams, SoundCloudToken, SoundCloudTrack, SoundCloudUser, SoundCloudWebProfile, type TokenOption, type UpdatePlaylistParams, type UpdateTrackParams, 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 };
+export { type CreatePlaylistParams, type RequestOptions, type RetryConfig, type SCRequestTelemetry, SoundCloudActivitiesResponse, SoundCloudClient, type SoundCloudClientConfig, SoundCloudComment, SoundCloudMe, SoundCloudPaginatedResponse, SoundCloudPlaylist, SoundCloudStreams, SoundCloudToken, SoundCloudTrack, SoundCloudUser, SoundCloudWebProfile, type TokenOption, type UpdatePlaylistParams, type UpdateTrackParams, 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 };

package/dist/index.js

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

package/dist/index.mjs

@@ -1,4 +1,4 @@
-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 } from './chunk-ACK4KMGD.mjs';
+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 } from './chunk-5FCXAR2S.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.10.0
+# soundcloud-api-ts v1.11.0
 
 > A TypeScript client for the SoundCloud API. Zero dependencies, native fetch, full OAuth 2.1 + PKCE support via `secure.soundcloud.com`.
 
@@ -190,6 +190,16 @@ const sc = new SoundCloudClient({
 });
 ```
 
+### Request Telemetry
+```ts
+const sc = new SoundCloudClient({
+  clientId: '...', clientSecret: '...',
+  onRequest: (t) => console.log(`[SC] ${t.method} ${t.path} ${t.status} ${t.durationMs}ms retries=${t.retryCount}`),
+});
+```
+
+`SCRequestTelemetry`: `{ method, path, durationMs, status, retryCount, error? }` — fires after every request including pagination and retries.
+
 ## Full Documentation
 
 https://twin-paws.github.io/soundcloud-api-ts/

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "soundcloud-api-ts",
-  "version": "1.10.2",
+  "version": "1.11.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",