@hile/cli 1.0.15 → 1.0.16

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/README.md +11 -0
  2. package/dist/index.js +37 -1
  3. package/package.json +3 -3
package/README.md CHANGED
@@ -46,6 +46,17 @@ hile start --env-file .env --env-file .env.local
46
46
 
47
47
  依赖 Node 20.12+ 原生 `process.loadEnvFile()`。
48
48
 
49
+ ### 启动日志(基于 @hile/core 事件)
50
+
51
+ CLI 已接入容器事件日志,默认会输出:
52
+
53
+ - 服务启动:`service:init` / `service:ready`(含耗时)
54
+ - 服务失败:`service:error`
55
+ - 关闭阶段:`service:shutdown:start` / `service:shutdown:done`
56
+ - 容器关闭:`container:shutdown:start` / `container:shutdown:done`
57
+
58
+ 这使得线上启动问题与关闭过程更容易观测。
59
+
49
60
  ### 其他命令
50
61
 
51
62
  ```bash
package/dist/index.js CHANGED
@@ -11,6 +11,37 @@ const require = createRequire(import.meta.url);
11
11
  function loadEnvFile(filePath) {
12
12
  process.loadEnvFile(resolve(process.cwd(), filePath));
13
13
  }
14
+ function logContainerEvent(event) {
15
+ switch (event.type) {
16
+ case 'service:init':
17
+ console.info(`[hile] service#${event.id} init`);
18
+ break;
19
+ case 'service:ready':
20
+ console.info(`[hile] service#${event.id} ready (${event.durationMs}ms)`);
21
+ break;
22
+ case 'service:error':
23
+ console.error(`[hile] service#${event.id} failed (${event.durationMs}ms):`, event.error);
24
+ break;
25
+ case 'service:shutdown:start':
26
+ console.info(`[hile] service#${event.id} stopping`);
27
+ break;
28
+ case 'service:shutdown:done':
29
+ console.info(`[hile] service#${event.id} stopped (${event.durationMs}ms)`);
30
+ break;
31
+ case 'service:shutdown:error':
32
+ console.error(`[hile] service#${event.id} shutdown error:`, event.error);
33
+ break;
34
+ case 'container:shutdown:start':
35
+ console.info('[hile] container shutdown start');
36
+ break;
37
+ case 'container:shutdown:done':
38
+ console.info(`[hile] container shutdown done (${event.durationMs}ms)`);
39
+ break;
40
+ case 'container:error':
41
+ console.error('[hile] container error:', event.error);
42
+ break;
43
+ }
44
+ }
14
45
  program.version(pkg.version, '-v, --version', '当前版本号');
15
46
  /**
16
47
  * 启动服务
@@ -28,6 +59,7 @@ program
28
59
  .option('-e, --env-file <path>', '加载指定 env 文件(兼容 Node --env-file 语义;可多次指定,先加载的不被后加载覆盖)', (v, acc) => (acc.push(v), acc), [])
29
60
  .description('启动服务,加载所有后缀为 boot.ts 或 boot.js 的服务,并注册退出钩子,在进程退出时销毁所有服务')
30
61
  .action(async (options) => {
62
+ const offEvent = container.onEvent(logContainerEvent);
31
63
  // 先加载 --env-file(与 Node --env-file 行为一致:先加载的优先,已存在的 key 不被覆盖)
32
64
  const envFiles = options.envFile ?? [];
33
65
  for (const p of envFiles) {
@@ -68,13 +100,17 @@ program
68
100
  // 如果没有服务要加载,则提示
69
101
  if (!files.length) {
70
102
  console.warn('no services to load');
103
+ offEvent();
71
104
  return;
72
105
  }
73
106
  // 注册退出钩子,在进程退出时销毁所有服务
74
107
  exitHook(exit => {
75
108
  container.shutdown()
76
109
  .catch(e => console.error(e))
77
- .finally(exit);
110
+ .finally(() => {
111
+ offEvent();
112
+ exit();
113
+ });
78
114
  });
79
115
  });
80
116
  program.parseAsync(process.argv);
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@hile/cli",
3
- "version": "1.0.15",
3
+ "version": "1.0.16",
4
4
  "type": "module",
5
5
  "main": "./dist/index.js",
6
6
  "scripts": {
@@ -23,11 +23,11 @@
23
23
  "vitest": "^4.0.18"
24
24
  },
25
25
  "dependencies": {
26
- "@hile/core": "^1.0.17",
26
+ "@hile/core": "^1.0.18",
27
27
  "async-exit-hook": "^2.0.1",
28
28
  "commander": "^14.0.3",
29
29
  "glob": "^13.0.6",
30
30
  "tsx": "^4.21.0"
31
31
  },
32
- "gitHead": "6672fc4cdc551c4265912cc85ee2e96fc44bc4c9"
32
+ "gitHead": "81347b9de460b693ed82af46c0f4a287d4527323"
33
33
  }