Configuration

const metrics = createMetricsClient("mtr_your_key", {
  // ── Connection ──
  endpoint: "https://metrics.harshit.page/api/collect",

  // ── Batching ──
  flushIntervalMs: 3000,    // Flush every 3 seconds
  maxBatchSize: 20,         // Max events per batch
  maxQueueSize: 500,        // Max events in queue before dropping oldest

  // ── Retries ──
  retryCount: 3,            // Retry attempts per flush
  retryBackoffMs: 500,      // Base backoff (doubles each retry)

  // ── Persistence ──
  persistQueue: true,       // Persist queue to localStorage
  storageKey: "metrics-sdk", // localStorage key prefix

  // ── Auto-tracking ──
  autoTrackPageviews: true,      // Track pageviews on init
  autoTrackRouteChanges: true,   // Track SPA route changes
  autoTrackClicks: false,        // Track data-track-click elements
  autoTrackOutbound: false,      // Track external link clicks
  autoTrackForms: false,         // Track form submissions
  autoTrackScrollDepth: false,   // Track scroll milestones
  autoTrackErrors: false,        // Capture unhandled errors
  autoTrackWebVitals: false,     // Capture Web Vitals

  // ── Scroll depth ──
  scrollThresholds: [25, 50, 75, 100], // Scroll percentages to track

  // ── Enrichment ──
  captureUtmParams: true,   // Auto-capture UTM parameters
  enrichDeviceInfo: true,    // Add browser, OS, screen info

  // ── Sessions ──
  sessionTimeoutMs: 1800000, // 30 minutes session timeout

  // ── Debug ──
  debug: false,              // Log SDK activity to console

  // ── Advanced ──
  fetchImplementation: fetch, // Custom fetch for Node.js/testing
  onError: (err) => {},       // Error callback
});