@red-hat-developer-hub/e2e-test-utils 2.1.0 → 2.2.0

package/dist/playwright/helpers/auth-token.d.ts

@@ -0,0 +1,5 @@
+import { type Page } from "@playwright/test";
+import { UIhelper } from "./ui-helper.js";
+/** Obtain a bearer token from the logged-in browser session. */
+export declare function getSessionAuthToken(page: Page, uiHelper: UIhelper, baseUrl: string): Promise<string>;
+//# sourceMappingURL=auth-token.d.ts.map

package/dist/playwright/helpers/auth-token.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth-token.d.ts","sourceRoot":"","sources":["../../../src/playwright/helpers/auth-token.ts"],"names":[],"mappings":"AAAA,OAAO,EAAU,KAAK,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAErD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,gEAAgE;AAChE,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,IAAI,EACV,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,CAAC,CAwCjB"}

package/dist/playwright/helpers/auth-token.js

@@ -0,0 +1,37 @@
+import { expect } from "@playwright/test";
+import { AuthApiHelper } from "./auth-api-helper.js";
+/** Obtain a bearer token from the logged-in browser session. */
+export async function getSessionAuthToken(page, uiHelper, baseUrl) {
+    const authApiHelper = new AuthApiHelper(page);
+    const readToken = async () => {
+        try {
+            const value = await authApiHelper.getToken();
+            return value?.length > 0 ? value : undefined;
+        }
+        catch {
+            return undefined;
+        }
+    };
+    const existingToken = await readToken();
+    if (existingToken) {
+        return existingToken;
+    }
+    await page.goto(baseUrl);
+    await uiHelper.waitForAppReady();
+    let token = "";
+    await expect
+        .poll(async () => {
+        const value = await readToken();
+        if (value) {
+            token = value;
+            return true;
+        }
+        return false;
+    }, {
+        message: "Token should be retrieved after session is established",
+        timeout: 30_000,
+        intervals: [2_000],
+    })
+        .toBe(true);
+    return token;
+}

package/dist/playwright/helpers/catalog-api-helper.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Static helper for catalog entity lookups via the RHDH catalog API.
+ * Used by event-driven discovery tests that poll for ingest completion.
+ */
+export declare class CatalogApiHelper {
+    private static context;
+    private static getContext;
+    static dispose(): Promise<void>;
+    static entityExists(baseUrl: string, token: string, kind: string, name: string, namespace?: string): Promise<boolean>;
+    static getEntity(baseUrl: string, token: string, kind: string, name: string, namespace?: string): Promise<any>;
+    static getEntityDescription(baseUrl: string, token: string, kind: string, name: string, namespace?: string): Promise<string | undefined>;
+    static getGroupEntity(baseUrl: string, token: string, groupName: string): Promise<any>;
+    static getGroupMembers(baseUrl: string, token: string, groupName: string): Promise<string[]>;
+}
+//# sourceMappingURL=catalog-api-helper.d.ts.map

package/dist/playwright/helpers/catalog-api-helper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-api-helper.d.ts","sourceRoot":"","sources":["../../../src/playwright/helpers/catalog-api-helper.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAC,OAAO,CAAgC;mBAEjC,UAAU;WASlB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;WAOxB,YAAY,CACvB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,SAAS,SAAY,GACpB,OAAO,CAAC,OAAO,CAAC;WAYN,SAAS,CACpB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,SAAS,SAAY,GAEpB,OAAO,CAAC,GAAG,CAAC;WAmBF,oBAAoB,CAC/B,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,SAAS,SAAY,GACpB,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;WAKjB,cAAc,CACzB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,GAEhB,OAAO,CAAC,GAAG,CAAC;WAIF,eAAe,CAC1B,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,MAAM,EAAE,CAAC;CAcrB"}

package/dist/playwright/helpers/catalog-api-helper.js

@@ -0,0 +1,63 @@
+import { request } from "@playwright/test";
+/**
+ * Static helper for catalog entity lookups via the RHDH catalog API.
+ * Used by event-driven discovery tests that poll for ingest completion.
+ */
+export class CatalogApiHelper {
+    static context;
+    static async getContext() {
+        if (!this.context) {
+            this.context = await request.newContext({
+                ignoreHTTPSErrors: true,
+            });
+        }
+        return this.context;
+    }
+    static async dispose() {
+        if (this.context) {
+            await this.context.dispose();
+            this.context = undefined;
+        }
+    }
+    static async entityExists(baseUrl, token, kind, name, namespace = "default") {
+        try {
+            await this.getEntity(baseUrl, token, kind, name, namespace);
+            return true;
+        }
+        catch (error) {
+            if (error instanceof Error && error.message.includes("404")) {
+                return false;
+            }
+            throw error;
+        }
+    }
+    static async getEntity(baseUrl, token, kind, name, namespace = "default") {
+        const context = await this.getContext();
+        const url = `${baseUrl}/api/catalog/entities/by-name/${kind.toLowerCase()}/${namespace}/${name}`;
+        const response = await context.get(url, {
+            headers: {
+                Authorization: `Bearer ${token}`,
+            },
+        });
+        if (!response.ok()) {
+            throw new Error(`Failed to get ${kind} entity "${name}": ${response.status()} ${response.statusText()}`);
+        }
+        return await response.json();
+    }
+    static async getEntityDescription(baseUrl, token, kind, name, namespace = "default") {
+        const entity = await this.getEntity(baseUrl, token, kind, name, namespace);
+        return entity.metadata?.description;
+    }
+    static async getGroupEntity(baseUrl, token, groupName) {
+        return this.getEntity(baseUrl, token, "group", groupName);
+    }
+    static async getGroupMembers(baseUrl, token, groupName) {
+        const groupEntity = await CatalogApiHelper.getGroupEntity(baseUrl, token, groupName);
+        const members = groupEntity.relations
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            ?.filter((r) => r.type === "hasMember")
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            .map((r) => r.targetRef.split("/")[1]) || [];
+        return members;
+    }
+}

package/dist/playwright/helpers/catalog-api-helper.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=catalog-api-helper.test.d.ts.map

package/dist/playwright/helpers/catalog-api-helper.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-api-helper.test.d.ts","sourceRoot":"","sources":["../../../src/playwright/helpers/catalog-api-helper.test.ts"],"names":[],"mappings":""}

package/dist/playwright/helpers/catalog-api-helper.test.js

@@ -0,0 +1,66 @@
+import assert from "node:assert";
+import { afterEach, describe, it, mock } from "node:test";
+import { request } from "@playwright/test";
+import { CatalogApiHelper } from "./catalog-api-helper.js";
+const baseUrl = "https://rhdh.example.com";
+const token = "test-token";
+describe("CatalogApiHelper", () => {
+    afterEach(async () => {
+        await CatalogApiHelper.dispose();
+        mock.restoreAll();
+    });
+    it("entityExists returns false when catalog responds with 404", async () => {
+        mock.method(request, "newContext", async () => ({
+            get: async () => ({
+                ok: () => false,
+                status: () => 404,
+                statusText: () => "Not Found",
+            }),
+            dispose: async () => { },
+        }));
+        const exists = await CatalogApiHelper.entityExists(baseUrl, token, "component", "missing-entity");
+        assert.strictEqual(exists, false);
+    });
+    it("entityExists returns true when entity is found", async () => {
+        mock.method(request, "newContext", async () => ({
+            get: async () => ({
+                ok: () => true,
+                status: () => 200,
+                statusText: () => "OK",
+                json: async () => ({ metadata: { name: "my-entity" } }),
+            }),
+            dispose: async () => { },
+        }));
+        const exists = await CatalogApiHelper.entityExists(baseUrl, token, "component", "my-entity");
+        assert.strictEqual(exists, true);
+    });
+    it("entityExists rethrows non-404 errors", async () => {
+        mock.method(request, "newContext", async () => ({
+            get: async () => ({
+                ok: () => false,
+                status: () => 500,
+                statusText: () => "Internal Server Error",
+            }),
+            dispose: async () => { },
+        }));
+        await assert.rejects(() => CatalogApiHelper.entityExists(baseUrl, token, "component", "my-entity"), /500/);
+    });
+    it("getEntityDescription returns metadata.description", async () => {
+        mock.method(request, "newContext", async () => ({
+            get: async (url) => {
+                assert.match(url, /\/api\/catalog\/entities\/by-name\/component\/default\/my-entity$/);
+                return {
+                    ok: () => true,
+                    status: () => 200,
+                    statusText: () => "OK",
+                    json: async () => ({
+                        metadata: { description: "updated description" },
+                    }),
+                };
+            },
+            dispose: async () => { },
+        }));
+        const description = await CatalogApiHelper.getEntityDescription(baseUrl, token, "component", "my-entity");
+        assert.strictEqual(description, "updated description");
+    });
+});

package/dist/playwright/helpers/common.d.ts

@@ -14,7 +14,6 @@ export declare class LoginHelper {
     private handleGithubPopupReauth;
     googleSignIn(email: string): Promise<void>;
     checkAndClickOnGHloginPopup(force?: boolean): Promise<void>;
-    getButtonSelector(label: string): string;
     getLoginBtnSelector(): string;
     clickOnGHloginPopup(): Promise<void>;
     getGitHub2FAOTP(userid: string): string;

package/dist/playwright/helpers/common.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../../src/playwright/helpers/common.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAG1C,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAOhE,qBAAa,WAAW;IACtB,IAAI,EAAE,IAAI,CAAC;IACX,QAAQ,EAAE,QAAQ,CAAC;gBAEP,IAAI,EAAE,IAAI;IAKhB,YAAY;IAcZ,OAAO;YAMC,aAAa;IA2CrB,eAAe,CAAC,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;IAO7D,mBAAmB,CACvB,MAAM,GAAE,MAAkC,EAC1C,QAAQ,GAAE,MAAkC;IAWxC,iBAAiB,CACrB,MAAM,GAAE,MAA+C;IAoDnD,4BAA4B;YASpB,uBAAuB;IAgB/B,YAAY,CAAC,KAAK,EAAE,MAAM;IA2B1B,2BAA2B,CAAC,KAAK,UAAQ;IAU/C,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAIxC,mBAAmB,IAAI,MAAM;IAIvB,mBAAmB;IAgBzB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAevC,eAAe,IAAI,MAAM;IAKnB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;YAqCxC,sBAAsB;IAoD9B,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;IAYjE,2BAA2B,CAC/B,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM;IAYb,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;CA2C7D;AAED,wBAAsB,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ;;;GAWtE"}
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../../src/playwright/helpers/common.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAG1C,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAMhE,qBAAa,WAAW;IACtB,IAAI,EAAE,IAAI,CAAC;IACX,QAAQ,EAAE,QAAQ,CAAC;gBAEP,IAAI,EAAE,IAAI;IAKhB,YAAY;IAcZ,OAAO;YAMC,aAAa;IA2CrB,eAAe,CAAC,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;IAO7D,mBAAmB,CACvB,MAAM,GAAE,MAAkC,EAC1C,QAAQ,GAAE,MAAkC;IAWxC,iBAAiB,CACrB,MAAM,GAAE,MAA+C;IAoDnD,4BAA4B;YASpB,uBAAuB;IAgB/B,YAAY,CAAC,KAAK,EAAE,MAAM;IA2B1B,2BAA2B,CAAC,KAAK,UAAQ;IAU/C,mBAAmB,IAAI,MAAM;IAIvB,mBAAmB;IAgBzB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAevC,eAAe,IAAI,MAAM;IAKnB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;YAqCxC,sBAAsB;IAoD9B,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;IAYjE,2BAA2B,CAC/B,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM;IAYb,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;CA2C7D;AAED,wBAAsB,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ;;;GAWtE"}

package/dist/playwright/helpers/common.js

@@ -2,7 +2,6 @@ import { UIhelper } from "./ui-helper.js";
 import { authenticator } from "otplib";
 import { test, expect } from "@playwright/test";
 import { SETTINGS_PAGE_COMPONENTS } from "../page-objects/page-obj.js";
-import { UI_HELPER_ELEMENTS } from "../page-objects/global-obj.js";
 import * as path from "path";
 import * as fs from "fs";
 import { DEFAULT_USERS } from "../../deployment/keycloak/constants.js";
@@ -169,9 +168,6 @@ export class LoginHelper {
                 throw error;
         }
     }
-    getButtonSelector(label) {
-        return `${UI_HELPER_ELEMENTS.MuiButtonLabel}:has-text("${label}")`;
-    }
     getLoginBtnSelector() {
         return 'MuiListItem-root li.MuiListItem-root button.MuiButton-root:has(span.MuiButton-label:text("Log in"))';
     }

package/dist/playwright/helpers/index.d.ts

@@ -4,4 +4,7 @@ export { LoginHelper, setupBrowser } from "./common.js";
 export { UIhelper } from "./ui-helper.js";
 export { RbacApiHelper, Policy, Role, Response } from "./rbac-api-helper.js";
 export { AuthApiHelper } from "./auth-api-helper.js";
+export { getSessionAuthToken } from "./auth-token.js";
+export { CatalogApiHelper } from "./catalog-api-helper.js";
+export { RhdhNotificationsApi, type NotificationPayload, type NotificationRecipients, type NotificationRequest, type NotificationSeverity, type BroadcastRecipients, type EntityRecipients, } from "./notifications-api-helper.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/playwright/helpers/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/playwright/helpers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAC7E,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/playwright/helpers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAC7E,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EACL,oBAAoB,EACpB,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,EAC3B,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,GACtB,MAAM,+BAA+B,CAAC"}

package/dist/playwright/helpers/index.js

@@ -4,3 +4,6 @@ export { LoginHelper, setupBrowser } from "./common.js";
 export { UIhelper } from "./ui-helper.js";
 export { RbacApiHelper, Response } from "./rbac-api-helper.js";
 export { AuthApiHelper } from "./auth-api-helper.js";
+export { getSessionAuthToken } from "./auth-token.js";
+export { CatalogApiHelper } from "./catalog-api-helper.js";
+export { RhdhNotificationsApi, } from "./notifications-api-helper.js";

package/dist/playwright/helpers/notifications-api-helper.d.ts

@@ -0,0 +1,32 @@
+import { APIResponse } from "@playwright/test";
+export type NotificationSeverity = "critical" | "high" | "normal" | "low";
+export interface NotificationPayload {
+    title: string;
+    description: string;
+    severity: NotificationSeverity;
+    topic: string;
+}
+export type BroadcastRecipients = {
+    type: "broadcast";
+};
+export type EntityRecipients = {
+    type: "entity";
+    entityRef: string | string[];
+    excludeEntityRef?: string | string[];
+};
+export type NotificationRecipients = BroadcastRecipients | EntityRecipients;
+export interface NotificationRequest {
+    recipients: NotificationRecipients;
+    payload: NotificationPayload;
+}
+export declare class RhdhNotificationsApi {
+    private readonly token;
+    private readonly apiUrl;
+    private readonly authHeader;
+    private myContext;
+    private constructor();
+    static build(token: string): Promise<RhdhNotificationsApi>;
+    createNotification(notification: NotificationRequest): Promise<APIResponse>;
+    markAllNotificationsAsRead(): Promise<APIResponse>;
+}
+//# sourceMappingURL=notifications-api-helper.d.ts.map

package/dist/playwright/helpers/notifications-api-helper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notifications-api-helper.d.ts","sourceRoot":"","sources":["../../../src/playwright/helpers/notifications-api-helper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,WAAW,EAAW,MAAM,kBAAkB,CAAC;AAE3E,MAAM,MAAM,oBAAoB,GAAG,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;AAE1E,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,oBAAoB,CAAC;IAC/B,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,EAAE,WAAW,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,QAAQ,CAAC;IACf,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC7B,gBAAgB,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;CACtC,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG,mBAAmB,GAAG,gBAAgB,CAAC;AAE5E,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,sBAAsB,CAAC;IACnC,OAAO,EAAE,mBAAmB,CAAC;CAC9B;AAED,qBAAa,oBAAoB;IAUX,OAAO,CAAC,QAAQ,CAAC,KAAK;IAT1C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuC;IAE9D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAGzB;IAEF,OAAO,CAAC,SAAS,CAAqB;IAEtC,OAAO;WAOa,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAS1D,kBAAkB,CAC7B,YAAY,EAAE,mBAAmB,GAChC,OAAO,CAAC,WAAW,CAAC;IAIV,0BAA0B,IAAI,OAAO,CAAC,WAAW,CAAC;CAQhE"}

package/dist/playwright/helpers/notifications-api-helper.js

@@ -0,0 +1,35 @@
+import { request } from "@playwright/test";
+export class RhdhNotificationsApi {
+    token;
+    apiUrl = `${process.env.RHDH_BASE_URL}/api/`;
+    /* eslint-disable @typescript-eslint/naming-convention */
+    authHeader;
+    /* eslint-enable @typescript-eslint/naming-convention */
+    myContext;
+    constructor(token) {
+        this.token = token;
+        this.authHeader = {
+            Accept: "application/json",
+            Authorization: `Bearer ${this.token}`,
+        };
+    }
+    static async build(token) {
+        const instance = new RhdhNotificationsApi(token);
+        instance.myContext = await request.newContext({
+            baseURL: instance.apiUrl,
+            extraHTTPHeaders: instance.authHeader,
+        });
+        return instance;
+    }
+    async createNotification(notification) {
+        return await this.myContext.post("notifications", { data: notification });
+    }
+    async markAllNotificationsAsRead() {
+        return await this.myContext.patch("notifications", {
+            data: {
+                ids: [],
+                read: true,
+            },
+        });
+    }
+}

package/dist/playwright/helpers/ui-helper.d.ts

@@ -4,6 +4,8 @@ export declare class UIhelper {
     private page;
     constructor(page: Page);
     waitForLoad(timeout?: number): Promise<void>;
+    /** Wait for MUI and BUI loading indicators to clear. Alias for {@link waitForLoad}. */
+    waitForAppReady(timeout?: number): Promise<void>;
     /**
      * Closes the quickstart drawer when the "Hide" button is visible (RHDH quickstart plugin),
      * so it does not cover catalog or other UI under test.

package/dist/playwright/helpers/ui-helper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ui-helper.d.ts","sourceRoot":"","sources":["../../../src/playwright/helpers/ui-helper.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ui-helper.d.ts","sourceRoot":"","sources":["../../../src/playwright/helpers/ui-helper.ts"],"names":[],"mappings":"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"}

package/dist/playwright/helpers/ui-helper.js

@@ -14,6 +14,10 @@ export class UIhelper {
             });
         }
     }
+    /** Wait for MUI and BUI loading indicators to clear. Alias for {@link waitForLoad}. */
+    async waitForAppReady(timeout = 120000) {
+        await this.waitForLoad(timeout);
+    }
     /**
      * Closes the quickstart drawer when the "Hide" button is visible (RHDH quickstart plugin),
      * so it does not cover catalog or other UI under test.
@@ -70,17 +74,10 @@ export class UIhelper {
         exact: true,
         force: false,
     }) {
-        const selector = `${UI_HELPER_ELEMENTS.MuiButtonLabel}`;
         const button = this.page
-            .locator(selector)
-            .getByText(label, { exact: options.exact })
+            .getByRole("button", { name: label, exact: options.exact })
             .first();
-        if (options?.force) {
-            await button.click({ force: true });
-        }
-        else {
-            await button.click();
-        }
+        await button.click({ force: options.force });
         return button;
     }
     async clickBtnByTitleIfNotPressed(title) {
@@ -218,7 +215,7 @@ export class UIhelper {
             .locator(`nav a:has-text("${navBarText}")`)
             .first();
         await navLink.waitFor({ state: "visible", timeout: 15_000 });
-        await navLink.dispatchEvent("click");
+        await navLink.click();
     }
     async openCatalogSidebar(kind) {
         await this.openSidebar("Catalog");

package/dist/playwright/page-objects/global-obj.d.ts

@@ -1,9 +1,12 @@
 export declare const WAIT_OBJECTS: {
     MuiLinearProgress: string;
     MuiCircularProgress: string;
+    /** Backstage UI (BUI) — additive so MUI and BUI apps both settle before assertions */
+    progressBar: string;
+    buttonSpinner: string;
+    alertSpinner: string;
 };
 export declare const UI_HELPER_ELEMENTS: {
-    MuiButtonLabel: string;
     MuiToggleButtonLabel: string;
     MuiBoxLabel: string;
     MuiTableHead: string;

package/dist/playwright/page-objects/global-obj.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"global-obj.d.ts","sourceRoot":"","sources":["../../../src/playwright/page-objects/global-obj.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,YAAY;;;CAGxB,CAAC;AAEF,eAAO,MAAM,kBAAkB;;;;;;;;;;2BAWN,MAAM;4BAEL,MAAM;;;;;;;sBAQZ,MAAM;CACzB,CAAC"}
+{"version":3,"file":"global-obj.d.ts","sourceRoot":"","sources":["../../../src/playwright/page-objects/global-obj.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,YAAY;;;IAGvB,sFAAsF;;;;CAIvF,CAAC;AAEF,eAAO,MAAM,kBAAkB;;;;;;;;;2BASN,MAAM;4BAEL,MAAM;;;;;;;sBAQZ,MAAM;CACzB,CAAC"}

package/dist/playwright/page-objects/global-obj.js

@@ -1,9 +1,12 @@
 export const WAIT_OBJECTS = {
     MuiLinearProgress: 'div[class*="MuiLinearProgress-root"]',
     MuiCircularProgress: '[class*="MuiCircularProgress-root"]',
+    /** Backstage UI (BUI) — additive so MUI and BUI apps both settle before assertions */
+    progressBar: '[role="progressbar"]',
+    buttonSpinner: ".bui-ButtonSpinner, .bui-ButtonIconSpinner",
+    alertSpinner: ".bui-AlertSpinner",
 };
 export const UI_HELPER_ELEMENTS = {
-    MuiButtonLabel: 'span[class^="MuiButton-label"],button[class*="MuiButton-root"]',
     MuiToggleButtonLabel: 'span[class^="MuiToggleButton-label"]',
     MuiBoxLabel: 'div[class*="MuiBox-root"] label',
     MuiTableHead: 'th[class*="MuiTableCell-root"]',

package/dist/playwright/page-objects/global-obj.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=global-obj.test.d.ts.map

package/dist/playwright/page-objects/global-obj.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"global-obj.test.d.ts","sourceRoot":"","sources":["../../../src/playwright/page-objects/global-obj.test.ts"],"names":[],"mappings":""}

package/dist/playwright/page-objects/global-obj.test.js

@@ -0,0 +1,14 @@
+import assert from "node:assert";
+import { describe, it } from "node:test";
+import { WAIT_OBJECTS } from "./global-obj.js";
+describe("WAIT_OBJECTS", () => {
+    it("includes MUI loading selectors", () => {
+        assert.ok(WAIT_OBJECTS.MuiLinearProgress);
+        assert.ok(WAIT_OBJECTS.MuiCircularProgress);
+    });
+    it("includes BUI loading selectors", () => {
+        assert.ok(WAIT_OBJECTS.progressBar);
+        assert.ok(WAIT_OBJECTS.buttonSpinner);
+        assert.ok(WAIT_OBJECTS.alertSpinner);
+    });
+});

package/dist/playwright/pages/notifications.d.ts

@@ -1,14 +1,16 @@
 import { type Page } from "@playwright/test";
+import { UIhelper } from "../helpers/ui-helper.js";
 export declare class NotificationPage {
     private readonly page;
     private readonly uiHelper;
-    constructor(page: Page);
-    clickNotificationsNavBarItem(): Promise<void>;
+    constructor(page: Page, uiHelper?: UIhelper);
+    /** Navigate to the notifications page and wait until it is ready. */
+    navigateToNotifications(): Promise<void>;
     notificationContains(text: string | RegExp): Promise<void>;
     clickNotificationHeadingLink(text: string | RegExp): Promise<void>;
     markAllNotificationsAsRead(): Promise<void>;
     selectAllNotifications(): Promise<void>;
-    selectNotification(nth?: number): Promise<void>;
+    selectNotification(textOrNth?: string | RegExp | number): Promise<void>;
     selectSeverity(severity?: string): Promise<void>;
     saveSelected(): Promise<void>;
     saveAllSelected(): Promise<void>;
@@ -20,5 +22,14 @@ export declare class NotificationPage {
     viewUnRead(): Promise<void>;
     sortByOldestOnTop(): Promise<void>;
     sortByNewestOnTop(): Promise<void>;
+    private severityFilter;
+    private saveSelectedButton;
+    private notificationRowsBui;
+    private findNotificationRow;
+    private waitForNotificationsReady;
+    private dismissNotificationToasts;
+    private setRowsPerPage;
+    private toggleRead;
+    private expectUnreadCountDecreased;
 }
 //# sourceMappingURL=notifications.d.ts.map

package/dist/playwright/pages/notifications.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"notifications.d.ts","sourceRoot":"","sources":["../../../src/playwright/pages/notifications.ts"],"names":[],"mappings":"AAAA,OAAO,EAAU,KAAK,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAGrD,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAO;IAC5B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAW;gBAExB,IAAI,EAAE,IAAI;IAKhB,4BAA4B;IAO5B,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAW1C,4BAA4B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAOlD,0BAA0B;IAiB1B,sBAAsB;IAItB,kBAAkB,CAAC,GAAG,SAAI;IAI1B,cAAc,CAAC,QAAQ,SAAK;IAW5B,YAAY;IAWZ,eAAe;IAWf,SAAS;IAQT,0BAA0B;IAK1B,sBAAsB,CAAC,IAAI,EAAE,MAAM;IAKnC,4BAA4B;IAK5B,QAAQ;IAUR,UAAU;IAUV,iBAAiB;IAQjB,iBAAiB;CAOxB"}
+{"version":3,"file":"notifications.d.ts","sourceRoot":"","sources":["../../../src/playwright/pages/notifications.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwB,KAAK,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACnE,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAEnD,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAO;IAC5B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAW;gBAExB,IAAI,EAAE,IAAI,EAAE,QAAQ,CAAC,EAAE,QAAQ;IAK3C,qEAAqE;IAC/D,uBAAuB;IAgBvB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAU1C,4BAA4B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAQlD,0BAA0B;IAsB1B,sBAAsB;IAItB,kBAAkB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM;IAgCvD,cAAc,CAAC,QAAQ,SAAK;IAS5B,YAAY;IAKZ,eAAe;IAKf,SAAS;IAMT,0BAA0B;IAI1B,sBAAsB,CAAC,IAAI,EAAE,MAAM;IAInC,4BAA4B;IAI5B,QAAQ;IAQR,UAAU;IAQV,iBAAiB;IAMjB,iBAAiB;IAMvB,OAAO,CAAC,cAAc;IAItB,OAAO,CAAC,kBAAkB;IAW1B,OAAO,CAAC,mBAAmB;IAM3B,OAAO,CAAC,mBAAmB;YAMb,yBAAyB;YAezB,yBAAyB;YAczB,cAAc;YAed,UAAU;YAyBV,0BAA0B;CAezC"}

package/dist/playwright/pages/notifications.js

@@ -3,21 +3,35 @@ import { UIhelper } from "../helpers/ui-helper.js";
 export class NotificationPage {
     page;
     uiHelper;
-    constructor(page) {
+    constructor(page, uiHelper) {
         this.page = page;
-        this.uiHelper = new UIhelper(page);
-    }
-    async clickNotificationsNavBarItem() {
-        await this.uiHelper.openSidebar("Notifications");
-        await expect(this.page.getByTestId("loading-indicator").getByRole("img")).toHaveCount(0);
+        this.uiHelper = uiHelper ?? new UIhelper(page);
+    }
+    /** Navigate to the notifications page and wait until it is ready. */
+    async navigateToNotifications() {
+        await this.dismissNotificationToasts();
+        await expect(async () => {
+            try {
+                await this.uiHelper.openSidebar("Notifications");
+                await this.waitForNotificationsReady(15_000);
+                await this.uiHelper.verifyHeading("Notifications", 15_000);
+            }
+            catch {
+                await this.page.goto("/notifications");
+                await this.waitForNotificationsReady(15_000);
+                await expect(this.page).toHaveURL(/\/notifications/);
+                await this.uiHelper.verifyHeading("Notifications", 15_000);
+            }
+        }).toPass({ timeout: 60_000, intervals: [2_000] });
     }
     async notificationContains(text) {
-        await this.page.getByLabel(/.*rows/).click();
-        // always expand the notifications table to show as many notifications as possible
-        await this.page.getByRole("option", { name: "20" }).click();
-        await expect(this.page.getByTestId("loading-indicator").getByRole("img")).toHaveCount(0);
-        const row = this.page.locator(`tr`, { hasText: text }).first();
-        await expect(row).toHaveCount(1);
+        await this.dismissNotificationToasts();
+        let row = this.findNotificationRow(text);
+        if (!(await row.isVisible())) {
+            await this.setRowsPerPage(20);
+            row = this.findNotificationRow(text);
+        }
+        await expect(row).toBeVisible();
     }
     async clickNotificationHeadingLink(text) {
         await this.page
@@ -27,86 +41,192 @@ export class NotificationPage {
             .click();
     }
     async markAllNotificationsAsRead() {
-        const markAllNotificationsAsReadIsVisible = await this.page
+        const markAllButton = this.page
             .getByTitle("Mark all read")
-            .getByRole("button")
-            .isVisible();
-        console.log(markAllNotificationsAsReadIsVisible);
-        // If button isn't visible there are no records in the notification table
-        if (markAllNotificationsAsReadIsVisible.toString() != "false") {
-            await this.page.getByTitle("Mark all read").getByRole("button").click();
-            await this.page.getByRole("button", { name: "MARK ALL" }).click();
-            await expect(this.page.getByTestId("loading-indicator").getByRole("img")).toHaveCount(0);
+            .getByRole("button");
+        const markAllByLabel = this.page.getByRole("button", {
+            name: /mark all read/i,
+        });
+        const target = (await markAllButton.isVisible().catch(() => false))
+            ? markAllButton
+            : markAllByLabel;
+        if (await target.isVisible().catch(() => false)) {
+            await target.click();
+            const confirm = this.page.getByRole("button", { name: /MARK ALL/i });
+            if (await confirm.isVisible().catch(() => false)) {
+                await confirm.click();
+            }
+            await this.waitForNotificationsReady();
             await expect(this.page.getByText("No records to display")).toBeVisible();
         }
     }
     async selectAllNotifications() {
         await this.page.getByRole("checkbox").first().click();
     }
-    async selectNotification(nth = 1) {
-        await this.page.getByRole("checkbox").nth(nth).click();
+    async selectNotification(textOrNth) {
+        await this.dismissNotificationToasts();
+        if (typeof textOrNth === "number") {
+            await this.page.getByRole("checkbox").nth(textOrNth).click();
+            return;
+        }
+        let row = textOrNth !== undefined
+            ? this.findNotificationRow(textOrNth).first()
+            : this.notificationRowsBui().first();
+        if (textOrNth !== undefined && !(await row.isVisible())) {
+            await this.setRowsPerPage(20);
+            row = this.findNotificationRow(textOrNth).first();
+        }
+        const buiCheckbox = row.getByRole("checkbox", {
+            name: "Select notification",
+        });
+        if (await buiCheckbox.isVisible().catch(() => false)) {
+            await buiCheckbox.check({ force: true });
+            return;
+        }
+        if (textOrNth === undefined) {
+            await this.page.getByRole("checkbox").first().click();
+            return;
+        }
+        await row.getByRole("checkbox").first().click();
     }
     async selectSeverity(severity = "") {
-        await this.page.getByLabel("Severity").click();
+        await this.severityFilter().click();
         await this.page.getByRole("option", { name: severity }).click();
         await expect(this.page.getByRole("table").filter({ hasText: "Rows per page" })).toBeVisible();
-        await expect(this.page.getByTestId("loading-indicator").getByRole("img")).toHaveCount(0);
+        await this.waitForNotificationsReady();
     }
     async saveSelected() {
-        await this.page
-            .locator("thead")
-            .getByTitle("Save selected for later")
-            .getByRole("button")
-            .click();
-        await expect(this.page.getByTestId("loading-indicator").getByRole("img")).toHaveCount(0);
+        await this.saveSelectedButton().click();
+        await this.waitForNotificationsReady();
     }
     async saveAllSelected() {
-        await this.page
-            .locator("thead")
-            .getByTitle("Save selected for later")
-            .getByRole("button")
-            .click();
-        await expect(this.page.getByTestId("loading-indicator").getByRole("img")).toHaveCount(0);
+        await this.saveSelectedButton().click();
+        await this.waitForNotificationsReady();
     }
     async viewSaved() {
         await this.page.getByLabel("View").click();
         await this.page.getByRole("option", { name: "Saved" }).click();
-        await expect(this.page.getByTestId("loading-indicator").getByRole("img")).toHaveCount(0);
+        await this.waitForNotificationsReady();
     }
     async markLastNotificationAsRead() {
-        const row = this.page.locator("td:nth-child(3) > div").first();
-        await row.getByRole("button").nth(1).click();
+        await this.toggleRead("unread");
     }
     async markNotificationAsRead(text) {
-        const row = this.page.locator(`tr:has-text("${text}")`);
-        await row.getByRole("button").nth(1).click();
+        await this.toggleRead("unread", text);
     }
     async markLastNotificationAsUnRead() {
-        const row = this.page.locator("td:nth-child(3) > div").first();
-        await row.getByRole("button").nth(1).click();
+        await this.toggleRead("read");
     }
     async viewRead() {
         await this.page.getByLabel("View").click();
         await this.page
             .getByRole("option", { name: "Read notifications", exact: true })
             .click();
-        await expect(this.page.getByTestId("loading-indicator").getByRole("img")).toHaveCount(0);
+        await this.waitForNotificationsReady();
     }
     async viewUnRead() {
         await this.page.getByLabel("View").click();
         await this.page
             .getByRole("option", { name: "Unread notifications", exact: true })
             .click();
-        await expect(this.page.getByTestId("loading-indicator").getByRole("img")).toHaveCount(0);
+        await this.waitForNotificationsReady();
     }
     async sortByOldestOnTop() {
         await this.page.getByLabel("Sort by").click();
         await this.page.getByRole("option", { name: "Oldest on top" }).click();
-        await expect(this.page.getByTestId("loading-indicator").getByRole("img")).toHaveCount(0);
+        await this.waitForNotificationsReady();
     }
     async sortByNewestOnTop() {
         await this.page.getByLabel("Sort by").click();
         await this.page.getByRole("option", { name: "Newest on top" }).click();
-        await expect(this.page.getByTestId("loading-indicator").getByRole("img")).toHaveCount(0);
+        await this.waitForNotificationsReady();
+    }
+    severityFilter() {
+        return this.page.getByLabel(/^(Min )?severity$/i);
+    }
+    saveSelectedButton() {
+        const bui = this.page.locator('thead button[aria-label="Save selected for later"]');
+        const mui = this.page
+            .locator("thead")
+            .getByTitle("Save selected for later")
+            .getByRole("button");
+        return bui.or(mui).first();
+    }
+    notificationRowsBui() {
+        return this.page.getByRole("row").filter({
+            has: this.page.getByRole("checkbox", { name: "Select notification" }),
+        });
+    }
+    findNotificationRow(text) {
+        const buiRow = this.notificationRowsBui().filter({ hasText: text }).first();
+        const legacyRow = this.page.locator("tr", { hasText: text }).first();
+        return buiRow.or(legacyRow).first();
+    }
+    async waitForNotificationsReady(timeout = 30_000) {
+        await this.uiHelper.waitForAppReady(timeout);
+        const muiLoader = this.page
+            .getByTestId("loading-indicator")
+            .getByRole("img");
+        if (await muiLoader
+            .first()
+            .isVisible()
+            .catch(() => false)) {
+            await expect(muiLoader).toHaveCount(0, { timeout });
+        }
+    }
+    async dismissNotificationToasts() {
+        const toasts = this.page.locator("#notistack-snackbar, .notistack-CollapseWrapper");
+        if (await toasts
+            .first()
+            .isVisible()
+            .catch(() => false)) {
+            await expect(toasts.first()).toBeHidden({ timeout: 15_000 });
+        }
+    }
+    async setRowsPerPage(size) {
+        await this.dismissNotificationToasts();
+        const rowsPerPage = this.page.getByRole("button", {
+            name: /rows per page/i,
+        });
+        const legacyRows = this.page.getByLabel(/.*rows/i);
+        if (await rowsPerPage.isVisible().catch(() => false)) {
+            await rowsPerPage.click({ force: true });
+        }
+        else {
+            await legacyRows.click();
+        }
+        await this.page.getByRole("option", { name: String(size) }).click();
+        await this.waitForNotificationsReady();
+    }
+    async toggleRead(currentState, text) {
+        await this.dismissNotificationToasts();
+        const readButtonName = currentState === "unread"
+            ? /Mark selected as read/i
+            : /Return selected among unread/i;
+        const buiRows = this.notificationRowsBui();
+        const buiRow = text ? buiRows.filter({ hasText: text }) : buiRows.first();
+        const buiAction = buiRow.getByRole("button", { name: readButtonName });
+        if (await buiAction.isVisible().catch(() => false)) {
+            const count = await buiRows.count();
+            await buiAction.click();
+            await this.waitForNotificationsReady();
+            await this.expectUnreadCountDecreased(buiRows, count, currentState);
+            return;
+        }
+        const legacyRow = text
+            ? this.page.locator(`tr:has-text("${text}")`)
+            : this.page.locator("td:nth-child(3) > div").first();
+        await legacyRow.getByRole("button").nth(1).click();
+        await this.waitForNotificationsReady();
+    }
+    async expectUnreadCountDecreased(rows, count, currentState) {
+        const viewPattern = currentState === "unread"
+            ? /Unread notifications \(/
+            : /Read notifications \(/;
+        if (await this.page.getByText(viewPattern).isVisible()) {
+            await expect(async () => {
+                await expect(rows).toHaveCount(count - 1);
+            }).toPass({ timeout: 15_000, intervals: [1_000] });
+        }
     }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@red-hat-developer-hub/e2e-test-utils",
-  "version": "2.1.0",
+  "version": "2.2.0",
   "description": "Test utilities for RHDH E2E tests",
   "license": "Apache-2.0",
   "repository": {