feat(core): allow operationName override to decouple type names from method names (#3684)

The override.operationName callback can now return [methodName, typeNameBase]
to independently control generated function/hook names from TypeScript type
identifier names (*Params, *Body, *Error, *Result, *Accept, zod/hono/effect
schema names). Returning a string (existing behavior) keeps both identical.

This enables gateway-aggregated specs with tags-split + splitByTags + indexFiles
where bare method names are safe per-tag but type names need global uniqueness
to avoid barrel-level TS2300 collisions.

Fully backward compatible — existing callbacks returning string work unchanged.
The tuple form is opt-in.

Author: aqeelat

docs/content/docs/reference/configuration/output.mdx

@@ -2192,7 +2192,9 @@ Override by OpenAPI tag (same options as `operations`).
 
 **Type:** `Function`
 
-Custom function to override generated operation names:
+Custom function to override generated operation names.
+
+**Return `string`** to control both the method name and the type-name base together:
 
 ```ts title="orval.config.ts"
 export default defineConfig({
@@ -2208,6 +2210,46 @@ export default defineConfig({
 });
 ```
 
+**Return `[methodName, typeNameBase]`** to decouple method names from type-identifier names. This is useful for gateway-aggregated specs where multiple services share the same REST patterns (`GET /products`, `GET /orders`) — bare method names are safe per-tag (each service class scopes them), but type names (`*Params`, `*Body`, `*Error`, `*Result`) need to be globally unique to avoid barrel-level collisions with `tags-split` + `splitByTags` + `indexFiles`:
+
+```ts title="orval.config.ts"
+import { pascal } from '@orval/core';
+
+export default defineConfig({
+  api: {
+    output: {
+      mode: 'tags-split',
+      schemas: { path: './model', splitByTags: true },
+      override: {
+        operationName: (_operation, route, verb) => {
+          const segments = route.split('/').filter(Boolean);
+          return [
+            `${verb}${pascal(segments.slice(2).join('-'))}`,  // getProducts
+            `${verb}${pascal(segments.slice(1).join('-'))}`,  // getCatalogProducts
+          ];
+        },
+      },
+    },
+  },
+});
+```
+
+Result:
+
+```ts
+// catalog/catalog.service.ts
+class CatalogService {
+  getProducts = (params: GetCatalogProductsParams) => ...;
+}
+
+// inventory/inventory.service.ts
+class InventoryService {
+  getProducts = (params: GetInventoryProductsParams) => ...;
+}
+```
+
+The first element controls the function/hook name. The second controls the base for all operation-specific TypeScript type identifiers (`*Params`, `*Body`, `*Error`, `*Result`, `*Accept`, zod/hono/effect schema names).
+
 ---
 
 ## override.components

packages/angular/src/http-client.test.ts

@@ -201,6 +201,7 @@ const createVerbOption = (
   ({
     operationId: 'getPetById',
     operationName: 'getPetById',
+    typeName: 'getPetById',
     verb: 'get',
     route: '/pets/${petId}',
     pathRoute: '/pets/{petId}',
@@ -553,6 +554,7 @@ describe('angular HttpClient generator', () => {
     it('still emits the shared helper when at least one operation lacks paramsFilter', () => {
       const verbWithFilter = createVerbOption({
         operationName: 'a',
+        typeName: 'a',
         queryParams: createQueryParams({
           schema: { name: 'AParams', model: '', imports: [] },
         }),
@@ -569,6 +571,7 @@ describe('angular HttpClient generator', () => {
       });
       const verbWithoutFilter = createVerbOption({
         operationName: 'b',
+        typeName: 'b',
         queryParams: createQueryParams({
           schema: { name: 'BParams', model: '', imports: [] },
         }),
@@ -870,6 +873,7 @@ describe('angular HttpClient generator', () => {
       const verbOption = createVerbOption({
         operationId: 'createPet',
         operationName: 'createPet',
+        typeName: 'createPet',
         verb: 'post',
         route: '/pets',
         pathRoute: '/pets',
@@ -911,6 +915,7 @@ describe('angular HttpClient generator', () => {
       const verbOption = createVerbOption({
         operationId: 'updatePet',
         operationName: 'updatePet',
+        typeName: 'updatePet',
         verb: 'put',
         route: '/pets/${petId}',
         pathRoute: '/pets/{petId}',
@@ -960,6 +965,7 @@ describe('angular HttpClient generator', () => {
       const verbOption = createVerbOption({
         operationId: 'deletePet',
         operationName: 'deletePet',
+        typeName: 'deletePet',
         verb: 'delete',
         route: '/pets/${petId}',
         pathRoute: '/pets/{petId}',
@@ -1031,6 +1037,7 @@ describe('angular HttpClient generator', () => {
       const verbOption = createVerbOption({
         operationId: 'authenticate',
         operationName: 'authenticate',
+        typeName: 'authenticate',
         verb: 'post',
         route: '/api/auth',
         pathRoute: '/api/auth',
@@ -1125,6 +1132,7 @@ describe('angular HttpClient generator', () => {
       const verbOption = createVerbOption({
         operationId: 'getPetFile',
         operationName: 'getPetFile',
+        typeName: 'getPetFile',
         response: baseResponse({
           definition: { success: 'Pet | string', errors: 'Error' },
           types: {
@@ -1158,6 +1166,7 @@ describe('angular HttpClient generator', () => {
       const verbOption = createVerbOption({
         operationId: 'updatePet',
         operationName: 'updatePet',
+        typeName: 'updatePet',
         verb: 'put',
         route: '/pets/${petId}',
         pathRoute: '/pets/{petId}',
@@ -1219,6 +1228,7 @@ describe('angular HttpClient generator', () => {
       const verbOption = createVerbOption({
         operationId: 'confirmReservation',
         operationName: 'confirmReservation',
+        typeName: 'confirmReservation',
         verb: 'post',
         route: '/reservations/${token}/confirm',
         pathRoute: '/reservations/{token}/confirm',
@@ -1303,6 +1313,7 @@ describe('angular HttpClient generator', () => {
       const verbOption = createVerbOption({
         operationId: 'updatePet',
         operationName: 'updatePet',
+        typeName: 'updatePet',
         verb: 'put',
         route: '/pets/${petId}',
         pathRoute: '/pets/{petId}',
@@ -1371,6 +1382,7 @@ describe('angular HttpClient generator', () => {
       const verbOption = createVerbOption({
         operationId: 'listPets',
         operationName: 'listPets',
+        typeName: 'listPets',
         route: '/pets',
         pathRoute: '/pets',
         params: [],
@@ -1420,6 +1432,7 @@ describe('angular HttpClient generator', () => {
       const verbOption = createVerbOption({
         operationId: 'deletePet',
         operationName: 'deletePet',
+        typeName: 'deletePet',
         verb: 'delete',
         route: '/pets/${petId}',
         pathRoute: '/pets/{petId}',
@@ -1480,6 +1493,7 @@ describe('angular HttpClient generator', () => {
       const verbOption = createVerbOption({
         operationId: 'listPets',
         operationName: 'listPets',
+        typeName: 'listPets',
         route: '/pets',
         pathRoute: '/pets',
         params: [],
@@ -1707,6 +1721,7 @@ describe('angular HttpClient generator', () => {
       const verbOption = createVerbOption({
         operationId: 'createPet',
         operationName: 'createPet',
+        typeName: 'createPet',
         verb: 'post',
         route: '/pets',
         pathRoute: '/pets',
@@ -1827,6 +1842,7 @@ describe('angular HttpClient generator', () => {
           getPetFile: createVerbOption({
             operationId: 'getPetFile',
             operationName: 'getPetFile',
+            typeName: 'getPetFile',
             response: baseResponse({
               definition: { success: 'Pet | string', errors: 'Error' },
               types: {
@@ -1909,6 +1925,7 @@ describe('angular HttpClient generator', () => {
       const verbOption = createVerbOption({
         operationId: 'listPets',
         operationName: 'listPets',
+        typeName: 'listPets',
         route: '/pets',
         pathRoute: '/pets',
         params: [],

packages/angular/src/http-client.ts

@@ -132,8 +132,8 @@ export const getAngularDependencies: ClientDependenciesBuilder = () => [
  *
  * @returns A PascalCase helper type/const name for the operation's `Accept` values.
  */
-export const getAcceptHelperName = (operationName: string) =>
-  `${pascal(operationName)}Accept`;
+export const getAcceptHelperName = (typeName: string) =>
+  `${pascal(typeName)}Accept`;
 
 /**
  * Collects the distinct successful response content types for a single
@@ -155,11 +155,11 @@ const toAcceptHelperKey = (contentType: string): string =>
     .toLowerCase();
 
 const buildAcceptHelper = (
-  operationName: string,
+  typeName: string,
   contentTypes: string[],
   output: ContextSpec['output'],
 ): string => {
-  const acceptHelperName = getAcceptHelperName(operationName);
+  const acceptHelperName = getAcceptHelperName(typeName);
   const unionValue = contentTypes
     .map((contentType) => `'${contentType}'`)
     .join(' | ');
@@ -200,9 +200,7 @@ export const buildAcceptHelpers = (
       );
       if (contentTypes.length <= 1) return [];
 
-      return [
-        buildAcceptHelper(verbOption.operationName, contentTypes, output),
-      ];
+      return [buildAcceptHelper(verbOption.typeName, contentTypes, output)];
     })
     .join('\n\n');
 
@@ -306,6 +304,7 @@ export const generateHttpClientImplementation = (
     headers,
     queryParams,
     operationName,
+    typeName,
     response,
     mutator,
     body,
@@ -404,7 +403,7 @@ export const generateHttpClientImplementation = (
   returnTypesRegistry.set(
     operationName,
     `export type ${pascal(
-      operationName,
+      typeName,
     )}ClientResult = NonNullable<${resultAliasType}>`,
   );
 
@@ -476,7 +475,7 @@ export const generateHttpClientImplementation = (
   const uniqueContentTypes = getUniqueContentTypes(successTypes);
   const hasMultipleContentTypes = uniqueContentTypes.length > 1;
   const acceptTypeName = hasMultipleContentTypes
-    ? getAcceptHelperName(operationName)
+    ? getAcceptHelperName(typeName)
     : undefined;
 
   const needsObserveBranching = isRequestOptions && !hasMultipleContentTypes;