paper-search-cli 0.3.1 → 0.3.2

package/dist/infrastructure/http/ErrorHandler.js

@@ -0,0 +1,266 @@
+/**
+ * Unified Error Handler for API requests
+ * Provides consistent error handling across all platforms
+ */
+import { sanitizeRequest, maskSensitiveData } from '../security/SecurityUtils.js';
+import { logError as loggerError, logDebug } from '../../utils/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;
+//# sourceMappingURL=ErrorHandler.js.map

package/dist/infrastructure/http/ErrorHandler.js.map

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

package/dist/infrastructure/http/HttpClient.d.ts

@@ -0,0 +1,31 @@
+import { type AxiosRequestConfig } from 'axios';
+export interface HttpPolicy {
+    rateLimit?: {
+        rps: number;
+        burst?: number;
+    };
+    cache?: {
+        ttlMs: number;
+        maxSize?: number;
+    };
+    timeoutMs?: number;
+    retry?: {
+        maxRetries: number;
+    };
+    userAgent?: string;
+    validateStatus?: (status: number) => boolean;
+}
+export interface HttpRequestConfig extends AxiosRequestConfig {
+    cacheKey?: string;
+}
+export declare class HttpClient {
+    private readonly policy;
+    constructor(policy?: HttpPolicy);
+    request<T>(config: HttpRequestConfig): Promise<T>;
+}
+/**
+ * Initializes global HTTP/HTTPS and SOCKS proxy agents for Axios
+ * based on standard proxy environment variables.
+ */
+export declare function setupGlobalProxy(): void;
+//# sourceMappingURL=HttpClient.d.ts.map

package/dist/infrastructure/http/HttpClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HttpClient.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/http/HttpClient.ts"],"names":[],"mappings":"AAAA,OAAc,EAAE,KAAK,kBAAkB,EAAE,MAAM,OAAO,CAAC;AAKvD,MAAM,WAAW,UAAU;IACzB,SAAS,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5C,KAAK,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE;QAAE,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC;CAC9C;AAED,MAAM,WAAW,iBAAkB,SAAQ,kBAAkB;IAC3D,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,UAAU;IACT,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,GAAE,UAAe;IAE9C,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,CAAC,CAAC;CAcxD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAuBvC"}

package/dist/infrastructure/http/HttpClient.js

@@ -0,0 +1,50 @@
+import axios from 'axios';
+import { HttpsProxyAgent } from 'https-proxy-agent';
+import { SocksProxyAgent } from 'socks-proxy-agent';
+import { logDebug } from '../../utils/Logger.js';
+export class HttpClient {
+    policy;
+    constructor(policy = {}) {
+        this.policy = policy;
+    }
+    async request(config) {
+        const response = await axios.request({
+            ...config,
+            timeout: config.timeout ?? this.policy.timeoutMs,
+            validateStatus: config.validateStatus ?? this.policy.validateStatus,
+            headers: this.policy.userAgent
+                ? {
+                    ...config.headers,
+                    'User-Agent': this.policy.userAgent
+                }
+                : config.headers
+        });
+        return response.data;
+    }
+}
+/**
+ * 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}`);
+    }
+}
+//# sourceMappingURL=HttpClient.js.map

package/dist/infrastructure/http/HttpClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HttpClient.js","sourceRoot":"","sources":["../../../src/infrastructure/http/HttpClient.ts"],"names":[],"mappings":"AAAA,OAAO,KAAkC,MAAM,OAAO,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAejD,MAAM,OAAO,UAAU;IACQ;IAA7B,YAA6B,SAAqB,EAAE;QAAvB,WAAM,GAAN,MAAM,CAAiB;IAAG,CAAC;IAExD,KAAK,CAAC,OAAO,CAAI,MAAyB;QACxC,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,OAAO,CAAI;YACtC,GAAG,MAAM;YACT,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,IAAI,CAAC,MAAM,CAAC,SAAS;YAChD,cAAc,EAAE,MAAM,CAAC,cAAc,IAAI,IAAI,CAAC,MAAM,CAAC,cAAc;YACnE,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS;gBAC5B,CAAC,CAAC;oBACE,GAAG,MAAM,CAAC,OAAO;oBACjB,YAAY,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS;iBACpC;gBACH,CAAC,CAAC,MAAM,CAAC,OAAO;SACnB,CAAC,CAAC;QACH,OAAO,QAAQ,CAAC,IAAI,CAAC;IACvB,CAAC;CACF;AAED;;;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"}

package/dist/infrastructure/pdf/PDFExtractor.d.ts

@@ -0,0 +1,34 @@
+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;
+//# sourceMappingURL=PDFExtractor.d.ts.map

package/dist/infrastructure/pdf/PDFExtractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PDFExtractor.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/pdf/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"}

package/dist/infrastructure/pdf/PDFExtractor.js

@@ -0,0 +1,130 @@
+import axios from 'axios';
+import * as fs from 'fs';
+import * as path from 'path';
+// @ts-ignore - pdf-parse doesn't have type definitions
+import pdf from 'pdf-parse';
+import { logDebug, logWarn } from '../../utils/Logger.js';
+import { TIMEOUTS, USER_AGENT } from '../../config/constants.js';
+export class PDFExtractor {
+    /**
+     * Download PDF from URL and extract text
+     */
+    async extractFromUrl(url, options = {}) {
+        try {
+            logDebug(`Downloading PDF from: ${url}`);
+            const response = await axios.get(url, {
+                responseType: 'arraybuffer',
+                timeout: TIMEOUTS.DOWNLOAD,
+                headers: {
+                    'User-Agent': USER_AGENT,
+                    'Accept': 'application/pdf'
+                }
+            });
+            if (response.status !== 200) {
+                throw new Error(`Failed to download PDF: HTTP ${response.status}`);
+            }
+            const buffer = Buffer.from(response.data);
+            return await this.extractFromBuffer(buffer, options);
+        }
+        catch (error) {
+            logWarn(`Error downloading PDF from ${url}:`, error.message);
+            throw error;
+        }
+    }
+    /**
+     * Extract text from PDF file
+     */
+    async extractFromFile(filePath, options = {}) {
+        try {
+            if (!fs.existsSync(filePath)) {
+                throw new Error(`PDF file not found: ${filePath}`);
+            }
+            logDebug(`Extracting text from PDF file: ${filePath}`);
+            const dataBuffer = fs.readFileSync(filePath);
+            return await this.extractFromBuffer(dataBuffer, options);
+        }
+        catch (error) {
+            logWarn(`Error extracting PDF from file ${filePath}:`, error.message);
+            throw error;
+        }
+    }
+    /**
+     * Extract text from PDF buffer
+     */
+    async extractFromBuffer(buffer, options = {}) {
+        try {
+            const pdfOptions = {};
+            if (options.maxPages) {
+                pdfOptions.max = options.maxPages;
+            }
+            const data = await pdf(buffer, pdfOptions);
+            let text = data.text;
+            if (options.cleanText !== false) {
+                text = this.cleanText(text);
+            }
+            logDebug(`Extracted ${data.numpages} pages, ${text.length} characters`);
+            return {
+                text,
+                numPages: data.numpages,
+                info: data.info,
+                metadata: data.metadata
+            };
+        }
+        catch (error) {
+            logWarn('Error parsing PDF:', error.message);
+            throw error;
+        }
+    }
+    /**
+     * Clean extracted text
+     */
+    cleanText(text) {
+        return text
+            // Remove excessive whitespace
+            .replace(/\s+/g, ' ')
+            // Remove page numbers (common patterns)
+            .replace(/\n\s*\d+\s*\n/g, '\n')
+            // Remove headers/footers (lines with only numbers or short text)
+            .replace(/\n\s*[\w\s]{1,30}\s*\n/g, '\n')
+            // Normalize line breaks
+            .replace(/\n{3,}/g, '\n\n')
+            // Trim
+            .trim();
+    }
+    /**
+     * Download PDF and save to file
+     */
+    async downloadPdf(url, savePath) {
+        try {
+            logDebug(`Downloading PDF from ${url} to ${savePath}`);
+            // Ensure directory exists
+            const dir = path.dirname(savePath);
+            if (!fs.existsSync(dir)) {
+                fs.mkdirSync(dir, { recursive: true });
+            }
+            const response = await axios.get(url, {
+                responseType: 'stream',
+                timeout: TIMEOUTS.DOWNLOAD,
+                headers: {
+                    'User-Agent': USER_AGENT,
+                    'Accept': 'application/pdf'
+                }
+            });
+            const writer = fs.createWriteStream(savePath);
+            response.data.pipe(writer);
+            return new Promise((resolve, reject) => {
+                writer.on('finish', () => {
+                    logDebug(`PDF saved to: ${savePath}`);
+                    resolve(savePath);
+                });
+                writer.on('error', reject);
+            });
+        }
+        catch (error) {
+            logWarn(`Error downloading PDF:`, error.message);
+            throw error;
+        }
+    }
+}
+export default PDFExtractor;
+//# sourceMappingURL=PDFExtractor.js.map

package/dist/infrastructure/pdf/PDFExtractor.js.map

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

package/dist/infrastructure/pdf/PdfDownload.d.ts

@@ -0,0 +1,7 @@
+export interface PdfDownloadOptions {
+    headers?: Record<string, string>;
+}
+export declare function safeFilename(value: string, fallback?: string): string;
+export declare function isPdfBuffer(buffer: Buffer, contentType?: string): boolean;
+export declare function downloadPdfFromUrl(pdfUrl: string, savePath: string, filenameHint: string, options?: PdfDownloadOptions): Promise<string>;
+//# sourceMappingURL=PdfDownload.d.ts.map

package/dist/infrastructure/pdf/PdfDownload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PdfDownload.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/pdf/PdfDownload.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,kBAAkB;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,SAAU,GAAG,MAAM,CAGtE;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,SAAK,GAAG,OAAO,CAErE;AAyCD,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EACpB,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,MAAM,CAAC,CA2IjB"}