@thinkwise/testwise 0.2.62 → 0.2.99

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>;
 }

package/dist/helpers/LoginHelper.js

@@ -5,10 +5,22 @@ import { testwiseConfig } from '../services/ConfigBuilder.js';
 import { pollUntil } from './Poll.js';
 const dirname = path.dirname(fileURLToPath(import.meta.url));
 const configFixture = JSON.parse(fs.readFileSync(path.resolve(dirname, '../../config.json'), 'utf-8'));
+/**
+ * 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 class LoginHelper {
     constructor(page) {
-        this.serviceUrl = String(testwiseConfig().get('environmentSettings.serviceUrl'));
-        this.metaEndpoint = String(testwiseConfig().get('environmentSettings.metaEndpoint'));
+        this.serviceUrl = String(testwiseConfig().get('environmentSettings.serviceUrl')).replace(/\/+$/, '');
+        this.metaEndpoint = String(testwiseConfig().get('environmentSettings.metaEndpoint')).replace(/\/+$/, '');
         if (!this.serviceUrl || this.serviceUrl === 'undefined')
             throw new Error('Service URL not found');
         if (!this.metaEndpoint || this.metaEndpoint === 'undefined')
@@ -46,18 +58,19 @@ export class LoginHelper {
         await this.logInAndConfigureApplication(options);
     }
     /**
-     * Navigate to the home page and wait for the menu to load
+     * Navigate to the home page and wait for the menu to load.
      */
     async navigateHomeAndWaitForMenuToLoad() {
-        const baseUrl = testwiseConfig().get('environmentSettings.baseUrl');
+        const baseUrl = testwiseConfig().get('environmentSettings.baseUrl')?.replace(/\/+$/, '');
+        const minimumTimeout = 60000;
         if (!baseUrl) {
             throw new Error('Base URL is not defined in the configuration.');
         }
+        let timeout = Number(testwiseConfig().get('featureSettings.other.loginTimeout') ?? minimumTimeout);
+        if (Number.isNaN(timeout) || timeout < minimumTimeout) {
+            timeout = minimumTimeout;
+        }
         await this._page.goto(baseUrl);
-        await this._page.route('**/i_ui_menu?**', (route) => {
-            route.continue();
-        });
-        const timeout = Number(testwiseConfig().get('featureSettings.other.loginTimeout') ?? 30000);
         await pollUntil(async () => this._page.url().includes('#application='), {
             timeout,
             interval: 200,
@@ -76,8 +89,8 @@ export class LoginHelper {
             throw new Error('Username and password are required for login.');
         }
         if (serviceUrl && metaEndpoint) {
-            this.serviceUrl = serviceUrl;
-            this.metaEndpoint = metaEndpoint;
+            this.serviceUrl = serviceUrl.replace(/\/+$/, '');
+            this.metaEndpoint = metaEndpoint.replace(/\/+$/, '');
         }
         const response = await this._page.request.post(`${this.serviceUrl}/account/api/login`, {
             form: {
@@ -137,6 +150,10 @@ export class LoginHelper {
             });
         });
     }
+    /**
+     * Logs out the current session by POSTing to the logout endpoint (accepts 204 or 401
+     * as valid responses), then clears all browser cookies.
+     */
     async logOut() {
         const response = await this._page.request.post(`${this.serviceUrl}/account/api/logout`);
         if (![204, 401].includes(response.status())) {
@@ -146,6 +163,14 @@ export class LoginHelper {
     }
 }
 export class UserPreferences {
+    /**
+     * 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, serviceUrl, metaEndpoint) {
         this.guiApplAlias = String(testwiseConfig().get('environmentSettings.guiApplAlias'));
         this._page = requestContext;
@@ -157,8 +182,13 @@ export class UserPreferences {
             throw new Error('Meta endpoint not found or is empty');
         if (!this.guiApplAlias)
             throw new Error('GUI application alias not found or is empty');
-        this.url = `${serviceUrl}/${metaEndpoint}/${this.guiApplAlias}`;
+        this.url = `${serviceUrl.replace(/\/+$/, '')}/${metaEndpoint.replace(/\/+$/, '')}/${this.guiApplAlias}`;
     }
+    /**
+     * 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.
+     */
     async run(upConfigurationId) {
         const fullUrl = `${this.url}/set_up_configuration`;
         const data = {
@@ -166,6 +196,11 @@ export class UserPreferences {
         };
         await this._page.request.post(fullUrl, { headers: { 'Content-Type': 'application/json; charset=utf-8' }, data });
     }
+    /**
+     * Disables all active user preferences for the current session by POSTing to the
+     * `disable_up` endpoint.
+     * @returns The raw Playwright `APIResponse`.
+     */
     async disable() {
         const fullUrl = `${this.url}/disable_up`;
         return await this._page.request.post(fullUrl, { headers: { 'Content-Type': 'application/json; charset=utf-8' } });

package/dist/helpers/LoginHelper.js.map

@@ -1 +1 @@
-{"version":3,"file":"LoginHelper.js","sourceRoot":"","sources":["../../helpers/LoginHelper.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"LoginHelper.js","sourceRoot":"","sources":["../../helpers/LoginHelper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAE9D,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAC7D,MAAM,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,mBAAmB,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;AAEvG;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,WAAW;IAKtB,YAAY,IAAU;QAHZ,eAAU,GAAG,MAAM,CAAC,cAAc,EAAE,CAAC,GAAG,CAAC,gCAAgC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAChG,iBAAY,GAAG,MAAM,CAAC,cAAc,EAAE,CAAC,GAAG,CAAC,kCAAkC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAG5G,IAAI,CAAC,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,UAAU,KAAK,WAAW;YAAE,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;QAClG,IAAI,CAAC,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,YAAY,KAAK,WAAW;YAAE,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;QAExG,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;IACpB,CAAC;IAED;;;OAGG;IACI,KAAK,CAAC,KAAK,CAAC,aAAsB;QACvC,MAAM,IAAI,CAAC,4BAA4B,CAAC;YACtC,MAAM,EAAE;gBACN,kBAAkB,EAAE,aAAa,IAAI,aAAa,CAAC,kBAAkB;aACtE;SACF,CAAC,CAAC;IACL,CAAC;IAED;;;;OAIG;IACI,KAAK,CAAC,oBAAoB,CAAC,QAAgB,EAAE,QAAgB;QAClE,MAAM,OAAO,GAA0B;YACrC,QAAQ,EAAE,QAAQ;YAClB,QAAQ,EAAE,QAAQ;SACnB,CAAC;QAEF,MAAM,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;IACvC,CAAC;IAED;;;OAGG;IACI,KAAK,CAAC,gBAAgB,CAAC,OAA8B;QAC1D,MAAM,IAAI,CAAC,4BAA4B,CAAC,OAAO,CAAC,CAAC;IACnD,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,gCAAgC;QAC5C,MAAM,OAAO,GAAG,cAAc,EAAE,CAAC,GAAG,CAAS,6BAA6B,CAAC,EAAE,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QACjG,MAAM,cAAc,GAAG,KAAK,CAAC;QAE7B,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;QACnE,CAAC;QAED,IAAI,OAAO,GAAG,MAAM,CAAC,cAAc,EAAE,CAAC,GAAG,CAAkB,oCAAoC,CAAC,IAAI,cAAc,CAAC,CAAC;QAEpH,IAAI,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,OAAO,GAAG,cAAc,EAAE,CAAC;YACtD,OAAO,GAAG,cAAc,CAAC;QAC3B,CAAC;QAED,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAE/B,MAAM,SAAS,CAAC,KAAK,IAAI,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,eAAe,CAAC,EAAE;YACtE,OAAO;YACP,QAAQ,EAAE,GAAG;YACb,SAAS,EAAE,CAAC,EAAW,EAAE,EAAE,CAAC,EAAE,KAAK,IAAI;SACxC,CAAC,CAAC;IACL,CAAC;IAED;;;OAGG;IACK,KAAK,CAAC,4BAA4B,CAAC,UAAiC,EAAE;QAC5E,MAAM,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;QAErD,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC;QAClE,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC;QAElE,IAAI,CAAC,QAAQ,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;QACnE,CAAC;QAED,IAAI,UAAU,IAAI,YAAY,EAAE,CAAC;YAC/B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;YACjD,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QACvD,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,UAAU,oBAAoB,EAAE;YACrF,IAAI,EAAE;gBACJ,QAAQ,EAAE,QAAQ;gBAClB,QAAQ,EAAE,QAAQ;aACnB;SACF,CAAC,CAAC;QAEH,IAAI,QAAQ,CAAC,MAAM,EAAE,KAAK,GAAG,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CAAC,kCAAkC,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QACzE,CAAC;QAED,IAAI,QAAQ,KAAK,QAAQ,IAAI,cAAc,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC3D,MAAM,eAAe,GAAG,IAAI,eAAe,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;YAE5F,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC;gBAC5B,OAAO,CAAC,IAAI,CACV,mEAAmE,QAAQ,0EAA0E,CACtJ,CAAC;YACJ,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,IAAI,CACV,oCAAoC,OAAO,CAAC,cAAc,gCAAgC,QAAQ,0FAA0F,CAC7L,CAAC;YACJ,CAAC;YAED,IAAI,CAAC;gBACH,MAAM,eAAe,CAAC,OAAO,EAAE,CAAC;gBAChC,OAAO,CAAC,IAAI,CAAC,6DAA6D,QAAQ,GAAG,CAAC,CAAC;gBAEvF,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;oBAC3B,MAAM,eAAe,CAAC,GAAG,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;oBAClD,OAAO,CAAC,IAAI,CACV,+DAA+D,QAAQ,0BAA0B,OAAO,CAAC,cAAc,GAAG,CAC3H,CAAC;gBACJ,CAAC;YACH,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,CAAC,IAAI,CACV,sEAAsE,QAAQ,2CAA2C,KAAK,EAAE,CACjI,CAAC;YACJ,CAAC;QACH,CAAC;QAED,sCAAsC;QACtC,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;YAChD,KAAK,CAAC,QAAQ,CAAC;gBACb,OAAO,EAAE;oBACP,GAAG,OAAO,CAAC,OAAO,EAAE;oBACpB,iBAAiB,EAAE,OAAO;iBAC3B;aACF,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,MAAM,IAAI,CAAC,oBAAoB,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC;QAE9C,MAAM,IAAI,CAAC,gCAAgC,EAAE,CAAC;IAChD,CAAC;IAED;;;OAGG;IACK,KAAK,CAAC,oBAAoB,CAAC,OAA+B;QAChE,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,gBAAgB,EAAE,CAAC,KAAK,EAAE,EAAE;YACjD,KAAK,CAAC,OAAO,CAAC;gBACZ,MAAM,EAAE,GAAG;gBACX,WAAW,EAAE,kBAAkB;gBAC/B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;oBACnB,GAAG,aAAa;oBAChB,UAAU,EAAE,GAAG,IAAI,CAAC,UAAU,QAAQ,IAAI,CAAC,YAAY,EAAE;oBACzD,GAAG,OAAO;iBACX,CAAC;aACH,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;OAGG;IACI,KAAK,CAAC,MAAM;QACjB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,UAAU,qBAAqB,CAAC,CAAC;QAExF,IAAI,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC;YAC5C,MAAM,IAAI,KAAK,CAAC,mCAAmC,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAC1E,CAAC;QAED,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,YAAY,EAAE,CAAC;IAC5C,CAAC;CACF;AAED,MAAM,OAAO,eAAe;IAM1B;;;;;;;OAOG;IACH,YAAY,cAAoB,EAAE,UAAmB,EAAE,YAAqB;QAX5D,iBAAY,GAAG,MAAM,CAAC,cAAc,EAAE,CAAC,GAAG,CAAS,kCAAkC,CAAC,CAAC,CAAC;QAYtG,IAAI,CAAC,KAAK,GAAG,cAAc,CAAC;QAE5B,UAAU,GAAG,UAAU,IAAI,cAAc,EAAE,CAAC,GAAG,CAAS,gCAAgC,CAAC,CAAC;QAC1F,YAAY,GAAG,YAAY,IAAI,cAAc,EAAE,CAAC,GAAG,CAAS,kCAAkC,CAAC,CAAC;QAEhG,IAAI,CAAC,UAAU;YAAE,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;QACtE,IAAI,CAAC,YAAY;YAAE,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;QAC1E,IAAI,CAAC,IAAI,CAAC,YAAY;YAAE,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;QAEvF,IAAI,CAAC,GAAG,GAAG,GAAG,UAAU,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,YAAY,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;IAC1G,CAAC;IAED;;;;OAIG;IACI,KAAK,CAAC,GAAG,CAAC,iBAAyB;QACxC,MAAM,OAAO,GAAG,GAAG,IAAI,CAAC,GAAG,uBAAuB,CAAC;QAEnD,MAAM,IAAI,GAAG;YACX,mBAAmB,EAAE,iBAAiB;SACvC,CAAC;QAEF,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,OAAO,EAAE,EAAE,cAAc,EAAE,iCAAiC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;IACnH,CAAC;IAED;;;;OAIG;IACI,KAAK,CAAC,OAAO;QAClB,MAAM,OAAO,GAAG,GAAG,IAAI,CAAC,GAAG,aAAa,CAAC;QAEzC,OAAO,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,OAAO,EAAE,EAAE,cAAc,EAAE,iCAAiC,EAAE,EAAE,CAAC,CAAC;IACpH,CAAC;CACF"}

package/dist/helpers/PathResolver.d.ts

@@ -1,3 +1,25 @@
+/**
+ * Locates the root directory of the **consumer project** (the project that has
+ * `@thinkwise/testwise` installed as a dependency) at runtime.
+ *
+ * **Why this exists:** Testwise runs from inside `node_modules` but needs to
+ * read and write files that belong to the consuming project (e.g.
+ * `registeredSubjects.json`, `Testwise.json`). Simply using `process.cwd()`
+ * is unreliable when scripts are invoked from sub-directories. This class
+ * walks up the directory tree looking for the first `package.json` whose
+ * `name` is NOT `@thinkwise/testwise`, which is guaranteed to be the consumer
+ * project root.
+ *
+ * **How to use it:** Inject it into any pipeline helper that needs to write
+ * to the consumer project. `PipelinePaths` already does this — you rarely
+ * need to instantiate `PathResolver` directly.
+ */
 export declare class PathResolver {
+    /**
+     * Walks up the directory tree from `process.cwd()` to find the nearest `package.json`
+     * whose `name` is not `@thinkwise/testwise`, returning that directory as the consumer
+     * project root. Falls back to `process.cwd()` if no such package is found.
+     * @returns Absolute path to the consumer project's root directory.
+     */
     getConsumerRootDirectory(): string;
 }

package/dist/helpers/PathResolver.js

@@ -1,6 +1,28 @@
 import fs from 'node:fs';
 import path from 'node:path';
+/**
+ * Locates the root directory of the **consumer project** (the project that has
+ * `@thinkwise/testwise` installed as a dependency) at runtime.
+ *
+ * **Why this exists:** Testwise runs from inside `node_modules` but needs to
+ * read and write files that belong to the consuming project (e.g.
+ * `registeredSubjects.json`, `Testwise.json`). Simply using `process.cwd()`
+ * is unreliable when scripts are invoked from sub-directories. This class
+ * walks up the directory tree looking for the first `package.json` whose
+ * `name` is NOT `@thinkwise/testwise`, which is guaranteed to be the consumer
+ * project root.
+ *
+ * **How to use it:** Inject it into any pipeline helper that needs to write
+ * to the consumer project. `PipelinePaths` already does this — you rarely
+ * need to instantiate `PathResolver` directly.
+ */
 export class PathResolver {
+    /**
+     * Walks up the directory tree from `process.cwd()` to find the nearest `package.json`
+     * whose `name` is not `@thinkwise/testwise`, returning that directory as the consumer
+     * project root. Falls back to `process.cwd()` if no such package is found.
+     * @returns Absolute path to the consumer project's root directory.
+     */
     getConsumerRootDirectory() {
         let directory = process.cwd();
         let lastDir = '';

package/dist/helpers/PathResolver.js.map

@@ -1 +1 @@
-{"version":3,"file":"PathResolver.js","sourceRoot":"","sources":["../../helpers/PathResolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,MAAM,OAAO,YAAY;IAChB,wBAAwB;QAC7B,IAAI,SAAS,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;QAC9B,IAAI,OAAO,GAAG,EAAE,CAAC;QACjB,IAAI,KAAK,GAAG,KAAK,CAAC;QAElB,OAAO,SAAS,KAAK,OAAO,EAAE,CAAC;YAC7B,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;YAErD,IAAI,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC3B,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;gBAC1D,IAAI,GAAG,CAAC,IAAI,KAAK,qBAAqB,EAAE,CAAC;oBACvC,KAAK,GAAG,IAAI,CAAC;oBACb,MAAM;gBACR,CAAC;YACH,CAAC;YAED,OAAO,GAAG,SAAS,CAAC;YACpB,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QACtC,CAAC;QACD,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,SAAS,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;QAC5B,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;CACF"}
+{"version":3,"file":"PathResolver.js","sourceRoot":"","sources":["../../helpers/PathResolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B;;;;;;;;;;;;;;;GAeG;AACH,MAAM,OAAO,YAAY;IACvB;;;;;OAKG;IACI,wBAAwB;QAC7B,IAAI,SAAS,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;QAC9B,IAAI,OAAO,GAAG,EAAE,CAAC;QACjB,IAAI,KAAK,GAAG,KAAK,CAAC;QAElB,OAAO,SAAS,KAAK,OAAO,EAAE,CAAC;YAC7B,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;YAErD,IAAI,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC3B,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;gBAC1D,IAAI,GAAG,CAAC,IAAI,KAAK,qBAAqB,EAAE,CAAC;oBACvC,KAAK,GAAG,IAAI,CAAC;oBACb,MAAM;gBACR,CAAC;YACH,CAAC;YAED,OAAO,GAAG,SAAS,CAAC;YACpB,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QACtC,CAAC;QACD,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,SAAS,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;QAC5B,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;CACF"}

package/dist/helpers/Poll.d.ts

@@ -1,2 +1,14 @@
-import type { PollOptions } from '../types/PollTypes.ts';
+import type { PollOptions } from '../types/PollTypes.js';
+/**
+ * Repeatedly calls `fn` at a configurable interval until the optional `predicate` returns
+ * truthy or the `timeout` is exceeded, at which point it throws.
+ * `onTick` is called with the last value and elapsed time after each failing attempt.
+ * @param fn - The async or sync function to poll.
+ * @param opts.timeout - Maximum wait time in milliseconds (default `10 000`).
+ * @param opts.interval - Polling interval in milliseconds (default `200`).
+ * @param opts.predicate - Returns `true` when the result is acceptable (default: truthy check).
+ * @param opts.onTick - Called after each failing attempt with the last value and elapsed ms.
+ * @returns The first value for which `predicate` returns `true`.
+ * @throws If `timeout` is exceeded before `predicate` returns `true`.
+ */
 export declare function pollUntil<T>(fn: () => Promise<T> | T, opts?: PollOptions<T>): Promise<T>;