@aomex/openapi 1.2.0 → 1.4.0
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 +22 -0
- package/README.md +3 -0
- package/dist/index.d.ts +4 -0
- package/dist/index.js +3 -3
- package/dist/index.js.map +1 -1
- package/package.json +10 -7
package/CHANGELOG.md
CHANGED
|
@@ -3,6 +3,28 @@
|
|
|
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.4.0](https://github.com/aomex/aomex/compare/v1.3.0...v1.4.0) (2024-06-29)
|
|
7
|
+
|
|
8
|
+
|
|
9
|
+
### Features
|
|
10
|
+
|
|
11
|
+
* **openapi:** 允许自定义指令名称 ([3b3a81b](https://github.com/aomex/aomex/commit/3b3a81b97f2b843810bb5bb8d2be58ee4175e398))
|
|
12
|
+
|
|
13
|
+
|
|
14
|
+
|
|
15
|
+
|
|
16
|
+
|
|
17
|
+
# [1.3.0](https://github.com/aomex/aomex/compare/v1.2.0...v1.3.0) (2024-06-28)
|
|
18
|
+
|
|
19
|
+
|
|
20
|
+
### Features
|
|
21
|
+
|
|
22
|
+
* **core:** 删除中间件链条概念 ([12f42e6](https://github.com/aomex/aomex/commit/12f42e6ba15f3118b98f5ff31832121b1b2b9896))
|
|
23
|
+
|
|
24
|
+
|
|
25
|
+
|
|
26
|
+
|
|
27
|
+
|
|
6
28
|
# [1.2.0](https://github.com/aomex/aomex/compare/v1.1.0...v1.2.0) (2024-06-27)
|
|
7
29
|
|
|
8
30
|
**Note:** Version bump only for package @aomex/openapi
|
package/README.md
ADDED
package/dist/index.d.ts
CHANGED
package/dist/index.js
CHANGED
|
@@ -126,7 +126,7 @@ var readPackageJson = async () => {
|
|
|
126
126
|
import { Listr } from "listr2";
|
|
127
127
|
|
|
128
128
|
// src/lib/parse-files.ts
|
|
129
|
-
import
|
|
129
|
+
import "@aomex/core";
|
|
130
130
|
import { getFileValues } from "@aomex/internal-file-import";
|
|
131
131
|
import { Router } from "@aomex/router";
|
|
132
132
|
import { WebMiddleware } from "@aomex/web";
|
|
@@ -153,7 +153,7 @@ var parseFiles = async (document, files) => {
|
|
|
153
153
|
(item) => !!item && item instanceof Router
|
|
154
154
|
);
|
|
155
155
|
for (const router of routers) {
|
|
156
|
-
const groupMiddlewareList =
|
|
156
|
+
const groupMiddlewareList = router["middlewareList"];
|
|
157
157
|
const builders = router["builders"];
|
|
158
158
|
for (const builder of builders) {
|
|
159
159
|
const builderMiddlewareList = groupMiddlewareList.concat(builder["middlewareList"]).filter((middleware2) => middleware2 instanceof WebMiddleware);
|
|
@@ -341,8 +341,8 @@ var formatValidateMessage = (item) => {
|
|
|
341
341
|
};
|
|
342
342
|
|
|
343
343
|
// src/openapi.ts
|
|
344
|
-
var commandName = "openapi";
|
|
345
344
|
var openapi = (options) => {
|
|
345
|
+
const { commandName = "openapi" } = options;
|
|
346
346
|
return middleware.console({
|
|
347
347
|
fn: async (ctx, next) => {
|
|
348
348
|
if (ctx.input.command !== commandName) return next();
|
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\nconst commandName = 'openapi';\n\nexport const openapi = (options: OpenapiOptions): ConsoleMiddleware => {\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 * 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 { flattenMiddlewareToken, 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 = flattenMiddlewareToken(router['middlewareChain']);\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.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"]}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@aomex/openapi",
|
|
3
|
-
"version": "1.
|
|
3
|
+
"version": "1.4.0",
|
|
4
4
|
"description": "Openapi文档生成工具",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"types": "dist/index.d.ts",
|
|
@@ -25,6 +25,9 @@
|
|
|
25
25
|
"repository": "git@github.com:aomex/aomex.git",
|
|
26
26
|
"homepage": "https://aomex.js.org",
|
|
27
27
|
"license": "MIT",
|
|
28
|
+
"engines": {
|
|
29
|
+
"node": "^20.13.0 || ^22"
|
|
30
|
+
},
|
|
28
31
|
"peerDependencies": {
|
|
29
32
|
"@aomex/console": "^1.0.0",
|
|
30
33
|
"@aomex/core": "^1.0.0",
|
|
@@ -38,16 +41,16 @@
|
|
|
38
41
|
"lodash.snakecase": "^4.1.1",
|
|
39
42
|
"log-symbols": "^6.0.0",
|
|
40
43
|
"yaml": "^2.4.5",
|
|
41
|
-
"@aomex/internal-file-import": "^1.
|
|
42
|
-
"@aomex/internal-tools": "^1.
|
|
44
|
+
"@aomex/internal-file-import": "^1.4.0",
|
|
45
|
+
"@aomex/internal-tools": "^1.4.0"
|
|
43
46
|
},
|
|
44
47
|
"devDependencies": {
|
|
45
48
|
"@types/lodash.snakecase": "^4.1.9",
|
|
46
49
|
"stat-mode": "^1.0.0",
|
|
47
|
-
"@aomex/console": "^1.
|
|
48
|
-
"@aomex/core": "^1.
|
|
49
|
-
"@aomex/router": "^1.
|
|
50
|
-
"@aomex/web": "^1.
|
|
50
|
+
"@aomex/console": "^1.4.0",
|
|
51
|
+
"@aomex/core": "^1.4.0",
|
|
52
|
+
"@aomex/router": "^1.4.0",
|
|
53
|
+
"@aomex/web": "^1.4.0"
|
|
51
54
|
},
|
|
52
55
|
"scripts": {}
|
|
53
56
|
}
|