@fluojs/terminus 1.0.0-beta.3 → 1.0.0-beta.4

package/README.ko.md

@@ -23,6 +23,8 @@ fluo 애플리케이션을 위한 헬스 인디케이터(Health Indicator) 툴
 pnpm add @fluojs/terminus
 ```
 
+`path`로 health endpoint를 custom path 아래에 mount할 수 있고, `readinessChecks`로 애플리케이션별 readiness logic을 Terminus indicator 및 platform readiness check와 합성할 수 있습니다.
+
 ## 사용 시점
 
 - 외부 의존성(데이터베이스, Redis, API 등)의 상태를 애플리케이션 헬스 체크 결과에 포함해야 할 때.
@@ -114,6 +116,7 @@ TerminusModule.forRoot({
 - 지원하지 않는 status, 빈 결과, 객체가 아닌 인디케이터 결과는 조용히 버려지지 않고 `down` 진단으로 보고됩니다.
 - 같은 실행에서 이미 보고된 key를 다른 인디케이터가 다시 사용하면, Terminus는 먼저 기록된 entry를 유지하고 데이터를 조용히 덮어쓰는 대신 결정적인 `*-duplicate-key-error` contributor를 추가합니다.
 - 플랫폼 health/readiness 실패는 `/health` 응답에서 결정적인 `fluo-platform-health`, `fluo-platform-readiness` contributor로 노출됩니다.
+- Runtime diagnostics가 있으면 `/health` response에 platform health/readiness detail을 담은 `platform` block이 포함될 수 있습니다.
 
 ## 공개 API 개요
 
@@ -121,6 +124,7 @@ TerminusModule.forRoot({
 
 - `static forRoot(options: TerminusModuleOptions): ModuleType`
   - 인디케이터 및 provider 등록을 위한 메인 엔트리 포인트입니다.
+  - Option에는 `indicators`, `indicatorProviders`, `readinessChecks`, `execution.indicatorTimeoutMs`, `path`가 포함됩니다.
 
 ### `TerminusHealthService`
 
@@ -129,6 +133,12 @@ TerminusModule.forRoot({
 - `isHealthy(): Promise<boolean>`
   - 현재 집계 결과가 완전히 healthy 상태인지 반환합니다.
 
+### 직접 helper와 token
+
+- `runHealthCheck(...)`, `assertHealthCheck(...)`: 직접 aggregation/testing helper입니다.
+- `TERMINUS_HEALTH_INDICATORS`, `TERMINUS_INDICATOR_PROVIDER_TOKENS`: 등록된 indicator와 provider token을 위한 DI token입니다.
+- Built-in indicator는 `create*HealthIndicator()` 및 `create*HealthIndicatorProvider()` helper도 노출합니다.
+
 ### `@fluojs/terminus/redis`
 
 - `RedisHealthIndicator`, `createRedisHealthIndicator()`, `createRedisHealthIndicatorProvider()`

package/README.md

@@ -103,6 +103,8 @@ TerminusModule.forRoot({
 });
 ```
 
+Use `path` to mount the health endpoints under a custom path, and `readinessChecks` to compose application-specific readiness logic with Terminus indicator and platform readiness checks.
+
 ### Failure Semantics
 
 When an indicator fails, it throws a `HealthCheckError`. The `TerminusHealthService` aggregates these failures into a report:
@@ -114,6 +116,7 @@ When an indicator fails, it throws a `HealthCheckError`. The `TerminusHealthServ
 - Unsupported, empty, or non-object indicator results are reported as `down` diagnostics instead of being silently discarded.
 - If an indicator reuses a key that was already reported earlier in the same run, Terminus keeps the first entry and adds a deterministic `*-duplicate-key-error` contributor instead of silently overwriting data.
 - Platform health/readiness failures are surfaced as deterministic `fluo-platform-health` and `fluo-platform-readiness` contributors in `/health` responses.
+- `/health` responses may include a `platform` block with platform health/readiness details when runtime diagnostics are available.
 
 ## Public API Overview
 
@@ -121,6 +124,7 @@ When an indicator fails, it throws a `HealthCheckError`. The `TerminusHealthServ
 
 - `static forRoot(options: TerminusModuleOptions): ModuleType`
   - Main entry point for registering indicators and providers.
+  - Options include `indicators`, `indicatorProviders`, `readinessChecks`, `execution.indicatorTimeoutMs`, and `path`.
 
 ### `TerminusHealthService`
 
@@ -129,6 +133,12 @@ When an indicator fails, it throws a `HealthCheckError`. The `TerminusHealthServ
 - `isHealthy(): Promise<boolean>`
   - Returns whether the current aggregated report is fully healthy.
 
+### Direct helpers and tokens
+
+- `runHealthCheck(...)`, `assertHealthCheck(...)`: Direct aggregation/testing helpers.
+- `TERMINUS_HEALTH_INDICATORS`, `TERMINUS_INDICATOR_PROVIDER_TOKENS`: DI tokens for registered indicators and provider tokens.
+- Built-in indicators also expose `create*HealthIndicator()` and `create*HealthIndicatorProvider()` helpers.
+
 ### `@fluojs/terminus/redis`
 
 - `RedisHealthIndicator`, `createRedisHealthIndicator()`, `createRedisHealthIndicatorProvider()`

package/package.json

@@ -9,7 +9,7 @@
     "liveness",
     "health-check"
   ],
-  "version": "1.0.0-beta.3",
+  "version": "1.0.0-beta.4",
   "private": false,
   "license": "MIT",
   "repository": {
@@ -40,15 +40,15 @@
     "dist"
   ],
   "dependencies": {
-    "@fluojs/di": "^1.0.0-beta.4",
-    "@fluojs/http": "^1.0.0-beta.3",
-    "@fluojs/core": "^1.0.0-beta.2",
-    "@fluojs/runtime": "^1.0.0-beta.4"
+    "@fluojs/core": "^1.0.0-beta.4",
+    "@fluojs/di": "^1.0.0-beta.6",
+    "@fluojs/http": "^1.0.0-beta.10",
+    "@fluojs/runtime": "^1.0.0-beta.11"
   },
   "peerDependencies": {
-    "@fluojs/drizzle": "^1.0.0-beta.2",
-    "@fluojs/prisma": "^1.0.0-beta.2",
-    "@fluojs/redis": "^1.0.0-beta.2"
+    "@fluojs/drizzle": "^1.0.0-beta.3",
+    "@fluojs/prisma": "^1.0.0-beta.3",
+    "@fluojs/redis": "^1.0.0-beta.3"
   },
   "peerDependenciesMeta": {
     "@fluojs/drizzle": {