@aomex/openapi 3.30.8-alpha.7326d75.0 → 4.0.1-alpha.185683a.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 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
+ # [4.0.0](https://github.com/aomex/aomex/compare/v3.30.7...v4.0.0) (2026-11-17)
7
+
8
+ * chore!: 升级依赖至最新 ([9a679fa](https://github.com/aomex/aomex/commit/9a679faf0a4e2b313e8ce9081c1ecc65356b844c))
9
+ * chore!: 升级至 TypeScript 7 并将构建工具迁移到 tsdown ([a111409](https://github.com/aomex/aomex/commit/a111409021e2ee81ee5fb20ccc75480c9b5fa4c0))
10
+
11
+ ### Bug Fixes
12
+
13
+ * **openapi:** 生成文档时webapp必填 ([189eedd](https://github.com/aomex/aomex/commit/189eedd863a6f0567694f4216d330af687e71ea2))
14
+
15
+ ### Features
16
+
17
+ * **openapi:** generateOpenapi 支持挂载 Web 全局中间件 ([3310e3e](https://github.com/aomex/aomex/commit/3310e3eb75e88ad31c6658337ff3f84ce4c4a1f2))
18
+ * **openapi:** 将 schema 提升为 components 中的 $ref ([5ab3757](https://github.com/aomex/aomex/commit/5ab37579b795b27bf29d860b667a7ae2ddd623b7))
19
+ * **validator:** 验证器规则入口支持传入schema ([7f0be2e](https://github.com/aomex/aomex/commit/7f0be2e027ad8e527989850ca331cde1d31830e0))
20
+
21
+ ### BREAKING CHANGES
22
+
23
+ * mongoose 最低版本为v9
24
+ * Node.js 最低版本提升至 `>=24.0.0`。
25
+ * 最低 TypeScript 版本为 7。
26
+
27
+
6
28
  ## [3.30.7](https://github.com/aomex/aomex/compare/v3.30.6...v3.30.7) (2026-11-01)
7
29
 
8
30
  **Note:** Version bump only for package @aomex/openapi
package/dist/index.d.ts CHANGED
@@ -1,6 +1,6 @@
1
1
  import { OpenAPI } from "@aomex/common";
2
2
  import { GlobPathOptions } from "@aomex/internal-file-import";
3
- import { EnvelopeOptions, WebApp, WebMiddlewareToken } from "@aomex/web";
3
+ import { WebApp, WebMiddlewareToken } from "@aomex/web";
4
4
  import { ConsoleMiddleware } from "@aomex/console";
5
5
  import { Mode } from "node:fs";
6
6
  export interface GenerateOpenapiOptions {
@@ -9,7 +9,8 @@ export interface GenerateOpenapiOptions {
9
9
  */
10
10
  routers: GlobPathOptions;
11
11
  /**
12
- * `WebApp` 实例:读取全局 `mount` 与 `envelope`,作为 OpenAPI 注入的单一真源。
12
+ * `WebApp` 实例:读取全局 `middlewareList`(含用户 `mount` 与自动插入的 envelope),
13
+ * 作为 OpenAPI 注入的单一真源。
13
14
  *
14
15
  * CLI / 测试会 `import` 该模块时,请把 `new WebApp(...)` 与 `app.listen(...)` 拆开
15
16
  *(或仅在入口文件 listen),避免副作用起服。
@@ -113,10 +114,8 @@ export declare const hoistSchemaRef: (document: OpenAPI.Document) => void;
113
114
  export declare const methodToVerb: (method: string, uri: string) => string;
114
115
  export declare const methods: readonly ['get', 'post', 'put', 'patch', 'delete', 'options', 'head', 'trace'];
115
116
  export interface ParseFilesOptions {
116
- /** 全局中间件(与 `WebApp` 的 `mount` 对应) */
117
+ /** 全局中间件(与 `WebApp` 的 `mount` / 自动插入的 envelope 对应) */
117
118
  mount?: WebMiddlewareToken[];
118
- /** 响应体套壳(与 `WebApp.envelope` 对应);在全部中间件 `postMethod` 之后收口 */
119
- envelope?: EnvelopeOptions;
120
119
  }
121
120
  export declare const parseFiles: (document: OpenAPI.Document, files: string[], options?: ParseFilesOptions) => Promise<string[]>;
122
121
  export declare const saveToFile: (document: OpenAPI.Document, filename?: string, fileMode?: Mode) => Promise<{
package/dist/index.js CHANGED
@@ -5,7 +5,7 @@ import path from "node:path";
5
5
  import { mkdir, readFile, writeFile } from "node:fs/promises";
6
6
  import YAML from "yaml";
7
7
  import { bytes } from "@aomex/internal-tools";
8
- import { Router, WebMiddleware, createEnvelopeOpenApiInjector } from "@aomex/web";
8
+ import { Router, WebMiddleware, X_SKIP_ENVELOPE } from "@aomex/web";
9
9
  import snakeCase from "lodash.snakecase";
10
10
  import { terminal } from "@aomex/console";
11
11
  // \0rolldown/runtime.js
@@ -224,10 +224,8 @@ const methodToVerb = (method, uri) => {
224
224
  // src/lib/parse-files.ts
225
225
  const parseFiles = async (document, files, options = {}) => {
226
226
  const mount = options.mount ?? [];
227
- const envelopeInjector = options.envelope ? createEnvelopeOpenApiInjector(options.envelope) : void 0;
228
227
  const usedTags = [];
229
- const data = [];
230
- /** 每个 operation 只出现一次,供 envelope 收口与标签补齐 */
228
+ /** 每个 operation 及其中间件 injector(顺序与运行时一致:全局 → 组 → 接口) */
231
229
  const operations = [];
232
230
  for (const file of files) {
233
231
  const routers = await getFileValues([file], (item) => !!item && item instanceof Router);
@@ -252,52 +250,37 @@ const parseFiles = async (document, files, options = {}) => {
252
250
  pathName,
253
251
  methodItem,
254
252
  methodName,
253
+ injectors: builderMiddlewareList.map((item) => item["openapi"]()),
255
254
  file,
256
255
  uri
257
256
  });
258
- data.push(...builderMiddlewareList.map((item) => {
259
- return {
260
- injector: item["openapi"](),
261
- pathItem,
262
- pathName,
263
- methodItem,
264
- methodName,
265
- file,
266
- uri
267
- };
268
- }));
269
257
  }
270
258
  }
271
259
  }
272
260
  }
273
- for (const { injector } of data) injector.onDocument?.(document);
274
- for (const { injector, pathItem, pathName } of data) injector.onPath?.(pathItem, {
261
+ for (const { injectors } of operations) for (const injector of injectors) injector.onDocument?.(document);
262
+ for (const { injectors, pathItem, pathName } of operations) for (const injector of injectors) injector.onPath?.(pathItem, {
275
263
  document,
276
264
  pathName
277
265
  });
278
- for (const { injector, pathItem, pathName, methodItem, methodName } of data) injector.onMethod?.(methodItem, {
266
+ for (const { injectors, pathItem, pathName, methodItem, methodName } of operations) for (const injector of injectors) injector.onMethod?.(methodItem, {
279
267
  document,
280
268
  pathItem,
281
269
  pathName,
282
270
  methodName
283
271
  });
284
- for (const { injector, pathItem, pathName, methodItem, methodName } of data) injector.postMethod?.(methodItem, {
272
+ for (const { injectors, pathItem, pathName, methodItem, methodName } of operations) for (let i = injectors.length - 1; i >= 0; i--) injectors[i].postMethod?.(methodItem, {
285
273
  document,
286
274
  pathItem,
287
275
  pathName,
288
276
  methodName
289
277
  });
290
- if (envelopeInjector?.postMethod) for (const { pathItem, pathName, methodItem, methodName } of operations) envelopeInjector.postMethod(methodItem, {
291
- document,
292
- pathItem,
293
- pathName,
294
- methodName
295
- });
296
- for (const { injector, pathItem, pathName } of data) injector.postPath?.(pathItem, {
278
+ for (const { methodItem } of operations) delete methodItem[X_SKIP_ENVELOPE];
279
+ for (const { injectors, pathItem, pathName } of operations) for (let i = injectors.length - 1; i >= 0; i--) injectors[i].postPath?.(pathItem, {
297
280
  document,
298
281
  pathName
299
282
  });
300
- for (const { injector } of data) injector.postDocument?.(document);
283
+ for (const { injectors } of operations) for (let i = injectors.length - 1; i >= 0; i--) injectors[i].postDocument?.(document);
301
284
  for (const { methodItem, methodName, file, uri } of operations) {
302
285
  methodItem.tags ||= [getTagByFilename(file)];
303
286
  methodItem.operationId ||= snakeCase(methodToVerb(methodName, uri) + " " + uri.replaceAll(":", "_by_"));
@@ -388,10 +371,7 @@ const generateOpenapiWithSpinner = async (config) => {
388
371
  title: i18n.t("parse_routers"),
389
372
  task: async (ctx) => {
390
373
  const app = config.app;
391
- ctx.usedTags = await parseFiles(ctx.document, ctx.files, {
392
- mount: app?.["middlewareList"],
393
- envelope: app?.["options"].envelope
394
- });
374
+ ctx.usedTags = await parseFiles(ctx.document, ctx.files, { mount: app?.["middlewareList"] });
395
375
  await (0, import_cjs.default)(500);
396
376
  }
397
377
  },
@@ -503,10 +483,7 @@ const generateOpenapi = async (config) => {
503
483
  const document = await initializeDocument(config.docs);
504
484
  const files = await pathToFiles(config.routers);
505
485
  const app = config.app;
506
- const usedTags = await parseFiles(document, files, {
507
- mount: app["middlewareList"],
508
- envelope: app["options"].envelope
509
- });
486
+ const usedTags = await parseFiles(document, files, { mount: app["middlewareList"] });
510
487
  appendTag(document, usedTags);
511
488
  await config.fix?.(document);
512
489
  hoistSchemaRef(document);
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","names":["sleep"],"sources":["../../../node_modules/.pnpm/sleep-promise@9.1.0/node_modules/sleep-promise/build/cjs.js","../src/lib/validate-openapi.ts","../src/lib/methods.ts","../src/lib/hoist-parameter.ts","../src/lib/hoist-schema-ref.ts","../src/lib/save-to-file.ts","../src/lib/initialize-document.ts","../src/lib/method-to-verb.ts","../src/lib/parse-files.ts","../src/lib/append-tag.ts","../src/i18n/locales/zh-cn.ts","../src/i18n/locales/en-us.ts","../src/i18n/index.ts","../src/lib/generate-document-with-spinner.ts","../src/openapi.ts","../src/lib/generate-openapi.ts"],"sourcesContent":["\"use strict\";var e=setTimeout;function t(t,n){var u=n.useCachedSetTimeout?e:setTimeout;return new Promise((function(e){u(e,t)}))}module.exports=function(e){var n=arguments.length>1&&void 0!==arguments[1]?arguments[1]:{},u=n.useCachedSetTimeout,r=t(e,{useCachedSetTimeout:u});function o(e){return r.then((function(){return e}))}return o.then=function(){return r.then.apply(r,arguments)},o.catch=Promise.resolve().catch,o};\n","import type { OpenAPI } from '@aomex/common';\nimport type spectral from '@stoplight/spectral-core';\nimport type ruleset from '@stoplight/spectral-rulesets';\nimport { createRequire } from 'node:module';\n\nconst requireCJS = createRequire(import.meta.url);\n\n// Inline package `@stoplight/types`\nenum DiagnosticSeverity {\n Error = 0,\n Warning = 1,\n Information = 2,\n Hint = 3,\n}\n\nlet _spectral: spectral.Spectral | null = null;\nconst initSpectral = () => {\n if (!_spectral) {\n // 直接顶级import导致node启动时间慢100ms+\n const { Spectral } = requireCJS('@stoplight/spectral-core') as typeof spectral;\n const { oas } = requireCJS('@stoplight/spectral-rulesets') as typeof ruleset;\n _spectral = new Spectral();\n _spectral.setRuleset({\n extends: oas as spectral.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 }\n return _spectral;\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 = { warnings: [], errors: [] };\n const spectral = initSpectral();\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/common';\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 type { OpenAPI } from '@aomex/common';\n\n/**\n * 识别 schema 上的 `x-ref`,提取到 `components.schemas`,并替换为 `$ref`。\n * 自底向上处理,保证嵌套 object 先变成 `$ref` 再被父级收录。\n */\nexport const hoistSchemaRef = (document: OpenAPI.Document) => {\n document.components ||= {};\n document.components.schemas ||= {};\n const seen = new Map<string, string>();\n\n const resolveName = (base: string, canonical: string, schema: OpenAPI.SchemaObject) => {\n let name = base;\n let suffix = 2;\n while (true) {\n const existing = document.components!.schemas![name];\n if (!existing) {\n document.components!.schemas![name] = schema;\n seen.set(name, canonical);\n return name;\n }\n const existingCanonical = seen.get(name) ?? JSON.stringify(existing);\n if (existingCanonical === canonical) return name;\n if (name === base) {\n console.warn(\n `OpenAPI schema component name conflict: \"${base}\" refers to different schemas, renaming to \"${base}-duplicated-${suffix}\"`,\n );\n }\n name = `${base}-duplicated-${suffix++}`;\n }\n };\n\n const visit = (node: unknown): void => {\n if (!node || typeof node !== 'object') return;\n if (Array.isArray(node)) {\n node.forEach(visit);\n return;\n }\n\n const obj = node as Record<string, unknown>;\n for (const value of Object.values(obj)) {\n visit(value);\n }\n\n const refName = obj['x-ref'];\n if (typeof refName !== 'string' || '$ref' in obj) return;\n\n const { 'x-ref': _, ...rest } = obj;\n const cleaned: OpenAPI.SchemaObject = JSON.parse(JSON.stringify(rest));\n const canonical = JSON.stringify(cleaned);\n const name = resolveName(refName, canonical, cleaned);\n\n for (const key of Object.keys(obj)) {\n delete obj[key];\n }\n obj['$ref'] = `#/components/schemas/${name}`;\n };\n\n visit(document.paths);\n\n if (!Object.keys(document.components.schemas).length) {\n delete document.components.schemas;\n if (!Object.keys(document.components).length) {\n delete document.components;\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/common';\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/common';\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","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/common';\nimport { getFileValues } from '@aomex/internal-file-import';\nimport {\n Router,\n WebMiddleware,\n WebRequest,\n createEnvelopeOpenApiInjector,\n type EnvelopeOptions,\n type OpenApiInjector,\n type WebMiddlewareToken,\n} from '@aomex/web';\nimport path from 'node:path';\nimport { methodToVerb } from './method-to-verb';\nimport snakeCase from 'lodash.snakecase';\n\nexport interface ParseFilesOptions {\n /** 全局中间件(与 `WebApp` 的 `mount` 对应) */\n mount?: WebMiddlewareToken[];\n /** 响应体套壳(与 `WebApp.envelope` 对应);在全部中间件 `postMethod` 之后收口 */\n envelope?: EnvelopeOptions;\n}\n\nexport const parseFiles = async (\n document: OpenAPI.Document,\n files: string[],\n options: ParseFilesOptions = {},\n) => {\n const mount = options.mount ?? [];\n const envelopeInjector = options.envelope\n ? createEnvelopeOpenApiInjector(options.envelope)\n : undefined;\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 /** 每个 operation 只出现一次,供 envelope 收口与标签补齐 */\n const operations: {\n pathName: string;\n pathItem: OpenAPI.PathItemObject;\n methodName: `${Lowercase<WebRequest['method']>}`;\n methodItem: OpenAPI.OperationObject;\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 // 顺序与运行时一致:全局 mount → 路由组 → 接口级\n const builderMiddlewareList = mount\n .concat(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 operations.push({\n pathItem,\n pathName,\n methodItem,\n methodName,\n file,\n uri,\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 // envelope 不在 mount 里,等价于最外层:全部中间件 postMethod 之后再收成 200\n if (envelopeInjector?.postMethod) {\n for (const { pathItem, pathName, methodItem, methodName } of operations) {\n envelopeInjector.postMethod(methodItem, {\n document,\n pathItem,\n pathName,\n methodName,\n });\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 operations) {\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","import type { OpenAPI } from '@aomex/common';\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/common';\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 help_app_listen_tip:\n '请将 new WebApp 与 app.listen 拆开(或仅在入口 listen),避免 CLI import 时副作用起服',\n has_error: '{{error_count}} 个错误,{{warning_count}} 条警告',\n no_error: '没有错误',\n});\n","import { I18n } from '@aomex/common';\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: 'Add 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 help_app_listen_tip:\n 'Keep new WebApp separate from app.listen (or listen only in the entry file) so CLI imports do not start the server as a side effect',\n has_error: '{{error_count}} errors, {{warning_count}} warnings',\n no_error: 'No errors',\n});\n","import { createI18n } from '@aomex/common';\nimport { zh } from './locales/zh-cn';\nimport { en } from './locales/en-us';\n\nexport const i18n = createI18n({\n zh,\n en,\n load: (file) => import(new URL(`./locales/${file}.js`, import.meta.url).href),\n});\n","import type { Mode } from 'node:fs';\nimport { OpenAPI } from '@aomex/common';\nimport sleep from 'sleep-promise';\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 { hoistSchemaRef } from './hoist-schema-ref';\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 const app = config.app;\n ctx.usedTags = await parseFiles(ctx.document, ctx.files, {\n mount: app?.['middlewareList'],\n envelope: app?.['options'].envelope,\n });\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 hoistSchemaRef(ctx.document);\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.createSession();\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 { middleware } from '@aomex/common';\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\n/**\n * Console 中间件:生成 OpenAPI 文档。\n *\n * 请把 `new WebApp(...)` 与 `app.listen(...)` 拆开(或仅在入口 listen),\n * 否则 CLI `import` 同一模块会副作用起服、抢端口。\n *\n * ```ts\n * // app.ts\n * export const app = new WebApp({ envelope: { ... }, mount: [...] });\n *\n * // main.ts\n * import { app } from './app.js';\n * app.listen(3000);\n *\n * // console mount\n * openapi({\n * commandName: 'openapi',\n * routers: './src/routers',\n * app, // 与运行时同一实例\n * });\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] = {\n summary: i18n.t('help_summary'),\n description: i18n.t('help_app_listen_tip'),\n };\n },\n },\n });\n};\n","import { OpenAPI } from '@aomex/common';\nimport { pathToFiles, type GlobPathOptions } from '@aomex/internal-file-import';\nimport type { WebApp } from '@aomex/web';\nimport { methodParameterToPathParameter } from './hoist-parameter';\nimport { hoistSchemaRef } from './hoist-schema-ref';\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 * `WebApp` 实例:读取全局 `mount` 与 `envelope`,作为 OpenAPI 注入的单一真源。\n *\n * CLI / 测试会 `import` 该模块时,请把 `new WebApp(...)` 与 `app.listen(...)` 拆开\n *(或仅在入口文件 listen),避免副作用起服。\n *\n * ```ts\n * // app.ts —— 只创建并导出\n * export const app = new WebApp({\n * envelope: { content: { ... } },\n * mount: [formatError({ ... })],\n * // services / logger / ...\n * });\n *\n * // main.ts —— 进程入口才听端口\n * import { app } from './app.js';\n * app.listen(3000);\n *\n * generateOpenapi({\n * routers: './src/routers',\n * app,\n * });\n * ```\n */\n app: WebApp;\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 app = config.app;\n const usedTags = await parseFiles(document, files, {\n mount: app['middlewareList'],\n envelope: app['options'].envelope,\n });\n appendTag(document, usedTags);\n await config.fix?.(document);\n hoistSchemaRef(document);\n methodParameterToPathParameter(document);\n\n return JSON.parse(JSON.stringify(document));\n};\n"],"ignoreList":[0],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAAa,IAAI,IAAE;CAAW,SAAS,EAAE,GAAE,GAAE;EAAC,IAAI,IAAE,EAAE,sBAAoB,IAAE;EAAW,OAAO,IAAI,SAAS,SAAS,GAAE;GAAC,EAAE,GAAE,CAAC;EAAC,EAAE;CAAC;CAAC,OAAO,UAAQ,SAAS,GAAE;EAAC,IAAgE,KAA1D,UAAU,SAAO,KAAG,KAAK,MAAI,UAAU,KAAG,UAAU,KAAG,CAAC,EAAA,CAAM,qBAAoB,IAAE,EAAE,GAAE,EAAC,qBAAoB,EAAC,CAAC;EAAE,SAAS,EAAE,GAAE;GAAC,OAAO,EAAE,MAAM,WAAU;IAAC,OAAO;GAAC,EAAE;EAAC;EAAC,OAAO,EAAE,OAAK,WAAU;GAAC,OAAO,EAAE,KAAK,MAAM,GAAE,SAAS;EAAC,GAAE,EAAE,QAAM,QAAQ,QAAQ,CAAC,CAAC,OAAM;CAAC;;ACKna,MAAM,aAAa,cAAc,YAAY,GAAG;AAUhD,IAAI,YAAsC;AAC1C,MAAM,qBAAqB;CACzB,IAAI,CAAC,WAAW;EAEd,MAAM,EAAE,aAAa,WAAW,0BAA0B;EAC1D,MAAM,EAAE,QAAQ,WAAW,8BAA8B;EACzD,YAAY,IAAI,SAAS;EACzB,UAAU,WAAW;GACnB,SAAS;GAET,OAAO;IACL,gBAAgB;IAChB,oBAAoB;GACtB;EACF,CAAC;CACH;CACA,OAAO;AACT;AAYA,MAAa,kBAAkB,OAAO,aAA+B;CACnE,MAAM,SAAgC;EAAE,UAAU,CAAC;EAAG,QAAQ,CAAC;CAAE;CAGjE,CAAA,MAFiB,aACiB,CAAC,CAAC,IAAI,QAA8C,EAAA,CACzE,SAAS,SAAS;EAC7B,OAAO,KAAK,aAAA,IAAwC,WAAW,WAAW,CAAC,KAAK;GAC9E,MAAM,KAAK,KAAK,IAAI,MAAM;GAC1B,SAAS,KAAK;EAChB,CAAC;CACH,CAAC;CACD,OAAO;AACT;;ACvDA,MAAa,UAAiB;CAC5B;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF;;;;;ACHA,MAAa,kCAAkC,aAA+B;CAC5E,UAAU,KAAK,MAAM,QAAQ,OAAO,OAAO,SAAS,KAAK,GAAG;EAC1D,MAAM,oBAAgD,CAAC;EACvD,IAAI,gBAAgB;EACpB,KAAK,MAAM,UAAU,SAAS;GAC5B,MAAM,aAAa,KAAM;GACzB,IAAI,CAAC,YAAY;GACjB,IAAI,CAAC,WAAW,YAAY,QAAQ,SAAS;GAC7C,EAAE;GACF,WAAW,WAAW,SAAS,WAAW,OAAO,QAAQ;IACvD,MAAM,YAAY,KAAK,UAAU,SAAS;IAE1C,YAAY,IAAI,SAAS,KAAK,MAAM,SAAS;IAC7C,MAAM,gBAAgB;KACpB,IAAI,OACF,IAAI,WAAW,SAAS,SAAS,SAAS,GAC1C,CACF;KACA,IAAI,CAAC,IAAI,QACP,OAAO,WAAW;IAEtB;IACA,kBAAkB,eAAe,CAAC;IAClC,kBAAkB,UAAU,CAAE,KAAK,OAAO;GAC5C,CAAC;EACH;EAEA,IAAI,gBAAgB,GAAG,SAAS;EAEhC,OAAO,QAAQ,iBAAiB,CAAC,CAAC,SAAS,CAAC,WAAW,cAAc;GACnE,IAAI,SAAS,WAAW,eAAe;GACvC,KAAM,eAAe,CAAC;GACtB,KAAM,WAAW,KAAK,KAAK,MAAM,SAAS,CAAC;GAC3C,SAAS,SAAS,OAAO,GAAG,CAAC;EAC/B,CAAC;EACD,IAAI,KAAM,cAAc,CAAC,KAAM,WAAW,QACxC,OAAO,KAAM;CAEjB;AACF;;;;;;ACvCA,MAAa,kBAAkB,aAA+B;CAC5D,SAAS,eAAe,CAAC;CACzB,SAAS,WAAW,YAAY,CAAC;CACjC,MAAM,uBAAO,IAAI,IAAoB;CAErC,MAAM,eAAe,MAAc,WAAmB,WAAiC;EACrF,IAAI,OAAO;EACX,IAAI,SAAS;EACb,OAAO,MAAM;GACX,MAAM,WAAW,SAAS,WAAY,QAAS;GAC/C,IAAI,CAAC,UAAU;IACb,SAAS,WAAY,QAAS,QAAQ;IACtC,KAAK,IAAI,MAAM,SAAS;IACxB,OAAO;GACT;GAEA,KAD0B,KAAK,IAAI,IAAI,KAAK,KAAK,UAAU,QAAQ,OACzC,WAAW,OAAO;GAC5C,IAAI,SAAS,MACX,QAAQ,KACN,4CAA4C,KAAK,8CAA8C,KAAK,cAAc,OAAO,EAC3H;GAEF,OAAO,GAAG,KAAK,cAAc;EAC/B;CACF;CAEA,MAAM,SAAS,SAAwB;EACrC,IAAI,CAAC,QAAQ,OAAO,SAAS,UAAU;EACvC,IAAI,MAAM,QAAQ,IAAI,GAAG;GACvB,KAAK,QAAQ,KAAK;GAClB;EACF;EAEA,MAAM,MAAM;EACZ,KAAK,MAAM,SAAS,OAAO,OAAO,GAAG,GACnC,MAAM,KAAK;EAGb,MAAM,UAAU,IAAI;EACpB,IAAI,OAAO,YAAY,YAAY,UAAU,KAAK;EAElD,MAAM,EAAE,SAAS,GAAG,GAAG,SAAS;EAChC,MAAM,UAAgC,KAAK,MAAM,KAAK,UAAU,IAAI,CAAC;EACrE,MAAM,YAAY,KAAK,UAAU,OAAO;EACxC,MAAM,OAAO,YAAY,SAAS,WAAW,OAAO;EAEpD,KAAK,MAAM,OAAO,OAAO,KAAK,GAAG,GAC/B,OAAO,IAAI;EAEb,IAAI,UAAU,wBAAwB;CACxC;CAEA,MAAM,SAAS,KAAK;CAEpB,IAAI,CAAC,OAAO,KAAK,SAAS,WAAW,OAAO,CAAC,CAAC,QAAQ;EACpD,OAAO,SAAS,WAAW;EAC3B,IAAI,CAAC,OAAO,KAAK,SAAS,UAAU,CAAC,CAAC,QACpC,OAAO,SAAS;CAEpB;AACF;;AC3DA,MAAa,aAAa,OACxB,UACA,UACA,aACG;CACH,MAAM,OAAO,KAAK,QAAQ,YAAY,cAAc;CACpD,MAAM,MAAM,KAAK,QAAQ,IAAI;CAC7B,MAAM,UACJ,IAAI,SAAS,OAAO,KAAK,IAAI,SAAS,MAAM,IACxC,KAAK,UAAU,QAAQ,IACvB,KAAK,UAAU,QAAQ;CAC7B,MAAM,OAAO,MAAM,OAAO,WAAW,OAAO,GAAG,EAAE,eAAe,GAAG,CAAC;CAEpE,MAAM,MAAM,KAAK,QAAQ,IAAI,GAAG,EAAE,WAAW,KAAK,CAAC;CACnD,MAAM,UAAU,MAAM,SAAS;EAAE,MAAM;EAAU,OAAO;CAAK,CAAC;CAE9D,OAAO;EAAE;EAAM;CAAK;AACtB;;ACnBA,MAAa,qBAAqB,OAAO,UAA2C;CAClF,MAAM,WAA6B,KAAK,MAAM,KAAK,UAAU,SAAS,CAAC,CAAC,CAAC;CACzE,SAAS,YAAY;CACrB,SAAS,SAAS,CAAC;CACnB,SAAS,SAAS;EAAE,OAAO;EAAI,SAAS;CAAG;CAC3C,SAAS,QAAQ,CAAC;CAClB,SAAS,KAAK,WAAW,MAAM,gBAAgB,EAAA,CAAG,QAAQ;CAC1D,SAAS,KAAK,aAAa,MAAM,gBAAgB,EAAA,CAAG,WAAW;CAC/D,OAAO;AACT;AAEA,MAAM,kBAAkB,YAA0D;CAChF,IAAI;EACF,MAAM,UAAU,MAAM,SAAS,KAAK,QAAQ,cAAc,GAAG,MAAM;EACnE,MAAM,OAAO,KAAK,MAAM,OAAO;EAC/B,OAAO,QAAQ,OAAO,SAAS,WAAW,OAAO,CAAC;CACpD,QAAQ;EACN,OAAO,CAAC;CACV;AACF;;ACxBA,MAAa,gBAAgB,QAAgB,QAAgB;CAC3D,SAAS,OAAO,YAAY;CAE5B,IAAI,WAAW,OAAO,OAAO,IAAI,SAAS,GAAG,IAAI,aAAa;CAC9D,IAAI,WAAW,QAAQ,OAAO;CAC9B,IAAI,WAAW,OAAO,OAAO;CAC7B,IAAI,WAAW,SAAS,OAAO;CAC/B,OAAO;AACT;;ACcA,MAAa,aAAa,OACxB,UACA,OACA,UAA6B,CAAC,MAC3B;CACH,MAAM,QAAQ,QAAQ,SAAS,CAAC;CAChC,MAAM,mBAAmB,QAAQ,WAC7B,8BAA8B,QAAQ,QAAQ,IAC9C,KAAA;CACJ,MAAM,WAAqB,CAAC;CAE5B,MAAM,OAQA,CAAC;;CAGP,MAAM,aAOA,CAAC;CAEP,KAAK,MAAM,QAAQ,OAAO;EACxB,MAAM,UAAU,MAAM,cACpB,CAAC,IAAI,IACJ,SAAS,CAAC,CAAC,QAAQ,gBAAgB,MACtC;EAEA,KAAK,MAAM,UAAU,SAAS;GAC5B,MAAM,sBAAsB,OAAO;GACnC,MAAM,WAAW,OAAO;GAExB,KAAK,MAAM,WAAW,UAAU;IAC9B,IAAI,QAAQ,KAAK,kBAAkB,OAAO;IAC1C,OAAO,QAAQ,KAAK;IAGpB,MAAM,wBAAwB,MAC3B,OAAO,mBAAmB,CAAC,CAC3B,OAAO,QAAQ,iBAAiB,CAAC,CACjC,QAAQ,eAAe,sBAAsB,aAAa;IAE7D,MAAM,MAAM,QAAQ;IACpB,MAAM,WAAW,cAAc,GAAG;IAClC,MAAM,WAAoC,SAAS,MAAM,cAAc,CAAC;IAExE,KAAK,MAAM,UAAU,QAAQ,YAAY;KACvC,MAAM,aAAa,OAAO,YAAY;KACtC,MAAM,aAAuC,SAAS,cAAc;MAClE,GAAG,QAAQ;MACX,WAAW,CAAC;KACd;KAEA,WAAW,KAAK;MACd;MACA;MACA;MACA;MACA;MACA;KACF,CAAC;KAED,KAAK,KACH,GAAG,sBAAsB,KAAK,SAAS;MACrC,OAAO;OACL,UAAU,KAAK,UAAU,CAAC;OAC1B;OACA;OACA;OACA;OACA;OACA;MACF;KACF,CAAC,CACH;IACF;GACF;EACF;CACF;CAEA,KAAK,MAAM,EAAE,cAAc,MACzB,SAAS,aAAa,QAAQ;CAEhC,KAAK,MAAM,EAAE,UAAU,UAAU,cAAc,MAC7C,SAAS,SAAS,UAAU;EAAE;EAAU;CAAS,CAAC;CAEpD,KAAK,MAAM,EAAE,UAAU,UAAU,UAAU,YAAY,gBAAgB,MACrE,SAAS,WAAW,YAAY;EAC9B;EACA;EACA;EACA;CACF,CAAC;CAEH,KAAK,MAAM,EAAE,UAAU,UAAU,UAAU,YAAY,gBAAgB,MACrE,SAAS,aAAa,YAAY;EAChC;EACA;EACA;EACA;CACF,CAAC;CAGH,IAAI,kBAAkB,YACpB,KAAK,MAAM,EAAE,UAAU,UAAU,YAAY,gBAAgB,YAC3D,iBAAiB,WAAW,YAAY;EACtC;EACA;EACA;EACA;CACF,CAAC;CAGL,KAAK,MAAM,EAAE,UAAU,UAAU,cAAc,MAC7C,SAAS,WAAW,UAAU;EAAE;EAAU;CAAS,CAAC;CAEtD,KAAK,MAAM,EAAE,cAAc,MACzB,SAAS,eAAe,QAAQ;CAGlC,KAAK,MAAM,EAAE,YAAY,YAAY,MAAM,SAAS,YAAY;EAC9D,WAAW,SAAS,CAAC,iBAAiB,IAAI,CAAC;EAC3C,WAAW,gBAAgB,UACzB,aAAa,YAAY,GAAG,IAAI,MAAM,IAAI,WAAW,KAAK,MAAM,CAClE;EAEA,IAAI,eAAe,QAEjB,WAAW,iCAAiC;EAG9C,IAAI,CAAC,OAAO,KAAK,WAAW,SAAS,CAAC,CAAC,QACrC,WAAW,YAAY,EAAE,SAAS,EAAE,aAAa,GAAG,EAAE;EAGxD,SAAS,KAAK,GAAG,WAAW,IAAK;CACnC;CAEA,OAAO,CAAC,GAAG,IAAI,IAAI,QAAQ,CAAC;AAC9B;AAEA,MAAM,iBAAiB,QAAgB;CACrC,OAAO,IAAI,QAAQ,qBAAqB,GAAG,OAAO;EAChD,OAAO,IAAI,GAAG,QAAQ,QAAQ,EAAE,EAAE;CACpC,CAAC;AACH;AAEA,MAAM,oBAAoB,SAAiB;CACzC,OAAO,KAAK,SAAS,IAAI,CAAC,CAAC,QAAQ,SAAS,EAAE;AAChD;;AClLA,MAAa,aAAa,UAA4B,aAAuB;CAC3E,MAAM,OAAQ,SAAS,SAAS,CAAC;CACjC,MAAM,cAAc,KAAK,KAAK,SAAS,KAAK,IAAI;CAChD,MAAM,gBAAgB,SAAS,QAAQ,QAAQ,CAAC,YAAY,SAAS,GAAG,CAAC,CAAC,CAAC,KAAK;CAEhF,KAAK,MAAM,OAAO,eAChB,KAAK,KAAK,EAAE,MAAM,IAAI,CAAC;CAGzB,OAAO;AACT;;ACVA,MAAa,KAAK,KAAK,OAAO;CAC5B,YAAY;CACZ,sBAAsB;CACtB,eAAe;CACf,SAAS;CACT,wBAAwB;CACxB,oBAAoB;CACpB,cAAc;CACd,UAAU;CACV,cAAc;CACd,qBACE;CACF,WAAW;CACX,UAAU;AACZ,CAAC;;ACbD,MAAa,KAAK,KAAK,UAAU,EAAE,CAAC,CAAC,OAAO;CAC1C,YAAY;CACZ,sBAAsB;CACtB,eAAe;CACf,SAAS;CACT,wBAAwB;CACxB,oBAAoB;CACpB,cAAc;CACd,UAAU;CACV,cAAc;CACd,qBACE;CACF,WAAW;CACX,UAAU;AACZ,CAAC;;ACbD,MAAa,OAAO,WAAW;CAC7B;CACA;CACA,OAAO,SAAS,OAAO,IAAI,IAAI,aAAa,KAAK,MAAM,YAAY,GAAG,CAAC,CAAC;AAC1E,CAAC;;;;;;;;;;;ACyCD,MAAa,6BAA6B,OACxC,WACqC;CACrC,MAAM,EAAE,OAAO,YAAY,MAAM,SAAS,SAAyB;EACjE;GACE,OAAO,KAAK,EAAE,YAAY;GAC1B,MAAM,OAAO,QAAQ;IACnB,IAAI,WAAW,MAAM,mBAAmB,OAAO,IAAI;GACrD;EACF;EACA;GACE,OAAO,KAAK,EAAE,sBAAsB;GACpC,MAAM,OAAO,QAAQ;IACnB,IAAI,QAAQ,MAAM,YAAY,OAAO,OAAO;IAC5C,OAAA,GAAMA,WAAAA,QAAAA,CAAM,GAAG;GACjB;EACF;EACA;GACE,OAAO,KAAK,EAAE,eAAe;GAC7B,MAAM,OAAO,QAAQ;IACnB,MAAM,MAAM,OAAO;IACnB,IAAI,WAAW,MAAM,WAAW,IAAI,UAAU,IAAI,OAAO;KACvD,OAAO,MAAM;KACb,UAAU,MAAM,UAAU,CAAC;IAC7B,CAAC;IACD,OAAA,GAAMA,WAAAA,QAAAA,CAAM,GAAG;GACjB;EACF;EACA;GACE,OAAO,KAAK,EAAE,SAAS;GACvB,MAAM,OAAO,KAAK,SAAS;IACzB,MAAM,gBAAgB,UAAU,IAAI,UAAU,IAAI,QAAQ;IAC1D,IAAI,cAAc,QAChB,KAAK,SAAS,SAAS,MAAM,QAAQ,cAAc,KAAK,GAAG,CAAC;SAE5D,KAAK,SAAS;GAElB;EACF;EACA;GACE,OAAO,KAAK,EAAE,wBAAwB;GACtC,MAAM,CAAC,OAAO;GACd,MAAM,OAAO,QAAQ;IACnB,MAAM,OAAO,IAAK,IAAI,QAAQ;IAC9B,OAAA,GAAMA,WAAAA,QAAAA,CAAM,GAAG;GACjB;EACF;EACA;GACE,OAAO,KAAK,EAAE,oBAAoB;GAClC,MAAM,OAAO,QAAQ;IACnB,eAAe,IAAI,QAAQ;IAC3B,+BAA+B,IAAI,QAAQ;IAC3C,OAAA,GAAMA,WAAAA,QAAAA,CAAM,GAAG;GACjB;EACF;EACA;GACE,OAAO,KAAK,EAAE,cAAc;GAC5B,MAAM,OAAO,KAAK,SAAS;IACzB,MAAM,SAAS,MAAM,WAAW,IAAI,UAAU,OAAO,YAAY,OAAO,QAAQ;IAChF,KAAK,SACH,SAAS,MACP,CAAC,QAAQ,WAAW,GACpB,KAAK,SAAS,QAAQ,IAAI,GAAG,OAAO,IAAI,CAC1C,IAAI,SAAS,MAAM,SAAS,KAAK,OAAO,KAAK,EAAE;GACnD;EACF;EACA;GACE,OAAO,KAAK,EAAE,UAAU;GACxB,MAAM,OAAO,KAAK,SAAS;IACzB,MAAM,SAAU,IAAI,iBAAiB,MAAM,gBAAgB,IAAI,QAAQ;IACvE,OAAA,GAAMA,WAAAA,QAAAA,CAAM,GAAG;IAEf,IAAI,OAAO,OAAO,UAAU,OAAO,SAAS,QAC1C,KAAK,SAAS,SAAS,MACrB,UACA,KAAK,EAAE,aAAa;KAClB,aAAa,OAAO,OAAO;KAC3B,eAAe,OAAO,SAAS;IACjC,CAAC,CACH;SAEA,KAAK,SAAS,SAAS,MAAM,SAAS,KAAK,EAAE,UAAU,CAAC;GAE5D;EACF;CACF,CAAC;CAED,IAAI,OAAO,OAAO;CAElB,MAAM,aAAa,SAAS,cAAc;CAC1C,MAAM,EAAE,QAAQ,aAAa,QAAQ;CACrC,KAAK,MAAM,SAAS,QAAQ;EAC1B,WAAW,OAAO,aAAa,sBAAsB,KAAK,GAAG;EAC7D,WAAW,OAAO;CACpB;CACA,KAAK,MAAM,WAAW,UAAU;EAC9B,WAAW,OAAO,eAAe,sBAAsB,OAAO,GAAG;EACjE,WAAW,OAAO;CACpB;CAEA,OAAO,KAAK,MAAM,KAAK,UAAU,QAAQ,QAAQ,CAAC;AACpD;AAEA,MAAM,yBAAyB,SAAoC;CACjE,IAAI,WAAW,KAAK,KAAK,SAAS,KAAK,KAAK,KAAK,GAAG,IAAI;CACxD,OAAO,GAAG,SAAS,MAAM,QAAQ,IAAI,YAAY,IAAI,EAAE,EAAE,GAAG,KAAK;AACnE;;;;;;;;;;;;;;;;;;;;;;;;ACtHA,MAAa,WAAW,YAA+C;CACrE,MAAM,EAAE,cAAc,cAAc;CAEpC,OAAO,WAAW,QAAQ;EACxB,IAAI,OAAO,KAAK,SAAS;GACvB,IAAI,IAAI,MAAM,YAAY,aAAa,OAAO,KAAK;GACnD,IAAI,iBAAiB;GACrB,MAAM,2BAA2B,OAAO;EAC1C;EACA,MAAM,EACJ,WAAW,KAAK;GACd,IAAI,eAAe;IACjB,SAAS,KAAK,EAAE,cAAc;IAC9B,aAAa,KAAK,EAAE,qBAAqB;GAC3C;EACF,EACF;CACF,CAAC;AACH;;;;;ACAA,MAAa,kBAAkB,OAC7B,WAC8B;CAC9B,MAAM,WAAW,MAAM,mBAAmB,OAAO,IAAI;CACrD,MAAM,QAAQ,MAAM,YAAY,OAAO,OAAO;CAC9C,MAAM,MAAM,OAAO;CACnB,MAAM,WAAW,MAAM,WAAW,UAAU,OAAO;EACjD,OAAO,IAAI;EACX,UAAU,IAAI,UAAU,CAAC;CAC3B,CAAC;CACD,UAAU,UAAU,QAAQ;CAC5B,MAAM,OAAO,MAAM,QAAQ;CAC3B,eAAe,QAAQ;CACvB,+BAA+B,QAAQ;CAEvC,OAAO,KAAK,MAAM,KAAK,UAAU,QAAQ,CAAC;AAC5C"}
1
+ {"version":3,"file":"index.js","names":["sleep"],"sources":["../../../node_modules/.pnpm/sleep-promise@9.1.0/node_modules/sleep-promise/build/cjs.js","../src/lib/validate-openapi.ts","../src/lib/methods.ts","../src/lib/hoist-parameter.ts","../src/lib/hoist-schema-ref.ts","../src/lib/save-to-file.ts","../src/lib/initialize-document.ts","../src/lib/method-to-verb.ts","../src/lib/parse-files.ts","../src/lib/append-tag.ts","../src/i18n/locales/zh-cn.ts","../src/i18n/locales/en-us.ts","../src/i18n/index.ts","../src/lib/generate-document-with-spinner.ts","../src/openapi.ts","../src/lib/generate-openapi.ts"],"sourcesContent":["\"use strict\";var e=setTimeout;function t(t,n){var u=n.useCachedSetTimeout?e:setTimeout;return new Promise((function(e){u(e,t)}))}module.exports=function(e){var n=arguments.length>1&&void 0!==arguments[1]?arguments[1]:{},u=n.useCachedSetTimeout,r=t(e,{useCachedSetTimeout:u});function o(e){return r.then((function(){return e}))}return o.then=function(){return r.then.apply(r,arguments)},o.catch=Promise.resolve().catch,o};\n","import type { OpenAPI } from '@aomex/common';\nimport type spectral from '@stoplight/spectral-core';\nimport type ruleset from '@stoplight/spectral-rulesets';\nimport { createRequire } from 'node:module';\n\nconst requireCJS = createRequire(import.meta.url);\n\n// Inline package `@stoplight/types`\nenum DiagnosticSeverity {\n Error = 0,\n Warning = 1,\n Information = 2,\n Hint = 3,\n}\n\nlet _spectral: spectral.Spectral | null = null;\nconst initSpectral = () => {\n if (!_spectral) {\n // 直接顶级import导致node启动时间慢100ms+\n const { Spectral } = requireCJS('@stoplight/spectral-core') as typeof spectral;\n const { oas } = requireCJS('@stoplight/spectral-rulesets') as typeof ruleset;\n _spectral = new Spectral();\n _spectral.setRuleset({\n extends: oas as spectral.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 }\n return _spectral;\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 = { warnings: [], errors: [] };\n const spectral = initSpectral();\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/common';\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 type { OpenAPI } from '@aomex/common';\n\n/**\n * 识别 schema 上的 `x-ref`,提取到 `components.schemas`,并替换为 `$ref`。\n * 自底向上处理,保证嵌套 object 先变成 `$ref` 再被父级收录。\n */\nexport const hoistSchemaRef = (document: OpenAPI.Document) => {\n document.components ||= {};\n document.components.schemas ||= {};\n const seen = new Map<string, string>();\n\n const resolveName = (base: string, canonical: string, schema: OpenAPI.SchemaObject) => {\n let name = base;\n let suffix = 2;\n while (true) {\n const existing = document.components!.schemas![name];\n if (!existing) {\n document.components!.schemas![name] = schema;\n seen.set(name, canonical);\n return name;\n }\n const existingCanonical = seen.get(name) ?? JSON.stringify(existing);\n if (existingCanonical === canonical) return name;\n if (name === base) {\n console.warn(\n `OpenAPI schema component name conflict: \"${base}\" refers to different schemas, renaming to \"${base}-duplicated-${suffix}\"`,\n );\n }\n name = `${base}-duplicated-${suffix++}`;\n }\n };\n\n const visit = (node: unknown): void => {\n if (!node || typeof node !== 'object') return;\n if (Array.isArray(node)) {\n node.forEach(visit);\n return;\n }\n\n const obj = node as Record<string, unknown>;\n for (const value of Object.values(obj)) {\n visit(value);\n }\n\n const refName = obj['x-ref'];\n if (typeof refName !== 'string' || '$ref' in obj) return;\n\n const { 'x-ref': _, ...rest } = obj;\n const cleaned: OpenAPI.SchemaObject = JSON.parse(JSON.stringify(rest));\n const canonical = JSON.stringify(cleaned);\n const name = resolveName(refName, canonical, cleaned);\n\n for (const key of Object.keys(obj)) {\n delete obj[key];\n }\n obj['$ref'] = `#/components/schemas/${name}`;\n };\n\n visit(document.paths);\n\n if (!Object.keys(document.components.schemas).length) {\n delete document.components.schemas;\n if (!Object.keys(document.components).length) {\n delete document.components;\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/common';\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/common';\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","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/common';\nimport { getFileValues } from '@aomex/internal-file-import';\nimport {\n Router,\n WebMiddleware,\n WebRequest,\n X_SKIP_ENVELOPE,\n type OpenApiInjector,\n type WebMiddlewareToken,\n} from '@aomex/web';\nimport path from 'node:path';\nimport { methodToVerb } from './method-to-verb';\nimport snakeCase from 'lodash.snakecase';\n\nexport interface ParseFilesOptions {\n /** 全局中间件(与 `WebApp` 的 `mount` / 自动插入的 envelope 对应) */\n mount?: WebMiddlewareToken[];\n}\n\nexport const parseFiles = async (\n document: OpenAPI.Document,\n files: string[],\n options: ParseFilesOptions = {},\n) => {\n const mount = options.mount ?? [];\n const usedTags: string[] = [];\n\n /** 每个 operation 及其中间件 injector(顺序与运行时一致:全局 → 组 → 接口) */\n const operations: {\n pathName: string;\n pathItem: OpenAPI.PathItemObject;\n methodName: `${Lowercase<WebRequest['method']>}`;\n methodItem: OpenAPI.OperationObject;\n injectors: 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 // 顺序与运行时一致:全局 mount → 路由组 → 接口级\n const builderMiddlewareList = mount\n .concat(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 operations.push({\n pathItem,\n pathName,\n methodItem,\n methodName,\n injectors: builderMiddlewareList.map((item) => item['openapi']()),\n file,\n uri,\n });\n }\n }\n }\n }\n\n // on*:由外到内(与 mount 顺序一致)\n for (const { injectors } of operations) {\n for (const injector of injectors) {\n injector.onDocument?.(document);\n }\n }\n for (const { injectors, pathItem, pathName } of operations) {\n for (const injector of injectors) {\n injector.onPath?.(pathItem, { document, pathName });\n }\n }\n for (const { injectors, pathItem, pathName, methodItem, methodName } of operations) {\n for (const injector of injectors) {\n injector.onMethod?.(methodItem, {\n document,\n pathItem,\n pathName,\n methodName,\n });\n }\n }\n\n // post*:由内到外(倒序),保证最外层(如 envelope)最后收口\n for (const { injectors, pathItem, pathName, methodItem, methodName } of operations) {\n for (let i = injectors.length - 1; i >= 0; i--) {\n injectors[i]!.postMethod?.(methodItem, {\n document,\n pathItem,\n pathName,\n methodName,\n });\n }\n }\n // 清理 response({ skipEnvelope }) 写入的临时键(无论是否配置 envelope)\n for (const { methodItem } of operations) {\n delete (methodItem as Record<string, unknown>)[X_SKIP_ENVELOPE];\n }\n for (const { injectors, pathItem, pathName } of operations) {\n for (let i = injectors.length - 1; i >= 0; i--) {\n injectors[i]!.postPath?.(pathItem, { document, pathName });\n }\n }\n for (const { injectors } of operations) {\n for (let i = injectors.length - 1; i >= 0; i--) {\n injectors[i]!.postDocument?.(document);\n }\n }\n\n for (const { methodItem, methodName, file, uri } of operations) {\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","import type { OpenAPI } from '@aomex/common';\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/common';\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 help_app_listen_tip:\n '请将 new WebApp 与 app.listen 拆开(或仅在入口 listen),避免 CLI import 时副作用起服',\n has_error: '{{error_count}} 个错误,{{warning_count}} 条警告',\n no_error: '没有错误',\n});\n","import { I18n } from '@aomex/common';\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: 'Add 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 help_app_listen_tip:\n 'Keep new WebApp separate from app.listen (or listen only in the entry file) so CLI imports do not start the server as a side effect',\n has_error: '{{error_count}} errors, {{warning_count}} warnings',\n no_error: 'No errors',\n});\n","import { createI18n } from '@aomex/common';\nimport { zh } from './locales/zh-cn';\nimport { en } from './locales/en-us';\n\nexport const i18n = createI18n({\n zh,\n en,\n load: (file) => import(new URL(`./locales/${file}.js`, import.meta.url).href),\n});\n","import type { Mode } from 'node:fs';\nimport { OpenAPI } from '@aomex/common';\nimport sleep from 'sleep-promise';\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 { hoistSchemaRef } from './hoist-schema-ref';\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 const app = config.app;\n ctx.usedTags = await parseFiles(ctx.document, ctx.files, {\n mount: app?.['middlewareList'],\n });\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 hoistSchemaRef(ctx.document);\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.createSession();\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 { middleware } from '@aomex/common';\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\n/**\n * Console 中间件:生成 OpenAPI 文档。\n *\n * 请把 `new WebApp(...)` 与 `app.listen(...)` 拆开(或仅在入口 listen),\n * 否则 CLI `import` 同一模块会副作用起服、抢端口。\n *\n * ```ts\n * // app.ts\n * export const app = new WebApp({ envelope: { ... }, mount: [...] });\n *\n * // main.ts\n * import { app } from './app.js';\n * app.listen(3000);\n *\n * // console mount\n * openapi({\n * commandName: 'openapi',\n * routers: './src/routers',\n * app, // 与运行时同一实例\n * });\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] = {\n summary: i18n.t('help_summary'),\n description: i18n.t('help_app_listen_tip'),\n };\n },\n },\n });\n};\n","import { OpenAPI } from '@aomex/common';\nimport { pathToFiles, type GlobPathOptions } from '@aomex/internal-file-import';\nimport type { WebApp } from '@aomex/web';\nimport { methodParameterToPathParameter } from './hoist-parameter';\nimport { hoistSchemaRef } from './hoist-schema-ref';\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 * `WebApp` 实例:读取全局 `middlewareList`(含用户 `mount` 与自动插入的 envelope),\n * 作为 OpenAPI 注入的单一真源。\n *\n * CLI / 测试会 `import` 该模块时,请把 `new WebApp(...)` 与 `app.listen(...)` 拆开\n *(或仅在入口文件 listen),避免副作用起服。\n *\n * ```ts\n * // app.ts —— 只创建并导出\n * export const app = new WebApp({\n * envelope: { content: { ... } },\n * mount: [formatError({ ... })],\n * // services / logger / ...\n * });\n *\n * // main.ts —— 进程入口才听端口\n * import { app } from './app.js';\n * app.listen(3000);\n *\n * generateOpenapi({\n * routers: './src/routers',\n * app,\n * });\n * ```\n */\n app: WebApp;\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 app = config.app;\n const usedTags = await parseFiles(document, files, {\n mount: app['middlewareList'],\n });\n appendTag(document, usedTags);\n await config.fix?.(document);\n hoistSchemaRef(document);\n methodParameterToPathParameter(document);\n\n return JSON.parse(JSON.stringify(document));\n};\n"],"ignoreList":[0],"mappings":"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"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@aomex/openapi",
3
- "version": "3.30.8-alpha.7326d75.0",
3
+ "version": "4.0.1-alpha.185683a.0",
4
4
  "description": "Openapi文档生成工具",
5
5
  "type": "module",
6
6
  "types": "dist/index.d.ts",
@@ -39,17 +39,17 @@
39
39
  }
40
40
  },
41
41
  "dependencies": {
42
- "@aomex/internal-file-import": "3.30.8-alpha.7326d75.0",
43
- "@aomex/internal-tools": "3.30.8-alpha.7326d75.0",
42
+ "@aomex/internal-file-import": "4.0.1-alpha.185683a.0",
43
+ "@aomex/internal-tools": "4.0.1-alpha.185683a.0",
44
44
  "@stoplight/spectral-core": "^1.24.1",
45
45
  "@stoplight/spectral-rulesets": "^1.23.1",
46
46
  "lodash.snakecase": "^4.1.1",
47
47
  "yaml": "^2.9.1"
48
48
  },
49
49
  "devDependencies": {
50
- "@aomex/common": "3.30.8-alpha.7326d75.0",
51
- "@aomex/console": "3.30.8-alpha.7326d75.0",
52
- "@aomex/web": "3.30.8-alpha.7326d75.0",
50
+ "@aomex/common": "4.0.1-alpha.185683a.0",
51
+ "@aomex/console": "4.0.1-alpha.185683a.0",
52
+ "@aomex/web": "4.0.1-alpha.185683a.0",
53
53
  "@types/lodash.snakecase": "^4.1.9",
54
54
  "stat-mode": "^1.0.0"
55
55
  },