@debriefer/sources 1.0.1

package/dist/__tests__/books/google-books.test.js

@@ -0,0 +1,221 @@
+/**
+ * Tests for GoogleBooksSource.
+ *
+ * Mocks the global fetch API and sanitizeSourceText to isolate
+ * Google Books-specific logic.
+ */
+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 mockSanitize = vi.fn();
+const mockDecodeEntities = vi.fn();
+vi.mock("../../shared/sanitize-text.js", () => ({
+    sanitizeSourceText: (...args) => mockSanitize(...args),
+}));
+vi.mock("../../shared/html-utils.js", () => ({
+    decodeHtmlEntities: (...args) => mockDecodeEntities(...args),
+}));
+import { GoogleBooksSource, googleBooks } from "../../books/google-books.js";
+// ============================================================================
+// Helpers
+// ============================================================================
+/** Standard test subject. */
+const subject = { id: 1, name: "John Wayne" };
+/** Standard abort signal for tests. */
+const signal = AbortSignal.timeout(5000);
+/** Build a mock Google Books API response. */
+function makeGoogleBooksResponse(items) {
+    return {
+        ok: true,
+        status: 200,
+        statusText: "OK",
+        json: async () => ({
+            totalItems: items.length,
+            items: items.length > 0 ? items : undefined,
+        }),
+    };
+}
+/** Description long enough to pass the 100-char minimum. */
+const LONG_DESCRIPTION = "A".repeat(150);
+// ============================================================================
+// Lifecycle
+// ============================================================================
+beforeEach(() => {
+    mockSanitize.mockReset();
+    mockDecodeEntities.mockReset();
+    // Default: pass through
+    mockSanitize.mockImplementation((text) => text);
+    mockDecodeEntities.mockImplementation((text) => text);
+    vi.stubGlobal("fetch", vi.fn());
+});
+afterEach(() => {
+    vi.restoreAllMocks();
+    vi.unstubAllGlobals();
+});
+// ============================================================================
+// Tests
+// ============================================================================
+describe("GoogleBooksSource", () => {
+    describe("metadata", () => {
+        it("has correct name, type, tier, domain, isFree, and cost", () => {
+            const source = new GoogleBooksSource({ apiKey: "test-key" });
+            expect(source.name).toBe("Google Books");
+            expect(source.type).toBe("google-books");
+            expect(source.reliabilityTier).toBe(ReliabilityTier.SECONDARY_COMPILATION);
+            expect(source.domain).toBe("www.googleapis.com");
+            expect(source.isFree).toBe(true);
+            expect(source.estimatedCostPerQuery).toBe(0);
+        });
+    });
+    // ==========================================================================
+    // isAvailable
+    // ==========================================================================
+    describe("isAvailable", () => {
+        it("returns true when apiKey is provided", () => {
+            const source = new GoogleBooksSource({ apiKey: "test-key" });
+            expect(source.isAvailable()).toBe(true);
+        });
+        it("returns false when no apiKey is provided and env var is unset", () => {
+            const original = process.env.GOOGLE_BOOKS_API_KEY;
+            delete process.env.GOOGLE_BOOKS_API_KEY;
+            const source = new GoogleBooksSource();
+            expect(source.isAvailable()).toBe(false);
+            if (original !== undefined) {
+                process.env.GOOGLE_BOOKS_API_KEY = original;
+            }
+        });
+    });
+    // ==========================================================================
+    // API call format
+    // ==========================================================================
+    describe("API call format", () => {
+        it("builds correct URL with all expected query params", async () => {
+            const mockFetch = vi.fn().mockResolvedValue(makeGoogleBooksResponse([]));
+            vi.stubGlobal("fetch", mockFetch);
+            const source = new GoogleBooksSource({ apiKey: "my-api-key" });
+            await source.lookup(subject, signal);
+            expect(mockFetch).toHaveBeenCalledTimes(1);
+            const [callUrl, callOptions] = mockFetch.mock.calls[0];
+            const parsed = new URL(callUrl);
+            expect(parsed.origin + parsed.pathname).toBe("https://www.googleapis.com/books/v1/volumes");
+            expect(parsed.searchParams.get("key")).toBe("my-api-key");
+            expect(parsed.searchParams.get("q")).toBe('"John Wayne" biography');
+            expect(parsed.searchParams.get("maxResults")).toBe("5");
+            expect(callOptions.signal).toBeDefined();
+        });
+    });
+    // ==========================================================================
+    // Response parsing
+    // ==========================================================================
+    describe("response parsing", () => {
+        it("returns finding with metadata from first item with enough text", async () => {
+            const mockFetch = vi.fn().mockResolvedValue(makeGoogleBooksResponse([
+                {
+                    volumeInfo: {
+                        title: "John Wayne: The Life",
+                        description: LONG_DESCRIPTION,
+                        authors: ["Author One"],
+                        publishedDate: "2020-01-01",
+                        infoLink: "https://books.google.com/books?id=abc123",
+                    },
+                    searchInfo: {
+                        textSnippet: "A <b>bold</b> snippet about John Wayne&apos;s life.",
+                    },
+                },
+            ]));
+            vi.stubGlobal("fetch", mockFetch);
+            const source = new GoogleBooksSource({ apiKey: "test-key" });
+            const result = await source.lookup(subject, signal);
+            expect(result).not.toBeNull();
+            expect(result.publication).toBe("Google Books");
+            expect(result.confidence).toBe(-1);
+            expect(result.costUsd).toBe(0);
+            expect(result.url).toBe("https://books.google.com/books?id=abc123");
+            expect(result.metadata?.title).toBe("John Wayne: The Life");
+            expect(result.metadata?.authors).toEqual(["Author One"]);
+            expect(result.metadata?.publishedDate).toBe("2020-01-01");
+        });
+        it("strips HTML tags from textSnippet and decodes entities", async () => {
+            const snippet = "A <b>bold</b> snippet &amp; more";
+            const decoded = "A bold snippet & more";
+            mockDecodeEntities.mockReturnValue(decoded);
+            const mockFetch = vi.fn().mockResolvedValue(makeGoogleBooksResponse([
+                {
+                    volumeInfo: {
+                        title: "Test Book",
+                        description: LONG_DESCRIPTION,
+                        infoLink: "https://books.google.com/books?id=xyz",
+                    },
+                    searchInfo: { textSnippet: snippet },
+                },
+            ]));
+            vi.stubGlobal("fetch", mockFetch);
+            const source = new GoogleBooksSource({ apiKey: "test-key" });
+            await source.lookup(subject, signal);
+            // decodeHtmlEntities should have been called with tag-stripped snippet
+            expect(mockDecodeEntities).toHaveBeenCalledWith("A bold snippet &amp; more");
+            // sanitizeSourceText should have been called with combined text
+            expect(mockSanitize).toHaveBeenCalled();
+        });
+        it("skips items with combined text shorter than 100 chars", async () => {
+            const mockFetch = vi.fn().mockResolvedValue(makeGoogleBooksResponse([
+                {
+                    volumeInfo: {
+                        title: "Short Book",
+                        description: "Too short",
+                        infoLink: "https://books.google.com/books?id=short",
+                    },
+                },
+                {
+                    volumeInfo: {
+                        title: "Long Book",
+                        description: LONG_DESCRIPTION,
+                        infoLink: "https://books.google.com/books?id=long",
+                    },
+                },
+            ]));
+            vi.stubGlobal("fetch", mockFetch);
+            const source = new GoogleBooksSource({ apiKey: "test-key" });
+            const result = await source.lookup(subject, signal);
+            expect(result).not.toBeNull();
+            expect(result.metadata?.title).toBe("Long Book");
+        });
+    });
+    // ==========================================================================
+    // Null returns
+    // ==========================================================================
+    describe("null returns", () => {
+        it("returns null when no items in response", async () => {
+            const mockFetch = vi.fn().mockResolvedValue(makeGoogleBooksResponse([]));
+            vi.stubGlobal("fetch", mockFetch);
+            const source = new GoogleBooksSource({ apiKey: "test-key" });
+            const result = await source.lookup(subject, signal);
+            expect(result).toBeNull();
+        });
+        it("returns null on API error (caught by base class)", async () => {
+            const mockFetch = vi.fn().mockResolvedValue({
+                ok: false,
+                status: 403,
+                statusText: "Forbidden",
+                json: async () => ({}),
+            });
+            vi.stubGlobal("fetch", mockFetch);
+            const source = new GoogleBooksSource({ apiKey: "test-key" });
+            const result = await source.lookup(subject, signal);
+            expect(result).toBeNull();
+        });
+    });
+    // ==========================================================================
+    // Factory function
+    // ==========================================================================
+    describe("factory", () => {
+        it("returns a GoogleBooksSource instance", () => {
+            const source = googleBooks({ apiKey: "test-key" });
+            expect(source).toBeInstanceOf(GoogleBooksSource);
+            expect(source.name).toBe("Google Books");
+        });
+    });
+});
+//# sourceMappingURL=google-books.test.js.map

package/dist/__tests__/books/google-books.test.js.map

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

package/dist/__tests__/books/open-library.test.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Tests for OpenLibrarySource.
+ *
+ * Mocks the global fetch API. Open Library requires no API key
+ * and returns structured JSON — no HTML parsing needed.
+ */
+export {};
+//# sourceMappingURL=open-library.test.d.ts.map

package/dist/__tests__/books/open-library.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-library.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/books/open-library.test.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/__tests__/books/open-library.test.js

@@ -0,0 +1,159 @@
+/**
+ * Tests for OpenLibrarySource.
+ *
+ * Mocks the global fetch API. Open Library requires no API key
+ * and returns structured JSON — no HTML parsing needed.
+ */
+import { describe, it, expect, vi, beforeEach, afterEach } from "vitest";
+import { ReliabilityTier } from "@debriefer/core";
+import { OpenLibrarySource, openLibrary } from "../../books/open-library.js";
+// ============================================================================
+// Helpers
+// ============================================================================
+/** Standard test subject. */
+const subject = { id: 1, name: "John Wayne" };
+/** Standard abort signal for tests. */
+const signal = AbortSignal.timeout(5000);
+/** Build a mock Open Library search response. */
+function makeOpenLibraryResponse(docs) {
+    return {
+        ok: true,
+        status: 200,
+        statusText: "OK",
+        json: async () => ({
+            numFound: docs.length,
+            docs,
+        }),
+    };
+}
+// ============================================================================
+// Lifecycle
+// ============================================================================
+beforeEach(() => {
+    vi.stubGlobal("fetch", vi.fn());
+});
+afterEach(() => {
+    vi.restoreAllMocks();
+    vi.unstubAllGlobals();
+});
+// ============================================================================
+// Tests
+// ============================================================================
+describe("OpenLibrarySource", () => {
+    describe("metadata", () => {
+        it("has correct name, type, tier, domain, isFree, and cost", () => {
+            const source = new OpenLibrarySource();
+            expect(source.name).toBe("Open Library");
+            expect(source.type).toBe("open-library");
+            expect(source.reliabilityTier).toBe(ReliabilityTier.SECONDARY_COMPILATION);
+            expect(source.domain).toBe("openlibrary.org");
+            expect(source.isFree).toBe(true);
+            expect(source.estimatedCostPerQuery).toBe(0);
+        });
+    });
+    // ==========================================================================
+    // isAvailable
+    // ==========================================================================
+    describe("isAvailable", () => {
+        it("returns true always (no API key required)", () => {
+            const source = new OpenLibrarySource();
+            expect(source.isAvailable()).toBe(true);
+        });
+    });
+    // ==========================================================================
+    // API call format
+    // ==========================================================================
+    describe("API call format", () => {
+        it("builds correct URL with expected query params", async () => {
+            const mockFetch = vi.fn().mockResolvedValue(makeOpenLibraryResponse([]));
+            vi.stubGlobal("fetch", mockFetch);
+            const source = new OpenLibrarySource();
+            await source.lookup(subject, signal);
+            expect(mockFetch).toHaveBeenCalledTimes(1);
+            const [callUrl, callOptions] = mockFetch.mock.calls[0];
+            const parsed = new URL(callUrl);
+            expect(parsed.origin + parsed.pathname).toBe("https://openlibrary.org/search.json");
+            expect(parsed.searchParams.get("q")).toBe('"John Wayne" biography');
+            expect(parsed.searchParams.get("limit")).toBe("5");
+            expect(callOptions.signal).toBeDefined();
+        });
+    });
+    // ==========================================================================
+    // Response parsing
+    // ==========================================================================
+    describe("response parsing", () => {
+        it("returns finding with metadata from first doc with a title", async () => {
+            const mockFetch = vi.fn().mockResolvedValue(makeOpenLibraryResponse([
+                {
+                    key: "/works/OL12345W",
+                    title: "John Wayne: American Legend",
+                    author_name: ["Jane Smith"],
+                    first_publish_year: 1998,
+                    ia: ["johnwaynelegend00smit"],
+                },
+            ]));
+            vi.stubGlobal("fetch", mockFetch);
+            const source = new OpenLibrarySource();
+            const result = await source.lookup(subject, signal);
+            expect(result).not.toBeNull();
+            expect(result.text).toBe("John Wayne: American Legend by Jane Smith (1998)");
+            expect(result.publication).toBe("Open Library");
+            expect(result.confidence).toBe(-1);
+            expect(result.costUsd).toBe(0);
+            expect(result.url).toBe("https://openlibrary.org/works/OL12345W");
+            expect(result.metadata?.title).toBe("John Wayne: American Legend");
+            expect(result.metadata?.authors).toEqual(["Jane Smith"]);
+            expect(result.metadata?.firstPublishYear).toBe(1998);
+        });
+        it("handles docs with multiple authors", async () => {
+            const mockFetch = vi.fn().mockResolvedValue(makeOpenLibraryResponse([
+                {
+                    key: "/works/OL999W",
+                    title: "Dual Authors Book",
+                    author_name: ["Author A", "Author B"],
+                    first_publish_year: 2005,
+                },
+            ]));
+            vi.stubGlobal("fetch", mockFetch);
+            const source = new OpenLibrarySource();
+            const result = await source.lookup(subject, signal);
+            expect(result).not.toBeNull();
+            expect(result.text).toBe("Dual Authors Book by Author A, Author B (2005)");
+        });
+    });
+    // ==========================================================================
+    // Null returns
+    // ==========================================================================
+    describe("null returns", () => {
+        it("returns null when no docs in response", async () => {
+            const mockFetch = vi.fn().mockResolvedValue(makeOpenLibraryResponse([]));
+            vi.stubGlobal("fetch", mockFetch);
+            const source = new OpenLibrarySource();
+            const result = await source.lookup(subject, signal);
+            expect(result).toBeNull();
+        });
+        it("returns null on API error (caught by base class)", async () => {
+            const mockFetch = vi.fn().mockResolvedValue({
+                ok: false,
+                status: 500,
+                statusText: "Internal Server Error",
+                json: async () => ({}),
+            });
+            vi.stubGlobal("fetch", mockFetch);
+            const source = new OpenLibrarySource();
+            const result = await source.lookup(subject, signal);
+            expect(result).toBeNull();
+        });
+    });
+    // ==========================================================================
+    // Factory function
+    // ==========================================================================
+    describe("factory", () => {
+        it("returns an OpenLibrarySource instance", () => {
+            const source = openLibrary();
+            expect(source).toBeInstanceOf(OpenLibrarySource);
+            expect(source.name).toBe("Open Library");
+        });
+    });
+});
+//# sourceMappingURL=open-library.test.js.map

package/dist/__tests__/books/open-library.test.js.map

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

package/dist/__tests__/news/guardian.test.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Tests for GuardianSource.
+ *
+ * Mocks the global fetch API. Does NOT mock pipeline utilities
+ * (Guardian uses its own API, not fetchPage/extractArticleContent).
+ * sanitizeSourceText is mocked to isolate Guardian-specific logic.
+ */
+export {};
+//# sourceMappingURL=guardian.test.d.ts.map

package/dist/__tests__/news/guardian.test.d.ts.map

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

package/dist/__tests__/news/guardian.test.js

@@ -0,0 +1,224 @@
+/**
+ * Tests for GuardianSource.
+ *
+ * Mocks the global fetch API. Does NOT mock pipeline utilities
+ * (Guardian uses its own API, not fetchPage/extractArticleContent).
+ * sanitizeSourceText is mocked to isolate Guardian-specific logic.
+ */
+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 mockSanitize = vi.fn();
+vi.mock("../../shared/sanitize-text.js", () => ({
+    sanitizeSourceText: (...args) => mockSanitize(...args),
+}));
+import { GuardianSource, guardian } from "../../news/guardian.js";
+// ============================================================================
+// Helpers
+// ============================================================================
+/** Standard test subject. */
+const subject = { id: 1, name: "John Wayne" };
+/** Standard abort signal for tests. */
+const signal = AbortSignal.timeout(5000);
+/** Build a mock Guardian API response. */
+function makeGuardianResponse(results) {
+    return {
+        ok: true,
+        status: 200,
+        statusText: "OK",
+        json: async () => ({
+            response: {
+                status: "ok",
+                results,
+            },
+        }),
+    };
+}
+/** Body text long enough to pass the 200-char minimum. */
+const LONG_TEXT = "A".repeat(300);
+// ============================================================================
+// Lifecycle
+// ============================================================================
+beforeEach(() => {
+    mockSanitize.mockReset();
+    vi.stubGlobal("fetch", vi.fn());
+});
+afterEach(() => {
+    vi.restoreAllMocks();
+    vi.unstubAllGlobals();
+});
+// ============================================================================
+// Metadata
+// ============================================================================
+describe("GuardianSource", () => {
+    describe("metadata", () => {
+        it("has correct name, type, tier, domain, isFree, and cost", () => {
+            const source = new GuardianSource({ apiKey: "test-key" });
+            expect(source.name).toBe("The Guardian");
+            expect(source.type).toBe("guardian");
+            expect(source.reliabilityTier).toBe(ReliabilityTier.TIER_1_NEWS);
+            expect(source.domain).toBe("content.guardianapis.com");
+            expect(source.isFree).toBe(true);
+            expect(source.estimatedCostPerQuery).toBe(0);
+        });
+    });
+    // ==========================================================================
+    // isAvailable
+    // ==========================================================================
+    describe("isAvailable", () => {
+        it("returns true when apiKey is provided", () => {
+            const source = new GuardianSource({ apiKey: "test-key" });
+            expect(source.isAvailable()).toBe(true);
+        });
+        it("returns false when no apiKey is provided and env var is unset", () => {
+            const original = process.env.GUARDIAN_API_KEY;
+            delete process.env.GUARDIAN_API_KEY;
+            const source = new GuardianSource();
+            expect(source.isAvailable()).toBe(false);
+            // Restore
+            if (original !== undefined) {
+                process.env.GUARDIAN_API_KEY = original;
+            }
+        });
+    });
+    // ==========================================================================
+    // API call format
+    // ==========================================================================
+    describe("API call format", () => {
+        it("builds correct URL with all expected query params", async () => {
+            const mockFetch = vi.fn().mockResolvedValue(makeGuardianResponse([]));
+            vi.stubGlobal("fetch", mockFetch);
+            const source = new GuardianSource({ apiKey: "my-api-key" });
+            await source.lookup(subject, signal);
+            expect(mockFetch).toHaveBeenCalledTimes(1);
+            const [callUrl, callOptions] = mockFetch.mock.calls[0];
+            const parsed = new URL(callUrl);
+            expect(parsed.origin + parsed.pathname).toBe("https://content.guardianapis.com/search");
+            expect(parsed.searchParams.get("api-key")).toBe("my-api-key");
+            expect(parsed.searchParams.get("q")).toContain('"John Wayne"');
+            expect(parsed.searchParams.get("show-fields")).toBe("bodyText,standfirst,trailText");
+            expect(parsed.searchParams.get("page-size")).toBe("10");
+            expect(parsed.searchParams.get("order-by")).toBe("relevance");
+            expect(callOptions.signal).toBeDefined();
+        });
+    });
+    // ==========================================================================
+    // Response parsing — article selection
+    // ==========================================================================
+    describe("article selection", () => {
+        it("picks article with bio keyword in title", async () => {
+            const mockFetch = vi.fn().mockResolvedValue(makeGuardianResponse([
+                {
+                    webTitle: "John Wayne filmography roundup",
+                    webUrl: "https://theguardian.com/film/roundup",
+                    fields: { bodyText: LONG_TEXT },
+                },
+                {
+                    webTitle: "John Wayne profile: the man behind the legend",
+                    webUrl: "https://theguardian.com/film/profile",
+                    fields: { bodyText: LONG_TEXT },
+                },
+            ]));
+            vi.stubGlobal("fetch", mockFetch);
+            mockSanitize.mockReturnValue(LONG_TEXT);
+            const source = new GuardianSource({ apiKey: "test-key" });
+            const result = await source.lookup(subject, signal);
+            expect(result).not.toBeNull();
+            expect(result.url).toBe("https://theguardian.com/film/profile");
+            expect(result.metadata?.title).toBe("John Wayne profile: the man behind the legend");
+        });
+        it("falls back to first result when no keyword match", async () => {
+            const mockFetch = vi.fn().mockResolvedValue(makeGuardianResponse([
+                {
+                    webTitle: "John Wayne in new film role",
+                    webUrl: "https://theguardian.com/film/new-role",
+                    fields: { bodyText: LONG_TEXT },
+                },
+                {
+                    webTitle: "John Wayne at the Oscars",
+                    webUrl: "https://theguardian.com/film/oscars",
+                    fields: { bodyText: LONG_TEXT },
+                },
+            ]));
+            vi.stubGlobal("fetch", mockFetch);
+            mockSanitize.mockReturnValue(LONG_TEXT);
+            const source = new GuardianSource({ apiKey: "test-key" });
+            const result = await source.lookup(subject, signal);
+            expect(result).not.toBeNull();
+            expect(result.url).toBe("https://theguardian.com/film/new-role");
+        });
+    });
+    // ==========================================================================
+    // Response parsing — body text
+    // ==========================================================================
+    describe("body text extraction", () => {
+        it("returns bodyText as source text", async () => {
+            const bodyText = "B".repeat(300);
+            const mockFetch = vi.fn().mockResolvedValue(makeGuardianResponse([
+                {
+                    webTitle: "John Wayne profile",
+                    webUrl: "https://theguardian.com/film/profile",
+                    fields: { bodyText },
+                },
+            ]));
+            vi.stubGlobal("fetch", mockFetch);
+            mockSanitize.mockReturnValue(bodyText);
+            const source = new GuardianSource({ apiKey: "test-key" });
+            const result = await source.lookup(subject, signal);
+            expect(result).not.toBeNull();
+            expect(result.text).toBe(bodyText);
+            expect(result.confidence).toBe(-1);
+            expect(result.costUsd).toBe(0);
+            expect(result.publication).toBe("The Guardian");
+            expect(mockSanitize).toHaveBeenCalledWith(bodyText);
+        });
+    });
+    // ==========================================================================
+    // Null returns
+    // ==========================================================================
+    describe("null returns", () => {
+        it("returns null when no results", async () => {
+            const mockFetch = vi.fn().mockResolvedValue(makeGuardianResponse([]));
+            vi.stubGlobal("fetch", mockFetch);
+            const source = new GuardianSource({ apiKey: "test-key" });
+            const result = await source.lookup(subject, signal);
+            expect(result).toBeNull();
+        });
+        it("returns null on API error (caught by base class)", async () => {
+            const mockFetch = vi.fn().mockResolvedValue({
+                ok: false,
+                status: 403,
+                statusText: "Forbidden",
+                json: async () => ({}),
+            });
+            vi.stubGlobal("fetch", mockFetch);
+            const source = new GuardianSource({ apiKey: "test-key" });
+            // BaseResearchSource.lookup() catches errors from fetchResult and returns null
+            const result = await source.lookup(subject, signal);
+            expect(result).toBeNull();
+        });
+        it("returns null when apiKey is missing", async () => {
+            const original = process.env.GUARDIAN_API_KEY;
+            delete process.env.GUARDIAN_API_KEY;
+            const source = new GuardianSource();
+            const result = await source.lookup(subject, signal);
+            expect(result).toBeNull();
+            if (original !== undefined) {
+                process.env.GUARDIAN_API_KEY = original;
+            }
+        });
+    });
+    // ==========================================================================
+    // Factory function
+    // ==========================================================================
+    describe("factory", () => {
+        it("returns a GuardianSource instance", () => {
+            const source = guardian({ apiKey: "test-key" });
+            expect(source).toBeInstanceOf(GuardianSource);
+            expect(source.name).toBe("The Guardian");
+        });
+    });
+});
+//# sourceMappingURL=guardian.test.js.map