@testmuai/playwright-bindings 0.1.2-beta.1 → 0.1.2-beta.3

package/dist/session.js

@@ -1,26 +1,95 @@
 import { chromium } from 'playwright';
+import { promises as fs } from 'fs';
+import { homedir } from 'os';
+import { join } from 'path';
 import { config } from './config.js';
+import * as configure from './configure.js';
 import { _getRegistry } from './test.js';
 import { createReporter } from './reporters/index.js';
 import { LTReporter } from './reporters/lt.js';
-import { _setReporter, _endDanglingStep } from './step.js';
+import { _setReporter } from './step.js';
 import { buildCapabilities, getCdpUrl, getViewport } from './capability.js';
 import { TestmuConfigError } from './errors.js';
-// Deferred: file download (_download_files) — Python downloads uploaded_files
-// via aiohttp after browser launch; no equivalent in TS scope yet.
-// Deferred: HE test-param overrides (get_test_params_override) — no testConfig
-// param-override integration in TS yet.
+import { PlaywrightRelayProxy } from './relayProxy.js';
+import { getTestParamsOverride } from './testConfig.js';
+import { setVar } from './vars.js';
+import { ltAuthHeader } from './http.js';
+import { log } from './log.js';
+import { installHealPatch } from './healPatch.js';
+// Module-level session state — exposed so helpers like executeKaneCli (M12) can
+// reach `relayUrl` to disconnect/reconnect mid-test. PY parity: _session.state.
+export const sessionState = { relay: null, relayTask: null, relayUrl: null };
+async function downloadFiles(files) {
+    const auth = ltAuthHeader();
+    if (!auth) {
+        log.helper('Cannot download files — no LT credentials');
+        return;
+    }
+    const dlDir = join(homedir(), 'Downloads');
+    await fs.mkdir(dlDir, { recursive: true });
+    for (const f of files) {
+        let url = f.media_url ?? '';
+        const name = f.name ?? '';
+        if (!url || !name)
+            continue;
+        if (!url.startsWith('http'))
+            url = `https://${url}`; // PY parity: _session.py:108-110
+        try {
+            const resp = await fetch(url, { headers: { Authorization: auth } });
+            if (!resp.ok)
+                throw new Error(`HTTP ${resp.status}`);
+            const buf = Buffer.from(await resp.arrayBuffer());
+            const dest = join(dlDir, name);
+            await fs.writeFile(dest, buf);
+            log.helper(`Downloaded: ${name} -> ${dest}`);
+        }
+        catch (e) {
+            log.helper(`Failed to download ${name}: ${String(e)}`);
+        }
+    }
+}
 async function createBrowserAndPage() {
     const caps = await buildCapabilities();
     if (config.current.runTarget === 'cloud') {
-        const browser = await chromium.connectOverCDP(getCdpUrl(caps));
-        const context = browser.contexts()[0] ?? await browser.newContext();
-        const page = context.pages()[0] ?? await context.newPage();
+        const cdpUrl = getCdpUrl(caps);
+        // Start a local relay proxy so kane-cli (M12) can hand off the browser mid-test
+        // and reconnect with state replay. PY parity: _session.py:54-62.
+        const relay = new PlaywrightRelayProxy(cdpUrl, 0);
+        const relayTask = relay.start();
+        try {
+            await relay.waitReady();
+        }
+        catch (e) {
+            // relay.start() rejected (e.g., UpstreamConnectionError). Don't leak state.
+            try {
+                relay.shutdown();
+            }
+            catch { /* ignore */ }
+            try {
+                await relayTask;
+            }
+            catch { /* ignore */ }
+            throw e;
+        }
+        sessionState.relay = relay;
+        sessionState.relayTask = relayTask;
+        sessionState.relayUrl = `ws://127.0.0.1:${relay.localPort}`;
+        log.helper(`Relay proxy listening at ${sessionState.relayUrl}`);
+        const browser = await chromium.connect(sessionState.relayUrl, { timeout: 120_000 });
+        log.helper('Connected to LT cloud via relay proxy');
+        const viewport = getViewport(process.env['LT_RESOLUTION']);
+        const headers = configure.get('customHeaders');
+        const ctxOpts = { viewport };
+        if (headers && Object.keys(headers).length)
+            ctxOpts.extraHTTPHeaders = headers;
+        const context = await browser.newContext(ctxOpts);
+        const page = await context.newPage();
         return { browser, context, page };
     }
     const headless = process.env['TESTMU_HEADLESS'] !== 'false';
     const browser = await chromium.launch({ headless });
-    const context = await browser.newContext({ viewport: getViewport(process.env['LT_RESOLUTION']) });
+    // Local: viewport unset → browser uses natural size (PY parity, _session.py:74)
+    const context = await browser.newContext({});
     const page = await context.newPage();
     return { browser, context, page };
 }
@@ -29,33 +98,78 @@ export async function run() {
         throw new TestmuConfigError('TESTMU_SMART=1 requires LT_USERNAME and LT_ACCESS_KEY. ' +
             'Smart helpers (vision, heal, kane-cli, SmartUI) need LT infrastructure.');
     }
+    // M19: diagnostic log at session start (PY parity: _session.py:126-132)
+    log.helper(`Mode: run_target=${config.current.runTarget}, ` +
+        `lt_auth=${config.current.ltAuth}, smart=${config.current.smart}`);
+    const varsCount = Object.keys(configure.get('variables')).length;
+    const paramsCount = Object.keys(configure.get('testParams')).length;
+    const globalsCount = configure.get('globalVariables').length;
+    if (varsCount || paramsCount || globalsCount) {
+        log.helper(`Variables: ${varsCount} test-level, ${paramsCount} params, ${globalsCount} globals`);
+    }
     const reporter = createReporter();
     _setReporter(reporter);
     const { browser, page } = await createBrowserAndPage();
     if (reporter instanceof LTReporter)
         reporter._setPage(page);
+    // Install vision-coordinate heal on Locator.prototype now that a Page exists.
+    // Deferred from module load because TS elides the `Locator` value-import
+    // (playwright .d.ts declares it as an interface). See healPatch.ts header.
+    installHealPatch(page);
+    // C9: download uploaded files to ~/Downloads/
+    const uploaded = configure.get('uploadedFiles');
+    if (uploaded.length) {
+        log.helper(`Downloading ${uploaded.length} uploaded file(s)...`);
+        await downloadFiles(uploaded);
+    }
+    // C11: apply HE test-run config overrides (dataset params)
+    const overrides = await getTestParamsOverride();
+    const nOverrides = Object.keys(overrides).length;
+    if (nOverrides > 0) {
+        for (const [k, v] of Object.entries(overrides))
+            setVar(k, v, { scope: 'testParams' });
+        log.helper(`Applied ${nOverrides} test param overrides from HE config`);
+    }
     try {
         for (const t of _getRegistry()) {
             await reporter.beginTest(t.name);
             try {
                 await t.fn(page);
-                await _endDanglingStep({ ok: true });
                 await reporter.passTest();
             }
             catch (e) {
-                await _endDanglingStep({ ok: false, error: e });
-                try {
-                    await reporter.attachScreenshot(await page.screenshot());
-                }
-                catch { /* swallow */ }
+                // H35 pending — PY side commented; re-enable when parity decided
+                // try { await reporter.attachScreenshot(await page.screenshot()); } catch { /* swallow */ }
                 await reporter.failTest(e);
                 throw e;
             }
         }
     }
     finally {
-        await browser.close();
+        try {
+            await browser.close();
+        }
+        catch { /* ignore */ }
+        if (sessionState.relay) {
+            try {
+                sessionState.relay.shutdown();
+                if (sessionState.relayTask) {
+                    let timer;
+                    const timeout = new Promise((_, rej) => {
+                        timer = setTimeout(() => rej(new Error('relay shutdown timeout')), 5_000);
+                    });
+                    await Promise.race([sessionState.relayTask, timeout]).catch(() => { });
+                    if (timer)
+                        clearTimeout(timer);
+                }
+            }
+            catch { /* ignore */ }
+        }
+        sessionState.relay = null;
+        sessionState.relayTask = null;
+        sessionState.relayUrl = null;
         _setReporter(null);
+        log.helper('Session closed');
     }
 }
 //# sourceMappingURL=session.js.map

package/dist/session.js.map

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

package/dist/step.d.ts

@@ -2,13 +2,30 @@ import type { Reporter } from './reporters/index.js';
 export interface StepState {
     description: string;
 }
+export interface StepOpts {
+    onFailure?: 'continue' | 'fail';
+    timeoutMs?: number;
+}
+type StepFn = () => Promise<void>;
 export declare function _setReporter(r: Reporter | null): void;
+export declare function _getReporter(): Reporter | null;
 export declare function currentStep(): StepState | null;
-export declare function step(description: string): void;
-export declare function done(): void;
-export declare function _endDanglingStep(opts?: {
-    ok: boolean;
-    error?: unknown;
-}): Promise<void>;
 export declare function _resetStep(): void;
+/**
+ * Block-scoped step boundary. Mirrors PY's `async with testmu.step(...)`.
+ *
+ * Two signatures:
+ *   step(description, async () => {...})
+ *   step(description, opts, async () => {...})
+ *
+ * Behavior:
+ *   - Sets currentStep() to {description} for the duration of fn (heal patch reads this).
+ *   - Calls reporter.beginStep(description) before fn.
+ *   - Calls reporter.endStep(description, ok) after fn — ok=true on resolve, ok=false on throw.
+ *   - Rethrows fn errors UNLESS opts.onFailure === 'continue'.
+ *   - Restores prior currentStep on exit (supports nesting; outer step resumes).
+ */
+export declare function step(description: string, fn: StepFn): Promise<void>;
+export declare function step(description: string, opts: StepOpts, fn: StepFn): Promise<void>;
+export {};
 //# sourceMappingURL=step.d.ts.map

package/dist/step.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"step.d.ts","sourceRoot":"","sources":["../src/step.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAErD,MAAM,WAAW,SAAS;IAAG,WAAW,EAAE,MAAM,CAAC;CAAE;AAKnD,wBAAgB,YAAY,CAAC,CAAC,EAAE,QAAQ,GAAG,IAAI,GAAG,IAAI,CAAmB;AACzE,wBAAgB,WAAW,IAAI,SAAS,GAAG,IAAI,CAAqB;AAEpE,wBAAgB,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAM9C;AAED,wBAAgB,IAAI,IAAI,IAAI,CAK3B;AAED,wBAAsB,gBAAgB,CAAC,IAAI,GAAE;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAW3G;AAED,wBAAgB,UAAU,IAAI,IAAI,CAAuC"}
+{"version":3,"file":"step.d.ts","sourceRoot":"","sources":["../src/step.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAErD,MAAM,WAAW,SAAS;IAAG,WAAW,EAAE,MAAM,CAAC;CAAE;AACnD,MAAM,WAAW,QAAQ;IAAG,SAAS,CAAC,EAAE,UAAU,GAAG,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE;AAEjF,KAAK,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;AAKlC,wBAAgB,YAAY,CAAC,CAAC,EAAE,QAAQ,GAAG,IAAI,GAAG,IAAI,CAAmB;AACzE,wBAAgB,YAAY,IAAI,QAAQ,GAAG,IAAI,CAAsB;AACrE,wBAAgB,WAAW,IAAI,SAAS,GAAG,IAAI,CAAqB;AACpE,wBAAgB,UAAU,IAAI,IAAI,CAAuC;AAEzE;;;;;;;;;;;;;GAaG;AACH,wBAAsB,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAC3E,wBAAsB,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC"}

package/dist/step.js

@@ -1,36 +1,32 @@
 let _current = null;
 let _reporter = null;
 export function _setReporter(r) { _reporter = r; }
+export function _getReporter() { return _reporter; }
 export function currentStep() { return _current; }
-export function step(description) {
-    if (_current !== null && _reporter) {
-        void _reporter.endStep(_current.description, true);
-    }
+export function _resetStep() { _current = null; _reporter = null; }
+export async function step(description, fnOrOpts, maybeFn) {
+    const opts = typeof fnOrOpts === 'function' ? {} : fnOrOpts;
+    const fn = typeof fnOrOpts === 'function' ? fnOrOpts : maybeFn;
+    const prev = _current;
     _current = { description };
     if (_reporter)
-        void _reporter.beginStep(description);
-}
-export function done() {
-    if (_current === null)
-        return;
-    const desc = _current.description;
-    _current = null;
-    if (_reporter)
-        void _reporter.endStep(desc, true);
-}
-export async function _endDanglingStep(opts = { ok: true }) {
-    if (_current === null)
-        return;
-    const desc = _current.description;
-    _current = null;
-    if (_reporter) {
-        if (opts.error !== undefined) {
-            await _reporter.endStep(desc, opts.ok, opts.error);
-        }
-        else {
-            await _reporter.endStep(desc, opts.ok);
-        }
+        await _reporter.beginStep(description);
+    let ok = true;
+    let thrown;
+    try {
+        await fn();
+    }
+    catch (e) {
+        ok = false;
+        thrown = e;
+    }
+    finally {
+        _current = prev;
+        if (_reporter)
+            await _reporter.endStep(description, ok, thrown);
+    }
+    if (!ok && opts.onFailure !== 'continue') {
+        throw thrown;
     }
 }
-export function _resetStep() { _current = null; _reporter = null; }
 //# sourceMappingURL=step.js.map

package/dist/step.js.map

@@ -1 +1 @@
-{"version":3,"file":"step.js","sourceRoot":"","sources":["../src/step.ts"],"names":[],"mappings":"AAIA,IAAI,QAAQ,GAAqB,IAAI,CAAC;AACtC,IAAI,SAAS,GAAoB,IAAI,CAAC;AAEtC,MAAM,UAAU,YAAY,CAAC,CAAkB,IAAU,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC;AACzE,MAAM,UAAU,WAAW,KAAuB,OAAO,QAAQ,CAAC,CAAC,CAAC;AAEpE,MAAM,UAAU,IAAI,CAAC,WAAmB;IACtC,IAAI,QAAQ,KAAK,IAAI,IAAI,SAAS,EAAE,CAAC;QACnC,KAAK,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;IACrD,CAAC;IACD,QAAQ,GAAG,EAAE,WAAW,EAAE,CAAC;IAC3B,IAAI,SAAS;QAAE,KAAK,SAAS,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;AACvD,CAAC;AAED,MAAM,UAAU,IAAI;IAClB,IAAI,QAAQ,KAAK,IAAI;QAAE,OAAO;IAC9B,MAAM,IAAI,GAAG,QAAQ,CAAC,WAAW,CAAC;IAClC,QAAQ,GAAG,IAAI,CAAC;IAChB,IAAI,SAAS;QAAE,KAAK,SAAS,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;AACpD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,OAAyC,EAAE,EAAE,EAAE,IAAI,EAAE;IAC1F,IAAI,QAAQ,KAAK,IAAI;QAAE,OAAO;IAC9B,MAAM,IAAI,GAAG,QAAQ,CAAC,WAAW,CAAC;IAClC,QAAQ,GAAG,IAAI,CAAC;IAChB,IAAI,SAAS,EAAE,CAAC;QACd,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YAC7B,MAAM,SAAS,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QACrD,CAAC;aAAM,CAAC;YACN,MAAM,SAAS,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;QACzC,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,UAAU,UAAU,KAAW,QAAQ,GAAG,IAAI,CAAC,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC,CAAC"}
+{"version":3,"file":"step.js","sourceRoot":"","sources":["../src/step.ts"],"names":[],"mappings":"AAOA,IAAI,QAAQ,GAAqB,IAAI,CAAC;AACtC,IAAI,SAAS,GAAoB,IAAI,CAAC;AAEtC,MAAM,UAAU,YAAY,CAAC,CAAkB,IAAU,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC;AACzE,MAAM,UAAU,YAAY,KAAsB,OAAO,SAAS,CAAC,CAAC,CAAC;AACrE,MAAM,UAAU,WAAW,KAAuB,OAAO,QAAQ,CAAC,CAAC,CAAC;AACpE,MAAM,UAAU,UAAU,KAAW,QAAQ,GAAG,IAAI,CAAC,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC,CAAC;AAkBzE,MAAM,CAAC,KAAK,UAAU,IAAI,CACxB,WAAmB,EACnB,QAA2B,EAC3B,OAAgB;IAEhB,MAAM,IAAI,GAAa,OAAO,QAAQ,KAAK,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC;IACtE,MAAM,EAAE,GAAW,OAAO,QAAQ,KAAK,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAE,OAAkB,CAAC;IAEnF,MAAM,IAAI,GAAG,QAAQ,CAAC;IACtB,QAAQ,GAAG,EAAE,WAAW,EAAE,CAAC;IAC3B,IAAI,SAAS;QAAE,MAAM,SAAS,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;IAEtD,IAAI,EAAE,GAAG,IAAI,CAAC;IACd,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,EAAE,EAAE,CAAC;IACb,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,EAAE,GAAG,KAAK,CAAC;QACX,MAAM,GAAG,CAAC,CAAC;IACb,CAAC;YAAS,CAAC;QACT,QAAQ,GAAG,IAAI,CAAC;QAChB,IAAI,SAAS;YAAE,MAAM,SAAS,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,EAAE,MAAM,CAAC,CAAC;IAClE,CAAC;IAED,IAAI,CAAC,EAAE,IAAI,IAAI,CAAC,SAAS,KAAK,UAAU,EAAE,CAAC;QACzC,MAAM,MAAM,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/vars.d.ts

@@ -1,18 +1,16 @@
 /**
  * Variable resolution for testmu.
  *
- * v(template) resolves {{...}} and ${...} placeholders:
+ * resolveVar(template) — single async entry point. Resolves:
  * - Pure {{x}} → direct lookup from userStore (type-preserving); unresolved → ""
  * - Embedded "prefix {{x}} suffix" → string interpolation; unresolved → ""
- * - ${x} → testParams lookup, then userStore fallback (type-preserving when pure)
- * - Non-string / non-template values → returned as-is
- *
- * vAsync(template) additionally resolves:
+ * - ${x} → testParams lookup, then userStore fallback
+ * - {{smart.X}} → local computation (no HTTP)
  * - {{global.X}} → ATMS API or TESTMU_VAR_X env fallback
  * - {{environment.X}} → ATMS API (with ENVIRONMENT_ID) or TESTMU_VAR_X env fallback
  * - {{secrets.cat.KEY}} → process.env[KEY]
- * - {{smart.X}} → local computation (no HTTP)
- * - plain {{x}} / ${x} → delegates to sync v()
+ * - {{totp.X}} → ATMS seed + TOTP compute
+ * - Non-string / non-template values → returned as-is
  */
 /** Shape of an entry in the global-variables list (populated by configure() in Task 15). */
 export interface GlobalVariable {
@@ -39,23 +37,14 @@ export declare function _getUserStore(): Record<string, unknown>;
 /** Append a global variable entry (called by configure() in Task 15). */
 export declare function _addGlobalVariable(g: GlobalVariable): void;
 /**
- * Resolve a template value.
- *
- * - Non-string → returned as-is.
- * - No {{...}} or ${...} → returned as-is.
- * - Pure {{x}} → type-preserving lookup; unresolved → "".
- * - Pure ${x} → testParams then userStore lookup; unresolved → "".
- * - Embedded (contains other text) → string interpolation; unresolved → "".
- */
-export declare function v<T = unknown>(template: unknown, opts?: VOptions): T;
-/**
- * Async variable resolution — extends v() with HTTP-backed lookups.
+ * Resolve a template value (async — handles both local and HTTP-backed lookups).
  *
  * - {{global.X}} → ATMS or TESTMU_VAR_X fallback
  * - {{environment.X}} → ATMS (with ENVIRONMENT_ID) or TESTMU_VAR_X fallback
  * - {{secrets.cat.KEY}} → process.env[KEY]
+ * - {{totp.X}} → ATMS seed + TOTP compute
  * - {{smart.X}} → local computation (no HTTP)
- * - plain {{x}} / ${x} → delegates to sync v()
+ * - plain {{x}} / ${x} / no template → delegates to module-private _resolveSync
  */
-export declare function vAsync<T = unknown>(template: unknown, opts?: VOptions): Promise<T>;
+export declare function resolveVar<T = unknown>(template: unknown, opts?: VOptions): Promise<T>;
 //# sourceMappingURL=vars.d.ts.map

package/dist/vars.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"vars.d.ts","sourceRoot":"","sources":["../src/vars.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAaH,4FAA4F;AAC5F,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,OAAO,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAyBD,MAAM,MAAM,SAAS,GACjB,OAAO,GACP,OAAO,GACP,MAAM,GACN,KAAK,GACL,KAAK,GACL,OAAO,GACP,MAAM,CAAC;AAgCX,MAAM,WAAW,QAAQ;IACvB,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,EAAE,MAAM,GAAG,YAAY,CAAC;CAC/B;AAED,6EAA6E;AAC7E,wBAAgB,MAAM,CACpB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,OAAO,EACd,IAAI,GAAE,aAAkB,GACvB,IAAI,CAON;AAED,sCAAsC;AACtC,wBAAgB,WAAW,IAAI,IAAI,CAIlC;AAED,8CAA8C;AAC9C,wBAAgB,mBAAmB,IAAI,SAAS,cAAc,EAAE,CAE/D;AAED,kFAAkF;AAClF,wBAAgB,aAAa,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEvD;AAED,yEAAyE;AACzE,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,cAAc,GAAG,IAAI,CAE1D;AAED;;;;;;;;GAQG;AACH,wBAAgB,CAAC,CAAC,CAAC,GAAG,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,GAAE,QAAa,GAAG,CAAC,CA8CxE;AAqdD;;;;;;;;GAQG;AACH,wBAAsB,MAAM,CAAC,CAAC,GAAG,OAAO,EACtC,QAAQ,EAAE,OAAO,EACjB,IAAI,GAAE,QAAa,GAClB,OAAO,CAAC,CAAC,CAAC,CA0EZ"}
+{"version":3,"file":"vars.d.ts","sourceRoot":"","sources":["../src/vars.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAmBH,4FAA4F;AAC5F,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,OAAO,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAyBD,MAAM,MAAM,SAAS,GACjB,OAAO,GACP,OAAO,GACP,MAAM,GACN,KAAK,GACL,KAAK,GACL,OAAO,GACP,MAAM,CAAC;AAgCX,MAAM,WAAW,QAAQ;IACvB,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,EAAE,MAAM,GAAG,YAAY,CAAC;CAC/B;AAED,6EAA6E;AAC7E,wBAAgB,MAAM,CACpB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,OAAO,EACd,IAAI,GAAE,aAAkB,GACvB,IAAI,CASN;AAED,sCAAsC;AACtC,wBAAgB,WAAW,IAAI,IAAI,CAIlC;AAED,8CAA8C;AAC9C,wBAAgB,mBAAmB,IAAI,SAAS,cAAc,EAAE,CAE/D;AAED,kFAAkF;AAClF,wBAAgB,aAAa,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEvD;AAED,yEAAyE;AACzE,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,cAAc,GAAG,IAAI,CAE1D;AAohBD;;;;;;;;;GASG;AACH,wBAAsB,UAAU,CAAC,CAAC,GAAG,OAAO,EAC1C,QAAQ,EAAE,OAAO,EACjB,IAAI,GAAE,QAAa,GAClB,OAAO,CAAC,CAAC,CAAC,CA6FZ"}

package/dist/vars.js

@@ -1,22 +1,25 @@
 /**
  * Variable resolution for testmu.
  *
- * v(template) resolves {{...}} and ${...} placeholders:
+ * resolveVar(template) — single async entry point. Resolves:
  * - Pure {{x}} → direct lookup from userStore (type-preserving); unresolved → ""
  * - Embedded "prefix {{x}} suffix" → string interpolation; unresolved → ""
- * - ${x} → testParams lookup, then userStore fallback (type-preserving when pure)
- * - Non-string / non-template values → returned as-is
- *
- * vAsync(template) additionally resolves:
+ * - ${x} → testParams lookup, then userStore fallback
+ * - {{smart.X}} → local computation (no HTTP)
  * - {{global.X}} → ATMS API or TESTMU_VAR_X env fallback
  * - {{environment.X}} → ATMS API (with ENVIRONMENT_ID) or TESTMU_VAR_X env fallback
  * - {{secrets.cat.KEY}} → process.env[KEY]
- * - {{smart.X}} → local computation (no HTTP)
- * - plain {{x}} / ${x} → delegates to sync v()
+ * - {{totp.X}} → ATMS seed + TOTP compute
+ * - Non-string / non-template values → returned as-is
  */
 import { authenticator } from "otplib";
 import { fetchWithAuth, ltAuthHeader } from "./http.js";
-import { _registerConfigureHook } from "./configure.js";
+import { _registerConfigureHook, get as getConfig } from "./configure.js";
+import { log, preview } from "./log.js";
+/** Mirrors PY _is_sensitive_template: only secrets/totp warrant redaction. */
+function _isSensitiveTemplate(templateStr) {
+    return templateStr.includes("{{secrets.") || templateStr.includes("{{totp.");
+}
 // ---------------------------------------------------------------------------
 // Internal stores (module-level singletons, reset via _resetStore())
 // ---------------------------------------------------------------------------
@@ -65,6 +68,8 @@ function applyTransform(value, t) {
 }
 /** Store a variable value into the given scope (default: user variables). */
 export function setVar(name, value, opts = {}) {
+    // PY parity: _vars.py set_var → "[set_var] name=%r value=%s"
+    log.helper(`[set_var] name='${name}' value=${preview(value)}`);
     const scope = opts.scope ?? "user";
     if (scope === "testParams") {
         testParamsStore.set(name, value);
@@ -92,7 +97,8 @@ export function _addGlobalVariable(g) {
     globalVariables.push(g);
 }
 /**
- * Resolve a template value.
+ * Module-private synchronous resolver — used internally by resolveVar for
+ * non-ATMS fast paths. Not exported.
  *
  * - Non-string → returned as-is.
  * - No {{...}} or ${...} → returned as-is.
@@ -100,7 +106,7 @@ export function _addGlobalVariable(g) {
  * - Pure ${x} → testParams then userStore lookup; unresolved → "".
  * - Embedded (contains other text) → string interpolation; unresolved → "".
  */
-export function v(template, opts = {}) {
+function _resolveSync(template, opts = {}) {
     // Non-string: pass through unchanged (JS idiom — differs from Python's None→"")
     if (typeof template !== "string")
         return template;
@@ -472,10 +478,11 @@ function lookupTestParams(name) {
  *
  * Matches Python _atms_get_variable: always includes environment_id (0 for global).
  * Response: resp.json()["data"] — then .value from that dict.
- * ATMS_URL has no default (empty string if unset) — mirrors Python.
+ * ATMS_URL defaults to https://test-manager-api.lambdatest.com when env var
+ * unset (matches Python _vars.py:391,405). Cloud (HE) overrides via injection.
  */
 async function atmsGetVariable(name, environmentId = 0) {
-    const base = (process.env["ATMS_URL"] ?? "").replace(/\/$/, "");
+    const base = (process.env["ATMS_URL"] ?? "https://test-manager-api.lambdatest.com").replace(/\/$/, "");
     const url = `${base}/api/v1/variables/${encodeURIComponent(name)}?environment_id=${environmentId}`;
     const resp = await fetchWithAuth(url, { method: "GET" });
     if (!resp.ok)
@@ -519,7 +526,11 @@ async function resolveSpecialAsync(name) {
             return envVal;
         }
         try {
-            const envId = parseInt(process.env["ENVIRONMENT_ID"] ?? "0", 10);
+            // env var wins, then configure(environmentId), then 0 — matches PY _vars.py:227.
+            const envFromProc = process.env["ENVIRONMENT_ID"];
+            const envId = (envFromProc !== undefined && envFromProc !== "")
+                ? parseInt(envFromProc, 10)
+                : Number(getConfig("environmentId") || 0);
             return await atmsGetVariable(varName, envId);
         }
         catch (err) {
@@ -553,7 +564,7 @@ async function resolveSpecialAsync(name) {
         }
         else {
             // GET {ATMS_URL}/api/v1/variables/totp/{name} — resp.json()["data"] is the seed string
-            const base = (process.env["ATMS_URL"] ?? "").replace(/\/$/, "");
+            const base = (process.env["ATMS_URL"] ?? "https://test-manager-api.lambdatest.com").replace(/\/$/, "");
             const url = `${base}/api/v1/variables/totp/${encodeURIComponent(varName)}`;
             const resp = await fetchWithAuth(url, { method: "GET" });
             if (!resp.ok)
@@ -566,17 +577,22 @@ async function resolveSpecialAsync(name) {
     throw new Error(`Unknown special variable prefix: ${name}`);
 }
 /**
- * Async variable resolution — extends v() with HTTP-backed lookups.
+ * Resolve a template value (async — handles both local and HTTP-backed lookups).
  *
  * - {{global.X}} → ATMS or TESTMU_VAR_X fallback
  * - {{environment.X}} → ATMS (with ENVIRONMENT_ID) or TESTMU_VAR_X fallback
  * - {{secrets.cat.KEY}} → process.env[KEY]
+ * - {{totp.X}} → ATMS seed + TOTP compute
  * - {{smart.X}} → local computation (no HTTP)
- * - plain {{x}} / ${x} → delegates to sync v()
+ * - plain {{x}} / ${x} / no template → delegates to module-private _resolveSync
  */
-export async function vAsync(template, opts = {}) {
-    if (typeof template !== "string")
+export async function resolveVar(template, opts = {}) {
+    if (typeof template !== "string") {
+        // PY parity: _log.info("    [var] template=None → ''") — JS emits typeof
+        log.helper(`[var] template=${template === null ? "null" : typeof template} → passthrough`);
         return template;
+    }
+    const sensitive = _isSensitiveTemplate(template);
     let result;
     // Pure single-placeholder: {{name}}
     const pureName = extractPure(template, MUSTACHE_RE);
@@ -591,19 +607,33 @@ export async function vAsync(template, opts = {}) {
             result = await resolveSpecialAsync(pureName);
         }
         else {
-            // Delegate to sync v() for plain variables (without transform — apply below)
-            result = v(template);
+            // Delegate to sync path for plain variables (transform applied below).
+            result = _resolveSync(template);
+        }
+        {
+            const finalResult = opts.transform ? applyTransform(result, opts.transform) : result;
+            const resolvedPreview = sensitive ? "[REDACTED]" : preview(finalResult);
+            const transformSuffix = opts.transform !== undefined ? ` transform=${opts.transform}` : "";
+            log.helper(`[var] ${preview(template)} → ${resolvedPreview}${transformSuffix}`);
+            return finalResult;
         }
-        return (opts.transform ? applyTransform(result, opts.transform) : result);
     }
-    // Pure ${x} — delegate sync (without transform — apply below)
+    // Pure ${x} — delegate sync (transform applied below).
     const pureDollar = extractPure(template, DOLLAR_RE);
     if (pureDollar !== null) {
-        result = v(template);
-        return (opts.transform ? applyTransform(result, opts.transform) : result);
+        result = _resolveSync(template);
+        {
+            const finalResult = opts.transform ? applyTransform(result, opts.transform) : result;
+            const resolvedPreview = sensitive ? "[REDACTED]" : preview(finalResult);
+            const transformSuffix = opts.transform !== undefined ? ` transform=${opts.transform}` : "";
+            log.helper(`[var] ${preview(template)} → ${resolvedPreview}${transformSuffix}`);
+            return finalResult;
+        }
     }
     // Embedded template — resolve {{...}} placeholders asynchronously
     if (!MUSTACHE_RE.test(template) && !DOLLAR_RE.test(template)) {
+        // No placeholders → passthrough; log type-preserving exit.
+        log.helper(`[var] ${preview(template)} → ${sensitive ? "[REDACTED]" : preview(template)} (no-op)`);
         return template;
     }
     const matches = [...template.matchAll(MUSTACHE_RE_G)];
@@ -620,7 +650,7 @@ export async function vAsync(template, opts = {}) {
             replacements.push(await resolveSpecialAsync(inner));
         }
         else {
-            const sync = v(`{{${inner}}}`);
+            const sync = _resolveSync(`{{${inner}}}`);
             replacements.push(sync === "" ? "" : String(sync));
         }
     }
@@ -634,7 +664,13 @@ export async function vAsync(template, opts = {}) {
         return val === "" ? "" : String(val);
     });
     result = out;
-    return (opts.transform ? applyTransform(result, opts.transform) : result);
+    {
+        const finalResult = opts.transform ? applyTransform(result, opts.transform) : result;
+        const resolvedPreview = sensitive ? "[REDACTED]" : preview(finalResult);
+        const transformSuffix = opts.transform !== undefined ? ` transform=${opts.transform}` : "";
+        log.helper(`[var] ${preview(template)} → ${resolvedPreview}${transformSuffix}`);
+        return finalResult;
+    }
 }
 // ---------------------------------------------------------------------------
 // configure() → vars store wiring (registered once at module load)