@testingbot/cli 1.0.1 → 1.0.3

package/README.md

@@ -1,8 +1,56 @@
-[![Run Tests](https://github.com/testingbot/testingbotctl/actions/workflows/test.yml/badge.svg)](https://github.com/testingbot/testingbotctl/actions/workflows/test.yml)
+<p align="center">
+  <a href="https://testingbot.com">
+    <img src="resources/logo.svg" alt="Maestro Cloud Testing" width="400">
+  </a>
+  <br>
+  <strong>Run mobile tests on real devices in the cloud</strong>
+</p>
+
+<p align="center">
+  <a href="https://github.com/testingbot/testingbotctl/actions/workflows/test.yml">
+    <img src="https://github.com/testingbot/testingbotctl/actions/workflows/test.yml/badge.svg" alt="Run Tests">
+  </a>
+  <a href="https://www.npmjs.com/package/@testingbot/cli">
+    <img src="https://img.shields.io/npm/v/@testingbot/cli.svg" alt="npm version">
+  </a>
+  <a href="https://www.npmjs.com/package/@testingbot/cli">
+    <img src="https://img.shields.io/npm/dm/@testingbot/cli.svg" alt="npm downloads">
+  </a>
+  <a href="https://github.com/testingbot/testingbotctl/blob/main/LICENSE">
+    <img src="https://img.shields.io/npm/l/@testingbot/cli.svg" alt="license">
+  </a>
+</p>
+
+<p align="center">
+  <a href="https://testingbot.com">Website</a>
+  ·
+  <a href="https://testingbot.com/support/app-automate/maestro">Documentation</a>
+  ·
+  <a href="https://www.npmjs.com/package/@testingbot/cli">npm</a>
+</p>
 
-# TestingBot CLI
+---
+
+<p align="center">
+  <img src="demo/demo.gif" alt="TestingBot CLI Demo" width="700">
+</p>
+
+---
+
+Run **Espresso**, **XCUITest** and **Maestro** tests on real devices in the cloud.
 
-CLI tool to run Espresso, XCUITest and Maestro tests on [TestingBot's](https://testingbot.com) cloud infrastructure.
+- **Real Devices** — Test on thousands of real iOS and Android devices
+- **Emulators & Simulators** — Fast feedback with virtual devices
+- **Parallel Execution** — Split tests across multiple devices with sharding
+- **CI/CD Ready** — Integrates with GitHub Actions, Jenkins, and more
+- **Live Results** — Watch tests run in real-time
+- **Artifacts** — Download videos, screenshots, and logs
+
+<p align="center">
+  <a href="#installation"><strong>Get Started →</strong></a>
+</p>
+
+---
 
 ## Installation
 
@@ -82,9 +130,25 @@ testingbot maestro <app> <flows...> [options]
 | `-q, --quiet` | Suppress progress output |
 | `--report <format>` | Download report after completion: html or junit |
 | `--report-output-dir <path>` | Directory to save reports (required with --report) |
-| `--download-artifacts` | Download test artifacts (logs, screenshots, video) |
+| `--download-artifacts [mode]` | Download test artifacts (logs, screenshots, video). Mode: `all` (default) or `failed` |
 | `--artifacts-output-dir <path>` | Directory to save artifacts zip (defaults to current directory) |
 
+**Advanced Options:**
+
+| Option | Description |
+|--------|-------------|
+| `--shard-split <number>` | Split flows into N parallel sessions for faster execution |
+| `--ignore-checksum-check` | Skip checksum verification and always upload the app |
+
+**CI/CD Integration:**
+
+| Option | Description |
+|--------|-------------|
+| `--commit-sha <sha>` | Git commit SHA associated with this test run |
+| `--pull-request-id <id>` | Pull request ID this test run originated from |
+| `--repo-name <name>` | Repository name (e.g., GitHub repo slug) |
+| `--repo-owner <owner>` | Repository owner (e.g., GitHub organization or username) |
+
 **Examples:**
 
 ```sh
@@ -97,8 +161,8 @@ testingbot maestro app.apk ./flows/smoke ./flows/regression ./flows/e2e
 # With device selection
 testingbot maestro app.apk ./flows --device "Pixel 8" --deviceVersion "14"
 
-# iOS app on real device with tags
-testingbot maestro app.ipa ./flows --platform iOS --real-device --include-tags "smoke,regression"
+# Android app on real device with tags
+testingbot maestro app.apk ./flows --device "Samsung Galaxy S24" --real-device --include-tags "smoke,regression"
 
 # With environment variables
 testingbot maestro app.apk ./flows -e API_URL=https://staging.example.com -e API_KEY=secret
@@ -109,8 +173,21 @@ testingbot maestro app.apk ./flows --report junit --report-output-dir ./reports
 # Download all artifacts (logs, screenshots, video)
 testingbot maestro app.apk ./flows --download-artifacts --build "build-123"
 
+# Download artifacts only for failed tests
+testingbot maestro app.apk ./flows --download-artifacts failed --artifacts-output-dir ./artifacts
+
 # Run in background (async)
 testingbot maestro app.apk ./flows --async
+
+# Split flows across 3 shards, grouping all flows over 3 parallel sessions
+testingbot maestro app.apk ./flows --shard-split 3
+
+# CI/CD integration with Git metadata
+testingbot maestro app.apk ./flows \
+  --commit-sha "abc123def" \
+  --pull-request-id "42" \
+  --repo-owner "myorg" \
+  --repo-name "myapp"
 ```
 
 ---
@@ -324,7 +401,7 @@ testingbot xcuitest app.ipa app-test.zip \
 ### Real-time Progress
 
 By default, the CLI shows real-time progress updates including:
-- Test status updates
+- Test status updates with actual device names (even when using wildcards)
 - Device allocation status
 - Live output from Maestro flows
 

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAwBpC,QAAA,MAAM,OAAO,SAAgB,CAAC;AAyf9B,eAAe,OAAO,CAAC"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA0BpC,QAAA,MAAM,OAAO,SAAgB,CAAC;AAwkB9B,eAAe,OAAO,CAAC"}

package/dist/cli.js

@@ -14,6 +14,7 @@ const package_json_1 = __importDefault(require("../package.json"));
 const maestro_options_1 = __importDefault(require("./models/maestro_options"));
 const maestro_1 = __importDefault(require("./providers/maestro"));
 const login_1 = __importDefault(require("./providers/login"));
+const testingbot_error_1 = __importDefault(require("./models/testingbot_error"));
 const program = new commander_1.Command();
 program
     .name('testingbot')
@@ -59,6 +60,11 @@ const espressoCommand = program
     // Report options
     .option('--report <format>', 'Download test report after completion: html or junit.', (val) => val.toLowerCase())
     .option('--report-output-dir <path>', 'Directory to save test reports (required when --report is used).')
+    // CI/CD metadata
+    .option('--commit-sha <sha>', 'The commit SHA of this upload.')
+    .option('--pull-request-id <id>', 'The ID of the pull request this upload originated from.')
+    .option('--repo-name <name>', 'Repository name (e.g., GitHub repo slug).')
+    .option('--repo-owner <owner>', 'Repository owner (e.g., GitHub organization or user slug).')
     // Authentication
     .option('--api-key <key>', 'TestingBot API key.')
     .option('--api-secret <secret>', 'TestingBot API secret.')
@@ -71,6 +77,14 @@ const espressoCommand = program
             espressoCommand.help();
             return;
         }
+        const metadata = args.commitSha || args.pullRequestId || args.repoName || args.repoOwner
+            ? {
+                commitSha: args.commitSha,
+                pullRequestId: args.pullRequestId,
+                repoName: args.repoName,
+                repoOwner: args.repoOwner,
+            }
+            : undefined;
         const options = new espresso_options_1.default(app, testApp, args.device, {
             version: args.platformVersion,
             realDevice: args.realDevice,
@@ -95,13 +109,14 @@ const espressoCommand = program
             async: args.async,
             report: args.report,
             reportOutputDir: args.reportOutputDir,
+            metadata,
         });
         const credentials = await auth_1.default.getCredentials({
             apiKey: args.apiKey,
             apiSecret: args.apiSecret,
         });
         if (credentials === null) {
-            throw new Error('No TestingBot credentials found. Please authenticate using one of these methods:\n' +
+            throw new testingbot_error_1.default('No TestingBot credentials found. Please authenticate using one of these methods:\n' +
                 '  1. Run "testingbot login" to authenticate via browser (recommended)\n' +
                 '  2. Use --api-key and --api-secret options\n' +
                 '  3. Set TB_KEY and TB_SECRET environment variables\n' +
@@ -135,8 +150,7 @@ const maestroCommand = program
     .option('--device-locale <locale>', 'Device locale (e.g., "en_US", "de_DE").')
     .option('--timezone <timezone>', 'Device timezone (e.g., "America/New_York", "Europe/London").')
     // Test metadata
-    .option('--name <name>', 'Test name for identification in dashboard.')
-    .option('--build <build>', 'Build identifier for grouping test runs.')
+    .option('--name <name>', 'Name for this Maestro run.')
     // Network and geo
     .option('--throttle-network <speed>', 'Network throttling: 4G, 3G, Edge, airplane, or disable.', (val) => val)
     .option('--geo-country-code <code>', 'Geographic IP location (ISO country code, e.g., "US", "DE").')
@@ -157,8 +171,15 @@ const maestroCommand = program
     .option('--report <format>', 'Download test report after completion: html or junit.', (val) => val.toLowerCase())
     .option('--report-output-dir <path>', 'Directory to save test reports (required when --report is used).')
     // Artifact download
-    .option('--download-artifacts', 'Download test artifacts (logs, screenshots, video) after completion.')
+    .option('--download-artifacts [mode]', 'Download test artifacts after completion. Mode: all (default) or failed.', (val) => (val === 'failed' ? 'failed' : 'all'))
     .option('--artifacts-output-dir <path>', 'Directory to save artifacts zip (defaults to current directory).')
+    .option('--ignore-checksum-check', 'Skip checksum verification and always upload the app.')
+    .option('--shard-split <number>', 'Number of chunks to split flows into (by default each flow runs on its own session).', (val) => parseInt(val, 10))
+    // CI/CD metadata
+    .option('--commit-sha <sha>', 'The commit SHA of this upload.')
+    .option('--pull-request-id <id>', 'The ID of the pull request this upload originated from.')
+    .option('--repo-name <name>', 'Repository name (e.g., GitHub repo slug).')
+    .option('--repo-owner <owner>', 'Repository owner (e.g., GitHub organization or user slug).')
     // Authentication
     .option('--api-key <key>', 'TestingBot API key.')
     .option('--api-secret <secret>', 'TestingBot API secret.')
@@ -192,13 +213,20 @@ const maestroCommand = program
                 env[key] = value;
             }
         }
+        const metadata = args.commitSha || args.pullRequestId || args.repoName || args.repoOwner
+            ? {
+                commitSha: args.commitSha,
+                pullRequestId: args.pullRequestId,
+                repoName: args.repoName,
+                repoOwner: args.repoOwner,
+            }
+            : undefined;
         const options = new maestro_options_1.default(app, flows, args.device, {
             includeTags: args.includeTags,
             excludeTags: args.excludeTags,
             platformName: args.platform,
             version: args.deviceVersion,
             name: args.name,
-            build: args.build,
             orientation: args.orientation,
             locale: args.deviceLocale,
             timeZone: args.timezone,
@@ -211,15 +239,20 @@ const maestroCommand = program
             report: args.report,
             reportOutputDir: args.reportOutputDir,
             realDevice: args.realDevice,
-            downloadArtifacts: args.downloadArtifacts,
+            downloadArtifacts: args.downloadArtifacts === true
+                ? 'all'
+                : args.downloadArtifacts,
             artifactsOutputDir: args.artifactsOutputDir,
+            ignoreChecksumCheck: args.ignoreChecksumCheck,
+            shardSplit: args.shardSplit,
+            metadata,
         });
         const credentials = await auth_1.default.getCredentials({
             apiKey: args.apiKey,
             apiSecret: args.apiSecret,
         });
         if (credentials === null) {
-            throw new Error('No TestingBot credentials found. Please authenticate using one of these methods:\n' +
+            throw new testingbot_error_1.default('No TestingBot credentials found. Please authenticate using one of these methods:\n' +
                 '  1. Run "testingbot login" to authenticate via browser (recommended)\n' +
                 '  2. Use --api-key and --api-secret options\n' +
                 '  3. Set TB_KEY and TB_SECRET environment variables\n' +
@@ -269,6 +302,11 @@ const xcuitestCommand = program
     // Report options
     .option('--report <format>', 'Download test report after completion: html or junit.', (val) => val.toLowerCase())
     .option('--report-output-dir <path>', 'Directory to save test reports (required when --report is used).')
+    // CI/CD metadata
+    .option('--commit-sha <sha>', 'The commit SHA of this upload.')
+    .option('--pull-request-id <id>', 'The ID of the pull request this upload originated from.')
+    .option('--repo-name <name>', 'Repository name (e.g., GitHub repo slug).')
+    .option('--repo-owner <owner>', 'Repository owner (e.g., GitHub organization or user slug).')
     // Authentication
     .option('--api-key <key>', 'TestingBot API key.')
     .option('--api-secret <secret>', 'TestingBot API secret.')
@@ -281,6 +319,14 @@ const xcuitestCommand = program
             xcuitestCommand.help();
             return;
         }
+        const metadata = args.commitSha || args.pullRequestId || args.repoName || args.repoOwner
+            ? {
+                commitSha: args.commitSha,
+                pullRequestId: args.pullRequestId,
+                repoName: args.repoName,
+                repoOwner: args.repoOwner,
+            }
+            : undefined;
         const options = new xcuitest_options_1.default(app, testApp, args.device, {
             version: args.platformVersion,
             realDevice: args.realDevice,
@@ -298,13 +344,14 @@ const xcuitestCommand = program
             async: args.async,
             report: args.report,
             reportOutputDir: args.reportOutputDir,
+            metadata,
         });
         const credentials = await auth_1.default.getCredentials({
             apiKey: args.apiKey,
             apiSecret: args.apiSecret,
         });
         if (credentials === null) {
-            throw new Error('No TestingBot credentials found. Please authenticate using one of these methods:\n' +
+            throw new testingbot_error_1.default('No TestingBot credentials found. Please authenticate using one of these methods:\n' +
                 '  1. Run "testingbot login" to authenticate via browser (recommended)\n' +
                 '  2. Use --api-key and --api-secret options\n' +
                 '  3. Set TB_KEY and TB_SECRET environment variables\n' +

package/dist/logger.js

@@ -3,7 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-const colors_1 = __importDefault(require("colors"));
+const picocolors_1 = __importDefault(require("picocolors"));
 const tracer_1 = __importDefault(require("tracer"));
 const logger = tracer_1.default.colorConsole({
     level: 'info',
@@ -11,9 +11,9 @@ const logger = tracer_1.default.colorConsole({
     dateformat: 'HH:MM:ss.L',
     filters: [
         {
-            warn: colors_1.default.red,
-            debug: colors_1.default.blue,
-            error: [colors_1.default.red, colors_1.default.bold],
+            warn: picocolors_1.default.red,
+            debug: picocolors_1.default.blue,
+            error: (text) => picocolors_1.default.bold(picocolors_1.default.red(text)),
         },
     ],
 });

package/dist/models/espresso_options.d.ts

@@ -1,6 +1,12 @@
 export type TestSize = 'small' | 'medium' | 'large';
 export type ReportFormat = 'html' | 'junit';
 export type ThrottleNetwork = '4G' | '3G' | 'Edge' | 'airplane';
+export interface RunMetadata {
+    commitSha?: string;
+    pullRequestId?: string;
+    repoName?: string;
+    repoOwner?: string;
+}
 export interface CustomNetworkProfile {
     uploadSpeed: number;
     downloadSpeed: number;
@@ -59,6 +65,7 @@ export default class EspressoOptions {
     private _async;
     private _report?;
     private _reportOutputDir?;
+    private _metadata?;
     constructor(app: string, testApp: string, device?: string, options?: {
         version?: string;
         realDevice?: boolean;
@@ -83,6 +90,7 @@ export default class EspressoOptions {
         async?: boolean;
         report?: ReportFormat;
         reportOutputDir?: string;
+        metadata?: RunMetadata;
     });
     get app(): string;
     get testApp(): string;
@@ -110,6 +118,7 @@ export default class EspressoOptions {
     get async(): boolean;
     get report(): ReportFormat | undefined;
     get reportOutputDir(): string | undefined;
+    get metadata(): RunMetadata | undefined;
     getCapabilities(): EspressoCapabilities;
     getEspressoOptions(): EspressoRunOptions | undefined;
 }

package/dist/models/espresso_options.d.ts.map

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

package/dist/models/espresso_options.js

@@ -1,5 +1,9 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
+const testingbot_error_1 = __importDefault(require("./testingbot_error"));
 class EspressoOptions {
     _app;
     _testApp;
@@ -32,6 +36,8 @@ class EspressoOptions {
     _async;
     _report;
     _reportOutputDir;
+    // Metadata
+    _metadata;
     constructor(app, testApp, device, options) {
         this._app = app;
         this._testApp = testApp;
@@ -40,6 +46,10 @@ class EspressoOptions {
         this._realDevice = options?.realDevice ?? false;
         this._tabletOnly = options?.tabletOnly ?? false;
         this._phoneOnly = options?.phoneOnly ?? false;
+        // Validate contradictory options
+        if (this._tabletOnly && this._phoneOnly) {
+            throw new testingbot_error_1.default('Cannot specify both --phone-only and --tablet-only options');
+        }
         this._name = options?.name;
         this._build = options?.build;
         this._testRunner = options?.testRunner;
@@ -59,6 +69,7 @@ class EspressoOptions {
         this._async = options?.async ?? false;
         this._report = options?.report;
         this._reportOutputDir = options?.reportOutputDir;
+        this._metadata = options?.metadata;
     }
     get app() {
         return this._app;
@@ -138,6 +149,9 @@ class EspressoOptions {
     get reportOutputDir() {
         return this._reportOutputDir;
     }
+    get metadata() {
+        return this._metadata;
+    }
     getCapabilities() {
         const caps = {
             platformName: 'Android',

package/dist/models/maestro_options.d.ts

@@ -7,12 +7,18 @@ export interface MaestroConfig {
 export type Orientation = 'PORTRAIT' | 'LANDSCAPE';
 export type ThrottleNetwork = '4G' | '3G' | 'Edge' | 'airplane' | 'disable';
 export type ReportFormat = 'html' | 'junit';
+export type ArtifactDownloadMode = 'all' | 'failed';
+export interface RunMetadata {
+    commitSha?: string;
+    pullRequestId?: string;
+    repoName?: string;
+    repoOwner?: string;
+}
 export interface MaestroCapabilities {
     platformName?: 'Android' | 'iOS';
     version?: string;
     deviceName: string;
     name?: string;
-    build?: string;
     orientation?: Orientation;
     locale?: string;
     timeZone?: string;
@@ -27,6 +33,7 @@ export interface MaestroRunOptions {
     version?: string;
 }
 export default class MaestroOptions {
+    private static isIpaFile;
     private _app;
     private _flows;
     private _device?;
@@ -35,7 +42,6 @@ export default class MaestroOptions {
     private _platformName?;
     private _version?;
     private _name?;
-    private _build?;
     private _orientation?;
     private _locale?;
     private _timeZone?;
@@ -48,15 +54,17 @@ export default class MaestroOptions {
     private _report?;
     private _reportOutputDir?;
     private _realDevice;
-    private _downloadArtifacts;
+    private _downloadArtifacts?;
     private _artifactsOutputDir?;
+    private _ignoreChecksumCheck;
+    private _shardSplit?;
+    private _metadata?;
     constructor(app: string, flows: string | string[], device?: string, options?: {
         includeTags?: string[];
         excludeTags?: string[];
         platformName?: 'Android' | 'iOS';
         version?: string;
         name?: string;
-        build?: string;
         orientation?: Orientation;
         locale?: string;
         timeZone?: string;
@@ -69,8 +77,11 @@ export default class MaestroOptions {
         report?: ReportFormat;
         reportOutputDir?: string;
         realDevice?: boolean;
-        downloadArtifacts?: boolean;
+        downloadArtifacts?: ArtifactDownloadMode;
         artifactsOutputDir?: string;
+        ignoreChecksumCheck?: boolean;
+        shardSplit?: number;
+        metadata?: RunMetadata;
     });
     get app(): string;
     get flows(): string[];
@@ -80,7 +91,6 @@ export default class MaestroOptions {
     get platformName(): 'Android' | 'iOS' | undefined;
     get version(): string | undefined;
     get name(): string | undefined;
-    get build(): string | undefined;
     get orientation(): Orientation | undefined;
     get locale(): string | undefined;
     get timeZone(): string | undefined;
@@ -93,8 +103,11 @@ export default class MaestroOptions {
     get report(): ReportFormat | undefined;
     get reportOutputDir(): string | undefined;
     get realDevice(): boolean;
-    get downloadArtifacts(): boolean;
+    get downloadArtifacts(): ArtifactDownloadMode | undefined;
     get artifactsOutputDir(): string | undefined;
+    get ignoreChecksumCheck(): boolean;
+    get shardSplit(): number | undefined;
+    get metadata(): RunMetadata | undefined;
     getMaestroOptions(): MaestroRunOptions | undefined;
     getCapabilities(detectedPlatform?: 'Android' | 'iOS'): MaestroCapabilities;
 }

package/dist/models/maestro_options.d.ts.map

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

package/dist/models/maestro_options.js

@@ -1,6 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 class MaestroOptions {
+    static isIpaFile(app) {
+        return app?.toLowerCase().endsWith('.ipa') ?? false;
+    }
     _app;
     _flows;
     _device;
@@ -9,7 +12,6 @@ class MaestroOptions {
     _platformName;
     _version;
     _name;
-    _build;
     _orientation;
     _locale;
     _timeZone;
@@ -24,6 +26,10 @@ class MaestroOptions {
     _realDevice;
     _downloadArtifacts;
     _artifactsOutputDir;
+    _ignoreChecksumCheck;
+    _shardSplit;
+    // Metadata
+    _metadata;
     constructor(app, flows, device, options) {
         this._app = app;
         this._flows = flows ? (Array.isArray(flows) ? flows : [flows]) : [];
@@ -33,7 +39,6 @@ class MaestroOptions {
         this._platformName = options?.platformName;
         this._version = options?.version;
         this._name = options?.name;
-        this._build = options?.build;
         this._orientation = options?.orientation;
         this._locale = options?.locale;
         this._timeZone = options?.timeZone;
@@ -45,9 +50,13 @@ class MaestroOptions {
         this._async = options?.async ?? false;
         this._report = options?.report;
         this._reportOutputDir = options?.reportOutputDir;
-        this._realDevice = options?.realDevice ?? false;
-        this._downloadArtifacts = options?.downloadArtifacts ?? false;
+        // IPA files can only be tested on real iOS devices, so automatically enable realDevice
+        this._realDevice = MaestroOptions.isIpaFile(app) || (options?.realDevice ?? false);
+        this._downloadArtifacts = options?.downloadArtifacts;
         this._artifactsOutputDir = options?.artifactsOutputDir;
+        this._ignoreChecksumCheck = options?.ignoreChecksumCheck ?? false;
+        this._shardSplit = options?.shardSplit;
+        this._metadata = options?.metadata;
     }
     get app() {
         return this._app;
@@ -73,9 +82,6 @@ class MaestroOptions {
     get name() {
         return this._name;
     }
-    get build() {
-        return this._build;
-    }
     get orientation() {
         return this._orientation;
     }
@@ -118,6 +124,15 @@ class MaestroOptions {
     get artifactsOutputDir() {
         return this._artifactsOutputDir;
     }
+    get ignoreChecksumCheck() {
+        return this._ignoreChecksumCheck;
+    }
+    get shardSplit() {
+        return this._shardSplit;
+    }
+    get metadata() {
+        return this._metadata;
+    }
     getMaestroOptions() {
         const opts = {};
         if (this._includeTags && this._includeTags.length > 0) {
@@ -156,8 +171,6 @@ class MaestroOptions {
             caps.version = this._version;
         if (this._name)
             caps.name = this._name;
-        if (this._build)
-            caps.build = this._build;
         if (this._orientation)
             caps.orientation = this._orientation;
         if (this._locale)

package/dist/models/testingbot_error.d.ts

@@ -1,3 +1,6 @@
 export default class TestingBotError extends Error {
+    constructor(message: string, options?: {
+        cause?: unknown;
+    });
 }
 //# sourceMappingURL=testingbot_error.d.ts.map

package/dist/models/testingbot_error.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"testingbot_error.d.ts","sourceRoot":"","sources":["../../src/models/testingbot_error.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,OAAO,OAAO,eAAgB,SAAQ,KAAK;CAAG"}
+{"version":3,"file":"testingbot_error.d.ts","sourceRoot":"","sources":["../../src/models/testingbot_error.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,OAAO,OAAO,eAAgB,SAAQ,KAAK;gBACpC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAK3D"}

package/dist/models/testingbot_error.js

@@ -1,5 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 class TestingBotError extends Error {
+    constructor(message, options) {
+        super(message, options);
+        this.name = 'TestingBotError';
+        Object.setPrototypeOf(this, TestingBotError.prototype);
+    }
 }
 exports.default = TestingBotError;