new-domain-event

To add a new domain event to a transactional outbox, you register the event type in contracts, create a matching payload interface and schema, wire a dispatcher case, and ensure writes occur transactionally.

The transactional outbox pattern for domain events ensures reliable and idempotent event publishing by writing event payloads to an outbox table within the same database transaction as your domain state changes.

To wire a domain event workflow in Temporal, you add a matching EventPayloadSchema in the Temporal client, add a dispatcher case in the worker workflow, and implement the corresponding workflow handler.

To register domain event types across TypeScript contracts and schemas, you define the event type in contracts, create a corresponding payload interface in the domain layer, and generate a matching EventPayloadSchema.

You need a dispatcher case for event-driven architecture when introducing a new event type that requires a dedicated worker workflow handler to process the event payload and execute the corresponding business logic.

Domain events must be written transactionally in the outbox to guarantee that event records and their associated domain state changes commit atomically, preventing data inconsistency and ensuring reliable event delivery.