appium-espresso-driver 8.4.0 → 8.5.0

package/CHANGELOG.md

@@ -1,3 +1,15 @@
+## [8.5.0](https://github.com/appium/appium-espresso-driver/compare/v8.4.1...v8.5.0) (2026-05-20)
+
+### Features
+
+* Refactor driver methods into focused domain modules ([#1162](https://github.com/appium/appium-espresso-driver/issues/1162)) ([aa74a0d](https://github.com/appium/appium-espresso-driver/commit/aa74a0d06b181472387bfd42c3a32f23b5f68988))
+
+## [8.4.1](https://github.com/appium/appium-espresso-driver/compare/v8.4.0...v8.4.1) (2026-05-12)
+
+### Miscellaneous Chores
+
+* **deps:** bump gradle-wrapper from 9.5.0 to 9.5.1 in /espresso-server ([#1161](https://github.com/appium/appium-espresso-driver/issues/1161)) ([b6e0cfb](https://github.com/appium/appium-espresso-driver/commit/b6e0cfbf0c0daff6aa89ccc3a5c472ed79b94106))
+
 ## [8.4.0](https://github.com/appium/appium-espresso-driver/compare/v8.3.1...v8.4.0) (2026-05-12)
 
 ### Features

package/build/lib/commands/app-install.d.ts

@@ -0,0 +1,21 @@
+import type { PostProcessOptions, PostProcessResult } from '@appium/types';
+import type { EspressoDriver } from '../driver';
+export declare const APK_EXT = ".apk";
+export declare const AAB_EXT = ".aab";
+export declare const SUPPORTED_EXTENSIONS: string[];
+/** Whether the session targets an app already installed on the device (no app path). */
+export declare function isAppOnDevice(driver: EspressoDriver): boolean;
+/**
+ * Unzip the given app path and return the first package that has SUPPORTED_EXTENSIONS
+ * in the archived file.
+ *
+ * @param appPath The path to app file.
+ * @returns The path to an unzipped app file path.
+ * @throws If the zip did not have any SUPPORTED_EXTENSIONS packages.
+ */
+export declare function unzipApp(this: EspressoDriver, appPath: string): Promise<string>;
+/** Post-processes configured apps and reuses a valid cache entry when possible. */
+export declare function onPostConfigureApp(this: EspressoDriver, opts: PostProcessOptions): Promise<PostProcessResult | undefined>;
+/** Prepare the application under test on the device. */
+export declare function initAUT(this: EspressoDriver): Promise<void>;
+//# sourceMappingURL=app-install.d.ts.map

package/build/lib/commands/app-install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-install.d.ts","sourceRoot":"","sources":["../../../lib/commands/app-install.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,kBAAkB,EAAE,iBAAiB,EAAC,MAAM,eAAe,CAAC;AAKzE,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,WAAW,CAAC;AAI9C,eAAO,MAAM,OAAO,SAAS,CAAC;AAC9B,eAAO,MAAM,OAAO,SAAS,CAAC;AAC9B,eAAO,MAAM,oBAAoB,UAAqB,CAAC;AAEvD,wFAAwF;AACxF,wBAAgB,aAAa,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAG7D;AAED;;;;;;;GAOG;AACH,wBAAsB,QAAQ,CAAC,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAuBrF;AAED,mFAAmF;AACnF,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,cAAc,EACpB,IAAI,EAAE,kBAAkB,GACvB,OAAO,CAAC,iBAAiB,GAAG,SAAS,CAAC,CAiExC;AAED,wDAAwD;AACxD,wBAAsB,OAAO,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAoDjE"}

package/build/lib/commands/app-install.js

@@ -0,0 +1,157 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SUPPORTED_EXTENSIONS = exports.AAB_EXT = exports.APK_EXT = void 0;
+exports.isAppOnDevice = isAppOnDevice;
+exports.unzipApp = unzipApp;
+exports.onPostConfigureApp = onPostConfigureApp;
+exports.initAUT = initAUT;
+const appium_android_driver_1 = require("appium-android-driver");
+const support_1 = require("appium/support");
+const io_appium_settings_1 = require("io.appium.settings");
+const node_path_1 = __importDefault(require("node:path"));
+const app_1 = require("./app");
+const server_1 = require("./server");
+exports.APK_EXT = '.apk';
+exports.AAB_EXT = '.aab';
+exports.SUPPORTED_EXTENSIONS = [exports.APK_EXT, exports.AAB_EXT];
+/** Whether the session targets an app already installed on the device (no app path). */
+function isAppOnDevice(driver) {
+    const appPackage = driver.opts.appPackage;
+    return !driver.opts.app && !!appPackage && driver.helpers.isPackageOrBundle(appPackage);
+}
+/**
+ * Unzip the given app path and return the first package that has SUPPORTED_EXTENSIONS
+ * in the archived file.
+ *
+ * @param appPath The path to app file.
+ * @returns The path to an unzipped app file path.
+ * @throws If the zip did not have any SUPPORTED_EXTENSIONS packages.
+ */
+async function unzipApp(appPath) {
+    const useSystemUnzipEnv = process.env.APPIUM_PREFER_SYSTEM_UNZIP;
+    const useSystemUnzip = !useSystemUnzipEnv || !['0', 'false'].includes(useSystemUnzipEnv.toLowerCase());
+    const tmpRoot = await support_1.tempDir.openDir();
+    await support_1.zip.extractAllTo(appPath, tmpRoot, { useSystemUnzip });
+    const globPattern = `**/*.+(${exports.SUPPORTED_EXTENSIONS.map((ext) => ext.replace(/^\./, '')).join('|')})`;
+    const sortedBundleItems = (await support_1.fs.glob(globPattern, {
+        cwd: tmpRoot,
+    })).sort((a, b) => a.split(node_path_1.default.sep).length - b.split(node_path_1.default.sep).length);
+    if (sortedBundleItems.length === 0) {
+        throw this.log.errorWithException(`${this.opts.app} did not have any of '${exports.SUPPORTED_EXTENSIONS.join(', ')}' ` +
+            `extension packages. Please make sure the provided .zip archive contains at ` +
+            `least one valid application package.`);
+    }
+    const unzippedAppPath = node_path_1.default.join(tmpRoot, sortedBundleItems[0]);
+    this.log.debug(`'${unzippedAppPath}' is the unzipped file from '${appPath}'`);
+    return unzippedAppPath;
+}
+/** Post-processes configured apps and reuses a valid cache entry when possible. */
+async function onPostConfigureApp(opts) {
+    const { cachedAppInfo, isUrl, appPath } = opts;
+    if (!appPath) {
+        return undefined;
+    }
+    const presignApp = async (appLocation) => {
+        if (this.opts.noSign) {
+            this.log.info('Skipping application signing because noSign capability is set to true. ' +
+                'Having the application under test with improper signature/non-signed will cause ' +
+                'Espresso automation startup failure.');
+        }
+        else if (!(await this.adb.checkApkCert(appLocation, ''))) {
+            await this.adb.sign(appLocation);
+        }
+    };
+    const hasApkExt = (p) => p.toLowerCase().endsWith(exports.APK_EXT);
+    const hasAabExt = (p) => p.toLowerCase().endsWith(exports.AAB_EXT);
+    const extractUniversalApk = async (shouldExtract, p) => shouldExtract ? p : await this.adb.extractUniversalApk(p);
+    let pathInCache = null;
+    let isResultAppPathAlreadyCached = false;
+    if ((0, app_1.isCachedAppInfo)(cachedAppInfo)) {
+        const packageHash = await support_1.fs.hash(appPath);
+        if (packageHash === cachedAppInfo.packageHash && (await support_1.fs.exists(cachedAppInfo.fullPath))) {
+            this.log.info(`Using '${cachedAppInfo.fullPath}' which is cached from '${appPath}'`);
+            isResultAppPathAlreadyCached = true;
+            pathInCache = cachedAppInfo.fullPath;
+        }
+    }
+    const isApk = hasApkExt(appPath);
+    const shouldResultAppPathBeCached = !isApk || (isApk && isUrl);
+    if (!isResultAppPathAlreadyCached) {
+        if (shouldResultAppPathBeCached) {
+            let unzippedAppPath;
+            let isUnzippedApk = false;
+            if (!(hasApkExt(appPath) || hasAabExt(appPath))) {
+                unzippedAppPath = await this.unzipApp(appPath);
+                isUnzippedApk = hasApkExt(unzippedAppPath);
+            }
+            pathInCache = unzippedAppPath
+                ? await extractUniversalApk(isUnzippedApk, unzippedAppPath)
+                : await extractUniversalApk(isApk, appPath);
+            if (!isApk && isUrl) {
+                await support_1.fs.rimraf(appPath);
+            }
+            if (unzippedAppPath !== undefined && hasAabExt(unzippedAppPath)) {
+                await support_1.fs.rimraf(unzippedAppPath);
+            }
+            if (pathInCache == null) {
+                throw this.log.errorWithException('Expected a cached app path after post-processing');
+            }
+            await presignApp(pathInCache);
+        }
+        else if (isApk) {
+            await presignApp(appPath);
+        }
+    }
+    return shouldResultAppPathBeCached && pathInCache != null ? { appPath: pathInCache } : undefined;
+}
+/** Prepare the application under test on the device. */
+async function initAUT() {
+    if (this.opts.uninstallOtherPackages) {
+        await this.uninstallOtherPackages(appium_android_driver_1.utils.parseArray(this.opts.uninstallOtherPackages), [
+            io_appium_settings_1.SETTINGS_HELPER_ID,
+            server_1.TEST_APK_PKG,
+        ]);
+    }
+    if (!this.opts.app) {
+        if (this.opts.fullReset) {
+            throw this.log.errorWithException('Full reset requires an app capability, use fastReset if app is not provided');
+        }
+        this.log.debug('No app capability. Assuming it is already on the device');
+        if (this.opts.fastReset) {
+            await this.resetAUT();
+        }
+    }
+    const appPackage = this.opts.appPackage;
+    if (!appPackage) {
+        throw this.log.errorWithException('appPackage is required');
+    }
+    if (!this.opts.skipUninstall) {
+        await this.adb.uninstallApk(appPackage);
+    }
+    if (this.opts.app) {
+        await this.installAUT();
+    }
+    if (this.opts.skipServerInstallation) {
+        this.log.debug('skipServerInstallation capability is set. Not installig espresso-server');
+    }
+    else {
+        await this.espresso.installTestApk();
+    }
+    try {
+        await this.adb.addToDeviceIdleWhitelist(io_appium_settings_1.SETTINGS_HELPER_ID, server_1.TEST_APK_PKG);
+    }
+    catch (e) {
+        const stderr = typeof e === 'object' &&
+            e !== null &&
+            'stderr' in e &&
+            typeof e.stderr === 'string'
+            ? e.stderr
+            : undefined;
+        const message = e instanceof Error ? e.message : String(e);
+        this.log.warn(`Cannot add server packages to the Doze whitelist. Original error: ` + (stderr || message));
+    }
+}
+//# sourceMappingURL=app-install.js.map

package/build/lib/commands/app-install.js.map

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

package/build/lib/commands/app.d.ts

@@ -0,0 +1,8 @@
+import type { CachedAppInfo } from '@appium/types';
+/** Cached app entry with integrity path (narrower than {@link CachedAppInfo}). */
+export type StrictCachedAppInfo = CachedAppInfo & {
+    fullPath: string;
+};
+/** Type guard for cached app metadata shape. */
+export declare function isCachedAppInfo(value: unknown): value is StrictCachedAppInfo;
+//# sourceMappingURL=app.d.ts.map

package/build/lib/commands/app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../../../lib/commands/app.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,eAAe,CAAC;AAGjD,kFAAkF;AAClF,MAAM,MAAM,mBAAmB,GAAG,aAAa,GAAG;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAC,CAAC;AAErE,gDAAgD;AAChD,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,mBAAmB,CAM5E"}

package/build/lib/commands/app.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isCachedAppInfo = isCachedAppInfo;
+const utils_1 = require("../utils");
+/** Type guard for cached app metadata shape. */
+function isCachedAppInfo(value) {
+    return ((0, utils_1.isPlainObject)(value) &&
+        typeof value.packageHash === 'string' &&
+        typeof value.fullPath === 'string');
+}
+//# sourceMappingURL=app.js.map

package/build/lib/commands/app.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.js","sourceRoot":"","sources":["../../../lib/commands/app.ts"],"names":[],"mappings":";;AAOA,0CAMC;AAZD,oCAAuC;AAKvC,gDAAgD;AAChD,SAAgB,eAAe,CAAC,KAAc;IAC5C,OAAO,CACL,IAAA,qBAAa,EAAC,KAAK,CAAC;QACpB,OAAO,KAAK,CAAC,WAAW,KAAK,QAAQ;QACrC,OAAO,KAAK,CAAC,QAAQ,KAAK,QAAQ,CACnC,CAAC;AACJ,CAAC"}

package/build/lib/{server-builder.d.ts → commands/server/builder.d.ts}

@@ -56,4 +56,13 @@ export declare class ServerBuilder {
  * @returns Configuration consumed by the Gradle signing step.
  */
 export declare function buildServerSigningConfig(args: BuildServerSigningConfigArgs): ServerSigningConfig;
-//# sourceMappingURL=server-builder.d.ts.map
+/**
+ * Insert Gradle dependency lines after a `// placeholder` marker in a Gradle file.
+ *
+ * @param originalContent - Full text of the Gradle configuration file.
+ * @param dependencyPlaceholder - Placeholder comment label to find (e.g. from build.gradle).
+ * @param dependencyLines - Dependency lines to insert (e.g. `implementation "..."`).
+ * @returns Updated file content, or the original string if the placeholder is missing.
+ */
+export declare function updateDependencyLines(originalContent: string, dependencyPlaceholder: string, dependencyLines: string[]): string;
+//# sourceMappingURL=builder.d.ts.map

package/build/lib/commands/server/builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../../../../lib/commands/server/builder.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,eAAe,CAAC;AAIhD,eAAO,MAAM,mBAAmB,uEACsC,CAAC;AAMvE,eAAO,MAAM,YAAY,8NAcf,CAAC;AAEX,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,OAAO,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,4BAA4B;IAC3C,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,0BAA0B;IACzC,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,yBAAyB,CAAC,EAAE,MAAM,EAAE,CAAC;IACrC,iCAAiC,CAAC,EAAE,MAAM,EAAE,CAAC;CAC9C;AAED,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,kBAAkB,CAAC,EAAE,0BAA0B,CAAC;IAChD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,mBAAmB,GAAG,IAAI,CAAC;CAC5C;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IACnC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAU;IACzC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAyD;IACxF,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,CAA6B;IAC5D,OAAO,CAAC,QAAQ,CAAC,yBAAyB,CAAgB;IAC1D,OAAO,CAAC,QAAQ,CAAC,iCAAiC,CAAgB;IAClE,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAU;gBAE7B,GAAG,EAAE,YAAY,EAAE,IAAI,EAAE,oBAAoB;IA0BnD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAW5B,OAAO,CAAC,UAAU;YA4CJ,uBAAuB;IAYrC,OAAO,CAAC,mBAAmB;YAOb,4BAA4B;YA0C5B,eAAe;CAmC9B;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,4BAA4B,GAAG,mBAAmB,CAQhG;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,eAAe,EAAE,MAAM,EACvB,qBAAqB,EAAE,MAAM,EAC7B,eAAe,EAAE,MAAM,EAAE,GACxB,MAAM,CAgBR"}

package/build/lib/{server-builder.js → commands/server/builder.js}

@@ -5,11 +5,12 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ServerBuilder = exports.VERSION_KEYS = exports.GRADLE_URL_TEMPLATE = void 0;
 exports.buildServerSigningConfig = buildServerSigningConfig;
+exports.updateDependencyLines = updateDependencyLines;
 const teen_process_1 = require("teen_process");
 const support_1 = require("appium/support");
 const node_path_1 = __importDefault(require("node:path"));
 const node_os_1 = require("node:os");
-const utils_1 = require("./utils");
+const utils_1 = require("../../utils");
 const GRADLE_VERSION_KEY = 'gradle';
 const GRADLE_URL_PREFIX = 'distributionUrl=';
 exports.GRADLE_URL_TEMPLATE = 'https\\://services.gradle.org/distributions/gradle-VERSION-all.zip';
@@ -150,7 +151,7 @@ class ServerBuilder {
                 continue;
             }
             this.log.info(`Adding the following ${propName} to build.gradle.kts: ${deps}`);
-            configuration = (0, utils_1.updateDependencyLines)(configuration, propName, deps);
+            configuration = updateDependencyLines(configuration, propName, deps);
         }
         await support_1.fs.writeFile(buildPath, configuration, 'utf8');
     }
@@ -203,4 +204,24 @@ function buildServerSigningConfig(args) {
         keyPassword: args.keyPassword,
     };
 }
-//# sourceMappingURL=server-builder.js.map
+/**
+ * Insert Gradle dependency lines after a `// placeholder` marker in a Gradle file.
+ *
+ * @param originalContent - Full text of the Gradle configuration file.
+ * @param dependencyPlaceholder - Placeholder comment label to find (e.g. from build.gradle).
+ * @param dependencyLines - Dependency lines to insert (e.g. `implementation "..."`).
+ * @returns Updated file content, or the original string if the placeholder is missing.
+ */
+function updateDependencyLines(originalContent, dependencyPlaceholder, dependencyLines) {
+    const configurationLines = originalContent.split('\n');
+    const searchRe = new RegExp(`^\\s*//\\s*\\b${(0, utils_1.escapeRegExp)(dependencyPlaceholder)}\\b`, 'm');
+    const placeholderIndex = configurationLines.findIndex((line) => searchRe.test(line));
+    if (placeholderIndex < 0) {
+        return originalContent;
+    }
+    const placeholderLine = configurationLines[placeholderIndex];
+    const indentLen = placeholderLine.length - placeholderLine.trimStart().length;
+    configurationLines.splice(placeholderIndex + 1, 0, ...dependencyLines.map((line) => `${' '.repeat(indentLen)}${line}`));
+    return configurationLines.join('\n');
+}
+//# sourceMappingURL=builder.js.map

package/build/lib/commands/server/builder.js.map

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

package/build/lib/commands/server/constants.d.ts

@@ -0,0 +1,8 @@
+export declare const TEST_APK_PKG = "io.appium.espressoserver.test";
+export declare const ESPRESSO_SERVER_LAUNCH_TIMEOUT_MS = 45000;
+export declare const TARGET_PACKAGE_CONTAINER = "/data/local/tmp/espresso.apppackage";
+/** System port range used to communicate with the Espresso HTTP server on the device. */
+export declare const SYSTEM_PORT_RANGE: number[];
+/** Port the Espresso server listens on on the device (forwarded from {@link SYSTEM_PORT_RANGE}). */
+export declare const DEVICE_PORT = 6791;
+//# sourceMappingURL=constants.d.ts.map

package/build/lib/commands/server/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../lib/commands/server/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,YAAY,kCAAkC,CAAC;AAE5D,eAAO,MAAM,iCAAiC,QAAQ,CAAC;AAEvD,eAAO,MAAM,wBAAwB,wCAAwC,CAAC;AAE9E,yFAAyF;AACzF,eAAO,MAAM,iBAAiB,UAAe,CAAC;AAE9C,oGAAoG;AACpG,eAAO,MAAM,WAAW,OAAO,CAAC"}

package/build/lib/commands/server/constants.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEVICE_PORT = exports.SYSTEM_PORT_RANGE = exports.TARGET_PACKAGE_CONTAINER = exports.ESPRESSO_SERVER_LAUNCH_TIMEOUT_MS = exports.TEST_APK_PKG = void 0;
+exports.TEST_APK_PKG = 'io.appium.espressoserver.test';
+exports.ESPRESSO_SERVER_LAUNCH_TIMEOUT_MS = 45000;
+exports.TARGET_PACKAGE_CONTAINER = '/data/local/tmp/espresso.apppackage';
+/** System port range used to communicate with the Espresso HTTP server on the device. */
+exports.SYSTEM_PORT_RANGE = [8300, 8399];
+/** Port the Espresso server listens on on the device (forwarded from {@link SYSTEM_PORT_RANGE}). */
+exports.DEVICE_PORT = 6791;
+//# sourceMappingURL=constants.js.map

package/build/lib/commands/server/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../lib/commands/server/constants.ts"],"names":[],"mappings":";;;AAAa,QAAA,YAAY,GAAG,+BAA+B,CAAC;AAE/C,QAAA,iCAAiC,GAAG,KAAK,CAAC;AAE1C,QAAA,wBAAwB,GAAG,qCAAqC,CAAC;AAE9E,yFAAyF;AAC5E,QAAA,iBAAiB,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;AAE9C,oGAAoG;AACvF,QAAA,WAAW,GAAG,IAAI,CAAC"}

package/build/lib/commands/server/index.d.ts

@@ -0,0 +1,5 @@
+export { SYSTEM_PORT_RANGE, TEST_APK_PKG } from './constants';
+export { ServerBuilder, buildServerSigningConfig, type BuildServerSigningConfigArgs, type EspressoBuildConfiguration, type ServerBuilderOptions, type ServerSigningConfig, } from './builder';
+export { EspressoRunner, type EspressoRunnerOptions } from './runner';
+export { initServer, removePortForward, startSession, teardown } from './startup';
+//# sourceMappingURL=index.d.ts.map

package/build/lib/commands/server/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../lib/commands/server/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,iBAAiB,EAAE,YAAY,EAAC,MAAM,aAAa,CAAC;AAC5D,OAAO,EACL,aAAa,EACb,wBAAwB,EACxB,KAAK,4BAA4B,EACjC,KAAK,0BAA0B,EAC/B,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,GACzB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAC,cAAc,EAAE,KAAK,qBAAqB,EAAC,MAAM,UAAU,CAAC;AACpE,OAAO,EAAC,UAAU,EAAE,iBAAiB,EAAE,YAAY,EAAE,QAAQ,EAAC,MAAM,WAAW,CAAC"}

package/build/lib/commands/server/index.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.teardown = exports.startSession = exports.removePortForward = exports.initServer = exports.EspressoRunner = exports.buildServerSigningConfig = exports.ServerBuilder = exports.TEST_APK_PKG = exports.SYSTEM_PORT_RANGE = void 0;
+var constants_1 = require("./constants");
+Object.defineProperty(exports, "SYSTEM_PORT_RANGE", { enumerable: true, get: function () { return constants_1.SYSTEM_PORT_RANGE; } });
+Object.defineProperty(exports, "TEST_APK_PKG", { enumerable: true, get: function () { return constants_1.TEST_APK_PKG; } });
+var builder_1 = require("./builder");
+Object.defineProperty(exports, "ServerBuilder", { enumerable: true, get: function () { return builder_1.ServerBuilder; } });
+Object.defineProperty(exports, "buildServerSigningConfig", { enumerable: true, get: function () { return builder_1.buildServerSigningConfig; } });
+var runner_1 = require("./runner");
+Object.defineProperty(exports, "EspressoRunner", { enumerable: true, get: function () { return runner_1.EspressoRunner; } });
+var startup_1 = require("./startup");
+Object.defineProperty(exports, "initServer", { enumerable: true, get: function () { return startup_1.initServer; } });
+Object.defineProperty(exports, "removePortForward", { enumerable: true, get: function () { return startup_1.removePortForward; } });
+Object.defineProperty(exports, "startSession", { enumerable: true, get: function () { return startup_1.startSession; } });
+Object.defineProperty(exports, "teardown", { enumerable: true, get: function () { return startup_1.teardown; } });
+//# sourceMappingURL=index.js.map

package/build/lib/commands/server/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../lib/commands/server/index.ts"],"names":[],"mappings":";;;AAAA,yCAA4D;AAApD,8GAAA,iBAAiB,OAAA;AAAE,yGAAA,YAAY,OAAA;AACvC,qCAOmB;AANjB,wGAAA,aAAa,OAAA;AACb,mHAAA,wBAAwB,OAAA;AAM1B,mCAAoE;AAA5D,wGAAA,cAAc,OAAA;AACtB,qCAAgF;AAAxE,qGAAA,UAAU,OAAA;AAAE,4GAAA,iBAAiB,OAAA;AAAE,uGAAA,YAAY,OAAA;AAAE,mGAAA,QAAQ,OAAA"}

package/build/lib/{espresso-runner.d.ts → commands/server/runner.d.ts}

@@ -1,9 +1,8 @@
 import { JWProxy } from 'appium/driver';
-import { type ServerSigningConfig } from './server-builder';
+import { type ServerSigningConfig } from './builder';
 import type { AppiumLogger, StringRecord, HTTPMethod, HTTPBody, ProxyResponse } from '@appium/types';
 import type { ADB } from 'appium-adb';
 import type { SubProcess } from 'teen_process';
-export declare const TEST_APK_PKG = "io.appium.espressoserver.test";
 export interface EspressoRunnerOptions {
     adb: ADB;
     tmpDir: string;
@@ -67,5 +66,11 @@ export declare class EspressoRunner {
     private recordTargetAppPackage;
     private _verifyServerStatus;
 }
+/**
+ * Recursively copy all files except build directories contents
+ * @param sourceBaseDir directory to copy files from
+ * @param targetBaseDir directory to copy files to
+ */
+export declare function copyGradleProjectRecursively(sourceBaseDir: string, targetBaseDir: string): Promise<void>;
 export {};
-//# sourceMappingURL=espresso-runner.d.ts.map
+//# sourceMappingURL=runner.d.ts.map

package/build/lib/commands/server/runner.d.ts.map

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

package/build/lib/{espresso-runner.js → commands/server/runner.js}

@@ -36,19 +36,17 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.EspressoRunner = exports.TEST_APK_PKG = void 0;
+exports.EspressoRunner = void 0;
+exports.copyGradleProjectRecursively = copyGradleProjectRecursively;
 const driver_1 = require("appium/driver");
 const asyncbox_1 = require("asyncbox");
-const server_builder_1 = require("./server-builder");
 const node_path_1 = __importDefault(require("node:path"));
 const support_1 = require("appium/support");
-const utils_1 = require("./utils");
+const utils_1 = require("../../utils");
+const builder_1 = require("./builder");
+const constants_1 = require("./constants");
 const axios_1 = __importDefault(require("axios"));
 const semver = __importStar(require("semver"));
-const TEST_SERVER_ROOT = node_path_1.default.resolve(__dirname, '..', '..', 'espresso-server');
-exports.TEST_APK_PKG = 'io.appium.espressoserver.test';
-const ESPRESSO_SERVER_LAUNCH_TIMEOUT_MS = 45000;
-const TARGET_PACKAGE_CONTAINER = '/data/local/tmp/espresso.apppackage';
 class EspressoProxy extends driver_1.JWProxy {
     instrumentationState;
     async proxyCommand(url, method, body = null) {
@@ -107,11 +105,11 @@ class EspressoRunner {
             crashed: false,
         };
         const { manifestPayload } = (0, utils_1.getPackageInfoSync)();
-        const modServerName = support_1.fs.sanitizeName(`${exports.TEST_APK_PKG}_${manifestPayload.version}_${this.appPackage}_${this.adb.curDeviceId}.apk`, { replacement: '-' });
+        const modServerName = support_1.fs.sanitizeName(`${constants_1.TEST_APK_PKG}_${manifestPayload.version}_${this.appPackage}_${this.adb.curDeviceId}.apk`, { replacement: '-' });
         this.modServerPath = node_path_1.default.resolve(this.tmpDir, modServerName);
         this.showGradleLog = opts.showGradleLog;
         this.espressoBuildConfig = opts.espressoBuildConfig;
-        this.serverLaunchTimeout = opts.serverLaunchTimeout || ESPRESSO_SERVER_LAUNCH_TIMEOUT_MS;
+        this.serverLaunchTimeout = opts.serverLaunchTimeout || constants_1.ESPRESSO_SERVER_LAUNCH_TIMEOUT_MS;
         this.androidInstallTimeout = opts.androidInstallTimeout;
         this.disableSuppressAccessibilityService = opts.disableSuppressAccessibilityService;
         // Espresso Server app needs to be signed with same keyStore as appPackage
@@ -120,7 +118,7 @@ class EspressoRunner {
             opts.keystorePassword &&
             opts.keyAlias &&
             opts.keyPassword) {
-            this.signingConfig = (0, server_builder_1.buildServerSigningConfig)({
+            this.signingConfig = (0, builder_1.buildServerSigningConfig)({
                 keystoreFile: opts.keystorePath,
                 keystorePassword: opts.keystorePassword,
                 keyAlias: opts.keyAlias,
@@ -132,11 +130,11 @@ class EspressoRunner {
         }
     }
     async isAppPackageChanged() {
-        if (!(await this.adb.fileExists(TARGET_PACKAGE_CONTAINER))) {
+        if (!(await this.adb.fileExists(constants_1.TARGET_PACKAGE_CONTAINER))) {
             this.log.debug('The previous target application package is unknown');
             return true;
         }
-        const previousAppPackage = (await this.adb.shell(['cat', TARGET_PACKAGE_CONTAINER])).trim();
+        const previousAppPackage = (await this.adb.shell(['cat', constants_1.TARGET_PACKAGE_CONTAINER])).trim();
         this.log.debug(`The previous target application package was '${previousAppPackage}'. ` +
             `The current package is '${this.appPackage}'`);
         return previousAppPackage !== this.appPackage;
@@ -146,19 +144,19 @@ class EspressoRunner {
      * Each adb command uses default timeout by them.
      */
     async installServer() {
-        const appState = await this.adb.getApplicationInstallState(this.modServerPath, exports.TEST_APK_PKG);
+        const appState = await this.adb.getApplicationInstallState(this.modServerPath, constants_1.TEST_APK_PKG);
         const shouldUninstallApp = [
             this.adb.APP_INSTALL_STATE.OLDER_VERSION_INSTALLED,
             this.adb.APP_INSTALL_STATE.NEWER_VERSION_INSTALLED,
         ].includes(appState);
         const shouldInstallApp = shouldUninstallApp || [this.adb.APP_INSTALL_STATE.NOT_INSTALLED].includes(appState);
         if (shouldUninstallApp) {
-            this.log.info(`Uninstalling Espresso Test Server apk from the target device (pkg: '${exports.TEST_APK_PKG}')`);
+            this.log.info(`Uninstalling Espresso Test Server apk from the target device (pkg: '${constants_1.TEST_APK_PKG}')`);
             try {
-                await this.adb.uninstallApk(exports.TEST_APK_PKG);
+                await this.adb.uninstallApk(constants_1.TEST_APK_PKG);
             }
             catch (err) {
-                this.log.warn(`Error uninstalling '${exports.TEST_APK_PKG}': ${err.message}`);
+                this.log.warn(`Error uninstalling '${constants_1.TEST_APK_PKG}': ${err.message}`);
             }
         }
         if (shouldInstallApp) {
@@ -168,7 +166,7 @@ class EspressoRunner {
                     replace: false,
                     timeout: this.androidInstallTimeout,
                 });
-                this.log.info(`Installed Espresso Test Server apk '${this.modServerPath}' (pkg: '${exports.TEST_APK_PKG}')`);
+                this.log.info(`Installed Espresso Test Server apk '${this.modServerPath}' (pkg: '${constants_1.TEST_APK_PKG}')`);
             }
             catch (err) {
                 throw this.log.errorWithException(`Cannot install '${this.modServerPath}' because of '${err.message}'`);
@@ -191,11 +189,11 @@ class EspressoRunner {
         if (!(await support_1.fs.exists(this.modServerPath))) {
             await this.buildNewModServer();
         }
-        const isSigned = await this.adb.checkApkCert(this.modServerPath, exports.TEST_APK_PKG);
-        if (!isSigned) {
+        const wasSigned = await this.adb.checkApkCert(this.modServerPath, '');
+        if (!wasSigned) {
             await this.adb.sign(this.modServerPath);
         }
-        if ((rebuild || !isSigned) && (await this.adb.uninstallApk(exports.TEST_APK_PKG))) {
+        if ((rebuild || !wasSigned) && (await this.adb.uninstallApk(constants_1.TEST_APK_PKG))) {
             this.log.info('Uninstalled the obsolete Espresso server package from the device under test');
         }
         await this.installServer();
@@ -228,10 +226,10 @@ class EspressoRunner {
         this.log.debug(`The build folder root could be customized by changing the 'tmpDir' capability`);
         await support_1.fs.rimraf(serverPath);
         await support_1.fs.mkdirp(serverPath);
-        this.log.debug(`Copying espresso server template from ('${TEST_SERVER_ROOT}' to '${serverPath}')`);
-        await (0, utils_1.copyGradleProjectRecursively)(TEST_SERVER_ROOT, serverPath);
+        this.log.debug(`Copying espresso server template from ('${getTestServerRoot()}' to '${serverPath}')`);
+        await copyGradleProjectRecursively(getTestServerRoot(), serverPath);
         this.log.debug('Bulding espresso server');
-        await new server_builder_1.ServerBuilder(this.log, {
+        await new builder_1.ServerBuilder(this.log, {
             serverPath,
             buildConfiguration,
             showGradleLog: this.showGradleLog,
@@ -259,7 +257,7 @@ class EspressoRunner {
         if (typeof this.disableSuppressAccessibilityService === 'boolean') {
             cmd.push('-e', 'DISABLE_SUPPRESS_ACCESSIBILITY_SERVICES', String(this.disableSuppressAccessibilityService));
         }
-        cmd.push(`${exports.TEST_APK_PKG}/androidx.test.runner.AndroidJUnitRunner`);
+        cmd.push(`${constants_1.TEST_APK_PKG}/androidx.test.runner.AndroidJUnitRunner`);
         const { manifestPayload } = await (0, utils_1.getPackageInfo)();
         this.log.info(`Starting Espresso Server v${manifestPayload.version} with cmd: adb ${cmd.join(' ')}`);
         let hasSocketError = false;
@@ -376,8 +374,8 @@ class EspressoRunner {
         }
     }
     async recordTargetAppPackage() {
-        await this.adb.shell([`echo "${this.appPackage}" > "${TARGET_PACKAGE_CONTAINER}"`]);
-        this.log.info(`Recorded the target application package '${this.appPackage}' to ${TARGET_PACKAGE_CONTAINER}`);
+        await this.adb.shell([`echo "${this.appPackage}" > "${constants_1.TARGET_PACKAGE_CONTAINER}"`]);
+        this.log.info(`Recorded the target application package '${this.appPackage}' to ${constants_1.TARGET_PACKAGE_CONTAINER}`);
     }
     async _verifyServerStatus(driverVersion, serverStatus) {
         if (!(0, utils_1.isPlainObject)(serverStatus) || !(0, utils_1.isPlainObject)(serverStatus.build)) {
@@ -424,4 +422,40 @@ function requireOption(opts, key) {
     }
     return opts[key];
 }
-//# sourceMappingURL=espresso-runner.js.map
+const MODULE_NAME = 'appium-espresso-driver';
+let testServerRoot;
+/**
+ * Recursively copy all files except build directories contents
+ * @param sourceBaseDir directory to copy files from
+ * @param targetBaseDir directory to copy files to
+ */
+async function copyGradleProjectRecursively(sourceBaseDir, targetBaseDir) {
+    // @ts-ignore it is ok to have the async callback
+    await support_1.fs.walkDir(sourceBaseDir, true, async (itemPath, isDirectory) => {
+        const relativePath = node_path_1.default.relative(sourceBaseDir, itemPath);
+        const targetPath = node_path_1.default.resolve(targetBaseDir, relativePath);
+        const isInGradleBuildDir = `${node_path_1.default.sep}${itemPath}`.includes(`${node_path_1.default.sep}build${node_path_1.default.sep}`);
+        if (isInGradleBuildDir) {
+            return false;
+        }
+        if (isDirectory) {
+            await support_1.fs.mkdirp(targetPath);
+        }
+        else {
+            await support_1.fs.copyFile(itemPath, targetPath);
+        }
+        return false;
+    });
+}
+/** Root path of the bundled Espresso server Gradle project. */
+function getTestServerRoot() {
+    if (testServerRoot === undefined) {
+        const moduleRoot = support_1.node.getModuleRootSync(MODULE_NAME, __filename);
+        if (!moduleRoot) {
+            throw new Error(`Cannot find the root folder of the ${MODULE_NAME} Node.js module`);
+        }
+        testServerRoot = node_path_1.default.join(moduleRoot, 'espresso-server');
+    }
+    return testServerRoot;
+}
+//# sourceMappingURL=runner.js.map