JSPM

Queueing jobs in Node.js using PostgreSQL like a boss.

async function readme() {
  const PgBoss = require('pg-boss');
  const boss = new PgBoss('postgres://user:pass@host/database');

  boss.on('error', error => console.error(error));

  await boss.start();
  
  const queue = 'some-queue';

  let jobId = await boss.publish(queue, { param1: 'foo' })
  
  console.log(`created job in queue ${queue}: ${jobId}`);

  await boss.subscribe(queue, someAsyncJobHandler);
}

async function someAsyncJobHandler(job) {
  console.log(`job ${job.id} received with data:`);
  console.log(JSON.stringify(job.data));
    
  await doSomethingAsyncWithThis(job.data);
}

pg-boss is a job queue built in Node.js on top of PostgreSQL in order to provide background job processing and reliable asynchronous execution to Node.js applications.

Why would you consider using this queue over others? pg-boss is actually a light abstraction over features added in PostgreSQL 9.5 (specifically SKIP LOCKED and upserts) which significantly enhanced its ability to act as a reliable, distributed message queue. I wrote this to remove a dependency on Redis (via the kue package), consolidating systems I have to support in production as well as upgrading to guaranteed message processing (hint: Redis persistence docs).

This will likely cater the most to teams already familiar with the simplicity of relational database semantics and operations (querying and backups, for example).

Features

• Guaranteed delivery and finalizing of jobs using a promise API
• Delayed jobs
• Job retries (opt-in exponential backoff)
• Job throttling (unique jobs, rate limiting and/or debouncing)
• Job batching for high volume use cases
• Backpressure-compatible subscriptions
• Configurable job concurrency
• Distributed and/or clustered workers
• Completion subscriptions to support orchestrations/sagas
• On-demand job fetching and completion for external integrations (such as web APIs)
• Automatic provisioning of required storage into a dedicated schema
• Automatic monitoring for expired jobs
• Automatic archiving for completed jobs

Requirements

• Node 8 or higher
• PostgreSQL 9.5 or higher

Documentation

• Usage
• Configuration