kschema-fs-api-gen-get-actions 1.3.2

package/bin/v2/tasks/actions/ShowAll/steps/UpdateRoutesJs/updateUse/index.js

@@ -0,0 +1,56 @@
+import readFile from "../common/readFile.js";
+import writeFile from "../common/writeFile.js";
+
+import buildUseLine from "./buildUseLine.js";
+import checkDuplicate from "./checkDuplicate.js";
+import findUseInsertIndex from "./findInsertIndex.js";
+
+const appOrRouter = "router";
+
+const updateAppUse = ({ appJsPath, endpoint, showLog, inFuncName }) => {
+    const summary = {
+        use: { added: false, skipped: false, line: null }
+    };
+
+    const content = readFile(appJsPath);
+
+    const useLine = buildUseLine({
+        inAppOrRouter: appOrRouter,
+        inEndpoint: endpoint,
+        inFuncName
+    });
+
+    const fromCheckDuplicate = checkDuplicate({
+        inContent: content,
+        inEndpoint: endpoint,
+        inAppOrRouter: appOrRouter
+    });
+    console.log("fromCheckDuplicate : ", fromCheckDuplicate);
+
+    if (fromCheckDuplicate) {
+        summary.use.skipped = true;
+
+        if (showLog) console.log(summary);
+
+        return summary;
+    };
+
+    const index = findUseInsertIndex(content);
+
+    const before = content.slice(0, index);
+    const lineNumber = before.split("\n").length + 1;
+
+    const updated =
+        before + "\n" + useLine + content.slice(index);
+
+    writeFile(appJsPath, updated);
+
+    summary.use.added = true;
+    summary.use.line = lineNumber;
+
+    if (showLog) console.log(summary);
+
+    return summary;
+};
+
+export default updateAppUse;

package/bin/v2/tasks/actions/ShowAll/steps/announce.js

@@ -0,0 +1,9 @@
+export const announce = ({ inResolvedFolderName }) => {
+    console.log(`[keshavsoft] Folder created: ${inResolvedFolderName}`);
+
+    console.log("");
+    console.log("Next:");
+    console.log("");
+    console.log(`cd ${inResolvedFolderName}`);
+    console.log(`npx kschema-api-gen AddSubRoute`);
+};

package/bin/v2/tasks/actions/ShowAll/steps/createFolder.js

@@ -0,0 +1,7 @@
+import fs from "fs";
+
+export const createFolder = ({ source, destination }) => {
+    fs.mkdirSync(destination, { recursive: true });
+
+    fs.cpSync(source, destination, { recursive: true });
+};

package/bin/v2/tasks/actions/ShowAll/steps/decideTemplate.js

@@ -0,0 +1,3 @@
+export const decideTemplate = ({ inTemplate }) => {
+    return inTemplate || "basic";
+};

package/bin/v2/tasks/actions/ShowAll/steps/locateDestination.js

@@ -0,0 +1,7 @@
+import path from "path";
+
+export const locateDestination = ({ inResolvedFolderName, toPath }) => {
+    const localToPath = toPath;
+
+    return path.join(localToPath, inResolvedFolderName);
+};

package/bin/v2/tasks/actions/ShowAll/steps/locateSource.js

@@ -0,0 +1,18 @@
+import fs from "fs";
+import path from "path";
+import { fileURLToPath } from "url";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+export const locateSource = () => {
+    const templatePath = path.join(__dirname, "..", "template");
+
+    const versions = fs.readdirSync(templatePath);
+
+    const maxVersion = Math.max(
+        ...versions.map(v => Number(v.replace("v", "")))
+    );
+
+    return path.join(templatePath, `v${maxVersion}`);
+};

package/bin/v2/tasks/actions/ShowAll/steps/resolveFolderName.js

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

package/bin/v2/tasks/actions/ShowAll/steps/updateAppJs.js

@@ -0,0 +1,7 @@
+import updateImports from "./UpdateRoutesJs/updateImports/index.js";
+import updateAppUse from "./UpdateRoutesJs/updateUse/index.js";
+
+export default ({ appJsPath, endpoint }) => {
+    updateImports({ appJsPath, endpoint });
+    updateAppUse({ appJsPath, endpoint });
+};

package/bin/v2/tasks/actions/ShowAll/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/v2/tasks/actions/ShowAll/template/v2/controller.js

@@ -0,0 +1,24 @@
+import { startFunc as Service } from "./service.js";
+import { ConflictError, StorageError } from "./errors.js";
+
+const getFunc = async ({ req, res, inTablePath }) => {
+    try {
+        const fromService = await Service({
+            inTablePath
+        });
+
+        res.type("application/json").send(fromService);
+    } catch (err) {
+
+        if (err instanceof ConflictError)
+            return res.status(409).send(err.message);
+
+        if (err instanceof StorageError)
+            return res.status(500).send("Failed to persist data");
+
+        console.error(err);
+        res.status(500).send("Unexpected error");
+    }
+};
+
+export default getFunc;

package/bin/v2/tasks/actions/ShowAll/template/v2/errors.js

@@ -0,0 +1,11 @@
+class AppError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = this.constructor.name;
+    }
+}
+
+class ConflictError extends AppError { }
+class StorageError extends AppError { }
+
+export { AppError, ConflictError, StorageError };

package/bin/v2/tasks/actions/ShowAll/template/v2/getData.js

@@ -0,0 +1,11 @@
+import { JSONFilePreset } from 'lowdb/node'
+
+const startFunc = async ({ inTablePath }) => {
+    const db = await JSONFilePreset(inTablePath, []);
+
+    await db.read();
+
+    return await db.data;
+};
+
+export default startFunc;

package/bin/v2/tasks/actions/ShowAll/template/v2/service.js

@@ -0,0 +1,9 @@
+import getData from "./getData.js";
+
+const startFunc = async ({ inTablePath }) => {
+    const dataAsArray = await getData({ inTablePath });
+
+    return await dataAsArray;
+};
+
+export { startFunc };

package/bin/v2/tasks/actions/showAll.js

@@ -0,0 +1,63 @@
+import path from "path";
+
+import generateRest from "kschema-fs-api-gen-rest";
+import fixEndpointsJs from "express-fix-endpoints-js";
+
+import { locateSource } from "./ShowAll/steps/locateSource.js";
+import { locateDestination } from "./ShowAll/steps/locateDestination.js";
+import { createFolder } from "../../core/createFolder.js";
+
+import { announce } from "./ShowAll/steps/announce.js";
+
+import resolveFolderName from "./ShowAll/steps/resolveFolderName.js";
+import actions from "./ShowAll/actions.json" with { type: "json" };
+
+const startFunc = async ({ cmd = "", toPath, isAnnounce = true, checkBeforeCreate = true,
+    toConfigPath, inTargetPath, inGenerateRest = false
+}) => {
+
+    const matched = actions;
+
+    const localToPath = toPath;
+
+    const resolvedFolderName = resolveFolderName({
+        name: cmd
+    });
+
+    if (resolvedFolderName.KTF === false) {
+        console.log(resolvedFolderName.KReason);
+
+        return;
+    };
+
+    const source = locateSource();
+    const destination = locateDestination({
+        inResolvedFolderName: resolvedFolderName,
+        toPath: localToPath
+    });
+
+    const createFolderResponse = createFolder({
+        source, destination,
+        isAnnounce, checkBeforeCreate
+    });
+
+    if (createFolderResponse.KTF) {
+        const fromEndPointsJs = await fixEndpointsJs({
+            endPointsJsPath: path.join(localToPath, "end-points.js"),
+            inActionName: cmd
+        });
+
+        if (inGenerateRest) {
+            generateRest({
+                toConfigPath, inTargetPath,
+                toPath: path.join(localToPath, resolvedFolderName),
+            });
+        };
+    };
+
+    if (isAnnounce) announce({ inResolvedFolderName: resolvedFolderName });
+
+    return resolvedFolderName;
+};
+
+export default startFunc;

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

@@ -0,0 +1,12 @@
+export default function parseInput() {
+    const [cmd, ...args] = process.argv.slice(2);
+
+    return {
+        cmd: cmd || null,
+        args,
+        template: cmd || null,
+        folderName: args[0] || null,
+        argsAsIs: args[0] || null,
+        toPath: process.cwd()
+    };
+};

package/bin/v2/tasks/core/resolveCommand.js

@@ -0,0 +1,24 @@
+import StartEndPoint from "../commands/startEndPoint.js";
+import AddSubRoute from "../commands/addSubRoute.js";
+import AddTableName from "../tasks/tables/addTableName.js";
+// import ShowAll from "../commands/showAll.js";
+import Insert from "../tasks/actions/insert.js";
+import ShowAll from "../tasks/actions/showAll.js";
+
+import CreateApi from "../Orchestration/CreateApi/createApi.js";
+import InsertApi from "../Orchestration/InsertApi/insertApi.js";
+
+// resolveCommand.js
+const map = {
+    StartEndPoint,
+    AddSubRoute,
+    AddTableName,
+    ShowAll,
+    CreateApi,
+    InsertApi,
+    Insert
+};
+
+export default function resolveCommand(cmd) {
+    return map[cmd] || null;
+};

package/bin/v2/tasks/core/showUsage.js

@@ -0,0 +1,43 @@
+/*
+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}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 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/v3/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/v3/core/parseInput.js

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

package/bin/v3/core/resolveCommand.js

@@ -0,0 +1,11 @@
+import actions from "../config/actions.json" with { type: "json" };
+
+export default async function resolveCommand(cmd) {
+    const matched = actions.find(x => x.cmd === cmd);
+
+    if (!matched) return null;
+
+    const module = await import(`../tasks/actions/${matched.file}.js`);
+
+    return module.default;
+};

package/bin/v3/core/showUsage.js

@@ -0,0 +1,49 @@
+/*
+KSchema CLI – Execution Flow
+
+1. Parse terminal input
+2. Show usage if command/help missing
+3. Resolve command dynamically
+4. Load command dynamically
+5. Execute action
+
+Architecture Goals:
+- JSON driven command system
+- Zero hardcoded command maps
+- Single source of truth
+- Easy scalability
+- Beginner friendly structure
+*/
+import actions from "../config/actions.json" with { type: "json" };
+
+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";
+
+  const commandsText = actions.map((item) => {
+    return `  ${g}${item.exportFile}${r}     ${item.description}`;
+  }).join("\n");
+
+  const examplesText = actions.map((item) => {
+    return `  ${gray}npx @keshavsoft/kschema-api-gen-actions ${item.exportFile}${r}`;
+  }).join("\n");
+
+  console.log(`
+${c}🚀 KSchema Api Generator v${version}${r}
+
+${y}Usage:${r}
+  ${g}npx @keshavsoft/kschema-api-gen-actions${r} <command> [options]
+
+${y}Commands:${r}
+${commandsText}
+
+${y}Examples:${r}
+${examplesText}
+
+${y}Tip:${r}
+  ${gray}npm i -g @keshavsoft/kschema-api-gen-actions${r}
+`);
+}

package/bin/v3/start.js

@@ -0,0 +1,22 @@
+import parseInput from "./core/parseInput.js";
+import resolveCommand from "./core/resolveCommand.js";
+import showUsage from './core/showUsage.js';
+import pkg from '../../package.json' with { type: 'json' };
+
+const version = pkg.version;
+
+const run = async () => {
+  const input = parseInput();
+
+  if (!input.cmd) return showUsage(version);
+
+  if (input.cmd === "--help" || input.cmd === "-h" || input.cmd === "help") return showUsage(version);
+
+  const command = await resolveCommand(input.cmd);
+
+  if (!command) return (console.log(`Unknown command: ${input.cmd}\n`), showUsage(version));
+
+  await command(input);
+};
+
+export default run;

package/bin/v3/tasks/actions/ShowAll/actions.json

@@ -0,0 +1,26 @@
+    {
+        "cmd": "WithMail",
+        "file": "withMail",
+        "exportFile": "WithMail",
+        "group": "PostMethods",
+        "description": "Generate WithMail POST action",
+        "endPointsJs": {
+            "importLines": {
+                "toInsertLine": "import funcFromWithMail from './WithMail/controller.js';",
+                "duplicationCheck": "from './WithMail/controller.js'",
+                "insertAfter": [
+                    "import funcFrom",
+                    "import express"
+                ]
+            },
+            "useLines": {
+                "toInsertLine1": "router.get('/WithMail', (req, res) => funcFromWithMail({ res, inTablePath: tablePath }));",
+                "toInsertLine": "router.post('/WithMail', express.json(), (req, res) => funcFromWithMail({ req, res, inTablePath: tablePath, inConfigPath: configPath }));",
+                "duplicationCheck": "router.use('/WithMail'",
+                "insertAfter": [
+                    "router.",
+                    "const router = "
+                ]
+            }
+        }
+    }

package/bin/v3/tasks/actions/ShowAll/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;

package/bin/v3/tasks/actions/ShowAll/steps/UpdateRoutesJs/common/writeFile.js

@@ -0,0 +1,10 @@
+import fs from "fs";
+
+const writeFile = (inAppJsPath, inContent) => {
+    const localPath = inAppJsPath;
+    const localContent = inContent;
+
+    fs.writeFileSync(localPath, localContent);
+};
+
+export default writeFile;

package/bin/v3/tasks/actions/ShowAll/steps/UpdateRoutesJs/updateImports/buildImport.js

@@ -0,0 +1,9 @@
+const buildImport = ({ inFuncName, inEndpoint }) => {
+    const localEndpoint = inEndpoint;
+
+    const safeName = localEndpoint.replace(/[^a-zA-Z0-9]/g, "_");
+
+    return `import { ${inFuncName} } from "./${localEndpoint}/controller.js";`;
+};
+
+export default buildImport;

package/bin/v3/tasks/actions/ShowAll/steps/UpdateRoutesJs/updateImports/checkDuplicate.js

@@ -0,0 +1,8 @@
+const checkUseDuplicate = ({ inContent, inFuncName }) => {
+    const localContent = inContent;
+    const toCheckLine = `import { ${inFuncName} } from`;
+
+    return localContent.includes(toCheckLine);
+};
+
+export default checkUseDuplicate;

package/bin/v3/tasks/actions/ShowAll/steps/UpdateRoutesJs/updateImports/findInsertIndex.js

@@ -0,0 +1,10 @@
+const findInsertIndex = (inContent) => {
+    const localContent = inContent;
+
+    const matches = [...localContent.matchAll(/^\s*import.*$/gm)];
+    const last = matches.at(-1);
+
+    return last ? last.index + last[0].length : 0;
+};
+
+export default findInsertIndex;

package/bin/v3/tasks/actions/ShowAll/steps/UpdateRoutesJs/updateImports/index.js

@@ -0,0 +1,47 @@
+import readFile from "../common/readFile.js";
+import buildImport from "./buildImport.js";
+import checkDuplicate from "./checkDuplicate.js";
+import findInsertIndex from "./findInsertIndex.js";
+import writeFile from "../common/writeFile.js";
+
+const updateImports = ({ appJsPath, endpoint, showLog, inFuncName }) => {
+    const summary = {
+        import: { added: false, line: null },
+    };
+
+    const content = readFile(appJsPath);
+
+    const importLine = buildImport({
+        inEndpoint: endpoint,
+        inFuncName
+    });
+
+    const fromCheckDuplicate = checkDuplicate({ inContent: content, inFuncName });
+
+    if (fromCheckDuplicate) {
+        summary.import.skipped = true;
+
+        if (showLog) console.log(summary);
+
+        return summary;
+    };
+
+    const index = findInsertIndex(content);
+
+    const before = content.slice(0, index);
+    const lineNumber = before.split("\n").length + 1;
+
+    const updated =
+        before + "\n" + importLine + content.slice(index);
+
+    writeFile(appJsPath, updated);
+
+    summary.import.added = true;
+    summary.import.line = lineNumber;
+
+    if (showLog) console.log(summary);
+
+    return summary;
+};
+
+export default updateImports;