mnehmos.trace.mcp 1.0.0

package/dist/adapters/openapi/convert.d.ts

@@ -0,0 +1,120 @@
+/**
+ * 🔄 OpenAPI Type Converter
+ * Converts OpenAPI schemas to NormalizedSchema/NormalizedType
+ *
+ * This module handles the transformation of OpenAPI 3.x schema objects
+ * into the trace-mcp normalized schema format. It supports:
+ * - Primitive types (string, number, boolean, integer)
+ * - Complex types (object, array)
+ * - Composition keywords (allOf, anyOf, oneOf)
+ * - Enums and const values
+ * - Constraint extraction (min/max, patterns, formats)
+ *
+ * @module adapters/openapi/convert
+ */
+import type { OpenAPIV3 } from 'openapi-types';
+import type { NormalizedSchema, NormalizedType, Constraints, SchemaRef } from '../../core/types.js';
+/** Union type for OpenAPI schemas (either concrete or reference) */
+type OpenAPISchema = OpenAPIV3.SchemaObject | OpenAPIV3.ReferenceObject;
+/**
+ * Convert an OpenAPI schema to a NormalizedType.
+ *
+ * Handles all OpenAPI type constructs:
+ * - `$ref` → ref kind
+ * - `oneOf`/`anyOf` → union kind
+ * - `allOf` → intersection kind
+ * - `enum` → union of literals
+ * - `const` → literal kind
+ * - Primitives → primitive kind
+ * - `array` → array kind
+ * - `object` → object kind
+ *
+ * @param schema - The OpenAPI schema to convert
+ * @returns The normalized type representation
+ *
+ * @example
+ * ```typescript
+ * // Convert a string type
+ * const type = convertToNormalizedType({ type: 'string' });
+ * // { kind: 'primitive', value: 'string' }
+ *
+ * // Convert an enum
+ * const type = convertToNormalizedType({ enum: ['active', 'inactive'] });
+ * // { kind: 'union', variants: [{ kind: 'literal', value: 'active' }, ...] }
+ *
+ * // Convert an array
+ * const type = convertToNormalizedType({ type: 'array', items: { type: 'string' } });
+ * // { kind: 'array', element: { kind: 'primitive', value: 'string' } }
+ * ```
+ */
+export declare function convertToNormalizedType(schema: OpenAPISchema): NormalizedType;
+/**
+ * Extract validation constraints from an OpenAPI schema.
+ *
+ * Supports the following constraint types:
+ * - String: minLength, maxLength, pattern, format
+ * - Number: minimum, maximum
+ * - Enum: allowed values
+ *
+ * @param schema - The OpenAPI schema object to extract constraints from
+ * @returns Constraints object if any constraints found, undefined otherwise
+ *
+ * @example
+ * ```typescript
+ * const constraints = extractConstraints({
+ *   type: 'string',
+ *   minLength: 1,
+ *   maxLength: 100,
+ *   pattern: '^[a-z]+$'
+ * });
+ * // { minLength: 1, maxLength: 100, pattern: '^[a-z]+$' }
+ * ```
+ */
+export declare function extractConstraints(schema: OpenAPIV3.SchemaObject): Constraints | undefined;
+/**
+ * Convert an OpenAPI schema object to a NormalizedSchema.
+ *
+ * This is the main conversion function for object-like schemas.
+ * It extracts properties, required fields, and handles allOf merging.
+ *
+ * @param schema - The OpenAPI schema object to convert
+ * @param source - The SchemaRef identifying the source
+ * @param name - Optional name for the schema
+ * @returns The normalized schema representation
+ *
+ * @example
+ * ```typescript
+ * const schema = convertToNormalizedSchema({
+ *   type: 'object',
+ *   required: ['id', 'name'],
+ *   properties: {
+ *     id: { type: 'integer' },
+ *     name: { type: 'string' },
+ *     email: { type: 'string', format: 'email' }
+ *   }
+ * }, { source: 'openapi', id: 'schema:User@./api.yaml' }, 'User');
+ * ```
+ */
+export declare function convertToNormalizedSchema(schema: OpenAPIV3.SchemaObject, source: SchemaRef, name?: string): NormalizedSchema;
+/**
+ * Convert an array of OpenAPI parameters to a NormalizedSchema.
+ *
+ * This handles path, query, and header parameters, converting
+ * each to a property in the resulting schema.
+ *
+ * @param parameters - Array of OpenAPI parameter objects
+ * @param source - The SchemaRef identifying the source
+ * @returns A normalized schema with parameters as properties
+ *
+ * @example
+ * ```typescript
+ * const schema = convertParametersToSchema([
+ *   { name: 'id', in: 'path', required: true, schema: { type: 'integer' } },
+ *   { name: 'limit', in: 'query', required: false, schema: { type: 'integer' } }
+ * ], ref);
+ * // Properties: { id: { type: number, optional: false }, limit: { type: number, optional: true } }
+ * ```
+ */
+export declare function convertParametersToSchema(parameters: OpenAPIV3.ParameterObject[], source: SchemaRef): NormalizedSchema;
+export {};
+//# sourceMappingURL=convert.d.ts.map

package/dist/adapters/openapi/convert.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"convert.d.ts","sourceRoot":"","sources":["../../../src/adapters/openapi/convert.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,KAAK,EACV,gBAAgB,EAChB,cAAc,EAEd,WAAW,EACX,SAAS,EACV,MAAM,qBAAqB,CAAC;AAE7B,oEAAoE;AACpE,KAAK,aAAa,GAAG,SAAS,CAAC,YAAY,GAAG,SAAS,CAAC,eAAe,CAAC;AAYxE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,aAAa,GAAG,cAAc,CAuE7E;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,CAAC,YAAY,GAAG,WAAW,GAAG,SAAS,CA2C1F;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,SAAS,CAAC,YAAY,EAC9B,MAAM,EAAE,SAAS,EACjB,IAAI,CAAC,EAAE,MAAM,GACZ,gBAAgB,CAmElB;AAwCD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,yBAAyB,CACvC,UAAU,EAAE,SAAS,CAAC,eAAe,EAAE,EACvC,MAAM,EAAE,SAAS,GAChB,gBAAgB,CAsDlB"}

package/dist/adapters/openapi/convert.js

@@ -0,0 +1,363 @@
+/**
+ * 🔄 OpenAPI Type Converter
+ * Converts OpenAPI schemas to NormalizedSchema/NormalizedType
+ *
+ * This module handles the transformation of OpenAPI 3.x schema objects
+ * into the trace-mcp normalized schema format. It supports:
+ * - Primitive types (string, number, boolean, integer)
+ * - Complex types (object, array)
+ * - Composition keywords (allOf, anyOf, oneOf)
+ * - Enums and const values
+ * - Constraint extraction (min/max, patterns, formats)
+ *
+ * @module adapters/openapi/convert
+ */
+/**
+ * Type guard to check if a schema is a $ref reference object.
+ *
+ * @param schema - The schema to check
+ * @returns True if the schema is a reference object
+ */
+function isRefObject(schema) {
+    return '$ref' in schema;
+}
+/**
+ * Convert an OpenAPI schema to a NormalizedType.
+ *
+ * Handles all OpenAPI type constructs:
+ * - `$ref` → ref kind
+ * - `oneOf`/`anyOf` → union kind
+ * - `allOf` → intersection kind
+ * - `enum` → union of literals
+ * - `const` → literal kind
+ * - Primitives → primitive kind
+ * - `array` → array kind
+ * - `object` → object kind
+ *
+ * @param schema - The OpenAPI schema to convert
+ * @returns The normalized type representation
+ *
+ * @example
+ * ```typescript
+ * // Convert a string type
+ * const type = convertToNormalizedType({ type: 'string' });
+ * // { kind: 'primitive', value: 'string' }
+ *
+ * // Convert an enum
+ * const type = convertToNormalizedType({ enum: ['active', 'inactive'] });
+ * // { kind: 'union', variants: [{ kind: 'literal', value: 'active' }, ...] }
+ *
+ * // Convert an array
+ * const type = convertToNormalizedType({ type: 'array', items: { type: 'string' } });
+ * // { kind: 'array', element: { kind: 'primitive', value: 'string' } }
+ * ```
+ */
+export function convertToNormalizedType(schema) {
+    // Handle $ref (circular references that weren't dereferenced)
+    if (isRefObject(schema)) {
+        const name = schema.$ref.split('/').pop() || 'Unknown';
+        return { kind: 'ref', name };
+    }
+    // Handle composition keywords first (oneOf, anyOf, allOf)
+    if (schema.oneOf) {
+        const variants = schema.oneOf.map(s => convertToNormalizedType(s));
+        return { kind: 'union', variants };
+    }
+    if (schema.anyOf) {
+        const variants = schema.anyOf.map(s => convertToNormalizedType(s));
+        return { kind: 'union', variants };
+    }
+    if (schema.allOf) {
+        const members = schema.allOf.map(s => convertToNormalizedType(s));
+        return { kind: 'intersection', members };
+    }
+    // Handle enum (before primitive types)
+    if (schema.enum && Array.isArray(schema.enum)) {
+        return {
+            kind: 'union',
+            variants: schema.enum.map(v => ({
+                kind: 'literal',
+                value: v,
+            })),
+        };
+    }
+    // Handle const
+    if ('const' in schema && schema.const !== undefined) {
+        return { kind: 'literal', value: schema.const };
+    }
+    // Handle by OpenAPI type keyword
+    switch (schema.type) {
+        case 'string':
+            return { kind: 'primitive', value: 'string' };
+        case 'boolean':
+            return { kind: 'primitive', value: 'boolean' };
+        case 'integer':
+        case 'number':
+            return { kind: 'primitive', value: 'number' };
+        case 'array': {
+            const element = schema.items
+                ? convertToNormalizedType(schema.items)
+                : { kind: 'unknown' };
+            return { kind: 'array', element };
+        }
+        case 'object': {
+            const nestedSchema = convertToNormalizedSchema(schema, { source: 'openapi', id: '' });
+            return { kind: 'object', schema: nestedSchema };
+        }
+        default:
+            // No type specified - check if has properties (implicit object)
+            if (schema.properties) {
+                const nestedSchema = convertToNormalizedSchema(schema, { source: 'openapi', id: '' });
+                return { kind: 'object', schema: nestedSchema };
+            }
+            return { kind: 'any' };
+    }
+}
+/**
+ * Extract validation constraints from an OpenAPI schema.
+ *
+ * Supports the following constraint types:
+ * - String: minLength, maxLength, pattern, format
+ * - Number: minimum, maximum
+ * - Enum: allowed values
+ *
+ * @param schema - The OpenAPI schema object to extract constraints from
+ * @returns Constraints object if any constraints found, undefined otherwise
+ *
+ * @example
+ * ```typescript
+ * const constraints = extractConstraints({
+ *   type: 'string',
+ *   minLength: 1,
+ *   maxLength: 100,
+ *   pattern: '^[a-z]+$'
+ * });
+ * // { minLength: 1, maxLength: 100, pattern: '^[a-z]+$' }
+ * ```
+ */
+export function extractConstraints(schema) {
+    const constraints = {};
+    let hasConstraints = false;
+    // String constraints
+    if (schema.minLength !== undefined) {
+        constraints.minLength = schema.minLength;
+        hasConstraints = true;
+    }
+    if (schema.maxLength !== undefined) {
+        constraints.maxLength = schema.maxLength;
+        hasConstraints = true;
+    }
+    if (schema.pattern !== undefined) {
+        constraints.pattern = schema.pattern;
+        hasConstraints = true;
+    }
+    if (schema.format !== undefined) {
+        constraints.format = schema.format;
+        hasConstraints = true;
+    }
+    // Number constraints
+    if (schema.minimum !== undefined) {
+        constraints.minimum = schema.minimum;
+        hasConstraints = true;
+    }
+    if (schema.maximum !== undefined) {
+        constraints.maximum = schema.maximum;
+        hasConstraints = true;
+    }
+    // Enum constraint
+    if (schema.enum !== undefined) {
+        constraints.enum = schema.enum;
+        hasConstraints = true;
+    }
+    return hasConstraints ? constraints : undefined;
+}
+/**
+ * Convert an OpenAPI schema object to a NormalizedSchema.
+ *
+ * This is the main conversion function for object-like schemas.
+ * It extracts properties, required fields, and handles allOf merging.
+ *
+ * @param schema - The OpenAPI schema object to convert
+ * @param source - The SchemaRef identifying the source
+ * @param name - Optional name for the schema
+ * @returns The normalized schema representation
+ *
+ * @example
+ * ```typescript
+ * const schema = convertToNormalizedSchema({
+ *   type: 'object',
+ *   required: ['id', 'name'],
+ *   properties: {
+ *     id: { type: 'integer' },
+ *     name: { type: 'string' },
+ *     email: { type: 'string', format: 'email' }
+ *   }
+ * }, { source: 'openapi', id: 'schema:User@./api.yaml' }, 'User');
+ * ```
+ */
+export function convertToNormalizedSchema(schema, source, name) {
+    const properties = {};
+    const required = schema.required || [];
+    // Handle allOf by merging all constituent schemas
+    if (schema.allOf) {
+        const merged = mergeAllOfSchemas(schema.allOf);
+        return convertToNormalizedSchema(merged, source, name);
+    }
+    // Extract and convert properties
+    if (schema.properties) {
+        for (const [propName, propSchema] of Object.entries(schema.properties)) {
+            const prop = propSchema;
+            const isRequired = required.includes(propName);
+            if (isRefObject(prop)) {
+                // Handle $ref properties
+                const refName = prop.$ref.split('/').pop() || 'Unknown';
+                properties[propName] = {
+                    type: { kind: 'ref', name: refName },
+                    optional: !isRequired,
+                    nullable: false,
+                    readonly: false,
+                    deprecated: false,
+                };
+            }
+            else {
+                // Handle concrete schema properties
+                const isNullable = prop.nullable === true;
+                const isDeprecated = prop.deprecated === true;
+                const isReadonly = prop.readOnly === true;
+                const description = prop.description;
+                const constraints = extractConstraints(prop);
+                properties[propName] = {
+                    type: convertToNormalizedType(prop),
+                    optional: !isRequired,
+                    nullable: isNullable,
+                    readonly: isReadonly,
+                    deprecated: isDeprecated,
+                    description,
+                    constraints,
+                };
+            }
+        }
+    }
+    const result = {
+        properties,
+        required,
+        source,
+    };
+    if (name) {
+        result.name = name;
+    }
+    // Handle additionalProperties
+    if (schema.additionalProperties !== undefined) {
+        if (typeof schema.additionalProperties === 'boolean') {
+            result.additionalProperties = schema.additionalProperties;
+        }
+        else {
+            result.additionalProperties = convertToNormalizedType(schema.additionalProperties);
+        }
+    }
+    return result;
+}
+/**
+ * Merge allOf schemas into a single combined schema object.
+ *
+ * This function flattens allOf arrays by combining properties
+ * and required arrays from all constituent schemas.
+ *
+ * @param allOf - Array of schemas to merge
+ * @returns A single merged schema object
+ *
+ * @internal
+ */
+function mergeAllOfSchemas(allOf) {
+    const merged = {
+        type: 'object',
+        properties: {},
+        required: [],
+    };
+    for (const schema of allOf) {
+        if (isRefObject(schema)) {
+            // Skip refs in merge - they should be dereferenced already
+            continue;
+        }
+        // Merge properties
+        if (schema.properties) {
+            merged.properties = { ...merged.properties, ...schema.properties };
+        }
+        // Merge required arrays
+        if (schema.required) {
+            merged.required = [...(merged.required || []), ...schema.required];
+        }
+    }
+    return merged;
+}
+/**
+ * Convert an array of OpenAPI parameters to a NormalizedSchema.
+ *
+ * This handles path, query, and header parameters, converting
+ * each to a property in the resulting schema.
+ *
+ * @param parameters - Array of OpenAPI parameter objects
+ * @param source - The SchemaRef identifying the source
+ * @returns A normalized schema with parameters as properties
+ *
+ * @example
+ * ```typescript
+ * const schema = convertParametersToSchema([
+ *   { name: 'id', in: 'path', required: true, schema: { type: 'integer' } },
+ *   { name: 'limit', in: 'query', required: false, schema: { type: 'integer' } }
+ * ], ref);
+ * // Properties: { id: { type: number, optional: false }, limit: { type: number, optional: true } }
+ * ```
+ */
+export function convertParametersToSchema(parameters, source) {
+    const properties = {};
+    const required = [];
+    for (const param of parameters) {
+        const paramSchema = param.schema;
+        if (!paramSchema) {
+            // Parameter without schema - treat as any
+            properties[param.name] = {
+                type: { kind: 'any' },
+                optional: !param.required,
+                nullable: false,
+                readonly: false,
+                deprecated: param.deprecated || false,
+                description: param.description,
+            };
+            continue;
+        }
+        if (isRefObject(paramSchema)) {
+            // Handle $ref parameters
+            const refName = paramSchema.$ref.split('/').pop() || 'Unknown';
+            properties[param.name] = {
+                type: { kind: 'ref', name: refName },
+                optional: !param.required,
+                nullable: false,
+                readonly: false,
+                deprecated: param.deprecated || false,
+                description: param.description,
+            };
+        }
+        else {
+            // Handle concrete schema parameters
+            properties[param.name] = {
+                type: convertToNormalizedType(paramSchema),
+                optional: !param.required,
+                nullable: paramSchema.nullable || false,
+                readonly: paramSchema.readOnly || false,
+                deprecated: param.deprecated || false,
+                description: param.description,
+                constraints: extractConstraints(paramSchema),
+            };
+        }
+        if (param.required) {
+            required.push(param.name);
+        }
+    }
+    return {
+        properties,
+        required,
+        source,
+    };
+}
+//# sourceMappingURL=convert.js.map

package/dist/adapters/openapi/convert.js.map

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

package/dist/adapters/openapi/index.d.ts

@@ -0,0 +1,39 @@
+/**
+ * 📋 OpenAPI Schema Adapter
+ * Extracts schemas from OpenAPI 3.x / Swagger specifications
+ *
+ * This module provides a complete adapter for working with OpenAPI
+ * specifications in the trace-mcp schema extraction framework.
+ *
+ * ## Features
+ * - 📄 Parse OpenAPI 3.x specifications
+ * - 🔗 Reference ID parsing and building
+ * - 🔄 Type conversion to normalized format
+ * - 📊 Constraint extraction (validation rules)
+ * - 🗂️ Endpoint and component schema extraction
+ *
+ * ## Usage
+ * ```typescript
+ * import { OpenAPIAdapter, parseOpenAPIRef } from '@trace-mcp/adapters/openapi';
+ * import { registerAdapter } from '@trace-mcp/adapters/registry';
+ *
+ * // Register the adapter
+ * registerAdapter(new OpenAPIAdapter());
+ *
+ * // Parse a ref ID
+ * const ref = parseOpenAPIRef('endpoint:GET:/users@./api.yaml');
+ *
+ * // Extract a schema
+ * const adapter = new OpenAPIAdapter();
+ * const schema = await adapter.extract({
+ *   source: 'openapi',
+ *   id: 'schema:User@./api.yaml'
+ * });
+ * ```
+ *
+ * @module adapters/openapi
+ */
+export { OpenAPIAdapter } from './adapter.js';
+export { parseOpenAPIRef, buildOpenAPIRefId, type OpenAPIRef } from './parser.js';
+export { convertToNormalizedSchema, convertToNormalizedType, convertParametersToSchema, extractConstraints, } from './convert.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/adapters/openapi/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/adapters/openapi/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAMH,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAM9C,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAMlF,OAAO,EACL,yBAAyB,EACzB,uBAAuB,EACvB,yBAAyB,EACzB,kBAAkB,GACnB,MAAM,cAAc,CAAC"}

package/dist/adapters/openapi/index.js

@@ -0,0 +1,48 @@
+/**
+ * 📋 OpenAPI Schema Adapter
+ * Extracts schemas from OpenAPI 3.x / Swagger specifications
+ *
+ * This module provides a complete adapter for working with OpenAPI
+ * specifications in the trace-mcp schema extraction framework.
+ *
+ * ## Features
+ * - 📄 Parse OpenAPI 3.x specifications
+ * - 🔗 Reference ID parsing and building
+ * - 🔄 Type conversion to normalized format
+ * - 📊 Constraint extraction (validation rules)
+ * - 🗂️ Endpoint and component schema extraction
+ *
+ * ## Usage
+ * ```typescript
+ * import { OpenAPIAdapter, parseOpenAPIRef } from '@trace-mcp/adapters/openapi';
+ * import { registerAdapter } from '@trace-mcp/adapters/registry';
+ *
+ * // Register the adapter
+ * registerAdapter(new OpenAPIAdapter());
+ *
+ * // Parse a ref ID
+ * const ref = parseOpenAPIRef('endpoint:GET:/users@./api.yaml');
+ *
+ * // Extract a schema
+ * const adapter = new OpenAPIAdapter();
+ * const schema = await adapter.extract({
+ *   source: 'openapi',
+ *   id: 'schema:User@./api.yaml'
+ * });
+ * ```
+ *
+ * @module adapters/openapi
+ */
+// ============================================================================
+// Main Adapter
+// ============================================================================
+export { OpenAPIAdapter } from './adapter.js';
+// ============================================================================
+// Parser Utilities
+// ============================================================================
+export { parseOpenAPIRef, buildOpenAPIRefId } from './parser.js';
+// ============================================================================
+// Conversion Utilities
+// ============================================================================
+export { convertToNormalizedSchema, convertToNormalizedType, convertParametersToSchema, extractConstraints, } from './convert.js';
+//# sourceMappingURL=index.js.map

package/dist/adapters/openapi/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/adapters/openapi/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,+EAA+E;AAC/E,eAAe;AACf,+EAA+E;AAE/E,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C,+EAA+E;AAC/E,mBAAmB;AACnB,+EAA+E;AAE/E,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAmB,MAAM,aAAa,CAAC;AAElF,+EAA+E;AAC/E,uBAAuB;AACvB,+EAA+E;AAE/E,OAAO,EACL,yBAAyB,EACzB,uBAAuB,EACvB,yBAAyB,EACzB,kBAAkB,GACnB,MAAM,cAAc,CAAC"}