@objectstack/runtime 0.1.0 → 0.1.1

package/CHANGELOG.md

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

package/dist/index.d.ts

@@ -1,5 +1,4 @@
-export { ObjectQL } from './engine';
-export { SchemaRegistry } from './registry';
-export { DataEngine } from './data-engine';
+export { ObjectQL, SchemaRegistry } from '@objectstack/objectql';
+export { ObjectStackKernel } from './kernel';
 export { ObjectStackRuntimeProtocol } from './protocol';
-export type { DriverInterface, DriverOptions, QueryAST } from '@objectstack/spec';
+export * from './types';

package/dist/index.js

@@ -1,12 +1,26 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ObjectStackRuntimeProtocol = exports.DataEngine = exports.SchemaRegistry = exports.ObjectQL = void 0;
+exports.ObjectStackRuntimeProtocol = exports.ObjectStackKernel = 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; } });
-var data_engine_1 = require("./data-engine");
-Object.defineProperty(exports, "DataEngine", { enumerable: true, get: function () { return data_engine_1.DataEngine; } });
+var objectql_1 = require("@objectstack/objectql");
+Object.defineProperty(exports, "ObjectQL", { enumerable: true, get: function () { return objectql_1.ObjectQL; } });
+Object.defineProperty(exports, "SchemaRegistry", { enumerable: true, get: function () { return objectql_1.SchemaRegistry; } });
+var kernel_1 = require("./kernel");
+Object.defineProperty(exports, "ObjectStackKernel", { enumerable: true, get: function () { return kernel_1.ObjectStackKernel; } });
 var protocol_1 = require("./protocol");
 Object.defineProperty(exports, "ObjectStackRuntimeProtocol", { enumerable: true, get: function () { return protocol_1.ObjectStackRuntimeProtocol; } });
+__exportStar(require("./types"), exports);

package/dist/{data-engine.d.ts → kernel.d.ts}

@@ -1,13 +1,11 @@
-import { ObjectQL } from './engine';
+import { ObjectQL } from '@objectstack/objectql';
 /**
- * Server Data Engine Wrapper
+ * ObjectStack Kernel (Microkernel)
  *
- * This class is now a thin wrapper that initializes the ObjectQL Engine
- * with the appropriate Server-Side configuration (Registry, Drivers).
- *
- * The core logic has been moved to @objectstack/objectql.
+ * The central container orchestrating the application lifecycle,
+ * plugins, and the core ObjectQL engine.
  */
-export declare class DataEngine {
+export declare class ObjectStackKernel {
     ql: ObjectQL;
     private plugins;
     constructor(plugins?: any[]);

package/dist/{data-engine.js → kernel.js}

@@ -33,39 +33,44 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DataEngine = void 0;
-const registry_1 = require("./registry");
-const engine_1 = require("./engine");
+exports.ObjectStackKernel = void 0;
+const objectql_1 = require("@objectstack/objectql");
 /**
- * Server Data Engine Wrapper
+ * ObjectStack Kernel (Microkernel)
  *
- * This class is now a thin wrapper that initializes the ObjectQL Engine
- * with the appropriate Server-Side configuration (Registry, Drivers).
- *
- * The core logic has been moved to @objectstack/objectql.
+ * The central container orchestrating the application lifecycle,
+ * plugins, and the core ObjectQL engine.
  */
-class DataEngine {
+class ObjectStackKernel {
     constructor(plugins = []) {
         // 1. Initialize Engine with Host Context (Simulated OS services)
-        this.ql = new engine_1.ObjectQL({
+        this.ql = new objectql_1.ObjectQL({
             env: process.env.NODE_ENV || 'development'
         });
         this.plugins = plugins;
     }
     async start() {
-        console.log('[DataEngine] Starting...');
+        console.log('[Kernel] Starting...');
         // 0. Register Provided Plugins
-        this.plugins.forEach(p => {
-            console.log(`[DataEngine] Loading Plugin: ${p.id || p.name}`);
-            registry_1.SchemaRegistry.registerPlugin(p);
+        for (const p of this.plugins) {
+            // Check if it is a Runtime Plugin (System Capability)
+            if ('onStart' in p || 'install' in p) {
+                console.log(`[Kernel] Loading Runtime Plugin: ${p.name}`);
+                if (p.install)
+                    await p.install({ engine: this });
+                continue;
+            }
+            // Otherwise treat as App Manifest
+            console.log(`[Kernel] Loading App Manifest: ${p.id || p.name}`);
+            objectql_1.SchemaRegistry.registerPlugin(p);
             // Register Objects from App/Plugin
             if (p.objects) {
                 for (const obj of p.objects) {
-                    registry_1.SchemaRegistry.registerObject(obj);
-                    console.log(`[DataEngine] Registered Object: ${obj.name}`);
+                    objectql_1.SchemaRegistry.registerObject(obj);
+                    console.log(`[Kernel] Registered Object: ${obj.name}`);
                 }
             }
-        });
+        }
         // 1. Load Drivers (Default to Memory if none provided in plugins)
         // TODO: Detect driver from plugins. For now, we still hard load memory driver if needed?
         // In strict mode, user should pass driver in plugins array (DriverManifest).
@@ -84,6 +89,13 @@ class DataEngine {
         await this.ql.init();
         // 3. Seed Data
         await this.seed();
+        // 4. Start Runtime Plugins
+        for (const p of this.plugins) {
+            if (('onStart' in p) && typeof p.onStart === 'function') {
+                console.log(`[Kernel] Starting Plugin: ${p.name}`);
+                await p.onStart({ engine: this });
+            }
+        }
     }
     async seed() {
         // If no driver registered yet, this might fail or wait. 
@@ -96,28 +108,28 @@ class DataEngine {
             }
             catch { }
             // Iterate over all registered plugins/apps and check for 'data' property in manifest
-            const plugins = registry_1.SchemaRegistry.getRegisteredTypes(); // This returns types like 'plugin', 'app'
+            const plugins = objectql_1.SchemaRegistry.getRegisteredTypes(); // This returns types like 'plugin', 'app'
             // This is a bit hacky because we don't have a direct "getAllManifests" API exposed easily
             // We will iterate known apps for now, or improve Registry API later.
             // Actually, SchemaRegistry.listItems('app') returns the manifests!
-            const apps = [...registry_1.SchemaRegistry.listItems('app'), ...registry_1.SchemaRegistry.listItems('plugin')];
+            const apps = [...objectql_1.SchemaRegistry.listItems('app'), ...objectql_1.SchemaRegistry.listItems('plugin')];
             for (const appItem of apps) {
                 const app = appItem; // Cast to access data prop safely
                 if (app.data && Array.isArray(app.data)) {
-                    console.log(`[DataEngine] Seeding data for ${app.name || app.id}...`);
+                    console.log(`[Kernel] Seeding data for ${app.name || app.id}...`);
                     for (const seed of app.data) {
                         try {
                             // Check if data exists
                             const existing = await this.ql.find(seed.object, { top: 1 });
                             if (existing.length === 0) {
-                                console.log(`[DataEngine] Inserting ${seed.records.length} records into ${seed.object}`);
+                                console.log(`[Kernel] Inserting ${seed.records.length} records into ${seed.object}`);
                                 for (const record of seed.records) {
                                     await this.ql.insert(seed.object, record);
                                 }
                             }
                         }
                         catch (e) {
-                            console.warn(`[DataEngine] Failed to seed ${seed.object}`, e);
+                            console.warn(`[Kernel] Failed to seed ${seed.object}`, e);
                         }
                     }
                 }
@@ -173,10 +185,10 @@ class DataEngine {
         return null;
     }
     ensureSchema(name) {
-        const schema = registry_1.SchemaRegistry.getObject(name);
+        const schema = objectql_1.SchemaRegistry.getObject(name);
         if (!schema)
             throw new Error(`Unknown object: ${name}`);
         return schema;
     }
 }
-exports.DataEngine = DataEngine;
+exports.ObjectStackKernel = ObjectStackKernel;

package/dist/protocol.d.ts

@@ -1,4 +1,4 @@
-import { DataEngine } from './data-engine';
+import { ObjectStackKernel } from './kernel';
 export interface ApiRequest {
     params: Record<string, string>;
     query: Record<string, string | string[]>;
@@ -6,7 +6,7 @@ export interface ApiRequest {
 }
 export declare class ObjectStackRuntimeProtocol {
     private engine;
-    constructor(engine: DataEngine);
+    constructor(engine: ObjectStackKernel);
     getDiscovery(): {
         name: string;
         version: string;

package/dist/protocol.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ObjectStackRuntimeProtocol = void 0;
-const registry_1 = require("./registry");
+const objectql_1 = require("@objectstack/objectql");
 class ObjectStackRuntimeProtocol {
     constructor(engine) {
         this.engine = engine;
@@ -27,12 +27,12 @@ class ObjectStackRuntimeProtocol {
     }
     // 2. Metadata: List Types
     getMetaTypes() {
-        const types = registry_1.SchemaRegistry.getRegisteredTypes();
+        const types = objectql_1.SchemaRegistry.getRegisteredTypes();
         return {
             data: types.map(type => ({
                 type,
                 href: `/api/v1/meta/${type}s`,
-                count: registry_1.SchemaRegistry.listItems(type).length
+                count: objectql_1.SchemaRegistry.listItems(type).length
             }))
         };
     }
@@ -48,7 +48,7 @@ class ObjectStackRuntimeProtocol {
             'kinds': 'kind'
         };
         const type = typeMap[typePlural] || typePlural;
-        const items = registry_1.SchemaRegistry.listItems(type);
+        const items = objectql_1.SchemaRegistry.listItems(type);
         const summaries = items.map((item) => ({
             id: item.id,
             name: item.name,
@@ -72,7 +72,7 @@ class ObjectStackRuntimeProtocol {
             'kinds': 'kind'
         };
         const type = typeMap[typePlural] || typePlural;
-        const item = registry_1.SchemaRegistry.getItem(type, name);
+        const item = objectql_1.SchemaRegistry.getItem(type, name);
         if (!item)
             throw new Error(`Metadata not found: ${type}/${name}`);
         return item;

package/dist/types.d.ts

@@ -0,0 +1,9 @@
+import { ObjectStackKernel } from './kernel';
+export interface RuntimeContext {
+    engine: ObjectStackKernel;
+}
+export interface RuntimePlugin {
+    name: string;
+    install?: (ctx: RuntimeContext) => void | Promise<void>;
+    onStart?: (ctx: RuntimeContext) => void | Promise<void>;
+}

package/dist/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/package.json

@@ -1,11 +1,13 @@
 {
   "name": "@objectstack/runtime",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "ObjectStack Core Runtime & Query Engine",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "dependencies": {
-    "@objectstack/spec": "0.1.1"
+    "@objectstack/objectql": "0.1.1",
+    "@objectstack/types": "0.1.1",
+    "@objectstack/spec": "0.1.2"
   },
   "devDependencies": {
     "typescript": "^5.0.0"

package/src/index.ts

@@ -1,10 +1,7 @@
 // Export core engine
-export { ObjectQL } from './engine';
-export { SchemaRegistry } from './registry';
-export { DataEngine } from './data-engine';
+export { ObjectQL, SchemaRegistry } from '@objectstack/objectql';
+export { ObjectStackKernel } from './kernel';
 export { ObjectStackRuntimeProtocol } from './protocol';
 
+export * from './types';
 
-
-// Re-export common types from spec for convenience
-export type { DriverInterface, DriverOptions, QueryAST } from '@objectstack/spec';

package/src/{data-engine.ts → kernel.ts}

@@ -1,16 +1,13 @@
 import { ServiceObject } from '@objectstack/spec';
-import { SchemaRegistry } from './registry';
-import { ObjectQL } from './engine';
+import { SchemaRegistry, ObjectQL } from '@objectstack/objectql';
 
 /**
- * Server Data Engine Wrapper
+ * ObjectStack Kernel (Microkernel)
  * 
- * This class is now a thin wrapper that initializes the ObjectQL Engine 
- * with the appropriate Server-Side configuration (Registry, Drivers).
- * 
- * The core logic has been moved to @objectstack/objectql.
+ * The central container orchestrating the application lifecycle,
+ * plugins, and the core ObjectQL engine.
  */
-export class DataEngine {
+export class ObjectStackKernel {
   public ql: ObjectQL;
   private plugins: any[];
 
@@ -23,21 +20,29 @@ export class DataEngine {
   }
 
   async start() {
-    console.log('[DataEngine] Starting...');
+    console.log('[Kernel] Starting...');
     
     // 0. Register Provided Plugins
-    this.plugins.forEach(p => {
-        console.log(`[DataEngine] Loading Plugin: ${p.id || p.name}`);
+    for (const p of this.plugins) {
+        // Check if it is a Runtime Plugin (System Capability)
+        if ('onStart' in p || 'install' in p) {
+             console.log(`[Kernel] Loading Runtime Plugin: ${p.name}`);
+             if (p.install) await p.install({ engine: this });
+             continue;
+        }
+        
+        // Otherwise treat as App Manifest
+        console.log(`[Kernel] Loading App Manifest: ${p.id || p.name}`);
         SchemaRegistry.registerPlugin(p);
         
         // Register Objects from App/Plugin
         if (p.objects) {
             for (const obj of p.objects) {
                 SchemaRegistry.registerObject(obj);
-                console.log(`[DataEngine] Registered Object: ${obj.name}`);
+                console.log(`[Kernel] Registered Object: ${obj.name}`);
             }
         }
-    });
+    }
 
     // 1. Load Drivers (Default to Memory if none provided in plugins)
     // TODO: Detect driver from plugins. For now, we still hard load memory driver if needed?
@@ -60,6 +65,14 @@ export class DataEngine {
 
     // 3. Seed Data
     await this.seed();
+
+    // 4. Start Runtime Plugins
+    for (const p of this.plugins) {
+        if (('onStart' in p) && typeof p.onStart === 'function') {
+            console.log(`[Kernel] Starting Plugin: ${p.name}`);
+            await p.onStart({ engine: this });
+        }
+    }
   }
 
   async seed() {
@@ -85,19 +98,19 @@ export class DataEngine {
         for (const appItem of apps) {
             const app = appItem as any; // Cast to access data prop safely
             if (app.data && Array.isArray(app.data)) {
-                console.log(`[DataEngine] Seeding data for ${app.name || app.id}...`);
+                console.log(`[Kernel] Seeding data for ${app.name || app.id}...`);
                 for (const seed of app.data) {
                      try {
                         // Check if data exists
                         const existing = await this.ql.find(seed.object, { top: 1 });
                         if (existing.length === 0) {
-                             console.log(`[DataEngine] Inserting ${seed.records.length} records into ${seed.object}`);
+                             console.log(`[Kernel] Inserting ${seed.records.length} records into ${seed.object}`);
                              for (const record of seed.records) {
                                  await this.ql.insert(seed.object, record);
                              }
                         }
                      } catch (e) {
-                         console.warn(`[DataEngine] Failed to seed ${seed.object}`, e);
+                         console.warn(`[Kernel] Failed to seed ${seed.object}`, e);
                      }
                 }
             }

package/src/protocol.ts

@@ -1,5 +1,5 @@
-import { SchemaRegistry } from './registry';
-import { DataEngine } from './data-engine';
+import { SchemaRegistry } from '@objectstack/objectql';
+import { ObjectStackKernel } from './kernel';
 
 export interface ApiRequest {
     params: Record<string, string>;
@@ -8,9 +8,9 @@ export interface ApiRequest {
 }
 
 export class ObjectStackRuntimeProtocol {
-    private engine: DataEngine;
+    private engine: ObjectStackKernel;
 
-    constructor(engine: DataEngine) {
+    constructor(engine: ObjectStackKernel) {
         this.engine = engine;
     }
 

package/src/types.ts

@@ -0,0 +1,11 @@
+import { ObjectStackKernel } from './kernel';
+
+export interface RuntimeContext {
+    engine: ObjectStackKernel;
+}
+
+export interface RuntimePlugin {
+    name: string;
+    install?: (ctx: RuntimeContext) => void | Promise<void>;
+    onStart?: (ctx: RuntimeContext) => void | Promise<void>;
+}

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,157 +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) {
-            // 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 DataEngine 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

@@ -1,55 +0,0 @@
-import { ServiceObject, App, ObjectStackManifest } from '@objectstack/spec';
-/**
- * Global Schema Registry
- * Unified storage for all metadata types (Objects, Apps, Flows, Layouts, etc.)
- */
-export declare class SchemaRegistry {
-    private static metadata;
-    /**
-     * Universal Register Method
-     * @param type The category of metadata (e.g., 'object', 'app', 'plugin')
-     * @param item The metadata item itself
-     * @param keyField The property to use as the unique key (default: 'name')
-     */
-    static registerItem<T>(type: string, item: T, keyField?: keyof T): void;
-    /**
-     * Universal Get Method
-     */
-    static getItem<T>(type: string, name: string): T | undefined;
-    /**
-     * Universal List Method
-     */
-    static listItems<T>(type: string): T[];
-    /**
-     * Get all registered metadata types (Kinds)
-     */
-    static getRegisteredTypes(): string[];
-    /**
-     * Object Helpers
-     */
-    static registerObject(schema: ServiceObject): void;
-    static getObject(name: string): ServiceObject | undefined;
-    static getAllObjects(): ServiceObject[];
-    /**
-     * App Helpers
-     */
-    static registerApp(app: App): void;
-    static getApp(name: string): App | undefined;
-    static getAllApps(): App[];
-    /**
-     * Plugin Helpers
-     */
-    static registerPlugin(manifest: ObjectStackManifest): void;
-    static getAllPlugins(): ObjectStackManifest[];
-    /**
-     * Kind (Metadata Type) Helpers
-     */
-    static registerKind(kind: {
-        id: string;
-        globs: string[];
-    }): void;
-    static getAllKinds(): {
-        id: string;
-        globs: string[];
-    }[];
-}

package/dist/registry.js

@@ -1,93 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.SchemaRegistry = void 0;
-/**
- * Global Schema Registry
- * Unified storage for all metadata types (Objects, Apps, Flows, Layouts, etc.)
- */
-class SchemaRegistry {
-    /**
-     * Universal Register Method
-     * @param type The category of metadata (e.g., 'object', 'app', 'plugin')
-     * @param item The metadata item itself
-     * @param keyField The property to use as the unique key (default: 'name')
-     */
-    static registerItem(type, item, keyField = 'name') {
-        if (!this.metadata.has(type)) {
-            this.metadata.set(type, new Map());
-        }
-        const collection = this.metadata.get(type);
-        const key = String(item[keyField]);
-        if (collection.has(key)) {
-            console.warn(`[Registry] Overwriting ${type}: ${key}`);
-        }
-        collection.set(key, item);
-        console.log(`[Registry] Registered ${type}: ${key}`);
-    }
-    /**
-     * Universal Get Method
-     */
-    static getItem(type, name) {
-        return this.metadata.get(type)?.get(name);
-    }
-    /**
-     * Universal List Method
-     */
-    static listItems(type) {
-        return Array.from(this.metadata.get(type)?.values() || []);
-    }
-    /**
-     * Get all registered metadata types (Kinds)
-     */
-    static getRegisteredTypes() {
-        return Array.from(this.metadata.keys());
-    }
-    // ==========================================
-    // Typed Helper Methods (Shortcuts)
-    // ==========================================
-    /**
-     * Object Helpers
-     */
-    static registerObject(schema) {
-        this.registerItem('object', schema, 'name');
-    }
-    static getObject(name) {
-        return this.getItem('object', name);
-    }
-    static getAllObjects() {
-        return this.listItems('object');
-    }
-    /**
-     * App Helpers
-     */
-    static registerApp(app) {
-        this.registerItem('app', app, 'name');
-    }
-    static getApp(name) {
-        return this.getItem('app', name);
-    }
-    static getAllApps() {
-        return this.listItems('app');
-    }
-    /**
-     * Plugin Helpers
-     */
-    static registerPlugin(manifest) {
-        this.registerItem('plugin', manifest, 'id');
-    }
-    static getAllPlugins() {
-        return this.listItems('plugin');
-    }
-    /**
-     * Kind (Metadata Type) Helpers
-     */
-    static registerKind(kind) {
-        this.registerItem('kind', kind, 'id');
-    }
-    static getAllKinds() {
-        return this.listItems('kind');
-    }
-}
-exports.SchemaRegistry = SchemaRegistry;
-// Nested Map: Type -> Name/ID -> MetadataItem
-SchemaRegistry.metadata = new Map();

package/src/engine.ts

@@ -1,189 +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) {
-      // 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 DataEngine 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/src/registry.ts

@@ -1,107 +0,0 @@
-import { ServiceObject, App, ObjectStackManifest } from '@objectstack/spec';
-
-/**
- * Global Schema Registry
- * Unified storage for all metadata types (Objects, Apps, Flows, Layouts, etc.)
- */
-export class SchemaRegistry {
-  // Nested Map: Type -> Name/ID -> MetadataItem
-  private static metadata = new Map<string, Map<string, any>>();
-
-  /**
-   * Universal Register Method
-   * @param type The category of metadata (e.g., 'object', 'app', 'plugin')
-   * @param item The metadata item itself
-   * @param keyField The property to use as the unique key (default: 'name')
-   */
-  static registerItem<T>(type: string, item: T, keyField: keyof T = 'name' as keyof T) {
-    if (!this.metadata.has(type)) {
-      this.metadata.set(type, new Map());
-    }
-    const collection = this.metadata.get(type)!;
-    const key = String(item[keyField]);
-
-    if (collection.has(key)) {
-      console.warn(`[Registry] Overwriting ${type}: ${key}`);
-    }
-    collection.set(key, item);
-    console.log(`[Registry] Registered ${type}: ${key}`);
-  }
-
-  /**
-   * Universal Get Method
-   */
-  static getItem<T>(type: string, name: string): T | undefined {
-    return this.metadata.get(type)?.get(name) as T;
-  }
-
-  /**
-   * Universal List Method
-   */
-  static listItems<T>(type: string): T[] {
-    return Array.from(this.metadata.get(type)?.values() || []) as T[];
-  }
-
-  /**
-   * Get all registered metadata types (Kinds)
-   */
-  static getRegisteredTypes(): string[] {
-    return Array.from(this.metadata.keys());
-  }
-
-  // ==========================================
-  // Typed Helper Methods (Shortcuts)
-  // ==========================================
-
-  /**
-   * Object Helpers
-   */
-  static registerObject(schema: ServiceObject) {
-    this.registerItem('object', schema, 'name');
-  }
-
-  static getObject(name: string): ServiceObject | undefined {
-    return this.getItem<ServiceObject>('object', name);
-  }
-
-  static getAllObjects(): ServiceObject[] {
-    return this.listItems<ServiceObject>('object');
-  }
-
-  /**
-   * App Helpers
-   */
-  static registerApp(app: App) {
-    this.registerItem('app', app, 'name');
-  }
-
-  static getApp(name: string): App | undefined {
-    return this.getItem<App>('app', name);
-  }
-
-  static getAllApps(): App[] {
-    return this.listItems<App>('app');
-  }
-
-  /**
-   * Plugin Helpers
-   */
-  static registerPlugin(manifest: ObjectStackManifest) {
-    this.registerItem('plugin', manifest, 'id');
-  }
-
-  static getAllPlugins(): ObjectStackManifest[] {
-    return this.listItems<ObjectStackManifest>('plugin');
-  }
-
-  /**
-   * Kind (Metadata Type) Helpers
-   */
-  static registerKind(kind: { id: string, globs: string[] }) {
-    this.registerItem('kind', kind, 'id');
-  }
-  
-  static getAllKinds(): { id: string, globs: string[] }[] {
-    return this.listItems('kind');
-  }
-}