@dune2/cli 1.1.4 → 1.1.6
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/cli.mjs
CHANGED
|
@@ -3,7 +3,7 @@ import cac from "cac";
|
|
|
3
3
|
import debug from "debug";
|
|
4
4
|
|
|
5
5
|
//#region package.json
|
|
6
|
-
var version = "1.1.
|
|
6
|
+
var version = "1.1.5";
|
|
7
7
|
|
|
8
8
|
//#endregion
|
|
9
9
|
//#region src/shared/index.ts
|
|
@@ -21,7 +21,7 @@ debug.enable(`${cli.name}:*`);
|
|
|
21
21
|
//#endregion
|
|
22
22
|
//#region src/cli.ts
|
|
23
23
|
cli.command("generateApi", "生成 api 文件").example("dune generateApi").action(async () => {
|
|
24
|
-
const { generateApi } = await import("./generateApi-
|
|
24
|
+
const { generateApi } = await import("./generateApi-BMRAxjkM.mjs");
|
|
25
25
|
await generateApi();
|
|
26
26
|
});
|
|
27
27
|
cli.command("init", "初始化配置文件").example("dune init").action(async () => {
|
|
@@ -0,0 +1,329 @@
|
|
|
1
|
+
import { r as getConfig } from "./config-CxSOgXuG.mjs";
|
|
2
|
+
import { n as createLogger } from "./cli.mjs";
|
|
3
|
+
import path from "path";
|
|
4
|
+
import SwaggerParser from "@apidevtools/swagger-parser";
|
|
5
|
+
import { camelCase, isPlainObject, merge } from "es-toolkit";
|
|
6
|
+
import { compile } from "json-schema-to-typescript";
|
|
7
|
+
import { AsyncLocalStorage } from "node:async_hooks";
|
|
8
|
+
import fs from "node:fs/promises";
|
|
9
|
+
import * as os from "os";
|
|
10
|
+
import pMap from "p-map";
|
|
11
|
+
import enquirer from "enquirer";
|
|
12
|
+
|
|
13
|
+
//#region src/shared/promptConfigEnable.ts
|
|
14
|
+
const { prompt } = enquirer;
|
|
15
|
+
async function promptConfigEnable(opt) {
|
|
16
|
+
const { configArr, getChoiceItem } = opt;
|
|
17
|
+
if (configArr.length <= 1) return configArr;
|
|
18
|
+
const res = await prompt({
|
|
19
|
+
type: "multiselect",
|
|
20
|
+
message: "选择要生效的配置项",
|
|
21
|
+
hint: "(空格选中，回车确认)",
|
|
22
|
+
name: "enabled",
|
|
23
|
+
validate(value) {
|
|
24
|
+
return value.length === 0 ? `至少选择一项` : true;
|
|
25
|
+
},
|
|
26
|
+
choices: [{
|
|
27
|
+
name: "全部",
|
|
28
|
+
message: "全部",
|
|
29
|
+
choices: configArr.map((item) => {
|
|
30
|
+
return getChoiceItem(item);
|
|
31
|
+
})
|
|
32
|
+
}]
|
|
33
|
+
});
|
|
34
|
+
configArr.forEach((item) => {
|
|
35
|
+
item.enabled = opt.checkIsEnabled(res.enabled, item);
|
|
36
|
+
});
|
|
37
|
+
return configArr.filter((c) => c.enabled);
|
|
38
|
+
}
|
|
39
|
+
function promptApiConfigEnable(configArr) {
|
|
40
|
+
return promptConfigEnable({
|
|
41
|
+
configArr: configArr ?? [],
|
|
42
|
+
getChoiceItem: (item) => {
|
|
43
|
+
return {
|
|
44
|
+
name: item.output,
|
|
45
|
+
hint: `swaggerJSONPath: ${item.swaggerJSONPath}`
|
|
46
|
+
};
|
|
47
|
+
},
|
|
48
|
+
checkIsEnabled: (enabledArr, item) => {
|
|
49
|
+
return enabledArr.includes(item.output);
|
|
50
|
+
}
|
|
51
|
+
});
|
|
52
|
+
}
|
|
53
|
+
|
|
54
|
+
//#endregion
|
|
55
|
+
//#region src/commands/generateApi/index.ts
|
|
56
|
+
const log = createLogger("generateApi");
|
|
57
|
+
const asyncLocalStorage = new AsyncLocalStorage();
|
|
58
|
+
async function generateApi() {
|
|
59
|
+
const selectedConfigs = await promptApiConfigEnable((await getConfig()).api);
|
|
60
|
+
const apiConfigs = selectedConfigs.filter((apiConfig) => {
|
|
61
|
+
if (!apiConfig.output) {
|
|
62
|
+
log.error("配置 %s 缺少 output，已跳过", apiConfig.swaggerJSONPath);
|
|
63
|
+
return false;
|
|
64
|
+
}
|
|
65
|
+
return true;
|
|
66
|
+
});
|
|
67
|
+
const skippedConfigCount = selectedConfigs.length - apiConfigs.length;
|
|
68
|
+
if (skippedConfigCount > 0) log.info("由于缺少 output，跳过 %d 个配置", skippedConfigCount);
|
|
69
|
+
if (!apiConfigs.length) {
|
|
70
|
+
log.info("没有需要生成的 API 配置，生成流程结束");
|
|
71
|
+
return;
|
|
72
|
+
}
|
|
73
|
+
log.info("本次将生成 %d 个 API 配置", apiConfigs.length);
|
|
74
|
+
let totalSuccessCount = 0;
|
|
75
|
+
let totalFailedCount = 0;
|
|
76
|
+
const startedAt = Date.now();
|
|
77
|
+
const preparedConfigs = [];
|
|
78
|
+
for (const apiConfig of apiConfigs) {
|
|
79
|
+
log.info("开始初始化输出目录 %s", apiConfig.output);
|
|
80
|
+
const prepareStartedAt = Date.now();
|
|
81
|
+
try {
|
|
82
|
+
await fs.rm(apiConfig.output, {
|
|
83
|
+
recursive: true,
|
|
84
|
+
force: true
|
|
85
|
+
});
|
|
86
|
+
await fs.mkdir(apiConfig.output, { recursive: true });
|
|
87
|
+
preparedConfigs.push(apiConfig);
|
|
88
|
+
log.info("输出目录 %s 初始化完成，耗时 %dms", apiConfig.output, Date.now() - prepareStartedAt);
|
|
89
|
+
} catch (error) {
|
|
90
|
+
totalFailedCount++;
|
|
91
|
+
const message = error instanceof Error ? error.message : String(error);
|
|
92
|
+
log.error("初始化输出目录 %s 失败：%s", apiConfig.output, message);
|
|
93
|
+
}
|
|
94
|
+
}
|
|
95
|
+
if (!preparedConfigs.length) {
|
|
96
|
+
log.error("所有配置都初始化失败，生成流程结束");
|
|
97
|
+
log.info("generateApi Done，成功 %d 个，失败 %d 个，总耗时 %dms", totalSuccessCount, totalFailedCount, Date.now() - startedAt);
|
|
98
|
+
return;
|
|
99
|
+
}
|
|
100
|
+
for (const apiConfig of preparedConfigs) {
|
|
101
|
+
log.info("开始解析 %s", apiConfig.swaggerJSONPath);
|
|
102
|
+
const dereferenceConfig = merge({ resolve: { http: { timeout: 30 * 1e3 } } }, apiConfig.dereferenceSwaggerConfig || {});
|
|
103
|
+
const parser = new SwaggerParser();
|
|
104
|
+
const bundleStartedAt = Date.now();
|
|
105
|
+
let parsed;
|
|
106
|
+
try {
|
|
107
|
+
parsed = await parser.bundle(apiConfig.swaggerJSONPath, dereferenceConfig);
|
|
108
|
+
log.info("解析 %s 成功，耗时 %dms", apiConfig.swaggerJSONPath, Date.now() - bundleStartedAt);
|
|
109
|
+
} catch (error) {
|
|
110
|
+
totalFailedCount++;
|
|
111
|
+
const message = error instanceof Error ? error.message : String(error);
|
|
112
|
+
log.error("解析 %s 失败：%s", apiConfig.swaggerJSONPath, message);
|
|
113
|
+
continue;
|
|
114
|
+
}
|
|
115
|
+
const state = {
|
|
116
|
+
parsed,
|
|
117
|
+
parser
|
|
118
|
+
};
|
|
119
|
+
let generatedCount = 0;
|
|
120
|
+
let skippedCount = 0;
|
|
121
|
+
const pathEntries = Object.entries(parsed.paths ?? {});
|
|
122
|
+
if (!pathEntries.length) {
|
|
123
|
+
log.error("%s 中没有可用的 paths，已跳过", apiConfig.swaggerJSONPath);
|
|
124
|
+
totalFailedCount++;
|
|
125
|
+
continue;
|
|
126
|
+
}
|
|
127
|
+
await asyncLocalStorage.run(state, async () => {
|
|
128
|
+
await pMap(pathEntries, async ([url, pathItemObject]) => {
|
|
129
|
+
if (!pathItemObject) {
|
|
130
|
+
log.error("路径 %s 未定义 pathItemObject，已跳过", url);
|
|
131
|
+
skippedCount++;
|
|
132
|
+
return;
|
|
133
|
+
}
|
|
134
|
+
log.info("开始生成 %s", url);
|
|
135
|
+
let generatedForUrl = 0;
|
|
136
|
+
await pMap([
|
|
137
|
+
"get",
|
|
138
|
+
"put",
|
|
139
|
+
"post",
|
|
140
|
+
"delete",
|
|
141
|
+
"patch"
|
|
142
|
+
], async (method) => {
|
|
143
|
+
const operationObject = pathItemObject[method];
|
|
144
|
+
if (!operationObject) return;
|
|
145
|
+
try {
|
|
146
|
+
const code = await generateApiRequestCode({
|
|
147
|
+
url,
|
|
148
|
+
method,
|
|
149
|
+
operationObject,
|
|
150
|
+
apiConfig
|
|
151
|
+
});
|
|
152
|
+
const outputPath = path.join(apiConfig.output, url, apiConfig.enableTs ? `${method}.ts` : `${method}.js`).replace(/:/g, "_");
|
|
153
|
+
await fs.mkdir(path.dirname(outputPath), { recursive: true });
|
|
154
|
+
await fs.writeFile(outputPath, code);
|
|
155
|
+
generatedCount++;
|
|
156
|
+
generatedForUrl++;
|
|
157
|
+
} catch (error) {
|
|
158
|
+
skippedCount++;
|
|
159
|
+
const message = error instanceof Error ? error.message : String(error);
|
|
160
|
+
log.error("%s %s 生成失败：%s", method.toUpperCase(), url, message);
|
|
161
|
+
}
|
|
162
|
+
});
|
|
163
|
+
if (generatedForUrl === 0) log.info("路径 %s 未生成任何方法", url);
|
|
164
|
+
});
|
|
165
|
+
});
|
|
166
|
+
if (!generatedCount) {
|
|
167
|
+
log.error("%s 未生成任何请求，已标记失败", apiConfig.swaggerJSONPath);
|
|
168
|
+
totalFailedCount++;
|
|
169
|
+
continue;
|
|
170
|
+
}
|
|
171
|
+
if (apiConfig.codeFormatterCmd) {
|
|
172
|
+
const { exec } = await import("child_process");
|
|
173
|
+
await new Promise((resolve) => {
|
|
174
|
+
exec(`${apiConfig.codeFormatterCmd} "${apiConfig.output}"`, (error) => {
|
|
175
|
+
if (error) {
|
|
176
|
+
skippedCount++;
|
|
177
|
+
log.error(`Code formatting failed: ${error.message}`);
|
|
178
|
+
} else log.info(`Code formatting success`);
|
|
179
|
+
resolve();
|
|
180
|
+
});
|
|
181
|
+
});
|
|
182
|
+
}
|
|
183
|
+
log.info("%s 生成完成，共生成 %d 个请求，跳过 %d 个", apiConfig.swaggerJSONPath, generatedCount, skippedCount);
|
|
184
|
+
totalSuccessCount++;
|
|
185
|
+
}
|
|
186
|
+
log.info("generateApi Done，成功 %d 个，失败 %d 个，总耗时 %dms", totalSuccessCount, totalFailedCount, Date.now() - startedAt);
|
|
187
|
+
}
|
|
188
|
+
/**
|
|
189
|
+
* 根据请求方法，生成请求代码
|
|
190
|
+
*/
|
|
191
|
+
async function generateApiRequestCode(options) {
|
|
192
|
+
var _operationObject$tags, _operationObject$tags2;
|
|
193
|
+
const { method, operationObject, apiConfig } = options;
|
|
194
|
+
const url = (() => {
|
|
195
|
+
if (typeof apiConfig.urlTransformer === "string") return `${apiConfig.urlTransformer}${options.url}`;
|
|
196
|
+
if (typeof apiConfig.urlTransformer === "function") return apiConfig.urlTransformer(options.url);
|
|
197
|
+
return options.url;
|
|
198
|
+
})();
|
|
199
|
+
const seeUrl = apiConfig.swaggerUiUrl ? `${apiConfig.swaggerUiUrl}#/${encodeURIComponent(`${((_operationObject$tags = operationObject.tags) === null || _operationObject$tags === void 0 ? void 0 : _operationObject$tags.join("/")) ?? ""}/${operationObject.operationId}`)}` : "";
|
|
200
|
+
let requestBuilderName = camelCase(`${options.url}_${method}_api`);
|
|
201
|
+
if (!/^[a-zA-Z_$][0-9a-zA-Z_$]*$/.test(requestBuilderName)) requestBuilderName = `_${requestBuilderName}`;
|
|
202
|
+
const urlPathParams = getUrlPathParams(operationObject.parameters ?? []);
|
|
203
|
+
const urlPathParamsCode = urlPathParams.length ? `urlPathParams: ${JSON.stringify(urlPathParams)},` : "";
|
|
204
|
+
let code = [
|
|
205
|
+
"// do not edit this file manually, it will be overwritten by @dune2/cli",
|
|
206
|
+
apiConfig.RequestBuilderImportPath,
|
|
207
|
+
apiConfig.queryClientImportPath,
|
|
208
|
+
"/**",
|
|
209
|
+
` * ${operationObject.summary}`,
|
|
210
|
+
` * @tags ${(_operationObject$tags2 = operationObject.tags) === null || _operationObject$tags2 === void 0 ? void 0 : _operationObject$tags2.join(",")}`,
|
|
211
|
+
seeUrl && ` * @see ${seeUrl}`,
|
|
212
|
+
` */`
|
|
213
|
+
].filter(Boolean);
|
|
214
|
+
let builderCode = `\
|
|
215
|
+
export const ${requestBuilderName} = new RequestBuilder({
|
|
216
|
+
url: '${url}',
|
|
217
|
+
method: '${method}',
|
|
218
|
+
${urlPathParamsCode}
|
|
219
|
+
${apiConfig.queryClientImportPath ? "queryClient," : ""}
|
|
220
|
+
});`.replace(/,\n\s*}/, "," + os.EOL + "}");
|
|
221
|
+
if (apiConfig.enableTs) builderCode = builderCode.replace("new RequestBuilder(", `new RequestBuilder<${requestBuilderName}.Req, ${requestBuilderName}.Res>(`);
|
|
222
|
+
code.push(builderCode);
|
|
223
|
+
if (apiConfig.enableTs) {
|
|
224
|
+
const [requestParamsTypeCode, responseParamsTypeCode] = await Promise.all([compileRequestParams(operationObject), compileResponseParams(operationObject, apiConfig)]);
|
|
225
|
+
code.push(`
|
|
226
|
+
export namespace ${requestBuilderName} {
|
|
227
|
+
${requestParamsTypeCode.code}
|
|
228
|
+
|
|
229
|
+
${responseParamsTypeCode}
|
|
230
|
+
};`);
|
|
231
|
+
}
|
|
232
|
+
return code.join(os.EOL);
|
|
233
|
+
}
|
|
234
|
+
function getUrlPathParams(parameters) {
|
|
235
|
+
return parameters.filter((item) => item.in === "path").map((item) => item.name);
|
|
236
|
+
}
|
|
237
|
+
/**
|
|
238
|
+
* 这个方法还不完善，只能处理简单的请求参数
|
|
239
|
+
*/
|
|
240
|
+
async function compileRequestParams(operationObject) {
|
|
241
|
+
const store = asyncLocalStorage.getStore();
|
|
242
|
+
const schemaOrRefObject = (() => {
|
|
243
|
+
if (operationObject.requestBody) {
|
|
244
|
+
if ("$ref" in operationObject.requestBody) return operationObject.requestBody;
|
|
245
|
+
return operationObject.requestBody.content["application/json"].schema;
|
|
246
|
+
}
|
|
247
|
+
if (operationObject.parameters) {
|
|
248
|
+
const extraProperties = {};
|
|
249
|
+
const parameters = [];
|
|
250
|
+
operationObject.parameters.forEach((item) => {
|
|
251
|
+
if (!["query", "path"].includes(item.in)) return;
|
|
252
|
+
if (item.schema && "type" in item.schema && item.schema.type === "object") Object.assign(extraProperties, item.schema.properties || {});
|
|
253
|
+
else parameters.push(item);
|
|
254
|
+
});
|
|
255
|
+
return {
|
|
256
|
+
required: parameters.filter((p) => p.required && ![
|
|
257
|
+
"pageNum",
|
|
258
|
+
"pageSize",
|
|
259
|
+
"count"
|
|
260
|
+
].includes(p.name)).map((p) => p.name),
|
|
261
|
+
type: "object",
|
|
262
|
+
properties: {
|
|
263
|
+
...Object.fromEntries(parameters.filter((p) => !!p.schema).map((p) => {
|
|
264
|
+
const schema = p.schema;
|
|
265
|
+
return [p.name, {
|
|
266
|
+
...schema,
|
|
267
|
+
description: p.description
|
|
268
|
+
}];
|
|
269
|
+
})),
|
|
270
|
+
...extraProperties
|
|
271
|
+
}
|
|
272
|
+
};
|
|
273
|
+
}
|
|
274
|
+
})();
|
|
275
|
+
const finalSchema = isPlainObject(schemaOrRefObject) ? Object.assign({ components: store === null || store === void 0 ? void 0 : store.parsed.components }, "$ref" in schemaOrRefObject ? store === null || store === void 0 ? void 0 : store.parser.$refs.get(schemaOrRefObject.$ref) : schemaOrRefObject) : void 0;
|
|
276
|
+
let code = "";
|
|
277
|
+
if (finalSchema) try {
|
|
278
|
+
code = await compile(finalSchema, "Req", {
|
|
279
|
+
bannerComment: "",
|
|
280
|
+
ignoreMinAndMaxItems: true,
|
|
281
|
+
additionalProperties: false,
|
|
282
|
+
unknownAny: false
|
|
283
|
+
});
|
|
284
|
+
} catch (e) {
|
|
285
|
+
log.error("生成请求参数类型失败，请检查 %o", {
|
|
286
|
+
summary: operationObject.summary,
|
|
287
|
+
message: e.message,
|
|
288
|
+
operationId: operationObject.operationId
|
|
289
|
+
});
|
|
290
|
+
}
|
|
291
|
+
return { code: code || "export type Req = any;" };
|
|
292
|
+
}
|
|
293
|
+
async function compileResponseParams(operationObject, apiConfig) {
|
|
294
|
+
const store = asyncLocalStorage.getStore();
|
|
295
|
+
function resolveSchema(arg) {
|
|
296
|
+
if (!arg) return;
|
|
297
|
+
if ("content" in arg) {
|
|
298
|
+
var _arg$content, _arg$content2;
|
|
299
|
+
const temp = ((_arg$content = arg.content) === null || _arg$content === void 0 ? void 0 : _arg$content["application/json"]) || ((_arg$content2 = arg.content) === null || _arg$content2 === void 0 ? void 0 : _arg$content2["*/*"]);
|
|
300
|
+
return resolveSchema(temp === null || temp === void 0 ? void 0 : temp.schema);
|
|
301
|
+
}
|
|
302
|
+
let schema = apiConfig.responseSchemaTransformer(arg);
|
|
303
|
+
if ("$ref" in schema) return resolveSchema(store === null || store === void 0 ? void 0 : store.parser.$refs.get(schema.$ref));
|
|
304
|
+
return schema;
|
|
305
|
+
}
|
|
306
|
+
const schemaObject = resolveSchema(operationObject.responses["200"]);
|
|
307
|
+
const finalSchema = schemaObject ? Object.assign({ components: store === null || store === void 0 ? void 0 : store.parsed.components }, schemaObject) : void 0;
|
|
308
|
+
let code = "";
|
|
309
|
+
if (finalSchema) try {
|
|
310
|
+
code = await compile(finalSchema, "Res", {
|
|
311
|
+
bannerComment: "",
|
|
312
|
+
ignoreMinAndMaxItems: true,
|
|
313
|
+
additionalProperties: false,
|
|
314
|
+
unknownAny: false
|
|
315
|
+
});
|
|
316
|
+
} catch (e) {
|
|
317
|
+
log.error("转换响应参数类型失败，请检查 %o", {
|
|
318
|
+
summary: operationObject.summary,
|
|
319
|
+
error: e.message,
|
|
320
|
+
operationId: operationObject.operationId
|
|
321
|
+
});
|
|
322
|
+
}
|
|
323
|
+
else log.error("responseSchemaTransformer 返回值为空，请检查");
|
|
324
|
+
return code ? code : "export type Res = any;";
|
|
325
|
+
}
|
|
326
|
+
|
|
327
|
+
//#endregion
|
|
328
|
+
export { generateApi };
|
|
329
|
+
//# sourceMappingURL=generateApi-BMRAxjkM.mjs.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"generateApi-BMRAxjkM.mjs","names":[],"sources":["../src/shared/promptConfigEnable.ts","../src/commands/generateApi/index.ts"],"sourcesContent":["import enquirer from \"enquirer\";\nimport { ApiConfig } from \"./config\";\nconst { prompt } = enquirer;\n\ninterface Opt<T> {\n configArr: (T & { enabled?: boolean })[];\n getChoiceItem: (item: T) => {\n name: string;\n message?: string;\n value?: string;\n hint?: string;\n };\n checkIsEnabled: (enabledArr: string[], item: T) => boolean;\n}\n\nexport async function promptConfigEnable<T>(opt: Opt<T>) {\n const { configArr, getChoiceItem } = opt;\n // 只有一条配置的时候不用选择\n if (configArr.length <= 1) {\n return configArr;\n }\n\n const choices = [\n {\n name: \"全部\",\n message: \"全部\",\n choices: configArr.map((item) => {\n return getChoiceItem(item);\n }),\n },\n ];\n const res = await prompt<{ enabled: string[] }>({\n type: \"multiselect\",\n message: \"选择要生效的配置项\",\n // @ts-ignore\n hint: \"(空格选中，回车确认)\",\n name: \"enabled\",\n validate(value) {\n return value.length === 0 ? `至少选择一项` : true;\n },\n choices,\n });\n\n configArr.forEach((item) => {\n item.enabled = opt.checkIsEnabled(res.enabled, item);\n });\n\n return configArr.filter((c) => c.enabled);\n}\n\nexport function promptApiConfigEnable(configArr: ApiConfig[] | undefined) {\n return promptConfigEnable({\n configArr: configArr ?? [],\n getChoiceItem: (item) => {\n return {\n name: item.output!,\n hint: `swaggerJSONPath: ${item.swaggerJSONPath}`,\n };\n },\n checkIsEnabled: (enabledArr, item) => {\n return enabledArr.includes(item.output!);\n },\n });\n}\n","import SwaggerParser from \"@apidevtools/swagger-parser\";\nimport { camelCase, isPlainObject, merge } from \"es-toolkit\";\nimport { compile } from \"json-schema-to-typescript\";\nimport { AsyncLocalStorage } from \"node:async_hooks\";\nimport fs from \"node:fs/promises\";\nimport { OpenAPIV3 } from \"openapi-types\";\nimport * as os from \"os\";\nimport pMap from \"p-map\";\nimport path from \"path\";\nimport { createLogger } from \"../../shared\";\nimport { ApiConfig, getConfig } from \"../../shared/config\";\nimport { promptApiConfigEnable } from \"../../shared/promptConfigEnable\";\n\nconst log = createLogger(\"generateApi\");\n\nexport const asyncLocalStorage = new AsyncLocalStorage<{\n parsed: OpenAPIV3.Document;\n parser: SwaggerParser;\n}>();\n\nexport async function generateApi() {\n const config = await getConfig();\n const selectedConfigs = await promptApiConfigEnable(config.api);\n const apiConfigs = selectedConfigs.filter((apiConfig) => {\n if (!apiConfig.output) {\n log.error(\"配置 %s 缺少 output，已跳过\", apiConfig.swaggerJSONPath);\n return false;\n }\n return true;\n });\n const skippedConfigCount = selectedConfigs.length - apiConfigs.length;\n\n if (skippedConfigCount > 0) {\n log.info(\"由于缺少 output，跳过 %d 个配置\", skippedConfigCount);\n }\n\n if (!apiConfigs.length) {\n log.info(\"没有需要生成的 API 配置，生成流程结束\");\n return;\n }\n\n log.info(\"本次将生成 %d 个 API 配置\", apiConfigs.length);\n\n let totalSuccessCount = 0;\n let totalFailedCount = 0;\n const startedAt = Date.now();\n\n const preparedConfigs: ApiConfig[] = [];\n\n for (const apiConfig of apiConfigs) {\n log.info(\"开始初始化输出目录 %s\", apiConfig.output);\n const prepareStartedAt = Date.now();\n try {\n await fs.rm(apiConfig.output!, { recursive: true, force: true });\n await fs.mkdir(apiConfig.output!, { recursive: true });\n preparedConfigs.push(apiConfig);\n log.info(\n \"输出目录 %s 初始化完成，耗时 %dms\",\n apiConfig.output,\n Date.now() - prepareStartedAt,\n );\n } catch (error) {\n totalFailedCount++;\n const message = error instanceof Error ? error.message : String(error);\n log.error(\"初始化输出目录 %s 失败：%s\", apiConfig.output, message);\n }\n }\n\n if (!preparedConfigs.length) {\n log.error(\"所有配置都初始化失败，生成流程结束\");\n log.info(\n \"generateApi Done，成功 %d 个，失败 %d 个，总耗时 %dms\",\n totalSuccessCount,\n totalFailedCount,\n Date.now() - startedAt,\n );\n return;\n }\n\n for (const apiConfig of preparedConfigs) {\n log.info(\"开始解析 %s\", apiConfig.swaggerJSONPath);\n const dereferenceConfig = merge(\n {\n resolve: {\n http: {\n timeout: 30 * 1000,\n },\n },\n },\n apiConfig.dereferenceSwaggerConfig || {},\n );\n const parser = new SwaggerParser();\n const bundleStartedAt = Date.now();\n\n let parsed: unknown;\n try {\n parsed = await parser.bundle(\n apiConfig.swaggerJSONPath,\n dereferenceConfig,\n );\n log.info(\n \"解析 %s 成功，耗时 %dms\",\n apiConfig.swaggerJSONPath,\n Date.now() - bundleStartedAt,\n );\n } catch (error) {\n totalFailedCount++;\n const message = error instanceof Error ? error.message : String(error);\n log.error(\"解析 %s 失败：%s\", apiConfig.swaggerJSONPath, message);\n continue;\n }\n\n const state = {\n // only support v3\n parsed: parsed as OpenAPIV3.Document,\n parser,\n };\n\n let generatedCount = 0;\n let skippedCount = 0;\n const pathEntries = Object.entries(\n (parsed as OpenAPIV3.Document).paths ?? {},\n );\n if (!pathEntries.length) {\n log.error(\"%s 中没有可用的 paths，已跳过\", apiConfig.swaggerJSONPath);\n totalFailedCount++;\n continue;\n }\n\n await asyncLocalStorage.run(state, async () => {\n await pMap(pathEntries, async ([url, pathItemObject]) => {\n if (!pathItemObject) {\n log.error(\"路径 %s 未定义 pathItemObject，已跳过\", url);\n skippedCount++;\n return;\n }\n\n log.info(\"开始生成 %s\", url);\n let generatedForUrl = 0;\n await pMap(\n [\"get\", \"put\", \"post\", \"delete\", \"patch\"],\n async (method) => {\n const operationObject = pathItemObject[method];\n if (!operationObject) {\n return;\n }\n\n try {\n const code = await generateApiRequestCode({\n url: url,\n method: method,\n operationObject: operationObject,\n apiConfig,\n });\n const outputPath = path\n .join(\n apiConfig.output!,\n url,\n apiConfig.enableTs ? `${method}.ts` : `${method}.js`,\n )\n .replace(/:/g, \"_\");\n await fs.mkdir(path.dirname(outputPath), {\n recursive: true,\n });\n await fs.writeFile(outputPath, code);\n generatedCount++;\n generatedForUrl++;\n } catch (error) {\n skippedCount++;\n const message =\n error instanceof Error ? error.message : String(error);\n log.error(\n \"%s %s 生成失败：%s\",\n method.toUpperCase(),\n url,\n message,\n );\n }\n },\n );\n if (generatedForUrl === 0) {\n log.info(\"路径 %s 未生成任何方法\", url);\n }\n });\n });\n\n if (!generatedCount) {\n log.error(\"%s 未生成任何请求，已标记失败\", apiConfig.swaggerJSONPath);\n totalFailedCount++;\n continue;\n }\n\n if (apiConfig.codeFormatterCmd) {\n const { exec } = await import(\"child_process\");\n await new Promise<void>((resolve) => {\n exec(\n `${apiConfig.codeFormatterCmd} \"${apiConfig.output!}\"`,\n (error) => {\n if (error) {\n skippedCount++;\n log.error(`Code formatting failed: ${error.message}`);\n } else {\n log.info(`Code formatting success`);\n }\n resolve();\n },\n );\n });\n }\n\n log.info(\n \"%s 生成完成，共生成 %d 个请求，跳过 %d 个\",\n apiConfig.swaggerJSONPath,\n generatedCount,\n skippedCount,\n );\n totalSuccessCount++;\n }\n\n log.info(\n \"generateApi Done，成功 %d 个，失败 %d 个，总耗时 %dms\",\n totalSuccessCount,\n totalFailedCount,\n Date.now() - startedAt,\n );\n}\n\n/**\n * 根据请求方法，生成请求代码\n */\nexport async function generateApiRequestCode(options: {\n url: string;\n method: string;\n operationObject: OpenAPIV3.OperationObject;\n apiConfig: ApiConfig;\n}): Promise<string> {\n const { method, operationObject, apiConfig } = options;\n\n const url = (() => {\n if (typeof apiConfig.urlTransformer === \"string\") {\n return `${apiConfig.urlTransformer}${options.url}`;\n }\n if (typeof apiConfig.urlTransformer === \"function\") {\n return apiConfig.urlTransformer(options.url);\n }\n return options.url;\n })();\n\n const seeUrl = apiConfig.swaggerUiUrl\n ? `${apiConfig.swaggerUiUrl}#/${encodeURIComponent(\n `${operationObject.tags?.join(\"/\") ?? \"\"}/${\n operationObject.operationId\n }`,\n )}`\n : \"\";\n\n // 生成的请求构造器的名称，需要使用原始 url\n let requestBuilderName = camelCase(`${options.url}_${method}_api`);\n\n // 判断是否有效的 js 变量\n if (!/^[a-zA-Z_$][0-9a-zA-Z_$]*$/.test(requestBuilderName)) {\n // 不是有效的 js 变量，使用 _ + 数字\n requestBuilderName = `_${requestBuilderName}`;\n }\n\n //#region url 上参数 例如 /api/v1/users/{userId}\n const urlPathParams = getUrlPathParams(\n (operationObject.parameters as never) ?? [],\n );\n const urlPathParamsCode = urlPathParams.length\n ? `urlPathParams: ${JSON.stringify(urlPathParams)},`\n : \"\";\n //#endregion\n\n let code: string[] = [\n \"// do not edit this file manually, it will be overwritten by @dune2/cli\",\n apiConfig.RequestBuilderImportPath!,\n apiConfig.queryClientImportPath!,\n\n \"/**\",\n ` * ${operationObject.summary}`,\n ` * @tags ${operationObject.tags?.join(\",\")}`,\n seeUrl && ` * @see ${seeUrl}`,\n ` */`,\n ].filter(Boolean);\n\n // builder 代码\n let builderCode = `\\\nexport const ${requestBuilderName} = new RequestBuilder({\n url: '${url}',\n method: '${method}',\n ${urlPathParamsCode}\n ${apiConfig.queryClientImportPath ? \"queryClient,\" : \"\"}\n});`\n // 移除空行\n .replace(/,\\n\\s*}/, \",\" + os.EOL + \"}\");\n if (apiConfig.enableTs) {\n builderCode = builderCode.replace(\n \"new RequestBuilder(\",\n `new RequestBuilder<${requestBuilderName}.Req, ${requestBuilderName}.Res>(`,\n );\n }\n code.push(builderCode);\n\n if (apiConfig.enableTs) {\n const [requestParamsTypeCode, responseParamsTypeCode] = await Promise.all([\n // 请求参数类型\n compileRequestParams(operationObject),\n // 响应参数类型\n compileResponseParams(operationObject, apiConfig),\n ]);\n\n code.push(`\nexport namespace ${requestBuilderName} {\n ${requestParamsTypeCode.code}\n \n ${responseParamsTypeCode}\n};`);\n }\n\n return code.join(os.EOL);\n}\n\nfunction getUrlPathParams(parameters: OpenAPIV3.ParameterObject[]) {\n return parameters\n .filter((item) => item.in === \"path\")\n .map((item) => item.name);\n}\n\n/**\n * 这个方法还不完善，只能处理简单的请求参数\n */\nasync function compileRequestParams(\n operationObject: OpenAPIV3.OperationObject,\n) {\n const store = asyncLocalStorage.getStore();\n const schemaOrRefObject = (() => {\n if (operationObject.requestBody) {\n if (\"$ref\" in operationObject.requestBody) {\n return operationObject.requestBody;\n }\n return operationObject.requestBody.content[\"application/json\"].schema;\n }\n if (operationObject.parameters) {\n const extraProperties = {};\n const parameters: OpenAPIV3.ParameterObject[] = [];\n (operationObject.parameters as OpenAPIV3.ParameterObject[]).forEach(\n (item) => {\n if (![\"query\", \"path\"].includes(item.in)) {\n return;\n }\n if (\n item.schema &&\n \"type\" in item.schema &&\n item.schema.type === \"object\"\n ) {\n // swagger get 请求上 有些参数是 object 类型 应该拍平\n Object.assign(\n extraProperties,\n (item.schema as OpenAPIV3.SchemaObject).properties || {},\n );\n } else {\n parameters.push(item);\n }\n },\n );\n // 必填参数中忽略 分页相关的参数\n const required = parameters\n .filter(\n (p) =>\n p.required && ![\"pageNum\", \"pageSize\", \"count\"].includes(p.name),\n )\n .map((p) => p.name);\n const properties = Object.fromEntries(\n parameters\n // 后端 swagger 可能出现没有 schema 的情况，这里过滤掉\n .filter((p) => !!p.schema)\n .map((p) => {\n const schema = p.schema;\n return [\n p.name,\n {\n ...schema,\n description: p.description,\n // enum: schema.enum ?? [],\n },\n ];\n }),\n );\n return {\n required,\n type: \"object\",\n properties: { ...properties, ...extraProperties },\n };\n }\n })();\n\n const finalSchema = isPlainObject(schemaOrRefObject)\n ? Object.assign(\n {\n components: store?.parsed.components,\n },\n \"$ref\" in schemaOrRefObject\n ? store?.parser.$refs.get(schemaOrRefObject.$ref)\n : schemaOrRefObject,\n )\n : void 0;\n\n let code = \"\";\n if (finalSchema) {\n try {\n code = await compile(finalSchema as never, \"Req\", {\n bannerComment: \"\",\n ignoreMinAndMaxItems: !!1,\n additionalProperties: false,\n unknownAny: false,\n // format: false,\n });\n } catch (e) {\n log.error(\"生成请求参数类型失败，请检查 %o\", {\n summary: operationObject.summary,\n message: e.message,\n operationId: operationObject.operationId,\n });\n }\n }\n\n return {\n code: code || \"export type Req = any;\",\n };\n}\n\nasync function compileResponseParams(\n operationObject: OpenAPIV3.OperationObject,\n apiConfig: ApiConfig,\n) {\n const store = asyncLocalStorage.getStore();\n\n function resolveSchema(\n arg:\n | OpenAPIV3.ReferenceObject\n | OpenAPIV3.ResponseObject\n | OpenAPIV3.MediaTypeObject\n | undefined,\n ) {\n if (!arg) return;\n\n if (\"content\" in arg) {\n const temp = arg.content?.[\"application/json\"] || arg.content?.[\"*/*\"];\n return resolveSchema(temp?.schema);\n }\n\n let schema = apiConfig.responseSchemaTransformer!(arg as never) as\n | OpenAPIV3.ReferenceObject\n | OpenAPIV3.SchemaObject;\n if (\"$ref\" in schema) {\n return resolveSchema(store?.parser.$refs.get(schema.$ref) as never);\n }\n return schema;\n }\n const schemaObject = resolveSchema(operationObject.responses[\"200\"]);\n const finalSchema = schemaObject\n ? Object.assign(\n {\n components: store?.parsed.components,\n },\n schemaObject,\n )\n : void 0;\n\n let code = \"\";\n if (finalSchema) {\n try {\n code = await compile(finalSchema, \"Res\", {\n bannerComment: \"\",\n ignoreMinAndMaxItems: !!1,\n additionalProperties: false,\n unknownAny: false,\n // format: false,\n });\n } catch (e) {\n log.error(\"转换响应参数类型失败，请检查 %o\", {\n summary: operationObject.summary,\n error: e.message,\n operationId: operationObject.operationId,\n });\n }\n } else {\n log.error(\"responseSchemaTransformer 返回值为空，请检查\");\n }\n\n return code ? code : \"export type Res = any;\";\n}\n"],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -1,272 +0,0 @@
|
|
|
1
|
-
import { r as getConfig } from "./config-CxSOgXuG.mjs";
|
|
2
|
-
import { n as createLogger } from "./cli.mjs";
|
|
3
|
-
import path from "path";
|
|
4
|
-
import SwaggerParser from "@apidevtools/swagger-parser";
|
|
5
|
-
import { camelCase, isPlainObject, merge } from "es-toolkit";
|
|
6
|
-
import { compile } from "json-schema-to-typescript";
|
|
7
|
-
import { AsyncLocalStorage } from "node:async_hooks";
|
|
8
|
-
import fs from "node:fs/promises";
|
|
9
|
-
import * as os from "os";
|
|
10
|
-
import pMap from "p-map";
|
|
11
|
-
import enquirer from "enquirer";
|
|
12
|
-
|
|
13
|
-
//#region src/shared/promptConfigEnable.ts
|
|
14
|
-
const { prompt } = enquirer;
|
|
15
|
-
async function promptConfigEnable(opt) {
|
|
16
|
-
const { configArr, getChoiceItem } = opt;
|
|
17
|
-
if (configArr.length <= 1) return configArr;
|
|
18
|
-
const res = await prompt({
|
|
19
|
-
type: "multiselect",
|
|
20
|
-
message: "选择要生效的配置项",
|
|
21
|
-
hint: "(空格选中，回车确认)",
|
|
22
|
-
name: "enabled",
|
|
23
|
-
validate(value) {
|
|
24
|
-
return value.length === 0 ? `至少选择一项` : true;
|
|
25
|
-
},
|
|
26
|
-
choices: [{
|
|
27
|
-
name: "全部",
|
|
28
|
-
message: "全部",
|
|
29
|
-
choices: configArr.map((item) => {
|
|
30
|
-
return getChoiceItem(item);
|
|
31
|
-
})
|
|
32
|
-
}]
|
|
33
|
-
});
|
|
34
|
-
configArr.forEach((item) => {
|
|
35
|
-
item.enabled = opt.checkIsEnabled(res.enabled, item);
|
|
36
|
-
});
|
|
37
|
-
return configArr.filter((c) => c.enabled);
|
|
38
|
-
}
|
|
39
|
-
function promptApiConfigEnable(configArr) {
|
|
40
|
-
return promptConfigEnable({
|
|
41
|
-
configArr: configArr ?? [],
|
|
42
|
-
getChoiceItem: (item) => {
|
|
43
|
-
return {
|
|
44
|
-
name: item.output,
|
|
45
|
-
hint: `swaggerJSONPath: ${item.swaggerJSONPath}`
|
|
46
|
-
};
|
|
47
|
-
},
|
|
48
|
-
checkIsEnabled: (enabledArr, item) => {
|
|
49
|
-
return enabledArr.includes(item.output);
|
|
50
|
-
}
|
|
51
|
-
});
|
|
52
|
-
}
|
|
53
|
-
|
|
54
|
-
//#endregion
|
|
55
|
-
//#region src/commands/generateApi/index.ts
|
|
56
|
-
const log = createLogger("generateApi");
|
|
57
|
-
const asyncLocalStorage = new AsyncLocalStorage();
|
|
58
|
-
function isV3(doc) {
|
|
59
|
-
if (doc) return "components" in doc;
|
|
60
|
-
return false;
|
|
61
|
-
}
|
|
62
|
-
async function generateApi() {
|
|
63
|
-
const apiConfigs = await promptApiConfigEnable((await getConfig()).api);
|
|
64
|
-
for (const apiConfig of apiConfigs) {
|
|
65
|
-
log.info(`清除旧的 api 文件：${apiConfig.output}`);
|
|
66
|
-
await fs.rm(apiConfig.output, {
|
|
67
|
-
recursive: true,
|
|
68
|
-
force: true
|
|
69
|
-
});
|
|
70
|
-
await fs.mkdir(apiConfig.output, { recursive: true });
|
|
71
|
-
}
|
|
72
|
-
for (const apiConfig of apiConfigs) {
|
|
73
|
-
log.info("开始解析 %s", apiConfig.swaggerJSONPath);
|
|
74
|
-
const dereferenceConfig = merge({ resolve: { http: { timeout: 30 * 1e3 } } }, apiConfig.dereferenceSwaggerConfig || {});
|
|
75
|
-
const parser = new SwaggerParser();
|
|
76
|
-
const parsed = await parser.bundle(apiConfig.swaggerJSONPath, dereferenceConfig);
|
|
77
|
-
asyncLocalStorage.run({
|
|
78
|
-
parsed,
|
|
79
|
-
parser
|
|
80
|
-
}, async () => {
|
|
81
|
-
await pMap(Object.entries(parsed.paths), async ([url, pathItemObject]) => {
|
|
82
|
-
log.info("开始生成 %s", url);
|
|
83
|
-
if (pathItemObject) await pMap([
|
|
84
|
-
"get",
|
|
85
|
-
"put",
|
|
86
|
-
"post",
|
|
87
|
-
"delete",
|
|
88
|
-
"patch"
|
|
89
|
-
], async (method) => {
|
|
90
|
-
const operationObject = pathItemObject[method];
|
|
91
|
-
if (operationObject) {
|
|
92
|
-
const code = await generateApiRequestCode({
|
|
93
|
-
url,
|
|
94
|
-
method,
|
|
95
|
-
operationObject,
|
|
96
|
-
apiConfig
|
|
97
|
-
});
|
|
98
|
-
const outputPath = path.join(apiConfig.output, url, apiConfig.enableTs ? `${method}.ts` : `${method}.js`).replace(/:/g, "_");
|
|
99
|
-
await fs.mkdir(path.dirname(outputPath), { recursive: true });
|
|
100
|
-
await fs.writeFile(outputPath, code);
|
|
101
|
-
}
|
|
102
|
-
});
|
|
103
|
-
});
|
|
104
|
-
});
|
|
105
|
-
if (apiConfig.codeFormatterCmd) {
|
|
106
|
-
const { exec } = await import("child_process");
|
|
107
|
-
await new Promise((resolve, reject) => {
|
|
108
|
-
exec(`${apiConfig.codeFormatterCmd} ${apiConfig.output}/**`, (error) => {
|
|
109
|
-
if (error) console.warn(`Code formatting failed: ${error.message}`);
|
|
110
|
-
resolve();
|
|
111
|
-
});
|
|
112
|
-
});
|
|
113
|
-
}
|
|
114
|
-
}
|
|
115
|
-
log.info("generateApi Done");
|
|
116
|
-
}
|
|
117
|
-
/**
|
|
118
|
-
* 根据请求方法，生成请求代码
|
|
119
|
-
*/
|
|
120
|
-
async function generateApiRequestCode(options) {
|
|
121
|
-
var _operationObject$tags, _operationObject$tags2;
|
|
122
|
-
const { method, operationObject, apiConfig } = options;
|
|
123
|
-
const url = (() => {
|
|
124
|
-
if (typeof apiConfig.urlTransformer === "string") return `${apiConfig.urlTransformer}${options.url}`;
|
|
125
|
-
if (typeof apiConfig.urlTransformer === "function") return apiConfig.urlTransformer(options.url);
|
|
126
|
-
return options.url;
|
|
127
|
-
})();
|
|
128
|
-
const seeUrl = apiConfig.swaggerUiUrl ? `${apiConfig.swaggerUiUrl}#/${encodeURIComponent(`${((_operationObject$tags = operationObject.tags) === null || _operationObject$tags === void 0 ? void 0 : _operationObject$tags.join("/")) ?? ""}/${operationObject.operationId}`)}` : "";
|
|
129
|
-
let requestBuilderName = camelCase(`${options.url}_${method}_api`);
|
|
130
|
-
if (!/^[a-zA-Z_$][0-9a-zA-Z_$]*$/.test(requestBuilderName)) requestBuilderName = `_${requestBuilderName}`;
|
|
131
|
-
const urlPathParams = getUrlPathParams(operationObject.parameters ?? []);
|
|
132
|
-
const urlPathParamsCode = urlPathParams.length ? `urlPathParams: ${JSON.stringify(urlPathParams)},` : "";
|
|
133
|
-
let code = [
|
|
134
|
-
"// do not edit this file manually, it will be overwritten by @dune2/cli",
|
|
135
|
-
apiConfig.RequestBuilderImportPath,
|
|
136
|
-
apiConfig.queryClientImportPath,
|
|
137
|
-
"/**",
|
|
138
|
-
` * ${operationObject.summary}`,
|
|
139
|
-
` * @tags ${(_operationObject$tags2 = operationObject.tags) === null || _operationObject$tags2 === void 0 ? void 0 : _operationObject$tags2.join(",")}`,
|
|
140
|
-
seeUrl && ` * @see ${seeUrl}`,
|
|
141
|
-
` */`
|
|
142
|
-
].filter(Boolean);
|
|
143
|
-
let builderCode = `\
|
|
144
|
-
export const ${requestBuilderName} = new RequestBuilder({
|
|
145
|
-
url: '${url}',
|
|
146
|
-
method: '${method}',
|
|
147
|
-
${urlPathParamsCode}
|
|
148
|
-
${apiConfig.queryClientImportPath ? "queryClient," : ""}
|
|
149
|
-
});`.replace(/,\n\s*}/, "," + os.EOL + "}");
|
|
150
|
-
if (apiConfig.enableTs) builderCode = builderCode.replace("new RequestBuilder(", `new RequestBuilder<${requestBuilderName}.Req, ${requestBuilderName}.Res>(`);
|
|
151
|
-
code.push(builderCode);
|
|
152
|
-
if (apiConfig.enableTs) {
|
|
153
|
-
const [requestParamsTypeCode, responseParamsTypeCode] = await Promise.all([compileRequestParams(operationObject), compileResponseParams(operationObject, apiConfig)]);
|
|
154
|
-
code.push(`
|
|
155
|
-
export namespace ${requestBuilderName} {
|
|
156
|
-
${requestParamsTypeCode.code}
|
|
157
|
-
|
|
158
|
-
${responseParamsTypeCode}
|
|
159
|
-
};`);
|
|
160
|
-
}
|
|
161
|
-
return code.join(os.EOL);
|
|
162
|
-
}
|
|
163
|
-
function getUrlPathParams(parameters) {
|
|
164
|
-
return parameters.filter((item) => item.in === "path").map((item) => item.name);
|
|
165
|
-
}
|
|
166
|
-
/**
|
|
167
|
-
* 这个方法还不完善，只能处理简单的请求参数
|
|
168
|
-
*/
|
|
169
|
-
async function compileRequestParams(operationObject) {
|
|
170
|
-
let schema;
|
|
171
|
-
if (operationObject.requestBody) schema = operationObject.requestBody.content["application/json"].schema;
|
|
172
|
-
else if (operationObject.parameters) {
|
|
173
|
-
const extraProperties = {};
|
|
174
|
-
const parameters = [];
|
|
175
|
-
operationObject.parameters.forEach((item) => {
|
|
176
|
-
if (!["query", "path"].includes(item.in)) return;
|
|
177
|
-
if (item.schema && "type" in item.schema && item.schema.type === "object") Object.assign(extraProperties, item.schema.properties || {});
|
|
178
|
-
else parameters.push(item);
|
|
179
|
-
});
|
|
180
|
-
schema = {
|
|
181
|
-
required: parameters.filter((p) => p.required && ![
|
|
182
|
-
"pageNum",
|
|
183
|
-
"pageSize",
|
|
184
|
-
"count"
|
|
185
|
-
].includes(p.name)).map((p) => p.name),
|
|
186
|
-
type: "object",
|
|
187
|
-
properties: {
|
|
188
|
-
...Object.fromEntries(parameters.filter((p) => !!p.schema).map((p) => {
|
|
189
|
-
const schema$1 = p.schema;
|
|
190
|
-
return [p.name, {
|
|
191
|
-
...schema$1,
|
|
192
|
-
description: p.description
|
|
193
|
-
}];
|
|
194
|
-
})),
|
|
195
|
-
...extraProperties
|
|
196
|
-
}
|
|
197
|
-
};
|
|
198
|
-
}
|
|
199
|
-
let code = "";
|
|
200
|
-
if (schema) {
|
|
201
|
-
const store = asyncLocalStorage.getStore();
|
|
202
|
-
if ((store === null || store === void 0 ? void 0 : store.parser) && schema.$ref) schema = store === null || store === void 0 ? void 0 : store.parser.$refs.get(schema.$ref);
|
|
203
|
-
if (isV3(store === null || store === void 0 ? void 0 : store.parsed)) schema.components = store === null || store === void 0 ? void 0 : store.parsed.components;
|
|
204
|
-
try {
|
|
205
|
-
code = await compile(schema, "Req", {
|
|
206
|
-
bannerComment: "",
|
|
207
|
-
ignoreMinAndMaxItems: true,
|
|
208
|
-
additionalProperties: false,
|
|
209
|
-
unknownAny: false
|
|
210
|
-
});
|
|
211
|
-
} catch (e) {
|
|
212
|
-
log.error("生成请求参数类型失败，请检查 %o", {
|
|
213
|
-
summary: operationObject.summary,
|
|
214
|
-
message: e.message,
|
|
215
|
-
operationId: operationObject.operationId
|
|
216
|
-
});
|
|
217
|
-
}
|
|
218
|
-
}
|
|
219
|
-
return { code: code || "export type Req = any;" };
|
|
220
|
-
}
|
|
221
|
-
async function compileResponseParams(operationObject, apiConfig) {
|
|
222
|
-
const temp = operationObject.responses["200"];
|
|
223
|
-
let code = "";
|
|
224
|
-
if (temp === null || temp === void 0 ? void 0 : temp.content) {
|
|
225
|
-
const temp2 = temp.content["application/json"] || temp.content["*/*"];
|
|
226
|
-
let schema = apiConfig.responseSchemaTransformer(temp2.schema);
|
|
227
|
-
if (schema) {
|
|
228
|
-
const store = asyncLocalStorage.getStore();
|
|
229
|
-
const schema2 = (() => {
|
|
230
|
-
if ("$ref" in schema && (store === null || store === void 0 ? void 0 : store.parser) && isV3(store.parsed)) {
|
|
231
|
-
let r = store === null || store === void 0 ? void 0 : store.parser.$refs.get(schema.$ref);
|
|
232
|
-
r = apiConfig.responseSchemaTransformer(r);
|
|
233
|
-
if (isPlainObject(r)) {
|
|
234
|
-
if ("$ref" in r) r = store === null || store === void 0 ? void 0 : store.parser.$refs.get(r.$ref);
|
|
235
|
-
if (isPlainObject(r)) return {
|
|
236
|
-
...r,
|
|
237
|
-
components: store === null || store === void 0 ? void 0 : store.parsed.components
|
|
238
|
-
};
|
|
239
|
-
}
|
|
240
|
-
log.error(`unknown other types`);
|
|
241
|
-
return;
|
|
242
|
-
}
|
|
243
|
-
return schema;
|
|
244
|
-
})();
|
|
245
|
-
if (!schema2) log.error(`can not found schema to generate response code`);
|
|
246
|
-
try {
|
|
247
|
-
code = await compile(schema2, "Res", {
|
|
248
|
-
bannerComment: "",
|
|
249
|
-
ignoreMinAndMaxItems: true,
|
|
250
|
-
additionalProperties: false,
|
|
251
|
-
unknownAny: false
|
|
252
|
-
});
|
|
253
|
-
const isPageSearchResponse = (data) => {
|
|
254
|
-
var _data$properties;
|
|
255
|
-
return data.type === "object" && ((_data$properties = data.properties) === null || _data$properties === void 0 || (_data$properties = _data$properties.result) === null || _data$properties === void 0 ? void 0 : _data$properties.type) === "array";
|
|
256
|
-
};
|
|
257
|
-
if (isPageSearchResponse(schema)) code += `${os.EOL}export type ResultItem = Res['result'][0]`;
|
|
258
|
-
} catch (e) {
|
|
259
|
-
log.error("转换响应参数类型失败，请检查 %o", {
|
|
260
|
-
summary: operationObject.summary,
|
|
261
|
-
error: e.message,
|
|
262
|
-
operationId: operationObject.operationId
|
|
263
|
-
});
|
|
264
|
-
}
|
|
265
|
-
} else log.error("responseSchemaTransformer 返回值为空，请检查");
|
|
266
|
-
}
|
|
267
|
-
return code ? code : "export type Res = any;";
|
|
268
|
-
}
|
|
269
|
-
|
|
270
|
-
//#endregion
|
|
271
|
-
export { generateApi };
|
|
272
|
-
//# sourceMappingURL=generateApi-NvvdY6gQ.mjs.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"generateApi-NvvdY6gQ.mjs","names":["schema"],"sources":["../src/shared/promptConfigEnable.ts","../src/commands/generateApi/index.ts"],"sourcesContent":["import enquirer from \"enquirer\";\nimport { ApiConfig } from \"./config\";\nconst { prompt } = enquirer;\n\ninterface Opt<T> {\n configArr: (T & { enabled?: boolean })[];\n getChoiceItem: (item: T) => {\n name: string;\n message?: string;\n value?: string;\n hint?: string;\n };\n checkIsEnabled: (enabledArr: string[], item: T) => boolean;\n}\n\nexport async function promptConfigEnable<T>(opt: Opt<T>) {\n const { configArr, getChoiceItem } = opt;\n // 只有一条配置的时候不用选择\n if (configArr.length <= 1) {\n return configArr;\n }\n\n const choices = [\n {\n name: \"全部\",\n message: \"全部\",\n choices: configArr.map((item) => {\n return getChoiceItem(item);\n }),\n },\n ];\n const res = await prompt<{ enabled: string[] }>({\n type: \"multiselect\",\n message: \"选择要生效的配置项\",\n // @ts-ignore\n hint: \"(空格选中，回车确认)\",\n name: \"enabled\",\n validate(value) {\n return value.length === 0 ? `至少选择一项` : true;\n },\n choices,\n });\n\n configArr.forEach((item) => {\n item.enabled = opt.checkIsEnabled(res.enabled, item);\n });\n\n return configArr.filter((c) => c.enabled);\n}\n\nexport function promptApiConfigEnable(configArr: ApiConfig[] | undefined) {\n return promptConfigEnable({\n configArr: configArr ?? [],\n getChoiceItem: (item) => {\n return {\n name: item.output!,\n hint: `swaggerJSONPath: ${item.swaggerJSONPath}`,\n };\n },\n checkIsEnabled: (enabledArr, item) => {\n return enabledArr.includes(item.output!);\n },\n });\n}\n","import SwaggerParser from \"@apidevtools/swagger-parser\";\nimport { camelCase, isPlainObject, merge } from \"es-toolkit\";\nimport { compile } from \"json-schema-to-typescript\";\nimport { AsyncLocalStorage } from \"node:async_hooks\";\nimport fs from \"node:fs/promises\";\nimport { OpenAPIV3, type OpenAPI } from \"openapi-types\";\nimport * as os from \"os\";\nimport pMap from \"p-map\";\nimport path from \"path\";\nimport { createLogger } from \"../../shared\";\nimport { ApiConfig, getConfig } from \"../../shared/config\";\nimport { promptApiConfigEnable } from \"../../shared/promptConfigEnable\";\n\nconst log = createLogger(\"generateApi\");\n\nexport const asyncLocalStorage = new AsyncLocalStorage<{\n parsed: OpenAPI.Document;\n parser: SwaggerParser;\n}>();\n\nfunction isV3(doc: OpenAPI.Document | undefined): doc is OpenAPIV3.Document {\n if (doc) {\n return \"components\" in doc;\n }\n return false;\n}\n\nexport async function generateApi() {\n const config = await getConfig();\n const apiConfigs = await promptApiConfigEnable(config.api);\n\n for (const apiConfig of apiConfigs) {\n log.info(`清除旧的 api 文件：${apiConfig.output}`);\n await fs.rm(apiConfig.output!, { recursive: true, force: true });\n await fs.mkdir(apiConfig.output!, { recursive: true });\n }\n\n for (const apiConfig of apiConfigs) {\n log.info(\"开始解析 %s\", apiConfig.swaggerJSONPath);\n const dereferenceConfig = merge(\n {\n resolve: {\n http: {\n timeout: 30 * 1000,\n },\n },\n },\n apiConfig.dereferenceSwaggerConfig || {},\n );\n const parser = new SwaggerParser();\n\n const parsed = await parser.bundle(\n apiConfig.swaggerJSONPath,\n dereferenceConfig,\n );\n\n asyncLocalStorage.run({ parsed, parser }, async () => {\n await pMap(\n Object.entries(parsed.paths!),\n async ([url, pathItemObject]) => {\n log.info(\"开始生成 %s\", url);\n if (pathItemObject) {\n await pMap(\n [\"get\", \"put\", \"post\", \"delete\", \"patch\"],\n async (method) => {\n const operationObject = pathItemObject[method];\n if (operationObject) {\n const code = await generateApiRequestCode({\n url: url,\n method: method,\n operationObject: operationObject,\n apiConfig,\n });\n const outputPath = path\n .join(\n apiConfig.output!,\n url,\n apiConfig.enableTs ? `${method}.ts` : `${method}.js`,\n )\n .replace(/:/g, \"_\");\n await fs.mkdir(path.dirname(outputPath), { recursive: true });\n await fs.writeFile(outputPath, code);\n }\n },\n );\n }\n },\n );\n });\n if (apiConfig.codeFormatterCmd) {\n const { exec } = await import(\"child_process\");\n await new Promise<void>((resolve, reject) => {\n exec(\n `${apiConfig.codeFormatterCmd} ${apiConfig.output!}/**`,\n (error) => {\n if (error) {\n console.warn(`Code formatting failed: ${error.message}`);\n }\n resolve();\n },\n );\n });\n }\n }\n\n log.info(\"generateApi Done\");\n}\n\n/**\n * 根据请求方法，生成请求代码\n */\nexport async function generateApiRequestCode(options: {\n url: string;\n method: string;\n operationObject: OpenAPIV3.OperationObject;\n apiConfig: ApiConfig;\n}): Promise<string> {\n const { method, operationObject, apiConfig } = options;\n\n const url = (() => {\n if (typeof apiConfig.urlTransformer === \"string\") {\n return `${apiConfig.urlTransformer}${options.url}`;\n }\n if (typeof apiConfig.urlTransformer === \"function\") {\n return apiConfig.urlTransformer(options.url);\n }\n return options.url;\n })();\n\n const seeUrl = apiConfig.swaggerUiUrl\n ? `${apiConfig.swaggerUiUrl}#/${encodeURIComponent(\n `${operationObject.tags?.join(\"/\") ?? \"\"}/${\n operationObject.operationId\n }`,\n )}`\n : \"\";\n\n // 生成的请求构造器的名称，需要使用原始 url\n let requestBuilderName = camelCase(`${options.url}_${method}_api`);\n\n // 判断是否有效的 js 变量\n if (!/^[a-zA-Z_$][0-9a-zA-Z_$]*$/.test(requestBuilderName)) {\n // 不是有效的 js 变量，使用 _ + 数字\n requestBuilderName = `_${requestBuilderName}`;\n }\n\n //#region url 上参数 例如 /api/v1/users/{userId}\n const urlPathParams = getUrlPathParams(\n (operationObject.parameters as never) ?? [],\n );\n const urlPathParamsCode = urlPathParams.length\n ? `urlPathParams: ${JSON.stringify(urlPathParams)},`\n : \"\";\n //#endregion\n\n let code: string[] = [\n \"// do not edit this file manually, it will be overwritten by @dune2/cli\",\n apiConfig.RequestBuilderImportPath!,\n apiConfig.queryClientImportPath!,\n\n \"/**\",\n ` * ${operationObject.summary}`,\n ` * @tags ${operationObject.tags?.join(\",\")}`,\n seeUrl && ` * @see ${seeUrl}`,\n ` */`,\n ].filter(Boolean);\n\n // builder 代码\n let builderCode = `\\\nexport const ${requestBuilderName} = new RequestBuilder({\n url: '${url}',\n method: '${method}',\n ${urlPathParamsCode}\n ${apiConfig.queryClientImportPath ? \"queryClient,\" : \"\"}\n});`\n // 移除空行\n .replace(/,\\n\\s*}/, \",\" + os.EOL + \"}\");\n if (apiConfig.enableTs) {\n builderCode = builderCode.replace(\n \"new RequestBuilder(\",\n `new RequestBuilder<${requestBuilderName}.Req, ${requestBuilderName}.Res>(`,\n );\n }\n code.push(builderCode);\n\n if (apiConfig.enableTs) {\n const [requestParamsTypeCode, responseParamsTypeCode] = await Promise.all([\n // 请求参数类型\n compileRequestParams(operationObject),\n // 响应参数类型\n compileResponseParams(operationObject, apiConfig),\n ]);\n\n code.push(`\nexport namespace ${requestBuilderName} {\n ${requestParamsTypeCode.code}\n \n ${responseParamsTypeCode}\n};`);\n }\n\n return code.join(os.EOL);\n}\n\nfunction getUrlPathParams(parameters: OpenAPIV3.ParameterObject[]) {\n return parameters\n .filter((item) => item.in === \"path\")\n .map((item) => item.name);\n}\n\n/**\n * 这个方法还不完善，只能处理简单的请求参数\n */\nasync function compileRequestParams(\n operationObject: OpenAPIV3.OperationObject,\n) {\n let schema;\n if (operationObject.requestBody) {\n //TODO: 这里也需要处理其他类型\n schema = (operationObject.requestBody as OpenAPIV3.RequestBodyObject)\n .content[\"application/json\"].schema;\n } else if (operationObject.parameters) {\n const extraProperties = {};\n const parameters: OpenAPIV3.ParameterObject[] = [];\n (operationObject.parameters as OpenAPIV3.ParameterObject[]).forEach(\n (item) => {\n if (![\"query\", \"path\"].includes(item.in)) {\n return;\n }\n if (\n item.schema &&\n \"type\" in item.schema &&\n item.schema.type === \"object\"\n ) {\n // swagger get 请求上 有些参数是 object 类型 应该拍平\n Object.assign(\n extraProperties,\n (item.schema as OpenAPIV3.SchemaObject).properties || {},\n );\n } else {\n parameters.push(item);\n }\n },\n );\n\n // 必填参数中忽略 分页相关的参数\n const required = parameters\n .filter(\n (p) => p.required && ![\"pageNum\", \"pageSize\", \"count\"].includes(p.name),\n )\n .map((p) => p.name);\n const properties = Object.fromEntries(\n parameters\n // 后端 swagger 可能出现没有 schema 的情况，这里过滤掉\n .filter((p) => !!p.schema)\n .map((p) => {\n //TODO: 这里也要处理 ref 类型\n const schema = p.schema as OpenAPIV3.SchemaObject;\n return [\n p.name,\n {\n ...schema,\n description: p.description,\n // enum: schema.enum ?? [],\n },\n ];\n }),\n );\n schema = {\n required,\n type: \"object\",\n properties: { ...properties, ...extraProperties },\n };\n }\n\n let code = \"\";\n if (schema) {\n const store = asyncLocalStorage.getStore();\n if (store?.parser && schema.$ref) {\n schema = store?.parser.$refs.get(schema.$ref);\n }\n if (isV3(store?.parsed)) {\n schema.components = store?.parsed.components;\n }\n\n try {\n code = await compile(schema, \"Req\", {\n bannerComment: \"\",\n ignoreMinAndMaxItems: !!1,\n additionalProperties: false,\n unknownAny: false,\n // format: false,\n });\n } catch (e) {\n log.error(\"生成请求参数类型失败，请检查 %o\", {\n summary: operationObject.summary,\n message: e.message,\n operationId: operationObject.operationId,\n });\n }\n }\n\n return {\n code: code || \"export type Req = any;\",\n };\n}\n\nasync function compileResponseParams(\n operationObject: OpenAPIV3.OperationObject,\n apiConfig: ApiConfig,\n) {\n const temp = operationObject.responses[\"200\"] as OpenAPIV3.ResponseObject;\n let code = \"\";\n if (temp?.content) {\n // FIXME: 可能需要处理其他的 content 类型\n const temp2 = temp.content[\"application/json\"] || temp.content[\"*/*\"];\n //let schema = temp2.schema;\n //@ts-expect-error TODO: 待修复类型\n let schema = apiConfig.responseSchemaTransformer!(temp2.schema);\n if (schema) {\n const store = asyncLocalStorage.getStore();\n\n const schema2 = (() => {\n if (\"$ref\" in schema && store?.parser && isV3(store.parsed)) {\n let r = store?.parser.$refs.get(schema.$ref);\n // @ts-expect-error TODO: 待修复类型\n r = apiConfig.responseSchemaTransformer!(r);\n if (isPlainObject(r)) {\n if (\"$ref\" in r) {\n r = store?.parser.$refs.get(r.$ref as string);\n }\n\n if (isPlainObject(r)) {\n return {\n ...r,\n components: store?.parsed.components,\n };\n }\n }\n log.error(`unknown other types`);\n return;\n }\n return schema;\n })();\n\n if (!schema2) {\n log.error(`can not found schema to generate response code`);\n }\n\n try {\n code = await compile(schema2, \"Res\", {\n bannerComment: \"\",\n ignoreMinAndMaxItems: !!1,\n additionalProperties: false,\n unknownAny: false,\n // format: false,\n });\n\n // 通过响应数据判断是否是分页查询接口\n const isPageSearchResponse = (data: any) => {\n // 有 result 字段且为数组，就认为是分页查询接口\n return (\n data.type === \"object\" && data.properties?.result?.type === \"array\"\n );\n };\n\n // 新增后端分页查询返回的数据类型\n if (isPageSearchResponse(schema)) {\n code += `${os.EOL}export type ResultItem = Res['result'][0]`;\n }\n } catch (e) {\n log.error(\"转换响应参数类型失败，请检查 %o\", {\n summary: operationObject.summary,\n error: e.message,\n operationId: operationObject.operationId,\n });\n }\n } else {\n log.error(\"responseSchemaTransformer 返回值为空，请检查\");\n }\n }\n\n return code ? code : \"export type Res = any;\";\n}\n"],"mappings":";;;;;;;;;;;;;AAEA,MAAM,EAAE,WAAW;AAanB,eAAsB,mBAAsB,KAAa;CACvD,MAAM,EAAE,WAAW,kBAAkB;AAErC,KAAI,UAAU,UAAU,EACtB,QAAO;CAYT,MAAM,MAAM,MAAM,OAA8B;EAC9C,MAAM;EACN,SAAS;EAET,MAAM;EACN,MAAM;EACN,SAAS,OAAO;AACd,UAAO,MAAM,WAAW,IAAI,WAAW;;EAEzC,SAlBc,CACd;GACE,MAAM;GACN,SAAS;GACT,SAAS,UAAU,KAAK,SAAS;AAC/B,WAAO,cAAc,KAAK;KAC1B;GACH,CACF;EAWA,CAAC;AAEF,WAAU,SAAS,SAAS;AAC1B,OAAK,UAAU,IAAI,eAAe,IAAI,SAAS,KAAK;GACpD;AAEF,QAAO,UAAU,QAAQ,MAAM,EAAE,QAAQ;;AAG3C,SAAgB,sBAAsB,WAAoC;AACxE,QAAO,mBAAmB;EACxB,WAAW,aAAa,EAAE;EAC1B,gBAAgB,SAAS;AACvB,UAAO;IACL,MAAM,KAAK;IACX,MAAM,oBAAoB,KAAK;IAChC;;EAEH,iBAAiB,YAAY,SAAS;AACpC,UAAO,WAAW,SAAS,KAAK,OAAQ;;EAE3C,CAAC;;;;;ACjDJ,MAAM,MAAM,aAAa,cAAc;AAEvC,MAAa,oBAAoB,IAAI,mBAGjC;AAEJ,SAAS,KAAK,KAA8D;AAC1E,KAAI,IACF,QAAO,gBAAgB;AAEzB,QAAO;;AAGT,eAAsB,cAAc;CAElC,MAAM,aAAa,MAAM,uBADV,MAAM,WAAW,EACsB,IAAI;AAE1D,MAAK,MAAM,aAAa,YAAY;AAClC,MAAI,KAAK,eAAe,UAAU,SAAS;AAC3C,QAAM,GAAG,GAAG,UAAU,QAAS;GAAE,WAAW;GAAM,OAAO;GAAM,CAAC;AAChE,QAAM,GAAG,MAAM,UAAU,QAAS,EAAE,WAAW,MAAM,CAAC;;AAGxD,MAAK,MAAM,aAAa,YAAY;AAClC,MAAI,KAAK,WAAW,UAAU,gBAAgB;EAC9C,MAAM,oBAAoB,MACxB,EACE,SAAS,EACP,MAAM,EACJ,SAAS,KAAK,KACf,EACF,EACF,EACD,UAAU,4BAA4B,EAAE,CACzC;EACD,MAAM,SAAS,IAAI,eAAe;EAElC,MAAM,SAAS,MAAM,OAAO,OAC1B,UAAU,iBACV,kBACD;AAED,oBAAkB,IAAI;GAAE;GAAQ;GAAQ,EAAE,YAAY;AACpD,SAAM,KACJ,OAAO,QAAQ,OAAO,MAAO,EAC7B,OAAO,CAAC,KAAK,oBAAoB;AAC/B,QAAI,KAAK,WAAW,IAAI;AACxB,QAAI,eACF,OAAM,KACJ;KAAC;KAAO;KAAO;KAAQ;KAAU;KAAQ,EACzC,OAAO,WAAW;KAChB,MAAM,kBAAkB,eAAe;AACvC,SAAI,iBAAiB;MACnB,MAAM,OAAO,MAAM,uBAAuB;OACnC;OACG;OACS;OACjB;OACD,CAAC;MACF,MAAM,aAAa,KAChB,KACC,UAAU,QACV,KACA,UAAU,WAAW,GAAG,OAAO,OAAO,GAAG,OAAO,KACjD,CACA,QAAQ,MAAM,IAAI;AACrB,YAAM,GAAG,MAAM,KAAK,QAAQ,WAAW,EAAE,EAAE,WAAW,MAAM,CAAC;AAC7D,YAAM,GAAG,UAAU,YAAY,KAAK;;MAGzC;KAGN;IACD;AACF,MAAI,UAAU,kBAAkB;GAC9B,MAAM,EAAE,SAAS,MAAM,OAAO;AAC9B,SAAM,IAAI,SAAe,SAAS,WAAW;AAC3C,SACE,GAAG,UAAU,iBAAiB,GAAG,UAAU,OAAQ,OAClD,UAAU;AACT,SAAI,MACF,SAAQ,KAAK,2BAA2B,MAAM,UAAU;AAE1D,cAAS;MAEZ;KACD;;;AAIN,KAAI,KAAK,mBAAmB;;;;;AAM9B,eAAsB,uBAAuB,SAKzB;;CAClB,MAAM,EAAE,QAAQ,iBAAiB,cAAc;CAE/C,MAAM,aAAa;AACjB,MAAI,OAAO,UAAU,mBAAmB,SACtC,QAAO,GAAG,UAAU,iBAAiB,QAAQ;AAE/C,MAAI,OAAO,UAAU,mBAAmB,WACtC,QAAO,UAAU,eAAe,QAAQ,IAAI;AAE9C,SAAO,QAAQ;KACb;CAEJ,MAAM,SAAS,UAAU,eACrB,GAAG,UAAU,aAAa,IAAI,mBAC5B,6BAAG,gBAAgB,oFAAM,KAAK,IAAI,KAAI,GAAG,GACvC,gBAAgB,cAEnB,KACD;CAGJ,IAAI,qBAAqB,UAAU,GAAG,QAAQ,IAAI,GAAG,OAAO,MAAM;AAGlE,KAAI,CAAC,6BAA6B,KAAK,mBAAmB,CAExD,sBAAqB,IAAI;CAI3B,MAAM,gBAAgB,iBACnB,gBAAgB,cAAwB,EAAE,CAC5C;CACD,MAAM,oBAAoB,cAAc,SACpC,kBAAkB,KAAK,UAAU,cAAc,CAAC,KAChD;CAGJ,IAAI,OAAiB;EACnB;EACA,UAAU;EACV,UAAU;EAEV;EACA,OAAO,gBAAgB;EACvB,uCAAa,gBAAgB,sFAAM,KAAK,IAAI;EAC5C,UAAU,YAAY;EACtB;EACD,CAAC,OAAO,QAAQ;CAGjB,IAAI,cAAc;eACL,mBAAmB;UACxB,IAAI;aACD,OAAO;IAChB,kBAAkB;IAClB,UAAU,wBAAwB,iBAAiB,GAAG;KAGrD,QAAQ,WAAW,MAAM,GAAG,MAAM,IAAI;AACzC,KAAI,UAAU,SACZ,eAAc,YAAY,QACxB,uBACA,sBAAsB,mBAAmB,QAAQ,mBAAmB,QACrE;AAEH,MAAK,KAAK,YAAY;AAEtB,KAAI,UAAU,UAAU;EACtB,MAAM,CAAC,uBAAuB,0BAA0B,MAAM,QAAQ,IAAI,CAExE,qBAAqB,gBAAgB,EAErC,sBAAsB,iBAAiB,UAAU,CAClD,CAAC;AAEF,OAAK,KAAK;mBACK,mBAAmB;GACnC,sBAAsB,KAAK;;GAE3B,uBAAuB;IACtB;;AAGF,QAAO,KAAK,KAAK,GAAG,IAAI;;AAG1B,SAAS,iBAAiB,YAAyC;AACjE,QAAO,WACJ,QAAQ,SAAS,KAAK,OAAO,OAAO,CACpC,KAAK,SAAS,KAAK,KAAK;;;;;AAM7B,eAAe,qBACb,iBACA;CACA,IAAI;AACJ,KAAI,gBAAgB,YAElB,UAAU,gBAAgB,YACvB,QAAQ,oBAAoB;UACtB,gBAAgB,YAAY;EACrC,MAAM,kBAAkB,EAAE;EAC1B,MAAM,aAA0C,EAAE;AAClD,EAAC,gBAAgB,WAA2C,SACzD,SAAS;AACR,OAAI,CAAC,CAAC,SAAS,OAAO,CAAC,SAAS,KAAK,GAAG,CACtC;AAEF,OACE,KAAK,UACL,UAAU,KAAK,UACf,KAAK,OAAO,SAAS,SAGrB,QAAO,OACL,iBACC,KAAK,OAAkC,cAAc,EAAE,CACzD;OAED,YAAW,KAAK,KAAK;IAG1B;AAyBD,WAAS;GACP,UAvBe,WACd,QACE,MAAM,EAAE,YAAY,CAAC;IAAC;IAAW;IAAY;IAAQ,CAAC,SAAS,EAAE,KAAK,CACxE,CACA,KAAK,MAAM,EAAE,KAAK;GAoBnB,MAAM;GACN,YAAY;IAAE,GApBG,OAAO,YACxB,WAEG,QAAQ,MAAM,CAAC,CAAC,EAAE,OAAO,CACzB,KAAK,MAAM;KAEV,MAAMA,WAAS,EAAE;AACjB,YAAO,CACL,EAAE,MACF;MACE,GAAGA;MACH,aAAa,EAAE;MAEhB,CACF;MACD,CACL;IAI8B,GAAG;IAAiB;GAClD;;CAGH,IAAI,OAAO;AACX,KAAI,QAAQ;EACV,MAAM,QAAQ,kBAAkB,UAAU;AAC1C,qDAAI,MAAO,WAAU,OAAO,KAC1B,wDAAS,MAAO,OAAO,MAAM,IAAI,OAAO,KAAK;AAE/C,MAAI,mDAAK,MAAO,OAAO,CACrB,QAAO,2DAAa,MAAO,OAAO;AAGpC,MAAI;AACF,UAAO,MAAM,QAAQ,QAAQ,OAAO;IAClC,eAAe;IACf,sBAAsB;IACtB,sBAAsB;IACtB,YAAY;IAEb,CAAC;WACK,GAAG;AACV,OAAI,MAAM,qBAAqB;IAC7B,SAAS,gBAAgB;IACzB,SAAS,EAAE;IACX,aAAa,gBAAgB;IAC9B,CAAC;;;AAIN,QAAO,EACL,MAAM,QAAQ,0BACf;;AAGH,eAAe,sBACb,iBACA,WACA;CACA,MAAM,OAAO,gBAAgB,UAAU;CACvC,IAAI,OAAO;AACX,iDAAI,KAAM,SAAS;EAEjB,MAAM,QAAQ,KAAK,QAAQ,uBAAuB,KAAK,QAAQ;EAG/D,IAAI,SAAS,UAAU,0BAA2B,MAAM,OAAO;AAC/D,MAAI,QAAQ;GACV,MAAM,QAAQ,kBAAkB,UAAU;GAE1C,MAAM,iBAAiB;AACrB,QAAI,UAAU,yDAAU,MAAO,WAAU,KAAK,MAAM,OAAO,EAAE;KAC3D,IAAI,kDAAI,MAAO,OAAO,MAAM,IAAI,OAAO,KAAK;AAE5C,SAAI,UAAU,0BAA2B,EAAE;AAC3C,SAAI,cAAc,EAAE,EAAE;AACpB,UAAI,UAAU,EACZ,mDAAI,MAAO,OAAO,MAAM,IAAI,EAAE,KAAe;AAG/C,UAAI,cAAc,EAAE,CAClB,QAAO;OACL,GAAG;OACH,0DAAY,MAAO,OAAO;OAC3B;;AAGL,SAAI,MAAM,sBAAsB;AAChC;;AAEF,WAAO;OACL;AAEJ,OAAI,CAAC,QACH,KAAI,MAAM,iDAAiD;AAG7D,OAAI;AACF,WAAO,MAAM,QAAQ,SAAS,OAAO;KACnC,eAAe;KACf,sBAAsB;KACtB,sBAAsB;KACtB,YAAY;KAEb,CAAC;IAGF,MAAM,wBAAwB,SAAc;;AAE1C,YACE,KAAK,SAAS,iCAAY,KAAK,4FAAY,4EAAQ,UAAS;;AAKhE,QAAI,qBAAqB,OAAO,CAC9B,SAAQ,GAAG,GAAG,IAAI;YAEb,GAAG;AACV,QAAI,MAAM,qBAAqB;KAC7B,SAAS,gBAAgB;KACzB,OAAO,EAAE;KACT,aAAa,gBAAgB;KAC9B,CAAC;;QAGJ,KAAI,MAAM,sCAAsC;;AAIpD,QAAO,OAAO,OAAO"}
|