@camunda/e2e-test-suite 0.0.1276 → 0.0.1278

package/dist/pages/8.8/WorkspaceMembersPage.js

@@ -0,0 +1,258 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WorkspaceMembersPage = void 0;
+const test_1 = require("@playwright/test");
+// Camunda Hub's workspace "Manage members" view: Members / Environments /
+// General tabs over a member table of Name | Email | Workspace role | Joined,
+// an "Add members" panel, and a role cell that becomes a select once clicked.
+//
+// This page matters to the role flows because an organization role alone no
+// longer decides what a non-admin can reach. Since camunda-hub's environments
+// work, an environment -- and so the cluster app behind it -- is visible only
+// to a user who is Editor or Workspace Admin on a workspace it is assigned to
+// (pdp-3715); organization admins and owners see every environment.
+class WorkspaceMembersPage {
+    page;
+    membersTab;
+    manageMembersHeading;
+    addMembersButton;
+    addMemberSearchbox;
+    addMemberSubmitButton;
+    constructor(page) {
+        this.page = page;
+        this.membersTab = page.getByRole('tab', { name: 'Members' });
+        this.manageMembersHeading = page.getByRole('heading', {
+            name: 'Manage members',
+        });
+        this.addMembersButton = page
+            .locator('[data-test="add-members-button"]')
+            .or(page.getByRole('button', { name: 'Add members' }))
+            .first();
+        // A cmdk combobox: <input cmdk-input role="combobox"
+        // aria-label="Search members" placeholder="Search members or enter an
+        // email to invite">. Prefer the accessible name over the placeholder,
+        // which is the longer and more churn-prone of the two.
+        this.addMemberSearchbox = page
+            .getByRole('combobox', { name: 'Search members' })
+            .or(page.getByPlaceholder('Search members or enter an email to invite'))
+            .first();
+        // `exact` matters: the panel's own trigger is "Add members", which a
+        // substring match on "Add" would also resolve.
+        this.addMemberSubmitButton = page.getByRole('button', {
+            name: 'Add',
+            exact: true,
+        });
+    }
+    // Hub's Workspaces overview defaults to "My workspaces" -- only the ones the
+    // current user is an explicit member of -- and resets to it on every load,
+    // so a workspace created by another user is invisible until the scope is
+    // widened. The empty state offers an explicit button; the populated view
+    // offers the filter instead. A no-op where neither is rendered.
+    async showAllWorkspaces() {
+        const switchButton = this.page.getByRole('button', {
+            name: 'Switch to All workspaces',
+        });
+        const scopeFilter = this.page.getByRole('combobox', {
+            name: 'Filter workspaces',
+        });
+        const appeared = await switchButton
+            .or(scopeFilter)
+            .first()
+            .waitFor({ state: 'visible', timeout: 15000 })
+            .then(() => true)
+            .catch(() => false);
+        if (!appeared) {
+            return;
+        }
+        if (await switchButton.isVisible().catch(() => false)) {
+            await switchButton.click({ timeout: 10000 });
+            await (0, test_1.expect)(switchButton).toBeHidden({ timeout: 10000 });
+            return;
+        }
+        if ((await scopeFilter.innerText()).includes('All workspaces')) {
+            return;
+        }
+        await scopeFilter.click({ timeout: 10000 });
+        await this.page
+            .getByRole('option', { name: 'All workspaces' })
+            .click({ timeout: 10000 });
+        await (0, test_1.expect)(scopeFilter).toContainText('All workspaces', {
+            timeout: 10000,
+        });
+    }
+    async openManageMembers(workspaceName) {
+        // `.first()`: an org can hold several workspaces sharing a name -- the
+        // nightly's environments card lists "Cross Component Test Project" twice
+        // -- and an unqualified match is then a strict-mode violation.
+        const manageButton = this.page
+            .getByRole('button', { name: `Manage workspace ${workspaceName}` })
+            .first();
+        // Keep Hub's default "My workspaces" scope, which is what a real user
+        // sees, and widen only when the target is not in it -- e.g. it was
+        // created by another user and this one holds no explicit membership.
+        const visibleUnderDefaultScope = await manageButton
+            .waitFor({ state: 'visible', timeout: 15000 })
+            .then(() => true)
+            .catch(() => false);
+        if (!visibleUnderDefaultScope) {
+            await this.showAllWorkspaces();
+        }
+        await (0, test_1.expect)(manageButton).toBeVisible({ timeout: 60000 });
+        await manageButton.click({ timeout: 30000 });
+        await (0, test_1.expect)(this.manageMembersHeading).toBeVisible({ timeout: 60000 });
+        if ((await this.membersTab
+            .getAttribute('aria-selected')
+            .catch(() => null)) !== 'true') {
+            await this.membersTab.click({ timeout: 30000 });
+        }
+    }
+    memberRow(email) {
+        return this.page.getByRole('row').filter({ hasText: email }).first();
+    }
+    async isMember(email) {
+        return this.memberRow(email)
+            .waitFor({ state: 'visible', timeout: 15000 })
+            .then(() => true)
+            .catch(() => false);
+    }
+    // Adds a user who is not on the member list yet. The panel is collapsed
+    // until its trigger is clicked, and its own "Workspace role" select already
+    // defaults to Editor, so it is only driven when a different role is wanted.
+    async addMember(email, role) {
+        await this.addMembersButton.click({ timeout: 30000 });
+        await (0, test_1.expect)(this.addMemberSearchbox).toBeVisible({ timeout: 30000 });
+        await this.addMemberSearchbox.click({ timeout: 30000 });
+        await this.addMemberSearchbox.fill(email);
+        // An org member shows up as a pickable result; picking it is what enables
+        // the submit. Typing alone leaves an invite-by-email candidate that some
+        // builds require to be committed the same way.
+        // cmdk renders its results as [cmdk-item] nodes with role="option",
+        // filtered live against what was typed.
+        const result = this.page
+            .getByRole('option', { name: new RegExp(escapeRegExp(email), 'i') })
+            .or(this.page.locator('[cmdk-item]').filter({ hasText: email }))
+            .first();
+        // The result list is a multi-select, and its checkbox is NOT a checkbox:
+        // a trace of the live DOM shows each row as
+        //   <div cmdk-item role="option" data-staged="false" aria-selected="true">
+        //     <svg aria-hidden="true"><rect .../></svg> <div>name / email</div>
+        // so getByRole('checkbox') matches nothing, and clicking the row only
+        // sets cmdk's highlight -- aria-selected and data-selected both read
+        // "true" while data-staged stays "false" and "Add" stays disabled.
+        // Click the leading svg, which is the box itself, and gate on the one
+        // attribute that actually tracks the pick.
+        await (0, test_1.expect)(result).toBeVisible({ timeout: 30000 });
+        // Neither the row nor its box can be clicked into a staged state: the box
+        // is a decorative svg the design system gives `pointer-events: none`, so
+        // that click lands on the row, and a row click only moves cmdk's
+        // highlight -- across three live runs `data-staged` never left "false"
+        // while `aria-selected` read "true" and "Add" stayed disabled. The
+        // list's "Select all" control is what actually stages. It is a
+        // <button data-test="members-picker-select-all">, not a cmdk item, and
+        // its label is split across text nodes ("Select all (", "1", ")"), so it
+        // is addressed by its test id. The search box above has already been
+        // filled with this one address, so the guard below holds it to exactly
+        // the intended user rather than trusting the label's count.
+        const candidates = this.page
+            .locator('[cmdk-item]')
+            .filter({ hasText: email });
+        await (0, test_1.expect)(candidates).toHaveCount(1, { timeout: 15000 });
+        await this.page
+            .locator('[data-test="members-picker-select-all"]')
+            .click({ timeout: 15000 });
+        await (0, test_1.expect)(result).toHaveAttribute('data-staged', 'true', {
+            timeout: 15000,
+        });
+        if (role !== 'Editor') {
+            await this.selectRoleIn(this.page.getByRole('combobox', { name: 'Workspace role' }).first(), role);
+        }
+        await (0, test_1.expect)(this.addMemberSubmitButton).toBeEnabled({ timeout: 30000 });
+        await this.addMemberSubmitButton.click({ timeout: 30000 });
+        await (0, test_1.expect)(this.memberRow(email)).toBeVisible({ timeout: 60000 });
+    }
+    async selectRoleIn(control, role) {
+        await control.click({ timeout: 30000 });
+        await this.page
+            .getByRole('option', { name: role, exact: true })
+            .or(this.page.getByRole('menuitem', { name: role, exact: true }))
+            .first()
+            .click({ timeout: 30000 });
+    }
+    // Ensures the user holds `role` on this workspace, adding them first when
+    // they are not a member at all -- which is the usual case for a role flow,
+    // since the shared workspace is created by whichever setup user won the
+    // race and nobody else is added to it.
+    async setMemberRole(email, role) {
+        if (!(await this.isMember(email))) {
+            await this.addMember(email, role);
+            return;
+        }
+        const row = this.memberRow(email);
+        if ((await row.getByText(role, { exact: true }).count()) > 0) {
+            return;
+        }
+        // The role cell renders as a static pill until clicked, then becomes a
+        // select with its own confirm control; leaving it unconfirmed silently
+        // reverts the row to its previous role.
+        const roleControl = row
+            .getByRole('combobox')
+            .or(row.getByRole('button', {
+            name: /^(Workspace Admin|Editor|Commenter|Viewer)$/,
+        }))
+            .first();
+        await roleControl.click({ timeout: 30000 });
+        await this.selectRoleIn(roleControl, role);
+        // Clicked unconditionally, not behind an `isVisible()` probe: the
+        // confirmation is what persists the change, and the control can render a
+        // beat after the select. A probe would read `false` in that window, skip
+        // the click, and let the assertion below match the still-uncommitted
+        // value in the open editor just before the row reverts. Clicking outright
+        // makes Playwright wait for the control and fail here when it never
+        // arrives, rather than passing on an edit that was never saved.
+        await row
+            .getByRole('button', { name: /^(Confirm|Save|Apply|Update)$/i })
+            .or(row.locator('button[type="submit"]'))
+            .first()
+            .click({ timeout: 30000 });
+        await (0, test_1.expect)(row.getByText(role, { exact: true })).toBeVisible({
+            timeout: 60000,
+        });
+    }
+    // Undoes `setMemberRole`/`addMember`. Workspace membership is durable org
+    // state: left behind, it survives the test that granted it, so a Playwright
+    // retry starts with the user already an Editor and any assertion about the
+    // un-granted state fails on the second attempt. A no-op when the user is
+    // not on the list, so it is safe to call from teardown after a failure at
+    // any point in the flow.
+    async removeMember(email) {
+        if (!(await this.isMember(email))) {
+            return;
+        }
+        const row = this.memberRow(email);
+        // The destructive action lives behind the row's own overflow menu; its
+        // trigger is an icon button, so it is matched on its accessible name
+        // rather than on text.
+        await row
+            .getByRole('button', { name: /(more|actions|options|menu)/i })
+            .or(row.locator('[data-test="member-row-actions"]'))
+            .first()
+            .click({ timeout: 30000 });
+        await this.page
+            .getByRole('menuitem', { name: /^Remove( member)?$/i })
+            .or(this.page.getByRole('option', { name: /^Remove( member)?$/i }))
+            .first()
+            .click({ timeout: 30000 });
+        // Removal is confirmed in a dialog. Scoped to it so the match cannot
+        // resolve back to the menu item that opened it.
+        const dialog = this.page.getByRole('dialog').first();
+        await dialog
+            .getByRole('button', { name: /^(Remove|Confirm|Delete)$/i })
+            .first()
+            .click({ timeout: 30000 });
+        await (0, test_1.expect)(row).toBeHidden({ timeout: 60000 });
+    }
+}
+exports.WorkspaceMembersPage = WorkspaceMembersPage;
+function escapeRegExp(value) {
+    return value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}

package/dist/tests/8.8/access-user-role-management.spec.js

@@ -6,9 +6,15 @@ const UtilitiesPage_1 = require("../../pages/8.8/UtilitiesPage");
 const sleep_1 = require("../../utils/sleep");
 const resetSession_1 = require("../../utils/resetSession");
 const LoginPage_1 = require("../../pages/8.8/LoginPage");
+const WorkspaceMembersPage_1 = require("../../pages/8.8/WorkspaceMembersPage");
 const test_1 = require("@playwright/test");
 const users_1 = require("../../utils/users");
 const testUser = (0, users_1.getTestUser)('mainUser');
+// The workspace the Analyst flow borrows Editor rights on, and whether that
+// grant is currently outstanding. Read by the teardown below so it only
+// reaches for Hub's Manage members view when there is something to undo.
+const analystWorkspaceName = 'Cross Component Test Project';
+let analystWorkspaceGrantMade = false;
 _8_8_1.test.describe.configure({ mode: 'parallel' });
 _8_8_1.test.describe('User Roles User Flow', () => {
     const clusterNames = {
@@ -35,6 +41,29 @@ _8_8_1.test.describe('User Roles User Flow', () => {
         await (0, _setup_1.captureScreenshot)(page, testInfo);
         await (0, _setup_1.captureFailureVideo)(page, testInfo);
     });
+    // Workspace membership is durable organization state, so the Editor rights
+    // the Analyst flow grants must be handed back whether the test passed or
+    // failed. Left behind, a retry would start with the analyst already an
+    // Editor and its own "not reachable without workspace access" assertion
+    // would fail on the second attempt; the grant would also leak into every
+    // later nightly run against the same org.
+    _8_8_1.test.afterEach(async ({ page, browser }, testInfo) => {
+        if (!testInfo.title.startsWith('Analyst Role User Flow')) {
+            return;
+        }
+        if (!analystWorkspaceGrantMade) {
+            return;
+        }
+        await (0, resetSession_1.resetSession)(browser, page);
+        await new LoginPage_1.LoginPage(page).loginWithTestUser({
+            username: process.env.C8_USERNAME,
+            password: process.env.C8_PASSWORD,
+        });
+        const workspaceMembersPage = new WorkspaceMembersPage_1.WorkspaceMembersPage(page);
+        await workspaceMembersPage.openManageMembers(analystWorkspaceName);
+        await workspaceMembersPage.removeMember(process.env.C8_USERNAME_TEST_9);
+        analystWorkspaceGrantMade = false;
+    });
     // Skipped due to bug #58514: https://github.com/camunda/camunda/issues/58514
     _8_8_1.test.skip('Modeler Role User Flow', async ({ page, modelerHomePage, appsPage, homePage, clusterPage, clusterDetailsPage, context, consoleOrganizationsPage, settingsPage, operateHomePage, ocIdentityHomePage, taskPanelPage, optimizeHomePage, modelerCreatePage, }) => {
         const randomString = await (0, _setup_1.generateRandomStringAsync)(3);
@@ -158,6 +187,72 @@ _8_8_1.test.describe('User Roles User Flow', () => {
                 password: process.env.C8_PASSWORD_TEST_9,
             });
         });
+        // An organization role no longer decides on its own what a non-admin can
+        // reach. Since camunda-hub's environments work (pdp-3443, pdp-3715), a
+        // cluster's apps are surfaced through an ENVIRONMENT, and an environment
+        // is visible only to users who are Editor or Workspace Admin on a
+        // workspace it is assigned to -- organization admins and owners excepted,
+        // who see every environment unconditionally. An Analyst with no workspace
+        // membership therefore reaches nothing, which is the decided design
+        // rather than a defect: "Clusters are shown only to org admins.
+        // Non-admins do not have cluster visibility (they operate with
+        // environments instead)."
+        //
+        // Assert that gate before granting the membership the rest of this test
+        // depends on, so both halves are covered: the role alone grants no
+        // access, and the role plus workspace editorship does.
+        await _8_8_1.test.step('Ensure Optimize is not reachable without workspace access', async () => {
+            // Assert the cause, not just the consequence. Hub shows the analyst an
+            // empty Workspaces overview -- "You don't have explicit membership in
+            // any workspace in this organization" before the scope is widened, and
+            // "Your organization has no workspaces yet" after -- because the
+            // workspace belongs to whoever created it. With no workspace there is
+            // no environment, and with no environment no cluster app, so checking
+            // the Optimize banner alone would pass for unrelated reasons too.
+            await appsPage.clickCamundaApps();
+            await (0, test_1.expect)(page
+                .getByText('Your organization has no workspaces yet')
+                .or(page.getByText("You don't have explicit membership in any workspace"))
+                .first()).toBeVisible({ timeout: 60000 });
+            // Assert the absence of THIS cluster's Optimize target directly rather
+            // than calling clickOptimize() and swallowing whatever it throws: a
+            // swallowed error would let this step pass because the hand-off helper
+            // itself broke and the page simply stayed on Hub, where the Optimize
+            // banner is absent for reasons that have nothing to do with the gate.
+            // On Hub a cluster's apps hang off the sidebar group named for the
+            // cluster, so with no environment neither the group nor the Optimize
+            // link inside it is ever rendered.
+            const hubSidebar = page.getByRole('navigation', {
+                name: 'Main navigation',
+            });
+            await (0, test_1.expect)(hubSidebar.getByRole('button', { name: clusterName })).toHaveCount(0, { timeout: 30000 });
+            await (0, test_1.expect)(hubSidebar.getByRole('link', { name: /Optimize/ })).toHaveCount(0, { timeout: 30000 });
+            await (0, test_1.expect)(optimizeHomePage.optimizeBanner).not.toBeVisible({
+                timeout: 30000,
+            });
+        });
+        await _8_8_1.test.step('Grant the analyst Editor rights on the shared workspace', async () => {
+            // Only an organization admin may change workspace membership, so this
+            // switches to the main user and back rather than doing it as the
+            // analyst under test.
+            await (0, resetSession_1.resetSession)(browser, page);
+            await new LoginPage_1.LoginPage(page).loginWithTestUser({
+                username: process.env.C8_USERNAME,
+                password: process.env.C8_PASSWORD,
+            });
+            const workspaceMembersPage = new WorkspaceMembersPage_1.WorkspaceMembersPage(page);
+            await workspaceMembersPage.openManageMembers(analystWorkspaceName);
+            // Flagged before the grant, not after: a failure partway through
+            // setMemberRole can still have added the member, and teardown must
+            // clean that up too.
+            analystWorkspaceGrantMade = true;
+            await workspaceMembersPage.setMemberRole(process.env.C8_USERNAME_TEST_9, 'Editor');
+            await (0, resetSession_1.resetSession)(browser, page);
+            await new LoginPage_1.LoginPage(page).loginWithTestUser({
+                username: process.env.C8_USERNAME_TEST_9,
+                password: process.env.C8_PASSWORD_TEST_9,
+            });
+        });
         await _8_8_1.test.step('Wait for the role change to reach Optimize', async () => {
             // Replaces a blind `sleep(600000)`. The role change only takes effect in
             // Optimize once its permission cache refreshes, and reaching Optimize is

package/dist/tests/8.8/console-user-flows.spec.js

@@ -105,6 +105,10 @@ _8_8_1.test.describe('Console User Flow Tests @tasklistV2', () => {
         });
         await _8_8_1.test.step('Create First Email Alert', async () => {
             await clusterDetailsPage.createAlert(true);
+            // Hub's alerts table keeps the recipient, date and trigger count in a
+            // collapsed expansion row, so the detail assertions below only have a
+            // second row to read once it is expanded.
+            await clusterDetailsPage.expandAlerts();
             await test_1.expect
                 .poll(async () => clusterDetailsPage.alertsList.count(), {
                 timeout: 30000,
@@ -165,6 +169,7 @@ _8_8_1.test.describe('Console User Flow Tests @tasklistV2', () => {
                 await (0, test_1.expect)(clusterDetailsPage.alertsList.first()).toBeVisible({
                     timeout: 20000,
                 });
+                await clusterDetailsPage.expandAlerts();
                 (0, test_1.expect)(await clusterDetailsPage.alertsList.count()).toBeGreaterThan(1);
                 await (0, test_1.expect)(clusterDetailsPage.alertsList.nth(0)).toContainText(`Email`);
                 await clusterDetailsPage.assertAlertText('Amount triggered1');
@@ -205,6 +210,7 @@ _8_8_1.test.describe('Console User Flow Tests @tasklistV2', () => {
                 await (0, test_1.expect)(clusterDetailsPage.alertsList.first()).toBeVisible({
                     timeout: 20000,
                 });
+                await clusterDetailsPage.expandAlerts();
                 (0, test_1.expect)(await clusterDetailsPage.alertsList.count()).toBeGreaterThan(1);
                 await clusterDetailsPage.assertAlertText('Amount triggered3');
             }).toPass({ timeout: 240000 });

package/dist/tests/8.8/web-modeler-user-flows.spec.js

@@ -31,7 +31,9 @@ _8_8_1.test.describe('Web Modeler User Flow Tests', () => {
             await (0, mailSlurpClient_1.deleteInbox)(inboxes[testInfo.title]);
         }
     });
-    (0, _8_8_1.test)('Form.js Integration with User Task and AI Generated Form @ai-external', async ({ page, homePage, modelerHomePage, appsPage, modelerCreatePage, formJsPage, }) => {
+    // Skipped due to bug #29346: https://github.com/camunda/camunda-hub/issues/29346
+    // Also tracked in https://github.com/camunda/product-hub/issues/3655
+    _8_8_1.test.skip('Form.js Integration with User Task and AI Generated Form @ai-external', async ({ page, homePage, modelerHomePage, appsPage, modelerCreatePage, formJsPage, }) => {
         _8_8_1.test.slow();
         const randomString = await (0, _setup_1.generateRandomStringAsync)(3);
         const processName = 'User_Task_Process_With_AI_Form' + randomString;
@@ -88,7 +90,9 @@ _8_8_1.test.describe('Web Modeler User Flow Tests', () => {
             await operateTabTaskDetailsPage.clickCompleteTaskButton();
         });
     });
-    (0, _8_8_1.test)('Form.js Integration with AI generated Start form @ai-external', async ({ page, homePage, modelerHomePage, appsPage, modelerCreatePage, formJsPage, }) => {
+    // Skipped due to bug #29346: https://github.com/camunda/camunda-hub/issues/29346
+    // Also tracked in https://github.com/camunda/product-hub/issues/3655
+    _8_8_1.test.skip('Form.js Integration with AI generated Start form @ai-external', async ({ page, homePage, modelerHomePage, appsPage, modelerCreatePage, formJsPage, }) => {
         _8_8_1.test.slow();
         const randomString = await (0, _setup_1.generateRandomStringAsync)(3);
         const processName = 'AI-generated-Start-form' + randomString;

package/dist/utils/consoleApiHelpers.js

@@ -810,24 +810,51 @@ async function listWorkspaceEnvironments(page, workspaceId) {
 // only the new id would silently unassign every other cluster the suite had
 // already linked (the AWS cluster, a sibling Tasklist-mode project's default).
 async function linkClusterToWorkspaceViaApi(page, workspaceId, clusterName) {
-    const environments = await listOrganizationEnvironments(page);
+    // Hub discovers a cluster into an environment asynchronously, so a cluster
+    // this suite just created via the API is healthy well before its
+    // environment exists. A single probe therefore failed specs that create
+    // their own cluster: the nightly reported `No environment backs cluster
+    // "Second RBA V2 Cluster"` while three OTHER clusters were listed ACTIVE,
+    // and `"Fourth RBA V2 Cluster"; available: <none>` at a moment when the
+    // list came back empty entirely. Poll until this cluster's environment
+    // shows up. The throw below still stands once the deadline passes, so a
+    // genuinely absent cluster fails exactly as before -- only the race is
+    // absorbed.
+    const deadline = Date.now() + 120000;
+    let environments = await listOrganizationEnvironments(page);
     if (environments === null) {
         console.log('Environments feature is off for this org; leaving the workspace unlinked');
         return;
     }
-    const matches = environments.filter((environment) => environment.clusterName === clusterName);
-    // Prefer an ACTIVE environment over a stale NOT_REPORTED duplicate left by
-    // an earlier cluster of the same name.
-    const match = matches.find((environment) => environment.discoveryState === 'ACTIVE') ??
-        matches[0];
+    const pickMatch = (candidates) => {
+        const matched = candidates.filter((environment) => environment.clusterName === clusterName);
+        // Prefer an ACTIVE environment over a stale NOT_REPORTED duplicate left by
+        // an earlier cluster of the same name.
+        return (matched.find((environment) => environment.discoveryState === 'ACTIVE') ??
+            matched[0]);
+    };
+    let match = pickMatch(environments);
+    while (!match && Date.now() < deadline) {
+        await page.waitForTimeout(5000);
+        const refreshed = await listOrganizationEnvironments(page);
+        if (refreshed === null) {
+            return;
+        }
+        environments = refreshed;
+        match = pickMatch(environments);
+    }
     if (!match) {
         throw new Error(`No environment backs cluster "${clusterName}"; available: ` +
             (environments
                 .map((e) => `${e.name}@${e.clusterName} (${e.discoveryState})`)
                 .join(', ') || '<none>'));
     }
+    // Bind to a const so the narrowing survives the closures below: `match` is
+    // a `let` reassigned by the discovery poll, so TypeScript widens it back to
+    // `HubEnvironment | undefined` inside callbacks.
+    const backing = match;
     const assigned = await listWorkspaceEnvironments(page, workspaceId);
-    if (assigned.some((environment) => environment.id === match.id)) {
+    if (assigned.some((environment) => environment.id === backing.id)) {
         // Logged rather than returning silently: a quiet no-op here is
         // indistinguishable from the helper never having run at all, which is
         // exactly the ambiguity that hid an earlier bug.
@@ -845,10 +872,10 @@ async function linkClusterToWorkspaceViaApi(page, workspaceId, clusterName) {
         const current = attempt === 1
             ? assigned
             : await listWorkspaceEnvironments(page, workspaceId);
-        if (attempt > 1 && current.some((e) => e.id === match.id)) {
+        if (attempt > 1 && current.some((e) => e.id === backing.id)) {
             return;
         }
-        const ids = [...new Set([...current.map((e) => e.id), match.id])];
+        const ids = [...new Set([...current.map((e) => e.id), backing.id])];
         const response = await clusterApiRequest(page, 'PUT', url, {
             environmentIds: ids,
         });
@@ -860,8 +887,8 @@ async function linkClusterToWorkspaceViaApi(page, workspaceId, clusterName) {
                 `${response.status()} ${response.statusText()}`);
         }
         const after = await listWorkspaceEnvironments(page, workspaceId);
-        if (after.some((e) => e.id === match.id)) {
-            console.log(`Linked cluster "${clusterName}" (environment ${match.id}) to workspace ${workspaceId}`);
+        if (after.some((e) => e.id === backing.id)) {
+            console.log(`Linked cluster "${clusterName}" (environment ${backing.id}) to workspace ${workspaceId}`);
             return;
         }
     }

package/package.json

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