@zivue/zuuid 0.2.0 → 0.2.2

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## 0.2.2 - 2026-05-25
+
+- Added IMDb fetch-by-ID scraper support for movie and TV title pages.
+- Added GamesDB live game search/fetch, platform fetch, `play.gamesdb` client support, and native API envelope/image handling.
+- Removed hardcoded fixture payloads from the fetch example; examples now cover live fetch-capable providers only.
+- Removed duplicate transformed TMDB TV `content_ratings` details while keeping normalized `certifications`.
+- Added `AGENTS.md` guidance for AI coding agents working in this repository.
+
+## 0.2.1 - 2026-05-24
+
+- Normalized provider ratings to a shared `0-5` scale while preserving native provider scores in `provider_rating` details.
+- Trimmed TMDB movie certification details and stopped emitting full `release_dates` detail payloads.
+- Added README documentation for raw source records, transformed output, transformer-only providers, and normalized ratings.
+
 ## 0.2.0 - 2026-05-24
 
 - Added Open Library provider support for books and authors.

package/README.md

@@ -1,8 +1,10 @@
 # @zivue/zuuid
 
-Search, fetch, and normalize media metadata from external providers into a shared Zivue/Zuuid data shape.
+Search, fetch, and normalize media metadata from external providers into a shared Zuuid data shape.
 
-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. It currently supports TMDB movies, TV shows, and people, plus Open Library books and authors.
+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`.
 
 Storage, caching, indexing, review state, object-store keys, and persistence belong in a layer outside this package.
 
@@ -59,7 +61,7 @@ console.log(movies?.results[0]);
 //   title: "Fight Club",
 //   date: "1999-10-15",
 //   cover: "https://image.tmdb.org/t/p/w500/...",
-//   rating: 8.4,
+//   rating: 4.2,
 //   weight: 20.0,
 //   relationType: null,
 //   attribute: null,
@@ -96,6 +98,8 @@ console.log(movie);
 
 Search results, relations, and recommendations share the same lightweight list item fields: `id`, `zuuid`, `category`, `title`, `date`, `cover`, `rating`, `weight`, `relationType`, `attribute`, and `order`.
 
+Ratings are normalized to a `0-5` scale when the provider exposes a compatible numeric score. The original provider score is preserved in details as `provider_rating` for providers whose native scale differs.
+
 ## Supported Providers
 
 | Provider | Category | Search | Fetch | Transform |
@@ -105,6 +109,69 @@ Search results, relations, and recommendations share the same lightweight list i
 | TMDB | person | yes | yes | yes |
 | Open Library | book | yes | yes | yes |
 | Open Library | author | yes | yes | yes |
+| ComicVine | volume, issue, story_arc, character, person, publisher | no | no | yes |
+| IMDb | movie, tv | no | yes | yes |
+| 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 |
+| OpenFoodFacts | product | no | no | yes |
+| OpenStreetMap | city, country, place, venue | no | no | yes |
+| Podcast / iTunes | podcast | no | no | yes |
+| Setlist.fm | setlist, artist, venue | no | no | yes |
+| Ticketmaster | event, attraction, venue | no | no | yes |
+| Wger | exercise, equipment | no | no | yes |
+
+For IMDb, search is marked `no` because the scraper fetches known title IDs such as `tt0137523`; it does not implement IMDb search. GamesDB platform search is marked `no` because only game search and ID fetches are currently implemented. For transformer-only providers, "Search" and "Fetch" are marked `no` because this package does not perform those HTTP requests yet. Use your own provider client or stored payloads, wrap the payload in a `SourceRecord`, and call the category transformer.
+
+
+
+## GamesDB Credentials
+
+`GamesDbProvider` uses TheGamesDB v1 API and requires an API key:
+
+```ts
+import { GamesDbProvider } from "@zivue/zuuid/providers/gamesdb";
+
+const gamesdb = new GamesDbProvider({
+  apiKey: process.env.GAMESDB_API_KEY!
+});
+
+const game = await gamesdb.fetchGame({ id: 17444 });
+const search = await gamesdb.searchGames({ query: "Chrono Trigger" });
+const platform = await gamesdb.fetchPlatform({ id: 6 });
+```
+
+The category-first client exposes GamesDB under `play.gamesdb`:
+
+```ts
+const zuuid = createZuuidClient({
+  providers: { gamesdb: { apiKey: process.env.GAMESDB_API_KEY! } }
+});
+
+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.
+
+## 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`.
+
+```ts
+import { ImdbProvider } from "@zivue/zuuid/providers/imdb";
+
+const imdb = new ImdbProvider();
+const movie = await imdb.fetchMovie({ id: "tt0137523" });
+const tv = await imdb.fetchTv({ id: "tt0944947" });
+```
+
+The category-first client exposes the same fetch-only provider under `movie.imdb` and `tv.imdb`:
+
+```ts
+const zuuid = createZuuidClient({ providers: { imdb: {} } });
+const movie = await zuuid.movie.imdb?.fetch({ id: "tt0137523" });
+```
 
 ## TMDB Credentials
 
@@ -204,6 +271,33 @@ const source = await tmdb.fetchMovieSourceRecord({ id: 550 });
 const movie = source ? await transformTmdbMovie(source, tmdb.transformOptions()) : undefined;
 ```
 
+The source record contains the raw payload:
+
+```ts
+console.log(source?.payload);
+```
+
+The transform result is normalized `ZuuidData`:
+
+```ts
+console.log(movie?.primaryTitle);
+console.log(movie?.externalIds);
+console.log(movie?.provenance);
+```
+
+For transformer-only providers:
+
+```ts
+import { createSourceRecord, transformGamesDbGame } from "@zivue/zuuid";
+
+const source = await createSourceRecord({
+  source: { provider: "gamesdb", category: "game", externalId: "17444" },
+  payload: rawGamesDbPayload
+});
+
+const game = await transformGamesDbGame(source);
+```
+
 Category-specific imports are available:
 
 ```ts
@@ -212,6 +306,11 @@ import { transformTmdbTv } from "@zivue/zuuid/providers/tmdb/tv";
 import { transformTmdbPerson } from "@zivue/zuuid/providers/tmdb/person";
 import { transformOpenLibraryBook } from "@zivue/zuuid/providers/openlibrary/book";
 import { transformOpenLibraryAuthor } from "@zivue/zuuid/providers/openlibrary/author";
+import { transformMusicBrainzReleaseGroup } from "@zivue/zuuid/providers/musicbrainz/release-group";
+import { transformComicVineIssue } from "@zivue/zuuid/providers/comicvine/issue";
+import { transformJikanProducer } from "@zivue/zuuid/providers/jikan/producer";
+import { transformOpenStreetMapVenue } from "@zivue/zuuid/providers/openstreetmap/venue";
+import { transformWgerEquipment } from "@zivue/zuuid/providers/wger/equipment";
 ```
 
 ## Data Model
@@ -277,7 +376,7 @@ zuuid.read.openlibrary?.search({ query: "The Lord of the Rings" });
 zuuid.read.openlibrary?.fetch({ id: "OL82563W" });
 ```
 
-## CLI Examples
+## Example Scripts
 
 The examples read `.env` from the repo root:
 
@@ -309,7 +408,30 @@ npm run example:fetch -- book OL82563W
 npm run example:fetch -- author OL23919A
 ```
 
-The examples write debug output to `data/tmdb/...` or `data/openlibrary/...`.
+Fetch live provider examples:
+
+```sh
+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
+```
+
+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.
+
+`example:fetch` writes both raw and transformed JSON:
+
+```text
+data/<provider>/<category>/<id>.raw.json
+data/<provider>/<category>/<id>.zuuid.json
+```
+
+`example:search` writes raw and transformed search JSON:
+
+```text
+data/<provider>/search/<category>/<query>.raw-search.json
+data/<provider>/search/<category>/<query>.zuuid-search.json
+```
 
 ## API Reference
 
@@ -327,11 +449,32 @@ Provider exports:
 
 - `TmdbProvider`
 - `OpenLibraryProvider`
+- `ImdbProvider`
+- `GamesDbProvider`
 - `transformTmdbMovie(sourceRecord, options?)`
 - `transformTmdbTv(sourceRecord, options?)`
 - `transformTmdbPerson(sourceRecord, options?)`
+- `transformImdbMovie(sourceRecord, options?)`
+- `transformImdbTv(sourceRecord, options?)`
 - `transformOpenLibraryBook(sourceRecord, options?)`
 - `transformOpenLibraryAuthor(sourceRecord, options?)`
+- `transformComicVine(sourceRecord)`
+- `transformGamesDbGame(sourceRecord, options?)`
+- `transformGamesDbPlatform(sourceRecord, options?)`
+- `transformJikan(sourceRecord)`
+- `transformMusicBrainzRelease(sourceRecord, options?)`
+- `transformMusicBrainzReleaseGroup(sourceRecord, options?)`
+- `transformMusicBrainzRecording(sourceRecord)`
+- `transformMusicBrainzArtist(sourceRecord)`
+- `transformMusicBrainzLabel(sourceRecord)`
+- `transformMusicBrainzWork(sourceRecord)`
+- `transformOpenFoodFactsProduct(sourceRecord)`
+- `transformOpenStreetMapPlace(sourceRecord)`
+- `transformPodcast(sourceRecord)`
+- `transformSetlistFm(sourceRecord)`
+- `transformTicketmaster(sourceRecord)`
+- `transformWgerExercise(sourceRecord)`
+- `transformWgerEquipment(sourceRecord)`
 - `searchTmdbMovies(provider, input, options?)`
 - `searchTmdbTv(provider, input, options?)`
 - `searchTmdbPeople(provider, input, options?)`

package/dist/client.d.ts

@@ -1,8 +1,12 @@
 import type { SearchResponse, ZuuidData, ZuuidSearchResult } from "./entity.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";
+import { type FetchImdbTitleInput, type ImdbProviderOptions } from "./providers/imdb/index.js";
 import type { SourceRecord } from "./source.js";
 export type ProviderConfigs = {
+    gamesdb?: GamesDbProviderOptions;
+    imdb?: ImdbProviderOptions;
     openlibrary?: OpenLibraryProviderOptions;
     tmdb?: TmdbProviderOptions;
 };
@@ -16,6 +20,11 @@ export type MovieProviderClient<TFetchInput> = {
     searchSourceRecords(input: TmdbSearchInput): Promise<SearchResponse<SourceRecord>>;
     transform(source: SourceRecord): Promise<ZuuidData>;
 };
+export type FetchOnlyProviderClient<TFetchInput> = {
+    fetch(input: TFetchInput): Promise<ZuuidData | undefined>;
+    fetchSourceRecord(input: TFetchInput): Promise<SourceRecord | undefined>;
+    transform(source: SourceRecord): Promise<ZuuidData>;
+};
 export type ProviderClient<TFetchInput, TSearchInput> = {
     fetch(input: TFetchInput): Promise<ZuuidData | undefined>;
     fetchSourceRecord(input: TFetchInput): Promise<SourceRecord | undefined>;
@@ -25,9 +34,11 @@ export type ProviderClient<TFetchInput, TSearchInput> = {
 };
 export type ZuuidClient = {
     movie: {
+        imdb?: FetchOnlyProviderClient<FetchImdbTitleInput>;
         tmdb?: ProviderClient<FetchTmdbMovieInput, TmdbSearchInput>;
     };
     tv: {
+        imdb?: FetchOnlyProviderClient<FetchImdbTitleInput>;
         tmdb?: ProviderClient<FetchTmdbTvInput, TmdbSearchInput>;
     };
     people: {
@@ -37,6 +48,12 @@ export type ZuuidClient = {
     read: {
         openlibrary?: ProviderClient<FetchOpenLibraryBookInput, OpenLibrarySearchInput>;
     };
+    play: {
+        gamesdb?: {
+            game: ProviderClient<FetchGamesDbGameInput, GamesDbSearchInput>;
+            platform: FetchOnlyProviderClient<FetchGamesDbPlatformInput>;
+        };
+    };
 };
 export declare function createZuuidClient(config?: ZuuidClientConfig): ZuuidClient;
 //# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChF,OAAO,EAIL,KAAK,2BAA2B,EAChC,KAAK,yBAAyB,EAC9B,KAAK,0BAA0B,EAC/B,KAAK,sBAAsB,EAC5B,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAKL,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACrB,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,MAAM,MAAM,eAAe,GAAG;IAC5B,WAAW,CAAC,EAAE,0BAA0B,CAAC;IACzC,IAAI,CAAC,EAAE,mBAAmB,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,SAAS,CAAC,EAAE,eAAe,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,mBAAmB,CAAC,WAAW,IAAI;IAC7C,KAAK,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC,CAAC;IAC1D,iBAAiB,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,CAAC;IACzE,MAAM,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC,iBAAiB,CAAC,CAAC,CAAC;IAC3E,mBAAmB,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC,YAAY,CAAC,CAAC,CAAC;IACnF,SAAS,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;CACrD,CAAC;AAEF,MAAM,MAAM,cAAc,CAAC,WAAW,EAAE,YAAY,IAAI;IACtD,KAAK,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC,CAAC;IAC1D,iBAAiB,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,CAAC;IACzE,MAAM,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,cAAc,CAAC,iBAAiB,CAAC,CAAC,CAAC;IACxE,mBAAmB,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,cAAc,CAAC,YAAY,CAAC,CAAC,CAAC;IAChF,SAAS,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;CACrD,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,KAAK,EAAE;QACL,IAAI,CAAC,EAAE,cAAc,CAAC,mBAAmB,EAAE,eAAe,CAAC,CAAC;KAC7D,CAAC;IACF,EAAE,EAAE;QACF,IAAI,CAAC,EAAE,cAAc,CAAC,gBAAgB,EAAE,eAAe,CAAC,CAAC;KAC1D,CAAC;IACF,MAAM,EAAE;QACN,IAAI,CAAC,EAAE,cAAc,CAAC,oBAAoB,EAAE,eAAe,CAAC,CAAC;QAC7D,WAAW,CAAC,EAAE,cAAc,CAAC,2BAA2B,EAAE,sBAAsB,CAAC,CAAC;KACnF,CAAC;IACF,IAAI,EAAE;QACJ,WAAW,CAAC,EAAE,cAAc,CAAC,yBAAyB,EAAE,sBAAsB,CAAC,CAAC;KACjF,CAAC;CACH,CAAC;AAEF,wBAAgB,iBAAiB,CAAC,MAAM,GAAE,iBAAsB,GAAG,WAAW,CA2D7E"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/client.js

@@ -1,10 +1,21 @@
 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";
+import { ImdbProvider, transformImdbMovie, transformImdbTv } from "./providers/imdb/index.js";
 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 openlibrary = config.providers?.openlibrary ? new OpenLibraryProvider(config.providers.openlibrary) : undefined;
     const tmdb = config.providers?.tmdb ? new TmdbProvider(config.providers.tmdb) : undefined;
     return Object.freeze({
         movie: Object.freeze({
+            imdb: imdb
+                ? Object.freeze({
+                    fetch: (input) => imdb.fetchMovie(input),
+                    fetchSourceRecord: (input) => imdb.fetchMovieSourceRecord(input),
+                    transform: (source) => transformImdbMovie(source, imdb.transformOptions())
+                })
+                : undefined,
             tmdb: tmdb
                 ? Object.freeze({
                     fetch: (input) => tmdb.fetchMovie(input),
@@ -16,6 +27,13 @@ export function createZuuidClient(config = {}) {
                 : undefined
         }),
         tv: Object.freeze({
+            imdb: imdb
+                ? Object.freeze({
+                    fetch: (input) => imdb.fetchTv(input),
+                    fetchSourceRecord: (input) => imdb.fetchTvSourceRecord(input),
+                    transform: (source) => transformImdbTv(source, imdb.transformOptions())
+                })
+                : undefined,
             tmdb: tmdb
                 ? Object.freeze({
                     fetch: (input) => tmdb.fetchTv(input),
@@ -56,6 +74,24 @@ export function createZuuidClient(config = {}) {
                     transform: (source) => transformOpenLibraryBook(source, openlibrary.transformOptions())
                 })
                 : undefined
+        }),
+        play: Object.freeze({
+            gamesdb: gamesdb
+                ? Object.freeze({
+                    game: Object.freeze({
+                        fetch: (input) => gamesdb.fetchGame(input),
+                        fetchSourceRecord: (input) => gamesdb.fetchGameSourceRecord(input),
+                        search: (input) => gamesdb.searchGames(input),
+                        searchSourceRecords: (input) => gamesdb.searchGameSourceRecords(input),
+                        transform: (source) => transformGamesDbGame(source, gamesdb.transformOptions())
+                    }),
+                    platform: Object.freeze({
+                        fetch: (input) => gamesdb.fetchPlatform(input),
+                        fetchSourceRecord: (input) => gamesdb.fetchPlatformSourceRecord(input),
+                        transform: (source) => transformGamesDbPlatform(source, gamesdb.transformOptions())
+                    })
+                })
+                : undefined
         })
     });
 }

package/dist/identity.d.ts

@@ -1,4 +1,4 @@
-export type ProviderName = "musicbrainz" | "gamesdb" | "openlibrary" | "tmdb" | "jikan" | "comicvine" | "setlistfm" | "ticketmaster" | "podcast" | "openstreetmap" | "wger" | "openfoodfacts" | "goodreads" | "rss" | "web";
+export type ProviderName = "musicbrainz" | "gamesdb" | "openlibrary" | "imdb" | "tmdb" | "jikan" | "comicvine" | "setlistfm" | "ticketmaster" | "podcast" | "openstreetmap" | "wger" | "openfoodfacts" | "goodreads" | "rss" | "web";
 export type ProviderNamespace = {
     provider: ProviderName;
     namespace: string;

package/dist/identity.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../src/identity.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,YAAY,GACpB,aAAa,GACb,SAAS,GACT,aAAa,GACb,MAAM,GACN,OAAO,GACP,WAAW,GACX,WAAW,GACX,cAAc,GACd,SAAS,GACT,eAAe,GACf,MAAM,GACN,eAAe,GACf,WAAW,GACX,KAAK,GACL,KAAK,CAAC;AAEV,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,EAAE,YAAY,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC;CAC7B,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,iBAAiB,EAgBlD,CAAC;AAEF,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEtE;AAED,wBAAsB,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,CAkB9E"}
+{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../src/identity.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,YAAY,GACpB,aAAa,GACb,SAAS,GACT,aAAa,GACb,MAAM,GACN,MAAM,GACN,OAAO,GACP,WAAW,GACX,WAAW,GACX,cAAc,GACd,SAAS,GACT,eAAe,GACf,MAAM,GACN,eAAe,GACf,WAAW,GACX,KAAK,GACL,KAAK,CAAC;AAEV,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,EAAE,YAAY,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC;CAC7B,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,iBAAiB,EAiBlD,CAAC;AAEF,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEtE;AAED,wBAAsB,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,CAkB9E"}

package/dist/identity.js

@@ -3,6 +3,7 @@ export const PROVIDER_NAMESPACES = [
     { provider: "musicbrainz", namespace: "9e4a2c71-f528-4d83-b710-a40c3e917f2a" },
     { provider: "gamesdb", namespace: "7ca1b820-aebc-41d2-90c5-00d05fe440d9" },
     { provider: "openlibrary", namespace: "3ea1c742-b50f-4a93-912d-7c8e1fa364d1" },
+    { provider: "imdb", namespace: "0a29a9f5-9d8f-45d7-8d18-03d966bdadfb" },
     { provider: "tmdb", namespace: "6ba7b810-9dad-11d1-80b4-00c04fd430c8" },
     { provider: "jikan", namespace: "7ca8b920-aebe-22e2-91c5-01d15ee541d9" },
     { provider: "comicvine", namespace: "8db9ca31-bfcf-33f3-a2d6-12e26ff652ea" },

package/dist/index.d.ts

@@ -4,6 +4,7 @@ export * from "./entity.js";
 export * from "./identity.js";
 export * from "./providers/comicvine/index.js";
 export * from "./providers/gamesdb/index.js";
+export * from "./providers/imdb/index.js";
 export * from "./providers/jikan/index.js";
 export * from "./providers/musicbrainz/index.js";
 export * from "./providers/openlibrary/index.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,gCAAgC,CAAC;AAC/C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,kCAAkC,CAAC;AACjD,cAAc,kCAAkC,CAAC;AACjD,cAAc,oCAAoC,CAAC;AACnD,cAAc,oCAAoC,CAAC;AACnD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,mCAAmC,CAAC;AAClD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,gCAAgC,CAAC;AAC/C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,kCAAkC,CAAC;AACjD,cAAc,kCAAkC,CAAC;AACjD,cAAc,oCAAoC,CAAC;AACnD,cAAc,oCAAoC,CAAC;AACnD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,mCAAmC,CAAC;AAClD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC"}

package/dist/index.js

@@ -4,6 +4,7 @@ export * from "./entity.js";
 export * from "./identity.js";
 export * from "./providers/comicvine/index.js";
 export * from "./providers/gamesdb/index.js";
+export * from "./providers/imdb/index.js";
 export * from "./providers/jikan/index.js";
 export * from "./providers/musicbrainz/index.js";
 export * from "./providers/openlibrary/index.js";

package/dist/providers/common.d.ts

@@ -17,6 +17,7 @@ export declare function addMedia(data: ZuuidData, provider: string, url: string
 export declare function stripHtml(input: string): string;
 export declare function datePrefix(value: string | undefined): string | undefined;
 export declare function formatNumber(value: number): string;
+export declare function normalizeRating(value: number | undefined | null, fromMin: number, fromMax: number, toMin?: number, toMax?: number): number | undefined;
 export declare function baseDataFromSource(source: SourceRecord, provider: string, category: string, publicCategory: string, externalId: string, primaryTitle: string): Promise<ZuuidData>;
 export declare function finalizeData(data: ZuuidData, source: SourceRecord, confidence?: number): ZuuidData;
 export declare function addRelation(data: ZuuidData, provider: string, category: string, externalId: string | undefined, relationType: string, title?: string, options?: Partial<Omit<EntityRelation, "id" | "zuuid" | "relationType" | "direction" | "category" | "title">>): Promise<void>;

package/dist/providers/common.d.ts.map

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

package/dist/providers/common.js

@@ -99,6 +99,14 @@ export function datePrefix(value) {
 export function formatNumber(value) {
     return value.toFixed(2).replace(/0+$/, "").replace(/\.$/, "");
 }
+export function normalizeRating(value, fromMin, fromMax, toMin = 0, toMax = 5) {
+    if (typeof value !== "number" || !Number.isFinite(value) || fromMax <= fromMin) {
+        return undefined;
+    }
+    const clamped = Math.min(Math.max(value, fromMin), fromMax);
+    const normalized = ((clamped - fromMin) / (fromMax - fromMin)) * (toMax - toMin) + toMin;
+    return Math.round(normalized * 1000) / 1000;
+}
 export async function baseDataFromSource(source, provider, category, publicCategory, externalId, primaryTitle) {
     const zuuid = await providerZuuid({ provider, category, externalId });
     return createZuuidData({ zuuid, category: publicCategory, primaryTitle });

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

@@ -0,0 +1,19 @@
+import type { SearchResponse, ZuuidData, ZuuidSearchResult } from "../../entity.js";
+import type { SourceRecord } from "../../source.js";
+import type { FetchGamesDbGameInput, FetchGamesDbPlatformInput, GamesDbProviderOptions, GamesDbSearchInput, GamesDbTransformOptions } from "./types.js";
+export declare class GamesDbProvider {
+    readonly apiBase: string;
+    readonly imageBaseUrl: string | null;
+    private readonly apiKey;
+    private readonly fetchImpl;
+    constructor(options: GamesDbProviderOptions);
+    getJson<T>(path: string, params: Record<string, string>): Promise<T | undefined>;
+    transformOptions(): GamesDbTransformOptions;
+    fetchGameSourceRecord(input: FetchGamesDbGameInput): Promise<SourceRecord | undefined>;
+    fetchGame(input: FetchGamesDbGameInput): Promise<ZuuidData | undefined>;
+    searchGameSourceRecords(input: GamesDbSearchInput): Promise<SearchResponse<SourceRecord>>;
+    searchGames(input: GamesDbSearchInput): Promise<SearchResponse<ZuuidSearchResult>>;
+    fetchPlatformSourceRecord(input: FetchGamesDbPlatformInput): Promise<SourceRecord | undefined>;
+    fetchPlatform(input: FetchGamesDbPlatformInput): Promise<ZuuidData | undefined>;
+}
+//# sourceMappingURL=client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/providers/gamesdb/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AASpD,OAAO,KAAK,EAAE,qBAAqB,EAAE,yBAAyB,EAAoB,sBAAsB,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAE1K,qBAAa,eAAe;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAmB;gBAEjC,OAAO,EAAE,sBAAsB;IAUrC,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IAmBtF,gBAAgB,IAAI,uBAAuB;IAIrC,qBAAqB,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC;IAItF,SAAS,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC;IAKvE,uBAAuB,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,cAAc,CAAC,YAAY,CAAC,CAAC;IAIzF,WAAW,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,cAAc,CAAC,iBAAiB,CAAC,CAAC;IAIlF,yBAAyB,CAAC,KAAK,EAAE,yBAAyB,GAAG,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC;IAI9F,aAAa,CAAC,KAAK,EAAE,yBAAyB,GAAG,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC;CAItF"}

package/dist/providers/gamesdb/client.js

@@ -0,0 +1,57 @@
+import { GAMESDB_API_BASE, GAMESDB_IMAGE_BASE_URL } from "./constants.js";
+import { fetchGamesDbGameSourceRecord, searchGamesDbGameSourceRecords, searchGamesDbGames, transformGamesDbGame } from "./game.js";
+import { fetchGamesDbPlatformSourceRecord, transformGamesDbPlatform } from "./platform.js";
+export class GamesDbProvider {
+    apiBase;
+    imageBaseUrl;
+    apiKey;
+    fetchImpl;
+    constructor(options) {
+        this.apiKey = options.apiKey.trim();
+        if (!this.apiKey) {
+            throw new Error("GamesDB API key must not be empty");
+        }
+        this.apiBase = options.apiBase ?? GAMESDB_API_BASE;
+        this.fetchImpl = options.fetch ?? globalThis.fetch.bind(globalThis);
+        this.imageBaseUrl = options.imageBaseUrl === undefined ? GAMESDB_IMAGE_BASE_URL : options.imageBaseUrl;
+    }
+    async getJson(path, params) {
+        const url = new URL(`${this.apiBase.replace(/\/$/, "")}/${path.replace(/^\//, "")}`);
+        url.searchParams.set("apikey", this.apiKey);
+        for (const [key, value] of Object.entries(params)) {
+            url.searchParams.set(key, value);
+        }
+        const response = await this.fetchImpl(url, { headers: { accept: "application/json" } });
+        if (response.status === 404) {
+            return undefined;
+        }
+        if (!response.ok) {
+            const body = await response.text().catch(() => "");
+            throw new Error(`GamesDB API returned ${response.status}: ${body}`);
+        }
+        return response.json();
+    }
+    transformOptions() {
+        return { imageBaseUrl: this.imageBaseUrl };
+    }
+    async fetchGameSourceRecord(input) {
+        return fetchGamesDbGameSourceRecord(this, input);
+    }
+    async fetchGame(input) {
+        const source = await this.fetchGameSourceRecord(input);
+        return source ? transformGamesDbGame(source, this.transformOptions()) : undefined;
+    }
+    async searchGameSourceRecords(input) {
+        return searchGamesDbGameSourceRecords(this, input);
+    }
+    async searchGames(input) {
+        return searchGamesDbGames(this, input, this.transformOptions());
+    }
+    async fetchPlatformSourceRecord(input) {
+        return fetchGamesDbPlatformSourceRecord(this, input);
+    }
+    async fetchPlatform(input) {
+        const source = await this.fetchPlatformSourceRecord(input);
+        return source ? transformGamesDbPlatform(source, this.transformOptions()) : undefined;
+    }
+}

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

@@ -1,4 +1,6 @@
 export declare const GAMESDB_PROVIDER = "gamesdb";
+export declare const GAMESDB_API_BASE = "https://api.thegamesdb.net/v1";
+export declare const GAMESDB_IMAGE_BASE_URL = "https://cdn.thegamesdb.net/images";
 export declare const GAMESDB_GAME_CATEGORY = "game";
 export declare const GAMESDB_PLATFORM_CATEGORY = "platform";
 //# sourceMappingURL=constants.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/providers/gamesdb/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,gBAAgB,YAAY,CAAC;AAC1C,eAAO,MAAM,qBAAqB,SAAS,CAAC;AAC5C,eAAO,MAAM,yBAAyB,aAAa,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/providers/gamesdb/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,gBAAgB,YAAY,CAAC;AAC1C,eAAO,MAAM,gBAAgB,kCAAkC,CAAC;AAChE,eAAO,MAAM,sBAAsB,sCAAsC,CAAC;AAC1E,eAAO,MAAM,qBAAqB,SAAS,CAAC;AAC5C,eAAO,MAAM,yBAAyB,aAAa,CAAC"}

package/dist/providers/gamesdb/constants.js

@@ -1,3 +1,5 @@
 export const GAMESDB_PROVIDER = "gamesdb";
+export const GAMESDB_API_BASE = "https://api.thegamesdb.net/v1";
+export const GAMESDB_IMAGE_BASE_URL = "https://cdn.thegamesdb.net/images";
 export const GAMESDB_GAME_CATEGORY = "game";
 export const GAMESDB_PLATFORM_CATEGORY = "platform";

package/dist/providers/gamesdb/game.d.ts

@@ -1,7 +1,9 @@
-import type { ZuuidData } from "../../entity.js";
-import type { SourceRecord } from "../../source.js";
-export type GamesDbTransformOptions = {
-    imageBaseUrl?: string | null;
-};
+import type { SearchResponse, ZuuidData, ZuuidSearchResult } from "../../entity.js";
+import { type SourceRecord } from "../../source.js";
+import type { GamesDbProvider } from "./client.js";
+import type { FetchGamesDbGameInput, GamesDbSearchInput, GamesDbTransformOptions } from "./types.js";
+export declare function fetchGamesDbGameSourceRecord(provider: GamesDbProvider, input: FetchGamesDbGameInput): Promise<SourceRecord | undefined>;
+export declare function searchGamesDbGameSourceRecords(provider: GamesDbProvider, input: GamesDbSearchInput): Promise<SearchResponse<SourceRecord>>;
+export declare function searchGamesDbGames(provider: GamesDbProvider, input: GamesDbSearchInput, options?: GamesDbTransformOptions): Promise<SearchResponse<ZuuidSearchResult>>;
 export declare function transformGamesDbGame(source: SourceRecord, options?: GamesDbTransformOptions): Promise<ZuuidData>;
 //# sourceMappingURL=game.d.ts.map

package/dist/providers/gamesdb/game.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"game.d.ts","sourceRoot":"","sources":["../../../src/providers/gamesdb/game.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAiBpD,MAAM,MAAM,uBAAuB,GAAG;IACpC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B,CAAC;AAEF,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,YAAY,EACpB,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,SAAS,CAAC,CAsBpB"}
+{"version":3,"file":"game.d.ts","sourceRoot":"","sources":["../../../src/providers/gamesdb/game.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEpF,OAAO,EAAsB,KAAK,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAGxE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,KAAK,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAmBrG,wBAAsB,4BAA4B,CAChD,QAAQ,EAAE,eAAe,EACzB,KAAK,EAAE,qBAAqB,GAC3B,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,CASnC;AAED,wBAAsB,8BAA8B,CAClD,QAAQ,EAAE,eAAe,EACzB,KAAK,EAAE,kBAAkB,GACxB,OAAO,CAAC,cAAc,CAAC,YAAY,CAAC,CAAC,CAOvC;AAED,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,eAAe,EACzB,KAAK,EAAE,kBAAkB,EACzB,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,cAAc,CAAC,iBAAiB,CAAC,CAAC,CAyB5C;AAED,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,YAAY,EACpB,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,SAAS,CAAC,CAoCpB"}