@ynight/cli 0.0.0-stage → 0.0.1

package/dist/dev-proxy.js

@@ -0,0 +1,98 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.installDevProxy = installDevProxy;
+const tslib_1 = require("tslib");
+const node_http_1 = tslib_1.__importDefault(require("node:http"));
+/**
+ * 在开发模式下，仅把前端 HMR 与开发产物相关的请求代理到 Webpack Dev Server，
+ * 其余请求（业务 API、页面 HTML、静态资源中需鉴权的部分）继续交给 Koa 框架处理。
+ *
+ * 路由策略（仅放行下列请求方法与路径前缀）：
+ * - 仅处理 `GET` / `HEAD`；
+ * - `/__webpack_hmr`            webpack-hot-middleware 长连接（SSE）；
+ * - `/dist/dev/...`             开发模式下的 js/css/asset 产物；
+ * - `/assets/...`               静态资源（虽然通常会经过框架校验，但开发期以原始
+ *                                文件形式由 webpack-dev-middleware 接管更高效）。
+ *
+ * 设计动机：保持单一域名，便于在登录态 Cookie / CSRF 等安全约束下做 HMR；
+ * 仅放行最关键的几个前缀，避免暴露完整 webpack-dev-server。
+ *
+ * @param managed 当前被管理的 Koa 应用（带 `app.middleware`）。
+ * @param port Webpack Dev Server 监听端口（来自 `config.dev.webPort`）。
+ * @returns 卸载代理中间件的清理函数；通常在切换前后端实例时调用。
+ */
+function installDevProxy(managed, port) {
+    // 待关闭请求表：用于在卸载代理时立刻终止长连接 / 未完成的上行请求。
+    const pending = new Map();
+    const proxyMiddleware = async (ctx, next) => {
+        // 路径/方法白名单：只有命中规则的请求才转发到 webpack-dev-server。
+        if (!['GET', 'HEAD'].includes(ctx.method) ||
+            !(ctx.path === '/__webpack_hmr' ||
+                ctx.path.startsWith('/dist/dev/') ||
+                ctx.path.startsWith('/assets/'))) {
+            await next();
+            return;
+        }
+        // 接管响应：ctx.respond = false 后由我们直接写回 res。
+        ctx.respond = false;
+        await new Promise(resolve => {
+            // settled 用于幂等收尾：上游结束 / 异常 / 客户端断开 三个事件都可能先发生。
+            let settled = false;
+            const upstream = node_http_1.default.request(
+            // 始终指向本机回环，避免外网访问开发服务；端口来自 dev.webPort。
+            { host: '127.0.0.1', port, path: ctx.url, method: ctx.method }, response => {
+                // 直接转发上游响应头和响应体。
+                ctx.res.writeHead(response.statusCode ?? 502, response.headers);
+                response.pipe(ctx.res);
+                response.once('error', fail);
+                response.once('end', finish);
+            });
+            // finish：幂等清理，避免重复 resolve / destroy。
+            const finish = () => {
+                if (settled) {
+                    return;
+                }
+                settled = true;
+                upstream.destroy();
+                pending.delete(upstream);
+                ctx.res.removeListener('close', finish);
+                resolve();
+            };
+            // fail：异常路径，写 502 与友好提示后退出 Promise。
+            const fail = () => {
+                if (settled) {
+                    return;
+                }
+                // 头未发出时主动写 502，否则依赖下游处理。
+                if (!ctx.res.headersSent) {
+                    ctx.res.writeHead(502, { 'Content-Type': 'text/plain; charset=utf-8' });
+                }
+                if (!ctx.res.writableEnded) {
+                    ctx.res.end('前端开发服务暂时不可用');
+                }
+                finish();
+            };
+            pending.set(upstream, finish);
+            // 客户端提前断开时同样走 finish，释放上游 socket。
+            ctx.res.once('close', finish);
+            upstream.once('error', fail);
+            upstream.end();
+        });
+    };
+    // unshift：保证代理中间件最先匹配，避免被框架业务中间件抢先处理。
+    managed.app.middleware.unshift(proxyMiddleware);
+    return () => {
+        // 卸载代理中间件：仅移除本次安装的实例，避免误删其他中间件。
+        const middlewareIndex = managed.app.middleware.indexOf(proxyMiddleware);
+        if (middlewareIndex !== -1) {
+            managed.app.middleware.splice(middlewareIndex, 1);
+        }
+        // 主动中断所有进行中的上行请求，防止重新加载阶段出现悬挂连接。
+        for (const [request, finish] of pending) {
+            request.destroy();
+            finish();
+        }
+        pending.clear();
+    };
+}
+//# sourceMappingURL=dev-proxy.js.map

package/dist/dev-proxy.js.map

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

package/dist/dev-watcher.d.ts

@@ -0,0 +1,24 @@
+import type { ElpisConfig } from '@ynight/framework/server';
+export interface ProjectWatchEvent {
+    event: 'add' | 'change' | 'unlink';
+    path: string;
+}
+export interface ProjectWatcher {
+    /**
+     * 配置文件改变后刷新监听范围。监听器本身保持事件驱动，不重新扫描整个项目。
+     */
+    refresh(config: ElpisConfig): Promise<void>;
+    /** 关闭底层文件监听器并释放文件描述符。 */
+    close(): Promise<void>;
+}
+/**
+ * 创建项目级事件监听器。
+ *
+ * 监听策略：
+ * - 通过操作系统文件事件监听变化，不以固定时间间隔扫描目录；
+ * - 只关注业务源目录和影响服务加载的关键文件；
+ * - 配置变化后重建监听器，使动态 businessDir / model.dir 立即生效；
+ * - 不监听 `.elpis`、`dist`、`node_modules` 等生成目录，避免自触发循环。
+ */
+export declare function watchProject(root: string, config: ElpisConfig, onChange: (event: ProjectWatchEvent) => void, onError: (error: unknown) => void): Promise<ProjectWatcher>;
+//# sourceMappingURL=dev-watcher.d.ts.map

package/dist/dev-watcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-watcher.d.ts","sourceRoot":"","sources":["../src/dev-watcher.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,KAAK,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACnC,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,OAAO,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,yBAAyB;IACzB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AA2QD;;;;;;;;GAQG;AACH,wBAAsB,YAAY,CAChC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,WAAW,EACnB,QAAQ,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,EAC5C,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GAChC,OAAO,CAAC,cAAc,CAAC,CA6BzB"}

package/dist/dev-watcher.js

@@ -0,0 +1,242 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.watchProject = watchProject;
+const tslib_1 = require("tslib");
+const node_fs_1 = tslib_1.__importDefault(require("node:fs"));
+const node_path_1 = tslib_1.__importDefault(require("node:path"));
+const chokidar_1 = tslib_1.__importDefault(require("chokidar"));
+const SOURCE_FILE = /\.(?:ts|js|cjs)$/;
+const CONFIG_FILES = ['elpis.config.ts', 'elpis.config.js', 'elpis.config.cjs'];
+function resolveWatchRoots(root, config) {
+    return [
+        node_path_1.default.resolve(root, config.server?.businessDir ?? 'server'),
+        node_path_1.default.resolve(root, config.model?.dir ?? 'model'),
+        node_path_1.default.resolve(root, 'shared'),
+    ];
+}
+function resolveWatchFiles(root, config) {
+    return [
+        ...CONFIG_FILES.map(file => node_path_1.default.resolve(root, file)),
+        node_path_1.default.resolve(root, 'tsconfig.server.json'),
+        ...(config.server?.entry ? [node_path_1.default.resolve(root, config.server.entry)] : []),
+        ...(config.model?.controlContracts ? [node_path_1.default.resolve(root, config.model.controlContracts)] : []),
+    ];
+}
+function resolveWatchTarget(candidate, root) {
+    let current = node_path_1.default.resolve(candidate);
+    // 配置路径可能是项目根外的绝对路径；不让向上回退越过真实项目根。
+    if (!isWithin(current, root)) {
+        return root;
+    }
+    while (current !== root && !node_fs_1.default.existsSync(current)) {
+        current = node_path_1.default.dirname(current);
+    }
+    return current;
+}
+/**
+ * 生成监听目标。已存在的业务目录单独递归监听；不存在的目录/文件只监听最近的
+ * 已存在父目录，并由 ignored 规则沿着配置路径放行，避免把整个临时目录递归打开。
+ */
+function resolveWatchPlan(root, config) {
+    const roots = resolveWatchRoots(root, config);
+    const files = resolveWatchFiles(root, config);
+    const targets = new Set();
+    const shallowTargets = new Set();
+    for (const directory of roots) {
+        if (node_fs_1.default.existsSync(directory) && node_fs_1.default.statSync(directory).isDirectory()) {
+            targets.add(directory);
+        }
+        else {
+            const parent = resolveWatchTarget(directory, root);
+            targets.add(parent);
+            shallowTargets.add(parent);
+        }
+    }
+    for (const file of files) {
+        // 配置文件采用 first-existing 语义：已有一种扩展名时，不为其它候选文件
+        // 把项目根目录提升为递归监听目标。
+        if (CONFIG_FILES.includes(node_path_1.default.basename(file)) &&
+            !node_fs_1.default.existsSync(file) &&
+            CONFIG_FILES.some(candidate => node_fs_1.default.existsSync(node_path_1.default.resolve(root, candidate)))) {
+            continue;
+        }
+        if (node_fs_1.default.existsSync(file)) {
+            targets.add(file);
+        }
+        else {
+            const parent = resolveWatchTarget(file, root);
+            targets.add(parent);
+            shallowTargets.add(parent);
+        }
+    }
+    // 已有递归目录覆盖了某个浅层父目录时，不需要重复声明浅层规则。
+    for (const parent of shallowTargets) {
+        if ([...targets].some(target => target !== parent && isWithin(parent, target))) {
+            shallowTargets.delete(parent);
+        }
+    }
+    return { targets: [...targets], shallowTargets: [...shallowTargets] };
+}
+function isWithin(candidate, parent) {
+    return candidate === parent || candidate.startsWith(parent + node_path_1.default.sep);
+}
+function mapConfigPath(value, logicalRoot, physicalRoot) {
+    if (!node_path_1.default.isAbsolute(value)) {
+        return value;
+    }
+    const resolved = node_path_1.default.resolve(value);
+    return isWithin(resolved, logicalRoot)
+        ? node_path_1.default.resolve(physicalRoot, node_path_1.default.relative(logicalRoot, resolved))
+        : value;
+}
+function mapConfigToPhysicalRoot(config, logicalRoot, physicalRoot) {
+    const mapped = { ...config };
+    if (config.server) {
+        mapped.server = { ...config.server };
+        if (config.server.businessDir !== undefined) {
+            mapped.server.businessDir = mapConfigPath(config.server.businessDir, logicalRoot, physicalRoot);
+        }
+        if (config.server.entry !== undefined) {
+            mapped.server.entry = mapConfigPath(config.server.entry, logicalRoot, physicalRoot);
+        }
+    }
+    if (config.model) {
+        mapped.model = { ...config.model };
+        if (config.model.dir !== undefined) {
+            mapped.model.dir = mapConfigPath(config.model.dir, logicalRoot, physicalRoot);
+        }
+        if (config.model.controlContracts !== undefined) {
+            mapped.model.controlContracts = mapConfigPath(config.model.controlContracts, logicalRoot, physicalRoot);
+        }
+    }
+    return mapped;
+}
+function mapWatchEventPath(eventPath, logicalRoot, physicalRoot) {
+    const resolved = node_path_1.default.resolve(eventPath);
+    return isWithin(resolved, physicalRoot)
+        ? node_path_1.default.resolve(logicalRoot, node_path_1.default.relative(physicalRoot, resolved))
+        : resolved;
+}
+function isDirectoryCandidate(root, config, candidate, stats) {
+    if (stats) {
+        return stats.isDirectory();
+    }
+    try {
+        return node_fs_1.default.statSync(candidate).isDirectory();
+    }
+    catch {
+        const normalized = node_path_1.default.resolve(candidate);
+        // chokidar 可能在新目录完成 stat 前调用 ignored；此时用配置路径判断，
+        // 避免带点号的目录（如 business.v1）或其新建子目录被当成文件提前过滤。
+        return resolveWatchRoots(root, config).some(watchRoot => normalized === watchRoot ||
+            isWithin(watchRoot, normalized) ||
+            isWithin(normalized, watchRoot));
+    }
+}
+function ignoredPath(root, config, candidate, isDirectory, shallowTargets = []) {
+    const normalized = node_path_1.default.resolve(candidate);
+    const ignoredDirectoryNames = new Set(['.git', '.elpis', 'node_modules', 'dist', 'logs']);
+    const relative = node_path_1.default.relative(root, normalized);
+    if (relative && relative.split(node_path_1.default.sep).some(part => ignoredDirectoryNames.has(part))) {
+        return true;
+    }
+    const roots = resolveWatchRoots(root, config);
+    const files = resolveWatchFiles(root, config);
+    if (isDirectory) {
+        // 浅层父目录只为发现缺失的配置目录服务。沿配置路径继续放行，
+        // 其余目录在这里截断，避免临时目录中的大量无关子目录触发 EMFILE。
+        if (shallowTargets.some(shallow => normalized !== shallow && isWithin(shallow, normalized))) {
+            const existingRoots = roots.filter(directory => {
+                try {
+                    return node_fs_1.default.statSync(directory).isDirectory();
+                }
+                catch {
+                    return false;
+                }
+            });
+            if (existingRoots.some(directory => normalized !== directory && isWithin(normalized, directory))) {
+                return true;
+            }
+            if (!roots.some(watchRoot => isWithin(normalized, watchRoot) || isWithin(watchRoot, normalized)) &&
+                !files.some(file => isWithin(normalized, file))) {
+                return true;
+            }
+        }
+        // 保留项目根到业务目录之间的路径，以便 chokidar 能继续向下监听。
+        return (!roots.some(watchRoot => isWithin(normalized, watchRoot) || isWithin(watchRoot, normalized)) && normalized !== root);
+    }
+    return !(files.includes(normalized) ||
+        (SOURCE_FILE.test(normalized) && roots.some(watchRoot => isWithin(normalized, watchRoot))));
+}
+async function openWatcher(root, config, onChange, onError) {
+    const plan = resolveWatchPlan(root, config);
+    const { targets, shallowTargets } = plan;
+    const watcher = chokidar_1.default.watch(targets, {
+        // 初始生成由 dev-entry 负责，避免启动时把所有已有文件当作变更事件。
+        ignoreInitial: true,
+        followSymlinks: false,
+        persistent: true,
+        // 不启用 awaitWriteFinish：它内部会轮询文件大小，防抖由上层统一处理。
+        ignored: (candidate, stats) => ignoredPath(root, config, candidate, isDirectoryCandidate(root, config, candidate, stats), shallowTargets),
+    });
+    watcher.on('add', filePath => onChange({ event: 'add', path: node_path_1.default.resolve(filePath) }));
+    watcher.on('change', filePath => onChange({ event: 'change', path: node_path_1.default.resolve(filePath) }));
+    watcher.on('unlink', filePath => onChange({ event: 'unlink', path: node_path_1.default.resolve(filePath) }));
+    watcher.on('error', onError);
+    await new Promise((resolve, reject) => {
+        const ready = () => {
+            cleanup();
+            resolve();
+        };
+        const fail = (error) => {
+            cleanup();
+            void watcher.close().finally(() => reject(error));
+        };
+        const cleanup = () => {
+            watcher.removeListener('ready', ready);
+            watcher.removeListener('error', fail);
+        };
+        watcher.once('ready', ready);
+        watcher.once('error', fail);
+    });
+    return watcher;
+}
+/**
+ * 创建项目级事件监听器。
+ *
+ * 监听策略：
+ * - 通过操作系统文件事件监听变化，不以固定时间间隔扫描目录；
+ * - 只关注业务源目录和影响服务加载的关键文件；
+ * - 配置变化后重建监听器，使动态 businessDir / model.dir 立即生效；
+ * - 不监听 `.elpis`、`dist`、`node_modules` 等生成目录，避免自触发循环。
+ */
+async function watchProject(root, config, onChange, onError) {
+    const logicalRoot = node_path_1.default.resolve(root);
+    const physicalRoot = node_fs_1.default.realpathSync(logicalRoot);
+    const physicalConfig = mapConfigToPhysicalRoot(config, logicalRoot, physicalRoot);
+    const emitChange = (event) => onChange({
+        ...event,
+        path: mapWatchEventPath(event.path, logicalRoot, physicalRoot),
+    });
+    let watcher = await openWatcher(physicalRoot, physicalConfig, emitChange, onError);
+    let closed = false;
+    return {
+        async refresh(nextConfig) {
+            if (closed) {
+                return;
+            }
+            const previous = watcher;
+            const nextPhysicalConfig = mapConfigToPhysicalRoot(nextConfig, logicalRoot, physicalRoot);
+            watcher = await openWatcher(physicalRoot, nextPhysicalConfig, emitChange, onError);
+            await previous.close();
+        },
+        async close() {
+            if (closed) {
+                return;
+            }
+            closed = true;
+            await watcher.close();
+        },
+    };
+}
+//# sourceMappingURL=dev-watcher.js.map

package/dist/dev-watcher.js.map

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

package/dist/generate-types.d.ts

@@ -0,0 +1,14 @@
+import type { ElpisMode } from '@ynight/framework/server';
+/**
+ * 生成业务模块的类型声明文件 `.elpis/types/application.d.ts`。
+ *
+ * 通过给 `@ynight/framework/server` 模块声明合并接口，业务侧即可在
+ * `app.service('user').foo()` 等链式调用上拿到具体类型提示。
+ *
+ * @param root 业务工程根目录。
+ * @param check 是否只校验不写文件；为 `true` 时若已过期会抛出错误，便于 CI 阻断。
+ * @param mode 运行模式（development / production），影响配置文件加载。
+ * @returns 文件是否发生变化；`check` 模式下为 `false`。
+ */
+export declare function generateTypes(root: string, check?: boolean, mode?: ElpisMode): boolean;
+//# sourceMappingURL=generate-types.d.ts.map

package/dist/generate-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-types.d.ts","sourceRoot":"","sources":["../src/generate-types.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAgL1D;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,EACZ,KAAK,UAAQ,EACb,IAAI,GAAE,SAAyB,GAC9B,OAAO,CA6CT"}

package/dist/generate-types.js

@@ -0,0 +1,190 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateTypes = generateTypes;
+const tslib_1 = require("tslib");
+const node_fs_1 = tslib_1.__importDefault(require("node:fs"));
+const node_path_1 = tslib_1.__importDefault(require("node:path"));
+const project_config_1 = require("./project-config");
+const utils_1 = require("./utils");
+const output_safety_1 = require("./output-safety");
+/**
+ * 把业务文件路径转换为"模块路径段"，最终用于声明对象的层级键名。
+ *
+ * 转换规则：
+ * 1. 取相对根目录的路径，去掉扩展名；
+ * 2. 按目录分段；
+ * 3. 每段 `camelCase` 后再做 `.` 拆分（允许文件名本身已含 `.` 形成多级键）。
+ *
+ * 例如 `server/service/user-profile.ts` → `['userProfile']`；
+ * `server/service/user.profile.ts`     → `['user', 'profile']`。
+ */
+function moduleParts(filePath, root) {
+    return node_path_1.default
+        .relative(root, filePath)
+        .replace(/\.(?:ts|js|cjs)$/, '')
+        .split(node_path_1.default.sep)
+        .flatMap(part => (0, utils_1.camelCase)(part).split('.'));
+}
+/**
+ * 把单个业务文件插入到声明树中，必要时创建中间分支节点。
+ *
+ * 冲突检测：
+ * - 当前层级已存在同名 `leaf`，新文件路径又与之不同 → 命名冲突；
+ * - 当前层级已存在子节点，但同时又要插入 `leaf` → 命名冲突；
+ * - 任一冲突都会立即抛出，确保类型生成结果唯一可预测。
+ */
+function insertDeclaration(root, parts, filePath, folder, sourceRoot) {
+    let current = root;
+    parts.forEach((part, index) => {
+        const isLeaf = index === parts.length - 1;
+        let next = current.children.get(part);
+        if (!next) {
+            // 没有则创建一个空分支；后续可能是叶子，也可能是中间节点。
+            next = { children: new Map() };
+            current.children.set(part, next);
+        }
+        if (isLeaf) {
+            // 已经存在文件或子节点，意味着同名冲突。
+            if (next.leaf || next.children.size > 0) {
+                throw new Error(`业务模块命名冲突: ${folder}.${parts.join('.')}`);
+            }
+            next.leaf = {
+                filePath,
+                importName: moduleImportName(filePath, sourceRoot, folder),
+            };
+            return;
+        }
+        // 中间节点却挂着 leaf，意味着"目录"已经是一个文件了。
+        if (next.leaf) {
+            throw new Error(`业务模块命名冲突: ${folder}.${parts.slice(0, index + 1).join('.')}`);
+        }
+        current = next;
+    });
+}
+/**
+ * 把源文件绝对路径转换为生成代码里 `import type` 使用的相对模块路径。
+ *
+ * 路径基准为 `<root>/.elpis/types`，与生成产物在同目录下，便于 TS 解析。
+ * 跨平台兼容：把路径分隔符统一替换为 `/`。
+ */
+function importPath(sourceRoot, filePath) {
+    const relative = node_path_1.default
+        .relative(node_path_1.default.resolve(sourceRoot, '.elpis/types'), filePath)
+        .replace(/\.(?:ts|js|cjs)$/, '')
+        .split(node_path_1.default.sep)
+        .join('/');
+    // `path.relative` 在跨盘时不会加 `./`，需手动补全。
+    return relative.startsWith('.') ? relative : `./${relative}`;
+}
+/**
+ * 把声明树渲染为接口体文本（递归）。
+ *
+ * 输出形如 `import type ServiceName from './path';` 与
+ * `serviceName: InstanceType<typeof ServiceName>;`，
+ * 这样消费方既能得到类型提示，也能避免循环依赖问题。
+ *
+ * 属性名非法时回退为 JSON 字符串，保持语法合法。
+ */
+function renderBranch(branch, sourceRoot, indent, imports) {
+    const lines = [];
+    for (const [name, node] of branch.children) {
+        // 属性名不合法（如数字开头）时用字符串字面量代替。
+        const property = /^[A-Za-z_$][\w$]*$/.test(name) ? name : JSON.stringify(name);
+        if (node.leaf) {
+            imports.push(`import type ${node.leaf.importName} from ${JSON.stringify(importPath(sourceRoot, node.leaf.filePath))};`);
+            lines.push(`${indent}${property}: InstanceType<typeof ${node.leaf.importName}>;`);
+            continue;
+        }
+        lines.push(`${indent}${property}: {`);
+        lines.push(...renderBranch(node, sourceRoot, `${indent}  `, imports));
+        lines.push(`${indent}};`);
+    }
+    return lines;
+}
+/**
+ * 扫描指定业务目录（如 `server/service`）并生成对应声明体。
+ *
+ * 内部维护一棵声明树，确保不同业务模块不会因为路径命名重合而互相覆盖。
+ *
+ * @param sourceRoot 业务工程根目录。
+ * @param folder 相对于 sourceRoot 的目录名（如 `server/service`）。
+ */
+function moduleImportName(filePath, root, folder) {
+    const prefix = folder
+        .split(node_path_1.default.sep)
+        .map(utils_1.camelCase)
+        .map(part => part.charAt(0).toUpperCase() + part.slice(1))
+        .join('');
+    const suffix = moduleParts(filePath, root)
+        .map(part => (part ? part.charAt(0).toUpperCase() + part.slice(1) : ''))
+        .join('');
+    return `${prefix}${suffix || 'Module'}`;
+}
+function declaration(sourceRoot, folder) {
+    const root = node_path_1.default.resolve(sourceRoot, folder);
+    const tree = { children: new Map() };
+    for (const filePath of (0, utils_1.findFiles)(root)) {
+        insertDeclaration(tree, moduleParts(filePath, root), filePath, folder, root);
+    }
+    // 缩进 4 空格与生成产物中的接口体对齐。
+    const imports = [];
+    return { imports, lines: renderBranch(tree, sourceRoot, '    ', imports) };
+}
+/**
+ * 生成业务模块的类型声明文件 `.elpis/types/application.d.ts`。
+ *
+ * 通过给 `@ynight/framework/server` 模块声明合并接口，业务侧即可在
+ * `app.service('user').foo()` 等链式调用上拿到具体类型提示。
+ *
+ * @param root 业务工程根目录。
+ * @param check 是否只校验不写文件；为 `true` 时若已过期会抛出错误，便于 CI 阻断。
+ * @param mode 运行模式（development / production），影响配置文件加载。
+ * @returns 文件是否发生变化；`check` 模式下为 `false`。
+ */
+function generateTypes(root, check = false, mode = 'development') {
+    const config = (0, project_config_1.loadProjectConfig)(root, mode);
+    const businessDir = config.server?.businessDir ?? 'server';
+    const output = (0, output_safety_1.safeGeneratedPath)(root, '.elpis/types/application.d.ts');
+    const services = declaration(root, node_path_1.default.join(businessDir, 'service'));
+    const controllers = declaration(root, node_path_1.default.join(businessDir, 'controller'));
+    const middlewares = declaration(root, node_path_1.default.join(businessDir, 'middleware'));
+    const imports = [
+        ...new Set([...services.imports, ...controllers.imports, ...middlewares.imports]),
+    ].sort();
+    const lines = [
+        // 提示此文件是自动生成，避免业务同学手动修改后被覆盖产生困惑。
+        '// 此文件由 @ynight/cli 生成，请勿手工修改。',
+        ...imports,
+        // 通过 declare module 给框架包内的接口合并业务实现，符合 TS 声明合并协议。
+        "declare module '@ynight/framework/server' {",
+        '  interface BusinessServices {',
+        ...services.lines,
+        '  }',
+        '  interface BusinessControllers {',
+        ...controllers.lines,
+        '  }',
+        '  interface BusinessMiddlewares {',
+        ...middlewares.lines,
+        '  }',
+        '}',
+        // 标记为模块文件，避免脚本上下文被合并到全局。
+        'export {};',
+        '',
+    ];
+    const content = lines.join('\n');
+    const current = node_fs_1.default.existsSync(output) ? node_fs_1.default.readFileSync(output, 'utf8') : undefined;
+    if (check) {
+        // check 模式下仅做差分比对，避免无谓的写入。
+        if (current !== content) {
+            throw new Error(`生成类型已过期，请执行: elpis generate:types\n文件: ${output}`);
+        }
+        return false;
+    }
+    node_fs_1.default.mkdirSync(node_path_1.default.dirname(output), { recursive: true });
+    // 内容未变化时不写盘，避免触发 IDE 重新加载与 git diff。
+    if (current !== content) {
+        node_fs_1.default.writeFileSync(output, content);
+    }
+    return current !== content;
+}
+//# sourceMappingURL=generate-types.js.map

package/dist/generate-types.js.map

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