Release version v5.3.0 (#879)

Author: github-actions[bot]

CHANGELOG.md

@@ -2,6 +2,8 @@
 
 ## [Unreleased]
 
+## [v5.3.0] - 2025-09-24
+
 ## [v5.2.0] - 2025-09-19
 
 ## [v5.1.0] - 2025-09-01
@@ -663,7 +665,9 @@ Newer releases follow the [Keep a Changelog](https://keepachangelog.com/en/1.0.0
 
 -   Base release
 
-[Unreleased]: https://github.com/postmanlabs/openapi-to-postman/compare/v5.2.0...HEAD
+[Unreleased]: https://github.com/postmanlabs/openapi-to-postman/compare/v5.3.0...HEAD
+
+[v5.3.0]: https://github.com/postmanlabs/openapi-to-postman/compare/v5.2.0...v5.3.0
 
 [v5.2.0]: https://github.com/postmanlabs/openapi-to-postman/compare/v5.1.0...v5.2.0
 

libV2/schemaUtils.js

@@ -510,12 +510,19 @@ let QUERYPARAM = 'query',
       a combination of multiple schemas
     */
     if (resolveFor === TYPES_GENERATION) {
-      return {
+      const result = {
         allOf: _.map(schema.allOf, (schema) => {
           // eslint-disable-next-line no-use-before-define
           return _resolveSchema(context, schema, stack, resolveFor, _.cloneDeep(seenRef), currentPath);
         })
       };
+      if (schema.title !== undefined) {
+        result.title = schema.title;
+      }
+      if (schema.description !== undefined) {
+        result.description = schema.description;
+      }
+      return result;
     }
 
     try {
@@ -594,10 +601,21 @@ let QUERYPARAM = 'query',
         return _resolveSchema(context, compositeSchema[0], stack, resolveFor, _.cloneDeep(seenRef), currentPath);
       }
 
-      return { [compositeKeyword]: _.map(compositeSchema, (schemaElement, index) => {
-        return _resolveSchema(context, schemaElement, stack, resolveFor, _.cloneDeep(seenRef),
-          utils.addToJsonPath(currentPath, [compositeKeyword, index]));
-      }) };
+      const result = {
+        [compositeKeyword]: _.map(compositeSchema, (schemaElement, index) => {
+          return _resolveSchema(context, schemaElement, stack, resolveFor, _.cloneDeep(seenRef),
+            utils.addToJsonPath(currentPath, [compositeKeyword, index]));
+        })
+      };
+
+      if (schema.title !== undefined) {
+        result.title = schema.title;
+      }
+      if (schema.description !== undefined) {
+        result.description = schema.description;
+      }
+
+      return result;
     }
 
     if (schema.allOf) {
@@ -768,6 +786,8 @@ let QUERYPARAM = 'query',
   processSchema = (resolvedSchema) => {
     if (resolvedSchema.anyOf) {
       return {
+        title: resolvedSchema.title,
+        description: resolvedSchema.description,
         anyOf: resolvedSchema.anyOf.map((schema) => {
           return processSchema(schema);
         })
@@ -776,6 +796,8 @@ let QUERYPARAM = 'query',
 
     if (resolvedSchema.oneOf) {
       return {
+        title: resolvedSchema.title,
+        description: resolvedSchema.description,
         oneOf: resolvedSchema.oneOf.map((schema) => {
           return processSchema(schema);
         })
@@ -784,6 +806,8 @@ let QUERYPARAM = 'query',
 
     if (resolvedSchema.allOf) {
       return {
+        title: resolvedSchema.title,
+        description: resolvedSchema.description,
         allOf: resolvedSchema.allOf.map((schema) => {
           return processSchema(schema);
         })
@@ -814,6 +838,7 @@ let QUERYPARAM = 'query',
           maximum: propValue.maximum,
           pattern: propValue.pattern,
           example: propValue.example,
+          title: propValue.title,
           description: propValue.description,
           format: propValue.format
         };
@@ -865,7 +890,9 @@ let QUERYPARAM = 'query',
       return arrayDetails;
     }
     return {
-      type: resolvedSchema.type
+      type: resolvedSchema.type,
+      description: resolvedSchema.description,
+      title: resolvedSchema.title
     };
   },
 
@@ -2106,6 +2133,8 @@ let QUERYPARAM = 'query',
   createProperties = (param) => {
     const { schema } = param;
     return {
+      description: schema.description,
+      title: schema.title,
       type: schema.type,
       format: schema.format,
       default: schema.default,
@@ -2450,6 +2479,8 @@ let QUERYPARAM = 'query',
 
         properties = {
           type: schema.type,
+          description: schema.description,
+          title: schema.title,
           format: schema.format,
           default: schema.default,
           required: schema.required,

package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "openapi-to-postmanv2",
-  "version": "5.2.0",
+  "version": "5.3.0",
   "description": "Convert a given OpenAPI specification to Postman Collection v2.0",
   "homepage": "https://github.com/postmanlabs/openapi-to-postman",
   "bugs": "https://github.com/postmanlabs/openapi-to-postman/issues",