skip to content
$worker

iii-queue

v0.21.1-next.1

Async job processing with named queues, retries, and dead-letter support.

Deprecated

Renamed to queue. Durable job queues are now a standalone worker — install queue instead of the iii-queue engine builtin.

Use queue instead.

iiiverified
11,031 installs1,719 in 7d51 today
install
$iii worker add iii-queue@0.21.1-next.1

exact versions are immutable; binary and bundle artifacts are digest-pinned.

engine module
baked into the iii engine; no separate install required.

functions

9

engine::queue::dlq_messages

function

Browse DLQ messages

request
  • limitinteger· uint64min 0

    Maximum number of messages to return (default 50).

  • offsetinteger· uint64min 0

    Number of messages to skip (default 0).

  • topicstringrequired

    Topic or named queue whose dead-letter messages to browse. For a durable topic this is the topic name.

response
valueunknown

engine::queue::dlq_topics

function

List DLQ topics with counts

request
valueunknown
response
valueunknown

engine::queue::list_topics

function

List all queue topics

request
valueunknown
response
valueunknown

engine::queue::topic_stats

function

Get stats for a queue topic

request
  • topicstringrequired

    Topic or named queue to inspect. For a durable topic this is the topic name.

response
valueunknown

iii-queue::on-config-change

function

Internal: re-apply the iii-queue configuration when the authoritative configuration entry changes.

request
valueunknown
response
valueunknown

iii::durable::publish

function

Enqueue a message

request
  • dataunknownrequired

    JSON payload delivered to each subscriber.

  • topicstringrequired

    Topic to publish to. Subscribers registered for this topic receive the message.

response
valueunknown

iii::queue::discard_message

function

Discard (purge) a single DLQ message by ID

request
  • message_idstringrequired

    Identifier of the dead-letter message to redrive (from `engine::queue::dlq_messages`).

  • queuestringrequired

    Queue or topic owning the dead-letter message. For a durable topic this is the topic name.

response
  • message_idstringrequired
  • queuestringrequired
  • redriveninteger· uint64requiredmin 0

iii::queue::redrive

function

Redrive all DLQ messages back to the main queue

request
  • queuestringrequired

    Queue or topic whose dead-letter messages should be moved back to the main queue. For a durable topic this is the topic name.

response
  • queuestringrequired
  • redriveninteger· uint64requiredmin 0

iii::queue::redrive_message

function

Redrive a single DLQ message by ID back to the main queue

request
  • message_idstringrequired

    Identifier of the dead-letter message to redrive (from `engine::queue::dlq_messages`).

  • queuestringrequired

    Queue or topic owning the dead-letter message. For a durable topic this is the topic name.

response
  • message_idstringrequired
  • queuestringrequired
  • redriveninteger· uint64requiredmin 0

triggers

1

durable:subscriber

trigger

Queue core module

invocation
  • condition_function_idstring

    Optional function ID to evaluate before invoking handler

  • queue_configunknown

    Queue-specific subscriber configuration

  • topicstringrequired

    Queue topic to subscribe to

return
valueunknown