@thinkwise/testwise 0.2.105 → 0.2.111

package/dist/helpers/Poll.js

@@ -1,27 +1,109 @@
+const maxDescribedLength = 200;
+/**
+ * Thrown when `pollUntil` exceeds its timeout.
+ *
+ * The message states what was awaited, how many attempts were made and the last value
+ * the polled function returned, so a timeout is diagnosable from a test report alone.
+ * The same details are exposed as properties for programmatic inspection.
+ */
+export class PollTimeoutError extends Error {
+    constructor(details) {
+        const waitingFor = details.description ? ` waiting for ${details.description}` : '';
+        super(`pollUntil timeout after ${details.timeout}ms${waitingFor}; ` +
+            `${details.attempts} attempts over ${details.elapsedMs}ms, ` +
+            `last value: ${describePolledValue(details.lastValue)}`);
+        this.name = 'PollTimeoutError';
+        this.timeout = details.timeout;
+        this.elapsedMs = details.elapsedMs;
+        this.attempts = details.attempts;
+        this.lastValue = details.lastValue;
+        this.description = details.description;
+    }
+}
+function truncate(text) {
+    return text.length > maxDescribedLength ? `${text.slice(0, maxDescribedLength)}… (${text.length} chars)` : text;
+}
+/**
+ * Renders any polled value as a short, single-line string. Never throws, so a bad
+ * value can never mask the timeout it was meant to explain.
+ */
+function describePolledValue(value) {
+    if (value === null) {
+        return 'null';
+    }
+    if (value === undefined) {
+        return 'undefined';
+    }
+    if (typeof value === 'bigint') {
+        return `${value}n`;
+    }
+    if (typeof value === 'function') {
+        return `[Function ${value.name || 'anonymous'}]`;
+    }
+    if (typeof value === 'string') {
+        return truncate(JSON.stringify(value));
+    }
+    if (typeof value === 'object') {
+        return truncate(stringifyObject(value));
+    }
+    return truncate(String(value));
+}
+function stringifyObject(value) {
+    const seen = new WeakSet();
+    try {
+        const json = JSON.stringify(value, (_key, nested) => {
+            if (typeof nested === 'bigint') {
+                return `${nested}n`;
+            }
+            if (typeof nested !== 'object' || nested === null) {
+                return nested;
+            }
+            if (seen.has(nested)) {
+                return '[Circular]';
+            }
+            seen.add(nested);
+            return nested;
+        });
+        return json ?? Object.prototype.toString.call(value);
+    }
+    catch {
+        return Object.prototype.toString.call(value);
+    }
+}
 /**
  * Repeatedly calls `fn` at a configurable interval until the optional `predicate` returns
- * truthy or the `timeout` is exceeded, at which point it throws.
+ * truthy or the `timeout` is exceeded, at which point it throws a {@link PollTimeoutError}.
  * `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.
+ * @param opts.description - What is being waited for, quoted in the timeout message.
  * @returns The first value for which `predicate` returns `true`.
- * @throws If `timeout` is exceeded before `predicate` returns `true`.
+ * @throws {PollTimeoutError} If `timeout` is exceeded before `predicate` returns `true`.
  */
 export async function pollUntil(fn, opts = {}) {
     const timeout = opts.timeout ?? 10000;
     const interval = opts.interval ?? 200;
     const ok = opts.predicate ?? ((v) => Boolean(v));
     const start = Date.now();
+    let attempts = 0;
     while (true) {
         const val = await fn();
+        attempts++;
         if (ok(val))
             return val;
-        opts.onTick?.(val, Date.now() - start);
-        if (Date.now() - start >= timeout) {
-            throw new Error(`pollUntil timeout after ${timeout}ms`);
+        const elapsedMs = Date.now() - start;
+        opts.onTick?.(val, elapsedMs);
+        if (elapsedMs >= timeout) {
+            throw new PollTimeoutError({
+                timeout,
+                elapsedMs,
+                attempts,
+                lastValue: val,
+                description: opts.description
+            });
         }
         await new Promise((r) => setTimeout(r, interval));
     }

package/dist/helpers/Poll.js.map

@@ -1 +1 @@
-{"version":3,"file":"Poll.js","sourceRoot":"","sources":["../../helpers/Poll.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAI,EAAwB,EAAE,OAAuB,EAAE;IACpF,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,KAAM,CAAC;IACvC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,GAAG,CAAC;IACtC,MAAM,EAAE,GAAG,IAAI,CAAC,SAAS,IAAI,CAAC,CAAC,CAAI,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IACpD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAEzB,OAAO,IAAI,EAAE,CAAC;QACZ,MAAM,GAAG,GAAG,MAAM,EAAE,EAAE,CAAC;QACvB,IAAI,EAAE,CAAC,GAAG,CAAC;YAAE,OAAO,GAAG,CAAC;QAExB,IAAI,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,CAAC;QACvC,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,IAAI,OAAO,EAAE,CAAC;YAClC,MAAM,IAAI,KAAK,CAAC,2BAA2B,OAAO,IAAI,CAAC,CAAC;QAC1D,CAAC;QACD,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC;IACpD,CAAC;AACH,CAAC"}
+{"version":3,"file":"Poll.js","sourceRoot":"","sources":["../../helpers/Poll.ts"],"names":[],"mappings":"AAEA,MAAM,kBAAkB,GAAG,GAAG,CAAC;AAE/B;;;;;;GAMG;AACH,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IAOzC,YAAY,OAMX;QACC,MAAM,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,gBAAgB,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACpF,KAAK,CACH,2BAA2B,OAAO,CAAC,OAAO,KAAK,UAAU,IAAI;YAC3D,GAAG,OAAO,CAAC,QAAQ,kBAAkB,OAAO,CAAC,SAAS,MAAM;YAC5D,eAAe,mBAAmB,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAC1D,CAAC;QAEF,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;QAC/B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QAC/B,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;QACnC,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;QACjC,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;QACnC,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;IACzC,CAAC;CACF;AAED,SAAS,QAAQ,CAAC,IAAY;IAC5B,OAAO,IAAI,CAAC,MAAM,GAAG,kBAAkB,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,kBAAkB,CAAC,MAAM,IAAI,CAAC,MAAM,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC;AAClH,CAAC;AAED;;;GAGG;AACH,SAAS,mBAAmB,CAAC,KAAc;IACzC,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACnB,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO,WAAW,CAAC;IACrB,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,GAAG,KAAK,GAAG,CAAC;IACrB,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,UAAU,EAAE,CAAC;QAChC,OAAO,aAAa,KAAK,CAAC,IAAI,IAAI,WAAW,GAAG,CAAC;IACnD,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;IACzC,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,QAAQ,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC;IAC1C,CAAC;IACD,OAAO,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;AACjC,CAAC;AAED,SAAS,eAAe,CAAC,KAAa;IACpC,MAAM,IAAI,GAAG,IAAI,OAAO,EAAU,CAAC;IAEnC,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE;YAClD,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;gBAC/B,OAAO,GAAG,MAAM,GAAG,CAAC;YACtB,CAAC;YACD,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;gBAClD,OAAO,MAAM,CAAC;YAChB,CAAC;YACD,IAAI,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;gBACrB,OAAO,YAAY,CAAC;YACtB,CAAC;YACD,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YACjB,OAAO,MAAM,CAAC;QAChB,CAAC,CAAC,CAAC;QAEH,OAAO,IAAI,IAAI,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACvD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC/C,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAI,EAAwB,EAAE,OAAuB,EAAE;IACpF,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,KAAM,CAAC;IACvC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,GAAG,CAAC;IACtC,MAAM,EAAE,GAAG,IAAI,CAAC,SAAS,IAAI,CAAC,CAAC,CAAI,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IACpD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACzB,IAAI,QAAQ,GAAG,CAAC,CAAC;IAEjB,OAAO,IAAI,EAAE,CAAC;QACZ,MAAM,GAAG,GAAG,MAAM,EAAE,EAAE,CAAC;QACvB,QAAQ,EAAE,CAAC;QACX,IAAI,EAAE,CAAC,GAAG,CAAC;YAAE,OAAO,GAAG,CAAC;QAExB,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;QACrC,IAAI,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;QAC9B,IAAI,SAAS,IAAI,OAAO,EAAE,CAAC;YACzB,MAAM,IAAI,gBAAgB,CAAC;gBACzB,OAAO;gBACP,SAAS;gBACT,QAAQ;gBACR,SAAS,EAAE,GAAG;gBACd,WAAW,EAAE,IAAI,CAAC,WAAW;aAC9B,CAAC,CAAC;QACL,CAAC;QACD,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC;IACpD,CAAC;AACH,CAAC"}

package/dist/helpers/UserSimulationHelper.js

@@ -52,7 +52,8 @@ export class UserSimulationHelper {
         await pollUntil(() => this.getSimulatedUser(), {
             timeout: 5000,
             interval: 200,
-            predicate: (val) => val === ''
+            predicate: (val) => val === '',
+            description: 'user simulation to stop and clear the simulated user'
         });
     }
     /**

package/dist/helpers/UserSimulationHelper.js.map

@@ -1 +1 @@
-{"version":3,"file":"UserSimulationHelper.js","sourceRoot":"","sources":["../../helpers/UserSimulationHelper.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAO,oBAAoB;IAI/B,YAAY,IAAU;QACpB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAElB,MAAM,UAAU,GAAG,cAAc,EAAE,CAAC,GAAG,CAAS,gCAAgC,CAAC,CAAC;QAElF,IAAI,CAAC,UAAU;YAAE,MAAM,IAAI,KAAK,CAAC,qEAAqE,CAAC,CAAC;QAExG,IAAI,CAAC,WAAW,GAAG,UAAU,CAAC;IAChC,CAAC;IAED;;;OAGG;IACI,KAAK,CAAC,gBAAgB;QAC3B,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,WAAW,6BAA6B,CAAC,CAAC;QAEhG,QAAQ,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC;YAC1B,KAAK,GAAG;gBACN,OAAO,CAAC,IAAI,CAAC,4BAA4B,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;gBAC9D,OAAO,EAAE,CAAC;YACZ,KAAK,GAAG;gBACN,OAAO,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,cAAc,CAAC;YAChD;gBACE,MAAM,IAAI,KAAK,CAAC,kDAAkD,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAC3F,CAAC;IACH,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,cAAc;QACzB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,WAAW,6BAA6B,CAAC,CAAC;QAEnG,IAAI,QAAQ,CAAC,MAAM,EAAE,KAAK,GAAG,EAAE,CAAC;YAC9B,OAAO,CAAC,IAAI,CAAC,4CAA4C,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;QAChF,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,KAAK,CAAC,+CAA+C,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QACtF,CAAC;QAED,MAAM,SAAS,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,gBAAgB,EAAE,EAAE;YAC7C,OAAO,EAAE,IAAK;YACd,QAAQ,EAAE,GAAG;YACb,SAAS,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,KAAK,EAAE;SAC/B,CAAC,CAAC;IACL,CAAC;IAED;;;OAGG;IACI,KAAK,CAAC,YAAY,CAAC,QAAgB;QACxC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,WAAW,6BAA6B,EAAE;YAChG,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;gBAClC,MAAM,EAAE,kBAAkB;aAC3B;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACnB,cAAc,EAAE,QAAQ;aACzB,CAAC;SACH,CAAC,CAAC;QAEH,IAAI,QAAQ,CAAC,MAAM,EAAE,KAAK,GAAG,EAAE,CAAC;YAC9B,OAAO,CAAC,IAAI,CAAC,uCAAuC,EAAE,MAAM,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;QACjF,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,KAAK,CAAC,0CAA0C,MAAM,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QACvF,CAAC;IACH,CAAC;CACF"}
+{"version":3,"file":"UserSimulationHelper.js","sourceRoot":"","sources":["../../helpers/UserSimulationHelper.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAO,oBAAoB;IAI/B,YAAY,IAAU;QACpB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAElB,MAAM,UAAU,GAAG,cAAc,EAAE,CAAC,GAAG,CAAS,gCAAgC,CAAC,CAAC;QAElF,IAAI,CAAC,UAAU;YAAE,MAAM,IAAI,KAAK,CAAC,qEAAqE,CAAC,CAAC;QAExG,IAAI,CAAC,WAAW,GAAG,UAAU,CAAC;IAChC,CAAC;IAED;;;OAGG;IACI,KAAK,CAAC,gBAAgB;QAC3B,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,WAAW,6BAA6B,CAAC,CAAC;QAEhG,QAAQ,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC;YAC1B,KAAK,GAAG;gBACN,OAAO,CAAC,IAAI,CAAC,4BAA4B,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;gBAC9D,OAAO,EAAE,CAAC;YACZ,KAAK,GAAG;gBACN,OAAO,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,cAAc,CAAC;YAChD;gBACE,MAAM,IAAI,KAAK,CAAC,kDAAkD,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAC3F,CAAC;IACH,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,cAAc;QACzB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,WAAW,6BAA6B,CAAC,CAAC;QAEnG,IAAI,QAAQ,CAAC,MAAM,EAAE,KAAK,GAAG,EAAE,CAAC;YAC9B,OAAO,CAAC,IAAI,CAAC,4CAA4C,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;QAChF,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,KAAK,CAAC,+CAA+C,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QACtF,CAAC;QAED,MAAM,SAAS,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,gBAAgB,EAAE,EAAE;YAC7C,OAAO,EAAE,IAAK;YACd,QAAQ,EAAE,GAAG;YACb,SAAS,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,KAAK,EAAE;YAC9B,WAAW,EAAE,sDAAsD;SACpE,CAAC,CAAC;IACL,CAAC;IAED;;;OAGG;IACI,KAAK,CAAC,YAAY,CAAC,QAAgB;QACxC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,WAAW,6BAA6B,EAAE;YAChG,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;gBAClC,MAAM,EAAE,kBAAkB;aAC3B;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACnB,cAAc,EAAE,QAAQ;aACzB,CAAC;SACH,CAAC,CAAC;QAEH,IAAI,QAAQ,CAAC,MAAM,EAAE,KAAK,GAAG,EAAE,CAAC;YAC9B,OAAO,CAAC,IAAI,CAAC,uCAAuC,EAAE,MAAM,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;QACjF,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,KAAK,CAAC,0CAA0C,MAAM,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QACvF,CAAC;IACH,CAAC;CACF"}

package/dist/interfaces/ITabTask.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Represents a single subject+variant combination that has qualifying task
+ * buttons, as stored in `seed-data/tab-tasks.json` after the
+ * `TaskDataBuilder` pipeline step.
+ *
+ * Tasks with `custom_display_type === 4` are stripped at fetch time and never
+ * appear here. If all tasks for a subject+variant had that type, the entry is
+ * omitted entirely and that subject receives a plain `ActionBar`.
+ */
+export interface ITabTask {
+    /** Thinkwise subject identifier (matches `ISubject.subject`). */
+    subject: string;
+    /** Subject variant identifier (matches `ISubject.variant`). */
+    variant: string;
+    /**
+     * Ordered list of qualifying task IDs.
+     * Each entry becomes a named getter on the generated custom ActionBar class.
+     * e.g. `"supplier-item-add"` → `get supplierItemAddButton(): Locator`
+     */
+    tasks: string[];
+}

package/dist/interfaces/ITabTask.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ITabTask.js.map

package/dist/interfaces/ITabTask.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ITabTask.js","sourceRoot":"","sources":["../../interfaces/ITabTask.ts"],"names":[],"mappings":""}

package/dist/services/IndiciumApi.service.d.ts

@@ -44,6 +44,13 @@ export declare class IndiciumApiService {
      * @returns An array of screen component objects, or an empty array if not verified or on error.
      */
     getScreenComponents(): Promise<any[]>;
+    /**
+     * Fetches all task button records (`i_ui_tab_task`) for the verified GUI application.
+     * Results include all tasks regardless of `custom_display_type`; callers are
+     * responsible for filtering out `custom_display_type === 4` entries.
+     * @returns An array of tab task objects, or an empty array if not verified or on error.
+     */
+    getTabTasks(): Promise<any[]>;
     /**
      * Returns the verified GUI Application ID.
      * Throws an error if verification failed or the alias was not found.

package/dist/services/IndiciumApi.service.js

@@ -153,6 +153,25 @@ export class IndiciumApiService {
             return [];
         }
     }
+    /**
+     * Fetches all task button records (`i_ui_tab_task`) for the verified GUI application.
+     * Results include all tasks regardless of `custom_display_type`; callers are
+     * responsible for filtering out `custom_display_type === 4` entries.
+     * @returns An array of tab task objects, or an empty array if not verified or on error.
+     */
+    async getTabTasks() {
+        await this.ensureReady();
+        if (!this.isVerified || !this.guiApplId)
+            return [];
+        try {
+            const response = await this.axiosInstance.get(`/iam/${this.metaEndpoint}/i_ui_tab_task?$filter=gui_appl_id%20eq%20${this.guiApplId}`);
+            return response.data?.value || [];
+        }
+        catch (error) {
+            console.error(`IndiciumApiService: Failed to fetch tab tasks: ${IndiciumApiService.extractMessage(error)}`);
+            return [];
+        }
+    }
     /**
      * Returns the verified GUI Application ID.
      * Throws an error if verification failed or the alias was not found.

package/dist/services/IndiciumApi.service.js.map

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

package/dist/types/PollTypes.d.ts

@@ -11,4 +11,9 @@ export type PollOptions<T = unknown> = {
     interval?: number;
     predicate?: (v: T) => boolean;
     onTick?: (v: T, elapsedMs: number) => void;
+    /**
+     * What is being waited for, phrased to follow "waiting for ...". Included in the
+     * timeout message, so a failure reads as a sentence rather than a bare timeout.
+     */
+    description?: string;
 };

package/helpers/DateFormat.ts

@@ -0,0 +1,123 @@
+/**
+ * Pure, page-independent helpers for turning a canonical ISO date/time into the
+ * digit sequence a Thinkwise date picker expects for a given locale.
+ *
+ * **Why this exists:** Thinkwise renders dates in the field order dictated by the
+ * logged-in user's `dateLocale` (e.g. `DD/MM/YYYY` for en-GB, `MM/DD/YYYY` for
+ * en-US, `YYYY-MM-DD` for sv-SE). The date picker applies its own separators when
+ * digits are typed sequentially, so all we must do is emit the day/month/year
+ * digits in the locale's order. These functions have no Playwright dependency and
+ * are unit-testable in isolation.
+ */
+
+export type DateParts = {
+  year: string;
+  month: string;
+  day: string;
+  hour?: string;
+  minute?: string;
+  second?: string;
+};
+
+export type DateFieldOrder = ('year' | 'month' | 'day')[];
+
+// A fixed reference date whose parts are all distinct and unambiguous, used to
+// probe a locale's field order via Intl. Day 7 / month 5 keeps it well inside
+// valid ranges for every calendar.
+const referenceDate = new Date(Date.UTC(2026, 4, 7));
+
+const isoDateTimePattern =
+  /^(?<year>\d{4})-(?<month>\d{2})-(?<day>\d{2})(?:[ T](?<hour>\d{2}):(?<minute>\d{2})(?::(?<second>\d{2}))?)?$/;
+
+/**
+ * Parse a canonical ISO date/time string into its component parts.
+ *
+ * Accepts `YYYY-MM-DD` and `YYYY-MM-DD HH:mm[:ss]` (a `T` separator also works).
+ * Throws a descriptive error on any other input so test authors get a clear
+ * message rather than a silently wrong date.
+ *
+ * @param iso - Canonical ISO date or date-time string.
+ * @returns The parsed, zero-padded date (and optional time) parts.
+ */
+export function parseIsoDateTime(iso: string): DateParts {
+  const match = isoDateTimePattern.exec(iso.trim());
+
+  if (!match?.groups) {
+    throw new Error(`Invalid date "${iso}". Expected canonical ISO format "YYYY-MM-DD" or "YYYY-MM-DD HH:mm:ss".`);
+  }
+
+  const { year, month, day, hour, minute, second } = match.groups;
+
+  return {
+    year,
+    month,
+    day,
+    ...(hour !== undefined ? { hour, minute, second: second ?? '00' } : {})
+  };
+}
+
+/**
+ * Whether a value is a canonical ISO date or date-time that {@link parseIsoDateTime} accepts.
+ *
+ * @param value - The value to test.
+ * @returns `true` for `YYYY-MM-DD` and `YYYY-MM-DD HH:mm[:ss]` (a `T` separator also works).
+ */
+export function isIsoDateTime(value: string): boolean {
+  return isoDateTimePattern.test(value.trim());
+}
+
+/**
+ * Determine the day/month/year ordering a locale uses to display dates.
+ *
+ * Derives the order from `Intl.DateTimeFormat` rather than a hardcoded table, so
+ * any locale the app supports is handled. Falls back to day/month/year when the
+ * locale is empty or unrecognised.
+ *
+ * @param locale - A BCP-47 locale tag (e.g. `en-GB`, `en-US`, `sv-SE`).
+ * @returns The order of date fields for that locale.
+ */
+export function fieldOrderForLocale(locale: string): DateFieldOrder {
+  const fallback: DateFieldOrder = ['day', 'month', 'year'];
+
+  if (!locale) return fallback;
+
+  try {
+    const order = new Intl.DateTimeFormat(locale)
+      .formatToParts(referenceDate)
+      .map((part) => part.type)
+      .filter((type): type is 'year' | 'month' | 'day' => type === 'year' || type === 'month' || type === 'day');
+
+    return order.length === 3 ? order : fallback;
+  } catch {
+    return fallback;
+  }
+}
+
+/**
+ * Produce the sequence of digits to type into a date picker for the given locale
+ * order. Date digits come first in `order`, followed by any time digits (always
+ * `HHmmss`). No separators are emitted — the picker inserts its own.
+ *
+ * @param parts - Parsed date/time parts.
+ * @param order - The locale's day/month/year ordering.
+ * @returns The digit string to type sequentially.
+ */
+export function toDigitSequence(parts: DateParts, order: DateFieldOrder): string {
+  const dateDigits = order.map((field) => parts[field]).join('');
+  const timeDigits = parts.hour !== undefined ? `${parts.hour}${parts.minute ?? '00'}${parts.second ?? '00'}` : '';
+
+  return `${dateDigits}${timeDigits}`;
+}
+
+/**
+ * Convenience helper combining {@link parseIsoDateTime}, {@link fieldOrderForLocale}
+ * and {@link toDigitSequence}: turn a canonical ISO date into the digit sequence
+ * for a locale.
+ *
+ * @param iso - Canonical ISO date or date-time string.
+ * @param locale - A BCP-47 locale tag; empty falls back to day/month/year order.
+ * @returns The digit string to type sequentially into the picker.
+ */
+export function isoToLocaleDigits(iso: string, locale: string): string {
+  return toDigitSequence(parseIsoDateTime(iso), fieldOrderForLocale(locale));
+}

package/helpers/DateLocaleHelper.ts

@@ -0,0 +1,57 @@
+import type { Page } from '@playwright/test';
+
+/**
+ * Reads the logged-in user's active date locale from the Thinkwise web app.
+ *
+ * **Why this exists:** Date pickers render dates in the field order dictated by the
+ * user's `dateLocale` preference. Testwise needs that locale to type dates in the
+ * correct order regardless of the browser locale. The value lives in the Redux
+ * store the app exposes on `window.__REDUX_STORE__` (see the front-end change that
+ * added it):
+ *
+ * ```ts
+ * window.__REDUX_STORE__.getState().auth.user.dateLocale
+ * ```
+ *
+ * The store is populated asynchronously after config load and login, so callers
+ * must only rely on this once past the login screen. Before then (or if the shape
+ * ever changes) this resolves to an empty string, letting callers fall back to a
+ * sensible default order.
+ */
+
+// Cache the resolved locale per page so repeated date fills don't re-evaluate.
+const localeCache = new WeakMap<Page, string>();
+
+/**
+ * Retrieve the app's active date locale (e.g. `en-GB`, `sv-SE`), caching the
+ * result per page. Returns `''` when the Redux store is not yet available or does
+ * not expose a locale.
+ *
+ * @param page - The Playwright page bound to a logged-in Thinkwise session.
+ * @returns The BCP-47 date locale tag, or `''` if it cannot be determined.
+ */
+export async function getDateLocale(page: Page): Promise<string> {
+  const cached = localeCache.get(page);
+  if (cached !== undefined) return cached;
+
+  const locale = await page
+    .evaluate(() => {
+      const store = (window as unknown as { __REDUX_STORE__?: { getState(): unknown } }).__REDUX_STORE__;
+      const state = store?.getState() as { auth?: { user?: { dateLocale?: string } } } | undefined;
+      return state?.auth?.user?.dateLocale ?? '';
+    })
+    .catch(() => '');
+
+  localeCache.set(page, locale);
+  return locale;
+}
+
+/**
+ * Clear any cached date locale for a page. Useful after a re-login or a user
+ * preference change that alters the active `dateLocale` within the same page.
+ *
+ * @param page - The page whose cached locale should be discarded.
+ */
+export function clearDateLocaleCache(page: Page): void {
+  localeCache.delete(page);
+}

package/helpers/LoginHelper.ts

@@ -89,7 +89,8 @@ export class LoginHelper {
     await pollUntil(async () => this._page.url().includes('#application='), {
       timeout,
       interval: 200,
-      predicate: (ok: boolean) => ok === true
+      predicate: (ok: boolean) => ok === true,
+      description: 'the URL to carry #application= after login'
     });
   }
 

package/helpers/Poll.ts

@@ -1,30 +1,133 @@
 import type { PollOptions } from '../types/PollTypes.js';
 
+const maxDescribedLength = 200;
+
+/**
+ * Thrown when `pollUntil` exceeds its timeout.
+ *
+ * The message states what was awaited, how many attempts were made and the last value
+ * the polled function returned, so a timeout is diagnosable from a test report alone.
+ * The same details are exposed as properties for programmatic inspection.
+ */
+export class PollTimeoutError extends Error {
+  public readonly timeout: number;
+  public readonly elapsedMs: number;
+  public readonly attempts: number;
+  public readonly lastValue: unknown;
+  public readonly description?: string;
+
+  constructor(details: {
+    timeout: number;
+    elapsedMs: number;
+    attempts: number;
+    lastValue: unknown;
+    description?: string;
+  }) {
+    const waitingFor = details.description ? ` waiting for ${details.description}` : '';
+    super(
+      `pollUntil timeout after ${details.timeout}ms${waitingFor}; ` +
+        `${details.attempts} attempts over ${details.elapsedMs}ms, ` +
+        `last value: ${describePolledValue(details.lastValue)}`
+    );
+
+    this.name = 'PollTimeoutError';
+    this.timeout = details.timeout;
+    this.elapsedMs = details.elapsedMs;
+    this.attempts = details.attempts;
+    this.lastValue = details.lastValue;
+    this.description = details.description;
+  }
+}
+
+function truncate(text: string): string {
+  return text.length > maxDescribedLength ? `${text.slice(0, maxDescribedLength)}… (${text.length} chars)` : text;
+}
+
+/**
+ * Renders any polled value as a short, single-line string. Never throws, so a bad
+ * value can never mask the timeout it was meant to explain.
+ */
+function describePolledValue(value: unknown): string {
+  if (value === null) {
+    return 'null';
+  }
+  if (value === undefined) {
+    return 'undefined';
+  }
+  if (typeof value === 'bigint') {
+    return `${value}n`;
+  }
+  if (typeof value === 'function') {
+    return `[Function ${value.name || 'anonymous'}]`;
+  }
+  if (typeof value === 'string') {
+    return truncate(JSON.stringify(value));
+  }
+  if (typeof value === 'object') {
+    return truncate(stringifyObject(value));
+  }
+  return truncate(String(value));
+}
+
+function stringifyObject(value: object): string {
+  const seen = new WeakSet<object>();
+
+  try {
+    const json = JSON.stringify(value, (_key, nested) => {
+      if (typeof nested === 'bigint') {
+        return `${nested}n`;
+      }
+      if (typeof nested !== 'object' || nested === null) {
+        return nested;
+      }
+      if (seen.has(nested)) {
+        return '[Circular]';
+      }
+      seen.add(nested);
+      return nested;
+    });
+
+    return json ?? Object.prototype.toString.call(value);
+  } catch {
+    return Object.prototype.toString.call(value);
+  }
+}
+
 /**
  * Repeatedly calls `fn` at a configurable interval until the optional `predicate` returns
- * truthy or the `timeout` is exceeded, at which point it throws.
+ * truthy or the `timeout` is exceeded, at which point it throws a {@link PollTimeoutError}.
  * `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.
+ * @param opts.description - What is being waited for, quoted in the timeout message.
  * @returns The first value for which `predicate` returns `true`.
- * @throws If `timeout` is exceeded before `predicate` returns `true`.
+ * @throws {PollTimeoutError} If `timeout` is exceeded before `predicate` returns `true`.
  */
 export async function pollUntil<T>(fn: () => Promise<T> | T, opts: PollOptions<T> = {}): Promise<T> {
   const timeout = opts.timeout ?? 10_000;
   const interval = opts.interval ?? 200;
   const ok = opts.predicate ?? ((v: T) => Boolean(v));
   const start = Date.now();
+  let attempts = 0;
 
   while (true) {
     const val = await fn();
+    attempts++;
     if (ok(val)) return val;
 
-    opts.onTick?.(val, Date.now() - start);
-    if (Date.now() - start >= timeout) {
-      throw new Error(`pollUntil timeout after ${timeout}ms`);
+    const elapsedMs = Date.now() - start;
+    opts.onTick?.(val, elapsedMs);
+    if (elapsedMs >= timeout) {
+      throw new PollTimeoutError({
+        timeout,
+        elapsedMs,
+        attempts,
+        lastValue: val,
+        description: opts.description
+      });
     }
     await new Promise((r) => setTimeout(r, interval));
   }

package/helpers/UserSimulationHelper.ts

@@ -63,7 +63,8 @@ export class UserSimulationHelper {
     await pollUntil(() => this.getSimulatedUser(), {
       timeout: 5_000,
       interval: 200,
-      predicate: (val) => val === ''
+      predicate: (val) => val === '',
+      description: 'user simulation to stop and clear the simulated user'
     });
   }
 

package/interfaces/ITabTask.ts

@@ -0,0 +1,21 @@
+/**
+ * Represents a single subject+variant combination that has qualifying task
+ * buttons, as stored in `seed-data/tab-tasks.json` after the
+ * `TaskDataBuilder` pipeline step.
+ *
+ * Tasks with `custom_display_type === 4` are stripped at fetch time and never
+ * appear here. If all tasks for a subject+variant had that type, the entry is
+ * omitted entirely and that subject receives a plain `ActionBar`.
+ */
+export interface ITabTask {
+  /** Thinkwise subject identifier (matches `ISubject.subject`). */
+  subject: string;
+  /** Subject variant identifier (matches `ISubject.variant`). */
+  variant: string;
+  /**
+   * Ordered list of qualifying task IDs.
+   * Each entry becomes a named getter on the generated custom ActionBar class.
+   * e.g. `"supplier-item-add"` → `get supplierItemAddButton(): Locator`
+   */
+  tasks: string[];
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thinkwise/testwise",
-  "version": "0.2.105",
+  "version": "0.2.111",
   "main": "dist/index.js",
   "type": "module",
   "bin": {
@@ -11,6 +11,8 @@
     "lint": "eslint ./ --cache --ignore-pattern .gitignore",
     "format:fix": "run-s \"lint --fix\" && biome check --fix --unsafe",
     "format:check": "run-s \"lint \" && biome check",
+    "build": "tsc",
+    "prepack": "rimraf dist && tsc && node scripts/checkPackageContents.js",
     "postinstall": "node scripts/main.js postinstall",
     "test": "vitest run",
     "test:watch": "vitest",