@andrebuzeli/git-mcp 2.28.0 → 2.28.2

package/dist/config.js

@@ -1,393 +1,393 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.config = exports.ConfigManager = void 0;
-const zod_1 = require("zod");
-/**
- * Schema de validação para configuração do servidor MCP Gitea
- *
- * VALIDAÇÕES:
- * - giteaUrl: Deve ser uma URL válida
- * - giteaToken: Deve ter pelo menos 1 caractere
- * - giteaUsername: Opcional
- * - debug: Padrão false
- * - timeout: Deve ser positivo, padrão 30000ms
- *
- * RECOMENDAÇÕES:
- * - Use HTTPS para produção
- * - Token deve ter permissões adequadas
- * - Timeout deve considerar latência da rede
- */
-const ConfigSchema = zod_1.z.object({
-    // Configuração legacy para Gitea
-    giteaUrl: zod_1.z.string().url().optional(),
-    giteaToken: zod_1.z.string().min(1).optional(),
-    giteaUsername: zod_1.z.string().optional(),
-    // Configuração para GitHub
-    githubToken: zod_1.z.string().min(1).optional(),
-    githubUsername: zod_1.z.string().optional(),
-    // Configuração genérica para multi-provider
-    provider: zod_1.z.enum(['gitea', 'github']).optional(),
-    apiUrl: zod_1.z.string().url().optional(),
-    apiToken: zod_1.z.string().min(1).optional(),
-    // Configuração multi-provider
-    defaultProvider: zod_1.z.string().optional(),
-    providersJson: zod_1.z.string().optional().transform(val => {
-        if (val) {
-            try {
-                return JSON.parse(val);
-            }
-            catch (e) {
-                console.error("Error parsing PROVIDERS_JSON:", e);
-                return undefined;
-            }
-        }
-        return undefined;
-    }),
-    // Configurações gerais
-    debug: zod_1.z.boolean().default(false),
-    timeout: zod_1.z.number().positive().default(30000),
-}).superRefine((data, ctx) => {
-    // Validação: deve ter pelo menos uma configuração válida ou modo demo
-    const hasGiteaConfig = data.giteaUrl && data.giteaToken;
-    const hasGitHubConfig = data.githubToken;
-    const hasGenericConfig = data.apiUrl && data.apiToken;
-    const hasMultiProviderConfig = data.providersJson;
-    const isDemoMode = process.env.DEMO_MODE === 'true';
-    const configCount = [hasGiteaConfig, hasGitHubConfig, hasGenericConfig, hasMultiProviderConfig].filter(Boolean).length;
-    if (configCount === 0 && !isDemoMode) {
-        ctx.addIssue({
-            code: zod_1.z.ZodIssueCode.custom,
-            message: "Configuration required: At least one provider configuration must be provided (GITEA_URL+GITEA_TOKEN, GITHUB_TOKEN, API_URL+API_TOKEN, or PROVIDERS_JSON). Use DEMO_MODE=true for testing without real providers.",
-            path: ['giteaUrl', 'githubToken', 'apiUrl', 'providersJson'],
-        });
-    }
-    // Se provider é especificado, apiUrl e apiToken são obrigatórios
-    if (data.provider && (!data.apiUrl || !data.apiToken)) {
-        ctx.addIssue({
-            code: zod_1.z.ZodIssueCode.custom,
-            message: "When provider is specified, both apiUrl and apiToken are required.",
-            path: ['apiUrl', 'apiToken'],
-        });
-    }
-});
-/**
- * Gerenciador de configuração usando padrão Singleton
- *
- * RESPONSABILIDADES:
- * - Carregar configuração do ambiente
- * - Validar parâmetros obrigatórios
- * - Fornecer acesso centralizado à configuração
- *
- * USO:
- * - const config = ConfigManager.getInstance();
- * - const url = config.getGiteaUrl();
- *
- * RECOMENDAÇÕES:
- * - Sempre use getInstance() para acessar
- * - Configure variáveis de ambiente adequadamente
- * - Valide configuração antes de usar
- */
-class ConfigManager {
-    static instance;
-    config;
-    constructor() {
-        this.config = this.loadConfig();
-    }
-    /**
-     * Obtém a instância única do ConfigManager
-     *
-     * IMPLEMENTAÇÃO:
-     * - Singleton pattern para configuração global
-     * - Thread-safe para aplicações concorrentes
-     *
-     * RETORNO:
-     * - Instância única do ConfigManager
-     */
-    static getInstance() {
-        if (!ConfigManager.instance) {
-            ConfigManager.instance = new ConfigManager();
-        }
-        return ConfigManager.instance;
-    }
-    /**
-     * Carrega e valida a configuração do ambiente
-     *
-     * FONTES DE CONFIGURAÇÃO:
-     * - Variáveis de ambiente (prioridade alta)
-     * - Valores padrão (fallback)
-     *
-     * VALIDAÇÃO:
-     * - Schema Zod para validação rigorosa
-     * - Mensagens de erro descritivas
-     *
-     * ERROS:
-     * - Configuração inválida gera exceção
-     * - Token obrigatório deve ser fornecido
-     */
-    loadConfig() {
-        const config = {
-            // Configuração legacy para Gitea
-            giteaUrl: process.env.GITEA_URL,
-            giteaToken: process.env.GITEA_TOKEN,
-            giteaUsername: process.env.GITEA_USERNAME,
-            // Configuração para GitHub
-            githubToken: process.env.GITHUB_TOKEN,
-            githubUsername: process.env.GITHUB_USERNAME,
-            // Configuração genérica para multi-provider
-            provider: process.env.PROVIDER,
-            apiUrl: process.env.API_URL,
-            apiToken: process.env.API_TOKEN,
-            // Configuração multi-provider
-            defaultProvider: process.env.DEFAULT_PROVIDER,
-            providersJson: process.env.PROVIDERS_JSON,
-            // Configurações gerais
-            debug: process.env.DEBUG === 'true',
-            timeout: parseInt(process.env.TIMEOUT || '30000'),
-        };
-        // Auto-detectar configuração multi-provider se ambos Gitea e GitHub estão configurados
-        if (config.giteaUrl && config.giteaToken && config.githubToken && !config.providersJson) {
-            config.providersJson = JSON.stringify({
-                defaultProvider: 'gitea',
-                providers: [
-                    {
-                        name: 'gitea',
-                        type: 'gitea',
-                        apiUrl: config.giteaUrl,
-                        token: config.giteaToken,
-                        username: config.giteaUsername
-                    },
-                    {
-                        name: 'github',
-                        type: 'github',
-                        apiUrl: 'https://api.github.com',
-                        token: config.githubToken,
-                        username: config.githubUsername
-                    }
-                ]
-            });
-        }
-        try {
-            return ConfigSchema.parse(config);
-        }
-        catch (error) {
-            if (error instanceof zod_1.z.ZodError) {
-                const issues = error.issues.map(issue => `${issue.path.join('.')}: ${issue.message}`).join(', ');
-                throw new Error(`Configuration validation failed: ${issues}`);
-            }
-            throw error;
-        }
-    }
-    /**
-     * Obtém a configuração completa validada
-     *
-     * RETORNO:
-     * - Objeto Config com todos os parâmetros
-     *
-     * USO:
-     * - Para acesso direto à configuração
-     * - Para validação de parâmetros
-     */
-    getConfig() {
-        return this.config;
-    }
-    /**
-     * Obtém a URL base do Gitea
-     *
-     * RETORNO:
-     * - URL completa do servidor Gitea
-     *
-     * EXEMPLO:
-     * - http://gitea.local:3000
-     * - https://gitea.company.com
-     */
-    getGiteaUrl() {
-        return this.config.giteaUrl;
-    }
-    /**
-     * Obtém o token de autenticação
-     *
-     * SEGURANÇA:
-     * - Token deve ser mantido seguro
-     * - Não logar em produção
-     * - Rotacionar periodicamente
-     *
-     * RETORNO:
-     * - Token de acesso pessoal
-     */
-    getGiteaToken() {
-        return this.config.giteaToken;
-    }
-    /**
-     * Obtém o nome de usuário configurado
-     *
-     * RETORNO:
-     * - Nome de usuário ou undefined
-     *
-     * USO:
-     * - Para operações específicas do usuário
-     * - Para identificação em logs
-     */
-    getGiteaUsername() {
-        return this.config.giteaUsername;
-    }
-    /**
-     * Verifica se o modo debug está ativo
-     *
-     * RETORNO:
-     * - true se debug ativo, false caso contrário
-     *
-     * RECOMENDAÇÕES:
-     * - Use apenas em desenvolvimento
-     * - Desative em produção
-     * - Configure via DEBUG=true
-     */
-    isDebug() {
-        return this.config.debug;
-    }
-    /**
-     * Obtém o timeout das requisições HTTP
-     *
-     * RETORNO:
-     * - Timeout em milissegundos
-     *
-     * RECOMENDAÇÕES:
-     * - 30000ms para redes locais
-     * - 60000ms para redes com latência
-     * - Configure via TIMEOUT=60000
-     */
-    getTimeout() {
-        return this.config.timeout;
-    }
-    /**
-     * Obtém o tipo de provider configurado
-     *
-     * RETORNO:
-     * - Tipo do provider ('gitea' ou 'github')
-     */
-    getProvider() {
-        return this.config.provider;
-    }
-    /**
-     * Obtém a URL da API genérica
-     *
-     * RETORNO:
-     * - URL da API ou undefined
-     */
-    getApiUrl() {
-        return this.config.apiUrl;
-    }
-    /**
-     * Obtém o token da API genérica
-     *
-     * RETORNO:
-     * - Token da API ou undefined
-     */
-    getApiToken() {
-        return this.config.apiToken;
-    }
-    /**
-     * Obtém o token do GitHub
-     *
-     * RETORNO:
-     * - Token do GitHub ou undefined
-     */
-    getGitHubToken() {
-        return this.config.githubToken;
-    }
-    /**
-     * Obtém o nome de usuário do GitHub
-     *
-     * RETORNO:
-     * - Nome de usuário do GitHub ou undefined
-     */
-    getGitHubUsername() {
-        return this.config.githubUsername;
-    }
-    /**
-     * Obtém o provider padrão configurado
-     *
-     * RETORNO:
-     * - Nome do provider padrão ou undefined
-     */
-    getDefaultProvider() {
-        return this.config.defaultProvider;
-    }
-    /**
-     * Obtém a configuração multi-provider
-     *
-     * RETORNO:
-     * - Configuração multi-provider parseada ou undefined
-     */
-    getProvidersJson() {
-        return this.config.providersJson;
-    }
-    /**
-     * Verifica se está usando configuração multi-provider
-     *
-     * RETORNO:
-     * - true se usando multi-provider, false caso contrário
-     */
-    isMultiProvider() {
-        return !!this.config.providersJson;
-    }
-    /**
-     * Verifica se está usando configuração genérica
-     *
-     * RETORNO:
-     * - true se usando configuração genérica, false caso contrário
-     */
-    isGenericConfig() {
-        return !!(this.config.apiUrl && this.config.apiToken);
-    }
-    /**
-     * Verifica se está usando configuração legacy do Gitea
-     *
-     * RETORNO:
-     * - true se usando configuração legacy, false caso contrário
-     */
-    isLegacyGitea() {
-        return !!(this.config.giteaUrl && this.config.giteaToken);
-    }
-    /**
-     * Verifica se está em modo demo
-     *
-     * RETORNO:
-     * - true se em modo demo, false caso contrário
-     */
-    isDemoMode() {
-        return process.env.DEMO_MODE === 'true';
-    }
-    /**
-     * Obtém configuração demo para testes
-     *
-     * RETORNO:
-     * - Configuração mock para modo demo
-     */
-    getDemoConfig() {
-        return {
-            defaultProvider: 'demo',
-            providers: [{
-                    name: 'demo',
-                    type: 'gitea',
-                    apiUrl: 'https://demo.gitea.io/api/v1',
-                    token: 'demo-token',
-                    username: 'demo-user'
-                }]
-        };
-    }
-}
-exports.ConfigManager = ConfigManager;
-/**
- * Instância global do ConfigManager
- *
- * USO DIRETO:
- * - import { config } from './config.js';
- * - const url = config.getGiteaUrl();
- *
- * RECOMENDAÇÕES:
- * - Use esta instância para acesso direto
- * - Não crie novas instâncias
- * - Configure antes de usar
- */
-exports.config = ConfigManager.getInstance();
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.config = exports.ConfigManager = void 0;
+const zod_1 = require("zod");
+/**
+ * Schema de validação para configuração do servidor MCP Gitea
+ *
+ * VALIDAÇÕES:
+ * - giteaUrl: Deve ser uma URL válida
+ * - giteaToken: Deve ter pelo menos 1 caractere
+ * - giteaUsername: Opcional
+ * - debug: Padrão false
+ * - timeout: Deve ser positivo, padrão 30000ms
+ *
+ * RECOMENDAÇÕES:
+ * - Use HTTPS para produção
+ * - Token deve ter permissões adequadas
+ * - Timeout deve considerar latência da rede
+ */
+const ConfigSchema = zod_1.z.object({
+    // Configuração legacy para Gitea
+    giteaUrl: zod_1.z.string().url().optional(),
+    giteaToken: zod_1.z.string().min(1).optional(),
+    giteaUsername: zod_1.z.string().optional(),
+    // Configuração para GitHub
+    githubToken: zod_1.z.string().min(1).optional(),
+    githubUsername: zod_1.z.string().optional(),
+    // Configuração genérica para multi-provider
+    provider: zod_1.z.enum(['gitea', 'github']).optional(),
+    apiUrl: zod_1.z.string().url().optional(),
+    apiToken: zod_1.z.string().min(1).optional(),
+    // Configuração multi-provider
+    defaultProvider: zod_1.z.string().optional(),
+    providersJson: zod_1.z.string().optional().transform(val => {
+        if (val) {
+            try {
+                return JSON.parse(val);
+            }
+            catch (e) {
+                console.error("Error parsing PROVIDERS_JSON:", e);
+                return undefined;
+            }
+        }
+        return undefined;
+    }),
+    // Configurações gerais
+    debug: zod_1.z.boolean().default(false),
+    timeout: zod_1.z.number().positive().default(30000),
+}).superRefine((data, ctx) => {
+    // Validação: deve ter pelo menos uma configuração válida ou modo demo
+    const hasGiteaConfig = data.giteaUrl && data.giteaToken;
+    const hasGitHubConfig = data.githubToken;
+    const hasGenericConfig = data.apiUrl && data.apiToken;
+    const hasMultiProviderConfig = data.providersJson;
+    const isDemoMode = process.env.DEMO_MODE === 'true';
+    const configCount = [hasGiteaConfig, hasGitHubConfig, hasGenericConfig, hasMultiProviderConfig].filter(Boolean).length;
+    if (configCount === 0 && !isDemoMode) {
+        ctx.addIssue({
+            code: zod_1.z.ZodIssueCode.custom,
+            message: "Configuration required: At least one provider configuration must be provided (GITEA_URL+GITEA_TOKEN, GITHUB_TOKEN, API_URL+API_TOKEN, or PROVIDERS_JSON). Use DEMO_MODE=true for testing without real providers.",
+            path: ['giteaUrl', 'githubToken', 'apiUrl', 'providersJson'],
+        });
+    }
+    // Se provider é especificado, apiUrl e apiToken são obrigatórios
+    if (data.provider && (!data.apiUrl || !data.apiToken)) {
+        ctx.addIssue({
+            code: zod_1.z.ZodIssueCode.custom,
+            message: "When provider is specified, both apiUrl and apiToken are required.",
+            path: ['apiUrl', 'apiToken'],
+        });
+    }
+});
+/**
+ * Gerenciador de configuração usando padrão Singleton
+ *
+ * RESPONSABILIDADES:
+ * - Carregar configuração do ambiente
+ * - Validar parâmetros obrigatórios
+ * - Fornecer acesso centralizado à configuração
+ *
+ * USO:
+ * - const config = ConfigManager.getInstance();
+ * - const url = config.getGiteaUrl();
+ *
+ * RECOMENDAÇÕES:
+ * - Sempre use getInstance() para acessar
+ * - Configure variáveis de ambiente adequadamente
+ * - Valide configuração antes de usar
+ */
+class ConfigManager {
+    static instance;
+    config;
+    constructor() {
+        this.config = this.loadConfig();
+    }
+    /**
+     * Obtém a instância única do ConfigManager
+     *
+     * IMPLEMENTAÇÃO:
+     * - Singleton pattern para configuração global
+     * - Thread-safe para aplicações concorrentes
+     *
+     * RETORNO:
+     * - Instância única do ConfigManager
+     */
+    static getInstance() {
+        if (!ConfigManager.instance) {
+            ConfigManager.instance = new ConfigManager();
+        }
+        return ConfigManager.instance;
+    }
+    /**
+     * Carrega e valida a configuração do ambiente
+     *
+     * FONTES DE CONFIGURAÇÃO:
+     * - Variáveis de ambiente (prioridade alta)
+     * - Valores padrão (fallback)
+     *
+     * VALIDAÇÃO:
+     * - Schema Zod para validação rigorosa
+     * - Mensagens de erro descritivas
+     *
+     * ERROS:
+     * - Configuração inválida gera exceção
+     * - Token obrigatório deve ser fornecido
+     */
+    loadConfig() {
+        const config = {
+            // Configuração legacy para Gitea
+            giteaUrl: process.env.GITEA_URL,
+            giteaToken: process.env.GITEA_TOKEN,
+            giteaUsername: process.env.GITEA_USERNAME,
+            // Configuração para GitHub
+            githubToken: process.env.GITHUB_TOKEN,
+            githubUsername: process.env.GITHUB_USERNAME,
+            // Configuração genérica para multi-provider
+            provider: process.env.PROVIDER,
+            apiUrl: process.env.API_URL,
+            apiToken: process.env.API_TOKEN,
+            // Configuração multi-provider
+            defaultProvider: process.env.DEFAULT_PROVIDER,
+            providersJson: process.env.PROVIDERS_JSON,
+            // Configurações gerais
+            debug: process.env.DEBUG === 'true',
+            timeout: parseInt(process.env.TIMEOUT || '30000'),
+        };
+        // Auto-detectar configuração multi-provider se ambos Gitea e GitHub estão configurados
+        if (config.giteaUrl && config.giteaToken && config.githubToken && !config.providersJson) {
+            config.providersJson = JSON.stringify({
+                defaultProvider: 'gitea',
+                providers: [
+                    {
+                        name: 'gitea',
+                        type: 'gitea',
+                        apiUrl: config.giteaUrl,
+                        token: config.giteaToken,
+                        username: config.giteaUsername
+                    },
+                    {
+                        name: 'github',
+                        type: 'github',
+                        apiUrl: 'https://api.github.com',
+                        token: config.githubToken,
+                        username: config.githubUsername
+                    }
+                ]
+            });
+        }
+        try {
+            return ConfigSchema.parse(config);
+        }
+        catch (error) {
+            if (error instanceof zod_1.z.ZodError) {
+                const issues = error.issues.map(issue => `${issue.path.join('.')}: ${issue.message}`).join(', ');
+                throw new Error(`Configuration validation failed: ${issues}`);
+            }
+            throw error;
+        }
+    }
+    /**
+     * Obtém a configuração completa validada
+     *
+     * RETORNO:
+     * - Objeto Config com todos os parâmetros
+     *
+     * USO:
+     * - Para acesso direto à configuração
+     * - Para validação de parâmetros
+     */
+    getConfig() {
+        return this.config;
+    }
+    /**
+     * Obtém a URL base do Gitea
+     *
+     * RETORNO:
+     * - URL completa do servidor Gitea
+     *
+     * EXEMPLO:
+     * - http://gitea.local:3000
+     * - https://gitea.company.com
+     */
+    getGiteaUrl() {
+        return this.config.giteaUrl;
+    }
+    /**
+     * Obtém o token de autenticação
+     *
+     * SEGURANÇA:
+     * - Token deve ser mantido seguro
+     * - Não logar em produção
+     * - Rotacionar periodicamente
+     *
+     * RETORNO:
+     * - Token de acesso pessoal
+     */
+    getGiteaToken() {
+        return this.config.giteaToken;
+    }
+    /**
+     * Obtém o nome de usuário configurado
+     *
+     * RETORNO:
+     * - Nome de usuário ou undefined
+     *
+     * USO:
+     * - Para operações específicas do usuário
+     * - Para identificação em logs
+     */
+    getGiteaUsername() {
+        return this.config.giteaUsername;
+    }
+    /**
+     * Verifica se o modo debug está ativo
+     *
+     * RETORNO:
+     * - true se debug ativo, false caso contrário
+     *
+     * RECOMENDAÇÕES:
+     * - Use apenas em desenvolvimento
+     * - Desative em produção
+     * - Configure via DEBUG=true
+     */
+    isDebug() {
+        return this.config.debug;
+    }
+    /**
+     * Obtém o timeout das requisições HTTP
+     *
+     * RETORNO:
+     * - Timeout em milissegundos
+     *
+     * RECOMENDAÇÕES:
+     * - 30000ms para redes locais
+     * - 60000ms para redes com latência
+     * - Configure via TIMEOUT=60000
+     */
+    getTimeout() {
+        return this.config.timeout;
+    }
+    /**
+     * Obtém o tipo de provider configurado
+     *
+     * RETORNO:
+     * - Tipo do provider ('gitea' ou 'github')
+     */
+    getProvider() {
+        return this.config.provider;
+    }
+    /**
+     * Obtém a URL da API genérica
+     *
+     * RETORNO:
+     * - URL da API ou undefined
+     */
+    getApiUrl() {
+        return this.config.apiUrl;
+    }
+    /**
+     * Obtém o token da API genérica
+     *
+     * RETORNO:
+     * - Token da API ou undefined
+     */
+    getApiToken() {
+        return this.config.apiToken;
+    }
+    /**
+     * Obtém o token do GitHub
+     *
+     * RETORNO:
+     * - Token do GitHub ou undefined
+     */
+    getGitHubToken() {
+        return this.config.githubToken;
+    }
+    /**
+     * Obtém o nome de usuário do GitHub
+     *
+     * RETORNO:
+     * - Nome de usuário do GitHub ou undefined
+     */
+    getGitHubUsername() {
+        return this.config.githubUsername;
+    }
+    /**
+     * Obtém o provider padrão configurado
+     *
+     * RETORNO:
+     * - Nome do provider padrão ou undefined
+     */
+    getDefaultProvider() {
+        return this.config.defaultProvider;
+    }
+    /**
+     * Obtém a configuração multi-provider
+     *
+     * RETORNO:
+     * - Configuração multi-provider parseada ou undefined
+     */
+    getProvidersJson() {
+        return this.config.providersJson;
+    }
+    /**
+     * Verifica se está usando configuração multi-provider
+     *
+     * RETORNO:
+     * - true se usando multi-provider, false caso contrário
+     */
+    isMultiProvider() {
+        return !!this.config.providersJson;
+    }
+    /**
+     * Verifica se está usando configuração genérica
+     *
+     * RETORNO:
+     * - true se usando configuração genérica, false caso contrário
+     */
+    isGenericConfig() {
+        return !!(this.config.apiUrl && this.config.apiToken);
+    }
+    /**
+     * Verifica se está usando configuração legacy do Gitea
+     *
+     * RETORNO:
+     * - true se usando configuração legacy, false caso contrário
+     */
+    isLegacyGitea() {
+        return !!(this.config.giteaUrl && this.config.giteaToken);
+    }
+    /**
+     * Verifica se está em modo demo
+     *
+     * RETORNO:
+     * - true se em modo demo, false caso contrário
+     */
+    isDemoMode() {
+        return process.env.DEMO_MODE === 'true';
+    }
+    /**
+     * Obtém configuração demo para testes
+     *
+     * RETORNO:
+     * - Configuração mock para modo demo
+     */
+    getDemoConfig() {
+        return {
+            defaultProvider: 'demo',
+            providers: [{
+                    name: 'demo',
+                    type: 'gitea',
+                    apiUrl: 'https://demo.gitea.io/api/v1',
+                    token: 'demo-token',
+                    username: 'demo-user'
+                }]
+        };
+    }
+}
+exports.ConfigManager = ConfigManager;
+/**
+ * Instância global do ConfigManager
+ *
+ * USO DIRETO:
+ * - import { config } from './config.js';
+ * - const url = config.getGiteaUrl();
+ *
+ * RECOMENDAÇÕES:
+ * - Use esta instância para acesso direto
+ * - Não crie novas instâncias
+ * - Configure antes de usar
+ */
+exports.config = ConfigManager.getInstance();
 //# sourceMappingURL=config.js.map