sonovault 4.1.0 → 4.2.1

package/README.md

@@ -51,6 +51,9 @@ const deluxe = await sv.releases.get(7, { edition: 16216 });
 
 // Recording to composition (ISWC), for royalty and publishing workflows
 const work = await sv.tracks.iswc({ isrc: "GBDUW0000053" });
+
+// What a label released on one day (from / until are inclusive YYYY-MM-DD)
+const friday = await sv.labels.releases(1, { from: "2026-09-11", until: "2026-09-11" });
 ```
 
 ## Bulk resolve

package/dist/index.cjs

@@ -50,7 +50,7 @@ var SonoVaultError = class extends Error {
 };
 
 // src/version.ts
-var VERSION = "4.1.0";
+var VERSION = "4.2.1";
 
 // src/client.ts
 var SonoVault = class {
@@ -89,11 +89,16 @@ var SonoVault = class {
     this.artists = {
       search: (params) => this.request("/v1/artists/search", { query: params }),
       get: (id) => this.request(`/v1/artists/${id}`),
+      /** An artist's releases, newest first. `from` / `until` are inclusive `YYYY-MM-DD` release dates. */
       releases: (id, params = {}) => this.request(`/v1/artists/${id}/releases`, { query: params })
     };
     this.labels = {
       search: (params) => this.request("/v1/labels/search", { query: params }),
       get: (id) => this.request(`/v1/labels/${id}`),
+      /**
+       * A label's releases, newest first. `from` / `until` are inclusive `YYYY-MM-DD`
+       * release dates, so `{ from: "2026-09-11", until: "2026-09-11" }` lists one day.
+       */
       releases: (id, params = {}) => this.request(`/v1/labels/${id}/releases`, { query: params }),
       artists: (id, params = {}) => this.request(`/v1/labels/${id}/artists`, { query: params })
     };

package/dist/index.d.cts

@@ -66,6 +66,15 @@ interface Page<T> {
     results: T[];
     next_cursor: string | null;
 }
+/** Query params for an artist's or a label's release list. */
+type ReleaseListParams = {
+    limit?: number;
+    cursor?: string;
+    /** Only releases dated on or after this day (`YYYY-MM-DD`). Undated releases are left out when `from` or `until` is set. */
+    from?: string;
+    /** Only releases dated on or before this day (`YYYY-MM-DD`). Pass the same day as `from` for a single release date. */
+    until?: string;
+};
 interface Artist {
     id: number;
     name: string;
@@ -177,6 +186,16 @@ interface ReleaseEdition {
     track_count: number | null;
     /** How many of this release's tracks sit on the edition. */
     tracks_on_row: number;
+    /**
+     * The label that issued this pressing, as the provider names it. Pressings of
+     * one album often differ: the UK original and a US reissue each carry their own.
+     */
+    label: {
+        id: number;
+        name: string;
+    } | null;
+    /** The pressing's catalog number, from Discogs and MusicBrainz. */
+    catalog_no: string | null;
 }
 interface Genre {
     id: number;
@@ -214,7 +233,11 @@ interface IswcLookupResponse {
 type ResolveInputType = "track_name" | "isrc" | "sonovault_id" | "spotify_id" | "applemusic_id" | "tidal_id" | "beatport_id" | "discogs_id" | "musicbrainz_id";
 interface ResolveRequest {
     input_type: ResolveInputType;
-    /** 1–100 entries. `{ artist, title }` objects for `track_name`, strings otherwise. */
+    /**
+     * 1–100 entries. `{ artist, title }` objects for `track_name`, strings otherwise.
+     * For `discogs_id` each string is a Discogs track key (release ID plus track
+     * position, e.g. `2844-A`), not a bare release ID.
+     */
     items: (string | {
         artist: string;
         title: string;
@@ -372,6 +395,7 @@ declare class SonoVault {
             isrc?: string;
             spotify_id?: string;
             beatport_id?: string;
+            /** Discogs track key: release ID plus track position, e.g. `2844-A`. A bare release ID matches nothing. */
             discogs_id?: string;
             musicbrainz_id?: string;
             applemusic_id?: string;
@@ -408,10 +432,8 @@ declare class SonoVault {
             cursor?: string;
         }) => Promise<Page<Artist>>;
         get: (id: number) => Promise<Artist>;
-        releases: (id: number, params?: {
-            limit?: number;
-            cursor?: string;
-        }) => Promise<Page<Release>>;
+        /** An artist's releases, newest first. `from` / `until` are inclusive `YYYY-MM-DD` release dates. */
+        releases: (id: number, params?: ReleaseListParams) => Promise<Page<Release>>;
     };
     readonly labels: {
         search: (params: {
@@ -420,10 +442,11 @@ declare class SonoVault {
             cursor?: string;
         }) => Promise<Page<Label>>;
         get: (id: number) => Promise<Label>;
-        releases: (id: number, params?: {
-            limit?: number;
-            cursor?: string;
-        }) => Promise<Page<Release>>;
+        /**
+         * A label's releases, newest first. `from` / `until` are inclusive `YYYY-MM-DD`
+         * release dates, so `{ from: "2026-09-11", until: "2026-09-11" }` lists one day.
+         */
+        releases: (id: number, params?: ReleaseListParams) => Promise<Page<Release>>;
         artists: (id: number, params?: {
             limit?: number;
             cursor?: string;
@@ -570,4 +593,4 @@ declare function verifyWebhookSignature(options: {
  */
 declare function paginate<T>(fetchPage: (cursor: string | undefined) => Promise<Page<T>>): AsyncGenerator<T>;
 
-export { type Artist, type Genre, type IdentifyResponse, type IdentifyResult, type IswcLookupResponse, type Label, type Page, type PlatformLink, type PlatformLinksResponse, type Release, type ReleaseEdition, type ReleaseTrack, type ResolveInputType, type ResolveRequest, type ResolveResponse, type ResolveResult, SonoVault, SonoVaultError, type SonoVaultOptions, type Stream, type StreamEvent, type StreamStatus, type StreamUpdateResponse, type Track, type TrackArtist, type TrackRelease, type Webhook, paginate, verifyWebhookSignature };
+export { type Artist, type Genre, type IdentifyResponse, type IdentifyResult, type IswcLookupResponse, type Label, type Page, type PlatformLink, type PlatformLinksResponse, type Release, type ReleaseEdition, type ReleaseListParams, type ReleaseTrack, type ResolveInputType, type ResolveRequest, type ResolveResponse, type ResolveResult, SonoVault, SonoVaultError, type SonoVaultOptions, type Stream, type StreamEvent, type StreamStatus, type StreamUpdateResponse, type Track, type TrackArtist, type TrackRelease, type Webhook, paginate, verifyWebhookSignature };

package/dist/index.d.ts

@@ -66,6 +66,15 @@ interface Page<T> {
     results: T[];
     next_cursor: string | null;
 }
+/** Query params for an artist's or a label's release list. */
+type ReleaseListParams = {
+    limit?: number;
+    cursor?: string;
+    /** Only releases dated on or after this day (`YYYY-MM-DD`). Undated releases are left out when `from` or `until` is set. */
+    from?: string;
+    /** Only releases dated on or before this day (`YYYY-MM-DD`). Pass the same day as `from` for a single release date. */
+    until?: string;
+};
 interface Artist {
     id: number;
     name: string;
@@ -177,6 +186,16 @@ interface ReleaseEdition {
     track_count: number | null;
     /** How many of this release's tracks sit on the edition. */
     tracks_on_row: number;
+    /**
+     * The label that issued this pressing, as the provider names it. Pressings of
+     * one album often differ: the UK original and a US reissue each carry their own.
+     */
+    label: {
+        id: number;
+        name: string;
+    } | null;
+    /** The pressing's catalog number, from Discogs and MusicBrainz. */
+    catalog_no: string | null;
 }
 interface Genre {
     id: number;
@@ -214,7 +233,11 @@ interface IswcLookupResponse {
 type ResolveInputType = "track_name" | "isrc" | "sonovault_id" | "spotify_id" | "applemusic_id" | "tidal_id" | "beatport_id" | "discogs_id" | "musicbrainz_id";
 interface ResolveRequest {
     input_type: ResolveInputType;
-    /** 1–100 entries. `{ artist, title }` objects for `track_name`, strings otherwise. */
+    /**
+     * 1–100 entries. `{ artist, title }` objects for `track_name`, strings otherwise.
+     * For `discogs_id` each string is a Discogs track key (release ID plus track
+     * position, e.g. `2844-A`), not a bare release ID.
+     */
     items: (string | {
         artist: string;
         title: string;
@@ -372,6 +395,7 @@ declare class SonoVault {
             isrc?: string;
             spotify_id?: string;
             beatport_id?: string;
+            /** Discogs track key: release ID plus track position, e.g. `2844-A`. A bare release ID matches nothing. */
             discogs_id?: string;
             musicbrainz_id?: string;
             applemusic_id?: string;
@@ -408,10 +432,8 @@ declare class SonoVault {
             cursor?: string;
         }) => Promise<Page<Artist>>;
         get: (id: number) => Promise<Artist>;
-        releases: (id: number, params?: {
-            limit?: number;
-            cursor?: string;
-        }) => Promise<Page<Release>>;
+        /** An artist's releases, newest first. `from` / `until` are inclusive `YYYY-MM-DD` release dates. */
+        releases: (id: number, params?: ReleaseListParams) => Promise<Page<Release>>;
     };
     readonly labels: {
         search: (params: {
@@ -420,10 +442,11 @@ declare class SonoVault {
             cursor?: string;
         }) => Promise<Page<Label>>;
         get: (id: number) => Promise<Label>;
-        releases: (id: number, params?: {
-            limit?: number;
-            cursor?: string;
-        }) => Promise<Page<Release>>;
+        /**
+         * A label's releases, newest first. `from` / `until` are inclusive `YYYY-MM-DD`
+         * release dates, so `{ from: "2026-09-11", until: "2026-09-11" }` lists one day.
+         */
+        releases: (id: number, params?: ReleaseListParams) => Promise<Page<Release>>;
         artists: (id: number, params?: {
             limit?: number;
             cursor?: string;
@@ -570,4 +593,4 @@ declare function verifyWebhookSignature(options: {
  */
 declare function paginate<T>(fetchPage: (cursor: string | undefined) => Promise<Page<T>>): AsyncGenerator<T>;
 
-export { type Artist, type Genre, type IdentifyResponse, type IdentifyResult, type IswcLookupResponse, type Label, type Page, type PlatformLink, type PlatformLinksResponse, type Release, type ReleaseEdition, type ReleaseTrack, type ResolveInputType, type ResolveRequest, type ResolveResponse, type ResolveResult, SonoVault, SonoVaultError, type SonoVaultOptions, type Stream, type StreamEvent, type StreamStatus, type StreamUpdateResponse, type Track, type TrackArtist, type TrackRelease, type Webhook, paginate, verifyWebhookSignature };
+export { type Artist, type Genre, type IdentifyResponse, type IdentifyResult, type IswcLookupResponse, type Label, type Page, type PlatformLink, type PlatformLinksResponse, type Release, type ReleaseEdition, type ReleaseListParams, type ReleaseTrack, type ResolveInputType, type ResolveRequest, type ResolveResponse, type ResolveResult, SonoVault, SonoVaultError, type SonoVaultOptions, type Stream, type StreamEvent, type StreamStatus, type StreamUpdateResponse, type Track, type TrackArtist, type TrackRelease, type Webhook, paginate, verifyWebhookSignature };

package/dist/index.js

@@ -21,7 +21,7 @@ var SonoVaultError = class extends Error {
 };
 
 // src/version.ts
-var VERSION = "4.1.0";
+var VERSION = "4.2.1";
 
 // src/client.ts
 var SonoVault = class {
@@ -60,11 +60,16 @@ var SonoVault = class {
     this.artists = {
       search: (params) => this.request("/v1/artists/search", { query: params }),
       get: (id) => this.request(`/v1/artists/${id}`),
+      /** An artist's releases, newest first. `from` / `until` are inclusive `YYYY-MM-DD` release dates. */
       releases: (id, params = {}) => this.request(`/v1/artists/${id}/releases`, { query: params })
     };
     this.labels = {
       search: (params) => this.request("/v1/labels/search", { query: params }),
       get: (id) => this.request(`/v1/labels/${id}`),
+      /**
+       * A label's releases, newest first. `from` / `until` are inclusive `YYYY-MM-DD`
+       * release dates, so `{ from: "2026-09-11", until: "2026-09-11" }` lists one day.
+       */
       releases: (id, params = {}) => this.request(`/v1/labels/${id}/releases`, { query: params }),
       artists: (id, params = {}) => this.request(`/v1/labels/${id}/artists`, { query: params })
     };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sonovault",
-  "version": "4.1.0",
+  "version": "4.2.1",
   "description": "TypeScript/Node client for the SonoVault music metadata API \u2014 ISRC, ISWC, genre, labels, release dates, and cross-platform IDs for 93M+ tracks.",
   "keywords": [
     "music",