jobs-kit

Monorepo for the @azsiaz/jobs-kit packages.

jobs-kit provides runtime-agnostic typed job definitions plus optional runtime adapters for BullMQ and tests.

Packages

Package	Description
@azsiaz/jobs-kit	Core runtime-agnostic API: job definitions, registries, types, dashboard contracts, and adapter helpers.
@azsiaz/jobs-kit-bullmq	BullMQ + Redis runtime adapter. bullmq and ioredis are peer dependencies.
@azsiaz/jobs-kit-testing	In-memory fake runtime for unit tests without Redis or BullMQ.

Install

Core only:

npm install @azsiaz/jobs-kit

BullMQ runtime:

npm install @azsiaz/jobs-kit @azsiaz/jobs-kit-bullmq bullmq ioredis

Testing runtime:

npm install -D @azsiaz/jobs-kit-testing

Development

This repository uses pnpm workspaces.

pnpm install
pnpm check

Useful commands:

pnpm build
pnpm typecheck
pnpm test
pnpm test:type
pnpm -r pack --dry-run

Release

Prepare a release commit:

pnpm release:prepare 2.0.0

After the release commit lands on main, Woodpecker creates the vX.Y.Z tag automatically and the tag workflow publishes the packages.