@agendajs/redis-backend 2.0.0 → 3.0.1

package/README.md

@@ -125,6 +125,43 @@ This means:
 
 The backend uses Redis WATCH/MULTI/EXEC transactions to atomically lock jobs for processing, preventing duplicate execution across multiple Agenda instances.
 
+## Job Logging
+
+RedisBackend includes a built-in `RedisJobLogger` that stores structured job lifecycle events using Redis sorted sets and hashes. The logger is lightweight and only creates its keys on first use.
+
+### Automatic Usage
+
+When you enable logging in Agenda, the backend's built-in logger is used automatically:
+
+```typescript
+const agenda = new Agenda({
+  backend: new RedisBackend({ connectionString: 'redis://localhost:6379' }),
+  logging: true  // Uses RedisJobLogger automatically
+});
+```
+
+### Standalone Usage
+
+You can also use `RedisJobLogger` independently — for example, to log to Redis while using a different backend for storage:
+
+```typescript
+import { RedisJobLogger } from '@agendajs/redis-backend';
+import Redis from 'ioredis';
+
+const logger = new RedisJobLogger({
+  redis: new Redis('redis://localhost:6379')
+});
+
+// Use with any backend
+import { MongoBackend } from '@agendajs/mongo-backend';
+const agenda = new Agenda({
+  backend: new MongoBackend({ mongo: db }),
+  logging: logger
+});
+```
+
+See the [Agenda README](https://github.com/agenda/agenda#persistent-job-logging) for full logging documentation.
+
 ## Persistence
 
 By default, Redis keeps data in memory. For production use with Agenda, configure Redis persistence:

package/dist/RedisBackend.d.ts

@@ -1,4 +1,4 @@
-import type { AgendaBackend, JobRepository, NotificationChannel } from 'agenda';
+import type { AgendaBackend, JobRepository, NotificationChannel, JobLogger } from 'agenda';
 import type { RedisBackendConfig } from './types.js';
 /**
  * Redis backend for Agenda
@@ -41,6 +41,7 @@ export declare class RedisBackend implements AgendaBackend {
     readonly name = "Redis";
     private _repository;
     private _notificationChannel;
+    private _logger;
     private config;
     private _ownsConnection;
     constructor(config: RedisBackendConfig);
@@ -48,6 +49,11 @@ export declare class RedisBackend implements AgendaBackend {
      * The job repository for storage operations
      */
     get repository(): JobRepository;
+    /**
+     * The job logger for persistent event logging.
+     * Always available; Agenda decides whether to activate it via its `logging` config.
+     */
+    get logger(): JobLogger;
     /**
      * The notification channel for real-time notifications via Pub/Sub
      */

package/dist/RedisBackend.js

@@ -1,5 +1,6 @@
 import debug from 'debug';
 import { RedisJobRepository } from './RedisJobRepository.js';
+import { RedisJobLogger } from './RedisJobLogger.js';
 import { RedisNotificationChannel } from './RedisNotificationChannel.js';
 const log = debug('agenda:redis:backend');
 /**
@@ -43,6 +44,7 @@ export class RedisBackend {
     name = 'Redis';
     _repository;
     _notificationChannel;
+    _logger;
     config;
     _ownsConnection;
     constructor(config) {
@@ -58,6 +60,8 @@ export class RedisBackend {
                 enabled: true
             }
         });
+        // Always create the logger (lightweight; only initializes on first use when Agenda activates it)
+        this._logger = new RedisJobLogger({ keyPrefix: config.keyPrefix });
         log('RedisBackend created with config: %O', {
             keyPrefix: config.keyPrefix || 'agenda:',
             channelName: config.channelName || 'agenda:jobs'
@@ -69,6 +73,13 @@ export class RedisBackend {
     get repository() {
         return this._repository;
     }
+    /**
+     * The job logger for persistent event logging.
+     * Always available; Agenda decides whether to activate it via its `logging` config.
+     */
+    get logger() {
+        return this._logger;
+    }
     /**
      * The notification channel for real-time notifications via Pub/Sub
      */
@@ -94,6 +105,8 @@ export class RedisBackend {
         await this._repository.connect();
         // Share the Redis client with notification channel
         this._notificationChannel.setRedis(this._repository.getRedis());
+        // Initialize the job logger with the shared Redis client
+        this._logger.setRedis(this._repository.getRedis());
         // Note: notification channel is connected by Agenda.start()
         // when it's needed, so we don't connect it here
         log('RedisBackend connected');

package/dist/RedisBackend.js.map

@@ -1 +1 @@
-{"version":3,"file":"RedisBackend.js","sourceRoot":"","sources":["../src/RedisBackend.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAGzE,MAAM,GAAG,GAAG,KAAK,CAAC,sBAAsB,CAAC,CAAC;AAE1C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,MAAM,OAAO,YAAY;IACf,IAAI,GAAG,OAAO,CAAC;IAEhB,WAAW,CAAqB;IAChC,oBAAoB,CAA2B;IAC/C,MAAM,CAAqB;IAC3B,eAAe,CAAU;IAEjC,YAAY,MAA0B;QACrC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QAErB,6DAA6D;QAC7D,IAAI,CAAC,eAAe,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC;QAErC,oBAAoB;QACpB,IAAI,CAAC,WAAW,GAAG,IAAI,kBAAkB,CAAC,MAAM,CAAC,CAAC;QAElD,8BAA8B;QAC9B,IAAI,CAAC,oBAAoB,GAAG,IAAI,wBAAwB,CAAC;YACxD,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,SAAS,EAAE;gBACV,OAAO,EAAE,IAAI;aACb;SACD,CAAC,CAAC;QAEH,GAAG,CAAC,sCAAsC,EAAE;YAC3C,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,SAAS;YACxC,WAAW,EAAE,MAAM,CAAC,WAAW,IAAI,aAAa;SAChD,CAAC,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,IAAI,UAAU;QACb,OAAO,IAAI,CAAC,WAAW,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,IAAI,mBAAmB;QACtB,OAAO,IAAI,CAAC,oBAAoB,CAAC;IAClC,CAAC;IAED;;;OAGG;IACH,IAAI,cAAc;QACjB,OAAO,IAAI,CAAC,eAAe,CAAC;IAC7B,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,OAAO;QACZ,GAAG,CAAC,yBAAyB,CAAC,CAAC;QAE/B,2BAA2B;QAC3B,MAAM,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC;QAEjC,mDAAmD;QACnD,IAAI,CAAC,oBAAoB,CAAC,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,QAAQ,EAAE,CAAC,CAAC;QAEhE,4DAA4D;QAC5D,gDAAgD;QAEhD,GAAG,CAAC,wBAAwB,CAAC,CAAC;IAC/B,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,UAAU;QACf,GAAG,CAAC,4BAA4B,CAAC,CAAC;QAElC,wDAAwD;QACxD,qDAAqD;QACrD,MAAM,IAAI,CAAC,WAAW,CAAC,UAAU,EAAE,CAAC;QAEpC,GAAG,CAAC,2BAA2B,CAAC,CAAC;IAClC,CAAC;CACD"}
+{"version":3,"file":"RedisBackend.js","sourceRoot":"","sources":["../src/RedisBackend.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAGzE,MAAM,GAAG,GAAG,KAAK,CAAC,sBAAsB,CAAC,CAAC;AAE1C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,MAAM,OAAO,YAAY;IACf,IAAI,GAAG,OAAO,CAAC;IAEhB,WAAW,CAAqB;IAChC,oBAAoB,CAA2B;IAC/C,OAAO,CAAiB;IACxB,MAAM,CAAqB;IAC3B,eAAe,CAAU;IAEjC,YAAY,MAA0B;QACrC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QAErB,6DAA6D;QAC7D,IAAI,CAAC,eAAe,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC;QAErC,oBAAoB;QACpB,IAAI,CAAC,WAAW,GAAG,IAAI,kBAAkB,CAAC,MAAM,CAAC,CAAC;QAElD,8BAA8B;QAC9B,IAAI,CAAC,oBAAoB,GAAG,IAAI,wBAAwB,CAAC;YACxD,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,SAAS,EAAE;gBACV,OAAO,EAAE,IAAI;aACb;SACD,CAAC,CAAC;QAEH,iGAAiG;QACjG,IAAI,CAAC,OAAO,GAAG,IAAI,cAAc,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC;QAEnE,GAAG,CAAC,sCAAsC,EAAE;YAC3C,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,SAAS;YACxC,WAAW,EAAE,MAAM,CAAC,WAAW,IAAI,aAAa;SAChD,CAAC,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,IAAI,UAAU;QACb,OAAO,IAAI,CAAC,WAAW,CAAC;IACzB,CAAC;IAED;;;OAGG;IACH,IAAI,MAAM;QACT,OAAO,IAAI,CAAC,OAAO,CAAC;IACrB,CAAC;IAED;;OAEG;IACH,IAAI,mBAAmB;QACtB,OAAO,IAAI,CAAC,oBAAoB,CAAC;IAClC,CAAC;IAED;;;OAGG;IACH,IAAI,cAAc;QACjB,OAAO,IAAI,CAAC,eAAe,CAAC;IAC7B,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,OAAO;QACZ,GAAG,CAAC,yBAAyB,CAAC,CAAC;QAE/B,2BAA2B;QAC3B,MAAM,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC;QAEjC,mDAAmD;QACnD,IAAI,CAAC,oBAAoB,CAAC,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,QAAQ,EAAE,CAAC,CAAC;QAEhE,yDAAyD;QACzD,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,QAAQ,EAAE,CAAC,CAAC;QAEnD,4DAA4D;QAC5D,gDAAgD;QAEhD,GAAG,CAAC,wBAAwB,CAAC,CAAC;IAC/B,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,UAAU;QACf,GAAG,CAAC,4BAA4B,CAAC,CAAC;QAElC,wDAAwD;QACxD,qDAAqD;QACrD,MAAM,IAAI,CAAC,WAAW,CAAC,UAAU,EAAE,CAAC;QAEpC,GAAG,CAAC,2BAA2B,CAAC,CAAC;IAClC,CAAC;CACD"}

package/dist/RedisJobLogger.d.ts

@@ -0,0 +1,53 @@
+import type { Redis } from 'ioredis';
+import type { JobLogger, JobLogEntry, JobLogQuery, JobLogQueryResult } from 'agenda';
+/**
+ * Redis implementation of JobLogger.
+ * Stores job lifecycle events using Redis sorted sets and hashes.
+ *
+ * Data structure:
+ * - `{prefix}log:{id}` - Hash for each log entry
+ * - `{prefix}logs:all` - Sorted set of all log IDs (score = timestamp)
+ * - `{prefix}logs:by_job:{jobId}` - Sorted set of log IDs per job
+ * - `{prefix}logs:by_name:{jobName}` - Sorted set of log IDs per job name
+ *
+ * @example
+ * ```typescript
+ * // Via backend (automatic connection sharing):
+ * import { RedisBackend } from '@agendajs/redis-backend';
+ *
+ * const backend = new RedisBackend({
+ *   connectionString: 'redis://localhost:6379',
+ *   logging: true // enables RedisJobLogger
+ * });
+ *
+ * // Standalone (e.g., log to Redis while using Mongo for storage):
+ * import { RedisJobLogger } from '@agendajs/redis-backend';
+ * import Redis from 'ioredis';
+ *
+ * const logger = new RedisJobLogger({ redis: new Redis('redis://localhost:6379') });
+ * const agenda = new Agenda({
+ *   backend: new MongoBackend({ address: 'mongodb://...' }),
+ *   logging: logger
+ * });
+ * ```
+ */
+export declare class RedisJobLogger implements JobLogger {
+    private redis;
+    private readonly keyPrefix;
+    private idCounter;
+    constructor(options?: {
+        redis?: Redis;
+        keyPrefix?: string;
+    } | string);
+    private key;
+    /**
+     * Set the Redis client.
+     * Called by RedisBackend after the repository connects.
+     */
+    setRedis(redis: Redis): void;
+    private generateId;
+    log(entry: Omit<JobLogEntry, '_id'>): Promise<void>;
+    getLogs(query?: JobLogQuery): Promise<JobLogQueryResult>;
+    clearLogs(query?: JobLogQuery): Promise<number>;
+    private hashToEntry;
+}

package/dist/RedisJobLogger.js

@@ -0,0 +1,217 @@
+import debug from 'debug';
+const log = debug('agenda:redis:logger');
+/**
+ * Redis implementation of JobLogger.
+ * Stores job lifecycle events using Redis sorted sets and hashes.
+ *
+ * Data structure:
+ * - `{prefix}log:{id}` - Hash for each log entry
+ * - `{prefix}logs:all` - Sorted set of all log IDs (score = timestamp)
+ * - `{prefix}logs:by_job:{jobId}` - Sorted set of log IDs per job
+ * - `{prefix}logs:by_name:{jobName}` - Sorted set of log IDs per job name
+ *
+ * @example
+ * ```typescript
+ * // Via backend (automatic connection sharing):
+ * import { RedisBackend } from '@agendajs/redis-backend';
+ *
+ * const backend = new RedisBackend({
+ *   connectionString: 'redis://localhost:6379',
+ *   logging: true // enables RedisJobLogger
+ * });
+ *
+ * // Standalone (e.g., log to Redis while using Mongo for storage):
+ * import { RedisJobLogger } from '@agendajs/redis-backend';
+ * import Redis from 'ioredis';
+ *
+ * const logger = new RedisJobLogger({ redis: new Redis('redis://localhost:6379') });
+ * const agenda = new Agenda({
+ *   backend: new MongoBackend({ address: 'mongodb://...' }),
+ *   logging: logger
+ * });
+ * ```
+ */
+export class RedisJobLogger {
+    redis;
+    keyPrefix;
+    idCounter = 0;
+    constructor(options) {
+        if (typeof options === 'string') {
+            // Legacy: constructor(keyPrefix)
+            this.keyPrefix = options;
+        }
+        else {
+            this.keyPrefix = options?.keyPrefix ?? 'agenda:';
+            if (options?.redis) {
+                this.redis = options.redis;
+            }
+        }
+    }
+    key(suffix) {
+        return `${this.keyPrefix}${suffix}`;
+    }
+    /**
+     * Set the Redis client.
+     * Called by RedisBackend after the repository connects.
+     */
+    setRedis(redis) {
+        this.redis = redis;
+        log('Redis client set for job logger');
+    }
+    generateId() {
+        return `${Date.now()}-${process.pid}-${++this.idCounter}`;
+    }
+    async log(entry) {
+        if (!this.redis) {
+            log('redis not initialized, skipping log entry');
+            return;
+        }
+        const id = this.generateId();
+        const score = entry.timestamp.getTime();
+        const hashKey = this.key(`log:${id}`);
+        const hashData = {
+            id,
+            timestamp: entry.timestamp.toISOString(),
+            level: entry.level,
+            event: entry.event,
+            jobName: entry.jobName,
+            message: entry.message
+        };
+        if (entry.jobId)
+            hashData.jobId = entry.jobId;
+        if (entry.duration !== undefined)
+            hashData.duration = String(entry.duration);
+        if (entry.error)
+            hashData.error = entry.error;
+        if (entry.failCount !== undefined)
+            hashData.failCount = String(entry.failCount);
+        if (entry.retryDelay !== undefined)
+            hashData.retryDelay = String(entry.retryDelay);
+        if (entry.retryAttempt !== undefined)
+            hashData.retryAttempt = String(entry.retryAttempt);
+        if (entry.agendaName)
+            hashData.agendaName = entry.agendaName;
+        if (entry.meta)
+            hashData.meta = JSON.stringify(entry.meta);
+        const pipeline = this.redis.pipeline();
+        pipeline.hset(hashKey, hashData);
+        pipeline.zadd(this.key('logs:all'), score, id);
+        if (entry.jobId) {
+            pipeline.zadd(this.key(`logs:by_job:${entry.jobId}`), score, id);
+        }
+        pipeline.zadd(this.key(`logs:by_name:${entry.jobName}`), score, id);
+        await pipeline.exec();
+    }
+    async getLogs(query) {
+        if (!this.redis) {
+            return { entries: [], total: 0 };
+        }
+        // Determine which sorted set to query
+        let setKey;
+        if (query?.jobId) {
+            setKey = this.key(`logs:by_job:${query.jobId}`);
+        }
+        else if (query?.jobName) {
+            setKey = this.key(`logs:by_name:${query.jobName}`);
+        }
+        else {
+            setKey = this.key('logs:all');
+        }
+        // Build score range for timestamp filtering
+        const minScore = query?.from ? query.from.getTime() : '-inf';
+        const maxScore = query?.to ? query.to.getTime() : '+inf';
+        // Get all matching IDs (we'll filter in memory for level/event)
+        const sortOrder = query?.sort === 'asc' ? 'asc' : 'desc';
+        let allIds;
+        if (sortOrder === 'desc') {
+            allIds = await this.redis.zrevrangebyscore(setKey, maxScore, minScore);
+        }
+        else {
+            allIds = await this.redis.zrangebyscore(setKey, minScore, maxScore);
+        }
+        if (allIds.length === 0) {
+            return { entries: [], total: 0 };
+        }
+        // Fetch all hash data for these IDs
+        const pipeline = this.redis.pipeline();
+        for (const id of allIds) {
+            pipeline.hgetall(this.key(`log:${id}`));
+        }
+        const results = await pipeline.exec();
+        // Convert and filter
+        let entries = [];
+        if (results) {
+            for (const [err, data] of results) {
+                if (err || !data || typeof data !== 'object' || Object.keys(data).length === 0)
+                    continue;
+                const hash = data;
+                const entry = this.hashToEntry(hash);
+                // Apply level filter
+                if (query?.level) {
+                    const levels = Array.isArray(query.level) ? query.level : [query.level];
+                    if (!levels.includes(entry.level))
+                        continue;
+                }
+                // Apply event filter
+                if (query?.event) {
+                    const events = Array.isArray(query.event) ? query.event : [query.event];
+                    if (!events.includes(entry.event))
+                        continue;
+                }
+                entries.push(entry);
+            }
+        }
+        const total = entries.length;
+        const offset = query?.offset ?? 0;
+        const limit = query?.limit ?? 50;
+        entries = entries.slice(offset, offset + limit);
+        return { entries, total };
+    }
+    async clearLogs(query) {
+        if (!this.redis) {
+            return 0;
+        }
+        // Get IDs to delete
+        const { entries, total } = await this.getLogs({
+            ...query,
+            limit: Number.MAX_SAFE_INTEGER,
+            offset: 0
+        });
+        if (entries.length === 0)
+            return 0;
+        const pipeline = this.redis.pipeline();
+        for (const entry of entries) {
+            if (!entry._id)
+                continue;
+            // Remove hash
+            pipeline.del(this.key(`log:${entry._id}`));
+            // Remove from all sorted sets
+            pipeline.zrem(this.key('logs:all'), entry._id);
+            if (entry.jobId) {
+                pipeline.zrem(this.key(`logs:by_job:${entry.jobId}`), entry._id);
+            }
+            pipeline.zrem(this.key(`logs:by_name:${entry.jobName}`), entry._id);
+        }
+        await pipeline.exec();
+        return total;
+    }
+    hashToEntry(hash) {
+        return {
+            _id: hash.id,
+            timestamp: new Date(hash.timestamp),
+            level: hash.level,
+            event: hash.event,
+            jobId: hash.jobId || undefined,
+            jobName: hash.jobName,
+            message: hash.message,
+            duration: hash.duration ? parseInt(hash.duration, 10) : undefined,
+            error: hash.error || undefined,
+            failCount: hash.failCount ? parseInt(hash.failCount, 10) : undefined,
+            retryDelay: hash.retryDelay ? parseInt(hash.retryDelay, 10) : undefined,
+            retryAttempt: hash.retryAttempt ? parseInt(hash.retryAttempt, 10) : undefined,
+            agendaName: hash.agendaName || undefined,
+            meta: hash.meta ? JSON.parse(hash.meta) : undefined
+        };
+    }
+}
+//# sourceMappingURL=RedisJobLogger.js.map

package/dist/RedisJobLogger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RedisJobLogger.js","sourceRoot":"","sources":["../src/RedisJobLogger.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -26,6 +26,7 @@
  */
 export { RedisBackend } from './RedisBackend.js';
 export { RedisJobRepository } from './RedisJobRepository.js';
+export { RedisJobLogger } from './RedisJobLogger.js';
 export { RedisNotificationChannel } from './RedisNotificationChannel.js';
 export type { RedisBackendConfig, RedisJobData } from './types.js';
 export type { RedisNotificationChannelConfig } from './RedisNotificationChannel.js';

package/dist/index.js

@@ -26,5 +26,6 @@
  */
 export { RedisBackend } from './RedisBackend.js';
 export { RedisJobRepository } from './RedisJobRepository.js';
+export { RedisJobLogger } from './RedisJobLogger.js';
 export { RedisNotificationChannel } from './RedisNotificationChannel.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agendajs/redis-backend",
-  "version": "2.0.0",
+  "version": "3.0.1",
   "description": "Redis backend for Agenda job scheduler with Pub/Sub notification support",
   "type": "module",
   "main": "dist/index.js",
@@ -41,7 +41,7 @@
     "ioredis": "^5.4.0"
   },
   "peerDependencies": {
-    "agenda": "6.1.0"
+    "agenda": "6.2.1"
   },
   "devDependencies": {
     "@types/debug": "^4.1.12",
@@ -49,7 +49,7 @@
     "@vitest/coverage-v8": "^3.1.0",
     "tsx": "^4.21.0",
     "vitest": "^3.1.0",
-    "agenda": "6.1.0"
+    "agenda": "6.2.1"
   },
   "scripts": {
     "build": "tsc -b",