feat(hono-plugin): add SPA fallback option and static file handling

feat(msw-plugin): refactor init method to use arrow function syntax
fix(api-registry-plugin): improve service retrieval with error handling

Author: hotlong

packages/plugins/plugin-hono-server/src/hono-plugin.ts

@@ -7,6 +7,7 @@ import {
 } from '@objectstack/spec/api';
 import { HonoHttpServer } from './adapter';
 import { createHonoApp } from '@objectstack/hono';
+import { serveStatic } from '@hono/node-server/serve-static';
 
 export interface HonoPluginOptions {
     port?: number;
@@ -26,6 +27,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 +59,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 +111,36 @@ export class HonoServerPlugin implements Plugin {
              ctx.logger.error('Failed to create standard Hono app', e);
         }
 
+        // Configure Static Files & SPA Fallback
+        if (this.options.staticRoot) {
+            const rawApp = this.server.getRawApp();
+            const staticRoot = this.options.staticRoot;
+            
+            ctx.logger.debug('Configuring static files', { root: staticRoot, spa: this.options.spaFallback });
+            
+            // 1. Static Files
+            rawApp.get('/*', serveStatic({ root: staticRoot }));
+            
+            // 2. SPA Fallback
+            if (this.options.spaFallback) {
+                rawApp.get('*', async (c, next) => {
+                    // Skip API paths
+                    const config = this.options.restConfig || {};
+                    const basePath = config.api?.basePath || '/api';
+                    
+                    if (c.req.path.startsWith(basePath)) {
+                        return next();
+                    }
+                    
+                    // Fallback to index.html
+                    return serveStatic({ 
+                        root: staticRoot,
+                        rewriteRequestPath: () => 'index.html'
+                    })(c, next);
+                });
+            }
+        }
+
         // Start server on kernel:ready hook
         ctx.hook('kernel:ready', async () => {
             const port = this.options.port || 3000;

packages/plugins/plugin-msw/src/msw-plugin.ts

@@ -118,7 +118,7 @@ export class MSWPlugin implements Plugin {
     /**
      * Init phase
      */
-    async init(ctx: PluginContext) {
+    init = async (ctx: PluginContext) => {
         ctx.logger.debug('Initializing MSW plugin', { 
             enableBrowser: this.options.enableBrowser,
             baseUrl: this.options.baseUrl,

packages/runtime/src/api-registry-plugin.ts

@@ -29,8 +29,20 @@ export function createApiRegistryPlugin(config: ApiRegistryConfig = {}): Plugin
             const serverService = config.serverServiceName || 'http.server';
             const protocolService = config.protocolServiceName || 'protocol';
 
-            const server = ctx.getService<IHttpServer>(serverService);
-            const protocol = ctx.getService<ObjectStackProtocol>(protocolService);
+            let server: IHttpServer | undefined;
+            let protocol: ObjectStackProtocol | undefined;
+
+            try {
+                server = ctx.getService<IHttpServer>(serverService);
+            } catch (e) {
+                // Ignore missing service
+            }
+
+            try {
+                protocol = ctx.getService<ObjectStackProtocol>(protocolService);
+            } catch (e) {
+                // Ignore missing service
+            }
 
             if (!server) {
                 ctx.logger.warn(`ApiRegistryPlugin: HTTP Server service '${serverService}' not found. REST routes skipped.`);