@debriefer/sources 1.0.1

package/dist/__tests__/web-search/brave.test.js.map

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

package/dist/__tests__/web-search/duckduckgo.test.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Tests for DuckDuckGoSearchSource.
+ *
+ * Mocks the shared searchDuckDuckGo utility and the WebSearchBase pipeline
+ * utilities (fetchPage, extractArticleContent) so the tests only exercise
+ * DuckDuckGo-specific code: metadata, isAvailable, performSearch delegation,
+ * and the factory function.
+ */
+export {};
+//# sourceMappingURL=duckduckgo.test.d.ts.map

package/dist/__tests__/web-search/duckduckgo.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"duckduckgo.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/web-search/duckduckgo.test.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/__tests__/web-search/duckduckgo.test.js

@@ -0,0 +1,107 @@
+/**
+ * Tests for DuckDuckGoSearchSource.
+ *
+ * Mocks the shared searchDuckDuckGo utility and the WebSearchBase pipeline
+ * utilities (fetchPage, extractArticleContent) so the tests only exercise
+ * DuckDuckGo-specific code: metadata, isAvailable, performSearch delegation,
+ * and the factory function.
+ */
+import { describe, it, expect, vi, beforeEach, afterEach } from "vitest";
+import { ReliabilityTier } from "@debriefer/core";
+// ============================================================================
+// Mocks — must be declared before importing the module under test
+// ============================================================================
+const mockSearchDDG = vi.fn();
+vi.mock("../../shared/duckduckgo-search.js", () => ({
+    searchDuckDuckGo: (...args) => mockSearchDDG(...args),
+}));
+vi.mock("../../shared/fetch-page.js", () => ({
+    fetchPage: vi.fn().mockResolvedValue({ content: "", url: "", fetchMethod: "none" }),
+}));
+vi.mock("../../shared/readability-extract.js", () => ({
+    extractArticleContent: vi.fn().mockReturnValue(null),
+}));
+import { DuckDuckGoSearchSource, duckduckgoSearch } from "../../web-search/duckduckgo.js";
+// ============================================================================
+// Lifecycle
+// ============================================================================
+beforeEach(() => {
+    mockSearchDDG.mockReset();
+});
+afterEach(() => {
+    vi.restoreAllMocks();
+});
+// ============================================================================
+// Tests
+// ============================================================================
+describe("DuckDuckGoSearchSource", () => {
+    // ==========================================================================
+    // Metadata
+    // ==========================================================================
+    describe("metadata", () => {
+        it("has correct name, type, reliabilityTier, domain, isFree, and estimatedCostPerQuery", () => {
+            const source = new DuckDuckGoSearchSource();
+            expect(source.name).toBe("DuckDuckGo");
+            expect(source.type).toBe("duckduckgo-search");
+            expect(source.reliabilityTier).toBe(ReliabilityTier.SEARCH_AGGREGATOR);
+            expect(source.domain).toBe("html.duckduckgo.com");
+            expect(source.isFree).toBe(true);
+            expect(source.estimatedCostPerQuery).toBe(0);
+        });
+    });
+    // ==========================================================================
+    // isAvailable — always true (no API key needed)
+    // ==========================================================================
+    describe("isAvailable", () => {
+        it("always returns true since no API key is required", () => {
+            const source = new DuckDuckGoSearchSource();
+            expect(source.isAvailable()).toBe(true);
+        });
+    });
+    // ==========================================================================
+    // performSearch — delegates to shared searchDuckDuckGo
+    // ==========================================================================
+    describe("performSearch", () => {
+        it("delegates to shared searchDuckDuckGo with correct query", async () => {
+            const mockResults = [
+                { url: "https://example.com/1", title: "Result 1", snippet: "Snippet 1" },
+                { url: "https://example.com/2", title: "Result 2", snippet: "Snippet 2" },
+            ];
+            mockSearchDDG.mockResolvedValue(mockResults);
+            const source = new DuckDuckGoSearchSource();
+            const signal = AbortSignal.timeout(5000);
+            await source.lookup({ id: 1, name: "test query" }, signal);
+            expect(mockSearchDDG).toHaveBeenCalledTimes(1);
+            // Verify query was passed through
+            const callArgs = mockSearchDDG.mock.calls[0][0];
+            expect(callArgs.query).toBe("test query");
+        });
+        it("passes signal to searchDuckDuckGo", async () => {
+            mockSearchDDG.mockResolvedValue([]);
+            const source = new DuckDuckGoSearchSource();
+            const signal = AbortSignal.timeout(5000);
+            await source.lookup({ id: 1, name: "test" }, signal);
+            expect(mockSearchDDG).toHaveBeenCalledTimes(1);
+            // Verify a signal was passed (may be wrapped by AbortSignal.any in base class)
+            const callArgs = mockSearchDDG.mock.calls[0][0];
+            expect(callArgs.signal).toBeDefined();
+            expect(callArgs.signal).toBeInstanceOf(AbortSignal);
+        });
+    });
+    // ==========================================================================
+    // Factory function
+    // ==========================================================================
+    describe("factory function", () => {
+        it("duckduckgoSearch() creates a DuckDuckGoSearchSource instance", () => {
+            const source = duckduckgoSearch();
+            expect(source).toBeInstanceOf(DuckDuckGoSearchSource);
+            expect(source.name).toBe("DuckDuckGo");
+            expect(source.isAvailable()).toBe(true);
+        });
+        it("duckduckgoSearch() passes options through to the constructor", () => {
+            const source = duckduckgoSearch({ maxLinksToFollow: 5 });
+            expect(source).toBeInstanceOf(DuckDuckGoSearchSource);
+        });
+    });
+});
+//# sourceMappingURL=duckduckgo.test.js.map

package/dist/__tests__/web-search/duckduckgo.test.js.map

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

package/dist/__tests__/web-search/google.test.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Tests for the Google Custom Search source.
+ *
+ * Mocks global fetch and the shared WebSearchBase pipeline utilities
+ * (fetch-page, readability-extract) so the tests only exercise
+ * Google-specific code: metadata, isAvailable, performSearch, and the factory.
+ */
+export {};
+//# sourceMappingURL=google.test.d.ts.map

package/dist/__tests__/web-search/google.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"google.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/web-search/google.test.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/__tests__/web-search/google.test.js

@@ -0,0 +1,189 @@
+/**
+ * Tests for the Google Custom Search source.
+ *
+ * Mocks global fetch and the shared WebSearchBase pipeline utilities
+ * (fetch-page, readability-extract) so the tests only exercise
+ * Google-specific code: metadata, isAvailable, performSearch, and the factory.
+ */
+import { describe, it, expect, vi, beforeEach, afterEach } from "vitest";
+import { ReliabilityTier } from "@debriefer/core";
+// ============================================================================
+// Mocks — must be declared before importing the module under test
+// ============================================================================
+vi.mock("../../shared/fetch-page.js", () => ({
+    fetchPage: vi.fn().mockResolvedValue({ content: "", url: "", fetchMethod: "none" }),
+}));
+vi.mock("../../shared/readability-extract.js", () => ({
+    extractArticleContent: vi.fn().mockReturnValue(null),
+}));
+import { GoogleSearchSource, googleSearch } from "../../web-search/google.js";
+// ============================================================================
+// Helpers
+// ============================================================================
+const VALID_OPTIONS = { apiKey: "test-key", cx: "test-cx" };
+function makeGoogleResponse(items) {
+    return items ? { items } : {};
+}
+function mockFetchSuccess(body) {
+    vi.stubGlobal("fetch", vi.fn().mockResolvedValue({
+        ok: true,
+        status: 200,
+        statusText: "OK",
+        json: () => Promise.resolve(body),
+    }));
+}
+function mockFetchError(status, statusText) {
+    vi.stubGlobal("fetch", vi.fn().mockResolvedValue({
+        ok: false,
+        status,
+        statusText,
+        json: () => Promise.resolve({}),
+    }));
+}
+// ============================================================================
+// Lifecycle
+// ============================================================================
+beforeEach(() => {
+    vi.stubGlobal("fetch", vi.fn());
+});
+afterEach(() => {
+    vi.restoreAllMocks();
+    vi.unstubAllGlobals();
+});
+// ============================================================================
+// Tests
+// ============================================================================
+describe("GoogleSearchSource", () => {
+    // ==========================================================================
+    // Metadata
+    // ==========================================================================
+    describe("metadata", () => {
+        it("has correct name, type, reliabilityTier, isFree, and cost", () => {
+            const source = new GoogleSearchSource(VALID_OPTIONS);
+            expect(source.name).toBe("Google Search");
+            expect(source.type).toBe("google-search");
+            expect(source.reliabilityTier).toBe(ReliabilityTier.SEARCH_AGGREGATOR);
+            expect(source.isFree).toBe(false);
+            expect(source.estimatedCostPerQuery).toBe(0.005);
+            expect(source.domain).toBe("www.googleapis.com");
+        });
+    });
+    // ==========================================================================
+    // isAvailable
+    // ==========================================================================
+    describe("isAvailable", () => {
+        it("returns true when both apiKey and cx are provided", () => {
+            const source = new GoogleSearchSource({ apiKey: "key", cx: "cx-id" });
+            expect(source.isAvailable()).toBe(true);
+        });
+        it("returns false when apiKey is missing", () => {
+            const source = new GoogleSearchSource({ cx: "cx-id" });
+            expect(source.isAvailable()).toBe(false);
+        });
+        it("returns false when cx is missing", () => {
+            const source = new GoogleSearchSource({ apiKey: "key" });
+            expect(source.isAvailable()).toBe(false);
+        });
+        it("returns false when both apiKey and cx are missing", () => {
+            const source = new GoogleSearchSource();
+            expect(source.isAvailable()).toBe(false);
+        });
+    });
+    // ==========================================================================
+    // performSearch — correct API call
+    // ==========================================================================
+    describe("performSearch", () => {
+        it("calls Google CSE API with correct URL params", async () => {
+            const items = [
+                { title: "Result 1", link: "https://example.com/1", snippet: "Snippet 1" },
+                { title: "Result 2", link: "https://example.com/2", snippet: "Snippet 2" },
+            ];
+            mockFetchSuccess(makeGoogleResponse(items));
+            const source = new GoogleSearchSource({
+                ...VALID_OPTIONS,
+                maxResults: 5,
+            });
+            // We call lookup which goes through the base class pipeline.
+            // Since fetchPage and extractArticleContent are mocked to return nothing,
+            // the result will be null — but we can still verify the fetch call.
+            const signal = AbortSignal.timeout(5000);
+            await source.lookup({ id: 1, name: "John Wayne" }, signal);
+            const fetchMock = vi.mocked(globalThis.fetch);
+            expect(fetchMock).toHaveBeenCalledTimes(1);
+            const callUrl = new URL(fetchMock.mock.calls[0][0]);
+            expect(callUrl.origin + callUrl.pathname).toBe("https://www.googleapis.com/customsearch/v1");
+            expect(callUrl.searchParams.get("key")).toBe("test-key");
+            expect(callUrl.searchParams.get("cx")).toBe("test-cx");
+            expect(callUrl.searchParams.get("q")).toBe("John Wayne");
+            expect(callUrl.searchParams.get("num")).toBe("5");
+            // Verify a signal is passed through (may be wrapped by AbortSignal.any)
+            const passedOptions = fetchMock.mock.calls[0][1];
+            expect(passedOptions.signal).toBeDefined();
+            expect(passedOptions.signal).toBeInstanceOf(AbortSignal);
+        });
+        it("uses default maxResults of 10", async () => {
+            mockFetchSuccess(makeGoogleResponse([]));
+            const source = new GoogleSearchSource(VALID_OPTIONS);
+            await source.lookup({ id: 1, name: "Jane Doe" }, AbortSignal.timeout(5000));
+            const fetchMock = vi.mocked(globalThis.fetch);
+            const callUrl = new URL(fetchMock.mock.calls[0][0]);
+            expect(callUrl.searchParams.get("num")).toBe("10");
+        });
+    });
+    // ==========================================================================
+    // API error handling
+    // ==========================================================================
+    describe("API error handling", () => {
+        it("returns null on non-OK HTTP response", async () => {
+            mockFetchError(403, "Forbidden");
+            const source = new GoogleSearchSource(VALID_OPTIONS);
+            const result = await source.lookup({ id: 1, name: "John Wayne" }, AbortSignal.timeout(5000));
+            // BaseResearchSource.lookup() catches errors and returns null
+            expect(result).toBeNull();
+        });
+    });
+    // ==========================================================================
+    // Empty / no items response
+    // ==========================================================================
+    describe("empty results", () => {
+        it("returns null when response has no items", async () => {
+            mockFetchSuccess(makeGoogleResponse(null));
+            const source = new GoogleSearchSource(VALID_OPTIONS);
+            const result = await source.lookup({ id: 1, name: "Obscure Person" }, AbortSignal.timeout(5000));
+            expect(result).toBeNull();
+        });
+        it("returns null when items array is empty", async () => {
+            mockFetchSuccess(makeGoogleResponse([]));
+            const source = new GoogleSearchSource(VALID_OPTIONS);
+            const result = await source.lookup({ id: 1, name: "Obscure Person" }, AbortSignal.timeout(5000));
+            expect(result).toBeNull();
+        });
+    });
+    // ==========================================================================
+    // No credentials → empty results (no API call)
+    // ==========================================================================
+    describe("missing credentials", () => {
+        it("returns null without calling fetch when credentials are missing", async () => {
+            const source = new GoogleSearchSource();
+            const result = await source.lookup({ id: 1, name: "John Wayne" }, AbortSignal.timeout(5000));
+            expect(result).toBeNull();
+            expect(globalThis.fetch).not.toHaveBeenCalled();
+        });
+    });
+    // ==========================================================================
+    // Factory function
+    // ==========================================================================
+    describe("factory function", () => {
+        it("creates a GoogleSearchSource instance", () => {
+            const source = googleSearch(VALID_OPTIONS);
+            expect(source).toBeInstanceOf(GoogleSearchSource);
+            expect(source.name).toBe("Google Search");
+        });
+        it("creates instance with default options when no options provided", () => {
+            const source = googleSearch();
+            expect(source).toBeInstanceOf(GoogleSearchSource);
+            expect(source.isAvailable()).toBe(false);
+        });
+    });
+});
+//# sourceMappingURL=google.test.js.map

package/dist/__tests__/web-search/google.test.js.map

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

package/dist/archives/chronicling-america.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Chronicling America (Library of Congress) source.
+ *
+ * Queries the Library of Congress Chronicling America digital newspaper
+ * archive for historical newspaper articles about a research subject.
+ * No authentication required.
+ */
+import { BaseResearchSource, ReliabilityTier, type BaseSourceOptions, type ResearchSubject, type RawFinding } from "@debriefer/core";
+export type ChroniclingAmericaOptions = BaseSourceOptions;
+/**
+ * Research source backed by the Library of Congress Chronicling America API.
+ *
+ * Searches historical digitized US newspapers for mentions of a subject.
+ * Free, no API key required.
+ */
+export declare class ChroniclingAmericaSource extends BaseResearchSource<ResearchSubject> {
+    readonly name = "Chronicling America";
+    readonly type = "chronicling-america";
+    readonly reliabilityTier = ReliabilityTier.ARCHIVAL;
+    readonly domain = "www.loc.gov";
+    readonly isFree = true;
+    readonly estimatedCostPerQuery = 0;
+    constructor(options?: ChroniclingAmericaOptions);
+    protected fetchResult(subject: ResearchSubject, signal: AbortSignal): Promise<RawFinding | null>;
+}
+/**
+ * Create a Chronicling America source instance.
+ *
+ * @param options - Source options (rateLimitMs, etc.)
+ * @returns A configured ChroniclingAmericaSource
+ */
+export declare function chroniclingAmerica(options?: ChroniclingAmericaOptions): ChroniclingAmericaSource;
+//# sourceMappingURL=chronicling-america.d.ts.map

package/dist/archives/chronicling-america.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chronicling-america.d.ts","sourceRoot":"","sources":["../../src/archives/chronicling-america.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,UAAU,EAChB,MAAM,iBAAiB,CAAA;AAaxB,MAAM,MAAM,yBAAyB,GAAG,iBAAiB,CAAA;AAmBzD;;;;;GAKG;AACH,qBAAa,wBAAyB,SAAQ,kBAAkB,CAAC,eAAe,CAAC;IAC/E,QAAQ,CAAC,IAAI,yBAAwB;IACrC,QAAQ,CAAC,IAAI,yBAAwB;IACrC,QAAQ,CAAC,eAAe,4BAA2B;IACnD,QAAQ,CAAC,MAAM,iBAAgB;IAC/B,QAAQ,CAAC,MAAM,QAAO;IACtB,QAAQ,CAAC,qBAAqB,KAAI;gBAEtB,OAAO,GAAE,yBAA8B;cAInC,WAAW,CACzB,OAAO,EAAE,eAAe,EACxB,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;CA8C9B;AAMD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,CAAC,EAAE,yBAAyB,GAAG,wBAAwB,CAEhG"}

package/dist/archives/chronicling-america.js

@@ -0,0 +1,85 @@
+/**
+ * Chronicling America (Library of Congress) source.
+ *
+ * Queries the Library of Congress Chronicling America digital newspaper
+ * archive for historical newspaper articles about a research subject.
+ * No authentication required.
+ */
+import { BaseResearchSource, ReliabilityTier, } from "@debriefer/core";
+import { sanitizeSourceText } from "../shared/sanitize-text.js";
+// ============================================================================
+// Constants
+// ============================================================================
+const LOC_API_URL = "https://www.loc.gov/collections/chronicling-america/";
+// ============================================================================
+// ChroniclingAmericaSource
+// ============================================================================
+/**
+ * Research source backed by the Library of Congress Chronicling America API.
+ *
+ * Searches historical digitized US newspapers for mentions of a subject.
+ * Free, no API key required.
+ */
+export class ChroniclingAmericaSource extends BaseResearchSource {
+    name = "Chronicling America";
+    type = "chronicling-america";
+    reliabilityTier = ReliabilityTier.ARCHIVAL;
+    domain = "www.loc.gov";
+    isFree = true;
+    estimatedCostPerQuery = 0;
+    constructor(options = {}) {
+        super({ rateLimitMs: 1000, ...options });
+    }
+    async fetchResult(subject, signal) {
+        const url = new URL(LOC_API_URL);
+        url.searchParams.set("q", `"${subject.name}"`);
+        url.searchParams.set("fo", "json");
+        url.searchParams.set("c", "5");
+        const response = await fetch(url.toString(), { signal });
+        if (!response.ok) {
+            throw new Error(`Chronicling America API error: HTTP ${response.status} ${response.statusText}`);
+        }
+        const data = (await response.json());
+        if (!data.results?.length)
+            return null;
+        // Combine title + description from all results
+        const parts = [];
+        for (const result of data.results) {
+            if (result.title)
+                parts.push(result.title);
+            if (result.description?.length) {
+                parts.push(result.description.join(" "));
+            }
+        }
+        const text = parts.join("\n\n");
+        if (!text.trim())
+            return null;
+        const sanitized = sanitizeSourceText(text);
+        if (!sanitized)
+            return null;
+        const firstWithUrl = data.results.find((r) => r.url);
+        return {
+            text: sanitized,
+            confidence: -1,
+            costUsd: 0,
+            url: firstWithUrl?.url,
+            publication: "Chronicling America (Library of Congress)",
+            metadata: {
+                title: data.results[0]?.title ?? "",
+            },
+        };
+    }
+}
+// ============================================================================
+// Factory
+// ============================================================================
+/**
+ * Create a Chronicling America source instance.
+ *
+ * @param options - Source options (rateLimitMs, etc.)
+ * @returns A configured ChroniclingAmericaSource
+ */
+export function chroniclingAmerica(options) {
+    return new ChroniclingAmericaSource(options);
+}
+//# sourceMappingURL=chronicling-america.js.map

package/dist/archives/chronicling-america.js.map

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

package/dist/archives/europeana.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Europeana source.
+ *
+ * Queries the Europeana Search API for cultural heritage records about
+ * a research subject. Requires a free API key from Europeana.
+ */
+import { BaseResearchSource, ReliabilityTier, type BaseSourceOptions, type ResearchSubject, type RawFinding } from "@debriefer/core";
+export interface EuropeanaOptions extends BaseSourceOptions {
+    /** Europeana API key. Defaults to process.env.EUROPEANA_API_KEY. */
+    apiKey?: string;
+}
+/**
+ * Research source backed by the Europeana Search API.
+ *
+ * Searches European cultural heritage collections for records about
+ * a subject. Requires a free API key.
+ */
+export declare class EuropeanaSource extends BaseResearchSource<ResearchSubject> {
+    readonly name = "Europeana";
+    readonly type = "europeana";
+    readonly reliabilityTier = ReliabilityTier.ARCHIVAL;
+    readonly domain = "api.europeana.eu";
+    readonly isFree = true;
+    readonly estimatedCostPerQuery = 0;
+    private apiKey;
+    constructor(options?: EuropeanaOptions);
+    isAvailable(): boolean;
+    protected fetchResult(subject: ResearchSubject, signal: AbortSignal): Promise<RawFinding | null>;
+}
+/**
+ * Create a Europeana source instance.
+ *
+ * @param options - Europeana-specific options (apiKey, rateLimitMs, etc.)
+ * @returns A configured EuropeanaSource
+ */
+export declare function europeana(options?: EuropeanaOptions): EuropeanaSource;
+//# sourceMappingURL=europeana.d.ts.map

package/dist/archives/europeana.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"europeana.d.ts","sourceRoot":"","sources":["../../src/archives/europeana.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,UAAU,EAChB,MAAM,iBAAiB,CAAA;AAaxB,MAAM,WAAW,gBAAiB,SAAQ,iBAAiB;IACzD,oEAAoE;IACpE,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAoBD;;;;;GAKG;AACH,qBAAa,eAAgB,SAAQ,kBAAkB,CAAC,eAAe,CAAC;IACtE,QAAQ,CAAC,IAAI,eAAc;IAC3B,QAAQ,CAAC,IAAI,eAAc;IAC3B,QAAQ,CAAC,eAAe,4BAA2B;IACnD,QAAQ,CAAC,MAAM,sBAAqB;IACpC,QAAQ,CAAC,MAAM,QAAO;IACtB,QAAQ,CAAC,qBAAqB,KAAI;IAElC,OAAO,CAAC,MAAM,CAAoB;gBAEtB,OAAO,GAAE,gBAAqB;IAKjC,WAAW,IAAI,OAAO;cAIf,WAAW,CACzB,OAAO,EAAE,eAAe,EACxB,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;CA8C9B;AAMD;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,eAAe,CAErE"}

package/dist/archives/europeana.js

@@ -0,0 +1,92 @@
+/**
+ * Europeana source.
+ *
+ * Queries the Europeana Search API for cultural heritage records about
+ * a research subject. Requires a free API key from Europeana.
+ */
+import { BaseResearchSource, ReliabilityTier, } from "@debriefer/core";
+import { sanitizeSourceText } from "../shared/sanitize-text.js";
+// ============================================================================
+// Constants
+// ============================================================================
+const EUROPEANA_API_URL = "https://api.europeana.eu/record/v2/search.json";
+// ============================================================================
+// EuropeanaSource
+// ============================================================================
+/**
+ * Research source backed by the Europeana Search API.
+ *
+ * Searches European cultural heritage collections for records about
+ * a subject. Requires a free API key.
+ */
+export class EuropeanaSource extends BaseResearchSource {
+    name = "Europeana";
+    type = "europeana";
+    reliabilityTier = ReliabilityTier.ARCHIVAL;
+    domain = "api.europeana.eu";
+    isFree = true;
+    estimatedCostPerQuery = 0;
+    apiKey;
+    constructor(options = {}) {
+        super({ rateLimitMs: 1000, ...options });
+        this.apiKey = options.apiKey ?? process.env.EUROPEANA_API_KEY;
+    }
+    isAvailable() {
+        return Boolean(this.apiKey);
+    }
+    async fetchResult(subject, signal) {
+        if (!this.apiKey)
+            return null;
+        const url = new URL(EUROPEANA_API_URL);
+        url.searchParams.set("wskey", this.apiKey);
+        url.searchParams.set("query", `"${subject.name}" biography`);
+        url.searchParams.set("rows", "5");
+        const response = await fetch(url.toString(), { signal });
+        if (!response.ok) {
+            throw new Error(`Europeana API error: HTTP ${response.status} ${response.statusText}`);
+        }
+        const data = (await response.json());
+        if (!data.items?.length)
+            return null;
+        // Combine title + description from all items
+        const parts = [];
+        for (const item of data.items) {
+            if (item.title?.length)
+                parts.push(item.title.join(" "));
+            if (item.dcDescription?.length)
+                parts.push(item.dcDescription.join(" "));
+        }
+        const text = parts.join("\n\n");
+        if (!text.trim())
+            return null;
+        const sanitized = sanitizeSourceText(text);
+        if (!sanitized)
+            return null;
+        // Use edmIsShownAt[0] or fall back to guid for URL
+        const firstItem = data.items[0];
+        const resultUrl = firstItem?.edmIsShownAt?.[0] ?? firstItem?.guid;
+        return {
+            text: sanitized,
+            confidence: -1,
+            costUsd: 0,
+            url: resultUrl,
+            publication: "Europeana",
+            metadata: {
+                title: firstItem?.title?.[0] ?? "",
+            },
+        };
+    }
+}
+// ============================================================================
+// Factory
+// ============================================================================
+/**
+ * Create a Europeana source instance.
+ *
+ * @param options - Europeana-specific options (apiKey, rateLimitMs, etc.)
+ * @returns A configured EuropeanaSource
+ */
+export function europeana(options) {
+    return new EuropeanaSource(options);
+}
+//# sourceMappingURL=europeana.js.map