Merge pull request #333 from objectstack-ai/copilot/replace-runtime-kernel-with-mini-kernel

Author: hotlong

examples/custom-objectql-example.ts

@@ -6,7 +6,7 @@
  * custom configuration.
  */
 
-import { ObjectStackKernel, ObjectQLPlugin, ObjectQL } from '@objectstack/runtime';
+import { ObjectKernel, ObjectQLPlugin, DriverPlugin, ObjectQL } from '@objectstack/runtime';
 import { InMemoryDriver } from '@objectstack/driver-memory';
 
 (async () => {
@@ -27,18 +27,22 @@ import { InMemoryDriver } from '@objectstack/driver-memory';
   });
 
   // Create kernel with the custom ObjectQL instance
-  const kernel = new ObjectStackKernel([
+  const kernel = new ObjectKernel();
+  
+  kernel
     // Register your custom ObjectQL instance
-    new ObjectQLPlugin(customQL),
+    .use(new ObjectQLPlugin(customQL))
 
     // Add your driver
-    new InMemoryDriver(),
+    .use(new DriverPlugin(new InMemoryDriver(), 'memory'));
 
     // Add other plugins and app configs as needed
-  ]);
 
-  await kernel.start();
+  await kernel.bootstrap();
 
   console.log('✅ Kernel started with custom ObjectQL instance');
-  console.log('ObjectQL instance:', kernel.ql);
+  
+  // Access ObjectQL via service registry
+  const objectql = kernel.getService('objectql');
+  console.log('ObjectQL instance:', objectql);
 })();

examples/host/debug-registry.ts

@@ -1,5 +1,5 @@
 
-import { ObjectStackKernel, ObjectQLPlugin } from '@objectstack/runtime';
+import { ObjectKernel, ObjectQLPlugin, DriverPlugin, AppManifestPlugin } from '@objectstack/runtime';
 import { SchemaRegistry, ObjectQL } from '@objectstack/objectql';
 import { InMemoryDriver } from '@objectstack/driver-memory';
 
@@ -10,13 +10,14 @@ import TodoApp from '@objectstack/example-todo/objectstack.config';
     console.log('Apps:', [TodoApp.name]);
     console.log('Objects inside App:', TodoApp.objects?.map((o: any) => o.name));
 
-    const kernel = new ObjectStackKernel([
-        new ObjectQLPlugin(),
-        TodoApp,
-        new InMemoryDriver()
-    ]);
+    const kernel = new ObjectKernel();
 
-    await kernel.start();
+    kernel
+        .use(new ObjectQLPlugin())
+        .use(new DriverPlugin(new InMemoryDriver(), 'memory'))
+        .use(new AppManifestPlugin(TodoApp));
+    
+    await kernel.bootstrap();
 
     console.log('--- Post Start ---');
 

examples/host/src/index.ts

@@ -1,4 +1,4 @@
-import { ObjectStackKernel, ObjectQLPlugin, ObjectQL } from '@objectstack/runtime';
+import { ObjectKernel, ObjectQLPlugin, DriverPlugin, AppManifestPlugin, ObjectQL } from '@objectstack/runtime';
 import { InMemoryDriver } from '@objectstack/driver-memory';
 import { HonoServerPlugin } from '@objectstack/plugin-hono-server';
 
@@ -9,32 +9,26 @@ import BiPluginManifest from '@objectstack/plugin-bi/objectstack.config';
 (async () => {
   console.log('🚀 Booting Kernel...');
 
-  // Option 1: Use default ObjectQL via plugin (recommended)
-  const kernel = new ObjectStackKernel([
-      // Register ObjectQL engine explicitly via plugin
-      new ObjectQLPlugin(),
-      
-      // App manifests
-      CrmApp, 
-      TodoApp, 
-      BiPluginManifest,
+  // Use MiniKernel architecture
+  const kernel = new ObjectKernel();
+  
+  kernel
+      // Register ObjectQL engine
+      .use(new ObjectQLPlugin())
 
       // Database driver
-      new InMemoryDriver(),
+      .use(new DriverPlugin(new InMemoryDriver(), 'memory'))
+      
+      // App manifests
+      .use(new AppManifestPlugin(CrmApp))
+      .use(new AppManifestPlugin(TodoApp))
+      .use(new AppManifestPlugin(BiPluginManifest))
 
       // Load the Hono Server Plugin
-      new HonoServerPlugin({ 
+      .use(new HonoServerPlugin({ 
         port: 3004, 
         staticRoot: './public' 
-      }) 
-  ]);
-
-  // Option 2: Use custom ObjectQL instance
-  // const customQL = new ObjectQL({ env: 'production', customConfig: true });
-  // const kernel = new ObjectStackKernel([
-  //     new ObjectQLPlugin(customQL),
-  //     ...other plugins
-  // ]);
+      }));
 
-  await kernel.start();
+  await kernel.bootstrap();
 })();

examples/msw-react-crud/src/mocks/browser.ts

@@ -5,13 +5,13 @@
  * and the MSW Plugin which automatically exposes the API.
  */
 
-import { ObjectStackKernel, ObjectQLPlugin } from '@objectstack/runtime';
+import { ObjectKernel, ObjectQLPlugin, DriverPlugin, AppManifestPlugin } from '@objectstack/runtime';
 import { InMemoryDriver } from '@objectstack/driver-memory';
 import { MSWPlugin } from '@objectstack/plugin-msw';
 // import appConfig from '../../objectstack.config';
 import todoConfig from '@objectstack/example-todo/objectstack.config';
 
-let kernel: ObjectStackKernel | null = null;
+let kernel: ObjectKernel | null = null;
 
 export async function startMockServer() {
   if (kernel) return;
@@ -20,28 +20,27 @@ export async function startMockServer() {
 
   const driver = new InMemoryDriver();
 
-  // Define Seed Data using the Dataset Protocol
-  // We use the data defined in the Todo App config
+  // Create kernel with MiniKernel architecture
+  kernel = new ObjectKernel();
 
-  kernel = new ObjectStackKernel([
-    // Register ObjectQL engine explicitly
-    new ObjectQLPlugin(),
+  kernel
+    // Register ObjectQL engine
+    .use(new ObjectQLPlugin())
 
-    // Todo App Config (contains objects and data)
-    todoConfig,
+    // Register the driver
+    .use(new DriverPlugin(driver, 'memory'))
 
-    // In-Memory Database (runs in browser)
-    driver,
+    // Load todo app config as a plugin
+    .use(new AppManifestPlugin(todoConfig))
 
     // MSW Plugin (intercepts network requests)
-    new MSWPlugin({
+    .use(new MSWPlugin({
       enableBrowser: true,
       baseUrl: '/api/v1',
       logRequests: true
-    })
-  ]);
-
-  await kernel.start();
+    }));
+  
+  await kernel.bootstrap();
 
   return kernel;
 }

packages/plugin-msw/src/msw-plugin.ts

@@ -1,6 +1,13 @@
 import { http, HttpResponse } from 'msw';
 import { setupWorker } from 'msw/browser';
-import { RuntimePlugin, RuntimeContext, ObjectStackRuntimeProtocol } from '@objectstack/runtime';
+import { 
+    RuntimePlugin, 
+    RuntimeContext, 
+    Plugin, 
+    PluginContext, 
+    ObjectStackRuntimeProtocol,
+    ObjectKernel 
+} from '@objectstack/runtime';
 
 export interface MSWPluginOptions {
     /**
@@ -149,10 +156,20 @@ export class ObjectStackServer {
  * This plugin enables Mock Service Worker integration for testing and development.
  * It automatically mocks API endpoints using the ObjectStack runtime protocol.
  * 
+ * Supports both legacy RuntimePlugin and new Plugin interfaces.
+ * 
  * @example
  * ```typescript
  * import { MSWPlugin } from '@objectstack/plugin-msw';
  * 
+ * // With new ObjectKernel
+ * const kernel = new ObjectKernel();
+ * kernel.use(new MSWPlugin({
+ *   enableBrowser: true,
+ *   baseUrl: '/api/v1'
+ * }));
+ * 
+ * // With legacy ObjectStackKernel
  * const runtime = new ObjectStackRuntime({
  *   plugins: [
  *     new MSWPlugin({
@@ -163,11 +180,14 @@ export class ObjectStackServer {
  * });
  * ```
  */
-export class MSWPlugin implements RuntimePlugin {
-    name = 'msw';
+export class MSWPlugin implements Plugin, RuntimePlugin {
+    name = 'com.objectstack.plugin.msw';
+    version = '1.0.0';
+    
     private options: MSWPluginOptions;
     private worker: any;
     private handlers: Array<any> = [];
+    private protocol?: ObjectStackRuntimeProtocol;
 
     constructor(options: MSWPluginOptions = {}) {
         this.options = {
@@ -178,9 +198,69 @@ export class MSWPlugin implements RuntimePlugin {
         };
     }
 
+    /**
+     * New Plugin interface - init phase
+     */
+    async init(ctx: PluginContext) {
+        // Protocol will be created in start phase
+        ctx.logger.log('[MSWPlugin] Initialized');
+    }
+
+    /**
+     * New Plugin interface - start phase
+     */
+    async start(ctx: PluginContext) {
+        // Get the kernel and create protocol
+        if (ctx.getKernel) {
+            const kernel = ctx.getKernel();
+            this.protocol = new ObjectStackRuntimeProtocol(kernel);
+        } else {
+            throw new Error('[MSWPlugin] Cannot access kernel from context - getKernel() not available');
+        }
+        
+        this.setupHandlers();
+        await this.startWorker();
+    }
+
+    /**
+     * New Plugin interface - destroy phase
+     */
+    async destroy() {
+        await this.stopWorker();
+    }
+
+    /**
+     * Legacy RuntimePlugin interface - install
+     */
     install(ctx: RuntimeContext) {
         const { engine } = ctx;
-        const protocol = new ObjectStackRuntimeProtocol(engine);
+        this.protocol = new ObjectStackRuntimeProtocol(engine);
+        this.setupHandlers();
+    }
+
+    /**
+     * Legacy RuntimePlugin interface - onStart
+     */
+    async onStart(ctx: RuntimeContext) {
+        await this.startWorker();
+    }
+
+    /**
+     * Legacy RuntimePlugin interface - onStop
+     */
+    async onStop() {
+        await this.stopWorker();
+    }
+
+    /**
+     * Setup MSW handlers
+     */
+    private setupHandlers() {
+        if (!this.protocol) {
+            throw new Error('[MSWPlugin] Protocol not initialized');
+        }
+
+        const protocol = this.protocol;
 
         // Initialize ObjectStackServer
         ObjectStackServer.init(
@@ -312,7 +392,10 @@ export class MSWPlugin implements RuntimePlugin {
         console.log(`[MSWPlugin] Installed ${this.handlers.length} request handlers.`);
     }
 
-    async onStart(ctx: RuntimeContext) {
+    /**
+     * Start the MSW worker
+     */
+    private async startWorker() {
         if (this.options.enableBrowser && typeof window !== 'undefined') {
             // Browser environment
             this.worker = setupWorker(...this.handlers);
@@ -325,7 +408,10 @@ export class MSWPlugin implements RuntimePlugin {
         }
     }
 
-    async onStop() {
+    /**
+     * Stop the MSW worker
+     */
+    private async stopWorker() {
         if (this.worker) {
             this.worker.stop();
             console.log(`[MSWPlugin] Stopped MSW worker.`);