fix: collect openapi version changes for operations

Author: b41ex

src/apitypes/rest/rest.changes.ts

@@ -59,6 +59,7 @@ import { calculateObjectHash } from '../../utils/hashes'
 import { REST_API_TYPE } from './rest.consts'
 import { OpenAPIV3 } from 'openapi-types'
 import {
+  extractOpenapiVersionDiff,
   extractPathParamRenameDiff,
   extractRootSecurityDiffs,
   extractRootServersDiffs,
@@ -167,7 +168,8 @@ export const compareDocuments = async (
       let operationDiffs: Diff[] = []
       if (operationPotentiallyChanged) {
         operationDiffs = [
-          ...(methodData as WithAggregatedDiffs<OpenAPIV3.OperationObject>)[DIFFS_AGGREGATED_META_KEY]??[],
+          ...(methodData as WithAggregatedDiffs<OpenAPIV3.OperationObject>)[DIFFS_AGGREGATED_META_KEY] ?? [],
+          ...extractOpenapiVersionDiff(merged),
           ...extractRootServersDiffs(merged),
           ...extractRootSecurityDiffs(merged),
           ...extractPathParamRenameDiff(merged, path),

src/apitypes/rest/rest.utils.ts

@@ -70,6 +70,11 @@ export const dump = (value: unknown, format: typeof FILE_FORMAT_YAML | typeof FI
   throw new Error(`Unsupported format: ${format}`)
 }
 
+export const extractOpenapiVersionDiff = (doc: OpenAPIV3.Document): Diff[] => {
+  const diff = (doc as WithDiffMetaRecord<OpenAPIV3.Document>)[DIFF_META_KEY]?.openapi
+  return diff ? [diff] : []
+}
+
 export const extractPathParamRenameDiff = (doc: OpenAPIV3.Document, path: string): Diff[] => {
   const diff = (doc.paths as WithDiffMetaRecord<OpenAPIV3.PathsObject>)[DIFF_META_KEY]?.[path]
   return diff && isPathParamRenameDiff(diff) ? [diff] : []

test/changes.test.ts

@@ -244,6 +244,13 @@ describe('Changelog build type', () => {
         [UNCLASSIFIED_CHANGE_TYPE]: 1,
       }))
     })
+
+    test('Change openapi version', async () => {
+      const result = await buildChangelogPackage('changelog/change-openapi-version')
+
+      expect(result).toEqual(changesSummaryMatcher({ [ANNOTATION_CHANGE_TYPE]: 1 }))
+      expect(result).toEqual(numberOfImpactedOperationsMatcher({ [ANNOTATION_CHANGE_TYPE]: 1 }))
+    })
   })
 
   test('Operation changes fields are correct', async () => {