@thinkwise/testwise 0.2.67 → 0.2.103

package/dist/controls/LookupDropdown.js

@@ -52,6 +52,14 @@ class LookupDropdown {
             .waitForFunction((el) => document.activeElement === el, await this._objects.input().elementHandle());
     }
 }
+/**
+ * Creates an `ILookupDropdown` proxy that intercepts named `LookupDropdown` methods from
+ * the class prototype and falls back to the base `Locator` for everything else, effectively
+ * merging the typed dropdown interface with standard Playwright locator capabilities.
+ * @param context - The parent locator to scope the control within.
+ * @param id - The field identifier used to build the scoped locator.
+ * @returns A proxy combining `ILookupDropdownCore` methods and `Locator` capabilities.
+ */
 export function createLookupDropdown(context, id) {
     const dropdown = new LookupDropdown(context, id);
     const customProps = new Set(Object.getOwnPropertyNames(LookupDropdown.prototype).filter((p) => p !== 'constructor'));

package/dist/controls/LookupDropdown.js.map

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

package/dist/enums/ElementTypes.d.ts

@@ -1,3 +1,21 @@
+/**
+ * Maps Thinkwise model control type identifiers to their string values.
+ *
+ * The artifact pipeline reads `control_type` values from the Indicium API
+ * (via `IProperty.control_type`) and uses these enum members to decide which
+ * Testwise control class to generate for each field or column.
+ *
+ * | Enum member | Generated control |
+ * |---|---|
+ * | `Field` | `InputFieldControl` |
+ * | `Dropdown` | `LookupDropdown` (drop-down variant) |
+ * | `Textarea` | `InputFieldControl` (multi-line) |
+ * | `Checkbox` | `InputFieldControl` (checkbox) |
+ * | `Lookup` | `LookupDropdown` |
+ * | `Column` | `GridColumnControl` |
+ * | `ComboBox` | `FormComboBox` |
+ * | `DatePicker` | `DateControl` |
+ */
 export declare enum KnownElementTypes {
     Field = "field",
     Dropdown = "dropdown",

package/dist/enums/ElementTypes.js

@@ -1,3 +1,21 @@
+/**
+ * Maps Thinkwise model control type identifiers to their string values.
+ *
+ * The artifact pipeline reads `control_type` values from the Indicium API
+ * (via `IProperty.control_type`) and uses these enum members to decide which
+ * Testwise control class to generate for each field or column.
+ *
+ * | Enum member | Generated control |
+ * |---|---|
+ * | `Field` | `InputFieldControl` |
+ * | `Dropdown` | `LookupDropdown` (drop-down variant) |
+ * | `Textarea` | `InputFieldControl` (multi-line) |
+ * | `Checkbox` | `InputFieldControl` (checkbox) |
+ * | `Lookup` | `LookupDropdown` |
+ * | `Column` | `GridColumnControl` |
+ * | `ComboBox` | `FormComboBox` |
+ * | `DatePicker` | `DateControl` |
+ */
 export var KnownElementTypes;
 (function (KnownElementTypes) {
     KnownElementTypes["Field"] = "field";

package/dist/enums/ElementTypes.js.map

@@ -1 +1 @@
-{"version":3,"file":"ElementTypes.js","sourceRoot":"","sources":["../../enums/ElementTypes.ts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAY,iBASX;AATD,WAAY,iBAAiB;IAC3B,oCAAe,CAAA;IACf,0CAAqB,CAAA;IACrB,0CAAqB,CAAA;IACrB,0CAAqB,CAAA;IACrB,sCAAiB,CAAA;IACjB,sCAAiB,CAAA;IACjB,2CAAsB,CAAA;IACtB,+CAA0B,CAAA;AAC5B,CAAC,EATW,iBAAiB,KAAjB,iBAAiB,QAS5B"}
+{"version":3,"file":"ElementTypes.js","sourceRoot":"","sources":["../../enums/ElementTypes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAN,IAAY,iBASX;AATD,WAAY,iBAAiB;IAC3B,oCAAe,CAAA;IACf,0CAAqB,CAAA;IACrB,0CAAqB,CAAA;IACrB,0CAAqB,CAAA;IACrB,sCAAiB,CAAA;IACjB,sCAAiB,CAAA;IACjB,2CAAsB,CAAA;IACtB,+CAA0B,CAAA;AAC5B,CAAC,EATW,iBAAiB,KAAjB,iBAAiB,QAS5B"}

package/dist/enums/ExportFormat.d.ts

@@ -1,3 +1,11 @@
+/**
+ * Supported file formats for the `ExportComponent` export action.
+ * Pass one of these values to `ExportComponent.export(format)` to trigger
+ * a grid or list export in the desired format (CSV, XLSX, or XLS).
+ *
+ * @example
+ * await page.components.export.export(ExportFormat.XLSX);
+ */
 export declare enum ExportFormat {
     CSV = "csv",
     XLSX = "xlsx",

package/dist/enums/ExportFormat.js

@@ -1,3 +1,11 @@
+/**
+ * Supported file formats for the `ExportComponent` export action.
+ * Pass one of these values to `ExportComponent.export(format)` to trigger
+ * a grid or list export in the desired format (CSV, XLSX, or XLS).
+ *
+ * @example
+ * await page.components.export.export(ExportFormat.XLSX);
+ */
 export var ExportFormat;
 (function (ExportFormat) {
     ExportFormat["CSV"] = "csv";

package/dist/enums/ExportFormat.js.map

@@ -1 +1 @@
-{"version":3,"file":"ExportFormat.js","sourceRoot":"","sources":["../../enums/ExportFormat.ts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAY,YAIX;AAJD,WAAY,YAAY;IACtB,2BAAW,CAAA;IACX,6BAAa,CAAA;IACb,2BAAW,CAAA;AACb,CAAC,EAJW,YAAY,KAAZ,YAAY,QAIvB"}
+{"version":3,"file":"ExportFormat.js","sourceRoot":"","sources":["../../enums/ExportFormat.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,CAAN,IAAY,YAIX;AAJD,WAAY,YAAY;IACtB,2BAAW,CAAA;IACX,6BAAa,CAAA;IACb,2BAAW,CAAA;AACb,CAAC,EAJW,YAAY,KAAZ,YAAY,QAIvB"}

package/dist/enums/LogLevel.d.ts

@@ -1,7 +1,24 @@
+/**
+ * Controls how much output the Testwise `Logger` writes, both to the log file
+ * and (optionally) to the console.
+ *
+ * Levels are cumulative — choosing `WARN` includes `ERROR`; choosing `DEBUG`
+ * includes `ERROR`, `WARN`, and `INFO`.
+ *
+ * Configure via `Testwise.json`:
+ * ```json
+ * { "featureSettings": { "logger": { "logLevel": "INFO" } } }
+ * ```
+ */
 export declare enum LogLevel {
+    /** Only critical failures. Use in CI environments where log noise must be minimal. */
     ERROR = "ERROR",
+    /** Errors and recoverable warnings. Good default for most pipelines. */
     WARN = "WARN",
+    /** Errors, warnings, and informational messages about what the test is doing. Recommended for local development. */
     INFO = "INFO",
+    /** Full verbose output including internal state changes. Use when diagnosing hard-to-reproduce failures. */
     DEBUG = "DEBUG",
+    /** Everything. Includes low-level log entries that are normally filtered out. */
     ALL = "ALL"
 }

package/dist/enums/LogLevel.js

@@ -1,10 +1,26 @@
+/**
+ * Controls how much output the Testwise `Logger` writes, both to the log file
+ * and (optionally) to the console.
+ *
+ * Levels are cumulative — choosing `WARN` includes `ERROR`; choosing `DEBUG`
+ * includes `ERROR`, `WARN`, and `INFO`.
+ *
+ * Configure via `Testwise.json`:
+ * ```json
+ * { "featureSettings": { "logger": { "logLevel": "INFO" } } }
+ * ```
+ */
 export var LogLevel;
 (function (LogLevel) {
-    // Order by severity
+    /** Only critical failures. Use in CI environments where log noise must be minimal. */
     LogLevel["ERROR"] = "ERROR";
+    /** Errors and recoverable warnings. Good default for most pipelines. */
     LogLevel["WARN"] = "WARN";
+    /** Errors, warnings, and informational messages about what the test is doing. Recommended for local development. */
     LogLevel["INFO"] = "INFO";
+    /** Full verbose output including internal state changes. Use when diagnosing hard-to-reproduce failures. */
     LogLevel["DEBUG"] = "DEBUG";
+    /** Everything. Includes low-level log entries that are normally filtered out. */
     LogLevel["ALL"] = "ALL";
 })(LogLevel || (LogLevel = {}));
 //# sourceMappingURL=LogLevel.js.map

package/dist/enums/LogLevel.js.map

@@ -1 +1 @@
-{"version":3,"file":"LogLevel.js","sourceRoot":"","sources":["../../enums/LogLevel.ts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAY,QAOX;AAPD,WAAY,QAAQ;IAClB,oBAAoB;IACpB,2BAAe,CAAA;IACf,yBAAa,CAAA;IACb,yBAAa,CAAA;IACb,2BAAe,CAAA;IACf,uBAAW,CAAA;AACb,CAAC,EAPW,QAAQ,KAAR,QAAQ,QAOnB"}
+{"version":3,"file":"LogLevel.js","sourceRoot":"","sources":["../../enums/LogLevel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,MAAM,CAAN,IAAY,QAWX;AAXD,WAAY,QAAQ;IAClB,sFAAsF;IACtF,2BAAe,CAAA;IACf,wEAAwE;IACxE,yBAAa,CAAA;IACb,oHAAoH;IACpH,yBAAa,CAAA;IACb,4GAA4G;IAC5G,2BAAe,CAAA;IACf,iFAAiF;IACjF,uBAAW,CAAA;AACb,CAAC,EAXW,QAAQ,KAAR,QAAQ,QAWnB"}

package/dist/enums/index.d.ts

@@ -1 +1,2 @@
 export * from './ExportFormat.js';
+export * from './LogLevel.js';

package/dist/enums/index.js

@@ -1,2 +1,3 @@
 export * from './ExportFormat.js';
+export * from './LogLevel.js';
 //# sourceMappingURL=index.js.map

package/dist/enums/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../enums/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../enums/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC"}

package/dist/helpers/ConfigChecker.d.ts

@@ -1,3 +1,16 @@
+/**
+ * Verifies that the consuming project's Testwise configuration is valid and
+ * reachable before the artifact pipeline is allowed to run.
+ *
+ * **Why this exists:** The artifact-builder fetches live model data from the
+ * Thinkwise Indicium API. If the API URL or credentials in `Testwise.json`
+ * are wrong, the pipeline fails mid-way with a cryptic network error.
+ * `ConfigChecker` performs a lightweight connectivity probe upfront so the
+ * pipeline can give a clear "cannot connect" error message instead.
+ *
+ * **When it is called:** Automatically by `ArtifactManager` at the start of
+ * every `testwise sync` run. You do not need to call it manually.
+ */
 export declare class ConfigChecker {
     hasValidModelBuilderConfig(): Promise<boolean>;
 }

package/dist/helpers/ConfigChecker.js

@@ -1,4 +1,17 @@
 import { indiciumApi } from '../services/IndiciumApi.service.js';
+/**
+ * Verifies that the consuming project's Testwise configuration is valid and
+ * reachable before the artifact pipeline is allowed to run.
+ *
+ * **Why this exists:** The artifact-builder fetches live model data from the
+ * Thinkwise Indicium API. If the API URL or credentials in `Testwise.json`
+ * are wrong, the pipeline fails mid-way with a cryptic network error.
+ * `ConfigChecker` performs a lightweight connectivity probe upfront so the
+ * pipeline can give a clear "cannot connect" error message instead.
+ *
+ * **When it is called:** Automatically by `ArtifactManager` at the start of
+ * every `testwise sync` run. You do not need to call it manually.
+ */
 export class ConfigChecker {
     async hasValidModelBuilderConfig() {
         return await indiciumApi.canConnectToProject();

package/dist/helpers/ConfigChecker.js.map

@@ -1 +1 @@
-{"version":3,"file":"ConfigChecker.js","sourceRoot":"","sources":["../../helpers/ConfigChecker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAC;AAEjE,MAAM,OAAO,aAAa;IACjB,KAAK,CAAC,0BAA0B;QACrC,OAAO,MAAM,WAAW,CAAC,mBAAmB,EAAE,CAAC;IACjD,CAAC;CACF"}
+{"version":3,"file":"ConfigChecker.js","sourceRoot":"","sources":["../../helpers/ConfigChecker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAC;AAEjE;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,aAAa;IACjB,KAAK,CAAC,0BAA0B;QACrC,OAAO,MAAM,WAAW,CAAC,mBAAmB,EAAE,CAAC;IACjD,CAAC;CACF"}

package/dist/helpers/Ensure.d.ts

@@ -1,2 +1,15 @@
+/**
+ * Asserts that `condition` is truthy, acting as a TypeScript assertion function.
+ * Throws an `Error` with the given message if the condition is falsy.
+ * @param condition - The value to assert.
+ * @param message - Optional error message (default `'Check failed'`).
+ */
 export declare function ensure(condition: unknown, message?: string): asserts condition;
+/**
+ * Asserts strict equality between `actual` and `expected`.
+ * Throws a descriptive `Error` (optionally prefixed by `label`) if they differ.
+ * @param actual - The value produced.
+ * @param expected - The value expected.
+ * @param label - Optional prefix for the error message.
+ */
 export declare function ensureEqual<T>(actual: T, expected: T, label?: string): void;

package/dist/helpers/Ensure.js

@@ -1,7 +1,20 @@
+/**
+ * Asserts that `condition` is truthy, acting as a TypeScript assertion function.
+ * Throws an `Error` with the given message if the condition is falsy.
+ * @param condition - The value to assert.
+ * @param message - Optional error message (default `'Check failed'`).
+ */
 export function ensure(condition, message = 'Check failed') {
     if (!condition)
         throw new Error(message);
 }
+/**
+ * Asserts strict equality between `actual` and `expected`.
+ * Throws a descriptive `Error` (optionally prefixed by `label`) if they differ.
+ * @param actual - The value produced.
+ * @param expected - The value expected.
+ * @param label - Optional prefix for the error message.
+ */
 export function ensureEqual(actual, expected, label) {
     if (actual !== expected) {
         throw new Error(label ? `${label}: expected ${expected}, got ${actual}` : `expected ${expected}, got ${actual}`);

package/dist/helpers/Ensure.js.map

@@ -1 +1 @@
-{"version":3,"file":"Ensure.js","sourceRoot":"","sources":["../../helpers/Ensure.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,MAAM,CAAC,SAAkB,EAAE,OAAO,GAAG,cAAc;IACjE,IAAI,CAAC,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,WAAW,CAAI,MAAS,EAAE,QAAW,EAAE,KAAc;IACnE,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,cAAc,QAAQ,SAAS,MAAM,EAAE,CAAC,CAAC,CAAC,YAAY,QAAQ,SAAS,MAAM,EAAE,CAAC,CAAC;IACnH,CAAC;AACH,CAAC"}
+{"version":3,"file":"Ensure.js","sourceRoot":"","sources":["../../helpers/Ensure.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,UAAU,MAAM,CAAC,SAAkB,EAAE,OAAO,GAAG,cAAc;IACjE,IAAI,CAAC,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC;AAC3C,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CAAI,MAAS,EAAE,QAAW,EAAE,KAAc;IACnE,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,cAAc,QAAQ,SAAS,MAAM,EAAE,CAAC,CAAC,CAAC,YAAY,QAAQ,SAAS,MAAM,EAAE,CAAC,CAAC;IACnH,CAAC;AACH,CAAC"}

package/dist/helpers/FlightTracker.d.ts

@@ -4,10 +4,20 @@ export declare class FlightTracker {
     private activeRequests;
     eventEmitter: EventEmitter;
     /**
-     * Filters out non-functional "noise" requests that shouldn't block test execution.
+     * Returns true for XHR requests that should block test execution.
+     * Filters out non-XHR traffic and known noise endpoints.
      */
-    isEssentialRequest(url: string): boolean;
-    handleRequestStarted: (url: string) => void;
+    isEssentialRequest(url: string, resourceType: string): boolean;
+    handleRequestStarted: (url: string, resourceType: string) => void;
+    reset: () => void;
+    handleRequestFailed: (url: string) => void;
     handleRequestFinished: (url: string) => void;
     waitToContinue: () => Promise<void>;
+    /**
+     * For use after hash-based SPA navigation. Waits for the SPA to begin firing
+     * XHR requests (within `spaStartupTimeout`), then waits for all of them to
+     * settle. If no requests appear within the startup window the page is
+     * considered already loaded.
+     */
+    waitForNavigationToSettle: (spaStartupTimeout?: number) => Promise<void>;
 }

package/dist/helpers/FlightTracker.js

@@ -1,22 +1,76 @@
 import { EventEmitter } from 'node:events';
 import { testwiseConfig } from '../services/ConfigBuilder.js';
-const timeout = testwiseConfig().get('featureSettings.InflightRequests.waitTimeout') ?? 5000;
+/**
+ * Tracks in-flight XHR requests made by the Thinkwise application and blocks
+ * test execution until the network has been idle for a short stability window.
+ *
+ * **Why this exists:** The Thinkwise Platform performs fire-and-forget XHR calls
+ * for things like navigation, saves, and data loads. Raw Playwright `waitFor*`
+ * helpers don't know about these — tests that proceed too early will act on
+ * stale data or a half-rendered screen. `FlightTracker` listens to every
+ * request/response cycle and exposes `waitToContinue()` which returns only
+ * once all tracked requests have finished AND the page has been quiet for at
+ * least `stabilityTime` milliseconds.
+ *
+ * **How to use it in tests:** You don't — it is wired up automatically inside
+ * `SubjectNavigator.navigateTo()`, `ClickOverride`, and `FillOverride`. You
+ * only need to know it exists if you are writing a new page-extension or
+ * override that performs navigation.
+ *
+ * @example
+ * // Inside a page-override or page-extension:
+ * const tracker = new FlightTracker();
+ * page.on('request',  req  => tracker.handleRequestStarted(req.url(), req.resourceType()));
+ * page.on('response', res  => tracker.handleRequestFinished(res.request().url()));
+ * await myAction();
+ * await tracker.waitToContinue();
+ */
+const minTimeout = 30000;
+const timeout = Math.max(testwiseConfig().get('featureSettings.InflightRequests.waitTimeout') ?? 0, minTimeout);
 const stabilityTime = 150;
 export class FlightTracker {
     constructor() {
         this.requestsInFlight = 0;
-        this.activeRequests = new Set();
+        this.activeRequests = new Map();
         this.eventEmitter = new EventEmitter();
-        this.handleRequestStarted = (url) => {
-            if (this.isEssentialRequest(url)) {
-                this.activeRequests.add(url);
-                this.requestsInFlight = this.activeRequests.size;
+        this.handleRequestStarted = (url, resourceType) => {
+            if (this.isEssentialRequest(url, resourceType)) {
+                const wasIdle = this.activeRequests.size === 0;
+                this.activeRequests.set(url, (this.activeRequests.get(url) ?? 0) + 1);
+                this.requestsInFlight++;
+                if (wasIdle)
+                    this.eventEmitter.emit('active');
+            }
+        };
+        this.reset = () => {
+            this.activeRequests.clear();
+            this.requestsInFlight = 0;
+        };
+        this.handleRequestFailed = (url) => {
+            const count = this.activeRequests.get(url);
+            if (count !== undefined) {
+                if (count <= 1) {
+                    this.activeRequests.delete(url);
+                }
+                else {
+                    this.activeRequests.set(url, count - 1);
+                }
+                this.requestsInFlight = Math.max(0, this.requestsInFlight - 1);
+                if (this.requestsInFlight === 0) {
+                    this.eventEmitter.emit('idle');
+                }
             }
         };
         this.handleRequestFinished = (url) => {
-            if (this.isEssentialRequest(url)) {
-                this.activeRequests.delete(url);
-                this.requestsInFlight = this.activeRequests.size;
+            const count = this.activeRequests.get(url);
+            if (count !== undefined) {
+                if (count <= 1) {
+                    this.activeRequests.delete(url);
+                }
+                else {
+                    this.activeRequests.set(url, count - 1);
+                }
+                this.requestsInFlight = Math.max(0, this.requestsInFlight - 1);
                 if (this.requestsInFlight === 0) {
                     this.eventEmitter.emit('idle');
                 }
@@ -42,10 +96,12 @@ export class FlightTracker {
                 };
                 this.eventEmitter.on('idle', checkIdle);
             });
-            const timeoutPromise = new Promise((_, reject) => {
+            const timeoutPromise = new Promise((resolve) => {
                 timeoutId = setTimeout(() => {
-                    const pending = Array.from(this.activeRequests).join('\n -> ');
-                    reject(new Error(`Timeout waiting for ${this.requestsInFlight} requests to complete (${timeout}ms).\nPending Essential Requests:\n -> ${pending}`));
+                    const pending = Array.from(this.activeRequests.keys()).join('\n -> ');
+                    console.warn(`FlightTracker: timed out after ${timeout}ms waiting for ${this.requestsInFlight} request(s) to complete.\nPending Essential Requests:\n -> ${pending}\nContinuing test execution.`);
+                    this.reset();
+                    resolve();
                 }, timeout);
             });
             try {
@@ -58,15 +114,45 @@ export class FlightTracker {
                 this.eventEmitter.removeAllListeners('idle');
             }
         };
+        /**
+         * For use after hash-based SPA navigation. Waits for the SPA to begin firing
+         * XHR requests (within `spaStartupTimeout`), then waits for all of them to
+         * settle. If no requests appear within the startup window the page is
+         * considered already loaded.
+         */
+        this.waitForNavigationToSettle = async (spaStartupTimeout = 3000) => {
+            if (this.requestsInFlight > 0) {
+                return this.waitToContinue();
+            }
+            await new Promise((resolve) => {
+                const timer = setTimeout(() => {
+                    this.eventEmitter.off('active', onActive);
+                    resolve();
+                }, spaStartupTimeout);
+                const onActive = () => {
+                    clearTimeout(timer);
+                    resolve();
+                };
+                this.eventEmitter.once('active', onActive);
+            });
+            if (this.requestsInFlight > 0) {
+                await this.waitToContinue();
+            }
+        };
     }
     /**
-     * Filters out non-functional "noise" requests that shouldn't block test execution.
+     * Returns true for XHR requests that should block test execution.
+     * Filters out non-XHR traffic and known noise endpoints.
      */
-    isEssentialRequest(url) {
+    isEssentialRequest(url, resourceType) {
+        if (resourceType !== 'xhr')
+            return false;
         const noisePatterns = [
-            '.download_icon',
-            '.download_list_bar_grp_icon',
-            '.download_form_next_grp_icon',
+            '/detect_change(',
+            '/set_gui_start_use_log_session',
+            'download_icon',
+            'download_list_bar_grp_icon',
+            'download_form_next_grp_icon',
             '/badge()',
             'universal_background_picture',
             'i_ui_theme'

package/dist/helpers/FlightTracker.js.map

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

package/dist/helpers/GlobalWaitEventHandler.d.ts

@@ -1,4 +1,17 @@
 import type { Page } from '@playwright/test';
+/**
+ * Waits for a specific response URL pattern before allowing test execution
+ * to continue. Used when you need to block until a known async API response
+ * has arrived, as opposed to waiting for XHR idle (which `FlightTracker` does).
+ *
+ * Attached to the page as `page.waitEventHandler` by the `WaitEventHandler`
+ * page extension. Call `page.waitEventHandler.waitForUrl(pattern)` to block
+ * until a response matching that URL has been received.
+ *
+ * @example
+ * // Wait for a specific background endpoint before asserting:
+ * await page.waitEventHandler.waitForUrl('/api/employees/load');
+ */
 export declare class GlobalWaitEventHandler {
     private _canContinue;
     private _eventEmitter;

package/dist/helpers/GlobalWaitEventHandler.js

@@ -1,5 +1,18 @@
 import { EventEmitter } from 'node:events';
 import { testwiseConfig } from '../services/ConfigBuilder.js';
+/**
+ * Waits for a specific response URL pattern before allowing test execution
+ * to continue. Used when you need to block until a known async API response
+ * has arrived, as opposed to waiting for XHR idle (which `FlightTracker` does).
+ *
+ * Attached to the page as `page.waitEventHandler` by the `WaitEventHandler`
+ * page extension. Call `page.waitEventHandler.waitForUrl(pattern)` to block
+ * until a response matching that URL has been received.
+ *
+ * @example
+ * // Wait for a specific background endpoint before asserting:
+ * await page.waitEventHandler.waitForUrl('/api/employees/load');
+ */
 export class GlobalWaitEventHandler {
     constructor(page) {
         this._canContinue = true;

package/dist/helpers/GlobalWaitEventHandler.js.map

@@ -1 +1 @@
-{"version":3,"file":"GlobalWaitEventHandler.js","sourceRoot":"","sources":["../../helpers/GlobalWaitEventHandler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAE9D,MAAM,OAAO,sBAAsB;IAMjC,YAAY,IAAU;QALd,iBAAY,GAAY,IAAI,CAAC;QAC7B,kBAAa,GAAiB,IAAI,YAAY,EAAE,CAAC;QAEjD,aAAQ,GAAG,cAAc,EAAE,CAAC,GAAG,CAAS,8CAA8C,CAAC,IAAI,IAAI,CAAC;QAGtG,IAAI,CAAC,aAAa,CAAC,EAAE,CAAC,UAAU,EAAE,GAAG,EAAE;YACrC,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;QAC3B,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;IACpB,CAAC;IAEO,WAAW,CAAC,OAAsB,EAAE,OAAe;QACzD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;YAC7B,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE;gBAC9B,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBACtB,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;gBACpC,OAAO,EAAE,CAAC;YACZ,CAAC,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;YAElB,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC7D,CAAC,CAAC,CAAC;IACL,CAAC;IAEM,eAAe,CAAC,GAAW;QAChC,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC;QAE1B,MAAM,eAAe,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YACpD,MAAM,QAAQ,GAAG,CAAC,MAAgB,EAAE,EAAE;gBACpC,IAAI,MAAM,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;oBAC/B,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;oBACrC,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;oBACzB,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;oBACpC,OAAO,EAAE,CAAC;gBACZ,CAAC;YACH,CAAC,CAAC;YACF,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;QACtC,CAAC,CAAC,CAAC;QAEH,OAAO,IAAI,CAAC,WAAW,CAAC,eAAe,EAAE,gEAAgE,CAAC,CAAC;IAC7G,CAAC;IAEM,kBAAkB;QACvB,IAAI,IAAI,CAAC,YAAY;YAAE,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;QAEhD,MAAM,eAAe,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YACpD,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QAC/C,CAAC,CAAC,CAAC;QAEH,OAAO,IAAI,CAAC,WAAW,CAAC,eAAe,EAAE,gEAAgE,CAAC,CAAC;IAC7G,CAAC;IAEM,cAAc,CAAC,KAAc;QAClC,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC;QAE1B,IAAI,KAAK,EAAE,CAAC;YACV,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACtC,CAAC;IACH,CAAC;CACF"}
+{"version":3,"file":"GlobalWaitEventHandler.js","sourceRoot":"","sources":["../../helpers/GlobalWaitEventHandler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAE9D;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,sBAAsB;IAMjC,YAAY,IAAU;QALd,iBAAY,GAAY,IAAI,CAAC;QAC7B,kBAAa,GAAiB,IAAI,YAAY,EAAE,CAAC;QAEjD,aAAQ,GAAG,cAAc,EAAE,CAAC,GAAG,CAAS,8CAA8C,CAAC,IAAI,IAAI,CAAC;QAGtG,IAAI,CAAC,aAAa,CAAC,EAAE,CAAC,UAAU,EAAE,GAAG,EAAE;YACrC,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;QAC3B,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;IACpB,CAAC;IAEO,WAAW,CAAC,OAAsB,EAAE,OAAe;QACzD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;YAC7B,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE;gBAC9B,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBACtB,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;gBACpC,OAAO,EAAE,CAAC;YACZ,CAAC,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;YAElB,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC7D,CAAC,CAAC,CAAC;IACL,CAAC;IAEM,eAAe,CAAC,GAAW;QAChC,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC;QAE1B,MAAM,eAAe,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YACpD,MAAM,QAAQ,GAAG,CAAC,MAAgB,EAAE,EAAE;gBACpC,IAAI,MAAM,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;oBAC/B,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;oBACrC,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;oBACzB,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;oBACpC,OAAO,EAAE,CAAC;gBACZ,CAAC;YACH,CAAC,CAAC;YACF,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;QACtC,CAAC,CAAC,CAAC;QAEH,OAAO,IAAI,CAAC,WAAW,CAAC,eAAe,EAAE,gEAAgE,CAAC,CAAC;IAC7G,CAAC;IAEM,kBAAkB;QACvB,IAAI,IAAI,CAAC,YAAY;YAAE,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;QAEhD,MAAM,eAAe,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YACpD,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QAC/C,CAAC,CAAC,CAAC;QAEH,OAAO,IAAI,CAAC,WAAW,CAAC,eAAe,EAAE,gEAAgE,CAAC,CAAC;IAC7G,CAAC;IAEM,cAAc,CAAC,KAAc;QAClC,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC;QAE1B,IAAI,KAAK,EAAE,CAAC;YACV,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACtC,CAAC;IACH,CAAC;CACF"}

package/dist/helpers/LoginHelper.d.ts

@@ -1,5 +1,17 @@
 import type { APIResponse, Page } from '@playwright/test';
 import type { UniversalLoginOptions } from '../types/index.js';
+/**
+ * Handles authentication against the Thinkwise Indicium API and the
+ * web application login screen.
+ *
+ * Exposed on the page fixture via `LoginFeatures` as `page.logIn()`,
+ * `page.logInWithCredentials()`, `page.logInWithOptions()`, and `page.logOut()`.
+ * You do not instantiate `LoginHelper` directly in tests.
+ *
+ * Credentials are read from `Testwise.json` (`environmentSettings.username`
+ * and `environmentSettings.password`) by default, and can be overridden
+ * per-call via `logInWithCredentials()` or `logInWithOptions()`.
+ */
 export declare class LoginHelper {
     private _page;
     protected serviceUrl: string;
@@ -22,7 +34,7 @@ export declare class LoginHelper {
      */
     logInWithOptions(options: UniversalLoginOptions): Promise<void>;
     /**
-     * Navigate to the home page and wait for the menu to load
+     * Navigate to the home page and wait for the menu to load.
      */
     private navigateHomeAndWaitForMenuToLoad;
     /**
@@ -35,13 +47,35 @@ export declare class LoginHelper {
      * @param options - The configuration options
      */
     private configureApplication;
+    /**
+     * Logs out the current session by POSTing to the logout endpoint (accepts 204 or 401
+     * as valid responses), then clears all browser cookies.
+     */
     logOut(): Promise<void>;
 }
 export declare class UserPreferences {
     private _page;
     readonly guiApplAlias: string;
     readonly url: string;
+    /**
+     * Initialises the `UserPreferences` service, resolving the service URL, meta endpoint,
+     * and GUI application alias from config (overridable via optional parameters) and
+     * constructing the full Indicium endpoint URL.
+     * @param requestContext - The Playwright `Page` used to make API requests.
+     * @param serviceUrl - Optional override for the service URL from config.
+     * @param metaEndpoint - Optional override for the meta endpoint from config.
+     */
     constructor(requestContext: Page, serviceUrl?: string, metaEndpoint?: string);
+    /**
+     * Activates a specific user preference configuration for the current session by POSTing
+     * to the `set_up_configuration` endpoint with the given configuration ID.
+     * @param upConfigurationId - The ID of the user preference configuration to activate.
+     */
     run(upConfigurationId: number): Promise<void>;
+    /**
+     * Disables all active user preferences for the current session by POSTing to the
+     * `disable_up` endpoint.
+     * @returns The raw Playwright `APIResponse`.
+     */
     disable(): Promise<APIResponse>;
 }