kythia-core 0.9.4-beta → 0.9.4-beta.0

package/changelog.md

@@ -0,0 +1,18 @@
+# Changelog
+
+All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
+
+### 0.9.4-beta.0 (2025-11-04)
+
+
+### 🔧 Changed
+
+* Kythia core library structure and update version to 0.9.1-beta. Simplified index.js exports, improved README with installation instructions, and enhanced documentation across various modules. Updated license to CC BY NC 4.0. Cleaned up unnecessary comments and improved code readability. ([1967b65](https://github.com/kenndeclouv/kythia-core/commit/1967b651d49b4c2a85403c2e5d7a58d95ba1d1ed))
+* Update package name to "kythia-core", adjust LRUCache import, and ensure logger availability in InteractionManager for command execution context. ([9e90cf6](https://github.com/kenndeclouv/kythia-core/commit/9e90cf6e04c4655ffbf71813e173de8b8d074b79))
+* Update version to 0.9.2-beta, enhance caching layer with LRU cache support, and improve sharding awareness in KythiaModel. ([6cfb275](https://github.com/kenndeclouv/kythia-core/commit/6cfb275543410aee6e5df429036be9571134618b))
+
+
+### ✨ Added
+
+* Enhance KythiaModel with multi-Redis fallback support, allowing connection to multiple Redis URLs for improved failover handling. Updated dependency injection to accept various Redis options and refined error handling for Redis connections. ([9eac22b](https://github.com/kenndeclouv/kythia-core/commit/9eac22b299b06842514e9576cdf1c08c09944a50))
+* Introduce failover cache flushing in KythiaModel during Redis connection recovery, enhancing error handling and connection management. Added a flag to track failover state and updated event handlers for improved logging and cache management. ([bb30d36](https://github.com/kenndeclouv/kythia-core/commit/bb30d36a845086675fd35774d773fc04d213bc0b))

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "kythia-core",
-    "version": "0.9.4-beta",
+    "version": "0.9.4-beta.0",
     "description": "Core library for the Kythia main Discord bot: extensible, modular, and scalable foundation for commands, components, and event management.",
     "main": "index.js",
     "scripts": {

package/src/database/KythiaModel.js

@@ -74,6 +74,7 @@ class KythiaModel extends Model {
     static _redisFallbackURLs = [];
     static _redisCurrentIndex = 0;
     static _redisFailedIndexes = new Set();
+    static _justFailedOver = false;
 
     /**
      * 💉 Injects core dependencies into the KythiaModel class.
@@ -187,6 +188,9 @@ class KythiaModel extends Model {
             this.logger.warn(
                 `[REDIS][FAILOVER] Trying to switch Redis connection from url index ${prevIndex} to ${this._redisCurrentIndex}`
             );
+
+            this._justFailedOver = true;
+
             this._closeCurrentRedis();
             this.initializeRedis();
             return true;
@@ -214,7 +218,6 @@ class KythiaModel extends Model {
      */
     static initializeRedis(redisOptions) {
         if (redisOptions) {
-            // ... (Logic ini biarin aja, udah bener) ...
             if (Array.isArray(redisOptions)) {
                 this._redisFallbackURLs = redisOptions.slice();
                 this._redisCurrentIndex = 0;
@@ -228,7 +231,6 @@ class KythiaModel extends Model {
         }
 
         if (!Array.isArray(this._redisFallbackURLs) || this._redisFallbackURLs.length === 0) {
-            // ... (Logic error ini biarin aja, udah bener) ...
             if (this.isShardMode) {
                 this.logger.error('❌ [REDIS][SHARD] No Redis URL/options provided but shard:true. Will run without caching!');
                 this.isRedisConnected = false;
@@ -252,12 +254,8 @@ class KythiaModel extends Model {
 
         let redisOpt;
         if (typeof opt === 'string') {
-            // --- 👇 PERUBAHAN DI SINI 👇 ---
-            // HAPUS lazyConnect: true
             redisOpt = { url: opt, retryStrategy: this._makeRetryStrategy() };
         } else if (opt && typeof opt === 'object') {
-            // --- 👇 PERUBAHAN DI SINI 👇 ---
-            // HAPUS lazyConnect: true
             redisOpt = {
                 maxRetriesPerRequest: 2,
                 enableReadyCheck: true,
@@ -276,21 +274,13 @@ class KythiaModel extends Model {
             }`
         );
 
-        // --- 👇 PERUBAHAN DI SINI 👇 ---
-        // Biarin ioredis otomatis konek (nggak pake lazy)
         this.redis = new Redis(redisOpt.url || redisOpt);
-        
-        // Langsung pasang handler
+
         this._setupRedisEventHandlers();
 
-        // HAPUS PANGGILAN ke _attemptConnection()
-        
         return this.redis;
     }
 
-    // HAPUS Fungsi _attemptConnection
-    // (Sudah tidak ada atau di bawah ini harus DIHAPUS sepenuhnya)
-
     /**
      * Internal: Makes retry strategy function which wraps the fallback failover logic if all failed.
      * Used by initializeRedis.
@@ -314,7 +304,7 @@ class KythiaModel extends Model {
      * @private
      */
     static _setupRedisEventHandlers() {
-        this.redis.on('connect', () => {
+        this.redis.on('connect', async () => {
             if (!this.isRedisConnected) {
                 this.logger.info('✅ [REDIS] Connection established. Switching to Redis Cache mode.');
             }
@@ -324,14 +314,23 @@ class KythiaModel extends Model {
                 clearTimeout(this.reconnectTimeout);
                 this.reconnectTimeout = null;
             }
-            this._redisFailedIndexes.delete(this._redisCurrentIndex); // <-- TAMBAHIN INI
+            this._redisFailedIndexes.delete(this._redisCurrentIndex);
+
+            if (this._justFailedOver) {
+                this.logger.warn(`[REDIS][FAILOVER] Connected to new server, flushing potentially stale cache...`);
+                try {
+                    await this.redis.flushdb();
+                    this.logger.info(`[REDIS][FAILOVER] Stale cache flushed successfully.`);
+                } catch (err) {
+                    this.logger.error(`[REDIS][FAILOVER] FAILED TO FLUSH CACHE:`, err);
+                }
+                this._justFailedOver = false;
+            }
         });
 
         this.redis.on('error', (err) => {
-            // (Biarkan handler 'error' ini kosong atau cuma nge-log, 
-            // karena 'close' yang akan nanganin failover)
             if (err && (err.code === 'ECONNREFUSED' || err.message)) {
-                 this.logger.warn(`🟠 [REDIS] Connection error: ${err.message}`);
+                this.logger.warn(`🟠 [REDIS] Connection error: ${err.message}`);
             }
         });
 
@@ -345,9 +344,8 @@ class KythiaModel extends Model {
             }
             this.isRedisConnected = false;
 
-            this._redisFailedIndexes.add(this._redisCurrentIndex); // <-- TAMBAHIN INI
+            this._redisFailedIndexes.add(this._redisCurrentIndex);
 
-            // --- INI LOGIKA KUNCINYA ---
             this.logger.warn(`[REDIS] Connection #${this._redisCurrentIndex + 1} closed. Attempting immediate failover...`);
             const triedFailover = this._tryRedisFailover();
 
@@ -355,7 +353,6 @@ class KythiaModel extends Model {
                 this.logger.warn(`[REDIS] Failover exhausted. Scheduling full reconnect...`);
                 this._scheduleReconnect();
             }
-            // --- AKHIR LOGIKA KUNCI ---
         });
     }
 
@@ -380,7 +377,7 @@ class KythiaModel extends Model {
             this.reconnectTimeout = null;
 
             this._redisCurrentIndex = 0;
-            this._redisFailedIndexes.clear(); // <-- TAMBAHIN INI
+            this._redisFailedIndexes.clear();
             this._closeCurrentRedis();
             this.initializeRedis();
         }, RECONNECT_DELAY_MINUTES * 60 * 1000);