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

package/LICENSE

@@ -1,21 +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.
+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

@@ -1,70 +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).
+# 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

@@ -1,12 +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({});
-};
-
+#!/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

@@ -1,13 +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);
+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

@@ -1,9 +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;
+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

@@ -1,14 +1,14 @@
-const checkUseDuplicate = ({ inSearchText, inFileContentAsStory }) => {
-
-    const found = inFileContentAsStory.find(element => {
-        return element.folderName === inSearchText;
-    });
-
-    return {
-        inserted: false,
-        found,
-        lineNumber: found ? found.lineNumber : null
-    };
-};
-
+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

@@ -1,23 +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;
+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

@@ -1,21 +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;
+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

@@ -1,8 +1,8 @@
-const getFromStory = (inAllLinesStory) => {
-    if (Array.isArray(inAllLinesStory)) {
-        return inAllLinesStory.length - 1;
-    }
-    return null;
-};
-
-export default getFromStory;
+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

@@ -1,23 +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;
+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

@@ -1,24 +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;
+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

@@ -1,8 +1,8 @@
-const getFromStory = (inAllLinesStory) => {
-    if (Array.isArray(inAllLinesStory)) {
-        return inAllLinesStory.length - 1;
-    }
-    return null;
-};
-
-export default getFromStory;
+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

@@ -1,16 +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;
+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;