@zivue/zuuid 0.2.1 → 0.2.2

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # 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.

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 and Open Library include live search/fetch clients. Additional providers currently expose source-record transformers: you provide the raw provider payload, and this package normalizes it into `ZuuidData`.
+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.
 
@@ -110,7 +110,9 @@ Ratings are normalized to a `0-5` scale when the provider exposes a compatible n
 | Open Library | book | yes | yes | yes |
 | Open Library | author | yes | yes | yes |
 | ComicVine | volume, issue, story_arc, character, person, publisher | no | no | yes |
-| GamesDB | game, platform | 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 |
@@ -120,7 +122,56 @@ Ratings are normalized to a `0-5` scale when the provider exposes a compatible n
 | Ticketmaster | event, attraction, venue | no | no | yes |
 | Wger | exercise, equipment | no | no | yes |
 
-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.
+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
 
@@ -357,22 +408,17 @@ npm run example:fetch -- book OL82563W
 npm run example:fetch -- author OL23919A
 ```
 
-Fetch fixture-backed transformer examples:
+Fetch live provider examples:
 
 ```sh
-npm run example:fetch -- gamesdb:game 17444
-npm run example:fetch -- gamesdb:platform 6
-npm run example:fetch -- musicbrainz:release-group aaa50249-1e6b-3910-b830-7e2fb622a8c4
-npm run example:fetch -- musicbrainz:recording 0b5d8c0f-4975-4e44-9e67-0a5f1b5939f6
-npm run example:fetch -- comicvine:issue 101
-npm run example:fetch -- comicvine:story_arc 201
-npm run example:fetch -- jikan:producer 14
-npm run example:fetch -- jikan:magazine 1
-npm run example:fetch -- openfoodfacts:product 3017620422003
-npm run example:fetch -- openstreetmap:venue W123456
-npm run example:fetch -- wger:equipment 7
+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
@@ -403,14 +449,18 @@ 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)`
+- `transformGamesDbPlatform(sourceRecord, options?)`
 - `transformJikan(sourceRecord)`
 - `transformMusicBrainzRelease(sourceRecord, options?)`
 - `transformMusicBrainzReleaseGroup(sourceRecord, 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/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;AAkBpD,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,CAwBpB"}
+{"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"}