@objectstack/core 3.3.1 → 4.0.0

package/.turbo/turbo-build.log

@@ -1,5 +1,5 @@
 
-> @objectstack/core@3.3.1 build /home/runner/work/spec/spec/packages/core
+> @objectstack/core@4.0.0 build /home/runner/work/spec/spec/packages/core
 > tsup --config ../../tsup.config.ts
 
 CLI Building entry: src/index.ts
@@ -12,11 +12,11 @@
 CJS Build start
 ESM dist/index.js     150.14 KB
 ESM dist/index.js.map 318.23 KB
-ESM ⚡️ Build success in 98ms
+ESM ⚡️ Build success in 96ms
 CJS dist/index.cjs     153.26 KB
 CJS dist/index.cjs.map 319.94 KB
-CJS ⚡️ Build success in 98ms
+CJS ⚡️ Build success in 95ms
 DTS Build start
-DTS ⚡️ Build success in 3603ms
+DTS ⚡️ Build success in 3210ms
 DTS dist/index.d.ts  63.13 KB
 DTS dist/index.d.cts 63.13 KB

package/CHANGELOG.md

@@ -1,5 +1,28 @@
 # @objectstack/core
 
+## 4.0.0
+
+### Minor Changes
+
+- e0b0a78: Deprecate DataEngineQueryOptions in favor of QueryAST-aligned EngineQueryOptions.
+
+  Engine, Protocol, and Client now use standard QueryAST parameter names:
+
+  - `filter` → `where`
+  - `select` → `fields`
+  - `sort` → `orderBy`
+  - `skip` → `offset`
+  - `populate` → `expand`
+  - `top` → `limit`
+
+  The old DataEngine\* schemas and types are preserved with `@deprecated` markers for backward compatibility.
+
+### Patch Changes
+
+- Updated dependencies [f08ffc3]
+- Updated dependencies [e0b0a78]
+  - @objectstack/spec@4.0.0
+
 ## 3.3.1
 
 ### Patch Changes

package/dist/index.d.cts

@@ -4,7 +4,7 @@ export { DriverInterface, IDataDriver, IDataEngine, IHttpRequest, IHttpResponse,
 import { z } from 'zod';
 import { ConflictResolutionStrategy, ApiRegistryEntryInput, ApiRegistryEntry, ApiDiscoveryQuery, ApiDiscoveryResponse, ApiEndpointRegistration, ApiRegistry as ApiRegistry$1 } from '@objectstack/spec/api';
 import { QA } from '@objectstack/spec';
-import { PluginCapability, PermissionSet, ResourceType, PermissionAction, Permission, SandboxConfig, KernelSecurityScanResult, KernelSecurityVulnerability, PluginHealthCheck, PluginHealthStatus as PluginHealthStatus$1, PluginHealthReport, HotReloadConfig, SemanticVersion, VersionConstraint, CompatibilityLevel, DependencyConflict } from '@objectstack/spec/kernel';
+import { PluginCapability, PermissionSet, ResourceType, PermissionAction, Permission, SandboxConfig, KernelSecurityScanResult, KernelSecurityVulnerability, PluginHealthCheck, PluginHealthStatus as PluginHealthStatus$1, PluginHealthReport, HotReloadConfig, VersionConstraint, DependencyConflict, SemanticVersion, CompatibilityLevel } from '@objectstack/spec/kernel';
 
 /**
  * Service Lifecycle Types

package/dist/index.d.ts

@@ -4,7 +4,7 @@ export { DriverInterface, IDataDriver, IDataEngine, IHttpRequest, IHttpResponse,
 import { z } from 'zod';
 import { ConflictResolutionStrategy, ApiRegistryEntryInput, ApiRegistryEntry, ApiDiscoveryQuery, ApiDiscoveryResponse, ApiEndpointRegistration, ApiRegistry as ApiRegistry$1 } from '@objectstack/spec/api';
 import { QA } from '@objectstack/spec';
-import { PluginCapability, PermissionSet, ResourceType, PermissionAction, Permission, SandboxConfig, KernelSecurityScanResult, KernelSecurityVulnerability, PluginHealthCheck, PluginHealthStatus as PluginHealthStatus$1, PluginHealthReport, HotReloadConfig, SemanticVersion, VersionConstraint, CompatibilityLevel, DependencyConflict } from '@objectstack/spec/kernel';
+import { PluginCapability, PermissionSet, ResourceType, PermissionAction, Permission, SandboxConfig, KernelSecurityScanResult, KernelSecurityVulnerability, PluginHealthCheck, PluginHealthStatus as PluginHealthStatus$1, PluginHealthReport, HotReloadConfig, VersionConstraint, DependencyConflict, SemanticVersion, CompatibilityLevel } from '@objectstack/spec/kernel';
 
 /**
  * Service Lifecycle Types

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@objectstack/core",
-  "version": "3.3.1",
+  "version": "4.0.0",
   "license": "Apache-2.0",
   "description": "Microkernel Core for ObjectStack",
   "type": "module",
@@ -14,15 +14,15 @@
     }
   },
   "devDependencies": {
-    "typescript": "^5.0.0",
-    "vitest": "^4.1.0",
-    "@types/node": "^25.5.0"
+    "@types/node": "^25.5.0",
+    "typescript": "^6.0.2",
+    "vitest": "^4.1.2"
   },
   "dependencies": {
     "pino": "^10.3.1",
     "pino-pretty": "^13.1.3",
     "zod": "^4.3.6",
-    "@objectstack/spec": "3.3.1"
+    "@objectstack/spec": "4.0.0"
   },
   "peerDependencies": {
     "pino": "^8.0.0"

package/src/contracts/data-engine.ts

@@ -1,12 +1,12 @@
 // Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.
 
 import { 
-  DataEngineQueryOptions, 
+  EngineQueryOptions,
   DataEngineInsertOptions, 
-  DataEngineUpdateOptions, 
-  DataEngineDeleteOptions,
-  DataEngineAggregateOptions, 
-  DataEngineCountOptions,
+  EngineUpdateOptions, 
+  EngineDeleteOptions,
+  EngineAggregateOptions, 
+  EngineCountOptions,
   DataEngineRequest,
 } from '@objectstack/spec/data';
 
@@ -17,22 +17,26 @@ import {
  * Following the Dependency Inversion Principle - plugins depend on this interface,
  * not on concrete database implementations.
  * 
+ * All query methods use standard QueryAST parameter names
+ * (where/fields/orderBy/limit/offset/expand) to eliminate mechanical translation
+ * between the Engine and Driver layers.
+ * 
  * Aligned with 'src/data/data-engine.zod.ts' in @objectstack/spec.
  */
 
 export interface IDataEngine {
-  find(objectName: string, query?: DataEngineQueryOptions): Promise<any[]>;
-  findOne(objectName: string, query?: DataEngineQueryOptions): Promise<any>;
+  find(objectName: string, query?: EngineQueryOptions): Promise<any[]>;
+  findOne(objectName: string, query?: EngineQueryOptions): Promise<any>;
   insert(objectName: string, data: any | any[], options?: DataEngineInsertOptions): Promise<any>;
-  update(objectName: string, data: any, options?: DataEngineUpdateOptions): Promise<any>;
-  delete(objectName: string, options?: DataEngineDeleteOptions): Promise<any>;
-  count(objectName: string, query?: DataEngineCountOptions): Promise<number>;
-  aggregate(objectName: string, query: DataEngineAggregateOptions): Promise<any[]>;
+  update(objectName: string, data: any, options?: EngineUpdateOptions): Promise<any>;
+  delete(objectName: string, options?: EngineDeleteOptions): Promise<any>;
+  count(objectName: string, query?: EngineCountOptions): Promise<number>;
+  aggregate(objectName: string, query: EngineAggregateOptions): Promise<any[]>;
   
   /**
    * Vector Search (AI/RAG)
    */
-  vectorFind?(objectName: string, vector: number[], options?: { filter?: any, limit?: number, select?: string[], threshold?: number }): Promise<any[]>;
+  vectorFind?(objectName: string, vector: number[], options?: { where?: any, limit?: number, fields?: string[], threshold?: number }): Promise<any[]>;
 
   /**
    * Batch Operations (Transactional)

package/tsconfig.json

@@ -2,7 +2,8 @@
   "extends": "../../tsconfig.json",
   "compilerOptions": {
     "outDir": "./dist",
-    "rootDir": "./src"
+    "rootDir": "./src",
+    "types": ["node"]
   },
   "include": ["src/**/*"],
   "exclude": []