@zivue/zuuid 0.1.0 → 0.2.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"release.d.ts","sourceRoot":"","sources":["../../../src/providers/musicbrainz/release.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAgBpD,MAAM,MAAM,2BAA2B,GAAG;IACxC,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC,CAAC;AAEF,wBAAsB,2BAA2B,CAC/C,MAAM,EAAE,YAAY,EACpB,OAAO,GAAE,2BAAgC,GACxC,OAAO,CAAC,SAAS,CAAC,CAiCpB"}

package/dist/providers/musicbrainz/release.js

@@ -0,0 +1,50 @@
+import { MUSICBRAINZ_COVER_ART_BASE_URL, MUSICBRAINZ_PROVIDER, MUSICBRAINZ_RELEASE_CATEGORY } from "./constants.js";
+import { addDescription, addDetail, addMedia, addTag, arrayField, baseDataFromSource, finalizeData, nestedString, stringField, valueAsString } from "../common.js";
+import { addArtistCreditDetail, addMusicBrainzDescription, addMusicBrainzTags, musicBrainzId, musicBrainzPayload, requireMusicBrainzTitle } from "./helpers.js";
+export async function transformMusicBrainzRelease(source, options = {}) {
+    if (source.source.provider !== MUSICBRAINZ_PROVIDER || source.source.category !== MUSICBRAINZ_RELEASE_CATEGORY) {
+        throw new Error(`unsupported MusicBrainz source: ${source.source.provider}:${source.source.category}`);
+    }
+    const payload = musicBrainzPayload(source.payload);
+    const id = musicBrainzId(payload, source.source.externalId);
+    const title = requireMusicBrainzTitle(payload);
+    if (!id)
+        throw new Error("missing required MusicBrainz release field: id");
+    if (!title)
+        throw new Error("missing required MusicBrainz release field: title");
+    const data = await baseDataFromSource(source, MUSICBRAINZ_PROVIDER, MUSICBRAINZ_RELEASE_CATEGORY, MUSICBRAINZ_RELEASE_CATEGORY, id, title);
+    const releaseDate = stringField(payload, "date");
+    if (releaseDate && /^\d{4}-\d{2}-\d{2}$/.test(releaseDate))
+        data.primaryDate = releaseDate;
+    addDetail(data, MUSICBRAINZ_PROVIDER, "release_date", releaseDate);
+    addArtistCreditDetail(data, payload);
+    addDetail(data, MUSICBRAINZ_PROVIDER, "labels", joinedLabels(payload));
+    for (const key of ["status", "country", "barcode"])
+        addDetail(data, MUSICBRAINZ_PROVIDER, key, stringField(payload, key));
+    addDetail(data, MUSICBRAINZ_PROVIDER, "track_count", valueAsString(payload["track-count"]));
+    addDetail(data, MUSICBRAINZ_PROVIDER, "media_count", valueAsString(payload["media-count"]));
+    addMusicBrainzDescription(data, payload);
+    addMusicBrainzTags(data, payload);
+    const barcode = stringField(payload, "barcode");
+    if (barcode)
+        data.externalIds.push({ source: "barcode", category: MUSICBRAINZ_RELEASE_CATEGORY, value: barcode });
+    const releaseGroupId = nestedString(payload, ["release-group", "id"]);
+    if (releaseGroupId) {
+        data.externalIds.push({ source: MUSICBRAINZ_PROVIDER, category: "release_group", value: releaseGroupId });
+        addDetail(data, MUSICBRAINZ_PROVIDER, "release_group_id", releaseGroupId);
+    }
+    const archive = payload["cover-art-archive"];
+    const hasFront = !!(archive && typeof archive === "object" && !Array.isArray(archive) && archive.front === true);
+    const baseUrl = options.coverArtBaseUrl === undefined ? MUSICBRAINZ_COVER_ART_BASE_URL : options.coverArtBaseUrl;
+    if (hasFront && baseUrl)
+        addMedia(data, MUSICBRAINZ_PROVIDER, `${baseUrl.replace(/\/$/, "")}/${id}/front`, "cover");
+    return finalizeData(data, source);
+}
+function joinedLabels(payload) {
+    const names = arrayField(payload, "label-info").map((item) => {
+        if (!item || typeof item !== "object" || Array.isArray(item))
+            return undefined;
+        return nestedString(item, ["label", "name"]);
+    }).filter((value) => !!value);
+    return names.length ? names.join(", ") : undefined;
+}

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

@@ -0,0 +1,4 @@
+import type { ZuuidData } from "../../entity.js";
+import type { SourceRecord } from "../../source.js";
+export declare function transformMusicBrainzWork(source: SourceRecord): Promise<ZuuidData>;
+//# sourceMappingURL=work.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"work.d.ts","sourceRoot":"","sources":["../../../src/providers/musicbrainz/work.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAKpD,wBAAsB,wBAAwB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,SAAS,CAAC,CAoBvF"}

package/dist/providers/musicbrainz/work.js

@@ -0,0 +1,40 @@
+import { addDetail, addRelation, addTag, arrayField, baseDataFromSource, finalizeData, stringField } from "../common.js";
+import { MUSICBRAINZ_ARTIST_CATEGORY, MUSICBRAINZ_PROVIDER, MUSICBRAINZ_WORK_CATEGORY } from "./constants.js";
+import { addMusicBrainzAliases, addMusicBrainzDescription, addMusicBrainzTags, musicBrainzId, musicBrainzPayload, requireMusicBrainzTitle } from "./helpers.js";
+export async function transformMusicBrainzWork(source) {
+    if (source.source.provider !== MUSICBRAINZ_PROVIDER || source.source.category !== MUSICBRAINZ_WORK_CATEGORY) {
+        throw new Error(`unsupported MusicBrainz source: ${source.source.provider}:${source.source.category}`);
+    }
+    const payload = musicBrainzPayload(source.payload);
+    const id = musicBrainzId(payload, source.source.externalId);
+    const title = requireMusicBrainzTitle(payload);
+    if (!id)
+        throw new Error("missing required MusicBrainz work field: id");
+    if (!title)
+        throw new Error("missing required MusicBrainz work field: title");
+    const data = await baseDataFromSource(source, MUSICBRAINZ_PROVIDER, MUSICBRAINZ_WORK_CATEGORY, "musical_work", id, title);
+    addMusicBrainzAliases(data, payload, title);
+    addMusicBrainzDescription(data, payload);
+    addDetail(data, MUSICBRAINZ_PROVIDER, "type", stringField(payload, "type"));
+    addDetail(data, MUSICBRAINZ_PROVIDER, "iswcs", arrayField(payload, "iswcs").filter((value) => typeof value === "string"));
+    for (const iswc of arrayField(payload, "iswcs"))
+        if (typeof iswc === "string")
+            data.externalIds.push({ source: "iswc", category: MUSICBRAINZ_WORK_CATEGORY, value: iswc });
+    await addArtistRelations(data, payload);
+    addMusicBrainzTags(data, payload);
+    addTag(data, "composition");
+    return finalizeData(data, source);
+}
+async function addArtistRelations(data, payload) {
+    let index = 0;
+    for (const relation of arrayField(payload, "relations")) {
+        if (!relation || typeof relation !== "object" || Array.isArray(relation))
+            continue;
+        const targetType = stringField(relation, "target-type");
+        const artist = relation.artist;
+        if (targetType !== "artist" || !artist || typeof artist !== "object" || Array.isArray(artist))
+            continue;
+        await addRelation(data, MUSICBRAINZ_PROVIDER, MUSICBRAINZ_ARTIST_CATEGORY, stringField(artist, "id"), stringField(relation, "type") ?? "artist", stringField(artist, "name"), { order: index });
+        index += 1;
+    }
+}

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

@@ -0,0 +1,3 @@
+export declare const OPENFOODFACTS_PROVIDER = "openfoodfacts";
+export declare const OPENFOODFACTS_PRODUCT_CATEGORY = "product";
+//# sourceMappingURL=constants.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/providers/openfoodfacts/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,sBAAsB,kBAAkB,CAAC;AACtD,eAAO,MAAM,8BAA8B,YAAY,CAAC"}

package/dist/providers/openfoodfacts/constants.js

@@ -0,0 +1,2 @@
+export const OPENFOODFACTS_PROVIDER = "openfoodfacts";
+export const OPENFOODFACTS_PRODUCT_CATEGORY = "product";

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

@@ -0,0 +1,3 @@
+export * from "./constants.js";
+export * from "./product.js";
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/providers/openfoodfacts/index.js

@@ -0,0 +1,2 @@
+export * from "./constants.js";
+export * from "./product.js";

package/dist/providers/openfoodfacts/product.d.ts

@@ -0,0 +1,4 @@
+import type { ZuuidData } from "../../entity.js";
+import type { SourceRecord } from "../../source.js";
+export declare function transformOpenFoodFactsProduct(source: SourceRecord): Promise<ZuuidData>;
+//# sourceMappingURL=product.d.ts.map

package/dist/providers/openfoodfacts/product.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"product.d.ts","sourceRoot":"","sources":["../../../src/providers/openfoodfacts/product.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAIpD,wBAAsB,6BAA6B,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,SAAS,CAAC,CAmB5F"}

package/dist/providers/openfoodfacts/product.js

@@ -0,0 +1,29 @@
+import { addAlias, addDetail, addMedia, addTag, arrayField, baseDataFromSource, finalizeData, objectPayload, stringField, valueAsString } from "../common.js";
+import { OPENFOODFACTS_PRODUCT_CATEGORY, OPENFOODFACTS_PROVIDER } from "./constants.js";
+export async function transformOpenFoodFactsProduct(source) {
+    if (source.source.provider !== OPENFOODFACTS_PROVIDER || source.source.category !== OPENFOODFACTS_PRODUCT_CATEGORY) {
+        throw new Error(`unsupported OpenFoodFacts source: ${source.source.provider}:${source.source.category}`);
+    }
+    const payload = objectPayload(source.payload);
+    const id = source.source.externalId.trim() || stringField(payload, "code") || stringField(payload, "_id");
+    const title = stringField(payload, "product_name") ?? stringField(payload, "title") ?? stringField(payload, "name");
+    if (!id)
+        throw new Error("missing required OpenFoodFacts product field: code");
+    if (!title)
+        throw new Error("missing required OpenFoodFacts product field: product_name");
+    const data = await baseDataFromSource(source, OPENFOODFACTS_PROVIDER, OPENFOODFACTS_PRODUCT_CATEGORY, OPENFOODFACTS_PRODUCT_CATEGORY, id, title);
+    addAlias(data, title, "title", true, OPENFOODFACTS_PROVIDER, "en");
+    addMedia(data, OPENFOODFACTS_PROVIDER, stringField(payload, "image_front_url") ?? stringField(payload, "image_url"), "cover");
+    for (const [jsonKey, detailKey] of [["brands", "brands"], ["quantity", "quantity"], ["serving_size", "serving_size"], ["ingredients_text", "ingredients_text"], ["nutriscore_grade", "nutriscore_grade"], ["ecoscore_grade", "ecoscore_grade"], ["allergens", "allergens"]])
+        addDetail(data, OPENFOODFACTS_PROVIDER, detailKey, stringField(payload, jsonKey));
+    addDetail(data, OPENFOODFACTS_PROVIDER, "barcode", id);
+    const nutriments = payload.nutriments && typeof payload.nutriments === "object" && !Array.isArray(payload.nutriments) ? payload.nutriments : {};
+    for (const [jsonKey, detailKey] of [["energy-kcal_100g", "calories_100g"], ["fat_100g", "fat_100g"], ["proteins_100g", "protein_100g"], ["carbohydrates_100g", "carbs_100g"], ["sugars_100g", "sugars_100g"], ["fiber_100g", "fiber_100g"], ["salt_100g", "salt_100g"], ["sodium_100g", "sodium_100g"], ["energy-kj_100g", "energy_kj_100g"], ["saturated-fat_100g", "saturated_fat_100g"], ["nutriscore_score", "nutriscore_score"], ["nova-group", "nova_group"]])
+        addDetail(data, OPENFOODFACTS_PROVIDER, detailKey, valueAsString(nutriments[jsonKey]));
+    addTag(data, "food");
+    for (const key of ["categories_tags", "countries_tags"])
+        for (const value of arrayField(payload, key))
+            if (typeof value === "string")
+                addTag(data, value.split(":").at(-1));
+    return finalizeData(data, source);
+}

package/dist/providers/openlibrary/author.d.ts

@@ -0,0 +1,65 @@
+import { type SearchResponse, type ZuuidData, type ZuuidSearchResult } from "../../entity.js";
+import { type SourceRecord } from "../../source.js";
+import type { OpenLibraryProvider } from "./client.js";
+import type { OpenLibrarySearchInput, OpenLibraryTransformOptions } from "./types.js";
+export declare const OPEN_LIBRARY_AUTHOR_CATEGORY = "author";
+export type FetchOpenLibraryAuthorInput = {
+    id: string;
+    workLimit?: number;
+};
+export type OpenLibraryAuthorDescription = string | {
+    type?: string;
+    value?: string;
+};
+export type OpenLibraryAuthorPayload = {
+    key?: string;
+    name?: string;
+    alternate_names?: string[];
+    birth_date?: string;
+    death_date?: string;
+    date?: string;
+    bio?: OpenLibraryAuthorDescription;
+    wikipedia?: string;
+    links?: {
+        title?: string;
+        url?: string;
+        type?: {
+            key?: string;
+        };
+    }[];
+    photos?: number[];
+    personal_name?: string;
+    remote_ids?: Record<string, string>;
+};
+export type OpenLibraryAuthorWorkPayload = {
+    key?: string;
+    title?: string;
+    first_publish_date?: string;
+    covers?: number[];
+};
+export type OpenLibraryAuthorWorksPayload = {
+    entries?: OpenLibraryAuthorWorkPayload[];
+    size?: number;
+};
+export type OpenLibraryAuthorSourcePayload = {
+    author: OpenLibraryAuthorPayload;
+    works?: {
+        entries: OpenLibraryAuthorWorkPayload[];
+        size?: number;
+    };
+};
+export type OpenLibraryAuthorSearchDoc = {
+    key?: string;
+    name?: string;
+    alternate_names?: string[];
+    birth_date?: string;
+    top_work?: string;
+    work_count?: number;
+    top_subjects?: string[];
+    _version_?: number;
+};
+export declare function fetchOpenLibraryAuthorSourceRecord(provider: OpenLibraryProvider, input: FetchOpenLibraryAuthorInput): Promise<SourceRecord | undefined>;
+export declare function searchOpenLibraryAuthorSourceRecords(provider: OpenLibraryProvider, input: OpenLibrarySearchInput): Promise<SearchResponse<SourceRecord>>;
+export declare function searchOpenLibraryAuthors(provider: OpenLibraryProvider, input: OpenLibrarySearchInput): Promise<SearchResponse<ZuuidSearchResult>>;
+export declare function transformOpenLibraryAuthor(source: SourceRecord, options?: OpenLibraryTransformOptions): Promise<ZuuidData>;
+//# sourceMappingURL=author.d.ts.map

package/dist/providers/openlibrary/author.d.ts.map

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

package/dist/providers/openlibrary/author.js

@@ -0,0 +1,228 @@
+import { createZuuidData } from "../../entity.js";
+import { providerZuuid } from "../../identity.js";
+import { attachSourceMetadata, createSourceRecord } from "../../source.js";
+import { OPEN_LIBRARY_COVER_BASE_URL, OPEN_LIBRARY_PROVIDER } from "./constants.js";
+export const OPEN_LIBRARY_AUTHOR_CATEGORY = "author";
+export async function fetchOpenLibraryAuthorSourceRecord(provider, input) {
+    const id = normalizeOpenLibraryAuthorId(input.id);
+    const author = await provider.getJson(`/authors/${id}.json`, {});
+    if (!author) {
+        return undefined;
+    }
+    const works = await provider.getJson(`/authors/${id}/works.json`, {
+        limit: String(input.workLimit ?? 20)
+    });
+    const payload = {
+        author,
+        ...(works ? { works: { entries: works.entries ?? [], size: works.size } } : {})
+    };
+    return createSourceRecord({
+        source: { provider: OPEN_LIBRARY_PROVIDER, category: OPEN_LIBRARY_AUTHOR_CATEGORY, externalId: id },
+        payload: payload
+    });
+}
+export async function searchOpenLibraryAuthorSourceRecords(provider, input) {
+    const payload = await fetchOpenLibraryAuthorSearchResults(provider, input);
+    return {
+        results: await sourceRecordsFromSearchResults(payload.docs),
+        pagination: paginationFromOpenLibrarySearchResponse(payload, input)
+    };
+}
+export async function searchOpenLibraryAuthors(provider, input) {
+    const payload = await fetchOpenLibraryAuthorSearchResults(provider, input);
+    const results = [];
+    for (const item of payload.docs ?? []) {
+        const id = normalizeOpenLibraryAuthorIdOrUndefined(item.key);
+        const title = stringField(item.name);
+        if (!id || !title) {
+            continue;
+        }
+        const zuuid = await providerZuuid({ provider: OPEN_LIBRARY_PROVIDER, category: OPEN_LIBRARY_AUTHOR_CATEGORY, externalId: id });
+        results.push({
+            id: zuuid,
+            zuuid,
+            category: OPEN_LIBRARY_AUTHOR_CATEGORY,
+            title,
+            date: stringField(item.birth_date) ?? null,
+            cover: null,
+            rating: null,
+            weight: typeof item.work_count === "number" ? item.work_count : null,
+            relationType: null,
+            attribute: stringField(item.top_work) ?? null,
+            order: null,
+            source: { source: OPEN_LIBRARY_PROVIDER, category: OPEN_LIBRARY_AUTHOR_CATEGORY, value: id }
+        });
+    }
+    return {
+        results,
+        pagination: paginationFromOpenLibrarySearchResponse(payload, input)
+    };
+}
+export async function transformOpenLibraryAuthor(source, options = {}) {
+    if (source.source.provider !== OPEN_LIBRARY_PROVIDER || source.source.category !== OPEN_LIBRARY_AUTHOR_CATEGORY) {
+        throw new Error(`unsupported Open Library source: ${source.source.provider}:${source.source.category}`);
+    }
+    const payload = openLibraryAuthorSourcePayload(source.payload);
+    const author = payload.author;
+    const id = normalizeOpenLibraryAuthorId(source.source.externalId || author.key || "");
+    const name = stringField(author.name);
+    if (!name) {
+        throw new Error("missing required Open Library author field: name");
+    }
+    const zuuid = await providerZuuid({ provider: OPEN_LIBRARY_PROVIDER, category: OPEN_LIBRARY_AUTHOR_CATEGORY, externalId: id });
+    const data = createZuuidData({ zuuid, category: OPEN_LIBRARY_AUTHOR_CATEGORY, primaryTitle: name });
+    const birthDate = stringField(author.birth_date ?? author.date);
+    if (birthDate) {
+        data.primaryDate = birthDate;
+        data.details.push({ key: "birth_date", value: birthDate, source: OPEN_LIBRARY_PROVIDER });
+    }
+    addDetail(data, "death_date", author.death_date);
+    addDetail(data, "personal_name", author.personal_name);
+    addDetail(data, "wikipedia", author.wikipedia);
+    addStructuredDetail(data, "links", author.links);
+    addStructuredDetail(data, "remote_ids", author.remote_ids);
+    if (typeof payload.works?.size === "number") {
+        data.details.push({ key: "work_count", value: payload.works.size, source: OPEN_LIBRARY_PROVIDER });
+    }
+    const bio = descriptionValue(author.bio);
+    if (bio) {
+        data.descriptions.push({ value: bio, source: OPEN_LIBRARY_PROVIDER });
+    }
+    for (const alias of author.alternate_names ?? []) {
+        const value = stringField(alias);
+        if (value && value !== name && !data.aliases.some((item) => item.value === value)) {
+            data.aliases.push({ value, aliasType: "alternate_name", isPrimary: false, source: OPEN_LIBRARY_PROVIDER });
+        }
+    }
+    addPhoto(data, author.photos?.find((photo) => typeof photo === "number"), options.coverBaseUrl ?? OPEN_LIBRARY_COVER_BASE_URL, true);
+    for (const [index, work] of (payload.works?.entries ?? []).entries()) {
+        await addWorkRelation(data, work, index, options);
+    }
+    return attachSourceMetadata(data, source);
+}
+async function fetchOpenLibraryAuthorSearchResults(provider, input) {
+    const payload = await provider.getJson("/search/authors.json", {
+        q: searchQuery(input.query),
+        page: String(input.page ?? 1),
+        limit: String(input.limit ?? 20)
+    });
+    return payload ?? {};
+}
+async function sourceRecordsFromSearchResults(results) {
+    const records = [];
+    for (const result of results ?? []) {
+        const id = normalizeOpenLibraryAuthorIdOrUndefined(result.key);
+        if (!id) {
+            continue;
+        }
+        records.push(await createSourceRecord({
+            source: { provider: OPEN_LIBRARY_PROVIDER, category: OPEN_LIBRARY_AUTHOR_CATEGORY, externalId: id },
+            payload: result
+        }));
+    }
+    return records;
+}
+async function addWorkRelation(data, work, index, options) {
+    const id = normalizeOpenLibraryWorkIdOrUndefined(work.key);
+    const title = stringField(work.title);
+    if (!id || !title) {
+        return;
+    }
+    const zuuid = await providerZuuid({ provider: OPEN_LIBRARY_PROVIDER, category: "book", externalId: id });
+    data.relations.push({
+        id: zuuid,
+        zuuid,
+        category: "book",
+        title,
+        date: stringField(work.first_publish_date) ?? null,
+        cover: coverUrl(work.covers?.find((cover) => typeof cover === "number"), options.coverBaseUrl ?? OPEN_LIBRARY_COVER_BASE_URL),
+        rating: null,
+        weight: null,
+        relationType: "author_of",
+        direction: "outgoing",
+        attribute: null,
+        order: index,
+        source: OPEN_LIBRARY_PROVIDER,
+        externalId: id
+    });
+}
+function addPhoto(data, photoId, baseUrl, isPrimary) {
+    const url = coverUrl(photoId, baseUrl);
+    if (!url) {
+        return;
+    }
+    data.cover = data.cover ?? url;
+    data.media.push({
+        url,
+        mediaType: "image",
+        mediaCategory: "profile",
+        isPrimary,
+        source: OPEN_LIBRARY_PROVIDER
+    });
+}
+function addDetail(data, key, value) {
+    const clean = stringField(value);
+    if (clean) {
+        data.details.push({ key, value: clean, source: OPEN_LIBRARY_PROVIDER });
+    }
+}
+function addStructuredDetail(data, key, value) {
+    if (value === undefined || value === null || (Array.isArray(value) && value.length === 0)) {
+        return;
+    }
+    data.details.push({ key, value, source: OPEN_LIBRARY_PROVIDER });
+}
+function paginationFromOpenLibrarySearchResponse(payload, input) {
+    const totalResults = payload.numFound ?? payload.num_found ?? 0;
+    const limit = input.limit ?? 20;
+    return {
+        page: input.page ?? 1,
+        totalPages: limit > 0 ? Math.ceil(totalResults / limit) : 0,
+        totalResults
+    };
+}
+function openLibraryAuthorSourcePayload(payload) {
+    const value = payload;
+    if ("author" in value && value.author) {
+        return value;
+    }
+    return { author: value };
+}
+function normalizeOpenLibraryAuthorId(value) {
+    const normalized = stringField(value)?.replace(/^\/authors\//, "").replace(/\.json$/, "");
+    if (!normalized) {
+        throw new Error("Open Library author id must not be empty");
+    }
+    if (!/^OL\d+A$/i.test(normalized)) {
+        throw new Error(`Open Library author id must look like OL23919A: ${value}`);
+    }
+    return normalized.toUpperCase();
+}
+function normalizeOpenLibraryAuthorIdOrUndefined(value) {
+    const normalized = stringField(value)?.replace(/^\/authors\//, "");
+    return normalized && /^OL\d+A$/i.test(normalized) ? normalized.toUpperCase() : undefined;
+}
+function normalizeOpenLibraryWorkIdOrUndefined(value) {
+    const normalized = stringField(value)?.replace(/^\/works\//, "");
+    return normalized && /^OL\d+W$/i.test(normalized) ? normalized.toUpperCase() : undefined;
+}
+function coverUrl(coverId, baseUrl) {
+    if (typeof coverId !== "number" || !baseUrl) {
+        return null;
+    }
+    return `${baseUrl.replace(/\/$/, "")}/${coverId}-L.jpg`;
+}
+function descriptionValue(value) {
+    return typeof value === "string" ? stringField(value) : stringField(value?.value);
+}
+function searchQuery(value) {
+    const query = stringField(value);
+    if (!query) {
+        throw new Error("Open Library author search query must not be empty");
+    }
+    return query;
+}
+function stringField(value) {
+    const normalized = value?.trim();
+    return normalized ? normalized : undefined;
+}

package/dist/providers/openlibrary/book.d.ts

@@ -0,0 +1,138 @@
+import { type SearchResponse, type ZuuidData, type ZuuidSearchResult } from "../../entity.js";
+import { type SourceRecord } from "../../source.js";
+import type { JsonValue } from "../../types.js";
+import type { OpenLibraryProvider } from "./client.js";
+import type { OpenLibrarySearchInput, OpenLibraryTransformOptions } from "./types.js";
+export declare const OPEN_LIBRARY_BOOK_CATEGORY = "book";
+export type FetchOpenLibraryBookInput = {
+    id: string;
+    editionLimit?: number;
+};
+export type OpenLibraryDescription = string | {
+    type?: string;
+    value?: string;
+};
+export type OpenLibraryAuthorRef = {
+    author?: {
+        key?: string;
+    };
+    type?: {
+        key?: string;
+    };
+};
+export type OpenLibraryWorkPayload = {
+    key?: string;
+    title?: string;
+    description?: OpenLibraryDescription;
+    covers?: number[];
+    subjects?: string[];
+    subject_places?: string[];
+    subject_people?: string[];
+    subject_times?: string[];
+    first_publish_date?: string;
+    authors?: OpenLibraryAuthorRef[];
+    links?: {
+        title?: string;
+        url?: string;
+        type?: {
+            key?: string;
+        };
+    }[];
+    excerpts?: {
+        excerpt?: string;
+        pages?: string;
+        comment?: string;
+    }[];
+    series?: JsonValue[];
+    cover_edition?: {
+        key?: string;
+    };
+    created?: JsonValue;
+    last_modified?: JsonValue;
+    latest_revision?: number;
+    revision?: number;
+};
+export type OpenLibraryBookAuthorPayload = {
+    key?: string;
+    name?: string;
+    birth_date?: string;
+    death_date?: string;
+    bio?: OpenLibraryDescription;
+    photos?: number[];
+};
+export type OpenLibraryEditionPayload = {
+    key?: string;
+    title?: string;
+    subtitle?: string;
+    full_title?: string;
+    edition_name?: string;
+    description?: OpenLibraryDescription;
+    notes?: OpenLibraryDescription;
+    publish_date?: string;
+    publishers?: string[];
+    number_of_pages?: number;
+    physical_format?: string;
+    isbn_10?: string[];
+    isbn_13?: string[];
+    languages?: {
+        key?: string;
+    }[];
+    translated_from?: {
+        key?: string;
+    }[];
+    translation_of?: string;
+    covers?: number[];
+    contributors?: {
+        role?: string;
+        name?: string;
+    }[];
+    identifiers?: Record<string, JsonValue>;
+    classifications?: Record<string, JsonValue>;
+    local_id?: string[];
+    source_records?: string[];
+};
+export type OpenLibraryEditionsPayload = {
+    entries?: OpenLibraryEditionPayload[];
+    size?: number;
+};
+export type OpenLibraryBookPayload = {
+    work: OpenLibraryWorkPayload;
+    search?: OpenLibrarySearchDoc;
+    editions?: {
+        entries: OpenLibraryEditionPayload[];
+        size?: number;
+    };
+    authors?: OpenLibraryBookAuthorPayload[];
+    ratings?: OpenLibraryRatingsPayload;
+};
+export type OpenLibraryRatingsPayload = {
+    summary?: {
+        average?: number;
+        count?: number;
+        sortable?: number;
+    };
+    counts?: Record<string, number>;
+};
+export type OpenLibrarySearchDoc = {
+    key?: string;
+    title?: string;
+    author_name?: string[];
+    author_key?: string[];
+    first_publish_year?: number;
+    first_publish_date?: string;
+    cover_i?: number;
+    ratings_average?: number;
+    edition_count?: number;
+    language?: string[];
+    isbn?: string[];
+    ia?: string[];
+    subject?: string[];
+    ddc?: string[];
+    lcc?: string[];
+    lccn?: string[];
+};
+export declare function fetchOpenLibraryBookSourceRecord(provider: OpenLibraryProvider, input: FetchOpenLibraryBookInput): Promise<SourceRecord | undefined>;
+export declare function searchOpenLibraryBookSourceRecords(provider: OpenLibraryProvider, input: OpenLibrarySearchInput): Promise<SearchResponse<SourceRecord>>;
+export declare function searchOpenLibraryBooks(provider: OpenLibraryProvider, input: OpenLibrarySearchInput, options?: OpenLibraryTransformOptions): Promise<SearchResponse<ZuuidSearchResult>>;
+export declare function transformOpenLibraryBook(source: SourceRecord, options?: OpenLibraryTransformOptions): Promise<ZuuidData>;
+//# sourceMappingURL=book.d.ts.map

package/dist/providers/openlibrary/book.d.ts.map

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