Class ActionLog

Index

Constructors

Methods

append byteSize clear countByIntent exportJson hydrate list size subscribe

Constructors

constructor

new ActionLog(opts?: ActionLogOptions): ActionLog
Parameters
- Optionalopts: ActionLogOptions
Returns ActionLog

Methods

append

append<K extends ActionIntent>(input: AppendInput<K>): ActionEvent
Append an action event. seq and ts are assigned by the log. success defaults to true. The generic preserves discriminated- union narrowing on params.
Type Parameters
- K extends ActionIntent
Parameters
- input: AppendInput<K>
Returns ActionEvent

byteSize

byteSize(): number

Returns number

clear

clear(): void

Returns void

countByIntent

countByIntent(filter?: ActionFilter): Record<ActionIntent, number>
Parameters
- Optionalfilter: ActionFilter
Returns Record<ActionIntent, number>

exportJson

exportJson(): string

Returns string

hydrate

hydrate(events: readonly ActionEvent[]): void
Hydrate the log from a prior snapshot (typically from IDB). Useful when the viewer's host service restores state on app boot. Does NOT re-emit subscribe listeners — the caller is already acknowledging the persisted state.
Parameters
- events: readonly ActionEvent[]
Returns void

list

list(filter?: ActionFilter): ActionEvent[]
Parameters
- Optionalfilter: ActionFilter
Returns ActionEvent[]

size

size(): number

Returns number

subscribe(listener: (event: ActionEvent) => void): () => void
Subscribe to new events (fire after append). Returns unsubscribe.
Parameters
- listener: (event: ActionEvent) => void
Returns () => void