@camunda8/orchestration-cluster-api 1.1.2 → 1.1.3

package/CHANGELOG.md

@@ -1,3 +1,9 @@
+## [1.1.3](https://github.com/camunda/orchestration-cluster-api-js/compare/v1.1.2...v1.1.3) (2025-11-10)
+
+### Bug Fixes
+
+- log backpressure at debug ([ef8fd69](https://github.com/camunda/orchestration-cluster-api-js/commit/ef8fd6999a39b8ed25a57a3647ec3b20928da640))
+
 ## [1.1.2](https://github.com/camunda/orchestration-cluster-api-js/compare/v1.1.1...v1.1.2) (2025-11-10)
 
 ### Bug Fixes

package/README.md

@@ -1116,3 +1116,13 @@ const client = createCamundaClient({
 ## License
 
 Apache 2.0
+
+## API Documentation
+
+Generate an HTML API reference site with TypeDoc (public entry points only):
+
+```bash
+npm run docs:api
+```
+
+Output: static site in `docs/api` (open `docs/api/index.html` in a browser or serve the folder, e.g. `npx http-server docs/api`). Entry points: `src/index.ts`, `src/logger.ts`, `src/fp/index.ts`. Internal generated code, scripts, tests are excluded and private / protected members are filtered. Regenerate after changing public exports.

package/dist/{chunk-FMCCRZJE.js → chunk-OL2FCI2Q.js}

@@ -9614,7 +9614,7 @@ function installAuthInterceptor(client2, getStrategy, getAuthHeaders) {
 }
 
 // src/runtime/version.ts
-var packageVersion = "1.1.1";
+var packageVersion = "1.1.2";
 
 // src/runtime/supportLogger.ts
 var NoopSupportLogger = class {
@@ -10372,10 +10372,19 @@ var BackpressureManager = class {
       waiters: this.waiters.length
     };
   }
-  log(evt, data) {
+  log(evt, data, prevSeverity) {
     this.logger?.trace?.(() => ["backpressure." + evt, data]);
-    if (evt === "severity" || evt.startsWith("permits.")) {
-      this.logger?.info?.(() => ["bp.state.change", { event: evt, ...data }]);
+    if (evt === "severity") {
+      const curr = data.severity;
+      const enteringUnhealthy = prevSeverity === "healthy" && curr !== "healthy";
+      const recoveringHealthy = prevSeverity !== "healthy" && curr === "healthy";
+      const level = enteringUnhealthy || recoveringHealthy ? "info" : "debug";
+      this.logger?.[level]?.(() => [
+        "bp.state.change",
+        { event: evt, from: prevSeverity, to: curr }
+      ]);
+    } else if (evt.startsWith("permits.")) {
+      this.logger?.debug?.(() => ["bp.state.change", { event: evt, ...data }]);
     }
   }
   async acquire(signal) {
@@ -10437,7 +10446,8 @@ var BackpressureManager = class {
     } else if (this.severity === "soft") {
       if (!this.observeOnly) this.scalePermits(this.cfg.reduceFactor);
     }
-    if (this.severity !== prevSeverity) this.log("severity", { severity: this.severity });
+    if (this.severity !== prevSeverity)
+      this.log("severity", { severity: this.severity }, prevSeverity);
   }
   recordHealthyHint() {
     if (!this.cfg.enabled && !this.observeOnly) return;
@@ -10457,16 +10467,17 @@ var BackpressureManager = class {
     if (now2 - this.lastRecoverCheck < this.cfg.recoveryIntervalMs) return;
     this.lastRecoverCheck = now2;
     if (now2 - this.lastEventAt > this.cfg.decayQuietMs) {
+      const prev = this.severity;
       if (this.severity === "severe") this.severity = "soft";
       else if (this.severity === "soft") this.severity = "healthy";
       if (this.severity === "healthy") this.consecutive = 0;
-      this.log("severity", { severity: this.severity });
+      if (prev !== this.severity) this.log("severity", { severity: this.severity }, prev);
     }
     if (this.permitsMax !== null) {
       const bootstrapCap = this.cfg.initialMaxConcurrency ?? 16;
       if (this.permitsMax < bootstrapCap) {
         this.permitsMax = Math.min(bootstrapCap, this.permitsMax + this.cfg.recoveryStep);
-        this.log("permits.recover", { max: this.permitsMax });
+        this.log("permits.recover", { max: this.permitsMax }, this.severity);
         this.release();
       }
     }
@@ -18762,4 +18773,4 @@ export {
   withTimeoutTE,
   eventuallyTE
 };
-//# sourceMappingURL=chunk-FMCCRZJE.js.map
+//# sourceMappingURL=chunk-OL2FCI2Q.js.map