# @vektis-io/tracker
> Browser JavaScript SDK for sending engagement events to VEKTIS. Zero runtime dependencies,
Latest version **1.4.1** (published 2026-09-23) · MIT license · 0 weekly downloads
## Install
```sh
npm install @vektis-io/tracker
pnpm add @vektis-io/tracker
yarn add @vektis-io/tracker
bun add @vektis-io/tracker
```
## Health
**Score 75/100 (B)** — status: active.
Positive: has types; esm support; no vulnerabilities; has provenance; recently updated; high maintenance score; high quality score.
Warnings: low downloads.
## Facts
| | |
|---|---|
| Version | 1.4.1 |
| Published | 2026-09-23 |
| First published | 2026-04-27 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Node | >=20.0.0 |
| Dependencies | 0 |
| Unpacked size | 210.6 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Provenance | attested (GitHub Actions) |
| GitHub stars | 0 |
| Author | VEKTIS Labs PBC |
| Maintainers | orion2k |
| Keywords | vektis, analytics, tracker, tracking, events, browser, sdk |
## Links
- npm: https://www.npmjs.com/package/@vektis-io/tracker
- Repository: https://github.com/vektis-dev/tracker-js
- Homepage: https://github.com/vektis-dev/tracker-js#readme
- Issues: https://github.com/vektis-dev/tracker-js/issues
- npm.io page: https://npm.io/package/@vektis-io/tracker
## Alternatives
- [@opentelemetry/exporter-zipkin](https://npm.io/package/@opentelemetry/exporter-zipkin.md) — 14.8M weekly downloads
- [pusher-js](https://npm.io/package/pusher-js.md) — 2.0M weekly downloads
- [browserify](https://npm.io/package/browserify.md) — 1.7M weekly downloads
- [sqs-consumer](https://npm.io/package/sqs-consumer.md) — 1.7M weekly downloads
- [@sanity/eventsource](https://npm.io/package/@sanity/eventsource.md) — 930.8K weekly downloads
## Recent versions
- 1.4.1 (latest) — 2026-09-23
- 1.0.0-rc.1 (rc) — 2026-04-27
- 0.0.1 (bootstrap) — 2026-04-27
- 1.4.0 — 2026-09-23
- 1.3.0 — 2026-05-26
- 1.2.0 — 2026-05-12
- 1.1.1 — 2026-05-10
- 1.1.0 — 2026-05-04
- 1.0.0 — 2026-04-27
## README
# @vektis-io/tracker
Browser JavaScript SDK for sending engagement events to VEKTIS. Zero runtime dependencies. <8KB gzipped.
**Full documentation:** [docs.vektis.io/integrations/tracker](https://docs.vektis.io/integrations/tracker) — per-framework guides, CSP setup, reset-on-logout snippets, and the complete error catalog.
[VEKTIS](https://vektis.io) helps software teams measure which engineering work actually delivers customer impact. `@vektis-io/tracker` is the browser-side half of the Impact Tracking data path. The SDK is **explicit-call-only** — it never auto-captures clicks, page views, errors, or anything else. The only events on the wire are the ones your code asks it to send. See also: [`@vektis-io/events-schema`](https://www.npmjs.com/package/@vektis-io/events-schema) — the shared schemas the SDK and the server validate against.
## Quick start — script tag (zero customer code)
Generate a **publishable** key (`vk_pub_*`) in the VEKTIS dashboard and drop a single tag into your ``:
```html
```
The SDK reads its own `data-vektis-*` attributes at load time, calls `init()` and (if `data-vektis-customer-id` is set) `identify()` for you, and exposes a global `vektis` for `track()` calls anywhere in your page code.
Available attributes:
| Attribute | Purpose |
| --- | --- |
| `data-vektis-key` *(required)* | Your publishable key (`vk_pub_*`). |
| `data-vektis-endpoint` | Override the ingest URL. Defaults to `https://events.vektis.io/api/v1/events`. |
| `data-vektis-debug` | Presence enables debug-mode console warnings. `"false"` disables. |
| `data-vektis-customer-id` | If set, triggers `identify({ customer_id })` automatically. |
| `data-vektis-user-id` | Included on `identify()` when `data-vektis-customer-id` is set. |
> **This path needs a classic `
```
jsDelivr is also supported: `https://cdn.jsdelivr.net/npm/@vektis-io/tracker@1/dist/vektis-tracker.iife.js`.
## API reference
| Method | Description |
| --- | --- |
| `init({ apiKey, endpoint?, flushIntervalMs?, flushThreshold?, allowFullScopeKey?, debug? })` | Initialize the SDK. Call once at app startup, or omit entirely if using the script-tag `data-vektis-*` path. |
| `initFromDataset(el?)` | Initialize from `data-vektis-*` attributes on `el` (defaults to the first `[data-vektis-key]` element). The ESM/importmap equivalent of the script-tag path. |
| `identify({ customer_id, user_id? })` | Set the identity for subsequent events. Required before `track()`. |
| `track(event_type, { feature_id?, action?, properties? })` | Send an engagement event. `feature.*` events require `feature_id`. |
| `flush()` | Force-flush the queue. Returns `Promise`. |
| `reset()` | Flush, clear identity, return to UNINITIALIZED. Call on logout. |
| `getStatus()` | Inspect state machine + queue + identity. |
Event types: `feature.used`, `feature.engagement`, `feature.first_use`, `session.active`, `customer.identified`.
## License
MIT. See [LICENSE](./LICENSE).
---
_Source: https://npm.io/package/@vektis-io/tracker · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._