@testingbot/mobilewright-driver 0.1.0

package/dist/keys.js

@@ -0,0 +1,117 @@
+/**
+ * Key-chord handling for pressKeys()/clearText(). Chords look like
+ * "ctrl+a", "backspace", "meta+shift+z".
+ *
+ * Android: translated to `mobile: pressKey` keycodes + metastate.
+ * iOS: translated to W3C key action sequences with WebDriver unicode keys.
+ */
+export function parseChord(chord) {
+    // A trailing '+' segment means the literal plus key ("ctrl++", "+").
+    const literalPlus = chord === '+' || chord.endsWith('++') || chord.endsWith('+ ');
+    const parts = chord.split('+').map((p) => p.trim()).filter(Boolean);
+    const key = literalPlus ? '+' : (parts.pop() ?? '');
+    return { modifiers: parts.map((m) => normalizeModifier(m)), key: key.toLowerCase() };
+}
+function normalizeModifier(mod) {
+    const m = mod.toLowerCase();
+    if (m === 'cmd' || m === 'command' || m === 'meta')
+        return 'meta';
+    if (m === 'ctrl' || m === 'control')
+        return 'ctrl';
+    if (m === 'alt' || m === 'option')
+        return 'alt';
+    return m;
+}
+// ─── Android (mobile: pressKey) ─────────────────────────────────
+const ANDROID_KEYCODES = {
+    home: 3,
+    back: 4,
+    call: 5,
+    endcall: 6,
+    up: 19, down: 20, left: 21, right: 22,
+    volumeup: 24, volumedown: 25,
+    power: 26,
+    camera: 27,
+    tab: 61,
+    space: 62,
+    enter: 66,
+    backspace: 67,
+    delete: 112,
+    escape: 111,
+    menu: 82,
+    search: 84,
+    pageup: 92, pagedown: 93,
+    appswitch: 187,
+};
+const ANDROID_META = {
+    shift: 1, // META_SHIFT_ON
+    alt: 2, // META_ALT_ON
+    ctrl: 4096, // META_CTRL_ON
+    meta: 65536, // META_META_ON
+};
+export function toAndroidKeyPress(chord) {
+    let keycode = ANDROID_KEYCODES[chord.key];
+    if (keycode === undefined && /^[a-z]$/.test(chord.key)) {
+        keycode = 29 + (chord.key.charCodeAt(0) - 97); // KEYCODE_A = 29
+    }
+    if (keycode === undefined && /^[0-9]$/.test(chord.key)) {
+        keycode = 7 + (chord.key.charCodeAt(0) - 48); // KEYCODE_0 = 7
+    }
+    if (keycode === undefined) {
+        throw new Error(`TestingBotDriver: unsupported key "${chord.key}" on Android`);
+    }
+    const metastate = chord.modifiers.reduce((acc, mod) => {
+        const bit = ANDROID_META[mod];
+        if (bit === undefined)
+            throw new Error(`TestingBotDriver: unsupported modifier "${mod}" on Android`);
+        return acc | bit;
+    }, 0);
+    return metastate ? { keycode, metastate } : { keycode };
+}
+// ─── iOS (W3C key actions) ──────────────────────────────────────
+const W3C_KEYS = {
+    shift: '\uE008',
+    ctrl: '\uE009',
+    alt: '\uE00A',
+    meta: '\uE03D',
+    enter: '\uE007',
+    tab: '\uE004',
+    space: ' ',
+    backspace: '\uE003',
+    delete: '\uE017',
+    escape: '\uE00C',
+    up: '\uE013', down: '\uE015', left: '\uE012', right: '\uE014',
+    pageup: '\uE00E', pagedown: '\uE00F',
+    home: '\uE011', end: '\uE010',
+};
+/** Build one W3C key-input source pressing the given chords in order. */
+export function toW3CKeyActions(chords) {
+    const actions = [];
+    for (const chord of chords) {
+        const modifierKeys = chord.modifiers.map((mod) => {
+            const key = W3C_KEYS[mod];
+            if (!key)
+                throw new Error(`TestingBotDriver: unsupported modifier "${mod}"`);
+            return key;
+        });
+        const key = W3C_KEYS[chord.key] ?? (chord.key.length === 1 ? chord.key : undefined);
+        if (key === undefined) {
+            throw new Error(`TestingBotDriver: unsupported key "${chord.key}"`);
+        }
+        for (const mod of modifierKeys)
+            actions.push({ type: 'keyDown', value: mod });
+        actions.push({ type: 'keyDown', value: key }, { type: 'keyUp', value: key });
+        for (const mod of [...modifierKeys].reverse())
+            actions.push({ type: 'keyUp', value: mod });
+    }
+    return [{ type: 'key', id: 'keyboard', actions }];
+}
+/** Type plain text as a W3C key-input source (per-character down/up). */
+export function typeTextActions(text) {
+    const actions = [];
+    for (const ch of text) {
+        actions.push({ type: 'keyDown', value: ch }, { type: 'keyUp', value: ch });
+    }
+    return [{ type: 'key', id: 'keyboard', actions }];
+}
+//# sourceMappingURL=keys.js.map

package/dist/keys.js.map

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

package/dist/observer.d.ts

@@ -0,0 +1,55 @@
+import type { RunResultInfo, TestInfo, TestObserver, TestResultInfo, TestRunInfo } from '@mobilewright/protocol';
+import type { RestApiClient } from './rest-api.js';
+export interface ReportableSession {
+    sessionId: string;
+    /** Connect/disconnect cycles (= tests) recorded for this session. */
+    spans: number;
+    /** Wall-clock bounds of the recorded cycles, when any exist. */
+    startedAt?: number;
+    endedAt?: number;
+}
+export interface ObserverContext {
+    /** Every TestingBot session of this run (allocated + worker-rotated). */
+    sessions(): ReportableSession[];
+    build?: string;
+    /** Local-video requests made via startRecording({ output }). */
+    recordings?(): {
+        sessionId: string;
+        output: string;
+    }[];
+}
+/**
+ * Reports outcomes to TestingBot. Sessions whose wall-clock interval maps to
+ * exactly one test (sessionPerTest mode) get that test's name and verdict;
+ * everything else — reused pool sessions hosting many tests, or ambiguous
+ * overlaps under high concurrency — gets the run-level verdict. Strictly
+ * best-effort: reporting failures never fail the test run.
+ */
+export declare class TestingBotTestObserver implements TestObserver {
+    private readonly api;
+    private readonly context;
+    private totalTests;
+    /** Final outcome per test id — onTestEnd fires once per ATTEMPT, and a
+     *  later retry overwrites the earlier attempt's result. */
+    private readonly outcomes;
+    constructor(api: RestApiClient, context: ObserverContext);
+    onRunStart(run: TestRunInfo): void;
+    onTestEnd(test: TestInfo, result: TestResultInfo): void;
+    onRunEnd(result: RunResultInfo): Promise<void>;
+    /**
+     * Fetch session videos requested via startRecording({ output }). The MP4
+     * finalizes only after the session ends, so this waits (bounded) for the
+     * asset to appear. Best-effort like all reporting.
+     */
+    private downloadRecordings;
+    /**
+     * The single test that ran inside this session, when unambiguous.
+     * Direction matters: connect() and disconnect() happen INSIDE the test, so
+     * the session interval is a sub-interval of its test's — but a test's
+     * reported duration also covers fixture setup (device allocation), so the
+     * test interval is much wider than the session's. The session midpoint must
+     * therefore be looked up in the test intervals, never the other way around.
+     */
+    private testForSession;
+}
+//# sourceMappingURL=observer.d.ts.map

package/dist/observer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observer.d.ts","sourceRoot":"","sources":["../src/observer.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,aAAa,EACb,QAAQ,EACR,YAAY,EACZ,cAAc,EACd,WAAW,EACZ,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAInD,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,qEAAqE;IACrE,KAAK,EAAE,MAAM,CAAC;IACd,gEAAgE;IAChE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,yEAAyE;IACzE,QAAQ,IAAI,iBAAiB,EAAE,CAAC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gEAAgE;IAChE,UAAU,CAAC,IAAI;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CACxD;AAWD;;;;;;GAMG;AACH,qBAAa,sBAAuB,YAAW,YAAY;IACzD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAgB;IACpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkB;IAC1C,OAAO,CAAC,UAAU,CAAK;IACvB;+DAC2D;IAC3D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkC;gBAE/C,GAAG,EAAE,aAAa,EAAE,OAAO,EAAE,eAAe;IAKxD,UAAU,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI;IAKlC,SAAS,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,cAAc,GAAG,IAAI;IAajD,QAAQ,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IA2CpD;;;;OAIG;YACW,kBAAkB;IAoChC;;;;;;;OAOG;IACH,OAAO,CAAC,cAAc;CAgBvB"}

package/dist/observer.js

@@ -0,0 +1,148 @@
+import { writeFile } from 'node:fs/promises';
+import createDebug from 'debug';
+const debug = createDebug('testingbot:observer');
+/**
+ * Reports outcomes to TestingBot. Sessions whose wall-clock interval maps to
+ * exactly one test (sessionPerTest mode) get that test's name and verdict;
+ * everything else — reused pool sessions hosting many tests, or ambiguous
+ * overlaps under high concurrency — gets the run-level verdict. Strictly
+ * best-effort: reporting failures never fail the test run.
+ */
+export class TestingBotTestObserver {
+    api;
+    context;
+    totalTests = 0;
+    /** Final outcome per test id — onTestEnd fires once per ATTEMPT, and a
+     *  later retry overwrites the earlier attempt's result. */
+    outcomes = new Map();
+    constructor(api, context) {
+        this.api = api;
+        this.context = context;
+    }
+    onRunStart(run) {
+        this.totalTests = run.totalTests;
+        debug('run started: %d tests', run.totalTests);
+    }
+    onTestEnd(test, result) {
+        const failed = result.status === 'failed' || result.status === 'timedOut' || result.status === 'interrupted';
+        const error = result.errors[0]?.split('\n')[0] ?? result.status;
+        const endedAt = Date.now();
+        this.outcomes.set(test.id, {
+            title: test.title,
+            failed,
+            summary: failed ? `${test.title}: ${error}`.slice(0, 200) : undefined,
+            startedAt: endedAt - result.duration,
+            endedAt,
+        });
+    }
+    async onRunEnd(result) {
+        if (this.outcomes.size === 0) {
+            // No test finished (e.g. "mobilewright test --list" fires onRunStart
+            // and onRunEnd without any tests running) — don't report, especially
+            // not to stale run-file sessions. Skipped tests still produce outcomes.
+            return;
+        }
+        const success = result.status === 'passed';
+        const outcomes = [...this.outcomes.values()];
+        const failures = outcomes.filter((o) => o.failed).map((o) => o.summary).filter(Boolean).slice(0, 10);
+        const runMessage = success
+            ? `${outcomes.length}/${this.totalTests} tests passed`
+            : `${failures.length} of ${outcomes.length} tests failed. ${failures.join(' | ')}`.slice(0, 500);
+        const sessions = this.context.sessions();
+        debug('run ended (%s), reporting to %d session(s)', result.status, sessions.length);
+        for (const session of sessions) {
+            const test = this.testForSession(session, outcomes);
+            try {
+                await this.api.updateTest(session.sessionId, test
+                    ? {
+                        success: !test.failed,
+                        name: test.title,
+                        statusMessage: test.failed ? (test.summary ?? 'failed') : 'passed',
+                        build: this.context.build,
+                        groups: ['mobilewright'],
+                    }
+                    : {
+                        success,
+                        statusMessage: runMessage,
+                        build: this.context.build,
+                        groups: ['mobilewright'],
+                    });
+                debug('reported %s -> %s', session.sessionId, test ? `test "${test.title}"` : `run success=${success}`);
+            }
+            catch (err) {
+                // Never fail the run over reporting.
+                console.warn(`TestingBotDriver: could not report result for session ${session.sessionId}: ${String(err)}`);
+            }
+        }
+        await this.downloadRecordings();
+    }
+    /**
+     * Fetch session videos requested via startRecording({ output }). The MP4
+     * finalizes only after the session ends, so this waits (bounded) for the
+     * asset to appear. Best-effort like all reporting.
+     */
+    async downloadRecordings() {
+        const requests = this.context.recordings?.() ?? [];
+        const deadline = Date.now() + 120_000;
+        for (const request of requests) {
+            try {
+                let videoUrl;
+                for (;;) {
+                    const test = await this.api.getTest(request.sessionId);
+                    if (test.video === false) {
+                        // Video was disabled for this session — waiting will not help.
+                        break;
+                    }
+                    // assets_available is the API's "processing finished" signal; a
+                    // populated video URL alone also suffices (the URL is presigned,
+                    // so it is fetched right away below).
+                    if ((test.assets_available ?? true) && typeof test.video === 'string' && test.video) {
+                        videoUrl = test.video;
+                        break;
+                    }
+                    if (Date.now() >= deadline)
+                        break;
+                    await new Promise((resolve) => setTimeout(resolve, 3_000));
+                }
+                if (!videoUrl) {
+                    console.warn(`TestingBotDriver: video for session ${request.sessionId} is unavailable (disabled or not ready in time); skipping ${request.output}`);
+                    continue;
+                }
+                const response = await fetch(videoUrl, { signal: AbortSignal.timeout(60_000) });
+                if (!response.ok)
+                    throw new Error(`HTTP ${response.status}`);
+                await writeFile(request.output, Buffer.from(await response.arrayBuffer()));
+                debug('saved recording of %s to %s', request.sessionId, request.output);
+            }
+            catch (err) {
+                console.warn(`TestingBotDriver: could not download video for session ${request.sessionId}: ${String(err)}`);
+            }
+        }
+    }
+    /**
+     * The single test that ran inside this session, when unambiguous.
+     * Direction matters: connect() and disconnect() happen INSIDE the test, so
+     * the session interval is a sub-interval of its test's — but a test's
+     * reported duration also covers fixture setup (device allocation), so the
+     * test interval is much wider than the session's. The session midpoint must
+     * therefore be looked up in the test intervals, never the other way around.
+     */
+    testForSession(session, outcomes) {
+        // A session that hosted several tests has no single correct name/verdict.
+        if (session.spans !== 1)
+            return undefined;
+        if (session.startedAt === undefined || session.endedAt === undefined)
+            return undefined;
+        const midpoint = (session.startedAt + session.endedAt) / 2;
+        // Clock skew tolerance between the worker's stamps and ours.
+        const SLACK_MS = 2_000;
+        const containing = outcomes.filter((o) => midpoint >= o.startedAt - SLACK_MS && midpoint <= o.endedAt + SLACK_MS);
+        if (containing.length === 1)
+            return containing[0];
+        if (containing.length > 1) {
+            debug('%d tests overlap session %s — falling back to the run verdict', containing.length, session.sessionId);
+        }
+        return undefined;
+    }
+}
+//# sourceMappingURL=observer.js.map

package/dist/observer.js.map

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

package/dist/options.d.ts

@@ -0,0 +1,154 @@
+/**
+ * Which allocations an app entry applies to. Specific keys win over
+ * platform-wide ones ('ios-real' beats 'ios').
+ */
+export type AppSlot = 'android' | 'android-emulator' | 'android-real' | 'ios' | 'ios-simulator' | 'ios-real';
+export interface TestingBotDriverOptions {
+    /**
+     * App under test per platform/device type. TestingBot sessions must start
+     * with an app (or a browser) — there is no app-less session or mid-session
+     * install — so the driver uploads these at allocation time and starts the
+     * session with `appium:app`. Values are local paths (.apk/.ipa/.zip) or
+     * existing storage URLs ("tb://...").
+     *
+     *   apps: { android: './build/app.apk', 'ios-simulator': './build/app.zip', 'ios-real': './build/app.ipa' }
+     */
+    apps?: Partial<Record<AppSlot, string>>;
+    /** TestingBot API key. Default: TESTINGBOT_KEY (or TB_KEY) env variable. */
+    key?: string;
+    /** TestingBot API secret. Default: TESTINGBOT_SECRET (or TB_SECRET) env variable. */
+    secret?: string;
+    /** WebDriver hub URL. Default: https://hub.testingbot.com/wd/hub */
+    hubUrl?: string;
+    /** REST API base URL. Default: https://api.testingbot.com/v1 */
+    apiUrl?: string;
+    /**
+     * Max time to wait for a device allocation (POST /session), in ms. The hub
+     * queues the request until a matching device frees up and gives up after
+     * 390s, so the default (395s) lets the hub's own verdict arrive first.
+     */
+    allocationTimeout?: number;
+    /** Per-WebDriver-command timeout, in ms. Default: 60000. */
+    commandTimeout?: number;
+    /**
+     * TestingBot idle timeout in seconds (`tb:options.idletimeout`). Pooled
+     * device slots sit idle between tests, so this defaults higher than
+     * TestingBot's own default of 130. Default: 230.
+     */
+    idleTimeout?: number;
+    /** TestingBot max session duration in seconds (`tb:options.maxduration`). */
+    maxDuration?: number;
+    /** Pin the Appium version TestingBot uses (`tb:options.appiumVersion`). */
+    appiumVersion?: string;
+    /** Test name shown on the TestingBot dashboard (`tb:options.name`). */
+    name?: string;
+    /**
+     * Build name for grouping sessions on the dashboard (`tb:options.build`).
+     * Defaults from the CI environment (GitHub Actions, GitLab, CircleCI,
+     * Buildkite, Bitrise, Travis, Azure, Jenkins, TeamCity — e.g.
+     * "owner/repo #123") or the TESTINGBOT_BUILD variable.
+     */
+    build?: string;
+    /** Device timezone (tz database name, e.g. "Europe/Brussels"). Default: "Etc/UTC". */
+    timeZone?: string;
+    /** Route device traffic through a proxy in this country ("DE", "US", "*" = random). */
+    geoCountryCode?: string;
+    /** Simulate network conditions: a preset ("Edge", "3G", "4G", "airplane") or custom speeds. */
+    throttleNetwork?: string | {
+        downloadSpeed: number;
+        uploadSpeed: number;
+        latency: number;
+        loss: number;
+    };
+    /** Capture a screenshot at every test step. Default: false. */
+    screenshots?: boolean;
+    /** Record a video of each session. Default: true. */
+    video?: boolean;
+    /** Command-log capture: true, false, or 'strip-parameters' (redacts request params). */
+    recordLogs?: boolean | 'strip-parameters';
+    /** Make test results publicly accessible. Default: false. */
+    public?: boolean;
+    /** Custom metadata (release, commit hash, ...) shown on the test detail page. */
+    extra?: string;
+    /** Restrict allocation to tablets only. */
+    tabletOnly?: boolean;
+    /** Restrict allocation to phones only. */
+    phoneOnly?: boolean;
+    /**
+     * Route sessions through a running TestingBot Tunnel with this identifier
+     * (`tb:options.tunnelIdentifier`). Start the tunnel yourself, or use the
+     * `tunnel` option to have the driver manage one.
+     */
+    tunnelIdentifier?: string;
+    /**
+     * Have the driver start a TestingBot Tunnel before the run and stop it
+     * afterwards, so tests can reach localhost/staging servers. Requires the
+     * optional `testingbot-tunnel-launcher` package (and Java) on the machine.
+     * Pass `true`, or an object with a tunnel `identifier` and any other
+     * testingbot-tunnel-launcher options.
+     */
+    tunnel?: boolean | ({
+        identifier?: string;
+    } & Record<string, unknown>);
+    /** Extra W3C/Appium capabilities, merged last (escape hatch). */
+    capabilities?: Record<string, unknown>;
+    /** Extra `tb:options` entries, merged last (escape hatch). */
+    tbOptions?: Record<string, unknown>;
+    /** Report pass/fail to TestingBot after the run. Default: 'on'. */
+    testResults?: 'on' | 'off';
+    /**
+     * Start a fresh TestingBot session for every test instead of reusing the
+     * device slot's session across tests. One dashboard entry, video, and
+     * pass/fail per test — at the cost of session startup time (device boot)
+     * on every test. Default: false (mobilewright's pool reuses sessions).
+     */
+    sessionPerTest?: boolean;
+}
+export interface ResolvedOptions {
+    apps: Partial<Record<AppSlot, string>>;
+    key: string;
+    secret: string;
+    hubUrl: string;
+    apiUrl: string;
+    allocationTimeout: number;
+    commandTimeout: number;
+    idleTimeout: number;
+    maxDuration: number | undefined;
+    appiumVersion: string | undefined;
+    name: string | undefined;
+    build: string | undefined;
+    timeZone: string | undefined;
+    geoCountryCode: string | undefined;
+    throttleNetwork: string | {
+        downloadSpeed: number;
+        uploadSpeed: number;
+        latency: number;
+        loss: number;
+    } | undefined;
+    screenshots: boolean | undefined;
+    video: boolean;
+    recordLogs: boolean | 'strip-parameters' | undefined;
+    public: boolean | undefined;
+    extra: string | undefined;
+    tabletOnly: boolean | undefined;
+    phoneOnly: boolean | undefined;
+    tunnelIdentifier: string | undefined;
+    tunnel: false | ({
+        identifier?: string;
+    } & Record<string, unknown>);
+    capabilities: Record<string, unknown>;
+    tbOptions: Record<string, unknown>;
+    testResults: 'on' | 'off';
+    sessionPerTest: boolean;
+}
+/**
+ * Resolve options against environment variables and defaults. Missing
+ * credentials are tolerated here (`key`/`secret` become empty strings): the
+ * config file constructing the driver is imported in every mobilewright
+ * process, so throwing from the constructor would break unrelated commands.
+ * `prepare()` fails fast instead.
+ */
+export declare function resolveOptions(options?: TestingBotDriverOptions): ResolvedOptions;
+/** Ensure credentials are present, with an actionable message when not. */
+export declare function requireCredentials(opts: ResolvedOptions): void;
+//# sourceMappingURL=options.d.ts.map

package/dist/options.d.ts.map

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

package/dist/options.js

@@ -0,0 +1,49 @@
+import { detectCiBuild } from './ci.js';
+/**
+ * Resolve options against environment variables and defaults. Missing
+ * credentials are tolerated here (`key`/`secret` become empty strings): the
+ * config file constructing the driver is imported in every mobilewright
+ * process, so throwing from the constructor would break unrelated commands.
+ * `prepare()` fails fast instead.
+ */
+export function resolveOptions(options = {}) {
+    return {
+        apps: options.apps ?? {},
+        key: options.key ?? process.env['TESTINGBOT_KEY'] ?? process.env['TB_KEY'] ?? '',
+        secret: options.secret ?? process.env['TESTINGBOT_SECRET'] ?? process.env['TB_SECRET'] ?? '',
+        hubUrl: (options.hubUrl ?? 'https://hub.testingbot.com/wd/hub').replace(/\/+$/, ''),
+        apiUrl: (options.apiUrl ?? 'https://api.testingbot.com/v1').replace(/\/+$/, ''),
+        allocationTimeout: options.allocationTimeout ?? 395_000,
+        commandTimeout: options.commandTimeout ?? 60_000,
+        idleTimeout: options.idleTimeout ?? 230,
+        maxDuration: options.maxDuration,
+        appiumVersion: options.appiumVersion,
+        name: options.name,
+        build: options.build ?? detectCiBuild(),
+        timeZone: options.timeZone,
+        geoCountryCode: options.geoCountryCode,
+        throttleNetwork: options.throttleNetwork,
+        screenshots: options.screenshots,
+        video: options.video ?? true,
+        recordLogs: options.recordLogs,
+        public: options.public,
+        extra: options.extra,
+        tabletOnly: options.tabletOnly,
+        phoneOnly: options.phoneOnly,
+        tunnelIdentifier: options.tunnelIdentifier ?? (typeof options.tunnel === 'object' ? options.tunnel.identifier : undefined),
+        tunnel: options.tunnel === true ? {} : (options.tunnel || false),
+        capabilities: options.capabilities ?? {},
+        tbOptions: options.tbOptions ?? {},
+        testResults: options.testResults ?? 'on',
+        sessionPerTest: options.sessionPerTest ?? false,
+    };
+}
+/** Ensure credentials are present, with an actionable message when not. */
+export function requireCredentials(opts) {
+    if (!opts.key || !opts.secret) {
+        throw new Error('TestingBot credentials are missing. Set TESTINGBOT_KEY and TESTINGBOT_SECRET ' +
+            'environment variables, or pass { key, secret } to new TestingBotDriver(...). ' +
+            'Find your credentials at https://testingbot.com/members/user/edit');
+    }
+}
+//# sourceMappingURL=options.js.map

package/dist/options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.js","sourceRoot":"","sources":["../src/options.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AA4IxC;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,UAAmC,EAAE;IAClE,OAAO;QACL,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,EAAE;QACxB,GAAG,EAAE,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE;QAChF,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,EAAE;QAC5F,MAAM,EAAE,CAAC,OAAO,CAAC,MAAM,IAAI,mCAAmC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;QACnF,MAAM,EAAE,CAAC,OAAO,CAAC,MAAM,IAAI,+BAA+B,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;QAC/E,iBAAiB,EAAE,OAAO,CAAC,iBAAiB,IAAI,OAAO;QACvD,cAAc,EAAE,OAAO,CAAC,cAAc,IAAI,MAAM;QAChD,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,GAAG;QACvC,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,aAAa,EAAE,OAAO,CAAC,aAAa;QACpC,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,aAAa,EAAE;QACvC,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,cAAc,EAAE,OAAO,CAAC,cAAc;QACtC,eAAe,EAAE,OAAO,CAAC,eAAe;QACxC,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,IAAI;QAC5B,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,gBAAgB,EAAE,OAAO,CAAC,gBAAgB,IAAI,CAAC,OAAO,OAAO,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC;QAC1H,MAAM,EAAE,OAAO,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,IAAI,KAAK,CAAC;QAChE,YAAY,EAAE,OAAO,CAAC,YAAY,IAAI,EAAE;QACxC,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,EAAE;QAClC,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,IAAI;QACxC,cAAc,EAAE,OAAO,CAAC,cAAc,IAAI,KAAK;KAChD,CAAC;AACJ,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,kBAAkB,CAAC,IAAqB;IACtD,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CACb,+EAA+E;YAC/E,+EAA+E;YAC/E,mEAAmE,CACpE,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/rest-api.d.ts

@@ -0,0 +1,67 @@
+import type { FetchFn } from './webdriver-client.js';
+export interface TestingBotDevice {
+    id: number;
+    name: string;
+    model_number?: string;
+    platform_name: 'Android' | 'iOS';
+    version: string | number;
+    available?: boolean;
+}
+/** One row of GET /v1/browsers — for mobile rows, a virtual device+OS combo. */
+export interface BrowserEntry {
+    name?: string;
+    platform?: string;
+    platformName?: string;
+    deviceName?: string;
+    version?: string | number;
+}
+export interface StorageEntry {
+    app_url: string;
+    state?: 'PROCESSING' | 'DONE';
+    type?: string;
+    sim_only?: boolean;
+    url?: string;
+}
+export interface TestUpdate {
+    success?: boolean;
+    name?: string;
+    statusMessage?: string;
+    build?: string;
+    extra?: string;
+    groups?: string[];
+}
+export interface TestDetails {
+    id?: number | string;
+    /** Signed S3 URL to the recording, or false when video was disabled. */
+    video?: string | false;
+    /** True once asset processing (video, logs, screenshots) has finished. */
+    assets_available?: boolean;
+    duration?: number;
+    [key: string]: unknown;
+}
+/** Client for api.testingbot.com/v1 (HTTP Basic auth with key:secret). */
+export declare class RestApiClient {
+    private readonly apiUrl;
+    private readonly auth;
+    private readonly fetchFn;
+    constructor(apiUrl: string, key: string, secret: string, fetchFn?: FetchFn);
+    /** Validate credentials; used by prepare() to fail fast. */
+    getUser(): Promise<Record<string, unknown>>;
+    /** Physical devices. `available` restricts to currently-acquirable ones. */
+    getDevices(available: boolean): Promise<TestingBotDevice[]>;
+    /** Simulator/emulator (and desktop-browser) combos; mobile rows carry platformName + deviceName + OS version. */
+    getBrowsers(): Promise<BrowserEntry[]>;
+    getDevice(id: string | number): Promise<TestingBotDevice>;
+    /** Upload an app binary; returns the storage entry with its tb:// URL. */
+    uploadApp(filePath: string): Promise<StorageEntry>;
+    getStorageEntry(appUrl: string): Promise<StorageEntry>;
+    /** Update a test by WebDriver session UUID (pass/fail, name, build, ...). */
+    updateTest(sessionId: string, update: TestUpdate): Promise<void>;
+    getTest(sessionId: string): Promise<TestDetails>;
+    /** Force-stop a running session (fallback when DELETE /session fails). */
+    stopTest(sessionId: string): Promise<void>;
+    private request;
+    private parse;
+}
+export declare function sha256(data: Buffer): string;
+//# sourceMappingURL=rest-api.d.ts.map

package/dist/rest-api.d.ts.map

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