io.appium.settings 7.0.7 → 7.0.9

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

@@ -1,26 +1,27 @@
 /**
- * RFC 2152 UTF-7 encoding with all optionals.
+ * RFC 2152 UTF-7 encoding.
  *
- * @param {string} str
- * @returns {string}
+ * @param mask Optional mask characters to exclude from encoding
+ */
+export declare const encode: (str: string, mask?: string | null) => string;
+/**
+ * RFC 2152 UTF-7 encoding with all optionals.
+ * Encodes all non-ASCII characters, including those that would normally
+ * be represented directly in standard UTF-7 encoding.
+ */
+export declare function encodeAll(str: string): string;
+/**
+ * RFC 2152 UTF-7 decoding.
  */
-export function encodeAll(str: string): string;
-export namespace imap {
+export declare const decode: (str: string) => string;
+export declare const imap: {
     /**
      * RFC 3501, section 5.1.3 UTF-7 encoding.
-     *
-     * @param {string} str
-     * @returns {string}
      */
-    function encode(str: string): string;
+    encode(str: string): string;
     /**
      * RFC 3501, section 5.1.3 UTF-7 decoding.
-     *
-     * @param {string} str
-     * @returns {string}
      */
-    function decode(str: string): string;
-}
-export function encode(str: string, mask?: string | null): string;
-export function decode(str: string): string;
+    decode(str: string): string;
+};
 //# sourceMappingURL=utf7.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"utf7.d.ts","sourceRoot":"","sources":["../../../lib/commands/utf7.js"],"names":[],"mappings":"AAmGA;;;;;GAKG;AACH,+BAHW,MAAM,GACJ,MAAM,CAQlB;;IAED;;;;;OAKG;IACH,qBAHW,MAAM,GACJ,MAAM,CAUlB;IAeD;;;;;OAKG;IACH,qBAHW,MAAM,GACJ,MAAM,CAOlB;;AAtEM,4BAJI,MAAM,SACN,MAAM,OAAC,GACL,MAAM,CAgBlB;AAsCM,4BAHI,MAAM,GACJ,MAAM,CAOlB"}
+{"version":3,"file":"utf7.d.ts","sourceRoot":"","sources":["../../../lib/commands/utf7.ts"],"names":[],"mappings":"AAaA;;;;GAIG;AACH,eAAO,MAAM,MAAM,GAAmB,KAAK,MAAM,EAAE,OAAM,MAAM,GAAG,IAAW,KAAG,MAc/E,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAM7C;AAED;;GAEG;AACH,eAAO,MAAM,MAAM,GAAmB,KAAK,MAAM,KAAG,MAKnD,CAAC;AAEF,eAAO,MAAM,IAAI;IACf;;OAEG;gBACS,MAAM,GAAG,MAAM;IAU3B;;OAEG;gBACS,MAAM,GAAG,MAAM;CAM5B,CAAC"}

package/build/lib/commands/utf7.js

@@ -3,78 +3,19 @@
  * The code below has been adopted from https://www.npmjs.com/package/utf7
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.decode = exports.encode = exports.imap = void 0;
+exports.imap = exports.decode = exports.encode = void 0;
 exports.encodeAll = encodeAll;
-/**
- * @param {number} length
- * @returns {Buffer}
- */
-function allocateAsciiBuffer(length) {
-    return Buffer.alloc(length, 'ascii');
-}
-/**
- * @param {string} str
- * @returns {string}
- */
-function _encode(str) {
-    const b = allocateAsciiBuffer(str.length * 2);
-    for (let i = 0, bi = 0; i < str.length; i++) {
-        // Note that we can't simply convert a UTF-8 string to Base64 because
-        // UTF-8 uses a different encoding. In modified UTF-7, all characters
-        // are represented by their two byte Unicode ID.
-        const c = str.charCodeAt(i);
-        // Upper 8 bits shifted into lower 8 bits so that they fit into 1 byte.
-        b[bi++] = c >> 8;
-        // Lower 8 bits. Cut off the upper 8 bits so that they fit into 1 byte.
-        b[bi++] = c & 0xFF;
-    }
-    // Modified Base64 uses , instead of / and omits trailing =.
-    return b.toString('base64').replace(/=+$/, '');
-}
-/**
- * @param {string} str
- * @returns {Buffer}
- */
-function allocateBase64Buffer(str) {
-    return Buffer.from(str, 'base64');
-}
-/**
- * @param {string} str
- * @returns {string}
- */
-function _decode(str) {
-    const b = allocateBase64Buffer(str);
-    const r = [];
-    for (let i = 0; i < b.length;) {
-        // Calculate charcode from two adjacent bytes.
-        r.push(String.fromCharCode(b[i++] << 8 | b[i++]));
-    }
-    return r.join('');
-}
-/**
- * Escape RegEx from http://simonwillison.net/2006/Jan/20/escape/
- *
- * @param {string} chars
- * @returns {string}
- */
-function escape(chars) {
-    return chars.replace(/[-[\]{}()*+?.,\\^$|#\s]/g, '\\$&');
-}
 // Character classes defined by RFC 2152.
 const setD = 'A-Za-z0-9' + escape(`'(),-./:?`);
 const setO = escape(`!"#$%&*;<=>@[]^_'{|}`);
 const setW = escape(` \r\n\t`);
 // Stores compiled regexes for various replacement pattern.
-/** @type {Record<string, RegExp>} */
 const regexes = {};
 const regexAll = new RegExp(`[^${setW}${setD}${setO}]+`, 'g');
-exports.imap = {};
 /**
  * RFC 2152 UTF-7 encoding.
  *
- * @param {string} str
- * @param {string?} mask
- * @returns {string}
+ * @param mask Optional mask characters to exclude from encoding
  */
 const encode = function encode(str, mask = null) {
     // Generate a RegExp object from the string of mask characters.
@@ -92,9 +33,8 @@ const encode = function encode(str, mask = null) {
 exports.encode = encode;
 /**
  * RFC 2152 UTF-7 encoding with all optionals.
- *
- * @param {string} str
- * @returns {string}
+ * Encodes all non-ASCII characters, including those that would normally
+ * be represented directly in standard UTF-7 encoding.
  */
 function encodeAll(str) {
     // We replace subsequent disallowed chars with their escape sequence.
@@ -102,26 +42,8 @@ function encodeAll(str) {
     // + is represented by an empty sequence +-, otherwise call encode().
     `+${chunk === '+' ? '' : _encode(chunk)}-`);
 }
-/**
- * RFC 3501, section 5.1.3 UTF-7 encoding.
- *
- * @param {string} str
- * @returns {string}
- */
-exports.imap.encode = function encode(str) {
-    // All printable ASCII chars except for & must be represented by themselves.
-    // We replace subsequent non-representable chars with their escape sequence.
-    return str.replace(/&/g, '&-').replace(/[^\x20-\x7e]+/g, (chunk) => {
-        // & is represented by an empty sequence &-, otherwise call encode().
-        chunk = (chunk === '&' ? '' : _encode(chunk)).replace(/\//g, ',');
-        return `&${chunk}-`;
-    });
-};
 /**
  * RFC 2152 UTF-7 decoding.
- *
- * @param {string} str
- * @returns {string}
  */
 const decode = function decode(str) {
     return str.replace(/\+([A-Za-z0-9/]*)-?/gi, (_, chunk) => 
@@ -129,15 +51,75 @@ const decode = function decode(str) {
     chunk === '' ? '+' : _decode(chunk));
 };
 exports.decode = decode;
+exports.imap = {
+    /**
+     * RFC 3501, section 5.1.3 UTF-7 encoding.
+     */
+    encode(str) {
+        // All printable ASCII chars except for & must be represented by themselves.
+        // We replace subsequent non-representable chars with their escape sequence.
+        return str.replace(/&/g, '&-').replace(/[^\x20-\x7e]+/g, (chunk) => {
+            // & is represented by an empty sequence &-, otherwise call encode().
+            chunk = (chunk === '&' ? '' : _encode(chunk)).replace(/\//g, ',');
+            return `&${chunk}-`;
+        });
+    },
+    /**
+     * RFC 3501, section 5.1.3 UTF-7 decoding.
+     */
+    decode(str) {
+        return str.replace(/&([^-]*)-/g, (_, chunk) => 
+        // &- represents &.
+        chunk === '' ? '&' : _decode(chunk.replace(/,/g, '/')));
+    },
+};
 /**
- * RFC 3501, section 5.1.3 UTF-7 decoding.
- *
- * @param {string} str
- * @returns {string}
+ * Allocates an ASCII buffer of the specified length.
  */
-exports.imap.decode = function decode(str) {
-    return str.replace(/&([^-]*)-/g, (_, chunk) => 
-    // &- represents &.
-    chunk === '' ? '&' : _decode(chunk.replace(/,/g, '/')));
-};
+function allocateAsciiBuffer(length) {
+    return Buffer.alloc(length, 'ascii');
+}
+/**
+ * Encodes a string using modified UTF-7 encoding.
+ */
+function _encode(str) {
+    const b = allocateAsciiBuffer(str.length * 2);
+    for (let i = 0, bi = 0; i < str.length; i++) {
+        // Note that we can't simply convert a UTF-8 string to Base64 because
+        // UTF-8 uses a different encoding. In modified UTF-7, all characters
+        // are represented by their two byte Unicode ID.
+        const c = str.charCodeAt(i);
+        // Upper 8 bits shifted into lower 8 bits so that they fit into 1 byte.
+        b[bi++] = c >> 8;
+        // Lower 8 bits. Cut off the upper 8 bits so that they fit into 1 byte.
+        b[bi++] = c & 0xFF;
+    }
+    // Modified Base64 uses , instead of / and omits trailing =.
+    return b.toString('base64').replace(/=+$/, '');
+}
+/**
+ * Allocates a buffer from a base64 string.
+ */
+function allocateBase64Buffer(str) {
+    return Buffer.from(str, 'base64');
+}
+/**
+ * Decodes a string using modified UTF-7 encoding.
+ */
+function _decode(str) {
+    const b = allocateBase64Buffer(str);
+    const r = [];
+    for (let i = 0; i < b.length;) {
+        // Calculate charcode from two adjacent bytes.
+        r.push(String.fromCharCode(b[i++] << 8 | b[i++]));
+    }
+    return r.join('');
+}
+/**
+ * Escapes special regex characters.
+ * From http://simonwillison.net/2006/Jan/20/escape/
+ */
+function escape(chars) {
+    return chars.replace(/[-[\]{}()*+?.,\\^$|#\s]/g, '\\$&');
+}
 //# sourceMappingURL=utf7.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"utf7.js","sourceRoot":"","sources":["../../../lib/commands/utf7.js"],"names":[],"mappings":";AAAA;;GAEG;;;AAuGH,8BAMC;AA3GD;;;GAGG;AACH,SAAS,mBAAmB,CAAC,MAAM;IACjC,OAAO,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AACvC,CAAC;AAED;;;GAGG;AACH,SAAS,OAAO,CAAC,GAAG;IAClB,MAAM,CAAC,GAAG,mBAAmB,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC9C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC5C,qEAAqE;QACrE,qEAAqE;QACrE,gDAAgD;QAChD,MAAM,CAAC,GAAG,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QAC5B,uEAAuE;QACvE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACjB,uEAAuE;QACvE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;IACrB,CAAC;IACD,4DAA4D;IAC5D,OAAO,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;AACjD,CAAC;AAED;;;GAGG;AACH,SAAS,oBAAoB,CAAC,GAAG;IAC/B,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;AACpC,CAAC;AAED;;;GAGG;AACH,SAAS,OAAO,CAAC,GAAG;IAClB,MAAM,CAAC,GAAG,oBAAoB,CAAC,GAAG,CAAC,CAAC;IACpC,MAAM,CAAC,GAAG,EAAE,CAAC;IACb,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,GAAG,CAAC;QAC9B,8CAA8C;QAC9C,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACpD,CAAC;IACD,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACpB,CAAC;AAED;;;;;GAKG;AACH,SAAS,MAAM,CAAC,KAAK;IACnB,OAAO,KAAK,CAAC,OAAO,CAAC,0BAA0B,EAAE,MAAM,CAAC,CAAC;AAC3D,CAAC;AAED,yCAAyC;AACzC,MAAM,IAAI,GAAG,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC;AAC/C,MAAM,IAAI,GAAG,MAAM,CAAC,sBAAsB,CAAC,CAAC;AAC5C,MAAM,IAAI,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC;AAE/B,2DAA2D;AAC3D,qCAAqC;AACrC,MAAM,OAAO,GAAG,EAAE,CAAC;AACnB,MAAM,QAAQ,GAAG,IAAI,MAAM,CAAC,KAAK,IAAI,GAAG,IAAI,GAAG,IAAI,IAAI,EAAE,GAAG,CAAC,CAAC;AAEjD,QAAA,IAAI,GAAG,EAAE,CAAC;AAEvB;;;;;;GAMG;AACI,MAAM,MAAM,GAAG,SAAS,MAAM,CAAC,GAAG,EAAE,IAAI,GAAG,IAAI;IACpD,+DAA+D;IAC/D,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,IAAI,GAAG,EAAE,CAAC;IACZ,CAAC;IACD,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACnB,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,MAAM,CAAC,KAAK,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAChE,CAAC;IAED,qEAAqE;IACrE,OAAO,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,EAAE;IAC1C,qEAAqE;IACrE,IAAI,KAAK,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAC3C,CAAC;AACJ,CAAC,CAAC;AAdW,QAAA,MAAM,UAcjB;AAEF;;;;;GAKG;AACH,SAAgB,SAAS,CAAC,GAAG;IAC3B,qEAAqE;IACrE,OAAO,GAAG,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE;IACrC,qEAAqE;IACrE,IAAI,KAAK,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAC3C,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,YAAI,CAAC,MAAM,GAAG,SAAS,MAAM,CAAC,GAAG;IAC/B,4EAA4E;IAC5E,4EAA4E;IAC5E,OAAO,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,OAAO,CAAC,gBAAgB,EAAE,CAAC,KAAK,EAAE,EAAE;QACjE,qEAAqE;QACrE,KAAK,GAAG,CAAC,KAAK,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QAClE,OAAO,IAAI,KAAK,GAAG,CAAC;IACtB,CAAC,CAAC,CAAC;AACL,CAAC,CAAC;AAEF;;;;;GAKG;AACI,MAAM,MAAM,GAAG,SAAS,MAAM,CAAC,GAAG;IACvC,OAAO,GAAG,CAAC,OAAO,CAAC,uBAAuB,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE;IACvD,mBAAmB;IACnB,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CACpC,CAAC;AACJ,CAAC,CAAC;AALW,QAAA,MAAM,UAKjB;AAEF;;;;;GAKG;AACH,YAAI,CAAC,MAAM,GAAG,SAAS,MAAM,CAAC,GAAG;IAC/B,OAAO,GAAG,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE;IAC5C,mBAAmB;IACnB,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CACvD,CAAC;AACJ,CAAC,CAAC"}
+{"version":3,"file":"utf7.js","sourceRoot":"","sources":["../../../lib/commands/utf7.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAqCH,8BAMC;AAzCD,yCAAyC;AACzC,MAAM,IAAI,GAAG,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC;AAC/C,MAAM,IAAI,GAAG,MAAM,CAAC,sBAAsB,CAAC,CAAC;AAC5C,MAAM,IAAI,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC;AAE/B,2DAA2D;AAC3D,MAAM,OAAO,GAA2B,EAAE,CAAC;AAC3C,MAAM,QAAQ,GAAG,IAAI,MAAM,CAAC,KAAK,IAAI,GAAG,IAAI,GAAG,IAAI,IAAI,EAAE,GAAG,CAAC,CAAC;AAE9D;;;;GAIG;AACI,MAAM,MAAM,GAAG,SAAS,MAAM,CAAC,GAAW,EAAE,OAAsB,IAAI;IAC3E,+DAA+D;IAC/D,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,IAAI,GAAG,EAAE,CAAC;IACZ,CAAC;IACD,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACnB,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,MAAM,CAAC,KAAK,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAChE,CAAC;IAED,qEAAqE;IACrE,OAAO,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,EAAE;IAC1C,qEAAqE;IACrE,IAAI,KAAK,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAC3C,CAAC;AACJ,CAAC,CAAC;AAdW,QAAA,MAAM,UAcjB;AAEF;;;;GAIG;AACH,SAAgB,SAAS,CAAC,GAAW;IACnC,qEAAqE;IACrE,OAAO,GAAG,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE;IACrC,qEAAqE;IACrE,IAAI,KAAK,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAC3C,CAAC;AACJ,CAAC;AAED;;GAEG;AACI,MAAM,MAAM,GAAG,SAAS,MAAM,CAAC,GAAW;IAC/C,OAAO,GAAG,CAAC,OAAO,CAAC,uBAAuB,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE;IACvD,mBAAmB;IACnB,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CACpC,CAAC;AACJ,CAAC,CAAC;AALW,QAAA,MAAM,UAKjB;AAEW,QAAA,IAAI,GAAG;IAClB;;OAEG;IACH,MAAM,CAAC,GAAW;QAChB,4EAA4E;QAC5E,4EAA4E;QAC5E,OAAO,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,OAAO,CAAC,gBAAgB,EAAE,CAAC,KAAK,EAAE,EAAE;YACjE,qEAAqE;YACrE,KAAK,GAAG,CAAC,KAAK,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;YAClE,OAAO,IAAI,KAAK,GAAG,CAAC;QACtB,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,GAAW;QAChB,OAAO,GAAG,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE;QAC5C,mBAAmB;QACnB,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CACvD,CAAC;IACJ,CAAC;CACF,CAAC;AAEF;;GAEG;AACH,SAAS,mBAAmB,CAAC,MAAc;IACzC,OAAO,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AACvC,CAAC;AAED;;GAEG;AACH,SAAS,OAAO,CAAC,GAAW;IAC1B,MAAM,CAAC,GAAG,mBAAmB,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC9C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC5C,qEAAqE;QACrE,qEAAqE;QACrE,gDAAgD;QAChD,MAAM,CAAC,GAAG,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QAC5B,uEAAuE;QACvE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACjB,uEAAuE;QACvE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;IACrB,CAAC;IACD,4DAA4D;IAC5D,OAAO,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;AACjD,CAAC;AAED;;GAEG;AACH,SAAS,oBAAoB,CAAC,GAAW;IACvC,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;AACpC,CAAC;AAED;;GAEG;AACH,SAAS,OAAO,CAAC,GAAW;IAC1B,MAAM,CAAC,GAAG,oBAAoB,CAAC,GAAG,CAAC,CAAC;IACpC,MAAM,CAAC,GAAa,EAAE,CAAC;IACvB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,GAAG,CAAC;QAC9B,8CAA8C;QAC9C,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACpD,CAAC;IACD,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACpB,CAAC;AAED;;;GAGG;AACH,SAAS,MAAM,CAAC,KAAa;IAC3B,OAAO,KAAK,CAAC,OAAO,CAAC,0BAA0B,EAAE,MAAM,CAAC,CAAC;AAC3D,CAAC"}

package/lib/commands/{geolocation.js → geolocation.ts}

@@ -7,6 +7,8 @@ import {
 import { SubProcess } from 'teen_process';
 import B from 'bluebird';
 import { LOG_PREFIX } from '../logger.js';
+import type { SettingsApp } from '../client.js';
+import type { Location } from './types.js';
 
 const DEFAULT_SATELLITES_COUNT = 12;
 const DEFAULT_ALTITUDE = 0.0;
@@ -18,42 +20,23 @@ const GPS_CACHE_REFRESHED_LOGS = [
 
 const GPS_COORDINATES_PATTERN = /data="(-?[\d.]+)\s+(-?[\d.]+)\s+(-?[\d.]+)"/;
 
-/**
- * @typedef {Object} Location
- * @property {number|string} longitude - Valid longitude value.
- * @property {number|string} latitude - Valid latitude value.
- * @property {number|string|null} [altitude] - Valid altitude value.
- * @property {number|string|null} [satellites=12] - Number of satellites being tracked (1-12).
- * This value is ignored on real devices.
- * @property {number|string|null} [speed] - Valid speed value.
- * https://developer.android.com/reference/android/location/Location#setSpeed(float)
- * @property {number|string|null} [bearing] - Valid bearing value.
- * https://developer.android.com/reference/android/location/Location#setBearing(float)
- * @property {number|string|null} [accuracy] - Valid accuracy value.
- * https://developer.android.com/reference/android/location/Location#setAccuracy(float),
- * https://developer.android.com/reference/android/location/Criteria
- * Should be greater than 0.0 meters/second for real devices or 0.0 knots
- * for emulators.
- */
-
 /**
  * Emulate geolocation coordinates on the device under test.
+ * The `altitude` value is ignored while mocking the position.
  *
- * @this {import('../client').SettingsApp}
- * @param {Location} location - Location object. The `altitude` value is ignored
- * while mocking the position.
- * @param {boolean} [isEmulator=false] - Set it to true if the device under test
- *                                       is an emulator rather than a real device.
+ * @param location - Location object containing coordinates and optional metadata
+ * @param isEmulator - Set it to true if the device under test is an emulator rather than a real device
+ * @throws {Error} If required location values are missing or invalid
  */
-export async function setGeoLocation (location, isEmulator = false) {
-  const formatLocationValue = (valueName, isRequired = true) => {
+export async function setGeoLocation(this: SettingsApp, location: Location, isEmulator = false): Promise<void> {
+  const formatLocationValue = (valueName: keyof Location, isRequired = true): string | null => {
     if (_.isNil(location[valueName])) {
       if (isRequired) {
         throw new Error(`${valueName} must be provided`);
       }
       return null;
     }
-    const floatValue = parseFloat(location[valueName]);
+    const floatValue = parseFloat(String(location[valueName]));
     if (!isNaN(floatValue)) {
       return `${_.ceil(floatValue, 5)}`;
     }
@@ -63,15 +46,14 @@ export async function setGeoLocation (location, isEmulator = false) {
     }
     return null;
   };
-  const longitude = /** @type {string} */ (formatLocationValue('longitude'));
-  const latitude = /** @type {string} */ (formatLocationValue('latitude'));
+  const longitude = formatLocationValue('longitude') as string;
+  const latitude = formatLocationValue('latitude') as string;
   const altitude = formatLocationValue('altitude', false);
   const speed = formatLocationValue('speed', false);
   const bearing = formatLocationValue('bearing', false);
   const accuracy = formatLocationValue('accuracy', false);
   if (isEmulator) {
-    /** @type {string[]} */
-    const args = [longitude, latitude];
+    const args: string[] = [longitude, latitude];
     if (!_.isNil(altitude)) {
       args.push(altitude);
     }
@@ -96,7 +78,7 @@ export async function setGeoLocation (location, isEmulator = false) {
     // A workaround for https://code.google.com/p/android/issues/detail?id=206180
     await this.adb.adbExec(['emu', 'geo', 'fix', ...(args.map((arg) => arg.replace('.', ',')))]);
   } else {
-    const args = [
+    const args: string[] = [
       'am', 'start-foreground-service',
       '-e', 'longitude', longitude,
       '-e', 'latitude', latitude,
@@ -130,11 +112,10 @@ export async function setGeoLocation (location, isEmulator = false) {
 /**
  * Get the current cached GPS location from the device under test.
  *
- * @this {import('../client').SettingsApp}
- * @returns {Promise<Location>} The current location
+ * @returns The current location
  * @throws {Error} If the current location cannot be retrieved
  */
-export async function getGeoLocation () {
+export async function getGeoLocation(this: SettingsApp): Promise<Location> {
   const output = await this.checkBroadcast([
     '-n', LOCATION_RECEIVER,
     '-a', LOCATION_RETRIEVAL_ACTION,
@@ -144,7 +125,7 @@ export async function getGeoLocation () {
   if (!match) {
     throw new Error(`Cannot parse the actual location values from the command output: ${output}`);
   }
-  const location = {
+  const location: Location = {
     latitude: match[1],
     longitude: match[2],
     altitude: match[3],
@@ -160,18 +141,15 @@ export async function getGeoLocation () {
  * LocationManager is used the device API level must be at
  * version 30 (Android R) or higher.
  *
- * @this {import('../client').SettingsApp}
- * @param {number} timeoutMs The maximum number of milliseconds
- * to block until GPS cache is refreshed. Providing zero or a negative
- * value to it skips waiting completely.
- *
+ * @param timeoutMs The maximum number of milliseconds to block until GPS cache is refreshed.
+ *                  Providing zero or a negative value to it skips waiting completely.
  * @throws {Error} If the GPS cache cannot be refreshed.
  */
-export async function refreshGeoLocationCache (timeoutMs = 20000) {
+export async function refreshGeoLocationCache(this: SettingsApp, timeoutMs = 20000): Promise<void> {
   await this.requireRunning({shouldRestoreCurrentApp: true});
 
-  let logcatMonitor;
-  let monitoringPromise;
+  let logcatMonitor: SubProcess | undefined;
+  let monitoringPromise: Promise<void> | undefined;
 
   if (timeoutMs > 0) {
     const cmd = [
@@ -183,11 +161,12 @@ export async function refreshGeoLocationCache (timeoutMs = 20000) {
       `Please make sure the device under test has Appium Settings app installed and running. ` +
       `Also, it is required that the device has Google Play Services installed or is running ` +
       `Android 10+ otherwise.`;
-    monitoringPromise = new B((resolve, reject) => {
+    const monitor = logcatMonitor;
+    monitoringPromise = new B<void>((resolve, reject) => {
       setTimeout(() => reject(new Error(timeoutErrorMsg)), timeoutMs);
 
-      logcatMonitor.on('exit', () => reject(new Error(timeoutErrorMsg)));
-      ['lines-stderr', 'lines-stdout'].map((evt) => logcatMonitor.on(evt, (lines) => {
+      monitor.on('exit', () => reject(new Error(timeoutErrorMsg)));
+      (['lines-stderr', 'lines-stdout'] as const).map((evt) => monitor.on(evt, (lines: string[]) => {
         if (lines.some((line) => GPS_CACHE_REFRESHED_LOGS.some((x) => line.includes(x)))) {
           resolve();
         }

package/lib/commands/{media-projection.js → media-projection.ts}

@@ -9,25 +9,60 @@ import {
   RECORDING_ACTION_STOP,
   RECORDING_ACTIVITY_NAME,
   RECORDING_SERVICE_NAME,
-} from '../constants';
+} from '../constants.js';
+import type { ADB } from 'appium-adb';
+import type { SettingsApp } from '../client.js';
+import type { StartMediaProjectionRecordingOpts } from './types.js';
+
+/**
+ * Creates a new instance of the MediaProjection-based recorder.
+ * The recorder only works since Android API 29+
+ *
+ * @returns The recorder instance
+ */
+export function makeMediaProjectionRecorder(this: SettingsApp): MediaProjectionRecorder {
+  return new MediaProjectionRecorder(this.adb);
+}
+
+/**
+ * Adjusts the necessary permissions for the Media Projection-based recording service.
+ * This method only applies to devices running Android API 29 or higher.
+ *
+ * @returns True if permissions were adjusted, false if device API level is below 29
+ */
+export async function adjustMediaProjectionServicePermissions(this: SettingsApp): Promise<boolean> {
+  if (await this.adb.getApiLevel() >= 29) {
+    await this.adb.shell(['appops', 'set', SETTINGS_HELPER_ID, 'PROJECT_MEDIA', 'allow']);
+    return true;
+  }
+  return false;
+}
 
 const RECORDING_STARTUP_TIMEOUT_MS = 3 * 1000;
 const RECORDING_STOP_TIMEOUT_MS = 3 * 1000;
 const RECORDINGS_ROOT = `/storage/emulated/0/Android/data/${SETTINGS_HELPER_ID}/files`;
 
+/**
+ * Media projection recorder for capturing device screen recordings.
+ * This class provides methods to start, stop, and manage screen recordings
+ * using Android's MediaProjection API (API 29+).
+ */
 class MediaProjectionRecorder {
+  private readonly adb: ADB;
+
   /**
-   * @param {ADB} adb
+   * Creates a new MediaProjectionRecorder instance.
+   *
+   * @param adb - ADB instance for device communication
    */
-  constructor(adb) {
+  constructor(adb: ADB) {
     this.adb = adb;
   }
 
   /**
-   *
-   * @returns {Promise<boolean>}
+   * Checks if the recording is currently running.
    */
-  async isRunning() {
+  async isRunning(): Promise<boolean> {
     const stdout = await this.adb.shell([
       'dumpsys',
       'activity',
@@ -38,18 +73,21 @@ class MediaProjectionRecorder {
   }
 
   /**
+   * Starts the media projection recording.
+   * If a recording is already running, this method will return false without starting a new one.
    *
-   * @param {StartMediaProjectionRecordingOpts} opts
-   * @returns {Promise<boolean>}
+   * @param opts Recording options including filename, resolution, duration, and priority
+   * @returns True if recording was started successfully, false if already running
+   * @throws {Error} If recording fails to start within the timeout period
    */
-  async start(opts = {}) {
+  async start(opts: StartMediaProjectionRecordingOpts = {}): Promise<boolean> {
     if (await this.isRunning()) {
       return false;
     }
 
     await this.cleanup();
     const {filename, maxDurationSec, priority, resolution} = opts;
-    const args = ['am', 'start', '-n', RECORDING_ACTIVITY_NAME, '-a', RECORDING_ACTION_START];
+    const args: string[] = ['am', 'start', '-n', RECORDING_ACTIVITY_NAME, '-a', RECORDING_ACTION_START];
     if (filename) {
       args.push('--es', 'filename', filename);
     }
@@ -63,7 +101,7 @@ class MediaProjectionRecorder {
       args.push('--es', 'resolution', resolution);
     }
     await this.adb.shell(args);
-    await new B((resolve, reject) => {
+    await new B<void>((resolve, reject) => {
       setTimeout(async () => {
         if (!(await this.isRunning())) {
           return reject(
@@ -80,17 +118,18 @@ class MediaProjectionRecorder {
   }
 
   /**
-   * @returns {Promise<void>}
+   * Cleans up old recording files.
    */
-  async cleanup() {
+  async cleanup(): Promise<void> {
     await this.adb.shell([`rm -f ${RECORDINGS_ROOT}/*`]);
   }
 
   /**
+   * Pulls the most recent recording file from the device.
    *
-   * @returns {Promise<string?>}
+   * @returns Path to the pulled file, or null if no recordings exist
    */
-  async pullRecent() {
+  async pullRecent(): Promise<string | null> {
     const recordings = await this.adb.ls(RECORDINGS_ROOT, ['-tr']);
     if (_.isEmpty(recordings)) {
       return null;
@@ -104,9 +143,12 @@ class MediaProjectionRecorder {
   }
 
   /**
-   * @returns {Promise<boolean>}
+   * Stops the current recording.
+   *
+   * @returns True if recording was stopped successfully, false if no recording was running
+   * @throws {Error} If the recording fails to stop within the timeout period
    */
-  async stop() {
+  async stop(): Promise<boolean> {
     if (!(await this.isRunning())) {
       return false;
     }
@@ -133,49 +175,3 @@ class MediaProjectionRecorder {
     return true;
   }
 }
-
-/**
- * Creates a new instance of the MediaProjection-based recorder
- * The recorder only works since Android API 29+
- *
- * @this {import('../client').SettingsApp}
- * @returns {MediaProjectionRecorder} The recorder instance
- */
-export function makeMediaProjectionRecorder() {
-  return new MediaProjectionRecorder(this.adb);
-}
-
-/**
- * Adjusts the necessary permissions for the
- * Media Projection-based recording service
- *
- * @this {import('../client').SettingsApp}
- * @returns {Promise<boolean>} If the permissions adjustment has actually been made
- */
-export async function adjustMediaProjectionServicePermissions() {
-  if (await this.adb.getApiLevel() >= 29) {
-    await this.adb.shell(['appops', 'set', SETTINGS_HELPER_ID, 'PROJECT_MEDIA', 'allow']);
-    return true;
-  }
-  return false;
-}
-
-/**
- * @typedef {import('appium-adb').ADB} ADB
- */
-
-/**
- * @typedef {Object} StartMediaProjectionRecordingOpts
- * @property {string} [resolution] Maximum supported resolution on-device (Detected automatically by the app
- * itself), which usually equals to Full HD 1920x1080 on most phones however
- * you can change it to following supported resolutions as well: "1920x1080",
- * "1280x720", "720x480", "320x240", "176x144".
- * @property {number} [maxDurationSec=900] Maximum allowed duration is 15 minutes; you can increase it if your test
- * takes longer than that.
- * @property {'high' | 'normal' | 'low'} [priority='high'] Recording thread priority.
- * If you face performance drops during testing with recording enabled, you
- * can reduce recording priority
- * @property {string} [filename] You can type recording video file name as you want, but recording currently
- * supports only "mp4" format so your filename must end with ".mp4". An
- * invalid file name will fail to start the recording.
- */

package/lib/commands/types.ts

@@ -0,0 +1,38 @@
+/**
+ * Location object containing geolocation coordinates and optional metadata.
+ */
+export interface Location {
+  longitude: number | string;
+  latitude: number | string;
+  altitude?: number | string | null;
+  /** Number of satellites being tracked (1-12). This value is ignored on real devices. */
+  satellites?: number | string | null;
+  /** Valid speed value. https://developer.android.com/reference/android/location/Location#setSpeed(float) */
+  speed?: number | string | null;
+  /** Valid bearing value. https://developer.android.com/reference/android/location/Location#setBearing(float) */
+  bearing?: number | string | null;
+  /** Valid accuracy value. https://developer.android.com/reference/android/location/Location#setAccuracy(float), https://developer.android.com/reference/android/location/Criteria. Should be greater than 0.0 meters/second for real devices or 0.0 knots for emulators. */
+  accuracy?: number | string | null;
+}
+
+/**
+ * Options for starting a media projection recording session.
+ */
+export interface StartMediaProjectionRecordingOpts {
+  /** Maximum supported resolution on-device (Detected automatically by the app
+   * itself), which usually equals to Full HD 1920x1080 on most phones however
+   * you can change it to following supported resolutions as well: "1920x1080",
+   * "1280x720", "720x480", "320x240", "176x144". */
+  resolution?: string;
+  /** Maximum allowed duration is 15 minutes; you can increase it if your test
+   * takes longer than that. */
+  maxDurationSec?: number;
+  /** Recording thread priority.
+   * If you face performance drops during testing with recording enabled, you
+   * can reduce recording priority */
+  priority?: 'high' | 'normal' | 'low';
+  /** You can type recording video file name as you want, but recording currently
+   * supports only "mp4" format so your filename must end with ".mp4". An
+   * invalid file name will fail to start the recording. */
+  filename?: string;
+}