feat: introduce @objectstack/rest package for REST API management

- Added RouteManager and RouteGroupBuilder for route management.
- Implemented RestServer for automatic REST endpoint generation.
- Created createRestApiPlugin for integrating REST API functionality.
- Updated runtime to use the new REST API plugin.
- Removed legacy API registry references and replaced with REST API configurations.
- Added TypeScript configuration for the new package.
- Updated pnpm-lock.yaml to include new dependencies.

Author: hotlong

packages/rest/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "@objectstack/rest",
+  "version": "1.1.0",
+  "license": "Apache-2.0",
+  "description": "ObjectStack REST API Server - automatic REST endpoint generation from protocol",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "scripts": {
+    "build": "tsup --config ../../tsup.config.ts",
+    "dev": "tsc -w",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "@objectstack/core": "workspace:*",
+    "@objectstack/spec": "workspace:*",
+    "zod": "^3.24.1"
+  },
+  "devDependencies": {
+    "typescript": "^5.0.0",
+    "vitest": "^4.0.18"
+  }
+}

packages/rest/src/index.ts

@@ -0,0 +1,14 @@
+// REST Server
+export { RestServer } from './rest-server.js';
+
+// Route Management
+export { RouteManager, RouteGroupBuilder } from './route-manager.js';
+export type { RouteEntry } from './route-manager.js';
+
+// REST API Plugin
+export { createRestApiPlugin } from './rest-api-plugin.js';
+export type { RestApiPluginConfig } from './rest-api-plugin.js';
+
+// Backward-compatible aliases (deprecated)
+export { createApiRegistryPlugin } from './rest-api-plugin.js';
+export type { ApiRegistryConfig } from './rest-api-plugin.js';

…kages/runtime/src/api-registry-plugin.ts packages/rest/src/rest-api-plugin.tspackages/runtime/src/api-registry-plugin.ts renamed to packages/rest/src/rest-api-plugin.ts packages/runtime/src/api-registry-plugin.ts renamed to packages/rest/src/rest-api-plugin.ts

@@ -2,23 +2,28 @@ import { Plugin, PluginContext, IHttpServer } from '@objectstack/core';
 import { RestServer } from './rest-server.js';
 import { ObjectStackProtocol, RestServerConfig } from '@objectstack/spec/api';
 
-export interface ApiRegistryConfig {
+export interface RestApiPluginConfig {
     serverServiceName?: string;
     protocolServiceName?: string;
     api?: RestServerConfig;
 }
 
 /**
- * ApiRegistryPlugin
+ * @deprecated Use {@link RestApiPluginConfig} instead
+ */
+export type ApiRegistryConfig = RestApiPluginConfig;
+
+/**
+ * REST API Plugin
  * 
  * Responsibilities:
  * 1. Consumes 'http.server' (or configured service)
  * 2. Consumes 'protocol' (ObjectStackProtocol)
  * 3. Instantiates RestServer to auto-generate routes
  */
-export function createApiRegistryPlugin(config: ApiRegistryConfig = {}): Plugin {
+export function createRestApiPlugin(config: RestApiPluginConfig = {}): Plugin {
     return {
-        name: 'com.objectstack.runtime.api-registry',
+        name: 'com.objectstack.rest.api',
         version: '1.0.0',
 
         init: async (_ctx: PluginContext) => {
@@ -45,12 +50,12 @@ export function createApiRegistryPlugin(config: ApiRegistryConfig = {}): Plugin
             }
 
             if (!server) {
-                ctx.logger.warn(`ApiRegistryPlugin: HTTP Server service '${serverService}' not found. REST routes skipped.`);
+                ctx.logger.warn(`RestApiPlugin: HTTP Server service '${serverService}' not found. REST routes skipped.`);
                 return;
             }
 
             if (!protocol) {
-                ctx.logger.warn(`ApiRegistryPlugin: Protocol service '${protocolService}' not found. REST routes skipped.`);
+                ctx.logger.warn(`RestApiPlugin: Protocol service '${protocolService}' not found. REST routes skipped.`);
                 return;
             }
 
@@ -68,3 +73,8 @@ export function createApiRegistryPlugin(config: ApiRegistryConfig = {}): Plugin
         }
     };
 }
+
+/**
+ * @deprecated Use {@link createRestApiPlugin} instead
+ */
+export const createApiRegistryPlugin = createRestApiPlugin;

packages/runtime/src/rest-server.ts packages/rest/src/rest-server.tspackages/runtime/src/rest-server.ts renamed to packages/rest/src/rest-server.ts

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

packages/runtime/src/route-manager.ts packages/rest/src/route-manager.tspackages/runtime/src/route-manager.ts renamed to packages/rest/src/route-manager.ts

@@ -20,6 +20,7 @@
   },
   "dependencies": {
     "@objectstack/core": "workspace:*",
+    "@objectstack/rest": "workspace:*",
     "@objectstack/spec": "workspace:*",
     "@objectstack/types": "workspace:*",
     "zod": "^3.24.1"

packages/rest/tsconfig.json

@@ -8,18 +8,27 @@ export type { RuntimeConfig } from './runtime.js';
 // Export Plugins
 export { DriverPlugin } from './driver-plugin.js';
 export { AppPlugin } from './app-plugin.js';
-export { createApiRegistryPlugin } from './api-registry-plugin.js';
-export type { ApiRegistryConfig } from './api-registry-plugin.js';
 
 // Export HTTP Server Components
 export { HttpServer } from './http-server.js';
 export { HttpDispatcher } from './http-dispatcher.js';
 export type { HttpProtocolContext, HttpDispatcherResult } from './http-dispatcher.js';
-export { RestServer } from './rest-server.js';
-export { RouteManager, RouteGroupBuilder } from './route-manager.js';
-export type { RouteEntry } from './route-manager.js';
 export { MiddlewareManager } from './middleware.js';
 
+// Re-export from @objectstack/rest for backward compatibility
+export {
+    RestServer,
+    RouteManager,
+    RouteGroupBuilder,
+    createRestApiPlugin,
+    createApiRegistryPlugin,
+} from '@objectstack/rest';
+export type {
+    RouteEntry,
+    RestApiPluginConfig,
+    ApiRegistryConfig,
+} from '@objectstack/rest';
+
 // Export Types
 export * from '@objectstack/core';
 

packages/runtime/package.json

@@ -1,5 +1,5 @@
 import { ObjectKernel, Plugin, IHttpServer, ObjectKernelConfig } from '@objectstack/core';
-import { createApiRegistryPlugin, ApiRegistryConfig } from './api-registry-plugin.js';
+import { createRestApiPlugin, RestApiPluginConfig } from '@objectstack/rest';
 
 export interface RuntimeConfig {
     /**
@@ -12,7 +12,7 @@ export interface RuntimeConfig {
     /**
      * API Registry Configuration
      */
-    api?: ApiRegistryConfig;
+    api?: RestApiPluginConfig;
 
     /**
      * Kernel Configuration
@@ -47,7 +47,7 @@ export class Runtime {
 
         // Register API Registry by default
         // This plugin is passive (wait for services) so it's safe to add early.
-        this.kernel.use(createApiRegistryPlugin(config.api));
+        this.kernel.use(createRestApiPlugin(config.api));
     }
 
     /**