Options for useChannelEffect. Extends the projection options
(bufferSize, replay) with the per-event callback, an optional
error sink, a target scope, and an enabled gate.
interface UseChannelEffectOptionsMaximum number of events retained in the projection snapshot. Defaults to 4096 so replay-backed discovery hooks can tolerate bursty token/media streams without dropping early lifecycle events.
Gate the subscription. When false, no subscription is opened and
no events are delivered. Defaults to true. Flipping this lets you
pause analytics (e.g. while the user is viewing a different thread)
without unmounting.
Invoked when onEvent throws. When omitted, a throwing
onEvent is swallowed so one bad delivery cannot wedge the shared
store's notification loop or other consumers.
Invoked once for every event observed while attached.
Whether to open a real subscription and receive replayed history. Defaults to true. Set false for live-only root-bus inspection when replay is unnecessary.
Scope events to a subagent / subgraph / explicit namespace. Defaults to the root namespace.