@bleedingdev/modern-js-plugin-bff-extensions 3.9.0-ultramodern.2 → 3.9.0-ultramodern.20

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/esm-node/{client-generator → effect-source-loader}/built-entry.mjs

@@ -1,12 +1,11 @@
 import "node:module";
 import { fs, upath } from "@modern-js/utils";
-import { resolveEffectEntryFile } from "./paths.mjs";
-const BUILT_ENTRY_EXT = /\.(?:[cm]?ts|tsx|jsx)$/u;
+import { emittedEffectEntry, relativeEffectAppPath, resolveEffectEntryFile } from "./paths.mjs";
 function resolveBuiltEffectEntry(appDirectory, distDirectory, sourceEntry) {
     if (void 0 === sourceEntry || 0 === sourceEntry.length) return;
-    const relativeEntry = upath.relative(appDirectory, sourceEntry);
-    if ('..' === relativeEntry || relativeEntry.startsWith(`..${upath.sep}`)) throw new Error(`Effect BFF entry must be inside the application directory: ${sourceEntry}`);
-    const builtEntry = upath.resolve(distDirectory, relativeEntry).replace(BUILT_ENTRY_EXT, '.js');
+    const relativeEntry = relativeEffectAppPath(appDirectory, sourceEntry);
+    if (void 0 === relativeEntry) throw new Error(`Effect BFF entry must be inside the application directory: ${sourceEntry}`);
+    const builtEntry = emittedEffectEntry(upath.resolve(distDirectory, relativeEntry));
     return fs.existsSync(builtEntry) ? builtEntry : void 0;
 }
 async function bundleBuiltEffectEntryForNode(options) {
@@ -18,7 +17,7 @@ async function bundleBuiltEffectEntryForNode(options) {
     });
     const builtEntry = resolveBuiltEffectEntry(appDir, distDir, sourceEntry);
     if (void 0 === builtEntry || 0 === builtEntry.length) throw new Error(`Effect BFF entry was not emitted into ${distDir}: ${sourceEntry ?? upath.resolve(apiDir, 'index')}`);
-    const { bundleEffectEntryForNode } = await import("../effect-source-loader/loader.mjs");
+    const { bundleEffectEntryForNode } = await import("./loader.mjs");
     return bundleEffectEntryForNode({
         appDir,
         entryPath: builtEntry,
@@ -32,7 +31,7 @@ function resolveEffectEntryPaths(options) {
         apiDir,
         effectEntry
     });
-    const relativeEffectEntry = void 0 !== sourceEffectEntry && sourceEffectEntry.length > 0 ? upath.relative(appDir, sourceEffectEntry).replace(BUILT_ENTRY_EXT, '.js') : '';
+    const relativeEffectEntry = void 0 !== sourceEffectEntry && sourceEffectEntry.length > 0 ? emittedEffectEntry(upath.relative(appDir, sourceEffectEntry)) : '';
     return {
         sourceEffectEntry,
         relativeEffectEntry

package/dist/esm-node/effect-source-loader/http-api-runtime.mjs

@@ -0,0 +1,20 @@
+import "node:module";
+import { extractHttpApiFromModule } from "@modern-js/bff-effect/effect";
+import { HttpApi } from "effect/unstable/httpapi";
+import { loadEffectSourceModule } from "./loader.mjs";
+function getHttpApiRuntime() {
+    return Promise.resolve({
+        isHttpApi: HttpApi.isHttpApi,
+        reflect: (api, handlers)=>{
+            if (!HttpApi.isHttpApi(api)) throw new TypeError('[BFF][Effect] Expected an HttpApi contract.');
+            HttpApi.reflect(api, {
+                onGroup: handlers.onGroup ?? (()=>{}),
+                onEndpoint: handlers.onEndpoint
+            });
+        }
+    });
+}
+function loadEffectApi(options) {
+    return getHttpApiRuntime().then((httpApiRuntime)=>loadEffectSourceModule(options).then((mod)=>extractHttpApiFromModule(mod, httpApiRuntime.isHttpApi)));
+}
+export { getHttpApiRuntime, loadEffectApi };

package/dist/esm-node/effect-source-loader/index.mjs

@@ -1,4 +1,7 @@
 import "node:module";
-export { resolveEffectEntryFile } from "../client-generator/paths.mjs";
+export { bundleBuiltEffectEntryForNode, resolveEffectEntryPaths } from "./built-entry.mjs";
 export { bundleEffectEntryForNode } from "./loader.mjs";
-export { generateEffectClientCode, generateEffectWorkerRuntimeWrapper } from "./worker-runtime-wrapper.mjs";
+export { resolveEffectOperationContracts } from "./operation-contracts.mjs";
+export { resolveEffectEntryFile } from "./paths.mjs";
+export { bundleEffectWorkerRuntimeSource } from "./worker-runtime-source.mjs";
+export { generateEffectWorkerRuntimeWrapper } from "./worker-runtime-wrapper.mjs";

package/dist/esm-node/effect-source-loader/loader.mjs

@@ -48,16 +48,18 @@ function preserveSourceModuleSemantics() {
         name: 'modern-js-effect-source-semantics',
         setup (buildApi) {
             buildApi.onLoad({
-                filter: /\.[cm]?[jt]sx?$/
+                filter: /\.[cm]?[jt]sx?$/,
+                namespace: 'file'
             }, async (args)=>{
                 const loader = sourceLoader(args);
                 if (!loader) return;
                 const source = await node_fs.promises.readFile(args.path, 'utf8');
+                const canonicalSourcePath = await node_fs.promises.realpath(args.path);
                 const compiled = await transform(source, {
                     define: {
-                        __dirname: JSON.stringify(node_path.dirname(args.path)),
-                        __filename: JSON.stringify(args.path),
-                        'import.meta.url': JSON.stringify(pathToFileURL(args.path).href)
+                        __dirname: JSON.stringify(node_path.dirname(canonicalSourcePath)),
+                        __filename: JSON.stringify(canonicalSourcePath),
+                        'import.meta.url': JSON.stringify(pathToFileURL(canonicalSourcePath).href)
                     },
                     jsx: 'automatic',
                     loader,
@@ -78,6 +80,7 @@ const nodeBuiltins = new Set([
     ...builtinModules.map((name)=>`node:${name}`)
 ]);
 const dependencyResolutionMarker = 'modern-js-effect-dependency-resolution';
+const BFF_RUNTIME_PACKAGE = /^@modern-js\/(?:bff-effect|plugin-bff)(?:\/|$)/;
 async function isEsmOnlyFile(filename) {
     const extension = node_path.extname(filename).toLowerCase();
     if ('.mjs' === extension || '.mts' === extension) return true;
@@ -100,13 +103,16 @@ function isBareSpecifier(specifier) {
     return !specifier.startsWith('.') && !specifier.startsWith('/') && !node_path.isAbsolute(specifier);
 }
 function externalizeInstalledDependencies(options) {
-    const runtimeRequire = createRequire(node_path.join(options.runtimeResolveDir, '__modern_effect_entry.cjs'));
     return {
         name: 'modern-js-effect-installed-dependencies',
         setup (buildApi) {
             buildApi.onResolve({
                 filter: /.*/
             }, async (args)=>{
+                if (BFF_RUNTIME_PACKAGE.test(args.path)) return {
+                    external: true,
+                    path: args.path
+                };
                 if (!isBareSpecifier(args.path) || nodeBuiltins.has(args.path) || args.pluginData?.[dependencyResolutionMarker] === true) return nodeBuiltins.has(args.path) ? {
                     external: true,
                     path: args.path
@@ -130,7 +136,8 @@ function externalizeInstalledDependencies(options) {
                     path: args.path
                 };
                 const realPath = await node_fs.promises.realpath(resolution.path).catch(()=>resolution.path);
-                if (realPath.includes(`${node_path.sep}node_modules${node_path.sep}`)) {
+                const loader = SOURCE_LOADERS.get(node_path.extname(realPath).toLowerCase());
+                if (realPath.includes(`${node_path.sep}node_modules${node_path.sep}`) && 'ts' !== loader && 'tsx' !== loader && 'jsx' !== loader) {
                     const runtimeResolution = await buildApi.resolve(args.path, {
                         importer: '',
                         kind: args.kind,
@@ -140,28 +147,10 @@ function externalizeInstalledDependencies(options) {
                         },
                         resolveDir: options.runtimeResolveDir
                     });
-                    if (0 === runtimeResolution.errors.length && runtimeResolution.path) {
-                        if ('cjs' === options.format) {
-                            let requiredPath;
-                            try {
-                                requiredPath = runtimeRequire.resolve(args.path);
-                            } catch  {
-                                requiredPath = runtimeResolution.path;
-                            }
-                            if (await isEsmOnlyFile(requiredPath)) return {
-                                namespace: resolution.namespace,
-                                path: resolution.path,
-                                pluginData: resolution.pluginData,
-                                sideEffects: resolution.sideEffects,
-                                suffix: resolution.suffix,
-                                warnings: resolution.warnings
-                            };
-                        }
-                        return {
-                            external: true,
-                            path: args.path
-                        };
-                    }
+                    if (0 === runtimeResolution.errors.length && runtimeResolution.path) return {
+                        external: true,
+                        path: args.path
+                    };
                 }
                 return {
                     namespace: resolution.namespace,
@@ -189,7 +178,6 @@ async function bundleEffectEntryForNode(options) {
         platform: 'node',
         plugins: [
             externalizeInstalledDependencies({
-                format: options.format,
                 runtimeResolveDir: options.appDir
             }),
             preserveSourceModuleSemantics()
@@ -263,7 +251,6 @@ async function loadEffectSourceModule(options) {
         platform: 'node',
         plugins: [
             externalizeInstalledDependencies({
-                format: 'esm',
                 runtimeResolveDir: appDir
             }),
             preserveSourceModuleSemantics()

package/dist/esm-node/effect-source-loader/operation-contracts.mjs

@@ -0,0 +1,23 @@
+import "node:module";
+import { collectEffectEndpoints, toOperationContractSources } from "@modern-js/bff-effect/effect";
+import { buildOperationContractMap, resolveOperationProducer } from "@modern-js/server-runtime-extensions/bff-policy/node";
+import { upath } from "@modern-js/utils";
+import { getHttpApiRuntime, loadEffectApi } from "./http-api-runtime.mjs";
+async function resolveEffectOperationContracts(options) {
+    const api = await loadEffectApi(options);
+    if (null === api) return null;
+    const runtime = await getHttpApiRuntime();
+    const endpoints = collectEffectEndpoints(runtime.reflect, api, options.prefix);
+    return buildOperationContractMap({
+        handlers: toOperationContractSources(endpoints),
+        ...resolveOperationProducer({
+            directories: [
+                upath.dirname(options.resourcePath),
+                options.appDir
+            ],
+            requestId: options.requestId,
+            onDependency: options.onDependency
+        })
+    });
+}
+export { resolveEffectOperationContracts };

package/dist/esm-node/effect-source-loader/paths.mjs

@@ -0,0 +1,44 @@
+import "node:module";
+import { findExists, fs, upath } from "@modern-js/utils";
+const JS_OR_TS_EXTS = [
+    '.js',
+    '.jsx',
+    '.ts',
+    '.tsx',
+    '.mjs',
+    '.mts',
+    '.cjs',
+    '.cts'
+];
+const emittedEffectEntry = (entry)=>entry.replace(/\.(?:[cm]?ts|tsx|jsx)$/u, '.js');
+function relativeEffectAppPath(appDir, entry) {
+    const relative = upath.relative(appDir, entry);
+    return '..' === relative || relative.startsWith('../') || relative.split('/').includes('node_modules') ? void 0 : relative;
+}
+function existingEntry(entry) {
+    return upath.extname(entry) ? fs.existsSync(entry) ? entry : void 0 : findExists(JS_OR_TS_EXTS.map((ext)=>`${entry}${ext}`)) || void 0;
+}
+function resolveEffectEntry(options) {
+    const { appDir, apiDir, effectEntry, distDir } = options;
+    const entry = upath.resolve(appDir, effectEntry || upath.join(apiDir, 'index'));
+    if (distDir && void 0 !== relativeEffectAppPath(distDir, entry)) return {
+        kind: 'built-output',
+        path: existingEntry(emittedEffectEntry(entry))
+    };
+    const relative = relativeEffectAppPath(appDir, entry);
+    if (void 0 === relative) return {
+        kind: 'external-sdk',
+        path: existingEntry(entry)
+    };
+    return distDir ? {
+        kind: 'built-output',
+        path: existingEntry(emittedEffectEntry(upath.resolve(distDir, relative)))
+    } : {
+        kind: 'app-source',
+        path: existingEntry(entry)
+    };
+}
+function resolveEffectEntryFile(options) {
+    return resolveEffectEntry(options).path;
+}
+export { emittedEffectEntry, relativeEffectAppPath, resolveEffectEntry, resolveEffectEntryFile };

package/dist/esm-node/effect-source-loader/rspack-loader.mjs

@@ -0,0 +1,37 @@
+import __rslib_shim_module__ from "node:module";
+const require = /*#__PURE__*/ __rslib_shim_module__.createRequire(/*#__PURE__*/ (()=>import.meta.url)());
+import { realpathSync } from "node:fs";
+import { bundleEffectWorkerRuntimeSource, generateEffectWorkerRuntimeWrapper, resolveEffectEntryFile } from "./index.mjs";
+async function loader(source) {
+    this.cacheable();
+    delete require.cache[this.resourcePath];
+    const callback = this.async();
+    try {
+        const options = this.getOptions();
+        const entry = resolveEffectEntryFile(options);
+        if (!entry || realpathSync(entry) !== realpathSync(this.resourcePath)) throw new Error(`Unexpected Effect BFF loader resource: ${this.resourcePath}`);
+        const query = new URLSearchParams(this.resourceQuery);
+        if (query.has('modern-bff-runtime-source')) {
+            const { transform } = await import("@swc/core");
+            const transformed = await transform(source, {
+                filename: this.resourcePath,
+                sourceMaps: false,
+                jsc: {
+                    parser: {
+                        syntax: "typescript",
+                        tsx: /\.[jt]sx$/.test(this.resourcePath)
+                    },
+                    target: 'es2024'
+                },
+                module: {
+                    type: 'es6'
+                }
+            });
+            callback(void 0, await bundleEffectWorkerRuntimeSource(transformed.code, this.resourcePath, this));
+        } else if (query.has('modern-bff-runtime')) callback(void 0, await generateEffectWorkerRuntimeWrapper(this, options, this.resourcePath));
+        else throw new Error('Effect BFF entries are server-only. Import the shared HttpApi contract and use HttpApiClient.make (or makeEffectHttpApiClient) for a fully inferred client.');
+    } catch (error) {
+        callback(error instanceof Error ? error : new Error(String(error)));
+    }
+}
+export default loader;

package/dist/esm-node/effect-source-loader/worker-runtime-source.mjs

@@ -0,0 +1,24 @@
+import "node:module";
+import node_path from "node:path";
+import { build } from "esbuild";
+async function bundleEffectWorkerRuntimeSource(source, resourcePath, loader) {
+    const result = await build({
+        absWorkingDir: node_path.dirname(resourcePath),
+        bundle: true,
+        format: 'esm',
+        metafile: true,
+        packages: 'external',
+        platform: 'neutral',
+        stdin: {
+            contents: source,
+            loader: 'js',
+            resolveDir: node_path.dirname(resourcePath),
+            sourcefile: resourcePath
+        },
+        target: 'es2024',
+        write: false
+    });
+    for (const dependency of Object.keys(result.metafile.inputs))if ('<stdin>' !== dependency) loader.addDependency(node_path.resolve(node_path.dirname(resourcePath), dependency));
+    return result.outputFiles[0].text;
+}
+export { bundleEffectWorkerRuntimeSource };

package/dist/esm-node/effect-source-loader/worker-runtime-wrapper.mjs

@@ -1,57 +1,17 @@
 import "node:module";
+import { resolveEffectOperationContracts } from "./operation-contracts.mjs";
 async function generateEffectWorkerRuntimeWrapper(loader, options, resourcePath) {
-    const { generateEffectClient } = await import("../client-generator/generator.mjs");
-    const artifacts = await generateEffectClient({
+    const operationContracts = await resolveEffectOperationContracts({
         appDir: options.appDir,
-        apiDir: options.apiDir,
         resourcePath,
         prefix: options.prefix,
-        port: Number(options.port),
-        target: 'bundle',
         requestId: options.requestId,
-        requestCreator: options.requestCreator,
-        httpMethodDecider: options.httpMethodDecider,
-        dataPlatformBatch: options.effectDataPlatformBatch,
         onDependency: (dependency)=>loader.addDependency(dependency)
     });
     const sourceRequest = `${resourcePath}?modern-bff-runtime-source`;
-    const operationContracts = artifacts?.operationContracts ?? {};
     return `import * as effectBffModule from ${JSON.stringify(sourceRequest)};
-import { createEffectBffEdgeDispatcher } from '@modern-js/plugin-bff/effect-edge/dispatcher';
-
-const __generatedOperationContracts = ${JSON.stringify(operationContracts)};
-
-const __mergeGeneratedOperationContracts = policy => {
-  if (
-    !policy ||
-    !policy.expectedOperationContracts ||
-    typeof policy.expectedOperationContracts !== 'object' ||
-    Array.isArray(policy.expectedOperationContracts)
-  ) {
-    return policy;
-  }
-  return {
-    ...policy,
-    expectedOperationContracts: {
-      ...policy.expectedOperationContracts,
-      ...__generatedOperationContracts,
-    },
-  };
-};
-
-export const __modern_create_effect_bff_dispatcher = options =>
-  createEffectBffEdgeDispatcher({
-    ...options,
-    crossProjectPolicy: __mergeGeneratedOperationContracts(
-      options?.crossProjectPolicy,
-    ),
-    module: effectBffModule,
-  });
+import { createEffectBffEdgeDispatcherFactory } from '@modern-js/bff-effect/effect-edge';
+export const __modern_create_effect_bff_dispatcher = createEffectBffEdgeDispatcherFactory(effectBffModule, ${JSON.stringify(operationContracts ?? {})});
 `;
 }
-async function generateEffectClientCode(options) {
-    const { generateEffectClient } = await import("../client-generator/generator.mjs");
-    const artifacts = await generateEffectClient(options);
-    return null === artifacts ? null : artifacts.code;
-}
-export { generateEffectClientCode, generateEffectWorkerRuntimeWrapper };
+export { generateEffectWorkerRuntimeWrapper };

package/dist/esm-node/hono/cross-project-policy.mjs

@@ -6,6 +6,7 @@ const createHonoCrossProjectPolicyMiddleware = (policy, routePath)=>async functi
             routePath
         });
         if (denial) return denial;
-        return next();
+        const result = await next();
+        return result instanceof Response ? result : void 0;
     };
 export { createHonoCrossProjectPolicyMiddleware };

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

@@ -0,0 +1,14 @@
+import "node:module";
+import { logger } from "@modern-js/utils";
+import { resolveAdapterCrossProjectPolicy } from "../cross-project-policy/node.mjs";
+import { bindHonoRouteHandlers } from "./bind-route-handlers.mjs";
+const createHonoRouteBinder = (api, handlers)=>{
+    const policy = resolveAdapterCrossProjectPolicy(api, handlers);
+    return (options)=>bindHonoRouteHandlers({
+            ...options,
+            policy,
+            onError: api.getServerConfig()?.onError,
+            reportError: (error)=>logger.error(error)
+        });
+};
+export { createHonoRouteBinder };

package/dist/types/backend-federation/edge-runtime.d.ts

@@ -33,14 +33,9 @@ type BackendFederationEdgeRuntimeBaseOptions = {
 export type BackendFederationEdgeRuntimeOptions = BackendFederationEdgeRuntimeBaseOptions & {
     expected: BackendFederationExpectedIdentity;
 };
-type EdgeRuntimeLoadOptions = BackendFederationEdgeRuntimeBaseOptions & {
-    allowMissingIdentityMetadata?: boolean;
-    expected?: BackendFederationExpectedIdentity;
-};
 export type BackendFederationEdgeRuntime = {
     loadRemote<T>(request: string): Promise<T>;
 };
 export declare function createBackendFederationLoadEntryPlugin(options: BackendFederationEdgeLoadEntryPluginOptions): BackendFederationEdgeLoadEntryPlugin;
 export declare function createBackendFederationRuntime(options: BackendFederationEdgeRuntimeOptions): BackendFederationEdgeRuntime;
-export declare function createBackendFederationRuntimeForLoad(options: EdgeRuntimeLoadOptions): BackendFederationEdgeRuntime;
 export {};

package/dist/types/backend-federation/edge.d.ts

@@ -1,4 +1,4 @@
-import { BACKEND_FEDERATION_CONTRACT_VERSION, BACKEND_FEDERATION_EFFECT_EXPOSE, BACKEND_FEDERATION_MANIFEST_FILE, BACKEND_FEDERATION_NODE_ADAPTER_VERSION } from '@modern-js/utils/universal';
+import { BACKEND_FEDERATION_CONTRACT_VERSION, BACKEND_FEDERATION_EFFECT_EXPOSE, BACKEND_FEDERATION_MANIFEST_FILE, BACKEND_FEDERATION_NODE_ADAPTER_VERSION } from '@modern-js/backend-federation-contracts';
 import { type BackendFederationEdgeLoadEntryPlugin, type BackendFederationEdgeLoadEntryPluginOptions, type BackendFederationEdgeRemote, type BackendFederationEdgeRuntimeOptions } from './edge-runtime.js';
 import type { BackendFederatedEffectApiModule, BackendFederationLoadOptions, BackendFederationIdentityLoadOptions as UniversalBackendFederationIdentityLoadOptions } from './types.js';
 export { type BackendFederationEdgeLoadEntryPlugin, type BackendFederationEdgeLoadEntryPluginOptions, type BackendFederationEdgeRemote, type BackendFederationEdgeRuntime, type BackendFederationEdgeRuntimeOptions, createBackendFederationLoadEntryPlugin, createBackendFederationRuntime, } from './edge-runtime.js';
@@ -8,21 +8,21 @@ export { BACKEND_FEDERATION_CONTRACT_VERSION, BACKEND_FEDERATION_EFFECT_EXPOSE,
 export type BackendFederationRemote = BackendFederationEdgeRemote;
 export type BackendFederationRuntimeOptions = BackendFederationEdgeRuntimeOptions;
 export type BackendFederationLoadEntryPluginOptions = BackendFederationEdgeLoadEntryPluginOptions;
-export type EdgeBackendFederationLoadOptions = Omit<BackendFederationLoadOptions, 'entryPolicy' | 'plugins' | 'remote' | 'remotes' | 'runtime'> & {
+export type EdgeBackendFederationLoadOptions = Omit<BackendFederationLoadOptions, 'entryPolicy' | 'plugins' | 'remote' | 'remotes' | 'runtime' | 'shared'> & {
     entryPolicy?: never;
     plugins?: BackendFederationEdgeLoadEntryPlugin[];
     remote?: BackendFederationEdgeRemote;
     remotes?: BackendFederationEdgeRemote[];
     runtime?: never;
+    shared?: never;
 };
-export type EdgeBackendFederationIdentityLoadOptions = Omit<UniversalBackendFederationIdentityLoadOptions, 'entryPolicy' | 'plugins' | 'remote' | 'remotes' | 'runtime'> & {
+export type EdgeBackendFederationIdentityLoadOptions = Omit<UniversalBackendFederationIdentityLoadOptions, 'entryPolicy' | 'plugins' | 'remote' | 'remotes' | 'runtime' | 'shared'> & {
     entryPolicy?: never;
     plugins?: BackendFederationEdgeLoadEntryPlugin[];
     remote?: BackendFederationEdgeRemote;
     remotes?: BackendFederationEdgeRemote[];
     runtime?: never;
+    shared?: never;
 };
 export type BackendFederationIdentityLoadOptions = EdgeBackendFederationIdentityLoadOptions;
 export declare function loadBackendFederatedEffectApi(options: EdgeBackendFederationIdentityLoadOptions): Promise<BackendFederatedEffectApiModule>;
-/** @deprecated Pass `expected` delivery-unit identity. */
-export declare function loadBackendFederatedEffectApi(options: EdgeBackendFederationLoadOptions): Promise<BackendFederatedEffectApiModule>;

package/dist/types/backend-federation/identity.d.ts

@@ -11,20 +11,8 @@ export type BackendFederationIdentityIssue = {
     path: string;
     message: string;
 };
-/**
- * Shared expected-identity validation for loaded backend federation modules.
- * Compares the expose's `backendFederationContract.compatibility` identity
- * (`unitId`, `build`) against the consumer's expected delivery-unit identity.
- * Missing identity metadata is an error: with an expectation present there is
- * no legacy escape hatch.
- */
-export declare function validateExpectedBackendFederationIdentity(loaded: unknown, expected: BackendFederationExpectedIdentity, options?: {
-    /**
-     * Tolerate exposes that declare no identity metadata (legacy modules).
-     * Mismatching declared values still fail. Used by the manifest adapter,
-     * whose manifest-side identity is already validated against `expected`;
-     * the raw identity-aware loader is strict.
-     */
-    allowMissingIdentityMetadata?: boolean;
-}): BackendFederationIdentityIssue[];
+/** Decode independently at each received-manifest / executed-expose boundary. */
+export declare function backendFederationCompatibility(loaded: unknown): Record<string, unknown> | undefined;
+export declare function validateBackendFederationCompatibility(compatibility: Record<string, unknown>, expected: Record<string, string | undefined>): BackendFederationIdentityIssue[];
+export declare function validateExpectedBackendFederationIdentity(loaded: unknown, expected: BackendFederationExpectedIdentity): BackendFederationIdentityIssue[];
 export declare function formatBackendFederationIdentityIssues(issues: BackendFederationIdentityIssue[]): string;

package/dist/types/backend-federation/index.d.ts

@@ -1,4 +1,4 @@
-import { BACKEND_FEDERATION_CONTRACT_VERSION, BACKEND_FEDERATION_EFFECT_EXPOSE, BACKEND_FEDERATION_MANIFEST_FILE, BACKEND_FEDERATION_NODE_ADAPTER_VERSION } from '@modern-js/utils/universal';
+import { BACKEND_FEDERATION_CONTRACT_VERSION, BACKEND_FEDERATION_EFFECT_EXPOSE, BACKEND_FEDERATION_MANIFEST_FILE, BACKEND_FEDERATION_NODE_ADAPTER_VERSION } from '@modern-js/backend-federation-contracts';
 export { type BackendFederationExpectedIdentity, type BackendFederationIdentityIssue, validateExpectedBackendFederationIdentity, } from './identity.js';
 export { createBackendFederationLoadEntryPlugin } from './plugin.js';
 export { createBackendFederationRuntime } from './runtime.js';

package/dist/types/backend-federation/integrity-plugin.d.ts

@@ -0,0 +1,13 @@
+import { Module, type ModuleFederation, type ModuleFederationRuntimePlugin } from '@module-federation/runtime';
+import type { BackendFederationEntryExports, BackendFederationRemote, BackendFederationRuntimeOptions } from './types.js';
+type RemoteInfo = ConstructorParameters<typeof Module>[0]['remoteInfo'];
+export declare const PROVIDED_ENTRY_SCHEME: RegExp;
+export declare function registerRemoteContainer(origin: ModuleFederation, remoteInfo: RemoteInfo, container: BackendFederationEntryExports): void;
+/**
+ * Loads each configured remote once per runtime and registers the resulting
+ * container with that runtime only, so Module Federation initializes it with
+ * the runtime's own share scope. Registered last, it replaces any container a
+ * caller plugin supplied for a scheme it owns.
+ */
+export declare function createBackendFederationIntegrityPlugin(options: BackendFederationRuntimeOptions, remotes: readonly BackendFederationRemote[]): ModuleFederationRuntimePlugin;
+export {};