create-swagger-client 0.1.2 → 0.1.4

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Cuong Nguyen
+
+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

@@ -11,6 +11,13 @@ A TypeScript tool that generates a fully type-safe REST API client from OpenAPI/
 - 🌐 **URL or File Input**: Generate from remote URLs or local files
 - 🎯 **Type Inference**: Automatic extraction of path params, query params, headers, and request/response types
 
+## Installation
+
+```bash
+npm install -g create-swagger-client
+# or
+npx create-swagger-client
+```
 
 ## Usage
 
@@ -180,24 +187,10 @@ try {
 }
 ```
 
-## Development
-
-### Build
-
-```bash
-bun run build
-```
-
-### Type Check
-
-```bash
-bun run typecheck
-```
-
 ## Requirements
 
-- TypeScript 5.x
-- Node.js 16+ or Bun
+- Node.js 16+ (for running the CLI)
+- TypeScript 5.x (peer dependency for generated types)
 
 ## License
 

package/index.mjs

@@ -6,7 +6,7 @@ import * as tsMorph from "ts-morph";
 
 var args = process.argv.slice(2);
 var source = args[0];
-var outPut = args[1] || "client-api.ts";
+var outPut = args[1] || "swagger-client.ts";
 if (!source) {
   console.error("Please provide a source URL or file path.");
   process.exit(1);
@@ -20,45 +20,48 @@ var isUrl = (str) => {
   }
 };
 async function generate() {
-  if (!source)
-    return;
+  if (!source) return;
   if (isUrl(source) === false) {
     source = resolve(process.cwd(), source);
   }
   const spinner = ora(`Generating API client from ${source}...`).start();
   const ast = await openapiTS(source);
   const contents = astToString(ast);
-  const project = new tsMorph.Project;
-  const sourceFile = project.createSourceFile(resolve(process.cwd(), outPut), contents, {
-    overwrite: true
-  });
+  const project = new tsMorph.Project();
+  const sourceFile = project.createSourceFile(
+    resolve(process.cwd(), outPut),
+    contents,
+    {
+      overwrite: true,
+    },
+  );
   sourceFile.addTypeAlias({
     name: "RestMethod",
     isExported: true,
-    type: '"get" | "post" | "put" | "delete" | "patch"'
+    type: '"get" | "post" | "put" | "delete" | "patch"',
   });
   sourceFile.addTypeAlias({
     name: "KeyPaths",
     isExported: true,
-    type: "keyof paths"
+    type: "keyof paths",
   });
   sourceFile.addTypeAlias({
     name: "ExtractPathParams",
     isExported: true,
     typeParameters: ["T extends KeyPaths", "K extends RestMethod"],
-    type: "paths[T][K] extends { parameters: { path?: infer P } } ? P : never"
+    type: "paths[T][K] extends { parameters: { path?: infer P } } ? P : never",
   });
   sourceFile.addTypeAlias({
     name: "ExtractQueryParams",
     isExported: true,
     typeParameters: ["T extends KeyPaths", "K extends RestMethod"],
-    type: "paths[T][K] extends { parameters: { query?: infer Q } } ? Q : never"
+    type: "paths[T][K] extends { parameters: { query?: infer Q } } ? Q : never",
   });
   sourceFile.addTypeAlias({
     name: "ExtractHeaderParams",
     isExported: true,
     typeParameters: ["T extends KeyPaths", "K extends RestMethod"],
-    type: "paths[T][K] extends { parameters: { header?: infer H } } ? H : never"
+    type: "paths[T][K] extends { parameters: { header?: infer H } } ? H : never",
   });
   sourceFile.addTypeAlias({
     name: "ExtractBody",
@@ -68,7 +71,7 @@ async function generate() {
   requestBody: { content: { "application/json": infer B } };
 }
   ? B
-  : never`
+  : never`,
   });
   sourceFile.addTypeAlias({
     name: "APIResponse",
@@ -80,7 +83,7 @@ async function generate() {
     | { [code: number]: { content: { "application/json": infer R } } };
 }
   ? R
-  : unknown`
+  : unknown`,
   });
   sourceFile.addTypeAlias({
     name: "ApiPayload",
@@ -91,7 +94,7 @@ async function generate() {
   query?: ExtractQueryParams<T, K>;
   body?: K extends "post" | "put" | "patch" ? ExtractBody<T, K> : never;
   headers?: ExtractHeaderParams<T, K>;
-}`
+}`,
   });
   sourceFile.addTypeAlias({
     name: "ApiClientType",
@@ -101,14 +104,14 @@ async function generate() {
     path: T,
     payload?: ApiPayload<T, K>,
   ) => Promise<APIResponse<T, K>>;
-}`
+}`,
   });
   sourceFile.addTypeAlias({
     name: "TypePaths",
     typeParameters: ["T extends RestMethod"],
     type: `{
   [K in KeyPaths]: paths[K] extends { [M in T]: unknown } ? K : never;
-}[KeyPaths]`
+}[KeyPaths]`,
   });
   sourceFile.addClass({
     name: "RestApiClient",
@@ -121,10 +124,10 @@ async function generate() {
             name: "option",
             type: "RequestInit",
             hasQuestionToken: true,
-            scope: tsMorph.Scope.Private
-          }
-        ]
-      }
+            scope: tsMorph.Scope.Private,
+          },
+        ],
+      },
     ],
     methods: [
       {
@@ -133,7 +136,7 @@ async function generate() {
         isAsync: true,
         parameters: [
           { name: "input", type: "RequestInfo" },
-          { name: "init", type: "RequestInit", hasQuestionToken: true }
+          { name: "init", type: "RequestInit", hasQuestionToken: true },
         ],
         statements: `const headers = {
       "Content-Type": "application/json",
@@ -147,7 +150,7 @@ async function generate() {
         \`API request failed: \${response.status} \${response.statusText} - \${errorBody}\`,
       );
     }
-    return response.json();`
+    return response.json();`,
       },
       {
         name: "request",
@@ -158,8 +161,8 @@ async function generate() {
           {
             name: "init",
             type: "ApiPayload<P, M>",
-            initializer: "{} as ApiPayload<P, M>"
-          }
+            initializer: "{} as ApiPayload<P, M>",
+          },
         ],
         returnType: "Promise<APIResponse<P, M>>",
         statements: `const url = new URL(this.basePath + String(path));
@@ -179,7 +182,7 @@ async function generate() {
 
     return this.fetcher(url.toString(), requestInit) as Promise<
       APIResponse<P, M>
-    >;`
+    >;`,
       },
       {
         name: "get",
@@ -190,11 +193,11 @@ async function generate() {
           {
             name: "payload",
             type: 'ApiPayload<T, "get">',
-            hasQuestionToken: true
-          }
+            hasQuestionToken: true,
+          },
         ],
         returnType: 'Promise<APIResponse<T, "get">>',
-        statements: 'return this.request("get", path, payload);'
+        statements: 'return this.request("get", path, payload);',
       },
       {
         name: "post",
@@ -205,11 +208,11 @@ async function generate() {
           {
             name: "payload",
             type: 'ApiPayload<T, "post">',
-            hasQuestionToken: true
-          }
+            hasQuestionToken: true,
+          },
         ],
         returnType: 'Promise<APIResponse<T, "post">>',
-        statements: 'return this.request("post", path, payload);'
+        statements: 'return this.request("post", path, payload);',
       },
       {
         name: "put",
@@ -220,11 +223,11 @@ async function generate() {
           {
             name: "payload",
             type: 'ApiPayload<T, "put">',
-            hasQuestionToken: true
-          }
+            hasQuestionToken: true,
+          },
         ],
         returnType: 'Promise<APIResponse<T, "put">>',
-        statements: 'return this.request("put", path, payload);'
+        statements: 'return this.request("put", path, payload);',
       },
       {
         name: "delete",
@@ -235,11 +238,11 @@ async function generate() {
           {
             name: "payload",
             type: 'ApiPayload<T, "delete">',
-            hasQuestionToken: true
-          }
+            hasQuestionToken: true,
+          },
         ],
         returnType: 'Promise<APIResponse<T, "delete">>',
-        statements: 'return this.request("delete", path, payload);'
+        statements: 'return this.request("delete", path, payload);',
       },
       {
         name: "patch",
@@ -250,18 +253,18 @@ async function generate() {
           {
             name: "payload",
             type: 'ApiPayload<T, "patch">',
-            hasQuestionToken: true
-          }
+            hasQuestionToken: true,
+          },
         ],
         returnType: 'Promise<APIResponse<T, "patch">>',
-        statements: 'return this.request("patch", path, payload);'
+        statements: 'return this.request("patch", path, payload);',
       },
       {
         name: "buildPathUrl",
         scope: tsMorph.Scope.Private,
         parameters: [
           { name: "basePath", type: "string" },
-          { name: "pathParams", type: "unknown", hasQuestionToken: true }
+          { name: "pathParams", type: "unknown", hasQuestionToken: true },
         ],
         returnType: "string",
         statements: `let pathname = basePath;
@@ -271,27 +274,27 @@ async function generate() {
         encodeURIComponent(String(params[key])),
       );
     }
-    return pathname;`
+    return pathname;`,
       },
       {
         name: "prepareBody",
         scope: tsMorph.Scope.Private,
         parameters: [
           { name: "method", type: "RestMethod" },
-          { name: "body", type: "unknown", hasQuestionToken: true }
+          { name: "body", type: "unknown", hasQuestionToken: true },
         ],
         returnType: "string | undefined",
         statements: `if (body && ["post", "put", "patch"].includes(method)) {
       return JSON.stringify(body);
     }
-    return undefined;`
+    return undefined;`,
       },
       {
         name: "appendQueryParams",
         scope: tsMorph.Scope.Private,
         parameters: [
           { name: "url", type: "URL" },
-          { name: "queryParams", type: "unknown", hasQuestionToken: true }
+          { name: "queryParams", type: "unknown", hasQuestionToken: true },
         ],
         returnType: "void",
         statements: `if (queryParams != null) {
@@ -301,15 +304,16 @@ async function generate() {
           url.searchParams.append(key, String(value));
         }
       }
-    }`
-      }
-    ]
+    }`,
+      },
+    ],
   });
   await sourceFile.formatText();
   await project.save();
   spinner.stopAndPersist({
     symbol: "✔",
-    text: `API client generated at ${resolve(process.cwd(), outPut)}`
+    text: `API client generated at ${resolve(process.cwd(), outPut)}`,
   });
 }
+
 generate();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-swagger-client",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "Generate fully type-safe REST API clients from OpenAPI/Swagger specifications",
   "main": "./index.mjs",
   "module": "./index.mjs",