@omnitronix/game-engine-sdk 1.0.4 → 2.0.2

package/dist/common/error-handling/internal-error-code.d.ts

@@ -1,67 +1,21 @@
+/**
+ * Error codes relevant to game engine services.
+ *
+ * Scoped to game-engine SDK concerns only.
+ * Platform-level codes (sessions, operators, jackpots, geo, etc.)
+ * belong in the RGS platform, not in individual engine services.
+ */
 export declare enum InternalErrorCode {
-    FORBIDDEN = "FORBIDDEN",
-    INTERNAL_SERVER_ERROR = "INTERNAL_SERVER_ERROR",
-    INSUFFICIENT_FUNDS = "INSUFFICIENT_FUNDS",
-    INVALID_CURRENCY_CODE = "INVALID_CURRENCY_CODE",
-    GAME_NOT_FOUND = "GAME_NOT_FOUND",
-    GAME_CONFIG_NOT_FOUND = "GAME_CONFIG_NOT_FOUND",
-    GAME_CONFIG_ALREADY_EXISTS_WITH_SAME_JURISDICTION_AND_RTP = "GAME_CONFIG_ALREADY_EXISTS_WITH_SAME_JURISDICTION_AND_RTP",
-    OPERATOR_GAME_NOT_FOUND = "OPERATOR_GAME_NOT_FOUND",
-    OPERATOR_GAME_ALREADY_ENABLED = "OPERATOR_GAME_ALREADY_ENABLED",
-    INVALID_GAME_CONFIG_DATA = "INVALID_GAME_CONFIG_DATA",
-    INVALID_GAME_UPDATE_DATA = "INVALID_GAME_UPDATE_DATA",
-    GAME_CODE_ALREADY_EXISTS = "GAME_CODE_ALREADY_EXISTS",
     GAME_ENGINE_ERROR = "GAME_ENGINE_ERROR",
-    GAME_OR_GAME_CONFIG_DISABLED = "GAME_OR_GAME_CONFIG_DISABLED",
     DEBUG_COMMANDS_DISABLED = "DEBUG_COMMANDS_DISABLED",
-    INVALID_SESSION = "INVALID_SESSION",
-    SESSION_NOT_FOUND = "SESSION_NOT_FOUND",
-    SESSION_NOT_ACTIVE = "SESSION_NOT_ACTIVE",
-    SESSION_MISMATCH = "SESSION_MISMATCH",
-    INVALID_STATE_TRANSITION = "INVALID_STATE_TRANSITION",
-    INVALID_BET_AMOUNT = "INVALID_BET_AMOUNT",
-    REALITY_CHECK_IN_PROGRESS = "REALITY_CHECK_IN_PROGRESS",
-    SESSION_TERMINATED = "SESSION_TERMINATED",
-    SESSION_CANNOT_BE_TERMINATED = "SESSION_CANNOT_BE_TERMINATED",
-    SESSION_AUTO_RESOLVE_FAILED = "SESSION_AUTO_RESOLVE_FAILED",
-    SESSION_ALREADY_EXISTS = "SESSION_ALREADY_EXISTS",
-    INCOMPATIBLE_GAMEPLAY_CONFIG = "INCOMPATIBLE_GAMEPLAY_CONFIG",
     UNKNOWN_COMMAND = "UNKNOWN_COMMAND",
-    MISSING_OPERATOR_CODE = "MISSING_OPERATOR_CODE",
-    INVALID_OPERATOR_CODE = "INVALID_OPERATOR_CODE",
-    OPERATOR_NOT_FOUND = "OPERATOR_NOT_FOUND",
-    OPERATOR_INACTIVE = "OPERATOR_INACTIVE",
-    COUNTRY_CODE_RESTRICTED = "COUNTRY_CODE_RESTRICTED",
+    INVALID_COMMAND = "INVALID_COMMAND",
+    INVALID_RNG_SEED = "INVALID_RNG_SEED",
+    INTERNAL_SERVER_ERROR = "INTERNAL_SERVER_ERROR",
+    FORBIDDEN = "FORBIDDEN",
     UNAUTHORIZED = "UNAUTHORIZED",
-    AUTH_VALIDATION_FAILED = "AUTH_VALIDATION_FAILED",
-    BALANCE_NOT_FOUND = "BALANCE_NOT_FOUND",
-    DEBIT_FAILED = "DEBIT_FAILED",
-    CREDIT_FAILED = "CREDIT_FAILED",
-    INVALID_AUTH_DATA = "INVALID_AUTH_DATA",
     VALIDATION_ERROR = "VALIDATION_ERROR",
-    JURISDICTION_CONFIG_ALREADY_EXISTS = "JURISDICTION_CONFIG_ALREADY_EXISTS",
-    JURISDICTION_CONFIG_NOT_FOUND = "JURISDICTION_CONFIG_NOT_FOUND",
-    OPERATOR_JURISDICTION_CONFIG_NOT_FOUND = "OPERATOR_JURISDICTION_CONFIG_NOT_FOUND",
-    GAME_ROUND_LOG_NOT_FOUND = "GAME_ROUND_LOG_NOT_FOUND",
-    COUNTRY_NOT_PERMITTED = "COUNTRY_NOT_PERMITTED",
-    GEO_VALIDATION_SERVICE_UNAVAILABLE = "GEO_VALIDATION_SERVICE_UNAVAILABLE",
-    RESOURCE_NOT_FOUND = "RESOURCE_NOT_FOUND",
-    FINANCIAL_TRANSACTION_NOT_FOUND = "FINANCIAL_TRANSACTION_NOT_FOUND",
-    HEALTH_CHECK_FAILED = "HEALTH_CHECK_FAILED",
-    JACKPOT_TYPE_NOT_FOUND = "JACKPOT_TYPE_NOT_FOUND",
-    JACKPOT_TIER_NOT_FOUND = "JACKPOT_TIER_NOT_FOUND",
-    JACKPOT_CONFIGURATION_NOT_FOUND = "JACKPOT_CONFIGURATION_NOT_FOUND",
-    JACKPOT_CONFIGURATION_IS_ACTIVE = "JACKPOT_CONFIGURATION_IS_ACTIVE",
-    JACKPOT_POOL_CONTRIBUTION_ALREADY_PROCESSED = "JACKPOT_POOL_CONTRIBUTION_ALREADY_PROCESSED",
-    JACKPOT_TYPE_DOES_NOT_SUPPORT_TIERS = "JACKPOT_TYPE_DOES_NOT_SUPPORT_TIERS",
-    RNG_SEED_NOT_FOUND = "RNG_SEED_NOT_FOUND",
-    RNG_SEED_MISMATCH = "RNG_SEED_MISMATCH",
-    MASTER_HASH_INVALID = "MASTER_HASH_INVALID",
-    REPLAY_OUTCOME_MISMATCH = "REPLAY_OUTCOME_MISMATCH",
-    CONCURRENT_MODIFICATION = "CONCURRENT_MODIFICATION",
-    ACCOUNT_LOCKED = "ACCOUNT_LOCKED",
-    DAILY_LIMIT_EXCEEDED = "DAILY_LIMIT_EXCEEDED",
-    INVALID_AMOUNT = "INVALID_AMOUNT",
-    SERVICE_UNAVAILABLE = "SERVICE_UNAVAILABLE"
+    SERVICE_UNAVAILABLE = "SERVICE_UNAVAILABLE",
+    HEALTH_CHECK_FAILED = "HEALTH_CHECK_FAILED"
 }
 //# sourceMappingURL=internal-error-code.d.ts.map

package/dist/common/error-handling/internal-error-code.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"internal-error-code.d.ts","sourceRoot":"","sources":["../../../src/common/error-handling/internal-error-code.ts"],"names":[],"mappings":"AAAA,oBAAY,iBAAiB;IAC3B,SAAS,cAAc;IACvB,qBAAqB,0BAA0B;IAC/C,kBAAkB,uBAAuB;IACzC,qBAAqB,0BAA0B;IAE/C,cAAc,mBAAmB;IACjC,qBAAqB,0BAA0B;IAC/C,yDAAyD,8DAA8D;IACvH,uBAAuB,4BAA4B;IACnD,6BAA6B,kCAAkC;IAC/D,wBAAwB,6BAA6B;IACrD,wBAAwB,6BAA6B;IACrD,wBAAwB,6BAA6B;IACrD,iBAAiB,sBAAsB;IACvC,4BAA4B,iCAAiC;IAC7D,uBAAuB,4BAA4B;IAEnD,eAAe,oBAAoB;IACnC,iBAAiB,sBAAsB;IACvC,kBAAkB,uBAAuB;IACzC,gBAAgB,qBAAqB;IACrC,wBAAwB,6BAA6B;IACrD,kBAAkB,uBAAuB;IACzC,yBAAyB,8BAA8B;IACvD,kBAAkB,uBAAuB;IACzC,4BAA4B,iCAAiC;IAC7D,2BAA2B,gCAAgC;IAC3D,sBAAsB,2BAA2B;IACjD,4BAA4B,iCAAiC;IAC7D,eAAe,oBAAoB;IAEnC,qBAAqB,0BAA0B;IAC/C,qBAAqB,0BAA0B;IAC/C,kBAAkB,uBAAuB;IACzC,iBAAiB,sBAAsB;IACvC,uBAAuB,4BAA4B;IACnD,YAAY,iBAAiB;IAC7B,sBAAsB,2BAA2B;IACjD,iBAAiB,sBAAsB;IACvC,YAAY,iBAAiB;IAC7B,aAAa,kBAAkB;IAC/B,iBAAiB,sBAAsB;IACvC,gBAAgB,qBAAqB;IACrC,kCAAkC,uCAAuC;IACzE,6BAA6B,kCAAkC;IAC/D,sCAAsC,2CAA2C;IAGjF,wBAAwB,6BAA6B;IAErD,qBAAqB,0BAA0B;IAC/C,kCAAkC,uCAAuC;IACzE,kBAAkB,uBAAuB;IAGzC,+BAA+B,oCAAoC;IAGnE,mBAAmB,wBAAwB;IAG3C,sBAAsB,2BAA2B;IACjD,sBAAsB,2BAA2B;IACjD,+BAA+B,oCAAoC;IACnE,+BAA+B,oCAAoC;IACnE,2CAA2C,gDAAgD;IAC3F,mCAAmC,wCAAwC;IAG3E,kBAAkB,uBAAuB;IACzC,iBAAiB,sBAAsB;IACvC,mBAAmB,wBAAwB;IAC3C,uBAAuB,4BAA4B;IAEnD,uBAAuB,4BAA4B;IAEnD,cAAc,mBAAmB;IACjC,oBAAoB,yBAAyB;IAC7C,cAAc,mBAAmB;IACjC,mBAAmB,wBAAwB;CAC5C"}
+{"version":3,"file":"internal-error-code.d.ts","sourceRoot":"","sources":["../../../src/common/error-handling/internal-error-code.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,oBAAY,iBAAiB;IAE3B,iBAAiB,sBAAsB;IACvC,uBAAuB,4BAA4B;IACnD,eAAe,oBAAoB;IACnC,eAAe,oBAAoB;IAGnC,gBAAgB,qBAAqB;IAGrC,qBAAqB,0BAA0B;IAC/C,SAAS,cAAc;IACvB,YAAY,iBAAiB;IAC7B,gBAAgB,qBAAqB;IACrC,mBAAmB,wBAAwB;IAG3C,mBAAmB,wBAAwB;CAC5C"}

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

@@ -1,80 +1,28 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.InternalErrorCode = void 0;
+/**
+ * Error codes relevant to game engine services.
+ *
+ * Scoped to game-engine SDK concerns only.
+ * Platform-level codes (sessions, operators, jackpots, geo, etc.)
+ * belong in the RGS platform, not in individual engine services.
+ */
 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";
+    // Core game engine errors
     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["INVALID_COMMAND"] = "INVALID_COMMAND";
+    // RNG integrity (GLI-19)
+    InternalErrorCode["INVALID_RNG_SEED"] = "INVALID_RNG_SEED";
+    // Infrastructure errors
+    InternalErrorCode["INTERNAL_SERVER_ERROR"] = "INTERNAL_SERVER_ERROR";
+    InternalErrorCode["FORBIDDEN"] = "FORBIDDEN";
     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";
+    // Health check
+    InternalErrorCode["HEALTH_CHECK_FAILED"] = "HEALTH_CHECK_FAILED";
 })(InternalErrorCode || (exports.InternalErrorCode = InternalErrorCode = {}));

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

@@ -10,11 +10,10 @@ export declare class Logger implements NestLoggerService {
     private selectFormat;
     private getJsonFormat;
     private getPrettyFormat;
-    private safeStringify;
     private getTransports;
-    log(message: any, { level, ...rest }?: {
+    log(message: string, { level, ...rest }?: {
         level?: string;
-    } & Record<string, any>): void;
+    } & Record<string, unknown>): void;
     error(message: any, ...optionalParams: any[]): void;
     warn(message: any, ...optionalParams: any[]): void;
     debug(message: any, ...optionalParams: any[]): void;

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

@@ -1 +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;IAUrB,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"}
+{"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;IAUrB,GAAG,CACD,OAAO,EAAE,MAAM,EACf,EAAE,KAAc,EAAE,GAAG,IAAI,EAAE,GAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM;IAqBhF,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

@@ -69,25 +69,12 @@ class Logger {
             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() {
-        const logTransports = [new winston_1.transports.Console()];
+        const consoleTransport = new winston_1.transports.Console();
         if (process.env.LOG_TO_FILE === 'true') {
-            logTransports.push(new winston_1.transports.File({ filename: 'logs/app.log' }));
+            return [consoleTransport, new winston_1.transports.File({ filename: 'logs/app.log' })];
         }
-        return logTransports;
+        return [consoleTransport];
     }
     log(message, { level = 'info', ...rest } = {}) {
         switch (level) {

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

@@ -1 +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;AA4B1D,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;CAkBpD"}
+{"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;AAwC1D,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;CAkBpD"}

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

@@ -13,11 +13,23 @@ 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'];
+/** Endpoints to suppress from logging on success. Configurable via LOG_BLOCKED_ENDPOINTS env var (comma-separated). */
+const BLOCKED_ENDPOINTS = process.env.LOG_BLOCKED_ENDPOINTS
+    ? process.env.LOG_BLOCKED_ENDPOINTS.split(',').map(e => e.trim())
+    : [];
 const SENSITIVE_FIELDS = new Set([
-    'password', 'token', 'secret', 'authorization',
-    'apikey', 'api_key', 'accesstoken', 'refreshtoken',
-    'creditcard', 'ssn', 'private_key', 'privatekey',
+    'password',
+    'token',
+    'secret',
+    'authorization',
+    'apikey',
+    'api_key',
+    'accesstoken',
+    'refreshtoken',
+    'creditcard',
+    'ssn',
+    'private_key',
+    'privatekey',
 ]);
 function sanitize(obj) {
     if (obj === null || obj === undefined || typeof obj !== 'object')

package/dist/common/metrics/prometheus.service.d.ts

@@ -20,6 +20,11 @@ export declare class PrometheusService implements MetricsPort {
     getCounter(name: string): Counter;
     getGauge(name: string): Gauge;
     getHistogram(name: string): Histogram;
+    /**
+     * Returns Prometheus text format metrics from the default prom-client registry.
+     * The @willsoto/nestjs-prometheus module also exposes a /metrics HTTP endpoint
+     * automatically — this method is for programmatic access via the MetricsPort.
+     */
     getMetrics(): Promise<string>;
 }
 //# sourceMappingURL=prometheus.service.d.ts.map

package/dist/common/metrics/prometheus.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prometheus.service.d.ts","sourceRoot":"","sources":["../../../src/common/metrics/prometheus.service.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,OAAO,IAAI,WAAW,EACtB,KAAK,IAAI,SAAS,EAClB,SAAS,IAAI,aAAa,EAC3B,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAExE,qBACa,iBAAkB,YAAW,WAAW;IAKjD,OAAO,CAAC,QAAQ,CAAC,mBAAmB;IAEpC,OAAO,CAAC,QAAQ,CAAC,iBAAiB;IAElC,OAAO,CAAC,QAAQ,CAAC,mBAAmB;IAEpC,OAAO,CAAC,QAAQ,CAAC,qBAAqB;IAEtC,OAAO,CAAC,QAAQ,CAAC,iBAAiB;IAElC,OAAO,CAAC,QAAQ,CAAC,kBAAkB;IAEnC,OAAO,CAAC,QAAQ,CAAC,kBAAkB;IAEnC,OAAO,CAAC,QAAQ,CAAC,4BAA4B;IAE7C,OAAO,CAAC,QAAQ,CAAC,4BAA4B;IAE7C,OAAO,CAAC,QAAQ,CAAC,uBAAuB;IAExC,OAAO,CAAC,QAAQ,CAAC,8BAA8B;IAE/C,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IA1BnC,OAAO,CAAC,eAAe,CAAmE;gBAIvE,mBAAmB,EAAE,WAAW,EAEhC,iBAAiB,EAAE,WAAW,EAE9B,mBAAmB,EAAE,WAAW,EAEhC,qBAAqB,EAAE,aAAa,EAEpC,iBAAiB,EAAE,SAAS,EAE5B,kBAAkB,EAAE,SAAS,EAE7B,kBAAkB,EAAE,SAAS,EAE7B,4BAA4B,EAAE,WAAW,EAEzC,4BAA4B,EAAE,WAAW,EAEzC,uBAAuB,EAAE,aAAa,EAEtC,8BAA8B,EAAE,WAAW,EAE3C,gBAAgB,EAAE,aAAa;IAKlD,6BAA6B,IAAI,OAAO,CAAC,IAAI,CAAC;IAI9C,OAAO,CAAC,kBAAkB;IAkB1B,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAQjC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK;IAQ7B,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS;IAQ/B,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;CAGpC"}
+{"version":3,"file":"prometheus.service.d.ts","sourceRoot":"","sources":["../../../src/common/metrics/prometheus.service.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,OAAO,IAAI,WAAW,EACtB,KAAK,IAAI,SAAS,EAClB,SAAS,IAAI,aAAa,EAC3B,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAExE,qBACa,iBAAkB,YAAW,WAAW;IAKjD,OAAO,CAAC,QAAQ,CAAC,mBAAmB;IAEpC,OAAO,CAAC,QAAQ,CAAC,iBAAiB;IAElC,OAAO,CAAC,QAAQ,CAAC,mBAAmB;IAEpC,OAAO,CAAC,QAAQ,CAAC,qBAAqB;IAEtC,OAAO,CAAC,QAAQ,CAAC,iBAAiB;IAElC,OAAO,CAAC,QAAQ,CAAC,kBAAkB;IAEnC,OAAO,CAAC,QAAQ,CAAC,kBAAkB;IAEnC,OAAO,CAAC,QAAQ,CAAC,4BAA4B;IAE7C,OAAO,CAAC,QAAQ,CAAC,4BAA4B;IAE7C,OAAO,CAAC,QAAQ,CAAC,uBAAuB;IAExC,OAAO,CAAC,QAAQ,CAAC,8BAA8B;IAE/C,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IA1BnC,OAAO,CAAC,eAAe,CAAmE;gBAIvE,mBAAmB,EAAE,WAAW,EAEhC,iBAAiB,EAAE,WAAW,EAE9B,mBAAmB,EAAE,WAAW,EAEhC,qBAAqB,EAAE,aAAa,EAEpC,iBAAiB,EAAE,SAAS,EAE5B,kBAAkB,EAAE,SAAS,EAE7B,kBAAkB,EAAE,SAAS,EAE7B,4BAA4B,EAAE,WAAW,EAEzC,4BAA4B,EAAE,WAAW,EAEzC,uBAAuB,EAAE,aAAa,EAEtC,8BAA8B,EAAE,WAAW,EAE3C,gBAAgB,EAAE,aAAa;IAK5C,6BAA6B,IAAI,OAAO,CAAC,IAAI,CAAC;IAKpD,OAAO,CAAC,kBAAkB;IAkB1B,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAQjC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK;IAQ7B,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS;IAQrC;;;;OAIG;IACG,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;CAIpC"}

package/dist/common/metrics/prometheus.service.js

@@ -1,10 +1,43 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
 var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
     var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
     if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
     else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
     return c > 3 && r && Object.defineProperty(target, key, r), r;
 };
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 var __metadata = (this && this.__metadata) || function (k, v) {
     if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 };
@@ -33,8 +66,9 @@ let PrometheusService = class PrometheusService {
         this.metricsRegistry = new Map();
         this.initializeRegistry();
     }
-    initializeMetricsFromDatabase() {
-        throw new Error('Method not implemented.');
+    async initializeMetricsFromDatabase() {
+        // No-op: Game engine metrics are initialized from Prometheus registry, not database.
+        // Override in subclass if database-backed metric initialization is needed.
     }
     initializeRegistry() {
         this.metricsRegistry.set('game_engine_commands_total', this.engineCommandsTotal);
@@ -71,8 +105,14 @@ let PrometheusService = class PrometheusService {
         }
         return metric;
     }
+    /**
+     * Returns Prometheus text format metrics from the default prom-client registry.
+     * The @willsoto/nestjs-prometheus module also exposes a /metrics HTTP endpoint
+     * automatically — this method is for programmatic access via the MetricsPort.
+     */
     async getMetrics() {
-        return '';
+        const { register } = await Promise.resolve().then(() => __importStar(require('prom-client')));
+        return register.metrics();
     }
 };
 exports.PrometheusService = PrometheusService;

package/dist/common/retry/retry-policy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"retry-policy.d.ts","sourceRoot":"","sources":["../../../src/common/retry/retry-policy.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IAClD,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgC;IACvD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;IAC3C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAW;IAC5C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAA0C;IACnE,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAS;gBAE5B,OAAO,EAAE,YAAY;IAUpB,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IA4CzD,OAAO,CAAC,WAAW;IASnB,OAAO,CAAC,cAAc;YAMR,KAAK;CAGpB"}
+{"version":3,"file":"retry-policy.d.ts","sourceRoot":"","sources":["../../../src/common/retry/retry-policy.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IAClD,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgC;IACvD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;IAC3C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAW;IAC5C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAA0C;IACnE,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAS;gBAE5B,OAAO,EAAE,YAAY;IAUpB,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAgDzD,OAAO,CAAC,WAAW;IAUnB,OAAO,CAAC,cAAc;YAMR,KAAK;CAGpB"}

package/dist/common/retry/retry-policy.js

@@ -24,7 +24,7 @@ class RetryPolicy {
                 return result;
             }
             catch (error) {
-                const err = error;
+                const err = error instanceof Error ? error : new Error(String(error));
                 lastError = err;
                 if (!this.isRetryable(err)) {
                     throw err;
@@ -39,7 +39,9 @@ class RetryPolicy {
                     try {
                         this.onRetry(attempt, err);
                     }
-                    catch { }
+                    catch (callbackError) {
+                        this.logger.debug(`onRetry callback threw: ${callbackError instanceof Error ? callbackError.message : String(callbackError)}`);
+                    }
                 }
                 await this.sleep(delay);
             }
@@ -49,8 +51,11 @@ class RetryPolicy {
     isRetryable(error) {
         if (!this.retryableErrors || this.retryableErrors.length === 0)
             return true;
-        const causeCode = error?.cause?.code ?? '';
-        const text = `${error?.code ?? ''} ${error?.name ?? ''} ${error.message} ${causeCode}`;
+        const errorRecord = error;
+        const cause = errorRecord.cause;
+        const causeCode = typeof cause?.code === 'string' ? cause.code : '';
+        const errorCode = typeof errorRecord.code === 'string' ? errorRecord.code : '';
+        const text = `${errorCode} ${error.name} ${error.message} ${causeCode}`;
         return this.retryableErrors.some(pattern => text.includes(pattern));
     }
     calculateDelay(attempt) {

package/dist/common/secrets-provider/secrets-provider.aws.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"secrets-provider.aws.d.ts","sourceRoot":"","sources":["../../../src/common/secrets-provider/secrets-provider.aws.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAG/C,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD,qBACa,kBAAmB,YAAW,eAAe;IAKrB,OAAO,CAAC,QAAQ,CAAC,aAAa;IAJjE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuC;IAC9D,OAAO,CAAC,YAAY,CAAkC;IACtD,OAAO,CAAC,cAAc,CAAiB;gBAEa,aAAa,EAAE,aAAa;IAM1E,QAAQ;YAIA,WAAW;IAiCnB,GAAG,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAO/C"}
+{"version":3,"file":"secrets-provider.aws.d.ts","sourceRoot":"","sources":["../../../src/common/secrets-provider/secrets-provider.aws.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAG/C,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD,qBACa,kBAAmB,YAAW,eAAe;IAKrB,OAAO,CAAC,QAAQ,CAAC,aAAa;IAJjE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuC;IAC9D,OAAO,CAAC,YAAY,CAAkC;IACtD,OAAO,CAAC,cAAc,CAAiB;gBAEa,aAAa,EAAE,aAAa;IAM1E,QAAQ;YAIA,WAAW;IAkCnB,GAAG,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAO/C"}

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

@@ -53,7 +53,8 @@ let AwsSecretsProvider = AwsSecretsProvider_1 = class AwsSecretsProvider {
             this.logger.log(`Successfully loaded secrets from AWS Secrets Manager.`);
         }
         catch (error) {
-            this.logger.error(`Failed to retrieve secrets from AWS: ${error.message}`);
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            this.logger.error(`Failed to retrieve secrets from AWS: ${errorMessage}`);
             throw error;
         }
     }

package/dist/esm/bootstrap/index.js

@@ -5,22 +5,24 @@ import { setupDocumentation } from '../common/api-docs/setup-documentation';
 import { SHUTDOWN_OUT_PORT, } from '../health/application/ports/out/shutdown.out-port';
 import { GameEngineGrpcInAdapter } from '../grpc/game-engine.grpc.in-adapter';
 import { createConnectRouter } from '../grpc/connect-router.middleware';
-import { BadRequestException, RequestMethod, ValidationPipe } from '@nestjs/common';
+import { BadRequestException, RequestMethod, ValidationPipe, } from '@nestjs/common';
 import { ConfigService } from '@nestjs/config';
 import { NestFactory } from '@nestjs/core';
 import * as http2 from 'http2';
+/** Type guard for NestJS dynamic modules with a static `register` method. */
+function hasRegisterMethod(module) {
+    return 'register' in module && typeof module.register === 'function';
+}
 /**
  * Creates and bootstraps a game engine NestJS application with
  * standard configuration: CORS, validation pipes, exception filters,
  * Swagger docs, Connect RPC gRPC server, and graceful shutdown.
  */
 export async function createGameEngineApp(options) {
-    const { serviceName, appModule, bootstrapOptions, corsOrigins = false } = options;
+    const { serviceName, appModule, bootstrapOptions, corsOrigins = false, additionalRoutes, } = options;
     const logger = new Logger(serviceName);
-    const moduleArg = bootstrapOptions
-        ? appModule.register
-            ? appModule.register(bootstrapOptions)
-            : appModule
+    const moduleArg = bootstrapOptions && hasRegisterMethod(appModule)
+        ? appModule.register(bootstrapOptions)
         : appModule;
     const app = await NestFactory.create(moduleArg, {
         logger: logger,
@@ -30,42 +32,33 @@ export async function createGameEngineApp(options) {
     }
     const configService = app.get(ConfigService);
     const shutdownService = app.get(SHUTDOWN_OUT_PORT);
-    let isShuttingDown = false;
+    // Fatal error handler uses ShutdownOutPort's guard to prevent duplicate shutdowns.
+    // No separate local flag — single source of truth avoids desync.
     const handleFatalError = async (errorType, error) => {
-        logger.error(`${errorType}:`, {
-            error: error.message,
-            stack: error.stack,
-        });
-        if (isShuttingDown) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        const errorStack = error instanceof Error ? error.stack : undefined;
+        logger.error(`${errorType}:`, { error: errorMessage, stack: errorStack });
+        if (shutdownService.isShuttingDown()) {
             logger.warn('Shutdown already in progress, ignoring additional error');
             return;
         }
-        isShuttingDown = true;
         try {
             logger.warn(`Initiating graceful shutdown due to ${errorType}...`);
             await shutdownService.startGracefulShutdown();
             logger.log('Graceful shutdown completed, exiting process');
         }
         catch (shutdownError) {
-            logger.error('Error during graceful shutdown:', shutdownError);
+            const shutdownMsg = shutdownError instanceof Error ? shutdownError.message : String(shutdownError);
+            logger.error(`Error during graceful shutdown: ${shutdownMsg}`);
         }
         finally {
             process.exit(1);
         }
     };
     process.on('uncaughtException', (error) => {
-        logger.error('Uncaught Exception:', {
-            error: error.message,
-            stack: error.stack,
-        });
         void handleFatalError('uncaughtException', error);
     });
-    process.on('unhandledRejection', (reason, promise) => {
-        logger.error('Unhandled Rejection:', {
-            reason: reason.message,
-            stack: reason.stack,
-            promise,
-        });
+    process.on('unhandledRejection', (reason) => {
         void handleFatalError('unhandledRejection', reason);
     });
     app.setGlobalPrefix('api', {
@@ -91,11 +84,11 @@ export async function createGameEngineApp(options) {
         },
     }));
     app.useGlobalFilters(app.get(ExceptionsFilter));
-    const PORT = configService.get('PORT') || 3000;
+    const PORT = configService.get('PORT') ?? 3000;
     await setupDocumentation(app, PORT, serviceName);
     // Setup Connect RPC server
     const gameEngineAdapter = app.get(GameEngineGrpcInAdapter);
-    const connectRouter = createConnectRouter(gameEngineAdapter);
+    const connectRouter = createConnectRouter(gameEngineAdapter, { additionalRoutes });
     // Mount Connect router on /connect path
     app.use('/connect', connectRouter);
     app.enableShutdownHooks(['SIGTERM', 'SIGINT']);
@@ -108,14 +101,21 @@ export async function createGameEngineApp(options) {
     h2cServer.listen(GRPC_PORT, '0.0.0.0', () => {
         logger.log(`Connect RPC (h2c) is available on: http://localhost:${GRPC_PORT}`);
     });
-    // Close h2c server during graceful shutdown
-    const closeH2c = () => {
-        h2cServer.close(() => {
-            logger.log('h2c gRPC server closed');
+    // Register h2c server closure with graceful shutdown service
+    shutdownService.registerCleanupCallback('h2c-grpc-server', () => {
+        return new Promise((resolve, reject) => {
+            h2cServer.close(err => {
+                if (err) {
+                    logger.error('Error closing h2c gRPC server:', err);
+                    reject(err);
+                }
+                else {
+                    logger.log('h2c gRPC server closed');
+                    resolve();
+                }
+            });
         });
-    };
-    process.on('SIGTERM', closeH2c);
-    process.on('SIGINT', closeH2c);
+    });
     await app.listen(PORT, '0.0.0.0');
     logger.log(`Application is running on: http://localhost:${PORT}`);
     return app;