@andrebuzeli/git-mcp 4.0.21 → 5.0.0

package/dist/utils/multi-provider-operation-handler.d.ts

@@ -0,0 +1,113 @@
+import { VcsOperations } from '../providers/types.js';
+/**
+ * Result interface for individual provider operations within multi-provider context
+ */
+export interface ProviderOperationResult<T> {
+    success: boolean;
+    data?: T;
+    error?: string;
+    provider: 'github' | 'gitea';
+    executionTime?: number;
+}
+/**
+ * Result interface for multi-provider operations
+ */
+export interface MultiProviderOperationResult<T> {
+    success: boolean;
+    message: string;
+    data: {
+        github?: ProviderOperationResult<T>;
+        gitea?: ProviderOperationResult<T>;
+    };
+    warnings?: string[];
+    summary: {
+        totalProviders: number;
+        successfulProviders: number;
+        failedProviders: number;
+        partialSuccess: boolean;
+    };
+}
+/**
+ * Configuration status for multi-provider operations
+ */
+export interface MultiProviderConfiguration {
+    github: {
+        configured: boolean;
+        available: boolean;
+        error?: string;
+    };
+    gitea: {
+        configured: boolean;
+        available: boolean;
+        error?: string;
+    };
+    totalConfigured: number;
+    hasAnyProvider: boolean;
+}
+/**
+ * Multi-Provider Operation Handler
+ * Handles simultaneous execution on both GitHub and Gitea providers
+ * with comprehensive error handling and partial success scenarios
+ */
+export declare class MultiProviderOperationHandler {
+    /**
+     * Execute operation on both providers simultaneously
+     */
+    static executeOnBoth<T>(operation: (provider: VcsOperations) => Promise<T>): Promise<MultiProviderOperationResult<T>>;
+    /**
+     * Execute operation on a specific provider
+     */
+    private static executeOnProvider;
+    /**
+     * Handle partial success scenarios where one provider fails
+     */
+    static handlePartialSuccess<T>(githubResult?: ProviderOperationResult<T>, giteaResult?: ProviderOperationResult<T>): {
+        success: boolean;
+        message: string;
+        warnings: string[];
+    };
+    /**
+     * Aggregate results from multiple providers
+     */
+    private static aggregateResults;
+    /**
+     * Get provider configuration status
+     */
+    static getProviderConfiguration(): MultiProviderConfiguration;
+    /**
+     * Generate configuration warnings for missing providers
+     */
+    private static generateConfigurationWarnings;
+    /**
+     * Create result for when no providers are configured
+     */
+    private static createNoProvidersResult;
+    /**
+     * Create failed result for a specific provider
+     */
+    private static createFailedResult;
+    /**
+     * Check if multi-provider operations are possible
+     */
+    static canExecuteMultiProvider(): {
+        possible: boolean;
+        reason?: string;
+        availableProviders: ('github' | 'gitea')[];
+    };
+    /**
+     * Get detailed provider status for debugging
+     */
+    static getDetailedProviderStatus(): {
+        github: {
+            configured: boolean;
+            error?: string;
+            configurationHelp?: any;
+        };
+        gitea: {
+            configured: boolean;
+            error?: string;
+            configurationHelp?: any;
+        };
+    };
+}
+//# sourceMappingURL=multi-provider-operation-handler.d.ts.map

package/dist/utils/multi-provider-operation-handler.d.ts.map

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

package/dist/utils/multi-provider-operation-handler.js

@@ -0,0 +1,303 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MultiProviderOperationHandler = void 0;
+const index_js_1 = require("../providers/index.js");
+const configuration_validator_js_1 = require("./configuration-validator.js");
+const configuration_error_generator_js_1 = require("./configuration-error-generator.js");
+const operation_error_handler_js_1 = require("./operation-error-handler.js");
+/**
+ * Multi-Provider Operation Handler
+ * Handles simultaneous execution on both GitHub and Gitea providers
+ * with comprehensive error handling and partial success scenarios
+ */
+class MultiProviderOperationHandler {
+    /**
+     * Execute operation on both providers simultaneously
+     */
+    static async executeOnBoth(operation) {
+        const startTime = Date.now();
+        // Get provider configuration status
+        const config = this.getProviderConfiguration();
+        // Handle case where no providers are configured
+        if (!config.hasAnyProvider) {
+            return this.createNoProvidersResult();
+        }
+        // Execute operations on available providers
+        const promises = [];
+        if (config.github.configured) {
+            promises.push(this.executeOnProvider('github', operation));
+        }
+        if (config.gitea.configured) {
+            promises.push(this.executeOnProvider('gitea', operation));
+        }
+        // Wait for all operations to complete
+        const results = await Promise.allSettled(promises);
+        // Process results
+        let githubResult;
+        let giteaResult;
+        let resultIndex = 0;
+        if (config.github.configured) {
+            const result = results[resultIndex];
+            githubResult = result.status === 'fulfilled'
+                ? result.value
+                : this.createFailedResult('github', result.reason);
+            resultIndex++;
+        }
+        if (config.gitea.configured) {
+            const result = results[resultIndex];
+            giteaResult = result.status === 'fulfilled'
+                ? result.value
+                : this.createFailedResult('gitea', result.reason);
+        }
+        return this.aggregateResults(config, githubResult, giteaResult);
+    }
+    /**
+     * Execute operation on a specific provider
+     */
+    static async executeOnProvider(providerName, operation) {
+        const startTime = Date.now();
+        try {
+            // Get provider instance
+            const providerInstance = index_js_1.globalProviderFactory.getProvider(providerName);
+            if (!providerInstance) {
+                const configError = providerName === 'github'
+                    ? configuration_error_generator_js_1.ConfigurationErrorGenerator.generateGitHubError()
+                    : configuration_error_generator_js_1.ConfigurationErrorGenerator.generateGiteaError();
+                return {
+                    success: false,
+                    provider: providerName,
+                    error: `${providerName} provider is not configured. ${configuration_error_generator_js_1.ConfigurationErrorGenerator.formatErrorMessage(configError)}`,
+                    executionTime: Date.now() - startTime
+                };
+            }
+            // Execute operation
+            const result = await operation(providerInstance);
+            return {
+                success: true,
+                provider: providerName,
+                data: result,
+                executionTime: Date.now() - startTime
+            };
+        }
+        catch (error) {
+            const errorResponse = operation_error_handler_js_1.OperationErrorHandler.createErrorResponse(error instanceof Error ? error : new Error(String(error)), providerName);
+            return {
+                success: false,
+                provider: providerName,
+                error: errorResponse.formattedMessage,
+                executionTime: Date.now() - startTime
+            };
+        }
+    }
+    /**
+     * Handle partial success scenarios where one provider fails
+     */
+    static handlePartialSuccess(githubResult, giteaResult) {
+        const warnings = [];
+        const githubSuccess = githubResult?.success ?? false;
+        const giteaSuccess = giteaResult?.success ?? false;
+        if (githubSuccess && giteaSuccess) {
+            return {
+                success: true,
+                message: 'Operation completed successfully on both providers',
+                warnings: []
+            };
+        }
+        if (githubSuccess && !giteaSuccess) {
+            warnings.push(`Gitea operation failed: ${giteaResult?.error || 'Unknown error'}`);
+            return {
+                success: true, // Partial success
+                message: 'Operation completed on GitHub, failed on Gitea',
+                warnings
+            };
+        }
+        if (!githubSuccess && giteaSuccess) {
+            warnings.push(`GitHub operation failed: ${githubResult?.error || 'Unknown error'}`);
+            return {
+                success: true, // Partial success
+                message: 'Operation completed on Gitea, failed on GitHub',
+                warnings
+            };
+        }
+        // Both failed
+        if (githubResult)
+            warnings.push(`GitHub: ${githubResult.error}`);
+        if (giteaResult)
+            warnings.push(`Gitea: ${giteaResult.error}`);
+        return {
+            success: false,
+            message: 'Operation failed on both providers',
+            warnings
+        };
+    }
+    /**
+     * Aggregate results from multiple providers
+     */
+    static aggregateResults(config, githubResult, giteaResult) {
+        const partialResult = this.handlePartialSuccess(githubResult, giteaResult);
+        const successfulProviders = [githubResult, giteaResult]
+            .filter(result => result?.success).length;
+        const failedProviders = [githubResult, giteaResult]
+            .filter(result => result && !result.success).length;
+        const result = {
+            success: partialResult.success,
+            message: partialResult.message,
+            data: {},
+            summary: {
+                totalProviders: config.totalConfigured,
+                successfulProviders,
+                failedProviders,
+                partialSuccess: successfulProviders > 0 && failedProviders > 0
+            }
+        };
+        // Add provider results
+        if (githubResult) {
+            result.data.github = githubResult;
+        }
+        if (giteaResult) {
+            result.data.gitea = giteaResult;
+        }
+        // Add warnings if any
+        if (partialResult.warnings.length > 0) {
+            result.warnings = partialResult.warnings;
+        }
+        // Add configuration warnings for missing providers
+        const configWarnings = this.generateConfigurationWarnings(config);
+        if (configWarnings.length > 0) {
+            result.warnings = [...(result.warnings || []), ...configWarnings];
+        }
+        return result;
+    }
+    /**
+     * Get provider configuration status
+     */
+    static getProviderConfiguration() {
+        const githubValidation = configuration_validator_js_1.ConfigurationValidator.validateGitHubConfiguration();
+        const giteaValidation = configuration_validator_js_1.ConfigurationValidator.validateGiteaConfiguration();
+        const github = {
+            configured: githubValidation.valid,
+            available: githubValidation.valid,
+            error: githubValidation.error?.message
+        };
+        const gitea = {
+            configured: giteaValidation.valid,
+            available: giteaValidation.valid,
+            error: giteaValidation.error?.message
+        };
+        const totalConfigured = (github.configured ? 1 : 0) + (gitea.configured ? 1 : 0);
+        return {
+            github,
+            gitea,
+            totalConfigured,
+            hasAnyProvider: totalConfigured > 0
+        };
+    }
+    /**
+     * Generate configuration warnings for missing providers
+     */
+    static generateConfigurationWarnings(config) {
+        const warnings = [];
+        if (!config.github.configured && !config.gitea.configured) {
+            warnings.push('No providers are configured. Please configure at least one provider (GitHub or Gitea).');
+        }
+        else {
+            if (!config.github.configured) {
+                warnings.push('GitHub provider is not configured. Configure GITHUB_TOKEN to enable GitHub operations.');
+            }
+            if (!config.gitea.configured) {
+                warnings.push('Gitea provider is not configured. Configure GITEA_URL and GITEA_TOKEN to enable Gitea operations.');
+            }
+        }
+        return warnings;
+    }
+    /**
+     * Create result for when no providers are configured
+     */
+    static createNoProvidersResult() {
+        const githubError = configuration_error_generator_js_1.ConfigurationErrorGenerator.generateGitHubError();
+        const giteaError = configuration_error_generator_js_1.ConfigurationErrorGenerator.generateGiteaError();
+        return {
+            success: false,
+            message: 'No providers are configured',
+            data: {
+                github: {
+                    success: false,
+                    provider: 'github',
+                    error: configuration_error_generator_js_1.ConfigurationErrorGenerator.formatErrorMessage(githubError)
+                },
+                gitea: {
+                    success: false,
+                    provider: 'gitea',
+                    error: configuration_error_generator_js_1.ConfigurationErrorGenerator.formatErrorMessage(giteaError)
+                }
+            },
+            warnings: [
+                'Both GitHub and Gitea providers are not configured.',
+                'Please configure at least one provider to use multi-provider operations.'
+            ],
+            summary: {
+                totalProviders: 0,
+                successfulProviders: 0,
+                failedProviders: 0,
+                partialSuccess: false
+            }
+        };
+    }
+    /**
+     * Create failed result for a specific provider
+     */
+    static createFailedResult(provider, reason) {
+        return {
+            success: false,
+            provider,
+            error: reason instanceof Error ? reason.message : String(reason)
+        };
+    }
+    /**
+     * Check if multi-provider operations are possible
+     */
+    static canExecuteMultiProvider() {
+        const config = this.getProviderConfiguration();
+        const availableProviders = [];
+        if (config.github.configured)
+            availableProviders.push('github');
+        if (config.gitea.configured)
+            availableProviders.push('gitea');
+        if (availableProviders.length === 0) {
+            return {
+                possible: false,
+                reason: 'No providers are configured',
+                availableProviders: []
+            };
+        }
+        return {
+            possible: true,
+            availableProviders
+        };
+    }
+    /**
+     * Get detailed provider status for debugging
+     */
+    static getDetailedProviderStatus() {
+        const githubValidation = configuration_validator_js_1.ConfigurationValidator.validateGitHubConfiguration();
+        const giteaValidation = configuration_validator_js_1.ConfigurationValidator.validateGiteaConfiguration();
+        return {
+            github: {
+                configured: githubValidation.valid,
+                error: githubValidation.error?.message,
+                configurationHelp: !githubValidation.valid
+                    ? configuration_error_generator_js_1.ConfigurationErrorGenerator.generateGitHubError()
+                    : undefined
+            },
+            gitea: {
+                configured: giteaValidation.valid,
+                error: giteaValidation.error?.message,
+                configurationHelp: !giteaValidation.valid
+                    ? configuration_error_generator_js_1.ConfigurationErrorGenerator.generateGiteaError()
+                    : undefined
+            }
+        };
+    }
+}
+exports.MultiProviderOperationHandler = MultiProviderOperationHandler;
+//# sourceMappingURL=multi-provider-operation-handler.js.map

package/dist/utils/multi-provider-operation-handler.js.map

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

package/dist/utils/operation-error-handler.d.ts

@@ -0,0 +1,69 @@
+import { ConfigurationError } from './configuration-error-generator.js';
+/**
+ * Detailed error information for operations
+ */
+export interface OperationError {
+    code: string;
+    message: string;
+    provider: string;
+    cause: string;
+    solution: string;
+    configuration?: ConfigurationError;
+    troubleshooting?: string[];
+}
+/**
+ * Operation error handler for Git MCP providers
+ * Provides comprehensive error handling with configuration guidance
+ */
+export declare class OperationErrorHandler {
+    /**
+     * Handle authentication errors with configuration guidance
+     */
+    static handleAuthenticationError(error: Error, provider: string): OperationError;
+    /**
+     * Handle network errors with troubleshooting steps
+     */
+    static handleNetworkError(error: Error, provider: string, endpoint?: string): OperationError;
+    /**
+     * Handle permission errors with access instructions
+     */
+    static handlePermissionError(error: Error, provider: string, operation?: string): OperationError;
+    /**
+     * Handle resource not found errors
+     */
+    static handleNotFoundError(error: Error, provider: string, resource?: string): OperationError;
+    /**
+     * Handle rate limiting errors
+     */
+    static handleRateLimitError(error: Error, provider: string): OperationError;
+    /**
+     * Handle timeout errors
+     */
+    static handleTimeoutError(error: Error, provider: string): OperationError;
+    /**
+     * Handle validation errors
+     */
+    static handleValidationError(error: Error, provider: string, field?: string): OperationError;
+    /**
+     * Handle generic API errors
+     */
+    static handleGenericError(error: Error, provider: string): OperationError;
+    /**
+     * Analyze error and return appropriate error handler result
+     */
+    static analyzeAndHandleError(error: Error, provider: string, operation?: string): OperationError;
+    /**
+     * Format operation error as user-friendly message
+     */
+    static formatErrorMessage(operationError: OperationError): string;
+    /**
+     * Create a comprehensive error response for API operations
+     */
+    static createErrorResponse(error: Error, provider: string, operation?: string): {
+        success: false;
+        error: string;
+        details: OperationError;
+        formattedMessage: string;
+    };
+}
+//# sourceMappingURL=operation-error-handler.d.ts.map

package/dist/utils/operation-error-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operation-error-handler.d.ts","sourceRoot":"","sources":["../../src/utils/operation-error-handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAA+B,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAErG;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,kBAAkB,CAAC;IACnC,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED;;;GAGG;AACH,qBAAa,qBAAqB;IAEhC;;OAEG;IACH,MAAM,CAAC,yBAAyB,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,GAAG,cAAc;IAmBhF;;OAEG;IACH,MAAM,CAAC,kBAAkB,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,cAAc;IAoB5F;;OAEG;IACH,MAAM,CAAC,qBAAqB,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,cAAc;IA2ChG;;OAEG;IACH,MAAM,CAAC,mBAAmB,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,cAAc;IAiB7F;;OAEG;IACH,MAAM,CAAC,oBAAoB,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,GAAG,cAAc;IAiB3E;;OAEG;IACH,MAAM,CAAC,kBAAkB,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,GAAG,cAAc;IAiBzE;;OAEG;IACH,MAAM,CAAC,qBAAqB,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,cAAc;IAiB5F;;OAEG;IACH,MAAM,CAAC,kBAAkB,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,GAAG,cAAc;IAiBzE;;OAEG;IACH,MAAM,CAAC,qBAAqB,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,cAAc;IAyDhG;;OAEG;IACH,MAAM,CAAC,kBAAkB,CAAC,cAAc,EAAE,cAAc,GAAG,MAAM;IAuBjE;;OAEG;IACH,MAAM,CAAC,mBAAmB,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG;QAC9E,OAAO,EAAE,KAAK,CAAC;QACf,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,cAAc,CAAC;QACxB,gBAAgB,EAAE,MAAM,CAAC;KAC1B;CAWF"}