feat: handle x-codegen operation extension to customize codegen output

Author: patrick-medusajs

src/client/interfaces/Operation.d.ts

@@ -1,6 +1,7 @@
 import type { OperationError } from './OperationError';
 import type { OperationParameters } from './OperationParameters';
 import type { OperationResponse } from './OperationResponse';
+import type { OperationCodegen } from './OperationCodegen';
 
 export interface Operation extends OperationParameters {
     service: string;
@@ -13,4 +14,5 @@ export interface Operation extends OperationParameters {
     errors: OperationError[];
     results: OperationResponse[];
     responseHeader: string | null;
+    codegen: OperationCodegen;
 }

src/client/interfaces/OperationCodegen.d.ts

@@ -0,0 +1,4 @@
+export interface OperationCodegen {
+    method?: string;
+    queryParams?: string;
+}

src/openApi/v3/interfaces/OpenApiOperation.d.ts

@@ -23,4 +23,5 @@ export interface OpenApiOperation {
     deprecated?: boolean;
     security?: OpenApiSecurityRequirement[];
     servers?: OpenApiServer[];
+    'x-codegen'?: Record<string, unknown>;
 }

src/openApi/v3/parser/getOperation.ts

@@ -1,5 +1,6 @@
 import type { Operation } from '../../../client/interfaces/Operation';
 import type { OperationParameters } from '../../../client/interfaces/OperationParameters';
+import type { OperationCodegen } from '../../../client/interfaces/OperationCodegen';
 import type { OpenApi } from '../interfaces/OpenApi';
 import type { OpenApiOperation } from '../interfaces/OpenApiOperation';
 import type { OpenApiRequestBody } from '../interfaces/OpenApiRequestBody';
@@ -24,11 +25,13 @@ export const getOperation = (
 ): Operation => {
     const serviceName = getServiceName(tag);
     const operationName = getOperationName(url, method, op.operationId);
+    const codegen: OperationCodegen = op['x-codegen'] || {};
 
     // Create a new operation object for this method.
     const operation: Operation = {
         service: serviceName,
-        name: operationName,
+        name: codegen.method || operationName,
+        operationId: op.operationId || null,
         summary: op.summary || null,
         description: op.description || null,
         deprecated: op.deprecated === true,
@@ -45,6 +48,7 @@ export const getOperation = (
         errors: [],
         results: [],
         responseHeader: null,
+        codegen,
     };
 
     // Parse the operation parameters (path, query, body, etc).