Trackjs-sdk

Automatic user behavior tracking SDK for React applications, capturing clicks, form submissions, and input changes via document-level event delegation—no in-component modifications required.

Table of Contents

- Features
- Installation
- Usage

Features

- Zero-config instrumentation via document-level event delegation—no boilerplate in React components.
- Automatic batching of events with configurable batch size and interval.
- Reliable delivery using navigator.sendBeacon() with fetch(..., { keepalive: true }) fallback for unload scenarios.
- Input sanitization & masking to strip HTML and redact sensitive fields (e.g., passwords).
- GDPR & DNT compliance with an opt-out API (disableTracker()).

Installation

Install via npm:

``bash
npm install trackjs-sdk
`

Usage

`js
import { initTracker } from "trackjs-sdk";

initTracker({
endpoint: "https://api.yourdomain.com/track",
apiKey: "YOUR_API_KEY",
batchSize: 20,
batchInterval: 5000,
maskInputs: ["password", "credit-card"],
enableBeacon: true,
debug: false,
});
``