@zivue/zuuid 0.1.0 → 0.2.1

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

package/dist/providers/openlibrary/book.js

@@ -0,0 +1,536 @@
+import { createZuuidData } from "../../entity.js";
+import { providerZuuid } from "../../identity.js";
+import { attachSourceMetadata, createSourceRecord } from "../../source.js";
+import { normalizeRating } from "../common.js";
+import { OPEN_LIBRARY_COVER_BASE_URL, OPEN_LIBRARY_PROVIDER } from "./constants.js";
+export const OPEN_LIBRARY_BOOK_CATEGORY = "book";
+export async function fetchOpenLibraryBookSourceRecord(provider, input) {
+    const id = normalizeOpenLibraryBookId(input.id);
+    const work = await provider.getJson(`/works/${id}.json`, {});
+    if (!work) {
+        return undefined;
+    }
+    const search = await fetchOpenLibraryBookSearchDoc(provider, id, work);
+    const editions = await provider.getJson(`/works/${id}/editions.json`, {
+        limit: String(input.editionLimit ?? 50)
+    });
+    const ratings = await provider.getJson(`/works/${id}/ratings.json`, {});
+    const authors = await fetchOpenLibraryAuthors(provider, work);
+    const payload = {
+        work,
+        ...(search ? { search } : {}),
+        ...(editions ? { editions: { entries: editions.entries ?? [], size: editions.size } } : {}),
+        ...(authors.length ? { authors } : {}),
+        ...(ratings ? { ratings } : {})
+    };
+    return createSourceRecord({
+        source: { provider: OPEN_LIBRARY_PROVIDER, category: OPEN_LIBRARY_BOOK_CATEGORY, externalId: id },
+        payload: payload
+    });
+}
+export async function searchOpenLibraryBookSourceRecords(provider, input) {
+    const payload = await fetchOpenLibraryBookSearchResults(provider, input);
+    return {
+        results: await sourceRecordsFromSearchResults(payload.docs),
+        pagination: paginationFromOpenLibrarySearchResponse(payload, input)
+    };
+}
+export async function searchOpenLibraryBooks(provider, input, options = {}) {
+    const payload = await fetchOpenLibraryBookSearchResults(provider, input);
+    const results = [];
+    for (const item of payload.docs ?? []) {
+        const id = openLibraryWorkIdFromKey(item.key);
+        const title = stringField(item.title);
+        if (!id || !title) {
+            continue;
+        }
+        const zuuid = await providerZuuid({ provider: OPEN_LIBRARY_PROVIDER, category: OPEN_LIBRARY_BOOK_CATEGORY, externalId: id });
+        const rating = typeof item.ratings_average === "number" ? item.ratings_average : null;
+        results.push({
+            id: zuuid,
+            zuuid,
+            category: OPEN_LIBRARY_BOOK_CATEGORY,
+            title,
+            date: item.first_publish_year === undefined ? stringField(item.first_publish_date) ?? null : String(item.first_publish_year),
+            cover: coverUrl(item.cover_i, options.coverBaseUrl ?? OPEN_LIBRARY_COVER_BASE_URL),
+            rating,
+            weight: typeof item.edition_count === "number" ? item.edition_count : rating,
+            relationType: null,
+            attribute: item.author_name?.filter(Boolean).join(", ") || null,
+            order: null,
+            source: { source: OPEN_LIBRARY_PROVIDER, category: OPEN_LIBRARY_BOOK_CATEGORY, value: id }
+        });
+    }
+    return {
+        results,
+        pagination: paginationFromOpenLibrarySearchResponse(payload, input)
+    };
+}
+export async function transformOpenLibraryBook(source, options = {}) {
+    if (source.source.provider !== OPEN_LIBRARY_PROVIDER || source.source.category !== OPEN_LIBRARY_BOOK_CATEGORY) {
+        throw new Error(`unsupported Open Library source: ${source.source.provider}:${source.source.category}`);
+    }
+    const payload = openLibraryBookPayload(source.payload);
+    const work = payload.work;
+    const id = normalizeOpenLibraryBookId(source.source.externalId || work.key || "");
+    const title = stringField(work.title);
+    if (!title) {
+        throw new Error("missing required Open Library book field: title");
+    }
+    const zuuid = await providerZuuid({ provider: OPEN_LIBRARY_PROVIDER, category: OPEN_LIBRARY_BOOK_CATEGORY, externalId: id });
+    const data = createZuuidData({ zuuid, category: OPEN_LIBRARY_BOOK_CATEGORY, primaryTitle: title });
+    const preferredEdition = preferredOpenLibraryEdition(payload);
+    const rating = numberField(payload.ratings?.summary?.average ?? payload.ratings?.summary?.sortable ?? payload.search?.ratings_average);
+    if (rating !== undefined) {
+        data.rating = normalizeRating(rating, 0, 5);
+        data.details.push({ key: "rating_average", value: rating, source: OPEN_LIBRARY_PROVIDER });
+    }
+    const ratingCount = numberField(payload.ratings?.summary?.count);
+    if (ratingCount !== undefined) {
+        data.details.push({ key: "rating_count", value: ratingCount, source: OPEN_LIBRARY_PROVIDER });
+    }
+    const firstPublishYear = numberField(payload.search?.first_publish_year);
+    const firstPublishDate = stringField(work.first_publish_date) ?? stringField(payload.search?.first_publish_date);
+    if (firstPublishYear !== undefined) {
+        data.primaryDate = String(firstPublishYear);
+        data.details.push({ key: "first_publish_year", value: firstPublishYear, source: OPEN_LIBRARY_PROVIDER });
+        if (firstPublishDate && firstPublishDate !== String(firstPublishYear)) {
+            data.details.push({ key: "work_first_publish_date", value: firstPublishDate, source: OPEN_LIBRARY_PROVIDER });
+        }
+    }
+    else if (firstPublishDate) {
+        data.primaryDate = firstPublishDate;
+        data.details.push({ key: "first_publish_date", value: firstPublishDate, source: OPEN_LIBRARY_PROVIDER });
+    }
+    const description = descriptionValue(work.description);
+    if (description) {
+        data.descriptions.push({ value: description, source: OPEN_LIBRARY_PROVIDER });
+    }
+    for (const edition of payload.editions?.entries ?? []) {
+        const editionDescription = descriptionValue(edition.description);
+        if (editionDescription && !data.descriptions.some((item) => item.value === editionDescription)) {
+            data.descriptions.push({ value: editionDescription, source: OPEN_LIBRARY_PROVIDER });
+        }
+    }
+    const primaryCover = work.covers?.find((cover) => typeof cover === "number") ??
+        preferredEdition?.covers?.find((cover) => typeof cover === "number") ??
+        payload.search?.cover_i;
+    const primaryCoverUrl = coverUrl(primaryCover, options.coverBaseUrl ?? OPEN_LIBRARY_COVER_BASE_URL);
+    if (primaryCoverUrl) {
+        data.cover = primaryCoverUrl;
+        data.media.push({
+            url: primaryCoverUrl,
+            mediaType: "image",
+            mediaCategory: "cover",
+            isPrimary: true,
+            source: OPEN_LIBRARY_PROVIDER
+        });
+    }
+    addArrayDetail(data, "subjects", work.subjects);
+    addArrayDetail(data, "subject_places", work.subject_places);
+    addArrayDetail(data, "subject_people", work.subject_people);
+    addArrayDetail(data, "subject_times", work.subject_times);
+    addStructuredDetail(data, "links", work.links);
+    addStructuredDetail(data, "excerpts", work.excerpts);
+    addStructuredDetail(data, "series", work.series);
+    addStructuredDetail(data, "cover_edition", work.cover_edition);
+    addOpenLibraryBookAggregateDetails(data, payload, preferredEdition);
+    if (typeof payload.editions?.size === "number") {
+        data.details.push({ key: "edition_count", value: payload.editions.size, source: OPEN_LIBRARY_PROVIDER });
+    }
+    else if (typeof payload.search?.edition_count === "number") {
+        data.details.push({ key: "edition_count", value: payload.search.edition_count, source: OPEN_LIBRARY_PROVIDER });
+    }
+    for (const subject of work.subjects ?? []) {
+        addTag(data, subject);
+    }
+    await addAuthorRelations(data, payload);
+    return attachSourceMetadata(data, source);
+}
+async function fetchOpenLibraryBookSearchDoc(provider, id, work) {
+    const byId = await fetchOpenLibraryBookSearchDocByQuery(provider, id, id, 5);
+    if (byId) {
+        return byId;
+    }
+    const title = stringField(work.title);
+    return title ? fetchOpenLibraryBookSearchDocByQuery(provider, id, title, 20) : undefined;
+}
+async function fetchOpenLibraryBookSearchDocByQuery(provider, id, query, limit) {
+    const payload = await provider.getJson("/search.json", {
+        q: query,
+        limit: String(limit),
+        fields: openLibraryBookSearchFields().join(",")
+    });
+    return payload?.docs?.find((doc) => openLibraryWorkIdFromKey(doc.key) === id);
+}
+async function fetchOpenLibraryAuthors(provider, work) {
+    const authors = [];
+    for (const ref of work.authors ?? []) {
+        const id = openLibraryAuthorIdFromKey(ref.author?.key);
+        if (!id) {
+            continue;
+        }
+        const author = await provider.getJson(`/authors/${id}.json`, {});
+        if (author) {
+            authors.push(author);
+        }
+    }
+    return authors;
+}
+async function fetchOpenLibraryBookSearchResults(provider, input) {
+    const query = searchQuery(input.query);
+    const fields = input.fields ?? openLibraryBookSearchFields();
+    const payload = await provider.getJson("/search.json", {
+        q: query,
+        page: String(input.page ?? 1),
+        limit: String(input.limit ?? 20),
+        fields: fields.join(","),
+        ...(input.language ? { language: input.language } : {})
+    });
+    return payload ?? {};
+}
+function openLibraryBookSearchFields() {
+    return [
+        "key",
+        "title",
+        "author_name",
+        "author_key",
+        "first_publish_year",
+        "first_publish_date",
+        "cover_i",
+        "ratings_average",
+        "edition_count",
+        "language",
+        "isbn",
+        "ia",
+        "subject",
+        "ddc",
+        "lcc",
+        "lccn"
+    ];
+}
+async function sourceRecordsFromSearchResults(results) {
+    const records = [];
+    for (const result of results ?? []) {
+        const id = openLibraryWorkIdFromKey(result.key);
+        if (!id) {
+            continue;
+        }
+        records.push(await createSourceRecord({
+            source: { provider: OPEN_LIBRARY_PROVIDER, category: OPEN_LIBRARY_BOOK_CATEGORY, externalId: id },
+            payload: result
+        }));
+    }
+    return records;
+}
+async function addAuthorRelations(data, payload) {
+    for (const [index, ref] of (payload.work.authors ?? []).entries()) {
+        const id = openLibraryAuthorIdFromKey(ref.author?.key);
+        if (!id) {
+            continue;
+        }
+        const author = payload.authors?.find((item) => openLibraryAuthorIdFromKey(item.key) === id);
+        const zuuid = await providerZuuid({ provider: OPEN_LIBRARY_PROVIDER, category: "author", externalId: id });
+        data.relations.push({
+            id: zuuid,
+            zuuid,
+            category: "author",
+            title: stringField(author?.name) ?? id,
+            date: stringField(author?.birth_date) ?? null,
+            cover: coverUrl(author?.photos?.find((photo) => typeof photo === "number"), OPEN_LIBRARY_COVER_BASE_URL),
+            rating: null,
+            weight: null,
+            relationType: "authored_by",
+            direction: "outgoing",
+            attribute: null,
+            order: index,
+            source: OPEN_LIBRARY_PROVIDER,
+            externalId: id
+        });
+    }
+}
+function addOpenLibraryBookAggregateDetails(data, payload, preferredEdition) {
+    const editions = payload.editions?.entries ?? [];
+    if (!editions.length && !payload.search) {
+        return;
+    }
+    addArrayDetail(data, "languages", uniqueStrings([...(payload.search?.language ?? []), ...editions.flatMap((edition) => languageKeys(edition.languages))]));
+    addArrayDetail(data, "isbn_10", uniqueStrings(editions.flatMap((edition) => edition.isbn_10 ?? [])));
+    addArrayDetail(data, "isbn_13", uniqueStrings(editions.flatMap((edition) => edition.isbn_13 ?? [])));
+    addArrayDetail(data, "isbn", uniqueStrings([...(payload.search?.isbn ?? []), ...editions.flatMap((edition) => [...(edition.isbn_10 ?? []), ...(edition.isbn_13 ?? [])])]));
+    addArrayDetail(data, "ia", payload.search?.ia);
+    addArrayDetail(data, "publishers", uniqueStrings(editions.flatMap((edition) => edition.publishers ?? [])));
+    addArrayDetail(data, "source_records", uniqueStrings(editions.flatMap((edition) => edition.source_records ?? [])));
+    addArrayDetail(data, "local_id", uniqueStrings(editions.flatMap((edition) => edition.local_id ?? [])));
+    addArrayDetail(data, "dewey_decimal_class", uniqueStrings([...(payload.search?.ddc ?? []), ...classificationSubjects(payload.work.subjects, "dewey")]));
+    addArrayDetail(data, "lc_classifications", uniqueStrings([...(payload.search?.lcc ?? []), ...classificationSubjects(payload.work.subjects, "lc")]));
+    addArrayDetail(data, "lccn", payload.search?.lccn);
+    addArrayDetail(data, "translated_from", uniqueStrings(editions.flatMap((edition) => languageKeys(edition.translated_from))));
+    addArrayDetail(data, "translation_of", uniqueStrings(editions.map((edition) => stringField(edition.translation_of)).filter((item) => Boolean(item))));
+    const contributors = uniqueObjects(editions.flatMap((edition) => (edition.contributors ?? [])
+        .map((contributor) => ({
+        role: stringField(contributor.role),
+        name: stringField(contributor.name)
+    }))
+        .filter((contributor) => contributor.name)));
+    addStructuredDetail(data, "contributors", contributors);
+    const classifications = combineEditionRecords(editions, "classifications");
+    addStructuredDetail(data, "classifications", classifications);
+    const identifiers = combineEditionRecords(editions, "identifiers");
+    addStructuredDetail(data, "identifiers", identifiers);
+    if (preferredEdition) {
+        const preferred = editionSummary(preferredEdition);
+        addStructuredDetail(data, "preferred_edition", preferred);
+        addDetail(data, "publish_date", preferredEdition.publish_date);
+        addDetail(data, "edition_name", preferredEdition.edition_name);
+        addDetail(data, "full_title", preferredEdition.full_title);
+        addDetail(data, "subtitle", preferredEdition.subtitle);
+        if (typeof preferredEdition.number_of_pages === "number") {
+            data.details.push({ key: "number_of_pages", value: preferredEdition.number_of_pages, source: OPEN_LIBRARY_PROVIDER });
+        }
+        addDetail(data, "physical_format", preferredEdition.physical_format);
+    }
+    const summaries = editions.map((edition) => editionSummary(edition)).filter((edition) => Object.keys(edition).length > 0);
+    addStructuredDetail(data, "editions", summaries);
+}
+function preferredOpenLibraryEdition(payload) {
+    const editions = payload.editions?.entries ?? [];
+    if (!editions.length) {
+        return undefined;
+    }
+    const coverEditionId = openLibraryEditionIdFromKey(payload.work.cover_edition?.key);
+    const coverEdition = editions.find((edition) => openLibraryEditionIdFromKey(edition.key) === coverEditionId);
+    if (coverEdition) {
+        return coverEdition;
+    }
+    return [...editions].sort((a, b) => editionScore(b, payload) - editionScore(a, payload))[0];
+}
+function editionScore(edition, payload) {
+    let score = 0;
+    const title = stringField(edition.title)?.toLowerCase();
+    const workTitle = stringField(payload.work.title)?.toLowerCase();
+    const languages = languageKeys(edition.languages);
+    if (title && workTitle && title === workTitle) {
+        score += 20;
+    }
+    if (languages.includes("eng")) {
+        score += 15;
+    }
+    if (edition.isbn_13?.length) {
+        score += 8;
+    }
+    if (edition.isbn_10?.length) {
+        score += 6;
+    }
+    if (edition.covers?.length) {
+        score += 5;
+    }
+    if (edition.publish_date) {
+        score += 4;
+    }
+    if (edition.publishers?.length) {
+        score += 3;
+    }
+    if (typeof edition.number_of_pages === "number") {
+        score += 2;
+    }
+    return score;
+}
+function editionSummary(edition) {
+    const summary = {};
+    addSummaryString(summary, "id", openLibraryEditionIdFromKey(edition.key));
+    addSummaryString(summary, "title", edition.title);
+    addSummaryString(summary, "subtitle", edition.subtitle);
+    addSummaryString(summary, "fullTitle", edition.full_title);
+    addSummaryString(summary, "editionName", edition.edition_name);
+    addSummaryString(summary, "publishDate", edition.publish_date);
+    addSummaryString(summary, "physicalFormat", edition.physical_format);
+    addSummaryNumber(summary, "numberOfPages", edition.number_of_pages);
+    addSummaryArray(summary, "publishers", edition.publishers);
+    addSummaryArray(summary, "isbn10", edition.isbn_10);
+    addSummaryArray(summary, "isbn13", edition.isbn_13);
+    addSummaryArray(summary, "languages", languageKeys(edition.languages));
+    addSummaryArray(summary, "translatedFrom", languageKeys(edition.translated_from));
+    addSummaryString(summary, "translationOf", edition.translation_of);
+    addSummaryArray(summary, "covers", edition.covers);
+    addSummaryArray(summary, "sourceRecords", edition.source_records);
+    addSummaryArray(summary, "localId", edition.local_id);
+    if (edition.contributors?.length) {
+        summary.contributors = edition.contributors;
+    }
+    if (edition.identifiers && Object.keys(edition.identifiers).length) {
+        summary.identifiers = edition.identifiers;
+    }
+    if (edition.classifications && Object.keys(edition.classifications).length) {
+        summary.classifications = edition.classifications;
+    }
+    return summary;
+}
+function addSummaryString(summary, key, value) {
+    const clean = stringField(value);
+    if (clean) {
+        summary[key] = clean;
+    }
+}
+function addSummaryNumber(summary, key, value) {
+    if (typeof value === "number" && Number.isFinite(value)) {
+        summary[key] = value;
+    }
+}
+function addSummaryArray(summary, key, value) {
+    if (value?.length) {
+        summary[key] = value;
+    }
+}
+function languageKeys(value) {
+    return uniqueStrings((value ?? [])
+        .map((item) => stringField(item.key)?.replace(/^\/languages\//, ""))
+        .filter((item) => Boolean(item)));
+}
+function combineEditionRecords(editions, key) {
+    const combined = {};
+    for (const edition of editions) {
+        const record = edition[key];
+        if (!record) {
+            continue;
+        }
+        for (const [recordKey, value] of Object.entries(record)) {
+            if (value === undefined || value === null || (Array.isArray(value) && value.length === 0)) {
+                continue;
+            }
+            const values = Array.isArray(value) ? value : [value];
+            for (const item of values) {
+                combined[recordKey] = combined[recordKey] ?? [];
+                if (!combined[recordKey].some((existing) => JSON.stringify(existing) === JSON.stringify(item))) {
+                    combined[recordKey].push(item);
+                }
+            }
+        }
+    }
+    return Object.keys(combined).length ? combined : undefined;
+}
+function classificationSubjects(subjects, type) {
+    const values = [];
+    for (const subject of subjects ?? []) {
+        const clean = stringField(subject);
+        if (!clean) {
+            continue;
+        }
+        if (type === "dewey" && /^\d{3}(?:\/|\.)/.test(clean)) {
+            values.push(clean);
+        }
+        if (type === "lc" && /^[A-Za-z]{1,3}\d{1,5}(?:\.\w+)?(?:\s+\w+)*$/.test(clean) && !/^\d/.test(clean)) {
+            values.push(clean);
+        }
+    }
+    return uniqueStrings(values);
+}
+function uniqueStrings(values) {
+    const seen = new Set();
+    const result = [];
+    for (const value of values ?? []) {
+        const clean = stringField(value);
+        if (clean && !seen.has(clean)) {
+            seen.add(clean);
+            result.push(clean);
+        }
+    }
+    return result;
+}
+function uniqueObjects(values) {
+    const seen = new Set();
+    const result = [];
+    for (const value of values) {
+        const key = JSON.stringify(value);
+        if (!seen.has(key)) {
+            seen.add(key);
+            result.push(value);
+        }
+    }
+    return result;
+}
+function addTag(data, value) {
+    const tag = stringField(value)?.toLowerCase();
+    if (tag && !data.tags.includes(tag)) {
+        data.tags.push(tag);
+    }
+}
+function addArrayDetail(data, key, value) {
+    const clean = value?.map((item) => stringField(item)).filter((item) => Boolean(item));
+    if (clean?.length) {
+        data.details.push({ key, value: clean, 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 normalizeOpenLibraryBookId(value) {
+    const normalized = stringField(value)?.replace(/^\/works\//, "").replace(/\.json$/, "");
+    if (!normalized) {
+        throw new Error("Open Library book id must not be empty");
+    }
+    if (!/^OL\d+W$/i.test(normalized)) {
+        throw new Error(`Open Library book id must be a work id like OL82563W: ${value}`);
+    }
+    return normalized.toUpperCase();
+}
+function openLibraryWorkIdFromKey(value) {
+    const normalized = stringField(value)?.replace(/^\/works\//, "");
+    return normalized && /^OL\d+W$/i.test(normalized) ? normalized.toUpperCase() : undefined;
+}
+function openLibraryEditionIdFromKey(value) {
+    const normalized = stringField(value)?.replace(/^\/books\//, "");
+    return normalized && /^OL\d+M$/i.test(normalized) ? normalized.toUpperCase() : undefined;
+}
+function openLibraryAuthorIdFromKey(value) {
+    const normalized = stringField(value)?.replace(/^\/authors\//, "");
+    return normalized && /^OL\d+A$/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 openLibraryBookPayload(payload) {
+    const value = payload;
+    if ("work" in value && value.work) {
+        return value;
+    }
+    return { work: value };
+}
+function searchQuery(value) {
+    const query = stringField(value);
+    if (!query) {
+        throw new Error("Open Library search query must not be empty");
+    }
+    return query;
+}
+function stringField(value) {
+    const normalized = value?.trim();
+    return normalized ? normalized : undefined;
+}
+function numberField(value) {
+    return typeof value === "number" && Number.isFinite(value) ? value : undefined;
+}