@testingbot/mobilewright-driver 0.1.0

package/dist/capabilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.d.ts","sourceRoot":"","sources":["../src/capabilities.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,KAAK,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE7D,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;CACvC;AAED,sDAAsD;AACtD,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,+DAA+D;IAC/D,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAKD;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,IAAI,CAAC,kBAAkB,EAAE,UAAU,GAAG,YAAY,CAAC,EAC7D,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,GACrC,MAAM,GAAG,SAAS,CAQpB;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,kBAAkB,EAC5B,OAAO,EAAE,eAAe,EACxB,MAAM,CAAC,EAAE,YAAY,EACrB,MAAM,CAAC,EAAE,MAAM,GACd,eAAe,CA6FjB"}

package/dist/capabilities.js

@@ -0,0 +1,120 @@
+/** Characters that make a regex source mean something beyond its literal text. */
+const REGEX_METACHARS = /[.*+?^${}()|[\]\\]/;
+/**
+ * Pick the configured app for an allocation, most-specific key first
+ * ('ios-real' beats 'ios'). Returns the raw configured value: a local path
+ * or a tb:// / https URL (the caller uploads local paths).
+ */
+export function appForCriteria(criteria, apps) {
+    const platform = criteria.platform;
+    if (!platform)
+        return undefined;
+    if (criteria.deviceType) {
+        const specific = apps[`${platform}-${criteria.deviceType}`];
+        if (specific)
+            return specific;
+    }
+    return apps[platform];
+}
+/**
+ * Build the W3C new-session payload for a set of allocation criteria.
+ * Pure — catalog lookups and app uploads happen in the caller; a pinned
+ * device (real-device allocations) overrides name/version wildcards, and
+ * `appUrl` is the already-uploaded app under test (tb:// or https).
+ */
+export function buildCapabilities(criteria, options, pinned, appUrl) {
+    const platform = criteria.platform;
+    if (!platform) {
+        throw new Error('TestingBotDriver.allocate requires a platform ("ios" or "android"). ' +
+            'Set `platform` in your mobilewright config (top-level or per-project `use`).');
+    }
+    // A pin from the physical-device catalog (deviceId lookups) implies a real
+    // device even without deviceType; virtual-catalog pins never do.
+    const isReal = criteria.deviceType === 'real' || (criteria.deviceType === undefined && pinned?.real === true);
+    const caps = {
+        platformName: platform === 'ios' ? 'iOS' : 'Android',
+        'appium:automationName': platform === 'ios' ? 'XCUITest' : 'UiAutomator2',
+    };
+    if (appUrl)
+        caps['appium:app'] = appUrl;
+    // TestingBot has no app-less sessions: every session must start with an
+    // app or a browser. Fail here with guidance instead of a cryptic hub error.
+    const escape = options.capabilities;
+    const startsWithSomething = appUrl
+        || escape['appium:app'] || escape['app']
+        || escape['browserName'] || escape['appium:browserName'];
+    if (!startsWithSomething) {
+        throw new Error('TestingBot sessions must start with an app (or a browser). Declare the app under test in ' +
+            "the driver options — new TestingBotDriver({ apps: { " +
+            (platform === 'ios'
+                ? "'ios-simulator': './build/App.zip', 'ios-real': './build/App.ipa'"
+                : "android: './build/app.apk'") +
+            " } }) — or set 'appium:app' / 'browserName' via the capabilities escape hatch.");
+    }
+    if (pinned) {
+        caps['appium:deviceName'] = pinned.deviceName;
+        caps['appium:platformVersion'] = pinned.platformVersion;
+    }
+    else {
+        // Fallback guard: the driver resolves regex patterns via the virtual
+        // catalog before calling this, so a regex here means a direct call
+        // without resolution — only literal names can pass through to the hub.
+        if (criteria.deviceNamePattern && REGEX_METACHARS.test(criteria.deviceNamePattern)) {
+            throw new Error(`TestingBotDriver cannot resolve the deviceName pattern /${criteria.deviceNamePattern}/ for ` +
+                'simulators/emulators. Use a literal device name (e.g. deviceName: "iPhone 15"), or set ' +
+                'the exact name via the capabilities escape hatch: { capabilities: { "appium:deviceName": "..." } }.');
+        }
+        caps['appium:deviceName'] = criteria.deviceNamePattern ?? '*';
+        if (criteria.osVersion) {
+            // Fallback guard: range expressions need catalog resolution (the
+            // driver does this before calling); only plain versions/prefixes can
+            // be forwarded as platformVersion.
+            if (/[<>=\s~^]/.test(criteria.osVersion)) {
+                throw new Error(`TestingBotDriver cannot resolve the osVersion range "${criteria.osVersion}" for ` +
+                    'simulators/emulators without catalog resolution. Use an exact version (e.g. "17.0") or a prefix (e.g. "17").');
+            }
+            caps['appium:platformVersion'] = criteria.osVersion;
+        }
+    }
+    const tbOptions = {
+        key: options.key,
+        secret: options.secret,
+        realDevice: isReal,
+        screenrecorder: options.video,
+        idletimeout: options.idleTimeout,
+    };
+    if (options.maxDuration !== undefined)
+        tbOptions['maxduration'] = options.maxDuration;
+    if (options.appiumVersion !== undefined)
+        tbOptions['appiumVersion'] = options.appiumVersion;
+    if (options.timeZone !== undefined)
+        tbOptions['timeZone'] = options.timeZone;
+    if (options.geoCountryCode !== undefined)
+        tbOptions['testingbot.geoCountryCode'] = options.geoCountryCode;
+    if (options.throttleNetwork !== undefined)
+        tbOptions['throttle_network'] = options.throttleNetwork;
+    if (options.screenshots !== undefined)
+        tbOptions['screenshot'] = options.screenshots;
+    if (options.recordLogs !== undefined)
+        tbOptions['recordLogs'] = String(options.recordLogs);
+    if (options.public !== undefined)
+        tbOptions['public'] = options.public;
+    if (options.extra !== undefined)
+        tbOptions['extra'] = options.extra;
+    if (options.tabletOnly !== undefined)
+        tbOptions['tabletOnly'] = options.tabletOnly;
+    if (options.phoneOnly !== undefined)
+        tbOptions['phoneOnly'] = options.phoneOnly;
+    if (options.tunnelIdentifier !== undefined)
+        tbOptions['tunnelIdentifier'] = options.tunnelIdentifier;
+    // Always name the session so it never shows as unnamed on the dashboard;
+    // the observer renames per-test sessions to their test's title at run end.
+    tbOptions['name'] = options.name ?? 'mobilewright';
+    if (options.build !== undefined)
+        tbOptions['build'] = options.build;
+    Object.assign(tbOptions, options.tbOptions);
+    Object.assign(caps, options.capabilities);
+    caps['tb:options'] = { ...tbOptions, ...options.capabilities['tb:options'] };
+    return { alwaysMatch: caps, firstMatch: [{}] };
+}
+//# sourceMappingURL=capabilities.js.map

package/dist/capabilities.js.map

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

package/dist/ci.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Default the TestingBot `build` name from the CI environment so dashboard
+ * sessions group by pipeline run without any configuration. An explicit
+ * `build` option or TESTINGBOT_BUILD always wins. Deterministic across the
+ * coordinator and worker processes, since they share the environment.
+ */
+export declare function detectCiBuild(env?: Record<string, string | undefined>): string | undefined;
+//# sourceMappingURL=ci.d.ts.map

package/dist/ci.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ci.d.ts","sourceRoot":"","sources":["../src/ci.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAe,GAAG,MAAM,GAAG,SAAS,CA+BvG"}

package/dist/ci.js

@@ -0,0 +1,46 @@
+/**
+ * Default the TestingBot `build` name from the CI environment so dashboard
+ * sessions group by pipeline run without any configuration. An explicit
+ * `build` option or TESTINGBOT_BUILD always wins. Deterministic across the
+ * coordinator and worker processes, since they share the environment.
+ */
+export function detectCiBuild(env = process.env) {
+    if (env['TESTINGBOT_BUILD'])
+        return env['TESTINGBOT_BUILD'];
+    if (env['GITHUB_ACTIONS']) {
+        return join(env['GITHUB_REPOSITORY'], num(env['GITHUB_RUN_NUMBER']));
+    }
+    if (env['GITLAB_CI']) {
+        return join(env['CI_PROJECT_PATH'], num(env['CI_PIPELINE_IID'] ?? env['CI_PIPELINE_ID']));
+    }
+    if (env['CIRCLECI']) {
+        return join(env['CIRCLE_PROJECT_REPONAME'], num(env['CIRCLE_BUILD_NUM']));
+    }
+    if (env['BUILDKITE']) {
+        return join(env['BUILDKITE_PIPELINE_SLUG'], num(env['BUILDKITE_BUILD_NUMBER']));
+    }
+    if (env['BITRISE_IO']) {
+        return join(env['BITRISE_APP_TITLE'], num(env['BITRISE_BUILD_NUMBER']));
+    }
+    if (env['TRAVIS']) {
+        return join(env['TRAVIS_REPO_SLUG'], num(env['TRAVIS_BUILD_NUMBER']));
+    }
+    if (env['TF_BUILD']) { // Azure DevOps
+        return join(env['BUILD_DEFINITIONNAME'], env['BUILD_BUILDNUMBER']);
+    }
+    if (env['JENKINS_URL']) {
+        return join(env['JOB_NAME'], num(env['BUILD_NUMBER']));
+    }
+    if (env['TEAMCITY_VERSION']) {
+        return join(env['TEAMCITY_PROJECT_NAME'], num(env['BUILD_NUMBER']));
+    }
+    return undefined;
+}
+function num(value) {
+    return value ? `#${value}` : undefined;
+}
+function join(...parts) {
+    const present = parts.filter((p) => !!p);
+    return present.length ? present.join(' ') : undefined;
+}
+//# sourceMappingURL=ci.js.map

package/dist/ci.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ci.js","sourceRoot":"","sources":["../src/ci.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,MAA0C,OAAO,CAAC,GAAG;IACjF,IAAI,GAAG,CAAC,kBAAkB,CAAC;QAAE,OAAO,GAAG,CAAC,kBAAkB,CAAC,CAAC;IAE5D,IAAI,GAAG,CAAC,gBAAgB,CAAC,EAAE,CAAC;QAC1B,OAAO,IAAI,CAAC,GAAG,CAAC,mBAAmB,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC;IACvE,CAAC;IACD,IAAI,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC;QACrB,OAAO,IAAI,CAAC,GAAG,CAAC,iBAAiB,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,iBAAiB,CAAC,IAAI,GAAG,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC;IAC5F,CAAC;IACD,IAAI,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;QACpB,OAAO,IAAI,CAAC,GAAG,CAAC,yBAAyB,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC;IAC5E,CAAC;IACD,IAAI,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC;QACrB,OAAO,IAAI,CAAC,GAAG,CAAC,yBAAyB,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC,CAAC,CAAC;IAClF,CAAC;IACD,IAAI,GAAG,CAAC,YAAY,CAAC,EAAE,CAAC;QACtB,OAAO,IAAI,CAAC,GAAG,CAAC,mBAAmB,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC;IAC1E,CAAC;IACD,IAAI,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;QAClB,OAAO,IAAI,CAAC,GAAG,CAAC,kBAAkB,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;IACxE,CAAC;IACD,IAAI,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,eAAe;QACpC,OAAO,IAAI,CAAC,GAAG,CAAC,sBAAsB,CAAC,EAAE,GAAG,CAAC,mBAAmB,CAAC,CAAC,CAAC;IACrE,CAAC;IACD,IAAI,GAAG,CAAC,aAAa,CAAC,EAAE,CAAC;QACvB,OAAO,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;IACzD,CAAC;IACD,IAAI,GAAG,CAAC,kBAAkB,CAAC,EAAE,CAAC;QAC5B,OAAO,IAAI,CAAC,GAAG,CAAC,uBAAuB,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;IACtE,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,GAAG,CAAC,KAAyB;IACpC,OAAO,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;AACzC,CAAC;AAED,SAAS,IAAI,CAAC,GAAG,KAA6B;IAC5C,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACtD,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AACxD,CAAC"}

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,43 @@
+#!/usr/bin/env node
+import { createInterface } from 'node:readline/promises';
+import { runInit } from './init.js';
+import { VERSION } from './version.js';
+const command = process.argv[2];
+const nonInteractive = process.argv.includes('--yes') || process.argv.includes('-y') || !process.stdin.isTTY;
+async function main() {
+    if (command === 'init') {
+        const rl = nonInteractive ? undefined : createInterface({ input: process.stdin, output: process.stdout });
+        try {
+            console.log(`@testingbot/mobilewright-driver ${VERSION} — project setup\n`);
+            await runInit(process.cwd(), {
+                ask: async (question, fallback) => {
+                    if (!rl)
+                        return fallback;
+                    const answer = (await rl.question(`${question} [${fallback}]: `)).trim();
+                    return answer || fallback;
+                },
+                log: (message) => console.log(message),
+            }, !nonInteractive);
+        }
+        finally {
+            rl?.close();
+        }
+        return;
+    }
+    console.log(`@testingbot/mobilewright-driver ${VERSION}
+
+Usage:
+  npx @testingbot/mobilewright-driver init [--yes]
+
+  init   Scaffold mobilewright.config.ts and a sample test in the current
+         directory. --yes (or a non-interactive shell) accepts all defaults.
+
+Docs: https://github.com/testingbot/mobilewright-testingbot`);
+    if (command !== undefined && command !== 'help' && command !== '--help')
+        process.exitCode = 1;
+}
+main().catch((err) => {
+    console.error(String(err));
+    process.exitCode = 1;
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAChC,MAAM,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC;AAE7G,KAAK,UAAU,IAAI;IACjB,IAAI,OAAO,KAAK,MAAM,EAAE,CAAC;QACvB,MAAM,EAAE,GAAG,cAAc,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,eAAe,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;QAC1G,IAAI,CAAC;YACH,OAAO,CAAC,GAAG,CAAC,mCAAmC,OAAO,oBAAoB,CAAC,CAAC;YAC5E,MAAM,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE;gBAC3B,GAAG,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE;oBAChC,IAAI,CAAC,EAAE;wBAAE,OAAO,QAAQ,CAAC;oBACzB,MAAM,MAAM,GAAG,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,GAAG,QAAQ,KAAK,QAAQ,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;oBACzE,OAAO,MAAM,IAAI,QAAQ,CAAC;gBAC5B,CAAC;gBACD,GAAG,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC;aACvC,EAAE,CAAC,cAAc,CAAC,CAAC;QACtB,CAAC;gBAAS,CAAC;YACT,EAAE,EAAE,KAAK,EAAE,CAAC;QACd,CAAC;QACD,OAAO;IACT,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,mCAAmC,OAAO;;;;;;;;4DAQI,CAAC,CAAC;IAC5D,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,KAAK,MAAM,IAAI,OAAO,KAAK,QAAQ;QAAE,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AAChG,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3B,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC,CAAC,CAAC"}

package/dist/device-catalog.d.ts

@@ -0,0 +1,37 @@
+import { type AllocationCriteria, type DeviceInfo, type Platform } from '@mobilewright/protocol';
+import type { PinnedDevice } from './capabilities.js';
+import type { RestApiClient } from './rest-api.js';
+export declare class DeviceCatalog {
+    private readonly api;
+    private cache;
+    private virtualCache;
+    constructor(api: RestApiClient);
+    /**
+     * Pick a concrete real device matching the criteria, for pinning into
+     * `appium:deviceName`/`appium:platformVersion`. Candidates come from the
+     * FULL physical-device catalog (GET /v1/devices) — a busy device is fine,
+     * because the hub queues POST /session until it frees up. Availability is
+     * only a preference, so allocations go to idle devices first. No match at
+     * all is a config error (plain Error — retrying would never help).
+     * `pinCounts` refcounts device names pinned by this run's other slots; the
+     * pick is registered in it synchronously (no await between choosing and
+     * reserving), so concurrent allocates spread across devices instead of
+     * racing for the same one. The caller decrements on release/failure.
+     */
+    pickRealDevice(criteria: AllocationCriteria, pinCounts: Map<string, number>): Promise<PinnedDevice>;
+    /**
+     * Pick a concrete simulator/emulator from GET /v1/browsers, resolving
+     * osVersion range expressions and deviceName regexes for virtual devices.
+     * The catalog is static configuration, so no match is a config error
+     * (thrown as a plain Error — retrying would never help), unlike the
+     * real-device path where absence is temporary.
+     */
+    pickVirtualDevice(criteria: AllocationCriteria): Promise<PinnedDevice>;
+    /** Resolve a user-pinned physical device id to its name/version. */
+    resolveDeviceId(deviceId: string): Promise<PinnedDevice>;
+    /** All physical devices mapped to the protocol's DeviceInfo shape. */
+    listDevices(platform?: Platform): Promise<DeviceInfo[]>;
+    private getPhysical;
+    private getVirtual;
+}
+//# sourceMappingURL=device-catalog.d.ts.map

package/dist/device-catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"device-catalog.d.ts","sourceRoot":"","sources":["../src/device-catalog.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,kBAAkB,EAAE,KAAK,UAAU,EAAE,KAAK,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AACrH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAgB,aAAa,EAAoB,MAAM,eAAe,CAAC;AASnF,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAgB;IACpC,OAAO,CAAC,KAAK,CAA4F;IACzG,OAAO,CAAC,YAAY,CAA6D;gBAErE,GAAG,EAAE,aAAa;IAI9B;;;;;;;;;;;OAWG;IACG,cAAc,CAAC,QAAQ,EAAE,kBAAkB,EAAE,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC;IAmBzG;;;;;;OAMG;IACG,iBAAiB,CAAC,QAAQ,EAAE,kBAAkB,GAAG,OAAO,CAAC,YAAY,CAAC;IAsB5E,oEAAoE;IAC9D,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAQ9D,sEAAsE;IAChE,WAAW,CAAC,QAAQ,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;YAgB/C,WAAW;YAaX,UAAU;CASzB"}

package/dist/device-catalog.js

@@ -0,0 +1,159 @@
+import { osVersionSatisfies } from '@mobilewright/protocol';
+/** How long fetched device lists stay fresh — keeps a burst of pool-slot
+ *  allocations from hammering the REST API (2000 requests / 5 min limit). */
+const CACHE_TTL_MS = 10_000;
+/** The simulator/emulator combo list is near-static — cache it longer. */
+const VIRTUAL_CACHE_TTL_MS = 300_000;
+export class DeviceCatalog {
+    api;
+    cache;
+    virtualCache;
+    constructor(api) {
+        this.api = api;
+    }
+    /**
+     * Pick a concrete real device matching the criteria, for pinning into
+     * `appium:deviceName`/`appium:platformVersion`. Candidates come from the
+     * FULL physical-device catalog (GET /v1/devices) — a busy device is fine,
+     * because the hub queues POST /session until it frees up. Availability is
+     * only a preference, so allocations go to idle devices first. No match at
+     * all is a config error (plain Error — retrying would never help).
+     * `pinCounts` refcounts device names pinned by this run's other slots; the
+     * pick is registered in it synchronously (no await between choosing and
+     * reserving), so concurrent allocates spread across devices instead of
+     * racing for the same one. The caller decrements on release/failure.
+     */
+    async pickRealDevice(criteria, pinCounts) {
+        const { all, available } = await this.getPhysical();
+        const matching = all.filter((d) => matches(d, criteria));
+        if (matching.length === 0) {
+            throw new Error(`No TestingBot real device matches ${describeCriteria(criteria)}. ` +
+                'See https://testingbot.com/support/devices for available devices.');
+        }
+        const availableIds = new Set(available.map((d) => d.id));
+        const preferred = matching.find((d) => availableIds.has(d.id) && !pinCounts.has(d.name)) ??
+            matching.find((d) => availableIds.has(d.id)) ??
+            matching.find((d) => !pinCounts.has(d.name)) ??
+            matching[0];
+        pinCounts.set(preferred.name, (pinCounts.get(preferred.name) ?? 0) + 1);
+        return { deviceName: preferred.name, platformVersion: String(preferred.version), real: true };
+    }
+    /**
+     * Pick a concrete simulator/emulator from GET /v1/browsers, resolving
+     * osVersion range expressions and deviceName regexes for virtual devices.
+     * The catalog is static configuration, so no match is a config error
+     * (thrown as a plain Error — retrying would never help), unlike the
+     * real-device path where absence is temporary.
+     */
+    async pickVirtualDevice(criteria) {
+        const platform = criteria.platform;
+        const combos = (await this.getVirtual()).filter((b) => {
+            if (browserPlatform(b) !== platform)
+                return false;
+            if (!b.deviceName || b.version === undefined)
+                return false;
+            // ChromeOS profiles ride along in the Android list but are not app targets.
+            if (b.deviceName.startsWith('ChromeOS'))
+                return false;
+            if (criteria.deviceNamePattern && !new RegExp(criteria.deviceNamePattern, 'i').test(b.deviceName))
+                return false;
+            if (criteria.osVersion && !osVersionSatisfies(String(b.version), criteria.osVersion))
+                return false;
+            return true;
+        });
+        if (combos.length === 0) {
+            throw new Error(`No TestingBot ${platform === 'ios' ? 'simulator' : 'emulator'} matches ${describeCriteria(criteria)}. ` +
+                'See https://testingbot.com/support/devices for available combinations.');
+        }
+        // Deterministic pick: the newest matching OS version.
+        const best = combos.reduce((a, b) => (compareVersions(String(a.version), String(b.version)) >= 0 ? a : b));
+        return { deviceName: best.deviceName, platformVersion: String(best.version), real: false };
+    }
+    /** Resolve a user-pinned physical device id to its name/version. */
+    async resolveDeviceId(deviceId) {
+        const device = await this.api.getDevice(deviceId);
+        if (!device?.name) {
+            throw new Error(`TestingBot device id "${deviceId}" was not found (GET /devices/${deviceId}).`);
+        }
+        return { deviceName: device.name, platformVersion: String(device.version), real: true };
+    }
+    /** All physical devices mapped to the protocol's DeviceInfo shape. */
+    async listDevices(platform) {
+        const { all, available } = await this.getPhysical();
+        const availableIds = new Set(available.map((d) => d.id));
+        return all
+            .filter((d) => !platform || toPlatform(d) === platform)
+            .map((d) => ({
+            id: String(d.id),
+            name: d.name,
+            platform: toPlatform(d),
+            type: 'real',
+            state: availableIds.has(d.id) ? 'online' : 'offline',
+            model: d.model_number,
+            osVersion: String(d.version),
+        }));
+    }
+    async getPhysical() {
+        const now = Date.now();
+        if (this.cache && now - this.cache.fetchedAt < CACHE_TTL_MS) {
+            return this.cache;
+        }
+        const [all, available] = await Promise.all([
+            this.api.getDevices(false),
+            this.api.getDevices(true),
+        ]);
+        this.cache = { all, available, fetchedAt: now };
+        return this.cache;
+    }
+    async getVirtual() {
+        const now = Date.now();
+        if (this.virtualCache && now - this.virtualCache.fetchedAt < VIRTUAL_CACHE_TTL_MS) {
+            return this.virtualCache.entries;
+        }
+        const entries = await this.api.getBrowsers();
+        this.virtualCache = { entries, fetchedAt: now };
+        return entries;
+    }
+}
+function browserPlatform(entry) {
+    const name = entry.platformName?.toLowerCase();
+    if (name === 'ios')
+        return 'ios';
+    if (name === 'android')
+        return 'android';
+    return undefined;
+}
+/** Compare dotted version strings numerically ("16.0" > "9.1"). */
+function compareVersions(a, b) {
+    const pa = a.split('.').map(Number);
+    const pb = b.split('.').map(Number);
+    for (let i = 0; i < Math.max(pa.length, pb.length); i++) {
+        const diff = (pa[i] ?? 0) - (pb[i] ?? 0);
+        if (diff !== 0)
+            return diff;
+    }
+    return 0;
+}
+function matches(device, criteria) {
+    if (criteria.platform && toPlatform(device) !== criteria.platform)
+        return false;
+    if (criteria.deviceNamePattern && !new RegExp(criteria.deviceNamePattern, 'i').test(device.name))
+        return false;
+    if (criteria.osVersion && !osVersionSatisfies(String(device.version), criteria.osVersion))
+        return false;
+    return true;
+}
+function toPlatform(device) {
+    return device.platform_name?.toLowerCase() === 'ios' ? 'ios' : 'android';
+}
+function describeCriteria(criteria) {
+    const parts = [];
+    if (criteria.platform)
+        parts.push(`platform=${criteria.platform}`);
+    if (criteria.deviceNamePattern)
+        parts.push(`name~/${criteria.deviceNamePattern}/`);
+    if (criteria.osVersion)
+        parts.push(`osVersion "${criteria.osVersion}"`);
+    return parts.length ? parts.join(', ') : 'any criteria';
+}
+//# sourceMappingURL=device-catalog.js.map

package/dist/device-catalog.js.map

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

package/dist/driver.d.ts

@@ -0,0 +1,80 @@
+import { type AllocatedDevice, type AllocationCriteria, type AppInfo, type ConnectionConfig, type DeviceInfo, type DeviceSettings, type GestureSequence, type HardwareButton, type LaunchOptions, type ListDevicesOptions, type MobilewrightDriver, type Orientation, type RecordingOptions, type RecordingResult, type ScreenSize, type ScreenshotOptions, type Session, type SwipeDirection, type SwipeOptions, type TestObserver, type ViewNode } from '@mobilewright/protocol';
+import { type TestingBotDriverOptions } from './options.js';
+import { AppiumWebViewBridge } from './webview.js';
+/**
+ * Mobilewright driver for TestingBot's device cloud.
+ *
+ * The WebDriver session is the allocation: `allocate()` creates an Appium
+ * session on hub.testingbot.com and hands its UUID to the device pool as the
+ * deviceId; worker processes `connect()` to that UUID over plain stateless
+ * HTTP. `disconnect()` only detaches (the pool re-grants slots without
+ * re-allocating) — the session actually ends in `release()`/`dispose()`.
+ */
+export declare class TestingBotDriver implements MobilewrightDriver {
+    readonly observer: TestObserver | undefined;
+    /** WebView support via Appium contexts (its presence signals capability). */
+    readonly webViewBridge: AppiumWebViewBridge;
+    private readonly options;
+    private readonly hub;
+    private readonly api;
+    private readonly catalog;
+    private readonly storage;
+    private readonly keepalive;
+    private readonly runLog;
+    private readonly tunnel;
+    /** Sessions created by this instance's allocate() (coordinator process). */
+    private readonly allocated;
+    /** Every session ever allocated this run — release() does NOT remove
+     *  entries, because the observer must report sessions the pool released
+     *  before onRunEnd fires (which, with Playwright's teardown ordering, is
+     *  all of them). */
+    private readonly everAllocated;
+    /** Refcount of real-device names pinned by in-flight/live allocations. */
+    private readonly pinCounts;
+    /** The session this instance is connected to (worker process). */
+    private active;
+    /** sessionPerTest: pool slots whose original session this instance has already probed/used. */
+    private readonly rotatedDeviceIds;
+    constructor(options?: TestingBotDriverOptions);
+    prepare(): Promise<void>;
+    allocate(criteria: AllocationCriteria, _takenDeviceIds: ReadonlySet<string>, signal?: AbortSignal): Promise<AllocatedDevice>;
+    release(deviceId: string): Promise<void>;
+    dispose(): Promise<void>;
+    connect(config: ConnectionConfig): Promise<Session>;
+    disconnect(): Promise<void>;
+    /** Create a new hub session for this slot from the connect() config. */
+    private startFreshSession;
+    /**
+     * Best-effort, fire-and-forget per the protocol: Android animation scales
+     * via `mobile: shell` (may be unavailable depending on TestingBot's Appium
+     * feature flags — failures are logged, never thrown); iOS has no equivalent.
+     */
+    applyDeviceSettings(settings: DeviceSettings): Promise<void>;
+    getViewHierarchy(): Promise<ViewNode[]>;
+    tap(x: number, y: number): Promise<void>;
+    doubleTap(x: number, y: number): Promise<void>;
+    longPress(x: number, y: number, duration?: number): Promise<void>;
+    typeText(text: string): Promise<void>;
+    pressKeys(keys: string[]): Promise<void>;
+    clearText(): Promise<void>;
+    swipe(direction: SwipeDirection, opts?: SwipeOptions): Promise<void>;
+    gesture(gestures: GestureSequence): Promise<void>;
+    pressButton(button: HardwareButton): Promise<void>;
+    screenshot(opts?: ScreenshotOptions): Promise<Buffer>;
+    getScreenSize(): Promise<ScreenSize>;
+    getOrientation(): Promise<Orientation>;
+    setOrientation(orientation: Orientation): Promise<void>;
+    launchApp(bundleId: string, opts?: LaunchOptions): Promise<void>;
+    terminateApp(bundleId: string): Promise<void>;
+    listApps(): Promise<AppInfo[]>;
+    getForegroundApp(): Promise<AppInfo>;
+    installApp(path: string): Promise<void>;
+    uninstallApp(bundleId: string): Promise<void>;
+    listDevices(opts?: ListDevicesOptions): Promise<DeviceInfo[]>;
+    openUrl(url: string): Promise<void>;
+    startRecording(opts: RecordingOptions): Promise<void>;
+    stopRecording(): Promise<RecordingResult>;
+    private session;
+    private unpin;
+}
+//# sourceMappingURL=driver.d.ts.map

package/dist/driver.d.ts.map

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