@zivue/zuuid 0.2.2 → 0.2.5

package/dist/providers/comicvine/client.js

@@ -0,0 +1,190 @@
+import { providerZuuid } from "../../identity.js";
+import { createSourceRecord } from "../../source.js";
+import { datePrefix, nestedString, stringField, valueAsString } from "../common.js";
+import { COMICVINE_API_BASE, COMICVINE_CHARACTER_CATEGORY, COMICVINE_DEFAULT_USER_AGENT, COMICVINE_ISSUE_CATEGORY, COMICVINE_PERSON_CATEGORY, COMICVINE_PROVIDER, COMICVINE_PUBLISHER_CATEGORY, COMICVINE_STORY_ARC_CATEGORY, COMICVINE_VOLUME_CATEGORY } from "./constants.js";
+import { transformComicVine } from "./transform.js";
+const CATEGORY_CONFIG = {
+    [COMICVINE_VOLUME_CATEGORY]: { detailPath: "volume", searchResource: "volume", idPrefix: "4050", publicCategory: "comic" },
+    [COMICVINE_ISSUE_CATEGORY]: { detailPath: "issue", searchResource: "issue", idPrefix: "4000", publicCategory: "comic" },
+    [COMICVINE_STORY_ARC_CATEGORY]: { detailPath: "story_arc", searchResource: "story_arc", idPrefix: "4045", publicCategory: "comic" },
+    [COMICVINE_CHARACTER_CATEGORY]: { detailPath: "character", searchResource: "character", idPrefix: "4005", publicCategory: "person" },
+    [COMICVINE_PERSON_CATEGORY]: { detailPath: "person", searchResource: "person", idPrefix: "4040", publicCategory: "person" },
+    [COMICVINE_PUBLISHER_CATEGORY]: { detailPath: "publisher", searchResource: "publisher", idPrefix: "4010", publicCategory: "organization" }
+};
+export class ComicVineProvider {
+    apiBase;
+    userAgent;
+    apiKey;
+    fetchImpl;
+    constructor(options) {
+        this.apiKey = options.apiKey.trim();
+        if (!this.apiKey)
+            throw new Error("ComicVine API key must not be empty");
+        this.apiBase = options.apiBase ?? COMICVINE_API_BASE;
+        this.fetchImpl = options.fetch ?? globalThis.fetch.bind(globalThis);
+        this.userAgent = options.userAgent ?? COMICVINE_DEFAULT_USER_AGENT;
+    }
+    async getJson(path, params) {
+        const url = new URL(`${this.apiBase.replace(/\/$/, "")}/${path.replace(/^\//, "")}`);
+        url.searchParams.set("api_key", this.apiKey);
+        url.searchParams.set("format", "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(`ComicVine API returned ${response.status}: ${body}`);
+        }
+        const payload = await response.json();
+        if (payload.status_code === 101)
+            return undefined;
+        if (payload.status_code !== undefined && payload.status_code !== 1) {
+            throw new Error(`ComicVine API returned status ${payload.status_code}: ${payload.error ?? "unknown error"}`);
+        }
+        return payload.results;
+    }
+    async getEnvelope(path, params) {
+        const url = new URL(`${this.apiBase.replace(/\/$/, "")}/${path.replace(/^\//, "")}`);
+        url.searchParams.set("api_key", this.apiKey);
+        url.searchParams.set("format", "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.ok) {
+            const body = await response.text().catch(() => "");
+            throw new Error(`ComicVine API returned ${response.status}: ${body}`);
+        }
+        const payload = await response.json();
+        if (payload.status_code !== undefined && payload.status_code !== 1) {
+            throw new Error(`ComicVine API returned status ${payload.status_code}: ${payload.error ?? "unknown error"}`);
+        }
+        return payload;
+    }
+    async fetchVolumeSourceRecord(input) { return fetchComicVineSourceRecord(this, COMICVINE_VOLUME_CATEGORY, input); }
+    async fetchVolume(input) { const source = await this.fetchVolumeSourceRecord(input); return source ? transformComicVine(source) : undefined; }
+    async searchVolumeSourceRecords(input) { return searchComicVineSourceRecords(this, COMICVINE_VOLUME_CATEGORY, input); }
+    async searchVolumes(input) { return searchComicVine(this, COMICVINE_VOLUME_CATEGORY, input); }
+    async fetchIssueSourceRecord(input) { return fetchComicVineSourceRecord(this, COMICVINE_ISSUE_CATEGORY, input); }
+    async fetchIssue(input) { const source = await this.fetchIssueSourceRecord(input); return source ? transformComicVine(source) : undefined; }
+    async searchIssueSourceRecords(input) { return searchComicVineSourceRecords(this, COMICVINE_ISSUE_CATEGORY, input); }
+    async searchIssues(input) { return searchComicVine(this, COMICVINE_ISSUE_CATEGORY, input); }
+    async fetchStoryArcSourceRecord(input) { return fetchComicVineSourceRecord(this, COMICVINE_STORY_ARC_CATEGORY, input); }
+    async fetchStoryArc(input) { const source = await this.fetchStoryArcSourceRecord(input); return source ? transformComicVine(source) : undefined; }
+    async searchStoryArcSourceRecords(input) { return searchComicVineSourceRecords(this, COMICVINE_STORY_ARC_CATEGORY, input); }
+    async searchStoryArcs(input) { return searchComicVine(this, COMICVINE_STORY_ARC_CATEGORY, input); }
+    async fetchCharacterSourceRecord(input) { return fetchComicVineSourceRecord(this, COMICVINE_CHARACTER_CATEGORY, input); }
+    async fetchCharacter(input) { const source = await this.fetchCharacterSourceRecord(input); return source ? transformComicVine(source) : undefined; }
+    async searchCharacterSourceRecords(input) { return searchComicVineSourceRecords(this, COMICVINE_CHARACTER_CATEGORY, input); }
+    async searchCharacters(input) { return searchComicVine(this, COMICVINE_CHARACTER_CATEGORY, input); }
+    async fetchPersonSourceRecord(input) { return fetchComicVineSourceRecord(this, COMICVINE_PERSON_CATEGORY, input); }
+    async fetchPerson(input) { const source = await this.fetchPersonSourceRecord(input); return source ? transformComicVine(source) : undefined; }
+    async searchPersonSourceRecords(input) { return searchComicVineSourceRecords(this, COMICVINE_PERSON_CATEGORY, input); }
+    async searchPeople(input) { return searchComicVine(this, COMICVINE_PERSON_CATEGORY, input); }
+    async fetchPublisherSourceRecord(input) { return fetchComicVineSourceRecord(this, COMICVINE_PUBLISHER_CATEGORY, input); }
+    async fetchPublisher(input) { const source = await this.fetchPublisherSourceRecord(input); return source ? transformComicVine(source) : undefined; }
+    async searchPublisherSourceRecords(input) { return searchComicVineSourceRecords(this, COMICVINE_PUBLISHER_CATEGORY, input); }
+    async searchPublishers(input) { return searchComicVine(this, COMICVINE_PUBLISHER_CATEGORY, input); }
+}
+export async function fetchComicVineSourceRecord(provider, category, input) {
+    const comicCategory = requireCategory(category);
+    const id = comicVineId(input.id);
+    const config = CATEGORY_CONFIG[comicCategory];
+    const payload = await provider.getJson(`/${config.detailPath}/${config.idPrefix}-${id}/`, {});
+    if (!payload)
+        return undefined;
+    return createSourceRecord({ source: { provider: COMICVINE_PROVIDER, category, externalId: id }, payload });
+}
+export async function searchComicVineSourceRecords(provider, category, input) {
+    const payload = await searchPayload(provider, category, input);
+    const comicCategory = requireCategory(category);
+    return {
+        results: await Promise.all(searchItems(payload).map((item) => createSourceRecord({ source: { provider: COMICVINE_PROVIDER, category, externalId: resultId(item, comicCategory) ?? "" }, payload: item }))),
+        pagination: pagination(payload)
+    };
+}
+export async function searchComicVine(provider, category, input) {
+    const payload = await searchPayload(provider, category, input);
+    const comicCategory = requireCategory(category);
+    const results = [];
+    for (const item of searchItems(payload)) {
+        const externalId = resultId(item, comicCategory);
+        const title = stringField(item, "name") ?? stringField(item, "title");
+        if (!externalId || !title)
+            continue;
+        const zuuid = await providerZuuid({ provider: COMICVINE_PROVIDER, category, externalId });
+        results.push({
+            id: zuuid,
+            zuuid,
+            category: CATEGORY_CONFIG[comicCategory].publicCategory,
+            title,
+            date: dateFor(item),
+            cover: nestedString(item, ["image", "super_url"]) ?? nestedString(item, ["image", "original_url"]) ?? nestedString(item, ["image", "medium_url"]) ?? null,
+            rating: null,
+            weight: numberValue(item, "score"),
+            relationType: null,
+            attribute: attributeFor(item, comicCategory),
+            order: null,
+            source: { source: COMICVINE_PROVIDER, category, value: externalId }
+        });
+    }
+    return { results, pagination: pagination(payload) };
+}
+async function searchPayload(provider, category, input) {
+    const comicCategory = requireCategory(category);
+    const query = input.query.trim();
+    if (!query)
+        throw new Error("ComicVine search query must not be empty");
+    return provider.getEnvelope("/search/", {
+        query,
+        resources: CATEGORY_CONFIG[comicCategory].searchResource,
+        limit: String(input.limit ?? 25),
+        offset: String(input.offset ?? 0),
+        ...(input.fieldList?.length ? { field_list: input.fieldList.join(",") } : {})
+    });
+}
+function searchItems(payload) {
+    return Array.isArray(payload.results) ? payload.results.filter(isObject) : [];
+}
+function pagination(payload) {
+    const total = payload.number_of_total_results ?? searchItems(payload).length;
+    const offset = payload.offset ?? 0;
+    const limit = payload.limit ?? payload.number_of_page_results ?? searchItems(payload).length;
+    return { page: limit > 0 ? Math.floor(offset / limit) + 1 : 1, totalPages: limit > 0 ? Math.ceil(total / limit) : 0, totalResults: total };
+}
+function requireCategory(category) {
+    if (category in CATEGORY_CONFIG)
+        return category;
+    throw new Error(`unsupported ComicVine category: ${category}`);
+}
+function comicVineId(value) {
+    const id = String(value).trim();
+    const normalized = id.includes("-") ? id.split("-").pop() ?? "" : id;
+    if (!/^\d+$/.test(normalized))
+        throw new Error(`ComicVine id must be numeric: ${value}`);
+    return normalized;
+}
+function resultId(item, category) {
+    const raw = valueAsString(item.id);
+    if (!raw)
+        return undefined;
+    return raw.startsWith(`${CATEGORY_CONFIG[category].idPrefix}-`) ? raw.slice(CATEGORY_CONFIG[category].idPrefix.length + 1) : raw;
+}
+function dateFor(item) {
+    return datePrefix(stringField(item, "cover_date")) ?? datePrefix(stringField(item, "store_date")) ?? stringField(item, "start_year") ?? null;
+}
+function attributeFor(item, category) {
+    if (category === COMICVINE_ISSUE_CATEGORY)
+        return stringField(item, "issue_number") ?? null;
+    if (category === COMICVINE_PERSON_CATEGORY || category === COMICVINE_CHARACTER_CATEGORY)
+        return stringField(item, "real_name") ?? null;
+    return stringField(item, "deck") ?? null;
+}
+function numberValue(item, key) {
+    const value = item[key];
+    return typeof value === "number" && Number.isFinite(value) ? value : null;
+}
+function isObject(value) {
+    return !!value && typeof value === "object" && !Array.isArray(value);
+}

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

@@ -5,4 +5,6 @@ export declare const COMICVINE_STORY_ARC_CATEGORY = "story_arc";
 export declare const COMICVINE_CHARACTER_CATEGORY = "character";
 export declare const COMICVINE_PERSON_CATEGORY = "person";
 export declare const COMICVINE_PUBLISHER_CATEGORY = "publisher";
+export declare const COMICVINE_API_BASE = "https://comicvine.gamespot.com/api";
+export declare const COMICVINE_DEFAULT_USER_AGENT = "@zivue/zuuid ComicVine client (+https://github.com/zivue/zuuid)";
 //# sourceMappingURL=constants.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/providers/comicvine/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,kBAAkB,cAAc,CAAC;AAC9C,eAAO,MAAM,yBAAyB,WAAW,CAAC;AAClD,eAAO,MAAM,wBAAwB,UAAU,CAAC;AAChD,eAAO,MAAM,4BAA4B,cAAc,CAAC;AACxD,eAAO,MAAM,4BAA4B,cAAc,CAAC;AACxD,eAAO,MAAM,yBAAyB,WAAW,CAAC;AAClD,eAAO,MAAM,4BAA4B,cAAc,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/providers/comicvine/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,kBAAkB,cAAc,CAAC;AAC9C,eAAO,MAAM,yBAAyB,WAAW,CAAC;AAClD,eAAO,MAAM,wBAAwB,UAAU,CAAC;AAChD,eAAO,MAAM,4BAA4B,cAAc,CAAC;AACxD,eAAO,MAAM,4BAA4B,cAAc,CAAC;AACxD,eAAO,MAAM,yBAAyB,WAAW,CAAC;AAClD,eAAO,MAAM,4BAA4B,cAAc,CAAC;AACxD,eAAO,MAAM,kBAAkB,uCAAuC,CAAC;AACvE,eAAO,MAAM,4BAA4B,oEAAoE,CAAC"}

package/dist/providers/comicvine/constants.js

@@ -5,3 +5,5 @@ export const COMICVINE_STORY_ARC_CATEGORY = "story_arc";
 export const COMICVINE_CHARACTER_CATEGORY = "character";
 export const COMICVINE_PERSON_CATEGORY = "person";
 export const COMICVINE_PUBLISHER_CATEGORY = "publisher";
+export const COMICVINE_API_BASE = "https://comicvine.gamespot.com/api";
+export const COMICVINE_DEFAULT_USER_AGENT = "@zivue/zuuid ComicVine client (+https://github.com/zivue/zuuid)";

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

@@ -1,3 +1,5 @@
+export * from "./types.js";
+export * from "./client.js";
 export * from "./character.js";
 export * from "./constants.js";
 export * from "./issue.js";

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

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

package/dist/providers/comicvine/index.js

@@ -1,3 +1,5 @@
+export * from "./types.js";
+export * from "./client.js";
 export * from "./character.js";
 export * from "./constants.js";
 export * from "./issue.js";

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

@@ -0,0 +1,26 @@
+export type ComicVineFetchLike = (input: string | URL, init?: RequestInit) => Promise<Response>;
+export type ComicVineProviderOptions = {
+    apiKey: string;
+    apiBase?: string;
+    fetch?: ComicVineFetchLike;
+    userAgent?: string;
+};
+export type FetchComicVineInput = {
+    id: string | number;
+};
+export type ComicVineSearchInput = {
+    query: string;
+    limit?: number;
+    offset?: number;
+    fieldList?: string[];
+};
+export type ComicVineApiResponse<T> = {
+    error?: string;
+    limit?: number;
+    offset?: number;
+    number_of_page_results?: number;
+    number_of_total_results?: number;
+    status_code?: number;
+    results?: T;
+};
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/providers/comicvine/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,kBAAkB,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;AAEhG,MAAM,MAAM,wBAAwB,GAAG;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,kBAAkB,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,oBAAoB,CAAC,CAAC,IAAI;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,CAAC,CAAC;CACb,CAAC"}

package/dist/providers/comicvine/types.js

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

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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"}