@gromlab/api-codegen 1.0.0

package/dist/templates/route-type.ejs

@@ -0,0 +1,24 @@
+<%
+const { route, utils, config } = it;
+const { _, pascalCase, require } = utils;
+const { query, payload, pathParams, headers } = route.request;
+
+const routeDocs = includeFile("./route-docs", { config, route, utils });
+const isValidIdentifier = (name) => /^[A-Za-z_$][A-Za-z0-9_$]*$/.test(name);
+const routeNamespace = pascalCase(route.routeName.usage);
+
+%>
+
+/**
+<%~ routeDocs.description %>
+
+<%~ routeDocs.lines %>
+
+*/
+export namespace <% if (isValidIdentifier(routeNamespace)) { %><%~ routeNamespace %><% } else { %>"<%~ routeNamespace %>"<% } %> {
+  export type RequestParams = <%~ (pathParams && pathParams.type) || '{}' %>;
+  export type RequestQuery = <%~ (query && query.type) || '{}' %>;
+  export type RequestBody = <%~ (payload && payload.type) || 'never' %>;
+  export type RequestHeaders = <%~ (headers && headers.type) || '{}' %>;
+  export type ResponseBody = <%~ route.response.type %>;
+}

package/dist/templates/route-types.ejs

@@ -0,0 +1,32 @@
+<%
+const { utils, config, routes, modelTypes } = it;
+const { _, pascalCase } = utils;
+const dataContracts = config.modular ? _.map(modelTypes, "name") : [];
+%>
+
+<% if (dataContracts.length) { %>
+import { <%~ dataContracts.join(", ") %> } from "./<%~ config.fileNames.dataContracts %>"
+<% } %>
+
+<%
+/* TODO: outOfModule, combined should be attributes of route, which will allow to avoid duplication of code */
+%>
+
+<% if (routes.outOfModule) { %>
+ <% for (const { routes: outOfModuleRoutes = [] } of routes.outOfModule) { %>
+   <% for (const route of outOfModuleRoutes) { %>
+     <%~ includeFile('./route-type.ejs', { ...it, route }) %>
+   <% } %>
+ <% } %>
+<% } %>
+
+<% if (routes.combined) { %>
+ <% for (const { routes: combinedRoutes = [], moduleName } of routes.combined) { %>
+   export namespace <%~ pascalCase(moduleName) %> {
+   <% for (const route of combinedRoutes) { %>
+     <%~ includeFile('./route-type.ejs', { ...it, route }) %>
+   <% } %>
+   }
+
+ <% } %>
+<% } %>

package/dist/templates/type-data-contract.ejs

@@ -0,0 +1,15 @@
+<%
+const { contract, utils } = it;
+const { formatDescription, require, _ } = utils;
+
+%>
+<% if (contract.$content.length) { %>
+export type <%~ contract.name %> = {
+  <% for (const field of contract.$content) { %>
+    <%~ includeFile('./object-field-jsdoc.ejs', { ...it, field }) %>
+    <%~ field.field %>;
+  <% } %>
+}<%~ utils.isNeedToAddNull(contract) ? ' | null' : ''%>
+<% } else { %>
+export type <%~ contract.name %> = Record<string, any>;
+<% } %>

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@gromlab/api-codegen",
+  "version": "1.0.0",
+  "description": "CLI tool to generate TypeScript API client from OpenAPI specification",
+  "type": "module",
+  "bin": {
+    "api-codegen": "dist/cli.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "bun build src/cli.ts --target=node --outdir=dist --format=esm && cp -r src/templates dist/",
+    "dev": "bun run src/cli.ts",
+    "test": "bun test",
+    "test:unit": "bun test tests/unit",
+    "test:integration": "bun test tests/integration",
+    "test:watch": "bun test --watch",
+    "test:coverage": "bun test --coverage",
+    "prepublishOnly": "bun run build"
+  },
+  "dependencies": {
+    "@biomejs/wasm-bundler": "^2.3.0",
+    "@biomejs/wasm-web": "^2.3.0",
+    "chalk": "^5.3.0",
+    "commander": "^12.1.0",
+    "ejs": "^3.1.10",
+    "js-yaml": "^4.1.0",
+    "swagger-typescript-api": "^13.0.22"
+  },
+  "devDependencies": {
+    "@types/bun": "latest",
+    "@types/ejs": "^3.1.5",
+    "@types/js-yaml": "^4.0.9",
+    "@types/node": "^22.10.2",
+    "@types/react": "^18.3.0",
+    "@types/tmp": "^0.2.6",
+    "execa": "^8.0.0",
+    "msw": "^2.0.0",
+    "react": "^18.3.0",
+    "swr": "^2.3.0",
+    "tmp": "^0.2.1"
+  },
+  "peerDependencies": {
+    "typescript": "^5"
+  },
+  "keywords": [
+    "openapi",
+    "swagger",
+    "api",
+    "codegen",
+    "typescript",
+    "generator",
+    "cli"
+  ],
+  "author": "",
+  "license": "MIT"
+}