@camunda8/orchestration-cluster-api 10.0.0-alpha.49 → 10.0.0-alpha.50

package/CHANGELOG.md

@@ -1,3 +1,10 @@
+# [10.0.0-alpha.50](https://github.com/camunda/orchestration-cluster-api-js/compare/v10.0.0-alpha.49...v10.0.0-alpha.50) (2026-09-30)
+
+
+### Features
+
+* **config:** add CAMUNDA_REST_ADDRESS_EXACT to opt out of /v2 suffix ([#534](https://github.com/camunda/orchestration-cluster-api-js/issues/534)) ([2797790](https://github.com/camunda/orchestration-cluster-api-js/commit/27977905b38cebb1789d6724a6c7702d50bb8679)), closes [#499](https://github.com/camunda/orchestration-cluster-api-js/issues/499)
+
 # [10.0.0-alpha.49](https://github.com/camunda/orchestration-cluster-api-js/compare/v10.0.0-alpha.48...v10.0.0-alpha.49) (2026-09-29)
 
 

package/README.md

@@ -199,6 +199,7 @@ Typical `.env` (example):
 
 ```bash
 CAMUNDA_REST_ADDRESS=https://cluster.example   # SDK will use https://cluster.example/v2/... unless /v2 already present
+# CAMUNDA_REST_ADDRESS_EXACT=true               # optional (specialized): suppress the /v2 suffix (trailing slashes/whitespace are still normalized) — only for gateway/reverse-proxy base paths
 CAMUNDA_AUTH_STRATEGY=OAUTH
 CAMUNDA_CLIENT_ID=***
 CAMUNDA_CLIENT_SECRET=***

package/dist/{CamundaClient-D0pHU3oF.d.cts → CamundaClient-DBZ5xkfB.d.cts}

@@ -22668,6 +22668,11 @@ declare const SCHEMA: {
         readonly aliases: readonly ["ZEEBE_REST_ADDRESS"];
         readonly doc: "Base REST endpoint address. Legacy alias: ZEEBE_REST_ADDRESS (used only when CAMUNDA_REST_ADDRESS is unset).";
     };
+    readonly CAMUNDA_REST_ADDRESS_EXACT: {
+        readonly type: "boolean";
+        readonly default: false;
+        readonly doc: "Disable the automatic /v2 suffix so CAMUNDA_REST_ADDRESS is used as the base path. The value is still normalized (surrounding whitespace and trailing slashes are trimmed) — this option only suppresses the /v2 append, it does not preserve the address byte-for-byte. Useful for gateway/reverse-proxy deployments whose base path does not follow the /v2 convention.";
+    };
     readonly CAMUNDA_SDK_HTTP_RETRY_MAX_ATTEMPTS: {
         readonly desc: "Maximum total HTTP attempts (including the initial attempt) for transient failures (429,503, network).";
         readonly type: "int";

package/dist/{CamundaClient-BD2Gqc3Y.d.ts → CamundaClient-DuZf_I-y.d.ts}

@@ -22668,6 +22668,11 @@ declare const SCHEMA: {
         readonly aliases: readonly ["ZEEBE_REST_ADDRESS"];
         readonly doc: "Base REST endpoint address. Legacy alias: ZEEBE_REST_ADDRESS (used only when CAMUNDA_REST_ADDRESS is unset).";
     };
+    readonly CAMUNDA_REST_ADDRESS_EXACT: {
+        readonly type: "boolean";
+        readonly default: false;
+        readonly doc: "Disable the automatic /v2 suffix so CAMUNDA_REST_ADDRESS is used as the base path. The value is still normalized (surrounding whitespace and trailing slashes are trimmed) — this option only suppresses the /v2 append, it does not preserve the address byte-for-byte. Useful for gateway/reverse-proxy deployments whose base path does not follow the /v2 convention.";
+    };
     readonly CAMUNDA_SDK_HTTP_RETRY_MAX_ATTEMPTS: {
         readonly desc: "Maximum total HTTP attempts (including the initial attempt) for transient failures (429,503, network).";
         readonly type: "int";

package/dist/{chunk-GIOXXJ73.js → chunk-GMNYLSVD.js}

@@ -4470,6 +4470,11 @@ var SCHEMA = {
     aliases: ["ZEEBE_REST_ADDRESS"],
     doc: "Base REST endpoint address. Legacy alias: ZEEBE_REST_ADDRESS (used only when CAMUNDA_REST_ADDRESS is unset)."
   },
+  CAMUNDA_REST_ADDRESS_EXACT: {
+    type: "boolean",
+    default: false,
+    doc: "Disable the automatic /v2 suffix so CAMUNDA_REST_ADDRESS is used as the base path. The value is still normalized (surrounding whitespace and trailing slashes are trimmed) \u2014 this option only suppresses the /v2 append, it does not preserve the address byte-for-byte. Useful for gateway/reverse-proxy deployments whose base path does not follow the /v2 convention."
+  },
   CAMUNDA_SDK_HTTP_RETRY_MAX_ATTEMPTS: {
     desc: "Maximum total HTTP attempts (including the initial attempt) for transient failures (429,503, network).",
     type: "int",
@@ -5029,10 +5034,13 @@ function hydrateConfig(options = {}) {
     if (isSecret(k) && v) redacted[k] = redactSecret(v);
     else redacted[k] = v;
   }
+  const _restAddressExact = reqBool("CAMUNDA_REST_ADDRESS_EXACT");
   let _restAddress = reqStr("CAMUNDA_REST_ADDRESS");
   if (_restAddress) {
     _restAddress = _restAddress.trim();
-    if (!/\/v2\/?$/i.test(_restAddress)) {
+    if (_restAddressExact) {
+      _restAddress = _restAddress.replace(/\/+$/, "");
+    } else if (!/\/v2\/?$/i.test(_restAddress)) {
       _restAddress = `${_restAddress.replace(/\/+$/, "")}/v2`;
     } else {
     }
@@ -5435,7 +5443,7 @@ function installAuthInterceptor(client2, getStrategy, getAuthHeaders) {
 }
 
 // src/runtime/version.ts
-var packageVersion = "10.0.0-alpha.49";
+var packageVersion = "10.0.0-alpha.50";
 
 // src/runtime/supportLogger.ts
 var NoopSupportLogger = class {
@@ -21727,4 +21735,4 @@ export {
   CamundaClientBase,
   CamundaClient
 };
-//# sourceMappingURL=chunk-GIOXXJ73.js.map
+//# sourceMappingURL=chunk-GMNYLSVD.js.map