express-fix-any-js 1.24.4 → 1.25.2

package/README.md

@@ -1,6 +1,6 @@
 # express-fix-any-js 🚀
 
-> **Instantly repair, structure, and align Express.js routing files with automated idempotency & formatting safeguards.**
+**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)
@@ -10,42 +10,18 @@
 
 ## 📖 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.
+`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.
 
-This module acts as the foundation layer for the **KeshavSoft API Generation Suite**, dynamically structuring routes generated via CLI or VS Code extensions.
+It acts as the foundational engine for the **KeshavSoft API Generation Suite**, seamlessly structuring routes generated via CLI tools 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
-```
+* 🔒 **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.
 
 ---
 
@@ -59,7 +35,7 @@ npm install express-fix-any-js
 
 ### Programmatic Usage
 
-You can use the core `alterFile` function to modify local routes files safely:
+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';
@@ -70,7 +46,7 @@ alterFile({
   duplicationCheck: 'router.post("/Create"',
   insertAfter: [
     'const router = express.Router();',
-    'router.post("/Alter"' // Inserts immediately after this line if found, otherwise after Router init
+    'router.post("/Alter"' // Inserts here if found, otherwise falls back to router initialization
   ],
   showLog: true
 });
@@ -78,52 +54,35 @@ alterFile({
 
 ---
 
-## 📜 Structuring Rules
+## 📐 Formatting Standards
 
-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:
+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);
+router.post("/Alter", express.json(), handler); // Injected with clean top margin
 
 export { router };
 ```
 
-### 2. Multi-Route Appending
-Subsequent routes are appended directly after the last matching route with no empty line spacing between them:
-
+### 2. Multi-Route Append Strategy
 ```javascript
 router.post("/Alter", express.json(), handler);
-router.post("/Alter1", express.json(), handler);
+router.post("/Alter1", express.json(), handler); // Appended flush below previous route
 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)
-
----
-
-## 🌐 Documentation
+## 🌐 Documentation & Guides
 
-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/
-
----
+Explore the [Official Documentation Portal](https://keshavsoft.github.io/express-fix-any-js/) for interactive guides and deeper architectural workflows:
 
-## ⚖️ License
+* 📄 **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.
 
-MIT License. Designed with ❤️ by [KeshavSoft](https://github.com/keshavsoft).
+Developed with ❤ by [KeshavSoft](https://github.com/keshavsoft). Distributed under the **MIT License**.

package/bin/v25/alterFile/start.js

@@ -0,0 +1,41 @@
+import fs from "fs";
+import path from "path";
+
+import fileNamesJson from '../fileNames.json' with {type: 'json'};
+
+const startFunc = ({ alterArray, inFileType, inTargetPath, inValue }) => {
+
+    try {
+        if (!inFileType in fileNamesJson) {
+            return false;
+        };
+
+        if (!"hookTo" in fileNamesJson[inFileType]) {
+            return false;
+        };
+
+        if (!"fileName" in fileNamesJson[fileNamesJson[inFileType]?.hookTo]) {
+            return false;
+        };
+
+        const jsFileName = fileNamesJson[fileNamesJson[inFileType]?.hookTo]?.fileName;
+
+        const localJsPath = path.join(inTargetPath, inValue, jsFileName);
+
+        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/v25/fileNames.json

@@ -0,0 +1,35 @@
+{
+    "version": "25.2",
+    "fromAppJs": {
+        "fileName": "app.js",
+        "temporaryValue": "routerFrom"
+    },
+    "fromRoutesJs": {
+        "fileName": "routes.js",
+        "temporaryValue": "routerFrom"
+    },
+    "fromRoutesJsEnd": {
+        "fileName": "routes.js",
+        "temporaryValue": "routerFrom",
+        "hookTo": "fromEndPointsJs"
+    },
+    "fromEndPointsJs": {
+        "fileName": "end-points.js",
+        "temporaryValue": "funcFrom",
+        "hookTo": "fromControllerJs"
+    },
+    "tableGetShowAll": {
+        "fileName": "end-points.js",
+        "temporaryValue": "funcFrom",
+        "hookTo": "fromControllerJs"
+    },
+    "tableGetFind": {
+        "fileName": "end-points.js",
+        "temporaryValue": "funcFrom",
+        "hookTo": "fromControllerJs"
+    },
+    "fromControllerJs": {
+        "fileName": "controller.js",
+        "temporaryValue": "controllerFrom"
+    }
+}

package/bin/{v23 → v25}/hookFolder/forImportLine/index.js

@@ -11,7 +11,7 @@ const startFunc = ({ inParts, inFileType, inTargetPath,
 }) => {
 
     try {
-        const localJsPath = path.join(inTargetPath, fileNamesJson[inFileType]);
+        const localJsPath = path.join(inTargetPath, fileNamesJson[inFileType]?.fileName);
 
         const fileContent = fs.readFileSync(localJsPath, 'utf8');
 

package/bin/{v23 → v25}/hookFolder/start.js

@@ -1,17 +1,19 @@
 import forImportLine from "./forImportLine/index.js";
 
-const startFunc = ({ inValue, temporaryValue, OutValue,
+import fileNamesJson from '../fileNames.json' with {type: 'json'};
+
+const startFunc = ({ inValue, OutValue,
     inFileType, inTargetPath }) => {
 
     const fromImportLine = forImportLine({
         inFileType, regexKey: "import",
         templateKey: "importRegex",
         inTargetPath, presentKey: "importLines",
-        inParts: [temporaryValue, inValue]
+        inParts: [`${fileNamesJson[inFileType]?.temporaryValue}${inValue}`, inValue]
     });
 
     const fromUseLine = forImportLine({
-        inParts: [temporaryValue, OutValue],
+        inParts: [`${fileNamesJson[inFileType]?.temporaryValue}${inValue}`, OutValue],
         inFileType, regexKey: "consumption",
         templateKey: "consumptionRegex",
         inTargetPath, presentKey: "useLines"

package/bin/{v23 → v25}/start.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "express-fix-any-js",
-  "version": "1.24.4",
+  "version": "1.25.2",
   "description": "CLI to build for appjs, the endpoints",
   "keywords": [
     "cli",
@@ -10,7 +10,7 @@
     "project-generator"
   ],
   "dependencies": {
-    "pattern-collector-anyjs-story": "^1.21.2"
+    "pattern-collector-anyjs-story": "^1.21.4"
   },
   "type": "module",
   "exports": {

package/bin/v23/alterFile/start.js

@@ -1,28 +0,0 @@
-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/fileNames.json

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