Feature/isolate openapi gen templates (#4168)

## Proposed change

feat: isolate and extend the OpenApi TypescriptFetch template

<!--
Please include a summary of the changes and the related issue.
Please also include relevant motivation and context.
-->

## Related issues

<!--
Please make sure to follow the [contribution
guidelines](https://github.com/amadeus-digital/Otter/blob/main/CONTRIBUTING.md)
-->

*- No issue associated -*

<!-- * 🐛 Fix #issue -->
<!-- * 🐛 Fix resolves #issue -->
<!-- * 🚀 Feature #issue -->
<!-- * 🚀 Feature resolves #issue -->
*  Pull Request #4159

Author: kpanot

.github/workflows/check-release.yml

@@ -49,7 +49,7 @@ jobs:
       - uses: ./.github/actions/setup-java
         with:
           install-jdk: 'true'
-      - run: yarn build:swagger-gen
+      - run: yarn build:jar
       - run: yarn build
       - uses: ./tools/github-actions/upload-build-output
         with:

.github/workflows/code-check.yml

@@ -78,7 +78,7 @@ jobs:
             ${{ runner.os }}-jest
             ${{ runner.os }}
       - name: Build swagger generator
-        run: yarn nx run ama-sdk-schematics:build-swagger
+        run: yarn build:jar
       - name: Test
         env:
           NX_BASE: ${{ format('remotes/origin/{0}', github.base_ref || github.ref_name) }}

nx.json

@@ -699,8 +699,15 @@
       ],
       "cache": true
     },
-    "build-swagger": {
-      "cache": true
+    "build-jar": {
+      "inputs": [
+        "source",
+        "{projectRoot}/pom.xml"
+      ],
+      "outputs": [
+        "{projectRoot}/target/*.jar"
+      ],
+      "cache": false
     },
     "i18n": {
       "cache": true
@@ -742,4 +749,4 @@
   "cacheDirectory": ".cache/nx",
   "nxCloudId": "63e6951e043da20dd8321aec",
   "analytics": false
-}
+}

package.json

@@ -16,7 +16,7 @@
     "build:tools": "yarn nx run-many --tui=false --target=build --projects=tag:hook:postinstall",
     "build:lint": "yarn nx run-many --tui=false --target=build --projects=eslint-plugin",
     "build:ama-openapi": "yarn nx run-many --tui=false  --target=build --projects=tag:scope:ama-openapi",
-    "build:swagger-gen": "yarn nx run-many --target=build-swagger",
+    "build:jar": "yarn nx run-many --target=build-jar",
     "publish": "yarn nx run-many --target=prepare-publish --exclude-task-dependencies && yarn nx run-many --target=publish --exclude=tag:access:private",
     "publish:extensions": "yarn nx run-many --target=prepare-publish --exclude-task-dependencies && yarn nx run-many --target=publish-extension",
     "publish:extensions:affected": "yarn nx affected --target=publish-extension",

…re/openapi-codegen-typescript/.gitignore …dk/openapi-codegen-typescript/.gitignorepackages/@ama-sdk/schematics/schematics/typescript/core/openapi-codegen-typescript/.gitignore renamed to packages/@ama-sdk/openapi-codegen-typescript/.gitignore packages/@ama-sdk/schematics/schematics/typescript/core/openapi-codegen-typescript/.gitignore renamed to packages/@ama-sdk/openapi-codegen-typescript/.gitignore

@@ -0,0 +1,19 @@
+{
+  "name": "@ama-sdk/openapi-codegen-typescript",
+  "version": "0.0.0-placeholder",
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build:jar": "mvn clean package -f ./pom.xml",
+    "build:jar:optional": "yarn run build:jar || true"
+  },
+  "main": "./target/typescriptFetch-openapi-generator.jar",
+  "exports": {
+    ".": "./target/typescriptFetch-openapi-generator.jar",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "./target/typescriptFetch-openapi-generator.jar"
+  ]
+}

…ore/openapi-codegen-typescript/README.md …sdk/openapi-codegen-typescript/README.mdpackages/@ama-sdk/schematics/schematics/typescript/core/openapi-codegen-typescript/README.md renamed to packages/@ama-sdk/openapi-codegen-typescript/README.md packages/@ama-sdk/schematics/schematics/typescript/core/openapi-codegen-typescript/README.md renamed to packages/@ama-sdk/openapi-codegen-typescript/README.md

@@ -87,11 +87,6 @@
     </plugins>
   </build>
   <dependencies>
-    <dependency>
-      <groupId>io.swagger.core.v3</groupId>
-      <artifactId>swagger-core</artifactId>
-      <version>2.2.49</version>
-    </dependency>
     <dependency>
       <groupId>org.openapitools</groupId>
       <artifactId>openapi-generator</artifactId>

packages/@ama-sdk/openapi-codegen-typescript/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "ama-sdk-openapi-codegen-typescript",
+  "$schema": "https://raw.githubusercontent.com/nrwl/nx/master/packages/nx/schemas/project-schema.json",
+  "projectType": "library",
+  "sourceRoot": "packages/@ama-sdk/openapi-codegen-typescript/src",
+  "prefix": "o3r",
+  "targets": {
+    "build": {
+      "executor": "nx:noop",
+      "dependsOn": [
+        "build-jar:optional"
+      ]
+    },
+    "build-jar": {
+      "executor": "nx:run-script",
+      "options": {
+        "script": "build:jar"
+      },
+      "configurations": {
+        "optional": {
+          "script": "build:jar:optional"
+        }
+      }
+    },
+    "publish": {
+      "inputs": [
+        "{projectRoot}/target/typescriptFetch-openapi-generator.jar"
+      ]
+    }
+  },
+  "tags": []
+}

…/core/openapi-codegen-typescript/pom.xml …a-sdk/openapi-codegen-typescript/pom.xmlpackages/@ama-sdk/schematics/schematics/typescript/core/openapi-codegen-typescript/pom.xml renamed to packages/@ama-sdk/openapi-codegen-typescript/pom.xml packages/@ama-sdk/schematics/schematics/typescript/core/openapi-codegen-typescript/pom.xml renamed to packages/@ama-sdk/openapi-codegen-typescript/pom.xml

@@ -67,6 +67,14 @@ public abstract class AbstractTypeScriptClientCodegen extends org.openapitools.c
   /** Custom request body transformation logic (GlobalSettings: requestBodyTransform, default: empty) */
   private final String requestBodyTransform;
 
+  /**
+   * Preprocesses the OpenAPI specification to extract operation adapter paths.
+   * This generates the OPERATION_ADAPTER data structure used for runtime operation matching.
+   *
+   * @param openAPI the OpenAPI specification to preprocess
+   */
+  protected abstract void preprocessOperationAdapter(OpenAPI openAPI);
+
   /**
    * Constructor for Otter-specific TypeScript client code generator.
    *
@@ -559,6 +567,18 @@ public void postProcessParameter(CodegenParameter parameter) {
     }
   }
 
+    /**
+   * Otter-specific override: Add any additional preprocessing logic for the OpenAPI specification:
+   * - Extract operation adapter paths for runtime matching and add to additionalProperties for template access.
+   *
+   * @param openAPI the OpenAPI specification to preprocess
+   */
+  @Override
+  public void preprocessOpenAPI(OpenAPI openAPI) {
+    super.preprocessOpenAPI(openAPI);
+    this.preprocessOperationAdapter(openAPI);
+  }
+
   /**
    * Otter-specific: Returns the TypeScript type for date-time objects without timezone modification.
    *