tnp-core 16.0.15 → 16.0.17

package/lib/helpers.js

@@ -2,26 +2,35 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.HelpersCore = void 0;
 var tslib_1 = require("tslib");
+//#region import
 var core_imports_1 = require("./core-imports");
 //#region @backend
 var buffer_1 = require("buffer");
 //#endregion
 var index_1 = require("./index");
 var helpers_messages_1 = require("./helpers-messages");
+var core_models_1 = require("./core-models");
 var framework_name_1 = require("./framework-name");
 var encoding = 'utf8';
 //#region @backend
 var trace = !global.hideLog;
+//#endregion
 var WEBSQL_PROC_MOCK_PROCESSES_PID = {};
 var WEBSQL_PROC_MOCK_PROCESSES_PPID = {};
+//#endregion
 var HelpersCore = /** @class */ (function (_super) {
     tslib_1.__extends(HelpersCore, _super);
+    //#endregion
+    //#endregion
+    //#region constructor
     function HelpersCore() {
         var _this = _super.call(this) || this;
         //#endregion
-        _this.bigMaxBuffer = 2024 * 500;
+        //#region fields / getters
         //#region @backend
         _this.processes = [];
+        //#endregion
+        _this.bigMaxBuffer = 2024 * 500;
         return _this;
         // //#region @backend
         // process.on('SIGINT', this.cleanExit); // catch ctrl-c
@@ -38,7 +47,29 @@ var HelpersCore = /** @class */ (function (_super) {
         enumerable: false,
         configurable: true
     });
+    Object.defineProperty(HelpersCore.prototype, "isRunningIn", {
+        //#region @backend
+        get: function () {
+            return {
+                mochaTest: function () {
+                    return (typeof global['it'] === 'function');
+                },
+                cliMode: function () {
+                    return !!global['globalSystemToolMode'];
+                },
+            };
+        },
+        enumerable: false,
+        configurable: true
+    });
     //#endregion
+    //#region methods
+    HelpersCore.prototype.mediaTypeFromSrc = function (src) {
+        var ext = core_imports_1.path.extname(src);
+        var media = core_models_1.mimeTypes[ext];
+        return core_imports_1._.first(media === null || media === void 0 ? void 0 : media.split('/'));
+    };
+    //#region methods / remove file or folder
     //#region @backend
     HelpersCore.prototype.remove = function (fileOrFolderPathOrPatter, exactFolder) {
         if (exactFolder === void 0) { exactFolder = false; }
@@ -53,6 +84,8 @@ var HelpersCore = /** @class */ (function (_super) {
         core_imports_1.rimraf.sync(fileOrFolderPathOrPatter);
     };
     //#endregion
+    //#endregion
+    //#region methods / clean exit proces
     //#region @backend
     HelpersCore.prototype.cleanExit = function () {
         index_1.Helpers.processes.forEach(function (p) {
@@ -64,18 +97,49 @@ var HelpersCore = /** @class */ (function (_super) {
         process.exit();
     };
     ;
+    //#endregion
+    //#endregion
+    //#region methods / is blob
+    /**
+     * check if data is nodejs/browser blob
+     *
+     * @param maybeBlob
+     * @returns
+     */
     HelpersCore.prototype.isBlob = function (maybeBlob) {
         // TODO is this needed hmmmm
         return maybeBlob instanceof buffer_1.Blob; // || toString.call(maybeBlob) === '[object Blob]';
     };
+    //#endregion
+    //#region methods / is buffer
+    /**
+     * Check if data is nodejs buffer
+     *
+     * @param maybeNodejsBuffer
+     * @returns
+     */
+    //#region @backend
+    HelpersCore.prototype.isBuffer = function (maybeNodejsBuffer) {
+        return Buffer.isBuffer(maybeNodejsBuffer);
+    };
+    //#endregion
+    //#endregion
+    //#region methods / remove slash at the end of string
     HelpersCore.prototype.removeSlashAtEnd = function (s) {
         s = (s === null || s === void 0 ? void 0 : s.endsWith("/")) ? s.slice(0, s.length - 1) : s;
         return s;
     };
+    //#endregion
+    //#region methods / remove slash at the begin of string
     HelpersCore.prototype.removeSlashAtBegin = function (s) {
         s = (s === null || s === void 0 ? void 0 : s.startsWith("/")) ? s.slice(1) : s;
         return s;
     };
+    //#endregion
+    //#region methods / stringify object pretty format
+    /**
+     * stringify to pretty json string
+     */
     HelpersCore.prototype.stringify = function (inputObject) {
         // if (_.isString(inputObject)) {
         //   return inputObject;
@@ -86,6 +150,8 @@ var HelpersCore = /** @class */ (function (_super) {
         // }
         return JSON.stringify(inputObject, null, 2);
     };
+    //#endregion
+    //#region methods / run sync or async
     HelpersCore.prototype.runSyncOrAsync = function (fnOrOptions) {
         var firstArg = [];
         for (var _i = 1; _i < arguments.length; _i++) {
@@ -96,7 +162,7 @@ var HelpersCore = /** @class */ (function (_super) {
             var _b;
             return tslib_1.__generator(this, function (_c) {
                 if (core_imports_1._.isUndefined(fnOrOptions)) {
-                    return [2 /*return*/];
+                    return [2 /*return*/, void 0];
                 }
                 optionsMode = core_imports_1._.isObject(fnOrOptions)
                     && !core_imports_1._.isArray(fnOrOptions)
@@ -121,6 +187,7 @@ var HelpersCore = /** @class */ (function (_super) {
         });
     };
     //#endregion
+    //#region methods / create symlink
     //#region @backend
     HelpersCore.prototype.createSymLink = function (existedFileOrFolder, destinationPath, options) {
         //#region fix parameters
@@ -267,6 +334,8 @@ var HelpersCore = /** @class */ (function (_super) {
         }
     };
     //#endregion
+    //#endregion
+    //#region methods / mkdirp
     //#region @backend
     HelpersCore.prototype.mkdirp = function (folderPath) {
         if (core_imports_1._.isArray(folderPath)) {
@@ -295,6 +364,8 @@ var HelpersCore = /** @class */ (function (_super) {
         }
     };
     //#endregion
+    //#endregion
+    //#region methods / is symlink that matches url
     /**
      * symlink may have existed or unexisted destiantion url
      * @param destUrl M
@@ -333,6 +404,8 @@ var HelpersCore = /** @class */ (function (_super) {
         }
         //#endregion
     };
+    //#endregion
+    //#region methods / is symlink file existed or unexisted
     HelpersCore.prototype.isSymlinkFileExitedOrUnexisted = function (filePath) {
         //#region @backendFunc
         try {
@@ -344,6 +417,8 @@ var HelpersCore = /** @class */ (function (_super) {
         }
         //#endregion
     };
+    //#endregion
+    //#region methods / is unexisted link
     /**
      * If symbolnk link that target file does not exits
      */
@@ -362,6 +437,8 @@ var HelpersCore = /** @class */ (function (_super) {
         }
         //#endregion
     };
+    //#endregion
+    //#region methods / is exited symlink
     /**
      * @param existedLink check if source of link exists
      */
@@ -380,11 +457,14 @@ var HelpersCore = /** @class */ (function (_super) {
         }
         //#endregion
     };
+    //#endregion
+    //#region methods / path contain link
     //#region @backend
     HelpersCore.prototype.pathContainLink = function (p) {
         var previous;
         while (true) {
             p = (0, core_imports_1.crossPlatformPath)(core_imports_1.path.dirname(p));
+            // @ts-ignore
             if (p === previous) {
                 return false;
             }
@@ -398,6 +478,8 @@ var HelpersCore = /** @class */ (function (_super) {
         }
     };
     //#endregion
+    //#endregion
+    //#region methods / exists
     HelpersCore.prototype.exists = function (folderOrFilePath
     // , allowUnexistedLinks = false
     ) {
@@ -416,6 +498,11 @@ var HelpersCore = /** @class */ (function (_super) {
         return core_imports_1.fse.existsSync(folderOrFilePath);
         //#endregion
     };
+    //#endregion
+    //#region methods / fix command
+    /**
+     * this is HACK for running procesess inside processes
+     */
     HelpersCore.prototype._fixCommand = function (command) {
         if ((command.startsWith('tnp ') || command.startsWith('firedev ')) // TODO every cli projects here that uses run and need to kill process easly!
             &&
@@ -427,6 +514,8 @@ var HelpersCore = /** @class */ (function (_super) {
         }
         return command;
     };
+    //#endregion
+    //#region methods / command
     HelpersCore.prototype.command = function (command) {
         // console.log({ command })
         command = index_1.Helpers._fixCommand(command);
@@ -437,6 +526,7 @@ var HelpersCore = /** @class */ (function (_super) {
                     options = {};
                 }
                 return new Promise(function (resolve) {
+                    // @ts-ignore
                     var ommitStder = options.ommitStder, cwd = options.cwd, biggerBuffer = options.biggerBuffer, gatherColors = options.gatherColors;
                     if (!cwd) {
                         cwd = process.cwd();
@@ -452,16 +542,20 @@ var HelpersCore = /** @class */ (function (_super) {
                     proc.on('exit', function (code) {
                         resolve(gatheredData);
                     });
+                    // @ts-ignore
                     proc.stdout.on('data', function (data) {
                         gatheredData = "".concat(gatheredData).concat((data === null || data === void 0 ? void 0 : data.toString()) || '');
                     });
+                    // @ts-ignore
                     proc.stdout.on('error', function (data) {
                         gatheredData = "".concat(gatheredData).concat((data === null || data === void 0 ? void 0 : data.toString()) || '');
                     });
                     if (!ommitStder) {
+                        // @ts-ignore
                         proc.stderr.on('data', function (data) {
                             gatheredData = "".concat(gatheredData).concat((data === null || data === void 0 ? void 0 : data.toString()) || '');
                         });
+                        // @ts-ignore
                         proc.stderr.on('error', function (data) {
                             gatheredData = "".concat(gatheredData).concat((data === null || data === void 0 ? void 0 : data.toString()) || '');
                         });
@@ -471,6 +565,8 @@ var HelpersCore = /** @class */ (function (_super) {
             //#endregion
         };
     };
+    //#endregion
+    //#region methods / wait
     HelpersCore.prototype.wait = function (second) {
         return new Promise(function (resolve, reject) {
             setTimeout(function () {
@@ -478,7 +574,8 @@ var HelpersCore = /** @class */ (function (_super) {
             }, second * 1000);
         });
     };
-    //#region command output as string async
+    //#endregion
+    //#region methods / command output as string async
     //#region @backend
     HelpersCore.prototype.commnadOutputAsStringAsync = function (command, cwd, options) {
         if (cwd === void 0) { cwd = (0, core_imports_1.crossPlatformPath)(process.cwd()); }
@@ -504,6 +601,7 @@ var HelpersCore = /** @class */ (function (_super) {
                         // console.log({
                         //   output
                         // })
+                        // @ts-ignore
                         if (opt.showWholeCommandNotOnlyLastLine) {
                             // console.log('SHHOW WOLE', output)
                             return [2 /*return*/, output.replace(/[^\x00-\xFF]/g, '')];
@@ -513,6 +611,7 @@ var HelpersCore = /** @class */ (function (_super) {
                         return [3 /*break*/, 4];
                     case 3:
                         e_1 = _a.sent();
+                        // @ts-ignore
                         if (opt.showErrorWarning) {
                             index_1.Helpers.warn("[firedev-helepr] Not able to get output from command:\n        \"".concat(command, "\"\n        "));
                         }
@@ -524,7 +623,7 @@ var HelpersCore = /** @class */ (function (_super) {
     };
     //#endregion
     //#endregion
-    //#region command output as string
+    //#region methods / command output as string
     //#region @backend
     HelpersCore.prototype.commnadOutputAsString = function (command, cwd, options) {
         var _a;
@@ -533,6 +632,7 @@ var HelpersCore = /** @class */ (function (_super) {
         var opt = (options || {});
         var output = '';
         try {
+            // @ts-ignore
             var env = opt.gatherColors ? tslib_1.__assign(tslib_1.__assign({}, process.env), { FORCE_COLOR: '1' }) : {};
             // output = Helpers.run(command, { output: false, cwd, biggerBuffer }).sync().toString().trim()
             output = (((_a = core_imports_1.child_process.execSync(command, {
@@ -544,6 +644,7 @@ var HelpersCore = /** @class */ (function (_super) {
             // console.log({
             //   output
             // })
+            // @ts-ignore
             if (opt.showWholeCommandNotOnlyLastLine) {
                 return output.replace(/[^\x00-\xFF]/g, '');
             }
@@ -551,6 +652,7 @@ var HelpersCore = /** @class */ (function (_super) {
             output = (splited.pop() || '').replace(/[^\x00-\xFF]/g, '');
         }
         catch (e) {
+            // @ts-ignore
             if (opt.showErrorWarning) {
                 index_1.Helpers.warn("[firedev-helpers] Not able to get output from command:\n      \"".concat(command, "\"\n      cwd: ").concat(cwd, "\n      "));
             }
@@ -559,6 +661,7 @@ var HelpersCore = /** @class */ (function (_super) {
     };
     //#endregion
     //#endregion
+    //#region methods / kill process
     HelpersCore.prototype.killProcess = function (byPid) {
         //#region @backend
         // Helpers.run(`kill -9 ${byPid}`).sync()
@@ -586,6 +689,8 @@ var HelpersCore = /** @class */ (function (_super) {
         /* */
         /* */
     };
+    //#endregion
+    //#region methods / run
     HelpersCore.prototype.run = function (command, options) {
         command = index_1.Helpers._fixCommand(command);
         // console.log({ command })
@@ -605,9 +710,11 @@ var HelpersCore = /** @class */ (function (_super) {
         return {
             //#region @backend
             sync: function () {
+                // @ts-ignore
                 if (core_imports_1._.isArray(options.extractFromLine)) {
                     index_1.Helpers.error("[tnp-helper] extractFromLine only for:\n          - asyncAsPromise\n          - async\n          - unitlOutputContains\n\n          ", false, true);
                 }
+                // @ts-ignore
                 if (core_imports_1._.isNumber(options.tryAgainWhenFailAfter) && options.tryAgainWhenFailAfter > 0) {
                     // TODO try again when fail
                     // try {
@@ -711,6 +818,7 @@ var HelpersCore = /** @class */ (function (_super) {
                 if (detach === void 0) { detach = false; }
                 //#endregion
                 //#region @backendFunc
+                // @ts-ignore
                 options.detach = detach;
                 return index_1.Helpers.runAsyncIn(command, options);
                 //#endregion
@@ -751,6 +859,7 @@ var HelpersCore = /** @class */ (function (_super) {
                         reject("[unitlOutputContains] Message not a array");
                     }
                     var proc = index_1.Helpers.runAsyncIn(command, options);
+                    // @ts-ignore
                     proc.stderr.on('data', function (message) {
                         var data = message.toString().trim();
                         if (!isResolved && core_imports_1._.isArray(stderMsg)) {
@@ -768,6 +877,7 @@ var HelpersCore = /** @class */ (function (_super) {
                             }
                         }
                     });
+                    // @ts-ignore
                     proc.stdout.on('data', function (message) {
                         var data = message.toString().trim();
                         if (!isResolved) {
@@ -803,25 +913,12 @@ var HelpersCore = /** @class */ (function (_super) {
             //#endregion
         };
     };
-    Object.defineProperty(HelpersCore.prototype, "isRunningIn", {
-        //#region @backend
-        get: function () {
-            return {
-                mochaTest: function () {
-                    return (typeof global['it'] === 'function');
-                },
-                cliMode: function () {
-                    return !!global['globalSystemToolMode'];
-                },
-            };
-        },
-        enumerable: false,
-        configurable: true
-    });
     //#endregion
+    //#region methods / get stdio
     //#region @backend
     HelpersCore.prototype.getStdio = function (options) {
-        var output = options.output, silence = options.silence, stdio = options.stdio
+        var // @ts-ignore
+        output = options.output, silence = options.silence, stdio = options.stdio
         // pipeToParentProcerss = false,
         // inheritFromParentProcerss = false
         ;
@@ -838,8 +935,11 @@ var HelpersCore = /** @class */ (function (_super) {
         return resstdio;
     };
     //#endregion
+    //#endregion
+    //#region methods / run sync in
     //#region @backend
     HelpersCore.prototype.runSyncIn = function (command, options) {
+        // @ts-ignore
         var cwd = options.cwd, biggerBuffer = options.biggerBuffer;
         var maxBuffer = biggerBuffer ? index_1.Helpers.bigMaxBuffer : undefined;
         var stdio = index_1.Helpers.getStdio(options);
@@ -847,8 +947,11 @@ var HelpersCore = /** @class */ (function (_super) {
         return core_imports_1.child_process.execSync(command, { stdio: stdio, cwd: cwd, maxBuffer: maxBuffer });
     };
     //#endregion
+    //#endregion
+    //#region methods / run async in
     //#region @backend
     HelpersCore.prototype.runAsyncIn = function (command, options) {
+        // @ts-ignore
         var output = options.output, cwd = options.cwd, biggerBuffer = options.biggerBuffer, outputLineReplace = options.outputLineReplace, extractFromLine = options.extractFromLine, detach = options.detach;
         var maxBuffer = biggerBuffer ? index_1.Helpers.bigMaxBuffer : undefined;
         var stdio = index_1.Helpers.getStdio(options);
@@ -872,6 +975,7 @@ var HelpersCore = /** @class */ (function (_super) {
                 // });
             }
             else {
+                // @ts-ignore
                 proc = core_imports_1.child_process.spawn(cmd, argsForCmd, { cwd: cwd, detached: true });
             }
             index_1.Helpers.log("\n\n      DETACHED PROCESS IS WORKING ON PID: ".concat(proc.pid, "\n\n      "));
@@ -884,13 +988,17 @@ var HelpersCore = /** @class */ (function (_super) {
             if (global.globalSystemToolMode) {
                 proc.on('exit', function (code) {
                     index_1.Helpers.log('EXITING BIG PROCESS');
+                    // @ts-ignore
                     process.exit(code);
                 });
             }
         }
-        return index_1.Helpers.logProc(proc, detach ? true : output, detach ? void 0 : stdio, outputLineReplace, options.prefix, extractFromLine);
+        return index_1.Helpers.logProc(proc, detach ? true : output, detach ? void 0 : stdio, outputLineReplace, // @ts-ignore
+        options.prefix, extractFromLine);
     };
     //#endregion
+    //#endregion
+    //#region methods / log process
     //#region @backend
     HelpersCore.prototype.logProc = function (proc, output, stdio, outputLineReplace, prefix, extractFromLine) {
         if (output === void 0) { output = true; }
@@ -903,24 +1011,28 @@ var HelpersCore = /** @class */ (function (_super) {
             prefix = '';
         }
         if (output) {
+            // @ts-ignore
             proc.stdout.on('data', function (data) {
                 // if (data?.toString().search('was unexpected at this time') !== -1) {
                 //   console.log('!!!COMMAND',command)
                 // }
                 process.stdout.write(index_1.Helpers.modifyLineByLine(data, outputLineReplace, prefix, extractFromLine));
             });
+            // @ts-ignore
             proc.stdout.on('error', function (data) {
                 // if (data?.toString().search('was unexpected at this time') !== -1) {
                 //   console.log('!!!COMMAND',command)
                 // }
                 console.log(index_1.Helpers.modifyLineByLine(data, outputLineReplace, prefix, extractFromLine));
             });
+            // @ts-ignore
             proc.stderr.on('data', function (data) {
                 // if (data?.toString().search('was unexpected at this time') !== -1) {
                 //   console.log('!!!COMMAND',command)
                 // }
                 process.stderr.write(index_1.Helpers.modifyLineByLine(data, outputLineReplace, prefix, extractFromLine));
             });
+            // @ts-ignore
             proc.stderr.on('error', function (data) {
                 // if (data?.toString().search('was unexpected at this time') !== -1) {
                 //   console.log('!!!COMMAND',command)
@@ -955,14 +1067,18 @@ var HelpersCore = /** @class */ (function (_super) {
         }
         return new Promise(function (resolve, reject) {
             // let stdio = [0,1,2]
+            // @ts-ignore
             childProcess.stdout.on('data', function (rawData) {
                 var data = ((rawData === null || rawData === void 0 ? void 0 : rawData.toString()) || '');
-                data = index_1.Helpers.modifyLineByLine(data, outputLineReplace, prefix, extractFromLine);
+                data = index_1.Helpers.modifyLineByLine(data, // @ts-ignore
+                outputLineReplace, prefix, extractFromLine);
+                // @ts-ignore
                 if (!hideOutput.stdout) {
                     process.stdout.write(data);
                 }
-                if (!isResolved && core_imports_1._.isArray(resolvePromiseMsg.stdout)) {
-                    for (var index = 0; index < resolvePromiseMsg.stdout.length; index++) {
+                // @ts-ignore
+                if (!isResolved && core_imports_1._.isArray(resolvePromiseMsg.stdout)) { // @ts-ignore
+                    for (var index = 0; index < resolvePromiseMsg.stdout.length; index++) { // @ts-ignore
                         var m = resolvePromiseMsg.stdout[index];
                         if ((data.search(m) !== -1)) {
                             // Helpers.info(`[unitlOutputContains] Move to next step...`)
@@ -972,8 +1088,9 @@ var HelpersCore = /** @class */ (function (_super) {
                         }
                     }
                 }
-                if (!isResolved && core_imports_1._.isArray(resolvePromiseMsg.stderr)) {
-                    for (var index = 0; index < resolvePromiseMsg.stderr.length; index++) {
+                // @ts-ignore
+                if (!isResolved && core_imports_1._.isArray(resolvePromiseMsg.stderr)) { // @ts-ignore
+                    for (var index = 0; index < resolvePromiseMsg.stderr.length; index++) { // @ts-ignore
                         var rejectm = resolvePromiseMsg.stderr[index];
                         if ((data.search(rejectm) !== -1)) {
                             // Helpers.info(`[unitlOutputContains] Rejected move to next step...`);
@@ -1004,6 +1121,7 @@ var HelpersCore = /** @class */ (function (_super) {
                             error_1 = _a.sent();
                             return [3 /*break*/, 4];
                         case 4:
+                            // @ts-ignore
                             process.exit(code);
                             _a.label = 5;
                         case 5:
@@ -1012,22 +1130,29 @@ var HelpersCore = /** @class */ (function (_super) {
                     }
                 });
             }); });
+            // @ts-ignore
             childProcess.stdout.on('error', function (rawData) {
                 var data = ((rawData === null || rawData === void 0 ? void 0 : rawData.toString()) || '');
-                data = index_1.Helpers.modifyLineByLine(data, outputLineReplace, prefix, extractFromLine);
+                data = index_1.Helpers.modifyLineByLine(data, // @ts-ignore
+                outputLineReplace, prefix, extractFromLine);
+                // @ts-ignore
                 if (!hideOutput.stdout) {
                     process.stdout.write(JSON.stringify(data));
                 }
                 // console.log(data);
             });
+            // @ts-ignore
             childProcess.stderr.on('data', function (rawData) {
                 var data = ((rawData === null || rawData === void 0 ? void 0 : rawData.toString()) || '');
-                data = index_1.Helpers.modifyLineByLine(data, outputLineReplace, prefix, extractFromLine);
+                data = index_1.Helpers.modifyLineByLine(data, // @ts-ignore
+                outputLineReplace, prefix, extractFromLine);
+                // @ts-ignore
                 if (!hideOutput.stderr) {
                     process.stderr.write(data);
                 }
-                if (!isResolved && core_imports_1._.isArray(resolvePromiseMsg.stderr)) {
-                    for (var index = 0; index < resolvePromiseMsg.stderr.length; index++) {
+                // @ts-ignore
+                if (!isResolved && core_imports_1._.isArray(resolvePromiseMsg.stderr)) { // @ts-ignore
+                    for (var index = 0; index < resolvePromiseMsg.stderr.length; index++) { // @ts-ignore
                         var rejectm = resolvePromiseMsg.stderr[index];
                         if ((data.search(rejectm) !== -1)) {
                             // Helpers.info(`[unitlOutputContains] Rejected move to next step...`);
@@ -1039,9 +1164,12 @@ var HelpersCore = /** @class */ (function (_super) {
                     }
                 }
             });
+            // @ts-ignore
             childProcess.stderr.on('error', function (rawData) {
                 var data = ((rawData === null || rawData === void 0 ? void 0 : rawData.toString()) || '');
-                data = index_1.Helpers.modifyLineByLine(data, outputLineReplace, prefix, extractFromLine);
+                data = index_1.Helpers.modifyLineByLine(data, // @ts-ignore
+                outputLineReplace, prefix, extractFromLine);
+                // @ts-ignore
                 if (!hideOutput.stderr) {
                     process.stderr.write(JSON.stringify(data));
                 }
@@ -1050,7 +1178,12 @@ var HelpersCore = /** @class */ (function (_super) {
         });
     };
     //#endregion
+    //#endregion
+    //#region methods / check process
     //#region @backend
+    /**
+     * @deprecated
+     */
     HelpersCore.prototype.checkProcess = function (dirPath, command) {
         if (!core_imports_1.fse.existsSync(dirPath)) {
             index_1.Helpers.error("\nPath for process cwd doesn't exist: ".concat(dirPath, "\ncommand: ").concat(command, "\n"));
@@ -1060,6 +1193,8 @@ var HelpersCore = /** @class */ (function (_super) {
         }
     };
     //#endregion
+    //#endregion
+    //#region methods / modify line by line
     //#region @backend
     HelpersCore.prototype.modifyLineByLine = function (data, outputLineReplace, prefix, extractFromLine) {
         var checkExtract = (core_imports_1._.isArray(extractFromLine) && extractFromLine.length > 0);
@@ -1091,20 +1226,27 @@ var HelpersCore = /** @class */ (function (_super) {
         return data;
     };
     //#endregion
+    //#endregion
+    //#region methods / is folder
     //#region @backend
     HelpersCore.prototype.isFolder = function (pathToFileOrMaybeFolder) {
-        return pathToFileOrMaybeFolder && core_imports_1.fse.existsSync(pathToFileOrMaybeFolder) &&
-            core_imports_1.fse.lstatSync(pathToFileOrMaybeFolder).isDirectory();
+        return !!(pathToFileOrMaybeFolder &&
+            core_imports_1.fse.existsSync(pathToFileOrMaybeFolder) &&
+            core_imports_1.fse.lstatSync(pathToFileOrMaybeFolder).isDirectory());
     };
     //#endregion
+    //#endregion
+    //#region methods / values
     /**
      * Quick fix for object values
+     * @deprecated
      */
     HelpersCore.prototype.values = function (obj) {
         if (core_imports_1._.isObject(obj) && !Array.isArray(obj)) {
             var values = [];
             for (var key in obj) {
                 if (Object.prototype.hasOwnProperty.call(obj, key)) {
+                    // @ts-ignore
                     values.push(obj[key]);
                 }
             }
@@ -1112,20 +1254,26 @@ var HelpersCore = /** @class */ (function (_super) {
         }
         return [];
     };
+    //#endregion
+    //#region methods / is file
     //#region @backend
     /**
      * does not make sense
+     * @deprecated
      */
     HelpersCore.prototype.isFile = function (pathToFileOrMaybeFolder) {
         return pathToFileOrMaybeFolder && core_imports_1.fse.existsSync(pathToFileOrMaybeFolder) &&
             !core_imports_1.fse.lstatSync(pathToFileOrMaybeFolder).isDirectory();
     };
     //#endregion
+    //#endregion
+    //#region methods / read file
     //#region @backend
     /**
-      * wrapper for fs.readFileSync
-      */
-    HelpersCore.prototype.readFile = function (absoluteFilePath, defaultValueWhenNotExists, notTrim) {
+    * wrapper for fs.readFileSync
+    */
+    HelpersCore.prototype.readFile = function (absoluteFilePath, // @ts-ignore
+    defaultValueWhenNotExists, notTrim) {
         if (defaultValueWhenNotExists === void 0) { defaultValueWhenNotExists = void 0; }
         if (notTrim === void 0) { notTrim = false; }
         if (core_imports_1._.isArray(absoluteFilePath)) {
@@ -1148,7 +1296,13 @@ var HelpersCore = /** @class */ (function (_super) {
         }).toString().trim();
     };
     //#endregion
+    //#endregion
+    //#region methods / read json
     //#region @backend
+    /**
+     * read json from absolute path
+     * @returns json object
+     */
     HelpersCore.prototype.readJson = function (absoluteFilePath, defaultValue, useJson5) {
         if (defaultValue === void 0) { defaultValue = {}; }
         if (useJson5 === void 0) { useJson5 = false; }
@@ -1162,6 +1316,7 @@ var HelpersCore = /** @class */ (function (_super) {
         try {
             var fileContent = index_1.Helpers.readFile(absoluteFilePath);
             var json = void 0;
+            // @ts-ignore
             json = index_1.Helpers.parse(fileContent, useJson5 || absoluteFilePath.endsWith('.json5'));
             return json;
         }
@@ -1170,7 +1325,13 @@ var HelpersCore = /** @class */ (function (_super) {
         }
     };
     //#endregion
+    //#endregion
+    //#region methods / parse
     //#region @backend
+    /**
+     * parse json from string
+     * @returns parse json object
+     */
     HelpersCore.prototype.parse = function (jsonInstring, useJson5) {
         if (useJson5 === void 0) { useJson5 = false; }
         if (!core_imports_1._.isString(jsonInstring)) {
@@ -1181,6 +1342,8 @@ var HelpersCore = /** @class */ (function (_super) {
         return (useJson5 ? core_imports_1.json5.parse(jsonInstring) : JSON.parse(jsonInstring));
     };
     //#endregion
+    //#endregion
+    //#region methods / compilation wrapper
     //#region @backend
     HelpersCore.prototype.compilationWrapper = function (fn, taskName, executionType) {
         if (taskName === void 0) { taskName = 'Task'; }
@@ -1219,11 +1382,15 @@ var HelpersCore = /** @class */ (function (_super) {
         });
     };
     //#endregion
+    //#endregion
+    //#region methods / write file
     //#region @backend
     /**
      * wrapper for fs.writeFileSync
      */
-    HelpersCore.prototype.writeFile = function (absoluteFilePath, input, options) {
+    HelpersCore.prototype.writeFile = function (absoluteFilePath, input
+    //#endregion
+    , options) {
         if (core_imports_1._.isArray(absoluteFilePath)) {
             absoluteFilePath = core_imports_1.path.join.apply(this, absoluteFilePath);
         }
@@ -1243,6 +1410,10 @@ var HelpersCore = /** @class */ (function (_super) {
         if (!core_imports_1.fse.existsSync(core_imports_1.path.dirname(absoluteFilePath))) {
             index_1.Helpers.mkdirp(core_imports_1.path.dirname(absoluteFilePath));
         }
+        if (index_1.Helpers.isBuffer(input)) {
+            core_imports_1.fse.writeFileSync(absoluteFilePath, input);
+            return true;
+        }
         if (core_imports_1._.isObject(input)) {
             input = index_1.Helpers.stringify(input);
         }
@@ -1264,6 +1435,8 @@ var HelpersCore = /** @class */ (function (_super) {
         return true;
     };
     //#endregion
+    //#endregion
+    //#region methods / write json
     //#region @backend
     /**
      * wrapper for fs.writeFileSync
@@ -1289,9 +1462,12 @@ var HelpersCore = /** @class */ (function (_super) {
         return true;
     };
     //#endregion
+    //#endregion
+    //#region methods / folders from
     //#region @backend
     /**
      * return absolute paths for folders inside folders
+     * @returns absoulte pathes to folders from path
      */
     HelpersCore.prototype.foldersFrom = function (pathToFolder) {
         if (core_imports_1._.isArray(pathToFolder)) {
@@ -1304,6 +1480,13 @@ var HelpersCore = /** @class */ (function (_super) {
             .map(function (f) { return (0, core_imports_1.crossPlatformPath)(core_imports_1.path.join(pathToFolder, f)); })
             .filter(function (f) { return core_imports_1.fse.lstatSync(f).isDirectory(); });
     };
+    //#endregion
+    //#endregion
+    //#region methods / links from
+    //#region @backend
+    /**
+     * @returns absolute pathes to links from path
+     */
     HelpersCore.prototype.linksToFoldersFrom = function (pathToFolder, outputRealPath) {
         if (outputRealPath === void 0) { outputRealPath = false; }
         if (core_imports_1._.isArray(pathToFolder)) {
@@ -1327,12 +1510,15 @@ var HelpersCore = /** @class */ (function (_super) {
                 }
             }
         }).filter(function (f) { return !!f; })
+            // @ts-ignore
             .map(function (f) { return (0, core_imports_1.crossPlatformPath)(f); });
     };
     //#endregion
+    //#endregion
+    //#region methods / links to folders from path
     //#region @backend
     /**
-     * return absolute paths for folders inside folders
+     * @returns absolute paths for folders inside folders
      */
     HelpersCore.prototype.linksToFolderFrom = function (pathToFolder) {
         // options = (options || {}) as any;
@@ -1358,6 +1544,8 @@ var HelpersCore = /** @class */ (function (_super) {
             .map(function (f) { return (0, core_imports_1.crossPlatformPath)(f); });
     };
     //#endregion
+    //#endregion
+    //#region methods / files from
     //#region @backend
     /**
      * return absolute paths for folders inside folders
@@ -1399,6 +1587,8 @@ var HelpersCore = /** @class */ (function (_super) {
         });
     };
     //#endregion
+    //#endregion
+    //#region methods / open folder in file explorer
     //#region @backend
     HelpersCore.prototype.openFolderInFileExploer = function (folderPath) {
         if (process.platform === 'win32') {