[jwei-pm]

The Data API now serves four range-event activity types from DirectionalModule (module 4). A strict ActivityType enum rejected those rows and failed the whole activity page.

This change adds the four types and keeps unknown future types as UnknownActivity, so a new type cannot crash clients.

Types

• DIRECTIONAL_SPLIT / DIRECTIONAL_MERGE: event-level rows. size is pair count (pairs). usdc_size is collateral paid or returned (amount). condition_id on the wire is the event id, not a market. Metadata (title, eventSlug, icon) is optional until the event is listed.
• THRESHOLD_COMPOSE / THRESHOLD_DECOMPOSE: line-market rows. conditionId is required. size is share count (shares). usdc_size is 0. outcome / outcomeIndex name the line side when present (0 = Yes/ABOVE, 1 = No/BELOW).

Source of the wire contract: polymarket-indexer /v2 activity serving and the DirectionalModule event semantics (split/merge of two lines, compose/decompose of one line).

Unknown types

ActivitySchema accepts any non-empty type string. Types that are not in ActivityType parse as UnknownActivity with type: undefined and the served value in rawType. Exhaustive switches over activity.type need a branch for undefined.

The listActivity type filter still accepts only known ActivityType values.

Tests

Sample payloads cover each new type, empty listing metadata, 29-byte and padded event ids, a missing threshold condition_id, and a mixed page that includes an unknown type.

  

---

Note

Medium Risk
Changes core activity normalization and widens the Activity union, so downstream type narrowing and display logic must handle new variants and unknown rows; market vs event condition_id handling is easy to get wrong if ignored.

^{Reviewed by Cursor Bugbot for commit da77d9e. Bugbot is set up for automated code reviews on this repo. Configure here.}

[cursor]

Cursor Bugbot has reviewed your changes using default effort and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, have a team admin enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit 97ae29b. Configure here.}

[jwei-pm]

Closing: not needed for the current staging work.