swagger-to-playwright-api-clients 1.0.4

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Amar Tanwar
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,190 @@
+# swagger-to-playwright-api-clients
+
+Generate TypeScript API clients from Swagger/OpenAPI specifications for Playwright testing.
+
+## Installation
+
+```bash
+npm install swagger-to-playwright-api-clients
+```
+
+## Quick Start
+
+### 1. Initialize Configuration
+
+```bash
+npx swagger-to-playwright init
+```
+
+This creates a `generator-config.ts` file in your project root.
+
+### 2. Configure Your Sources
+
+Edit `generator-config.ts`:
+
+```typescript
+import type { AutomationConfig } from 'swagger-to-playwright-api-clients';
+import * as path from 'path';
+
+const config: AutomationConfig = {
+	// Output directory for generated clients
+	outputDir: path.join(__dirname, 'src/clients'),
+
+	// Clean output before generation
+	cleanOutput: true,
+
+	// Process sources in parallel
+	parallel: false,
+
+	// BaseAPIClient import path (optional - defaults to '../../../BaseAPIClient')
+	// Generated clients are at: outputDir/generatedClients/ServiceName/FolderName/
+	// The library will auto-copy BaseAPIClient.ts to your outputDir
+	// baseClientPath: '../../../BaseAPIClient',
+
+	// Swagger/OpenAPI sources
+	sources: [
+		{
+			type: 'file',
+			source: './swagger/api.json',
+			serviceName: 'MyService',
+		},
+		{
+			type: 'url',
+			source: 'https://api.example.com/swagger.json',
+			serviceName: 'ExampleService',
+		},
+	],
+};
+
+export default config;
+```
+
+### 3. Generate Clients
+
+```bash
+npx swagger-to-playwright
+```
+
+Or using npm script:
+
+```bash
+npm run generate
+```
+
+## CLI Usage
+
+```bash
+# Generate from config file
+npx swagger-to-playwright
+
+# Generate from specific config
+npx swagger-to-playwright --config ./my-config.ts
+
+# Generate from single file
+npx swagger-to-playwright --file ./swagger.json --output ./src/clients
+
+# Generate from URL
+npx swagger-to-playwright --url https://api.example.com/swagger.json --output ./src/clients
+
+# Show help
+npx swagger-to-playwright --help
+
+# Initialize a new config file
+npx swagger-to-playwright init
+```
+
+## Programmatic Usage
+
+```typescript
+import { generate, generateFromConfig } from 'swagger-to-playwright-api-clients';
+
+// Generate from a single source
+const result = await generate({
+	source: './swagger.json',
+	type: 'file',
+	outputDir: './src/clients',
+	serviceName: 'MyService',
+});
+
+// Generate from config object
+const results = await generateFromConfig({
+	outputDir: './src/clients',
+	sources: [{ type: 'file', source: './swagger.json', serviceName: 'MyService' }],
+});
+```
+
+## Using Generated Clients
+
+```typescript
+import { test, expect } from '@playwright/test';
+import { BaseAPIClient } from './clients/BaseAPIClient';
+import { MyServiceActivityClient } from './clients/generatedClients/MyService/Activity/MyServiceActivityClient';
+
+test('API test example', async () => {
+	const baseClient = new BaseAPIClient('https://api.example.com', {
+		'Content-Type': 'application/json',
+		Authorization: 'Bearer your-token',
+	});
+	await baseClient.init();
+
+	const activityClient = new MyServiceActivityClient(baseClient);
+
+	const { body, status } = await activityClient.getActivities();
+
+	expect(status).toBe(200);
+	expect(body.activities).toBeDefined();
+
+	await baseClient.dispose();
+});
+```
+
+## Configuration Options
+
+| Option           | Type                  | Default                    | Description                          |
+| ---------------- | --------------------- | -------------------------- | ------------------------------------ |
+| `outputDir`      | string                | required                   | Output directory for generated files |
+| `sources`        | SwaggerSourceConfig[] | required                   | Array of swagger sources             |
+| `baseClientPath` | string                | `'../../../BaseAPIClient'` | Custom path to BaseAPIClient         |
+| `copyBaseClient` | boolean               | `true`                     | Copy BaseAPIClient to output         |
+| `cleanOutput`    | boolean               | `true`                     | Clean output before generation       |
+| `parallel`       | boolean               | `false`                    | Process sources in parallel          |
+
+### Source Configuration
+
+| Option        | Type                | Description                   |
+| ------------- | ------------------- | ----------------------------- |
+| `type`        | `'file'` \| `'url'` | Source type                   |
+| `source`      | string              | Path or URL to swagger JSON   |
+| `serviceName` | string              | Override service name         |
+| `outputDir`   | string              | Custom output for this source |
+| `skip`        | boolean             | Skip this source              |
+
+## Generated Structure
+
+```
+src/clients/
+├── BaseAPIClient.ts           # Base client (auto-copied)
+└── generatedClients/
+    └── MyService/
+        ├── Activity/
+        │   ├── types.ts
+        │   └── MyServiceActivityClient.ts
+        ├── Users/
+        │   ├── types.ts
+        │   └── MyServiceUsersClient.ts
+        └── Root/
+            ├── types.ts
+            └── MyServiceRootClient.ts
+```
+
+## Peer Dependencies
+
+This library requires Playwright to be installed in your project:
+
+```bash
+npm install @playwright/test playwright
+```
+
+## License
+
+MIT

package/dist/api.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Programmatic API for the generator
+ * Allows users to use the generator as a library
+ */
+import { AutomationConfig } from './config/types';
+import { RunResults } from './utils/swagger/run-generator';
+import { GeneratorResult } from './utils/swagger/SwaggerGenerator';
+/**
+ * Generate API clients from a single swagger source
+ */
+export declare function generate(options: {
+    source: string;
+    type: 'file' | 'url';
+    outputDir: string;
+    serviceName?: string;
+    baseClientPath?: string;
+    copyBaseClient?: boolean;
+}): Promise<GeneratorResult>;
+/**
+ * Generate API clients from a configuration object
+ */
+export declare function generateFromConfig(config: AutomationConfig): Promise<RunResults>;
+/**
+ * Load configuration from a file path
+ */
+export declare function loadConfig(configPath: string): Promise<AutomationConfig>;
+//# sourceMappingURL=api.d.ts.map

package/dist/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EAAE,gBAAgB,EAA2C,MAAM,gBAAgB,CAAC;AAC3F,OAAO,EAAgB,UAAU,EAAE,MAAM,+BAA+B,CAAC;AACzE,OAAO,EAAoB,eAAe,EAAE,MAAM,kCAAkC,CAAC;AAIrF;;GAEG;AACH,wBAAsB,QAAQ,CAAC,OAAO,EAAE;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,GAAG,KAAK,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,OAAO,CAAC;CACzB,GAAG,OAAO,CAAC,eAAe,CAAC,CA8B3B;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,UAAU,CAAC,CActF;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAuC9E"}

package/dist/api.js

@@ -0,0 +1,127 @@
+"use strict";
+/**
+ * Programmatic API for the generator
+ * Allows users to use the generator as a library
+ */
+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;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generate = generate;
+exports.generateFromConfig = generateFromConfig;
+exports.loadConfig = loadConfig;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const types_1 = require("./config/types");
+const run_generator_1 = require("./utils/swagger/run-generator");
+const SwaggerGenerator_1 = require("./utils/swagger/SwaggerGenerator");
+const copyBaseClient_1 = require("./utils/copyBaseClient");
+/**
+ * Generate API clients from a single swagger source
+ */
+async function generate(options) {
+    const { source, type, outputDir, serviceName, baseClientPath, copyBaseClient: shouldCopyBaseClient = true, } = options;
+    // Copy BaseAPIClient if needed
+    if (shouldCopyBaseClient && !baseClientPath) {
+        await (0, copyBaseClient_1.copyBaseClient)(outputDir);
+    }
+    const generatedClientsDir = path.join(outputDir, 'generatedClients');
+    await fs.promises.mkdir(generatedClientsDir, { recursive: true });
+    const generator = new SwaggerGenerator_1.SwaggerGenerator({
+        outputDir: generatedClientsDir,
+        serviceName,
+        baseClientPath: baseClientPath || types_1.DEFAULT_BASE_CLIENT_PATH,
+    });
+    if (type === 'file') {
+        const filePath = path.isAbsolute(source) ? source : path.join(process.cwd(), source);
+        return generator.generateFromFile(filePath);
+    }
+    else {
+        return generator.generateFromUrl(source);
+    }
+}
+/**
+ * Generate API clients from a configuration object
+ */
+async function generateFromConfig(config) {
+    const mergedConfig = {
+        ...types_1.defaultConfig,
+        ...config,
+    };
+    // Copy BaseAPIClient if needed (when no custom baseClientPath is provided)
+    if (mergedConfig.copyBaseClient !== false && !config.baseClientPath) {
+        await (0, copyBaseClient_1.copyBaseClient)(mergedConfig.outputDir);
+        // Use the default base client path relative to generated clients
+        mergedConfig.baseClientPath = types_1.DEFAULT_BASE_CLIENT_PATH;
+    }
+    return (0, run_generator_1.runGenerator)(mergedConfig);
+}
+/**
+ * Load configuration from a file path
+ */
+async function loadConfig(configPath) {
+    const absolutePath = path.isAbsolute(configPath)
+        ? configPath
+        : path.join(process.cwd(), configPath);
+    if (!fs.existsSync(absolutePath)) {
+        throw new Error(`Configuration file not found: ${absolutePath}`);
+    }
+    // For TypeScript files, we need to use dynamic import or require with ts-node
+    const ext = path.extname(absolutePath);
+    if (ext === '.ts') {
+        // Try to load TypeScript config
+        try {
+            // Check if ts-node is available
+            require.resolve('ts-node');
+            require('ts-node').register({
+                transpileOnly: true,
+                compilerOptions: {
+                    module: 'commonjs',
+                },
+            });
+        }
+        catch {
+            // ts-node not available, try to load compiled JS version
+            const jsPath = absolutePath.replace(/\.ts$/, '.js');
+            if (fs.existsSync(jsPath)) {
+                const config = require(jsPath);
+                return config.default || config;
+            }
+            throw new Error('ts-node is not installed. Install it with: npm install -D ts-node\n' +
+                'Or compile your config to JavaScript first.');
+        }
+    }
+    const config = require(absolutePath);
+    return config.default || config;
+}
+//# sourceMappingURL=api.js.map

package/dist/api.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+/**
+ * CLI entry point for swagger-to-playwright-api-clients
+ */
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;GAEG"}

package/dist/cli.js

@@ -0,0 +1,255 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * CLI entry point for swagger-to-playwright-api-clients
+ */
+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;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const api_1 = require("./api");
+const DEFAULT_CONFIG_NAMES = [
+    'generator-config.ts',
+    'generator-config.js',
+    'swagger-generator.config.ts',
+    'swagger-generator.config.js',
+];
+async function findConfigFile() {
+    const cwd = process.cwd();
+    for (const name of DEFAULT_CONFIG_NAMES) {
+        const configPath = path.join(cwd, name);
+        if (fs.existsSync(configPath)) {
+            return configPath;
+        }
+    }
+    return null;
+}
+function printHelp() {
+    console.log(`
+swagger-to-playwright-api-clients - Generate TypeScript API clients from Swagger/OpenAPI
+
+Usage:
+  swagger-to-playwright [command] [options]
+
+Commands:
+  generate              Generate API clients from config file (default)
+  init                  Create a sample configuration file
+
+Options:
+  --config <path>       Path to config file (default: generator-config.ts)
+  --file <path>         Generate from a single swagger file
+  --url <url>           Generate from a single swagger URL
+  --output <dir>        Output directory (default: ./src/clients)
+  --name <name>         Service name override
+  --help, -h            Show this help message
+  --version, -v         Show version
+
+Examples:
+  # Generate from config file in project root
+  swagger-to-playwright
+
+  # Generate from specific config file
+  swagger-to-playwright --config ./my-config.ts
+
+  # Generate from a single file
+  swagger-to-playwright --file ./swagger.json --output ./src/clients
+
+  # Generate from URL
+  swagger-to-playwright --url https://api.example.com/swagger.json --output ./src/clients
+
+  # Initialize a new config file
+  swagger-to-playwright init
+`);
+}
+function printVersion() {
+    try {
+        const packageJsonPath = path.join(__dirname, '..', 'package.json');
+        const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf-8'));
+        console.log(`swagger-to-playwright-api-clients v${packageJson.version}`);
+    }
+    catch {
+        console.log('swagger-to-playwright-api-clients v1.0.0');
+    }
+}
+async function initConfig() {
+    const configPath = path.join(process.cwd(), 'generator-config.ts');
+    if (fs.existsSync(configPath)) {
+        console.error('Error: generator-config.ts already exists');
+        process.exit(1);
+    }
+    const configContent = `/**
+ * Swagger to Playwright API Client Generator Configuration
+ * 
+ * Customize this file to specify your Swagger/OpenAPI sources.
+ * Run with: npx swagger-to-playwright
+ */
+
+import type { AutomationConfig } from 'swagger-to-playwright-api-clients';
+import * as path from 'path';
+
+const config: AutomationConfig = {
+  // Output directory for generated clients
+  outputDir: path.join(__dirname, 'src/clients'),
+
+  // Clean output before generation
+  cleanOutput: true,
+
+  // Process sources in parallel
+  parallel: false,
+
+  // BaseAPIClient import path (relative to generated client files)
+  // Generated clients are at: outputDir/generatedClients/ServiceName/FolderName/
+  // Default: '../../../BaseAPIClient' - library will copy BaseAPIClient.ts to outputDir
+  // baseClientPath: '../../../BaseAPIClient',
+
+  // Swagger/OpenAPI sources
+  sources: [
+    // Example: Local file
+    // {
+    //   type: 'file',
+    //   source: './swagger/api.json',
+    //   serviceName: 'MyService',
+    // },
+
+    // Example: Remote URL
+    // {
+    //   type: 'url',
+    //   source: 'https://api.example.com/swagger.json',
+    //   serviceName: 'ExampleService',
+    // },
+  ],
+};
+
+export default config;
+`;
+    await fs.promises.writeFile(configPath, configContent, 'utf-8');
+    console.log('Created generator-config.ts');
+    console.log('\nNext steps:');
+    console.log('1. Edit generator-config.ts to add your Swagger sources');
+    console.log('2. Run: npx swagger-to-playwright');
+}
+async function main() {
+    const args = process.argv.slice(2);
+    // Handle help
+    if (args.includes('--help') || args.includes('-h')) {
+        printHelp();
+        return;
+    }
+    // Handle version
+    if (args.includes('--version') || args.includes('-v')) {
+        printVersion();
+        return;
+    }
+    // Handle init command
+    if (args[0] === 'init') {
+        await initConfig();
+        return;
+    }
+    // Handle single file/url mode
+    const fileIndex = args.indexOf('--file');
+    const urlIndex = args.indexOf('--url');
+    const outputIndex = args.indexOf('--output');
+    const nameIndex = args.indexOf('--name');
+    if (fileIndex !== -1 || urlIndex !== -1) {
+        const outputDir = outputIndex !== -1 ? args[outputIndex + 1] : './src/clients';
+        const serviceName = nameIndex !== -1 ? args[nameIndex + 1] : undefined;
+        const type = fileIndex !== -1 ? 'file' : 'url';
+        const source = fileIndex !== -1 ? args[fileIndex + 1] : args[urlIndex + 1];
+        if (!source) {
+            console.error(`Error: Missing ${type} path`);
+            process.exit(1);
+        }
+        console.log(`Generating from ${type}: ${source}`);
+        const result = await (0, api_1.generate)({
+            source,
+            type,
+            outputDir: path.resolve(outputDir),
+            serviceName,
+        });
+        if (result.success) {
+            console.log(`\n✓ Successfully generated ${result.filesWritten.length} files`);
+            console.log(`\nFolder Structure:\n${result.folderStructure}`);
+        }
+        else {
+            console.error(`\n✗ Generation failed: ${result.errors.join(', ')}`);
+            process.exit(1);
+        }
+        return;
+    }
+    // Handle config-based generation
+    const configIndex = args.indexOf('--config');
+    let configPath = null;
+    if (configIndex !== -1) {
+        configPath = args[configIndex + 1];
+        if (!configPath) {
+            console.error('Error: Missing config file path');
+            process.exit(1);
+        }
+    }
+    else {
+        configPath = await findConfigFile();
+    }
+    if (!configPath) {
+        console.error('Error: No configuration file found.');
+        console.error('Create a generator-config.ts file or use --config to specify one.');
+        console.error('\nRun "swagger-to-playwright init" to create a sample config file.');
+        process.exit(1);
+    }
+    console.log(`Using config: ${configPath}`);
+    try {
+        const config = await (0, api_1.loadConfig)(configPath);
+        const results = await (0, api_1.generateFromConfig)(config);
+        console.log('\n' + '='.repeat(60));
+        console.log('Generation Complete');
+        console.log('='.repeat(60));
+        console.log(`Total Sources: ${results.totalSources}`);
+        console.log(`Successful: ${results.successful}`);
+        console.log(`Failed: ${results.failed}`);
+        console.log(`Skipped: ${results.skipped}`);
+        if (results.failed > 0) {
+            process.exit(1);
+        }
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        console.error(`Error: ${message}`);
+        process.exit(1);
+    }
+}
+main().catch((error) => {
+    console.error('Fatal error:', error);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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