plainleaf/docs/API/event.md

tags, references

tags	references
api/syscall	plug-api/syscalls/event.ts client/plugos/syscalls/event.ts client/plugos/event.ts

The Event API provides functions for working with SilverBullet's event bus system, allowing communication between different parts of the application.

event.dispatch

event.dispatch(eventName, data)

Dispatches an event and collects responses from its listeners.

Parameters:

• eventName (string) — Event name.
• data — Event payload.

Returns:

• table — Listener responses.

Example:

local responses = event.dispatch("data.request", {id = 123})

event.listEvents

event.listEvents()

Lists all event names that currently have listeners.

Returns:

• table — Registered event names.

event.listen

event.listen(listener)

Registers a Space Lua listener on the event bus.

Parameters:

• listener (table) — Listener definition with name and run callback.

Example:

event.listen { name = "my-event", run = function(e) print(e.data) end }