@devbie/apits 1.0.2 → 1.0.4

package/dist/cjs/core/generator.js

@@ -45,7 +45,7 @@ var import_types = require("../types.js");
 var import_utils = require("../utils/utils.js");
 var import_getOutputPath = require("../utils/getOutputPath.js");
 var import_writeRequestClient = __toESM(require("./writeRequestClient.js"));
-function defaultClientImportTemplate(config) {
+function defaultClientImportTemplate(_config) {
   return `import request from './request'`;
 }
 var getDataKeySetStr = (method) => {
@@ -174,9 +174,9 @@ var Generator = class {
       })
     );
     const allApi = await (0, import_openApiToInterfaces.openApiToInterfaces)(openApiV3Json);
-    let interfaceList = allApi.interfaces;
+    const interfaceList = allApi.interfaces;
     const categoryCode = [...componentsCode];
-    for (let interfaceInfo of interfaceList) {
+    for (const interfaceInfo of interfaceList) {
       const code = await this.generateInterfaceCode(
         {
           ...this.config,

package/dist/cjs/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./types.js";
+export * from "./utils/helpers.js";

package/dist/cjs/types.d.ts

@@ -0,0 +1,330 @@
+/// <reference types="node" />
+export * from "json-schema";
+import { JSONSchema4 } from "json-schema";
+import { OpenAPIV3 } from "openapi-types";
+import { ParsedPath } from "path";
+/** Returns the client import snippet placed at the top of each generated file. */
+export type ClientImportTemplate = () => string;
+/** Interface definition */
+export interface Interface {
+    /** Interface name */
+    title: string;
+    /** Request path */
+    path: string;
+    /** Request method, HEAD and OPTIONS are handled like GET, others like POST */
+    method: Method;
+    /** Path parameters */
+    req_params: Array<{
+        /** Name */
+        name: string;
+        /** Description */
+        desc: string;
+        /** Example */
+        example: string;
+        /** Type (YApi-X) */
+        type?: RequestParamType;
+    }>;
+    /** GET only: query string */
+    req_query: Array<{
+        /** Name */
+        name: string;
+        /** Description */
+        desc: string;
+        /** Example */
+        example: string;
+        /** Required */
+        required: Required;
+        /** Type (YApi-X) */
+        type?: RequestQueryType;
+    }>;
+    /** POST only: request content type. No special handling needed for text, file, raw. */
+    req_body_type: RequestBodyType;
+    /** Whether it is json schema when `req_body_type = json` */
+    req_body_is_json_schema: boolean;
+    /** Request content when `req_body_type = form` */
+    req_body_form: Array<{
+        /** Name */
+        name: string;
+        /** Type */
+        type: RequestFormItemType;
+        /** Description */
+        desc: string;
+        /** Example */
+        example: string;
+        /** Required */
+        required: Required;
+        /**
+         * Whether the field accepts multiple files (a binary array in the
+         * OpenAPI schema, e.g. `files: {type: 'array', items: {format: 'binary'}}`).
+         * Only meaningful when `type` is `file`.
+         */
+        isArray?: boolean;
+        /** Allowed literal values when the form field is an enum */
+        enum?: Array<string | number>;
+    }>;
+    /**
+     * Whether the form body is `multipart/form-data` (true) or
+     * `application/x-www-form-urlencoded` (false). Only set when
+     * `req_body_type = form`.
+     */
+    req_body_multipart?: boolean;
+    /**
+     * JSON Schema fragment describing dynamic form fields (the
+     * `additionalProperties` of a multipart request schema). Used for
+     * runtime-named upload fields such as `evidence_0`, `evidence_1`, ...
+     */
+    req_body_additional?: Record<string, any>;
+    /** Request content when `req_body_type = json` */
+    req_body_other: string;
+    /** Response data type */
+    res_body_type: ResponseBodyType;
+    /** Whether it is json schema when `res_body_type = json` */
+    res_body_is_json_schema: boolean;
+    /** Response data */
+    res_body: string;
+    [key: string]: any;
+}
+/** Category information */
+export interface Category {
+    /** Category name */
+    name: string;
+    /** Category description */
+    desc: string;
+}
+/** Request method */
+export declare enum Method {
+    GET = "GET",
+    POST = "POST",
+    PUT = "PUT",
+    DELETE = "DELETE",
+    HEAD = "HEAD",
+    OPTIONS = "OPTIONS",
+    PATCH = "PATCH"
+}
+/** Required */
+export declare enum Required {
+    /** Not required */
+    false = "0",
+    /** Required */
+    true = "1"
+}
+/** Request body type */
+export declare enum RequestBodyType {
+    /** Query string */
+    query = "query",
+    /** Form */
+    form = "form",
+    /** JSON */
+    json = "json",
+    /** Plain text */
+    text = "text",
+    /** File */
+    file = "file",
+    /** Raw data */
+    raw = "raw",
+    /** No request data */
+    none = "none"
+}
+/** Request path parameter type */
+export declare enum RequestParamType {
+    /** String */
+    string = "string",
+    /** Number */
+    number = "number"
+}
+/** Request query parameter type */
+export declare enum RequestQueryType {
+    /** String */
+    string = "string",
+    /** Number */
+    number = "number"
+}
+/** Request form item type */
+export declare enum RequestFormItemType {
+    /** Plain text */
+    text = "text",
+    /** File */
+    file = "file"
+}
+/** Response body type */
+export declare enum ResponseBodyType {
+    /** JSON */
+    json = "json",
+    /** Plain text */
+    text = "text",
+    /** XML */
+    xml = "xml",
+    /** Raw data */
+    raw = "raw"
+}
+/** Extended interface definition */
+export interface ExtendedInterface extends Interface {
+    parsedPath: ParsedPath;
+}
+/**
+ * Generator configuration for one OpenAPI source.
+ */
+export interface ApiConfig {
+    /**
+     * The OpenAPI document to generate code from. Required.
+     *
+     * Accepts an http(s) URL or a local file path. Local files may be
+     * JSON (.json / .json5) or YAML (.yaml / .yml).
+     *
+     * @example 'http://localhost:3041/api-json'
+     * @example './openapi.json'
+     * @example './docs/openapi.yaml'
+     */
+    input: string;
+    /**
+     * Output directory for generated files (relative or absolute path).
+     *
+     * Two files are written into it: `<name>.ts` (type declarations and
+     * request functions) and `request.ts` (the axios client, unless
+     * `client` is false or the file already exists).
+     *
+     * @default 'src/api'
+     */
+    output?: string;
+    /**
+     * Base name of the generated types file: code is written to
+     * `<output>/<name>.ts`. Also serves as the source identifier for
+     * `apits gen -n <name>` filtering.
+     *
+     * Defaults to a name derived from `input`: the URL hostname
+     * (`http://localhost:3041/api-json` -> `localhost`) or the local file
+     * name without extension (`./user.openapi.yaml` -> `userOpenapi`).
+     * Duplicated derived names get an index suffix.
+     */
+    name?: string;
+    /**
+     * Runtime `baseURL` baked into every generated request function.
+     *
+     * Prefix with `[code]:` to emit the value as code instead of a string
+     * literal, e.g. to read from an env var at runtime:
+     *
+     * - `baseURL: '[code]:process.env.BASE_URL'` -> `baseURL: process.env.BASE_URL`
+     * - `baseURL: 'http://localhost:3000'`       -> `baseURL: "http://localhost:3000"`
+     *
+     * May also be a function receiving each API path and returning the
+     * baseURL to use for that path (or undefined to omit).
+     */
+    baseURL?: ((path: string) => string | undefined) | string;
+    /**
+     * Returns the import snippet placed at the top of every generated file —
+     * use it to point at a custom request client instead of the scaffolded
+     * `request.ts`.
+     *
+     * Providing this option also flips the default of `client` to `false`,
+     * so no unused `request.ts` is scaffolded; set `client: true` explicitly
+     * to keep both.
+     *
+     * @default () => "import request from './request'"
+     */
+    clientImportTemplate?: ClientImportTemplate;
+    /**
+     * Type used for the `extra` argument of every generated request
+     * function — the object spread into the underlying client call as
+     * per-request overrides (headers, signal, `responseType`, ...).
+     *
+     * Defaults to `AxiosRequestConfig`, in which case each generated file
+     * also imports that type from `axios`. When using a custom client via
+     * `clientImportTemplate`, set this to that client's config type and
+     * make sure `clientImportTemplate` imports it, e.g.:
+     *
+     * ```ts
+     * clientImportTemplate: () => "import {request, type RequestConfig} from '../fetch'",
+     * clientConfigType: 'RequestConfig',
+     * ```
+     *
+     * @default 'AxiosRequestConfig'
+     */
+    clientConfigType?: string;
+    /**
+     * Whether to scaffold the default axios request client into
+     * `<output>/request.ts` (skipped when that file already exists).
+     *
+     * Defaults to `true`, and to `false` when `clientImportTemplate` is
+     * provided without an explicit `client` value.
+     *
+     * @default true
+     */
+    client?: boolean;
+}
+/** Combined configuration. */
+export type SyntheticalConfig = Partial<ApiConfig & {
+    components: OpenAPIV3.Document["components"];
+}>;
+/** Configuration. */
+export type Config = ApiConfig;
+/**
+ * Request configuration.
+ */
+export interface RequestConfig<Path extends string = string, ParamName extends string = string, QueryName extends string = string, RequestDataOptional extends boolean = boolean> {
+    /** Interface path, starting with `/` */
+    path: Path;
+    /** Request method */
+    method: Method;
+    /** Request headers, all headers except Content-Type */
+    requestHeaders: Record<string, string>;
+    /** Request body type */
+    requestBodyType: RequestBodyType;
+    /** Response body type */
+    responseBodyType: ResponseBodyType;
+    /** List of path parameter names */
+    paramNames: ParamName[];
+    /** List of query parameter names */
+    queryNames: QueryName[];
+    /** Whether request data is optional */
+    requestDataOptional: RequestDataOptional;
+    /** JSON Schema for request data (only effective when JSON Schema generation is enabled) */
+    requestDataJsonSchema: JSONSchema4;
+    /** JSON Schema for response data (only effective when JSON Schema generation is enabled) */
+    responseDataJsonSchema: JSONSchema4;
+    /** Request function name */
+    requestFunctionName: string;
+}
+/**
+ * Request parameters.
+ */
+export interface RequestFunctionParams extends RequestConfig {
+    /** Raw data */
+    rawData: Record<string, any>;
+    /** Request data, excluding file data */
+    data: Record<string, any>;
+    /** Whether there is file data */
+    hasFileData: boolean;
+    /** Request file data */
+    fileData: Record<string, any>;
+    /** All request data, including data and fileData */
+    allData: Record<string, any>;
+    /** Get FormData instance for all request data (including files) */
+    getFormData: () => FormData;
+}
+/** Additional parameters of the request function */
+export type RequestFunctionRestArgs<T extends (...args: any[]) => any> = T extends (payload: any, ...args: infer R) => any ? R : never;
+/** Property definition */
+export interface PropDefinition {
+    /** Property name */
+    name: string;
+    /** Required */
+    required: boolean;
+    /** Type */
+    type: JSONSchema4["type"];
+    /** Comment */
+    comment: string;
+    /** Whether the property is an array (used for multi-file upload fields) */
+    isArray?: boolean;
+    /** Allowed literal values for enum properties */
+    enum?: Array<string | number>;
+}
+/** Property definition list */
+export type PropDefinitions = PropDefinition[];
+/** Request function body generation template function */
+export interface RequestFunctionTemplateProps {
+    baseURL?: string;
+    requestFunctionName: string;
+    requestDataTypeName: string;
+    extendedInterfaceInfo: ExtendedInterface;
+    responseDataTypeName: string;
+}

package/dist/cjs/utils/console.d.ts

@@ -0,0 +1,16 @@
+/** Log a plain message. */
+export declare function log(message?: any, ...args: any[]): void;
+/** Log an error message. */
+export declare function error(message?: any, ...args: any[]): void;
+/** Log an info message. */
+export declare function info(message?: any, ...args: any[]): void;
+/** Log a warning message. */
+export declare function warn(message?: any, ...args: any[]): void;
+/** Log a soft tip message with a prefix icon. */
+export declare function tips(message?: any, ...args: any[]): void;
+/** Log a success message. */
+export declare function success(message?: any, ...args: any[]): void;
+/** Print tabular data as a table. */
+export declare function table(tabularData: any, properties?: ReadonlyArray<string>): void;
+/** Print a separator line (or a blank line). */
+export declare function line(blank?: boolean): void;

package/dist/cjs/utils/getOutputPath.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Resolve the output file path for a generated file.
+ */
+import { Config } from "../types.js";
+export declare const getOutputFilePath: (config: Config, file: string) => string;

package/dist/cjs/utils/helpers.d.ts

@@ -0,0 +1,65 @@
+import type { AppendOptions } from "form-data";
+import type { Config, RequestConfig, RequestFunctionParams } from "../types.js";
+/**
+ * Normalize user configuration into a config array and apply built-in
+ * defaults.
+ *
+ * Defaults:
+ * - `output` falls back to `src/api`.
+ * - `client` falls back to `true`, except when a custom
+ *   `clientImportTemplate` is provided without an explicit `client` value —
+ *   in that case the scaffolded client is skipped automatically, otherwise
+ *   the generated `request.ts` would be dead code (the generated file
+ *   imports the custom client instead).
+ *
+ * @param config Configuration
+ */
+export declare function defineConfig(config: Config | Config[]): Config[];
+export declare class FileData<T = any> {
+    /**
+     * Original file data.
+     */
+    private originalFileData;
+    /**
+     * Options.
+     */
+    private options;
+    /**
+     * File data helper class, unified file upload for web, mini-program and other platforms.
+     *
+     * @param originalFileData Original file data
+     * @param options If using internal getFormData, options will be used by it
+     */
+    constructor(originalFileData: T, options?: AppendOptions);
+    /**
+     * Get original file data.
+     *
+     * @returns Original file data
+     */
+    getOriginalFileData(): T;
+    /**
+     * Get options.
+     */
+    getOptions(): AppendOptions | undefined;
+}
+/**
+ * Parse request data, separating normal data and file data from request data.
+ *
+ * @param [requestData] Request data to parse
+ * @returns Object containing normal data (data) and file data (fileData), when data and fileData are empty objects, it means no such data exists
+ */
+export declare function parseRequestData(requestData?: any): {
+    data: any;
+    fileData: any;
+};
+/**
+ * Prepare parameters to be passed to the request function.
+ */
+export declare function prepare(requestConfig: RequestConfig, requestData: any): RequestFunctionParams;
+/**
+ * Execute async function queue sequentially
+ * @param fns
+ * @param results
+ * @returns
+ */
+export declare const asyncFnArrayOrderRun: <T = any>(fns: (() => Promise<T>)[], results?: T[]) => Promise<T[]>;

package/dist/cjs/utils/helpers.js

@@ -121,7 +121,7 @@ function prepare(requestConfig, requestData) {
     const useNodeFormData = !useNativeFormData && // https://github.com/fjc0k/vtils/blob/master/src/utils/inNodeJS.ts
     typeof global === "object" && typeof global.process === "object" && typeof global.process.versions === "object" && global.process.versions.node != null;
     const UniFormData = useNativeFormData ? FormData : useNodeFormData ? (
-      // eslint-disable-next-line @typescript-eslint/no-var-requires
+      // eslint-disable-next-line @typescript-eslint/no-require-imports -- isomorphic shim: conditional CJS require when native FormData is unavailable
       require("form-data")
     ) : void 0;
     if (!UniFormData) {

package/dist/cjs/utils/openApiToInterfaces.d.ts

@@ -0,0 +1,14 @@
+import { OpenAPIV3 } from "openapi-types";
+import { Interface } from "../types.js";
+/**
+ * Convert an OpenAPI 3.x document into the internal `Interface[]` format.
+ *
+ * Reads OAS3 directly — no intermediate Swagger 2.0 `openapi3Format` step,
+ * no YApi platform fields (`_id`/`project_id`/`catid`/`add_time`/`up_time`),
+ * no module-level mutable state.
+ *
+ * @param data OpenAPI 3.x document (object or JSON string)
+ */
+export declare function openApiToInterfaces(data: OpenAPIV3.Document | string): Promise<{
+    interfaces: Interface[];
+}>;

package/dist/cjs/utils/spinner.d.ts

@@ -0,0 +1,15 @@
+import { Ora } from "ora";
+declare class Spin {
+    spinnerInstance: Ora;
+    constructor();
+    clear(): void;
+    start(text?: string): void;
+    succeed(text?: string): void;
+    fail(text?: string): void;
+    render(): void;
+    frame(): void;
+    info(text?: string): void;
+    stop(): void;
+}
+export declare const spinnerInstance: Spin;
+export {};

package/dist/cjs/utils/vtilsLite.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Local replacements for the small subset of `vtils` helpers used by this
+ * project. `vtils` pulls in several deprecated dependencies (cuid, uuid,
+ * tough-cookie@0.12.1 with a ReDoS advisory) and is otherwise unmaintained,
+ * so these minimal local implementations keep the dependency tree clean.
+ *
+ * Behavior matches the upstream vtils functions for the call sites in this
+ * repository only; no attempt is made to be a drop-in replacement for the
+ * full vtils API.
+ */
+/**
+ * Remove `undefined` from a type. Equivalent to vtils's `Defined<T>`.
+ */
+export type Defined<T> = Exclude<T, undefined>;
+/**
+ * Wrap a value in an array unless it is already an array.
+ */
+export declare function castArray<T>(value: T | T[]): T[];
+/**
+ * `Array.isArray` alias, kept for import symmetry with the other helpers.
+ */
+export declare const isArray: (arg: any) => arg is any[];
+/**
+ * Check whether a value is a plain object (not null, not an array, not a
+ * function, not a primitive). Matches vtils `isObject` for the JSON-Schema
+ * values used in this project.
+ */
+export declare function isObject(value: any): value is Record<string, any>;
+/**
+ * Check whether a value is "empty": null/undefined, empty string, empty
+ * array, or an object with no own enumerable string-keyed properties.
+ */
+export declare function isEmpty(value: any): boolean;
+/**
+ * Iterate over the own enumerable string-keyed properties of an object,
+ * invoking `callback(value, key)` for each.
+ */
+export declare function forOwn<T extends object>(obj: T, callback: (value: T[keyof T], key: keyof T) => void): void;
+/**
+ * Iterate over a collection (array or object), invoking `callback(value, key)`
+ * for each item. For arrays `key` is the numeric index. Types are intentionally
+ * loose (matching vtils) because call sites pass heterogeneous OpenAPI data.
+ */
+export declare function each(collection: any, callback: (value: any, key: any) => void): void;
+/**
+ * Return the first item in a collection for which `predicate` returns a
+ * truthy value, or `undefined` if none matches.
+ */
+export declare function find(collection: any, predicate: (value: any, key: any) => boolean): any;
+/**
+ * Tagged-template helper that strips the common leading whitespace from every
+ * line. Multi-line interpolations keep the indentation of the line they are
+ * embedded on (mirrors vtils `dedent`, which first runs `indent`).
+ */
+export declare function dedent(literals: TemplateStringsArray, ...interpolations: any[]): string;

package/dist/esm/core/cli.mjs

@@ -169,6 +169,7 @@ function loadConfigFile(discovered) {
   if (kind === "ts") {
     var _mod$default;
     // tsx is registered at module load time.
+    // eslint-disable-next-line @typescript-eslint/no-require-imports -- user config files are loaded dynamically at runtime
     var mod = require(filePath);
     return normalizeConfig((_mod$default = mod.default) !== null && _mod$default !== void 0 ? _mod$default : mod);
   }

package/dist/esm/core/generator.mjs

@@ -33,7 +33,7 @@ import { getRequestDataJsonSchema, getResponseDataJsonSchema, jsonSchemaToTsCode
 import { getOutputFilePath } from "../utils/getOutputPath.mjs";
 import writeRequestClient from "./writeRequestClient.mjs";
 // Default client import snippet placed at the top of generated files.
-function defaultClientImportTemplate(config) {
+function defaultClientImportTemplate(_config) {
   return "import request from './request'";
 }
 var getDataKeySetStr = function getDataKeySetStr(method) {
@@ -47,7 +47,6 @@ var getDataKeySetStr = function getDataKeySetStr(method) {
 // request function can substitute path params from the incoming data object.
 function handlePathParam(path) {
   if (path.match(/\{(\w+)\}/)) {
-    // eslint-disable-next-line no-template-curly-in-string
     return "`".concat(path.replace(/\{(\w+)\}/g, "${data.$1}"), "`");
   }
   return JSON.stringify(path);

package/dist/esm/core/writeRequestClient.mjs

@@ -4,7 +4,6 @@ function _regeneratorRuntime() { "use strict"; /*! regenerator-runtime -- Copyri
 function _taggedTemplateLiteral(strings, raw) { if (!raw) { raw = strings.slice(0); } return Object.freeze(Object.defineProperties(strings, { raw: { value: Object.freeze(raw) } })); }
 function asyncGeneratorStep(gen, resolve, reject, _next, _throw, key, arg) { try { var info = gen[key](arg); var value = info.value; } catch (error) { reject(error); return; } if (info.done) { resolve(value); } else { Promise.resolve(value).then(_next, _throw); } }
 function _asyncToGenerator(fn) { return function () { var self = this, args = arguments; return new Promise(function (resolve, reject) { var gen = fn.apply(self, args); function _next(value) { asyncGeneratorStep(gen, resolve, reject, _next, _throw, "next", value); } function _throw(err) { asyncGeneratorStep(gen, resolve, reject, _next, _throw, "throw", err); } _next(undefined); }); }; }
-/* eslint-disable @typescript-eslint/explicit-module-boundary-types */
 import fs from "fs-extra";
 import { dedent } from "../utils/vtilsLite.mjs";
 import { getOutputFilePath } from "../utils/getOutputPath.mjs";

package/dist/esm/index.d.mts

@@ -0,0 +1,2 @@
+export * from "./types.mjs";
+export * from "./utils/helpers.mjs";

package/dist/esm/types.d.mts

@@ -0,0 +1,330 @@
+/// <reference types="node" />
+export * from "json-schema";
+import { JSONSchema4 } from "json-schema";
+import { OpenAPIV3 } from "openapi-types";
+import { ParsedPath } from "path";
+/** Returns the client import snippet placed at the top of each generated file. */
+export type ClientImportTemplate = () => string;
+/** Interface definition */
+export interface Interface {
+    /** Interface name */
+    title: string;
+    /** Request path */
+    path: string;
+    /** Request method, HEAD and OPTIONS are handled like GET, others like POST */
+    method: Method;
+    /** Path parameters */
+    req_params: Array<{
+        /** Name */
+        name: string;
+        /** Description */
+        desc: string;
+        /** Example */
+        example: string;
+        /** Type (YApi-X) */
+        type?: RequestParamType;
+    }>;
+    /** GET only: query string */
+    req_query: Array<{
+        /** Name */
+        name: string;
+        /** Description */
+        desc: string;
+        /** Example */
+        example: string;
+        /** Required */
+        required: Required;
+        /** Type (YApi-X) */
+        type?: RequestQueryType;
+    }>;
+    /** POST only: request content type. No special handling needed for text, file, raw. */
+    req_body_type: RequestBodyType;
+    /** Whether it is json schema when `req_body_type = json` */
+    req_body_is_json_schema: boolean;
+    /** Request content when `req_body_type = form` */
+    req_body_form: Array<{
+        /** Name */
+        name: string;
+        /** Type */
+        type: RequestFormItemType;
+        /** Description */
+        desc: string;
+        /** Example */
+        example: string;
+        /** Required */
+        required: Required;
+        /**
+         * Whether the field accepts multiple files (a binary array in the
+         * OpenAPI schema, e.g. `files: {type: 'array', items: {format: 'binary'}}`).
+         * Only meaningful when `type` is `file`.
+         */
+        isArray?: boolean;
+        /** Allowed literal values when the form field is an enum */
+        enum?: Array<string | number>;
+    }>;
+    /**
+     * Whether the form body is `multipart/form-data` (true) or
+     * `application/x-www-form-urlencoded` (false). Only set when
+     * `req_body_type = form`.
+     */
+    req_body_multipart?: boolean;
+    /**
+     * JSON Schema fragment describing dynamic form fields (the
+     * `additionalProperties` of a multipart request schema). Used for
+     * runtime-named upload fields such as `evidence_0`, `evidence_1`, ...
+     */
+    req_body_additional?: Record<string, any>;
+    /** Request content when `req_body_type = json` */
+    req_body_other: string;
+    /** Response data type */
+    res_body_type: ResponseBodyType;
+    /** Whether it is json schema when `res_body_type = json` */
+    res_body_is_json_schema: boolean;
+    /** Response data */
+    res_body: string;
+    [key: string]: any;
+}
+/** Category information */
+export interface Category {
+    /** Category name */
+    name: string;
+    /** Category description */
+    desc: string;
+}
+/** Request method */
+export declare enum Method {
+    GET = "GET",
+    POST = "POST",
+    PUT = "PUT",
+    DELETE = "DELETE",
+    HEAD = "HEAD",
+    OPTIONS = "OPTIONS",
+    PATCH = "PATCH"
+}
+/** Required */
+export declare enum Required {
+    /** Not required */
+    false = "0",
+    /** Required */
+    true = "1"
+}
+/** Request body type */
+export declare enum RequestBodyType {
+    /** Query string */
+    query = "query",
+    /** Form */
+    form = "form",
+    /** JSON */
+    json = "json",
+    /** Plain text */
+    text = "text",
+    /** File */
+    file = "file",
+    /** Raw data */
+    raw = "raw",
+    /** No request data */
+    none = "none"
+}
+/** Request path parameter type */
+export declare enum RequestParamType {
+    /** String */
+    string = "string",
+    /** Number */
+    number = "number"
+}
+/** Request query parameter type */
+export declare enum RequestQueryType {
+    /** String */
+    string = "string",
+    /** Number */
+    number = "number"
+}
+/** Request form item type */
+export declare enum RequestFormItemType {
+    /** Plain text */
+    text = "text",
+    /** File */
+    file = "file"
+}
+/** Response body type */
+export declare enum ResponseBodyType {
+    /** JSON */
+    json = "json",
+    /** Plain text */
+    text = "text",
+    /** XML */
+    xml = "xml",
+    /** Raw data */
+    raw = "raw"
+}
+/** Extended interface definition */
+export interface ExtendedInterface extends Interface {
+    parsedPath: ParsedPath;
+}
+/**
+ * Generator configuration for one OpenAPI source.
+ */
+export interface ApiConfig {
+    /**
+     * The OpenAPI document to generate code from. Required.
+     *
+     * Accepts an http(s) URL or a local file path. Local files may be
+     * JSON (.json / .json5) or YAML (.yaml / .yml).
+     *
+     * @example 'http://localhost:3041/api-json'
+     * @example './openapi.json'
+     * @example './docs/openapi.yaml'
+     */
+    input: string;
+    /**
+     * Output directory for generated files (relative or absolute path).
+     *
+     * Two files are written into it: `<name>.ts` (type declarations and
+     * request functions) and `request.ts` (the axios client, unless
+     * `client` is false or the file already exists).
+     *
+     * @default 'src/api'
+     */
+    output?: string;
+    /**
+     * Base name of the generated types file: code is written to
+     * `<output>/<name>.ts`. Also serves as the source identifier for
+     * `apits gen -n <name>` filtering.
+     *
+     * Defaults to a name derived from `input`: the URL hostname
+     * (`http://localhost:3041/api-json` -> `localhost`) or the local file
+     * name without extension (`./user.openapi.yaml` -> `userOpenapi`).
+     * Duplicated derived names get an index suffix.
+     */
+    name?: string;
+    /**
+     * Runtime `baseURL` baked into every generated request function.
+     *
+     * Prefix with `[code]:` to emit the value as code instead of a string
+     * literal, e.g. to read from an env var at runtime:
+     *
+     * - `baseURL: '[code]:process.env.BASE_URL'` -> `baseURL: process.env.BASE_URL`
+     * - `baseURL: 'http://localhost:3000'`       -> `baseURL: "http://localhost:3000"`
+     *
+     * May also be a function receiving each API path and returning the
+     * baseURL to use for that path (or undefined to omit).
+     */
+    baseURL?: ((path: string) => string | undefined) | string;
+    /**
+     * Returns the import snippet placed at the top of every generated file —
+     * use it to point at a custom request client instead of the scaffolded
+     * `request.ts`.
+     *
+     * Providing this option also flips the default of `client` to `false`,
+     * so no unused `request.ts` is scaffolded; set `client: true` explicitly
+     * to keep both.
+     *
+     * @default () => "import request from './request'"
+     */
+    clientImportTemplate?: ClientImportTemplate;
+    /**
+     * Type used for the `extra` argument of every generated request
+     * function — the object spread into the underlying client call as
+     * per-request overrides (headers, signal, `responseType`, ...).
+     *
+     * Defaults to `AxiosRequestConfig`, in which case each generated file
+     * also imports that type from `axios`. When using a custom client via
+     * `clientImportTemplate`, set this to that client's config type and
+     * make sure `clientImportTemplate` imports it, e.g.:
+     *
+     * ```ts
+     * clientImportTemplate: () => "import {request, type RequestConfig} from '../fetch'",
+     * clientConfigType: 'RequestConfig',
+     * ```
+     *
+     * @default 'AxiosRequestConfig'
+     */
+    clientConfigType?: string;
+    /**
+     * Whether to scaffold the default axios request client into
+     * `<output>/request.ts` (skipped when that file already exists).
+     *
+     * Defaults to `true`, and to `false` when `clientImportTemplate` is
+     * provided without an explicit `client` value.
+     *
+     * @default true
+     */
+    client?: boolean;
+}
+/** Combined configuration. */
+export type SyntheticalConfig = Partial<ApiConfig & {
+    components: OpenAPIV3.Document["components"];
+}>;
+/** Configuration. */
+export type Config = ApiConfig;
+/**
+ * Request configuration.
+ */
+export interface RequestConfig<Path extends string = string, ParamName extends string = string, QueryName extends string = string, RequestDataOptional extends boolean = boolean> {
+    /** Interface path, starting with `/` */
+    path: Path;
+    /** Request method */
+    method: Method;
+    /** Request headers, all headers except Content-Type */
+    requestHeaders: Record<string, string>;
+    /** Request body type */
+    requestBodyType: RequestBodyType;
+    /** Response body type */
+    responseBodyType: ResponseBodyType;
+    /** List of path parameter names */
+    paramNames: ParamName[];
+    /** List of query parameter names */
+    queryNames: QueryName[];
+    /** Whether request data is optional */
+    requestDataOptional: RequestDataOptional;
+    /** JSON Schema for request data (only effective when JSON Schema generation is enabled) */
+    requestDataJsonSchema: JSONSchema4;
+    /** JSON Schema for response data (only effective when JSON Schema generation is enabled) */
+    responseDataJsonSchema: JSONSchema4;
+    /** Request function name */
+    requestFunctionName: string;
+}
+/**
+ * Request parameters.
+ */
+export interface RequestFunctionParams extends RequestConfig {
+    /** Raw data */
+    rawData: Record<string, any>;
+    /** Request data, excluding file data */
+    data: Record<string, any>;
+    /** Whether there is file data */
+    hasFileData: boolean;
+    /** Request file data */
+    fileData: Record<string, any>;
+    /** All request data, including data and fileData */
+    allData: Record<string, any>;
+    /** Get FormData instance for all request data (including files) */
+    getFormData: () => FormData;
+}
+/** Additional parameters of the request function */
+export type RequestFunctionRestArgs<T extends (...args: any[]) => any> = T extends (payload: any, ...args: infer R) => any ? R : never;
+/** Property definition */
+export interface PropDefinition {
+    /** Property name */
+    name: string;
+    /** Required */
+    required: boolean;
+    /** Type */
+    type: JSONSchema4["type"];
+    /** Comment */
+    comment: string;
+    /** Whether the property is an array (used for multi-file upload fields) */
+    isArray?: boolean;
+    /** Allowed literal values for enum properties */
+    enum?: Array<string | number>;
+}
+/** Property definition list */
+export type PropDefinitions = PropDefinition[];
+/** Request function body generation template function */
+export interface RequestFunctionTemplateProps {
+    baseURL?: string;
+    requestFunctionName: string;
+    requestDataTypeName: string;
+    extendedInterfaceInfo: ExtendedInterface;
+    responseDataTypeName: string;
+}

package/dist/esm/utils/console.d.mts

@@ -0,0 +1,16 @@
+/** Log a plain message. */
+export declare function log(message?: any, ...args: any[]): void;
+/** Log an error message. */
+export declare function error(message?: any, ...args: any[]): void;
+/** Log an info message. */
+export declare function info(message?: any, ...args: any[]): void;
+/** Log a warning message. */
+export declare function warn(message?: any, ...args: any[]): void;
+/** Log a soft tip message with a prefix icon. */
+export declare function tips(message?: any, ...args: any[]): void;
+/** Log a success message. */
+export declare function success(message?: any, ...args: any[]): void;
+/** Print tabular data as a table. */
+export declare function table(tabularData: any, properties?: ReadonlyArray<string>): void;
+/** Print a separator line (or a blank line). */
+export declare function line(blank?: boolean): void;

package/dist/esm/utils/getOutputPath.d.mts

@@ -0,0 +1,5 @@
+/**
+ * Resolve the output file path for a generated file.
+ */
+import { Config } from "../types.mjs";
+export declare const getOutputFilePath: (config: Config, file: string) => string;

package/dist/esm/utils/getOutputPath.mjs

@@ -2,7 +2,6 @@
  * Resolve the output file path for a generated file.
  */
 
-/* eslint-disable @typescript-eslint/explicit-module-boundary-types */
 import path from "path";
 export var getOutputFilePath = function getOutputFilePath(config, file) {
   var _path$parse = path.parse(config.output || ""),

package/dist/esm/utils/helpers.d.mts

@@ -0,0 +1,65 @@
+import type { AppendOptions } from "form-data";
+import type { Config, RequestConfig, RequestFunctionParams } from "../types.mjs";
+/**
+ * Normalize user configuration into a config array and apply built-in
+ * defaults.
+ *
+ * Defaults:
+ * - `output` falls back to `src/api`.
+ * - `client` falls back to `true`, except when a custom
+ *   `clientImportTemplate` is provided without an explicit `client` value —
+ *   in that case the scaffolded client is skipped automatically, otherwise
+ *   the generated `request.ts` would be dead code (the generated file
+ *   imports the custom client instead).
+ *
+ * @param config Configuration
+ */
+export declare function defineConfig(config: Config | Config[]): Config[];
+export declare class FileData<T = any> {
+    /**
+     * Original file data.
+     */
+    private originalFileData;
+    /**
+     * Options.
+     */
+    private options;
+    /**
+     * File data helper class, unified file upload for web, mini-program and other platforms.
+     *
+     * @param originalFileData Original file data
+     * @param options If using internal getFormData, options will be used by it
+     */
+    constructor(originalFileData: T, options?: AppendOptions);
+    /**
+     * Get original file data.
+     *
+     * @returns Original file data
+     */
+    getOriginalFileData(): T;
+    /**
+     * Get options.
+     */
+    getOptions(): AppendOptions | undefined;
+}
+/**
+ * Parse request data, separating normal data and file data from request data.
+ *
+ * @param [requestData] Request data to parse
+ * @returns Object containing normal data (data) and file data (fileData), when data and fileData are empty objects, it means no such data exists
+ */
+export declare function parseRequestData(requestData?: any): {
+    data: any;
+    fileData: any;
+};
+/**
+ * Prepare parameters to be passed to the request function.
+ */
+export declare function prepare(requestConfig: RequestConfig, requestData: any): RequestFunctionParams;
+/**
+ * Execute async function queue sequentially
+ * @param fns
+ * @param results
+ * @returns
+ */
+export declare const asyncFnArrayOrderRun: <T = any>(fns: (() => Promise<T>)[], results?: T[]) => Promise<T[]>;

package/dist/esm/utils/helpers.mjs

@@ -161,7 +161,7 @@ export function prepare(requestConfig, requestData) {
     // https://github.com/fjc0k/vtils/blob/master/src/utils/inNodeJS.ts
     (typeof global === "undefined" ? "undefined" : _typeof(global)) === "object" && _typeof(global.process) === "object" && _typeof(global.process.versions) === "object" && global.process.versions.node != null;
     var UniFormData = useNativeFormData ? FormData : useNodeFormData ?
-    // eslint-disable-next-line @typescript-eslint/no-var-requires
+    // eslint-disable-next-line @typescript-eslint/no-require-imports -- isomorphic shim: conditional CJS require when native FormData is unavailable
     require("form-data") : undefined;
     if (!UniFormData) {
       throw new Error("FormData is not supported in the current environment");

package/dist/esm/utils/openApiToInterfaces.d.mts

@@ -0,0 +1,14 @@
+import { OpenAPIV3 } from "openapi-types";
+import { Interface } from "../types.mjs";
+/**
+ * Convert an OpenAPI 3.x document into the internal `Interface[]` format.
+ *
+ * Reads OAS3 directly — no intermediate Swagger 2.0 `openapi3Format` step,
+ * no YApi platform fields (`_id`/`project_id`/`catid`/`add_time`/`up_time`),
+ * no module-level mutable state.
+ *
+ * @param data OpenAPI 3.x document (object or JSON string)
+ */
+export declare function openApiToInterfaces(data: OpenAPIV3.Document | string): Promise<{
+    interfaces: Interface[];
+}>;

package/dist/esm/utils/spinner.d.mts

@@ -0,0 +1,15 @@
+import { Ora } from "ora";
+declare class Spin {
+    spinnerInstance: Ora;
+    constructor();
+    clear(): void;
+    start(text?: string): void;
+    succeed(text?: string): void;
+    fail(text?: string): void;
+    render(): void;
+    frame(): void;
+    info(text?: string): void;
+    stop(): void;
+}
+export declare const spinnerInstance: Spin;
+export {};

package/dist/esm/utils/utils.mjs

@@ -94,6 +94,7 @@ export function processJsonSchema(jsonSchema) {
 
   // Mock.toJSONSchema produces `properties` as an array, but JSONSchema4 expects an object.
   if (isArray(jsonSchema.properties)) {
+    // eslint-disable-next-line @typescript-eslint/ban-ts-comment -- narrowing the array to the object shape here is intentional and type-safe at runtime
     // @ts-ignore
     jsonSchema.properties = jsonSchema.properties.reduce(function (props, js) {
       props[js.name] = js;

package/dist/esm/utils/vtilsLite.d.mts

@@ -0,0 +1,55 @@
+/**
+ * Local replacements for the small subset of `vtils` helpers used by this
+ * project. `vtils` pulls in several deprecated dependencies (cuid, uuid,
+ * tough-cookie@0.12.1 with a ReDoS advisory) and is otherwise unmaintained,
+ * so these minimal local implementations keep the dependency tree clean.
+ *
+ * Behavior matches the upstream vtils functions for the call sites in this
+ * repository only; no attempt is made to be a drop-in replacement for the
+ * full vtils API.
+ */
+/**
+ * Remove `undefined` from a type. Equivalent to vtils's `Defined<T>`.
+ */
+export type Defined<T> = Exclude<T, undefined>;
+/**
+ * Wrap a value in an array unless it is already an array.
+ */
+export declare function castArray<T>(value: T | T[]): T[];
+/**
+ * `Array.isArray` alias, kept for import symmetry with the other helpers.
+ */
+export declare const isArray: (arg: any) => arg is any[];
+/**
+ * Check whether a value is a plain object (not null, not an array, not a
+ * function, not a primitive). Matches vtils `isObject` for the JSON-Schema
+ * values used in this project.
+ */
+export declare function isObject(value: any): value is Record<string, any>;
+/**
+ * Check whether a value is "empty": null/undefined, empty string, empty
+ * array, or an object with no own enumerable string-keyed properties.
+ */
+export declare function isEmpty(value: any): boolean;
+/**
+ * Iterate over the own enumerable string-keyed properties of an object,
+ * invoking `callback(value, key)` for each.
+ */
+export declare function forOwn<T extends object>(obj: T, callback: (value: T[keyof T], key: keyof T) => void): void;
+/**
+ * Iterate over a collection (array or object), invoking `callback(value, key)`
+ * for each item. For arrays `key` is the numeric index. Types are intentionally
+ * loose (matching vtils) because call sites pass heterogeneous OpenAPI data.
+ */
+export declare function each(collection: any, callback: (value: any, key: any) => void): void;
+/**
+ * Return the first item in a collection for which `predicate` returns a
+ * truthy value, or `undefined` if none matches.
+ */
+export declare function find(collection: any, predicate: (value: any, key: any) => boolean): any;
+/**
+ * Tagged-template helper that strips the common leading whitespace from every
+ * line. Multi-line interpolations keep the indentation of the line they are
+ * embedded on (mirrors vtils `dedent`, which first runs `indent`).
+ */
+export declare function dedent(literals: TemplateStringsArray, ...interpolations: any[]): string;

package/package.json

@@ -1,12 +1,18 @@
 {
   "name": "@devbie/apits",
-  "version": "1.0.2",
-  "author": "zimv <zimudashiren@163.com>",
+  "version": "1.0.4",
+  "author": "worldzhy",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/worldzhy/newbie.git",
+    "directory": "packages/apits"
+  },
   "main": "./dist/cjs/index.js",
   "module": "./dist/esm/index.mjs",
   "types": "./dist/cjs/index.d.ts",
   "bin": {
-    "apits": "./bin/apits"
+    "apits": "bin/apits"
   },
   "files": [
     "bin",
@@ -14,20 +20,18 @@
   ],
   "scripts": {
     "build": "father build",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
     "gen": "rm -rf ./api & tsx test/gen.ts --type-check false gen",
     "gen:api-1": "tsx test/gen.ts --type-check false gen -n api-1",
     "init": "tsx test/gen.ts --type-check false init",
+    "lint": "eslint",
+    "lint:fix": "eslint --fix",
     "publishOnly": "npm run build",
-    "release": "npm run build && standard-version && git push --follow-tags origin master && npm publish",
     "requestTest": "tsx watch test/requestTest.ts --type-check false",
     "test": "tsx test/index.ts",
     "test2": "tsx watch test/json-schema-to-typescript.ts --type-check false"
   },
-  "lint-staged": {
-    "src/**/*.ts": [
-      "eslint --fix"
-    ]
-  },
   "dependencies": {
     "chalk": "^4.1.1",
     "change-case": "^3.1.0",
@@ -52,16 +56,9 @@
     "@types/json-schema": "^7.0.1",
     "@types/json5": "^0.0.30",
     "@types/node": "^18.7.14",
-    "@types/prompts": "^1.2.0",
+    "@types/prompts": "^1.0.4",
     "@types/yargs": "^16.0.1",
-    "@typescript-eslint/eslint-plugin": "^6.21.0",
-    "@typescript-eslint/parser": "^6.21.0",
-    "eslint": "^7.16.0",
-    "eslint-config-airbnb-base": "^15.0.0",
-    "eslint-config-prettier": "^9.1.2",
-    "eslint-plugin-prettier": "^5.5.7",
-    "father": "^4",
-    "standard-version": "^4.4.0"
+    "father": "^4"
   },
   "publishConfig": {
     "access": "public",