swagger-to-playwright-api-clients 1.0.4

package/dist/utils/swagger/run-generator.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Generator Runner - Executes swagger generation based on automation config
+ */
+import { GeneratorResult } from '.';
+import { AutomationConfig } from '../../config/types';
+/**
+ * Results for all processed sources
+ */
+export interface RunResults {
+    totalSources: number;
+    successful: number;
+    failed: number;
+    skipped: number;
+    results: Array<{
+        source: string;
+        result: GeneratorResult;
+    }>;
+}
+/**
+ * Run the generator for all configured sources
+ */
+export declare function runGenerator(config: AutomationConfig): Promise<RunResults>;
+//# sourceMappingURL=run-generator.d.ts.map

package/dist/utils/swagger/run-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-generator.d.ts","sourceRoot":"","sources":["../../../src/utils/swagger/run-generator.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAAoB,eAAe,EAAE,MAAM,GAAG,CAAC;AACtD,OAAO,EACN,gBAAgB,EAGhB,MAAM,oBAAoB,CAAC;AAG5B;;GAEG;AACH,MAAM,WAAW,UAAU;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,KAAK,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,eAAe,CAAC;KACxB,CAAC,CAAC;CACH;AAyCD;;GAEG;AACH,wBAAsB,YAAY,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,UAAU,CAAC,CA0HhF"}

package/dist/utils/swagger/run-generator.js

@@ -0,0 +1,195 @@
+"use strict";
+/**
+ * Generator Runner - Executes swagger generation based on automation config
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runGenerator = runGenerator;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const _1 = require(".");
+const types_1 = require("../../config/types");
+const logger_1 = __importDefault(require("../logger"));
+/**
+ * Process a single swagger source
+ */
+async function processSource(sourceConfig, globalOutputDir, baseClientPath) {
+    const outputDir = sourceConfig.outputDir || globalOutputDir;
+    const generator = new _1.SwaggerGenerator({
+        outputDir,
+        serviceName: sourceConfig.serviceName,
+        baseClientPath: baseClientPath || types_1.DEFAULT_BASE_CLIENT_PATH,
+    });
+    if (sourceConfig.type === 'file') {
+        // Resolve file path relative to project root
+        const filePath = path.isAbsolute(sourceConfig.source)
+            ? sourceConfig.source
+            : path.join(process.cwd(), sourceConfig.source);
+        return generator.generateFromFile(filePath);
+    }
+    else {
+        return generator.generateFromUrl(sourceConfig.source);
+    }
+}
+/**
+ * Clean output directory
+ */
+async function cleanDirectory(dirPath) {
+    try {
+        await fs.promises.rm(dirPath, { recursive: true, force: true });
+        logger_1.default.info(`Cleaned output directory: ${dirPath}`);
+    }
+    catch (error) {
+        // Ignore if doesn't exist
+    }
+}
+/**
+ * Run the generator for all configured sources
+ */
+async function runGenerator(config) {
+    logger_1.default.info('='.repeat(60));
+    logger_1.default.info('Starting Swagger to Playwright API Client Generation');
+    logger_1.default.info('='.repeat(60));
+    const results = {
+        totalSources: config.sources.length,
+        successful: 0,
+        failed: 0,
+        skipped: 0,
+        results: [],
+    };
+    // Filter active sources
+    const activeSources = config.sources.filter((s) => !s.skip);
+    const skippedSources = config.sources.filter((s) => s.skip);
+    results.skipped = skippedSources.length;
+    if (skippedSources.length > 0) {
+        logger_1.default.info(`Skipping ${skippedSources.length} source(s)`);
+    }
+    if (activeSources.length === 0) {
+        logger_1.default.warn('No active sources to process. Check your automation-config.ts');
+        return results;
+    }
+    // Generated clients go into a subfolder for safe cleanup
+    const generatedClientsDir = path.join(config.outputDir, 'generatedClients');
+    // Clean generated clients directory if configured (safe - doesn't touch BaseAPIClient etc.)
+    if (config.cleanOutput) {
+        await cleanDirectory(generatedClientsDir);
+    }
+    // Create generated clients directory
+    await fs.promises.mkdir(generatedClientsDir, { recursive: true });
+    // Process sources
+    if (config.parallel) {
+        // Parallel processing
+        logger_1.default.info(`Processing ${activeSources.length} source(s) in parallel`);
+        const promises = activeSources.map((source) => processSource(source, generatedClientsDir, config.baseClientPath));
+        const allResults = await Promise.allSettled(promises);
+        for (let i = 0; i < allResults.length; i++) {
+            const settledResult = allResults[i];
+            const source = activeSources[i];
+            if (settledResult.status === 'fulfilled') {
+                const result = settledResult.value;
+                results.results.push({ source: source.source, result });
+                if (result.success) {
+                    results.successful++;
+                }
+                else {
+                    results.failed++;
+                }
+            }
+            else {
+                results.failed++;
+                results.results.push({
+                    source: source.source,
+                    result: {
+                        success: false,
+                        serviceName: '',
+                        filesWritten: [],
+                        folderStructure: '',
+                        errors: [settledResult.reason?.message || 'Unknown error'],
+                    },
+                });
+            }
+        }
+    }
+    else {
+        // Sequential processing
+        for (const source of activeSources) {
+            logger_1.default.info('-'.repeat(40));
+            logger_1.default.info(`Processing: ${source.source}`);
+            try {
+                const result = await processSource(source, generatedClientsDir, config.baseClientPath);
+                results.results.push({ source: source.source, result });
+                if (result.success) {
+                    results.successful++;
+                    logger_1.default.info(`✓ Generated ${result.filesWritten.length} files for ${result.serviceName}`);
+                }
+                else {
+                    results.failed++;
+                    logger_1.default.error(`✗ Failed: ${result.errors.join(', ')}`);
+                }
+            }
+            catch (error) {
+                results.failed++;
+                const errorMessage = error instanceof Error ? error.message : String(error);
+                logger_1.default.error(`✗ Exception: ${errorMessage}`);
+                results.results.push({
+                    source: source.source,
+                    result: {
+                        success: false,
+                        serviceName: '',
+                        filesWritten: [],
+                        folderStructure: '',
+                        errors: [errorMessage],
+                    },
+                });
+            }
+        }
+    }
+    // Print summary
+    logger_1.default.info('='.repeat(60));
+    logger_1.default.info('Generation Complete');
+    logger_1.default.info('='.repeat(60));
+    logger_1.default.info(`Total Sources: ${results.totalSources}`);
+    logger_1.default.info(`Successful: ${results.successful}`);
+    logger_1.default.info(`Failed: ${results.failed}`);
+    logger_1.default.info(`Skipped: ${results.skipped}`);
+    if (results.failed > 0) {
+        logger_1.default.warn('Some sources failed. Check the logs above for details.');
+    }
+    return results;
+}
+//# sourceMappingURL=run-generator.js.map

package/dist/utils/swagger/run-generator.js.map

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

package/dist/utils/swagger/types.d.ts

@@ -0,0 +1,142 @@
+/**
+ * Type definitions for Swagger/OpenAPI parsing
+ * Supports Swagger 2.0 and OpenAPI 3.x (including 3.1)
+ */
+export interface SwaggerInfo {
+    title: string;
+    version: string;
+    description?: string;
+}
+export interface SwaggerParameter {
+    name: string;
+    in: 'path' | 'query' | 'header' | 'body' | 'formData';
+    required?: boolean;
+    type?: string;
+    format?: string;
+    description?: string;
+    schema?: SchemaObject;
+    items?: SchemaObject;
+    enum?: string[];
+}
+export interface SchemaObject {
+    type?: string;
+    format?: string;
+    $ref?: string;
+    items?: SchemaObject;
+    properties?: Record<string, SchemaObject>;
+    required?: string[];
+    additionalProperties?: boolean | SchemaObject;
+    enum?: (string | number)[];
+    nullable?: boolean;
+    allOf?: SchemaObject[];
+    oneOf?: SchemaObject[];
+    anyOf?: SchemaObject[];
+    description?: string;
+    default?: unknown;
+    example?: unknown;
+}
+export interface RequestBody {
+    required?: boolean;
+    content: Record<string, {
+        schema?: SchemaObject;
+    }>;
+}
+export interface ResponseObject {
+    description?: string;
+    schema?: SchemaObject;
+    content?: Record<string, {
+        schema?: SchemaObject;
+    }>;
+}
+export interface OperationObject {
+    operationId?: string;
+    summary?: string;
+    description?: string;
+    tags?: string[];
+    parameters?: SwaggerParameter[];
+    requestBody?: RequestBody;
+    responses?: Record<string, ResponseObject>;
+    deprecated?: boolean;
+}
+export interface PathItemObject {
+    get?: OperationObject;
+    post?: OperationObject;
+    put?: OperationObject;
+    patch?: OperationObject;
+    delete?: OperationObject;
+    parameters?: SwaggerParameter[];
+}
+export interface Swagger2Document {
+    swagger: '2.0';
+    info: SwaggerInfo;
+    host?: string;
+    basePath?: string;
+    schemes?: string[];
+    paths: Record<string, PathItemObject>;
+    definitions?: Record<string, SchemaObject>;
+    parameters?: Record<string, SwaggerParameter>;
+}
+export interface OpenAPI3Document {
+    openapi: string;
+    info: SwaggerInfo;
+    servers?: Array<{
+        url: string;
+        description?: string;
+    }>;
+    paths: Record<string, PathItemObject>;
+    components?: {
+        schemas?: Record<string, SchemaObject>;
+        parameters?: Record<string, SwaggerParameter>;
+        requestBodies?: Record<string, RequestBody>;
+        responses?: Record<string, ResponseObject>;
+    };
+}
+export type SwaggerDocument = Swagger2Document | OpenAPI3Document;
+export interface ParsedEndpoint {
+    path: string;
+    method: string;
+    operationId?: string;
+    summary?: string;
+    description?: string;
+    tags?: string[];
+    pathParams: ParsedParameter[];
+    queryParams: ParsedParameter[];
+    headerParams: ParsedParameter[];
+    requestBody?: ParsedSchema;
+    responses: Record<string, ParsedSchema>;
+    deprecated?: boolean;
+}
+export interface ParsedParameter {
+    name: string;
+    required: boolean;
+    type: string;
+    description?: string;
+    enum?: (string | number)[];
+}
+export interface ParsedSchema {
+    typeName: string;
+    typeDefinition: string;
+    isArray?: boolean;
+    isEnum?: boolean;
+    enumValues?: (string | number)[];
+    properties?: Record<string, ParsedSchema>;
+    required?: string[];
+}
+export interface GeneratedType {
+    name: string;
+    definition: string;
+    source: string;
+}
+export interface GeneratedClient {
+    serviceName: string;
+    folder: string[];
+    imports: string[];
+    functions: string[];
+    types: GeneratedType[];
+}
+export interface GeneratorOutput {
+    serviceName: string;
+    clients: GeneratedClient[];
+    sharedTypes: GeneratedType[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/utils/swagger/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/utils/swagger/types.ts"],"names":[],"mappings":"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"}

package/dist/utils/swagger/types.js

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * Type definitions for Swagger/OpenAPI parsing
+ * Supports Swagger 2.0 and OpenAPI 3.x (including 3.1)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/utils/swagger/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/utils/swagger/types.ts"],"names":[],"mappings":";AAAA;;;GAGG"}

package/dist/utils/swagger/utils/naming.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Naming convention utilities for generating TypeScript code
+ * Handles conversion between different case styles
+ */
+/**
+ * Convert string to PascalCase
+ * Example: "activity-plan-schedule" -> "ActivityPlanSchedule"
+ */
+export declare function toPascalCase(str: string): string;
+/**
+ * Convert string to camelCase
+ * Example: "activity-plan-schedule" -> "activityPlanSchedule"
+ */
+export declare function toCamelCase(str: string): string;
+/**
+ * Convert path parameter to "By{ParamName}" format
+ * Example: "{id}" -> "ById", "{lessonId}" -> "ByLessonId"
+ */
+export declare function pathParamToByFormat(param: string): string;
+/**
+ * Generate type name from endpoint and method
+ * Example: POST /api/v1/activity/activity-plan-schedule -> postActivityPlanScheduleRequest
+ */
+export declare function generateTypeName(method: string, resourceName: string, pathParams: string[], suffix: 'Request' | 'Response'): string;
+/**
+ * Generate function name from endpoint and method
+ * Example: GET /api/v1/activity/activity-plan-schedule/{id} -> getActivityPlanScheduleById
+ */
+export declare function generateFunctionName(method: string, resourceName: string, pathParams: string[]): string;
+/**
+ * Extract resource name from path
+ * Example: "/api/v1/activity/activity-plan-schedule/{id}" -> "ActivityPlanSchedule"
+ */
+export declare function extractResourceName(path: string): string;
+/**
+ * Extract path parameters from endpoint path
+ * Example: "/api/v1/activity/{id}/items/{itemId}" -> ["id", "itemId"]
+ */
+export declare function extractPathParams(path: string): string[];
+/**
+ * Sanitize a name to be a valid TypeScript identifier
+ */
+export declare function sanitizeIdentifier(name: string): string;
+/**
+ * Convert schema property name to valid TypeScript property
+ */
+export declare function sanitizePropertyName(name: string): string;
+//# sourceMappingURL=naming.d.ts.map

package/dist/utils/swagger/utils/naming.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"naming.d.ts","sourceRoot":"","sources":["../../../../src/utils/swagger/utils/naming.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;GAGG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAKhD;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAG/C;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGzD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC/B,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,EAAE,EACpB,MAAM,EAAE,SAAS,GAAG,UAAU,GAC5B,MAAM,CAKR;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CACnC,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,EAAE,GAClB,MAAM,CAKR;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAexD;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAIxD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAOvD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAMzD"}

package/dist/utils/swagger/utils/naming.js

@@ -0,0 +1,109 @@
+"use strict";
+/**
+ * Naming convention utilities for generating TypeScript code
+ * Handles conversion between different case styles
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toPascalCase = toPascalCase;
+exports.toCamelCase = toCamelCase;
+exports.pathParamToByFormat = pathParamToByFormat;
+exports.generateTypeName = generateTypeName;
+exports.generateFunctionName = generateFunctionName;
+exports.extractResourceName = extractResourceName;
+exports.extractPathParams = extractPathParams;
+exports.sanitizeIdentifier = sanitizeIdentifier;
+exports.sanitizePropertyName = sanitizePropertyName;
+/**
+ * Convert string to PascalCase
+ * Example: "activity-plan-schedule" -> "ActivityPlanSchedule"
+ */
+function toPascalCase(str) {
+    return str
+        .replace(/[-_\s]+(.)?/g, (_, char) => (char ? char.toUpperCase() : ''))
+        .replace(/^(.)/, (char) => char.toUpperCase())
+        .replace(/[^a-zA-Z0-9]/g, '');
+}
+/**
+ * Convert string to camelCase
+ * Example: "activity-plan-schedule" -> "activityPlanSchedule"
+ */
+function toCamelCase(str) {
+    const pascal = toPascalCase(str);
+    return pascal.charAt(0).toLowerCase() + pascal.slice(1);
+}
+/**
+ * Convert path parameter to "By{ParamName}" format
+ * Example: "{id}" -> "ById", "{lessonId}" -> "ByLessonId"
+ */
+function pathParamToByFormat(param) {
+    const cleanParam = param.replace(/[{}]/g, '');
+    return `By${toPascalCase(cleanParam)}`;
+}
+/**
+ * Generate type name from endpoint and method
+ * Example: POST /api/v1/activity/activity-plan-schedule -> postActivityPlanScheduleRequest
+ */
+function generateTypeName(method, resourceName, pathParams, suffix) {
+    const methodLower = method.toLowerCase();
+    const resource = toPascalCase(resourceName);
+    const paramSuffix = pathParams.map((p) => pathParamToByFormat(p)).join('');
+    return `${methodLower}${resource}${paramSuffix}${suffix}`;
+}
+/**
+ * Generate function name from endpoint and method
+ * Example: GET /api/v1/activity/activity-plan-schedule/{id} -> getActivityPlanScheduleById
+ */
+function generateFunctionName(method, resourceName, pathParams) {
+    const methodLower = method.toLowerCase();
+    const resource = toPascalCase(resourceName);
+    const paramSuffix = pathParams.map((p) => pathParamToByFormat(p)).join('');
+    return `${methodLower}${resource}${paramSuffix}`;
+}
+/**
+ * Extract resource name from path
+ * Example: "/api/v1/activity/activity-plan-schedule/{id}" -> "ActivityPlanSchedule"
+ */
+function extractResourceName(path) {
+    // Remove path parameters and split by /
+    const segments = path.split('/').filter((s) => s && !s.startsWith('{') && !s.endsWith('}'));
+    // Skip common prefixes like api, v1, v2, etc.
+    const filteredSegments = segments.filter((s) => !['api', 'v1', 'v2', 'v3'].includes(s.toLowerCase()));
+    // Take the last meaningful segments
+    if (filteredSegments.length === 0)
+        return 'Root';
+    // Join last 2-3 segments to form resource name
+    const relevantSegments = filteredSegments.slice(-3);
+    return relevantSegments.map((s) => toPascalCase(s)).join('');
+}
+/**
+ * Extract path parameters from endpoint path
+ * Example: "/api/v1/activity/{id}/items/{itemId}" -> ["id", "itemId"]
+ */
+function extractPathParams(path) {
+    const matches = path.match(/\{([^}]+)\}/g);
+    if (!matches)
+        return [];
+    return matches.map((m) => m.replace(/[{}]/g, ''));
+}
+/**
+ * Sanitize a name to be a valid TypeScript identifier
+ */
+function sanitizeIdentifier(name) {
+    // Remove invalid characters and ensure it starts with a letter
+    let sanitized = name.replace(/[^a-zA-Z0-9_$]/g, '');
+    if (/^[0-9]/.test(sanitized)) {
+        sanitized = '_' + sanitized;
+    }
+    return sanitized || '_unknown';
+}
+/**
+ * Convert schema property name to valid TypeScript property
+ */
+function sanitizePropertyName(name) {
+    // If name contains special characters, wrap in quotes
+    if (/[^a-zA-Z0-9_$]/.test(name) || /^[0-9]/.test(name)) {
+        return `'${name}'`;
+    }
+    return name;
+}
+//# sourceMappingURL=naming.js.map

package/dist/utils/swagger/utils/naming.js.map

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

package/dist/utils/swagger/utils/pathUtils.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Path utilities for processing API endpoints
+ * Handles path parsing, grouping, and organization
+ */
+import { PathItemObject } from '../types';
+/**
+ * Determine the folder structure for an endpoint
+ * Groups endpoints logically based on path segments
+ */
+export declare function determineFolderStructure(path: string, serviceName: string): string[];
+/**
+ * Strip path parameters from endpoint for base path
+ * Example: "/api/v1/activity/{id}/items/{itemId}" -> "/api/v1/activity"
+ */
+export declare function stripPathParams(path: string): string;
+/**
+ * Generate template literal for path with params
+ * Example: "/api/v1/activity/{id}" -> "`/api/v1/activity/${id}`"
+ */
+export declare function generatePathTemplate(path: string): string;
+/**
+ * Parse query parameters from path (if any exist in the path definition)
+ */
+export declare function parseQueryFromPath(path: string): {
+    basePath: string;
+    queryParams: string[];
+};
+/**
+ * Group endpoints by their logical folder
+ */
+export interface EndpointGroup {
+    folder: string[];
+    endpoints: Array<{
+        path: string;
+        method: string;
+        operationId?: string;
+    }>;
+}
+export declare function groupEndpointsByFolder(paths: Record<string, PathItemObject>, serviceName: string): Map<string, EndpointGroup>;
+//# sourceMappingURL=pathUtils.d.ts.map

package/dist/utils/swagger/utils/pathUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pathUtils.d.ts","sourceRoot":"","sources":["../../../../src/utils/swagger/utils/pathUtils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAG1C;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,CAoCpF;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKpD;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAQzD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG;IACjD,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,EAAE,CAAC;CACtB,CAgBA;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC7B,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,SAAS,EAAE,KAAK,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,WAAW,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC,CAAC;CACH;AAED,wBAAgB,sBAAsB,CACrC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,EACrC,WAAW,EAAE,MAAM,GACjB,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAmC5B"}