express-fix-endpoints-post-js 1.2.2

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,77 @@
+# EndPoints Fix
+
+Utility for automatically maintaining Express route files.
+
+## Purpose
+
+This module updates `end-points.js` files by:
+
+* Adding new route handlers
+* Preventing duplicate routes
+* Preserving route order
+* Maintaining consistent formatting
+
+---
+
+## Generated Structure
+
+```js
+import express from "express";
+
+const tableName = "BillsTable";
+
+const router = express.Router();
+
+router.post("/Alter", express.json(), (req, res) =>
+    AlterFunc({ req, res, inTablePath: tablePath })
+);
+
+export { router };
+```
+
+---
+
+## Rules
+
+### First Route
+
+When the first route is inserted:
+
+* Add one blank line after `const router = express.Router();`
+* Add one blank line before `export { router };`
+
+Example:
+
+```js
+const router = express.Router();
+
+router.post("/Alter", express.json(), handler);
+
+export { router };
+```
+
+### Additional Routes
+
+New routes are always appended after the last route.
+
+Example:
+
+```js
+router.post("/Alter", express.json(), handler);
+router.post("/Alter1", express.json(), handler);
+router.post("/Alter2", express.json(), handler);
+```
+
+No blank lines are inserted between routes.
+
+---
+
+## Duplicate Protection
+
+If a route already exists, no new route is added.
+
+---
+
+## Goal
+
+Produce clean and predictable Express route files automatically.

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/checkLines copy.json

@@ -0,0 +1,18 @@
+{
+    "importLines": {
+        "toInsertLine": "import funcFrom${folderName} from './${folderName}/controller.js';",
+        "duplicationCheck": "from './${folderName}/controller.js'",
+        "insertAfter": [
+            "import funcFrom",
+            "import express"
+        ]
+    },
+    "useLines": {
+        "toInsertLine": "router.get('/${endpoint}', (req, res) => funcFrom${folderName}({ req, res, inTablePath: tablePath }));",
+        "duplicationCheck": "router.get('/${endpoint}'",
+        "insertAfter": [
+            "router.",
+            "const router = "
+        ]
+    }
+}

package/bin/v1/UpdateJs/checkLines.json

@@ -0,0 +1,38 @@
+{
+    "simple": {
+        "importLines": {
+            "toInsertLine": "import funcFrom${folderName} from './${folderName}/controller.js';",
+            "duplicationCheck": "from './${folderName}/controller.js'",
+            "insertAfter": [
+                "import funcFrom",
+                "import express"
+            ]
+        },
+        "useLines": {
+            "toInsertLine": "router.get('/${endpoint}', (req, res) => funcFrom${folderName}({ req, res, inTablePath: tablePath }));",
+            "duplicationCheck": "router.get('/${endpoint}'",
+            "insertAfter": [
+                "router.",
+                "const router = "
+            ]
+        }
+    },
+    "withParams": {
+        "importLines": {
+            "toInsertLine": "import funcFrom${folderName} from './${folderName}/controller.js';",
+            "duplicationCheck": "from './${folderName}/controller.js'",
+            "insertAfter": [
+                "import funcFrom",
+                "import express"
+            ]
+        },
+        "useLines": {
+            "toInsertLine": "router.get('/${endpoint}/:pk', (req, res) => funcFrom${folderName}({ req, res, inTablePath: tablePath }));",
+            "duplicationCheck": "router.get('/${endpoint}'",
+            "insertAfter": [
+                "router.",
+                "const router = "
+            ]
+        }
+    }
+}

package/bin/v1/UpdateJs/index.js

@@ -0,0 +1,33 @@
+import fixAnyJs from "express-fix-any-js";
+import checkLines from "./checkLines.json" with {type: "json"};
+
+const alterLines = ({ inActionName, inFolderName, inGetType }) => {
+    let checkLinesData = checkLines;
+    let localCheckLines = checkLinesData[inGetType];
+    console.log("aaaaaaaaaa : ", inActionName, inFolderName, inGetType);
+
+    localCheckLines.importLines.toInsertLine = localCheckLines.importLines.toInsertLine.replaceAll("${folderName}", inFolderName);
+    localCheckLines.importLines.duplicationCheck = localCheckLines.importLines.duplicationCheck.replaceAll("${folderName}", inFolderName).replaceAll("'", '"');
+
+    localCheckLines.useLines.toInsertLine = localCheckLines.useLines.toInsertLine.replaceAll("${endpoint}", inActionName);
+    localCheckLines.useLines.toInsertLine = localCheckLines.useLines.toInsertLine.replaceAll("${folderName}", inFolderName);
+
+    localCheckLines.useLines.duplicationCheck = localCheckLines.useLines.duplicationCheck.replaceAll("${endpoint}", inActionName).replaceAll("'", '"');
+
+    return localCheckLines;
+};
+
+const startFunc = ({ inJsFilePath, inActionName, inFolderName, showLog = false, inGetType }) => {
+
+    const localCheckLines = alterLines({ inActionName, inFolderName, inGetType });
+
+    fixAnyJs({
+        showLog,
+        jsFilePath: inJsFilePath,
+        inCheckLines: localCheckLines
+    });
+
+    return false;
+};
+
+export default startFunc;

package/bin/v1/core/createFolder.js

@@ -0,0 +1,34 @@
+import fs from "fs";
+
+export const createFolder = ({ source, destination, checkBeforeCreate = false, isAnnounce = true }) => {
+    if (checkBeforeCreate) {
+        return createFolderWithCheck({ source, destination, isAnnounce });
+    } else {
+        return createOnly({ source, destination });
+    };
+};
+
+const createOnly = ({ source, destination }) => {
+    fs.mkdirSync(destination, { recursive: true });
+
+    fs.cpSync(source, destination, { recursive: true });
+
+    return {
+        KTF: true
+    };
+};
+
+const createFolderWithCheck = ({ source, destination, isAnnounce }) => {
+    if (fs.existsSync(destination)) {
+        if (isAnnounce) console.log("Folder already exists :", destination);
+
+        return {
+            KTF: false,
+            KReason: "Folder already exists"
+        };
+    };
+
+    if (isAnnounce) console.log("Folder created :", destination);
+
+    return createOnly({ source, destination });
+};

package/bin/v1/core/parseInput.js

@@ -0,0 +1,13 @@
+export default function parseInput({ jsFilePath, inGetType = "simple",
+    showLog, inActionName = "KeshavSoftAction", inFolderName = "KeshavSoftFolderName" }) {
+
+    const [...args] = process.argv.slice(2);
+
+    return {
+        showLog: args[1] === undefined
+            ? showLog
+            : args[1] === "true",
+        inJsFilePath: jsFilePath || process.cwd(),
+        inActionName, inFolderName, inGetType
+    };
+};

package/bin/v1/core/showUsage.js

@@ -0,0 +1,50 @@
+/*
+KSchema CLI – Entry Flow
+
+1. Read user input from terminal (parseInput)
+2. If no command → show usage (first-time user safety)
+3. If help flags → show usage (quick guidance)
+4. Resolve command dynamically (no hardcoding logic)
+5. If command not found → inform + guide back to usage
+6. Execute command with parsed input
+
+Goal:
+- Zero confusion for user
+- Single source of truth (showUsage)
+- Easy to extend (just add commands, no core changes)
+*/
+
+export default function showUsage(version) {
+    const g = "\x1b[32m";
+    const y = "\x1b[33m";
+    const c = "\x1b[36m";
+    const gray = "\x1b[90m";
+    const r = "\x1b[0m";
+
+    console.log(`
+${c}🚀 KSchema Api Generator v${version}${r}
+
+${y}Usage:${r}
+  ${g}npx @keshavsoft/kschema-api-gen${r} <command> [options]
+
+${y}Commands:${r}
+  ${g}StartEndPoint${r}     Initialize a new folder and files
+  ${g}AddSubRoute${r}       Initialize a new folder and files
+  ${g}AddTableName${r}      Initialize a new folder and files for TableName
+  ${g}ShowAll${r}           Initialize a new folder and files for action
+  
+  ${g}CreateApi${r}         Creates new end point and hooks to app.js
+  ${g}InsertApi${r}         Creates new InsertApi end point and hooks to app.js
+  
+${y}Examples:${r}
+  ${gray}npx @keshavsoft/kschema-api-gen StartEndPoint${r}
+  ${gray}npx @keshavsoft/kschema-api-gen AddSubRoute${r}
+  ${gray}npx @keshavsoft/kschema-api-gen AddTableName${r}
+  ${gray}npx @keshavsoft/kschema-api-gen ShowAll${r}
+  ${gray}npx @keshavsoft/kschema-api-gen CreateApi Api/V1/journals/ShowAll${r}
+  ${gray}npx @keshavsoft/kschema-api-gen InsertApi Api/V1/journals/Insert${r}
+
+${y}Tip:${r}
+  ${gray}npm i -g @keshavsoft/kschema-api-gen${r}
+`);
+}

package/bin/v1/start.js

@@ -0,0 +1,21 @@
+import parseInput from "./core/parseInput.js";
+import showUsage from './core/showUsage.js';
+
+import updateJs from "./UpdateJs/index.js";
+
+import pkg from '../../package.json' with { type: 'json' };
+
+const version = pkg.version;
+
+const run = ({ endPointsJsPath, showLog, inActionName, inFolderName, inGetType }) => {
+  const input = parseInput({
+    jsFilePath: endPointsJsPath, showLog,
+    inActionName, inFolderName, inGetType
+  });
+
+  if (input.cmd === "--help" || input.cmd === "-h" || input.cmd === "help") return showUsage(version);
+
+  updateJs(input);
+};
+
+export default run;

package/bin/v2/UpdateJs/checkLines.json

@@ -0,0 +1,38 @@
+{
+    "simple": {
+        "importLines": {
+            "toInsertLine": "import funcFrom${folderName} from './${folderName}/controller.js';",
+            "duplicationCheck": "from './${folderName}/controller.js'",
+            "insertAfter": [
+                "import funcFrom",
+                "import express"
+            ]
+        },
+        "useLines": {
+            "toInsertLine": "router.post('/${endpoint}', (req, res) => funcFrom${folderName}({ req, res, inTablePath: tablePath }));",
+            "duplicationCheck": "router.post('/${endpoint}'",
+            "insertAfter": [
+                "router.",
+                "const router = "
+            ]
+        }
+    },
+    "bodyParse": {
+        "importLines": {
+            "toInsertLine": "import funcFrom${folderName} from './${folderName}/controller.js';",
+            "duplicationCheck": "from './${folderName}/controller.js'",
+            "insertAfter": [
+                "import funcFrom",
+                "import express"
+            ]
+        },
+        "useLines": {
+            "toInsertLine": "router.post('/${endpoint}/:pk', express.json(), (req, res) => funcFrom${folderName}({ req, res, inTablePath: tablePath }));",
+            "duplicationCheck": "router.post('/${endpoint}'",
+            "insertAfter": [
+                "router.",
+                "const router = "
+            ]
+        }
+    }
+}

package/bin/v2/UpdateJs/index.js

@@ -0,0 +1,33 @@
+import fixAnyJs from "express-fix-any-js";
+import checkLines from "./checkLines.json" with {type: "json"};
+
+const alterLines = ({ inActionName, inFolderName, inGetType }) => {
+    let checkLinesData = checkLines;
+    let localCheckLines = checkLinesData[inGetType];
+    // console.log("aaaaaaaaaa : ", inActionName, inFolderName, inGetType);
+
+    localCheckLines.importLines.toInsertLine = localCheckLines.importLines.toInsertLine.replaceAll("${folderName}", inFolderName);
+    localCheckLines.importLines.duplicationCheck = localCheckLines.importLines.duplicationCheck.replaceAll("${folderName}", inFolderName).replaceAll("'", '"');
+
+    localCheckLines.useLines.toInsertLine = localCheckLines.useLines.toInsertLine.replaceAll("${endpoint}", inActionName);
+    localCheckLines.useLines.toInsertLine = localCheckLines.useLines.toInsertLine.replaceAll("${folderName}", inFolderName);
+
+    localCheckLines.useLines.duplicationCheck = localCheckLines.useLines.duplicationCheck.replaceAll("${endpoint}", inActionName).replaceAll("'", '"');
+
+    return localCheckLines;
+};
+
+const startFunc = ({ inJsFilePath, inActionName, inFolderName, showLog = false, inGetType }) => {
+
+    const localCheckLines = alterLines({ inActionName, inFolderName, inGetType });
+
+    fixAnyJs({
+        showLog,
+        jsFilePath: inJsFilePath,
+        inCheckLines: localCheckLines
+    });
+
+    return false;
+};
+
+export default startFunc;

package/bin/v2/core/createFolder.js

@@ -0,0 +1,34 @@
+import fs from "fs";
+
+export const createFolder = ({ source, destination, checkBeforeCreate = false, isAnnounce = true }) => {
+    if (checkBeforeCreate) {
+        return createFolderWithCheck({ source, destination, isAnnounce });
+    } else {
+        return createOnly({ source, destination });
+    };
+};
+
+const createOnly = ({ source, destination }) => {
+    fs.mkdirSync(destination, { recursive: true });
+
+    fs.cpSync(source, destination, { recursive: true });
+
+    return {
+        KTF: true
+    };
+};
+
+const createFolderWithCheck = ({ source, destination, isAnnounce }) => {
+    if (fs.existsSync(destination)) {
+        if (isAnnounce) console.log("Folder already exists :", destination);
+
+        return {
+            KTF: false,
+            KReason: "Folder already exists"
+        };
+    };
+
+    if (isAnnounce) console.log("Folder created :", destination);
+
+    return createOnly({ source, destination });
+};

package/bin/v2/core/parseInput.js

@@ -0,0 +1,13 @@
+export default function parseInput({ jsFilePath, inGetType = "simple",
+    showLog, inActionName = "KeshavSoftAction", inFolderName = "KeshavSoftFolderName" }) {
+
+    const [...args] = process.argv.slice(2);
+
+    return {
+        showLog: args[1] === undefined
+            ? showLog
+            : args[1] === "true",
+        inJsFilePath: jsFilePath || process.cwd(),
+        inActionName, inFolderName, inGetType
+    };
+};

package/bin/v2/core/showUsage.js

@@ -0,0 +1,50 @@
+/*
+KSchema CLI – Entry Flow
+
+1. Read user input from terminal (parseInput)
+2. If no command → show usage (first-time user safety)
+3. If help flags → show usage (quick guidance)
+4. Resolve command dynamically (no hardcoding logic)
+5. If command not found → inform + guide back to usage
+6. Execute command with parsed input
+
+Goal:
+- Zero confusion for user
+- Single source of truth (showUsage)
+- Easy to extend (just add commands, no core changes)
+*/
+
+export default function showUsage(version) {
+    const g = "\x1b[32m";
+    const y = "\x1b[33m";
+    const c = "\x1b[36m";
+    const gray = "\x1b[90m";
+    const r = "\x1b[0m";
+
+    console.log(`
+${c}🚀 KSchema Api Generator v${version}${r}
+
+${y}Usage:${r}
+  ${g}npx @keshavsoft/kschema-api-gen${r} <command> [options]
+
+${y}Commands:${r}
+  ${g}StartEndPoint${r}     Initialize a new folder and files
+  ${g}AddSubRoute${r}       Initialize a new folder and files
+  ${g}AddTableName${r}      Initialize a new folder and files for TableName
+  ${g}ShowAll${r}           Initialize a new folder and files for action
+  
+  ${g}CreateApi${r}         Creates new end point and hooks to app.js
+  ${g}InsertApi${r}         Creates new InsertApi end point and hooks to app.js
+  
+${y}Examples:${r}
+  ${gray}npx @keshavsoft/kschema-api-gen StartEndPoint${r}
+  ${gray}npx @keshavsoft/kschema-api-gen AddSubRoute${r}
+  ${gray}npx @keshavsoft/kschema-api-gen AddTableName${r}
+  ${gray}npx @keshavsoft/kschema-api-gen ShowAll${r}
+  ${gray}npx @keshavsoft/kschema-api-gen CreateApi Api/V1/journals/ShowAll${r}
+  ${gray}npx @keshavsoft/kschema-api-gen InsertApi Api/V1/journals/Insert${r}
+
+${y}Tip:${r}
+  ${gray}npm i -g @keshavsoft/kschema-api-gen${r}
+`);
+}

package/bin/v2/start.js

@@ -0,0 +1,21 @@
+import parseInput from "./core/parseInput.js";
+import showUsage from './core/showUsage.js';
+
+import updateJs from "./UpdateJs/index.js";
+
+import pkg from '../../package.json' with { type: 'json' };
+
+const version = pkg.version;
+
+const run = ({ endPointsJsPath, showLog, inActionName, inFolderName, inGetType }) => {
+  const input = parseInput({
+    jsFilePath: endPointsJsPath, showLog,
+    inActionName, inFolderName, inGetType
+  });
+
+  if (input.cmd === "--help" || input.cmd === "-h" || input.cmd === "help") return showUsage(version);
+
+  updateJs(input);
+};
+
+export default run;

package/index.js

@@ -0,0 +1,16 @@
+import getLatestVersion from "./bin/core/getLatestVersion.js";
+
+const load = async ({ endPointsJsPath, inActionName, showLog, inFolderName,
+    inGetType }) => {
+
+    const v = getLatestVersion();
+
+    const module = await import(`./bin/${v}/start.js`);
+
+    await module.default({
+        endPointsJsPath, inFolderName,
+        inActionName, showLog, inGetType
+    });
+};
+
+export default load;

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "express-fix-endpoints-post-js",
+  "version": "1.2.2",
+  "description": "CLI to build for appjs, the endpoints",
+  "keywords": [
+    "cli",
+    "scaffold",
+    "templates",
+    "node",
+    "project-generator"
+  ],
+  "dependencies": {
+    "express-fix-any-js": "^1.3.3"
+  },
+  "type": "module",
+  "exports": {
+    ".": "./index.js"
+  },
+  "bin": {
+    "express-fix-endpoints-post-js": "./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-endpoints-post-js"
+  },
+  "bugs": {
+    "url": "https://github.com/keshavsoft/express-fix-endpoints-post-js/issues"
+  }
+}