mongo-job-scheduler 0.1.4 → 0.1.6

package/README.md

@@ -65,16 +65,14 @@ await scheduler.start();
 ## Cron with Timezone
 
 ```typescript
-await scheduler.schedule(
-  "daily-report",
-  { type: "report" }, // payload
-  {
-    repeat: {
-      cron: "0 9 * * *",
-      timezone: "Asia/Kolkata", // default is UTC
-    },
-  }
-);
+await scheduler.schedule({
+  name: "daily-report",
+  // data: { type: "report" }, // optional payload
+  repeat: {
+    cron: "0 9 * * *",
+    timezone: "Asia/Kolkata", // default is UTC
+  },
+});
 ```
 
 ## Interval Scheduling
@@ -116,6 +114,18 @@ await scheduler.cancel(jobId);
 const job = await scheduler.getJob(jobId);
 ```
 
+## Job Persistence & Updates
+
+Update job `data`, reschedule, or modify configuration safely.
+
+```typescript
+await scheduler.updateJob(jobId, {
+  data: { page: 2 },
+  nextRunAt: new Date(Date.now() + 60000), // delay by 1 min
+  repeat: { every: 60000 }, // Change to run every minute
+});
+```
+
 ## Bulk Scheduling
 
 For high-performance ingestion, use `scheduleBulk` to insert multiple jobs in a single database operation:

package/dist/core/scheduler.d.ts

@@ -1,5 +1,5 @@
 import { SchedulerEventMap } from "../types/events";
-import { JobStore } from "../store";
+import { JobStore, JobUpdates } from "../store";
 import { Job } from "../types/job";
 import { ScheduleOptions } from "../types/schedule";
 export interface SchedulerOptions {
@@ -33,6 +33,10 @@ export declare class Scheduler {
      * Get a job by ID
      */
     getJob(jobId: unknown): Promise<Job | null>;
+    /**
+     * Update job data or schedule
+     */
+    updateJob(jobId: unknown, updates: JobUpdates): Promise<void>;
     /**
      * Cancel a job
      */

package/dist/core/scheduler.js

@@ -94,6 +94,15 @@ class Scheduler {
         }
         return this.store.findById(jobId);
     }
+    /**
+     * Update job data or schedule
+     */
+    async updateJob(jobId, updates) {
+        if (!this.store) {
+            throw new Error("Scheduler has no JobStore configured");
+        }
+        await this.store.update(jobId, updates);
+    }
     /**
      * Cancel a job
      */

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

@@ -1,5 +1,5 @@
 import { Job } from "../types/job";
-import { JobStore } from "./job-store";
+import { JobStore, JobUpdates } from "./job-store";
 export declare class InMemoryJobStore implements JobStore {
     private jobs;
     private mutex;
@@ -23,4 +23,5 @@ export declare class InMemoryJobStore implements JobStore {
     cancel(jobId: unknown): Promise<void>;
     findById(jobId: unknown): Promise<Job | null>;
     renewLock(jobId: unknown, workerId: string): Promise<void>;
+    update(jobId: unknown, updates: JobUpdates): Promise<void>;
 }

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

@@ -131,5 +131,23 @@ class InMemoryJobStore {
             throw new Error("Job lock lost or owner changed");
         }
     }
+    async update(jobId, updates) {
+        const job = this.jobs.get(String(jobId));
+        if (!job)
+            throw new store_errors_1.JobNotFoundError();
+        if (updates.data !== undefined) {
+            job.data = updates.data;
+        }
+        if (updates.nextRunAt !== undefined) {
+            job.nextRunAt = updates.nextRunAt;
+        }
+        if (updates.retry !== undefined) {
+            job.retry = updates.retry;
+        }
+        if (updates.repeat !== undefined) {
+            job.repeat = updates.repeat;
+        }
+        job.updatedAt = new Date();
+    }
 }
 exports.InMemoryJobStore = InMemoryJobStore;

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

@@ -51,4 +51,16 @@ export interface JobStore {
      * Renew the lock for a running job (heartbeat)
      */
     renewLock(jobId: unknown, workerId: string): Promise<void>;
+    /**
+     * Update job properties (data persistence)
+     */
+    update(jobId: unknown, updates: JobUpdates): Promise<void>;
+}
+import { RetryOptions } from "../types/retry";
+import { RepeatOptions } from "../types/repeat";
+export interface JobUpdates {
+    data?: unknown;
+    nextRunAt?: Date;
+    retry?: RetryOptions;
+    repeat?: RepeatOptions;
 }

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

@@ -1,5 +1,5 @@
 import { Db, ObjectId } from "mongodb";
-import { JobStore } from "../job-store";
+import { JobStore, JobUpdates } from "../job-store";
 import { Job } from "../../types/job";
 export interface MongoJobStoreOptions {
     collectionName?: string;
@@ -29,4 +29,5 @@ export declare class MongoJobStore implements JobStore {
         lockTimeoutMs: number;
     }): Promise<number>;
     renewLock(id: ObjectId, workerId: string): Promise<void>;
+    update(id: ObjectId, updates: JobUpdates): Promise<void>;
 }

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

@@ -181,5 +181,19 @@ class MongoJobStore {
             throw new Error("Job lock lost or owner changed");
         }
     }
+    async update(id, updates) {
+        if (Object.keys(updates).length === 0)
+            return;
+        const $set = { updatedAt: new Date() };
+        if (updates.data !== undefined)
+            $set.data = updates.data;
+        if (updates.nextRunAt !== undefined)
+            $set.nextRunAt = updates.nextRunAt;
+        if (updates.retry !== undefined)
+            $set.retry = updates.retry;
+        if (updates.repeat !== undefined)
+            $set.repeat = updates.repeat;
+        await this.collection.updateOne({ _id: id }, { $set });
+    }
 }
 exports.MongoJobStore = MongoJobStore;

package/dist/types/job.d.ts

@@ -4,7 +4,7 @@ import { RepeatOptions } from "./repeat";
 export interface Job<Data = unknown> {
     _id?: unknown;
     name: string;
-    data: Data;
+    data?: Data;
     status: JobStatus;
     nextRunAt: Date;
     lastRunAt?: Date;

package/dist/types/schedule.d.ts

@@ -2,7 +2,7 @@ import { RetryOptions } from "./retry";
 import { RepeatOptions } from "./repeat";
 export interface ScheduleOptions<T = unknown> {
     name: string;
-    data: T;
+    data?: T;
     /**
      * When the job should first run.
      * Defaults to now.

package/package.json

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