paper-search-cli 0.1.0

package/dist/platforms/SpringerSearcher.js

@@ -0,0 +1,407 @@
+/**
+ * Springer Nature Searcher
+ *
+ * Documentation: https://dev.springernature.com/
+ * API Endpoints:
+ * - Metadata API v2: https://api.springernature.com/meta/v2/json
+ * - OpenAccess API: https://api.springernature.com/openaccess/json (if available with your key)
+ *
+ * Required API Key: Yes (api_key parameter)
+ * Get API key from: https://dev.springernature.com/signup
+ *
+ * Note: Meta API v2 is the primary API. OpenAccess API may require special access.
+ */
+import axios from 'axios';
+import { sanitizeDoi, escapeQueryValue, withTimeout } from '../utils/SecurityUtils.js';
+import { PaperSource } from './PaperSource.js';
+import { PaperFactory } from '../models/Paper.js';
+import { RateLimiter } from '../utils/RateLimiter.js';
+import { ErrorHandler } from '../utils/ErrorHandler.js';
+import { QuotaManager } from '../utils/QuotaManager.js';
+import { logDebug, logWarn } from '../utils/Logger.js';
+import { TIMEOUTS, USER_AGENT } from '../config/constants.js';
+export class SpringerSearcher extends PaperSource {
+    metadataClient;
+    openAccessClient;
+    rateLimiter;
+    quotaManager;
+    hasOpenAccessAPI;
+    openAccessApiKey;
+    testingPromise = null;
+    constructor(apiKey, openAccessApiKey) {
+        super('springer', 'https://api.springernature.com', apiKey);
+        // Check for separate OpenAccess API key from environment
+        this.openAccessApiKey = openAccessApiKey || process.env.SPRINGER_OPENACCESS_API_KEY || apiKey;
+        // Use v2 API endpoint for metadata
+        this.metadataClient = axios.create({
+            baseURL: 'https://api.springernature.com/meta/v2',
+            timeout: TIMEOUTS.DEFAULT,
+            headers: {
+                'Accept': 'application/json',
+                'User-Agent': USER_AGENT
+            }
+        });
+        // OpenAccess API client (may not be available for all API keys)
+        this.openAccessClient = axios.create({
+            baseURL: 'https://api.springernature.com/openaccess',
+            timeout: TIMEOUTS.DEFAULT,
+            headers: {
+                'Accept': 'application/json',
+                'User-Agent': USER_AGENT
+            }
+        });
+        // Springer rate limits:
+        // - 5000 requests per day for both APIs combined
+        // - Approximately 200 per hour or 3-4 per minute to be safe
+        // Note: The same API key works for both Metadata and OpenAccess APIs
+        this.rateLimiter = new RateLimiter({
+            requestsPerSecond: 0.05, // Conservative: 3 per minute
+            burstCapacity: 5
+        });
+        this.quotaManager = QuotaManager.getInstance();
+        this.quotaManager.registerPlatform('springer', {
+            dailyLimit: 5000,
+            envPrefix: 'SPRINGER'
+        });
+    }
+    async search(query, options = {}) {
+        const customOptions = options;
+        if (!this.apiKey) {
+            throw new Error('Springer API key is required');
+        }
+        const maxResults = Math.min(options.maxResults || 10, 100);
+        const papers = [];
+        try {
+            // Decide which API to use
+            let useOpenAccess = customOptions.openAccess === true;
+            // If openAccess is requested and we haven't tested the API yet, test it
+            if (useOpenAccess && this.hasOpenAccessAPI === undefined) {
+                await this.testOpenAccessAPI();
+            }
+            // Fall back to Meta API if OpenAccess API is not available
+            if (useOpenAccess && !this.hasOpenAccessAPI) {
+                logDebug('OpenAccess API not available, using Meta API with filtering');
+                useOpenAccess = false;
+            }
+            // Build query parameters
+            const params = {
+                q: query,
+                api_key: useOpenAccess ? this.openAccessApiKey : this.apiKey,
+                s: 1, // start index
+                p: maxResults // page size
+            };
+            // Add filters - Note: Some filters may require premium access
+            if (options.author) {
+                const sanitizedAuthor = this.sanitizeQueryValue(options.author);
+                params.q += ` name:"${sanitizedAuthor}"`;
+            }
+            if (options.journal) {
+                const sanitizedJournal = this.sanitizeQueryValue(options.journal);
+                params.q += ` pub:"${sanitizedJournal}"`;
+            }
+            if (options.year) {
+                // Year filter may cause 403 for some API keys
+                if (options.year.includes('-')) {
+                    const [startYear, endYear] = options.year.split('-');
+                    params.q += ` year:${startYear} TO ${endYear || '*'}`;
+                }
+                else {
+                    params.q += ` year:${options.year}`;
+                }
+            }
+            if (customOptions.subject) {
+                // Subject filter may cause 403 for some API keys
+                const sanitizedSubject = this.sanitizeQueryValue(customOptions.subject);
+                params.q += ` subject:"${sanitizedSubject}"`;
+            }
+            if (customOptions.type) {
+                // Type filter generally works
+                params.q += ` type:${customOptions.type}`;
+            }
+            await this.rateLimiter.waitForPermission();
+            this.quotaManager.checkQuota('springer');
+            // Choose the appropriate API
+            let response;
+            if (useOpenAccess) {
+                response = await ErrorHandler.retryWithBackoff(() => this.openAccessClient.get('/json', { params }), { context: 'Springer OpenAccess search' });
+            }
+            else {
+                response = await ErrorHandler.retryWithBackoff(() => this.metadataClient.get('/json', { params }), { context: 'Springer Meta search' });
+            }
+            this.quotaManager.incrementUsage('springer');
+            // Handle different response structures
+            // Meta v2 API: records contains the actual papers, result contains metadata
+            // OpenAccess API: might use either records or result for the actual papers
+            let results = [];
+            // For Meta v2 API, records is always the array of papers
+            if (response.data.records && Array.isArray(response.data.records)) {
+                results = response.data.records;
+            }
+            // For older API versions or different response format
+            else if (response.data.result && Array.isArray(response.data.result) &&
+                response.data.result.length > 0 &&
+                response.data.result[0].title) {
+                // If result contains actual papers (has title field), use it
+                results = response.data.result;
+            }
+            if (results && results.length > 0) {
+                for (const result of results) {
+                    const paper = this.parseResult(result);
+                    if (paper) {
+                        // If openAccess filter was requested but using Meta API, filter results
+                        if (customOptions.openAccess && !useOpenAccess && result.openaccess !== 'true') {
+                            continue;
+                        }
+                        papers.push(paper);
+                    }
+                }
+            }
+            return papers;
+        }
+        catch (error) {
+            if (error.response?.status === 401) {
+                this.handleHttpError(error, 'search');
+            }
+            if (error.response?.status === 403) {
+                // Some filters require premium access
+                logWarn('Springer API returned 403 - some filters may require premium access');
+                // Try a simpler query without advanced filters
+                if (options.year || customOptions.subject) {
+                    logDebug('Retrying without year/subject filters...');
+                    const simpleOptions = { ...options };
+                    delete simpleOptions.year;
+                    delete simpleOptions.subject;
+                    return this.search(query, simpleOptions);
+                }
+                this.handleHttpError(error, 'search');
+            }
+            if (error.response?.status === 429) {
+                this.handleHttpError(error, 'search');
+            }
+            this.handleHttpError(error, 'search');
+        }
+    }
+    parseResult(result) {
+        try {
+            // Extract authors
+            const authors = result.creators?.map(c => c.creator).join(', ') || '';
+            // Extract URL
+            let paperUrl;
+            let pdfUrl;
+            if (result.url && result.url.length > 0) {
+                for (const urlObj of result.url) {
+                    if (urlObj.format === 'pdf') {
+                        pdfUrl = urlObj.value;
+                    }
+                    else if (!paperUrl) {
+                        paperUrl = urlObj.value;
+                    }
+                }
+            }
+            // If no URL found, construct from DOI
+            if (!paperUrl && result.doi) {
+                paperUrl = `https://doi.org/${result.doi}`;
+            }
+            // Extract page range
+            let pages;
+            if (result.startingPage && result.endingPage) {
+                pages = `${result.startingPage}-${result.endingPage}`;
+            }
+            else if (result.startingPage) {
+                pages = result.startingPage;
+            }
+            return PaperFactory.create({
+                paperId: result.doi || result.identifier || '',
+                title: result.title || '',
+                authors: authors ? authors.split(', ') : [],
+                abstract: result.abstract || '',
+                doi: result.doi,
+                publishedDate: result.publicationDate ? new Date(result.publicationDate) : null,
+                pdfUrl: pdfUrl,
+                url: paperUrl,
+                source: 'springer',
+                journal: result.publicationName,
+                volume: result.volume,
+                issue: result.number,
+                pages: pages,
+                extra: {
+                    isbn: result.isbn,
+                    issn: result.issn,
+                    contentType: result.contentType,
+                    genre: result.genre,
+                    language: result.language,
+                    openAccess: result.openaccess === 'true',
+                    copyright: result.copyright
+                }
+            });
+        }
+        catch (error) {
+            logDebug('Error parsing Springer result:', error);
+            return null;
+        }
+    }
+    async downloadPdf(doi, options = {}) {
+        // Search for the paper and check if it has a PDF URL
+        const papers = await this.search(doi, { maxResults: 1 });
+        if (papers.length === 0) {
+            throw new Error('Paper not found');
+        }
+        if (!papers[0].pdfUrl) {
+            // Try searching with openAccess filter to get PDF links
+            const openAccessPapers = await this.search(doi, { maxResults: 1, openAccess: true });
+            if (openAccessPapers.length === 0 || !openAccessPapers[0].pdfUrl) {
+                throw new Error('PDF not available (may require institutional access or not be open access)');
+            }
+            papers[0] = openAccessPapers[0];
+        }
+        const paper = papers[0];
+        if (!paper.pdfUrl) {
+            throw new Error('PDF URL not available for this paper');
+        }
+        // Download PDF
+        const fs = await import('fs');
+        const path = await import('path');
+        const savePath = options.savePath || './downloads';
+        if (!fs.existsSync(savePath)) {
+            fs.mkdirSync(savePath, { recursive: true });
+        }
+        const fileName = `${doi.replace(/[\/\\:*?"<>|]/g, '_')}.pdf`;
+        const filePath = path.join(savePath, fileName);
+        try {
+            const response = await ErrorHandler.retryWithBackoff(() => axios.get(paper.pdfUrl, { responseType: 'stream' }), { context: 'Springer download' });
+            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) {
+            throw new Error(`Failed to download PDF: ${error.message}`);
+        }
+    }
+    getCapabilities() {
+        return {
+            search: true,
+            download: true,
+            fullText: false,
+            citations: true,
+            requiresApiKey: true,
+            supportedOptions: ['maxResults', 'year', 'author', 'journal', 'openAccess', 'subject', 'type']
+        };
+    }
+    /**
+     * 获取引用此论文的文献列表(通过Crossref/OpenCitations)
+     */
+    async getCitations(doi) {
+        try {
+            // Validate DOI format
+            if (!doi || typeof doi !== 'string') {
+                throw new Error('Invalid DOI: must be a non-empty string');
+            }
+            // Sanitize and validate DOI
+            const doiValidation = sanitizeDoi(doi);
+            if (!doiValidation.valid) {
+                throw new Error(`Invalid DOI: ${doiValidation.error}`);
+            }
+            const { CrossrefSearcher } = await import('./CrossrefSearcher.js');
+            const crossref = new CrossrefSearcher();
+            // Add timeout wrapper for Crossref API calls
+            return await withTimeout(crossref.getCitations(doiValidation.sanitized), TIMEOUTS.HEALTH_CHECK, 'Crossref citation request timed out');
+        }
+        catch (error) {
+            // Don't log the DOI in case it's sensitive
+            logDebug('Error getting Springer citations:', error instanceof Error ? error.message : 'Unknown error');
+            return [];
+        }
+    }
+    /**
+     * 获取论文的参考文献列表(通过Crossref)
+     */
+    async getReferences(doi) {
+        try {
+            // Validate DOI format
+            if (!doi || typeof doi !== 'string') {
+                throw new Error('Invalid DOI: must be a non-empty string');
+            }
+            // Sanitize and validate DOI
+            const doiValidation = sanitizeDoi(doi);
+            if (!doiValidation.valid) {
+                throw new Error(`Invalid DOI: ${doiValidation.error}`);
+            }
+            const { CrossrefSearcher } = await import('./CrossrefSearcher.js');
+            const crossref = new CrossrefSearcher();
+            // Add timeout wrapper for Crossref API calls
+            return await withTimeout(crossref.getReferences(doiValidation.sanitized), TIMEOUTS.HEALTH_CHECK, 'Crossref references request timed out');
+        }
+        catch (error) {
+            // Don't log the DOI in case it's sensitive
+            logDebug('Error getting Springer references:', error instanceof Error ? error.message : 'Unknown error');
+            return [];
+        }
+    }
+    /**
+     * 清理和转义查询参数中的特殊字符
+     */
+    sanitizeQueryValue(value, context = 'general') {
+        return escapeQueryValue(value, 'springer');
+    }
+    /**
+     * Test if OpenAccess API is available for this API key
+     * Uses promise caching to prevent race conditions with concurrent requests
+     */
+    async testOpenAccessAPI() {
+        // Already tested
+        if (this.hasOpenAccessAPI !== undefined) {
+            return;
+        }
+        // Test already in progress - wait for it
+        if (this.testingPromise) {
+            return this.testingPromise;
+        }
+        // Start new test and cache the promise
+        this.testingPromise = this.performOpenAccessTest();
+        try {
+            await this.testingPromise;
+        }
+        finally {
+            this.testingPromise = null;
+        }
+    }
+    /**
+     * Perform the actual OpenAccess API test
+     */
+    async performOpenAccessTest() {
+        try {
+            const response = await this.openAccessClient.get('/json', {
+                params: {
+                    q: 'test',
+                    api_key: this.openAccessApiKey,
+                    s: 1,
+                    p: 1
+                }
+            });
+            this.hasOpenAccessAPI = response.status === 200;
+            logDebug('OpenAccess API is available');
+        }
+        catch (error) {
+            if (error.response?.status === 401) {
+                this.hasOpenAccessAPI = false;
+                logDebug('OpenAccess API is not available (401 Unauthorized - check API key permissions)');
+            }
+            else {
+                // Network error or other issue, assume not available
+                this.hasOpenAccessAPI = false;
+                logDebug('OpenAccess API test failed:', error.message);
+            }
+        }
+    }
+    async readPaper(paperId, options = {}) {
+        const papers = await this.search(paperId, { maxResults: 1 });
+        if (papers.length === 0) {
+            throw new Error('Paper not found');
+        }
+        return papers[0].abstract || 'Abstract not available';
+    }
+}
+//# sourceMappingURL=SpringerSearcher.js.map

package/dist/platforms/SpringerSearcher.js.map

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

package/dist/platforms/UnpaywallSearcher.d.ts

@@ -0,0 +1,18 @@
+import { Paper } from '../models/Paper.js';
+import { PaperSource, SearchOptions, DownloadOptions, PlatformCapabilities } from './PaperSource.js';
+export declare class UnpaywallSearcher extends PaperSource {
+    private readonly client;
+    private readonly email;
+    constructor(email?: string);
+    getCapabilities(): PlatformCapabilities;
+    hasApiKey(): boolean;
+    search(query: string, _options?: SearchOptions): Promise<Paper[]>;
+    getPaperByDoi(doi: string): Promise<Paper | null>;
+    resolveBestPdfUrl(doi: string): Promise<string>;
+    downloadPdf(_paperId: string, _options?: DownloadOptions): Promise<string>;
+    readPaper(_paperId: string, _options?: DownloadOptions): Promise<string>;
+    private parseRecord;
+    private firstLocationUrl;
+    private extractDoi;
+}
+//# sourceMappingURL=UnpaywallSearcher.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"UnpaywallSearcher.d.ts","sourceRoot":"","sources":["../../src/platforms/UnpaywallSearcher.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAgB,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AA+BrG,qBAAa,iBAAkB,SAAQ,WAAW;IAChD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;gBAEnB,KAAK,CAAC,EAAE,MAAM;IAgB1B,eAAe,IAAI,oBAAoB;IAWvC,SAAS,IAAI,OAAO;IAId,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,GAAE,aAAkB,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAQrE,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC;IAqBjD,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAK/C,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,GAAE,eAAoB,GAAG,OAAO,CAAC,MAAM,CAAC;IAI9E,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,GAAE,eAAoB,GAAG,OAAO,CAAC,MAAM,CAAC;IAIlF,OAAO,CAAC,WAAW;IA6BnB,OAAO,CAAC,gBAAgB;IAQxB,OAAO,CAAC,UAAU;CAKnB"}

package/dist/platforms/UnpaywallSearcher.js

@@ -0,0 +1,115 @@
+import axios from 'axios';
+import { PaperFactory } from '../models/Paper.js';
+import { PaperSource } from './PaperSource.js';
+import { TIMEOUTS, USER_AGENT } from '../config/constants.js';
+import { sanitizeDoi } from '../utils/SecurityUtils.js';
+export class UnpaywallSearcher extends PaperSource {
+    client;
+    email;
+    constructor(email) {
+        const configuredEmail = email || process.env.PAPER_SEARCH_UNPAYWALL_EMAIL || process.env.UNPAYWALL_EMAIL || '';
+        super('unpaywall', 'https://api.unpaywall.org/v2', configuredEmail);
+        this.email = configuredEmail.trim();
+        this.client = axios.create({
+            baseURL: this.baseUrl,
+            timeout: TIMEOUTS.DEFAULT,
+            headers: {
+                Accept: 'application/json',
+                'User-Agent': `${USER_AGENT} (https://github.com/dr-dumpling/paper-search-cli)`
+            },
+            validateStatus: status => status < 500
+        });
+    }
+    getCapabilities() {
+        return {
+            search: true,
+            download: false,
+            fullText: false,
+            citations: false,
+            requiresApiKey: true,
+            supportedOptions: ['maxResults']
+        };
+    }
+    hasApiKey() {
+        return Boolean(this.email);
+    }
+    async search(query, _options = {}) {
+        const doi = this.extractDoi(query);
+        if (!doi || !this.email)
+            return [];
+        const paper = await this.getPaperByDoi(doi);
+        return paper ? [paper] : [];
+    }
+    async getPaperByDoi(doi) {
+        if (!this.email)
+            return null;
+        const cleanDoi = this.extractDoi(doi);
+        if (!cleanDoi)
+            return null;
+        try {
+            const response = await this.client.get(`/${encodeURIComponent(cleanDoi)}`, {
+                params: { email: this.email }
+            });
+            if (response.status === 404 || response.status === 422)
+                return null;
+            if (response.status >= 400) {
+                throw new Error(`Unpaywall request failed with HTTP ${response.status}`);
+            }
+            return this.parseRecord(response.data, cleanDoi);
+        }
+        catch (error) {
+            this.handleHttpError(error, 'getPaperByDoi');
+        }
+    }
+    async resolveBestPdfUrl(doi) {
+        const paper = await this.getPaperByDoi(doi);
+        return paper?.pdfUrl || '';
+    }
+    async downloadPdf(_paperId, _options = {}) {
+        throw new Error('Unpaywall does not host PDFs. Use returned pdf_url with download_with_fallback.');
+    }
+    async readPaper(_paperId, _options = {}) {
+        throw new Error('Unpaywall provides OA metadata only; it does not provide full text.');
+    }
+    parseRecord(record, doi) {
+        const best = record.best_oa_location || {};
+        const pdfUrl = best.url_for_pdf || best.url || this.firstLocationUrl(record.oa_locations || []);
+        const authors = (record.z_authors || [])
+            .map(author => `${author.given || ''} ${author.family || ''}`.trim())
+            .filter(Boolean);
+        return PaperFactory.create({
+            paperId: `unpaywall:${doi}`,
+            title: record.title || doi,
+            authors,
+            abstract: '',
+            doi: record.doi || doi,
+            publishedDate: record.published_date ? this.parseDate(record.published_date) : null,
+            pdfUrl: pdfUrl || '',
+            url: best.url || record.doi_url || `https://doi.org/${doi}`,
+            source: 'unpaywall',
+            journal: record.journal_name || '',
+            extra: {
+                isOpenAccess: Boolean(record.is_oa),
+                oaStatus: record.oa_status || '',
+                publisher: record.publisher || '',
+                hostType: best.host_type || '',
+                license: best.license || '',
+                version: best.version || ''
+            }
+        });
+    }
+    firstLocationUrl(locations) {
+        for (const location of locations) {
+            const candidate = location.url_for_pdf || location.url || '';
+            if (candidate)
+                return candidate;
+        }
+        return '';
+    }
+    extractDoi(value) {
+        const candidate = value.match(/10\.\d{4,9}\/[-._;()/:A-Z0-9]+/i)?.[0] || value;
+        const result = sanitizeDoi(candidate);
+        return result.valid ? result.sanitized : '';
+    }
+}
+//# sourceMappingURL=UnpaywallSearcher.js.map

package/dist/platforms/UnpaywallSearcher.js.map

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