tnp-helpers 19.0.35 → 19.0.37

package/lib/utils.d.ts

@@ -50,7 +50,10 @@ export declare namespace UtilsTypescript {
     /**
      * Attempts to set or add an exported const with given name and value.
      */
-    export const setValueToVariableInTsFile: (tsAbsFilePath: string, variableName: string, valueOfVariable: any, addIfNotExists?: boolean) => void;
+    export const setValueToVariableInTsFile: (tsAbsFilePath: string, variableName: string, valueOfVariable: any, options?: {
+        skipAddIfNotExists?: boolean;
+        useRawStringValue?: boolean;
+    }) => void;
     export class TsImportExport {
         /**
          * for external modification
@@ -153,6 +156,17 @@ export declare namespace UtilsVSCode {
     const generateFancyColor: () => string;
     const vscodeImport: () => typeof vscodeType;
 }
+export declare namespace UtilsDotFile {
+    const setValueToDotFile: (dotFileAbsPath: string | string[], value: string, key: string | number | boolean) => void;
+    const getValueFromDotFile: (dotFileAbsPath: string | string[], key: string) => string | number | boolean;
+    const setValuesKeysFromObject: (dotFileAbsPath: string | string[], obj: Record<string, string | number | boolean>, options?: {
+        /**
+         * if true, it will overwrite existing keys
+         */
+        setAsNewFile?: boolean;
+    }) => void;
+    const getValuesKeysAsJsonObject: <T = Record<string, string | number | boolean>>(dotFileAbsPath: string | string[]) => T;
+}
 export declare namespace UtilsZipBrowser {
     const zipDirBrowser: (fileList: FileList) => Promise<Blob>;
     const unzipArchiveBrowser: (zipBlob: Blob) => Promise<Map<string, Blob>>;

package/lib/utils.js

@@ -1,9 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.UtilsZip = exports.UtilsZipBrowser = exports.UtilsVSCode = exports.UtilsQuickFixes = exports.UtilsMd = exports.UtilsHttp = exports.UtilsTypescript = exports.UtilsNpm = void 0;
+exports.UtilsZip = exports.UtilsZipBrowser = exports.UtilsDotFile = exports.UtilsVSCode = exports.UtilsQuickFixes = exports.UtilsMd = exports.UtilsHttp = exports.UtilsTypescript = exports.UtilsNpm = void 0;
 //#region imports
-const lib_1 = require("tnp-core/lib");
+const lib_1 = require("tnp-config/lib");
 const lib_2 = require("tnp-core/lib");
+const lib_3 = require("tnp-core/lib");
 const typescript_1 = require("typescript");
 const index_1 = require("./index");
 //#endregion
@@ -12,7 +13,7 @@ var UtilsNpm;
 (function (UtilsNpm) {
     //#region is special version
     UtilsNpm.isSpecialVersion = (version) => {
-        return lib_2.CoreModels.NpmSpecialVersions.includes(version);
+        return lib_3.CoreModels.NpmSpecialVersions.includes(version);
     };
     //#endregion
     //#region clear version
@@ -23,7 +24,7 @@ var UtilsNpm;
         }
         version = (version || '')
             .trim()
-            .replace(new RegExp(lib_2.Utils.escapeStringForRegEx('undefined'), 'g'), '0');
+            .replace(new RegExp(lib_3.Utils.escapeStringForRegEx('undefined'), 'g'), '0');
         if (removePrefixes) {
             version = version.replace('^', '').replace('~', '');
         }
@@ -41,7 +42,7 @@ var UtilsNpm;
         }
         version = (version || '')
             .trim()
-            .replace(new RegExp(lib_2.Utils.escapeStringForRegEx('undefined'), 'g'), '0');
+            .replace(new RegExp(lib_3.Utils.escapeStringForRegEx('undefined'), 'g'), '0');
         const splited = version.split('.');
         let [major, minor, patch, alphaOrBetaOrRc] = splited;
         if (splited.length === 1) {
@@ -286,13 +287,13 @@ var UtilsTypescript;
     //#region format file(s) with prettier
     UtilsTypescript.formatFile = (absPathToFile) => {
         //#region @backendFunc
-        absPathToFile = (0, lib_1.crossPlatformPath)(absPathToFile);
+        absPathToFile = (0, lib_2.crossPlatformPath)(absPathToFile);
         if (index_1.Helpers.exists(absPathToFile)) {
             const { execSync } = require('child_process');
             index_1.Helpers.logInfo(`Formatting file: ${absPathToFile}`);
             try {
-                execSync(`prettier --write ${lib_1.path.basename(absPathToFile)}`, {
-                    cwd: lib_1.path.dirname(absPathToFile),
+                execSync(`prettier --write ${lib_2.path.basename(absPathToFile)}`, {
+                    cwd: lib_2.path.dirname(absPathToFile),
                 });
             }
             catch (error) {
@@ -322,13 +323,13 @@ var UtilsTypescript;
     //#region lint file(s) with eslint
     UtilsTypescript.eslintFixFile = (absPathToFile) => {
         //#region @backendFunc
-        absPathToFile = (0, lib_1.crossPlatformPath)(absPathToFile);
+        absPathToFile = (0, lib_2.crossPlatformPath)(absPathToFile);
         if (index_1.Helpers.exists(absPathToFile)) {
             const { execSync } = require('child_process');
             index_1.Helpers.logInfo(`Fixing file with eslint: ${absPathToFile}`);
             try {
-                execSync(`npx --yes eslint --fix ${lib_1.path.basename(absPathToFile)}`, {
-                    cwd: lib_1.path.dirname(absPathToFile),
+                execSync(`npx --yes eslint --fix ${lib_2.path.basename(absPathToFile)}`, {
+                    cwd: lib_2.path.dirname(absPathToFile),
                 });
             }
             catch (error) { }
@@ -338,7 +339,7 @@ var UtilsTypescript;
     };
     UtilsTypescript.eslintFixAllFilesInsideFolder = (absPathToFolder) => {
         //#region @backendFunc
-        absPathToFolder = (0, lib_1.crossPlatformPath)(absPathToFolder);
+        absPathToFolder = (0, lib_2.crossPlatformPath)(absPathToFolder);
         if (index_1.Helpers.exists(absPathToFolder)) {
             index_1.Helpers.info(`Fixing files with eslint in: ${absPathToFolder}`);
             const lintFixFn = () => {
@@ -450,7 +451,7 @@ var UtilsTypescript;
     //#region wrap one line with comment
     UtilsTypescript.wrapWithComment = (oneLineComment, absDestFilePath) => {
         //#region @backendFunc
-        const ext = lib_1.path.extname(absDestFilePath).toLowerCase();
+        const ext = lib_2.path.extname(absDestFilePath).toLowerCase();
         let commentSyntax;
         switch (ext) {
             case '.ts':
@@ -487,11 +488,13 @@ var UtilsTypescript;
     /**
      * Attempts to set or add an exported const with given name and value.
      */
-    UtilsTypescript.setValueToVariableInTsFile = (tsAbsFilePath, variableName, valueOfVariable, addIfNotExists = true) => {
+    UtilsTypescript.setValueToVariableInTsFile = (tsAbsFilePath, variableName, valueOfVariable, options) => {
         //#region @backendFunc
         const sourceText = index_1.Helpers.readFile(tsAbsFilePath);
         const sourceFile = (0, typescript_1.createSourceFile)(tsAbsFilePath, sourceText, typescript_1.ScriptTarget.Latest, 
         /*setParentNodes */ true);
+        options = options || {};
+        const addIfNotExists = !options.skipAddIfNotExists;
         // We'll build an AST transformer that modifies or inserts our variable declaration
         const transformer = (context) => {
             const { factory } = context;
@@ -510,7 +513,12 @@ var UtilsTypescript;
                                 // we wrap it with quotes; otherwise, create a numeric or object literal.
                                 let initializer;
                                 if (typeof valueOfVariable === 'string') {
-                                    initializer = factory.createStringLiteral(valueOfVariable);
+                                    if (options.useRawStringValue) {
+                                        initializer = factory.createIdentifier(valueOfVariable);
+                                    }
+                                    else {
+                                        initializer = factory.createStringLiteral(valueOfVariable);
+                                    }
                                 }
                                 else if (typeof valueOfVariable === 'number') {
                                     initializer = factory.createNumericLiteral(valueOfVariable);
@@ -677,14 +685,17 @@ var UtilsTypescript;
     //#endregion
     //#region helpers / get quote type
     const getQuoteType = (text) => {
+        //#region @websqlFunc
         if (text.startsWith('`'))
             return 'tics';
         if (text.startsWith("'"))
             return 'single';
         return 'double';
+        //#endregion
     };
     //#endregion
     const extractImportExportElements = (node) => {
+        //#region @websqlFunc
         const elements = [];
         if ((0, typescript_1.isImportDeclaration)(node) && node.importClause) {
             // Check if there are named imports inside { }
@@ -700,6 +711,7 @@ var UtilsTypescript;
             }
         }
         return elements;
+        //#endregion
     };
     UtilsTypescript.recognizeImportsFromFile = (fileAbsPAth) => {
         //#region @backendFunc
@@ -824,9 +836,9 @@ var UtilsTypescript;
         index_1.Helpers.taskStarted(`(before prettier) Fixing HTML templates in`);
         const files = index_1.Helpers.filesFrom(directoryPath, true, false);
         for (const fullPath of files) {
-            const file = lib_1.path.basename(fullPath);
+            const file = lib_2.path.basename(fullPath);
             if (index_1.Helpers.exists(fullPath)) {
-                const stat = lib_1.fse.statSync(fullPath);
+                const stat = lib_2.fse.statSync(fullPath);
                 if (file.endsWith('.html')) {
                     const original = index_1.Helpers.readFile(fullPath);
                     const fixed = escapeAtInHtmlText(original);
@@ -843,13 +855,14 @@ var UtilsTypescript;
     //#endregion
     //#region remove tagged imports/exports
     function removeTaggedImportExport(tsFileContent, tags) {
+        //#region @websqlFunc
         const sourceFile = (0, typescript_1.createSourceFile)('temp.ts', tsFileContent, typescript_1.ScriptTarget.Latest, true, typescript_1.ScriptKind.TS);
         // debug && console.log(tsFileContent);
         const lines = tsFileContent.split(/\r?\n/);
         const tagRegex = new RegExp(tags
             .map(t => (Array.isArray(t) ? t[0] : t))
             .filter(Boolean)
-            .map(lib_2.Utils.escapeStringForRegEx)
+            .map(lib_3.Utils.escapeStringForRegEx)
             .join('|'), 'i');
         let a = 0;
         for (const statement of sourceFile.statements) {
@@ -883,6 +896,7 @@ var UtilsTypescript;
         const result = lines.join('\n');
         // debug && console.log(result)
         return result;
+        //#endregion
     }
     UtilsTypescript.removeTaggedImportExport = removeTaggedImportExport;
     //#endregion
@@ -1142,8 +1156,8 @@ var UtilsQuickFixes;
     UtilsQuickFixes.replaceElectronWithNothing = (jsContent, packageName) => {
         //#region @backendFunc
         return jsContent
-            .replace(new RegExp(lib_2.Utils.escapeStringForRegEx(`mod${'ule.exports'} = ${'requ' + 'ire'}("${packageName}");`), 'g'), `/* --- replaced ${packageName} --- */`)
-            .replace(new RegExp(lib_2.Utils.escapeStringForRegEx(`var ${lib_2._.snakeCase(packageName)}_1 = ${'req' + 'uire'}("${packageName}");`), 'g'), `/* --- replaced ${packageName} --- */`);
+            .replace(new RegExp(lib_3.Utils.escapeStringForRegEx(`mod${'ule.exports'} = ${'requ' + 'ire'}("${packageName}");`), 'g'), `/* --- replaced ${packageName} --- */`)
+            .replace(new RegExp(lib_3.Utils.escapeStringForRegEx(`var ${lib_3._.snakeCase(packageName)}_1 = ${'req' + 'uire'}("${packageName}");`), 'g'), `/* --- replaced ${packageName} --- */`);
         // var electron_1 = require("electron");
         //#endregion
     };
@@ -1214,7 +1228,7 @@ var UtilsVSCode;
     };
     UtilsVSCode.vscodeImport = () => {
         //#region @backendFunc
-        if (!lib_1.UtilsOs.isRunningInVscodeExtension()) {
+        if (!lib_2.UtilsOs.isRunningInVscodeExtension()) {
             return {};
         }
         const vscode = require('vsc' + 'ode');
@@ -1223,6 +1237,128 @@ var UtilsVSCode;
     };
 })(UtilsVSCode || (exports.UtilsVSCode = UtilsVSCode = {}));
 //#endregion
+//#region utils dot file
+var UtilsDotFile;
+(function (UtilsDotFile) {
+    //#region parse value from dot file util
+    const parseValue = (rawValue) => {
+        const val = rawValue.trim().replace(/^"|"$/g, '');
+        // Try boolean
+        if (val.toLowerCase() === 'true')
+            return true;
+        if (val.toLowerCase() === 'false')
+            return false;
+        // Try number
+        if (!isNaN(Number(val)) && val !== '')
+            return Number(val);
+        return val;
+    };
+    //#endregion
+    //#region set value to/from dot file
+    UtilsDotFile.setValueToDotFile = (dotFileAbsPath, value, key) => {
+        //#region @backendFunc
+        dotFileAbsPath = (0, lib_2.crossPlatformPath)(dotFileAbsPath);
+        let envContent = '';
+        if (lib_2.fse.existsSync(dotFileAbsPath)) {
+            envContent = index_1.Helpers.readFile(dotFileAbsPath, '');
+        }
+        else {
+            // Create file if it doesn't exist
+            index_1.Helpers.writeFile(dotFileAbsPath, '');
+            index_1.Helpers.logInfo(`[${lib_1.config.frameworkName}-helpers] Created ${lib_2.path.basename(dotFileAbsPath)}`);
+            envContent = '';
+        }
+        const regex = new RegExp(`^${key}=.*$`, 'm');
+        if (regex.test(envContent)) {
+            // Replace existing
+            envContent = envContent.replace(regex, `${key}=${value}`);
+        }
+        else {
+            // Append new
+            if (envContent.length > 0 && !envContent.endsWith('\n')) {
+                envContent += '\n';
+            }
+            envContent += `${key}=${value}\n`;
+        }
+        index_1.Helpers.writeFile(dotFileAbsPath, envContent);
+        index_1.Helpers.info(`[${lib_1.config.frameworkName}-helpers] Updated ${lib_2.path.basename(dotFileAbsPath)}: ${key}=${value}`);
+        //#endregion
+    };
+    //#endregion
+    //#region get value from dot file
+    UtilsDotFile.getValueFromDotFile = (dotFileAbsPath, key) => {
+        //#region @backendFunc
+        dotFileAbsPath = (0, lib_2.crossPlatformPath)(dotFileAbsPath);
+        if (!lib_2.fse.existsSync(dotFileAbsPath)) {
+            index_1.Helpers.warn(`[${lib_1.config.frameworkName}-helpers] File ${lib_2.path.basename(dotFileAbsPath)} does not exist.`);
+            return;
+        }
+        const envContent = lib_2.fse.readFileSync(dotFileAbsPath, 'utf-8');
+        // Parse line by line
+        const lines = envContent.split(/\r?\n/);
+        for (const line of lines) {
+            const trimmed = line.trim();
+            if (!trimmed || trimmed.startsWith('#'))
+                continue;
+            const [k, ...rest] = trimmed.split('=');
+            if (k === key) {
+                return parseValue(rest.join('='));
+            }
+        }
+        //#endregion
+    };
+    //#endregion
+    //#region set values keys from object
+    UtilsDotFile.setValuesKeysFromObject = (dotFileAbsPath, obj, options) => {
+        //#region @backendFunc
+        dotFileAbsPath = (0, lib_2.crossPlatformPath)(dotFileAbsPath);
+        options = options || {};
+        let envContent = options.setAsNewFile
+            ? ''
+            : index_1.Helpers.readFile(dotFileAbsPath, '');
+        for (const [key, value] of Object.entries(obj)) {
+            const stringValue = String(value);
+            const regex = new RegExp(`^${key}=.*$`, 'm');
+            if (regex.test(envContent)) {
+                envContent = envContent.replace(regex, `${key}=${stringValue}`);
+            }
+            else {
+                if (envContent.length > 0 && !envContent.endsWith('\n')) {
+                    envContent += '\n';
+                }
+                envContent += `${key}=${stringValue}\n`;
+            }
+        }
+        index_1.Helpers.writeFile(dotFileAbsPath, envContent);
+        //#endregion
+    };
+    //#endregion
+    //#region get values keys as json object
+    UtilsDotFile.getValuesKeysAsJsonObject = (dotFileAbsPath) => {
+        //#region @backendFunc
+        dotFileAbsPath = (0, lib_2.crossPlatformPath)(dotFileAbsPath);
+        if (!index_1.Helpers.exists(dotFileAbsPath)) {
+            return {};
+        }
+        const envContent = index_1.Helpers.readFile(dotFileAbsPath, '');
+        const result = {};
+        const lines = envContent.split(/\r?\n/);
+        for (const line of lines) {
+            const trimmed = line.trim();
+            if (!trimmed || trimmed.startsWith('#'))
+                continue;
+            const [key, ...rest] = trimmed.split('=');
+            if (key) {
+                result[key] = parseValue(rest.join('='));
+            }
+        }
+        return result;
+        //#endregion
+    };
+    //#endregion
+})(UtilsDotFile || (exports.UtilsDotFile = UtilsDotFile = {}));
+//#endregion
+//#region utils zip browser
 var UtilsZipBrowser;
 (function (UtilsZipBrowser) {
     // <input type="file" id="folderInput" webkitdirectory />
@@ -1278,21 +1414,23 @@ var UtilsZipBrowser;
         return void 0;
     };
 })(UtilsZipBrowser || (exports.UtilsZipBrowser = UtilsZipBrowser = {}));
+//#endregion
+//#region utils zip node
 var UtilsZip;
 (function (UtilsZip) {
     //#region split zip file
     UtilsZip.splitFile7Zip = async (inputPath, partSizeMB = 99) => {
         //#region @backendFunc
-        const stat = lib_1.fse.statSync(inputPath);
+        const stat = lib_2.fse.statSync(inputPath);
         const partSize = partSizeMB * 1024 * 1024;
         if (stat.size <= partSize) {
             console.log('File is smaller than part size — no split needed.');
             return 0;
         }
         const { path7za } = await Promise.resolve().then(() => require('7zip-bin'));
-        const baseName = lib_1.path.basename(inputPath, lib_1.path.extname(inputPath));
-        const dirname = lib_1.path.dirname(inputPath);
-        const output7zPath = lib_1.path.join(dirname, `${baseName}.7z`);
+        const baseName = lib_2.path.basename(inputPath, lib_2.path.extname(inputPath));
+        const dirname = lib_2.path.dirname(inputPath);
+        const output7zPath = lib_2.path.join(dirname, `${baseName}.7z`);
         return new Promise((resolve, reject) => {
             const args = [
                 'a', // Add to archive
@@ -1301,12 +1439,12 @@ var UtilsZip;
                 `-v${partSizeMB}m`, // ✅ Volume split flag
                 '-mx=0', // No compression (optional: speeds it up)
             ];
-            const proc = lib_1.child_process.spawn(path7za, args, { stdio: 'inherit' });
+            const proc = lib_2.child_process.spawn(path7za, args, { stdio: 'inherit' });
             proc.on('close', async (code) => {
                 if (code !== 0)
                     return reject(new Error(`7za failed with code ${code}`));
                 try {
-                    const files = await lib_1.fse.readdir(dirname);
+                    const files = await lib_2.fse.readdir(dirname);
                     const partFiles = files.filter(f => f.startsWith(`${baseName}.7z.`) &&
                         /^[0-9]{3}$/.test(f.split('.').pop() || ''));
                     const count = partFiles.length;
@@ -1326,26 +1464,26 @@ var UtilsZip;
      */
     UtilsZip.splitFile = async (inputPath, partSizeMB = 99) => {
         //#region @backendFunc
-        const stat = lib_1.fse.statSync(inputPath);
+        const stat = lib_2.fse.statSync(inputPath);
         const partSize = partSizeMB * 1024 * 1024;
         if (stat.size <= partSize) {
             console.log('File is smaller than part size — no split needed.');
             return 0;
         }
         return await new Promise((resolve, reject) => {
-            const baseName = lib_1.path.basename(inputPath);
-            const dirname = lib_1.path.dirname(inputPath);
-            const input = lib_1.fse.createReadStream(inputPath);
+            const baseName = lib_2.path.basename(inputPath);
+            const dirname = lib_2.path.dirname(inputPath);
+            const input = lib_2.fse.createReadStream(inputPath);
             let partIndex = 0;
             let written = 0;
-            let currentStream = lib_1.fse.createWriteStream(`${baseName}.part${partIndex}`);
+            let currentStream = lib_2.fse.createWriteStream(`${baseName}.part${partIndex}`);
             input.on('data', chunk => {
                 let offset = 0;
                 while (offset < chunk.length) {
                     if (written >= partSize) {
                         currentStream.end();
                         partIndex++;
-                        currentStream = lib_1.fse.createWriteStream((0, lib_1.crossPlatformPath)([dirname, `${baseName}.part${partIndex}`]));
+                        currentStream = lib_2.fse.createWriteStream((0, lib_2.crossPlatformPath)([dirname, `${baseName}.part${partIndex}`]));
                         written = 0;
                     }
                     const toWrite = Math.min(partSize - written, chunk.length - offset);
@@ -1373,10 +1511,10 @@ var UtilsZip;
         const zipPath = `${absPathToDir}.zip`;
         const zipfile = new yazl.ZipFile();
         const addDirectoryToZip = async (dir, basePath) => {
-            const entries = await lib_1.fse.promises.readdir(dir, { withFileTypes: true });
+            const entries = await lib_2.fse.promises.readdir(dir, { withFileTypes: true });
             for (const entry of entries) {
-                const fullPath = lib_1.path.join(dir, entry.name);
-                const relPath = lib_1.path.relative(basePath, fullPath).replace(/\\/g, '/');
+                const fullPath = lib_2.path.join(dir, entry.name);
+                const relPath = lib_2.path.relative(basePath, fullPath).replace(/\\/g, '/');
                 if (entry.isDirectory()) {
                     await addDirectoryToZip(fullPath, basePath);
                 }
@@ -1387,7 +1525,7 @@ var UtilsZip;
         };
         await addDirectoryToZip(absPathToDir, absPathToDir);
         zipfile.end();
-        await pipeline(zipfile.outputStream, lib_1.fse.createWriteStream(zipPath));
+        await pipeline(zipfile.outputStream, lib_2.fse.createWriteStream(zipPath));
         //#endregion;
     };
     // Unzip: `/some/path/folder.zip` → `/some/path/folder`
@@ -1404,17 +1542,17 @@ var UtilsZip;
                     return reject(err);
                 zipfile.readEntry();
                 zipfile.on('entry', async (entry) => {
-                    const filePath = lib_1.path.join(extractTo, entry.fileName);
+                    const filePath = lib_2.path.join(extractTo, entry.fileName);
                     if (/\/$/.test(entry.fileName)) {
                         await mkdir(filePath, { recursive: true });
                         zipfile.readEntry();
                     }
                     else {
-                        await mkdir(lib_1.path.dirname(filePath), { recursive: true });
+                        await mkdir(lib_2.path.dirname(filePath), { recursive: true });
                         zipfile.openReadStream(entry, async (err, readStream) => {
                             if (err || !readStream)
                                 return reject(err);
-                            const writeStream = lib_1.fse.createWriteStream(filePath);
+                            const writeStream = lib_2.fse.createWriteStream(filePath);
                             await pipeline(readStream, writeStream);
                             zipfile.readEntry();
                         });
@@ -1427,4 +1565,5 @@ var UtilsZip;
         //#endregion
     };
 })(UtilsZip || (exports.UtilsZip = UtilsZip = {}));
+//#endregion
 //# sourceMappingURL=utils.js.map