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

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

@@ -1,12 +1,12 @@
 import "node:module";
-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-node/backend-federation-manifest/node.mjs

@@ -1,12 +1,12 @@
 import "node:module";
-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-node/{effect-adapter → effect-server}/cross-project-policy.mjs

@@ -3,7 +3,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)=>{
@@ -24,4 +24,4 @@ function resolveEffectAdapterCrossProjectPolicy(api, prefix, mod, producer) {
         return policy;
     });
 }
-export { resolveEffectAdapterCrossProjectPolicy };
+export { resolveEffectServerCrossProjectPolicy };

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

@@ -3,7 +3,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({
@@ -13,4 +13,4 @@ function resolveEffectAdapterEntryFile(api) {
         distDir: isProd() && distDirectory ? node_path.resolve(distDirectory) : void 0
     }).path;
 }
-export { resolveEffectAdapterEntryFile };
+export { resolveEffectServerEntryFile };

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

@@ -1,7 +1,7 @@
 import "node:module";
 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)=>{
@@ -35,4 +35,4 @@ function ensureJsonContext(context) {
         }
     });
 }
-export { createEffectAdapterRuntimeErrorResponse };
+export { createEffectServerRuntimeErrorResponse };

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

@@ -0,0 +1,152 @@
+import "node:module";
+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/types/backend-federation/node-evaluator.d.ts

@@ -0,0 +1,2 @@
+import { evaluateNodeBackendFederationCommonJs } from '@modern-js/server-runtime-extensions/backend-federation-security/node';
+export declare const evaluateEffectBackendFederationCommonJs: (source: Parameters<typeof evaluateNodeBackendFederationCommonJs>[0], context: Parameters<typeof evaluateNodeBackendFederationCommonJs>[1]) => Record<string, unknown>;

package/dist/types/{effect-adapter → effect-server}/cross-project-policy.d.ts

@@ -2,4 +2,4 @@ import { type EffectApiModule } from '@modern-js/bff-effect/effect';
 import type { ServerPluginAPI } from '@modern-js/server-core';
 import type { resolveOperationProducer } from '@modern-js/server-runtime-extensions/bff-policy/node';
 import type { ResolvedCrossProjectPolicy } from '../cross-project-policy/evaluation.js';
-export declare function resolveEffectAdapterCrossProjectPolicy(api: ServerPluginAPI, prefix: string, mod: EffectApiModule | null, producer?: ReturnType<typeof resolveOperationProducer>): Promise<ResolvedCrossProjectPolicy | undefined>;
+export declare function resolveEffectServerCrossProjectPolicy(api: ServerPluginAPI, prefix: string, mod: EffectApiModule | null, producer?: ReturnType<typeof resolveOperationProducer>): Promise<ResolvedCrossProjectPolicy | undefined>;

package/dist/types/{effect-adapter → effect-server}/entry.d.ts

@@ -1,3 +1,3 @@
 import '@modern-js/server-runtime-extensions/server-config';
 import type { ServerPluginAPI } from '@modern-js/server-core';
-export declare function resolveEffectAdapterEntryFile(api: ServerPluginAPI): string | undefined;
+export declare function resolveEffectServerEntryFile(api: ServerPluginAPI): string | undefined;

package/dist/types/effect-server/error-response.d.ts

@@ -0,0 +1,2 @@
+import type { Context, ServerPluginAPI } from '@modern-js/server-core';
+export declare function createEffectServerRuntimeErrorResponse(api: ServerPluginAPI, error: unknown, context: Context): Promise<Response>;

package/dist/types/effect-server/index.d.ts

@@ -0,0 +1,4 @@
+import '@modern-js/server-runtime-extensions/server-config';
+import type { ServerPlugin } from '@modern-js/server-core';
+export default _default;
+declare function _default(): ServerPlugin;

package/package.json

@@ -18,7 +18,7 @@
     "modern.js",
     "ultramodern.js"
   ],
-  "version": "3.9.0-ultramodern.12",
+  "version": "3.9.0-ultramodern.13",
   "files": [
     "dist",
     "src"
@@ -50,13 +50,13 @@
       },
       "default": "./dist/cjs/cross-project-generation/index.js"
     },
-    "./effect-adapter": {
-      "types": "./dist/types/effect-adapter/index.d.ts",
+    "./effect-server": {
+      "types": "./dist/types/effect-server/index.d.ts",
       "node": {
-        "import": "./dist/esm-node/effect-adapter/index.mjs",
-        "require": "./dist/cjs/effect-adapter/index.js"
+        "import": "./dist/esm-node/effect-server/index.mjs",
+        "require": "./dist/cjs/effect-server/index.js"
       },
-      "default": "./dist/cjs/effect-adapter/index.js"
+      "default": "./dist/cjs/effect-server/index.js"
     },
     "./effect-source-loader": {
       "types": "./dist/types/effect-source-loader/index.d.ts",
@@ -147,9 +147,9 @@
         "./dist/types/cross-project-generation/index.d.ts",
         "./src/cross-project-generation/index.ts"
       ],
-      "effect-adapter": [
-        "./dist/types/effect-adapter/index.d.ts",
-        "./src/effect-adapter/index.ts"
+      "effect-server": [
+        "./dist/types/effect-server/index.d.ts",
+        "./src/effect-server/index.ts"
       ],
       "effect-source-loader": [
         "./dist/types/effect-source-loader/index.d.ts",
@@ -193,21 +193,21 @@
     "node": ">=26.7.0"
   },
   "dependencies": {
-    "@modern-js/backend-federation-contracts": "npm:@bleedingdev/modern-js-backend-federation-contracts@3.9.0-ultramodern.12",
-    "@modern-js/bff-core": "npm:@bleedingdev/modern-js-bff-core@3.9.0-ultramodern.12",
-    "@modern-js/bff-effect": "npm:@bleedingdev/modern-js-bff-effect@3.9.0-ultramodern.12",
-    "@modern-js/runtime-extensions": "npm:@bleedingdev/modern-js-runtime-extensions@3.9.0-ultramodern.12",
-    "@modern-js/server-core": "npm:@bleedingdev/modern-js-server-core@3.9.0-ultramodern.12",
-    "@modern-js/server-runtime-extensions": "npm:@bleedingdev/modern-js-server-runtime-extensions@3.9.0-ultramodern.12",
-    "@modern-js/types": "npm:@bleedingdev/modern-js-types@3.9.0-ultramodern.12",
-    "@modern-js/utils": "npm:@bleedingdev/modern-js-utils@3.9.0-ultramodern.12",
-    "@module-federation/runtime": "2.9.0",
+    "@modern-js/backend-federation-contracts": "npm:@bleedingdev/modern-js-backend-federation-contracts@3.9.0-ultramodern.13",
+    "@modern-js/bff-core": "npm:@bleedingdev/modern-js-bff-core@3.9.0-ultramodern.13",
+    "@modern-js/bff-effect": "npm:@bleedingdev/modern-js-bff-effect@3.9.0-ultramodern.13",
+    "@modern-js/runtime-extensions": "npm:@bleedingdev/modern-js-runtime-extensions@3.9.0-ultramodern.13",
+    "@modern-js/server-core": "npm:@bleedingdev/modern-js-server-core@3.9.0-ultramodern.13",
+    "@modern-js/server-runtime-extensions": "npm:@bleedingdev/modern-js-server-runtime-extensions@3.9.0-ultramodern.13",
+    "@modern-js/types": "npm:@bleedingdev/modern-js-types@3.9.0-ultramodern.13",
+    "@modern-js/utils": "npm:@bleedingdev/modern-js-utils@3.9.0-ultramodern.13",
+    "@module-federation/runtime": "npm:@bleedingdev/mf-runtime@2.9.1",
     "@swc/core": "1.16.2",
     "esbuild": "^0.28.2"
   },
   "peerDependencies": {
-    "@effect/opentelemetry": "4.0.0-rc.112",
-    "effect": "4.0.0-rc.112"
+    "@effect/opentelemetry": "4.0.0-rc.117",
+    "effect": "4.0.0-rc.117"
   },
   "peerDependenciesMeta": {
     "@effect/opentelemetry": {
@@ -218,15 +218,15 @@
     }
   },
   "devDependencies": {
-    "@effect/opentelemetry": "4.0.0-rc.112",
-    "@modern-js/plugin": "npm:@bleedingdev/modern-js-plugin@3.9.0-ultramodern.12",
-    "@rsbuild/core": "2.2.3",
-    "@rslib/core": "1.0.0",
+    "@effect/opentelemetry": "4.0.0-rc.117",
+    "@modern-js/plugin": "npm:@bleedingdev/modern-js-plugin@3.9.0-ultramodern.13",
+    "@rsbuild/core": "2.2.9",
+    "@rslib/core": "1.0.2",
     "@scripts/rstest-config": "2.66.0",
-    "@types/node": "^26.4.1",
-    "@types/react": "^19.2.18",
+    "@types/node": "^26.6.2",
+    "@types/react": "^19.3.0",
     "@typescript/native-preview": "7.0.0-dev.20260707.2",
-    "effect": "4.0.0-rc.112"
+    "effect": "npm:@bleedingdev/effect@4.0.0-rc.117"
   },
   "sideEffects": false,
   "publishConfig": {

package/src/backend-federation/node-evaluator.ts

@@ -0,0 +1,13 @@
+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'}`);
+
+export const evaluateEffectBackendFederationCommonJs = (
+  source: Parameters<typeof evaluateNodeBackendFederationCommonJs>[0],
+  context: Parameters<typeof evaluateNodeBackendFederationCommonJs>[1],
+) => evaluateNodeBackendFederationCommonJs(source, context, privateRegistry);

package/src/backend-federation/node.ts

@@ -1,6 +1,5 @@
-import { evaluateNodeBackendFederationCommonJs } from '@modern-js/server-runtime-extensions/backend-federation-security/node';
-
 import { loadBackendFederatedEffectApi as loadUniversalBackendFederatedEffectApi } from './load';
+import { evaluateEffectBackendFederationCommonJs } from './node-evaluator';
 import type {
   BackendFederatedEffectApiModule,
   BackendFederationIdentityLoadOptions,
@@ -16,7 +15,7 @@ export function loadBackendFederatedEffectApi(
       ...options.entryPolicy,
       evaluateCommonJs:
         options.entryPolicy?.evaluateCommonJs ??
-        evaluateNodeBackendFederationCommonJs,
+        evaluateEffectBackendFederationCommonJs,
     },
   });
 }

package/src/backend-federation-manifest/node.ts

@@ -1,6 +1,5 @@
-import { evaluateNodeBackendFederationCommonJs } from '@modern-js/server-runtime-extensions/backend-federation-security/node';
-
 import type { BackendFederatedEffectApiModule } from '../backend-federation';
+import { evaluateEffectBackendFederationCommonJs } from '../backend-federation/node-evaluator';
 import { loadBackendFederatedEffectApiFromManifest as loadUniversalBackendFederatedEffectApiFromManifest } from './load';
 import type { BackendFederationManifestAdapterOptions } from './types';
 
@@ -13,7 +12,7 @@ export function loadBackendFederatedEffectApiFromManifest(
       ...options.entryPolicy,
       evaluateCommonJs:
         options.entryPolicy?.evaluateCommonJs ??
-        evaluateNodeBackendFederationCommonJs,
+        evaluateEffectBackendFederationCommonJs,
     },
   });
 }

package/src/{effect-adapter → effect-server}/cross-project-policy.ts

@@ -13,7 +13,7 @@ import { HttpApi } from 'effect/unstable/httpapi';
 import { resolveAdapterCrossProjectPolicy } from '../cross-project-policy';
 import type { ResolvedCrossProjectPolicy } from '../cross-project-policy/evaluation';
 
-export function resolveEffectAdapterCrossProjectPolicy(
+export function resolveEffectServerCrossProjectPolicy(
   api: ServerPluginAPI,
   prefix: string,
   mod: EffectApiModule | null,

package/src/{effect-adapter → effect-server}/entry.ts

@@ -5,7 +5,7 @@ import type { ServerPluginAPI } from '@modern-js/server-core';
 import { API_DIR, isProd } from '@modern-js/utils';
 import { resolveEffectEntry } from '../effect-source-loader/paths';
 
-export function resolveEffectAdapterEntryFile(api: ServerPluginAPI) {
+export function resolveEffectServerEntryFile(api: ServerPluginAPI) {
   const { appDirectory, apiDirectory, distDirectory } = api.getServerContext();
   const appDir = path.resolve(appDirectory || process.cwd());
   return resolveEffectEntry({

package/src/{effect-adapter → effect-server}/error-response.ts

@@ -2,7 +2,7 @@ import { createSafeFailureResponse } from '@modern-js/runtime-extensions/safe-fa
 import type { Context, ServerPluginAPI } from '@modern-js/server-core';
 import { logger } from '@modern-js/utils';
 
-export function createEffectAdapterRuntimeErrorResponse(
+export function createEffectServerRuntimeErrorResponse(
   api: ServerPluginAPI,
   error: unknown,
   context: Context,