@pyrx/synapse-browser

Lightweight browser tracking SDK (~5.3 KB minified) for the PYRX Synapse customer engagement platform.

Installation

Script Tag (recommended)

<script>
  !function(){var s=window.synapse=window.synapse||function(){
    (s.q=s.q||[]).push(arguments)};
    var e=document.createElement("script");
    e.type="text/javascript";e.async=true;
    e.src="https://synapse-events.pyrx.tech/sdk/v1/synapse.min.js";
    var x=document.getElementsByTagName("script")[0];
    x.parentNode.insertBefore(e,x);
  }();

  synapse('init', { apiKey: 'psk_live_YOUR_API_KEY' });
  synapse('page');
</script>

npm

npm install @pyrx/synapse-browser

import { synapse } from '@pyrx/synapse-browser';

synapse('init', { apiKey: 'psk_live_YOUR_API_KEY' });

Quick Start

// Identify a user
synapse('identify', 'user-123', {
  email: '[email protected]',
  first_name: 'Jane',
  plan: 'pro',
});

// Track an event
synapse('track', 'cart.abandoned', {
  product: 'Widget',
  price: 29.99,
});

// Track a page view
synapse('page');

// Reset on logout
synapse('reset');

Features

• Event queuing with localStorage persistence
• Automatic flush on interval (5s), batch size (10), and page unload (sendBeacon)
• Retry with exponential backoff
• Automatic page view tracking (URL, path, title, referrer)

Documentation

Full API reference and guides: synapse.pyrx.tech/developers/sdks/browser

License

MIT