@objectstack/objectql 0.4.2 → 0.6.1

package/dist/index.d.ts

@@ -1,164 +1,6 @@
-import { HookContext } from '@objectstack/spec/data';
-import { DriverInterface, DriverOptions } from '@objectstack/spec/system';
 export { SchemaRegistry } from './registry';
-export type HookHandler = (context: HookContext) => Promise<void> | void;
-/**
- * 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 hooks;
-    private hostContext;
-    constructor(hostContext?: Record<string, any>);
-    /**
-     * Load and Register a Plugin
-     */
-    use(manifestPart: any, runtimePart?: any): Promise<void>;
-    /**
-     * Register a hook
-     * @param event The event name (e.g. 'beforeFind', 'afterInsert')
-     * @param handler The handler function
-     */
-    registerHook(event: string, handler: HookHandler): void;
-    private triggerHooks;
-    /**
-     * Register a new storage driver
-     */
-    registerDriver(driver: DriverInterface, isDefault?: boolean): void;
-    /**
-     * Helper to get object definition
-     */
-    getSchema(objectName: string): {
-        fields: Record<string, {
-            type: "number" | "boolean" | "code" | "date" | "text" | "textarea" | "email" | "url" | "phone" | "password" | "markdown" | "html" | "richtext" | "currency" | "percent" | "datetime" | "time" | "toggle" | "select" | "multiselect" | "radio" | "checkboxes" | "lookup" | "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;
-            unique: boolean;
-            deleteBehavior: "set_null" | "cascade" | "restrict";
-            hidden: boolean;
-            readonly: boolean;
-            encryption: boolean;
-            index: boolean;
-            externalId: boolean;
-            options?: {
-                value: string;
-                label: string;
-                color?: string | undefined;
-                default?: boolean | undefined;
-            }[] | undefined;
-            min?: number | undefined;
-            max?: number | 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;
-            scale?: number | undefined;
-            reference?: string | undefined;
-            referenceFilters?: string[] | undefined;
-            writeRequiresMasterRead?: boolean | undefined;
-            expression?: string | undefined;
-            summaryOperations?: {
-                object: string;
-                function: "count" | "sum" | "avg" | "min" | "max";
-                field: string;
-            } | undefined;
-            language?: string | undefined;
-            theme?: string | undefined;
-            lineNumbers?: boolean | undefined;
-            maxRating?: number | undefined;
-            allowHalf?: boolean | undefined;
-            displayMap?: boolean | undefined;
-            allowGeocoding?: boolean | undefined;
-            addressFormat?: "us" | "uk" | "international" | undefined;
-            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;
-            qrErrorCorrection?: "L" | "M" | "Q" | "H" | undefined;
-            displayValue?: boolean | undefined;
-            allowScanning?: boolean | undefined;
-            currencyConfig?: {
-                precision: number;
-                currencyMode: "dynamic" | "fixed";
-                defaultCurrency: string;
-            } | undefined;
-            vectorConfig?: {
-                dimensions: number;
-                distanceMetric: "cosine" | "euclidean" | "dotProduct" | "manhattan";
-                normalized: boolean;
-                indexed: boolean;
-                indexType?: "flat" | "hnsw" | "ivfflat" | undefined;
-            } | undefined;
-        }>;
-        name: string;
-        active: boolean;
-        isSystem: boolean;
-        abstract: boolean;
-        datasource: string;
-        tags?: string[] | undefined;
-        label?: string | undefined;
-        description?: string | undefined;
-        search?: {
-            fields: string[];
-            displayFields?: string[] | undefined;
-            filters?: string[] | undefined;
-        } | undefined;
-        pluralLabel?: string | undefined;
-        icon?: string | undefined;
-        tableName?: string | undefined;
-        indexes?: {
-            fields: string[];
-            type?: "hash" | "btree" | "gin" | "gist" | undefined;
-            name?: string | undefined;
-            unique?: boolean | undefined;
-        }[] | undefined;
-        validations?: any[] | undefined;
-        titleFormat?: string | undefined;
-        compactLayout?: string[] | undefined;
-        enable?: {
-            searchable: boolean;
-            trackHistory: boolean;
-            apiEnabled: boolean;
-            files: boolean;
-            feeds: boolean;
-            activities: boolean;
-            trash: boolean;
-            mru: boolean;
-            clone: boolean;
-            apiMethods?: ("update" | "delete" | "get" | "list" | "create" | "upsert" | "bulk" | "aggregate" | "history" | "search" | "restore" | "purge" | "import" | "export")[] | undefined;
-        } | undefined;
-    } | undefined;
-    /**
-     * Helper to get the target driver
-     */
-    private getDriver;
-    /**
-     * Initialize the engine and all registered drivers
-     */
-    init(): Promise<void>;
-    destroy(): Promise<void>;
-    find(object: string, query?: any, options?: DriverOptions): Promise<any>;
-    findOne(object: string, idOrQuery: string | any, options?: DriverOptions): Promise<Record<string, any> | null>;
-    insert(object: string, data: Record<string, any>, options?: DriverOptions): Promise<any>;
-    update(object: string, id: string | number, data: Record<string, any>, options?: DriverOptions): Promise<any>;
-    delete(object: string, id: string | number, options?: DriverOptions): Promise<any>;
-}
+export { ObjectStackProtocolImplementation } from './protocol';
+export { ObjectQL } from './engine';
+export type { ObjectQLHostContext, HookHandler } from './engine';
+export { ObjectQLPlugin } from './plugin';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAE/D,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAI1E,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5C,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AAEzE;;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,KAAK,CAKX;IAGF,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;;;;OAIG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW;YAQlC,YAAY;IAQ1B;;OAEG;IACH,cAAc,CAAC,MAAM,EAAE,eAAe,EAAE,SAAS,GAAE,OAAe;IAclE;;OAEG;IACH,SAAS,CAAC,UAAU,EAAE,MAAM;;;;;;;;;;;;;mBAyMi/T,CAAC;;;qBAA2E,CAAC;uBAAyC,CAAC;;eAA2D,CAAC;eAAiC,CAAC;mBAAqC,CAAC;iBAAmC,CAAC;qBAAuC,CAAC;gBAAkC,CAAC;uBAAyC,CAAC;kBAAoC,CAAC;wBAA0C,CAAC;qBAAwB,CAAC;qBAAuC,CAAC;iBAAmC,CAAC;qBAAuC,CAAC;4BAA8C,CAAC;mCAAuD,CAAC;sBAAyC,CAAC;6BAA+C,CAAC;;;;;oBAAiK,CAAC;iBAAmC,CAAC;uBAAyC,CAAC;qBAAwC,CAAC;qBAAuC,CAAC;sBAAyC,CAAC;0BAA6C,CAAC;yBAA4C,CAAC;uBAAgE,CAAC;sBAAgE,CAAC;wBAA2C,CAAC;gBAAoC,CAAC;qBAAuC,CAAC;iBAAoC,CAAC;yBAA2D,CAAC;6BAAyG,CAAC;wBAAyD,CAAC;yBAA4C,CAAC;0BAA6C,CAAC;;;;;wBAAkK,CAAC;;;;;yBAAyM,CAAC;;;;;;;;;;;;;yBAA4V,CAAC;mBAAuC,CAAC;;;;;;;gBAA0M,CAAC;gBAA6D,CAAC;kBAAoC,CAAC;;;;;;;;;;;;;;;sBAA8a,CAAC;;;IArM/ya;;OAEG;IACH,OAAO,CAAC,SAAS;IAqCjB;;OAEG;IACG,IAAI;IAYJ,OAAO;IAUP,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,GAAE,GAAQ,EAAE,OAAO,CAAC,EAAE,aAAa;IAqC7D,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,GAAG,EAAE,OAAO,CAAC,EAAE,aAAa;IAwBxE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,OAAO,CAAC,EAAE,aAAa;IA+BzE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,OAAO,CAAC,EAAE,aAAa;IAoB9F,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa;CAmB1E"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAG5C,OAAO,EAAE,iCAAiC,EAAE,MAAM,YAAY,CAAC;AAG/D,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACpC,YAAY,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAGjE,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC"}

package/dist/index.js

@@ -1,286 +1,9 @@
-import { SchemaRegistry } from './registry';
-// Export Registry for consumers
+// Export Registry
 export { SchemaRegistry } from './registry';
-/**
- * ObjectQL Engine
- */
-export class ObjectQL {
-    constructor(hostContext = {}) {
-        this.drivers = new Map();
-        this.defaultDriver = null;
-        // Hooks Registry
-        this.hooks = {
-            'beforeFind': [], 'afterFind': [],
-            'beforeInsert': [], 'afterInsert': [],
-            'beforeUpdate': [], 'afterUpdate': [],
-            'beforeDelete': [], 'afterDelete': [],
-        };
-        // 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}`);
-            SchemaRegistry.registerPlugin(manifest);
-            // 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.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 hook
-     * @param event The event name (e.g. 'beforeFind', 'afterInsert')
-     * @param handler The handler function
-     */
-    registerHook(event, handler) {
-        if (!this.hooks[event]) {
-            this.hooks[event] = [];
-        }
-        this.hooks[event].push(handler);
-        console.log(`[ObjectQL] Registered hook for ${event}`);
-    }
-    async triggerHooks(event, context) {
-        const handlers = this.hooks[event] || [];
-        for (const handler of handlers) {
-            // In a real system, we might want to catch errors here or allow them to bubble up
-            await handler(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 object definition
-     */
-    getSchema(objectName) {
-        return SchemaRegistry.getObject(objectName);
-    }
-    /**
-     * Helper to get the target driver
-     */
-    getDriver(objectName) {
-        const object = SchemaRegistry.getObject(objectName);
-        // 1. If object definition exists, check for explicit datasource
-        if (object) {
-            const datasourceName = object.datasource || 'default';
-            // If configured for 'default', try to find the default driver
-            if (datasourceName === 'default') {
-                if (this.defaultDriver && this.drivers.has(this.defaultDriver)) {
-                    return this.drivers.get(this.defaultDriver);
-                }
-                // Fallback: If 'default' not explicitly set, use the first available driver?
-                // Better to be strict.
-            }
-            else {
-                // Specific datasource requested
-                if (this.drivers.has(datasourceName)) {
-                    return this.drivers.get(datasourceName);
-                }
-                // If not found, fall back to default? Or error?
-                // Standard behavior: Error if specific datasource is missing.
-                throw new Error(`[ObjectQL] Datasource '${datasourceName}' configured for object '${objectName}' is not registered.`);
-            }
-        }
-        // 2. Fallback for ad-hoc objects or missing definitions
-        // If we have a default driver, use it.
-        if (this.defaultDriver) {
-            if (!object) {
-                console.warn(`[ObjectQL] Object '${objectName}' not found in registry. Using default driver.`);
-            }
-            return this.drivers.get(this.defaultDriver);
-        }
-        throw new Error(`[ObjectQL] No driver available for object '${objectName}'`);
-    }
-    /**
-     * 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, query = {}, options) {
-        const driver = this.getDriver(object);
-        // Normalize QueryAST
-        let ast;
-        if (query.where || query.fields || query.orderBy || query.limit) {
-            ast = { object, ...query };
-        }
-        else {
-            ast = { object, where: query };
-        }
-        if (ast.limit === undefined)
-            ast.limit = 100;
-        // Trigger Before Hook
-        const hookContext = {
-            object,
-            event: 'beforeFind',
-            input: { ast, options }, // Hooks can modify AST here
-            ql: this
-        };
-        await this.triggerHooks('beforeFind', hookContext);
-        try {
-            const result = await driver.find(object, hookContext.input.ast, hookContext.input.options);
-            // Trigger After Hook
-            hookContext.event = 'afterFind';
-            hookContext.result = result;
-            await this.triggerHooks('afterFind', hookContext);
-            return hookContext.result;
-        }
-        catch (e) {
-            // hookContext.error = e;
-            throw e;
-        }
-    }
-    async findOne(object, idOrQuery, options) {
-        const driver = this.getDriver(object);
-        let ast;
-        if (typeof idOrQuery === 'string') {
-            ast = {
-                object,
-                where: { _id: idOrQuery }
-            };
-        }
-        else {
-            // Assume query object
-            // reuse logic from find() or just wrap it
-            if (idOrQuery.where || idOrQuery.fields) {
-                ast = { object, ...idOrQuery };
-            }
-            else {
-                ast = { object, where: idOrQuery };
-            }
-        }
-        // Limit 1 for findOne
-        ast.limit = 1;
-        return driver.findOne(object, ast, options);
-    }
-    async insert(object, data, options) {
-        const driver = this.getDriver(object);
-        // 1. Get Schema
-        const schema = SchemaRegistry.getObject(object);
-        if (schema) {
-            // TODO: Validation Logic
-            // validate(schema, data);
-        }
-        // 2. Trigger Before Hook
-        const hookContext = {
-            object,
-            event: 'beforeInsert',
-            input: { data, options },
-            ql: this
-        };
-        await this.triggerHooks('beforeInsert', hookContext);
-        // 3. Execute Driver
-        const result = await driver.create(object, hookContext.input.data, hookContext.input.options);
-        // 4. Trigger After Hook
-        hookContext.event = 'afterInsert';
-        hookContext.result = result;
-        await this.triggerHooks('afterInsert', hookContext);
-        return hookContext.result;
-    }
-    async update(object, id, data, options) {
-        const driver = this.getDriver(object);
-        const hookContext = {
-            object,
-            event: 'beforeUpdate',
-            input: { id, data, options },
-            ql: this
-        };
-        await this.triggerHooks('beforeUpdate', hookContext);
-        const result = await driver.update(object, hookContext.input.id, hookContext.input.data, hookContext.input.options);
-        hookContext.event = 'afterUpdate';
-        hookContext.result = result;
-        await this.triggerHooks('afterUpdate', hookContext);
-        return hookContext.result;
-    }
-    async delete(object, id, options) {
-        const driver = this.getDriver(object);
-        const hookContext = {
-            object,
-            event: 'beforeDelete',
-            input: { id, options },
-            ql: this
-        };
-        await this.triggerHooks('beforeDelete', hookContext);
-        const result = await driver.delete(object, hookContext.input.id, hookContext.input.options);
-        hookContext.event = 'afterDelete';
-        hookContext.result = result;
-        await this.triggerHooks('afterDelete', hookContext);
-        return hookContext.result;
-    }
-}
+// Export Protocol Implementation
+export { ObjectStackProtocolImplementation } from './protocol';
+// Export Engine
+export { ObjectQL } from './engine';
+// Export Plugin Shim
+export { ObjectQLPlugin } from './plugin';
+// Moved logic to engine.ts

package/dist/plugin.d.ts

@@ -0,0 +1,14 @@
+import { ObjectQL } from './engine';
+import { Plugin, PluginContext } from '@objectstack/core';
+export type { Plugin, PluginContext };
+export declare class ObjectQLPlugin implements Plugin {
+    name: string;
+    type: "objectql";
+    version: string;
+    private ql;
+    private hostContext?;
+    constructor(ql?: ObjectQL, hostContext?: Record<string, any>);
+    init(ctx: PluginContext): Promise<void>;
+    start(ctx: PluginContext): Promise<void>;
+}
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAEpC,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAE1D,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC;AAEtC,qBAAa,cAAe,YAAW,MAAM;IAC3C,IAAI,SAAqC;IACzC,IAAI,EAAG,UAAU,CAAU;IAC3B,OAAO,SAAW;IAElB,OAAO,CAAC,EAAE,CAAuB;IACjC,OAAO,CAAC,WAAW,CAAC,CAAsB;gBAE9B,EAAE,CAAC,EAAE,QAAQ,EAAE,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAStD,IAAI,CAAC,GAAG,EAAE,aAAa;IAkBvB,KAAK,CAAC,GAAG,EAAE,aAAa;CAoB/B"}

package/dist/plugin.js

@@ -0,0 +1,54 @@
+import { ObjectQL } from './engine';
+import { ObjectStackProtocolImplementation } from './protocol';
+export class ObjectQLPlugin {
+    constructor(ql, hostContext) {
+        this.name = 'com.objectstack.engine.objectql';
+        this.type = 'objectql';
+        this.version = '1.0.0';
+        if (ql) {
+            this.ql = ql;
+        }
+        else {
+            this.hostContext = hostContext;
+            // Lazily created in init
+        }
+    }
+    async init(ctx) {
+        if (!this.ql) {
+            this.ql = new ObjectQL(this.hostContext);
+        }
+        ctx.registerService('objectql', this.ql);
+        if (ctx.logger)
+            ctx.logger.log(`[ObjectQLPlugin] ObjectQL engine registered as service`);
+        // Register Protocol Implementation
+        if (!this.ql) {
+            throw new Error('ObjectQL engine not initialized');
+        }
+        const protocolShim = new ObjectStackProtocolImplementation(this.ql);
+        ctx.registerService('protocol', protocolShim);
+        if (ctx.logger)
+            ctx.logger.log(`[ObjectQLPlugin] Protocol service registered`);
+    }
+    async start(ctx) {
+        if (ctx.logger)
+            ctx.logger.log(`[ObjectQLPlugin] ObjectQL engine initialized`);
+        // Discover features from Kernel Services
+        if (ctx.getServices && this.ql) {
+            const services = ctx.getServices();
+            for (const [name, service] of services.entries()) {
+                if (name.startsWith('driver.')) {
+                    // Register Driver
+                    this.ql.registerDriver(service);
+                    if (ctx.logger)
+                        ctx.logger.log(`[ObjectQLPlugin] Discovered and registered driver service: ${name}`);
+                }
+                if (name.startsWith('app.')) {
+                    // Register App
+                    this.ql.registerApp(service); // service is Manifest
+                    if (ctx.logger)
+                        ctx.logger.log(`[ObjectQLPlugin] Discovered and registered app service: ${name}`);
+                }
+            }
+        }
+    }
+}

package/dist/protocol.d.ts

@@ -0,0 +1,43 @@
+import { IObjectStackProtocol } from '@objectstack/spec/api';
+import { IDataEngine } from '@objectstack/core';
+export declare class ObjectStackProtocolImplementation implements IObjectStackProtocol {
+    private engine;
+    constructor(engine: IDataEngine);
+    getDiscovery(): {
+        name: string;
+        version: string;
+        capabilities: {
+            metadata: boolean;
+            data: boolean;
+            ui: boolean;
+        };
+    };
+    getMetaTypes(): string[];
+    getMetaItems(type: string): unknown[];
+    getMetaItem(type: string, name: string): unknown;
+    getUiView(object: string, type: 'list' | 'form'): {
+        type: string;
+        object: string;
+        columns: {
+            field: string;
+            label: string;
+        }[];
+        sections?: undefined;
+    } | {
+        type: string;
+        object: string;
+        sections: {
+            label: string;
+            fields: {
+                field: string;
+            }[];
+        }[];
+        columns?: undefined;
+    };
+    findData(object: string, query: any): Promise<any[]>;
+    getData(object: string, id: string): Promise<any>;
+    createData(object: string, data: any): Promise<any>;
+    updateData(object: string, id: string, data: any): Promise<any>;
+    deleteData(object: string, id: string): Promise<boolean>;
+}
+//# sourceMappingURL=protocol.d.ts.map

package/dist/protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAKhD,qBAAa,iCAAkC,YAAW,oBAAoB;IAC1E,OAAO,CAAC,MAAM,CAAc;gBAEhB,MAAM,EAAE,WAAW;IAI/B,YAAY;;;;;;;;;IAYZ,YAAY;IAIZ,YAAY,CAAC,IAAI,EAAE,MAAM;IAIzB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;IAItC,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM;;;;;;;;;;;;;;;;;;;IA6B/C,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG;IAI7B,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM;IAsBxC,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG;IAIpC,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG;IAIhD,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM;CAGxC"}

package/dist/protocol.js

@@ -0,0 +1,87 @@
+// We import SchemaRegistry directly since this class lives in the same package
+import { SchemaRegistry } from './registry';
+export class ObjectStackProtocolImplementation {
+    constructor(engine) {
+        this.engine = engine;
+    }
+    getDiscovery() {
+        return {
+            name: 'ObjectStack API',
+            version: '1.0',
+            capabilities: {
+                metadata: true,
+                data: true,
+                ui: true
+            }
+        };
+    }
+    getMetaTypes() {
+        return SchemaRegistry.getRegisteredTypes();
+    }
+    getMetaItems(type) {
+        return SchemaRegistry.listItems(type);
+    }
+    getMetaItem(type, name) {
+        return SchemaRegistry.getItem(type, name);
+    }
+    getUiView(object, type) {
+        const schema = SchemaRegistry.getObject(object);
+        if (!schema)
+            throw new Error(`Object ${object} not found`);
+        if (type === 'list') {
+            return {
+                type: 'list',
+                object: object,
+                columns: Object.keys(schema.fields || {}).slice(0, 5).map(f => ({
+                    field: f,
+                    label: schema.fields[f].label || f
+                }))
+            };
+        }
+        else {
+            return {
+                type: 'form',
+                object: object,
+                sections: [
+                    {
+                        label: 'General',
+                        fields: Object.keys(schema.fields || {}).map(f => ({
+                            field: f
+                        }))
+                    }
+                ]
+            };
+        }
+    }
+    findData(object, query) {
+        return this.engine.find(object, query);
+    }
+    async getData(object, id) {
+        // IDataEngine doesn't have findOne, so we simulate it with find and limit 1
+        // Assuming the ID field is named '_id' or 'id'. 
+        // For broad compatibility, we might need to know the ID field name.
+        // But traditionally it is _id in ObjectStack/mongo or id in others.
+        // Let's rely on finding by ID if the engine supports it via find?
+        // Actually, ObjectQL (the implementation) DOES have findOne.
+        // But we are programming against IDataEngine interface here.
+        // If the engine IS ObjectQL (which it practically is), we could cast it.
+        // But let's try to stick to interface.
+        const results = await this.engine.find(object, {
+            filter: { _id: id }, // Default Assumption: _id
+            limit: 1
+        });
+        if (results && results.length > 0) {
+            return results[0];
+        }
+        throw new Error(`Record ${id} not found in ${object}`);
+    }
+    createData(object, data) {
+        return this.engine.insert(object, data);
+    }
+    updateData(object, id, data) {
+        return this.engine.update(object, id, data);
+    }
+    deleteData(object, id) {
+        return this.engine.delete(object, id);
+    }
+}