fix(openapi): collapse dotted operationIds into valid endpoint names (#17310)

* fix(openapi): collapse dotted operationIds into valid endpoint names

Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>

* fix(openapi): sanitize dotted method names after tokenization in v3 importer

Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>

* chore(cli): call out method rename in changelog entry

Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>

---------

Co-authored-by: dakshesh.daruri <support@buildwithfern.com>
Co-authored-by: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
Co-authored-by: Dak <dakshesh@buildwithfern.com>

Author: 3 people

packages/cli/api-importers/openapi-to-ir/src/3.1/paths/operations/AbstractOperationConverter.ts

@@ -332,12 +332,19 @@ export abstract class AbstractOperationConverter extends AbstractConverter<
         return operationId;
     }
 
+    // A dot in a method name is parsed as a reference to another file (`import.endpoint`),
+    // so dotted operation ids must be collapsed into a single name. This runs after
+    // tokenization so that grouping still sees the individual tokens.
+    protected sanitizeMethodName(methodName: string): string {
+        return methodName.includes(".") ? camelCase(methodName) : methodName;
+    }
+
     protected computeGroupNameFromTagAndOperationId(): GroupNameAndLocation {
         const tag = this.operation.tags?.[0];
         const methodName = this.evaluateMethodNameFromOperation();
 
         if (tag == null) {
-            return { method: methodName };
+            return { method: this.sanitizeMethodName(methodName) };
         }
 
         const tagTokens = tokenizeString(tag);
@@ -372,7 +379,7 @@ export abstract class AbstractOperationConverter extends AbstractConverter<
         if (tagIsNotPrefixOfMethodName) {
             return {
                 group: [tag],
-                method: methodName
+                method: this.sanitizeMethodName(methodName)
             };
         }