@omnitronix/game-engine-sdk 1.0.1

package/dist/grpc/game-engine.grpc.in-adapter.d.ts

@@ -0,0 +1,21 @@
+import { Logger } from '../common/logger/logger';
+import { GetGameEngineInfoRequest, GetGameEngineInfoResponse, ProcessCommandRequest, ProcessCommandResponse } from '../generated/game-engine_pb';
+import { GameEngineInPort } from '../types';
+export declare class GameEngineGrpcInAdapter {
+    private readonly gameEngineInPort;
+    logger: Logger;
+    constructor(gameEngineInPort: GameEngineInPort);
+    processCommand(request: ProcessCommandRequest): Promise<ProcessCommandResponse>;
+    private extractCommandFromRequest;
+    private createSuccessResponse;
+    private createErrorResponse;
+    /**
+     * Convert RNG outcome from internal format (seed: number) to wire format (seed: string).
+     *
+     * This conversion happens at the gRPC boundary to match the proto definition.
+     */
+    private convertRngOutcome;
+    private safeStringify;
+    getGameEngineInfo(_request: GetGameEngineInfoRequest): Promise<GetGameEngineInfoResponse>;
+}
+//# sourceMappingURL=game-engine.grpc.in-adapter.d.ts.map

package/dist/grpc/game-engine.grpc.in-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"game-engine.grpc.in-adapter.d.ts","sourceRoot":"","sources":["../../src/grpc/game-engine.grpc.in-adapter.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AACjD,OAAO,EACL,wBAAwB,EACxB,yBAAyB,EAEzB,qBAAqB,EACrB,sBAAsB,EAEvB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAEL,gBAAgB,EAIjB,MAAM,UAAU,CAAC;AAGlB,qBACa,uBAAuB;IAIhC,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IAHnC,MAAM,EAAE,MAAM,CAAC;gBAGI,gBAAgB,EAAE,gBAAgB;IAK/C,cAAc,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAerF,OAAO,CAAC,yBAAyB;IAQjC,OAAO,CAAC,qBAAqB;IAe7B,OAAO,CAAC,mBAAmB;IAS3B;;;;OAIG;IACH,OAAO,CAAC,iBAAiB;IA0BzB,OAAO,CAAC,aAAa;IAMf,iBAAiB,CAAC,QAAQ,EAAE,wBAAwB,GAAG,OAAO,CAAC,yBAAyB,CAAC;CAYhG"}

package/dist/grpc/game-engine.grpc.in-adapter.js

@@ -0,0 +1,112 @@
+"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);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+var GameEngineGrpcInAdapter_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GameEngineGrpcInAdapter = void 0;
+const protobuf_1 = require("@bufbuild/protobuf");
+const logger_1 = require("../common/logger/logger");
+const game_engine_pb_1 = require("../generated/game-engine_pb");
+const types_1 = require("../types");
+const common_1 = require("@nestjs/common");
+let GameEngineGrpcInAdapter = GameEngineGrpcInAdapter_1 = class GameEngineGrpcInAdapter {
+    constructor(gameEngineInPort) {
+        this.gameEngineInPort = gameEngineInPort;
+        this.logger = new logger_1.Logger(GameEngineGrpcInAdapter_1.name);
+    }
+    async processCommand(request) {
+        try {
+            const command = this.extractCommandFromRequest(request);
+            const publicState = request.publicState ?? {};
+            const privateState = request.privateState ?? {};
+            const result = await this.gameEngineInPort.processCommand(publicState, privateState, command);
+            return this.createSuccessResponse(result);
+        }
+        catch (error) {
+            this.logger.error('Error in processCommand', error);
+            return this.createErrorResponse(request, error);
+        }
+    }
+    extractCommandFromRequest(request) {
+        return {
+            id: request.command?.id ?? '',
+            type: request.command?.type ?? '',
+            payload: request.command?.payload,
+        };
+    }
+    createSuccessResponse(result) {
+        const rngOutcome = this.convertRngOutcome(result.rngOutcome);
+        return (0, protobuf_1.create)(game_engine_pb_1.ProcessCommandResponseSchema, {
+            success: result.success ?? true,
+            publicState: result.publicState,
+            privateState: result.privateState,
+            outcome: result.outcome,
+            message: result.message,
+            rngOutcome: rngOutcome,
+        });
+    }
+    createErrorResponse(request, error) {
+        return (0, protobuf_1.create)(game_engine_pb_1.ProcessCommandResponseSchema, {
+            success: false,
+            publicState: request.publicState,
+            privateState: request.privateState,
+            message: error.errorCode ? error.message : 'Command processing failed',
+        });
+    }
+    /**
+     * Convert RNG outcome from internal format (seed: number) to wire format (seed: string).
+     *
+     * This conversion happens at the gRPC boundary to match the proto definition.
+     */
+    convertRngOutcome(rngOutcome) {
+        if (!rngOutcome) {
+            return undefined;
+        }
+        try {
+            return Object.fromEntries(Object.entries(rngOutcome).map(([key, value]) => [
+                key,
+                {
+                    result: value.result,
+                    // Convert seed to string for wire format (gRPC proto uses string)
+                    seed: String(value.seed),
+                    min: value.min,
+                    max: value.max,
+                },
+            ]));
+        }
+        catch (e) {
+            this.logger.error('Error while formatting rngOutcome', e);
+            throw e;
+        }
+    }
+    safeStringify(obj) {
+        return JSON.stringify(obj, (key, value) => typeof value === 'bigint' ? value.toString() : value);
+    }
+    async getGameEngineInfo(_request) {
+        const gameEngineInfo = await this.gameEngineInPort.getGameEngineInfo();
+        // TODO: gameName and provider are available in GameEngineInfo but not in the proto schema.
+        // Update game-engine.proto to add these fields in GetGameEngineInfoResponse.
+        return (0, protobuf_1.create)(game_engine_pb_1.GetGameEngineInfoResponseSchema, {
+            gameCode: gameEngineInfo.gameCode,
+            version: gameEngineInfo.version,
+            rtp: gameEngineInfo.rtp,
+            gameType: gameEngineInfo.gameType,
+        });
+    }
+};
+exports.GameEngineGrpcInAdapter = GameEngineGrpcInAdapter;
+exports.GameEngineGrpcInAdapter = GameEngineGrpcInAdapter = GameEngineGrpcInAdapter_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, common_1.Inject)(types_1.GAME_ENGINE_IN_PORT)),
+    __metadata("design:paramtypes", [Object])
+], GameEngineGrpcInAdapter);

package/dist/grpc/index.d.ts

@@ -0,0 +1,3 @@
+export { GameEngineGrpcInAdapter } from './game-engine.grpc.in-adapter';
+export { createConnectRouter } from './connect-router.middleware';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/grpc/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AACxE,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/grpc/index.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createConnectRouter = exports.GameEngineGrpcInAdapter = void 0;
+var game_engine_grpc_in_adapter_1 = require("./game-engine.grpc.in-adapter");
+Object.defineProperty(exports, "GameEngineGrpcInAdapter", { enumerable: true, get: function () { return game_engine_grpc_in_adapter_1.GameEngineGrpcInAdapter; } });
+var connect_router_middleware_1 = require("./connect-router.middleware");
+Object.defineProperty(exports, "createConnectRouter", { enumerable: true, get: function () { return connect_router_middleware_1.createConnectRouter; } });

package/dist/health/application/ports/in/health-in.port.d.ts

@@ -0,0 +1,7 @@
+import { ApplicationHealthStatus } from '../../../domain/health';
+export declare const HEALTH_IN_PORT: unique symbol;
+export interface HealthInPort {
+    checkHealth(): Promise<ApplicationHealthStatus>;
+    isApplicationShuttingDown(): boolean;
+}
+//# sourceMappingURL=health-in.port.d.ts.map

package/dist/health/application/ports/in/health-in.port.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health-in.port.d.ts","sourceRoot":"","sources":["../../../../../src/health/application/ports/in/health-in.port.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAEjE,eAAO,MAAM,cAAc,eAA2B,CAAC;AAEvD,MAAM,WAAW,YAAY;IAC3B,WAAW,IAAI,OAAO,CAAC,uBAAuB,CAAC,CAAC;IAChD,yBAAyB,IAAI,OAAO,CAAC;CACtC"}

package/dist/health/application/ports/in/health-in.port.js

@@ -0,0 +1,4 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HEALTH_IN_PORT = void 0;
+exports.HEALTH_IN_PORT = Symbol('HEALTH_IN_PORT');

package/dist/health/application/ports/out/database-health.out-port.d.ts

@@ -0,0 +1,6 @@
+import { HealthStatus } from '../../../domain/health';
+export declare const DATABASE_HEALTH_OUT_PORT: unique symbol;
+export interface DatabaseHealthOutPort {
+    checkDatabaseConnection(): Promise<HealthStatus>;
+}
+//# sourceMappingURL=database-health.out-port.d.ts.map

package/dist/health/application/ports/out/database-health.out-port.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"database-health.out-port.d.ts","sourceRoot":"","sources":["../../../../../src/health/application/ports/out/database-health.out-port.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAEtD,eAAO,MAAM,wBAAwB,eAAqC,CAAC;AAE3E,MAAM,WAAW,qBAAqB;IACpC,uBAAuB,IAAI,OAAO,CAAC,YAAY,CAAC,CAAC;CAClD"}

package/dist/health/application/ports/out/database-health.out-port.js

@@ -0,0 +1,4 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DATABASE_HEALTH_OUT_PORT = void 0;
+exports.DATABASE_HEALTH_OUT_PORT = Symbol('DATABASE_HEALTH_OUT_PORT');

package/dist/health/application/ports/out/shutdown.out-port.d.ts

@@ -0,0 +1,6 @@
+export declare const SHUTDOWN_OUT_PORT: unique symbol;
+export interface ShutdownOutPort {
+    isShuttingDown(): boolean;
+    startGracefulShutdown(): Promise<void>;
+}
+//# sourceMappingURL=shutdown.out-port.d.ts.map

package/dist/health/application/ports/out/shutdown.out-port.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shutdown.out-port.d.ts","sourceRoot":"","sources":["../../../../../src/health/application/ports/out/shutdown.out-port.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,iBAAiB,eAA8B,CAAC;AAE7D,MAAM,WAAW,eAAe;IAC9B,cAAc,IAAI,OAAO,CAAC;IAC1B,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxC"}

package/dist/health/application/ports/out/shutdown.out-port.js

@@ -0,0 +1,4 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SHUTDOWN_OUT_PORT = void 0;
+exports.SHUTDOWN_OUT_PORT = Symbol('SHUTDOWN_OUT_PORT');

package/dist/health/application/ports/out/system-health.out-port.d.ts

@@ -0,0 +1,7 @@
+import { HealthStatus } from '../../../domain/health';
+export declare const SYSTEM_HEALTH_OUT_PORT: unique symbol;
+export interface SystemHealthOutPort {
+    checkMemoryUsage(): HealthStatus;
+    checkSystemResources(): HealthStatus;
+}
+//# sourceMappingURL=system-health.out-port.d.ts.map

package/dist/health/application/ports/out/system-health.out-port.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-health.out-port.d.ts","sourceRoot":"","sources":["../../../../../src/health/application/ports/out/system-health.out-port.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAEtD,eAAO,MAAM,sBAAsB,eAAmC,CAAC;AAEvE,MAAM,WAAW,mBAAmB;IAClC,gBAAgB,IAAI,YAAY,CAAC;IACjC,oBAAoB,IAAI,YAAY,CAAC;CACtC"}

package/dist/health/application/ports/out/system-health.out-port.js

@@ -0,0 +1,4 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SYSTEM_HEALTH_OUT_PORT = void 0;
+exports.SYSTEM_HEALTH_OUT_PORT = Symbol('SYSTEM_HEALTH_OUT_PORT');

package/dist/health/application/services/health.service.d.ts

@@ -0,0 +1,13 @@
+import { HealthInPort } from '../ports/in/health-in.port';
+import { ShutdownOutPort } from '../ports/out/shutdown.out-port';
+import { SystemHealthOutPort } from '../ports/out/system-health.out-port';
+import { ApplicationHealthStatus } from '../../domain/health';
+export declare class HealthService implements HealthInPort {
+    private readonly systemHealthOutPort;
+    private readonly shutdownOutPort;
+    private readonly logger;
+    constructor(systemHealthOutPort: SystemHealthOutPort, shutdownOutPort: ShutdownOutPort);
+    checkHealth(): Promise<ApplicationHealthStatus>;
+    isApplicationShuttingDown(): boolean;
+}
+//# sourceMappingURL=health.service.d.ts.map

package/dist/health/application/services/health.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.service.d.ts","sourceRoot":"","sources":["../../../../src/health/application/services/health.service.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAqB,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACpF,OAAO,EAA0B,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAClG,OAAO,EACL,uBAAuB,EAGxB,MAAM,qBAAqB,CAAC;AAG7B,qBACa,aAAc,YAAW,YAAY;IAK9C,OAAO,CAAC,QAAQ,CAAC,mBAAmB;IAEpC,OAAO,CAAC,QAAQ,CAAC,eAAe;IANlC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkC;gBAItC,mBAAmB,EAAE,mBAAmB,EAExC,eAAe,EAAE,eAAe;IAG7C,WAAW,IAAI,OAAO,CAAC,uBAAuB,CAAC;IAoDrD,yBAAyB,IAAI,OAAO;CAGrC"}

package/dist/health/application/services/health.service.js

@@ -0,0 +1,84 @@
+"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);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+var HealthService_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HealthService = void 0;
+const logger_1 = require("../../../common/logger/logger");
+const shutdown_out_port_1 = require("../ports/out/shutdown.out-port");
+const system_health_out_port_1 = require("../ports/out/system-health.out-port");
+const health_1 = require("../../domain/health");
+const common_1 = require("@nestjs/common");
+let HealthService = HealthService_1 = class HealthService {
+    constructor(systemHealthOutPort, shutdownOutPort) {
+        this.systemHealthOutPort = systemHealthOutPort;
+        this.shutdownOutPort = shutdownOutPort;
+        this.logger = new logger_1.Logger(HealthService_1.name);
+    }
+    async checkHealth() {
+        this.logger.debug('Starting health check...');
+        try {
+            const healthChecks = await Promise.allSettled([
+                Promise.resolve(this.systemHealthOutPort.checkMemoryUsage()),
+                Promise.resolve(this.systemHealthOutPort.checkSystemResources()),
+            ]);
+            const components = [];
+            let overallHealth = true;
+            healthChecks.forEach((result, index) => {
+                const componentNames = ['memory', 'system'];
+                const componentName = componentNames[index];
+                if (result.status === 'fulfilled') {
+                    components.push(result.value);
+                    if (!result.value.healthy) {
+                        overallHealth = false;
+                    }
+                }
+                else {
+                    const failedComponent = {
+                        healthy: false,
+                        component: componentName,
+                    };
+                    components.push(failedComponent);
+                    overallHealth = false;
+                }
+            });
+            const isShuttingDown = this.isApplicationShuttingDown();
+            const healthStatus = {
+                overall: overallHealth,
+                components,
+                uptime: process.uptime(),
+                shutdownStatus: isShuttingDown ? 'draining' : 'active',
+            };
+            if (!overallHealth) {
+                this.logger.error('Health check failed', { components });
+                throw new health_1.HealthCheckFailedException('application', healthStatus);
+            }
+            this.logger.debug('Health check passed');
+            return healthStatus;
+        }
+        catch (error) {
+            this.logger.error('Health check error:', error);
+            throw error;
+        }
+    }
+    isApplicationShuttingDown() {
+        return this.shutdownOutPort.isShuttingDown();
+    }
+};
+exports.HealthService = HealthService;
+exports.HealthService = HealthService = HealthService_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, common_1.Inject)(system_health_out_port_1.SYSTEM_HEALTH_OUT_PORT)),
+    __param(1, (0, common_1.Inject)(shutdown_out_port_1.SHUTDOWN_OUT_PORT)),
+    __metadata("design:paramtypes", [Object, Object])
+], HealthService);

package/dist/health/domain/health.d.ts

@@ -0,0 +1,15 @@
+import { DomainException } from '../../common/error-handling/domain.exception';
+export interface HealthStatus {
+    healthy: boolean;
+    component: string;
+}
+export interface ApplicationHealthStatus {
+    overall: boolean;
+    components: HealthStatus[];
+    uptime: number;
+    shutdownStatus?: 'active' | 'draining';
+}
+export declare class HealthCheckFailedException extends DomainException {
+    constructor(component: string, details?: any);
+}
+//# sourceMappingURL=health.d.ts.map

package/dist/health/domain/health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../../../src/health/domain/health.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,8CAA8C,CAAC;AAG/E,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,YAAY,EAAE,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,QAAQ,GAAG,UAAU,CAAC;CACxC;AAED,qBAAa,0BAA2B,SAAQ,eAAe;gBACjD,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG;CAO7C"}

package/dist/health/domain/health.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HealthCheckFailedException = void 0;
+const domain_exception_1 = require("../../common/error-handling/domain.exception");
+const internal_error_code_1 = require("../../common/error-handling/internal-error-code");
+class HealthCheckFailedException extends domain_exception_1.DomainException {
+    constructor(component, details) {
+        super(internal_error_code_1.InternalErrorCode.HEALTH_CHECK_FAILED, `Health check failed for component: ${component}`, details);
+    }
+}
+exports.HealthCheckFailedException = HealthCheckFailedException;

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

@@ -0,0 +1,10 @@
+import { BeforeApplicationShutdown, OnModuleInit } from '@nestjs/common';
+import { ShutdownOutPort } from './application/ports/out/shutdown.out-port';
+export declare class HealthModule implements BeforeApplicationShutdown, OnModuleInit {
+    private readonly shutdownOutPort;
+    private readonly logger;
+    constructor(shutdownOutPort: ShutdownOutPort);
+    onModuleInit(): void;
+    beforeApplicationShutdown(signal?: string): Promise<void>;
+}
+//# sourceMappingURL=health.module.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"health.module.d.ts","sourceRoot":"","sources":["../../src/health/health.module.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,yBAAyB,EAAkB,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAGzF,OAAO,EAAqB,eAAe,EAAE,MAAM,2CAA2C,CAAC;AAM/F,qBAqBa,YAAa,YAAW,yBAAyB,EAAE,YAAY;IAKxE,OAAO,CAAC,QAAQ,CAAC,eAAe;IAJlC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiC;gBAIrC,eAAe,EAAE,eAAe;IAGnD,YAAY;IAIN,yBAAyB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAMhE"}

package/dist/health/health.module.js

@@ -0,0 +1,68 @@
+"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);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+var HealthModule_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HealthModule = void 0;
+const logger_1 = require("../common/logger/logger");
+const secrets_provider_module_1 = require("../common/secrets-provider/secrets-provider.module");
+const health_in_port_1 = require("./application/ports/in/health-in.port");
+const health_http_in_adapter_1 = require("./infrastructure/adapters/in/health.http.in-adapter");
+const common_1 = require("@nestjs/common");
+const config_1 = require("@nestjs/config");
+const shutdown_out_port_1 = require("./application/ports/out/shutdown.out-port");
+const system_health_out_port_1 = require("./application/ports/out/system-health.out-port");
+const health_service_1 = require("./application/services/health.service");
+const shutdown_out_adapter_1 = require("./infrastructure/adapters/out/shutdown/shutdown.out-adapter");
+const system_health_out_adapter_1 = require("./infrastructure/adapters/out/system/system-health.out-adapter");
+let HealthModule = HealthModule_1 = class HealthModule {
+    constructor(shutdownOutPort) {
+        this.shutdownOutPort = shutdownOutPort;
+        this.logger = new logger_1.Logger(HealthModule_1.name);
+    }
+    onModuleInit() {
+        this.logger.log('HealthModule initialized successfully');
+    }
+    async beforeApplicationShutdown(signal) {
+        this.logger.log(`Received signal: ${signal}`);
+        if (signal === 'SIGTERM' || signal === 'SIGINT') {
+            await this.shutdownOutPort.startGracefulShutdown();
+        }
+    }
+};
+exports.HealthModule = HealthModule;
+exports.HealthModule = HealthModule = HealthModule_1 = __decorate([
+    (0, common_1.Module)({
+        imports: [config_1.ConfigModule, secrets_provider_module_1.SecretsModule],
+        controllers: [health_http_in_adapter_1.HealthHttpInAdapter],
+        providers: [
+            system_health_out_adapter_1.SystemHealthOutAdapter,
+            health_service_1.HealthService,
+            {
+                provide: system_health_out_port_1.SYSTEM_HEALTH_OUT_PORT,
+                useClass: system_health_out_adapter_1.SystemHealthOutAdapter,
+            },
+            {
+                provide: shutdown_out_port_1.SHUTDOWN_OUT_PORT,
+                useClass: shutdown_out_adapter_1.ShutdownOutAdapter,
+            },
+            {
+                provide: health_in_port_1.HEALTH_IN_PORT,
+                useExisting: health_service_1.HealthService,
+            },
+        ],
+        exports: [],
+    }),
+    __param(0, (0, common_1.Inject)(shutdown_out_port_1.SHUTDOWN_OUT_PORT)),
+    __metadata("design:paramtypes", [Object])
+], HealthModule);

package/dist/health/index.d.ts

@@ -0,0 +1,11 @@
+export { HealthStatus, ApplicationHealthStatus, HealthCheckFailedException } from './domain/health';
+export { HEALTH_IN_PORT, HealthInPort } from './application/ports/in/health-in.port';
+export { SYSTEM_HEALTH_OUT_PORT, SystemHealthOutPort, } from './application/ports/out/system-health.out-port';
+export { SHUTDOWN_OUT_PORT, ShutdownOutPort } from './application/ports/out/shutdown.out-port';
+export { DATABASE_HEALTH_OUT_PORT, DatabaseHealthOutPort, } from './application/ports/out/database-health.out-port';
+export { HealthService } from './application/services/health.service';
+export { HealthHttpInAdapter } from './infrastructure/adapters/in/health.http.in-adapter';
+export { SystemHealthOutAdapter } from './infrastructure/adapters/out/system/system-health.out-adapter';
+export { ShutdownOutAdapter } from './infrastructure/adapters/out/shutdown/shutdown.out-adapter';
+export { HealthModule } from './health.module';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/health/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,uBAAuB,EAAE,0BAA0B,EAAE,MAAM,iBAAiB,CAAC;AAGpG,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,uCAAuC,CAAC;AACrF,OAAO,EACL,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,gDAAgD,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,2CAA2C,CAAC;AAC/F,OAAO,EACL,wBAAwB,EACxB,qBAAqB,GACtB,MAAM,kDAAkD,CAAC;AAG1D,OAAO,EAAE,aAAa,EAAE,MAAM,uCAAuC,CAAC;AAGtE,OAAO,EAAE,mBAAmB,EAAE,MAAM,qDAAqD,CAAC;AAC1F,OAAO,EAAE,sBAAsB,EAAE,MAAM,gEAAgE,CAAC;AACxG,OAAO,EAAE,kBAAkB,EAAE,MAAM,6DAA6D,CAAC;AAGjG,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/health/index.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HealthModule = exports.ShutdownOutAdapter = exports.SystemHealthOutAdapter = exports.HealthHttpInAdapter = exports.HealthService = exports.DATABASE_HEALTH_OUT_PORT = exports.SHUTDOWN_OUT_PORT = exports.SYSTEM_HEALTH_OUT_PORT = exports.HEALTH_IN_PORT = exports.HealthCheckFailedException = void 0;
+// Domain
+var health_1 = require("./domain/health");
+Object.defineProperty(exports, "HealthCheckFailedException", { enumerable: true, get: function () { return health_1.HealthCheckFailedException; } });
+// Ports
+var health_in_port_1 = require("./application/ports/in/health-in.port");
+Object.defineProperty(exports, "HEALTH_IN_PORT", { enumerable: true, get: function () { return health_in_port_1.HEALTH_IN_PORT; } });
+var system_health_out_port_1 = require("./application/ports/out/system-health.out-port");
+Object.defineProperty(exports, "SYSTEM_HEALTH_OUT_PORT", { enumerable: true, get: function () { return system_health_out_port_1.SYSTEM_HEALTH_OUT_PORT; } });
+var shutdown_out_port_1 = require("./application/ports/out/shutdown.out-port");
+Object.defineProperty(exports, "SHUTDOWN_OUT_PORT", { enumerable: true, get: function () { return shutdown_out_port_1.SHUTDOWN_OUT_PORT; } });
+var database_health_out_port_1 = require("./application/ports/out/database-health.out-port");
+Object.defineProperty(exports, "DATABASE_HEALTH_OUT_PORT", { enumerable: true, get: function () { return database_health_out_port_1.DATABASE_HEALTH_OUT_PORT; } });
+// Services
+var health_service_1 = require("./application/services/health.service");
+Object.defineProperty(exports, "HealthService", { enumerable: true, get: function () { return health_service_1.HealthService; } });
+// Infrastructure
+var health_http_in_adapter_1 = require("./infrastructure/adapters/in/health.http.in-adapter");
+Object.defineProperty(exports, "HealthHttpInAdapter", { enumerable: true, get: function () { return health_http_in_adapter_1.HealthHttpInAdapter; } });
+var system_health_out_adapter_1 = require("./infrastructure/adapters/out/system/system-health.out-adapter");
+Object.defineProperty(exports, "SystemHealthOutAdapter", { enumerable: true, get: function () { return system_health_out_adapter_1.SystemHealthOutAdapter; } });
+var shutdown_out_adapter_1 = require("./infrastructure/adapters/out/shutdown/shutdown.out-adapter");
+Object.defineProperty(exports, "ShutdownOutAdapter", { enumerable: true, get: function () { return shutdown_out_adapter_1.ShutdownOutAdapter; } });
+// Module
+var health_module_1 = require("./health.module");
+Object.defineProperty(exports, "HealthModule", { enumerable: true, get: function () { return health_module_1.HealthModule; } });

package/dist/health/infrastructure/adapters/in/health.http.in-adapter.d.ts

@@ -0,0 +1,16 @@
+import { HealthInPort } from '../../../application/ports/in/health-in.port';
+import { Response } from 'express';
+export declare class HealthHttpInAdapter {
+    private readonly healthInPort;
+    constructor(healthInPort: HealthInPort);
+    checkHealth(): Promise<{
+        status: string;
+        overall: boolean;
+        uptime: number;
+        shutdownStatus: "active" | "draining" | undefined;
+        components: import("../../../domain/health").HealthStatus[];
+        timestamp: string;
+    }>;
+    readyHealth(res: Response): Promise<Response<any, Record<string, any>>>;
+}
+//# sourceMappingURL=health.http.in-adapter.d.ts.map

package/dist/health/infrastructure/adapters/in/health.http.in-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.http.in-adapter.d.ts","sourceRoot":"","sources":["../../../../../src/health/infrastructure/adapters/in/health.http.in-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,YAAY,EAAE,MAAM,8CAA8C,CAAC;AAI5F,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAEnC,qBAEa,mBAAmB;IAG5B,OAAO,CAAC,QAAQ,CAAC,YAAY;gBAAZ,YAAY,EAAE,YAAY;IAiCvC,WAAW;;;;;;;;IAuBX,WAAW,CAAQ,GAAG,EAAE,QAAQ;CAQvC"}

package/dist/health/infrastructure/adapters/in/health.http.in-adapter.js

@@ -0,0 +1,99 @@
+"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);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HealthHttpInAdapter = void 0;
+const health_in_port_1 = require("../../../application/ports/in/health-in.port");
+const common_1 = require("@nestjs/common");
+const swagger_1 = require("@nestjs/swagger");
+let HealthHttpInAdapter = class HealthHttpInAdapter {
+    constructor(healthInPort) {
+        this.healthInPort = healthInPort;
+    }
+    async checkHealth() {
+        const healthStatus = await this.healthInPort.checkHealth();
+        return {
+            status: 'ok',
+            overall: healthStatus.overall,
+            uptime: healthStatus.uptime,
+            shutdownStatus: healthStatus.shutdownStatus,
+            components: healthStatus.components,
+            timestamp: new Date().toISOString(),
+        };
+    }
+    async readyHealth(res) {
+        const isReady = !this.healthInPort.isApplicationShuttingDown();
+        if (isReady) {
+            return res.status(common_1.HttpStatus.OK).send();
+        }
+        return res.status(common_1.HttpStatus.SERVICE_UNAVAILABLE).send();
+    }
+};
+exports.HealthHttpInAdapter = HealthHttpInAdapter;
+__decorate([
+    (0, common_1.Get)('health'),
+    (0, swagger_1.ApiOperation)({ summary: 'Health check endpoint' }),
+    (0, swagger_1.ApiResponse)({
+        status: 200,
+        description: 'Application is healthy',
+        schema: {
+            type: 'object',
+            properties: {
+                status: { type: 'string', example: 'ok' },
+                overall: { type: 'boolean' },
+                uptime: { type: 'number' },
+                shutdownStatus: { type: 'string', example: 'running' },
+                components: {
+                    type: 'array',
+                    items: {
+                        type: 'object',
+                        properties: {
+                            healthy: { type: 'boolean' },
+                            component: { type: 'string' },
+                        },
+                    },
+                },
+                timestamp: { type: 'string', format: 'date-time' },
+            },
+        },
+    }),
+    (0, swagger_1.ApiResponse)({
+        status: 500,
+        description: 'Application is unhealthy or shutting down',
+    }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", Promise)
+], HealthHttpInAdapter.prototype, "checkHealth", null);
+__decorate([
+    (0, common_1.Get)('ready'),
+    (0, swagger_1.ApiOperation)({ summary: 'Application readiness to take traffic endpoint' }),
+    (0, swagger_1.ApiResponse)({
+        status: 200,
+        description: 'Application is ready',
+    }),
+    (0, swagger_1.ApiResponse)({
+        status: 503,
+        description: 'Application is shutting down',
+    }),
+    __param(0, (0, common_1.Res)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], HealthHttpInAdapter.prototype, "readyHealth", null);
+exports.HealthHttpInAdapter = HealthHttpInAdapter = __decorate([
+    (0, swagger_1.ApiTags)('Application - health'),
+    (0, common_1.Controller)(''),
+    __param(0, (0, common_1.Inject)(health_in_port_1.HEALTH_IN_PORT)),
+    __metadata("design:paramtypes", [Object])
+], HealthHttpInAdapter);

package/dist/health/infrastructure/adapters/out/shutdown/shutdown.out-adapter.d.ts

@@ -0,0 +1,13 @@
+import { ShutdownOutPort } from '../../../../application/ports/out/shutdown.out-port';
+import { ConfigService } from '@nestjs/config';
+export declare class ShutdownOutAdapter implements ShutdownOutPort {
+    private readonly configService;
+    private readonly logger;
+    private shuttingDown;
+    constructor(configService: ConfigService);
+    isShuttingDown(): boolean;
+    startGracefulShutdown(): Promise<void>;
+    private cleanup;
+    private delay;
+}
+//# sourceMappingURL=shutdown.out-adapter.d.ts.map