@lark-apaas/fullstack-rspack-preset 1.0.56-alpha.5 → 1.0.56-alpha.7

package/lib/preset.js

@@ -16,6 +16,7 @@ const slardar_performance_monitor_plugin_1 = __importDefault(require("./rspack-p
 const view_context_injection_plugin_1 = __importDefault(require("./rspack-plugins/view-context-injection-plugin"));
 const og_meta_injection_plugin_1 = __importDefault(require("./rspack-plugins/og-meta-injection-plugin"));
 const runtime_injection_plugin_1 = __importDefault(require("./rspack-plugins/runtime-injection-plugin"));
+const basename_injection_plugin_1 = __importDefault(require("./rspack-plugins/basename-injection-plugin"));
 const css_legacy_plugin_1 = __importDefault(require("./rspack-plugins/css-legacy-plugin"));
 const polyfill_plugin_1 = __importDefault(require("./rspack-plugins/polyfill-plugin"));
 const static_assets_plugin_1 = __importDefault(require("./rspack-plugins/static-assets-plugin"));
@@ -80,12 +81,11 @@ function createRecommendRspackConfig(options) {
     const localDev = (0, local_dev_1.isLocalDev)();
     const sandboxBase = (0, local_dev_1.resolveSandboxOrigin)();
     const { cookie: outboundCookie, csrfToken: outboundCsrfToken } = (0, local_dev_1.composeSandboxOutboundAuth)();
+    // parseSudaWebUserEnv 容忍 dotenv@17 对 shell-quoted JSON 不 unescape `\"` 的边界。
     let localDevWebUserHeader = '';
-    if (process.env.SUDA_WEBUSER) {
-        try {
-            localDevWebUserHeader = encodeURIComponent(JSON.stringify(JSON.parse(process.env.SUDA_WEBUSER)));
-        }
-        catch { /* ignore */ }
+    const parsedSudaWebUser = (0, local_dev_1.parseSudaWebUserEnv)(process.env.SUDA_WEBUSER);
+    if (parsedSudaWebUser) {
+        localDevWebUserHeader = encodeURIComponent(JSON.stringify(parsedSudaWebUser));
     }
     // 沙箱上 /__runtime__/* 的路由本身就期望带 /app/<appId> 前缀
     // （跟生产网关 miaoda.feishu-boe.cn 的行为一致），所以直接透传完整路径，不做 pathRewrite。
@@ -223,6 +223,10 @@ function createRecommendRspackConfig(options) {
         plugins: [
             // 运行时注入插件 - 自动将 @lark-apaas/client-toolkit/runtime 注入到所有入口之前
             new runtime_injection_plugin_1.default(),
+            // basename 运行时注入 - 改写入口文件 process.env.CLIENT_BASE_PATH 为运行时读 window.__BASENAME__
+            // 必须在 DefinePlugin 之前生效（plugin 内部 enforce:'pre'）
+            // 匹配 client/src/ 根层级入口文件（index.tsx / main.tsx 等），不影响 SDK 内部代码
+            new basename_injection_plugin_1.default({ envBasePath: clientBasePath }),
             new core_1.default.BannerPlugin({
                 banner: `window.__RELEASE_COMMIT_ID__ = '${releaseId}';`,
                 raw: true,

package/lib/rspack-plugins/basename-injection-loader.d.ts

@@ -0,0 +1,2 @@
+declare function _exports(source: any): any;
+export = _exports;

package/lib/rspack-plugins/basename-injection-loader.js

@@ -0,0 +1,23 @@
+"use strict";
+/**
+ * Basename Injection Loader
+ *
+ * 仅由 BasenameInjectionPlugin 在入口文件上挂载，做字符串替换：
+ *   process.env.CLIENT_BASE_PATH
+ *     → ((typeof window !== "undefined" && window.__BASENAME__) || "<envBasePath>")
+ *
+ * loader 阶段天然早于 DefinePlugin 的表达式替换（rspack source-transform → parsing → DefinePlugin 流水线顺序）。
+ * 替换后的字符串里没有 process.env.X 形式，DefinePlugin 不会再二次替换。
+ */
+module.exports = function basenameInjectionLoader(source) {
+    const options = (typeof this.getOptions === 'function' ? this.getOptions() : this.query) || {};
+    const envBasePath = options.envBasePath || '';
+    if (typeof source !== 'string' || !source.includes('process.env.CLIENT_BASE_PATH')) {
+        return source;
+    }
+    const fallback = JSON.stringify(envBasePath);
+    const runtimeExpr = '((typeof window !== "undefined" && window.__BASENAME__) || ' +
+        fallback +
+        ')';
+    return source.replace(/\bprocess\.env\.CLIENT_BASE_PATH\b/g, runtimeExpr);
+};

package/lib/rspack-plugins/basename-injection-plugin.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Basename Injection Plugin for Rspack
+ *
+ * 在 module rules 最前面注入一个 loader，仅匹配应用入口文件，
+ * 把入口里的 process.env.CLIENT_BASE_PATH
+ * 改写为运行时读 window.__BASENAME__（fallback 到构建时常量）。
+ *
+ * 让 BrowserRouter basename 运行时动态化，实现同一份 bundle 跑在不同 basename 下
+ * （默认域名 `/app/<appId>`、自定义域名 `/` 或 `/<alias>`）。
+ *
+ * 入口文件识别：在 entryOption hook（配置已完全解析合并）中从 entry 提取业务入口路径，
+ * 过滤掉 node_modules 包名（runtime 注入、polyfill 等非业务入口）和 Module Federation
+ * 远程模块，生成精确匹配正则。兜底到 client/src/index.{tsx,ts,jsx,js} 正则。
+ *
+ * 关键约束：
+ *   - 只匹配入口文件，不影响 SDK 内部代码（如 client-toolkit-lite 仍读编译期常量）
+ *   - loader 阶段天然早于 DefinePlugin 的表达式替换（rspack 内部 source-transform → parsing → DefinePlugin 流水线顺序）
+ *     enforce:'pre' 是用来跟 babel-loader / swc-loader 等其他 loader 抢先，避免被它们先处理掉表达式
+ *   - 兜底常量来自构建时 process.env.CLIENT_BASE_PATH，保证降级运行
+ */
+import type { Compiler } from '@rspack/core';
+export interface BasenameInjectionPluginOptions {
+    /** 编译时兜底 basename，通常等于 process.env.CLIENT_BASE_PATH */
+    envBasePath?: string;
+}
+export declare class BasenameInjectionPlugin {
+    private readonly envBasePath;
+    constructor(options?: BasenameInjectionPluginOptions);
+    apply(compiler: Compiler): void;
+}
+export default BasenameInjectionPlugin;

package/lib/rspack-plugins/basename-injection-plugin.js

@@ -0,0 +1,115 @@
+"use strict";
+/**
+ * Basename Injection Plugin for Rspack
+ *
+ * 在 module rules 最前面注入一个 loader，仅匹配应用入口文件，
+ * 把入口里的 process.env.CLIENT_BASE_PATH
+ * 改写为运行时读 window.__BASENAME__（fallback 到构建时常量）。
+ *
+ * 让 BrowserRouter basename 运行时动态化，实现同一份 bundle 跑在不同 basename 下
+ * （默认域名 `/app/<appId>`、自定义域名 `/` 或 `/<alias>`）。
+ *
+ * 入口文件识别：在 entryOption hook（配置已完全解析合并）中从 entry 提取业务入口路径，
+ * 过滤掉 node_modules 包名（runtime 注入、polyfill 等非业务入口）和 Module Federation
+ * 远程模块，生成精确匹配正则。兜底到 client/src/index.{tsx,ts,jsx,js} 正则。
+ *
+ * 关键约束：
+ *   - 只匹配入口文件，不影响 SDK 内部代码（如 client-toolkit-lite 仍读编译期常量）
+ *   - loader 阶段天然早于 DefinePlugin 的表达式替换（rspack 内部 source-transform → parsing → DefinePlugin 流水线顺序）
+ *     enforce:'pre' 是用来跟 babel-loader / swc-loader 等其他 loader 抢先，避免被它们先处理掉表达式
+ *   - 兜底常量来自构建时 process.env.CLIENT_BASE_PATH，保证降级运行
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BasenameInjectionPlugin = void 0;
+const path_1 = __importDefault(require("path"));
+const PLUGIN_NAME = 'BasenameInjectionPlugin';
+const FALLBACK_ENTRY_REGEX = /[/\\]client[/\\]src[/\\]index\.(tsx?|jsx?)$/;
+/**
+ * 判断 import 路径是否为本地业务文件（相对路径或绝对路径），
+ * 排除 node_modules 包名（runtime 注入、polyfill、HMR client 等）。
+ */
+function isLocalFile(imp) {
+    return imp.startsWith('.') || imp.startsWith('/');
+}
+/**
+ * 从 entry 配置中提取所有本地业务入口文件的绝对路径。
+ *
+ * entry 结构（entryOption hook 阶段已规范化）：
+ *   { main: { import: ['@lark-apaas/client-toolkit/runtime', './client/src/index.tsx'] } }
+ *
+ * 过滤规则：
+ *   - 跳过非本地路径（node_modules 包名，如 runtime 注入、polyfill、HMR client）
+ *   - 跳过 node_modules 内的文件（Module Federation 远程模块等）
+ */
+function resolveEntryFiles(entry, context) {
+    const files = [];
+    for (const descriptor of Object.values(entry)) {
+        const imports = descriptor.import;
+        if (!Array.isArray(imports))
+            continue;
+        for (const imp of imports) {
+            if (!isLocalFile(imp))
+                continue;
+            const resolved = path_1.default.resolve(context, imp);
+            if (resolved.includes('node_modules'))
+                continue;
+            files.push(resolved);
+        }
+    }
+    return files;
+}
+/**
+ * 构建入口文件匹配正则：精确匹配 resolved 路径，无路径时兜底默认正则。
+ * 路径分隔符统一用 [/\\] 匹配，避免跨平台问题（rspack 传给 test 的路径分隔符不确定）。
+ */
+function buildEntryTest(entryFiles) {
+    if (entryFiles.length === 0)
+        return FALLBACK_ENTRY_REGEX;
+    const escaped = entryFiles.map(f => {
+        return path_1.default.normalize(f)
+            .split(path_1.default.sep) // 按平台分隔符拆段
+            .map(seg => seg.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')) // 每段转义正则特殊字符
+            .join('[/\\\\]'); // 用 [/\\] 重新拼接
+    });
+    return new RegExp(`(${escaped.join('|')})$`);
+}
+class BasenameInjectionPlugin {
+    constructor(options = {}) {
+        this.envBasePath = options.envBasePath ?? process.env.CLIENT_BASE_PATH ?? '';
+    }
+    apply(compiler) {
+        const loaderPath = path_1.default.resolve(__dirname, './basename-injection-loader.js');
+        const envBasePath = this.envBasePath;
+        // entryOption hook：配置已完全解析合并（包括异步 entry 函数的返回值），
+        // 是读 entry 最安全的时机。参考 RuntimeInjectionPlugin 的做法。
+        compiler.hooks.entryOption.tap(PLUGIN_NAME, (context, entry) => {
+            // 动态 entry（函数形式）无法在此阶段解析，兜底到默认正则
+            const entryFiles = (typeof entry !== 'function')
+                ? resolveEntryFiles(entry, context)
+                : [];
+            const entryTest = buildEntryTest(entryFiles);
+            if (!compiler.options.module) {
+                compiler.options.module = { rules: [] };
+            }
+            const rules = compiler.options.module.rules || [];
+            compiler.options.module.rules = [
+                {
+                    test: entryTest,
+                    enforce: 'pre',
+                    use: [
+                        {
+                            loader: loaderPath,
+                            options: { envBasePath },
+                        },
+                    ],
+                },
+                ...rules,
+            ];
+        });
+    }
+}
+exports.BasenameInjectionPlugin = BasenameInjectionPlugin;
+exports.default = BasenameInjectionPlugin;

package/lib/rspack-plugins/source-map-upload-plugin.js

@@ -68,19 +68,25 @@ class SourceMapUploadPlugin {
                     if (!fs.existsSync(destinationDir)) {
                         fs.mkdirSync(destinationDir, { recursive: true });
                     }
-                    // The asset source may be a Buffer or a string.
-                    const source = sourceMap.source.source();
-                    const sourceBuffer = Buffer.isBuffer(source) ? source : Buffer.from(source, 'utf-8');
-                    fs.writeFileSync(destinationPath, sourceBuffer);
-                    console.log(`SourceMapUploadPlugin: Consolidated ${assetName} to ${destinationPath}`);
-                    // Delete the original sourcemap file.
+                    // Move the file; fallback to copy+delete on cross-filesystem (EXDEV)
                     try {
-                        fs.unlinkSync(originalPath);
-                        console.log(`SourceMapUploadPlugin: Deleted original sourcemap ${originalPath}`);
+                        fs.renameSync(originalPath, destinationPath);
                     }
-                    catch (deleteError) {
-                        console.warn(`SourceMapUploadPlugin: Failed to delete original sourcemap ${originalPath}.`, deleteError);
+                    catch (renameError) {
+                        if (renameError.code === 'EXDEV') {
+                            fs.copyFileSync(originalPath, destinationPath);
+                            try {
+                                fs.unlinkSync(originalPath);
+                            }
+                            catch (deleteError) {
+                                console.warn(`SourceMapUploadPlugin: Failed to delete original sourcemap ${originalPath}.`, deleteError);
+                            }
+                        }
+                        else {
+                            throw renameError;
+                        }
                     }
+                    console.log(`SourceMapUploadPlugin: Consolidated ${assetName} to ${destinationPath}`);
                 }
                 catch (error) {
                     const errorMessage = `SourceMapUploadPlugin: Failed to consolidate ${assetName}.`;

package/lib/rspack-plugins/view-context-injection-plugin.js

@@ -79,5 +79,6 @@ function getViewContextScriptContent() {
         if (appInfo.name) {
           window._appInfo = appInfo;
         }
+        window.__BASENAME__ = "{{basename}}";
     `;
 }

package/lib/utils/local-dev.d.ts

@@ -29,3 +29,14 @@ export declare function composeSandboxOutboundAuth(): {
  * （local dev 跑不通，但不抛错——交给上层 `localDev && sandboxBase` 条件兜底）。
  */
 export declare function resolveSandboxOrigin(): string;
+/**
+ * 解析 `process.env.SUDA_WEBUSER`，容忍沙箱下发的 shell-quoted JSON。
+ *
+ * 沙箱 env pull 下发到 .env.local 的 SUDA_WEBUSER 是双引号包裹 + 内部 `\"` 转义；
+ * dotenv@17 剥外层引号后**不还原**内部 `\"`，导致 `process.env.SUDA_WEBUSER` 是
+ * `{\"user_id\":\"...\"}` 这种带反斜杠的字符串，直接 JSON.parse 会挂在
+ * `Expected property name or '}' in JSON at position 1`。
+ *
+ * 容错：先直接 parse；失败再 unescape `\"` 后 parse；都失败返回 null。
+ */
+export declare function parseSudaWebUserEnv<T = unknown>(raw: string | undefined): T | null;

package/lib/utils/local-dev.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.isLocalDev = isLocalDev;
 exports.composeSandboxOutboundAuth = composeSandboxOutboundAuth;
 exports.resolveSandboxOrigin = resolveSandboxOrigin;
+exports.parseSudaWebUserEnv = parseSudaWebUserEnv;
 /**
  * 本地开发总开关。由 dev-local.sh export `MIAODA_LOCAL_DEV=1`；
  * 沙箱 dev / 生产都不设此 env。
@@ -63,3 +64,29 @@ function resolveSandboxOrigin() {
     }
     return process.env.SANDBOX_PUBLIC_URL || '';
 }
+/**
+ * 解析 `process.env.SUDA_WEBUSER`，容忍沙箱下发的 shell-quoted JSON。
+ *
+ * 沙箱 env pull 下发到 .env.local 的 SUDA_WEBUSER 是双引号包裹 + 内部 `\"` 转义；
+ * dotenv@17 剥外层引号后**不还原**内部 `\"`，导致 `process.env.SUDA_WEBUSER` 是
+ * `{\"user_id\":\"...\"}` 这种带反斜杠的字符串，直接 JSON.parse 会挂在
+ * `Expected property name or '}' in JSON at position 1`。
+ *
+ * 容错：先直接 parse；失败再 unescape `\"` 后 parse；都失败返回 null。
+ */
+function parseSudaWebUserEnv(raw) {
+    if (!raw)
+        return null;
+    try {
+        return JSON.parse(raw);
+    }
+    catch {
+        // fall through to unescape attempt
+    }
+    try {
+        return JSON.parse(raw.replace(/\\"/g, '"'));
+    }
+    catch {
+        return null;
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lark-apaas/fullstack-rspack-preset",
-  "version": "1.0.56-alpha.5",
+  "version": "1.0.56-alpha.7",
   "files": [
     "lib",
     "patches",