@bleedingdev/modern-js-plugin-bff-extensions 3.9.0-ultramodern.12 → 3.9.0-ultramodern.13

package/README.md

@@ -1,7 +1,7 @@
 # @modern-js/plugin-bff-extensions
 
 Fork-owned integration extensions for UltraModern.js BFFs. This package keeps
-Effect adapter lifecycle integration, server source loading,
+Effect server lifecycle integration, server source loading,
 cross-project policy, Hono middleware, and backend federation out of the
 upstream-owned `@modern-js/plugin-bff` implementation.
 
@@ -12,7 +12,7 @@ upstream Modern.js project.
 ## Entry points
 
 - `/hono` exposes the peer-independent Hono route binder.
-- `/cross-project-policy`, `/effect-adapter`, and `/effect-source-loader` expose Node tooling and server integration.
+- `/cross-project-policy`, `/effect-server`, and `/effect-source-loader` expose Node tooling and server integration.
 - `/cross-project-generation` renders the generated producer client runtime
   consumed by `@modern-js/plugin-bff`.
 - `/backend-federation` exposes the portable federation runtime, while
@@ -32,7 +32,7 @@ upstream Modern.js project.
 Effect and its OpenTelemetry integration are exact-cohort optional peers. A
 Hono-only consumer can import `/hono` without installing Effect.
 
-There is deliberately no adapter-kit or re-export-only compatibility layer.
+There is deliberately no adapter registry or re-export-only compatibility layer.
 
 Effect server tooling derives operation-contract metadata without generating
 client code. Import shared `HttpApi` contracts in clients and use native

package/dist/cjs/backend-federation/node-evaluator.js

@@ -0,0 +1,48 @@
+"use strict";
+const __rslib_import_meta_url__ = /*#__PURE__*/ function() {
+    return "u" < typeof document ? new (require('url'.replace('', ''))).URL('file:' + __filename).href : document.currentScript && document.currentScript.src || new URL('main.js', document.baseURI).href;
+}();
+var __webpack_require__ = {};
+(()=>{
+    __webpack_require__.d = (exports1, getters, values)=>{
+        var define = (defs, kind)=>{
+            for(var key in defs)if (__webpack_require__.o(defs, key) && !__webpack_require__.o(exports1, key)) Object.defineProperty(exports1, key, {
+                enumerable: true,
+                [kind]: defs[key]
+            });
+        };
+        define(getters, "get");
+        define(values, "value");
+    };
+})();
+(()=>{
+    __webpack_require__.o = (obj, prop)=>Object.prototype.hasOwnProperty.call(obj, prop);
+})();
+(()=>{
+    __webpack_require__.r = (exports1)=>{
+        if ("u" > typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
+            value: 'Module'
+        });
+        Object.defineProperty(exports1, '__esModule', {
+            value: true
+        });
+    };
+})();
+var __webpack_exports__ = {};
+__webpack_require__.r(__webpack_exports__);
+__webpack_require__.d(__webpack_exports__, {
+    evaluateEffectBackendFederationCommonJs: ()=>evaluateEffectBackendFederationCommonJs
+});
+const external_node_module_namespaceObject = require("node:module");
+const node_namespaceObject = require("@modern-js/server-runtime-extensions/backend-federation-security/node");
+const fromAdapter = (0, external_node_module_namespaceObject.createRequire)(__rslib_import_meta_url__);
+const fromEffectPackage = (0, external_node_module_namespaceObject.createRequire)(fromAdapter.resolve('@modern-js/bff-effect/package.json'));
+const privateRegistry = fromEffectPackage("#effect-entry-shape-registry");
+const evaluateEffectBackendFederationCommonJs = (source, context)=>(0, node_namespaceObject.evaluateNodeBackendFederationCommonJs)(source, context, privateRegistry);
+exports.evaluateEffectBackendFederationCommonJs = __webpack_exports__.evaluateEffectBackendFederationCommonJs;
+for(var __rspack_i in __webpack_exports__)if (-1 === [
+    "evaluateEffectBackendFederationCommonJs"
+].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];
+Object.defineProperty(exports, '__esModule', {
+    value: true
+});

package/dist/cjs/backend-federation/node.js

@@ -30,14 +30,14 @@ __webpack_require__.r(__webpack_exports__);
 __webpack_require__.d(__webpack_exports__, {
     loadBackendFederatedEffectApi: ()=>loadBackendFederatedEffectApi
 });
-const node_namespaceObject = require("@modern-js/server-runtime-extensions/backend-federation-security/node");
 const external_load_js_namespaceObject = require("./load.js");
+const external_node_evaluator_js_namespaceObject = require("./node-evaluator.js");
 function loadBackendFederatedEffectApi(options) {
     return (0, external_load_js_namespaceObject.loadBackendFederatedEffectApi)({
         ...options,
         entryPolicy: {
             ...options.entryPolicy,
-            evaluateCommonJs: options.entryPolicy?.evaluateCommonJs ?? node_namespaceObject.evaluateNodeBackendFederationCommonJs
+            evaluateCommonJs: options.entryPolicy?.evaluateCommonJs ?? external_node_evaluator_js_namespaceObject.evaluateEffectBackendFederationCommonJs
         }
     });
 }

package/dist/cjs/backend-federation-manifest/node.js

@@ -30,14 +30,14 @@ __webpack_require__.r(__webpack_exports__);
 __webpack_require__.d(__webpack_exports__, {
     loadBackendFederatedEffectApiFromManifest: ()=>loadBackendFederatedEffectApiFromManifest
 });
-const node_namespaceObject = require("@modern-js/server-runtime-extensions/backend-federation-security/node");
+const node_evaluator_js_namespaceObject = require("../backend-federation/node-evaluator.js");
 const external_load_js_namespaceObject = require("./load.js");
 function loadBackendFederatedEffectApiFromManifest(options) {
     return (0, external_load_js_namespaceObject.loadBackendFederatedEffectApiFromManifest)({
         ...options,
         entryPolicy: {
             ...options.entryPolicy,
-            evaluateCommonJs: options.entryPolicy?.evaluateCommonJs ?? node_namespaceObject.evaluateNodeBackendFederationCommonJs
+            evaluateCommonJs: options.entryPolicy?.evaluateCommonJs ?? node_evaluator_js_namespaceObject.evaluateEffectBackendFederationCommonJs
         }
     });
 }

package/dist/cjs/{effect-adapter → effect-server}/cross-project-policy.js

@@ -28,13 +28,13 @@ var __webpack_require__ = {};
 var __webpack_exports__ = {};
 __webpack_require__.r(__webpack_exports__);
 __webpack_require__.d(__webpack_exports__, {
-    resolveEffectAdapterCrossProjectPolicy: ()=>resolveEffectAdapterCrossProjectPolicy
+    resolveEffectServerCrossProjectPolicy: ()=>resolveEffectServerCrossProjectPolicy
 });
 const effect_namespaceObject = require("@modern-js/bff-effect/effect");
 const utils_namespaceObject = require("@modern-js/utils");
 const httpapi_namespaceObject = require("effect/unstable/httpapi");
 const index_js_namespaceObject = require("../cross-project-policy/index.js");
-function resolveEffectAdapterCrossProjectPolicy(api, prefix, mod, producer) {
+function resolveEffectServerCrossProjectPolicy(api, prefix, mod, producer) {
     const contractSourcesPromise = null === mod ? Promise.resolve([]) : Promise.resolve().then(()=>(0, effect_namespaceObject.extractHttpApiFromModule)(mod, httpapi_namespaceObject.HttpApi.isHttpApi)).then((effectApi)=>{
         if (null === effectApi) return [];
         const reflect = (apiValue, handlers)=>{
@@ -55,9 +55,9 @@ function resolveEffectAdapterCrossProjectPolicy(api, prefix, mod, producer) {
         return policy;
     });
 }
-exports.resolveEffectAdapterCrossProjectPolicy = __webpack_exports__.resolveEffectAdapterCrossProjectPolicy;
+exports.resolveEffectServerCrossProjectPolicy = __webpack_exports__.resolveEffectServerCrossProjectPolicy;
 for(var __rspack_i in __webpack_exports__)if (-1 === [
-    "resolveEffectAdapterCrossProjectPolicy"
+    "resolveEffectServerCrossProjectPolicy"
 ].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];
 Object.defineProperty(exports, '__esModule', {
     value: true

package/dist/cjs/{effect-adapter → effect-server}/entry.js

@@ -37,14 +37,14 @@ var __webpack_require__ = {};
 var __webpack_exports__ = {};
 __webpack_require__.r(__webpack_exports__);
 __webpack_require__.d(__webpack_exports__, {
-    resolveEffectAdapterEntryFile: ()=>resolveEffectAdapterEntryFile
+    resolveEffectServerEntryFile: ()=>resolveEffectServerEntryFile
 });
 const external_node_path_namespaceObject = require("node:path");
 var external_node_path_default = /*#__PURE__*/ __webpack_require__.n(external_node_path_namespaceObject);
 require("@modern-js/server-runtime-extensions/server-config");
 const utils_namespaceObject = require("@modern-js/utils");
 const paths_js_namespaceObject = require("../effect-source-loader/paths.js");
-function resolveEffectAdapterEntryFile(api) {
+function resolveEffectServerEntryFile(api) {
     const { appDirectory, apiDirectory, distDirectory } = api.getServerContext();
     const appDir = external_node_path_default().resolve(appDirectory || process.cwd());
     return (0, paths_js_namespaceObject.resolveEffectEntry)({
@@ -54,9 +54,9 @@ function resolveEffectAdapterEntryFile(api) {
         distDir: (0, utils_namespaceObject.isProd)() && distDirectory ? external_node_path_default().resolve(distDirectory) : void 0
     }).path;
 }
-exports.resolveEffectAdapterEntryFile = __webpack_exports__.resolveEffectAdapterEntryFile;
+exports.resolveEffectServerEntryFile = __webpack_exports__.resolveEffectServerEntryFile;
 for(var __rspack_i in __webpack_exports__)if (-1 === [
-    "resolveEffectAdapterEntryFile"
+    "resolveEffectServerEntryFile"
 ].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];
 Object.defineProperty(exports, '__esModule', {
     value: true

package/dist/cjs/{effect-adapter → effect-server}/error-response.js

@@ -28,11 +28,11 @@ var __webpack_require__ = {};
 var __webpack_exports__ = {};
 __webpack_require__.r(__webpack_exports__);
 __webpack_require__.d(__webpack_exports__, {
-    createEffectAdapterRuntimeErrorResponse: ()=>createEffectAdapterRuntimeErrorResponse
+    createEffectServerRuntimeErrorResponse: ()=>createEffectServerRuntimeErrorResponse
 });
 const safe_failure_namespaceObject = require("@modern-js/runtime-extensions/safe-failure");
 const utils_namespaceObject = require("@modern-js/utils");
-function createEffectAdapterRuntimeErrorResponse(api, error, context) {
+function createEffectServerRuntimeErrorResponse(api, error, context) {
     try {
         const onError = api.getServerConfig()?.onError;
         if (void 0 !== onError) return Promise.resolve(onError(error instanceof Error ? error : new Error(String(error)), ensureJsonContext(context))).then((result)=>result instanceof Response ? result : (0, safe_failure_namespaceObject.createSafeFailureResponse)(error)).catch((configError)=>{
@@ -66,9 +66,9 @@ function ensureJsonContext(context) {
         }
     });
 }
-exports.createEffectAdapterRuntimeErrorResponse = __webpack_exports__.createEffectAdapterRuntimeErrorResponse;
+exports.createEffectServerRuntimeErrorResponse = __webpack_exports__.createEffectServerRuntimeErrorResponse;
 for(var __rspack_i in __webpack_exports__)if (-1 === [
-    "createEffectAdapterRuntimeErrorResponse"
+    "createEffectServerRuntimeErrorResponse"
 ].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];
 Object.defineProperty(exports, '__esModule', {
     value: true

package/dist/cjs/effect-server/index.js

@@ -0,0 +1,199 @@
+"use strict";
+var __webpack_require__ = {};
+(()=>{
+    __webpack_require__.n = (module)=>{
+        var getter = module && module.__esModule ? ()=>module['default'] : ()=>module;
+        __webpack_require__.d(getter, {
+            a: getter
+        });
+        return getter;
+    };
+})();
+(()=>{
+    __webpack_require__.d = (exports1, getters, values)=>{
+        var define = (defs, kind)=>{
+            for(var key in defs)if (__webpack_require__.o(defs, key) && !__webpack_require__.o(exports1, key)) Object.defineProperty(exports1, key, {
+                enumerable: true,
+                [kind]: defs[key]
+            });
+        };
+        define(getters, "get");
+        define(values, "value");
+    };
+})();
+(()=>{
+    __webpack_require__.o = (obj, prop)=>Object.prototype.hasOwnProperty.call(obj, prop);
+})();
+(()=>{
+    __webpack_require__.r = (exports1)=>{
+        if ("u" > typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
+            value: 'Module'
+        });
+        Object.defineProperty(exports1, '__esModule', {
+            value: true
+        });
+    };
+})();
+var __webpack_exports__ = {};
+__webpack_require__.r(__webpack_exports__);
+__webpack_require__.d(__webpack_exports__, {
+    default: ()=>effect_server
+});
+const external_node_path_namespaceObject = require("node:path");
+var external_node_path_default = /*#__PURE__*/ __webpack_require__.n(external_node_path_namespaceObject);
+require("@modern-js/server-runtime-extensions/server-config");
+const effect_namespaceObject = require("@modern-js/bff-effect/effect");
+const node_namespaceObject = require("@modern-js/server-runtime-extensions/bff-policy/node");
+const runtime_lifecycle_namespaceObject = require("@modern-js/server-runtime-extensions/runtime-lifecycle");
+const utils_namespaceObject = require("@modern-js/utils");
+const evaluation_js_namespaceObject = require("../cross-project-policy/evaluation.js");
+const loader_js_namespaceObject = require("../effect-source-loader/loader.js");
+const external_cross_project_policy_js_namespaceObject = require("./cross-project-policy.js");
+const external_entry_js_namespaceObject = require("./entry.js");
+const external_error_response_js_namespaceObject = require("./error-response.js");
+const EFFECT_MIDDLEWARE_BEFORE = [
+    'custom-server-hook',
+    'custom-server-middleware',
+    'render'
+];
+const effect_server = ()=>({
+        name: '@modern-js/plugin-bff-extensions/effect-server',
+        setup (api) {
+            const runtimeFramework = api.getServerContext().bffRuntimeFramework;
+            if ('effect' !== runtimeFramework) throw new Error(`Effect BFF server plugin requires Effect; received "${runtimeFramework}".`);
+            let handler = null;
+            let unregisterRuntimeDisposer;
+            let prefix = '/api';
+            let prefixes = [
+                '/api'
+            ];
+            let matchingPrefixes = [
+                '/api'
+            ];
+            let retired = false;
+            const dispose = async ()=>{
+                retired = true;
+                unregisterRuntimeDisposer?.();
+                unregisterRuntimeDisposer = void 0;
+                const previous = handler;
+                handler = null;
+                await previous?.dispose();
+            };
+            const loadHandler = async ()=>{
+                const entryFile = (0, external_entry_js_namespaceObject.resolveEffectServerEntryFile)(api);
+                if (!entryFile || !await utils_namespaceObject.fs.pathExists(entryFile)) {
+                    handler = null;
+                    return;
+                }
+                const { appDirectory } = api.getServerContext();
+                let mod;
+                try {
+                    mod = await ((0, utils_namespaceObject.isProd)() ? (0, loader_js_namespaceObject.loadEffectBuiltModule)(entryFile) : (0, loader_js_namespaceObject.loadEffectSourceModule)({
+                        resourcePath: entryFile,
+                        appDir: appDirectory || external_node_path_default().dirname(entryFile)
+                    }));
+                } catch (error) {
+                    utils_namespaceObject.logger.error(`[BFF][Effect] Failed to load Effect entry: ${entryFile}\n${String(error)}`);
+                    throw error;
+                }
+                const producer = (0, node_namespaceObject.resolveOperationProducer)({
+                    directories: [
+                        external_node_path_default().dirname(entryFile),
+                        appDirectory
+                    ],
+                    requestId: api.getServerConfig()?.bff?.requestId
+                });
+                const crossProjectPolicies = new Map(await Promise.all(prefixes.map(async (prefix)=>[
+                        prefix,
+                        await (0, external_cross_project_policy_js_namespaceObject.resolveEffectServerCrossProjectPolicy)(api, prefix, mod, producer)
+                    ])));
+                const effectConfig = api.getServerConfig()?.bff?.effect;
+                const loaded = await (0, effect_namespaceObject.resolveEffectBffModuleHandler)(mod, {
+                    openapi: effectConfig?.openapi,
+                    dataPlatform: effectConfig?.dataPlatform,
+                    validateRequest: (request)=>{
+                        const { path: mountedPathname } = (0, effect_namespaceObject.useEffectContext)();
+                        const prefix = matchingPrefixes.find((item)=>'/' === item || mountedPathname === item || mountedPathname.startsWith(`${item}/`));
+                        if (!prefix) return null;
+                        const requestUrl = new URL(request.url);
+                        if ('/' !== prefix) requestUrl.pathname = '/' === requestUrl.pathname ? prefix : `${prefix}${requestUrl.pathname}`;
+                        return (0, evaluation_js_namespaceObject.checkCrossProjectPolicyForRequest)(new Request(requestUrl, request), crossProjectPolicies.get(prefix));
+                    },
+                    onWarning: (message)=>utils_namespaceObject.logger.warn(message)
+                });
+                if (!loaded) {
+                    const error = new Error(`[BFF][Effect] Invalid Effect entry module: ${entryFile}. Export defineEffectBff(...) or a { api, layer } HttpApi module.`);
+                    utils_namespaceObject.logger.warn(error.message);
+                    throw error;
+                }
+                const candidateOwner = {};
+                if (loaded.dispose) (0, runtime_lifecycle_namespaceObject.registerServerRuntimeDisposer)(candidateOwner, loaded.dispose);
+                const candidate = (0, runtime_lifecycle_namespaceObject.createDisposableServerRuntimeHandle)(candidateOwner, loaded.handler);
+                if (retired) {
+                    await candidate.dispose();
+                    throw new Error('Cannot initialize a retired Effect server.');
+                }
+                handler = candidate;
+            };
+            api.onPrepare(async ()=>{
+                const { middlewares: globalMiddlewares } = api.getServerContext();
+                const configuredPrefix = api.getServerConfig()?.bff?.prefix;
+                const enableHandleWeb = api.getServerConfig()?.bff?.enableHandleWeb;
+                const configuredPrefixes = Array.isArray(configuredPrefix) ? configuredPrefix.filter(Boolean) : [
+                    configuredPrefix || '/api'
+                ];
+                prefixes = [
+                    ...new Set(configuredPrefixes.length > 0 ? configuredPrefixes : [
+                        '/api'
+                    ])
+                ];
+                matchingPrefixes = [
+                    ...prefixes
+                ].sort((left, right)=>right.length - left.length);
+                prefix = prefixes[0] || '/api';
+                const { serverBase } = api.getServerContext();
+                if (serverBase) unregisterRuntimeDisposer = (0, runtime_lifecycle_namespaceObject.registerServerRuntimeDisposer)(serverBase, dispose);
+                try {
+                    await loadHandler();
+                } catch (error) {
+                    await dispose();
+                    throw error;
+                }
+                const middlewarePrefixes = enableHandleWeb ? [
+                    prefix
+                ] : matchingPrefixes;
+                const middlewares = middlewarePrefixes.map((middlewarePrefix)=>({
+                        name: 'effect-api-handler',
+                        path: enableHandleWeb ? '*' : `${middlewarePrefix}/*`,
+                        method: 'all',
+                        order: 'post',
+                        before: EFFECT_MIDDLEWARE_BEFORE,
+                        handler: async (context, next)=>{
+                            const activeHandler = handler;
+                            if (!activeHandler) {
+                                if (enableHandleWeb) return void await next();
+                                return (0, external_error_response_js_namespaceObject.createEffectServerRuntimeErrorResponse)(api, new Error('[BFF][Effect] Missing Effect entry. Define api/index or configure bff.effect.entry.'), context);
+                            }
+                            const mountedPrefix = enableHandleWeb ? matchingPrefixes.find((item)=>'/' === item || context.req.path === item || context.req.path.startsWith(`${item}/`)) || prefix : middlewarePrefix;
+                            const response = await (0, effect_namespaceObject.dispatchEffectBffRequest)(activeHandler, context.req.raw, {
+                                prefix: mountedPrefix,
+                                env: context.env,
+                                path: context.req.path,
+                                method: context.req.method,
+                                onError: (error)=>(0, external_error_response_js_namespaceObject.createEffectServerRuntimeErrorResponse)(api, error, context)
+                            });
+                            if (404 === response.status && enableHandleWeb) return void await next();
+                            return new Response(response.body, response);
+                        }
+                    }));
+                globalMiddlewares.push(...middlewares);
+            });
+        }
+    });
+exports["default"] = __webpack_exports__["default"];
+for(var __rspack_i in __webpack_exports__)if (-1 === [
+    "default"
+].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];
+Object.defineProperty(exports, '__esModule', {
+    value: true
+});

package/dist/esm/backend-federation/node-evaluator.mjs

@@ -0,0 +1,7 @@
+import { createRequire } from "node:module";
+import { evaluateNodeBackendFederationCommonJs } from "@modern-js/server-runtime-extensions/backend-federation-security/node";
+const fromAdapter = createRequire(import.meta.url);
+const fromEffectPackage = createRequire(fromAdapter.resolve('@modern-js/bff-effect/package.json'));
+const privateRegistry = fromEffectPackage("#effect-entry-shape-registry");
+const evaluateEffectBackendFederationCommonJs = (source, context)=>evaluateNodeBackendFederationCommonJs(source, context, privateRegistry);
+export { evaluateEffectBackendFederationCommonJs };

package/dist/esm/backend-federation/node.mjs

@@ -1,11 +1,11 @@
-import { evaluateNodeBackendFederationCommonJs } from "@modern-js/server-runtime-extensions/backend-federation-security/node";
 import { loadBackendFederatedEffectApi } from "./load.mjs";
+import { evaluateEffectBackendFederationCommonJs } from "./node-evaluator.mjs";
 function node_loadBackendFederatedEffectApi(options) {
     return loadBackendFederatedEffectApi({
         ...options,
         entryPolicy: {
             ...options.entryPolicy,
-            evaluateCommonJs: options.entryPolicy?.evaluateCommonJs ?? evaluateNodeBackendFederationCommonJs
+            evaluateCommonJs: options.entryPolicy?.evaluateCommonJs ?? evaluateEffectBackendFederationCommonJs
         }
     });
 }

package/dist/esm/backend-federation-manifest/node.mjs

@@ -1,11 +1,11 @@
-import { evaluateNodeBackendFederationCommonJs } from "@modern-js/server-runtime-extensions/backend-federation-security/node";
+import { evaluateEffectBackendFederationCommonJs } from "../backend-federation/node-evaluator.mjs";
 import { loadBackendFederatedEffectApiFromManifest } from "./load.mjs";
 function node_loadBackendFederatedEffectApiFromManifest(options) {
     return loadBackendFederatedEffectApiFromManifest({
         ...options,
         entryPolicy: {
             ...options.entryPolicy,
-            evaluateCommonJs: options.entryPolicy?.evaluateCommonJs ?? evaluateNodeBackendFederationCommonJs
+            evaluateCommonJs: options.entryPolicy?.evaluateCommonJs ?? evaluateEffectBackendFederationCommonJs
         }
     });
 }

package/dist/esm/{effect-adapter → effect-server}/cross-project-policy.mjs

@@ -2,7 +2,7 @@ import { collectEffectEndpoints, extractHttpApiFromModule, toOperationContractSo
 import { logger } from "@modern-js/utils";
 import { HttpApi } from "effect/unstable/httpapi";
 import { resolveAdapterCrossProjectPolicy } from "../cross-project-policy/index.mjs";
-function resolveEffectAdapterCrossProjectPolicy(api, prefix, mod, producer) {
+function resolveEffectServerCrossProjectPolicy(api, prefix, mod, producer) {
     const contractSourcesPromise = null === mod ? Promise.resolve([]) : Promise.resolve().then(()=>extractHttpApiFromModule(mod, HttpApi.isHttpApi)).then((effectApi)=>{
         if (null === effectApi) return [];
         const reflect = (apiValue, handlers)=>{
@@ -23,4 +23,4 @@ function resolveEffectAdapterCrossProjectPolicy(api, prefix, mod, producer) {
         return policy;
     });
 }
-export { resolveEffectAdapterCrossProjectPolicy };
+export { resolveEffectServerCrossProjectPolicy };

package/dist/esm/{effect-adapter → effect-server}/entry.mjs

@@ -2,7 +2,7 @@ import node_path from "node:path";
 import "@modern-js/server-runtime-extensions/server-config";
 import { API_DIR, isProd } from "@modern-js/utils";
 import { resolveEffectEntry } from "../effect-source-loader/paths.mjs";
-function resolveEffectAdapterEntryFile(api) {
+function resolveEffectServerEntryFile(api) {
     const { appDirectory, apiDirectory, distDirectory } = api.getServerContext();
     const appDir = node_path.resolve(appDirectory || process.cwd());
     return resolveEffectEntry({
@@ -12,4 +12,4 @@ function resolveEffectAdapterEntryFile(api) {
         distDir: isProd() && distDirectory ? node_path.resolve(distDirectory) : void 0
     }).path;
 }
-export { resolveEffectAdapterEntryFile };
+export { resolveEffectServerEntryFile };

package/dist/esm/{effect-adapter → effect-server}/error-response.mjs

@@ -1,6 +1,6 @@
 import { createSafeFailureResponse } from "@modern-js/runtime-extensions/safe-failure";
 import { logger } from "@modern-js/utils";
-function createEffectAdapterRuntimeErrorResponse(api, error, context) {
+function createEffectServerRuntimeErrorResponse(api, error, context) {
     try {
         const onError = api.getServerConfig()?.onError;
         if (void 0 !== onError) return Promise.resolve(onError(error instanceof Error ? error : new Error(String(error)), ensureJsonContext(context))).then((result)=>result instanceof Response ? result : createSafeFailureResponse(error)).catch((configError)=>{
@@ -34,4 +34,4 @@ function ensureJsonContext(context) {
         }
     });
 }
-export { createEffectAdapterRuntimeErrorResponse };
+export { createEffectServerRuntimeErrorResponse };

package/dist/esm/effect-server/index.mjs

@@ -0,0 +1,151 @@
+import node_path from "node:path";
+import "@modern-js/server-runtime-extensions/server-config";
+import { dispatchEffectBffRequest, resolveEffectBffModuleHandler, useEffectContext } from "@modern-js/bff-effect/effect";
+import { resolveOperationProducer } from "@modern-js/server-runtime-extensions/bff-policy/node";
+import { createDisposableServerRuntimeHandle, registerServerRuntimeDisposer } from "@modern-js/server-runtime-extensions/runtime-lifecycle";
+import { fs, isProd, logger } from "@modern-js/utils";
+import { checkCrossProjectPolicyForRequest } from "../cross-project-policy/evaluation.mjs";
+import { loadEffectBuiltModule, loadEffectSourceModule } from "../effect-source-loader/loader.mjs";
+import { resolveEffectServerCrossProjectPolicy } from "./cross-project-policy.mjs";
+import { resolveEffectServerEntryFile } from "./entry.mjs";
+import { createEffectServerRuntimeErrorResponse } from "./error-response.mjs";
+const EFFECT_MIDDLEWARE_BEFORE = [
+    'custom-server-hook',
+    'custom-server-middleware',
+    'render'
+];
+const effect_server = ()=>({
+        name: '@modern-js/plugin-bff-extensions/effect-server',
+        setup (api) {
+            const runtimeFramework = api.getServerContext().bffRuntimeFramework;
+            if ('effect' !== runtimeFramework) throw new Error(`Effect BFF server plugin requires Effect; received "${runtimeFramework}".`);
+            let handler = null;
+            let unregisterRuntimeDisposer;
+            let prefix = '/api';
+            let prefixes = [
+                '/api'
+            ];
+            let matchingPrefixes = [
+                '/api'
+            ];
+            let retired = false;
+            const dispose = async ()=>{
+                retired = true;
+                unregisterRuntimeDisposer?.();
+                unregisterRuntimeDisposer = void 0;
+                const previous = handler;
+                handler = null;
+                await previous?.dispose();
+            };
+            const loadHandler = async ()=>{
+                const entryFile = resolveEffectServerEntryFile(api);
+                if (!entryFile || !await fs.pathExists(entryFile)) {
+                    handler = null;
+                    return;
+                }
+                const { appDirectory } = api.getServerContext();
+                let mod;
+                try {
+                    mod = await (isProd() ? loadEffectBuiltModule(entryFile) : loadEffectSourceModule({
+                        resourcePath: entryFile,
+                        appDir: appDirectory || node_path.dirname(entryFile)
+                    }));
+                } catch (error) {
+                    logger.error(`[BFF][Effect] Failed to load Effect entry: ${entryFile}\n${String(error)}`);
+                    throw error;
+                }
+                const producer = resolveOperationProducer({
+                    directories: [
+                        node_path.dirname(entryFile),
+                        appDirectory
+                    ],
+                    requestId: api.getServerConfig()?.bff?.requestId
+                });
+                const crossProjectPolicies = new Map(await Promise.all(prefixes.map(async (prefix)=>[
+                        prefix,
+                        await resolveEffectServerCrossProjectPolicy(api, prefix, mod, producer)
+                    ])));
+                const effectConfig = api.getServerConfig()?.bff?.effect;
+                const loaded = await resolveEffectBffModuleHandler(mod, {
+                    openapi: effectConfig?.openapi,
+                    dataPlatform: effectConfig?.dataPlatform,
+                    validateRequest: (request)=>{
+                        const { path: mountedPathname } = useEffectContext();
+                        const prefix = matchingPrefixes.find((item)=>'/' === item || mountedPathname === item || mountedPathname.startsWith(`${item}/`));
+                        if (!prefix) return null;
+                        const requestUrl = new URL(request.url);
+                        if ('/' !== prefix) requestUrl.pathname = '/' === requestUrl.pathname ? prefix : `${prefix}${requestUrl.pathname}`;
+                        return checkCrossProjectPolicyForRequest(new Request(requestUrl, request), crossProjectPolicies.get(prefix));
+                    },
+                    onWarning: (message)=>logger.warn(message)
+                });
+                if (!loaded) {
+                    const error = new Error(`[BFF][Effect] Invalid Effect entry module: ${entryFile}. Export defineEffectBff(...) or a { api, layer } HttpApi module.`);
+                    logger.warn(error.message);
+                    throw error;
+                }
+                const candidateOwner = {};
+                if (loaded.dispose) registerServerRuntimeDisposer(candidateOwner, loaded.dispose);
+                const candidate = createDisposableServerRuntimeHandle(candidateOwner, loaded.handler);
+                if (retired) {
+                    await candidate.dispose();
+                    throw new Error('Cannot initialize a retired Effect server.');
+                }
+                handler = candidate;
+            };
+            api.onPrepare(async ()=>{
+                const { middlewares: globalMiddlewares } = api.getServerContext();
+                const configuredPrefix = api.getServerConfig()?.bff?.prefix;
+                const enableHandleWeb = api.getServerConfig()?.bff?.enableHandleWeb;
+                const configuredPrefixes = Array.isArray(configuredPrefix) ? configuredPrefix.filter(Boolean) : [
+                    configuredPrefix || '/api'
+                ];
+                prefixes = [
+                    ...new Set(configuredPrefixes.length > 0 ? configuredPrefixes : [
+                        '/api'
+                    ])
+                ];
+                matchingPrefixes = [
+                    ...prefixes
+                ].sort((left, right)=>right.length - left.length);
+                prefix = prefixes[0] || '/api';
+                const { serverBase } = api.getServerContext();
+                if (serverBase) unregisterRuntimeDisposer = registerServerRuntimeDisposer(serverBase, dispose);
+                try {
+                    await loadHandler();
+                } catch (error) {
+                    await dispose();
+                    throw error;
+                }
+                const middlewarePrefixes = enableHandleWeb ? [
+                    prefix
+                ] : matchingPrefixes;
+                const middlewares = middlewarePrefixes.map((middlewarePrefix)=>({
+                        name: 'effect-api-handler',
+                        path: enableHandleWeb ? '*' : `${middlewarePrefix}/*`,
+                        method: 'all',
+                        order: 'post',
+                        before: EFFECT_MIDDLEWARE_BEFORE,
+                        handler: async (context, next)=>{
+                            const activeHandler = handler;
+                            if (!activeHandler) {
+                                if (enableHandleWeb) return void await next();
+                                return createEffectServerRuntimeErrorResponse(api, new Error('[BFF][Effect] Missing Effect entry. Define api/index or configure bff.effect.entry.'), context);
+                            }
+                            const mountedPrefix = enableHandleWeb ? matchingPrefixes.find((item)=>'/' === item || context.req.path === item || context.req.path.startsWith(`${item}/`)) || prefix : middlewarePrefix;
+                            const response = await dispatchEffectBffRequest(activeHandler, context.req.raw, {
+                                prefix: mountedPrefix,
+                                env: context.env,
+                                path: context.req.path,
+                                method: context.req.method,
+                                onError: (error)=>createEffectServerRuntimeErrorResponse(api, error, context)
+                            });
+                            if (404 === response.status && enableHandleWeb) return void await next();
+                            return new Response(response.body, response);
+                        }
+                    }));
+                globalMiddlewares.push(...middlewares);
+            });
+        }
+    });
+export default effect_server;

package/dist/esm-node/backend-federation/node-evaluator.mjs

@@ -0,0 +1,8 @@
+import "node:module";
+import { createRequire } from "node:module";
+import { evaluateNodeBackendFederationCommonJs } from "@modern-js/server-runtime-extensions/backend-federation-security/node";
+const fromAdapter = createRequire(import.meta.url);
+const fromEffectPackage = createRequire(fromAdapter.resolve('@modern-js/bff-effect/package.json'));
+const privateRegistry = fromEffectPackage("#effect-entry-shape-registry");
+const evaluateEffectBackendFederationCommonJs = (source, context)=>evaluateNodeBackendFederationCommonJs(source, context, privateRegistry);
+export { evaluateEffectBackendFederationCommonJs };