llm-search-tools 1.1.0

package/dist/modules/flights.js

@@ -0,0 +1,135 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.searchFlights = searchFlights;
+const common_1 = require("./common");
+/**
+ * Search for flights on Google Flights
+ * @param query Search query (e.g. "flights from JFK to LHR") or options object
+ * @param options Search options
+ * @returns Promise<FlightResult>
+ */
+async function searchFlights(query, options = {}) {
+    let opts;
+    if (typeof query === "object") {
+        opts = { ...query, ...options };
+    }
+    else {
+        opts = options;
+        // Attempt to parse query if provided as string, but relying on explicit options is better
+    }
+    // Construct URL
+    // Basic format: https://www.google.com/travel/flights?q=Flights%20to%20LHR%20from%20JFK%20on%202023-05-01
+    // Or more specific parameters
+    let url = "https://www.google.com/travel/flights";
+    const params = [];
+    if (opts.from && opts.to) {
+        let q = `Flights to ${opts.to} from ${opts.from}`;
+        if (opts.departureDate) {
+            q += ` on ${opts.departureDate}`;
+        }
+        if (opts.returnDate) {
+            q += ` returning ${opts.returnDate}`;
+        }
+        params.push(`q=${encodeURIComponent(q)}`);
+    }
+    else if (typeof query === "string") {
+        params.push(`q=${encodeURIComponent(query)}`);
+    }
+    if (params.length > 0) {
+        url += `?${params.join("&")}`;
+    }
+    const proxy = (0, common_1.parseProxyConfig)(opts.proxy);
+    const browser = await (0, common_1.createStealthBrowser)(proxy || undefined);
+    try {
+        const page = await browser.newPage();
+        await page.setViewport({ width: 1920, height: 1080 });
+        await page.setExtraHTTPHeaders((0, common_1.createRealisticHeaders)());
+        // Navigate to Google Flights
+        await page.goto(url, { waitUntil: "networkidle2", timeout: opts.timeout || 30000 });
+        // Handle cookie consent if present (common in EU)
+        try {
+            const consentButton = await page.waitForSelector('button[aria-label="Accept all"]', { timeout: 5000 });
+            if (consentButton) {
+                await consentButton.click();
+                await page.waitForNavigation({ waitUntil: "networkidle2" }).catch(() => { }); // Wait a bit if nav happens
+            }
+        }
+        catch {
+            // No consent button found, proceed
+        }
+        // Wait for results to load
+        // The selector for flight lists often changes, but usually there are accessible roles
+        try {
+            await page.waitForSelector('li[class*="pIav2d"]', { timeout: 10000 });
+        }
+        catch {
+            // Fallback or retry
+        }
+        // Extract flights
+        const flights = await page.evaluate(() => {
+            const results = [];
+            // Select flight list items
+            // Note: CSS classes in Google Flights are obfuscated and change often.
+            // We'll try to use more stable structure selectors where possible, or partial class matches.
+            // Current observation of Google Flights DOM structure (approximate)
+            const listItems = document.querySelectorAll('li[class*="pIav2d"]'); // Common container class for list items
+            listItems.forEach((item) => {
+                try {
+                    // Airline & Times often in specific aria-labels or text content
+                    const text = item.textContent || "";
+                    // Attempt to extract structured data
+                    // This is brittle and might need constant updates
+                    // Look for time pattern (e.g. 10:00 AM)
+                    const timeRegex = /(\d{1,2}:\d{2}\s*[AP]M)/g;
+                    const times = text.match(timeRegex);
+                    // Look for price
+                    const priceRegex = /([$€£]\d+(?:,\d+)?)/;
+                    const priceMatch = text.match(priceRegex);
+                    // Look for duration (e.g. 7 hr 30 min)
+                    const durationRegex = /(\d+\s*hr\s*\d*\s*min)/;
+                    const durationMatch = text.match(durationRegex);
+                    // Look for stops
+                    const stops = text.includes("Non-stop")
+                        ? "Non-stop"
+                        : text.includes("1 stop")
+                            ? "1 stop"
+                            : text.includes("stops")
+                                ? "2+ stops"
+                                : "Unknown";
+                    // Extract Airline (usually first text or near image)
+                    // Simple heuristic: Text lines before the time
+                    const airline = text.split(timeRegex)[0]?.trim() || "Unknown Airline";
+                    if (times && times.length >= 2 && priceMatch) {
+                        results.push({
+                            airline, // Heuristic
+                            departureTime: times[0],
+                            arrivalTime: times[1],
+                            duration: durationMatch ? durationMatch[0] : "Unknown",
+                            price: priceMatch[0],
+                            stops,
+                        });
+                    }
+                }
+                catch {
+                    // Skip malformed items
+                }
+            });
+            return results;
+        });
+        return {
+            flights: flights.slice(0, opts.limit || 10),
+            url,
+            source: "google-flights",
+        };
+    }
+    catch (error) {
+        throw {
+            message: `Failed to search flights: ${error.message}`,
+            code: "FLIGHT_SEARCH_ERROR",
+            originalError: error,
+        };
+    }
+    finally {
+        await browser.close();
+    }
+}

package/dist/modules/flights.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/modules/flights.test.js

@@ -0,0 +1,128 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const flights_1 = require("./flights");
+const common = __importStar(require("./common"));
+// Mock common module
+vitest_1.vi.mock("./common", async () => {
+    const actual = await vitest_1.vi.importActual("./common");
+    return {
+        ...actual,
+        createStealthBrowser: vitest_1.vi.fn(),
+    };
+});
+(0, vitest_1.describe)("Flights Module", () => {
+    let mockPage;
+    let mockBrowser;
+    (0, vitest_1.beforeEach)(() => {
+        vitest_1.vi.clearAllMocks();
+        mockPage = {
+            setViewport: vitest_1.vi.fn(),
+            setExtraHTTPHeaders: vitest_1.vi.fn(),
+            goto: vitest_1.vi.fn(),
+            waitForSelector: vitest_1.vi.fn(),
+            evaluate: vitest_1.vi.fn(),
+            click: vitest_1.vi.fn(),
+            waitForNavigation: vitest_1.vi.fn(),
+            $: vitest_1.vi.fn(),
+        };
+        mockBrowser = {
+            newPage: vitest_1.vi.fn().mockResolvedValue(mockPage),
+            close: vitest_1.vi.fn(),
+        };
+        vitest_1.vi.spyOn(common, "createStealthBrowser").mockResolvedValue(mockBrowser);
+    });
+    (0, vitest_1.it)("should search for flights with query string", async () => {
+        const mockFlights = [
+            {
+                airline: "Test Air",
+                departureTime: "10:00 AM",
+                arrivalTime: "02:00 PM",
+                duration: "4 hr",
+                price: "$200",
+                stops: "Non-stop",
+            },
+        ];
+        mockPage.evaluate.mockResolvedValue(mockFlights);
+        const result = await (0, flights_1.searchFlights)("flights from JFK to LHR");
+        (0, vitest_1.expect)(common.createStealthBrowser).toHaveBeenCalled();
+        (0, vitest_1.expect)(mockPage.goto).toHaveBeenCalledWith(vitest_1.expect.stringContaining("google.com/travel/flights"), vitest_1.expect.any(Object));
+        (0, vitest_1.expect)(result.flights).toEqual(mockFlights);
+        (0, vitest_1.expect)(result.source).toBe("google-flights");
+    });
+    (0, vitest_1.it)("should search for flights with structured options", async () => {
+        const mockFlights = [
+            {
+                airline: "Test Air",
+                departureTime: "10:00 AM",
+                arrivalTime: "02:00 PM",
+                duration: "4 hr",
+                price: "$200",
+                stops: "Non-stop",
+            },
+        ];
+        mockPage.evaluate.mockResolvedValue(mockFlights);
+        const options = {
+            from: "JFK",
+            to: "LHR",
+            departureDate: "2025-05-01",
+            returnDate: "2025-05-10",
+        };
+        const result = await (0, flights_1.searchFlights)(options);
+        (0, vitest_1.expect)(mockPage.goto).toHaveBeenCalledWith(vitest_1.expect.stringMatching(/q=Flights%20to%20LHR%20from%20JFK%20on%202025-05-01%20returning%202025-05-10/), vitest_1.expect.any(Object));
+        (0, vitest_1.expect)(result.flights).toEqual(mockFlights);
+    });
+    (0, vitest_1.it)("should handle scraping errors gracefully", async () => {
+        mockPage.goto.mockRejectedValue(new Error("Navigation failed"));
+        await (0, vitest_1.expect)((0, flights_1.searchFlights)("query")).rejects.toThrow("Failed to search flights");
+        (0, vitest_1.expect)(mockBrowser.close).toHaveBeenCalled();
+    });
+    (0, vitest_1.it)("should attempt to click consent button if found", async () => {
+        // Mock waitForSelector implementation for consent button
+        mockPage.waitForSelector.mockImplementation((selector) => {
+            if (selector.includes("Accept all")) {
+                return Promise.resolve({ click: vitest_1.vi.fn() });
+            }
+            return Promise.resolve(null); // Return null for other selectors or throw depending on logic
+        });
+        // Mock evaluate to return empty list so it finishes
+        mockPage.evaluate.mockResolvedValue([]);
+        await (0, flights_1.searchFlights)("query");
+        // We can't easily check if the exact element method was called since we return a new object
+        // But we can check if the flow continued
+        (0, vitest_1.expect)(mockPage.goto).toHaveBeenCalled();
+    });
+});

package/dist/modules/hackernews.d.ts

@@ -0,0 +1,8 @@
+import { HackerNewsResult } from "../types";
+export declare function getTopStories(limit?: number): Promise<HackerNewsResult[]>;
+export declare function getNewStories(limit?: number): Promise<HackerNewsResult[]>;
+export declare function getBestStories(limit?: number): Promise<HackerNewsResult[]>;
+export declare function getAskStories(limit?: number): Promise<HackerNewsResult[]>;
+export declare function getShowStories(limit?: number): Promise<HackerNewsResult[]>;
+export declare function getJobStories(limit?: number): Promise<HackerNewsResult[]>;
+export declare function getStoryById(id: number): Promise<HackerNewsResult>;

package/dist/modules/hackernews.js

@@ -0,0 +1,87 @@
+"use strict";
+// hackernews.ts - get them spicy tech stories n stuff
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getTopStories = getTopStories;
+exports.getNewStories = getNewStories;
+exports.getBestStories = getBestStories;
+exports.getAskStories = getAskStories;
+exports.getShowStories = getShowStories;
+exports.getJobStories = getJobStories;
+exports.getStoryById = getStoryById;
+const API_BASE = "https://hacker-news.firebaseio.com/v0";
+// convert hn item to our format
+function formatHNResult(item, requestedId) {
+    if (!item) {
+        return {
+            id: requestedId,
+            title: "Unknown Story",
+            url: requestedId ? `https://news.ycombinator.com/item?id=${requestedId}` : "https://news.ycombinator.com",
+            snippet: "",
+            source: "hackernews",
+        };
+    }
+    return {
+        id: item.id,
+        title: item.title || "Untitled",
+        url: item.url || `https://news.ycombinator.com/item?id=${item.id}`,
+        snippet: item.text || "",
+        source: "hackernews",
+        points: item.score || 0,
+        author: item.by || "anonymous",
+        comments: item.descendants || 0,
+        time: item.time ? new Date(item.time * 1000) : new Date(),
+    };
+}
+async function fetchItem(id) {
+    const response = await fetch(`${API_BASE}/item/${id}.json`);
+    return response.json();
+}
+async function fetchStories(type, limit = 10) {
+    try {
+        const response = await fetch(`${API_BASE}/${type}.json`);
+        const ids = (await response.json());
+        // get first 'limit' number of stories
+        const storyIds = ids.slice(0, limit);
+        // fetch all stories in parallel
+        const stories = await Promise.all(storyIds.map(fetchItem));
+        return stories.filter((story) => !!story).map(formatHNResult);
+    }
+    catch (err) {
+        throw {
+            message: `failed to get ${type} stories :(`,
+            code: `HN_${type.toUpperCase()}_ERROR`,
+            originalError: err,
+        };
+    }
+}
+async function getTopStories(limit = 10) {
+    return fetchStories("topstories", limit);
+}
+async function getNewStories(limit = 10) {
+    return fetchStories("newstories", limit);
+}
+async function getBestStories(limit = 10) {
+    return fetchStories("beststories", limit);
+}
+async function getAskStories(limit = 10) {
+    return fetchStories("askstories", limit);
+}
+async function getShowStories(limit = 10) {
+    return fetchStories("showstories", limit);
+}
+async function getJobStories(limit = 10) {
+    return fetchStories("jobstories", limit);
+}
+async function getStoryById(id) {
+    try {
+        const story = await fetchItem(id);
+        return formatHNResult(story, id);
+    }
+    catch (err) {
+        throw {
+            message: "failed to get story :(",
+            code: "HN_STORY_ERROR",
+            originalError: err,
+        };
+    }
+}

package/dist/modules/hackernews.js.map

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

package/dist/modules/images.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/modules/images.test.js

@@ -0,0 +1,145 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const search_1 = require("./search");
+const duckduckgo_1 = require("./scrapers/duckduckgo");
+const google_1 = require("./scrapers/google");
+const searxng_1 = require("./scrapers/searxng");
+const common = __importStar(require("./common"));
+// Mock common module
+vitest_1.vi.mock("./common", async () => {
+    const actual = await vitest_1.vi.importActual("./common");
+    return {
+        ...actual,
+        createStealthBrowser: vitest_1.vi.fn(),
+        fetchWithDetection: vitest_1.vi.fn(),
+    };
+});
+(0, vitest_1.describe)("Image Search Integration", () => {
+    let mockPage;
+    let mockBrowser;
+    (0, vitest_1.beforeEach)(() => {
+        vitest_1.vi.clearAllMocks();
+        mockPage = {
+            setViewport: vitest_1.vi.fn(),
+            setExtraHTTPHeaders: vitest_1.vi.fn(),
+            goto: vitest_1.vi.fn(),
+            waitForSelector: vitest_1.vi.fn(),
+            evaluate: vitest_1.vi.fn(),
+            close: vitest_1.vi.fn(),
+        };
+        mockBrowser = {
+            newPage: vitest_1.vi.fn().mockResolvedValue(mockPage),
+            close: vitest_1.vi.fn(),
+        };
+        vitest_1.vi.spyOn(common, "createStealthBrowser").mockResolvedValue(mockBrowser);
+    });
+    (0, vitest_1.it)("should search google images correctly", async () => {
+        const mockImages = [
+            {
+                title: "Test Image",
+                url: "https://example.com/page",
+                snippet: "Test Image",
+                imageUrl: "https://example.com/image.jpg",
+                thumbnailUrl: "https://example.com/thumb.jpg",
+                source: "google-images",
+            },
+        ];
+        mockPage.evaluate.mockResolvedValue(mockImages);
+        const results = await (0, google_1.searchGoogle)("cats", { category: "images" });
+        (0, vitest_1.expect)(common.createStealthBrowser).toHaveBeenCalled();
+        (0, vitest_1.expect)(mockPage.goto).toHaveBeenCalledWith(vitest_1.expect.stringContaining("google.com/search?q=cats&tbm=isch"), vitest_1.expect.any(Object));
+        (0, vitest_1.expect)(results).toEqual(mockImages);
+    });
+    (0, vitest_1.it)("should search duckduckgo images correctly", async () => {
+        const mockImages = [
+            {
+                title: "Test DDG Image",
+                url: "https://example.com/ddg-page",
+                snippet: "Test DDG Image",
+                imageUrl: "https://example.com/ddg-image.jpg",
+                thumbnailUrl: "https://example.com/ddg-image.jpg",
+                source: "duckduckgo-images",
+            },
+        ];
+        mockPage.evaluate.mockResolvedValue(mockImages);
+        const results = await (0, duckduckgo_1.searchDuckDuckGo)("dogs", { category: "images" });
+        (0, vitest_1.expect)(common.createStealthBrowser).toHaveBeenCalled();
+        // DDG image search url param
+        (0, vitest_1.expect)(mockPage.goto).toHaveBeenCalledWith(vitest_1.expect.stringContaining("duckduckgo.com/?q=dogs&iax=images&ia=images"), vitest_1.expect.any(Object));
+        (0, vitest_1.expect)(results).toEqual(mockImages);
+    });
+    (0, vitest_1.it)("should search searxng images correctly", async () => {
+        const mockResponse = {
+            results: [
+                {
+                    title: "Test SearxNG Image",
+                    url: "https://example.com/searx-page",
+                    content: "Test SearxNG Image",
+                    img_src: "https://example.com/searx-image.jpg",
+                    thumbnail_src: "https://example.com/searx-thumb.jpg",
+                },
+            ],
+        };
+        common.fetchWithDetection.mockResolvedValue({
+            headers: {},
+            body: JSON.stringify(mockResponse),
+        });
+        const results = await (0, searxng_1.searchSearxNG)("lizards", { category: "images" });
+        (0, vitest_1.expect)(common.fetchWithDetection).toHaveBeenCalledWith(vitest_1.expect.stringContaining("categories=images"), vitest_1.expect.any(Object));
+        (0, vitest_1.expect)(results[0]).toMatchObject({
+            title: "Test SearxNG Image",
+            imageUrl: "https://example.com/searx-image.jpg",
+            source: "searxng-images",
+        });
+    });
+    (0, vitest_1.it)("should delegate to scrapers via main search function", async () => {
+        const mockImages = [
+            {
+                title: "Test DDG Image",
+                url: "https://example.com/ddg-page",
+                snippet: "Test DDG Image",
+                imageUrl: "https://example.com/ddg-image.jpg",
+                thumbnailUrl: "https://example.com/ddg-image.jpg",
+                source: "duckduckgo-images",
+            },
+        ];
+        mockPage.evaluate.mockResolvedValue(mockImages);
+        // Should default to DDG first
+        const results = await (0, search_1.search)("birds", { category: "images" });
+        (0, vitest_1.expect)(results[0].source).toContain("images");
+    });
+});

package/dist/modules/integrations.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/modules/integrations.test.js

@@ -0,0 +1,93 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const hackernews_1 = require("./hackernews");
+const wikipedia_1 = require("./wikipedia");
+const wikipedia_2 = __importDefault(require("wikipedia"));
+// Mock dependencies
+vitest_1.vi.mock("wikipedia");
+// Global fetch mock
+global.fetch = vitest_1.vi.fn();
+(0, vitest_1.describe)("Integrations Module", () => {
+    (0, vitest_1.beforeEach)(() => {
+        vitest_1.vi.resetAllMocks();
+    });
+    (0, vitest_1.describe)("HackerNews", () => {
+        (0, vitest_1.it)("should fetch top stories", async () => {
+            // Mock ID list response
+            global.fetch
+                .mockResolvedValueOnce({
+                json: () => Promise.resolve([1, 2]),
+            })
+                // Mock Item 1
+                .mockResolvedValueOnce({
+                json: () => Promise.resolve({ id: 1, title: "Story 1", url: "http://story1.com", score: 100 }),
+            })
+                // Mock Item 2
+                .mockResolvedValueOnce({
+                json: () => Promise.resolve({ id: 2, title: "Story 2", url: "http://story2.com", score: 200 }),
+            });
+            const stories = await (0, hackernews_1.getTopStories)(2);
+            (0, vitest_1.expect)(stories).toHaveLength(2);
+            (0, vitest_1.expect)(stories[0].title).toBe("Story 1");
+            (0, vitest_1.expect)(stories[1].title).toBe("Story 2");
+            (0, vitest_1.expect)(global.fetch).toHaveBeenCalledTimes(3);
+        });
+        (0, vitest_1.it)("should fetch story by ID", async () => {
+            global.fetch.mockResolvedValue({
+                json: () => Promise.resolve({ id: 123, title: "Specific Story", text: "Content" }),
+            });
+            const story = await (0, hackernews_1.getStoryById)(123);
+            (0, vitest_1.expect)(story.title).toBe("Specific Story");
+            (0, vitest_1.expect)(story.snippet).toBe("Content");
+        });
+        (0, vitest_1.it)("should handle HN errors", async () => {
+            global.fetch.mockRejectedValue(new Error("API Error"));
+            await (0, vitest_1.expect)((0, hackernews_1.getStoryById)(1)).rejects.toThrow("failed to get story");
+        });
+    });
+    (0, vitest_1.describe)("Wikipedia", () => {
+        (0, vitest_1.it)("should search wikipedia", async () => {
+            const mockResults = {
+                results: [{ title: "Result 1" }, { title: "Result 2" }],
+            };
+            const mockSummary = {
+                title: "Result 1",
+                extract: "Summary 1",
+                thumbnail: { source: "img.jpg" },
+            };
+            wikipedia_2.default.search.mockResolvedValue(mockResults);
+            wikipedia_2.default.summary.mockResolvedValue(mockSummary);
+            const results = await (0, wikipedia_1.wikiSearch)("query", 2);
+            (0, vitest_1.expect)(results).toHaveLength(2);
+            (0, vitest_1.expect)(results[0].title).toBe("Result 1");
+            (0, vitest_1.expect)(results[0].snippet).toBe("Summary 1");
+            (0, vitest_1.expect)(wikipedia_2.default.search).toHaveBeenCalledWith("query", { limit: 2 });
+        });
+        (0, vitest_1.it)("should get wikipedia content", async () => {
+            const mockPage = {
+                content: vitest_1.vi.fn().mockResolvedValue("Page Content"),
+            };
+            wikipedia_2.default.page.mockResolvedValue(mockPage);
+            const content = await (0, wikipedia_1.wikiGetContent)("Test Page");
+            (0, vitest_1.expect)(content).toBe("Page Content");
+            (0, vitest_1.expect)(wikipedia_2.default.page).toHaveBeenCalledWith("Test Page");
+        });
+        (0, vitest_1.it)("should get wikipedia summary", async () => {
+            wikipedia_2.default.summary.mockResolvedValue({
+                title: "Summary Title",
+                extract: "Summary Text",
+            });
+            const summary = await (0, wikipedia_1.wikiGetSummary)("Test Page");
+            (0, vitest_1.expect)(summary.title).toBe("Summary Title");
+            (0, vitest_1.expect)(summary.extract).toBe("Summary Text");
+        });
+        (0, vitest_1.it)("should handle Wikipedia errors", async () => {
+            wikipedia_2.default.page.mockRejectedValue(new Error("Wiki Error"));
+            await (0, vitest_1.expect)((0, wikipedia_1.wikiGetContent)("Error Page")).rejects.toThrow("failed to get wikipedia content");
+        });
+    });
+});

package/dist/modules/media.d.ts

@@ -0,0 +1,11 @@
+import { MediaResult, MediaSearchOptions } from "../types";
+/**
+ * Unified Media Search
+ * Coordinates between TMDB, TheTVDB, and AniDB with fallback logic.
+ */
+export declare function searchMedia(query: string, options?: MediaSearchOptions): Promise<MediaResult[]>;
+/**
+ * Get detailed information for a media result.
+ * Automatically determines the source based on the URL or accepts an explicit source.
+ */
+export declare function getMediaDetails(url: string, source?: "tmdb" | "thetvdb" | "anidb", options?: MediaSearchOptions): Promise<Partial<MediaResult>>;