EventResult

​

Common fields

• id: unique result id
• status: pending | started | completed | error
• result: handler return value (typed by event result schema/type)
• error: captured exception/error when handler fails
• started_at, completed_at
• event_children: child events emitted from inside this handler execution
• Handler metadata (handler_id, handler_name, bus label/id/name)

​

Await semantics

entry = event.event_results[some_handler_id]
value = await entry

const [, entry] = Array.from(event.event_results.entries())[0]
const value = entry.result

​

Internal lifecycle methods

# internal methods used by EventBus
await entry.execute(...)
entry.update(status='started' | 'completed' | 'error', result=..., error=...)

entry.markStarted()
entry.markCompleted(result)
entry.markError(error)
await entry.runHandler()
entry.signalAbort(error)
entry.linkEmittedChildEvent(childEvent)

​

Serialization

payload = entry.model_dump(mode='json')

const payload = entry.toJSON()
const restored = EventResult.fromJSON(event, payload)