@machina.ai/openapi-contract-tester 2.1.0

package/dist/parsers/endpoint-extractor.js

@@ -0,0 +1,160 @@
+/**
+ * Endpoint Extractor
+ *
+ * Extracts and resolves endpoint information from OpenAPI specifications.
+ *
+ * @module parsers/endpoint-extractor
+ */
+import { OpenAPIError, ErrorCode } from '../utils/errors.js';
+import { createLogger } from '../utils/logger.js';
+const log = createLogger('endpoint-extractor');
+/**
+ * Extracts all endpoints from an OpenAPI specification
+ *
+ * @param spec - Parsed OpenAPI specification
+ * @returns Array of parsed endpoints with their metadata
+ */
+export function extractEndpoints(spec) {
+    log.debug('Extracting endpoints from OpenAPI specification');
+    if (!spec.paths || Object.keys(spec.paths).length === 0) {
+        throw new OpenAPIError(ErrorCode.OPENAPI_MISSING_PATHS, 'OpenAPI specification has no paths defined', 'The specification does not define any API endpoints. Please add path definitions.', { title: spec.info?.title });
+    }
+    const endpoints = [];
+    for (const [path, pathItem] of Object.entries(spec.paths || {})) {
+        if (!pathItem)
+            continue;
+        const methods = ['GET', 'POST', 'PUT', 'PATCH', 'DELETE', 'HEAD', 'OPTIONS'];
+        for (const method of methods) {
+            const methodKey = method.toLowerCase();
+            const operation = pathItem[methodKey];
+            if (!operation)
+                continue;
+            const pathParams = [];
+            const queryParams = [];
+            const headerParams = [];
+            const allParams = [
+                ...(pathItem.parameters || []),
+                ...(operation.parameters || [])
+            ];
+            for (const param of allParams) {
+                if ('$ref' in param)
+                    continue;
+                const paramObj = param;
+                switch (paramObj.in) {
+                    case 'path':
+                        pathParams.push(paramObj);
+                        break;
+                    case 'query':
+                        queryParams.push(paramObj);
+                        break;
+                    case 'header':
+                        headerParams.push(paramObj);
+                        break;
+                }
+            }
+            // Extract request body schema (content-type agnostic)
+            let requestBody;
+            let requestContentType;
+            if (operation.requestBody && !('$ref' in operation.requestBody)) {
+                const requestBodyObj = operation.requestBody;
+                const contentTypes = Object.keys(requestBodyObj.content || {});
+                const priorityOrder = [
+                    'application/json',
+                    'application/x-www-form-urlencoded',
+                    'multipart/form-data'
+                ];
+                requestContentType = priorityOrder.find(ct => contentTypes.includes(ct)) || contentTypes[0];
+                if (requestContentType && requestBodyObj.content?.[requestContentType]) {
+                    const content = requestBodyObj.content[requestContentType];
+                    if (content.schema && !('$ref' in content.schema)) {
+                        requestBody = content.schema;
+                    }
+                }
+            }
+            // Extract response schemas by status code (content-type agnostic)
+            const responses = {};
+            if (operation.responses) {
+                for (const [statusCode, response] of Object.entries(operation.responses)) {
+                    if ('$ref' in response)
+                        continue;
+                    const responseObj = response;
+                    const responseContentTypes = Object.keys(responseObj.content || {});
+                    const responsePriorityOrder = [
+                        'application/json',
+                        'application/xml',
+                        'text/plain',
+                        'text/html'
+                    ];
+                    const responseContentType = responsePriorityOrder.find(ct => responseContentTypes.includes(ct)) || responseContentTypes[0];
+                    if (responseContentType && responseObj.content?.[responseContentType]) {
+                        const content = responseObj.content[responseContentType];
+                        if (content.schema && !('$ref' in content.schema)) {
+                            // Skip 'default' — it represents an unspecified status range and
+                            // cannot be mapped to a concrete code without overwriting real schemas
+                            if (statusCode === 'default')
+                                continue;
+                            const status = parseInt(statusCode, 10);
+                            responses[status] = content.schema;
+                        }
+                    }
+                }
+            }
+            const security = operation.security || spec.security;
+            const securitySchemes = extractSecuritySchemes(spec);
+            const resolvedSecurity = resolveSecurityRequirements(security, securitySchemes);
+            const requiresAuth = !(Array.isArray(security) && security.length === 0);
+            endpoints.push({
+                method,
+                path,
+                operation,
+                pathParams,
+                queryParams,
+                headerParams,
+                requestBody,
+                requestContentType,
+                responses,
+                security,
+                securitySchemes: resolvedSecurity,
+                requiresAuth
+            });
+        }
+    }
+    log.info('Successfully extracted endpoints', {
+        count: endpoints.length,
+        paths: Object.keys(spec.paths).length
+    });
+    return endpoints;
+}
+/**
+ * Extracts security schemes from an OpenAPI specification
+ *
+ * @param spec - Parsed OpenAPI specification
+ * @returns Map of security scheme name to security scheme object
+ */
+export function extractSecuritySchemes(spec) {
+    return spec.components?.securitySchemes || {};
+}
+/**
+ * Resolves security requirements to actual security scheme objects
+ *
+ * @param security - Security requirements array from operation or global
+ * @param schemes - Available security schemes from spec
+ * @returns Array of resolved security scheme objects
+ */
+export function resolveSecurityRequirements(security, schemes) {
+    if (!security || security.length === 0) {
+        return [];
+    }
+    const resolved = [];
+    for (const requirement of security) {
+        const schemeNames = Object.keys(requirement);
+        for (const schemeName of schemeNames) {
+            const scheme = schemes[schemeName];
+            if (scheme) {
+                resolved.push(scheme);
+            }
+        }
+    }
+    return resolved;
+}
+//# sourceMappingURL=endpoint-extractor.js.map

package/dist/parsers/endpoint-extractor.js.map

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

package/dist/parsers/openapi-parser.d.ts

@@ -0,0 +1,120 @@
+/**
+ * OpenAPI Specification Parser
+ *
+ * This module provides functionality to parse, validate, and extract information
+ * from OpenAPI 3.x and Swagger 2.0 specification files (YAML or JSON format).
+ * Swagger 2.0 specs are automatically converted to OpenAPI 3.0.
+ *
+ * @module parsers/openapi-parser
+ */
+import type { OpenAPIV3 } from 'openapi-types';
+import type { HttpMethod, ParsedEndpoint } from '../types/index.js';
+export { extractEndpoints, extractSecuritySchemes, resolveSecurityRequirements } from './endpoint-extractor.js';
+export { inferAuthFromSpec } from './visitors/auth-visitor.js';
+/**
+ * Parses and validates an OpenAPI specification file
+ *
+ * @param specPath - Path or URL to the OpenAPI specification file (YAML or JSON)
+ * @returns Parsed and dereferenced OpenAPI specification
+ * @throws {Error} If the specification is invalid or cannot be parsed
+ *
+ * @example
+ * ```typescript
+ * const spec = await parseOpenAPISpec('./api/openapi.yml');
+ * console.log(spec.info.title); // "My API"
+ * ```
+ */
+export declare function parseOpenAPISpec(specPath: string): Promise<OpenAPIV3.Document>;
+/**
+ * Validates an OpenAPI specification file without dereferencing
+ *
+ * This is faster than full parsing and useful for quick validation checks.
+ *
+ * @param specPath - Path or URL to the OpenAPI specification file
+ * @returns Validation result with any errors found
+ *
+ * @example
+ * ```typescript
+ * const result = await validateOpenAPISpec('./api/openapi.yml');
+ * if (result.valid) {
+ *   console.log('Spec is valid!');
+ * } else {
+ *   console.error('Validation errors:', result.errors);
+ * }
+ * ```
+ */
+export declare function validateOpenAPISpec(specPath: string): Promise<{
+    valid: boolean;
+    errors: string[];
+    warnings: string[];
+}>;
+/**
+ * Gets the base URL for the API from the servers section
+ *
+ * @param spec - Parsed OpenAPI specification
+ * @param environmentName - Optional environment name to filter servers
+ * @returns Base URL for the API, or undefined if no servers defined
+ *
+ * @example
+ * ```typescript
+ * const spec = await parseOpenAPISpec('./api/openapi.yml');
+ * const baseUrl = getBaseUrl(spec);
+ * console.log('API base URL:', baseUrl); // "https://api.example.com/v1"
+ * ```
+ */
+export declare function getBaseUrl(spec: OpenAPIV3.Document, environmentName?: string): string | undefined;
+/**
+ * Checks if an endpoint requires authentication
+ *
+ * @param endpoint - Parsed endpoint to check
+ * @param spec - OpenAPI specification (for global security)
+ * @returns True if the endpoint requires authentication
+ *
+ * @example
+ * ```typescript
+ * const spec = await parseOpenAPISpec('./api/openapi.yml');
+ * const endpoints = extractEndpoints(spec);
+ * const authRequired = isAuthRequired(endpoints[0], spec);
+ * console.log('Auth required:', authRequired);
+ * ```
+ */
+export declare function isAuthRequired(endpoint: ParsedEndpoint, spec: OpenAPIV3.Document): boolean;
+/**
+ * Extracts all unique tags from the specification
+ *
+ * @param spec - Parsed OpenAPI specification
+ * @returns Array of unique tag names
+ *
+ * @example
+ * ```typescript
+ * const spec = await parseOpenAPISpec('./api/openapi.yml');
+ * const tags = extractTags(spec);
+ * console.log('API tags:', tags); // ["users", "orders", "products"]
+ * ```
+ */
+export declare function extractTags(spec: OpenAPIV3.Document): string[];
+/**
+ * Gets a human-readable summary of the OpenAPI specification
+ *
+ * @param spec - Parsed OpenAPI specification
+ * @returns Summary object with key information
+ *
+ * @example
+ * ```typescript
+ * const spec = await parseOpenAPISpec('./api/openapi.yml');
+ * const summary = getSpecSummary(spec);
+ * console.log(summary.title); // "My API"
+ * console.log(summary.totalEndpoints); // 25
+ * ```
+ */
+export declare function getSpecSummary(spec: OpenAPIV3.Document): {
+    title: string;
+    version: string;
+    description?: string;
+    totalEndpoints: number;
+    endpointsByMethod: Record<HttpMethod, number>;
+    tags: string[];
+    hasAuthentication: boolean;
+    servers: string[];
+};
+//# sourceMappingURL=openapi-parser.d.ts.map

package/dist/parsers/openapi-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi-parser.d.ts","sourceRoot":"","sources":["../../src/parsers/openapi-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,KAAK,EAAW,SAAS,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAQpE,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAC;AAChH,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAE/D;;;;;;;;;;;;GAYG;AACH,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,QAAQ,CAAC,CAsFpF;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;IACnE,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB,CAAC,CAeD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,SAAS,CAAC,QAAQ,EAAE,eAAe,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAiBjG;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,cAAc,EAAE,IAAI,EAAE,SAAS,CAAC,QAAQ,GAAG,OAAO,CAQ1F;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,SAAS,CAAC,QAAQ,GAAG,MAAM,EAAE,CA2B9D;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,SAAS,CAAC,QAAQ,GAAG;IACxD,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,iBAAiB,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IAC9C,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,iBAAiB,EAAE,OAAO,CAAC;IAC3B,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB,CA2BA"}

package/dist/parsers/openapi-parser.js

@@ -0,0 +1,257 @@
+/**
+ * OpenAPI Specification Parser
+ *
+ * This module provides functionality to parse, validate, and extract information
+ * from OpenAPI 3.x and Swagger 2.0 specification files (YAML or JSON format).
+ * Swagger 2.0 specs are automatically converted to OpenAPI 3.0.
+ *
+ * @module parsers/openapi-parser
+ */
+import SwaggerParser from '@apidevtools/swagger-parser';
+// @ts-ignore - swagger2openapi doesn't have type definitions
+import * as swagger2openapi from 'swagger2openapi';
+import { OpenAPIError, ErrorCode } from '../utils/errors.js';
+import { createLogger } from '../utils/logger.js';
+import { extractEndpoints } from './endpoint-extractor.js';
+const log = createLogger('openapi-parser');
+// Re-export from extracted modules for backward compatibility
+export { extractEndpoints, extractSecuritySchemes, resolveSecurityRequirements } from './endpoint-extractor.js';
+export { inferAuthFromSpec } from './visitors/auth-visitor.js';
+/**
+ * Parses and validates an OpenAPI specification file
+ *
+ * @param specPath - Path or URL to the OpenAPI specification file (YAML or JSON)
+ * @returns Parsed and dereferenced OpenAPI specification
+ * @throws {Error} If the specification is invalid or cannot be parsed
+ *
+ * @example
+ * ```typescript
+ * const spec = await parseOpenAPISpec('./api/openapi.yml');
+ * console.log(spec.info.title); // "My API"
+ * ```
+ */
+export async function parseOpenAPISpec(specPath) {
+    log.debug('Parsing OpenAPI specification', { specPath });
+    try {
+        // First, bundle without dereferencing to detect version
+        const bundled = await SwaggerParser.bundle(specPath);
+        const apiAny = bundled;
+        // Detect spec version
+        const isSwagger2 = apiAny.swagger?.startsWith('2.');
+        const isOpenAPI3 = apiAny.openapi?.startsWith('3.');
+        if (!isSwagger2 && !isOpenAPI3) {
+            throw new OpenAPIError(ErrorCode.OPENAPI_INVALID_SPEC, 'Invalid API specification: missing openapi or swagger version field', 'The specification file is not a valid OpenAPI 3.x or Swagger 2.0 document. Please check the file format.', { specPath });
+        }
+        let openapi3Spec;
+        if (isSwagger2) {
+            // Convert Swagger 2.0 to OpenAPI 3.0 automatically
+            log.info('Detected Swagger 2.0 specification, converting to OpenAPI 3.0...', {
+                specPath,
+                swaggerVersion: apiAny.swagger,
+                title: apiAny.info?.title
+            });
+            try {
+                const conversionResult = await swagger2openapi.convertObj(bundled, {
+                    patch: true, // Auto-fix common issues
+                    warnOnly: true, // Don't fail on warnings
+                    direct: true, // Return object directly
+                });
+                openapi3Spec = conversionResult.openapi;
+                log.info('Successfully converted Swagger 2.0 to OpenAPI 3.0', {
+                    specPath,
+                    originalVersion: apiAny.swagger,
+                    convertedVersion: openapi3Spec.openapi
+                });
+            }
+            catch (conversionError) {
+                throw new OpenAPIError(ErrorCode.OPENAPI_PARSE_ERROR, `Failed to convert Swagger 2.0 to OpenAPI 3.0: ${conversionError instanceof Error ? conversionError.message : String(conversionError)}`, 'The Swagger 2.0 specification could not be converted to OpenAPI 3.0. Please check the specification for compatibility issues.', { specPath, originalError: conversionError instanceof Error ? conversionError.message : String(conversionError) });
+            }
+        }
+        else {
+            openapi3Spec = bundled;
+        }
+        // Now dereference the OpenAPI 3.x spec (resolve all $ref references)
+        const dereferenced = await SwaggerParser.dereference(openapi3Spec);
+        const version = dereferenced.openapi;
+        log.info('Successfully parsed OpenAPI specification', {
+            specPath,
+            version,
+            wasConverted: isSwagger2,
+            title: dereferenced.info?.title
+        });
+        return dereferenced;
+    }
+    catch (error) {
+        // If already an OpenAPIError, rethrow
+        if (error instanceof OpenAPIError) {
+            throw error;
+        }
+        // Wrap other errors
+        log.error('Failed to parse OpenAPI specification', { specPath, error });
+        throw new OpenAPIError(ErrorCode.OPENAPI_PARSE_ERROR, error instanceof Error ? error.message : String(error), 'Failed to parse the OpenAPI specification. Please check that the file exists and is valid YAML/JSON.', { specPath, originalError: error instanceof Error ? error.message : String(error) });
+    }
+}
+/**
+ * Validates an OpenAPI specification file without dereferencing
+ *
+ * This is faster than full parsing and useful for quick validation checks.
+ *
+ * @param specPath - Path or URL to the OpenAPI specification file
+ * @returns Validation result with any errors found
+ *
+ * @example
+ * ```typescript
+ * const result = await validateOpenAPISpec('./api/openapi.yml');
+ * if (result.valid) {
+ *   console.log('Spec is valid!');
+ * } else {
+ *   console.error('Validation errors:', result.errors);
+ * }
+ * ```
+ */
+export async function validateOpenAPISpec(specPath) {
+    const errors = [];
+    const warnings = [];
+    try {
+        await SwaggerParser.validate(specPath);
+        return { valid: true, errors, warnings };
+    }
+    catch (error) {
+        if (error instanceof Error) {
+            errors.push(error.message);
+        }
+        else {
+            errors.push('Unknown validation error');
+        }
+        return { valid: false, errors, warnings };
+    }
+}
+/**
+ * Gets the base URL for the API from the servers section
+ *
+ * @param spec - Parsed OpenAPI specification
+ * @param environmentName - Optional environment name to filter servers
+ * @returns Base URL for the API, or undefined if no servers defined
+ *
+ * @example
+ * ```typescript
+ * const spec = await parseOpenAPISpec('./api/openapi.yml');
+ * const baseUrl = getBaseUrl(spec);
+ * console.log('API base URL:', baseUrl); // "https://api.example.com/v1"
+ * ```
+ */
+export function getBaseUrl(spec, environmentName) {
+    if (!spec.servers || spec.servers.length === 0) {
+        return undefined;
+    }
+    // If environment name provided, try to find matching server
+    if (environmentName) {
+        const server = spec.servers.find(s => s.description?.toLowerCase().includes(environmentName.toLowerCase()));
+        if (server) {
+            return server.url;
+        }
+    }
+    // Return first server URL
+    return spec.servers[0].url;
+}
+/**
+ * Checks if an endpoint requires authentication
+ *
+ * @param endpoint - Parsed endpoint to check
+ * @param spec - OpenAPI specification (for global security)
+ * @returns True if the endpoint requires authentication
+ *
+ * @example
+ * ```typescript
+ * const spec = await parseOpenAPISpec('./api/openapi.yml');
+ * const endpoints = extractEndpoints(spec);
+ * const authRequired = isAuthRequired(endpoints[0], spec);
+ * console.log('Auth required:', authRequired);
+ * ```
+ */
+export function isAuthRequired(endpoint, spec) {
+    // Check operation-level security
+    if (endpoint.operation.security) {
+        return endpoint.operation.security.length > 0;
+    }
+    // Check global security
+    return (spec.security?.length || 0) > 0;
+}
+/**
+ * Extracts all unique tags from the specification
+ *
+ * @param spec - Parsed OpenAPI specification
+ * @returns Array of unique tag names
+ *
+ * @example
+ * ```typescript
+ * const spec = await parseOpenAPISpec('./api/openapi.yml');
+ * const tags = extractTags(spec);
+ * console.log('API tags:', tags); // ["users", "orders", "products"]
+ * ```
+ */
+export function extractTags(spec) {
+    const tags = new Set();
+    // Add tags from the tags section
+    if (spec.tags) {
+        for (const tag of spec.tags) {
+            tags.add(tag.name);
+        }
+    }
+    // Add tags from operations
+    for (const pathItem of Object.values(spec.paths || {})) {
+        if (!pathItem)
+            continue;
+        const methods = ['get', 'post', 'put', 'patch', 'delete', 'head', 'options'];
+        for (const method of methods) {
+            const operation = pathItem[method];
+            if (operation?.tags) {
+                for (const tag of operation.tags) {
+                    tags.add(tag);
+                }
+            }
+        }
+    }
+    return Array.from(tags);
+}
+/**
+ * Gets a human-readable summary of the OpenAPI specification
+ *
+ * @param spec - Parsed OpenAPI specification
+ * @returns Summary object with key information
+ *
+ * @example
+ * ```typescript
+ * const spec = await parseOpenAPISpec('./api/openapi.yml');
+ * const summary = getSpecSummary(spec);
+ * console.log(summary.title); // "My API"
+ * console.log(summary.totalEndpoints); // 25
+ * ```
+ */
+export function getSpecSummary(spec) {
+    const endpoints = extractEndpoints(spec);
+    const endpointsByMethod = {
+        GET: 0,
+        POST: 0,
+        PUT: 0,
+        PATCH: 0,
+        DELETE: 0,
+        HEAD: 0,
+        OPTIONS: 0
+    };
+    for (const endpoint of endpoints) {
+        endpointsByMethod[endpoint.method]++;
+    }
+    return {
+        title: spec.info.title,
+        version: spec.info.version,
+        description: spec.info.description,
+        totalEndpoints: endpoints.length,
+        endpointsByMethod,
+        tags: extractTags(spec),
+        hasAuthentication: (spec.security?.length || 0) > 0 ||
+            Object.keys(spec.components?.securitySchemes || {}).length > 0,
+        servers: (spec.servers || []).map(s => s.url)
+    };
+}
+//# sourceMappingURL=openapi-parser.js.map

package/dist/parsers/openapi-parser.js.map

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

package/dist/parsers/visitors/auth-visitor.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Auth Inference Visitor
+ *
+ * Infers authentication configuration from OpenAPI security schemes.
+ * Implements the Visitor pattern for spec-level auth analysis.
+ *
+ * @module parsers/visitors/auth-visitor
+ */
+import type { OpenAPIV3 } from 'openapi-types';
+/**
+ * Infers authentication configuration from OpenAPI security schemes.
+ *
+ * Automatically detects OAuth2, Bearer, API Key, and Basic auth from the spec
+ * and constructs the appropriate AuthConfig using provided credentials.
+ *
+ * @param spec - Parsed OpenAPI specification
+ * @param credentials - User-provided credentials
+ * @returns AuthConfig object or undefined if no auth detected
+ */
+export declare function inferAuthFromSpec(spec: OpenAPIV3.Document, credentials?: {
+    clientId?: string;
+    clientSecret?: string;
+    apiKey?: string;
+    username?: string;
+    password?: string;
+    bearerToken?: string;
+}): any;
+//# sourceMappingURL=auth-visitor.d.ts.map

package/dist/parsers/visitors/auth-visitor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth-visitor.d.ts","sourceRoot":"","sources":["../../../src/parsers/visitors/auth-visitor.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAG/C;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,SAAS,CAAC,QAAQ,EACxB,WAAW,CAAC,EAAE;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,GACA,GAAG,CA2GL"}