@zivue/zuuid 0.2.2 → 0.2.3

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## 0.2.3 - 2026-05-25
+
+- Added live MusicBrainz lookup/search support for releases, release groups, recordings, artists, labels, and works.
+- Added MusicBrainz category-first client facades under `listen.musicbrainz` and `people.musicbrainz`, plus a `providers/musicbrainz/client` subpath export.
+- Added MusicBrainz fetch/search examples and README usage documentation.
+- Added an IMDb suggestion-data fallback for challenge pages so known title IDs still resolve core metadata such as title, year, poster, type, rank, and cast summary.
+
 ## 0.2.2 - 2026-05-25
 
 - Added IMDb fetch-by-ID scraper support for movie and TV title pages.

package/README.md

@@ -4,7 +4,7 @@ Search, fetch, and normalize media metadata from external providers into a share
 
 This package is meant to be used by apps that need provider-backed lookup and transformation, but do not want provider-specific response shapes leaking through the app.
 
-TMDB, Open Library, and GamesDB include live search/fetch clients. IMDb includes a fetch-by-ID title-page scraper for movie and TV titles. Additional providers currently expose source-record transformers: you provide the raw provider payload, and this package normalizes it into `ZuuidData`.
+TMDB, Open Library, GamesDB, and MusicBrainz include live search/fetch clients. IMDb includes a fetch-by-ID title-page scraper for movie and TV titles. Additional providers currently expose source-record transformers: you provide the raw provider payload, and this package normalizes it into `ZuuidData`.
 
 Storage, caching, indexing, review state, object-store keys, and persistence belong in a layer outside this package.
 
@@ -114,7 +114,7 @@ Ratings are normalized to a `0-5` scale when the provider exposes a compatible n
 | GamesDB | game | yes | yes | yes |
 | GamesDB | platform | no | yes | yes |
 | Jikan | anime, manga, producer, magazine, character, person | no | no | yes |
-| MusicBrainz | release, release-group, recording, artist, label, work | no | no | yes |
+| MusicBrainz | release, release-group, recording, artist, label, work | yes | yes | yes |
 | OpenFoodFacts | product | no | no | yes |
 | OpenStreetMap | city, country, place, venue | no | no | yes |
 | Podcast / iTunes | podcast | no | no | yes |
@@ -154,9 +154,35 @@ const game = await zuuid.play.gamesdb?.game.fetch({ id: 17444 });
 
 GamesDB transforms accept both simple flat payloads and native TheGamesDB API envelopes with `data.games`, `data.platforms`, lookup maps, and `boxart` image metadata.
 
+
+## MusicBrainz
+
+`MusicBrainzProvider` uses the public MusicBrainz JSON web service. No API key is required, but the provider sends a descriptive `User-Agent` by default and lets you override it.
+
+```ts
+import { MusicBrainzProvider } from "@zivue/zuuid/providers/musicbrainz";
+
+const musicbrainz = new MusicBrainzProvider({
+  userAgent: "your-app/1.0 (you@example.com)"
+});
+
+const release = await musicbrainz.fetchRelease({ id: "f5093c06-23e3-404f-aeaa-40f72885ee3a" });
+const releaseGroups = await musicbrainz.searchReleaseGroups({ query: "Kind of Blue" });
+const artist = await musicbrainz.fetchArtist({ id: "561d854a-6a28-4aa7-8c99-323e6ce46c2a" });
+```
+
+The category-first client exposes MusicBrainz under `listen.musicbrainz` and `people.musicbrainz`:
+
+```ts
+const zuuid = createZuuidClient({ providers: { musicbrainz: {} } });
+
+const album = await zuuid.listen.musicbrainz?.releaseGroup.search({ query: "Kind of Blue" });
+const artist = await zuuid.people.musicbrainz?.artist.search({ query: "Miles Davis" });
+```
+
 ## IMDb Scraper
 
-IMDb can be used as a credential-free alternative source when you already have an IMDb title ID. It scrapes the title page, preserves the fetched HTML and extracted JSON-LD in the raw `SourceRecord`, and transforms the JSON-LD into normalized `ZuuidData`.
+IMDb can be used as a credential-free alternative source when you already have an IMDb title ID. It scrapes the title page, preserves the fetched HTML and extracted JSON-LD in the raw `SourceRecord`, and transforms the JSON-LD into normalized `ZuuidData`. If IMDb serves a challenge page instead of title HTML, the provider falls back to IMDb suggestion data for core fields such as title, year, poster, type, rank, and cast summary.
 
 ```ts
 import { ImdbProvider } from "@zivue/zuuid/providers/imdb";
@@ -374,6 +400,11 @@ zuuid.people.openlibrary?.fetch({ id: "OL23919A" });
 
 zuuid.read.openlibrary?.search({ query: "The Lord of the Rings" });
 zuuid.read.openlibrary?.fetch({ id: "OL82563W" });
+
+zuuid.listen.musicbrainz?.release.search({ query: "Kind of Blue" });
+zuuid.listen.musicbrainz?.releaseGroup.fetch({ id: "aaa50249-1e6b-3910-b830-7e2fb622a8c4" });
+zuuid.listen.musicbrainz?.recording.search({ query: "So What" });
+zuuid.people.musicbrainz?.artist.search({ query: "Miles Davis" });
 ```
 
 ## Example Scripts
@@ -396,6 +427,9 @@ npm run example:search -- tv "Game of Thrones"
 npm run example:search -- people "Brad Pitt"
 npm run example:search -- book "The Lord of the Rings"
 npm run example:search -- author "J. K. Rowling"
+npm run example:search -- release-group "Kind of Blue"
+npm run example:search -- recording "So What"
+npm run example:search -- artist "Miles Davis"
 ```
 
 Fetch and transform a selected provider ID:
@@ -415,6 +449,9 @@ npm run example:fetch -- imdb:movie tt0137523
 npm run example:fetch -- imdb:tv tt0944947
 GAMESDB_API_KEY=... npm run example:fetch -- gamesdb:game 17444
 GAMESDB_API_KEY=... npm run example:fetch -- gamesdb:platform 6
+npm run example:fetch -- musicbrainz:release f5093c06-23e3-404f-aeaa-40f72885ee3a
+npm run example:fetch -- musicbrainz:release-group aaa50249-1e6b-3910-b830-7e2fb622a8c4
+npm run example:fetch -- musicbrainz:artist 561d854a-6a28-4aa7-8c99-323e6ce46c2a
 ```
 
 Transformer-only providers do not have fetch examples. Wrap a real payload from your own provider client in a `SourceRecord` and call the transformer directly.
@@ -451,6 +488,7 @@ Provider exports:
 - `OpenLibraryProvider`
 - `ImdbProvider`
 - `GamesDbProvider`
+- `MusicBrainzProvider`
 - `transformTmdbMovie(sourceRecord, options?)`
 - `transformTmdbTv(sourceRecord, options?)`
 - `transformTmdbPerson(sourceRecord, options?)`

package/dist/client.d.ts

@@ -1,4 +1,5 @@
 import type { SearchResponse, ZuuidData, ZuuidSearchResult } from "./entity.js";
+import { type FetchMusicBrainzInput, type MusicBrainzProviderOptions, type MusicBrainzSearchInput } from "./providers/musicbrainz/index.js";
 import { type FetchOpenLibraryAuthorInput, type FetchOpenLibraryBookInput, type OpenLibraryProviderOptions, type OpenLibrarySearchInput } from "./providers/openlibrary/index.js";
 import { type FetchTmdbMovieInput, type FetchTmdbPersonInput, type FetchTmdbTvInput, type TmdbProviderOptions, type TmdbSearchInput } from "./providers/tmdb/index.js";
 import { type FetchGamesDbGameInput, type FetchGamesDbPlatformInput, type GamesDbProviderOptions, type GamesDbSearchInput } from "./providers/gamesdb/index.js";
@@ -7,6 +8,7 @@ import type { SourceRecord } from "./source.js";
 export type ProviderConfigs = {
     gamesdb?: GamesDbProviderOptions;
     imdb?: ImdbProviderOptions;
+    musicbrainz?: MusicBrainzProviderOptions;
     openlibrary?: OpenLibraryProviderOptions;
     tmdb?: TmdbProviderOptions;
 };
@@ -44,10 +46,22 @@ export type ZuuidClient = {
     people: {
         tmdb?: ProviderClient<FetchTmdbPersonInput, TmdbSearchInput>;
         openlibrary?: ProviderClient<FetchOpenLibraryAuthorInput, OpenLibrarySearchInput>;
+        musicbrainz?: {
+            artist: ProviderClient<FetchMusicBrainzInput, MusicBrainzSearchInput>;
+            label: ProviderClient<FetchMusicBrainzInput, MusicBrainzSearchInput>;
+        };
     };
     read: {
         openlibrary?: ProviderClient<FetchOpenLibraryBookInput, OpenLibrarySearchInput>;
     };
+    listen: {
+        musicbrainz?: {
+            release: ProviderClient<FetchMusicBrainzInput, MusicBrainzSearchInput>;
+            releaseGroup: ProviderClient<FetchMusicBrainzInput, MusicBrainzSearchInput>;
+            recording: ProviderClient<FetchMusicBrainzInput, MusicBrainzSearchInput>;
+            work: ProviderClient<FetchMusicBrainzInput, MusicBrainzSearchInput>;
+        };
+    };
     play: {
         gamesdb?: {
             game: ProviderClient<FetchGamesDbGameInput, GamesDbSearchInput>;

package/dist/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/client.js

@@ -1,3 +1,4 @@
+import { MusicBrainzProvider, transformMusicBrainzArtist, transformMusicBrainzLabel, transformMusicBrainzRecording, transformMusicBrainzRelease, transformMusicBrainzReleaseGroup, transformMusicBrainzWork } from "./providers/musicbrainz/index.js";
 import { OpenLibraryProvider, transformOpenLibraryAuthor, transformOpenLibraryBook } from "./providers/openlibrary/index.js";
 import { TmdbProvider, transformTmdbMovie, transformTmdbPerson, transformTmdbTv } from "./providers/tmdb/index.js";
 import { GamesDbProvider, transformGamesDbGame, transformGamesDbPlatform } from "./providers/gamesdb/index.js";
@@ -5,6 +6,7 @@ import { ImdbProvider, transformImdbMovie, transformImdbTv } from "./providers/i
 export function createZuuidClient(config = {}) {
     const gamesdb = config.providers?.gamesdb ? new GamesDbProvider(config.providers.gamesdb) : undefined;
     const imdb = config.providers?.imdb ? new ImdbProvider(config.providers.imdb) : undefined;
+    const musicbrainz = config.providers?.musicbrainz ? new MusicBrainzProvider(config.providers.musicbrainz) : undefined;
     const openlibrary = config.providers?.openlibrary ? new OpenLibraryProvider(config.providers.openlibrary) : undefined;
     const tmdb = config.providers?.tmdb ? new TmdbProvider(config.providers.tmdb) : undefined;
     return Object.freeze({
@@ -62,6 +64,24 @@ export function createZuuidClient(config = {}) {
                     searchSourceRecords: (input) => openlibrary.searchAuthorSourceRecords(input),
                     transform: (source) => transformOpenLibraryAuthor(source, openlibrary.transformOptions())
                 })
+                : undefined,
+            musicbrainz: musicbrainz
+                ? Object.freeze({
+                    artist: Object.freeze({
+                        fetch: (input) => musicbrainz.fetchArtist(input),
+                        fetchSourceRecord: (input) => musicbrainz.fetchArtistSourceRecord(input),
+                        search: (input) => musicbrainz.searchArtists(input),
+                        searchSourceRecords: (input) => musicbrainz.searchArtistSourceRecords(input),
+                        transform: (source) => transformMusicBrainzArtist(source)
+                    }),
+                    label: Object.freeze({
+                        fetch: (input) => musicbrainz.fetchLabel(input),
+                        fetchSourceRecord: (input) => musicbrainz.fetchLabelSourceRecord(input),
+                        search: (input) => musicbrainz.searchLabels(input),
+                        searchSourceRecords: (input) => musicbrainz.searchLabelSourceRecords(input),
+                        transform: (source) => transformMusicBrainzLabel(source)
+                    })
+                })
                 : undefined
         }),
         read: Object.freeze({
@@ -75,6 +95,40 @@ export function createZuuidClient(config = {}) {
                 })
                 : undefined
         }),
+        listen: Object.freeze({
+            musicbrainz: musicbrainz
+                ? Object.freeze({
+                    release: Object.freeze({
+                        fetch: (input) => musicbrainz.fetchRelease(input),
+                        fetchSourceRecord: (input) => musicbrainz.fetchReleaseSourceRecord(input),
+                        search: (input) => musicbrainz.searchReleases(input),
+                        searchSourceRecords: (input) => musicbrainz.searchReleaseSourceRecords(input),
+                        transform: (source) => transformMusicBrainzRelease(source, { coverArtBaseUrl: musicbrainz.coverArtBaseUrl })
+                    }),
+                    releaseGroup: Object.freeze({
+                        fetch: (input) => musicbrainz.fetchReleaseGroup(input),
+                        fetchSourceRecord: (input) => musicbrainz.fetchReleaseGroupSourceRecord(input),
+                        search: (input) => musicbrainz.searchReleaseGroups(input),
+                        searchSourceRecords: (input) => musicbrainz.searchReleaseGroupSourceRecords(input),
+                        transform: (source) => transformMusicBrainzReleaseGroup(source, { coverArtBaseUrl: musicbrainz.releaseGroupCoverArtBaseUrl })
+                    }),
+                    recording: Object.freeze({
+                        fetch: (input) => musicbrainz.fetchRecording(input),
+                        fetchSourceRecord: (input) => musicbrainz.fetchRecordingSourceRecord(input),
+                        search: (input) => musicbrainz.searchRecordings(input),
+                        searchSourceRecords: (input) => musicbrainz.searchRecordingSourceRecords(input),
+                        transform: (source) => transformMusicBrainzRecording(source)
+                    }),
+                    work: Object.freeze({
+                        fetch: (input) => musicbrainz.fetchWork(input),
+                        fetchSourceRecord: (input) => musicbrainz.fetchWorkSourceRecord(input),
+                        search: (input) => musicbrainz.searchWorks(input),
+                        searchSourceRecords: (input) => musicbrainz.searchWorkSourceRecords(input),
+                        transform: (source) => transformMusicBrainzWork(source)
+                    })
+                })
+                : undefined
+        }),
         play: Object.freeze({
             gamesdb: gamesdb
                 ? Object.freeze({

package/dist/providers/imdb/client.d.ts

@@ -5,6 +5,7 @@ import type { ImdbFetchLike, ImdbProviderOptions, ImdbTransformOptions } from ".
 export declare class ImdbProvider {
     readonly fetcher: ImdbFetchLike;
     readonly titleBaseUrl: string | null;
+    readonly suggestionBaseUrl: string | null;
     readonly userAgent: string;
     constructor(options?: ImdbProviderOptions);
     transformOptions(): ImdbTransformOptions;

package/dist/providers/imdb/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/providers/imdb/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD,OAAO,EAA4F,KAAK,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAChJ,OAAO,KAAK,EAAE,aAAa,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAE3F,qBAAa,YAAY;IACvB,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAChC,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;gBAEf,OAAO,GAAE,mBAAwB;IAM7C,gBAAgB,IAAI,oBAAoB;IAIlC,sBAAsB,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC;IAIrF,UAAU,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC;IAKtE,mBAAmB,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC;IAIlF,OAAO,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC;CAI1E"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/providers/imdb/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD,OAAO,EAA4F,KAAK,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAChJ,OAAO,KAAK,EAAE,aAAa,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAE3F,qBAAa,YAAY;IACvB,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAChC,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;gBAEf,OAAO,GAAE,mBAAwB;IAO7C,gBAAgB,IAAI,oBAAoB;IAIlC,sBAAsB,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC;IAIrF,UAAU,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC;IAKtE,mBAAmB,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC;IAIlF,OAAO,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC;CAI1E"}

package/dist/providers/imdb/client.js

@@ -1,16 +1,18 @@
-import { IMDB_DEFAULT_USER_AGENT, IMDB_TITLE_BASE_URL } from "./constants.js";
+import { IMDB_DEFAULT_USER_AGENT, IMDB_SUGGESTION_BASE_URL, IMDB_TITLE_BASE_URL } from "./constants.js";
 import { fetchImdbMovieSourceRecord, fetchImdbTvSourceRecord, transformImdbMovie, transformImdbTv } from "./movie.js";
 export class ImdbProvider {
     fetcher;
     titleBaseUrl;
+    suggestionBaseUrl;
     userAgent;
     constructor(options = {}) {
         this.fetcher = options.fetch ?? fetch;
         this.titleBaseUrl = options.titleBaseUrl === undefined ? IMDB_TITLE_BASE_URL : options.titleBaseUrl;
+        this.suggestionBaseUrl = options.suggestionBaseUrl === undefined ? IMDB_SUGGESTION_BASE_URL : options.suggestionBaseUrl;
         this.userAgent = options.userAgent ?? IMDB_DEFAULT_USER_AGENT;
     }
     transformOptions() {
-        return { titleBaseUrl: this.titleBaseUrl };
+        return { titleBaseUrl: this.titleBaseUrl, suggestionBaseUrl: this.suggestionBaseUrl };
     }
     async fetchMovieSourceRecord(input) {
         return fetchImdbMovieSourceRecord(this, input);

package/dist/providers/imdb/constants.d.ts

@@ -1,4 +1,5 @@
 export declare const IMDB_PROVIDER = "imdb";
 export declare const IMDB_TITLE_BASE_URL = "https://www.imdb.com/title";
 export declare const IMDB_DEFAULT_USER_AGENT = "@zivue/zuuid IMDb scraper (+https://github.com/zivue/zuuid)";
+export declare const IMDB_SUGGESTION_BASE_URL = "https://v3.sg.media-imdb.com/suggestion";
 //# sourceMappingURL=constants.d.ts.map

package/dist/providers/imdb/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/providers/imdb/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,aAAa,SAAS,CAAC;AACpC,eAAO,MAAM,mBAAmB,+BAA+B,CAAC;AAChE,eAAO,MAAM,uBAAuB,gEAAgE,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/providers/imdb/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,aAAa,SAAS,CAAC;AACpC,eAAO,MAAM,mBAAmB,+BAA+B,CAAC;AAChE,eAAO,MAAM,uBAAuB,gEAAgE,CAAC;AACrG,eAAO,MAAM,wBAAwB,4CAA4C,CAAC"}

package/dist/providers/imdb/constants.js

@@ -1,3 +1,4 @@
 export const IMDB_PROVIDER = "imdb";
 export const IMDB_TITLE_BASE_URL = "https://www.imdb.com/title";
 export const IMDB_DEFAULT_USER_AGENT = "@zivue/zuuid IMDb scraper (+https://github.com/zivue/zuuid)";
+export const IMDB_SUGGESTION_BASE_URL = "https://v3.sg.media-imdb.com/suggestion";

package/dist/providers/imdb/movie.js

@@ -37,22 +37,25 @@ async function fetchImdbTitleSourceRecord(provider, input, category) {
         throw new Error(`IMDb title request failed with status ${response.status}`);
     }
     const html = await response.text();
+    const pagePayload = extractImdbPayload(url, html);
+    const suggestion = await fetchSuggestionPayload(provider, id);
     return createSourceRecord({
         source: { provider: IMDB_PROVIDER, category, externalId: id },
-        payload: extractImdbPayload(url, html)
+        payload: { ...objectPayload(pagePayload), suggestion: suggestion ?? null }
     });
 }
 async function transformImdbTitle(source, fallbackCategory, options = {}) {
     const payload = objectPayload(source.payload);
     const jsonLd = objectPayload(payload.jsonLd ?? {});
     const externalId = normalizeImdbTitleId(source.source.externalId);
-    const category = source.source.category === "tv" || schemaType(jsonLd).includes("TVSeries") ? "tv" : fallbackCategory;
-    const title = stringField(jsonLd, "name") ?? fallbackTitle(payload) ?? externalId;
+    const suggestion = suggestionItem(payload, externalId);
+    const category = source.source.category === "tv" || schemaType(jsonLd).includes("TVSeries") || stringField(suggestion, "qid")?.startsWith("tv") ? "tv" : fallbackCategory;
+    const title = stringField(jsonLd, "name") ?? stringField(suggestion, "l") ?? fallbackTitle(payload) ?? externalId;
     const data = await baseDataFromSource(source, IMDB_PROVIDER, category, category, externalId, title);
-    data.primaryDate = datePrefix(stringField(jsonLd, "datePublished"));
+    data.primaryDate = datePrefix(stringField(jsonLd, "datePublished")) ?? suggestionYearDate(suggestion);
     addAlias(data, title, "primary", true, IMDB_PROVIDER);
     addDescription(data, IMDB_PROVIDER, stringField(jsonLd, "description"));
-    addMedia(data, IMDB_PROVIDER, stringField(jsonLd, "image"), "poster");
+    addMedia(data, IMDB_PROVIDER, stringField(jsonLd, "image") ?? nestedSuggestionImage(suggestion), "poster");
     const aggregateRating = objectPayload(jsonLd.aggregateRating ?? {});
     const nativeRating = numericValue(aggregateRating.ratingValue);
     const normalizedRating = normalizeRating(nativeRating, 0, 10);
@@ -66,6 +69,12 @@ async function transformImdbTitle(source, fallbackCategory, options = {}) {
     addDetail(data, IMDB_PROVIDER, "duration", stringField(jsonLd, "duration"));
     addDetail(data, IMDB_PROVIDER, "schema_type", valueAsString(jsonLd["@type"]));
     addDetail(data, IMDB_PROVIDER, "url", stringField(payload, "url") ?? imdbTitleUrl(externalId, options.titleBaseUrl));
+    addDetail(data, IMDB_PROVIDER, "page_status", payload.challenge === true ? "challenge" : undefined);
+    addDetail(data, IMDB_PROVIDER, "imdb_type", stringField(suggestion, "q"));
+    addDetail(data, IMDB_PROVIDER, "imdb_type_id", stringField(suggestion, "qid"));
+    addDetail(data, IMDB_PROVIDER, "rank", numericValue(suggestion.rank));
+    addDetail(data, IMDB_PROVIDER, "year", numericValue(suggestion.y));
+    addDetail(data, IMDB_PROVIDER, "cast_summary", stringField(suggestion, "s"));
     for (const genre of stringArray(jsonLd.genre)) {
         addTag(data, genre);
     }
@@ -86,9 +95,31 @@ function extractImdbPayload(url, html) {
         html,
         title: cleanPageTitle(decodeHtml(textFromMatch(html.match(/<title[^>]*>([\s\S]*?)<\/title>/i)?.[1]))) ?? null,
         jsonLd: parseJsonScript(html, /<script[^>]+type=["']application\/ld\+json["'][^>]*>([\s\S]*?)<\/script>/i) ?? null,
-        nextData: parseJsonScript(html, /<script[^>]+id=["']__NEXT_DATA__["'][^>]*>([\s\S]*?)<\/script>/i) ?? null
+        nextData: parseJsonScript(html, /<script[^>]+id=["']__NEXT_DATA__["'][^>]*>([\s\S]*?)<\/script>/i) ?? null,
+        challenge: isChallengePage(html)
     };
 }
+async function fetchSuggestionPayload(provider, id) {
+    const baseUrl = provider.suggestionBaseUrl?.replace(/\/$/, "");
+    if (!baseUrl) {
+        return undefined;
+    }
+    const bucket = id.slice(0, 1);
+    const response = await provider.fetcher(`${baseUrl}/${bucket}/${id}.json`, {
+        headers: {
+            Accept: "application/json",
+            "Accept-Language": "en-US,en;q=0.9",
+            "User-Agent": provider.userAgent
+        }
+    });
+    if (!response.ok) {
+        return undefined;
+    }
+    return response.json();
+}
+function isChallengePage(html) {
+    return html.includes("AwsWafIntegration") || html.includes("awsWafCookieDomainList") || html.includes("challenge-container");
+}
 function parseJsonScript(html, pattern) {
     const raw = html.match(pattern)?.[1];
     const text = textFromMatch(raw);
@@ -124,6 +155,20 @@ function imdbTitleUrl(id, titleBaseUrl) {
     const base = titleBaseUrl?.replace(/\/$/, "");
     return base ? `${base}/${id}/` : undefined;
 }
+function suggestionItem(payload, externalId) {
+    const suggestion = objectPayload(payload.suggestion ?? {});
+    const items = Array.isArray(suggestion.d) ? suggestion.d : [];
+    const matched = items.find((item) => item && typeof item === "object" && !Array.isArray(item) && stringField(item, "id") === externalId);
+    return matched && typeof matched === "object" && !Array.isArray(matched) ? matched : {};
+}
+function nestedSuggestionImage(suggestion) {
+    const image = objectPayload(suggestion.i ?? {});
+    return stringField(image, "imageUrl");
+}
+function suggestionYearDate(suggestion) {
+    const year = numericValue(suggestion.y);
+    return year ? `${Math.trunc(year)}-01-01` : undefined;
+}
 function schemaType(jsonLd) {
     const value = jsonLd["@type"];
     return Array.isArray(value) ? value.map((item) => valueAsString(item)).filter(Boolean).join(",") : valueAsString(value) ?? "";

package/dist/providers/imdb/types.d.ts

@@ -2,9 +2,11 @@ export type ImdbFetchLike = (input: string | URL, init?: RequestInit) => Promise
 export type ImdbProviderOptions = {
     fetch?: ImdbFetchLike;
     titleBaseUrl?: string | null;
+    suggestionBaseUrl?: string | null;
     userAgent?: string;
 };
 export type ImdbTransformOptions = {
     titleBaseUrl?: string | null;
+    suggestionBaseUrl?: string | null;
 };
 //# sourceMappingURL=types.d.ts.map

package/dist/providers/imdb/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/providers/imdb/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;AAE3F,MAAM,MAAM,mBAAmB,GAAG;IAChC,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/providers/imdb/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;AAE3F,MAAM,MAAM,mBAAmB,GAAG;IAChC,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACnC,CAAC"}

package/dist/providers/musicbrainz/client.d.ts

@@ -0,0 +1,41 @@
+import type { SearchResponse, ZuuidData, ZuuidSearchResult } from "../../entity.js";
+import { type SourceRecord } from "../../source.js";
+import type { FetchMusicBrainzInput, MusicBrainzProviderOptions, MusicBrainzSearchInput, MusicBrainzProviderTransformOptions } from "./types.js";
+export declare class MusicBrainzProvider {
+    readonly apiBase: string;
+    readonly coverArtBaseUrl: string | null;
+    readonly releaseGroupCoverArtBaseUrl: string | null;
+    readonly userAgent: string;
+    private readonly fetchImpl;
+    constructor(options?: MusicBrainzProviderOptions);
+    getJson<T>(path: string, params: Record<string, string>): Promise<T | undefined>;
+    transformOptions(): MusicBrainzProviderTransformOptions;
+    fetchReleaseSourceRecord(input: FetchMusicBrainzInput): Promise<SourceRecord | undefined>;
+    fetchRelease(input: FetchMusicBrainzInput): Promise<ZuuidData | undefined>;
+    searchReleaseSourceRecords(input: MusicBrainzSearchInput): Promise<SearchResponse<SourceRecord>>;
+    searchReleases(input: MusicBrainzSearchInput): Promise<SearchResponse<ZuuidSearchResult>>;
+    fetchReleaseGroupSourceRecord(input: FetchMusicBrainzInput): Promise<SourceRecord | undefined>;
+    fetchReleaseGroup(input: FetchMusicBrainzInput): Promise<ZuuidData | undefined>;
+    searchReleaseGroupSourceRecords(input: MusicBrainzSearchInput): Promise<SearchResponse<SourceRecord>>;
+    searchReleaseGroups(input: MusicBrainzSearchInput): Promise<SearchResponse<ZuuidSearchResult>>;
+    fetchRecordingSourceRecord(input: FetchMusicBrainzInput): Promise<SourceRecord | undefined>;
+    fetchRecording(input: FetchMusicBrainzInput): Promise<ZuuidData | undefined>;
+    searchRecordingSourceRecords(input: MusicBrainzSearchInput): Promise<SearchResponse<SourceRecord>>;
+    searchRecordings(input: MusicBrainzSearchInput): Promise<SearchResponse<ZuuidSearchResult>>;
+    fetchArtistSourceRecord(input: FetchMusicBrainzInput): Promise<SourceRecord | undefined>;
+    fetchArtist(input: FetchMusicBrainzInput): Promise<ZuuidData | undefined>;
+    searchArtistSourceRecords(input: MusicBrainzSearchInput): Promise<SearchResponse<SourceRecord>>;
+    searchArtists(input: MusicBrainzSearchInput): Promise<SearchResponse<ZuuidSearchResult>>;
+    fetchLabelSourceRecord(input: FetchMusicBrainzInput): Promise<SourceRecord | undefined>;
+    fetchLabel(input: FetchMusicBrainzInput): Promise<ZuuidData | undefined>;
+    searchLabelSourceRecords(input: MusicBrainzSearchInput): Promise<SearchResponse<SourceRecord>>;
+    searchLabels(input: MusicBrainzSearchInput): Promise<SearchResponse<ZuuidSearchResult>>;
+    fetchWorkSourceRecord(input: FetchMusicBrainzInput): Promise<SourceRecord | undefined>;
+    fetchWork(input: FetchMusicBrainzInput): Promise<ZuuidData | undefined>;
+    searchWorkSourceRecords(input: MusicBrainzSearchInput): Promise<SearchResponse<SourceRecord>>;
+    searchWorks(input: MusicBrainzSearchInput): Promise<SearchResponse<ZuuidSearchResult>>;
+}
+export declare function fetchMusicBrainzSourceRecord(provider: MusicBrainzProvider, category: string, input: FetchMusicBrainzInput): Promise<SourceRecord | undefined>;
+export declare function searchMusicBrainzSourceRecords(provider: MusicBrainzProvider, category: string, input: MusicBrainzSearchInput): Promise<SearchResponse<SourceRecord>>;
+export declare function searchMusicBrainz(provider: MusicBrainzProvider, category: string, input: MusicBrainzSearchInput, options?: MusicBrainzProviderTransformOptions): Promise<SearchResponse<ZuuidSearchResult>>;
+//# sourceMappingURL=client.d.ts.map

package/dist/providers/musicbrainz/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/providers/musicbrainz/client.ts"],"names":[],"mappings":"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"}

package/dist/providers/musicbrainz/client.js

@@ -0,0 +1,169 @@
+import { providerZuuid } from "../../identity.js";
+import { createSourceRecord } from "../../source.js";
+import { datePrefix, nestedString, objectPayload, stringField, valueAsString } from "../common.js";
+import { MUSICBRAINZ_API_BASE, MUSICBRAINZ_ARTIST_CATEGORY, MUSICBRAINZ_COVER_ART_BASE_URL, MUSICBRAINZ_DEFAULT_USER_AGENT, MUSICBRAINZ_LABEL_CATEGORY, MUSICBRAINZ_PROVIDER, MUSICBRAINZ_RECORDING_CATEGORY, MUSICBRAINZ_RELEASE_CATEGORY, MUSICBRAINZ_RELEASE_GROUP_CATEGORY, MUSICBRAINZ_RELEASE_GROUP_COVER_ART_BASE_URL, MUSICBRAINZ_WORK_CATEGORY } from "./constants.js";
+import { transformMusicBrainzArtist } from "./artist.js";
+import { transformMusicBrainzLabel } from "./label.js";
+import { transformMusicBrainzRecording } from "./recording.js";
+import { transformMusicBrainzRelease } from "./release.js";
+import { transformMusicBrainzReleaseGroup } from "./release-group.js";
+import { transformMusicBrainzWork } from "./work.js";
+export class MusicBrainzProvider {
+    apiBase;
+    coverArtBaseUrl;
+    releaseGroupCoverArtBaseUrl;
+    userAgent;
+    fetchImpl;
+    constructor(options = {}) {
+        this.apiBase = options.apiBase ?? MUSICBRAINZ_API_BASE;
+        this.fetchImpl = options.fetch ?? globalThis.fetch.bind(globalThis);
+        this.coverArtBaseUrl = options.coverArtBaseUrl === undefined ? MUSICBRAINZ_COVER_ART_BASE_URL : options.coverArtBaseUrl;
+        this.releaseGroupCoverArtBaseUrl = options.releaseGroupCoverArtBaseUrl === undefined ? MUSICBRAINZ_RELEASE_GROUP_COVER_ART_BASE_URL : options.releaseGroupCoverArtBaseUrl;
+        this.userAgent = options.userAgent ?? MUSICBRAINZ_DEFAULT_USER_AGENT;
+    }
+    async getJson(path, params) {
+        const url = new URL(`${this.apiBase.replace(/\/$/, "")}/${path.replace(/^\//, "")}`);
+        url.searchParams.set("fmt", "json");
+        for (const [key, value] of Object.entries(params))
+            url.searchParams.set(key, value);
+        const response = await this.fetchImpl(url, { headers: { accept: "application/json", "user-agent": this.userAgent } });
+        if (response.status === 404)
+            return undefined;
+        if (!response.ok) {
+            const body = await response.text().catch(() => "");
+            throw new Error(`MusicBrainz API returned ${response.status}: ${body}`);
+        }
+        return response.json();
+    }
+    transformOptions() {
+        return { coverArtBaseUrl: this.coverArtBaseUrl, releaseGroupCoverArtBaseUrl: this.releaseGroupCoverArtBaseUrl };
+    }
+    async fetchReleaseSourceRecord(input) { return fetchMusicBrainzSourceRecord(this, MUSICBRAINZ_RELEASE_CATEGORY, input); }
+    async fetchRelease(input) { const source = await this.fetchReleaseSourceRecord(input); return source ? transformMusicBrainzRelease(source, this.transformOptions()) : undefined; }
+    async searchReleaseSourceRecords(input) { return searchMusicBrainzSourceRecords(this, MUSICBRAINZ_RELEASE_CATEGORY, input); }
+    async searchReleases(input) { return searchMusicBrainz(this, MUSICBRAINZ_RELEASE_CATEGORY, input, this.transformOptions()); }
+    async fetchReleaseGroupSourceRecord(input) { return fetchMusicBrainzSourceRecord(this, MUSICBRAINZ_RELEASE_GROUP_CATEGORY, input); }
+    async fetchReleaseGroup(input) { const source = await this.fetchReleaseGroupSourceRecord(input); return source ? transformMusicBrainzReleaseGroup(source, { coverArtBaseUrl: this.releaseGroupCoverArtBaseUrl }) : undefined; }
+    async searchReleaseGroupSourceRecords(input) { return searchMusicBrainzSourceRecords(this, MUSICBRAINZ_RELEASE_GROUP_CATEGORY, input); }
+    async searchReleaseGroups(input) { return searchMusicBrainz(this, MUSICBRAINZ_RELEASE_GROUP_CATEGORY, input, this.transformOptions()); }
+    async fetchRecordingSourceRecord(input) { return fetchMusicBrainzSourceRecord(this, MUSICBRAINZ_RECORDING_CATEGORY, input); }
+    async fetchRecording(input) { const source = await this.fetchRecordingSourceRecord(input); return source ? transformMusicBrainzRecording(source) : undefined; }
+    async searchRecordingSourceRecords(input) { return searchMusicBrainzSourceRecords(this, MUSICBRAINZ_RECORDING_CATEGORY, input); }
+    async searchRecordings(input) { return searchMusicBrainz(this, MUSICBRAINZ_RECORDING_CATEGORY, input, this.transformOptions()); }
+    async fetchArtistSourceRecord(input) { return fetchMusicBrainzSourceRecord(this, MUSICBRAINZ_ARTIST_CATEGORY, input); }
+    async fetchArtist(input) { const source = await this.fetchArtistSourceRecord(input); return source ? transformMusicBrainzArtist(source) : undefined; }
+    async searchArtistSourceRecords(input) { return searchMusicBrainzSourceRecords(this, MUSICBRAINZ_ARTIST_CATEGORY, input); }
+    async searchArtists(input) { return searchMusicBrainz(this, MUSICBRAINZ_ARTIST_CATEGORY, input, this.transformOptions()); }
+    async fetchLabelSourceRecord(input) { return fetchMusicBrainzSourceRecord(this, MUSICBRAINZ_LABEL_CATEGORY, input); }
+    async fetchLabel(input) { const source = await this.fetchLabelSourceRecord(input); return source ? transformMusicBrainzLabel(source) : undefined; }
+    async searchLabelSourceRecords(input) { return searchMusicBrainzSourceRecords(this, MUSICBRAINZ_LABEL_CATEGORY, input); }
+    async searchLabels(input) { return searchMusicBrainz(this, MUSICBRAINZ_LABEL_CATEGORY, input, this.transformOptions()); }
+    async fetchWorkSourceRecord(input) { return fetchMusicBrainzSourceRecord(this, MUSICBRAINZ_WORK_CATEGORY, input); }
+    async fetchWork(input) { const source = await this.fetchWorkSourceRecord(input); return source ? transformMusicBrainzWork(source) : undefined; }
+    async searchWorkSourceRecords(input) { return searchMusicBrainzSourceRecords(this, MUSICBRAINZ_WORK_CATEGORY, input); }
+    async searchWorks(input) { return searchMusicBrainz(this, MUSICBRAINZ_WORK_CATEGORY, input, this.transformOptions()); }
+}
+export async function fetchMusicBrainzSourceRecord(provider, category, input) {
+    const id = musicBrainzId(input.id);
+    const payload = await provider.getJson(`/${entityPath(category)}/${id}`, { inc: lookupIncludes(category) });
+    if (!payload)
+        return undefined;
+    return createSourceRecord({ source: { provider: MUSICBRAINZ_PROVIDER, category, externalId: id }, payload });
+}
+export async function searchMusicBrainzSourceRecords(provider, category, input) {
+    const payload = await searchPayload(provider, category, input);
+    const results = searchItems(payload, category);
+    return {
+        results: await Promise.all(results.map((item) => createSourceRecord({ source: { provider: MUSICBRAINZ_PROVIDER, category, externalId: stringField(item, "id") ?? "" }, payload: item }))),
+        pagination: pagination(payload)
+    };
+}
+export async function searchMusicBrainz(provider, category, input, options = {}) {
+    const payload = await searchPayload(provider, category, input);
+    const results = [];
+    for (const item of searchItems(payload, category)) {
+        const externalId = stringField(item, "id");
+        const title = titleFor(item, category);
+        if (!externalId || !title)
+            continue;
+        const zuuid = await providerZuuid({ provider: MUSICBRAINZ_PROVIDER, category, externalId });
+        results.push({
+            id: zuuid,
+            zuuid,
+            category: publicCategory(category),
+            title,
+            date: dateFor(item, category),
+            cover: coverFor(item, category, options),
+            rating: null,
+            weight: numberValue(item.score),
+            relationType: null,
+            attribute: attributeFor(item, category),
+            order: null,
+            source: { source: MUSICBRAINZ_PROVIDER, category, value: externalId }
+        });
+    }
+    return { results, pagination: pagination(payload) };
+}
+async function searchPayload(provider, category, input) {
+    const query = input.query.trim();
+    if (!query)
+        throw new Error("MusicBrainz search query must not be empty");
+    return objectPayload(await provider.getJson(`/${entityPath(category)}`, {
+        query,
+        limit: String(input.limit ?? 25),
+        offset: String(input.offset ?? 0)
+    }) ?? {});
+}
+function searchItems(payload, category) {
+    const value = payload[searchKey(category)];
+    return Array.isArray(value) ? value.filter(isObject) : [];
+}
+function pagination(payload) {
+    const count = numberValue(payload.count) ?? 0;
+    const offset = numberValue(payload.offset) ?? 0;
+    const limit = Array.isArray(payload[searchKeyFromPayload(payload)]) ? payload[searchKeyFromPayload(payload)].length : 0;
+    return { page: limit > 0 ? Math.floor(offset / limit) + 1 : 1, totalPages: limit > 0 ? Math.ceil(count / limit) : 0, totalResults: count };
+}
+function searchKeyFromPayload(payload) {
+    return ["releases", "release-groups", "recordings", "artists", "labels", "works"].find((key) => Array.isArray(payload[key])) ?? "";
+}
+function lookupIncludes(category) {
+    switch (category) {
+        case MUSICBRAINZ_RELEASE_CATEGORY:
+            return "artists+labels+release-groups+media+recordings+genres+tags+url-rels";
+        case MUSICBRAINZ_RELEASE_GROUP_CATEGORY:
+            return "artists+releases+genres+tags+url-rels";
+        case MUSICBRAINZ_RECORDING_CATEGORY:
+            return "artists+releases+isrcs+genres+tags+work-rels+url-rels";
+        case MUSICBRAINZ_ARTIST_CATEGORY:
+            return "aliases+annotation+genres+tags+area-rels+url-rels";
+        case MUSICBRAINZ_LABEL_CATEGORY:
+            return "aliases+annotation+genres+tags+area-rels+url-rels";
+        case MUSICBRAINZ_WORK_CATEGORY:
+            return "aliases+annotation+artists+iswcs+genres+tags+artist-rels+url-rels";
+        default:
+            return "genres+tags";
+    }
+}
+function entityPath(category) { return category === MUSICBRAINZ_RELEASE_GROUP_CATEGORY ? "release-group" : category; }
+function searchKey(category) { return category === MUSICBRAINZ_RELEASE_GROUP_CATEGORY ? "release-groups" : `${category}s`; }
+function publicCategory(category) { return category === MUSICBRAINZ_RELEASE_GROUP_CATEGORY ? "release_group" : category === MUSICBRAINZ_WORK_CATEGORY ? "musical_work" : category; }
+function titleFor(item, category) { return category === MUSICBRAINZ_ARTIST_CATEGORY || category === MUSICBRAINZ_LABEL_CATEGORY ? stringField(item, "name") : stringField(item, "title"); }
+function dateFor(item, category) { return (category === MUSICBRAINZ_RELEASE_GROUP_CATEGORY ? stringField(item, "first-release-date") : category === MUSICBRAINZ_RECORDING_CATEGORY ? stringField(item, "first-release-date") : category === MUSICBRAINZ_ARTIST_CATEGORY || category === MUSICBRAINZ_LABEL_CATEGORY ? nestedString(item, ["life-span", "begin"]) : stringField(item, "date")) ?? null; }
+function attributeFor(item, category) { return category === MUSICBRAINZ_ARTIST_CATEGORY || category === MUSICBRAINZ_LABEL_CATEGORY || category === MUSICBRAINZ_WORK_CATEGORY ? stringField(item, "type") ?? null : stringField(item, "primary-type") ?? stringField(item, "status") ?? null; }
+function coverFor(item, category, options) { const id = stringField(item, "id"); if (!id)
+    return null; if (category === MUSICBRAINZ_RELEASE_GROUP_CATEGORY && options.releaseGroupCoverArtBaseUrl)
+    return `${options.releaseGroupCoverArtBaseUrl.replace(/\/$/, "")}/${id}/front`; if (category === MUSICBRAINZ_RELEASE_CATEGORY && options.coverArtBaseUrl && objectPayload(item["cover-art-archive"] ?? {}).front === true)
+    return `${options.coverArtBaseUrl.replace(/\/$/, "")}/${id}/front`; return null; }
+function numberValue(value) { if (typeof value === "number" && Number.isFinite(value))
+    return value; if (typeof value === "string") {
+    const parsed = Number(value);
+    return Number.isFinite(parsed) ? parsed : null;
+} return null; }
+function isObject(value) { return !!value && typeof value === "object" && !Array.isArray(value); }
+function musicBrainzId(value) {
+    const id = value.trim();
+    if (!/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(id))
+        throw new Error(`Invalid MusicBrainz MBID: ${value}`);
+    return id.toLowerCase();
+}

package/dist/providers/musicbrainz/constants.d.ts

@@ -7,4 +7,6 @@ export declare const MUSICBRAINZ_LABEL_CATEGORY = "label";
 export declare const MUSICBRAINZ_WORK_CATEGORY = "work";
 export declare const MUSICBRAINZ_COVER_ART_BASE_URL = "https://coverartarchive.org/release";
 export declare const MUSICBRAINZ_RELEASE_GROUP_COVER_ART_BASE_URL = "https://coverartarchive.org/release-group";
+export declare const MUSICBRAINZ_API_BASE = "https://musicbrainz.org/ws/2";
+export declare const MUSICBRAINZ_DEFAULT_USER_AGENT = "@zivue/zuuid/0.2.3 (https://github.com/zivue/zuuid)";
 //# sourceMappingURL=constants.d.ts.map

package/dist/providers/musicbrainz/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/providers/musicbrainz/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,oBAAoB,gBAAgB,CAAC;AAClD,eAAO,MAAM,4BAA4B,YAAY,CAAC;AACtD,eAAO,MAAM,kCAAkC,kBAAkB,CAAC;AAClE,eAAO,MAAM,8BAA8B,cAAc,CAAC;AAC1D,eAAO,MAAM,2BAA2B,WAAW,CAAC;AACpD,eAAO,MAAM,0BAA0B,UAAU,CAAC;AAClD,eAAO,MAAM,yBAAyB,SAAS,CAAC;AAChD,eAAO,MAAM,8BAA8B,wCAAwC,CAAC;AACpF,eAAO,MAAM,4CAA4C,8CAA8C,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/providers/musicbrainz/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,oBAAoB,gBAAgB,CAAC;AAClD,eAAO,MAAM,4BAA4B,YAAY,CAAC;AACtD,eAAO,MAAM,kCAAkC,kBAAkB,CAAC;AAClE,eAAO,MAAM,8BAA8B,cAAc,CAAC;AAC1D,eAAO,MAAM,2BAA2B,WAAW,CAAC;AACpD,eAAO,MAAM,0BAA0B,UAAU,CAAC;AAClD,eAAO,MAAM,yBAAyB,SAAS,CAAC;AAChD,eAAO,MAAM,8BAA8B,wCAAwC,CAAC;AACpF,eAAO,MAAM,4CAA4C,8CAA8C,CAAC;AACxG,eAAO,MAAM,oBAAoB,iCAAiC,CAAC;AACnE,eAAO,MAAM,8BAA8B,wDAAwD,CAAC"}

package/dist/providers/musicbrainz/constants.js

@@ -7,3 +7,5 @@ export const MUSICBRAINZ_LABEL_CATEGORY = "label";
 export const MUSICBRAINZ_WORK_CATEGORY = "work";
 export const MUSICBRAINZ_COVER_ART_BASE_URL = "https://coverartarchive.org/release";
 export const MUSICBRAINZ_RELEASE_GROUP_COVER_ART_BASE_URL = "https://coverartarchive.org/release-group";
+export const MUSICBRAINZ_API_BASE = "https://musicbrainz.org/ws/2";
+export const MUSICBRAINZ_DEFAULT_USER_AGENT = "@zivue/zuuid/0.2.3 (https://github.com/zivue/zuuid)";

package/dist/providers/musicbrainz/index.d.ts

@@ -1,3 +1,4 @@
+export * from "./client.js";
 export * from "./artist.js";
 export * from "./constants.js";
 export * from "./label.js";
@@ -5,4 +6,5 @@ export * from "./recording.js";
 export * from "./release.js";
 export * from "./release-group.js";
 export * from "./work.js";
+export * from "./types.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/providers/musicbrainz/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/providers/musicbrainz/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/providers/musicbrainz/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC"}

package/dist/providers/musicbrainz/index.js

@@ -1,3 +1,4 @@
+export * from "./client.js";
 export * from "./artist.js";
 export * from "./constants.js";
 export * from "./label.js";
@@ -5,3 +6,4 @@ export * from "./recording.js";
 export * from "./release.js";
 export * from "./release-group.js";
 export * from "./work.js";
+export * from "./types.js";

package/dist/providers/musicbrainz/types.d.ts

@@ -0,0 +1,21 @@
+export type MusicBrainzFetchLike = (input: string | URL, init?: RequestInit) => Promise<Response>;
+export type MusicBrainzProviderOptions = {
+    apiBase?: string;
+    fetch?: MusicBrainzFetchLike;
+    userAgent?: string;
+    coverArtBaseUrl?: string | null;
+    releaseGroupCoverArtBaseUrl?: string | null;
+};
+export type MusicBrainzProviderTransformOptions = {
+    coverArtBaseUrl?: string | null;
+    releaseGroupCoverArtBaseUrl?: string | null;
+};
+export type FetchMusicBrainzInput = {
+    id: string;
+};
+export type MusicBrainzSearchInput = {
+    query: string;
+    limit?: number;
+    offset?: number;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/providers/musicbrainz/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/providers/musicbrainz/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,oBAAoB,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;AAElG,MAAM,MAAM,0BAA0B,GAAG;IACvC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,oBAAoB,CAAC;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,2BAA2B,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7C,CAAC;AAEF,MAAM,MAAM,mCAAmC,GAAG;IAChD,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,2BAA2B,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7C,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,EAAE,EAAE,MAAM,CAAC;CACZ,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC"}

package/dist/providers/musicbrainz/types.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zivue/zuuid",
-  "version": "0.2.2",
+  "version": "0.2.3",
   "description": "TypeScript helpers for fetching, searching, and transforming Zuuid datasets.",
   "type": "module",
   "license": "MIT",
@@ -255,6 +255,10 @@
     "./providers/gamesdb/client": {
       "types": "./dist/providers/gamesdb/client.d.ts",
       "import": "./dist/providers/gamesdb/client.js"
+    },
+    "./providers/musicbrainz/client": {
+      "types": "./dist/providers/musicbrainz/client.d.ts",
+      "import": "./dist/providers/musicbrainz/client.js"
     }
   },
   "types": "./dist/index.d.ts",