Feat: New API Versioning Implementation

.github/actions/build-sdk/action.yaml

@@ -17,76 +17,28 @@ runs:
     - name: Set up Node
       uses: actions/setup-node@v6
       with:
-        node-version: "24"
+        node-version: "20"
 
     - name: Set up Java
       uses: actions/setup-java@v4
       with:
         distribution: "temurin"
         java-version: "17"
+
+    - name: Install Node dependencies
+      shell: bash
+      run: npm install
 
     - name: Download OpenAPI Generator
       shell: bash
       run: |
         wget -q https://repo1.maven.org/maven2/org/openapitools/openapi-generator-cli/7.12.0/openapi-generator-cli-7.12.0.jar -O openapi-generator-cli.jar
 
-    - name: Build V3 SDK
-      shell: bash
-      run: |
-        rm -rf ./sdk-output/v3
-        java -jar openapi-generator-cli.jar generate \
-          -i ${{ inputs.api-specs-path }}/idn/sailpoint-api.v3.yaml \
-          -g typescript-axios -o sdk-output/v3 \
-          --global-property skipFormModel=false,apiDocs=true,modelDocs=true \
-          --config sdk-resources/v3-config.yaml
-
-    - name: Build Beta SDK
+    - name: Build Versioned SDK (per-partition)
       shell: bash
       run: |
-        rm -rf ./sdk-output/beta
-        java -jar openapi-generator-cli.jar generate \
-          -i ${{ inputs.api-specs-path }}/idn/sailpoint-api.beta.yaml \
-          -g typescript-axios -o sdk-output/beta \
-          --global-property skipFormModel=false,apiDocs=true,modelDocs=true \
-          --config sdk-resources/beta-config.yaml \
-          --api-name-suffix BetaApi --model-name-suffix Beta
-
-    - name: Build V2024 SDK
-      shell: bash
-      run: |
-        rm -rf ./sdk-output/v2024
-        node sdk-resources/prescript.js ${{ inputs.api-specs-path }}/idn/v2024/paths
-        java -jar openapi-generator-cli.jar generate \
-          -i ${{ inputs.api-specs-path }}/idn/sailpoint-api.v2024.yaml \
-          -g typescript-axios -o sdk-output/v2024 \
-          --global-property skipFormModel=false,apiDocs=true,modelDocs=true \
-          --config sdk-resources/v2024-config.yaml \
-          --api-name-suffix V2024Api --model-name-suffix V2024
-
-    - name: Build V2025 SDK
-      shell: bash
-      run: |
-        rm -rf ./sdk-output/v2025
-        node sdk-resources/prescript.js ${{ inputs.api-specs-path }}/idn/v2025/paths
-        java -jar openapi-generator-cli.jar generate \
-          -i ${{ inputs.api-specs-path }}/idn/sailpoint-api.v2025.yaml \
-          -g typescript-axios -o sdk-output/v2025 \
-          --global-property skipFormModel=false,apiDocs=true,modelDocs=true \
-          --config sdk-resources/v2025-config.yaml \
-          --api-name-suffix V2025Api --model-name-suffix V2025
-
-    - name: Build V2026 SDK
-      shell: bash
-      run: |
-        rm -rf ./sdk-output/v2026
-        node sdk-resources/prescript.js ${{ inputs.api-specs-path }}/idn/v2026/paths
-        java -jar openapi-generator-cli.jar generate \
-          -i ${{ inputs.api-specs-path }}/idn/sailpoint-api.v2026.yaml \
-          -g typescript-axios -o sdk-output/v2026 \
-          --global-property skipFormModel=false,apiDocs=true,modelDocs=true \
-          --config sdk-resources/v2026-config.yaml \
-          --api-name-suffix V2026Api --model-name-suffix V2026
-
+        node sdk-resources/build-versioned-sdk.js \
+          ${{ inputs.api-specs-path }}/idn/apis
 
     - name: Build NERM SDK
       shell: bash

.github/workflows/build_pr.yml

@@ -4,6 +4,7 @@ env:
   SAIL_CLIENT_ID: ${{ secrets.SDK_TEST_TENANT_CLIENT_ID }}
   SAIL_CLIENT_SECRET: ${{ secrets.SDK_TEST_TENANT_CLIENT_SECRET }}
   SAIL_BASE_URL: ${{ secrets.SDK_TEST_TENANT_BASE_URL }}
+  SAIL_NERM_BASE_URL: ${{ secrets.SDK_TEST_NERM_BASE_URL }}
 
 on:
   pull_request:

.gitignore

@@ -3,4 +3,6 @@ build
 dist
 api-specs
 sdk-output/config.json
-examples/config.json
+examples/config.json
+.sdk-build-tmp/
+build-errors/

Makefile

@@ -6,21 +6,15 @@ specs:
 clean-specs:
 	rm -rf ./api-specs
 
+APIS_DIR ?= api-specs/src/main/yaml/apis
+
 .PHONY: build
 build:
-	rm -rf ./sdk-output/v3
-	java -jar openapi-generator-cli.jar generate -i api-specs/idn/sailpoint-api.v3.yaml -g typescript-axios -o sdk-output/v3 --global-property skipFormModel=false,apiDocs=true,modelDocs=true --config sdk-resources/v3-config.yaml
-	rm -rf ./sdk-output/beta
-	java -jar openapi-generator-cli.jar generate -i api-specs/idn/sailpoint-api.beta.yaml -g typescript-axios -o sdk-output/beta --global-property skipFormModel=false,apiDocs=true,modelDocs=true --config sdk-resources/beta-config.yaml --api-name-suffix BetaApi --model-name-suffix Beta
-	rm -rf ./sdk-output/v2024
-	node sdk-resources/prescript.js api-specs/idn/v2024/paths
-	java -jar openapi-generator-cli.jar generate -i api-specs/idn/sailpoint-api.v2024.yaml -g typescript-axios -o sdk-output/v2024 --global-property skipFormModel=false,apiDocs=true,modelDocs=true --config sdk-resources/v2024-config.yaml --api-name-suffix V2024Api --model-name-suffix V2024
-	rm -rf ./sdk-output/v2025
-	node sdk-resources/prescript.js api-specs/idn/v2025/paths
-	java -jar openapi-generator-cli.jar generate -i api-specs/idn/sailpoint-api.v2025.yaml -g typescript-axios -o sdk-output/v2025 --global-property skipFormModel=false,apiDocs=true,modelDocs=true --config sdk-resources/v2025-config.yaml --api-name-suffix V2025Api --model-name-suffix V2025
-	rm -rf ./sdk-output/v2026
-	node sdk-resources/prescript.js api-specs/idn/v2026/paths
-	java -jar openapi-generator-cli.jar generate -i api-specs/idn/sailpoint-api.v2026.yaml -g typescript-axios -o sdk-output/v2026 --global-property skipFormModel=false,apiDocs=true,modelDocs=true --config sdk-resources/v2026-config.yaml --api-name-suffix V2026Api --model-name-suffix V2026
+	node sdk-resources/build-versioned-sdk.js $(APIS_DIR)
+
+.PHONY: build-partition
+build-partition:
+	node sdk-resources/build-versioned-sdk.js $(APIS_DIR) --partition $(PARTITION)
 
 .PHONY: test
 test:

package.json

@@ -0,0 +1,12 @@
+{
+  "name": "typescript-sdk-builder",
+  "version": "1.0.0",
+  "private": true,
+  "description": "Build tooling for the SailPoint Typescript SDK",
+  "scripts": {
+    "build": "node sdk-resources/build-versioned-sdk.js"
+  },
+  "dependencies": {
+    "@redocly/cli": "^2.32.2"
+  }
+}

sdk-output/access_model_metadata/.sdk-partition

@@ -0,0 +1 @@
+access-model-metadata

sdk-output/beta/README.md → sdk-output/access_model_metadata/README.md

@@ -1,4 +1,4 @@
-## sailpoint-sdk@1.8.69
+## sailpoint-api-client@1.0.0
 
 This generator creates TypeScript/JavaScript client that utilizes [axios](https://github.com/axios/axios). The generated Node module can be used in the following environments:
 
@@ -36,7 +36,7 @@ navigate to the folder of your consuming project and run one of the following co
 _published:_
 
 ```
-npm install sailpoint-sdk@1.8.69 --save
+npm install sailpoint-api-client@1.0.0 --save
 ```
 
 _unPublished (not recommended):_