Node.js SDK

The ListenLayer Node.js SDK for server-side tracking.

Installation

npm install @listenlayer/node

Quick Start

const { ListenLayer } = require('@listenlayer/node');

const ll = new ListenLayer({
  apiKey: process.env.LISTENLAYER_API_KEY
});

// Track an event
await ll.track({
  userId: 'user_123',
  event: 'purchase',
  properties: {
    transaction_id: 'txn_456',
    value: 99.99
  }
});

Methods

track()

Track a user event.

await ll.track({
  userId: 'user_123',        // Required
  event: 'purchase',         // Required
  properties: { ... },       // Optional
  timestamp: new Date(),     // Optional
  context: { ... }           // Optional
});

identify()

Identify a user with traits.

await ll.identify({
  userId: 'user_123',
  traits: {
    email: '[email protected]',
    name: 'Jane Doe',
    plan: 'enterprise'
  }
});

page()

Track a page view (for SSR apps).

await ll.page({
  userId: 'user_123',
  name: 'Pricing',
  properties: {
    url: '/pricing',
    referrer: '/home'
  }
});

Batching

Events are automatically batched for efficiency:

const ll = new ListenLayer({
  apiKey: process.env.LISTENLAYER_API_KEY,
  flushAt: 20,      // Flush after 20 events
  flushInterval: 10000  // Or every 10 seconds
});

Error Handling

try {
  await ll.track({ ... });
} catch (error) {
  console.error('Tracking failed:', error.message);
}