express-fix-any-js 1.16.4 → 1.17.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,118 +1,118 @@
-# express-fix-any-js 🚀
-
-> **Instantly repair, structure, and align Express.js routing files with automated idempotency & 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 JS AST and file modifier utility. It automatically injects missing Express.js route declarations, import statements, and export configurations into your JavaScript files while ensuring complete protection against code duplication.
-
-This module acts as the foundation layer for the **KeshavSoft API Generation Suite**, dynamically structuring routes generated via CLI or VS Code extensions.
-
----
-
-## ✨ Features
-
-*   **🔒 Duplicate Prevention (Idempotency)**: Checks files before altering them. If a route or pattern already exists, it skips execution silently to avoid code corruption.
-*   **📐 Strict Route Formatting**:
-    *   Inserts clean line spaces after `express.Router()` initialization.
-    *   Maintains zero-line spacing between consecutive route definitions.
-    *   Appends spacing cleanly before the `export` keyword.
-*   **⚡ Multiple File Versions (V1 - V6)**: Supports legacy configuration modifications alongside cutting-edge AST-based insertions.
-*   **🛠️ Developer-First Diagnostics**: Provides clear inline logging of file updates and duplicate line match warnings.
-
----
-
-## 📁 Repository Integration Map
-
-`express-fix-any-js` is part of a larger cascading developer ecosystem:
-
-```mermaid
-graph TD
-    ext["vs-code-ext-express-api-gen-get-actions<br/><i>VS Code Extension</i>"]
-    
-    gen["kschema-fs-api-gen-get-actions<br/><i>API Generator Actions</i>"]
-    
-    endpoints["express-fix-endpoints-get-js<br/><i>Endpoint Logic Builder</i>"]
-    
-    anyjs["express-fix-any-js<br/><i>This Core Utility</i>"]
-
-    ext -->|delegates to| gen
-    gen -->|invokes| endpoints
-    endpoints -->|relies on| anyjs
-```
-
----
-
-## 🚀 Quick Start
-
-### Installation
-
-```bash
-npm install express-fix-any-js
-```
-
-### Programmatic Usage
-
-You can use the core `alterFile` function to modify local routes files safely:
-
-```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 immediately after this line if found, otherwise after Router init
-  ],
-  showLog: true
-});
-```
-
----
-
-## 📜 Structuring Rules
-
-The utility operates under strict structural rules to preserve route aesthetics:
-
-### 1. First Route Placement
-When the first route is inserted into an empty routing structure, the file is formatted with breathing space:
-
-```javascript
-const router = express.Router();
-
-router.post("/Alter", express.json(), handler);
-
-export { router };
-```
-
-### 2. Multi-Route Appending
-Subsequent routes are appended directly after the last matching route with no empty line spacing between them:
-
-```javascript
-router.post("/Alter", express.json(), handler);
-router.post("/Alter1", express.json(), handler);
-router.post("/Alter2", express.json(), handler);
-```
-
----
-
-## 🛠️ Developer & API Reference
-
-For detailed developer notes, architectural mappings, and code analyses:
-*   [Developer Docs Home](./docs/index.html)
-*   [Code Style & Readability Analysis](./docs/code_style_and_readability.md)
-*   [AlterFile Workflow Analysis](./docs/alter_file_analysis.md)
-
----
-
-## ⚖️ License
-
-MIT License. Designed with ❤️ by [KeshavSoft](https://github.com/keshavsoft).
+# express-fix-any-js 🚀
+
+> **Instantly repair, structure, and align Express.js routing files with automated idempotency & 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 JS AST and file modifier utility. It automatically injects missing Express.js route declarations, import statements, and export configurations into your JavaScript files while ensuring complete protection against code duplication.
+
+This module acts as the foundation layer for the **KeshavSoft API Generation Suite**, dynamically structuring routes generated via CLI or VS Code extensions.
+
+---
+
+## ✨ Features
+
+*   **🔒 Duplicate Prevention (Idempotency)**: Checks files before altering them. If a route or pattern already exists, it skips execution silently to avoid code corruption.
+*   **📐 Strict Route Formatting**:
+    *   Inserts clean line spaces after `express.Router()` initialization.
+    *   Maintains zero-line spacing between consecutive route definitions.
+    *   Appends spacing cleanly before the `export` keyword.
+*   **⚡ Multiple File Versions (V1 - V6)**: Supports legacy configuration modifications alongside cutting-edge AST-based insertions.
+*   **🛠️ Developer-First Diagnostics**: Provides clear inline logging of file updates and duplicate line match warnings.
+
+---
+
+## 📁 Repository Integration Map
+
+`express-fix-any-js` is part of a larger cascading developer ecosystem:
+
+```mermaid
+graph TD
+    ext["vs-code-ext-express-api-gen-get-actions<br/><i>VS Code Extension</i>"]
+    
+    gen["kschema-fs-api-gen-get-actions<br/><i>API Generator Actions</i>"]
+    
+    endpoints["express-fix-endpoints-get-js<br/><i>Endpoint Logic Builder</i>"]
+    
+    anyjs["express-fix-any-js<br/><i>This Core Utility</i>"]
+
+    ext -->|delegates to| gen
+    gen -->|invokes| endpoints
+    endpoints -->|relies on| anyjs
+```
+
+---
+
+## 🚀 Quick Start
+
+### Installation
+
+```bash
+npm install express-fix-any-js
+```
+
+### Programmatic Usage
+
+You can use the core `alterFile` function to modify local routes files safely:
+
+```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 immediately after this line if found, otherwise after Router init
+  ],
+  showLog: true
+});
+```
+
+---
+
+## 📜 Structuring Rules
+
+The utility operates under strict structural rules to preserve route aesthetics:
+
+### 1. First Route Placement
+When the first route is inserted into an empty routing structure, the file is formatted with breathing space:
+
+```javascript
+const router = express.Router();
+
+router.post("/Alter", express.json(), handler);
+
+export { router };
+```
+
+### 2. Multi-Route Appending
+Subsequent routes are appended directly after the last matching route with no empty line spacing between them:
+
+```javascript
+router.post("/Alter", express.json(), handler);
+router.post("/Alter1", express.json(), handler);
+router.post("/Alter2", express.json(), handler);
+```
+
+---
+
+## 🛠️ Developer & API Reference
+
+For detailed developer notes, architectural mappings, and code analyses:
+*   [Developer Docs Home](./docs/index.html)
+*   [Code Style & Readability Analysis](./docs/code_style_and_readability.md)
+*   [AlterFile Workflow Analysis](./docs/alter_file_analysis.md)
+
+---
+
+## ⚖️ 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/v16/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/v16/findInsertIndex.js

@@ -1,79 +1,79 @@
-const startFunc1 = ({ onlyIndexesValues, extractRegex, presentKey }) => {
-    let insertStory = {};
-
-    mainLoop: for (const element of extractRegex?.toInsertIndex?.import) {
-        const splitValues = element.split(".");
-        const firstValue = splitValues[0];
-        const secondValue = splitValues[1];
-
-        if (splitValues.length > 1) {
-            if (firstValue in onlyIndexesValues) {
-                if (onlyIndexesValues[firstValue]) {
-                    if (secondValue in onlyIndexesValues[firstValue]) {
-                        insertStory.index = onlyIndexesValues[firstValue][secondValue];
-
-                        if (presentKey in onlyIndexesValues) {
-                            if (!onlyIndexesValues[presentKey]) {
-                                insertStory.gapBefore = true;
-                            };
-                        };
-
-                        break mainLoop;
-                    };
-                };
-            };
-        } else {
-            switch (element) {
-                case "first":
-                    insertStory.index = 0;
-
-                    break mainLoop;
-                    break;
-
-                default:
-                    break;
-            }
-        };
-    };
-
-    return insertStory;
-};
-
-const startFunc = ({ onlyIndexesValues, extractRegex, presentKey }) => {
-    const insertStory = {};
-
-    if (!extractRegex) {
-        return insertStory;
-    };
-
-    // Try each preferred location until one exists.
-    for (const preference of extractRegex) {
-
-        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 startFunc1 = ({ onlyIndexesValues, extractRegex, presentKey }) => {
+    let insertStory = {};
+
+    mainLoop: for (const element of extractRegex?.toInsertIndex?.import) {
+        const splitValues = element.split(".");
+        const firstValue = splitValues[0];
+        const secondValue = splitValues[1];
+
+        if (splitValues.length > 1) {
+            if (firstValue in onlyIndexesValues) {
+                if (onlyIndexesValues[firstValue]) {
+                    if (secondValue in onlyIndexesValues[firstValue]) {
+                        insertStory.index = onlyIndexesValues[firstValue][secondValue];
+
+                        if (presentKey in onlyIndexesValues) {
+                            if (!onlyIndexesValues[presentKey]) {
+                                insertStory.gapBefore = true;
+                            };
+                        };
+
+                        break mainLoop;
+                    };
+                };
+            };
+        } else {
+            switch (element) {
+                case "first":
+                    insertStory.index = 0;
+
+                    break mainLoop;
+                    break;
+
+                default:
+                    break;
+            }
+        };
+    };
+
+    return insertStory;
+};
+
+const startFunc = ({ onlyIndexesValues, extractRegex, presentKey }) => {
+    const insertStory = {};
+
+    if (!extractRegex) {
+        return insertStory;
+    };
+
+    // Try each preferred location until one exists.
+    for (const preference of extractRegex) {
+
+        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/v16/forImportLine/index.js

@@ -1,37 +1,37 @@
-import fs from "fs";
-
-import defaultFunc from 'pattern-collector-anyjs-story';
-import insertImportLine from "./insertImportLine.js";
-
-const startFunc = ({ inFolderNameToInsert, inFileType, inJsPath }) => {
-    try {
-
-        const folderNameToInsert = inFolderNameToInsert;
-        const localJsPath = inJsPath;
-
-        const fileContent = fs.readFileSync(localJsPath, 'utf8');
-
-        const story = defaultFunc({
-            fileContent,
-            fileType: inFileType
-        });
-
-        insertImportLine({
-            inStory: story,
-            fileContent, extractRegex: story?.extractRegex,
-            filePath: localJsPath, inFolderNameToInsert: folderNameToInsert,
-            inTemplate1: story.regexForPullLinesStory.importRegex.reverseTemplate,
-            inTemplate: story.reverseTemplates.importRegex,
-            inParts: [`${story.variablesConnection}${folderNameToInsert}`, folderNameToInsert],
-            fileType: inFileType
-        });
-
-    } catch (error) {
-        console.log("error : ", error);
-
-    };
-};
-
-export default startFunc;
-
+import fs from "fs";
+
+import defaultFunc from 'pattern-collector-anyjs-story';
+import insertImportLine from "./insertImportLine.js";
+
+const startFunc = ({ inFolderNameToInsert, inFileType, inJsPath }) => {
+    try {
+
+        const folderNameToInsert = inFolderNameToInsert;
+        const localJsPath = inJsPath;
+
+        const fileContent = fs.readFileSync(localJsPath, 'utf8');
+
+        const story = defaultFunc({
+            fileContent,
+            fileType: inFileType
+        });
+
+        insertImportLine({
+            inStory: story,
+            fileContent, extractRegex: story?.extractRegex,
+            filePath: localJsPath, inFolderNameToInsert: folderNameToInsert,
+            inTemplate1: story.regexForPullLinesStory.importRegex.reverseTemplate,
+            inTemplate: story.reverseTemplates.importRegex,
+            inParts: [`${story.variablesConnection}${folderNameToInsert}`, folderNameToInsert],
+            fileType: inFileType
+        });
+
+    } catch (error) {
+        console.log("error : ", error);
+
+    };
+};
+
+export default startFunc;
+
 // startFunc({ folderNameToInsert, fileType });