@10x-media/jobs

An ops dashboard plus reliability, worker, and queue-control layers for Payload v3's built-in jobs queue. See what the queue is doing, recover jobs that die mid-run, run a proper worker process with graceful drain, and pause or drive the queue from the outside. Every layer is opt-in.

Part of the @10x-media Payload plugins collection. In beta: published under the beta dist-tag until a stable 1.0.

Features

• Dashboard: a derived Status column, a queue-health bar, and error/log panels on the payload-jobs collection. On by default.
• Custom log blocks: register your own renderer for an attempt's input, output, or error, per task slug or for every task.
• Create-form input: input is pre-filled from the selected task's or workflow's inputSchema, and input.components swaps the JSON editor for your own per slug.
• Reliability: job leases, an orphan sweeper with dead-lettering, leader election with fence tokens, serverless staleness.
• Workers: createWorker runs jobs as a standalone process and drains gracefully on SIGTERM.
• Queue control: cluster-wide pause/resume plus hardened queue-run, queue-sweep, and queue-status endpoints with access guards.
• Topology presets for serverless (Vercel Cron), single-node, and multi-node deployments.
• Typed translations with per-key overrides via @10x-media/jobs/i18n.

Quick start

pnpm add @10x-media/jobs

// payload.config.ts
import { buildConfig } from 'payload'
import { jobs, singleNodePreset } from '@10x-media/jobs'

export default buildConfig({
  jobs: {
    tasks: [/* at least one task; payload-jobs does not exist without one */],
  },
  plugins: [jobs({ ...singleNodePreset() })],
})

jobs({}) alone enables the dashboard; the preset also turns on reliability and queue control. Run a worker process for production execution.

Documentation

Full documentation at docs.10xmedia.de:

• Overview
• Quick start
• Dashboard
• Reliability
• Workers
• Topologies
• Queue control
• Testing and local dev
• i18n

License

MIT. Copyright 10x Media GmbH.