@lark-apaas/fullstack-rspack-preset 1.0.55 → 1.0.56-alpha.0

package/lib/index.js

@@ -41,10 +41,14 @@ const normalize_base_path_1 = require("./utils/normalize-base-path");
  * - CLIENT_DEV_PORT: 客户端开发端口 (默认: 8080)
  */
 function createFullstackRspackConfig(overrides = {}) {
-    // 1. 自动加载 .env 文件（同步加载，确保环境变量立即可用）
+    // 优先级 shell > .env.local > .env，对齐 Vite/Next.js 约定。
+    // dotenv.config 默认 override:false（先到先得），先 .env.local 让它优先，
+    // 再 .env 兜底；shell env 已在 process.env 中，两次 config 都不会覆盖。
     try {
         // eslint-disable-next-line @typescript-eslint/no-var-requires
-        require('dotenv').config();
+        const dotenv = require('dotenv');
+        dotenv.config({ path: '.env.local' });
+        dotenv.config({ path: '.env' });
     }
     catch (e) {
         // dotenv 是可选依赖，如果没有安装也不影响使用

package/lib/preset.js

@@ -10,12 +10,12 @@ const core_1 = __importDefault(require("@rspack/core"));
 const devtool_kits_1 = require("@lark-apaas/devtool-kits");
 const plugin_react_refresh_1 = __importDefault(require("@rspack/plugin-react-refresh"));
 const dev_server_listener_1 = require("./utils/dev-server-listener");
+const local_dev_1 = require("./utils/local-dev");
 const route_parser_plugin_1 = __importDefault(require("./rspack-plugins/route-parser-plugin"));
 const slardar_performance_monitor_plugin_1 = __importDefault(require("./rspack-plugins/slardar-performance-monitor-plugin"));
 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"));
@@ -74,6 +74,33 @@ function createRecommendRspackConfig(options) {
         }
     }
     catch { /* ignore */ }
+    // 本地 dev 链路兜底：将 {clientBasePath}/__runtime__ 反代到公网沙箱，
+    // 由 SDK 而非用户应用承担 cookie / x-larkgw-suda-webuser 注入。
+    const localDev = (0, local_dev_1.isLocalDev)();
+    const sandboxBase = process.env.SANDBOX_PUBLIC_URL;
+    const sandboxCookie = process.env.SANDBOX_COOKIE || '';
+    let localDevWebUserHeader = '';
+    if (process.env.SUDA_WEBUSER) {
+        try {
+            localDevWebUserHeader = encodeURIComponent(JSON.stringify(JSON.parse(process.env.SUDA_WEBUSER)));
+        }
+        catch { /* ignore */ }
+    }
+    // 沙箱(SANDBOX_PUBLIC_URL)上 /__runtime__/* 的路由本身就期望带 /app/<appId> 前缀
+    // （跟生产网关 miaoda.feishu-boe.cn 的行为一致），所以直接透传完整路径，不做 pathRewrite。
+    const localDevRuntimeProxyEntries = localDev && sandboxBase
+        ? [{
+                context: [`${clientBasePath}/__runtime__`],
+                target: sandboxBase,
+                changeOrigin: true,
+                secure: true,
+                headers: {
+                    ...(sandboxCookie ? { cookie: sandboxCookie } : {}),
+                    'accept-encoding': 'identity',
+                    ...(localDevWebUserHeader ? { 'x-larkgw-suda-webuser': localDevWebUserHeader } : {}),
+                },
+            }]
+        : [];
     return {
         mode: isDev ? 'development' : 'production',
         cache: false,
@@ -194,10 +221,6 @@ 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,
@@ -376,6 +399,7 @@ function createRecommendRspackConfig(options) {
                 (0, dev_server_listener_1.listenHmrTiming)(server);
             },
             proxy: [
+                ...localDevRuntimeProxyEntries,
                 {
                     context: [`${clientBasePath}/api`],
                     target: `http://localhost:${serverPort}`,

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

@@ -68,25 +68,19 @@ class SourceMapUploadPlugin {
                     if (!fs.existsSync(destinationDir)) {
                         fs.mkdirSync(destinationDir, { recursive: true });
                     }
-                    // Move the file; fallback to copy+delete on cross-filesystem (EXDEV)
+                    // 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.
                     try {
-                        fs.renameSync(originalPath, destinationPath);
+                        fs.unlinkSync(originalPath);
+                        console.log(`SourceMapUploadPlugin: Deleted original sourcemap ${originalPath}`);
                     }
-                    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;
-                        }
+                    catch (deleteError) {
+                        console.warn(`SourceMapUploadPlugin: Failed to delete original sourcemap ${originalPath}.`, deleteError);
                     }
-                    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,6 +79,5 @@ function getViewContextScriptContent() {
         if (appInfo.name) {
           window._appInfo = appInfo;
         }
-        window.__BASENAME__ = "{{basename}}";
     `;
 }

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

@@ -0,0 +1 @@
+export declare function isLocalDev(): boolean;

package/lib/utils/local-dev.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isLocalDev = isLocalDev;
+function isLocalDev() {
+    if (process.env.NODE_ENV === 'production')
+        return false;
+    const flag = process.env.MIAODA_LOCAL_DEV;
+    return flag === '1' || flag === 'true';
+}

package/package.json

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

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

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

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

@@ -1,23 +0,0 @@
-"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

@@ -1,31 +0,0 @@
-/**
- * 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

@@ -1,115 +0,0 @@
-"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;