@keshavsoft/kschema-cli 1.1.1

package/CHANGELOG.md

@@ -0,0 +1,39 @@
+# CHANGELOG
+
+All notable changes to this project will be documented in this file.
+
+---
+
+## [1.7.1] - 2026-04-18
+
+### 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
+
+### 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
+

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,95 @@
+# KeshavSoft
+
+Simple tools. Clean architecture. Fast development.
+
+---
+
+## @keshavsoft/kschema
+
+A lightweight schema-driven JSON database for Node.js.
+
+---
+
+## 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);
+
+---
+
+## API
+
+Create
+
+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
+
+GitHub: https://github.com/keshavsoft/kschema
+NPM: https://www.npmjs.com/package/@keshavsoft/kschema
+Website: https://keshavsoft.com
+
+---
+
+## Contact
+
+Email: founder@keshavsoft.com
+
+---
+
+## About
+
+KeshavSoft builds simple and practical developer tools focused on clarity, speed, and real-world usage.
+
+---
+
+## License
+
+MIT License — see LICENSE file

package/bin/cli.js

@@ -0,0 +1,20 @@
+#!/usr/bin/env node
+
+import init from "../commands/init.js";
+import test from "../commands/test.js";
+
+const cmd = process.argv[2];
+const arg = process.argv[3];
+
+switch (cmd) {
+    case "init":
+        init(arg);
+        break;
+
+    case "test":
+        test(arg);
+        break;
+
+    default:
+        console.log("Usage: kschema <init|test> [name]");
+}

package/commands/init.js

@@ -0,0 +1,20 @@
+// commands/init.js
+
+import fs from "fs";
+import path from "path";
+import { fileURLToPath } from "url";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+export default (arg) => {
+    const folderName = arg || "KehavSoft1";
+
+    const source = path.join(__dirname, "../template");
+    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/commands/test.js

@@ -0,0 +1,36 @@
+// commands/test.js
+
+import fs from "fs";
+import path from "path";
+
+export default (arg) => {
+    const projectPath = arg
+        ? path.resolve(process.cwd(), arg)
+        : process.cwd();
+
+    // 1. Check folder exists
+    if (!fs.existsSync(projectPath)) {
+        console.log("Invalid path");
+        return;
+    }
+
+    // 2. Check required structure
+    const hasConfigJson = fs.existsSync(
+        path.join(projectPath, "config.json")
+    );
+
+    const hasConfigFolder = fs.existsSync(
+        path.join(projectPath, "Config")
+    );
+
+    const hasSchemasFolder = fs.existsSync(
+        path.join(projectPath, "Config", "Schemas")
+    );
+
+    // 3. Final decision
+    if (hasConfigJson && hasConfigFolder && hasSchemasFolder) {
+        console.log("Already initialized");
+    } else {
+        console.log("Not initialized");
+    }
+};

package/dev.md

@@ -0,0 +1,74 @@
+# @keshavsoft/kschema
+
+A minimal config store for loading and accessing JSON configuration across your application.
+
+---
+
+## 🚀 Installation
+
+```bash
+npm install @keshavsoft/kschema
+```
+
+---
+
+## 📦 Usage
+
+```js
+import { loadConfig, getConfig } from "@keshavsoft/kschema";
+
+loadConfig({ name: "test" });
+
+console.log(getConfig());
+```
+
+---
+
+## 🧠 API
+
+### loadConfig(config)
+
+Loads the configuration into memory.
+
+* `config` → Object
+
+---
+
+### getConfig()
+
+Returns the loaded configuration.
+
+* Throws error if config is not loaded
+
+---
+
+## ⚠️ Notes
+
+* Config is stored in-memory
+* Must call `loadConfig` before `getConfig`
+
+---
+
+## 📌 Example
+
+```js
+loadConfig({ user: "keshav" });
+
+const data = getConfig();
+
+console.log(data.user); // keshav
+```
+
+---
+
+## 🛠 Future Scope
+
+* Validation support
+* Config updates
+* Remote config loading
+
+---
+
+## 👨‍💻 Author
+
+KeshavSoft

package/index.js

@@ -0,0 +1 @@
+export * from "./src/v8/index.js";

package/package.json

@@ -0,0 +1,16 @@
+{
+  "name": "@keshavsoft/kschema-cli",
+  "version": "1.1.1",
+  "type": "module",
+  "bin": {
+    "kschema": "./bin/cli.js"
+  },
+  "homepage": "https://keshavsoft.com",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/keshavsoft/kschema-cli"
+  },
+  "bugs": {
+    "url": "https://github.com/keshavsoft/kschema-cli/issues"
+  }
+}

package/src/core/configStore.js

@@ -0,0 +1,10 @@
+let _config = null;
+
+export const loadConfig = (config) => {
+    _config = config;
+};
+
+export const getConfig = () => {
+    if (!_config) throw new Error("Config not loaded");
+    return _config;
+};

package/src/utils/pathBuilder.js

@@ -0,0 +1,3 @@
+export const buildDataPath = (cfg, fileName) => {
+    return `${cfg.DataPath}/${fileName}.json`;
+};

package/src/v1/data/deleteData.js

@@ -0,0 +1,16 @@
+import fs from "fs";
+import { getConfig } from "../../core/configStore.js";
+import { buildDataPath } from "../../utils/pathBuilder.js";
+
+export const deleteData = ({ table, key, value }) => {
+    const cfg = getConfig();
+    const path = buildDataPath(cfg, table);
+
+    const data = JSON.parse(fs.readFileSync(path));
+
+    const newData = data.filter(item => item[key] !== value);
+
+    fs.writeFileSync(path, JSON.stringify(newData, null, 2));
+
+    return true;
+};

package/src/v1/data/getData.js

@@ -0,0 +1,13 @@
+import fs from "fs";
+import { getConfig } from "../../core/configStore.js";
+import { buildDataPath } from "../../utils/pathBuilder.js";
+
+export const getData = ({ table }) => {
+  const cfg = getConfig();
+
+  const path = buildDataPath(cfg, table);
+
+  const data = fs.readFileSync(path, "utf-8");
+
+  return JSON.parse(data);
+};

package/src/v1/data/index.js

@@ -0,0 +1,4 @@
+export { getData } from "./getData.js";
+export { insertData } from "./insertData.js";
+export { updateData } from "./updateData.js";
+export { deleteData } from "./deleteData.js";

package/src/v1/data/insertData.js

@@ -0,0 +1,16 @@
+import fs from "fs";
+import { getConfig } from "../../core/configStore.js";
+import { buildDataPath } from "../../utils/pathBuilder.js";
+
+export const insertData = ({ table, record }) => {
+    const cfg = getConfig();
+    const path = buildDataPath(cfg, table);
+
+    const data = JSON.parse(fs.readFileSync(path));
+
+    data.push(record);
+
+    fs.writeFileSync(path, JSON.stringify(data, null, 2));
+
+    return record;
+};

package/src/v1/data/updateData.js

@@ -0,0 +1,20 @@
+import fs from "fs";
+import { getConfig } from "../../core/configStore.js";
+import { buildDataPath } from "../../utils/pathBuilder.js";
+
+export const updateData = ({ table, key, value, updates }) => {
+    const cfg = getConfig();
+    const path = buildDataPath(cfg, table);
+
+    const data = JSON.parse(fs.readFileSync(path));
+
+    const index = data.findIndex(item => item[key] === value);
+
+    if (index === -1) throw new Error("Record not found");
+
+    data[index] = { ...data[index], ...updates };
+
+    fs.writeFileSync(path, JSON.stringify(data, null, 2));
+
+    return data[index];
+};

package/src/v1/index.js

@@ -0,0 +1,3 @@
+export { loadConfig, getConfig } from "../core/configStore.js";
+
+export * from "./data/index.js";

package/src/v2/config/getSchema.js

@@ -0,0 +1,12 @@
+import fs from "fs";
+import { getConfig } from "../../core/configStore.js";
+
+export const getSchema = (table) => {
+    const config = getConfig();
+
+    const schemaPath = `${config.SchemaPath}/${table}.json`;
+
+    const schema = fs.readFileSync(schemaPath, "utf-8");
+
+    return JSON.parse(schema);
+};

package/src/v2/data/deleteData.js

@@ -0,0 +1,16 @@
+import fs from "fs";
+import { getConfig } from "../../core/configStore.js";
+import { buildDataPath } from "../../utils/pathBuilder.js";
+
+export const deleteData = ({ table, key, value }) => {
+    const cfg = getConfig();
+    const path = buildDataPath(cfg, table);
+
+    const data = JSON.parse(fs.readFileSync(path));
+
+    const newData = data.filter(item => item[key] !== value);
+
+    fs.writeFileSync(path, JSON.stringify(newData, null, 2));
+
+    return true;
+};

package/src/v2/data/getData.js

@@ -0,0 +1,13 @@
+import fs from "fs";
+import { getConfig } from "../../core/configStore.js";
+import { buildDataPath } from "../../utils/pathBuilder.js";
+
+export const getData = ({ table }) => {
+  const cfg = getConfig();
+
+  const path = buildDataPath(cfg, table);
+
+  const data = fs.readFileSync(path, "utf-8");
+
+  return JSON.parse(data);
+};

package/src/v2/data/index.js

@@ -0,0 +1,4 @@
+export { getData } from "./getData.js";
+export { insertData } from "./insertData.js";
+export { updateData } from "./updateData.js";
+export { deleteData } from "./deleteData.js";

package/src/v2/data/insertData copy.js

@@ -0,0 +1,46 @@
+import fs from "fs";
+import { getConfig } from "../../core/configStore.js";
+import { buildDataPath } from "../../utils/pathBuilder.js";
+
+// 🔹 helpers
+
+const getPrimaryKey = (columns) => {
+    const pk = columns.find(c => c.unique)?.field;
+    if (!pk) throw new Error("Primary key not defined");
+    return pk;
+};
+
+const readData = (path) => {
+    return JSON.parse(fs.readFileSync(path));
+};
+
+const writeData = (path, data) => {
+    fs.writeFileSync(path, JSON.stringify(data, null, 2));
+};
+
+const attachPrimaryKey = (record, pk) => {
+    return {
+        ...record,
+        [pk]: Date.now()
+    };
+};
+
+// 🔹 main
+
+export const insertData = ({ table, record }) => {
+    const config = getConfig();
+    const schema = config[table];
+
+    const pk = getPrimaryKey(schema.columns);
+    const path = buildDataPath(config, table);
+
+    const data = readData(path);
+
+    const newRecord = attachPrimaryKey(record, pk);
+
+    data.push(newRecord);
+
+    writeData(path, data);
+
+    return newRecord;
+};

package/src/v2/data/insertData.js

@@ -0,0 +1,52 @@
+import fs from "fs";
+import { getConfig } from "../../core/configStore.js";
+import { buildDataPath } from "../../utils/pathBuilder.js";
+import { getSchema } from "../config/getSchema.js";
+// 🔹 helpers
+
+const getPrimaryKey = (columns) => {
+    const pk = columns.find(c => c.unique)?.field;
+    if (!pk) throw new Error("Primary key not defined");
+    return pk;
+};
+
+const readData = (path) => {
+    if (!fs.existsSync(path)) return [];
+    return JSON.parse(fs.readFileSync(path));
+};
+
+const writeData = (path, data) => {
+    fs.writeFileSync(path, JSON.stringify(data, null, 2));
+};
+
+const attachPrimaryKey = (record, pk, data) => {
+    if (data.length === 0) {
+        return { ...record, [pk]: 1 };
+    }
+
+    const maxId = Math.max(...data.map(row => row[pk] || 0));
+
+    return {
+        ...record,
+        [pk]: maxId + 1
+    };
+};
+// 🔹 main
+
+export const insertData = ({ table, record }) => {
+    const config = getConfig();
+    const schema = getSchema(table);
+
+    const pk = getPrimaryKey(schema.columns);
+    const path = buildDataPath(config, table);
+
+    const data = readData(path);
+
+    const newRecord = attachPrimaryKey(record, pk, data);
+
+    data.push(newRecord);
+
+    writeData(path, data);
+
+    return newRecord;
+};

package/src/v2/data/updateData.js

@@ -0,0 +1,20 @@
+import fs from "fs";
+import { getConfig } from "../../core/configStore.js";
+import { buildDataPath } from "../../utils/pathBuilder.js";
+
+export const updateData = ({ table, key, value, updates }) => {
+    const cfg = getConfig();
+    const path = buildDataPath(cfg, table);
+
+    const data = JSON.parse(fs.readFileSync(path));
+
+    const index = data.findIndex(item => item[key] === value);
+
+    if (index === -1) throw new Error("Record not found");
+
+    data[index] = { ...data[index], ...updates };
+
+    fs.writeFileSync(path, JSON.stringify(data, null, 2));
+
+    return data[index];
+};

package/src/v2/index.js

@@ -0,0 +1,3 @@
+export { loadConfig, getConfig } from "../core/configStore.js";
+
+export * from "./data/index.js";

package/src/v3/config/getSchema.js

@@ -0,0 +1,12 @@
+import fs from "fs";
+import { getConfig } from "../../core/configStore.js";
+
+export const getSchema = (table) => {
+    const config = getConfig();
+
+    const schemaPath = `${config.SchemaPath}/${table}.json`;
+
+    const schema = fs.readFileSync(schemaPath, "utf-8");
+
+    return JSON.parse(schema);
+};

package/src/v3/data/deleteData.js

@@ -0,0 +1,16 @@
+import fs from "fs";
+import { getConfig } from "../../core/configStore.js";
+import { buildDataPath } from "../../utils/pathBuilder.js";
+
+export const deleteData = ({ table, key, value }) => {
+    const cfg = getConfig();
+    const path = buildDataPath(cfg, table);
+
+    const data = JSON.parse(fs.readFileSync(path));
+
+    const newData = data.filter(item => item[key] !== value);
+
+    fs.writeFileSync(path, JSON.stringify(newData, null, 2));
+
+    return true;
+};

package/src/v3/data/getData.js

@@ -0,0 +1,13 @@
+import fs from "fs";
+import { getConfig } from "../../core/configStore.js";
+import { buildDataPath } from "../../utils/pathBuilder.js";
+
+export const getData = ({ table }) => {
+  const cfg = getConfig();
+
+  const path = buildDataPath(cfg, table);
+
+  const data = fs.readFileSync(path, "utf-8");
+
+  return JSON.parse(data);
+};

package/src/v3/data/index.js

@@ -0,0 +1,4 @@
+export { getData } from "./getData.js";
+export { insertData } from "./insertData.js";
+export { updateData } from "./updateData.js";
+export { deleteData } from "./deleteData.js";

package/src/v3/data/insertData.js

@@ -0,0 +1,27 @@
+import { getConfig } from "../../core/configStore.js";
+import { buildDataPath } from "../../utils/pathBuilder.js";
+import { getSchema } from "../config/getSchema.js";
+
+import { getPrimaryKey, attachPrimaryKey } from "../helpers/pkHelper.js";
+import { readData, writeData } from "../helpers/fileHelper.js";
+import { validateRecord } from "../helpers/validateHelper.js";
+
+export const insertData = ({ table, record }) => {
+    const config = getConfig();
+    const schema = getSchema(table);
+
+    const pk = getPrimaryKey(schema.columns);
+    const path = buildDataPath(config, table);
+
+    const data = readData(path);
+
+    validateRecord(record, schema.columns, data);
+
+    const newRecord = attachPrimaryKey(record, pk, data);
+
+    data.push(newRecord);
+
+    writeData(path, data);
+
+    return newRecord;
+};