@camunda8/orchestration-cluster-api 8.9.0-alpha.12 → 8.9.0-alpha.13

package/CHANGELOG.md

@@ -1,9 +1,15 @@
-# [8.9.0-alpha.12](https://github.com/camunda/orchestration-cluster-api-js/compare/v8.9.0-alpha.11...v8.9.0-alpha.12) (2026-03-08)
+# [8.9.0-alpha.13](https://github.com/camunda/orchestration-cluster-api-js/compare/v8.9.0-alpha.12...v8.9.0-alpha.13) (2026-03-09)
+
+
+### Features
+
+* add backoff-at-floor to backpressure algorithm ([a0504bc](https://github.com/camunda/orchestration-cluster-api-js/commit/a0504bcdfd3e24c47e168cddc59aeae957bfc8dd))
 
+# [8.9.0-alpha.12](https://github.com/camunda/orchestration-cluster-api-js/compare/v8.9.0-alpha.11...v8.9.0-alpha.12) (2026-03-08)
 
 ### Features
 
-* build from hardened contract in 8.9 ([03ef35a](https://github.com/camunda/orchestration-cluster-api-js/commit/03ef35a9cda1913bf11bd42b07ae95829d4118cc))
+- build from hardened contract in 8.9 ([03ef35a](https://github.com/camunda/orchestration-cluster-api-js/commit/03ef35a9cda1913bf11bd42b07ae95829d4118cc))
 
 # [8.9.0-alpha.11](https://github.com/camunda/orchestration-cluster-api-js/compare/v8.9.0-alpha.10...v8.9.0-alpha.11) (2026-03-06)
 

package/dist/{chunk-4LIDRKND.js → chunk-ULXL7H75.js}

@@ -12426,7 +12426,7 @@ function installAuthInterceptor(client2, getStrategy, getAuthHeaders) {
 }
 
 // src/runtime/version.ts
-var packageVersion = "8.9.0-alpha.12";
+var packageVersion = "8.9.0-alpha.13";
 
 // src/runtime/supportLogger.ts
 var NoopSupportLogger = class {
@@ -13226,6 +13226,7 @@ async function executeWithHttpRetry(fn, policy, logger, classify = defaultHttpCl
 var BackpressureManager = class {
   logger;
   now;
+  sleep;
   cfg;
   severity = "healthy";
   consecutive = 0;
@@ -13238,9 +13239,12 @@ var BackpressureManager = class {
   observeOnly = false;
   healthySince = 0;
   // timestamp when severity last became healthy
+  backoffMs = 0;
+  // current backoff delay in ms (0 = no backoff)
   constructor(opts = {}) {
     this.logger = opts.logger;
     this.now = opts.now || (() => Date.now());
+    this.sleep = opts.sleep || ((ms) => new Promise((r) => setTimeout(r, ms)));
     this.cfg = {
       enabled: true,
       initialMaxConcurrency: null,
@@ -13254,6 +13258,9 @@ var BackpressureManager = class {
       maxWaiters: 1e3,
       healthyRecoveryMultiplier: 1.5,
       unlimitedAfterHealthyMs: 3e4,
+      backoffInitialMs: 25,
+      backoffMaxMs: 2e3,
+      backoffEscalate: 2,
       ...opts.config
     };
     this.observeOnly = !!this.cfg.observeOnly;
@@ -13269,7 +13276,8 @@ var BackpressureManager = class {
       // When disabled, report unlimited semantics explicitly
       permitsMax: this.cfg.enabled === false ? null : this.permitsMax,
       permitsCurrent: this.cfg.enabled === false ? 0 : this.permitsCurrent,
-      waiters: this.waiters.length
+      waiters: this.waiters.length,
+      backoffMs: this.backoffMs
     };
   }
   log(evt, data, prevSeverity) {
@@ -13291,6 +13299,10 @@ var BackpressureManager = class {
     if (this.observeOnly) return;
     if (!this.isEnabled()) return;
     if (this.permitsMax === null) return;
+    if (this.backoffMs > 0) {
+      await this.sleep(this.backoffMs);
+      if (this.permitsMax === null) return;
+    }
     if (this.permitsCurrent < (this.permitsMax || 0)) {
       this.permitsCurrent++;
       return;
@@ -13354,11 +13366,23 @@ var BackpressureManager = class {
     } else if (this.severity === "soft") {
       if (!this.observeOnly) this.scalePermits(this.cfg.reduceFactor);
     }
+    if (!this.observeOnly && this.permitsMax !== null && this.permitsMax <= this.cfg.floorConcurrency && this.severity === "severe") {
+      if (this.backoffMs === 0) {
+        this.backoffMs = this.cfg.backoffInitialMs;
+      } else {
+        this.backoffMs = Math.min(this.cfg.backoffMaxMs, this.backoffMs * this.cfg.backoffEscalate);
+      }
+      this.log("backoff.escalate", { delayMs: this.backoffMs });
+    }
     if (this.severity !== prevSeverity)
       this.log("severity", { severity: this.severity }, prevSeverity);
   }
   recordHealthyHint() {
     if (!this.cfg.enabled && !this.observeOnly) return;
+    if (this.backoffMs > 0) {
+      this.backoffMs = 0;
+      this.log("backoff.clear", { reason: "healthy-hint" });
+    }
     const now2 = this.now();
     this.maybeRecover(now2);
   }
@@ -13382,13 +13406,23 @@ var BackpressureManager = class {
         this.healthySince = now2;
       }
       if (this.severity === "healthy") this.consecutive = 0;
-      if (prev !== this.severity) this.log("severity", { severity: this.severity }, prev);
+      if (prev !== this.severity) {
+        if (this.backoffMs > 0) {
+          this.backoffMs = 0;
+          this.log("backoff.clear", { reason: "severity-decay" });
+        }
+        this.log("severity", { severity: this.severity }, prev);
+      }
     }
     if (this.permitsMax !== null) {
       const bootstrapCap = this.cfg.initialMaxConcurrency ?? 16;
       if (this.severity !== "healthy") {
         if (this.permitsMax < bootstrapCap) {
           this.permitsMax = Math.min(bootstrapCap, this.permitsMax + this.cfg.recoveryStep);
+          if (this.permitsMax > this.cfg.floorConcurrency && this.backoffMs > 0) {
+            this.backoffMs = 0;
+            this.log("backoff.clear", { reason: "left-floor" });
+          }
           this.log("permits.recover", { max: this.permitsMax, phase: "additive" }, this.severity);
           this.release();
         }
@@ -13396,6 +13430,7 @@ var BackpressureManager = class {
         if (this.healthySince > 0 && now2 - this.healthySince >= this.cfg.unlimitedAfterHealthyMs) {
           this.permitsMax = null;
           this.permitsCurrent = 0;
+          this.backoffMs = 0;
           while (this.waiters.length) {
             const w = this.waiters.shift();
             try {
@@ -23515,4 +23550,4 @@ export {
   withTimeoutTE,
   eventuallyTE
 };
-//# sourceMappingURL=chunk-4LIDRKND.js.map
+//# sourceMappingURL=chunk-ULXL7H75.js.map