appium-android-driver 12.4.9 → 12.4.11

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

@@ -1,33 +1,61 @@
+import type { AndroidDriver } from '../driver';
+declare const PM_ACTION: Readonly<{
+    readonly GRANT: "grant";
+    readonly REVOKE: "revoke";
+}>;
+declare const APPOPS_ACTION: Readonly<{
+    readonly ALLOW: "allow";
+    readonly DENY: "deny";
+    readonly IGNORE: "ignore";
+    readonly DEFAULT: "default";
+}>;
+declare const PERMISSION_TARGET: Readonly<{
+    readonly PM: "pm";
+    readonly APPOPS: "appops";
+}>;
+declare const PERMISSIONS_TYPE: Readonly<{
+    readonly DENIED: "denied";
+    readonly GRANTED: "granted";
+    readonly REQUESTED: "requested";
+}>;
 /**
- * @this {import('../driver').AndroidDriver}
- * @param {string | string[]} permissions If `target` is set to 'pm':
+ * Changes permissions for an Android application.
+ *
+ * @param permissions If `target` is set to 'pm':
  *  The full name of the permission to be changed
  * or a list of permissions. Check https://developer.android.com/reference/android/Manifest.permission
- * to get the full list of standard Android permssion names. Mandatory argument.
+ * to get the full list of standard Android permission names. Mandatory argument.
  * If 'all' magic string is passed then the chosen action is going to be applied to all
- * permisisons requested/granted by 'appPackage'.
+ * permissions requested/granted by 'appPackage'.
  * If `target` is set to 'appops':
  * The full name of the appops permission to be changed
  * or a list of permissions. Check AppOpsManager.java sources to get the full list of
  * available appops permission names. Mandatory argument.
  * Examples: 'ACTIVITY_RECOGNITION', 'SMS_FINANCIAL_TRANSACTIONS', 'READ_SMS', 'ACCESS_NOTIFICATIONS'.
  * The 'all' magic string is unsupported.
- * @param {string} [appPackage] The application package to set change permissions on. Defaults to the
- * package name under test
- * @param {string} [action] One of `PM_ACTION` values if `target` is set to 'pm', otherwise
- * one of `APPOPS_ACTION` values
- * @param {'pm' | 'appops'} [target='pm'] Either 'pm' or 'appops'. The 'appops' one requires
- * 'adb_shell' server security option to be enabled.
+ * @param appPackage The application package to set change permissions on. Defaults to the
+ * package name under test.
+ * @param action One of `PM_ACTION` values if `target` is set to 'pm', otherwise
+ * one of `APPOPS_ACTION` values.
+ * @param target Either 'pm' or 'appops'. The 'appops' one requires
+ * 'adb_shell' server security option to be enabled. Defaults to 'pm'.
+ * @returns Promise that resolves when permissions are changed.
+ * @throws {errors.InvalidArgumentError} If permissions argument is missing, empty, or invalid.
  */
-export function mobileChangePermissions(this: import("../driver").AndroidDriver, permissions: string | string[], appPackage?: string, action?: string, target?: "pm" | "appops"): Promise<any>;
+export declare function mobileChangePermissions(this: AndroidDriver, permissions: string | string[], appPackage?: string, action?: PMAction | AppOpsAction, target?: PermissionTarget): Promise<void>;
 /**
- * @this {import('../driver').AndroidDriver}
- * @param {string} [type='requested'] One of possible permission types to get.
- * @param {string} [appPackage] The application package to set change permissions on.
- * Defaults to the package name under test
- * @returns {Promise<string[]>}
+ * Gets permissions for an Android application.
+ *
+ * @param type One of possible permission types to get. Defaults to 'requested'.
+ * @param appPackage The application package to get permissions for.
+ * Defaults to the package name under test.
+ * @returns Promise that resolves to an array of permission names.
+ * @throws {errors.InvalidArgumentError} If the permission type is unknown.
  */
-export function mobileGetPermissions(this: import("../driver").AndroidDriver, type?: string, appPackage?: string): Promise<string[]>;
-export type ADB = import("appium-adb").ADB;
-export type AndroidDriver = import("../driver").AndroidDriver;
+export declare function mobileGetPermissions(this: AndroidDriver, type?: PermissionsType, appPackage?: string): Promise<string[]>;
+type PMAction = typeof PM_ACTION[keyof typeof PM_ACTION];
+type AppOpsAction = typeof APPOPS_ACTION[keyof typeof APPOPS_ACTION];
+type PermissionTarget = typeof PERMISSION_TARGET[keyof typeof PERMISSION_TARGET];
+type PermissionsType = typeof PERMISSIONS_TYPE[keyof typeof PERMISSIONS_TYPE];
+export {};
 //# sourceMappingURL=permissions.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"permissions.d.ts","sourceRoot":"","sources":["../../../lib/commands/permissions.js"],"names":[],"mappings":"AA0BA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,8FAnBW,MAAM,GAAG,MAAM,EAAE,eAYjB,MAAM,WAEN,MAAM,WAEN,IAAI,GAAG,QAAQ,gBAmCzB;AAED;;;;;;GAMG;AACH,qFALW,MAAM,eACN,MAAM,GAEJ,OAAO,CAAC,MAAM,EAAE,CAAC,CAyB7B;kBAsEY,OAAO,YAAY,EAAE,GAAG;4BACxB,OAAO,WAAW,EAAE,aAAa"}
+{"version":3,"file":"permissions.d.ts","sourceRoot":"","sources":["../../../lib/commands/permissions.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,WAAW,CAAC;AAG7C,QAAA,MAAM,SAAS;;;EAGJ,CAAC;AACZ,QAAA,MAAM,aAAa;;;;;EAKR,CAAC;AACZ,QAAA,MAAM,iBAAiB;;;EAGZ,CAAC;AACZ,QAAA,MAAM,gBAAgB;;;;EAIX,CAAC;AAEZ;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,aAAa,EACnB,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,EAC9B,UAAU,CAAC,EAAE,MAAM,EACnB,MAAM,CAAC,EAAE,QAAQ,GAAG,YAAY,EAChC,MAAM,GAAE,gBAAuC,GAC9C,OAAO,CAAC,IAAI,CAAC,CA2Bf;AAED;;;;;;;;GAQG;AACH,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,aAAa,EACnB,IAAI,GAAE,eAA4C,EAClD,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,EAAE,CAAC,CAoBnB;AAoED,KAAK,QAAQ,GAAG,OAAO,SAAS,CAAC,MAAM,OAAO,SAAS,CAAC,CAAC;AACzD,KAAK,YAAY,GAAG,OAAO,aAAa,CAAC,MAAM,OAAO,aAAa,CAAC,CAAC;AACrE,KAAK,gBAAgB,GAAG,OAAO,iBAAiB,CAAC,MAAM,OAAO,iBAAiB,CAAC,CAAC;AACjF,KAAK,eAAe,GAAG,OAAO,gBAAgB,CAAC,MAAM,OAAO,gBAAgB,CAAC,CAAC"}

package/build/lib/commands/permissions.js

@@ -30,25 +30,28 @@ const PERMISSIONS_TYPE = Object.freeze({
     REQUESTED: 'requested',
 });
 /**
- * @this {import('../driver').AndroidDriver}
- * @param {string | string[]} permissions If `target` is set to 'pm':
+ * Changes permissions for an Android application.
+ *
+ * @param permissions If `target` is set to 'pm':
  *  The full name of the permission to be changed
  * or a list of permissions. Check https://developer.android.com/reference/android/Manifest.permission
- * to get the full list of standard Android permssion names. Mandatory argument.
+ * to get the full list of standard Android permission names. Mandatory argument.
  * If 'all' magic string is passed then the chosen action is going to be applied to all
- * permisisons requested/granted by 'appPackage'.
+ * permissions requested/granted by 'appPackage'.
  * If `target` is set to 'appops':
  * The full name of the appops permission to be changed
  * or a list of permissions. Check AppOpsManager.java sources to get the full list of
  * available appops permission names. Mandatory argument.
  * Examples: 'ACTIVITY_RECOGNITION', 'SMS_FINANCIAL_TRANSACTIONS', 'READ_SMS', 'ACCESS_NOTIFICATIONS'.
  * The 'all' magic string is unsupported.
- * @param {string} [appPackage] The application package to set change permissions on. Defaults to the
- * package name under test
- * @param {string} [action] One of `PM_ACTION` values if `target` is set to 'pm', otherwise
- * one of `APPOPS_ACTION` values
- * @param {'pm' | 'appops'} [target='pm'] Either 'pm' or 'appops'. The 'appops' one requires
- * 'adb_shell' server security option to be enabled.
+ * @param appPackage The application package to set change permissions on. Defaults to the
+ * package name under test.
+ * @param action One of `PM_ACTION` values if `target` is set to 'pm', otherwise
+ * one of `APPOPS_ACTION` values.
+ * @param target Either 'pm' or 'appops'. The 'appops' one requires
+ * 'adb_shell' server security option to be enabled. Defaults to 'pm'.
+ * @returns Promise that resolves when permissions are changed.
+ * @throws {errors.InvalidArgumentError} If permissions argument is missing, empty, or invalid.
  */
 async function mobileChangePermissions(permissions, appPackage, action, target = PERMISSION_TARGET.PM) {
     appPackage ??= this.opts.appPackage;
@@ -72,17 +75,16 @@ async function mobileChangePermissions(permissions, appPackage, action, target =
     }
 }
 /**
- * @this {import('../driver').AndroidDriver}
- * @param {string} [type='requested'] One of possible permission types to get.
- * @param {string} [appPackage] The application package to set change permissions on.
- * Defaults to the package name under test
- * @returns {Promise<string[]>}
+ * Gets permissions for an Android application.
+ *
+ * @param type One of possible permission types to get. Defaults to 'requested'.
+ * @param appPackage The application package to get permissions for.
+ * Defaults to the package name under test.
+ * @returns Promise that resolves to an array of permission names.
+ * @throws {errors.InvalidArgumentError} If the permission type is unknown.
  */
 async function mobileGetPermissions(type = PERMISSIONS_TYPE.REQUESTED, appPackage) {
     appPackage ??= this.opts.appPackage;
-    /**
-     * @type {(pkg: string) => Promise<string[]>}
-     */
     let actionFunc;
     switch (lodash_1.default.toLower(type)) {
         case PERMISSIONS_TYPE.REQUESTED:
@@ -98,15 +100,9 @@ async function mobileGetPermissions(type = PERMISSIONS_TYPE.REQUESTED, appPackag
             throw new driver_1.errors.InvalidArgumentError(`Unknown permissions type '${type}'. ` +
                 `Only ${JSON.stringify(lodash_1.default.values(PERMISSIONS_TYPE))} types are supported`);
     }
-    return await actionFunc(/** @type {string} */ (appPackage));
+    return await actionFunc(appPackage);
 }
 // #region Internal helpers
-/**
- * @this {AndroidDriver}
- * @param {string|string[]} permissions
- * @param {string} appPackage
- * @param {PM_ACTION[keyof PM_ACTION]} action
- */
 async function changePermissionsViaPm(permissions, appPackage, action) {
     if (!lodash_1.default.values(PM_ACTION).includes(action)) {
         throw new driver_1.errors.InvalidArgumentError(`Unknown action '${action}'. ` +
@@ -135,12 +131,6 @@ async function changePermissionsViaPm(permissions, appPackage, action) {
         await bluebird_1.default.all(affectedPermissions.map((name) => this.adb.revokePermission(appPackage, name)));
     }
 }
-/**
- * @this {AndroidDriver}
- * @param {string|string[]} permissions
- * @param {string} appPackage
- * @param {APPOPS_ACTION[keyof APPOPS_ACTION]} action
- */
 async function changePermissionsViaAppops(permissions, appPackage, action) {
     if (!lodash_1.default.values(APPOPS_ACTION).includes(action)) {
         throw new driver_1.errors.InvalidArgumentError(`Unknown action '${action}'. ` +
@@ -154,9 +144,4 @@ async function changePermissionsViaAppops(permissions, appPackage, action) {
     const promises = (lodash_1.default.isArray(permissions) ? permissions : [permissions]).map((permission) => this.adb.shell(['appops', 'set', appPackage, permission, action]));
     await bluebird_1.default.all(promises);
 }
-// #endregion
-/**
- * @typedef {import('appium-adb').ADB} ADB
- * @typedef {import('../driver').AndroidDriver} AndroidDriver
- */
 //# sourceMappingURL=permissions.js.map

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

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

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

@@ -1,21 +1,21 @@
+import type { StringRecord } from '@appium/types';
+import type { AndroidDriver } from '../driver';
 /**
- * @this {import('../driver').AndroidDriver}
- * @param {string?} [language=null]
- * @returns {Promise<import('@appium/types').StringRecord>}}
+ * Gets the localized strings from the application.
+ *
+ * @param language The language code to retrieve strings for. If not provided,
+ * the device's current language will be used.
+ * @returns Promise that resolves to a mapping of string keys to their localized values.
  */
-export function getStrings(this: import("../driver").AndroidDriver, language?: string | null): Promise<import("@appium/types").StringRecord>;
+export declare function getStrings(this: AndroidDriver, language?: string | null): Promise<StringRecord>;
 /**
- * @this {import('../driver').AndroidDriver}
- * @param {string} language
- * @param {string} country
- * @param {string} [script]
- * @returns {Promise<void>}}
+ * Ensures the device locale is set to the specified language, country, and optional script.
+ *
+ * @param language The language code (e.g., 'en', 'fr').
+ * @param country The country code (e.g., 'US', 'FR').
+ * @param script Optional script code.
+ * @returns Promise that resolves when the locale is set and verified.
+ * @throws {Error} If the locale cannot be set or verified.
  */
-export function ensureDeviceLocale(this: import("../driver").AndroidDriver, language: string, country: string, script?: string): Promise<void>;
-export type Locale = {
-    language: string;
-    country: string;
-    script?: string | undefined;
-};
-export type ADB = import("appium-adb").ADB;
+export declare function ensureDeviceLocale(this: AndroidDriver, language: string, country: string, script?: string): Promise<void>;
 //# sourceMappingURL=resources.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"resources.d.ts","sourceRoot":"","sources":["../../../lib/commands/resources.js"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,+EAHW,MAAM,OAAC,GACL,OAAO,CAAC,OAAO,eAAe,EAAE,YAAY,CAAC,CAqBzD;AAED;;;;;;GAMG;AACH,sFALW,MAAM,WACN,MAAM,WACN,MAAM,GACJ,OAAO,CAAC,IAAI,CAAC,CAwBzB;;cA0Ca,MAAM;aACN,MAAM;;;kBAgCP,OAAO,YAAY,EAAE,GAAG"}
+{"version":3,"file":"resources.d.ts","sourceRoot":"","sources":["../../../lib/commands/resources.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,eAAe,CAAC;AAChD,OAAO,KAAK,EAAC,aAAa,EAAoB,MAAM,WAAW,CAAC;AAGhE;;;;;;GAMG;AACH,wBAAsB,UAAU,CAC9B,IAAI,EAAE,aAAa,EACnB,QAAQ,GAAE,MAAM,GAAG,IAAW,GAC7B,OAAO,CAAC,YAAY,CAAC,CAiBvB;AAED;;;;;;;;GAQG;AACH,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,aAAa,EACnB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC,CAqBf"}

package/build/lib/commands/resources.js

@@ -8,9 +8,11 @@ exports.ensureDeviceLocale = ensureDeviceLocale;
 const lodash_1 = __importDefault(require("lodash"));
 const support_1 = require("@appium/support");
 /**
- * @this {import('../driver').AndroidDriver}
- * @param {string?} [language=null]
- * @returns {Promise<import('@appium/types').StringRecord>}}
+ * Gets the localized strings from the application.
+ *
+ * @param language The language code to retrieve strings for. If not provided,
+ * the device's current language will be used.
+ * @returns Promise that resolves to a mapping of string keys to their localized values.
  */
 async function getStrings(language = null) {
     if (!language) {
@@ -19,9 +21,7 @@ async function getStrings(language = null) {
     }
     // Clients require the resulting mapping to have both keys
     // and values of type string
-    /** @param {import('@appium/types').StringRecord} mapping */
     const preprocessStringsMap = (mapping) => {
-        /** @type {import('@appium/types').StringRecord} */
         const result = {};
         for (const [key, value] of lodash_1.default.toPairs(mapping)) {
             result[key] = lodash_1.default.isString(value) ? value : JSON.stringify(value);
@@ -31,11 +31,13 @@ async function getStrings(language = null) {
     return preprocessStringsMap(await extractStringsFromResources.bind(this)(language));
 }
 /**
- * @this {import('../driver').AndroidDriver}
- * @param {string} language
- * @param {string} country
- * @param {string} [script]
- * @returns {Promise<void>}}
+ * Ensures the device locale is set to the specified language, country, and optional script.
+ *
+ * @param language The language code (e.g., 'en', 'fr').
+ * @param country The country code (e.g., 'US', 'FR').
+ * @param script Optional script code.
+ * @returns Promise that resolves when the locale is set and verified.
+ * @throws {Error} If the locale cannot be set or verified.
  */
 async function ensureDeviceLocale(language, country, script) {
     try {
@@ -47,7 +49,6 @@ async function ensureDeviceLocale(language, country, script) {
     catch (e) {
         this.log.debug(e.stack);
         let errMsg = `Cannot set the device locale to '${toLocaleAbbr({ language, country, script })}'.`;
-        /** @type {string[]} */
         let suggestions = [];
         try {
             suggestions = (await fetchLocaleSuggestions.bind(this)(language, country)).map(toLocaleAbbr);
@@ -62,15 +63,8 @@ async function ensureDeviceLocale(language, country, script) {
     }
 }
 // #region Internal helpers
-/**
- * @this {import('../driver').AndroidDriver}
- * @param {string?} [language]
- * @param {import('../driver').AndroidDriverOpts?} [opts=null]
- * @returns {Promise<import('@appium/types').StringRecord>};
- */
 async function extractStringsFromResources(language, opts = null) {
     const caps = opts ?? this.opts;
-    /** @type {string|undefined} */
     let app = caps.app;
     let tmpRoot;
     try {
@@ -94,18 +88,6 @@ async function extractStringsFromResources(language, opts = null) {
         }
     }
 }
-/**
- * @typedef {Object} Locale
- * @property {string} language
- * @property {string} country
- * @property {string} [script]
- */
-/**
- * @this {import('../driver').AndroidDriver}
- * @param {string} [language]
- * @param {string} [country]
- * @returns {Promise<Locale[]>}
- */
 async function fetchLocaleSuggestions(language, country) {
     const supportedLocales = await this.settingsApp.listSupportedLocales();
     const suggestedLocales = supportedLocales
@@ -113,16 +95,8 @@ async function fetchLocaleSuggestions(language, country) {
         || lodash_1.default.toLower(country) === lodash_1.default.toLower(locale.country));
     return lodash_1.default.isEmpty(suggestedLocales) ? supportedLocales : suggestedLocales;
 }
-/**
- *
- * @param {Locale} locale
- * @returns {string}
- */
 function toLocaleAbbr({ language, country, script }) {
     return `${language}_${country}${script ? ('-' + script) : ''}`;
 }
 // #endregion
-/**
- * @typedef {import('appium-adb').ADB} ADB
- */
 //# sourceMappingURL=resources.js.map

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"shell.d.ts","sourceRoot":"","sources":["../../../lib/commands/shell.ts"],"names":[],"mappings":"AAMA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,WAAW,CAAC,CAAC,SAAS,OAAO,EACjD,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,MAAM,EAAO,EACnB,OAAO,GAAE,MAAc,EACvB,aAAa,CAAC,EAAE,CAAC,GAChB,OAAO,CAAC,CAAC,SAAS,IAAI,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;CAAE,GAAG,MAAM,CAAC,CA4BxE"}
+{"version":3,"file":"shell.d.ts","sourceRoot":"","sources":["../../../lib/commands/shell.ts"],"names":[],"mappings":"AAOA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,WAAW,CAAC,CAAC,SAAS,OAAO,EACjD,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,MAAM,EAAO,EACnB,OAAO,GAAE,MAAc,EACvB,aAAa,CAAC,EAAE,CAAC,GAChB,OAAO,CAAC,CAAC,SAAS,IAAI,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;CAAE,GAAG,MAAM,CAAC,CA4BxE"}

package/build/lib/commands/shell.js

@@ -50,7 +50,7 @@ async function mobileShell(command, args = [], timeout = 20000, includeStderr) {
         return stdout;
     }
     catch (e) {
-        const err = /** @type {import('teen_process').ExecError} */ (e);
+        const err = e;
         throw this.log.errorWithException(`Cannot execute the '${command}' shell command. ` +
             `Original error: ${err.message}. ` +
             `StdOut: ${err.stdout}. StdErr: ${err.stderr}`);

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

@@ -1 +1 @@
-{"version":3,"file":"shell.js","sourceRoot":"","sources":["../../../lib/commands/shell.ts"],"names":[],"mappings":";;;;;AA2BA,kCAiCC;AA5DD,6CAAqC;AACrC,0CAAqC;AACrC,oDAAuB;AACvB,+CAAkC;AAClC,oCAA2C;AAE3C;;;;;;;;;;;;;;;;;;;;GAoBG;AACI,KAAK,UAAU,WAAW,CAC/B,OAAe,EACf,OAAiB,EAAE,EACnB,UAAkB,KAAK,EACvB,aAAiB;IAEjB,IAAI,CAAC,oBAAoB,CAAC,yBAAiB,CAAC,CAAC;IAE7C,IAAI,CAAC,gBAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,eAAM,CAAC,oBAAoB,CAAC,qCAAqC,CAAC,CAAC;IAC/E,CAAC;IAED,MAAM,OAAO,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,WAAW,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,gBAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;IAC7F,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,YAAY,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,IAAI,cAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC/E,IAAI,CAAC;QACH,MAAM,EAAC,MAAM,EAAE,MAAM,EAAC,GAAG,MAAM,IAAA,mBAAI,EAAC,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,OAAO,EAAE,EAAC,OAAO,EAAC,CAAC,CAAC;QAClF,IAAI,aAAa,EAAE,CAAC;YAClB,4CAA4C;YAC5C,OAAO;gBACL,MAAM;gBACN,MAAM;aACP,CAAC;QACJ,CAAC;QACD,4CAA4C;QAC5C,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,GAAG,GAAG,+CAA+C,CAAC,CAAC,CAAC,CAAC,CAAC;QAChE,MAAM,IAAI,CAAC,GAAG,CAAC,kBAAkB,CAC/B,uBAAuB,OAAO,mBAAmB;YAC/C,mBAAmB,GAAG,CAAC,OAAO,IAAI;YAClC,WAAW,GAAG,CAAC,MAAM,aAAa,GAAG,CAAC,MAAM,EAAE,CACjD,CAAC;IACJ,CAAC;AACH,CAAC"}
+{"version":3,"file":"shell.js","sourceRoot":"","sources":["../../../lib/commands/shell.ts"],"names":[],"mappings":";;;;;AA4BA,kCAiCC;AA7DD,6CAAqC;AACrC,0CAAqC;AACrC,oDAAuB;AACvB,+CAAkC;AAElC,oCAA2C;AAE3C;;;;;;;;;;;;;;;;;;;;GAoBG;AACI,KAAK,UAAU,WAAW,CAC/B,OAAe,EACf,OAAiB,EAAE,EACnB,UAAkB,KAAK,EACvB,aAAiB;IAEjB,IAAI,CAAC,oBAAoB,CAAC,yBAAiB,CAAC,CAAC;IAE7C,IAAI,CAAC,gBAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,eAAM,CAAC,oBAAoB,CAAC,qCAAqC,CAAC,CAAC;IAC/E,CAAC;IAED,MAAM,OAAO,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,WAAW,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,gBAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;IAC7F,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,YAAY,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,IAAI,cAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC/E,IAAI,CAAC;QACH,MAAM,EAAC,MAAM,EAAE,MAAM,EAAC,GAAG,MAAM,IAAA,mBAAI,EAAC,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,OAAO,EAAE,EAAC,OAAO,EAAC,CAAC,CAAC;QAClF,IAAI,aAAa,EAAE,CAAC;YAClB,4CAA4C;YAC5C,OAAO;gBACL,MAAM;gBACN,MAAM;aACP,CAAC;QACJ,CAAC;QACD,4CAA4C;QAC5C,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,GAAG,GAAG,CAAc,CAAC;QAC3B,MAAM,IAAI,CAAC,GAAG,CAAC,kBAAkB,CAC/B,uBAAuB,OAAO,mBAAmB;YAC/C,mBAAmB,GAAG,CAAC,OAAO,IAAI;YAClC,WAAW,GAAG,CAAC,MAAM,aAAa,GAAG,CAAC,MAAM,EAAE,CACjD,CAAC;IACJ,CAAC;AACH,CAAC"}

package/build/lib/commands/system-bars.d.ts

@@ -1,41 +1,47 @@
+import type { StringRecord } from '@appium/types';
+import type { AndroidDriver } from '../driver';
+import type { StatusBarCommand, WindowProperties } from './types';
 /**
- * @this {import('../driver').AndroidDriver}
- * @returns {Promise<StringRecord>}
+ * Gets the system bars (status bar and navigation bar) properties.
+ *
+ * @returns Promise that resolves to an object containing statusBar and navigationBar properties.
+ * @throws {Error} If system bars details cannot be retrieved or parsed.
  */
-export function getSystemBars(this: import("../driver").AndroidDriver): Promise<StringRecord>;
+export declare function getSystemBars(this: AndroidDriver): Promise<StringRecord>;
 /**
- * @this {import('../driver').AndroidDriver}
- * @param {import('./types').StatusBarCommand} command Each list
- * item must separated with a new line (`\n`) character.
- * @param {string} [component] The name of the tile component.
+ * Performs a status bar command.
+ *
+ * @param command The status bar command to perform.
+ * @param component The name of the tile component.
  * It is only required for `(add|remove|click)Tile` commands.
  * Example value: `com.package.name/.service.QuickSettingsTileComponent`
- * @returns {Promise<string>}
+ * @returns Promise that resolves to the command output string.
+ * @throws {errors.InvalidArgumentError} If the command is unknown.
  */
-export function mobilePerformStatusBarCommand(this: import("../driver").AndroidDriver, command: import("./types").StatusBarCommand, component?: string): Promise<string>;
+export declare function mobilePerformStatusBarCommand(this: AndroidDriver, command: StatusBarCommand, component?: string): Promise<string>;
 /**
  * Parses window properties from adb dumpsys output
  *
- * @this {import('../driver').AndroidDriver}
- * @param {string} name The name of the window whose properties are being parsed
- * @param {Array<string>} props The list of particular window property lines.
+ * @param name The name of the window whose properties are being parsed
+ * @param props The list of particular window property lines.
  * Check the corresponding unit tests for more details on the input format.
- * @returns {WindowProperties} Parsed properties object
+ * @returns Parsed properties object
  * @throws {Error} If there was an issue while parsing the properties string
  */
-export function parseWindowProperties(this: import("../driver").AndroidDriver, name: string, props: Array<string>): WindowProperties;
+export declare function parseWindowProperties(this: AndroidDriver, name: string, props: string[]): WindowProperties;
 /**
  * Extracts status and navigation bar information from the window manager output.
  *
- * @this {import('../driver').AndroidDriver}
- * @param {string} lines Output from dumpsys command.
+ * @param lines Output from dumpsys command.
  * Check the corresponding unit tests for more details on the input format.
- * @return {StringRecord} An object containing two items where keys are statusBar and navigationBar,
+ * @return An object containing two items where keys are statusBar and navigationBar,
  * and values are corresponding WindowProperties objects
  * @throws {Error} If no window properties could be parsed
  */
-export function parseWindows(this: import("../driver").AndroidDriver, lines: string): StringRecord;
-export type ADB = import("appium-adb").ADB;
-export type StringRecord = import("@appium/types").StringRecord;
-export type WindowProperties = import("./types").WindowProperties;
+export declare function parseWindows(this: AndroidDriver, lines: string): SystemBarsResult;
+interface SystemBarsResult {
+    statusBar?: WindowProperties;
+    navigationBar?: WindowProperties;
+}
+export {};
 //# sourceMappingURL=system-bars.d.ts.map

package/build/lib/commands/system-bars.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"system-bars.d.ts","sourceRoot":"","sources":["../../../lib/commands/system-bars.js"],"names":[],"mappings":"AAqBA;;;GAGG;AACH,wEAFa,OAAO,CAAC,YAAY,CAAC,CAajC;AAED;;;;;;;;GAQG;AACH,gGAPW,OAAO,SAAS,EAAE,gBAAgB,cAElC,MAAM,GAGJ,OAAO,CAAC,MAAM,CAAC,CAqC3B;AAID;;;;;;;;;GASG;AACH,qFANW,MAAM,SACN,KAAK,CAAC,MAAM,CAAC,GAEX,gBAAgB,CAsB5B;AAED;;;;;;;;;GASG;AACH,6EANW,MAAM,GAEL,YAAY,CA2DvB;kBAKY,OAAO,YAAY,EAAE,GAAG;2BACxB,OAAO,eAAe,EAAE,YAAY;+BACpC,OAAO,SAAS,EAAE,gBAAgB"}
+{"version":3,"file":"system-bars.d.ts","sourceRoot":"","sources":["../../../lib/commands/system-bars.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,eAAe,CAAC;AAChD,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,WAAW,CAAC;AAC7C,OAAO,KAAK,EAAC,gBAAgB,EAAE,gBAAgB,EAAC,MAAM,SAAS,CAAC;AAoBhE;;;;;GAKG;AACH,wBAAsB,aAAa,CACjC,IAAI,EAAE,aAAa,GAClB,OAAO,CAAC,YAAY,CAAC,CAUvB;AAED;;;;;;;;;GASG;AACH,wBAAsB,6BAA6B,CACjD,IAAI,EAAE,aAAa,EACnB,OAAO,EAAE,gBAAgB,EACzB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,MAAM,CAAC,CAgCjB;AAID;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,aAAa,EACnB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EAAE,GACd,gBAAgB,CAmBlB;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,aAAa,EACnB,KAAK,EAAE,MAAM,GACZ,gBAAgB,CAmDlB;AAID,UAAU,gBAAgB;IACxB,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAC7B,aAAa,CAAC,EAAE,gBAAgB,CAAC;CAClC"}