@bejibun/redis 0.1.38 → 0.1.39

package/CHANGELOG.md

@@ -3,6 +3,21 @@ All notable changes to this project will be documented in this file.
 
 ---
 
+## [v0.1.39](https://github.com/Bejibun-Framework/bejibun-redis/compare/v0.1.38...v0.1.39) - 2026-03-02
+
+### 🩹 Fixes
+
+### 📖 Changes
+- Added `.ttl(key: string)` to get ttl of key.
+- Added `.expire(key: string, value: number)` to set key expires.
+
+### ❤️Contributors
+- Havea Crenata ([@crenata](https://github.com/crenata))
+
+**Full Changelog**: https://github.com/Bejibun-Framework/bejibun-redis/blob/master/CHANGELOG.md
+
+---
+
 ## [v0.1.38](https://github.com/Bejibun-Framework/bejibun-redis/compare/v0.1.36...v0.1.38) - 2026-02-14
 
 ### 🩹 Fixes

package/builders/RedisBuilder.d.ts

@@ -10,6 +10,8 @@ export default class RedisBuilder {
     static get(key: Bun.RedisClient.KeyLike, connection?: string, disconnectAfter?: boolean): Promise<any>;
     static set(key: Bun.RedisClient.KeyLike, value: any, ttl?: number, connection?: string, disconnectAfter?: boolean): Promise<number | "OK">;
     static del(key: Bun.RedisClient.KeyLike, connection?: string, disconnectAfter?: boolean): Promise<number>;
+    static ttl(key: Bun.RedisClient.KeyLike, connection?: string, disconnectAfter?: boolean): Promise<number>;
+    static expire(key: Bun.RedisClient.KeyLike, value: number, connection?: string, disconnectAfter?: boolean): Promise<number>;
     static publish(channel: string, message: any, connection?: string): Promise<number>;
     static subscribe(channel: string, listener: Bun.RedisClient.StringPubSubListener, connection?: string): Promise<RedisSubscribe>;
     static pipeline(fn: (pipe: RedisPipeline) => void, connection?: string, disconnectAfter?: boolean): Promise<any[]>;

package/builders/RedisBuilder.js

@@ -14,23 +14,27 @@ export default class RedisBuilder {
         this.clients[connectionName] = this.createClient(connectionName, cfg);
         return {
             del: (key) => this.del(key, connectionName, isNotEmpty(name)),
+            expire: (key, value) => this.expire(key, value, connectionName, isNotEmpty(name)),
             get: (key) => this.get(key, connectionName, isNotEmpty(name)),
             keys: (pattern) => this.keys(pattern, connectionName, isNotEmpty(name)),
             pipeline: (fn) => this.pipeline(fn, connectionName, isNotEmpty(name)),
             publish: (channel, message) => this.publish(channel, message, connectionName),
             set: (key, value, ttl) => this.set(key, value, ttl, connectionName, isNotEmpty(name)),
             subscribe: (channel, listener) => this.subscribe(channel, listener, connectionName),
+            ttl: (key) => this.ttl(key, connectionName, isNotEmpty(name))
         };
     }
     static connection(name) {
         return {
             del: (key) => this.del(key, name),
+            expire: (key, value) => this.expire(key, value, name),
             get: (key) => this.get(key, name),
             keys: (pattern) => this.keys(pattern, name),
             pipeline: (fn) => this.pipeline(fn, name),
             publish: (channel, message) => this.publish(channel, message, name),
             set: (key, value, ttl) => this.set(key, value, ttl, name),
             subscribe: (channel, listener) => this.subscribe(channel, listener, name),
+            ttl: (key) => this.ttl(key, name)
         };
     }
     static async connect(name) {
@@ -109,6 +113,30 @@ export default class RedisBuilder {
             return 0;
         }
     }
+    static async ttl(key, connection, disconnectAfter) {
+        try {
+            const data = await this.getClient(connection).ttl(key);
+            if (disconnectAfter)
+                await this.disconnect(connection);
+            return data;
+        }
+        catch (error) {
+            Logger.setContext("Redis").error("Failed to fetch ttl.").trace(error);
+            return 0;
+        }
+    }
+    static async expire(key, value, connection, disconnectAfter) {
+        try {
+            const data = await this.getClient(connection).expire(key, value);
+            if (disconnectAfter)
+                await this.disconnect(connection);
+            return data;
+        }
+        catch (error) {
+            Logger.setContext("Redis").error("Failed to set expire.").trace(error);
+            return 0;
+        }
+    }
     static async publish(channel, message, connection) {
         try {
             const serialized = this.serialize(message);

package/facades/Redis.d.ts

@@ -8,6 +8,8 @@ export default class Redis {
     static get(key: Bun.RedisClient.KeyLike, connection?: string): Promise<any>;
     static set(key: Bun.RedisClient.KeyLike, value: any, ttl?: number, connection?: string): Promise<number | "OK">;
     static del(key: Bun.RedisClient.KeyLike, connection?: string): Promise<number>;
+    static ttl(key: Bun.RedisClient.KeyLike, connection?: string): Promise<number>;
+    static expire(key: Bun.RedisClient.KeyLike, value: number, connection?: string): Promise<number>;
     static publish(channel: string, message: any, connection?: string): Promise<number>;
     static subscribe(channel: string, listener: Bun.RedisClient.StringPubSubListener, connection?: string): Promise<RedisSubscribe>;
     static pipeline(fn: (pipe: RedisPipeline) => void, connection?: string): Promise<any[]>;

package/facades/Redis.js

@@ -24,6 +24,12 @@ export default class Redis {
     static async del(key, connection) {
         return RedisBuilder.del(key, connection);
     }
+    static async ttl(key, connection) {
+        return RedisBuilder.ttl(key, connection);
+    }
+    static async expire(key, value, connection) {
+        return RedisBuilder.expire(key, value, connection);
+    }
     static async publish(channel, message, connection) {
         return RedisBuilder.publish(channel, message, connection);
     }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@bejibun/redis",
-    "version": "0.1.38",
+    "version": "0.1.39",
     "author": "Havea Crenata <havea.crenata@gmail.com>",
     "repository": {
         "type": "git",