@objectql/core 4.0.4 → 4.0.6

package/dist/protocol.js

@@ -0,0 +1,260 @@
+"use strict";
+/**
+ * ObjectStack Protocol Implementation
+ * Copyright (c) 2026-present ObjectStack Inc.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ObjectStackProtocolImplementation = void 0;
+/**
+ * Bridges the ObjectStack Protocol (Specification) to the ObjectQL Engine (Implementation)
+ */
+class ObjectStackProtocolImplementation {
+    constructor(engine) {
+        this.engine = engine;
+    }
+    /**
+     * Get API Discovery Document
+     */
+    async getDiscovery(args) {
+        return {
+            name: 'ObjectQL Engine',
+            version: '4.0.0',
+            protocols: ['rest', 'graphql', 'json-rpc', 'odata'],
+            auth: {
+                type: 'bearer',
+                url: '/auth/token'
+            }
+        };
+    }
+    /**
+     * Get Metadata Types (e.g., ['object', 'action'])
+     */
+    async getMetaTypes(args) {
+        let types = ['object'];
+        if (this.engine.metadata && typeof this.engine.metadata.getTypes === 'function') {
+            types = this.engine.metadata.getTypes();
+        }
+        return { types };
+    }
+    /**
+     * Get Metadata Items for a Type
+     */
+    async getMetaItems(args) {
+        const { type } = args;
+        let items = [];
+        if (this.engine.metadata && typeof this.engine.metadata.list === 'function') {
+            items = this.engine.metadata.list(type);
+        }
+        return { type, items };
+    }
+    /**
+     * Get Metadata Item
+     */
+    async getMetaItem(args) {
+        const { type, name } = args;
+        if (this.engine.metadata && typeof this.engine.metadata.get === 'function') {
+            return this.engine.metadata.get(type, name);
+        }
+        return null;
+    }
+    /**
+     * Get Cached Metadata Item
+     */
+    async getMetaItemCached(args) {
+        // Fallback to non-cached version for now
+        return this.getMetaItem(args);
+    }
+    /**
+     * Get UI View
+     */
+    async getUiView(args) {
+        return null;
+    }
+    /**
+     * Find Data Records
+     */
+    async findData(args) {
+        const { object, query } = args;
+        // Use direct kernel method if available (preferred)
+        if (typeof this.engine.find === 'function') {
+            const result = await this.engine.find(object, query || {});
+            return result;
+        }
+        // Fallback to createContext (if engine is IObjectQL)
+        if (typeof this.engine.createContext === 'function') {
+            const ctx = this.engine.createContext({ isSystem: true });
+            try {
+                const repo = ctx.object(object);
+                return await repo.find(query || {});
+            }
+            catch (error) {
+                throw new Error(`Data access failed: ${error.message}`);
+            }
+        }
+        throw new Error('Engine does not support find operation');
+    }
+    /**
+     * Count Data Records
+     */
+    async countData(args) {
+        const { object, query } = args;
+        // Basic fallback
+        const result = await this.findData(args);
+        return Array.isArray(result) ? result.length : (result.value ? result.value.length : 0);
+    }
+    /**
+     * Get Single Data Record
+     */
+    async getData(args) {
+        const { object, id } = args;
+        if (typeof this.engine.get === 'function') {
+            return await this.engine.get(object, id);
+        }
+        if (typeof this.engine.createContext === 'function') {
+            const ctx = this.engine.createContext({ isSystem: true });
+            try {
+                const repo = ctx.object(object);
+                return await repo.findOne(id);
+            }
+            catch (error) {
+                throw new Error(`Data retrieval failed: ${error.message}`);
+            }
+        }
+        throw new Error('Engine does not support get operation');
+    }
+    /**
+     * Create Data Record
+     */
+    async createData(args) {
+        const { object, data } = args;
+        if (typeof this.engine.create === 'function') {
+            return await this.engine.create(object, data);
+        }
+        if (typeof this.engine.createContext === 'function') {
+            const ctx = this.engine.createContext({ isSystem: true });
+            try {
+                const repo = ctx.object(object);
+                // Protocol expects returned data
+                return await repo.create(data);
+            }
+            catch (error) {
+                throw new Error(`Data creation failed: ${error.message}`);
+            }
+        }
+        throw new Error('Engine does not support create operation');
+    }
+    /**
+     * Update Data Record
+     */
+    async updateData(args) {
+        const { object, id, data } = args;
+        if (typeof this.engine.update === 'function') {
+            return await this.engine.update(object, id, data);
+        }
+        if (typeof this.engine.createContext === 'function') {
+            const ctx = this.engine.createContext({ isSystem: true });
+            try {
+                const repo = ctx.object(object);
+                return await repo.update(id, data);
+            }
+            catch (error) {
+                throw new Error(`Data update failed: ${error.message}`);
+            }
+        }
+        throw new Error('Engine does not support update operation');
+    }
+    /**
+     * Delete Data Record
+     */
+    async deleteData(args) {
+        const { object, id } = args;
+        if (typeof this.engine.delete === 'function') {
+            const success = await this.engine.delete(object, id);
+            return { object, id, success: !!success };
+        }
+        if (typeof this.engine.createContext === 'function') {
+            const ctx = this.engine.createContext({ isSystem: true });
+            try {
+                const repo = ctx.object(object);
+                await repo.delete(id);
+                return { object, id, success: true };
+            }
+            catch (error) {
+                throw new Error(`Data deletion failed: ${error.message}`);
+            }
+        }
+        throw new Error('Engine does not support delete operation');
+    }
+    /**
+     * Create Many Data Records
+     */
+    async createManyData(args) {
+        throw new Error('createManyData not implemented');
+    }
+    /**
+     * Update Many Data Records
+     */
+    async updateManyData(args) {
+        throw new Error('updateManyData not implemented');
+    }
+    /**
+     * Delete Many Data Records
+     */
+    async deleteManyData(args) {
+        throw new Error('deleteManyData not implemented');
+    }
+    /**
+     * Batch Operations
+     */
+    async batchData(args) {
+        throw new Error('batchData not implemented');
+    }
+    /**
+     * Execute Action/Operation
+     */
+    async performAction(args) {
+        // Not implemented in this shim yet
+        throw new Error('Action execution not implemented in protocol shim');
+    }
+    /**
+     * Analytics Query - Execute analytics query
+     */
+    async analyticsQuery(args) {
+        throw new Error('analyticsQuery not implemented');
+    }
+    /**
+     * Get Analytics Metadata
+     */
+    async getAnalyticsMeta(args) {
+        throw new Error('getAnalyticsMeta not implemented');
+    }
+    /**
+     * Trigger Automation
+     */
+    async triggerAutomation(args) {
+        throw new Error('triggerAutomation not implemented');
+    }
+    /**
+     * List Spaces (Hub/Workspace Management)
+     */
+    async listSpaces(args) {
+        throw new Error('listSpaces not implemented');
+    }
+    /**
+     * Create Space (Hub/Workspace Management)
+     */
+    async createSpace(args) {
+        throw new Error('createSpace not implemented');
+    }
+    /**
+     * Install Plugin (Hub/Extension Management)
+     */
+    async installPlugin(args) {
+        throw new Error('installPlugin not implemented');
+    }
+}
+exports.ObjectStackProtocolImplementation = ObjectStackProtocolImplementation;
+//# sourceMappingURL=protocol.js.map

package/dist/protocol.js.map

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

package/jest.config.js

@@ -12,6 +12,9 @@ module.exports = {
   testMatch: ['**/test/**/*.test.ts'],
   moduleNameMapper: {
     '^@objectql/(.*)$': '<rootDir>/../$1/src',
+    '^@objectstack/core$': '<rootDir>/test/__mocks__/@objectstack/core.ts',
+    '^@objectstack/objectql$': '<rootDir>/test/__mocks__/@objectstack/objectql.ts',
+    '^@objectstack/runtime$': '<rootDir>/test/__mocks__/@objectstack/runtime.ts',
   },
   transform: {
     '^.+\\.(t|j)sx?$': ['ts-jest', {
@@ -23,7 +26,4 @@ module.exports = {
       }
     }],
   },
-  transformIgnorePatterns: [
-    "/node_modules/(?!(@objectstack|.pnpm))"
-  ],
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@objectql/core",
-  "version": "4.0.4",
+  "version": "4.0.6",
   "description": "Universal runtime engine for ObjectQL - AI-native metadata-driven ORM with validation, repository pattern, and driver orchestration",
   "keywords": [
     "objectql",
@@ -18,14 +18,14 @@
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "dependencies": {
-    "@objectstack/spec": "^0.8.0",
-    "@objectstack/runtime": "^0.8.0",
-    "@objectstack/objectql": "^0.8.0",
-    "@objectstack/core": "^0.8.0",
+    "@objectstack/core": "^1.0.0",
+    "@objectstack/objectql": "^1.0.0",
+    "@objectstack/runtime": "^1.0.0",
+    "@objectstack/spec": "^1.0.0",
     "js-yaml": "^4.1.0",
-    "@objectql/types": "4.0.3",
-    "@objectql/plugin-formula": "4.0.3",
-    "@objectql/plugin-validator": "4.0.3"
+    "@objectql/plugin-formula": "4.0.6",
+    "@objectql/plugin-validator": "4.0.6",
+    "@objectql/types": "4.0.6"
   },
   "devDependencies": {
     "@types/js-yaml": "^4.0.5",

package/src/app.ts

@@ -110,18 +110,24 @@ export class ObjectQL implements IObjectQL {
                 return items.map(unwrapContent);
             },
             unregister: (type: string, name: string) => {
-                 // Access private static storage using any cast
-                 const metadata = (SchemaRegistry as any).metadata;
-                 if (metadata instanceof Map) {
-                     const collection = metadata.get(type);
-                     if (collection instanceof Map) {
-                         collection.delete(name);
+                 // Use the official unregisterItem API when available (added in @objectstack/objectql v0.9.2)
+                 // Fallback to direct metadata access for older versions or test mocks
+                 if (typeof SchemaRegistry.unregisterItem === 'function') {
+                     SchemaRegistry.unregisterItem(type, name);
+                 } else {
+                     // Fallback: try to access metadata Map directly
+                     const metadata = (SchemaRegistry as any).metadata;
+                     if (metadata && metadata instanceof Map) {
+                         const collection = metadata.get(type);
+                         if (collection && collection instanceof Map) {
+                             collection.delete(name);
+                         }
                      }
                  }
             },
             unregisterPackage: (packageName: string) => {
                  const metadata = (SchemaRegistry as any).metadata;
-                 if (metadata instanceof Map) {
+                 if (metadata && metadata instanceof Map) {
                      for (const [type, collection] of metadata.entries()) {
                          if (collection instanceof Map) {
                              for (const [key, item] of collection.entries()) {
@@ -395,6 +401,21 @@ export class ObjectQL implements IObjectQL {
             await (this.kernel as any).bootstrap();
         } else {
              console.warn('ObjectKernel does not have start() or bootstrap() method');
+             
+             // Manually initialize plugins if kernel doesn't support lifecycle
+             for (const plugin of this.kernelPlugins) {
+                 try {
+                     if (typeof (plugin as any).init === 'function') {
+                         await (plugin as any).init();
+                     }
+                     if (typeof (plugin as any).start === 'function') {
+                         await (plugin as any).start();
+                     }
+                 } catch (error) {
+                     console.error(`Failed to initialize plugin ${(plugin as any).name || 'unknown'}:`, error);
+                     // Continue with other plugins even if one fails
+                 }
+             }
         }
         
         // TEMPORARY: Set driver for backward compatibility during migration

package/src/gateway.ts

@@ -0,0 +1,101 @@
+/**
+ * ObjectQL
+ * Copyright (c) 2026-present ObjectStack Inc.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+import { ApiRequest, ApiResponse, GatewayProtocol } from '@objectql/types';
+
+export type RequestTransformer = (request: ApiRequest) => Promise<ApiRequest>;
+export type ResponseTransformer = (response: ApiResponse) => Promise<ApiResponse>;
+
+/**
+ * Unified API Gateway
+ * Routtes generic API requests to specific protocol implementations
+ */
+export class ObjectGateway {
+    private protocols: GatewayProtocol[] = [];
+    private requestTransforms: RequestTransformer[] = [];
+    private responseTransforms: ResponseTransformer[] = [];
+
+    constructor(protocols: GatewayProtocol[] = []) {
+        this.protocols = protocols;
+    }
+
+    /**
+     * Register a new protocol handler
+     */
+    registerProtocol(protocol: GatewayProtocol) {
+        this.protocols.push(protocol);
+    }
+    
+    /**
+     * Add a request transformer (middleware)
+     */
+    addRequestTransform(transformer: RequestTransformer) {
+        this.requestTransforms.push(transformer);
+    }
+
+    /**
+     * Add a response transformer (middleware)
+     */
+    addResponseTransform(transformer: ResponseTransformer) {
+        this.responseTransforms.push(transformer);
+    }
+
+    /**
+     * Handle an incoming API request
+     */
+    async handle(request: ApiRequest): Promise<ApiResponse> {
+        let req = request;
+
+        // 1. Apply Request Transforms
+        for (const transform of this.requestTransforms) {
+            req = await transform(req);
+        }
+
+        // 2. Find matching protocol
+        const protocol = this.protocols.find(p => p.route(req));
+
+        if (!protocol) {
+            return {
+                status: 404,
+                headers: { 'Content-Type': 'application/json' },
+                body: {
+                    error: {
+                        code: 'PROTOCOL_NOT_FOUND',
+                        message: `No protocol found to handle path: ${req.path}`
+                    }
+                }
+            };
+        }
+
+        let response: ApiResponse;
+
+        // 3. Delegate to protocol
+        try {
+            response = await protocol.handle(req);
+        } catch (error: any) {
+            console.error(`[ObjectGateway] Error in ${protocol.name}:`, error);
+            response = {
+                status: 500,
+                headers: { 'Content-Type': 'application/json' },
+                body: {
+                    error: {
+                        code: 'INTERNAL_ERROR',
+                        message: error.message || 'Internal Gateway Error'
+                    }
+                }
+            };
+        }
+
+        // 4. Apply Response Transforms
+        for (const transform of this.responseTransforms) {
+            response = await transform(response);
+        }
+
+        return response;
+    }
+}

package/src/index.ts

@@ -19,6 +19,8 @@ export type QueryAST = Data.QueryAST;
 export type DriverInterface = Data.DriverInterface;
 export type DriverOptions = Data.DriverOptions;
 
+export * from './gateway';
+
 // Export our enhanced runtime components (actual implementations)
 export * from './repository';
 export * from './app';

package/src/plugin.ts

@@ -11,6 +11,7 @@ import { ValidatorPlugin, ValidatorPluginConfig } from '@objectql/plugin-validat
 import { FormulaPlugin, FormulaPluginConfig } from '@objectql/plugin-formula';
 import { QueryService } from './query/query-service';
 import { QueryAnalyzer } from './query/query-analyzer';
+import { ObjectStackProtocolImplementation } from './protocol';
 import type { Driver } from '@objectql/types';
 
 /**
@@ -190,6 +191,15 @@ export class ObjectQLPlugin implements RuntimePlugin {
           engine: kernel,
           getKernel: () => kernel
       };
+
+      // Register Protocol Service
+      // If kernel supports service registration (PluginContext or ExtendedKernel with custom registry)
+      if (kernel && typeof kernel.registerService === 'function') {
+          console.log(`[${this.name}] Registering protocol service...`);
+          const protocolShim = new ObjectStackProtocolImplementation(kernel as any);
+          kernel.registerService('protocol', protocolShim);
+      }
+
       return this.install(ctx);
   }