Browser SDK

Use this guide for browser applications — vanilla JavaScript and frameworks like Vue, Svelte, and Angular.

For session flow and event schemas, see the REST API. For a guided first integration, see Quickstart.

Install

npm install @trichidata/browser

@trichidata/browser provides TrichiDataClient configured for browser environments. The client uses credentials: 'include' so the browser stores the sdk_session cookie automatically after init().

Usage

import { TrichiDataClient } from '@trichidata/browser';

const client = new TrichiDataClient({
  apiKey: 'prj_ak_xxxxxxxxxxxx',
});

await client.init(); // device + tracking cookies under the hood

await client.identify({ userId: 'usr_7f3a9b2c', appVersion: '2.4.1' });

await client.page(); // page context filled from window/document
await client.productViewed({ productId: 'sku_1', name: 'Shoes', price: 99, currency: 'USD' });
await client.trackCustom('promo_banner_click', { slot: 'hero' });

init() collects device info and tracking automatically: _ga / _fbp / _fbc / fbclid when present; otherwise the SDK generates a GA-like clientId. You can override with init({ device, tracking }).

Helpers

Client methods

See REST API for reserved eventName values and properties schemas.

See also

• Quickstart — track your first event
• REST API — event schemas and HTTP reference
• React SDK — if you use React