labre-mcp 0.1.0

package/dist/lib/patent/mock-patent-source.d.mts

@@ -0,0 +1,285 @@
+import { PatentDataSource, emptyPatentData } from './patent-data-source.mjs';
+import type { PatentData } from '../../types/patent.mjs';
+/**
+ * Mature technology: high certitude, high ubiquity signals.
+ * Concentrated CPC distribution, stable taxonomy, high citations,
+ * narrowing claims, many assignees, broad geo, cross-sector, mostly expired.
+ * Expected evolution: Commodity (>= 0.70)
+ *
+ * @returns {import('./patent-data-source.mjs').PatentData}
+ */
+declare function commodityFixture(): {
+    totalPatents: number;
+    cpcDistribution: {
+        cpc: string;
+        count: number;
+    }[];
+    yearlyClassifications: {
+        year: number;
+        cpcCodes: string[];
+    }[];
+    citationData: {
+        totalForwardCitations: number;
+        patentCount: number;
+    };
+    claimsTimeline: {
+        year: number;
+        avgIndependentClaims: number;
+    }[];
+    assigneeData: {
+        uniqueAssignees: number;
+        totalPatents: number;
+    };
+    geoData: {
+        jurisdictionCount: number;
+        jurisdictions: string[];
+    };
+    sectorData: {
+        uniqueSections: number;
+        uniqueClasses: number;
+    };
+    expirationData: {
+        expiredCount: number;
+        totalPatents: number;
+    };
+};
+/**
+ * Nascent technology: low certitude, low ubiquity signals.
+ * Even CPC distribution, unstable taxonomy, few citations,
+ * expanding claims, few assignees, single jurisdiction, one sector, none expired.
+ * Expected evolution: Genesis/Custom (<= 0.26)
+ *
+ * @returns {import('./patent-data-source.mjs').PatentData}
+ */
+declare function genesisFixture(): {
+    totalPatents: number;
+    cpcDistribution: {
+        cpc: string;
+        count: number;
+    }[];
+    yearlyClassifications: {
+        year: number;
+        cpcCodes: string[];
+    }[];
+    citationData: {
+        totalForwardCitations: number;
+        patentCount: number;
+    };
+    claimsTimeline: {
+        year: number;
+        avgIndependentClaims: number;
+    }[];
+    assigneeData: {
+        uniqueAssignees: number;
+        totalPatents: number;
+    };
+    geoData: {
+        jurisdictionCount: number;
+        jurisdictions: string[];
+    };
+    sectorData: {
+        uniqueSections: number;
+        uniqueClasses: number;
+    };
+    expirationData: {
+        expiredCount: number;
+        totalPatents: number;
+    };
+};
+/**
+ * Mid-range technology: moderate certitude and ubiquity signals.
+ * Mixed CPC distribution, some stability, moderate citations,
+ * moderate assignees, mid geo coverage, some cross-sector, some expired.
+ * Expected evolution: Product (0.26 - 0.70)
+ *
+ * @returns {import('./patent-data-source.mjs').PatentData}
+ */
+declare function productFixture(): {
+    totalPatents: number;
+    cpcDistribution: {
+        cpc: string;
+        count: number;
+    }[];
+    yearlyClassifications: {
+        year: number;
+        cpcCodes: string[];
+    }[];
+    citationData: {
+        totalForwardCitations: number;
+        patentCount: number;
+    };
+    claimsTimeline: {
+        year: number;
+        avgIndependentClaims: number;
+    }[];
+    assigneeData: {
+        uniqueAssignees: number;
+        totalPatents: number;
+    };
+    geoData: {
+        jurisdictionCount: number;
+        jurisdictions: string[];
+    };
+    sectorData: {
+        uniqueSections: number;
+        uniqueClasses: number;
+    };
+    expirationData: {
+        expiredCount: number;
+        totalPatents: number;
+    };
+};
+/**
+ * Sparse data: very few patents for testing confidence degradation.
+ * Expected: low data quality score, low confidence.
+ *
+ * @returns {import('./patent-data-source.mjs').PatentData}
+ */
+declare function sparseFixture(): {
+    totalPatents: number;
+    cpcDistribution: {
+        cpc: string;
+        count: number;
+    }[];
+    yearlyClassifications: {
+        year: number;
+        cpcCodes: string[];
+    }[];
+    citationData: {
+        totalForwardCitations: number;
+        patentCount: number;
+    };
+    claimsTimeline: {
+        year: number;
+        avgIndependentClaims: number;
+    }[];
+    assigneeData: {
+        uniqueAssignees: number;
+        totalPatents: number;
+    };
+    geoData: {
+        jurisdictionCount: number;
+        jurisdictions: string[];
+    };
+    sectorData: {
+        uniqueSections: number;
+        uniqueClasses: number;
+    };
+    expirationData: {
+        expiredCount: number;
+        totalPatents: number;
+    };
+};
+/**
+ * Named fixture map for convenient access.
+ * Each value is a factory function returning a fresh copy (no shared state).
+ */
+export declare const FIXTURES: Readonly<{
+    commodity: typeof commodityFixture;
+    genesis: typeof genesisFixture;
+    product: typeof productFixture;
+    empty: typeof emptyPatentData;
+    sparse: typeof sparseFixture;
+}>;
+/**
+ * Test adapter implementing PatentDataSource interface.
+ *
+ * Extends PatentDataSource so it passes `instanceof` checks and inherits
+ * the default fetchIndicators() composition (fetchByCpc → computeAllIndicators).
+ *
+ * Configuration:
+ *   - data:       PatentData fixture to return (default: emptyPatentData)
+ *   - error:      Error to throw from fetchByCpc (simulates failures)
+ *   - delay:      Milliseconds to delay fetchByCpc (simulates latency)
+ *   - perCpc:     Map of CPC code → PatentData for per-code responses
+ *   - onFetch:    Optional callback(cpcCodes) invoked on each fetchByCpc call
+ *
+ * Instrumentation:
+ *   - callCount:  Number of fetchByCpc calls
+ *   - lastArgs:   Last CPC codes passed to fetchByCpc
+ *   - calls:      Array of all { cpcCodes, timestamp } call records
+ *   - closed:     Whether close() was called
+ *
+ * @extends PatentDataSource
+ */
+export declare class MockPatentSource extends PatentDataSource {
+    _data: PatentData | (() => PatentData) | null;
+    _error: Error | null;
+    _delay: number;
+    _perCpc: Map<string, PatentData | (() => PatentData)> | null;
+    _onFetch: ((cpcCodes: string[]) => void) | null;
+    callCount: number;
+    lastArgs: string[] | null;
+    calls: Array<{
+        cpcCodes: string[];
+        timestamp: number;
+    }>;
+    closed: boolean;
+    /**
+     * @param {Object} [options]
+     * @param {import('./patent-data-source.mjs').PatentData|function():import('./patent-data-source.mjs').PatentData} [options.data]
+     *   Fixed patent data to return, or a factory function that produces it.
+     *   Default: emptyPatentData().
+     * @param {Error} [options.error]
+     *   If set, fetchByCpc will throw this error instead of returning data.
+     * @param {number} [options.delay]
+     *   Milliseconds to delay before returning (simulates network latency).
+     * @param {Map<string, import('./patent-data-source.mjs').PatentData>|Object} [options.perCpc]
+     *   Per-CPC-code responses. If a queried CPC code is found here, its data
+     *   is returned instead of the default. Keys are CPC codes (e.g. 'H04L').
+     * @param {function(string[]): void} [options.onFetch]
+     *   Optional callback invoked with the CPC codes on each fetchByCpc call.
+     */
+    constructor(options?: {
+        data?: PatentData | (() => PatentData);
+        error?: Error;
+        delay?: number;
+        perCpc?: Map<string, PatentData | (() => PatentData)> | Record<string, PatentData | (() => PatentData)>;
+        onFetch?: (cpcCodes: string[]) => void;
+    });
+    /**
+     * Fetch patent data by CPC codes.
+     *
+     * Returns the configured fixture data (or throws the configured error).
+     * Records each call in the instrumentation properties.
+     *
+     * Implements PatentDataSource.fetchByCpc() contract:
+     *   - Accepts string[] of CPC codes
+     *   - Returns Promise<PatentData>
+     *   - May throw on error
+     *
+     * @param {string[]} cpcCodes - Array of 4-char CPC sub-class codes
+     * @returns {Promise<import('./patent-data-source.mjs').PatentData>}
+     */
+    fetchByCpc(cpcCodes: string[]): Promise<PatentData>;
+    /**
+     * Lifecycle cleanup.
+     * Sets the `closed` flag for test assertions.
+     *
+     * @returns {Promise<void>}
+     */
+    close(): Promise<void>;
+    /**
+     * Reset all instrumentation counters.
+     * Useful when reusing a mock across multiple test cases.
+     */
+    reset(): void;
+}
+/**
+ * Create a MockPatentSource pre-loaded with a named fixture.
+ *
+ * @param {'commodity'|'genesis'|'product'|'empty'|'sparse'} fixtureName
+ * @param {Object} [options] - Additional MockPatentSource options (merged with fixture)
+ * @returns {MockPatentSource}
+ */
+export declare function createMockSource(fixtureName: string, options?: Record<string, unknown>): MockPatentSource;
+/**
+ * Create a MockPatentSource that simulates a specific error.
+ *
+ * @param {string} [message='Mock BigQuery error'] - Error message
+ * @param {Object} [options] - Additional MockPatentSource options
+ * @returns {MockPatentSource}
+ */
+export declare function createErrorSource(message?: string, options?: {}): MockPatentSource;
+export {};
+//# sourceMappingURL=mock-patent-source.d.mts.map

package/dist/lib/patent/mock-patent-source.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-patent-source.d.mts","sourceRoot":"","sources":["../../../src/lib/patent/mock-patent-source.mts"],"names":[],"mappings":"AAuBA,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAsB,MAAM,0BAA0B,CAAC;AACjG,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAIzD;;;;;;;GAOG;AACH,iBAAS,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA2BxB;AAED;;;;;;;GAOG;AACH,iBAAS,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAsBtB;AAED;;;;;;;GAOG;AACH,iBAAS,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAyBtB;AAED;;;;;GAKG;AACH,iBAAS,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmBrB;AAED;;;GAGG;AACH,eAAO,MAAM,QAAQ;;;;;;EAMnB,CAAC;AAIH;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,gBAAiB,SAAQ,gBAAgB;IAIpD,KAAK,EAAE,UAAU,GAAG,CAAC,MAAM,UAAU,CAAC,GAAG,IAAI,CAAC;IAC9C,MAAM,EAAE,KAAK,GAAG,IAAI,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,GAAG,CAAC,MAAM,UAAU,CAAC,CAAC,GAAG,IAAI,CAAC;IAC7D,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAC1B,KAAK,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACxD,MAAM,EAAE,OAAO,CAAC;IAEhB;;;;;;;;;;;;;;OAcG;gBACS,OAAO,GAAE;QACnB,IAAI,CAAC,EAAE,UAAU,GAAG,CAAC,MAAM,UAAU,CAAC,CAAC;QACvC,KAAK,CAAC,EAAE,KAAK,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,GAAG,CAAC,MAAM,UAAU,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,UAAU,GAAG,CAAC,MAAM,UAAU,CAAC,CAAC,CAAC;QACxG,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;KACnC;IAmBN;;;;;;;;;;;;;OAaG;IACG,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,UAAU,CAAC;IAwCzD;;;;;OAKG;IACG,KAAK;IAIX;;;OAGG;IACH,KAAK;CAMN;AAID;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,oBAQ1F;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,SAAwB,EAAE,OAAO,KAAK,oBAE9E"}

package/dist/lib/patent/mock-patent-source.mjs

@@ -0,0 +1,321 @@
+// MockPatentSource: test adapter implementing PatentDataSource interface.
+//
+// Provides configurable fixture data for testing — swappable anywhere
+// BigQueryPatentSource (or any PatentDataSource) is expected.
+//
+// Includes pre-built fixture factories for common scenarios:
+//   - commodity:  mature technology (high certitude, high ubiquity)
+//   - genesis:    nascent technology (low certitude, low ubiquity)
+//   - product:    mid-range technology (moderate signals)
+//   - empty:      zero patents (tests confidence degradation)
+//   - sparse:     few patents (tests data quality thresholds)
+//
+// Usage:
+//   import { MockPatentSource, FIXTURES } from './mock-patent-source.mjs';
+//   const source = new MockPatentSource(FIXTURES.commodity);
+//   const strategy = new CpcEvolutionStrategy({ patentSource: source });
+//
+// The adapter tracks calls for assertion in tests:
+//   source.callCount   — number of fetchByCpc calls
+//   source.lastArgs    — last CPC codes passed to fetchByCpc
+//   source.calls       — full history of all calls
+//   source.closed      — whether close() was called
+import { PatentDataSource, emptyPatentData } from './patent-data-source.mjs';
+// ─── Pre-built fixture data ─────────────────────────────────────────────────
+/**
+ * Mature technology: high certitude, high ubiquity signals.
+ * Concentrated CPC distribution, stable taxonomy, high citations,
+ * narrowing claims, many assignees, broad geo, cross-sector, mostly expired.
+ * Expected evolution: Commodity (>= 0.70)
+ *
+ * @returns {import('./patent-data-source.mjs').PatentData}
+ */
+function commodityFixture() {
+    return {
+        totalPatents: 500,
+        cpcDistribution: [
+            { cpc: 'H04L', count: 350 },
+            { cpc: 'G06F', count: 100 },
+            { cpc: 'H04W', count: 50 },
+        ],
+        yearlyClassifications: [
+            { year: 2017, cpcCodes: ['H04L', 'G06F'] },
+            { year: 2018, cpcCodes: ['H04L', 'G06F', 'H04W'] },
+            { year: 2019, cpcCodes: ['H04L', 'G06F', 'H04W'] },
+            { year: 2020, cpcCodes: ['H04L', 'G06F', 'H04W'] },
+            { year: 2021, cpcCodes: ['H04L', 'G06F', 'H04W'] },
+        ],
+        citationData: { totalForwardCitations: 8000, patentCount: 500 },
+        claimsTimeline: [
+            { year: 2015, avgIndependentClaims: 12 },
+            { year: 2017, avgIndependentClaims: 8 },
+            { year: 2019, avgIndependentClaims: 5 },
+            { year: 2021, avgIndependentClaims: 3 },
+        ],
+        assigneeData: { uniqueAssignees: 200, totalPatents: 500 },
+        geoData: { jurisdictionCount: 8, jurisdictions: ['US', 'EP', 'CN', 'JP', 'KR', 'IN', 'BR', 'AU'] },
+        sectorData: { uniqueSections: 5, uniqueClasses: 20 },
+        expirationData: { expiredCount: 350, totalPatents: 500 },
+    };
+}
+/**
+ * Nascent technology: low certitude, low ubiquity signals.
+ * Even CPC distribution, unstable taxonomy, few citations,
+ * expanding claims, few assignees, single jurisdiction, one sector, none expired.
+ * Expected evolution: Genesis/Custom (<= 0.26)
+ *
+ * @returns {import('./patent-data-source.mjs').PatentData}
+ */
+function genesisFixture() {
+    return {
+        totalPatents: 8,
+        cpcDistribution: [
+            { cpc: 'G06N', count: 3 },
+            { cpc: 'H10N', count: 3 },
+            { cpc: 'B82Y', count: 2 },
+        ],
+        yearlyClassifications: [
+            { year: 2022, cpcCodes: ['G06N'] },
+            { year: 2023, cpcCodes: ['G06N', 'H10N', 'B82Y'] },
+        ],
+        citationData: { totalForwardCitations: 2, patentCount: 8 },
+        claimsTimeline: [
+            { year: 2022, avgIndependentClaims: 15 },
+            { year: 2023, avgIndependentClaims: 18 },
+        ],
+        assigneeData: { uniqueAssignees: 4, totalPatents: 8 },
+        geoData: { jurisdictionCount: 1, jurisdictions: ['US'] },
+        sectorData: { uniqueSections: 1, uniqueClasses: 2 },
+        expirationData: { expiredCount: 0, totalPatents: 8 },
+    };
+}
+/**
+ * Mid-range technology: moderate certitude and ubiquity signals.
+ * Mixed CPC distribution, some stability, moderate citations,
+ * moderate assignees, mid geo coverage, some cross-sector, some expired.
+ * Expected evolution: Product (0.26 - 0.70)
+ *
+ * @returns {import('./patent-data-source.mjs').PatentData}
+ */
+function productFixture() {
+    return {
+        totalPatents: 150,
+        cpcDistribution: [
+            { cpc: 'G06F', count: 60 },
+            { cpc: 'H04L', count: 50 },
+            { cpc: 'G06Q', count: 40 },
+        ],
+        yearlyClassifications: [
+            { year: 2018, cpcCodes: ['G06F', 'H04L'] },
+            { year: 2019, cpcCodes: ['G06F', 'H04L', 'G06Q'] },
+            { year: 2020, cpcCodes: ['G06F', 'H04L', 'G06Q'] },
+            { year: 2021, cpcCodes: ['G06F', 'H04L', 'G06Q'] },
+        ],
+        citationData: { totalForwardCitations: 1200, patentCount: 150 },
+        claimsTimeline: [
+            { year: 2017, avgIndependentClaims: 10 },
+            { year: 2019, avgIndependentClaims: 7 },
+            { year: 2021, avgIndependentClaims: 5 },
+        ],
+        assigneeData: { uniqueAssignees: 45, totalPatents: 150 },
+        geoData: { jurisdictionCount: 4, jurisdictions: ['US', 'EP', 'CN', 'JP'] },
+        sectorData: { uniqueSections: 2, uniqueClasses: 8 },
+        expirationData: { expiredCount: 30, totalPatents: 150 },
+    };
+}
+/**
+ * Sparse data: very few patents for testing confidence degradation.
+ * Expected: low data quality score, low confidence.
+ *
+ * @returns {import('./patent-data-source.mjs').PatentData}
+ */
+function sparseFixture() {
+    return {
+        totalPatents: 3,
+        cpcDistribution: [
+            { cpc: 'G06N', count: 2 },
+            { cpc: 'B25J', count: 1 },
+        ],
+        yearlyClassifications: [
+            { year: 2023, cpcCodes: ['G06N', 'B25J'] },
+        ],
+        citationData: { totalForwardCitations: 1, patentCount: 3 },
+        claimsTimeline: [
+            { year: 2023, avgIndependentClaims: 12 },
+        ],
+        assigneeData: { uniqueAssignees: 2, totalPatents: 3 },
+        geoData: { jurisdictionCount: 1, jurisdictions: ['US'] },
+        sectorData: { uniqueSections: 1, uniqueClasses: 2 },
+        expirationData: { expiredCount: 0, totalPatents: 3 },
+    };
+}
+/**
+ * Named fixture map for convenient access.
+ * Each value is a factory function returning a fresh copy (no shared state).
+ */
+export const FIXTURES = Object.freeze({
+    commodity: commodityFixture,
+    genesis: genesisFixture,
+    product: productFixture,
+    empty: emptyPatentData,
+    sparse: sparseFixture,
+});
+// ─── MockPatentSource class ─────────────────────────────────────────────────
+/**
+ * Test adapter implementing PatentDataSource interface.
+ *
+ * Extends PatentDataSource so it passes `instanceof` checks and inherits
+ * the default fetchIndicators() composition (fetchByCpc → computeAllIndicators).
+ *
+ * Configuration:
+ *   - data:       PatentData fixture to return (default: emptyPatentData)
+ *   - error:      Error to throw from fetchByCpc (simulates failures)
+ *   - delay:      Milliseconds to delay fetchByCpc (simulates latency)
+ *   - perCpc:     Map of CPC code → PatentData for per-code responses
+ *   - onFetch:    Optional callback(cpcCodes) invoked on each fetchByCpc call
+ *
+ * Instrumentation:
+ *   - callCount:  Number of fetchByCpc calls
+ *   - lastArgs:   Last CPC codes passed to fetchByCpc
+ *   - calls:      Array of all { cpcCodes, timestamp } call records
+ *   - closed:     Whether close() was called
+ *
+ * @extends PatentDataSource
+ */
+export class MockPatentSource extends PatentDataSource {
+    // Class field declarations (TypeScript requires these to exist on the type).
+    // Runtime values are set in the constructor — types are intentionally loose
+    // at this migration step.
+    _data;
+    _error;
+    _delay;
+    _perCpc;
+    _onFetch;
+    callCount;
+    lastArgs;
+    calls;
+    closed;
+    /**
+     * @param {Object} [options]
+     * @param {import('./patent-data-source.mjs').PatentData|function():import('./patent-data-source.mjs').PatentData} [options.data]
+     *   Fixed patent data to return, or a factory function that produces it.
+     *   Default: emptyPatentData().
+     * @param {Error} [options.error]
+     *   If set, fetchByCpc will throw this error instead of returning data.
+     * @param {number} [options.delay]
+     *   Milliseconds to delay before returning (simulates network latency).
+     * @param {Map<string, import('./patent-data-source.mjs').PatentData>|Object} [options.perCpc]
+     *   Per-CPC-code responses. If a queried CPC code is found here, its data
+     *   is returned instead of the default. Keys are CPC codes (e.g. 'H04L').
+     * @param {function(string[]): void} [options.onFetch]
+     *   Optional callback invoked with the CPC codes on each fetchByCpc call.
+     */
+    constructor(options = {}) {
+        super();
+        // Configuration
+        this._data = options.data ?? null;
+        this._error = options.error ?? null;
+        this._delay = options.delay ?? 0;
+        this._perCpc = options.perCpc instanceof Map
+            ? options.perCpc
+            : options.perCpc ? new Map(Object.entries(options.perCpc)) : null;
+        this._onFetch = options.onFetch ?? null;
+        // Instrumentation
+        this.callCount = 0;
+        this.lastArgs = null;
+        this.calls = [];
+        this.closed = false;
+    }
+    /**
+     * Fetch patent data by CPC codes.
+     *
+     * Returns the configured fixture data (or throws the configured error).
+     * Records each call in the instrumentation properties.
+     *
+     * Implements PatentDataSource.fetchByCpc() contract:
+     *   - Accepts string[] of CPC codes
+     *   - Returns Promise<PatentData>
+     *   - May throw on error
+     *
+     * @param {string[]} cpcCodes - Array of 4-char CPC sub-class codes
+     * @returns {Promise<import('./patent-data-source.mjs').PatentData>}
+     */
+    async fetchByCpc(cpcCodes) {
+        // Record the call
+        this.callCount++;
+        this.lastArgs = cpcCodes;
+        this.calls.push({ cpcCodes: [...(cpcCodes || [])], timestamp: Date.now() });
+        // Optional callback
+        if (this._onFetch) {
+            this._onFetch(cpcCodes);
+        }
+        // Simulate latency
+        if (this._delay > 0) {
+            await new Promise(resolve => setTimeout(resolve, this._delay));
+        }
+        // Simulate error
+        if (this._error) {
+            throw this._error;
+        }
+        // Per-CPC response: return data for the first matching CPC code
+        if (this._perCpc && cpcCodes) {
+            for (const code of cpcCodes) {
+                if (this._perCpc.has(code)) {
+                    const entry = this._perCpc.get(code);
+                    return typeof entry === 'function' ? entry() : entry;
+                }
+            }
+        }
+        // Default data
+        if (this._data) {
+            return typeof this._data === 'function' ? this._data() : this._data;
+        }
+        // Ultimate fallback: empty patent data
+        return emptyPatentData();
+    }
+    /**
+     * Lifecycle cleanup.
+     * Sets the `closed` flag for test assertions.
+     *
+     * @returns {Promise<void>}
+     */
+    async close() {
+        this.closed = true;
+    }
+    /**
+     * Reset all instrumentation counters.
+     * Useful when reusing a mock across multiple test cases.
+     */
+    reset() {
+        this.callCount = 0;
+        this.lastArgs = null;
+        this.calls = [];
+        this.closed = false;
+    }
+}
+// ─── Convenience factory functions ──────────────────────────────────────────
+/**
+ * Create a MockPatentSource pre-loaded with a named fixture.
+ *
+ * @param {'commodity'|'genesis'|'product'|'empty'|'sparse'} fixtureName
+ * @param {Object} [options] - Additional MockPatentSource options (merged with fixture)
+ * @returns {MockPatentSource}
+ */
+export function createMockSource(fixtureName, options = {}) {
+    const factory = FIXTURES[fixtureName];
+    if (!factory) {
+        throw new Error(`Unknown fixture "${fixtureName}". Available: ${Object.keys(FIXTURES).join(', ')}`);
+    }
+    return new MockPatentSource({ data: factory, ...options });
+}
+/**
+ * Create a MockPatentSource that simulates a specific error.
+ *
+ * @param {string} [message='Mock BigQuery error'] - Error message
+ * @param {Object} [options] - Additional MockPatentSource options
+ * @returns {MockPatentSource}
+ */
+export function createErrorSource(message = 'Mock BigQuery error', options = {}) {
+    return new MockPatentSource({ error: new Error(message), ...options });
+}
+//# sourceMappingURL=mock-patent-source.mjs.map

package/dist/lib/patent/mock-patent-source.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-patent-source.mjs","sourceRoot":"","sources":["../../../src/lib/patent/mock-patent-source.mts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,EAAE;AACF,sEAAsE;AACtE,8DAA8D;AAC9D,EAAE;AACF,6DAA6D;AAC7D,oEAAoE;AACpE,mEAAmE;AACnE,0DAA0D;AAC1D,8DAA8D;AAC9D,8DAA8D;AAC9D,EAAE;AACF,SAAS;AACT,2EAA2E;AAC3E,6DAA6D;AAC7D,yEAAyE;AACzE,EAAE;AACF,mDAAmD;AACnD,oDAAoD;AACpD,6DAA6D;AAC7D,mDAAmD;AACnD,oDAAoD;AAEpD,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAsB,MAAM,0BAA0B,CAAC;AAGjG,+EAA+E;AAE/E;;;;;;;GAOG;AACH,SAAS,gBAAgB;IACvB,OAAO;QACL,YAAY,EAAE,GAAG;QACjB,eAAe,EAAE;YACf,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE;YAC3B,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE;YAC3B,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE;SAC3B;QACD,qBAAqB,EAAE;YACrB,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE;YAC1C,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE;YAClD,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE;YAClD,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE;YAClD,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE;SACnD;QACD,YAAY,EAAE,EAAE,qBAAqB,EAAE,IAAI,EAAE,WAAW,EAAE,GAAG,EAAE;QAC/D,cAAc,EAAE;YACd,EAAE,IAAI,EAAE,IAAI,EAAE,oBAAoB,EAAE,EAAE,EAAE;YACxC,EAAE,IAAI,EAAE,IAAI,EAAE,oBAAoB,EAAE,CAAC,EAAE;YACvC,EAAE,IAAI,EAAE,IAAI,EAAE,oBAAoB,EAAE,CAAC,EAAE;YACvC,EAAE,IAAI,EAAE,IAAI,EAAE,oBAAoB,EAAE,CAAC,EAAE;SACxC;QACD,YAAY,EAAE,EAAE,eAAe,EAAE,GAAG,EAAE,YAAY,EAAE,GAAG,EAAE;QACzD,OAAO,EAAE,EAAE,iBAAiB,EAAE,CAAC,EAAE,aAAa,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE;QAClG,UAAU,EAAE,EAAE,cAAc,EAAE,CAAC,EAAE,aAAa,EAAE,EAAE,EAAE;QACpD,cAAc,EAAE,EAAE,YAAY,EAAE,GAAG,EAAE,YAAY,EAAE,GAAG,EAAE;KACzD,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,cAAc;IACrB,OAAO;QACL,YAAY,EAAE,CAAC;QACf,eAAe,EAAE;YACf,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE;YACzB,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE;YACzB,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE;SAC1B;QACD,qBAAqB,EAAE;YACrB,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,MAAM,CAAC,EAAE;YAClC,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE;SACnD;QACD,YAAY,EAAE,EAAE,qBAAqB,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE;QAC1D,cAAc,EAAE;YACd,EAAE,IAAI,EAAE,IAAI,EAAE,oBAAoB,EAAE,EAAE,EAAE;YACxC,EAAE,IAAI,EAAE,IAAI,EAAE,oBAAoB,EAAE,EAAE,EAAE;SACzC;QACD,YAAY,EAAE,EAAE,eAAe,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE;QACrD,OAAO,EAAE,EAAE,iBAAiB,EAAE,CAAC,EAAE,aAAa,EAAE,CAAC,IAAI,CAAC,EAAE;QACxD,UAAU,EAAE,EAAE,cAAc,EAAE,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE;QACnD,cAAc,EAAE,EAAE,YAAY,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE;KACrD,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,cAAc;IACrB,OAAO;QACL,YAAY,EAAE,GAAG;QACjB,eAAe,EAAE;YACf,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE;YAC1B,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE;YAC1B,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE;SAC3B;QACD,qBAAqB,EAAE;YACrB,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE;YAC1C,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE;YAClD,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE;YAClD,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE;SACnD;QACD,YAAY,EAAE,EAAE,qBAAqB,EAAE,IAAI,EAAE,WAAW,EAAE,GAAG,EAAE;QAC/D,cAAc,EAAE;YACd,EAAE,IAAI,EAAE,IAAI,EAAE,oBAAoB,EAAE,EAAE,EAAE;YACxC,EAAE,IAAI,EAAE,IAAI,EAAE,oBAAoB,EAAE,CAAC,EAAE;YACvC,EAAE,IAAI,EAAE,IAAI,EAAE,oBAAoB,EAAE,CAAC,EAAE;SACxC;QACD,YAAY,EAAE,EAAE,eAAe,EAAE,EAAE,EAAE,YAAY,EAAE,GAAG,EAAE;QACxD,OAAO,EAAE,EAAE,iBAAiB,EAAE,CAAC,EAAE,aAAa,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE;QAC1E,UAAU,EAAE,EAAE,cAAc,EAAE,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE;QACnD,cAAc,EAAE,EAAE,YAAY,EAAE,EAAE,EAAE,YAAY,EAAE,GAAG,EAAE;KACxD,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,SAAS,aAAa;IACpB,OAAO;QACL,YAAY,EAAE,CAAC;QACf,eAAe,EAAE;YACf,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE;YACzB,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE;SAC1B;QACD,qBAAqB,EAAE;YACrB,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE;SAC3C;QACD,YAAY,EAAE,EAAE,qBAAqB,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE;QAC1D,cAAc,EAAE;YACd,EAAE,IAAI,EAAE,IAAI,EAAE,oBAAoB,EAAE,EAAE,EAAE;SACzC;QACD,YAAY,EAAE,EAAE,eAAe,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE;QACrD,OAAO,EAAE,EAAE,iBAAiB,EAAE,CAAC,EAAE,aAAa,EAAE,CAAC,IAAI,CAAC,EAAE;QACxD,UAAU,EAAE,EAAE,cAAc,EAAE,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE;QACnD,cAAc,EAAE,EAAE,YAAY,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE;KACrD,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC;IACpC,SAAS,EAAE,gBAAgB;IAC3B,OAAO,EAAI,cAAc;IACzB,OAAO,EAAI,cAAc;IACzB,KAAK,EAAM,eAAe;IAC1B,MAAM,EAAK,aAAa;CACzB,CAAC,CAAC;AAEH,+EAA+E;AAE/E;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,OAAO,gBAAiB,SAAQ,gBAAgB;IACpD,6EAA6E;IAC7E,4EAA4E;IAC5E,0BAA0B;IAC1B,KAAK,CAAyC;IAC9C,MAAM,CAAe;IACrB,MAAM,CAAS;IACf,OAAO,CAAsD;IAC7D,QAAQ,CAAwC;IAChD,SAAS,CAAS;IAClB,QAAQ,CAAkB;IAC1B,KAAK,CAAmD;IACxD,MAAM,CAAU;IAEhB;;;;;;;;;;;;;;OAcG;IACH,YAAY,UAMR,EAAE;QACJ,KAAK,EAAE,CAAC;QAER,gBAAgB;QAChB,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,IAAI,IAAI,IAAI,CAAC;QAClC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,KAAK,IAAI,IAAI,CAAC;QACpC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,KAAK,IAAI,CAAC,CAAC;QACjC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,MAAM,YAAY,GAAG;YAC1C,CAAC,CAAC,OAAO,CAAC,MAAM;YAChB,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACpE,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,OAAO,IAAI,IAAI,CAAC;QAExC,kBAAkB;QAClB,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC;QACnB,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACrB,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;QAChB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;IACtB,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,KAAK,CAAC,UAAU,CAAC,QAAkB;QACjC,kBAAkB;QAClB,IAAI,CAAC,SAAS,EAAE,CAAC;QACjB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QAE5E,oBAAoB;QACpB,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAC1B,CAAC;QAED,mBAAmB;QACnB,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpB,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;QACjE,CAAC;QAED,iBAAiB;QACjB,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,MAAM,IAAI,CAAC,MAAM,CAAC;QACpB,CAAC;QAED,gEAAgE;QAChE,IAAI,IAAI,CAAC,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC7B,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;gBAC5B,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;oBAC3B,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAE,CAAC;oBACtC,OAAO,OAAO,KAAK,KAAK,UAAU,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;gBACvD,CAAC;YACH,CAAC;QACH,CAAC;QAED,eAAe;QACf,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,OAAO,OAAO,IAAI,CAAC,KAAK,KAAK,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC;QACtE,CAAC;QAED,uCAAuC;QACvC,OAAO,eAAe,EAAE,CAAC;IAC3B,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,KAAK;QACT,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;IACrB,CAAC;IAED;;;OAGG;IACH,KAAK;QACH,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC;QACnB,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACrB,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;QAChB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;IACtB,CAAC;CACF;AAED,+EAA+E;AAE/E;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,WAAmB,EAAE,UAAmC,EAAE;IACzF,MAAM,OAAO,GAAI,QAA6C,CAAC,WAAW,CAAC,CAAC;IAC5E,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,oBAAoB,WAAW,iBAAiB,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACnF,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,gBAAgB,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;AAC7D,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAO,GAAG,qBAAqB,EAAE,OAAO,GAAG,EAAE;IAC7E,OAAO,IAAI,gBAAgB,CAAC,EAAE,KAAK,EAAE,IAAI,KAAK,CAAC,OAAO,CAAC,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;AACzE,CAAC"}