soundcloud-api-ts 1.9.1 → 1.9.3

package/dist/cli.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 'use strict';
 
-var chunkPRQGEYWK_js = require('./chunk-PRQGEYWK.js');
+var chunkIU4XNEP2_js = require('./chunk-IU4XNEP2.js');
 require('./chunk-NBKG62HR.js');
 var readline = require('readline');
 var http = require('http');
@@ -115,7 +115,7 @@ function getClient(config) {
   if (!config.clientId || !config.clientSecret) {
     die("Not configured. Run `sc-cli auth` first.");
   }
-  const client = new chunkPRQGEYWK_js.SoundCloudClient({
+  const client = new chunkIU4XNEP2_js.SoundCloudClient({
     clientId: config.clientId,
     clientSecret: config.clientSecret,
     redirectUri: "http://localhost:8976/callback"
@@ -169,7 +169,7 @@ ${col(c.bold + c.cyan, "\u26A1 SoundCloud CLI Setup")}
   if (!clientSecret) die("Client Secret is required.");
   const spinner = createSpinner("Verifying credentials\u2026");
   try {
-    const client = new chunkPRQGEYWK_js.SoundCloudClient({ clientId, clientSecret });
+    const client = new chunkIU4XNEP2_js.SoundCloudClient({ clientId, clientSecret });
     const token = await client.auth.getClientToken();
     spinner.stop(`${col(c.green, "\u2714")} Credentials verified!`);
     const config = { clientId, clientSecret, token: token.access_token };
@@ -185,9 +185,9 @@ async function cmdLogin() {
   if (!config.clientId || !config.clientSecret) {
     die("Not configured. Run `sc-cli auth` first.");
   }
-  const verifier = chunkPRQGEYWK_js.generateCodeVerifier();
-  const challenge = await chunkPRQGEYWK_js.generateCodeChallenge(verifier);
-  const client = new chunkPRQGEYWK_js.SoundCloudClient({
+  const verifier = chunkIU4XNEP2_js.generateCodeVerifier();
+  const challenge = await chunkIU4XNEP2_js.generateCodeChallenge(verifier);
+  const client = new chunkIU4XNEP2_js.SoundCloudClient({
     clientId: config.clientId,
     clientSecret: config.clientSecret,
     redirectUri: "http://localhost:8976/callback"

package/dist/cli.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { generateCodeVerifier, generateCodeChallenge, SoundCloudClient } from './chunk-SCUOUK3L.mjs';
+import { generateCodeVerifier, generateCodeChallenge, SoundCloudClient } from './chunk-G6S6GM75.mjs';
 import './chunk-CYDTNVV3.mjs';
 import * as readline from 'readline';
 import * as http from 'http';

package/dist/index.d.mts

@@ -1499,7 +1499,7 @@ declare function getAuthorizationUrl(clientId: string, redirectUri: string, opti
 /**
  * Generate a random PKCE code verifier (43+ characters, base64url-encoded).
  *
- * Uses the Web Crypto API (`globalThis.crypto`), compatible with Node 18+ and modern browsers.
+ * Uses the Web Crypto API (`globalThis.crypto`), compatible with Node 20+ and modern browsers.
  *
  * @returns A cryptographically random code verifier string
  *
@@ -1519,7 +1519,7 @@ declare function generateCodeVerifier(): string;
  * Derive the S256 PKCE code challenge from a code verifier.
  *
  * Computes `BASE64URL(SHA256(verifier))` using the Web Crypto API (SubtleCrypto),
- * available in Node 18+ and modern browsers.
+ * available in Node 20+ and modern browsers.
  *
  * @param verifier - The code verifier string (typically from {@link generateCodeVerifier})
  * @returns The base64url-encoded SHA-256 hash of the verifier

package/dist/index.d.ts

@@ -1499,7 +1499,7 @@ declare function getAuthorizationUrl(clientId: string, redirectUri: string, opti
 /**
  * Generate a random PKCE code verifier (43+ characters, base64url-encoded).
  *
- * Uses the Web Crypto API (`globalThis.crypto`), compatible with Node 18+ and modern browsers.
+ * Uses the Web Crypto API (`globalThis.crypto`), compatible with Node 20+ and modern browsers.
  *
  * @returns A cryptographically random code verifier string
  *
@@ -1519,7 +1519,7 @@ declare function generateCodeVerifier(): string;
  * Derive the S256 PKCE code challenge from a code verifier.
  *
  * Computes `BASE64URL(SHA256(verifier))` using the Web Crypto API (SubtleCrypto),
- * available in Node 18+ and modern browsers.
+ * available in Node 20+ and modern browsers.
  *
  * @param verifier - The code verifier string (typically from {@link generateCodeVerifier})
  * @returns The base64url-encoded SHA-256 hash of the verifier

package/dist/index.js

@@ -1,257 +1,257 @@
 'use strict';
 
-var chunkPRQGEYWK_js = require('./chunk-PRQGEYWK.js');
+var chunkIU4XNEP2_js = require('./chunk-IU4XNEP2.js');
 var chunkNBKG62HR_js = require('./chunk-NBKG62HR.js');
 
 
 
 Object.defineProperty(exports, "SoundCloudClient", {
   enumerable: true,
-  get: function () { return chunkPRQGEYWK_js.SoundCloudClient; }
+  get: function () { return chunkIU4XNEP2_js.SoundCloudClient; }
 });
 Object.defineProperty(exports, "createPlaylist", {
   enumerable: true,
-  get: function () { return chunkPRQGEYWK_js.createPlaylist; }
+  get: function () { return chunkIU4XNEP2_js.createPlaylist; }
 });
 Object.defineProperty(exports, "createTrackComment", {
   enumerable: true,
-  get: function () { return chunkPRQGEYWK_js.createTrackComment; }
+  get: function () { return chunkIU4XNEP2_js.createTrackComment; }
 });
 Object.defineProperty(exports, "deletePlaylist", {
   enumerable: true,
-  get: function () { return chunkPRQGEYWK_js.deletePlaylist; }
+  get: function () { return chunkIU4XNEP2_js.deletePlaylist; }
 });
 Object.defineProperty(exports, "deleteTrack", {
   enumerable: true,
-  get: function () { return chunkPRQGEYWK_js.deleteTrack; }
+  get: function () { return chunkIU4XNEP2_js.deleteTrack; }
 });
 Object.defineProperty(exports, "fetchAll", {
   enumerable: true,
-  get: function () { return chunkPRQGEYWK_js.fetchAll; }
+  get: function () { return chunkIU4XNEP2_js.fetchAll; }
 });
 Object.defineProperty(exports, "followUser", {
   enumerable: true,
-  get: function () { return chunkPRQGEYWK_js.followUser; }
+  get: function () { return chunkIU4XNEP2_js.followUser; }
 });
 Object.defineProperty(exports, "generateCodeChallenge", {
   enumerable: true,
-  get: function () { return chunkPRQGEYWK_js.generateCodeChallenge; }
+  get: function () { return chunkIU4XNEP2_js.generateCodeChallenge; }
 });
 Object.defineProperty(exports, "generateCodeVerifier", {
   enumerable: true,
-  get: function () { return chunkPRQGEYWK_js.generateCodeVerifier; }
+  get: function () { return chunkIU4XNEP2_js.generateCodeVerifier; }
 });
 Object.defineProperty(exports, "getAuthorizationUrl", {
   enumerable: true,
-  get: function () { return chunkPRQGEYWK_js.getAuthorizationUrl; }
+  get: function () { return chunkIU4XNEP2_js.getAuthorizationUrl; }
 });
 Object.defineProperty(exports, "getClientToken", {
   enumerable: true,
-  get: function () { return chunkPRQGEYWK_js.getClientToken; }
+  get: function () { return chunkIU4XNEP2_js.getClientToken; }
 });
 Object.defineProperty(exports, "getFollowers", {
   enumerable: true,
-  get: function () { return chunkPRQGEYWK_js.getFollowers; }
+  get: function () { return chunkIU4XNEP2_js.getFollowers; }
 });
 Object.defineProperty(exports, "getFollowings", {
   enumerable: true,
-  get: function () { return chunkPRQGEYWK_js.getFollowings; }
+  get: function () { return chunkIU4XNEP2_js.getFollowings; }
 });
 Object.defineProperty(exports, "getMe", {
   enumerable: true,
-  get: function () { return chunkPRQGEYWK_js.getMe; }
+  get: function () { return chunkIU4XNEP2_js.getMe; }
 });
 Object.defineProperty(exports, "getMeActivities", {
   enumerable: true,
-  get: function () { return chunkPRQGEYWK_js.getMeActivities; }
+  get: function () { return chunkIU4XNEP2_js.getMeActivities; }
 });
 Object.defineProperty(exports, "getMeActivitiesOwn", {
   enumerable: true,
-  get: function () { return chunkPRQGEYWK_js.getMeActivitiesOwn; }
+  get: function () { return chunkIU4XNEP2_js.getMeActivitiesOwn; }
 });
 Object.defineProperty(exports, "getMeActivitiesTracks", {
   enumerable: true,
-  get: function () { return chunkPRQGEYWK_js.getMeActivitiesTracks; }
+  get: function () { return chunkIU4XNEP2_js.getMeActivitiesTracks; }
 });
 Object.defineProperty(exports, "getMeFollowers", {
   enumerable: true,
-  get: function () { return chunkPRQGEYWK_js.getMeFollowers; }
+  get: function () { return chunkIU4XNEP2_js.getMeFollowers; }
 });
 Object.defineProperty(exports, "getMeFollowings", {
   enumerable: true,
-  get: function () { return chunkPRQGEYWK_js.getMeFollowings; }
+  get: function () { return chunkIU4XNEP2_js.getMeFollowings; }
 });
 Object.defineProperty(exports, "getMeFollowingsTracks", {
   enumerable: true,
-  get: function () { return chunkPRQGEYWK_js.getMeFollowingsTracks; }
+  get: function () { return chunkIU4XNEP2_js.getMeFollowingsTracks; }
 });
 Object.defineProperty(exports, "getMeLikesPlaylists", {
   enumerable: true,
-  get: function () { return chunkPRQGEYWK_js.getMeLikesPlaylists; }
+  get: function () { return chunkIU4XNEP2_js.getMeLikesPlaylists; }
 });
 Object.defineProperty(exports, "getMeLikesTracks", {
   enumerable: true,
-  get: function () { return chunkPRQGEYWK_js.getMeLikesTracks; }
+  get: function () { return chunkIU4XNEP2_js.getMeLikesTracks; }
 });
 Object.defineProperty(exports, "getMePlaylists", {
   enumerable: true,
-  get: function () { return chunkPRQGEYWK_js.getMePlaylists; }
+  get: function () { return chunkIU4XNEP2_js.getMePlaylists; }
 });
 Object.defineProperty(exports, "getMeTracks", {
   enumerable: true,
-  get: function () { return chunkPRQGEYWK_js.getMeTracks; }
+  get: function () { return chunkIU4XNEP2_js.getMeTracks; }
 });
 Object.defineProperty(exports, "getPlaylist", {
   enumerable: true,
-  get: function () { return chunkPRQGEYWK_js.getPlaylist; }
+  get: function () { return chunkIU4XNEP2_js.getPlaylist; }
 });
 Object.defineProperty(exports, "getPlaylistReposts", {
   enumerable: true,
-  get: function () { return chunkPRQGEYWK_js.getPlaylistReposts; }
+  get: function () { return chunkIU4XNEP2_js.getPlaylistReposts; }
 });
 Object.defineProperty(exports, "getPlaylistTracks", {
   enumerable: true,
-  get: function () { return chunkPRQGEYWK_js.getPlaylistTracks; }
+  get: function () { return chunkIU4XNEP2_js.getPlaylistTracks; }
 });
 Object.defineProperty(exports, "getRelatedTracks", {
   enumerable: true,
-  get: function () { return chunkPRQGEYWK_js.getRelatedTracks; }
+  get: function () { return chunkIU4XNEP2_js.getRelatedTracks; }
 });
 Object.defineProperty(exports, "getSoundCloudWidgetUrl", {
   enumerable: true,
-  get: function () { return chunkPRQGEYWK_js.getSoundCloudWidgetUrl; }
+  get: function () { return chunkIU4XNEP2_js.getSoundCloudWidgetUrl; }
 });
 Object.defineProperty(exports, "getTrack", {
   enumerable: true,
-  get: function () { return chunkPRQGEYWK_js.getTrack; }
+  get: function () { return chunkIU4XNEP2_js.getTrack; }
 });
 Object.defineProperty(exports, "getTrackComments", {
   enumerable: true,
-  get: function () { return chunkPRQGEYWK_js.getTrackComments; }
+  get: function () { return chunkIU4XNEP2_js.getTrackComments; }
 });
 Object.defineProperty(exports, "getTrackLikes", {
   enumerable: true,
-  get: function () { return chunkPRQGEYWK_js.getTrackLikes; }
+  get: function () { return chunkIU4XNEP2_js.getTrackLikes; }
 });
 Object.defineProperty(exports, "getTrackReposts", {
   enumerable: true,
-  get: function () { return chunkPRQGEYWK_js.getTrackReposts; }
+  get: function () { return chunkIU4XNEP2_js.getTrackReposts; }
 });
 Object.defineProperty(exports, "getTrackStreams", {
   enumerable: true,
-  get: function () { return chunkPRQGEYWK_js.getTrackStreams; }
+  get: function () { return chunkIU4XNEP2_js.getTrackStreams; }
 });
 Object.defineProperty(exports, "getUser", {
   enumerable: true,
-  get: function () { return chunkPRQGEYWK_js.getUser; }
+  get: function () { return chunkIU4XNEP2_js.getUser; }
 });
 Object.defineProperty(exports, "getUserLikesPlaylists", {
   enumerable: true,
-  get: function () { return chunkPRQGEYWK_js.getUserLikesPlaylists; }
+  get: function () { return chunkIU4XNEP2_js.getUserLikesPlaylists; }
 });
 Object.defineProperty(exports, "getUserLikesTracks", {
   enumerable: true,
-  get: function () { return chunkPRQGEYWK_js.getUserLikesTracks; }
+  get: function () { return chunkIU4XNEP2_js.getUserLikesTracks; }
 });
 Object.defineProperty(exports, "getUserPlaylists", {
   enumerable: true,
-  get: function () { return chunkPRQGEYWK_js.getUserPlaylists; }
+  get: function () { return chunkIU4XNEP2_js.getUserPlaylists; }
 });
 Object.defineProperty(exports, "getUserToken", {
   enumerable: true,
-  get: function () { return chunkPRQGEYWK_js.getUserToken; }
+  get: function () { return chunkIU4XNEP2_js.getUserToken; }
 });
 Object.defineProperty(exports, "getUserTracks", {
   enumerable: true,
-  get: function () { return chunkPRQGEYWK_js.getUserTracks; }
+  get: function () { return chunkIU4XNEP2_js.getUserTracks; }
 });
 Object.defineProperty(exports, "getUserWebProfiles", {
   enumerable: true,
-  get: function () { return chunkPRQGEYWK_js.getUserWebProfiles; }
+  get: function () { return chunkIU4XNEP2_js.getUserWebProfiles; }
 });
 Object.defineProperty(exports, "likePlaylist", {
   enumerable: true,
-  get: function () { return chunkPRQGEYWK_js.likePlaylist; }
+  get: function () { return chunkIU4XNEP2_js.likePlaylist; }
 });
 Object.defineProperty(exports, "likeTrack", {
   enumerable: true,
-  get: function () { return chunkPRQGEYWK_js.likeTrack; }
+  get: function () { return chunkIU4XNEP2_js.likeTrack; }
 });
 Object.defineProperty(exports, "paginate", {
   enumerable: true,
-  get: function () { return chunkPRQGEYWK_js.paginate; }
+  get: function () { return chunkIU4XNEP2_js.paginate; }
 });
 Object.defineProperty(exports, "paginateItems", {
   enumerable: true,
-  get: function () { return chunkPRQGEYWK_js.paginateItems; }
+  get: function () { return chunkIU4XNEP2_js.paginateItems; }
 });
 Object.defineProperty(exports, "refreshUserToken", {
   enumerable: true,
-  get: function () { return chunkPRQGEYWK_js.refreshUserToken; }
+  get: function () { return chunkIU4XNEP2_js.refreshUserToken; }
 });
 Object.defineProperty(exports, "repostPlaylist", {
   enumerable: true,
-  get: function () { return chunkPRQGEYWK_js.repostPlaylist; }
+  get: function () { return chunkIU4XNEP2_js.repostPlaylist; }
 });
 Object.defineProperty(exports, "repostTrack", {
   enumerable: true,
-  get: function () { return chunkPRQGEYWK_js.repostTrack; }
+  get: function () { return chunkIU4XNEP2_js.repostTrack; }
 });
 Object.defineProperty(exports, "resolveUrl", {
   enumerable: true,
-  get: function () { return chunkPRQGEYWK_js.resolveUrl; }
+  get: function () { return chunkIU4XNEP2_js.resolveUrl; }
 });
 Object.defineProperty(exports, "scFetch", {
   enumerable: true,
-  get: function () { return chunkPRQGEYWK_js.scFetch; }
+  get: function () { return chunkIU4XNEP2_js.scFetch; }
 });
 Object.defineProperty(exports, "scFetchUrl", {
   enumerable: true,
-  get: function () { return chunkPRQGEYWK_js.scFetchUrl; }
+  get: function () { return chunkIU4XNEP2_js.scFetchUrl; }
 });
 Object.defineProperty(exports, "searchPlaylists", {
   enumerable: true,
-  get: function () { return chunkPRQGEYWK_js.searchPlaylists; }
+  get: function () { return chunkIU4XNEP2_js.searchPlaylists; }
 });
 Object.defineProperty(exports, "searchTracks", {
   enumerable: true,
-  get: function () { return chunkPRQGEYWK_js.searchTracks; }
+  get: function () { return chunkIU4XNEP2_js.searchTracks; }
 });
 Object.defineProperty(exports, "searchUsers", {
   enumerable: true,
-  get: function () { return chunkPRQGEYWK_js.searchUsers; }
+  get: function () { return chunkIU4XNEP2_js.searchUsers; }
 });
 Object.defineProperty(exports, "signOut", {
   enumerable: true,
-  get: function () { return chunkPRQGEYWK_js.signOut; }
+  get: function () { return chunkIU4XNEP2_js.signOut; }
 });
 Object.defineProperty(exports, "unfollowUser", {
   enumerable: true,
-  get: function () { return chunkPRQGEYWK_js.unfollowUser; }
+  get: function () { return chunkIU4XNEP2_js.unfollowUser; }
 });
 Object.defineProperty(exports, "unlikePlaylist", {
   enumerable: true,
-  get: function () { return chunkPRQGEYWK_js.unlikePlaylist; }
+  get: function () { return chunkIU4XNEP2_js.unlikePlaylist; }
 });
 Object.defineProperty(exports, "unlikeTrack", {
   enumerable: true,
-  get: function () { return chunkPRQGEYWK_js.unlikeTrack; }
+  get: function () { return chunkIU4XNEP2_js.unlikeTrack; }
 });
 Object.defineProperty(exports, "unrepostPlaylist", {
   enumerable: true,
-  get: function () { return chunkPRQGEYWK_js.unrepostPlaylist; }
+  get: function () { return chunkIU4XNEP2_js.unrepostPlaylist; }
 });
 Object.defineProperty(exports, "unrepostTrack", {
   enumerable: true,
-  get: function () { return chunkPRQGEYWK_js.unrepostTrack; }
+  get: function () { return chunkIU4XNEP2_js.unrepostTrack; }
 });
 Object.defineProperty(exports, "updatePlaylist", {
   enumerable: true,
-  get: function () { return chunkPRQGEYWK_js.updatePlaylist; }
+  get: function () { return chunkIU4XNEP2_js.updatePlaylist; }
 });
 Object.defineProperty(exports, "updateTrack", {
   enumerable: true,
-  get: function () { return chunkPRQGEYWK_js.updateTrack; }
+  get: function () { return chunkIU4XNEP2_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-SCUOUK3L.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-G6S6GM75.mjs';
 export { SoundCloudError } from './chunk-CYDTNVV3.mjs';
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map

package/llms.txt

@@ -0,0 +1,195 @@
+# soundcloud-api-ts v1.9.2
+
+> A TypeScript client for the SoundCloud API. Zero dependencies, native fetch, full OAuth 2.1 + PKCE support.
+
+## Installation
+
+    npm install soundcloud-api-ts
+
+## Quick Start
+
+```ts
+import { SoundCloudClient } from 'soundcloud-api-ts';
+
+const sc = new SoundCloudClient({
+  clientId: 'YOUR_CLIENT_ID',
+  clientSecret: 'YOUR_CLIENT_SECRET',
+  redirectUri: 'https://example.com/callback', // optional, needed for user auth
+});
+
+// Get a client credentials token
+const token = await sc.auth.getClientToken();
+sc.setToken(token.access_token);
+
+// Fetch a track
+const track = await sc.tracks.getTrack(123456);
+console.log(track.title);
+```
+
+## API Reference
+
+All methods accept an optional trailing `{ token?: string }` parameter to override the stored token.
+Paginated responses return `SoundCloudPaginatedResponse<T>` with `collection: T[]` and `next_href?: string`.
+
+### Auth (sc.auth)
+
+    getAuthorizationUrl(options?: { state?: string; codeChallenge?: string }): string
+    getClientToken(): Promise<SoundCloudToken>
+    getUserToken(code: string, codeVerifier?: string): Promise<SoundCloudToken>
+    refreshUserToken(refreshToken: string): Promise<SoundCloudToken>
+    signOut(accessToken: string): Promise<void>
+
+### PKCE Helpers (standalone exports)
+
+    generateCodeVerifier(): string
+    generateCodeChallenge(verifier: string): Promise<string>
+
+### Tracks (sc.tracks)
+
+    getTrack(trackId: string | number): Promise<SoundCloudTrack>
+    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>
+    getLikes(trackId: string | number, limit?: number): Promise<SoundCloudPaginatedResponse<SoundCloudUser>>
+    getReposts(trackId: string | number, limit?: number): Promise<SoundCloudPaginatedResponse<SoundCloudUser>>
+    getRelated(trackId: string | number, limit?: number): Promise<SoundCloudTrack[]>
+    update(trackId: string | number, params: UpdateTrackParams): Promise<SoundCloudTrack>
+    delete(trackId: string | number): Promise<void>
+
+### Users (sc.users)
+
+    getUser(userId: string | number): Promise<SoundCloudUser>
+    getFollowers(userId: string | number, limit?: number): Promise<SoundCloudPaginatedResponse<SoundCloudUser>>
+    getFollowings(userId: string | number, limit?: number): Promise<SoundCloudPaginatedResponse<SoundCloudUser>>
+    getTracks(userId: string | number, limit?: number): Promise<SoundCloudPaginatedResponse<SoundCloudTrack>>
+    getPlaylists(userId: string | number, limit?: number): Promise<SoundCloudPaginatedResponse<SoundCloudPlaylist>>
+    getLikesTracks(userId: string | number, limit?: number, cursor?: string): Promise<SoundCloudPaginatedResponse<SoundCloudTrack>>
+    getLikesPlaylists(userId: string | number, limit?: number): Promise<SoundCloudPaginatedResponse<SoundCloudPlaylist>>
+    getWebProfiles(userId: string | number): Promise<SoundCloudWebProfile[]>
+
+### Playlists (sc.playlists)
+
+    getPlaylist(playlistId: string | number): Promise<SoundCloudPlaylist>
+    getTracks(playlistId: string | number, limit?: number, offset?: number): Promise<SoundCloudPaginatedResponse<SoundCloudTrack>>
+    getReposts(playlistId: string | number, limit?: number): Promise<SoundCloudPaginatedResponse<SoundCloudUser>>
+    create(params: CreatePlaylistParams): Promise<SoundCloudPlaylist>
+    update(playlistId: string | number, params: UpdatePlaylistParams): Promise<SoundCloudPlaylist>
+    delete(playlistId: string | number): Promise<void>
+
+### Search (sc.search)
+
+    tracks(query: string, pageNumber?: number): Promise<SoundCloudPaginatedResponse<SoundCloudTrack>>
+    users(query: string, pageNumber?: number): Promise<SoundCloudPaginatedResponse<SoundCloudUser>>
+    playlists(query: string, pageNumber?: number): Promise<SoundCloudPaginatedResponse<SoundCloudPlaylist>>
+
+### Me — Authenticated User (sc.me)
+
+    getMe(): Promise<SoundCloudMe>
+    getActivities(limit?: number): Promise<SoundCloudActivitiesResponse>
+    getActivitiesOwn(limit?: number): Promise<SoundCloudActivitiesResponse>
+    getActivitiesTracks(limit?: number): Promise<SoundCloudActivitiesResponse>
+    getLikesTracks(limit?: number): Promise<SoundCloudPaginatedResponse<SoundCloudTrack>>
+    getLikesPlaylists(limit?: number): Promise<SoundCloudPaginatedResponse<SoundCloudPlaylist>>
+    getFollowings(limit?: number): Promise<SoundCloudPaginatedResponse<SoundCloudUser>>
+    getFollowingsTracks(limit?: number): Promise<SoundCloudPaginatedResponse<SoundCloudTrack>>
+    getFollowers(limit?: number): Promise<SoundCloudPaginatedResponse<SoundCloudUser>>
+    getTracks(limit?: number): Promise<SoundCloudPaginatedResponse<SoundCloudTrack>>
+    getPlaylists(limit?: number): Promise<SoundCloudPaginatedResponse<SoundCloudPlaylist>>
+    follow(userUrn: string | number): Promise<void>
+    unfollow(userUrn: string | number): Promise<void>
+
+### Likes (sc.likes)
+
+    likeTrack(trackId: string | number): Promise<boolean>
+    unlikeTrack(trackId: string | number): Promise<boolean>
+    likePlaylist(playlistId: string | number): Promise<boolean>
+    unlikePlaylist(playlistId: string | number): Promise<boolean>
+
+### Reposts (sc.reposts)
+
+    repostTrack(trackId: string | number): Promise<boolean>
+    unrepostTrack(trackId: string | number): Promise<boolean>
+    repostPlaylist(playlistId: string | number): Promise<boolean>
+    unrepostPlaylist(playlistId: string | number): Promise<boolean>
+
+### Resolve (sc.resolve)
+
+    resolveUrl(url: string): Promise<string>
+
+### Pagination (instance methods)
+
+    sc.paginate<T>(firstPage: () => Promise<PaginatedResponse<T>>): AsyncGenerator<T[]>
+    sc.paginateItems<T>(firstPage: () => Promise<PaginatedResponse<T>>): AsyncGenerator<T>
+    sc.fetchAll<T>(firstPage: () => Promise<PaginatedResponse<T>>, options?: { maxItems?: number }): Promise<T[]>
+
+### Client Methods
+
+    sc.setToken(accessToken: string, refreshToken?: string): void
+    sc.clearToken(): void
+    sc.accessToken: string | undefined
+    sc.refreshToken: string | undefined
+
+## Common Patterns
+
+### Client Credentials Flow (server-to-server)
+```ts
+const sc = new SoundCloudClient({ clientId: '...', clientSecret: '...' });
+const token = await sc.auth.getClientToken();
+sc.setToken(token.access_token);
+```
+
+### User Authorization Flow (with PKCE)
+```ts
+import { SoundCloudClient, generateCodeVerifier, generateCodeChallenge } from 'soundcloud-api-ts';
+
+const sc = new SoundCloudClient({ clientId: '...', clientSecret: '...', redirectUri: 'https://...' });
+const verifier = generateCodeVerifier();
+const challenge = await generateCodeChallenge(verifier);
+const authUrl = sc.auth.getAuthorizationUrl({ state: 'random', codeChallenge: challenge });
+// redirect user to authUrl, get code from callback
+const token = await sc.auth.getUserToken(code, verifier);
+sc.setToken(token.access_token, token.refresh_token);
+```
+
+### Pagination
+```ts
+// Iterate individual items across all pages
+for await (const track of sc.paginateItems(() => sc.search.tracks('lofi'))) {
+  console.log(track.title);
+}
+
+// Collect all into an array (with optional limit)
+const all = await sc.fetchAll(() => sc.search.tracks('lofi'), { maxItems: 100 });
+```
+
+### Error Handling
+```ts
+import { SoundCloudError } from 'soundcloud-api-ts';
+
+try {
+  await sc.tracks.getTrack(999);
+} catch (err) {
+  if (err instanceof SoundCloudError) {
+    if (err.isNotFound) console.log('Not found');
+    if (err.isRateLimited) console.log('Rate limited');
+    if (err.isUnauthorized) console.log('Bad token');
+    console.log(err.status, err.message);
+  }
+}
+```
+
+### Auto Token Refresh
+```ts
+const sc = new SoundCloudClient({
+  clientId: '...', clientSecret: '...',
+  onTokenRefresh: async (client) => {
+    const newToken = await client.auth.refreshUserToken(client.refreshToken!);
+    client.setToken(newToken.access_token, newToken.refresh_token);
+    return newToken;
+  },
+});
+```
+
+## Full Documentation
+
+https://twin-paws.github.io/soundcloud-api-ts/

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "soundcloud-api-ts",
-  "version": "1.9.1",
+  "version": "1.9.3",
   "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",
@@ -22,7 +22,9 @@
     }
   },
   "files": [
-    "dist"
+    "dist",
+    "llms.txt",
+    "AGENTS.md"
   ],
   "scripts": {
     "build": "tsup",