blocfeed 0.18.0 → 0.19.0

package/CHANGELOG.md

@@ -1,5 +1,26 @@
 # Changelog
 
+## 0.19.0 — 2026-05-07
+
+### Signal accuracy fixes
+
+- **rage-click** now emits a follow-up `final: true` event with the real total `click_count` after the click streak ends (default 1500 ms idle). Previously the count was capped at the threshold, so a 20-click rage looked identical to a 3-click rage. New `RageClickConfig.streakIdleMs` (default 1500).
+- **dead-click** observation is now scoped to the click target's nearest interesting ancestor (button / a / form / [role=button]) instead of the entire document body. Unrelated re-renders elsewhere on the page no longer suppress real dead clicks.
+- **httpFail** now catches fetch exceptions (network errors, CORS, abort) and emits with `event_data.http_status: 0` and `error_kind: "network" | "abort"`. Also adds `404, 408, 409, 429` to the default tracked status codes. New optional `treatJsonErrorAsFail` config to flag 2xx responses with `{ ok: false }` / `{ error }` / `{ success: false }` bodies.
+- **formDataLoss** clears dirty state on `submit` and `reset` events, and suppresses bfcache emission for 60 s after a successful submit. Eliminates false "form abandonment" events on successful conversions.
+
+### Reliability fixes
+
+- **Sampling consistency.** Behavioral and replay sampling now both use the same deterministic `simpleHash(session_id) % 100` decision. A sampled session is in both cohorts or neither — no more "signal exists but no replay" or vice-versa.
+- **Replay restart after inactivity.** The 30-min inactivity timer now triggers a soft pause (uninstalls rrweb, keeps the controller alive). A one-shot pointerdown/keydown listener resumes recording when the user returns. The 4-hour absolute cap still terminates fully. New `pause_count` field appears in chunk POST bodies.
+
+### New: widget heartbeat
+
+- New `installHeartbeat()` helper (auto-installed by `BehavioralTracker`) POSTs to `/api/heartbeat` every 5 minutes (and on pagehide) with `{ blocfeed_id, session_id, version, page_url, user_agent, sdk_features }`. Lets the dashboard surface a "last seen" indicator and detect silent SDK breakage.
+- New exported constant `SDK_VERSION` from `blocfeed`.
+
+---
+
 ## 0.18.0 — 2026-04-30
 
 - **feat:** new `track(name, properties?, options?)` API on `BlocFeedApi` and exported as `BlocFeed.track()` for non-React usage. Send custom events to BlocFeed for funnels, conversion tracking, and segment filters.