Classes · @purista/core

DefaultQueueBridge

In-memory queue bridge for development and unit tests.

Signature

DefaultQueueBridge.tstypescript
class DefaultQueueBridge

Examples

example-1.tstypescript
const queueBridge = new DefaultQueueBridge({ defaultLeaseTtlMs: 60_000 })
await queueBridge.enqueue({ queueName: 'orders', payload: { id: 'ord_1' } })

Constructors

1 entry

constructor

Constructor

Source
constructor.tstypescript
new constructor(options?: DefaultQueueBridgeOptions)

Properties

3 entries

capabilities

Property

Source
capabilities.tstypescript
capabilities: QueueBridgeCapabilities

Process-local capability matrix for strict startup validation.

instanceId

Property

Source
instanceId.tstypescript
instanceId: string

Runtime instance id for this in-memory bridge instance.

name

Property

Source
name.tstypescript
name: "DefaultQueueBridge"

Human-readable bridge name used in diagnostics and metrics.

Methods

15 entries

ack

Method

Source
ack.tstypescript
ack(queueName: string, leaseId: string): Promise<void>

Acknowledge successful processing and remove the leased message.

destroy

Method

Source
destroy.tstypescript
destroy(): Promise<void>

Release provider resources and stop background bridge activity.

enqueue

Method

Source
enqueue.tstypescript
enqueue(options: QueueEnqueueOptions<unknown, unknown>): Promise<QueueEnqueueResult>

Enqueue a queue message and return provider-visible job metadata.

extendLease

Method

Source
extendLease.tstypescript
extendLease(queueName: string, leaseId: string, extensionMs: number): Promise<void>

Extend an active lease so long-running work can continue safely.

inspectLeases

Method

Source
inspectLeases.tstypescript
inspectLeases(_queueName: string, _options?: QueueDeadLetterListOptions): Promise<QueueLeaseInspectionRecord[]>

Inspect active leases when the adapter supports lease diagnostics.

isHealthy

Method

Source
isHealthy.tstypescript
isHealthy(): Promise<boolean>

Returns whether the bridge can currently make progress.

isReady

Method

Source
isReady.tstypescript
isReady(): Promise<boolean>

Returns whether the bridge has completed startup and can accept calls.

leaseNext

Method

Source
leaseNext.tstypescript
leaseNext(queueName: string, _opts?: QueueLeaseOptions): Promise<QueueLease | undefined>

Lease the next available message for a worker, if one is ready.

metrics

Method

Source
metrics.tstypescript
metrics(queueName: string): Promise<QueueMetrics>

Return queue-level operational metrics for health and dashboards.

moveToDeadLetter

Method

Source
moveToDeadLetter.tstypescript
moveToDeadLetter(queueName: string, message: QueueMessage, reason?: string): Promise<void>

Move a message to the dead-letter store with an optional safe reason.

nack

Method

Source
nack.tstypescript
nack(queueName: string, leaseId: string, request: QueueRetryRequest): Promise<void>

Return a leased message to the queue or move it toward dead-letter policy.

peekDeadLetter

Method

Source
peekDeadLetter.tstypescript
peekDeadLetter(queueName: string, options?: QueueDeadLetterListOptions): Promise<QueueMessage[]>

Inspect dead-letter messages without redriving or deleting them.

purgeDeadLetter

Method

Source
purgeDeadLetter.tstypescript
purgeDeadLetter(queueName: string): Promise<number>

Delete all dead-letter messages for the queue.

redriveDeadLetter

Method

Source
redriveDeadLetter.tstypescript
redriveDeadLetter(queueName: string, options?: QueueDeadLetterRedriveOptions): Promise<number>

Move dead-letter messages back to the live queue.

start

Method

Source
start.tstypescript
start(): Promise<void>

Start the bridge and establish any provider connection needed for work.