@carlonicora/nestjs-neo4jsonapi 1.20.0 → 1.21.0

package/README.md

@@ -13,6 +13,7 @@ A comprehensive NestJS foundation package providing JSON:API compliant APIs, Neo
 - [Company-User Model (B2B & B2C)](#company-user-model-b2b--b2c)
 - [Required Configuration Files](#required-configuration-files)
 - [Core Modules](#core-modules)
+- [Health Check Endpoints](#health-check-endpoints)
 - [Foundation Modules](#foundation-modules)
 - [AI Agents](#ai-agents)
 - [Security & Authentication](#security--authentication)
@@ -902,6 +903,120 @@ The library includes 18 core infrastructure modules:
 | `MigratorModule`  | Database migrations                              |
 | `AppModeModule`   | Application mode (API/Worker)                    |
 | `DebugModule`     | Debugging utilities                              |
+| `HealthModule`    | Health check endpoints for liveness/readiness    |
+
+## Health Check Endpoints
+
+The package includes built-in health check endpoints using `@nestjs/terminus` for container orchestration and load balancer integration. Rate limiting is automatically disabled for all health endpoints.
+
+### Endpoints
+
+| Endpoint | Purpose | Checks |
+|----------|---------|--------|
+| `GET /health` | Full health status | Neo4j, Redis, S3, Disk |
+| `GET /health/live` | Liveness probe | None (process running) |
+| `GET /health/ready` | Readiness probe | Neo4j, Redis |
+
+### Full Health Check: GET /health
+
+Returns detailed status of all dependencies. Use for monitoring dashboards.
+
+**Response when healthy (200 OK):**
+```json
+{
+  "status": "ok",
+  "info": {
+    "neo4j": { "status": "up", "message": "Neo4j connection healthy" },
+    "redis": { "status": "up", "message": "Redis connection healthy" },
+    "storage": { "status": "up", "message": "aws storage connection healthy" },
+    "disk": { "status": "up", "message": "Disk space healthy", "free": "50.00 GB" }
+  },
+  "error": {},
+  "details": { ... }
+}
+```
+
+### Liveness Probe: GET /health/live
+
+Indicates if the application process is running. Does NOT check external dependencies.
+
+**Use for Kubernetes livenessProbe:** If this fails, the container should be restarted.
+
+**Response (200 OK):**
+```json
+{
+  "status": "ok",
+  "info": {},
+  "error": {},
+  "details": {}
+}
+```
+
+### Readiness Probe: GET /health/ready
+
+Indicates if the application can accept traffic. Checks critical dependencies (Neo4j, Redis).
+
+**Use for Kubernetes readinessProbe:** If this fails, traffic should be routed elsewhere.
+
+**Response when healthy (200 OK):**
+```json
+{
+  "status": "ok",
+  "info": {
+    "neo4j": { "status": "up", "message": "Neo4j connection healthy" },
+    "redis": { "status": "up", "message": "Redis connection healthy" }
+  },
+  "error": {},
+  "details": { ... }
+}
+```
+
+**Response when unhealthy (503 Service Unavailable):**
+```json
+{
+  "status": "error",
+  "info": {
+    "redis": { "status": "up", "message": "Redis connection healthy" }
+  },
+  "error": {
+    "neo4j": { "status": "down", "message": "Connection refused" }
+  },
+  "details": { ... }
+}
+```
+
+### Kubernetes Configuration Example
+
+```yaml
+apiVersion: v1
+kind: Pod
+spec:
+  containers:
+  - name: api
+    livenessProbe:
+      httpGet:
+        path: /health/live
+        port: 3000
+      initialDelaySeconds: 10
+      periodSeconds: 10
+    readinessProbe:
+      httpGet:
+        path: /health/ready
+        port: 3000
+      initialDelaySeconds: 5
+      periodSeconds: 5
+```
+
+### Health Indicators
+
+The module includes four health indicators:
+
+| Indicator | Timeout | What it checks |
+|-----------|---------|----------------|
+| `Neo4jHealthIndicator` | 3s | Executes `RETURN 1` query |
+| `RedisHealthIndicator` | 3s | Connection status + PING |
+| `S3HealthIndicator` | 5s | Bucket access (HeadBucket) |
+| `DiskHealthIndicator` | - | Free space ≥ 1GB or 10% |
 
 ## Foundation Modules
 

package/dist/core/core.module.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"core.module.d.ts","sourceRoot":"","sources":["../../src/core/core.module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAA4B,MAAM,gBAAgB,CAAC;AAyGzE;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,qBAEa,UAAU;IACrB;;OAEG;IACH,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,aAAa;CAW3D"}
+{"version":3,"file":"core.module.d.ts","sourceRoot":"","sources":["../../src/core/core.module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAA4B,MAAM,gBAAgB,CAAC;AA6GzE;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,qBAEa,UAAU;IACrB;;OAEG;IACH,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,aAAa;CAW3D"}

package/dist/core/core.module.js

@@ -15,6 +15,7 @@ const passport_1 = require("@nestjs/passport");
 // Import all core modules
 const blocknote_module_1 = require("./blocknote/blocknote.module");
 const cache_module_1 = require("./cache/cache.module");
+const health_module_1 = require("./health/health.module");
 const cors_module_1 = require("./cors/cors.module");
 const debug_module_1 = require("./debug/debug.module");
 const email_module_1 = require("./email/email.module");
@@ -71,9 +72,11 @@ function getCoreModules(queueIds = []) {
         neo4j_module_1.Neo4JModule,
         redis_module_1.RedisModule,
         cache_module_1.CacheModule,
-        // 3. Queue module - uses ConfigService for Redis, explicit queue IDs for registration
+        // 3. Health module - needs Neo4j and Redis for health checks
+        health_module_1.HealthModule,
+        // 4. Queue module - uses ConfigService for Redis, explicit queue IDs for registration
         queue_module_1.QueueModule.forRootWithQueues(queueIds),
-        // 4. Services using external connections
+        // 5. Services using external connections
         email_module_1.EmailModule.forRoot(),
         websocket_module_1.WebsocketModule,
         llm_module_1.LLMModule,
@@ -97,6 +100,7 @@ function getCoreModuleExports() {
         email_module_1.EmailModule,
         cors_module_1.CorsModule,
         version_module_1.VersionModule,
+        health_module_1.HealthModule,
         websocket_module_1.WebsocketModule,
         llm_module_1.LLMModule,
         blocknote_module_1.BlockNoteModule,

package/dist/core/core.module.js.map

@@ -1 +1 @@
-{"version":3,"file":"core.module.js","sourceRoot":"","sources":["../../src/core/core.module.ts"],"names":[],"mappings":";;;;;;;;;;AAAA,2CAAyE;AACzE,2CAA6D;AAC7D,qCAAwC;AACxC,+CAAkD;AAGlD,0BAA0B;AAC1B,mEAA+D;AAC/D,uDAAmD;AACnD,oDAAgD;AAChD,uDAAmD;AACnD,uDAAmD;AACnD,6DAAyD;AACzD,iDAA6C;AAC7C,6DAAyD;AACzD,gEAA4D;AAC5D,uDAAmD;AACnD,uDAAmD;AACnD,uDAAmD;AACnD,gEAA4D;AAC5D,6DAAyD;AACzD,6DAAyD;AACzD,mEAA+D;AAE/D;;;;;;;;;;;;;;GAcG;AACH,SAAS,cAAc,CAAC,WAAqB,EAAE;IAC7C,OAAO;QACL,iEAAiE;QACjE,eAAS,CAAC,aAAa,CAAC;YACtB,OAAO,EAAE,CAAC,qBAAY,CAAC;YACvB,MAAM,EAAE,CAAC,sBAAa,CAAC;YACvB,UAAU,EAAE,CAAC,aAAiD,EAAE,EAAE;gBAChE,MAAM,GAAG,GAAG,aAAa,CAAC,GAAG,CAAqB,KAAK,CAAC,CAAC;gBACzD,OAAO;oBACL,MAAM,EAAE,GAAG,EAAE,MAAM;oBACnB,WAAW,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,SAAgB,EAAE;iBAClD,CAAC;YACJ,CAAC;SACF,CAAC;QACF,yBAAc;QACd,kDAAkD;QAClD,gCAAc;QACd,wBAAU,CAAC,OAAO,EAAE;QACpB,8BAAa,CAAC,OAAO,EAAE;QACvB,8BAAa;QACb,0BAAW;QACX,8BAAa,CAAC,OAAO,EAAE;QACvB,8BAAa,CAAC,OAAO,EAAE;QACvB,iDAAiD;QACjD,0BAAW;QACX,0BAAW;QACX,0BAAW;QACX,sFAAsF;QACtF,0BAAW,CAAC,iBAAiB,CAAC,QAAQ,CAAC;QACvC,yCAAyC;QACzC,0BAAW,CAAC,OAAO,EAAE;QACrB,kCAAe;QACf,sBAAS;QACT,kCAAe;QACf,gCAAc;QACd,8BAAa;KACd,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,SAAS,oBAAoB;IAC3B,OAAO;QACL,eAAS;QACT,yBAAc;QACd,0BAAW;QACX,0BAAW;QACX,0BAAW;QACX,gCAAc;QACd,0BAAW;QACX,wBAAU;QACV,8BAAa;QACb,kCAAe;QACf,sBAAS;QACT,kCAAe;QACf,0BAAW;QACX,8BAAa;QACb,8BAAa;QACb,8BAAa;QACb,0BAAW;QACX,8BAAa;KACd,CAAC;AACJ,CAAC;AAcD;;;;;;;;;;;;;;;;GAgBG;AAGI,IAAM,UAAU,kBAAhB,MAAM,UAAU;IACrB;;OAEG;IACH,MAAM,CAAC,OAAO,CAAC,OAA2B;QACxC,MAAM,SAAS,GAAe,EAAE,CAAC;QAEjC,OAAO;YACL,MAAM,EAAE,YAAU;YAClB,OAAO,EAAE,cAAc,CAAC,OAAO,EAAE,QAAQ,IAAI,EAAE,CAAC;YAChD,SAAS;YACT,OAAO,EAAE,CAAC,GAAG,oBAAoB,EAAE,CAAC;YACpC,MAAM,EAAE,IAAI;SACb,CAAC;IACJ,CAAC;CACF,CAAA;AAfY,gCAAU;qBAAV,UAAU;IAFtB,IAAA,eAAM,GAAE;IACR,IAAA,eAAM,EAAC,EAAE,CAAC;GACE,UAAU,CAetB"}
+{"version":3,"file":"core.module.js","sourceRoot":"","sources":["../../src/core/core.module.ts"],"names":[],"mappings":";;;;;;;;;;AAAA,2CAAyE;AACzE,2CAA6D;AAC7D,qCAAwC;AACxC,+CAAkD;AAGlD,0BAA0B;AAC1B,mEAA+D;AAC/D,uDAAmD;AACnD,0DAAsD;AACtD,oDAAgD;AAChD,uDAAmD;AACnD,uDAAmD;AACnD,6DAAyD;AACzD,iDAA6C;AAC7C,6DAAyD;AACzD,gEAA4D;AAC5D,uDAAmD;AACnD,uDAAmD;AACnD,uDAAmD;AACnD,gEAA4D;AAC5D,6DAAyD;AACzD,6DAAyD;AACzD,mEAA+D;AAE/D;;;;;;;;;;;;;;GAcG;AACH,SAAS,cAAc,CAAC,WAAqB,EAAE;IAC7C,OAAO;QACL,iEAAiE;QACjE,eAAS,CAAC,aAAa,CAAC;YACtB,OAAO,EAAE,CAAC,qBAAY,CAAC;YACvB,MAAM,EAAE,CAAC,sBAAa,CAAC;YACvB,UAAU,EAAE,CAAC,aAAiD,EAAE,EAAE;gBAChE,MAAM,GAAG,GAAG,aAAa,CAAC,GAAG,CAAqB,KAAK,CAAC,CAAC;gBACzD,OAAO;oBACL,MAAM,EAAE,GAAG,EAAE,MAAM;oBACnB,WAAW,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,SAAgB,EAAE;iBAClD,CAAC;YACJ,CAAC;SACF,CAAC;QACF,yBAAc;QACd,kDAAkD;QAClD,gCAAc;QACd,wBAAU,CAAC,OAAO,EAAE;QACpB,8BAAa,CAAC,OAAO,EAAE;QACvB,8BAAa;QACb,0BAAW;QACX,8BAAa,CAAC,OAAO,EAAE;QACvB,8BAAa,CAAC,OAAO,EAAE;QACvB,iDAAiD;QACjD,0BAAW;QACX,0BAAW;QACX,0BAAW;QACX,6DAA6D;QAC7D,4BAAY;QACZ,sFAAsF;QACtF,0BAAW,CAAC,iBAAiB,CAAC,QAAQ,CAAC;QACvC,yCAAyC;QACzC,0BAAW,CAAC,OAAO,EAAE;QACrB,kCAAe;QACf,sBAAS;QACT,kCAAe;QACf,gCAAc;QACd,8BAAa;KACd,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,SAAS,oBAAoB;IAC3B,OAAO;QACL,eAAS;QACT,yBAAc;QACd,0BAAW;QACX,0BAAW;QACX,0BAAW;QACX,gCAAc;QACd,0BAAW;QACX,wBAAU;QACV,8BAAa;QACb,4BAAY;QACZ,kCAAe;QACf,sBAAS;QACT,kCAAe;QACf,0BAAW;QACX,8BAAa;QACb,8BAAa;QACb,8BAAa;QACb,0BAAW;QACX,8BAAa;KACd,CAAC;AACJ,CAAC;AAcD;;;;;;;;;;;;;;;;GAgBG;AAGI,IAAM,UAAU,kBAAhB,MAAM,UAAU;IACrB;;OAEG;IACH,MAAM,CAAC,OAAO,CAAC,OAA2B;QACxC,MAAM,SAAS,GAAe,EAAE,CAAC;QAEjC,OAAO;YACL,MAAM,EAAE,YAAU;YAClB,OAAO,EAAE,cAAc,CAAC,OAAO,EAAE,QAAQ,IAAI,EAAE,CAAC;YAChD,SAAS;YACT,OAAO,EAAE,CAAC,GAAG,oBAAoB,EAAE,CAAC;YACpC,MAAM,EAAE,IAAI;SACb,CAAC;IACJ,CAAC;CACF,CAAA;AAfY,gCAAU;qBAAV,UAAU;IAFtB,IAAA,eAAM,GAAE;IACR,IAAA,eAAM,EAAC,EAAE,CAAC;GACE,UAAU,CAetB"}

package/dist/core/health/controllers/health.controller.d.ts

@@ -0,0 +1,65 @@
+import { HealthCheckService, HealthCheckResult } from "@nestjs/terminus";
+import { Neo4jHealthIndicator } from "../indicators/neo4j.health";
+import { RedisHealthIndicator } from "../indicators/redis.health";
+import { S3HealthIndicator } from "../indicators/s3.health";
+import { DiskHealthIndicator } from "../indicators/disk.health";
+/**
+ * Health Check Controller
+ *
+ * Provides health check endpoints for monitoring and orchestration.
+ * All endpoints are PUBLIC (no authentication required).
+ * Rate limiting is disabled for health endpoints.
+ *
+ * Endpoints:
+ * - GET /health - Full health status with all dependency checks
+ * - GET /health/live - Liveness probe (process is running)
+ * - GET /health/ready - Readiness probe (can accept traffic)
+ */
+export declare class HealthController {
+    private health;
+    private neo4jHealth;
+    private redisHealth;
+    private s3Health;
+    private diskHealth;
+    constructor(health: HealthCheckService, neo4jHealth: Neo4jHealthIndicator, redisHealth: RedisHealthIndicator, s3Health: S3HealthIndicator, diskHealth: DiskHealthIndicator);
+    /**
+     * Full health check endpoint
+     *
+     * Checks all dependencies and returns detailed status.
+     * Use for monitoring dashboards and detailed health analysis.
+     *
+     * @returns HealthCheckResult with status of all dependencies
+     * - HTTP 200: All dependencies healthy
+     * - HTTP 503: One or more dependencies unhealthy
+     */
+    check(): Promise<HealthCheckResult>;
+    /**
+     * Liveness probe endpoint
+     *
+     * Indicates if the application process is running.
+     * Does NOT check external dependencies.
+     *
+     * Use for Kubernetes livenessProbe:
+     * - If this fails, container should be restarted
+     *
+     * @returns HealthCheckResult
+     * - HTTP 200: Process is alive
+     */
+    liveness(): Promise<HealthCheckResult>;
+    /**
+     * Readiness probe endpoint
+     *
+     * Indicates if the application can accept traffic.
+     * Checks critical dependencies (Neo4j, Redis).
+     *
+     * Use for Kubernetes readinessProbe:
+     * - If this fails, traffic should be routed elsewhere
+     * - Container should NOT be restarted
+     *
+     * @returns HealthCheckResult
+     * - HTTP 200: Ready to accept traffic
+     * - HTTP 503: Not ready (dependency unavailable)
+     */
+    readiness(): Promise<HealthCheckResult>;
+}
+//# sourceMappingURL=health.controller.d.ts.map

package/dist/core/health/controllers/health.controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.controller.d.ts","sourceRoot":"","sources":["../../../../src/core/health/controllers/health.controller.ts"],"names":[],"mappings":"AAEA,OAAO,EAAe,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACtF,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAEhE;;;;;;;;;;;GAWG;AACH,qBAEa,gBAAgB;IAEzB,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,WAAW;IACnB,OAAO,CAAC,WAAW;IACnB,OAAO,CAAC,QAAQ;IAChB,OAAO,CAAC,UAAU;gBAJV,MAAM,EAAE,kBAAkB,EAC1B,WAAW,EAAE,oBAAoB,EACjC,WAAW,EAAE,oBAAoB,EACjC,QAAQ,EAAE,iBAAiB,EAC3B,UAAU,EAAE,mBAAmB;IAGzC;;;;;;;;;OASG;IAGG,KAAK,IAAI,OAAO,CAAC,iBAAiB,CAAC;IASzC;;;;;;;;;;;OAWG;IAGG,QAAQ,IAAI,OAAO,CAAC,iBAAiB,CAAC;IAM5C;;;;;;;;;;;;;OAaG;IAGG,SAAS,IAAI,OAAO,CAAC,iBAAiB,CAAC;CAI9C"}

package/dist/core/health/controllers/health.controller.js

@@ -0,0 +1,125 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HealthController = void 0;
+const common_1 = require("@nestjs/common");
+const throttler_1 = require("@nestjs/throttler");
+const terminus_1 = require("@nestjs/terminus");
+const neo4j_health_1 = require("../indicators/neo4j.health");
+const redis_health_1 = require("../indicators/redis.health");
+const s3_health_1 = require("../indicators/s3.health");
+const disk_health_1 = require("../indicators/disk.health");
+/**
+ * Health Check Controller
+ *
+ * Provides health check endpoints for monitoring and orchestration.
+ * All endpoints are PUBLIC (no authentication required).
+ * Rate limiting is disabled for health endpoints.
+ *
+ * Endpoints:
+ * - GET /health - Full health status with all dependency checks
+ * - GET /health/live - Liveness probe (process is running)
+ * - GET /health/ready - Readiness probe (can accept traffic)
+ */
+let HealthController = class HealthController {
+    constructor(health, neo4jHealth, redisHealth, s3Health, diskHealth) {
+        this.health = health;
+        this.neo4jHealth = neo4jHealth;
+        this.redisHealth = redisHealth;
+        this.s3Health = s3Health;
+        this.diskHealth = diskHealth;
+    }
+    /**
+     * Full health check endpoint
+     *
+     * Checks all dependencies and returns detailed status.
+     * Use for monitoring dashboards and detailed health analysis.
+     *
+     * @returns HealthCheckResult with status of all dependencies
+     * - HTTP 200: All dependencies healthy
+     * - HTTP 503: One or more dependencies unhealthy
+     */
+    async check() {
+        return this.health.check([
+            () => this.neo4jHealth.isHealthy("neo4j"),
+            () => this.redisHealth.isHealthy("redis"),
+            () => this.s3Health.isHealthy("storage"),
+            () => this.diskHealth.isHealthy("disk"),
+        ]);
+    }
+    /**
+     * Liveness probe endpoint
+     *
+     * Indicates if the application process is running.
+     * Does NOT check external dependencies.
+     *
+     * Use for Kubernetes livenessProbe:
+     * - If this fails, container should be restarted
+     *
+     * @returns HealthCheckResult
+     * - HTTP 200: Process is alive
+     */
+    async liveness() {
+        // Liveness only checks if process is running
+        // No external dependency checks
+        return this.health.check([]);
+    }
+    /**
+     * Readiness probe endpoint
+     *
+     * Indicates if the application can accept traffic.
+     * Checks critical dependencies (Neo4j, Redis).
+     *
+     * Use for Kubernetes readinessProbe:
+     * - If this fails, traffic should be routed elsewhere
+     * - Container should NOT be restarted
+     *
+     * @returns HealthCheckResult
+     * - HTTP 200: Ready to accept traffic
+     * - HTTP 503: Not ready (dependency unavailable)
+     */
+    async readiness() {
+        // Readiness checks critical dependencies needed to handle requests
+        return this.health.check([() => this.neo4jHealth.isHealthy("neo4j"), () => this.redisHealth.isHealthy("redis")]);
+    }
+};
+exports.HealthController = HealthController;
+__decorate([
+    (0, common_1.Get)(),
+    (0, terminus_1.HealthCheck)(),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", Promise)
+], HealthController.prototype, "check", null);
+__decorate([
+    (0, common_1.Get)("live"),
+    (0, terminus_1.HealthCheck)(),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", Promise)
+], HealthController.prototype, "liveness", null);
+__decorate([
+    (0, common_1.Get)("ready"),
+    (0, terminus_1.HealthCheck)(),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", Promise)
+], HealthController.prototype, "readiness", null);
+exports.HealthController = HealthController = __decorate([
+    (0, common_1.Controller)("health"),
+    (0, throttler_1.SkipThrottle)(),
+    __metadata("design:paramtypes", [terminus_1.HealthCheckService,
+        neo4j_health_1.Neo4jHealthIndicator,
+        redis_health_1.RedisHealthIndicator,
+        s3_health_1.S3HealthIndicator,
+        disk_health_1.DiskHealthIndicator])
+], HealthController);
+//# sourceMappingURL=health.controller.js.map

package/dist/core/health/controllers/health.controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.controller.js","sourceRoot":"","sources":["../../../../src/core/health/controllers/health.controller.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAAiD;AACjD,iDAAiD;AACjD,+CAAsF;AACtF,6DAAkE;AAClE,6DAAkE;AAClE,uDAA4D;AAC5D,2DAAgE;AAEhE;;;;;;;;;;;GAWG;AAGI,IAAM,gBAAgB,GAAtB,MAAM,gBAAgB;IAC3B,YACU,MAA0B,EAC1B,WAAiC,EACjC,WAAiC,EACjC,QAA2B,EAC3B,UAA+B;QAJ/B,WAAM,GAAN,MAAM,CAAoB;QAC1B,gBAAW,GAAX,WAAW,CAAsB;QACjC,gBAAW,GAAX,WAAW,CAAsB;QACjC,aAAQ,GAAR,QAAQ,CAAmB;QAC3B,eAAU,GAAV,UAAU,CAAqB;IACtC,CAAC;IAEJ;;;;;;;;;OASG;IAGG,AAAN,KAAK,CAAC,KAAK;QACT,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;YACvB,GAAG,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,OAAO,CAAC;YACzC,GAAG,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,OAAO,CAAC;YACzC,GAAG,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,SAAS,CAAC;YACxC,GAAG,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,MAAM,CAAC;SACxC,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;OAWG;IAGG,AAAN,KAAK,CAAC,QAAQ;QACZ,6CAA6C;QAC7C,gCAAgC;QAChC,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAC/B,CAAC;IAED;;;;;;;;;;;;;OAaG;IAGG,AAAN,KAAK,CAAC,SAAS;QACb,mEAAmE;QACnE,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IACnH,CAAC;CACF,CAAA;AAtEY,4CAAgB;AAqBrB;IAFL,IAAA,YAAG,GAAE;IACL,IAAA,sBAAW,GAAE;;;;6CAQb;AAgBK;IAFL,IAAA,YAAG,EAAC,MAAM,CAAC;IACX,IAAA,sBAAW,GAAE;;;;gDAKb;AAkBK;IAFL,IAAA,YAAG,EAAC,OAAO,CAAC;IACZ,IAAA,sBAAW,GAAE;;;;iDAIb;2BArEU,gBAAgB;IAF5B,IAAA,mBAAU,EAAC,QAAQ,CAAC;IACpB,IAAA,wBAAY,GAAE;qCAGK,6BAAkB;QACb,mCAAoB;QACpB,mCAAoB;QACvB,6BAAiB;QACf,iCAAmB;GAN9B,gBAAgB,CAsE5B"}

package/dist/core/health/health.module.d.ts

@@ -0,0 +1,3 @@
+export declare class HealthModule {
+}
+//# sourceMappingURL=health.module.d.ts.map

package/dist/core/health/health.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.module.d.ts","sourceRoot":"","sources":["../../../src/core/health/health.module.ts"],"names":[],"mappings":"AAQA,qBAMa,YAAY;CAAG"}

package/dist/core/health/health.module.js

@@ -0,0 +1,28 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HealthModule = void 0;
+const common_1 = require("@nestjs/common");
+const terminus_1 = require("@nestjs/terminus");
+const health_controller_1 = require("./controllers/health.controller");
+const neo4j_health_1 = require("./indicators/neo4j.health");
+const redis_health_1 = require("./indicators/redis.health");
+const s3_health_1 = require("./indicators/s3.health");
+const disk_health_1 = require("./indicators/disk.health");
+let HealthModule = class HealthModule {
+};
+exports.HealthModule = HealthModule;
+exports.HealthModule = HealthModule = __decorate([
+    (0, common_1.Module)({
+        imports: [terminus_1.TerminusModule],
+        controllers: [health_controller_1.HealthController],
+        providers: [neo4j_health_1.Neo4jHealthIndicator, redis_health_1.RedisHealthIndicator, s3_health_1.S3HealthIndicator, disk_health_1.DiskHealthIndicator],
+        exports: [neo4j_health_1.Neo4jHealthIndicator, redis_health_1.RedisHealthIndicator, s3_health_1.S3HealthIndicator, disk_health_1.DiskHealthIndicator],
+    })
+], HealthModule);
+//# sourceMappingURL=health.module.js.map

package/dist/core/health/health.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.module.js","sourceRoot":"","sources":["../../../src/core/health/health.module.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAAwC;AACxC,+CAAkD;AAClD,uEAAmE;AACnE,4DAAiE;AACjE,4DAAiE;AACjE,sDAA2D;AAC3D,0DAA+D;AAQxD,IAAM,YAAY,GAAlB,MAAM,YAAY;CAAG,CAAA;AAAf,oCAAY;uBAAZ,YAAY;IANxB,IAAA,eAAM,EAAC;QACN,OAAO,EAAE,CAAC,yBAAc,CAAC;QACzB,WAAW,EAAE,CAAC,oCAAgB,CAAC;QAC/B,SAAS,EAAE,CAAC,mCAAoB,EAAE,mCAAoB,EAAE,6BAAiB,EAAE,iCAAmB,CAAC;QAC/F,OAAO,EAAE,CAAC,mCAAoB,EAAE,mCAAoB,EAAE,6BAAiB,EAAE,iCAAmB,CAAC;KAC9F,CAAC;GACW,YAAY,CAAG"}

package/dist/core/health/index.d.ts

@@ -0,0 +1,7 @@
+export * from "./controllers/health.controller";
+export * from "./indicators/neo4j.health";
+export * from "./indicators/redis.health";
+export * from "./indicators/s3.health";
+export * from "./indicators/disk.health";
+export * from "./health.module";
+//# sourceMappingURL=index.d.ts.map

package/dist/core/health/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/health/index.ts"],"names":[],"mappings":"AAAA,cAAc,iCAAiC,CAAC;AAChD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,wBAAwB,CAAC;AACvC,cAAc,0BAA0B,CAAC;AACzC,cAAc,iBAAiB,CAAC"}

package/dist/core/health/index.js

@@ -0,0 +1,23 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./controllers/health.controller"), exports);
+__exportStar(require("./indicators/neo4j.health"), exports);
+__exportStar(require("./indicators/redis.health"), exports);
+__exportStar(require("./indicators/s3.health"), exports);
+__exportStar(require("./indicators/disk.health"), exports);
+__exportStar(require("./health.module"), exports);
+//# sourceMappingURL=index.js.map

package/dist/core/health/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/health/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,kEAAgD;AAChD,4DAA0C;AAC1C,4DAA0C;AAC1C,yDAAuC;AACvC,2DAAyC;AACzC,kDAAgC"}

package/dist/core/health/indicators/disk.health.d.ts

@@ -0,0 +1,9 @@
+import { HealthIndicator, HealthIndicatorResult } from "@nestjs/terminus";
+export declare class DiskHealthIndicator extends HealthIndicator {
+    private readonly MIN_FREE_BYTES;
+    private readonly MIN_FREE_PERCENTAGE;
+    isHealthy(key: string): Promise<HealthIndicatorResult>;
+    private getDiskStats;
+    private formatBytes;
+}
+//# sourceMappingURL=disk.health.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"disk.health.d.ts","sourceRoot":"","sources":["../../../../src/core/health/indicators/disk.health.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAoB,MAAM,kBAAkB,CAAC;AAW5F,qBACa,mBAAoB,SAAQ,eAAe;IAEtD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAsB;IACrD,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAM;IAEpC,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC;YA2C9C,YAAY;IA4C1B,OAAO,CAAC,WAAW;CAYpB"}

package/dist/core/health/indicators/disk.health.js

@@ -0,0 +1,145 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DiskHealthIndicator = void 0;
+const common_1 = require("@nestjs/common");
+const terminus_1 = require("@nestjs/terminus");
+const fs = __importStar(require("fs"));
+const os = __importStar(require("os"));
+let DiskHealthIndicator = class DiskHealthIndicator extends terminus_1.HealthIndicator {
+    constructor() {
+        super(...arguments);
+        // Minimum free space threshold: 1GB or 10% of total, whichever is smaller
+        this.MIN_FREE_BYTES = 1024 * 1024 * 1024; // 1GB
+        this.MIN_FREE_PERCENTAGE = 10; // 10%
+    }
+    async isHealthy(key) {
+        try {
+            const stats = await this.getDiskStats();
+            const minRequiredByPercentage = (stats.total * this.MIN_FREE_PERCENTAGE) / 100;
+            const threshold = Math.min(this.MIN_FREE_BYTES, minRequiredByPercentage);
+            const isHealthy = stats.free >= threshold;
+            if (!isHealthy) {
+                throw new terminus_1.HealthCheckError("Disk space critically low", this.getStatus(key, false, {
+                    message: `Low disk space: ${this.formatBytes(stats.free)} free (${(100 - stats.usedPercentage).toFixed(1)}%)`,
+                    total: this.formatBytes(stats.total),
+                    free: this.formatBytes(stats.free),
+                    used: this.formatBytes(stats.used),
+                    usedPercentage: `${stats.usedPercentage.toFixed(1)}%`,
+                }));
+            }
+            return this.getStatus(key, true, {
+                message: "Disk space healthy",
+                total: this.formatBytes(stats.total),
+                free: this.formatBytes(stats.free),
+                used: this.formatBytes(stats.used),
+                usedPercentage: `${stats.usedPercentage.toFixed(1)}%`,
+            });
+        }
+        catch (error) {
+            if (error instanceof terminus_1.HealthCheckError) {
+                throw error;
+            }
+            const errorMessage = error instanceof Error ? error.message : "Unknown error";
+            throw new terminus_1.HealthCheckError("Disk health check failed", this.getStatus(key, false, {
+                message: errorMessage,
+            }));
+        }
+    }
+    async getDiskStats() {
+        // Get the root path based on OS
+        const checkPath = os.platform() === "win32" ? "C:\\" : "/";
+        return new Promise((resolve) => {
+            // Use statvfs-like approach for Unix systems
+            if (os.platform() !== "win32") {
+                try {
+                    const stats = fs.statfsSync(checkPath);
+                    const total = stats.bsize * stats.blocks;
+                    const free = stats.bsize * stats.bfree;
+                    const used = total - free;
+                    resolve({
+                        total,
+                        free,
+                        used,
+                        usedPercentage: (used / total) * 100,
+                    });
+                }
+                catch {
+                    // Fallback: use os module for basic memory info as indicator
+                    const totalMem = os.totalmem();
+                    const freeMem = os.freemem();
+                    resolve({
+                        total: totalMem,
+                        free: freeMem,
+                        used: totalMem - freeMem,
+                        usedPercentage: ((totalMem - freeMem) / totalMem) * 100,
+                    });
+                }
+            }
+            else {
+                // For Windows, use a different approach or return system memory
+                const totalMem = os.totalmem();
+                const freeMem = os.freemem();
+                resolve({
+                    total: totalMem,
+                    free: freeMem,
+                    used: totalMem - freeMem,
+                    usedPercentage: ((totalMem - freeMem) / totalMem) * 100,
+                });
+            }
+        });
+    }
+    formatBytes(bytes) {
+        const units = ["B", "KB", "MB", "GB", "TB"];
+        let unitIndex = 0;
+        let size = bytes;
+        while (size >= 1024 && unitIndex < units.length - 1) {
+            size /= 1024;
+            unitIndex++;
+        }
+        return `${size.toFixed(2)} ${units[unitIndex]}`;
+    }
+};
+exports.DiskHealthIndicator = DiskHealthIndicator;
+exports.DiskHealthIndicator = DiskHealthIndicator = __decorate([
+    (0, common_1.Injectable)()
+], DiskHealthIndicator);
+//# sourceMappingURL=disk.health.js.map

package/dist/core/health/indicators/disk.health.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"disk.health.js","sourceRoot":"","sources":["../../../../src/core/health/indicators/disk.health.ts"],"names":[],"mappings":"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"}

package/dist/core/health/indicators/neo4j.health.d.ts

@@ -0,0 +1,9 @@
+import { HealthIndicator, HealthIndicatorResult } from "@nestjs/terminus";
+import { Neo4jService } from "../../neo4j/services/neo4j.service";
+export declare class Neo4jHealthIndicator extends HealthIndicator {
+    private readonly neo4jService;
+    private readonly TIMEOUT_MS;
+    constructor(neo4jService: Neo4jService);
+    isHealthy(key: string): Promise<HealthIndicatorResult>;
+}
+//# sourceMappingURL=neo4j.health.d.ts.map

package/dist/core/health/indicators/neo4j.health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"neo4j.health.d.ts","sourceRoot":"","sources":["../../../../src/core/health/indicators/neo4j.health.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAoB,MAAM,kBAAkB,CAAC;AAC5F,OAAO,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAElE,qBACa,oBAAqB,SAAQ,eAAe;IAG3C,OAAO,CAAC,QAAQ,CAAC,YAAY;IAFzC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAQ;gBAEN,YAAY,EAAE,YAAY;IAIjD,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC;CA0B7D"}

package/dist/core/health/indicators/neo4j.health.js

@@ -0,0 +1,49 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Neo4jHealthIndicator = void 0;
+const common_1 = require("@nestjs/common");
+const terminus_1 = require("@nestjs/terminus");
+const neo4j_service_1 = require("../../neo4j/services/neo4j.service");
+let Neo4jHealthIndicator = class Neo4jHealthIndicator extends terminus_1.HealthIndicator {
+    constructor(neo4jService) {
+        super();
+        this.neo4jService = neo4jService;
+        this.TIMEOUT_MS = 3000;
+    }
+    async isHealthy(key) {
+        try {
+            // Create a timeout promise
+            const timeoutPromise = new Promise((_, reject) => {
+                setTimeout(() => reject(new Error("Health check timeout")), this.TIMEOUT_MS);
+            });
+            // Execute simple query to verify connection
+            const checkPromise = this.neo4jService.read("RETURN 1 as result", {});
+            // Race between query and timeout
+            await Promise.race([checkPromise, timeoutPromise]);
+            return this.getStatus(key, true, {
+                message: "Neo4j connection healthy",
+            });
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : "Unknown error";
+            throw new terminus_1.HealthCheckError("Neo4j health check failed", this.getStatus(key, false, {
+                message: errorMessage,
+            }));
+        }
+    }
+};
+exports.Neo4jHealthIndicator = Neo4jHealthIndicator;
+exports.Neo4jHealthIndicator = Neo4jHealthIndicator = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [neo4j_service_1.Neo4jService])
+], Neo4jHealthIndicator);
+//# sourceMappingURL=neo4j.health.js.map

package/dist/core/health/indicators/neo4j.health.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"neo4j.health.js","sourceRoot":"","sources":["../../../../src/core/health/indicators/neo4j.health.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAA4C;AAC5C,+CAA4F;AAC5F,sEAAkE;AAG3D,IAAM,oBAAoB,GAA1B,MAAM,oBAAqB,SAAQ,0BAAe;IAGvD,YAA6B,YAA0B;QACrD,KAAK,EAAE,CAAC;QADmB,iBAAY,GAAZ,YAAY,CAAc;QAFtC,eAAU,GAAG,IAAI,CAAC;IAInC,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,GAAW;QACzB,IAAI,CAAC;YACH,2BAA2B;YAC3B,MAAM,cAAc,GAAG,IAAI,OAAO,CAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE;gBACtD,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;YAC/E,CAAC,CAAC,CAAC;YAEH,4CAA4C;YAC5C,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,oBAAoB,EAAE,EAAE,CAAC,CAAC;YAEtE,iCAAiC;YACjC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,YAAY,EAAE,cAAc,CAAC,CAAC,CAAC;YAEnD,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE;gBAC/B,OAAO,EAAE,0BAA0B;aACpC,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC;YAC9E,MAAM,IAAI,2BAAgB,CACxB,2BAA2B,EAC3B,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,KAAK,EAAE;gBACzB,OAAO,EAAE,YAAY;aACtB,CAAC,CACH,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAA;AAjCY,oDAAoB;+BAApB,oBAAoB;IADhC,IAAA,mBAAU,GAAE;qCAIgC,4BAAY;GAH5C,oBAAoB,CAiChC"}

package/dist/core/health/indicators/redis.health.d.ts

@@ -0,0 +1,9 @@
+import { HealthIndicator, HealthIndicatorResult } from "@nestjs/terminus";
+import { RedisClientStorageService } from "../../redis/services/redis.client.storage.service";
+export declare class RedisHealthIndicator extends HealthIndicator {
+    private readonly redisService;
+    private readonly TIMEOUT_MS;
+    constructor(redisService: RedisClientStorageService);
+    isHealthy(key: string): Promise<HealthIndicatorResult>;
+}
+//# sourceMappingURL=redis.health.d.ts.map

package/dist/core/health/indicators/redis.health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis.health.d.ts","sourceRoot":"","sources":["../../../../src/core/health/indicators/redis.health.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAoB,MAAM,kBAAkB,CAAC;AAC5F,OAAO,EAAE,yBAAyB,EAAE,MAAM,mDAAmD,CAAC;AAE9F,qBACa,oBAAqB,SAAQ,eAAe;IAG3C,OAAO,CAAC,QAAQ,CAAC,YAAY;IAFzC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAQ;gBAEN,YAAY,EAAE,yBAAyB;IAI9D,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC;CAwC7D"}

package/dist/core/health/indicators/redis.health.js

@@ -0,0 +1,59 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RedisHealthIndicator = void 0;
+const common_1 = require("@nestjs/common");
+const terminus_1 = require("@nestjs/terminus");
+const redis_client_storage_service_1 = require("../../redis/services/redis.client.storage.service");
+let RedisHealthIndicator = class RedisHealthIndicator extends terminus_1.HealthIndicator {
+    constructor(redisService) {
+        super();
+        this.redisService = redisService;
+        this.TIMEOUT_MS = 3000;
+    }
+    async isHealthy(key) {
+        try {
+            // Check if Redis client is connected
+            const isConnected = this.redisService.isConnected();
+            if (!isConnected) {
+                throw new Error("Redis client not connected");
+            }
+            // Execute PING command to verify responsiveness
+            const redis = this.redisService.getRedisClient();
+            // Create a timeout promise
+            const timeoutPromise = new Promise((_, reject) => {
+                setTimeout(() => reject(new Error("Health check timeout")), this.TIMEOUT_MS);
+            });
+            // Execute PING
+            const pingPromise = redis.ping();
+            // Race between ping and timeout
+            const result = await Promise.race([pingPromise, timeoutPromise]);
+            if (result !== "PONG") {
+                throw new Error(`Unexpected PING response: ${result}`);
+            }
+            return this.getStatus(key, true, {
+                message: "Redis connection healthy",
+            });
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : "Unknown error";
+            throw new terminus_1.HealthCheckError("Redis health check failed", this.getStatus(key, false, {
+                message: errorMessage,
+            }));
+        }
+    }
+};
+exports.RedisHealthIndicator = RedisHealthIndicator;
+exports.RedisHealthIndicator = RedisHealthIndicator = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [redis_client_storage_service_1.RedisClientStorageService])
+], RedisHealthIndicator);
+//# sourceMappingURL=redis.health.js.map

package/dist/core/health/indicators/redis.health.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis.health.js","sourceRoot":"","sources":["../../../../src/core/health/indicators/redis.health.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAA4C;AAC5C,+CAA4F;AAC5F,oGAA8F;AAGvF,IAAM,oBAAoB,GAA1B,MAAM,oBAAqB,SAAQ,0BAAe;IAGvD,YAA6B,YAAuC;QAClE,KAAK,EAAE,CAAC;QADmB,iBAAY,GAAZ,YAAY,CAA2B;QAFnD,eAAU,GAAG,IAAI,CAAC;IAInC,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,GAAW;QACzB,IAAI,CAAC;YACH,qCAAqC;YACrC,MAAM,WAAW,GAAG,IAAI,CAAC,YAAY,CAAC,WAAW,EAAE,CAAC;YAEpD,IAAI,CAAC,WAAW,EAAE,CAAC;gBACjB,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;YAChD,CAAC;YAED,gDAAgD;YAChD,MAAM,KAAK,GAAG,IAAI,CAAC,YAAY,CAAC,cAAc,EAAE,CAAC;YAEjD,2BAA2B;YAC3B,MAAM,cAAc,GAAG,IAAI,OAAO,CAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE;gBACtD,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;YAC/E,CAAC,CAAC,CAAC;YAEH,eAAe;YACf,MAAM,WAAW,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;YAEjC,gCAAgC;YAChC,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC,CAAC;YAEjE,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;gBACtB,MAAM,IAAI,KAAK,CAAC,6BAA6B,MAAM,EAAE,CAAC,CAAC;YACzD,CAAC;YAED,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE;gBAC/B,OAAO,EAAE,0BAA0B;aACpC,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC;YAC9E,MAAM,IAAI,2BAAgB,CACxB,2BAA2B,EAC3B,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,KAAK,EAAE;gBACzB,OAAO,EAAE,YAAY;aACtB,CAAC,CACH,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAA;AA/CY,oDAAoB;+BAApB,oBAAoB;IADhC,IAAA,mBAAU,GAAE;qCAIgC,wDAAyB;GAHzD,oBAAoB,CA+ChC"}

package/dist/core/health/indicators/s3.health.d.ts

@@ -0,0 +1,12 @@
+import { ConfigService } from "@nestjs/config";
+import { HealthIndicator, HealthIndicatorResult } from "@nestjs/terminus";
+import { BaseConfigInterface } from "../../../config/interfaces";
+export declare class S3HealthIndicator extends HealthIndicator {
+    private readonly config;
+    private readonly TIMEOUT_MS;
+    constructor(config: ConfigService<BaseConfigInterface>);
+    isHealthy(key: string): Promise<HealthIndicatorResult>;
+    private checkS3Compatible;
+    private checkAzure;
+}
+//# sourceMappingURL=s3.health.d.ts.map

package/dist/core/health/indicators/s3.health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"s3.health.d.ts","sourceRoot":"","sources":["../../../../src/core/health/indicators/s3.health.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAoB,MAAM,kBAAkB,CAAC;AAG5F,OAAO,EAAE,mBAAmB,EAAqB,MAAM,4BAA4B,CAAC;AAEpF,qBACa,iBAAkB,SAAQ,eAAe;IAGxC,OAAO,CAAC,QAAQ,CAAC,MAAM;IAFnC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAQ;gBAEN,MAAM,EAAE,aAAa,CAAC,mBAAmB,CAAC;IAIjE,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC;YA0C9C,iBAAiB;YAgDjB,UAAU;CAazB"}

package/dist/core/health/indicators/s3.health.js

@@ -0,0 +1,118 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.S3HealthIndicator = void 0;
+const common_1 = require("@nestjs/common");
+const config_1 = require("@nestjs/config");
+const terminus_1 = require("@nestjs/terminus");
+const client_s3_1 = require("@aws-sdk/client-s3");
+const storage_blob_1 = require("@azure/storage-blob");
+let S3HealthIndicator = class S3HealthIndicator extends terminus_1.HealthIndicator {
+    constructor(config) {
+        super();
+        this.config = config;
+        this.TIMEOUT_MS = 5000;
+    }
+    async isHealthy(key) {
+        try {
+            const s3Config = this.config.get("s3");
+            if (!s3Config || !s3Config.bucket) {
+                return this.getStatus(key, true, {
+                    message: "S3 not configured - skipping check",
+                });
+            }
+            const storageType = s3Config.type;
+            // Create a timeout promise
+            const timeoutPromise = new Promise((_, reject) => {
+                setTimeout(() => reject(new Error("Health check timeout")), this.TIMEOUT_MS);
+            });
+            let checkPromise;
+            if (storageType === "azure") {
+                checkPromise = this.checkAzure(s3Config);
+            }
+            else {
+                checkPromise = this.checkS3Compatible(s3Config);
+            }
+            await Promise.race([checkPromise, timeoutPromise]);
+            return this.getStatus(key, true, {
+                message: `${storageType} storage connection healthy`,
+                storageType,
+            });
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : "Unknown error";
+            throw new terminus_1.HealthCheckError("S3/Storage health check failed", this.getStatus(key, false, {
+                message: errorMessage,
+            }));
+        }
+    }
+    async checkS3Compatible(s3Config) {
+        const type = s3Config.type;
+        let s3Client;
+        switch (type) {
+            case "s3":
+            case "aws":
+                s3Client = new client_s3_1.S3Client({
+                    region: s3Config.region,
+                    credentials: {
+                        accessKeyId: s3Config.key,
+                        secretAccessKey: s3Config.secret,
+                    },
+                });
+                break;
+            case "digitalocean":
+            case "hetzner":
+                s3Client = new client_s3_1.S3Client({
+                    region: s3Config.region,
+                    endpoint: s3Config.endpoint,
+                    credentials: {
+                        accessKeyId: s3Config.key,
+                        secretAccessKey: s3Config.secret,
+                    },
+                });
+                break;
+            case "minio":
+                s3Client = new client_s3_1.S3Client({
+                    endpoint: s3Config.endpoint,
+                    region: "local",
+                    credentials: {
+                        accessKeyId: s3Config.key,
+                        secretAccessKey: s3Config.secret,
+                    },
+                    forcePathStyle: true,
+                });
+                break;
+            default:
+                throw new Error(`Unsupported storage type: ${type}`);
+        }
+        // HeadBucket is a lightweight operation to check bucket access
+        const command = new client_s3_1.HeadBucketCommand({ Bucket: s3Config.bucket });
+        await s3Client.send(command);
+        s3Client.destroy();
+    }
+    async checkAzure(s3Config) {
+        const connectionString = s3Config.key;
+        const containerName = s3Config.bucket;
+        const blobServiceClient = storage_blob_1.BlobServiceClient.fromConnectionString(connectionString);
+        const containerClient = blobServiceClient.getContainerClient(containerName);
+        // Check if container exists - lightweight operation
+        const exists = await containerClient.exists();
+        if (!exists) {
+            throw new Error(`Azure container '${containerName}' does not exist`);
+        }
+    }
+};
+exports.S3HealthIndicator = S3HealthIndicator;
+exports.S3HealthIndicator = S3HealthIndicator = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [config_1.ConfigService])
+], S3HealthIndicator);
+//# sourceMappingURL=s3.health.js.map

package/dist/core/health/indicators/s3.health.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"s3.health.js","sourceRoot":"","sources":["../../../../src/core/health/indicators/s3.health.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAA4C;AAC5C,2CAA+C;AAC/C,+CAA4F;AAC5F,kDAAiE;AACjE,sDAAwD;AAIjD,IAAM,iBAAiB,GAAvB,MAAM,iBAAkB,SAAQ,0BAAe;IAGpD,YAA6B,MAA0C;QACrE,KAAK,EAAE,CAAC;QADmB,WAAM,GAAN,MAAM,CAAoC;QAFtD,eAAU,GAAG,IAAI,CAAC;IAInC,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,GAAW;QACzB,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAoB,IAAI,CAAC,CAAC;YAE1D,IAAI,CAAC,QAAQ,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;gBAClC,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE;oBAC/B,OAAO,EAAE,oCAAoC;iBAC9C,CAAC,CAAC;YACL,CAAC;YAED,MAAM,WAAW,GAAG,QAAQ,CAAC,IAAI,CAAC;YAElC,2BAA2B;YAC3B,MAAM,cAAc,GAAG,IAAI,OAAO,CAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE;gBACtD,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;YAC/E,CAAC,CAAC,CAAC;YAEH,IAAI,YAA2B,CAAC;YAEhC,IAAI,WAAW,KAAK,OAAO,EAAE,CAAC;gBAC5B,YAAY,GAAG,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;YAC3C,CAAC;iBAAM,CAAC;gBACN,YAAY,GAAG,IAAI,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC;YAClD,CAAC;YAED,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,YAAY,EAAE,cAAc,CAAC,CAAC,CAAC;YAEnD,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE;gBAC/B,OAAO,EAAE,GAAG,WAAW,6BAA6B;gBACpD,WAAW;aACZ,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC;YAC9E,MAAM,IAAI,2BAAgB,CACxB,gCAAgC,EAChC,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,KAAK,EAAE;gBACzB,OAAO,EAAE,YAAY;aACtB,CAAC,CACH,CAAC;QACJ,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,iBAAiB,CAAC,QAA2B;QACzD,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC;QAE3B,IAAI,QAAkB,CAAC;QAEvB,QAAQ,IAAI,EAAE,CAAC;YACb,KAAK,IAAI,CAAC;YACV,KAAK,KAAK;gBACR,QAAQ,GAAG,IAAI,oBAAQ,CAAC;oBACtB,MAAM,EAAE,QAAQ,CAAC,MAAM;oBACvB,WAAW,EAAE;wBACX,WAAW,EAAE,QAAQ,CAAC,GAAG;wBACzB,eAAe,EAAE,QAAQ,CAAC,MAAM;qBACjC;iBACF,CAAC,CAAC;gBACH,MAAM;YACR,KAAK,cAAc,CAAC;YACpB,KAAK,SAAS;gBACZ,QAAQ,GAAG,IAAI,oBAAQ,CAAC;oBACtB,MAAM,EAAE,QAAQ,CAAC,MAAM;oBACvB,QAAQ,EAAE,QAAQ,CAAC,QAAQ;oBAC3B,WAAW,EAAE;wBACX,WAAW,EAAE,QAAQ,CAAC,GAAG;wBACzB,eAAe,EAAE,QAAQ,CAAC,MAAM;qBACjC;iBACF,CAAC,CAAC;gBACH,MAAM;YACR,KAAK,OAAO;gBACV,QAAQ,GAAG,IAAI,oBAAQ,CAAC;oBACtB,QAAQ,EAAE,QAAQ,CAAC,QAAQ;oBAC3B,MAAM,EAAE,OAAO;oBACf,WAAW,EAAE;wBACX,WAAW,EAAE,QAAQ,CAAC,GAAG;wBACzB,eAAe,EAAE,QAAQ,CAAC,MAAM;qBACjC;oBACD,cAAc,EAAE,IAAI;iBACrB,CAAC,CAAC;gBACH,MAAM;YACR;gBACE,MAAM,IAAI,KAAK,CAAC,6BAA6B,IAAI,EAAE,CAAC,CAAC;QACzD,CAAC;QAED,+DAA+D;QAC/D,MAAM,OAAO,GAAG,IAAI,6BAAiB,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;QACnE,MAAM,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC7B,QAAQ,CAAC,OAAO,EAAE,CAAC;IACrB,CAAC;IAEO,KAAK,CAAC,UAAU,CAAC,QAA2B;QAClD,MAAM,gBAAgB,GAAG,QAAQ,CAAC,GAAG,CAAC;QACtC,MAAM,aAAa,GAAG,QAAQ,CAAC,MAAM,CAAC;QAEtC,MAAM,iBAAiB,GAAG,gCAAiB,CAAC,oBAAoB,CAAC,gBAAgB,CAAC,CAAC;QACnF,MAAM,eAAe,GAAG,iBAAiB,CAAC,kBAAkB,CAAC,aAAa,CAAC,CAAC;QAE5E,oDAAoD;QACpD,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,MAAM,EAAE,CAAC;QAC9C,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,oBAAoB,aAAa,kBAAkB,CAAC,CAAC;QACvE,CAAC;IACH,CAAC;CACF,CAAA;AA9GY,8CAAiB;4BAAjB,iBAAiB;IAD7B,IAAA,mBAAU,GAAE;qCAI0B,sBAAa;GAHvC,iBAAiB,CA8G7B"}

package/dist/core/index.d.ts

@@ -26,5 +26,6 @@ export * from "./migrator";
 export * from "./debug";
 export * from "./jsonapi";
 export * from "./tracing";
+export * from "./health";
 export * from "./logging";
 //# sourceMappingURL=index.d.ts.map

package/dist/core/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,cAAc,eAAe,CAAC;AAG9B,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,OAAO,CAAC;AACtB,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC;AAGxB,cAAc,WAAW,CAAC;AAG1B,cAAc,WAAW,CAAC;AAG1B,cAAc,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,cAAc,eAAe,CAAC;AAG9B,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,OAAO,CAAC;AACtB,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC;AAGxB,cAAc,WAAW,CAAC;AAG1B,cAAc,WAAW,CAAC;AAG1B,cAAc,UAAU,CAAC;AAGzB,cAAc,WAAW,CAAC"}

package/dist/core/index.js

@@ -46,6 +46,8 @@ __exportStar(require("./debug"), exports);
 __exportStar(require("./jsonapi"), exports);
 // Tracing module (exports TracingContext)
 __exportStar(require("./tracing"), exports);
+// Health module for liveness/readiness probes
+__exportStar(require("./health"), exports);
 // Logging module (exports TracingServiceInterface but not TracingContext to avoid duplicates)
 __exportStar(require("./logging"), exports);
 //# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;;;;;;;;;;;;;;;AAEH,8EAA8E;AAC9E,gDAA8B;AAE9B,8BAA8B;AAC9B,0CAAwB;AACxB,0CAAwB;AACxB,0CAAwB;AACxB,6CAA2B;AAC3B,4CAA0B;AAC1B,0CAAwB;AACxB,0CAAwB;AACxB,yCAAuB;AACvB,4CAA0B;AAC1B,8CAA4B;AAC5B,wCAAsB;AACtB,8CAA4B;AAC5B,6CAA2B;AAC3B,0CAAwB;AAExB,mDAAmD;AACnD,4CAA0B;AAE1B,0CAA0C;AAC1C,4CAA0B;AAE1B,8FAA8F;AAC9F,4CAA0B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;;;;;;;;;;;;;;;AAEH,8EAA8E;AAC9E,gDAA8B;AAE9B,8BAA8B;AAC9B,0CAAwB;AACxB,0CAAwB;AACxB,0CAAwB;AACxB,6CAA2B;AAC3B,4CAA0B;AAC1B,0CAAwB;AACxB,0CAAwB;AACxB,yCAAuB;AACvB,4CAA0B;AAC1B,8CAA4B;AAC5B,wCAAsB;AACtB,8CAA4B;AAC5B,6CAA2B;AAC3B,0CAAwB;AAExB,mDAAmD;AACnD,4CAA0B;AAE1B,0CAA0C;AAC1C,4CAA0B;AAE1B,8CAA8C;AAC9C,2CAAyB;AAEzB,8FAA8F;AAC9F,4CAA0B"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@carlonicora/nestjs-neo4jsonapi",
-  "version": "1.20.0",
+  "version": "1.21.0",
   "description": "NestJS foundation package with JSON:API, Neo4j, Redis, LangChain agents, and common utilities",
   "author": "Carlo Nicora",
   "license": "GPL-3.0-or-later",
@@ -182,6 +182,7 @@
     "@nestjs/platform-fastify": "^11.1.9",
     "@nestjs/platform-socket.io": "^11.1.9",
     "@nestjs/schedule": "^6.0.1",
+    "@nestjs/terminus": "^11.0.0",
     "@nestjs/throttler": "^6.5.0",
     "@nestjs/websockets": "^11.1.9",
     "nestjs-cls": "^6.1.0",