Merge branch 'release'

Author: b41ex

package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "@netcracker/qubership-apihub-api-diff",
-  "version": "1.0.4",
+  "version": "1.1.0-next.0",
   "module": "./dist/index.es.js",
   "main": "./dist/index.cjs.js",
   "types": "./dist/index.d.ts",

package.json

@@ -4,6 +4,7 @@ import {
   breakingIfAfterTrue,
   nonBreaking,
   PARENT_JUMP,
+  semiBreaking,
   strictResolveValueFromContext,
   unclassified,
 } from '../core'
@@ -100,6 +101,9 @@ export const enumClassifyRule: ClassifyRule = [
   ({ before }) => (isNotEmptyArray(before.parent) ? nonBreaking : breaking),
   ({ after }) => (isNotEmptyArray(after.parent) ? breaking : nonBreaking),
   breaking,
+  ({ before }) => (isNotEmptyArray(before.parent) ? semiBreaking : nonBreaking),
+  ({ after }) => (isNotEmptyArray(after.parent) ? nonBreaking: semiBreaking ),
+  nonBreaking
 ]
 
 export const nonInvertible = (rule: ClassifyRule): ClassifyRule => {

src/jsonSchema/jsonSchema.classify.ts

@@ -20,6 +20,7 @@ import {
   transformCompareRules,
   unclassified,
   deepEqualsUniqueItemsArrayMappingResolver,
+  semiBreaking,
 } from '../core'
 import {
   enumClassifyRule,
@@ -122,7 +123,7 @@ export const jsonSchemaRules = ({
     '/default': simpleRule([nonBreaking, breaking, breaking], resolveSchemaDescriptionTemplates('default value')),
 
     '/enum': {
-      $: [breaking, nonBreaking, breaking],
+      $: [breaking, nonBreaking, breaking, nonBreaking, semiBreaking, nonBreaking],
       mapping: deepEqualsUniqueItemsArrayMappingResolver,
       '/*': ({ key, value }) => {
         if (!isNumber(key)) {

src/jsonSchema/jsonSchema.rules.ts

@@ -14,6 +14,7 @@ import { getKeyValue, isExist, isNotEmptyArray } from '../utils'
 import { emptySecurity, getDefaultStyle, includeSecurity } from './openapi3.utils'
 import type { ClassifyRule, CompareContext } from '../types'
 import { DiffType } from '../types'
+import { hidePathParamNames } from './openapi3.mapping'
 
 export const paramClassifyRule: ClassifyRule = [
   ({ after }) => {
@@ -72,7 +73,7 @@ export const parameterAllowReservedClassifyRule: ClassifyRule = [
 export const parameterNameClassifyRule: ClassifyRule = [
   nonBreaking,
   breaking,
-  ({ before }) => (getKeyValue(before.parent, 'in') === 'path' ? nonBreaking : breaking),
+  ({ before }) => (getKeyValue(before.parent, 'in') === 'path' ? annotation : breaking),
 ]
 
 export const parameterRequiredClassifyRule: ClassifyRule = [
@@ -141,3 +142,17 @@ export const operationSecurityItemClassifyRule: ClassifyRule = [
     after,
   }) => (includeSecurity(after.parent, before.parent) || emptySecurity(after.value) ? nonBreaking : breaking),
 ]
+
+export const pathChangeClassifyRule: ClassifyRule = [
+  nonBreaking,
+  breaking,
+  ({ before, after }) => {
+    const beforePath = before.key as string
+    const afterPath = after.key as string
+    const unifiedBeforePath = hidePathParamNames(beforePath)
+    const unifiedAfterPath = hidePathParamNames(afterPath)
+    
+    // If unified paths are the same, it means only parameter names changed
+    return unifiedBeforePath === unifiedAfterPath ? annotation : breaking
+  }
+]

src/openapi/openapi3.classify.ts

@@ -124,7 +124,7 @@ export const contentMediaTypeMappingResolver: MappingResolver<string> = (before,
   return result
 }
 
-function hidePathParamNames(path: string): string {
+export function hidePathParamNames(path: string): string {
   return path.replace(PATH_PARAMETER_REGEXP, PATH_PARAM_UNIFIED_PLACEHOLDER)
 }
 

src/openapi/openapi3.mapping.ts

@@ -51,6 +51,7 @@ import {
   parameterNameClassifyRule,
   parameterRequiredClassifyRule,
   parameterStyleClassifyRule,
+  pathChangeClassifyRule,
 } from './openapi3.classify'
 import {
   contentMediaTypeMappingResolver,
@@ -341,7 +342,7 @@ export const openApi3Rules = (options: OpenApi3RulesOptions): CompareRules => {
       $: allUnclassified,
       mapping: options.mode === COMPARE_MODE_OPERATION ? singleOperationPathMappingResolver : pathMappingResolver,
       '/*': {
-        $: [nonBreaking, breaking, breaking],
+        $: pathChangeClassifyRule,
         mapping: options.mode === COMPARE_MODE_OPERATION ? singleOperationPathMappingResolver : pathMappingResolver,
         '/summary': { $: allAnnotation },
         '/description': { $: allAnnotation },

src/openapi/openapi3.rules.ts

@@ -1,6 +1,6 @@
 import { compareFiles, compareFilesWithMerge, TEST_DEFAULTS_DECLARATION_PATHS } from '../utils'
 import { diffsMatcher } from '../../helper/matchers'
-import { annotation, breaking, DiffAction, nonBreaking } from '../../../src'
+import { annotation, breaking, DiffAction, nonBreaking, semiBreaking } from '../../../src'
 import { JSON_SCHEMA_NODE_SYNTHETIC_TYPE_ANY } from '@netcracker/qubership-apihub-api-unifier'
 
 const SUITE_ID = 'response-body-schema'
@@ -160,7 +160,7 @@ describe('Openapi3 ResponseBody.Schema ', () => {
       expect.objectContaining({
         action: DiffAction.remove,
         beforeDeclarationPaths: [[...RESPONSE_SCHEMA_PATH, 'enum']],
-        type: breaking,
+        type: semiBreaking,
       }),
     ]))
   })
@@ -172,7 +172,7 @@ describe('Openapi3 ResponseBody.Schema ', () => {
       expect.objectContaining({
         action: DiffAction.add,
         afterDeclarationPaths: [[...RESPONSE_SCHEMA_PATH, 'enum', 2]],
-        type: breaking,
+        type: semiBreaking,
       }),
     ]))
   })
@@ -189,7 +189,7 @@ describe('Openapi3 ResponseBody.Schema ', () => {
         expect.objectContaining({
           action: DiffAction.add,
           afterDeclarationPaths: [[...RESPONSE_SCHEMA_PATH, 'enum', 1]],
-          type: breaking,
+          type: semiBreaking,
         }),
       ],
     ))

test/compatibility-suites/openapi/response-body-schema.test.ts

@@ -7,6 +7,7 @@ import {
   DIFF_META_KEY,
   DiffAction,
   nonBreaking,
+  annotation,
 } from '../src'
 
 import { OpenapiBuilder, TEST_DIFF_FLAG, TEST_ORIGINS_FLAG, TEST_SYNTHETIC_TITLE_FLAG } from './helper'
@@ -186,20 +187,19 @@ describe('Openapi3 operation changes', () => {
         action: DiffAction.rename,
         beforeDeclarationPaths: [['paths', '/path1/{param1}/{anotherParam1}']],
         afterDeclarationPaths: [['paths', '/path1/{param2}/{anotherParam2}']],
-        // todo fix
-        type: breaking,
+        type: annotation, // Only parameter names changed, unified paths are the same
       }),
       expect.objectContaining({
         action: DiffAction.replace,
         beforeDeclarationPaths: [['paths', '/path1/{param1}/{anotherParam1}', 'parameters', 0, 'name']],
         afterDeclarationPaths: [['paths', '/path1/{param2}/{anotherParam2}', 'parameters', 1, 'name']],
-        type: nonBreaking,
+        type: annotation,
       }),
       expect.objectContaining({
         action: DiffAction.replace,
         beforeDeclarationPaths: [['paths', '/path1/{param1}/{anotherParam1}', 'parameters', 1, 'name']],
         afterDeclarationPaths: [['paths', '/path1/{param2}/{anotherParam2}', 'parameters', 0, 'name']],
-        type: nonBreaking,
+        type: annotation,
       }),
     ]))
   })
@@ -211,20 +211,19 @@ describe('Openapi3 operation changes', () => {
         action: DiffAction.rename,
         beforeDeclarationPaths: [['paths', '/path1/{param1}/{anotherParam1}']],
         afterDeclarationPaths: [['paths', '/path1/{param2}/{anotherParam2}']],
-        // todo fix
-        type: breaking,
+        type: annotation, // Only parameter names changed, unified paths are the same
       }),
       expect.objectContaining({
         action: DiffAction.replace,
         beforeDeclarationPaths: [['paths', '/path1/{param1}/{anotherParam1}', 'get', 'parameters', 0, 'name']],
         afterDeclarationPaths: [['paths', '/path1/{param2}/{anotherParam2}', 'get', 'parameters', 1, 'name']],
-        type: nonBreaking,
+        type: annotation,
       }),
       expect.objectContaining({
         action: DiffAction.replace,
         beforeDeclarationPaths: [['paths', '/path1/{param1}/{anotherParam1}', 'get', 'parameters', 1, 'name']],
         afterDeclarationPaths: [['paths', '/path1/{param2}/{anotherParam2}', 'get', 'parameters', 0, 'name']],
-        type: nonBreaking,
+        type: annotation,
       }),
     ]))
   })
@@ -253,14 +252,13 @@ describe('Openapi3 operation changes', () => {
         action: DiffAction.rename,
         beforeDeclarationPaths: [['paths', '/path1/{param1}']],
         afterDeclarationPaths: [['paths', '/path1/{param2}']],
-        // todo fix
-        type: breaking,
+        type: annotation, // Only parameter name changed, unified paths are the same
       }),
       expect.objectContaining({
         action: DiffAction.replace,
         beforeDeclarationPaths: [['paths', '/path1/{param1}', 'get', 'parameters', 0, 'name']],
         afterDeclarationPaths: [['paths', '/path1/{param2}', 'get', 'parameters', 0, 'name']],
-        type: nonBreaking,
+        type: annotation,
       }),
       expect.objectContaining({
         action: DiffAction.add,