soundcloud-api-ts 1.9.2 → 1.10.0

package/README.md

@@ -7,7 +7,7 @@
 [![bundle size](https://img.shields.io/bundlephobia/minzip/soundcloud-api-ts)](https://bundlephobia.com/package/soundcloud-api-ts)
 [![install size](https://packagephobia.com/badge?p=soundcloud-api-ts)](https://packagephobia.com/result?p=soundcloud-api-ts)
 [![TypeScript](https://img.shields.io/badge/TypeScript-5.9+-blue.svg)](https://www.typescriptlang.org/)
-[![Node](https://img.shields.io/badge/Node.js-≥20-339933.svg)](https://nodejs.org/)
+[![Node](https://img.shields.io/badge/Node.js-≥22-339933.svg)](https://nodejs.org/)
 [![coverage](https://img.shields.io/badge/coverage-100%25-brightgreen.svg)]()
 [![docs](https://img.shields.io/badge/docs-TypeDoc-blue.svg)](https://twin-paws.github.io/soundcloud-api-ts/)
 [![GitHub stars](https://img.shields.io/github/stars/twin-paws/soundcloud-api-ts)](https://github.com/twin-paws/soundcloud-api-ts)
@@ -456,6 +456,10 @@ Full API documentation is available at **[twin-paws.github.io/soundcloud-api-ts]
 
 See [CHANGELOG.md](CHANGELOG.md) for release history.
 
+## Related Packages
+
+- **[soundcloud-api-ts-next](https://github.com/twin-paws/soundcloud-api-ts-next)** — React hooks + Next.js API route handlers built on this package. Use it when building Next.js apps that need SoundCloud data with secrets kept server-side.
+
 ## Contributing
 
 Contributions are welcome! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.

package/dist/{chunk-NBKG62HR.js → chunk-MLVA534Z.js}

@@ -55,5 +55,5 @@ var SoundCloudError = class extends Error {
 };
 
 exports.SoundCloudError = SoundCloudError;
-//# sourceMappingURL=chunk-NBKG62HR.js.map
-//# sourceMappingURL=chunk-NBKG62HR.js.map
+//# sourceMappingURL=chunk-MLVA534Z.js.map
+//# sourceMappingURL=chunk-MLVA534Z.js.map

package/dist/{chunk-CYDTNVV3.mjs.map → chunk-MLVA534Z.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/errors.ts"],"names":[],"mappings":";AA6DO,IAAM,eAAA,GAAN,cAA8B,KAAA,CAAM;AAAA;AAAA,EAEhC,MAAA;AAAA;AAAA,EAEA,UAAA;AAAA;AAAA,EAEA,SAAA;AAAA;AAAA,EAEA,QAAA;AAAA;AAAA,EAEA,MAAA;AAAA;AAAA,EAEA,IAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAST,WAAA,CAAY,MAAA,EAAgB,UAAA,EAAoB,IAAA,EAA4B;AAE1E,IAAA,MAAM,MACJ,IAAA,EAAM,OAAA,IACN,IAAA,EAAM,iBAAA,IACN,MAAM,UAAA,IACN,IAAA,EAAM,MAAA,GAAS,CAAC,GAAG,aAAA,IACnB,IAAA,EAAM,SACN,CAAA,EAAG,MAAM,IAAI,UAAU,CAAA,CAAA;AAEzB,IAAA,KAAA,CAAM,GAAG,CAAA;AACT,IAAA,IAAA,CAAK,IAAA,GAAO,iBAAA;AACZ,IAAA,IAAA,CAAK,MAAA,GAAS,MAAA;AACd,IAAA,IAAA,CAAK,UAAA,GAAa,UAAA;AAClB,IAAA,IAAA,CAAK,SAAA,GAAY,MAAM,UAAA,IAAc,MAAA;AACrC,IAAA,IAAA,CAAK,QAAA,GAAW,MAAM,IAAA,IAAQ,MAAA;AAC9B,IAAA,IAAA,CAAK,SACH,IAAA,EAAM,MAAA,EACF,GAAA,CAAI,CAAC,MAAM,CAAA,CAAE,aAAa,CAAA,CAC3B,MAAA,CAAO,CAAC,CAAA,KAAmB,CAAC,CAAC,CAAC,KAAK,EAAC;AACzC,IAAA,IAAA,CAAK,IAAA,GAAO,IAAA;AAAA,EACd;AAAA;AAAA,EAGA,IAAI,cAAA,GAA0B;AAC5B,IAAA,OAAO,KAAK,MAAA,KAAW,GAAA;AAAA,EACzB;AAAA;AAAA,EAGA,IAAI,WAAA,GAAuB;AACzB,IAAA,OAAO,KAAK,MAAA,KAAW,GAAA;AAAA,EACzB;AAAA;AAAA,EAGA,IAAI,UAAA,GAAsB;AACxB,IAAA,OAAO,KAAK,MAAA,KAAW,GAAA;AAAA,EACzB;AAAA;AAAA,EAGA,IAAI,aAAA,GAAyB;AAC3B,IAAA,OAAO,KAAK,MAAA,KAAW,GAAA;AAAA,EACzB;AAAA;AAAA,EAGA,IAAI,aAAA,GAAyB;AAC3B,IAAA,OAAO,IAAA,CAAK,MAAA,IAAU,GAAA,IAAO,IAAA,CAAK,MAAA,GAAS,GAAA;AAAA,EAC7C;AACF","file":"chunk-CYDTNVV3.mjs","sourcesContent":["/**\n * Shape of error response bodies returned by the SoundCloud API.\n *\n * The API returns varying combinations of these fields depending on the endpoint\n * and error type. All fields are optional.\n *\n * @example\n * ```json\n * {\n *   \"code\": 401,\n *   \"message\": \"invalid_client\",\n *   \"link\": \"https://developers.soundcloud.com/docs/api/explorer/open-api\",\n *   \"status\": \"401 - Unauthorized\",\n *   \"errors\": [{\"error_message\": \"invalid_client\"}],\n *   \"error\": null,\n *   \"error_code\": \"invalid_client\"\n * }\n * ```\n *\n * @see https://developers.soundcloud.com/docs/api/explorer/open-api\n */\nexport interface SoundCloudErrorBody {\n  /** HTTP status code echoed in the response body */\n  code?: number;\n  /** Error message from SoundCloud (e.g. \"invalid_client\", \"404 - Not Found\") */\n  message?: string;\n  /** Human-readable status string (e.g. \"401 - Unauthorized\") */\n  status?: string;\n  /** Link to SoundCloud API documentation */\n  link?: string;\n  /** Array of individual error detail objects */\n  errors?: Array<{ error_message?: string }>;\n  /** Generic error field — typically null in SoundCloud responses */\n  error?: string | null;\n  /** Machine-readable error code (e.g. \"invalid_client\") */\n  error_code?: string;\n  /** OAuth error description, present in `/oauth2/token` error responses */\n  error_description?: string;\n}\n\n/**\n * Error class thrown when a SoundCloud API request fails.\n *\n * Provides structured access to HTTP status, error codes, and convenience\n * getters for common error categories.\n *\n * @example\n * ```ts\n * import { SoundCloudError } from 'soundcloud-api-ts';\n *\n * try {\n *   await sc.tracks.getTrack(999999999);\n * } catch (err) {\n *   if (err instanceof SoundCloudError) {\n *     if (err.isNotFound) console.log('Track not found');\n *     if (err.isRateLimited) console.log('Rate limited, retry later');\n *     console.log(err.status, err.message);\n *   }\n * }\n * ```\n */\nexport class SoundCloudError extends Error {\n  /** HTTP status code of the failed response (e.g. 401, 404, 429) */\n  readonly status: number;\n  /** HTTP status text of the failed response (e.g. \"Unauthorized\", \"Not Found\") */\n  readonly statusText: string;\n  /** Machine-readable error code from SoundCloud (e.g. \"invalid_client\"), if present */\n  readonly errorCode?: string;\n  /** Link to SoundCloud API documentation, if included in the error response */\n  readonly docsLink?: string;\n  /** Individual error messages extracted from the response body's `errors` array */\n  readonly errors: string[];\n  /** The full parsed error response body, if available */\n  readonly body?: SoundCloudErrorBody;\n\n  /**\n   * Creates a new SoundCloudError.\n   *\n   * @param status - HTTP status code\n   * @param statusText - HTTP status text\n   * @param body - Parsed JSON error response body from SoundCloud, if available\n   */\n  constructor(status: number, statusText: string, body?: SoundCloudErrorBody) {\n    // Build the most useful message we can from SC's response\n    const msg =\n      body?.message ||\n      body?.error_description ||\n      body?.error_code ||\n      body?.errors?.[0]?.error_message ||\n      body?.error ||\n      `${status} ${statusText}`;\n\n    super(msg);\n    this.name = \"SoundCloudError\";\n    this.status = status;\n    this.statusText = statusText;\n    this.errorCode = body?.error_code ?? undefined;\n    this.docsLink = body?.link ?? undefined;\n    this.errors =\n      body?.errors\n        ?.map((e) => e.error_message)\n        .filter((m): m is string => !!m) ?? [];\n    this.body = body;\n  }\n\n  /** True if status is 401 Unauthorized (invalid or expired token) */\n  get isUnauthorized(): boolean {\n    return this.status === 401;\n  }\n\n  /** True if status is 403 Forbidden (insufficient permissions) */\n  get isForbidden(): boolean {\n    return this.status === 403;\n  }\n\n  /** True if status is 404 Not Found (resource does not exist) */\n  get isNotFound(): boolean {\n    return this.status === 404;\n  }\n\n  /** True if status is 429 Too Many Requests (rate limit exceeded) */\n  get isRateLimited(): boolean {\n    return this.status === 429;\n  }\n\n  /** True if status is 5xx (SoundCloud server error) */\n  get isServerError(): boolean {\n    return this.status >= 500 && this.status < 600;\n  }\n}\n"]}
+{"version":3,"sources":["../src/errors.ts"],"names":[],"mappings":";;;AA6DO,IAAM,eAAA,GAAN,cAA8B,KAAA,CAAM;AAAA;AAAA,EAEhC,MAAA;AAAA;AAAA,EAEA,UAAA;AAAA;AAAA,EAEA,SAAA;AAAA;AAAA,EAEA,QAAA;AAAA;AAAA,EAEA,MAAA;AAAA;AAAA,EAEA,IAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAST,WAAA,CAAY,MAAA,EAAgB,UAAA,EAAoB,IAAA,EAA4B;AAE1E,IAAA,MAAM,MACJ,IAAA,EAAM,OAAA,IACN,IAAA,EAAM,iBAAA,IACN,MAAM,UAAA,IACN,IAAA,EAAM,MAAA,GAAS,CAAC,GAAG,aAAA,IACnB,IAAA,EAAM,SACN,CAAA,EAAG,MAAM,IAAI,UAAU,CAAA,CAAA;AAEzB,IAAA,KAAA,CAAM,GAAG,CAAA;AACT,IAAA,IAAA,CAAK,IAAA,GAAO,iBAAA;AACZ,IAAA,IAAA,CAAK,MAAA,GAAS,MAAA;AACd,IAAA,IAAA,CAAK,UAAA,GAAa,UAAA;AAClB,IAAA,IAAA,CAAK,SAAA,GAAY,MAAM,UAAA,IAAc,MAAA;AACrC,IAAA,IAAA,CAAK,QAAA,GAAW,MAAM,IAAA,IAAQ,MAAA;AAC9B,IAAA,IAAA,CAAK,SACH,IAAA,EAAM,MAAA,EACF,GAAA,CAAI,CAAC,MAAM,CAAA,CAAE,aAAa,CAAA,CAC3B,MAAA,CAAO,CAAC,CAAA,KAAmB,CAAC,CAAC,CAAC,KAAK,EAAC;AACzC,IAAA,IAAA,CAAK,IAAA,GAAO,IAAA;AAAA,EACd;AAAA;AAAA,EAGA,IAAI,cAAA,GAA0B;AAC5B,IAAA,OAAO,KAAK,MAAA,KAAW,GAAA;AAAA,EACzB;AAAA;AAAA,EAGA,IAAI,WAAA,GAAuB;AACzB,IAAA,OAAO,KAAK,MAAA,KAAW,GAAA;AAAA,EACzB;AAAA;AAAA,EAGA,IAAI,UAAA,GAAsB;AACxB,IAAA,OAAO,KAAK,MAAA,KAAW,GAAA;AAAA,EACzB;AAAA;AAAA,EAGA,IAAI,aAAA,GAAyB;AAC3B,IAAA,OAAO,KAAK,MAAA,KAAW,GAAA;AAAA,EACzB;AAAA;AAAA,EAGA,IAAI,aAAA,GAAyB;AAC3B,IAAA,OAAO,IAAA,CAAK,MAAA,IAAU,GAAA,IAAO,IAAA,CAAK,MAAA,GAAS,GAAA;AAAA,EAC7C;AACF","file":"chunk-MLVA534Z.js","sourcesContent":["/**\n * Shape of error response bodies returned by the SoundCloud API.\n *\n * The API returns varying combinations of these fields depending on the endpoint\n * and error type. All fields are optional.\n *\n * @example\n * ```json\n * {\n *   \"code\": 401,\n *   \"message\": \"invalid_client\",\n *   \"link\": \"https://developers.soundcloud.com/docs/api/explorer/open-api\",\n *   \"status\": \"401 - Unauthorized\",\n *   \"errors\": [{\"error_message\": \"invalid_client\"}],\n *   \"error\": null,\n *   \"error_code\": \"invalid_client\"\n * }\n * ```\n *\n * @see https://developers.soundcloud.com/docs/api/explorer/open-api\n */\nexport interface SoundCloudErrorBody {\n  /** HTTP status code echoed in the response body */\n  code?: number;\n  /** Error message from SoundCloud (e.g. \"invalid_client\", \"404 - Not Found\") */\n  message?: string;\n  /** Human-readable status string (e.g. \"401 - Unauthorized\") */\n  status?: string;\n  /** Link to SoundCloud API documentation */\n  link?: string;\n  /** Array of individual error detail objects */\n  errors?: Array<{ error_message?: string }>;\n  /** Generic error field — typically null in SoundCloud responses */\n  error?: string | null;\n  /** Machine-readable error code (e.g. \"invalid_client\") */\n  error_code?: string;\n  /** OAuth error description, present in `/oauth/token` error responses */\n  error_description?: string;\n}\n\n/**\n * Error class thrown when a SoundCloud API request fails.\n *\n * Provides structured access to HTTP status, error codes, and convenience\n * getters for common error categories.\n *\n * @example\n * ```ts\n * import { SoundCloudError } from 'soundcloud-api-ts';\n *\n * try {\n *   await sc.tracks.getTrack(999999999);\n * } catch (err) {\n *   if (err instanceof SoundCloudError) {\n *     if (err.isNotFound) console.log('Track not found');\n *     if (err.isRateLimited) console.log('Rate limited, retry later');\n *     console.log(err.status, err.message);\n *   }\n * }\n * ```\n */\nexport class SoundCloudError extends Error {\n  /** HTTP status code of the failed response (e.g. 401, 404, 429) */\n  readonly status: number;\n  /** HTTP status text of the failed response (e.g. \"Unauthorized\", \"Not Found\") */\n  readonly statusText: string;\n  /** Machine-readable error code from SoundCloud (e.g. \"invalid_client\"), if present */\n  readonly errorCode?: string;\n  /** Link to SoundCloud API documentation, if included in the error response */\n  readonly docsLink?: string;\n  /** Individual error messages extracted from the response body's `errors` array */\n  readonly errors: string[];\n  /** The full parsed error response body, if available */\n  readonly body?: SoundCloudErrorBody;\n\n  /**\n   * Creates a new SoundCloudError.\n   *\n   * @param status - HTTP status code\n   * @param statusText - HTTP status text\n   * @param body - Parsed JSON error response body from SoundCloud, if available\n   */\n  constructor(status: number, statusText: string, body?: SoundCloudErrorBody) {\n    // Build the most useful message we can from SC's response\n    const msg =\n      body?.message ||\n      body?.error_description ||\n      body?.error_code ||\n      body?.errors?.[0]?.error_message ||\n      body?.error ||\n      `${status} ${statusText}`;\n\n    super(msg);\n    this.name = \"SoundCloudError\";\n    this.status = status;\n    this.statusText = statusText;\n    this.errorCode = body?.error_code ?? undefined;\n    this.docsLink = body?.link ?? undefined;\n    this.errors =\n      body?.errors\n        ?.map((e) => e.error_message)\n        .filter((m): m is string => !!m) ?? [];\n    this.body = body;\n  }\n\n  /** True if status is 401 Unauthorized (invalid or expired token) */\n  get isUnauthorized(): boolean {\n    return this.status === 401;\n  }\n\n  /** True if status is 403 Forbidden (insufficient permissions) */\n  get isForbidden(): boolean {\n    return this.status === 403;\n  }\n\n  /** True if status is 404 Not Found (resource does not exist) */\n  get isNotFound(): boolean {\n    return this.status === 404;\n  }\n\n  /** True if status is 429 Too Many Requests (rate limit exceeded) */\n  get isRateLimited(): boolean {\n    return this.status === 429;\n  }\n\n  /** True if status is 5xx (SoundCloud server error) */\n  get isServerError(): boolean {\n    return this.status >= 500 && this.status < 600;\n  }\n}\n"]}

package/dist/{chunk-CYDTNVV3.mjs → chunk-QYYEWUIJ.mjs}

@@ -53,5 +53,5 @@ var SoundCloudError = class extends Error {
 };
 
 export { SoundCloudError };
-//# sourceMappingURL=chunk-CYDTNVV3.mjs.map
-//# sourceMappingURL=chunk-CYDTNVV3.mjs.map
+//# sourceMappingURL=chunk-QYYEWUIJ.mjs.map
+//# sourceMappingURL=chunk-QYYEWUIJ.mjs.map

package/dist/chunk-QYYEWUIJ.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/errors.ts"],"names":[],"mappings":";AA6DO,IAAM,eAAA,GAAN,cAA8B,KAAA,CAAM;AAAA;AAAA,EAEhC,MAAA;AAAA;AAAA,EAEA,UAAA;AAAA;AAAA,EAEA,SAAA;AAAA;AAAA,EAEA,QAAA;AAAA;AAAA,EAEA,MAAA;AAAA;AAAA,EAEA,IAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAST,WAAA,CAAY,MAAA,EAAgB,UAAA,EAAoB,IAAA,EAA4B;AAE1E,IAAA,MAAM,MACJ,IAAA,EAAM,OAAA,IACN,IAAA,EAAM,iBAAA,IACN,MAAM,UAAA,IACN,IAAA,EAAM,MAAA,GAAS,CAAC,GAAG,aAAA,IACnB,IAAA,EAAM,SACN,CAAA,EAAG,MAAM,IAAI,UAAU,CAAA,CAAA;AAEzB,IAAA,KAAA,CAAM,GAAG,CAAA;AACT,IAAA,IAAA,CAAK,IAAA,GAAO,iBAAA;AACZ,IAAA,IAAA,CAAK,MAAA,GAAS,MAAA;AACd,IAAA,IAAA,CAAK,UAAA,GAAa,UAAA;AAClB,IAAA,IAAA,CAAK,SAAA,GAAY,MAAM,UAAA,IAAc,MAAA;AACrC,IAAA,IAAA,CAAK,QAAA,GAAW,MAAM,IAAA,IAAQ,MAAA;AAC9B,IAAA,IAAA,CAAK,SACH,IAAA,EAAM,MAAA,EACF,GAAA,CAAI,CAAC,MAAM,CAAA,CAAE,aAAa,CAAA,CAC3B,MAAA,CAAO,CAAC,CAAA,KAAmB,CAAC,CAAC,CAAC,KAAK,EAAC;AACzC,IAAA,IAAA,CAAK,IAAA,GAAO,IAAA;AAAA,EACd;AAAA;AAAA,EAGA,IAAI,cAAA,GAA0B;AAC5B,IAAA,OAAO,KAAK,MAAA,KAAW,GAAA;AAAA,EACzB;AAAA;AAAA,EAGA,IAAI,WAAA,GAAuB;AACzB,IAAA,OAAO,KAAK,MAAA,KAAW,GAAA;AAAA,EACzB;AAAA;AAAA,EAGA,IAAI,UAAA,GAAsB;AACxB,IAAA,OAAO,KAAK,MAAA,KAAW,GAAA;AAAA,EACzB;AAAA;AAAA,EAGA,IAAI,aAAA,GAAyB;AAC3B,IAAA,OAAO,KAAK,MAAA,KAAW,GAAA;AAAA,EACzB;AAAA;AAAA,EAGA,IAAI,aAAA,GAAyB;AAC3B,IAAA,OAAO,IAAA,CAAK,MAAA,IAAU,GAAA,IAAO,IAAA,CAAK,MAAA,GAAS,GAAA;AAAA,EAC7C;AACF","file":"chunk-QYYEWUIJ.mjs","sourcesContent":["/**\n * Shape of error response bodies returned by the SoundCloud API.\n *\n * The API returns varying combinations of these fields depending on the endpoint\n * and error type. All fields are optional.\n *\n * @example\n * ```json\n * {\n *   \"code\": 401,\n *   \"message\": \"invalid_client\",\n *   \"link\": \"https://developers.soundcloud.com/docs/api/explorer/open-api\",\n *   \"status\": \"401 - Unauthorized\",\n *   \"errors\": [{\"error_message\": \"invalid_client\"}],\n *   \"error\": null,\n *   \"error_code\": \"invalid_client\"\n * }\n * ```\n *\n * @see https://developers.soundcloud.com/docs/api/explorer/open-api\n */\nexport interface SoundCloudErrorBody {\n  /** HTTP status code echoed in the response body */\n  code?: number;\n  /** Error message from SoundCloud (e.g. \"invalid_client\", \"404 - Not Found\") */\n  message?: string;\n  /** Human-readable status string (e.g. \"401 - Unauthorized\") */\n  status?: string;\n  /** Link to SoundCloud API documentation */\n  link?: string;\n  /** Array of individual error detail objects */\n  errors?: Array<{ error_message?: string }>;\n  /** Generic error field — typically null in SoundCloud responses */\n  error?: string | null;\n  /** Machine-readable error code (e.g. \"invalid_client\") */\n  error_code?: string;\n  /** OAuth error description, present in `/oauth/token` error responses */\n  error_description?: string;\n}\n\n/**\n * Error class thrown when a SoundCloud API request fails.\n *\n * Provides structured access to HTTP status, error codes, and convenience\n * getters for common error categories.\n *\n * @example\n * ```ts\n * import { SoundCloudError } from 'soundcloud-api-ts';\n *\n * try {\n *   await sc.tracks.getTrack(999999999);\n * } catch (err) {\n *   if (err instanceof SoundCloudError) {\n *     if (err.isNotFound) console.log('Track not found');\n *     if (err.isRateLimited) console.log('Rate limited, retry later');\n *     console.log(err.status, err.message);\n *   }\n * }\n * ```\n */\nexport class SoundCloudError extends Error {\n  /** HTTP status code of the failed response (e.g. 401, 404, 429) */\n  readonly status: number;\n  /** HTTP status text of the failed response (e.g. \"Unauthorized\", \"Not Found\") */\n  readonly statusText: string;\n  /** Machine-readable error code from SoundCloud (e.g. \"invalid_client\"), if present */\n  readonly errorCode?: string;\n  /** Link to SoundCloud API documentation, if included in the error response */\n  readonly docsLink?: string;\n  /** Individual error messages extracted from the response body's `errors` array */\n  readonly errors: string[];\n  /** The full parsed error response body, if available */\n  readonly body?: SoundCloudErrorBody;\n\n  /**\n   * Creates a new SoundCloudError.\n   *\n   * @param status - HTTP status code\n   * @param statusText - HTTP status text\n   * @param body - Parsed JSON error response body from SoundCloud, if available\n   */\n  constructor(status: number, statusText: string, body?: SoundCloudErrorBody) {\n    // Build the most useful message we can from SC's response\n    const msg =\n      body?.message ||\n      body?.error_description ||\n      body?.error_code ||\n      body?.errors?.[0]?.error_message ||\n      body?.error ||\n      `${status} ${statusText}`;\n\n    super(msg);\n    this.name = \"SoundCloudError\";\n    this.status = status;\n    this.statusText = statusText;\n    this.errorCode = body?.error_code ?? undefined;\n    this.docsLink = body?.link ?? undefined;\n    this.errors =\n      body?.errors\n        ?.map((e) => e.error_message)\n        .filter((m): m is string => !!m) ?? [];\n    this.body = body;\n  }\n\n  /** True if status is 401 Unauthorized (invalid or expired token) */\n  get isUnauthorized(): boolean {\n    return this.status === 401;\n  }\n\n  /** True if status is 403 Forbidden (insufficient permissions) */\n  get isForbidden(): boolean {\n    return this.status === 403;\n  }\n\n  /** True if status is 404 Not Found (resource does not exist) */\n  get isNotFound(): boolean {\n    return this.status === 404;\n  }\n\n  /** True if status is 429 Too Many Requests (rate limit exceeded) */\n  get isRateLimited(): boolean {\n    return this.status === 429;\n  }\n\n  /** True if status is 5xx (SoundCloud server error) */\n  get isServerError(): boolean {\n    return this.status >= 500 && this.status < 600;\n  }\n}\n"]}

package/dist/{chunk-SCUOUK3L.mjs → chunk-RETVFKZM.mjs}

@@ -1,7 +1,8 @@
-import { SoundCloudError } from './chunk-CYDTNVV3.mjs';
+import { SoundCloudError } from './chunk-QYYEWUIJ.mjs';
 
 // src/client/http.ts
 var BASE_URL = "https://api.soundcloud.com";
+var AUTH_BASE_URL = "https://secure.soundcloud.com";
 var DEFAULT_RETRY = { maxRetries: 3, retryBaseDelay: 1e3 };
 function delay(ms) {
   return new Promise((resolve) => setTimeout(resolve, ms));
@@ -30,7 +31,8 @@ async function parseErrorBody(response) {
 async function scFetch(options, refreshCtx) {
   const retryConfig = refreshCtx?.retry ?? DEFAULT_RETRY;
   const execute = async (tokenOverride) => {
-    const url = `${BASE_URL}${options.path}`;
+    const isAuthPath = options.path.startsWith("/oauth");
+    const url = `${isAuthPath ? AUTH_BASE_URL : BASE_URL}${options.path}`;
     const headers = {
       Accept: "application/json"
     };
@@ -336,7 +338,7 @@ var SoundCloudClient = class _SoundCloudClient {
         params.set("code_challenge", options.codeChallenge);
         params.set("code_challenge_method", "S256");
       }
-      return `https://api.soundcloud.com/connect?${params}`;
+      return `https://secure.soundcloud.com/authorize?${params}`;
     }
     /**
      * Exchange client credentials for an access token (machine-to-machine auth).
@@ -354,7 +356,7 @@ var SoundCloudClient = class _SoundCloudClient {
      */
     async getClientToken() {
       return scFetch({
-        path: "/oauth2/token",
+        path: "/oauth/token",
         method: "POST",
         body: new URLSearchParams({
           grant_type: "client_credentials",
@@ -389,7 +391,7 @@ var SoundCloudClient = class _SoundCloudClient {
       };
       if (codeVerifier) params.code_verifier = codeVerifier;
       return scFetch({
-        path: "/oauth2/token",
+        path: "/oauth/token",
         method: "POST",
         body: new URLSearchParams(params)
       });
@@ -411,7 +413,7 @@ var SoundCloudClient = class _SoundCloudClient {
      */
     async refreshUserToken(refreshToken) {
       return scFetch({
-        path: "/oauth2/token",
+        path: "/oauth/token",
         method: "POST",
         body: new URLSearchParams({
           grant_type: "refresh_token",
@@ -1391,7 +1393,7 @@ var SoundCloudClient = class _SoundCloudClient {
 // src/auth/getClientToken.ts
 var getClientToken = (clientId, clientSecret) => {
   return scFetch({
-    path: "/oauth2/token",
+    path: "/oauth/token",
     method: "POST",
     body: new URLSearchParams({
       grant_type: "client_credentials",
@@ -1412,7 +1414,7 @@ var getUserToken = (clientId, clientSecret, redirectUri, code, codeVerifier) =>
   };
   if (codeVerifier) params.code_verifier = codeVerifier;
   return scFetch({
-    path: "/oauth2/token",
+    path: "/oauth/token",
     method: "POST",
     body: new URLSearchParams(params)
   });
@@ -1421,7 +1423,7 @@ var getUserToken = (clientId, clientSecret, redirectUri, code, codeVerifier) =>
 // src/auth/refreshUserToken.ts
 var refreshUserToken = (clientId, clientSecret, redirectUri, refreshToken) => {
   return scFetch({
-    path: "/oauth2/token",
+    path: "/oauth/token",
     method: "POST",
     body: new URLSearchParams({
       grant_type: "refresh_token",
@@ -1455,7 +1457,7 @@ function getAuthorizationUrl(clientId, redirectUri, options) {
     params.set("code_challenge", options.codeChallenge);
     params.set("code_challenge_method", "S256");
   }
-  return `https://api.soundcloud.com/connect?${params}`;
+  return `https://secure.soundcloud.com/authorize?${params}`;
 }
 
 // src/auth/pkce.ts
@@ -1679,5 +1681,5 @@ var unrepostPlaylist = async (token, playlistId) => {
 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-SCUOUK3L.mjs.map
-//# sourceMappingURL=chunk-SCUOUK3L.mjs.map
+//# sourceMappingURL=chunk-RETVFKZM.mjs.map
+//# sourceMappingURL=chunk-RETVFKZM.mjs.map