@omnitronix/game-engine-sdk 1.0.1

package/dist/esm/common/secrets-provider/secrets-provider.aws.js

@@ -0,0 +1,69 @@
+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 AwsSecretsProvider_1;
+import { SecretsManager } from '@aws-sdk/client-secrets-manager';
+import { Inject, Injectable } from '@nestjs/common';
+import { ConfigService } from '@nestjs/config';
+import { Logger } from '../logger/logger';
+let AwsSecretsProvider = AwsSecretsProvider_1 = class AwsSecretsProvider {
+    constructor(configService) {
+        this.configService = configService;
+        this.logger = new Logger(AwsSecretsProvider_1.name);
+        this.secretsCache = new Map();
+        this.secretsManager = new SecretsManager({
+            region: this.configService.get('AWS_REGION') || 'eu-central-1',
+        });
+    }
+    async register() {
+        await this.loadSecrets();
+    }
+    async loadSecrets() {
+        const envName = this.configService.get('AWS_SECRET_ID');
+        if (!envName) {
+            throw new Error(`AWS_SECRET_ID is not defined in environment variables`);
+        }
+        try {
+            this.logger.log(`Fetching secrets from AWS Secrets Manager: ${envName}`);
+            const response = await this.secretsManager.getSecretValue({
+                SecretId: envName,
+            });
+            if (!response.SecretString) {
+                throw new Error(`Secret ${envName} found but has no value.`);
+            }
+            const secretsObject = JSON.parse(response.SecretString);
+            if (typeof secretsObject !== 'object' || secretsObject === null) {
+                throw new Error(`Secret ${envName} is not a valid JSON object.`);
+            }
+            Object.entries(secretsObject).forEach(([key, value]) => {
+                this.secretsCache.set(key, String(value));
+            });
+            this.logger.log(`Successfully loaded secrets from AWS Secrets Manager.`);
+        }
+        catch (error) {
+            this.logger.error(`Failed to retrieve secrets from AWS: ${error.message}`);
+            throw error;
+        }
+    }
+    async get(secretName) {
+        if (!this.secretsCache.has(secretName)) {
+            throw new Error(`Secret ${secretName} not found in cache.`);
+        }
+        return this.secretsCache.get(secretName);
+    }
+};
+AwsSecretsProvider = AwsSecretsProvider_1 = __decorate([
+    Injectable(),
+    __param(0, Inject(ConfigService)),
+    __metadata("design:paramtypes", [ConfigService])
+], AwsSecretsProvider);
+export { AwsSecretsProvider };

package/dist/esm/common/secrets-provider/secrets-provider.js

@@ -0,0 +1 @@
+export const SECRETS_PROVIDER = Symbol('SecretsProvider');

package/dist/esm/common/secrets-provider/secrets-provider.local.js

@@ -0,0 +1,39 @@
+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);
+};
+import { Injectable } from '@nestjs/common';
+import * as dotenv from 'dotenv';
+import * as fs from 'fs';
+import * as path from 'path';
+let LocalSecretsProvider = class LocalSecretsProvider {
+    constructor() {
+        this.secretsCache = new Map();
+        this.loadSecrets();
+    }
+    loadSecrets() {
+        const envPath = path.resolve(process.cwd(), '.secrets.env');
+        if (fs.existsSync(envPath)) {
+            const parsed = dotenv.parse(fs.readFileSync(envPath));
+            Object.entries(parsed).forEach(([key, value]) => {
+                this.secretsCache.set(key, value);
+            });
+        }
+    }
+    async get(secretName) {
+        if (this.secretsCache.has(secretName)) {
+            return this.secretsCache.get(secretName);
+        }
+        throw new Error(`Secret ${secretName} not found in local secrets file`);
+    }
+};
+LocalSecretsProvider = __decorate([
+    Injectable(),
+    __metadata("design:paramtypes", [])
+], LocalSecretsProvider);
+export { LocalSecretsProvider };

package/dist/esm/common/secrets-provider/secrets-provider.module.js

@@ -0,0 +1,44 @@
+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 SecretsModule_1;
+import { Global, Module } from '@nestjs/common';
+import { ConfigModule, ConfigService } from '@nestjs/config';
+import { SECRETS_PROVIDER } from './secrets-provider';
+import { AwsSecretsProvider } from './secrets-provider.aws';
+import { LocalSecretsProvider } from './secrets-provider.local';
+let SecretsModule = SecretsModule_1 = class SecretsModule {
+    static register() {
+        return {
+            module: SecretsModule_1,
+            providers: [
+                {
+                    provide: SECRETS_PROVIDER,
+                    useFactory: async (configService) => {
+                        const useLocalSecrets = configService.get('LOCAL_SECRETS') === 'true';
+                        if (useLocalSecrets) {
+                            return new LocalSecretsProvider();
+                        }
+                        else {
+                            const awsSecretsProvider = new AwsSecretsProvider(configService);
+                            await awsSecretsProvider.register();
+                            return awsSecretsProvider;
+                        }
+                    },
+                    inject: [ConfigService],
+                },
+            ],
+            exports: [SECRETS_PROVIDER],
+        };
+    }
+};
+SecretsModule = SecretsModule_1 = __decorate([
+    Global(),
+    Module({
+        imports: [ConfigModule],
+    })
+], SecretsModule);
+export { SecretsModule };

package/dist/esm/generated/game-engine-registry_pb.js

@@ -0,0 +1,28 @@
+// @generated by protoc-gen-es v2.10.0 with parameter "target=ts"
+// @generated from file game-engine-registry.proto (package game_engine_registry, syntax proto3)
+/* eslint-disable */
+import { fileDesc, messageDesc, serviceDesc } from '@bufbuild/protobuf/codegenv2';
+/**
+ * Describes the file game-engine-registry.proto.
+ */
+export const file_game_engine_registry = 
+/*@__PURE__*/
+fileDesc('ChpnYW1lLWVuZ2luZS1yZWdpc3RyeS5wcm90bxIUZ2FtZV9lbmdpbmVfcmVnaXN0cnkilgEKGVJlZ2lzdGVyR2FtZUVuZ2luZVJlcXVlc3QSEQoJZ2FtZV9jb2RlGAEgASgJEg8KB3ZlcnNpb24YAiABKAkSCwoDcnRwGAMgASgBEhEKCWdhbWVfdHlwZRgEIAEoCRIQCghncnBjX3VybBgFIAEoCRIRCglnYW1lX25hbWUYBiABKAkSEAoIcHJvdmlkZXIYByABKAkiTwoaUmVnaXN0ZXJHYW1lRW5naW5lUmVzcG9uc2USDwoHc3VjY2VzcxgBIAEoCBIUCgdtZXNzYWdlGAIgASgJSACIAQFCCgoIX21lc3NhZ2UylAEKGUdhbWVFbmdpbmVSZWdpc3RyeVNlcnZpY2USdwoSUmVnaXN0ZXJHYW1lRW5naW5lEi8uZ2FtZV9lbmdpbmVfcmVnaXN0cnkuUmVnaXN0ZXJHYW1lRW5naW5lUmVxdWVzdBowLmdhbWVfZW5naW5lX3JlZ2lzdHJ5LlJlZ2lzdGVyR2FtZUVuZ2luZVJlc3BvbnNlYgZwcm90bzM');
+/**
+ * Describes the message game_engine_registry.RegisterGameEngineRequest.
+ * Use `create(RegisterGameEngineRequestSchema)` to create a new message.
+ */
+export const RegisterGameEngineRequestSchema = 
+/*@__PURE__*/
+messageDesc(file_game_engine_registry, 0);
+/**
+ * Describes the message game_engine_registry.RegisterGameEngineResponse.
+ * Use `create(RegisterGameEngineResponseSchema)` to create a new message.
+ */
+export const RegisterGameEngineResponseSchema = 
+/*@__PURE__*/
+messageDesc(file_game_engine_registry, 1);
+/**
+ * @generated from service game_engine_registry.GameEngineRegistryService
+ */
+export const GameEngineRegistryService = /*@__PURE__*/ serviceDesc(file_game_engine_registry, 0);

package/dist/esm/generated/game-engine_pb.js

@@ -0,0 +1,57 @@
+// @generated by protoc-gen-es v2.10.0 with parameter "target=ts"
+// @generated from file game-engine.proto (package game_engine, syntax proto3)
+/* eslint-disable */
+import { fileDesc, messageDesc, serviceDesc } from '@bufbuild/protobuf/codegenv2';
+import { file_google_protobuf_struct } from '@bufbuild/protobuf/wkt';
+/**
+ * Describes the file game-engine.proto.
+ */
+export const file_game_engine = 
+/*@__PURE__*/
+fileDesc('ChFnYW1lLWVuZ2luZS5wcm90bxILZ2FtZV9lbmdpbmUi5QEKFVByb2Nlc3NDb21tYW5kUmVxdWVzdBIyCgxwdWJsaWNfc3RhdGUYASABKAsyFy5nb29nbGUucHJvdG9idWYuU3RydWN0SACIAQESMwoNcHJpdmF0ZV9zdGF0ZRgCIAEoCzIXLmdvb2dsZS5wcm90b2J1Zi5TdHJ1Y3RIAYgBARI0Cgdjb21tYW5kGAMgASgLMh4uZ2FtZV9lbmdpbmUuR2FtZUFjdGlvbkNvbW1hbmRIAogBAUIPCg1fcHVibGljX3N0YXRlQhAKDl9wcml2YXRlX3N0YXRlQgoKCF9jb21tYW5kImgKEUdhbWVBY3Rpb25Db21tYW5kEgoKAmlkGAEgASgJEgwKBHR5cGUYAiABKAkSLQoHcGF5bG9hZBgDIAEoCzIXLmdvb2dsZS5wcm90b2J1Zi5TdHJ1Y3RIAIgBAUIKCghfcGF5bG9hZCJKChBSbmdPdXRjb21lUmVjb3JkEg4KBnJlc3VsdBgBIAEoARIMCgRzZWVkGAIgASgJEgsKA21pbhgDIAEoARILCgNtYXgYBCABKAEirgMKFlByb2Nlc3NDb21tYW5kUmVzcG9uc2USDwoHc3VjY2VzcxgBIAEoCBIyCgxwdWJsaWNfc3RhdGUYAiABKAsyFy5nb29nbGUucHJvdG9idWYuU3RydWN0SACIAQESMwoNcHJpdmF0ZV9zdGF0ZRgDIAEoCzIXLmdvb2dsZS5wcm90b2J1Zi5TdHJ1Y3RIAYgBARItCgdvdXRjb21lGAQgASgLMhcuZ29vZ2xlLnByb3RvYnVmLlN0cnVjdEgCiAEBEhQKB21lc3NhZ2UYBSABKAlIA4gBARJICgtybmdfb3V0Y29tZRgGIAMoCzIzLmdhbWVfZW5naW5lLlByb2Nlc3NDb21tYW5kUmVzcG9uc2UuUm5nT3V0Y29tZUVudHJ5GlAKD1JuZ091dGNvbWVFbnRyeRILCgNrZXkYASABKAkSLAoFdmFsdWUYAiABKAsyHS5nYW1lX2VuZ2luZS5SbmdPdXRjb21lUmVjb3JkOgI4AUIPCg1fcHVibGljX3N0YXRlQhAKDl9wcml2YXRlX3N0YXRlQgoKCF9vdXRjb21lQgoKCF9tZXNzYWdlIhoKGEdldEdhbWVFbmdpbmVJbmZvUmVxdWVzdCJfChlHZXRHYW1lRW5naW5lSW5mb1Jlc3BvbnNlEhEKCWdhbWVfY29kZRgBIAEoCRIPCgd2ZXJzaW9uGAIgASgJEgsKA3J0cBgDIAEoARIRCglnYW1lX3R5cGUYBCABKAky0gEKEUdhbWVFbmdpbmVTZXJ2aWNlElkKDlByb2Nlc3NDb21tYW5kEiIuZ2FtZV9lbmdpbmUuUHJvY2Vzc0NvbW1hbmRSZXF1ZXN0GiMuZ2FtZV9lbmdpbmUuUHJvY2Vzc0NvbW1hbmRSZXNwb25zZRJiChFHZXRHYW1lRW5naW5lSW5mbxIlLmdhbWVfZW5naW5lLkdldEdhbWVFbmdpbmVJbmZvUmVxdWVzdBomLmdhbWVfZW5naW5lLkdldEdhbWVFbmdpbmVJbmZvUmVzcG9uc2ViBnByb3RvMw', [file_google_protobuf_struct]);
+/**
+ * Describes the message game_engine.ProcessCommandRequest.
+ * Use `create(ProcessCommandRequestSchema)` to create a new message.
+ */
+export const ProcessCommandRequestSchema = 
+/*@__PURE__*/
+messageDesc(file_game_engine, 0);
+/**
+ * Describes the message game_engine.GameActionCommand.
+ * Use `create(GameActionCommandSchema)` to create a new message.
+ */
+export const GameActionCommandSchema = 
+/*@__PURE__*/
+messageDesc(file_game_engine, 1);
+/**
+ * Describes the message game_engine.RngOutcomeRecord.
+ * Use `create(RngOutcomeRecordSchema)` to create a new message.
+ */
+export const RngOutcomeRecordSchema = 
+/*@__PURE__*/
+messageDesc(file_game_engine, 2);
+/**
+ * Describes the message game_engine.ProcessCommandResponse.
+ * Use `create(ProcessCommandResponseSchema)` to create a new message.
+ */
+export const ProcessCommandResponseSchema = 
+/*@__PURE__*/
+messageDesc(file_game_engine, 3);
+/**
+ * Describes the message game_engine.GetGameEngineInfoRequest.
+ * Use `create(GetGameEngineInfoRequestSchema)` to create a new message.
+ */
+export const GetGameEngineInfoRequestSchema = 
+/*@__PURE__*/
+messageDesc(file_game_engine, 4);
+/**
+ * Describes the message game_engine.GetGameEngineInfoResponse.
+ * Use `create(GetGameEngineInfoResponseSchema)` to create a new message.
+ */
+export const GetGameEngineInfoResponseSchema = 
+/*@__PURE__*/
+messageDesc(file_game_engine, 5);
+/**
+ * @generated from service game_engine.GameEngineService
+ */
+export const GameEngineService = /*@__PURE__*/ serviceDesc(file_game_engine, 0);

package/dist/esm/grpc/connect-router.middleware.js

@@ -0,0 +1,16 @@
+import { connectNodeAdapter } from '@connectrpc/connect-node';
+import { GameEngineService } from '../generated/game-engine_pb';
+/**
+ * Creates Connect router middleware for GameEngineService.
+ * This replaces NestJS built-in gRPC transport with Connect-compatible server.
+ */
+export function createConnectRouter(gameEngineAdapter) {
+    return connectNodeAdapter({
+        routes: router => {
+            router.service(GameEngineService, {
+                processCommand: gameEngineAdapter.processCommand.bind(gameEngineAdapter),
+                getGameEngineInfo: gameEngineAdapter.getGameEngineInfo.bind(gameEngineAdapter),
+            });
+        },
+    });
+}

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

@@ -0,0 +1,109 @@
+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;
+import { create } from '@bufbuild/protobuf';
+import { Logger } from '../common/logger/logger';
+import { GetGameEngineInfoResponseSchema, ProcessCommandResponseSchema, } from '../generated/game-engine_pb';
+import { GAME_ENGINE_IN_PORT, } from '../types';
+import { Inject, Injectable } from '@nestjs/common';
+let GameEngineGrpcInAdapter = GameEngineGrpcInAdapter_1 = class GameEngineGrpcInAdapter {
+    constructor(gameEngineInPort) {
+        this.gameEngineInPort = gameEngineInPort;
+        this.logger = new 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 create(ProcessCommandResponseSchema, {
+            success: result.success ?? true,
+            publicState: result.publicState,
+            privateState: result.privateState,
+            outcome: result.outcome,
+            message: result.message,
+            rngOutcome: rngOutcome,
+        });
+    }
+    createErrorResponse(request, error) {
+        return create(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 create(GetGameEngineInfoResponseSchema, {
+            gameCode: gameEngineInfo.gameCode,
+            version: gameEngineInfo.version,
+            rtp: gameEngineInfo.rtp,
+            gameType: gameEngineInfo.gameType,
+        });
+    }
+};
+GameEngineGrpcInAdapter = GameEngineGrpcInAdapter_1 = __decorate([
+    Injectable(),
+    __param(0, Inject(GAME_ENGINE_IN_PORT)),
+    __metadata("design:paramtypes", [Object])
+], GameEngineGrpcInAdapter);
+export { GameEngineGrpcInAdapter };

package/dist/esm/grpc/index.js

@@ -0,0 +1,2 @@
+export { GameEngineGrpcInAdapter } from './game-engine.grpc.in-adapter';
+export { createConnectRouter } from './connect-router.middleware';

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

@@ -0,0 +1 @@
+export const HEALTH_IN_PORT = Symbol('HEALTH_IN_PORT');

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

@@ -0,0 +1 @@
+export const DATABASE_HEALTH_OUT_PORT = Symbol('DATABASE_HEALTH_OUT_PORT');

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

@@ -0,0 +1 @@
+export const SHUTDOWN_OUT_PORT = Symbol('SHUTDOWN_OUT_PORT');

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

@@ -0,0 +1 @@
+export const SYSTEM_HEALTH_OUT_PORT = Symbol('SYSTEM_HEALTH_OUT_PORT');

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

@@ -0,0 +1,81 @@
+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;
+import { Logger } from '../../../common/logger/logger';
+import { SHUTDOWN_OUT_PORT } from '../ports/out/shutdown.out-port';
+import { SYSTEM_HEALTH_OUT_PORT } from '../ports/out/system-health.out-port';
+import { HealthCheckFailedException, } from '../../domain/health';
+import { Inject, Injectable } from '@nestjs/common';
+let HealthService = HealthService_1 = class HealthService {
+    constructor(systemHealthOutPort, shutdownOutPort) {
+        this.systemHealthOutPort = systemHealthOutPort;
+        this.shutdownOutPort = shutdownOutPort;
+        this.logger = new 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 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();
+    }
+};
+HealthService = HealthService_1 = __decorate([
+    Injectable(),
+    __param(0, Inject(SYSTEM_HEALTH_OUT_PORT)),
+    __param(1, Inject(SHUTDOWN_OUT_PORT)),
+    __metadata("design:paramtypes", [Object, Object])
+], HealthService);
+export { HealthService };

package/dist/esm/health/domain/health.js

@@ -0,0 +1,7 @@
+import { DomainException } from '../../common/error-handling/domain.exception';
+import { InternalErrorCode } from '../../common/error-handling/internal-error-code';
+export class HealthCheckFailedException extends DomainException {
+    constructor(component, details) {
+        super(InternalErrorCode.HEALTH_CHECK_FAILED, `Health check failed for component: ${component}`, details);
+    }
+}

package/dist/esm/health/health.module.js

@@ -0,0 +1,65 @@
+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;
+import { Logger } from '../common/logger/logger';
+import { SecretsModule } from '../common/secrets-provider/secrets-provider.module';
+import { HEALTH_IN_PORT } from './application/ports/in/health-in.port';
+import { HealthHttpInAdapter } from './infrastructure/adapters/in/health.http.in-adapter';
+import { Inject, Module } from '@nestjs/common';
+import { ConfigModule } from '@nestjs/config';
+import { SHUTDOWN_OUT_PORT } from './application/ports/out/shutdown.out-port';
+import { SYSTEM_HEALTH_OUT_PORT } from './application/ports/out/system-health.out-port';
+import { HealthService } from './application/services/health.service';
+import { ShutdownOutAdapter } from './infrastructure/adapters/out/shutdown/shutdown.out-adapter';
+import { SystemHealthOutAdapter } from './infrastructure/adapters/out/system/system-health.out-adapter';
+let HealthModule = HealthModule_1 = class HealthModule {
+    constructor(shutdownOutPort) {
+        this.shutdownOutPort = shutdownOutPort;
+        this.logger = new 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();
+        }
+    }
+};
+HealthModule = HealthModule_1 = __decorate([
+    Module({
+        imports: [ConfigModule, SecretsModule],
+        controllers: [HealthHttpInAdapter],
+        providers: [
+            SystemHealthOutAdapter,
+            HealthService,
+            {
+                provide: SYSTEM_HEALTH_OUT_PORT,
+                useClass: SystemHealthOutAdapter,
+            },
+            {
+                provide: SHUTDOWN_OUT_PORT,
+                useClass: ShutdownOutAdapter,
+            },
+            {
+                provide: HEALTH_IN_PORT,
+                useExisting: HealthService,
+            },
+        ],
+        exports: [],
+    }),
+    __param(0, Inject(SHUTDOWN_OUT_PORT)),
+    __metadata("design:paramtypes", [Object])
+], HealthModule);
+export { HealthModule };

package/dist/esm/health/index.js

@@ -0,0 +1,15 @@
+// Domain
+export { HealthCheckFailedException } from './domain/health';
+// Ports
+export { HEALTH_IN_PORT } from './application/ports/in/health-in.port';
+export { SYSTEM_HEALTH_OUT_PORT, } from './application/ports/out/system-health.out-port';
+export { SHUTDOWN_OUT_PORT } from './application/ports/out/shutdown.out-port';
+export { DATABASE_HEALTH_OUT_PORT, } from './application/ports/out/database-health.out-port';
+// Services
+export { HealthService } from './application/services/health.service';
+// Infrastructure
+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';
+// Module
+export { HealthModule } from './health.module';

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

@@ -0,0 +1,96 @@
+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); }
+};
+import { HEALTH_IN_PORT } from '../../../application/ports/in/health-in.port';
+import { Controller, Get, HttpStatus, Inject, Res } from '@nestjs/common';
+import { ApiOperation, ApiResponse, ApiTags } from '@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(HttpStatus.OK).send();
+        }
+        return res.status(HttpStatus.SERVICE_UNAVAILABLE).send();
+    }
+};
+__decorate([
+    Get('health'),
+    ApiOperation({ summary: 'Health check endpoint' }),
+    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' },
+            },
+        },
+    }),
+    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([
+    Get('ready'),
+    ApiOperation({ summary: 'Application readiness to take traffic endpoint' }),
+    ApiResponse({
+        status: 200,
+        description: 'Application is ready',
+    }),
+    ApiResponse({
+        status: 503,
+        description: 'Application is shutting down',
+    }),
+    __param(0, Res()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], HealthHttpInAdapter.prototype, "readyHealth", null);
+HealthHttpInAdapter = __decorate([
+    ApiTags('Application - health'),
+    Controller(''),
+    __param(0, Inject(HEALTH_IN_PORT)),
+    __metadata("design:paramtypes", [Object])
+], HealthHttpInAdapter);
+export { HealthHttpInAdapter };