soundcloud-api-ts 1.6.2 → 1.6.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +16 -7
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -25,14 +25,23 @@ A fully-typed TypeScript client for the SoundCloud API. Zero dependencies, nativ
25
25
 
26
26
  ## Comparison
27
27
 
28
- | Feature | soundcloud-api-ts | soundcloud.ts | node-soundcloud |
28
+ | Feature | soundcloud-api-ts | soundcloud.ts | soundcloud-fetch |
29
29
  | --- | --- | --- | --- |
30
- | TypeScript | ✅ Native | ✅ | ❌ |
31
- | Dependencies | 0 | varies | varies |
32
- | OAuth 2.0 | ✅ Full | Partial | Partial |
33
- | Auto token refresh | ✅ | ❌ | ❌ |
34
- | PKCE | ✅ | ❌ | ❌ |
35
- | Maintained | ✅ 2026 | — | — |
30
+ | TypeScript | ✅ Native | ✅ | ✅ |
31
+ | Dependencies | **0** | 1 | 3 (lodash, cookie, undici) |
32
+ | Auth method | **Official OAuth 2.0** | ⚠️ Scrape client ID from browser | ⚠️ Scrape client ID from browser |
33
+ | PKCE support | ✅ | ❌ | ❌ |
34
+ | Auto token refresh | ✅ on 401 | ❌ | ❌ |
35
+ | Auto retry (429/5xx) | ✅ exponential backoff | ❌ | ❌ |
36
+ | CLI tool | ✅ `sc-cli` | ❌ | ❌ |
37
+ | Pagination helpers | ✅ async iterators | ❌ | ✅ |
38
+ | Typed errors | ✅ `SoundCloudError` | ❌ | ❌ |
39
+ | Test coverage | **94%** | — | — |
40
+ | API docs site | ✅ [TypeDoc](https://twin-paws.github.io/soundcloud-api-ts/) | ✅ | ❌ |
41
+ | LLM/AI-friendly | ✅ llms.txt + AGENTS.md | ❌ | ❌ |
42
+ | Maintained | ✅ 2026 | ✅ 2025 | ✅ 2026 |
43
+
44
+ > **Why does auth method matter?** `soundcloud.ts` and `soundcloud-fetch` require you to open browser dev tools, inspect network traffic, and manually copy your client ID — which can break anytime SoundCloud changes their frontend. `soundcloud-api-ts` uses the **official OAuth 2.0 API** with registered app credentials, PKCE for public clients, and automatic token refresh.
36
45
 
37
46
  ## Install
38
47
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "soundcloud-api-ts",
3
- "version": "1.6.2",
3
+ "version": "1.6.3",
4
4
  "description": "A TypeScript client for the SoundCloud API. Zero dependencies, native fetch, full OAuth 2.0 + PKCE support.",
5
5
  "bin": {
6
6
  "sc-cli": "./dist/cli.js",