@agendajs/mongo-backend 1.0.0-alpha.0

package/LICENSE.md

@@ -0,0 +1,25 @@
+## License
+(The MIT License)
+
+Copyright (c) 2013 Ryan Schmukler <ryan@slingingcode.com>
+
+Copyright (c) 2022-2026 Simon Tretter <s.tretter@gmail.com>
+
+Contributors: Mikael Korpela, Alexis Tyler, Vasyl Boroviak, Haris Sulaiman, Loris Guignard
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the 'Software'), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
+the Software, and to permit persons to whom the Software is furnished to do so,
+subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
+FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
+COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
+IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -0,0 +1,174 @@
+# @agendajs/mongo-backend
+
+MongoDB backend for [Agenda](https://www.npmjs.com/package/agenda) job scheduler.
+
+## Installation
+
+```bash
+npm install agenda @agendajs/mongo-backend
+# or
+pnpm add agenda @agendajs/mongo-backend
+# or
+yarn add agenda @agendajs/mongo-backend
+```
+
+**Requirements:**
+- Node.js 18+
+- MongoDB 4+
+
+## Usage
+
+```typescript
+import { Agenda } from 'agenda';
+import { MongoBackend } from '@agendajs/mongo-backend';
+
+// Via connection string
+const agenda = new Agenda({
+  backend: new MongoBackend({
+    address: 'mongodb://localhost/agenda'
+  })
+});
+
+// Or via existing MongoDB connection
+import { MongoClient } from 'mongodb';
+
+const client = await MongoClient.connect('mongodb://localhost');
+const db = client.db('agenda');
+
+const agenda = new Agenda({
+  backend: new MongoBackend({ mongo: db })
+});
+
+// Define jobs
+agenda.define('send-email', async (job) => {
+  const { to, subject } = job.attrs.data;
+  await sendEmail(to, subject);
+});
+
+// Start processing
+await agenda.start();
+
+// Schedule jobs
+await agenda.every('1 hour', 'send-email', { to: 'user@example.com', subject: 'Hello' });
+```
+
+## Configuration Options
+
+```typescript
+interface IMongoBackendConfig {
+  /** MongoDB connection string */
+  address?: string;
+
+  /** Existing MongoDB database instance */
+  mongo?: Db;
+
+  /** Collection name for jobs (default: 'agendaJobs') */
+  collection?: string;
+
+  /** MongoDB client options */
+  options?: MongoClientOptions;
+
+  /** Name to identify this Agenda instance (stored as lastModifiedBy) */
+  name?: string;
+
+  /** Whether to create indexes on connect (default: true) */
+  ensureIndex?: boolean;
+
+  /** Sort order for job queries */
+  sort?: { [key: string]: SortDirection };
+}
+```
+
+### Full Example with Options
+
+```typescript
+const agenda = new Agenda({
+  backend: new MongoBackend({
+    address: 'mongodb://localhost/agenda',
+    collection: 'jobs',           // Custom collection name
+    sort: { nextRunAt: 'asc', priority: 'desc' }
+  }),
+  processEvery: '30 seconds',     // Job polling interval
+  maxConcurrency: 20,             // Max concurrent jobs
+  defaultConcurrency: 5           // Default per job type
+});
+```
+
+## Real-Time Notifications
+
+MongoBackend provides storage only and uses polling to check for new jobs. For real-time job processing across distributed systems, combine it with a notification channel:
+
+```typescript
+import { Agenda, InMemoryNotificationChannel } from 'agenda';
+import { MongoBackend } from '@agendajs/mongo-backend';
+
+// For single-process apps (testing/development)
+const agenda = new Agenda({
+  backend: new MongoBackend({ mongo: db }),
+  notificationChannel: new InMemoryNotificationChannel()
+});
+
+// For production: use Redis for notifications
+import { RedisBackend } from '@agendajs/redis-backend';
+
+const redisBackend = new RedisBackend({ connectionString: 'redis://localhost:6379' });
+const agenda = new Agenda({
+  backend: new MongoBackend({ mongo: db }),
+  notificationChannel: redisBackend.notificationChannel
+});
+```
+
+## Database Index
+
+By default, MongoBackend automatically creates the `findAndLockNextJobIndex` index on connect for optimal job query performance. The index includes:
+
+```javascript
+{
+  "name": 1,
+  "nextRunAt": 1,
+  "priority": -1,
+  "lockedAt": 1,
+  "disabled": 1
+}
+```
+
+To disable automatic index creation (e.g., if you manage indexes separately):
+
+```typescript
+const backend = new MongoBackend({
+  mongo: db,
+  ensureIndex: false  // Skip automatic index creation
+});
+```
+
+### Additional Indexes
+
+If you use **Agendash**, add this index for better dashboard performance:
+
+```javascript
+db.agendaJobs.createIndex({
+  "nextRunAt": -1,
+  "lastRunAt": -1,
+  "lastFinishedAt": -1
+}, { name: "agendash" })
+```
+
+If you have job definitions with thousands of instances, this index can improve lock queries:
+
+```javascript
+db.agendaJobs.createIndex({
+  "name": 1,
+  "disabled": 1,
+  "lockedAt": 1
+}, { name: "findAndLockDeadJobs" })
+```
+
+## Related Packages
+
+- [agenda](https://www.npmjs.com/package/agenda) - Core scheduler
+- [@agendajs/postgres-backend](https://www.npmjs.com/package/@agendajs/postgres-backend) - PostgreSQL backend with LISTEN/NOTIFY
+- [@agendajs/redis-backend](https://www.npmjs.com/package/@agendajs/redis-backend) - Redis backend with Pub/Sub
+
+## License
+
+MIT

package/dist/MongoBackend.d.ts

@@ -0,0 +1,48 @@
+import type { AgendaBackend, JobRepository, NotificationChannel } from 'agenda';
+import type { MongoBackendConfig } from './types.js';
+/**
+ * MongoDB backend for Agenda.
+ * Provides storage via MongoDB. Does not provide notifications (uses polling).
+ *
+ * @example
+ * ```typescript
+ * import { Agenda } from 'agenda';
+ * import { MongoBackend } from '@agendajs/mongo-backend';
+ *
+ * // Via connection string
+ * const backend = new MongoBackend({ address: 'mongodb://localhost/agenda' });
+ *
+ * // Via existing connection
+ * const backend = new MongoBackend({ mongo: existingDb });
+ *
+ * const agenda = new Agenda({ backend });
+ * ```
+ */
+export declare class MongoBackend implements AgendaBackend {
+    private config;
+    private _repository;
+    private _ownsConnection;
+    /**
+     * MongoDB does not provide a notification channel.
+     * For real-time notifications with MongoDB, use a separate notification
+     * channel like Redis pub/sub.
+     */
+    readonly notificationChannel: NotificationChannel | undefined;
+    constructor(config: MongoBackendConfig);
+    get repository(): JobRepository;
+    /**
+     * Whether this backend owns its database connection.
+     * True if created from address (connection string), false if mongo Db was passed in.
+     */
+    get ownsConnection(): boolean;
+    /**
+     * Connect to MongoDB and initialize the collection.
+     */
+    connect(): Promise<void>;
+    /**
+     * Disconnect from MongoDB.
+     * Only closes the connection if we created it (i.e., from connection string).
+     * If an existing Db instance was passed in, this is a no-op.
+     */
+    disconnect(): Promise<void>;
+}

package/dist/MongoBackend.js

@@ -0,0 +1,69 @@
+import { MongoJobRepository } from './MongoJobRepository.js';
+/**
+ * MongoDB backend for Agenda.
+ * Provides storage via MongoDB. Does not provide notifications (uses polling).
+ *
+ * @example
+ * ```typescript
+ * import { Agenda } from 'agenda';
+ * import { MongoBackend } from '@agendajs/mongo-backend';
+ *
+ * // Via connection string
+ * const backend = new MongoBackend({ address: 'mongodb://localhost/agenda' });
+ *
+ * // Via existing connection
+ * const backend = new MongoBackend({ mongo: existingDb });
+ *
+ * const agenda = new Agenda({ backend });
+ * ```
+ */
+export class MongoBackend {
+    config;
+    _repository;
+    _ownsConnection;
+    /**
+     * MongoDB does not provide a notification channel.
+     * For real-time notifications with MongoDB, use a separate notification
+     * channel like Redis pub/sub.
+     */
+    notificationChannel = undefined;
+    constructor(config) {
+        this.config = config;
+        // Determine if we own the connection (not passed in by user)
+        this._ownsConnection = !('mongo' in config);
+        this._repository = new MongoJobRepository({
+            ...('mongo' in config
+                ? { mongo: config.mongo, db: { collection: config.collection } }
+                : {
+                    db: { address: config.address, collection: config.collection, options: config.options }
+                }),
+            ensureIndex: config.ensureIndex,
+            sort: config.sort
+        });
+    }
+    get repository() {
+        return this._repository;
+    }
+    /**
+     * Whether this backend owns its database connection.
+     * True if created from address (connection string), false if mongo Db was passed in.
+     */
+    get ownsConnection() {
+        return this._ownsConnection;
+    }
+    /**
+     * Connect to MongoDB and initialize the collection.
+     */
+    async connect() {
+        await this._repository.connect();
+    }
+    /**
+     * Disconnect from MongoDB.
+     * Only closes the connection if we created it (i.e., from connection string).
+     * If an existing Db instance was passed in, this is a no-op.
+     */
+    async disconnect() {
+        await this._repository.disconnect();
+    }
+}
+//# sourceMappingURL=MongoBackend.js.map

package/dist/MongoBackend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MongoBackend.js","sourceRoot":"","sources":["../src/MongoBackend.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAG7D;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,OAAO,YAAY;IAWJ;IAVZ,WAAW,CAAqB;IAChC,eAAe,CAAU;IAEjC;;;;OAIG;IACM,mBAAmB,GAAoC,SAAS,CAAC;IAE1E,YAAoB,MAA0B;QAA1B,WAAM,GAAN,MAAM,CAAoB;QAC7C,6DAA6D;QAC7D,IAAI,CAAC,eAAe,GAAG,CAAC,CAAC,OAAO,IAAI,MAAM,CAAC,CAAC;QAC5C,IAAI,CAAC,WAAW,GAAG,IAAI,kBAAkB,CAAC;YACzC,GAAG,CAAC,OAAO,IAAI,MAAM;gBACpB,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,EAAE,EAAE,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,EAAE;gBAChE,CAAC,CAAC;oBACA,EAAE,EAAE,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE;iBACvF,CAAC;YACJ,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,IAAI,EAAE,MAAM,CAAC,IAAI;SACjB,CAAC,CAAC;IACJ,CAAC;IAED,IAAI,UAAU;QACb,OAAO,IAAI,CAAC,WAAW,CAAC;IACzB,CAAC;IAED;;;OAGG;IACH,IAAI,cAAc;QACjB,OAAO,IAAI,CAAC,eAAe,CAAC;IAC7B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO;QACZ,MAAM,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC;IAClC,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,UAAU;QACf,MAAM,IAAI,CAAC,WAAW,CAAC,UAAU,EAAE,CAAC;IACrC,CAAC;CACD"}

package/dist/MongoJobRepository.d.ts

@@ -0,0 +1,65 @@
+import { Collection, ObjectId } from 'mongodb';
+import type { JobParameters, JobId, JobsQueryOptions, JobsResult, JobsOverview, JobRepository, JobRepositoryOptions, RemoveJobsOptions } from 'agenda';
+import type { MongoJobRepositoryConfig } from './types.js';
+/**
+ * Internal MongoDB document type with ObjectId for _id
+ * This is what's actually stored in MongoDB, separate from the public JobParameters interface
+ */
+type MongoJobDocument = Omit<JobParameters, '_id'> & {
+    _id?: ObjectId;
+};
+/**
+ * @class
+ * MongoDB implementation of JobRepository
+ */
+export declare class MongoJobRepository implements JobRepository {
+    private connectOptions;
+    collection: Collection<MongoJobDocument>;
+    private mongoClient?;
+    private ownsConnection;
+    constructor(connectOptions: MongoJobRepositoryConfig);
+    private createConnection;
+    getJobById(id: string): Promise<JobParameters | null>;
+    /**
+     * Convert a SortDirection value to MongoDB's numeric sort direction
+     */
+    private toMongoSortDirection;
+    /**
+     * Convert generic sort options to MongoDB sort
+     */
+    private toMongoSort;
+    /**
+     * Query jobs with database-agnostic options.
+     * Handles state computation and filtering internally.
+     */
+    queryJobs(options?: JobsQueryOptions): Promise<JobsResult>;
+    /**
+     * Get overview statistics for jobs grouped by name.
+     * Returns counts of jobs in each state for each job name.
+     */
+    getJobsOverview(): Promise<JobsOverview[]>;
+    /**
+     * Get all distinct job names
+     */
+    getDistinctJobNames(): Promise<string[]>;
+    getQueueSize(): Promise<number>;
+    removeJobs(options: RemoveJobsOptions): Promise<number>;
+    unlockJob(job: JobParameters): Promise<void>;
+    /**
+     * Internal method to unlock jobs so that they can be re-run
+     */
+    unlockJobs(jobIds: (JobId | string)[]): Promise<void>;
+    lockJob(job: JobParameters, options: JobRepositoryOptions | undefined): Promise<JobParameters | undefined>;
+    getNextJobToRun(jobName: string, nextScanAt: Date, lockDeadline: Date, now: Date | undefined, options: JobRepositoryOptions | undefined): Promise<JobParameters | undefined>;
+    connect(): Promise<void>;
+    private database;
+    disconnect(): Promise<void>;
+    saveJobState(job: JobParameters, options: JobRepositoryOptions | undefined): Promise<void>;
+    /**
+     * Save a job to the database (insert or update)
+     * @param job Job parameters to save
+     * @returns The saved job parameters with ID
+     */
+    saveJob<DATA = unknown>(job: JobParameters<DATA>, options: JobRepositoryOptions | undefined): Promise<JobParameters<DATA>>;
+}
+export {};

package/dist/MongoJobRepository.js

@@ -0,0 +1,492 @@
+import assert from 'node:assert';
+import debug from 'debug';
+import { MongoClient, ObjectId } from 'mongodb';
+import { toJobId, computeJobState } from 'agenda';
+import { hasMongoProtocol } from './hasMongoProtocol.js';
+const log = debug('agenda:mongo:repository');
+/**
+ * Escape special regex characters in a string to treat it as literal text
+ */
+function escapeRegex(str) {
+    return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+function computeJobObj(job) {
+    return {
+        _id: toJobId(job._id.toHexString()),
+        name: job.name,
+        priority: job.priority,
+        nextRunAt: job.nextRunAt,
+        type: job.type,
+        data: job.data,
+        lockedAt: job.lockedAt,
+        lastFinishedAt: job.lastFinishedAt,
+        failedAt: job.failedAt || undefined,
+        failCount: job.failCount || undefined,
+        failReason: job.failReason || undefined,
+        repeatTimezone: job.repeatTimezone,
+        lastRunAt: job.lastRunAt,
+        repeatInterval: job.repeatInterval,
+        repeatAt: job.repeatAt,
+        disabled: job.disabled,
+        progress: job.progress,
+        unique: job.unique,
+        uniqueOpts: job.uniqueOpts,
+        lastModifiedBy: job.lastModifiedBy,
+        fork: job.fork
+    };
+}
+/**
+ * @class
+ * MongoDB implementation of JobRepository
+ */
+export class MongoJobRepository {
+    connectOptions;
+    collection;
+    mongoClient;
+    ownsConnection = false;
+    constructor(connectOptions) {
+        this.connectOptions = connectOptions;
+        this.connectOptions.sort = this.connectOptions.sort || { nextRunAt: 'asc', priority: 'desc' };
+        // Track if we own the connection (i.e., we created it from a connection string)
+        this.ownsConnection = !('mongo' in connectOptions);
+    }
+    async createConnection() {
+        const { connectOptions } = this;
+        if ('mongo' in connectOptions) {
+            log('using passed in mongo connection');
+            return connectOptions.mongo;
+        }
+        if ('db' in connectOptions && connectOptions.db) {
+            log('using database config', connectOptions);
+            return this.database(connectOptions.db.address, connectOptions.db.options);
+        }
+        throw new Error('invalid db config, or db config not found');
+    }
+    async getJobById(id) {
+        const doc = await this.collection.findOne({ _id: new ObjectId(id) });
+        if (!doc)
+            return null;
+        // Convert MongoDB ObjectId to JobId
+        return computeJobObj(doc);
+    }
+    /**
+     * Convert a SortDirection value to MongoDB's numeric sort direction
+     */
+    toMongoSortDirection(dir) {
+        return dir === 'asc' ? 1 : -1;
+    }
+    /**
+     * Convert generic sort options to MongoDB sort
+     */
+    toMongoSort(sort) {
+        if (!sort) {
+            return { nextRunAt: -1, lastRunAt: -1 };
+        }
+        const mongoSort = {};
+        if (sort.nextRunAt !== undefined)
+            mongoSort.nextRunAt = this.toMongoSortDirection(sort.nextRunAt);
+        if (sort.lastRunAt !== undefined)
+            mongoSort.lastRunAt = this.toMongoSortDirection(sort.lastRunAt);
+        if (sort.lastFinishedAt !== undefined)
+            mongoSort.lastFinishedAt = this.toMongoSortDirection(sort.lastFinishedAt);
+        if (sort.priority !== undefined)
+            mongoSort.priority = this.toMongoSortDirection(sort.priority);
+        if (sort.name !== undefined)
+            mongoSort.name = this.toMongoSortDirection(sort.name);
+        if (sort.data !== undefined)
+            mongoSort.data = this.toMongoSortDirection(sort.data);
+        return Object.keys(mongoSort).length > 0 ? mongoSort : { nextRunAt: -1, lastRunAt: -1 };
+    }
+    /**
+     * Query jobs with database-agnostic options.
+     * Handles state computation and filtering internally.
+     */
+    async queryJobs(options = {}) {
+        const { name, names, state, id, ids, search, data, includeDisabled = true, sort, skip = 0, limit = 0 } = options;
+        const now = new Date();
+        // Build MongoDB query from options
+        const query = {};
+        // Validate name is a string to prevent query operator injection
+        if (name && typeof name === 'string') {
+            query.name = name;
+        }
+        else if (names && Array.isArray(names) && names.length > 0) {
+            // Filter to only valid strings
+            const validNames = names.filter((n) => typeof n === 'string');
+            if (validNames.length > 0) {
+                query.name = { $in: validNames };
+            }
+        }
+        if (id && typeof id === 'string') {
+            try {
+                query._id = new ObjectId(id);
+            }
+            catch {
+                return { jobs: [], total: 0 };
+            }
+        }
+        else if (ids && Array.isArray(ids) && ids.length > 0) {
+            try {
+                const validIds = ids.filter((i) => typeof i === 'string');
+                if (validIds.length > 0) {
+                    query._id = { $in: validIds.map(i => new ObjectId(i)) };
+                }
+            }
+            catch {
+                return { jobs: [], total: 0 };
+            }
+        }
+        // Validate search is a string and escape regex metacharacters
+        if (search && typeof search === 'string' && search.length > 0) {
+            query.name = { $regex: escapeRegex(search), $options: 'i' };
+        }
+        if (data !== undefined) {
+            query.data = data;
+        }
+        if (!includeDisabled) {
+            query.disabled = { $ne: true };
+        }
+        // Fetch jobs
+        const allJobs = await this.collection.find(query).sort(this.toMongoSort(sort)).toArray();
+        // Compute states and filter by state if specified
+        let jobsWithState = allJobs
+            .map(job => {
+            const jobOb = computeJobObj(job);
+            return {
+                ...jobOb,
+                state: computeJobState(jobOb, now)
+            };
+        })
+            .filter(job => !state || job.state === state);
+        // Apply pagination after state filtering
+        const total = jobsWithState.length;
+        if (limit > 0) {
+            jobsWithState = jobsWithState.slice(skip, skip + limit);
+        }
+        else if (skip > 0) {
+            jobsWithState = jobsWithState.slice(skip);
+        }
+        return { jobs: jobsWithState, total };
+    }
+    /**
+     * Get overview statistics for jobs grouped by name.
+     * Returns counts of jobs in each state for each job name.
+     */
+    async getJobsOverview() {
+        const now = new Date();
+        const names = await this.getDistinctJobNames();
+        const overviews = await Promise.all(names.map(async (name) => {
+            const jobs = await this.collection.find({ name }).toArray();
+            const overview = {
+                name,
+                total: jobs.length,
+                running: 0,
+                scheduled: 0,
+                queued: 0,
+                completed: 0,
+                failed: 0,
+                repeating: 0
+            };
+            for (const job of jobs) {
+                const state = computeJobState(job, now);
+                overview[state]++;
+            }
+            return overview;
+        }));
+        return overviews;
+    }
+    /**
+     * Get all distinct job names
+     */
+    async getDistinctJobNames() {
+        return this.collection.distinct('name');
+    }
+    async getQueueSize() {
+        return this.collection.countDocuments({ nextRunAt: { $lt: new Date() } });
+    }
+    async removeJobs(options) {
+        const query = {};
+        if (options.id) {
+            const idStr = String(options.id);
+            try {
+                query._id = new ObjectId(idStr);
+            }
+            catch {
+                return 0;
+            }
+        }
+        else if (options.ids && Array.isArray(options.ids) && options.ids.length > 0) {
+            try {
+                query._id = { $in: options.ids.map(id => new ObjectId(String(id))) };
+            }
+            catch {
+                return 0;
+            }
+        }
+        // Validate name is a string to prevent query operator injection
+        if (options.name && typeof options.name === 'string') {
+            query.name = options.name;
+        }
+        else if (options.names && Array.isArray(options.names) && options.names.length > 0) {
+            const validNames = options.names.filter((n) => typeof n === 'string');
+            if (validNames.length > 0) {
+                query.name = { $in: validNames };
+            }
+        }
+        else if (options.notNames && Array.isArray(options.notNames) && options.notNames.length > 0) {
+            const validNotNames = options.notNames.filter((n) => typeof n === 'string');
+            if (validNotNames.length > 0) {
+                query.name = { $nin: validNotNames };
+            }
+        }
+        if (options.data !== undefined) {
+            query.data = options.data;
+        }
+        // If no criteria provided, don't delete anything
+        if (Object.keys(query).length === 0) {
+            log('removeJobs: skipping deleteMany without query', query);
+            return 0;
+        }
+        const result = await this.collection.deleteMany(query);
+        return result.deletedCount;
+    }
+    async unlockJob(job) {
+        if (!job._id)
+            return;
+        // only unlock jobs which are not currently processed (nextRunAt is not null)
+        await this.collection.updateOne({ _id: new ObjectId(job._id.toString()), nextRunAt: { $ne: null } }, { $unset: { lockedAt: true } });
+    }
+    /**
+     * Internal method to unlock jobs so that they can be re-run
+     */
+    async unlockJobs(jobIds) {
+        if (jobIds.length === 0)
+            return;
+        const objectIds = jobIds.map(id => new ObjectId(id.toString()));
+        // Unlock jobs by ID regardless of nextRunAt status.
+        // When a one-time job starts running, nextRunAt becomes null,
+        // but we still want to unlock it when stop() is called.
+        await this.collection.updateMany({ _id: { $in: objectIds } }, { $unset: { lockedAt: true } });
+    }
+    async lockJob(job, options) {
+        if (!job._id)
+            return undefined;
+        // Query to run against collection to see if we need to lock it
+        const criteria = {
+            _id: new ObjectId(job._id.toString()),
+            name: job.name,
+            lockedAt: null,
+            nextRunAt: job.nextRunAt,
+            disabled: { $ne: true }
+        };
+        // Update / options for the MongoDB query
+        const update = {
+            $set: { lockedAt: new Date(), lastModifiedBy: options?.lastModifiedBy }
+        };
+        const findOptions = {
+            returnDocument: 'after',
+            sort: this.connectOptions.sort
+        };
+        // Lock the job in MongoDB!
+        const result = await this.collection.findOneAndUpdate(criteria, update, findOptions);
+        if (!result)
+            return undefined;
+        // Convert MongoDB ObjectId to JobId
+        return computeJobObj(result);
+    }
+    async getNextJobToRun(jobName, nextScanAt, lockDeadline, now, options) {
+        const lockTime = now ?? new Date();
+        /**
+         * Query used to find job to run
+         */
+        const JOB_PROCESS_WHERE_QUERY = {
+            name: jobName,
+            disabled: { $ne: true },
+            $or: [
+                {
+                    lockedAt: { $eq: null },
+                    nextRunAt: { $lte: nextScanAt }
+                },
+                {
+                    lockedAt: { $lte: lockDeadline }
+                }
+            ]
+        };
+        /**
+         * Query used to set a job as locked
+         */
+        const JOB_PROCESS_SET_QUERY = {
+            $set: { lockedAt: lockTime, lastModifiedBy: options?.lastModifiedBy }
+        };
+        /**
+         * Query used to affect what gets returned
+         */
+        const JOB_RETURN_QUERY = {
+            returnDocument: 'after',
+            sort: this.connectOptions.sort
+        };
+        // Find ONE and ONLY ONE job and set the 'lockedAt' time so that job begins to be processed
+        const result = await this.collection.findOneAndUpdate(JOB_PROCESS_WHERE_QUERY, JOB_PROCESS_SET_QUERY, JOB_RETURN_QUERY);
+        if (!result)
+            return undefined;
+        // Convert MongoDB ObjectId to JobId
+        return computeJobObj(result);
+    }
+    async connect() {
+        const db = await this.createConnection();
+        log('successful connection to MongoDB', db.options);
+        const collection = this.connectOptions.db?.collection || 'agendaJobs';
+        this.collection = db.collection(collection);
+        if (log.enabled) {
+            log(`connected with collection: ${collection}, collection size: ${typeof this.collection.estimatedDocumentCount === 'function'
+                ? await this.collection.estimatedDocumentCount()
+                : '?'}`);
+        }
+        if (this.connectOptions.ensureIndex ?? true) {
+            log('attempting index creation');
+            try {
+                const result = await this.collection.createIndex({
+                    name: 1,
+                    ...this.connectOptions.sort,
+                    priority: -1,
+                    lockedAt: 1,
+                    nextRunAt: 1,
+                    disabled: 1
+                }, { name: 'findAndLockNextJobIndex' });
+                log('index succesfully created', result);
+            }
+            catch (error) {
+                log('db index creation failed', error);
+                throw error;
+            }
+        }
+    }
+    async database(url, options) {
+        let connectionString = url;
+        if (!hasMongoProtocol(connectionString)) {
+            connectionString = `mongodb://${connectionString}`;
+        }
+        this.mongoClient = await MongoClient.connect(connectionString, {
+            ...options
+        });
+        return this.mongoClient.db();
+    }
+    async disconnect() {
+        if (this.ownsConnection && this.mongoClient) {
+            log('closing owned MongoDB connection');
+            await this.mongoClient.close();
+            this.mongoClient = undefined;
+        }
+    }
+    async saveJobState(job, options) {
+        if (!job._id) {
+            throw new Error('Cannot save job state without job ID');
+        }
+        const id = new ObjectId(job._id.toString());
+        const $set = {
+            lockedAt: (job.lockedAt && new Date(job.lockedAt)) || undefined,
+            nextRunAt: (job.nextRunAt && new Date(job.nextRunAt)) || undefined,
+            lastRunAt: (job.lastRunAt && new Date(job.lastRunAt)) || undefined,
+            progress: job.progress,
+            failReason: job.failReason,
+            failCount: job.failCount,
+            failedAt: job.failedAt && new Date(job.failedAt),
+            lastFinishedAt: (job.lastFinishedAt && new Date(job.lastFinishedAt)) || undefined,
+            lastModifiedBy: options?.lastModifiedBy
+        };
+        log('[job %s] save job state: \n%O', job._id, $set);
+        const result = await this.collection.updateOne({ _id: id, name: job.name }, {
+            $set
+        });
+        if (!result.acknowledged || result.matchedCount !== 1) {
+            throw new Error(`job ${job._id} (name: ${job.name}) cannot be updated in the database, maybe it does not exist anymore?`);
+        }
+    }
+    /**
+     * Save a job to the database (insert or update)
+     * @param job Job parameters to save
+     * @returns The saved job parameters with ID
+     */
+    async saveJob(job, options) {
+        try {
+            log('attempting to save a job');
+            // Extract the ID and unique fields (not persisted directly)
+            const { _id, unique, uniqueOpts, ...props } = job;
+            // Add lastModifiedBy
+            const propsWithModifier = {
+                ...props,
+                lastModifiedBy: options?.lastModifiedBy
+            };
+            log('[job %s] set job props: \n%O', _id, propsWithModifier);
+            // Grab current time and set default query options for MongoDB
+            const now = new Date();
+            const protect = {};
+            let update = { $set: propsWithModifier };
+            log('current time stored as %s', now.toISOString());
+            // If the job already had an ID, then update the properties of the job
+            if (_id) {
+                log('job already has _id, calling findOneAndUpdate() using _id as query');
+                const result = await this.collection.findOneAndUpdate({ _id: new ObjectId(_id.toString()), name: props.name }, update, { returnDocument: 'after' });
+                if (!result) {
+                    // Job was removed, return original data unchanged
+                    log('job %s was not found for update, returning original data', _id);
+                    return job;
+                }
+                return computeJobObj(result);
+            }
+            if (props.type === 'single') {
+                // Job type set to 'single' so...
+                log('job with type of "single" found');
+                // If the nextRunAt time is older than the current time, "protect" that property
+                if (props.nextRunAt && props.nextRunAt <= now) {
+                    log('job has a scheduled nextRunAt time, protecting that field from upsert');
+                    protect.nextRunAt = props.nextRunAt;
+                    delete propsWithModifier.nextRunAt;
+                }
+                // If we have things to protect, set them in MongoDB using $setOnInsert
+                if (Object.keys(protect).length > 0) {
+                    update.$setOnInsert = protect;
+                }
+                // Try an upsert - ensures only one job of this name exists
+                log(`calling findOneAndUpdate(${props.name}) with job name and type of "single" as query`);
+                const result = await this.collection.findOneAndUpdate({
+                    name: props.name,
+                    type: 'single'
+                }, update, {
+                    upsert: true,
+                    returnDocument: 'after'
+                });
+                log(`findOneAndUpdate(${props.name}) with type "single" completed`);
+                assert(result, 'findOneAndUpdate with upsert should always return a document');
+                return computeJobObj(result);
+            }
+            if (unique) {
+                // Upsert based on the 'unique' query object
+                const query = { ...unique };
+                query.name = props.name;
+                if (uniqueOpts?.insertOnly) {
+                    update = { $setOnInsert: propsWithModifier };
+                }
+                log('calling findOneAndUpdate() with unique object as query: \n%O', query);
+                const result = await this.collection.findOneAndUpdate(query, update, {
+                    upsert: true,
+                    returnDocument: 'after'
+                });
+                assert(result, 'findOneAndUpdate with upsert should always return a document');
+                return computeJobObj(result);
+            }
+            // Insert new job
+            log('using default behavior, inserting new job via insertOne() with props that were set: \n%O', propsWithModifier);
+            const result = await this.collection.insertOne(propsWithModifier);
+            return computeJobObj({
+                _id: result.insertedId,
+                ...propsWithModifier
+            });
+        }
+        catch (error) {
+            log('saveJob() received an error, job was not updated/created');
+            throw error;
+        }
+    }
+}
+//# sourceMappingURL=MongoJobRepository.js.map

package/dist/MongoJobRepository.js.map

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

package/dist/hasMongoProtocol.d.ts

@@ -0,0 +1 @@
+export declare const hasMongoProtocol: (url: string) => boolean;

package/dist/hasMongoProtocol.js

@@ -0,0 +1,2 @@
+export const hasMongoProtocol = (url) => /mongodb(?:\+srv)?:\/\/.*/.test(url);
+//# sourceMappingURL=hasMongoProtocol.js.map

package/dist/hasMongoProtocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hasMongoProtocol.js","sourceRoot":"","sources":["../src/hasMongoProtocol.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,GAAW,EAAW,EAAE,CAAC,0BAA0B,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,36 @@
+/**
+ * @agendajs/mongo-backend
+ *
+ * MongoDB backend for Agenda job scheduler.
+ *
+ * @example
+ * ```typescript
+ * import { Agenda } from 'agenda';
+ * import { MongoBackend } from '@agendajs/mongo-backend';
+ *
+ * // Create agenda with MongoDB backend
+ * const agenda = new Agenda({
+ *   backend: new MongoBackend({
+ *     address: 'mongodb://localhost/agenda'
+ *   })
+ * });
+ *
+ * // Or with existing connection
+ * const agenda = new Agenda({
+ *   backend: new MongoBackend({ mongo: existingDb })
+ * });
+ *
+ * // Define and run jobs
+ * agenda.define('myJob', async (job) => {
+ *   console.log('Running job:', job.attrs.name);
+ * });
+ *
+ * await agenda.start();
+ * await agenda.every('5 minutes', 'myJob');
+ * ```
+ */
+export { MongoBackend } from './MongoBackend.js';
+export { MongoJobRepository } from './MongoJobRepository.js';
+export type { MongoBackendConfig, MongoJobRepositoryConfig, MongoDbConfig } from './types.js';
+export type { Db, MongoClientOptions } from 'mongodb';
+export { MongoClient, ObjectId } from 'mongodb';

package/dist/index.js

@@ -0,0 +1,35 @@
+/**
+ * @agendajs/mongo-backend
+ *
+ * MongoDB backend for Agenda job scheduler.
+ *
+ * @example
+ * ```typescript
+ * import { Agenda } from 'agenda';
+ * import { MongoBackend } from '@agendajs/mongo-backend';
+ *
+ * // Create agenda with MongoDB backend
+ * const agenda = new Agenda({
+ *   backend: new MongoBackend({
+ *     address: 'mongodb://localhost/agenda'
+ *   })
+ * });
+ *
+ * // Or with existing connection
+ * const agenda = new Agenda({
+ *   backend: new MongoBackend({ mongo: existingDb })
+ * });
+ *
+ * // Define and run jobs
+ * agenda.define('myJob', async (job) => {
+ *   console.log('Running job:', job.attrs.name);
+ * });
+ *
+ * await agenda.start();
+ * await agenda.every('5 minutes', 'myJob');
+ * ```
+ */
+export { MongoBackend } from './MongoBackend.js';
+export { MongoJobRepository } from './MongoJobRepository.js';
+export { MongoClient, ObjectId } from 'mongodb';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAM7D,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC"}

package/dist/testing.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Test utilities for @agendajs/mongo-backend
+ *
+ * @example
+ * ```typescript
+ * import { mockMongo } from '@agendajs/mongo-backend/testing';
+ *
+ * const { db, disconnect } = await mockMongo();
+ * // Use db for testing
+ * await disconnect();
+ * ```
+ */
+import { Db, MongoClient } from 'mongodb';
+export interface IMockMongo {
+    disconnect: () => Promise<void>;
+    mongo: MongoClient;
+    uri: string;
+    db: Db;
+}
+/**
+ * Create a mock MongoDB connection for testing.
+ * Requires MONGO_URI environment variable to be set (usually by mongodb-memory-server).
+ */
+export declare function mockMongo(): Promise<IMockMongo>;
+export type { Db, MongoClient } from 'mongodb';

package/dist/testing.js

@@ -0,0 +1,45 @@
+/**
+ * Test utilities for @agendajs/mongo-backend
+ *
+ * @example
+ * ```typescript
+ * import { mockMongo } from '@agendajs/mongo-backend/testing';
+ *
+ * const { db, disconnect } = await mockMongo();
+ * // Use db for testing
+ * await disconnect();
+ * ```
+ */
+import { MongoClient } from 'mongodb';
+import debug from 'debug';
+import { randomUUID } from 'crypto';
+const log = debug('agenda:mock-mongodb');
+/**
+ * Create a mock MongoDB connection for testing.
+ * Requires MONGO_URI environment variable to be set (usually by mongodb-memory-server).
+ */
+export async function mockMongo() {
+    const baseUri = process.env.MONGO_URI;
+    if (!baseUri) {
+        throw new Error('MONGO_URI not set. Ensure global setup is configured.');
+    }
+    // Use unique database per test suite to avoid interference
+    const dbName = `agenda_test_${randomUUID().replace(/-/g, '')}`;
+    // Build URI with database name (ensure single slash before db name)
+    const uri = `${baseUri.replace(/\/$/, '')}/${dbName}`;
+    log('connecting to mongod with db', dbName);
+    const mongo = await MongoClient.connect(uri);
+    const db = mongo.db(dbName);
+    return {
+        uri,
+        db,
+        mongo,
+        disconnect: async () => {
+            // Drop the test database to clean up
+            await db.dropDatabase();
+            await mongo.close();
+            log('mongo client closed, db dropped:', dbName);
+        }
+    };
+}
+//# sourceMappingURL=testing.js.map

package/dist/testing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.js","sourceRoot":"","sources":["../src/testing.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAM,WAAW,EAAE,MAAM,SAAS,CAAC;AAC1C,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAEpC,MAAM,GAAG,GAAG,KAAK,CAAC,qBAAqB,CAAC,CAAC;AASzC;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS;IAC9B,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC;IACtC,IAAI,CAAC,OAAO,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;IAC1E,CAAC;IAED,2DAA2D;IAC3D,MAAM,MAAM,GAAG,eAAe,UAAU,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC;IAC/D,oEAAoE;IACpE,MAAM,GAAG,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,MAAM,EAAE,CAAC;IACtD,GAAG,CAAC,8BAA8B,EAAE,MAAM,CAAC,CAAC;IAC5C,MAAM,KAAK,GAAG,MAAM,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC7C,MAAM,EAAE,GAAG,KAAK,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC;IAE5B,OAAO;QACN,GAAG;QACH,EAAE;QACF,KAAK;QACL,UAAU,EAAE,KAAK,IAAI,EAAE;YACtB,qCAAqC;YACrC,MAAM,EAAE,CAAC,YAAY,EAAE,CAAC;YACxB,MAAM,KAAK,CAAC,KAAK,EAAE,CAAC;YACpB,GAAG,CAAC,kCAAkC,EAAE,MAAM,CAAC,CAAC;QACjD,CAAC;KACD,CAAC;AACH,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,50 @@
+import type { Db, MongoClientOptions } from 'mongodb';
+import type { SortDirection } from 'agenda';
+/**
+ * Configuration options for MongoBackend
+ */
+export type MongoConnectionConfig = {
+    /** Existing MongoDB database instance */
+    mongo: Db;
+} | {
+    /** MongoDB connection string */
+    address: string;
+    /** MongoDB client options */
+    options?: MongoClientOptions;
+};
+export type MongoBackendConfig = MongoConnectionConfig & {
+    /** Collection name for jobs (default: 'agendaJobs') */
+    collection?: string;
+    /** Whether to create indexes on connect (default: true) */
+    ensureIndex?: boolean;
+    /** Sort order for job queries */
+    sort?: {
+        [key: string]: SortDirection;
+    };
+};
+/**
+ * Database configuration options used internally by the repository
+ */
+export interface MongoDbConfig {
+    ensureIndex?: boolean;
+    sort?: {
+        [key: string]: SortDirection;
+    };
+}
+/**
+ * Configuration options for MongoJobRepository
+ */
+export type MongoJobRepositoryConfig = MongoDbConfig & ({
+    /** MongoDB connection string */
+    db: {
+        address: string;
+        collection?: string;
+        options?: MongoClientOptions;
+    };
+} | {
+    /** Existing MongoDB database instance */
+    mongo: Db;
+    db?: {
+        collection?: string;
+    };
+});

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "@agendajs/mongo-backend",
+  "version": "1.0.0-alpha.0",
+  "description": "MongoDB backend for Agenda job scheduler",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./testing": {
+      "types": "./dist/testing.d.ts",
+      "import": "./dist/testing.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git://github.com/agenda/agenda"
+  },
+  "keywords": [
+    "agenda",
+    "job",
+    "scheduler",
+    "mongodb",
+    "mongo"
+  ],
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/agenda/agenda/issues"
+  },
+  "dependencies": {
+    "debug": "^4.4.0",
+    "mongodb": "^6.12.0"
+  },
+  "peerDependencies": {
+    "agenda": "6.0.0-alpha.0"
+  },
+  "devDependencies": {
+    "@types/debug": "^4.1.12",
+    "@types/node": "^22.0.0",
+    "@vitest/coverage-v8": "^3.1.0",
+    "mongodb-memory-server": "^10.0.0",
+    "tsx": "^4.21.0",
+    "vitest": "^3.1.0",
+    "agenda": "6.0.0-alpha.0"
+  },
+  "scripts": {
+    "build": "tsc -b",
+    "typecheck": "tsc -b && tsc -p tsconfig.test.json",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "test:debug": "DEBUG=agenda:**,-agenda:internal:** vitest run"
+  }
+}