@litemetrics/node 0.1.2 → 0.2.0

package/README.md

@@ -69,7 +69,7 @@ const collector = await createCollector({
 - **Bot Filtering** - Automatically drops events from known bots and crawlers
 - **GeoIP Enrichment** - Resolves country/city from IP using MaxMind GeoLite2
 - **User-Agent Parsing** - Extracts browser, OS, and device type
-- **Hostname Filtering** - Only count events from allowed hostnames per site
+- **Hostname Filtering** - Only count events from allowed hostnames per site (matched against request Origin/Referer)
 - **Query API** - Built-in metrics for pages, events, conversions, and behavioral insights
 - **Segmentation Filters** - Filter any metric/time series by geo, device, UTM, referrer, or event metadata
 - **Time Series** - Hourly/daily/weekly/monthly breakdowns
@@ -87,6 +87,22 @@ await collector.track('site-id', 'Purchase', { amount: 99 }, { userId: 'user-123
 await collector.identify('site-id', 'user-123', { plan: 'pro' });
 ```
 
+## Identity Merging
+
+Litemetrics automatically links anonymous visitors to identified users. After a
+user is identified, subsequent events are merged across all linked visitor IDs.
+`GET /api/users/:identifier` accepts either a `visitorId` or a `userId` and
+returns a merged profile when available.
+
+### Backfill (one-time)
+
+If you already have identify events, run the backfill script once to populate
+the identity map:
+
+```bash
+bun packages/node/src/backfill-identity.ts --adapter clickhouse --url http://localhost:8123
+```
+
 ## Metrics
 
 | Metric | Description |