@objectstack/objectql 0.0.1 → 0.1.1

package/CHANGELOG.md

@@ -0,0 +1,9 @@
+# @objectstack/objectql
+
+## 0.1.1
+
+### Patch Changes
+
+- Remove debug logs from registry and protocol modules
+- Updated dependencies
+  - @objectstack/spec@0.1.2

package/dist/index.d.ts

@@ -1,3 +1,41 @@
-export { ObjectQL } from './engine';
+import { DriverInterface, DriverOptions } from '@objectstack/spec';
 export { SchemaRegistry } from './registry';
-export type { DriverInterface, DriverOptions, QueryAST } from '@objectstack/spec';
+/**
+ * Host Context provided to plugins
+ */
+export interface PluginContext {
+    ql: ObjectQL;
+    logger: Console;
+    [key: string]: any;
+}
+/**
+ * ObjectQL Engine
+ */
+export declare class ObjectQL {
+    private drivers;
+    private defaultDriver;
+    private hostContext;
+    constructor(hostContext?: Record<string, any>);
+    /**
+     * Load and Register a Plugin
+     */
+    use(manifestPart: any, runtimePart?: any): Promise<void>;
+    /**
+     * Register a new storage driver
+     */
+    registerDriver(driver: DriverInterface, isDefault?: boolean): void;
+    /**
+     * Helper to get the target driver
+     */
+    private getDriver;
+    /**
+     * Initialize the engine and all registered drivers
+     */
+    init(): Promise<void>;
+    destroy(): Promise<void>;
+    find(object: string, filters?: any, options?: DriverOptions): Promise<Record<string, any>[]>;
+    insert(object: string, data: Record<string, any>, options?: DriverOptions): Promise<Record<string, any>>;
+    update(object: string, id: string, data: Record<string, any>, options?: DriverOptions): Promise<Record<string, any>>;
+    delete(object: string, id: string, options?: DriverOptions): Promise<boolean>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,aAAa,EAAiC,MAAM,mBAAmB,CAAC;AAIlG,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5C;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,QAAQ,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAEhB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED;;GAEG;AACH,qBAAa,QAAQ;IACnB,OAAO,CAAC,OAAO,CAAsC;IACrD,OAAO,CAAC,aAAa,CAAuB;IAG5C,OAAO,CAAC,WAAW,CAA2B;gBAElC,WAAW,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM;IAKjD;;OAEG;IACG,GAAG,CAAC,YAAY,EAAE,GAAG,EAAE,WAAW,CAAC,EAAE,GAAG;IA4D9C;;OAEG;IACH,cAAc,CAAC,MAAM,EAAE,eAAe,EAAE,SAAS,GAAE,OAAe;IAclE;;OAEG;IACH,OAAO,CAAC,SAAS;IASjB;;OAEG;IACG,IAAI;IAYJ,OAAO;IAUP,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,GAAQ,EAAE,OAAO,CAAC,EAAE,aAAa;IAmB/D,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,OAAO,CAAC,EAAE,aAAa;IAYzE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,OAAO,CAAC,EAAE,aAAa;IAMrF,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa;CAKjE"}

package/dist/index.js

@@ -1,8 +1,159 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SchemaRegistry = exports.ObjectQL = void 0;
-// Export core engine
-var engine_1 = require("./engine");
-Object.defineProperty(exports, "ObjectQL", { enumerable: true, get: function () { return engine_1.ObjectQL; } });
-var registry_1 = require("./registry");
-Object.defineProperty(exports, "SchemaRegistry", { enumerable: true, get: function () { return registry_1.SchemaRegistry; } });
+exports.ObjectQL = exports.SchemaRegistry = void 0;
+const registry_1 = require("./registry");
+// Export Registry for consumers
+var registry_2 = require("./registry");
+Object.defineProperty(exports, "SchemaRegistry", { enumerable: true, get: function () { return registry_2.SchemaRegistry; } });
+/**
+ * ObjectQL Engine
+ */
+class ObjectQL {
+    constructor(hostContext = {}) {
+        this.drivers = new Map();
+        this.defaultDriver = null;
+        // Host provided context additions (e.g. Server router)
+        this.hostContext = {};
+        this.hostContext = hostContext;
+        console.log(`[ObjectQL] Engine Instance Created`);
+    }
+    /**
+     * Load and Register a Plugin
+     */
+    async use(manifestPart, runtimePart) {
+        // 1. Validate / Register Manifest
+        if (manifestPart) {
+            // 1. Handle Module Imports (commonjs/esm interop)
+            // If the passed object is a module namespace with a default export, use that.
+            const manifest = manifestPart.default || manifestPart;
+            // In a real scenario, we might strictly parse this using Zod
+            // For now, simple ID check
+            const id = manifest.id || manifest.name;
+            if (!id) {
+                console.warn(`[ObjectQL] Plugin manifest missing ID (keys: ${Object.keys(manifest)})`, manifest);
+                // Don't return, try to proceed if it looks like an App (Apps might use 'name' instead of 'id')
+                // return; 
+            }
+            console.log(`[ObjectQL] Loading Plugin: ${id}`);
+            registry_1.SchemaRegistry.registerPlugin(manifest);
+            // Register Objects from App/Plugin
+            if (manifest.objects) {
+                for (const obj of manifest.objects) {
+                    // Ensure object name is registered globally
+                    registry_1.SchemaRegistry.registerObject(obj);
+                    console.log(`[ObjectQL] Registered Object: ${obj.name}`);
+                }
+            }
+            // Register contributions
+            if (manifest.contributes?.kinds) {
+                for (const kind of manifest.contributes.kinds) {
+                    registry_1.SchemaRegistry.registerKind(kind);
+                }
+            }
+            // Register Data Seeding (Lazy execution or immediate?)
+            // We store it in a temporary registry or execute immediately if engine is ready.
+            // Since `use` is init time, we might need to store it and run later in `seed()`.
+            // For this MVP, let's attach it to the manifest object in registry so Kernel can find it.
+        }
+        // 2. Execute Runtime
+        if (runtimePart) {
+            const pluginDef = runtimePart.default || runtimePart;
+            if (pluginDef.onEnable) {
+                const context = {
+                    ql: this,
+                    logger: console,
+                    // Expose the driver registry helper explicitly if needed
+                    drivers: {
+                        register: (driver) => this.registerDriver(driver)
+                    },
+                    ...this.hostContext
+                };
+                await pluginDef.onEnable(context);
+            }
+        }
+    }
+    /**
+     * Register a new storage driver
+     */
+    registerDriver(driver, isDefault = false) {
+        if (this.drivers.has(driver.name)) {
+            console.warn(`[ObjectQL] Driver ${driver.name} is already registered. Skipping.`);
+            return;
+        }
+        this.drivers.set(driver.name, driver);
+        console.log(`[ObjectQL] Registered driver: ${driver.name} v${driver.version}`);
+        if (isDefault || this.drivers.size === 1) {
+            this.defaultDriver = driver.name;
+        }
+    }
+    /**
+     * Helper to get the target driver
+     */
+    getDriver(_object) {
+        // TODO: Look up Object definition to see if it specifies a specific datasource/driver
+        // For now, always return default
+        if (!this.defaultDriver) {
+            throw new Error('[ObjectQL] No drivers registered!');
+        }
+        return this.drivers.get(this.defaultDriver);
+    }
+    /**
+     * Initialize the engine and all registered drivers
+     */
+    async init() {
+        console.log('[ObjectQL] Initializing drivers...');
+        for (const [name, driver] of this.drivers) {
+            try {
+                await driver.connect();
+            }
+            catch (e) {
+                console.error(`[ObjectQL] Failed to connect driver ${name}`, e);
+            }
+        }
+        // In a real app, we would sync schemas here
+    }
+    async destroy() {
+        for (const driver of this.drivers.values()) {
+            await driver.disconnect();
+        }
+    }
+    // ============================================
+    // Data Access Methods
+    // ============================================
+    async find(object, filters = {}, options) {
+        const driver = this.getDriver(object);
+        console.log(`[ObjectQL] Finding ${object} on ${driver.name}...`);
+        // Transform simplified filters to QueryAST
+        // This is a simplified "Mock" transform. 
+        // Real implementation would parse complex JSON or FilterBuilders.
+        const ast = {
+            object, // Add missing required field
+            // Pass through if it looks like AST, otherwise empty
+            // In this demo, we assume the caller passes a simplified object or raw AST
+            filters: filters.filters || undefined,
+            top: filters.top || 100,
+            sort: filters.sort || []
+        };
+        return driver.find(object, ast, options);
+    }
+    async insert(object, data, options) {
+        const driver = this.getDriver(object);
+        console.log(`[ObjectQL] Creating ${object} on ${driver.name}...`);
+        // 1. Validate Schema
+        // 2. Run "Before Insert" Triggers
+        const result = await driver.create(object, data, options);
+        // 3. Run "After Insert" Triggers
+        return result;
+    }
+    async update(object, id, data, options) {
+        const driver = this.getDriver(object);
+        console.log(`[ObjectQL] Updating ${object} ${id}...`);
+        return driver.update(object, id, data, options);
+    }
+    async delete(object, id, options) {
+        const driver = this.getDriver(object);
+        console.log(`[ObjectQL] Deleting ${object} ${id}...`);
+        return driver.delete(object, id, options);
+    }
+}
+exports.ObjectQL = ObjectQL;

package/dist/registry.d.ts

@@ -53,3 +53,4 @@ export declare class SchemaRegistry {
         globs: string[];
     }[];
 }
+//# sourceMappingURL=registry.d.ts.map

package/dist/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,GAAG,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAE5E;;;GAGG;AACH,qBAAa,cAAc;IAEzB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAuC;IAE9D;;;;;OAKG;IACH,MAAM,CAAC,YAAY,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,QAAQ,GAAE,MAAM,CAAqB;IAcnF;;OAEG;IACH,MAAM,CAAC,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAI5D;;OAEG;IACH,MAAM,CAAC,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,EAAE;IAItC;;OAEG;IACH,MAAM,CAAC,kBAAkB,IAAI,MAAM,EAAE;IAQrC;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,aAAa;IAI3C,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAIzD,MAAM,CAAC,aAAa,IAAI,aAAa,EAAE;IAIvC;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG;IAI3B,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,GAAG,SAAS;IAI5C,MAAM,CAAC,UAAU,IAAI,GAAG,EAAE;IAI1B;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,QAAQ,EAAE,mBAAmB;IAInD,MAAM,CAAC,aAAa,IAAI,mBAAmB,EAAE;IAI7C;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,EAAE,CAAA;KAAE;IAIzD,MAAM,CAAC,WAAW,IAAI;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,EAAE,CAAA;KAAE,EAAE;CAGxD"}

package/package.json

@@ -1,17 +1,18 @@
 {
   "name": "@objectstack/objectql",
-  "version": "0.0.1",
-  "description": "ObjectQL Reference Implementation",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
+  "version": "0.1.1",
+  "description": "Isomorphic ObjectQL Engine for ObjectStack",
+  "main": "src/index.ts",
+  "types": "src/index.ts",
   "dependencies": {
-    "@objectstack/spec": "0.1.1"
+    "@objectstack/spec": "0.1.2"
   },
   "devDependencies": {
-    "typescript": "^5.0.0"
+    "typescript": "^5.0.0",
+    "vitest": "^1.0.0"
   },
   "scripts": {
     "build": "tsc",
-    "dev": "tsc -w"
+    "test": "vitest"
   }
 }

package/src/index.ts

@@ -1,6 +1,191 @@
-// Export core engine
-export { ObjectQL } from './engine';
+import { DriverInterface, DriverOptions, QueryAST, ObjectStackManifest } from '@objectstack/spec';
+import { SchemaRegistry } from './registry';
+
+// Export Registry for consumers
 export { SchemaRegistry } from './registry';
 
-// Re-export common types from spec for convenience
-export type { DriverInterface, DriverOptions, QueryAST } from '@objectstack/spec';
+/**
+ * Host Context provided to plugins
+ */
+export interface PluginContext {
+  ql: ObjectQL;
+  logger: Console;
+  // Extensible map for host-specific globals (like HTTP Router, etc.)
+  [key: string]: any;
+}
+
+/**
+ * ObjectQL Engine
+ */
+export class ObjectQL {
+  private drivers = new Map<string, DriverInterface>();
+  private defaultDriver: string | null = null;
+  
+  // Host provided context additions (e.g. Server router)
+  private hostContext: Record<string, any> = {};
+
+  constructor(hostContext: Record<string, any> = {}) {
+    this.hostContext = hostContext;
+    console.log(`[ObjectQL] Engine Instance Created`);
+  }
+
+  /**
+   * Load and Register a Plugin
+   */
+  async use(manifestPart: any, runtimePart?: any) {
+    // 1. Validate / Register Manifest
+    if (manifestPart) {
+      // 1. Handle Module Imports (commonjs/esm interop)
+      // If the passed object is a module namespace with a default export, use that.
+      const manifest = manifestPart.default || manifestPart;
+
+      // In a real scenario, we might strictly parse this using Zod
+      // For now, simple ID check
+      const id = manifest.id || manifest.name;
+      if (!id) {
+        console.warn(`[ObjectQL] Plugin manifest missing ID (keys: ${Object.keys(manifest)})`, manifest);
+        // Don't return, try to proceed if it looks like an App (Apps might use 'name' instead of 'id')
+        // return; 
+      }
+      
+      console.log(`[ObjectQL] Loading Plugin: ${id}`);
+      SchemaRegistry.registerPlugin(manifest as ObjectStackManifest);
+
+      // Register Objects from App/Plugin
+      if (manifest.objects) {
+        for (const obj of manifest.objects) {
+            // Ensure object name is registered globally
+            SchemaRegistry.registerObject(obj);
+            console.log(`[ObjectQL] Registered Object: ${obj.name}`);
+        }
+      }
+
+      // Register contributions
+       if (manifest.contributes?.kinds) {
+          for (const kind of manifest.contributes.kinds) {
+            SchemaRegistry.registerKind(kind);
+          }
+       }
+
+       // Register Data Seeding (Lazy execution or immediate?)
+       // We store it in a temporary registry or execute immediately if engine is ready.
+       // Since `use` is init time, we might need to store it and run later in `seed()`.
+       // For this MVP, let's attach it to the manifest object in registry so Kernel can find it.
+    }
+
+    // 2. Execute Runtime
+    if (runtimePart) {
+       const pluginDef = (runtimePart as any).default || runtimePart;
+       if (pluginDef.onEnable) {
+          const context: PluginContext = {
+            ql: this,
+            logger: console,
+            // Expose the driver registry helper explicitly if needed
+            drivers: {
+                register: (driver: DriverInterface) => this.registerDriver(driver)
+            },
+            ...this.hostContext
+          };
+          
+          await pluginDef.onEnable(context);
+       }
+    }
+  }
+
+  /**
+   * Register a new storage driver
+   */
+  registerDriver(driver: DriverInterface, isDefault: boolean = false) {
+    if (this.drivers.has(driver.name)) {
+      console.warn(`[ObjectQL] Driver ${driver.name} is already registered. Skipping.`);
+      return;
+    }
+
+    this.drivers.set(driver.name, driver);
+    console.log(`[ObjectQL] Registered driver: ${driver.name} v${driver.version}`);
+
+    if (isDefault || this.drivers.size === 1) {
+      this.defaultDriver = driver.name;
+    }
+  }
+
+  /**
+   * Helper to get the target driver
+   */
+  private getDriver(_object: string): DriverInterface {
+    // TODO: Look up Object definition to see if it specifies a specific datasource/driver
+    // For now, always return default
+    if (!this.defaultDriver) {
+      throw new Error('[ObjectQL] No drivers registered!');
+    }
+    return this.drivers.get(this.defaultDriver)!;
+  }
+
+  /**
+   * Initialize the engine and all registered drivers
+   */
+  async init() {
+    console.log('[ObjectQL] Initializing drivers...');
+    for (const [name, driver] of this.drivers) {
+      try {
+        await driver.connect();
+      } catch (e) {
+        console.error(`[ObjectQL] Failed to connect driver ${name}`, e);
+      }
+    }
+    // In a real app, we would sync schemas here
+  }
+
+  async destroy() {
+    for (const driver of this.drivers.values()) {
+      await driver.disconnect();
+    }
+  }
+
+  // ============================================
+  // Data Access Methods
+  // ============================================
+
+  async find(object: string, filters: any = {}, options?: DriverOptions) {
+    const driver = this.getDriver(object);
+    console.log(`[ObjectQL] Finding ${object} on ${driver.name}...`);
+    
+    // Transform simplified filters to QueryAST
+    // This is a simplified "Mock" transform. 
+    // Real implementation would parse complex JSON or FilterBuilders.
+    const ast: QueryAST = {
+       object, // Add missing required field
+       // Pass through if it looks like AST, otherwise empty
+       // In this demo, we assume the caller passes a simplified object or raw AST
+       filters: filters.filters || undefined,
+       top: filters.top || 100,
+       sort: filters.sort || []
+    };
+
+    return driver.find(object, ast, options);
+  }
+
+  async insert(object: string, data: Record<string, any>, options?: DriverOptions) {
+    const driver = this.getDriver(object);
+    console.log(`[ObjectQL] Creating ${object} on ${driver.name}...`);
+    // 1. Validate Schema
+    // 2. Run "Before Insert" Triggers
+    
+    const result = await driver.create(object, data, options);
+    
+    // 3. Run "After Insert" Triggers
+    return result;
+  }
+
+  async update(object: string, id: string, data: Record<string, any>, options?: DriverOptions) {
+    const driver = this.getDriver(object);
+    console.log(`[ObjectQL] Updating ${object} ${id}...`);
+    return driver.update(object, id, data, options);
+  }
+
+  async delete(object: string, id: string, options?: DriverOptions) {
+    const driver = this.getDriver(object);
+    console.log(`[ObjectQL] Deleting ${object} ${id}...`);
+    return driver.delete(object, id, options);
+  }
+}

package/tsconfig.json

@@ -1,13 +1,9 @@
 {
+  "extends": "../../tsconfig.json",
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"],
   "compilerOptions": {
-    "target": "ES2020",
-    "module": "commonjs",
-    "declaration": true,
-    "outDir": "./dist",
-    "strict": true,
-    "esModuleInterop": true,
-    "skipLibCheck": true,
-    "forceConsistentCasingInFileNames": true
-  },
-  "include": ["src/**/*"]
+    "outDir": "dist",
+    "rootDir": "src"
+  }
 }

package/dist/engine.d.ts

@@ -1,40 +0,0 @@
-import { DriverInterface, DriverOptions } from '@objectstack/spec';
-/**
- * Host Context provided to plugins
- */
-export interface PluginContext {
-    ql: ObjectQL;
-    logger: Console;
-    [key: string]: any;
-}
-/**
- * ObjectQL Engine
- */
-export declare class ObjectQL {
-    private drivers;
-    private defaultDriver;
-    private plugins;
-    private hostContext;
-    constructor(hostContext?: Record<string, any>);
-    /**
-     * Load and Register a Plugin
-     */
-    use(manifestPart: any, runtimePart?: any): Promise<void>;
-    /**
-     * Register a new storage driver
-     */
-    registerDriver(driver: DriverInterface, isDefault?: boolean): void;
-    /**
-     * Helper to get the target driver
-     */
-    private getDriver;
-    /**
-     * Initialize the engine and all registered drivers
-     */
-    init(): Promise<void>;
-    destroy(): Promise<void>;
-    find(object: string, filters?: any, options?: DriverOptions): Promise<Record<string, any>[]>;
-    insert(object: string, data: Record<string, any>, options?: DriverOptions): Promise<Record<string, any>>;
-    update(object: string, id: string, data: Record<string, any>, options?: DriverOptions): Promise<Record<string, any>>;
-    delete(object: string, id: string, options?: DriverOptions): Promise<boolean>;
-}

package/dist/engine.js

@@ -1,139 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ObjectQL = void 0;
-const registry_1 = require("./registry");
-/**
- * ObjectQL Engine
- */
-class ObjectQL {
-    constructor(hostContext = {}) {
-        this.drivers = new Map();
-        this.defaultDriver = null;
-        this.plugins = new Map();
-        // Host provided context additions (e.g. Server router)
-        this.hostContext = {};
-        this.hostContext = hostContext;
-        console.log(`[ObjectQL] Engine Instance Created`);
-    }
-    /**
-     * Load and Register a Plugin
-     */
-    async use(manifestPart, runtimePart) {
-        // 1. Validate / Register Manifest
-        if (manifestPart) {
-            // In a real scenario, we might strictly parse this using Zod
-            // For now, simple ID check
-            const id = manifestPart.id;
-            if (!id) {
-                console.warn('[ObjectQL] Plugin manifest missing ID', manifestPart);
-                return;
-            }
-            console.log(`[ObjectQL] Loading Plugin: ${id}`);
-            registry_1.SchemaRegistry.registerPlugin(manifestPart);
-            // Register contributions
-            if (manifestPart.contributes?.kinds) {
-                for (const kind of manifestPart.contributes.kinds) {
-                    registry_1.SchemaRegistry.registerKind(kind);
-                }
-            }
-        }
-        // 2. Execute Runtime
-        if (runtimePart) {
-            const pluginDef = runtimePart.default || runtimePart;
-            if (pluginDef.onEnable) {
-                const context = {
-                    ql: this,
-                    logger: console,
-                    // Expose the driver registry helper explicitly if needed
-                    drivers: this, // Since `registerDriver` is on `this`, we can alias it or expose `this`
-                    ...this.hostContext
-                };
-                await pluginDef.onEnable(context);
-            }
-        }
-    }
-    /**
-     * Register a new storage driver
-     */
-    registerDriver(driver, isDefault = false) {
-        if (this.drivers.has(driver.name)) {
-            console.warn(`[ObjectQL] Driver ${driver.name} is already registered. Skipping.`);
-            return;
-        }
-        this.drivers.set(driver.name, driver);
-        console.log(`[ObjectQL] Registered driver: ${driver.name} v${driver.version}`);
-        if (isDefault || this.drivers.size === 1) {
-            this.defaultDriver = driver.name;
-        }
-    }
-    /**
-     * Helper to get the target driver
-     */
-    getDriver(object) {
-        // TODO: Look up Object definition to see if it specifies a specific datasource/driver
-        // For now, always return default
-        if (!this.defaultDriver) {
-            throw new Error('[ObjectQL] No drivers registered!');
-        }
-        return this.drivers.get(this.defaultDriver);
-    }
-    /**
-     * Initialize the engine and all registered drivers
-     */
-    async init() {
-        console.log('[ObjectQL] Initializing drivers...');
-        for (const [name, driver] of this.drivers) {
-            try {
-                await driver.connect();
-            }
-            catch (e) {
-                console.error(`[ObjectQL] Failed to connect driver ${name}`, e);
-            }
-        }
-        // In a real app, we would sync schemas here
-    }
-    async destroy() {
-        for (const driver of this.drivers.values()) {
-            await driver.disconnect();
-        }
-    }
-    // ============================================
-    // Data Access Methods
-    // ============================================
-    async find(object, filters = {}, options) {
-        const driver = this.getDriver(object);
-        console.log(`[ObjectQL] Finding ${object} on ${driver.name}...`);
-        // Transform simplified filters to QueryAST
-        // This is a simplified "Mock" transform. 
-        // Real implementation would parse complex JSON or FilterBuilders.
-        const ast = {
-            object, // Add missing required field
-            // Pass through if it looks like AST, otherwise empty
-            // In this demo, we assume the caller passes a simplified object or raw AST
-            filters: filters.filters || undefined,
-            top: filters.top || 100,
-            sort: filters.sort || []
-        };
-        return driver.find(object, ast, options);
-    }
-    async insert(object, data, options) {
-        const driver = this.getDriver(object);
-        console.log(`[ObjectQL] Creating ${object} on ${driver.name}...`);
-        // 1. Validate Schema
-        // 2. Run "Before Insert" Triggers
-        const result = await driver.create(object, data, options);
-        // 3. Run "After Insert" Triggers
-        return result;
-    }
-    async update(object, id, data, options) {
-        const driver = this.getDriver(object);
-        console.log(`[ObjectQL] Updating ${object} ${id}...`);
-        return driver.update(object, id, data, options);
-    }
-    async delete(object, id, options) {
-        const driver = this.getDriver(object);
-        console.log(`[ObjectQL] Deleting ${object} ${id}...`);
-        return driver.delete(object, id, options);
-    }
-}
-exports.ObjectQL = ObjectQL;

package/src/engine.ts

@@ -1,168 +0,0 @@
-import { DriverInterface, DriverOptions, QueryAST, ObjectStackManifest, ManifestSchema } from '@objectstack/spec';
-import { SchemaRegistry } from './registry';
-
-/**
- * Host Context provided to plugins
- */
-export interface PluginContext {
-  ql: ObjectQL;
-  logger: Console;
-  // Extensible map for host-specific globals (like HTTP Router, etc.)
-  [key: string]: any;
-}
-
-/**
- * ObjectQL Engine
- */
-export class ObjectQL {
-  private drivers = new Map<string, DriverInterface>();
-  private defaultDriver: string | null = null;
-  private plugins = new Map<string, any>();
-  
-  // Host provided context additions (e.g. Server router)
-  private hostContext: Record<string, any> = {};
-
-  constructor(hostContext: Record<string, any> = {}) {
-    this.hostContext = hostContext;
-    console.log(`[ObjectQL] Engine Instance Created`);
-  }
-
-  /**
-   * Load and Register a Plugin
-   */
-  async use(manifestPart: any, runtimePart?: any) {
-    // 1. Validate / Register Manifest
-    if (manifestPart) {
-      // In a real scenario, we might strictly parse this using Zod
-      // For now, simple ID check
-      const id = manifestPart.id;
-      if (!id) {
-        console.warn('[ObjectQL] Plugin manifest missing ID', manifestPart);
-        return;
-      }
-      
-      console.log(`[ObjectQL] Loading Plugin: ${id}`);
-      SchemaRegistry.registerPlugin(manifestPart as ObjectStackManifest);
-
-      // Register contributions
-       if (manifestPart.contributes?.kinds) {
-          for (const kind of manifestPart.contributes.kinds) {
-            SchemaRegistry.registerKind(kind);
-          }
-       }
-    }
-
-    // 2. Execute Runtime
-    if (runtimePart) {
-       const pluginDef = (runtimePart as any).default || runtimePart;
-       if (pluginDef.onEnable) {
-          const context: PluginContext = {
-            ql: this,
-            logger: console,
-            // Expose the driver registry helper explicitly if needed
-            drivers: this, // Since `registerDriver` is on `this`, we can alias it or expose `this`
-            ...this.hostContext
-          };
-          
-          await pluginDef.onEnable(context);
-       }
-    }
-  }
-
-  /**
-   * Register a new storage driver
-   */
-  registerDriver(driver: DriverInterface, isDefault: boolean = false) {
-    if (this.drivers.has(driver.name)) {
-      console.warn(`[ObjectQL] Driver ${driver.name} is already registered. Skipping.`);
-      return;
-    }
-
-    this.drivers.set(driver.name, driver);
-    console.log(`[ObjectQL] Registered driver: ${driver.name} v${driver.version}`);
-
-    if (isDefault || this.drivers.size === 1) {
-      this.defaultDriver = driver.name;
-    }
-  }
-
-  /**
-   * Helper to get the target driver
-   */
-  private getDriver(object: string): DriverInterface {
-    // TODO: Look up Object definition to see if it specifies a specific datasource/driver
-    // For now, always return default
-    if (!this.defaultDriver) {
-      throw new Error('[ObjectQL] No drivers registered!');
-    }
-    return this.drivers.get(this.defaultDriver)!;
-  }
-
-  /**
-   * Initialize the engine and all registered drivers
-   */
-  async init() {
-    console.log('[ObjectQL] Initializing drivers...');
-    for (const [name, driver] of this.drivers) {
-      try {
-        await driver.connect();
-      } catch (e) {
-        console.error(`[ObjectQL] Failed to connect driver ${name}`, e);
-      }
-    }
-    // In a real app, we would sync schemas here
-  }
-
-  async destroy() {
-    for (const driver of this.drivers.values()) {
-      await driver.disconnect();
-    }
-  }
-
-  // ============================================
-  // Data Access Methods
-  // ============================================
-
-  async find(object: string, filters: any = {}, options?: DriverOptions) {
-    const driver = this.getDriver(object);
-    console.log(`[ObjectQL] Finding ${object} on ${driver.name}...`);
-    
-    // Transform simplified filters to QueryAST
-    // This is a simplified "Mock" transform. 
-    // Real implementation would parse complex JSON or FilterBuilders.
-    const ast: QueryAST = {
-       object, // Add missing required field
-       // Pass through if it looks like AST, otherwise empty
-       // In this demo, we assume the caller passes a simplified object or raw AST
-       filters: filters.filters || undefined,
-       top: filters.top || 100,
-       sort: filters.sort || []
-    };
-
-    return driver.find(object, ast, options);
-  }
-
-  async insert(object: string, data: Record<string, any>, options?: DriverOptions) {
-    const driver = this.getDriver(object);
-    console.log(`[ObjectQL] Creating ${object} on ${driver.name}...`);
-    // 1. Validate Schema
-    // 2. Run "Before Insert" Triggers
-    
-    const result = await driver.create(object, data, options);
-    
-    // 3. Run "After Insert" Triggers
-    return result;
-  }
-
-  async update(object: string, id: string, data: Record<string, any>, options?: DriverOptions) {
-    const driver = this.getDriver(object);
-    console.log(`[ObjectQL] Updating ${object} ${id}...`);
-    return driver.update(object, id, data, options);
-  }
-
-  async delete(object: string, id: string, options?: DriverOptions) {
-    const driver = this.getDriver(object);
-    console.log(`[ObjectQL] Deleting ${object} ${id}...`);
-    return driver.delete(object, id, options);
-  }
-}