[mozzius]

Fixes APP-3101. Stacked on #11957.

What it does

• Impressions. The first time the new posts pill shows an offer, it reports:

  • what put the pill up, a restore or a significant return. This comes from the staged page it was offered with, and stays the same as later pages join.
  • how many posts it offered;
  • whether it showed a facepile or a count.

  An offer counts once, however many later posts join it. It only counts while Home Following is on screen, so a pill that comes down unseen reports nothing.

• Presses report the same, plus how long the pill had been showing. A press is reported as the pill comes down, so it can't be counted twice.

• Hides report why the pill came down, and the count it last showed and how long it was up. The reasons:

  • the reader reached the top;
  • they pressed it;
  • its pages left the feed, for example on a refresh (replaced);
  • its pages are still there but none of their posts render (gone).

• The pill reports for itself. It keeps what put it up and why it came down in its own state. pillMetrics.ts only turns that into events.

• Gated. Only Home Following on iOS and Android with Following v2 on reports anything. Volume is low, at most one of each event per offer, and nothing about the posts or their authors is reported.

Known issues

• An offer still up when the view unmounts reports no hide.

Test plan

• pnpm test src/features/followingV2 src/lib/appState (305 tests), pnpm typecheck, pnpm lint.
• Unit tests:
  • what put the pill up and why it came down (usePrependPill);
  • one impression per offer;
  • a press reported as the pill comes down;
  • unseen offers, and reporting disabled (pillMetrics).
• Through the renderHome harness:
  • a warm-open impression, then a hide at the top;
  • later checks joining without a second impression;
  • the press payload;
  • a refresh replacing the feed;
  • a restore's impression only once it's on screen.
• Device:
  • one impression per offer, on a cold restore and on a significant return;
  • press and hide reasons in the debug metrics log;
  • nothing on hops, with the flag off, or on web.

🤖 Generated with Claude Code

[linear-code]

APP-3101

[github-actions]

Size	Old size	New size	Diff
Uncompressed	9.67 MB	9.68 MB	+7.92 KB (0.08%)
Gzip	2.84 MB	2.84 MB	+2.83 KB (0.10%)

---

[github-actions]

The OTA deployment for this PR was successful! You may now apply it by either scanning the QR code or opening the deep link below in your browser:

bluesky://intent/apply-ota?channel=pull-request-11959&releaseVersion=1.138.0&iosBuildNumber=2263&androidBuildNumber=1704