express-fix-any-js 1.26.2 → 1.28.2

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,88 +1,88 @@
-# express-fix-any-js 🚀
-
-**Instantly repair, structure, and align Express.js routing files with automated idempotency and strict formatting safeguards.**
-
-[![npm version](https://img.shields.io/npm/v/express-fix-any-js.svg?style=flat-square&color=38bdf8)](https://www.npmjs.com/package/express-fix-any-js)
-[![license](https://img.shields.io/npm/l/express-fix-any-js.svg?style=flat-square&color=34d399)](LICENSE)
-[![GitHub workflows](https://img.shields.io/github/actions/workflow/status/keshavsoft/express-fix-any-js/npm-publish.yml?style=flat-square&label=workflows)](https://github.com/keshavsoft/express-fix-any-js/actions)
-
----
-
-## 📖 Overview
-
-`express-fix-any-js` is a lightweight, high-performance AST and file-modifier utility. It dynamically injects missing Express.js route declarations, import statements, and export configurations into your JavaScript files while ensuring complete protection against code duplication.
-
-It acts as the foundational engine for the **KeshavSoft API Generation Suite**, seamlessly structuring routes generated via CLI tools or VS Code extensions.
-
----
-
-## ✨ Features
-
-* 🔒 **Idempotent Injection:** Checks files before altering; skips execution silently if a duplicate pattern or route already exists.
-* 📐 **Strict Aesthetics:** Enforces zero-line spacing between consecutive routes while maintaining ideal breathing space after router initializations.
-* ⚡ **Versatile Versioning:** Supports legacy structure modifications alongside cutting-edge AST-based insertions (V1 to V6).
-* 🛠️ **Developer Diagnostics:** Emits clean, explicit inline logging for file updates and duplicate line match warnings.
-
----
-
-## 🚀 Quick Start
-
-### Installation
-
-```bash
-npm install express-fix-any-js
-```
-
-### Programmatic Usage
-
-Safely append or insert local routes using the core `alterFile` API:
-
-```javascript
-import alterFile from 'express-fix-any-js/bin/v6/UpdateJs/common/AlterFile/index.js';
-
-alterFile({
-  jsFilePath: './routes/end-points.js',
-  toInsertLine: 'router.post("/Create", express.json(), CreateFunc);',
-  duplicationCheck: 'router.post("/Create"',
-  insertAfter: [
-    'const router = express.Router();',
-    'router.post("/Alter"' // Inserts here if found, otherwise falls back to router initialization
-  ],
-  showLog: true
-});
-```
-
----
-
-## 📐 Formatting Standards
-
-The utility ensures your routing logic remains pristine by applying strict formatting:
-
-### 1. First Route Base Layout
-```javascript
-const router = express.Router();
-
-router.post("/Alter", express.json(), handler); // Injected with clean top margin
-
-export { router };
-```
-
-### 2. Multi-Route Append Strategy
-```javascript
-router.post("/Alter", express.json(), handler);
-router.post("/Alter1", express.json(), handler); // Appended flush below previous route
-router.post("/Alter2", express.json(), handler);
-```
-
----
-
-## 🌐 Documentation & Guides
-
-Explore the [Official Documentation Portal](https://keshavsoft.github.io/express-fix-any-js/) for interactive guides and deeper architectural workflows:
-
-* 📄 **App.js Route Generation** – Automates app-level router registration.
-* 📄 **Version Route Generation** – Easily sets up `/v1` or `/v2` routing scopes.
-* 📄 **Table Route Generation** – Generates structured relational endpoints like `/doctors`.
-* 📄 **Endpoint Generation** – Scaffolds foundational GET, POST, PUT, and DELETE methods.
-
-Developed with ❤ by [KeshavSoft](https://github.com/keshavsoft). Distributed under the **MIT License**.
+# express-fix-any-js 🚀
+
+**Instantly repair, structure, and align Express.js routing files with automated idempotency and strict formatting safeguards.**
+
+[![npm version](https://img.shields.io/npm/v/express-fix-any-js.svg?style=flat-square&color=38bdf8)](https://www.npmjs.com/package/express-fix-any-js)
+[![license](https://img.shields.io/npm/l/express-fix-any-js.svg?style=flat-square&color=34d399)](LICENSE)
+[![GitHub workflows](https://img.shields.io/github/actions/workflow/status/keshavsoft/express-fix-any-js/npm-publish.yml?style=flat-square&label=workflows)](https://github.com/keshavsoft/express-fix-any-js/actions)
+
+---
+
+## 📖 Overview
+
+`express-fix-any-js` is a lightweight, high-performance AST and file-modifier utility. It dynamically injects missing Express.js route declarations, import statements, and export configurations into your JavaScript files while ensuring complete protection against code duplication.
+
+It acts as the foundational engine for the **KeshavSoft API Generation Suite**, seamlessly structuring routes generated via CLI tools or VS Code extensions.
+
+---
+
+## ✨ Features
+
+* 🔒 **Idempotent Injection:** Checks files before altering; skips execution silently if a duplicate pattern or route already exists.
+* 📐 **Strict Aesthetics:** Enforces zero-line spacing between consecutive routes while maintaining ideal breathing space after router initializations.
+* ⚡ **Versatile Versioning:** Supports legacy structure modifications alongside cutting-edge AST-based insertions (V1 to V6).
+* 🛠️ **Developer Diagnostics:** Emits clean, explicit inline logging for file updates and duplicate line match warnings.
+
+---
+
+## 🚀 Quick Start
+
+### Installation
+
+```bash
+npm install express-fix-any-js
+```
+
+### Programmatic Usage
+
+Safely append or insert local routes using the core `alterFile` API:
+
+```javascript
+import alterFile from 'express-fix-any-js/bin/v6/UpdateJs/common/AlterFile/index.js';
+
+alterFile({
+  jsFilePath: './routes/end-points.js',
+  toInsertLine: 'router.post("/Create", express.json(), CreateFunc);',
+  duplicationCheck: 'router.post("/Create"',
+  insertAfter: [
+    'const router = express.Router();',
+    'router.post("/Alter"' // Inserts here if found, otherwise falls back to router initialization
+  ],
+  showLog: true
+});
+```
+
+---
+
+## 📐 Formatting Standards
+
+The utility ensures your routing logic remains pristine by applying strict formatting:
+
+### 1. First Route Base Layout
+```javascript
+const router = express.Router();
+
+router.post("/Alter", express.json(), handler); // Injected with clean top margin
+
+export { router };
+```
+
+### 2. Multi-Route Append Strategy
+```javascript
+router.post("/Alter", express.json(), handler);
+router.post("/Alter1", express.json(), handler); // Appended flush below previous route
+router.post("/Alter2", express.json(), handler);
+```
+
+---
+
+## 🌐 Documentation & Guides
+
+Explore the [Official Documentation Portal](https://keshavsoft.github.io/express-fix-any-js/) for interactive guides and deeper architectural workflows:
+
+* 📄 **App.js Route Generation** – Automates app-level router registration.
+* 📄 **Version Route Generation** – Easily sets up `/v1` or `/v2` routing scopes.
+* 📄 **Table Route Generation** – Generates structured relational endpoints like `/doctors`.
+* 📄 **Endpoint Generation** – Scaffolds foundational GET, POST, PUT, and DELETE methods.
+
+Developed with ❤ by [KeshavSoft](https://github.com/keshavsoft). Distributed under the **MIT License**.

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/{v25 → v27}/alterFile/forImportLine/index.js

@@ -1,41 +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;
-
+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/{v26/hookFolder → v27/alterFile}/forInsertIndex.js

@@ -1,30 +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
+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/{v26 → v27}/alterFile/insertLine/addLines.js

@@ -1,16 +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);
-};
-
+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/{v25/hookFolder → v27/alterFile}/insertLine/findInsertIndex.js

@@ -1,38 +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;
-};
-
+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/{v25/hookFolder → v27/alterFile}/insertLine/index.js

@@ -1,50 +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"));
-
-};
-
+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/{v25 → v27}/alterFile/insertLine/writeToFile.js

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