@getstrata/bootstrap 2.2.4 → 2.2.5

package/CHANGELOG.md

@@ -1,5 +1,9 @@
 # @getstrata/bootstrap changelog
 
+## 2.2.5
+
+-  fix(starter): keep container readiness independent of API admission
+
 ## 2.2.4
 
 -  perf(database): seek Postgres composite keyset bounds

package/dist/bootstrap/health.d.ts

@@ -1,13 +1,17 @@
 import type { AppDependencies } from "./contracts";
 interface CreateHealthRoutesOptions {
     pingOnHealth?: boolean;
+    /** Optional non-mutating schema check; applies to dependency-checked /health only. */
+    schemaCheck?: () => boolean | Promise<boolean>;
+    /** Text mode emits only ok/degraded for container readiness probes. */
+    healthFormat?: "json" | "text";
     extra?: Record<string, unknown> | (() => Record<string, unknown> | Promise<Record<string, unknown>>);
 }
 declare function checkDatabase(): Promise<boolean>;
 declare function pingDatabase(): Promise<boolean>;
 declare function checkRedis(redisUrl: string): Promise<boolean>;
 declare function createHealthRoutes(dependencies: AppDependencies, options?: CreateHealthRoutesOptions): {
-    "/health": () => Promise<Response>;
+    "/health": (request?: Request) => Promise<Response>;
     "/ready": () => Promise<Response>;
 };
 export type { CreateHealthRoutesOptions };

package/dist/entries/health.js

@@ -75,12 +75,19 @@ async function pingDatabase() {
   return await checkDatabase();
 }
 async function checkRedis(redisUrl) {
+  let client;
   try {
-    const client = new RedisClient(redisUrl);
+    client = new RedisClient(redisUrl, {
+      connectionTimeout: 1000,
+      idleTimeout: 1000,
+      autoReconnect: false
+    });
     const response = await client.ping();
     return response === "PONG";
   } catch {
     return false;
+  } finally {
+    client?.close();
   }
 }
 async function resolveExtraFields(extra) {
@@ -104,17 +111,40 @@ async function collectDependencyChecks(dependencies) {
 }
 function createHealthRoutes(dependencies, options = {}) {
   return {
-    "/health": async () => {
-      const extra = await resolveExtraFields(options.extra);
+    "/health": async (request) => {
+      if (request && request.method !== "GET" && request.method !== "HEAD") {
+        return new Response(null, { status: 405, headers: { allow: "GET, HEAD" } });
+      }
+      const headers = { "cache-control": "no-store" };
+      const extra = options.healthFormat === "text" ? {} : await resolveExtraFields(options.extra);
       if (!options.pingOnHealth) {
-        return jsonResponse({ status: "ok", ...extra });
+        return options.healthFormat === "text" ? new Response("ok", {
+          headers: { ...headers, "content-type": "text/plain; charset=utf-8" }
+        }) : jsonResponse({ status: "ok", ...extra }, { headers });
+      }
+      const { checks, ready: dependenciesReady } = await collectDependencyChecks(dependencies);
+      let schemaReady = true;
+      if (options.schemaCheck) {
+        try {
+          schemaReady = await options.schemaCheck();
+        } catch {
+          schemaReady = false;
+        }
+      }
+      if (options.schemaCheck)
+        checks.schema = schemaReady ? "ok" : "error";
+      const ready = dependenciesReady && schemaReady;
+      if (options.healthFormat === "text") {
+        return new Response(ready ? "ok" : "degraded", {
+          status: ready ? 200 : 503,
+          headers: { ...headers, "content-type": "text/plain; charset=utf-8" }
+        });
       }
-      const { checks, ready } = await collectDependencyChecks(dependencies);
       return jsonResponse({
         status: ready ? "ok" : "error",
         checks,
         ...extra
-      }, { status: ready ? 200 : 503 });
+      }, { status: ready ? 200 : 503, headers });
     },
     "/ready": async () => {
       const extra = await resolveExtraFields(options.extra);

package/dist/index.js

@@ -1559,12 +1559,19 @@ async function pingDatabase() {
   return await checkDatabase();
 }
 async function checkRedis(redisUrl) {
+  let client;
   try {
-    const client = new RedisClient(redisUrl);
+    client = new RedisClient(redisUrl, {
+      connectionTimeout: 1000,
+      idleTimeout: 1000,
+      autoReconnect: false
+    });
     const response = await client.ping();
     return response === "PONG";
   } catch {
     return false;
+  } finally {
+    client?.close();
   }
 }
 async function resolveExtraFields(extra) {
@@ -1588,17 +1595,40 @@ async function collectDependencyChecks(dependencies) {
 }
 function createHealthRoutes(dependencies, options = {}) {
   return {
-    "/health": async () => {
-      const extra = await resolveExtraFields(options.extra);
+    "/health": async (request) => {
+      if (request && request.method !== "GET" && request.method !== "HEAD") {
+        return new Response(null, { status: 405, headers: { allow: "GET, HEAD" } });
+      }
+      const headers = { "cache-control": "no-store" };
+      const extra = options.healthFormat === "text" ? {} : await resolveExtraFields(options.extra);
       if (!options.pingOnHealth) {
-        return jsonResponse({ status: "ok", ...extra });
+        return options.healthFormat === "text" ? new Response("ok", {
+          headers: { ...headers, "content-type": "text/plain; charset=utf-8" }
+        }) : jsonResponse({ status: "ok", ...extra }, { headers });
+      }
+      const { checks, ready: dependenciesReady } = await collectDependencyChecks(dependencies);
+      let schemaReady = true;
+      if (options.schemaCheck) {
+        try {
+          schemaReady = await options.schemaCheck();
+        } catch {
+          schemaReady = false;
+        }
+      }
+      if (options.schemaCheck)
+        checks.schema = schemaReady ? "ok" : "error";
+      const ready = dependenciesReady && schemaReady;
+      if (options.healthFormat === "text") {
+        return new Response(ready ? "ok" : "degraded", {
+          status: ready ? 200 : 503,
+          headers: { ...headers, "content-type": "text/plain; charset=utf-8" }
+        });
       }
-      const { checks, ready } = await collectDependencyChecks(dependencies);
       return jsonResponse({
         status: ready ? "ok" : "error",
         checks,
         ...extra
-      }, { status: ready ? 200 : 503 });
+      }, { status: ready ? 200 : 503, headers });
     },
     "/ready": async () => {
       const extra = await resolveExtraFields(options.extra);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@getstrata/bootstrap",
-  "version": "2.2.4",
+  "version": "2.2.5",
   "description": "Strata application bootstrap: HttpKernel, DI, web session helpers",
   "type": "module",
   "license": "MIT",
@@ -190,7 +190,7 @@
     "access": "public"
   },
   "peerDependencies": {
-    "@getstrata/core": "^2.2.4",
+    "@getstrata/core": "^2.2.5",
     "typescript": "^5.9.0 || ^6.0.0 || ^7.0.0"
   },
   "engines": {