@de-otio/bibcheck 0.1.0

package/dist/databases/openlibrary.js

@@ -0,0 +1,79 @@
+/**
+ * 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 { trimTrailingSlash } from './crossref.js';
+const DEFAULT_OPENLIBRARY_BASE = 'https://openlibrary.org';
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function isOpenLibraryResponse(body) {
+    return typeof body === 'object' && body !== null && !Array.isArray(body);
+}
+function mapBookMetadata(book, isbn) {
+    const authors = book.authors?.map((a) => a.name ?? '').filter((n) => n.length > 0);
+    const publisher = book.publishers?.[0]?.name;
+    // publish_date is a free-form string like "January 2001" or "2001"; extract year.
+    let issued;
+    if (book.publish_date) {
+        const match = /\b(\d{4})\b/.exec(book.publish_date);
+        if (match?.[1] !== undefined) {
+            const parsed = parseInt(match[1], 10);
+            if (!isNaN(parsed)) {
+                issued = parsed;
+            }
+        }
+    }
+    return {
+        title: book.title,
+        authors: authors && authors.length > 0 ? authors : undefined,
+        issued,
+        publisher,
+        isbn,
+    };
+}
+// ---------------------------------------------------------------------------
+// Factory
+// ---------------------------------------------------------------------------
+export function createOpenLibraryClient(opts) {
+    const { http, cache } = opts;
+    const base = trimTrailingSlash(opts.baseUrl ?? DEFAULT_OPENLIBRARY_BASE);
+    async function lookupByIsbn(isbn, signal) {
+        const cacheKey = `openlibrary:lookupByIsbn:${isbn}`;
+        const cached = await cache.get(cacheKey, signal);
+        if (cached !== null) {
+            return cached;
+        }
+        const url = `${base}/api/books?bibkeys=ISBN:${encodeURIComponent(isbn)}&format=json&jscmd=data`;
+        let response;
+        response = await http.get(url, { signal });
+        if (response.status === 404) {
+            return { found: false, metadata: null, raw: response.body };
+        }
+        if (!isOpenLibraryResponse(response.body)) {
+            throw new Error(`OpenLibrary: unexpected response body for ISBN "${isbn}"`);
+        }
+        const bookData = response.body[`ISBN:${isbn}`];
+        if (bookData === undefined) {
+            // Empty response or no matching entry.
+            const result = { found: false, metadata: null, raw: response.body };
+            await cache.set(cacheKey, result);
+            return result;
+        }
+        const metadata = mapBookMetadata(bookData, isbn);
+        const result = { found: true, metadata, raw: response.body };
+        await cache.set(cacheKey, result);
+        return result;
+    }
+    return {
+        name: 'openlibrary',
+        lookupByIsbn,
+    };
+}
+//# sourceMappingURL=openlibrary.js.map

package/dist/databases/openlibrary.js.map

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

package/dist/databases/worldcat.d.ts

@@ -0,0 +1,33 @@
+/**
+ * WorldCat ISBN lookup client (v0.1: OCLC Classify legacy endpoint).
+ *
+ * v0.1 uses the OCLC Classify API at:
+ *   http://classify.oclc.org/classify2/api?isbn=<isbn>&summary=true
+ *
+ * IMPORTANT: This endpoint uses HTTP (not HTTPS). The response is bibliographic
+ * metadata only and contains no credentials, but response integrity is not
+ * guaranteed over a plaintext connection. This is an accepted v0.1 limitation.
+ * Migrate to the OCLC Discovery API (HTTPS + OAuth2) in v0.2 when apiKey
+ * support is implemented.
+ *
+ * The Classify API returns XML by default. We request JSON via Accept header.
+ * If the response is nonetheless XML (string), we perform a minimal regex parse
+ * for <work title="..." author="..."> — acceptable for v0.1 (documented kludge).
+ */
+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 WorldCatClientOptions {
+    http: HttpClient;
+    cache: Cache;
+    apiKey?: string | null;
+    /** Base URL for the Classify endpoint. Defaults to the public endpoint. */
+    baseUrl?: string;
+}
+export interface WorldCatClient extends DatabaseClient {
+    readonly name: 'worldcat';
+    lookupByIsbn(isbn: string, signal?: AbortSignal): Promise<DatabaseLookupResult>;
+}
+export declare function createWorldCatClient(opts: WorldCatClientOptions): WorldCatClient;
+//# sourceMappingURL=worldcat.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"worldcat.d.ts","sourceRoot":"","sources":["../../src/databases/worldcat.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;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;AAQrD,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,UAAU,CAAC;IACjB,KAAK,EAAE,KAAK,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,2EAA2E;IAC3E,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAe,SAAQ,cAAc;IACpD,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;CACjF;AA6FD,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,qBAAqB,GAAG,cAAc,CA2EhF"}

package/dist/databases/worldcat.js

@@ -0,0 +1,145 @@
+/**
+ * WorldCat ISBN lookup client (v0.1: OCLC Classify legacy endpoint).
+ *
+ * v0.1 uses the OCLC Classify API at:
+ *   http://classify.oclc.org/classify2/api?isbn=<isbn>&summary=true
+ *
+ * IMPORTANT: This endpoint uses HTTP (not HTTPS). The response is bibliographic
+ * metadata only and contains no credentials, but response integrity is not
+ * guaranteed over a plaintext connection. This is an accepted v0.1 limitation.
+ * Migrate to the OCLC Discovery API (HTTPS + OAuth2) in v0.2 when apiKey
+ * support is implemented.
+ *
+ * The Classify API returns XML by default. We request JSON via Accept header.
+ * If the response is nonetheless XML (string), we perform a minimal regex parse
+ * for <work title="..." author="..."> — acceptable for v0.1 (documented kludge).
+ */
+import { trimTrailingSlash } from './crossref.js';
+const DEFAULT_WORLDCAT_BASE = 'http://classify.oclc.org';
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function isClassifyJsonResponse(body) {
+    return typeof body === 'object' && body !== null;
+}
+/**
+ * Minimal XML parse for OCLC Classify XML responses.
+ * Extracts title and author from the first <work title="..." author="..."> element.
+ * This is a v0.1 kludge; full XML parsing is deferred to v0.2.
+ */
+function parseClassifyXml(xml) {
+    // Match both <work ... title="..." author="..."> and with attributes in any order.
+    const workMatch = /<work\b([^>]*)>/i.exec(xml);
+    if (!workMatch?.[1])
+        return null;
+    const attrs = workMatch[1];
+    const titleMatch = /\btitle="([^"]*)"/.exec(attrs);
+    const authorMatch = /\bauthor="([^"]*)"/.exec(attrs);
+    if (!titleMatch && !authorMatch)
+        return null;
+    return {
+        title: titleMatch?.[1],
+        author: authorMatch?.[1],
+    };
+}
+/**
+ * Determine whether there are zero works in a Classify JSON response.
+ * The Classify API returns an empty work list or a specific responseCode when
+ * no records are found.
+ */
+function hasClassifyWork(body) {
+    const classify = body.classify;
+    if (!classify)
+        return null;
+    // Single-work response.
+    if (classify.work && typeof classify.work === 'object') {
+        return classify.work;
+    }
+    // Multi-work summary: works.work may be an array or single object.
+    if (classify.works?.work) {
+        const w = classify.works.work;
+        if (Array.isArray(w)) {
+            return w[0] ?? null;
+        }
+        return w;
+    }
+    return null;
+}
+function mapClassifyMetadata(work, isbn) {
+    const authors = work.author ? [work.author] : undefined;
+    return {
+        title: work.title,
+        authors,
+        isbn,
+    };
+}
+// ---------------------------------------------------------------------------
+// Factory
+// ---------------------------------------------------------------------------
+export function createWorldCatClient(opts) {
+    const { http, cache } = opts;
+    // apiKey is reserved for v0.2; ignored in v0.1.
+    const base = trimTrailingSlash(opts.baseUrl ?? DEFAULT_WORLDCAT_BASE);
+    async function lookupByIsbn(isbn, signal) {
+        const cacheKey = `worldcat:lookupByIsbn:${isbn}`;
+        const cached = await cache.get(cacheKey, signal);
+        if (cached !== null) {
+            return cached;
+        }
+        // v0.1: HTTP (not HTTPS) — legacy Classify endpoint does not support HTTPS.
+        const url = `${base}/classify2/api?isbn=${encodeURIComponent(isbn)}&summary=true`;
+        let response;
+        try {
+            response = await http.get(url, {
+                signal,
+                headers: { Accept: 'application/json' },
+            });
+        }
+        catch (err) {
+            throw err;
+        }
+        if (response.status === 404) {
+            return { found: false, metadata: null, raw: response.body };
+        }
+        // Handle XML fallback (response body is a string when Content-Type is not JSON).
+        if (typeof response.body === 'string') {
+            const parsed = parseClassifyXml(response.body);
+            if (!parsed || (!parsed.title && !parsed.author)) {
+                const result = {
+                    found: false,
+                    metadata: null,
+                    raw: response.body,
+                };
+                await cache.set(cacheKey, result);
+                return result;
+            }
+            const metadata = mapClassifyMetadata(parsed, isbn);
+            const result = { found: true, metadata, raw: response.body };
+            await cache.set(cacheKey, result);
+            return result;
+        }
+        // JSON response path.
+        if (!isClassifyJsonResponse(response.body)) {
+            throw new Error(`WorldCat: unexpected response body for ISBN "${isbn}"`);
+        }
+        const work = hasClassifyWork(response.body);
+        if (!work) {
+            const result = {
+                found: false,
+                metadata: null,
+                raw: response.body,
+            };
+            await cache.set(cacheKey, result);
+            return result;
+        }
+        const metadata = mapClassifyMetadata(work, isbn);
+        const result = { found: true, metadata, raw: response.body };
+        await cache.set(cacheKey, result);
+        return result;
+    }
+    return {
+        name: 'worldcat',
+        lookupByIsbn,
+    };
+}
+//# sourceMappingURL=worldcat.js.map

package/dist/databases/worldcat.js.map

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

package/dist/doctor.d.ts

@@ -0,0 +1,44 @@
+/**
+ * bibcheck doctor — diagnostic runner.
+ *
+ * Runs a series of environment and configuration checks and returns a
+ * structured result. Each check emits a DoctorCheck entry with a name,
+ * status, and human-readable message. The CLI (T15) is responsible for
+ * rendering the output; this module does no I/O beyond what is needed
+ * to perform the checks.
+ *
+ * SECURITY: API keys, polite-pool email addresses, and full request URLs
+ * (which might contain ?mailto= query params) MUST NOT appear in any
+ * DoctorCheck.message or .details value.
+ */
+import type { Config } from './config.js';
+import type { HttpClient } from './http.js';
+export interface DoctorCheck {
+    name: string;
+    status: 'ok' | 'warn' | 'fail';
+    message: string;
+    details?: Record<string, unknown>;
+}
+export interface RunDoctorDeps {
+    config: Config;
+    cwd: string;
+    http: HttpClient;
+    signal: AbortSignal;
+    /** Injectable for tests */
+    fs?: {
+        stat: (path: string) => Promise<{
+            size: number;
+            isDirectory: () => boolean;
+        }>;
+        access: (path: string) => Promise<void>;
+        readdir: (path: string) => Promise<string[]>;
+    };
+    /** Optional: clear cache directory (called by --clear-cache flag) */
+    clearCache?: boolean;
+}
+export interface RunDoctorResult {
+    checks: DoctorCheck[];
+    ok: boolean;
+}
+export declare function runDoctor(deps: RunDoctorDeps): Promise<RunDoctorResult>;
+//# sourceMappingURL=doctor.d.ts.map

package/dist/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../src/doctor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAU5C,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,CAAC;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,UAAU,CAAC;IACjB,MAAM,EAAE,WAAW,CAAC;IACpB,2BAA2B;IAC3B,EAAE,CAAC,EAAE;QACH,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,WAAW,EAAE,MAAM,OAAO,CAAA;SAAE,CAAC,CAAC;QAC9E,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;QACxC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;KAC9C,CAAC;IACF,qEAAqE;IACrE,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,EAAE,EAAE,OAAO,CAAC;CACb;AA+HD,wBAAsB,SAAS,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,eAAe,CAAC,CAsS7E"}