Module: Background Job Queue

Composable background job processing with pluggable brokers. Ships with an in-memory provider for development and testing, a BullMQ provider for Redis-backed queues, and an AWS SQS provider for cloud-native workloads. Uses a self-registering provider registry so custom brokers can be added without modifying core code.

Name	`module-queue-ts`
Version	`0.1.0`
Category	composable-modules
License	Apache-2.0
Persona	engineering
Tags	queue, jobs, background, typescript, workers
Source	`templates/module-queue-ts`

Render it

Three front doors, one catalog. Pick whichever suits the caller.

# CLI
npx @nanohype/sdk render module-queue-ts --out ./my-app

# SDK
import { LocalSource, renderTemplate } from "@nanohype/sdk";
const result = await renderTemplate(source, "module-queue-ts", variables);

# MCP — from an agent
get_template({ name: "module-queue-ts" })

Prerequisites

Tool	Version	Why
`node`	`>=22`	Node.js runtime for the queue module

Variables

Required

ProjectName string: Kebab-case project name, used as package name and directory Must be lowercase kebab-case starting with a letter.

Optional

Description string — defaults to Background job processing with pluggable queue providers: Short project description for package.json and README
QueueProvider string — defaults to memory: Default queue provider (memory, bullmq, sqs, or a custom name)

What it produces

23 files. Placeholder names such as __APP_NAME__ are what the renderer substitutes into.

.env.example
.gitignore
biome.json
package.json
README.md
src/queue/__tests__/integration.test.ts
src/queue/__tests__/job.test.ts
src/queue/__tests__/memory.test.ts
src/queue/__tests__/registry.test.ts
src/queue/bootstrap.ts
src/queue/index.ts
src/queue/job.ts
src/queue/metrics.ts
src/queue/providers/bullmq.ts
src/queue/providers/index.ts
src/queue/providers/memory.ts
src/queue/providers/registry.ts
src/queue/providers/sqs.ts
src/queue/providers/types.ts
src/queue/types.ts
src/queue/worker.ts
tsconfig.json
vitest.config.ts

Composes with

Pairs with ts-service
Pairs with agentic-loop
Nests inside monorepo

Composites that use it

Background Processor — Async job processing service with queue, database, storage, observability, and deployment.
Enterprise AI Infrastructure — Full enterprise AI stack with agents, tool servers, safety guardrails, evaluation, prompt management, observability, and Kubernetes deployment..
Production API Service — Production-grade TypeScript API service with auth, database, caching, rate limiting, background jobs, observability, and deployment..