Add core package and refactor imports across runtime modules

Author: hotlong

packages/core/package.json

@@ -0,0 +1,14 @@
+{
+  "name": "@objectstack/core",
+  "version": "0.4.2",
+  "description": "Microkernel Core for ObjectStack",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc"
+  },
+  "devDependencies": {
+    "typescript": "^5.0.0"
+  }
+}

packages/core/src/index.ts

@@ -0,0 +1,2 @@
+export * from './kernel.js';
+export * from './types.js';

packages/runtime/src/mini-kernel.ts packages/core/src/kernel.tspackages/runtime/src/mini-kernel.ts renamed to packages/core/src/kernel.ts

@@ -1,5 +1,4 @@
 import { Plugin, PluginContext } from './types.js';
-import { SchemaRegistry, ObjectQL } from '@objectstack/objectql';
 
 /**
  * ObjectKernel - MiniKernel Architecture

packages/runtime/src/types.ts packages/core/src/types.tspackages/runtime/src/types.ts renamed to packages/core/src/types.ts

@@ -1,4 +1,4 @@
-import { ObjectKernel } from './mini-kernel.js';
+import { ObjectKernel } from './kernel.js';
 
 /**
  * PluginContext - Runtime context available to plugins
@@ -48,56 +48,48 @@ export interface PluginContext {
      * Get the kernel instance (for advanced use cases)
      * @returns Kernel instance
      */
-    getKernel?(): ObjectKernel;
+    getKernel(): ObjectKernel;
 }
 
 /**
- * Plugin - Standard plugin interface
+ * Plugin Interface
  * 
- * Plugins are independent modules with standard lifecycle hooks.
- * They can declare dependencies on other plugins and register services.
+ * All ObjectStack plugins must implement this interface.
  */
 export interface Plugin {
     /**
-     * Plugin name (unique identifier)
+     * Unique plugin name (e.g., 'com.objectstack.engine.objectql')
      */
     name: string;
 
     /**
-     * Plugin version (optional)
+     * Plugin version
      */
     version?: string;
 
     /**
-     * Plugin type (optional, for special plugins like 'objectql')
-     */
-    type?: string;
-
-    /**
-     * Dependencies - list of plugin names this plugin depends on
-     * Kernel will ensure dependencies are initialized first
+     * List of other plugin names that this plugin depends on.
+     * The kernel ensures these plugins are initialized before this one.
      */
     dependencies?: string[];
 
     /**
-     * Init phase - Register services and prepare plugin
-     * Called during kernel bootstrap, before start phase
-     * 
-     * @param ctx - Plugin context
+     * Init Phase: Register services
+     * Called when kernel is initializing.
+     * Use this to register services that other plugins might need.
      */
-    init(ctx: PluginContext): Promise<void>;
+    init(ctx: PluginContext): Promise<void> | void;
 
     /**
-     * Start phase - Execute business logic, start servers, connect to databases
-     * Called after all plugins have been initialized
-     * 
-     * @param ctx - Plugin context
+     * Start Phase: Execute business logic
+     * Called after all plugins have been initialized.
+     * Use this to start servers, connect to DBs, or execute main logic.
      */
-    start?(ctx: PluginContext): Promise<void>;
+    start?(ctx: PluginContext): Promise<void> | void;
 
     /**
-     * Destroy phase - Cleanup resources, close connections
-     * Called during kernel shutdown
+     * Destroy Phase: Cleanup
+     * Called when kernel is shutting down.
      */
-    destroy?(): Promise<void>;
+    destroy?(): Promise<void> | void;
 }

packages/core/tsconfig.json

@@ -0,0 +1,9 @@
+{
+  "extends": "../../tsconfig.json",
+  "compilerOptions": {
+    "outDir": "./dist",
+    "rootDir": "./src"
+  },
+  "include": ["src/**/*"],
+  "exclude": [] 
+}

packages/runtime/package.json

@@ -10,6 +10,7 @@
     "dev": "tsc -w"
   },
   "dependencies": {
+    "@objectstack/core": "workspace:*",
     "@objectstack/objectql": "workspace:*",
     "@objectstack/types": "workspace:*",
     "@objectstack/spec": "workspace:*"

packages/runtime/src/app-manifest-plugin.ts

@@ -1,4 +1,4 @@
-import { Plugin, PluginContext } from './types.js';
+import { Plugin, PluginContext } from '@objectstack/core';
 import { SchemaRegistry, ObjectQL } from '@objectstack/objectql';
 
 /**

packages/runtime/src/driver-plugin.ts

@@ -1,4 +1,4 @@
-import { Plugin, PluginContext } from './types.js';
+import { Plugin, PluginContext } from '@objectstack/core';
 
 /**
  * Driver Plugin

packages/runtime/src/index.ts

@@ -2,7 +2,7 @@
 export { ObjectQL, SchemaRegistry } from '@objectstack/objectql';
 
 // Export Kernels
-export { ObjectKernel } from './mini-kernel.js';
+export { ObjectKernel } from '@objectstack/core';
 
 // Export Plugins
 export { ObjectQLPlugin } from '@objectstack/objectql';
@@ -13,7 +13,7 @@ export { AppManifestPlugin } from './app-manifest-plugin.js';
 export { ObjectStackRuntimeProtocol } from './protocol.js';
 
 // Export Types
-export * from './types.js';
+export * from '@objectstack/core';
 
 // Export Interfaces (Capability Contracts)
 export * from './interfaces/http-server.js';

packages/runtime/src/protocol.ts

@@ -1,5 +1,5 @@
 import { SchemaRegistry, ObjectQL } from '@objectstack/objectql';
-import { ObjectKernel } from './mini-kernel.js';
+import { ObjectKernel } from '@objectstack/core';
 
 export interface ApiRequest {
     params: Record<string, string>;