EventHandler

​

Common fields

• id: stable handler id
• handler_name: callable/function name
• handler_file_path: source path metadata (str | None in Python, string | null in TypeScript)
• handler_timeout: optional per-handler timeout override
• handler_slow_timeout: optional slow-warning override
• handler_registered_at
• event_pattern: subscribed key (EventType or '*')
• eventbus_name, eventbus_id

​

bus.on(...) and bus.off(...)

entry = bus.on(MyEvent, handler)
bus.off(MyEvent, entry)

const entry = bus.on(MyEvent, handler)
bus.off(MyEvent, entry)

​

Serialization

payload = entry.model_dump(mode='json', exclude={'handler'})
print(payload)
# {
#   "id": "018f...",
#   "handler_name": "app.handlers.on_user_created",
#   "event_pattern": "UserCreatedEvent",
#   "eventbus_name": "AuthBus",
#   "eventbus_id": "018f...",
#   "...": "..."
# }

restored = EventHandler.from_json_dict(payload, handler=real_handler)

const payload = entry.toJSON()
console.log(payload)
// {
//   id: '018f...',
//   handler_name: 'onUserCreated',
//   event_pattern: 'UserCreatedEvent',
//   eventbus_name: 'AuthBus',
//   eventbus_id: '018f...',
//   ...
// }

const restored = EventHandler.fromJSON(payload, realHandler)

​

Notes

• Function bodies are not serialized.
• Rehydration restores metadata; execution behavior requires re-binding a real callable.