@omnitronix/game-engine-sdk 1.0.1

package/dist/common/error-handling/internal-error-code.js

@@ -0,0 +1,80 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InternalErrorCode = void 0;
+var InternalErrorCode;
+(function (InternalErrorCode) {
+    InternalErrorCode["FORBIDDEN"] = "FORBIDDEN";
+    InternalErrorCode["INTERNAL_SERVER_ERROR"] = "INTERNAL_SERVER_ERROR";
+    InternalErrorCode["INSUFFICIENT_FUNDS"] = "INSUFFICIENT_FUNDS";
+    InternalErrorCode["INVALID_CURRENCY_CODE"] = "INVALID_CURRENCY_CODE";
+    // Game Catalog errors
+    InternalErrorCode["GAME_NOT_FOUND"] = "GAME_NOT_FOUND";
+    InternalErrorCode["GAME_CONFIG_NOT_FOUND"] = "GAME_CONFIG_NOT_FOUND";
+    InternalErrorCode["GAME_CONFIG_ALREADY_EXISTS_WITH_SAME_JURISDICTION_AND_RTP"] = "GAME_CONFIG_ALREADY_EXISTS_WITH_SAME_JURISDICTION_AND_RTP";
+    InternalErrorCode["OPERATOR_GAME_NOT_FOUND"] = "OPERATOR_GAME_NOT_FOUND";
+    InternalErrorCode["OPERATOR_GAME_ALREADY_ENABLED"] = "OPERATOR_GAME_ALREADY_ENABLED";
+    InternalErrorCode["INVALID_GAME_CONFIG_DATA"] = "INVALID_GAME_CONFIG_DATA";
+    InternalErrorCode["INVALID_GAME_UPDATE_DATA"] = "INVALID_GAME_UPDATE_DATA";
+    InternalErrorCode["GAME_CODE_ALREADY_EXISTS"] = "GAME_CODE_ALREADY_EXISTS";
+    InternalErrorCode["GAME_ENGINE_ERROR"] = "GAME_ENGINE_ERROR";
+    InternalErrorCode["GAME_OR_GAME_CONFIG_DISABLED"] = "GAME_OR_GAME_CONFIG_DISABLED";
+    InternalErrorCode["DEBUG_COMMANDS_DISABLED"] = "DEBUG_COMMANDS_DISABLED";
+    // Game Orchestrator errors
+    InternalErrorCode["INVALID_SESSION"] = "INVALID_SESSION";
+    InternalErrorCode["SESSION_NOT_FOUND"] = "SESSION_NOT_FOUND";
+    InternalErrorCode["SESSION_NOT_ACTIVE"] = "SESSION_NOT_ACTIVE";
+    InternalErrorCode["SESSION_MISMATCH"] = "SESSION_MISMATCH";
+    InternalErrorCode["INVALID_STATE_TRANSITION"] = "INVALID_STATE_TRANSITION";
+    InternalErrorCode["INVALID_BET_AMOUNT"] = "INVALID_BET_AMOUNT";
+    InternalErrorCode["REALITY_CHECK_IN_PROGRESS"] = "REALITY_CHECK_IN_PROGRESS";
+    InternalErrorCode["SESSION_TERMINATED"] = "SESSION_TERMINATED";
+    InternalErrorCode["SESSION_CANNOT_BE_TERMINATED"] = "SESSION_CANNOT_BE_TERMINATED";
+    InternalErrorCode["SESSION_AUTO_RESOLVE_FAILED"] = "SESSION_AUTO_RESOLVE_FAILED";
+    InternalErrorCode["SESSION_ALREADY_EXISTS"] = "SESSION_ALREADY_EXISTS";
+    InternalErrorCode["INCOMPATIBLE_GAMEPLAY_CONFIG"] = "INCOMPATIBLE_GAMEPLAY_CONFIG";
+    InternalErrorCode["UNKNOWN_COMMAND"] = "UNKNOWN_COMMAND";
+    // Operator errors
+    InternalErrorCode["MISSING_OPERATOR_CODE"] = "MISSING_OPERATOR_CODE";
+    InternalErrorCode["INVALID_OPERATOR_CODE"] = "INVALID_OPERATOR_CODE";
+    InternalErrorCode["OPERATOR_NOT_FOUND"] = "OPERATOR_NOT_FOUND";
+    InternalErrorCode["OPERATOR_INACTIVE"] = "OPERATOR_INACTIVE";
+    InternalErrorCode["COUNTRY_CODE_RESTRICTED"] = "COUNTRY_CODE_RESTRICTED";
+    InternalErrorCode["UNAUTHORIZED"] = "UNAUTHORIZED";
+    InternalErrorCode["AUTH_VALIDATION_FAILED"] = "AUTH_VALIDATION_FAILED";
+    InternalErrorCode["BALANCE_NOT_FOUND"] = "BALANCE_NOT_FOUND";
+    InternalErrorCode["DEBIT_FAILED"] = "DEBIT_FAILED";
+    InternalErrorCode["CREDIT_FAILED"] = "CREDIT_FAILED";
+    InternalErrorCode["INVALID_AUTH_DATA"] = "INVALID_AUTH_DATA";
+    InternalErrorCode["VALIDATION_ERROR"] = "VALIDATION_ERROR";
+    InternalErrorCode["JURISDICTION_CONFIG_ALREADY_EXISTS"] = "JURISDICTION_CONFIG_ALREADY_EXISTS";
+    InternalErrorCode["JURISDICTION_CONFIG_NOT_FOUND"] = "JURISDICTION_CONFIG_NOT_FOUND";
+    InternalErrorCode["OPERATOR_JURISDICTION_CONFIG_NOT_FOUND"] = "OPERATOR_JURISDICTION_CONFIG_NOT_FOUND";
+    // Game round log errors
+    InternalErrorCode["GAME_ROUND_LOG_NOT_FOUND"] = "GAME_ROUND_LOG_NOT_FOUND";
+    // Geo Validation errors
+    InternalErrorCode["COUNTRY_NOT_PERMITTED"] = "COUNTRY_NOT_PERMITTED";
+    InternalErrorCode["GEO_VALIDATION_SERVICE_UNAVAILABLE"] = "GEO_VALIDATION_SERVICE_UNAVAILABLE";
+    InternalErrorCode["RESOURCE_NOT_FOUND"] = "RESOURCE_NOT_FOUND";
+    // Financial transaction errors
+    InternalErrorCode["FINANCIAL_TRANSACTION_NOT_FOUND"] = "FINANCIAL_TRANSACTION_NOT_FOUND";
+    //Health check errors
+    InternalErrorCode["HEALTH_CHECK_FAILED"] = "HEALTH_CHECK_FAILED";
+    //Jackpot errors
+    InternalErrorCode["JACKPOT_TYPE_NOT_FOUND"] = "JACKPOT_TYPE_NOT_FOUND";
+    InternalErrorCode["JACKPOT_TIER_NOT_FOUND"] = "JACKPOT_TIER_NOT_FOUND";
+    InternalErrorCode["JACKPOT_CONFIGURATION_NOT_FOUND"] = "JACKPOT_CONFIGURATION_NOT_FOUND";
+    InternalErrorCode["JACKPOT_CONFIGURATION_IS_ACTIVE"] = "JACKPOT_CONFIGURATION_IS_ACTIVE";
+    InternalErrorCode["JACKPOT_POOL_CONTRIBUTION_ALREADY_PROCESSED"] = "JACKPOT_POOL_CONTRIBUTION_ALREADY_PROCESSED";
+    InternalErrorCode["JACKPOT_TYPE_DOES_NOT_SUPPORT_TIERS"] = "JACKPOT_TYPE_DOES_NOT_SUPPORT_TIERS";
+    // RNG and Replay errors
+    InternalErrorCode["RNG_SEED_NOT_FOUND"] = "RNG_SEED_NOT_FOUND";
+    InternalErrorCode["RNG_SEED_MISMATCH"] = "RNG_SEED_MISMATCH";
+    InternalErrorCode["MASTER_HASH_INVALID"] = "MASTER_HASH_INVALID";
+    InternalErrorCode["REPLAY_OUTCOME_MISMATCH"] = "REPLAY_OUTCOME_MISMATCH";
+    // Concurrency
+    InternalErrorCode["CONCURRENT_MODIFICATION"] = "CONCURRENT_MODIFICATION";
+    InternalErrorCode["ACCOUNT_LOCKED"] = "ACCOUNT_LOCKED";
+    InternalErrorCode["DAILY_LIMIT_EXCEEDED"] = "DAILY_LIMIT_EXCEEDED";
+    InternalErrorCode["INVALID_AMOUNT"] = "INVALID_AMOUNT";
+    InternalErrorCode["SERVICE_UNAVAILABLE"] = "SERVICE_UNAVAILABLE";
+})(InternalErrorCode || (exports.InternalErrorCode = InternalErrorCode = {}));

package/dist/common/index.d.ts

@@ -0,0 +1,21 @@
+export { Logger } from './logger/logger';
+export { LoggerModule } from './logger/logger.module';
+export { LoggingMiddleware } from './logger/logging.middleware';
+export { DomainException } from './error-handling/domain.exception';
+export { InternalErrorCode } from './error-handling/internal-error-code';
+export { ErrorCodeMapper } from './error-handling/error-code-mapper';
+export { ExceptionsFilter, ErrorResponse } from './error-handling/all-exceptions.filter';
+export { SECRETS_PROVIDER, SecretsProvider } from './secrets-provider/secrets-provider';
+export { SecretsModule } from './secrets-provider/secrets-provider.module';
+export { LocalSecretsProvider } from './secrets-provider/secrets-provider.local';
+export { AwsSecretsProvider } from './secrets-provider/secrets-provider.aws';
+export { RetryPolicy, RetryOptions } from './retry/retry-policy';
+export { RetryPolicies, HTTP_RETRYABLE_ERRORS } from './retry/retry-policies';
+export { METRICS_PORT, MetricsPort, Counter, Gauge, Histogram } from './metrics/metrics.port';
+export { PrometheusService } from './metrics/prometheus.service';
+export { MetricsModule } from './metrics/metrics.module';
+export { DatabaseMetricsService } from './metrics/database-metrics.service';
+export { toMinorUnits, getEventCountBucket, getStreamVersionBucket, sanitizeRoute, } from './metrics/helpers/metrics.helpers';
+export { setupDocumentation } from './api-docs/setup-documentation';
+export { ApplicationBootstrapOptions } from './application-bootstrap-options.interface';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/common/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAGhE,OAAO,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AACpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AACzE,OAAO,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AACrE,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,wCAAwC,CAAC;AAGzF,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AACxF,OAAO,EAAE,aAAa,EAAE,MAAM,4CAA4C,CAAC;AAC3E,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,kBAAkB,EAAE,MAAM,yCAAyC,CAAC;AAG7E,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAG9E,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAC9F,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAC;AAC5E,OAAO,EACL,YAAY,EACZ,mBAAmB,EACnB,sBAAsB,EACtB,aAAa,GACd,MAAM,mCAAmC,CAAC;AAG3C,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAGpE,OAAO,EAAE,2BAA2B,EAAE,MAAM,2CAA2C,CAAC"}

package/dist/common/index.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setupDocumentation = exports.sanitizeRoute = exports.getStreamVersionBucket = exports.getEventCountBucket = exports.toMinorUnits = exports.DatabaseMetricsService = exports.MetricsModule = exports.PrometheusService = exports.METRICS_PORT = exports.HTTP_RETRYABLE_ERRORS = exports.RetryPolicies = exports.RetryPolicy = exports.AwsSecretsProvider = exports.LocalSecretsProvider = exports.SecretsModule = exports.SECRETS_PROVIDER = exports.ExceptionsFilter = exports.ErrorCodeMapper = exports.InternalErrorCode = exports.DomainException = exports.LoggingMiddleware = exports.LoggerModule = exports.Logger = void 0;
+// Logger
+var logger_1 = require("./logger/logger");
+Object.defineProperty(exports, "Logger", { enumerable: true, get: function () { return logger_1.Logger; } });
+var logger_module_1 = require("./logger/logger.module");
+Object.defineProperty(exports, "LoggerModule", { enumerable: true, get: function () { return logger_module_1.LoggerModule; } });
+var logging_middleware_1 = require("./logger/logging.middleware");
+Object.defineProperty(exports, "LoggingMiddleware", { enumerable: true, get: function () { return logging_middleware_1.LoggingMiddleware; } });
+// Error Handling
+var domain_exception_1 = require("./error-handling/domain.exception");
+Object.defineProperty(exports, "DomainException", { enumerable: true, get: function () { return domain_exception_1.DomainException; } });
+var internal_error_code_1 = require("./error-handling/internal-error-code");
+Object.defineProperty(exports, "InternalErrorCode", { enumerable: true, get: function () { return internal_error_code_1.InternalErrorCode; } });
+var error_code_mapper_1 = require("./error-handling/error-code-mapper");
+Object.defineProperty(exports, "ErrorCodeMapper", { enumerable: true, get: function () { return error_code_mapper_1.ErrorCodeMapper; } });
+var all_exceptions_filter_1 = require("./error-handling/all-exceptions.filter");
+Object.defineProperty(exports, "ExceptionsFilter", { enumerable: true, get: function () { return all_exceptions_filter_1.ExceptionsFilter; } });
+// Secrets Provider
+var secrets_provider_1 = require("./secrets-provider/secrets-provider");
+Object.defineProperty(exports, "SECRETS_PROVIDER", { enumerable: true, get: function () { return secrets_provider_1.SECRETS_PROVIDER; } });
+var secrets_provider_module_1 = require("./secrets-provider/secrets-provider.module");
+Object.defineProperty(exports, "SecretsModule", { enumerable: true, get: function () { return secrets_provider_module_1.SecretsModule; } });
+var secrets_provider_local_1 = require("./secrets-provider/secrets-provider.local");
+Object.defineProperty(exports, "LocalSecretsProvider", { enumerable: true, get: function () { return secrets_provider_local_1.LocalSecretsProvider; } });
+var secrets_provider_aws_1 = require("./secrets-provider/secrets-provider.aws");
+Object.defineProperty(exports, "AwsSecretsProvider", { enumerable: true, get: function () { return secrets_provider_aws_1.AwsSecretsProvider; } });
+// Retry
+var retry_policy_1 = require("./retry/retry-policy");
+Object.defineProperty(exports, "RetryPolicy", { enumerable: true, get: function () { return retry_policy_1.RetryPolicy; } });
+var retry_policies_1 = require("./retry/retry-policies");
+Object.defineProperty(exports, "RetryPolicies", { enumerable: true, get: function () { return retry_policies_1.RetryPolicies; } });
+Object.defineProperty(exports, "HTTP_RETRYABLE_ERRORS", { enumerable: true, get: function () { return retry_policies_1.HTTP_RETRYABLE_ERRORS; } });
+// Metrics
+var metrics_port_1 = require("./metrics/metrics.port");
+Object.defineProperty(exports, "METRICS_PORT", { enumerable: true, get: function () { return metrics_port_1.METRICS_PORT; } });
+var prometheus_service_1 = require("./metrics/prometheus.service");
+Object.defineProperty(exports, "PrometheusService", { enumerable: true, get: function () { return prometheus_service_1.PrometheusService; } });
+var metrics_module_1 = require("./metrics/metrics.module");
+Object.defineProperty(exports, "MetricsModule", { enumerable: true, get: function () { return metrics_module_1.MetricsModule; } });
+var database_metrics_service_1 = require("./metrics/database-metrics.service");
+Object.defineProperty(exports, "DatabaseMetricsService", { enumerable: true, get: function () { return database_metrics_service_1.DatabaseMetricsService; } });
+var metrics_helpers_1 = require("./metrics/helpers/metrics.helpers");
+Object.defineProperty(exports, "toMinorUnits", { enumerable: true, get: function () { return metrics_helpers_1.toMinorUnits; } });
+Object.defineProperty(exports, "getEventCountBucket", { enumerable: true, get: function () { return metrics_helpers_1.getEventCountBucket; } });
+Object.defineProperty(exports, "getStreamVersionBucket", { enumerable: true, get: function () { return metrics_helpers_1.getStreamVersionBucket; } });
+Object.defineProperty(exports, "sanitizeRoute", { enumerable: true, get: function () { return metrics_helpers_1.sanitizeRoute; } });
+// API Docs
+var setup_documentation_1 = require("./api-docs/setup-documentation");
+Object.defineProperty(exports, "setupDocumentation", { enumerable: true, get: function () { return setup_documentation_1.setupDocumentation; } });

package/dist/common/logger/logger.d.ts

@@ -0,0 +1,24 @@
+import { LoggerService as NestLoggerService } from '@nestjs/common';
+type LogFormat = 'json' | 'pretty';
+export declare class Logger implements NestLoggerService {
+    private readonly logger;
+    private context;
+    constructor(context: string, logFormat?: LogFormat);
+    private detectLogFormat;
+    private createWinstonLogger;
+    private getLogFormat;
+    private selectFormat;
+    private getJsonFormat;
+    private getPrettyFormat;
+    private safeStringify;
+    private getTransports;
+    log(message: any, { level, ...rest }?: {
+        level?: string;
+    } & Record<string, any>): void;
+    error(message: any, ...optionalParams: any[]): void;
+    warn(message: any, ...optionalParams: any[]): void;
+    debug(message: any, ...optionalParams: any[]): void;
+    verbose(message: any, ...optionalParams: any[]): void;
+}
+export {};
+//# sourceMappingURL=logger.d.ts.map

package/dist/common/logger/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/common/logger/logger.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,IAAI,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAGpE,KAAK,SAAS,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEnC,qBAAa,MAAO,YAAW,iBAAiB;IAC9C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,OAAO,CAAS;gBAEZ,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,SAAS;IAMlD,OAAO,CAAC,eAAe;IAavB,OAAO,CAAC,mBAAmB;IAU3B,OAAO,CAAC,YAAY;IAIpB,OAAO,CAAC,YAAY;IAWpB,OAAO,CAAC,aAAa;IAYrB,OAAO,CAAC,eAAe;IA+BvB,OAAO,CAAC,aAAa;IAarB,OAAO,CAAC,aAAa;IAIrB,GAAG,CAAC,OAAO,EAAE,GAAG,EAAE,EAAE,KAAc,EAAE,GAAG,IAAI,EAAE,GAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM;IAoB5F,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,EAAE;IAsB5C,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,EAAE;IAI3C,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,EAAE;IAI5C,OAAO,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,EAAE;CAG/C"}

package/dist/common/logger/logger.js

@@ -0,0 +1,137 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Logger = void 0;
+const domain_exception_1 = require("../error-handling/domain.exception");
+const winston_1 = require("winston");
+class Logger {
+    constructor(context, logFormat) {
+        this.context = context;
+        const format = logFormat ?? this.detectLogFormat();
+        this.logger = this.createWinstonLogger(format);
+    }
+    detectLogFormat() {
+        const envFormat = process.env.LOG_FORMAT?.toLowerCase();
+        switch (envFormat) {
+            case 'pretty':
+                return 'pretty';
+            case 'json':
+                return 'json';
+            default:
+                return 'json';
+        }
+    }
+    createWinstonLogger(logFormat) {
+        const winstonFormat = this.getLogFormat(logFormat);
+        return (0, winston_1.createLogger)({
+            level: 'info',
+            format: winstonFormat,
+            transports: this.getTransports(),
+        });
+    }
+    getLogFormat(logFormat) {
+        return winston_1.format.combine(winston_1.format.timestamp(), this.selectFormat(logFormat));
+    }
+    selectFormat(logFormat) {
+        switch (logFormat) {
+            case 'pretty':
+                return this.getPrettyFormat();
+            case 'json':
+                return this.getJsonFormat();
+            default:
+                return this.getJsonFormat();
+        }
+    }
+    getJsonFormat() {
+        return winston_1.format.combine((0, winston_1.format)(info => {
+            if (this.context) {
+                info.message = `[${this.context}] ${info.message}`;
+            }
+            return info;
+        })(), winston_1.format.json());
+    }
+    getPrettyFormat() {
+        return winston_1.format.combine(winston_1.format.colorize(), winston_1.format.printf(({ timestamp, level, message, error, ...meta }) => {
+            const contextStr = this.context ? `[${this.context}] ` : '';
+            let output = `${timestamp} ${level}: ${contextStr}${message}`;
+            if (error && typeof error === 'object' && 'name' in error && 'message' in error) {
+                output += `\n  Error: ${error.name}: ${error.message}`;
+                if (error.name === 'DomainException' && 'errorCode' in error) {
+                    output += `\n  Internal Code: ${error.errorCode}`;
+                }
+                if ('stack' in error && error.stack) {
+                    output += `\n  Stack: ${error.stack}`;
+                }
+            }
+            const metaKeys = Object.keys(meta).filter(key => key !== 'timestamp' && key !== 'level' && key !== 'message');
+            if (metaKeys.length > 0) {
+                output += `\n  Meta: ${JSON.stringify(meta, null, 2)}`;
+            }
+            return output;
+        }));
+    }
+    safeStringify(obj) {
+        try {
+            return JSON.stringify(obj, (key, value) => {
+                if (typeof value === 'bigint') {
+                    return value.toString();
+                }
+                return value;
+            });
+        }
+        catch (_error) {
+            return '[Object cannot be serialized]';
+        }
+    }
+    getTransports() {
+        return [new winston_1.transports.Console(), new winston_1.transports.File({ filename: 'logs/app.log' })];
+    }
+    log(message, { level = 'info', ...rest } = {}) {
+        switch (level) {
+            case 'error':
+                this.logger.error(message, rest);
+                break;
+            case 'warn':
+                this.logger.warn(message, rest);
+                break;
+            case 'debug':
+                this.logger.debug(message, rest);
+                break;
+            case 'verbose':
+                this.logger.verbose(message, rest);
+                break;
+            default:
+                this.logger.info(message, rest);
+                break;
+        }
+    }
+    error(message, ...optionalParams) {
+        if (optionalParams.length > 0 && optionalParams[0] instanceof Error) {
+            const error = optionalParams[0];
+            const errorData = {
+                name: error.name,
+                message: error.message,
+                stack: error.stack,
+            };
+            if (error instanceof domain_exception_1.DomainException) {
+                errorData.errorCode = error.errorCode;
+            }
+            this.logger.error(message, {
+                error: errorData,
+                ...optionalParams.slice(1),
+            });
+        }
+        else {
+            this.logger.error(message, ...optionalParams);
+        }
+    }
+    warn(message, ...optionalParams) {
+        this.logger.warn(message, ...optionalParams);
+    }
+    debug(message, ...optionalParams) {
+        this.logger.debug(message, ...optionalParams);
+    }
+    verbose(message, ...optionalParams) {
+        this.logger.verbose(message, ...optionalParams);
+    }
+}
+exports.Logger = Logger;

package/dist/common/logger/logger.module.d.ts

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

package/dist/common/logger/logger.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.module.d.ts","sourceRoot":"","sources":["../../../src/common/logger/logger.module.ts"],"names":[],"mappings":"AAGA,qBAGa,YAAY;CAAG"}

package/dist/common/logger/logger.module.js

@@ -0,0 +1,19 @@
+"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.LoggerModule = void 0;
+const common_1 = require("@nestjs/common");
+const config_1 = require("@nestjs/config");
+let LoggerModule = class LoggerModule {
+};
+exports.LoggerModule = LoggerModule;
+exports.LoggerModule = LoggerModule = __decorate([
+    (0, common_1.Module)({
+        imports: [config_1.ConfigModule],
+    })
+], LoggerModule);

package/dist/common/logger/logging.middleware.d.ts

@@ -0,0 +1,8 @@
+import { NestMiddleware } from '@nestjs/common';
+import { NextFunction, Request, Response } from 'express';
+export declare class LoggingMiddleware implements NestMiddleware {
+    private readonly logger;
+    constructor();
+    use(req: Request, res: Response, next: NextFunction): void;
+}
+//# sourceMappingURL=logging.middleware.d.ts.map

package/dist/common/logger/logging.middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logging.middleware.d.ts","sourceRoot":"","sources":["../../../src/common/logger/logging.middleware.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAM1D,qBACa,iBAAkB,YAAW,cAAc;IACtD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;;IAMhC,GAAG,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY;CAwBpD"}

package/dist/common/logger/logging.middleware.js

@@ -0,0 +1,44 @@
+"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 LoggingMiddleware_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LoggingMiddleware = void 0;
+const common_1 = require("@nestjs/common");
+const logger_1 = require("./logger");
+const BLOCKED_ENDPOINTS = ['/api/races/active'];
+let LoggingMiddleware = LoggingMiddleware_1 = class LoggingMiddleware {
+    constructor() {
+        this.logger = new logger_1.Logger(LoggingMiddleware_1.name);
+    }
+    use(req, res, next) {
+        const { method, originalUrl, body } = req;
+        const sanitizedBody = { ...body };
+        if (sanitizedBody.password) {
+            sanitizedBody.password = '***';
+        }
+        if (sanitizedBody.token) {
+            sanitizedBody.token = '***';
+        }
+        res.on('finish', () => {
+            const isBlockedEndpoint = BLOCKED_ENDPOINTS.some(endpoint => originalUrl.includes(endpoint));
+            const isSuccessfulRequest = res.statusCode < 400;
+            if (!(isBlockedEndpoint && isSuccessfulRequest)) {
+                this.logger.log(`Request: ${method} ${originalUrl} | Body: ${JSON.stringify(sanitizedBody)}`);
+            }
+        });
+        next();
+    }
+};
+exports.LoggingMiddleware = LoggingMiddleware;
+exports.LoggingMiddleware = LoggingMiddleware = LoggingMiddleware_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [])
+], LoggingMiddleware);

package/dist/common/metrics/database-metrics.service.d.ts

@@ -0,0 +1,8 @@
+import { MetricsPort } from './metrics.port';
+export declare class DatabaseMetricsService {
+    private readonly metricsPort;
+    constructor(metricsPort: MetricsPort);
+    updateConnectionPoolSize(poolType: string, state: 'active' | 'idle' | 'waiting', size: number): void;
+    trackConnectionError(errorType: string): void;
+}
+//# sourceMappingURL=database-metrics.service.d.ts.map

package/dist/common/metrics/database-metrics.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"database-metrics.service.d.ts","sourceRoot":"","sources":["../../../src/common/metrics/database-metrics.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAG3D,qBACa,sBAAsB;IAG/B,OAAO,CAAC,QAAQ,CAAC,WAAW;gBAAX,WAAW,EAAE,WAAW;IAG3C,wBAAwB,CACtB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,QAAQ,GAAG,MAAM,GAAG,SAAS,EACpC,IAAI,EAAE,MAAM,GACX,IAAI;IAUP,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;CAK9C"}

package/dist/common/metrics/database-metrics.service.js

@@ -0,0 +1,39 @@
+"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.DatabaseMetricsService = void 0;
+const metrics_port_1 = require("./metrics.port");
+const common_1 = require("@nestjs/common");
+let DatabaseMetricsService = class DatabaseMetricsService {
+    constructor(metricsPort) {
+        this.metricsPort = metricsPort;
+    }
+    updateConnectionPoolSize(poolType, state, size) {
+        this.metricsPort.getGauge('rgs_db_connection_pool_size').set({
+            pool_type: poolType,
+            state,
+        }, size);
+    }
+    trackConnectionError(errorType) {
+        this.metricsPort.getCounter('rgs_db_connection_errors_total').inc({
+            error_type: errorType,
+        });
+    }
+};
+exports.DatabaseMetricsService = DatabaseMetricsService;
+exports.DatabaseMetricsService = DatabaseMetricsService = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, common_1.Inject)(metrics_port_1.METRICS_PORT)),
+    __metadata("design:paramtypes", [Object])
+], DatabaseMetricsService);

package/dist/common/metrics/helpers/metrics.helpers.d.ts

@@ -0,0 +1,5 @@
+export declare function toMinorUnits(amount: number): number;
+export declare function getEventCountBucket(count: number): string;
+export declare function getStreamVersionBucket(version: number): string;
+export declare function sanitizeRoute(route: string): string;
+//# sourceMappingURL=metrics.helpers.d.ts.map

package/dist/common/metrics/helpers/metrics.helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.helpers.d.ts","sourceRoot":"","sources":["../../../../src/common/metrics/helpers/metrics.helpers.ts"],"names":[],"mappings":"AAAA,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAOzD;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAM9D;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAInD"}

package/dist/common/metrics/helpers/metrics.helpers.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toMinorUnits = toMinorUnits;
+exports.getEventCountBucket = getEventCountBucket;
+exports.getStreamVersionBucket = getStreamVersionBucket;
+exports.sanitizeRoute = sanitizeRoute;
+function toMinorUnits(amount) {
+    return Math.round(amount * 100);
+}
+function getEventCountBucket(count) {
+    if (count <= 5)
+        return '1-5';
+    if (count <= 10)
+        return '6-10';
+    if (count <= 25)
+        return '11-25';
+    if (count <= 50)
+        return '26-50';
+    if (count <= 100)
+        return '51-100';
+    return '100+';
+}
+function getStreamVersionBucket(version) {
+    if (version <= 10)
+        return '1-10';
+    if (version <= 50)
+        return '11-50';
+    if (version <= 100)
+        return '51-100';
+    if (version <= 500)
+        return '101-500';
+    return '500+';
+}
+function sanitizeRoute(route) {
+    return route
+        .replace(/\/[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}/gi, '/:id')
+        .replace(/\/\d+/g, '/:id');
+}

package/dist/common/metrics/metrics.module.d.ts

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

package/dist/common/metrics/metrics.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.module.d.ts","sourceRoot":"","sources":["../../../src/common/metrics/metrics.module.ts"],"names":[],"mappings":"AAWA,qBAoMa,aAAa;CAAG"}