gerdur-core 2.12.0 → 2.13.1

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 (7) hide show
  1. package/CHANGELOG.md +26 -0
  2. package/README.md +655 -344
  3. package/dist/enrich/coverart.d.ts +19 -0
  4. package/dist/enrich/coverart.js +45 -1
  5. package/dist/enrich/index.d.ts +1 -1
  6. package/dist/enrich/index.js +3 -1
  7. package/package.json +19 -2
package/CHANGELOG.md CHANGED
@@ -1,5 +1,31 @@
1
1
  # Changelog
2
2
 
3
+ ## 2.13.1 - 2026-08-31
4
+
5
+ ### Docs
6
+
7
+ - **README rewritten** — restructured around use cases (a task-oriented guide
8
+ covering auth, lookups, URL/ISRC/UPC resolution, both search APIs, browse,
9
+ Flow/library, podcasts, previews, URL resolution, buffered and streamed
10
+ downloads, decryption, tagging, enrichment, multi-account sessions and the HTTP
11
+ helpers), a full collapsible API reference, an errors table and a types
12
+ summary. npm-facing tone: badges, single-line description, no internal-project
13
+ references.
14
+ - `package.json` `description` rewritten and `keywords` added for npm search.
15
+
16
+ No code changes.
17
+
18
+ ## 2.13.0 - 2026-08-31
19
+
20
+ ### Added
21
+
22
+ - **`getCoverArtByISRC(isrc, {minSize?, maxTries?})`** and
23
+ **`getRecordingCoverArt(recording, …)`** — the full ISRC → cover chain with a
24
+ proper release ranking: `getBestCoverArtUrl` on the *first* release a recording
25
+ lists often hits a promo comp / bootleg with no art. These walk the
26
+ release-groups **canonical-first** (Official > Album > earliest date) and
27
+ return the first real front cover, bounded to `maxTries` (default 4) lookups.
28
+
3
29
  ## 2.12.0 - 2026-08-31
4
30
 
5
31
  Phase 4 — an optional, read-only **enrichment** layer against open databases.