open-museum-mcp 0.1.0

package/dist/dateParser.js

@@ -0,0 +1,265 @@
+import dynastiesData from './data/dynasties.json' with { type: 'json' };
+const dynasties = dynastiesData;
+const flatDynasties = (() => {
+    const out = {};
+    const seen = new Set();
+    for (const culture of Object.keys(dynasties)) {
+        for (const [period, range] of Object.entries(dynasties[culture])) {
+            const key = period.toLowerCase();
+            if (seen.has(key)) {
+                console.warn(`[open-museum-mcp] dynasty table: duplicate period "${key}" across cultures; last definition wins`);
+            }
+            seen.add(key);
+            out[key] = range;
+        }
+    }
+    return out;
+})();
+const ROMAN = {
+    i: 1, ii: 2, iii: 3, iv: 4, v: 5, vi: 6, vii: 7, viii: 8, ix: 9, x: 10,
+    xi: 11, xii: 12, xiii: 13, xiv: 14, xv: 15, xvi: 16, xvii: 17, xviii: 18,
+    xix: 19, xx: 20, xxi: 21,
+};
+const ORDINAL_WORDS = {
+    first: 1, second: 2, third: 3, fourth: 4, fifth: 5, sixth: 6, seventh: 7,
+    eighth: 8, ninth: 9, tenth: 10, eleventh: 11, twelfth: 12, thirteenth: 13,
+    fourteenth: 14, fifteenth: 15, sixteenth: 16, seventeenth: 17,
+    eighteenth: 18, nineteenth: 19, twentieth: 20, 'twenty-first': 21,
+};
+function ordinalToNumber(token) {
+    const lower = token.toLowerCase();
+    // Check the word dictionary BEFORE stripping suffixes — otherwise hyphenated
+    // forms like "twenty-first" get mangled into "twenty-fir" by the suffix
+    // regex and never match.
+    if (ORDINAL_WORDS[lower] !== undefined)
+        return ORDINAL_WORDS[lower];
+    const stripped = lower.replace(/(st|nd|rd|th)$/, '');
+    if (/^\d+$/.test(stripped))
+        return parseInt(stripped, 10);
+    if (ROMAN[stripped] !== undefined)
+        return ROMAN[stripped];
+    return ORDINAL_WORDS[stripped] ?? null;
+}
+// 19th century CE = 1801–1900 (no year zero, century N spans years
+// (N-1)*100+1 to N*100). qualifier divides the span into thirds; floor()
+// accepts that the 99-year span doesn't divide evenly — close enough for
+// catalog metadata and matches museum convention.
+function centuryRange(n, era, qualifier) {
+    let start, end;
+    if (era === 'ce') {
+        start = (n - 1) * 100 + 1;
+        end = n * 100;
+    }
+    else {
+        end = -((n - 1) * 100 + 1);
+        start = -(n * 100);
+    }
+    const span = end - start;
+    if (qualifier === 'early') {
+        return { yearStart: start, yearEnd: start + Math.floor(span / 3) };
+    }
+    if (qualifier === 'mid' || qualifier === 'middle') {
+        return {
+            yearStart: start + Math.floor(span / 3),
+            yearEnd: end - Math.floor(span / 3),
+        };
+    }
+    if (qualifier === 'late') {
+        return { yearStart: end - Math.floor(span / 3), yearEnd: end };
+    }
+    return { yearStart: start, yearEnd: end };
+}
+// True only when the string carries BOTH a BCE marker and a CE marker —
+// signals a cross-era range that tryRangeRegex must defer on so
+// tryCrossEraRange can handle it correctly.
+function hasMixedEras(s) {
+    const hasBce = /\b(b\.?c\.?e?\.?|bc)\b/i.test(s);
+    if (!hasBce)
+        return false;
+    return /\bce\b/i.test(s) || /\bc\.e\./i.test(s);
+}
+function tryCrossEraRange(s) {
+    const m = s.match(/(\d{1,5})\s*(?:b\.?c\.?e?\.?|bc)\s*[-–]\s*(\d{1,5})\s*(?:c\.?e\.?|ce)/i);
+    if (m) {
+        return {
+            yearStart: -parseInt(m[1], 10),
+            yearEnd: parseInt(m[2], 10),
+        };
+    }
+    return null;
+}
+// Numeric range with optional trailing BCE marker. Bare digits separated by
+// hyphen/en-dash. Note: ordinal-century inputs like "14th-15th century" are
+// NOT matched here because the regex requires the dash to immediately follow
+// digits — the "th" between "14" and "-" breaks the match. Don't relax the
+// regex without locking down that invariant in tests; tryCenturyRange owns
+// ordinal-century parsing.
+function tryRangeRegex(s) {
+    if (hasMixedEras(s))
+        return null;
+    const m = s.match(/(-?\d{1,5})\s*[-–]\s*(-?\d{1,5})\s*(b\.?c\.?e?\.?|bc)?/i);
+    if (m) {
+        const firstStr = m[1];
+        const secondStr = m[2];
+        let a = parseInt(firstStr, 10);
+        let b = parseInt(secondStr, 10);
+        const firstIsCleanFourDigit = !firstStr.startsWith('-') && firstStr.length === 4;
+        const secondIsShortSuffix = !secondStr.startsWith('-') && (secondStr.length === 1 || secondStr.length === 2);
+        // Short-suffix forms expand the second number by reusing digits from the
+        // first: "1820-5" → 1820–1825 (decade rollover), "1899–05" → 1899–1905
+        // (century rollover). When the candidate would land before the start
+        // year, bump it forward by the rollover unit.
+        if (!m[3] && firstIsCleanFourDigit && secondIsShortSuffix) {
+            const decade = Math.floor(a / 10) * 10;
+            const century = Math.floor(a / 100) * 100;
+            const candidateDecade = decade + b;
+            const candidateCentury = century + b;
+            let resolved;
+            if (secondStr.length === 1) {
+                resolved = candidateDecade < a ? candidateDecade + 10 : candidateDecade;
+            }
+            else {
+                resolved = candidateCentury < a ? candidateCentury + 100 : candidateCentury;
+            }
+            return { yearStart: a, yearEnd: resolved };
+        }
+        if (m[3]) {
+            a = -Math.abs(a);
+            b = -Math.abs(b);
+        }
+        return { yearStart: Math.min(a, b), yearEnd: Math.max(a, b) };
+    }
+    return null;
+}
+function tryCenturyRange(s) {
+    const m = s.match(/([\w-]+)\s*[-–]\s*([\w-]+)\s*(?:-|\s)?\s*century\s*(b\.?c\.?e?\.?|bc)?/i);
+    if (!m)
+        return null;
+    const startN = ordinalToNumber(m[1]);
+    const endN = ordinalToNumber(m[2]);
+    if (startN === null || endN === null)
+        return null;
+    const era = m[3] ? 'bce' : 'ce';
+    const startRange = centuryRange(startN, era);
+    const endRange = centuryRange(endN, era);
+    return {
+        yearStart: Math.min(startRange.yearStart, endRange.yearStart),
+        yearEnd: Math.max(startRange.yearEnd, endRange.yearEnd),
+    };
+}
+function tryDecade(s) {
+    const m = s.match(/(?<![\d-])(\d{3,4})s\b/i);
+    if (m) {
+        const y = parseInt(m[1], 10);
+        return { yearStart: y, yearEnd: y + 9 };
+    }
+    return null;
+}
+function trySingleYear(s) {
+    const bce = s.match(/(\d{1,5})\s*(b\.?c\.?e?\.?|bc)\b/i);
+    if (bce) {
+        const y = -parseInt(bce[1], 10);
+        return { yearStart: y, yearEnd: y };
+    }
+    const ce = s.match(/(?<!\w)(\d{1,5})\s*(c\.?e\.?|ce)\b/i);
+    if (ce) {
+        const y = parseInt(ce[1], 10);
+        return { yearStart: y, yearEnd: y };
+    }
+    const circa = s.match(/(?:c\.?|ca\.?|circa|approximately|around|about)\s*(-?\d{1,5})/i);
+    if (circa) {
+        const y = parseInt(circa[1], 10);
+        return { yearStart: y - 5, yearEnd: y + 5 };
+    }
+    const exact = s.match(/(?<![\d-])(\d{3,4})(?![\d-])/);
+    if (exact) {
+        const y = parseInt(exact[1], 10);
+        return { yearStart: y, yearEnd: y };
+    }
+    return null;
+}
+function tryCentury(s) {
+    const qual = s.match(/\b(early|mid|middle|late)\b/i);
+    const qualifier = qual ? qual[1].toLowerCase() : undefined;
+    const stripped = s.replace(/\b(early|mid|middle|late)\b[\s\-]*/i, ' ').trim();
+    const m = stripped.match(/([\w-]+)\s*(?:-|\s)?\s*century\s*(b\.?c\.?e?\.?|bc)?/i);
+    if (!m)
+        return null;
+    const num = ordinalToNumber(m[1]);
+    if (num === null)
+        return null;
+    const era = m[2] ? 'bce' : 'ce';
+    return centuryRange(num, era, qualifier);
+}
+function tryDynasty(s) {
+    const lower = s.toLowerCase();
+    const sorted = Object.keys(flatDynasties).sort((a, b) => b.length - a.length);
+    for (const period of sorted) {
+        if (lower.includes(period)) {
+            const [start, end] = flatDynasties[period];
+            const qual = lower.match(/\b(early|mid|middle|late)\b/);
+            const qualifier = qual ? qual[1] : undefined;
+            const span = end - start;
+            if (qualifier === 'early') {
+                return { yearStart: start, yearEnd: start + Math.floor(span / 3) };
+            }
+            if (qualifier === 'mid' || qualifier === 'middle') {
+                return {
+                    yearStart: start + Math.floor(span / 3),
+                    yearEnd: end - Math.floor(span / 3),
+                };
+            }
+            if (qualifier === 'late') {
+                return { yearStart: end - Math.floor(span / 3), yearEnd: end };
+            }
+            return { yearStart: start, yearEnd: end };
+        }
+    }
+    return null;
+}
+/**
+ * Parse a museum-supplied display date into a {yearStart, yearEnd} range.
+ *
+ * Strategies are tried in this exact order — earlier strategies win:
+ *   1. cross-era range ("500 BCE – 50 CE")
+ *   2. numeric range ("1820–1830", "1820-5", "1899–05")
+ *   3. ordinal-century range ("14th-15th century")
+ *   4. ordinal century with optional early/mid/late qualifier
+ *   5. decade ("1820s")
+ *   6. single year ("1888", "ca. 1820", "500 BCE")
+ *   7. dynasty/period lookup (longest key first to avoid prefix shadowing)
+ *
+ * Returns {null, null} when nothing matches — never guesses. BCE is encoded
+ * as negative integers so range arithmetic Just Works.
+ */
+export function parseDisplayDate(input) {
+    if (!input || typeof input !== 'string') {
+        return { yearStart: null, yearEnd: null };
+    }
+    const s = input.trim();
+    if (!s)
+        return { yearStart: null, yearEnd: null };
+    const cross = tryCrossEraRange(s);
+    if (cross)
+        return cross;
+    const range = tryRangeRegex(s);
+    if (range)
+        return range;
+    const centuryRangeMatch = tryCenturyRange(s);
+    if (centuryRangeMatch)
+        return centuryRangeMatch;
+    const century = tryCentury(s);
+    if (century)
+        return century;
+    const decade = tryDecade(s);
+    if (decade)
+        return decade;
+    const single = trySingleYear(s);
+    if (single)
+        return single;
+    const dynasty = tryDynasty(s);
+    if (dynasty)
+        return dynasty;
+    return { yearStart: null, yearEnd: null };
+}
+//# sourceMappingURL=dateParser.js.map

package/dist/dateParser.js.map

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

package/dist/db.d.ts

@@ -0,0 +1,35 @@
+import type { Artwork } from './types.js';
+export interface CacheConfig {
+    path: string;
+}
+/**
+ * SQLite-backed cache for normalized artworks and search-result IDs.
+ *
+ * TTL contract:
+ *   - `objects` rows live for {@link OBJECT_TTL_DAYS} days. Artworks don't
+ *     change once accessioned, so the long TTL keeps cold-cache HTTP cost low.
+ *   - `query_cache` rows live for {@link QUERY_TTL_DAYS} days. Museums add
+ *     new open-access objects regularly, so queries refresh on a shorter cycle.
+ *
+ * Stale rows are pruned on construction (cheap bulk DELETE) so a long-lived
+ * client doesn't accumulate dead rows indefinitely. Reads also treat expired
+ * rows as misses; the next write overwrites the row via ON CONFLICT.
+ *
+ * The DB file is created with mode 0o600. Parameterized statements only —
+ * no string-concatenated SQL paths.
+ */
+export declare class Cache {
+    private db;
+    constructor(config: CacheConfig);
+    private init;
+    upsertObject(art: Artwork): void;
+    getObject(id: string): Artwork | null;
+    putQuery(cacheKey: string, ids: string[]): void;
+    getQuery(cacheKey: string): string[] | null;
+    pruneExpired(): {
+        objects: number;
+        queries: number;
+    };
+    private isExpired;
+    close(): void;
+}

package/dist/db.js

@@ -0,0 +1,182 @@
+import Database from 'better-sqlite3';
+import { chmodSync, mkdirSync, existsSync } from 'node:fs';
+import { dirname } from 'node:path';
+const OBJECT_TTL_DAYS = 90;
+const QUERY_TTL_DAYS = 14;
+const MS_PER_DAY = 24 * 60 * 60 * 1000;
+/**
+ * SQLite-backed cache for normalized artworks and search-result IDs.
+ *
+ * TTL contract:
+ *   - `objects` rows live for {@link OBJECT_TTL_DAYS} days. Artworks don't
+ *     change once accessioned, so the long TTL keeps cold-cache HTTP cost low.
+ *   - `query_cache` rows live for {@link QUERY_TTL_DAYS} days. Museums add
+ *     new open-access objects regularly, so queries refresh on a shorter cycle.
+ *
+ * Stale rows are pruned on construction (cheap bulk DELETE) so a long-lived
+ * client doesn't accumulate dead rows indefinitely. Reads also treat expired
+ * rows as misses; the next write overwrites the row via ON CONFLICT.
+ *
+ * The DB file is created with mode 0o600. Parameterized statements only —
+ * no string-concatenated SQL paths.
+ */
+export class Cache {
+    db;
+    constructor(config) {
+        if (!existsSync(dirname(config.path))) {
+            mkdirSync(dirname(config.path), { recursive: true, mode: 0o700 });
+        }
+        const fileExisted = existsSync(config.path);
+        this.db = new Database(config.path);
+        if (!fileExisted) {
+            // Tighten file mode immediately on creation so the cache (which can
+            // include rights metadata, snapshots of museum responses, etc.) isn't
+            // group/world-readable under loose umasks.
+            try {
+                chmodSync(config.path, 0o600);
+            }
+            catch {
+                // Best-effort; non-fatal on filesystems that don't support chmod.
+            }
+        }
+        this.db.pragma('journal_mode = WAL');
+        this.init();
+        this.pruneExpired();
+    }
+    init() {
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS objects (
+        id TEXT PRIMARY KEY,
+        museum_code TEXT NOT NULL,
+        title TEXT NOT NULL,
+        artist_name TEXT,
+        attribution_type TEXT NOT NULL,
+        display_date TEXT,
+        year_start INTEGER,
+        year_end INTEGER,
+        medium TEXT,
+        region TEXT,
+        period TEXT,
+        license_type TEXT NOT NULL,
+        full_record TEXT NOT NULL,
+        cached_at TEXT NOT NULL
+      );
+
+      CREATE INDEX IF NOT EXISTS idx_objects_year_start ON objects(year_start);
+      CREATE INDEX IF NOT EXISTS idx_objects_year_end ON objects(year_end);
+      CREATE INDEX IF NOT EXISTS idx_objects_region ON objects(region);
+      CREATE INDEX IF NOT EXISTS idx_objects_period ON objects(period);
+      CREATE INDEX IF NOT EXISTS idx_objects_artist ON objects(artist_name);
+      CREATE INDEX IF NOT EXISTS idx_objects_museum ON objects(museum_code);
+
+      CREATE TABLE IF NOT EXISTS query_cache (
+        cache_key TEXT PRIMARY KEY,
+        ids_json TEXT NOT NULL,
+        cached_at TEXT NOT NULL
+      );
+
+      -- Forward-compat scaffold for v1.0 artist obscurity scoring across the
+      -- federated corpus. Not yet populated; do not depend on these columns.
+      CREATE TABLE IF NOT EXISTS artists (
+        name TEXT PRIMARY KEY,
+        object_count INTEGER NOT NULL DEFAULT 0,
+        museum_count INTEGER NOT NULL DEFAULT 0,
+        museums_json TEXT NOT NULL DEFAULT '[]'
+      );
+    `);
+    }
+    upsertObject(art) {
+        const stmt = this.db.prepare(`
+      INSERT INTO objects (
+        id, museum_code, title, artist_name, attribution_type,
+        display_date, year_start, year_end, medium, region, period,
+        license_type, full_record, cached_at
+      ) VALUES (
+        @id, @museum_code, @title, @artist_name, @attribution_type,
+        @display_date, @year_start, @year_end, @medium, @region, @period,
+        @license_type, @full_record, @cached_at
+      )
+      ON CONFLICT(id) DO UPDATE SET
+        title = excluded.title,
+        artist_name = excluded.artist_name,
+        attribution_type = excluded.attribution_type,
+        display_date = excluded.display_date,
+        year_start = excluded.year_start,
+        year_end = excluded.year_end,
+        medium = excluded.medium,
+        region = excluded.region,
+        period = excluded.period,
+        license_type = excluded.license_type,
+        full_record = excluded.full_record,
+        cached_at = excluded.cached_at
+    `);
+        stmt.run({
+            id: art.id,
+            museum_code: art.museum.code,
+            title: art.title,
+            artist_name: art.artist.name,
+            attribution_type: art.artist.attributionType,
+            display_date: art.displayDate,
+            year_start: art.yearStart,
+            year_end: art.yearEnd,
+            medium: art.medium,
+            region: art.region,
+            period: art.period,
+            license_type: art.license.type,
+            full_record: JSON.stringify(art),
+            cached_at: new Date().toISOString(),
+        });
+    }
+    getObject(id) {
+        const row = this.db.prepare(`SELECT full_record, cached_at FROM objects WHERE id = ?`).get(id);
+        if (!row)
+            return null;
+        if (this.isExpired(row.cached_at, OBJECT_TTL_DAYS))
+            return null;
+        try {
+            return JSON.parse(row.full_record);
+        }
+        catch {
+            // A malformed row (manual DB tinkering, OS-level corruption, schema
+            // drift from a prior version) shouldn't poison the request — treat it
+            // as a cache miss; the next write will overwrite the row.
+            return null;
+        }
+    }
+    putQuery(cacheKey, ids) {
+        this.db
+            .prepare(`INSERT INTO query_cache (cache_key, ids_json, cached_at)
+         VALUES (?, ?, ?)
+         ON CONFLICT(cache_key) DO UPDATE SET ids_json = excluded.ids_json, cached_at = excluded.cached_at`)
+            .run(cacheKey, JSON.stringify(ids), new Date().toISOString());
+    }
+    getQuery(cacheKey) {
+        const row = this.db.prepare(`SELECT ids_json, cached_at FROM query_cache WHERE cache_key = ?`).get(cacheKey);
+        if (!row)
+            return null;
+        if (this.isExpired(row.cached_at, QUERY_TTL_DAYS))
+            return null;
+        try {
+            return JSON.parse(row.ids_json);
+        }
+        catch {
+            return null;
+        }
+    }
+    pruneExpired() {
+        const objectsCutoff = new Date(Date.now() - OBJECT_TTL_DAYS * MS_PER_DAY).toISOString();
+        const queriesCutoff = new Date(Date.now() - QUERY_TTL_DAYS * MS_PER_DAY).toISOString();
+        const objects = this.db.prepare(`DELETE FROM objects WHERE cached_at < ?`).run(objectsCutoff);
+        const queries = this.db.prepare(`DELETE FROM query_cache WHERE cached_at < ?`).run(queriesCutoff);
+        return { objects: objects.changes, queries: queries.changes };
+    }
+    isExpired(isoTimestamp, ttlDays) {
+        const cachedAt = new Date(isoTimestamp).getTime();
+        const expiresAt = cachedAt + ttlDays * MS_PER_DAY;
+        return Date.now() > expiresAt;
+    }
+    close() {
+        this.db.close();
+    }
+}
+//# sourceMappingURL=db.js.map

package/dist/db.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"db.js","sourceRoot":"","sources":["../src/db.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AACtC,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC3D,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,MAAM,eAAe,GAAG,EAAE,CAAC;AAC3B,MAAM,cAAc,GAAG,EAAE,CAAC;AAC1B,MAAM,UAAU,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAMvC;;;;;;;;;;;;;;;GAeG;AACH,MAAM,OAAO,KAAK;IACR,EAAE,CAAoB;IAE9B,YAAY,MAAmB;QAC7B,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;YACtC,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QACpE,CAAC;QACD,MAAM,WAAW,GAAG,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC5C,IAAI,CAAC,EAAE,GAAG,IAAI,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACpC,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,oEAAoE;YACpE,sEAAsE;YACtE,2CAA2C;YAC3C,IAAI,CAAC;gBACH,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;YAChC,CAAC;YAAC,MAAM,CAAC;gBACP,kEAAkE;YACpE,CAAC;QACH,CAAC;QACD,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;QACrC,IAAI,CAAC,IAAI,EAAE,CAAC;QACZ,IAAI,CAAC,YAAY,EAAE,CAAC;IACtB,CAAC;IAEO,IAAI;QACV,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAuCZ,CAAC,CAAC;IACL,CAAC;IAED,YAAY,CAAC,GAAY;QACvB,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC;;;;;;;;;;;;;;;;;;;;;;;KAuB5B,CAAC,CAAC;QAEH,IAAI,CAAC,GAAG,CAAC;YACP,EAAE,EAAE,GAAG,CAAC,EAAE;YACV,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC,IAAI;YAC5B,KAAK,EAAE,GAAG,CAAC,KAAK;YAChB,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC,IAAI;YAC5B,gBAAgB,EAAE,GAAG,CAAC,MAAM,CAAC,eAAe;YAC5C,YAAY,EAAE,GAAG,CAAC,WAAW;YAC7B,UAAU,EAAE,GAAG,CAAC,SAAS;YACzB,QAAQ,EAAE,GAAG,CAAC,OAAO;YACrB,MAAM,EAAE,GAAG,CAAC,MAAM;YAClB,MAAM,EAAE,GAAG,CAAC,MAAM;YAClB,MAAM,EAAE,GAAG,CAAC,MAAM;YAClB,YAAY,EAAE,GAAG,CAAC,OAAO,CAAC,IAAI;YAC9B,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC;YAChC,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACpC,CAAC,CAAC;IACL,CAAC;IAED,SAAS,CAAC,EAAU;QAClB,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,yDAAyD,CAAC,CAAC,GAAG,CAAC,EAAE,CAEhF,CAAC;QACd,IAAI,CAAC,GAAG;YAAE,OAAO,IAAI,CAAC;QACtB,IAAI,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS,EAAE,eAAe,CAAC;YAAE,OAAO,IAAI,CAAC;QAChE,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,CAAY,CAAC;QAChD,CAAC;QAAC,MAAM,CAAC;YACP,oEAAoE;YACpE,sEAAsE;YACtE,0DAA0D;YAC1D,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,QAAQ,CAAC,QAAgB,EAAE,GAAa;QACtC,IAAI,CAAC,EAAE;aACJ,OAAO,CACN;;2GAEmG,CACpG;aACA,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC;IAClE,CAAC;IAED,QAAQ,CAAC,QAAgB;QACvB,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,iEAAiE,CAAC,CAAC,GAAG,CAAC,QAAQ,CAE9F,CAAC;QACd,IAAI,CAAC,GAAG;YAAE,OAAO,IAAI,CAAC;QACtB,IAAI,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS,EAAE,cAAc,CAAC;YAAE,OAAO,IAAI,CAAC;QAC/D,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAa,CAAC;QAC9C,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,YAAY;QACV,MAAM,aAAa,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,eAAe,GAAG,UAAU,CAAC,CAAC,WAAW,EAAE,CAAC;QACxF,MAAM,aAAa,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,cAAc,GAAG,UAAU,CAAC,CAAC,WAAW,EAAE,CAAC;QACvF,MAAM,OAAO,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,yCAAyC,CAAC,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QAC9F,MAAM,OAAO,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,6CAA6C,CAAC,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QAClG,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC;IAChE,CAAC;IAEO,SAAS,CAAC,YAAoB,EAAE,OAAe;QACrD,MAAM,QAAQ,GAAG,IAAI,IAAI,CAAC,YAAY,CAAC,CAAC,OAAO,EAAE,CAAC;QAClD,MAAM,SAAS,GAAG,QAAQ,GAAG,OAAO,GAAG,UAAU,CAAC;QAClD,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;IAChC,CAAC;IAED,KAAK;QACH,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC;IAClB,CAAC;CACF"}

package/dist/fetchers/met.d.ts

@@ -0,0 +1,2 @@
+import type { Fetcher } from './types.js';
+export declare const metFetcher: Fetcher;

package/dist/fetchers/met.js

@@ -0,0 +1,132 @@
+import { parseDisplayDate } from '../dateParser.js';
+import { validateMetLicense } from '../licenseGate.js';
+import { cleanArtistName, detectAttributionType, normalizeRegion } from '../mappings.js';
+const MET_API = 'https://collectionapi.metmuseum.org/public/collection/v1';
+function asString(v) {
+    return typeof v === 'string' ? v : '';
+}
+function asOptionalString(v) {
+    return typeof v === 'string' && v.length > 0 ? v : undefined;
+}
+export const metFetcher = {
+    code: 'met',
+    name: 'The Metropolitan Museum of Art',
+    async search(query, limit, options = {}) {
+        const url = new URL(`${MET_API}/search`);
+        url.searchParams.set('q', query);
+        if (options.hasImage !== false) {
+            url.searchParams.set('hasImages', 'true');
+        }
+        url.searchParams.set('isPublicDomain', 'true');
+        const res = await fetch(url);
+        if (!res.ok)
+            throw new Error(`Met search failed: ${res.status}`);
+        const json = (await res.json());
+        const ids = json.objectIDs ?? [];
+        return ids.slice(0, limit).map((n) => `met:${n}`);
+    },
+    async getRaw(id) {
+        const numeric = id.replace(/^met:/, '');
+        const res = await fetch(`${MET_API}/objects/${numeric}`);
+        if (!res.ok)
+            throw new Error(`Met get failed for ${id}: ${res.status}`);
+        return res.json();
+    },
+    normalize(raw) {
+        if (!raw || typeof raw !== 'object') {
+            return {
+                status: 'rejected',
+                rejection: {
+                    id: 'met:unknown',
+                    museumCode: 'met',
+                    reason: 'response not an object',
+                    rawSnapshot: raw,
+                },
+            };
+        }
+        const r = raw;
+        const objectID = r.objectID;
+        // Met IDs are always positive integers. Anything else flunks ID_REGEX
+        // downstream; emit a placeholder so the rejection still carries a stable
+        // (and obviously bogus) id for logs.
+        const validId = typeof objectID === 'number' && Number.isInteger(objectID) && objectID > 0;
+        const id = validId ? `met:${objectID}` : 'met:unknown';
+        const decision = validateMetLicense(raw);
+        if (!decision.accepted || !decision.license) {
+            return {
+                status: 'rejected',
+                rejection: {
+                    id,
+                    museumCode: 'met',
+                    reason: decision.reason,
+                    rawSnapshot: raw,
+                },
+            };
+        }
+        if (!validId) {
+            return {
+                status: 'rejected',
+                rejection: {
+                    id,
+                    museumCode: 'met',
+                    reason: 'met: missing or non-integer objectID',
+                    rawSnapshot: raw,
+                },
+            };
+        }
+        const displayDate = asString(r.objectDate);
+        const dateRange = parseDisplayDate(displayDate);
+        const artistRaw = asString(r.artistDisplayName);
+        const attributionType = detectAttributionType(artistRaw);
+        const cleanName = cleanArtistName(artistRaw);
+        const cultureOrCountry = asString(r.culture) || asString(r.country) || asString(r.classification);
+        const region = normalizeRegion(cultureOrCountry);
+        const periodRaw = (asString(r.period) || asString(r.dynasty)).toLowerCase().trim();
+        const period = periodRaw.replace(/\s*\([^)]*\)\s*$/, '').trim() || null;
+        const fullImage = asString(r.primaryImage) || asString(r.primaryImageSmall);
+        const thumbnail = asOptionalString(r.primaryImageSmall);
+        const beginDate = asString(r.artistBeginDate);
+        const endDate = asString(r.artistEndDate);
+        const lifespan = beginDate || endDate ? `${beginDate}–${endDate}`.replace(/^–|–$/g, '') : undefined;
+        const artwork = {
+            id,
+            museum: {
+                code: 'met',
+                name: 'The Metropolitan Museum of Art',
+                url: 'https://www.metmuseum.org',
+            },
+            title: (asString(r.title) || '(Untitled)').trim(),
+            artist: {
+                name: cleanName || 'Unknown',
+                nationality: asOptionalString(r.artistNationality),
+                lifespan,
+                attributionType,
+            },
+            displayDate,
+            yearStart: dateRange.yearStart,
+            yearEnd: dateRange.yearEnd,
+            medium: asString(r.medium),
+            region,
+            period,
+            imageUrls: {
+                full: fullImage,
+                thumbnail,
+            },
+            imageOpenAccess: decision.imageOpenAccess,
+            metadataOpenAccess: decision.metadataOpenAccess,
+            license: decision.license,
+            source: {
+                apiUrl: `${MET_API}/objects/${objectID}`,
+                pageUrl: asString(r.objectURL) || `https://www.metmuseum.org/art/collection/search/${objectID}`,
+            },
+            description: asOptionalString(r.objectName),
+            rawTags: Array.isArray(r.tags)
+                ? r.tags
+                    .map((t) => (t && typeof t === 'object' ? t.term : undefined))
+                    .filter((s) => typeof s === 'string')
+                : undefined,
+        };
+        return { status: 'accepted', artwork };
+    },
+};
+//# sourceMappingURL=met.js.map

package/dist/fetchers/met.js.map

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

package/dist/fetchers/types.d.ts

@@ -0,0 +1,11 @@
+import type { ValidationResult } from '../types.js';
+export interface SearchOptions {
+    hasImage?: boolean;
+}
+export interface Fetcher {
+    code: string;
+    name: string;
+    search(query: string, limit: number, options?: SearchOptions): Promise<string[]>;
+    getRaw(id: string): Promise<unknown>;
+    normalize(raw: unknown): ValidationResult;
+}