@levrbet/shared 0.3.41 → 0.4.1

package/dist/core/config/urls.js

@@ -33,7 +33,7 @@ exports.allUrls = {
         leaderboard: "https://leaderboard.dev.levr.bet",
         indexers: {
             [types_1.LevrChain.MONAD_TESTNET]: [
-                { type: indexers_types_1.LevrIndexer.ENVIO, url: "https://indexer.dev.hyperindex.xyz/e8beeeb/v1/graphql" },
+                { type: indexers_types_1.LevrIndexer.ENVIO, url: "https://indexer.dev.hyperindex.xyz/79ae9a8/v1/graphql" },
                 { type: indexers_types_1.LevrIndexer.SUBSQUID, url: "https://levrbet.squids.live/v1-levr-dev@v3/api/graphql" },
             ],
         },

package/dist/server/index.d.ts

@@ -4,6 +4,7 @@ export * from "./contracts";
 export * from "./liquidation-engine";
 export * from "./middleware";
 export * from "./oracle";
+export * from "./redis";
 export * from "./repositories";
 export * from "./services";
 export * from "./types";

package/dist/server/index.js

@@ -26,6 +26,7 @@ __exportStar(require("./contracts"), exports);
 __exportStar(require("./liquidation-engine"), exports);
 __exportStar(require("./middleware"), exports);
 __exportStar(require("./oracle"), exports);
+__exportStar(require("./redis"), exports);
 __exportStar(require("./repositories"), exports);
 __exportStar(require("./services"), exports);
 __exportStar(require("./types"), exports);

package/dist/server/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,iFAAiF;AACjF,IAAI,OAAQ,UAAkB,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;IACpD,MAAM,IAAI,KAAK,CACX,0EAA0E;QACtE,0GAA0G;QAC1G,kFAAkF,CACzF,CAAA;AACL,CAAC;AAED,0CAAuB;AACvB,2CAAwB;AACxB,8CAA2B;AAC3B,uDAAoC;AACpC,+CAA4B;AAC5B,2CAAwB;AACxB,iDAA8B;AAC9B,6CAA0B;AAC1B,0CAAuB;AACvB,0CAAuB;AAEvB,0CAA0C;AAC1C,6DAA6D"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,iFAAiF;AACjF,IAAI,OAAQ,UAAkB,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;IACpD,MAAM,IAAI,KAAK,CACX,0EAA0E;QACtE,0GAA0G;QAC1G,kFAAkF,CACzF,CAAA;AACL,CAAC;AAED,0CAAuB;AACvB,2CAAwB;AACxB,8CAA2B;AAC3B,uDAAoC;AACpC,+CAA4B;AAC5B,2CAAwB;AACxB,0CAAuB;AACvB,iDAA8B;AAC9B,6CAA0B;AAC1B,0CAAuB;AACvB,0CAAuB;AAEvB,0CAA0C;AAC1C,6DAA6D"}

package/dist/server/redis/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Redis Module
+ *
+ * Redis-related utilities, keys, and service interfaces.
+ */
+export * from "./queue-management";

package/dist/server/redis/index.js

@@ -0,0 +1,23 @@
+"use strict";
+/**
+ * Redis Module
+ *
+ * Redis-related utilities, keys, and service interfaces.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./queue-management"), exports);
+//# sourceMappingURL=index.js.map

package/dist/server/redis/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/server/redis/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;;;;;;;;;;;;;;AAEH,qDAAkC"}

package/dist/server/redis/queue-management/constants.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Queue Management Configuration Constants
+ *
+ * Configuration values and thresholds for the Queue Management System.
+ */
+export declare const QUEUE_MANAGEMENT_CONFIG: {
+    /**
+     * TTLs in seconds for various Redis keys
+     */
+    readonly TTL: {
+        /** DLQ stats cache refresh interval */
+        readonly DLQ_STATS_CACHE: 60;
+        /** Escalation history retention */
+        readonly ESCALATION_HISTORY: 604800;
+        /** DLQ alert debounce period */
+        readonly DLQ_ALERT_DEBOUNCE: 3600;
+    };
+    /**
+     * Circuit breaker configuration
+     */
+    readonly CIRCUIT_BREAKER: {
+        /** Number of consecutive failures before opening circuit */
+        readonly FAILURE_THRESHOLD: 3;
+        /** Initial backoff duration in milliseconds */
+        readonly INITIAL_BACKOFF_MS: 30000;
+        /** Maximum backoff duration in milliseconds */
+        readonly MAX_BACKOFF_MS: 600000;
+        /** Multiplier for exponential backoff */
+        readonly BACKOFF_MULTIPLIER: 2;
+    };
+    /**
+     * DLQ thresholds for auto-escalation
+     */
+    readonly DLQ_THRESHOLDS: {
+        /** Message count to trigger WARNING escalation */
+        readonly WARNING: 50;
+        /** Message count to trigger CRITICAL escalation */
+        readonly CRITICAL: 100;
+    };
+    /**
+     * Escalation history retention
+     */
+    readonly ESCALATION_HISTORY_MAX: 1000;
+};
+/**
+ * Redis key patterns for documentation purposes
+ * (Not used in runtime, just for reference)
+ */
+export declare const KEY_PATTERNS: {
+    readonly QUEUE_PAUSE_GLOBAL: "queue:pause:global";
+    readonly QUEUE_PAUSE_TYPE: "queue:pause:type:{type}";
+    readonly QUEUE_PAUSE_QUEUE: "queue:pause:queue:{queueName}";
+    readonly QUEUE_PAUSE_ACTIVE: "queue:pause:active";
+    readonly QUEUE_ESCALATION: "queue:escalation:{queueName}";
+    readonly QUEUE_ESCALATION_HISTORY: "queue:escalation:history:{queueName}";
+    readonly QUEUE_ESCALATION_ACTIVE: "queue:escalation:active";
+    readonly CIRCUIT_BREAKER_STATE: "circuit_breaker:{queueName}";
+    readonly CIRCUIT_BREAKER_OPEN: "circuit_breaker:open";
+    readonly DLQ_STATS: "dlq:stats:{dlqName}";
+    readonly DLQ_REPROCESS_COUNT: "dlq:reprocessed:{dlqName}";
+    readonly DLQ_ALERT_SENT: "dlq:alert:{dlqName}:{alertType}";
+};

package/dist/server/redis/queue-management/constants.js

@@ -0,0 +1,70 @@
+"use strict";
+/**
+ * Queue Management Configuration Constants
+ *
+ * Configuration values and thresholds for the Queue Management System.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KEY_PATTERNS = exports.QUEUE_MANAGEMENT_CONFIG = void 0;
+exports.QUEUE_MANAGEMENT_CONFIG = {
+    /**
+     * TTLs in seconds for various Redis keys
+     */
+    TTL: {
+        /** DLQ stats cache refresh interval */
+        DLQ_STATS_CACHE: 60, // 1 minute
+        /** Escalation history retention */
+        ESCALATION_HISTORY: 604800, // 7 days
+        /** DLQ alert debounce period */
+        DLQ_ALERT_DEBOUNCE: 3600, // 1 hour
+    },
+    /**
+     * Circuit breaker configuration
+     */
+    CIRCUIT_BREAKER: {
+        /** Number of consecutive failures before opening circuit */
+        FAILURE_THRESHOLD: 3,
+        /** Initial backoff duration in milliseconds */
+        INITIAL_BACKOFF_MS: 30000, // 30 seconds
+        /** Maximum backoff duration in milliseconds */
+        MAX_BACKOFF_MS: 600000, // 10 minutes
+        /** Multiplier for exponential backoff */
+        BACKOFF_MULTIPLIER: 2,
+    },
+    /**
+     * DLQ thresholds for auto-escalation
+     */
+    DLQ_THRESHOLDS: {
+        /** Message count to trigger WARNING escalation */
+        WARNING: 50,
+        /** Message count to trigger CRITICAL escalation */
+        CRITICAL: 100,
+    },
+    /**
+     * Escalation history retention
+     */
+    ESCALATION_HISTORY_MAX: 1000,
+};
+/**
+ * Redis key patterns for documentation purposes
+ * (Not used in runtime, just for reference)
+ */
+exports.KEY_PATTERNS = {
+    // Operational pause keys (NEW)
+    QUEUE_PAUSE_GLOBAL: "queue:pause:global",
+    QUEUE_PAUSE_TYPE: "queue:pause:type:{type}",
+    QUEUE_PAUSE_QUEUE: "queue:pause:queue:{queueName}",
+    QUEUE_PAUSE_ACTIVE: "queue:pause:active",
+    // Escalation keys
+    QUEUE_ESCALATION: "queue:escalation:{queueName}",
+    QUEUE_ESCALATION_HISTORY: "queue:escalation:history:{queueName}",
+    QUEUE_ESCALATION_ACTIVE: "queue:escalation:active",
+    // Circuit breaker keys
+    CIRCUIT_BREAKER_STATE: "circuit_breaker:{queueName}",
+    CIRCUIT_BREAKER_OPEN: "circuit_breaker:open",
+    // DLQ keys
+    DLQ_STATS: "dlq:stats:{dlqName}",
+    DLQ_REPROCESS_COUNT: "dlq:reprocessed:{dlqName}",
+    DLQ_ALERT_SENT: "dlq:alert:{dlqName}:{alertType}",
+};
+//# sourceMappingURL=constants.js.map

package/dist/server/redis/queue-management/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../src/server/redis/queue-management/constants.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEU,QAAA,uBAAuB,GAAG;IACnC;;OAEG;IACH,GAAG,EAAE;QACD,uCAAuC;QACvC,eAAe,EAAE,EAAE,EAAE,WAAW;QAEhC,mCAAmC;QACnC,kBAAkB,EAAE,MAAM,EAAE,SAAS;QAErC,gCAAgC;QAChC,kBAAkB,EAAE,IAAI,EAAE,SAAS;KACtC;IAED;;OAEG;IACH,eAAe,EAAE;QACb,4DAA4D;QAC5D,iBAAiB,EAAE,CAAC;QAEpB,+CAA+C;QAC/C,kBAAkB,EAAE,KAAK,EAAE,aAAa;QAExC,+CAA+C;QAC/C,cAAc,EAAE,MAAM,EAAE,aAAa;QAErC,yCAAyC;QACzC,kBAAkB,EAAE,CAAC;KACxB;IAED;;OAEG;IACH,cAAc,EAAE;QACZ,kDAAkD;QAClD,OAAO,EAAE,EAAE;QAEX,mDAAmD;QACnD,QAAQ,EAAE,GAAG;KAChB;IAED;;OAEG;IACH,sBAAsB,EAAE,IAAI;CACtB,CAAA;AAEV;;;GAGG;AACU,QAAA,YAAY,GAAG;IACxB,+BAA+B;IAC/B,kBAAkB,EAAE,oBAAoB;IACxC,gBAAgB,EAAE,yBAAyB;IAC3C,iBAAiB,EAAE,+BAA+B;IAClD,kBAAkB,EAAE,oBAAoB;IAExC,kBAAkB;IAClB,gBAAgB,EAAE,8BAA8B;IAChD,wBAAwB,EAAE,sCAAsC;IAChE,uBAAuB,EAAE,yBAAyB;IAElD,uBAAuB;IACvB,qBAAqB,EAAE,6BAA6B;IACpD,oBAAoB,EAAE,sBAAsB;IAE5C,WAAW;IACX,SAAS,EAAE,qBAAqB;IAChC,mBAAmB,EAAE,2BAA2B;IAChD,cAAc,EAAE,iCAAiC;CAC3C,CAAA"}

package/dist/server/redis/queue-management/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Queue Management Redis Module
+ *
+ * Provides Redis keys, types, and constants for the Queue Management System.
+ * Used by oracle/core, oracle/processors, liquidation-engine, and other services.
+ *
+ * @example
+ * ```typescript
+ * import { QueueManagementKeys, EscalationLevel } from '@levrbet/shared/server'
+ *
+ * // Get key for global pause
+ * const key = QueueManagementKeys.pause.global()
+ *
+ * // Get key for specific queue pause
+ * const queueKey = QueueManagementKeys.pause.queue('mkt.abc.xyz')
+ * ```
+ */
+export { QueueManagementKeys } from "./keys";
+export { CircuitState, EscalationLevel, type CircuitBreakerState, type DLQStats, type EscalationHistoryEntry, type EscalationState, type GlobalPauseState, type OperationalPauseState, type PauseCheckResult, type QueueContext, type QueuePauseState, type QueueType, type TypePauseState, } from "./types";
+export { KEY_PATTERNS, QUEUE_MANAGEMENT_CONFIG } from "./constants";

package/dist/server/redis/queue-management/index.js

@@ -0,0 +1,32 @@
+"use strict";
+/**
+ * Queue Management Redis Module
+ *
+ * Provides Redis keys, types, and constants for the Queue Management System.
+ * Used by oracle/core, oracle/processors, liquidation-engine, and other services.
+ *
+ * @example
+ * ```typescript
+ * import { QueueManagementKeys, EscalationLevel } from '@levrbet/shared/server'
+ *
+ * // Get key for global pause
+ * const key = QueueManagementKeys.pause.global()
+ *
+ * // Get key for specific queue pause
+ * const queueKey = QueueManagementKeys.pause.queue('mkt.abc.xyz')
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.QUEUE_MANAGEMENT_CONFIG = exports.KEY_PATTERNS = exports.EscalationLevel = exports.CircuitState = exports.QueueManagementKeys = void 0;
+// Key builders
+var keys_1 = require("./keys");
+Object.defineProperty(exports, "QueueManagementKeys", { enumerable: true, get: function () { return keys_1.QueueManagementKeys; } });
+// Types and enums
+var types_1 = require("./types");
+Object.defineProperty(exports, "CircuitState", { enumerable: true, get: function () { return types_1.CircuitState; } });
+Object.defineProperty(exports, "EscalationLevel", { enumerable: true, get: function () { return types_1.EscalationLevel; } });
+// Constants
+var constants_1 = require("./constants");
+Object.defineProperty(exports, "KEY_PATTERNS", { enumerable: true, get: function () { return constants_1.KEY_PATTERNS; } });
+Object.defineProperty(exports, "QUEUE_MANAGEMENT_CONFIG", { enumerable: true, get: function () { return constants_1.QUEUE_MANAGEMENT_CONFIG; } });
+//# sourceMappingURL=index.js.map

package/dist/server/redis/queue-management/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/server/redis/queue-management/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;GAgBG;;;AAEH,eAAe;AACf,+BAA4C;AAAnC,2GAAA,mBAAmB,OAAA;AAE5B,kBAAkB;AAClB,iCAcgB;AAbZ,qGAAA,YAAY,OAAA;AACZ,wGAAA,eAAe,OAAA;AAcnB,YAAY;AACZ,yCAAmE;AAA1D,yGAAA,YAAY,OAAA;AAAE,oHAAA,uBAAuB,OAAA"}

package/dist/server/redis/queue-management/keys.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Queue Management Redis Keys
+ *
+ * Key builder functions for the Queue Management System.
+ * These are ONLY for operational queue control.
+ *
+ * NOTE: Game/market pause is checked via existing searchGames()/searchMarkets()
+ * which return game.paused/market.paused from Redis Search cache.
+ * DO NOT create separate pause keys for games/markets.
+ */
+import type { QueueType } from "./types";
+export declare const QueueManagementKeys: {
+    readonly pause: {
+        /**
+         * Global pause key - stops ALL queue processing
+         * Type: STRING (JSON)
+         * @example 'queue:pause:global'
+         */
+        readonly global: () => "queue:pause:global";
+        /**
+         * Queue type pause key - stops all queues of a specific type
+         * Type: STRING (JSON)
+         * @example 'queue:pause:type:market'
+         */
+        readonly type: (type: QueueType) => "queue:pause:type:market" | "queue:pause:type:game" | "queue:pause:type:game_time" | "queue:pause:type:liquidation";
+        /**
+         * Individual queue pause key - stops a specific queue
+         * Type: STRING (JSON)
+         * Use for operational control without touching game/market state
+         * @example 'queue:pause:queue:mkt.507f1f77bcf86cd799439011.507f1f77bcf86cd799439012'
+         */
+        readonly queue: (queueName: string) => `queue:pause:queue:${string}`;
+        /**
+         * Active operational pauses index
+         * Type: SET
+         * Members: All currently paused key names (only operational pauses)
+         * @example 'queue:pause:active'
+         */
+        readonly activeIndex: () => "queue:pause:active";
+    };
+    readonly escalation: {
+        /**
+         * Queue escalation state
+         * Type: HASH
+         * @example 'queue:escalation:mkt.abc.xyz'
+         */
+        readonly state: (queueName: string) => `queue:escalation:${string}`;
+        /**
+         * Queue escalation history
+         * Type: LIST (LPUSH, most recent first)
+         * @example 'queue:escalation:history:mkt.abc.xyz'
+         */
+        readonly history: (queueName: string) => `queue:escalation:history:${string}`;
+        /**
+         * Active escalations index (sorted by level)
+         * Type: SORTED SET (score = escalation level)
+         * @example 'queue:escalation:active'
+         */
+        readonly activeIndex: () => "queue:escalation:active";
+    };
+    readonly circuitBreaker: {
+        /**
+         * Circuit breaker state for a queue
+         * Type: HASH
+         * @example 'circuit_breaker:mkt.abc.xyz'
+         */
+        readonly state: (queueName: string) => `circuit_breaker:${string}`;
+        /**
+         * Index of open circuit breakers
+         * Type: SET
+         * @example 'circuit_breaker:open'
+         */
+        readonly openIndex: () => "circuit_breaker:open";
+    };
+    readonly dlq: {
+        /**
+         * DLQ statistics cache
+         * Type: HASH
+         * TTL: 60 seconds
+         * @example 'dlq:stats:dlq.market'
+         */
+        readonly stats: (dlqName: string) => `dlq:stats:${string}`;
+        /**
+         * DLQ reprocess counter
+         * Type: STRING (integer)
+         * @example 'dlq:reprocessed:dlq.market'
+         */
+        readonly reprocessCount: (dlqName: string) => `dlq:reprocessed:${string}`;
+        /**
+         * DLQ alert sent flag (for debouncing)
+         * Type: STRING
+         * TTL: 3600 seconds (1 hour)
+         * @example 'dlq:alert:dlq.market:threshold_exceeded'
+         */
+        readonly alertSent: (dlqName: string, alertType: string) => `dlq:alert:${string}:${string}`;
+    };
+};

package/dist/server/redis/queue-management/keys.js

@@ -0,0 +1,113 @@
+"use strict";
+/**
+ * Queue Management Redis Keys
+ *
+ * Key builder functions for the Queue Management System.
+ * These are ONLY for operational queue control.
+ *
+ * NOTE: Game/market pause is checked via existing searchGames()/searchMarkets()
+ * which return game.paused/market.paused from Redis Search cache.
+ * DO NOT create separate pause keys for games/markets.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.QueueManagementKeys = void 0;
+exports.QueueManagementKeys = {
+    // =========================================================================
+    // Operational Pause Keys (NEW)
+    // For pausing message PROCESSING without changing game/market business state
+    // =========================================================================
+    pause: {
+        /**
+         * Global pause key - stops ALL queue processing
+         * Type: STRING (JSON)
+         * @example 'queue:pause:global'
+         */
+        global: () => "queue:pause:global",
+        /**
+         * Queue type pause key - stops all queues of a specific type
+         * Type: STRING (JSON)
+         * @example 'queue:pause:type:market'
+         */
+        type: (type) => `queue:pause:type:${type}`,
+        /**
+         * Individual queue pause key - stops a specific queue
+         * Type: STRING (JSON)
+         * Use for operational control without touching game/market state
+         * @example 'queue:pause:queue:mkt.507f1f77bcf86cd799439011.507f1f77bcf86cd799439012'
+         */
+        queue: (queueName) => `queue:pause:queue:${queueName}`,
+        /**
+         * Active operational pauses index
+         * Type: SET
+         * Members: All currently paused key names (only operational pauses)
+         * @example 'queue:pause:active'
+         */
+        activeIndex: () => "queue:pause:active",
+    },
+    // =========================================================================
+    // Escalation Keys
+    // =========================================================================
+    escalation: {
+        /**
+         * Queue escalation state
+         * Type: HASH
+         * @example 'queue:escalation:mkt.abc.xyz'
+         */
+        state: (queueName) => `queue:escalation:${queueName}`,
+        /**
+         * Queue escalation history
+         * Type: LIST (LPUSH, most recent first)
+         * @example 'queue:escalation:history:mkt.abc.xyz'
+         */
+        history: (queueName) => `queue:escalation:history:${queueName}`,
+        /**
+         * Active escalations index (sorted by level)
+         * Type: SORTED SET (score = escalation level)
+         * @example 'queue:escalation:active'
+         */
+        activeIndex: () => "queue:escalation:active",
+    },
+    // =========================================================================
+    // Circuit Breaker Keys (Existing - Standardized)
+    // =========================================================================
+    circuitBreaker: {
+        /**
+         * Circuit breaker state for a queue
+         * Type: HASH
+         * @example 'circuit_breaker:mkt.abc.xyz'
+         */
+        state: (queueName) => `circuit_breaker:${queueName}`,
+        /**
+         * Index of open circuit breakers
+         * Type: SET
+         * @example 'circuit_breaker:open'
+         */
+        openIndex: () => "circuit_breaker:open",
+    },
+    // =========================================================================
+    // DLQ Management Keys
+    // =========================================================================
+    dlq: {
+        /**
+         * DLQ statistics cache
+         * Type: HASH
+         * TTL: 60 seconds
+         * @example 'dlq:stats:dlq.market'
+         */
+        stats: (dlqName) => `dlq:stats:${dlqName}`,
+        /**
+         * DLQ reprocess counter
+         * Type: STRING (integer)
+         * @example 'dlq:reprocessed:dlq.market'
+         */
+        reprocessCount: (dlqName) => `dlq:reprocessed:${dlqName}`,
+        /**
+         * DLQ alert sent flag (for debouncing)
+         * Type: STRING
+         * TTL: 3600 seconds (1 hour)
+         * @example 'dlq:alert:dlq.market:threshold_exceeded'
+         */
+        alertSent: (dlqName, alertType) => `dlq:alert:${dlqName}:${alertType}`,
+    },
+};
+//# sourceMappingURL=keys.js.map

package/dist/server/redis/queue-management/keys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keys.js","sourceRoot":"","sources":["../../../../src/server/redis/queue-management/keys.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;;AAIU,QAAA,mBAAmB,GAAG;IAC/B,4EAA4E;IAC5E,+BAA+B;IAC/B,6EAA6E;IAC7E,4EAA4E;IAE5E,KAAK,EAAE;QACH;;;;WAIG;QACH,MAAM,EAAE,GAAG,EAAE,CAAC,oBAA6B;QAE3C;;;;WAIG;QACH,IAAI,EAAE,CAAC,IAAe,EAAE,EAAE,CAAC,oBAAoB,IAAI,EAAW;QAE9D;;;;;WAKG;QACH,KAAK,EAAE,CAAC,SAAiB,EAAE,EAAE,CAAC,qBAAqB,SAAS,EAAW;QAEvE;;;;;WAKG;QACH,WAAW,EAAE,GAAG,EAAE,CAAC,oBAA6B;KACnD;IAED,4EAA4E;IAC5E,kBAAkB;IAClB,4EAA4E;IAE5E,UAAU,EAAE;QACR;;;;WAIG;QACH,KAAK,EAAE,CAAC,SAAiB,EAAE,EAAE,CAAC,oBAAoB,SAAS,EAAW;QAEtE;;;;WAIG;QACH,OAAO,EAAE,CAAC,SAAiB,EAAE,EAAE,CAAC,4BAA4B,SAAS,EAAW;QAEhF;;;;WAIG;QACH,WAAW,EAAE,GAAG,EAAE,CAAC,yBAAkC;KACxD;IAED,4EAA4E;IAC5E,iDAAiD;IACjD,4EAA4E;IAE5E,cAAc,EAAE;QACZ;;;;WAIG;QACH,KAAK,EAAE,CAAC,SAAiB,EAAE,EAAE,CAAC,mBAAmB,SAAS,EAAW;QAErE;;;;WAIG;QACH,SAAS,EAAE,GAAG,EAAE,CAAC,sBAA+B;KACnD;IAED,4EAA4E;IAC5E,sBAAsB;IACtB,4EAA4E;IAE5E,GAAG,EAAE;QACD;;;;;WAKG;QACH,KAAK,EAAE,CAAC,OAAe,EAAE,EAAE,CAAC,aAAa,OAAO,EAAW;QAE3D;;;;WAIG;QACH,cAAc,EAAE,CAAC,OAAe,EAAE,EAAE,CAAC,mBAAmB,OAAO,EAAW;QAE1E;;;;;WAKG;QACH,SAAS,EAAE,CAAC,OAAe,EAAE,SAAiB,EAAE,EAAE,CAAC,aAAa,OAAO,IAAI,SAAS,EAAW;KAClG;CACK,CAAA"}

package/dist/server/redis/queue-management/types.d.ts

@@ -0,0 +1,111 @@
+/**
+ * Queue Management Redis Types
+ *
+ * Type definitions for the Queue Management System Redis keys.
+ * These keys handle operational queue control - NOT game/market business state.
+ *
+ * For game/market pause state, use existing Redis Search cache:
+ * - searchGames(redis, { objectId }) → game.paused
+ * - searchMarkets(redis, { objectId }) → market.paused
+ */
+export declare enum EscalationLevel {
+    NORMAL = 0,
+    WATCH = 1,
+    WARNING = 2,
+    CRITICAL = 3,
+    EMERGENCY = 4
+}
+export declare enum CircuitState {
+    CLOSED = "CLOSED",
+    OPEN = "OPEN",
+    HALF_OPEN = "HALF_OPEN"
+}
+export type QueueType = "market" | "game" | "game_time" | "liquidation";
+/**
+ * Base pause state for operational pauses
+ */
+export interface OperationalPauseState {
+    paused: boolean;
+    pausedAt: number;
+    pausedBy: string;
+    reason: string;
+    resumeAt?: number;
+}
+/**
+ * Global pause state - stops ALL queue processing
+ */
+export interface GlobalPauseState extends OperationalPauseState {
+}
+/**
+ * Type pause state - stops all queues of a specific type
+ */
+export interface TypePauseState extends OperationalPauseState {
+    queueType: QueueType;
+}
+/**
+ * Individual queue pause state - stops a specific queue
+ * Use for operational control without touching game/market state
+ */
+export interface QueuePauseState extends OperationalPauseState {
+    queueName: string;
+}
+/**
+ * Current escalation state for a queue
+ */
+export interface EscalationState {
+    queueName: string;
+    level: EscalationLevel;
+    escalatedAt: number;
+    reason: string;
+    escalatedBy: "auto" | string;
+}
+/**
+ * Historical escalation entry
+ */
+export interface EscalationHistoryEntry {
+    level: EscalationLevel;
+    timestamp: number;
+    reason: string;
+    escalatedBy: string;
+    resolvedAt?: number;
+}
+/**
+ * Circuit breaker state for a queue
+ */
+export interface CircuitBreakerState {
+    state: CircuitState;
+    consecutiveFailures: number;
+    lastFailureTime: number;
+    lastSuccessTime: number;
+    lastError: string;
+    nextRetryTime: number;
+    backoffMs: number;
+}
+/**
+ * DLQ statistics cache
+ */
+export interface DLQStats {
+    totalMessages: number;
+    oldestMessageAt: number;
+    newestMessageAt: number;
+    lastUpdated: number;
+    byQueue: Record<string, number>;
+    byReason: Record<string, number>;
+}
+/**
+ * Queue context for pause checking
+ */
+export interface QueueContext {
+    queueName: string;
+    queueType: QueueType;
+    gameObjectId: string;
+    marketObjectId?: string;
+}
+/**
+ * Result of pause check operation
+ */
+export interface PauseCheckResult {
+    canProcess: boolean;
+    reason?: string;
+    pauseLevel?: "global" | "type" | "game" | "market" | "queue";
+}

package/dist/server/redis/queue-management/types.js

@@ -0,0 +1,28 @@
+"use strict";
+/**
+ * Queue Management Redis Types
+ *
+ * Type definitions for the Queue Management System Redis keys.
+ * These keys handle operational queue control - NOT game/market business state.
+ *
+ * For game/market pause state, use existing Redis Search cache:
+ * - searchGames(redis, { objectId }) → game.paused
+ * - searchMarkets(redis, { objectId }) → market.paused
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CircuitState = exports.EscalationLevel = void 0;
+var EscalationLevel;
+(function (EscalationLevel) {
+    EscalationLevel[EscalationLevel["NORMAL"] = 0] = "NORMAL";
+    EscalationLevel[EscalationLevel["WATCH"] = 1] = "WATCH";
+    EscalationLevel[EscalationLevel["WARNING"] = 2] = "WARNING";
+    EscalationLevel[EscalationLevel["CRITICAL"] = 3] = "CRITICAL";
+    EscalationLevel[EscalationLevel["EMERGENCY"] = 4] = "EMERGENCY";
+})(EscalationLevel || (exports.EscalationLevel = EscalationLevel = {}));
+var CircuitState;
+(function (CircuitState) {
+    CircuitState["CLOSED"] = "CLOSED";
+    CircuitState["OPEN"] = "OPEN";
+    CircuitState["HALF_OPEN"] = "HALF_OPEN";
+})(CircuitState || (exports.CircuitState = CircuitState = {}));
+//# sourceMappingURL=types.js.map

package/dist/server/redis/queue-management/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/server/redis/queue-management/types.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;;AAEH,IAAY,eAMX;AAND,WAAY,eAAe;IACvB,yDAAU,CAAA;IACV,uDAAS,CAAA;IACT,2DAAW,CAAA;IACX,6DAAY,CAAA;IACZ,+DAAa,CAAA;AACjB,CAAC,EANW,eAAe,+BAAf,eAAe,QAM1B;AAED,IAAY,YAIX;AAJD,WAAY,YAAY;IACpB,iCAAiB,CAAA;IACjB,6BAAa,CAAA;IACb,uCAAuB,CAAA;AAC3B,CAAC,EAJW,YAAY,4BAAZ,YAAY,QAIvB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@levrbet/shared",
-  "version": "0.3.41",
+  "version": "0.4.1",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "exports": {