@advenue/sdk-core

Platform-agnostic TypeScript core of the Advenue SDK — the open-source, self-hostable mobile attribution platform (MMP).

Provides AdvenueClient (event tracking with batching and offline queueing), durable device identity, HMAC request signing, and deferred deep-link / conversion lookups. Runs anywhere fetch exists; it embeds no server secrets.

Most apps should use a platform wrapper instead of this package directly — @advenue/react-native wires storage, native modules and lifecycle for you.

Install

npm install @advenue/sdk-core

Usage

import { AdvenueClient } from '@advenue/sdk-core';

const client = new AdvenueClient({
  apiKey: 'apk_live_...',   // from your Advenue dashboard
  platform: 'ios',
  // endpoint: 'https://ingest.your-domain.com',  // self-hosted only
});

client.track('purchase', { revenue: 9.99, currency: 'USD' });
await client.flush();

The adv_ event-name prefix (e.g. adv_meta_aem) is reserved for Advenue-internal signals — don't name your own custom events with it. Such events are still accepted by track() (the pipeline relies on them) but are hidden from analytics surfaces like the dashboard's funnel event picker.

Docs

docs.advenue.io

License

MIT — the SDK is intentionally MIT-licensed so it can ship inside any app. The Advenue server platform is licensed separately (AGPLv3).