blocfeed 0.19.0 → 0.21.0

package/CHANGELOG.md

@@ -1,5 +1,60 @@
 # Changelog
 
+## 0.21.0 — 2026-05-07
+
+### New: tracking-only modes for non-React stacks
+
+Two new ways to install BlocFeed when you only want session replay,
+behavioral signals, and custom events — no feedback panel UI:
+
+- **`blocfeed/passive` subpath export.** Import `<BlocFeedPassive />` (a
+  React component that renders nothing and installs the tracker on mount)
+  or `BlocFeed.init({...})` (vanilla JS, no React required). Tree-shakes
+  cleanly so the feedback panel and `framer-motion` don't reach the
+  customer's bundle.
+
+- **IIFE script-tag bundle (`dist/script.js`, 65 KB gzipped).** Drop into
+  PHP, WordPress, Webflow, or any vanilla HTML page with one tag. All
+  configuration via `data-*` attributes; exposes `window.BlocFeed` for
+  runtime `track()` / `identify()` calls. Distributed via jsDelivr at
+  `https://cdn.jsdelivr.net/npm/blocfeed@0/dist/script.js`.
+
+  ```html
+  <script async
+    src="https://cdn.jsdelivr.net/npm/blocfeed@0/dist/script.js"
+    data-blocfeed-id="bf_xxx"
+    data-user-id="123"></script>
+  ```
+
+  Available data attributes: `data-blocfeed-id` (required),
+  `data-user-id`, `data-user-email`, `data-user-name`, `data-replay`,
+  `data-signals`, `data-mask` (`inputs` / `text` / `none`), `data-sample`
+  (0..1), `data-track-clicks`.
+
+- Heartbeats from script-tag installs include `"script-tag"` in
+  `sdk_features` so the dashboard can distinguish them from React imports.
+
+### Internal
+
+- `BehavioralTracker` accepts a new `extraSdkFeatures: string[]` option
+  used internally to tag the deployment surface in heartbeats.
+
+---
+
+## 0.20.0 — 2026-05-07
+
+### Signal accuracy
+
+- **rage-click now emits exactly one event per burst.** The previous behaviour fired an immediate `final: false` event at threshold-crossing and a follow-up `final: true` after the streak idled out, so a single rage produced two server-side rows the dashboard had to reconcile. The detector now emits a single event with `final: true` and the full `click_count` once the streak ends (`streakIdleMs`, default 1500). On `pagehide`, in-progress bursts that crossed the threshold are flushed via the same code path so we don't lose data when the user closes the tab mid-rage.
+
+### New: stable element keys
+
+- New `stable_key: string | null` field on every `BehavioralEvent`. Built by walking up to four ancestors and emitting the first of `data-blocfeed-component` (→ `bf:component:<value>`), a `data-testid` family attribute (→ `bf:testid:<value>`), or `id` (→ `bf:id:<value>`). Lets the backend dedupe and aggregate events for the "same logical element" across re-renders even when the CSS selector path shifts.
+- The `rage_click` and `dead_click` detectors now key their internal grouping maps on `stable_key ?? selector`, so bursts and rate-limit budgets follow the logical element, not its current selector path.
+- New exported helper `buildStableElementKey(el, maxDepth?)` from `blocfeed/shared/dom`.
+
+---
+
 ## 0.19.0 — 2026-05-07
 
 ### Signal accuracy fixes