@kawoou/kadoc-mcp 0.1.0

package/README.md

@@ -0,0 +1,200 @@
+# kadoc-mcp
+
+[![npm version](https://badge.fury.io/js/%40kawoou%2Fkadoc-mcp.svg)](https://www.npmjs.com/package/@kawoou/kadoc-mcp)
+
+kadoc-server를 위한 MCP (Model Context Protocol) 클라이언트
+
+## 기능
+
+- kadoc-server 문서 CRUD 연동
+- BM25 전문 검색
+- 폴더 관리
+- 봉투 암호화 세션 지원 (X25519 + XSalsa20-Poly1305)
+- 자동 세션 관리
+
+## 설치
+
+```bash
+# 설치 없이 바로 실행
+npx @kawoou/kadoc-mcp
+
+# 또는 글로벌 설치
+npm install -g @kawoou/kadoc-mcp
+kadoc-mcp
+```
+
+## 설정
+
+### 자동 설정 (권장)
+
+MCP가 처음 실행될 때 설정 파일이 없으면 자동으로 사용자를 등록하고 `~/.kadoc.json` 파일을 생성합니다.
+
+1. `KADOC_SERVER_URL` 환경 변수 설정 (또는 기본값 `http://localhost:3000` 사용)
+2. Claude Desktop에서 MCP 실행
+3. 자동으로 사용자 등록 및 설정 파일 생성 완료
+
+### 수동 설정
+
+`~/.kadoc.json` 파일을 직접 생성할 수도 있습니다:
+
+```json
+{
+  "servers": {
+    "default": {
+      "url": "http://localhost:3000",
+      "auth": {
+        "authKey": "your-auth-key-from-register"
+      }
+    },
+    "production": {
+      "url": "https://kadoc.example.com",
+      "auth": {
+        "authKey": "production-auth-key"
+      }
+    }
+  },
+  "defaultServer": "default"
+}
+```
+
+수동 등록 시:
+```bash
+curl -X POST http://localhost:3000/auth/register
+```
+응답의 `authKey`를 설정 파일에 저장
+
+## Claude Desktop 설정
+
+`claude_desktop_config.json`에 추가:
+
+```json
+{
+  "mcpServers": {
+    "kadoc": {
+      "command": "npx",
+      "args": ["@kawoou/kadoc-mcp"],
+      "env": {
+        "KADOC_SERVER_URL": "http://localhost:3000"
+      }
+    }
+  }
+}
+```
+
+또는 기존 설정 파일 사용 시:
+```json
+{
+  "mcpServers": {
+    "kadoc": {
+      "command": "npx",
+      "args": ["@kawoou/kadoc-mcp"],
+      "env": {
+        "KADOC_CONFIG": "~/.kadoc.json"
+      }
+    }
+  }
+}
+```
+
+## MCP Tools
+
+### 문서 관리
+| 도구 | 설명 |
+|------|------|
+| `write_document` | 문서 작성 (path, title, content, metadata?) |
+| `update_document` | 문서 수정 (path, title?, content?, metadata?) |
+| `read_document` | 문서 읽기 (path) |
+| `delete_document` | 문서 삭제 (path) |
+| `list_documents` | 문서 목록 조회 (folder?, limit?) |
+
+`metadata`는 임의의 키-값 쌍을 저장하는 JSON 객체입니다:
+```json
+{ "author": "홍길동", "tags": ["회의", "2024"], "priority": "high" }
+```
+
+### 검색
+| 도구 | 설명 |
+|------|------|
+| `search` | BM25 기반 전문 검색 (query, folder?, limit?) |
+
+### 폴더 관리
+| 도구 | 설명 |
+|------|------|
+| `create_folder` | 폴더 생성 (path) |
+| `list_folders` | 폴더 목록 조회 (limit?) |
+| `delete_folder` | 폴더 및 하위 문서 삭제 (path) |
+| `get_index_settings` | 인덱스 설정 조회 (path) |
+| `set_index_settings` | 인덱스 설정 변경 (path, indexFields?) |
+
+`indexFields`에 지정된 메타데이터 필드가 검색 인덱스에 포함됩니다.
+`title`과 `content`는 항상 인덱싱되며, 설정 변경 시 폴더 내 문서가 자동 재인덱싱됩니다.
+
+## 암호화 세션
+
+kadoc-mcp는 자동으로 암호화 세션을 관리합니다:
+
+1. 첫 요청 시 `handshake()` 호출
+2. X25519 ECDH로 shared secret 생성
+3. 이후 모든 요청/응답 XSalsa20-Poly1305로 암호화
+4. 세션 만료 시 자동 재연결
+
+수동으로 세션 제어:
+```typescript
+import { KadocClient } from '@kawoou/kadoc-mcp';
+
+const client = new KadocClient(config);
+
+// 세션 시작
+await client.handshake();
+
+// 세션 상태 확인
+if (client.hasSession()) {
+  // 암호화 통신 중
+}
+
+// 세션 종료
+await client.endSession();
+```
+
+## 개발
+
+```bash
+# 의존성 설치
+npm install
+
+# 개발 모드 실행
+npm run dev
+
+# 빌드
+npm run build
+
+# 테스트
+npm test
+```
+
+## 환경 변수
+
+| 변수 | 설명 |
+|------|------|
+| `KADOC_SERVER_URL` | kadoc-server URL (기본: `http://localhost:3000`) |
+| `KADOC_CONFIG` | 설정 파일 경로 (기본: `~/.kadoc.json`) |
+
+## 프로젝트 구조
+
+```
+src/
+├── index.ts           # MCP 서버 엔트리포인트
+├── config.ts          # 설정 파일 로더
+├── client/
+│   └── kadoc-client.ts # HTTP 클라이언트 (암호화 지원)
+├── crypto/
+│   └── envelope.ts    # 암호화 유틸리티
+└── tools/
+    ├── documents.ts   # 문서 MCP 도구
+    ├── folders.ts     # 폴더 MCP 도구
+    └── search.ts      # 검색 MCP 도구
+```
+
+## 라이선스
+
+MIT

package/dist/client/kadoc-client.d.ts

@@ -0,0 +1,74 @@
+import { Config } from '../config.js';
+export interface ApiError {
+    error: {
+        code: string;
+        message: string;
+        details?: unknown;
+    };
+    requestId: string;
+}
+export interface PaginatedResponse<T> {
+    items: T[];
+    nextCursor?: string;
+    hasMore: boolean;
+}
+export declare class KadocClient {
+    private config;
+    private sessions;
+    constructor(config: Config);
+    /**
+     * Make a request to the kadoc-server
+     * Automatically uses encryption if session is established
+     */
+    request<T>(method: 'GET' | 'POST' | 'PUT' | 'DELETE', path: string, body?: unknown, serverName?: string): Promise<T>;
+    /**
+     * Perform handshake with server to establish encrypted session
+     */
+    handshake(serverName?: string): Promise<void>;
+    /**
+     * End encrypted session
+     */
+    endSession(serverName?: string): Promise<void>;
+    /**
+     * Check if session is established and valid
+     */
+    hasSession(serverName?: string): boolean;
+    createDocument(params: {
+        path: string;
+        title: string;
+        content: string;
+        metadata?: Record<string, unknown>;
+    }): Promise<unknown>;
+    readDocument(path: string): Promise<unknown>;
+    updateDocument(params: {
+        path: string;
+        title?: string;
+        content?: string;
+        metadata?: Record<string, unknown>;
+    }): Promise<unknown>;
+    deleteDocument(path: string): Promise<unknown>;
+    listDocuments(params: {
+        folder?: string;
+        cursor?: string;
+        limit?: number;
+    }): Promise<unknown>;
+    search(params: {
+        query: string;
+        folder?: string;
+        limit?: number;
+    }): Promise<unknown>;
+    createFolder(params: {
+        path: string;
+    }): Promise<unknown>;
+    listFolders(params: {
+        cursor?: string;
+        limit?: number;
+    }): Promise<unknown>;
+    deleteFolder(path: string): Promise<unknown>;
+    getIndexSettings(path: string): Promise<unknown>;
+    setIndexSettings(params: {
+        path: string;
+        indexFields?: string[];
+    }): Promise<unknown>;
+}
+//# sourceMappingURL=kadoc-client.d.ts.map

package/dist/client/kadoc-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kadoc-client.d.ts","sourceRoot":"","sources":["../../src/client/kadoc-client.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAmB,MAAM,cAAc,CAAC;AAYvD,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE;QACL,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,OAAO,CAAC;KACnB,CAAC;IACF,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB,CAAC,CAAC;IAClC,KAAK,EAAE,CAAC,EAAE,CAAC;IACX,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;CAClB;AAoBD,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAuC;gBAE3C,MAAM,EAAE,MAAM;IAI1B;;;OAGG;IACG,OAAO,CAAC,CAAC,EACb,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,EACzC,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,OAAO,EACd,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,CAAC,CAAC;IAwEb;;OAEG;IACG,SAAS,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAwCnD;;OAEG;IACG,UAAU,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAoBpD;;OAEG;IACH,UAAU,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO;IAOlC,cAAc,CAAC,MAAM,EAAE;QAC3B,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACpC;IASK,YAAY,CAAC,IAAI,EAAE,MAAM;IAIzB,cAAc,CAAC,MAAM,EAAE;QAC3B,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACpC;IAQK,cAAc,CAAC,IAAI,EAAE,MAAM;IAI3B,aAAa,CAAC,MAAM,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;IAW1E,MAAM,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;IASjE,YAAY,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE;IAIrC,WAAW,CAAC,MAAM,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;IASvD,YAAY,CAAC,IAAI,EAAE,MAAM;IAIzB,gBAAgB,CAAC,IAAI,EAAE,MAAM;IAI7B,gBAAgB,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE;CAKxE"}

package/dist/client/kadoc-client.js

@@ -0,0 +1,202 @@
+import { request } from 'undici';
+import { getServerConfig } from '../config.js';
+import { generateKeyPair, computeSharedSecret, encodePublicKey, decodePublicKey, encrypt, decryptJson, generateNonce, } from '../crypto/envelope.js';
+export class KadocClient {
+    config;
+    sessions = new Map(); // serverName -> session
+    constructor(config) {
+        this.config = config;
+    }
+    /**
+     * Make a request to the kadoc-server
+     * Automatically uses encryption if session is established
+     */
+    async request(method, path, body, serverName) {
+        const serverConfig = getServerConfig(this.config, serverName);
+        const serverKey = serverName ?? this.config.defaultServer;
+        const url = `${serverConfig.url}${path}`;
+        const headers = {
+            'X-Auth-Key': serverConfig.auth.authKey,
+        };
+        // Only set Content-Type for requests with body
+        if (body || (method !== 'GET' && method !== 'DELETE')) {
+            headers['Content-Type'] = 'application/json';
+        }
+        // Get session if available
+        const session = this.sessions.get(serverKey);
+        let requestBody = body;
+        if (session && Date.now() < session.expiresAt) {
+            headers['X-Session-Id'] = session.sessionId;
+            // Encrypt request body if present
+            if (body) {
+                const encrypted = encrypt(body, session.sharedSecret);
+                const nonce = generateNonce();
+                requestBody = { encrypted, nonce };
+            }
+        }
+        const response = await request(url, {
+            method,
+            headers,
+            body: requestBody ? JSON.stringify(requestBody) : undefined,
+        });
+        // Handle 204 No Content responses
+        if (response.statusCode === 204) {
+            return {};
+        }
+        // Read response text first to handle empty body
+        const responseText = await response.body.text();
+        let responseBody;
+        try {
+            responseBody = responseText ? JSON.parse(responseText) : {};
+        }
+        catch {
+            // If response is not JSON, return empty object for success, throw for error
+            if (response.statusCode >= 400) {
+                throw new Error(`HTTP ${response.statusCode}: ${responseText}`);
+            }
+            return {};
+        }
+        if (response.statusCode >= 400) {
+            const error = responseBody;
+            throw new Error(`[${error.error?.code || 'ERROR'}] ${error.error?.message || 'Unknown error'}`);
+        }
+        // Decrypt response if encrypted
+        if (session && responseBody.encrypted) {
+            const encryptedResponse = responseBody;
+            const decrypted = decryptJson(encryptedResponse.encrypted, session.sharedSecret);
+            if (!decrypted) {
+                throw new Error('Failed to decrypt response');
+            }
+            return decrypted;
+        }
+        return responseBody;
+    }
+    /**
+     * Perform handshake with server to establish encrypted session
+     */
+    async handshake(serverName) {
+        const serverConfig = getServerConfig(this.config, serverName);
+        const serverKey = serverName ?? this.config.defaultServer;
+        // Generate ephemeral key pair
+        const clientKeyPair = generateKeyPair();
+        const url = `${serverConfig.url}/auth/handshake`;
+        const response = await request(url, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'X-Auth-Key': serverConfig.auth.authKey,
+            },
+            body: JSON.stringify({
+                clientPublicKey: encodePublicKey(clientKeyPair.publicKey),
+            }),
+        });
+        const responseBody = await response.body.json();
+        if (response.statusCode >= 400) {
+            const error = responseBody;
+            throw new Error(`[${error.error.code}] ${error.error.message}`);
+        }
+        const handshakeResponse = responseBody;
+        // Compute shared secret
+        const serverPublicKey = decodePublicKey(handshakeResponse.data.serverPublicKey);
+        const sharedSecret = computeSharedSecret(clientKeyPair.secretKey, serverPublicKey);
+        // Store session
+        this.sessions.set(serverKey, {
+            sessionId: handshakeResponse.data.sessionId,
+            sharedSecret,
+            expiresAt: handshakeResponse.data.expiresAt,
+        });
+    }
+    /**
+     * End encrypted session
+     */
+    async endSession(serverName) {
+        const serverConfig = getServerConfig(this.config, serverName);
+        const serverKey = serverName ?? this.config.defaultServer;
+        const session = this.sessions.get(serverKey);
+        if (!session) {
+            return;
+        }
+        const url = `${serverConfig.url}/auth/session`;
+        await request(url, {
+            method: 'DELETE',
+            headers: {
+                'X-Session-Id': session.sessionId,
+            },
+        });
+        this.sessions.delete(serverKey);
+    }
+    /**
+     * Check if session is established and valid
+     */
+    hasSession(serverName) {
+        const serverKey = serverName ?? this.config.defaultServer;
+        const session = this.sessions.get(serverKey);
+        return !!session && Date.now() < session.expiresAt;
+    }
+    // Document operations
+    async createDocument(params) {
+        return this.request('POST', '/documents', {
+            path: params.path,
+            title: params.title,
+            content: params.content,
+            metadata: params.metadata,
+        });
+    }
+    async readDocument(path) {
+        return this.request('GET', `/documents/${encodeURIComponent(path)}`);
+    }
+    async updateDocument(params) {
+        return this.request('PUT', `/documents/${encodeURIComponent(params.path)}`, {
+            title: params.title,
+            content: params.content,
+            metadata: params.metadata,
+        });
+    }
+    async deleteDocument(path) {
+        return this.request('DELETE', `/documents/${encodeURIComponent(path)}`);
+    }
+    async listDocuments(params) {
+        const searchParams = new URLSearchParams();
+        if (params.folder)
+            searchParams.set('folder', params.folder);
+        if (params.cursor)
+            searchParams.set('cursor', params.cursor);
+        if (params.limit)
+            searchParams.set('limit', String(params.limit));
+        const query = searchParams.toString();
+        return this.request('GET', `/documents${query ? `?${query}` : ''}`);
+    }
+    // Search
+    async search(params) {
+        return this.request('POST', '/search', {
+            query: params.query,
+            folder: params.folder,
+            limit: params.limit,
+        });
+    }
+    // Folder operations
+    async createFolder(params) {
+        return this.request('POST', '/folders', { path: params.path });
+    }
+    async listFolders(params) {
+        const searchParams = new URLSearchParams();
+        if (params.cursor)
+            searchParams.set('cursor', params.cursor);
+        if (params.limit)
+            searchParams.set('limit', String(params.limit));
+        const query = searchParams.toString();
+        return this.request('GET', `/folders${query ? `?${query}` : ''}`);
+    }
+    async deleteFolder(path) {
+        return this.request('DELETE', `/folders/${encodeURIComponent(path)}`);
+    }
+    async getIndexSettings(path) {
+        return this.request('GET', `/folders/${encodeURIComponent(path)}/index-settings`);
+    }
+    async setIndexSettings(params) {
+        return this.request('PUT', `/folders/${encodeURIComponent(params.path)}/index-settings`, {
+            indexFields: params.indexFields,
+        });
+    }
+}
+//# sourceMappingURL=kadoc-client.js.map

package/dist/client/kadoc-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kadoc-client.js","sourceRoot":"","sources":["../../src/client/kadoc-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AACjC,OAAO,EAAU,eAAe,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,eAAe,EACf,eAAe,EACf,OAAO,EACP,WAAW,EACX,aAAa,GAEd,MAAM,uBAAuB,CAAC;AAmC/B,MAAM,OAAO,WAAW;IACd,MAAM,CAAS;IACf,QAAQ,GAA6B,IAAI,GAAG,EAAE,CAAC,CAAC,wBAAwB;IAEhF,YAAY,MAAc;QACxB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,OAAO,CACX,MAAyC,EACzC,IAAY,EACZ,IAAc,EACd,UAAmB;QAEnB,MAAM,YAAY,GAAG,eAAe,CAAC,IAAI,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;QAC9D,MAAM,SAAS,GAAG,UAAU,IAAI,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC;QAE1D,MAAM,GAAG,GAAG,GAAG,YAAY,CAAC,GAAG,GAAG,IAAI,EAAE,CAAC;QACzC,MAAM,OAAO,GAA2B;YACtC,YAAY,EAAE,YAAY,CAAC,IAAI,CAAC,OAAO;SACxC,CAAC;QAEF,+CAA+C;QAC/C,IAAI,IAAI,IAAI,CAAC,MAAM,KAAK,KAAK,IAAI,MAAM,KAAK,QAAQ,CAAC,EAAE,CAAC;YACtD,OAAO,CAAC,cAAc,CAAC,GAAG,kBAAkB,CAAC;QAC/C,CAAC;QAED,2BAA2B;QAC3B,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC7C,IAAI,WAAW,GAAY,IAAI,CAAC;QAEhC,IAAI,OAAO,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;YAC9C,OAAO,CAAC,cAAc,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC;YAE5C,kCAAkC;YAClC,IAAI,IAAI,EAAE,CAAC;gBACT,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;gBACtD,MAAM,KAAK,GAAG,aAAa,EAAE,CAAC;gBAC9B,WAAW,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;YACrC,CAAC;QACH,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,GAAG,EAAE;YAClC,MAAM;YACN,OAAO;YACP,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,SAAS;SAC5D,CAAC,CAAC;QAEH,kCAAkC;QAClC,IAAI,QAAQ,CAAC,UAAU,KAAK,GAAG,EAAE,CAAC;YAChC,OAAO,EAAO,CAAC;QACjB,CAAC;QAED,gDAAgD;QAChD,MAAM,YAAY,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QAChD,IAAI,YAAqB,CAAC;QAE1B,IAAI,CAAC;YACH,YAAY,GAAG,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9D,CAAC;QAAC,MAAM,CAAC;YACP,4EAA4E;YAC5E,IAAI,QAAQ,CAAC,UAAU,IAAI,GAAG,EAAE,CAAC;gBAC/B,MAAM,IAAI,KAAK,CAAC,QAAQ,QAAQ,CAAC,UAAU,KAAK,YAAY,EAAE,CAAC,CAAC;YAClE,CAAC;YACD,OAAO,EAAO,CAAC;QACjB,CAAC;QAED,IAAI,QAAQ,CAAC,UAAU,IAAI,GAAG,EAAE,CAAC;YAC/B,MAAM,KAAK,GAAG,YAAwB,CAAC;YACvC,MAAM,IAAI,KAAK,CAAC,IAAI,KAAK,CAAC,KAAK,EAAE,IAAI,IAAI,OAAO,KAAK,KAAK,CAAC,KAAK,EAAE,OAAO,IAAI,eAAe,EAAE,CAAC,CAAC;QAClG,CAAC;QAED,gCAAgC;QAChC,IAAI,OAAO,IAAK,YAAkC,CAAC,SAAS,EAAE,CAAC;YAC7D,MAAM,iBAAiB,GAAG,YAAiC,CAAC;YAC5D,MAAM,SAAS,GAAG,WAAW,CAAI,iBAAiB,CAAC,SAAS,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;YACpF,IAAI,CAAC,SAAS,EAAE,CAAC;gBACf,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;YAChD,CAAC;YACD,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,OAAO,YAAiB,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,SAAS,CAAC,UAAmB;QACjC,MAAM,YAAY,GAAG,eAAe,CAAC,IAAI,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;QAC9D,MAAM,SAAS,GAAG,UAAU,IAAI,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC;QAE1D,8BAA8B;QAC9B,MAAM,aAAa,GAAG,eAAe,EAAE,CAAC;QAExC,MAAM,GAAG,GAAG,GAAG,YAAY,CAAC,GAAG,iBAAiB,CAAC;QACjD,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,GAAG,EAAE;YAClC,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;gBAClC,YAAY,EAAE,YAAY,CAAC,IAAI,CAAC,OAAO;aACxC;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACnB,eAAe,EAAE,eAAe,CAAC,aAAa,CAAC,SAAS,CAAC;aAC1D,CAAC;SACH,CAAC,CAAC;QAEH,MAAM,YAAY,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QAEhD,IAAI,QAAQ,CAAC,UAAU,IAAI,GAAG,EAAE,CAAC;YAC/B,MAAM,KAAK,GAAG,YAAwB,CAAC;YACvC,MAAM,IAAI,KAAK,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QAClE,CAAC;QAED,MAAM,iBAAiB,GAAG,YAAiC,CAAC;QAE5D,wBAAwB;QACxB,MAAM,eAAe,GAAG,eAAe,CAAC,iBAAiB,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAChF,MAAM,YAAY,GAAG,mBAAmB,CAAC,aAAa,CAAC,SAAS,EAAE,eAAe,CAAC,CAAC;QAEnF,gBAAgB;QAChB,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,EAAE;YAC3B,SAAS,EAAE,iBAAiB,CAAC,IAAI,CAAC,SAAS;YAC3C,YAAY;YACZ,SAAS,EAAE,iBAAiB,CAAC,IAAI,CAAC,SAAS;SAC5C,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU,CAAC,UAAmB;QAClC,MAAM,YAAY,GAAG,eAAe,CAAC,IAAI,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;QAC9D,MAAM,SAAS,GAAG,UAAU,IAAI,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC;QAE1D,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC7C,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO;QACT,CAAC;QAED,MAAM,GAAG,GAAG,GAAG,YAAY,CAAC,GAAG,eAAe,CAAC;QAC/C,MAAM,OAAO,CAAC,GAAG,EAAE;YACjB,MAAM,EAAE,QAAQ;YAChB,OAAO,EAAE;gBACP,cAAc,EAAE,OAAO,CAAC,SAAS;aAClC;SACF,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAClC,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,UAAmB;QAC5B,MAAM,SAAS,GAAG,UAAU,IAAI,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC;QAC1D,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC7C,OAAO,CAAC,CAAC,OAAO,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,SAAS,CAAC;IACrD,CAAC;IAED,sBAAsB;IACtB,KAAK,CAAC,cAAc,CAAC,MAKpB;QACC,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,YAAY,EAAE;YACxC,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,QAAQ,EAAE,MAAM,CAAC,QAAQ;SAC1B,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,IAAY;QAC7B,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,cAAc,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACvE,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,MAKpB;QACC,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,cAAc,kBAAkB,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE;YAC1E,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,QAAQ,EAAE,MAAM,CAAC,QAAQ;SAC1B,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,IAAY;QAC/B,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,cAAc,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC1E,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,MAA4D;QAC9E,MAAM,YAAY,GAAG,IAAI,eAAe,EAAE,CAAC;QAC3C,IAAI,MAAM,CAAC,MAAM;YAAE,YAAY,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;QAC7D,IAAI,MAAM,CAAC,MAAM;YAAE,YAAY,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;QAC7D,IAAI,MAAM,CAAC,KAAK;YAAE,YAAY,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QAElE,MAAM,KAAK,GAAG,YAAY,CAAC,QAAQ,EAAE,CAAC;QACtC,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,aAAa,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACtE,CAAC;IAED,SAAS;IACT,KAAK,CAAC,MAAM,CAAC,MAA0D;QACrE,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,SAAS,EAAE;YACrC,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,KAAK,EAAE,MAAM,CAAC,KAAK;SACpB,CAAC,CAAC;IACL,CAAC;IAED,oBAAoB;IACpB,KAAK,CAAC,YAAY,CAAC,MAAwB;QACzC,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;IACjE,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,MAA2C;QAC3D,MAAM,YAAY,GAAG,IAAI,eAAe,EAAE,CAAC;QAC3C,IAAI,MAAM,CAAC,MAAM;YAAE,YAAY,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;QAC7D,IAAI,MAAM,CAAC,KAAK;YAAE,YAAY,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QAElE,MAAM,KAAK,GAAG,YAAY,CAAC,QAAQ,EAAE,CAAC;QACtC,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,WAAW,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACpE,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,IAAY;QAC7B,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,YAAY,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACxE,CAAC;IAED,KAAK,CAAC,gBAAgB,CAAC,IAAY;QACjC,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,YAAY,kBAAkB,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IACpF,CAAC;IAED,KAAK,CAAC,gBAAgB,CAAC,MAAgD;QACrE,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,YAAY,kBAAkB,CAAC,MAAM,CAAC,IAAI,CAAC,iBAAiB,EAAE;YACvF,WAAW,EAAE,MAAM,CAAC,WAAW;SAChC,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/config.d.ts

@@ -0,0 +1,82 @@
+import { z } from 'zod';
+declare const serverAuthSchema: z.ZodObject<{
+    authKey: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    authKey: string;
+}, {
+    authKey: string;
+}>;
+declare const serverConfigSchema: z.ZodObject<{
+    url: z.ZodString;
+    auth: z.ZodObject<{
+        authKey: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        authKey: string;
+    }, {
+        authKey: string;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    url: string;
+    auth: {
+        authKey: string;
+    };
+}, {
+    url: string;
+    auth: {
+        authKey: string;
+    };
+}>;
+declare const configSchema: z.ZodObject<{
+    servers: z.ZodRecord<z.ZodString, z.ZodObject<{
+        url: z.ZodString;
+        auth: z.ZodObject<{
+            authKey: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            authKey: string;
+        }, {
+            authKey: string;
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        url: string;
+        auth: {
+            authKey: string;
+        };
+    }, {
+        url: string;
+        auth: {
+            authKey: string;
+        };
+    }>>;
+    defaultServer: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    servers: Record<string, {
+        url: string;
+        auth: {
+            authKey: string;
+        };
+    }>;
+    defaultServer: string;
+}, {
+    servers: Record<string, {
+        url: string;
+        auth: {
+            authKey: string;
+        };
+    }>;
+    defaultServer: string;
+}>;
+export type ServerAuth = z.infer<typeof serverAuthSchema>;
+export type ServerConfig = z.infer<typeof serverConfigSchema>;
+export type Config = z.infer<typeof configSchema>;
+/**
+ * Load configuration, auto-registering if auth is missing
+ */
+export declare function loadConfigAsync(configPath?: string): Promise<Config>;
+/**
+ * Synchronous config load (for backward compatibility, throws if auth missing)
+ */
+export declare function loadConfig(configPath?: string): Config;
+export declare function getServerConfig(config: Config, serverName?: string): ServerConfig;
+export declare function getConfigPath(): string;
+export {};
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,QAAA,MAAM,gBAAgB;;;;;;EAEpB,CAAC;AAEH,QAAA,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;EAGtB,CAAC;AAEH,QAAA,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAGhB,CAAC;AAaH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAC1D,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAC9D,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAiDlD;;GAEG;AACH,wBAAsB,eAAe,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CA+E1E;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CA6BtD;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,YAAY,CASjF;AAED,wBAAgB,aAAa,IAAI,MAAM,CAEtC"}