@testingbot/mobilewright-driver 0.1.0

package/dist/rest-api.js

@@ -0,0 +1,117 @@
+import { createHash } from 'node:crypto';
+import { readFile } from 'node:fs/promises';
+import { basename } from 'node:path';
+import createDebug from 'debug';
+import { AuthenticationError, RestApiError } from './errors.js';
+import { USER_AGENT } from './version.js';
+const debug = createDebug('testingbot:rest');
+/** Client for api.testingbot.com/v1 (HTTP Basic auth with key:secret). */
+export class RestApiClient {
+    apiUrl;
+    auth;
+    fetchFn;
+    constructor(apiUrl, key, secret, fetchFn = fetch) {
+        this.apiUrl = apiUrl.replace(/\/+$/, '');
+        this.auth = 'Basic ' + Buffer.from(`${key}:${secret}`).toString('base64');
+        this.fetchFn = fetchFn;
+    }
+    /** Validate credentials; used by prepare() to fail fast. */
+    async getUser() {
+        return await this.request('GET', '/user');
+    }
+    /** Physical devices. `available` restricts to currently-acquirable ones. */
+    async getDevices(available) {
+        const path = available ? '/devices/available' : '/devices';
+        const result = await this.request('GET', path);
+        // The API historically wraps lists as {devices: [...]}; accept both.
+        if (Array.isArray(result))
+            return result;
+        const wrapped = result.devices;
+        return wrapped ?? [];
+    }
+    /** Simulator/emulator (and desktop-browser) combos; mobile rows carry platformName + deviceName + OS version. */
+    async getBrowsers() {
+        const result = await this.request('GET', '/browsers');
+        if (Array.isArray(result))
+            return result;
+        return (result.browsers) ?? [];
+    }
+    async getDevice(id) {
+        const result = await this.request('GET', `/devices/${id}`);
+        return (result.device ?? result);
+    }
+    /** Upload an app binary; returns the storage entry with its tb:// URL. */
+    async uploadApp(filePath) {
+        const data = await readFile(filePath);
+        debug('uploading %s (%d bytes, sha256=%s)', filePath, data.length, sha256(data).slice(0, 12));
+        const form = new FormData();
+        form.append('file', new Blob([data]), basename(filePath));
+        const response = await this.fetchFn(`${this.apiUrl}/storage`, {
+            method: 'POST',
+            headers: { Authorization: this.auth, 'User-Agent': USER_AGENT },
+            body: form,
+        });
+        return await this.parse(response, 'POST /storage');
+    }
+    async getStorageEntry(appUrl) {
+        const appKey = appUrl.replace(/^tb:\/\//, '');
+        return await this.request('GET', `/storage/${appKey}`);
+    }
+    /** Update a test by WebDriver session UUID (pass/fail, name, build, ...). */
+    async updateTest(sessionId, update) {
+        const params = new URLSearchParams();
+        if (update.success !== undefined)
+            params.set('test[success]', update.success ? '1' : '0');
+        if (update.name !== undefined)
+            params.set('test[name]', update.name);
+        if (update.statusMessage !== undefined)
+            params.set('test[status_message]', update.statusMessage);
+        if (update.build !== undefined)
+            params.set('test[build]', update.build);
+        if (update.extra !== undefined)
+            params.set('test[extra]', update.extra);
+        for (const group of update.groups ?? [])
+            params.append('groups[]', group);
+        await this.request('PUT', `/tests/${sessionId}`, params);
+    }
+    async getTest(sessionId) {
+        return await this.request('GET', `/tests/${sessionId}`);
+    }
+    /** Force-stop a running session (fallback when DELETE /session fails). */
+    async stopTest(sessionId) {
+        await this.request('PUT', `/tests/${sessionId}/stop`);
+    }
+    async request(method, path, body) {
+        debug('%s %s', method, path);
+        const response = await this.fetchFn(`${this.apiUrl}${path}`, {
+            method,
+            headers: {
+                Authorization: this.auth,
+                'User-Agent': USER_AGENT,
+                ...(body ? { 'Content-Type': 'application/x-www-form-urlencoded' } : {}),
+            },
+            body,
+            signal: AbortSignal.timeout(30_000),
+        });
+        return await this.parse(response, `${method} ${path}`);
+    }
+    async parse(response, context) {
+        const text = await response.text();
+        if (response.status === 401) {
+            throw new AuthenticationError(`TestingBot rejected the credentials (${context}). Check TESTINGBOT_KEY and TESTINGBOT_SECRET.`);
+        }
+        if (!response.ok) {
+            throw new RestApiError(`${context} failed (HTTP ${response.status}): ${text.slice(0, 500)}`, response.status);
+        }
+        try {
+            return JSON.parse(text);
+        }
+        catch {
+            throw new RestApiError(`${context} returned non-JSON: ${text.slice(0, 200)}`, response.status);
+        }
+    }
+}
+export function sha256(data) {
+    return createHash('sha256').update(data).digest('hex');
+}
+//# sourceMappingURL=rest-api.js.map

package/dist/rest-api.js.map

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

package/dist/run-log.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Tiny JSONL file shared between the coordinator process (allocator half,
+ * observer) and worker processes (session half) of one mobilewright run —
+ * needed by sessionPerTest, where workers create WebDriver sessions the
+ * coordinator never sees but the observer must still report on. Keyed by
+ * cwd, since all processes of a run share it; the coordinator truncates the
+ * file in prepare() so stale entries from a previous run cannot leak in.
+ */
+export interface SessionRecord {
+    type: 'session';
+    sessionId: string;
+    /** Wall-clock ms of connect()/disconnect() — present on records written at
+     *  test end, used to attribute a test's verdict to its session. */
+    startedAt?: number;
+    endedAt?: number;
+}
+export interface AppRecord {
+    type: 'app';
+    platform: string;
+    deviceType?: string;
+    url: string;
+}
+export interface RecordingRecord {
+    type: 'recording';
+    sessionId: string;
+    /** Local MP4 path the caller asked stopRecording() to produce. */
+    output: string;
+}
+type Record_ = SessionRecord | AppRecord | RecordingRecord;
+export interface MergedSession {
+    sessionId: string;
+    /** Number of connect/disconnect cycles (= tests) recorded for this session. */
+    spans: number;
+    startedAt?: number;
+    endedAt?: number;
+}
+export declare class RunLog {
+    readonly path: string;
+    constructor(dir?: string, key?: string);
+    truncate(): void;
+    append(record: Record_): void;
+    read(): Record_[];
+    /**
+     * Session records merged by id. A pooled session hosts one test per
+     * connect/disconnect cycle, so it accumulates one timed record per test:
+     * `spans` counts them, and startedAt/endedAt cover their union. A session
+     * with exactly one span hosted exactly one test — attributable; more than
+     * one span means several tests shared it.
+     */
+    sessions(): MergedSession[];
+    sessionIds(): string[];
+    recordings(): RecordingRecord[];
+    appUrlFor(platform: string, deviceType: string | undefined): string | undefined;
+}
+export {};
+//# sourceMappingURL=run-log.d.ts.map

package/dist/run-log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-log.d.ts","sourceRoot":"","sources":["../src/run-log.ts"],"names":[],"mappings":"AAKA;;;;;;;GAOG;AAEH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,SAAS,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB;uEACmE;IACnE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,KAAK,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,WAAW,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,kEAAkE;IAClE,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,KAAK,OAAO,GAAG,aAAa,GAAG,SAAS,GAAG,eAAe,CAAC;AAE3D,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,+EAA+E;IAC/E,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,MAAM;IACjB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAEV,GAAG,GAAE,MAAiB,EAAE,GAAG,GAAE,MAAsB;IAK/D,QAAQ,IAAI,IAAI;IAQhB,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI;IAQ7B,IAAI,IAAI,OAAO,EAAE;IAWjB;;;;;;OAMG;IACH,QAAQ,IAAI,aAAa,EAAE;IAe3B,UAAU,IAAI,MAAM,EAAE;IAItB,UAAU,IAAI,eAAe,EAAE;IAI/B,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS;CAOhF"}

package/dist/run-log.js

@@ -0,0 +1,72 @@
+import { appendFileSync, readFileSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { createHash } from 'node:crypto';
+export class RunLog {
+    path;
+    constructor(dir = tmpdir(), key = process.cwd()) {
+        const hash = createHash('sha256').update(key).digest('hex').slice(0, 12);
+        this.path = join(dir, `testingbot-mobilewright-${hash}.jsonl`);
+    }
+    truncate() {
+        try {
+            writeFileSync(this.path, '');
+        }
+        catch {
+            // best-effort — a failed truncate only risks over-reporting old sessions
+        }
+    }
+    append(record) {
+        try {
+            appendFileSync(this.path, JSON.stringify(record) + '\n');
+        }
+        catch {
+            // best-effort — reporting degrades, tests must not fail over this
+        }
+    }
+    read() {
+        try {
+            return readFileSync(this.path, 'utf-8')
+                .split('\n')
+                .filter(Boolean)
+                .map((line) => JSON.parse(line));
+        }
+        catch {
+            return [];
+        }
+    }
+    /**
+     * Session records merged by id. A pooled session hosts one test per
+     * connect/disconnect cycle, so it accumulates one timed record per test:
+     * `spans` counts them, and startedAt/endedAt cover their union. A session
+     * with exactly one span hosted exactly one test — attributable; more than
+     * one span means several tests shared it.
+     */
+    sessions() {
+        const byId = new Map();
+        for (const record of this.read()) {
+            if (record.type !== 'session')
+                continue;
+            const merged = byId.get(record.sessionId) ?? { sessionId: record.sessionId, spans: 0 };
+            if (record.startedAt !== undefined && record.endedAt !== undefined) {
+                merged.spans += 1;
+                merged.startedAt = Math.min(merged.startedAt ?? record.startedAt, record.startedAt);
+                merged.endedAt = Math.max(merged.endedAt ?? record.endedAt, record.endedAt);
+            }
+            byId.set(record.sessionId, merged);
+        }
+        return [...byId.values()];
+    }
+    sessionIds() {
+        return this.sessions().map((r) => r.sessionId);
+    }
+    recordings() {
+        return this.read().filter((r) => r.type === 'recording');
+    }
+    appUrlFor(platform, deviceType) {
+        const apps = this.read().filter((r) => r.type === 'app');
+        return (apps.find((a) => a.platform === platform && a.deviceType === deviceType) ??
+            apps.find((a) => a.platform === platform))?.url;
+    }
+}
+//# sourceMappingURL=run-log.js.map

package/dist/run-log.js.map

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

package/dist/tunnel.d.ts

@@ -0,0 +1,13 @@
+import type { ResolvedOptions } from './options.js';
+/**
+ * Starts/stops a TestingBot Tunnel around the run via the official
+ * `testingbot-tunnel-launcher` package — an optional peer dependency, since
+ * it needs Java on the machine. Only the coordinator's prepare()/dispose()
+ * touch this; workers just put the tunnelIdentifier into their caps.
+ */
+export declare class TunnelManager {
+    private running;
+    start(options: ResolvedOptions): Promise<void>;
+    stop(): Promise<void>;
+}
+//# sourceMappingURL=tunnel.d.ts.map

package/dist/tunnel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tunnel.d.ts","sourceRoot":"","sources":["../src/tunnel.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAapD;;;;;GAKG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,OAAO,CAA4B;IAErC,KAAK,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IA8B9C,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAO5B"}

package/dist/tunnel.js

@@ -0,0 +1,47 @@
+import createDebug from 'debug';
+const debug = createDebug('testingbot:tunnel');
+/**
+ * Starts/stops a TestingBot Tunnel around the run via the official
+ * `testingbot-tunnel-launcher` package — an optional peer dependency, since
+ * it needs Java on the machine. Only the coordinator's prepare()/dispose()
+ * touch this; workers just put the tunnelIdentifier into their caps.
+ */
+export class TunnelManager {
+    running;
+    async start(options) {
+        if (!options.tunnel || this.running)
+            return;
+        let launcher;
+        try {
+            const mod = await import('testingbot-tunnel-launcher');
+            launcher = mod.default ?? mod;
+        }
+        catch {
+            throw new Error('The `tunnel` option needs the optional testingbot-tunnel-launcher package (and Java). ' +
+                'Install it with: npm install --save-dev testingbot-tunnel-launcher — or start the tunnel ' +
+                'yourself and use the `tunnelIdentifier` option instead.');
+        }
+        const { identifier, ...rest } = options.tunnel;
+        const launcherOptions = {
+            apiKey: options.key,
+            apiSecret: options.secret,
+            ...(options.tunnelIdentifier ? { tunnelIdentifier: options.tunnelIdentifier } : {}),
+            ...rest,
+        };
+        void identifier; // already folded into options.tunnelIdentifier at resolve time
+        debug('starting TestingBot Tunnel%s', options.tunnelIdentifier ? ` (identifier ${options.tunnelIdentifier})` : '');
+        this.running = await new Promise((resolve, reject) => {
+            launcher(launcherOptions, (err, tunnel) => (err ? reject(err) : resolve(tunnel)));
+        });
+        debug('tunnel ready');
+    }
+    async stop() {
+        const tunnel = this.running;
+        if (!tunnel)
+            return;
+        this.running = undefined;
+        await new Promise((resolve) => tunnel.close(resolve));
+        debug('tunnel closed');
+    }
+}
+//# sourceMappingURL=tunnel.js.map

package/dist/tunnel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tunnel.js","sourceRoot":"","sources":["../src/tunnel.ts"],"names":[],"mappings":"AAAA,OAAO,WAAW,MAAM,OAAO,CAAC;AAGhC,MAAM,KAAK,GAAG,WAAW,CAAC,mBAAmB,CAAC,CAAC;AAW/C;;;;;GAKG;AACH,MAAM,OAAO,aAAa;IAChB,OAAO,CAA4B;IAE3C,KAAK,CAAC,KAAK,CAAC,OAAwB;QAClC,IAAI,CAAC,OAAO,CAAC,MAAM,IAAI,IAAI,CAAC,OAAO;YAAE,OAAO;QAC5C,IAAI,QAAoB,CAAC;QACzB,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,4BAA4B,CAAC,CAAC;YACvD,QAAQ,GAAI,GAAgC,CAAC,OAAO,IAAK,GAA6B,CAAC;QACzF,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,KAAK,CACb,wFAAwF;gBACxF,2FAA2F;gBAC3F,yDAAyD,CAC1D,CAAC;QACJ,CAAC;QAED,MAAM,EAAE,UAAU,EAAE,GAAG,IAAI,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;QAC/C,MAAM,eAAe,GAA4B;YAC/C,MAAM,EAAE,OAAO,CAAC,GAAG;YACnB,SAAS,EAAE,OAAO,CAAC,MAAM;YACzB,GAAG,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE,gBAAgB,EAAE,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACnF,GAAG,IAAI;SACR,CAAC;QACF,KAAK,UAAU,CAAC,CAAC,+DAA+D;QAEhF,KAAK,CAAC,8BAA8B,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,gBAAgB,OAAO,CAAC,gBAAgB,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACnH,IAAI,CAAC,OAAO,GAAG,MAAM,IAAI,OAAO,CAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAClE,QAAQ,CAAC,eAAe,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QACpF,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,cAAc,CAAC,CAAC;IACxB,CAAC;IAED,KAAK,CAAC,IAAI;QACR,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC;QAC5B,IAAI,CAAC,MAAM;YAAE,OAAO;QACpB,IAAI,CAAC,OAAO,GAAG,SAAS,CAAC;QACzB,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;QAC5D,KAAK,CAAC,eAAe,CAAC,CAAC;IACzB,CAAC;CACF"}

package/dist/version.d.ts

@@ -0,0 +1,4 @@
+export declare const VERSION: string;
+/** Sent on every hub and REST request so TestingBot can attribute traffic. */
+export declare const USER_AGENT: string;
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,OAAO,EAAE,MAAgB,CAAC;AAEvC,8EAA8E;AAC9E,eAAO,MAAM,UAAU,QAAwE,CAAC"}

package/dist/version.js

@@ -0,0 +1,7 @@
+import { createRequire } from 'node:module';
+// Resolves to the package root from both src/ (tests) and dist/ (published).
+const { version } = createRequire(import.meta.url)('../package.json');
+export const VERSION = version;
+/** Sent on every hub and REST request so TestingBot can attribute traffic. */
+export const USER_AGENT = `testingbot-mobilewright-driver/${version} (node ${process.version})`;
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,6EAA6E;AAC7E,MAAM,EAAE,OAAO,EAAE,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,iBAAiB,CAAwB,CAAC;AAE7F,MAAM,CAAC,MAAM,OAAO,GAAW,OAAO,CAAC;AAEvC,8EAA8E;AAC9E,MAAM,CAAC,MAAM,UAAU,GAAG,kCAAkC,OAAO,UAAU,OAAO,CAAC,OAAO,GAAG,CAAC"}

package/dist/webdriver-client.d.ts

@@ -0,0 +1,43 @@
+export type FetchFn = typeof fetch;
+export interface NewSessionResult {
+    sessionId: string;
+    capabilities: Record<string, unknown>;
+}
+interface CommandOptions {
+    /** Overrides the client's default per-command timeout. */
+    timeout?: number;
+    signal?: AbortSignal;
+}
+/**
+ * Minimal fetch-based W3C WebDriver / Appium client. Deliberately not a
+ * full client library: only the commands the driver needs, with uniform
+ * timeout, abort, and error mapping.
+ */
+export declare class WebDriverClient {
+    private readonly hubUrl;
+    private readonly commandTimeout;
+    private readonly fetchFn;
+    constructor(hubUrl: string, commandTimeout: number, fetchFn?: FetchFn);
+    /**
+     * POST /session. Exempt from the per-command timeout — device allocation
+     * can queue for minutes; the caller bounds it via `opts.timeout`/`signal`.
+     */
+    newSession(capabilities: {
+        alwaysMatch: Record<string, unknown>;
+        firstMatch: Record<string, unknown>[];
+    }, opts?: CommandOptions): Promise<NewSessionResult>;
+    deleteSession(sessionId: string, opts?: CommandOptions): Promise<void>;
+    get<T = unknown>(sessionId: string, path: string, opts?: CommandOptions): Promise<T>;
+    post<T = unknown>(sessionId: string, path: string, body: unknown, opts?: CommandOptions): Promise<T>;
+    /** Execute a script — used for Appium `mobile:` extension commands. */
+    execute<T = unknown>(sessionId: string, script: string, args?: unknown[], opts?: CommandOptions): Promise<T>;
+    performActions(sessionId: string, actions: unknown[], opts?: CommandOptions): Promise<void>;
+    releaseActions(sessionId: string, opts?: CommandOptions): Promise<void>;
+    /** Screenshot as a base64 PNG string. */
+    screenshot(sessionId: string, opts?: CommandOptions): Promise<string>;
+    /** Page source (Appium XML hierarchy). */
+    source(sessionId: string, opts?: CommandOptions): Promise<string>;
+    private request;
+}
+export {};
+//# sourceMappingURL=webdriver-client.d.ts.map

package/dist/webdriver-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webdriver-client.d.ts","sourceRoot":"","sources":["../src/webdriver-client.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,OAAO,GAAG,OAAO,KAAK,CAAC;AAEnC,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACvC;AAED,UAAU,cAAc;IACtB,0DAA0D;IAC1D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED;;;;GAIG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;gBAEtB,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,OAAO,GAAE,OAAe;IAM5E;;;OAGG;IACG,UAAU,CACd,YAAY,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAA;KAAE,EAC7F,IAAI,GAAE,cAAmB,GACxB,OAAO,CAAC,gBAAgB,CAAC;IAYtB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,GAAE,cAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAI1E,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,cAAmB,GAAG,OAAO,CAAC,CAAC,CAAC;IAIxF,IAAI,CAAC,CAAC,GAAG,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,GAAE,cAAmB,GAAG,OAAO,CAAC,CAAC,CAAC;IAI9G,uEAAuE;IACjE,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,GAAE,OAAO,EAAO,EAAE,IAAI,GAAE,cAAmB,GAAG,OAAO,CAAC,CAAC,CAAC;IAIpH,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,GAAE,cAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/F,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,GAAE,cAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjF,yCAAyC;IACnC,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,GAAE,cAAmB,GAAG,OAAO,CAAC,MAAM,CAAC;IAI/E,0CAA0C;IACpC,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,GAAE,cAAmB,GAAG,OAAO,CAAC,MAAM,CAAC;YAI7D,OAAO;CAkDtB"}

package/dist/webdriver-client.js

@@ -0,0 +1,109 @@
+import createDebug from 'debug';
+import { WebDriverError } from './errors.js';
+import { USER_AGENT } from './version.js';
+const debug = createDebug('testingbot:webdriver');
+/**
+ * Minimal fetch-based W3C WebDriver / Appium client. Deliberately not a
+ * full client library: only the commands the driver needs, with uniform
+ * timeout, abort, and error mapping.
+ */
+export class WebDriverClient {
+    hubUrl;
+    commandTimeout;
+    fetchFn;
+    constructor(hubUrl, commandTimeout, fetchFn = fetch) {
+        this.hubUrl = hubUrl.replace(/\/+$/, '');
+        this.commandTimeout = commandTimeout;
+        this.fetchFn = fetchFn;
+    }
+    /**
+     * POST /session. Exempt from the per-command timeout — device allocation
+     * can queue for minutes; the caller bounds it via `opts.timeout`/`signal`.
+     */
+    async newSession(capabilities, opts = {}) {
+        const value = await this.request('POST', '/session', { capabilities }, opts);
+        const sessionId = value.sessionId;
+        if (!sessionId) {
+            throw new WebDriverError('session not created', 'hub response did not include a sessionId', 200);
+        }
+        return { sessionId, capabilities: value.capabilities ?? {} };
+    }
+    async deleteSession(sessionId, opts = {}) {
+        await this.request('DELETE', `/session/${sessionId}`, undefined, opts);
+    }
+    async get(sessionId, path, opts = {}) {
+        return await this.request('GET', `/session/${sessionId}${path}`, undefined, opts);
+    }
+    async post(sessionId, path, body, opts = {}) {
+        return await this.request('POST', `/session/${sessionId}${path}`, body ?? {}, opts);
+    }
+    /** Execute a script — used for Appium `mobile:` extension commands. */
+    async execute(sessionId, script, args = [], opts = {}) {
+        return await this.post(sessionId, '/execute/sync', { script, args }, opts);
+    }
+    async performActions(sessionId, actions, opts = {}) {
+        await this.post(sessionId, '/actions', { actions }, opts);
+    }
+    async releaseActions(sessionId, opts = {}) {
+        await this.request('DELETE', `/session/${sessionId}/actions`, undefined, opts);
+    }
+    /** Screenshot as a base64 PNG string. */
+    async screenshot(sessionId, opts = {}) {
+        return await this.get(sessionId, '/screenshot', opts);
+    }
+    /** Page source (Appium XML hierarchy). */
+    async source(sessionId, opts = {}) {
+        return await this.get(sessionId, '/source', opts);
+    }
+    async request(method, path, body, opts) {
+        const url = `${this.hubUrl}${path}`;
+        const timeout = opts.timeout ?? this.commandTimeout;
+        const signal = opts.signal
+            ? combineSignals(AbortSignal.timeout(timeout), opts.signal)
+            : AbortSignal.timeout(timeout);
+        debug('%s %s', method, path);
+        let response;
+        try {
+            response = await this.fetchFn(url, {
+                method,
+                headers: { 'Content-Type': 'application/json; charset=utf-8', 'User-Agent': USER_AGENT },
+                body: body === undefined ? undefined : JSON.stringify(body),
+                signal,
+            });
+        }
+        catch (err) {
+            if (err instanceof Error && err.name === 'TimeoutError') {
+                throw new WebDriverError('timeout', `${method} ${path} timed out after ${timeout}ms`, 0);
+            }
+            throw err;
+        }
+        let payload;
+        const text = await response.text();
+        try {
+            payload = JSON.parse(text);
+        }
+        catch {
+            throw new WebDriverError('invalid response', `${method} ${path} returned non-JSON (HTTP ${response.status}): ${text.slice(0, 500)}`, response.status);
+        }
+        if (!response.ok) {
+            const value = payload.value;
+            throw new WebDriverError(value?.error ?? `http ${response.status}`, value?.message ?? text.slice(0, 500), response.status);
+        }
+        return payload.value;
+    }
+}
+/** AbortSignal.any with a fallback for Node 18/20.0-20.2 (added in 20.3). */
+function combineSignals(a, b) {
+    if (typeof AbortSignal.any === 'function')
+        return AbortSignal.any([a, b]);
+    if (a.aborted)
+        return a;
+    if (b.aborted)
+        return b;
+    const controller = new AbortController();
+    const onAbort = function () { controller.abort(this.reason); };
+    a.addEventListener('abort', onAbort, { once: true });
+    b.addEventListener('abort', onAbort, { once: true });
+    return controller.signal;
+}
+//# sourceMappingURL=webdriver-client.js.map

package/dist/webdriver-client.js.map

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

package/dist/webview.d.ts

@@ -0,0 +1,16 @@
+import type { WebViewBridge, WebViewInfo, WebViewSession } from '@mobilewright/protocol';
+import type { WebDriverClient } from './webdriver-client.js';
+/**
+ * WebView support over Appium's context API. Attaching switches the ONE
+ * WebDriver context the session has — native commands issued while a webview
+ * session is open target the web layer, which is also how the reference
+ * drivers behave. close() switches back to the native context.
+ */
+export declare class AppiumWebViewBridge implements WebViewBridge {
+    private readonly hub;
+    private readonly sessionId;
+    constructor(hub: WebDriverClient, sessionId: () => string);
+    listWebViews(): Promise<WebViewInfo[]>;
+    attachWebView(id: string): Promise<WebViewSession>;
+}
+//# sourceMappingURL=webview.d.ts.map

package/dist/webview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webview.d.ts","sourceRoot":"","sources":["../src/webview.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACzF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAM7D;;;;;GAKG;AACH,qBAAa,mBAAoB,YAAW,aAAa;IACvD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAkB;IACtC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAe;gBAE7B,GAAG,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,MAAM;IAKnD,YAAY,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAetC,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;CAMzD"}