Skip to content

QueueManager

Defined in: queue/manager.ts:26

Queue Manager - handles all queue operations

T extends QueueItem = QueueItem

new QueueManager<T>(storage, config?): QueueManager<T>

Defined in: queue/manager.ts:29

QueueStorage<T>

QueueManagerConfig = {}

QueueManager<T>

add(item): Promise<T>

Defined in: queue/manager.ts:43

Add an item to the queue

Omit<T, "status" | "addedAt" | "retries"> & Partial<Pick<T, "status" | "addedAt" | "retries">>

Promise<T>


cancel(id): Promise<T | undefined>

Defined in: queue/manager.ts:178

Cancel an item

string

Promise<T | undefined>


clear(): Promise<void>

Defined in: queue/manager.ts:212

Clear all items (dangerous!)

Promise<void>


complete(id): Promise<T | undefined>

Defined in: queue/manager.ts:130

Mark an item as completed and remove from queue

string

Promise<T | undefined>


fail(id, error): Promise<T | undefined>

Defined in: queue/manager.ts:151

Mark an item as failed If under max retries, requeue as pending

string

string

Promise<T | undefined>


get(id): Promise<T | undefined>

Defined in: queue/manager.ts:95

Get an item by ID

string

Promise<T | undefined>


isLocked(): Promise<boolean>

Defined in: queue/manager.ts:236

Check if queue is locked

Promise<boolean>


length(): Promise<number>

Defined in: queue/manager.ts:204

Get current queue length

Promise<number>


list(status?): Promise<T[]>

Defined in: queue/manager.ts:185

List all items (optionally filtered by status)

QueueItemStatus

Promise<T[]>


lock(): Promise<boolean>

Defined in: queue/manager.ts:222

Acquire a lock for processing

Promise<boolean>


next(): Promise<T | undefined>

Defined in: queue/manager.ts:87

Get the next item to process (highest priority, oldest first)

Promise<T | undefined>


processNext<R>(handler): Promise<{ item: T; result: R; } | null>

Defined in: queue/manager.ts:244

Process the next item with a handler Automatically handles locking, status updates, and error handling

R

(item) => Promise<R>

Promise<{ item: T; result: R; } | null>


remove(id): Promise<T | undefined>

Defined in: queue/manager.ts:71

Remove an item from the queue

string

Promise<T | undefined>


startProcessing(id): Promise<T | undefined>

Defined in: queue/manager.ts:120

Mark an item as processing

string

Promise<T | undefined>


stats(): Promise<QueueStats>

Defined in: queue/manager.ts:196

Get queue statistics

Promise<QueueStats>


unlock(): Promise<void>

Defined in: queue/manager.ts:229

Release the lock

Promise<void>


update(id, updates): Promise<T | undefined>

Defined in: queue/manager.ts:103

Update an item’s properties

string

Partial<Omit<T, "id">>

Promise<T | undefined>