swagger-to-playwright-api-clients 1.0.4

package/dist/utils/swagger/utils/pathUtils.js

@@ -0,0 +1,118 @@
+"use strict";
+/**
+ * Path utilities for processing API endpoints
+ * Handles path parsing, grouping, and organization
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.determineFolderStructure = determineFolderStructure;
+exports.stripPathParams = stripPathParams;
+exports.generatePathTemplate = generatePathTemplate;
+exports.parseQueryFromPath = parseQueryFromPath;
+exports.groupEndpointsByFolder = groupEndpointsByFolder;
+const naming_1 = require("./naming");
+/**
+ * Determine the folder structure for an endpoint
+ * Groups endpoints logically based on path segments
+ */
+function determineFolderStructure(path, serviceName) {
+    const segments = path.split('/').filter((s) => s && !s.startsWith('{') && !s.endsWith('}'));
+    // Skip common prefixes
+    const filtered = segments.filter((s) => !['api', 'v1', 'v2', 'v3'].includes(s.toLowerCase()));
+    // Start with service name
+    const folders = [(0, naming_1.toPascalCase)(serviceName)];
+    // If only one segment after filtering (e.g., /health, /metrics), use Root folder
+    if (filtered.length <= 1) {
+        folders.push('Root');
+        return folders;
+    }
+    // Check for therapist keyword - create dedicated folder
+    for (const segment of filtered) {
+        if (segment.toLowerCase().includes('therapist')) {
+            folders.push('Therapist');
+            break;
+        }
+    }
+    // Group by first meaningful segment after service name
+    if (filtered.length > 1) {
+        // Use the first segment after the service-like segment
+        const groupSegment = filtered[0];
+        if (!folders.includes((0, naming_1.toPascalCase)(groupSegment)) &&
+            groupSegment.toLowerCase() !== 'therapist') {
+            folders.push((0, naming_1.toPascalCase)(groupSegment));
+        }
+    }
+    return folders;
+}
+/**
+ * Strip path parameters from endpoint for base path
+ * Example: "/api/v1/activity/{id}/items/{itemId}" -> "/api/v1/activity"
+ */
+function stripPathParams(path) {
+    return path
+        .split('/')
+        .filter((s) => !s.startsWith('{'))
+        .join('/');
+}
+/**
+ * Generate template literal for path with params
+ * Example: "/api/v1/activity/{id}" -> "`/api/v1/activity/${id}`"
+ */
+function generatePathTemplate(path) {
+    const hasParams = path.includes('{');
+    if (!hasParams) {
+        return `'${path}'`;
+    }
+    // Convert {param} to ${param}
+    const template = path.replace(/\{([^}]+)\}/g, '${$1}');
+    return '`' + template + '`';
+}
+/**
+ * Parse query parameters from path (if any exist in the path definition)
+ */
+function parseQueryFromPath(path) {
+    const [basePath, query] = path.split('?');
+    if (!query) {
+        return { basePath, queryParams: [] };
+    }
+    const queryParams = [];
+    const params = query.split('&');
+    for (const param of params) {
+        const [key] = param.split('=');
+        if (key) {
+            queryParams.push(key.replace(/[{}]/g, ''));
+        }
+    }
+    return { basePath, queryParams };
+}
+function groupEndpointsByFolder(paths, serviceName) {
+    const groups = new Map();
+    for (const [path, pathItem] of Object.entries(paths)) {
+        const folders = determineFolderStructure(path, serviceName);
+        const folderKey = folders.join('/');
+        if (!groups.has(folderKey)) {
+            groups.set(folderKey, {
+                folder: folders,
+                endpoints: [],
+            });
+        }
+        const methods = [
+            'get',
+            'post',
+            'put',
+            'patch',
+            'delete',
+        ];
+        for (const method of methods) {
+            const operation = pathItem[method];
+            if (operation) {
+                groups.get(folderKey).endpoints.push({
+                    path,
+                    method: method.toUpperCase(),
+                    operationId: operation.operationId,
+                });
+            }
+        }
+    }
+    return groups;
+}
+//# sourceMappingURL=pathUtils.js.map

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

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

package/package.json

@@ -0,0 +1,56 @@
+{
+	"name": "swagger-to-playwright-api-clients",
+	"version": "1.0.4",
+	"description": "Generate TypeScript API clients from Swagger/OpenAPI specifications for Playwright testing",
+	"main": "dist/index.js",
+	"types": "dist/index.d.ts",
+	"bin": {
+		"swagger-to-playwright": "./dist/cli.js"
+	},
+	"files": [
+		"dist",
+		"README.md"
+	],
+	"scripts": {
+		"build": "tsc",
+		"build:watch": "tsc --watch",
+		"prepublishOnly": "npm run build",
+		"test": "npx playwright test",
+		"generate": "npx ts-node src/cli.ts",
+		"generate:help": "npx ts-node src/cli.ts --help",
+		"format": "prettier --write .",
+		"format:check": "prettier --check ."
+	},
+	"keywords": [
+		"swagger",
+		"openapi",
+		"playwright",
+		"api-client",
+		"code-generator",
+		"typescript"
+	],
+	"author": "",
+	"license": "MIT",
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/amartanwar42/swagger-to-playwright-api-clients"
+	},
+	"engines": {
+		"node": ">=18.0.0"
+	},
+	"peerDependencies": {
+		"@playwright/test": ">=1.40.0",
+		"playwright": ">=1.40.0"
+	},
+	"dependencies": {
+		"winston": "^3.19.0"
+	},
+	"devDependencies": {
+		"@playwright/test": "^1.58.2",
+		"@types/node": "^25.3.0",
+		"playwright": "^1.58.2",
+		"prettier": "^3.5.3",
+		"ts-node": "^10.9.2",
+		"typescript": "^5.9.3"
+	}
+}