express-fix-any-js 1.17.4 → 1.24.1

package/README.md

@@ -113,6 +113,17 @@ For detailed developer notes, architectural mappings, and code analyses:
 
 ---
 
+## 🌐 Documentation
+
+Visit the official documentation portal for detailed guides, workflow diagrams, architecture explanations, and API references.
+
+[![Documentation](https://img.shields.io/badge/📘-Developer_Documentation-2563eb?style=for-the-badge)](https://keshavsoft.github.io/express-fix-any-js/)
+
+**Documentation Portal:**  
+https://keshavsoft.github.io/express-fix-any-js/
+
+---
+
 ## ⚖️ License
 
-MIT License. Designed with ❤️ by [KeshavSoft](https://github.com/keshavsoft).
+MIT License. Designed with ❤️ by [KeshavSoft](https://github.com/keshavsoft).

package/bin/v23/alterFile/forImportLine/index.js

@@ -0,0 +1,41 @@
+import fs from "fs";
+import path from "path";
+
+import defaultFunc from 'pattern-collector-anyjs-story';
+import insertLine from "../insertLine/index.js";
+
+import fileNamesJson from '../../fileNames.json' with {type: 'json'};
+
+const startFunc = ({ inParts, inFileType, inTargetPath,
+    presentKey, regexKey, templateKey
+}) => {
+
+    try {
+        const localJsPath = path.join(inTargetPath, fileNamesJson[inFileType]);
+
+        const fileContent = fs.readFileSync(localJsPath, 'utf8');
+
+        const story = defaultFunc({ fileContent, fileType: inFileType });
+
+        const fromInsertLine = insertLine({
+            presentKey,
+            linesStory: story.linesStory,
+            onlyIndexesValues: story?.onlyIndexesValues,
+            fileContent,
+            importRegex: story?.extractRegex?.toInsertIndex?.[inFileType]?.[regexKey],
+            filePath: localJsPath,
+            inTemplate: story?.reverseTemplates?.[templateKey],
+            inParts
+        });
+
+        return fromInsertLine;
+
+    } catch (error) {
+        console.log("error : ", error);
+
+    };
+};
+
+export default startFunc;
+
+// startFunc({ folderNameToInsert, fileType });

package/bin/v23/alterFile/insertLine/findInsertIndex.js

@@ -0,0 +1,38 @@
+const startFunc = ({ onlyIndexesValues, importRegex, presentKey }) => {
+    const insertStory = {};
+
+    if (!importRegex) {
+        return insertStory;
+    };
+
+    // Try each preferred location until one exists.
+    for (const preference of importRegex) {
+
+        const [group, property] = preference.split(".");
+
+        // Preference like: importLines.firstLineIndex
+        if (property) {
+            if (onlyIndexesValues[group]?.[property] !== undefined) {
+                insertStory.index = onlyIndexesValues[group][property];
+
+                if (presentKey in onlyIndexesValues && !onlyIndexesValues[presentKey]) {
+                    insertStory.gapBefore = true;
+                }
+
+                break;
+            }
+
+            continue;
+        }
+
+        // Special preference like: first
+        if (preference === "firstLineIndex") {
+            insertStory.index = 0;
+            break;
+        };
+    };
+
+    return insertStory;
+};
+
+export default startFunc;

package/bin/v23/alterFile/insertLine/index.js

@@ -0,0 +1,50 @@
+import findInsertIndex from "./findInsertIndex.js";
+import addLines from "./addLines.js";
+import writeToFile from "./writeToFile.js";
+
+function build(template, parts) {
+    return template.replace(/\{(\d+)\}/g, (_, i) => parts[i]);
+};
+
+const startFunc = ({ linesStory, fileContent, filePath, importRegex, onlyIndexesValues,
+    presentKey, inTemplate, inParts }) => {
+
+    const foundUseLinesStory = linesStory[presentKey].find(element => {
+        return element.part2 === inParts[1];
+    });
+
+    if (foundUseLinesStory) {
+        return {
+            KTF: false,
+            KReason: foundUseLinesStory
+        };
+    };
+
+    const newLine = build(inTemplate, inParts);
+
+    const lines = fileContent.split(/\r?\n/);
+
+    const insertStory = findInsertIndex({
+        onlyIndexesValues,
+        importRegex,
+        presentKey
+    });
+
+    addLines({
+        inLines: lines, inInsertAtIndex: insertStory?.index,
+        inNewLine: newLine, inGapBefore: insertStory?.gapBefore,
+        inGapAfter: insertStory?.gapAfter
+    });
+
+    // lines.splice(insertAtIndex, 0, newLine);
+
+    writeToFile({ fileContent, filePath, lines });
+
+    return {
+        newLine, inParts
+    };
+    // fs.writeFileSync(filePath, lines.join(fileContent.includes("\r\n") ? "\r\n" : "\n"));
+
+};
+
+export default startFunc;

package/bin/v23/alterFile/insertLine/writeToFile.js

@@ -0,0 +1,8 @@
+import fs from 'fs';
+
+const startFunc = ({ fileContent, filePath, lines }) => {
+
+    fs.writeFileSync(filePath, lines.join(fileContent.includes("\r\n") ? "\r\n" : "\n"));
+};
+
+export default startFunc;

package/bin/v23/alterFile/start.js

@@ -0,0 +1,28 @@
+import fs from "fs";
+import path from "path";
+
+import fileNamesJson from '../fileNames.json' with {type: 'json'};
+
+const startFunc = ({ alterArray, inFileType, inTargetPath
+}) => {
+
+    try {
+        const localJsPath = path.join(inTargetPath, fileNamesJson[inFileType]);
+
+        let fileContent = fs.readFileSync(localJsPath, 'utf8');
+
+        alterArray.forEach(element => {
+            fileContent = fileContent.replaceAll(element.key, element.value);
+        });
+
+        fs.writeFileSync(localJsPath, fileContent);
+
+        return true;
+
+    } catch (error) {
+        console.log("error : ", error);
+
+    };
+};
+
+export default startFunc;

package/bin/v23/hookFolder/forImportLine/index.js

@@ -0,0 +1,41 @@
+import fs from "fs";
+import path from "path";
+
+import defaultFunc from 'pattern-collector-anyjs-story';
+import insertLine from "../insertLine/index.js";
+
+import fileNamesJson from '../../fileNames.json' with {type: 'json'};
+
+const startFunc = ({ inParts, inFileType, inTargetPath,
+    presentKey, regexKey, templateKey
+}) => {
+
+    try {
+        const localJsPath = path.join(inTargetPath, fileNamesJson[inFileType]);
+
+        const fileContent = fs.readFileSync(localJsPath, 'utf8');
+
+        const story = defaultFunc({ fileContent, fileType: inFileType });
+
+        const fromInsertLine = insertLine({
+            presentKey,
+            linesStory: story.linesStory,
+            onlyIndexesValues: story?.onlyIndexesValues,
+            fileContent,
+            importRegex: story?.extractRegex?.toInsertIndex?.[inFileType]?.[regexKey],
+            filePath: localJsPath,
+            inTemplate: story?.reverseTemplates?.[templateKey],
+            inParts
+        });
+
+        return fromInsertLine;
+
+    } catch (error) {
+        console.log("error : ", error);
+
+    };
+};
+
+export default startFunc;
+
+// startFunc({ folderNameToInsert, fileType });

package/bin/v23/hookFolder/insertLine/findInsertIndex.js

@@ -0,0 +1,38 @@
+const startFunc = ({ onlyIndexesValues, importRegex, presentKey }) => {
+    const insertStory = {};
+
+    if (!importRegex) {
+        return insertStory;
+    };
+
+    // Try each preferred location until one exists.
+    for (const preference of importRegex) {
+
+        const [group, property] = preference.split(".");
+
+        // Preference like: importLines.firstLineIndex
+        if (property) {
+            if (onlyIndexesValues[group]?.[property] !== undefined) {
+                insertStory.index = onlyIndexesValues[group][property];
+
+                if (presentKey in onlyIndexesValues && !onlyIndexesValues[presentKey]) {
+                    insertStory.gapBefore = true;
+                }
+
+                break;
+            }
+
+            continue;
+        }
+
+        // Special preference like: first
+        if (preference === "firstLineIndex") {
+            insertStory.index = 0;
+            break;
+        };
+    };
+
+    return insertStory;
+};
+
+export default startFunc;

package/bin/v23/hookFolder/insertLine/index.js

@@ -0,0 +1,50 @@
+import findInsertIndex from "./findInsertIndex.js";
+import addLines from "./addLines.js";
+import writeToFile from "./writeToFile.js";
+
+function build(template, parts) {
+    return template.replace(/\{(\d+)\}/g, (_, i) => parts[i]);
+};
+
+const startFunc = ({ linesStory, fileContent, filePath, importRegex, onlyIndexesValues,
+    presentKey, inTemplate, inParts }) => {
+
+    const foundUseLinesStory = linesStory[presentKey].find(element => {
+        return element.part2 === inParts[1];
+    });
+
+    if (foundUseLinesStory) {
+        return {
+            KTF: false,
+            KReason: foundUseLinesStory
+        };
+    };
+
+    const newLine = build(inTemplate, inParts);
+
+    const lines = fileContent.split(/\r?\n/);
+
+    const insertStory = findInsertIndex({
+        onlyIndexesValues,
+        importRegex,
+        presentKey
+    });
+
+    addLines({
+        inLines: lines, inInsertAtIndex: insertStory?.index,
+        inNewLine: newLine, inGapBefore: insertStory?.gapBefore,
+        inGapAfter: insertStory?.gapAfter
+    });
+
+    // lines.splice(insertAtIndex, 0, newLine);
+
+    writeToFile({ fileContent, filePath, lines });
+
+    return {
+        newLine, inParts
+    };
+    // fs.writeFileSync(filePath, lines.join(fileContent.includes("\r\n") ? "\r\n" : "\n"));
+
+};
+
+export default startFunc;

package/bin/v23/hookFolder/insertLine/writeToFile.js

@@ -0,0 +1,8 @@
+import fs from 'fs';
+
+const startFunc = ({ fileContent, filePath, lines }) => {
+
+    fs.writeFileSync(filePath, lines.join(fileContent.includes("\r\n") ? "\r\n" : "\n"));
+};
+
+export default startFunc;

package/bin/v23/hookFolder/start.js

@@ -0,0 +1,23 @@
+import forImportLine from "./forImportLine/index.js";
+
+const startFunc = ({ inValue, temporaryValue, OutValue,
+    inFileType, inTargetPath }) => {
+
+    const fromImportLine = forImportLine({
+        inFileType, regexKey: "import",
+        templateKey: "importRegex",
+        inTargetPath, presentKey: "importLines",
+        inParts: [temporaryValue, inValue]
+    });
+
+    const fromUseLine = forImportLine({
+        inParts: [temporaryValue, OutValue],
+        inFileType, regexKey: "consumption",
+        templateKey: "consumptionRegex",
+        inTargetPath, presentKey: "useLines"
+    });
+
+    return { fromImportLine, fromUseLine }
+};
+
+export default startFunc;

package/bin/v23/start.js

@@ -0,0 +1,22 @@
+import hookFolder from "./hookFolder/start.js";
+import alterFile from "./alterFile/start.js";
+
+const startFunc = ({ inValue, temporaryValue, OutValue,
+    inFileType, jsFilePath, inTargetPath, alterArray }) => {
+
+    let fromInternal;
+    let fromAlterFile;
+
+    if (inValue && temporaryValue && OutValue) {
+        fromInternal = hookFolder({
+            inValue, temporaryValue, OutValue,
+            inFileType, inTargetPath
+        });
+    };
+
+    fromAlterFile = alterFile({ alterArray, inFileType, inTargetPath });
+
+    return { fromInternal, fromAlterFile };
+};
+
+export default startFunc;

package/bin/v24/alterFile/forImportLine/index.js

@@ -0,0 +1,41 @@
+import fs from "fs";
+import path from "path";
+
+import defaultFunc from 'pattern-collector-anyjs-story';
+import insertLine from "../insertLine/index.js";
+
+import fileNamesJson from '../../fileNames.json' with {type: 'json'};
+
+const startFunc = ({ inParts, inFileType, inTargetPath,
+    presentKey, regexKey, templateKey
+}) => {
+
+    try {
+        const localJsPath = path.join(inTargetPath, fileNamesJson[inFileType]);
+
+        const fileContent = fs.readFileSync(localJsPath, 'utf8');
+
+        const story = defaultFunc({ fileContent, fileType: inFileType });
+
+        const fromInsertLine = insertLine({
+            presentKey,
+            linesStory: story.linesStory,
+            onlyIndexesValues: story?.onlyIndexesValues,
+            fileContent,
+            importRegex: story?.extractRegex?.toInsertIndex?.[inFileType]?.[regexKey],
+            filePath: localJsPath,
+            inTemplate: story?.reverseTemplates?.[templateKey],
+            inParts
+        });
+
+        return fromInsertLine;
+
+    } catch (error) {
+        console.log("error : ", error);
+
+    };
+};
+
+export default startFunc;
+
+// startFunc({ folderNameToInsert, fileType });

package/bin/v24/alterFile/insertLine/findInsertIndex.js

@@ -0,0 +1,38 @@
+const startFunc = ({ onlyIndexesValues, importRegex, presentKey }) => {
+    const insertStory = {};
+
+    if (!importRegex) {
+        return insertStory;
+    };
+
+    // Try each preferred location until one exists.
+    for (const preference of importRegex) {
+
+        const [group, property] = preference.split(".");
+
+        // Preference like: importLines.firstLineIndex
+        if (property) {
+            if (onlyIndexesValues[group]?.[property] !== undefined) {
+                insertStory.index = onlyIndexesValues[group][property];
+
+                if (presentKey in onlyIndexesValues && !onlyIndexesValues[presentKey]) {
+                    insertStory.gapBefore = true;
+                }
+
+                break;
+            }
+
+            continue;
+        }
+
+        // Special preference like: first
+        if (preference === "firstLineIndex") {
+            insertStory.index = 0;
+            break;
+        };
+    };
+
+    return insertStory;
+};
+
+export default startFunc;

package/bin/v24/alterFile/insertLine/index.js

@@ -0,0 +1,50 @@
+import findInsertIndex from "./findInsertIndex.js";
+import addLines from "./addLines.js";
+import writeToFile from "./writeToFile.js";
+
+function build(template, parts) {
+    return template.replace(/\{(\d+)\}/g, (_, i) => parts[i]);
+};
+
+const startFunc = ({ linesStory, fileContent, filePath, importRegex, onlyIndexesValues,
+    presentKey, inTemplate, inParts }) => {
+
+    const foundUseLinesStory = linesStory[presentKey].find(element => {
+        return element.part2 === inParts[1];
+    });
+
+    if (foundUseLinesStory) {
+        return {
+            KTF: false,
+            KReason: foundUseLinesStory
+        };
+    };
+
+    const newLine = build(inTemplate, inParts);
+
+    const lines = fileContent.split(/\r?\n/);
+
+    const insertStory = findInsertIndex({
+        onlyIndexesValues,
+        importRegex,
+        presentKey
+    });
+
+    addLines({
+        inLines: lines, inInsertAtIndex: insertStory?.index,
+        inNewLine: newLine, inGapBefore: insertStory?.gapBefore,
+        inGapAfter: insertStory?.gapAfter
+    });
+
+    // lines.splice(insertAtIndex, 0, newLine);
+
+    writeToFile({ fileContent, filePath, lines });
+
+    return {
+        newLine, inParts
+    };
+    // fs.writeFileSync(filePath, lines.join(fileContent.includes("\r\n") ? "\r\n" : "\n"));
+
+};
+
+export default startFunc;

package/bin/v24/alterFile/insertLine/writeToFile.js

@@ -0,0 +1,8 @@
+import fs from 'fs';
+
+const startFunc = ({ fileContent, filePath, lines }) => {
+
+    fs.writeFileSync(filePath, lines.join(fileContent.includes("\r\n") ? "\r\n" : "\n"));
+};
+
+export default startFunc;

package/bin/v24/alterFile/start.js

@@ -0,0 +1,28 @@
+import fs from "fs";
+import path from "path";
+
+import fileNamesJson from '../fileNames.json' with {type: 'json'};
+
+const startFunc = ({ alterArray, inFileType, inTargetPath
+}) => {
+
+    try {
+        const localJsPath = path.join(inTargetPath, fileNamesJson[inFileType]);
+
+        let fileContent = fs.readFileSync(localJsPath, 'utf8');
+
+        alterArray.forEach(element => {
+            fileContent = fileContent.replaceAll(element.key, element.value);
+        });
+
+        fs.writeFileSync(localJsPath, fileContent);
+
+        return true;
+
+    } catch (error) {
+        console.log("error : ", error);
+
+    };
+};
+
+export default startFunc;

package/bin/v24/fileNames.json

@@ -0,0 +1,6 @@
+{
+    "fromAppJs": "app.js",
+    "fromRoutesJs": "routes.js",
+    "fromRoutesJsEnd": "routes.js",
+    "fromEndPointsJs": "end-points.js"
+}

package/bin/v24/hookFolder/forImportLine/index.js

@@ -0,0 +1,41 @@
+import fs from "fs";
+import path from "path";
+
+import defaultFunc from 'pattern-collector-anyjs-story';
+import insertLine from "../insertLine/index.js";
+
+import fileNamesJson from '../../fileNames.json' with {type: 'json'};
+
+const startFunc = ({ inParts, inFileType, inTargetPath,
+    presentKey, regexKey, templateKey
+}) => {
+
+    try {
+        const localJsPath = path.join(inTargetPath, fileNamesJson[inFileType]);
+
+        const fileContent = fs.readFileSync(localJsPath, 'utf8');
+
+        const story = defaultFunc({ fileContent, fileType: inFileType });
+
+        const fromInsertLine = insertLine({
+            presentKey,
+            linesStory: story.linesStory,
+            onlyIndexesValues: story?.onlyIndexesValues,
+            fileContent,
+            importRegex: story?.extractRegex?.toInsertIndex?.[inFileType]?.[regexKey],
+            filePath: localJsPath,
+            inTemplate: story?.reverseTemplates?.[templateKey],
+            inParts
+        });
+
+        return fromInsertLine;
+
+    } catch (error) {
+        console.log("error : ", error);
+
+    };
+};
+
+export default startFunc;
+
+// startFunc({ folderNameToInsert, fileType });

package/bin/v24/hookFolder/forInsertIndex.js

@@ -0,0 +1,30 @@
+import fs from 'fs';
+
+const findImportLinesFromNpmIndex = ({ inStory }) => {
+    const importLinesFromNpm = inStory?.linesStory?.importLinesFromNpm;
+
+    const lastLine = importLinesFromNpm[importLinesFromNpm.length - 1];
+
+    return lastLine?.lineNumber;
+};
+
+const findImportLinesIndex = ({ inStory }) => {
+    const importLines = inStory?.linesStory?.importLines;
+
+    const lastLine = importLines[importLines.length - 1];
+
+    return lastLine?.lineNumber;
+};
+
+const findVariablesDeclareHereLinesIndex = ({ inStory }) => {
+    const variablesDeclareHereLines = inStory?.lines?.variablesDeclareHereLines;
+
+    const lastLine = variablesDeclareHereLines[variablesDeclareHereLines.length - 1];
+
+    return lastLine?.lineNumber;
+};
+
+export {
+    findImportLinesFromNpmIndex, findImportLinesIndex,
+    findVariablesDeclareHereLinesIndex
+};

package/bin/v24/hookFolder/insertLine/addLines.js

@@ -0,0 +1,16 @@
+const startFunc = ({
+    inLines,
+    inNewLine,
+    inInsertAtIndex,
+    inGapBefore = false,
+    inGapAfter = false
+}) => {
+    let line = inNewLine;
+
+    if (inGapBefore) line = "\n" + line;
+    if (inGapAfter) line = line + "\n";
+
+    inLines.splice(inInsertAtIndex, 0, line);
+};
+
+export default startFunc;

package/bin/v24/hookFolder/insertLine/findInsertIndex.js

@@ -0,0 +1,38 @@
+const startFunc = ({ onlyIndexesValues, importRegex, presentKey }) => {
+    const insertStory = {};
+
+    if (!importRegex) {
+        return insertStory;
+    };
+
+    // Try each preferred location until one exists.
+    for (const preference of importRegex) {
+
+        const [group, property] = preference.split(".");
+
+        // Preference like: importLines.firstLineIndex
+        if (property) {
+            if (onlyIndexesValues[group]?.[property] !== undefined) {
+                insertStory.index = onlyIndexesValues[group][property];
+
+                if (presentKey in onlyIndexesValues && !onlyIndexesValues[presentKey]) {
+                    insertStory.gapBefore = true;
+                }
+
+                break;
+            }
+
+            continue;
+        }
+
+        // Special preference like: first
+        if (preference === "firstLineIndex") {
+            insertStory.index = 0;
+            break;
+        };
+    };
+
+    return insertStory;
+};
+
+export default startFunc;