easy-mcp-nest 0.2.0 → 0.3.0

package/dist/decorators/mcp-context.decorator.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.McpContext = McpContext;
+exports.getContextParameterIndices = getContextParameterIndices;
+require("reflect-metadata");
+const MCP_CONTEXT_METADATA_KEY = Symbol("mcp:context");
+function McpContext() {
+    return (target, propertyKey, parameterIndex) => {
+        if (propertyKey === undefined) {
+            return;
+        }
+        const existingContextParams = Reflect.getMetadata(MCP_CONTEXT_METADATA_KEY, target, propertyKey) || [];
+        existingContextParams.push(parameterIndex);
+        Reflect.defineMetadata(MCP_CONTEXT_METADATA_KEY, existingContextParams, target, propertyKey);
+    };
+}
+function getContextParameterIndices(target, propertyKey) {
+    return Reflect.getMetadata(MCP_CONTEXT_METADATA_KEY, target, propertyKey) || [];
+}
+//# sourceMappingURL=mcp-context.decorator.js.map

package/dist/decorators/mcp-context.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-context.decorator.js","sourceRoot":"","sources":["../../src/decorators/mcp-context.decorator.ts"],"names":[],"mappings":";;AAqBA,gCAaC;AAMD,gEAKC;AA7CD,4BAA0B;AAK1B,MAAM,wBAAwB,GAAG,MAAM,CAAC,aAAa,CAAC,CAAC;AAgBvD,SAAgB,UAAU;IACxB,OAAO,CAAC,MAAW,EAAE,WAAwC,EAAE,cAAsB,EAAE,EAAE;QACvF,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;YAC9B,OAAO;QACT,CAAC;QAGD,MAAM,qBAAqB,GACzB,OAAO,CAAC,WAAW,CAAC,wBAAwB,EAAE,MAAM,EAAE,WAAW,CAAC,IAAI,EAAE,CAAC;QAE3E,qBAAqB,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAC3C,OAAO,CAAC,cAAc,CAAC,wBAAwB,EAAE,qBAAqB,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;IAC/F,CAAC,CAAC;AACJ,CAAC;AAMD,SAAgB,0BAA0B,CACxC,MAAW,EACX,WAA4B;IAE5B,OAAO,OAAO,CAAC,WAAW,CAAC,wBAAwB,EAAE,MAAM,EAAE,WAAW,CAAC,IAAI,EAAE,CAAC;AAClF,CAAC"}

package/dist/decorators/mcp-param.decorator.d.ts

@@ -0,0 +1,10 @@
+import "reflect-metadata";
+import { z } from "zod";
+export declare function McpParam<T extends z.ZodTypeAny>(schema: T): ParameterDecorator;
+export declare function getParamSchema(target: any, propertyKey: string | symbol, parameterIndex: number): z.ZodTypeAny | undefined;
+export declare function getAllParamSchemas(target: any, propertyKey: string | symbol): Map<number, z.ZodTypeAny>;
+export declare function getParamSchemasAsJsonSchema(target: any, propertyKey: string | symbol): {
+    type: "object";
+    properties?: Record<string, any>;
+    required?: string[];
+} | null;

package/dist/decorators/mcp-param.decorator.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.McpParam = McpParam;
+exports.getParamSchema = getParamSchema;
+exports.getAllParamSchemas = getAllParamSchemas;
+exports.getParamSchemasAsJsonSchema = getParamSchemasAsJsonSchema;
+require("reflect-metadata");
+const zod_integration_1 = require("../validation/zod-integration");
+const MCP_PARAM_SCHEMA_METADATA_KEY = Symbol("mcp:param:schema");
+const MCP_PARAM_INDEX_METADATA_KEY = Symbol("mcp:param:index");
+function McpParam(schema) {
+    return (target, propertyKey, parameterIndex) => {
+        if (propertyKey === undefined) {
+            return;
+        }
+        const existingSchemas = Reflect.getMetadata(MCP_PARAM_SCHEMA_METADATA_KEY, target, propertyKey) || new Map();
+        existingSchemas.set(parameterIndex, schema);
+        Reflect.defineMetadata(MCP_PARAM_SCHEMA_METADATA_KEY, existingSchemas, target, propertyKey);
+        const existingIndices = Reflect.getMetadata(MCP_PARAM_INDEX_METADATA_KEY, target, propertyKey) || [];
+        if (!existingIndices.includes(parameterIndex)) {
+            existingIndices.push(parameterIndex);
+            Reflect.defineMetadata(MCP_PARAM_INDEX_METADATA_KEY, existingIndices, target, propertyKey);
+        }
+    };
+}
+function getParamSchema(target, propertyKey, parameterIndex) {
+    const schemas = Reflect.getMetadata(MCP_PARAM_SCHEMA_METADATA_KEY, target, propertyKey) || new Map();
+    return schemas.get(parameterIndex);
+}
+function getAllParamSchemas(target, propertyKey) {
+    return Reflect.getMetadata(MCP_PARAM_SCHEMA_METADATA_KEY, target, propertyKey) || new Map();
+}
+function getParamSchemasAsJsonSchema(target, propertyKey) {
+    const schemas = getAllParamSchemas(target, propertyKey);
+    const paramsSchema = schemas.get(0);
+    if (!paramsSchema) {
+        return null;
+    }
+    return (0, zod_integration_1.zodToJsonSchema)(paramsSchema);
+}
+//# sourceMappingURL=mcp-param.decorator.js.map

package/dist/decorators/mcp-param.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-param.decorator.js","sourceRoot":"","sources":["../../src/decorators/mcp-param.decorator.ts"],"names":[],"mappings":";;AA+BA,4BAsBC;AAMD,wCAQC;AAMD,gDAKC;AAMD,kEAgBC;AApGD,4BAA0B;AAE1B,mEAAgE;AAKhE,MAAM,6BAA6B,GAAG,MAAM,CAAC,kBAAkB,CAAC,CAAC;AACjE,MAAM,4BAA4B,GAAG,MAAM,CAAC,iBAAiB,CAAC,CAAC;AAuB/D,SAAgB,QAAQ,CAAyB,MAAS;IACxD,OAAO,CAAC,MAAW,EAAE,WAAwC,EAAE,cAAsB,EAAE,EAAE;QACvF,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;YAC9B,OAAO;QACT,CAAC;QAGD,MAAM,eAAe,GACnB,OAAO,CAAC,WAAW,CAAC,6BAA6B,EAAE,MAAM,EAAE,WAAW,CAAC,IAAI,IAAI,GAAG,EAAE,CAAC;QAEvF,eAAe,CAAC,GAAG,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;QAC5C,OAAO,CAAC,cAAc,CAAC,6BAA6B,EAAE,eAAe,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;QAG5F,MAAM,eAAe,GACnB,OAAO,CAAC,WAAW,CAAC,4BAA4B,EAAE,MAAM,EAAE,WAAW,CAAC,IAAI,EAAE,CAAC;QAE/E,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC;YAC9C,eAAe,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;YACrC,OAAO,CAAC,cAAc,CAAC,4BAA4B,EAAE,eAAe,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;QAC7F,CAAC;IACH,CAAC,CAAC;AACJ,CAAC;AAMD,SAAgB,cAAc,CAC5B,MAAW,EACX,WAA4B,EAC5B,cAAsB;IAEtB,MAAM,OAAO,GACX,OAAO,CAAC,WAAW,CAAC,6BAA6B,EAAE,MAAM,EAAE,WAAW,CAAC,IAAI,IAAI,GAAG,EAAE,CAAC;IACvF,OAAO,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;AACrC,CAAC;AAMD,SAAgB,kBAAkB,CAChC,MAAW,EACX,WAA4B;IAE5B,OAAO,OAAO,CAAC,WAAW,CAAC,6BAA6B,EAAE,MAAM,EAAE,WAAW,CAAC,IAAI,IAAI,GAAG,EAAE,CAAC;AAC9F,CAAC;AAMD,SAAgB,2BAA2B,CACzC,MAAW,EACX,WAA4B;IAE5B,MAAM,OAAO,GAAG,kBAAkB,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAIxD,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAEpC,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,OAAO,IAAI,CAAC;IACd,CAAC;IAGD,OAAO,IAAA,iCAAe,EAAC,YAAY,CAA8E,CAAC;AACpH,CAAC"}

package/dist/decorators/mcp-service.decorator.d.ts

@@ -0,0 +1,6 @@
+import "reflect-metadata";
+export declare function McpService<T = any>(factory: () => T): ParameterDecorator;
+export declare function getServiceFactories(target: any, propertyKey?: string | symbol): Array<{
+    index: number;
+    factory: () => any;
+}>;

package/dist/decorators/mcp-service.decorator.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.McpService = McpService;
+exports.getServiceFactories = getServiceFactories;
+require("reflect-metadata");
+const MCP_SERVICE_FACTORY_METADATA_KEY = Symbol("mcp:service:factory");
+function McpService(factory) {
+    return (target, propertyKey, parameterIndex) => {
+        if (propertyKey !== undefined) {
+            const existingFactories = Reflect.getMetadata(MCP_SERVICE_FACTORY_METADATA_KEY, target, propertyKey) || [];
+            existingFactories.push({ index: parameterIndex, factory });
+            Reflect.defineMetadata(MCP_SERVICE_FACTORY_METADATA_KEY, existingFactories, target, propertyKey);
+        }
+        else {
+            const existingFactories = Reflect.getMetadata(MCP_SERVICE_FACTORY_METADATA_KEY, target) || [];
+            existingFactories.push({ index: parameterIndex, factory });
+            Reflect.defineMetadata(MCP_SERVICE_FACTORY_METADATA_KEY, existingFactories, target);
+        }
+    };
+}
+function getServiceFactories(target, propertyKey) {
+    if (propertyKey !== undefined) {
+        return Reflect.getMetadata(MCP_SERVICE_FACTORY_METADATA_KEY, target, propertyKey) || [];
+    }
+    return Reflect.getMetadata(MCP_SERVICE_FACTORY_METADATA_KEY, target) || [];
+}
+//# sourceMappingURL=mcp-service.decorator.js.map

package/dist/decorators/mcp-service.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-service.decorator.js","sourceRoot":"","sources":["../../src/decorators/mcp-service.decorator.ts"],"names":[],"mappings":";;AAuBA,gCAkBC;AAMD,kDAQC;AAvDD,4BAA0B;AAK1B,MAAM,gCAAgC,GAAG,MAAM,CAAC,qBAAqB,CAAC,CAAC;AAkBvE,SAAgB,UAAU,CAAU,OAAgB;IAClD,OAAO,CAAC,MAAW,EAAE,WAAwC,EAAE,cAAsB,EAAE,EAAE;QACvF,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;YAE9B,MAAM,iBAAiB,GACrB,OAAO,CAAC,WAAW,CAAC,gCAAgC,EAAE,MAAM,EAAE,WAAW,CAAC,IAAI,EAAE,CAAC;YAEnF,iBAAiB,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,CAAC,CAAC;YAC3D,OAAO,CAAC,cAAc,CAAC,gCAAgC,EAAE,iBAAiB,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;QACnG,CAAC;aAAM,CAAC;YAEN,MAAM,iBAAiB,GACrB,OAAO,CAAC,WAAW,CAAC,gCAAgC,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;YAEtE,iBAAiB,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,CAAC,CAAC;YAC3D,OAAO,CAAC,cAAc,CAAC,gCAAgC,EAAE,iBAAiB,EAAE,MAAM,CAAC,CAAC;QACtF,CAAC;IACH,CAAC,CAAC;AACJ,CAAC;AAMD,SAAgB,mBAAmB,CACjC,MAAW,EACX,WAA6B;IAE7B,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;QAC9B,OAAO,OAAO,CAAC,WAAW,CAAC,gCAAgC,EAAE,MAAM,EAAE,WAAW,CAAC,IAAI,EAAE,CAAC;IAC1F,CAAC;IACD,OAAO,OAAO,CAAC,WAAW,CAAC,gCAAgC,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;AAC7E,CAAC"}

package/dist/index.d.ts

@@ -7,5 +7,17 @@ export type { InitializeParams, InitializeResult, ListToolsResult, McpTool, Call
 export { McpErrorCode } from './interface/mcp-protocol.interface';
 export type { ToolDefinition, ToolParameter, ToolFunction, } from './tooling/tool.interface';
 export { EasyMcpError, ConfigurationError, ToolExecutionError, ToolNotFoundError, } from './core/errors/easy-mcp-error';
+export { ToolNamingValidator } from './core/utils/tool-naming-validator';
 export { INTERFACE_LAYER_TOKEN } from './config/constants';
 export { VERSION, PACKAGE_NAME, getVersion, getPackageName } from './config/version';
+export type { McpContext } from './core/context/mcp-context.interface';
+export { McpContext as McpContextDecorator, McpService, createFactoryProvider, McpParam } from './decorators';
+export { zodToJsonSchema, validateWithZod, safeValidateWithZod } from './validation';
+export { createMcpExpressRouter } from './adapters/express';
+export type { CreateMcpExpressRouterOptions, McpAuthMiddleware } from './adapters/express';
+export { OAuthProviderService, createOAuthMiddleware } from './auth/oauth';
+export type { OAuthProviderConfig, OAuthConfig, OAuthTokenValidator, OAuthContextExtractor } from './auth/oauth';
+export { createMcpServer, StandaloneMcpServer } from './standalone';
+export type { CreateMcpServerOptions, StandaloneTransport, StandaloneAuthFunction } from './standalone';
+export { createMcpTestApp, McpTestApp, mockMcpContext } from './testing';
+export { createMockJsonRpcRequest, createMockTool, wait, createMockCancellationToken } from './testing';

package/dist/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getPackageName = exports.getVersion = exports.PACKAGE_NAME = exports.VERSION = exports.INTERFACE_LAYER_TOKEN = exports.ToolNotFoundError = exports.ToolExecutionError = exports.ConfigurationError = exports.EasyMcpError = exports.McpErrorCode = exports.JsonRpcErrorCode = exports.EasyMCP = void 0;
+exports.createMockCancellationToken = exports.wait = exports.createMockTool = exports.createMockJsonRpcRequest = exports.mockMcpContext = exports.McpTestApp = exports.createMcpTestApp = exports.StandaloneMcpServer = exports.createMcpServer = exports.createOAuthMiddleware = exports.OAuthProviderService = exports.createMcpExpressRouter = exports.safeValidateWithZod = exports.validateWithZod = exports.zodToJsonSchema = exports.McpParam = exports.createFactoryProvider = exports.McpService = exports.McpContextDecorator = exports.getPackageName = exports.getVersion = exports.PACKAGE_NAME = exports.VERSION = exports.INTERFACE_LAYER_TOKEN = exports.ToolNamingValidator = exports.ToolNotFoundError = exports.ToolExecutionError = exports.ConfigurationError = exports.EasyMcpError = exports.McpErrorCode = exports.JsonRpcErrorCode = exports.EasyMCP = void 0;
 var EasyMCP_1 = require("./EasyMCP");
 Object.defineProperty(exports, "EasyMCP", { enumerable: true, get: function () { return EasyMCP_1.EasyMCP; } });
 var jsonrpc_interface_1 = require("./interface/jsonrpc.interface");
@@ -12,6 +12,8 @@ Object.defineProperty(exports, "EasyMcpError", { enumerable: true, get: function
 Object.defineProperty(exports, "ConfigurationError", { enumerable: true, get: function () { return easy_mcp_error_1.ConfigurationError; } });
 Object.defineProperty(exports, "ToolExecutionError", { enumerable: true, get: function () { return easy_mcp_error_1.ToolExecutionError; } });
 Object.defineProperty(exports, "ToolNotFoundError", { enumerable: true, get: function () { return easy_mcp_error_1.ToolNotFoundError; } });
+var tool_naming_validator_1 = require("./core/utils/tool-naming-validator");
+Object.defineProperty(exports, "ToolNamingValidator", { enumerable: true, get: function () { return tool_naming_validator_1.ToolNamingValidator; } });
 var constants_1 = require("./config/constants");
 Object.defineProperty(exports, "INTERFACE_LAYER_TOKEN", { enumerable: true, get: function () { return constants_1.INTERFACE_LAYER_TOKEN; } });
 var version_1 = require("./config/version");
@@ -19,4 +21,30 @@ Object.defineProperty(exports, "VERSION", { enumerable: true, get: function () {
 Object.defineProperty(exports, "PACKAGE_NAME", { enumerable: true, get: function () { return version_1.PACKAGE_NAME; } });
 Object.defineProperty(exports, "getVersion", { enumerable: true, get: function () { return version_1.getVersion; } });
 Object.defineProperty(exports, "getPackageName", { enumerable: true, get: function () { return version_1.getPackageName; } });
+var decorators_1 = require("./decorators");
+Object.defineProperty(exports, "McpContextDecorator", { enumerable: true, get: function () { return decorators_1.McpContext; } });
+Object.defineProperty(exports, "McpService", { enumerable: true, get: function () { return decorators_1.McpService; } });
+Object.defineProperty(exports, "createFactoryProvider", { enumerable: true, get: function () { return decorators_1.createFactoryProvider; } });
+Object.defineProperty(exports, "McpParam", { enumerable: true, get: function () { return decorators_1.McpParam; } });
+var validation_1 = require("./validation");
+Object.defineProperty(exports, "zodToJsonSchema", { enumerable: true, get: function () { return validation_1.zodToJsonSchema; } });
+Object.defineProperty(exports, "validateWithZod", { enumerable: true, get: function () { return validation_1.validateWithZod; } });
+Object.defineProperty(exports, "safeValidateWithZod", { enumerable: true, get: function () { return validation_1.safeValidateWithZod; } });
+var express_1 = require("./adapters/express");
+Object.defineProperty(exports, "createMcpExpressRouter", { enumerable: true, get: function () { return express_1.createMcpExpressRouter; } });
+var oauth_1 = require("./auth/oauth");
+Object.defineProperty(exports, "OAuthProviderService", { enumerable: true, get: function () { return oauth_1.OAuthProviderService; } });
+Object.defineProperty(exports, "createOAuthMiddleware", { enumerable: true, get: function () { return oauth_1.createOAuthMiddleware; } });
+var standalone_1 = require("./standalone");
+Object.defineProperty(exports, "createMcpServer", { enumerable: true, get: function () { return standalone_1.createMcpServer; } });
+Object.defineProperty(exports, "StandaloneMcpServer", { enumerable: true, get: function () { return standalone_1.StandaloneMcpServer; } });
+var testing_1 = require("./testing");
+Object.defineProperty(exports, "createMcpTestApp", { enumerable: true, get: function () { return testing_1.createMcpTestApp; } });
+Object.defineProperty(exports, "McpTestApp", { enumerable: true, get: function () { return testing_1.McpTestApp; } });
+Object.defineProperty(exports, "mockMcpContext", { enumerable: true, get: function () { return testing_1.mockMcpContext; } });
+var testing_2 = require("./testing");
+Object.defineProperty(exports, "createMockJsonRpcRequest", { enumerable: true, get: function () { return testing_2.createMockJsonRpcRequest; } });
+Object.defineProperty(exports, "createMockTool", { enumerable: true, get: function () { return testing_2.createMockTool; } });
+Object.defineProperty(exports, "wait", { enumerable: true, get: function () { return testing_2.wait; } });
+Object.defineProperty(exports, "createMockCancellationToken", { enumerable: true, get: function () { return testing_2.createMockCancellationToken; } });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AACA,qCAAoC;AAA3B,kGAAA,OAAO,OAAA;AAmBhB,mEAAiE;AAAxD,qHAAA,gBAAgB,OAAA;AAYzB,6EAAkE;AAAzD,sHAAA,YAAY,OAAA;AAUrB,+DAKsC;AAJpC,8GAAA,YAAY,OAAA;AACZ,oHAAA,kBAAkB,OAAA;AAClB,oHAAA,kBAAkB,OAAA;AAClB,mHAAA,iBAAiB,OAAA;AAInB,gDAA2D;AAAlD,kHAAA,qBAAqB,OAAA;AAG9B,4CAAqF;AAA5E,kGAAA,OAAO,OAAA;AAAE,uGAAA,YAAY,OAAA;AAAE,qGAAA,UAAU,OAAA;AAAE,yGAAA,cAAc,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AACA,qCAAoC;AAA3B,kGAAA,OAAO,OAAA;AAmBhB,mEAAiE;AAAxD,qHAAA,gBAAgB,OAAA;AAYzB,6EAAkE;AAAzD,sHAAA,YAAY,OAAA;AAUrB,+DAKsC;AAJpC,8GAAA,YAAY,OAAA;AACZ,oHAAA,kBAAkB,OAAA;AAClB,oHAAA,kBAAkB,OAAA;AAClB,mHAAA,iBAAiB,OAAA;AAInB,4EAAyE;AAAhE,4HAAA,mBAAmB,OAAA;AAG5B,gDAA2D;AAAlD,kHAAA,qBAAqB,OAAA;AAG9B,4CAAqF;AAA5E,kGAAA,OAAO,OAAA;AAAE,uGAAA,YAAY,OAAA;AAAE,qGAAA,UAAU,OAAA;AAAE,yGAAA,cAAc,OAAA;AAI1D,2CAA8G;AAArG,iHAAA,UAAU,OAAuB;AAAE,wGAAA,UAAU,OAAA;AAAE,mHAAA,qBAAqB,OAAA;AAAE,sGAAA,QAAQ,OAAA;AAGvF,2CAAqF;AAA5E,6GAAA,eAAe,OAAA;AAAE,6GAAA,eAAe,OAAA;AAAE,iHAAA,mBAAmB,OAAA;AAG9D,8CAA4D;AAAnD,iHAAA,sBAAsB,OAAA;AAI/B,sCAA2E;AAAlE,6GAAA,oBAAoB,OAAA;AAAE,8GAAA,qBAAqB,OAAA;AAIpD,2CAAoE;AAA3D,6GAAA,eAAe,OAAA;AAAE,iHAAA,mBAAmB,OAAA;AAI7C,qCAAyE;AAAhE,2GAAA,gBAAgB,OAAA;AAAE,qGAAA,UAAU,OAAA;AAAE,yGAAA,cAAc,OAAA;AACrD,qCAAwG;AAA/F,mHAAA,wBAAwB,OAAA;AAAE,yGAAA,cAAc,OAAA;AAAE,+FAAA,IAAI,OAAA;AAAE,sHAAA,2BAA2B,OAAA"}

package/dist/interface/jsonrpc.interface.d.ts

@@ -3,6 +3,14 @@ export interface JsonRpcRequest {
     id: string | number | null;
     method: string;
     params?: any;
+    metadata?: {
+        userId?: string;
+        scopes?: string[];
+        buildingIds?: string[];
+        sessionId?: string;
+        metadata?: Record<string, any>;
+        [key: string]: any;
+    };
 }
 export interface JsonRpcResponse {
     jsonrpc: "2.0";

package/dist/interface/jsonrpc.interface.js.map

@@ -1 +1 @@
-{"version":3,"file":"jsonrpc.interface.js","sourceRoot":"","sources":["../../src/interface/jsonrpc.interface.ts"],"names":[],"mappings":";;;AA2CA,sDAUC;AAKD,oDASC;AAKD,gDAeC;AAvDD,IAAY,gBAMX;AAND,WAAY,gBAAgB;IAC1B,wEAAmB,CAAA;IACnB,gFAAuB,CAAA;IACvB,gFAAuB,CAAA;IACvB,8EAAsB,CAAA;IACtB,8EAAsB,CAAA;AACxB,CAAC,EANW,gBAAgB,gCAAhB,gBAAgB,QAM3B;AAKD,SAAgB,qBAAqB,CAAC,GAAQ;IAC5C,OAAO,CACL,GAAG;QACH,OAAO,GAAG,KAAK,QAAQ;QACvB,GAAG,CAAC,OAAO,KAAK,KAAK;QACrB,OAAO,GAAG,CAAC,MAAM,KAAK,QAAQ;QAC9B,CAAC,GAAG,CAAC,EAAE,KAAK,IAAI;YACd,OAAO,GAAG,CAAC,EAAE,KAAK,QAAQ;YAC1B,OAAO,GAAG,CAAC,EAAE,KAAK,QAAQ,CAAC,CAC9B,CAAC;AACJ,CAAC;AAKD,SAAgB,oBAAoB,CAClC,EAA0B,EAC1B,MAAW;IAEX,OAAO;QACL,OAAO,EAAE,KAAK;QACd,EAAE;QACF,MAAM;KACP,CAAC;AACJ,CAAC;AAKD,SAAgB,kBAAkB,CAChC,EAA0B,EAC1B,IAAY,EACZ,OAAe,EACf,IAAU;IAEV,OAAO;QACL,OAAO,EAAE,KAAK;QACd,EAAE;QACF,KAAK,EAAE;YACL,IAAI;YACJ,OAAO;YACP,GAAG,CAAC,IAAI,KAAK,SAAS,IAAI,EAAE,IAAI,EAAE,CAAC;SACpC;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"jsonrpc.interface.js","sourceRoot":"","sources":["../../src/interface/jsonrpc.interface.ts"],"names":[],"mappings":";;;AAoDA,sDAUC;AAKD,oDASC;AAKD,gDAeC;AAvDD,IAAY,gBAMX;AAND,WAAY,gBAAgB;IAC1B,wEAAmB,CAAA;IACnB,gFAAuB,CAAA;IACvB,gFAAuB,CAAA;IACvB,8EAAsB,CAAA;IACtB,8EAAsB,CAAA;AACxB,CAAC,EANW,gBAAgB,gCAAhB,gBAAgB,QAM3B;AAKD,SAAgB,qBAAqB,CAAC,GAAQ;IAC5C,OAAO,CACL,GAAG;QACH,OAAO,GAAG,KAAK,QAAQ;QACvB,GAAG,CAAC,OAAO,KAAK,KAAK;QACrB,OAAO,GAAG,CAAC,MAAM,KAAK,QAAQ;QAC9B,CAAC,GAAG,CAAC,EAAE,KAAK,IAAI;YACd,OAAO,GAAG,CAAC,EAAE,KAAK,QAAQ;YAC1B,OAAO,GAAG,CAAC,EAAE,KAAK,QAAQ,CAAC,CAC9B,CAAC;AACJ,CAAC;AAKD,SAAgB,oBAAoB,CAClC,EAA0B,EAC1B,MAAW;IAEX,OAAO;QACL,OAAO,EAAE,KAAK;QACd,EAAE;QACF,MAAM;KACP,CAAC;AACJ,CAAC;AAKD,SAAgB,kBAAkB,CAChC,EAA0B,EAC1B,IAAY,EACZ,OAAe,EACf,IAAU;IAEV,OAAO;QACL,OAAO,EAAE,KAAK;QACd,EAAE;QACF,KAAK,EAAE;YACL,IAAI;YACJ,OAAO;YACP,GAAG,CAAC,IAAI,KAAK,SAAS,IAAI,EAAE,IAAI,EAAE,CAAC;SACpC;KACF,CAAC;AACJ,CAAC"}

package/dist/standalone/core-services.d.ts

@@ -0,0 +1,29 @@
+import { ToolDefinition, CancellationToken } from "../tooling/tool.interface";
+import { ToolRegistrationInput, ResourceRegistrationInput, PromptRegistrationInput } from "../config/mcp-config.interface";
+import { McpContext } from "../core/context/mcp-context.interface";
+export declare class StandaloneToolRegistry {
+    private readonly registry;
+    registerTool(toolInput: ToolRegistrationInput): void;
+    getTool(name: string): ToolDefinition | undefined;
+    executeTool(name: string, args: Record<string, any>, cancellationToken?: CancellationToken, context?: McpContext): Promise<any>;
+    getToolSchemasForLLM(): Array<{
+        type: "function";
+        function: {
+            name: string;
+            description: string;
+            parameters: any;
+        };
+    }>;
+}
+export declare class StandaloneResourceRegistry {
+    private readonly registry;
+    registerResource(resource: ResourceRegistrationInput): void;
+    getResource(uri: string): ResourceRegistrationInput | undefined;
+    getAllResources(): ResourceRegistrationInput[];
+}
+export declare class StandalonePromptRegistry {
+    private readonly registry;
+    registerPrompt(prompt: PromptRegistrationInput): void;
+    getPrompt(name: string): PromptRegistrationInput | undefined;
+    getAllPrompts(): PromptRegistrationInput[];
+}

package/dist/standalone/core-services.js

@@ -0,0 +1,94 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StandalonePromptRegistry = exports.StandaloneResourceRegistry = exports.StandaloneToolRegistry = void 0;
+const easy_mcp_error_1 = require("../core/errors/easy-mcp-error");
+const schema_validator_1 = require("../core/utils/schema-validator");
+const logger_util_1 = require("../core/utils/logger.util");
+class StandaloneToolRegistry {
+    registry = new Map();
+    registerTool(toolInput) {
+        if (this.registry.has(toolInput.name)) {
+            throw new Error(`Tool name '${toolInput.name}' already registered.`);
+        }
+        if (toolInput.inputSchema.type !== "object") {
+            throw new Error(`Tool '${toolInput.name}': inputSchema.type must be "object" for tool definitions`);
+        }
+        const toolDefinition = {
+            name: toolInput.name,
+            description: toolInput.description,
+            execute: toolInput.function,
+            inputSchema: toolInput.inputSchema,
+            icon: toolInput.icon,
+        };
+        this.registry.set(toolInput.name, toolDefinition);
+        logger_util_1.logger.info("StandaloneToolRegistry", `Tool registered: ${toolInput.name}`, {
+            component: "Standalone",
+            toolName: toolInput.name,
+        });
+    }
+    getTool(name) {
+        return this.registry.get(name);
+    }
+    async executeTool(name, args, cancellationToken, context) {
+        const tool = this.getTool(name);
+        if (!tool) {
+            throw new easy_mcp_error_1.ToolNotFoundError(name);
+        }
+        const validationError = (0, schema_validator_1.validateToolArguments)(args, tool.inputSchema);
+        if (validationError) {
+            throw new easy_mcp_error_1.ToolExecutionError(`Tool '${name}' validation failed: ${validationError}`, name);
+        }
+        try {
+            const result = await tool.execute(args, cancellationToken, context);
+            return result;
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            throw new easy_mcp_error_1.ToolExecutionError(`Tool '${name}' execution failed: ${errorMessage}`, name, error instanceof Error ? error : undefined);
+        }
+    }
+    getToolSchemasForLLM() {
+        return Array.from(this.registry.values()).map((tool) => ({
+            type: "function",
+            function: {
+                name: tool.name,
+                description: tool.description,
+                parameters: tool.inputSchema,
+            },
+        }));
+    }
+}
+exports.StandaloneToolRegistry = StandaloneToolRegistry;
+class StandaloneResourceRegistry {
+    registry = new Map();
+    registerResource(resource) {
+        if (this.registry.has(resource.uri)) {
+            throw new Error(`Resource URI '${resource.uri}' already registered.`);
+        }
+        this.registry.set(resource.uri, resource);
+    }
+    getResource(uri) {
+        return this.registry.get(uri);
+    }
+    getAllResources() {
+        return Array.from(this.registry.values());
+    }
+}
+exports.StandaloneResourceRegistry = StandaloneResourceRegistry;
+class StandalonePromptRegistry {
+    registry = new Map();
+    registerPrompt(prompt) {
+        if (this.registry.has(prompt.name)) {
+            throw new Error(`Prompt name '${prompt.name}' already registered.`);
+        }
+        this.registry.set(prompt.name, prompt);
+    }
+    getPrompt(name) {
+        return this.registry.get(name);
+    }
+    getAllPrompts() {
+        return Array.from(this.registry.values());
+    }
+}
+exports.StandalonePromptRegistry = StandalonePromptRegistry;
+//# sourceMappingURL=core-services.js.map

package/dist/standalone/core-services.js.map

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

package/dist/standalone/index.d.ts

@@ -0,0 +1,3 @@
+export { createMcpServer, StandaloneMcpServer } from "./standalone-server";
+export type { CreateMcpServerOptions, StandaloneTransport, StandaloneAuthFunction } from "./types";
+export { StandaloneToolRegistry, StandaloneResourceRegistry, StandalonePromptRegistry } from "./core-services";

package/dist/standalone/index.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StandalonePromptRegistry = exports.StandaloneResourceRegistry = exports.StandaloneToolRegistry = exports.StandaloneMcpServer = exports.createMcpServer = void 0;
+var standalone_server_1 = require("./standalone-server");
+Object.defineProperty(exports, "createMcpServer", { enumerable: true, get: function () { return standalone_server_1.createMcpServer; } });
+Object.defineProperty(exports, "StandaloneMcpServer", { enumerable: true, get: function () { return standalone_server_1.StandaloneMcpServer; } });
+var core_services_1 = require("./core-services");
+Object.defineProperty(exports, "StandaloneToolRegistry", { enumerable: true, get: function () { return core_services_1.StandaloneToolRegistry; } });
+Object.defineProperty(exports, "StandaloneResourceRegistry", { enumerable: true, get: function () { return core_services_1.StandaloneResourceRegistry; } });
+Object.defineProperty(exports, "StandalonePromptRegistry", { enumerable: true, get: function () { return core_services_1.StandalonePromptRegistry; } });
+//# sourceMappingURL=index.js.map

package/dist/standalone/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/standalone/index.ts"],"names":[],"mappings":";;;AAAA,yDAA2E;AAAlE,oHAAA,eAAe,OAAA;AAAE,wHAAA,mBAAmB,OAAA;AAE7C,iDAA+G;AAAtG,uHAAA,sBAAsB,OAAA;AAAE,2HAAA,0BAA0B,OAAA;AAAE,yHAAA,wBAAwB,OAAA"}

package/dist/standalone/standalone-server.d.ts

@@ -0,0 +1,23 @@
+import { CreateMcpServerOptions } from "./types";
+import { JsonRpcRequest, JsonRpcResponse } from "../interface/jsonrpc.interface";
+export declare class StandaloneMcpServer {
+    private toolRegistry;
+    private resourceRegistry;
+    private promptRegistry;
+    private serverInfo;
+    private transport;
+    private auth?;
+    private httpServer?;
+    private port?;
+    private host?;
+    constructor(options: CreateMcpServerOptions);
+    start(): Promise<void>;
+    private startStdio;
+    private startHttp;
+    handleRequest(request: JsonRpcRequest): Promise<JsonRpcResponse>;
+    private handleInitialize;
+    private handleListTools;
+    private handleCallTool;
+    stop(): Promise<void>;
+}
+export declare function createMcpServer(options: CreateMcpServerOptions): StandaloneMcpServer;