@syntarie/tracking

The browser SDK for leadmaps. It sends privacy-gated product analytics to your leadmaps workspace and keeps optional features in separate imports.

Package migration: new installations should use @leadmaps/tracking. This compatibility package remains supported for 60 days after the canonical stable release. Existing installations continue to work during that window.

Install

pnpm add @syntarie/tracking

import { grantConsent, init, track } from '@syntarie/tracking';

init({
  apiKey: 'lk_live_xxx',
  siteId: 'your-site-id',
});

consentBanner.onAccept((record) => grantConsent(record.id));

track('checkout_completed', { plan: 'pro' });

Consent starts in the unknown state. The SDK does not send analytics until the visitor grants consent, unless you explicitly configure another lawful mode. Consent is also enforced by the leadmaps collector.

Optional modules

Import only what your site uses:

import { installVitals } from '@syntarie/tracking/vitals';
import { installErrors } from '@syntarie/tracking/errors';
import { installHeatmap } from '@syntarie/tracking/heatmap';

Additional subpaths cover click and scroll capture, engaged time, retry and offline behavior, feedback, feature flags, ecommerce, forms, Experience analytics, and consented session replay. See the SDK documentation for the full list and setup guidance.

Privacy and data boundaries

• Consent is default-deny and can be withdrawn at runtime.
• Anonymous privacy mode does not enable replay, heatmaps, movement analytics, or cross-day visitor identity.
• Form analytics exclude values, free text, passwords, payment fields, file names, contenteditable content, and keystrokes.
• Experience analytics use bounded interaction summaries. Exact movement is available only inside consented, masked replay.
• Pointer activity is not eye tracking.

Browser SDK code is delivered to the browser and can be inspected. leadmaps keeps product prioritization, commercial analysis, tuning data, and AI prompts on the server.

Move to the canonical package

pnpm remove @syntarie/tracking
pnpm add @leadmaps/tracking

Then replace @syntarie/tracking with @leadmaps/tracking in imports. The API and subpath names are unchanged for this release.

Support and license

Read the documentation or contact [email protected]. This package is source-available under the included license.