paper-search-cli 0.1.0

package/dist/platforms/WileySearcher.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Wiley TDM (Text and Data Mining) API - PDF Download Only
+ *
+ * Documentation: https://onlinelibrary.wiley.com/library-info/resources/text-and-datamining
+ * GitHub Client: https://github.com/WileyLabs/tdm-client
+ *
+ * IMPORTANT: Wiley TDM API does NOT support keyword search.
+ * It only supports downloading PDFs by DOI.
+ * For searching Wiley content, use Crossref API with publisher filter.
+ *
+ * API Endpoint: https://api.wiley.com/onlinelibrary/tdm/v1/articles/{DOI}
+ * Header: Wiley-TDM-Client-Token: <token>
+ *
+ * Rate limits:
+ * - Up to 3 articles per second
+ * - Up to 60 requests per 10 minutes (build in 10 second delay between requests)
+ */
+import { PaperSource, SearchOptions, DownloadOptions, PlatformCapabilities } from './PaperSource.js';
+import { Paper } from '../models/Paper.js';
+export declare class WileySearcher extends PaperSource {
+    private client;
+    private rateLimiter;
+    constructor(tdmToken?: string);
+    /**
+     * Search is NOT supported by Wiley TDM API.
+     * Use Crossref API to search for Wiley articles, then use download() to get PDFs.
+     */
+    search(query: string, options?: SearchOptions): Promise<Paper[]>;
+    /**
+     * Download PDF by DOI using Wiley TDM API
+     * @param doi - The DOI of the article (e.g., "10.1111/jtsb.12390")
+     * @param options - Download options including savePath
+     */
+    downloadPdf(doi: string, options?: {
+        savePath?: string;
+    }): Promise<string>;
+    /**
+     * Get article metadata and download link (without downloading)
+     */
+    getArticleInfo(doi: string): Promise<Paper>;
+    getCapabilities(): PlatformCapabilities;
+    readPaper(paperId: string, options?: DownloadOptions): Promise<string>;
+}
+//# sourceMappingURL=WileySearcher.d.ts.map

package/dist/platforms/WileySearcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WileySearcher.d.ts","sourceRoot":"","sources":["../../src/platforms/WileySearcher.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACrG,OAAO,EAAE,KAAK,EAAgB,MAAM,oBAAoB,CAAC;AAMzD,qBAAa,aAAc,SAAQ,WAAW;IAC5C,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,WAAW,CAAc;gBAErB,QAAQ,CAAC,EAAE,MAAM;IAoB7B;;;OAGG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAQ1E;;;;OAIG;IACG,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,OAAO,CAAC,MAAM,CAAC;IAiEpF;;OAEG;IACG,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IAsBjD,eAAe,IAAI,oBAAoB;IAWjC,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,MAAM,CAAC;CAGjF"}

package/dist/platforms/WileySearcher.js

@@ -0,0 +1,148 @@
+/**
+ * Wiley TDM (Text and Data Mining) API - PDF Download Only
+ *
+ * Documentation: https://onlinelibrary.wiley.com/library-info/resources/text-and-datamining
+ * GitHub Client: https://github.com/WileyLabs/tdm-client
+ *
+ * IMPORTANT: Wiley TDM API does NOT support keyword search.
+ * It only supports downloading PDFs by DOI.
+ * For searching Wiley content, use Crossref API with publisher filter.
+ *
+ * API Endpoint: https://api.wiley.com/onlinelibrary/tdm/v1/articles/{DOI}
+ * Header: Wiley-TDM-Client-Token: <token>
+ *
+ * Rate limits:
+ * - Up to 3 articles per second
+ * - Up to 60 requests per 10 minutes (build in 10 second delay between requests)
+ */
+import axios from 'axios';
+import { PaperSource } from './PaperSource.js';
+import { PaperFactory } from '../models/Paper.js';
+import { RateLimiter } from '../utils/RateLimiter.js';
+import { ErrorHandler } from '../utils/ErrorHandler.js';
+import { sanitizeDoi } from '../utils/SecurityUtils.js';
+import { TIMEOUTS } from '../config/constants.js';
+export class WileySearcher extends PaperSource {
+    client;
+    rateLimiter;
+    constructor(tdmToken) {
+        super('wiley', 'https://api.wiley.com/onlinelibrary/tdm/v1', tdmToken);
+        this.client = axios.create({
+            baseURL: 'https://api.wiley.com/onlinelibrary/tdm/v1',
+            headers: {
+                'Accept': 'application/pdf',
+                ...(tdmToken ? { 'Wiley-TDM-Client-Token': tdmToken } : {})
+            },
+            maxRedirects: 5,
+            timeout: TIMEOUTS.EXTENDED
+        });
+        // Wiley rate limits: 3 articles/sec, 60 requests/10min
+        this.rateLimiter = new RateLimiter({
+            requestsPerSecond: 0.1, // Conservative: ~6 per minute
+            burstCapacity: 3
+        });
+    }
+    /**
+     * Search is NOT supported by Wiley TDM API.
+     * Use Crossref API to search for Wiley articles, then use download() to get PDFs.
+     */
+    async search(query, options = {}) {
+        throw new Error('Wiley TDM API does not support keyword search. ' +
+            'Use Crossref API (search_crossref) to find Wiley articles by DOI, ' +
+            'then use download_paper with platform="wiley" to download PDFs.');
+    }
+    /**
+     * Download PDF by DOI using Wiley TDM API
+     * @param doi - The DOI of the article (e.g., "10.1111/jtsb.12390")
+     * @param options - Download options including savePath
+     */
+    async downloadPdf(doi, options = {}) {
+        if (!this.apiKey) {
+            throw new Error('Wiley TDM token is required. Set WILEY_TDM_TOKEN environment variable.');
+        }
+        // Clean and validate DOI format
+        const doiResult = sanitizeDoi(doi);
+        if (!doiResult.valid) {
+            throw new Error(`Invalid DOI format: ${doi}. ${doiResult.error || ''}`);
+        }
+        const cleanDoi = doiResult.sanitized;
+        const fs = await import('fs');
+        const path = await import('path');
+        const savePath = options.savePath || './downloads';
+        if (!fs.existsSync(savePath)) {
+            fs.mkdirSync(savePath, { recursive: true });
+        }
+        // Encode DOI for URL (replace / with %2F)
+        const encodedDoi = encodeURIComponent(cleanDoi);
+        const url = `/articles/${encodedDoi}`;
+        await this.rateLimiter.waitForPermission();
+        try {
+            const response = await ErrorHandler.retryWithBackoff(() => this.client.get(url, {
+                responseType: 'stream',
+                headers: {
+                    'Wiley-TDM-Client-Token': this.apiKey,
+                    'Accept': 'application/pdf'
+                }
+            }), { context: 'Wiley download' });
+            // Generate filename from DOI
+            const fileName = `${cleanDoi.replace(/[\/\\:*?"<>|]/g, '_')}.pdf`;
+            const filePath = path.join(savePath, fileName);
+            const writer = fs.createWriteStream(filePath);
+            response.data.pipe(writer);
+            return new Promise((resolve, reject) => {
+                writer.on('finish', () => resolve(filePath));
+                writer.on('error', reject);
+            });
+        }
+        catch (error) {
+            const status = error.response?.status;
+            const errorMessages = {
+                400: 'No TDM Client Token was found in the request',
+                403: 'TDM Client Token is invalid or not registered',
+                404: 'Access denied - you or your institution does not have access to this content. Check your subscription.',
+                429: 'Rate limit exceeded. Please reduce request frequency (max 60 requests per 10 minutes).'
+            };
+            if (status && errorMessages[status]) {
+                throw new Error(`Wiley TDM Error (${status}): ${errorMessages[status]}`);
+            }
+            throw new Error(`Failed to download PDF: ${error.message}`);
+        }
+    }
+    /**
+     * Get article metadata and download link (without downloading)
+     */
+    async getArticleInfo(doi) {
+        // Clean and validate DOI
+        const doiResult = sanitizeDoi(doi);
+        const cleanDoi = doiResult.valid ? doiResult.sanitized : doi;
+        // Since TDM API only provides PDF download, we create basic paper info from DOI
+        return PaperFactory.create({
+            paperId: cleanDoi,
+            title: `Wiley Article: ${cleanDoi}`,
+            authors: [],
+            abstract: '',
+            doi: cleanDoi,
+            publishedDate: null,
+            pdfUrl: `https://api.wiley.com/onlinelibrary/tdm/v1/articles/${encodeURIComponent(cleanDoi)}`,
+            url: `https://doi.org/${cleanDoi}`,
+            source: 'wiley',
+            extra: {
+                note: 'Use Crossref API for full metadata. This endpoint only provides PDF download.'
+            }
+        });
+    }
+    getCapabilities() {
+        return {
+            search: false, // TDM API does not support search
+            download: true, // PDF download by DOI
+            fullText: true, // Full PDF available
+            citations: false,
+            requiresApiKey: true,
+            supportedOptions: [] // No search options - only DOI-based download
+        };
+    }
+    async readPaper(paperId, options = {}) {
+        return 'Wiley TDM API only supports PDF download. Use downloadPdf() method with a DOI to get the full PDF.';
+    }
+}
+//# sourceMappingURL=WileySearcher.js.map

package/dist/platforms/WileySearcher.js.map

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

package/dist/services/CitationService.d.ts

@@ -0,0 +1,66 @@
+export interface CitationData {
+    paperId: string;
+    title: string;
+    citationCount: number;
+    referenceCount: number;
+    influentialCitationCount?: number;
+    year?: number;
+    authors?: Array<{
+        name: string;
+        authorId?: string;
+    }>;
+    venue?: string;
+    doi?: string;
+    url?: string;
+}
+export interface BatchCitationRequest {
+    paperId?: string;
+    doi?: string;
+    arxivId?: string;
+    title?: string;
+}
+export declare class CitationService {
+    private client;
+    private cache;
+    private rateLimiter;
+    private apiKey?;
+    constructor(apiKey?: string);
+    /**
+     * Get citation data for a single paper by ID
+     */
+    getCitationData(paperId: string, forceRefresh?: boolean): Promise<CitationData | null>;
+    /**
+     * Get citation data by DOI
+     */
+    getCitationDataByDoi(doi: string, forceRefresh?: boolean): Promise<CitationData | null>;
+    /**
+     * Get citation data by arXiv ID
+     */
+    getCitationDataByArxiv(arxivId: string, forceRefresh?: boolean): Promise<CitationData | null>;
+    /**
+     * Batch lookup citations for multiple papers
+     */
+    batchLookup(requests: BatchCitationRequest[]): Promise<Map<string, CitationData | null>>;
+    /**
+     * Get references for a paper
+     */
+    getReferences(paperId: string, limit?: number): Promise<CitationData[]>;
+    /**
+     * Get citations for a paper
+     */
+    getCitations(paperId: string, limit?: number): Promise<CitationData[]>;
+    /**
+     * Parse Semantic Scholar response to CitationData
+     */
+    private parseCitationData;
+    /**
+     * Get cache statistics
+     */
+    getCacheStats(): import("../utils/RequestCache.js").CacheStats;
+    /**
+     * Clear cache
+     */
+    clearCache(): void;
+}
+export default CitationService;
+//# sourceMappingURL=CitationService.d.ts.map

package/dist/services/CitationService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CitationService.d.ts","sourceRoot":"","sources":["../../src/services/CitationService.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACrD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,KAAK,CAA6B;IAC1C,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,MAAM,CAAC,CAAS;gBAEZ,MAAM,CAAC,EAAE,MAAM;IA0B3B;;OAEG;IACG,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,GAAE,OAAe,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAkDnG;;OAEG;IACG,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,GAAE,OAAe,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAUpG;;OAEG;IACG,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,GAAE,OAAe,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAU1G;;OAEG;IACG,WAAW,CAAC,QAAQ,EAAE,oBAAoB,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAAC,CAAC;IAqC9F;;OAEG;IACG,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,GAAE,MAAY,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAkClF;;OAEG;IACG,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,GAAE,MAAY,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAkCjF;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAkBzB;;OAEG;IACH,aAAa;IAIb;;OAEG;IACH,UAAU;CAGX;AAED,eAAe,eAAe,CAAC"}

package/dist/services/CitationService.js

@@ -0,0 +1,237 @@
+import axios from 'axios';
+import { RequestCache } from '../utils/RequestCache.js';
+import { RateLimiter } from '../utils/RateLimiter.js';
+import { ErrorHandler } from '../utils/ErrorHandler.js';
+import { TIMEOUTS, USER_AGENT } from '../config/constants.js';
+import { logDebug, logWarn } from '../utils/Logger.js';
+export class CitationService {
+    client;
+    cache;
+    rateLimiter;
+    apiKey;
+    constructor(apiKey) {
+        this.apiKey = apiKey || process.env.SEMANTIC_SCHOLAR_API_KEY;
+        this.client = axios.create({
+            baseURL: 'https://api.semanticscholar.org/graph/v1',
+            timeout: TIMEOUTS.DEFAULT,
+            headers: {
+                'Accept': 'application/json',
+                'User-Agent': USER_AGENT,
+                ...(this.apiKey ? { 'x-api-key': this.apiKey } : {})
+            }
+        });
+        // Semantic Scholar rate limits: 100 req/5min (free), 1000 req/5min (paid)
+        const requestsPerMinute = this.apiKey ? 180 : 18;
+        this.rateLimiter = new RateLimiter({
+            requestsPerSecond: requestsPerMinute / 60,
+            burstCapacity: Math.max(3, Math.floor(requestsPerMinute / 20))
+        });
+        this.cache = new RequestCache({
+            maxSize: 500,
+            ttlMs: 86400000 // 24 hours
+        });
+    }
+    /**
+     * Get citation data for a single paper by ID
+     */
+    async getCitationData(paperId, forceRefresh = false) {
+        try {
+            // Check cache first
+            if (!forceRefresh) {
+                const cacheKey = this.cache.generateKey('citation', paperId, {});
+                const cached = this.cache.get(cacheKey);
+                if (cached) {
+                    return cached;
+                }
+            }
+            await this.rateLimiter.waitForPermission();
+            const fields = [
+                'paperId',
+                'title',
+                'citationCount',
+                'referenceCount',
+                'influentialCitationCount',
+                'year',
+                'authors',
+                'venue',
+                'externalIds',
+                'url'
+            ].join(',');
+            const response = await ErrorHandler.retryWithBackoff(() => this.client.get(`/paper/${paperId}`, {
+                params: { fields }
+            }), { context: 'Semantic Scholar citation lookup' });
+            if (response.status !== 200 || !response.data) {
+                return null;
+            }
+            const data = this.parseCitationData(response.data);
+            // Cache the result
+            const cacheKey = this.cache.generateKey('citation', paperId, {});
+            this.cache.set(cacheKey, data);
+            return data;
+        }
+        catch (error) {
+            logWarn(`Error fetching citation data for ${paperId}:`, error.message);
+            return null;
+        }
+    }
+    /**
+     * Get citation data by DOI
+     */
+    async getCitationDataByDoi(doi, forceRefresh = false) {
+        try {
+            const paperId = `DOI:${doi}`;
+            return await this.getCitationData(paperId, forceRefresh);
+        }
+        catch (error) {
+            logWarn(`Error fetching citation data by DOI ${doi}:`, error.message);
+            return null;
+        }
+    }
+    /**
+     * Get citation data by arXiv ID
+     */
+    async getCitationDataByArxiv(arxivId, forceRefresh = false) {
+        try {
+            const paperId = `ARXIV:${arxivId}`;
+            return await this.getCitationData(paperId, forceRefresh);
+        }
+        catch (error) {
+            logWarn(`Error fetching citation data by arXiv ID ${arxivId}:`, error.message);
+            return null;
+        }
+    }
+    /**
+     * Batch lookup citations for multiple papers
+     */
+    async batchLookup(requests) {
+        const results = new Map();
+        for (const request of requests) {
+            let paperId = null;
+            let key;
+            if (request.paperId) {
+                paperId = request.paperId;
+                key = request.paperId;
+            }
+            else if (request.doi) {
+                paperId = `DOI:${request.doi}`;
+                key = request.doi;
+            }
+            else if (request.arxivId) {
+                paperId = `ARXIV:${request.arxivId}`;
+                key = request.arxivId;
+            }
+            else if (request.title) {
+                key = request.title;
+                // Search by title (not implemented in this version)
+                results.set(key, null);
+                continue;
+            }
+            else {
+                continue;
+            }
+            try {
+                const data = await this.getCitationData(paperId);
+                results.set(key, data);
+            }
+            catch (error) {
+                logDebug(`Error in batch lookup for ${key}:`, error);
+                results.set(key, null);
+            }
+        }
+        return results;
+    }
+    /**
+     * Get references for a paper
+     */
+    async getReferences(paperId, limit = 100) {
+        try {
+            await this.rateLimiter.waitForPermission();
+            const fields = [
+                'paperId',
+                'title',
+                'citationCount',
+                'year',
+                'authors',
+                'venue'
+            ].join(',');
+            const response = await ErrorHandler.retryWithBackoff(() => this.client.get(`/paper/${paperId}/references`, {
+                params: { fields, limit }
+            }), { context: 'Semantic Scholar references lookup' });
+            if (response.status !== 200 || !response.data?.data) {
+                return [];
+            }
+            return response.data.data
+                .map((item) => item.citedPaper)
+                .filter((paper) => paper)
+                .map((paper) => this.parseCitationData(paper));
+        }
+        catch (error) {
+            logWarn(`Error fetching references for ${paperId}:`, error.message);
+            return [];
+        }
+    }
+    /**
+     * Get citations for a paper
+     */
+    async getCitations(paperId, limit = 100) {
+        try {
+            await this.rateLimiter.waitForPermission();
+            const fields = [
+                'paperId',
+                'title',
+                'citationCount',
+                'year',
+                'authors',
+                'venue'
+            ].join(',');
+            const response = await ErrorHandler.retryWithBackoff(() => this.client.get(`/paper/${paperId}/citations`, {
+                params: { fields, limit }
+            }), { context: 'Semantic Scholar citations lookup' });
+            if (response.status !== 200 || !response.data?.data) {
+                return [];
+            }
+            return response.data.data
+                .map((item) => item.citingPaper)
+                .filter((paper) => paper)
+                .map((paper) => this.parseCitationData(paper));
+        }
+        catch (error) {
+            logWarn(`Error fetching citations for ${paperId}:`, error.message);
+            return [];
+        }
+    }
+    /**
+     * Parse Semantic Scholar response to CitationData
+     */
+    parseCitationData(data) {
+        return {
+            paperId: data.paperId,
+            title: data.title,
+            citationCount: data.citationCount || 0,
+            referenceCount: data.referenceCount || 0,
+            influentialCitationCount: data.influentialCitationCount,
+            year: data.year,
+            authors: data.authors?.map((author) => ({
+                name: author.name,
+                authorId: author.authorId
+            })),
+            venue: data.venue,
+            doi: data.externalIds?.DOI,
+            url: data.url
+        };
+    }
+    /**
+     * Get cache statistics
+     */
+    getCacheStats() {
+        return this.cache.getStats();
+    }
+    /**
+     * Clear cache
+     */
+    clearCache() {
+        this.cache.clear();
+    }
+}
+export default CitationService;
+//# sourceMappingURL=CitationService.js.map

package/dist/services/CitationService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CitationService.js","sourceRoot":"","sources":["../../src/services/CitationService.ts"],"names":[],"mappings":"AAAA,OAAO,KAAwB,MAAM,OAAO,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAsBvD,MAAM,OAAO,eAAe;IAClB,MAAM,CAAgB;IACtB,KAAK,CAA6B;IAClC,WAAW,CAAc;IACzB,MAAM,CAAU;IAExB,YAAY,MAAe;QACzB,IAAI,CAAC,MAAM,GAAG,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC;QAE7D,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;YACzB,OAAO,EAAE,0CAA0C;YACnD,OAAO,EAAE,QAAQ,CAAC,OAAO;YACzB,OAAO,EAAE;gBACP,QAAQ,EAAE,kBAAkB;gBAC5B,YAAY,EAAE,UAAU;gBACxB,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACrD;SACF,CAAC,CAAC;QAEH,0EAA0E;QAC1E,MAAM,iBAAiB,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QACjD,IAAI,CAAC,WAAW,GAAG,IAAI,WAAW,CAAC;YACjC,iBAAiB,EAAE,iBAAiB,GAAG,EAAE;YACzC,aAAa,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,iBAAiB,GAAG,EAAE,CAAC,CAAC;SAC/D,CAAC,CAAC;QAEH,IAAI,CAAC,KAAK,GAAG,IAAI,YAAY,CAAe;YAC1C,OAAO,EAAE,GAAG;YACZ,KAAK,EAAE,QAAQ,CAAC,WAAW;SAC5B,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,eAAe,CAAC,OAAe,EAAE,eAAwB,KAAK;QAClE,IAAI,CAAC;YACH,oBAAoB;YACpB,IAAI,CAAC,YAAY,EAAE,CAAC;gBAClB,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,UAAU,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC;gBACjE,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;gBACxC,IAAI,MAAM,EAAE,CAAC;oBACX,OAAO,MAAM,CAAC;gBAChB,CAAC;YACH,CAAC;YAED,MAAM,IAAI,CAAC,WAAW,CAAC,iBAAiB,EAAE,CAAC;YAE3C,MAAM,MAAM,GAAG;gBACb,SAAS;gBACT,OAAO;gBACP,eAAe;gBACf,gBAAgB;gBAChB,0BAA0B;gBAC1B,MAAM;gBACN,SAAS;gBACT,OAAO;gBACP,aAAa;gBACb,KAAK;aACN,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAEZ,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,gBAAgB,CAClD,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,OAAO,EAAE,EAAE;gBACzC,MAAM,EAAE,EAAE,MAAM,EAAE;aACnB,CAAC,EACF,EAAE,OAAO,EAAE,kCAAkC,EAAE,CAChD,CAAC;YAEF,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;gBAC9C,OAAO,IAAI,CAAC;YACd,CAAC;YAED,MAAM,IAAI,GAAG,IAAI,CAAC,iBAAiB,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;YAEnD,mBAAmB;YACnB,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,UAAU,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC;YACjE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;YAE/B,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,OAAO,CAAC,oCAAoC,OAAO,GAAG,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;YACvE,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,oBAAoB,CAAC,GAAW,EAAE,eAAwB,KAAK;QACnE,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,OAAO,GAAG,EAAE,CAAC;YAC7B,OAAO,MAAM,IAAI,CAAC,eAAe,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;QAC3D,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,OAAO,CAAC,uCAAuC,GAAG,GAAG,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;YACtE,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,sBAAsB,CAAC,OAAe,EAAE,eAAwB,KAAK;QACzE,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,SAAS,OAAO,EAAE,CAAC;YACnC,OAAO,MAAM,IAAI,CAAC,eAAe,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;QAC3D,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,OAAO,CAAC,4CAA4C,OAAO,GAAG,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;YAC/E,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,WAAW,CAAC,QAAgC;QAChD,MAAM,OAAO,GAAG,IAAI,GAAG,EAA+B,CAAC;QAEvD,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,IAAI,OAAO,GAAkB,IAAI,CAAC;YAClC,IAAI,GAAW,CAAC;YAEhB,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;gBACpB,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;gBAC1B,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC;YACxB,CAAC;iBAAM,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;gBACvB,OAAO,GAAG,OAAO,OAAO,CAAC,GAAG,EAAE,CAAC;gBAC/B,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;YACpB,CAAC;iBAAM,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;gBAC3B,OAAO,GAAG,SAAS,OAAO,CAAC,OAAO,EAAE,CAAC;gBACrC,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC;YACxB,CAAC;iBAAM,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;gBACzB,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC;gBACpB,oDAAoD;gBACpD,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;gBACvB,SAAS;YACX,CAAC;iBAAM,CAAC;gBACN,SAAS;YACX,CAAC;YAED,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;gBACjD,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YACzB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,QAAQ,CAAC,6BAA6B,GAAG,GAAG,EAAE,KAAK,CAAC,CAAC;gBACrD,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YACzB,CAAC;QACH,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,aAAa,CAAC,OAAe,EAAE,QAAgB,GAAG;QACtD,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,WAAW,CAAC,iBAAiB,EAAE,CAAC;YAE3C,MAAM,MAAM,GAAG;gBACb,SAAS;gBACT,OAAO;gBACP,eAAe;gBACf,MAAM;gBACN,SAAS;gBACT,OAAO;aACR,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAEZ,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,gBAAgB,CAClD,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,OAAO,aAAa,EAAE;gBACpD,MAAM,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE;aAC1B,CAAC,EACF,EAAE,OAAO,EAAE,oCAAoC,EAAE,CAClD,CAAC;YAEF,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC;gBACpD,OAAO,EAAE,CAAC;YACZ,CAAC;YAED,OAAO,QAAQ,CAAC,IAAI,CAAC,IAAI;iBACtB,GAAG,CAAC,CAAC,IAAS,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC;iBACnC,MAAM,CAAC,CAAC,KAAU,EAAE,EAAE,CAAC,KAAK,CAAC;iBAC7B,GAAG,CAAC,CAAC,KAAU,EAAE,EAAE,CAAC,IAAI,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC,CAAC;QACxD,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,OAAO,CAAC,iCAAiC,OAAO,GAAG,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;YACpE,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,YAAY,CAAC,OAAe,EAAE,QAAgB,GAAG;QACrD,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,WAAW,CAAC,iBAAiB,EAAE,CAAC;YAE3C,MAAM,MAAM,GAAG;gBACb,SAAS;gBACT,OAAO;gBACP,eAAe;gBACf,MAAM;gBACN,SAAS;gBACT,OAAO;aACR,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAEZ,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,gBAAgB,CAClD,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,OAAO,YAAY,EAAE;gBACnD,MAAM,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE;aAC1B,CAAC,EACF,EAAE,OAAO,EAAE,mCAAmC,EAAE,CACjD,CAAC;YAEF,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC;gBACpD,OAAO,EAAE,CAAC;YACZ,CAAC;YAED,OAAO,QAAQ,CAAC,IAAI,CAAC,IAAI;iBACtB,GAAG,CAAC,CAAC,IAAS,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC;iBACpC,MAAM,CAAC,CAAC,KAAU,EAAE,EAAE,CAAC,KAAK,CAAC;iBAC7B,GAAG,CAAC,CAAC,KAAU,EAAE,EAAE,CAAC,IAAI,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC,CAAC;QACxD,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,OAAO,CAAC,gCAAgC,OAAO,GAAG,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;YACnE,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IAED;;OAEG;IACK,iBAAiB,CAAC,IAAS;QACjC,OAAO;YACL,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,aAAa,EAAE,IAAI,CAAC,aAAa,IAAI,CAAC;YACtC,cAAc,EAAE,IAAI,CAAC,cAAc,IAAI,CAAC;YACxC,wBAAwB,EAAE,IAAI,CAAC,wBAAwB;YACvD,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,MAAW,EAAE,EAAE,CAAC,CAAC;gBAC3C,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,QAAQ,EAAE,MAAM,CAAC,QAAQ;aAC1B,CAAC,CAAC;YACH,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,GAAG,EAAE,IAAI,CAAC,WAAW,EAAE,GAAG;YAC1B,GAAG,EAAE,IAAI,CAAC,GAAG;SACd,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,aAAa;QACX,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;IAC/B,CAAC;IAED;;OAEG;IACH,UAAU;QACR,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;CACF;AAED,eAAe,eAAe,CAAC"}

package/dist/services/MultiSourceSearchService.d.ts

@@ -0,0 +1,19 @@
+import type { Searchers } from '../core/searchers.js';
+import { Paper } from '../models/Paper.js';
+import { SearchOptions } from '../platforms/PaperSource.js';
+export interface MultiSourceSearchResult {
+    query: string;
+    sources_requested: string;
+    sources_used: string[];
+    source_results: Record<string, number>;
+    errors: Record<string, string>;
+    failed_sources: string[];
+    warnings: string[];
+    total: number;
+    raw_total: number;
+    papers: Record<string, unknown>[];
+}
+export declare function parseSourceList(sources: string | undefined, searchers: Searchers): string[];
+export declare function searchMultipleSources(searchers: Searchers, query: string, sources: string, options: SearchOptions, sourceTimeoutMs?: number): Promise<MultiSourceSearchResult>;
+export declare function dedupePapers(papers: Paper[]): Paper[];
+//# sourceMappingURL=MultiSourceSearchService.d.ts.map

package/dist/services/MultiSourceSearchService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MultiSourceSearchService.d.ts","sourceRoot":"","sources":["../../src/services/MultiSourceSearchService.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEtD,OAAO,EAAE,KAAK,EAAgB,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAe,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAGzE,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,iBAAiB,EAAE,MAAM,CAAC;IAC1B,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;CACnC;AAuBD,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,EAAE,SAAS,EAAE,SAAS,GAAG,MAAM,EAAE,CAc3F;AAED,wBAAsB,qBAAqB,CACzC,SAAS,EAAE,SAAS,EACpB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,aAAa,EACtB,eAAe,GAAE,MAA6B,GAC7C,OAAO,CAAC,uBAAuB,CAAC,CA8ClC;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,EAAE,CAYrD"}

package/dist/services/MultiSourceSearchService.js

@@ -0,0 +1,96 @@
+import { TIMEOUTS } from '../config/constants.js';
+import { PaperFactory } from '../models/Paper.js';
+import { withTimeout } from '../utils/SecurityUtils.js';
+const DEFAULT_ALL_SOURCES = [
+    'crossref',
+    'openalex',
+    'pubmed',
+    'pmc',
+    'europepmc',
+    'arxiv',
+    'biorxiv',
+    'medrxiv',
+    'iacr',
+    'core',
+    'openaire'
+];
+const ALIASES = {
+    google_scholar: 'googlescholar',
+    webofscience: 'webofscience',
+    wos: 'webofscience',
+    europe_pmc: 'europepmc',
+    pubmed_central: 'pmc'
+};
+export function parseSourceList(sources, searchers) {
+    const requested = !sources || sources.trim() === '' ? 'crossref' : sources.trim();
+    if (requested.toLowerCase() === 'all') {
+        return DEFAULT_ALL_SOURCES.filter(source => source in searchers);
+    }
+    return requested
+        .split(',')
+        .map(source => source.trim().toLowerCase())
+        .filter(Boolean)
+        .map(source => ALIASES[source] || source)
+        .filter((source, index, values) => values.indexOf(source) === index)
+        .filter(source => source in searchers);
+}
+export async function searchMultipleSources(searchers, query, sources, options, sourceTimeoutMs = TIMEOUTS.SOURCE_TASK) {
+    const selected = parseSourceList(sources, searchers);
+    const settled = await Promise.allSettled(selected.map(async (source) => {
+        const searcher = searchers[source];
+        const results = await withTimeout(searcher.search(query, options), sourceTimeoutMs, `${source} search timed out after ${sourceTimeoutMs}ms`);
+        return { source, results };
+    }));
+    const sourceResults = {};
+    const errors = {};
+    const failedSources = [];
+    const merged = [];
+    for (let i = 0; i < settled.length; i += 1) {
+        const source = selected[i];
+        const result = settled[i];
+        if (result.status === 'rejected') {
+            sourceResults[source] = 0;
+            errors[source] = result.reason?.message || String(result.reason);
+            failedSources.push(source);
+            continue;
+        }
+        sourceResults[source] = result.value.results.length;
+        merged.push(...result.value.results);
+    }
+    const deduped = dedupePapers(merged);
+    return {
+        query,
+        sources_requested: sources,
+        sources_used: selected,
+        source_results: sourceResults,
+        errors,
+        failed_sources: failedSources,
+        warnings: failedSources.map(source => `${source}: ${errors[source]}`),
+        total: deduped.length,
+        raw_total: merged.length,
+        papers: deduped.map(paper => PaperFactory.toDict(paper))
+    };
+}
+export function dedupePapers(papers) {
+    const seen = new Set();
+    const out = [];
+    for (const paper of papers) {
+        const key = paperKey(paper);
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        out.push(paper);
+    }
+    return out;
+}
+function paperKey(paper) {
+    const doi = paper.doi.trim().toLowerCase();
+    if (doi)
+        return `doi:${doi}`;
+    const title = paper.title.trim().toLowerCase();
+    const authors = paper.authors.join(';').trim().toLowerCase();
+    if (title)
+        return `title:${title}|authors:${authors}`;
+    return `id:${paper.source}:${paper.paperId}`;
+}
+//# sourceMappingURL=MultiSourceSearchService.js.map

package/dist/services/MultiSourceSearchService.js.map

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