Refactor driver and plugin imports; migrate to @objectstack/core and remove deprecated JSON schemas

Author: hotlong

content/docs/developers/server-drivers.mdx

@@ -76,8 +76,8 @@ my-custom-db/
 
 ```typescript
 // src/driver.ts
+import { DriverInterface } from '@objectstack/core';
 import {
-  DriverInterface,
   DriverOptions,
   DriverCapabilities,
 } from '@objectstack/spec';
@@ -560,7 +560,8 @@ Complete implementation of a simple in-memory driver:
 
 ```typescript
 // src/memory-driver.ts
-import { DriverInterface, DriverCapabilities } from '@objectstack/spec';
+import { DriverInterface } from '@objectstack/core';
+import { DriverCapabilities } from '@objectstack/spec';
 import { Query, QueryResult } from '@objectstack/objectql';
 
 export class InMemoryDriver implements DriverInterface {
@@ -793,7 +794,7 @@ export class InMemoryDriver implements DriverInterface {
 ```typescript
 // src/postgres-driver.ts
 import { Pool } from 'pg';
-import { DriverInterface } from '@objectstack/spec';
+import { DriverInterface } from '@objectstack/core';
 import { Query } from '@objectstack/objectql';
 
 export class PostgresDriver implements DriverInterface {

content/docs/developers/writing-plugins.mdx

@@ -133,21 +133,32 @@ export default defineManifest({
 
 ```typescript
 // src/index.ts
-import { PluginContext } from '@objectstack/spec';
+import { Plugin } from '@objectstack/core';
 import { Account } from './objects/account.object';
 import { registerWebhooks } from './routes/webhooks';
 import { startSyncJob } from './jobs/sync';
 
-export default {
+const myPlugin: Plugin = {
+  name: 'my-crm-plugin',
+  version: '1.0.0',
+  
   /**
    * Called when the plugin is enabled.
    * Register objects, routes, jobs, and event listeners here.
    */
-  onEnable: async (context: PluginContext) => {
-    const { ql, os, logger, router, scheduler, storage } = context;
+  init: async (context) => {
+    // context comes from @objectstack/core
+    const { logger } = context;
 
     logger.info('My CRM Plugin enabled');
 
+    /* 
+       Note: Accessing services like 'ql' or 'router' depends on 
+       what plugins are installed in the kernel.
+       const ql = context.getService('objectql');
+    */
+  },
+    
     // Register custom objects
     await ql.registerObject(Account);
 
@@ -343,7 +354,7 @@ Add custom HTTP endpoints for webhooks, integrations, or custom APIs:
 
 ```typescript
 // src/routes/webhooks.ts
-import { Router } from '@objectstack/spec';
+import { IHttpServer } from '@objectstack/core';
 import { z } from 'zod';
 
 const WebhookPayloadSchema = z.object({
@@ -352,13 +363,13 @@ const WebhookPayloadSchema = z.object({
   timestamp: z.string(),
 });
 
-export function registerWebhooks(router: Router) {
+export function registerWebhooks(server: IHttpServer) {
 
   // ============================================================================
   // POST /api/webhooks/account
   // ============================================================================
 
-  router.post('/api/webhooks/account', async (req, res) => {
+  server.post('/api/webhooks/account', async (req, res) => {
     try {
       // Validate webhook payload
       const payload = WebhookPayloadSchema.parse(req.body);
@@ -385,7 +396,7 @@ export function registerWebhooks(router: Router) {
   // GET /api/integrations/sync
   // ============================================================================
 
-  router.get('/api/integrations/sync', async (req, res) => {
+  server.get('/api/integrations/sync', async (req, res) => {
     const { ql, logger } = req.context;
 
     try {
@@ -439,7 +450,7 @@ Run tasks periodically using cron expressions:
 
 ```typescript
 // src/jobs/sync.ts
-import { PluginContext } from '@objectstack/spec';
+import { PluginContext } from '@objectstack/core';
 
 export async function startSyncJob(context: PluginContext) {
   const { ql, os, logger, storage } = context;
@@ -506,7 +517,7 @@ React to data changes in real-time:
 
 ```typescript
 // src/events/account-created.ts
-import { PluginContext } from '@objectstack/spec';
+import { PluginContext } from '@objectstack/core';
 
 export function registerEventListeners(context: PluginContext) {
   const { ql, logger } = context;

content/docs/references/system/data-engine.mdx

@@ -12,26 +12,15 @@ description: Data Engine protocol schemas
 ## TypeScript Usage
 
 ```typescript
-import { DataEngineSchema, DataEngineFilterSchema, DataEngineQueryOptionsSchema } from '@objectstack/spec/system';
-import type { DataEngine, DataEngineFilter, DataEngineQueryOptions } from '@objectstack/spec/system';
+import { DataEngineFilterSchema, DataEngineQueryOptionsSchema } from '@objectstack/spec/system';
+import type { DataEngineFilter, DataEngineQueryOptions } from '@objectstack/spec/system';
 
 // Validate data
-const result = DataEngineSchema.parse(data);
+const result = DataEngineFilterSchema.parse(data);
 ```
 
 ---
 
-## DataEngine
-
-Data Engine Interface
-
-### Properties
-
-| Property | Type | Required | Description |
-| :--- | :--- | :--- | :--- |
-
----
-
 ## DataEngineFilter
 
 Data Engine query filter conditions

content/docs/references/system/index.mdx

@@ -18,7 +18,6 @@ This section contains all protocol schemas for the system layer of ObjectStack.
   <Card href="./job" title="Job" description="Source: packages/spec/src/system/job.zod.ts" />
   <Card href="./logger" title="Logger" description="Source: packages/spec/src/system/logger.zod.ts" />
   <Card href="./manifest" title="Manifest" description="Source: packages/spec/src/system/manifest.zod.ts" />
-  <Card href="./plugin" title="Plugin" description="Source: packages/spec/src/system/plugin.zod.ts" />
   <Card href="./scoped-storage" title="Scoped Storage" description="Source: packages/spec/src/system/scoped-storage.zod.ts" />
   <Card href="./translation" title="Translation" description="Source: packages/spec/src/system/translation.zod.ts" />
 </Cards>

content/docs/references/system/meta.json

@@ -11,7 +11,6 @@
     "job",
     "logger",
     "manifest",
-    "plugin",
     "scoped-storage",
     "translation"
   ]

content/docs/references/system/plugin.mdx

@@ -1,3 +1,6 @@
+import { QueryAST } from '@objectstack/spec/data';
+import { DriverOptions } from '@objectstack/spec/system';
+
 /**
  * IDataEngine - Standard Data Engine Interface
  * 
@@ -32,16 +35,18 @@ export interface IDataEngine {
   delete(objectName: string, id: any): Promise<boolean>;
 }
 
-// Driver Interface specific to storage drivers
-export interface DriverOptions {
-  name?: string;
-  url?: string;
-  [key: string]: any;
-}
-
-export interface DriverInterface extends IDataEngine {
+export interface DriverInterface {
   name: string;
   version: string;
   connect(): Promise<void>;
   disconnect(): Promise<void>;
+  
+  find(object: string, query: QueryAST, options?: DriverOptions): Promise<any[]>;
+  findOne(object: string, query: QueryAST, options?: DriverOptions): Promise<any>;
+  create(object: string, data: any, options?: DriverOptions): Promise<any>;
+  update(object: string, id: any, data: any, options?: DriverOptions): Promise<any>;
+  delete(object: string, id: any, options?: DriverOptions): Promise<any>;
+  
+  count?(object: string, query: QueryAST, options?: DriverOptions): Promise<number>;
 }
+

packages/core/src/contracts/data-engine.ts

@@ -2,7 +2,9 @@
   "extends": "../../tsconfig.json",
   "compilerOptions": {
     "outDir": "./dist",
-    "rootDir": "./src"
+    "rootDir": "./src",
+    "moduleResolution": "bundler",
+    "module": "esnext"
   },
   "include": ["src/**/*"],
   "exclude": [] 

packages/core/tsconfig.json

@@ -1,5 +1,6 @@
 import { QueryAST, QueryInput } from '@objectstack/spec/data';
-import { DriverInterface, DriverOptions } from '@objectstack/spec/system';
+import { DriverOptions } from '@objectstack/spec/system';
+import { DriverInterface } from '@objectstack/core';
 
 /**
  * Example: In-Memory Driver

packages/driver-memory/src/memory-driver.ts

@@ -1,7 +1,7 @@
 import { QueryAST, HookContext } from '@objectstack/spec/data';
 import { ObjectStackManifest } from '@objectstack/spec/system';
-import { DriverInterface, DriverOptions } from '@objectstack/spec/system';
-import { IDataEngine, DataEngineQueryOptions } from '@objectstack/spec/system';
+import { DriverOptions } from '@objectstack/spec/system';
+import { DriverInterface, IDataEngine, DataEngineQueryOptions } from '@objectstack/core';
 import { SchemaRegistry } from './registry';
 
 // Export Registry for consumers