swagger-typescript-api 13.9.2 → 13.10.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "swagger-typescript-api",
-  "version": "13.9.2",
+  "version": "13.10.0",
   "description": "Generate the API client for Fetch or Axios from an OpenAPI Specification",
   "homepage": "https://github.com/acacode/swagger-typescript-api",
   "bugs": "https://github.com/acacode/swagger-typescript-api/issues",
@@ -68,12 +68,12 @@
     "@changesets/cli": "2.31.0",
     "@tsconfig/node20": "20.1.9",
     "@tsconfig/strictest": "2.0.8",
-    "@types/node": "25.8.0",
+    "@types/node": "25.9.1",
     "@types/swagger2openapi": "7.0.4",
     "axios": "1.16.1",
     "tsdown": "0.21.10",
     "typedoc": "0.28.19",
-    "vitest": "4.1.6"
+    "vitest": "4.1.7"
   },
   "engines": {
     "node": ">=20"

package/templates/base/data-contracts.ejs

@@ -25,6 +25,16 @@ const dataContractTemplates = {
   type: (contract) => {
     return `type ${contract.name}${buildGenerics(contract)} = ${contract.content}`;
   },
+  const: (contract) => {
+    const entries = contract.$content
+      .map(({ key, value }) => `  ${key}: ${value}`)
+      .join(',\n');
+    const typeExport = contract.internal ? '' : 'export ';
+    return (
+      `const ${contract.name} = {\n${entries},\n} as const\n` +
+      `${typeExport}type ${contract.name} = (typeof ${contract.name})[keyof typeof ${contract.name}]`
+    );
+  },
 }
 %>
 

package/templates/base/enum-data-contract.ejs

@@ -3,7 +3,12 @@ const { contract, utils, config } = it;
 const { formatDescription, require, _ } = utils;
 const { name, $content } = contract;
 %>
-<% if (config.generateUnionEnums) { %>
+<% if (config.enumStyle === "const") { %>
+  export const <%~ name %> = {
+    <%~ _.map($content, ({ key, value }) => `${key}: ${value}`).join(",\n    ") %>
+  } as const;
+  export type <%~ name %> = (typeof <%~ name %>)[keyof typeof <%~ name %>];
+<% } else if (config.enumStyle === "union") { %>
   export type <%~ name %> = <%~ _.map($content, ({ value }) => value).join(" | ") %>
 <% } else { %>
   export enum <%~ name %> {

package/templates/base/http-clients/axios-http-client.ejs

@@ -30,6 +30,16 @@ export interface ApiConfig<SecurityDataType = unknown> extends Omit<AxiosRequest
   format?: ResponseType;
 }
 
+<% if (config.enumStyle === "const") { %>
+export const ContentType = {
+  Json: "application/json",
+  JsonApi: "application/vnd.api+json",
+  FormData: "multipart/form-data",
+  UrlEncoded: "application/x-www-form-urlencoded",
+  Text: "text/plain",
+} as const;
+export type ContentType = (typeof ContentType)[keyof typeof ContentType];
+<% } else { %>
 export enum ContentType {
   Json = "application/json",
   JsonApi = "application/vnd.api+json",
@@ -37,6 +47,7 @@ export enum ContentType {
   UrlEncoded = "application/x-www-form-urlencoded",
   Text = "text/plain",
 }
+<% } %>
 
 export class HttpClient<SecurityDataType = unknown> {
     public instance: AxiosInstance;

package/templates/base/http-clients/fetch-http-client.ejs

@@ -41,6 +41,16 @@ export interface HttpResponse<D extends unknown, E extends unknown = unknown> ex
 
 type CancelToken = Symbol | string | number;
 
+<% if (config.enumStyle === "const") { %>
+export const ContentType = {
+    Json: "application/json",
+    JsonApi: "application/vnd.api+json",
+    FormData: "multipart/form-data",
+    UrlEncoded: "application/x-www-form-urlencoded",
+    Text: "text/plain",
+} as const;
+export type ContentType = (typeof ContentType)[keyof typeof ContentType];
+<% } else { %>
 export enum ContentType {
     Json = "application/json",
     JsonApi = "application/vnd.api+json",
@@ -48,6 +58,7 @@ export enum ContentType {
     UrlEncoded = "application/x-www-form-urlencoded",
     Text = "text/plain",
 }
+<% } %>
 
 export class HttpClient<SecurityDataType = unknown> {
     public baseUrl: string = "<%~ apiConfig.baseUrl %>";

package/templates/default/procedure-call.ejs

@@ -31,8 +31,9 @@ const rawWrapperArgs = config.extractRequestParams ?
     _.compact([
         requestParams && {
           name: extractedRequestParamsName,
-          optional: false,
+          optional: route.request.requestParamsOptional,
           type: getInlineParseContent(requestParams),
+          defaultValue: route.request.requestParamsOptional ? '{}' : undefined,
         },
         ...(!requestParams ? pathParams : []),
         payload,

package/templates/modular/procedure-call.ejs

@@ -31,8 +31,9 @@ const rawWrapperArgs = config.extractRequestParams ?
     _.compact([
         requestParams && {
           name: extractedRequestParamsName,
-          optional: false,
+          optional: route.request.requestParamsOptional,
           type: getInlineParseContent(requestParams),
+          defaultValue: route.request.requestParamsOptional ? '{}' : undefined,
         },
         ...(!requestParams ? pathParams : []),
         payload,