appium-adb 9.14.11 → 10.0.0

package/CHANGELOG.md

@@ -1,3 +1,26 @@
+## [10.0.0](https://github.com/appium/appium-adb/compare/v9.14.12...v10.0.0) (2023-10-16)
+
+
+### ⚠ BREAKING CHANGES
+
+* Some type declarations have been changed in order to make the compiler happy
+
+### Features
+
+* Improve type declarations ([#698](https://github.com/appium/appium-adb/issues/698)) ([7d2588a](https://github.com/appium/appium-adb/commit/7d2588a1842be73dd77c08c493e7aef5aa4ee92d))
+
+## [9.14.12](https://github.com/appium/appium-adb/compare/v9.14.11...v9.14.12) (2023-10-08)
+
+
+### Bug Fixes
+
+* Fallback the boot detection if the device does not have reboot_readiness service ([#697](https://github.com/appium/appium-adb/issues/697)) ([8a84148](https://github.com/appium/appium-adb/commit/8a841483429b1949ac663829f8801f62ee88f49c))
+
+
+### Miscellaneous Chores
+
+* Bump sinon from 15.2.0 to 16.0.0 ([7a51919](https://github.com/appium/appium-adb/commit/7a51919af82716beebba4880e404275925b54488))
+
 ## [9.14.11](https://github.com/appium/appium-adb/compare/v9.14.10...v9.14.11) (2023-09-14)
 
 

package/build/lib/adb.d.ts

@@ -1,6 +1,8 @@
 import { getAndroidBinaryPath } from './tools';
 import { getSdkRootFromEnv } from './helpers';
 import type { ADBOptions, ADBExecutable } from './options';
+import type { LogcatOpts } from './logcat';
+import type { LRUCache } from 'lru-cache';
 declare const DEFAULT_ADB_PORT = 5037;
 export declare const DEFAULT_OPTS: {
     readonly sdkRoot: string | undefined;
@@ -20,6 +22,16 @@ export declare const DEFAULT_OPTS: {
 export declare class ADB {
     adbHost?: string;
     adbPort?: number;
+    _apiLevel: number | undefined;
+    _logcatStartupParams: LogcatOpts | undefined;
+    _doesPsSupportAOption: boolean | undefined;
+    _isPgrepAvailable: boolean | undefined;
+    _canPgrepUseFullCmdLineSearch: boolean | undefined;
+    _isPidofAvailable: boolean | undefined;
+    _memoizedFeatures: (() => Promise<string>) | undefined;
+    _areExtendedLsOptionsSupported: boolean | undefined;
+    remoteAppsCache: LRUCache<string, string> | undefined;
+    _isLockManagementSupported: boolean | undefined;
     executable: ADBExecutable;
     constructor(opts?: Partial<ADBOptions>);
     /**

package/build/lib/adb.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adb.d.ts","sourceRoot":"","sources":["../../lib/adb.ts"],"names":[],"mappings":"AAEA,OAAgB,EAAC,oBAAoB,EAAC,MAAM,SAAS,CAAC;AACtD,OAAO,EAA2C,iBAAiB,EAAC,MAAM,WAAW,CAAC;AAEtF,OAAO,KAAK,EAAC,UAAU,EAAE,aAAa,EAAC,MAAM,WAAW,CAAC;AAEzD,QAAA,MAAM,gBAAgB,OAAO,CAAC;AAC9B,eAAO,MAAM,YAAY;;;;;;;;;;;;;;CAWf,CAAC;AAEX,qBAAa,GAAG;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,UAAU,EAAE,aAAa,CAAC;gBACd,IAAI,GAAE,OAAO,CAAC,UAAU,CAAM;IAmB1C;;;;;OAKG;IACH,KAAK,CAAC,IAAI,GAAE,OAAO,CAAC,UAAU,CAAM,GAAG,GAAG;WAiB7B,SAAS,CAAC,IAAI,EAAE,OAAO,CAAC,UAAU,CAAC;CAYjD;AAKD,OAAO,EAAC,gBAAgB,EAAE,oBAAoB,EAAE,iBAAiB,EAAC,CAAC"}
+{"version":3,"file":"adb.d.ts","sourceRoot":"","sources":["../../lib/adb.ts"],"names":[],"mappings":"AAEA,OAAgB,EAAC,oBAAoB,EAAC,MAAM,SAAS,CAAC;AACtD,OAAO,EAA2C,iBAAiB,EAAC,MAAM,WAAW,CAAC;AAEtF,OAAO,KAAK,EAAC,UAAU,EAAE,aAAa,EAAC,MAAM,WAAW,CAAC;AACzD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAE1C,QAAA,MAAM,gBAAgB,OAAO,CAAC;AAC9B,eAAO,MAAM,YAAY;;;;;;;;;;;;;;CAWf,CAAC;AAEX,qBAAa,GAAG;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,GAAC,SAAS,CAAC;IAC5B,oBAAoB,EAAE,UAAU,GAAC,SAAS,CAAC;IAC3C,qBAAqB,EAAE,OAAO,GAAC,SAAS,CAAC;IACzC,iBAAiB,EAAE,OAAO,GAAC,SAAS,CAAC;IACrC,6BAA6B,EAAE,OAAO,GAAC,SAAS,CAAC;IACjD,iBAAiB,EAAE,OAAO,GAAC,SAAS,CAAC;IACrC,iBAAiB,EAAE,CAAC,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC,GAAC,SAAS,CAAC;IACrD,8BAA8B,EAAE,OAAO,GAAC,SAAS,CAAC;IAClD,eAAe,EAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,GAAC,SAAS,CAAC;IACpD,0BAA0B,EAAE,OAAO,GAAC,SAAS,CAAC;IAE9C,UAAU,EAAE,aAAa,CAAC;gBACd,IAAI,GAAE,OAAO,CAAC,UAAU,CAAM;IAmB1C;;;;;OAKG;IACH,KAAK,CAAC,IAAI,GAAE,OAAO,CAAC,UAAU,CAAM,GAAG,GAAG;WAiB7B,SAAS,CAAC,IAAI,EAAE,OAAO,CAAC,UAAU,CAAC;CAYjD;AAKD,OAAO,EAAC,gBAAgB,EAAE,oBAAoB,EAAE,iBAAiB,EAAC,CAAC"}

package/build/lib/adb.js.map

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

package/build/lib/helpers.d.ts

@@ -12,33 +12,33 @@ export type PlatformInfo = {
 };
 export type InstallOptions = {
     /**
-     * [false] - Set to true in order to allow test
-     *           packages installation.
+     * - Set to true in order to allow test
+     *    packages installation.
      */
-    allowTestPackages: boolean;
+    allowTestPackages?: boolean | undefined;
     /**
-     * [false] - Set to true to install the app on sdcard
-     *           instead of the device memory.
+     * - Set to true to install the app on sdcard
+     *    instead of the device memory.
      */
-    useSdcard: boolean;
+    useSdcard?: boolean | undefined;
     /**
-     * [false] - Set to true in order to grant all the
-     *           permissions requested in the application's manifest
-     *           automatically after the installation is completed
-     *           under Android 6+.
+     * - Set to true in order to grant all the
+     *    permissions requested in the application's manifest
+     *    automatically after the installation is completed
+     *    under Android 6+.
      */
-    grantPermissions: boolean;
+    grantPermissions?: boolean | undefined;
     /**
-     * [true] - Set it to false if you don't want
-     *          the application to be upgraded/reinstalled
-     *          if it is already present on the device.
+     * - Set it to false if you don't want
+     *    the application to be upgraded/reinstalled
+     *    if it is already present on the device.
      */
-    replace: boolean;
+    replace?: boolean | undefined;
     /**
-     * [false] - Install apks partially. It is used for 'install-multiple'.
-     *          https://android.stackexchange.com/questions/111064/what-is-a-partial-application-install-via-adb
+     * - Install apks partially. It is used for 'install-multiple'.
+     *   https://android.stackexchange.com/questions/111064/what-is-a-partial-application-install-via-adb
      */
-    partialInstall: boolean;
+    partialInstall?: boolean | undefined;
 };
 export type ManifestInfo = {
     /**
@@ -48,7 +48,7 @@ export type ManifestInfo = {
     /**
      * - The name of the main package activity
      */
-    activity: string;
+    activity?: string | undefined;
     /**
      * - The version code number (might be `NaN`)
      */
@@ -60,20 +60,30 @@ export type ManifestInfo = {
 };
 /**
  * @typedef {Object} PlatformInfo
- * @property {?string} platform - The platform name, for example `android-24`
+ * @property {string?} platform - The platform name, for example `android-24`
  *                                or `null` if it cannot be found
- * @property {?string} platformPath - Full path to the platform SDK folder
+ * @property {string?} platformPath - Full path to the platform SDK folder
  *                                    or `null` if it cannot be found
  */
 /**
  * Retrieve the path to the recent installed Android platform.
  *
- * @return {PlatformInfo} The resulting path to the newest installed platform.
+ * @param {string} sdkRoot
+ * @return {Promise<PlatformInfo>} The resulting path to the newest installed platform.
  */
-export function getAndroidPlatformAndPath(sdkRoot: any): PlatformInfo;
-export function unzipFile(zipPath: any, dstRoot?: string): Promise<void>;
-export function getIMEListFromOutput(stdout: any): any[];
-export const getJavaForOs: (() => Promise<string>) & _.MemoizedFunction;
+export function getAndroidPlatformAndPath(sdkRoot: string): Promise<PlatformInfo>;
+/**
+ * @param {string} zipPath
+ * @param {string} dstRoot
+ */
+export function unzipFile(zipPath: string, dstRoot?: string): Promise<void>;
+/**
+ * @param {string} stdout
+ * @returns {string[]}
+ */
+export function getIMEListFromOutput(stdout: string): string[];
+/** @type {() => Promise<string>} */
+export const getJavaForOs: () => Promise<string>;
 /**
  * Checks mShowingLockscreen or mDreamingLockscreen in dumpsys output to determine
  * if lock screen is showing
@@ -98,17 +108,19 @@ export function isScreenOnFully(dumpsys: any): boolean;
  * Builds command line representation for the given
  * application startup options
  *
- * @param {StartAppOptions} startAppOptions - Application options mapping
+ * @param {Record<string, any>} startAppOptions - Application options mapping
  * @param {number} apiLevel - The actual OS API level
- * @returns {Array<String>} The actual command line array
+ * @returns {string[]} The actual command line array
  */
-export function buildStartCmd(startAppOptions: StartAppOptions, apiLevel: number): Array<string>;
-export const getJavaHome: (() => Promise<string>) & _.MemoizedFunction;
-export const getSdkToolsVersion: (() => Promise<{
+export function buildStartCmd(startAppOptions: Record<string, any>, apiLevel: number): string[];
+/** @type {() => Promise<string>} */
+export const getJavaHome: () => Promise<string>;
+/** @type {() => Promise<{major: number, minor: number, build: number}?>} */
+export const getSdkToolsVersion: () => Promise<{
     major: number;
     minor: number;
     build: number;
-} | undefined>) & _.MemoizedFunction;
+} | null>;
 /**
  * Get the absolute path to apksigner tool
  *
@@ -116,69 +128,68 @@ export const getSdkToolsVersion: (() => Promise<{
  * @returns {Promise<string>} An absolute path to apksigner tool.
  * @throws {Error} If the tool is not present on the local file system.
  */
-export function getApksignerForOs(sysHelpers: Object): Promise<string>;
+export function getApksignerForOs(sysHelpers: any): Promise<string>;
 /**
  * Retrieves full paths to all 'build-tools' subfolders under the particular
  * SDK root folder
  *
- * @param {string} sdkRoot - The full path to the Android SDK root folder
- * @returns {Array<string>} The full paths to the resulting folders sorted by
- * modification date (the newest comes first) or an empty list if no macthes were found
+ * @type {(sdkRoot: string) => Promise<string[]>}
  */
-export const getBuildToolsDirs: ((sdkRoot: any) => Promise<string[]>) & _.MemoizedFunction;
+export const getBuildToolsDirs: (sdkRoot: string) => Promise<string[]>;
 /**
  * Get the absolute path to apkanalyzer tool.
  * https://developer.android.com/studio/command-line/apkanalyzer.html
  *
  * @param {Object} sysHelpers - An instance containing systemCallMethods helper methods
- * @returns {string} An absolute path to apkanalyzer tool.
+ * @returns {Promise<string>} An absolute path to apkanalyzer tool.
  * @throws {Error} If the tool is not present on the local file system.
  */
-export function getApkanalyzerForOs(sysHelpers: Object): string;
-export function getOpenSslForOs(): Promise<string>;
+export function getApkanalyzerForOs(sysHelpers: any): Promise<string>;
+/** @type {() => Promise<string>} */
+export const getOpenSslForOs: () => Promise<string>;
 /**
  * Retrieves the list of permission names encoded in `dumpsys package` command output.
  *
  * @param {string} dumpsysOutput - The actual command output.
- * @param {Array<string>} groupNames - The list of group names to list permissions for.
- * @param {?boolean} grantedState - The expected state of `granted` attribute to filter with.
- *                                  No filtering is done if the parameter is not set.
- * @returns {Array<string>} The list of matched permission names or an empty list if no matches were found.
+ * @param {string[]} groupNames - The list of group names to list permissions for.
+ * @param {boolean?} [grantedState=null] - The expected state of `granted` attribute to filter with.
+ *  No filtering is done if the parameter is not set.
+ * @returns {string[]} The list of matched permission names or an empty list if no matches were found.
  */
-export function extractMatchingPermissions(dumpsysOutput: string, groupNames: Array<string>, grantedState?: boolean | null): Array<string>;
+export function extractMatchingPermissions(dumpsysOutput: string, groupNames: string[], grantedState?: boolean | null | undefined): string[];
 export const APKS_EXTENSION: ".apks";
 export const APK_INSTALL_TIMEOUT: 60000;
 export const APKS_INSTALL_TIMEOUT: number;
 /**
  * @typedef {Object} InstallOptions
- * @property {boolean} allowTestPackages [false] - Set to true in order to allow test
+ * @property {boolean} [allowTestPackages=false] - Set to true in order to allow test
  *                                                 packages installation.
- * @property {boolean} useSdcard [false] - Set to true to install the app on sdcard
+ * @property {boolean} [useSdcard=false] - Set to true to install the app on sdcard
  *                                         instead of the device memory.
- * @property {boolean} grantPermissions [false] - Set to true in order to grant all the
+ * @property {boolean} [grantPermissions=false] - Set to true in order to grant all the
  *                                                permissions requested in the application's manifest
  *                                                automatically after the installation is completed
  *                                                under Android 6+.
- * @property {boolean} replace [true] - Set it to false if you don't want
+ * @property {boolean} [replace=true] - Set it to false if you don't want
  *                                      the application to be upgraded/reinstalled
  *                                      if it is already present on the device.
- * @property {boolean} partialInstall [false] - Install apks partially. It is used for 'install-multiple'.
+ * @property {boolean} [partialInstall=false] - Install apks partially. It is used for 'install-multiple'.
  *                                             https://android.stackexchange.com/questions/111064/what-is-a-partial-application-install-via-adb
  */
 /**
  * Transforms given options into the list of `adb install.install-multiple` command arguments
  *
  * @param {number} apiLevel - The current API level
- * @param {?InstallOptions} options - The options mapping to transform
- * @returns {Array<String>} The array of arguments
+ * @param {InstallOptions} [options={}] - The options mapping to transform
+ * @returns {string[]} The array of arguments
  */
-export function buildInstallArgs(apiLevel: number, options?: InstallOptions | null): Array<string>;
+export function buildInstallArgs(apiLevel: number, options?: InstallOptions | undefined): string[];
 export const APK_EXTENSION: ".apk";
 export const DEFAULT_ADB_EXEC_TIMEOUT: 20000;
 /**
  * @typedef {Object} ManifestInfo
  * @property {string} pkg - The application identifier
- * @property {string} activity - The name of the main package activity
+ * @property {string} [activity] - The name of the main package activity
  * @property {?number} versionCode - The version code number (might be `NaN`)
  * @property {?string} versionName - The version name (might be `null`)
  */
@@ -186,11 +197,11 @@ export const DEFAULT_ADB_EXEC_TIMEOUT: 20000;
  * Perform parsing of the manifest object in order
  * to extract some vital values from it
  *
- * @param {object} manifest The manifest content formatted as JSON
+ * @param {Record<string, any>} manifest The manifest content formatted as JSON
  * See https://www.npmjs.com/package/adbkit-apkreader for detailed format description
  * @returns {ManifestInfo}
  */
-export function parseManifest(manifest: object): ManifestInfo;
+export function parseManifest(manifest: Record<string, any>): ManifestInfo;
 /**
  * Parses apk strings from aapt tool output
  *
@@ -201,7 +212,7 @@ export function parseManifest(manifest: object): ManifestInfo;
  * values are represented as arrays. If no config found for the
  * given marker then an empty mapping is returned.
  */
-export function parseAaptStrings(rawOutput: string, configMarker: string): Object;
+export function parseAaptStrings(rawOutput: string, configMarker: string): any;
 /**
  * Parses apk strings from aapt2 tool output
  *
@@ -212,18 +223,18 @@ export function parseAaptStrings(rawOutput: string, configMarker: string): Objec
  * values are represented as arrays. If no config found for the
  * given marker then an empty mapping is returned.
  */
-export function parseAapt2Strings(rawOutput: string, configMarker: string): Object;
+export function parseAapt2Strings(rawOutput: string, configMarker: string): any;
 /**
  * Formats the config marker, which is then passed to parse.. methods
  * to make it compatible with resource formats generated by aapt(2) tool
  *
  * @param {Function} configsGetter The function whose result is a list
  * of apk configs
- * @param {string} desiredMarker The desired config marker value
+ * @param {string?} desiredMarker The desired config marker value
  * @param {string} defaultMarker The default config marker value
- * @return {string} The formatted config marker
+ * @return {Promise<string>} The formatted config marker
  */
-export function formatConfigMarker(configsGetter: Function, desiredMarker: string, defaultMarker: string): string;
+export function formatConfigMarker(configsGetter: Function, desiredMarker: string | null, defaultMarker: string): Promise<string>;
 /**
  * Parses the output in JSON format retrieved from
  * the corresponding Appium Settings broadcast calls
@@ -235,18 +246,18 @@ export function formatConfigMarker(configsGetter: Function, desiredMarker: strin
  * @throws {Error} If the output cannot be parsed
  * as a valid JSON
  */
-export function parseJsonData(output: string, entityName: string): Object;
+export function parseJsonData(output: string, entityName: string): any;
 /**
  * Unsigns the given apk by removing the
  * META-INF folder recursively from the archive.
  * !!! The function overwrites the given apk after successful unsigning !!!
  *
  * @param {string} apkPath The path to the apk
- * @returns {boolean} `true` if the apk has been successfully
+ * @returns {Promise<boolean>} `true` if the apk has been successfully
  * unsigned and overwritten
  * @throws {Error} if there was an error during the unsign operation
  */
-export function unsignApk(apkPath: string): boolean;
+export function unsignApk(apkPath: string): Promise<boolean>;
 /**
  * Transforms the given language and country abbreviations
  * to AVD arguments array
@@ -275,16 +286,16 @@ export function getSdkRootFromEnv(): string | undefined;
 /**
  * Retrieves the full path to the Android preferences root
  *
- * @returns {?string} The full path to the folder or `null` if the folder cannot be found
+ * @returns {Promise<string?>} The full path to the folder or `null` if the folder cannot be found
  */
-export function getAndroidPrefsRoot(): string | null;
+export function getAndroidPrefsRoot(): Promise<string | null>;
 /**
  * Check if a path exists on the filesystem and is a directory
  *
- * @param {?string} location The full path to the directory
- * @returns {boolean}
+ * @param {string} location The full path to the directory
+ * @returns {Promise<boolean>}
  */
-export function dirExists(location: string | null): boolean;
+export function dirExists(location: string): Promise<boolean>;
 /**
  * Escapes special characters in command line arguments.
  * This is needed to avoid possible issues with how system `spawn`
@@ -314,10 +325,10 @@ export function parseLaunchableActivityNames(dumpsys: string): string[];
  * Check if the given string is a valid component name
  *
  * @param {string} classString The string to verify
- * @return {?Array<Match>} The result of Regexp.exec operation
+ * @return {RegExpExecArray?} The result of Regexp.exec operation
  * or _null_ if no matches are found
  */
-export function matchComponentName(classString: string): Array<Match> | null;
+export function matchComponentName(classString: string): RegExpExecArray | null;
 /**
  * Calculates the absolsute path to the given resource
  *

package/build/lib/helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../lib/helpers.js"],"names":[],"mappings":";;;;;cAgGe,MAAM;;;;;kBAEN,MAAM;;;;;;;uBA2aP,OAAO;;;;;eAEP,OAAO;;;;;;;sBAEP,OAAO;;;;;;aAIP,OAAO;;;;;oBAGP,OAAO;;;;;;SA0CP,MAAM;;;;cACN,MAAM;;;;iBACL,MAAM;;;;iBACN,MAAM;;AAverB;;;;;;GAMG;AAEH;;;;GAIG;AACH,yDAFY,YAAY,CAmCvB;AAED,yEAKC;AAwCD,yDASC;AAiBD,wEAoBG;AAkCH;;;;;;;;;;;;;;;GAeG;AACH,6CAHW,MAAM,GACL,OAAO,CAMlB;AAKD,gEAGC;AAKD,mEAGC;AAMD,uDAIC;AAED;;;;;;;GAOG;AACH,0EAHW,MAAM,GACJ,aAAa,CAuFzB;AAlND,uEAaG;AAuMH;;;;qCAqBG;AA3LH;;;;;;GAMG;AACH,8CAJW,MAAM,GACJ,QAAQ,MAAM,CAAC,CAK3B;AAoLD;;;;;;;GAOG;AACH,2FAwBG;AAlNH;;;;;;;GAOG;AACH,gDAJW,MAAM,GACJ,MAAM,CAKlB;AA9BD,mDAOC;AAiOD;;;;;;;;GAQG;AACH,0DANW,MAAM,cACN,MAAM,MAAM,CAAC,iBACZ,OAAO,UAEN,MAAM,MAAM,CAAC,CA+CzB;AAjgBD,qCAA+B;AAE/B,wCAAkC;AAClC,0CAAqD;AAggBrD;;;;;;;;;;;;;;;GAeG;AAEH;;;;;;GAMG;AACH,2CAJW,MAAM,YACL,cAAc,UACb,aAAa,CA6BzB;AArjBD,mCAA6B;AAG7B,6CAAuC;AAojBvC;;;;;;GAMG;AAEH;;;;;;;GAOG;AACH,wCAJW,MAAM,GAEJ,YAAY,CAqCxB;AAED;;;;;;;;;GASG;AACH,4CAPW,MAAM,gBACN,MAAM,GAEJ,MAAM,CAwElB;AAED;;;;;;;;;GASG;AACH,6CAPW,MAAM,gBACN,MAAM,GAEJ,MAAM,CA4GlB;AAED;;;;;;;;;GASG;AACH,2EAJW,MAAM,iBACN,MAAM,GACL,MAAM,CAmBjB;AAED;;;;;;;;;;GAUG;AACH,sCAPW,MAAM,cACN,MAAM,GAEJ,MAAM,CA8BlB;AAtuBD;;;;;;;;;GASG;AACH,mCALW,MAAM,GACJ,OAAO,CA8BnB;AAosBD;;;;;;;;GAQG;AACH,0CALY,MAAM,kBACN,MAAM,UACL,MAAM,MAAM,CAAC,CAuBzB;AAr1BD;;;;;;;GAOG;AACH,wEAJY,QAAQ,MAAM,CAAC,CAmB1B;AAhCD;;;;GAIG;AACH,qCAFY,MAAM,GAAC,SAAS,CAI3B;AAy1BD;;;;GAIG;AACH,uCAFc,MAAM,QAuBnB;AAED;;;;;GAKG;AACH,oCAHY,MAAM,UACL,OAAO,CAMnB;AAED;;;;;;;;;GASG;AACH,oCAHW,MAAM,UAShB;AAED;;;;;;;;;;;;GAYG;AACH,sDATW,MAAM,GACJ,MAAM,EAAE,CA4EpB;AAED;;;;;;GAMG;AACH,gDAJW,MAAM,GACJ,YAAY,QAMxB;AAxgCD;;;;;;GAMG;AACH,uFAQG;cAvDW,QAAQ"}
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../lib/helpers.js"],"names":[],"mappings":";;;;;cAgGc,MAAM;;;;;kBAEN,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;SA+eN,MAAM;;;;;;;;iBAEL,MAAM;;;;iBACN,MAAM;;AAtfrB;;;;;;GAMG;AAEH;;;;;GAKG;AACH,mDAHW,MAAM,GACL,QAAQ,YAAY,CAAC,CAoChC;AAED;;;GAGG;AACH,mCAHW,MAAM,YACN,MAAM,iBAOhB;AAwCD;;;GAGG;AACH,6CAHW,MAAM,GACJ,MAAM,EAAE,CAWpB;AAkBD,oCAAoC;AACpC,2BADW,MAAM,QAAQ,MAAM,CAAC,CAqB7B;AAmCH;;;;;;;;;;;;;;;GAeG;AACH,6CAHW,MAAM,GACL,OAAO,CAMlB;AAKD,gEAGC;AAKD,mEAGC;AAMD,uDAIC;AAED;;;;;;;GAOG;AACH,+CAJW,OAAO,MAAM,EAAE,GAAG,CAAC,YACnB,MAAM,GACJ,MAAM,EAAE,CAuFpB;AArND,oCAAoC;AACpC,0BADW,MAAM,QAAQ,MAAM,CAAC,CAc7B;AAyMH,4EAA4E;AAC5E,iCADW,MAAM,QAAQ;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAC,QAAE,CAuBrE;AA7LH;;;;;;GAMG;AACH,oDAHa,QAAQ,MAAM,CAAC,CAK3B;AAsLD;;;;;GAKG;AACH,0CAFoB,MAAM,KAAK,QAAQ,MAAM,EAAE,CAAC,CA4B7C;AApNH;;;;;;;GAOG;AACH,sDAHa,QAAQ,MAAM,CAAC,CAK3B;AA/BD,oCAAoC;AACpC,8BADW,MAAM,QAAQ,MAAM,CAAC,CAQ9B;AAmOF;;;;;;;;GAQG;AACH,0DANW,MAAM,cACN,MAAM,EAAE,8CAGN,MAAM,EAAE,CA+CpB;AAhhBD,qCAA+B;AAE/B,wCAAkC;AAClC,0CAAqD;AA+gBrD;;;;;;;;;;;;;;;GAeG;AAEH;;;;;;GAMG;AACH,2CAJW,MAAM,yCAEJ,MAAM,EAAE,CA6BpB;AApkBD,mCAA6B;AAG7B,6CAAuC;AAmkBvC;;;;;;GAMG;AAEH;;;;;;;GAOG;AACH,wCAJW,OAAO,MAAM,EAAE,GAAG,CAAC,GAEjB,YAAY,CAqCxB;AAED;;;;;;;;;GASG;AACH,4CAPW,MAAM,gBACN,MAAM,OA0EhB;AAED;;;;;;;;;GASG;AACH,6CAPW,MAAM,gBACN,MAAM,OA8GhB;AAED;;;;;;;;;GASG;AACH,2EAJW,MAAM,wBACN,MAAM,GACL,QAAQ,MAAM,CAAC,CAmB1B;AAED;;;;;;;;;;GAUG;AACH,sCAPW,MAAM,cACN,MAAM,OAgChB;AA/uBD;;;;;;;;;GASG;AACH,mCALW,MAAM,GACJ,QAAQ,OAAO,CAAC,CA8B5B;AA6sBD;;;;;;;;GAQG;AACH,0CALY,MAAM,kBACN,MAAM,UACL,MAAM,MAAM,CAAC,CAuBzB;AAp2BD;;;;;;;GAOG;AACH,wEAJY,QAAQ,MAAM,CAAC,CAmB1B;AAhCD;;;;GAIG;AACH,qCAFY,MAAM,GAAC,SAAS,CAI3B;AAw2BD;;;;GAIG;AACH,uCAFa,QAAQ,MAAM,QAAE,CAuB5B;AAED;;;;;GAKG;AACH,oCAHW,MAAM,GACJ,QAAQ,OAAO,CAAC,CAI5B;AAED;;;;;;;;;GASG;AACH,oCAHW,MAAM,UAShB;AAED;;;;;;;;;;;;GAYG;AACH,sDATW,MAAM,GACJ,MAAM,EAAE,CA4EpB;AAED;;;;;;GAMG;AACH,gDAJW,MAAM,GACL,eAAe,QAM1B;AArhCD;;;;;;GAMG;AACH,uFAQG;cAvDW,QAAQ"}