@lark-apaas/fullstack-rspack-preset 1.0.58-alpha.1 → 1.0.58-beta.1

package/lib/preset.js

@@ -23,6 +23,7 @@ const static_assets_plugin_1 = __importDefault(require("./rspack-plugins/static-
 const source_map_upload_plugin_1 = __importDefault(require("./rspack-plugins/source-map-upload-plugin"));
 const capabilities_plugin_1 = require("./rspack-plugins/capabilities-plugin");
 const dev_server_snapdom_proxy_1 = require("./utils/dev-server-snapdom-proxy");
+const dev_server_health_1 = require("./utils/dev-server-health");
 function sendBackendUnavailable502(_err, _req, res) {
     if (res.headersSent)
         return;
@@ -518,6 +519,7 @@ function createRecommendRspackConfig(options) {
                     // 开发环境下提供 shared/static 文件服务，对齐 Vite preset 的 configureServer 中间件
                     devServer.app.use(staticAssetsPlugin.createDevMiddleware());
                     (0, dev_server_snapdom_proxy_1.registerSnapDomProxyMiddleware)(devServer.app, { baseUrl: clientBasePath });
+                    (0, dev_server_health_1.registerHealthCheckMiddleware)(devServer.app, { httpServer: devServer.server });
                     (0, devtool_kits_1.registerMiddlewares)(devServer.app, [
                         (0, devtool_kits_1.createDevLogsMiddleware)({ logDir: process.env.LOG_DIR || './logs' }),
                         (0, devtool_kits_1.createOpenapiMiddleware)({

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

@@ -10,7 +10,6 @@
  * 替换后的字符串里没有 process.env.X 形式，DefinePlugin 不会再二次替换。
  */
 module.exports = function basenameInjectionLoader(source) {
-    console.log(`[BasenameInjectionLoader] processing: ${this.resourcePath}`);
     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')) {

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

@@ -83,17 +83,14 @@ class BasenameInjectionPlugin {
     apply(compiler) {
         const loaderPath = path_1.default.resolve(__dirname, './basename-injection-loader.js');
         const envBasePath = this.envBasePath;
-        // afterEnvironment hook：所有配置（包括 extends、merge）已完成，
-        // compiler.options.entry 和 compiler.options.module 都是最终值。
-        compiler.hooks.afterEnvironment.tap(PLUGIN_NAME, () => {
-            const context = compiler.options.context || process.cwd();
-            const entry = compiler.options.entry;
-            // 从已解析的 entry 提取业务入口文件路径
+        // 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);
-            console.log(`[${PLUGIN_NAME}] entryTest: ${entryTest}, entryFiles: ${JSON.stringify(entryFiles)}, loaderPath: ${loaderPath}`);
             if (!compiler.options.module) {
                 compiler.options.module = { rules: [] };
             }

package/lib/utils/dev-server-health.d.ts

@@ -0,0 +1,33 @@
+/**
+ * 给妙搭沙箱外壳提供统一的 health endpoint。
+ *
+ * 协议（飞书文档 - 妙搭应用 Health Check 接口规范，对齐
+ * `@lark-apaas/coding-preset-vite-react` 的 healthMiddlewarePlugin）：
+ *   - HTTP connection refused / timeout → dev server 没起来 → 外壳重启沙箱
+ *   - 200 + { ready: true }             → 应用已就绪
+ *   - 200 + { ready: false }            → 还在启动
+ *
+ * 不归本接口管：
+ *   - compile error / runtime error / 资源加载失败 → 浏览器侧自己上报
+ */
+export declare const HEALTH_ENDPOINT = "/dev/health";
+/**
+ * dev server 底层 http(s) server 的最小结构（http.Server / https.Server 均满足）
+ */
+export interface ListenableServer {
+    listening: boolean;
+    once(event: 'listening', listener: () => void): unknown;
+}
+interface HealthCheckMiddlewareOptions {
+    /**
+     * dev server 的 http server；不传视为已就绪。
+     *
+     * 外部假设：@rspack/dev-server（webpack-dev-server v5 系排序）在
+     * setupMiddlewares 回调时 createServer() 已执行，devServer.server 可用且未
+     * listening。若宿主 dev-server 实现排序不同导致拿不到 server，则退化为
+     * ready 恒 true——请求只有 listen 后才进得来，协议语义仍成立。
+     */
+    httpServer?: ListenableServer | null;
+}
+export declare function registerHealthCheckMiddleware(serverApp: any, options?: HealthCheckMiddlewareOptions): void;
+export {};

package/lib/utils/dev-server-health.js

@@ -0,0 +1,41 @@
+"use strict";
+/* eslint-disable @typescript-eslint/no-explicit-any */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HEALTH_ENDPOINT = void 0;
+exports.registerHealthCheckMiddleware = registerHealthCheckMiddleware;
+/**
+ * 给妙搭沙箱外壳提供统一的 health endpoint。
+ *
+ * 协议（飞书文档 - 妙搭应用 Health Check 接口规范，对齐
+ * `@lark-apaas/coding-preset-vite-react` 的 healthMiddlewarePlugin）：
+ *   - HTTP connection refused / timeout → dev server 没起来 → 外壳重启沙箱
+ *   - 200 + { ready: true }             → 应用已就绪
+ *   - 200 + { ready: false }            → 还在启动
+ *
+ * 不归本接口管：
+ *   - compile error / runtime error / 资源加载失败 → 浏览器侧自己上报
+ */
+exports.HEALTH_ENDPOINT = '/dev/health';
+function registerHealthCheckMiddleware(serverApp, options = {}) {
+    const { httpServer } = options;
+    let ready = false;
+    // 三种状态：
+    //   - 无 httpServer                    → 认为已就绪
+    //   - httpServer.listening 已 true     → 已就绪
+    //   - 否则注册一次 listening 回调
+    if (!httpServer || httpServer.listening) {
+        ready = true;
+    }
+    else {
+        httpServer.once('listening', () => {
+            ready = true;
+        });
+    }
+    // 沙箱外壳探测的是固定根路径 /dev/health，不跟 clientBasePath 走
+    // req: import('express').Request
+    // res: import('express').Response
+    serverApp.get(exports.HEALTH_ENDPOINT, (_req, res) => {
+        res.setHeader('Cache-Control', 'no-store');
+        res.status(200).json({ ready });
+    });
+}

package/package.json

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