@objectstack/driver-memory 3.2.9 → 3.3.0

package/.turbo/turbo-build.log

@@ -1,5 +1,5 @@
 
-> @objectstack/driver-memory@3.2.9 build /home/runner/work/spec/spec/packages/plugins/driver-memory
+> @objectstack/driver-memory@3.3.0 build /home/runner/work/spec/spec/packages/plugins/driver-memory
 > tsup --config ../../../tsup.config.ts
 
 CLI Building entry: src/index.ts
@@ -10,13 +10,13 @@
 CLI Cleaning output folder
 ESM Build start
 CJS Build start
-ESM dist/index.mjs     52.62 KB
-ESM dist/index.mjs.map 104.48 KB
-ESM ⚡️ Build success in 128ms
-CJS dist/index.js     54.30 KB
-CJS dist/index.js.map 104.53 KB
-CJS ⚡️ Build success in 128ms
+ESM dist/index.mjs     54.07 KB
+ESM dist/index.mjs.map 107.73 KB
+ESM ⚡️ Build success in 179ms
+CJS dist/index.js     55.80 KB
+CJS dist/index.js.map 107.79 KB
+CJS ⚡️ Build success in 182ms
 DTS Build start
-DTS ⚡️ Build success in 16559ms
-DTS dist/index.d.mts 14.27 KB
-DTS dist/index.d.ts  14.27 KB
+DTS ⚡️ Build success in 17342ms
+DTS dist/index.d.mts 15.57 KB
+DTS dist/index.d.ts  15.57 KB

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # @objectstack/driver-memory
 
+## 3.3.0
+
+### Patch Changes
+
+- @objectstack/spec@3.3.0
+- @objectstack/core@3.3.0
+
 ## 3.2.9
 
 ### Patch Changes

package/dist/index.d.mts

@@ -1,6 +1,6 @@
-import { QueryInput, DriverOptions, Cube, AnalyticsQuery } from '@objectstack/spec/data';
-import { DriverInterface, Logger } from '@objectstack/core';
-import { IAnalyticsService, AnalyticsResult, CubeMeta } from '@objectstack/spec/contracts';
+import { QueryAST, DriverOptions, QueryInput, Cube, AnalyticsQuery } from '@objectstack/spec/data';
+import { IDataDriver, IAnalyticsService, AnalyticsResult, CubeMeta, AnalyticsStrategy, AnalyticsQuery as AnalyticsQuery$1, StrategyContext } from '@objectstack/spec/contracts';
+import { Logger } from '@objectstack/core';
 
 /**
  * Persistence adapter interface.
@@ -65,10 +65,10 @@ interface InMemoryDriverConfig {
  *
  * Reference: objectql/packages/drivers/memory
  */
-declare class InMemoryDriver implements DriverInterface {
-    name: string;
+declare class InMemoryDriver implements IDataDriver {
+    readonly name = "com.objectstack.driver.memory";
     type: string;
-    version: string;
+    readonly version = "1.0.0";
     private config;
     private logger;
     private idCounters;
@@ -76,20 +76,37 @@ declare class InMemoryDriver implements DriverInterface {
     private persistenceAdapter;
     constructor(config?: InMemoryDriverConfig);
     install(ctx: any): void;
-    supports: {
+    readonly supports: {
+        create: boolean;
+        read: boolean;
+        update: boolean;
+        delete: boolean;
+        bulkCreate: boolean;
+        bulkUpdate: boolean;
+        bulkDelete: boolean;
         transactions: boolean;
+        savepoints: boolean;
         queryFilters: boolean;
         queryAggregations: boolean;
         querySorting: boolean;
         queryPagination: boolean;
         queryWindowFunctions: boolean;
         querySubqueries: boolean;
+        queryCTE: boolean;
         joins: boolean;
         fullTextSearch: boolean;
-        vectorSearch: boolean;
-        geoSpatial: boolean;
+        jsonQuery: boolean;
+        geospatialQuery: boolean;
+        streaming: boolean;
         jsonFields: boolean;
         arrayFields: boolean;
+        vectorSearch: boolean;
+        schemaSync: boolean;
+        migrations: boolean;
+        indexes: boolean;
+        connectionPooling: boolean;
+        preparedStatements: boolean;
+        queryCache: boolean;
     };
     /**
      * The "Database": A map of TableName -> Array of Records
@@ -99,9 +116,9 @@ declare class InMemoryDriver implements DriverInterface {
     disconnect(): Promise<void>;
     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>;
+    find(object: string, query: QueryAST, options?: DriverOptions): Promise<any[]>;
+    findStream(object: string, query: QueryAST, options?: DriverOptions): AsyncGenerator<any, void, unknown>;
+    findOne(object: string, query: QueryAST, options?: DriverOptions): Promise<any>;
     create(object: string, data: Record<string, any>, options?: DriverOptions): Promise<{
         created_at: any;
         updated_at: any;
@@ -110,18 +127,14 @@ declare class InMemoryDriver implements DriverInterface {
     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>;
+    count(object: string, query?: QueryAST, options?: DriverOptions): Promise<number>;
     bulkCreate(object: string, dataArray: Record<string, any>[], options?: DriverOptions): Promise<{
         created_at: any;
         updated_at: any;
         id: any;
     }[]>;
-    updateMany(object: string, query: QueryInput, data: Record<string, any>, options?: DriverOptions): Promise<{
-        count: number;
-    }>;
-    deleteMany(object: string, query: QueryInput, options?: DriverOptions): Promise<{
-        count: number;
-    }>;
+    updateMany(object: string, query: QueryAST, data: Record<string, any>, options?: DriverOptions): Promise<number>;
+    deleteMany(object: string, query: QueryAST, options?: DriverOptions): Promise<number>;
     bulkUpdate(object: string, updates: {
         id: string | number;
         data: Record<string, any>;
@@ -393,10 +406,31 @@ declare class MemoryAnalyticsService implements IAnalyticsService {
     private generateSqlFromPipeline;
 }
 
+/**
+ * InMemoryStrategy — Priority 3
+ *
+ * Delegates to an existing `IAnalyticsService` instance that was registered
+ * as a fallback (typically `MemoryAnalyticsService` from this package).
+ *
+ * This is the lowest-priority strategy, used in:
+ * - `dev` / `test` environments
+ * - Any runtime where the backing driver is in-memory
+ */
+declare class InMemoryStrategy implements AnalyticsStrategy {
+    readonly name = "InMemoryStrategy";
+    readonly priority = 30;
+    canHandle(query: AnalyticsQuery$1, ctx: StrategyContext): boolean;
+    execute(query: AnalyticsQuery$1, ctx: StrategyContext): Promise<AnalyticsResult>;
+    generateSql(query: AnalyticsQuery$1, ctx: StrategyContext): Promise<{
+        sql: string;
+        params: unknown[];
+    }>;
+}
+
 declare const _default: {
     id: string;
     version: string;
     onEnable: (context: any) => Promise<void>;
 };
 
-export { FileSystemPersistenceAdapter, InMemoryDriver, type InMemoryDriverConfig, LocalStoragePersistenceAdapter, type MemoryAnalyticsConfig, MemoryAnalyticsService, type PersistenceAdapterInterface, _default as default };
+export { FileSystemPersistenceAdapter, InMemoryDriver, type InMemoryDriverConfig, InMemoryStrategy, LocalStoragePersistenceAdapter, type MemoryAnalyticsConfig, MemoryAnalyticsService, type PersistenceAdapterInterface, _default as default };

package/dist/index.d.ts

@@ -1,6 +1,6 @@
-import { QueryInput, DriverOptions, Cube, AnalyticsQuery } from '@objectstack/spec/data';
-import { DriverInterface, Logger } from '@objectstack/core';
-import { IAnalyticsService, AnalyticsResult, CubeMeta } from '@objectstack/spec/contracts';
+import { QueryAST, DriverOptions, QueryInput, Cube, AnalyticsQuery } from '@objectstack/spec/data';
+import { IDataDriver, IAnalyticsService, AnalyticsResult, CubeMeta, AnalyticsStrategy, AnalyticsQuery as AnalyticsQuery$1, StrategyContext } from '@objectstack/spec/contracts';
+import { Logger } from '@objectstack/core';
 
 /**
  * Persistence adapter interface.
@@ -65,10 +65,10 @@ interface InMemoryDriverConfig {
  *
  * Reference: objectql/packages/drivers/memory
  */
-declare class InMemoryDriver implements DriverInterface {
-    name: string;
+declare class InMemoryDriver implements IDataDriver {
+    readonly name = "com.objectstack.driver.memory";
     type: string;
-    version: string;
+    readonly version = "1.0.0";
     private config;
     private logger;
     private idCounters;
@@ -76,20 +76,37 @@ declare class InMemoryDriver implements DriverInterface {
     private persistenceAdapter;
     constructor(config?: InMemoryDriverConfig);
     install(ctx: any): void;
-    supports: {
+    readonly supports: {
+        create: boolean;
+        read: boolean;
+        update: boolean;
+        delete: boolean;
+        bulkCreate: boolean;
+        bulkUpdate: boolean;
+        bulkDelete: boolean;
         transactions: boolean;
+        savepoints: boolean;
         queryFilters: boolean;
         queryAggregations: boolean;
         querySorting: boolean;
         queryPagination: boolean;
         queryWindowFunctions: boolean;
         querySubqueries: boolean;
+        queryCTE: boolean;
         joins: boolean;
         fullTextSearch: boolean;
-        vectorSearch: boolean;
-        geoSpatial: boolean;
+        jsonQuery: boolean;
+        geospatialQuery: boolean;
+        streaming: boolean;
         jsonFields: boolean;
         arrayFields: boolean;
+        vectorSearch: boolean;
+        schemaSync: boolean;
+        migrations: boolean;
+        indexes: boolean;
+        connectionPooling: boolean;
+        preparedStatements: boolean;
+        queryCache: boolean;
     };
     /**
      * The "Database": A map of TableName -> Array of Records
@@ -99,9 +116,9 @@ declare class InMemoryDriver implements DriverInterface {
     disconnect(): Promise<void>;
     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>;
+    find(object: string, query: QueryAST, options?: DriverOptions): Promise<any[]>;
+    findStream(object: string, query: QueryAST, options?: DriverOptions): AsyncGenerator<any, void, unknown>;
+    findOne(object: string, query: QueryAST, options?: DriverOptions): Promise<any>;
     create(object: string, data: Record<string, any>, options?: DriverOptions): Promise<{
         created_at: any;
         updated_at: any;
@@ -110,18 +127,14 @@ declare class InMemoryDriver implements DriverInterface {
     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>;
+    count(object: string, query?: QueryAST, options?: DriverOptions): Promise<number>;
     bulkCreate(object: string, dataArray: Record<string, any>[], options?: DriverOptions): Promise<{
         created_at: any;
         updated_at: any;
         id: any;
     }[]>;
-    updateMany(object: string, query: QueryInput, data: Record<string, any>, options?: DriverOptions): Promise<{
-        count: number;
-    }>;
-    deleteMany(object: string, query: QueryInput, options?: DriverOptions): Promise<{
-        count: number;
-    }>;
+    updateMany(object: string, query: QueryAST, data: Record<string, any>, options?: DriverOptions): Promise<number>;
+    deleteMany(object: string, query: QueryAST, options?: DriverOptions): Promise<number>;
     bulkUpdate(object: string, updates: {
         id: string | number;
         data: Record<string, any>;
@@ -393,10 +406,31 @@ declare class MemoryAnalyticsService implements IAnalyticsService {
     private generateSqlFromPipeline;
 }
 
+/**
+ * InMemoryStrategy — Priority 3
+ *
+ * Delegates to an existing `IAnalyticsService` instance that was registered
+ * as a fallback (typically `MemoryAnalyticsService` from this package).
+ *
+ * This is the lowest-priority strategy, used in:
+ * - `dev` / `test` environments
+ * - Any runtime where the backing driver is in-memory
+ */
+declare class InMemoryStrategy implements AnalyticsStrategy {
+    readonly name = "InMemoryStrategy";
+    readonly priority = 30;
+    canHandle(query: AnalyticsQuery$1, ctx: StrategyContext): boolean;
+    execute(query: AnalyticsQuery$1, ctx: StrategyContext): Promise<AnalyticsResult>;
+    generateSql(query: AnalyticsQuery$1, ctx: StrategyContext): Promise<{
+        sql: string;
+        params: unknown[];
+    }>;
+}
+
 declare const _default: {
     id: string;
     version: string;
     onEnable: (context: any) => Promise<void>;
 };
 
-export { FileSystemPersistenceAdapter, InMemoryDriver, type InMemoryDriverConfig, LocalStoragePersistenceAdapter, type MemoryAnalyticsConfig, MemoryAnalyticsService, type PersistenceAdapterInterface, _default as default };
+export { FileSystemPersistenceAdapter, InMemoryDriver, type InMemoryDriverConfig, InMemoryStrategy, LocalStoragePersistenceAdapter, type MemoryAnalyticsConfig, MemoryAnalyticsService, type PersistenceAdapterInterface, _default as default };

package/dist/index.js

@@ -182,6 +182,7 @@ var index_exports = {};
 __export(index_exports, {
   FileSystemPersistenceAdapter: () => FileSystemPersistenceAdapter,
   InMemoryDriver: () => InMemoryDriver,
+  InMemoryStrategy: () => InMemoryStrategy,
   LocalStoragePersistenceAdapter: () => LocalStoragePersistenceAdapter,
   MemoryAnalyticsService: () => MemoryAnalyticsService,
   default: () => index_default
@@ -208,9 +209,19 @@ var _InMemoryDriver = class _InMemoryDriver {
     this.transactions = /* @__PURE__ */ new Map();
     this.persistenceAdapter = null;
     this.supports = {
+      // Basic CRUD Operations
+      create: true,
+      read: true,
+      update: true,
+      delete: true,
+      // Bulk Operations
+      bulkCreate: true,
+      bulkUpdate: true,
+      bulkDelete: true,
       // Transaction & Connection Management
       transactions: true,
       // Snapshot-based transactions
+      savepoints: false,
       // Query Operations
       queryFilters: true,
       // Implemented via memory-matcher
@@ -224,19 +235,31 @@ var _InMemoryDriver = class _InMemoryDriver {
       // @planned: Window functions (ROW_NUMBER, RANK, etc.)
       querySubqueries: false,
       // @planned: Subquery execution
+      queryCTE: false,
       joins: false,
       // @planned: In-memory join operations
       // Advanced Features
       fullTextSearch: false,
       // @planned: Text tokenization + matching
-      vectorSearch: false,
-      // @planned: Cosine similarity search
-      geoSpatial: false,
-      // @planned: Distance/within calculations
+      jsonQuery: false,
+      geospatialQuery: false,
+      streaming: true,
+      // Implemented via findStream()
       jsonFields: true,
       // Native JS object support
-      arrayFields: true
+      arrayFields: true,
       // Native JS array support
+      vectorSearch: false,
+      // @planned: Cosine similarity search
+      // Schema Management
+      schemaSync: true,
+      // Implemented via syncSchema()
+      migrations: false,
+      indexes: false,
+      // Performance & Optimization
+      connectionPooling: false,
+      preparedStatements: false,
+      queryCache: false
     };
     /**
      * The "Database": A map of TableName -> Array of Records
@@ -498,7 +521,7 @@ var _InMemoryDriver = class _InMemoryDriver {
     }
     if (count > 0) this.markDirty();
     this.logger.debug("UpdateMany completed", { object, count });
-    return { count };
+    return count;
   }
   async deleteMany(object, query, options) {
     this.logger.debug("DeleteMany operation", { object, query });
@@ -520,7 +543,7 @@ var _InMemoryDriver = class _InMemoryDriver {
     const count = initialLength - this.db[object].length;
     if (count > 0) this.markDirty();
     this.logger.debug("DeleteMany completed", { object, count });
-    return { count };
+    return count;
   }
   // Compatibility aliases
   async bulkUpdate(object, updates, options) {
@@ -1523,6 +1546,37 @@ ${stages}`;
   }
 };
 
+// src/in-memory-strategy.ts
+var InMemoryStrategy = class {
+  constructor() {
+    this.name = "InMemoryStrategy";
+    this.priority = 30;
+  }
+  canHandle(query, ctx) {
+    if (!query.cube) return false;
+    if (ctx.fallbackService) return true;
+    const caps = ctx.queryCapabilities(query.cube);
+    return caps.inMemory;
+  }
+  async execute(query, ctx) {
+    if (!ctx.fallbackService) {
+      throw new Error(
+        `[InMemoryStrategy] No fallback analytics service available for cube "${query.cube}". Register a MemoryAnalyticsService or configure a driver with analytics support.`
+      );
+    }
+    return ctx.fallbackService.query(query);
+  }
+  async generateSql(query, ctx) {
+    if (ctx.fallbackService?.generateSql) {
+      return ctx.fallbackService.generateSql(query);
+    }
+    return {
+      sql: `-- InMemoryStrategy: SQL generation not supported for cube "${query.cube}"`,
+      params: []
+    };
+  }
+};
+
 // src/index.ts
 var index_default = {
   id: "com.objectstack.driver.memory",
@@ -1543,6 +1597,7 @@ var index_default = {
 0 && (module.exports = {
   FileSystemPersistenceAdapter,
   InMemoryDriver,
+  InMemoryStrategy,
   LocalStoragePersistenceAdapter,
   MemoryAnalyticsService
 });