@kubun/plugin-http 0.13.0 → 0.14.0

package/lib/index.d.ts

@@ -1,5 +1,6 @@
 import type { KubunPlugin, PluginFactoryParams } from '@kubun/engine';
-import type { RPCPluginAPI } from '@kubun/plugin-rpc';
+import type { AccessRules } from '@kubun/plugin-service-api';
+import type { ServiceServerPluginAPI } from '@kubun/plugin-service-server';
 import { Hono } from 'hono';
 /**
  * Options for the HTTP infrastructure plugin.
@@ -13,25 +14,29 @@ export type HTTPPluginOptions = {
     prefix?: string;
     /** Maximum request body size in bytes, enforced by the transport. Default: 1 MiB. */
     bodyLimit?: number;
+    /**
+     * Access posture for the graph service served over HTTP. `false` disables auth
+     * entirely; an `AccessRules` object grants the enumerated procedures; omit for
+     * the server-only default.
+     */
+    accessRules?: false | AccessRules;
 };
 /**
  * API provided by the HTTP infrastructure plugin.
  * Provides a shared routing surface for other plugins to register routes on.
  */
-export type HTTPPluginAPI = {
-    /** Resolves when the HTTP server is accepting connections. */
-    listening: Promise<void>;
-    registerRoute: (method: string, path: string, handler: (c: unknown) => unknown) => void;
-    registerProtocol: (name: string, fetch: (req: Request) => Response | Promise<Response>) => void;
-    getPort: () => number;
-    getURL: () => string;
-};
 /**
  * Options for creating a standalone graph protocol Hono app.
  */
 export type GraphAppOptions = {
-    /** The RPC plugin API (already resolved). */
-    rpc: RPCPluginAPI;
+    /** The service host API (already resolved). */
+    host: ServiceServerPluginAPI;
+    /**
+     * Access posture for the graph service. `false` disables auth entirely; an
+     * `AccessRules` object grants the enumerated procedures; omit for the
+     * server-only default.
+     */
+    accessRules?: false | AccessRules;
     /** Allowed CORS origin(s). Default: deny cross-origin. */
     allowedOrigin?: string | Array<string>;
     /** Maximum request body size in bytes, enforced by the transport. Default: 1 MiB. */
@@ -52,7 +57,7 @@ export type GraphApp = {
  *
  * The caller is responsible for:
  * - Creating and awaiting the KubunEngine
- * - Resolving the RPCPluginAPI via engine.getAPI('rpc')
+ * - Resolving the ServiceServerPluginAPI via engine.getAPI('service-server')
  * - Mounting the returned app and managing the HTTP server lifecycle
  */
 export declare function createGraphApp(options: GraphAppOptions): GraphApp;

package/lib/index.js

@@ -28,7 +28,7 @@ function createProtocolHandler(fetch) {
  *
  * The caller is responsible for:
  * - Creating and awaiting the KubunEngine
- * - Resolving the RPCPluginAPI via engine.getAPI('rpc')
+ * - Resolving the ServiceServerPluginAPI via engine.getAPI('service-server')
  * - Mounting the returned app and managing the HTTP server lifecycle
  */ export function createGraphApp(options) {
     const app = new Hono();
@@ -38,8 +38,21 @@ function createProtocolHandler(fetch) {
         maxRequestBodySize: options.bodyLimit ?? DEFAULT_BODY_LIMIT_BYTES
     });
     const handler = createProtocolHandler(transport.fetch.bind(transport));
-    // @ts-expect-error: type instantiation too deep
-    const server = options.rpc.serve(transport);
+    const requireAuth = options.accessRules === false;
+    const services = options.accessRules != null && options.accessRules !== false ? {
+        graph: {
+            rules: options.accessRules
+        }
+    } : {
+        graph: true
+    };
+    const server = options.host.serve({
+        transport,
+        services,
+        ...requireAuth ? {
+            requireAuth: false
+        } : {}
+    });
     app.post('/graph', handler);
     app.post('/graph/*', handler);
     app.options('/graph', handler);
@@ -126,11 +139,24 @@ function createProtocolHandler(fetch) {
                 maxRequestBodySize: options?.bodyLimit ?? DEFAULT_BODY_LIMIT_BYTES
             });
             api.registerProtocol('graph', transport.fetch.bind(transport));
-            // Get handlers from plugin-rpc's API instead of the engine's merged handler map.
-            // This decouples plugin-http from the engine's handler merging mechanism.
-            const rpcPlugin = await params.engine.getAPI('rpc');
-            // @ts-expect-error: type instantiation too deep
-            enkakuServer = rpcPlugin.serve(transport);
+            // Serve the graph service through the service host rather than the engine's
+            // merged handler map, decoupling plugin-http from handler merging.
+            const host = await params.engine.getAPI('service-server');
+            const requireAuth = options?.accessRules === false;
+            const services = options?.accessRules != null && options.accessRules !== false ? {
+                graph: {
+                    rules: options.accessRules
+                }
+            } : {
+                graph: true
+            };
+            enkakuServer = host.serve({
+                transport,
+                services,
+                ...requireAuth ? {
+                    requireAuth: false
+                } : {}
+            });
             httpServer = serve({
                 fetch: app.fetch,
                 port

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kubun/plugin-http",
-  "version": "0.13.0",
+  "version": "0.14.0",
   "license": "see LICENSE.md",
   "sideEffects": false,
   "type": "module",
@@ -18,17 +18,20 @@
     "@enkaku/protocol": "^0.21.0",
     "@enkaku/server": "^0.21.2",
     "@hono/node-server": "^2.1.1",
+    "@kubun/engine": "^0.14.0",
+    "@kubun/http-util": "^0.14.0",
+    "@kubun/plugin-http-api": "^0.14.0",
     "@sozai/async": "^0.2.1",
     "get-port": "^7.2.0",
-    "hono": "^4.13.3",
-    "@kubun/engine": "^0.13.0",
-    "@kubun/http-util": "^0.13.0"
+    "hono": "^4.13.4"
   },
   "devDependencies": {
     "@enkaku/http-fetch": "^0.21.0",
-    "@kubun/client": "^0.13.0",
-    "@kubun/plugin-rpc": "^0.13.0",
-    "@kubun/protocol": "^0.13.0",
+    "@kubun/client": "^0.14.0",
+    "@kubun/plugin-service-api": "^0.14.0",
+    "@kubun/plugin-service-server": "^0.14.0",
+    "@kubun/protocol": "^0.14.0",
+    "@kubun/service-graph-api": "^0.14.0",
     "@kubun/test-utils": "^0.13.0"
   },
   "publishConfig": {