@ttoss/http-server-mcp-openapi 0.1.3 → 0.2.1

package/dist/index.cjs

@@ -45,6 +45,7 @@ var dereferenceValue = args => {
       const refName = obj.$ref.replace("#/components/schemas/", "");
       if (seenRefs.has(refName)) return {};
       const resolved = spec.components?.schemas?.[refName];
+      if (resolved === void 0) return {};
       return dereferenceValue({
         value: resolved,
         spec,
@@ -184,6 +185,34 @@ var getJsonSchemaType = schemaType => {
 var sanitizeDescription = description => {
   return (description || "").replace(/'/g, "\\'").replace(/\n/g, " ").trim();
 };
+/**
+* Builds a single body/query property's `JsonSchemaProperty`. Split out of
+* {@link buildInputSchema} to keep that function's size and branching down.
+*/
+var buildTypedProperty = param => {
+  const description = sanitizeDescription(param.description);
+  if (param.oneOf && param.oneOf.length > 0) return {
+    oneOf: param.oneOf,
+    description
+  };
+  if (param.anyOf && param.anyOf.length > 0) return {
+    anyOf: param.anyOf,
+    description
+  };
+  const jsonType = getJsonSchemaType(param.type);
+  const finalType = param.nullable === true ? [jsonType, "null"] : jsonType;
+  if (param.type === "array") return {
+    type: finalType,
+    items: param.items ? param.items : {
+      type: "string"
+    },
+    description
+  };
+  return {
+    type: finalType,
+    description
+  };
+};
 var buildInputSchema = (pathParams, queryParams, bodyProps) => {
   const allParams = [...pathParams, ...queryParams, ...bodyProps];
   if (allParams.length === 0) return {
@@ -201,30 +230,16 @@ var buildInputSchema = (pathParams, queryParams, bodyProps) => {
     return p.camelName;
   })];
   const properties = {};
-  for (const param of allParams) if ("type" in param) {
-    const jsonType = getJsonSchemaType(param.type);
-    const description = sanitizeDescription(param.description);
-    if (param.type === "array") {
-      const itemsSchema = "items" in param && param.items ? param.items : {
-        type: "string"
-      };
-      properties[param.camelName] = {
-        type: "array",
-        items: itemsSchema,
-        description
-      };
-    } else properties[param.camelName] = {
-      type: jsonType,
-      description
-    };
-  } else properties[param.camelName] = {
+  for (const param of allParams) properties[param.camelName] = "type" in param ? buildTypedProperty(param) : {
     type: "string",
     description: ""
   };
   return {
     type: "object",
     properties,
-    required: requiredFields.length > 0 ? requiredFields : void 0
+    ...(requiredFields.length > 0 ? {
+      required: requiredFields
+    } : {})
   };
 };
 /**
@@ -289,7 +304,10 @@ var extractBodyProps = args => {
       description: typeof val.description === "string" ? val.description : "",
       required: (bodySchema.required || []).includes(key),
       type: typeof val.type === "string" ? val.type : "string",
-      items: val.items
+      items: val.items,
+      nullable: val.nullable === true,
+      oneOf: Array.isArray(val.oneOf) ? val.oneOf : void 0,
+      anyOf: Array.isArray(val.anyOf) ? val.anyOf : void 0
     };
   });
 };

package/dist/index.d.cts

@@ -2,16 +2,28 @@
 import { JsonObjectSchema, McpServer } from "@ttoss/http-server-mcp";
 
 //#region src/types.d.ts
+/** The JSON Schema primitive types this generator can derive from an OpenAPI `type`. */
+type JsonSchemaPrimitiveType = 'string' | 'number' | 'boolean' | 'array' | 'integer' | 'object' | 'null';
 /**
  * A single JSON Schema property descriptor as emitted for a tool's
  * `inputSchema`. Only the subset of JSON Schema the generator produces is
  * modelled here; the value is forwarded verbatim over the MCP wire protocol.
+ *
+ * A property with OpenAPI `oneOf`/`anyOf` is forwarded as-is (no `type`) so a
+ * client-side validator enforces the same alternatives the REST API does,
+ * rather than collapsing to a single guessed primitive. `type` may be an
+ * array of two entries (e.g. `['string', 'null']`) to represent an OpenAPI
+ * `nullable: true` property without losing its declared type.
  */
-interface JsonSchemaProperty {
-  type: 'string' | 'number' | 'boolean' | 'array' | 'integer' | 'object' | 'null';
+type JsonSchemaProperty = {
+  type: JsonSchemaPrimitiveType | JsonSchemaPrimitiveType[];
   description?: string;
   items?: unknown;
-}
+} | {
+  oneOf?: unknown[];
+  anyOf?: unknown[];
+  description?: string;
+};
 /**
  * A REST-backed MCP tool derived from a single OpenAPI operation.
  *
@@ -256,6 +268,9 @@ declare const buildInputSchema: (pathParams: Array<{
   required: boolean;
   type: string;
   items?: unknown;
+  nullable?: boolean;
+  oneOf?: unknown[];
+  anyOf?: unknown[];
 }>) => JsonObjectSchema;
 declare const extractPathParams: (args: {
   parameters?: Array<{
@@ -301,6 +316,9 @@ declare const extractBodyProps: (args: {
   required: boolean;
   type: string;
   items?: unknown;
+  nullable: boolean;
+  oneOf?: unknown[];
+  anyOf?: unknown[];
 }>;
 declare const processOperation: (args: {
   pathTemplate: string;

package/dist/index.d.mts

@@ -2,16 +2,28 @@
 import { JsonObjectSchema, McpServer } from "@ttoss/http-server-mcp";
 
 //#region src/types.d.ts
+/** The JSON Schema primitive types this generator can derive from an OpenAPI `type`. */
+type JsonSchemaPrimitiveType = 'string' | 'number' | 'boolean' | 'array' | 'integer' | 'object' | 'null';
 /**
  * A single JSON Schema property descriptor as emitted for a tool's
  * `inputSchema`. Only the subset of JSON Schema the generator produces is
  * modelled here; the value is forwarded verbatim over the MCP wire protocol.
+ *
+ * A property with OpenAPI `oneOf`/`anyOf` is forwarded as-is (no `type`) so a
+ * client-side validator enforces the same alternatives the REST API does,
+ * rather than collapsing to a single guessed primitive. `type` may be an
+ * array of two entries (e.g. `['string', 'null']`) to represent an OpenAPI
+ * `nullable: true` property without losing its declared type.
  */
-interface JsonSchemaProperty {
-  type: 'string' | 'number' | 'boolean' | 'array' | 'integer' | 'object' | 'null';
+type JsonSchemaProperty = {
+  type: JsonSchemaPrimitiveType | JsonSchemaPrimitiveType[];
   description?: string;
   items?: unknown;
-}
+} | {
+  oneOf?: unknown[];
+  anyOf?: unknown[];
+  description?: string;
+};
 /**
  * A REST-backed MCP tool derived from a single OpenAPI operation.
  *
@@ -256,6 +268,9 @@ declare const buildInputSchema: (pathParams: Array<{
   required: boolean;
   type: string;
   items?: unknown;
+  nullable?: boolean;
+  oneOf?: unknown[];
+  anyOf?: unknown[];
 }>) => JsonObjectSchema;
 declare const extractPathParams: (args: {
   parameters?: Array<{
@@ -301,6 +316,9 @@ declare const extractBodyProps: (args: {
   required: boolean;
   type: string;
   items?: unknown;
+  nullable: boolean;
+  oneOf?: unknown[];
+  anyOf?: unknown[];
 }>;
 declare const processOperation: (args: {
   pathTemplate: string;

package/dist/index.mjs

@@ -42,6 +42,7 @@ var dereferenceValue = args => {
       const refName = obj.$ref.replace("#/components/schemas/", "");
       if (seenRefs.has(refName)) return {};
       const resolved = spec.components?.schemas?.[refName];
+      if (resolved === void 0) return {};
       return dereferenceValue({
         value: resolved,
         spec,
@@ -181,6 +182,34 @@ var getJsonSchemaType = schemaType => {
 var sanitizeDescription = description => {
   return (description || "").replace(/'/g, "\\'").replace(/\n/g, " ").trim();
 };
+/**
+* Builds a single body/query property's `JsonSchemaProperty`. Split out of
+* {@link buildInputSchema} to keep that function's size and branching down.
+*/
+var buildTypedProperty = param => {
+  const description = sanitizeDescription(param.description);
+  if (param.oneOf && param.oneOf.length > 0) return {
+    oneOf: param.oneOf,
+    description
+  };
+  if (param.anyOf && param.anyOf.length > 0) return {
+    anyOf: param.anyOf,
+    description
+  };
+  const jsonType = getJsonSchemaType(param.type);
+  const finalType = param.nullable === true ? [jsonType, "null"] : jsonType;
+  if (param.type === "array") return {
+    type: finalType,
+    items: param.items ? param.items : {
+      type: "string"
+    },
+    description
+  };
+  return {
+    type: finalType,
+    description
+  };
+};
 var buildInputSchema = (pathParams, queryParams, bodyProps) => {
   const allParams = [...pathParams, ...queryParams, ...bodyProps];
   if (allParams.length === 0) return {
@@ -198,30 +227,16 @@ var buildInputSchema = (pathParams, queryParams, bodyProps) => {
     return p.camelName;
   })];
   const properties = {};
-  for (const param of allParams) if ("type" in param) {
-    const jsonType = getJsonSchemaType(param.type);
-    const description = sanitizeDescription(param.description);
-    if (param.type === "array") {
-      const itemsSchema = "items" in param && param.items ? param.items : {
-        type: "string"
-      };
-      properties[param.camelName] = {
-        type: "array",
-        items: itemsSchema,
-        description
-      };
-    } else properties[param.camelName] = {
-      type: jsonType,
-      description
-    };
-  } else properties[param.camelName] = {
+  for (const param of allParams) properties[param.camelName] = "type" in param ? buildTypedProperty(param) : {
     type: "string",
     description: ""
   };
   return {
     type: "object",
     properties,
-    required: requiredFields.length > 0 ? requiredFields : void 0
+    ...(requiredFields.length > 0 ? {
+      required: requiredFields
+    } : {})
   };
 };
 /**
@@ -286,7 +301,10 @@ var extractBodyProps = args => {
       description: typeof val.description === "string" ? val.description : "",
       required: (bodySchema.required || []).includes(key),
       type: typeof val.type === "string" ? val.type : "string",
-      items: val.items
+      items: val.items,
+      nullable: val.nullable === true,
+      oneOf: Array.isArray(val.oneOf) ? val.oneOf : void 0,
+      anyOf: Array.isArray(val.anyOf) ? val.anyOf : void 0
     };
   });
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ttoss/http-server-mcp-openapi",
-  "version": "0.1.3",
+  "version": "0.2.1",
   "description": "Generate Model Context Protocol (MCP) tools from an OpenAPI specification for @ttoss/http-server-mcp",
   "keywords": [
     "ai",
@@ -35,14 +35,15 @@
     "dist"
   ],
   "dependencies": {
-    "@ttoss/http-server-mcp": "^0.23.1"
+    "@ttoss/http-server-mcp": "^0.24.0"
   },
   "devDependencies": {
+    "@modelcontextprotocol/server": "^2.0.0",
     "jest": "^30.4.2",
     "supertest": "^7.2.2",
     "tsdown": "^0.22.2",
-    "@ttoss/http-server": "^0.7.1",
-    "@ttoss/config": "^1.37.17"
+    "@ttoss/config": "^1.37.17",
+    "@ttoss/http-server": "^0.7.1"
   },
   "publishConfig": {
     "access": "public",