api-farmer 0.0.16 → 0.0.18

package/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2024 varletjs
+
+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

@@ -56,32 +56,6 @@ npx af
 
 Some simple usage examples can be found [here](fixtures)
 
-### Custom EJS Template
-
-Create `api-farmer.ejs` in the project root, which will replace the `preset` template.
-The template format can refer to the preset template listed below:
-
-- [Axle](templates/axle.ejs)
-- [Axios](templates/axios.ejs)
-
-See the bottom of the document for template variable definitions.
-
-### Status Code Strategy
-
-`smart`: find a valid status code between [`200`, `299`] that is closest to `200` <br>
-`loose`: all success status codes are `200` <br>
-`strict`: `Restful API` recommends using different successful http status codes for different methods, such as `get: 200`, `post: 201`, etc. <br>
-
-```ts
-// api-farmer.config.ts
-import { defineConfig } from 'api-farmer'
-
-export default defineConfig({
-  // 'strict' or 'loose' or 'smart', defaults 'smart'
-  statusCodeStrategy: 'strict',
-})
-```
-
 ### Transformer API
 
 You can use the Transformer API to further define template variables, which will override the default transformation rules.
@@ -112,16 +86,28 @@ export default defineConfig({
 })
 ```
 
+### Custom EJS Template
+
+Create `api-farmer.ejs` in the project root, which will replace the `preset` template.
+The template format can refer to the preset template listed below:
+
+- [Axle](templates/axle.ejs)
+- [Axios](templates/axios.ejs)
+
+See the bottom of the document for template variable definitions.
+
 ### Configuration Options
 
 ```ts
 export interface Config {
   /**
    * The path to the OpenAPI/Swagger schema file.
+   * @default './schema.json'
    */
   input?: string
   /**
    * The path to the output directory.
+   * @default './src/apis/generated'
    */
   output?: string
   /**
@@ -130,43 +116,38 @@ export interface Config {
   base?: string
   /**
    * The filename of the generated openapi types file.
+   * @default '_types.ts'
    */
   typesFilename?: string
-  /**
-   * The transformer api options, used to override the default transformation rules.
-   */
-  transformer?: Partial<Transformer>
   /**
    * Whether to generate TypeScript code.
+   * @default true
    */
   ts?: boolean
+  /**
+   * Whether to generate only types.
+   * @default false
+   */
+  typesOnly?: boolean
   /**
    * Whether to override the existing files, or an array of filenames to override.
+   * @default true
    */
   overrides?: boolean | string[]
   /**
    * The preset ejs template to use.
+   * @default 'axle'
    */
   preset?: Preset
   /**
-   * The status code strategy to use.
-   * loose: all success status codes are 200,
-   * strict: use the openapi recommended success status codes.
-   * smart: find a valid status code between [200, 299] that is closest to 200
+   * Defines which return status codes will be typed
+   * @default (status) => status >= 200 && status < 300
    */
-  statusCodeStrategy?: StatusCodeStrategy
+  validateStatus?: (status: number) => boolean
   /**
-   * The status codes to override the default status codes.
+   * The transformer api options, used to override the default transformation rules.
    */
-  statusCodes?: {
-    get?: number
-    post?: number
-    put?: number
-    delete?: number
-    patch?: number
-    options?: number
-    head?: number
-  }
+  transformer?: Partial<Transformer>
 }
 ```
 
@@ -186,6 +167,10 @@ export interface ApiModuleTemplateData {
    * Whether to generate ts code
    */
   ts: boolean
+  /**
+   * Whether to generate only types.
+   */
+  typesOnly?: boolean
 }
 
 export interface ApiModule {

package/dist/{chunk-VAAFC73D.js → chunk-K46PCBCF.js}

@@ -1,13 +1,12 @@
 import {
   CWD,
   SUPPORTED_HTTP_METHODS,
-  createStatusCodesByStrategy,
-  doStatusCodeStrategy,
+  getValidResponseMetadataItems,
   hasQueryParameter,
   isRequiredRequestBody,
   readSchema,
   readTemplateFile
-} from "./chunk-LYOTF4II.js";
+} from "./chunk-SKKHIIUE.js";
 import {
   __export
 } from "./chunk-6OIOYGN7.js";
@@ -22804,10 +22803,9 @@ function transformTypeResponseBody({
 }
 function transformTypeResponseBodyValue({
   type: type2,
-  statusCode,
-  mime
+  responseMetadataItems
 }) {
-  return `${type2}['responses']['${statusCode}']['content']['${mime}']`;
+  return responseMetadataItems.map(({ status, mime }) => `${type2}['responses']['${status}']['content']['${mime}']`).join(" | ");
 }
 function createTransformer() {
   return {
@@ -22829,7 +22827,7 @@ function createTransformer() {
 
 // src/generate.ts
 function transformPayloads(pathItems, options8) {
-  const { transformer, path: path13, base, statusCodeStrategy, statusCodes } = options8;
+  const { transformer, path: path13, base, validateStatus } = options8;
   return Object.entries(pathItems).filter(([key2]) => SUPPORTED_HTTP_METHODS.includes(key2)).reduce((payloads, [method, operation]) => {
     const url2 = transformer.url({ path: path13, base });
     const args = { path: path13, base, url: url2, method, operation };
@@ -22848,13 +22846,9 @@ function transformPayloads(pathItems, options8) {
       entity,
       required: isRequiredRequestBody(operation.requestBody)
     }) : "undefined";
-    const { mime, statusCode } = doStatusCodeStrategy(
-      operation,
-      statusCodes[method] ?? 200,
-      statusCodeStrategy
-    );
     const typeResponseBody = transformer.typeResponseBody({ ...args, type: type2, verb, entity });
-    const typeResponseBodyValue = mime && statusCode ? transformer.typeResponseBodyValue({ ...args, type: type2, verb, entity, statusCode, mime }) : "undefined";
+    const responseMetadataItems = getValidResponseMetadataItems(operation, validateStatus);
+    const typeResponseBodyValue = responseMetadataItems.length > 0 ? transformer.typeResponseBodyValue({ ...args, type: type2, verb, entity, responseMetadataItems }) : "undefined";
     payloads.push({
       fn,
       url: url2,
@@ -22874,14 +22868,16 @@ function transformPayloads(pathItems, options8) {
   }, []);
 }
 function partitionApiModules(schema2, options8) {
-  const { base, transformer } = options8;
+  const { base, transformer, validateStatus } = options8;
   const schemaPaths = schema2.paths ?? {};
   const schemaPathKeys = base ? Object.keys(schemaPaths).map((key2) => key2.replace(base, "")) : Object.keys(schemaPaths);
   const keyToPaths = groupBy(schemaPathKeys, (key2) => key2.split("/")[1]);
   const apiModules = Object.entries(keyToPaths).reduce((apiModules2, [name, paths]) => {
     const payloads = paths.reduce((payloads2, path13) => {
       const pathItems = schemaPaths[path13];
-      payloads2.push(...transformPayloads(pathItems, { ...options8, path: base ? base + path13 : path13, transformer }));
+      payloads2.push(
+        ...transformPayloads(pathItems, { ...options8, path: base ? base + path13 : path13, transformer, validateStatus })
+      );
       return payloads2;
     }, []);
     apiModules2.push({ name: transformer.moduleName({ name }), payloads });
@@ -22890,7 +22886,7 @@ function partitionApiModules(schema2, options8) {
   return apiModules;
 }
 function renderApiModules(apiModules, options8) {
-  const { output, ts, overrides, preset } = options8;
+  const { output, ts, typesOnly, overrides, preset } = options8;
   const templateFile = readTemplateFile(preset);
   const typesFilename = options8.typesFilename.replace(".ts", "");
   return Promise.all(
@@ -22899,7 +22895,8 @@ function renderApiModules(apiModules, options8) {
         const data = {
           apiModule,
           typesFilename,
-          ts
+          ts,
+          typesOnly
         };
         src_default.format(ejs.render(templateFile, data), {
           parser: "typescript",
@@ -22935,18 +22932,15 @@ async function generate(userOptions = {}) {
   const {
     base,
     ts = true,
+    typesOnly = false,
     overrides = true,
     preset = "axle",
-    statusCodeStrategy = "smart",
     input = "./schema.json",
     output = "./src/apis/generated",
     typesFilename = "_types.ts",
+    validateStatus = (status) => status >= 200 && status < 300,
     transformer = {}
   } = options8;
-  const statusCodes = {
-    ...createStatusCodesByStrategy(statusCodeStrategy),
-    ...options8.statusCodes ?? {}
-  };
   const mergedTransformer = { ...createTransformer(), ...transformer };
   const schema2 = await readSchema(input);
   logger.info("Generating API modules...");
@@ -22954,12 +22948,11 @@ async function generate(userOptions = {}) {
     await generateTypes(schema2, output, typesFilename);
   }
   const apiModules = partitionApiModules(schema2, {
-    statusCodes,
-    statusCodeStrategy,
     base,
-    transformer: mergedTransformer
+    transformer: mergedTransformer,
+    validateStatus
   });
-  await renderApiModules(apiModules, { output, typesFilename, ts, overrides, preset });
+  await renderApiModules(apiModules, { output, typesFilename, ts, typesOnly, overrides, preset });
   logger.success("Done");
 }
 

package/dist/{chunk-LYOTF4II.js → chunk-SKKHIIUE.js}

@@ -68,24 +68,18 @@ function getCliVersion() {
 function isRequiredRequestBody(value) {
   return "required" in value && value.required === true;
 }
-function doStatusCodeStrategy(operation, statusCode, strategy) {
-  if (strategy === "smart") {
-    const responses = operation.responses ?? {};
-    const codeKey = Object.keys(responses).sort((a, b) => Number(a) - Number(b)).find((codeKey2) => Number(codeKey2) >= 200 && Number(codeKey2) <= 299);
-    if (!codeKey) {
-      return {
-        statusCode: void 0,
-        mime: void 0
-      };
-    }
-    statusCode = Number(codeKey);
-  }
-  const content = operation.responses?.[statusCode]?.content;
-  const mime = content?.["application/json"] ? "application/json" : content?.["*/*"] ? "*/*" : void 0;
-  return {
-    statusCode,
-    mime
-  };
+function getValidResponseMetadataItems(operation, validateStatus) {
+  const responses = operation.responses ?? {};
+  const validStatusResults = Object.keys(responses).sort((a, b) => Number(a) - Number(b)).filter((key) => validateStatus(Number(key))).map(Number);
+  const results = validStatusResults.map((status) => {
+    const content = operation.responses?.[status]?.content;
+    const mime = content?.["application/json"] ? "application/json" : content?.["*/*"] ? "*/*" : void 0;
+    return {
+      status,
+      mime
+    };
+  }).filter((result) => result.mime);
+  return results;
 }
 
 export {
@@ -97,5 +91,5 @@ export {
   hasQueryParameter,
   getCliVersion,
   isRequiredRequestBody,
-  doStatusCodeStrategy
+  getValidResponseMetadataItems
 };

package/dist/cli.cjs

@@ -55,37 +55,6 @@ var init_constants = __esm({
 });
 
 // src/utils.ts
-function createStatusCodesByStrategy(strategy) {
-  return {
-    strict: {
-      get: 200,
-      post: 201,
-      put: 200,
-      delete: 204,
-      patch: 200,
-      options: 204,
-      head: 200
-    },
-    loose: {
-      get: 200,
-      post: 200,
-      put: 200,
-      delete: 200,
-      patch: 200,
-      options: 200,
-      head: 200
-    },
-    smart: {
-      get: 200,
-      post: 200,
-      put: 200,
-      delete: 200,
-      patch: 200,
-      options: 200,
-      head: 200
-    }
-  }[strategy];
-}
 async function readSchema(input) {
   const isYaml = input.endsWith(".yaml");
   const path13 = (0, import_path2.resolve)(CWD, input);
@@ -109,24 +78,18 @@ function getCliVersion() {
 function isRequiredRequestBody(value) {
   return "required" in value && value.required === true;
 }
-function doStatusCodeStrategy(operation, statusCode, strategy) {
-  if (strategy === "smart") {
-    const responses = operation.responses ?? {};
-    const codeKey = Object.keys(responses).sort((a5, b8) => Number(a5) - Number(b8)).find((codeKey2) => Number(codeKey2) >= 200 && Number(codeKey2) <= 299);
-    if (!codeKey) {
-      return {
-        statusCode: void 0,
-        mime: void 0
-      };
-    }
-    statusCode = Number(codeKey);
-  }
-  const content = operation.responses?.[statusCode]?.content;
-  const mime = content?.["application/json"] ? "application/json" : content?.["*/*"] ? "*/*" : void 0;
-  return {
-    statusCode,
-    mime
-  };
+function getValidResponseMetadataItems(operation, validateStatus) {
+  const responses = operation.responses ?? {};
+  const validStatusResults = Object.keys(responses).sort((a5, b8) => Number(a5) - Number(b8)).filter((key2) => validateStatus(Number(key2))).map(Number);
+  const results = validStatusResults.map((status) => {
+    const content = operation.responses?.[status]?.content;
+    const mime = content?.["application/json"] ? "application/json" : content?.["*/*"] ? "*/*" : void 0;
+    return {
+      status,
+      mime
+    };
+  }).filter((result) => result.mime);
+  return results;
 }
 var import_path2, import_fs_extra, import_swagger2openapi, import_yaml;
 var init_utils = __esm({
@@ -102088,10 +102051,9 @@ function transformTypeResponseBody({
 }
 function transformTypeResponseBodyValue({
   type: type2,
-  statusCode,
-  mime
+  responseMetadataItems
 }) {
-  return `${type2}['responses']['${statusCode}']['content']['${mime}']`;
+  return responseMetadataItems.map(({ status, mime }) => `${type2}['responses']['${status}']['content']['${mime}']`).join(" | ");
 }
 function createTransformer() {
   return {
@@ -102130,7 +102092,7 @@ __export(generate_exports, {
   transformPayloads: () => transformPayloads
 });
 function transformPayloads(pathItems, options8) {
-  const { transformer, path: path13, base, statusCodeStrategy, statusCodes } = options8;
+  const { transformer, path: path13, base, validateStatus } = options8;
   return Object.entries(pathItems).filter(([key2]) => SUPPORTED_HTTP_METHODS.includes(key2)).reduce((payloads, [method, operation]) => {
     const url2 = transformer.url({ path: path13, base });
     const args = { path: path13, base, url: url2, method, operation };
@@ -102149,13 +102111,9 @@ function transformPayloads(pathItems, options8) {
       entity,
       required: isRequiredRequestBody(operation.requestBody)
     }) : "undefined";
-    const { mime, statusCode } = doStatusCodeStrategy(
-      operation,
-      statusCodes[method] ?? 200,
-      statusCodeStrategy
-    );
     const typeResponseBody = transformer.typeResponseBody({ ...args, type: type2, verb, entity });
-    const typeResponseBodyValue = mime && statusCode ? transformer.typeResponseBodyValue({ ...args, type: type2, verb, entity, statusCode, mime }) : "undefined";
+    const responseMetadataItems = getValidResponseMetadataItems(operation, validateStatus);
+    const typeResponseBodyValue = responseMetadataItems.length > 0 ? transformer.typeResponseBodyValue({ ...args, type: type2, verb, entity, responseMetadataItems }) : "undefined";
     payloads.push({
       fn: fn8,
       url: url2,
@@ -102175,14 +102133,16 @@ function transformPayloads(pathItems, options8) {
   }, []);
 }
 function partitionApiModules(schema2, options8) {
-  const { base, transformer } = options8;
+  const { base, transformer, validateStatus } = options8;
   const schemaPaths = schema2.paths ?? {};
   const schemaPathKeys = base ? Object.keys(schemaPaths).map((key2) => key2.replace(base, "")) : Object.keys(schemaPaths);
   const keyToPaths = (0, import_rattail2.groupBy)(schemaPathKeys, (key2) => key2.split("/")[1]);
   const apiModules = Object.entries(keyToPaths).reduce((apiModules2, [name, paths]) => {
     const payloads = paths.reduce((payloads2, path13) => {
       const pathItems = schemaPaths[path13];
-      payloads2.push(...transformPayloads(pathItems, { ...options8, path: base ? base + path13 : path13, transformer }));
+      payloads2.push(
+        ...transformPayloads(pathItems, { ...options8, path: base ? base + path13 : path13, transformer, validateStatus })
+      );
       return payloads2;
     }, []);
     apiModules2.push({ name: transformer.moduleName({ name }), payloads });
@@ -102191,7 +102151,7 @@ function partitionApiModules(schema2, options8) {
   return apiModules;
 }
 function renderApiModules(apiModules, options8) {
-  const { output, ts: ts9, overrides, preset } = options8;
+  const { output, ts: ts9, typesOnly, overrides, preset } = options8;
   const templateFile = readTemplateFile(preset);
   const typesFilename = options8.typesFilename.replace(".ts", "");
   return Promise.all(
@@ -102200,7 +102160,8 @@ function renderApiModules(apiModules, options8) {
         const data = {
           apiModule,
           typesFilename,
-          ts: ts9
+          ts: ts9,
+          typesOnly
         };
         src_default.format(import_ejs.default.render(templateFile, data), {
           parser: "typescript",
@@ -102236,18 +102197,15 @@ async function generate(userOptions = {}) {
   const {
     base,
     ts: ts9 = true,
+    typesOnly = false,
     overrides = true,
     preset = "axle",
-    statusCodeStrategy = "smart",
     input = "./schema.json",
     output = "./src/apis/generated",
     typesFilename = "_types.ts",
+    validateStatus = (status) => status >= 200 && status < 300,
     transformer = {}
   } = options8;
-  const statusCodes = {
-    ...createStatusCodesByStrategy(statusCodeStrategy),
-    ...options8.statusCodes ?? {}
-  };
   const mergedTransformer = { ...createTransformer(), ...transformer };
   const schema2 = await readSchema(input);
   import_rslog.logger.info("Generating API modules...");
@@ -102255,12 +102213,11 @@ async function generate(userOptions = {}) {
     await generateTypes(schema2, output, typesFilename);
   }
   const apiModules = partitionApiModules(schema2, {
-    statusCodes,
-    statusCodeStrategy,
     base,
-    transformer: mergedTransformer
+    transformer: mergedTransformer,
+    validateStatus
   });
-  await renderApiModules(apiModules, { output, typesFilename, ts: ts9, overrides, preset });
+  await renderApiModules(apiModules, { output, typesFilename, ts: ts9, typesOnly, overrides, preset });
   import_rslog.logger.success("Done");
 }
 var import_path14, import_ejs, import_fs_extra2, import_openapi_typescript, import_rattail2, import_rslog;

package/dist/cli.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   getCliVersion
-} from "./chunk-LYOTF4II.js";
+} from "./chunk-SKKHIIUE.js";
 import "./chunk-6OIOYGN7.js";
 
 // src/cli.ts
@@ -9,7 +9,7 @@ import { Command } from "commander";
 var program = new Command();
 program.version(getCliVersion());
 program.action(async () => {
-  const { generate } = await import("./generate-RJ23AKV7.js");
+  const { generate } = await import("./generate-IJGTBA2I.js");
   return generate();
 });
 program.parse();

package/dist/{generate-RJ23AKV7.js → generate-IJGTBA2I.js}

@@ -4,8 +4,8 @@ import {
   partitionApiModules,
   renderApiModules,
   transformPayloads
-} from "./chunk-VAAFC73D.js";
-import "./chunk-LYOTF4II.js";
+} from "./chunk-K46PCBCF.js";
+import "./chunk-SKKHIIUE.js";
 import "./chunk-6OIOYGN7.js";
 export {
   generate,

package/dist/index.cjs

@@ -79228,11 +79228,11 @@ __export(index_exports, {
   createStatusCodesByStrategy: () => createStatusCodesByStrategy,
   createTransformer: () => createTransformer,
   defineConfig: () => defineConfig,
-  doStatusCodeStrategy: () => doStatusCodeStrategy,
   generate: () => generate,
   generateTypes: () => generateTypes,
   getCliVersion: () => getCliVersion,
   getConfig: () => getConfig,
+  getValidResponseMetadataItems: () => getValidResponseMetadataItems,
   hasQueryParameter: () => hasQueryParameter,
   isRequiredRequestBody: () => isRequiredRequestBody,
   partitionApiModules: () => partitionApiModules,
@@ -79328,10 +79328,9 @@ function transformTypeResponseBody({
 }
 function transformTypeResponseBodyValue({
   type: type2,
-  statusCode,
-  mime
+  responseMetadataItems
 }) {
-  return `${type2}['responses']['${statusCode}']['content']['${mime}']`;
+  return responseMetadataItems.map(({ status, mime }) => `${type2}['responses']['${status}']['content']['${mime}']`).join(" | ");
 }
 function createTransformer() {
   return {
@@ -102146,29 +102145,23 @@ function getCliVersion() {
 function isRequiredRequestBody(value) {
   return "required" in value && value.required === true;
 }
-function doStatusCodeStrategy(operation, statusCode, strategy) {
-  if (strategy === "smart") {
-    const responses = operation.responses ?? {};
-    const codeKey = Object.keys(responses).sort((a5, b8) => Number(a5) - Number(b8)).find((codeKey2) => Number(codeKey2) >= 200 && Number(codeKey2) <= 299);
-    if (!codeKey) {
-      return {
-        statusCode: void 0,
-        mime: void 0
-      };
-    }
-    statusCode = Number(codeKey);
-  }
-  const content = operation.responses?.[statusCode]?.content;
-  const mime = content?.["application/json"] ? "application/json" : content?.["*/*"] ? "*/*" : void 0;
-  return {
-    statusCode,
-    mime
-  };
+function getValidResponseMetadataItems(operation, validateStatus) {
+  const responses = operation.responses ?? {};
+  const validStatusResults = Object.keys(responses).sort((a5, b8) => Number(a5) - Number(b8)).filter((key2) => validateStatus(Number(key2))).map(Number);
+  const results = validStatusResults.map((status) => {
+    const content = operation.responses?.[status]?.content;
+    const mime = content?.["application/json"] ? "application/json" : content?.["*/*"] ? "*/*" : void 0;
+    return {
+      status,
+      mime
+    };
+  }).filter((result) => result.mime);
+  return results;
 }
 
 // src/generate.ts
 function transformPayloads(pathItems, options8) {
-  const { transformer, path: path13, base, statusCodeStrategy, statusCodes } = options8;
+  const { transformer, path: path13, base, validateStatus } = options8;
   return Object.entries(pathItems).filter(([key2]) => SUPPORTED_HTTP_METHODS.includes(key2)).reduce((payloads, [method, operation]) => {
     const url2 = transformer.url({ path: path13, base });
     const args = { path: path13, base, url: url2, method, operation };
@@ -102187,13 +102180,9 @@ function transformPayloads(pathItems, options8) {
       entity,
       required: isRequiredRequestBody(operation.requestBody)
     }) : "undefined";
-    const { mime, statusCode } = doStatusCodeStrategy(
-      operation,
-      statusCodes[method] ?? 200,
-      statusCodeStrategy
-    );
     const typeResponseBody = transformer.typeResponseBody({ ...args, type: type2, verb, entity });
-    const typeResponseBodyValue = mime && statusCode ? transformer.typeResponseBodyValue({ ...args, type: type2, verb, entity, statusCode, mime }) : "undefined";
+    const responseMetadataItems = getValidResponseMetadataItems(operation, validateStatus);
+    const typeResponseBodyValue = responseMetadataItems.length > 0 ? transformer.typeResponseBodyValue({ ...args, type: type2, verb, entity, responseMetadataItems }) : "undefined";
     payloads.push({
       fn: fn8,
       url: url2,
@@ -102213,14 +102202,16 @@ function transformPayloads(pathItems, options8) {
   }, []);
 }
 function partitionApiModules(schema2, options8) {
-  const { base, transformer } = options8;
+  const { base, transformer, validateStatus } = options8;
   const schemaPaths = schema2.paths ?? {};
   const schemaPathKeys = base ? Object.keys(schemaPaths).map((key2) => key2.replace(base, "")) : Object.keys(schemaPaths);
   const keyToPaths = (0, import_rattail2.groupBy)(schemaPathKeys, (key2) => key2.split("/")[1]);
   const apiModules = Object.entries(keyToPaths).reduce((apiModules2, [name, paths]) => {
     const payloads = paths.reduce((payloads2, path13) => {
       const pathItems = schemaPaths[path13];
-      payloads2.push(...transformPayloads(pathItems, { ...options8, path: base ? base + path13 : path13, transformer }));
+      payloads2.push(
+        ...transformPayloads(pathItems, { ...options8, path: base ? base + path13 : path13, transformer, validateStatus })
+      );
       return payloads2;
     }, []);
     apiModules2.push({ name: transformer.moduleName({ name }), payloads });
@@ -102229,7 +102220,7 @@ function partitionApiModules(schema2, options8) {
   return apiModules;
 }
 function renderApiModules(apiModules, options8) {
-  const { output, ts: ts9, overrides, preset } = options8;
+  const { output, ts: ts9, typesOnly, overrides, preset } = options8;
   const templateFile = readTemplateFile(preset);
   const typesFilename = options8.typesFilename.replace(".ts", "");
   return Promise.all(
@@ -102238,7 +102229,8 @@ function renderApiModules(apiModules, options8) {
         const data = {
           apiModule,
           typesFilename,
-          ts: ts9
+          ts: ts9,
+          typesOnly
         };
         src_default.format(import_ejs.default.render(templateFile, data), {
           parser: "typescript",
@@ -102274,18 +102266,15 @@ async function generate(userOptions = {}) {
   const {
     base,
     ts: ts9 = true,
+    typesOnly = false,
     overrides = true,
     preset = "axle",
-    statusCodeStrategy = "smart",
     input = "./schema.json",
     output = "./src/apis/generated",
     typesFilename = "_types.ts",
+    validateStatus = (status) => status >= 200 && status < 300,
     transformer = {}
   } = options8;
-  const statusCodes = {
-    ...createStatusCodesByStrategy(statusCodeStrategy),
-    ...options8.statusCodes ?? {}
-  };
   const mergedTransformer = { ...createTransformer(), ...transformer };
   const schema2 = await readSchema(input);
   import_rslog.logger.info("Generating API modules...");
@@ -102293,12 +102282,11 @@ async function generate(userOptions = {}) {
     await generateTypes(schema2, output, typesFilename);
   }
   const apiModules = partitionApiModules(schema2, {
-    statusCodes,
-    statusCodeStrategy,
     base,
-    transformer: mergedTransformer
+    transformer: mergedTransformer,
+    validateStatus
   });
-  await renderApiModules(apiModules, { output, typesFilename, ts: ts9, overrides, preset });
+  await renderApiModules(apiModules, { output, typesFilename, ts: ts9, typesOnly, overrides, preset });
   import_rslog.logger.success("Done");
 }
 
@@ -102309,11 +102297,11 @@ var import_pluralize2 = __toESM(require("pluralize"), 1);
   createStatusCodesByStrategy,
   createTransformer,
   defineConfig,
-  doStatusCodeStrategy,
   generate,
   generateTypes,
   getCliVersion,
   getConfig,
+  getValidResponseMetadataItems,
   hasQueryParameter,
   isRequiredRequestBody,
   partitionApiModules,

package/dist/index.d.cts

@@ -1,6 +1,53 @@
-import { OperationObject, OpenAPI3, RequestBodyObject, ReferenceObject } from 'openapi-typescript';
+import { OpenAPI3, OperationObject, RequestBodyObject, ReferenceObject } from 'openapi-typescript';
 export { default as pluralize } from 'pluralize';
 
+type Preset = 'axle' | 'axios';
+type StatusCodeStrategy = 'strict' | 'loose' | 'smart';
+interface StatusCodes {
+    get?: number;
+    post?: number;
+    put?: number;
+    delete?: number;
+    patch?: number;
+    options?: number;
+    head?: number;
+}
+declare function createStatusCodesByStrategy(strategy: StatusCodeStrategy): {
+    get: number;
+    post: number;
+    put: number;
+    delete: number;
+    patch: number;
+    options: number;
+    head: number;
+} | {
+    get: number;
+    post: number;
+    put: number;
+    delete: number;
+    patch: number;
+    options: number;
+    head: number;
+} | {
+    get: number;
+    post: number;
+    put: number;
+    delete: number;
+    patch: number;
+    options: number;
+    head: number;
+};
+declare function readSchema(input: string): Promise<OpenAPI3>;
+declare function readTemplateFile(preset?: Preset): string;
+declare function hasQueryParameter(operation: OperationObject): boolean;
+declare function getCliVersion(): any;
+declare function isRequiredRequestBody(value: RequestBodyObject | ReferenceObject): boolean;
+type ResponseMetadataItem = {
+    status: number;
+    mime: string;
+};
+declare function getValidResponseMetadataItems(operation: OperationObject, validateStatus: (status: number) => boolean): ResponseMetadataItem[];
+
 type TransformerBaseArgs = {
     path: string;
     base: string | undefined;
@@ -57,12 +104,11 @@ declare function transformTypeResponseBody({ type, }: {
     verb: string;
     entity: string;
 } & TransformerBaseArgs): string;
-declare function transformTypeResponseBodyValue({ type, statusCode, mime, }: {
+declare function transformTypeResponseBodyValue({ type, responseMetadataItems, }: {
     type: string;
     verb: string;
     entity: string;
-    statusCode: number;
-    mime: string;
+    responseMetadataItems: ResponseMetadataItem[];
 } & TransformerBaseArgs): string;
 interface Transformer {
     moduleName: typeof transformModuleName;
@@ -81,55 +127,6 @@ interface Transformer {
 }
 declare function createTransformer(): Transformer;
 
-type Preset = 'axle' | 'axios';
-type StatusCodeStrategy = 'strict' | 'loose' | 'smart';
-interface StatusCodes {
-    get?: number;
-    post?: number;
-    put?: number;
-    delete?: number;
-    patch?: number;
-    options?: number;
-    head?: number;
-}
-declare function createStatusCodesByStrategy(strategy: StatusCodeStrategy): {
-    get: number;
-    post: number;
-    put: number;
-    delete: number;
-    patch: number;
-    options: number;
-    head: number;
-} | {
-    get: number;
-    post: number;
-    put: number;
-    delete: number;
-    patch: number;
-    options: number;
-    head: number;
-} | {
-    get: number;
-    post: number;
-    put: number;
-    delete: number;
-    patch: number;
-    options: number;
-    head: number;
-};
-declare function readSchema(input: string): Promise<OpenAPI3>;
-declare function readTemplateFile(preset?: Preset): string;
-declare function hasQueryParameter(operation: OperationObject): boolean;
-declare function getCliVersion(): any;
-declare function isRequiredRequestBody(value: RequestBodyObject | ReferenceObject): boolean;
-declare function doStatusCodeStrategy(operation: OperationObject, statusCode: number, strategy: StatusCodeStrategy): {
-    statusCode: undefined;
-    mime: undefined;
-} | {
-    statusCode: number;
-    mime: string | undefined;
-};
-
 interface ApiModuleTemplateData {
     /**
      * API module metadata
@@ -143,6 +140,10 @@ interface ApiModuleTemplateData {
      * Whether to generate ts code
      */
     ts: boolean;
+    /**
+     * Whether to generate only types
+     */
+    typesOnly: boolean;
 }
 interface ApiModule {
     /**
@@ -211,10 +212,12 @@ interface ApiModulePayload {
 interface GenerateOptions {
     /**
      * The path to the OpenAPI/Swagger schema file.
+     * @default './schema.json'
      */
     input?: string;
     /**
      * The path to the output directory.
+     * @default './src/apis/generated'
      */
     output?: string;
     /**
@@ -223,61 +226,55 @@ interface GenerateOptions {
     base?: string;
     /**
      * The filename of the generated openapi types file.
+     * @default '_types.ts'
      */
     typesFilename?: string;
-    /**
-     * The transformer api options, used to override the default transformation rules.
-     */
-    transformer?: Partial<Transformer>;
     /**
      * Whether to generate TypeScript code.
+     * @default true
      */
     ts?: boolean;
+    /**
+     * Whether to generate only types.
+     * @default false
+     */
+    typesOnly?: boolean;
     /**
      * Whether to override the existing files, or an array of filenames to override.
+     * @default true
      */
     overrides?: boolean | string[];
     /**
      * The preset ejs template to use.
+     * @default 'axle'
      */
     preset?: Preset;
     /**
-     * The status code strategy to use.
-     * loose: all success status codes are 200,
-     * strict: use the openapi recommended success status codes.
-     * smart: find a valid status code between [200, 299] that is closest to 200
+     * Defines which return status codes will be typed
+     * @default (status) => status >= 200 && status < 300
      */
-    statusCodeStrategy?: StatusCodeStrategy;
+    validateStatus?: (status: number) => boolean;
     /**
-     * The status codes to override the default status codes.
+     * The transformer api options, used to override the default transformation rules.
      */
-    statusCodes?: {
-        get?: number;
-        post?: number;
-        put?: number;
-        delete?: number;
-        patch?: number;
-        options?: number;
-        head?: number;
-    };
+    transformer?: Partial<Transformer>;
 }
 declare function transformPayloads(pathItems: Record<string, OperationObject>, options: {
     path: string;
-    statusCodeStrategy: StatusCodeStrategy;
-    statusCodes: StatusCodes;
     transformer: Transformer;
     base: string | undefined;
+    validateStatus: (status: number) => boolean;
 }): ApiModulePayload[];
 declare function partitionApiModules(schema: OpenAPI3, options: {
     transformer: Transformer;
-    statusCodeStrategy: StatusCodeStrategy;
-    statusCodes: StatusCodes;
     base: string | undefined;
+    validateStatus: (status: number) => boolean;
 }): ApiModule[];
 declare function renderApiModules(apiModules: ApiModule[], options: {
     output: string;
     typesFilename: string;
     ts: boolean;
+    typesOnly: boolean;
     overrides: boolean | string[];
     preset: Preset;
 }): Promise<unknown[]>;
@@ -288,4 +285,4 @@ type Config = GenerateOptions;
 declare function defineConfig(config: Config): GenerateOptions;
 declare function getConfig(): Promise<Config>;
 
-export { type ApiModule, type ApiModulePayload, type ApiModuleTemplateData, type Config, type GenerateOptions, type Preset, type StatusCodeStrategy, type StatusCodes, type Transformer, type TransformerBaseArgs, createStatusCodesByStrategy, createTransformer, defineConfig, doStatusCodeStrategy, generate, generateTypes, getCliVersion, getConfig, hasQueryParameter, isRequiredRequestBody, partitionApiModules, readSchema, readTemplateFile, renderApiModules, transformEntity, transformFn, transformModuleName, transformPayloads, transformType, transformTypeQuery, transformTypeQueryValue, transformTypeRequestBody, transformTypeRequestBodyValue, transformTypeResponseBody, transformTypeResponseBodyValue, transformTypeValue, transformUrl, transformVerb };
+export { type ApiModule, type ApiModulePayload, type ApiModuleTemplateData, type Config, type GenerateOptions, type Preset, type ResponseMetadataItem, type StatusCodeStrategy, type StatusCodes, type Transformer, type TransformerBaseArgs, createStatusCodesByStrategy, createTransformer, defineConfig, generate, generateTypes, getCliVersion, getConfig, getValidResponseMetadataItems, hasQueryParameter, isRequiredRequestBody, partitionApiModules, readSchema, readTemplateFile, renderApiModules, transformEntity, transformFn, transformModuleName, transformPayloads, transformType, transformTypeQuery, transformTypeQueryValue, transformTypeRequestBody, transformTypeRequestBodyValue, transformTypeResponseBody, transformTypeResponseBodyValue, transformTypeValue, transformUrl, transformVerb };

package/dist/index.d.ts

@@ -1,6 +1,53 @@
-import { OperationObject, OpenAPI3, RequestBodyObject, ReferenceObject } from 'openapi-typescript';
+import { OpenAPI3, OperationObject, RequestBodyObject, ReferenceObject } from 'openapi-typescript';
 export { default as pluralize } from 'pluralize';
 
+type Preset = 'axle' | 'axios';
+type StatusCodeStrategy = 'strict' | 'loose' | 'smart';
+interface StatusCodes {
+    get?: number;
+    post?: number;
+    put?: number;
+    delete?: number;
+    patch?: number;
+    options?: number;
+    head?: number;
+}
+declare function createStatusCodesByStrategy(strategy: StatusCodeStrategy): {
+    get: number;
+    post: number;
+    put: number;
+    delete: number;
+    patch: number;
+    options: number;
+    head: number;
+} | {
+    get: number;
+    post: number;
+    put: number;
+    delete: number;
+    patch: number;
+    options: number;
+    head: number;
+} | {
+    get: number;
+    post: number;
+    put: number;
+    delete: number;
+    patch: number;
+    options: number;
+    head: number;
+};
+declare function readSchema(input: string): Promise<OpenAPI3>;
+declare function readTemplateFile(preset?: Preset): string;
+declare function hasQueryParameter(operation: OperationObject): boolean;
+declare function getCliVersion(): any;
+declare function isRequiredRequestBody(value: RequestBodyObject | ReferenceObject): boolean;
+type ResponseMetadataItem = {
+    status: number;
+    mime: string;
+};
+declare function getValidResponseMetadataItems(operation: OperationObject, validateStatus: (status: number) => boolean): ResponseMetadataItem[];
+
 type TransformerBaseArgs = {
     path: string;
     base: string | undefined;
@@ -57,12 +104,11 @@ declare function transformTypeResponseBody({ type, }: {
     verb: string;
     entity: string;
 } & TransformerBaseArgs): string;
-declare function transformTypeResponseBodyValue({ type, statusCode, mime, }: {
+declare function transformTypeResponseBodyValue({ type, responseMetadataItems, }: {
     type: string;
     verb: string;
     entity: string;
-    statusCode: number;
-    mime: string;
+    responseMetadataItems: ResponseMetadataItem[];
 } & TransformerBaseArgs): string;
 interface Transformer {
     moduleName: typeof transformModuleName;
@@ -81,55 +127,6 @@ interface Transformer {
 }
 declare function createTransformer(): Transformer;
 
-type Preset = 'axle' | 'axios';
-type StatusCodeStrategy = 'strict' | 'loose' | 'smart';
-interface StatusCodes {
-    get?: number;
-    post?: number;
-    put?: number;
-    delete?: number;
-    patch?: number;
-    options?: number;
-    head?: number;
-}
-declare function createStatusCodesByStrategy(strategy: StatusCodeStrategy): {
-    get: number;
-    post: number;
-    put: number;
-    delete: number;
-    patch: number;
-    options: number;
-    head: number;
-} | {
-    get: number;
-    post: number;
-    put: number;
-    delete: number;
-    patch: number;
-    options: number;
-    head: number;
-} | {
-    get: number;
-    post: number;
-    put: number;
-    delete: number;
-    patch: number;
-    options: number;
-    head: number;
-};
-declare function readSchema(input: string): Promise<OpenAPI3>;
-declare function readTemplateFile(preset?: Preset): string;
-declare function hasQueryParameter(operation: OperationObject): boolean;
-declare function getCliVersion(): any;
-declare function isRequiredRequestBody(value: RequestBodyObject | ReferenceObject): boolean;
-declare function doStatusCodeStrategy(operation: OperationObject, statusCode: number, strategy: StatusCodeStrategy): {
-    statusCode: undefined;
-    mime: undefined;
-} | {
-    statusCode: number;
-    mime: string | undefined;
-};
-
 interface ApiModuleTemplateData {
     /**
      * API module metadata
@@ -143,6 +140,10 @@ interface ApiModuleTemplateData {
      * Whether to generate ts code
      */
     ts: boolean;
+    /**
+     * Whether to generate only types
+     */
+    typesOnly: boolean;
 }
 interface ApiModule {
     /**
@@ -211,10 +212,12 @@ interface ApiModulePayload {
 interface GenerateOptions {
     /**
      * The path to the OpenAPI/Swagger schema file.
+     * @default './schema.json'
      */
     input?: string;
     /**
      * The path to the output directory.
+     * @default './src/apis/generated'
      */
     output?: string;
     /**
@@ -223,61 +226,55 @@ interface GenerateOptions {
     base?: string;
     /**
      * The filename of the generated openapi types file.
+     * @default '_types.ts'
      */
     typesFilename?: string;
-    /**
-     * The transformer api options, used to override the default transformation rules.
-     */
-    transformer?: Partial<Transformer>;
     /**
      * Whether to generate TypeScript code.
+     * @default true
      */
     ts?: boolean;
+    /**
+     * Whether to generate only types.
+     * @default false
+     */
+    typesOnly?: boolean;
     /**
      * Whether to override the existing files, or an array of filenames to override.
+     * @default true
      */
     overrides?: boolean | string[];
     /**
      * The preset ejs template to use.
+     * @default 'axle'
      */
     preset?: Preset;
     /**
-     * The status code strategy to use.
-     * loose: all success status codes are 200,
-     * strict: use the openapi recommended success status codes.
-     * smart: find a valid status code between [200, 299] that is closest to 200
+     * Defines which return status codes will be typed
+     * @default (status) => status >= 200 && status < 300
      */
-    statusCodeStrategy?: StatusCodeStrategy;
+    validateStatus?: (status: number) => boolean;
     /**
-     * The status codes to override the default status codes.
+     * The transformer api options, used to override the default transformation rules.
      */
-    statusCodes?: {
-        get?: number;
-        post?: number;
-        put?: number;
-        delete?: number;
-        patch?: number;
-        options?: number;
-        head?: number;
-    };
+    transformer?: Partial<Transformer>;
 }
 declare function transformPayloads(pathItems: Record<string, OperationObject>, options: {
     path: string;
-    statusCodeStrategy: StatusCodeStrategy;
-    statusCodes: StatusCodes;
     transformer: Transformer;
     base: string | undefined;
+    validateStatus: (status: number) => boolean;
 }): ApiModulePayload[];
 declare function partitionApiModules(schema: OpenAPI3, options: {
     transformer: Transformer;
-    statusCodeStrategy: StatusCodeStrategy;
-    statusCodes: StatusCodes;
     base: string | undefined;
+    validateStatus: (status: number) => boolean;
 }): ApiModule[];
 declare function renderApiModules(apiModules: ApiModule[], options: {
     output: string;
     typesFilename: string;
     ts: boolean;
+    typesOnly: boolean;
     overrides: boolean | string[];
     preset: Preset;
 }): Promise<unknown[]>;
@@ -288,4 +285,4 @@ type Config = GenerateOptions;
 declare function defineConfig(config: Config): GenerateOptions;
 declare function getConfig(): Promise<Config>;
 
-export { type ApiModule, type ApiModulePayload, type ApiModuleTemplateData, type Config, type GenerateOptions, type Preset, type StatusCodeStrategy, type StatusCodes, type Transformer, type TransformerBaseArgs, createStatusCodesByStrategy, createTransformer, defineConfig, doStatusCodeStrategy, generate, generateTypes, getCliVersion, getConfig, hasQueryParameter, isRequiredRequestBody, partitionApiModules, readSchema, readTemplateFile, renderApiModules, transformEntity, transformFn, transformModuleName, transformPayloads, transformType, transformTypeQuery, transformTypeQueryValue, transformTypeRequestBody, transformTypeRequestBodyValue, transformTypeResponseBody, transformTypeResponseBodyValue, transformTypeValue, transformUrl, transformVerb };
+export { type ApiModule, type ApiModulePayload, type ApiModuleTemplateData, type Config, type GenerateOptions, type Preset, type ResponseMetadataItem, type StatusCodeStrategy, type StatusCodes, type Transformer, type TransformerBaseArgs, createStatusCodesByStrategy, createTransformer, defineConfig, generate, generateTypes, getCliVersion, getConfig, getValidResponseMetadataItems, hasQueryParameter, isRequiredRequestBody, partitionApiModules, readSchema, readTemplateFile, renderApiModules, transformEntity, transformFn, transformModuleName, transformPayloads, transformType, transformTypeQuery, transformTypeQueryValue, transformTypeRequestBody, transformTypeRequestBodyValue, transformTypeResponseBody, transformTypeResponseBodyValue, transformTypeValue, transformUrl, transformVerb };

package/dist/index.js

@@ -20,16 +20,16 @@ import {
   transformTypeValue,
   transformUrl,
   transformVerb
-} from "./chunk-VAAFC73D.js";
+} from "./chunk-K46PCBCF.js";
 import {
   createStatusCodesByStrategy,
-  doStatusCodeStrategy,
   getCliVersion,
+  getValidResponseMetadataItems,
   hasQueryParameter,
   isRequiredRequestBody,
   readSchema,
   readTemplateFile
-} from "./chunk-LYOTF4II.js";
+} from "./chunk-SKKHIIUE.js";
 import "./chunk-6OIOYGN7.js";
 
 // src/index.ts
@@ -38,11 +38,11 @@ export {
   createStatusCodesByStrategy,
   createTransformer,
   defineConfig,
-  doStatusCodeStrategy,
   generate,
   generateTypes,
   getCliVersion,
   getConfig,
+  getValidResponseMetadataItems,
   hasQueryParameter,
   isRequiredRequestBody,
   partitionApiModules,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "api-farmer",
-  "version": "0.0.16",
+  "version": "0.0.18",
   "description": "API module generation tool based on Openapi3/Swagger2.",
   "keywords": [
     "cli",

package/templates/axios.ejs

@@ -1,7 +1,8 @@
-<% if (ts) { %> import { type AxiosRequestConfig } from 'axios' <% } %>
-import { request } from '@/request'
+<% if (ts && !typesOnly) { %> import { type AxiosRequestConfig } from 'axios' <% } %>
+<% if (!typesOnly) { %> import { request } from '@/request' <% } %>
 <% if (ts) { %> import { type paths } from './<%- typesFilename %>' <% } %>
 
+<% if (!typesOnly) { %>
 <% apiModule.payloads.forEach(payload => { %> -%>
 export const <%- payload.fn %> = (config<% if (ts) { %>: AxiosRequestConfig<<%- payload.typeRequestBody %>> <% } %>) 
 => request<% if (ts) { %><any, <%- payload.typeResponseBody %>><% } %>({
@@ -11,6 +12,7 @@ export const <%- payload.fn %> = (config<% if (ts) { %>: AxiosRequestConfig<<%-
 })
 
 <% }) %>
+<% } %>
 
 <% if (ts) { %>
 <% apiModule.payloads.forEach(payload => { %> -%>

package/templates/axle.ejs

@@ -1,6 +1,7 @@
-import { api } from '@/request'
+<% if (!typesOnly) { %> import { api } from '@/request' <% } %>
 <% if (ts) { %> import { type paths } from './<%- typesFilename %>' <% } %>
 
+<% if (!typesOnly) { %>
 <% apiModule.payloads.forEach(payload => { %> -%>
 export const <%- payload.fn %> = api
 <% if (ts) { %>
@@ -14,6 +15,7 @@ export const <%- payload.fn %> = api
 ('<%- payload.url %>', '<%- payload.method %>')
 
 <% }) %>
+<% } %>
 
 <% if (ts) { %>
 <% apiModule.payloads.forEach(payload => { %> -%>