@bleedingdev/modern-js-plugin-bff 3.5.0-ultramodern.97 → 3.5.0-ultramodern.99

package/dist/cjs/runtime/effect/endpoint-contracts.js

@@ -37,6 +37,11 @@ __webpack_require__.d(__webpack_exports__, {
 });
 const bff_core_namespaceObject = require("@modern-js/bff-core");
 const external_entry_shape_js_namespaceObject = require("./entry-shape.js");
+function resolveEffectEndpointName(endpoint) {
+    if ('string' == typeof endpoint.identifier && endpoint.identifier) return endpoint.identifier;
+    if ('string' == typeof endpoint.name && endpoint.name) return endpoint.name;
+    return '';
+}
 function ensureLeadingSlash(pathname) {
     return pathname.startsWith('/') ? pathname : `/${pathname}`;
 }
@@ -65,7 +70,7 @@ function collectEffectEndpoints(reflect, api, prefix) {
             endpoints.push({
                 apiId,
                 groupName: String(group.identifier),
-                endpointName: String(endpoint.name),
+                endpointName: resolveEffectEndpointName(endpoint),
                 method: String(endpoint.method).toUpperCase(),
                 routePath: getEffectRoutePath(prefix, String(endpoint.path))
             });

package/dist/cjs/runtime/hono/adapter.js

@@ -39,7 +39,6 @@ __webpack_require__.r(__webpack_exports__);
 __webpack_require__.d(__webpack_exports__, {
     HonoAdapter: ()=>HonoAdapter
 });
-const server_core_namespaceObject = require("@modern-js/server-core");
 const utils_namespaceObject = require("@modern-js/utils");
 const createHonoRoutes_js_namespaceObject = require("../../utils/createHonoRoutes.js");
 var createHonoRoutes_js_default = /*#__PURE__*/ __webpack_require__.n(createHonoRoutes_js_namespaceObject);
@@ -50,17 +49,9 @@ const before = [
     'custom-server-middleware',
     'render'
 ];
-const kParentHonoVars = Symbol.for('modernjs.hono.parentVars');
 class HonoAdapter {
-    wrapInArray(handler) {
-        if (Array.isArray(handler)) return handler;
-        return [
-            handler
-        ];
-    }
     constructor(api){
         this.apiMiddleware = [];
-        this.apiServer = null;
         this.isHono = true;
         this.prefix = '/api';
         this.setHandlers = async ()=>{
@@ -71,7 +62,7 @@ class HonoAdapter {
                     name: 'hono-bff-api',
                     path,
                     method,
-                    handler,
+                    handler: this.withErrorBoundary(handler),
                     order: 'post',
                     before
                 }));
@@ -92,85 +83,47 @@ class HonoAdapter {
                 });
             }
         };
-        this.registerApiRoutes = async ()=>{
-            if (!this.isHono) return;
-            this.apiServer = new server_core_namespaceObject.Hono();
-            this.apiServer.use('*', server_core_namespaceObject.run);
-            this.apiServer.use('*', async (c, next)=>{
-                const nodeReq = c.env?.node?.req;
-                const parentVars = nodeReq?.[kParentHonoVars];
-                if (parentVars && 'object' == typeof parentVars) {
-                    delete nodeReq[kParentHonoVars];
-                    for (const [key, value] of Object.entries(parentVars))if (void 0 === c.get(key)) c.set(key, value);
-                }
-                await next();
-            });
-            this.apiMiddleware.forEach(({ path = '*', method = 'all', handler })=>{
-                const handlers = this.wrapInArray(handler);
-                if (0 === handlers.length) return;
-                const firstHandler = handlers[0];
-                const restHandlers = handlers.slice(1);
-                const m = method;
-                const server = this.apiServer;
-                if (!server) return;
-                const register = server[m];
-                register.call(server, path, firstHandler, ...restHandlers);
-            });
-            this.apiServer.onError(async (err, c)=>{
-                try {
-                    const serverConfig = this.api.getServerConfig();
-                    const onErrorHandler = serverConfig?.onError;
-                    if (onErrorHandler) {
-                        const result = await onErrorHandler(err, c);
-                        if (result instanceof Response) return result;
-                    } else utils_namespaceObject.logger.error(err);
-                } catch (configError) {
-                    utils_namespaceObject.logger.error(`Error in serverConfig.onError handler: ${configError}`);
-                }
-                return (0, external_safe_failure_js_namespaceObject.createSafeFailureResponse)(err);
-            });
-        };
-        this.registerMiddleware = async (options)=>{
-            const { prefix } = options;
+        this.registerMiddleware = async (options = {})=>{
             const { bffRuntimeFramework } = this.api.getServerContext();
             if ('hono' !== bffRuntimeFramework) {
                 this.isHono = false;
                 return;
             }
+            const { prefix } = options;
             this.prefix = prefix || this.prefix;
             const { middlewares: globalMiddlewares } = this.api.getServerContext();
             await this.setHandlers();
-            if ((0, utils_namespaceObject.isProd)()) globalMiddlewares.push(...this.apiMiddleware);
-            else {
-                await this.registerApiRoutes();
-                const dynamicApiMiddleware = {
-                    name: 'dynamic-bff-handler',
-                    path: `${prefix}/*`,
-                    method: 'all',
-                    order: 'post',
-                    before,
-                    handler: async (c, next)=>{
-                        if (this.apiServer) {
-                            const nodeReq = c.env?.node?.req;
-                            if (nodeReq) {
-                                const parentVars = c?.var;
-                                nodeReq[kParentHonoVars] = parentVars && 'object' == typeof parentVars ? {
-                                    ...parentVars
-                                } : parentVars;
-                            }
-                            const response = await this.apiServer.fetch(c.req.raw, c.env);
-                            if (404 !== response.status) return new Response(response.body, response);
-                        }
-                        await next();
-                    }
-                };
-                globalMiddlewares.push(dynamicApiMiddleware);
+            globalMiddlewares.push(...this.apiMiddleware);
+        };
+        this.handleRouteError = async (error, c)=>{
+            try {
+                const onErrorHandler = this.api.getServerConfig()?.onError;
+                if (onErrorHandler) {
+                    const result = await onErrorHandler(error, c);
+                    if (result instanceof Response) return result;
+                } else utils_namespaceObject.logger.error(error);
+            } catch (configError) {
+                utils_namespaceObject.logger.error(`Error in serverConfig.onError handler: ${configError}`);
             }
+            return (0, external_safe_failure_js_namespaceObject.createSafeFailureResponse)(error);
         };
-        this.onApiHandlersUpdated = async ()=>{
-            if (!this.isHono) return;
-            await this.setHandlers();
-            await this.registerApiRoutes();
+        this.withErrorBoundary = (handler)=>{
+            const handlers = Array.isArray(handler) ? handler : [
+                handler
+            ];
+            const [firstHandler, ...restHandlers] = handlers;
+            if (!firstHandler) return handler;
+            const boundary = async (c, next)=>{
+                try {
+                    return await firstHandler(c, next);
+                } catch (error) {
+                    return this.handleRouteError(error, c);
+                }
+            };
+            return Array.isArray(handler) ? [
+                boundary,
+                ...restHandlers
+            ] : boundary;
         };
         this.api = api;
     }

package/dist/cjs/server.js

@@ -43,15 +43,17 @@ const bff_core_namespaceObject = require("@modern-js/bff-core");
 const utils_namespaceObject = require("@modern-js/utils");
 const external_path_namespaceObject = require("path");
 var external_path_default = /*#__PURE__*/ __webpack_require__.n(external_path_namespaceObject);
-const adapter_js_namespaceObject = require("./runtime/effect/adapter.js");
-const hono_adapter_js_namespaceObject = require("./runtime/hono/adapter.js");
-const RUNTIME_ADAPTER_FACTORIES = {
-    hono: [
-        (api)=>new hono_adapter_js_namespaceObject.HonoAdapter(api)
-    ],
-    effect: [
-        (api)=>new adapter_js_namespaceObject.EffectAdapter(api)
-    ]
+const adapter_js_namespaceObject = require("./runtime/hono/adapter.js");
+const RUNTIME_ADAPTER_LOADERS = {
+    hono: async (api)=>[
+            new adapter_js_namespaceObject.HonoAdapter(api)
+        ],
+    effect: async (api)=>{
+        const { EffectAdapter } = await import("./runtime/effect/adapter.js");
+        return [
+            new EffectAdapter(api)
+        ];
+    }
 };
 const normalizePrefixList = (prefix)=>{
     if (Array.isArray(prefix)) return prefix.filter(Boolean);
@@ -64,9 +66,6 @@ function resolveRuntimeFramework(runtimeFramework) {
     return 'hono' === runtimeFramework ? 'hono' : 'effect';
 }
 class Storage {
-    reset() {
-        this.middlewares = [];
-    }
     constructor(){
         this.middlewares = [];
     }
@@ -78,7 +77,6 @@ const server = ()=>({
             let apiRouter = null;
             const appContext = api.getServerContext();
             const runtimeFramework = resolveRuntimeFramework(appContext.bffRuntimeFramework);
-            const runtimeAdapters = RUNTIME_ADAPTER_FACTORIES[runtimeFramework].map((createAdapter)=>createAdapter(api));
             api.onPrepare(async ()=>{
                 const appContext = api.getServerContext();
                 const { render } = appContext;
@@ -124,29 +122,20 @@ const server = ()=>({
                         ]
                     });
                 }
+                const runtimeAdapters = await RUNTIME_ADAPTER_LOADERS[runtimeFramework](api);
                 await Promise.all(runtimeAdapters.map((adapter)=>adapter.registerMiddleware({
                         prefix,
                         enableHandleWeb
                     })));
             });
             api.onReset(async ({ event })=>{
-                storage.reset();
-                const appContext = api.getServerContext();
-                const { middlewares } = storage;
-                api.updateServerContext({
-                    ...appContext,
-                    apiMiddlewares: middlewares
-                });
-                if ('file-change' === event.type) {
-                    if ('hono' === runtimeFramework && apiRouter) {
-                        const apiHandlerInfos = await apiRouter.getApiHandlers();
-                        const appContext = api.getServerContext();
-                        api.updateServerContext({
-                            ...appContext,
-                            apiHandlerInfos
-                        });
-                    }
-                    await Promise.all(runtimeAdapters.map((adapter)=>adapter.onApiHandlersUpdated?.()));
+                if ('file-change' === event.type && apiRouter) {
+                    const appContext = api.getServerContext();
+                    const apiHandlerInfos = await apiRouter.getApiHandlers();
+                    api.updateServerContext({
+                        ...appContext,
+                        apiHandlerInfos
+                    });
                 }
             });
             const prepareApiServer = async (input, next)=>{

package/dist/cjs/utils/client-generator/write-package.js

@@ -112,7 +112,7 @@ async function setPackage(files, appDirectory, relativeDistPath) {
         }
     });
     (0, external_package_json_js_namespaceObject.mergePackageJson)(packageJson, addFiles, typesVersions, exports1, relativeDistPath);
-    await utils_namespaceObject.fs.promises.writeFile(packagePath, JSON.stringify(packageJson, null, 2));
+    await utils_namespaceObject.fs.promises.writeFile(packagePath, `${JSON.stringify(packageJson, null, 2)}\n`);
 }
 exports.setPackage = __webpack_exports__.setPackage;
 exports.writeClientModuleBoundary = __webpack_exports__.writeClientModuleBoundary;

package/dist/esm/runtime/effect/endpoint-contracts.mjs

@@ -1,5 +1,10 @@
 import { createOperationContractHash } from "@modern-js/bff-core";
 import { classifyEffectBffEntryModule, isValidatorAwareHandlerFactory } from "./entry-shape.mjs";
+function resolveEffectEndpointName(endpoint) {
+    if ('string' == typeof endpoint.identifier && endpoint.identifier) return endpoint.identifier;
+    if ('string' == typeof endpoint.name && endpoint.name) return endpoint.name;
+    return '';
+}
 function ensureLeadingSlash(pathname) {
     return pathname.startsWith('/') ? pathname : `/${pathname}`;
 }
@@ -28,7 +33,7 @@ function collectEffectEndpoints(reflect, api, prefix) {
             endpoints.push({
                 apiId,
                 groupName: String(group.identifier),
-                endpointName: String(endpoint.name),
+                endpointName: resolveEffectEndpointName(endpoint),
                 method: String(endpoint.method).toUpperCase(),
                 routePath: getEffectRoutePath(prefix, String(endpoint.path))
             });

package/dist/esm/runtime/hono/adapter.mjs

@@ -1,5 +1,4 @@
-import { Hono, run } from "@modern-js/server-core";
-import { isProd, logger } from "@modern-js/utils";
+import { logger } from "@modern-js/utils";
 import createHonoRoutes from "../../utils/createHonoRoutes.mjs";
 import { checkCrossProjectPolicyResponse, resolveAdapterCrossProjectPolicy } from "../../utils/crossProjectServerPolicy.mjs";
 import { createSafeFailureResponse } from "../safe-failure.mjs";
@@ -8,17 +7,9 @@ const before = [
     'custom-server-middleware',
     'render'
 ];
-const kParentHonoVars = Symbol.for('modernjs.hono.parentVars');
 class HonoAdapter {
-    wrapInArray(handler) {
-        if (Array.isArray(handler)) return handler;
-        return [
-            handler
-        ];
-    }
     constructor(api){
         this.apiMiddleware = [];
-        this.apiServer = null;
         this.isHono = true;
         this.prefix = '/api';
         this.setHandlers = async ()=>{
@@ -29,7 +20,7 @@ class HonoAdapter {
                     name: 'hono-bff-api',
                     path,
                     method,
-                    handler,
+                    handler: this.withErrorBoundary(handler),
                     order: 'post',
                     before: before
                 }));
@@ -50,85 +41,47 @@ class HonoAdapter {
                 });
             }
         };
-        this.registerApiRoutes = async ()=>{
-            if (!this.isHono) return;
-            this.apiServer = new Hono();
-            this.apiServer.use('*', run);
-            this.apiServer.use('*', async (c, next)=>{
-                const nodeReq = c.env?.node?.req;
-                const parentVars = nodeReq?.[kParentHonoVars];
-                if (parentVars && 'object' == typeof parentVars) {
-                    delete nodeReq[kParentHonoVars];
-                    for (const [key, value] of Object.entries(parentVars))if (void 0 === c.get(key)) c.set(key, value);
-                }
-                await next();
-            });
-            this.apiMiddleware.forEach(({ path = '*', method = 'all', handler })=>{
-                const handlers = this.wrapInArray(handler);
-                if (0 === handlers.length) return;
-                const firstHandler = handlers[0];
-                const restHandlers = handlers.slice(1);
-                const m = method;
-                const server = this.apiServer;
-                if (!server) return;
-                const register = server[m];
-                register.call(server, path, firstHandler, ...restHandlers);
-            });
-            this.apiServer.onError(async (err, c)=>{
-                try {
-                    const serverConfig = this.api.getServerConfig();
-                    const onErrorHandler = serverConfig?.onError;
-                    if (onErrorHandler) {
-                        const result = await onErrorHandler(err, c);
-                        if (result instanceof Response) return result;
-                    } else logger.error(err);
-                } catch (configError) {
-                    logger.error(`Error in serverConfig.onError handler: ${configError}`);
-                }
-                return createSafeFailureResponse(err);
-            });
-        };
-        this.registerMiddleware = async (options)=>{
-            const { prefix } = options;
+        this.registerMiddleware = async (options = {})=>{
             const { bffRuntimeFramework } = this.api.getServerContext();
             if ('hono' !== bffRuntimeFramework) {
                 this.isHono = false;
                 return;
             }
+            const { prefix } = options;
             this.prefix = prefix || this.prefix;
             const { middlewares: globalMiddlewares } = this.api.getServerContext();
             await this.setHandlers();
-            if (isProd()) globalMiddlewares.push(...this.apiMiddleware);
-            else {
-                await this.registerApiRoutes();
-                const dynamicApiMiddleware = {
-                    name: 'dynamic-bff-handler',
-                    path: `${prefix}/*`,
-                    method: 'all',
-                    order: 'post',
-                    before: before,
-                    handler: async (c, next)=>{
-                        if (this.apiServer) {
-                            const nodeReq = c.env?.node?.req;
-                            if (nodeReq) {
-                                const parentVars = c?.var;
-                                nodeReq[kParentHonoVars] = parentVars && 'object' == typeof parentVars ? {
-                                    ...parentVars
-                                } : parentVars;
-                            }
-                            const response = await this.apiServer.fetch(c.req.raw, c.env);
-                            if (404 !== response.status) return new Response(response.body, response);
-                        }
-                        await next();
-                    }
-                };
-                globalMiddlewares.push(dynamicApiMiddleware);
+            globalMiddlewares.push(...this.apiMiddleware);
+        };
+        this.handleRouteError = async (error, c)=>{
+            try {
+                const onErrorHandler = this.api.getServerConfig()?.onError;
+                if (onErrorHandler) {
+                    const result = await onErrorHandler(error, c);
+                    if (result instanceof Response) return result;
+                } else logger.error(error);
+            } catch (configError) {
+                logger.error(`Error in serverConfig.onError handler: ${configError}`);
             }
+            return createSafeFailureResponse(error);
         };
-        this.onApiHandlersUpdated = async ()=>{
-            if (!this.isHono) return;
-            await this.setHandlers();
-            await this.registerApiRoutes();
+        this.withErrorBoundary = (handler)=>{
+            const handlers = Array.isArray(handler) ? handler : [
+                handler
+            ];
+            const [firstHandler, ...restHandlers] = handlers;
+            if (!firstHandler) return handler;
+            const boundary = async (c, next)=>{
+                try {
+                    return await firstHandler(c, next);
+                } catch (error) {
+                    return this.handleRouteError(error, c);
+                }
+            };
+            return Array.isArray(handler) ? [
+                boundary,
+                ...restHandlers
+            ] : boundary;
         };
         this.api = api;
     }

package/dist/esm/server.mjs

@@ -1,15 +1,17 @@
 import { ApiRouter } from "@modern-js/bff-core";
 import { API_DIR, isFunction, isWebOnly } from "@modern-js/utils";
 import path from "path";
-import { EffectAdapter } from "./runtime/effect/adapter.mjs";
 import { HonoAdapter } from "./runtime/hono/adapter.mjs";
-const RUNTIME_ADAPTER_FACTORIES = {
-    hono: [
-        (api)=>new HonoAdapter(api)
-    ],
-    effect: [
-        (api)=>new EffectAdapter(api)
-    ]
+const RUNTIME_ADAPTER_LOADERS = {
+    hono: async (api)=>[
+            new HonoAdapter(api)
+        ],
+    effect: async (api)=>{
+        const { EffectAdapter } = await import("./runtime/effect/adapter.mjs");
+        return [
+            new EffectAdapter(api)
+        ];
+    }
 };
 const normalizePrefixList = (prefix)=>{
     if (Array.isArray(prefix)) return prefix.filter(Boolean);
@@ -22,9 +24,6 @@ function resolveRuntimeFramework(runtimeFramework) {
     return 'hono' === runtimeFramework ? 'hono' : 'effect';
 }
 class Storage {
-    reset() {
-        this.middlewares = [];
-    }
     constructor(){
         this.middlewares = [];
     }
@@ -36,7 +35,6 @@ const server = ()=>({
             let apiRouter = null;
             const appContext = api.getServerContext();
             const runtimeFramework = resolveRuntimeFramework(appContext.bffRuntimeFramework);
-            const runtimeAdapters = RUNTIME_ADAPTER_FACTORIES[runtimeFramework].map((createAdapter)=>createAdapter(api));
             api.onPrepare(async ()=>{
                 const appContext = api.getServerContext();
                 const { render } = appContext;
@@ -82,29 +80,20 @@ const server = ()=>({
                         ]
                     });
                 }
+                const runtimeAdapters = await RUNTIME_ADAPTER_LOADERS[runtimeFramework](api);
                 await Promise.all(runtimeAdapters.map((adapter)=>adapter.registerMiddleware({
                         prefix,
                         enableHandleWeb
                     })));
             });
             api.onReset(async ({ event })=>{
-                storage.reset();
-                const appContext = api.getServerContext();
-                const { middlewares } = storage;
-                api.updateServerContext({
-                    ...appContext,
-                    apiMiddlewares: middlewares
-                });
-                if ('file-change' === event.type) {
-                    if ('hono' === runtimeFramework && apiRouter) {
-                        const apiHandlerInfos = await apiRouter.getApiHandlers();
-                        const appContext = api.getServerContext();
-                        api.updateServerContext({
-                            ...appContext,
-                            apiHandlerInfos
-                        });
-                    }
-                    await Promise.all(runtimeAdapters.map((adapter)=>adapter.onApiHandlersUpdated?.()));
+                if ('file-change' === event.type && apiRouter) {
+                    const appContext = api.getServerContext();
+                    const apiHandlerInfos = await apiRouter.getApiHandlers();
+                    api.updateServerContext({
+                        ...appContext,
+                        apiHandlerInfos
+                    });
                 }
             });
             const prepareApiServer = async (input, next)=>{

package/dist/esm/utils/client-generator/write-package.mjs

@@ -69,6 +69,6 @@ async function setPackage(files, appDirectory, relativeDistPath) {
         }
     });
     mergePackageJson(packageJson, addFiles, typesVersions, exports, relativeDistPath);
-    await fs.promises.writeFile(packagePath, JSON.stringify(packageJson, null, 2));
+    await fs.promises.writeFile(packagePath, `${JSON.stringify(packageJson, null, 2)}\n`);
 }
 export { setPackage, writeClientModuleBoundary };

package/dist/esm-node/runtime/effect/endpoint-contracts.mjs

@@ -1,6 +1,11 @@
 import "node:module";
 import { createOperationContractHash } from "@modern-js/bff-core";
 import { classifyEffectBffEntryModule, isValidatorAwareHandlerFactory } from "./entry-shape.mjs";
+function resolveEffectEndpointName(endpoint) {
+    if ('string' == typeof endpoint.identifier && endpoint.identifier) return endpoint.identifier;
+    if ('string' == typeof endpoint.name && endpoint.name) return endpoint.name;
+    return '';
+}
 function ensureLeadingSlash(pathname) {
     return pathname.startsWith('/') ? pathname : `/${pathname}`;
 }
@@ -29,7 +34,7 @@ function collectEffectEndpoints(reflect, api, prefix) {
             endpoints.push({
                 apiId,
                 groupName: String(group.identifier),
-                endpointName: String(endpoint.name),
+                endpointName: resolveEffectEndpointName(endpoint),
                 method: String(endpoint.method).toUpperCase(),
                 routePath: getEffectRoutePath(prefix, String(endpoint.path))
             });

package/dist/esm-node/runtime/hono/adapter.mjs

@@ -1,6 +1,5 @@
 import "node:module";
-import { Hono, run } from "@modern-js/server-core";
-import { isProd, logger } from "@modern-js/utils";
+import { logger } from "@modern-js/utils";
 import createHonoRoutes from "../../utils/createHonoRoutes.mjs";
 import { checkCrossProjectPolicyResponse, resolveAdapterCrossProjectPolicy } from "../../utils/crossProjectServerPolicy.mjs";
 import { createSafeFailureResponse } from "../safe-failure.mjs";
@@ -9,17 +8,9 @@ const before = [
     'custom-server-middleware',
     'render'
 ];
-const kParentHonoVars = Symbol.for('modernjs.hono.parentVars');
 class HonoAdapter {
-    wrapInArray(handler) {
-        if (Array.isArray(handler)) return handler;
-        return [
-            handler
-        ];
-    }
     constructor(api){
         this.apiMiddleware = [];
-        this.apiServer = null;
         this.isHono = true;
         this.prefix = '/api';
         this.setHandlers = async ()=>{
@@ -30,7 +21,7 @@ class HonoAdapter {
                     name: 'hono-bff-api',
                     path,
                     method,
-                    handler,
+                    handler: this.withErrorBoundary(handler),
                     order: 'post',
                     before: before
                 }));
@@ -51,85 +42,47 @@ class HonoAdapter {
                 });
             }
         };
-        this.registerApiRoutes = async ()=>{
-            if (!this.isHono) return;
-            this.apiServer = new Hono();
-            this.apiServer.use('*', run);
-            this.apiServer.use('*', async (c, next)=>{
-                const nodeReq = c.env?.node?.req;
-                const parentVars = nodeReq?.[kParentHonoVars];
-                if (parentVars && 'object' == typeof parentVars) {
-                    delete nodeReq[kParentHonoVars];
-                    for (const [key, value] of Object.entries(parentVars))if (void 0 === c.get(key)) c.set(key, value);
-                }
-                await next();
-            });
-            this.apiMiddleware.forEach(({ path = '*', method = 'all', handler })=>{
-                const handlers = this.wrapInArray(handler);
-                if (0 === handlers.length) return;
-                const firstHandler = handlers[0];
-                const restHandlers = handlers.slice(1);
-                const m = method;
-                const server = this.apiServer;
-                if (!server) return;
-                const register = server[m];
-                register.call(server, path, firstHandler, ...restHandlers);
-            });
-            this.apiServer.onError(async (err, c)=>{
-                try {
-                    const serverConfig = this.api.getServerConfig();
-                    const onErrorHandler = serverConfig?.onError;
-                    if (onErrorHandler) {
-                        const result = await onErrorHandler(err, c);
-                        if (result instanceof Response) return result;
-                    } else logger.error(err);
-                } catch (configError) {
-                    logger.error(`Error in serverConfig.onError handler: ${configError}`);
-                }
-                return createSafeFailureResponse(err);
-            });
-        };
-        this.registerMiddleware = async (options)=>{
-            const { prefix } = options;
+        this.registerMiddleware = async (options = {})=>{
             const { bffRuntimeFramework } = this.api.getServerContext();
             if ('hono' !== bffRuntimeFramework) {
                 this.isHono = false;
                 return;
             }
+            const { prefix } = options;
             this.prefix = prefix || this.prefix;
             const { middlewares: globalMiddlewares } = this.api.getServerContext();
             await this.setHandlers();
-            if (isProd()) globalMiddlewares.push(...this.apiMiddleware);
-            else {
-                await this.registerApiRoutes();
-                const dynamicApiMiddleware = {
-                    name: 'dynamic-bff-handler',
-                    path: `${prefix}/*`,
-                    method: 'all',
-                    order: 'post',
-                    before: before,
-                    handler: async (c, next)=>{
-                        if (this.apiServer) {
-                            const nodeReq = c.env?.node?.req;
-                            if (nodeReq) {
-                                const parentVars = c?.var;
-                                nodeReq[kParentHonoVars] = parentVars && 'object' == typeof parentVars ? {
-                                    ...parentVars
-                                } : parentVars;
-                            }
-                            const response = await this.apiServer.fetch(c.req.raw, c.env);
-                            if (404 !== response.status) return new Response(response.body, response);
-                        }
-                        await next();
-                    }
-                };
-                globalMiddlewares.push(dynamicApiMiddleware);
+            globalMiddlewares.push(...this.apiMiddleware);
+        };
+        this.handleRouteError = async (error, c)=>{
+            try {
+                const onErrorHandler = this.api.getServerConfig()?.onError;
+                if (onErrorHandler) {
+                    const result = await onErrorHandler(error, c);
+                    if (result instanceof Response) return result;
+                } else logger.error(error);
+            } catch (configError) {
+                logger.error(`Error in serverConfig.onError handler: ${configError}`);
             }
+            return createSafeFailureResponse(error);
         };
-        this.onApiHandlersUpdated = async ()=>{
-            if (!this.isHono) return;
-            await this.setHandlers();
-            await this.registerApiRoutes();
+        this.withErrorBoundary = (handler)=>{
+            const handlers = Array.isArray(handler) ? handler : [
+                handler
+            ];
+            const [firstHandler, ...restHandlers] = handlers;
+            if (!firstHandler) return handler;
+            const boundary = async (c, next)=>{
+                try {
+                    return await firstHandler(c, next);
+                } catch (error) {
+                    return this.handleRouteError(error, c);
+                }
+            };
+            return Array.isArray(handler) ? [
+                boundary,
+                ...restHandlers
+            ] : boundary;
         };
         this.api = api;
     }

package/dist/esm-node/server.mjs

@@ -2,15 +2,17 @@ import "node:module";
 import { ApiRouter } from "@modern-js/bff-core";
 import { API_DIR, isFunction, isWebOnly } from "@modern-js/utils";
 import path from "path";
-import { EffectAdapter } from "./runtime/effect/adapter.mjs";
 import { HonoAdapter } from "./runtime/hono/adapter.mjs";
-const RUNTIME_ADAPTER_FACTORIES = {
-    hono: [
-        (api)=>new HonoAdapter(api)
-    ],
-    effect: [
-        (api)=>new EffectAdapter(api)
-    ]
+const RUNTIME_ADAPTER_LOADERS = {
+    hono: async (api)=>[
+            new HonoAdapter(api)
+        ],
+    effect: async (api)=>{
+        const { EffectAdapter } = await import("./runtime/effect/adapter.mjs");
+        return [
+            new EffectAdapter(api)
+        ];
+    }
 };
 const normalizePrefixList = (prefix)=>{
     if (Array.isArray(prefix)) return prefix.filter(Boolean);
@@ -23,9 +25,6 @@ function resolveRuntimeFramework(runtimeFramework) {
     return 'hono' === runtimeFramework ? 'hono' : 'effect';
 }
 class Storage {
-    reset() {
-        this.middlewares = [];
-    }
     constructor(){
         this.middlewares = [];
     }
@@ -37,7 +36,6 @@ const server = ()=>({
             let apiRouter = null;
             const appContext = api.getServerContext();
             const runtimeFramework = resolveRuntimeFramework(appContext.bffRuntimeFramework);
-            const runtimeAdapters = RUNTIME_ADAPTER_FACTORIES[runtimeFramework].map((createAdapter)=>createAdapter(api));
             api.onPrepare(async ()=>{
                 const appContext = api.getServerContext();
                 const { render } = appContext;
@@ -83,29 +81,20 @@ const server = ()=>({
                         ]
                     });
                 }
+                const runtimeAdapters = await RUNTIME_ADAPTER_LOADERS[runtimeFramework](api);
                 await Promise.all(runtimeAdapters.map((adapter)=>adapter.registerMiddleware({
                         prefix,
                         enableHandleWeb
                     })));
             });
             api.onReset(async ({ event })=>{
-                storage.reset();
-                const appContext = api.getServerContext();
-                const { middlewares } = storage;
-                api.updateServerContext({
-                    ...appContext,
-                    apiMiddlewares: middlewares
-                });
-                if ('file-change' === event.type) {
-                    if ('hono' === runtimeFramework && apiRouter) {
-                        const apiHandlerInfos = await apiRouter.getApiHandlers();
-                        const appContext = api.getServerContext();
-                        api.updateServerContext({
-                            ...appContext,
-                            apiHandlerInfos
-                        });
-                    }
-                    await Promise.all(runtimeAdapters.map((adapter)=>adapter.onApiHandlersUpdated?.()));
+                if ('file-change' === event.type && apiRouter) {
+                    const appContext = api.getServerContext();
+                    const apiHandlerInfos = await apiRouter.getApiHandlers();
+                    api.updateServerContext({
+                        ...appContext,
+                        apiHandlerInfos
+                    });
                 }
             });
             const prepareApiServer = async (input, next)=>{

package/dist/esm-node/utils/client-generator/write-package.mjs

@@ -70,6 +70,6 @@ async function setPackage(files, appDirectory, relativeDistPath) {
         }
     });
     mergePackageJson(packageJson, addFiles, typesVersions, exports, relativeDistPath);
-    await fs.promises.writeFile(packagePath, JSON.stringify(packageJson, null, 2));
+    await fs.promises.writeFile(packagePath, `${JSON.stringify(packageJson, null, 2)}\n`);
 }
 export { setPackage, writeClientModuleBoundary };

package/dist/types/runtime/effect/endpoint-contracts.d.ts

@@ -25,6 +25,12 @@ type HttpApiGroupLike = {
     identifier?: unknown;
 };
 type HttpApiEndpointLike = {
+    /**
+     * effect 4.0.0-beta.98 renamed the endpoint `name` property to `identifier`,
+     * matching `HttpApiGroup`. `name` is kept as a fallback so reflection over an
+     * older Effect build does not silently degrade to the class name.
+     */
+    identifier?: unknown;
     name?: unknown;
     method?: unknown;
     path?: unknown;

package/dist/types/runtime/effect/handler/definition.d.ts

@@ -1,7 +1,7 @@
 import type { HttpApi } from 'effect/unstable/httpapi';
 import type { Rpc } from 'effect/unstable/rpc';
 import type { EffectBffRuntime, EffectDataPlatformValidationOptions, EffectRpcBffDefinition, EffectRpcBffHandlerFactory, EffectRpcRuntimeLayer, EffectRuntimeLayer } from './types';
-export declare function defineEffectBff<TApi extends HttpApi.AnyWithProps, TLayer extends EffectRuntimeLayer, TRpcs extends Rpc.Any = Rpc.Any>(definition: {
+export declare function defineEffectBff<TApi extends HttpApi.Constraint, TLayer extends EffectRuntimeLayer, TRpcs extends Rpc.Any = Rpc.Any>(definition: {
     api: TApi;
     layer: TLayer;
     rpc?: EffectRpcBffDefinition<TRpcs>;

package/dist/types/runtime/effect/handler/http.d.ts

@@ -1,7 +1,7 @@
 import type { HttpApi } from 'effect/unstable/httpapi';
 import type { Rpc } from 'effect/unstable/rpc';
 import type { EffectBffOpenApiConfig, EffectDataPlatformValidationOptions, EffectRequestValidator, EffectRpcBffDefinition, EffectRuntimeLayer } from './types';
-export declare function createHttpApiHandler<TApi extends HttpApi.AnyWithProps = HttpApi.AnyWithProps, TRpcs extends Rpc.Any = Rpc.Any>(options: {
+export declare function createHttpApiHandler<TApi extends HttpApi.Constraint = HttpApi.Top, TRpcs extends Rpc.Any = Rpc.Any>(options: {
     api: TApi;
     layer: EffectRuntimeLayer;
     openapi?: EffectBffOpenApiConfig;

package/dist/types/runtime/effect/handler/openapi.d.ts

@@ -1,4 +1,4 @@
 import { HttpRouter } from 'effect/unstable/http';
 import { type HttpApi } from 'effect/unstable/httpapi';
 import type { EffectBffOpenApiConfig } from './types';
-export declare function createOpenApiLayer(api: HttpApi.AnyWithProps, openapi: EffectBffOpenApiConfig | undefined): import("effect/Layer").Layer<never, never, HttpRouter.HttpRouter> | null;
+export declare function createOpenApiLayer(api: HttpApi.Constraint, openapi: EffectBffOpenApiConfig | undefined): import("effect/Layer").Layer<never, never, HttpRouter.HttpRouter> | null;

package/dist/types/runtime/effect/handler/types.d.ts

@@ -28,9 +28,9 @@ type EffectApiPromiseClient<TClient> = {
         [EndpointName in keyof TClient[GroupName]]: TClient[GroupName][EndpointName] extends (...args: infer TArgs) => infer TResult ? TResult extends EffectType.Effect<unknown, unknown, unknown> ? (...args: TArgs) => Promise<Exclude<EffectType.Success<TResult>, readonly [unknown, unknown]>> : never : never;
     };
 };
-export type EffectApiClientFromApi<TApi extends HttpApi.AnyWithProps = HttpApi.AnyWithProps> = TApi extends HttpApi.HttpApi<infer _ApiId, infer Groups> ? HttpApiClient.Client<Extract<Groups, HttpApiGroup.Any>, never, never> : never;
-export type EffectApiPromiseClientFromApi<TApi extends HttpApi.AnyWithProps = HttpApi.AnyWithProps> = EffectApiPromiseClient<EffectApiClientFromApi<TApi>>;
-export type EffectBffDefinition<TApi extends HttpApi.AnyWithProps = HttpApi.AnyWithProps, TLayer extends EffectRuntimeLayer = EffectRuntimeLayer, TRpcs extends Rpc.Any = Rpc.Any> = {
+export type EffectApiClientFromApi<TApi extends HttpApi.Constraint = HttpApi.Top> = TApi extends HttpApi.HttpApi<infer _ApiId, infer Groups> ? HttpApiClient.Client<Extract<Groups, HttpApiGroup.Constraint>, never, never> : never;
+export type EffectApiPromiseClientFromApi<TApi extends HttpApi.Constraint = HttpApi.Top> = EffectApiPromiseClient<EffectApiClientFromApi<TApi>>;
+export type EffectBffDefinition<TApi extends HttpApi.Constraint = HttpApi.Top, TLayer extends EffectRuntimeLayer = EffectRuntimeLayer, TRpcs extends Rpc.Any = Rpc.Any> = {
     api: TApi;
     layer: TLayer;
     rpc?: EffectRpcBffDefinition<TRpcs>;
@@ -131,13 +131,13 @@ export type EffectDataPlatformValidationOptions = {
  * cannot bypass it.
  */
 export type EffectRequestValidator = (request: Request) => Response | null | undefined;
-export type EffectBffHandlerFactory<TApi extends HttpApi.AnyWithProps = HttpApi.AnyWithProps, TLayer extends EffectRuntimeLayer = EffectRuntimeLayer> = (options?: {
+export type EffectBffHandlerFactory<TApi extends HttpApi.Constraint = HttpApi.Top, TLayer extends EffectRuntimeLayer = EffectRuntimeLayer> = (options?: {
     openapi?: EffectBffOpenApiConfig;
     rpc?: Partial<EffectRpcBffHandlerOptions>;
     dataPlatform?: Partial<EffectDataPlatformValidationOptions>;
     validateRequest?: EffectRequestValidator;
 }) => ReturnType<typeof createHttpApiHandler>;
-export type EffectBffRuntime<TApi extends HttpApi.AnyWithProps = HttpApi.AnyWithProps, TLayer extends EffectRuntimeLayer = EffectRuntimeLayer> = {
+export type EffectBffRuntime<TApi extends HttpApi.Constraint = HttpApi.Top, TLayer extends EffectRuntimeLayer = EffectRuntimeLayer> = {
     createHandler: EffectBffHandlerFactory<TApi, TLayer>;
     client: EffectApiPromiseClientFromApi<TApi>;
 };

package/dist/types/runtime/effect-client/index.d.ts

@@ -53,6 +53,6 @@ export type EffectRpcClientHandle<Rpcs extends Rpc.Any, Flatten extends boolean
 export declare function view<T>(): <const Selection extends EffectViewSelection<T>>(selection: Selection) => Selection;
 export declare function mask<T, const Selection extends EffectViewSelection<T>>(value: T, selection: Selection): EffectViewData<T, Selection>;
 export declare function runEffectView<T, const Selection extends EffectViewSelection<T>>(request: PromiseLike<T>, selection: Selection): Promise<EffectViewData<T, Selection>>;
-export declare function makeEffectHttpApiClient<ApiId extends string, Groups extends HttpApiGroup.Any>(api: HttpApi.HttpApi<ApiId, Groups>, options?: EffectHttpApiClientOptions): Effect.Effect<HttpApiClient.Client<Groups, never, never>, never, HttpApiGroup.MiddlewareClient<Groups>>;
+export declare function makeEffectHttpApiClient<ApiId extends string, Groups extends HttpApiGroup.Constraint>(api: HttpApi.HttpApi<ApiId, Groups>, options?: EffectHttpApiClientOptions): Effect.Effect<HttpApiClient.Client<Groups, never, never>, never, HttpApiGroup.MiddlewareClient<Groups>>;
 export declare function makeEffectRpcClient<Rpcs extends Rpc.Any, const Flatten extends boolean = false>(group: RpcGroup.RpcGroup<Rpcs>, options: EffectRpcClientOptions<Rpcs, Flatten>): Effect.Effect<EffectRpcClientHandle<Rpcs, Flatten>, EffectRpcClientError, never>;
 export declare const runEffectRequest: <A, E>(effect: Effect.Effect<A, E>, options?: Effect.RunOptions | undefined) => Promise<A>;

package/dist/types/runtime/hono/adapter.d.ts

@@ -1,22 +1,28 @@
-import type { MiddlewareHandler, ServerMiddleware, ServerPluginAPI } from '@modern-js/server-core';
-import { Hono } from '@modern-js/server-core';
+import type { ServerMiddleware, ServerPluginAPI } from '@modern-js/server-core';
 import { type ResolvedCrossProjectPolicy } from '../../utils/crossProjectServerPolicy';
 interface MiddlewareOptions {
-    prefix: string;
+    prefix?: string;
     enableHandleWeb?: boolean;
 }
 export declare class HonoAdapter {
     apiMiddleware: ServerMiddleware[];
-    apiServer: Hono | null;
     api: ServerPluginAPI;
     isHono: boolean;
     prefix: string;
     crossProjectPolicy: ResolvedCrossProjectPolicy | undefined;
     constructor(api: ServerPluginAPI);
     setHandlers: () => Promise<void>;
-    registerApiRoutes: () => Promise<void>;
-    registerMiddleware: (options: MiddlewareOptions) => Promise<void>;
-    onApiHandlersUpdated: () => Promise<void>;
-    wrapInArray(handler: MiddlewareHandler[] | MiddlewareHandler): MiddlewareHandler[];
+    /**
+     * Register the BFF API routes as ordinary server middlewares.
+     *
+     * Dev and prod now share this single path: the routes are pushed straight
+     * into the server's middleware list. In dev, hot updates are handled by the
+     * unified `@modern-js/server` runtime reload (which rebuilds the whole
+     * runtime — including this plugin — from scratch), so BFF no longer needs its
+     * own swappable Hono sub-app / dynamic dispatch middleware.
+     */
+    registerMiddleware: (options?: MiddlewareOptions) => Promise<void>;
+    private handleRouteError;
+    private withErrorBoundary;
 }
 export {};

package/package.json

@@ -17,7 +17,7 @@
     "modern",
     "modern.js"
   ],
-  "version": "3.5.0-ultramodern.97",
+  "version": "3.5.0-ultramodern.99",
   "types": "./dist/types/cli.d.ts",
   "main": "./dist/cjs/cli.js",
   "exports": {
@@ -153,13 +153,12 @@
     }
   },
   "dependencies": {
-    "@effect/opentelemetry": "4.0.0-beta.97",
-    "@modern-js/bff-core": "npm:@bleedingdev/modern-js-bff-core@3.5.0-ultramodern.97",
-    "@modern-js/builder": "npm:@bleedingdev/modern-js-builder@3.5.0-ultramodern.97",
-    "@modern-js/create-request": "npm:@bleedingdev/modern-js-create-request@3.5.0-ultramodern.97",
-    "@modern-js/server-core": "npm:@bleedingdev/modern-js-server-core@3.5.0-ultramodern.97",
-    "@modern-js/server-utils": "npm:@bleedingdev/modern-js-server-utils@3.5.0-ultramodern.97",
-    "@modern-js/utils": "npm:@bleedingdev/modern-js-utils@3.5.0-ultramodern.97",
+    "@modern-js/bff-core": "npm:@bleedingdev/modern-js-bff-core@3.5.0-ultramodern.99",
+    "@modern-js/builder": "npm:@bleedingdev/modern-js-builder@3.5.0-ultramodern.99",
+    "@modern-js/create-request": "npm:@bleedingdev/modern-js-create-request@3.5.0-ultramodern.99",
+    "@modern-js/server-core": "npm:@bleedingdev/modern-js-server-core@3.5.0-ultramodern.99",
+    "@modern-js/server-utils": "npm:@bleedingdev/modern-js-server-utils@3.5.0-ultramodern.99",
+    "@modern-js/utils": "npm:@bleedingdev/modern-js-utils@3.5.0-ultramodern.99",
     "@module-federation/runtime": "2.8.0",
     "@opentelemetry/api": "1.9.1",
     "@opentelemetry/api-logs": "0.220.0",
@@ -172,17 +171,29 @@
     "@opentelemetry/semantic-conventions": "1.43.0",
     "@swc/core": "1.15.43",
     "@swc/helpers": "^0.5.23",
-    "effect": "4.0.0-beta.97",
     "esbuild": "^0.28.1",
     "qs": "^6.15.3",
     "type-is": "^2.1.0"
   },
+  "peerDependencies": {
+    "@effect/opentelemetry": "4.0.0-beta.102",
+    "effect": "4.0.0-beta.102"
+  },
+  "peerDependenciesMeta": {
+    "@effect/opentelemetry": {
+      "optional": true
+    },
+    "effect": {
+      "optional": true
+    }
+  },
   "devDependencies": {
-    "@modern-js/app-tools": "npm:@bleedingdev/modern-js-app-tools@3.5.0-ultramodern.97",
-    "@modern-js/bff-runtime": "npm:@bleedingdev/modern-js-bff-runtime@3.5.0-ultramodern.97",
-    "@modern-js/plugin": "npm:@bleedingdev/modern-js-plugin@3.5.0-ultramodern.97",
-    "@modern-js/runtime": "npm:@bleedingdev/modern-js-runtime@3.5.0-ultramodern.97",
-    "@modern-js/types": "npm:@bleedingdev/modern-js-types@3.5.0-ultramodern.97",
+    "@effect/opentelemetry": "4.0.0-beta.102",
+    "@modern-js/app-tools": "npm:@bleedingdev/modern-js-app-tools@3.5.0-ultramodern.99",
+    "@modern-js/bff-runtime": "npm:@bleedingdev/modern-js-bff-runtime@3.5.0-ultramodern.99",
+    "@modern-js/plugin": "npm:@bleedingdev/modern-js-plugin@3.5.0-ultramodern.99",
+    "@modern-js/runtime": "npm:@bleedingdev/modern-js-runtime@3.5.0-ultramodern.99",
+    "@modern-js/types": "npm:@bleedingdev/modern-js-types@3.5.0-ultramodern.99",
     "@rsbuild/core": "2.1.5",
     "@rslib/core": "0.23.2",
     "@scripts/rstest-config": "2.66.0",
@@ -190,6 +201,7 @@
     "@types/qs": "^6.15.1",
     "@types/type-is": "^1.6.7",
     "@typescript/native-preview": "7.0.0-dev.20260707.2",
+    "effect": "4.0.0-beta.102",
     "memfs": "^4.64.0",
     "typescript": "^7.0.2",
     "zod": "^4.4.3"