pg-boss 7.0.3 → 7.2.1

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.0.3",
+  "version": "7.2.1",
   "description": "Queueing jobs in Node.js using PostgreSQL like a boss",
   "main": "./src/index.js",
   "engines": {

package/src/index.js

@@ -73,12 +73,14 @@ class PgBoss extends EventEmitter {
 
     function promoteFunction (obj, func) {
       this[func.name] = (...args) => {
-        if (this.stopped || this.stoppingOn) {
-          const state = this.stoppingOn ? 'stopping' : 'stopped'
+        const shouldRun = !this.started || !((func.name === 'work' || func.name === 'onComplete') && (this.stopped || this.stoppingOn))
+
+        if (shouldRun) {
+          return func.apply(obj, args)
+        } else {
+          const state = this.stoppingOn ? 'stopping' : this.stopped ? 'stopped' : !this.started ? 'not started' : 'started'
           return Promise.reject(new Error(`pg-boss is ${state}.`))
         }
-
-        return func.apply(obj, args)
       }
     }
 
@@ -100,6 +102,8 @@ class PgBoss extends EventEmitter {
 
     await this.contractor.start()
 
+    this.started = true
+
     this.manager.start()
 
     if (!this.config.noSupervisor) {
@@ -132,10 +136,6 @@ class PgBoss extends EventEmitter {
     await this.timekeeper.stop()
 
     const shutdown = async () => {
-      if (this.db.isOurs) {
-        await this.db.close()
-      }
-
       this.stopped = true
       this.stoppingOn = null
 

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

@@ -102,6 +102,7 @@ declare namespace PgBoss {
   interface JobFetchOptions {
     teamSize?: number;
     teamConcurrency?: number;
+    teamRefill?: boolean;
     batchSize?: number;
     includeMetadata?: boolean;
   }
@@ -329,6 +330,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>;