@lark-apaas/coding-preset-vite-react 0.1.0

package/lib/plugins/slardar.js

@@ -0,0 +1,74 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.slardarPlugin = slardarPlugin;
+function buildSlardarScript(bid, globalName) {
+    return `
+    const slardarScript = document.createElement('script');
+    slardarScript.src = 'https://lf3-short.ibytedapm.com/slardar/fe/sdk-web/browser.cn.js?bid=${bid}&globalName=${globalName}';
+    slardarScript.crossOrigin = 'anonymous';
+    slardarScript.onload = function() {
+      if (window.${globalName}) {
+        window.${globalName}('context.merge', {
+          tenantId: window.tenantId ?? '',
+          appId: window.appId ?? '',
+        });
+        window.${globalName}('init', {
+          bid: '${bid}',
+          env: window.ENVIRONMENT || 'online',
+          userId: window.userId ?? '',
+        });
+        window.${globalName}('start');
+      }
+    };
+    slardarScript.onerror = function() {
+      console.warn('Failed to load Slardar script');
+    };
+    document.head.appendChild(slardarScript);
+  `;
+}
+function buildTeaScript() {
+    return `
+  (function (win, export_obj) {
+    win['LogAnalyticsObject'] = export_obj;
+    if (!win[export_obj]) {
+      function _collect() { _collect.q.push(arguments); }
+      _collect.q = _collect.q || [];
+      win[export_obj] = _collect;
+    }
+    win[export_obj].l = +new Date();
+  })(window, 'collectEvent');
+
+  const teaScript = document.createElement('script');
+  teaScript.src = 'https://lf3-cdn-tos.bytescm.com/obj/static/log-sdk/collect/5.1/collect.js';
+  teaScript.crossOrigin = 'anonymous';
+  teaScript.async = true;
+  teaScript.onerror = function() {
+    console.warn('Failed to load Tea script');
+  };
+  document.head.appendChild(teaScript);
+  `;
+}
+function slardarPlugin(options = {}) {
+    const { bid = 'apaas_miaoda', globalName = 'KSlardarWeb' } = options;
+    return {
+        name: 'miaoda-slardar',
+        transformIndexHtml(html) {
+            const tags = [
+                { tag: 'script', children: buildSlardarScript(bid, globalName), injectTo: 'head-prepend' },
+                {
+                    tag: 'script',
+                    attrs: {
+                        src: 'https://sf3-scmcdn-cn.feishucdn.com/obj/unpkg/byted/performance/0.1.2/dist/performance.iife.js',
+                        crossorigin: 'anonymous',
+                        defer: true,
+                    },
+                    injectTo: 'head-prepend',
+                },
+                { tag: 'script', children: buildTeaScript(), injectTo: 'head-prepend' },
+            ];
+            return { html, tags };
+        },
+    };
+}
+exports.default = slardarPlugin;
+//# sourceMappingURL=slardar.js.map

package/lib/plugins/slardar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slardar.js","sourceRoot":"","sources":["../../src/plugins/slardar.ts"],"names":[],"mappings":";;AAwEA,sCAuBC;AAxED,SAAS,kBAAkB,CAAC,GAAW,EAAE,UAAkB;IACzD,OAAO;;gGAEuF,GAAG,eAAe,UAAU;;;mBAGzG,UAAU;iBACZ,UAAU;;;;iBAIV,UAAU;kBACT,GAAG;;;;iBAIJ,UAAU;;;;;;;GAOxB,CAAC;AACJ,CAAC;AAED,SAAS,cAAc;IACrB,OAAO;;;;;;;;;;;;;;;;;;;GAmBN,CAAC;AACJ,CAAC;AAED,SAAgB,aAAa,CAAC,UAAgC,EAAE;IAC9D,MAAM,EAAE,GAAG,GAAG,cAAc,EAAE,UAAU,GAAG,aAAa,EAAE,GAAG,OAAO,CAAC;IAErE,OAAO;QACL,IAAI,EAAE,gBAAgB;QAEtB,kBAAkB,CAAC,IAAI;YACrB,MAAM,IAAI,GAAwB;gBAChC,EAAE,GAAG,EAAE,QAAQ,EAAE,QAAQ,EAAE,kBAAkB,CAAC,GAAG,EAAE,UAAU,CAAC,EAAE,QAAQ,EAAE,cAAc,EAAE;gBAC1F;oBACE,GAAG,EAAE,QAAQ;oBACb,KAAK,EAAE;wBACL,GAAG,EAAE,gGAAgG;wBACrG,WAAW,EAAE,WAAW;wBACxB,KAAK,EAAE,IAAI;qBACZ;oBACD,QAAQ,EAAE,cAAc;iBACzB;gBACD,EAAE,GAAG,EAAE,QAAQ,EAAE,QAAQ,EAAE,cAAc,EAAE,EAAE,QAAQ,EAAE,cAAc,EAAE;aACxE,CAAC;YACF,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;QACxB,CAAC;KACF,CAAC;AACJ,CAAC;AAED,kBAAe,aAAa,CAAC"}

package/lib/plugins/static-assets.d.ts

@@ -0,0 +1,10 @@
+import type { Plugin } from 'vite';
+export interface StaticAssetsPluginOptions {
+    /** Client base path prefix for routes. */
+    clientBasePath?: string;
+    /** Project root directory. Defaults to `process.cwd()`. */
+    rootDir?: string;
+}
+export declare function staticAssetsPlugin(options?: StaticAssetsPluginOptions): Plugin;
+export default staticAssetsPlugin;
+//# sourceMappingURL=static-assets.d.ts.map

package/lib/plugins/static-assets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"static-assets.d.ts","sourceRoot":"","sources":["../../src/plugins/static-assets.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAqB,MAAM,EAAiB,MAAM,MAAM,CAAC;AAqErE,MAAM,WAAW,yBAAyB;IACxC,0CAA0C;IAC1C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,2DAA2D;IAC3D,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,kBAAkB,CAAC,OAAO,GAAE,yBAA8B,GAAG,MAAM,CAwLlF;AAED,eAAe,kBAAkB,CAAC"}

package/lib/plugins/static-assets.js

@@ -0,0 +1,297 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.staticAssetsPlugin = staticAssetsPlugin;
+/**
+ * 业务工程 `shared/static/*` 静态资源解析。
+ *
+ * - JSON：dev 内联展开成 `export default {...}`；prod 走 `window.__STATIC_JSON__['key']`
+ *   （prod HTML 注入 inline script 一次性塞所有 json）
+ * - 其它文件：返回 URL 字符串 `${publicPrefix}/<rel>`（默认 `${clientBasePath}/static/<rel>`）
+ * - 脚本扩展（.ts/.tsx/.js/.jsx/.mts/.cts/.mjs/.cjs）：fallback 到真实路径，让 Vite 当普通模块打
+ * - 带 query 的 import（`?raw`/`?url` 等）：返回真实路径 + query，让 Vite 内置处理
+ *
+ * 算法移植自 `@lark-apaas/coding-vite-preset/static-assets-plugin`，
+ * 把 `glob` 依赖换成 `fs.readdirSync` 递归遍历，去掉额外 dep。
+ */
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const PREFIX = '@shared/static/';
+const VIRTUAL_PREFIX = '\0@shared/static/';
+const SCRIPT_EXTENSIONS = ['.ts', '.tsx', '.js', '.jsx', '.mts', '.cts', '.mjs', '.cjs'];
+const MIME = {
+    '.json': 'application/json',
+    '.png': 'image/png',
+    '.jpg': 'image/jpeg',
+    '.jpeg': 'image/jpeg',
+    '.gif': 'image/gif',
+    '.svg': 'image/svg+xml',
+    '.webp': 'image/webp',
+    '.ico': 'image/x-icon',
+    '.woff': 'font/woff',
+    '.woff2': 'font/woff2',
+    '.ttf': 'font/ttf',
+    '.eot': 'application/vnd.ms-fontobject',
+    '.otf': 'font/otf',
+    '.css': 'text/css',
+    '.js': 'application/javascript',
+    '.txt': 'text/plain',
+    '.html': 'text/html',
+    '.xml': 'application/xml',
+    '.pdf': 'application/pdf',
+    '.mp3': 'audio/mpeg',
+    '.mp4': 'video/mp4',
+    '.webm': 'video/webm',
+};
+function splitQuery(rel) {
+    const i = rel.indexOf('?');
+    return i === -1 ? [rel, ''] : [rel.slice(0, i), rel.slice(i)];
+}
+function resolveScriptFile(staticDir, cleanPath) {
+    const ext = path.extname(cleanPath).toLowerCase();
+    if (ext && SCRIPT_EXTENSIONS.includes(ext)) {
+        return path.join(staticDir, cleanPath);
+    }
+    if (!ext) {
+        for (const e of SCRIPT_EXTENSIONS) {
+            const p = path.join(staticDir, cleanPath + e);
+            if (fs.existsSync(p))
+                return p;
+        }
+    }
+    return null;
+}
+function walkJson(dir, out, prefix = '') {
+    if (!fs.existsSync(dir))
+        return;
+    for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+        const full = path.join(dir, entry.name);
+        const rel = prefix ? `${prefix}/${entry.name}` : entry.name;
+        if (entry.isDirectory()) {
+            walkJson(full, out, rel);
+        }
+        else if (entry.isFile() && entry.name.endsWith('.json')) {
+            try {
+                const key = rel.replace(/\.json$/, '');
+                out[key] = JSON.parse(fs.readFileSync(full, 'utf-8'));
+            }
+            catch (e) {
+                console.warn(`[miaoda-static-assets] skip invalid json: ${rel}: ${e instanceof Error ? e.message : String(e)}`);
+            }
+        }
+    }
+}
+function staticAssetsPlugin(options = {}) {
+    const { clientBasePath = '', rootDir = process.cwd() } = options;
+    const staticDir = path.resolve(rootDir, 'shared/static');
+    let isDev = true;
+    let jsonCache = null;
+    function getJson() {
+        if (!isDev && jsonCache)
+            return jsonCache;
+        const data = {};
+        walkJson(staticDir, data);
+        if (!isDev)
+            jsonCache = data;
+        return data;
+    }
+    return {
+        name: 'miaoda-static-assets',
+        // 必须 enforce:'pre'：早于 tsconfig paths 和 vite:json transform
+        enforce: 'pre',
+        config(_config, { command }) {
+            isDev = command === 'serve';
+        },
+        resolveId: {
+            filter: { id: /^@shared\/static\// },
+            handler(id) {
+                if (!id.startsWith(PREFIX))
+                    return null;
+                const rel = id.slice(PREFIX.length);
+                const [cleanPath, query] = splitQuery(rel);
+                // ?raw / ?url 等：返回真实路径 + query，交给 Vite 内置处理
+                if (query)
+                    return path.join(staticDir, cleanPath) + query;
+                // 脚本：解析到真实文件，让 vite 当普通模块打
+                const scriptPath = resolveScriptFile(staticDir, cleanPath);
+                if (scriptPath)
+                    return scriptPath;
+                const virtualId = VIRTUAL_PREFIX + cleanPath;
+                // 后缀 `.js` 避免 vite:json 把 .json 虚拟模块当 JSON 文件 transform
+                return cleanPath.endsWith('.json') ? virtualId + '.js' : virtualId;
+            },
+        },
+        load(id) {
+            if (!id.startsWith(VIRTUAL_PREFIX))
+                return null;
+            let rel = id.slice(VIRTUAL_PREFIX.length);
+            if (rel.endsWith('.json.js'))
+                rel = rel.slice(0, -3); // strip 上面加的 .js
+            const isJson = rel.endsWith('.json');
+            if (isJson) {
+                if (isDev) {
+                    // dev：直接内联 JSON 内容，避免依赖 window.__STATIC_JSON__
+                    const full = path.join(staticDir, rel);
+                    try {
+                        const content = fs.readFileSync(full, 'utf-8');
+                        return `export default ${content};`;
+                    }
+                    catch (e) {
+                        console.warn(`[miaoda-static-assets] read json failed: ${rel}`, e);
+                        return `export default undefined;`;
+                    }
+                }
+                // prod：从 transformIndexHtml 注入的 window.__STATIC_JSON__ 取
+                const key = rel.replace(/\.json$/, '');
+                return `export default window.__STATIC_JSON__[${JSON.stringify(key)}];`;
+            }
+            // 非 JSON：返回 URL 字符串
+            //   - dev：走 `${clientBasePath}/static/${rel}`，由本插件挂的 middleware 服务真实文件
+            //   - prod：走 `${STATIC_ASSETS_BASE_URL}/${rel}`（build.sh 从 MIAODA_STATIC_CDN_PREFIX 映射，
+            //     最终来自 TOS preUploadStatic.downloadURLPrefix）。未设置时空字符串退化为相对路径——
+            //     线上 build 缺这个环境变量基本是 deploy 配置漏了，warn 一下方便排查。
+            let url;
+            if (isDev) {
+                url = `${clientBasePath}/static/${rel}`;
+            }
+            else {
+                const cdnPrefix = (process.env.STATIC_ASSETS_BASE_URL ?? '').replace(/\/+$/, '');
+                if (!cdnPrefix) {
+                    console.warn(`[miaoda-static-assets] STATIC_ASSETS_BASE_URL is not set; "${rel}" will resolve to a relative URL. ` +
+                        `Did you forget to inject MIAODA_STATIC_CDN_PREFIX in build.sh?`);
+                }
+                url = cdnPrefix ? `${cdnPrefix}/${rel}` : `/${rel}`;
+            }
+            return `export default ${JSON.stringify(url)};`;
+        },
+        transformIndexHtml() {
+            if (isDev)
+                return; // dev 直接内联，不需要 window.__STATIC_JSON__
+            const data = getJson();
+            if (Object.keys(data).length === 0)
+                return;
+            const tags = [
+                {
+                    tag: 'script',
+                    children: `window.__STATIC_JSON__ = ${JSON.stringify(data)};`,
+                    injectTo: 'head-prepend',
+                },
+            ];
+            return { html: '', tags };
+        },
+        configureServer(server) {
+            if (!fs.existsSync(staticDir))
+                return;
+            const watcher = server.watcher;
+            watcher.add(staticDir);
+            const handleChange = (changedPath) => {
+                if (!changedPath.startsWith(staticDir))
+                    return;
+                const rel = path.relative(staticDir, changedPath);
+                if (rel.endsWith('.json')) {
+                    // JSON 变了：invalidate 虚拟模块 + full-reload
+                    const moduleId = VIRTUAL_PREFIX + rel;
+                    const mod = server.environments.client.moduleGraph.getModuleById(moduleId);
+                    if (mod)
+                        server.environments.client.moduleGraph.invalidateModule(mod);
+                    server.hot.send({ type: 'custom', event: 'static-json-update', data: { path: rel } });
+                    server.hot.send({ type: 'full-reload', path: '*' });
+                }
+                else {
+                    server.hot.send({ type: 'custom', event: 'static-asset-update', data: { path: rel } });
+                }
+            };
+            watcher.on('change', handleChange);
+            watcher.on('add', handleChange);
+            watcher.on('unlink', (changedPath) => {
+                if (!changedPath.startsWith(staticDir))
+                    return;
+                if (changedPath.endsWith('.json')) {
+                    const rel = path.relative(staticDir, changedPath);
+                    const moduleId = VIRTUAL_PREFIX + rel;
+                    const mod = server.environments.client.moduleGraph.getModuleById(moduleId);
+                    if (mod)
+                        server.environments.client.moduleGraph.invalidateModule(mod);
+                }
+                server.hot.send({ type: 'full-reload', path: '*' });
+            });
+            // dev 下直接 serve `${clientBasePath}/static/...` 路径
+            server.middlewares.use((req, res, next) => {
+                const staticPrefix = `${clientBasePath}/static/`;
+                const url = req.url || '';
+                if (!url.startsWith(staticPrefix))
+                    return next();
+                const rawRel = url.slice(staticPrefix.length).split('?')[0];
+                let rel;
+                try {
+                    rel = decodeURIComponent(rawRel);
+                }
+                catch {
+                    res.statusCode = 400;
+                    res.end('Bad Request');
+                    return;
+                }
+                const filePath = path.join(staticDir, rel);
+                // 防 path traversal
+                const normalized = path.normalize(filePath);
+                if (!normalized.startsWith(staticDir)) {
+                    res.statusCode = 403;
+                    res.end('Forbidden');
+                    return;
+                }
+                if (!fs.existsSync(filePath)) {
+                    res.statusCode = 404;
+                    res.end('Not Found');
+                    return;
+                }
+                const stat = fs.statSync(filePath);
+                if (stat.isDirectory()) {
+                    res.statusCode = 403;
+                    res.end('Forbidden');
+                    return;
+                }
+                const ext = path.extname(filePath).toLowerCase();
+                res.setHeader('Content-Type', MIME[ext] || 'application/octet-stream');
+                res.setHeader('Cache-Control', 'no-cache');
+                fs.createReadStream(filePath).pipe(res);
+            });
+        },
+        // closeBundle 拷贝 shared/static 的逻辑已删除——build.sh 用 rsync 直接拷到
+        // dist/output_static/（部署侧识别的目录），plugin 之前拷到 dist/shared/static
+        // 是死代码、没人读，而且没排除 .ts/.tsx 还可能误传脚本文件。
+    };
+}
+exports.default = staticAssetsPlugin;
+//# sourceMappingURL=static-assets.js.map

package/lib/plugins/static-assets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"static-assets.js","sourceRoot":"","sources":["../../src/plugins/static-assets.ts"],"names":[],"mappings":"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"}

package/lib/plugins/view-context.d.ts

@@ -0,0 +1,22 @@
+import type { IncomingMessage } from 'node:http';
+import type { Plugin } from 'vite';
+interface RequestRenderContext {
+    userId: string;
+    tenantId: number | string;
+    userName: string;
+    csrfToken: string;
+    environment: 'staging' | 'gray' | 'online';
+}
+/** 从 incoming request 抽出全部 server 端能拿到的 view-context 字段 */
+export declare function buildRenderContext(req: IncomingMessage): RequestRenderContext;
+export interface ViewContextPluginOptions {
+    /**
+     * 显式传入的 appId override。preset 已经从 `CLIENT_BASE_PATH=/app/<appId>`
+     * 提取，设置后 inline script 直接拼真值字面量。未设置则走 IIFE 从 URL
+     * 解析（prod / 部分本地 dev URL 没 base path 时用）。
+     */
+    appId?: string;
+}
+export declare function viewContextPlugin(options?: ViewContextPluginOptions): Plugin;
+export default viewContextPlugin;
+//# sourceMappingURL=view-context.d.ts.map

package/lib/plugins/view-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"view-context.d.ts","sourceRoot":"","sources":["../../src/plugins/view-context.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,KAAK,EAAqB,MAAM,EAAE,MAAM,MAAM,CAAC;AA6BtD,UAAU,oBAAoB;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,SAAS,GAAG,MAAM,GAAG,QAAQ,CAAC;CAC5C;AA4BD,2DAA2D;AAC3D,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,eAAe,GAAG,oBAAoB,CAS7E;AAID,MAAM,WAAW,wBAAwB;IACvC;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AA+CD,wBAAgB,iBAAiB,CAAC,OAAO,GAAE,wBAA6B,GAAG,MAAM,CA+BhF;AAED,eAAe,iBAAiB,CAAC"}

package/lib/plugins/view-context.js

@@ -0,0 +1,132 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildRenderContext = buildRenderContext;
+exports.viewContextPlugin = viewContextPlugin;
+const node_async_hooks_1 = require("node:async_hooks");
+/**
+ * 在 HTML head 注入 inline script，把启动期上下文挂到 `window`。
+ *
+ * **dev 期完全走 server 渲染**：在 `configureServer` 中间件里解析 incoming request
+ * 的 cookie / host / `x-larkgw-suda-webuser` header，用 `AsyncLocalStorage` 绑到当前
+ * 异步链；`transformIndexHtml` 钩子读出后**全部拼成字面量**注入。
+ *
+ * **prod / 本地裸 dev 无 request 上下文时**走 IIFE fallback：
+ *   - `csrfToken` 从 `document.cookie` 读
+ *   - `ENVIRONMENT` 从 `location.hostname` 推
+ *   - `userId / tenantId / userName` 空字符串
+ *
+ * 这套设计针对纯前端 jsPage 模板：dev 期沙箱网关已经把 `x-larkgw-suda-webuser`
+ * 透传给本地 devserver，于是 server 端有完整 user 上下文；prod 由业务侧
+ * `useCurrentUserProfile` 等 hook 异步 fetch 兜底。
+ */
+const SUDA_HEADER = 'x-larkgw-suda-webuser';
+const requestContext = new node_async_hooks_1.AsyncLocalStorage();
+// ───────────── header / cookie / host 解析 helpers ─────────────
+function parseSudaWebUser(header) {
+    if (typeof header !== 'string' || !header)
+        return null;
+    try {
+        return JSON.parse(decodeURIComponent(header));
+    }
+    catch {
+        return null;
+    }
+}
+function parseCsrfToken(cookieHeader) {
+    if (!cookieHeader)
+        return '';
+    const m = cookieHeader.match(/(?:^|;\s*)suda-csrf-token=([^;]+)/);
+    return m ? decodeURIComponent(m[1]) : '';
+}
+function deriveEnvironment(host) {
+    if (!host)
+        return 'online';
+    if (host.includes('boe'))
+        return 'staging';
+    if (host.includes('feishu-pre') || host.includes('-pre.'))
+        return 'gray';
+    return 'online';
+}
+/** 从 incoming request 抽出全部 server 端能拿到的 view-context 字段 */
+function buildRenderContext(req) {
+    const user = parseSudaWebUser(req.headers[SUDA_HEADER]);
+    return {
+        userId: user?.user_id ?? '',
+        tenantId: user?.tenant_id ?? '',
+        userName: user?.user_name?.zh_cn ?? '',
+        csrfToken: parseCsrfToken(req.headers.cookie),
+        environment: deriveEnvironment(req.headers.host),
+    };
+}
+function appIdExpr(appId) {
+    if (appId)
+        return JSON.stringify(appId);
+    return `(function () {
+        var p = location.pathname.match(/\\/app\\/(app_[a-z0-9]+)/i);
+        if (p) return p[1];
+        var h = location.hostname.match(/app_[a-z0-9]+/i);
+        return h ? h[0] : '';
+      })()`;
+}
+/** 有 request context（dev 沙箱 / dev 本地）：全字面量 */
+function buildScriptFromRequest(options, ctx) {
+    return `
+    window.appId = ${appIdExpr(options.appId)};
+    window.userId = ${JSON.stringify(ctx.userId)};
+    window.tenantId = ${JSON.stringify(ctx.tenantId)};
+    window.userName = ${JSON.stringify(ctx.userName)};
+    window.csrfToken = ${JSON.stringify(ctx.csrfToken)};
+    window.ENVIRONMENT = ${JSON.stringify(ctx.environment)};
+  `;
+}
+/** 无 request context（prod build）：IIFE fallback */
+function buildScriptFallback(options) {
+    return `
+    window.appId = ${appIdExpr(options.appId)};
+    window.userId = '';
+    window.tenantId = '';
+    window.userName = '';
+    window.csrfToken = (function () {
+      var m = document.cookie.match(/(?:^|;\\s*)suda-csrf-token=([^;]+)/);
+      return m ? decodeURIComponent(m[1]) : '';
+    })();
+    window.ENVIRONMENT = (function () {
+      var h = location.hostname;
+      if (h.indexOf('boe') !== -1) return 'staging';
+      if (h.indexOf('feishu-pre') !== -1 || h.indexOf('-pre.') !== -1) return 'gray';
+      return 'online';
+    })();
+  `;
+}
+function viewContextPlugin(options = {}) {
+    return {
+        name: 'miaoda-view-context',
+        /**
+         * dev 期前置 middleware：每个请求都把 render context 绑到 ALS。
+         * 后续 `transformIndexHtml` 在同一异步链里 `getStore()` 读出。
+         */
+        configureServer(server) {
+            server.middlewares.use((req, _res, next) => {
+                const ctx = buildRenderContext(req);
+                requestContext.run(ctx, () => next());
+            });
+        },
+        transformIndexHtml() {
+            const ctx = requestContext.getStore();
+            const children = ctx
+                ? buildScriptFromRequest(options, ctx)
+                : buildScriptFallback(options);
+            const tags = [
+                {
+                    tag: 'script',
+                    children,
+                    // head-prepend：必须在业务代码 / runtime 之前注入，保证业务可同步读 window 全局
+                    injectTo: 'head-prepend',
+                },
+            ];
+            return tags;
+        },
+    };
+}
+exports.default = viewContextPlugin;
+//# sourceMappingURL=view-context.js.map

package/lib/plugins/view-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"view-context.js","sourceRoot":"","sources":["../../src/plugins/view-context.ts"],"names":[],"mappings":"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"}

package/lib/plugins/vite-client-patch.d.ts

@@ -0,0 +1,4 @@
+import type { Plugin } from 'vite';
+export declare function viteClientPatchPlugin(): Plugin;
+export default viteClientPatchPlugin;
+//# sourceMappingURL=vite-client-patch.d.ts.map

package/lib/plugins/vite-client-patch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vite-client-patch.d.ts","sourceRoot":"","sources":["../../src/plugins/vite-client-patch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAkBnC,wBAAgB,qBAAqB,IAAI,MAAM,CAqB9C;AAED,eAAe,qBAAqB,CAAC"}

package/lib/plugins/vite-client-patch.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.viteClientPatchPlugin = viteClientPatchPlugin;
+/**
+ * 抑制 `@vite/client` 在 HMR WS 重连成功后的 `location.reload()`。
+ *
+ * 背景（沙箱反向代理场景）：电脑休眠唤醒后 WS 断连重连。Vite 客户端走
+ * `waitForSuccessfulPing()` 用新 TCP 连接握手成功，立刻发 `location.reload()`；
+ * 但 reload 用的是浏览器 HTTP/2 连接池里复用的休眠前死连接，
+ * 导致 ~18s `ERR_CONNECTION_TIMED_OUT` 白屏。
+ *
+ * 解：transform 拦截 `vite/dist/client/client.mjs`，直接删掉 reload 那一行。
+ * 用户需要新代码时手动刷新。
+ *
+ * 仅 dev（`apply: 'serve'`）。
+ */
+const RECONNECT_RELOAD_PATTERN = /(await waitForSuccessfulPing\(url\.href\);)\r?\n(\s*)location\.reload\(\);/;
+function viteClientPatchPlugin() {
+    return {
+        name: 'miaoda-vite-client-patch',
+        enforce: 'post',
+        apply: 'serve',
+        transform(code, id) {
+            if (!id.includes('vite/dist/client/client.mjs'))
+                return;
+            if (!RECONNECT_RELOAD_PATTERN.test(code)) {
+                console.warn('[miaoda-vite-client-patch] reconnect-reload pattern not found in @vite/client. ' +
+                    'patch NOT applied — Vite client.mjs may have changed.');
+                return;
+            }
+            const patched = code.replace(RECONNECT_RELOAD_PATTERN, (_, pingLine) => pingLine);
+            return { code: patched };
+        },
+    };
+}
+exports.default = viteClientPatchPlugin;
+//# sourceMappingURL=vite-client-patch.js.map

package/lib/plugins/vite-client-patch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vite-client-patch.js","sourceRoot":"","sources":["../../src/plugins/vite-client-patch.ts"],"names":[],"mappings":";;AAkBA,sDAqBC;AArCD;;;;;;;;;;;;GAYG;AACH,MAAM,wBAAwB,GAC5B,4EAA4E,CAAC;AAE/E,SAAgB,qBAAqB;IACnC,OAAO;QACL,IAAI,EAAE,0BAA0B;QAChC,OAAO,EAAE,MAAM;QACf,KAAK,EAAE,OAAO;QAEd,SAAS,CAAC,IAAI,EAAE,EAAE;YAChB,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC,6BAA6B,CAAC;gBAAE,OAAO;YAExD,IAAI,CAAC,wBAAwB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBACzC,OAAO,CAAC,IAAI,CACV,iFAAiF;oBAC/E,uDAAuD,CAC1D,CAAC;gBACF,OAAO;YACT,CAAC;YAED,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,wBAAwB,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC;YAClF,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;QAC3B,CAAC;KACF,CAAC;AACJ,CAAC;AAED,kBAAe,qBAAqB,CAAC"}

package/lib/plugins/ws-watchdog.d.ts

@@ -0,0 +1,22 @@
+import type { Plugin } from 'vite';
+/**
+ * 检测沙箱代理链路下的 WebSocket 僵尸连接。
+ *
+ * 客户端 5s ping 一次（通过 vite hot.send），连续 2 次拿不到 pong 判死，
+ * 向 parent window 发 `postMessage({ type: 'disconnected' })` 通知沙箱外壳。
+ *
+ * 仅 dev 期生效（`apply: 'serve'`）；本地裸 dev 也开，不会有副作用——
+ * parent 不是沙箱时 postMessage 无消费者，自然丢弃。
+ */
+export interface WsWatchdogPluginOptions {
+    pingEvent?: string;
+    pongEvent?: string;
+    /**
+     * 客户端 base path（如 `/app/app_xxx`）。沙箱网关把完整路径透传给 Vite，
+     * middleware 匹配和注入的 `<script src>` 都必须带 base；空串退化到裸路径。
+     */
+    clientBasePath?: string;
+}
+export declare function wsWatchdogPlugin(options?: WsWatchdogPluginOptions): Plugin;
+export default wsWatchdogPlugin;
+//# sourceMappingURL=ws-watchdog.d.ts.map

package/lib/plugins/ws-watchdog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws-watchdog.d.ts","sourceRoot":"","sources":["../../src/plugins/ws-watchdog.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAqB,MAAM,MAAM,CAAC;AAItD;;;;;;;;GAQG;AACH,MAAM,WAAW,uBAAuB;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAUD,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,uBAA4B,GAAG,MAAM,CA6D9E;AAED,eAAe,gBAAgB,CAAC"}