@module-federation/rsbuild-plugin 2.0.1 → 2.1.0

package/README.md

@@ -34,6 +34,53 @@ export default defineConfig({
 });
 ```
 
+### Rsbuild App SSR (Node target with custom environment)
+
+Use `target: 'node'` with an explicit `environment` to apply federation to a
+specific Rsbuild app environment (for example `ssr`).
+
+```ts
+import { pluginModuleFederation } from '@module-federation/rsbuild-plugin';
+import { defineConfig } from '@rsbuild/core';
+
+export default defineConfig({
+  environments: {
+    client: {},
+    ssr: {},
+  },
+  plugins: [
+    pluginModuleFederation(
+      {
+        name: 'host',
+        remotes: {
+          remote: 'remote@http://localhost:3001/mf-manifest.json',
+        },
+      },
+      {
+        target: 'node',
+        environment: 'ssr',
+      },
+    ),
+  ],
+});
+```
+
+`target: 'dual'` support remains scoped to Rslib/Rspress workflows.
+
+### Default environment detection
+
+If `environment` is omitted, the plugin will choose a default per tool:
+
+- **Rslib**: `mf`
+- **Rsbuild app**:
+  - `target: 'web'` → `web`
+  - `target: 'node'` → `node`
+- **Rspress**:
+  - `target: 'web'` → `web`
+  - `target: 'node'` → `node`
+
+You can still override with `environment` when your project uses custom names.
+
 ### Rslib Module
 
 ```js

package/dist/cli/index.js

@@ -97,6 +97,23 @@ const LIB_FORMAT = [
     'modern-module'
 ];
 const DEFAULT_MF_ENVIRONMENT_NAME = 'mf';
+const DEFAULT_WEB_ENVIRONMENT_NAME = 'web';
+const DEFAULT_NODE_ENVIRONMENT_NAME = 'node';
+const resolveDefaultEnvironmentName = ({ callerName, target })=>{
+    if (callerName === external_constant_js_namespaceObject.CALL_NAME_MAP.RSLIB) {
+        return DEFAULT_MF_ENVIRONMENT_NAME;
+    }
+    if (callerName === external_constant_js_namespaceObject.CALL_NAME_MAP.RSPRESS) {
+        if (target === 'node') {
+            return DEFAULT_NODE_ENVIRONMENT_NAME;
+        }
+        return DEFAULT_WEB_ENVIRONMENT_NAME;
+    }
+    if (target === 'node') {
+        return DEFAULT_NODE_ENVIRONMENT_NAME;
+    }
+    return DEFAULT_WEB_ENVIRONMENT_NAME;
+};
 function isStoryBook(rsbuildConfig) {
     var _rsbuildConfig_plugins;
     if ((_rsbuildConfig_plugins = rsbuildConfig.plugins) === null || _rsbuildConfig_plugins === void 0 ? void 0 : _rsbuildConfig_plugins.find((p)=>p && 'name' in p && p.name === 'module-federation-storybook-plugin')) {
@@ -123,7 +140,10 @@ const isRspressSSGConfig = (bundlerConfigName)=>{
 const pluginModuleFederation = (moduleFederationOptions, rsbuildOptions)=>({
         name: RSBUILD_PLUGIN_MODULE_FEDERATION_NAME,
         setup: (api)=>{
-            const { target = 'web', ssr = undefined, ssrDir = external_utils_js_namespaceObject.SSR_DIR, environment = DEFAULT_MF_ENVIRONMENT_NAME } = rsbuildOptions || {};
+            if (!(moduleFederationOptions === null || moduleFederationOptions === void 0 ? void 0 : moduleFederationOptions.name)) {
+                throw new Error('The module federation option "name" is required in @module-federation/rsbuild-plugin.');
+            }
+            const { target = 'web', ssr = undefined, ssrDir = external_utils_js_namespaceObject.SSR_DIR, environment: configuredEnvironment } = rsbuildOptions || {};
             if (ssr) {
                 throw new Error("The `ssr` option is deprecated. If you want to enable SSR, please use `target: 'dual'` instead.");
             }
@@ -135,6 +155,10 @@ const pluginModuleFederation = (moduleFederationOptions, rsbuildOptions)=>({
             const isRslib = callerName === external_constant_js_namespaceObject.CALL_NAME_MAP.RSLIB;
             const isRspress = callerName === external_constant_js_namespaceObject.CALL_NAME_MAP.RSPRESS;
             const isSSR = target === 'dual';
+            const environment = configuredEnvironment ?? resolveDefaultEnvironmentName({
+                callerName,
+                target
+            });
             if (isSSR && !isStoryBook(originalRsbuildConfig)) {
                 var _rsbuildConfig_environments;
                 if (!isRslib && !isRspress) {
@@ -206,8 +230,14 @@ const pluginModuleFederation = (moduleFederationOptions, rsbuildOptions)=>({
                         });
                     }
                 } else if (target === 'node') {
-                    const mfEnv = config.environments[ssr_js_namespaceObject.ENV_NAME];
-                    (0,ssr_js_namespaceObject.patchToolsTspack)(mfEnv, (config, { environment })=>{
+                    var _config_environments2;
+                    const nodeTargetEnv = (_config_environments2 = config.environments) === null || _config_environments2 === void 0 ? void 0 : _config_environments2[environment];
+                    if (!nodeTargetEnv) {
+                        const availableEnvironments = Object.keys(config.environments || {});
+                        const availableEnvironmentsLabel = availableEnvironments.length > 0 ? availableEnvironments.join(', ') : '(none)';
+                        throw new Error(`Can not find environment '${environment}' when using target: 'node'. Available environments: ${availableEnvironmentsLabel}.`);
+                    }
+                    (0,ssr_js_namespaceObject.patchToolsTspack)(nodeTargetEnv, (config, { environment })=>{
                         config.target = 'async-node';
                     });
                 }
@@ -284,7 +314,22 @@ const pluginModuleFederation = (moduleFederationOptions, rsbuildOptions)=>({
                     throw new Error('Can not get bundlerConfigs!');
                 }
                 bundlerConfigs.forEach((bundlerConfig)=>{
-                    if (!isMFFormat(bundlerConfig) && !isRspress) {
+                    const bundlerConfigName = bundlerConfig.name || '';
+                    const isConfiguredEnvironmentConfig = bundlerConfigName === environment;
+                    const isNodeTargetEnvironmentConfig = target === 'node' && bundlerConfigName === environment;
+                    const isRspressSSGEnvironmentConfig = isRspressSSGConfig(bundlerConfig.name);
+                    const isActiveRspressSSGEnvironmentConfig = isRspress && isRspressSSGEnvironmentConfig;
+                    const shouldUseSSRPluginConfig = isSSRConfig(bundlerConfig.name) || isNodeTargetEnvironmentConfig;
+                    if (target === 'node' && !isNodeTargetEnvironmentConfig && !isActiveRspressSSGEnvironmentConfig) {
+                        return;
+                    }
+                    // For non-node targets, scope each plugin instance to its configured
+                    // environment plus explicit SSR/SSG environments. This prevents a
+                    // browser-targeted instance from mutating SSR configs.
+                    if (target !== 'node' && !isConfiguredEnvironmentConfig && !shouldUseSSRPluginConfig && !isActiveRspressSSGEnvironmentConfig) {
+                        return;
+                    }
+                    if (!isMFFormat(bundlerConfig) && !isRspress && !isNodeTargetEnvironmentConfig) {
                         return;
                     } else if (isStoryBook(originalRsbuildConfig)) {
                         bundlerConfig.output.uniqueName = `${moduleFederationOptions.name} -storybook - host`;
@@ -292,7 +337,8 @@ const pluginModuleFederation = (moduleFederationOptions, rsbuildOptions)=>({
                         var _bundlerConfig_optimization, _bundlerConfig_optimization1, _bundlerConfig_output, _bundlerConfig_output1, _bundlerConfig_output2;
                         // mf
                         (0,external_utils_js_namespaceObject.autoDeleteSplitChunkCacheGroups)(moduleFederationOptions, bundlerConfig === null || bundlerConfig === void 0 ? void 0 : (_bundlerConfig_optimization = bundlerConfig.optimization) === null || _bundlerConfig_optimization === void 0 ? void 0 : _bundlerConfig_optimization.splitChunks);
-                        (0,external_utils_js_namespaceObject.addDataFetchExposes)(moduleFederationOptions.exposes, isSSRConfig(bundlerConfig.name));
+                        (0,external_utils_js_namespaceObject.addDataFetchExposes)(moduleFederationOptions.exposes, shouldUseSSRPluginConfig);
+                        const ssrModuleFederationOptions = shouldUseSSRPluginConfig ? (0,external_utils_js_namespaceObject.createSSRMFConfig)(moduleFederationOptions) : undefined;
                         (_bundlerConfig_optimization1 = bundlerConfig.optimization) === null || _bundlerConfig_optimization1 === void 0 ? true : delete _bundlerConfig_optimization1.runtimeChunk;
                         const externals = bundlerConfig.externals;
                         if (Array.isArray(externals)) {
@@ -334,13 +380,12 @@ const pluginModuleFederation = (moduleFederationOptions, rsbuildOptions)=>({
                                 }
                             }
                         }
-                        if (!((_bundlerConfig_output = bundlerConfig.output) === null || _bundlerConfig_output === void 0 ? void 0 : _bundlerConfig_output.chunkLoadingGlobal) && !isSSRConfig(bundlerConfig.name) && !isRspressSSGConfig(bundlerConfig.name) && target !== 'node') {
+                        if (!((_bundlerConfig_output = bundlerConfig.output) === null || _bundlerConfig_output === void 0 ? void 0 : _bundlerConfig_output.chunkLoadingGlobal) && !shouldUseSSRPluginConfig && !isActiveRspressSSGEnvironmentConfig && target !== 'node') {
                             bundlerConfig.output.chunkLoading = 'jsonp';
                             bundlerConfig.output.chunkLoadingGlobal = `chunk_${moduleFederationOptions.name} `;
                         }
-                        if (target === 'node' && isMFFormat(bundlerConfig)) {
-                            (0,ssr_js_namespaceObject.patchNodeConfig)(bundlerConfig, moduleFederationOptions);
-                            (0,ssr_js_namespaceObject.patchNodeMFConfig)(moduleFederationOptions);
+                        if (isNodeTargetEnvironmentConfig) {
+                            (0,ssr_js_namespaceObject.patchNodeConfig)(bundlerConfig, ssrModuleFederationOptions ?? moduleFederationOptions);
                         }
                         // `uniqueName` is required for react refresh to work
                         if (!((_bundlerConfig_output1 = bundlerConfig.output) === null || _bundlerConfig_output1 === void 0 ? void 0 : _bundlerConfig_output1.uniqueName)) {
@@ -348,17 +393,18 @@ const pluginModuleFederation = (moduleFederationOptions, rsbuildOptions)=>({
                         }
                         // Set default publicPath to 'auto' if not explicitly configured
                         // This allows remote chunks to load from the same origin as the remote application's manifest
-                        if (((_bundlerConfig_output2 = bundlerConfig.output) === null || _bundlerConfig_output2 === void 0 ? void 0 : _bundlerConfig_output2.publicPath) === undefined && !isSSRConfig(bundlerConfig.name) && !isRspressSSGConfig(bundlerConfig.name)) {
+                        if (((_bundlerConfig_output2 = bundlerConfig.output) === null || _bundlerConfig_output2 === void 0 ? void 0 : _bundlerConfig_output2.publicPath) === undefined && !shouldUseSSRPluginConfig && !isActiveRspressSSGEnvironmentConfig) {
                             bundlerConfig.output.publicPath = 'auto';
                         }
                         if (!bundlerConfig.plugins.find((p)=>p && p.name === rspack_namespaceObject.PLUGIN_NAME)) {
                             var _bundlerConfig_output3;
-                            if (isSSRConfig(bundlerConfig.name)) {
-                                generateMergedStatsAndManifestOptions.options.nodePlugin = new rspack_namespaceObject.ModuleFederationPlugin((0,external_utils_js_namespaceObject.createSSRMFConfig)(moduleFederationOptions));
+                            if (shouldUseSSRPluginConfig) {
+                                const ssrMFConfig = ssrModuleFederationOptions ?? (0,external_utils_js_namespaceObject.createSSRMFConfig)(moduleFederationOptions);
+                                generateMergedStatsAndManifestOptions.options.nodePlugin = new rspack_namespaceObject.ModuleFederationPlugin(ssrMFConfig);
                                 generateMergedStatsAndManifestOptions.options.nodeEnvironmentName = bundlerConfig.name || external_utils_js_namespaceObject.SSR_ENV_NAME;
                                 bundlerConfig.plugins.push(generateMergedStatsAndManifestOptions.options.nodePlugin);
                                 return;
-                            } else if (isRspressSSGConfig(bundlerConfig.name)) {
+                            } else if (isActiveRspressSSGEnvironmentConfig) {
                                 const mfConfig = {
                                     ...(0,external_utils_js_namespaceObject.createSSRMFConfig)(moduleFederationOptions),
                                     // expose in mf-ssg env

package/dist/cli/index.mjs

@@ -5,7 +5,7 @@ import package_0 from "../../package.json";
 import logger from "../logger.mjs";
 import { SSR_DIR, SSR_ENV_NAME, addDataFetchExposes, autoDeleteSplitChunkCacheGroups, createSSRMFConfig, createSSRREnvConfig, isRegExp, patchSSRRspackConfig, setSSREnv, updateStatsAndManifest } from "../utils.mjs";
 import { CALL_NAME_MAP, RSPRESS_BUNDLER_CONFIG_NAME, RSPRESS_SSG_MD_ENV_NAME, RSPRESS_SSR_DIR } from "../constant.mjs";
-import { ENV_NAME, patchNodeConfig, patchNodeMFConfig, patchToolsTspack } from "../utils/ssr.mjs";
+import { patchNodeConfig, patchToolsTspack } from "../utils/ssr.mjs";
 
 ;// CONCATENATED MODULE: external "@module-federation/enhanced"
 
@@ -40,6 +40,23 @@ const LIB_FORMAT = [
     'modern-module'
 ];
 const DEFAULT_MF_ENVIRONMENT_NAME = 'mf';
+const DEFAULT_WEB_ENVIRONMENT_NAME = 'web';
+const DEFAULT_NODE_ENVIRONMENT_NAME = 'node';
+const resolveDefaultEnvironmentName = ({ callerName, target })=>{
+    if (callerName === CALL_NAME_MAP.RSLIB) {
+        return DEFAULT_MF_ENVIRONMENT_NAME;
+    }
+    if (callerName === CALL_NAME_MAP.RSPRESS) {
+        if (target === 'node') {
+            return DEFAULT_NODE_ENVIRONMENT_NAME;
+        }
+        return DEFAULT_WEB_ENVIRONMENT_NAME;
+    }
+    if (target === 'node') {
+        return DEFAULT_NODE_ENVIRONMENT_NAME;
+    }
+    return DEFAULT_WEB_ENVIRONMENT_NAME;
+};
 function isStoryBook(rsbuildConfig) {
     var _rsbuildConfig_plugins;
     if ((_rsbuildConfig_plugins = rsbuildConfig.plugins) === null || _rsbuildConfig_plugins === void 0 ? void 0 : _rsbuildConfig_plugins.find((p)=>p && 'name' in p && p.name === 'module-federation-storybook-plugin')) {
@@ -66,7 +83,10 @@ const isRspressSSGConfig = (bundlerConfigName)=>{
 const pluginModuleFederation = (moduleFederationOptions, rsbuildOptions)=>({
         name: RSBUILD_PLUGIN_MODULE_FEDERATION_NAME,
         setup: (api)=>{
-            const { target = 'web', ssr = undefined, ssrDir = SSR_DIR, environment = DEFAULT_MF_ENVIRONMENT_NAME } = rsbuildOptions || {};
+            if (!(moduleFederationOptions === null || moduleFederationOptions === void 0 ? void 0 : moduleFederationOptions.name)) {
+                throw new Error('The module federation option "name" is required in @module-federation/rsbuild-plugin.');
+            }
+            const { target = 'web', ssr = undefined, ssrDir = SSR_DIR, environment: configuredEnvironment } = rsbuildOptions || {};
             if (ssr) {
                 throw new Error("The `ssr` option is deprecated. If you want to enable SSR, please use `target: 'dual'` instead.");
             }
@@ -78,6 +98,10 @@ const pluginModuleFederation = (moduleFederationOptions, rsbuildOptions)=>({
             const isRslib = callerName === CALL_NAME_MAP.RSLIB;
             const isRspress = callerName === CALL_NAME_MAP.RSPRESS;
             const isSSR = target === 'dual';
+            const environment = configuredEnvironment ?? resolveDefaultEnvironmentName({
+                callerName,
+                target
+            });
             if (isSSR && !isStoryBook(originalRsbuildConfig)) {
                 var _rsbuildConfig_environments;
                 if (!isRslib && !isRspress) {
@@ -149,8 +173,14 @@ const pluginModuleFederation = (moduleFederationOptions, rsbuildOptions)=>({
                         });
                     }
                 } else if (target === 'node') {
-                    const mfEnv = config.environments[ENV_NAME];
-                    patchToolsTspack(mfEnv, (config, { environment })=>{
+                    var _config_environments2;
+                    const nodeTargetEnv = (_config_environments2 = config.environments) === null || _config_environments2 === void 0 ? void 0 : _config_environments2[environment];
+                    if (!nodeTargetEnv) {
+                        const availableEnvironments = Object.keys(config.environments || {});
+                        const availableEnvironmentsLabel = availableEnvironments.length > 0 ? availableEnvironments.join(', ') : '(none)';
+                        throw new Error(`Can not find environment '${environment}' when using target: 'node'. Available environments: ${availableEnvironmentsLabel}.`);
+                    }
+                    patchToolsTspack(nodeTargetEnv, (config, { environment })=>{
                         config.target = 'async-node';
                     });
                 }
@@ -227,7 +257,22 @@ const pluginModuleFederation = (moduleFederationOptions, rsbuildOptions)=>({
                     throw new Error('Can not get bundlerConfigs!');
                 }
                 bundlerConfigs.forEach((bundlerConfig)=>{
-                    if (!isMFFormat(bundlerConfig) && !isRspress) {
+                    const bundlerConfigName = bundlerConfig.name || '';
+                    const isConfiguredEnvironmentConfig = bundlerConfigName === environment;
+                    const isNodeTargetEnvironmentConfig = target === 'node' && bundlerConfigName === environment;
+                    const isRspressSSGEnvironmentConfig = isRspressSSGConfig(bundlerConfig.name);
+                    const isActiveRspressSSGEnvironmentConfig = isRspress && isRspressSSGEnvironmentConfig;
+                    const shouldUseSSRPluginConfig = isSSRConfig(bundlerConfig.name) || isNodeTargetEnvironmentConfig;
+                    if (target === 'node' && !isNodeTargetEnvironmentConfig && !isActiveRspressSSGEnvironmentConfig) {
+                        return;
+                    }
+                    // For non-node targets, scope each plugin instance to its configured
+                    // environment plus explicit SSR/SSG environments. This prevents a
+                    // browser-targeted instance from mutating SSR configs.
+                    if (target !== 'node' && !isConfiguredEnvironmentConfig && !shouldUseSSRPluginConfig && !isActiveRspressSSGEnvironmentConfig) {
+                        return;
+                    }
+                    if (!isMFFormat(bundlerConfig) && !isRspress && !isNodeTargetEnvironmentConfig) {
                         return;
                     } else if (isStoryBook(originalRsbuildConfig)) {
                         bundlerConfig.output.uniqueName = `${moduleFederationOptions.name} -storybook - host`;
@@ -235,7 +280,8 @@ const pluginModuleFederation = (moduleFederationOptions, rsbuildOptions)=>({
                         var _bundlerConfig_optimization, _bundlerConfig_optimization1, _bundlerConfig_output, _bundlerConfig_output1, _bundlerConfig_output2;
                         // mf
                         autoDeleteSplitChunkCacheGroups(moduleFederationOptions, bundlerConfig === null || bundlerConfig === void 0 ? void 0 : (_bundlerConfig_optimization = bundlerConfig.optimization) === null || _bundlerConfig_optimization === void 0 ? void 0 : _bundlerConfig_optimization.splitChunks);
-                        addDataFetchExposes(moduleFederationOptions.exposes, isSSRConfig(bundlerConfig.name));
+                        addDataFetchExposes(moduleFederationOptions.exposes, shouldUseSSRPluginConfig);
+                        const ssrModuleFederationOptions = shouldUseSSRPluginConfig ? createSSRMFConfig(moduleFederationOptions) : undefined;
                         (_bundlerConfig_optimization1 = bundlerConfig.optimization) === null || _bundlerConfig_optimization1 === void 0 ? true : delete _bundlerConfig_optimization1.runtimeChunk;
                         const externals = bundlerConfig.externals;
                         if (Array.isArray(externals)) {
@@ -277,13 +323,12 @@ const pluginModuleFederation = (moduleFederationOptions, rsbuildOptions)=>({
                                 }
                             }
                         }
-                        if (!((_bundlerConfig_output = bundlerConfig.output) === null || _bundlerConfig_output === void 0 ? void 0 : _bundlerConfig_output.chunkLoadingGlobal) && !isSSRConfig(bundlerConfig.name) && !isRspressSSGConfig(bundlerConfig.name) && target !== 'node') {
+                        if (!((_bundlerConfig_output = bundlerConfig.output) === null || _bundlerConfig_output === void 0 ? void 0 : _bundlerConfig_output.chunkLoadingGlobal) && !shouldUseSSRPluginConfig && !isActiveRspressSSGEnvironmentConfig && target !== 'node') {
                             bundlerConfig.output.chunkLoading = 'jsonp';
                             bundlerConfig.output.chunkLoadingGlobal = `chunk_${moduleFederationOptions.name} `;
                         }
-                        if (target === 'node' && isMFFormat(bundlerConfig)) {
-                            patchNodeConfig(bundlerConfig, moduleFederationOptions);
-                            patchNodeMFConfig(moduleFederationOptions);
+                        if (isNodeTargetEnvironmentConfig) {
+                            patchNodeConfig(bundlerConfig, ssrModuleFederationOptions ?? moduleFederationOptions);
                         }
                         // `uniqueName` is required for react refresh to work
                         if (!((_bundlerConfig_output1 = bundlerConfig.output) === null || _bundlerConfig_output1 === void 0 ? void 0 : _bundlerConfig_output1.uniqueName)) {
@@ -291,17 +336,18 @@ const pluginModuleFederation = (moduleFederationOptions, rsbuildOptions)=>({
                         }
                         // Set default publicPath to 'auto' if not explicitly configured
                         // This allows remote chunks to load from the same origin as the remote application's manifest
-                        if (((_bundlerConfig_output2 = bundlerConfig.output) === null || _bundlerConfig_output2 === void 0 ? void 0 : _bundlerConfig_output2.publicPath) === undefined && !isSSRConfig(bundlerConfig.name) && !isRspressSSGConfig(bundlerConfig.name)) {
+                        if (((_bundlerConfig_output2 = bundlerConfig.output) === null || _bundlerConfig_output2 === void 0 ? void 0 : _bundlerConfig_output2.publicPath) === undefined && !shouldUseSSRPluginConfig && !isActiveRspressSSGEnvironmentConfig) {
                             bundlerConfig.output.publicPath = 'auto';
                         }
                         if (!bundlerConfig.plugins.find((p)=>p && p.name === PLUGIN_NAME)) {
                             var _bundlerConfig_output3;
-                            if (isSSRConfig(bundlerConfig.name)) {
-                                generateMergedStatsAndManifestOptions.options.nodePlugin = new ModuleFederationPlugin(createSSRMFConfig(moduleFederationOptions));
+                            if (shouldUseSSRPluginConfig) {
+                                const ssrMFConfig = ssrModuleFederationOptions ?? createSSRMFConfig(moduleFederationOptions);
+                                generateMergedStatsAndManifestOptions.options.nodePlugin = new ModuleFederationPlugin(ssrMFConfig);
                                 generateMergedStatsAndManifestOptions.options.nodeEnvironmentName = bundlerConfig.name || SSR_ENV_NAME;
                                 bundlerConfig.plugins.push(generateMergedStatsAndManifestOptions.options.nodePlugin);
                                 return;
-                            } else if (isRspressSSGConfig(bundlerConfig.name)) {
+                            } else if (isActiveRspressSSGEnvironmentConfig) {
                                 const mfConfig = {
                                     ...createSSRMFConfig(moduleFederationOptions),
                                     // expose in mf-ssg env

package/dist/utils/ssr.js

@@ -81,6 +81,20 @@ const external_constant_js_namespaceObject = require("../constant.js");
 
 const ssr_require = (0,external_node_module_namespaceObject.createRequire)(__rslib_import_meta_url__);
 const resolve = ssr_require.resolve;
+function resolveOrRequest(request) {
+    try {
+        return resolve(request);
+    } catch  {
+        return request;
+    }
+}
+function safeRequire(request) {
+    try {
+        return ssr_require(request);
+    } catch  {
+        return undefined;
+    }
+}
 const SSR_DIR = 'ssr';
 const SSR_ENV_NAME = 'mf-ssr';
 const ENV_NAME = 'mf';
@@ -93,16 +107,27 @@ const isDev = ()=>{
 function patchNodeConfig(config, mfConfig) {
     var _config_output;
     config.output ||= {};
+    if (config.output.publicPath === 'auto') {
+        config.output.publicPath = '';
+    }
     config.target = 'async-node';
-    // @module-federation/node/universe-entry-chunk-tracker-plugin only export cjs
-    const UniverseEntryChunkTrackerPlugin = ssr_require('@module-federation/node/universe-entry-chunk-tracker-plugin').default;
+    // Force node federation output to CJS + async chunk loading.
+    // This prevents browser jsonp runtime handlers from leaking into SSR remotes.
+    config.output.module = false;
+    config.output.chunkFormat = 'commonjs';
+    config.output.chunkLoading = 'async-node';
+    delete config.output.chunkLoadingGlobal;
+    const UniverseEntryChunkTrackerPluginModule = safeRequire('@module-federation/node/universe-entry-chunk-tracker-plugin');
+    const UniverseEntryChunkTrackerPlugin = UniverseEntryChunkTrackerPluginModule === null || UniverseEntryChunkTrackerPluginModule === void 0 ? void 0 : UniverseEntryChunkTrackerPluginModule.default;
     config.plugins ||= [];
-    isDev() && config.plugins.push(new UniverseEntryChunkTrackerPlugin());
+    if (isDev() && UniverseEntryChunkTrackerPlugin) {
+        config.plugins.push(new UniverseEntryChunkTrackerPlugin());
+    }
     const uniqueName = mfConfig.name || ((_config_output = config.output) === null || _config_output === void 0 ? void 0 : _config_output.uniqueName);
     const chunkFileName = config.output.chunkFilename;
     if (typeof chunkFileName === 'string' && uniqueName && !chunkFileName.includes(uniqueName)) {
-        const suffix = `${(0,sdk_namespaceObject.encodeName)(uniqueName)}-[contenthash].js`;
-        config.output.chunkFilename = chunkFileName.replace('.js', suffix);
+        const encodedName = (0,sdk_namespaceObject.encodeName)(uniqueName);
+        config.output.chunkFilename = chunkFileName.endsWith('.js') ? chunkFileName.replace(/\.js$/, `${encodedName}.js`) : `${chunkFileName}${encodedName}`;
     }
 }
 function patchSSRRspackConfig(config, mfConfig, ssrDir, callerName, resetEntry = true, modifyPublicPath = true) {
@@ -113,11 +138,10 @@ function patchSSRRspackConfig(config, mfConfig, ssrDir, callerName, resetEntry =
             throw new Error('publicPath must be string!');
         }
         const publicPath = config.output.publicPath;
-        if (publicPath === 'auto') {
-            throw new Error('publicPath can not be "auto"!');
+        if (publicPath !== 'auto') {
+            const publicPathWithSSRDir = `${publicPath}${ssrDir}/`;
+            config.output.publicPath = publicPathWithSSRDir;
         }
-        const publicPathWithSSRDir = `${publicPath}${ssrDir}/`;
-        config.output.publicPath = publicPathWithSSRDir;
     }
     if (callerName === external_constant_js_namespaceObject.CALL_NAME_MAP.RSPRESS && resetEntry) {
         // set virtue entry, only need mf entry
@@ -196,10 +220,9 @@ function patchNodeMFConfig(mfConfig) {
     mfConfig.runtimePlugins = [
         ...mfConfig.runtimePlugins || []
     ];
-    mfConfig.runtimePlugins.push(resolve('@module-federation/node/runtimePlugin'));
+    mfConfig.runtimePlugins.push(resolveOrRequest('@module-federation/node/runtimePlugin'));
     if (isDev()) {
-        mfConfig.runtimePlugins.push(// @ts-ignore
-        resolve('@module-federation/node/record-dynamic-remote-entry-hash-plugin'));
+        mfConfig.runtimePlugins.push(resolveOrRequest('@module-federation/node/record-dynamic-remote-entry-hash-plugin'));
     }
 }
 function createSSRMFConfig(mfConfig) {

package/dist/utils/ssr.mjs

@@ -18,6 +18,20 @@ import { CALL_NAME_MAP } from "../constant.mjs";
 
 const ssr_require = createRequire(import.meta.url);
 const resolve = ssr_require.resolve;
+function resolveOrRequest(request) {
+    try {
+        return resolve(request);
+    } catch  {
+        return request;
+    }
+}
+function safeRequire(request) {
+    try {
+        return ssr_require(request);
+    } catch  {
+        return undefined;
+    }
+}
 const SSR_DIR = 'ssr';
 const SSR_ENV_NAME = 'mf-ssr';
 const ENV_NAME = 'mf';
@@ -30,16 +44,27 @@ const isDev = ()=>{
 function patchNodeConfig(config, mfConfig) {
     var _config_output;
     config.output ||= {};
+    if (config.output.publicPath === 'auto') {
+        config.output.publicPath = '';
+    }
     config.target = 'async-node';
-    // @module-federation/node/universe-entry-chunk-tracker-plugin only export cjs
-    const UniverseEntryChunkTrackerPlugin = ssr_require('@module-federation/node/universe-entry-chunk-tracker-plugin').default;
+    // Force node federation output to CJS + async chunk loading.
+    // This prevents browser jsonp runtime handlers from leaking into SSR remotes.
+    config.output.module = false;
+    config.output.chunkFormat = 'commonjs';
+    config.output.chunkLoading = 'async-node';
+    delete config.output.chunkLoadingGlobal;
+    const UniverseEntryChunkTrackerPluginModule = safeRequire('@module-federation/node/universe-entry-chunk-tracker-plugin');
+    const UniverseEntryChunkTrackerPlugin = UniverseEntryChunkTrackerPluginModule === null || UniverseEntryChunkTrackerPluginModule === void 0 ? void 0 : UniverseEntryChunkTrackerPluginModule.default;
     config.plugins ||= [];
-    isDev() && config.plugins.push(new UniverseEntryChunkTrackerPlugin());
+    if (isDev() && UniverseEntryChunkTrackerPlugin) {
+        config.plugins.push(new UniverseEntryChunkTrackerPlugin());
+    }
     const uniqueName = mfConfig.name || ((_config_output = config.output) === null || _config_output === void 0 ? void 0 : _config_output.uniqueName);
     const chunkFileName = config.output.chunkFilename;
     if (typeof chunkFileName === 'string' && uniqueName && !chunkFileName.includes(uniqueName)) {
-        const suffix = `${encodeName(uniqueName)}-[contenthash].js`;
-        config.output.chunkFilename = chunkFileName.replace('.js', suffix);
+        const encodedName = encodeName(uniqueName);
+        config.output.chunkFilename = chunkFileName.endsWith('.js') ? chunkFileName.replace(/\.js$/, `${encodedName}.js`) : `${chunkFileName}${encodedName}`;
     }
 }
 function patchSSRRspackConfig(config, mfConfig, ssrDir, callerName, resetEntry = true, modifyPublicPath = true) {
@@ -50,11 +75,10 @@ function patchSSRRspackConfig(config, mfConfig, ssrDir, callerName, resetEntry =
             throw new Error('publicPath must be string!');
         }
         const publicPath = config.output.publicPath;
-        if (publicPath === 'auto') {
-            throw new Error('publicPath can not be "auto"!');
+        if (publicPath !== 'auto') {
+            const publicPathWithSSRDir = `${publicPath}${ssrDir}/`;
+            config.output.publicPath = publicPathWithSSRDir;
         }
-        const publicPathWithSSRDir = `${publicPath}${ssrDir}/`;
-        config.output.publicPath = publicPathWithSSRDir;
     }
     if (callerName === CALL_NAME_MAP.RSPRESS && resetEntry) {
         // set virtue entry, only need mf entry
@@ -133,10 +157,9 @@ function patchNodeMFConfig(mfConfig) {
     mfConfig.runtimePlugins = [
         ...mfConfig.runtimePlugins || []
     ];
-    mfConfig.runtimePlugins.push(resolve('@module-federation/node/runtimePlugin'));
+    mfConfig.runtimePlugins.push(resolveOrRequest('@module-federation/node/runtimePlugin'));
     if (isDev()) {
-        mfConfig.runtimePlugins.push(// @ts-ignore
-        resolve('@module-federation/node/record-dynamic-remote-entry-hash-plugin'));
+        mfConfig.runtimePlugins.push(resolveOrRequest('@module-federation/node/record-dynamic-remote-entry-hash-plugin'));
     }
 }
 function createSSRMFConfig(mfConfig) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@module-federation/rsbuild-plugin",
-  "version": "2.0.1",
+  "version": "2.1.0",
   "description": "Module Federation plugin for Rsbuild",
   "homepage": "https://module-federation.io",
   "bugs": {
@@ -50,16 +50,16 @@
   ],
   "dependencies": {
     "fs-extra": "11.3.0",
-    "@module-federation/sdk": "2.0.1",
-    "@module-federation/enhanced": "2.0.1",
-    "@module-federation/node": "2.7.32"
+    "@module-federation/sdk": "2.1.0",
+    "@module-federation/enhanced": "2.1.0",
+    "@module-federation/node": "2.7.33"
   },
   "devDependencies": {
     "@rslib/core": "^0.12.4",
     "@rsbuild/core": "2.0.0-beta.2"
   },
   "peerDependencies": {
-    "@rsbuild/core": "2.0.0-beta.2"
+    "@rsbuild/core": "^1.3.21 || ^2.0.0-0"
   },
   "peerDependenciesMeta": {
     "@rsbuild/core": {