nativescript 9.0.0-alpha.13 → 9.0.0-alpha.14

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.styleText(["cyanBright", "bold"], "{N} NativeScript "),
         color_1.color.styleText(["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.styleText(["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

package/lib/common/host-info.js

@@ -65,6 +65,9 @@ class HostInfo {
         catch (err) {
             this.$logger.trace(`Unable to get macOS version from ${systemProfileCommand}. Error is: ${err}`);
         }
+        // https://en.wikipedia.org/wiki/Darwin_(operating_system)#Release_history
+        // Each macOS version is labeled 10.<version>, where it looks like <versions> is taken from the major version returned by os.release() (16.x.x for example) and subtracting 4 from it.
+        // So the version becomes "10.12" in this case.
         const osRelease = this.$osInfo.release();
         const majorVersion = osRelease && _.first(osRelease.split("."));
         macOSVersion = majorVersion && `10.${+majorVersion - 4}`;
@@ -118,3 +121,4 @@ __decorate([
     (0, decorators_1.cache)()
 ], HostInfo.prototype, "getMacOSVersion", null);
 yok_1.injector.register("hostInfo", HostInfo);
+//# sourceMappingURL=host-info.js.map

package/lib/common/http-client.js

@@ -26,6 +26,9 @@ class HttpClient {
         catch (err) {
             if (err.message === HttpClient.STUCK_REQUEST_ERROR_MESSAGE ||
                 err.message === HttpClient.STUCK_RESPONSE_ERROR_MESSAGE) {
+                // Retry the request immediately because there are at least 10 seconds between the two requests.
+                // We have to retry only once the sporadically stuck requests/responses.
+                // We can add exponential backoff retry here if we decide that we need to workaround bigger network issues on the client side.
                 this.$logger.warn("%s Retrying request to %s...", err.message, options.url || options);
                 const retryResult = await this.httpRequestCore(options, proxySettings);
                 return {
@@ -51,6 +54,7 @@ class HttpClient {
         await this.useProxySettings(proxySettings, cliProxySettings, options, headers, requestProto);
         if (!headers["User-Agent"]) {
             if (!this.defaultUserAgent) {
+                //TODO: the user agent client name is also passed explicitly during login and should be kept in sync
                 this.defaultUserAgent = `${this.$staticConfig.USER_AGENT_NAME}/${this.$staticConfig.version} (Node.js ${process.versions.node}; ${process.platform}; ${process.arch})`;
                 this.$logger.trace("User-Agent: %s", this.defaultUserAgent);
             }
@@ -79,14 +83,19 @@ class HttpClient {
         }).catch((err) => {
             this.$logger.trace("An error occurred while sending the request:", err);
             if (err.response) {
+                // The request was made and the server responded with a status code
+                // that falls out of the range of 2xx
                 const errorMessage = this.getErrorMessage(err.response.status, null);
                 err.proxyAuthenticationRequired =
                     err.response.status === constants_1.HttpStatusCodes.PROXY_AUTHENTICATION_REQUIRED;
                 err.message = errorMessage || err.message;
             }
             else if (err.request) {
+                // The request was made but no response was received
+                // `err.request` is an instance of XMLHttpRequest in the browser and an instance of
             }
             else {
+                // Something happened in setting up the request that triggered an Error
             }
             throw err;
         });
@@ -132,8 +141,17 @@ class HttpClient {
             return body;
         }
     }
+    /**
+     * This method respects the proxySettings (or proxyCache) by modifying headers and options passed to http(s) module.
+     * @param {IProxySettings} proxySettings The settings passed for this specific call.
+     * @param {IProxySettings} cliProxySettings The globally set proxy for this CLI.
+     * @param {any}options The object that will be passed to http(s) module.
+     * @param {any} headers Headers of the current request.
+     * @param {string} requestProto The protocol used for the current request - http or https.
+     */
     async useProxySettings(proxySettings, cliProxySettings, options, headers, requestProto) {
         const isLocalRequest = options.host === "localhost" || options.host === "127.0.0.1";
+        // don't use the proxy for requests to localhost
         if (!isLocalRequest && (proxySettings || cliProxySettings)) {
             const proto = (proxySettings && proxySettings.protocol) ||
                 cliProxySettings.protocol ||
@@ -144,6 +162,7 @@ class HttpClient {
             if (cliProxySettings.username && cliProxySettings.password) {
                 credentialsPart = `${cliProxySettings.username}:${cliProxySettings.password}@`;
             }
+            // Note that proto ends with :
             options.proxy = `${proto}//${credentialsPart}${host}:${port}`;
             options.rejectUnauthorized = proxySettings
                 ? proxySettings.rejectUnauthorized
@@ -156,3 +175,4 @@ exports.HttpClient = HttpClient;
 HttpClient.STUCK_REQUEST_ERROR_MESSAGE = "The request can't receive any response.";
 HttpClient.STUCK_RESPONSE_ERROR_MESSAGE = "Can't receive all parts of the response.";
 yok_1.injector.register("httpClient", HttpClient);
+//# sourceMappingURL=http-client.js.map

package/lib/common/logger/appenders/cli-appender.js

@@ -15,9 +15,13 @@ function cliAppender(layout) {
     return appender;
 }
 function configure(config, layouts) {
+    // the default layout for the appender
     let layout = layouts.messagePassThroughLayout;
+    // check if there is another layout specified
     if (config.layout) {
         layout = layouts.layout(config.layout.type, config.layout);
     }
+    // create a new appender instance
     return cliAppender(layout);
 }
+//# sourceMappingURL=cli-appender.js.map

package/lib/common/logger/appenders/emit-appender.js

@@ -21,9 +21,13 @@ function configure(config, layouts) {
     if (!config.emitter.emit || typeof config.emitter.emit !== "function") {
         throw new Error("The passed emitter must be instance of EventEmitter");
     }
+    // the default layout for the appender
     let layout = layouts.messagePassThroughLayout;
+    // check if there is another layout specified
     if (config.layout) {
         layout = layouts.layout(config.layout.type, config.layout);
     }
+    // create a new appender instance
     return emitAppender(layout, config.emitter);
 }
+//# sourceMappingURL=emit-appender.js.map

package/lib/common/logger/layouts/cli-layout.js

@@ -30,3 +30,4 @@ function layout(config) {
         return msg;
     };
 }
+//# sourceMappingURL=cli-layout.js.map

package/lib/common/logger/logger.js

@@ -98,9 +98,11 @@ class Logger {
         if (typeof item === "string") {
             return item;
         }
+        // do not try to read streams, because they may not be rewindable
         if (item instanceof stream.Readable) {
             return "[ReadableStream]";
         }
+        // There's no point in printing buffers
         if (item instanceof Buffer) {
             return "[Buffer]";
         }
@@ -153,12 +155,14 @@ class Logger {
     getLogOptionsForMessage(data) {
         const loggerOptionKeys = _.keys(constants_1.LoggerConfigData);
         const dataToCheck = data.filter((el) => {
+            // objects created with Object.create(null) do not have `hasOwnProperty` function
             if (!!el &&
                 typeof el === "object" &&
                 el.hasOwnProperty &&
                 typeof el.hasOwnProperty === "function") {
                 for (const key of loggerOptionKeys) {
                     if (el.hasOwnProperty(key)) {
+                        // include only the elements which have one of the keys we've specified as logger options
                         return true;
                     }
                 }
@@ -197,3 +201,4 @@ __decorate([
     (0, decorators_1.cache)()
 ], Logger.prototype, "initialize", null);
 yok_1.injector.register("logger", Logger);
+//# sourceMappingURL=logger.js.map

package/lib/common/messages/messages.js

@@ -1,7 +1,11 @@
 "use strict";
+//
+// automatically generated code; do not edit manually!
+//
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Messages = void 0;
 const yok_1 = require("../yok");
+/* tslint:disable:all */
 class Messages {
     constructor() {
         this.Devices = {
@@ -13,3 +17,5 @@ class Messages {
 }
 exports.Messages = Messages;
 yok_1.injector.register("messages", Messages);
+/* tslint:enable */
+//# sourceMappingURL=messages.js.map