@revealui/mcp 0.0.1-pre.0 → 0.1.1

package/dist/servers/adapter.d.ts

@@ -0,0 +1,209 @@
+#!/usr/bin/env tsx
+/**
+ * MCP Adapter - Generic Model Context Protocol Integration
+ *
+ * Provides a unified interface for all MCP server integrations,
+ * eliminating code duplication across different service adapters.
+ *
+ * Usage:
+ *   const adapter = new MCPAdapter('vercel', config)
+ *   await adapter.execute(request)
+ */
+export declare enum McpErrorCode {
+    VALIDATION_ERROR = "VALIDATION_ERROR",
+    NETWORK_ERROR = "NETWORK_ERROR",
+    TIMEOUT_ERROR = "TIMEOUT_ERROR",
+    CONFIG_ERROR = "CONFIG_ERROR"
+}
+export declare class McpError extends Error {
+    code: McpErrorCode;
+    constructor(message: string, code: McpErrorCode);
+}
+/**
+ * Dispose all active MCP adapters (cleanup on shutdown)
+ */
+export declare function disposeAllAdapters(): void;
+export interface MCPRequest {
+    action: string;
+    parameters?: Record<string, unknown>;
+    options?: {
+        timeout?: number;
+        retries?: number;
+        dryRun?: boolean;
+        /** Idempotency key to prevent duplicate operations */
+        idempotencyKey?: string;
+        /** TTL for idempotency cache in milliseconds (default: 5 minutes) */
+        idempotencyTTL?: number;
+    };
+}
+export interface MCPResponse {
+    success: boolean;
+    data?: unknown;
+    error?: string;
+    metadata?: {
+        duration: number;
+        retries: number;
+        service: string;
+        /** Indicates this response was served from idempotency cache */
+        cached?: boolean;
+        /** The idempotency key that was used */
+        idempotencyKey?: string;
+    };
+}
+/**
+ * In-memory idempotency cache for preventing duplicate operations.
+ * Each adapter instance has its own cache.
+ */
+declare class IdempotencyCache {
+    private cache;
+    private cleanupInterval;
+    private readonly DEFAULT_TTL;
+    constructor();
+    /**
+     * Get a cached response by idempotency key
+     */
+    get(key: string): MCPResponse | null;
+    /**
+     * Store a response with idempotency key
+     */
+    set(key: string, response: MCPResponse, ttl?: number): void;
+    /**
+     * Check if a key exists in the cache
+     */
+    has(key: string): boolean;
+    /**
+     * Remove expired entries
+     */
+    private cleanup;
+    /**
+     * Clear all cached entries
+     */
+    clear(): void;
+    /**
+     * Stop the cleanup interval
+     */
+    dispose(): void;
+    /**
+     * Get cache statistics
+     */
+    stats(): {
+        size: number;
+        keys: string[];
+    };
+}
+export interface MCPConfig {
+    apiKey?: string;
+    baseUrl?: string;
+    timeout?: number;
+    retries?: number;
+    environment?: 'development' | 'production';
+}
+export declare abstract class MCPAdapter {
+    protected serviceName: string;
+    protected config: MCPConfig;
+    protected logger: import("@revealui/utils/logger").Logger;
+    protected idempotencyCache: IdempotencyCache;
+    constructor(serviceName: string, config: MCPConfig);
+    /**
+     * Dispose of adapter resources (cleanup idempotency cache)
+     */
+    dispose(): void;
+    /**
+     * Get idempotency cache statistics
+     */
+    getCacheStats(): {
+        size: number;
+        keys: string[];
+    };
+    /**
+     * Clear the idempotency cache
+     */
+    clearCache(): void;
+    /**
+     * Execute an MCP request
+     *
+     * If an idempotencyKey is provided in options, the request will be checked
+     * against the cache. If a cached response exists, it will be returned
+     * immediately. Otherwise, the request will be executed and the response
+     * will be cached for future duplicate requests.
+     */
+    execute(request: MCPRequest): Promise<MCPResponse>;
+    /**
+     * Validate the incoming request
+     */
+    protected validateRequest(request: MCPRequest): void;
+    /**
+     * Check if an action is supported by this adapter
+     */
+    protected abstract isValidAction(action: string): boolean;
+    /**
+     * Execute the actual request (implemented by subclasses)
+     */
+    protected abstract executeRequest(request: MCPRequest): Promise<unknown>;
+    /**
+     * Create a dry-run response
+     */
+    protected createDryRunResponse(request: MCPRequest): MCPResponse;
+    /**
+     * Get authentication headers for API calls
+     */
+    protected getAuthHeaders(): Record<string, string>;
+    /**
+     * Get the authentication header name for this service
+     */
+    protected abstract getAuthHeaderName(): string;
+    /**
+     * Make an HTTP request with proper error handling
+     */
+    protected makeRequest(method: 'GET' | 'POST' | 'PUT' | 'DELETE', url: string, data?: unknown): Promise<unknown>;
+}
+export declare class VercelAdapter extends MCPAdapter {
+    constructor(config: MCPConfig);
+    protected isValidAction(action: string): boolean;
+    protected getAuthHeaderName(): string;
+    protected executeRequest(request: MCPRequest): Promise<unknown>;
+}
+export declare class StripeAdapter extends MCPAdapter {
+    constructor(config: MCPConfig);
+    protected isValidAction(action: string): boolean;
+    protected getAuthHeaderName(): string;
+    protected executeRequest(request: MCPRequest): Promise<unknown>;
+}
+export declare class NeonAdapter extends MCPAdapter {
+    constructor(config: MCPConfig);
+    protected isValidAction(action: string): boolean;
+    protected getAuthHeaderName(): string;
+    protected executeRequest(request: MCPRequest): Promise<unknown>;
+}
+export declare function createMCPAdapter(service: string, config: MCPConfig): MCPAdapter;
+/**
+ * Generate an idempotency key based on the request content.
+ *
+ * This creates a deterministic key from the action and parameters,
+ * so identical requests will get the same key.
+ *
+ * @example
+ * ```typescript
+ * const key = generateIdempotencyKey({
+ *   action: 'deploy',
+ *   parameters: { projectId: '123' }
+ * })
+ * // Returns: "deploy:a1b2c3d4e5f6..."
+ * ```
+ */
+export declare function generateIdempotencyKey(request: MCPRequest): string;
+/**
+ * Generate a unique idempotency key with timestamp.
+ *
+ * Use this when you want each request to be unique but still
+ * want idempotency protection against rapid duplicate submissions.
+ *
+ * @example
+ * ```typescript
+ * const key = generateUniqueIdempotencyKey('deploy')
+ * // Returns: "deploy:1706536800000:a1b2c3d4"
+ * ```
+ */
+export declare function generateUniqueIdempotencyKey(action: string): string;
+export {};
+//# sourceMappingURL=adapter.d.ts.map

package/dist/servers/adapter.d.ts.map

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