@aomex/openapi 3.2.2 → 3.2.4
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/CHANGELOG.md +16 -0
- package/dist/index.d.ts +1 -24
- package/dist/index.js +62 -45
- package/dist/index.js.map +1 -1
- package/package.json +6 -6
package/CHANGELOG.md
CHANGED
|
@@ -3,6 +3,22 @@
|
|
|
3
3
|
All notable changes to this project will be documented in this file.
|
|
4
4
|
See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
|
|
5
5
|
|
|
6
|
+
## [3.2.4](https://github.com/aomex/aomex/compare/v3.2.3...v3.2.4) (2024-09-25)
|
|
7
|
+
|
|
8
|
+
**Note:** Version bump only for package @aomex/openapi
|
|
9
|
+
|
|
10
|
+
|
|
11
|
+
|
|
12
|
+
|
|
13
|
+
|
|
14
|
+
## [3.2.3](https://github.com/aomex/aomex/compare/v3.2.2...v3.2.3) (2024-09-25)
|
|
15
|
+
|
|
16
|
+
**Note:** Version bump only for package @aomex/openapi
|
|
17
|
+
|
|
18
|
+
|
|
19
|
+
|
|
20
|
+
|
|
21
|
+
|
|
6
22
|
## [3.2.2](https://github.com/aomex/aomex/compare/v3.2.1...v3.2.2) (2024-09-19)
|
|
7
23
|
|
|
8
24
|
**Note:** Version bump only for package @aomex/openapi
|
package/dist/index.d.ts
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
import { ConsoleMiddleware } from '@aomex/console';
|
|
2
2
|
import { Mode } from 'node:fs';
|
|
3
|
-
import { OpenAPI
|
|
3
|
+
import { OpenAPI } from '@aomex/core';
|
|
4
4
|
import { GlobPathOptions } from '@aomex/internal-file-import';
|
|
5
5
|
|
|
6
6
|
interface GenerateOpenapiOptions {
|
|
@@ -56,29 +56,6 @@ interface OpenapiOptions extends GenerateOpenapiWithSpinnerOptions {
|
|
|
56
56
|
}
|
|
57
57
|
declare const openapi: (options: OpenapiOptions) => ConsoleMiddleware;
|
|
58
58
|
|
|
59
|
-
declare module '@aomex/core' {
|
|
60
|
-
namespace I18n {
|
|
61
|
-
interface Definition {
|
|
62
|
-
openapi: {
|
|
63
|
-
initialize: I18nMessage;
|
|
64
|
-
search_routers_files: I18nMessage;
|
|
65
|
-
parse_routers: I18nMessage;
|
|
66
|
-
add_tag: I18nMessage;
|
|
67
|
-
hand_fix_documentation: I18nMessage;
|
|
68
|
-
optimize_parameter: I18nMessage;
|
|
69
|
-
save_to_file: I18nMessage;
|
|
70
|
-
validate: I18nMessage;
|
|
71
|
-
help_summary: I18nMessage;
|
|
72
|
-
has_error: I18nMessage<{
|
|
73
|
-
error_count: number;
|
|
74
|
-
warning_count: number;
|
|
75
|
-
}>;
|
|
76
|
-
no_error: I18nMessage;
|
|
77
|
-
};
|
|
78
|
-
}
|
|
79
|
-
}
|
|
80
|
-
}
|
|
81
|
-
|
|
82
59
|
declare const initializeDocument: (basic?: GenerateOpenapiOptions["docs"]) => Promise<OpenAPI.Document<{}>>;
|
|
83
60
|
|
|
84
61
|
/**
|
package/dist/index.js
CHANGED
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
// src/openapi.ts
|
|
2
|
-
import {
|
|
2
|
+
import { middleware } from "@aomex/core";
|
|
3
3
|
|
|
4
4
|
// src/lib/generate-document-with-spinner.ts
|
|
5
|
-
import
|
|
5
|
+
import "@aomex/core";
|
|
6
6
|
import { sleep } from "@aomex/internal-tools";
|
|
7
7
|
import { pathToFiles } from "@aomex/internal-file-import";
|
|
8
8
|
import path4 from "node:path";
|
|
@@ -246,30 +246,79 @@ var appendTag = (document, usedTags) => {
|
|
|
246
246
|
|
|
247
247
|
// src/lib/generate-document-with-spinner.ts
|
|
248
248
|
import { terminal } from "@aomex/console";
|
|
249
|
+
|
|
250
|
+
// src/i18n/index.ts
|
|
251
|
+
import { I18n as I18n3 } from "@aomex/core";
|
|
252
|
+
|
|
253
|
+
// src/i18n/locales/zh-cn.ts
|
|
254
|
+
import { I18n } from "@aomex/core";
|
|
255
|
+
var zh = I18n.define({
|
|
256
|
+
initialize: "\u521D\u59CB\u5316\u6587\u6863",
|
|
257
|
+
search_routers_files: "\u641C\u7D22\u8DEF\u7531\u6587\u4EF6",
|
|
258
|
+
parse_routers: "\u89E3\u6790\u8DEF\u7531",
|
|
259
|
+
add_tag: "\u589E\u52A0\u6807\u7B7E",
|
|
260
|
+
hand_fix_documentation: "\u624B\u52A8\u4FEE\u590D\u6587\u6863",
|
|
261
|
+
optimize_parameter: "\u4F18\u5316\u53C2\u6570",
|
|
262
|
+
save_to_file: "\u4FDD\u5B58\u5230\u6587\u4EF6",
|
|
263
|
+
validate: "\u9A8C\u8BC1\u6587\u6863",
|
|
264
|
+
help_summary: "openapi v3 \u6587\u6863\u751F\u6210\u5668",
|
|
265
|
+
has_error: "{{error_count}}\u6761\u62A5\u9519\uFF0C{{warning_count}}\u6761\u8B66\u544A",
|
|
266
|
+
no_error: "\u6CA1\u6709\u62A5\u9519"
|
|
267
|
+
});
|
|
268
|
+
|
|
269
|
+
// src/i18n/locales/en-us.ts
|
|
270
|
+
import { I18n as I18n2 } from "@aomex/core";
|
|
271
|
+
var en = I18n2.satisfies(zh).define({
|
|
272
|
+
initialize: "initialize document",
|
|
273
|
+
search_routers_files: "search web routers files",
|
|
274
|
+
parse_routers: "parse routers",
|
|
275
|
+
add_tag: "append tags",
|
|
276
|
+
hand_fix_documentation: "fix documentation by manual",
|
|
277
|
+
optimize_parameter: "optimize parameters",
|
|
278
|
+
save_to_file: "save to file",
|
|
279
|
+
validate: "validate document",
|
|
280
|
+
help_summary: "openapi v3 documentation generator",
|
|
281
|
+
has_error: "{{error_count}} errors, {{warning_count}} warnings",
|
|
282
|
+
no_error: "No errors"
|
|
283
|
+
});
|
|
284
|
+
|
|
285
|
+
// src/i18n/locales/index.ts
|
|
286
|
+
var locales = {
|
|
287
|
+
zh_CN: zh,
|
|
288
|
+
en_US: en
|
|
289
|
+
};
|
|
290
|
+
|
|
291
|
+
// src/i18n/index.ts
|
|
292
|
+
var i18n = new I18n3({
|
|
293
|
+
resources: locales,
|
|
294
|
+
defaultLanguage: "zh_CN"
|
|
295
|
+
});
|
|
296
|
+
|
|
297
|
+
// src/lib/generate-document-with-spinner.ts
|
|
249
298
|
var generateOpenapiWithSpinner = async (config) => {
|
|
250
299
|
const { error, context } = await terminal.runTasks([
|
|
251
300
|
{
|
|
252
|
-
title: i18n.t("
|
|
301
|
+
title: i18n.t("initialize"),
|
|
253
302
|
task: async (ctx) => {
|
|
254
303
|
ctx.document = await initializeDocument(config.docs);
|
|
255
304
|
}
|
|
256
305
|
},
|
|
257
306
|
{
|
|
258
|
-
title: i18n.t("
|
|
307
|
+
title: i18n.t("search_routers_files"),
|
|
259
308
|
task: async (ctx) => {
|
|
260
309
|
ctx.files = await pathToFiles(config.routers);
|
|
261
310
|
await sleep(500);
|
|
262
311
|
}
|
|
263
312
|
},
|
|
264
313
|
{
|
|
265
|
-
title: i18n.t("
|
|
314
|
+
title: i18n.t("parse_routers"),
|
|
266
315
|
task: async (ctx) => {
|
|
267
316
|
ctx.usedTags = await parseFiles(ctx.document, ctx.files);
|
|
268
317
|
await sleep(500);
|
|
269
318
|
}
|
|
270
319
|
},
|
|
271
320
|
{
|
|
272
|
-
title: i18n.t("
|
|
321
|
+
title: i18n.t("add_tag"),
|
|
273
322
|
task: async (ctx, task) => {
|
|
274
323
|
const undefinedTags = appendTag(ctx.document, ctx.usedTags);
|
|
275
324
|
if (undefinedTags.length) {
|
|
@@ -280,7 +329,7 @@ var generateOpenapiWithSpinner = async (config) => {
|
|
|
280
329
|
}
|
|
281
330
|
},
|
|
282
331
|
{
|
|
283
|
-
title: i18n.t("
|
|
332
|
+
title: i18n.t("hand_fix_documentation"),
|
|
284
333
|
skip: !config.fix,
|
|
285
334
|
task: async (ctx) => {
|
|
286
335
|
await config.fix(ctx.document);
|
|
@@ -288,14 +337,14 @@ var generateOpenapiWithSpinner = async (config) => {
|
|
|
288
337
|
}
|
|
289
338
|
},
|
|
290
339
|
{
|
|
291
|
-
title: i18n.t("
|
|
340
|
+
title: i18n.t("optimize_parameter"),
|
|
292
341
|
task: async (ctx) => {
|
|
293
342
|
methodParameterToPathParameter(ctx.document);
|
|
294
343
|
await sleep(500);
|
|
295
344
|
}
|
|
296
345
|
},
|
|
297
346
|
{
|
|
298
|
-
title: i18n.t("
|
|
347
|
+
title: i18n.t("save_to_file"),
|
|
299
348
|
task: async (ctx, task) => {
|
|
300
349
|
const result = await saveToFile(ctx.document, config.saveToFile, config.fileMode);
|
|
301
350
|
task.suffix = terminal.style(
|
|
@@ -305,20 +354,20 @@ var generateOpenapiWithSpinner = async (config) => {
|
|
|
305
354
|
}
|
|
306
355
|
},
|
|
307
356
|
{
|
|
308
|
-
title: i18n.t("
|
|
357
|
+
title: i18n.t("validate"),
|
|
309
358
|
task: async (ctx, task) => {
|
|
310
359
|
const result = ctx.validateResult = await validateOpenapi(ctx.document);
|
|
311
360
|
await sleep(500);
|
|
312
361
|
if (result.errors.length || result.warnings.length) {
|
|
313
362
|
task.suffix = terminal.style(
|
|
314
363
|
"yellow",
|
|
315
|
-
i18n.t("
|
|
364
|
+
i18n.t("has_error", {
|
|
316
365
|
error_count: result.errors.length,
|
|
317
366
|
warning_count: result.warnings.length
|
|
318
367
|
})
|
|
319
368
|
);
|
|
320
369
|
} else {
|
|
321
|
-
task.suffix = terminal.style("green", i18n.t("
|
|
370
|
+
task.suffix = terminal.style("green", i18n.t("no_error"));
|
|
322
371
|
}
|
|
323
372
|
}
|
|
324
373
|
}
|
|
@@ -352,44 +401,12 @@ var openapi = (options) => {
|
|
|
352
401
|
},
|
|
353
402
|
help: {
|
|
354
403
|
onDocument(doc) {
|
|
355
|
-
doc[commandName] = { summary:
|
|
404
|
+
doc[commandName] = { summary: i18n.t("help_summary") };
|
|
356
405
|
}
|
|
357
406
|
}
|
|
358
407
|
});
|
|
359
408
|
};
|
|
360
409
|
|
|
361
|
-
// src/i18n/locales/zh-cn.ts
|
|
362
|
-
import { i18n as i18n3 } from "@aomex/core";
|
|
363
|
-
i18n3.register("zh_CN", "openapi", {
|
|
364
|
-
initialize: "\u521D\u59CB\u5316\u6587\u6863",
|
|
365
|
-
search_routers_files: "\u641C\u7D22\u8DEF\u7531\u6587\u4EF6",
|
|
366
|
-
parse_routers: "\u89E3\u6790\u8DEF\u7531",
|
|
367
|
-
add_tag: "\u589E\u52A0\u6807\u7B7E",
|
|
368
|
-
hand_fix_documentation: "\u624B\u52A8\u4FEE\u590D\u6587\u6863",
|
|
369
|
-
optimize_parameter: "\u4F18\u5316\u53C2\u6570",
|
|
370
|
-
save_to_file: "\u4FDD\u5B58\u5230\u6587\u4EF6",
|
|
371
|
-
validate: "\u9A8C\u8BC1\u6587\u6863",
|
|
372
|
-
help_summary: "openapi v3 \u6587\u6863\u751F\u6210\u5668",
|
|
373
|
-
has_error: "{{error_count}}\u6761\u62A5\u9519\uFF0C{{warning_count}}\u6761\u8B66\u544A",
|
|
374
|
-
no_error: "\u6CA1\u6709\u62A5\u9519"
|
|
375
|
-
});
|
|
376
|
-
|
|
377
|
-
// src/i18n/locales/en-us.ts
|
|
378
|
-
import { i18n as i18n4 } from "@aomex/core";
|
|
379
|
-
i18n4.register("en_US", "openapi", {
|
|
380
|
-
initialize: "initialize document",
|
|
381
|
-
search_routers_files: "search web routers files",
|
|
382
|
-
parse_routers: "parse routers",
|
|
383
|
-
add_tag: "append tags",
|
|
384
|
-
hand_fix_documentation: "fix documentation by manual",
|
|
385
|
-
optimize_parameter: "optimize parameters",
|
|
386
|
-
save_to_file: "save to file",
|
|
387
|
-
validate: "validate document",
|
|
388
|
-
help_summary: "openapi v3 documentation generator",
|
|
389
|
-
has_error: "{{error_count}} errors, {{warning_count}} warnings",
|
|
390
|
-
no_error: "No errors"
|
|
391
|
-
});
|
|
392
|
-
|
|
393
410
|
// src/lib/generate-openapi.ts
|
|
394
411
|
import "@aomex/core";
|
|
395
412
|
import { pathToFiles as pathToFiles2 } from "@aomex/internal-file-import";
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/openapi.ts","../src/lib/generate-document-with-spinner.ts","../src/lib/validate-openapi.ts","../src/lib/methods.ts","../src/lib/hoist-parameter.ts","../src/lib/save-to-file.ts","../src/lib/initialize-document.ts","../src/lib/parse-files.ts","../src/lib/method-to-verb.ts","../src/lib/append-tag.ts","../src/i18n/locales/zh-cn.ts","../src/i18n/locales/en-us.ts","../src/lib/generate-openapi.ts"],"sourcesContent":["import { i18n, middleware } from '@aomex/core';\nimport type { ConsoleMiddleware } from '@aomex/console';\nimport {\n generateOpenapiWithSpinner,\n type GenerateOpenapiWithSpinnerOptions,\n} from './lib/generate-document-with-spinner';\n\nexport interface OpenapiOptions extends GenerateOpenapiWithSpinnerOptions {\n /**\n * 指令名称。默认值:`openapi`\n */\n commandName?: string;\n}\n\nexport const openapi = (options: OpenapiOptions): ConsoleMiddleware => {\n const { commandName = 'openapi' } = options;\n\n return middleware.console({\n fn: async (ctx, next) => {\n if (ctx.input.command !== commandName) return next();\n ctx.commandMatched = true;\n await generateOpenapiWithSpinner(options);\n },\n help: {\n onDocument(doc) {\n doc[commandName] = { summary: i18n.t('openapi.help_summary') };\n },\n },\n });\n};\n","import type { Mode } from 'node:fs';\nimport { OpenAPI, i18n } from '@aomex/core';\nimport { sleep } from '@aomex/internal-tools';\nimport { pathToFiles } from '@aomex/internal-file-import';\nimport path from 'node:path';\nimport {\n validateOpenapi,\n type OpenapiValidateResult,\n type OpenapiValidateResultItem,\n} from './validate-openapi';\nimport { methodParameterToPathParameter } from './hoist-parameter';\nimport { saveToFile } from './save-to-file';\nimport { initializeDocument } from './initialize-document';\nimport { parseFiles } from './parse-files';\nimport { appendTag } from './append-tag';\nimport { terminal } from '@aomex/console';\nimport type { GenerateOpenapiOptions } from './generate-openapi';\n\nexport interface GenerateOpenapiWithSpinnerOptions extends GenerateOpenapiOptions {\n /**\n * 保存到指定文件。默认值:`openapi.json`\n * - `*.json` 保存为JSON格式\n * - `*.yaml` 保存为YAML格式\n */\n saveToFile?: string;\n /**\n * 设置保存文件的系统权限。\n */\n fileMode?: Mode;\n}\n\ninterface SpinnerContext {\n document: OpenAPI.Document;\n files: string[];\n usedTags: string[];\n validateResult: OpenapiValidateResult;\n}\n\n/**\n * 1. 生成openapi文档\n * 2. 保存文档到文件\n * 3. 验证\n * 4. 控制台输出执行步骤和验证结果\n *\n * 如果是主动调用,则应使用 generateOpenapi()\n * @see generateOpenapi\n */\nexport const generateOpenapiWithSpinner = async (\n config: GenerateOpenapiWithSpinnerOptions,\n): Promise<OpenAPI.Document | null> => {\n const { error, context } = await terminal.runTasks<SpinnerContext>([\n {\n title: i18n.t('openapi.initialize'),\n task: async (ctx) => {\n ctx.document = await initializeDocument(config.docs);\n },\n },\n {\n title: i18n.t('openapi.search_routers_files'),\n task: async (ctx) => {\n ctx.files = await pathToFiles(config.routers);\n await sleep(500);\n },\n },\n {\n title: i18n.t('openapi.parse_routers'),\n task: async (ctx) => {\n ctx.usedTags = await parseFiles(ctx.document, ctx.files);\n await sleep(500);\n },\n },\n {\n title: i18n.t('openapi.add_tag'),\n task: async (ctx, task) => {\n const undefinedTags = appendTag(ctx.document, ctx.usedTags);\n if (undefinedTags.length) {\n task.suffix = terminal.style('gray', undefinedTags.join(','));\n } else {\n task.status = 'skip';\n }\n },\n },\n {\n title: i18n.t('openapi.hand_fix_documentation'),\n skip: !config.fix,\n task: async (ctx) => {\n await config.fix!(ctx.document);\n await sleep(500);\n },\n },\n {\n title: i18n.t('openapi.optimize_parameter'),\n task: async (ctx) => {\n methodParameterToPathParameter(ctx.document);\n await sleep(500);\n },\n },\n {\n title: i18n.t('openapi.save_to_file'),\n task: async (ctx, task) => {\n const result = await saveToFile(ctx.document, config.saveToFile, config.fileMode);\n task.suffix =\n terminal.style(\n ['blue', 'underline'],\n path.relative(process.cwd(), result.dest),\n ) + terminal.style('green', ` [${result.size}]`);\n },\n },\n {\n title: i18n.t('openapi.validate'),\n task: async (ctx, task) => {\n const result = (ctx.validateResult = await validateOpenapi(ctx.document));\n await sleep(500);\n\n if (result.errors.length || result.warnings.length) {\n task.suffix = terminal.style(\n 'yellow',\n i18n.t('openapi.has_error', {\n error_count: result.errors.length,\n warning_count: result.warnings.length,\n }),\n );\n } else {\n task.suffix = terminal.style('green', i18n.t('openapi.no_error'));\n }\n },\n },\n ]);\n\n if (error) return null;\n\n const logSession = terminal.applySession();\n const { errors, warnings } = context.validateResult;\n for (const error of errors) {\n logSession.update(` :error: ${formatValidateMessage(error)}`);\n logSession.commit();\n }\n for (const warning of warnings) {\n logSession.update(` :warning: ${formatValidateMessage(warning)}`);\n logSession.commit();\n }\n\n return JSON.parse(JSON.stringify(context.document));\n};\n\nconst formatValidateMessage = (item: OpenapiValidateResultItem) => {\n let pathname = item.path.length ? item.path.join('.') : '';\n return `${terminal.style('gray', `[${pathname || '.'}]`)} ${item.message}`;\n};\n","import type { OpenAPI } from '@aomex/core';\nimport stoplight, { type RulesetDefinition } from '@stoplight/spectral-core';\nimport { oas } from '@stoplight/spectral-rulesets';\n\n// Inline package `@stoplight/types`\nenum DiagnosticSeverity {\n Error = 0,\n Warning = 1,\n Information = 2,\n Hint = 3,\n}\n\nconst spectral = new stoplight.Spectral();\nspectral.setRuleset({\n extends: oas as RulesetDefinition,\n // https://github.com/stoplightio/spectral/blob/develop/packages/rulesets/src/oas/index.ts\n rules: {\n 'info-contact': 'off',\n 'info-description': 'off',\n },\n});\n\nexport interface OpenapiValidateResultItem {\n path: string[];\n message: string;\n}\n\nexport interface OpenapiValidateResult {\n errors: OpenapiValidateResultItem[];\n warnings: OpenapiValidateResultItem[];\n}\n\nexport const validateOpenapi = async (document: OpenAPI.Document) => {\n const result: OpenapiValidateResult = {\n warnings: [],\n errors: [],\n };\n const originResult = await spectral.run(document as unknown as Record<string, unknown>);\n originResult.forEach((item) => {\n result[item.severity === DiagnosticSeverity.Error ? 'errors' : 'warnings'].push({\n path: item.path.map(String),\n message: item.message,\n });\n });\n return result;\n};\n","export const methods = <const>[\n 'get',\n 'post',\n 'put',\n 'patch',\n 'delete',\n 'options',\n 'head',\n 'trace',\n];\n","import type { OpenAPI } from '@aomex/core';\nimport { methods } from './methods';\n\n/**\n * 同一个路径下,所有方法都有相同的parameter时,可以往上提取,这样能减小生成产物\n */\nexport const methodParameterToPathParameter = (document: OpenAPI.Document) => {\n pathLoop: for (const path of Object.values(document.paths)) {\n const parametersHandler: Record<string, Function[]> = {};\n let methodCounter = 0;\n for (const method of methods) {\n const methodItem = path![method];\n if (!methodItem) continue;\n if (!methodItem.parameters?.length) continue pathLoop;\n ++methodCounter;\n methodItem.parameters.forEach((parameter, index, arr) => {\n const uniqueKey = JSON.stringify(parameter);\n // 确保是唯一的\n parameter = arr[index] = JSON.parse(uniqueKey);\n const handler = () => {\n arr.splice(\n arr.findIndex((item) => item === parameter),\n 1,\n );\n if (!arr.length) {\n delete methodItem.parameters;\n }\n };\n parametersHandler[uniqueKey] ||= [];\n parametersHandler[uniqueKey]!.push(handler);\n });\n }\n\n if (methodCounter < 2) continue pathLoop;\n\n Object.entries(parametersHandler).forEach(([uniqueKey, handlers]) => {\n if (handlers.length !== methodCounter) return;\n path!.parameters ||= [];\n path!.parameters.push(JSON.parse(uniqueKey));\n handlers.forEach((fn) => fn());\n });\n if (path!.parameters && !path!.parameters.length) {\n delete path!.parameters;\n }\n }\n};\n","import path from 'node:path';\nimport { mkdir, writeFile } from 'node:fs/promises';\nimport YAML from 'yaml';\nimport { bytes } from '@aomex/internal-tools';\nimport type { OpenAPI } from '@aomex/core';\nimport type { Mode } from 'node:fs';\n\nexport const saveToFile = async (\n document: OpenAPI.Document,\n filename?: string,\n fileMode?: Mode,\n) => {\n const dest = path.resolve(filename || 'openapi.json');\n const ext = path.extname(dest);\n const content =\n ext.endsWith('.yaml') || ext.endsWith('.yml')\n ? YAML.stringify(document)\n : JSON.stringify(document);\n const size = bytes(Buffer.byteLength(content), { unitSeparator: '' });\n\n await mkdir(path.dirname(dest), { recursive: true });\n await writeFile(dest, content, { mode: fileMode, flush: true });\n\n return { dest, size };\n};\n","import type { OpenAPI } from '@aomex/core';\nimport type { GenerateOpenapiOptions } from './generate-openapi';\nimport { readFile } from 'node:fs/promises';\nimport path from 'node:path';\n\nexport const initializeDocument = async (basic?: GenerateOpenapiOptions['docs']) => {\n const document: OpenAPI.Document = JSON.parse(JSON.stringify(basic || {}));\n document.openapi ||= '3.0.3';\n document.tags ||= [];\n document.info ||= { title: '', version: '' };\n document.paths = {};\n document.info.title ||= (await readPackageJson()).name || 'OpenAPI';\n document.info.version ||= (await readPackageJson()).version || '0.0.0';\n return document;\n};\n\nconst readPackageJson = async (): Promise<{ name?: string; version?: string }> => {\n try {\n const content = await readFile(path.resolve('package.json'), 'utf8');\n const json = JSON.parse(content);\n return json && typeof json === 'object' ? json : {};\n } catch {\n return {};\n }\n};\n","import type { OpenAPI } from '@aomex/core';\nimport { getFileValues } from '@aomex/internal-file-import';\nimport { Router, WebMiddleware, WebRequest, type OpenApiInjector } from '@aomex/web';\nimport path from 'node:path';\nimport { methodToVerb } from './method-to-verb';\nimport snakeCase from 'lodash.snakecase';\n\nexport const parseFiles = async (document: OpenAPI.Document, files: string[]) => {\n const usedTags: string[] = [];\n\n const data: {\n pathName: string;\n pathItem: OpenAPI.PathItemObject;\n methodName: `${Lowercase<WebRequest['method']>}`;\n methodItem: OpenAPI.OperationObject;\n injector: OpenApiInjector;\n file: string;\n uri: string;\n }[] = [];\n\n for (const file of files) {\n const routers = await getFileValues<Router>(\n [file],\n (item) => !!item && item instanceof Router,\n );\n\n for (const router of routers) {\n const groupMiddlewareList = router['middlewareList'];\n const builders = router['builders'];\n\n for (const builder of builders) {\n if (builder.docs.showInOpenapi === false) continue;\n delete builder.docs.showInOpenapi;\n\n const builderMiddlewareList = groupMiddlewareList\n .concat(builder['middlewareList'])\n .filter((middleware) => middleware instanceof WebMiddleware) as WebMiddleware[];\n\n const uri = builder['uri'];\n const pathName = normalizePath(uri);\n const pathItem: OpenAPI.PathItemObject = (document.paths[pathName] ||= {});\n\n for (const method of builder['methods']) {\n const methodName = method.toLowerCase() as `${Lowercase<WebRequest['method']>}`;\n const methodItem: OpenAPI.OperationObject = (pathItem[methodName] = {\n ...builder.docs,\n responses: {},\n });\n\n data.push(\n ...builderMiddlewareList.map((item) => {\n return {\n injector: item['openapi'](),\n pathItem,\n pathName,\n methodItem,\n methodName,\n file,\n uri,\n };\n }),\n );\n }\n }\n }\n }\n\n for (const { injector } of data) {\n injector.onDocument?.(document);\n }\n for (const { injector, pathItem, pathName } of data) {\n injector.onPath?.(pathItem, { document, pathName });\n }\n for (const { injector, pathItem, pathName, methodItem, methodName } of data) {\n injector.onMethod?.(methodItem, {\n document,\n pathItem,\n pathName,\n methodName,\n });\n }\n for (const { injector, pathItem, pathName, methodItem, methodName } of data) {\n injector.postMethod?.(methodItem, {\n document,\n pathItem,\n pathName,\n methodName,\n });\n }\n for (const { injector, pathItem, pathName } of data) {\n injector.postPath?.(pathItem, { document, pathName });\n }\n for (const { injector } of data) {\n injector.postDocument?.(document);\n }\n\n for (const { methodItem, methodName, file, uri } of data) {\n methodItem.tags ||= [getTagByFilename(file)];\n methodItem.operationId ||= snakeCase(\n methodToVerb(methodName, uri) + ' ' + uri.replaceAll(':', '_by_'),\n );\n\n if (methodName === 'post') {\n // @ts-expect-error 防止验证警告\n methodItem['x-codegen-request-body-name'] = 'body';\n }\n\n if (!Object.keys(methodItem.responses).length) {\n methodItem.responses = { default: { description: '' } };\n }\n\n usedTags.push(...methodItem.tags!);\n }\n\n return [...new Set(usedTags)];\n};\n\nconst normalizePath = (uri: string) => {\n return uri.replace(/:([a-z0-9_?]+)/gi, (_, $1) => {\n return `{${$1.replace(/[?]/g, '')}}`;\n });\n};\n\nconst getTagByFilename = (file: string) => {\n return path.basename(file).replace(/\\..+$/, '');\n};\n","export const methodToVerb = (method: string, uri: string) => {\n method = method.toLowerCase();\n\n if (method === 'get') return uri.includes(':') ? 'retrieve' : 'list';\n if (method === 'post') return 'create';\n if (method === 'put') return 'replace';\n if (method === 'patch') return 'update';\n return method;\n};\n","import type { OpenAPI } from '@aomex/core';\n\nexport const appendTag = (document: OpenAPI.Document, usedTags: string[]) => {\n const tags = (document.tags ||= []);\n const definedTags = tags.map((item) => item.name);\n const undefinedTags = usedTags.filter((tag) => !definedTags.includes(tag)).sort();\n\n for (const tag of undefinedTags) {\n tags.push({ name: tag });\n }\n\n return undefinedTags;\n};\n","import { i18n } from '@aomex/core';\n\ni18n.register('zh_CN', 'openapi', {\n initialize: '初始化文档',\n search_routers_files: '搜索路由文件',\n parse_routers: '解析路由',\n add_tag: '增加标签',\n hand_fix_documentation: '手动修复文档',\n optimize_parameter: '优化参数',\n save_to_file: '保存到文件',\n validate: '验证文档',\n help_summary: 'openapi v3 文档生成器',\n has_error: '{{error_count}}条报错,{{warning_count}}条警告',\n no_error: '没有报错',\n});\n","import { i18n } from '@aomex/core';\n\ni18n.register('en_US', 'openapi', {\n initialize: 'initialize document',\n search_routers_files: 'search web routers files',\n parse_routers: 'parse routers',\n add_tag: 'append tags',\n hand_fix_documentation: 'fix documentation by manual',\n optimize_parameter: 'optimize parameters',\n save_to_file: 'save to file',\n validate: 'validate document',\n help_summary: 'openapi v3 documentation generator',\n has_error: '{{error_count}} errors, {{warning_count}} warnings',\n no_error: 'No errors',\n});\n","import { OpenAPI } from '@aomex/core';\nimport { pathToFiles, type GlobPathOptions } from '@aomex/internal-file-import';\nimport { methodParameterToPathParameter } from './hoist-parameter';\nimport { initializeDocument } from './initialize-document';\nimport { parseFiles } from './parse-files';\nimport { appendTag } from './append-tag';\n\nexport interface GenerateOpenapiOptions {\n /**\n * http接口路由文件\n */\n routers: GlobPathOptions;\n /**\n * Openapi基础信息\n */\n docs?: Omit<OpenAPI.Document, 'paths' | 'openapi' | 'info'> & {\n openapi?: `3.0.${0 | 1 | 2 | 3}`;\n info?: Partial<OpenAPI.Document['info']>;\n };\n /**\n * 手动修复文档内容\n */\n fix?: (data: OpenAPI.Document) => void | Promise<void>;\n}\n\n/**\n * 生成openapi文档\n */\nexport const generateOpenapi = async (\n config: GenerateOpenapiOptions,\n): Promise<OpenAPI.Document> => {\n const document = await initializeDocument(config.docs);\n const files = await pathToFiles(config.routers);\n const usedTags = await parseFiles(document, files);\n appendTag(document, usedTags);\n await config.fix?.(document);\n methodParameterToPathParameter(document);\n\n return JSON.parse(JSON.stringify(document));\n};\n"],"mappings":";AAAA,SAAS,QAAAA,OAAM,kBAAkB;;;ACCjC,SAAkB,YAAY;AAC9B,SAAS,aAAa;AACtB,SAAS,mBAAmB;AAC5B,OAAOC,WAAU;;;ACHjB,OAAO,eAA2C;AAClD,SAAS,WAAW;AAUpB,IAAM,WAAW,IAAI,UAAU,SAAS;AACxC,SAAS,WAAW;AAAA,EAClB,SAAS;AAAA;AAAA,EAET,OAAO;AAAA,IACL,gBAAgB;AAAA,IAChB,oBAAoB;AAAA,EACtB;AACF,CAAC;AAYM,IAAM,kBAAkB,OAAO,aAA+B;AACnE,QAAM,SAAgC;AAAA,IACpC,UAAU,CAAC;AAAA,IACX,QAAQ,CAAC;AAAA,EACX;AACA,QAAM,eAAe,MAAM,SAAS,IAAI,QAA8C;AACtF,eAAa,QAAQ,CAAC,SAAS;AAC7B,WAAO,KAAK,aAAa,gBAA2B,WAAW,UAAU,EAAE,KAAK;AAAA,MAC9E,MAAM,KAAK,KAAK,IAAI,MAAM;AAAA,MAC1B,SAAS,KAAK;AAAA,IAChB,CAAC;AAAA,EACH,CAAC;AACD,SAAO;AACT;;;AC7CO,IAAM,UAAiB;AAAA,EAC5B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;;;ACHO,IAAM,iCAAiC,CAAC,aAA+B;AAC5E,WAAU,YAAWC,SAAQ,OAAO,OAAO,SAAS,KAAK,GAAG;AAC1D,UAAM,oBAAgD,CAAC;AACvD,QAAI,gBAAgB;AACpB,eAAW,UAAU,SAAS;AAC5B,YAAM,aAAaA,MAAM,MAAM;AAC/B,UAAI,CAAC,WAAY;AACjB,UAAI,CAAC,WAAW,YAAY,OAAQ,UAAS;AAC7C,QAAE;AACF,iBAAW,WAAW,QAAQ,CAAC,WAAW,OAAO,QAAQ;AACvD,cAAM,YAAY,KAAK,UAAU,SAAS;AAE1C,oBAAY,IAAI,KAAK,IAAI,KAAK,MAAM,SAAS;AAC7C,cAAM,UAAU,MAAM;AACpB,cAAI;AAAA,YACF,IAAI,UAAU,CAAC,SAAS,SAAS,SAAS;AAAA,YAC1C;AAAA,UACF;AACA,cAAI,CAAC,IAAI,QAAQ;AACf,mBAAO,WAAW;AAAA,UACpB;AAAA,QACF;AACA,0BAAkB,SAAS,MAAM,CAAC;AAClC,0BAAkB,SAAS,EAAG,KAAK,OAAO;AAAA,MAC5C,CAAC;AAAA,IACH;AAEA,QAAI,gBAAgB,EAAG,UAAS;AAEhC,WAAO,QAAQ,iBAAiB,EAAE,QAAQ,CAAC,CAAC,WAAW,QAAQ,MAAM;AACnE,UAAI,SAAS,WAAW,cAAe;AACvC,MAAAA,MAAM,eAAe,CAAC;AACtB,MAAAA,MAAM,WAAW,KAAK,KAAK,MAAM,SAAS,CAAC;AAC3C,eAAS,QAAQ,CAAC,OAAO,GAAG,CAAC;AAAA,IAC/B,CAAC;AACD,QAAIA,MAAM,cAAc,CAACA,MAAM,WAAW,QAAQ;AAChD,aAAOA,MAAM;AAAA,IACf;AAAA,EACF;AACF;;;AC7CA,OAAO,UAAU;AACjB,SAAS,OAAO,iBAAiB;AACjC,OAAO,UAAU;AACjB,SAAS,aAAa;AAIf,IAAM,aAAa,OACxB,UACA,UACA,aACG;AACH,QAAM,OAAO,KAAK,QAAQ,YAAY,cAAc;AACpD,QAAM,MAAM,KAAK,QAAQ,IAAI;AAC7B,QAAM,UACJ,IAAI,SAAS,OAAO,KAAK,IAAI,SAAS,MAAM,IACxC,KAAK,UAAU,QAAQ,IACvB,KAAK,UAAU,QAAQ;AAC7B,QAAM,OAAO,MAAM,OAAO,WAAW,OAAO,GAAG,EAAE,eAAe,GAAG,CAAC;AAEpE,QAAM,MAAM,KAAK,QAAQ,IAAI,GAAG,EAAE,WAAW,KAAK,CAAC;AACnD,QAAM,UAAU,MAAM,SAAS,EAAE,MAAM,UAAU,OAAO,KAAK,CAAC;AAE9D,SAAO,EAAE,MAAM,KAAK;AACtB;;;ACtBA,SAAS,gBAAgB;AACzB,OAAOC,WAAU;AAEV,IAAM,qBAAqB,OAAO,UAA2C;AAClF,QAAM,WAA6B,KAAK,MAAM,KAAK,UAAU,SAAS,CAAC,CAAC,CAAC;AACzE,WAAS,YAAY;AACrB,WAAS,SAAS,CAAC;AACnB,WAAS,SAAS,EAAE,OAAO,IAAI,SAAS,GAAG;AAC3C,WAAS,QAAQ,CAAC;AAClB,WAAS,KAAK,WAAW,MAAM,gBAAgB,GAAG,QAAQ;AAC1D,WAAS,KAAK,aAAa,MAAM,gBAAgB,GAAG,WAAW;AAC/D,SAAO;AACT;AAEA,IAAM,kBAAkB,YAA0D;AAChF,MAAI;AACF,UAAM,UAAU,MAAM,SAASA,MAAK,QAAQ,cAAc,GAAG,MAAM;AACnE,UAAM,OAAO,KAAK,MAAM,OAAO;AAC/B,WAAO,QAAQ,OAAO,SAAS,WAAW,OAAO,CAAC;AAAA,EACpD,QAAQ;AACN,WAAO,CAAC;AAAA,EACV;AACF;;;ACvBA,SAAS,qBAAqB;AAC9B,SAAS,QAAQ,qBAAuD;AACxE,OAAOC,WAAU;;;ACHV,IAAM,eAAe,CAAC,QAAgB,QAAgB;AAC3D,WAAS,OAAO,YAAY;AAE5B,MAAI,WAAW,MAAO,QAAO,IAAI,SAAS,GAAG,IAAI,aAAa;AAC9D,MAAI,WAAW,OAAQ,QAAO;AAC9B,MAAI,WAAW,MAAO,QAAO;AAC7B,MAAI,WAAW,QAAS,QAAO;AAC/B,SAAO;AACT;;;ADHA,OAAO,eAAe;AAEf,IAAM,aAAa,OAAO,UAA4B,UAAoB;AAC/E,QAAM,WAAqB,CAAC;AAE5B,QAAM,OAQA,CAAC;AAEP,aAAW,QAAQ,OAAO;AACxB,UAAM,UAAU,MAAM;AAAA,MACpB,CAAC,IAAI;AAAA,MACL,CAAC,SAAS,CAAC,CAAC,QAAQ,gBAAgB;AAAA,IACtC;AAEA,eAAW,UAAU,SAAS;AAC5B,YAAM,sBAAsB,OAAO,gBAAgB;AACnD,YAAM,WAAW,OAAO,UAAU;AAElC,iBAAW,WAAW,UAAU;AAC9B,YAAI,QAAQ,KAAK,kBAAkB,MAAO;AAC1C,eAAO,QAAQ,KAAK;AAEpB,cAAM,wBAAwB,oBAC3B,OAAO,QAAQ,gBAAgB,CAAC,EAChC,OAAO,CAACC,gBAAeA,uBAAsB,aAAa;AAE7D,cAAM,MAAM,QAAQ,KAAK;AACzB,cAAM,WAAW,cAAc,GAAG;AAClC,cAAM,WAAoC,SAAS,MAAM,QAAQ,MAAM,CAAC;AAExE,mBAAW,UAAU,QAAQ,SAAS,GAAG;AACvC,gBAAM,aAAa,OAAO,YAAY;AACtC,gBAAM,aAAuC,SAAS,UAAU,IAAI;AAAA,YAClE,GAAG,QAAQ;AAAA,YACX,WAAW,CAAC;AAAA,UACd;AAEA,eAAK;AAAA,YACH,GAAG,sBAAsB,IAAI,CAAC,SAAS;AACrC,qBAAO;AAAA,gBACL,UAAU,KAAK,SAAS,EAAE;AAAA,gBAC1B;AAAA,gBACA;AAAA,gBACA;AAAA,gBACA;AAAA,gBACA;AAAA,gBACA;AAAA,cACF;AAAA,YACF,CAAC;AAAA,UACH;AAAA,QACF;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAEA,aAAW,EAAE,SAAS,KAAK,MAAM;AAC/B,aAAS,aAAa,QAAQ;AAAA,EAChC;AACA,aAAW,EAAE,UAAU,UAAU,SAAS,KAAK,MAAM;AACnD,aAAS,SAAS,UAAU,EAAE,UAAU,SAAS,CAAC;AAAA,EACpD;AACA,aAAW,EAAE,UAAU,UAAU,UAAU,YAAY,WAAW,KAAK,MAAM;AAC3E,aAAS,WAAW,YAAY;AAAA,MAC9B;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF,CAAC;AAAA,EACH;AACA,aAAW,EAAE,UAAU,UAAU,UAAU,YAAY,WAAW,KAAK,MAAM;AAC3E,aAAS,aAAa,YAAY;AAAA,MAChC;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF,CAAC;AAAA,EACH;AACA,aAAW,EAAE,UAAU,UAAU,SAAS,KAAK,MAAM;AACnD,aAAS,WAAW,UAAU,EAAE,UAAU,SAAS,CAAC;AAAA,EACtD;AACA,aAAW,EAAE,SAAS,KAAK,MAAM;AAC/B,aAAS,eAAe,QAAQ;AAAA,EAClC;AAEA,aAAW,EAAE,YAAY,YAAY,MAAM,IAAI,KAAK,MAAM;AACxD,eAAW,SAAS,CAAC,iBAAiB,IAAI,CAAC;AAC3C,eAAW,gBAAgB;AAAA,MACzB,aAAa,YAAY,GAAG,IAAI,MAAM,IAAI,WAAW,KAAK,MAAM;AAAA,IAClE;AAEA,QAAI,eAAe,QAAQ;AAEzB,iBAAW,6BAA6B,IAAI;AAAA,IAC9C;AAEA,QAAI,CAAC,OAAO,KAAK,WAAW,SAAS,EAAE,QAAQ;AAC7C,iBAAW,YAAY,EAAE,SAAS,EAAE,aAAa,GAAG,EAAE;AAAA,IACxD;AAEA,aAAS,KAAK,GAAG,WAAW,IAAK;AAAA,EACnC;AAEA,SAAO,CAAC,GAAG,IAAI,IAAI,QAAQ,CAAC;AAC9B;AAEA,IAAM,gBAAgB,CAAC,QAAgB;AACrC,SAAO,IAAI,QAAQ,oBAAoB,CAAC,GAAG,OAAO;AAChD,WAAO,IAAI,GAAG,QAAQ,QAAQ,EAAE,CAAC;AAAA,EACnC,CAAC;AACH;AAEA,IAAM,mBAAmB,CAAC,SAAiB;AACzC,SAAOC,MAAK,SAAS,IAAI,EAAE,QAAQ,SAAS,EAAE;AAChD;;;AE3HO,IAAM,YAAY,CAAC,UAA4B,aAAuB;AAC3E,QAAM,OAAQ,SAAS,SAAS,CAAC;AACjC,QAAM,cAAc,KAAK,IAAI,CAAC,SAAS,KAAK,IAAI;AAChD,QAAM,gBAAgB,SAAS,OAAO,CAAC,QAAQ,CAAC,YAAY,SAAS,GAAG,CAAC,EAAE,KAAK;AAEhF,aAAW,OAAO,eAAe;AAC/B,SAAK,KAAK,EAAE,MAAM,IAAI,CAAC;AAAA,EACzB;AAEA,SAAO;AACT;;;ARGA,SAAS,gBAAgB;AAgClB,IAAM,6BAA6B,OACxC,WACqC;AACrC,QAAM,EAAE,OAAO,QAAQ,IAAI,MAAM,SAAS,SAAyB;AAAA,IACjE;AAAA,MACE,OAAO,KAAK,EAAE,oBAAoB;AAAA,MAClC,MAAM,OAAO,QAAQ;AACnB,YAAI,WAAW,MAAM,mBAAmB,OAAO,IAAI;AAAA,MACrD;AAAA,IACF;AAAA,IACA;AAAA,MACE,OAAO,KAAK,EAAE,8BAA8B;AAAA,MAC5C,MAAM,OAAO,QAAQ;AACnB,YAAI,QAAQ,MAAM,YAAY,OAAO,OAAO;AAC5C,cAAM,MAAM,GAAG;AAAA,MACjB;AAAA,IACF;AAAA,IACA;AAAA,MACE,OAAO,KAAK,EAAE,uBAAuB;AAAA,MACrC,MAAM,OAAO,QAAQ;AACnB,YAAI,WAAW,MAAM,WAAW,IAAI,UAAU,IAAI,KAAK;AACvD,cAAM,MAAM,GAAG;AAAA,MACjB;AAAA,IACF;AAAA,IACA;AAAA,MACE,OAAO,KAAK,EAAE,iBAAiB;AAAA,MAC/B,MAAM,OAAO,KAAK,SAAS;AACzB,cAAM,gBAAgB,UAAU,IAAI,UAAU,IAAI,QAAQ;AAC1D,YAAI,cAAc,QAAQ;AACxB,eAAK,SAAS,SAAS,MAAM,QAAQ,cAAc,KAAK,GAAG,CAAC;AAAA,QAC9D,OAAO;AACL,eAAK,SAAS;AAAA,QAChB;AAAA,MACF;AAAA,IACF;AAAA,IACA;AAAA,MACE,OAAO,KAAK,EAAE,gCAAgC;AAAA,MAC9C,MAAM,CAAC,OAAO;AAAA,MACd,MAAM,OAAO,QAAQ;AACnB,cAAM,OAAO,IAAK,IAAI,QAAQ;AAC9B,cAAM,MAAM,GAAG;AAAA,MACjB;AAAA,IACF;AAAA,IACA;AAAA,MACE,OAAO,KAAK,EAAE,4BAA4B;AAAA,MAC1C,MAAM,OAAO,QAAQ;AACnB,uCAA+B,IAAI,QAAQ;AAC3C,cAAM,MAAM,GAAG;AAAA,MACjB;AAAA,IACF;AAAA,IACA;AAAA,MACE,OAAO,KAAK,EAAE,sBAAsB;AAAA,MACpC,MAAM,OAAO,KAAK,SAAS;AACzB,cAAM,SAAS,MAAM,WAAW,IAAI,UAAU,OAAO,YAAY,OAAO,QAAQ;AAChF,aAAK,SACH,SAAS;AAAA,UACP,CAAC,QAAQ,WAAW;AAAA,UACpBC,MAAK,SAAS,QAAQ,IAAI,GAAG,OAAO,IAAI;AAAA,QAC1C,IAAI,SAAS,MAAM,SAAS,KAAK,OAAO,IAAI,GAAG;AAAA,MACnD;AAAA,IACF;AAAA,IACA;AAAA,MACE,OAAO,KAAK,EAAE,kBAAkB;AAAA,MAChC,MAAM,OAAO,KAAK,SAAS;AACzB,cAAM,SAAU,IAAI,iBAAiB,MAAM,gBAAgB,IAAI,QAAQ;AACvE,cAAM,MAAM,GAAG;AAEf,YAAI,OAAO,OAAO,UAAU,OAAO,SAAS,QAAQ;AAClD,eAAK,SAAS,SAAS;AAAA,YACrB;AAAA,YACA,KAAK,EAAE,qBAAqB;AAAA,cAC1B,aAAa,OAAO,OAAO;AAAA,cAC3B,eAAe,OAAO,SAAS;AAAA,YACjC,CAAC;AAAA,UACH;AAAA,QACF,OAAO;AACL,eAAK,SAAS,SAAS,MAAM,SAAS,KAAK,EAAE,kBAAkB,CAAC;AAAA,QAClE;AAAA,MACF;AAAA,IACF;AAAA,EACF,CAAC;AAED,MAAI,MAAO,QAAO;AAElB,QAAM,aAAa,SAAS,aAAa;AACzC,QAAM,EAAE,QAAQ,SAAS,IAAI,QAAQ;AACrC,aAAWC,UAAS,QAAQ;AAC1B,eAAW,OAAO,aAAa,sBAAsBA,MAAK,CAAC,EAAE;AAC7D,eAAW,OAAO;AAAA,EACpB;AACA,aAAW,WAAW,UAAU;AAC9B,eAAW,OAAO,eAAe,sBAAsB,OAAO,CAAC,EAAE;AACjE,eAAW,OAAO;AAAA,EACpB;AAEA,SAAO,KAAK,MAAM,KAAK,UAAU,QAAQ,QAAQ,CAAC;AACpD;AAEA,IAAM,wBAAwB,CAAC,SAAoC;AACjE,MAAI,WAAW,KAAK,KAAK,SAAS,KAAK,KAAK,KAAK,GAAG,IAAI;AACxD,SAAO,GAAG,SAAS,MAAM,QAAQ,IAAI,YAAY,GAAG,GAAG,CAAC,IAAI,KAAK,OAAO;AAC1E;;;ADtIO,IAAM,UAAU,CAAC,YAA+C;AACrE,QAAM,EAAE,cAAc,UAAU,IAAI;AAEpC,SAAO,WAAW,QAAQ;AAAA,IACxB,IAAI,OAAO,KAAK,SAAS;AACvB,UAAI,IAAI,MAAM,YAAY,YAAa,QAAO,KAAK;AACnD,UAAI,iBAAiB;AACrB,YAAM,2BAA2B,OAAO;AAAA,IAC1C;AAAA,IACA,MAAM;AAAA,MACJ,WAAW,KAAK;AACd,YAAI,WAAW,IAAI,EAAE,SAASC,MAAK,EAAE,sBAAsB,EAAE;AAAA,MAC/D;AAAA,IACF;AAAA,EACF,CAAC;AACH;;;AU7BA,SAAS,QAAAC,aAAY;AAErBA,MAAK,SAAS,SAAS,WAAW;AAAA,EAChC,YAAY;AAAA,EACZ,sBAAsB;AAAA,EACtB,eAAe;AAAA,EACf,SAAS;AAAA,EACT,wBAAwB;AAAA,EACxB,oBAAoB;AAAA,EACpB,cAAc;AAAA,EACd,UAAU;AAAA,EACV,cAAc;AAAA,EACd,WAAW;AAAA,EACX,UAAU;AACZ,CAAC;;;ACdD,SAAS,QAAAC,aAAY;AAErBA,MAAK,SAAS,SAAS,WAAW;AAAA,EAChC,YAAY;AAAA,EACZ,sBAAsB;AAAA,EACtB,eAAe;AAAA,EACf,SAAS;AAAA,EACT,wBAAwB;AAAA,EACxB,oBAAoB;AAAA,EACpB,cAAc;AAAA,EACd,UAAU;AAAA,EACV,cAAc;AAAA,EACd,WAAW;AAAA,EACX,UAAU;AACZ,CAAC;;;ACdD,OAAwB;AACxB,SAAS,eAAAC,oBAAyC;AA2B3C,IAAM,kBAAkB,OAC7B,WAC8B;AAC9B,QAAM,WAAW,MAAM,mBAAmB,OAAO,IAAI;AACrD,QAAM,QAAQ,MAAMC,aAAY,OAAO,OAAO;AAC9C,QAAM,WAAW,MAAM,WAAW,UAAU,KAAK;AACjD,YAAU,UAAU,QAAQ;AAC5B,QAAM,OAAO,MAAM,QAAQ;AAC3B,iCAA+B,QAAQ;AAEvC,SAAO,KAAK,MAAM,KAAK,UAAU,QAAQ,CAAC;AAC5C;","names":["i18n","path","path","path","path","middleware","path","path","error","i18n","i18n","i18n","pathToFiles","pathToFiles"]}
|
|
1
|
+
{"version":3,"sources":["../src/openapi.ts","../src/lib/generate-document-with-spinner.ts","../src/lib/validate-openapi.ts","../src/lib/methods.ts","../src/lib/hoist-parameter.ts","../src/lib/save-to-file.ts","../src/lib/initialize-document.ts","../src/lib/parse-files.ts","../src/lib/method-to-verb.ts","../src/lib/append-tag.ts","../src/i18n/index.ts","../src/i18n/locales/zh-cn.ts","../src/i18n/locales/en-us.ts","../src/i18n/locales/index.ts","../src/lib/generate-openapi.ts"],"sourcesContent":["import { middleware } from '@aomex/core';\nimport type { ConsoleMiddleware } from '@aomex/console';\nimport {\n generateOpenapiWithSpinner,\n type GenerateOpenapiWithSpinnerOptions,\n} from './lib/generate-document-with-spinner';\nimport { i18n } from './i18n';\n\nexport interface OpenapiOptions extends GenerateOpenapiWithSpinnerOptions {\n /**\n * 指令名称。默认值:`openapi`\n */\n commandName?: string;\n}\n\nexport const openapi = (options: OpenapiOptions): ConsoleMiddleware => {\n const { commandName = 'openapi' } = options;\n\n return middleware.console({\n fn: async (ctx, next) => {\n if (ctx.input.command !== commandName) return next();\n ctx.commandMatched = true;\n await generateOpenapiWithSpinner(options);\n },\n help: {\n onDocument(doc) {\n doc[commandName] = { summary: i18n.t('help_summary') };\n },\n },\n });\n};\n","import type { Mode } from 'node:fs';\nimport { OpenAPI } from '@aomex/core';\nimport { sleep } from '@aomex/internal-tools';\nimport { pathToFiles } from '@aomex/internal-file-import';\nimport path from 'node:path';\nimport {\n validateOpenapi,\n type OpenapiValidateResult,\n type OpenapiValidateResultItem,\n} from './validate-openapi';\nimport { methodParameterToPathParameter } from './hoist-parameter';\nimport { saveToFile } from './save-to-file';\nimport { initializeDocument } from './initialize-document';\nimport { parseFiles } from './parse-files';\nimport { appendTag } from './append-tag';\nimport { terminal } from '@aomex/console';\nimport type { GenerateOpenapiOptions } from './generate-openapi';\nimport { i18n } from '../i18n';\n\nexport interface GenerateOpenapiWithSpinnerOptions extends GenerateOpenapiOptions {\n /**\n * 保存到指定文件。默认值:`openapi.json`\n * - `*.json` 保存为JSON格式\n * - `*.yaml` 保存为YAML格式\n */\n saveToFile?: string;\n /**\n * 设置保存文件的系统权限。\n */\n fileMode?: Mode;\n}\n\ninterface SpinnerContext {\n document: OpenAPI.Document;\n files: string[];\n usedTags: string[];\n validateResult: OpenapiValidateResult;\n}\n\n/**\n * 1. 生成openapi文档\n * 2. 保存文档到文件\n * 3. 验证\n * 4. 控制台输出执行步骤和验证结果\n *\n * 如果是主动调用,则应使用 generateOpenapi()\n * @see generateOpenapi\n */\nexport const generateOpenapiWithSpinner = async (\n config: GenerateOpenapiWithSpinnerOptions,\n): Promise<OpenAPI.Document | null> => {\n const { error, context } = await terminal.runTasks<SpinnerContext>([\n {\n title: i18n.t('initialize'),\n task: async (ctx) => {\n ctx.document = await initializeDocument(config.docs);\n },\n },\n {\n title: i18n.t('search_routers_files'),\n task: async (ctx) => {\n ctx.files = await pathToFiles(config.routers);\n await sleep(500);\n },\n },\n {\n title: i18n.t('parse_routers'),\n task: async (ctx) => {\n ctx.usedTags = await parseFiles(ctx.document, ctx.files);\n await sleep(500);\n },\n },\n {\n title: i18n.t('add_tag'),\n task: async (ctx, task) => {\n const undefinedTags = appendTag(ctx.document, ctx.usedTags);\n if (undefinedTags.length) {\n task.suffix = terminal.style('gray', undefinedTags.join(','));\n } else {\n task.status = 'skip';\n }\n },\n },\n {\n title: i18n.t('hand_fix_documentation'),\n skip: !config.fix,\n task: async (ctx) => {\n await config.fix!(ctx.document);\n await sleep(500);\n },\n },\n {\n title: i18n.t('optimize_parameter'),\n task: async (ctx) => {\n methodParameterToPathParameter(ctx.document);\n await sleep(500);\n },\n },\n {\n title: i18n.t('save_to_file'),\n task: async (ctx, task) => {\n const result = await saveToFile(ctx.document, config.saveToFile, config.fileMode);\n task.suffix =\n terminal.style(\n ['blue', 'underline'],\n path.relative(process.cwd(), result.dest),\n ) + terminal.style('green', ` [${result.size}]`);\n },\n },\n {\n title: i18n.t('validate'),\n task: async (ctx, task) => {\n const result = (ctx.validateResult = await validateOpenapi(ctx.document));\n await sleep(500);\n\n if (result.errors.length || result.warnings.length) {\n task.suffix = terminal.style(\n 'yellow',\n i18n.t('has_error', {\n error_count: result.errors.length,\n warning_count: result.warnings.length,\n }),\n );\n } else {\n task.suffix = terminal.style('green', i18n.t('no_error'));\n }\n },\n },\n ]);\n\n if (error) return null;\n\n const logSession = terminal.applySession();\n const { errors, warnings } = context.validateResult;\n for (const error of errors) {\n logSession.update(` :error: ${formatValidateMessage(error)}`);\n logSession.commit();\n }\n for (const warning of warnings) {\n logSession.update(` :warning: ${formatValidateMessage(warning)}`);\n logSession.commit();\n }\n\n return JSON.parse(JSON.stringify(context.document));\n};\n\nconst formatValidateMessage = (item: OpenapiValidateResultItem) => {\n let pathname = item.path.length ? item.path.join('.') : '';\n return `${terminal.style('gray', `[${pathname || '.'}]`)} ${item.message}`;\n};\n","import type { OpenAPI } from '@aomex/core';\nimport stoplight, { type RulesetDefinition } from '@stoplight/spectral-core';\nimport { oas } from '@stoplight/spectral-rulesets';\n\n// Inline package `@stoplight/types`\nenum DiagnosticSeverity {\n Error = 0,\n Warning = 1,\n Information = 2,\n Hint = 3,\n}\n\nconst spectral = new stoplight.Spectral();\nspectral.setRuleset({\n extends: oas as RulesetDefinition,\n // https://github.com/stoplightio/spectral/blob/develop/packages/rulesets/src/oas/index.ts\n rules: {\n 'info-contact': 'off',\n 'info-description': 'off',\n },\n});\n\nexport interface OpenapiValidateResultItem {\n path: string[];\n message: string;\n}\n\nexport interface OpenapiValidateResult {\n errors: OpenapiValidateResultItem[];\n warnings: OpenapiValidateResultItem[];\n}\n\nexport const validateOpenapi = async (document: OpenAPI.Document) => {\n const result: OpenapiValidateResult = {\n warnings: [],\n errors: [],\n };\n const originResult = await spectral.run(document as unknown as Record<string, unknown>);\n originResult.forEach((item) => {\n result[item.severity === DiagnosticSeverity.Error ? 'errors' : 'warnings'].push({\n path: item.path.map(String),\n message: item.message,\n });\n });\n return result;\n};\n","export const methods = <const>[\n 'get',\n 'post',\n 'put',\n 'patch',\n 'delete',\n 'options',\n 'head',\n 'trace',\n];\n","import type { OpenAPI } from '@aomex/core';\nimport { methods } from './methods';\n\n/**\n * 同一个路径下,所有方法都有相同的parameter时,可以往上提取,这样能减小生成产物\n */\nexport const methodParameterToPathParameter = (document: OpenAPI.Document) => {\n pathLoop: for (const path of Object.values(document.paths)) {\n const parametersHandler: Record<string, Function[]> = {};\n let methodCounter = 0;\n for (const method of methods) {\n const methodItem = path![method];\n if (!methodItem) continue;\n if (!methodItem.parameters?.length) continue pathLoop;\n ++methodCounter;\n methodItem.parameters.forEach((parameter, index, arr) => {\n const uniqueKey = JSON.stringify(parameter);\n // 确保是唯一的\n parameter = arr[index] = JSON.parse(uniqueKey);\n const handler = () => {\n arr.splice(\n arr.findIndex((item) => item === parameter),\n 1,\n );\n if (!arr.length) {\n delete methodItem.parameters;\n }\n };\n parametersHandler[uniqueKey] ||= [];\n parametersHandler[uniqueKey]!.push(handler);\n });\n }\n\n if (methodCounter < 2) continue pathLoop;\n\n Object.entries(parametersHandler).forEach(([uniqueKey, handlers]) => {\n if (handlers.length !== methodCounter) return;\n path!.parameters ||= [];\n path!.parameters.push(JSON.parse(uniqueKey));\n handlers.forEach((fn) => fn());\n });\n if (path!.parameters && !path!.parameters.length) {\n delete path!.parameters;\n }\n }\n};\n","import path from 'node:path';\nimport { mkdir, writeFile } from 'node:fs/promises';\nimport YAML from 'yaml';\nimport { bytes } from '@aomex/internal-tools';\nimport type { OpenAPI } from '@aomex/core';\nimport type { Mode } from 'node:fs';\n\nexport const saveToFile = async (\n document: OpenAPI.Document,\n filename?: string,\n fileMode?: Mode,\n) => {\n const dest = path.resolve(filename || 'openapi.json');\n const ext = path.extname(dest);\n const content =\n ext.endsWith('.yaml') || ext.endsWith('.yml')\n ? YAML.stringify(document)\n : JSON.stringify(document);\n const size = bytes(Buffer.byteLength(content), { unitSeparator: '' });\n\n await mkdir(path.dirname(dest), { recursive: true });\n await writeFile(dest, content, { mode: fileMode, flush: true });\n\n return { dest, size };\n};\n","import type { OpenAPI } from '@aomex/core';\nimport type { GenerateOpenapiOptions } from './generate-openapi';\nimport { readFile } from 'node:fs/promises';\nimport path from 'node:path';\n\nexport const initializeDocument = async (basic?: GenerateOpenapiOptions['docs']) => {\n const document: OpenAPI.Document = JSON.parse(JSON.stringify(basic || {}));\n document.openapi ||= '3.0.3';\n document.tags ||= [];\n document.info ||= { title: '', version: '' };\n document.paths = {};\n document.info.title ||= (await readPackageJson()).name || 'OpenAPI';\n document.info.version ||= (await readPackageJson()).version || '0.0.0';\n return document;\n};\n\nconst readPackageJson = async (): Promise<{ name?: string; version?: string }> => {\n try {\n const content = await readFile(path.resolve('package.json'), 'utf8');\n const json = JSON.parse(content);\n return json && typeof json === 'object' ? json : {};\n } catch {\n return {};\n }\n};\n","import type { OpenAPI } from '@aomex/core';\nimport { getFileValues } from '@aomex/internal-file-import';\nimport { Router, WebMiddleware, WebRequest, type OpenApiInjector } from '@aomex/web';\nimport path from 'node:path';\nimport { methodToVerb } from './method-to-verb';\nimport snakeCase from 'lodash.snakecase';\n\nexport const parseFiles = async (document: OpenAPI.Document, files: string[]) => {\n const usedTags: string[] = [];\n\n const data: {\n pathName: string;\n pathItem: OpenAPI.PathItemObject;\n methodName: `${Lowercase<WebRequest['method']>}`;\n methodItem: OpenAPI.OperationObject;\n injector: OpenApiInjector;\n file: string;\n uri: string;\n }[] = [];\n\n for (const file of files) {\n const routers = await getFileValues<Router>(\n [file],\n (item) => !!item && item instanceof Router,\n );\n\n for (const router of routers) {\n const groupMiddlewareList = router['middlewareList'];\n const builders = router['builders'];\n\n for (const builder of builders) {\n if (builder.docs.showInOpenapi === false) continue;\n delete builder.docs.showInOpenapi;\n\n const builderMiddlewareList = groupMiddlewareList\n .concat(builder['middlewareList'])\n .filter((middleware) => middleware instanceof WebMiddleware) as WebMiddleware[];\n\n const uri = builder['uri'];\n const pathName = normalizePath(uri);\n const pathItem: OpenAPI.PathItemObject = (document.paths[pathName] ||= {});\n\n for (const method of builder['methods']) {\n const methodName = method.toLowerCase() as `${Lowercase<WebRequest['method']>}`;\n const methodItem: OpenAPI.OperationObject = (pathItem[methodName] = {\n ...builder.docs,\n responses: {},\n });\n\n data.push(\n ...builderMiddlewareList.map((item) => {\n return {\n injector: item['openapi'](),\n pathItem,\n pathName,\n methodItem,\n methodName,\n file,\n uri,\n };\n }),\n );\n }\n }\n }\n }\n\n for (const { injector } of data) {\n injector.onDocument?.(document);\n }\n for (const { injector, pathItem, pathName } of data) {\n injector.onPath?.(pathItem, { document, pathName });\n }\n for (const { injector, pathItem, pathName, methodItem, methodName } of data) {\n injector.onMethod?.(methodItem, {\n document,\n pathItem,\n pathName,\n methodName,\n });\n }\n for (const { injector, pathItem, pathName, methodItem, methodName } of data) {\n injector.postMethod?.(methodItem, {\n document,\n pathItem,\n pathName,\n methodName,\n });\n }\n for (const { injector, pathItem, pathName } of data) {\n injector.postPath?.(pathItem, { document, pathName });\n }\n for (const { injector } of data) {\n injector.postDocument?.(document);\n }\n\n for (const { methodItem, methodName, file, uri } of data) {\n methodItem.tags ||= [getTagByFilename(file)];\n methodItem.operationId ||= snakeCase(\n methodToVerb(methodName, uri) + ' ' + uri.replaceAll(':', '_by_'),\n );\n\n if (methodName === 'post') {\n // @ts-expect-error 防止验证警告\n methodItem['x-codegen-request-body-name'] = 'body';\n }\n\n if (!Object.keys(methodItem.responses).length) {\n methodItem.responses = { default: { description: '' } };\n }\n\n usedTags.push(...methodItem.tags!);\n }\n\n return [...new Set(usedTags)];\n};\n\nconst normalizePath = (uri: string) => {\n return uri.replace(/:([a-z0-9_?]+)/gi, (_, $1) => {\n return `{${$1.replace(/[?]/g, '')}}`;\n });\n};\n\nconst getTagByFilename = (file: string) => {\n return path.basename(file).replace(/\\..+$/, '');\n};\n","export const methodToVerb = (method: string, uri: string) => {\n method = method.toLowerCase();\n\n if (method === 'get') return uri.includes(':') ? 'retrieve' : 'list';\n if (method === 'post') return 'create';\n if (method === 'put') return 'replace';\n if (method === 'patch') return 'update';\n return method;\n};\n","import type { OpenAPI } from '@aomex/core';\n\nexport const appendTag = (document: OpenAPI.Document, usedTags: string[]) => {\n const tags = (document.tags ||= []);\n const definedTags = tags.map((item) => item.name);\n const undefinedTags = usedTags.filter((tag) => !definedTags.includes(tag)).sort();\n\n for (const tag of undefinedTags) {\n tags.push({ name: tag });\n }\n\n return undefinedTags;\n};\n","import { I18n } from '@aomex/core';\nimport { locales } from './locales';\n\nexport const i18n = new I18n({\n resources: locales,\n defaultLanguage: 'zh_CN',\n});\n","import { I18n } from '@aomex/core';\n\nexport const zh = I18n.define({\n initialize: '初始化文档',\n search_routers_files: '搜索路由文件',\n parse_routers: '解析路由',\n add_tag: '增加标签',\n hand_fix_documentation: '手动修复文档',\n optimize_parameter: '优化参数',\n save_to_file: '保存到文件',\n validate: '验证文档',\n help_summary: 'openapi v3 文档生成器',\n has_error: '{{error_count}}条报错,{{warning_count}}条警告',\n no_error: '没有报错',\n});\n","import { I18n } from '@aomex/core';\nimport { zh } from './zh-cn';\n\nexport const en = I18n.satisfies(zh).define({\n initialize: 'initialize document',\n search_routers_files: 'search web routers files',\n parse_routers: 'parse routers',\n add_tag: 'append tags',\n hand_fix_documentation: 'fix documentation by manual',\n optimize_parameter: 'optimize parameters',\n save_to_file: 'save to file',\n validate: 'validate document',\n help_summary: 'openapi v3 documentation generator',\n has_error: '{{error_count}} errors, {{warning_count}} warnings',\n no_error: 'No errors',\n});\n","import { zh } from './zh-cn';\nimport { en } from './en-us';\n\nexport const locales = {\n zh_CN: zh,\n en_US: en,\n};\n","import { OpenAPI } from '@aomex/core';\nimport { pathToFiles, type GlobPathOptions } from '@aomex/internal-file-import';\nimport { methodParameterToPathParameter } from './hoist-parameter';\nimport { initializeDocument } from './initialize-document';\nimport { parseFiles } from './parse-files';\nimport { appendTag } from './append-tag';\n\nexport interface GenerateOpenapiOptions {\n /**\n * http接口路由文件\n */\n routers: GlobPathOptions;\n /**\n * Openapi基础信息\n */\n docs?: Omit<OpenAPI.Document, 'paths' | 'openapi' | 'info'> & {\n openapi?: `3.0.${0 | 1 | 2 | 3}`;\n info?: Partial<OpenAPI.Document['info']>;\n };\n /**\n * 手动修复文档内容\n */\n fix?: (data: OpenAPI.Document) => void | Promise<void>;\n}\n\n/**\n * 生成openapi文档\n */\nexport const generateOpenapi = async (\n config: GenerateOpenapiOptions,\n): Promise<OpenAPI.Document> => {\n const document = await initializeDocument(config.docs);\n const files = await pathToFiles(config.routers);\n const usedTags = await parseFiles(document, files);\n appendTag(document, usedTags);\n await config.fix?.(document);\n methodParameterToPathParameter(document);\n\n return JSON.parse(JSON.stringify(document));\n};\n"],"mappings":"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","names":["path","path","path","path","middleware","path","I18n","I18n","I18n","I18n","path","error","pathToFiles","pathToFiles"]}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@aomex/openapi",
|
|
3
|
-
"version": "3.2.
|
|
3
|
+
"version": "3.2.4",
|
|
4
4
|
"description": "Openapi文档生成工具",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"types": "dist/index.d.ts",
|
|
@@ -43,15 +43,15 @@
|
|
|
43
43
|
"@stoplight/spectral-rulesets": "^1.19.1",
|
|
44
44
|
"lodash.snakecase": "^4.1.1",
|
|
45
45
|
"yaml": "^2.4.5",
|
|
46
|
-
"@aomex/internal-file-import": "^3.2.
|
|
47
|
-
"@aomex/internal-tools": "^3.2.
|
|
46
|
+
"@aomex/internal-file-import": "^3.2.4",
|
|
47
|
+
"@aomex/internal-tools": "^3.2.4"
|
|
48
48
|
},
|
|
49
49
|
"devDependencies": {
|
|
50
50
|
"@types/lodash.snakecase": "^4.1.9",
|
|
51
51
|
"stat-mode": "^1.0.0",
|
|
52
|
-
"@aomex/console": "^3.2.
|
|
53
|
-
"@aomex/
|
|
54
|
-
"@aomex/
|
|
52
|
+
"@aomex/console": "^3.2.4",
|
|
53
|
+
"@aomex/web": "^3.2.4",
|
|
54
|
+
"@aomex/core": "^3.2.4"
|
|
55
55
|
},
|
|
56
56
|
"scripts": {}
|
|
57
57
|
}
|