nativescript 9.0.0-alpha.1 → 9.0.0-alpha.3

package/lib/common/commands/proxy/proxy-base.js

@@ -12,7 +12,10 @@ class ProxyCommandBase {
     }
     async tryTrackUsage() {
         try {
+            // TODO(Analytics): Check why we have set the `disableAnalytics` to true and we track the command as separate one
+            // instead of tracking it through the commandsService.
             this.$logger.trace(this.commandName);
+            // await this.$analyticsService.trackFeature(this.commandName);
         }
         catch (ex) {
             this.$logger.trace("Error in trying to track proxy command usage:");
@@ -21,3 +24,4 @@ class ProxyCommandBase {
     }
 }
 exports.ProxyCommandBase = ProxyCommandBase;
+//# sourceMappingURL=proxy-base.js.map

package/lib/common/commands/proxy/proxy-clear.js

@@ -19,3 +19,4 @@ class ProxyClearCommand extends proxy_base_1.ProxyCommandBase {
 }
 exports.ProxyClearCommand = ProxyClearCommand;
 yok_1.injector.registerCommand(proxyClearCommandName, ProxyClearCommand);
+//# sourceMappingURL=proxy-clear.js.map

package/lib/common/commands/proxy/proxy-get.js

@@ -18,3 +18,4 @@ class ProxyGetCommand extends proxy_base_1.ProxyCommandBase {
 }
 exports.ProxyGetCommand = ProxyGetCommand;
 yok_1.injector.registerCommand(proxyGetCommandName, ProxyGetCommand);
+//# sourceMappingURL=proxy-get.js.map

package/lib/common/commands/proxy/proxy-set.js

@@ -135,3 +135,4 @@ class ProxySetCommand extends proxy_base_1.ProxyCommandBase {
 }
 exports.ProxySetCommand = ProxySetCommand;
 yok_1.injector.registerCommand(proxySetCommandName, ProxySetCommand);
+//# sourceMappingURL=proxy-set.js.map

package/lib/common/common-lib.js

@@ -3,3 +3,4 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const yok_1 = require("./yok");
 require("./appbuilder/proton-bootstrap");
 module.exports = yok_1.injector.publicApi;
+//# sourceMappingURL=common-lib.js.map

package/lib/common/constants.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SOCKET_CONNECTION_TIMEOUT_MS = exports.AndroidVirtualDevice = exports.ATTACH_REQUEST_EVENT_NAME = exports.DEBUGGER_PORT_FOUND_EVENT_NAME = exports.DEFAULT_CHUNK_SIZE = exports.HttpProtocolToPort = exports.HttpStatusCodes = exports.Proxy = exports.IOS_RELAY_NOTIFICATION_COMMAND_TYPE = exports.IOS_OBSERVE_NOTIFICATION_COMMAND_TYPE = exports.IOS_POST_NOTIFICATION_COMMAND_TYPE = exports.FileExtensions = exports.TNS_CORE_MODULES = exports.NODE_MODULES_DIR_NAME = exports.Configurations = exports.TARGET_FRAMEWORK_IDENTIFIERS = exports.FAIL_LIVESYNC_LOG_REGEX = exports.IOS_APP_CRASH_LOG_REG_EXP = exports.IOS_LOG_PREDICATE = exports.DEVICE_LOG_EVENT_NAME = exports.EmulatorDiscoveryNames = exports.DeviceDiscoveryEventNames = exports.HmrConstants = exports.LiveSyncPaths = exports.APPLE_VENDOR_NAME = exports.NOT_RUNNING_EMULATOR_STATUS = exports.RUNNING_EMULATOR_STATUS = exports.CONNECTED_STATUS = exports.UNREACHABLE_STATUS = exports.ERROR_NO_VALID_SUBCOMMAND_FORMAT = exports.ERROR_CANNOT_RESOLVE_DEVICE = exports.ERROR_NO_DEVICES_CANT_USE_IOS_SIMULATOR = exports.ERROR_CANT_USE_SIMULATOR = exports.ERROR_NO_DEVICES = exports.APP_RESOURCES_FOLDER_NAME = exports.DeviceTypes = exports.ProvisionType = void 0;
+// enumeration taken from ProvisionType.cs
 class ProvisionType {
 }
 exports.ProvisionType = ProvisionType;
@@ -82,6 +83,9 @@ Proxy.CACHE_FILE_NAME = "proxy-cache.json";
 Proxy.USE_PROXY = "USE_PROXY";
 Proxy.PROXY_PORT = "PROXY_PORT";
 Proxy.PROXY_HOSTNAME = "PROXY_HOSTNAME";
+/**
+ * Http status codes available from `require("http").STATUS_CODES`.
+ */
 class HttpStatusCodes {
 }
 exports.HttpStatusCodes = HttpStatusCodes;
@@ -107,7 +111,13 @@ AndroidVirtualDevice.INI_FILES_MASK = /^(.*)\.ini$/i;
 AndroidVirtualDevice.AVD_FILES_MASK = /^(.*)\.avd$/i;
 AndroidVirtualDevice.MIN_ANDROID_APILEVEL = 17;
 AndroidVirtualDevice.MIN_ANDROID_VERSION = "4.2";
+/**
+ * The message that is printed from `avdmanager list avds`
+ */
 AndroidVirtualDevice.AVAILABLE_AVDS_MESSAGE = "Available Android Virtual Devices:";
+/**
+ * The delimiter between devices that is used from `avdmanager list avds`
+ */
 AndroidVirtualDevice.AVD_LIST_DELIMITER = "---------";
 AndroidVirtualDevice.CONFIG_INI_FILE_NAME = "config.ini";
 AndroidVirtualDevice.INI_FILE_EXTENSION = ".ini";
@@ -120,3 +130,4 @@ AndroidVirtualDevice.TIMEOUT_SECONDS = 120;
 AndroidVirtualDevice.GENYMOTION_DEFAULT_STDERR_STRING = "Logging activities to file";
 AndroidVirtualDevice.UNABLE_TO_START_EMULATOR_MESSAGE = "Cannot run the app in the selected native emulator. Try to restart the adb server by running the `adb kill-server` command in the Command Prompt, or increase the allocated RAM of the virtual device through the Android Virtual Device manager. NativeScript CLI users can try to increase the timeout of the operation by adding the `--timeout` flag.";
 exports.SOCKET_CONNECTION_TIMEOUT_MS = 30000;
+//# sourceMappingURL=constants.js.map

package/lib/common/decorators.js

@@ -9,6 +9,32 @@ exports.performanceLog = performanceLog;
 exports.deprecated = deprecated;
 const constants_1 = require("../constants");
 const yok_1 = require("./yok");
+/**
+ * Caches the result of the first execution of the method and returns it whenever it is called instead of executing it again.
+ * Works with methods and getters.
+ * @example
+ * ```
+ * class CacheDecoratorsTest {
+ *
+ * 	@cache()
+ * 	public method(num: number): number {
+ * 		return num;
+ * 	}
+ *
+ * 	@cache()
+ * 	public get property(): any {
+ * 		// execute some heavy operation.
+ * 		return result;
+ * 	}
+ * }
+ *
+ * const instance = new CacheDecoratorsTest();
+ * const result = instance.method(1); // returns 1;
+ *
+ * // all consecutive calls to instance.method will return 1.
+ * const result2 = instance.method(2); // returns 1;
+ * ```
+ */
 function cache() {
     return (target, propertyKey, descriptor) => {
         let result;
@@ -28,6 +54,7 @@ function cache() {
 let memoizeIDCounter = 0;
 function memoize(options) {
     return (target, propertyKey, descriptor) => {
+        // todo: remove once surely working as intended.
         const DEBUG = false;
         const memoizeID = memoizeIDCounter++;
         const valueOrGet = descriptor.value ? "value" : "get";
@@ -48,6 +75,7 @@ function memoize(options) {
                     cacheMapName,
                     hashKey,
                 });
+            // initialize cache map if not exists
             if (!this.hasOwnProperty(cacheMapName)) {
                 DEBUG && console.log("NO CACHE MAP YET, CREATING ONE NOW");
                 Object.defineProperty(this, cacheMapName, {
@@ -62,12 +90,16 @@ function memoize(options) {
                 console.log({
                     cacheMap,
                 });
+            // check if has memoized value based on hashFn
             if (cacheMap.has(hashKey)) {
                 DEBUG && console.log("CACHE HIT");
+                // if yes, return cached value
                 return cacheMap.get(hashKey);
             }
             DEBUG && console.log("CACHE MISS");
+            // if not call original and get result
             const result = originalMethod.apply(this, args);
+            // call shouldCache (if passed) with the result or default to true
             let shouldCache = true;
             if (options.shouldCache) {
                 shouldCache = options.shouldCache.call(this, result);
@@ -77,12 +109,21 @@ function memoize(options) {
                 DEBUG && console.log("CACHING NOW");
                 cacheMap.set(hashKey, result);
             }
+            // if shouldCache: save result
             DEBUG && console.log("RETURNING", result);
             return result;
         };
         return descriptor;
     };
 }
+/**
+ * Calls specific method of the instance before executing the decorated method.
+ * This is usable when some of your methods depend on initialize async method, that cannot be invoked in constructor of the class.
+ * IMPORTANT: The decorated method must be async.
+ * @param {string} methodName The name of the method that will be invoked before calling the decorated method.
+ * @param {any[]} methodArgs Args that will be passed to the method that will be invoked before calling the decorated one.
+ * @return {any} Result of the decorated method.
+ */
 function invokeBefore(methodName, methodArgs) {
     return (target, propertyKey, descriptor) => {
         const originalValue = descriptor.value;
@@ -114,6 +155,7 @@ function performanceLog(localInjector) {
         const className = target.constructor.name;
         const trackName = `${className}${constants_1.AnalyticsEventLabelDelimiter}${propertyKey}`;
         const performanceService = localInjector.resolve("performanceService");
+        //needed for the returned function to have the same name as the original - used in hooks decorator
         const functionWrapper = {
             [originalMethod.name]: function (...args) {
                 const start = performanceService.now();
@@ -139,12 +181,14 @@ function performanceLog(localInjector) {
             },
         };
         descriptor.value = functionWrapper[originalMethod.name];
+        // used to get parameter names in hooks decorator
         descriptor.value.toString = () => {
             return originalMethod.toString();
         };
         return descriptor;
     };
 }
+// inspired by https://github.com/NativeScript/NativeScript/blob/55dfe25938569edbec89255008e5ad9804901305/tns-core-modules/globals/globals.ts#L121-L137
 function deprecated(additionalInfo, localInjector) {
     const isDeprecatedMessage = " is deprecated.";
     return (target, key, descriptor) => {
@@ -153,6 +197,7 @@ function deprecated(additionalInfo, localInjector) {
         const $logger = localInjector.resolve("logger");
         if (descriptor) {
             if (descriptor.value) {
+                // method
                 const originalMethod = descriptor.value;
                 descriptor.value = function (...args) {
                     $logger.warn(`${key.toString()}${isDeprecatedMessage} ${additionalInfo}`);
@@ -161,6 +206,7 @@ function deprecated(additionalInfo, localInjector) {
                 return descriptor;
             }
             else {
+                // property
                 if (descriptor.set) {
                     const originalSetter = descriptor.set;
                     descriptor.set = function (...args) {
@@ -179,6 +225,7 @@ function deprecated(additionalInfo, localInjector) {
             }
         }
         else {
+            // class
             $logger.warn(`${(target &&
                 (target.name ||
                     (target.constructor && target.constructor.name))) ||
@@ -187,3 +234,4 @@ function deprecated(additionalInfo, localInjector) {
         }
     };
 }
+//# sourceMappingURL=decorators.js.map

package/lib/common/dispatchers.js

@@ -15,7 +15,9 @@ const yok_1 = require("./yok");
 const constants_1 = require("../constants");
 const semver = require("semver");
 class CommandDispatcher {
-    constructor($logger, $injector, $cancellation, $commandsService, $staticConfig, $sysInfo, $options, $versionsService, $packageManager, $terminalSpinnerService) {
+    constructor($logger, 
+    // required by the hooksService
+    $injector, $cancellation, $commandsService, $staticConfig, $sysInfo, $options, $versionsService, $packageManager, $terminalSpinnerService) {
         this.$logger = $logger;
         this.$injector = $injector;
         this.$cancellation = $cancellation;
@@ -32,6 +34,7 @@ class CommandDispatcher {
             return this.printVersion();
         }
         if (this.$logger.getLevel() === "TRACE" && !this.$options.json) {
+            // CommandDispatcher is called from external CLI's only, so pass the path to their package.json
             this.$logger.trace("Collecting system information...");
             const sysInfo = await this.$sysInfo.getSysInfo({
                 pathToNativeScriptCliPackageJson: path.join(__dirname, "..", "..", "package.json"),
@@ -61,6 +64,7 @@ class CommandDispatcher {
         await this.$commandsService.tryExecuteCommand(commandName, commandArguments);
     }
     async resolveCommand(commandName, commandArguments, argv) {
+        // just a hook point
         return { commandName, commandArguments, argv };
     }
     getCommandName() {
@@ -68,12 +72,15 @@ class CommandDispatcher {
         if (remaining.length > 0) {
             return remaining[0].toString().toLowerCase();
         }
+        // if only <CLI_NAME> is specified on console, show console help
         this.$options.help = true;
         return "";
     }
     async printVersion() {
         this.$logger.info(this.$staticConfig.version);
         if (this.$options.json) {
+            // we don't check for updates when --json is passed
+            // useful for tools that rely on the output of the command
             return;
         }
         const spinner = this.$terminalSpinnerService.createSpinner();
@@ -101,6 +108,7 @@ class CommandDispatcher {
         if (semver.gte(nativescriptCliVersion.currentVersion, nativescriptCliVersion.latestVersion, {
             loose: true,
         })) {
+            // up-to-date
             spinner.succeed("Up to date.");
         }
         else {
@@ -132,3 +140,4 @@ class FutureDispatcher {
     }
 }
 yok_1.injector.register("dispatcher", FutureDispatcher, false);
+//# sourceMappingURL=dispatchers.js.map

package/lib/common/errors.js

@@ -15,7 +15,9 @@ const source_map_1 = require("source-map");
 const helpers_1 = require("./helpers");
 const decorators_1 = require("./decorators");
 const yok_1 = require("./yok");
+// we need this to overwrite .stack property (read-only in Error)
 function Exception() {
+    /* intentionally left blank */
 }
 Exception.prototype = new Error();
 async function resolveCallStack(error) {
@@ -60,6 +62,7 @@ async function resolveCallStack(error) {
     }));
     let outputMessage = remapped.join("\n");
     if (outputMessage.indexOf(error.message) === -1) {
+        // when fibers throw error in node 0.12.x, the stack does NOT contain the message
         outputMessage = outputMessage.replace(/Error/, "Error: " + error.message);
     }
     return outputMessage;
@@ -83,7 +86,9 @@ function installUncaughtExceptionListener(actionOnException) {
             }
         }
         catch (err) {
-            process.exit(131);
+            // In case the handler throws error and we do not catch it, we'll go in infinite loop of unhandled rejections.
+            // We cannot do anything here as even `console.error` may fail. So just exit the process.
+            process.exit(131 /* ErrorCodes.UNHANDLED_REJECTION_FAILURE */);
         }
     };
     process.on("uncaughtException", handler);
@@ -95,6 +100,7 @@ async function tryTrackException(error, localInjector) {
         disableAnalytics = localInjector.resolve("staticConfig").disableAnalytics;
     }
     catch (err) {
+        // We should get here only in our unit tests.
         disableAnalytics = true;
     }
     if (!disableAnalytics) {
@@ -103,6 +109,7 @@ async function tryTrackException(error, localInjector) {
             await analyticsService.trackException(error, error.message);
         }
         catch (e) {
+            // Do not replace with logger due to cyclic dependency
             console.error("Error while reporting exception: " + e);
         }
     }
@@ -140,9 +147,10 @@ class Errors {
             exception.message = $messagesService.getMessage.apply($messagesService, [opts.formatStr].concat(argsArray));
         }
         catch (err) {
+            // Ignore
         }
         exception.stack = new Error(exception.message).stack;
-        exception.errorCode = opts.errorCode || 127;
+        exception.errorCode = opts.errorCode || 127 /* ErrorCodes.UNKNOWN */;
         exception.suggestCommandHelp = suggestCommandHelp;
         exception.proxyAuthenticationRequired = !!opts.proxyAuthenticationRequired;
         exception.printOnStdout = opts.printOnStdout;
@@ -174,9 +182,10 @@ class Errors {
                 await printCommandHelpSuggestion();
             }
             await tryTrackException(ex, this.$injector);
-            process.exit(_.isNumber(ex.errorCode) ? ex.errorCode : 127);
+            process.exit(_.isNumber(ex.errorCode) ? ex.errorCode : 127 /* ErrorCodes.UNKNOWN */);
         }
     }
+    // If you want to activate this function, start Node with flags --nouse_idle_notification and --expose_gc
     verifyHeap(message) {
         if (global.gc) {
             console.log("verifyHeap: '%s'", message);
@@ -189,3 +198,4 @@ __decorate([
     (0, decorators_1.deprecated)("Use `fail` instead.")
 ], Errors.prototype, "failWithoutHelp", null);
 yok_1.injector.register("errors", Errors);
+//# sourceMappingURL=errors.js.map

package/lib/common/file-system.js

@@ -20,12 +20,14 @@ const constants_1 = require("../constants");
 const os_1 = require("os");
 const detectNewline = require("detect-newline");
 const archiver_1 = require("archiver");
+// TODO: Add .d.ts for mkdirp module (or use it from @types repo).
 const mkdirp = require("mkdirp");
 let FileSystem = FileSystem_1 = class FileSystem {
     constructor($injector) {
         this.$injector = $injector;
     }
     async zipFiles(zipFile, files, zipPathCallback) {
+        //we are resolving it here instead of in the constructor, because config has dependency on file system and config shouldn't require logger
         const $logger = this.$injector.resolve("logger");
         const zip = (0, archiver_1.create)("zip", {
             zlib: {
@@ -62,10 +64,10 @@ let FileSystem = FileSystem_1 = class FileSystem {
             proc = (0, path_1.join)(__dirname, "resources/platform-tools/unzip/win32/unzip");
         }
         else if ($hostInfo.isDarwin) {
-            proc = "unzip";
+            proc = "unzip"; // darwin unzip is info-zip
         }
         else if ($hostInfo.isLinux) {
-            proc = "unzip";
+            proc = "unzip"; // linux unzip is info-zip
         }
         if (!isCaseSensitive) {
             zipFile = this.findFileCaseInsensitive(zipFile);
@@ -106,6 +108,7 @@ let FileSystem = FileSystem_1 = class FileSystem {
         }
         catch (err) {
             if (err && err.code !== "ENOENT") {
+                // ignore "file doesn't exist" error
                 throw err;
             }
         }
@@ -144,6 +147,7 @@ let FileSystem = FileSystem_1 = class FileSystem {
                 }
             });
             if (root) {
+                // console.log("root", paths);
                 return Array.from(paths.values()).reduce((sum, current) => sum + current, 0);
             }
         };
@@ -216,6 +220,8 @@ let FileSystem = FileSystem_1 = class FileSystem {
     writeFile(filename, data, encoding) {
         this.createDirectory((0, path_1.dirname)(filename));
         if (!data) {
+            // node 14 will no longer coerce unsupported input to strings anymore.
+            // clean any null or undefined data
             data = "";
         }
         fs.writeFileSync(filename, data, { encoding: encoding });
@@ -246,6 +252,8 @@ let FileSystem = FileSystem_1 = class FileSystem {
             return;
         }
         this.createDirectory((0, path_1.dirname)(destinationFileName));
+        // MobileApplication.app is resolved as a directory on Mac,
+        // therefore we need to copy it recursively as it's not a single file.
         shelljs.cp("-rf", sourceFileName, destinationFileName);
         const err = shelljs.error();
         if (err) {
@@ -321,7 +329,9 @@ let FileSystem = FileSystem_1 = class FileSystem {
             });
             await this.futureFromEvent(chown, "close");
         }
+        // nothing to do on Windows, as chown does not work on this platform
     }
+    // filterCallback: function(path: String, stat: fs.Stats): Boolean
     enumerateFilesInDirectorySync(directoryPath, filterCallback, opts, foundFiles) {
         foundFiles = foundFiles || [];
         if (!this.exists(directoryPath)) {
@@ -417,3 +427,4 @@ FileSystem.JSON_OBJECT_REGEXP = new RegExp(`{\\r*\\n*(\\W*)"`, "m");
 exports.FileSystem = FileSystem = FileSystem_1 = __decorate([
     injector.register("fs")
 ], FileSystem);
+//# sourceMappingURL=file-system.js.map

package/lib/common/header.js

@@ -13,11 +13,13 @@ function printHeader() {
         color_1.color.cyanBright.bold("{N} NativeScript "),
         color_1.color.whiteBright.bold("CLI"),
         color_1.color.dim(` [v${version}] `),
+        // color.dim("  │"),
     ].join("");
     const tagLine = [
         color_1.color.dim("│ "),
         color_1.color.dim(" → "),
         color_1.color.whiteBright.bold("Empower JavaScript with native APIs "),
+        // color.dim("  │"),
     ].join("");
     const headerLength = (0, color_1.stripColors)(header).length;
     const tagLineLength = (0, color_1.stripColors)(tagLine).length;
@@ -27,3 +29,4 @@ function printHeader() {
     console.info("  " + tagLine + " ".repeat(width - tagLineLength) + color_1.color.dim("│"));
     console.info("  " + color_1.color.dim("└" + "─".repeat(width - 1) + "┘"));
 }
+//# sourceMappingURL=header.js.map

package/lib/common/helpers.js

@@ -71,6 +71,13 @@ function doesCurrentNpmCommandMatch(patterns) {
     }
     return result;
 }
+/**
+ * Equivalent of lodash's some, but instead of lambda, just pass array of Regular Expressions.
+ * If any of them matches any of the given elements, true is returned.
+ * @param {string[]} array Elements to be checked.
+ * @param {RegExp[]} patterns Regular expressions to be tested
+ * @returns {boolean} True in case any element of the array matches any of the patterns. False otherwise.
+ */
 function someWithRegExps(array, patterns) {
     return _.some(array, (item) => _.some(patterns, (pattern) => !!item.match(pattern)));
 }
@@ -82,6 +89,7 @@ function getCurrentNpmCommandArgv() {
             result = npmConfigArgv.original || [];
         }
         catch (error) {
+            // ignore
         }
     }
     return result;
@@ -100,6 +108,7 @@ function isInstallingNativeScriptGloballyWithNpm() {
     return isInstallCommand && isGlobalCommand && hasNativeScriptPackage;
 }
 function isInstallingNativeScriptGloballyWithYarn() {
+    // yarn populates the same env used by npm - npm_config_argv, so check it for yarn specific command
     const isInstallCommand = doesCurrentNpmCommandMatch([/^add$/]);
     const isGlobalCommand = doesCurrentNpmCommandMatch([/^global$/]);
     const hasNativeScriptPackage = doesCurrentNpmCommandMatch([
@@ -108,6 +117,13 @@ function isInstallingNativeScriptGloballyWithYarn() {
     ]);
     return isInstallCommand && isGlobalCommand && hasNativeScriptPackage;
 }
+/**
+ * Creates regular expression from input string.
+ * The method replaces all occurences of RegExp special symbols in the input string with \<symbol>.
+ * @param {string} input The string from which a regular expression should be created.
+ * @param {string} opts RegExp options, for example "gm" - global and multiline.
+ * @returns {RegExp} The regular expression created from the input string.
+ */
 function createRegExp(input, opts) {
     if (!input || !_.isString(input)) {
         throw new Error("Input must be a string.");
@@ -115,13 +131,20 @@ function createRegExp(input, opts) {
     const escapedSource = regExpEscape(input);
     return new RegExp(escapedSource, opts);
 }
+/**
+ * Escapes all special symbols used in regex.
+ * @param {string} input The string in which to replace the special regexp symbols.
+ * @returns {string} A string in which all regex symbols are escaped.
+ */
 function regExpEscape(input) {
+    // https://stackoverflow.com/questions/3446170/escape-string-for-use-in-javascript-regex
     return input.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
 function getShortPluginName(pluginName) {
     return sanitizePluginName(pluginName).replace(/[\-]/g, "_");
 }
 function sanitizePluginName(pluginName) {
+    // avoid long plugin names, exclude the npm module scope (@scope/nativescript-plugin) from the android plugin name
     return pluginName.split("/").pop();
 }
 async function executeActionByChunks(initialData, chunkSize, elementAction) {
@@ -168,6 +191,13 @@ function deferPromise() {
         getResult: () => result,
     };
 }
+/**
+ * Executes all promises and does not stop in case any of them throws.
+ * Returns the results of all promises in array when all are successfully resolved.
+ * In case any of the promises is rejected, rejects the resulted promise with all accumulated errors.
+ * @param {Promise<T>[]} promises Promises to be resolved.
+ * @returns {Promise<T[]>} New promise which will be resolved with the results of all promises.
+ */
 function settlePromises(promises) {
     return new Promise((resolve, reject) => {
         let settledPromisesCount = 0;
@@ -183,6 +213,7 @@ function settlePromises(promises) {
                 results[index] = result;
             })
                 .catch((err) => {
+                // Accumulate all errors.
                 errors.push(err);
             })
                 .then(() => {
@@ -214,12 +245,14 @@ function bashQuote(s) {
     if (s[0] === "'" && s[s.length - 1] === "'") {
         return s;
     }
+    // replace ' with '"'"' and wrap in ''
     return "'" + s.replace(/'/g, "'\"'\"'") + "'";
 }
 function cmdQuote(s) {
     if (s[0] === '"' && s[s.length - 1] === '"') {
         return s;
     }
+    // replace " with \" and wrap in ""
     return '"' + s.replace(/"/g, '\\"') + '"';
 }
 function quoteString(s) {
@@ -276,6 +309,9 @@ function isInteractive() {
     const result = isRunningInTTY() && !isCIEnvironment();
     return result;
 }
+/**
+ * Checks if current process is running in Text Terminal (TTY)
+ */
 function isRunningInTTY() {
     return (process.stdout &&
         process.stdout.isTTY &&
@@ -283,6 +319,10 @@ function isRunningInTTY() {
         process.stdin.isTTY);
 }
 function isCIEnvironment() {
+    // The following CI environments set their own environment variables that we respect:
+    //  travis: "CI",
+    //  circleCI: "CI",
+    //  jenkins: "JENKINS_HOME"
     return !!(process.env && (process.env.CI || process.env.JENKINS_HOME));
 }
 function toBoolean(str) {
@@ -337,11 +377,11 @@ function getMessageWithBorders(message, spanLength = 3) {
     const longestRowLength = message.split("\n").sort((a, b) => {
         return b.length - a.length;
     })[0].length;
-    let border = "*".repeat(longestRowLength + 2 * spanLength);
+    let border = "*".repeat(longestRowLength + 2 * spanLength); // * 2 for both sides
     if (border.length % 2 === 0) {
-        border += "*";
+        border += "*"; // the * should always be an odd number in order to get * in each edge (we will remove the even *s below)
     }
-    border = border.replace(/\*\*/g, "* ");
+    border = border.replace(/\*\*/g, "* "); // ***** => * * * in order to have similar padding to the side borders
     const formatRow = function (row) {
         return (_.padEnd("*", spanLength) +
             _.padEnd(row, border.length - 2 * spanLength) +
@@ -371,12 +411,20 @@ function trimSymbol(str, symbol) {
     return str;
 }
 function parseJson(data) {
+    // Replace BOM from the header of the file if it exists
     return JSON.parse(data.replace(/^\uFEFF/, ""));
 }
+// TODO: Use generic for predicatе predicate: (element: T|T[]) when TypeScript support this.
 async function getFuturesResults(promises, predicate) {
     const results = await Promise.all(promises);
     return _(results).filter(predicate).flatten().value();
 }
+/**
+ * Appends zeroes to a version string until it reaches a specified length.
+ * @param {string} version The version on which to append zeroes.
+ * @param requiredVersionLength The required length of the version string.
+ * @returns {string} Appended version string. In case input is null, undefined or empty string, it is returned immediately without appending anything.
+ */
 function appendZeroesToVersion(version, requiredVersionLength) {
     if (version) {
         const zeroesToAppend = requiredVersionLength - version.split(".").length;
@@ -521,6 +569,14 @@ function getProjectFilesConfig(opts) {
     };
     return projectFilesConfig;
 }
+/**
+ * Tries to find the process id (PID) of the specified application identifier.
+ * This is specific implementation for iOS Simulator, where the running applications are real processes.
+ * Their PIDs are printed in a specific format in the the logs, once the application is started.
+ * @param {string} applicationIdentifier Application Identifier of the app for which we try to get the PID.
+ * @param {string} logLine Line that may contain the PID of the process.
+ * @returns {string} The PID of the searched application identifier in case it's found in the current line, null otherwise.
+ */
 function getPidFromiOSSimulatorLogs(applicationIdentifier, logLine) {
     if (logLine) {
         const pidRegExp = new RegExp(`${applicationIdentifier}:\\s?(\\d+)`);
@@ -568,6 +624,7 @@ function getWinRegPropertyValue(key, propertyName) {
 function stringify(value, replacer, space) {
     return JSON.stringify(value, replacer, space || 2);
 }
+//2019-01-07 18:29:50.745
 function getFixedLengthDateString() {
     const currentDate = new Date();
     const year = currentDate.getFullYear();
@@ -590,6 +647,28 @@ function getFormattedMilliseconds(date) {
     }
     return milliseconds;
 }
+//--- begin part copied from AngularJS
+//The MIT License
+//
+//Copyright (c) 2010-2012 Google, Inc. http://angularjs.org
+//
+//Permission is hereby granted, free of charge, to any person obtaining a copy
+//of this software and associated documentation files (the "Software"), to deal
+//in the Software without restriction, including without limitation the rights
+//to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+//copies of the Software, and to permit persons to whom the Software is
+//furnished to do so, subject to the following conditions:
+//
+//	The above copyright notice and this permission notice shall be included in
+//all copies or substantial portions of the Software.
+//
+//	THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+//IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+//	FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+//AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+//LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+//	OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+//THE SOFTWARE.
 const CLASS_NAME = /class\s+([A-Z].+?)(?:\s+.*?)?\{/;
 const CONSTRUCTOR_ARGS = /constructor\s*([^\(]*)\(\s*([^\)]*)\)/m;
 const FN_NAME_AND_ARGS = /^(?:function)?\s*([^\(]*)\(\s*([^\)]*)\)\s*(=>)?\s*[{_]/m;
@@ -619,6 +698,11 @@ function annotate(fn) {
     }
     return $inject;
 }
+/**
+ * Returns true if all Android signing options are provided, false otherwise.
+ * @param {IAndroidSigningData} signingData The signing data to be validated.
+ * @return {void}
+ */
 function hasValidAndroidSigning(signingData) {
     const isValid = signingData &&
         signingData.keyStorePath &&
@@ -627,3 +711,5 @@ function hasValidAndroidSigning(signingData) {
         signingData.keyStoreAliasPassword;
     return !!isValid;
 }
+//--- end part copied from AngularJS
+//# sourceMappingURL=helpers.js.map