mcp-from-openapi 0.0.1

package/src/parameter-resolver.js

@@ -0,0 +1,211 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ParameterResolver = void 0;
+const types_1 = require("./types");
+/**
+ * Resolves parameters and handles naming conflicts
+ */
+class ParameterResolver {
+    constructor(namingStrategy) {
+        this.namingStrategy = namingStrategy ?? {
+            conflictResolver: this.defaultConflictResolver,
+        };
+    }
+    /**
+     * Default conflict resolver: prefix with location
+     */
+    defaultConflictResolver(paramName, location, index) {
+        const locationPrefix = {
+            path: 'path',
+            query: 'query',
+            header: 'header',
+            cookie: 'cookie',
+            body: 'body',
+        }[location];
+        return `${locationPrefix}${paramName.charAt(0).toUpperCase()}${paramName.slice(1)}`;
+    }
+    /**
+     * Resolve all parameters for an operation
+     */
+    resolve(operation, pathParameters) {
+        const allParameters = [
+            ...(pathParameters ?? []),
+            ...(operation.parameters ?? []),
+        ];
+        const requestBody = operation.requestBody;
+        // Collect all parameter names and detect conflicts
+        const parametersByName = new Map();
+        // Process standard parameters
+        allParameters.forEach((param) => {
+            const info = {
+                name: param.name,
+                location: param.in,
+                required: param.required ?? (param.in === 'path'),
+                schema: param.schema ?? { type: 'string' },
+                description: param.description,
+                style: param.style,
+                explode: param.explode,
+                allowReserved: param.allowReserved,
+                deprecated: param.deprecated,
+            };
+            if (!parametersByName.has(param.name)) {
+                parametersByName.set(param.name, []);
+            }
+            parametersByName.get(param.name).push(info);
+        });
+        // Process request body
+        if (requestBody?.content) {
+            const contentType = this.selectContentType(requestBody.content);
+            const mediaType = requestBody.content[contentType];
+            if (mediaType?.schema) {
+                this.extractBodyParameters(mediaType.schema, parametersByName, requestBody.required ?? false, contentType);
+            }
+        }
+        // Resolve conflicts and build schema + mapper
+        const properties = {};
+        const required = [];
+        const mapper = [];
+        for (const [originalName, params] of parametersByName.entries()) {
+            if (params.length === 1) {
+                // No conflict
+                const param = params[0];
+                const inputKey = originalName;
+                properties[inputKey] = this.buildParameterSchema(param);
+                if (param.required) {
+                    required.push(inputKey);
+                }
+                mapper.push({
+                    inputKey,
+                    type: param.location,
+                    key: originalName,
+                    required: param.required,
+                    style: param.style,
+                    explode: param.explode,
+                    serialization: param.serialization,
+                });
+            }
+            else {
+                // Conflict - need to resolve
+                params.forEach((param, index) => {
+                    const inputKey = this.namingStrategy.conflictResolver(originalName, param.location, index);
+                    properties[inputKey] = this.buildParameterSchema(param);
+                    if (param.required) {
+                        required.push(inputKey);
+                    }
+                    mapper.push({
+                        inputKey,
+                        type: param.location,
+                        key: originalName,
+                        required: param.required,
+                        style: param.style,
+                        explode: param.explode,
+                        serialization: param.serialization,
+                    });
+                });
+            }
+        }
+        const inputSchema = {
+            type: 'object',
+            properties,
+            ...(required.length > 0 && { required }),
+            additionalProperties: false,
+        };
+        return { inputSchema, mapper };
+    }
+    /**
+     * Extract parameters from request body schema
+     */
+    extractBodyParameters(schema, parametersByName, required, contentType, prefix = '') {
+        if (!schema || typeof schema !== 'object')
+            return;
+        // Convert to JSONSchema7 for processing
+        const jsonSchema = (0, types_1.toJSONSchema7)(schema);
+        // Handle object schemas
+        if (jsonSchema.type === 'object' && jsonSchema.properties) {
+            const requiredFields = new Set(jsonSchema.required ?? []);
+            for (const [propName, propSchema] of Object.entries(jsonSchema.properties)) {
+                const fullName = prefix ? `${prefix}.${propName}` : propName;
+                const isRequired = required && requiredFields.has(propName);
+                if (typeof propSchema === 'object' && !('$ref' in propSchema)) {
+                    const info = {
+                        name: fullName,
+                        location: 'body',
+                        required: isRequired,
+                        schema: propSchema,
+                        description: propSchema.description,
+                        serialization: {
+                            contentType,
+                        },
+                    };
+                    if (!parametersByName.has(fullName)) {
+                        parametersByName.set(fullName, []);
+                    }
+                    parametersByName.get(fullName).push(info);
+                }
+            }
+        }
+        else {
+            // For non-object bodies (arrays, primitives), treat as single parameter
+            const bodyParamName = prefix || 'body';
+            const info = {
+                name: bodyParamName,
+                location: 'body',
+                required,
+                schema,
+                serialization: {
+                    contentType,
+                },
+            };
+            if (!parametersByName.has(bodyParamName)) {
+                parametersByName.set(bodyParamName, []);
+            }
+            parametersByName.get(bodyParamName).push(info);
+        }
+    }
+    /**
+     * Build JSON Schema for a parameter
+     */
+    buildParameterSchema(param) {
+        const schema = (0, types_1.toJSONSchema7)(param.schema);
+        if (param.description) {
+            schema.description = param.description;
+        }
+        if (param.deprecated) {
+            schema['deprecated'] = true;
+        }
+        // Add parameter metadata
+        schema['x-parameter-location'] = param.location;
+        if (param.style) {
+            schema['x-parameter-style'] = param.style;
+        }
+        if (param.explode !== undefined) {
+            schema['x-parameter-explode'] = param.explode;
+        }
+        return schema;
+    }
+    /**
+     * Select the most appropriate content type
+     */
+    selectContentType(content) {
+        // Preference order
+        const preferences = [
+            'application/json',
+            'application/x-www-form-urlencoded',
+            'multipart/form-data',
+            'application/xml',
+            'text/plain',
+        ];
+        for (const pref of preferences) {
+            if (content[pref])
+                return pref;
+        }
+        // Fallback to first available
+        const firstKey = Object.keys(content)[0];
+        if (!firstKey) {
+            throw new Error('No content type available in request body');
+        }
+        return firstKey;
+    }
+}
+exports.ParameterResolver = ParameterResolver;
+//# sourceMappingURL=parameter-resolver.js.map

package/src/parameter-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parameter-resolver.js","sourceRoot":"","sources":["../../src/parameter-resolver.ts"],"names":[],"mappings":"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","sourcesContent":["import type { JSONSchema7 } from 'json-schema';\nimport type {\n  ParameterMapper,\n  ParameterObject,\n  RequestBodyObject,\n  NamingStrategy,\n  ParameterLocation,\n  SchemaObject,\n  ReferenceObject,\n} from './types';\nimport { toJSONSchema7 } from './types';\n\n/**\n * Resolves parameters and handles naming conflicts\n */\nexport class ParameterResolver {\n  private namingStrategy: NamingStrategy;\n\n  constructor(namingStrategy?: NamingStrategy) {\n    this.namingStrategy = namingStrategy ?? {\n      conflictResolver: this.defaultConflictResolver,\n    };\n  }\n\n  /**\n   * Default conflict resolver: prefix with location\n   */\n  private defaultConflictResolver(\n    paramName: string,\n    location: ParameterLocation,\n    index: number\n  ): string {\n    const locationPrefix = {\n      path: 'path',\n      query: 'query',\n      header: 'header',\n      cookie: 'cookie',\n      body: 'body',\n    }[location];\n\n    return `${locationPrefix}${paramName.charAt(0).toUpperCase()}${paramName.slice(1)}`;\n  }\n\n  /**\n   * Resolve all parameters for an operation\n   */\n  resolve(\n    operation: any,\n    pathParameters?: ParameterObject[]\n  ): {\n    inputSchema: JSONSchema7;\n    mapper: ParameterMapper[];\n  } {\n    const allParameters: ParameterObject[] = [\n      ...(pathParameters ?? []),\n      ...(operation.parameters ?? []),\n    ];\n\n    const requestBody = operation.requestBody as RequestBodyObject | undefined;\n\n    // Collect all parameter names and detect conflicts\n    const parametersByName = new Map<string, ParameterInfo[]>();\n\n    // Process standard parameters\n    allParameters.forEach((param) => {\n      const info: ParameterInfo = {\n        name: param.name,\n        location: param.in as ParameterLocation,\n        required: param.required ?? (param.in === 'path'),\n        schema: param.schema ?? { type: 'string' },\n        description: param.description,\n        style: param.style,\n        explode: param.explode,\n        allowReserved: param.allowReserved,\n        deprecated: param.deprecated,\n      };\n\n      if (!parametersByName.has(param.name)) {\n        parametersByName.set(param.name, []);\n      }\n      parametersByName.get(param.name)!.push(info);\n    });\n\n    // Process request body\n    if (requestBody?.content) {\n      const contentType = this.selectContentType(requestBody.content);\n      const mediaType = requestBody.content[contentType];\n\n      if (mediaType?.schema) {\n        this.extractBodyParameters(\n          mediaType.schema,\n          parametersByName,\n          requestBody.required ?? false,\n          contentType\n        );\n      }\n    }\n\n    // Resolve conflicts and build schema + mapper\n    const properties: Record<string, JSONSchema7> = {};\n    const required: string[] = [];\n    const mapper: ParameterMapper[] = [];\n\n    for (const [originalName, params] of parametersByName.entries()) {\n      if (params.length === 1) {\n        // No conflict\n        const param = params[0];\n        const inputKey = originalName;\n\n        properties[inputKey] = this.buildParameterSchema(param);\n        if (param.required) {\n          required.push(inputKey);\n        }\n\n        mapper.push({\n          inputKey,\n          type: param.location,\n          key: originalName,\n          required: param.required,\n          style: param.style,\n          explode: param.explode,\n          serialization: param.serialization,\n        });\n      } else {\n        // Conflict - need to resolve\n        params.forEach((param, index) => {\n          const inputKey = this.namingStrategy.conflictResolver(\n            originalName,\n            param.location,\n            index\n          );\n\n          properties[inputKey] = this.buildParameterSchema(param);\n          if (param.required) {\n            required.push(inputKey);\n          }\n\n          mapper.push({\n            inputKey,\n            type: param.location,\n            key: originalName,\n            required: param.required,\n            style: param.style,\n            explode: param.explode,\n            serialization: param.serialization,\n          });\n        });\n      }\n    }\n\n    const inputSchema: JSONSchema7 = {\n      type: 'object',\n      properties,\n      ...(required.length > 0 && { required }),\n      additionalProperties: false,\n    };\n\n    return { inputSchema, mapper };\n  }\n\n  /**\n   * Extract parameters from request body schema\n   */\n  private extractBodyParameters(\n    schema: SchemaObject | ReferenceObject,\n    parametersByName: Map<string, ParameterInfo[]>,\n    required: boolean,\n    contentType: string,\n    prefix = ''\n  ): void {\n    if (!schema || typeof schema !== 'object') return;\n\n    // Convert to JSONSchema7 for processing\n    const jsonSchema = toJSONSchema7(schema);\n\n    // Handle object schemas\n    if (jsonSchema.type === 'object' && jsonSchema.properties) {\n      const requiredFields = new Set(jsonSchema.required ?? []);\n\n      for (const [propName, propSchema] of Object.entries(jsonSchema.properties)) {\n        const fullName = prefix ? `${prefix}.${propName}` : propName;\n        const isRequired = required && requiredFields.has(propName);\n\n        if (typeof propSchema === 'object' && !('$ref' in propSchema)) {\n          const info: ParameterInfo = {\n            name: fullName,\n            location: 'body',\n            required: isRequired,\n            schema: propSchema as JSONSchema7,\n            description: (propSchema as any).description,\n            serialization: {\n              contentType,\n            },\n          };\n\n          if (!parametersByName.has(fullName)) {\n            parametersByName.set(fullName, []);\n          }\n          parametersByName.get(fullName)!.push(info);\n        }\n      }\n    } else {\n      // For non-object bodies (arrays, primitives), treat as single parameter\n      const bodyParamName = prefix || 'body';\n      const info: ParameterInfo = {\n        name: bodyParamName,\n        location: 'body',\n        required,\n        schema,\n        serialization: {\n          contentType,\n        },\n      };\n\n      if (!parametersByName.has(bodyParamName)) {\n        parametersByName.set(bodyParamName, []);\n      }\n      parametersByName.get(bodyParamName)!.push(info);\n    }\n  }\n\n  /**\n   * Build JSON Schema for a parameter\n   */\n  private buildParameterSchema(param: ParameterInfo): JSONSchema7 {\n    const schema: JSONSchema7 = toJSONSchema7(param.schema as any);\n\n    if (param.description) {\n      schema.description = param.description;\n    }\n\n    if (param.deprecated) {\n      schema['deprecated'] = true;\n    }\n\n    // Add parameter metadata\n    (schema as any)['x-parameter-location'] = param.location;\n    if (param.style) {\n      (schema as any)['x-parameter-style'] = param.style;\n    }\n    if (param.explode !== undefined) {\n      (schema as any)['x-parameter-explode'] = param.explode;\n    }\n\n    return schema;\n  }\n\n  /**\n   * Select the most appropriate content type\n   */\n  private selectContentType(content: Record<string, any>): string {\n    // Preference order\n    const preferences = [\n      'application/json',\n      'application/x-www-form-urlencoded',\n      'multipart/form-data',\n      'application/xml',\n      'text/plain',\n    ];\n\n    for (const pref of preferences) {\n      if (content[pref]) return pref;\n    }\n\n    // Fallback to first available\n    const firstKey = Object.keys(content)[0];\n    if (!firstKey) {\n      throw new Error('No content type available in request body');\n    }\n    return firstKey;\n  }\n}\n\n/**\n * Internal parameter info structure\n */\ninterface ParameterInfo {\n  name: string;\n  location: ParameterLocation;\n  required: boolean;\n  schema: SchemaObject | ReferenceObject | JSONSchema7;\n  description?: string;\n  style?: string;\n  explode?: boolean;\n  allowReserved?: boolean;\n  deprecated?: boolean;\n  serialization?: {\n    contentType?: string;\n    encoding?: Record<string, any>;\n  };\n}\n"]}

package/src/response-builder.d.ts

@@ -0,0 +1,30 @@
+import type { JSONSchema7 } from 'json-schema';
+import type { GenerateOptions, ResponsesObject } from './types';
+/**
+ * Builds output schemas from OpenAPI response definitions
+ */
+export declare class ResponseBuilder {
+    private preferredStatusCodes;
+    private includeAllResponses;
+    constructor(options?: GenerateOptions);
+    /**
+     * Build output schema from responses
+     */
+    build(responses?: ResponsesObject): JSONSchema7 | undefined;
+    /**
+     * Extract schemas from all responses
+     */
+    private extractResponseSchemas;
+    /**
+     * Extract schema from a single response
+     */
+    private extractResponseSchema;
+    /**
+     * Select the most appropriate content type
+     */
+    private selectContentType;
+    /**
+     * Select the preferred schema based on status code preferences
+     */
+    private selectPreferredSchema;
+}

package/src/response-builder.js

@@ -0,0 +1,147 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ResponseBuilder = void 0;
+const types_1 = require("./types");
+/**
+ * Builds output schemas from OpenAPI response definitions
+ */
+class ResponseBuilder {
+    constructor(options = {}) {
+        this.preferredStatusCodes = options.preferredStatusCodes ?? [200, 201, 204, 202, 203, 206];
+        this.includeAllResponses = options.includeAllResponses ?? true;
+    }
+    /**
+     * Build output schema from responses
+     */
+    build(responses) {
+        if (!responses || Object.keys(responses).length === 0) {
+            return undefined;
+        }
+        const schemas = this.extractResponseSchemas(responses);
+        if (schemas.length === 0) {
+            return undefined;
+        }
+        if (schemas.length === 1) {
+            return schemas[0].schema;
+        }
+        if (this.includeAllResponses) {
+            // Return union of all response schemas
+            return {
+                oneOf: schemas.map((s) => s.schema),
+                description: 'Response can be one of multiple status codes',
+            };
+        }
+        else {
+            // Return only the preferred status code
+            const preferred = this.selectPreferredSchema(schemas);
+            return preferred.schema;
+        }
+    }
+    /**
+     * Extract schemas from all responses
+     */
+    extractResponseSchemas(responses) {
+        const schemas = [];
+        for (const [statusCode, response] of Object.entries(responses)) {
+            // Skip if it's a reference object
+            if ((0, types_1.isReferenceObject)(response))
+                continue;
+            // Skip 'default' for now, we'll handle it separately
+            if (statusCode === 'default')
+                continue;
+            const code = parseInt(statusCode, 10);
+            if (isNaN(code))
+                continue;
+            const schema = this.extractResponseSchema(response, code);
+            if (schema) {
+                schemas.push(schema);
+            }
+        }
+        // Handle default response if no other schemas found
+        if (schemas.length === 0 && responses['default']) {
+            const defaultResponse = responses['default'];
+            if (!(0, types_1.isReferenceObject)(defaultResponse)) {
+                const schema = this.extractResponseSchema(defaultResponse, 0);
+                if (schema) {
+                    schemas.push(schema);
+                }
+            }
+        }
+        return schemas;
+    }
+    /**
+     * Extract schema from a single response
+     */
+    extractResponseSchema(response, statusCode) {
+        if (!response.content) {
+            // Response with no content (e.g., 204 No Content)
+            return {
+                statusCode,
+                schema: {
+                    type: 'null',
+                    description: response.description,
+                    'x-status-code': statusCode,
+                },
+            };
+        }
+        const contentType = this.selectContentType(response.content);
+        const mediaType = response.content[contentType];
+        if (!mediaType?.schema) {
+            return null;
+        }
+        const schema = {
+            ...(0, types_1.toJSONSchema7)(mediaType.schema),
+            'x-status-code': statusCode,
+        };
+        // Add description if not already present
+        if (!schema.description && response.description) {
+            schema.description = response.description;
+        }
+        // Add content type metadata
+        schema['x-content-type'] = contentType;
+        return { statusCode, schema };
+    }
+    /**
+     * Select the most appropriate content type
+     */
+    selectContentType(content) {
+        // Preference order for responses
+        const preferences = [
+            'application/json',
+            'application/hal+json',
+            'application/problem+json',
+            'application/xml',
+            'text/plain',
+            'text/html',
+        ];
+        for (const pref of preferences) {
+            if (content[pref])
+                return pref;
+        }
+        // Fallback to first available
+        return Object.keys(content)[0];
+    }
+    /**
+     * Select the preferred schema based on status code preferences
+     */
+    selectPreferredSchema(schemas) {
+        // First, try to find exact match in preferred list
+        for (const preferredCode of this.preferredStatusCodes) {
+            const found = schemas.find((s) => s.statusCode === preferredCode);
+            if (found)
+                return found;
+        }
+        // Next, try to find any 2xx response
+        const success = schemas.find((s) => s.statusCode >= 200 && s.statusCode < 300);
+        if (success)
+            return success;
+        // Next, try to find any 3xx response
+        const redirect = schemas.find((s) => s.statusCode >= 300 && s.statusCode < 400);
+        if (redirect)
+            return redirect;
+        // Fallback to first available
+        return schemas[0];
+    }
+}
+exports.ResponseBuilder = ResponseBuilder;
+//# sourceMappingURL=response-builder.js.map

package/src/response-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-builder.js","sourceRoot":"","sources":["../../src/response-builder.ts"],"names":[],"mappings":"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","sourcesContent":["import type { JSONSchema7 } from 'json-schema';\nimport type { ResponseObject, GenerateOptions, ResponsesObject } from './types';\nimport { isReferenceObject, toJSONSchema7 } from './types';\n\n/**\n * Builds output schemas from OpenAPI response definitions\n */\nexport class ResponseBuilder {\n  private preferredStatusCodes: number[];\n  private includeAllResponses: boolean;\n\n  constructor(options: GenerateOptions = {}) {\n    this.preferredStatusCodes = options.preferredStatusCodes ?? [200, 201, 204, 202, 203, 206];\n    this.includeAllResponses = options.includeAllResponses ?? true;\n  }\n\n  /**\n   * Build output schema from responses\n   */\n  build(responses?: ResponsesObject): JSONSchema7 | undefined {\n    if (!responses || Object.keys(responses).length === 0) {\n      return undefined;\n    }\n\n    const schemas = this.extractResponseSchemas(responses);\n\n    if (schemas.length === 0) {\n      return undefined;\n    }\n\n    if (schemas.length === 1) {\n      return schemas[0].schema;\n    }\n\n    if (this.includeAllResponses) {\n      // Return union of all response schemas\n      return {\n        oneOf: schemas.map((s) => s.schema),\n        description: 'Response can be one of multiple status codes',\n      };\n    } else {\n      // Return only the preferred status code\n      const preferred = this.selectPreferredSchema(schemas);\n      return preferred.schema;\n    }\n  }\n\n  /**\n   * Extract schemas from all responses\n   */\n  private extractResponseSchemas(responses: ResponsesObject): ResponseSchema[] {\n    const schemas: ResponseSchema[] = [];\n\n    for (const [statusCode, response] of Object.entries(responses)) {\n      // Skip if it's a reference object\n      if (isReferenceObject(response)) continue;\n\n      // Skip 'default' for now, we'll handle it separately\n      if (statusCode === 'default') continue;\n\n      const code = parseInt(statusCode, 10);\n      if (isNaN(code)) continue;\n\n      const schema = this.extractResponseSchema(response, code);\n      if (schema) {\n        schemas.push(schema);\n      }\n    }\n\n    // Handle default response if no other schemas found\n    if (schemas.length === 0 && responses['default']) {\n      const defaultResponse = responses['default'];\n      if (!isReferenceObject(defaultResponse)) {\n        const schema = this.extractResponseSchema(defaultResponse, 0);\n        if (schema) {\n          schemas.push(schema);\n        }\n      }\n    }\n\n    return schemas;\n  }\n\n  /**\n   * Extract schema from a single response\n   */\n  private extractResponseSchema(response: ResponseObject, statusCode: number): ResponseSchema | null {\n    if (!response.content) {\n      // Response with no content (e.g., 204 No Content)\n      return {\n        statusCode,\n        schema: {\n          type: 'null',\n          description: response.description,\n          'x-status-code': statusCode,\n        } as JSONSchema7,\n      };\n    }\n\n    const contentType = this.selectContentType(response.content);\n    const mediaType = response.content[contentType];\n\n    if (!mediaType?.schema) {\n      return null;\n    }\n\n    const schema: JSONSchema7 & { 'x-status-code'?: number } = {\n      ...toJSONSchema7(mediaType.schema),\n      'x-status-code': statusCode,\n    };\n\n    // Add description if not already present\n    if (!schema.description && response.description) {\n      schema.description = response.description;\n    }\n\n    // Add content type metadata\n    (schema as any)['x-content-type'] = contentType;\n\n    return { statusCode, schema };\n  }\n\n  /**\n   * Select the most appropriate content type\n   */\n  private selectContentType(content: Record<string, any>): string {\n    // Preference order for responses\n    const preferences = [\n      'application/json',\n      'application/hal+json',\n      'application/problem+json',\n      'application/xml',\n      'text/plain',\n      'text/html',\n    ];\n\n    for (const pref of preferences) {\n      if (content[pref]) return pref;\n    }\n\n    // Fallback to first available\n    return Object.keys(content)[0];\n  }\n\n  /**\n   * Select the preferred schema based on status code preferences\n   */\n  private selectPreferredSchema(schemas: ResponseSchema[]): ResponseSchema {\n    // First, try to find exact match in preferred list\n    for (const preferredCode of this.preferredStatusCodes) {\n      const found = schemas.find((s) => s.statusCode === preferredCode);\n      if (found) return found;\n    }\n\n    // Next, try to find any 2xx response\n    const success = schemas.find((s) => s.statusCode >= 200 && s.statusCode < 300);\n    if (success) return success;\n\n    // Next, try to find any 3xx response\n    const redirect = schemas.find((s) => s.statusCode >= 300 && s.statusCode < 400);\n    if (redirect) return redirect;\n\n    // Fallback to first available\n    return schemas[0];\n  }\n}\n\n/**\n * Internal response schema structure\n */\ninterface ResponseSchema {\n  statusCode: number;\n  schema: JSONSchema7;\n}\n"]}

package/src/schema-builder.d.ts

@@ -0,0 +1,123 @@
+import type { JSONSchema7 } from 'json-schema';
+/**
+ * Helper class for building and manipulating JSON schemas
+ */
+export declare class SchemaBuilder {
+    /**
+     * Merge multiple schemas into one
+     */
+    static merge(schemas: JSONSchema7[]): JSONSchema7;
+    /**
+     * Create a union schema (oneOf)
+     */
+    static union(schemas: JSONSchema7[]): JSONSchema7;
+    /**
+     * Deep clone a schema
+     */
+    static clone(schema: JSONSchema7): JSONSchema7;
+    /**
+     * Remove $ref from schema (assumes already dereferenced)
+     */
+    static removeRefs(schema: JSONSchema7): JSONSchema7;
+    private static removeRefsRecursive;
+    /**
+     * Add description to schema
+     */
+    static withDescription(schema: JSONSchema7, description: string): JSONSchema7;
+    /**
+     * Mark schema as required
+     */
+    static required(schema: JSONSchema7): JSONSchema7;
+    /**
+     * Mark schema as optional
+     */
+    static optional(schema: JSONSchema7): JSONSchema7;
+    /**
+     * Add example to schema
+     */
+    static withExample(schema: JSONSchema7, example: any): JSONSchema7;
+    /**
+     * Add default value to schema
+     */
+    static withDefault(schema: JSONSchema7, defaultValue: any): JSONSchema7;
+    /**
+     * Add format to schema
+     */
+    static withFormat(schema: JSONSchema7, format: string): JSONSchema7;
+    /**
+     * Add pattern to schema
+     */
+    static withPattern(schema: JSONSchema7, pattern: string): JSONSchema7;
+    /**
+     * Add enum to schema
+     */
+    static withEnum(schema: JSONSchema7, values: any[]): JSONSchema7;
+    /**
+     * Add minimum/maximum constraints
+     */
+    static withRange(schema: JSONSchema7, min?: number, max?: number, options?: {
+        exclusive?: boolean;
+    }): JSONSchema7;
+    /**
+     * Add minLength/maxLength constraints
+     */
+    static withLength(schema: JSONSchema7, minLength?: number, maxLength?: number): JSONSchema7;
+    /**
+     * Create object schema
+     */
+    static object(properties: Record<string, JSONSchema7>, required?: string[]): JSONSchema7;
+    /**
+     * Create array schema
+     */
+    static array(items: JSONSchema7, constraints?: {
+        minItems?: number;
+        maxItems?: number;
+        uniqueItems?: boolean;
+    }): JSONSchema7;
+    /**
+     * Create string schema
+     */
+    static string(constraints?: {
+        minLength?: number;
+        maxLength?: number;
+        pattern?: string;
+        format?: string;
+        enum?: string[];
+    }): JSONSchema7;
+    /**
+     * Create number schema
+     */
+    static number(constraints?: {
+        minimum?: number;
+        maximum?: number;
+        exclusiveMinimum?: number;
+        exclusiveMaximum?: number;
+        multipleOf?: number;
+    }): JSONSchema7;
+    /**
+     * Create integer schema
+     */
+    static integer(constraints?: {
+        minimum?: number;
+        maximum?: number;
+        exclusiveMinimum?: number;
+        exclusiveMaximum?: number;
+        multipleOf?: number;
+    }): JSONSchema7;
+    /**
+     * Create boolean schema
+     */
+    static boolean(): JSONSchema7;
+    /**
+     * Create null schema
+     */
+    static null(): JSONSchema7;
+    /**
+     * Flatten nested oneOf/anyOf/allOf schemas
+     */
+    static flatten(schema: JSONSchema7, maxDepth?: number): JSONSchema7;
+    /**
+     * Simplify schema by removing unnecessary fields
+     */
+    static simplify(schema: JSONSchema7): JSONSchema7;
+}