@camunda/e2e-test-suite 0.0.979 → 0.0.980

package/dist/tests/c8Run-8.9/hto-user-flows.spec.js

@@ -5,8 +5,10 @@ const c8Run_8_9_1 = require("../../fixtures/c8Run-8.9");
 const zeebeClient_1 = require("../../utils/zeebeClient");
 const UtilitiesPage_1 = require("../../pages/c8Run-8.9/UtilitiesPage");
 const sleep_1 = require("../../utils/sleep");
+const apiHelpers_1 = require("../../utils/apiHelpers");
 const _setup_1 = require("../../test-setup.js");
 c8Run_8_9_1.test.beforeAll(async () => {
+    await (0, apiHelpers_1.waitForOrchestrationClusterReady)();
     await Promise.all([
         (0, zeebeClient_1.deploy)('./resources/User_Task_Editing_Variables.bpmn'),
         (0, zeebeClient_1.deploy)('./resources/Zeebe_User_Task.bpmn'),

package/dist/utils/apiHelpers.d.ts

@@ -18,6 +18,7 @@ export declare function authC8runAPI(name: string, password: string): Promise<vo
 export declare function validateMcpServerHealth(serverUrl?: string): Promise<APIResponse>;
 export declare function waitForConnectorsReady(baseUrl?: string | undefined, timeoutMs?: number, requiredJobTypes?: string[]): Promise<void>;
 export declare function waitForInboundWebhookRegistered(webhookPath: string, baseUrl?: string | undefined, timeoutMs?: number): Promise<void>;
+export declare function waitForOrchestrationClusterReady(managementUrl?: string, timeoutMs?: number): Promise<void>;
 export declare function deployProcess(filePath: string, authToken?: string, environment?: 'saas' | 'sm', clusterType?: string): Promise<number | null>;
 export declare function createProcessInstance(processDefinitionKey: string, authToken?: string, environment?: 'saas' | 'sm', clusterType?: string, variables?: Record<string, unknown>): Promise<string>;
 export declare function waitForProcessInstanceVisible(processInstanceKey: string, authToken?: string, environment?: 'saas' | 'sm', clusterType?: string, maxAttempts?: number, retryDelayMs?: number): Promise<void>;

package/dist/utils/apiHelpers.js

@@ -3,7 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.updateClusterDataFilters = exports.getClusterDataFilters = exports.getTestClusterUuid = exports.authConsoleManagementAPI = exports.updateCollectionScope = exports.createSingleProcessReport = exports.createDashboard = exports.createCollection = exports.getOptimizeCookieSm = exports.getOptimizeCoockie = exports.createStringClusterVariable = exports.createJsonClusterVariable = exports.waitForProcessInstanceVisible = exports.createProcessInstance = exports.deployProcess = exports.waitForInboundWebhookRegistered = exports.waitForConnectorsReady = exports.validateMcpServerHealth = exports.authC8runAPI = exports.authSmAPI = exports.authSaasAPI = exports.authAPI = exports.buildZeebeApiUrl = exports.retryOn500 = exports.sendRequestAndAssertResponse = exports.assertUnauthorizedResponseBody = exports.expectUnauthorizedErrorBody = exports.assertResponseStatus = exports.getApiRequestContext = void 0;
+exports.updateClusterDataFilters = exports.getClusterDataFilters = exports.getTestClusterUuid = exports.authConsoleManagementAPI = exports.updateCollectionScope = exports.createSingleProcessReport = exports.createDashboard = exports.createCollection = exports.getOptimizeCookieSm = exports.getOptimizeCoockie = exports.createStringClusterVariable = exports.createJsonClusterVariable = exports.waitForProcessInstanceVisible = exports.createProcessInstance = exports.deployProcess = exports.waitForOrchestrationClusterReady = exports.waitForInboundWebhookRegistered = exports.waitForConnectorsReady = exports.validateMcpServerHealth = exports.authC8runAPI = exports.authSmAPI = exports.authSaasAPI = exports.authAPI = exports.buildZeebeApiUrl = exports.retryOn500 = exports.sendRequestAndAssertResponse = exports.assertUnauthorizedResponseBody = exports.expectUnauthorizedErrorBody = exports.assertResponseStatus = exports.getApiRequestContext = void 0;
 const test_1 = require("@playwright/test");
 const sleep_1 = require("./sleep");
 const randomSleep_1 = require("./randomSleep");
@@ -408,6 +408,69 @@ async function waitForInboundWebhookRegistered(webhookPath, baseUrl = process.en
     }).toPass({ intervals: [5000, 10000, 15000], timeout: timeoutMs });
 }
 exports.waitForInboundWebhookRegistered = waitForInboundWebhookRegistered;
+// ---- Orchestration Cluster Health Check ----
+// Polls the c8Run management API until the orchestration cluster can accept
+// commands, so a `beforeAll` that deploys through zeebe-node never issues its
+// first gRPC call against a broker that is not serving yet.
+//
+// The gate exists because every zeebe-node call is unbounded: ZBClient defaults
+// to `maxRetries: -1`, so `deploy`/`createProcessInstance` retry gRPC code 14
+// (gateway unreachable) and code 8 (backpressure) forever. Such a call neither
+// resolves nor rejects, it just drains the caller's whole hook budget, and
+// Playwright can then only report `"beforeAll" hook timeout of 720000ms
+// exceeded` with no cause while reporting every remaining test in the file as
+// never run.
+//
+// `brokerStatus` is the documented "can accept commands" signal: it backs the
+// broker's `/actuator/health/status` group and reports DOWN until the broker is
+// healthy. See camunda-docs version-8.9
+// self-managed/components/orchestration-cluster/zeebe/operations/health.md --
+// "A broker is healthy when it can process processes, accept commands, and
+// perform all its expected tasks". Several consecutive healthy responses are
+// required so an instance that is still shutting down, or has only just begun
+// starting, cannot satisfy the gate on one lucky answer.
+async function waitForOrchestrationClusterReady(managementUrl = 'http://localhost:9600', timeoutMs = 240000) {
+    const healthEndpoint = `${managementUrl}/actuator/health`;
+    apiRequestContext = await getApiRequestContext();
+    const requiredConsecutive = 3;
+    let consecutiveHealthy = 0;
+    await (0, test_1.expect)(async () => {
+        let response;
+        try {
+            response = await apiRequestContext.get(healthEndpoint, {
+                timeout: 10000,
+            });
+        }
+        catch (error) {
+            consecutiveHealthy = 0;
+            throw error;
+        }
+        if (response.status() !== 200) {
+            consecutiveHealthy = 0;
+            throw new Error(`orchestration cluster health returned ${response.status()}`);
+        }
+        const brokerStatus = await brokerStatusFrom(response);
+        if (brokerStatus !== undefined && brokerStatus !== 'UP') {
+            consecutiveHealthy = 0;
+            throw new Error(`broker cannot accept commands yet (brokerStatus: ${brokerStatus})`);
+        }
+        consecutiveHealthy += 1;
+        (0, test_1.expect)(consecutiveHealthy).toBeGreaterThanOrEqual(requiredConsecutive);
+    }).toPass({ intervals: [5000, 10000, 15000], timeout: timeoutMs });
+}
+exports.waitForOrchestrationClusterReady = waitForOrchestrationClusterReady;
+// Reads the `brokerStatus` indicator out of an `/actuator/health` response.
+// Returns undefined when the response carries no such component, so a
+// distribution that does not expose it falls back to the plain 200 check.
+async function brokerStatusFrom(response) {
+    try {
+        const body = (await response.json());
+        return body.components?.brokerStatus?.status;
+    }
+    catch {
+        return undefined;
+    }
+}
 // ---- Zeebe: API helpers ----
 async function deployProcess(filePath, authToken, environment, clusterType) {
     try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camunda/e2e-test-suite",
-  "version": "0.0.979",
+  "version": "0.0.980",
   "description": "End-to-end test helpers for Camunda 8",
   "repository": {
     "type": "git",