@objectstack/driver-memory 0.3.1 → 0.3.3

package/CHANGELOG.md

@@ -1,5 +1,28 @@
 # @objectstack/driver-memory
 
+## 0.3.3
+
+### Patch Changes
+
+- Workflow and configuration improvements
+
+  - Enhanced GitHub workflows for CI, release, and PR automation
+  - Added comprehensive prompt templates for different protocol areas
+  - Improved project documentation and automation guides
+  - Updated changeset configuration
+  - Added cursor rules for better development experience
+
+- Updated dependencies
+  - @objectstack/spec@0.3.3
+
+## 0.3.2
+
+### Patch Changes
+
+- Patch release for maintenance and stability improvements
+- Updated dependencies
+  - @objectstack/spec@0.3.2
+
 ## 0.3.1
 
 ### Patch Changes

package/dist/objectstack.config.d.ts

@@ -1,3 +1,3 @@
-import { ObjectStackManifest } from '@objectstack/spec/system';
+import { ObjectStackManifest } from '@objectstack/spec/kernel';
 declare const MemoryDriverPlugin: ObjectStackManifest;
 export default MemoryDriverPlugin;

package/dist/objectstack.config.js

@@ -2,7 +2,7 @@ const MemoryDriverPlugin = {
     id: 'com.objectstack.driver.memory',
     name: 'In-Memory Driver',
     version: '1.0.0',
-    type: 'plugin', // Acts as a plugin that contributes a driver
+    type: 'driver',
     description: 'A reference specificiation implementation of the DriverInterface using in-memory arrays.',
     configuration: {
         title: 'Memory Driver Settings',

package/dist/src/index.js

@@ -11,13 +11,13 @@ export default {
     id: 'com.objectstack.driver.memory',
     version: '1.0.0',
     onEnable: async (context) => {
-        const { logger } = context;
+        const { logger, config, drivers } = context;
         logger.info('[Memory Driver] Initializing...');
         // Simulate driver registration
         // This assumes the runtime exposes a 'drivers' registry
-        if (context.drivers) {
-            const driver = new InMemoryDriver();
-            context.drivers.register(driver);
+        if (drivers) {
+            const driver = new InMemoryDriver(config); // Pass config to driver
+            drivers.register(driver);
             logger.info(`[Memory Driver] Registered driver: ${driver.name}`);
         }
         else {

package/dist/src/memory-driver.d.ts

@@ -1,5 +1,5 @@
 import { QueryInput } from '@objectstack/spec/data';
-import { DriverInterface, DriverOptions } from '@objectstack/spec/system';
+import { DriverInterface, DriverOptions } from '@objectstack/spec/driver';
 /**
  * Example: In-Memory Driver
  *
@@ -9,6 +9,8 @@ import { DriverInterface, DriverOptions } from '@objectstack/spec/system';
 export declare class InMemoryDriver implements DriverInterface {
     name: string;
     version: string;
+    private config;
+    constructor(config?: any);
     install(ctx: any): void;
     supports: {
         transactions: boolean;
@@ -20,6 +22,8 @@ export declare class InMemoryDriver implements DriverInterface {
         querySubqueries: boolean;
         joins: boolean;
         fullTextSearch: boolean;
+        vectorSearch: boolean;
+        geoSpatial: boolean;
         jsonFields: boolean;
         arrayFields: boolean;
     };
@@ -32,6 +36,7 @@ export declare class InMemoryDriver implements DriverInterface {
     checkHealth(): Promise<boolean>;
     execute(command: any, params?: any[]): Promise<null>;
     find(object: string, query: QueryInput, options?: DriverOptions): Promise<any[]>;
+    findStream(object: string, query: QueryInput, options?: DriverOptions): AsyncGenerator<any, void, unknown>;
     findOne(object: string, query: QueryInput, options?: DriverOptions): Promise<any>;
     create(object: string, data: Record<string, any>, options?: DriverOptions): Promise<{
         created_at: Date;
@@ -39,6 +44,7 @@ export declare class InMemoryDriver implements DriverInterface {
         id: string;
     }>;
     update(object: string, id: string | number, data: Record<string, any>, options?: DriverOptions): Promise<any>;
+    upsert(object: string, data: Record<string, any>, conflictKeys?: string[], options?: DriverOptions): Promise<any>;
     delete(object: string, id: string | number, options?: DriverOptions): Promise<boolean>;
     count(object: string, query?: QueryInput, options?: DriverOptions): Promise<number>;
     bulkCreate(object: string, dataArray: Record<string, any>[], options?: DriverOptions): Promise<{

package/dist/src/memory-driver.js

@@ -5,7 +5,7 @@
  * This driver stores data in a simple JavaScript object (Heap).
  */
 export class InMemoryDriver {
-    constructor() {
+    constructor(config) {
         this.name = 'in-memory-driver';
         this.version = '0.0.1';
         this.supports = {
@@ -15,12 +15,14 @@ export class InMemoryDriver {
             queryFilters: false, // TODO: Not implemented - basic find() doesn't handle filters
             queryAggregations: false, // TODO: Not implemented - count() only returns total
             querySorting: false, // TODO: Not implemented - find() doesn't handle sorting
-            queryPagination: true, // Basic pagination via 'top' is implemented
+            queryPagination: true, // Basic pagination via 'limit' is implemented
             queryWindowFunctions: false, // TODO: Not implemented
             querySubqueries: false, // TODO: Not implemented
             joins: false, // TODO: Not implemented
             // Advanced Features
             fullTextSearch: false, // TODO: Not implemented
+            vectorSearch: false, // TODO: Not implemented
+            geoSpatial: false, // TODO: Not implemented
             jsonFields: true, // Native JS object support
             arrayFields: true, // Native JS array support
         };
@@ -28,6 +30,7 @@ export class InMemoryDriver {
          * The "Database": A map of TableName -> Array of Records
          */
         this.db = {};
+        this.config = config || {};
     }
     // Duck-typed RuntimePlugin hook
     install(ctx) {
@@ -63,13 +66,19 @@ export class InMemoryDriver {
         // 💡 Naive Implementation
         let results = [...table];
         // Simple limiting for demonstration
-        if (query.top) {
-            results = results.slice(0, query.top);
+        if (query.limit) {
+            results = results.slice(0, query.limit);
         }
         return results;
     }
+    async *findStream(object, query, options) {
+        const results = await this.find(object, query, options);
+        for (const record of results) {
+            yield record;
+        }
+    }
     async findOne(object, query, options) {
-        const results = await this.find(object, { ...query, top: 1 }, options);
+        const results = await this.find(object, { ...query, limit: 1 }, options);
         return results[0] || null;
     }
     async create(object, data, options) {
@@ -98,6 +107,22 @@ export class InMemoryDriver {
         table[index] = updatedRecord;
         return updatedRecord;
     }
+    async upsert(object, data, conflictKeys, options) {
+        const table = this.getTable(object);
+        let existingRecord = null;
+        if (data.id) {
+            existingRecord = table.find(r => r.id === data.id);
+        }
+        else if (conflictKeys && conflictKeys.length > 0) {
+            existingRecord = table.find(r => conflictKeys.every(key => r[key] === data[key]));
+        }
+        if (existingRecord) {
+            return this.update(object, existingRecord.id, data, options);
+        }
+        else {
+            return this.create(object, data, options);
+        }
+    }
     async delete(object, id, options) {
         const table = this.getTable(object);
         const index = table.findIndex(r => r.id == id);

package/objectstack.config.ts

@@ -1,10 +1,10 @@
-import { ObjectStackManifest } from '@objectstack/spec/system';
+import { ObjectStackManifest } from '@objectstack/spec/kernel';
 
 const MemoryDriverPlugin: ObjectStackManifest = {
   id: 'com.objectstack.driver.memory',
   name: 'In-Memory Driver',
   version: '1.0.0',
-  type: 'plugin', // Acts as a plugin that contributes a driver
+  type: 'driver',
   description: 'A reference specificiation implementation of the DriverInterface using in-memory arrays.',
   
   configuration: {

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "@objectstack/driver-memory",
-  "version": "0.3.1",
+  "version": "0.3.3",
   "description": "In-Memory Driver for ObjectStack (Reference Implementation)",
   "main": "dist/src/index.js",
   "types": "dist/src/index.d.ts",
   "dependencies": {
-    "@objectstack/spec": "0.3.1"
+    "@objectstack/spec": "0.3.3"
   },
   "devDependencies": {
     "typescript": "^5.0.0"

package/src/index.ts

@@ -17,14 +17,14 @@ export default {
   version: '1.0.0',
 
   onEnable: async (context: any) => {
-    const { logger } = context;
+    const { logger, config, drivers } = context;
     logger.info('[Memory Driver] Initializing...');
 
     // Simulate driver registration
     // This assumes the runtime exposes a 'drivers' registry
-    if (context.drivers) {
-       const driver = new InMemoryDriver();
-       context.drivers.register(driver);
+    if (drivers) {
+       const driver = new InMemoryDriver(config); // Pass config to driver
+       drivers.register(driver);
        logger.info(`[Memory Driver] Registered driver: ${driver.name}`);
     } else {
        logger.warn('[Memory Driver] No driver registry found in context.');

package/src/memory-driver.ts

@@ -1,5 +1,5 @@
 import { QueryAST, QueryInput } from '@objectstack/spec/data';
-import { DriverInterface, DriverOptions } from '@objectstack/spec/system';
+import { DriverInterface, DriverOptions } from '@objectstack/spec/driver';
 
 /**
  * Example: In-Memory Driver
@@ -10,6 +10,11 @@ import { DriverInterface, DriverOptions } from '@objectstack/spec/system';
 export class InMemoryDriver implements DriverInterface {
   name = 'in-memory-driver';
   version = '0.0.1';
+  private config: any;
+
+  constructor(config?: any) {
+    this.config = config || {};
+  }
 
   // Duck-typed RuntimePlugin hook
   install(ctx: any) {
@@ -26,13 +31,15 @@ export class InMemoryDriver implements DriverInterface {
     queryFilters: false,         // TODO: Not implemented - basic find() doesn't handle filters
     queryAggregations: false,    // TODO: Not implemented - count() only returns total
     querySorting: false,         // TODO: Not implemented - find() doesn't handle sorting
-    queryPagination: true,       // Basic pagination via 'top' is implemented
+    queryPagination: true,       // Basic pagination via 'limit' is implemented
     queryWindowFunctions: false, // TODO: Not implemented
     querySubqueries: false,      // TODO: Not implemented
     joins: false,                // TODO: Not implemented
     
     // Advanced Features
     fullTextSearch: false,       // TODO: Not implemented
+    vectorSearch: false,         // TODO: Not implemented
+    geoSpatial: false,           // TODO: Not implemented
     jsonFields: true,            // Native JS object support
     arrayFields: true,           // Native JS array support
   };
@@ -79,15 +86,22 @@ export class InMemoryDriver implements DriverInterface {
     let results = [...table];
 
     // Simple limiting for demonstration
-    if (query.top) {
-      results = results.slice(0, query.top);
+    if (query.limit) {
+      results = results.slice(0, query.limit);
     }
 
     return results;
   }
 
+  async *findStream(object: string, query: QueryInput, options?: DriverOptions) {
+    const results = await this.find(object, query, options);
+    for (const record of results) {
+      yield record;
+    }
+  }
+
   async findOne(object: string, query: QueryInput, options?: DriverOptions) {
-    const results = await this.find(object, { ...query, top: 1 }, options);
+    const results = await this.find(object, { ...query, limit: 1 }, options);
     return results[0] || null;
   }
 
@@ -124,6 +138,23 @@ export class InMemoryDriver implements DriverInterface {
     return updatedRecord;
   }
 
+  async upsert(object: string, data: Record<string, any>, conflictKeys?: string[], options?: DriverOptions) {
+    const table = this.getTable(object);
+    let existingRecord: any = null;
+
+    if (data.id) {
+        existingRecord = table.find(r => r.id === data.id);
+    } else if (conflictKeys && conflictKeys.length > 0) {
+        existingRecord = table.find(r => conflictKeys.every(key => r[key] === data[key]));
+    }
+
+    if (existingRecord) {
+        return this.update(object, existingRecord.id, data, options);
+    } else {
+        return this.create(object, data, options);
+    }
+  }
+
   async delete(object: string, id: string | number, options?: DriverOptions) {
     const table = this.getTable(object);
     const index = table.findIndex(r => r.id == id);