@pixygon/analytics

Analytics SDK for Pixygon apps — page views, events, error reporting to Discord, web vitals.

Install

npm install @pixygon/analytics

Setup

import PixygonAnalytics from '@pixygon/analytics'

PixygonAnalytics.init({
  projectId: '69c3e752b9e4643b1ba67ff8', // MongoDB ObjectId
  appName: 'Kartograf',                   // For error reports
  endpoint: 'https://api.pixygon.com/v1/analytics',
  autoTrack: true,
  trackClicks: true,
  trackTimeSpent: true,
})

API

import { track, page, identify, reportError } from '@pixygon/analytics'

// Track custom events
track('treasure_collected', { treasureId: '123', value: 50 })

// Track page views (auto-tracked if autoTrack: true)
page('/profile')

// Identify user
identify(userId, { plan: 'plus', level: 5 })

// Report errors to Discord (auto-reported for uncaught errors)
reportError(new Error('Something broke'), { componentStack, userId })

Error Reporting

Errors are automatically reported to Discord via POST /v1/errors/report:

• All uncaught window.onerror events
• All unhandledrejection events
• Manual reportError() calls (use in ErrorBoundary componentDidCatch)

Discord shows: app name, error message, stack trace, URL, user ID.