inbox.py¶

Generated: 2026-03-30T04:38:46.086787+00:00

Commit: 615f1354a103

Language: python

Scope: dazzle_back

Purpose¶

Event Inbox for Idempotent Consumer Processing.

The inbox pattern tracks which events have been processed by each consumer, enabling at-least-once delivery with idempotent handling. When an event arrives, the consumer checks the inbox first - if already processed, it's skipped.

Rule 2: At-least-on...

Key Exports¶

ProcessingResult
InboxEntry
EventInbox
create_table
is_processed
should_process
mark_processed
mark_error
get_entry
delete_entry
get_stats
cleanup_old_entries
get_recent_entries
list_consumers

Dependencies¶

Imports¶

__future__.annotations
dataclasses.dataclass
dataclasses.field
datetime.UTC
datetime.datetime
enum.StrEnum
typing.Any
uuid.UUID
json
json
datetime.timedelta
json

Event Interactions¶

None detected.

Invariants and Assumptions¶

No invariants documented.

Tests¶

tests/unit/test_inbox_pg.py
tests/unit/test_events.py
tests/unit/test_events_api.py

Notes¶

This page was automatically generated by tools/gen_reference_docs.py.