kschema-api-gen-routesjs 1.1.1

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,38 @@
+# @keshavsoft/kschema-cli
+
+CLI to generate projects using templates.
+
+## Install
+
+npm install -g @keshavsoft/kschema-cli
+
+or
+
+npx @keshavsoft/kschema-cli init express MyApp
+
+## Usage
+
+kschema init <template> [projectName]
+
+## Examples
+
+kschema init basic MyApp
+kschema init express MyServer
+kschema init express
+
+## Templates
+
+basic
+express
+
+## Behavior
+
+- If projectName is provided → folder created with that name  
+- If not provided → auto name generated  
+
+Example auto name:
+kschema-express-<timestamp>
+
+## Output
+
+Creates a new folder with selected template files.

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/AddSubRoute/Helpers/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/v1/AddSubRoute/Helpers/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/v1/AddSubRoute/Helpers/steps/UpdateRoutesJs/updateImports/buildImport.js

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

package/bin/v1/AddSubRoute/Helpers/steps/UpdateRoutesJs/updateImports/checkDuplicate.js

@@ -0,0 +1,8 @@
+const checkUseDuplicate = (inContent, inEndpoint) => {
+    const localContent = inContent;
+    const localEndpoint = inEndpoint;
+
+    return localContent.includes(`app.use("/${localEndpoint}"`);
+};
+
+export default checkUseDuplicate;

package/bin/v1/AddSubRoute/Helpers/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/v1/AddSubRoute/Helpers/steps/UpdateRoutesJs/updateImports/index.js

@@ -0,0 +1,41 @@
+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 }) => {
+    const summary = {
+        import: { added: false, line: null },
+    };
+
+    const content = readFile(appJsPath);
+    const importLine = buildImport(endpoint);
+
+    if (checkDuplicate(content, endpoint)) {
+        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;

package/bin/v1/AddSubRoute/Helpers/steps/UpdateRoutesJs/updateUse/buildUseLine.js

@@ -0,0 +1,11 @@
+const appOrRouter = "router";
+
+const buildUseLine = (inEndpoint) => {
+    const localEndpoint = inEndpoint;
+
+    const safeName = localEndpoint.replace(/[^a-zA-Z0-9]/g, "_");
+
+    return `${appOrRouter}.use("/${localEndpoint}", routerFrom${safeName});`;
+};
+
+export default buildUseLine;

package/bin/v1/AddSubRoute/Helpers/steps/UpdateRoutesJs/updateUse/checkDuplicate.js

@@ -0,0 +1,8 @@
+const checkDuplicate = (inContent, inEndpoint) => {
+    const localContent = inContent;
+    const localEndpoint = inEndpoint;
+
+    return localContent.includes(`app.use("/${localEndpoint}"`);
+};
+
+export default checkDuplicate;

package/bin/v1/AddSubRoute/Helpers/steps/UpdateRoutesJs/updateUse/findInsertIndex.js

@@ -0,0 +1,10 @@
+const findUseInsertIndex = (inContent) => {
+    const localContent = inContent;
+
+    const matches = [...localContent.matchAll(/const\s+router\s*=\s*express\.Router\(\)/g)];
+    const match = matches.at(0);
+
+    return match ? match.index + match[0].length : localContent.length;
+};
+
+export default findUseInsertIndex;

package/bin/v1/AddSubRoute/Helpers/steps/UpdateRoutesJs/updateUse/index.js

@@ -0,0 +1,42 @@
+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 updateAppUse = ({ appJsPath, endpoint, showLog }) => {
+    const summary = {
+        use: { added: false, skipped: false, line: null }
+    };
+
+    const content = readFile(appJsPath);
+    const useLine = buildUseLine(endpoint);
+
+    if (checkDuplicate(content, endpoint)) {
+        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/v1/AddSubRoute/Helpers/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/v1/AddSubRoute/Helpers/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/v1/AddSubRoute/Helpers/steps/decideTemplate.js

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

package/bin/v1/AddSubRoute/Helpers/steps/locateDestination.js

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

package/bin/v1/AddSubRoute/Helpers/steps/locateSource.js

@@ -0,0 +1,13 @@
+import path from "path";
+import { fileURLToPath } from "url";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+export const locateSource = () => {
+    return path.join(
+        __dirname,
+        "..",
+        "template"
+    );
+};

package/bin/v1/AddSubRoute/Helpers/steps/resolveFolderName.js

@@ -0,0 +1,20 @@
+import fs from "fs";
+
+export default function resolveFolderName({ name }) {
+    const defaultFolerName = "V1";
+
+    // 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/v1/AddSubRoute/Helpers/steps/updateAppJs.js

@@ -0,0 +1,13 @@
+import updateImports from "./UpdateRoutesJs/updateImports/index.js";
+import updateAppUse from "./UpdateRoutesJs/updateUse/index.js";
+
+export function updateAppJs({ appJsPath, endpoint }) {
+    if (!fs.existsSync(appJsPath)) {
+        if (showLog) console.log("app.js file not found ?");
+
+        return false;
+    };
+
+    updateImports({ appJsPath, endpoint });
+    updateAppUse({ appJsPath, endpoint });
+};

package/bin/v1/AddSubRoute/Helpers/template/routes.js

@@ -0,0 +1,5 @@
+import express from 'express';
+
+const router = express.Router();
+
+export { router };

package/bin/v1/AddSubRoute/index.js

@@ -0,0 +1,42 @@
+import { locateSource } from "./Helpers/steps/locateSource.js";
+import { locateDestination } from "./Helpers/steps/locateDestination.js";
+import { createFolder } from "../core/createFolder.js";
+import { updateAppJs } from "./Helpers/steps/updateAppJs.js";
+import { announce } from "./Helpers/steps/announce.js";
+
+import resolveFolderName from "./Helpers/steps/resolveFolderName.js";
+
+export default ({ folderName = "", argsAsIs, 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) {
+        updateAppJs({
+            appJsPath: `${localToPath}/routes.js`,
+            endpoint: resolvedFolderName
+        });
+    };
+
+    if (isAnnounce) announce({ inResolvedFolderName: resolvedFolderName });
+
+    return resolvedFolderName;
+};

package/bin/v1/commands/AddSubRoute/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/v1/commands/AddSubRoute/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/v1/commands/AddSubRoute/steps/UpdateRoutesJs/updateImports/buildImport.js

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

package/bin/v1/commands/AddSubRoute/steps/UpdateRoutesJs/updateImports/checkDuplicate.js

@@ -0,0 +1,8 @@
+const checkUseDuplicate = (inContent, inEndpoint) => {
+    const localContent = inContent;
+    const localEndpoint = inEndpoint;
+
+    return localContent.includes(`app.use("/${localEndpoint}"`);
+};
+
+export default checkUseDuplicate;

package/bin/v1/commands/AddSubRoute/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/v1/commands/AddSubRoute/steps/UpdateRoutesJs/updateImports/index.js

@@ -0,0 +1,41 @@
+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 }) => {
+    const summary = {
+        import: { added: false, line: null },
+    };
+
+    const content = readFile(appJsPath);
+    const importLine = buildImport(endpoint);
+
+    if (checkDuplicate(content, endpoint)) {
+        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;

package/bin/v1/commands/AddSubRoute/steps/UpdateRoutesJs/updateUse/buildUseLine.js

@@ -0,0 +1,11 @@
+const appOrRouter = "router";
+
+const buildUseLine = (inEndpoint) => {
+    const localEndpoint = inEndpoint;
+
+    const safeName = localEndpoint.replace(/[^a-zA-Z0-9]/g, "_");
+
+    return `${appOrRouter}.use("/${localEndpoint}", routerFrom${safeName});`;
+};
+
+export default buildUseLine;

package/bin/v1/commands/AddSubRoute/steps/UpdateRoutesJs/updateUse/checkDuplicate.js

@@ -0,0 +1,8 @@
+const checkDuplicate = (inContent, inEndpoint) => {
+    const localContent = inContent;
+    const localEndpoint = inEndpoint;
+
+    return localContent.includes(`app.use("/${localEndpoint}"`);
+};
+
+export default checkDuplicate;

package/bin/v1/commands/AddSubRoute/steps/UpdateRoutesJs/updateUse/findInsertIndex.js

@@ -0,0 +1,10 @@
+const findUseInsertIndex = (inContent) => {
+    const localContent = inContent;
+
+    const matches = [...localContent.matchAll(/const\s+router\s*=\s*express\.Router\(\)/g)];
+    const match = matches.at(0);
+
+    return match ? match.index + match[0].length : localContent.length;
+};
+
+export default findUseInsertIndex;

package/bin/v1/commands/AddSubRoute/steps/UpdateRoutesJs/updateUse/index.js

@@ -0,0 +1,42 @@
+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 updateAppUse = ({ appJsPath, endpoint, showLog }) => {
+    const summary = {
+        use: { added: false, skipped: false, line: null }
+    };
+
+    const content = readFile(appJsPath);
+    const useLine = buildUseLine(endpoint);
+
+    if (checkDuplicate(content, endpoint)) {
+        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/v1/commands/AddSubRoute/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/v1/commands/AddSubRoute/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/v1/commands/AddSubRoute/steps/decideTemplate.js

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

package/bin/v1/commands/AddSubRoute/steps/locateDestination.js

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

package/bin/v1/commands/AddSubRoute/steps/locateSource.js

@@ -0,0 +1,13 @@
+import path from "path";
+import { fileURLToPath } from "url";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+export const locateSource = () => {
+    return path.join(
+        __dirname,
+        "..",
+        "template"
+    );
+};

package/bin/v1/commands/AddSubRoute/steps/resolveFolderName.js

@@ -0,0 +1,20 @@
+import fs from "fs";
+
+export default function resolveFolderName({ name }) {
+    const defaultFolerName = "V1";
+
+    // 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/v1/commands/AddSubRoute/steps/updateAppJs.js

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

package/bin/v1/commands/AddSubRoute/template/routes.js

@@ -0,0 +1,5 @@
+import express from 'express';
+
+const router = express.Router();
+
+export { router };

package/bin/v1/commands/StartEndPoint/steps/UpdateAppJs/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/v1/commands/StartEndPoint/steps/UpdateAppJs/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/v1/commands/StartEndPoint/steps/UpdateAppJs/index.js

@@ -0,0 +1,11 @@
+import fs from "fs";
+
+import updateImports from "./updateImports/index.js";
+import updateAppUse from "./updateUse/index.js";
+
+export function updateAppJs({ appJsPath, endpoint }) {
+    if (!fs.existsSync(appJsPath)) return;
+
+    updateImports({ appJsPath, endpoint });
+    updateAppUse({ appJsPath, endpoint });
+};

package/bin/v1/commands/StartEndPoint/steps/UpdateAppJs/updateImports/buildImport.js

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

package/bin/v1/commands/StartEndPoint/steps/UpdateAppJs/updateImports/checkDuplicate.js

@@ -0,0 +1,8 @@
+const checkUseDuplicate = (inContent, inEndpoint) => {
+    const localContent = inContent;
+    const localEndpoint = inEndpoint;
+
+    return localContent.includes(`app.use("/${localEndpoint}"`);
+};
+
+export default checkUseDuplicate;

package/bin/v1/commands/StartEndPoint/steps/UpdateAppJs/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/v1/commands/StartEndPoint/steps/UpdateAppJs/updateImports/index.js

@@ -0,0 +1,41 @@
+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 }) => {
+    const summary = {
+        import: { added: false, line: null },
+    };
+
+    const content = readFile(appJsPath);
+    const importLine = buildImport(endpoint);
+
+    if (checkDuplicate(content, endpoint)) {
+        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;

package/bin/v1/commands/StartEndPoint/steps/UpdateAppJs/updateUse/buildUseLine.js

@@ -0,0 +1,9 @@
+const buildUseLine = (inEndpoint) => {
+    const localEndpoint = inEndpoint;
+
+    const safeName = localEndpoint.replace(/[^a-zA-Z0-9]/g, "_");
+
+    return `app.use("/${localEndpoint}", routerFrom${safeName});`;
+};
+
+export default buildUseLine;

package/bin/v1/commands/StartEndPoint/steps/UpdateAppJs/updateUse/checkDuplicate.js

@@ -0,0 +1,8 @@
+const checkDuplicate = (inContent, inEndpoint) => {
+    const localContent = inContent;
+    const localEndpoint = inEndpoint;
+
+    return localContent.includes(`app.use("/${localEndpoint}"`);
+};
+
+export default checkDuplicate;

package/bin/v1/commands/StartEndPoint/steps/UpdateAppJs/updateUse/findInsertIndex.js

@@ -0,0 +1,10 @@
+const findUseInsertIndex = (inContent) => {
+    const localContent = inContent;
+
+    const matches = [...localContent.matchAll(/const\s+app\s*=\s*express\(\)/g)];
+    const match = matches.at(0);
+
+    return match ? match.index + match[0].length : localContent.length;
+};
+
+export default findUseInsertIndex;

package/bin/v1/commands/StartEndPoint/steps/UpdateAppJs/updateUse/index.js

@@ -0,0 +1,42 @@
+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 updateAppUse = ({ appJsPath, endpoint, showLog = false }) => {
+    const summary = {
+        use: { added: false, skipped: false, line: null }
+    };
+
+    const content = readFile(appJsPath);
+    const useLine = buildUseLine(endpoint);
+
+    if (checkDuplicate(content, endpoint)) {
+        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/v1/commands/StartEndPoint/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/v1/commands/StartEndPoint/steps/decideTemplate.js

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

package/bin/v1/commands/StartEndPoint/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/v1/commands/StartEndPoint/steps/locateSource.js

@@ -0,0 +1,13 @@
+import path from "path";
+import { fileURLToPath } from "url";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+export const locateSource = () => {
+    return path.join(
+        __dirname,
+        "..",
+        "template"
+    );
+};

package/bin/v1/commands/StartEndPoint/steps/resolveFolderName.js

@@ -0,0 +1,20 @@
+import fs from "fs";
+
+export default function resolveFolderName({ name }) {
+    const defaultFolerName = "Api";
+
+    // 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/v1/commands/StartEndPoint/template/routes.js

@@ -0,0 +1,5 @@
+import express from 'express';
+
+const router = express.Router();
+
+export { router };

package/bin/v1/commands/addSubRoute.js

@@ -0,0 +1,42 @@
+import { locateSource } from "./AddSubRoute/steps/locateSource.js";
+import { locateDestination } from "./AddSubRoute/steps/locateDestination.js";
+import { createFolder } from "../core/createFolder.js";
+import { updateAppJs } from "./AddSubRoute/steps/updateAppJs.js";
+import { announce } from "./AddSubRoute/steps/announce.js";
+
+import resolveFolderName from "./AddSubRoute/steps/resolveFolderName.js";
+
+export default ({ folderName = "", argsAsIs, 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) {
+        updateAppJs({
+            appJsPath: `${localToPath}/routes.js`,
+            endpoint: resolvedFolderName
+        });
+    };
+
+    if (isAnnounce) announce({ inResolvedFolderName: resolvedFolderName });
+
+    return resolvedFolderName;
+};

package/bin/v1/commands/startEndPoint.js

@@ -0,0 +1,44 @@
+import { locateSource } from "./StartEndPoint/steps/locateSource.js";
+import { locateDestination } from "./StartEndPoint/steps/locateDestination.js";
+import { createFolder } from "../core/createFolder.js";
+import { updateAppJs } from "./StartEndPoint/steps/UpdateAppJs/index.js";
+
+import { announce } from "./StartEndPoint/steps/announce.js";
+
+import resolveFolderName from "./StartEndPoint/steps/resolveFolderName.js";
+
+export default ({ folderName = "", toPath, isAnnounce = true, checkBeforeCreate = true }) => {
+    const localToPath = toPath;
+
+    const resolvedFolderName = resolveFolderName({
+        name: folderName
+    });
+
+    if (resolvedFolderName.KTF === false) {
+        return folderName;
+    };
+
+    const source = locateSource();
+    const destination = locateDestination({
+        inResolvedFolderName: resolvedFolderName,
+        toPath: localToPath
+    });
+
+    const createFolderResponse = createFolder({
+        source, destination,
+        isAnnounce, checkBeforeCreate
+    });
+
+    // console.log("bbbbbbbbbbbbbbbb : ", createFolderResponse);
+
+    if (createFolderResponse.KTF) {
+        updateAppJs({
+            appJsPath: `${localToPath}/app.js`,
+            endpoint: resolvedFolderName
+        });
+    };
+
+    if (isAnnounce) announce({ inResolvedFolderName: resolvedFolderName });
+
+    return resolvedFolderName;
+};

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,16 @@
+export default function parseInput() {
+    const [...args] = process.argv.slice(2);
+
+    const flags = Object.fromEntries(
+        args
+            .filter(a => a.includes("="))
+            .map(a => a.split("="))
+    );
+
+    return {
+        folderName: flags?.folderName || null,
+        isAnnounce: flags?.isAnnounce || true,
+        showLog: flags?.showLog || false,
+        toPath: process.cwd()
+    };
+};

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,18 @@
+import parseInput from "./core/parseInput.js";
+import showUsage from './core/showUsage.js';
+
+import addSubRoute from "./AddSubRoute/index.js";
+
+import pkg from '../../package.json' with { type: 'json' };
+
+const version = pkg.version;
+
+const run = () => {
+  const input = parseInput();
+
+  if (input.cmd === "--help" || input.cmd === "-h" || input.cmd === "help") return showUsage(version);
+
+  addSubRoute(input);
+};
+
+export default run;

package/index.js

@@ -0,0 +1,11 @@
+import getLatestVersion from "./bin/core/getLatestVersion.js";
+
+const load = async () => {
+    const v = getLatestVersion();
+
+    const module = await import(`./bin/${v}/StartEndPoint/index.js`);
+
+    return await module.default;
+};
+
+export default load;

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "kschema-api-gen-routesjs",
+  "version": "1.1.1",
+  "description": "CLI to build for appjs, the endpoints",
+  "keywords": [
+    "cli",
+    "scaffold",
+    "templates",
+    "node",
+    "project-generator"
+  ],
+  "dependencies": {
+  },
+  "type": "module",
+  "exports": {
+    ".": "./index.js"
+  },
+  "bin": {
+    "kschema-api-gen-routesjs": "./bin/cli.js"
+  },
+  "files": [
+    "bin/",
+    "index.js",
+    "README.md",
+    "LICENSE"
+  ],
+  "homepage": "https://cli.keshavsoft.com",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/keshavsoft/kschema-api-gen-routesjs"
+  },
+  "bugs": {
+    "url": "https://github.com/keshavsoft/kschema-api-gen-routesjs/issues"
+  }
+}