@sanvika/tracking
v0.6.1
Published
Sanvika Tracking SDK — web (React) + bare React Native + server S2S for all Sanvika projects
Maintainers
Readme
@sanvika/tracking
Sanvika Central Analytics Platform SDK — Activity (Lane A) + Business Analytics (Lane B).
Install
pnpm add @sanvika/trackingExports
| Import | Surface |
|--------|---------|
| @sanvika/tracking / @sanvika/tracking/react | Web React |
| @sanvika/tracking/react-native | Bare RN |
| @sanvika/tracking/server | Node / Next BFF |
Lane A — Activity (stable)
TrackingProvider,ActivityTracker,useActivityTracker- RN
activityTrackerscreen/activity helpers - Server
track/trackActivity/proxyMobileTrackingEvent
Posts to POST /api/v1/track → trackingevents.
Lane B — Business Analytics (0.5+)
- Server:
trackBusinessEvent,trackBusinessBatch,proxyMobileAnalyticsEvent,generateEventId - Web:
useAnalytics()→trackBusinessEvent,trackSessionStart,trackSessionEnd,flushQueue - RN:
activityTracker.trackBusinessEvent,trackSessionStart/End,flushAnalyticsQueue
Posts to:
POST /api/v1/analytics/eventsPOST /api/v1/analytics/events/batch
Transport
- Exponential backoff retries
- Web IndexedDB offline queue
- RN AsyncStorage offline queue
- Optional gzip (
CompressionStream) when available - Transport metrics via
getTransportMetrics()
Versioning
Additive minors only for public APIs. See CHANGELOG.md and MIGRATION.md.
Tree shaking
Package is ESM ("type": "module"). Import only the subpath you need (/server, /react-native) so bundlers can drop unused surfaces.
