@keshavsoft/kschema-cli 1.1.1

package/src/v6/data/insertDataStrict.js

@@ -0,0 +1,76 @@
+/**
+ * insertDataStrict - Strict Orchestration Flow
+ *
+ * 1. Load config & schema
+ * 2. Resolve primary key + file path
+ * 3. Reject manual primary key input
+ * 4. Reject extra fields (only schema fields allowed)
+ * 5. Read existing data
+ * 6. Normalize record (keep only schema fields)
+ * 7. Validate (required + unique on schema columns)
+ * 8. Attach primary key (auto increment)
+ * 9. Push + persist to file
+ * 10. Return inserted record
+ *
+ * Notes:
+ * - Only schema-defined fields are allowed
+ * - Any extra field will throw an error
+ * - Primary key is system-generated only
+ */
+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";
+import { normalizeRecord } from "../helpers/recordHelper.js";
+
+export const insertDataStrict = ({ table, record }) => {
+    try {
+        const config = getConfig();
+        const schema = getSchema(table);
+
+        const pk = getPrimaryKey(schema.columns);
+        const path = buildDataPath(config, table);
+
+        const schemaFields = schema.columns.map(c => c.field);
+
+        if (pk in record) {
+            throw new Error(`Primary key '${pk}' should not be provided`);
+        }
+
+        const extraFields = Object.keys(record).filter(
+            key => !schemaFields.includes(key)
+        );
+
+        if (extraFields.length) {
+            throw new Error(`Invalid fields: ${extraFields.join(", ")}`);
+        }
+
+        const data = readData(path);
+
+        const cleanRecord = normalizeRecord(record, schema.columns);
+
+        validateRecord(cleanRecord, schema.columns, data);
+
+        const newRecord = attachPrimaryKey(cleanRecord, pk, data);
+
+        data.push(newRecord);
+
+        writeData(path, data);
+
+        // return newRecord;
+
+        // existing logic...
+        return { success: true, data: newRecord };
+    } catch (err) {
+        return {
+            success: false,
+            error: {
+                message: err.message,
+                code: "VALIDATION_ERROR"
+            }
+        };
+    };
+};

package/src/v6/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/v6/helpers/fileHelper.js

@@ -0,0 +1,11 @@
+// v3/helpers/fileHelper.js
+import fs from "fs";
+
+export const readData = (path) => {
+    if (!fs.existsSync(path)) return [];
+    return JSON.parse(fs.readFileSync(path, "utf-8"));
+};
+
+export const writeData = (path, data) => {
+    fs.writeFileSync(path, JSON.stringify(data, null, 2));
+};

package/src/v6/helpers/pkHelper.js

@@ -0,0 +1,18 @@
+// v3/helpers/pkHelper.js
+
+export const getPrimaryKey = (columns) => {
+    const pkColumn = columns.find(c => c.primary);
+    if (!pkColumn) throw new Error("Primary key not defined");
+    return pkColumn.field;
+};
+
+export const attachPrimaryKey = (record, pk, data) => {
+    const maxId = data.length
+        ? Math.max(...data.map(row => row[pk] || 0))
+        : 0;
+
+    return {
+        ...record,
+        [pk]: maxId + 1
+    };
+};

package/src/v6/helpers/recordHelper.js

@@ -0,0 +1,9 @@
+export const normalizeRecord = (record, columns) => {
+    const clean = {};
+    columns.forEach(col => {
+        if (record[col.field] !== undefined) {
+            clean[col.field] = record[col.field];
+        }
+    });
+    return clean;
+};

package/src/v6/helpers/validateHelper.js

@@ -0,0 +1,15 @@
+export const validateRecord = (record, columns, data) => {
+    columns.forEach(col => {
+        const value = record[col.field];
+
+        if (col.required && (value === undefined || value === "")) {
+            throw new Error(`${col.field} is required`);
+        }
+
+        if (value === undefined) return;
+
+        if (col.unique && data.some(r => r[col.field] === value)) {
+            throw new Error(`${col.field} must be unique`);
+        }
+    });
+};

package/src/v6/index.js

@@ -0,0 +1,21 @@
+import { loadConfig, getConfig } from "../core/configStore.js";
+import {
+    insertData,
+    getData,
+    updateData,
+    deleteData,
+    insertDataStrict
+} from "./data/index.js";
+
+export const kschema = {
+    loadConfig,
+    getConfig,
+
+    table: (table) => ({
+        insert: (record) => insertData({ table, record }),
+        get: () => getData({ table }),
+        update: (record) => updateData({ table, record }),
+        delete: (id) => deleteData({ table, id }),
+        insertStrict: (record) => insertDataStrict({ table, record }),
+    })
+};

package/src/v7/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/v7/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/v7/data/filterByColumns.js

@@ -0,0 +1,19 @@
+import { getConfig } from "../../core/configStore.js";
+import { buildDataPath } from "../../utils/pathBuilder.js";
+import { getSchema } from "../config/getSchema.js";
+
+import { readData } from "../helpers/fileHelper.js";
+import { applyFilter } from "../helpers/recordHelper.js";
+import { validateFilterKeys } from "../helpers/validateHelper.js";
+
+export const filterByColumnsData = ({ table, filter }) => {
+    const cfg = getConfig();
+    const schema = getSchema(table);
+
+    validateFilterKeys(filter, schema.columns);
+
+    const path = buildDataPath(cfg, table);
+    const data = readData(path);
+
+    return applyFilter(data, filter);
+};

package/src/v7/data/filterByPk.js

@@ -0,0 +1,16 @@
+import { getConfig } from "../../core/configStore.js";
+import { buildDataPath } from "../../utils/pathBuilder.js";
+import { getPrimaryKey } from "../helpers/pkHelper.js";
+import { getSchema } from "../config/getSchema.js";
+import { readData } from "../helpers/fileHelper.js";
+
+export const filterByPkData = ({ table, id }) => {
+  const cfg = getConfig();
+  const schema = getSchema(table);
+  const pk = getPrimaryKey(schema.columns);
+
+  const path = buildDataPath(cfg, table);
+  const data = readData(path);
+
+  return data.filter(row => Number(row[pk]) === Number(id));
+};

package/src/v7/data/findByColumns.js

@@ -0,0 +1,21 @@
+import { getConfig } from "../../core/configStore.js";
+import { buildDataPath } from "../../utils/pathBuilder.js";
+import { getSchema } from "../config/getSchema.js";
+
+import { readData } from "../helpers/fileHelper.js";
+import { applyFilter } from "../helpers/recordHelper.js";
+import { validateFilterKeys } from "../helpers/validateHelper.js";
+
+export const findByColumnsData = ({ table, filter }) => {
+    const cfg = getConfig();
+    const schema = getSchema(table);
+
+    validateFilterKeys(filter, schema.columns);
+
+    const path = buildDataPath(cfg, table);
+    const data = readData(path);
+
+    return data.find(row =>
+        Object.keys(filter).every(key => row[key] === filter[key])
+    ) || null;
+};

package/src/v7/data/findByPk.js

@@ -0,0 +1,16 @@
+import { getConfig } from "../../core/configStore.js";
+import { buildDataPath } from "../../utils/pathBuilder.js";
+import { getPrimaryKey } from "../helpers/pkHelper.js";
+import { getSchema } from "../config/getSchema.js";
+import { readData } from "../helpers/fileHelper.js";
+
+export const findByPkData = ({ table, id }) => {
+  const cfg = getConfig();
+  const schema = getSchema(table);
+  const pk = getPrimaryKey(schema.columns);
+
+  const path = buildDataPath(cfg, table);
+  const data = readData(path);
+
+  return data.find(row => Number(row[pk]) === Number(id)) || null;
+};

package/src/v7/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/v7/data/index.js

@@ -0,0 +1,11 @@
+export { getData } from "./getData.js";
+export { insertData } from "./insertData.js";
+export { insertDataStrict } from "./insertDataStrict.js";
+
+export { updateData } from "./updateData.js";
+export { deleteData } from "./deleteData.js";
+
+export { findByPkData } from "./findByPk.js";
+export { filterByPkData } from "./filterByPk.js";
+
+export { filterByColumnsData } from "./filterByColumns.js";

package/src/v7/data/insertData.js

@@ -0,0 +1,55 @@
+/**
+ * insertData - Orchestration Flow
+ *
+ * 1. Load config & schema
+ * 2. Resolve primary key + file path
+ * 3. Read existing data
+ * 4. Prepare record (allow extra fields, validate only schema fields)
+ * 5. Validate (required + unique only on schema columns)
+ * 6. Attach primary key (auto increment)
+ * 7. Push + persist to file
+ * 8. Return inserted record
+ *
+ * Notes:
+ * - Extra fields are NOT validated but are stored
+ * - Schema drives validation, not storage
+ */
+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";
+import { normalizeRecord } from "../helpers/recordHelper.js";
+
+/**
+ * Inserts a record into the data store
+ *
+ * @param {Object} params
+ * @param {string} params.table - Table name
+ * @param {Object} params.record - Record data to insert
+ *
+ * @returns {Object} Inserted record with primary key
+ */
+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 cleanRecord = { ...record };
+
+    validateRecord(cleanRecord, schema.columns, data);
+
+    const newRecord = attachPrimaryKey(cleanRecord, pk, data);
+
+    data.push(newRecord);
+
+    writeData(path, data);
+
+    return newRecord[pk];
+};

package/src/v7/data/insertDataStrict.js

@@ -0,0 +1,73 @@
+/**
+ * insertDataStrict - Strict Orchestration Flow
+ *
+ * 1. Load config & schema
+ * 2. Resolve primary key + file path
+ * 3. Reject manual primary key input
+ * 4. Reject extra fields (only schema fields allowed)
+ * 5. Read existing data
+ * 6. Normalize record (keep only schema fields)
+ * 7. Validate (required + unique on schema columns)
+ * 8. Attach primary key (auto increment)
+ * 9. Push + persist to file
+ * 10. Return inserted record
+ *
+ * Notes:
+ * - Only schema-defined fields are allowed
+ * - Any extra field will throw an error
+ * - Primary key is system-generated only
+ */
+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";
+import { normalizeRecord } from "../helpers/recordHelper.js";
+
+export const insertDataStrict = ({ table, record }) => {
+    try {
+        const config = getConfig();
+        const schema = getSchema(table);
+
+        const pk = getPrimaryKey(schema.columns);
+        const path = buildDataPath(config, table);
+
+        const schemaFields = schema.columns.map(c => c.field);
+
+        if (pk in record) {
+            throw new Error(`Primary key '${pk}' should not be provided`);
+        };
+
+        const extraFields = Object.keys(record).filter(
+            key => !schemaFields.includes(key)
+        );
+
+        if (extraFields.length) {
+            throw new Error(`Invalid fields: ${extraFields.join(", ")}`);
+        };
+
+        const data = readData(path);
+
+        const cleanRecord = normalizeRecord(record, schema.columns);
+
+        validateRecord(cleanRecord, schema.columns, data);
+
+        const newRecord = attachPrimaryKey(cleanRecord, pk, data);
+
+        data.push(newRecord);
+
+        writeData(path, data);
+
+        return pk;
+    } catch (err) {
+        return {
+            success: false,
+            error: {
+                message: err.message,
+                code: "VALIDATION_ERROR"
+            }
+        };
+    };
+};

package/src/v7/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/v7/helpers/fileHelper.js

@@ -0,0 +1,16 @@
+import fs from "fs";
+
+export const readData = (path) => {
+    if (!fs.existsSync(path)) return [];
+    return JSON.parse(fs.readFileSync(path, "utf-8"));
+};
+
+export const writeData = (path, data) => {
+    fs.writeFileSync(path, JSON.stringify(data, null, 2));
+};
+
+export const applyFilter = (data, filter) => {
+    return data.filter(row =>
+        Object.keys(filter).every(key => row[key] === filter[key])
+    );
+};

package/src/v7/helpers/pkHelper.js

@@ -0,0 +1,21 @@
+// v3/helpers/pkHelper.js
+
+export const getPrimaryKey = (columns) => {
+    const pkColumn = columns.find(c => c.primary);
+    if (!pkColumn) throw new Error("Primary key not defined");
+    return pkColumn.field;
+};
+
+export const attachPrimaryKey = (record, pk, data) => {
+    let maxId = 0;
+
+    for (const row of data) {
+        const val = Number(row[pk]) || 0;
+        if (val > maxId) maxId = val;
+    }
+
+    return {
+        ...record,
+        [pk]: maxId + 1
+    };
+};

package/src/v7/helpers/recordHelper.js

@@ -0,0 +1,15 @@
+export const normalizeRecord = (record, columns) => {
+    const clean = {};
+    columns.forEach(col => {
+        if (record[col.field] !== undefined) {
+            clean[col.field] = record[col.field];
+        }
+    });
+    return clean;
+};
+
+export const applyFilter = (data, filter) => {
+    return data.filter(row =>
+        Object.keys(filter).every(key => row[key] === filter[key])
+    );
+};

package/src/v7/helpers/validateHelper.js

@@ -0,0 +1,27 @@
+export const validateRecord = (record, columns, data) => {
+    columns.forEach(col => {
+        const value = record[col.field];
+
+        if (col.required && (value === undefined || value === null || value === "")) {
+            throw new Error(`${col.field} is required`);
+        }
+
+        if (value === undefined) return;
+
+        if (col.unique && data.some(r => r[col.field] === value)) {
+            throw new Error(`${col.field} must be unique`);
+        }
+    });
+};
+
+export const validateFilterKeys = (filter, columns) => {
+    const validColumns = columns.map(col => col.field);
+
+    const invalidKeys = Object.keys(filter).filter(
+        key => !validColumns.includes(key)
+    );
+
+    if (invalidKeys.length > 0) {
+        throw new Error(`Invalid columns: ${invalidKeys.join(", ")}`);
+    };
+};

package/src/v7/index.js

@@ -0,0 +1,27 @@
+import { loadConfig, getConfig } from "../core/configStore.js";
+import {
+    insertData,
+    getData,
+    updateData,
+    deleteData,
+    insertDataStrict,
+    findByPkData,
+    filterByPkData,
+    filterByColumnsData
+} from "./data/index.js";
+
+export const kschema = {
+    loadConfig,
+    getConfig,
+
+    table: (table) => ({
+        insert: (record) => insertData({ table, record }),
+        get: () => getData({ table }),
+        update: (record) => updateData({ table, record }),
+        delete: (id) => deleteData({ table, id }),
+        insertStrict: (record) => insertDataStrict({ table, record }),
+        findByPk: (id) => findByPkData({ table, id }),
+        filterByPk: (id) => filterByPkData({ table, id }),
+        filterByColumns: (filter) => filterByColumnsData({ table, filter }),
+    })
+};

package/src/v8/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/v8/data/deleteByColumnsData.js

@@ -0,0 +1,20 @@
+import { getConfig } from "../../core/configStore.js";
+import { buildDataPath } from "../../utils/pathBuilder.js";
+import { readData, writeData } from "../helpers/fileHelper.js";
+import { applyFilter } from "../helpers/recordHelper.js";
+
+const deleteByColumnsData = ({ table, filter }) => {
+    const config = getConfig();
+    const path = buildDataPath(config, table);
+    const data = readData(path);
+
+    const toDelete = applyFilter(data, filter);
+    if (toDelete.length === 0) throw new Error(`No records match filter`);
+
+    const newData = data.filter(item => !toDelete.includes(item));
+    writeData(path, newData);
+
+    return toDelete.length;
+};
+
+export { deleteByColumnsData };

package/src/v8/data/deleteData.js

@@ -0,0 +1,22 @@
+import { getConfig } from "../../core/configStore.js";
+import { buildDataPath } from "../../utils/pathBuilder.js";
+import { getSchema } from "../config/getSchema.js";
+import { getPrimaryKey } from "../helpers/pkHelper.js";
+import { readData, writeData } from "../helpers/fileHelper.js";
+
+const deleteData = ({ table, id }) => {
+    const config = getConfig();
+    const path = buildDataPath(config, table);
+
+    const pk = getPrimaryKey(getSchema(table).columns);
+
+    const data = readData(path);
+
+    if (!data.some(item => item[pk] === id)) throw new Error(`${pk}: ${id} not found`);
+
+    writeData(path, data.filter(item => item[pk] !== id));
+
+    return true;
+};
+
+export { deleteData };

package/src/v8/data/filterByColumns.js

@@ -0,0 +1,19 @@
+import { getConfig } from "../../core/configStore.js";
+import { buildDataPath } from "../../utils/pathBuilder.js";
+import { getSchema } from "../config/getSchema.js";
+
+import { readData } from "../helpers/fileHelper.js";
+import { applyFilter } from "../helpers/recordHelper.js";
+import { validateFilterKeys } from "../helpers/validateHelper.js";
+
+export const filterByColumnsData = ({ table, filter }) => {
+    const cfg = getConfig();
+    const schema = getSchema(table);
+
+    validateFilterKeys(filter, schema.columns);
+
+    const path = buildDataPath(cfg, table);
+    const data = readData(path);
+
+    return applyFilter(data, filter);
+};

package/src/v8/data/filterByPk.js

@@ -0,0 +1,16 @@
+import { getConfig } from "../../core/configStore.js";
+import { buildDataPath } from "../../utils/pathBuilder.js";
+import { getPrimaryKey } from "../helpers/pkHelper.js";
+import { getSchema } from "../config/getSchema.js";
+import { readData } from "../helpers/fileHelper.js";
+
+export const filterByPkData = ({ table, id }) => {
+  const cfg = getConfig();
+  const schema = getSchema(table);
+  const pk = getPrimaryKey(schema.columns);
+
+  const path = buildDataPath(cfg, table);
+  const data = readData(path);
+
+  return data.filter(row => Number(row[pk]) === Number(id));
+};