@stonyx/orm 0.3.2-beta.0 → 0.3.2-beta.1

package/dist/index.js

@@ -29,6 +29,11 @@ export { count, avg, sum, min, max }; // aggregate helpers
 export { beforeHook, afterHook, clearHook, clearAllHooks } from './hooks.js'; // middleware hooks
 // Store API:
 // store.get(model, id)   -- sync, memory-only
-// store.find(model, id)  -- async, MySQL for memory:false models
+// store.find(model, id)  -- async, SQL for memory:false models
 // store.findAll(model)   -- async, all records
-// store.query(model, conditions) -- async, always hits MySQL
+// store.query(model, conditions) -- async, always hits SQL
+//
+// Programmatic CRUD (memory + SQL persistence):
+// Orm.create(model, data)      -- async, createRecord + sqlDb.persist
+// Orm.update(model, id, data)  -- async, updateRecord + sqlDb.persist
+// Orm.remove(model, id)        -- async, sqlDb.persist + store.remove

package/dist/main.d.ts

@@ -1,4 +1,5 @@
 import Store from './store.js';
+import type { OrmRecord } from './types/orm-types.js';
 interface OrmOptions {
     dbType?: string;
 }
@@ -39,6 +40,21 @@ export default class Orm {
         serializerClass: unknown;
     };
     isView(modelName: string): boolean;
+    /**
+     * Programmatic create — writes to memory AND persists to SQL database.
+     * Use instead of createRecord() when records must be persisted to PostgreSQL/TimescaleDB.
+     */
+    static create(modelName: string, data?: Record<string, unknown>): Promise<OrmRecord>;
+    /**
+     * Programmatic update — updates in memory AND persists to SQL database.
+     * Captures old state for diff-based UPDATE queries.
+     */
+    static update(modelName: string, id: string | number, data: Record<string, unknown>): Promise<OrmRecord>;
+    /**
+     * Programmatic delete — removes from SQL database AND memory store.
+     * SQL delete runs first to ensure consistency on failure.
+     */
+    static remove(modelName: string, id: string | number): Promise<void>;
     warn(message: string): void;
 }
 export declare const store: Store;

package/dist/main.js

@@ -24,6 +24,7 @@ import baseTransforms from './transforms.js';
 import Store from './store.js';
 import Serializer from './serializer.js';
 import { setup } from '@stonyx/events';
+import { isOrmRecord } from './utils.js';
 const defaultOptions = {
     dbType: 'json'
 };
@@ -168,6 +169,55 @@ export default class Orm {
         const modelClassPrefix = kebabCaseToPascalCase(modelName);
         return !!this.views[`${modelClassPrefix}View`];
     }
+    /**
+     * Programmatic create — writes to memory AND persists to SQL database.
+     * Use instead of createRecord() when records must be persisted to PostgreSQL/TimescaleDB.
+     */
+    static async create(modelName, data = {}) {
+        if (!Orm.initialized)
+            throw new Error('ORM is not ready');
+        const { createRecord } = await import('./manage-record.js');
+        const record = createRecord(modelName, data, { serialize: false });
+        if (Orm.instance.sqlDb) {
+            const response = { data: { id: record.id } };
+            await Orm.instance.sqlDb.persist('create', modelName, {}, response);
+        }
+        return record;
+    }
+    /**
+     * Programmatic update — updates in memory AND persists to SQL database.
+     * Captures old state for diff-based UPDATE queries.
+     */
+    static async update(modelName, id, data) {
+        if (!Orm.initialized)
+            throw new Error('ORM is not ready');
+        const record = Orm.store.get(modelName, id);
+        if (!record || !isOrmRecord(record))
+            throw new Error(`Record ${modelName}:${id} not found`);
+        const oldState = JSON.parse(JSON.stringify(record.__data));
+        // Apply attribute updates directly, matching the REST handler pattern
+        for (const [key, value] of Object.entries(data)) {
+            if (key === 'id')
+                continue;
+            record[key] = value;
+        }
+        if (Orm.instance.sqlDb) {
+            await Orm.instance.sqlDb.persist('update', modelName, { record, oldState }, {});
+        }
+        return record;
+    }
+    /**
+     * Programmatic delete — removes from SQL database AND memory store.
+     * SQL delete runs first to ensure consistency on failure.
+     */
+    static async remove(modelName, id) {
+        if (!Orm.initialized)
+            throw new Error('ORM is not ready');
+        if (Orm.instance.sqlDb) {
+            await Orm.instance.sqlDb.persist('delete', modelName, { recordId: id }, {});
+        }
+        Orm.store.remove(modelName, id);
+    }
     // Queue warnings to avoid the same error from being logged in the same iteration
     warn(message) {
         this.warnings.add(message);

package/package.json

@@ -4,7 +4,7 @@
     "stonyx-async",
     "stonyx-module"
   ],
-  "version": "0.3.2-beta.0",
+  "version": "0.3.2-beta.1",
   "description": "",
   "main": "dist/index.js",
   "type": "module",

package/src/index.ts

@@ -33,6 +33,11 @@ export { beforeHook, afterHook, clearHook, clearAllHooks } from './hooks.js'; //
 
 // Store API:
 // store.get(model, id)   -- sync, memory-only
-// store.find(model, id)  -- async, MySQL for memory:false models
+// store.find(model, id)  -- async, SQL for memory:false models
 // store.findAll(model)   -- async, all records
-// store.query(model, conditions) -- async, always hits MySQL
+// store.query(model, conditions) -- async, always hits SQL
+//
+// Programmatic CRUD (memory + SQL persistence):
+// Orm.create(model, data)      -- async, createRecord + sqlDb.persist
+// Orm.update(model, id, data)  -- async, updateRecord + sqlDb.persist
+// Orm.remove(model, id)        -- async, sqlDb.persist + store.remove

package/src/main.ts

@@ -25,6 +25,8 @@ import baseTransforms from './transforms.js';
 import Store from './store.js';
 import Serializer from './serializer.js';
 import { setup } from '@stonyx/events';
+import type { OrmRecord } from './types/orm-types.js';
+import { isOrmRecord } from './utils.js';
 
 interface OrmOptions {
   dbType?: string;
@@ -214,6 +216,63 @@ export default class Orm {
     return !!this.views[`${modelClassPrefix}View`];
   }
 
+  /**
+   * Programmatic create — writes to memory AND persists to SQL database.
+   * Use instead of createRecord() when records must be persisted to PostgreSQL/TimescaleDB.
+   */
+  static async create(modelName: string, data: Record<string, unknown> = {}): Promise<OrmRecord> {
+    if (!Orm.initialized) throw new Error('ORM is not ready');
+
+    const { createRecord } = await import('./manage-record.js');
+    const record = createRecord(modelName, data, { serialize: false }) as unknown as OrmRecord;
+
+    if (Orm.instance.sqlDb) {
+      const response: { data: { id: unknown } } = { data: { id: record.id } };
+      await Orm.instance.sqlDb.persist('create', modelName, {}, response);
+    }
+
+    return record;
+  }
+
+  /**
+   * Programmatic update — updates in memory AND persists to SQL database.
+   * Captures old state for diff-based UPDATE queries.
+   */
+  static async update(modelName: string, id: string | number, data: Record<string, unknown>): Promise<OrmRecord> {
+    if (!Orm.initialized) throw new Error('ORM is not ready');
+
+    const record = Orm.store.get(modelName, id);
+    if (!record || !isOrmRecord(record)) throw new Error(`Record ${modelName}:${id} not found`);
+
+    const oldState = JSON.parse(JSON.stringify(record.__data));
+
+    // Apply attribute updates directly, matching the REST handler pattern
+    for (const [key, value] of Object.entries(data)) {
+      if (key === 'id') continue;
+      record[key] = value;
+    }
+
+    if (Orm.instance.sqlDb) {
+      await Orm.instance.sqlDb.persist('update', modelName, { record, oldState }, {});
+    }
+
+    return record;
+  }
+
+  /**
+   * Programmatic delete — removes from SQL database AND memory store.
+   * SQL delete runs first to ensure consistency on failure.
+   */
+  static async remove(modelName: string, id: string | number): Promise<void> {
+    if (!Orm.initialized) throw new Error('ORM is not ready');
+
+    if (Orm.instance.sqlDb) {
+      await Orm.instance.sqlDb.persist('delete', modelName, { recordId: id }, {});
+    }
+
+    Orm.store.remove(modelName, id);
+  }
+
   // Queue warnings to avoid the same error from being logged in the same iteration
   warn(message: string): void {
     this.warnings.add(message);