StoreSpec · @yoltra/core (0.9) · Yoltra

La referencia de la API está disponible solo en inglés por ahora.

Store configuration object passed to the Store constructor or createStore.

Type parameters

Name	Type	Description
`R`	`extends string`	Reducer name union (string literal union).
`S`	`extends Record<R, any>`	State record keyed by `R`.
`EM`	`extends EventMapBase`	Event map.

Properties

Name	Type	Description
`dedupWindowMs`?	`number`	Time window in milliseconds for content-based event deduplication. When greater than 0, events with identical fingerprints (channel + type + serialized payload) within this window are treated as duplicates and skipped. Off by default. Content-based dedup can silently drop legitimate rapid-fire identical events (double-clicks, repeated `+1`, sliders emitting the same value), so it is opt-in. To safely coalesce a specific re-fired emit (e.g. React Strict Mode), prefer the per-emit `EmitOptions.dedupKey`.
`devtools`?	`{ allowReplay?: boolean }`	DevTools configuration options.
`effects`?	`EffectSpec<DeepReadonly<S>, EM>[]`	Optional side-effect handlers registered at construction time. Runs after reducers for every propagated event.
`idFactory`?	`() => string`	Generates the `id` for each emitted event. Defaults to `crypto.randomUUID()`.
`maxReduceDepth`?	`number`	Maximum causal depth of an event chain before the store refuses to extend it.
`maxTransitionsPerDrain`?	`number`	Maximum number of events one synchronous drain will process before refusing more.
`middleware`?	`MiddlewareInput<DeepReadonly<S>, EM>[]`	Middleware chain executed before reducers/effects. Accepts either functions (legacy) or MiddlewareSpec objects (recommended). An event stops propagating only when a middleware returns an explicit `false`, or throws. Returning nothing allows it. Middleware is synchronous: a `Promise` is not `false`, so it cannot veto.
`name`	`string`	Store name (used by DevTools to identify the instance).
`onCascade`?	`(info: CascadeInfo<EM>) => void`	Called when a ceiling is breached, instead of throwing.
`onEffectError`?	`(error: unknown, event: EventUnion<EM>) => void`	Called when an effect throws or its returned promise rejects.
`onReducerError`?	`(error: unknown, event: EventUnion<EM>, slice: string) => void`	Invoked when a reducer throws.
`onRejected`?	`(rejection: Rejection, event: EventUnion<EM>, slice: string) => void`	Called when a reducer refuses a write by returning `Rejected`.
`onSubscriberError`?	`(error: unknown, event: EventUnion<EM>, phase: NotifiedPhase) => void`	Called when an `onEvent` subscriber throws, or rejects.
`reducer`	`Record<R, ReducerSpec<S[R], EM>>`	Map of slice name → reducer spec. Each entry declares initial state, the reducer function, and the event targeting.