@de-otio/bibcheck 0.1.0

package/dist/config.js

@@ -0,0 +1,180 @@
+/**
+ * bibcheck configuration schema and loader.
+ *
+ * Reads `bibcheck.toml` from the project root, validates it against the
+ * Zod schema, and returns a frozen typed Config. Returns defaults when no
+ * config file is present.
+ */
+import { z } from 'zod';
+import { parse as parseToml } from 'smol-toml';
+import { readFile, access } from 'node:fs/promises';
+import { join } from 'node:path';
+// ---------------------------------------------------------------------------
+// Schema sections
+// ---------------------------------------------------------------------------
+const BibliographySchema = z.object({
+    file: z.string().default('docs/sources.json'),
+});
+const DocsSchema = z.object({
+    include: z.array(z.string()).default(['docs/**/*.md']),
+    exclude: z.array(z.string()).default([]),
+});
+const TrustedHostsSchema = z.object({
+    hosts: z.array(z.string()).default([
+        'hathitrust.org',
+        'archive.org',
+        'oll.libertyfund.org',
+        'plato.stanford.edu',
+        'philpapers.org',
+        'loc.gov',
+        'dnb.de',
+        'bnf.fr',
+    ]),
+});
+const PhrasesSchema = z.object({
+    file: z.string().nullable().default(null),
+});
+const SourceTypeEntrySchema = z.object({
+    warn_load_bearing: z.boolean().optional(),
+    allow_load_bearing: z.boolean().optional(),
+    /**
+     * T23 — source-type gating rule. When `false`, a `not-found-in-databases`
+     * (unverifiable-absence) result for an entry of this CSL type does NOT gate
+     * `bibcheck check` — e.g. a pre-DOI manuscript / archival source for which no
+     * DOI was ever expected. The finding is still reported (informational), never
+     * dropped. Omitted / `true` ⇒ the Q1 secure default (gate). Governs only the
+     * not-found gate; malformed identifiers, canonical issues, and metadata
+     * mismatches always gate (use a per-entry `bibcheck-allow` note for those).
+     */
+    gate_not_found: z.boolean().optional(),
+});
+const ApisSchema = z.object({
+    crossref_mailto: z.string().nullable().default(null),
+    openalex_mailto: z.string().nullable().default(null),
+    // Base URLs for each bibliographic database. When omitted, each DB client
+    // and the doctor connectivity check fall back to the real public endpoint
+    // (see API_BASE_DEFAULTS). Overridable (e.g. to a localhost stub) for
+    // hermetic testing. Validated as URLs when present; a trailing slash is
+    // tolerated (clients strip it). Kept optional so the effective default lives
+    // in one place (API_BASE_DEFAULTS) and consumers stay tolerant of an absent
+    // value.
+    crossref_base: z.string().url().optional(),
+    openalex_base: z.string().url().optional(),
+    openlibrary_base: z.string().url().optional(),
+});
+/**
+ * Effective default base URLs for the bibliographic database APIs. These are
+ * the real public endpoints used whenever the corresponding `[apis] *_base`
+ * config field is omitted. (WorldCat / OCLC Classify was removed in 0.2.0.)
+ */
+export const API_BASE_DEFAULTS = {
+    crossref: 'https://api.crossref.org',
+    openalex: 'https://api.openalex.org',
+    openlibrary: 'https://openlibrary.org',
+};
+const CacheSchema = z.object({
+    dir: z.string().default('.bibcheck-cache'),
+    max_size_mb: z.number().nullable().default(256),
+});
+// ---------------------------------------------------------------------------
+// Top-level schema
+// ---------------------------------------------------------------------------
+export const ConfigSchema = z.object({
+    bibliography: BibliographySchema.default({}),
+    docs: DocsSchema.default({}),
+    trusted_hosts: TrustedHostsSchema.default({}),
+    phrases: PhrasesSchema.default({}),
+    source_types: z.record(z.string(), SourceTypeEntrySchema).default({}),
+    edition_discipline: z.record(z.string(), z.string()).default({}),
+    apis: ApisSchema.default({}),
+    cache: CacheSchema.default({}),
+});
+// ---------------------------------------------------------------------------
+// Error class
+// ---------------------------------------------------------------------------
+export class ConfigError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'ConfigError';
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, ConfigError);
+        }
+    }
+}
+// ---------------------------------------------------------------------------
+// Prototype-pollution guard
+// ---------------------------------------------------------------------------
+const DANGEROUS_KEYS = new Set(['__proto__', 'constructor', 'prototype']);
+function checkPollution(node, path) {
+    if (node === null || typeof node !== 'object')
+        return;
+    for (const key of Object.keys(node)) {
+        const childPath = path ? `${path}.${key}` : key;
+        if (DANGEROUS_KEYS.has(key)) {
+            throw new ConfigError(`Prototype pollution attempt: ${childPath}`);
+        }
+        checkPollution(node[key], childPath);
+    }
+}
+// ---------------------------------------------------------------------------
+// Deep freeze helper
+// ---------------------------------------------------------------------------
+function deepFreeze(value) {
+    if (value === null || typeof value !== 'object')
+        return value;
+    Object.freeze(value);
+    for (const v of Object.values(value)) {
+        deepFreeze(v);
+    }
+    return value;
+}
+export async function loadConfig(opts) {
+    const cwd = opts?.cwd ?? process.cwd();
+    const configPath = opts?.path ? join(cwd, opts.path) : join(cwd, 'bibcheck.toml');
+    let raw;
+    try {
+        await access(configPath);
+    }
+    catch {
+        // File does not exist — return defaults
+        return deepFreeze(ConfigSchema.parse({}));
+    }
+    let contents;
+    try {
+        contents = await readFile(configPath, 'utf-8');
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        throw new ConfigError(`Failed to read config file: ${message}`);
+    }
+    // Empty file is valid — treat as all-defaults
+    if (contents.trim() === '') {
+        return deepFreeze(ConfigSchema.parse({}));
+    }
+    try {
+        raw = parseToml(contents);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        throw new ConfigError(`TOML parse error in ${configPath}: ${message}`);
+    }
+    // Prototype-pollution guard
+    checkPollution(raw, '');
+    try {
+        return deepFreeze(ConfigSchema.parse(raw));
+    }
+    catch (err) {
+        if (err instanceof z.ZodError) {
+            const first = err.issues[0];
+            if (first !== undefined) {
+                const fieldPath = first.path.join('.');
+                throw new ConfigError(`${fieldPath}: ${first.message}`);
+            }
+            /* c8 ignore next */
+            // unreachable: ZodError always has at least one issue
+            throw new ConfigError(`Configuration validation failed: ${err.message}`);
+        }
+        throw err;
+    }
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/databases/crossref.d.ts

@@ -0,0 +1,53 @@
+/**
+ * CrossRef DOI lookup client.
+ *
+ * Queries https://api.crossref.org/works/<doi> and returns normalised
+ * DatabaseLookupResult metadata. Supports the CrossRef polite pool via a
+ * ?mailto= query param. Results are cached (default 30-day TTL).
+ *
+ * The polite-pool email is stripped from any URL fields in the raw response
+ * before caching to prevent credentials leaking into evidence output.
+ */
+import type { HttpClient } from '../http.js';
+import type { Cache } from '../cache/fs-cache.js';
+export interface DatabaseLookupResult {
+    found: boolean;
+    metadata: {
+        title?: string;
+        authors?: string[];
+        issued?: number;
+        publisher?: string;
+        doi?: string;
+        isbn?: string;
+        url?: string;
+    } | null;
+    raw: unknown;
+}
+export interface DatabaseClient {
+    readonly name: string;
+}
+export interface CrossRefClientOptions {
+    http: HttpClient;
+    cache: Cache;
+    mailto?: string | null;
+    /** Base URL for the CrossRef API. Defaults to the public endpoint. */
+    baseUrl?: string;
+}
+/** Remove a single trailing slash so path joins are unambiguous. */
+export declare function trimTrailingSlash(url: string): string;
+export interface CrossRefClient extends DatabaseClient {
+    readonly name: 'crossref';
+    lookupByDoi(doi: string, signal?: AbortSignal): Promise<DatabaseLookupResult>;
+}
+/**
+ * Strip the ?mailto= query parameter from a URL string.
+ * Returns the original string unchanged if it is not a valid URL.
+ */
+export declare function stripMailto(url: string): string;
+/**
+ * Recursively walk an unknown value and strip ?mailto= from any string
+ * fields that look like URLs. Returns a new value; does not mutate.
+ */
+export declare function sanitizeMailto(value: unknown): unknown;
+export declare function createCrossRefClient(opts: CrossRefClientOptions): CrossRefClient;
+//# sourceMappingURL=crossref.d.ts.map

package/dist/databases/crossref.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crossref.d.ts","sourceRoot":"","sources":["../../src/databases/crossref.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAgB,MAAM,YAAY,CAAC;AAC3D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAOlD,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,EAAE;QACR,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;QACnB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,GAAG,CAAC,EAAE,MAAM,CAAC;KACd,GAAG,IAAI,CAAC;IACT,GAAG,EAAE,OAAO,CAAC;CACd;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAMD,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,UAAU,CAAC;IACjB,KAAK,EAAE,KAAK,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,sEAAsE;IACtE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAID,oEAAoE;AACpE,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAErD;AAED,MAAM,WAAW,cAAe,SAAQ,cAAc;IACpD,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;CAC/E;AAmCD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAY/C;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAmBtD;AAoCD,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,qBAAqB,GAAG,cAAc,CA0DhF"}

package/dist/databases/crossref.js

@@ -0,0 +1,138 @@
+/**
+ * CrossRef DOI lookup client.
+ *
+ * Queries https://api.crossref.org/works/<doi> and returns normalised
+ * DatabaseLookupResult metadata. Supports the CrossRef polite pool via a
+ * ?mailto= query param. Results are cached (default 30-day TTL).
+ *
+ * The polite-pool email is stripped from any URL fields in the raw response
+ * before caching to prevent credentials leaking into evidence output.
+ */
+const DEFAULT_CROSSREF_BASE = 'https://api.crossref.org';
+/** Remove a single trailing slash so path joins are unambiguous. */
+export function trimTrailingSlash(url) {
+    return url.endsWith('/') ? url.slice(0, -1) : url;
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/**
+ * Strip the ?mailto= query parameter from a URL string.
+ * Returns the original string unchanged if it is not a valid URL.
+ */
+export function stripMailto(url) {
+    let parsed;
+    try {
+        parsed = new URL(url);
+    }
+    catch {
+        return url;
+    }
+    if (parsed.searchParams.has('mailto')) {
+        parsed.searchParams.delete('mailto');
+        return parsed.toString();
+    }
+    return url;
+}
+/**
+ * Recursively walk an unknown value and strip ?mailto= from any string
+ * fields that look like URLs. Returns a new value; does not mutate.
+ */
+export function sanitizeMailto(value) {
+    if (typeof value === 'string') {
+        // Only attempt stripMailto for strings that look like URLs.
+        if (value.startsWith('http://') || value.startsWith('https://')) {
+            return stripMailto(value);
+        }
+        return value;
+    }
+    if (Array.isArray(value)) {
+        return value.map(sanitizeMailto);
+    }
+    if (typeof value === 'object' && value !== null) {
+        const result = {};
+        for (const [k, v] of Object.entries(value)) {
+            result[k] = sanitizeMailto(v);
+        }
+        return result;
+    }
+    return value;
+}
+function isCrossRefSuccess(body) {
+    if (typeof body !== 'object' || body === null)
+        return false;
+    const b = body;
+    return b['status'] === 'ok' && typeof b['message'] === 'object' && b['message'] !== null;
+}
+function mapMetadata(msg) {
+    const authors = msg.author
+        ?.map((a) => [a.family, a.given].filter(Boolean).join(', '))
+        .filter((s) => s.length > 0);
+    // noUncheckedIndexedAccess: date-parts[0] could be undefined on malformed data.
+    const dateParts = msg.issued?.['date-parts'];
+    const firstPart = dateParts?.[0];
+    const year = firstPart?.[0];
+    const isbn = msg.ISBN?.[0];
+    const title = msg.title?.[0];
+    return {
+        title,
+        authors: authors && authors.length > 0 ? authors : undefined,
+        issued: typeof year === 'number' ? year : undefined,
+        publisher: msg.publisher,
+        doi: msg.DOI,
+        isbn,
+        url: msg.URL,
+    };
+}
+// ---------------------------------------------------------------------------
+// Factory
+// ---------------------------------------------------------------------------
+export function createCrossRefClient(opts) {
+    const { http, cache, mailto } = opts;
+    const base = trimTrailingSlash(opts.baseUrl ?? DEFAULT_CROSSREF_BASE);
+    async function lookupByDoi(doi, signal) {
+        const cacheKey = `crossref:lookupByDoi:${doi.toLowerCase()}`;
+        const cached = await cache.get(cacheKey, signal);
+        if (cached !== null) {
+            return cached;
+        }
+        const encoded = encodeURIComponent(doi);
+        let url = `${base}/works/${encoded}`;
+        if (mailto) {
+            url += `?mailto=${encodeURIComponent(mailto)}`;
+        }
+        let response;
+        try {
+            response = await http.get(url, { signal });
+        }
+        catch (err) {
+            // Network errors / 5xx after retries — propagate.
+            throw err;
+        }
+        if (response.status === 404) {
+            const result = {
+                found: false,
+                metadata: null,
+                raw: sanitizeMailto(response.body),
+            };
+            return result;
+        }
+        if (!isCrossRefSuccess(response.body)) {
+            throw new Error(`CrossRef: unexpected response body for DOI "${doi}" (status ${response.status})`);
+        }
+        const sanitizedRaw = sanitizeMailto(response.body);
+        const metadata = mapMetadata(response.body.message);
+        const result = {
+            found: true,
+            metadata,
+            raw: sanitizedRaw,
+        };
+        await cache.set(cacheKey, result);
+        return result;
+    }
+    return {
+        name: 'crossref',
+        lookupByDoi,
+    };
+}
+//# sourceMappingURL=crossref.js.map

package/dist/databases/crossref.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"crossref.js","sourceRoot":"","sources":["../../src/databases/crossref.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAwCH,MAAM,qBAAqB,GAAG,0BAA0B,CAAC;AAEzD,oEAAoE;AACpE,MAAM,UAAU,iBAAiB,CAAC,GAAW;IAC3C,OAAO,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;AACpD,CAAC;AAoCD,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,GAAW;IACrC,IAAI,MAAW,CAAC;IAChB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;IACxB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,GAAG,CAAC;IACb,CAAC;IACD,IAAI,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;QACtC,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACrC,OAAO,MAAM,CAAC,QAAQ,EAAE,CAAC;IAC3B,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,4DAA4D;QAC5D,IAAI,KAAK,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,KAAK,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YAChE,OAAO,WAAW,CAAC,KAAK,CAAC,CAAC;QAC5B,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IACnC,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAChD,MAAM,MAAM,GAA4B,EAAE,CAAC;QAC3C,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAC3C,MAAM,CAAC,CAAC,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC;QAChC,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,iBAAiB,CAAC,IAAa;IACtC,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC5D,MAAM,CAAC,GAAG,IAA+B,CAAC;IAC1C,OAAO,CAAC,CAAC,QAAQ,CAAC,KAAK,IAAI,IAAI,OAAO,CAAC,CAAC,SAAS,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,SAAS,CAAC,KAAK,IAAI,CAAC;AAC3F,CAAC;AAED,SAAS,WAAW,CAAC,GAAoB;IACvC,MAAM,OAAO,GAAG,GAAG,CAAC,MAAM;QACxB,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;SAC3D,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAE/B,gFAAgF;IAChF,MAAM,SAAS,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,YAAY,CAAC,CAAC;IAC7C,MAAM,SAAS,GAAG,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC;IACjC,MAAM,IAAI,GAAG,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC;IAE5B,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAC3B,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;IAE7B,OAAO;QACL,KAAK;QACL,OAAO,EAAE,OAAO,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;QAC5D,MAAM,EAAE,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;QACnD,SAAS,EAAE,GAAG,CAAC,SAAS;QACxB,GAAG,EAAE,GAAG,CAAC,GAAG;QACZ,IAAI;QACJ,GAAG,EAAE,GAAG,CAAC,GAAG;KACb,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E,MAAM,UAAU,oBAAoB,CAAC,IAA2B;IAC9D,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IACrC,MAAM,IAAI,GAAG,iBAAiB,CAAC,IAAI,CAAC,OAAO,IAAI,qBAAqB,CAAC,CAAC;IAEtE,KAAK,UAAU,WAAW,CAAC,GAAW,EAAE,MAAoB;QAC1D,MAAM,QAAQ,GAAG,wBAAwB,GAAG,CAAC,WAAW,EAAE,EAAE,CAAC;QAE7D,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,GAAG,CAAuB,QAAQ,EAAE,MAAM,CAAC,CAAC;QACvE,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;YACpB,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,MAAM,OAAO,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC;QACxC,IAAI,GAAG,GAAG,GAAG,IAAI,UAAU,OAAO,EAAE,CAAC;QACrC,IAAI,MAAM,EAAE,CAAC;YACX,GAAG,IAAI,WAAW,kBAAkB,CAAC,MAAM,CAAC,EAAE,CAAC;QACjD,CAAC;QAED,IAAI,QAAsB,CAAC;QAC3B,IAAI,CAAC;YACH,QAAQ,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;QAC7C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,kDAAkD;YAClD,MAAM,GAAG,CAAC;QACZ,CAAC;QAED,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YAC5B,MAAM,MAAM,GAAyB;gBACnC,KAAK,EAAE,KAAK;gBACZ,QAAQ,EAAE,IAAI;gBACd,GAAG,EAAE,cAAc,CAAC,QAAQ,CAAC,IAAI,CAAC;aACnC,CAAC;YACF,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,IAAI,CAAC,iBAAiB,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YACtC,MAAM,IAAI,KAAK,CACb,+CAA+C,GAAG,aAAa,QAAQ,CAAC,MAAM,GAAG,CAClF,CAAC;QACJ,CAAC;QAED,MAAM,YAAY,GAAG,cAAc,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACnD,MAAM,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAEpD,MAAM,MAAM,GAAyB;YACnC,KAAK,EAAE,IAAI;YACX,QAAQ;YACR,GAAG,EAAE,YAAY;SAClB,CAAC;QAEF,MAAM,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAClC,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,OAAO;QACL,IAAI,EAAE,UAAmB;QACzB,WAAW;KACZ,CAAC;AACJ,CAAC"}

package/dist/databases/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Barrel re-export for the bibliographic database clients (CrossRef,
+ * OpenAlex, OpenLibrary). WorldCat / OCLC Classify was removed in 0.2.0
+ * (decommissioned endpoint; see tmp/design-review/worldcat.md).
+ */
+export { createCrossRefClient, stripMailto, sanitizeMailto, } from './crossref.js';
+export type { DatabaseLookupResult, DatabaseClient, CrossRefClientOptions, CrossRefClient, } from './crossref.js';
+export { createOpenAlexClient } from './openalex.js';
+export type { OpenAlexClientOptions, OpenAlexClient } from './openalex.js';
+export { createOpenLibraryClient } from './openlibrary.js';
+export type { OpenLibraryClientOptions, OpenLibraryClient } from './openlibrary.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/databases/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/databases/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,oBAAoB,EACpB,WAAW,EACX,cAAc,GACf,MAAM,eAAe,CAAC;AACvB,YAAY,EACV,oBAAoB,EACpB,cAAc,EACd,qBAAqB,EACrB,cAAc,GACf,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,YAAY,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE3E,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAC3D,YAAY,EAAE,wBAAwB,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/databases/index.js

@@ -0,0 +1,9 @@
+/**
+ * Barrel re-export for the bibliographic database clients (CrossRef,
+ * OpenAlex, OpenLibrary). WorldCat / OCLC Classify was removed in 0.2.0
+ * (decommissioned endpoint; see tmp/design-review/worldcat.md).
+ */
+export { createCrossRefClient, stripMailto, sanitizeMailto, } from './crossref.js';
+export { createOpenAlexClient } from './openalex.js';
+export { createOpenLibraryClient } from './openlibrary.js';
+//# sourceMappingURL=index.js.map

package/dist/databases/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/databases/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,oBAAoB,EACpB,WAAW,EACX,cAAc,GACf,MAAM,eAAe,CAAC;AAQvB,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAGrD,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/databases/openalex.d.ts

@@ -0,0 +1,29 @@
+/**
+ * OpenAlex works client.
+ *
+ * Supports DOI lookup and title+author search against the OpenAlex API
+ * (https://api.openalex.org/works). Polite pool is engaged via ?mailto=.
+ * Results are cached at default TTL (30 days).
+ *
+ * Sanitization: ?mailto= is stripped from any URL strings in the raw response.
+ */
+import type { HttpClient } from '../http.js';
+import type { Cache } from '../cache/fs-cache.js';
+import type { DatabaseLookupResult, DatabaseClient } from './crossref.js';
+import { stripMailto } from './crossref.js';
+export type { DatabaseLookupResult, DatabaseClient };
+export interface OpenAlexClientOptions {
+    http: HttpClient;
+    cache: Cache;
+    mailto?: string | null;
+    /** Base URL for the OpenAlex API. Defaults to the public endpoint. */
+    baseUrl?: string;
+}
+export interface OpenAlexClient extends DatabaseClient {
+    readonly name: 'openalex';
+    searchByTitleAuthor(title: string, authors: string[], signal?: AbortSignal): Promise<DatabaseLookupResult>;
+    lookupByDoi(doi: string, signal?: AbortSignal): Promise<DatabaseLookupResult>;
+}
+export { stripMailto };
+export declare function createOpenAlexClient(opts: OpenAlexClientOptions): OpenAlexClient;
+//# sourceMappingURL=openalex.d.ts.map

package/dist/databases/openalex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openalex.d.ts","sourceRoot":"","sources":["../../src/databases/openalex.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAgB,MAAM,YAAY,CAAC;AAC3D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,KAAK,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC1E,OAAO,EAAE,WAAW,EAAqC,MAAM,eAAe,CAAC;AAG/E,YAAY,EAAE,oBAAoB,EAAE,cAAc,EAAE,CAAC;AAMrD,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,UAAU,CAAC;IACjB,KAAK,EAAE,KAAK,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,sEAAsE;IACtE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAID,MAAM,WAAW,cAAe,SAAQ,cAAc;IACpD,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,mBAAmB,CACjB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EAAE,EACjB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,oBAAoB,CAAC,CAAC;IACjC,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;CAC/E;AA6BD,OAAO,EAAE,WAAW,EAAE,CAAC;AAwCvB,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,qBAAqB,GAAG,cAAc,CAuFhF"}

package/dist/databases/openalex.js

@@ -0,0 +1,117 @@
+/**
+ * OpenAlex works client.
+ *
+ * Supports DOI lookup and title+author search against the OpenAlex API
+ * (https://api.openalex.org/works). Polite pool is engaged via ?mailto=.
+ * Results are cached at default TTL (30 days).
+ *
+ * Sanitization: ?mailto= is stripped from any URL strings in the raw response.
+ */
+import { stripMailto, sanitizeMailto, trimTrailingSlash } from './crossref.js';
+const DEFAULT_OPENALEX_BASE = 'https://api.openalex.org';
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+// Re-export stripMailto for tests.
+export { stripMailto };
+function sanitizeRaw(value) {
+    return sanitizeMailto(value);
+}
+function isOpenAlexWork(body) {
+    if (typeof body !== 'object' || body === null)
+        return false;
+    return true;
+}
+function isOpenAlexSearchResponse(body) {
+    if (typeof body !== 'object' || body === null)
+        return false;
+    return true;
+}
+function mapWorkMetadata(work) {
+    const authors = work.authorships
+        ?.map((a) => a.author?.display_name ?? '')
+        .filter((n) => n.length > 0);
+    return {
+        title: work.display_name,
+        authors: authors && authors.length > 0 ? authors : undefined,
+        issued: typeof work.publication_year === 'number' ? work.publication_year : undefined,
+        doi: work.doi,
+        url: work.id,
+    };
+}
+function appendMailto(url, mailto) {
+    if (!mailto)
+        return url;
+    const separator = url.includes('?') ? '&' : '?';
+    return `${url}${separator}mailto=${encodeURIComponent(mailto)}`;
+}
+// ---------------------------------------------------------------------------
+// Factory
+// ---------------------------------------------------------------------------
+export function createOpenAlexClient(opts) {
+    const { http, cache, mailto } = opts;
+    const base = trimTrailingSlash(opts.baseUrl ?? DEFAULT_OPENALEX_BASE);
+    async function lookupByDoi(doi, signal) {
+        const cacheKey = `openalex:lookupByDoi:${doi.toLowerCase()}`;
+        const cached = await cache.get(cacheKey, signal);
+        if (cached !== null) {
+            return cached;
+        }
+        const encoded = encodeURIComponent(doi);
+        const baseUrl = `${base}/works/doi:${encoded}`;
+        const url = appendMailto(baseUrl, mailto);
+        let response;
+        response = await http.get(url, { signal });
+        if (response.status === 404) {
+            return { found: false, metadata: null, raw: sanitizeRaw(response.body) };
+        }
+        if (!isOpenAlexWork(response.body)) {
+            throw new Error(`OpenAlex: unexpected response body for DOI "${doi}"`);
+        }
+        const sanitizedRaw = sanitizeRaw(response.body);
+        const metadata = mapWorkMetadata(response.body);
+        const result = { found: true, metadata, raw: sanitizedRaw };
+        await cache.set(cacheKey, result);
+        return result;
+    }
+    async function searchByTitleAuthor(title, authors, signal) {
+        const firstAuthor = authors[0] ?? '';
+        const cacheKey = `openalex:searchByTitleAuthor:${title.toLowerCase()}:${firstAuthor.toLowerCase()}`;
+        const cached = await cache.get(cacheKey, signal);
+        if (cached !== null) {
+            return cached;
+        }
+        const baseUrl = `${base}/works?search=${encodeURIComponent(title)}&filter=author.display_name.search:${encodeURIComponent(firstAuthor)}&per-page=5`;
+        const url = appendMailto(baseUrl, mailto);
+        let response;
+        response = await http.get(url, { signal });
+        if (response.status === 404) {
+            return { found: false, metadata: null, raw: sanitizeRaw(response.body) };
+        }
+        if (!isOpenAlexSearchResponse(response.body)) {
+            throw new Error(`OpenAlex: unexpected search response for title "${title}"`);
+        }
+        const results = response.body.results;
+        const firstResult = results?.[0];
+        if (!firstResult) {
+            const result = {
+                found: false,
+                metadata: null,
+                raw: sanitizeRaw(response.body),
+            };
+            await cache.set(cacheKey, result);
+            return result;
+        }
+        const sanitizedRaw = sanitizeRaw(response.body);
+        const metadata = mapWorkMetadata(firstResult);
+        const result = { found: true, metadata, raw: sanitizedRaw };
+        await cache.set(cacheKey, result);
+        return result;
+    }
+    return {
+        name: 'openalex',
+        lookupByDoi,
+        searchByTitleAuthor,
+    };
+}
+//# sourceMappingURL=openalex.js.map

package/dist/databases/openalex.js.map

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

package/dist/databases/openlibrary.d.ts

@@ -0,0 +1,26 @@
+/**
+ * OpenLibrary ISBN lookup client.
+ *
+ * Queries https://openlibrary.org/api/books?bibkeys=ISBN:<isbn>&format=json&jscmd=data
+ * and returns normalised DatabaseLookupResult metadata. Results are cached at
+ * the default TTL (30 days).
+ *
+ * An empty response object {} indicates no match (found: false). The client
+ * does not use a polite-pool email (OpenLibrary has no such mechanism).
+ */
+import type { HttpClient } from '../http.js';
+import type { Cache } from '../cache/fs-cache.js';
+import type { DatabaseLookupResult, DatabaseClient } from './crossref.js';
+export type { DatabaseLookupResult, DatabaseClient };
+export interface OpenLibraryClientOptions {
+    http: HttpClient;
+    cache: Cache;
+    /** Base URL for the OpenLibrary API. Defaults to the public endpoint. */
+    baseUrl?: string;
+}
+export interface OpenLibraryClient extends DatabaseClient {
+    readonly name: 'openlibrary';
+    lookupByIsbn(isbn: string, signal?: AbortSignal): Promise<DatabaseLookupResult>;
+}
+export declare function createOpenLibraryClient(opts: OpenLibraryClientOptions): OpenLibraryClient;
+//# sourceMappingURL=openlibrary.d.ts.map

package/dist/databases/openlibrary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openlibrary.d.ts","sourceRoot":"","sources":["../../src/databases/openlibrary.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAgB,MAAM,YAAY,CAAC;AAC3D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,KAAK,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAG1E,YAAY,EAAE,oBAAoB,EAAE,cAAc,EAAE,CAAC;AAMrD,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,UAAU,CAAC;IACjB,KAAK,EAAE,KAAK,CAAC;IACb,yEAAyE;IACzE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAID,MAAM,WAAW,iBAAkB,SAAQ,cAAc;IACvD,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;CACjF;AA8DD,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,wBAAwB,GAAG,iBAAiB,CA2CzF"}