pnscheduler 0.0.1 → 0.2.0

package/README.md

@@ -2,6 +2,9 @@
 
 Persistent NodeJS Scheduler - A simple job scheduler for Node.js applications, with Postgres-based persistence.
 
+![npm-version](https://img.shields.io/npm/v/pnscheduler)
+![Build](https://img.shields.io/github/actions/workflow/status/nilmus/pnscheduler/test.yml)
+
 ## Installation
 
 ```bash
@@ -78,7 +81,7 @@ await scheduler.scheduleJob("parameterized-job", new Date(2084, 0, 1), {
 });
 
 // With grace period (5 minutes)
-await scheduler.scheduleJob("simple-job", new Date(2084, 0, 1), null, 300_000);
+await scheduler.scheduleJob("simple-job", new Date(2084, 0, 1), null, 300);
 ```
 
 ### Job Management
@@ -103,8 +106,8 @@ console.log(dueJobs);
 ### Scheduler Control
 
 ```typescript
-// Start the scheduler (30s check interval)
-scheduler.start(3000);
+// Adjust check frequency (defaults to 1 second)
+scheduler.start(30); // check every 30 seconds
 
 // Stop the scheduler
 scheduler.stop();

package/dist/db/migration.js

@@ -13,6 +13,7 @@ export const migrationQuery = db.query(`
         grace_period INTEGER,
         params JSONB,
         status pnscheduler.status_type DEFAULT 'pending' NOT NULL,
+        status_updated_at TIMESTAMPTZ,
         created_at TIMESTAMPTZ DEFAULT NOW()
   )
   `);

package/dist/jobs.d.ts

@@ -6,6 +6,7 @@ type JobRow = {
     grace_period: number | null;
     params: any | null;
     status: JobStatus;
+    status_updated_at: Date | null;
 };
 export declare class Job {
     id: number;
@@ -14,6 +15,7 @@ export declare class Job {
     gracePeriod: number | null;
     params: any;
     status: JobStatus;
-    constructor({ id, name, execution_date, grace_period, params, status, }: JobRow);
+    statusUpdatedAt: Date | null;
+    constructor({ id, name, execution_date, grace_period, params, status, status_updated_at, }: JobRow);
 }
 export {};

package/dist/jobs.js

@@ -14,6 +14,9 @@ function validateJobRow(row) {
     if (typeof row.status !== "string" ||
         !["pending", "executed", "failed", "skipped"].includes(row.status))
         throw new Error(`Invalid job row column: status - ${row.status}`);
+    if (row.status_updated_at !== null &&
+        !(row.status_updated_at instanceof Date))
+        throw new Error(`Invalid job row column: status_updated_at - ${row.status_updated_at}`);
     return row;
 }
 export class Job {
@@ -23,7 +26,8 @@ export class Job {
     gracePeriod;
     params;
     status;
-    constructor({ id, name, execution_date, grace_period, params, status, }) {
+    statusUpdatedAt;
+    constructor({ id, name, execution_date, grace_period, params, status, status_updated_at, }) {
         const row = validateJobRow({
             id,
             name,
@@ -31,6 +35,7 @@ export class Job {
             grace_period,
             params,
             status,
+            status_updated_at,
         });
         this.id = row.id;
         this.name = row.name;
@@ -38,5 +43,6 @@ export class Job {
         this.gracePeriod = row.grace_period;
         this.params = row.params;
         this.status = row.status;
+        this.statusUpdatedAt = row.status_updated_at;
     }
 }

package/dist/scheduler.js

@@ -59,10 +59,7 @@ class PNScheduler {
     }
     async #markJobStatusAs(job, status) {
         this.#log(`Marking job "${job.name}" with id ${job.id} as ${status}...`);
-        await db.query(`UPDATE pnscheduler.jobs SET status = $1 WHERE id = $2`, [
-            status,
-            job.id,
-        ]);
+        await db.query(`UPDATE pnscheduler.jobs SET status = $1, status_updated_at = NOW() WHERE id = $2`, [status, job.id]);
     }
     async findDueJobs() {
         this.#log("Finding due jobs...");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pnscheduler",
-  "version": "0.0.1",
+  "version": "0.2.0",
   "description": "Persistent NodeJS Scheduler - A simple job scheduler for Node.js applications, with Postgres-based persistence.",
   "keywords": [
     "node",