@fluojs/terminus 1.0.5 → 2.0.0

package/dist/health-check.js

@@ -1,5 +1,4 @@
 import { HealthCheckError } from './errors.js';
-const runningIndicatorChecks = new WeakMap();
 function normalizeIndicatorTimeoutMs(value) {
   if (typeof value !== 'number' || !Number.isFinite(value) || value <= 0) {
     return undefined;
@@ -17,24 +16,40 @@ function createInFlightResult(key) {
     }
   };
 }
-function startSerializedIndicatorCheck(indicator, key) {
+function startSerializedIndicatorCheck(indicator, key, runningIndicatorChecks) {
   const runningCheck = runningIndicatorChecks.get(indicator);
   if (runningCheck) {
     return undefined;
   }
   const check = Promise.resolve().then(() => indicator.check(key));
   runningIndicatorChecks.set(indicator, check);
-  check.then(() => {
-    if (runningIndicatorChecks.get(indicator) === check) {
-      runningIndicatorChecks.delete(indicator);
+  const releaseIndicatorOwnership = () => {
+    const settlement = indicator.getPendingHealthCheckSettlement?.();
+    if (settlement) {
+      void settlement.then(() => {
+        if (runningIndicatorChecks.get(indicator) === check) {
+          runningIndicatorChecks.delete(indicator);
+        }
+      }, () => {
+        if (runningIndicatorChecks.get(indicator) === check) {
+          runningIndicatorChecks.delete(indicator);
+        }
+      });
+      return;
     }
-  }, () => {
     if (runningIndicatorChecks.get(indicator) === check) {
       runningIndicatorChecks.delete(indicator);
     }
-  });
+  };
+  check.then(releaseIndicatorOwnership, releaseIndicatorOwnership);
   return check;
 }
+function normalizeHealthCheckErrorCauses(key, causes) {
+  return normalizeIndicatorResult(key, causes).map(([entryKey, state]) => [entryKey, {
+    ...state,
+    status: 'down'
+  }]);
+}
 async function withTimeout(promise, timeoutMs) {
   let timer;
   try {
@@ -161,10 +176,10 @@ function createDuplicateKeyFailure(indicatorKey, duplicateKeys, seenKeys) {
     status: 'down'
   }];
 }
-async function runIndicator(indicator, index, executionOptions) {
+async function runIndicator(indicator, index, executionOptions, runningIndicatorChecks) {
   const key = inferIndicatorKey(indicator, index);
   const indicatorTimeoutMs = normalizeIndicatorTimeoutMs(executionOptions.indicatorTimeoutMs);
-  const runningCheck = startSerializedIndicatorCheck(indicator, key);
+  const runningCheck = startSerializedIndicatorCheck(indicator, key, runningIndicatorChecks);
   if (!runningCheck) {
     return {
       entries: Object.entries(createInFlightResult(key)),
@@ -180,7 +195,7 @@ async function runIndicator(indicator, index, executionOptions) {
   } catch (error) {
     if (error instanceof HealthCheckError) {
       return {
-        entries: normalizeIndicatorResult(key, error.causes),
+        entries: normalizeHealthCheckErrorCauses(key, error.causes),
         indicatorKey: key
       };
     }
@@ -212,16 +227,8 @@ function aggregateIndicatorEntries(checks) {
   }
   return aggregatedEntries;
 }
-
-/**
- * Run every registered health indicator and aggregate their results.
- *
- * @param indicators Indicator instances to execute for the current health probe.
- * @param executionOptions Optional timeout guardrails for indicator execution.
- * @returns A structured report containing `info`, `error`, and full `details` maps.
- */
-export async function runHealthCheck(indicators, executionOptions = {}) {
-  const checks = aggregateIndicatorEntries(await Promise.all(indicators.map((indicator, index) => runIndicator(indicator, index, executionOptions))));
+async function executeHealthCheck(indicators, executionOptions = {}, runningIndicatorChecks) {
+  const checks = aggregateIndicatorEntries(await Promise.all(indicators.map((indicator, index) => runIndicator(indicator, index, executionOptions, runningIndicatorChecks))));
   const details = Object.fromEntries(checks);
   const infoEntries = checks.filter(([, result]) => result.status === 'up');
   const errorEntries = checks.filter(([, result]) => result.status === 'down');
@@ -238,13 +245,29 @@ export async function runHealthCheck(indicators, executionOptions = {}) {
   };
 }
 
+/**
+ * Run every registered health indicator and aggregate their results.
+ *
+ * @remarks
+ * Direct helper calls receive an isolated execution scope. Use `TerminusHealthService`
+ * when repeated checks should serialize overlapping probes for a container-owned
+ * indicator set.
+ *
+ * @param indicators Indicator instances to execute for the current health probe.
+ * @param executionOptions Optional timeout guardrails for indicator execution.
+ * @returns A structured report containing `info`, `error`, and full `details` maps.
+ */
+export async function runHealthCheck(indicators, executionOptions = {}) {
+  return executeHealthCheck(indicators, executionOptions, new WeakMap());
+}
+
 /**
  * Assert that an aggregated health report is fully healthy.
  *
  * @param report Health report returned by `runHealthCheck(...)` or `TerminusHealthService.check()`.
  * @param message Error message used when one or more indicators are down.
  * @returns The same health report when every indicator is healthy.
- * @throws {HealthCheckError} When the report contains at least one down indicator.
+ * @throws {HealthCheckError} When one or more indicators are down.
  */
 export function assertHealthCheck(report, message = 'Health check failed.') {
   if (report.status === 'error') {
@@ -255,6 +278,7 @@ export function assertHealthCheck(report, message = 'Health check failed.') {
 
 /** Service facade that resolves and runs the health indicators registered in Terminus. */
 export class TerminusHealthService {
+  runningIndicatorChecks = new WeakMap();
   constructor(indicators, executionOptions = {}) {
     this.indicators = indicators;
     this.executionOptions = executionOptions;
@@ -266,7 +290,7 @@ export class TerminusHealthService {
    * @returns The aggregated health report for this check cycle.
    */
   async check() {
-    return runHealthCheck(this.indicators, this.executionOptions);
+    return executeHealthCheck(this.indicators, this.executionOptions, this.runningIndicatorChecks);
   }
 
   /**
@@ -277,4 +301,14 @@ export class TerminusHealthService {
   async isHealthy() {
     return (await this.check()).status === 'ok';
   }
+
+  /**
+   * Return whether every indicator participating in readiness currently reports `up`.
+   *
+   * @returns `true` when all indicators whose `readiness` setting is not `false` report `up`.
+   */
+  async isReady() {
+    const readinessIndicators = this.indicators.filter(indicator => indicator.readiness !== false);
+    return (await executeHealthCheck(readinessIndicators, this.executionOptions, this.runningIndicatorChecks)).status === 'ok';
+  }
 }

package/dist/indicators/disk.d.ts

@@ -6,6 +6,8 @@ export interface DiskHealthIndicatorOptions {
     minFreeBytes?: number;
     minFreeRatio?: number;
     path?: string;
+    /** Whether this indicator participates in `/ready`. Defaults to `true`. */
+    readiness?: boolean;
 }
 /**
  * Create a disk-space health indicator.
@@ -25,6 +27,7 @@ export declare function createDiskHealthIndicatorProvider(options?: DiskHealthIn
 export declare class DiskHealthIndicator implements HealthIndicator {
     private readonly options;
     readonly key: string | undefined;
+    readonly readiness: boolean | undefined;
     constructor(options?: DiskHealthIndicatorOptions);
     check(key: string): Promise<HealthIndicatorResult>;
 }

package/dist/indicators/disk.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"disk.d.ts","sourceRoot":"","sources":["../../src/indicators/disk.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAG3C,OAAO,KAAK,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAE1E,sEAAsE;AACtE,MAAM,WAAW,0BAA0B;IACzC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAcD;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,GAAE,0BAA+B,GAAG,eAAe,CAEnG;AAED;;;;;GAKG;AACH,wBAAgB,iCAAiC,CAAC,OAAO,GAAE,0BAA+B,GAAG,QAAQ,CAOpG;AAED,yEAAyE;AACzE,qBAAa,mBAAoB,YAAW,eAAe;IAG7C,OAAO,CAAC,QAAQ,CAAC,OAAO;IAFpC,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;gBAEJ,OAAO,GAAE,0BAA+B;IAI/D,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC;CAsCzD"}
+{"version":3,"file":"disk.d.ts","sourceRoot":"","sources":["../../src/indicators/disk.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAG3C,OAAO,KAAK,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAE1E,sEAAsE;AACtE,MAAM,WAAW,0BAA0B;IACzC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,2EAA2E;IAC3E,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAcD;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,GAAE,0BAA+B,GAAG,eAAe,CAEnG;AAED;;;;;GAKG;AACH,wBAAgB,iCAAiC,CAAC,OAAO,GAAE,0BAA+B,GAAG,QAAQ,CAOpG;AAED,yEAAyE;AACzE,qBAAa,mBAAoB,YAAW,eAAe;IAI7C,OAAO,CAAC,QAAQ,CAAC,OAAO;IAHpC,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,QAAQ,CAAC,SAAS,EAAE,OAAO,GAAG,SAAS,CAAC;gBAEX,OAAO,GAAE,0BAA+B;IAK/D,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC;CAsCzD"}

package/dist/indicators/disk.js

@@ -40,9 +40,11 @@ export function createDiskHealthIndicatorProvider(options = {}) {
 /** Health indicator that inspects free space for one filesystem path. */
 export class DiskHealthIndicator {
   key;
+  readiness;
   constructor(options = {}) {
     this.options = options;
     this.key = options.key;
+    this.readiness = options.readiness;
   }
   async check(key) {
     const indicatorKey = resolveIndicatorKey('disk', this.options.key ?? key);

package/dist/indicators/drizzle.d.ts

@@ -25,6 +25,8 @@ export interface DrizzleHealthIndicatorOptions {
     key?: string;
     ping?: () => Promise<unknown> | unknown;
     query?: unknown;
+    /** Whether this indicator participates in `/ready`. Defaults to `true`. */
+    readiness?: boolean;
     timeoutMs?: number;
 }
 /**
@@ -45,8 +47,11 @@ export declare function createDrizzleHealthIndicatorProvider(options?: Omit<Driz
 export declare class DrizzleHealthIndicator implements HealthIndicator {
     private readonly options;
     readonly key: string | undefined;
+    readonly readiness: boolean | undefined;
+    private pendingProbeSettlement;
     constructor(options?: DrizzleHealthIndicatorOptions);
     check(key: string): Promise<HealthIndicatorResult>;
+    getPendingHealthCheckSettlement(): Promise<void> | undefined;
 }
 export {};
 //# sourceMappingURL=drizzle.d.ts.map

package/dist/indicators/drizzle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"drizzle.d.ts","sourceRoot":"","sources":["../../src/indicators/drizzle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,QAAQ,EAAE,MAAM,YAAY,CAAC;AAGrD,OAAO,KAAK,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAK1E,UAAU,kBAAkB;IAC1B,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAChD;AAED,UAAU,4BAA4B;IACpC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,MAAM,EAAE;QACN,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,WAAW,CAAC;KAC9C,CAAC;IACF,SAAS,EAAE;QACT,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,OAAO,GAAG,WAAW,CAAC;KAC/B,CAAC;CACH;AAED,UAAU,yBAAyB;IACjC,4BAA4B,CAAC,EAAE,MAAM,4BAA4B,CAAC;IAClE,OAAO,CAAC,EAAE,MAAM,kBAAkB,GAAG,OAAO,CAAC;CAC9C;AAED,gEAAgE;AAChE,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,EAAE,kBAAkB,CAAC;IAC9B,cAAc,CAAC,EAAE,yBAAyB,CAAC;IAC3C,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;IACxC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AA8DD;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAAC,OAAO,GAAE,6BAAkC,GAAG,eAAe,CAEzG;AAED;;;;;GAKG;AACH,wBAAgB,oCAAoC,CAAC,OAAO,GAAE,IAAI,CAAC,6BAA6B,EAAE,UAAU,GAAG,gBAAgB,CAAM,GAAG,QAAQ,CAkB/I;AAED,iHAAiH;AACjH,qBAAa,sBAAuB,YAAW,eAAe;IAGhD,OAAO,CAAC,QAAQ,CAAC,OAAO;IAFpC,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;gBAEJ,OAAO,GAAE,6BAAkC;IAIlE,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC;CAiCzD"}
+{"version":3,"file":"drizzle.d.ts","sourceRoot":"","sources":["../../src/indicators/drizzle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,QAAQ,EAAE,MAAM,YAAY,CAAC;AAErD,OAAO,KAAK,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAM1E,UAAU,kBAAkB;IAC1B,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAChD;AAED,UAAU,4BAA4B;IACpC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,MAAM,EAAE;QACN,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,WAAW,CAAC;KAC9C,CAAC;IACF,SAAS,EAAE;QACT,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,OAAO,GAAG,WAAW,CAAC;KAC/B,CAAC;CACH;AAED,UAAU,yBAAyB;IACjC,4BAA4B,CAAC,EAAE,MAAM,4BAA4B,CAAC;IAClE,OAAO,CAAC,EAAE,MAAM,kBAAkB,GAAG,OAAO,CAAC;CAC9C;AAED,gEAAgE;AAChE,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,EAAE,kBAAkB,CAAC;IAC9B,cAAc,CAAC,EAAE,yBAAyB,CAAC;IAC3C,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;IACxC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,2EAA2E;IAC3E,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AA8DD;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAAC,OAAO,GAAE,6BAAkC,GAAG,eAAe,CAEzG;AAED;;;;;GAKG;AACH,wBAAgB,oCAAoC,CAAC,OAAO,GAAE,IAAI,CAAC,6BAA6B,EAAE,UAAU,GAAG,gBAAgB,CAAM,GAAG,QAAQ,CAkB/I;AAED,iHAAiH;AACjH,qBAAa,sBAAuB,YAAW,eAAe;IAKhD,OAAO,CAAC,QAAQ,CAAC,OAAO;IAJpC,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,QAAQ,CAAC,SAAS,EAAE,OAAO,GAAG,SAAS,CAAC;IACxC,OAAO,CAAC,sBAAsB,CAA4B;gBAE7B,OAAO,GAAE,6BAAkC;IAKlE,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAoCxD,+BAA+B,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,SAAS;CAG7D"}

package/dist/indicators/drizzle.js

@@ -1,5 +1,5 @@
 import { optional } from '@fluojs/di';
-import { createDownResult, createUpResult, resolveIndicatorKey, throwHealthCheckError, withIndicatorTimeout } from './utils.js';
+import { createDownResult, createUpResult, resolveIndicatorKey, resolveIndicatorTimeoutMs, throwHealthCheckError, waitForIndicatorProbeSettlement, withIndicatorTimeout } from './utils.js';
 const DRIZZLE_DATABASE = Symbol.for('fluo.drizzle.database');
 const DRIZZLE_HANDLE_PROVIDER = Symbol.for('fluo.drizzle.handle-provider');
 
@@ -12,7 +12,7 @@ async function runDrizzlePing(options) {
     await options.ping();
     return;
   }
-  const database = options.database ?? resolveCurrentDatabase(options.handleProvider);
+  const database = resolveCurrentDatabase(options.handleProvider) ?? options.database;
   if (!database || typeof database.execute !== 'function') {
     throw new Error('Drizzle indicator requires an execute-capable database handle or a ping callback.');
   }
@@ -79,20 +79,25 @@ export function createDrizzleHealthIndicatorProvider(options = {}) {
 /** Health indicator that maps Drizzle lifecycle state and probes connectivity with an execute-capable handle. */
 export class DrizzleHealthIndicator {
   key;
+  readiness;
+  pendingProbeSettlement;
   constructor(options = {}) {
     this.options = options;
     this.key = options.key;
+    this.readiness = options.readiness;
   }
   async check(key) {
     const indicatorKey = resolveIndicatorKey('drizzle', this.options.key ?? key);
-    const timeoutMs = this.options.timeoutMs ?? DEFAULT_DRIZZLE_TIMEOUT_MS;
     try {
+      const timeoutMs = resolveIndicatorTimeoutMs(this.options.timeoutMs, DEFAULT_DRIZZLE_TIMEOUT_MS, indicatorKey);
       const snapshot = createDrizzleLifecycleSnapshot(this.options.handleProvider);
       const lifecycleDownResult = snapshot ? createDrizzleLifecycleDownResult(indicatorKey, snapshot) : undefined;
       if (lifecycleDownResult) {
         throwHealthCheckError('Drizzle health check failed.', lifecycleDownResult);
       }
-      await withIndicatorTimeout(runDrizzlePing(this.options), timeoutMs, indicatorKey);
+      const probe = runDrizzlePing(this.options);
+      this.pendingProbeSettlement = waitForIndicatorProbeSettlement(probe);
+      await withIndicatorTimeout(probe, timeoutMs, indicatorKey);
       return createUpResult(indicatorKey, snapshot ? {
         details: snapshot.details,
         healthStatus: snapshot.health.status,
@@ -105,4 +110,7 @@ export class DrizzleHealthIndicator {
       throwHealthCheckError('Drizzle health check failed.', createDownResult(indicatorKey, error instanceof Error ? error.message : 'Drizzle health check failed.'));
     }
   }
+  getPendingHealthCheckSettlement() {
+    return this.pendingProbeSettlement;
+  }
 }

package/dist/indicators/http.d.ts

@@ -6,6 +6,8 @@ export interface HttpHealthIndicatorOptions {
     headers?: Record<string, string>;
     key?: string;
     method?: string;
+    /** Whether this indicator participates in `/ready`. Defaults to `true`. */
+    readiness?: boolean;
     timeoutMs?: number;
     url: string;
 }
@@ -27,6 +29,7 @@ export declare function createHttpHealthIndicatorProvider(options: HttpHealthInd
 export declare class HttpHealthIndicator implements HealthIndicator {
     private readonly options;
     readonly key: string | undefined;
+    readonly readiness: boolean | undefined;
     constructor(options: HttpHealthIndicatorOptions);
     check(key: string): Promise<HealthIndicatorResult>;
 }

package/dist/indicators/http.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/indicators/http.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAI3C,OAAO,KAAK,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAE1E,wDAAwD;AACxD,MAAM,WAAW,0BAA0B;IACzC,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,GAAG,CAAC,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC;IAC5E,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;CACb;AAoBD;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,0BAA0B,GAAG,eAAe,CAE9F;AAED;;;;;GAKG;AACH,wBAAgB,iCAAiC,CAAC,OAAO,EAAE,0BAA0B,GAAG,QAAQ,CAO/F;AAED,6EAA6E;AAC7E,qBAAa,mBAAoB,YAAW,eAAe;IAG7C,OAAO,CAAC,QAAQ,CAAC,OAAO;IAFpC,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;gBAEJ,OAAO,EAAE,0BAA0B;IAI1D,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC;CA6CzD"}
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/indicators/http.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAI3C,OAAO,KAAK,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAE1E,wDAAwD;AACxD,MAAM,WAAW,0BAA0B;IACzC,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,GAAG,CAAC,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC;IAC5E,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2EAA2E;IAC3E,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;CACb;AA8BD;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,0BAA0B,GAAG,eAAe,CAE9F;AAED;;;;;GAKG;AACH,wBAAgB,iCAAiC,CAAC,OAAO,EAAE,0BAA0B,GAAG,QAAQ,CAO/F;AAED,6EAA6E;AAC7E,qBAAa,mBAAoB,YAAW,eAAe;IAI7C,OAAO,CAAC,QAAQ,CAAC,OAAO;IAHpC,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,QAAQ,CAAC,SAAS,EAAE,OAAO,GAAG,SAAS,CAAC;gBAEX,OAAO,EAAE,0BAA0B;IAK1D,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC;CAmDzD"}

package/dist/indicators/http.js

@@ -1,4 +1,4 @@
-import { createDownResult, createUpResult, resolveIndicatorKey, throwHealthCheckError } from './utils.js';
+import { createDownResult, createUpResult, resolveIndicatorKey, resolveIndicatorTimeoutMs, throwHealthCheckError } from './utils.js';
 import { HealthCheckError } from '../errors.js';
 
 /** Options for probing one upstream HTTP dependency. */
@@ -16,6 +16,13 @@ function isExpectedStatus(status, expected) {
   }
   return status >= 200 && status < 300;
 }
+function cancelResponseBody(response) {
+  const body = response.body;
+  if (!body) {
+    return;
+  }
+  void body.cancel().catch(() => undefined);
+}
 
 /**
  * Create an HTTP-backed health indicator.
@@ -44,45 +51,53 @@ export function createHttpHealthIndicatorProvider(options) {
 /** Health indicator that probes an upstream HTTP endpoint with `fetch()`. */
 export class HttpHealthIndicator {
   key;
+  readiness;
   constructor(options) {
     this.options = options;
     this.key = options.key;
+    this.readiness = options.readiness;
   }
   async check(key) {
     const indicatorKey = resolveIndicatorKey('http', this.options.key ?? key);
-    const timeoutMs = this.options.timeoutMs ?? DEFAULT_HTTP_TIMEOUT_MS;
     const method = this.options.method ?? 'GET';
-    const abortController = new AbortController();
-    const startedAt = Date.now();
-    const timeout = setTimeout(() => {
-      abortController.abort(new Error(`HTTP health check timed out after ${String(timeoutMs)}ms.`));
-    }, timeoutMs);
     try {
-      const response = await fetch(this.options.url, {
-        headers: this.options.headers,
-        method,
-        signal: abortController.signal
-      });
-      const responseTimeMs = Date.now() - startedAt;
-      if (!isExpectedStatus(response.status, this.options.expectedStatus)) {
-        throwHealthCheckError('HTTP health check failed.', createDownResult(indicatorKey, `Unexpected status code ${String(response.status)} from ${this.options.url}.`, {
-          responseTimeMs,
-          statusCode: response.status,
-          url: this.options.url
-        }));
+      const timeoutMs = resolveIndicatorTimeoutMs(this.options.timeoutMs, DEFAULT_HTTP_TIMEOUT_MS, indicatorKey);
+      const abortController = new AbortController();
+      const startedAt = Date.now();
+      const timeout = setTimeout(() => {
+        abortController.abort(new Error(`HTTP health check timed out after ${String(timeoutMs)}ms.`));
+      }, timeoutMs);
+      try {
+        const response = await fetch(this.options.url, {
+          headers: this.options.headers,
+          method,
+          signal: abortController.signal
+        });
+        const responseTimeMs = Date.now() - startedAt;
+        try {
+          if (!isExpectedStatus(response.status, this.options.expectedStatus)) {
+            throwHealthCheckError('HTTP health check failed.', createDownResult(indicatorKey, `Unexpected status code ${String(response.status)} from ${this.options.url}.`, {
+              responseTimeMs,
+              statusCode: response.status,
+              url: this.options.url
+            }));
+          }
+          return createUpResult(indicatorKey, {
+            responseTimeMs,
+            statusCode: response.status,
+            url: this.options.url
+          });
+        } finally {
+          cancelResponseBody(response);
+        }
+      } finally {
+        clearTimeout(timeout);
       }
-      return createUpResult(indicatorKey, {
-        responseTimeMs,
-        statusCode: response.status,
-        url: this.options.url
-      });
     } catch (error) {
       if (error instanceof HealthCheckError) {
         throw error;
       }
       throwHealthCheckError('HTTP health check failed.', createDownResult(indicatorKey, error instanceof Error ? error.message : `HTTP health check failed for ${this.options.url}.`));
-    } finally {
-      clearTimeout(timeout);
     }
   }
 }

package/dist/indicators/memory.d.ts

@@ -16,6 +16,8 @@ export interface MemoryHealthIndicatorOptions {
     heapUsedThresholdRatio?: number;
     key?: string;
     memoryUsage?: MemoryUsageSampler;
+    /** Whether this indicator participates in `/ready`. Defaults to `true`. */
+    readiness?: boolean;
     rssThresholdBytes?: number;
 }
 /**
@@ -36,6 +38,7 @@ export declare function createMemoryHealthIndicatorProvider(options?: MemoryHeal
 export declare class MemoryHealthIndicator implements HealthIndicator {
     private readonly options;
     readonly key: string | undefined;
+    readonly readiness: boolean | undefined;
     constructor(options?: MemoryHealthIndicatorOptions);
     check(key: string): Promise<HealthIndicatorResult>;
 }

package/dist/indicators/memory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../src/indicators/memory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAI3C,OAAO,KAAK,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAE1E,mDAAmD;AACnD,MAAM,WAAW,mBAAmB;IAClC,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,8EAA8E;AAC9E,MAAM,MAAM,kBAAkB,GAAG,MAAM,mBAAmB,CAAC;AAE3D,4DAA4D;AAC5D,MAAM,WAAW,4BAA4B;IAC3C,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,kBAAkB,CAAC;IACjC,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAYD;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,GAAE,4BAAiC,GAAG,eAAe,CAEvG;AAED;;;;;GAKG;AACH,wBAAgB,mCAAmC,CAAC,OAAO,GAAE,4BAAiC,GAAG,QAAQ,CAOxG;AAED,qEAAqE;AACrE,qBAAa,qBAAsB,YAAW,eAAe;IAG/C,OAAO,CAAC,QAAQ,CAAC,OAAO;IAFpC,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;gBAEJ,OAAO,GAAE,4BAAiC;IAIjE,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC;CAiCzD"}
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../src/indicators/memory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAI3C,OAAO,KAAK,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAE1E,mDAAmD;AACnD,MAAM,WAAW,mBAAmB;IAClC,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,8EAA8E;AAC9E,MAAM,MAAM,kBAAkB,GAAG,MAAM,mBAAmB,CAAC;AAE3D,4DAA4D;AAC5D,MAAM,WAAW,4BAA4B;IAC3C,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,kBAAkB,CAAC;IACjC,2EAA2E;IAC3E,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAYD;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,GAAE,4BAAiC,GAAG,eAAe,CAEvG;AAED;;;;;GAKG;AACH,wBAAgB,mCAAmC,CAAC,OAAO,GAAE,4BAAiC,GAAG,QAAQ,CAOxG;AAED,qEAAqE;AACrE,qBAAa,qBAAsB,YAAW,eAAe;IAI/C,OAAO,CAAC,QAAQ,CAAC,OAAO;IAHpC,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,QAAQ,CAAC,SAAS,EAAE,OAAO,GAAG,SAAS,CAAC;gBAEX,OAAO,GAAE,4BAAiC;IAKjE,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC;CAiCzD"}

package/dist/indicators/memory.js

@@ -42,9 +42,11 @@ export function createMemoryHealthIndicatorProvider(options = {}) {
 /** Health indicator that checks local process heap and RSS usage. */
 export class MemoryHealthIndicator {
   key;
+  readiness;
   constructor(options = {}) {
     this.options = options;
     this.key = options.key;
+    this.readiness = options.readiness;
   }
   async check(key) {
     const indicatorKey = resolveIndicatorKey('memory', this.options.key ?? key);

package/dist/indicators/prisma.d.ts

@@ -1,4 +1,5 @@
-import type { Provider } from '@fluojs/di';
+import type { Token } from '@fluojs/core';
+import { type Provider } from '@fluojs/di';
 import type { HealthIndicator, HealthIndicatorResult } from '../types.js';
 interface PrismaClientLike {
     $executeRaw?: (...args: unknown[]) => Promise<unknown>;
@@ -6,33 +7,70 @@ interface PrismaClientLike {
     $queryRaw?: (...args: unknown[]) => Promise<unknown>;
     $queryRawUnsafe?: (query: string) => Promise<unknown>;
 }
+interface PrismaLifecycleSnapshotLike {
+    details?: Record<string, unknown>;
+    health: {
+        reason?: string;
+        status: 'healthy' | 'degraded' | 'unhealthy';
+    };
+    readiness: {
+        reason?: string;
+        status: 'ready' | 'not-ready';
+    };
+}
+interface PrismaServiceLike {
+    createPlatformStatusSnapshot?: () => PrismaLifecycleSnapshotLike;
+    current?: () => PrismaClientLike | unknown;
+}
 /** Options for probing Prisma-backed database connectivity. */
 export interface PrismaHealthIndicatorOptions {
+    /** Raw Prisma client to probe when no lifecycle-aware service facade is supplied. */
     client?: PrismaClientLike;
+    /** Explicit raw-client token to resolve when using `createPrismaHealthIndicatorProvider(...)`. */
+    clientToken?: Token;
+    /** Indicator result key override. Defaults to the key passed to `check(...)`, then `prisma`. */
     key?: string;
+    /** Named Prisma registration to resolve when using `createPrismaHealthIndicatorProvider(...)`. */
+    name?: string;
+    /** Custom ping callback for manual probes or tests. Lifecycle state is only mapped when `service` is available. */
     ping?: () => Promise<unknown> | unknown;
+    /** Whether this indicator participates in `/ready`. Defaults to `true`. */
+    readiness?: boolean;
+    /** Lifecycle-aware Prisma service/facade handle, usually resolved from `getPrismaServiceToken(name)`. */
+    service?: PrismaServiceLike;
+    /** Explicit Prisma service token to resolve when using `createPrismaHealthIndicatorProvider(...)`. */
+    serviceToken?: Token;
+    /** Maximum time to wait for the ping operation. Defaults to `2_000` ms. */
     timeoutMs?: number;
 }
 /**
  * Create a Prisma health indicator.
  *
- * @param options Optional Prisma client, ping callback, timeout, and key override.
- * @returns A health indicator that executes a lightweight Prisma round trip.
+ * @param options Optional lifecycle-aware service facade, Prisma client, ping callback, timeout, and key override.
+ * @returns A health indicator that checks Prisma lifecycle state before executing a lightweight round trip.
  */
 export declare function createPrismaHealthIndicator(options?: PrismaHealthIndicatorOptions): HealthIndicator;
 /**
- * Create a Terminus indicator provider collection entry that resolves a Prisma client from DI.
+ * Create a Terminus indicator provider collection entry that resolves Prisma from DI.
+ *
+ * The provider prefers `getPrismaServiceToken(options.name)` so `@fluojs/prisma`
+ * lifecycle snapshots participate in health/readiness diagnostics. It falls back
+ * to the matching raw client token for compatibility with manual provider graphs.
+ * Explicit `serviceToken` and `clientToken` values override the name-derived tokens.
  *
- * @param options Optional timeout, key override, or custom ping callback.
+ * @param options Optional name hint, explicit tokens, timeout, key override, or custom ping callback.
  * @returns A factory provider with a unique internal DI token for `TerminusModule` indicatorProviders.
  */
-export declare function createPrismaHealthIndicatorProvider(options?: Omit<PrismaHealthIndicatorOptions, 'client'>): Provider;
-/** Health indicator that probes Prisma connectivity with a trivial query. */
+export declare function createPrismaHealthIndicatorProvider(options?: Omit<PrismaHealthIndicatorOptions, 'client' | 'service'>): Provider;
+/** Health indicator that maps Prisma lifecycle status and probes connectivity with a trivial query. */
 export declare class PrismaHealthIndicator implements HealthIndicator {
     private readonly options;
     readonly key: string | undefined;
+    readonly readiness: boolean | undefined;
+    private pendingProbeSettlement;
     constructor(options?: PrismaHealthIndicatorOptions);
     check(key: string): Promise<HealthIndicatorResult>;
+    getPendingHealthCheckSettlement(): Promise<void> | undefined;
 }
 export {};
 //# sourceMappingURL=prisma.d.ts.map

package/dist/indicators/prisma.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prisma.d.ts","sourceRoot":"","sources":["../../src/indicators/prisma.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAG3C,OAAO,KAAK,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAI1E,UAAU,gBAAgB;IACxB,WAAW,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACvD,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACxD,SAAS,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACrD,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CACvD;AAED,+DAA+D;AAC/D,MAAM,WAAW,4BAA4B;IAC3C,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAuCD;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,GAAE,4BAAiC,GAAG,eAAe,CAEvG;AAED;;;;;GAKG;AACH,wBAAgB,mCAAmC,CAAC,OAAO,GAAE,IAAI,CAAC,4BAA4B,EAAE,QAAQ,CAAM,GAAG,QAAQ,CAQxH;AAED,6EAA6E;AAC7E,qBAAa,qBAAsB,YAAW,eAAe;IAG/C,OAAO,CAAC,QAAQ,CAAC,OAAO;IAFpC,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;gBAEJ,OAAO,GAAE,4BAAiC;IAIjE,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC;CAczD"}
+{"version":3,"file":"prisma.d.ts","sourceRoot":"","sources":["../../src/indicators/prisma.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAY,KAAK,QAAQ,EAAE,MAAM,YAAY,CAAC;AAErD,OAAO,KAAK,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAM1E,UAAU,gBAAgB;IACxB,WAAW,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACvD,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACxD,SAAS,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACrD,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CACvD;AAED,UAAU,2BAA2B;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,MAAM,EAAE;QACN,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,WAAW,CAAC;KAC9C,CAAC;IACF,SAAS,EAAE;QACT,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,OAAO,GAAG,WAAW,CAAC;KAC/B,CAAC;CACH;AAED,UAAU,iBAAiB;IACzB,4BAA4B,CAAC,EAAE,MAAM,2BAA2B,CAAC;IACjE,OAAO,CAAC,EAAE,MAAM,gBAAgB,GAAG,OAAO,CAAC;CAC5C;AAED,+DAA+D;AAC/D,MAAM,WAAW,4BAA4B;IAC3C,qFAAqF;IACrF,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,kGAAkG;IAClG,WAAW,CAAC,EAAE,KAAK,CAAC;IACpB,gGAAgG;IAChG,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,kGAAkG;IAClG,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,mHAAmH;IACnH,IAAI,CAAC,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;IACxC,2EAA2E;IAC3E,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,yGAAyG;IACzG,OAAO,CAAC,EAAE,iBAAiB,CAAC;IAC5B,sGAAsG;IACtG,YAAY,CAAC,EAAE,KAAK,CAAC;IACrB,2EAA2E;IAC3E,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AA+HD;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,GAAE,4BAAiC,GAAG,eAAe,CAEvG;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mCAAmC,CACjD,OAAO,GAAE,IAAI,CAAC,4BAA4B,EAAE,QAAQ,GAAG,SAAS,CAAM,GACrE,QAAQ,CA8BV;AAED,uGAAuG;AACvG,qBAAa,qBAAsB,YAAW,eAAe;IAK/C,OAAO,CAAC,QAAQ,CAAC,OAAO;IAJpC,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,QAAQ,CAAC,SAAS,EAAE,OAAO,GAAG,SAAS,CAAC;IACxC,OAAO,CAAC,sBAAsB,CAA4B;gBAE7B,OAAO,GAAE,4BAAiC;IAKjE,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC;IA8BxD,+BAA+B,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,SAAS;CAG7D"}