@testingbot/cli 1.0.0

package/dist/upload.js

@@ -0,0 +1,94 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const axios_1 = __importDefault(require("axios"));
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const form_data_1 = __importDefault(require("form-data"));
+const testingbot_error_1 = __importDefault(require("./models/testingbot_error"));
+const utils_1 = __importDefault(require("./utils"));
+class Upload {
+    lastProgressPercent = 0;
+    async upload(options) {
+        const { filePath, url, credentials, contentType, showProgress = false, } = options;
+        await this.validateFile(filePath);
+        const fileName = node_path_1.default.basename(filePath);
+        const fileStats = await node_fs_1.default.promises.stat(filePath);
+        const fileStream = node_fs_1.default.createReadStream(filePath);
+        const formData = new form_data_1.default();
+        formData.append('file', fileStream);
+        try {
+            const response = await axios_1.default.post(url, formData, {
+                headers: {
+                    'Content-Type': contentType,
+                    'Content-Disposition': `attachment; filename=${fileName}`,
+                    'User-Agent': utils_1.default.getUserAgent(),
+                },
+                auth: {
+                    username: credentials.userName,
+                    password: credentials.accessKey,
+                },
+                maxContentLength: Infinity,
+                maxBodyLength: Infinity,
+                onUploadProgress: showProgress
+                    ? (progressEvent) => {
+                        this.handleProgress(progressEvent, fileStats.size, fileName);
+                    }
+                    : undefined,
+            });
+            const result = response.data;
+            if (result.id) {
+                if (showProgress) {
+                    this.clearProgressLine();
+                }
+                return { id: result.id };
+            }
+            else {
+                throw new testingbot_error_1.default(`Upload failed: ${result.error || 'Unknown error'}`);
+            }
+        }
+        catch (error) {
+            if (error instanceof testingbot_error_1.default) {
+                throw error;
+            }
+            if (axios_1.default.isAxiosError(error)) {
+                const message = error.response?.data?.error || error.message;
+                throw new testingbot_error_1.default(`Upload failed: ${message}`);
+            }
+            throw new testingbot_error_1.default(`Upload failed: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    async validateFile(filePath) {
+        try {
+            await node_fs_1.default.promises.access(filePath, node_fs_1.default.constants.R_OK);
+        }
+        catch {
+            throw new testingbot_error_1.default(`File not found or not readable: ${filePath}`);
+        }
+    }
+    handleProgress(progressEvent, totalSize, fileName) {
+        const loaded = progressEvent.loaded;
+        const total = progressEvent.total || totalSize;
+        const percent = Math.round((loaded / total) * 100);
+        if (percent !== this.lastProgressPercent) {
+            this.lastProgressPercent = percent;
+            this.displayProgress(fileName, percent, loaded, total);
+        }
+    }
+    displayProgress(fileName, percent, loaded, total) {
+        const barWidth = 30;
+        const filledWidth = Math.round((percent / 100) * barWidth);
+        const emptyWidth = barWidth - filledWidth;
+        const bar = '█'.repeat(filledWidth) + '░'.repeat(emptyWidth);
+        const loadedMB = (loaded / (1024 * 1024)).toFixed(2);
+        const totalMB = (total / (1024 * 1024)).toFixed(2);
+        process.stdout.write(`\r  ${fileName}: [${bar}] ${percent}% (${loadedMB}/${totalMB} MB)`);
+    }
+    clearProgressLine() {
+        process.stdout.write('\r' + ' '.repeat(80) + '\r');
+        this.lastProgressPercent = 0;
+    }
+}
+exports.default = Upload;

package/dist/utils/file-type-detector.d.ts

@@ -0,0 +1,15 @@
+export interface FileTypeResult {
+    ext: string;
+    mime: string;
+}
+/**
+ * Detect file type from file content using magic bytes.
+ * Returns undefined if the file type cannot be determined.
+ */
+export declare function detectFileType(filePath: string): Promise<FileTypeResult | undefined>;
+/**
+ * Detect platform (Android or iOS) from app file.
+ * Uses magic bytes for content detection, with extension fallback for zip-based formats.
+ */
+export declare function detectPlatformFromFile(filePath: string): Promise<'Android' | 'iOS' | undefined>;
+//# sourceMappingURL=file-type-detector.d.ts.map

package/dist/utils/file-type-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-type-detector.d.ts","sourceRoot":"","sources":["../../src/utils/file-type-detector.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAClC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CASrC;AAED;;;GAGG;AACH,wBAAsB,sBAAsB,CAC1C,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,SAAS,GAAG,KAAK,GAAG,SAAS,CAAC,CAmBxC"}

package/dist/utils/file-type-detector.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.detectFileType = detectFileType;
+exports.detectPlatformFromFile = detectPlatformFromFile;
+/**
+ * Detect file type from file content using magic bytes.
+ * Returns undefined if the file type cannot be determined.
+ */
+async function detectFileType(filePath) {
+    try {
+        // Dynamic import for ESM-only file-type package
+        const { fileTypeFromFile } = await import('file-type');
+        const result = await fileTypeFromFile(filePath);
+        return result;
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Detect platform (Android or iOS) from app file.
+ * Uses magic bytes for content detection, with extension fallback for zip-based formats.
+ */
+async function detectPlatformFromFile(filePath) {
+    const fileType = await detectFileType(filePath);
+    if (fileType) {
+        // APK files are detected as 'application/zip' with ext 'apk'
+        // or as 'application/vnd.android.package-archive'
+        if (fileType.ext === 'apk' ||
+            fileType.mime === 'application/vnd.android.package-archive') {
+            return 'Android';
+        }
+        if (fileType.ext === 'zip' || fileType.mime === 'application/zip') {
+            return 'iOS';
+        }
+    }
+    return undefined;
+}

package/dist/utils/platform.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Cross-platform utilities for terminal operations and signal handling
+ */
+/**
+ * Clear the current line in the terminal.
+ * Uses ANSI escape codes on Unix/macOS, and space overwrite on Windows.
+ */
+export declare function clearLine(): void;
+/**
+ * Setup signal handlers for graceful shutdown.
+ * SIGINT (Ctrl+C) works on all platforms.
+ * SIGTERM only works on Unix/macOS.
+ */
+export declare function setupSignalHandlers(handler: () => void): void;
+/**
+ * Remove signal handlers.
+ */
+export declare function removeSignalHandlers(handler: () => void): void;
+declare const _default: {
+    isWindows: boolean;
+    clearLine: typeof clearLine;
+    setupSignalHandlers: typeof setupSignalHandlers;
+    removeSignalHandlers: typeof removeSignalHandlers;
+};
+export default _default;
+//# sourceMappingURL=platform.d.ts.map

package/dist/utils/platform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform.d.ts","sourceRoot":"","sources":["../../src/utils/platform.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;;GAGG;AACH,wBAAgB,SAAS,IAAI,IAAI,CAehC;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,IAAI,GAAG,IAAI,CAO7D;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,IAAI,GAAG,IAAI,CAM9D;;;;;;;AAED,wBAKE"}

package/dist/utils/platform.js

@@ -0,0 +1,58 @@
+"use strict";
+/**
+ * Cross-platform utilities for terminal operations and signal handling
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.clearLine = clearLine;
+exports.setupSignalHandlers = setupSignalHandlers;
+exports.removeSignalHandlers = removeSignalHandlers;
+const isWindows = process.platform === 'win32';
+/**
+ * Clear the current line in the terminal.
+ * Uses ANSI escape codes on Unix/macOS, and space overwrite on Windows.
+ */
+function clearLine() {
+    if (isWindows) {
+        // Windows fallback: overwrite with spaces and return to start
+        // Use readline if available for better Windows support
+        if (process.stdout.clearLine && process.stdout.cursorTo) {
+            process.stdout.clearLine(0);
+            process.stdout.cursorTo(0);
+        }
+        else {
+            // Fallback: write spaces to clear typical line width
+            process.stdout.write('\r' + ' '.repeat(120) + '\r');
+        }
+    }
+    else {
+        // Unix/macOS: ANSI escape sequence
+        process.stdout.write('\r\x1b[K');
+    }
+}
+/**
+ * Setup signal handlers for graceful shutdown.
+ * SIGINT (Ctrl+C) works on all platforms.
+ * SIGTERM only works on Unix/macOS.
+ */
+function setupSignalHandlers(handler) {
+    process.on('SIGINT', handler);
+    // SIGTERM is not supported on Windows
+    if (!isWindows) {
+        process.on('SIGTERM', handler);
+    }
+}
+/**
+ * Remove signal handlers.
+ */
+function removeSignalHandlers(handler) {
+    process.removeListener('SIGINT', handler);
+    if (!isWindows) {
+        process.removeListener('SIGTERM', handler);
+    }
+}
+exports.default = {
+    isWindows,
+    clearLine,
+    setupSignalHandlers,
+    removeSignalHandlers,
+};

package/dist/utils.d.ts

@@ -0,0 +1,15 @@
+declare const _default: {
+    getUserAgent(): string;
+    getCurrentVersion(): string;
+    /**
+     * Compare two semver version strings
+     * Returns: -1 if v1 < v2, 0 if equal, 1 if v1 > v2
+     */
+    compareVersions(v1: string, v2: string): number;
+    /**
+     * Check if a newer version is available and display update notice
+     */
+    checkForUpdate(latestVersion: string | undefined): void;
+};
+export default _default;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":";oBAOkB,MAAM;yBAID,MAAM;IAI3B;;;OAGG;wBACiB,MAAM,MAAM,MAAM,GAAG,MAAM;IAa/C;;OAEG;kCAC2B,MAAM,GAAG,SAAS,GAAG,IAAI;;AA7BzD,wBAiDE"}

package/dist/utils.js

@@ -0,0 +1,48 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const package_json_1 = __importDefault(require("../package.json"));
+const logger_1 = __importDefault(require("./logger"));
+const colors_1 = __importDefault(require("colors"));
+let versionCheckDisplayed = false;
+exports.default = {
+    getUserAgent() {
+        return `TestingBot-CTL-${package_json_1.default.version}`;
+    },
+    getCurrentVersion() {
+        return package_json_1.default.version;
+    },
+    /**
+     * Compare two semver version strings
+     * Returns: -1 if v1 < v2, 0 if equal, 1 if v1 > v2
+     */
+    compareVersions(v1, v2) {
+        const parts1 = v1.split('.').map(Number);
+        const parts2 = v2.split('.').map(Number);
+        for (let i = 0; i < Math.max(parts1.length, parts2.length); i++) {
+            const p1 = parts1[i] || 0;
+            const p2 = parts2[i] || 0;
+            if (p1 < p2)
+                return -1;
+            if (p1 > p2)
+                return 1;
+        }
+        return 0;
+    },
+    /**
+     * Check if a newer version is available and display update notice
+     */
+    checkForUpdate(latestVersion) {
+        if (!latestVersion || versionCheckDisplayed) {
+            return;
+        }
+        const currentVersion = this.getCurrentVersion();
+        if (this.compareVersions(currentVersion, latestVersion) < 0) {
+            versionCheckDisplayed = true;
+            logger_1.default.warn(colors_1.default.yellow(`\n📦 A new version of testingbotctl is available: ${colors_1.default.green(latestVersion)} (current: ${currentVersion})`));
+            logger_1.default.warn(colors_1.default.yellow(`   Run ${colors_1.default.cyan('npm update -g testingbotctl')} to update.\n`));
+        }
+    },
+};

package/package.json

@@ -0,0 +1,78 @@
+{
+  "name": "@testingbot/cli",
+  "version": "1.0.0",
+  "description": "CLI tool to run Espresso, XCUITest, and Maestro tests on TestingBot's cloud infrastructure",
+  "main": "dist/index.js",
+  "bin": {
+    "testingbot": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "lint": "prettier --check '**/*.{js,ts}' && eslint src/",
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "start": "node dist/index.js",
+    "format": "prettier --write '**/*.{js,ts}'",
+    "test": "jest"
+  },
+  "keywords": [
+    "testingbot",
+    "mobile-testing",
+    "espresso",
+    "xcuitest",
+    "maestro",
+    "android",
+    "ios",
+    "test-automation",
+    "cloud-testing",
+    "cli",
+    "real-devices",
+    "emulators",
+    "simulators"
+  ],
+  "author": "TestingBot",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/testingbot/testingbotctl.git"
+  },
+  "homepage": "https://testingbot.com",
+  "bugs": {
+    "url": "https://github.com/testingbot/testingbotctl/issues"
+  },
+  "dependencies": {
+    "archiver": "^7.0.1",
+    "axios": "^1.13.2",
+    "colors": "^1.4.0",
+    "commander": "^14.0.2",
+    "file-type": "^21.1.1",
+    "form-data": "^4.0.5",
+    "glob": "^13.0.0",
+    "js-yaml": "^4.1.1",
+    "socket.io-client": "^4.8.1",
+    "tracer": "^1.3.0"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.39.1",
+    "@tsconfig/node20": "^20.1.8",
+    "@types/archiver": "^7.0.0",
+    "@types/jest": "^29.5.14",
+    "@types/js-yaml": "^4.0.9",
+    "@types/node": "^20.19.0",
+    "babel-jest": "^29.7.0",
+    "eslint": "^9.39.1",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-prettier": "^5.5.4",
+    "jest": "^29.7.0",
+    "prettier": "^3.7.4",
+    "ts-jest": "^29.4.6",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.48.1"
+  }
+}