proxy-api-mcp 1.0.0

package/dist/src/core/registry.js

@@ -0,0 +1,126 @@
+/**
+ * 工具注册器
+ */
+import { ToolRegistrationError } from '../utils/errors.js';
+import { SchemaValidator } from '../tools/validator.js';
+import { logger } from '../utils/logger.js';
+/**
+ * 工具注册器类
+ */
+export class ToolRegistry {
+    tools = new Map();
+    /**
+     * 注册单个工具
+     */
+    register(config) {
+        // 验证工具配置
+        this.validateToolConfig(config);
+        // 检查工具名称唯一性
+        if (this.tools.has(config.name)) {
+            throw new ToolRegistrationError(`Tool already registered: ${config.name}`, { toolName: config.name });
+        }
+        // 验证 inputSchema
+        if (!SchemaValidator.isValidSchema(config.inputSchema)) {
+            throw new ToolRegistrationError(`Invalid input schema for tool: ${config.name}`, { toolName: config.name, schema: config.inputSchema });
+        }
+        // 验证 outputSchema (如果存在)
+        if (config.outputSchema && !SchemaValidator.isValidSchema(config.outputSchema)) {
+            throw new ToolRegistrationError(`Invalid output schema for tool: ${config.name}`, { toolName: config.name, schema: config.outputSchema });
+        }
+        // 注册工具
+        this.tools.set(config.name, config);
+        logger.info(`Tool registered: ${config.name}`, {
+            title: config.title,
+            hasOutputSchema: !!config.outputSchema,
+        });
+    }
+    /**
+     * 批量注册工具
+     */
+    registerBatch(configs) {
+        for (const config of configs) {
+            this.register(config);
+        }
+    }
+    /**
+     * 获取工具配置
+     */
+    get(name) {
+        return this.tools.get(name);
+    }
+    /**
+     * 检查工具是否存在
+     */
+    has(name) {
+        return this.tools.has(name);
+    }
+    /**
+     * 获取所有工具名称
+     */
+    getToolNames() {
+        return Array.from(this.tools.keys());
+    }
+    /**
+     * 获取所有工具配置
+     */
+    getAll() {
+        return Array.from(this.tools.values());
+    }
+    /**
+     * 注销工具
+     */
+    unregister(name) {
+        const result = this.tools.delete(name);
+        if (result) {
+            logger.info(`Tool unregistered: ${name}`);
+        }
+        return result;
+    }
+    /**
+     * 清空所有工具
+     */
+    clear() {
+        const count = this.tools.size;
+        this.tools.clear();
+        logger.info(`All tools cleared (${count} tools)`);
+    }
+    /**
+     * 获取工具数量
+     */
+    count() {
+        return this.tools.size;
+    }
+    /**
+     * 验证工具配置的完整性
+     */
+    validateToolConfig(config) {
+        // 验证必填字段
+        if (!config.name || typeof config.name !== 'string') {
+            throw new ToolRegistrationError('Tool name is required and must be a string');
+        }
+        if (!config.description || typeof config.description !== 'string') {
+            throw new ToolRegistrationError(`Tool description is required: ${config.name}`);
+        }
+        if (!config.inputSchema || typeof config.inputSchema !== 'object') {
+            throw new ToolRegistrationError(`Tool inputSchema is required: ${config.name}`);
+        }
+        if (!config.handler || typeof config.handler !== 'function') {
+            throw new ToolRegistrationError(`Tool handler is required and must be a function: ${config.name}`);
+        }
+        // 验证名称格式(小写字母、数字和下划线)
+        if (!/^[a-z0-9_]+$/.test(config.name)) {
+            throw new ToolRegistrationError(`Invalid tool name format: ${config.name}. Use only lowercase letters, numbers, and underscores.`);
+        }
+    }
+    /**
+     * 转换为 MCP 工具列表格式
+     */
+    toMcpTools() {
+        return this.getAll().map(tool => ({
+            name: tool.name,
+            description: tool.description,
+            inputSchema: tool.inputSchema,
+        }));
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/src/core/registry.js.map

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

package/dist/src/core/router.d.ts

@@ -0,0 +1,34 @@
+/**
+ * 工具路由器
+ */
+import { type ToolRegistry } from './registry.js';
+import { type ToolContext, type ToolResult, type Middleware } from '../tools/types.js';
+/**
+ * 工具路由器类
+ */
+export declare class ToolRouter {
+    private registry;
+    private middlewares;
+    constructor(registry: ToolRegistry);
+    /**
+     * 添加中间件
+     */
+    use(middleware: Middleware): void;
+    /**
+     * 调用工具
+     */
+    callTool(toolName: string, args: Record<string, unknown>, context: ToolContext): Promise<ToolResult>;
+    /**
+     * 应用中间件链
+     */
+    private applyMiddlewares;
+    /**
+     * 批量调用工具(并行)
+     */
+    callToolsBatch(calls: {
+        toolName: string;
+        args: Record<string, unknown>;
+        context: ToolContext;
+    }[]): Promise<ToolResult[]>;
+}
+//# sourceMappingURL=router.d.ts.map

package/dist/src/core/router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../../../src/core/router.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,KAAK,WAAW,EAAE,KAAK,UAAU,EAAE,KAAK,UAAU,EAAE,MAAM,mBAAmB,CAAC;AASvF;;GAEG;AACH,qBAAa,UAAU;IAGT,OAAO,CAAC,QAAQ;IAF5B,OAAO,CAAC,WAAW,CAAoB;gBAEnB,QAAQ,EAAE,YAAY;IAE1C;;OAEG;IACH,GAAG,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI;IAKjC;;OAEG;IACG,QAAQ,CACZ,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,CAAC;IA0EtB;;OAEG;YACW,gBAAgB;IAsB9B;;OAEG;IACG,cAAc,CAClB,KAAK,EAAE;QACL,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC9B,OAAO,EAAE,WAAW,CAAC;KACtB,EAAE,GACF,OAAO,CAAC,UAAU,EAAE,CAAC;CAOzB"}

package/dist/src/core/router.js

@@ -0,0 +1,108 @@
+/**
+ * 工具路由器
+ */
+import { SchemaValidator } from '../tools/validator.js';
+import { ToolNotFoundError, ToolExecutionError, toMcpError, } from '../utils/errors.js';
+import { logger } from '../utils/logger.js';
+/**
+ * 工具路由器类
+ */
+export class ToolRouter {
+    registry;
+    middlewares = [];
+    constructor(registry) {
+        this.registry = registry;
+    }
+    /**
+     * 添加中间件
+     */
+    use(middleware) {
+        this.middlewares.push(middleware);
+        logger.debug('Middleware added', { count: this.middlewares.length });
+    }
+    /**
+     * 调用工具
+     */
+    async callTool(toolName, args, context) {
+        const startTime = Date.now();
+        try {
+            // 查找工具配置
+            const toolConfig = this.registry.get(toolName);
+            if (!toolConfig) {
+                throw new ToolNotFoundError(toolName);
+            }
+            logger.debug(`Calling tool: ${toolName}`, { args, context });
+            // 验证输入参数
+            const validatedArgs = SchemaValidator.validateInput(args, toolConfig.inputSchema);
+            // 创建执行函数
+            const execute = async () => {
+                try {
+                    // 调用工具处理器
+                    const result = await toolConfig.handler(validatedArgs, context);
+                    // 验证输出结果(如果有 outputSchema)
+                    if (toolConfig.outputSchema && result.structuredContent) {
+                        SchemaValidator.validateOutput(result.structuredContent, toolConfig.outputSchema);
+                    }
+                    return result;
+                }
+                catch (error) {
+                    if (error instanceof Error) {
+                        throw new ToolExecutionError(toolName, error);
+                    }
+                    throw error;
+                }
+            };
+            // 应用中间件
+            const result = await this.applyMiddlewares(context, execute);
+            const duration = Date.now() - startTime;
+            logger.info(`Tool executed: ${toolName}`, {
+                duration,
+                success: !result.isError,
+            });
+            return result;
+        }
+        catch (error) {
+            const duration = Date.now() - startTime;
+            const mcpError = toMcpError(error);
+            logger.error(`Tool execution failed: ${toolName}`, {
+                duration,
+                error: mcpError.message,
+                code: mcpError.code,
+            });
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: mcpError.message,
+                    },
+                ],
+                structuredContent: mcpError.toJSON(),
+                isError: true,
+            };
+        }
+    }
+    /**
+     * 应用中间件链
+     */
+    async applyMiddlewares(context, finalHandler) {
+        if (this.middlewares.length === 0) {
+            return finalHandler();
+        }
+        let index = 0;
+        const next = async () => {
+            if (index >= this.middlewares.length) {
+                return finalHandler();
+            }
+            const middleware = this.middlewares[index++];
+            return middleware(context, next);
+        };
+        return next();
+    }
+    /**
+     * 批量调用工具(并行)
+     */
+    async callToolsBatch(calls) {
+        return Promise.all(calls.map(({ toolName, args, context }) => this.callTool(toolName, args, context)));
+    }
+}
+//# sourceMappingURL=router.js.map

package/dist/src/core/router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.js","sourceRoot":"","sources":["../../../src/core/router.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,UAAU,GACX,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C;;GAEG;AACH,MAAM,OAAO,UAAU;IAGD;IAFZ,WAAW,GAAiB,EAAE,CAAC;IAEvC,YAAoB,QAAsB;QAAtB,aAAQ,GAAR,QAAQ,CAAc;IAAG,CAAC;IAE9C;;OAEG;IACH,GAAG,CAAC,UAAsB;QACxB,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAClC,MAAM,CAAC,KAAK,CAAC,kBAAkB,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC;IACvE,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,QAAQ,CACZ,QAAgB,EAChB,IAA6B,EAC7B,OAAoB;QAEpB,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAE7B,IAAI,CAAC;YACH,SAAS;YACT,MAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YAC/C,IAAI,CAAC,UAAU,EAAE,CAAC;gBAChB,MAAM,IAAI,iBAAiB,CAAC,QAAQ,CAAC,CAAC;YACxC,CAAC;YAED,MAAM,CAAC,KAAK,CAAC,iBAAiB,QAAQ,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;YAE7D,SAAS;YACT,MAAM,aAAa,GAAG,eAAe,CAAC,aAAa,CACjD,IAAI,EACJ,UAAU,CAAC,WAAW,CACvB,CAAC;YAEF,SAAS;YACT,MAAM,OAAO,GAAG,KAAK,IAAyB,EAAE;gBAC9C,IAAI,CAAC;oBACH,UAAU;oBACV,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,OAAO,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;oBAEhE,2BAA2B;oBAC3B,IAAI,UAAU,CAAC,YAAY,IAAI,MAAM,CAAC,iBAAiB,EAAE,CAAC;wBACxD,eAAe,CAAC,cAAc,CAC5B,MAAM,CAAC,iBAAiB,EACxB,UAAU,CAAC,YAAY,CACxB,CAAC;oBACJ,CAAC;oBAED,OAAO,MAAM,CAAC;gBAChB,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;wBAC3B,MAAM,IAAI,kBAAkB,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;oBAChD,CAAC;oBACD,MAAM,KAAK,CAAC;gBACd,CAAC;YACH,CAAC,CAAC;YAEF,QAAQ;YACR,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAE7D,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;YACxC,MAAM,CAAC,IAAI,CAAC,kBAAkB,QAAQ,EAAE,EAAE;gBACxC,QAAQ;gBACR,OAAO,EAAE,CAAC,MAAM,CAAC,OAAO;aACzB,CAAC,CAAC;YAEH,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;YACxC,MAAM,QAAQ,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;YAEnC,MAAM,CAAC,KAAK,CAAC,0BAA0B,QAAQ,EAAE,EAAE;gBACjD,QAAQ;gBACR,KAAK,EAAE,QAAQ,CAAC,OAAO;gBACvB,IAAI,EAAE,QAAQ,CAAC,IAAI;aACpB,CAAC,CAAC;YAEH,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,QAAQ,CAAC,OAAO;qBACvB;iBACF;gBACD,iBAAiB,EAAE,QAAQ,CAAC,MAAM,EAAE;gBACpC,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,gBAAgB,CAC5B,OAAoB,EACpB,YAAuC;QAEvC,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAClC,OAAO,YAAY,EAAE,CAAC;QACxB,CAAC;QAED,IAAI,KAAK,GAAG,CAAC,CAAC;QAEd,MAAM,IAAI,GAAG,KAAK,IAAyB,EAAE;YAC3C,IAAI,KAAK,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,CAAC;gBACrC,OAAO,YAAY,EAAE,CAAC;YACxB,CAAC;YAED,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC,CAAC;YAC7C,OAAO,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QACnC,CAAC,CAAC;QAEF,OAAO,IAAI,EAAE,CAAC;IAChB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,cAAc,CAClB,KAIG;QAEH,OAAO,OAAO,CAAC,GAAG,CAChB,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,CACxC,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,CAAC,CACvC,CACF,CAAC;IACJ,CAAC;CACF"}

package/dist/src/core/server.d.ts

@@ -0,0 +1,55 @@
+/**
+ * MCP Server 封装
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { ToolRegistry } from './registry.js';
+import { ToolRouter } from './router.js';
+import { SessionManager } from './session.js';
+import { type ServerConfig, type ToolConfig } from '../tools/types.js';
+/**
+ * MCP 服务器封装类
+ */
+export declare class McpServer {
+    private server;
+    private registry;
+    private router;
+    private sessionManager;
+    constructor(config: ServerConfig);
+    /**
+     * 注册工具
+     */
+    registerTool(config: ToolConfig): void;
+    /**
+     * 批量注册工具
+     */
+    registerTools(configs: ToolConfig[]): void;
+    /**
+     * 获取工具注册器
+     */
+    getRegistry(): ToolRegistry;
+    /**
+     * 获取工具路由器
+     */
+    getRouter(): ToolRouter;
+    /**
+     * 获取会话管理器
+     */
+    getSessionManager(): SessionManager;
+    /**
+     * 获取底层 MCP Server 实例
+     */
+    getServer(): Server;
+    /**
+     * 设置 MCP Server 处理器
+     */
+    private setupHandlers;
+    /**
+     * 启动会话清理
+     */
+    startSessionCleanup(interval?: number): void;
+    /**
+     * 关闭服务器
+     */
+    close(): Promise<void>;
+}
+//# sourceMappingURL=server.d.ts.map

package/dist/src/core/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../src/core/server.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAEnE,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,KAAK,YAAY,EAAE,KAAK,UAAU,EAAoB,MAAM,mBAAmB,CAAC;AAIzF;;GAEG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAe;IAC/B,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,cAAc,CAAiB;gBAE3B,MAAM,EAAE,YAAY;IAiChC;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI;IAItC;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,IAAI;IAI1C;;OAEG;IACH,WAAW,IAAI,YAAY;IAI3B;;OAEG;IACH,SAAS,IAAI,UAAU;IAIvB;;OAEG;IACH,iBAAiB,IAAI,cAAc;IAInC;;OAEG;IACH,SAAS,IAAI,MAAM;IAInB;;OAEG;IACH,OAAO,CAAC,aAAa;IAwErB;;OAEG;IACH,mBAAmB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI;IAI5C;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAc7B"}

package/dist/src/core/server.js

@@ -0,0 +1,159 @@
+/**
+ * MCP Server 封装
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { CallToolRequestSchema, ListToolsRequestSchema } from '@modelcontextprotocol/sdk/types.js';
+import { ToolRegistry } from './registry.js';
+import { ToolRouter } from './router.js';
+import { SessionManager } from './session.js';
+import { logger } from '../utils/logger.js';
+import { toMcpError } from '../utils/errors.js';
+/**
+ * MCP 服务器封装类
+ */
+export class McpServer {
+    server;
+    registry;
+    router;
+    sessionManager;
+    constructor(config) {
+        // 初始化 MCP Server
+        this.server = new Server({
+            name: config.name,
+            version: config.version,
+        }, {
+            capabilities: {
+                tools: {},
+            },
+        });
+        // 初始化组件
+        this.registry = new ToolRegistry();
+        this.router = new ToolRouter(this.registry);
+        this.sessionManager = new SessionManager(config.sessionTimeout);
+        // 注册工具
+        if (config.tools) {
+            this.registerTools(config.tools);
+        }
+        // 设置 MCP Server 处理器
+        this.setupHandlers();
+        logger.info(`MCP Server initialized: ${config.name} v${config.version}`, {
+            toolCount: this.registry.count(),
+            transport: config.transport,
+        });
+    }
+    /**
+     * 注册工具
+     */
+    registerTool(config) {
+        this.registry.register(config);
+    }
+    /**
+     * 批量注册工具
+     */
+    registerTools(configs) {
+        this.registry.registerBatch(configs);
+    }
+    /**
+     * 获取工具注册器
+     */
+    getRegistry() {
+        return this.registry;
+    }
+    /**
+     * 获取工具路由器
+     */
+    getRouter() {
+        return this.router;
+    }
+    /**
+     * 获取会话管理器
+     */
+    getSessionManager() {
+        return this.sessionManager;
+    }
+    /**
+     * 获取底层 MCP Server 实例
+     */
+    getServer() {
+        return this.server;
+    }
+    /**
+     * 设置 MCP Server 处理器
+     */
+    setupHandlers() {
+        // 处理工具列表请求
+        this.server.setRequestHandler(ListToolsRequestSchema, () => {
+            logger.debug('Handling tools/list request');
+            return {
+                tools: this.registry.toMcpTools(),
+            };
+        });
+        // 处理工具调用请求
+        this.server.setRequestHandler(CallToolRequestSchema, async (request) => {
+            const { name, arguments: args } = request.params;
+            logger.debug(`Handling tools/call request: ${name}`);
+            // 创建工具执行上下文
+            const context = {
+                timestamp: Date.now(),
+                metadata: request.params._meta,
+            };
+            try {
+                // 调用工具
+                const result = await this.router.callTool(name, args || {}, context);
+                // 如果是错误结果,返回错误响应
+                if (result.isError && result.structuredContent) {
+                    const errorData = result.structuredContent;
+                    return {
+                        content: result.content,
+                        isError: true,
+                        _meta: {
+                            error: errorData,
+                        },
+                    };
+                }
+                return {
+                    content: result.content,
+                    ...(result.structuredContent && {
+                        _meta: { structuredContent: result.structuredContent },
+                    }),
+                };
+            }
+            catch (error) {
+                const mcpError = toMcpError(error);
+                logger.error('Tool call error', mcpError.toJSON());
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: mcpError.message,
+                        },
+                    ],
+                    isError: true,
+                    _meta: {
+                        error: mcpError.toJSON(),
+                    },
+                };
+            }
+        });
+    }
+    /**
+     * 启动会话清理
+     */
+    startSessionCleanup(interval) {
+        this.sessionManager.startCleanup(interval);
+    }
+    /**
+     * 关闭服务器
+     */
+    async close() {
+        logger.info('Closing MCP Server...');
+        // 停止会话清理
+        this.sessionManager.destroy();
+        // 清空工具注册
+        this.registry.clear();
+        // 关闭 MCP Server
+        await this.server.close();
+        logger.info('MCP Server closed');
+    }
+}
+//# sourceMappingURL=server.js.map

package/dist/src/core/server.js.map

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

package/dist/src/core/session.d.ts

@@ -0,0 +1,70 @@
+/**
+ * 会话管理器
+ */
+import { type Session } from '../tools/types.js';
+/**
+ * 会话管理器类
+ */
+export declare class SessionManager {
+    private sessions;
+    private cleanupInterval;
+    private sessionTimeout;
+    constructor(sessionTimeout?: number);
+    /**
+     * 启动会话清理定时器
+     */
+    startCleanup(interval?: number): void;
+    /**
+     * 停止会话清理定时器
+     */
+    stopCleanup(): void;
+    /**
+     * 创建新会话
+     */
+    create(sessionId: string, context?: Record<string, unknown>): Session;
+    /**
+     * 获取会话
+     */
+    get(sessionId: string): Session;
+    /**
+     * 更新会话活跃时间
+     */
+    touch(sessionId: string): void;
+    /**
+     * 更新会话上下文
+     */
+    updateContext(sessionId: string, context: Record<string, unknown>): void;
+    /**
+     * 检查会话是否存在
+     */
+    has(sessionId: string): boolean;
+    /**
+     * 检查会话是否过期
+     */
+    isExpired(session: Session): boolean;
+    /**
+     * 关闭会话
+     */
+    close(sessionId: string): boolean;
+    /**
+     * 清理过期会话
+     */
+    private cleanupExpiredSessions;
+    /**
+     * 获取所有活跃会话
+     */
+    getActiveSessions(): Session[];
+    /**
+     * 获取会话数量
+     */
+    count(): number;
+    /**
+     * 清空所有会话
+     */
+    clear(): void;
+    /**
+     * 销毁会话管理器
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=session.d.ts.map

package/dist/src/core/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../../src/core/session.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,KAAK,OAAO,EAAiB,MAAM,mBAAmB,CAAC;AAIhE;;GAEG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAA8B;IAC9C,OAAO,CAAC,eAAe,CAA+B;IACtD,OAAO,CAAC,cAAc,CAAS;gBAEnB,cAAc,SAAU;IAKpC;;OAEG;IACH,YAAY,CAAC,QAAQ,SAAQ,GAAG,IAAI;IAgBpC;;OAEG;IACH,WAAW,IAAI,IAAI;IAQnB;;OAEG;IACH,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,OAAO;IAmBzE;;OAEG;IACH,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAe/B;;OAEG;IACH,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAQ9B;;OAEG;IACH,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAMxE;;OAEG;IACH,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAI/B;;OAEG;IACH,SAAS,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO;IAKpC;;OAEG;IACH,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAejC;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAqB9B;;OAEG;IACH,iBAAiB,IAAI,OAAO,EAAE;IAM9B;;OAEG;IACH,KAAK,IAAI,MAAM;IAIf;;OAEG;IACH,KAAK,IAAI,IAAI;IAMb;;OAEG;IACH,OAAO,IAAI,IAAI;CAIhB"}