Introduce spans of events

[Yopi]

Backend:

• Adds a hierarchical grouping of events (via parent_event_id).
• Allows ingestion with a external_event_id as an idempotency key. Events with the same external_event_id are not reingested
• Allows ingestion of a parent_event_id either as a Polar event.id or as a external_event_id. We do the lookup on our side to allow both sides.
• Adds a new event hierarchical listing endpoint. I think this can replace the existing endpoint listing endpoint, as we can allow it to be configured with hierarchical: bool. We could make the HierarchicalEvent to be an Event with a children list, instead of holding the Event as a field. -- Or we keep it as a separate endpoint.

Frontend:

• Add display of nested events.
• Add semi-pagination of nested events (Show more instead of pages)

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

2 Skipped Deployments

Project	Deployment	Preview	Comments	Updated (UTC)
polar	Ignored	Preview		Oct 31, 2025 2:56pm
polar-sandbox	Ignored	Preview		Oct 31, 2025 2:56pm

[emilwidlund]

Great work on this!

I wonder if we should rename external_event_id to idempotency_key instead? I wonder if that better conveys the purpose of it. But that's just my 2 cents :)