@lark-apaas/coding-preset-vite-react 0.1.1-alpha.0 → 0.1.1

package/lib/plugins/capabilities.js

@@ -0,0 +1,151 @@
+"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.capabilitiesBundlePlugin = capabilitiesBundlePlugin;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const VIRTUAL_ID = 'virtual:capabilities';
+const RESOLVED = '\0' + VIRTUAL_ID;
+// jsPage 约定的 capability 目录（老 fullstack 路径 `server/capabilities/` 不兼容）
+const DEFAULT_DIRS = ['shared/capabilities'];
+/**
+ * 把业务工程 `<dir>/*.json` 的 capability 配置打成 `virtual:capabilities` 虚拟模块。
+ *
+ * `@lark-apaas/client-capability` SDK（被 client-toolkit-lite 内联使用）会
+ * `import map from 'virtual:capabilities'` 取这个 map。SDK 在 dev 预览 / 沙箱
+ * 加载流程中依赖这个模块存在，所以即使 capabilities 目录为空，也必须把模块
+ * 注册成解析成功（空 map），否则 rolldown 在 build 时直接 fail。
+ *
+ * 同时通过 `optimizeDeps.esbuildOptions.plugins` 在 depOptimizer 那条路径上
+ * 也提供解析——因为 client-toolkit-lite 是 pre-bundle 进来的，pre-bundle 的
+ * esbuild 不会经过 Vite 主 pipeline 的 plugin 链。
+ *
+ * V1 限制：dev 期更改 capability JSON 后，pre-bundle 产物里的 map 是启动时快照，
+ * 不会自动刷新；新增 / 修改 capability 后需要重启 dev server。
+ */
+function capabilitiesBundlePlugin(options = {}) {
+    let rootDir = process.cwd();
+    function listDirs() {
+        if (options.dir)
+            return [path.resolve(rootDir, options.dir)];
+        return DEFAULT_DIRS.map((d) => path.resolve(rootDir, d));
+    }
+    function loadMap() {
+        const map = {};
+        for (const abs of listDirs()) {
+            if (!fs.existsSync(abs))
+                continue;
+            for (const f of fs.readdirSync(abs)) {
+                if (!f.endsWith('.json'))
+                    continue;
+                try {
+                    const cfg = JSON.parse(fs.readFileSync(path.join(abs, f), 'utf-8'));
+                    if (cfg?.id)
+                        map[cfg.id] = cfg;
+                }
+                catch (e) {
+                    console.warn(`[miaoda-capabilities] skip invalid json: ${path.join(abs, f)}: ${e instanceof Error ? e.message : String(e)}`);
+                }
+            }
+        }
+        return map;
+    }
+    return {
+        name: 'miaoda-capabilities-bundle',
+        configResolved(config) {
+            rootDir = config.root;
+        },
+        // 同时通过 depOptimizer 的 Rolldown 注入解析，让 client-toolkit-lite 这种
+        // pre-bundle 进来的依赖也能把 `import 'virtual:capabilities'` 解掉。
+        // Vite 8 用 Rolldown 替换了 esbuild 做 depOptimize，所以走 rolldownOptions.plugins。
+        config(_userConfig, _env) {
+            // `rolldownOptions` 是 Vite 8 引入的 depOptimizer 新 API，
+            // 当前 Vite 类型还没覆盖，需要 as any 绕过
+            return {
+                optimizeDeps: {
+                    rolldownOptions: {
+                        plugins: [
+                            {
+                                name: 'miaoda-capabilities-rolldown',
+                                resolveId(source) {
+                                    if (source === VIRTUAL_ID)
+                                        return RESOLVED;
+                                    return null;
+                                },
+                                load(id) {
+                                    if (id !== RESOLVED)
+                                        return null;
+                                    return `export default ${JSON.stringify(loadMap())};`;
+                                },
+                            },
+                        ],
+                    },
+                },
+            };
+        },
+        resolveId(id) {
+            if (id === VIRTUAL_ID)
+                return RESOLVED;
+            return null;
+        },
+        load(id) {
+            if (id !== RESOLVED)
+                return null;
+            return `export default ${JSON.stringify(loadMap())};`;
+        },
+        configureServer(server) {
+            for (const abs of listDirs()) {
+                if (fs.existsSync(abs))
+                    server.watcher.add(abs);
+            }
+            const watching = listDirs();
+            const handle = (file) => {
+                if (!file.endsWith('.json'))
+                    return;
+                if (!watching.some((d) => file.startsWith(d)))
+                    return;
+                const mod = server.moduleGraph.getModuleById(RESOLVED);
+                if (mod)
+                    server.moduleGraph.invalidateModule(mod);
+                server.ws.send({ type: 'full-reload', path: '*' });
+            };
+            server.watcher.on('add', handle);
+            server.watcher.on('change', handle);
+            server.watcher.on('unlink', handle);
+        },
+    };
+}
+exports.default = capabilitiesBundlePlugin;
+//# sourceMappingURL=capabilities.js.map

package/lib/plugins/capabilities.js.map

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

package/lib/plugins/dev-logs.d.ts

@@ -0,0 +1,44 @@
+import type { Plugin } from 'vite';
+/**
+ * 客户端日志收集 + 读取 + SSE 流式 endpoint。
+ *
+ * 写入：
+ *   - `POST <basePath>/dev/logs/collect`        单条 log（`{ message, ... }`）
+ *   - `POST <basePath>/dev/logs/collect-batch`  数组批量 log
+ *
+ * 读取：
+ *   - `GET <basePath>/dev/logs/files/:fileName?page=1&pageSize=200`
+ *     倒序分页读 `<logDir>/<fileName>` 任意文件，防 path traversal，max pageSize 2000
+ *   - `GET <basePath>/dev/logs/server-logs?limit=100&offset=0&levels=error,warn&sources=client-std`
+ *     合并 4 个常见日志文件（server.log / trace.log / server.std.log / client.std.log）
+ *     的 entries，按 timestamp desc 排序后分页 + 过滤
+ *   - `GET <basePath>/dev/logs/server-logs/stream`（SSE）
+ *     `LogWatcher` 增量监听 4 个文件，新行实时推送
+ *
+ * jsPage 说明：endpoint 名字带 "server-" 是历史遗留（与 `client-toolkit` 写死的路径
+ * 兼容，见 `client-toolkit/src/server-log/poller.ts`）；实际只监测一个文件
+ * `client.std.log`（dev.mjs 写的）。上游另外那 3 个（`server.log`、`trace.log`、
+ * `server.std.log`）是 fullstack 后端的产物，jsPage 不产、也没消费者，全部砍掉。
+ *
+ * 写入路径：`<logDir>/<fileName>`（默认 `./logs/client.log`，由 `LOG_DIR` 环境变量改写）。
+ *
+ * 移植自上游 `@lark-apaas/devtool-kits` 的 `dev-logs` + `collect-logs` middlewares。
+ * 仍然不补的 fullstack-only endpoints：
+ *   - `/app/trace/:traceId`、`/trace/recent`、`/trace/trigger/*`、`/trace/capability/list`
+ *     —— 全是 server-side trace.log 的索引接口
+ *   - `/api-list` —— 从 fullstack server 抓 API route 清单
+ *   - `/health` —— 重复（本 preset 有独立 `/dev/health`）
+ */
+export interface DevLogsPluginOptions {
+    /** 日志写入目录。默认 `process.env.LOG_DIR ?? './logs'`。 */
+    logDir?: string;
+    /** 日志文件名。默认 `client.log`。 */
+    fileName?: string;
+    /** Body 大小上限（bytes）。默认 20 MB。 */
+    bodyLimit?: number;
+    /** 接口基路径前缀（沙箱 base path）。默认空。 */
+    basePath?: string;
+}
+export declare function devLogsPlugin(options?: DevLogsPluginOptions): Plugin;
+export default devLogsPlugin;
+//# sourceMappingURL=dev-logs.d.ts.map

package/lib/plugins/dev-logs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-logs.d.ts","sourceRoot":"","sources":["../../src/plugins/dev-logs.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,MAAM,EAAiB,MAAM,MAAM,CAAC;AAElD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,WAAW,oBAAoB;IACnC,mDAAmD;IACnD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,6BAA6B;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iCAAiC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iCAAiC;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AA0YD,wBAAgB,aAAa,CAAC,OAAO,GAAE,oBAAyB,GAAG,MAAM,CAqKxE;AAED,eAAe,aAAa,CAAC"}