@jayfong/x-server 1.8.0

package/CHANGELOG.md

@@ -0,0 +1,154 @@
+# Changelog
+
+All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
+
+## [1.8.0](https://github.com/jfWorks/x-server/compare/v1.7.2...v1.8.0) (2022-04-18)
+
+
+### Features
+
+* 更改包名为 @jayfong/x-server ([1be9998](https://github.com/jfWorks/x-server/commit/1be9998070cc0960aeef2d333356f66a22bb5766))
+* 移除 cwd 选项 ([12cfa42](https://github.com/jfWorks/x-server/commit/12cfa4222ec8d69d73f2b38a68ea6aa975dbe575))
+* npc ([5d314ea](https://github.com/jfWorks/x-server/commit/5d314ea341a72ae5b09db979d5d2b63ffadf0670))
+* plugins ([1df0cd1](https://github.com/jfWorks/x-server/commit/1df0cd10ccf170d9e7180abf9d27416304856894))
+* service 通过 x 提供 ([a159154](https://github.com/jfWorks/x-server/commit/a1591541e865e755d4d6dbdeb405d5d08b334a4a))
+* templates ([deeb0d6](https://github.com/jfWorks/x-server/commit/deeb0d643bdf04d04533d20bd1d5a068b178347a))
+
+
+### Bug Fixes
+
+* test ([994845b](https://github.com/jfWorks/x-server/commit/994845b0e2ac84ce050494de27b705c1e45fb343))
+
+### [1.7.2](https://github.com/jfWorks/x-server/compare/v1.7.1...v1.7.2) (2022-04-16)
+
+
+### Bug Fixes
+
+* npx -> tnpx ([2ef5650](https://github.com/jfWorks/x-server/commit/2ef5650679dbc1ceea5a44e8348c31aa06f5ae5b))
+
+### [1.7.1](https://github.com/jfWorks/x-server/compare/v1.7.0...v1.7.1) (2022-04-16)
+
+## [1.7.0](https://github.com/jfWorks/x-server/compare/v1.6.0...v1.7.0) (2021-11-08)
+
+
+### Features
+
+* 升级 vtils 使用 dedent, ms ([251591b](https://github.com/jfWorks/x-server/commit/251591ba47b9a9d619e038adcb66dfb52fd80264))
+
+## [1.6.0](https://github.com/jfWorks/x-server/compare/v1.5.7...v1.6.0) (2021-11-07)
+
+
+### Features
+
+* 支持 npc ([53069e6](https://github.com/jfWorks/x-server/commit/53069e6ba77d2ad8852cc2d5d7ede73a9d05c1da))
+
+### [1.5.7](https://github.com/jfWorks/x-server/compare/v1.5.6...v1.5.7) (2021-11-07)
+
+### [1.5.6](https://github.com/jfWorks/x-server/compare/v1.5.5...v1.5.6) (2021-11-07)
+
+
+### Bug Fixes
+
+* task ([f36571a](https://github.com/jfWorks/x-server/commit/f36571a51d32fff19d62c233cc31fd250d90281a))
+
+### [1.5.5](https://github.com/jfWorks/x-server/compare/v1.5.4...v1.5.5) (2021-11-07)
+
+
+### Bug Fixes
+
+* env ([5917b3d](https://github.com/jfWorks/x-server/commit/5917b3dddaeb750c692c7ac8a1af6fdb65eab942))
+
+### [1.5.4](https://github.com/jfWorks/x-server/compare/v1.5.3...v1.5.4) (2021-11-07)
+
+
+### Bug Fixes
+
+* 兼容 prisma ([41c3417](https://github.com/jfWorks/x-server/commit/41c34175d2af074c44e76422d9ba2b421be556c9))
+
+### [1.5.3](https://github.com/jfWorks/x-server/compare/v1.5.2...v1.5.3) (2021-11-07)
+
+
+### Bug Fixes
+
+* 兼容 prisma ([668bfd1](https://github.com/jfWorks/x-server/commit/668bfd1d7efd91b1a3c607d7050379d43fccdd22))
+
+### [1.5.2](https://github.com/jfWorks/x-server/compare/v1.5.1...v1.5.2) (2021-11-07)
+
+### [1.5.1](https://github.com/jfWorks/x-server/compare/v1.5.0...v1.5.1) (2021-11-07)
+
+
+### Bug Fixes
+
+* env ([f79cd48](https://github.com/jfWorks/x-server/commit/f79cd48a3ee9101605d9ac80dbaac5f8ca7f94df))
+
+## [1.5.0](https://github.com/jfWorks/x-server/compare/v1.4.0...v1.5.0) (2021-11-07)
+
+
+### Features
+
+* 支持 DATABASE_ACTION_URL ([e21884e](https://github.com/jfWorks/x-server/commit/e21884eeca8e1c451f8536d93663e1b663ee5303))
+
+## [1.4.0](https://github.com/jfWorks/x-server/compare/v1.3.1...v1.4.0) (2021-11-06)
+
+
+### Features
+
+* 进一步简化部署流程 ([a2062d8](https://github.com/jfWorks/x-server/commit/a2062d8d07df2a256d470ec10b633183fa5e44c1))
+* build 优化 ([4d988bb](https://github.com/jfWorks/x-server/commit/4d988bb953f68a44916d6bb89c9d05ee5801abb9))
+
+### [1.3.1](https://github.com/jfWorks/x-server/compare/v1.3.0...v1.3.1) (2021-11-06)
+
+
+### Bug Fixes
+
+* **cli/build:** 将 svg-captcha 加入 external ([d2b9b8d](https://github.com/jfWorks/x-server/commit/d2b9b8d7e4818d7eb3eb5249b6b24c344a9f027b))
+* ws ([6cdb442](https://github.com/jfWorks/x-server/commit/6cdb4421415b4e607a6e00c5469a955114aca112))
+
+## [1.3.0](https://github.com/jfWorks/x-server/compare/v1.1.3...v1.3.0) (2021-11-06)
+
+
+### Features
+
+* deploy ([b0808ce](https://github.com/jfWorks/x-server/commit/b0808cec8d5eb35fe80897e13db719151f6935b3))
+* **EnvUtil:** 支持多行 ([fb99204](https://github.com/jfWorks/x-server/commit/fb9920478db090fce3eb57340b71e8c9b5c9af96))
+
+
+### Bug Fixes
+
+* deploy ([0a02537](https://github.com/jfWorks/x-server/commit/0a02537d4e1198249f6e0d9c1fc6e40b7c24684c))
+
+## [1.2.0](https://github.com/jfWorks/x-server/compare/v1.1.3...v1.2.0) (2021-11-05)
+
+
+### Features
+
+* deploy ([b0808ce](https://github.com/jfWorks/x-server/commit/b0808cec8d5eb35fe80897e13db719151f6935b3))
+* **EnvUtil:** 支持多行 ([fb99204](https://github.com/jfWorks/x-server/commit/fb9920478db090fce3eb57340b71e8c9b5c9af96))
+
+### [1.1.3](https://github.com/jfWorks/x-server/compare/v1.1.2...v1.1.3) (2021-11-05)
+
+
+### Bug Fixes
+
+* **EnvUtil:** 解析注释正则更新 ([5e9cfbf](https://github.com/jfWorks/x-server/commit/5e9cfbff44a8695f648e7b7ef25226b1e6c4b350))
+
+### [1.1.2](https://github.com/jfWorks/x-server/compare/v1.1.1...v1.1.2) (2021-11-05)
+
+### [1.1.1](https://github.com/jfWorks/x-server/compare/v1.1.0...v1.1.1) (2021-11-05)
+
+## [1.1.0](https://github.com/jfWorks/x-server/compare/v1.0.1...v1.1.0) (2021-11-05)
+
+
+### Features
+
+* **cli:** 新增 run ([c9d8de0](https://github.com/jfWorks/x-server/commit/c9d8de01de8373541f6e4e628fe43067a58d0b8b))
+* **cli:** prisma 支持通过 mode 传入环境 ([5547b7b](https://github.com/jfWorks/x-server/commit/5547b7b66205b25e545a94db88665c513cc8fbd0))
+* **cli:** prisma 支持增强 ([2be1aa1](https://github.com/jfWorks/x-server/commit/2be1aa1394d6aac5c2f4c9a7ca24a3b89a4c0811))
+* **run:** 不传 script 时选择 npm scripts ([474baf0](https://github.com/jfWorks/x-server/commit/474baf0f30b039600922679850f494dadbea4963))
+
+
+### Bug Fixes
+
+* **cli:** 简化模式配置 ([a4e9e41](https://github.com/jfWorks/x-server/commit/a4e9e413b8e5209489a3944ae0bb7930c42a999c))
+
+### 1.0.1 (2021-11-05)

package/README.md

@@ -0,0 +1,51 @@
+# x-server
+
+X 服务端。
+
+## 技术栈
+
+- [fastify v3](https://github.com/fastify/fastify)
+- [prisma v3](https://github.com/prisma/prisma)
+
+## 特性
+
+- 通过 `cache` 支持 redis 缓存
+- 通过 `jwt` 支持用户认证
+- 通过 `captcha` 支持验证码
+- 通过 `defineHandler` 支持 POST、GET、POST、FILE、WS、XML 请求
+- 通过 `defineTask` 支持定时任务
+
+## 命令
+
+### xs dev
+
+开始开发
+
+- `-i aaa -i bbb`: 额外需要生成的索引文件
+- `-npc xxx@bbbb`: npc 地址及密钥，格式：地址@密钥
+
+### xs build
+
+构建
+
+- `-e aaa -e bbb`: 不应该被打的包
+
+### xs deploy
+
+部署
+
+### xs api
+
+生成 API
+
+### xs prisma
+
+prisma 代理，主要为了注入环境变量
+
+- `-p false`: 是否生产模式
+
+### xs run
+
+执行 package.json 里的脚本
+
+- `-p false`: 是否生产模式

package/lib/cli/api_generator.d.ts

@@ -0,0 +1,44 @@
+import * as ts from 'ts-morph';
+import createDebug from 'debug';
+import type { JSONSchema4 } from 'json-schema';
+import type { XHandler } from '../core/types';
+interface ApiData {
+    name: string;
+    desc: string;
+    type: 'string' | 'number' | 'boolean' | 'object' | 'array' | 'file';
+    enum: any[];
+    required: boolean;
+    children: ApiData[];
+}
+declare type ApiHandles = Array<{
+    category: string;
+    name: string;
+    path: string;
+    handlerMethod: XHandler.Method;
+    method: string;
+    requestData: ApiData;
+    responseData: ApiData;
+    requestDataJsonSchema: JSONSchema4;
+    responseDataJsonSchema: JSONSchema4;
+}>;
+export declare class ApiGenerator {
+    debug: createDebug.Debugger;
+    cwd: string;
+    project: ts.Project;
+    getTypeBySymbol(symbol: ts.Symbol): ts.Type;
+    getComment(declaration?: ts.Node): {
+        existing: boolean;
+        description: string;
+        tags: Map<string, string>;
+    };
+    getCommentBySymbol(symbol: ts.Symbol): string;
+    typeToApiData(type: ts.Type, _symbol?: ts.Symbol): ApiData;
+    apiDataToJsonSchema(apiData: ApiData, jsonSchema?: JSONSchema4): JSONSchema4;
+    genYApiData(handles: ApiHandles): {
+        name: string;
+        desc: string;
+        list: any;
+    }[];
+    generate(): Promise<void>;
+}
+export {};

package/lib/cli/api_generator.js

@@ -0,0 +1,339 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ApiGenerator = void 0;
+const parseComment = __importStar(require("comment-parser"));
+const ts = __importStar(require("ts-morph"));
+const debug_1 = __importDefault(require("debug"));
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const node_path_1 = __importDefault(require("node:path"));
+const http_method_1 = require("../core/http_method");
+const vtils_1 = require("vtils");
+class ApiGenerator {
+    constructor() {
+        this.debug = (0, debug_1.default)('api');
+        this.cwd = process.cwd();
+    }
+    getTypeBySymbol(symbol) {
+        return symbol.getTypeAtLocation(symbol.getDeclarations()[0] || symbol.getValueDeclarationOrThrow());
+    }
+    getComment(declaration) {
+        const text = (declaration?.getLeadingCommentRanges()[0]?.getText() || '').trim();
+        const comment = parseComment.parse(text)[0];
+        const description = comment?.description || '';
+        const tags = new Map();
+        comment?.tags.forEach(tag => {
+            tags.set(tag.tag, tag.description);
+        });
+        return {
+            existing: !!comment,
+            description: description,
+            tags: tags,
+        };
+    }
+    getCommentBySymbol(symbol) {
+        return this.getComment(symbol.getDeclarations()[0])?.description || '';
+    }
+    typeToApiData(type, _symbol) {
+        // ws
+        if (type.getSymbol()?.getName() === 'SocketStream') {
+            return {
+                name: 'ws',
+                desc: 'ws',
+                required: false,
+                type: 'object',
+                children: [],
+                enum: [],
+            };
+        }
+        // XFile
+        if (type.getSymbol()?.getName() === 'MultipartFile') {
+            const symbol = _symbol || type.getSymbol();
+            return {
+                name: 'file',
+                desc: (symbol && this.getCommentBySymbol(symbol)) || '',
+                required: !!symbol && !(symbol.getFlags() & ts.SymbolFlags.Optional),
+                type: 'file',
+                children: [],
+                enum: [],
+            };
+        }
+        let isRequired = true;
+        let isUnion = type.isUnion();
+        const unionTypes = isUnion
+            ? type
+                .getUnionTypes()
+                .filter(item => !item.isBooleanLiteral() && !item.isNull() && !item.isUndefined())
+            : [];
+        isUnion = !!unionTypes.length;
+        if (isUnion) {
+            if (unionTypes.length === 1 && !unionTypes[0].isLiteral()) {
+                isUnion = false;
+            }
+            // 兼容 prisma 生成的类型用 null 表示可选
+            isRequired = unionTypes.length === type.getUnionTypes().length;
+            // 必须用 getBaseTypeOfLiteralType 获取枚举字面量的原始类型
+            type = unionTypes[0].getBaseTypeOfLiteralType();
+        }
+        const isEnum = type.isEnum();
+        const enumData = isEnum
+            ? // @ts-ignore
+                type.compilerType.types.reduce((res, item) => {
+                    res[item.getSymbol().getName()] = item.value;
+                    return res;
+                }, {})
+            : {};
+        const enumKeys = Object.keys(enumData);
+        const enumValues = Object.values(enumData);
+        const isIntersection = type.isIntersection();
+        const intersectionTypes = isIntersection && type.getIntersectionTypes();
+        const isArray = type.isArray();
+        const isString = isEnum
+            ? typeof enumValues[0] === 'string'
+            : type.isString() || ['Date'].includes(type.getSymbol()?.getName() || '');
+        const isNumber = isEnum
+            ? typeof enumValues[0] === 'number'
+            : type.isNumber();
+        const isBoolean = type.isBoolean() ||
+            (type.isUnion() &&
+                type.getUnionTypes().some(item => item.isBooleanLiteral()) &&
+                type
+                    .getUnionTypes()
+                    .every(item => item.isBooleanLiteral() || item.isNull() || item.isUndefined()));
+        const isObject = (!isArray && !isString && !isNumber && !isBoolean && type.isObject()) ||
+            // 将交集类型视为对象
+            isIntersection;
+        const symbol = _symbol || type.getSymbol();
+        const apiName = symbol?.getName() || '__type';
+        const apiDesc = [
+            symbol && this.getCommentBySymbol(symbol),
+            isEnum &&
+                `枚举：${enumKeys
+                    .map((key, index) => `${key}->${enumValues[index]}`)
+                    .join('; ')}`,
+        ]
+            .filter(Boolean)
+            .join('\n');
+        const apiEnum = isUnion
+            ? unionTypes.map(t => t.getLiteralValue())
+            : isEnum
+                ? enumValues
+                : [];
+        const apiType = isArray
+            ? 'array'
+            : isString
+                ? 'string'
+                : isNumber
+                    ? 'number'
+                    : isBoolean
+                        ? 'boolean'
+                        : 'object';
+        const apiRequired = isRequired === false
+            ? false
+            : !!symbol && !(symbol.getFlags() & ts.SymbolFlags.Optional);
+        const apiChildren = isArray
+            ? [this.typeToApiData(type.getArrayElementTypeOrThrow())]
+            : isObject
+                ? (0, vtils_1.ii)(() => {
+                    const context = type._context;
+                    const compilerFactory = context.compilerFactory;
+                    const rawChecker = type.compilerType
+                        .checker;
+                    let symbols = [];
+                    if (intersectionTypes) {
+                        // https://github.com/microsoft/TypeScript/issues/38184
+                        symbols = rawChecker
+                            .getAllPossiblePropertiesOfTypes(intersectionTypes.map(item => item.compilerType))
+                            // https://github.com/dsherret/ts-morph/blob/a7072fcf6f9babb784b40f0326c80dea4563a4aa/packages/ts-morph/src/compiler/types/Type.ts#L296
+                            .map((symbol) => compilerFactory.getSymbol(symbol));
+                    }
+                    else {
+                        // symbols = type.getApparentProperties()
+                        // https://github.com/microsoft/TypeScript/issues/38184
+                        symbols = rawChecker
+                            .getAllPossiblePropertiesOfTypes([type.compilerType])
+                            // https://github.com/dsherret/ts-morph/blob/a7072fcf6f9babb784b40f0326c80dea4563a4aa/packages/ts-morph/src/compiler/types/Type.ts#L296
+                            .map((symbol) => compilerFactory.getSymbol(symbol));
+                    }
+                    return symbols.map(symbol => {
+                        return this.typeToApiData(!symbol.compilerSymbol.declarations
+                            ? // 对于复杂对象，没有定义的，通过 type 直接获取（在前面通过 getText 预处理得到）
+                                compilerFactory.getType(symbol.compilerSymbol.type)
+                            : this.getTypeBySymbol(symbol), symbol);
+                    });
+                })
+                : [];
+        return {
+            name: apiName,
+            desc: apiDesc,
+            enum: apiEnum,
+            type: apiType,
+            required: apiRequired,
+            children: apiChildren,
+        };
+    }
+    apiDataToJsonSchema(apiData, jsonSchema = {}) {
+        jsonSchema.description = apiData.desc;
+        if (apiData.type === 'object') {
+            jsonSchema.type = 'object';
+            jsonSchema.properties = apiData.children.reduce((res, item) => {
+                ;
+                res[item.name] = this.apiDataToJsonSchema(item);
+                return res;
+            }, {});
+            jsonSchema.required = apiData.children
+                .filter(item => item.required)
+                .map(item => item.name);
+        }
+        else if (apiData.type === 'array') {
+            jsonSchema.type = 'array';
+            jsonSchema.items = apiData.children.map(item => this.apiDataToJsonSchema(item))[0];
+        }
+        else {
+            jsonSchema.type = apiData.type;
+            if (apiData.enum.length) {
+                jsonSchema.enum = apiData.enum;
+            }
+        }
+        return jsonSchema;
+    }
+    genYApiData(handles) {
+        const data = {};
+        for (const handle of handles) {
+            data[handle.category] = data[handle.category] || [];
+            data[handle.category].push(handle.handlerMethod === 'FILE'
+                ? {
+                    method: handle.method.toUpperCase(),
+                    title: handle.name,
+                    path: handle.path,
+                    req_body_type: 'form',
+                    res_body_type: 'json',
+                    req_body_is_json_schema: false,
+                    res_body_is_json_schema: true,
+                    req_params: [],
+                    req_query: [],
+                    req_headers: [],
+                    req_body_form: handle.requestData.children.map(item => ({
+                        required: item.required ? 1 : 0,
+                        name: item.name,
+                        type: item.type === 'file' ? 'file' : 'text',
+                    })),
+                    res_body: JSON.stringify(handle.responseDataJsonSchema),
+                }
+                : {
+                    method: handle.method.toUpperCase(),
+                    title: handle.name,
+                    path: handle.path,
+                    req_body_type: 'json',
+                    res_body_type: 'json',
+                    req_body_is_json_schema: true,
+                    res_body_is_json_schema: true,
+                    req_params: [],
+                    req_query: [],
+                    req_headers: [],
+                    req_body_form: [],
+                    req_body_other: JSON.stringify(handle.requestDataJsonSchema),
+                    res_body: JSON.stringify(handle.responseDataJsonSchema),
+                });
+        }
+        return Object.keys(data).map(cat => ({
+            name: cat,
+            desc: cat,
+            list: data[cat],
+        }));
+    }
+    async generate() {
+        this.debug('启动项目...');
+        this.project = new ts.Project({
+            tsConfigFilePath: node_path_1.default.join(this.cwd, 'tsconfig.json'),
+        });
+        this.debug('加载文件...');
+        const sourceFile = this.project.getSourceFileOrThrow(node_path_1.default.join(this.cwd, 'src/generated/handlers.ts'));
+        this.debug('导出处理器...');
+        const handlerGroup = sourceFile.getExportSymbols();
+        const handles = [];
+        this.debug('生成API文档...');
+        for (const handlerList of handlerGroup) {
+            const handlerListSourceFile = this.getTypeBySymbol(handlerList)
+                .getProperties()[0]
+                .getDeclarations()[0]
+                .getSourceFile();
+            const basePath = `/${(0, vtils_1.snakeCase)(handlerListSourceFile
+                .getFilePath()
+                .replace('.ts', '')
+                .split('/src/handlers/')[1]).replace(/_/g, '/')}/`.replace(/\/{2,}/g, '/');
+            for (const handler of handlerListSourceFile
+                .getVariableStatements()
+                .filter(item => item.isExported())) {
+                // 重要：这一步必须，先调一遍 getText 获取看到的对象，后续对于复杂定义才不会报错
+                handler.getDeclarations().forEach(exp => {
+                    exp.getType().getText();
+                });
+                const handlerExp = handler.getDeclarations()[0];
+                const handlerPath = `${basePath}${handlerExp.getName()}`;
+                this.debug('生成接口: %s ...', handlerPath);
+                const [requestType, responseType, methodType] = handlerExp
+                    .getType()
+                    .getTypeArguments();
+                const handlerComment = this.getComment(handlerExp.getParent().getParent());
+                if (handlerComment.tags.has('private')) {
+                    this.debug('跳过生成接口: %s', `${handlerPath}`);
+                    continue;
+                }
+                const handlerCategory = (0, vtils_1.pascalCase)(basePath) || 'ROOT';
+                const handlerName = handlerComment.description || handlerPath;
+                const handlerMethod = methodType.getLiteralValueOrThrow();
+                const serverMethod = http_method_1.HandlerMethodToHttpMethod[handlerMethod];
+                const requestData = this.typeToApiData(requestType);
+                const responseData = this.typeToApiData(responseType);
+                const requestDataJsonSchema = this.apiDataToJsonSchema(requestData);
+                const responseDataJsonSchema = this.apiDataToJsonSchema(responseData);
+                handles.push({
+                    category: handlerCategory,
+                    name: handlerName,
+                    path: handlerPath,
+                    handlerMethod: handlerMethod,
+                    method: serverMethod,
+                    requestData: requestData,
+                    responseData: responseData,
+                    requestDataJsonSchema: requestDataJsonSchema,
+                    responseDataJsonSchema: responseDataJsonSchema,
+                });
+            }
+        }
+        this.debug('写入文件...');
+        await Promise.all([
+            fs_extra_1.default.outputJSON(node_path_1.default.join(this.cwd, 'temp/api.json'), handles, {
+                spaces: 2,
+            }),
+            fs_extra_1.default.outputJSON(node_path_1.default.join(this.cwd, 'temp/yapi.json'), this.genYApiData(handles), { spaces: 2 }),
+        ]);
+    }
+}
+exports.ApiGenerator = ApiGenerator;
+// new ApiGenerator().generate()

package/lib/cli/build_util.d.ts

@@ -0,0 +1,9 @@
+import { ParsedEnv } from './env_util';
+export interface BuildOptions {
+    cwd: string;
+    external?: string[];
+    inlineEnvs?: ParsedEnv[];
+}
+export declare class BuildUtil {
+    static build(options: BuildOptions): Promise<void>;
+}