converteverything-mcp 1.2.0

package/dist/client.d.ts

@@ -0,0 +1,129 @@
+/**
+ * ConvertEverything API Client
+ *
+ * Secure client for interacting with the ConvertEverything.io public API.
+ * Only uses documented public endpoints - no internal/admin access.
+ */
+import { ClientConfig, ConversionResponse, ConversionListResponse, ConversionOptions, SupportedFormatsResponse, UsageResponse } from "./types.js";
+export interface WaitOptions {
+    pollInterval?: number;
+    timeout?: number;
+}
+export declare class ConvertEverythingClient {
+    private readonly apiKey;
+    private readonly baseUrl;
+    private readonly timeout;
+    private readonly userAgent;
+    private readonly maxRetries;
+    private formatCache;
+    constructor(config: ClientConfig);
+    /**
+     * Generate a unique correlation ID for request tracing
+     */
+    private generateCorrelationId;
+    /**
+     * Calculate exponential backoff delay
+     */
+    private getRetryDelay;
+    /**
+     * Sleep for specified milliseconds
+     */
+    private sleep;
+    /**
+     * Execute fetch with timeout and abort controller
+     */
+    private fetchWithTimeout;
+    /**
+     * Execute fetch with retry logic and rate limit handling
+     */
+    private fetchWithRetry;
+    /**
+     * Sanitize and validate the base URL
+     */
+    private sanitizeUrl;
+    /**
+     * Make an authenticated API request with retry and correlation ID
+     */
+    private request;
+    /**
+     * Get list of supported conversion formats (cached for 1 hour)
+     */
+    getSupportedFormats(skipCache?: boolean): Promise<SupportedFormatsResponse>;
+    /**
+     * Clear the format cache
+     */
+    clearFormatCache(): void;
+    /**
+     * Get current API usage and limits
+     */
+    getUsage(): Promise<UsageResponse>;
+    /**
+     * Get status of a conversion
+     */
+    getConversionStatus(conversionId: string): Promise<ConversionResponse>;
+    /**
+     * Validate file path for security
+     */
+    private validateFilePath;
+    /**
+     * Convert a file from a local path
+     */
+    convertFile(filePath: string, targetFormat: string, options?: ConversionOptions): Promise<ConversionResponse>;
+    /**
+     * Convert a file from a buffer/base64 data
+     */
+    convertFileBuffer(data: Buffer | string, fileName: string, targetFormat: string, options?: ConversionOptions): Promise<ConversionResponse>;
+    /**
+     * Download a converted file
+     */
+    downloadFile(conversionId: string): Promise<{
+        data: Buffer;
+        filename: string;
+        contentType: string;
+    }>;
+    /**
+     * Wait for a conversion to complete
+     */
+    waitForConversion(conversionId: string, options?: WaitOptions): Promise<ConversionResponse>;
+    /**
+     * List recent conversions
+     */
+    listConversions(page?: number, perPage?: number): Promise<ConversionListResponse>;
+    /**
+     * Cancel/delete an in-progress or completed conversion
+     */
+    cancelConversion(conversionId: string): Promise<{
+        success: boolean;
+        message: string;
+    }>;
+    /**
+     * Get file information/metadata
+     */
+    getFileInfo(filePath: string): Promise<{
+        filename: string;
+        size: number;
+        format: string;
+        mimeType: string;
+    }>;
+    /**
+     * Estimate output file size based on conversion options
+     */
+    estimateOutputSize(inputSize: number, sourceFormat: string, targetFormat: string, options?: ConversionOptions): {
+        estimatedSize: number;
+        confidence: "low" | "medium" | "high";
+        notes: string;
+    };
+    /**
+     * Retry a failed conversion with optional new options
+     */
+    retryConversion(conversionId: string, newOptions?: ConversionOptions): Promise<ConversionResponse>;
+    /**
+     * Validate UUID format
+     */
+    private isValidUuid;
+    /**
+     * Sanitize filename to prevent issues
+     */
+    private sanitizeFilename;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

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