easy-mcp-nest 0.2.0 → 0.3.0

package/dist/validation/index.d.ts

@@ -0,0 +1 @@
+export { zodToJsonSchema, validateWithZod, safeValidateWithZod } from "./zod-integration";

package/dist/validation/index.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.safeValidateWithZod = exports.validateWithZod = exports.zodToJsonSchema = void 0;
+var zod_integration_1 = require("./zod-integration");
+Object.defineProperty(exports, "zodToJsonSchema", { enumerable: true, get: function () { return zod_integration_1.zodToJsonSchema; } });
+Object.defineProperty(exports, "validateWithZod", { enumerable: true, get: function () { return zod_integration_1.validateWithZod; } });
+Object.defineProperty(exports, "safeValidateWithZod", { enumerable: true, get: function () { return zod_integration_1.safeValidateWithZod; } });
+//# sourceMappingURL=index.js.map

package/dist/validation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/validation/index.ts"],"names":[],"mappings":";;;AAAA,qDAA0F;AAAjF,kHAAA,eAAe,OAAA;AAAE,kHAAA,eAAe,OAAA;AAAE,sHAAA,mBAAmB,OAAA"}

package/dist/validation/zod-integration.d.ts

@@ -0,0 +1,11 @@
+import { z } from "zod";
+import { JsonSchema2020_12 } from "../config/mcp-config.interface";
+export declare function zodToJsonSchema(schema: z.ZodTypeAny): JsonSchema2020_12;
+export declare function validateWithZod<T>(schema: z.ZodType<T>, data: unknown): T;
+export declare function safeValidateWithZod<T>(schema: z.ZodType<T>, data: unknown): {
+    success: true;
+    data: T;
+} | {
+    success: false;
+    error: z.ZodError;
+};

package/dist/validation/zod-integration.js

@@ -0,0 +1,148 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.zodToJsonSchema = zodToJsonSchema;
+exports.validateWithZod = validateWithZod;
+exports.safeValidateWithZod = safeValidateWithZod;
+const zod_1 = require("zod");
+function zodToJsonSchema(schema) {
+    if (schema instanceof zod_1.z.ZodObject) {
+        const shape = schema.shape;
+        const properties = {};
+        const required = [];
+        for (const [key, value] of Object.entries(shape)) {
+            const zodSchema = value;
+            properties[key] = zodSchemaToJsonSchema(zodSchema);
+            if (!(zodSchema instanceof zod_1.z.ZodOptional) &&
+                !(zodSchema instanceof zod_1.z.ZodDefault) &&
+                !(zodSchema instanceof zod_1.z.ZodNullable)) {
+                required.push(key);
+            }
+        }
+        return {
+            type: "object",
+            properties,
+            required: required.length > 0 ? required : undefined,
+        };
+    }
+    return zodSchemaToJsonSchema(schema);
+}
+function zodSchemaToJsonSchema(schema) {
+    if (schema instanceof zod_1.z.ZodOptional) {
+        return zodSchemaToJsonSchema(schema._def.innerType);
+    }
+    if (schema instanceof zod_1.z.ZodNullable) {
+        const inner = zodSchemaToJsonSchema(schema._def.innerType);
+        return {
+            oneOf: [
+                inner,
+                { type: "null" },
+            ],
+        };
+    }
+    if (schema instanceof zod_1.z.ZodDefault) {
+        const inner = zodSchemaToJsonSchema(schema._def.innerType);
+        return {
+            ...inner,
+            default: schema._def.defaultValue(),
+        };
+    }
+    if (schema instanceof zod_1.z.ZodString) {
+        const result = { type: "string" };
+        if (schema._def.checks) {
+            for (const check of schema._def.checks) {
+                if (check.kind === "min") {
+                    result.minLength = check.value;
+                }
+                else if (check.kind === "max") {
+                    result.maxLength = check.value;
+                }
+                else if (check.kind === "email") {
+                    result.format = "email";
+                }
+                else if (check.kind === "url") {
+                    result.format = "url";
+                }
+                else if (check.kind === "uuid") {
+                    result.format = "uuid";
+                }
+                else if (check.kind === "regex") {
+                    result.pattern = check.regex.source;
+                }
+            }
+        }
+        return result;
+    }
+    if (schema instanceof zod_1.z.ZodNumber) {
+        const result = { type: "number" };
+        if (schema._def.checks) {
+            for (const check of schema._def.checks) {
+                if (check.kind === "min") {
+                    result.minimum = check.value;
+                }
+                else if (check.kind === "max") {
+                    result.maximum = check.value;
+                }
+                else if (check.kind === "int") {
+                    result.type = "integer";
+                }
+            }
+        }
+        return result;
+    }
+    if (schema instanceof zod_1.z.ZodBoolean) {
+        return { type: "boolean" };
+    }
+    if (schema instanceof zod_1.z.ZodArray) {
+        return {
+            type: "array",
+            items: zodSchemaToJsonSchema(schema._def.type),
+        };
+    }
+    if (schema instanceof zod_1.z.ZodEnum) {
+        return {
+            type: "string",
+            enum: schema._def.values,
+        };
+    }
+    if (schema instanceof zod_1.z.ZodNativeEnum) {
+        return {
+            type: "string",
+            enum: Object.values(schema._def.values),
+        };
+    }
+    if (schema instanceof zod_1.z.ZodUnion) {
+        return {
+            type: "object",
+            oneOf: schema._def.options.map((option) => zodSchemaToJsonSchema(option)),
+        };
+    }
+    if (schema instanceof zod_1.z.ZodLiteral) {
+        const value = schema._def.value;
+        const valueType = typeof value;
+        return {
+            type: (valueType === "string" ? "string" :
+                valueType === "number" ? "number" :
+                    valueType === "boolean" ? "boolean" :
+                        "object"),
+            const: value,
+        };
+    }
+    if (schema instanceof zod_1.z.ZodObject) {
+        return zodToJsonSchema(schema);
+    }
+    if (schema instanceof zod_1.z.ZodAny || schema instanceof zod_1.z.ZodUnknown) {
+        return { type: "object" };
+    }
+    return { type: "object" };
+}
+function validateWithZod(schema, data) {
+    return schema.parse(data);
+}
+function safeValidateWithZod(schema, data) {
+    const result = schema.safeParse(data);
+    if (result.success) {
+        return { success: true, data: result.data };
+    }
+    return { success: false, error: result.error };
+}
+//# sourceMappingURL=zod-integration.js.map

package/dist/validation/zod-integration.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "easy-mcp-nest",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "A NestJS-based framework for building standard Model Context Protocol (MCP) servers with tool execution via JSON-RPC 2.0",
   "author": "Nir Arazi",
   "license": "MIT",
@@ -56,7 +56,9 @@
   "peerDependencies": {
     "@nestjs/common": "^11.0.1",
     "@nestjs/core": "^11.0.1",
-    "@nestjs/platform-express": "^11.0.1"
+    "@nestjs/platform-express": "^11.0.1",
+    "express": "^4.18.0",
+    "zod": "^3.22.0"
   },
   "devDependencies": {
     "@eslint/eslintrc": "^3.2.0",