mcp-from-openapi 2.1.0 → 2.1.2

package/src/schema-builder.js

@@ -1,291 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.SchemaBuilder = void 0;
-/**
- * Helper class for building and manipulating JSON schemas
- */
-class SchemaBuilder {
-    /**
-     * Merge multiple schemas into one
-     */
-    static merge(schemas) {
-        if (schemas.length === 0) {
-            return { type: 'object' };
-        }
-        if (schemas.length === 1) {
-            return schemas[0];
-        }
-        const merged = {
-            type: 'object',
-            properties: {},
-            required: [],
-        };
-        const allRequired = new Set();
-        for (const schema of schemas) {
-            if (schema.properties) {
-                merged.properties = {
-                    ...merged.properties,
-                    ...schema.properties,
-                };
-            }
-            if (schema.required) {
-                schema.required.forEach((field) => allRequired.add(field));
-            }
-        }
-        if (allRequired.size > 0) {
-            merged.required = Array.from(allRequired);
-        }
-        return merged;
-    }
-    /**
-     * Create a union schema (oneOf)
-     */
-    static union(schemas) {
-        if (schemas.length === 0) {
-            return {};
-        }
-        if (schemas.length === 1) {
-            return schemas[0];
-        }
-        return {
-            oneOf: schemas,
-        };
-    }
-    /**
-     * Deep clone a schema
-     */
-    static clone(schema) {
-        return JSON.parse(JSON.stringify(schema));
-    }
-    /**
-     * Remove $ref from schema (assumes already dereferenced)
-     */
-    static removeRefs(schema) {
-        const cloned = this.clone(schema);
-        this.removeRefsRecursive(cloned);
-        return cloned;
-    }
-    static removeRefsRecursive(obj) {
-        if (!obj || typeof obj !== 'object')
-            return;
-        if (obj.$ref) {
-            delete obj.$ref;
-        }
-        for (const key in obj) {
-            if (key in obj) {
-                const value = obj[key];
-                if (value && typeof value === 'object') {
-                    this.removeRefsRecursive(value);
-                }
-            }
-        }
-    }
-    /**
-     * Add description to schema
-     */
-    static withDescription(schema, description) {
-        return {
-            ...schema,
-            description,
-        };
-    }
-    /**
-     * Add example to schema
-     */
-    static withExample(schema, example) {
-        const existingExamples = Array.isArray(schema.examples) ? schema.examples : [];
-        return {
-            ...schema,
-            examples: [...existingExamples, example],
-        };
-    }
-    /**
-     * Add default value to schema
-     */
-    static withDefault(schema, defaultValue) {
-        return {
-            ...schema,
-            default: defaultValue,
-        };
-    }
-    /**
-     * Add format to schema
-     */
-    static withFormat(schema, format) {
-        return {
-            ...schema,
-            format,
-        };
-    }
-    /**
-     * Add pattern to schema
-     */
-    static withPattern(schema, pattern) {
-        return {
-            ...schema,
-            pattern,
-        };
-    }
-    /**
-     * Add enum to schema
-     */
-    static withEnum(schema, values) {
-        return {
-            ...schema,
-            enum: values,
-        };
-    }
-    /**
-     * Add minimum/maximum constraints
-     */
-    static withRange(schema, min, max, options = {}) {
-        const result = { ...schema };
-        if (min !== undefined) {
-            if (options.exclusive) {
-                result.exclusiveMinimum = min;
-            }
-            else {
-                result.minimum = min;
-            }
-        }
-        if (max !== undefined) {
-            if (options.exclusive) {
-                result.exclusiveMaximum = max;
-            }
-            else {
-                result.maximum = max;
-            }
-        }
-        return result;
-    }
-    /**
-     * Add minLength/maxLength constraints
-     */
-    static withLength(schema, minLength, maxLength) {
-        const result = { ...schema };
-        if (minLength !== undefined) {
-            result.minLength = minLength;
-        }
-        if (maxLength !== undefined) {
-            result.maxLength = maxLength;
-        }
-        return result;
-    }
-    /**
-     * Create object schema
-     */
-    static object(properties, required) {
-        return {
-            type: 'object',
-            properties,
-            ...(required && required.length > 0 && { required }),
-            additionalProperties: false,
-        };
-    }
-    /**
-     * Create array schema
-     */
-    static array(items, constraints) {
-        return {
-            type: 'array',
-            items,
-            ...constraints,
-        };
-    }
-    /**
-     * Create string schema
-     */
-    static string(constraints) {
-        return {
-            type: 'string',
-            ...constraints,
-        };
-    }
-    /**
-     * Create number schema
-     */
-    static number(constraints) {
-        return {
-            type: 'number',
-            ...constraints,
-        };
-    }
-    /**
-     * Create integer schema
-     */
-    static integer(constraints) {
-        return {
-            type: 'integer',
-            ...constraints,
-        };
-    }
-    /**
-     * Create boolean schema
-     */
-    static boolean() {
-        return {
-            type: 'boolean',
-        };
-    }
-    /**
-     * Create null schema
-     */
-    static null() {
-        return {
-            type: 'null',
-        };
-    }
-    /**
-     * Flatten nested oneOf/anyOf/allOf schemas
-     */
-    static flatten(schema, maxDepth = 10) {
-        if (maxDepth <= 0)
-            return schema;
-        const cloned = this.clone(schema);
-        if (cloned.oneOf) {
-            const flattened = cloned.oneOf.flatMap((s) => {
-                const sub = this.flatten(s, maxDepth - 1);
-                return sub.oneOf ? sub.oneOf : [sub];
-            });
-            cloned.oneOf = flattened;
-        }
-        if (cloned.anyOf) {
-            const flattened = cloned.anyOf.flatMap((s) => {
-                const sub = this.flatten(s, maxDepth - 1);
-                return sub.anyOf ? sub.anyOf : [sub];
-            });
-            cloned.anyOf = flattened;
-        }
-        if (cloned.allOf) {
-            const flattened = cloned.allOf.flatMap((s) => {
-                const sub = this.flatten(s, maxDepth - 1);
-                return sub.allOf ? sub.allOf : [sub];
-            });
-            cloned.allOf = flattened;
-        }
-        return cloned;
-    }
-    /**
-     * Simplify schema by removing unnecessary fields
-     */
-    static simplify(schema) {
-        const cloned = this.clone(schema);
-        // Remove empty arrays/objects
-        if (Array.isArray(cloned.required) && cloned.required.length === 0) {
-            delete cloned.required;
-        }
-        if (cloned.properties && Object.keys(cloned.properties).length === 0) {
-            delete cloned.properties;
-        }
-        if (Array.isArray(cloned.examples) && cloned.examples.length === 0) {
-            delete cloned.examples;
-        }
-        // Remove title if it matches description
-        if (cloned.title && cloned.description && cloned.title === cloned.description) {
-            delete cloned.title;
-        }
-        return cloned;
-    }
-}
-exports.SchemaBuilder = SchemaBuilder;
-//# sourceMappingURL=schema-builder.js.map

package/src/schema-builder.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"schema-builder.js","sourceRoot":"","sources":["../../src/schema-builder.ts"],"names":[],"mappings":"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","sourcesContent":["import type { JSONSchema } from 'zod/v4/core';\n\n/** JSON Schema type from Zod v4 */\ntype JsonSchema = JSONSchema.JSONSchema;\n\n/**\n * Helper class for building and manipulating JSON schemas\n */\nexport class SchemaBuilder {\n  /**\n   * Merge multiple schemas into one\n   */\n  static merge(schemas: JsonSchema[]): JsonSchema {\n    if (schemas.length === 0) {\n      return { type: 'object' };\n    }\n\n    if (schemas.length === 1) {\n      return schemas[0];\n    }\n\n    const merged: JsonSchema = {\n      type: 'object',\n      properties: {},\n      required: [],\n    };\n\n    const allRequired = new Set<string>();\n\n    for (const schema of schemas) {\n      if (schema.properties) {\n        merged.properties = {\n          ...merged.properties,\n          ...schema.properties,\n        };\n      }\n\n      if (schema.required) {\n        schema.required.forEach((field) => allRequired.add(field));\n      }\n    }\n\n    if (allRequired.size > 0) {\n      merged.required = Array.from(allRequired);\n    }\n\n    return merged;\n  }\n\n  /**\n   * Create a union schema (oneOf)\n   */\n  static union(schemas: JsonSchema[]): JsonSchema {\n    if (schemas.length === 0) {\n      return {};\n    }\n\n    if (schemas.length === 1) {\n      return schemas[0];\n    }\n\n    return {\n      oneOf: schemas,\n    };\n  }\n\n  /**\n   * Deep clone a schema\n   */\n  static clone(schema: JsonSchema): JsonSchema {\n    return JSON.parse(JSON.stringify(schema));\n  }\n\n  /**\n   * Remove $ref from schema (assumes already dereferenced)\n   */\n  static removeRefs(schema: JsonSchema): JsonSchema {\n    const cloned = this.clone(schema);\n    this.removeRefsRecursive(cloned);\n    return cloned;\n  }\n\n  private static removeRefsRecursive(obj: any): void {\n    if (!obj || typeof obj !== 'object') return;\n\n    if (obj.$ref) {\n      delete obj.$ref;\n    }\n\n    for (const key in obj) {\n      if (key in obj) {\n        const value = obj[key];\n        if (value && typeof value === 'object') {\n          this.removeRefsRecursive(value);\n        }\n      }\n    }\n  }\n\n  /**\n   * Add description to schema\n   */\n  static withDescription(schema: JsonSchema, description: string): JsonSchema {\n    return {\n      ...schema,\n      description,\n    };\n  }\n\n  /**\n   * Add example to schema\n   */\n  static withExample(schema: JsonSchema, example: any): JsonSchema {\n    const existingExamples = Array.isArray(schema.examples) ? schema.examples : [];\n    return {\n      ...schema,\n      examples: [...existingExamples, example],\n    };\n  }\n\n  /**\n   * Add default value to schema\n   */\n  static withDefault(schema: JsonSchema, defaultValue: any): JsonSchema {\n    return {\n      ...schema,\n      default: defaultValue,\n    };\n  }\n\n  /**\n   * Add format to schema\n   */\n  static withFormat(schema: JsonSchema, format: string): JsonSchema {\n    return {\n      ...schema,\n      format,\n    };\n  }\n\n  /**\n   * Add pattern to schema\n   */\n  static withPattern(schema: JsonSchema, pattern: string): JsonSchema {\n    return {\n      ...schema,\n      pattern,\n    };\n  }\n\n  /**\n   * Add enum to schema\n   */\n  static withEnum(schema: JsonSchema, values: any[]): JsonSchema {\n    return {\n      ...schema,\n      enum: values,\n    };\n  }\n\n  /**\n   * Add minimum/maximum constraints\n   */\n  static withRange(schema: JsonSchema, min?: number, max?: number, options: { exclusive?: boolean } = {}): JsonSchema {\n    const result = { ...schema };\n\n    if (min !== undefined) {\n      if (options.exclusive) {\n        result.exclusiveMinimum = min;\n      } else {\n        result.minimum = min;\n      }\n    }\n\n    if (max !== undefined) {\n      if (options.exclusive) {\n        result.exclusiveMaximum = max;\n      } else {\n        result.maximum = max;\n      }\n    }\n\n    return result;\n  }\n\n  /**\n   * Add minLength/maxLength constraints\n   */\n  static withLength(schema: JsonSchema, minLength?: number, maxLength?: number): JsonSchema {\n    const result = { ...schema };\n\n    if (minLength !== undefined) {\n      result.minLength = minLength;\n    }\n\n    if (maxLength !== undefined) {\n      result.maxLength = maxLength;\n    }\n\n    return result;\n  }\n\n  /**\n   * Create object schema\n   */\n  static object(properties: Record<string, JsonSchema>, required?: string[]): JsonSchema {\n    return {\n      type: 'object',\n      properties,\n      ...(required && required.length > 0 && { required }),\n      additionalProperties: false,\n    };\n  }\n\n  /**\n   * Create array schema\n   */\n  static array(\n    items: JsonSchema,\n    constraints?: {\n      minItems?: number;\n      maxItems?: number;\n      uniqueItems?: boolean;\n    },\n  ): JsonSchema {\n    return {\n      type: 'array',\n      items,\n      ...constraints,\n    };\n  }\n\n  /**\n   * Create string schema\n   */\n  static string(constraints?: {\n    minLength?: number;\n    maxLength?: number;\n    pattern?: string;\n    format?: string;\n    enum?: string[];\n  }): JsonSchema {\n    return {\n      type: 'string',\n      ...constraints,\n    };\n  }\n\n  /**\n   * Create number schema\n   */\n  static number(constraints?: {\n    minimum?: number;\n    maximum?: number;\n    exclusiveMinimum?: number;\n    exclusiveMaximum?: number;\n    multipleOf?: number;\n  }): JsonSchema {\n    return {\n      type: 'number',\n      ...constraints,\n    };\n  }\n\n  /**\n   * Create integer schema\n   */\n  static integer(constraints?: {\n    minimum?: number;\n    maximum?: number;\n    exclusiveMinimum?: number;\n    exclusiveMaximum?: number;\n    multipleOf?: number;\n  }): JsonSchema {\n    return {\n      type: 'integer',\n      ...constraints,\n    };\n  }\n\n  /**\n   * Create boolean schema\n   */\n  static boolean(): JsonSchema {\n    return {\n      type: 'boolean',\n    };\n  }\n\n  /**\n   * Create null schema\n   */\n  static null(): JsonSchema {\n    return {\n      type: 'null',\n    };\n  }\n\n  /**\n   * Flatten nested oneOf/anyOf/allOf schemas\n   */\n  static flatten(schema: JsonSchema, maxDepth = 10): JsonSchema {\n    if (maxDepth <= 0) return schema;\n\n    const cloned = this.clone(schema);\n\n    if (cloned.oneOf) {\n      const flattened = cloned.oneOf.flatMap((s) => {\n        const sub = this.flatten(s as JsonSchema, maxDepth - 1);\n        return sub.oneOf ? sub.oneOf : [sub];\n      });\n      cloned.oneOf = flattened as JsonSchema[];\n    }\n\n    if (cloned.anyOf) {\n      const flattened = cloned.anyOf.flatMap((s) => {\n        const sub = this.flatten(s as JsonSchema, maxDepth - 1);\n        return sub.anyOf ? sub.anyOf : [sub];\n      });\n      cloned.anyOf = flattened as JsonSchema[];\n    }\n\n    if (cloned.allOf) {\n      const flattened = cloned.allOf.flatMap((s) => {\n        const sub = this.flatten(s as JsonSchema, maxDepth - 1);\n        return sub.allOf ? sub.allOf : [sub];\n      });\n      cloned.allOf = flattened as JsonSchema[];\n    }\n\n    return cloned;\n  }\n\n  /**\n   * Simplify schema by removing unnecessary fields\n   */\n  static simplify(schema: JsonSchema): JsonSchema {\n    const cloned = this.clone(schema);\n\n    // Remove empty arrays/objects\n    if (Array.isArray(cloned.required) && cloned.required.length === 0) {\n      delete cloned.required;\n    }\n\n    if (cloned.properties && Object.keys(cloned.properties).length === 0) {\n      delete cloned.properties;\n    }\n\n    if (Array.isArray(cloned.examples) && cloned.examples.length === 0) {\n      delete cloned.examples;\n    }\n\n    // Remove title if it matches description\n    if (cloned.title && cloned.description && cloned.title === cloned.description) {\n      delete cloned.title;\n    }\n\n    return cloned;\n  }\n}\n"]}

package/src/security-resolver.js

@@ -1,324 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.SecurityResolver = void 0;
-exports.createSecurityContext = createSecurityContext;
-/**
- * Security resolver that maps OpenAPI security requirements to actual auth values
- *
- * This helper handles security parameters from any OpenAPI spec, regardless of
- * custom naming (BearerAuth, JWT, Authorization, etc.). It uses the mapper's
- * security metadata to determine the auth type and format.
- *
- * @example
- * ```typescript
- * // In FrontMCP
- * const resolver = new SecurityResolver();
- * const resolved = resolver.resolve(tool.mapper, {
- *   jwt: context.authInfo.jwt,
- *   apiKey: process.env.API_KEY
- * });
- *
- * // Use resolved.headers in HTTP request
- * fetch(url, { headers: { ...resolved.headers, ...otherHeaders } });
- * ```
- *
- * @example
- * ```typescript
- * // Custom resolver for framework-specific auth
- * const resolved = resolver.resolve(tool.mapper, {
- *   customResolver: (security) => {
- *     if (security.type === 'http' && security.httpScheme === 'bearer') {
- *       return myFramework.getAuthToken();
- *     }
- *     return undefined;
- *   }
- * });
- * ```
- */
-class SecurityResolver {
-    /**
-     * Resolve security parameters from mapper entries
-     *
-     * @param mappers - Parameter mappers from the tool definition
-     * @param context - Security context with auth values or custom resolver
-     * @returns Resolved headers, query params, and cookies with auth applied
-     */
-    async resolve(mappers, context) {
-        const resolved = {
-            headers: {},
-            query: {},
-            cookies: {},
-        };
-        // Add client certificate if available (for mTLS)
-        if (context.clientCertificate) {
-            resolved.clientCertificate = context.clientCertificate;
-        }
-        // Check if signature-based auth is needed
-        let requiresSignature = false;
-        let signatureScheme;
-        for (const mapper of mappers) {
-            // Skip non-security parameters
-            if (!mapper.security) {
-                continue;
-            }
-            // Check for signature-based auth
-            if (this.isSignatureBasedAuth(mapper.security)) {
-                requiresSignature = true;
-                signatureScheme = mapper.security.scheme;
-                // Signature will be added later by signRequest()
-                continue;
-            }
-            // Try to resolve the auth value
-            const authValue = await this.resolveAuthValue(mapper.security, context);
-            if (!authValue) {
-                // Auth value not available - skip this security requirement
-                // Framework may want to throw an error or log a warning
-                continue;
-            }
-            // Apply to the correct location
-            const headerName = mapper.key;
-            if (mapper.type === 'header') {
-                resolved.headers[headerName] = authValue;
-            }
-            else if (mapper.type === 'query') {
-                resolved.query[headerName] = authValue;
-            }
-            else if (mapper.type === 'cookie') {
-                resolved.cookies[headerName] = authValue;
-            }
-        }
-        // Add context cookies if available
-        if (context.cookies) {
-            resolved.cookies = { ...resolved.cookies, ...context.cookies };
-        }
-        // Add signature metadata if needed
-        if (requiresSignature) {
-            resolved.requiresSignature = true;
-            resolved.signatureInfo = {
-                scheme: signatureScheme || 'unknown',
-            };
-        }
-        return resolved;
-    }
-    /**
-     * Check if security scheme requires request signing
-     */
-    isSignatureBasedAuth(security) {
-        // Check for schemes that typically require signing
-        const signatureSchemes = ['aws4', 'hmac', 'signature', 'hawk', 'custom-signature'];
-        return signatureSchemes.some(scheme => security.scheme.toLowerCase().includes(scheme));
-    }
-    /**
-     * Resolve the actual auth value based on security type
-     */
-    async resolveAuthValue(security, context) {
-        // Try custom resolver first
-        if (context.customResolver) {
-            const customValue = await context.customResolver(security);
-            if (customValue !== undefined) {
-                return customValue;
-            }
-        }
-        // Handle standard security types
-        if (security.type === 'http') {
-            return this.resolveHttpAuth(security, context);
-        }
-        else if (security.type === 'apiKey') {
-            return this.resolveApiKey(security, context);
-        }
-        else if (security.type === 'oauth2' || security.type === 'openIdConnect') {
-            return this.resolveOAuth2(security, context);
-        }
-        return undefined;
-    }
-    /**
-     * Resolve HTTP authentication (bearer, basic, digest, etc.)
-     */
-    resolveHttpAuth(security, context) {
-        const scheme = security.httpScheme?.toLowerCase() || 'bearer';
-        switch (scheme) {
-            case 'bearer':
-                return this.resolveBearerAuth(context);
-            case 'basic':
-                return this.resolveBasicAuth(context);
-            case 'digest':
-                return this.resolveDigestAuth(context);
-            case 'hoba':
-            case 'mutual':
-            case 'negotiate':
-            case 'vapid':
-            case 'scram':
-                // These schemes typically require custom implementation
-                // Try custom headers or signature generator
-                return this.resolveCustomHttpScheme(scheme, security, context);
-            default:
-                // Unknown scheme - try custom resolver
-                return undefined;
-        }
-    }
-    /**
-     * Resolve Bearer token authentication
-     */
-    resolveBearerAuth(context) {
-        const token = context.jwt;
-        if (!token)
-            return undefined;
-        return `Bearer ${token}`;
-    }
-    /**
-     * Resolve Basic authentication
-     */
-    resolveBasicAuth(context) {
-        const credentials = context.basic;
-        if (!credentials)
-            return undefined;
-        return `Basic ${credentials}`;
-    }
-    /**
-     * Resolve Digest authentication
-     */
-    resolveDigestAuth(context) {
-        const digest = context.digest;
-        if (!digest)
-            return undefined;
-        // Build digest auth header
-        const parts = [
-            `username="${digest.username}"`,
-            digest.realm ? `realm="${digest.realm}"` : '',
-            digest.nonce ? `nonce="${digest.nonce}"` : '',
-            digest.uri ? `uri="${digest.uri}"` : '',
-            digest.response ? `response="${digest.response}"` : '',
-            digest.opaque ? `opaque="${digest.opaque}"` : '',
-            digest.qop ? `qop=${digest.qop}` : '',
-            digest.nc ? `nc=${digest.nc}` : '',
-            digest.cnonce ? `cnonce="${digest.cnonce}"` : '',
-        ].filter(Boolean);
-        return `Digest ${parts.join(', ')}`;
-    }
-    /**
-     * Resolve custom HTTP authentication schemes
-     */
-    resolveCustomHttpScheme(scheme, security, context) {
-        // Try custom headers first
-        const headerKey = security.apiKeyName || `X-${scheme.toUpperCase()}`;
-        if (context.customHeaders?.[headerKey]) {
-            return context.customHeaders[headerKey];
-        }
-        // Unknown scheme
-        return undefined;
-    }
-    /**
-     * Resolve API key authentication
-     */
-    resolveApiKey(security, context) {
-        // Try named API keys first (for multiple keys)
-        if (context.apiKeys && security.apiKeyName) {
-            const key = context.apiKeys[security.apiKeyName];
-            if (key)
-                return key;
-        }
-        // Try custom headers (for proprietary auth headers like X-Custom-Auth)
-        if (context.customHeaders && security.apiKeyName) {
-            const header = context.customHeaders[security.apiKeyName];
-            if (header)
-                return header;
-        }
-        // Fall back to single apiKey (backward compatibility)
-        return context.apiKey;
-    }
-    /**
-     * Resolve OAuth2/OpenID Connect authentication
-     */
-    resolveOAuth2(security, context) {
-        const token = context.oauth2Token;
-        if (!token)
-            return undefined;
-        // OAuth2 tokens are typically formatted as "Bearer {token}"
-        return `Bearer ${token}`;
-    }
-    /**
-     * Check if any security requirements are missing from context
-     *
-     * @param mappers - Parameter mappers from the tool definition
-     * @param context - Security context with auth values
-     * @returns Array of missing security scheme names
-     */
-    async checkMissingSecurity(mappers, context) {
-        const missing = [];
-        for (const mapper of mappers) {
-            if (!mapper.security)
-                continue;
-            const authValue = await this.resolveAuthValue(mapper.security, context);
-            if (!authValue) {
-                missing.push(mapper.security.scheme);
-            }
-        }
-        return missing;
-    }
-    /**
-     * Sign a request for signature-based authentication
-     *
-     * Use this when resolved.requiresSignature is true.
-     * This method will call the signatureGenerator from context to sign the request.
-     *
-     * @param mappers - Parameter mappers from the tool definition
-     * @param signatureData - Request data to sign
-     * @param context - Security context with signature generator
-     * @returns Headers with signature added
-     *
-     * @example
-     * ```typescript
-     * const resolved = resolver.resolve(tool.mapper, context);
-     * if (resolved.requiresSignature) {
-     *   const signedHeaders = await resolver.signRequest(
-     *     tool.mapper,
-     *     { method: 'GET', url: 'https://api.example.com/data', headers: resolved.headers },
-     *     context
-     *   );
-     *   // Use signedHeaders in request
-     * }
-     * ```
-     */
-    async signRequest(mappers, signatureData, context) {
-        const headers = { ...signatureData.headers };
-        if (!context.signatureGenerator) {
-            throw new Error('Signature-based auth required but no signatureGenerator provided');
-        }
-        for (const mapper of mappers) {
-            if (!mapper.security || !this.isSignatureBasedAuth(mapper.security)) {
-                continue;
-            }
-            // Call signature generator
-            const signature = await context.signatureGenerator(signatureData, mapper.security);
-            // Add signature to appropriate location
-            if (mapper.type === 'header') {
-                headers[mapper.key] = signature;
-            }
-            // Note: Query/cookie signatures would be handled differently
-        }
-        return headers;
-    }
-}
-exports.SecurityResolver = SecurityResolver;
-/**
- * Create a basic security context from common auth sources
- *
- * @example
- * ```typescript
- * const context = createSecurityContext({
- *   jwt: process.env.JWT_TOKEN,
- *   apiKey: process.env.API_KEY
- * });
- * ```
- */
-function createSecurityContext(auth) {
-    return {
-        ...auth,
-        jwt: auth.jwt,
-        basic: auth.basic,
-        apiKey: auth.apiKey,
-        oauth2Token: auth.oauth2Token,
-        customResolver: auth.customResolver,
-    };
-}
-//# sourceMappingURL=security-resolver.js.map