@andrebuzeli/git-mcp 5.0.9 → 5.2.0

package/README.md

@@ -1,15 +1,18 @@
 # GIT MCP Server
 
-Professional MCP (Model Context Protocol) server for Git operations with multi-provider support.
+Professional MCP (Model Context Protocol) server for Git operations with multi-provider support, enhanced security, and comprehensive safety features.
 
 ## Features
 
-- 🚀 **17 Specialized Git Tools** - Complete Git workflow coverage
-- 🔄 **Multi-Provider Support** - GitHub and Gitea simultaneously
-- � **Compatibilidade com IDEs/Clients** - Alguns clientes MCP ou IDEs esperam nomes alternativos para operações de arquivo (ex.: `listFiles`, `getFile`). O servidor mantém a universalidade oferecendo aliases compatíveis além das operações padrão `file-*`.
-- �🛡️ **Production Ready** - Robust validation and error handling
+- 🚀 **17 Specialized Git Tools** - Complete Git workflow coverage with safety warnings
+- 🔄 **Multi-Provider Support** - GitHub and Gitea simultaneously with credential validation
+- 🔒 **Security-First Design** - Read-only file operations, no content modification via API
+- 🚨 **Safety Warnings** - Comprehensive warnings for destructive operations
+- 🛡️ **Enhanced Error Handling** - Detailed diagnostics with actionable solutions
+- 📋 **Comprehensive Validation** - Pre-execution validation with helpful guidance
+- 🔧 **IDE/Client Compatibility** - Universal aliases for different MCP client expectations
 - 📦 **NPM Distribution** - Easy installation via npx
-- 🤖 **AI Agent Integration** - Designed for AI agent workflows
+- 🤖 **AI Agent Integration** - Designed for AI agent workflows with safety controls
 
 ## Quick Start
 
@@ -46,143 +49,299 @@ Configure both GitHub and Gitea to use `provider="both"` in tool calls.
 
 ## Available Tools
 
-| Tool | Description | Operations |
-|------|-------------|------------|
-| `git-workflow` | Core Git workflow operations | init, commit, sync, status, backup, create, list, get, update, delete, fork, search |
-| `git-files` | File management operations | read, create, update, delete, search, backup, list |
-| `git-branches` | Branch management | create, list, get, delete, merge, compare |
-| `git-issues` | Issue management | create, list, get, update, close, comment, search |
-| `git-pulls` | Pull request management | create, list, get, update, merge, close, review, search |
-| `git-tags` | Tag operations | create, list, get, delete, search |
-| `git-release` | Release management | create, list, get, update, delete, publish, download |
-| `git-remote` | Remote operations | add, remove, rename, show, set-url, prune |
-| `git-reset` | Reset operations | soft, mixed, hard, reset-to-commit, reset-branch |
-| `git-stash` | Stash management | stash, pop, apply, list, show, drop, clear |
-| `git-config` | Git configuration | get, set, unset, list, edit, show |
-| `git-monitor` | Monitoring and logs | log, status, commits, contributors |
-| `git-backup` | Backup system | backup, restore, list, verify |
-| `git-archive` | Archive operations | create, extract, list, verify |
-| `git-packages` | Package management | list, get, create, update, delete, publish, download |
-| `git-analytics` | Analytics and stats | stats, commits, contributors |
-| `git-sync` | Advanced synchronization | sync, status |
+| Tool | Description | Operations | Safety Features |
+|------|-------------|------------|-----------------|
+| `git-workflow` | Core Git operations | init, status, commit, sync, backup, create, list, get, update, delete, fork, search | Repository deletion warnings |
+| `git-files` | **Read-only** file operations | read, list, search, backup | File modification blocked |
+| `git-branches` | Branch management | create, list, get, delete, merge, compare | Branch deletion warnings |
+| `git-issues` | Issue management | create, list, get, update, close, comment, search | - |
+| `git-pulls` | Pull request management | create, list, get, update, merge, close, review, search | - |
+| `git-tags` | Tag management | create, list, get, delete, search | - |
+| `git-release` | Release management | create, list, get, update, delete, publish, download | - |
+| `git-remote` | Remote repository management | add, remove, rename, show, set-url, prune | - |
+| `git-reset` | **⚠️ Repository reset** | soft, mixed, hard, reset-to-commit, reset-branch | **Hard reset warnings** |
+| `git-stash` | Stash management | stash, pop, apply, list, show, drop, clear | - |
+| `git-config` | Git configuration | get, set, unset, list, edit, show | - |
+| `git-monitor` | Repository monitoring | status, changes, health | - |
+| `git-backup` | Repository backup | create, restore, list, verify | - |
+| `git-archive` | Repository archiving | create, extract, list, verify | - |
+| `git-sync` | Repository synchronization | sync, status | - |
+| `git-packages` | Package management | list, get, create, update, delete, publish, download | - |
+| `git-analytics` | Repository analytics | stats, insights, reports | - |
+
+## Security Features
+
+### 🔒 File Operations Restriction
+
+The `git-files` tool is **read-only only** for security reasons:
+
+**✅ Allowed Operations:**
+- `read` - Read file content
+- `list` - List directory contents  
+- `search` - Search file content
+- `backup` - Create local backups
+
+**❌ Blocked Operations:**
+- `create` - Create new files (blocked)
+- `update` - Modify existing files (blocked)
+- `delete` - Delete files (blocked)
+
+**Why?** File content modification should be done through your local development environment, not via remote API calls.
+
+### 🚨 Safety Warnings
+
+Destructive operations include comprehensive safety warnings:
+
+#### Git Reset Warnings
+```json
+{
+  "tool": "git-reset",
+  "params": {
+    "action": "hard",
+    "projectPath": "/path/to/project"
+  }
+}
+```
+
+**Result:** Detailed warning about data loss with alternatives:
+- `git reset --soft` (keeps changes staged)
+- `git reset --mixed` (keeps changes unstaged)  
+- `git stash` (saves changes temporarily)
+
+#### Branch Deletion Warnings
+```json
+{
+  "tool": "git-branches", 
+  "params": {
+    "action": "delete",
+    "branchName": "feature-branch"
+  }
+}
+```
+
+**Result:** Warning about permanent branch deletion with suggestions:
+- Ensure branch is merged first
+- Create backup branch before deletion
+- Check for unmerged commits
+
+### 🔍 Enhanced Error Handling
+
+All tools provide detailed error messages with actionable solutions:
+
+**Example Error Response:**
+```json
+{
+  "success": false,
+  "error": {
+    "code": "BRANCH_NOT_FOUND",
+    "message": "Branch not found",
+    "suggestions": [
+      "Check if the branch name is correct",
+      "Use git branch -a to see all available branches", 
+      "Ensure the branch exists on the remote repository"
+    ]
+  }
+}
+```
 
 ## Usage Examples
 
-### Basic Git Operations
+### Local Git Operations
 
 ```json
 {
-  "name": "git-workflow",
-  "arguments": {
-    "action": "init",
+  "tool": "git-workflow",
+  "params": {
+    "action": "status",
     "projectPath": "/path/to/project"
   }
 }
 ```
 
+```json
+{
+  "tool": "git-workflow", 
+  "params": {
+    "action": "commit",
+    "projectPath": "/path/to/project",
+    "message": "Add new feature"
+  }
+}
+```
+
 ### Remote Repository Operations
 
 ```json
 {
-  "name": "git-workflow",
-  "arguments": {
+  "tool": "git-workflow",
+  "params": {
     "action": "create",
-    "projectPath": "/path/to/project",
+    "projectPath": "/path/to/project", 
     "provider": "github",
     "name": "my-new-repo",
     "description": "My new repository",
-    "private": false
+    "private": true
   }
 }
 ```
 
-### Multi-Provider Operations
+### Safe File Operations (Read-Only)
 
 ```json
 {
-  "name": "git-issues",
-  "arguments": {
-    "action": "create",
+  "tool": "git-files",
+  "params": {
+    "action": "read",
     "projectPath": "/path/to/project",
-    "provider": "both",
-    "title": "Bug Report",
-    "body": "Description of the issue"
+    "filePath": "README.md"
   }
 }
 ```
 
-### File Management
+### Destructive Operations (With Warnings)
 
 ```json
 {
-  "name": "git-files",
-  "arguments": {
-    "action": "create",
+  "tool": "git-reset",
+  "params": {
+    "action": "hard",
     "projectPath": "/path/to/project",
-    "provider": "github",
-    "path": "src/new-file.js",
-    "content": "console.log('Hello World');",
-    "message": "Add new file"
+    "confirmDestructive": true
   }
 }
 ```
 
-## MCP Resources
+## Error Codes Reference
+
+### Common Error Codes
+
+| Code | Description | Solution |
+|------|-------------|----------|
+| `VALIDATION_ERROR` | Parameter validation failed | Check required parameters and format |
+| `NOT_A_GIT_REPOSITORY` | Directory is not a Git repository | Use `git init` first |
+| `NOTHING_TO_COMMIT` | No changes to commit | Make changes first |
+| `MERGE_CONFLICT` | Merge conflicts detected | Resolve conflicts before proceeding |
+| `PERMISSION_DENIED` | Permission denied | Check credentials and access rights |
+| `PROVIDER_NOT_CONFIGURED` | Provider not configured | Set up GitHub or Gitea credentials |
+| `NETWORK_ERROR` | Network connectivity issue | Check internet connection |
+| `OPERATION_RESTRICTED` | File modification blocked | Use read-only operations only |
+| `SAFETY_WARNING` | Destructive operation detected | Review warning and confirm if needed |
+
+### Git-Specific Error Codes
+
+| Code | Description | Solution |
+|------|-------------|----------|
+| `BRANCH_EXISTS` | Branch already exists | Use different name or delete existing |
+| `BRANCH_NOT_FOUND` | Branch not found | Check branch name and remote config |
+| `DIRTY_WORKING_TREE` | Uncommitted changes | Commit or stash changes first |
+| `DETACHED_HEAD` | Repository in detached HEAD state | Create branch or checkout existing |
+| `REF_LOCK_ERROR` | Cannot lock Git reference | Wait for other operations to complete |
+
+## Configuration Guide
+
+### Environment Variables
+
+**Required for GitHub:**
+- `GITHUB_TOKEN` - Personal access token with repo permissions
+- `GITHUB_USERNAME` - Your GitHub username
+
+**Required for Gitea:**
+- `GITEA_URL` - Your Gitea instance URL (e.g., `https://git.example.com`)
+- `GITEA_TOKEN` - Personal access token
+- `GITEA_USERNAME` - Your Gitea username
+
+### Credential Validation
+
+The server automatically validates credentials on startup:
+
+- ✅ **Valid credentials** - API connectivity confirmed
+- ❌ **Invalid token** - Authentication failed
+- 🌐 **Network error** - Cannot reach provider API
+- ⚠️ **Partial failure** - Some providers failed validation
 
-- `mcp-git://status` - Server status and configuration
-- `mcp-git://tools` - List of available tools with detailed information
+### Setup Instructions
 
-## Error Handling
+1. **Generate GitHub Token:**
+   - Go to GitHub Settings → Developer settings → Personal access tokens
+   - Create token with `repo` scope
+   - Copy token to `GITHUB_TOKEN` environment variable
 
-The server provides comprehensive error handling with:
+2. **Generate Gitea Token:**
+   - Go to your Gitea instance → Settings → Applications
+   - Generate new token with appropriate permissions
+   - Copy token to `GITEA_TOKEN` environment variable
 
-- **Detailed Error Messages** - Clear descriptions of what went wrong
-- **Configuration Guidance** - Instructions for missing setup
-- **Validation Errors** - Specific parameter validation feedback
-- **Troubleshooting Tips** - Actionable suggestions for resolution
+3. **Test Configuration:**
+   ```bash
+   # Start the server to see validation results
+   npx @andrebuzeli/git-mcp@latest
+   ```
 
-## Requirements
+## Troubleshooting
 
-- **Node.js** 18.0.0 or higher
-- **Git** installed and accessible in PATH
-- **Provider Credentials** (GitHub token, Gitea token) for remote operations
+### Common Issues
+
+**"Provider not configured" error:**
+- Check environment variables are set correctly
+- Verify token has required permissions
+- Test API connectivity manually
+
+**"Operation restricted" error:**
+- File modification operations are blocked for security
+- Use read-only operations: `read`, `list`, `search`, `backup`
+- Make file changes through your local development environment
+
+**"Safety warning" error:**
+- Review the detailed warning message
+- Consider safer alternatives suggested
+- Use `confirmDestructive: true` only if absolutely necessary
+
+**"Network error" errors:**
+- Check internet connectivity
+- Verify provider URLs are correct
+- Check firewall/proxy settings
+
+### Getting Help
+
+1. **Check error messages** - They include specific suggestions
+2. **Review safety warnings** - They explain risks and alternatives  
+3. **Validate credentials** - Server validates on startup
+4. **Use read-only operations** - Safe file operations are always available
 
 ## Development
 
-### Local Development
+### Building from Source
 
 ```bash
-# Clone the repository
-git clone https://github.com/andrebuzeli/git-mcp.git
+git clone https://github.com/your-repo/git-mcp.git
 cd git-mcp
-
-# Install dependencies
 npm install
-
-# Build the project
 npm run build
-
-# Run locally
-npm start
-
-# Development mode with auto-reload
-npm run dev
 ```
 
 ### Testing
 
 ```bash
-# Run tests
 npm test
-
-# Run tests in watch mode
-npm run test:watch
 ```
 
 ## License
 
-MIT License - see [LICENSE](LICENSE) file for details.
+MIT License - see LICENSE file for details.
 
 ## Contributing
 
-Contributions are welcome! Please read our contributing guidelines and submit pull requests.
+1. Fork the repository
+2. Create a feature branch
+3. Make your changes
+4. Add tests for new functionality
+5. Submit a pull request
+
+---
+
+**⚠️ Important Security Notes:**
+
+- File content modification is intentionally restricted for security
+- Always review safety warnings before destructive operations
+- Keep your API tokens secure and rotate them regularly
+- Use `confirmDestructive: true` only when absolutely necessary

package/dist/__tests__/setup.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Setup de Testes - Git MCP
+ *
+ * Configurações globais para melhorar performance e confiabilidade dos testes
+ */
+declare global {
+    var testRepoPath: string;
+}
+export {};
+//# sourceMappingURL=setup.d.ts.map

package/dist/__tests__/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../src/__tests__/setup.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAkFH,OAAO,CAAC,MAAM,CAAC;IACb,IAAI,YAAY,EAAE,MAAM,CAAC;CAC1B"}

package/dist/__tests__/setup.js

@@ -0,0 +1,105 @@
+"use strict";
+/**
+ * Setup de Testes - Git MCP
+ *
+ * Configurações globais para melhorar performance e confiabilidade dos testes
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const child_process_1 = require("child_process");
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+// Configurar timeout global para operações Git
+jest.setTimeout(30000);
+// Setup global antes de todos os testes
+beforeAll(async () => {
+    console.log('🚀 Iniciando setup de testes Git MCP...');
+    // Configurar variáveis de ambiente
+    process.env.GITHUB_TOKEN = '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';
+    process.env.GITHUB_USERNAME = 'andrebuzeli';
+    process.env.GITEA_URL = 'http://nas-ubuntu:3000';
+    process.env.GITEA_TOKEN = 'e9e5c441d5e8559004a9efd0614487bc5d7b0f23';
+    process.env.GITEA_USERNAME = 'admin';
+    // Criar repositório de teste em diretório local (evitar caminhos UNC)
+    const testRepoPath = path.join(process.cwd(), 'temp-test-repo');
+    try {
+        // Limpar repositório anterior se existir
+        if (fs.existsSync(testRepoPath)) {
+            fs.rmSync(testRepoPath, { recursive: true, force: true });
+        }
+        // Criar diretório
+        fs.mkdirSync(testRepoPath, { recursive: true });
+        // Inicializar repositório Git
+        (0, child_process_1.execSync)('git init', { cwd: testRepoPath, stdio: 'pipe' });
+        // Configurar Git user
+        (0, child_process_1.execSync)('git config user.email "test@git-mcp.com"', { cwd: testRepoPath, stdio: 'pipe' });
+        (0, child_process_1.execSync)('git config user.name "Test User"', { cwd: testRepoPath, stdio: 'pipe' });
+        // Criar arquivos de teste
+        fs.writeFileSync(path.join(testRepoPath, 'README.md'), '# Test Repository\n\nThis is a test repository for Git MCP testing.\n');
+        fs.writeFileSync(path.join(testRepoPath, 'package.json'), JSON.stringify({
+            name: 'test-repo',
+            version: '1.0.0',
+            description: 'Test repository'
+        }, null, 2));
+        // Criar estrutura de diretórios
+        fs.mkdirSync(path.join(testRepoPath, 'src'), { recursive: true });
+        fs.mkdirSync(path.join(testRepoPath, 'tests'), { recursive: true });
+        fs.writeFileSync(path.join(testRepoPath, 'src/main.js'), 'console.log("Hello, Git MCP!");\n');
+        fs.writeFileSync(path.join(testRepoPath, 'tests/sample.test.js'), 'test("sample", () => expect(1).toBe(1));\n');
+        // Fazer commit inicial
+        (0, child_process_1.execSync)('git add .', { cwd: testRepoPath, stdio: 'pipe' });
+        (0, child_process_1.execSync)('git commit -m "Initial commit - Test repository for Git MCP"', { cwd: testRepoPath, stdio: 'pipe' });
+        console.log('✅ Repositório de teste configurado com sucesso');
+    }
+    catch (error) {
+        console.warn('⚠️ Erro ao configurar repositório de teste:', error);
+    }
+});
+// Cleanup global após todos os testes
+afterAll(async () => {
+    console.log('🧹 Limpando arquivos de teste...');
+    const testRepoPath = path.join(process.cwd(), 'temp-test-repo');
+    try {
+        if (fs.existsSync(testRepoPath)) {
+            fs.rmSync(testRepoPath, { recursive: true, force: true });
+            console.log('✅ Arquivos de teste removidos');
+        }
+    }
+    catch (error) {
+        console.warn('⚠️ Erro ao limpar arquivos de teste:', error);
+    }
+});
+global.testRepoPath = path.join(process.cwd(), 'temp-test-repo');
+//# sourceMappingURL=setup.js.map

package/dist/__tests__/setup.js.map

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

package/dist/config.d.ts

@@ -33,6 +33,37 @@ export interface ConfigValidationResult {
         exampleConfig: Record<string, string>;
     };
 }
+export interface DetailedValidationResult {
+    isValid: boolean;
+    providerResults: {
+        github?: ProviderValidationResult;
+        gitea?: ProviderValidationResult;
+    };
+    summary: {
+        totalProviders: number;
+        validProviders: number;
+        errors: string[];
+        warnings: string[];
+    };
+}
+export interface ProviderValidationResult {
+    provider: 'github' | 'gitea';
+    isValid: boolean;
+    isConfigured: boolean;
+    credentialStatus: 'valid' | 'invalid' | 'missing' | 'network_error';
+    errorDetails?: string;
+    userInfo?: {
+        username: string;
+        displayName?: string;
+        email?: string;
+    };
+    permissions?: string[];
+    rateLimit?: {
+        limit: number;
+        remaining: number;
+        reset: Date;
+    };
+}
 export declare class ConfigManager {
     private config;
     constructor();
@@ -64,6 +95,18 @@ export declare class ConfigManager {
      * Checks if a provider is supported for operations
      */
     isProviderSupported(provider: 'github' | 'gitea' | 'both'): boolean;
+    /**
+     * Validates credentials with detailed testing of API connectivity
+     */
+    validateCredentialsDetailed(): Promise<DetailedValidationResult>;
+    /**
+     * Validates GitHub credentials with API test
+     */
+    private validateGitHubCredentials;
+    /**
+     * Validates Gitea credentials with API test
+     */
+    private validateGiteaCredentials;
     /**
      * Gets configuration guidance for missing setup
      */

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,EAAE;QACP,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,KAAK,CAAC,EAAE;QACN,GAAG,EAAE,MAAM,CAAC;QACZ,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;CACH;AAED,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,OAAO,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,kBAAkB,CAAC,EAAE;QACnB,eAAe,EAAE,MAAM,EAAE,CAAC;QAC1B,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KACvC,CAAC;CACH;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAe;;IAM7B,OAAO,CAAC,iBAAiB;IAuBlB,SAAS,IAAI,YAAY;IAIzB,kBAAkB,IAAI,OAAO;IAI7B,iBAAiB,IAAI,OAAO;IAI5B,sBAAsB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAOvD;;OAEG;IACI,mBAAmB,IAAI,sBAAsB;IA2DpD;;OAEG;IACI,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,cAAc;IAgDhE;;OAEG;IACI,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS;IAU3E;;OAEG;IACI,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO;eAhN5C,MAAM;kBACH,MAAM;;IAmNlB;;OAEG;IACI,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO;IAO1E;;OAEG;IACI,wBAAwB,IAAI;QACjC,eAAe,EAAE,MAAM,EAAE,CAAC;QAC1B,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACtC,iBAAiB,EAAE,MAAM,EAAE,CAAC;KAC7B;CAqBF;AAGD,eAAO,MAAM,aAAa,eAAsB,CAAC;AAEjD,wBAAgB,iBAAiB,IAAI,YAAY,CAEhD"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,EAAE;QACP,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,KAAK,CAAC,EAAE;QACN,GAAG,EAAE,MAAM,CAAC;QACZ,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;CACH;AAED,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,OAAO,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,kBAAkB,CAAC,EAAE;QACnB,eAAe,EAAE,MAAM,EAAE,CAAC;QAC1B,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KACvC,CAAC;CACH;AAED,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,OAAO,CAAC;IACjB,eAAe,EAAE;QACf,MAAM,CAAC,EAAE,wBAAwB,CAAC;QAClC,KAAK,CAAC,EAAE,wBAAwB,CAAC;KAClC,CAAC;IACF,OAAO,EAAE;QACP,cAAc,EAAE,MAAM,CAAC;QACvB,cAAc,EAAE,MAAM,CAAC;QACvB,MAAM,EAAE,MAAM,EAAE,CAAC;QACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;KACpB,CAAC;CACH;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,OAAO,CAAC;IACtB,gBAAgB,EAAE,OAAO,GAAG,SAAS,GAAG,SAAS,GAAG,eAAe,CAAC;IACpE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE;QACT,QAAQ,EAAE,MAAM,CAAC;QACjB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,SAAS,CAAC,EAAE;QACV,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,EAAE,MAAM,CAAC;QAClB,KAAK,EAAE,IAAI,CAAC;KACb,CAAC;CACH;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAe;;IAM7B,OAAO,CAAC,iBAAiB;IAuBlB,SAAS,IAAI,YAAY;IAIzB,kBAAkB,IAAI,OAAO;IAI7B,iBAAiB,IAAI,OAAO;IAI5B,sBAAsB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAOvD;;OAEG;IACI,mBAAmB,IAAI,sBAAsB;IA2DpD;;OAEG;IACI,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,cAAc;IAgDhE;;OAEG;IACI,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS;IAU3E;;OAEG;IACI,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO;eAjP5C,MAAM;kBACH,MAAM;;IAoPlB;;OAEG;IACI,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO;IAO1E;;OAEG;IACU,2BAA2B,IAAI,OAAO,CAAC,wBAAwB,CAAC;IAgD7E;;OAEG;YACW,yBAAyB;IA6DvC;;OAEG;YACW,wBAAwB;IAsDtC;;OAEG;IACI,wBAAwB,IAAI;QACjC,eAAe,EAAE,MAAM,EAAE,CAAC;QAC1B,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACtC,iBAAiB,EAAE,MAAM,EAAE,CAAC;KAC7B;CAqBF;AAGD,eAAO,MAAM,aAAa,eAAsB,CAAC;AAEjD,wBAAgB,iBAAiB,IAAI,YAAY,CAEhD"}