mongo-job-scheduler 0.1.17 → 1.0.1

package/README.md

@@ -23,6 +23,10 @@ A production-grade MongoDB-backed job scheduler for Node.js with distributed loc
 
 ---
 
+> 🚀 **Ready to start?** Check out the [Complete Example Repository](https://github.com/darshanpatel14/mongo-job-scheduler-example) which demonstrates all features (Priority, Retries, Cron, UI) in a production-ready Express app with Docker.
+
+---
+
 ## Quick Start
 
 ### Requirements
@@ -43,6 +47,7 @@ For a visual web dashboard to manage and monitor your jobs, check out:
 
 - **NPM**: [`mongo-scheduler-ui`](https://www.npmjs.com/package/mongo-scheduler-ui)
 - **GitHub**: [mongo-scheduler-ui](https://github.com/darshanpatel14/mongo-job-scheduler-ui)
+- **Full Example**: [mongo-job-scheduler-example](https://github.com/darshanpatel14/mongo-job-scheduler-example) (Backend + UI + Docker)
 - **API Server**: [mongo-job-scheduler-api](https://github.com/darshanpatel14/mongo-job-scheduler-api)
 
 ### Basic Usage

package/dist/store/in-memory-job-store.d.ts

@@ -12,7 +12,7 @@ export declare class InMemoryJobStore implements JobStore {
         workerId: string;
         lockTimeoutMs: number;
     }): Promise<Job | null>;
-    markCompleted(jobId: unknown): Promise<void>;
+    markCompleted(jobId: unknown, workerId: string): Promise<void>;
     markFailed(jobId: unknown, error: string): Promise<void>;
     reschedule(jobId: unknown, nextRunAt: Date, updates?: {
         attempts?: number;

package/dist/store/in-memory-job-store.js

@@ -78,13 +78,19 @@ class InMemoryJobStore {
             release();
         }
     }
-    async markCompleted(jobId) {
+    async markCompleted(jobId, workerId) {
         const job = this.jobs.get(String(jobId));
         if (!job)
             throw new store_errors_1.JobNotFoundError();
+        if (job.lockedBy !== workerId || job.status !== "running") {
+            throw new store_errors_1.JobOwnershipError(`Cannot complete job ${jobId}: ownership lost (expected workerId: ${workerId})`);
+        }
         job.status = "completed";
         job.lastRunAt = new Date();
         job.updatedAt = new Date();
+        job.lockedAt = undefined;
+        job.lockedBy = undefined;
+        job.lockUntil = undefined;
     }
     async markFailed(jobId, error) {
         const job = this.jobs.get(String(jobId));

package/dist/store/job-store.d.ts

@@ -19,9 +19,9 @@ export interface JobStore {
         lockTimeoutMs: number;
     }): Promise<Job | null>;
     /**
-     * Mark job as completed
+     * Mark job as completed (requires ownership verification)
      */
-    markCompleted(jobId: unknown): Promise<void>;
+    markCompleted(jobId: unknown, workerId: string): Promise<void>;
     /**
      * Mark job as failed
      */

package/dist/store/mongo/mongo-job-store.d.ts

@@ -18,7 +18,7 @@ export declare class MongoJobStore implements JobStore {
         workerId: string;
         lockTimeoutMs: number;
     }): Promise<Job | null>;
-    markCompleted(id: ObjectId): Promise<void>;
+    markCompleted(id: ObjectId, workerId: string): Promise<void>;
     markFailed(id: ObjectId, error: string): Promise<void>;
     reschedule(id: ObjectId, nextRunAt: Date, updates?: {
         attempts?: number;

package/dist/store/mongo/mongo-job-store.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.MongoJobStore = void 0;
+const store_errors_1 = require("../store-errors");
 class MongoJobStore {
     constructor(db, options = {}) {
         this.collection = db.collection(options.collectionName ?? "scheduler_jobs");
@@ -210,8 +211,8 @@ class MongoJobStore {
         }
         return null;
     }
-    async markCompleted(id) {
-        await this.collection.updateOne({ _id: id }, {
+    async markCompleted(id, workerId) {
+        const result = await this.collection.updateOne({ _id: id, lockedBy: workerId, status: "running" }, {
             $set: {
                 status: "completed",
                 updatedAt: new Date(),
@@ -222,6 +223,9 @@ class MongoJobStore {
                 lockUntil: "",
             },
         });
+        if (result.matchedCount === 0) {
+            throw new store_errors_1.JobOwnershipError(`Cannot complete job ${id}: ownership lost (expected workerId: ${workerId})`);
+        }
     }
     async markFailed(id, error) {
         await this.collection.updateOne({ _id: id }, {

package/dist/store/store-errors.d.ts

@@ -4,3 +4,6 @@ export declare class JobNotFoundError extends Error {
 export declare class JobLockError extends Error {
     constructor(message?: string);
 }
+export declare class JobOwnershipError extends Error {
+    constructor(message?: string);
+}

package/dist/store/store-errors.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.JobLockError = exports.JobNotFoundError = void 0;
+exports.JobOwnershipError = exports.JobLockError = exports.JobNotFoundError = void 0;
 class JobNotFoundError extends Error {
     constructor(message = "Job not found") {
         super(message);
@@ -15,3 +15,10 @@ class JobLockError extends Error {
     }
 }
 exports.JobLockError = JobLockError;
+class JobOwnershipError extends Error {
+    constructor(message = "Job ownership lost") {
+        super(message);
+        this.name = "JobOwnershipError";
+    }
+}
+exports.JobOwnershipError = JobOwnershipError;

package/dist/worker/worker.js

@@ -127,7 +127,7 @@ class Worker {
                 await this.store.reschedule(job._id, next);
             }
             if (!job.repeat) {
-                await this.store.markCompleted(job._id);
+                await this.store.markCompleted(job._id, this.workerId);
                 this.emitter.emitSafe("job:success", job);
             }
             this.emitter.emitSafe("job:complete", job);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mongo-job-scheduler",
-  "version": "0.1.17",
+  "version": "1.0.1",
   "description": "Production-grade MongoDB-backed job scheduler with retries, cron, timezone support, and crash recovery",
   "license": "MIT",
   "author": "Darshan Bhut",