feat(inbox): type trackingIds and add clickTrackingId for SDK parity

[mikemilla]

Ticket: C-19804

Not a bug fix — worth saying plainly

Unlike courier-flutter (which genuinely had no trackingIds field), this SDK was never broken:

• InboxMessage already declared trackingIds
• fromJson already passes parsed.trackingIds into the constructor, so the field the native SDKs send has always reached JS
• the high-level Courier.shared.clickMessage({ messageId }) resolves the tracking id natively, so click tracking worked regardless

I initially reported the opposite on C-19804 — that was wrong, from globbing *.ts and missing .tsx. Retracted there.

What was actually missing: reachability

	before	after
trackingIds type	{ [key: string]: any } — guess the key names, no autocomplete, no compiler check	InboxMessageTrackingIds, all seven ids
clickTrackingId	absent — only SDK without it	present, matching ios / android / flutter

That matters for the lower-level client.inbox.click({ messageId, trackingId }), which does need the id — and this was the only SDK where you had to reach through an untyped map to get it.

Change

• InboxMessageTrackingIds covering all seven ids the server publishes: archive, channel, click, deliver, open, read, unread — exported as a type
• trackingIds field and constructor parameter typed to it
• clickTrackingId getter for parity

Read from the root of the message, where both the GraphQL read and the iwpv=v2 socket publish it. Independent of the protocol version and of the pending native pin bump.

Tests

130/130 passing, tsc --noEmit clean, eslint clean. 5 new cases:

• all seven ids parsed from a native payload
• clickTrackingId present, absent, and present-but-partial
• a nested data.trackingIds copy (the v1/legacy shape) is not read

One of these caught a wrong assumption of mine while writing it: fromJson passes undefined into a parameter defaulting to null, so an absent trackingIds lands as null, not undefined. The test now pins that actual behaviour.

🤖 Generated with Claude Code

[linear]

C-19804