swagger-to-playwright-api-clients 1.0.4

package/dist/utils/copyBaseClient.js

@@ -0,0 +1,354 @@
+"use strict";
+/**
+ * Utility to copy BaseAPIClient to user's project
+ */
+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.copyBaseClient = copyBaseClient;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const logger_1 = __importDefault(require("./logger"));
+/**
+ * BaseAPIClient template content - standalone version without winston dependency
+ */
+const BASE_API_CLIENT_CONTENT = `/**
+ * BaseAPIClient - Base class for making API requests using Playwright's APIRequestContext
+ * Generated by swagger-to-playwright-api-clients
+ */
+
+import { request, APIRequestContext } from '@playwright/test';
+
+/**
+ * Options for individual API requests
+ */
+export interface RequestOptions {
+	headers?: Record<string, string>;
+	params?: Record<string, string | number | boolean | undefined>;
+	timeout?: number;
+}
+
+/**
+ * Standard API response result
+ */
+export interface APIResponseResult<T = unknown> {
+	body: T;
+	status: number;
+	headers: Record<string, string>;
+}
+
+/**
+ * Logger interface - implement this to customize logging
+ */
+export interface APIClientLogger {
+	info(message: string): void;
+	debug(message: string): void;
+	error(message: string): void;
+}
+
+/**
+ * Default console logger
+ */
+const defaultLogger: APIClientLogger = {
+	info: (msg) => console.log(\`[INFO] \${msg}\`),
+	debug: (msg) => console.debug(\`[DEBUG] \${msg}\`),
+	error: (msg) => console.error(\`[ERROR] \${msg}\`),
+};
+
+/**
+ * BaseAPIClient - Provides HTTP methods using Playwright's request API
+ */
+export class BaseAPIClient {
+	private baseURL: string;
+	private defaultHeaders: Record<string, string>;
+	private context: APIRequestContext | null = null;
+	private logger: APIClientLogger;
+
+	constructor(
+		baseURL: string,
+		defaultHeaders: Record<string, string> = {},
+		logger: APIClientLogger = defaultLogger
+	) {
+		this.baseURL = baseURL;
+		this.defaultHeaders = defaultHeaders;
+		this.logger = logger;
+	}
+
+	/**
+	 * Initialize the API request context
+	 */
+	async init(): Promise<void> {
+		this.context = await request.newContext({
+			baseURL: this.baseURL,
+			extraHTTPHeaders: this.defaultHeaders,
+		});
+		this.logger.info(\`BaseAPIClient initialized with baseURL: \${this.baseURL}\`);
+	}
+
+	/**
+	 * Dispose the API request context
+	 */
+	async dispose(): Promise<void> {
+		if (this.context) {
+			await this.context.dispose();
+			this.context = null;
+			this.logger.info('BaseAPIClient disposed');
+		}
+	}
+
+	/**
+	 * Get the request context, initializing if needed
+	 */
+	private async getContext(): Promise<APIRequestContext> {
+		if (!this.context) {
+			await this.init();
+		}
+		return this.context!;
+	}
+
+	/**
+	 * Build URL with query parameters
+	 */
+	private buildUrl(
+		endpoint: string,
+		params?: Record<string, string | number | boolean | undefined>
+	): string {
+		if (!params) return endpoint;
+
+		const searchParams = new URLSearchParams();
+		for (const [key, value] of Object.entries(params)) {
+			if (value !== undefined) {
+				searchParams.append(key, String(value));
+			}
+		}
+
+		const queryString = searchParams.toString();
+		if (!queryString) return endpoint;
+
+		return \`\${endpoint}\${endpoint.includes('?') ? '&' : '?'}\${queryString}\`;
+	}
+
+	/**
+	 * Log request details
+	 */
+	private logRequest(
+		method: string,
+		url: string,
+		headers?: Record<string, string>,
+		body?: unknown
+	): void {
+		this.logger.info(\`>>> \${method} \${this.baseURL}\${url}\`);
+		const allHeaders = { ...this.defaultHeaders, ...headers };
+		this.logger.debug(\`Headers: \${JSON.stringify(allHeaders, null, 2)}\`);
+		if (body !== undefined) {
+			this.logger.info(\`Body: \${JSON.stringify(body, null, 2)}\`);
+		}
+	}
+
+	/**
+	 * Log response details
+	 */
+	private logResponse<T>(method: string, url: string, status: number, body: T): void {
+		this.logger.info(\`<<< \${method} \${this.baseURL}\${url} - Status: \${status}\`);
+		this.logger.info(\`Response: \${JSON.stringify(body, null, 2)}\`);
+	}
+
+	/**
+	 * Parse response into standard result format
+	 */
+	private async parseResponse<T>(
+		response: Awaited<ReturnType<APIRequestContext['get']>>
+	): Promise<APIResponseResult<T>> {
+		let body: T;
+		const contentType = response.headers()['content-type'] || '';
+
+		if (contentType.includes('application/json')) {
+			try {
+				body = await response.json();
+			} catch {
+				body = (await response.text()) as unknown as T;
+			}
+		} else {
+			body = (await response.text()) as unknown as T;
+		}
+
+		return {
+			body,
+			status: response.status(),
+			headers: response.headers(),
+		};
+	}
+
+	/**
+	 * GET request
+	 */
+	async get<T = unknown>(
+		endpoint: string,
+		options?: RequestOptions
+	): Promise<APIResponseResult<T>> {
+		const ctx = await this.getContext();
+		const url = this.buildUrl(endpoint, options?.params);
+
+		this.logRequest('GET', url, options?.headers);
+
+		const response = await ctx.get(url, {
+			headers: options?.headers,
+			timeout: options?.timeout,
+		});
+
+		const result = await this.parseResponse<T>(response);
+		this.logResponse('GET', url, result.status, result.body);
+
+		return result;
+	}
+
+	/**
+	 * POST request
+	 */
+	async post<T = unknown>(
+		endpoint: string,
+		data?: unknown,
+		options?: RequestOptions
+	): Promise<APIResponseResult<T>> {
+		const ctx = await this.getContext();
+		const url = this.buildUrl(endpoint, options?.params);
+
+		this.logRequest('POST', url, options?.headers, data);
+
+		const response = await ctx.post(url, {
+			data,
+			headers: options?.headers,
+			timeout: options?.timeout,
+		});
+
+		const result = await this.parseResponse<T>(response);
+		this.logResponse('POST', url, result.status, result.body);
+
+		return result;
+	}
+
+	/**
+	 * PUT request
+	 */
+	async put<T = unknown>(
+		endpoint: string,
+		data?: unknown,
+		options?: RequestOptions
+	): Promise<APIResponseResult<T>> {
+		const ctx = await this.getContext();
+		const url = this.buildUrl(endpoint, options?.params);
+
+		this.logRequest('PUT', url, options?.headers, data);
+
+		const response = await ctx.put(url, {
+			data,
+			headers: options?.headers,
+			timeout: options?.timeout,
+		});
+
+		const result = await this.parseResponse<T>(response);
+		this.logResponse('PUT', url, result.status, result.body);
+
+		return result;
+	}
+
+	/**
+	 * PATCH request
+	 */
+	async patch<T = unknown>(
+		endpoint: string,
+		data?: unknown,
+		options?: RequestOptions
+	): Promise<APIResponseResult<T>> {
+		const ctx = await this.getContext();
+		const url = this.buildUrl(endpoint, options?.params);
+
+		this.logRequest('PATCH', url, options?.headers, data);
+
+		const response = await ctx.patch(url, {
+			data,
+			headers: options?.headers,
+			timeout: options?.timeout,
+		});
+
+		const result = await this.parseResponse<T>(response);
+		this.logResponse('PATCH', url, result.status, result.body);
+
+		return result;
+	}
+
+	/**
+	 * DELETE request
+	 */
+	async delete<T = unknown>(
+		endpoint: string,
+		data?: unknown,
+		options?: RequestOptions
+	): Promise<APIResponseResult<T>> {
+		const ctx = await this.getContext();
+		const url = this.buildUrl(endpoint, options?.params);
+
+		this.logRequest('DELETE', url, options?.headers, data);
+
+		const response = await ctx.delete(url, {
+			data,
+			headers: options?.headers,
+			timeout: options?.timeout,
+		});
+
+		const result = await this.parseResponse<T>(response);
+		this.logResponse('DELETE', url, result.status, result.body);
+
+		return result;
+	}
+}
+
+export default BaseAPIClient;
+`;
+/**
+ * Copy BaseAPIClient to the specified output directory
+ */
+async function copyBaseClient(outputDir) {
+    const targetPath = path.join(outputDir, 'BaseAPIClient.ts');
+    // Ensure directory exists
+    await fs.promises.mkdir(outputDir, { recursive: true });
+    // Write the file
+    await fs.promises.writeFile(targetPath, BASE_API_CLIENT_CONTENT, 'utf-8');
+    logger_1.default.info(`BaseAPIClient copied to: ${targetPath}`);
+    return targetPath;
+}
+//# sourceMappingURL=copyBaseClient.js.map

package/dist/utils/copyBaseClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"copyBaseClient.js","sourceRoot":"","sources":["../../src/utils/copyBaseClient.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkTH,wCAYC;AA5TD,uCAAyB;AACzB,2CAA6B;AAC7B,sDAA8B;AAE9B;;GAEG;AACH,MAAM,uBAAuB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoS/B,CAAC;AAEF;;GAEG;AACI,KAAK,UAAU,cAAc,CAAC,SAAiB;IACrD,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,kBAAkB,CAAC,CAAC;IAE5D,0BAA0B;IAC1B,MAAM,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAExD,iBAAiB;IACjB,MAAM,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,UAAU,EAAE,uBAAuB,EAAE,OAAO,CAAC,CAAC;IAE1E,gBAAM,CAAC,IAAI,CAAC,4BAA4B,UAAU,EAAE,CAAC,CAAC;IAEtD,OAAO,UAAU,CAAC;AACnB,CAAC"}

package/dist/utils/logger.d.ts

@@ -0,0 +1,6 @@
+import winston from 'winston';
+declare const logger: winston.Logger;
+export declare const logRequest: (method: string, url: string, statusCode: number, duration: number) => void;
+export declare const logError: (error: Error, context?: string) => void;
+export default logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,SAAS,CAAC;AA4B9B,QAAA,MAAM,MAAM,gBAsBV,CAAC;AAGH,eAAO,MAAM,UAAU,GACtB,QAAQ,MAAM,EACd,KAAK,MAAM,EACX,YAAY,MAAM,EAClB,UAAU,MAAM,KACd,IAEF,CAAC;AAEF,eAAO,MAAM,QAAQ,GAAI,OAAO,KAAK,EAAE,gBAAY,KAAG,IAGrD,CAAC;AAEF,eAAe,MAAM,CAAC"}

package/dist/utils/logger.js

@@ -0,0 +1,57 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.logError = exports.logRequest = void 0;
+const winston_1 = __importDefault(require("winston"));
+const path_1 = __importDefault(require("path"));
+// Define log directory
+const logDir = path_1.default.join(process.cwd(), 'logs');
+// Custom log format
+const logFormat = winston_1.default.format.combine(winston_1.default.format.timestamp({ format: 'YYYY-MM-DD HH:mm:ss' }), winston_1.default.format.errors({ stack: true }), winston_1.default.format.printf(({ level, message, timestamp, stack }) => {
+    if (stack) {
+        return `${timestamp} [${level.toUpperCase()}]: ${message}\n${stack}`;
+    }
+    return `${timestamp} [${level.toUpperCase()}]: ${message}`;
+}));
+// Console format with colors
+const consoleFormat = winston_1.default.format.combine(winston_1.default.format.colorize({ all: true }), winston_1.default.format.timestamp({ format: 'YYYY-MM-DD HH:mm:ss' }), winston_1.default.format.printf(({ level, message, timestamp }) => {
+    return `${timestamp} [${level}]: ${message}`;
+}));
+// Create logger instance
+const logger = winston_1.default.createLogger({
+    level: process.env.LOG_LEVEL || 'info',
+    format: logFormat,
+    transports: [
+        // Console transport
+        new winston_1.default.transports.Console({
+            format: consoleFormat,
+        }),
+        // Combined log file
+        new winston_1.default.transports.File({
+            filename: path_1.default.join(logDir, 'combined.log'),
+            maxsize: 5242880, // 5MB
+            maxFiles: 5,
+        }),
+        // Error log file
+        new winston_1.default.transports.File({
+            filename: path_1.default.join(logDir, 'error.log'),
+            level: 'error',
+            maxsize: 5242880, // 5MB
+            maxFiles: 5,
+        }),
+    ],
+});
+// Utility methods
+const logRequest = (method, url, statusCode, duration) => {
+    logger.info(`${method} ${url} - ${statusCode} (${duration}ms)`);
+};
+exports.logRequest = logRequest;
+const logError = (error, context = '') => {
+    const errorMessage = context ? `${context}: ${error.message}` : error.message;
+    logger.error(errorMessage, { stack: error.stack });
+};
+exports.logError = logError;
+exports.default = logger;
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

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

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

@@ -0,0 +1,49 @@
+/**
+ * ClientGenerator - Generates API client functions from parsed endpoints
+ * Uses BaseAPIClient for all HTTP requests
+ */
+import { ParsedEndpoint } from './types';
+import { TypeGenerator } from './TypeGenerator';
+export interface GeneratedFunction {
+    name: string;
+    code: string;
+    endpoint: ParsedEndpoint;
+}
+export declare class ClientGenerator {
+    private typeGenerator;
+    private baseClientPath;
+    constructor(typeGenerator: TypeGenerator, baseClientPath?: string);
+    /**
+     * Generate client function for an endpoint
+     */
+    generateClientFunction(endpoint: ParsedEndpoint): GeneratedFunction;
+    /**
+     * Generate all client functions for a group of endpoints
+     */
+    generateClientFunctions(endpoints: ParsedEndpoint[]): GeneratedFunction[];
+    /**
+     * Build the function code
+     */
+    private buildFunctionCode;
+    /**
+     * Build function parameters
+     */
+    private buildFunctionParams;
+    /**
+     * Build query params type
+     */
+    private buildQueryParamsType;
+    /**
+     * Build function body
+     */
+    private buildFunctionBody;
+    /**
+     * Build JSDoc comment
+     */
+    private buildJsDoc;
+    /**
+     * Generate a complete client class for a group of endpoints
+     */
+    generateClientClass(className: string, endpoints: ParsedEndpoint[], typeImports: string[]): string;
+}
+//# sourceMappingURL=ClientGenerator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ClientGenerator.d.ts","sourceRoot":"","sources":["../../../src/utils/swagger/ClientGenerator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAShD,MAAM,WAAW,iBAAiB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,cAAc,CAAC;CACzB;AAED,qBAAa,eAAe;IAC3B,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,cAAc,CAAS;gBAEnB,aAAa,EAAE,aAAa,EAAE,cAAc,CAAC,EAAE,MAAM;IAKjE;;OAEG;IACH,sBAAsB,CAAC,QAAQ,EAAE,cAAc,GAAG,iBAAiB;IAcnE;;OAEG;IACH,uBAAuB,CAAC,SAAS,EAAE,cAAc,EAAE,GAAG,iBAAiB,EAAE;IAIzE;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAyBzB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAqC3B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAS5B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAsCzB;;OAEG;IACH,OAAO,CAAC,UAAU;IAiClB;;OAEG;IACH,mBAAmB,CAClB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,cAAc,EAAE,EAC3B,WAAW,EAAE,MAAM,EAAE,GACnB,MAAM;CAwBT"}

package/dist/utils/swagger/ClientGenerator.js

@@ -0,0 +1,192 @@
+"use strict";
+/**
+ * ClientGenerator - Generates API client functions from parsed endpoints
+ * Uses BaseAPIClient for all HTTP requests
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ClientGenerator = void 0;
+const naming_1 = require("./utils/naming");
+const pathUtils_1 = require("./utils/pathUtils");
+class ClientGenerator {
+    typeGenerator;
+    baseClientPath;
+    constructor(typeGenerator, baseClientPath) {
+        this.typeGenerator = typeGenerator;
+        this.baseClientPath = baseClientPath || '../../clients/BaseAPIClient';
+    }
+    /**
+     * Generate client function for an endpoint
+     */
+    generateClientFunction(endpoint) {
+        const resourceName = (0, naming_1.extractResourceName)(endpoint.path);
+        const pathParams = (0, naming_1.extractPathParams)(endpoint.path);
+        const functionName = (0, naming_1.generateFunctionName)(endpoint.method, resourceName, pathParams);
+        const code = this.buildFunctionCode(endpoint, functionName);
+        return {
+            name: functionName,
+            code,
+            endpoint,
+        };
+    }
+    /**
+     * Generate all client functions for a group of endpoints
+     */
+    generateClientFunctions(endpoints) {
+        return endpoints.map((endpoint) => this.generateClientFunction(endpoint));
+    }
+    /**
+     * Build the function code
+     */
+    buildFunctionCode(endpoint, functionName) {
+        const pathParams = (0, naming_1.extractPathParams)(endpoint.path);
+        const pathTemplate = (0, pathUtils_1.generatePathTemplate)(endpoint.path);
+        const method = endpoint.method.toLowerCase();
+        // Build function parameters
+        const params = this.buildFunctionParams(endpoint, pathParams);
+        // Build function body
+        const body = this.buildFunctionBody(endpoint, method, pathTemplate);
+        // Get type annotations
+        const requestTypeName = this.typeGenerator.getRequestTypeName(endpoint);
+        const responseTypeName = this.typeGenerator.getResponseTypeName(endpoint) || 'unknown';
+        // Build JSDoc comment
+        const jsDoc = this.buildJsDoc(endpoint);
+        // Build the complete function
+        return `${jsDoc}
+${functionName} = async (${params}): Promise<APIResponseResult<${responseTypeName}>> => {
+  ${body}
+}`;
+    }
+    /**
+     * Build function parameters
+     */
+    buildFunctionParams(endpoint, pathParams) {
+        const params = [];
+        // Add path parameters
+        for (const param of pathParams) {
+            const paramDef = endpoint.pathParams.find((p) => p.name === param);
+            const type = paramDef?.type || 'string';
+            params.push(`${(0, naming_1.toCamelCase)(param)}: ${type}`);
+        }
+        // Determine if we need a data/payload parameter
+        const hasRequestBody = !!endpoint.requestBody;
+        const hasQueryParams = endpoint.queryParams.length > 0;
+        const method = endpoint.method.toLowerCase();
+        if (hasRequestBody && ['post', 'put', 'patch', 'delete'].includes(method)) {
+            const requestTypeName = this.typeGenerator.getRequestTypeName(endpoint);
+            if (requestTypeName) {
+                params.push(`data: ${requestTypeName}`);
+            }
+            else {
+                params.push('data: unknown');
+            }
+        }
+        // Add query params as options if they exist
+        if (hasQueryParams) {
+            const queryType = this.buildQueryParamsType(endpoint);
+            const optional = endpoint.queryParams.every((p) => !p.required);
+            params.push(`params${optional ? '?' : ''}: ${queryType}`);
+        }
+        // Add optional request options
+        params.push('options?: RequestOptions');
+        return params.join(', ');
+    }
+    /**
+     * Build query params type
+     */
+    buildQueryParamsType(endpoint) {
+        const props = endpoint.queryParams.map((param) => {
+            const optional = param.required ? '' : '?';
+            return `${param.name}${optional}: ${param.type}`;
+        });
+        return `{ ${props.join('; ')} }`;
+    }
+    /**
+     * Build function body
+     */
+    buildFunctionBody(endpoint, method, pathTemplate) {
+        const hasQueryParams = endpoint.queryParams.length > 0;
+        const hasRequestBody = !!endpoint.requestBody;
+        const lines = [];
+        // Build request options
+        if (hasQueryParams) {
+            lines.push('const reqOptions = { ...options, params };');
+        }
+        // Build the request call
+        const optionsArg = hasQueryParams ? 'reqOptions' : 'options';
+        if (['post', 'put', 'patch'].includes(method)) {
+            if (hasRequestBody) {
+                lines.push(`return this.client.${method}(${pathTemplate}, data, ${optionsArg});`);
+            }
+            else {
+                lines.push(`return this.client.${method}(${pathTemplate}, {}, ${optionsArg});`);
+            }
+        }
+        else if (method === 'delete') {
+            if (hasRequestBody) {
+                lines.push(`return this.client.delete(${pathTemplate}, data, ${optionsArg});`);
+            }
+            else {
+                lines.push(`return this.client.delete(${pathTemplate}, undefined, ${optionsArg});`);
+            }
+        }
+        else {
+            // GET
+            lines.push(`return this.client.${method}(${pathTemplate}, ${optionsArg});`);
+        }
+        return lines.join('\n  ');
+    }
+    /**
+     * Build JSDoc comment
+     */
+    buildJsDoc(endpoint) {
+        const lines = ['/**'];
+        if (endpoint.summary) {
+            lines.push(` * ${endpoint.summary}`);
+        }
+        if (endpoint.description) {
+            lines.push(` * ${endpoint.description}`);
+        }
+        if (endpoint.deprecated) {
+            lines.push(' * @deprecated');
+        }
+        // Add param docs
+        for (const param of endpoint.pathParams) {
+            lines.push(` * @param ${param.name} - ${param.description || 'Path parameter'}`);
+        }
+        if (endpoint.requestBody) {
+            lines.push(' * @param data - Request body');
+        }
+        if (endpoint.queryParams.length > 0) {
+            lines.push(' * @param params - Query parameters');
+        }
+        lines.push(' */');
+        return lines.join('\n');
+    }
+    /**
+     * Generate a complete client class for a group of endpoints
+     */
+    generateClientClass(className, endpoints, typeImports) {
+        const functions = this.generateClientFunctions(endpoints);
+        const functionCode = functions.map((f) => `  ${f.code}`).join('\n\n');
+        return `import { BaseAPIClient, RequestOptions, APIResponseResult } from '${this.baseClientPath}';
+${typeImports.length > 0 ? `import { ${typeImports.join(', ')} } from './types';` : ''}
+
+/**
+ * ${className} - Auto-generated API client
+ */
+export class ${className} {
+  private client: BaseAPIClient;
+
+  constructor(client: BaseAPIClient) {
+    this.client = client;
+  }
+
+${functionCode}
+}
+
+export default ${className};
+`;
+    }
+}
+exports.ClientGenerator = ClientGenerator;
+//# sourceMappingURL=ClientGenerator.js.map

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

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