@umap360/sdk-web

Official UMAP360 Web Analytics SDK with identity resolution and browser fingerprinting.

Published on npm: @umap360/sdk-web

Quick Start

npm install @umap360/sdk-web

import umap360 from '@umap360/sdk-web';

umap360.init({
  writeKey: 'uk_live_YOUR_WRITE_KEY',
  apiHost: 'https://YOUR_SUPABASE_REF.supabase.co/functions/v1',
});
umap360.track('Button Clicked', { button_name: 'signup' });

By default the SDK POSTs to <apiHost>/v1-batch — the canonical UMAP360 edge function name. Override eventPath only if your edge function is deployed at a different path. The eventPath option was added in 1.2.0 (initial default /v1/batch was structurally broken); 1.3.0 flipped the default to /v1-batch so the out-of-the-box configuration works without any override.

umap360.init({
  writeKey: 'uk_live_YOUR_WRITE_KEY',
  apiHost: 'https://YOUR_SUPABASE_REF.supabase.co/functions/v1',
  // eventPath defaults to '/v1-batch' since 1.3.0. Set explicitly only if
  // your deployment uses a different path, or set to '' if apiHost is
  // already the full event-ingest URL.
});

Documentation

Full SDK documentation — installation, configuration, API reference, framework integrations, privacy/GDPR, plugins, and debugging — lives in:

docs/reference/features/13-sdk-integration.md

Development

cd sdk-web
npm install
npm run build       # Build ESM + CJS + UMD bundles
npx vitest run      # Run 50 tests

License

MIT