json-crud-ui 1.1.1

package/bin/v11/tasks/tables/AddTableName/steps/resolveFolderName.js

@@ -0,0 +1,20 @@
+import fs from "fs";
+
+export default function resolveFolderName({ name }) {
+    const defaultFolerName = "KSTable1";
+
+    // case 1: force new → timestamp
+    if (name === null) {
+        name = defaultFolerName;
+    };
+
+    // case 2: user provided → strict
+    if (fs.existsSync(name)) {
+        return {
+            KTF: false,
+            KReason: `Folder already exists : ${name}`
+        };
+    };
+
+    return name;
+};

package/bin/v11/tasks/tables/AddTableName/steps/updateConfig.js

@@ -0,0 +1,16 @@
+import fs from "fs";
+import path from "path";
+
+export function updateConfigFile({ inEndpointFolder, inTableName }) {
+    const filePath = path.join(inEndpointFolder, "Config", "schema.json");
+
+    // Read Synchronously
+    const rawData = fs.readFileSync(filePath);
+    const data = JSON.parse(rawData);
+    data.tableName = `${inTableName}.json`;
+
+    // // Write Synchronously
+    const jsonString = JSON.stringify(data, null, 2);
+    fs.writeFileSync(filePath, jsonString);
+
+};

package/bin/v11/tasks/tables/AddTableName/steps/updateEndPointsFile.js

@@ -0,0 +1,30 @@
+import fs from 'fs';
+
+function updateEndPointsFile({ filePath, inTableName }) {
+    try {
+        let content = readFile(filePath);
+
+        content = content.replace("<TABLE_NAME>", inTableName);
+
+        writeFile(filePath, content);
+    } catch (e) {
+        handleError(e);
+    };
+};
+
+// read
+function readFile(filePath) {
+    return fs.readFileSync(filePath, "utf-8");
+};
+
+// write
+function writeFile(filePath, content) {
+    fs.writeFileSync(filePath, content);
+};
+
+// error handler
+function handleError(e) {
+    console.error("ROUTE USE ERROR:", e.message);
+};
+
+export { updateEndPointsFile };

package/bin/v11/tasks/tables/AddTableName/steps/updateTableName.js

@@ -0,0 +1,30 @@
+import fs from 'fs';
+
+function startFunc({ filePath, inTableName }) {
+    try {
+        let content = readFile(filePath);
+
+        content = content.replace("<TABLE_NAME>", inTableName);
+
+        writeFile(filePath, content);
+    } catch (e) {
+        handleError(e);
+    };
+};
+
+// read
+function readFile(filePath) {
+    return fs.readFileSync(filePath, "utf-8");
+};
+
+// write
+function writeFile(filePath, content) {
+    fs.writeFileSync(filePath, content);
+};
+
+// error handler
+function handleError(e) {
+    console.error("ROUTE USE ERROR:", e.message);
+};
+
+export default startFunc;

package/bin/v11/tasks/tables/AddTableName/template/Config/schema.json

@@ -0,0 +1,3 @@
+{
+    "tableName": "<KSTable.json>"
+}

package/bin/v11/tasks/tables/AddTableName/template/end-points.js

@@ -0,0 +1,7 @@
+import express from 'express';
+
+const tableName = "<TABLE_NAME>";
+
+const router = express.Router();
+
+export { router };

package/bin/v11/tasks/tables/addTableName.js

@@ -0,0 +1,56 @@
+import { locateSource } from "./AddTableName/steps/locateSource.js";
+import { locateDestination } from "./AddTableName/steps/locateDestination.js";
+import { createFolder } from "../../core/createFolder.js";
+import UpdateRoutesJs from "./AddTableName/steps/UpdateRoutesJs/index.js";
+import { updateEndPointsFile } from "./AddTableName/steps/updateEndPointsFile.js";
+import { updateConfigFile } from "./AddTableName/steps/updateConfig.js";
+
+import { announce } from "./AddTableName/steps/announce.js";
+
+import resolveFolderName from "./AddTableName/steps/resolveFolderName.js";
+
+export default ({ folderName = "", toPath, isAnnounce = true, checkBeforeCreate = true }) => {
+    const localToPath = toPath;
+
+    const resolvedFolderName = resolveFolderName({
+        name: folderName
+    });
+
+    if (resolvedFolderName.KTF === false) {
+        console.log(resolvedFolderName.KReason);
+
+        return folderName;
+    };
+
+    const source = locateSource();
+    const destination = locateDestination({
+        inResolvedFolderName: resolvedFolderName,
+        toPath: localToPath
+    });
+
+    const createFolderResponse = createFolder({
+        source, destination,
+        isAnnounce, checkBeforeCreate
+    });
+
+    if (createFolderResponse.KTF) {
+        UpdateRoutesJs({
+            appJsPath: `${localToPath}/routes.js`,
+            endpoint: resolvedFolderName
+        });
+
+        updateEndPointsFile({
+            filePath: `${destination}/end-points.js`,
+            inTableName: resolvedFolderName
+        });
+
+        updateConfigFile({
+            inEndpointFolder: destination,
+            inTableName: resolvedFolderName
+        });
+    };
+
+    if (isAnnounce) announce({ inResolvedFolderName: resolvedFolderName });
+
+    return resolvedFolderName;
+};

package/bin/v12/commands/loadCommand.js

@@ -0,0 +1,7 @@
+// bin/v11/commands/loadCommand.js
+
+import endPointsJs from "../tasks/actions/EndPointsJs/index.js"
+
+export default async function loadCommand(name) {
+    await endPointsJs({ action: name });
+};

package/bin/v12/config/actions.json

@@ -0,0 +1,46 @@
+[
+    {
+        "cmd": "ShowAll",
+        "file": "showAll",
+        "exportFile": "ShowAll",
+        "group": "GetMethods",
+        "description": "Generate ShowAll GET action",
+        "endPointsJs": {
+            "importLine": "import { getFunc } from './ShowAll/controller.js';",
+            "usageLine": "router.get('/ShowAll', (req, res) => getFunc({ res, inTableName : tableName}));"
+        }
+    },
+    {
+        "cmd": "Insert",
+        "file": "insert",
+        "exportFile": "Insert",
+        "group": "PostMethods",
+        "description": "Generate Insert POST action",
+        "endPointsJs": {
+            "importLine": "import { postFunc } from './Insert/controller.js';",
+            "usageLine": "router.post('/Insert', express.json(), (req, res) => postFunc({ req, res, inTableName : tableName}));"
+        }
+    },
+    {
+        "cmd": "Distinct",
+        "file": "distinct",
+        "exportFile": "Distinct",
+        "group": "GetMethods",
+        "description": "Generate Distinct GET action",
+        "endPointsJs": {
+            "importLine": "import distinctFunc from './Distinct/controller.js';",
+            "usageLine": "router.get('/Distinct/:columnName', (req, res) => distinctFunc({ req, res, inTableName : tableName}));"
+        }
+    },
+    {
+        "cmd": "FilterColumns",
+        "file": "filterColumns",
+        "exportFile": "FilterColumns",
+        "group": "PostMethods",
+        "description": "Generate FilterColumns POST action",
+        "endPointsJs": {
+            "importLine": "import filterColumnsFunc from './FilterColumns/controller.js';",
+            "usageLine": "router.post('/FilterColumns', express.json(), (req, res) => filterColumnsFunc({ req, res, inTableName : tableName}));"
+        }
+    }
+]

package/bin/v12/config/actionsV1.json

@@ -0,0 +1,20 @@
+[
+    {
+        "cmd": "showAll",
+        "file": "showAll",
+        "exportFile": "ShowAll",
+        "group": "GetMethods"
+    },
+    {
+        "cmd": "insert",
+        "file": "insert",
+        "exportFile": "Insert",
+        "group": "PostMethods"
+    },
+    {
+        "cmd": "distinct",
+        "file": "distinct",
+        "exportFile": "Distinct",
+        "group": "GetMethods"
+    }
+]

package/bin/v12/config/actionsV2.json

@@ -0,0 +1,27 @@
+[
+    {
+        "cmd": "ShowAll",
+        "file": "showAll",
+        "exportFile": "ShowAll",
+        "group": "GetMethods",
+        "description": "Generate ShowAll GET action",
+        "endPointsJs": {
+            "importLine": "import { getFunc } from './ShowAll/controller.js';",
+            "usageLine": "router.get('/ShowAll', (req, res) => getFunc({ res, inTableName : tableName}));"
+        }
+    },
+    {
+        "cmd": "Insert",
+        "file": "insert",
+        "exportFile": "Insert",
+        "group": "PostMethods",
+        "description": "Generate Insert POST action"
+    },
+    {
+        "cmd": "Distinct",
+        "file": "distinct",
+        "exportFile": "Distinct",
+        "group": "GetMethods",
+        "description": "Generate Distinct GET action"
+    }
+]

package/bin/v12/config/actionsV3.json

@@ -0,0 +1,35 @@
+[
+    {
+        "cmd": "ShowAll",
+        "file": "showAll",
+        "exportFile": "ShowAll",
+        "group": "GetMethods",
+        "description": "Generate ShowAll GET action",
+        "endPointsJs": {
+            "importLine": "import { getFunc } from './ShowAll/controller.js';",
+            "usageLine": "router.get('/ShowAll', (req, res) => getFunc({ res, inTableName : tableName}));"
+        }
+    },
+    {
+        "cmd": "Insert",
+        "file": "insert",
+        "exportFile": "Insert",
+        "group": "PostMethods",
+        "description": "Generate Insert POST action",
+        "endPointsJs": {
+            "importLine": "import { postFunc } from './Insert/controller.js';",
+            "usageLine": "router.post('/Insert', express.json(), (req, res) => postFunc({ req, res, inTableName : tableName}));"
+        }
+    },
+    {
+        "cmd": "Distinct",
+        "file": "distinct",
+        "exportFile": "Distinct",
+        "group": "GetMethods",
+        "description": "Generate Distinct GET action",
+        "endPointsJs": {
+            "importLine": "import { getFunc } from './Distinct/controller.js';",
+            "usageLine": "router.get('/Distinct/:columnName', (req, res) => getFunc({ req, res, inTableName : tableName}));"
+        }
+    }
+]

package/bin/v12/config/actionsV4.json

@@ -0,0 +1,35 @@
+[
+    {
+        "cmd": "ShowAll",
+        "file": "showAll",
+        "exportFile": "ShowAll",
+        "group": "GetMethods",
+        "description": "Generate ShowAll GET action",
+        "endPointsJs": {
+            "importLine": "import { getFunc } from './ShowAll/controller.js';",
+            "usageLine": "router.get('/ShowAll', (req, res) => getFunc({ res, inTableName : tableName}));"
+        }
+    },
+    {
+        "cmd": "Insert",
+        "file": "insert",
+        "exportFile": "Insert",
+        "group": "PostMethods",
+        "description": "Generate Insert POST action",
+        "endPointsJs": {
+            "importLine": "import { postFunc } from './Insert/controller.js';",
+            "usageLine": "router.post('/Insert', express.json(), (req, res) => postFunc({ req, res, inTableName : tableName}));"
+        }
+    },
+    {
+        "cmd": "Distinct",
+        "file": "distinct",
+        "exportFile": "Distinct",
+        "group": "GetMethods",
+        "description": "Generate Distinct GET action",
+        "endPointsJs": {
+            "importLine": "import distinctFunc from './Distinct/controller.js';",
+            "usageLine": "router.get('/Distinct/:columnName', (req, res) => distinctFunc({ req, res, inTableName : tableName}));"
+        }
+    }
+]

package/bin/v12/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/v12/core/parseInput.js

@@ -0,0 +1,8 @@
+export default function parseInput() {
+    const [action] = process.argv.slice(2);
+
+    return {
+        action: action || null,
+        toPath: process.cwd()
+    };
+};

package/bin/v12/core/resolveCommand.js

@@ -0,0 +1,13 @@
+// import endPointsJs from "../tasks/actions/EndPointsJs/ShowAll/index.js";
+import appJs from "../tasks/actions/appJs.js";
+import endPointsJs from "../tasks/actions/EndPointsJs/index.js";
+
+// resolveCommand.js
+const map = {
+    endPointsJs,
+    appJs
+};
+
+export default function resolveCommand(cmd) {
+    return map[cmd] || null;
+};

package/bin/v12/core/showUsage.js

@@ -0,0 +1,39 @@
+/*
+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}endPointsJs${r}     Checks for end-points.js file in that location
+
+${y}Examples:${r}
+  ${gray}npx @keshavsoft/kschema-api-gen endPointsJs ShowAll${r}
+
+${y}Tip:${r}
+  ${gray}npm i -g @keshavsoft/kschema-api-gen${r}
+`);
+}

package/bin/v12/start.js

@@ -0,0 +1,21 @@
+import parseInput from "./core/parseInput.js";
+import showUsage from './core/showUsage.js';
+
+import resolveCommand from "./tasks/actions/EndPointsJs/index.js";
+
+import pkg from '../../package.json' with { type: 'json' };
+
+const version = pkg.version;
+
+const run = async () => {
+  const input = parseInput();
+
+  if (input.action === "--help" || input.action === "-h" || input.action === "help") return showUsage(version);
+
+  await resolveCommand({
+    action: input.action,
+    toPath: input.toPath
+  });
+};
+
+export default run;

package/bin/v12/tasks/actions/EndPointsJs/AlterJsFile/index.js

@@ -0,0 +1,31 @@
+// bin/v9/tasks/actions/EndPointsJs/index.js
+
+import SourceEditor from "../../../common/SourceEditor.js";
+
+import insertImport from "./insertImport.js";
+import insertUsage from "./insertUsage.js";
+
+export default ({ inImportLine, inUsageLine, toPath }) => {
+
+    const path = `${toPath}/end-points.js`;
+
+    const editor = new SourceEditor(path);
+
+    const importLine = inImportLine;
+
+    const usageLine = inUsageLine;
+
+    insertImport({
+        editor,
+        importLine
+    });
+
+    editor.save();
+
+    insertUsage({
+        editor,
+        usageLine
+    });
+
+    editor.save();
+};

package/bin/v12/tasks/actions/EndPointsJs/AlterJsFile/insertImport.js

@@ -0,0 +1,15 @@
+// insertImport.js
+
+export default ({ editor, importLine }) => {
+
+    if (!editor.hasLine(importLine)) {
+
+        const lastImportLine =
+            editor.findLastLine("import ");
+
+        editor.insertAfter({
+            line: lastImportLine,
+            content: importLine
+        });
+    };
+};

package/bin/v12/tasks/actions/EndPointsJs/AlterJsFile/insertUsage.js

@@ -0,0 +1,15 @@
+// insertUsage.js
+export default ({ editor, usageLine }) => {
+
+    if (!editor.hasLine(usageLine)) {
+
+        const exportLine =
+            editor.findLastLine("const router = ");
+        console.log("exportLine : ", exportLine);
+
+        editor.insertAfter({
+            line: exportLine,
+            content: usageLine
+        });
+    };
+};

package/bin/v12/tasks/actions/EndPointsJs/index.js

@@ -0,0 +1,19 @@
+// bin/v11/tasks/actions/EndPointsJs/index.js
+
+import showUsage from "./showUsage.js";
+import actions from "../../../config/actions.json" with { type: "json" };
+import alterJsFile from "./AlterJsFile/index.js";
+
+export default async ({ action, toPath }) => {
+    const matchedAction = actions.find(
+        ({ cmd }) => cmd === action
+    );
+
+    if (matchedAction) {
+        alterJsFile({
+            inImportLine: matchedAction.endPointsJs.importLine,
+            inUsageLine: matchedAction.endPointsJs.usageLine,
+            toPath
+        });
+    };
+};

package/bin/v12/tasks/actions/EndPointsJs/showUsage.js

@@ -0,0 +1,38 @@
+/*
+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() {
+    const g = "\x1b[32m";
+    const y = "\x1b[33m";
+    const c = "\x1b[36m";
+    const gray = "\x1b[90m";
+    const r = "\x1b[0m";
+
+    console.log(`
+${y}Usage:${r}
+  ${g}npx kschema-api-gen endPointsJs${r} [options]
+
+${y}options:${r}
+  ${g}ShowAll${r}     the action for get
+  ${g}Insert${r}      the action for post
+  ${g}Distinct${r}    the action for get and request param columnName
+
+${y}Examples:${r}
+  ${gray}npx kschema-api-gen endPointsJs ShowAll${r}
+  ${gray}npx kschema-api-gen endPointsJs Insert${r}
+  ${gray}npx kschema-api-gen endPointsJs Distinct${r}
+`);
+}

package/bin/v12/tasks/actions/appJs.js

@@ -0,0 +1,6 @@
+import path from "path";
+
+export default ({ action = "", toPath, cmd, isAnnounce = true, checkBeforeCreate = true }) => {
+    const localToPath = toPath;
+    console.log("    aaaaaaaaa :", cmd, action, toPath);
+};

package/bin/v12/tasks/common/SourceEditor.js

@@ -0,0 +1,66 @@
+// SourceEditor.js
+
+import fs from "fs";
+
+class SourceEditor {
+
+    constructor(path) {
+
+        this.path = path;
+
+        this.content = fs.readFileSync(path, "utf-8");
+
+        this.lines = this.content.split("\n");
+    };
+
+    findLine(searchText) {
+
+        const index = this.lines.findIndex(line =>
+            line.includes(searchText)
+        );
+
+        return index === -1
+            ? null
+            : index + 1;
+    };
+
+    findLastLine(searchText) {
+
+        let found = null;
+
+        this.lines.forEach((line, index) => {
+
+            if (line.includes(searchText)) {
+
+                found = index + 1;
+            };
+        });
+
+        return found;
+    };
+
+    hasLine(searchText) {
+
+        return this.findLine(searchText) !== null;
+    };
+
+    insertAfter({ line, content }) {
+
+        this.lines.splice(line, 0, content);
+    };
+
+    insertBefore({ line, content }) {
+
+        this.lines.splice(line - 1, 0, content);
+    };
+
+    save() {
+
+        fs.writeFileSync(
+            this.path,
+            this.lines.join("\n")
+        );
+    };
+};
+
+export default SourceEditor;

package/bin/v12/tasks/tables/AddTableName/steps/UpdateRoutesJs/common/readFile.js

@@ -0,0 +1,8 @@
+import fs from "fs";
+
+const readFile = (inAppJsPath) => {
+    const localPath = inAppJsPath;
+    return fs.readFileSync(localPath, "utf-8");
+};
+
+export default readFile;