express-fix-any-js-from-base 1.2.5

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 KeshavSoft
+
+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 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.

package/README.md

@@ -0,0 +1,70 @@
+# express-fix-any-js-from-for-import 🚀
+
+> **Idempotent & Clean Route Imports Builder. Intelligently scans, injects, and aligns routing import statements at the top of Javascript files.**
+
+[![npm version](https://img.shields.io/npm/v/express-fix-any-js-from-for-import.svg?style=flat-square&color=38bdf8)](https://www.npmjs.com/package/express-fix-any-js-from-for-import)
+[![license](https://img.shields.io/npm/l/express-fix-any-js-from-for-import.svg?style=flat-square&color=34d399)](LICENSE)
+
+---
+
+## 📖 The Story of the 3 Repositories
+
+This package handles the top-level **imports** layer in our modular route-fixing ecosystem. It is designed to work in alignment with two other packages:
+
+```mermaid
+graph TD
+    story["express-fix-any-js-from-story<br/><b>(High-Level CLI Orchestrator)</b>"]
+    forimport["express-fix-any-js-from-for-import<br/><b>(Route Imports Fixer)</b>"]
+    consumption["express-fix-any-js-from-for-consumption<br/><b>(Route Consumption Fixer)</b>"]
+
+    story -->|Requires| forimport
+    story -->|Requires| consumption
+```
+
+1. **[express-fix-any-js-from-for-import](https://github.com/keshavsoft/express-fix-any-js-from-for-import)** *(This Repository)*: Focuses strictly on inspecting, formatting, and injecting route/router **import statements** cleanly at the top of Javascript files without duplication.
+2. **[express-fix-any-js-from-for-consumption](https://github.com/keshavsoft/express-fix-any-js-from-for-consumption)**: Focuses strictly on inspecting, formatting, and injecting route/router **consumption lines** (`router.use(...)` or `router.post(...)`) in the body of the routes initialization block.
+3. **[express-fix-any-js-from-story](https://github.com/keshavsoft/express-fix-any-js-from-story)**: The master orchestrator. It receives generation specifications (stories) and coordinates both the **import fixer** and the **consumption fixer** to safely build and update full routing definitions.
+
+---
+
+## ✨ Features
+
+*   **🔒 Strict Idempotency**: Prevents adding duplicate imports regardless of repeated builders runs.
+*   **📐 Layout Spacing**: Inserts imports cleanly at the top relative to existing ES imports or CommonJS requires.
+*   **⚡ Cascade Dependency**: Automatically triggers dependents notification builds downstream upon successful publishing.
+
+---
+
+## 🚀 Quick Start
+
+### Installation
+
+```bash
+npm install express-fix-any-js-from-for-import
+```
+
+### Programmatic Usage
+
+```javascript
+import alterFileImports from 'express-fix-any-js-from-for-import';
+
+alterFileImports({
+  jsFilePath: './routes/end-points.js',
+  toInsertLine: "import GetRoutes from './routes/GetRoutes.js';",
+  duplicationCheck: "import GetRoutes"
+});
+```
+
+---
+
+## 🛠[]() Developer Technical Guides
+
+For more details on the orchestration system:
+*   [Developer Docs Home](./docs/index.html)
+*   [Orchestration CLI documentation](https://github.com/keshavsoft/express-fix-any-js-from-story)
+
+---
+
+## ⚖️ License
+
+MIT License. Designed with ❤️ by [KeshavSoft](https://github.com/keshavsoft).

package/bin/cli.js

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+
+import getLatestVersion from "./core/getLatestVersion.js";
+import loadRunner from "./core/loadRunner.js";
+
+const run = async ({ }) => {
+  const version = getLatestVersion();
+  const runner = await loadRunner(version);
+  await runner({});
+};
+
+run({}).then();

package/bin/core/getLatestVersion.js

@@ -0,0 +1,13 @@
+import fs from "fs";
+import path from "path";
+import { fileURLToPath } from "url";
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+
+export default function getLatestVersion() {
+    const versions = fs.readdirSync(path.join(__dirname, ".."))
+        .filter(n => /^v\d+$/.test(n))
+        .sort((a, b) => parseInt(a.slice(1)) - parseInt(b.slice(1)));
+
+    return versions.at(-1);
+};

package/bin/core/loadRunner.js

@@ -0,0 +1,9 @@
+export default async function loadRunner(version) {
+    const mod = await import(`../${version}/start.js`);
+
+    if (typeof mod.default !== "function") {
+        throw new Error(`Invalid start.js in ${version}`);
+    }
+
+    return mod.default;
+};

package/bin/v1/UpdateJs/common/AlterFileForImport/checkDuplicate.js

@@ -0,0 +1,14 @@
+const checkUseDuplicate = ({ inSearchText, inFileContentAsStory }) => {
+
+    const found = inFileContentAsStory.find(element => {
+        return element.folderName === inSearchText;
+    });
+
+    return {
+        inserted: false,
+        found,
+        lineNumber: found ? found.lineNumber : null
+    };
+};
+
+export default checkUseDuplicate;

package/bin/v1/UpdateJs/common/AlterFileForImport/findInsertIndex/defaultAfter/index.js

@@ -0,0 +1,23 @@
+import getFromStory from "./story.js";
+import getFromSummary from "./modulat.js";
+
+const findInsertIndex = ({ toInsertIndex,
+    inAllLinesStory, inSummary
+}) => {
+
+    const storyIndex = getFromStory(inAllLinesStory);
+
+    if (storyIndex !== null) {
+        toInsertIndex = storyIndex;
+    };
+
+    const summaryIndex = getFromSummary(inSummary);
+
+    if (summaryIndex !== null) {
+        toInsertIndex = summaryIndex;
+    };
+
+    return toInsertIndex;
+};
+
+export default findInsertIndex;

package/bin/v1/UpdateJs/common/AlterFileForImport/findInsertIndex/defaultAfter/modulat.js

@@ -0,0 +1,21 @@
+const getFromSummary = (inSummary) => {
+    let index = null;
+
+    if (inSummary?.exportSummary) {
+        const minLine = inSummary?.exportSummary?.maxLineNumber;
+        if (minLine !== Infinity && minLine !== -Infinity) {
+            index = minLine + 1;
+        }
+    };
+
+    if (inSummary?.consumeSummary) {
+        const minLine = inSummary?.consumeSummary?.maxLineNumber;
+        if (minLine !== Infinity && minLine !== -Infinity) {
+            index = minLine + 1;
+        }
+    };
+
+    return index;
+};
+
+export default getFromSummary;

package/bin/v1/UpdateJs/common/AlterFileForImport/findInsertIndex/defaultAfter/story.js

@@ -0,0 +1,8 @@
+const getFromStory = (inAllLinesStory) => {
+    if (Array.isArray(inAllLinesStory)) {
+        return inAllLinesStory.length - 1;
+    }
+    return null;
+};
+
+export default getFromStory;

package/bin/v1/UpdateJs/common/AlterFileForImport/findInsertIndex/defaultBefore/index.js

@@ -0,0 +1,23 @@
+import getFromStory from "./story.js";
+import getFromSummary from "./modulat.js";
+
+const findInsertIndex = ({ toInsertIndex,
+    inAllLinesStory, inSummary, inKeyInSummary
+}) => {
+
+    const storyIndex = getFromStory(inAllLinesStory);
+
+    if (storyIndex !== null) {
+        toInsertIndex = storyIndex;
+    };
+    // console.log("aaaaaaaa-- : ", inKeyInSummary);
+    const summaryIndex = getFromSummary({ inSummary, inKeyInSummary });
+
+    if (summaryIndex !== null) {
+        toInsertIndex = summaryIndex;
+    };
+
+    return toInsertIndex;
+};
+
+export default findInsertIndex;

package/bin/v1/UpdateJs/common/AlterFileForImport/findInsertIndex/defaultBefore/modulat.js

@@ -0,0 +1,24 @@
+const startFunc = ({ inSummary, inKeyInSummary }) => {
+    let index = null;
+    let emptyBefore = false;
+
+    if (inSummary.importSummary?.lineCount === 0) {
+
+        if (inSummary.importFromNpmSummary?.lineCount === 0) {
+            index = 1;
+        } else {
+            emptyBefore = true;
+            index = inSummary.importFromNpmSummary?.maxLineNumber + 1;
+        };
+
+    } else {
+        index = inSummary.importSummary?.minLineNumber;
+    };
+
+    return {
+        emptyBefore,
+        index
+    };
+};
+
+export default startFunc;

package/bin/v1/UpdateJs/common/AlterFileForImport/findInsertIndex/defaultBefore/story.js

@@ -0,0 +1,8 @@
+const getFromStory = (inAllLinesStory) => {
+    if (Array.isArray(inAllLinesStory)) {
+        return inAllLinesStory.length - 1;
+    }
+    return null;
+};
+
+export default getFromStory;

package/bin/v1/UpdateJs/common/AlterFileForImport/findInsertIndex/index.js

@@ -0,0 +1,16 @@
+import defaultAfter from "./defaultAfter/index.js";
+import defaultBefore from "./defaultBefore/index.js";
+
+const startFunc = ({
+    inAllLinesStory, rulesJson, inSummary, inKeyInSummary,
+}) => {
+    let toInsertIndex = 3;
+
+    if (rulesJson.toInsertRule === "defaultAfter") toInsertIndex = defaultAfter({ toInsertIndex, inAllLinesStory, inSummary });
+
+    if (rulesJson.toInsertRule === "defaultBefore") toInsertIndex = defaultBefore({ toInsertIndex, inAllLinesStory, inSummary, inKeyInSummary });
+    // console.log("aaaaaaaa--------- : ", toInsertIndex);
+    return toInsertIndex;
+};
+
+export default startFunc;

package/bin/v1/UpdateJs/common/AlterFileForImport/index.js

@@ -0,0 +1,80 @@
+import getStory from "pattern-collector-anyjs";
+
+import readFile from "../readFile.js";
+import checkDuplicate from "./checkDuplicate.js";
+import findInsertIndex from "./findInsertIndex/index.js";
+import writeFile from "../writeFile.js";
+import getLineStory from "./toInsertLineStory.js";
+import atStart from "./showLogs/atStart.js";
+import atEnd from "./showLogs/atEnd.js";
+
+import packageJson from '../../../../../package.json' with {type: 'json'};
+
+const alterFile = ({
+    jsFilePath, rulesJson, extractRegex, inParseRegex,
+    toCheckLinesName, inKeyInSummary,
+    showLog = false, showLogStep1, showLogStep2, showLogStep3
+}) => {
+
+    atStart({ jsFilePath, rulesJson, packageJson, showLog, parseRegex: inParseRegex, searchRegex: extractRegex });
+
+    const toInsertLine = rulesJson.toInsertLine;
+
+    const content = readFile(jsFilePath);
+
+    const lineStory = getLineStory({
+        toInsertLine, parseRegex: inParseRegex, showLog
+    });
+
+    if (showLog?.withValues) console.log(`${packageJson.name}-lineStory : `, lineStory);
+
+    const fromPatternCollector = getStory({
+        fileContent: content,
+        extractRegex,
+        showLog: showLogStep1,
+        showLogStep1: showLogStep2, showLogStep2: showLogStep3
+    });
+
+    // console.log(`-fromPatternCollector : `, fromPatternCollector.importLines);
+
+    if (showLog?.withValues) console.log(`${packageJson.name}------------ : `, fromPatternCollector);
+
+
+    const duplicateInfo = checkDuplicate({
+        inSearchText: lineStory.raka,
+        inFileContentAsStory: fromPatternCollector[toCheckLinesName]
+    });
+
+    if (duplicateInfo.found) {
+        if (showLog) {
+            console.log(
+                `Duplicate found at line ${duplicateInfo.lineNumber}`
+            );
+        };
+
+        return duplicateInfo;
+    };
+
+    const toInsertIndex = findInsertIndex({
+        inAllLinesStory: fromPatternCollector.allLinesStory,
+        inSummary: fromPatternCollector?.summary,
+        rulesJson, inKeyInSummary
+    });
+
+    writeFile({
+        inJsFilePath: jsFilePath,
+        inInsertLineIndex: toInsertIndex.index,
+        toInsertLine, emptyBefore: toInsertIndex.emptyBefore
+    });
+
+    atEnd({ duplicateInfo, packageJson, showLog });
+
+    return {
+        inserted: true,
+        found: false,
+        filePath: jsFilePath,
+        lineNumber: null
+    };
+};
+
+export default alterFile;

package/bin/v1/UpdateJs/common/AlterFileForImport/showLogs/atEnd.js

@@ -0,0 +1,10 @@
+const startFunc = ({
+    duplicateInfo, packageJson, showLog
+}) => {
+
+    if (showLog?.keysOnly) console.log(`${packageJson.name}-end`);
+    if (showLog?.withValues) console.log(`${packageJson.name}-outputs : `, duplicateInfo);
+
+};
+
+export default startFunc;

package/bin/v1/UpdateJs/common/AlterFileForImport/showLogs/atStart.js

@@ -0,0 +1,13 @@
+const startFunc = ({
+    jsFilePath, rulesJson, packageJson, showLog, parseRegex, searchRegex
+}) => {
+
+    if (showLog?.keysOnly) console.log(`${packageJson.name}-start`);
+
+    if (showLog?.withValues) console.log(`${packageJson.name}-inputs-jsFilePath : `, jsFilePath);
+    if (showLog?.withValues) console.log(`${packageJson.name}-inputs-rulesJson : `, JSON.stringify(rulesJson));
+    if (showLog?.withValues) console.log(`${packageJson.name}-inputs-parseRegex : `, JSON.stringify(parseRegex));
+    if (showLog?.withValues) console.log(`${packageJson.name}-inputs-searchRegex : `, JSON.stringify(searchRegex));
+};
+
+export default startFunc;

package/bin/v1/UpdateJs/common/AlterFileForImport/toInsertLineStory.js

@@ -0,0 +1,17 @@
+import baseRegex from "pattern-collector-base-regex";
+
+const startFunc = ({ toInsertLine, parseRegex, showLog = false }) => {
+
+    if (showLog) console.log("toInsertLineStory-inputs : ", parseRegex, toInsertLine);
+
+    const fromPatternCollector = baseRegex({
+        matchLine: toInsertLine,
+        parseRegex, showLog
+    });
+
+    if (showLog) console.log("toInsertLineStory-outputs : ", fromPatternCollector);
+
+    return fromPatternCollector;
+};
+
+export default startFunc;

package/bin/v1/UpdateJs/common/readFile.js

@@ -0,0 +1,8 @@
+import fs from "fs";
+
+const readFile = (inAppJsPath) => {
+    const localPath = inAppJsPath;
+    return fs.readFileSync(localPath, "utf-8");
+};
+
+export default readFile;

package/bin/v1/UpdateJs/common/writeFile.js

@@ -0,0 +1,25 @@
+import fs from "fs";
+import readFile from "./readFile.js";
+
+const writeFile = ({ inJsFilePath, inInsertLineIndex, toInsertLine,
+    emptyBefore = false, emptyAfter = false
+}) => {
+    try {
+        if (emptyBefore) {
+            toInsertLine = "\n".concat(toInsertLine);
+        };
+
+        const content = readFile(inJsFilePath);
+
+        const lines = content.split("\n");
+
+        const updatedLines = lines.toSpliced(inInsertLineIndex - 1, 0, toInsertLine);
+
+        fs.writeFileSync(inJsFilePath, updatedLines.join("\n"));
+
+    } catch (error) {
+        return error;
+    };
+};
+
+export default writeFile;

package/bin/v1/UpdateJs/index.js

@@ -0,0 +1,9 @@
+import alterFileForImport from "./common/AlterFileForImport/index.js";
+
+const updateAppJs = (args) => {
+    const importResult = alterFileForImport(args);
+
+    return importResult;
+};
+
+export default updateAppJs;

package/bin/v1/start.js

@@ -0,0 +1,7 @@
+import updateJs from "./UpdateJs/index.js";
+
+const run = (args) => {
+  return updateJs(args);
+};
+
+export default run;

package/bin/v2/UpdateJs/common/AlterFileForImport/checkDuplicate.js

@@ -0,0 +1,14 @@
+const checkUseDuplicate = ({ inSearchText, inFileContentAsStory }) => {
+
+    const found = inFileContentAsStory.find(element => {
+        return element.folderName === inSearchText;
+    });
+
+    return {
+        inserted: false,
+        found,
+        lineNumber: found ? found.lineNumber : null
+    };
+};
+
+export default checkUseDuplicate;

package/bin/v2/UpdateJs/common/AlterFileForImport/findInsertIndex/defaultAfter/index.js

@@ -0,0 +1,23 @@
+import getFromStory from "./story.js";
+import getFromSummary from "./modulat.js";
+
+const findInsertIndex = ({ toInsertIndex,
+    inAllLinesStory, inSummary
+}) => {
+
+    const storyIndex = getFromStory(inAllLinesStory);
+
+    if (storyIndex !== null) {
+        toInsertIndex = storyIndex;
+    };
+
+    const summaryIndex = getFromSummary(inSummary);
+
+    if (summaryIndex !== null) {
+        toInsertIndex = summaryIndex;
+    };
+
+    return toInsertIndex;
+};
+
+export default findInsertIndex;

package/bin/v2/UpdateJs/common/AlterFileForImport/findInsertIndex/defaultAfter/modulat.js

@@ -0,0 +1,21 @@
+const getFromSummary = (inSummary) => {
+    let index = null;
+
+    if (inSummary?.exportSummary) {
+        const minLine = inSummary?.exportSummary?.maxLineNumber;
+        if (minLine !== Infinity && minLine !== -Infinity) {
+            index = minLine + 1;
+        }
+    };
+
+    if (inSummary?.consumeSummary) {
+        const minLine = inSummary?.consumeSummary?.maxLineNumber;
+        if (minLine !== Infinity && minLine !== -Infinity) {
+            index = minLine + 1;
+        }
+    };
+
+    return index;
+};
+
+export default getFromSummary;

package/bin/v2/UpdateJs/common/AlterFileForImport/findInsertIndex/defaultAfter/story.js

@@ -0,0 +1,8 @@
+const getFromStory = (inAllLinesStory) => {
+    if (Array.isArray(inAllLinesStory)) {
+        return inAllLinesStory.length - 1;
+    }
+    return null;
+};
+
+export default getFromStory;

package/bin/v2/UpdateJs/common/AlterFileForImport/findInsertIndex/defaultBefore/index.js

@@ -0,0 +1,30 @@
+import getFromStory from "./story.js";
+import getFromSummary from "./modulat.js";
+
+const findInsertIndex = ({ toInsertIndex,
+    inAllLinesStory, inSummary, rulesJson
+}) => {
+
+    const storyIndex = getFromStory(inAllLinesStory);
+
+    if (storyIndex !== null) {
+        toInsertIndex = storyIndex;
+    };
+    // console.log("aaaaaaaa-- : ", inKeyInSummary);
+    const summaryIndex = getFromSummary({
+        inSummary,
+        inToCheckKey: rulesJson?.toCheckKey,
+        inToCheckEmptyKey: rulesJson?.toCheckEmptyKey,
+        inConsiderTop: rulesJson?.considerTop,
+        inConsiderBottom: rulesJson?.considerBottom,
+        inToCheckEmpty2Key: rulesJson?.toCheckEmpty2Key
+    })
+
+    if (summaryIndex !== null) {
+        toInsertIndex = summaryIndex;
+    };
+
+    return toInsertIndex;
+};
+
+export default findInsertIndex;

package/bin/v2/UpdateJs/common/AlterFileForImport/findInsertIndex/defaultBefore/modulat.js

@@ -0,0 +1,53 @@
+const startFunc = ({ inSummary, inToCheckKey, inToCheckEmptyKey,
+    inConsiderTop, inConsiderBottom, inToCheckEmpty2Key
+}) => {
+
+    let index = null;
+    let emptyBefore = false;
+    let emptyAfter = false;
+
+    const toCheckKey = inToCheckKey;
+    const toCheckEmptyKey = inToCheckEmptyKey;
+    const toCheckEmpty2Key = inToCheckEmpty2Key;
+
+    const considerTop = inConsiderTop;
+    const considerBottom = inConsiderBottom;
+
+    if (inSummary[toCheckKey]?.lineCount === 0) {
+
+        if (considerTop) {
+            if (inSummary.importFromNpmSummary?.lineCount === 0) {
+                index = 1;
+            } else {
+                emptyBefore = true;
+                index = inSummary.importFromNpmSummary?.maxLineNumber + 1;
+            };
+        };
+
+        if (considerBottom) {
+            if (inSummary[toCheckEmptyKey]?.lineCount === 0) {
+                if (inSummary[toCheckEmpty2Key]?.lineCount === 0) {
+                    // index = inSummary[toCheckEmptyKey]?.minLineNumber;
+                    index = 1;
+                } else {
+                    emptyBefore = true;
+                    index = inSummary[toCheckEmpty2Key]?.maxLineNumber + 1;
+                };
+            } else {
+                emptyAfter = true;
+                index = inSummary[toCheckEmptyKey]?.minLineNumber;
+            };
+        };
+
+    } else {
+        index = inSummary[toCheckKey]?.minLineNumber;
+    };
+
+    return {
+        emptyBefore,
+        emptyAfter,
+        index
+    };
+};
+
+export default startFunc;

package/bin/v2/UpdateJs/common/AlterFileForImport/findInsertIndex/defaultBefore/story.js

@@ -0,0 +1,8 @@
+const getFromStory = (inAllLinesStory) => {
+    if (Array.isArray(inAllLinesStory)) {
+        return inAllLinesStory.length - 1;
+    }
+    return null;
+};
+
+export default getFromStory;

package/bin/v2/UpdateJs/common/AlterFileForImport/findInsertIndex/index.js

@@ -0,0 +1,19 @@
+import defaultAfter from "./defaultAfter/index.js";
+import defaultBefore from "./defaultBefore/index.js";
+
+const startFunc = ({
+    inAllLinesStory, rulesJson, inSummary
+}) => {
+    let toInsertIndex = 3;
+
+    if (rulesJson.toInsertRule === "defaultAfter") toInsertIndex = defaultAfter({ toInsertIndex, inAllLinesStory, inSummary });
+
+    if (rulesJson.toInsertRule === "defaultBefore") toInsertIndex = defaultBefore({
+        toInsertIndex,
+        inAllLinesStory, inSummary, rulesJson
+    });
+    // console.log("aaaaaaaa--------- : ", toInsertIndex);
+    return toInsertIndex;
+};
+
+export default startFunc;

package/bin/v2/UpdateJs/common/AlterFileForImport/index.js

@@ -0,0 +1,82 @@
+import getStory from "pattern-collector-anyjs";
+
+import readFile from "../readFile.js";
+import checkDuplicate from "./checkDuplicate.js";
+import findInsertIndex from "./findInsertIndex/index.js";
+import writeFile from "../writeFile.js";
+import getLineStory from "./toInsertLineStory.js";
+import atStart from "./showLogs/atStart.js";
+import atEnd from "./showLogs/atEnd.js";
+
+import packageJson from '../../../../../package.json' with {type: 'json'};
+
+const alterFile = ({
+    jsFilePath, rulesJson, extractRegex,
+    showLog = false, showLogStep1, showLogStep2, showLogStep3
+}) => {
+
+    atStart({ jsFilePath, rulesJson, packageJson, showLog, searchRegex: extractRegex });
+
+    const toInsertLine = rulesJson.toInsertLine;
+
+    const content = readFile(jsFilePath);
+
+    // "keyNeeded": "importRegex.parseRegex"
+
+    const lineStory = getLineStory({
+        toInsertLine, parseRegex: extractRegex[rulesJson?.regexNeeded],
+        showLog
+    });
+
+    if (showLog?.withValues) console.log(`${packageJson.name}-lineStory : `, lineStory);
+
+    const fromPatternCollector = getStory({
+        fileContent: content,
+        extractRegex,
+        showLog: showLogStep1,
+        showLogStep1: showLogStep2, showLogStep2: showLogStep3
+    });
+
+    // console.log(`-fromPatternCollector : `, fromPatternCollector.importLines);
+
+    if (showLog?.withValues) console.log(`${packageJson.name}------------ : `, fromPatternCollector);
+
+    const duplicateInfo = checkDuplicate({
+        inSearchText: lineStory.raka,
+        inFileContentAsStory: fromPatternCollector[rulesJson?.toCheckLinesName]
+    });
+
+    if (duplicateInfo.found) {
+        if (showLog) {
+            console.log(
+                `Duplicate found at line ${duplicateInfo.lineNumber}`
+            );
+        };
+
+        return duplicateInfo;
+    };
+
+    const toInsertIndex = findInsertIndex({
+        inAllLinesStory: fromPatternCollector.allLinesStory,
+        inSummary: fromPatternCollector?.summary,
+        rulesJson: rulesJson?.aboutInsertIndex
+    });
+
+    writeFile({
+        inJsFilePath: jsFilePath,
+        inInsertLineIndex: toInsertIndex.index,
+        toInsertLine, emptyBefore: toInsertIndex.emptyBefore,
+        emptyAfter: toInsertIndex.emptyAfter
+    });
+
+    atEnd({ duplicateInfo, packageJson, showLog });
+
+    return {
+        inserted: true,
+        found: false,
+        filePath: jsFilePath,
+        lineNumber: null
+    };
+};
+
+export default alterFile;

package/bin/v2/UpdateJs/common/AlterFileForImport/showLogs/atEnd.js

@@ -0,0 +1,10 @@
+const startFunc = ({
+    duplicateInfo, packageJson, showLog
+}) => {
+
+    if (showLog?.keysOnly) console.log(`${packageJson.name}-end`);
+    if (showLog?.withValues) console.log(`${packageJson.name}-outputs : `, duplicateInfo);
+
+};
+
+export default startFunc;

package/bin/v2/UpdateJs/common/AlterFileForImport/showLogs/atStart.js

@@ -0,0 +1,12 @@
+const startFunc = ({
+    jsFilePath, rulesJson, packageJson, showLog, searchRegex
+}) => {
+
+    if (showLog?.keysOnly) console.log(`${packageJson.name}-start`);
+
+    if (showLog?.withValues) console.log(`${packageJson.name}-inputs-jsFilePath : `, jsFilePath);
+    if (showLog?.withValues) console.log(`${packageJson.name}-inputs-rulesJson : `, JSON.stringify(rulesJson));
+    if (showLog?.withValues) console.log(`${packageJson.name}-inputs-searchRegex : `, JSON.stringify(searchRegex));
+};
+
+export default startFunc;

package/bin/v2/UpdateJs/common/AlterFileForImport/toInsertLineStory.js

@@ -0,0 +1,17 @@
+import baseRegex from "pattern-collector-base-regex";
+
+const startFunc = ({ toInsertLine, parseRegex, showLog = false }) => {
+
+    if (showLog) console.log("toInsertLineStory-inputs : ", parseRegex, toInsertLine);
+
+    const fromPatternCollector = baseRegex({
+        matchLine: toInsertLine,
+        parseRegex, showLog
+    });
+
+    if (showLog) console.log("toInsertLineStory-outputs : ", fromPatternCollector);
+
+    return fromPatternCollector;
+};
+
+export default startFunc;

package/bin/v2/UpdateJs/common/readFile.js

@@ -0,0 +1,8 @@
+import fs from "fs";
+
+const readFile = (inAppJsPath) => {
+    const localPath = inAppJsPath;
+    return fs.readFileSync(localPath, "utf-8");
+};
+
+export default readFile;

package/bin/v2/UpdateJs/common/writeFile.js

@@ -0,0 +1,29 @@
+import fs from "fs";
+import readFile from "./readFile.js";
+
+const writeFile = ({ inJsFilePath, inInsertLineIndex, toInsertLine,
+    emptyBefore = false, emptyAfter = false
+}) => {
+    try {
+        if (emptyBefore) {
+            toInsertLine = "\n".concat(toInsertLine);
+        };
+
+        if (emptyAfter) {
+            toInsertLine = toInsertLine.concat("\n");
+        };
+
+        const content = readFile(inJsFilePath);
+
+        const lines = content.split("\n");
+
+        const updatedLines = lines.toSpliced(inInsertLineIndex - 1, 0, toInsertLine);
+
+        fs.writeFileSync(inJsFilePath, updatedLines.join("\n"));
+
+    } catch (error) {
+        return error;
+    };
+};
+
+export default writeFile;

package/bin/v2/UpdateJs/index.js

@@ -0,0 +1,9 @@
+import alterFileForImport from "./common/AlterFileForImport/index.js";
+
+const updateAppJs = (args) => {
+    const importResult = alterFileForImport(args);
+
+    return importResult;
+};
+
+export default updateAppJs;

package/bin/v2/start.js

@@ -0,0 +1,7 @@
+import updateJs from "./UpdateJs/index.js";
+
+const run = (args) => {
+  return updateJs(args);
+};
+
+export default run;

package/index.js

@@ -0,0 +1,14 @@
+import { createRequire } from "module";
+import getLatestVersion from "./bin/core/getLatestVersion.js";
+
+const require = createRequire(import.meta.url);
+
+const load = (options) => {
+    const v = getLatestVersion();
+
+    const mod = require(`./bin/${v}/start.js`);
+
+    return mod.default(options);
+};
+
+export default load;

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "express-fix-any-js-from-base",
+  "version": "1.2.5",
+  "description": "CLI to build for appjs, the endpoints",
+  "keywords": [
+    "cli",
+    "scaffold",
+    "templates",
+    "node",
+    "project-generator"
+  ],
+  "dependencies": {
+    "pattern-collector-anyjs": "^1.8.2",
+    "pattern-collector-base-regex": "^1.3.2"
+  },
+  "type": "module",
+  "exports": {
+    ".": "./index.js"
+  },
+  "bin": {
+    "express-fix-any-js-from-base": "./bin/cli.js"
+  },
+  "files": [
+    "bin/",
+    "index.js",
+    "README.md",
+    "LICENSE"
+  ],
+  "homepage": "https://cli.keshavsoft.com",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/keshavsoft/express-fix-any-js-from-base"
+  },
+  "bugs": {
+    "url": "https://github.com/keshavsoft/express-fix-any-js-from-base/issues"
+  }
+}