vona-module-a-openapi 5.0.14 → 5.0.16

package/dist/index.js

@@ -118,7 +118,7 @@ let ServiceOpenapi = (_dec$1 = Service(), _dec2$1 = BeanInfo({
     const registry = this._collectRegistry();
     const generator = version === 'V30' ? new OpenApiGeneratorV3(registry.definitions) : new OpenApiGeneratorV31(registry.definitions);
     const apiObj = generator.generateDocument(this.scope.config.generateDocument[version]);
-    this._translate(apiObj);
+    this._translate(apiObj, 'api');
     return apiObj;
   }
   generateJsonOfControllerAction(controller, actionKey, version = 'V31') {
@@ -128,10 +128,10 @@ let ServiceOpenapi = (_dec$1 = Service(), _dec2$1 = BeanInfo({
     this._collectController(registry, beanOptions.module, controller, actionKey);
     const generator = version === 'V30' ? new OpenApiGeneratorV3(registry.definitions) : new OpenApiGeneratorV31(registry.definitions);
     const apiObj = generator.generateDocument(this.scope.config.generateDocument[version]);
-    this._translate(apiObj);
+    this._translate(apiObj, 'rest');
     return apiObj;
   }
-  _translate(apiObj) {
+  _translate(apiObj, generateJsonScene) {
     // paths
     if (apiObj.paths) {
       for (const key in apiObj.paths) {
@@ -141,10 +141,10 @@ let ServiceOpenapi = (_dec$1 = Service(), _dec2$1 = BeanInfo({
           this._translateStrings(methodObj, ['description', 'summary']);
           // parameters
           for (const parameterObj of methodObj.parameters || []) {
-            this._translateSchema(parameterObj.schema);
+            this._translateSchema(parameterObj.schema, generateJsonScene);
           }
           // requestBody
-          this._translateSchema(methodObj.requestBody?.content?.['application/json']?.schema);
+          this._translateSchema(methodObj.requestBody?.content?.['application/json']?.schema, generateJsonScene);
         }
       }
     }
@@ -152,19 +152,23 @@ let ServiceOpenapi = (_dec$1 = Service(), _dec2$1 = BeanInfo({
     if (apiObj.components?.schemas) {
       for (const key in apiObj.components.schemas) {
         const schema = apiObj.components.schemas[key];
-        this._translateSchema(schema);
+        this._translateSchema(schema, generateJsonScene);
       }
     }
   }
-  _translateSchema(schema) {
+  _translateSchema(schema, generateJsonScene) {
     if (!schema) return;
     if (schema.type === 'object' && schema.required === undefined) schema.required = [];
     this._translateStrings(schema, ['title', 'description']);
+    if (generateJsonScene === 'api' && !schema.description && schema.title) {
+      schema.description = schema.title;
+      delete schema.title;
+    }
     const properties = cast(schema).properties;
     if (properties && typeof properties === 'object') {
       for (const prop in properties) {
         const propObj = properties[prop];
-        this._translateSchema(propObj);
+        this._translateSchema(propObj, generateJsonScene);
       }
     }
   }

package/dist/types/api.d.ts

@@ -20,6 +20,7 @@ export interface IOpenApiOptions {
     operationId?: string;
     headers?: IOpenApiHeader[];
 }
+export type TypeGenerateJsonScene = 'api' | 'rest';
 export type TypeOpenApiVersion = 'V30' | 'V31';
 export interface IOpenAPIObject {
     V30: OpenAPIObject30;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "vona-module-a-openapi",
   "type": "module",
-  "version": "5.0.14",
+  "version": "5.0.16",
   "title": "a-openapi",
   "vonaModule": {
     "capabilities": {
@@ -38,7 +38,7 @@
     "@cabloy/zod-query": "^1.0.14",
     "@zhennann/currency": "^2.0.0",
     "openapi3-ts": "^4.4.0",
-    "zod": "^3.23.8"
+    "zod": "^3.25.58"
   },
   "devDependencies": {
     "clean-package": "^2.2.0",