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

package/README.ko.md

@@ -111,7 +111,9 @@ TerminusModule.forRoot({
 - 준비 상태(readiness)와 관련된 인디케이터가 실패하면 `/ready`는 HTTP `503`을 반환합니다.
 - 응답 본문은 `status`, `contributors`, `info`, `error`, `details`를 포함한 구조화된 JSON 객체입니다.
 - 하나의 인디케이터가 여러 keyed entry를 반환할 수도 있으며, 이 경우 `/health`는 모든 entry를 `details`와 `contributors.up` / `contributors.down` 요약에 그대로 반영합니다.
+- 지원하지 않는 status, 빈 결과, 객체가 아닌 인디케이터 결과는 조용히 버려지지 않고 `down` 진단으로 보고됩니다.
 - 같은 실행에서 이미 보고된 key를 다른 인디케이터가 다시 사용하면, Terminus는 먼저 기록된 entry를 유지하고 데이터를 조용히 덮어쓰는 대신 결정적인 `*-duplicate-key-error` contributor를 추가합니다.
+- 플랫폼 health/readiness 실패는 `/health` 응답에서 결정적인 `fluo-platform-health`, `fluo-platform-readiness` contributor로 노출됩니다.
 
 ## 공개 API 개요
 

package/README.md

@@ -111,7 +111,9 @@ When an indicator fails, it throws a `HealthCheckError`. The `TerminusHealthServ
 - `/ready` returns HTTP `503` if any indicator associated with readiness fails.
 - The response body contains a structured JSON object with `status`, `contributors`, `info`, `error`, and `details`.
 - Indicators may emit multiple keyed entries in a single check result; `/health` preserves every keyed entry in `details` and in the `contributors.up` / `contributors.down` summaries.
+- 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.
 
 ## Public API Overview
 

package/dist/errors.d.ts

@@ -1,4 +1,7 @@
 import type { HealthIndicatorResult } from './types.js';
+/**
+ * Represents the health check error.
+ */
 export declare class HealthCheckError extends Error {
     readonly causes: HealthIndicatorResult;
     constructor(message: string, causes: HealthIndicatorResult);

package/dist/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAExD,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,QAAQ,CAAC,MAAM,EAAE,qBAAqB,CAAC;gBAE3B,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,qBAAqB;CAK3D"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAExD;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,QAAQ,CAAC,MAAM,EAAE,qBAAqB,CAAC;gBAE3B,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,qBAAqB;CAK3D"}

package/dist/errors.js

@@ -1,3 +1,6 @@
+/**
+ * Represents the health check error.
+ */
 export class HealthCheckError extends Error {
   causes;
   constructor(message, causes) {

package/dist/health-check.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"health-check.d.ts","sourceRoot":"","sources":["../src/health-check.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,2BAA2B,EAC3B,iBAAiB,EACjB,eAAe,EAGhB,MAAM,YAAY,CAAC;AA0LpB;;;;;;GAMG;AACH,wBAAsB,cAAc,CAClC,UAAU,EAAE,SAAS,eAAe,EAAE,EACtC,gBAAgB,GAAE,2BAAgC,GACjD,OAAO,CAAC,iBAAiB,CAAC,CAoB5B;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,iBAAiB,EAAE,OAAO,SAAyB,GAAG,iBAAiB,CAMhH;AAED,0FAA0F;AAC1F,qBAAa,qBAAqB;IAE9B,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,gBAAgB;gBADhB,UAAU,EAAE,SAAS,eAAe,EAAE,EACtC,gBAAgB,GAAE,2BAAgC;IAGrE;;;;OAIG;IACG,KAAK,IAAI,OAAO,CAAC,iBAAiB,CAAC;IAIzC;;;;OAIG;IACG,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC;CAGpC"}
+{"version":3,"file":"health-check.d.ts","sourceRoot":"","sources":["../src/health-check.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,2BAA2B,EAC3B,iBAAiB,EACjB,eAAe,EAGhB,MAAM,YAAY,CAAC;AAsOpB;;;;;;GAMG;AACH,wBAAsB,cAAc,CAClC,UAAU,EAAE,SAAS,eAAe,EAAE,EACtC,gBAAgB,GAAE,2BAAgC,GACjD,OAAO,CAAC,iBAAiB,CAAC,CAoB5B;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,iBAAiB,EAAE,OAAO,SAAyB,GAAG,iBAAiB,CAMhH;AAED,0FAA0F;AAC1F,qBAAa,qBAAqB;IAE9B,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,gBAAgB;gBADhB,UAAU,EAAE,SAAS,eAAe,EAAE,EACtC,gBAAgB,GAAE,2BAAgC;IAGrE;;;;OAIG;IACG,KAAK,IAAI,OAAO,CAAC,iBAAiB,CAAC;IAIzC;;;;OAIG;IACG,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC;CAGpC"}

package/dist/health-check.js

@@ -37,17 +37,47 @@ function hasIndicatorStatus(value) {
   const status = value.status;
   return status === 'up' || status === 'down';
 }
+function createUnsupportedEntryMessage(entryKey) {
+  return entryKey.trim().length > 0 ? `Indicator returned an unsupported status value for result key "${entryKey}".` : 'Indicator returned an unsupported status value for an empty result key.';
+}
 function normalizeIndicatorResult(key, result) {
-  const normalizedEntries = Object.entries(result).filter(([, entryValue]) => hasIndicatorStatus(entryValue));
-  if (normalizedEntries.length > 0) {
-    return Object.fromEntries(normalizedEntries);
+  if (typeof result !== 'object' || result === null || Array.isArray(result)) {
+    return [[key, {
+      message: 'Indicator returned a non-object health result.',
+      status: 'down'
+    }]];
   }
-  return {
-    [key]: {
-      message: 'Indicator returned an unsupported status value.',
+  const normalizedEntries = [];
+  const seenKeys = new Set();
+  const duplicateKeys = [];
+  const entries = Object.entries(result);
+  if (entries.length === 0) {
+    return [[key, {
+      message: 'Indicator returned no health result entries.',
       status: 'down'
+    }]];
+  }
+  for (const [entryKey, entryValue] of entries) {
+    const normalizedKey = hasIndicatorStatus(entryValue) || entryKey.trim().length > 0 ? entryKey : key;
+    if (seenKeys.has(normalizedKey)) {
+      duplicateKeys.push(normalizedKey);
+      continue;
     }
-  };
+    seenKeys.add(normalizedKey);
+    if (hasIndicatorStatus(entryValue)) {
+      normalizedEntries.push([normalizedKey, entryValue]);
+      continue;
+    }
+    normalizedEntries.push([normalizedKey, {
+      message: createUnsupportedEntryMessage(entryKey),
+      status: 'down'
+    }]);
+  }
+  if (duplicateKeys.length > 0) {
+    const duplicateFailure = createDuplicateKeyFailure(key, duplicateKeys, seenKeys);
+    normalizedEntries.push(duplicateFailure);
+  }
+  return normalizedEntries;
 }
 function inferIndicatorKey(indicator, index) {
   const candidateKey = indicator.key;
@@ -85,13 +115,13 @@ async function runIndicator(indicator, index, executionOptions) {
   try {
     const result = indicatorTimeoutMs === undefined ? await indicator.check(key) : await withTimeout(indicator.check(key), indicatorTimeoutMs);
     return {
-      entries: Object.entries(normalizeIndicatorResult(key, result)),
+      entries: normalizeIndicatorResult(key, result),
       indicatorKey: key
     };
   } catch (error) {
     if (error instanceof HealthCheckError) {
       return {
-        entries: Object.entries(normalizeIndicatorResult(key, error.causes)),
+        entries: normalizeIndicatorResult(key, error.causes),
         indicatorKey: key
       };
     }

package/dist/module.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"module.d.ts","sourceRoot":"","sources":["../src/module.ts"],"names":[],"mappings":"AAEA,OAAO,EAGL,KAAK,UAAU,EAGhB,MAAM,iBAAiB,CAAC;AAKzB,OAAO,KAAK,EAAmB,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAgLzE,uFAAuF;AACvF,qBAAa,cAAc;IACzB;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,OAAO,CAAC,OAAO,GAAE,qBAA0B,GAAG,UAAU;CAGhE"}
+{"version":3,"file":"module.d.ts","sourceRoot":"","sources":["../src/module.ts"],"names":[],"mappings":"AAEA,OAAO,EAGL,KAAK,UAAU,EAGhB,MAAM,iBAAiB,CAAC;AAKzB,OAAO,KAAK,EAA4D,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAuRlH,uFAAuF;AACvF,qBAAa,cAAc;IACzB;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,OAAO,CAAC,OAAO,GAAE,qBAA0B,GAAG,UAAU;CAGhE"}

package/dist/module.js

@@ -62,6 +62,85 @@ function createTerminusProviders(options = {}) {
     }
   }];
 }
+function createPlatformHealthDiagnostic(health) {
+  if (health.status === 'healthy') {
+    return undefined;
+  }
+  return {
+    checks: health.checks,
+    message: health.reason ?? `Platform health reported ${health.status}.`,
+    platformStatus: health.status,
+    status: 'down'
+  };
+}
+function createPlatformReadinessDiagnostic(readiness) {
+  if (readiness.status === 'ready') {
+    return undefined;
+  }
+  return {
+    checks: readiness.checks,
+    critical: readiness.critical,
+    message: readiness.reason ?? `Platform readiness reported ${readiness.status}.`,
+    platformStatus: readiness.status,
+    status: 'down'
+  };
+}
+function createPlatformDiagnosticCollisionKey(diagnosticKey, seenKeys) {
+  const baseKey = `${diagnosticKey}-duplicate-key-error`;
+  if (!seenKeys.has(baseKey)) {
+    return baseKey;
+  }
+  let suffix = 2;
+  let candidate = `${baseKey}-${String(suffix)}`;
+  while (seenKeys.has(candidate)) {
+    suffix += 1;
+    candidate = `${baseKey}-${String(suffix)}`;
+  }
+  return candidate;
+}
+function appendPlatformDiagnostic(entries, existingKeys, diagnosticKey, diagnostic) {
+  if (diagnostic === undefined) {
+    return;
+  }
+  if (!existingKeys.has(diagnosticKey) && !(diagnosticKey in entries)) {
+    entries[diagnosticKey] = diagnostic;
+    return;
+  }
+  const collisionKey = createPlatformDiagnosticCollisionKey(diagnosticKey, new Set([...existingKeys, ...Object.keys(entries)]));
+  entries[collisionKey] = {
+    message: `Platform diagnostic key "${diagnosticKey}" collided with an existing health result key.`,
+    status: 'down'
+  };
+}
+function withPlatformDiagnostics(report, health, readiness) {
+  const platformDiagnostics = {};
+  const healthDiagnostic = createPlatformHealthDiagnostic(health);
+  const readinessDiagnostic = createPlatformReadinessDiagnostic(readiness);
+  const existingKeys = new Set(Object.keys(report.details));
+  appendPlatformDiagnostic(platformDiagnostics, existingKeys, 'fluo-platform-health', healthDiagnostic);
+  appendPlatformDiagnostic(platformDiagnostics, existingKeys, 'fluo-platform-readiness', readinessDiagnostic);
+  const platformDiagnosticKeys = Object.keys(platformDiagnostics);
+  return {
+    ...report,
+    contributors: {
+      down: [...report.contributors.down, ...platformDiagnosticKeys],
+      up: [...report.contributors.up]
+    },
+    details: {
+      ...report.details,
+      ...platformDiagnostics
+    },
+    error: {
+      ...report.error,
+      ...platformDiagnostics
+    },
+    platform: {
+      health,
+      readiness
+    },
+    status: report.status === 'ok' && platformDiagnosticKeys.length === 0 ? 'ok' : 'error'
+  };
+}
 function createTerminusRuntimeModule(options = {}) {
   const readinessChecks = [...(options.readinessChecks ?? [])];
   const healthModule = createHealthModule({
@@ -69,17 +148,10 @@ function createTerminusRuntimeModule(options = {}) {
       const healthService = await ctx.container.resolve(TerminusHealthService);
       const platformShell = await ctx.container.resolve(PLATFORM_SHELL);
       const [report, readiness, health] = await Promise.all([healthService.check(), platformShell.ready(), platformShell.health()]);
-      const status = report.status === 'ok' && health.status === 'healthy' && readiness.status === 'ready' ? 'ok' : 'error';
+      const reportWithPlatform = withPlatformDiagnostics(report, health, readiness);
       return {
-        body: {
-          ...report,
-          platform: {
-            health,
-            readiness
-          },
-          status
-        },
-        statusCode: status === 'ok' ? 200 : 503
+        body: reportWithPlatform,
+        statusCode: reportWithPlatform.status === 'ok' ? 200 : 503
       };
     },
     path: options.path

package/package.json

@@ -9,7 +9,7 @@
     "liveness",
     "health-check"
   ],
-  "version": "1.0.0-beta.1",
+  "version": "1.0.0-beta.3",
   "private": false,
   "license": "MIT",
   "repository": {
@@ -40,15 +40,15 @@
     "dist"
   ],
   "dependencies": {
-    "@fluojs/core": "^1.0.0-beta.1",
-    "@fluojs/runtime": "^1.0.0-beta.1",
-    "@fluojs/di": "^1.0.0-beta.1",
-    "@fluojs/http": "^1.0.0-beta.1"
+    "@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"
   },
   "peerDependencies": {
-    "@fluojs/redis": "^1.0.0-beta.1",
-    "@fluojs/drizzle": "^1.0.0-beta.1",
-    "@fluojs/prisma": "^1.0.0-beta.1"
+    "@fluojs/drizzle": "^1.0.0-beta.2",
+    "@fluojs/prisma": "^1.0.0-beta.2",
+    "@fluojs/redis": "^1.0.0-beta.2"
   },
   "peerDependenciesMeta": {
     "@fluojs/drizzle": {