@keshavsoft/kschema-cli 1.2.2 → 1.3.1

package/CHANGELOG.md

@@ -1,39 +1,25 @@
-# CHANGELOG
+# Changelog
 
 All notable changes to this project will be documented in this file.
 
+The format is based on Keep a Changelog.
+
 ---
 
-## [1.7.1] - 2026-04-18
+## [1.3.1] - 2026-04-21
 
 ### Added
-
-* Initial release of kschema
-* Config loader (`loadConfig`, `getConfig`)
-* File-based JSON storage
-* Schema-driven table handling
-* Primary key detection (`getPrimaryKey`)
-* Auto-increment primary key (`attachPrimaryKey`)
-* CRUD operations:
-
-  * insert
-  * insertStrict
-  * get
-  * findByPk
-  * update
-  * delete
+- Initial release of `@keshavsoft/kschema-cli`
+- CLI command: `kschema init <template> [projectName]`
+- Template support:
+  - basic
+  - express
+- Auto project generation using file copy
+- Auto folder naming when projectName not provided:
+  - `kschema-<template>-<timestamp>`
+- Modular command structure (`init`, `test`)
+- Version-based CLI execution (`cliVersion` support)
 
 ### Notes
-
-* Primary key is dynamically resolved from schema
-* Data stored as JSON files
-* Minimal, dependency-free design
-
-## [1.7.3] - 2026-04-19
-
-### filer and find columns perfect
-
-## [1.7.4]
-
-### delete multi added
-
+- Designed as a wrapper over kschema ecosystem
+- Focused on simplicity and fast project setup

package/README.md

@@ -1,95 +1,38 @@
-# KeshavSoft
+# @keshavsoft/kschema-cli
 
-Simple tools. Clean architecture. Fast development.
-
----
-
-## @keshavsoft/kschema
-
-A lightweight schema-driven JSON database for Node.js.
-
----
+CLI to generate projects using templates.
 
 ## Install
 
-npm i @keshavsoft/kschema
-
----
-
-## Usage
-
-import { kschema } from "@keshavsoft/kschema";
-
-kschema.loadConfig({ dataPath: "./data" });
-
-const users = kschema.table("users");
-
-users.insert({ name: "keshav" });
-
-const data = users.get();
-
-console.log(data);
-
----
+npm install -g @keshavsoft/kschema-cli
 
-## API
+or
 
-Create
+npx @keshavsoft/kschema-cli init express MyApp
 
-users.insert(record);
-users.insertStrict(record);
-
-Read
-
-users.get();
-users.findByPk(id);
-
-Filter
-
-users.filterByPk(id);
-users.filterByColumns({ name: "keshav" });
-
-Update
-
-users.update(record);
-
-Delete
-
-users.delete(id);
-users.deleteByColumns({ name: "keshav" });
-
----
-
-## Features
-
-* File-based JSON storage
-* Schema-driven design
-* Auto primary key
-* Simple CRUD API
-* Zero dependencies
-
----
-
-## Links
+## Usage
 
-GitHub: https://github.com/keshavsoft/kschema
-NPM: https://www.npmjs.com/package/@keshavsoft/kschema
-Website: https://keshavsoft.com
+kschema init <template> [projectName]
 
----
+## Examples
 
-## Contact
+kschema init basic MyApp
+kschema init express MyServer
+kschema init express
 
-Email: founder@keshavsoft.com
+## Templates
 
----
+basic
+express
 
-## About
+## Behavior
 
-KeshavSoft builds simple and practical developer tools focused on clarity, speed, and real-world usage.
+- If projectName is provided → folder created with that name  
+- If not provided → auto name generated  
 
----
+Example auto name:
+kschema-express-<timestamp>
 
-## License
+## Output
 
-MIT License — see LICENSE file
+Creates a new folder with selected template files.

package/bin/cli.js

@@ -1,17 +1,21 @@
 #!/usr/bin/env node
-console.log("baaaaaaaaaaaa : ");
 
 import packageJson from "../package.json" with { type: "json" };
 
 import { v2Func } from "./v2/start.js";
-console.log("bbbbbbbbbbbbbbb : ", packageJson);
+import { v3Func } from "./v3/start.js";
 
-switch (packageJson?.version.split(".")[1]) {
+switch (packageJson?.cliVersion) {
     case "2":
         v2Func();
 
+        break;
+    case "3":
+        v3Func();
+
         break;
 
     default:
+        console.log(`Unsupported CLI version: ${packageJson?.cliVersion}`);
         console.log("Usage: kschema <init|test> [name]");
 };

package/bin/v2/commands/template/Data/LedgerNames.json

@@ -1,6 +1,6 @@
-[
-  {
-    "LedgerName": "Keshav",
-    "pk": 1
-  }
+[
+  {
+    "LedgerName": "Keshav",
+    "pk": 1
+  }
 ]

package/bin/v3/commands/init.js

@@ -0,0 +1,30 @@
+import fs from "fs";
+import path from "path";
+import { fileURLToPath } from "url";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+const defaultFolderName = "KehavSoft";
+
+export default ({ inTemplate, inFolderName }) => {
+    const folderName = inFolderName || `kschema-${inTemplate}-${Date.now()}`;
+    let source;
+
+    switch (inTemplate) {
+        case "express":
+            source = path.join(__dirname, "template", "express");
+            break;
+
+        default:
+            source = path.join(__dirname, "template", "basic");
+            break;
+    };
+
+    const destination = path.join(process.cwd(), folderName);
+
+    fs.mkdirSync(destination, { recursive: true });
+    fs.cpSync(source, destination, { recursive: true });
+
+    console.log(`Project created in ${folderName}`);
+};

package/bin/v3/commands/template/basic/.vscode/launch.json

@@ -0,0 +1,12 @@
+{
+    "version": "0.2.0",
+    "configurations": [
+        {
+            "type": "node",
+            "request": "launch",
+            "name": "Debug App",
+            "program": "${workspaceFolder}/app.js",
+            "envFile": "${workspaceFolder}/.env"
+        }
+    ]
+}

package/bin/v3/commands/template/basic/Config/Schemas/BillsTable.json

@@ -0,0 +1,165 @@
+{
+  "tableName": "BillsTable",
+  "columns": [
+    {
+      "field": "LedgerName",
+      "title": "LedgerName",
+      "type": "text",
+      "isInput": false,
+      "isAutoFocus": true,
+      "WidthOptions": {
+        "inPx": 200
+      },
+      "defaultvalue": "Keshav",
+      "isDataList": true,
+      "dataListId": "LedgerNames",
+      "isConsider": true
+    },
+    {
+      "field": "LedgerParentName",
+      "title": "LedgerParentName",
+      "type": "text",
+      "isInput": true,
+      "WidthOptions": {
+        "inPx": 200
+      },
+      "isConsider": true,
+      "showInUi": false
+    },
+    {
+      "field": "LedgerGST",
+      "title": "LedgerGST",
+      "type": "text",
+      "isInput": true,
+      "isAutoFocus": true,
+      "WidthOptions": {
+        "inPx": 200
+      },
+      "isConsider": true,
+      "showInUi": false
+    },
+    {
+      "field": "InvoiceNo",
+      "title": "InvoiceNo",
+      "type": "number",
+      "isInput": true,
+      "WidthOptions": {
+        "inPx": 200
+      },
+      "isConsider": true
+    },
+    {
+      "field": "InvoiceDate",
+      "title": "InvoiceDate",
+      "isDate": true,
+      "type": "date",
+      "WidthOptions": {
+        "inPx": 200
+      },
+      "defaultvalue": "today",
+      "isConsider": true
+    },
+    {
+      "field": "InvoiceStateCode",
+      "title": "InvoiceStateCode",
+      "defaultvalue": "37",
+      "isInput": true,
+      "WidthOptions": {
+        "inPx": 200
+      },
+      "isConsider": true,
+      "showInUi": false
+    },
+    {
+      "field": "pk",
+      "title": "pk",
+      "primary": true
+    }
+  ],
+  "data": [],
+  "Vertical": [
+    {
+      "field": "LedgerName",
+      "title": "LedgerName",
+      "type": "text",
+      "isInput": false,
+      "isAutoFocus": true,
+      "WidthOptions": {
+        "inPx": 200
+      },
+      "defaultvalue": "Keshav",
+      "isDataList": true,
+      "dataListId": "LedgerNames"
+    },
+    {
+      "field": "LedgerParentName",
+      "title": "LedgerParentName",
+      "type": "text",
+      "isInput": true,
+      "WidthOptions": {
+        "inPx": 200
+      }
+    },
+    {
+      "field": "LedgerGST",
+      "title": "LedgerGST",
+      "type": "text",
+      "isInput": true,
+      "isAutoFocus": true,
+      "WidthOptions": {
+        "inPx": 200
+      }
+    },
+    {
+      "field": "InvoiceNo",
+      "title": "InvoiceNo",
+      "type": "number",
+      "isInput": true,
+      "WidthOptions": {
+        "inPx": 200
+      }
+    },
+    {
+      "field": "InvoiceDate",
+      "title": "InvoiceDate",
+      "isDate": true,
+      "type": "date",
+      "WidthOptions": {
+        "inPx": 200
+      },
+      "defaultvalue": "today"
+    },
+    {
+      "field": "InvoiceStateCode",
+      "title": "InvoiceStateCode",
+      "defaultvalue": "37",
+      "isInput": true,
+      "WidthOptions": {
+        "inPx": 200
+      }
+    }
+  ],
+  "DataTableOptions": {
+    "Header": {
+      "autoFocus": "LedgerName"
+    }
+  },
+  "ForeignkeyTables": [
+    "ItemsTable"
+  ],
+  "DependantTables": [
+    "LedgerNames"
+  ],
+  "NonSecured": {
+    "SubRoutes": [
+      "ShowAll",
+      "Insert",
+      "Find",
+      "InsertAndReturnPk",
+      "FindWithForeignData",
+      "InsertToTally"
+    ]
+  },
+  "PrimarykeyTableNames": [],
+  "PrimarykeyTables": []
+}

package/bin/v3/commands/template/basic/Config/Schemas/ItemsTable.json

@@ -0,0 +1,200 @@
+{
+  "tableName": "ItemsTable",
+  "columns": [
+    {
+      "field": "StockItemName",
+      "title": "StockItemName",
+      "unique": false,
+      "type": "text",
+      "isInput": false,
+      "isAutoFocus": true,
+      "WidthOptions": {
+        "inPx": 300
+      },
+      "isDataList": true,
+      "dataListId": "StockItems",
+      "isConsider": true,
+      "showInUi": true
+    },
+    {
+      "field": "Rate",
+      "title": "Rate",
+      "unique": false,
+      "type": "number",
+      "isNumber": true,
+      "ShowTotal": false,
+      "footerFormatter": "",
+      "showRupee": true,
+      "align": "right",
+      "WidthOptions": {
+        "inPx": 250
+      },
+      "isConsider": true,
+      "showInUi": true
+    },
+    {
+      "field": "Qty",
+      "title": "Qty",
+      "unique": false,
+      "type": "number",
+      "isNumber": true,
+      "ShowTotal": true,
+      "footerFormatter": "TotalFormatter",
+      "showRupee": false,
+      "WidthOptions": {
+        "inPx": 200
+      },
+      "isConsider": true,
+      "showInUi": true
+    },
+    {
+      "field": "Amount",
+      "title": "Amount",
+      "unique": false,
+      "type": "number",
+      "isNumber": true,
+      "ShowTotal": true,
+      "footerFormatter": "TotalFormatter",
+      "enterCal": "Rate*Qty",
+      "showRupee": true,
+      "align": "right",
+      "WidthOptions": {
+        "inPx": 250
+      },
+      "isConsider": true,
+      "showInUi": false
+    },
+    {
+      "field": "TaxPer",
+      "title": "TaxPer",
+      "unique": false,
+      "type": "number",
+      "isNumber": true,
+      "defaultvalue": 18,
+      "isConsider": true,
+      "showInUi": true
+    },
+    {
+      "field": "Uom",
+      "title": "Uom",
+      "unique": false,
+      "type": "number",
+      "isNumber": true,
+      "defaultvalue": 18,
+      "isConsider": true,
+      "showInUi": true
+    },
+    {
+      "field": "ParentPk",
+      "title": "ParentPk",
+      "unique": false,
+      "isConsider": true,
+      "showInUi": true
+    },
+    {
+      "field": "pk",
+      "title": "pk",
+      "primary": true
+    }
+  ],
+  "data": [],
+  "Vertical": [
+    {
+      "field": "StockItemName",
+      "title": "StockItemName",
+      "unique": false,
+      "type": "text",
+      "isInput": false,
+      "isAutoFocus": true,
+      "WidthOptions": {
+        "inPx": 300
+      },
+      "isDataList": true,
+      "dataListId": "StockItems"
+    },
+    {
+      "field": "Rate",
+      "title": "Rate",
+      "unique": false,
+      "type": "number",
+      "isNumber": true,
+      "ShowTotal": false,
+      "footerFormatter": "",
+      "showRupee": true,
+      "align": "right",
+      "WidthOptions": {
+        "inPx": 250
+      }
+    },
+    {
+      "field": "Qty",
+      "title": "Qty",
+      "unique": false,
+      "type": "number",
+      "isNumber": true,
+      "ShowTotal": true,
+      "footerFormatter": "TotalFormatter",
+      "showRupee": false,
+      "WidthOptions": {
+        "inPx": 200
+      }
+    },
+    {
+      "field": "Amount",
+      "title": "Amount",
+      "unique": false,
+      "type": "number",
+      "isNumber": true,
+      "ShowTotal": true,
+      "footerFormatter": "TotalFormatter",
+      "showRupee": true,
+      "align": "right",
+      "WidthOptions": {
+        "inPx": 250
+      }
+    },
+    {
+      "field": "TaxPer",
+      "title": "TaxPer",
+      "unique": false,
+      "type": "number",
+      "isNumber": true,
+      "defaultvalue": 18,
+      "isConsider": true,
+      "showInUi": true
+    },
+    {
+      "field": "Uom",
+      "title": "Uom",
+      "unique": false,
+      "type": "number",
+      "isNumber": true,
+      "defaultvalue": 18,
+      "isConsider": true,
+      "showInUi": true
+    }
+  ],
+  "DataTableOptions": {
+    "Header": {
+      "autoFocus": "StockItemName"
+    }
+  },
+  "NonSecured": {
+    "SubRoutes": [
+      "ShowAll",
+      "Insert",
+      "InsertAndReturnPk",
+      "InsertWithDefaults"
+    ]
+  },
+  "DependantTables": [
+    "StockItems"
+  ],
+  "ForeignkeyTables": [
+    "BillsTable"
+  ],
+  "PrimarykeyTableNames": [
+    "BillsTable"
+  ],
+  "PrimarykeyTables": []
+}

package/bin/v3/commands/template/basic/Config/Schemas/LedgerNames.json

@@ -0,0 +1,50 @@
+{
+  "tableName": "LedgerNames",
+  "columns": [
+    {
+      "field": "LedgerName",
+      "title": "LedgerName",
+      "unique": true,
+      "type": "text",
+      "isInput": true,
+      "isAutoFocus": true,
+      "defaultvalue": "KeshavSoft",
+      "isConsider": true
+    },
+    {
+      "field": "LedgerParentName",
+      "title": "LedgerParentName",
+      "type": "text",
+      "isInput": true,
+      "isConsider": true
+    },
+    {
+      "field": "LedgerType",
+      "title": "LedgerType",
+      "type": "text",
+      "isInput": true,
+      "isConsider": true
+    },
+    {
+      "field": "pk",
+      "title": "pk",
+      "primary": true
+    }
+  ],
+  "data": [],
+  "Vertical": [],
+  "DataTableOptions": {
+    "Header": {
+      "autoFocus": "LedgerName"
+    }
+  },
+  "NonSecured": {
+    "SubRoutes": [
+      "ShowAll",
+      "Insert",
+      "Pipe"
+    ]
+  },
+  "PrimarykeyTableNames": [],
+  "PrimarykeyTables": []
+}