EventHistory

​

Common fields

• max_history_size: max retained events (None/null means unbounded, 0 keeps only in-flight visibility)
• max_history_drop: whether to trim oldest entries when over limit
• Ordered mapping keyed by event_id

​

Mapping interface

from abxbus import EventHistory

history = EventHistory(max_history_size=100, max_history_drop=True)
history[event.event_id] = event

exists = event.event_id in history
loaded = history.get(event.event_id)
count = len(history)

for event_id, item in history.items():
    print(event_id, item.event_type)

import { EventHistory } from 'abxbus'

const history = new EventHistory({ max_history_size: 100, max_history_drop: true })
history.set(event.event_id, event)

const exists = history.has(event.event_id)
const loaded = history.get(event.event_id)
const count = history.size

for (const [event_id, item] of history) {
  console.log(event_id, item.event_type)
}

​

Accessor methods

​

find(...)

• event pattern ('EventType', class, or '*')
• where predicate filtering
• field equality filters (**event_fields in Python, options object fields in TypeScript)
• past / future windows
• child_of constraints

​

Retention and trim methods

• trim_event_history / trimEventHistory applies configured retention policy.
• on_remove callbacks let the caller run cleanup side effects when history entries are removed.

​

Constructor options

history = EventHistory(max_history_size=100, max_history_drop=False)

const history = new EventHistory({ max_history_size: 100, max_history_drop: false })