appium-adb 14.1.2 → 14.1.3

package/build/lib/tools/apks-utils.js

@@ -21,10 +21,9 @@ const async_lock_1 = __importDefault(require("async-lock"));
 const bluebird_1 = __importDefault(require("bluebird"));
 const BASE_APK = 'base-master.apk';
 const LANGUAGE_APK = (lang) => `base-${lang}.apk`;
-/** @type {LRUCache<string, string>} */
 const APKS_CACHE = new lru_cache_1.LRUCache({
     max: 10,
-    dispose: (extractedFilesRoot) => support_1.fs.rimraf(/** @type {string} */ (extractedFilesRoot)),
+    dispose: (extractedFilesRoot) => support_1.fs.rimraf(extractedFilesRoot),
 });
 const APKS_CACHE_GUARD = new async_lock_1.default();
 const BUNDLETOOL_TIMEOUT_MS = 4 * 60 * 1000;
@@ -33,7 +32,7 @@ process.on('exit', () => {
     if (!APKS_CACHE.size) {
         return;
     }
-    const paths = /** @type {string[]} */ ([...APKS_CACHE.values()]);
+    const paths = [...APKS_CACHE.values()];
     logger_js_1.log.debug(`Performing cleanup of ${paths.length} cached .apks ` + support_1.util.pluralize('package', paths.length));
     for (const appPath of paths) {
         try {
@@ -51,17 +50,15 @@ process.on('exit', () => {
  * The resulting temporary path, where the .apks file has been extracted,
  * will be stored into the internal LRU cache for better performance.
  *
- * @param {string} apks - The full path to the .apks file
- * @param {string|string[]} dstPath - The relative path to the destination file,
+ * @param apks - The full path to the .apks file
+ * @param dstPath - The relative path to the destination file,
  * which is going to be extracted, where each path component is an array item
- * @returns {Promise<string>} Full path to the extracted file
+ * @returns Full path to the extracted file
  * @throws {Error} If the requested item does not exist in the extracted archive or the provides
  * apks file is not a valid bundle
  */
 async function extractFromApks(apks, dstPath) {
-    if (!lodash_1.default.isArray(dstPath)) {
-        dstPath = [dstPath];
-    }
+    const normalizedDstPath = lodash_1.default.isArray(dstPath) ? dstPath : [dstPath];
     return await APKS_CACHE_GUARD.acquire(apks, async () => {
         // It might be that the original file has been replaced,
         // so we need to keep the hash sums instead of the actual file paths
@@ -69,18 +66,21 @@ async function extractFromApks(apks, dstPath) {
         const apksHash = await support_1.fs.hash(apks);
         logger_js_1.log.debug(`Calculated '${apks}' hash: ${apksHash}`);
         if (APKS_CACHE.has(apksHash)) {
-            const resultPath = path_1.default.resolve(/** @type {string} */ (APKS_CACHE.get(apksHash)), ...dstPath);
-            if (await support_1.fs.exists(resultPath)) {
-                return resultPath;
+            const cachedRoot = APKS_CACHE.get(apksHash);
+            if (cachedRoot) {
+                const resultPath = path_1.default.resolve(cachedRoot, ...normalizedDstPath);
+                if (await support_1.fs.exists(resultPath)) {
+                    return resultPath;
+                }
             }
             APKS_CACHE.delete(apksHash);
         }
         const tmpRoot = await support_1.tempDir.openDir();
         logger_js_1.log.debug(`Unpacking application bundle at '${apks}' to '${tmpRoot}'`);
         await (0, helpers_js_1.unzipFile)(apks, tmpRoot);
-        const resultPath = path_1.default.resolve(tmpRoot, ...(lodash_1.default.isArray(dstPath) ? dstPath : [dstPath]));
+        const resultPath = path_1.default.resolve(tmpRoot, ...normalizedDstPath);
         if (!(await support_1.fs.exists(resultPath))) {
-            throw new Error(`${lodash_1.default.isArray(dstPath) ? dstPath.join(path_1.default.sep) : dstPath} cannot be found in '${apks}' bundle. ` +
+            throw new Error(`${normalizedDstPath.join(path_1.default.sep)} cannot be found in '${apks}' bundle. ` +
                 `Does the archive contain a valid application bundle?`);
         }
         APKS_CACHE.set(apksHash, tmpRoot);
@@ -90,20 +90,16 @@ async function extractFromApks(apks, dstPath) {
 /**
  * Executes bundletool utility with given arguments and returns the actual stdout
  *
- * @this {import('../adb.js').ADB}
- * @param {Array<String>} args - the list of bundletool arguments
- * @param {string} errorMsg - The customized error message string
- * @returns {Promise<string>} the actual command stdout
+ * @param args - the list of bundletool arguments
+ * @param errorMsg - The customized error message string
+ * @returns the actual command stdout
  * @throws {Error} If bundletool jar does not exist in PATH or there was an error while
  * executing it
  */
 async function execBundletool(args, errorMsg) {
     await this.initBundletool();
-    args = [
-        '-jar',
-        /** @type {import('./types').StringRecord} */ (this.binaries).bundletool,
-        ...args,
-    ];
+    const binaries = this.binaries;
+    args = ['-jar', binaries.bundletool, ...args];
     const env = process.env;
     if (this.adbPort) {
         env.ANDROID_ADB_SERVER_PORT = `${this.adbPort}`;
@@ -122,30 +118,29 @@ async function execBundletool(args, errorMsg) {
         return stdout;
     }
     catch (e) {
-        if (e.stdout) {
-            logger_js_1.log.debug(`Command stdout: ${e.stdout}`);
+        const err = e;
+        if (err.stdout) {
+            logger_js_1.log.debug(`Command stdout: ${err.stdout}`);
         }
-        if (e.stderr) {
-            logger_js_1.log.debug(`Command stderr: ${e.stderr}`);
+        if (err.stderr) {
+            logger_js_1.log.debug(`Command stderr: ${err.stderr}`);
         }
-        throw new Error(`${errorMsg}. Original error: ${e.message}`);
+        throw new Error(`${errorMsg}. Original error: ${err.message}`);
     }
 }
 /**
  *
- * @this {import('../adb.js').ADB}
- * @param {string} specLocation - The full path to the generated device spec location
- * @returns {Promise<string>} The same `specLocation` value
+ * @param specLocation - The full path to the generated device spec location
+ * @returns The same `specLocation` value
  * @throws {Error} If it is not possible to retrieve the spec for the current device
  */
 async function getDeviceSpec(specLocation) {
-    /** @type {string[]} */
     const args = [
         'get-device-spec',
         '--adb',
         this.executable.path,
         '--device-id',
-        /** @type {string} */ (this.curDeviceId),
+        this.curDeviceId,
         '--output',
         specLocation,
     ];
@@ -156,29 +151,26 @@ async function getDeviceSpec(specLocation) {
 /**
  * Installs the given apks into the device under test
  *
- * @this {import('../adb.js').ADB}
- * @param {Array<string>} apkPathsToInstall - The full paths to install apks
- * @param {import('./types').InstallMultipleApksOptions} [options={}] - Installation options
+ * @param apkPathsToInstall - The full paths to install apks
+ * @param options - Installation options
  */
 async function installMultipleApks(apkPathsToInstall, options = {}) {
     const installArgs = (0, helpers_js_1.buildInstallArgs)(await this.getApiLevel(), options);
     return await this.adbExec(['install-multiple', ...installArgs, ...apkPathsToInstall], {
         // @ts-ignore This validation works
-        timeout: isNaN(options.timeout) ? undefined : options.timeout,
+        timeout: isNaN(Number(options.timeout)) ? undefined : options.timeout,
         timeoutCapName: options.timeoutCapName,
     });
 }
 /**
  * Installs the given .apks package into the device under test
  *
- * @this {import('../adb.js').ADB}
- * @param {string} apks - The full path to the .apks file
- * @param {import('./types').InstallApksOptions} [options={}] - Installation options
+ * @param apks - The full path to the .apks file
+ * @param options - Installation options
  * @throws {Error} If the .apks bundle cannot be installed
  */
 async function installApks(apks, options = {}) {
     const { grantPermissions, allowTestPackages, timeout } = options;
-    /** @type {string[]} */
     const args = [
         'install-apks',
         '--adb',
@@ -188,12 +180,11 @@ async function installApks(apks, options = {}) {
         '--timeout-millis',
         `${timeout || APKS_INSTALL_TIMEOUT}`,
         '--device-id',
-        /** @type {string} */ (this.curDeviceId),
+        this.curDeviceId,
     ];
     if (allowTestPackages) {
         args.push('--allow-test-only');
     }
-    /** @type {Promise[]} */
     const tasks = [
         this.execBundletool(args, `Cannot install '${path_1.default.basename(apks)}' to the device ${this.curDeviceId}`),
     ];
@@ -209,9 +200,8 @@ async function installApks(apks, options = {}) {
 /**
  * Extracts and returns the full path to the master .apk file inside the bundle.
  *
- * @this {import('../adb.js').ADB}
- * @param {string} apks - The full path to the .apks file
- * @returns {Promise<string>} The full path to the master bundle .apk
+ * @param apks - The full path to the .apks file
+ * @returns The full path to the master bundle .apk
  * @throws {Error} If there was an error while extracting/finding the file
  */
 async function extractBaseApk(apks) {
@@ -221,11 +211,10 @@ async function extractBaseApk(apks) {
  * Extracts and returns the full path to the .apk, which contains the corresponding
  * resources for the given language in the .apks bundle.
  *
- * @this {import('../adb.js').ADB}
- * @param {string} apks - The full path to the .apks file
- * @param {?string} [language=null] - The language abbreviation. The default language is
+ * @param apks - The full path to the .apks file
+ * @param language - The language abbreviation. The default language is
  * going to be selected if it is not set.
- * @returns {Promise<string>} The full path to the corresponding language .apk or the master .apk
+ * @returns The full path to the corresponding language .apk or the master .apk
  * if language split is not enabled for the bundle.
  * @throws {Error} If there was an error while extracting/finding the file
  */
@@ -254,8 +243,8 @@ async function extractLanguageApk(apks, language = null) {
 }
 /**
  *
- * @param {string} output
- * @returns {boolean}
+ * @param output
+ * @returns
  */
 function isTestPackageOnlyError(output) {
     return /\[INSTALL_FAILED_TEST_ONLY\]/.test(output);

package/build/lib/tools/apks-utils.js.map

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

package/build/lib/tools/fs-commands.d.ts

@@ -1,69 +1,64 @@
+import type { ADB } from '../adb.js';
+import type { TeenProcessExecOptions } from 'teen_process';
 /**
  * Verify whether a remote path exists on the device under test.
  *
- * @this {import('../adb.js').ADB}
- * @param {string} remotePath - The remote path to verify.
- * @return {Promise<boolean>} True if the given path exists on the device.
+ * @param remotePath - The remote path to verify.
+ * @return True if the given path exists on the device.
  */
-export function fileExists(this: import("../adb.js").ADB, remotePath: string): Promise<boolean>;
+export declare function fileExists(this: ADB, remotePath: string): Promise<boolean>;
 /**
  * Get the output of _ls_ command on the device under test.
  *
- * @this {import('../adb.js').ADB}
- * @param {string} remotePath - The remote path (the first argument to the _ls_ command).
- * @param {string[]} [opts] - Additional _ls_ options.
- * @return {Promise<string[]>} The _ls_ output as an array of split lines.
+ * @param remotePath - The remote path (the first argument to the _ls_ command).
+ * @param opts - Additional _ls_ options.
+ * @return The _ls_ output as an array of split lines.
  *                          An empty array is returned of the given _remotePath_
  *                          does not exist.
  */
-export function ls(this: import("../adb.js").ADB, remotePath: string, opts?: string[]): Promise<string[]>;
+export declare function ls(this: ADB, remotePath: string, opts?: string[]): Promise<string[]>;
 /**
  * Get the size of the particular file located on the device under test.
  *
- * @this {import('../adb.js').ADB}
- * @param {string} remotePath - The remote path to the file.
- * @return {Promise<number>} File size in bytes.
+ * @param remotePath - The remote path to the file.
+ * @return File size in bytes.
  * @throws {Error} If there was an error while getting the size of the given file.
  */
-export function fileSize(this: import("../adb.js").ADB, remotePath: string): Promise<number>;
+export declare function fileSize(this: ADB, remotePath: string): Promise<number>;
 /**
  * Forcefully recursively remove a path on the device under test.
  * Be careful while calling this method.
  *
- * @this {import('../adb.js').ADB}
- * @param {string} path - The path to be removed recursively.
+ * @param path - The path to be removed recursively.
  */
-export function rimraf(this: import("../adb.js").ADB, path: string): Promise<void>;
+export declare function rimraf(this: ADB, path: string): Promise<void>;
 /**
  * Send a file to the device under test.
  *
- * @this {import('../adb.js').ADB}
- * @param {string} localPath - The path to the file on the local file system.
- * @param {string} remotePath - The destination path on the remote device.
- * @param {object} [opts] - Additional options mapping. See
+ * @param localPath - The path to the file on the local file system.
+ * @param remotePath - The destination path on the remote device.
+ * @param opts - Additional options mapping. See
  *                        https://github.com/appium/node-teen_process,
  *                        _exec_ method options, for more information about available
  *                        options.
  */
-export function push(this: import("../adb.js").ADB, localPath: string, remotePath: string, opts?: object): Promise<void>;
+export declare function push(this: ADB, localPath: string, remotePath: string, opts?: TeenProcessExecOptions): Promise<void>;
 /**
  * Receive a file from the device under test.
  *
- * @this {import('../adb.js').ADB}
- * @param {string} remotePath - The source path on the remote device.
- * @param {string} localPath - The destination path to the file on the local file system.
- * @param {import('teen_process').TeenProcessExecOptions} [opts={}] - Additional options mapping. See
+ * @param remotePath - The source path on the remote device.
+ * @param localPath - The destination path to the file on the local file system.
+ * @param opts - Additional options mapping. See
  * https://github.com/appium/node-teen_process,
  * _exec_ method options, for more information about available
  * options.
  */
-export function pull(this: import("../adb.js").ADB, remotePath: string, localPath: string, opts?: import("teen_process").TeenProcessExecOptions): Promise<void>;
+export declare function pull(this: ADB, remotePath: string, localPath: string, opts?: TeenProcessExecOptions): Promise<void>;
 /**
  * Recursively create a new folder on the device under test.
  *
- * @this {import('../adb.js').ADB}
- * @param {string} remotePath - The new path to be created.
- * @return {Promise<string>} mkdir command output.
+ * @param remotePath - The new path to be created.
+ * @return mkdir command output.
  */
-export function mkdir(this: import("../adb.js").ADB, remotePath: string): Promise<string>;
+export declare function mkdir(this: ADB, remotePath: string): Promise<string>;
 //# sourceMappingURL=fs-commands.d.ts.map

package/build/lib/tools/fs-commands.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fs-commands.d.ts","sourceRoot":"","sources":["../../../lib/tools/fs-commands.js"],"names":[],"mappings":"AAGA;;;;;;GAMG;AACH,sEAHW,MAAM,GACL,OAAO,CAAC,OAAO,CAAC,CAU3B;AAED;;;;;;;;;GASG;AACH,8DANW,MAAM,SACN,MAAM,EAAE,GACP,OAAO,CAAC,MAAM,EAAE,CAAC,CAmB5B;AAED;;;;;;;GAOG;AACH,oEAJW,MAAM,GACL,OAAO,CAAC,MAAM,CAAC,CAkB1B;AAED;;;;;;GAMG;AACH,4DAFW,MAAM,iBAIhB;AAED;;;;;;;;;;GAUG;AACH,+DAPW,MAAM,cACN,MAAM,SACN,MAAM,iBAQhB;AAED;;;;;;;;;;GAUG;AACH,gEAPW,MAAM,aACN,MAAM,SACN,OAAO,cAAc,EAAE,sBAAsB,iBAQvD;AAED;;;;;;GAMG;AACH,iEAHW,MAAM,GACL,OAAO,CAAC,MAAM,CAAC,CAM1B"}
+{"version":3,"file":"fs-commands.d.ts","sourceRoot":"","sources":["../../../lib/tools/fs-commands.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAC,GAAG,EAAC,MAAM,WAAW,CAAC;AACnC,OAAO,KAAK,EAAC,sBAAsB,EAAC,MAAM,cAAc,CAAC;AAEzD;;;;;GAKG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAQhF;AAED;;;;;;;;GAQG;AACH,wBAAsB,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,GAAE,MAAM,EAAO,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAe9F;AAED;;;;;;GAMG;AACH,wBAAsB,QAAQ,CAAC,IAAI,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAe7E;AAED;;;;;GAKG;AACH,wBAAsB,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEnE;AAED;;;;;;;;;GASG;AACH,wBAAsB,IAAI,CACxB,IAAI,EAAE,GAAG,EACT,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,IAAI,CAAC,EAAE,sBAAsB,GAC5B,OAAO,CAAC,IAAI,CAAC,CAGf;AAED;;;;;;;;;GASG;AACH,wBAAsB,IAAI,CACxB,IAAI,EAAE,GAAG,EACT,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,IAAI,GAAE,sBAA2B,GAChC,OAAO,CAAC,IAAI,CAAC,CAGf;AAED;;;;;GAKG;AACH,wBAAsB,KAAK,CAAC,IAAI,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAI1E"}

package/build/lib/tools/fs-commands.js

@@ -15,9 +15,8 @@ const path_1 = __importDefault(require("path"));
 /**
  * Verify whether a remote path exists on the device under test.
  *
- * @this {import('../adb.js').ADB}
- * @param {string} remotePath - The remote path to verify.
- * @return {Promise<boolean>} True if the given path exists on the device.
+ * @param remotePath - The remote path to verify.
+ * @return True if the given path exists on the device.
  */
 async function fileExists(remotePath) {
     const passFlag = '__PASS__';
@@ -32,18 +31,17 @@ async function fileExists(remotePath) {
 /**
  * Get the output of _ls_ command on the device under test.
  *
- * @this {import('../adb.js').ADB}
- * @param {string} remotePath - The remote path (the first argument to the _ls_ command).
- * @param {string[]} [opts] - Additional _ls_ options.
- * @return {Promise<string[]>} The _ls_ output as an array of split lines.
+ * @param remotePath - The remote path (the first argument to the _ls_ command).
+ * @param opts - Additional _ls_ options.
+ * @return The _ls_ output as an array of split lines.
  *                          An empty array is returned of the given _remotePath_
  *                          does not exist.
  */
 async function ls(remotePath, opts = []) {
     try {
-        let args = ['ls', ...opts, remotePath];
-        let stdout = await this.shell(args);
-        let lines = stdout.split('\n');
+        const args = ['ls', ...opts, remotePath];
+        const stdout = await this.shell(args);
+        const lines = stdout.split('\n');
         return lines
             .map((l) => l.trim())
             .filter(Boolean)
@@ -59,9 +57,8 @@ async function ls(remotePath, opts = []) {
 /**
  * Get the size of the particular file located on the device under test.
  *
- * @this {import('../adb.js').ADB}
- * @param {string} remotePath - The remote path to the file.
- * @return {Promise<number>} File size in bytes.
+ * @param remotePath - The remote path to the file.
+ * @return File size in bytes.
  * @throws {Error} If there was an error while getting the size of the given file.
  */
 async function fileSize(remotePath) {
@@ -85,8 +82,7 @@ async function fileSize(remotePath) {
  * Forcefully recursively remove a path on the device under test.
  * Be careful while calling this method.
  *
- * @this {import('../adb.js').ADB}
- * @param {string} path - The path to be removed recursively.
+ * @param path - The path to be removed recursively.
  */
 async function rimraf(path) {
     await this.shell(['rm', '-rf', path]);
@@ -94,10 +90,9 @@ async function rimraf(path) {
 /**
  * Send a file to the device under test.
  *
- * @this {import('../adb.js').ADB}
- * @param {string} localPath - The path to the file on the local file system.
- * @param {string} remotePath - The destination path on the remote device.
- * @param {object} [opts] - Additional options mapping. See
+ * @param localPath - The path to the file on the local file system.
+ * @param remotePath - The destination path on the remote device.
+ * @param opts - Additional options mapping. See
  *                        https://github.com/appium/node-teen_process,
  *                        _exec_ method options, for more information about available
  *                        options.
@@ -109,10 +104,9 @@ async function push(localPath, remotePath, opts) {
 /**
  * Receive a file from the device under test.
  *
- * @this {import('../adb.js').ADB}
- * @param {string} remotePath - The source path on the remote device.
- * @param {string} localPath - The destination path to the file on the local file system.
- * @param {import('teen_process').TeenProcessExecOptions} [opts={}] - Additional options mapping. See
+ * @param remotePath - The source path on the remote device.
+ * @param localPath - The destination path to the file on the local file system.
+ * @param opts - Additional options mapping. See
  * https://github.com/appium/node-teen_process,
  * _exec_ method options, for more information about available
  * options.
@@ -124,9 +118,8 @@ async function pull(remotePath, localPath, opts = {}) {
 /**
  * Recursively create a new folder on the device under test.
  *
- * @this {import('../adb.js').ADB}
- * @param {string} remotePath - The new path to be created.
- * @return {Promise<string>} mkdir command output.
+ * @param remotePath - The new path to be created.
+ * @return mkdir command output.
  */
 async function mkdir(remotePath) {
     return /\s+/.test(remotePath)

package/build/lib/tools/fs-commands.js.map

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