Skip to main content

ActOptions

@rotorsoft/act-root


@rotorsoft/act-root / act/src / ActOptions

Type Alias: ActOptions<TLanes>

ActOptions<TLanes> = object

Defined in: libs/act/src/act.ts:142

Options for Act construction (passed via ActBuilder.build).

Type Parametersโ€‹

TLanesโ€‹

TLanes extends string = string

Propertiesโ€‹

correlator?โ€‹

readonly optional correlator?: Correlator

Defined in: libs/act/src/act.ts:163

Correlation-id generator for originating actions (ACT-404). When omitted, Act uses defaultCorrelator, which produces a readable, time-monotonic-within-window, lowercase id of the form {state[:4]}-{action[:4]}-{ts}{rnd} (18 chars).

Reactions inherit reactingTo.meta.correlation so the chain stays intact โ€” the delegate is only consulted on originating commits and for the close-the-books transaction.


maxSubscribedStreams?โ€‹

readonly optional maxSubscribedStreams?: number

Defined in: libs/act/src/act.ts:143

Cap for the LRU set tracking already- subscribed reaction streams. Default: DEFAULT_MAX_SUBSCRIBED_STREAMS.


onlyLanes?โ€‹

readonly optional onlyLanes?: ReadonlyArray<TLanes>

Defined in: libs/act/src/act.ts:165

Restrict this process to a subset of declared lanes (ACT-1103).


scoped?โ€‹

readonly optional scoped?: Scoped

Defined in: libs/act/src/act.ts:152

Per-Act ports (ACT-501). When set, this Act runs against the provided store + cache instead of the singletons โ€” threaded via AsyncLocalStorage so internals are unchanged. Both are required together (a shared cache across distinct stores would collide on stream keys). Omit for the singleton path.


settleDebounceMs?โ€‹

readonly optional settleDebounceMs?: number

Defined in: libs/act/src/act.ts:144

Debounce window (ms) used by settle() when the caller doesn't pass SettleOptions.debounceMs. Tune this once per Act instance instead of threading the value through every call site. Default: DEFAULT_SETTLE_DEBOUNCE_MS.