owox 0.9.0-next-20251006155344 → 0.9.0-next-20251007055312

package/dist/commands/serve.js

@@ -3,7 +3,7 @@ import { IdpProtocolMiddleware } from '@owox/idp-protocol';
 import express from 'express';
 import { IdpFactory } from '../idp/factory.js';
 import { getPackageInfo } from '../utils/package-info.js';
-import { registerPublicFlagsRoute, setupWebStaticAssets } from '../web/index.js';
+import { registerHealthRoutes, registerPublicFlagsRoute, setupWebStaticAssets, } from '../web/index.js';
 import { BaseCommand } from './base.js';
 /**
  * Command class for starting the OWOX Data Marts application server.
@@ -138,14 +138,19 @@ export default class Serve extends BaseCommand {
         const port = process.env.PORT;
         const logFormat = process.env.LOG_FORMAT;
         this.log(`📦 Starting server on port ${port} with ${logFormat} logs...`);
-        const { bootstrap } = await import('@owox/backend');
+        const { bootstrap, createHealthProbe } = await import('@owox/backend');
         const expressApp = express();
         expressApp.set('trust proxy', 1);
+        // Holders for late-bound dependencies used by early health routes
+        let currentIdp = null;
+        let currentBackendApp = null;
+        registerHealthRoutes(expressApp, () => currentIdp, () => currentBackendApp, () => this.isShuttingDown);
         const idpProvider = await IdpFactory.createFromEnvironment(this);
         await idpProvider.initialize();
         const idpProtocolMiddleware = new IdpProtocolMiddleware(idpProvider);
         idpProtocolMiddleware.register(expressApp);
         expressApp.set('idp', idpProvider);
+        currentIdp = idpProvider;
         // Register public route to expose whitelisted flags
         registerPublicFlagsRoute(expressApp);
         // Configure web static assets if web interface is enabled
@@ -163,6 +168,7 @@ export default class Serve extends BaseCommand {
         }
         try {
             this.app = await bootstrap({ express: expressApp });
+            currentBackendApp = createHealthProbe(this.app);
             this.log(`📝 Process ID: ${process.pid}`);
             this.log(`✅ Server started successfully. Open http://localhost:${port} in your browser.`);
             // Keep process alive until shutdown

package/dist/web/health-route.js

@@ -0,0 +1,26 @@
+import { checkReadiness } from './readiness.js';
+/**
+ * Registers health check routes on the given Express app.
+ *
+ * Behavior:
+ * - /health/live returns 503 until BOTH IDP and backend probe are available; 200 otherwise.
+ * - /health/ready returns 503 if shutting down, or if dependencies are missing; otherwise uses checkReadiness.
+ */
+export function registerHealthRoutes(app, getIdp, getBackend, isShuttingDown) {
+    app.get('/health/live', (_req, res) => res.status(200).json({}));
+    app.get('/health/ready', async (_req, res) => {
+        if (isShuttingDown()) {
+            return res.status(503).json({ reason: 'shutting down' });
+        }
+        const idp = getIdp();
+        if (!idp) {
+            return res.status(503).json({ reason: 'IDP not available' });
+        }
+        const backend = getBackend();
+        if (!backend) {
+            return res.status(503).json({ reason: 'backend not available' });
+        }
+        const ok = await checkReadiness(idp, backend);
+        return res.status(ok ? 200 : 503).json({ reason: ok ? 'ok' : 'dependencies not healthy' });
+    });
+}

package/dist/web/index.js

@@ -5,4 +5,6 @@
  * including static file serving, SPA routing configuration, and helper routes.
  */
 export { registerPublicFlagsRoute } from './flags-route.js';
+export { registerHealthRoutes } from './health-route.js';
+export { checkReadiness } from './readiness.js';
 export { setupWebStaticAssets } from './static-config.js';

package/dist/web/readiness.js

@@ -0,0 +1,19 @@
+import { withTimeout } from '@owox/internal-helpers';
+const HEALTHCHECK_TIMEOUT_MS = 500;
+/**
+ * Aggregate readiness check for the web layer.
+ *
+ * Returns true only if both the IDP and backend report healthy status.
+ * Errors and timeouts (> HEALTHCHECK_TIMEOUT_MS) are treated as unhealthy to keep the behavior conservative.
+ */
+export async function checkReadiness(idp, backend) {
+    // Start both checks concurrently and enforce a strict timeout for each.
+    // If a check errors or exceeds the timeout, we treat it as unhealthy (false).
+    const idpHealthyPromise = withTimeout(idp.isHealthy(), HEALTHCHECK_TIMEOUT_MS, false).catch(() => false);
+    const backendHealthyPromise = withTimeout(backend.isHealthy(), HEALTHCHECK_TIMEOUT_MS, false).catch(() => false);
+    const [idpHealthy, backendHealthy] = await Promise.all([
+        idpHealthyPromise,
+        backendHealthyPromise,
+    ]);
+    return idpHealthy && backendHealthy;
+}

package/oclif.manifest.json

@@ -253,5 +253,5 @@
       ]
     }
   },
-  "version": "0.9.0-next-20251006155344"
+  "version": "0.9.0-next-20251007055312"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "owox",
   "description": "OWOX Data Marts CLI: Simple command-line interface to start the OWOX Data Marts application with backend and frontend components.",
-  "version": "0.9.0-next-20251006155344",
+  "version": "0.9.0-next-20251007055312",
   "publishConfig": {
     "access": "public"
   },
@@ -13,12 +13,12 @@
     "@oclif/core": "^4",
     "@oclif/plugin-help": "^6",
     "@oclif/plugin-plugins": "^5",
-    "@owox/backend": "0.9.0-next-20251006155344",
-    "@owox/idp-better-auth": "0.9.0-next-20251006155344",
-    "@owox/idp-owox": "0.9.0-next-20251006155344",
-    "@owox/idp-protocol": "0.9.0-next-20251006155344",
-    "@owox/internal-helpers": "0.9.0-next-20251006155344",
-    "@owox/web": "0.9.0-next-20251006155344",
+    "@owox/backend": "0.9.0-next-20251007055312",
+    "@owox/idp-better-auth": "0.9.0-next-20251007055312",
+    "@owox/idp-owox": "0.9.0-next-20251007055312",
+    "@owox/idp-protocol": "0.9.0-next-20251007055312",
+    "@owox/internal-helpers": "0.9.0-next-20251007055312",
+    "@owox/web": "0.9.0-next-20251007055312",
     "find-process": "^1.4.10"
   },
   "peerDependencies": {
@@ -88,6 +88,7 @@
     "build:internal-helpers": "npm run build -w @owox/internal-helpers --prefix ../..",
     "dev": "node ./bin/run.js serve -e ../../.env",
     "lint": "eslint . --config ./eslint.config.mjs",
+    "lint:fix": "eslint . --config ./eslint.config.mjs --fix",
     "lint:md": "markdownlint-cli2 --config ../../.markdownlint-cli2.mjs",
     "lint:md:fix": "markdownlint-cli2 --config ../../.markdownlint-cli2.mjs --fix",
     "format": "prettier --write \"**/*.{ts,js,json}\" --ignore-path ../../.prettierignore",