publish
Publish an event to a pubsub topic
- dataunknownrequired
JSON payload delivered to each subscriber.
- topicstringrequired
Topic to publish to. Subscribers registered for this topic receive the event.
valuenull
pubsub
v0.21.12pubsub is deprecated (pubsub) and will be removed in an upcoming release. Behavior is unchanged for now. Migration guide: https://github.com/iii-hq/iii/blob/6901a589dd39d9c34f9d5b6bd8bc82170ee21548/docs/next/upgrading/migrate-from-streams.mdx — Topic-based publish/subscribe messaging; registers the `subscribe` trigger type and the `publish` function.
Deprecated
pubsub is deprecated and will be removed in an upcoming release. Behavior is unchanged for now. For fan-out notifications, have your worker register its own trigger type; when delivery must not be lost, use the queue worker (iii::durable::publish + durable:subscriber). Migration guide: https://iii.dev/docs/upgrading/migrate-from-streams
Install
bash
iii trigger compose::add worker=pubsub@0.21.12Run in your project with the iii engine running. Exact versions are immutable and digest-pinned.
Functions2
Function
pubsub::on-config-change
Internal: reload pubsub configuration from the authoritative store on change.
Empty object
- okbooleanrequired
Triggers1
subscribe
Subscribe to a topic
- condition_function_idstring
Condition function ID accepted for schema parity with the builtin trigger; never evaluated.
- topicstringrequired
Topic to subscribe to
valueunknown