@de-otio/bibcheck 0.1.0 → 0.1.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@de-otio/bibcheck",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Humanities-aware citation verification for CSL-JSON bibliographies. Canonical-edition URL verification, Pandoc-citeproc-style linkage check, structured human-triage worklist generation, and an opt-in project-supplied phrase denylist.",
   "keywords": [
     "citations",

package/dist/databases/worldcat.d.ts

@@ -1,33 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

@@ -1,145 +0,0 @@
-/**
- * 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

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