@objectstack/objectql 0.9.2 → 1.0.0

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # @objectstack/objectql
 
+## 1.0.0
+
+### Major Changes
+
+- Major version release for ObjectStack Protocol v1.0.
+  - Stabilized Protocol Definitions
+  - Enhanced Runtime Plugin Support
+  - Fixed Type Compliance across Monorepo
+
+### Patch Changes
+
+- Updated dependencies
+  - @objectstack/spec@1.0.0
+  - @objectstack/core@1.0.0
+  - @objectstack/types@1.0.0
+
 ## 0.9.2
 
 ### Patch Changes

package/README.md

@@ -1,387 +1,23 @@
-# ObjectQL Engine
+# @objectstack/objectql
 
-**ObjectQL** is a schema-driven, cross-datasource query engine for the [ObjectStack](https://github.com/steedos/objectstack) ecosystem. It acts as a virtual "Meta-Database" that unifies access to SQL, NoSQL, and API data sources under a single semantic layer.
+The **Data Engine** for ObjectStack. It acts as a semantic layer between your application code and the underlying database.
 
 ## Features
 
-- **Protocol Agnostic**: Uses standard `ObjectSchema` and `QueryAST` from `@objectstack/spec`.
-- **Cross-Datasource**: Routes queries to the correct driver (Postgres, MongoDB, Redis, etc.) based on Object definition.
-- **Unified API**: Single `find`, `insert`, `update`, `delete` API regardless of the underlying storage.
-- **Plugin System**: Load objects and logic via standard Manifests.
-- **Middleware**: (Planned) Support for Hooks and Validators.
-
-## 🤖 AI Development Context
-
-**Role**: Data Engine / Query Layer
-**Usage**:
-- Use this package to execute data operations (`find`, `insert`).
-- Do NOT bypass this layer to access drivers directly unless building a driver.
-- This is the "Backend Brain" for data.
-
-**Key Concepts**:
-- `SchemaRegistry`: Holds all object definitions.
-- `ObjectQL`: The main facade.
-- `Driver`: Interface for storage adapters.
+- **Universal API**: A consistent query interface (`find`, `insert`, `update`, `delete`) regardless of the storage backend.
+- **Schema Validation**: Enforces Zod schemas defined in `@objectstack/spec`.
+- **Query Resolution**: Translates ObjectStack queries into driver-specific commands.
+- **Driver Architecture**: Pluggable storage (Memory, MongoDB, SQL, etc.).
 
 ## Usage
 
-### 1. Standalone Usage
-
 ```typescript
 import { ObjectQL } from '@objectstack/objectql';
-import { InMemoryDriver } from '@objectstack/driver-memory'; // Note: Package name might export InMemoryDriver now
-
-async function main() {
-  // 1. Initialize Engine
-  const ql = new ObjectQL();
-
-  // 2. Register Drivers
-  const memDriver = new InMemoryDriver({ name: 'default' });
-  ql.registerDriver(memDriver, true);
-
-  // 3. Load Schema (via Plugin/Manifest)
-  await ql.use({
-    name: 'my-app',
-    objects: [
-      {
-        name: 'todo',
-        fields: {
-          title: { type: 'text' },
-          completed: { type: 'boolean' }
-        },
-        datasource: 'default'
-      }
-    ]
-  });
-
-  await ql.init();
-
-  // 4. Execute Queries
-  // Insert
-  await ql.insert('todo', { title: 'Buy Milk', completed: false });
-
-  // Find (Simple)
-  const todos = await ql.find('todo', { completed: false });
-
-  // Find (Advanced AST)
-  const results = await ql.find('todo', {
-    where: { 
-      title: { $contains: 'Milk' } 
-    },
-    limit: 10,
-    orderBy: [{ field: 'title', order: 'desc' }]
-  });
-
-  console.log(results);
-}
-```
-
-### 2. Using with ObjectKernel (Recommended)
-
-When building full applications, use the `ObjectKernel` to manage plugins and configuration.
-
-```typescript
-import { ObjectKernel } from '@objectstack/core';
-import { DriverPlugin } from '@objectstack/runtime';
-import { ObjectQLPlugin } from '@objectstack/objectql';
-import { InMemoryDriver } from '@objectstack/driver-memory';
-
-const kernel = new ObjectKernel();
-
-// Register Engine and Drivers as Kernel Plugins
-kernel.use(new ObjectQLPlugin())
-      .use(new DriverPlugin(new InMemoryDriver(), 'default'));
-
-await kernel.bootstrap();
-
-// The engine automatically discovers drivers and apps registered in the kernel.
-```
-
-## Architecture
-
-- **SchemaRegistry**: Central store for all metadata (Objects, Apps, Config).
-- **DriverRegistry**: Manages connections to physical data sources.
-- **QueryPlanner**: (Internal) Normalizes simplified queries into `QueryAST`.
-- **Executor**: Routes AST to the correct driver.
-
-## Advanced Examples
-
-### Complex Queries
-
-```typescript
-// Filtering with multiple conditions
-const activeTasks = await ql.find('todo_task', {
-  where: {
-    $and: [
-      { status: 'active' },
-      { priority: { $gte: 3 } },
-      { due_date: { $lte: new Date() } }
-    ]
-  },
-  orderBy: [
-    { field: 'priority', order: 'desc' },
-    { field: 'due_date', order: 'asc' }
-  ],
-  limit: 50
-});
-
-// Text search
-const searchResults = await ql.find('todo_task', {
-  where: {
-    $or: [
-      { title: { $contains: 'urgent' } },
-      { description: { $contains: 'urgent' } }
-    ]
-  }
-});
-
-// Nested conditions
-const complexQuery = await ql.find('project', {
-  where: {
-    $and: [
-      { status: { $in: ['active', 'planning'] } },
-      {
-        $or: [
-          { budget: { $gt: 100000 } },
-          { priority: { $eq: 1 } }
-        ]
-      }
-    ]
-  }
-});
-```
-
-### Batch Operations
-
-```typescript
-// Batch insert
-const newTasks = [
-  { title: 'Task 1', priority: 1 },
-  { title: 'Task 2', priority: 2 },
-  { title: 'Task 3', priority: 3 }
-];
-
-for (const task of newTasks) {
-  await ql.insert('todo_task', task);
-}
-
-// Batch update
-const tasksToUpdate = await ql.find('todo_task', {
-  where: { status: 'pending' }
-});
-
-for (const task of tasksToUpdate) {
-  await ql.update('todo_task', task.id, {
-    status: 'in_progress',
-    started_at: new Date()
-  });
-}
-```
-
-### Working with Relationships
-
-```typescript
-// One-to-Many: Get project with tasks
-const project = await ql.find('project', {
-  where: { id: 'proj_123' },
-  include: ['tasks'] // Assumes 'tasks' is a relation field
-});
-
-// Many-to-One: Get task with project details
-const task = await ql.find('todo_task', {
-  where: { id: 'task_456' },
-  include: ['project']
-});
 
-// Manual join (when driver doesn't support relations)
-const tasks = await ql.find('todo_task', {
-  where: { project_id: 'proj_123' }
+// Querying data
+const engine = kernel.getService('objectql');
+const users = await engine.find('user', {
+    where: { role: 'admin' },
+    top: 10
 });
-
-const project = await ql.find('project', {
-  where: { id: 'proj_123' }
-});
-
-const projectWithTasks = {
-  ...project[0],
-  tasks: tasks
-};
-```
-
-### Aggregations
-
-```typescript
-// Count records
-const totalTasks = await ql.count('todo_task', {
-  where: { status: 'active' }
-});
-
-// Sum (if driver supports)
-const totalBudget = await ql.aggregate('project', {
-  operation: 'sum',
-  field: 'budget',
-  where: { status: 'active' }
-});
-
-// Group by (if driver supports)
-const tasksByStatus = await ql.aggregate('todo_task', {
-  operation: 'count',
-  groupBy: ['status']
-});
-```
-
-### Multi-Datasource Queries
-
-```typescript
-import { PostgresDriver } from '@objectstack/driver-postgres';
-import { MongoDBDriver } from '@objectstack/driver-mongodb';
-import { RedisDriver } from '@objectstack/driver-redis';
-
-const ql = new ObjectQL();
-
-// Register multiple drivers
-const pgDriver = new PostgresDriver({ connectionString: 'postgres://...' });
-const mongoDriver = new MongoDBDriver({ url: 'mongodb://...' });
-const redisDriver = new RedisDriver({ host: 'localhost' });
-
-ql.registerDriver(pgDriver, false, 'postgres');
-ql.registerDriver(mongoDriver, false, 'mongodb');
-ql.registerDriver(redisDriver, false, 'redis');
-
-// Configure objects to use different datasources
-await ql.use({
-  name: 'multi-db-app',
-  objects: [
-    {
-      name: 'user',
-      datasource: 'postgres', // Users in PostgreSQL
-      fields: { /* ... */ }
-    },
-    {
-      name: 'product',
-      datasource: 'mongodb', // Products in MongoDB
-      fields: { /* ... */ }
-    },
-    {
-      name: 'session',
-      datasource: 'redis', // Sessions in Redis
-      fields: { /* ... */ }
-    }
-  ]
-});
-
-await ql.init();
-
-// Query automatically routes to correct datasource
-const users = await ql.find('user');      // → PostgreSQL
-const products = await ql.find('product'); // → MongoDB
-const sessions = await ql.find('session'); // → Redis
-```
-
-### Custom Hooks and Middleware
-
-```typescript
-// Register hooks for data operations
-ql.registerHook('beforeInsert', async (ctx) => {
-  console.log(`Creating ${ctx.object}:`, ctx.data);
-  
-  // Add timestamps
-  ctx.data.created_at = new Date();
-  ctx.data.updated_at = new Date();
-  
-  // Validate
-  if (ctx.object === 'user' && !ctx.data.email) {
-    throw new Error('Email is required');
-  }
-});
-
-ql.registerHook('afterInsert', async (ctx) => {
-  console.log(`Created ${ctx.object}:`, ctx.result);
-  
-  // Trigger events - get event bus from kernel or context
-  // Note: eventBus should be injected or accessed from context
-  const eventBus = ctx.getService?.('event-bus');
-  if (eventBus) {
-    await eventBus.emit('data:created', {
-      object: ctx.object,
-      id: ctx.result.id
-    });
-  }
-});
-
-ql.registerHook('beforeUpdate', async (ctx) => {
-  // Update timestamp
-  ctx.data.updated_at = new Date();
-});
-
-ql.registerHook('beforeDelete', async (ctx) => {
-  // Soft delete
-  if (ctx.object === 'user') {
-    throw new Error('Cannot delete users, use deactivate instead');
-  }
-});
-```
-
-### Transaction Support
-
-```typescript
-// If driver supports transactions
-const driver = ql.getDriver('default');
-
-if (driver.supports.transactions) {
-  await driver.beginTransaction();
-  
-  try {
-    await ql.insert('order', {
-      customer_id: 'cust_123',
-      total: 100.00
-    });
-    
-    await ql.update('inventory', 'inv_456', {
-      quantity: { $decrement: 1 }
-    });
-    
-    await driver.commitTransaction();
-  } catch (error) {
-    await driver.rollbackTransaction();
-    throw error;
-  }
-}
-```
-
-### Schema Migration
-
-```typescript
-// Add new field to existing object
-const currentSchema = ql.getSchema('todo_task');
-
-const updatedSchema = {
-  ...currentSchema,
-  fields: {
-    ...currentSchema.fields,
-    assignee: {
-      type: 'lookup',
-      reference: 'user',
-      label: 'Assignee'
-    }
-  }
-};
-
-// Re-register schema
-ql.registerObject(updatedSchema);
-
-// Driver might need to sync schema
-const driver = ql.getDriver('default');
-if (driver.syncSchema) {
-  await driver.syncSchema('todo_task', updatedSchema);
-}
 ```
-
-## Roadmap
-
-- [x] Basic CRUD
-- [x] Driver Routing
-- [ ] Cross-Object Joins (Federation)
-- [ ] Validation Layer (Zod)
-- [ ] Access Control (ACL)
-- [ ] Caching Layer

package/dist/engine.d.ts

@@ -15,6 +15,9 @@ export interface ObjectQLHostContext {
  * ObjectQL Engine
  *
  * Implements the IDataEngine interface for data persistence.
+ * Acts as the reference implementation for:
+ * - CoreServiceName.data (CRUD)
+ * - CoreServiceName.metadata (Schema Registry)
  */
 export declare class ObjectQL implements IDataEngine {
     private drivers;
@@ -23,6 +26,16 @@ export declare class ObjectQL implements IDataEngine {
     private hooks;
     private hostContext;
     constructor(hostContext?: Record<string, any>);
+    /**
+     * Service Status Report
+     * Used by Kernel to verify health and capabilities.
+     */
+    getStatus(): {
+        name: "data";
+        status: string;
+        version: string;
+        features: string[];
+    };
     /**
      * Expose the SchemaRegistry for plugins to register metadata
      */
@@ -50,13 +63,8 @@ export declare class ObjectQL implements IDataEngine {
      * Helper to get object definition
      */
     getSchema(objectName: string): {
-        name: string;
-        active: boolean;
-        isSystem: boolean;
-        abstract: boolean;
-        datasource: string;
         fields: Record<string, {
-            type: "number" | "boolean" | "tags" | "formula" | "date" | "lookup" | "file" | "code" | "text" | "textarea" | "email" | "url" | "phone" | "password" | "markdown" | "html" | "richtext" | "currency" | "percent" | "datetime" | "time" | "toggle" | "select" | "multiselect" | "radio" | "checkboxes" | "master_detail" | "tree" | "image" | "avatar" | "video" | "audio" | "summary" | "autonumber" | "location" | "address" | "json" | "color" | "rating" | "slider" | "signature" | "qrcode" | "progress" | "vector";
+            type: "number" | "boolean" | "code" | "date" | "lookup" | "text" | "textarea" | "email" | "url" | "phone" | "password" | "markdown" | "html" | "richtext" | "currency" | "percent" | "datetime" | "time" | "toggle" | "select" | "multiselect" | "radio" | "checkboxes" | "master_detail" | "tree" | "image" | "file" | "avatar" | "video" | "audio" | "formula" | "summary" | "autonumber" | "location" | "address" | "json" | "color" | "rating" | "slider" | "signature" | "qrcode" | "progress" | "tags" | "vector";
             required: boolean;
             searchable: boolean;
             multiple: boolean;
@@ -68,34 +76,52 @@ export declare class ObjectQL implements IDataEngine {
             encryption: boolean;
             index: boolean;
             externalId: boolean;
-            name?: string | undefined;
+            options?: {
+                value: string;
+                label: string;
+                color?: string | undefined;
+                default?: boolean | undefined;
+            }[] | undefined;
+            expression?: string | undefined;
+            defaultValue?: any;
+            min?: number | undefined;
+            max?: number | undefined;
+            step?: number | undefined;
+            language?: string | undefined;
+            encryptionConfig?: {
+                enabled: boolean;
+                algorithm: "aes-256-gcm" | "aes-256-cbc" | "chacha20-poly1305";
+                keyManagement: {
+                    provider: "local" | "aws-kms" | "azure-key-vault" | "gcp-kms" | "hashicorp-vault";
+                    keyId?: string | undefined;
+                    rotationPolicy?: {
+                        enabled: boolean;
+                        frequencyDays: number;
+                        retainOldVersions: number;
+                        autoRotate: boolean;
+                    } | undefined;
+                };
+                scope: "table" | "field" | "database" | "record";
+                deterministicEncryption: boolean;
+                searchableEncryption: boolean;
+            } | undefined;
+            formula?: string | undefined;
             label?: string | undefined;
+            precision?: number | undefined;
+            name?: string | undefined;
             description?: string | undefined;
             format?: string | undefined;
-            defaultValue?: any;
             maxLength?: number | undefined;
             minLength?: number | undefined;
-            precision?: number | undefined;
             scale?: number | undefined;
-            min?: number | undefined;
-            max?: number | undefined;
-            options?: {
-                label: string;
-                value: string;
-                color?: string | undefined;
-                default?: boolean | undefined;
-            }[] | undefined;
             reference?: string | undefined;
             referenceFilters?: string[] | undefined;
             writeRequiresMasterRead?: boolean | undefined;
-            expression?: string | undefined;
-            formula?: string | undefined;
             summaryOperations?: {
                 object: string;
+                function: "count" | "sum" | "avg" | "min" | "max";
                 field: string;
-                function: "min" | "max" | "count" | "sum" | "avg";
             } | undefined;
-            language?: string | undefined;
             theme?: string | undefined;
             lineNumbers?: boolean | undefined;
             maxRating?: number | undefined;
@@ -106,7 +132,6 @@ export declare class ObjectQL implements IDataEngine {
             colorFormat?: "hex" | "rgb" | "rgba" | "hsl" | undefined;
             allowAlpha?: boolean | undefined;
             presetColors?: string[] | undefined;
-            step?: number | undefined;
             showValue?: boolean | undefined;
             marks?: Record<string, string> | undefined;
             barcodeFormat?: "qr" | "ean13" | "ean8" | "code128" | "code39" | "upca" | "upce" | undefined;
@@ -115,7 +140,7 @@ export declare class ObjectQL implements IDataEngine {
             allowScanning?: boolean | undefined;
             currencyConfig?: {
                 precision: number;
-                currencyMode: "fixed" | "dynamic";
+                currencyMode: "dynamic" | "fixed";
                 defaultCurrency: string;
             } | undefined;
             vectorConfig?: {
@@ -149,9 +174,9 @@ export declare class ObjectQL implements IDataEngine {
                 storageBucket?: string | undefined;
                 storagePrefix?: string | undefined;
                 imageValidation?: {
+                    autoRotate: boolean;
                     generateThumbnails: boolean;
                     preserveMetadata: boolean;
-                    autoRotate: boolean;
                     minWidth?: number | undefined;
                     maxWidth?: number | undefined;
                     minHeight?: number | undefined;
@@ -166,26 +191,9 @@ export declare class ObjectQL implements IDataEngine {
                 } | undefined;
                 maxVersions?: number | undefined;
             } | undefined;
-            encryptionConfig?: {
-                enabled: boolean;
-                algorithm: "aes-256-gcm" | "aes-256-cbc" | "chacha20-poly1305";
-                keyManagement: {
-                    provider: "local" | "aws-kms" | "azure-key-vault" | "gcp-kms" | "hashicorp-vault";
-                    keyId?: string | undefined;
-                    rotationPolicy?: {
-                        enabled: boolean;
-                        frequencyDays: number;
-                        retainOldVersions: number;
-                        autoRotate: boolean;
-                    } | undefined;
-                };
-                scope: "field" | "table" | "record" | "database";
-                deterministicEncryption: boolean;
-                searchableEncryption: boolean;
-            } | undefined;
             maskingRule?: {
                 field: string;
-                strategy: "hash" | "redact" | "partial" | "tokenize" | "randomize" | "nullify" | "substitute";
+                strategy: "partial" | "hash" | "redact" | "tokenize" | "randomize" | "nullify" | "substitute";
                 preserveFormat: boolean;
                 preserveLength: boolean;
                 pattern?: string | undefined;
@@ -207,18 +215,28 @@ export declare class ObjectQL implements IDataEngine {
                 } | undefined;
             } | undefined;
         }>;
+        name: string;
+        active: boolean;
+        isSystem: boolean;
+        abstract: boolean;
+        datasource: string;
+        search?: {
+            fields: string[];
+            displayFields?: string[] | undefined;
+            filters?: string[] | undefined;
+        } | undefined;
+        tags?: string[] | undefined;
         label?: string | undefined;
-        pluralLabel?: string | undefined;
         description?: string | undefined;
+        pluralLabel?: string | undefined;
         icon?: string | undefined;
-        tags?: string[] | undefined;
         tableName?: string | undefined;
         indexes?: {
-            fields: string[];
             type: "hash" | "btree" | "gin" | "gist" | "fulltext";
+            fields: string[];
             unique: boolean;
-            name?: string | undefined;
             partial?: string | undefined;
+            name?: string | undefined;
         }[] | undefined;
         tenancy?: {
             enabled: boolean;
@@ -245,20 +263,15 @@ export declare class ObjectQL implements IDataEngine {
         } | undefined;
         cdc?: {
             enabled: boolean;
-            events: ("update" | "delete" | "insert")[];
+            events: ("insert" | "update" | "delete")[];
             destination: string;
         } | undefined;
         validations?: any[] | undefined;
         titleFormat?: string | undefined;
         compactLayout?: string[] | undefined;
-        search?: {
-            fields: string[];
-            displayFields?: string[] | undefined;
-            filters?: string[] | undefined;
-        } | undefined;
         enable?: {
-            trackHistory: boolean;
             searchable: boolean;
+            trackHistory: boolean;
             apiEnabled: boolean;
             files: boolean;
             feeds: boolean;
@@ -266,7 +279,7 @@ export declare class ObjectQL implements IDataEngine {
             trash: boolean;
             mru: boolean;
             clone: boolean;
-            apiMethods?: ("search" | "list" | "update" | "delete" | "get" | "create" | "upsert" | "bulk" | "aggregate" | "history" | "restore" | "purge" | "import" | "export")[] | undefined;
+            apiMethods?: ("search" | "update" | "delete" | "get" | "list" | "create" | "upsert" | "bulk" | "aggregate" | "history" | "restore" | "purge" | "import" | "export")[] | undefined;
         } | undefined;
     } | undefined;
     /**

package/dist/engine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"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"}

package/dist/engine.js

@@ -1,9 +1,13 @@
 import { createLogger } from '@objectstack/core';
+import { CoreServiceName } from '@objectstack/spec/system';
 import { SchemaRegistry } from './registry.js';
 /**
  * ObjectQL Engine
  *
  * Implements the IDataEngine interface for data persistence.
+ * Acts as the reference implementation for:
+ * - CoreServiceName.data (CRUD)
+ * - CoreServiceName.metadata (Schema Registry)
  */
 export class ObjectQL {
     constructor(hostContext = {}) {
@@ -23,6 +27,18 @@ export class ObjectQL {
         this.logger = hostContext.logger || createLogger({ level: 'info', format: 'pretty' });
         this.logger.info('ObjectQL Engine Instance Created');
     }
+    /**
+     * Service Status Report
+     * Used by Kernel to verify health and capabilities.
+     */
+    getStatus() {
+        return {
+            name: CoreServiceName.enum.data,
+            status: 'running',
+            version: '0.9.0',
+            features: ['crud', 'query', 'aggregate', 'transactions', 'metadata']
+        };
+    }
     /**
      * Expose the SchemaRegistry for plugins to register metadata
      */