@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. If your edge function is deployed at a different path (for example, a single-segment hyphenated name like v1-batch rather than a nested v1/batch/ directory), pass eventPath to control the composition. Added in 1.2.0.

umap360.init({
  writeKey: 'uk_live_YOUR_WRITE_KEY',
  apiHost: 'https://YOUR_SUPABASE_REF.supabase.co/functions/v1',
  eventPath: '/v1-batch',  // POSTs to <apiHost>/v1-batch instead of <apiHost>/v1/batch
});

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