@aomex/openapi 1.4.0 → 1.5.1
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 +20 -0
- package/dist/index.d.ts +41 -21
- package/dist/index.js +23 -7
- package/dist/index.js.map +1 -1
- package/package.json +7 -7
package/CHANGELOG.md
CHANGED
|
@@ -3,6 +3,26 @@
|
|
|
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
|
+
## [1.5.1](https://github.com/aomex/aomex/compare/v1.5.0...v1.5.1) (2024-07-04)
|
|
7
|
+
|
|
8
|
+
**Note:** Version bump only for package @aomex/openapi
|
|
9
|
+
|
|
10
|
+
|
|
11
|
+
|
|
12
|
+
|
|
13
|
+
|
|
14
|
+
# [1.5.0](https://github.com/aomex/aomex/compare/v1.4.0...v1.5.0) (2024-07-04)
|
|
15
|
+
|
|
16
|
+
|
|
17
|
+
### Features
|
|
18
|
+
|
|
19
|
+
* **openapi:** 增加generateOpenapi函数快速生成文档 ([b048aac](https://github.com/aomex/aomex/commit/b048aacc5ff8a21be499b2f3af42aa61f6209697))
|
|
20
|
+
* **router:** 路由增加文档属性 showInOpenapi ([cff6b01](https://github.com/aomex/aomex/commit/cff6b01834d1e5f3c07e1b9e2b903cf11138e51e))
|
|
21
|
+
|
|
22
|
+
|
|
23
|
+
|
|
24
|
+
|
|
25
|
+
|
|
6
26
|
# [1.4.0](https://github.com/aomex/aomex/compare/v1.3.0...v1.4.0) (2024-06-29)
|
|
7
27
|
|
|
8
28
|
|
package/dist/index.d.ts
CHANGED
|
@@ -3,11 +3,17 @@ import { Mode } from 'node:fs';
|
|
|
3
3
|
import { OpenAPI, I18nMessage } from '@aomex/core';
|
|
4
4
|
import { GlobPathOptions } from '@aomex/internal-file-import';
|
|
5
5
|
|
|
6
|
-
interface
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
6
|
+
interface OpenapiValidateResultItem {
|
|
7
|
+
path: string[];
|
|
8
|
+
message: string;
|
|
9
|
+
}
|
|
10
|
+
interface OpenapiValidateResult {
|
|
11
|
+
errors: OpenapiValidateResultItem[];
|
|
12
|
+
warnings: OpenapiValidateResultItem[];
|
|
13
|
+
}
|
|
14
|
+
declare const validateOpenapi: (document: OpenAPI.Document) => Promise<OpenapiValidateResult>;
|
|
15
|
+
|
|
16
|
+
interface GenerateOpenapiOptions {
|
|
11
17
|
/**
|
|
12
18
|
* http接口路由文件
|
|
13
19
|
*/
|
|
@@ -19,6 +25,19 @@ interface OpenapiOptions {
|
|
|
19
25
|
openapi?: `3.0.${0 | 1 | 2 | 3}`;
|
|
20
26
|
info?: Partial<OpenAPI.Document['info']>;
|
|
21
27
|
};
|
|
28
|
+
/**
|
|
29
|
+
* 手动修复文档内容
|
|
30
|
+
*/
|
|
31
|
+
fix?: (data: OpenAPI.Document) => void | Promise<void>;
|
|
32
|
+
}
|
|
33
|
+
/**
|
|
34
|
+
* 生成openapi文档
|
|
35
|
+
*/
|
|
36
|
+
declare const generateOpenapi: (config: GenerateOpenapiOptions) => Promise<{
|
|
37
|
+
document: OpenAPI.Document;
|
|
38
|
+
} & OpenapiValidateResult>;
|
|
39
|
+
|
|
40
|
+
interface GenerateOpenapiWithSpinnerOptions extends GenerateOpenapiOptions {
|
|
22
41
|
/**
|
|
23
42
|
* 保存到指定文件。默认值:`openapi.json`
|
|
24
43
|
* - `*.json` 保存为JSON格式
|
|
@@ -30,13 +49,24 @@ interface OpenapiOptions {
|
|
|
30
49
|
* 设置保存文件的系统权限。
|
|
31
50
|
*/
|
|
32
51
|
fileMode?: Mode;
|
|
52
|
+
}
|
|
53
|
+
/**
|
|
54
|
+
* 1. 生成openapi文档
|
|
55
|
+
* 2. 保存文档到文件
|
|
56
|
+
* 3. 验证
|
|
57
|
+
* 4. 控制台输出执行步骤和验证结果
|
|
58
|
+
*
|
|
59
|
+
* 如果是主动调用,则应使用 generateOpenapi()
|
|
60
|
+
* @see generateOpenapi
|
|
61
|
+
*/
|
|
62
|
+
declare const generateOpenapiWithSpinner: (config: GenerateOpenapiWithSpinnerOptions) => Promise<OpenAPI.Document>;
|
|
63
|
+
|
|
64
|
+
interface OpenapiOptions extends GenerateOpenapiWithSpinnerOptions {
|
|
33
65
|
/**
|
|
34
|
-
*
|
|
66
|
+
* 指令名称。默认值:`openapi`
|
|
35
67
|
*/
|
|
36
|
-
|
|
68
|
+
commandName?: string;
|
|
37
69
|
}
|
|
38
|
-
declare const generateDocument: (config: OpenapiOptions) => Promise<OpenAPI.Document>;
|
|
39
|
-
|
|
40
70
|
declare const openapi: (options: OpenapiOptions) => ConsoleMiddleware;
|
|
41
71
|
|
|
42
72
|
declare module '@aomex/core' {
|
|
@@ -62,7 +92,7 @@ declare module '@aomex/core' {
|
|
|
62
92
|
}
|
|
63
93
|
}
|
|
64
94
|
|
|
65
|
-
declare const initializeDocument: (basic?:
|
|
95
|
+
declare const initializeDocument: (basic?: GenerateOpenapiOptions['docs']) => Promise<OpenAPI.Document<{}>>;
|
|
66
96
|
|
|
67
97
|
/**
|
|
68
98
|
* 同一个路径下,所有方法都有相同的parameter时,可以往上提取,这样能减小生成产物
|
|
@@ -80,14 +110,4 @@ declare const saveToFile: (document: OpenAPI.Document, filename?: string, fileMo
|
|
|
80
110
|
size: string;
|
|
81
111
|
}>;
|
|
82
112
|
|
|
83
|
-
|
|
84
|
-
path: string[];
|
|
85
|
-
message: string;
|
|
86
|
-
}
|
|
87
|
-
interface OpenapiValidateResult {
|
|
88
|
-
errors: OpenapiValidateResultItem[];
|
|
89
|
-
warnings: OpenapiValidateResultItem[];
|
|
90
|
-
}
|
|
91
|
-
declare const validateOpenapi: (document: OpenAPI.Document) => Promise<OpenapiValidateResult>;
|
|
92
|
-
|
|
93
|
-
export { type OpenapiOptions, type OpenapiValidateResult, type OpenapiValidateResultItem, generateDocument, initializeDocument, methodParameterToPathParameter, methodToVerb, methods, openapi, parseFiles, saveToFile, validateOpenapi };
|
|
113
|
+
export { type GenerateOpenapiOptions, type GenerateOpenapiWithSpinnerOptions, type OpenapiOptions, type OpenapiValidateResult, type OpenapiValidateResultItem, generateOpenapi, generateOpenapiWithSpinner, initializeDocument, methodParameterToPathParameter, methodToVerb, methods, openapi, parseFiles, saveToFile, validateOpenapi };
|
package/dist/index.js
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
// src/openapi.ts
|
|
2
2
|
import { i18n as i18n2, middleware } from "@aomex/core";
|
|
3
3
|
|
|
4
|
-
// src/lib/generate-document.ts
|
|
4
|
+
// src/lib/generate-document-with-spinner.ts
|
|
5
5
|
import { i18n } from "@aomex/core";
|
|
6
6
|
import { sleep } from "@aomex/internal-tools";
|
|
7
7
|
import { pathToFiles } from "@aomex/internal-file-import";
|
|
@@ -122,7 +122,7 @@ var readPackageJson = async () => {
|
|
|
122
122
|
}
|
|
123
123
|
};
|
|
124
124
|
|
|
125
|
-
// src/lib/generate-document.ts
|
|
125
|
+
// src/lib/generate-document-with-spinner.ts
|
|
126
126
|
import { Listr } from "listr2";
|
|
127
127
|
|
|
128
128
|
// src/lib/parse-files.ts
|
|
@@ -156,6 +156,8 @@ var parseFiles = async (document, files) => {
|
|
|
156
156
|
const groupMiddlewareList = router["middlewareList"];
|
|
157
157
|
const builders = router["builders"];
|
|
158
158
|
for (const builder of builders) {
|
|
159
|
+
if (builder.docs.showInOpenapi === false) continue;
|
|
160
|
+
delete builder.docs.showInOpenapi;
|
|
159
161
|
const builderMiddlewareList = groupMiddlewareList.concat(builder["middlewareList"]).filter((middleware2) => middleware2 instanceof WebMiddleware);
|
|
160
162
|
for (const uri of builder["uris"]) {
|
|
161
163
|
const pathName = normalizePath(uri);
|
|
@@ -236,7 +238,7 @@ var getTagByFilename = (file) => {
|
|
|
236
238
|
return path3.basename(file).replace(/\..+$/, "");
|
|
237
239
|
};
|
|
238
240
|
|
|
239
|
-
// src/lib/generate-document.ts
|
|
241
|
+
// src/lib/generate-document-with-spinner.ts
|
|
240
242
|
import logSymbols from "log-symbols";
|
|
241
243
|
|
|
242
244
|
// src/lib/append-tag.ts
|
|
@@ -250,9 +252,9 @@ var appendTag = (document, usedTags) => {
|
|
|
250
252
|
return undefinedTags;
|
|
251
253
|
};
|
|
252
254
|
|
|
253
|
-
// src/lib/generate-document.ts
|
|
255
|
+
// src/lib/generate-document-with-spinner.ts
|
|
254
256
|
import { styleText } from "node:util";
|
|
255
|
-
var
|
|
257
|
+
var generateOpenapiWithSpinner = async (config) => {
|
|
256
258
|
const spinner = new Listr([], { concurrent: false, exitOnError: true });
|
|
257
259
|
spinner.add({
|
|
258
260
|
title: i18n.t("openapi.initialize"),
|
|
@@ -347,7 +349,7 @@ var openapi = (options) => {
|
|
|
347
349
|
fn: async (ctx, next) => {
|
|
348
350
|
if (ctx.input.command !== commandName) return next();
|
|
349
351
|
ctx.commandMatched = true;
|
|
350
|
-
await
|
|
352
|
+
await generateOpenapiWithSpinner(options);
|
|
351
353
|
},
|
|
352
354
|
help: {
|
|
353
355
|
onDocument(doc) {
|
|
@@ -388,8 +390,22 @@ i18n4.register("en_US", "openapi", {
|
|
|
388
390
|
has_error: "{{error_count}} errors, {{warning_count}} warnings",
|
|
389
391
|
no_error: "No errors"
|
|
390
392
|
});
|
|
393
|
+
|
|
394
|
+
// src/lib/generate-openapi.ts
|
|
395
|
+
import "@aomex/core";
|
|
396
|
+
import { pathToFiles as pathToFiles2 } from "@aomex/internal-file-import";
|
|
397
|
+
var generateOpenapi = async (config) => {
|
|
398
|
+
const document = await initializeDocument(config.docs);
|
|
399
|
+
const files = await pathToFiles2(config.routers);
|
|
400
|
+
const usedTags = await parseFiles(document, files);
|
|
401
|
+
appendTag(document, usedTags);
|
|
402
|
+
await config.fix?.(document);
|
|
403
|
+
methodParameterToPathParameter(document);
|
|
404
|
+
return JSON.parse(JSON.stringify(document));
|
|
405
|
+
};
|
|
391
406
|
export {
|
|
392
|
-
|
|
407
|
+
generateOpenapi,
|
|
408
|
+
generateOpenapiWithSpinner,
|
|
393
409
|
initializeDocument,
|
|
394
410
|
methodParameterToPathParameter,
|
|
395
411
|
methodToVerb,
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/openapi.ts","../src/lib/generate-document.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"],"sourcesContent":["import { i18n, middleware } from '@aomex/core';\nimport type { ConsoleMiddleware } from '@aomex/console';\nimport { generateDocument, type OpenapiOptions } from './lib/generate-document';\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 generateDocument(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, type GlobPathOptions } 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 { Listr } from 'listr2';\nimport { parseFiles } from './parse-files';\nimport logSymbols from 'log-symbols';\nimport { appendTag } from './append-tag';\nimport { styleText } from 'node:util';\n\nexport interface OpenapiOptions {\n /**\n * 指令名称。默认值:`openapi`\n */\n commandName?: string;\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 * 保存到指定文件。默认值:`openapi.json`\n * - `*.json` 保存为JSON格式\n * - `*.yml` 保存为YAML格式\n * - `*.yaml` 保存为YAML格式\n */\n saveToFile?: string;\n /**\n * 设置保存文件的系统权限。\n */\n fileMode?: Mode;\n /**\n * 手动修复文档内容\n */\n fix?: (data: OpenAPI.Document) => void | Promise<void>;\n}\n\ninterface SpinnerContext {\n document: OpenAPI.Document;\n files: string[];\n usedTags: string[];\n validateResult: OpenapiValidateResult;\n}\n\nexport const generateDocument = async (\n config: OpenapiOptions,\n): Promise<OpenAPI.Document> => {\n const spinner = new Listr<SpinnerContext>([], { concurrent: false, exitOnError: true });\n\n spinner.add({\n title: i18n.t('openapi.initialize'),\n task: async (ctx) => {\n ctx.document = await initializeDocument(config.docs);\n },\n });\n\n spinner.add({\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 spinner.add({\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 spinner.add({\n title: i18n.t('openapi.add_tag'),\n task: (ctx, task) => {\n const undefinedTags = appendTag(ctx.document, ctx.usedTags);\n if (undefinedTags.length) {\n task.title += ' ' + styleText('gray', undefinedTags.join(','));\n } else {\n task.skip();\n }\n },\n });\n\n spinner.add({\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 spinner.add({\n title: i18n.t('openapi.optimize_parameter'),\n task: async (ctx) => {\n methodParameterToPathParameter(ctx.document);\n await sleep(500);\n },\n });\n\n spinner.add({\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.title +=\n ' ' +\n styleText(['blue', 'underline'], path.relative(process.cwd(), result.dest)) +\n styleText('green', ` [${result.size}]`);\n },\n });\n\n spinner.add({\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.title +=\n ' ' +\n styleText(\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.title += ' ' + styleText('green', i18n.t('openapi.no_error'));\n }\n },\n });\n\n const context = await spinner.run({} as SpinnerContext);\n\n const { errors, warnings } = context.validateResult;\n for (const error of errors) {\n console.log(` ${logSymbols.error} ${formatValidateMessage(error)}`);\n }\n for (const warning of warnings) {\n console.log(` ${logSymbols.warning} ${formatValidateMessage(warning)}`);\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 `${styleText('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 content = ['.yml', '.yaml'].includes(path.extname(dest))\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 { OpenapiOptions } from './generate-document';\nimport { readFile } from 'node:fs/promises';\nimport path from 'node:path';\n\nexport const initializeDocument = async (basic?: OpenapiOptions['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 } from '@aomex/router';\nimport { 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 const builderMiddlewareList = groupMiddlewareList\n .concat(builder['middlewareList'])\n .filter((middleware) => middleware instanceof WebMiddleware) as WebMiddleware[];\n\n for (const uri of builder['uris']) {\n const pathName = normalizePath(uri);\n const pathItem: OpenAPI.PathItemObject = (document.paths[pathName] ||= {});\n\n for (const method of builder['methods']) {\n const methodName =\n 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\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"],"mappings":"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","names":["i18n","path","path","path","path","middleware","path","path","i18n","i18n","i18n"]}
|
|
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 { Listr } from 'listr2';\nimport { parseFiles } from './parse-files';\nimport logSymbols from 'log-symbols';\nimport { appendTag } from './append-tag';\nimport { styleText } from 'node:util';\nimport type { GenerateOpenapiOptions } from './generate-openapi';\n\nexport interface GenerateOpenapiWithSpinnerOptions extends GenerateOpenapiOptions {\n /**\n * 保存到指定文件。默认值:`openapi.json`\n * - `*.json` 保存为JSON格式\n * - `*.yml` 保存为YAML格式\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> => {\n const spinner = new Listr<SpinnerContext>([], { concurrent: false, exitOnError: true });\n\n spinner.add({\n title: i18n.t('openapi.initialize'),\n task: async (ctx) => {\n ctx.document = await initializeDocument(config.docs);\n },\n });\n\n spinner.add({\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 spinner.add({\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 spinner.add({\n title: i18n.t('openapi.add_tag'),\n task: (ctx, task) => {\n const undefinedTags = appendTag(ctx.document, ctx.usedTags);\n if (undefinedTags.length) {\n task.title += ' ' + styleText('gray', undefinedTags.join(','));\n } else {\n task.skip();\n }\n },\n });\n\n spinner.add({\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 spinner.add({\n title: i18n.t('openapi.optimize_parameter'),\n task: async (ctx) => {\n methodParameterToPathParameter(ctx.document);\n await sleep(500);\n },\n });\n\n spinner.add({\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.title +=\n ' ' +\n styleText(['blue', 'underline'], path.relative(process.cwd(), result.dest)) +\n styleText('green', ` [${result.size}]`);\n },\n });\n\n spinner.add({\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.title +=\n ' ' +\n styleText(\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.title += ' ' + styleText('green', i18n.t('openapi.no_error'));\n }\n },\n });\n\n const context = await spinner.run({} as SpinnerContext);\n\n const { errors, warnings } = context.validateResult;\n for (const error of errors) {\n console.log(` ${logSymbols.error} ${formatValidateMessage(error)}`);\n }\n for (const warning of warnings) {\n console.log(` ${logSymbols.warning} ${formatValidateMessage(warning)}`);\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 `${styleText('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 content = ['.yml', '.yaml'].includes(path.extname(dest))\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 } from '@aomex/router';\nimport { 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 for (const uri of builder['uris']) {\n const pathName = normalizePath(uri);\n const pathItem: OpenAPI.PathItemObject = (document.paths[pathName] ||= {});\n\n for (const method of builder['methods']) {\n const methodName =\n 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\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 { type OpenapiValidateResult } from './validate-openapi';\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<{ document: OpenAPI.Document } & OpenapiValidateResult> => {\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":["i18n","path","path","path","path","middleware","path","path","i18n","i18n","i18n","pathToFiles","pathToFiles"]}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@aomex/openapi",
|
|
3
|
-
"version": "1.
|
|
3
|
+
"version": "1.5.1",
|
|
4
4
|
"description": "Openapi文档生成工具",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"types": "dist/index.d.ts",
|
|
@@ -41,16 +41,16 @@
|
|
|
41
41
|
"lodash.snakecase": "^4.1.1",
|
|
42
42
|
"log-symbols": "^6.0.0",
|
|
43
43
|
"yaml": "^2.4.5",
|
|
44
|
-
"@aomex/internal-file-import": "^1.
|
|
45
|
-
"@aomex/internal-tools": "^1.
|
|
44
|
+
"@aomex/internal-file-import": "^1.5.1",
|
|
45
|
+
"@aomex/internal-tools": "^1.5.1"
|
|
46
46
|
},
|
|
47
47
|
"devDependencies": {
|
|
48
48
|
"@types/lodash.snakecase": "^4.1.9",
|
|
49
49
|
"stat-mode": "^1.0.0",
|
|
50
|
-
"@aomex/console": "^1.
|
|
51
|
-
"@aomex/
|
|
52
|
-
"@aomex/
|
|
53
|
-
"@aomex/
|
|
50
|
+
"@aomex/console": "^1.5.1",
|
|
51
|
+
"@aomex/router": "^1.5.1",
|
|
52
|
+
"@aomex/web": "^1.5.1",
|
|
53
|
+
"@aomex/core": "^1.5.1"
|
|
54
54
|
},
|
|
55
55
|
"scripts": {}
|
|
56
56
|
}
|