pg-boss 7.1.0 → 7.2.0

package/README.md

@@ -38,6 +38,7 @@ pg-boss relies on [SKIP LOCKED](http://blog.2ndquadrant.com/what-is-select-skip-
 This will likely cater the most to teams already familiar with the simplicity of relational database semantics and operations (SQL, querying, and backups). It will be especially useful to those already relying on PostgreSQL that want to limit how many systems are required to monitor and support in their architecture.
 
 ## Features
+* Exactly-once job delivery
 * Backpressure-compatible polling workers
 * Cron scheduling
 * Pub/sub API for fan-out queue relationships

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pg-boss",
-  "version": "7.1.0",
+  "version": "7.2.0",
   "description": "Queueing jobs in Node.js using PostgreSQL like a boss",
   "main": "./src/index.js",
   "engines": {

package/src/manager.js

@@ -56,6 +56,7 @@ class Manager extends EventEmitter {
     this.insertJobsCommand = plans.insertJobs(config.schema)
     this.completeJobsCommand = plans.completeJobs(config.schema)
     this.cancelJobsCommand = plans.cancelJobs(config.schema)
+    this.resumeJobsCommand = plans.resumeJobs(config.schema)
     this.failJobsCommand = plans.failJobs(config.schema)
     this.getJobByIdCommand = plans.getJobById(config.schema)
     this.getArchivedJobByIdCommand = plans.getArchivedJobById(config.schema)
@@ -67,6 +68,7 @@ class Manager extends EventEmitter {
     this.functions = [
       this.complete,
       this.cancel,
+      this.resume,
       this.fail,
       this.fetch,
       this.fetchCompleted,
@@ -541,6 +543,12 @@ class Manager extends EventEmitter {
     return this.mapCompletionResponse(ids, result)
   }
 
+  async resume (id) {
+    const ids = this.mapCompletionIdArg(id, 'resume')
+    const result = await this.db.executeSql(this.resumeJobsCommand, [ids])
+    return this.mapCompletionResponse(ids, result)
+  }
+
   async deleteQueue (queue, options) {
     assert(queue, 'Missing queue name argument')
     const sql = plans.deleteQueue(this.config.schema, options)

package/src/plans.js

@@ -26,6 +26,7 @@ module.exports = {
   fetchNextJob,
   completeJobs,
   cancelJobs,
+  resumeJobs,
   failJobs,
   insertJob,
   insertJobs,
@@ -497,6 +498,19 @@ function cancelJobs (schema) {
   `
 }
 
+function resumeJobs (schema) {
+  return `
+    with results as (
+      UPDATE ${schema}.job
+      SET completedOn = NULL,
+        state = '${states.created}'
+      WHERE id IN (SELECT UNNEST($1::uuid[]))
+      RETURNING 1
+    )
+    SELECT COUNT(*) from results
+  `
+}
+
 function insertJob (schema) {
   return `
     INSERT INTO ${schema}.job (

package/types.d.ts

@@ -329,6 +329,9 @@ declare class PgBoss extends EventEmitter {
   cancel(id: string): Promise<void>;
   cancel(ids: string[]): Promise<void>;
 
+  resume(id: string): Promise<void>;
+  resume(ids: string[]): Promise<void>;
+
   complete(id: string): Promise<void>;
   complete(id: string, data: object): Promise<void>;
   complete(ids: string[]): Promise<void>;