mosaic-core/dev.catbit.mosaic.core.data.schemas.event.events.event/RunEventsEventSchema

RunEventsEventSchema

@Serializable

@SerialName(value = "RunEvents")

data class RunEventsEventSchema(val id: String, val trigger: EventTrigger, val events: SerializableImmutableList<EventSchema>?) : EventSchema

Runs this event's own events list inline, in order, each receiving this event's incomingData. It is the way to fan a single trigger out into several events, or to group events for reuse.

Unlike most events, events here is the payload to execute rather than a downstream chain. Each entry is run guarded, so one failing event is logged and the remaining ones still run.

incomingData consumed: forwarded unchanged to every event in the list.

Triggers fired:

OnSuccessEventTrigger — when every event in the list ran without throwing. No data is passed downstream.
OnFailureEventTrigger — when at least one of them threw. Fired once at the end, after all of them were attempted, with no data attached; each failure is logged.

Constructors

RunEventsEventSchema

constructor(id: String, trigger: EventTrigger, events: SerializableImmutableList<EventSchema>?)

Properties

events

@SerialName(value = "events")

open override val events: SerializableImmutableList<EventSchema>?

This event's own children — each declaring, via its own trigger, which of this event's outgoing triggers runs it. null when this event declares no children.

@SerialName(value = "id")

open override val id: String

Unique identifier — how TriggerEvent/UpdateEvents address this event by id. Defaults to a random id when omitted from the DSL.

trigger

@SerialName(value = "trigger")

open override val trigger: EventTrigger

The condition that must occur for this event to run — matched by structural equality (data class/data object equality) against whatever trigger value fired, never by any kind of subscription or listener registry.