@keshavsoft/kschema-api-gen-actions 1.14.1

package/bin/v14/tasks/actions/distinct.js

@@ -0,0 +1,59 @@
+import path from "path";
+import { endPointsJs } from "@keshavsoft/kschema-api-check";
+
+import { locateSource } from "./GetMethods/ShowAll/steps/locateSource.js";
+import { locateDestination } from "./GetMethods/ShowAll/steps/locateDestination.js";
+import { createFolder } from "../core/createFolder.js";
+
+// import updateEndPointsJs from "./ShowAll/steps/updateEndPointsJs.js";
+import createHttpFile from "./GetMethods/ShowAll/steps/createHttpFile.js";
+
+import { announce } from "./GetMethods/ShowAll/steps/announce.js";
+
+import resolveFolderName from "./GetMethods/ShowAll/steps/resolveFolderName.js";
+
+export default ({ cmd = "", toPath, isAnnounce = true, checkBeforeCreate = true }) => {
+    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) {
+        endPointsJs({
+            toPath: localToPath,
+            action: resolvedFolderName
+        });
+
+        // updateEndPointsJs({
+        //     appJsPath: `${localToPath}/end-points.js`,
+        //     endpoint: resolvedFolderName
+        // });
+
+        createHttpFile({
+            inTargetPath: path.join(localToPath, resolvedFolderName),
+            toPath: process.cwd()
+        });
+    };
+
+    if (isAnnounce) announce({ inResolvedFolderName: resolvedFolderName });
+
+    return resolveFolderName;
+};

package/bin/v14/tasks/actions/insert.js

@@ -0,0 +1,59 @@
+import path from "path";
+import { endPointsJs } from "@keshavsoft/kschema-api-check";
+
+import { locateSource } from "./PostMethods/Insert/steps/locateSource.js";
+import { locateDestination } from "./PostMethods/Insert/steps/locateDestination.js";
+import { createFolder } from "../../core/createFolder.js";
+
+import updateEndPointsJs from "./PostMethods/Insert/steps/updateEndPointsJs.js";
+import createHttpFile from "./PostMethods/Insert/steps/createHttpFile.js";
+
+import { announce } from "./PostMethods/Insert/steps/announce.js";
+
+import resolveFolderName from "./PostMethods/Insert/steps/resolveFolderName.js";
+
+export default ({ cmd = "", toPath, isAnnounce = true, checkBeforeCreate = true }) => {
+    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) {
+        endPointsJs({
+            toPath: localToPath,
+            action: resolvedFolderName
+        });
+
+        // updateEndPointsJs({
+        //     appJsPath: `${localToPath}/end-points.js`,
+        //     endpoint: resolvedFolderName
+        // });
+
+        createHttpFile({
+            inTargetPath: path.join(localToPath, resolvedFolderName),
+            toPath: process.cwd()
+        });
+    };
+
+    if (isAnnounce) announce({ inResolvedFolderName: resolvedFolderName });
+
+    return resolvedFolderName;
+};

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

@@ -0,0 +1,59 @@
+import path from "path";
+import { endPointsJs } from "@keshavsoft/kschema-api-check";
+
+import { locateSource } from "./GetMethods/ShowAll/steps/locateSource.js";
+import { locateDestination } from "./GetMethods/ShowAll/steps/locateDestination.js";
+import { createFolder } from "../core/createFolder.js";
+
+// import updateEndPointsJs from "./ShowAll/steps/updateEndPointsJs.js";
+import createHttpFile from "./GetMethods/ShowAll/steps/createHttpFile.js";
+
+import { announce } from "./GetMethods/ShowAll/steps/announce.js";
+
+import resolveFolderName from "./GetMethods/ShowAll/steps/resolveFolderName.js";
+
+export default ({ cmd = "", toPath, isAnnounce = true, checkBeforeCreate = true }) => {
+    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) {
+        endPointsJs({
+            toPath: localToPath,
+            action: resolvedFolderName
+        });
+
+        // updateEndPointsJs({
+        //     appJsPath: `${localToPath}/end-points.js`,
+        //     endpoint: resolvedFolderName
+        // });
+
+        createHttpFile({
+            inTargetPath: path.join(localToPath, resolvedFolderName),
+            toPath: process.cwd()
+        });
+    };
+
+    if (isAnnounce) announce({ inResolvedFolderName: resolvedFolderName });
+
+    return resolveFolderName;
+};

package/bin/v14/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/v14/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/v14/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/v14/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/index.js

@@ -0,0 +1,8 @@
+import getLatestVersion from "./bin/core/getLatestVersion.js";
+
+const load = async (cmd) => {
+    const v = getLatestVersion();
+    return (await import(`./bin/${v}/commands/exportCommands/${cmd}.js`)).default;
+};
+
+export const showAll = async (...a) => (await load("showAll"))(...a);

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@keshavsoft/kschema-api-gen-actions",
+  "version": "1.14.1",
+  "description": "CLI to scaffold projects using templates",
+  "keywords": [
+    "cli",
+    "scaffold",
+    "templates",
+    "node",
+    "project-generator"
+  ],
+  "dependencies": {
+    "@keshavsoft/kschema": "^1.17.8",
+    "@keshavsoft/kschema-api-check": "^1.10.3"
+  },
+  "type": "module",
+  "exports": {
+    ".": "./index.js"
+  },
+  "bin": {
+    "kschema-api-gen-actions": "./bin/cli.js"
+  },
+  "files": [
+    "bin/",
+    "index.js",
+    "README.md",
+    "LICENSE"
+  ],
+  "homepage": "https://cli.keshavsoft.com",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/keshavsoft/kschema-cli"
+  },
+  "bugs": {
+    "url": "https://github.com/keshavsoft/kschema-cli/issues"
+  }
+}