paper-search-cli 0.3.0 → 0.3.2

package/dist/services/OpenAccessFallbackService.js

@@ -1,124 +1,2 @@
-import { downloadPdfFromUrl, safeFilename } from '../utils/PdfDownload.js';
-const REPOSITORY_SOURCES = ['pmc', 'europepmc', 'core', 'openaire'];
-export async function downloadWithFallback(searchers, options) {
-    const savePath = options.savePath || './downloads';
-    const attempts = [];
-    const source = normalizeSource(options.source);
-    const primary = searchers[source];
-    if (primary?.getCapabilities().download) {
-        try {
-            const path = await primary.downloadPdf(options.paperId, { savePath });
-            attempts.push({ stage: 'primary', status: 'ok', message: path });
-            return { status: 'ok', path, attempts };
-        }
-        catch (error) {
-            attempts.push({ stage: 'primary', status: 'error', message: error?.message || String(error) });
-        }
-    }
-    else {
-        attempts.push({ stage: 'primary', status: 'skipped', message: `No primary downloader for ${source}` });
-    }
-    const directResult = await tryDirectMetadataUrl(searchers, source, options.paperId, savePath, attempts);
-    if (directResult)
-        return { status: 'ok', path: directResult, attempts };
-    const repositoryResult = await tryRepositoryFallback(searchers, options, savePath, attempts);
-    if (repositoryResult)
-        return { status: 'ok', path: repositoryResult, attempts };
-    const unpaywallResult = await tryUnpaywall(searchers, options.doi || '', savePath, attempts);
-    if (unpaywallResult)
-        return { status: 'ok', path: unpaywallResult, attempts };
-    if (options.useSciHub !== false) {
-        const identifier = options.doi || options.title || options.paperId;
-        try {
-            const path = await searchers.scihub.downloadPdf(identifier, { savePath });
-            attempts.push({ stage: 'scihub', status: 'ok', message: path });
-            return { status: 'ok', path, attempts };
-        }
-        catch (error) {
-            attempts.push({ stage: 'scihub', status: 'error', message: error?.message || String(error) });
-        }
-    }
-    else {
-        attempts.push({ stage: 'scihub', status: 'skipped', message: 'Sci-Hub fallback disabled by useSciHub=false.' });
-    }
-    return { status: 'error', attempts };
-}
-async function tryDirectMetadataUrl(searchers, source, paperId, savePath, attempts) {
-    const searcher = searchers[source];
-    if (!searcher)
-        return '';
-    try {
-        const paper = await searcher.getPaperByDoi(paperId);
-        if (!paper?.pdfUrl) {
-            attempts.push({ stage: 'direct_pdf_url', status: 'skipped', message: 'No pdf_url found in source metadata.' });
-            return '';
-        }
-        const path = await downloadPdfFromUrl(paper.pdfUrl, savePath, `${source}_${safeFilename(paper.paperId)}`);
-        attempts.push({ stage: 'direct_pdf_url', status: 'ok', message: path });
-        return path;
-    }
-    catch (error) {
-        attempts.push({ stage: 'direct_pdf_url', status: 'error', message: error?.message || String(error) });
-        return '';
-    }
-}
-async function tryRepositoryFallback(searchers, options, savePath, attempts) {
-    const queries = [options.doi || '', options.title || ''].filter(Boolean);
-    if (queries.length === 0) {
-        attempts.push({ stage: 'repositories', status: 'skipped', message: 'No DOI/title provided for repository discovery.' });
-        return '';
-    }
-    for (const source of REPOSITORY_SOURCES) {
-        const searcher = searchers[source];
-        if (!searcher)
-            continue;
-        for (const query of queries) {
-            try {
-                const papers = await searcher.search(query, { maxResults: 3 });
-                const paper = papers.find(candidate => candidate.pdfUrl);
-                if (!paper?.pdfUrl)
-                    continue;
-                const path = await downloadPdfFromUrl(paper.pdfUrl, savePath, `${source}_${safeFilename(paper.paperId)}`);
-                attempts.push({ stage: `repository:${source}`, status: 'ok', message: path });
-                return path;
-            }
-            catch (error) {
-                attempts.push({ stage: `repository:${source}`, status: 'error', message: error?.message || String(error) });
-            }
-        }
-    }
-    attempts.push({ stage: 'repositories', status: 'skipped', message: 'No repository PDF candidate succeeded.' });
-    return '';
-}
-async function tryUnpaywall(searchers, doi, savePath, attempts) {
-    if (!doi) {
-        attempts.push({ stage: 'unpaywall', status: 'skipped', message: 'DOI not provided.' });
-        return '';
-    }
-    try {
-        const unpaywall = searchers.unpaywall;
-        const pdfUrl = await unpaywall.resolveBestPdfUrl(doi);
-        if (!pdfUrl) {
-            attempts.push({ stage: 'unpaywall', status: 'skipped', message: 'No OA PDF URL found or email not configured.' });
-            return '';
-        }
-        const path = await downloadPdfFromUrl(pdfUrl, savePath, `unpaywall_${safeFilename(doi)}`);
-        attempts.push({ stage: 'unpaywall', status: 'ok', message: path });
-        return path;
-    }
-    catch (error) {
-        attempts.push({ stage: 'unpaywall', status: 'error', message: error?.message || String(error) });
-        return '';
-    }
-}
-function normalizeSource(source) {
-    const normalized = source.trim().toLowerCase();
-    if (normalized === 'google_scholar')
-        return 'googlescholar';
-    if (normalized === 'pubmed_central')
-        return 'pmc';
-    if (normalized === 'europe_pmc')
-        return 'europepmc';
-    return normalized;
-}
+export { createDefaultDownloadTiers, downloadWithFallback, INSTITUTIONAL_ACCESS_TIER_ID, insertDownloadTierBefore } from '../capabilities/pdf-discovery/OpenAccessFallbackService.js';
 //# sourceMappingURL=OpenAccessFallbackService.js.map

package/dist/services/OpenAccessFallbackService.js.map

@@ -1 +1 @@
-{"version":3,"file":"OpenAccessFallbackService.js","sourceRoot":"","sources":["../../src/services/OpenAccessFallbackService.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"OpenAccessFallbackService.js","sourceRoot":"","sources":["../../src/services/OpenAccessFallbackService.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,0BAA0B,EAC1B,oBAAoB,EACpB,4BAA4B,EAC5B,wBAAwB,EACzB,MAAM,4DAA4D,CAAC"}

package/dist/utils/ErrorHandler.d.ts

@@ -1,99 +1,3 @@
-/**
- * Unified Error Handler for API requests
- * Provides consistent error handling across all platforms
- */
-/**
- * API Error codes and their meanings
- */
-export declare const HTTP_ERROR_CODES: {
-    readonly 400: "Bad Request - Invalid parameters or syntax";
-    readonly 401: "Unauthorized - Invalid or missing API key";
-    readonly 403: "Forbidden - Access denied or rate limit exceeded";
-    readonly 404: "Not Found - Resource does not exist";
-    readonly 405: "Method Not Allowed - HTTP method not supported";
-    readonly 408: "Request Timeout - Server took too long to respond";
-    readonly 429: "Too Many Requests - Rate limit exceeded";
-    readonly 500: "Internal Server Error - Server error";
-    readonly 502: "Bad Gateway - Server communication error";
-    readonly 503: "Service Unavailable - Server temporarily unavailable";
-    readonly 504: "Gateway Timeout - Server timeout";
-};
-/**
- * Custom API Error class with detailed information
- */
-export declare class ApiError extends Error {
-    readonly status?: number;
-    readonly platform: string;
-    readonly operation: string;
-    readonly timestamp: string;
-    readonly retryable: boolean;
-    readonly details?: any;
-    constructor(options: {
-        message: string;
-        status?: number;
-        platform: string;
-        operation: string;
-        details?: any;
-    });
-    private isRetryable;
-    toJSON(): {
-        name: string;
-        message: string;
-        status: number | undefined;
-        platform: string;
-        operation: string;
-        timestamp: string;
-        retryable: boolean;
-    };
-}
-/**
- * Error Handler class for unified error processing
- */
-export declare class ErrorHandler {
-    private platform;
-    private verbose;
-    constructor(platform: string, verbose?: boolean);
-    /**
-     * Handle HTTP errors from axios or similar libraries
-     */
-    handleHttpError(error: any, operation: string): never;
-    /**
-     * Handle generic errors
-     */
-    handleError(error: any, operation: string): never;
-    /**
-     * Extract error message from various error formats
-     */
-    private extractErrorMessage;
-    /**
-     * Create user-friendly error message
-     */
-    private createUserMessage;
-    /**
-     * Sanitize URL for logging
-     */
-    private sanitizeUrl;
-    /**
-     * Log error with consistent format
-     */
-    private logError;
-    /**
-     * Check if an error is retryable
-     */
-    static isRetryable(error: any): boolean;
-    /**
-     * Get suggested retry delay based on error
-     */
-    static getRetryDelay(error: any, attempt?: number): number;
-    /**
-     * Retry a function with exponential backoff and full jitter
-     */
-    static retryWithBackoff<T>(fn: () => Promise<T>, options?: {
-        maxRetries?: number;
-        initialDelayMs?: number;
-        maxDelayMs?: number;
-        context?: string;
-    }): Promise<T>;
-}
-export default ErrorHandler;
+export * from '../infrastructure/http/ErrorHandler.js';
+export { default } from '../infrastructure/http/ErrorHandler.js';
 //# sourceMappingURL=ErrorHandler.d.ts.map

package/dist/utils/ErrorHandler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ErrorHandler.d.ts","sourceRoot":"","sources":["../../src/utils/ErrorHandler.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;CAYnB,CAAC;AAEX;;GAEG;AACH,qBAAa,QAAS,SAAQ,KAAK;IACjC,SAAgB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChC,SAAgB,QAAQ,EAAE,MAAM,CAAC;IACjC,SAAgB,SAAS,EAAE,MAAM,CAAC;IAClC,SAAgB,SAAS,EAAE,MAAM,CAAC;IAClC,SAAgB,SAAS,EAAE,OAAO,CAAC;IACnC,SAAgB,OAAO,CAAC,EAAE,GAAG,CAAC;gBAElB,OAAO,EAAE;QACnB,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,CAAC,EAAE,GAAG,CAAC;KACf;IAaD,OAAO,CAAC,WAAW;IAMnB,MAAM;;;;;;;;;CAWP;AAED;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,OAAO,CAAU;gBAEb,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,OAAe;IAKtD;;OAEG;IACH,eAAe,CAAC,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,GAAG,KAAK;IAiCrD;;OAEG;IACH,WAAW,CAAC,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,GAAG,KAAK;IAqBjD;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAuB3B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA6BzB;;OAEG;IACH,OAAO,CAAC,WAAW;IAiBnB;;OAEG;IACH,OAAO,CAAC,QAAQ;IAOhB;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO;IASvC;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,KAAK,EAAE,GAAG,EAAE,OAAO,GAAE,MAAU,GAAG,MAAM;IAyB7D;;OAEG;WACU,gBAAgB,CAAC,CAAC,EAC7B,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,GAAE;QACP,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,OAAO,CAAC,EAAE,MAAM,CAAC;KACb,GACL,OAAO,CAAC,CAAC,CAAC;CAgCd;AAED,eAAe,YAAY,CAAC"}
+{"version":3,"file":"ErrorHandler.d.ts","sourceRoot":"","sources":["../../src/utils/ErrorHandler.ts"],"names":[],"mappings":"AAAA,cAAc,wCAAwC,CAAC;AACvD,OAAO,EAAE,OAAO,EAAE,MAAM,wCAAwC,CAAC"}

package/dist/utils/ErrorHandler.js

@@ -1,266 +1,3 @@
-/**
- * Unified Error Handler for API requests
- * Provides consistent error handling across all platforms
- */
-import { sanitizeRequest, maskSensitiveData } from './SecurityUtils.js';
-import { logError as loggerError, logDebug } from './Logger.js';
-/**
- * API Error codes and their meanings
- */
-export const HTTP_ERROR_CODES = {
-    400: 'Bad Request - Invalid parameters or syntax',
-    401: 'Unauthorized - Invalid or missing API key',
-    403: 'Forbidden - Access denied or rate limit exceeded',
-    404: 'Not Found - Resource does not exist',
-    405: 'Method Not Allowed - HTTP method not supported',
-    408: 'Request Timeout - Server took too long to respond',
-    429: 'Too Many Requests - Rate limit exceeded',
-    500: 'Internal Server Error - Server error',
-    502: 'Bad Gateway - Server communication error',
-    503: 'Service Unavailable - Server temporarily unavailable',
-    504: 'Gateway Timeout - Server timeout'
-};
-/**
- * Custom API Error class with detailed information
- */
-export class ApiError extends Error {
-    status;
-    platform;
-    operation;
-    timestamp;
-    retryable;
-    details;
-    constructor(options) {
-        super(options.message);
-        this.name = 'ApiError';
-        this.status = options.status;
-        this.platform = options.platform;
-        this.operation = options.operation;
-        this.timestamp = new Date().toISOString();
-        this.details = options.details;
-        // Determine if error is retryable
-        this.retryable = this.isRetryable(options.status);
-    }
-    isRetryable(status) {
-        if (!status)
-            return true;
-        // Retryable: rate limits, timeouts, server errors
-        return [408, 429, 500, 502, 503, 504].includes(status);
-    }
-    toJSON() {
-        return {
-            name: this.name,
-            message: this.message,
-            status: this.status,
-            platform: this.platform,
-            operation: this.operation,
-            timestamp: this.timestamp,
-            retryable: this.retryable
-        };
-    }
-}
-/**
- * Error Handler class for unified error processing
- */
-export class ErrorHandler {
-    platform;
-    verbose;
-    constructor(platform, verbose = false) {
-        this.platform = platform;
-        this.verbose = verbose || process.env.NODE_ENV === 'development';
-    }
-    /**
-     * Handle HTTP errors from axios or similar libraries
-     */
-    handleHttpError(error, operation) {
-        const status = error.response?.status;
-        const responseMessage = this.extractErrorMessage(error);
-        const url = error.config?.url;
-        const method = error.config?.method?.toUpperCase() || 'GET';
-        // Sanitize sensitive data before logging
-        const sanitizedConfig = sanitizeRequest(error.config);
-        const sanitizedUrl = url ? this.sanitizeUrl(url) : 'unknown';
-        // Log error details (sanitized)
-        this.logError({
-            status,
-            message: responseMessage,
-            url: sanitizedUrl,
-            method,
-            operation,
-            config: this.verbose ? sanitizedConfig : undefined,
-            responseData: this.verbose ? error.response?.data : undefined
-        });
-        // Create user-friendly error message
-        const userMessage = this.createUserMessage(status, responseMessage, operation);
-        throw new ApiError({
-            message: userMessage,
-            status,
-            platform: this.platform,
-            operation,
-            details: this.verbose ? { url: sanitizedUrl, method } : undefined
-        });
-    }
-    /**
-     * Handle generic errors
-     */
-    handleError(error, operation) {
-        if (error.response) {
-            // HTTP error
-            this.handleHttpError(error, operation);
-        }
-        const message = error.message || 'Unknown error occurred';
-        this.logError({
-            message,
-            operation,
-            stack: this.verbose ? error.stack : undefined
-        });
-        throw new ApiError({
-            message: `${this.platform} ${operation} failed: ${message}`,
-            platform: this.platform,
-            operation
-        });
-    }
-    /**
-     * Extract error message from various error formats
-     */
-    extractErrorMessage(error) {
-        // Try different error message locations
-        const candidates = [
-            error.response?.data?.message,
-            error.response?.data?.error?.message,
-            error.response?.data?.error?.error_description,
-            error.response?.data?.error,
-            error.response?.data?.detail,
-            error.response?.data?.['service-error']?.status?.statusText,
-            error.response?.data?.apiMessage,
-            error.response?.statusText,
-            error.message
-        ];
-        for (const candidate of candidates) {
-            if (candidate && typeof candidate === 'string') {
-                return candidate;
-            }
-        }
-        return 'Unknown error';
-    }
-    /**
-     * Create user-friendly error message
-     */
-    createUserMessage(status, message, operation) {
-        const statusDesc = status ? HTTP_ERROR_CODES[status] : '';
-        // Platform-specific messages
-        if (status === 401) {
-            if (/not authorized|insufficient|permission|entitlement|access.*requested/i.test(message)) {
-                return `${this.platform}: API key was accepted but does not have permission for this API product, view, or resource.`;
-            }
-            return `${this.platform}: Invalid or missing API key. Please check your credentials.`;
-        }
-        if (status === 403) {
-            return `${this.platform}: Access forbidden. This may be due to rate limiting or insufficient permissions.`;
-        }
-        if (status === 404) {
-            return `${this.platform}: Resource not found. The requested item may not exist.`;
-        }
-        if (status === 429) {
-            return `${this.platform}: Rate limit exceeded. Please wait before making more requests.`;
-        }
-        if (status && status >= 500) {
-            return `${this.platform}: Server error (${status}). The service may be temporarily unavailable.`;
-        }
-        // Generic message
-        const prefix = `${this.platform} ${operation} failed`;
-        const statusInfo = status ? ` (${status}${statusDesc ? ': ' + statusDesc : ''})` : '';
-        return `${prefix}${statusInfo}: ${maskSensitiveData(message)}`;
-    }
-    /**
-     * Sanitize URL for logging
-     */
-    sanitizeUrl(url) {
-        try {
-            const urlObj = new URL(url);
-            // Remove sensitive query parameters
-            const sensitiveParams = ['api_key', 'apikey', 'key', 'token', 'secret', 'auth'];
-            sensitiveParams.forEach(param => {
-                if (urlObj.searchParams.has(param)) {
-                    urlObj.searchParams.set(param, '***');
-                }
-            });
-            return urlObj.toString();
-        }
-        catch {
-            // If URL parsing fails, mask the entire thing
-            return '***sanitized-url***';
-        }
-    }
-    /**
-     * Log error with consistent format
-     */
-    logError(details) {
-        loggerError(`[${this.platform}] Error:`, {
-            timestamp: new Date().toISOString(),
-            ...details
-        });
-    }
-    /**
-     * Check if an error is retryable
-     */
-    static isRetryable(error) {
-        if (error instanceof ApiError) {
-            return error.retryable;
-        }
-        const status = error.response?.status;
-        if (!status)
-            return true;
-        return [408, 429, 500, 502, 503, 504].includes(status);
-    }
-    /**
-     * Get suggested retry delay based on error
-     */
-    static getRetryDelay(error, attempt = 1) {
-        const status = error.response?.status || error.status;
-        // For rate limiting, check Retry-After header
-        if (status === 429) {
-            const retryAfter = error.response?.headers?.['retry-after'];
-            if (retryAfter) {
-                const seconds = parseInt(retryAfter, 10);
-                if (!isNaN(seconds)) {
-                    return seconds * 1000;
-                }
-            }
-            // Default: exponential backoff for rate limits
-            return Math.min(60000, 1000 * Math.pow(2, attempt));
-        }
-        // For server errors, use exponential backoff
-        if (status && status >= 500) {
-            return Math.min(30000, 1000 * Math.pow(2, attempt));
-        }
-        // Default delay
-        return 1000 * attempt;
-    }
-    /**
-     * Retry a function with exponential backoff and full jitter
-     */
-    static async retryWithBackoff(fn, options = {}) {
-        const { maxRetries = 3, initialDelayMs = 1000, maxDelayMs = 30000, context = 'operation' } = options;
-        let lastError;
-        for (let attempt = 0; attempt <= maxRetries; attempt++) {
-            try {
-                return await fn();
-            }
-            catch (error) {
-                lastError = error;
-                if (attempt >= maxRetries || !ErrorHandler.isRetryable(error)) {
-                    throw error;
-                }
-                // Exponential backoff with full jitter
-                const baseDelay = Math.min(maxDelayMs, initialDelayMs * Math.pow(2, attempt));
-                const jitteredDelay = Math.floor(Math.random() * baseDelay);
-                logDebug(`[Retry] ${context} attempt ${attempt + 1}/${maxRetries} failed, retrying in ${jitteredDelay}ms`);
-                await new Promise(resolve => setTimeout(resolve, jitteredDelay));
-            }
-        }
-        throw lastError;
-    }
-}
-export default ErrorHandler;
+export * from '../infrastructure/http/ErrorHandler.js';
+export { default } from '../infrastructure/http/ErrorHandler.js';
 //# sourceMappingURL=ErrorHandler.js.map

package/dist/utils/ErrorHandler.js.map

@@ -1 +1 @@
-{"version":3,"file":"ErrorHandler.js","sourceRoot":"","sources":["../../src/utils/ErrorHandler.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACxE,OAAO,EAAE,QAAQ,IAAI,WAAW,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEhE;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,GAAG,EAAE,4CAA4C;IACjD,GAAG,EAAE,2CAA2C;IAChD,GAAG,EAAE,kDAAkD;IACvD,GAAG,EAAE,qCAAqC;IAC1C,GAAG,EAAE,gDAAgD;IACrD,GAAG,EAAE,mDAAmD;IACxD,GAAG,EAAE,yCAAyC;IAC9C,GAAG,EAAE,sCAAsC;IAC3C,GAAG,EAAE,0CAA0C;IAC/C,GAAG,EAAE,sDAAsD;IAC3D,GAAG,EAAE,kCAAkC;CAC/B,CAAC;AAEX;;GAEG;AACH,MAAM,OAAO,QAAS,SAAQ,KAAK;IACjB,MAAM,CAAU;IAChB,QAAQ,CAAS;IACjB,SAAS,CAAS;IAClB,SAAS,CAAS;IAClB,SAAS,CAAU;IACnB,OAAO,CAAO;IAE9B,YAAY,OAMX;QACC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACvB,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;QACvB,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;QACjC,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;QACnC,IAAI,CAAC,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC1C,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QAE/B,kCAAkC;QAClC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACpD,CAAC;IAEO,WAAW,CAAC,MAAe;QACjC,IAAI,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC;QACzB,kDAAkD;QAClD,OAAO,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IACzD,CAAC;IAED,MAAM;QACJ,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,SAAS,EAAE,IAAI,CAAC,SAAS;SAC1B,CAAC;IACJ,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,YAAY;IACf,QAAQ,CAAS;IACjB,OAAO,CAAU;IAEzB,YAAY,QAAgB,EAAE,UAAmB,KAAK;QACpD,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,OAAO,GAAG,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,aAAa,CAAC;IACnE,CAAC;IAED;;OAEG;IACH,eAAe,CAAC,KAAU,EAAE,SAAiB;QAC3C,MAAM,MAAM,GAAG,KAAK,CAAC,QAAQ,EAAE,MAAM,CAAC;QACtC,MAAM,eAAe,GAAG,IAAI,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC;QACxD,MAAM,GAAG,GAAG,KAAK,CAAC,MAAM,EAAE,GAAG,CAAC;QAC9B,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,IAAI,KAAK,CAAC;QAE5D,yCAAyC;QACzC,MAAM,eAAe,GAAG,eAAe,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACtD,MAAM,YAAY,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAE7D,gCAAgC;QAChC,IAAI,CAAC,QAAQ,CAAC;YACZ,MAAM;YACN,OAAO,EAAE,eAAe;YACxB,GAAG,EAAE,YAAY;YACjB,MAAM;YACN,SAAS;YACT,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,SAAS;YAClD,YAAY,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC,SAAS;SAC9D,CAAC,CAAC;QAEH,qCAAqC;QACrC,MAAM,WAAW,GAAG,IAAI,CAAC,iBAAiB,CAAC,MAAM,EAAE,eAAe,EAAE,SAAS,CAAC,CAAC;QAE/E,MAAM,IAAI,QAAQ,CAAC;YACjB,OAAO,EAAE,WAAW;YACpB,MAAM;YACN,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,SAAS;YACT,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,YAAY,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,SAAS;SAClE,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,KAAU,EAAE,SAAiB;QACvC,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;YACnB,aAAa;YACb,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;QACzC,CAAC;QAED,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,IAAI,wBAAwB,CAAC;QAE1D,IAAI,CAAC,QAAQ,CAAC;YACZ,OAAO;YACP,SAAS;YACT,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;SAC9C,CAAC,CAAC;QAEH,MAAM,IAAI,QAAQ,CAAC;YACjB,OAAO,EAAE,GAAG,IAAI,CAAC,QAAQ,IAAI,SAAS,YAAY,OAAO,EAAE;YAC3D,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,SAAS;SACV,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACK,mBAAmB,CAAC,KAAU;QACpC,wCAAwC;QACxC,MAAM,UAAU,GAAG;YACjB,KAAK,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO;YAC7B,KAAK,CAAC,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO;YACpC,KAAK,CAAC,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,iBAAiB;YAC9C,KAAK,CAAC,QAAQ,EAAE,IAAI,EAAE,KAAK;YAC3B,KAAK,CAAC,QAAQ,EAAE,IAAI,EAAE,MAAM;YAC5B,KAAK,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,eAAe,CAAC,EAAE,MAAM,EAAE,UAAU;YAC3D,KAAK,CAAC,QAAQ,EAAE,IAAI,EAAE,UAAU;YAChC,KAAK,CAAC,QAAQ,EAAE,UAAU;YAC1B,KAAK,CAAC,OAAO;SACd,CAAC;QAEF,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;YACnC,IAAI,SAAS,IAAI,OAAO,SAAS,KAAK,QAAQ,EAAE,CAAC;gBAC/C,OAAO,SAAS,CAAC;YACnB,CAAC;QACH,CAAC;QAED,OAAO,eAAe,CAAC;IACzB,CAAC;IAED;;OAEG;IACK,iBAAiB,CAAC,MAA0B,EAAE,OAAe,EAAE,SAAiB;QACtF,MAAM,UAAU,GAAG,MAAM,CAAC,CAAC,CAAC,gBAAgB,CAAC,MAAuC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAE3F,6BAA6B;QAC7B,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;YACnB,IAAI,uEAAuE,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC1F,OAAO,GAAG,IAAI,CAAC,QAAQ,8FAA8F,CAAC;YACxH,CAAC;YACD,OAAO,GAAG,IAAI,CAAC,QAAQ,8DAA8D,CAAC;QACxF,CAAC;QACD,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;YACnB,OAAO,GAAG,IAAI,CAAC,QAAQ,mFAAmF,CAAC;QAC7G,CAAC;QACD,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;YACnB,OAAO,GAAG,IAAI,CAAC,QAAQ,yDAAyD,CAAC;QACnF,CAAC;QACD,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;YACnB,OAAO,GAAG,IAAI,CAAC,QAAQ,iEAAiE,CAAC;QAC3F,CAAC;QACD,IAAI,MAAM,IAAI,MAAM,IAAI,GAAG,EAAE,CAAC;YAC5B,OAAO,GAAG,IAAI,CAAC,QAAQ,mBAAmB,MAAM,gDAAgD,CAAC;QACnG,CAAC;QAED,kBAAkB;QAClB,MAAM,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,IAAI,SAAS,SAAS,CAAC;QACtD,MAAM,UAAU,GAAG,MAAM,CAAC,CAAC,CAAC,KAAK,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC,IAAI,GAAG,UAAU,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QACtF,OAAO,GAAG,MAAM,GAAG,UAAU,KAAK,iBAAiB,CAAC,OAAO,CAAC,EAAE,CAAC;IACjE,CAAC;IAED;;OAEG;IACK,WAAW,CAAC,GAAW;QAC7B,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;YAC5B,oCAAoC;YACpC,MAAM,eAAe,GAAG,CAAC,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;YAChF,eAAe,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE;gBAC9B,IAAI,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;oBACnC,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;gBACxC,CAAC;YACH,CAAC,CAAC,CAAC;YACH,OAAO,MAAM,CAAC,QAAQ,EAAE,CAAC;QAC3B,CAAC;QAAC,MAAM,CAAC;YACP,8CAA8C;YAC9C,OAAO,qBAAqB,CAAC;QAC/B,CAAC;IACH,CAAC;IAED;;OAEG;IACK,QAAQ,CAAC,OAA4B;QAC3C,WAAW,CAAC,IAAI,IAAI,CAAC,QAAQ,UAAU,EAAE;YACvC,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,KAAU;QAC3B,IAAI,KAAK,YAAY,QAAQ,EAAE,CAAC;YAC9B,OAAO,KAAK,CAAC,SAAS,CAAC;QACzB,CAAC;QACD,MAAM,MAAM,GAAG,KAAK,CAAC,QAAQ,EAAE,MAAM,CAAC;QACtC,IAAI,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC;QACzB,OAAO,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IACzD,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,KAAU,EAAE,UAAkB,CAAC;QAClD,MAAM,MAAM,GAAG,KAAK,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC;QAEtD,8CAA8C;QAC9C,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;YACnB,MAAM,UAAU,GAAG,KAAK,CAAC,QAAQ,EAAE,OAAO,EAAE,CAAC,aAAa,CAAC,CAAC;YAC5D,IAAI,UAAU,EAAE,CAAC;gBACf,MAAM,OAAO,GAAG,QAAQ,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;gBACzC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;oBACpB,OAAO,OAAO,GAAG,IAAI,CAAC;gBACxB,CAAC;YACH,CAAC;YACD,+CAA+C;YAC/C,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;QACtD,CAAC;QAED,6CAA6C;QAC7C,IAAI,MAAM,IAAI,MAAM,IAAI,GAAG,EAAE,CAAC;YAC5B,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;QACtD,CAAC;QAED,gBAAgB;QAChB,OAAO,IAAI,GAAG,OAAO,CAAC;IACxB,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,gBAAgB,CAC3B,EAAoB,EACpB,UAKI,EAAE;QAEN,MAAM,EACJ,UAAU,GAAG,CAAC,EACd,cAAc,GAAG,IAAI,EACrB,UAAU,GAAG,KAAK,EAClB,OAAO,GAAG,WAAW,EACtB,GAAG,OAAO,CAAC;QAEZ,IAAI,SAAc,CAAC;QAEnB,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,UAAU,EAAE,OAAO,EAAE,EAAE,CAAC;YACvD,IAAI,CAAC;gBACH,OAAO,MAAM,EAAE,EAAE,CAAC;YACpB,CAAC;YAAC,OAAO,KAAU,EAAE,CAAC;gBACpB,SAAS,GAAG,KAAK,CAAC;gBAElB,IAAI,OAAO,IAAI,UAAU,IAAI,CAAC,YAAY,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC;oBAC9D,MAAM,KAAK,CAAC;gBACd,CAAC;gBAED,uCAAuC;gBACvC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,cAAc,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;gBAC9E,MAAM,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC;gBAE5D,QAAQ,CAAC,WAAW,OAAO,YAAY,OAAO,GAAG,CAAC,IAAI,UAAU,wBAAwB,aAAa,IAAI,CAAC,CAAC;gBAE3G,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC;YACnE,CAAC;QACH,CAAC;QAED,MAAM,SAAS,CAAC;IAClB,CAAC;CACF;AAED,eAAe,YAAY,CAAC"}
+{"version":3,"file":"ErrorHandler.js","sourceRoot":"","sources":["../../src/utils/ErrorHandler.ts"],"names":[],"mappings":"AAAA,cAAc,wCAAwC,CAAC;AACvD,OAAO,EAAE,OAAO,EAAE,MAAM,wCAAwC,CAAC"}

package/dist/utils/HttpClient.d.ts

@@ -1,6 +1,2 @@
-/**
- * Initializes global HTTP/HTTPS and SOCKS proxy agents for Axios
- * based on standard proxy environment variables.
- */
-export declare function setupGlobalProxy(): void;
+export * from '../infrastructure/http/HttpClient.js';
 //# sourceMappingURL=HttpClient.d.ts.map

package/dist/utils/HttpClient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"HttpClient.d.ts","sourceRoot":"","sources":["../../src/utils/HttpClient.ts"],"names":[],"mappings":"AAKA;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAuBvC"}
+{"version":3,"file":"HttpClient.d.ts","sourceRoot":"","sources":["../../src/utils/HttpClient.ts"],"names":[],"mappings":"AAAA,cAAc,sCAAsC,CAAC"}

package/dist/utils/HttpClient.js

@@ -1,30 +1,2 @@
-import axios from 'axios';
-import { HttpsProxyAgent } from 'https-proxy-agent';
-import { SocksProxyAgent } from 'socks-proxy-agent';
-import { logDebug } from './Logger.js';
-/**
- * Initializes global HTTP/HTTPS and SOCKS proxy agents for Axios
- * based on standard proxy environment variables.
- */
-export function setupGlobalProxy() {
-    const proxy = process.env.HTTPS_PROXY ||
-        process.env.HTTP_PROXY ||
-        process.env.https_proxy ||
-        process.env.http_proxy;
-    if (!proxy) {
-        return;
-    }
-    try {
-        logDebug(`Configuring global HTTP/HTTPS proxy: ${proxy}`);
-        const agent = proxy.startsWith('socks')
-            ? new SocksProxyAgent(proxy)
-            : new HttpsProxyAgent(proxy);
-        // Inject agent as default for both http and https protocols
-        axios.defaults.httpAgent = agent;
-        axios.defaults.httpsAgent = agent;
-    }
-    catch (error) {
-        logDebug(`Failed to initialize global proxy agent: ${error.message}`);
-    }
-}
+export * from '../infrastructure/http/HttpClient.js';
 //# sourceMappingURL=HttpClient.js.map

package/dist/utils/HttpClient.js.map

@@ -1 +1 @@
-{"version":3,"file":"HttpClient.js","sourceRoot":"","sources":["../../src/utils/HttpClient.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvC;;;GAGG;AACH,MAAM,UAAU,gBAAgB;IAC9B,MAAM,KAAK,GACT,OAAO,CAAC,GAAG,CAAC,WAAW;QACvB,OAAO,CAAC,GAAG,CAAC,UAAU;QACtB,OAAO,CAAC,GAAG,CAAC,WAAW;QACvB,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC;IAEzB,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO;IACT,CAAC;IAED,IAAI,CAAC;QACH,QAAQ,CAAC,wCAAwC,KAAK,EAAE,CAAC,CAAC;QAC1D,MAAM,KAAK,GAAG,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC;YACrC,CAAC,CAAC,IAAI,eAAe,CAAC,KAAK,CAAC;YAC5B,CAAC,CAAC,IAAI,eAAe,CAAC,KAAK,CAAC,CAAC;QAE/B,4DAA4D;QAC5D,KAAK,CAAC,QAAQ,CAAC,SAAS,GAAG,KAAK,CAAC;QACjC,KAAK,CAAC,QAAQ,CAAC,UAAU,GAAG,KAAK,CAAC;IACpC,CAAC;IAAC,OAAO,KAAU,EAAE,CAAC;QACpB,QAAQ,CAAC,4CAA4C,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IACxE,CAAC;AACH,CAAC"}
+{"version":3,"file":"HttpClient.js","sourceRoot":"","sources":["../../src/utils/HttpClient.ts"],"names":[],"mappings":"AAAA,cAAc,sCAAsC,CAAC"}

package/dist/utils/PDFExtractor.d.ts

@@ -1,34 +1,3 @@
-export interface PDFExtractOptions {
-    maxPages?: number;
-    cleanText?: boolean;
-}
-export interface PDFExtractResult {
-    text: string;
-    numPages: number;
-    info?: any;
-    metadata?: any;
-}
-export declare class PDFExtractor {
-    /**
-     * Download PDF from URL and extract text
-     */
-    extractFromUrl(url: string, options?: PDFExtractOptions): Promise<PDFExtractResult>;
-    /**
-     * Extract text from PDF file
-     */
-    extractFromFile(filePath: string, options?: PDFExtractOptions): Promise<PDFExtractResult>;
-    /**
-     * Extract text from PDF buffer
-     */
-    extractFromBuffer(buffer: Buffer, options?: PDFExtractOptions): Promise<PDFExtractResult>;
-    /**
-     * Clean extracted text
-     */
-    private cleanText;
-    /**
-     * Download PDF and save to file
-     */
-    downloadPdf(url: string, savePath: string): Promise<string>;
-}
-export default PDFExtractor;
+export * from '../infrastructure/pdf/PDFExtractor.js';
+export { default } from '../infrastructure/pdf/PDFExtractor.js';
 //# sourceMappingURL=PDFExtractor.d.ts.map

package/dist/utils/PDFExtractor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PDFExtractor.d.ts","sourceRoot":"","sources":["../../src/utils/PDFExtractor.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,QAAQ,CAAC,EAAE,GAAG,CAAC;CAChB;AAED,qBAAa,YAAY;IACvB;;OAEG;IACG,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAyB7F;;OAEG;IACG,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAgBnG;;OAEG;IACG,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA8BnG;;OAEG;IACH,OAAO,CAAC,SAAS;IAcjB;;OAEG;IACG,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAkClE;AAED,eAAe,YAAY,CAAC"}
+{"version":3,"file":"PDFExtractor.d.ts","sourceRoot":"","sources":["../../src/utils/PDFExtractor.ts"],"names":[],"mappings":"AAAA,cAAc,uCAAuC,CAAC;AACtD,OAAO,EAAE,OAAO,EAAE,MAAM,uCAAuC,CAAC"}