paper-search-cli 0.1.0

package/dist/platforms/PMCSearcher.js.map

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

package/dist/platforms/PaperSource.d.ts

@@ -0,0 +1,143 @@
+/**
+ * 学术论文搜索平台的抽象基类
+ * 定义了所有平台搜索器必须实现的核心接口
+ */
+import { Paper } from '../models/Paper.js';
+import { ErrorHandler } from '../utils/ErrorHandler.js';
+export interface SearchOptions {
+    /** 最大结果数量 */
+    maxResults?: number;
+    /** 年份过滤 */
+    year?: string;
+    /** 作者过滤 */
+    author?: string;
+    /** 期刊过滤 */
+    journal?: string;
+    /** 学科分类过滤 */
+    category?: string;
+    /** 排序方式 */
+    sortBy?: 'relevance' | 'date' | 'citations';
+    /** 排序顺序 */
+    sortOrder?: 'asc' | 'desc';
+    /** 搜索天数范围 (bioRxiv/medRxiv) */
+    days?: number;
+    /** 是否获取详细信息 (IACR) */
+    fetchDetails?: boolean;
+    /** 研究领域过滤 (Semantic Scholar) */
+    fieldsOfStudy?: string[];
+    /** 开放获取过滤 (Springer/ScienceDirect/Scopus) */
+    openAccess?: boolean;
+    /** 主题过滤 (Springer/Scopus) */
+    subject?: string;
+    /** 出版物类型过滤 (Springer) */
+    type?: 'Journal' | 'Book' | 'Chapter';
+    /** 机构过滤 (Scopus) */
+    affiliation?: string;
+    /** 文档类型过滤 (Scopus) */
+    documentType?: 'ar' | 'cp' | 're' | 'bk' | 'ch';
+    /** 出版物类型 (PubMed) */
+    publicationType?: string[];
+}
+export interface DownloadOptions {
+    /** 保存路径 */
+    savePath?: string;
+    /** 是否覆盖现有文件 */
+    overwrite?: boolean;
+}
+export interface PlatformCapabilities {
+    /** 是否支持搜索 */
+    search: boolean;
+    /** 是否支持PDF下载 */
+    download: boolean;
+    /** 是否支持全文提取 */
+    fullText: boolean;
+    /** 是否支持被引统计 */
+    citations: boolean;
+    /** 是否需要API密钥 */
+    requiresApiKey: boolean;
+    /** 支持的搜索选项 */
+    supportedOptions: (keyof SearchOptions)[];
+}
+/**
+ * 抽象基类：论文搜索平台
+ */
+export declare abstract class PaperSource {
+    protected readonly baseUrl: string;
+    protected readonly apiKey?: string;
+    protected readonly platformName: string;
+    protected readonly errorHandler: ErrorHandler;
+    constructor(platformName: string, baseUrl: string, apiKey?: string);
+    /**
+     * 获取平台能力描述
+     */
+    abstract getCapabilities(): PlatformCapabilities;
+    /**
+     * 搜索论文
+     * @param query 搜索查询字符串
+     * @param options 搜索选项
+     * @returns Promise<Paper[]> 论文列表
+     */
+    abstract search(query: string, options?: SearchOptions): Promise<Paper[]>;
+    /**
+     * 下载PDF文件
+     * @param paperId 论文ID
+     * @param options 下载选项
+     * @returns Promise<string> 下载文件的路径
+     */
+    abstract downloadPdf(paperId: string, options?: DownloadOptions): Promise<string>;
+    /**
+     * 读取论文全文内容
+     * @param paperId 论文ID
+     * @param options 下载选项（如果需要先下载）
+     * @returns Promise<string> 论文全文内容
+     */
+    abstract readPaper(paperId: string, options?: DownloadOptions): Promise<string>;
+    /**
+     * 根据DOI获取论文信息
+     * @param doi DOI标识符
+     * @returns Promise<Paper | null> 论文信息或null
+     */
+    getPaperByDoi(doi: string): Promise<Paper | null>;
+    /**
+     * 验证API密钥是否有效
+     * @returns Promise<boolean> 是否有效
+     */
+    validateApiKey(): Promise<boolean>;
+    /**
+     * 获取平台名称
+     */
+    getPlatformName(): string;
+    /**
+     * 获取基础URL
+     */
+    getBaseUrl(): string;
+    /**
+     * 是否配置了API密钥
+     */
+    hasApiKey(): boolean;
+    /**
+     * 通用的HTTP请求错误处理 - 使用统一ErrorHandler
+     */
+    protected handleHttpError(error: any, operation: string): never;
+    /**
+     * 检查错误是否可重试
+     */
+    protected isRetryableError(error: any): boolean;
+    /**
+     * 获取建议的重试延迟
+     */
+    protected getRetryDelay(error: any, attempt?: number): number;
+    /**
+     * 通用的日期解析
+     */
+    protected parseDate(dateString: string): Date | null;
+    /**
+     * 清理和规范化文本
+     */
+    protected cleanText(text: string): string;
+    /**
+     * 从URL中提取文件名
+     */
+    protected extractFilename(url: string, paperId: string, extension?: string): string;
+}
+//# sourceMappingURL=PaperSource.d.ts.map

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

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

package/dist/platforms/PaperSource.js

@@ -0,0 +1,125 @@
+/**
+ * 学术论文搜索平台的抽象基类
+ * 定义了所有平台搜索器必须实现的核心接口
+ */
+import { ErrorHandler } from '../utils/ErrorHandler.js';
+import { logDebug } from '../utils/Logger.js';
+/**
+ * 抽象基类：论文搜索平台
+ */
+export class PaperSource {
+    baseUrl;
+    apiKey;
+    platformName;
+    errorHandler;
+    constructor(platformName, baseUrl, apiKey) {
+        this.platformName = platformName;
+        this.baseUrl = baseUrl;
+        this.apiKey = apiKey;
+        this.errorHandler = new ErrorHandler(platformName, process.env.NODE_ENV === 'development');
+    }
+    /**
+     * 根据DOI获取论文信息
+     * @param doi DOI标识符
+     * @returns Promise<Paper | null> 论文信息或null
+     */
+    async getPaperByDoi(doi) {
+        try {
+            const results = await this.search(doi, { maxResults: 1 });
+            return results.length > 0 ? results[0] : null;
+        }
+        catch (error) {
+            logDebug(`Error getting paper by DOI from ${this.platformName}:`, error);
+            return null;
+        }
+    }
+    /**
+     * 验证API密钥是否有效
+     * @returns Promise<boolean> 是否有效
+     */
+    async validateApiKey() {
+        if (!this.getCapabilities().requiresApiKey) {
+            return true;
+        }
+        if (!this.apiKey) {
+            return false;
+        }
+        try {
+            // 尝试一个简单的搜索来验证密钥
+            await this.search('test', { maxResults: 1 });
+            return true;
+        }
+        catch (error) {
+            return false;
+        }
+    }
+    /**
+     * 获取平台名称
+     */
+    getPlatformName() {
+        return this.platformName;
+    }
+    /**
+     * 获取基础URL
+     */
+    getBaseUrl() {
+        return this.baseUrl;
+    }
+    /**
+     * 是否配置了API密钥
+     */
+    hasApiKey() {
+        return !!this.apiKey;
+    }
+    /**
+     * 通用的HTTP请求错误处理 - 使用统一ErrorHandler
+     */
+    handleHttpError(error, operation) {
+        // Delegate to ErrorHandler for unified error handling
+        this.errorHandler.handleHttpError(error, operation);
+    }
+    /**
+     * 检查错误是否可重试
+     */
+    isRetryableError(error) {
+        return ErrorHandler.isRetryable(error);
+    }
+    /**
+     * 获取建议的重试延迟
+     */
+    getRetryDelay(error, attempt = 1) {
+        return ErrorHandler.getRetryDelay(error, attempt);
+    }
+    /**
+     * 通用的日期解析
+     */
+    parseDate(dateString) {
+        if (!dateString)
+            return null;
+        const date = new Date(dateString);
+        return isNaN(date.getTime()) ? null : date;
+    }
+    /**
+     * 清理和规范化文本
+     */
+    cleanText(text) {
+        if (!text)
+            return '';
+        return text
+            .replace(/\s+/g, ' ')
+            .replace(/\n+/g, ' ')
+            .trim();
+    }
+    /**
+     * 从URL中提取文件名
+     */
+    extractFilename(url, paperId, extension = 'pdf') {
+        const urlParts = url.split('/');
+        const lastPart = urlParts[urlParts.length - 1];
+        if (lastPart && lastPart.includes('.')) {
+            return lastPart;
+        }
+        return `${paperId}.${extension}`;
+    }
+}
+//# sourceMappingURL=PaperSource.js.map

package/dist/platforms/PaperSource.js.map

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

package/dist/platforms/PubMedSearcher.d.ts

@@ -0,0 +1,104 @@
+/**
+ * PubMed E-utilities API集成模块
+ * 支持无API密钥的免费使用（3 req/s）和有API密钥的增强使用（10 req/s）
+ */
+import { Paper } from '../models/Paper.js';
+import { PaperSource, SearchOptions, DownloadOptions, PlatformCapabilities } from './PaperSource.js';
+interface PubMedSearchOptions extends SearchOptions {
+    /** 搜索字段 */
+    field?: string;
+    /** 出版状态 */
+    pubStatus?: string;
+    /** 文献类型 */
+    publicationType?: string[];
+}
+export declare class PubMedSearcher extends PaperSource {
+    private readonly baseApiUrl;
+    private readonly rateLimiter;
+    private readonly retMax;
+    constructor(apiKey?: string);
+    getCapabilities(): PlatformCapabilities;
+    /**
+     * 搜索PubMed文献
+     */
+    search(query: string, options?: PubMedSearchOptions): Promise<Paper[]>;
+    /**
+     * 搜索获取PMID列表
+     */
+    private searchPMIDs;
+    /**
+     * 获取论文详细信息
+     */
+    private fetchPaperDetails;
+    /**
+     * 构建搜索查询
+     */
+    private buildSearchQuery;
+    /**
+     * 映射排序字段
+     */
+    private mapSortField;
+    /**
+     * 解析XML响应
+     */
+    private parseXmlResponse;
+    /**
+     * 解析PubMed文章列表
+     */
+    private parsePubMedArticles;
+    /**
+     * 解析单个PubMed文章
+     */
+    private parsePubMedArticle;
+    /**
+     * 提取作者信息
+     */
+    private extractAuthors;
+    /**
+     * 提取摘要
+     */
+    private extractAbstract;
+    /**
+     * 提取发布日期
+     */
+    private extractPublishedDate;
+    /**
+     * 解析月份（支持英文和数字）
+     */
+    private parseMonth;
+    /**
+     * 提取文章ID（DOI、PMC等）
+     */
+    private extractArticleIds;
+    /**
+     * PubMed通常不支持直接PDF下载
+     */
+    downloadPdf(paperId: string, options?: DownloadOptions): Promise<string>;
+    /**
+     * PubMed不提供全文内容
+     */
+    readPaper(paperId: string, options?: DownloadOptions): Promise<string>;
+    /**
+     * 根据PMID获取论文信息
+     */
+    getPaperByPmid(pmid: string): Promise<Paper | null>;
+    /**
+     * 根据DOI获取论文信息
+     */
+    getPaperByDoi(doi: string): Promise<Paper | null>;
+    /**
+     * 获取速率限制器状态
+     */
+    getRateLimiterStatus(): {
+        availableTokens: number;
+        maxTokens: number;
+        requestsPerSecond: number;
+        pendingRequests: number;
+    };
+    /**
+     * 验证API密钥（如果提供）
+     */
+    validateApiKey(): Promise<boolean>;
+}
+export {};
+//# sourceMappingURL=PubMedSearcher.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PubMedSearcher.d.ts","sourceRoot":"","sources":["../../src/platforms/PubMedSearcher.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EAAE,KAAK,EAAgB,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAMrG,UAAU,mBAAoB,SAAQ,aAAa;IACjD,WAAW;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW;IACX,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW;IACX,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B;AA2GD,qBAAa,cAAe,SAAQ,WAAW;IAC7C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAc;IAC1C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;gBAEzB,MAAM,CAAC,EAAE,MAAM;IAa3B,eAAe,IAAI,oBAAoB;IAWvC;;OAEG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,mBAAwB,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IA0BhF;;OAEG;YACW,WAAW;IA+CzB;;OAEG;YACW,iBAAiB;IAmC/B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAwCxB;;OAEG;IACH,OAAO,CAAC,YAAY;IASpB;;OAEG;YACW,gBAAgB;IAgB9B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAK3B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IA+D1B;;OAEG;IACH,OAAO,CAAC,cAAc;IAyBtB;;OAEG;IACH,OAAO,CAAC,eAAe;IAgBvB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAmB5B;;OAEG;IACH,OAAO,CAAC,UAAU;IAiBlB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAoBzB;;OAEG;IACG,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC;IAW9E;;OAEG;IACG,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC;IAI5E;;OAEG;IACG,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC;IAUzD;;OAEG;IACG,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC;IAUvD;;OAEG;IACH,oBAAoB;;;;;;IAIpB;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC;CAiBzC"}