@objectstack/plugin-hono-server 1.0.4 → 1.0.6

package/dist/index.mjs

@@ -0,0 +1,297 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  HonoHttpServer: () => HonoHttpServer,
+  HonoServerPlugin: () => HonoServerPlugin
+});
+
+// src/adapter.ts
+var adapter_exports = {};
+__export(adapter_exports, {
+  HonoHttpServer: () => HonoHttpServer
+});
+__reExport(adapter_exports, core_star);
+import * as core_star from "@objectstack/core";
+import { Hono } from "hono";
+import { serve } from "@hono/node-server";
+import { serveStatic } from "@hono/node-server/serve-static";
+var HonoHttpServer = class {
+  constructor(port = 3e3, staticRoot) {
+    this.port = port;
+    this.staticRoot = staticRoot;
+    __publicField(this, "app");
+    __publicField(this, "server");
+    __publicField(this, "listeningPort");
+    this.app = new Hono();
+  }
+  // internal helper to convert standard handler to Hono handler
+  wrap(handler) {
+    return async (c) => {
+      let body = {};
+      if (c.req.header("content-type")?.includes("application/json")) {
+        try {
+          body = await c.req.json();
+        } catch (e) {
+          try {
+            body = await c.req.parseBody();
+          } catch (e2) {
+          }
+        }
+      } else {
+        try {
+          body = await c.req.parseBody();
+        } catch (e) {
+        }
+      }
+      const req = {
+        params: c.req.param(),
+        query: c.req.query(),
+        body,
+        headers: c.req.header(),
+        method: c.req.method,
+        path: c.req.path
+      };
+      let capturedResponse;
+      const res = {
+        json: (data) => {
+          capturedResponse = c.json(data);
+        },
+        send: (data) => {
+          capturedResponse = c.html(data);
+        },
+        status: (code) => {
+          c.status(code);
+          return res;
+        },
+        header: (name, value) => {
+          c.header(name, value);
+          return res;
+        }
+      };
+      await handler(req, res);
+      return capturedResponse;
+    };
+  }
+  get(path2, handler) {
+    this.app.get(path2, this.wrap(handler));
+  }
+  post(path2, handler) {
+    this.app.post(path2, this.wrap(handler));
+  }
+  put(path2, handler) {
+    this.app.put(path2, this.wrap(handler));
+  }
+  delete(path2, handler) {
+    this.app.delete(path2, this.wrap(handler));
+  }
+  patch(path2, handler) {
+    this.app.patch(path2, this.wrap(handler));
+  }
+  use(pathOrHandler, handler) {
+    if (typeof pathOrHandler === "string" && handler) {
+      this.app.use(pathOrHandler, async (c, next) => {
+        await handler({}, {}, next);
+      });
+    } else if (typeof pathOrHandler === "function") {
+      this.app.use("*", async (c, next) => {
+        await pathOrHandler({}, {}, next);
+      });
+    }
+  }
+  /**
+   * Mount a sub-application or router
+   */
+  mount(path2, subApp) {
+    this.app.route(path2, subApp);
+  }
+  async listen(port) {
+    return new Promise((resolve2) => {
+      if (this.staticRoot) {
+        this.app.get("/*", serveStatic({ root: this.staticRoot }));
+      }
+      const targetPort = port || this.port;
+      this.server = serve({
+        fetch: this.app.fetch,
+        port: targetPort
+      }, (info) => {
+        this.listeningPort = info.port;
+        resolve2();
+      });
+    });
+  }
+  getPort() {
+    return this.listeningPort || this.port;
+  }
+  // Expose raw app for scenarios where standard interface is not enough
+  getRawApp() {
+    return this.app;
+  }
+  async close() {
+    if (this.server && typeof this.server.close === "function") {
+      this.server.close();
+    }
+  }
+};
+
+// src/hono-plugin.ts
+import { createHonoApp } from "@objectstack/hono";
+import { serveStatic as serveStatic2 } from "@hono/node-server/serve-static";
+import * as fs from "fs";
+import * as path from "path";
+var HonoServerPlugin = class {
+  constructor(options = {}) {
+    __publicField(this, "name", "com.objectstack.server.hono");
+    __publicField(this, "version", "0.9.0");
+    __publicField(this, "options");
+    __publicField(this, "server");
+    /**
+     * Init phase - Setup HTTP server and register as service
+     */
+    __publicField(this, "init", async (ctx) => {
+      ctx.logger.debug("Initializing Hono server plugin", {
+        port: this.options.port,
+        staticRoot: this.options.staticRoot
+      });
+      ctx.registerService("http.server", this.server);
+      ctx.registerService("http-server", this.server);
+      ctx.logger.debug("HTTP server service registered", { serviceName: "http.server" });
+    });
+    /**
+     * Start phase - Bind routes and start listening
+     */
+    __publicField(this, "start", async (ctx) => {
+      ctx.logger.debug("Starting Hono server plugin");
+      try {
+        const kernel = ctx.getKernel();
+        const config = this.options.restConfig || {};
+        const apiVersion = config.api?.version || "v1";
+        const basePath = config.api?.basePath || "/api";
+        const apiPath = config.api?.apiPath || `${basePath}/${apiVersion}`;
+        const app = createHonoApp({
+          kernel,
+          prefix: apiPath
+          // Use the calculated path
+        });
+        ctx.logger.debug("Mounting ObjectStack Runtime App", { prefix: apiPath });
+        this.server.mount("/", app);
+      } catch (e) {
+        ctx.logger.error("Failed to create standard Hono app", e);
+      }
+      const mounts = this.options.staticMounts || [];
+      if (this.options.staticRoot) {
+        mounts.push({
+          root: this.options.staticRoot,
+          path: "/",
+          rewrite: false,
+          spa: this.options.spaFallback
+        });
+      }
+      if (mounts.length > 0) {
+        const rawApp = this.server.getRawApp();
+        for (const mount of mounts) {
+          const mountRoot = path.resolve(process.cwd(), mount.root);
+          if (!fs.existsSync(mountRoot)) {
+            ctx.logger.warn(`Static mount root not found: ${mountRoot}. Skipping.`);
+            continue;
+          }
+          const mountPath = mount.path || "/";
+          const normalizedPath = mountPath.startsWith("/") ? mountPath : `/${mountPath}`;
+          const routePattern = normalizedPath === "/" ? "/*" : `${normalizedPath.replace(/\/$/, "")}/*`;
+          const routes = normalizedPath === "/" ? [routePattern] : [normalizedPath, routePattern];
+          ctx.logger.debug("Mounting static files", {
+            to: routes,
+            from: mountRoot,
+            rewrite: mount.rewrite,
+            spa: mount.spa
+          });
+          routes.forEach((route) => {
+            rawApp.get(
+              route,
+              serveStatic2({
+                root: mount.root,
+                rewriteRequestPath: (reqPath) => {
+                  if (mount.rewrite && normalizedPath !== "/") {
+                    if (reqPath.startsWith(normalizedPath)) {
+                      return reqPath.substring(normalizedPath.length) || "/";
+                    }
+                  }
+                  return reqPath;
+                }
+              })
+            );
+            if (mount.spa) {
+              rawApp.get(route, async (c, next) => {
+                const config = this.options.restConfig || {};
+                const basePath = config.api?.basePath || "/api";
+                if (c.req.path.startsWith(basePath)) {
+                  return next();
+                }
+                return serveStatic2({
+                  root: mount.root,
+                  rewriteRequestPath: () => "index.html"
+                })(c, next);
+              });
+            }
+          });
+        }
+      }
+      ctx.hook("kernel:ready", async () => {
+        const port = this.options.port || 3e3;
+        ctx.logger.debug("Starting HTTP server", { port });
+        await this.server.listen(port);
+        const actualPort = this.server.getPort();
+        ctx.logger.info("HTTP server started successfully", {
+          port: actualPort,
+          url: `http://localhost:${actualPort}`
+        });
+      });
+    });
+    this.options = {
+      port: 3e3,
+      registerStandardEndpoints: true,
+      useApiRegistry: true,
+      spaFallback: false,
+      ...options
+    };
+    this.server = new HonoHttpServer(this.options.port);
+  }
+  /**
+   * Destroy phase - Stop server
+   */
+  async destroy() {
+    this.server.close();
+    console.log("[HonoServerPlugin] Server stopped");
+  }
+};
+// Constants
+__publicField(HonoServerPlugin, "DEFAULT_ENDPOINT_PRIORITY", 100);
+__publicField(HonoServerPlugin, "CORE_ENDPOINT_PRIORITY", 950);
+__publicField(HonoServerPlugin, "DISCOVERY_ENDPOINT_PRIORITY", 900);
+
+// src/index.ts
+__reExport(index_exports, adapter_exports);
+export {
+  HonoHttpServer,
+  HonoServerPlugin
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/adapter.ts","../src/hono-plugin.ts"],"sourcesContent":["export * from './hono-plugin';\nexport * from './adapter';\n\n","// Export IHttpServer from core\nexport * from '@objectstack/core';\n\nimport { \n    IHttpServer, \n    RouteHandler, \n    Middleware \n} from '@objectstack/core';\nimport { Hono } from 'hono';\nimport { serve } from '@hono/node-server';\nimport { serveStatic } from '@hono/node-server/serve-static';\n\n/**\n * Hono Implementation of IHttpServer\n */\nexport class HonoHttpServer implements IHttpServer {\n    private app: Hono;\n    private server: any;\n    private listeningPort: number | undefined;\n\n    constructor(\n        private port: number = 3000,\n        private staticRoot?: string\n    ) {\n        this.app = new Hono();\n    }\n\n    // internal helper to convert standard handler to Hono handler\n    private wrap(handler: RouteHandler) {\n        return async (c: any) => {\n            let body: any = {};\n            \n            // Try to parse JSON body first if content-type is JSON\n            if (c.req.header('content-type')?.includes('application/json')) {\n                try { \n                    body = await c.req.json(); \n                } catch(e) {\n                    // If JSON parsing fails, try parseBody\n                    try { \n                        body = await c.req.parseBody(); \n                    } catch(e2) {}\n                }\n            } else {\n                // For non-JSON content types, use parseBody\n                try { \n                    body = await c.req.parseBody(); \n                } catch(e) {}\n            }\n            \n            const req = {\n                params: c.req.param(),\n                query: c.req.query(),\n                body,\n                headers: c.req.header(),\n                method: c.req.method,\n                path: c.req.path\n            };\n\n            let capturedResponse: any;\n\n            const res = {\n                json: (data: any) => { capturedResponse = c.json(data); },\n                send: (data: string) => { capturedResponse = c.html(data); },\n                status: (code: number) => { c.status(code); return res; },\n                header: (name: string, value: string) => { c.header(name, value); return res; }\n            };\n\n            await handler(req as any, res as any);\n            return capturedResponse;\n        };\n    }\n\n    get(path: string, handler: RouteHandler) {\n        this.app.get(path, this.wrap(handler));\n    }\n    post(path: string, handler: RouteHandler) {\n        this.app.post(path, this.wrap(handler));\n    }\n    put(path: string, handler: RouteHandler) {\n        this.app.put(path, this.wrap(handler));\n    }\n    delete(path: string, handler: RouteHandler) {\n        this.app.delete(path, this.wrap(handler));\n    }\n    patch(path: string, handler: RouteHandler) {\n        this.app.patch(path, this.wrap(handler));\n    }\n    \n    use(pathOrHandler: string | Middleware, handler?: Middleware) {\n        if (typeof pathOrHandler === 'string' && handler) {\n             // Path based middleware\n             // Hono middleware signature is different (c, next) => ...\n             this.app.use(pathOrHandler, async (c, next) => {\n                 // Simplistic conversion\n                 await handler({} as any, {} as any, next);\n             });\n        } else if (typeof pathOrHandler === 'function') {\n             // Global middleware\n             this.app.use('*', async (c, next) => {\n                 await pathOrHandler({} as any, {} as any, next);\n             });\n        }\n    }\n\n    /**\n     * Mount a sub-application or router\n     */\n    mount(path: string, subApp: Hono) {\n        this.app.route(path, subApp);\n    }\n\n\n    async listen(port: number) {\n        return new Promise<void>((resolve) => {\n            if (this.staticRoot) {\n                this.app.get('/*', serveStatic({ root: this.staticRoot }));\n            }\n            \n            const targetPort = port || this.port;\n            this.server = serve({\n                fetch: this.app.fetch,\n                port: targetPort\n            }, (info) => {\n                this.listeningPort = info.port;\n                resolve();\n            });\n        });\n    }\n\n    getPort() {\n        return this.listeningPort || this.port;\n    }\n\n    // Expose raw app for scenarios where standard interface is not enough\n    getRawApp() {\n        return this.app;\n    }\n\n    async close() {\n        if (this.server && typeof this.server.close === 'function') {\n            this.server.close();\n        }\n    }\n\n\n}\n","import { Plugin, PluginContext, IHttpServer, ApiRegistry } from '@objectstack/core';\nimport { ObjectStackProtocol } from '@objectstack/spec/api';\nimport { \n    ApiRegistryEntryInput,\n    ApiEndpointRegistrationInput,\n    RestServerConfig,\n} from '@objectstack/spec/api';\nimport { HonoHttpServer } from './adapter';\nimport { createHonoApp } from '@objectstack/hono';\nimport { serveStatic } from '@hono/node-server/serve-static';\nimport * as fs from 'fs';\nimport * as path from 'path';\n\nexport interface StaticMount {\n    root: string;\n    path?: string;\n    rewrite?: boolean;\n    spa?: boolean;\n}\n\nexport interface HonoPluginOptions {\n    port?: number;\n    staticRoot?: string;\n    /**\n     * Multiple static resource mounts\n     */\n    staticMounts?: StaticMount[];\n    /**\n     * REST server configuration\n     * Controls automatic endpoint generation and API behavior\n     */\n    restConfig?: RestServerConfig;\n    /**\n     * Whether to register standard ObjectStack CRUD endpoints\n     * @default true\n     */\n    registerStandardEndpoints?: boolean;\n    /**\n     * Whether to load endpoints from API Registry\n     * @default true\n     */\n    useApiRegistry?: boolean;\n\n    /**\n     * Whether to enable SPA fallback\n     * If true, returns index.html for non-API 404s\n     * @default false\n     */\n    spaFallback?: boolean;\n}\n\n/**\n * Hono Server Plugin\n * \n * Provides HTTP server capabilities using Hono framework.\n * Registers routes for ObjectStack Runtime Protocol.\n */\nexport class HonoServerPlugin implements Plugin {\n    name = 'com.objectstack.server.hono';\n    version = '0.9.0';\n    \n    // Constants\n    private static readonly DEFAULT_ENDPOINT_PRIORITY = 100;\n    private static readonly CORE_ENDPOINT_PRIORITY = 950;\n    private static readonly DISCOVERY_ENDPOINT_PRIORITY = 900;\n    \n    private options: HonoPluginOptions;\n    private server: HonoHttpServer;\n\n    constructor(options: HonoPluginOptions = {}) {\n        this.options = { \n            port: 3000,\n            registerStandardEndpoints: true,\n            useApiRegistry: true,\n            spaFallback: false,\n            ...options\n        };\n        // We handle static root manually in start() to support SPA fallback\n        this.server = new HonoHttpServer(this.options.port);\n    }\n\n    /**\n     * Init phase - Setup HTTP server and register as service\n     */\n    init = async (ctx: PluginContext) => {\n        ctx.logger.debug('Initializing Hono server plugin', { \n            port: this.options.port,\n            staticRoot: this.options.staticRoot \n        });\n        \n        // Register HTTP server service as IHttpServer\n        // Register as 'http.server' to match core requirements\n        ctx.registerService('http.server', this.server);\n        // Alias 'http-server' for backward compatibility\n        ctx.registerService('http-server', this.server);\n        ctx.logger.debug('HTTP server service registered', { serviceName: 'http.server' });\n    }\n\n    /**\n     * Start phase - Bind routes and start listening\n     */\n    start = async (ctx: PluginContext) => {\n        ctx.logger.debug('Starting Hono server plugin');\n        \n        // Use Standard ObjectStack Runtime Hono App\n        try {\n            const kernel = ctx.getKernel();\n            const config = this.options.restConfig || {};\n            // Calculate prefix similar to before\n            const apiVersion = config.api?.version || 'v1';\n            const basePath = config.api?.basePath || '/api';\n            const apiPath = config.api?.apiPath || `${basePath}/${apiVersion}`;\n            \n            const app = createHonoApp({ \n                kernel,\n                prefix: apiPath // Use the calculated path\n            });\n            \n            ctx.logger.debug('Mounting ObjectStack Runtime App', { prefix: apiPath });\n            // Use the mount method we added to HonoHttpServer\n            this.server.mount('/', app as any);\n\n        } catch (e: any) {\n             ctx.logger.error('Failed to create standard Hono app', e);\n        }\n\n        // Configure Static Files & SPA Fallback\n        const mounts: StaticMount[] = this.options.staticMounts || [];\n\n        // Backward compatibility for staticRoot\n        if (this.options.staticRoot) {\n            mounts.push({\n                root: this.options.staticRoot,\n                path: '/',\n                rewrite: false,\n                spa: this.options.spaFallback\n            });\n        }\n\n        if (mounts.length > 0) {\n            const rawApp = this.server.getRawApp();\n            \n            for (const mount of mounts) {\n                const mountRoot = path.resolve(process.cwd(), mount.root);\n\n                if (!fs.existsSync(mountRoot)) {\n                    ctx.logger.warn(`Static mount root not found: ${mountRoot}. Skipping.`);\n                    continue;\n                }\n\n                const mountPath = mount.path || '/';\n                const normalizedPath = mountPath.startsWith('/') ? mountPath : `/${mountPath}`;\n                const routePattern = normalizedPath === '/' ? '/*' : `${normalizedPath.replace(/\\/$/, '')}/*`;\n                \n                // Routes to register: both /mount and /mount/*\n                const routes = normalizedPath === '/' ? [routePattern] : [normalizedPath, routePattern];\n\n                ctx.logger.debug('Mounting static files', { \n                    to: routes, \n                    from: mountRoot, \n                    rewrite: mount.rewrite, \n                    spa: mount.spa \n                });\n\n                routes.forEach(route => {\n                    // 1. Serve Static Files\n                    rawApp.get(\n                        route, \n                        serveStatic({ \n                            root: mount.root,\n                            rewriteRequestPath: (reqPath) => {\n                                if (mount.rewrite && normalizedPath !== '/') {\n                                    // /console/assets/style.css -> /assets/style.css\n                                    if (reqPath.startsWith(normalizedPath)) {\n                                        return reqPath.substring(normalizedPath.length) || '/';\n                                    }\n                                }\n                                return reqPath;\n                            }\n                        })\n                    );\n\n                    // 2. SPA Fallback (Scoped)\n                    if (mount.spa) {\n                        rawApp.get(route, async (c, next) => {\n                            // Skip if API path check\n                            const config = this.options.restConfig || {};\n                            const basePath = config.api?.basePath || '/api';\n                            \n                            if (c.req.path.startsWith(basePath)) {\n                                return next();\n                            }\n\n                            return serveStatic({ \n                                root: mount.root,\n                                rewriteRequestPath: () => 'index.html'\n                            })(c, next);\n                        });\n                    }\n                });\n            }\n        }\n\n        // Start server on kernel:ready hook\n        ctx.hook('kernel:ready', async () => {\n            const port = this.options.port || 3000;\n            ctx.logger.debug('Starting HTTP server', { port });\n            \n            await this.server.listen(port);\n            \n            const actualPort = this.server.getPort();\n            ctx.logger.info('HTTP server started successfully', { \n                port: actualPort, \n                url: `http://localhost:${actualPort}` \n            });\n        });\n    }\n\n    /**\n     * Destroy phase - Stop server\n     */\n    async destroy() {\n        this.server.close();\n        // Note: Can't use ctx.logger here since we're in destroy\n        console.log('[HonoServerPlugin] Server stopped');\n    }\n}\n"],"mappings":"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","names":["path","resolve","serveStatic","serveStatic"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@objectstack/plugin-hono-server",
-  "version": "1.0.4",
+  "version": "1.0.6",
   "license": "Apache-2.0",
   "description": "Standard Hono Server Adapter for ObjectStack Runtime",
   "main": "dist/index.js",
@@ -8,11 +8,11 @@
   "dependencies": {
     "@hono/node-server": "^1.2.0",
     "hono": "^4.0.0",
-    "@objectstack/core": "1.0.4",
-    "@objectstack/hono": "1.0.4",
-    "@objectstack/runtime": "1.0.4",
-    "@objectstack/spec": "1.0.4",
-    "@objectstack/types": "1.0.4"
+    "@objectstack/core": "1.0.6",
+    "@objectstack/runtime": "1.0.6",
+    "@objectstack/hono": "1.0.6",
+    "@objectstack/spec": "1.0.6",
+    "@objectstack/types": "1.0.6"
   },
   "devDependencies": {
     "@types/node": "^25.1.0",
@@ -20,7 +20,7 @@
     "vitest": "^4.0.18"
   },
   "scripts": {
-    "build": "tsc",
+    "build": "tsup --config ../../../tsup.config.ts",
     "test": "vitest run"
   }
 }

package/src/hono-plugin.test.ts

@@ -4,18 +4,36 @@ import { PluginContext } from '@objectstack/core';
 import { createHonoApp } from '@objectstack/hono';
 import { HonoHttpServer } from './adapter';
 
+vi.mock('fs', async (importOriginal) => {
+    const actual = await importOriginal<typeof import('fs')>();
+    return {
+        ...actual,
+        existsSync: vi.fn().mockReturnValue(true)
+    };
+});
+
 // Mock dependencies
 vi.mock('@objectstack/hono', () => ({
     createHonoApp: vi.fn(),
 }));
 
+vi.mock('@hono/node-server/serve-static', () => ({
+    serveStatic: vi.fn(() => (c: any, next: any) => next())
+}));
+
 vi.mock('./adapter', () => ({
     HonoHttpServer: vi.fn(function() {
         return {
             mount: vi.fn(),
             start: vi.fn(),
             stop: vi.fn(),
-            getApp: vi.fn()
+            getApp: vi.fn(),
+            listen: vi.fn(),
+            getPort: vi.fn().mockReturnValue(3000),
+            close: vi.fn(),
+            getRawApp: vi.fn().mockReturnValue({
+                get: vi.fn(),
+            })
         };
     })
 }));
@@ -104,4 +122,23 @@ describe('HonoServerPlugin', () => {
         
         expect(logger.error).toHaveBeenCalledWith('Failed to create standard Hono app', expect.any(Error));
     });
+
+    it('should configure static files and SPA fallback when enabled', async () => {
+        const plugin = new HonoServerPlugin({
+            staticRoot: './public',
+            spaFallback: true
+        });
+
+        await plugin.init(context as PluginContext);
+        await plugin.start(context as PluginContext);
+
+        const serverInstance = (HonoHttpServer as any).mock.instances[0];
+        const rawApp = serverInstance.getRawApp();
+        
+        expect(serverInstance.getRawApp).toHaveBeenCalled();
+        // Should register static files middleware
+        expect(rawApp.get).toHaveBeenCalledWith('/*', expect.anything());
+        // Should register SPA fallback middleware
+        expect(rawApp.get).toHaveBeenCalledWith('/*', expect.anything());
+    });
 });

package/src/hono-plugin.ts

@@ -7,10 +7,24 @@ import {
 } from '@objectstack/spec/api';
 import { HonoHttpServer } from './adapter';
 import { createHonoApp } from '@objectstack/hono';
+import { serveStatic } from '@hono/node-server/serve-static';
+import * as fs from 'fs';
+import * as path from 'path';
+
+export interface StaticMount {
+    root: string;
+    path?: string;
+    rewrite?: boolean;
+    spa?: boolean;
+}
 
 export interface HonoPluginOptions {
     port?: number;
     staticRoot?: string;
+    /**
+     * Multiple static resource mounts
+     */
+    staticMounts?: StaticMount[];
     /**
      * REST server configuration
      * Controls automatic endpoint generation and API behavior
@@ -26,6 +40,13 @@ export interface HonoPluginOptions {
      * @default true
      */
     useApiRegistry?: boolean;
+
+    /**
+     * Whether to enable SPA fallback
+     * If true, returns index.html for non-API 404s
+     * @default false
+     */
+    spaFallback?: boolean;
 }
 
 /**
@@ -51,9 +72,11 @@ export class HonoServerPlugin implements Plugin {
             port: 3000,
             registerStandardEndpoints: true,
             useApiRegistry: true,
+            spaFallback: false,
             ...options
         };
-        this.server = new HonoHttpServer(this.options.port, this.options.staticRoot);
+        // We handle static root manually in start() to support SPA fallback
+        this.server = new HonoHttpServer(this.options.port);
     }
 
     /**
@@ -101,6 +124,83 @@ export class HonoServerPlugin implements Plugin {
              ctx.logger.error('Failed to create standard Hono app', e);
         }
 
+        // Configure Static Files & SPA Fallback
+        const mounts: StaticMount[] = this.options.staticMounts || [];
+
+        // Backward compatibility for staticRoot
+        if (this.options.staticRoot) {
+            mounts.push({
+                root: this.options.staticRoot,
+                path: '/',
+                rewrite: false,
+                spa: this.options.spaFallback
+            });
+        }
+
+        if (mounts.length > 0) {
+            const rawApp = this.server.getRawApp();
+            
+            for (const mount of mounts) {
+                const mountRoot = path.resolve(process.cwd(), mount.root);
+
+                if (!fs.existsSync(mountRoot)) {
+                    ctx.logger.warn(`Static mount root not found: ${mountRoot}. Skipping.`);
+                    continue;
+                }
+
+                const mountPath = mount.path || '/';
+                const normalizedPath = mountPath.startsWith('/') ? mountPath : `/${mountPath}`;
+                const routePattern = normalizedPath === '/' ? '/*' : `${normalizedPath.replace(/\/$/, '')}/*`;
+                
+                // Routes to register: both /mount and /mount/*
+                const routes = normalizedPath === '/' ? [routePattern] : [normalizedPath, routePattern];
+
+                ctx.logger.debug('Mounting static files', { 
+                    to: routes, 
+                    from: mountRoot, 
+                    rewrite: mount.rewrite, 
+                    spa: mount.spa 
+                });
+
+                routes.forEach(route => {
+                    // 1. Serve Static Files
+                    rawApp.get(
+                        route, 
+                        serveStatic({ 
+                            root: mount.root,
+                            rewriteRequestPath: (reqPath) => {
+                                if (mount.rewrite && normalizedPath !== '/') {
+                                    // /console/assets/style.css -> /assets/style.css
+                                    if (reqPath.startsWith(normalizedPath)) {
+                                        return reqPath.substring(normalizedPath.length) || '/';
+                                    }
+                                }
+                                return reqPath;
+                            }
+                        })
+                    );
+
+                    // 2. SPA Fallback (Scoped)
+                    if (mount.spa) {
+                        rawApp.get(route, async (c, next) => {
+                            // Skip if API path check
+                            const config = this.options.restConfig || {};
+                            const basePath = config.api?.basePath || '/api';
+                            
+                            if (c.req.path.startsWith(basePath)) {
+                                return next();
+                            }
+
+                            return serveStatic({ 
+                                root: mount.root,
+                                rewriteRequestPath: () => 'index.html'
+                            })(c, next);
+                        });
+                    }
+                });
+            }
+        }
+
         // Start server on kernel:ready hook
         ctx.hook('kernel:ready', async () => {
             const port = this.options.port || 3000;

package/dist/adapter.d.ts

@@ -1,29 +0,0 @@
-export * from '@objectstack/core';
-import { IHttpServer, RouteHandler, Middleware } from '@objectstack/core';
-import { Hono } from 'hono';
-/**
- * Hono Implementation of IHttpServer
- */
-export declare class HonoHttpServer implements IHttpServer {
-    private port;
-    private staticRoot?;
-    private app;
-    private server;
-    private listeningPort;
-    constructor(port?: number, staticRoot?: string | undefined);
-    private wrap;
-    get(path: string, handler: RouteHandler): void;
-    post(path: string, handler: RouteHandler): void;
-    put(path: string, handler: RouteHandler): void;
-    delete(path: string, handler: RouteHandler): void;
-    patch(path: string, handler: RouteHandler): void;
-    use(pathOrHandler: string | Middleware, handler?: Middleware): void;
-    /**
-     * Mount a sub-application or router
-     */
-    mount(path: string, subApp: Hono): void;
-    listen(port: number): Promise<void>;
-    getPort(): number;
-    getRawApp(): Hono<import("hono/types").BlankEnv, import("hono/types").BlankSchema, "/">;
-    close(): Promise<void>;
-}