[OAS] Beautify generated operation ids (#198132)

Author: jloleysens

oas_docs/bundle.json

@@ -35,7 +35,7 @@ export const sharedOas = {
       get: {
         deprecated: true,
         'x-discontinued': 'route discontinued version or date',
-        operationId: '%2Fbar#0',
+        operationId: 'get-bar',
         parameters: [
           {
             description: 'The version of the API to use',
@@ -154,7 +154,7 @@ export const sharedOas = {
     '/foo/{id}/{path*}': {
       get: {
         description: 'route description',
-        operationId: '%2Ffoo%2F%7Bid%7D%2F%7Bpath*%7D#0',
+        operationId: 'get-foo-id-path',
         parameters: [
           {
             description: 'The version of the API to use',
@@ -278,7 +278,7 @@ export const sharedOas = {
       },
       post: {
         description: 'route description',
-        operationId: '%2Ffoo%2F%7Bid%7D%2F%7Bpath*%7D#1',
+        operationId: 'post-foo-id-path',
         parameters: [
           {
             description: 'The version of the API to use',

oas_docs/bundle.serverless.json

@@ -10,10 +10,9 @@
 import type { CoreVersionedRouter, Router } from '@kbn/core-http-router-server-internal';
 import type { OpenAPIV3 } from 'openapi-types';
 import { OasConverter } from './oas_converter';
-import { createOperationIdCounter } from './operation_id_counter';
 import { processRouter } from './process_router';
 import { processVersionedRouter } from './process_versioned_router';
-import { buildGlobalTags } from './util';
+import { buildGlobalTags, createOpIdGenerator } from './util';
 
 export const openApiVersion = '3.0.0';
 
@@ -40,8 +39,8 @@ export const generateOpenApiDocument = (
 ): OpenAPIV3.Document => {
   const { filters } = opts;
   const converter = new OasConverter();
-  const getOpId = createOperationIdCounter();
   const paths: OpenAPIV3.PathsObject = {};
+  const getOpId = createOpIdGenerator();
   for (const router of appRouters.routers) {
     const result = processRouter(router, converter, getOpId, filters);
     Object.assign(paths, result.paths);

oas_docs/output/kibana.serverless.yaml

@@ -10,9 +10,9 @@
 import { schema } from '@kbn/config-schema';
 import { Router } from '@kbn/core-http-router-server-internal';
 import { OasConverter } from './oas_converter';
-import { createOperationIdCounter } from './operation_id_counter';
 import { extractResponses, processRouter } from './process_router';
 import { type InternalRouterRoute } from './type';
+import { createOpIdGenerator } from './util';
 
 describe('extractResponses', () => {
   let oasConverter: OasConverter;
@@ -86,18 +86,21 @@ describe('processRouter', () => {
   const testRouter = {
     getRoutes: () => [
       {
+        method: 'get',
         path: '/foo',
         options: { access: 'internal', deprecated: true, discontinued: 'discontinued router' },
         handler: jest.fn(),
         validationSchemas: { request: { body: schema.object({}) } },
       },
       {
+        method: 'get',
         path: '/bar',
         options: {},
         handler: jest.fn(),
         validationSchemas: { request: { body: schema.object({}) } },
       },
       {
+        method: 'get',
         path: '/baz',
         options: {},
         handler: jest.fn(),
@@ -125,20 +128,20 @@ describe('processRouter', () => {
   } as unknown as Router;
 
   it('only provides routes for version 2023-10-31', () => {
-    const result1 = processRouter(testRouter, new OasConverter(), createOperationIdCounter(), {
+    const result1 = processRouter(testRouter, new OasConverter(), createOpIdGenerator(), {
       version: '2023-10-31',
     });
 
     expect(Object.keys(result1.paths!)).toHaveLength(4);
 
-    const result2 = processRouter(testRouter, new OasConverter(), createOperationIdCounter(), {
+    const result2 = processRouter(testRouter, new OasConverter(), createOpIdGenerator(), {
       version: '2024-10-31',
     });
     expect(Object.keys(result2.paths!)).toHaveLength(0);
   });
 
   it('updates description with privileges required', () => {
-    const result = processRouter(testRouter, new OasConverter(), createOperationIdCounter(), {
+    const result = processRouter(testRouter, new OasConverter(), createOpIdGenerator(), {
       version: '2023-10-31',
     });