@camunda/e2e-test-suite 0.0.1248 → 0.0.1250

package/dist/pages/8.7/ModelerHomePage.d.ts

@@ -2,12 +2,18 @@ import { Page, Locator } from '@playwright/test';
 import { LoginPage } from './LoginPage';
 declare class ModelerHomePage {
     private defaultFolderName;
+    private defaultClusterName;
     private page;
     private processApplicationPage;
     private processApplicationUrl?;
     private processApplicationName?;
     readonly modelerPageBanner: Locator;
     readonly createNewProjectButton: Locator;
+    readonly createWorkspaceButton: Locator;
+    readonly workspaceWizardNameInput: Locator;
+    readonly workspaceWizardSubmitButton: Locator;
+    readonly workspaceWizardMembersStep: Locator;
+    readonly workspaceWizardEnvironmentsHeading: Locator;
     readonly projectNameInput: Locator;
     readonly formNameInput: Locator;
     readonly chooseBpmnTemplateButton: Locator;
@@ -31,7 +37,11 @@ declare class ModelerHomePage {
     readonly closeButton: Locator;
     readonly formNameBreadcrumb: (formName: string) => Locator;
     readonly formBreadcrumbButton: Locator;
+    readonly formActionsButton: Locator;
     readonly renameFormMenuItem: Locator;
+    readonly renameDialog: Locator;
+    readonly renameDialogInput: Locator;
+    readonly renameDialogSubmitButton: Locator;
     constructor(page: Page);
     dismissOverlays(): Promise<void>;
     clickCreateNewProjectButton(): Promise<void>;
@@ -63,6 +73,7 @@ declare class ModelerHomePage {
     clickHomeBreadcrumb(): Promise<void>;
     clickOpenOrganizationsButton(): Promise<void>;
     clickCrossComponentProjectFolder(): Promise<void>;
+    private createWorkspaceViaWizard;
     createCrossComponentProjectFolder(): Promise<void>;
     /**
      * Asserts the Cross Component project folder is listed on the Modeler home

package/dist/pages/8.7/ModelerHomePage.js

@@ -9,6 +9,11 @@ const ProcessApplicationPage_1 = require("./ProcessApplicationPage");
 const expectLocatorWithRetry_1 = require("../../utils/assertionHelpers/expectLocatorWithRetry");
 class ModelerHomePage {
     defaultFolderName = 'Cross Component Test Project';
+    // The default cluster test-setup.spec.ts's "Create Default Cluster" test
+    // provisions for the whole suite -- assigned to the shared workspace's
+    // Environments step so downstream specs can deploy to it without a manual
+    // assignment step first.
+    defaultClusterName = 'Test Cluster';
     page;
     // Since camunda/camunda-hub#25831 files and folders cannot sit at a
     // workspace ("project" in today's UI) root -- only process applications and
@@ -25,6 +30,11 @@ class ModelerHomePage {
     processApplicationName;
     modelerPageBanner;
     createNewProjectButton;
+    createWorkspaceButton;
+    workspaceWizardNameInput;
+    workspaceWizardSubmitButton;
+    workspaceWizardMembersStep;
+    workspaceWizardEnvironmentsHeading;
     projectNameInput;
     formNameInput;
     chooseBpmnTemplateButton;
@@ -48,13 +58,31 @@ class ModelerHomePage {
     closeButton;
     formNameBreadcrumb;
     formBreadcrumbButton;
+    formActionsButton;
     renameFormMenuItem;
+    renameDialog;
+    renameDialogInput;
+    renameDialogSubmitButton;
     constructor(page) {
         this.page = page;
         this.processApplicationPage = new ProcessApplicationPage_1.ProcessApplicationPage(page);
-        this.modelerPageBanner = page.getByRole('banner', {
+        // Hub's design-system shell renders the app header as a role=banner with no
+        // accessible name after the Camunda Hub rebrand, so the classic
+        // name-matched banner no longer resolves; the Modeler logo link inside it
+        // carries "Camunda Modeler home" or, once camunda-hub PR#29349's rename
+        // has rolled out to an org, "Camunda Hub home". Keep the legacy
+        // named-banner branch for shells where the rename has not shipped yet.
+        this.modelerPageBanner = page
+            .getByRole('banner', {
             name: 'Camunda Modeler',
-        });
+        })
+            .or(page
+            .getByRole('link', { name: 'Camunda Modeler home' })
+            .and(page.locator(':not([href$="/login"])')))
+            .or(page
+            .getByRole('link', { name: 'Camunda Hub home' })
+            .and(page.locator(':not([href$="/login"])')))
+            .first();
         // Hub renamed this button to "Create project" on both the classic and the
         // design-system shell. The legacy label is kept so the flow still works
         // against Modeler builds where the rename has not shipped yet. exact:true
@@ -67,6 +95,24 @@ class ModelerHomePage {
             name: 'Create project',
             exact: true,
         }));
+        // Camunda Hub, which replaced Console + Web Modeler on SaaS, tops the
+        // hierarchy with a Workspaces overview whose "Create workspace" CTA opens a
+        // wizard (General -> Members) that names the workspace up front. Same
+        // hooks as pages/8.10/ModelerHomePage.ts. exact:true keeps the split
+        // button's options chevron out of the match.
+        this.createWorkspaceButton = page.getByRole('button', {
+            name: 'Create workspace',
+            exact: true,
+        });
+        this.workspaceWizardNameInput = page.locator('#workspace-name');
+        this.workspaceWizardSubmitButton = page.locator('[data-test="workspace-wizard-submit"]');
+        this.workspaceWizardMembersStep = page.locator('[data-test="step-members"]');
+        // When the org has environments enabled, an "Assign environments" step is
+        // inserted after Members -- camunda-hub's own
+        // e2e-playwright/pages/CreateWorkspacePage.ts detects it the same way.
+        this.workspaceWizardEnvironmentsHeading = page.getByRole('heading', {
+            name: 'Assign environments',
+        });
         this.projectNameInput = page.locator('[data-test="editable-input"]');
         this.formNameInput = page.locator('[data-test="editable-input"]');
         this.idpApplicationNameInput = page.getByPlaceholder('New IDP Application');
@@ -98,10 +144,13 @@ class ModelerHomePage {
         this.homeBreadcrumb = page.locator('[data-test="breadcrumb-home"]');
         this.openOrganizationsButton = page.getByLabel('Open Organizations');
         this.manageButton = page.getByRole('menuitem', { name: 'Manage' });
+        // On the Camunda Hub Workspaces overview the folder is a workspace tile
+        // whose "Open workspace <name>" button navigates into it.
         this.crossComponentProjectFolder = page
-            .getByTitle(this.defaultFolderName, {
+            .getByRole('button', { name: `Open workspace ${this.defaultFolderName}` })
+            .or(page.getByTitle(this.defaultFolderName, {
             exact: true,
-        })
+        }))
             .first();
         this.rows = page.getByRole('row');
         this.uploadFilesButton = page.getByRole('menuitem', { name: 'Upload files' });
@@ -116,7 +165,26 @@ class ModelerHomePage {
             hasText: formName,
         });
         this.formBreadcrumbButton = page.locator('button[data-test="breadcrumb-form"]');
-        this.renameFormMenuItem = page.locator('[data-test="rename-form"]');
+        // Hub's newer nav (isNavV2) makes formBreadcrumbButton a no-op and moves
+        // Rename/Duplicate/Delete behind a separate "<name> actions" kebab
+        // instead (use-file-page-actions.ts); its own menu item carries no
+        // data-test, just the text "Rename".
+        this.formActionsButton = page
+            .getByRole('button', { name: / actions$/ })
+            .first();
+        this.renameFormMenuItem = page
+            .locator('[data-test="rename-form"]')
+            .or(page.getByRole('menuitem', { name: 'Rename', exact: true }));
+        // The design-system nav's Rename opens a modal dialog (RenameDialogDs.tsx)
+        // instead of the legacy inline breadcrumb editor.
+        this.renameDialog = page.getByRole('dialog', { name: 'Rename', exact: true });
+        this.renameDialogInput = this.renameDialog.getByLabel('Name', {
+            exact: true,
+        });
+        this.renameDialogSubmitButton = this.renameDialog.getByRole('button', {
+            name: 'Rename',
+            exact: true,
+        });
     }
     // The release-announcement dialog ("Check out our new release") re-mounts
     // after the projects list re-renders, so one dismissal pass is not enough.
@@ -300,10 +368,28 @@ class ModelerHomePage {
                 if (!editorOpen) {
                     await this.openFormRenameEditor();
                 }
-                await this.formNameInput.click({ timeout: 30000 });
-                await this.formNameInput.fill(name);
-                await this.formNameInput.press('Enter');
-                await this.formNameBreadcrumb(name).waitFor({
+                // The design-system nav's Rename opens a modal dialog
+                // (RenameDialogDs.tsx) instead of the legacy inline breadcrumb
+                // editor -- fill and submit whichever is actually open.
+                const modalOpen = await this.renameDialog
+                    .isVisible()
+                    .catch(() => false);
+                if (modalOpen) {
+                    await this.renameDialogInput.fill(name, { timeout: 45000 });
+                    await this.renameDialogSubmitButton.click({ timeout: 10000 });
+                    await this.renameDialog.waitFor({ state: 'hidden', timeout: 30000 });
+                }
+                else {
+                    await this.formNameInput.click({ timeout: 30000 });
+                    await this.formNameInput.fill(name);
+                    await this.formNameInput.press('Enter');
+                }
+                // The legacy breadcrumb shows the new name directly; the
+                // design-system kebab instead embeds it in its own accessible name
+                // ("<name> actions"). Accept either as confirmation the rename took.
+                await this.formNameBreadcrumb(name)
+                    .or(this.page.getByRole('button', { name: `${name} actions` }))
+                    .waitFor({
                     state: 'visible',
                     timeout: 30000,
                 });
@@ -319,7 +405,18 @@ class ModelerHomePage {
         }
     }
     async openFormRenameEditor() {
-        await this.formBreadcrumbButton.click({ timeout: 60000 });
+        // Hub's newer nav (isNavV2) makes formBreadcrumbButton a no-op and moves
+        // the dropdown behind a separate "<name> actions" kebab instead -- prefer
+        // it when present, and only fall back to the legacy breadcrumb otherwise.
+        const kebabVisible = await this.formActionsButton
+            .isVisible({ timeout: 5000 })
+            .catch(() => false);
+        if (kebabVisible) {
+            await this.formActionsButton.click({ timeout: 60000 });
+        }
+        else {
+            await this.formBreadcrumbButton.click({ timeout: 60000 });
+        }
         await this.renameFormMenuItem.click({ timeout: 30000 });
     }
     // Kept under its original name because it is what the existing call sites
@@ -432,6 +529,28 @@ class ModelerHomePage {
         return this.becameVisible(this.modelerPageBanner, timeout);
     }
     async clickHomeBreadcrumb() {
+        // Camunda Hub has no Modeler home breadcrumb: its home is the Workspaces
+        // overview, reached through the header logo link so the SPA keeps its
+        // in-memory session (a full navigation re-runs the whole Auth0 hand-off).
+        if (new URL(this.page.url()).hostname.startsWith('hub.')) {
+            const header = this.page.locator('header[data-slot="app-header"]');
+            // The href stays literally "/login" until the client's auth state
+            // catches up just after login (camunda-hub NavShellDs.common.tsx) --
+            // clicking it in that window would log the test out instead of
+            // navigating home, so exclude that href and wait for the authenticated
+            // one rather than racing it (same hazard AppsPage.clickModeler()
+            // guards against).
+            const homeLink = header
+                .getByRole('link', { name: 'Camunda Modeler home' })
+                .and(this.page.locator(':not([href$="/login"])'))
+                .or(header
+                .getByRole('link', { name: 'Camunda Hub home' })
+                .and(this.page.locator(':not([href$="/login"])')))
+                .first();
+            await (0, test_1.expect)(homeLink).toBeVisible({ timeout: 30000 });
+            await homeLink.click({ timeout: 30000 });
+            return;
+        }
         try {
             await this.homeBreadcrumb.click();
         }
@@ -468,6 +587,57 @@ class ModelerHomePage {
             },
         });
     }
+    // Drives Camunda Hub's workspace-creation wizard. The name is entered on
+    // the General step, which enables "Next"; the same submit button then
+    // relabels itself through the remaining steps and finally reads "Create
+    // workspace" once it creates the workspace and routes the creator into its
+    // projects listing. Gate the Members-step click on that step becoming
+    // active so the shared submit button is not clicked twice while still on
+    // General.
+    async createWorkspaceViaWizard(name) {
+        await this.dismissOverlays();
+        await this.createWorkspaceButton.click({ timeout: 60000 });
+        await this.workspaceWizardNameInput.fill(name, { timeout: 60000 });
+        await this.workspaceWizardSubmitButton.click({ timeout: 60000 });
+        await (0, test_1.expect)(this.workspaceWizardMembersStep).toHaveAttribute('data-state', 'active', { timeout: 30000 });
+        await this.workspaceWizardSubmitButton.click({ timeout: 60000 });
+        // When the org has environments enabled, this only advances the wizard
+        // into an "Assign environments" step instead of submitting. Assign the
+        // suite's default cluster here rather than submitting with an empty
+        // selection -- otherwise this shared workspace starts with no
+        // environments and every downstream spec that deploys to it needs its
+        // own manual assignment first. Each card's accessible name is
+        // "Select <cluster name>" before it is picked (camunda-hub's own
+        // create-workspace-environments.spec.tsx asserts the same pattern).
+        // Sampled immediately (isVisible() doesn't wait) since the step change
+        // is a synchronous client-side re-render.
+        if (await this.workspaceWizardEnvironmentsHeading
+            .isVisible()
+            .catch(() => false)) {
+            // "Create Default Cluster" runs in parallel with this flow
+            // (test-setup.spec.ts's mode: 'parallel'), so the cluster this picker
+            // lists may still be provisioning -- wait for it a generous 90s rather
+            // than sampling once. If it genuinely never appears (the cluster
+            // failed rather than just being slow), don't fail the whole shared
+            // workspace's setup over it: Hub's own recovery copy for this step
+            // ("Could not load environments. You can finish creating the
+            // workspace and assign them later.") confirms submitting unassigned
+            // is a supported, recoverable path, not a broken one.
+            const clusterOption = this.page.getByRole('button', {
+                name: new RegExp(`^Select ${this.defaultClusterName}`),
+            });
+            if (await this.becameVisible(clusterOption, 90000)) {
+                await clusterOption.click({ timeout: 10000 });
+            }
+            else {
+                console.warn(`"${this.defaultClusterName}" was not selectable on the Environments step; creating the workspace without it.`);
+            }
+            await this.workspaceWizardSubmitButton.click({ timeout: 60000 });
+        }
+        await this.page.waitForURL(/\/workspaces?\/[^/]+\/projects/, {
+            timeout: 120000,
+        });
+    }
     async createCrossComponentProjectFolder() {
         await this.dismissOverlays();
         // The project list can take well over a minute to render after a session
@@ -483,6 +653,10 @@ class ModelerHomePage {
             await this.clickCrossComponentProjectFolder();
             return;
         }
+        if (await this.becameVisible(this.createWorkspaceButton, 5000)) {
+            await this.createWorkspaceViaWizard(this.defaultFolderName);
+            return;
+        }
         await this.clickCreateNewProjectButton();
         await this.enterNewProjectName(this.defaultFolderName);
     }

package/dist/pages/8.7/ProcessApplicationPage.js

@@ -48,21 +48,36 @@ class ProcessApplicationPage {
         // .first() defensively only: hub renders exactly one of these today, in the
         // workspace-root empty state. A future second placement should not turn
         // every PA-creating test into a strict-mode violation.
+        //
+        // camunda-hub#25831 renamed the concept from "process application" to
+        // "project" (workspace root's CreateSplitButton renders literal text
+        // "Create project", opening a dialog titled "Create project"). Accept
+        // both names so this resolves whichever the org's live rollout has
+        // reached.
         this.createProcessApplicationButton = page
             .getByRole('button', { name: 'Create process application' })
+            .or(page.getByRole('button', { name: 'Create project' }))
             .first();
         this.createProcessApplicationOption = page.locator('[data-test="create-process-application"]');
-        this.creationDialog = page.getByRole('dialog', {
-            name: 'Create a process application',
-        });
+        this.creationDialog = page
+            .getByRole('dialog', { name: 'Create a process application' })
+            .or(page.getByRole('dialog', { name: 'Create project' }));
         // Deliberately scoped to the dialog: ModelerCreatePage owns an unscoped
         // getByLabel('Name', {exact: true}) for the properties panel, which would
         // resolve to two elements while the creation modal is open.
-        this.nameInput = this.creationDialog.getByLabel('Name', { exact: true });
-        this.submitButton = this.creationDialog.getByRole('button', {
-            name: 'Create',
+        // CreateProjectModal.tsx labels its field "Project name", not "Name" --
+        // accept both so this resolves under either dialog variant.
+        this.nameInput = this.creationDialog
+            .getByLabel('Name', { exact: true })
+            .or(this.creationDialog.getByLabel('Project name', { exact: true }));
+        // CreateProjectModal.tsx's submit button reads "Create project", not the
+        // exact "Create" the legacy dialog used.
+        this.submitButton = this.creationDialog
+            .getByRole('button', { name: 'Create', exact: true })
+            .or(this.creationDialog.getByRole('button', {
+            name: 'Create project',
             exact: true,
-        });
+        }));
         this.cancelButton = this.creationDialog.getByRole('button', {
             name: 'Cancel',
             exact: true,
@@ -72,8 +87,13 @@ class ProcessApplicationPage {
         // The process application page renders more than one diagram-dropdown
         // (hub's own unit tests reach for it with getAllByTestId), so the dropdown
         // has to be resolved inside the folder explorer rather than page-wide.
+        // camunda-hub#25831's workspace-projects flow (WorkspaceProjectDetail.tsx)
+        // renders this control as CreateActionDs with test-id
+        // "create-action-dropdown" instead of the legacy "diagram-dropdown" --
+        // accept both.
         this.createNewDropdown = this.folderExplorer
             .locator('[data-test="diagram-dropdown"]')
+            .or(this.folderExplorer.locator('[data-test="create-action-dropdown"]'))
             .first();
         this.inlineNameInput = page.locator('[data-test="editable-input"]');
         this.defineStagesDialog = page

package/dist/pages/8.7/UtilitiesPage.js

@@ -7,11 +7,34 @@ const HomePage_1 = require("./HomePage");
 const sleep_1 = require("../../utils/sleep");
 const fileUpload_1 = require("../../utils/fileUpload");
 const mailSlurpClient_1 = require("../../utils/mailSlurpClient");
+const consoleApiHelpers_1 = require("../../utils/consoleApiHelpers");
 // Tracks which worker-derived `timeout` values have already paid the
 // pre-flight stagger below, so a worker only pays it once per process
 // lifetime rather than on every call -- see the comment at the call sites.
 const staggeredWorkerTimeouts = new Set();
+const onboardingTourSuppressed = new WeakSet();
+// Mirrors camunda-hub@452978f: pre-seed the onboarding tour's "seen" localStorage flag
+// (SEEN_KEY_PREFIX in .../tour-dialog/use-onboarding-seen.ts) so it never auto-opens. The
+// "Welcome to Camunda Hub" tour mounts app-wide -- Console included, not just Modeler -- and
+// hides the post-login banner link from the accessibility tree until dismissed, which times
+// out assertTestUsesCorrectOrganization's banner check. addInitScript runs before any page
+// script on every navigation/reload, so there's no login-response race to lose; the flag is
+// matched by prefix since the user id isn't known ahead of login.
+async function suppressOnboardingTour(page) {
+    if (onboardingTourSuppressed.has(page)) {
+        return;
+    }
+    onboardingTourSuppressed.add(page);
+    await page.addInitScript((prefixPattern) => {
+        const pattern = new RegExp(prefixPattern);
+        const originalGetItem = Storage.prototype.getItem;
+        Storage.prototype.getItem = function (key) {
+            return pattern.test(key) ? 'true' : originalGetItem.call(this, key);
+        };
+    }, '^hub\\.onboarding\\..*\\.seen\\.');
+}
 async function loginWithRetry(page, loginPage, testUser, timeout, maxRetries = 5, skipOrgAssertion = false) {
+    await suppressOnboardingTour(page);
     // Callers derive `timeout` as (workerIndex + 1) * 1000, so it's a stable
     // per-worker identifier: a Playwright worker is a long-lived process that
     // calls loginWithRetry once per test/repeat it runs, and this stagger only
@@ -32,6 +55,11 @@ async function loginWithRetry(page, loginPage, testUser, timeout, maxRetries = 5
     for (let attempt = 0; attempt < maxRetries; attempt++) {
         try {
             await page.context().clearCookies();
+            // The Hub bearer-token cache in consoleApiHelpers.ts is keyed by Page
+            // for the tab's whole lifetime; without clearing it here alongside
+            // cookies/storage, a flow that logs a different user into the same
+            // page could have getUserToken() return the PREVIOUS user's token.
+            (0, consoleApiHelpers_1.resetHubBearerToken)(page);
             await page.goto('about:blank');
             await page
                 .evaluate(() => {
@@ -429,8 +457,15 @@ async function assertTestUsesCorrectOrganization(page) {
     const homePage = new HomePage_1.HomePage(page);
     if (page.url().includes('?code=') || page.url().includes('&state=')) {
         console.log('OAuth callback detected, waiting for redirect...');
+        // Camunda Hub (which replaced Console on SaaS) only exchanges the code
+        // once its SPA has booted, and on CI runners that boot alone was measured
+        // at ~45s past /login-callback -- a 30s wait aborted the exchange on every
+        // attempt. The code is single-use, so falling back to page.goto('/') on
+        // timeout (as this used to) doesn't recover a slow-but-valid exchange, it
+        // just turns it into a guaranteed failure. Wait longer instead, matching
+        // the sibling 8.10 fix.
         await page.waitForURL((url) => !url.toString().includes('?code='), {
-            timeout: 30000,
+            timeout: 120000,
         });
         await (0, sleep_1.sleep)(5000);
     }
@@ -442,6 +477,24 @@ async function assertTestUsesCorrectOrganization(page) {
     else {
         await (0, test_1.expect)(homePage.consoleBanner).toBeVisible({ timeout: 30000 });
     }
+    // Camunda Hub replaced Console + Web Modeler on SaaS: it lands on
+    // /workspaces (no org id in the URL) and has no "Open Organizations"
+    // button. Its sidebar links are org-scoped, so assert on those instead and
+    // switch via the same /org/<id> route Hub's org breadcrumb dropdown uses.
+    const isShown = (locator, timeout) => locator
+        .waitFor({ state: 'visible', timeout })
+        .then(() => true)
+        .catch(() => false);
+    if (await isShown(homePage.hubSidebar, 10000)) {
+        const orgScopedLink = homePage.hubSidebar
+            .locator(`a[href*="/org/${process.env.ORG_ID}/"]`)
+            .first();
+        if (!(await isShown(orgScopedLink, 30000))) {
+            await page.goto(`/org/${process.env.ORG_ID}`);
+        }
+        await (0, test_1.expect)(orgScopedLink).toBeVisible({ timeout: 60000 });
+        return;
+    }
     await (0, test_1.expect)(homePage.openOrganizationButton).toBeVisible({ timeout: 180000 });
     try {
         await (0, test_1.expect)(page.url()).toContain(process.env.ORG_ID);

package/dist/pages/8.9/AppsPage.d.ts

@@ -18,8 +18,10 @@ declare class AppsPage {
     readonly consoleLink: Locator;
     readonly camundaComponentsButton: Locator;
     readonly camundaAppsButton: Locator;
+    readonly hubSidebar: Locator;
     constructor(page: Page);
     clickCluster(component: Locator, name: string): Promise<void>;
+    private clickHubClusterApp;
     clickModeler(): Promise<void>;
     clickTasklist(clusterName: string): Promise<void>;
     clickAdmin(clusterName: string): Promise<void>;

package/dist/pages/8.9/AppsPage.js

@@ -23,9 +23,15 @@ class AppsPage {
     consoleLink;
     camundaComponentsButton;
     camundaAppsButton;
+    hubSidebar;
     constructor(page) {
         this.page = page;
         this.modelerLink = page.getByRole('link', { name: 'Modeler', exact: true });
+        // Camunda Hub's persistent "Main navigation" sidebar lists each cluster
+        // with its own apps (Operate/Tasklist/Optimize/Identity) as child links
+        // -- there is no per-app switcher panel to open on Hub (see
+        // clickCamundaApps below). Mirrors pages/8.7/AppsPage.ts.
+        this.hubSidebar = page.getByRole('navigation', { name: 'Main navigation' });
         this.appSwitcherButton = page.getByLabel('App Switcher');
         this.tasklistLink = page.getByRole('link', { name: 'Tasklist', exact: true });
         this.adminLink = page.getByRole('link', { name: /^(Admin|Identity)$/ });
@@ -75,7 +81,78 @@ class AppsPage {
         await (0, test_1.expect)(cluster).toBeVisible({ timeout: 30000 });
         await cluster.click();
     }
+    // Camunda Hub's sidebar groups by cluster, not by app: each cluster row
+    // expands to reveal its own per-app child links (Operate/Tasklist/...).
+    // camunda-hub's own nav-shell-ds.spec.saas.tsx documents the shape: "the
+    // design system splits the group row into a label control and a chevron
+    // control, both labelled by the cluster name; either one opens it" -- and
+    // the child links do not exist in the DOM at all until expanded (not just
+    // hidden), and are not nested under any container matchable by cluster
+    // name once expanded. So: find the toggle by the cluster's own name
+    // (`.first()` because both controls share that name), click it, then
+    // look up the app link sidebar-wide rather than scoped to a "group"
+    // container that doesn't reliably exist.
+    async clickHubClusterApp(clusterName, appName) {
+        // Not exact: camunda-hub's own nav-shell-ds.spec.saas.tsx asserts this same
+        // link with a substring/regex match (`{name: /Operate/}`), not an exact
+        // string -- and CI traces confirm why: even after the toggle click
+        // succeeds (no error thrown), an exact-match lookup here still times out
+        // with "element(s) not found", meaning the rendered link's accessible
+        // name is not byte-for-byte "Operate"/"Tasklist"/"Optimize" (likely
+        // additional content from the design-system sidebar item, e.g. an icon
+        // or badge). The app names are distinct enough that a substring match
+        // carries no ambiguity risk.
+        const appLink = this.hubSidebar.getByRole('link', {
+            name: appName,
+        });
+        // Decide whether to expand from clusterName's OWN toggle state, not from
+        // whether "some" appLink is already visible sidebar-wide: in a
+        // multi-cluster org another cluster's group can already be expanded with
+        // the same app name, which made this check pass while clusterName's own
+        // group stayed collapsed -- appLink.click() below then fired on the
+        // wrong cluster's link (see PR #3627 review).
+        const collapsedToggle = this.hubSidebar
+            .getByRole('button', { name: clusterName, expanded: false })
+            .first();
+        if (await collapsedToggle.isVisible({ timeout: 5000 }).catch(() => false)) {
+            // This is the only expansion action in the Hub path -- swallowing its
+            // failure made a broken expansion look successful and left the caller
+            // to burn the full 30s below waiting on an app link that could never
+            // appear, hiding the actionable error (e.g. a toggle that doesn't
+            // exist or isn't clickable) behind an unrelated timeout.
+            await collapsedToggle.click({ timeout: 10000 });
+        }
+        await (0, test_1.expect)(appLink).toBeVisible({ timeout: 30000 });
+        await appLink.click({ timeout: 10000 });
+    }
     async clickModeler() {
+        // Camunda Hub (hub.*) replaced Console + Web Modeler on SaaS and has no
+        // app switcher. Its home is the Modeler/Workspaces home, but a hostname
+        // check alone can't tell whether we're already there -- Hub's cluster
+        // pages are on the same hub.* hostname, and a no-op here would leave a
+        // caller that reaches clickModeler() from a cluster/API-client page
+        // stranded with the next locator running against the wrong page.
+        // Navigate home through the header logo link instead, same as
+        // ModelerHomePage.clickHomeBreadcrumb -- clicking it when already on the
+        // Modeler home is a harmless in-SPA no-op.
+        if (new URL(this.page.url()).hostname.startsWith('hub.')) {
+            const header = this.page.locator('header[data-slot="app-header"]');
+            // The href stays literally "/login" until the client's auth state
+            // catches up just after login (camunda-hub NavShellDs.common.tsx) --
+            // clicking it in that window would log the test out instead of
+            // navigating home, so exclude that href and wait for the authenticated
+            // one rather than racing it.
+            const homeLink = header
+                .getByRole('link', { name: 'Camunda Modeler home' })
+                .and(this.page.locator(':not([href$="/login"])'))
+                .or(header
+                .getByRole('link', { name: 'Camunda Hub home' })
+                .and(this.page.locator(':not([href$="/login"])')))
+                .first();
+            await (0, test_1.expect)(homeLink).toBeVisible({ timeout: 30000 });
+            await homeLink.click({ timeout: 30000 });
+            return;
+        }
         const maxRetries = 3;
         for (let retries = 0; retries < maxRetries; retries++) {
             try {
@@ -106,6 +183,10 @@ class AppsPage {
         throw new Error(`Failed to click the modeler link after ${maxRetries} attempts.`);
     }
     async clickTasklist(clusterName) {
+        if (new URL(this.page.url()).hostname.startsWith('hub.')) {
+            await this.clickHubClusterApp(clusterName, 'Tasklist');
+            return;
+        }
         const maxRetries = 3;
         for (let retries = 0; retries < maxRetries; retries++) {
             try {
@@ -144,6 +225,14 @@ class AppsPage {
         throw new Error(`Failed to click the tasklist link after ${maxRetries} attempts.`);
     }
     async clickAdmin(clusterName) {
+        if (new URL(this.page.url()).hostname.startsWith('hub.')) {
+            // Non-anchored, matching the substring lookup clickHubClusterApp uses
+            // for Operate/Tasklist/Optimize -- an anchored pattern fails the same
+            // way an exact-string match did for those apps if the rendered link's
+            // accessible name carries any extra content (icon/badge).
+            await this.clickHubClusterApp(clusterName, /Admin|Identity/);
+            return;
+        }
         const maxRetries = 5;
         for (let retries = 0; retries < maxRetries; retries++) {
             try {
@@ -218,6 +307,10 @@ class AppsPage {
         await this.clickCluster(this.optimizeListItem, clusterName);
     }
     async clickOperate(clusterName) {
+        if (new URL(this.page.url()).hostname.startsWith('hub.')) {
+            await this.clickHubClusterApp(clusterName, 'Operate');
+            return;
+        }
         const maxRetries = 3;
         for (let retries = 0; retries < maxRetries; retries++) {
             try {
@@ -252,6 +345,10 @@ class AppsPage {
         throw new Error(`Failed to click the operate link after ${maxRetries} attempts.`);
     }
     async clickOptimize(clusterName) {
+        if (new URL(this.page.url()).hostname.startsWith('hub.')) {
+            await this.clickHubClusterApp(clusterName, 'Optimize');
+            return;
+        }
         const maxRetries = 3;
         for (let retries = 0; retries < maxRetries; retries++) {
             try {
@@ -329,6 +426,13 @@ class AppsPage {
         }
     }
     async clickCamundaApps(maxRetries = 3) {
+        // Camunda Hub's rewritten shells have no app-switcher button to open --
+        // Modeler is already Hub's home area and the other apps are reached
+        // per-cluster via the persistent sidebar, not through a global switcher
+        // panel. Mirrors the same hostname guard in clickModeler() above.
+        if (new URL(this.page.url()).hostname.startsWith('hub.')) {
+            return;
+        }
         await (0, sleep_1.sleep)(2000);
         await this.dismissBlockingOverlays();
         const appButtons = [
@@ -357,6 +461,16 @@ class AppsPage {
         }
     }
     async clickConsoleLink() {
+        // Camunda Hub folded Console into the same persistent shell as
+        // Modeler/home: Console's Dashboard/Clusters/Organization links are
+        // just another section of the same "Main navigation" sidebar, not a
+        // separate app to switch into. Its header banner (homePage.consoleBanner,
+        // via hubHeader) is already visible from any Hub page, so there is no
+        // navigation action needed here -- mirrors the same hostname guard in
+        // clickModeler().
+        if (new URL(this.page.url()).hostname.startsWith('hub.')) {
+            return;
+        }
         const maxRetries = 3;
         for (let retries = 0; retries < maxRetries; retries++) {
             try {