import { createClient } from '@litemetrics/client';

const client = createClient({
  baseUrl: 'https://your-server.com',
  siteId: 'your-site-id',
  secretKey: 'your-secret-key',
});

Querying Stats

// Overview metrics
const overview = await client.getOverview(
  ['pageviews', 'visitors', 'sessions'],
  { period: '7d', compare: true }
);

// Top pages
const pages = await client.getStats('top_pages', { period: '30d', limit: 10 });

// Top referrers
const referrers = await client.getStats('top_referrers', { period: '7d' });

// Country breakdown
const countries = await client.getTopCountries({ period: '30d', limit: 50 });

Time Series

const timeseries = await client.getTimeSeries({
  metric: 'pageviews',
  period: '30d',
  granularity: 'day',
});

// Returns: { data: [{ date: '2025-01-01', value: 142 }, ...] }

Events & Users

// List events
const events = await client.getEventsList({
  type: 'pageview',
  period: '24h',
  limit: 50,
});

// List users
const users = await client.getUsersList({ limit: 20 });

// User detail
const user = await client.getUserDetail('visitor-id');

Retention

const retention = await client.getRetention({ period: '90d', weeks: 8 });
// Returns weekly cohort retention data

Site Management

import { createSitesClient } from '@litemetrics/client';

const sites = createSitesClient({
  baseUrl: 'https://your-server.com',
  adminSecret: 'your-admin-secret',
});

// CRUD
const { site } = await sites.createSite({ name: 'My App', domain: 'myapp.com' });
const { sites: allSites } = await sites.listSites();
await sites.updateSite(site.siteId, { allowedOrigins: ['myapp.com'] });
await sites.deleteSite(site.siteId);
await sites.regenerateSecret(site.siteId);