@qawolf/pom 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 QA Wolf Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,53 @@
+# @qawolf/pom
+
+`@qawolf/pom` is a TypeScript toolkit for building Page Object Models (POMs) on
+top of Playwright: base classes for page objects, a central registry that lets
+page objects construct one another without circular imports, and automatic
+popup and route-hook installation.
+
+To learn more about how to use `@qawolf/pom`, check out the
+[API Reference](https://docs.qawolf.com/qawolf/libraries/pom/api-reference/index)
+and [Documentation](https://docs.qawolf.com/qawolf/libraries/pom).
+
+## Install
+
+```sh
+npm install @qawolf/pom
+```
+
+## Usage
+
+Define a page object by extending `BasePageObject`, keeping selectors in a
+private `locators` getter and constructing sibling page objects with
+`this.create(...)`.
+
+```ts
+import { BasePageObject } from "@qawolf/pom";
+
+export class LoginPage extends BasePageObject {
+  private get locators() {
+    return {
+      email: this.page.getByLabel("Email"),
+      submit: this.page.getByRole("button", { name: "Sign in" }),
+    } as const;
+  }
+
+  async signIn(email: string) {
+    await this.locators.email.fill(email);
+    await this.locators.submit.click();
+    return this.create("DashboardPage");
+  }
+}
+```
+
+Register every page object once — importing the registration module for its
+side effects before constructing any page object — then build one for a
+Playwright `page`.
+
+```ts
+import { createPage, registerPage } from "@qawolf/pom";
+
+registerPage("LoginPage", () => import("./pages/login-page.js"));
+
+const loginPage = await createPage("LoginPage", page);
+```

package/dist/basePageObject.d.ts

@@ -0,0 +1,50 @@
+import type { Locator, Page } from "playwright";
+import type { RegisteredPages } from "./index.js";
+import type { PopupHandlerDef, RouteInterceptorDef } from "./pageHooks.js";
+export type BaselineScreenshotFn = (target: Page | Locator, name: string, options?: Record<string, unknown>) => Promise<void>;
+export declare abstract class BasePageObject {
+    protected page: Page;
+    protected constructor(page: Page);
+    /**
+     * Public factory for the page registry while keeping constructors protected.
+     */
+    static createFromPage<TPageObject extends BasePageObject>(this: new (page: Page) => TPageObject, page: Page): TPageObject;
+    /**
+     * Popups owned by this POM that should be auto-dismissed when the entry
+     * point installs page hooks. Override in subclasses that own popups; the
+     * page registry detects the override via an own-property check on the
+     * registered class's prototype at registration time, so no extra wiring is
+     * needed in `register-pages.ts`. Inherited overrides are NOT picked up —
+     * declare `popupHandlers()` directly on the class you register (see
+     * `pageRegistry.ts` for details).
+     *
+     * Override bodies typically read from `this.locators` / `this.dynamicLocators`.
+     */
+    popupHandlers(): PopupHandlerDef[];
+    /**
+     * Route interceptors owned by this POM that should be installed when the
+     * entry point installs page hooks. Override in subclasses; the page
+     * registry auto-detects the override the same way it does for
+     * `popupHandlers` (own-property check on the registered class's
+     * prototype — inherited overrides are not picked up).
+     */
+    routeInterceptors(): RouteInterceptorDef[];
+    /**
+     * Construct a sibling POM that shares this page instance.
+     *
+     * This is the ONLY way POMs should create other POMs — it routes through
+     * the central page registry, eliminating circular import dependencies.
+     * POMs never `import { SiblingPage }` as a value; they use
+     * `import type { SiblingPage }` for return-type annotations and call
+     * `await this.create('SiblingPage')` for runtime construction. The call
+     * is async because lazily registered POM modules load on first use.
+     *
+     * When the workspace's `register-pages.ts` augments `RegisteredPages`,
+     * names in the map return their page-object type without an annotation;
+     * other names default to `BasePageObject`, so annotate the call —
+     * `this.create<NextPage>("NextPage")` — for a more specific type.
+     */
+    protected create<TName extends keyof RegisteredPages & string>(name: TName): Promise<RegisteredPages[TName]>;
+    protected create<TPageObject extends BasePageObject = BasePageObject>(name: string): Promise<TPageObject>;
+}
+//# sourceMappingURL=basePageObject.d.ts.map

package/dist/basePageObject.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"basePageObject.d.ts","sourceRoot":"","sources":["../src/basePageObject.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAEhD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,KAAK,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAG3E,MAAM,MAAM,oBAAoB,GAAG,CACjC,MAAM,EAAE,IAAI,GAAG,OAAO,EACtB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC9B,OAAO,CAAC,IAAI,CAAC,CAAC;AAEnB,8BAAsB,cAAc;IAClC,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC;IAErB,SAAS,aAAa,IAAI,EAAE,IAAI;IAIhC;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,WAAW,SAAS,cAAc,EACtD,IAAI,EAAE,KAAK,IAAI,EAAE,IAAI,KAAK,WAAW,EACrC,IAAI,EAAE,IAAI,GACT,WAAW;IAId;;;;;;;;;;OAUG;IACH,aAAa,IAAI,eAAe,EAAE;IAIlC;;;;;;OAMG;IACH,iBAAiB,IAAI,mBAAmB,EAAE;IAI1C;;;;;;;;;;;;;;OAcG;IACH,SAAS,CAAC,MAAM,CAAC,KAAK,SAAS,MAAM,eAAe,GAAG,MAAM,EAC3D,IAAI,EAAE,KAAK,GACV,OAAO,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;IAClC,SAAS,CAAC,MAAM,CAAC,WAAW,SAAS,cAAc,GAAG,cAAc,EAClE,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,WAAW,CAAC;CAIxB"}

package/dist/basePageObject.js

@@ -0,0 +1,41 @@
+import { createPage } from "./pageRegistry.js";
+export class BasePageObject {
+    page;
+    constructor(page) {
+        this.page = page;
+    }
+    /**
+     * Public factory for the page registry while keeping constructors protected.
+     */
+    static createFromPage(page) {
+        return new this(page);
+    }
+    /**
+     * Popups owned by this POM that should be auto-dismissed when the entry
+     * point installs page hooks. Override in subclasses that own popups; the
+     * page registry detects the override via an own-property check on the
+     * registered class's prototype at registration time, so no extra wiring is
+     * needed in `register-pages.ts`. Inherited overrides are NOT picked up —
+     * declare `popupHandlers()` directly on the class you register (see
+     * `pageRegistry.ts` for details).
+     *
+     * Override bodies typically read from `this.locators` / `this.dynamicLocators`.
+     */
+    popupHandlers() {
+        return [];
+    }
+    /**
+     * Route interceptors owned by this POM that should be installed when the
+     * entry point installs page hooks. Override in subclasses; the page
+     * registry auto-detects the override the same way it does for
+     * `popupHandlers` (own-property check on the registered class's
+     * prototype — inherited overrides are not picked up).
+     */
+    routeInterceptors() {
+        return [];
+    }
+    create(name) {
+        return createPage(name, this.page);
+    }
+}
+//# sourceMappingURL=basePageObject.js.map

package/dist/basePageObject.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"basePageObject.js","sourceRoot":"","sources":["../src/basePageObject.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAQ/C,MAAM,OAAgB,cAAc;IACxB,IAAI,CAAO;IAErB,YAAsB,IAAU;QAC9B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,cAAc,CAEnB,IAAU;QAEV,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC;IAED;;;;;;;;;;OAUG;IACH,aAAa;QACX,OAAO,EAAE,CAAC;IACZ,CAAC;IAED;;;;;;OAMG;IACH,iBAAiB;QACf,OAAO,EAAE,CAAC;IACZ,CAAC;IAuBS,MAAM,CAAC,IAAY;QAC3B,OAAO,UAAU,CAAiB,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IACrD,CAAC;CACF"}

package/dist/cleanupUtils.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Cleanup Utilities
+ *
+ * Provides fail-safe reporting for cleanup sequence failures.
+ * Cleanup sequences reset server-side state (cart, addresses, prefs)
+ * between test runs. When a cleanup fails, it is logged but does NOT
+ * abort the test — the test continues and the failure is reported
+ * separately for investigation.
+ *
+ * API endpoint documentation: https://task-wolf.com/docs/users/automation/apis/cleanup-alerts/
+ */
+export type ReportCleanupFailedParams = {
+    dedupKey?: string;
+    errorMsg?: string;
+};
+/**
+ * POST cleanup failure details to the automation Cleanup Failure API.
+ * No-ops when `QAWOLF_RUN_ID` is unset (e.g. editor runs).
+ */
+export declare function reportCleanupFailed({ dedupKey, errorMsg, }?: ReportCleanupFailedParams): Promise<unknown>;
+/**
+ * Report a cleanup sequence failure to the automation stack.
+ * Logs the error but does NOT throw — the test continues.
+ *
+ * @param cleanupName - Identifier for the cleanup (e.g., "cart-cleanup")
+ * @param error - The error thrown by the cleanup sequence
+ */
+export declare function reportCleanupFailure(cleanupName: string, error: unknown): void;
+//# sourceMappingURL=cleanupUtils.d.ts.map

package/dist/cleanupUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cleanupUtils.d.ts","sourceRoot":"","sources":["../src/cleanupUtils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,MAAM,MAAM,yBAAyB,GAAG;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;;GAGG;AACH,wBAAsB,mBAAmB,CAAC,EACxC,QAAQ,EACR,QAAQ,GACT,GAAE,yBAA8B,GAAG,OAAO,CAAC,OAAO,CAAC,CA0BnD;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,OAAO,GACb,IAAI,CAeN"}

package/dist/cleanupUtils.js

@@ -0,0 +1,62 @@
+/**
+ * Cleanup Utilities
+ *
+ * Provides fail-safe reporting for cleanup sequence failures.
+ * Cleanup sequences reset server-side state (cart, addresses, prefs)
+ * between test runs. When a cleanup fails, it is logged but does NOT
+ * abort the test — the test continues and the failure is reported
+ * separately for investigation.
+ *
+ * API endpoint documentation: https://task-wolf.com/docs/users/automation/apis/cleanup-alerts/
+ */
+const cleanupApiUrl = "https://task-wolf.com/apis/cleanup-fail";
+/**
+ * POST cleanup failure details to the automation Cleanup Failure API.
+ * No-ops when `QAWOLF_RUN_ID` is unset (e.g. editor runs).
+ */
+export async function reportCleanupFailed({ dedupKey, errorMsg, } = {}) {
+    const payload = {
+        dedupKey,
+        errorMsg,
+        runId: process.env.QAWOLF_RUN_ID,
+        suiteId: process.env.QAWOLF_SUITE_ID,
+        teamId: process.env.QAWOLF_TEAM_ID,
+        workflowId: process.env.QAWOLF_WORKFLOW_ID,
+    };
+    if (!payload.runId)
+        return;
+    try {
+        const response = await fetch(cleanupApiUrl, {
+            body: JSON.stringify(payload),
+            headers: { "Content-Type": "application/json" },
+            method: "POST",
+        });
+        if (response.ok)
+            return await response.json();
+        throw Error(`HTTP error! Status: ${response.status}`);
+    }
+    catch (error) {
+        const msg = error instanceof Error ? error.message : String(error);
+        throw Error(`Fetch or parsing error! ${msg}`);
+    }
+}
+/**
+ * Report a cleanup sequence failure to the automation stack.
+ * Logs the error but does NOT throw — the test continues.
+ *
+ * @param cleanupName - Identifier for the cleanup (e.g., "cart-cleanup")
+ * @param error - The error thrown by the cleanup sequence
+ */
+export function reportCleanupFailure(cleanupName, error) {
+    const message = error instanceof Error ? error.message : String(error);
+    const stack = error instanceof Error ? error.stack : undefined;
+    console.warn(`[CLEANUP FAILED] ${cleanupName}: ${message}`);
+    if (stack)
+        console.warn(`[CLEANUP STACK] ${stack}`);
+    const errorMsg = stack ? `${message}\n${stack}` : message;
+    reportCleanupFailed({ dedupKey: cleanupName, errorMsg }).catch((reportErr) => {
+        const reportMsg = reportErr instanceof Error ? reportErr.message : String(reportErr);
+        console.warn(`[CLEANUP REPORT FAILED] ${reportMsg}`);
+    });
+}
+//# sourceMappingURL=cleanupUtils.js.map

package/dist/cleanupUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cleanupUtils.js","sourceRoot":"","sources":["../src/cleanupUtils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,aAAa,GAAG,yCAAyC,CAAC;AAOhE;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,EACxC,QAAQ,EACR,QAAQ,MACqB,EAAE;IAC/B,MAAM,OAAO,GAAG;QACd,QAAQ;QACR,QAAQ;QACR,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,aAAa;QAChC,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,eAAe;QACpC,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,cAAc;QAClC,UAAU,EAAE,OAAO,CAAC,GAAG,CAAC,kBAAkB;KAC3C,CAAC;IAEF,IAAI,CAAC,OAAO,CAAC,KAAK;QAAE,OAAO;IAE3B,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,aAAa,EAAE;YAC1C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;YAC7B,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,MAAM,EAAE,MAAM;SACf,CAAC,CAAC;QAEH,IAAI,QAAQ,CAAC,EAAE;YAAE,OAAO,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QAE9C,MAAM,KAAK,CAAC,uBAAuB,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;IACxD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,GAAG,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACnE,MAAM,KAAK,CAAC,2BAA2B,GAAG,EAAE,CAAC,CAAC;IAChD,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAClC,WAAmB,EACnB,KAAc;IAEd,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvE,MAAM,KAAK,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;IAE/D,OAAO,CAAC,IAAI,CAAC,oBAAoB,WAAW,KAAK,OAAO,EAAE,CAAC,CAAC;IAC5D,IAAI,KAAK;QAAE,OAAO,CAAC,IAAI,CAAC,mBAAmB,KAAK,EAAE,CAAC,CAAC;IAEpD,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,OAAO,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;IAC1D,mBAAmB,CAAC,EAAE,QAAQ,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC,CAAC,KAAK,CAC5D,CAAC,SAAS,EAAE,EAAE;QACZ,MAAM,SAAS,GACb,SAAS,YAAY,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QACrE,OAAO,CAAC,IAAI,CAAC,2BAA2B,SAAS,EAAE,CAAC,CAAC;IACvD,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/entryPointPageObject.d.ts

@@ -0,0 +1,44 @@
+import type { Page } from "playwright";
+import { BasePageObject } from "./basePageObject.js";
+import type { PageSetupOptions } from "./pageHooks.js";
+export declare abstract class EntryPointPageObject extends BasePageObject {
+    protected static initializeBrowser(options?: InitializeBrowserOptions): Promise<Page>;
+    /**
+     * Navigate to a URL (defaults to DEFAULT_URL from .env). Accepts Playwright's
+     * `page.goto` options; `waitUntil: "domcontentloaded"` and `timeout: 60000`
+     * are the defaults, overridable per call.
+     */
+    goto(url?: string, options?: Parameters<Page["goto"]>[1]): Promise<void>;
+    /**
+     * Install all page hooks. Call before goto().
+     *
+     * Hook defs come from the page registry — every POM that overrode
+     * `popupHandlers()` or `routeInterceptors()` on its class contributes
+     * here, not just the entry point. See `pageHookCollection.ts` for the
+     * auto-detection mechanism.
+     */
+    protected installPageHooks(options?: PageSetupOptions): Promise<void>;
+}
+export type InitializeBrowserOptions = {
+    device?: BrowserDeviceOverride;
+    permissions?: string[];
+    proxy?: BrowserProxyConfig;
+    slowMo?: number;
+};
+type BrowserDeviceOverride = {
+    deviceScaleFactor?: number;
+    hasTouch?: boolean;
+    isMobile?: boolean;
+    userAgent?: string;
+    viewport?: {
+        height: number;
+        width: number;
+    };
+};
+type BrowserProxyConfig = {
+    password?: string;
+    server: string;
+    username?: string;
+};
+export {};
+//# sourceMappingURL=entryPointPageObject.d.ts.map

package/dist/entryPointPageObject.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entryPointPageObject.d.ts","sourceRoot":"","sources":["../src/entryPointPageObject.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAIvC,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAKrD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AA0CvD,8BAAsB,oBAAqB,SAAQ,cAAc;qBACxC,iBAAiB,CACtC,OAAO,GAAE,wBAA6B,GACrC,OAAO,CAAC,IAAI,CAAC;IAYhB;;;;OAIG;IACG,IAAI,CACR,GAAG,CAAC,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,GACpC,OAAO,CAAC,IAAI,CAAC;IAiBhB;;;;;;;OAOG;cACa,gBAAgB,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;CA6C5E;AAED,MAAM,MAAM,wBAAwB,GAAG;IACrC,MAAM,CAAC,EAAE,qBAAqB,CAAC;IAC/B,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,KAAK,CAAC,EAAE,kBAAkB,CAAC;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,KAAK,qBAAqB,GAAG;IAC3B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;CAC9C,CAAC;AAEF,KAAK,kBAAkB,GAAG;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC"}

package/dist/entryPointPageObject.js

@@ -0,0 +1,116 @@
+import { launch } from "@qawolf/flows/web";
+import { BasePageObject } from "./basePageObject.js";
+import { getRegisteredPopupHandlers, getRegisteredRouteInterceptors, } from "./pageHookCollection.js";
+import { buildPopupShieldInitScript } from "./popupShieldInitScript.js";
+/**
+ * Playwright applies HTTP auth when `httpCredentials` is set. Passing empty
+ * username/password (e.g. from unset env vars coerced with `?? ""`) breaks
+ * navigation on sites that do not expect preemptive auth — only include
+ * credentials when both `AUTH_USERNAME` and `AUTH_PASSWORD` are non-empty.
+ */
+function optionalHttpCredentialsFromEnv() {
+    const username = process.env.AUTH_USERNAME;
+    const password = process.env.AUTH_PASSWORD;
+    if (username && password)
+        return { httpCredentials: { password, username } };
+    return {};
+}
+function assertUniqueHookNames(groups, kind) {
+    const seen = new Map();
+    for (const { className, defs } of groups) {
+        for (const def of defs) {
+            const prev = seen.get(def.name);
+            if (prev !== undefined) {
+                if (prev === className) {
+                    throw Error(`Duplicate ${kind} hook name "${def.name}" defined twice on ${className}.`);
+                }
+                throw Error(`Duplicate ${kind} hook name "${def.name}" registered by both ${prev} and ${className}.`);
+            }
+            seen.set(def.name, className);
+        }
+    }
+}
+export class EntryPointPageObject extends BasePageObject {
+    static async initializeBrowser(options = {}) {
+        const launchResult = await launch({
+            ...options,
+            ...optionalHttpCredentialsFromEnv(),
+        });
+        if (!("browser" in launchResult))
+            throw Error("Expected a browser launch result for QAW platform context.");
+        return launchResult.context.newPage();
+    }
+    /**
+     * Navigate to a URL (defaults to DEFAULT_URL from .env). Accepts Playwright's
+     * `page.goto` options; `waitUntil: "domcontentloaded"` and `timeout: 60000`
+     * are the defaults, overridable per call.
+     */
+    async goto(url, options) {
+        const targetUrl = url || process.env.DEFAULT_URL;
+        if (!targetUrl) {
+            throw Error("No URL provided and no DEFAULT_URL environment variable is set");
+        }
+        await this.page.goto(targetUrl, {
+            timeout: 60000,
+            waitUntil: "domcontentloaded",
+            ...options,
+        });
+    }
+    // Concrete entry points define `static async create()` using `initializeBrowser`,
+    // `new this(page)`, and `installPageHooks`.
+    /**
+     * Install all page hooks. Call before goto().
+     *
+     * Hook defs come from the page registry — every POM that overrode
+     * `popupHandlers()` or `routeInterceptors()` on its class contributes
+     * here, not just the entry point. See `pageHookCollection.ts` for the
+     * auto-detection mechanism.
+     */
+    async installPageHooks(options) {
+        const skipPopups = new Set(options?.allowPopups);
+        const skipRoutes = new Set(options?.allowRoutes);
+        const popupGroups = await getRegisteredPopupHandlers(this.page);
+        const routeGroups = await getRegisteredRouteInterceptors(this.page);
+        assertUniqueHookNames(popupGroups, "popup");
+        assertUniqueHookNames(routeGroups, "route");
+        const popupDefs = popupGroups.flatMap((g) => g.defs);
+        const routeDefs = routeGroups.flatMap((g) => g.defs);
+        if (options?.handler) {
+            options.handler.install(this.page);
+            for (const def of popupDefs) {
+                if (skipPopups.has(def.name))
+                    continue;
+                await options.handler.add(def.name, def.trigger, def.dismiss);
+            }
+        }
+        else {
+            const cssSelectors = [];
+            for (const def of popupDefs) {
+                if (skipPopups.has(def.name))
+                    continue;
+                if (def.cssSelector)
+                    cssSelectors.push(def.cssSelector);
+                // A popup without a cssSelector cannot use the CSS-injection shield, so
+                // it falls back to addLocatorHandler. In default mode the shield is
+                // preferred because addLocatorHandler deadlocks when multiple overlays
+                // stack — each handler waits for the action pipeline, blocking all
+                // locator operations (evaluate, count, screenshot).
+                else {
+                    await this.page.addLocatorHandler(def.trigger, async () => {
+                        await def.dismiss();
+                    });
+                }
+            }
+            if (cssSelectors.length > 0)
+                await this.page.addInitScript(buildPopupShieldInitScript(cssSelectors));
+        }
+        for (const routeDef of routeDefs) {
+            if (skipRoutes.has(routeDef.name))
+                continue;
+            await this.page.route(routeDef.pattern, routeDef.handler);
+        }
+        if (options?.monitor)
+            options.monitor.install(this.page);
+    }
+}
+//# sourceMappingURL=entryPointPageObject.js.map

package/dist/entryPointPageObject.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entryPointPageObject.js","sourceRoot":"","sources":["../src/entryPointPageObject.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Map of page-object types keyed by the name passed to `registerPage`.
+ *
+ * Empty by default. A workspace opts into typed `this.create("ClassName")`
+ * by augmenting it from its generated `register-pages.ts`:
+ *
+ *   declare module "@qawolf/pom" {
+ *     interface RegisteredPages {
+ *       LoginPage: LoginPage;
+ *     }
+ *   }
+ *
+ * `this.create("LoginPage")` then returns `LoginPage` without a type
+ * annotation. Names missing from the map keep the untyped fallback, so the
+ * map can be adopted incrementally.
+ *
+ * The interface is declared here (in the package entry module, not in
+ * `pageRegistry.ts`) because TypeScript module augmentation only merges with
+ * interfaces declared directly in the augmented module — an augmentation of
+ * "@qawolf/pom" would not reach an interface that is merely re-exported.
+ */
+export interface RegisteredPages {
+}
+export { type BaselineScreenshotFn, BasePageObject } from "./basePageObject.js";
+export { type ReportCleanupFailedParams, reportCleanupFailed, reportCleanupFailure, } from "./cleanupUtils.js";
+export { type InitializeBrowserOptions, EntryPointPageObject, } from "./entryPointPageObject.js";
+export { type NetworkError, NetworkMonitor } from "./networkMonitor.js";
+export type { PageSetupOptions, PopupHandlerDef, RouteInterceptorDef, } from "./pageHooks.js";
+export { type PomModuleLoader, type RegisterPageOptions, createPage, registerPage, } from "./pageRegistry.js";
+export { callPlatformAPI } from "./platformClient.js";
+export { PopupHandler } from "./popupHandler.js";
+export type { SequencePromise } from "./sequence.js";
+export { SubPageObject } from "./subPageObject.js";
+export { assertPricesClose, moneyToNumber, numberToMoney, } from "./testDataUtilities.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,MAAM,WAAW,eAAe;CAAG;AAEnC,OAAO,EAAE,KAAK,oBAAoB,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAChF,OAAO,EACL,KAAK,yBAAyB,EAC9B,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,KAAK,wBAAwB,EAC7B,oBAAoB,GACrB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,KAAK,YAAY,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACxE,YAAY,EACV,gBAAgB,EAChB,eAAe,EACf,mBAAmB,GACpB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,UAAU,EACV,YAAY,GACb,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EACL,iBAAiB,EACjB,aAAa,EACb,aAAa,GACd,MAAM,wBAAwB,CAAC"}

package/dist/index.js

@@ -0,0 +1,10 @@
+export { BasePageObject } from "./basePageObject.js";
+export { reportCleanupFailed, reportCleanupFailure, } from "./cleanupUtils.js";
+export { EntryPointPageObject, } from "./entryPointPageObject.js";
+export { NetworkMonitor } from "./networkMonitor.js";
+export { createPage, registerPage, } from "./pageRegistry.js";
+export { callPlatformAPI } from "./platformClient.js";
+export { PopupHandler } from "./popupHandler.js";
+export { SubPageObject } from "./subPageObject.js";
+export { assertPricesClose, moneyToNumber, numberToMoney, } from "./testDataUtilities.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAwBA,OAAO,EAA6B,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAChF,OAAO,EAEL,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAEL,oBAAoB,GACrB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAqB,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAMxE,OAAO,EAGL,UAAU,EACV,YAAY,GACb,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EACL,iBAAiB,EACjB,aAAa,EACb,aAAa,GACd,MAAM,wBAAwB,CAAC"}

package/dist/networkMonitor.d.ts

@@ -0,0 +1,35 @@
+import type { Page } from "playwright";
+export type NetworkError = {
+    readonly method: string;
+    readonly resourceType: string;
+    readonly status: number;
+    readonly statusText: string;
+    readonly timestamp: number;
+    readonly url: string;
+};
+export declare class NetworkMonitor {
+    readonly name: string;
+    /** Only 4xx errors. */
+    get clientErrors(): readonly NetworkError[];
+    /** All recorded 4xx/5xx errors. */
+    get errors(): readonly NetworkError[];
+    /** Only 5xx errors. */
+    get serverErrors(): readonly NetworkError[];
+    private _errors;
+    private _page;
+    constructor(name: string);
+    /** Assert zero HTTP errors were recorded, with optional URL exclusions. */
+    assertClean(options?: {
+        exclude?: RegExp[];
+    }): void;
+    /** Assert zero 5xx errors were recorded, with optional URL exclusions. */
+    assertNoServerErrors(options?: {
+        exclude?: RegExp[];
+    }): void;
+    /** Bind to a page. Throws if already bound — one monitor per page. */
+    install(page: Page): void;
+    /** Reset collected errors (useful mid-flow if only a specific section matters). */
+    reset(): void;
+    private _filtered;
+}
+//# sourceMappingURL=networkMonitor.d.ts.map

package/dist/networkMonitor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"networkMonitor.d.ts","sourceRoot":"","sources":["../src/networkMonitor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAY,MAAM,YAAY,CAAC;AAIjD,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,qBAAa,cAAc;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,uBAAuB;IACvB,IAAI,YAAY,IAAI,SAAS,YAAY,EAAE,CAE1C;IACD,mCAAmC;IACnC,IAAI,MAAM,IAAI,SAAS,YAAY,EAAE,CAEpC;IAED,uBAAuB;IACvB,IAAI,YAAY,IAAI,SAAS,YAAY,EAAE,CAE1C;IAED,OAAO,CAAC,OAAO,CAAsB;IAErC,OAAO,CAAC,KAAK,CAA+B;gBAEhC,IAAI,EAAE,MAAM;IAIxB,2EAA2E;IAC3E,WAAW,CAAC,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,IAAI;IAWnD,0EAA0E;IAC1E,oBAAoB,CAAC,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,IAAI;IAa5D,sEAAsE;IACtE,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAyBzB,mFAAmF;IACnF,KAAK,IAAI,IAAI;IAIb,OAAO,CAAC,SAAS;CAIlB"}

package/dist/networkMonitor.js

@@ -0,0 +1,70 @@
+import { expect } from "@qawolf/flows/web";
+export class NetworkMonitor {
+    name;
+    /** Only 4xx errors. */
+    get clientErrors() {
+        return this._errors.filter((e) => e.status < 500);
+    }
+    /** All recorded 4xx/5xx errors. */
+    get errors() {
+        return [...this._errors];
+    }
+    /** Only 5xx errors. */
+    get serverErrors() {
+        return this._errors.filter((e) => e.status >= 500);
+    }
+    _errors = [];
+    _page = undefined;
+    constructor(name) {
+        this.name = name;
+    }
+    /** Assert zero HTTP errors were recorded, with optional URL exclusions. */
+    assertClean(options) {
+        const errors = this._filtered(options?.exclude);
+        expect(errors, `NetworkMonitor "${this.name}" recorded ${errors.length} HTTP error(s):\n` +
+            errors
+                .map((e) => `  ${e.method} ${e.status} ${e.statusText} ${e.url}`)
+                .join("\n")).toHaveLength(0);
+    }
+    /** Assert zero 5xx errors were recorded, with optional URL exclusions. */
+    assertNoServerErrors(options) {
+        const errors = this._filtered(options?.exclude).filter((e) => e.status >= 500);
+        expect(errors, `NetworkMonitor "${this.name}" recorded ${errors.length} server error(s):\n` +
+            errors
+                .map((e) => `  ${e.method} ${e.status} ${e.statusText} ${e.url}`)
+                .join("\n")).toHaveLength(0);
+    }
+    /** Bind to a page. Throws if already bound — one monitor per page. */
+    install(page) {
+        if (this._page) {
+            throw Error(`NetworkMonitor "${this.name}" is already tracking a page. ` +
+                `Each monitor tracks exactly one page handle. For multi-page ` +
+                `sessions, create a separate NetworkMonitor per page:\n\n` +
+                `  const main      = new NetworkMonitor("main");\n` +
+                `  const secondary = new NetworkMonitor("secondary");`);
+        }
+        this._page = page;
+        page.on("response", (response) => {
+            if (response.status() >= 400) {
+                this._errors.push({
+                    method: response.request().method(),
+                    resourceType: response.request().resourceType(),
+                    status: response.status(),
+                    statusText: response.statusText(),
+                    timestamp: Date.now(),
+                    url: response.url(),
+                });
+            }
+        });
+    }
+    /** Reset collected errors (useful mid-flow if only a specific section matters). */
+    reset() {
+        this._errors = [];
+    }
+    _filtered(exclude) {
+        if (!exclude?.length)
+            return [...this._errors];
+        return this._errors.filter((e) => !exclude.some((rx) => rx.test(e.url)));
+    }
+}
+//# sourceMappingURL=networkMonitor.js.map

package/dist/networkMonitor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"networkMonitor.js","sourceRoot":"","sources":["../src/networkMonitor.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAW3C,MAAM,OAAO,cAAc;IAChB,IAAI,CAAS;IACtB,uBAAuB;IACvB,IAAI,YAAY;QACd,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC;IACpD,CAAC;IACD,mCAAmC;IACnC,IAAI,MAAM;QACR,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC;IAC3B,CAAC;IAED,uBAAuB;IACvB,IAAI,YAAY;QACd,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,IAAI,GAAG,CAAC,CAAC;IACrD,CAAC;IAEO,OAAO,GAAmB,EAAE,CAAC;IAE7B,KAAK,GAAqB,SAAS,CAAC;IAE5C,YAAY,IAAY;QACtB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED,2EAA2E;IAC3E,WAAW,CAAC,OAAgC;QAC1C,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAChD,MAAM,CACJ,MAAM,EACN,mBAAmB,IAAI,CAAC,IAAI,cAAc,MAAM,CAAC,MAAM,mBAAmB;YACxE,MAAM;iBACH,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,GAAG,EAAE,CAAC;iBAChE,IAAI,CAAC,IAAI,CAAC,CAChB,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;IAED,0EAA0E;IAC1E,oBAAoB,CAAC,OAAgC;QACnD,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,MAAM,CACpD,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,IAAI,GAAG,CACvB,CAAC;QACF,MAAM,CACJ,MAAM,EACN,mBAAmB,IAAI,CAAC,IAAI,cAAc,MAAM,CAAC,MAAM,qBAAqB;YAC1E,MAAM;iBACH,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,GAAG,EAAE,CAAC;iBAChE,IAAI,CAAC,IAAI,CAAC,CAChB,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;IAED,sEAAsE;IACtE,OAAO,CAAC,IAAU;QAChB,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,MAAM,KAAK,CACT,mBAAmB,IAAI,CAAC,IAAI,gCAAgC;gBAC1D,8DAA8D;gBAC9D,0DAA0D;gBAC1D,mDAAmD;gBACnD,sDAAsD,CACzD,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,IAAI,CAAC,EAAE,CAAC,UAAU,EAAE,CAAC,QAAkB,EAAE,EAAE;YACzC,IAAI,QAAQ,CAAC,MAAM,EAAE,IAAI,GAAG,EAAE,CAAC;gBAC7B,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;oBAChB,MAAM,EAAE,QAAQ,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE;oBACnC,YAAY,EAAE,QAAQ,CAAC,OAAO,EAAE,CAAC,YAAY,EAAE;oBAC/C,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE;oBACzB,UAAU,EAAE,QAAQ,CAAC,UAAU,EAAE;oBACjC,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;oBACrB,GAAG,EAAE,QAAQ,CAAC,GAAG,EAAE;iBACpB,CAAC,CAAC;YACL,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAED,mFAAmF;IACnF,KAAK;QACH,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC;IACpB,CAAC;IAEO,SAAS,CAAC,OAAkB;QAClC,IAAI,CAAC,OAAO,EAAE,MAAM;YAAE,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC;QAC/C,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAC3E,CAAC;CACF"}

package/dist/pageHookCollection.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Page-hook collection — reads `popupHandlers()` / `routeInterceptors()` defs
+ * off every registered POM for `EntryPointPageObject.installPageHooks`.
+ *
+ * Hook defs can only be read off a loaded class, so this loads every lazy
+ * registry entry except those registered `{ providesPageHooks: false }`.
+ * Overrides are detected via `Object.hasOwn(cls.prototype, ...)`, so only
+ * classes that directly declare the override are picked up.
+ */
+import type { Page } from "playwright";
+import type { PopupHandlerDef, RouteInterceptorDef } from "./pageHooks.js";
+export declare function getRegisteredPopupHandlers(page: Page): Promise<{
+    className: string;
+    defs: PopupHandlerDef[];
+}[]>;
+export declare function getRegisteredRouteInterceptors(page: Page): Promise<{
+    className: string;
+    defs: RouteInterceptorDef[];
+}[]>;
+//# sourceMappingURL=pageHookCollection.d.ts.map