opuskiln-analytics

Minimal, cookie-free page and event analytics for single-page apps. Events are sent to your collector (for example a Supabase Edge Function in India).

Install

npm install opuskiln-analytics

Usage

import { init, trackPageview, track } from "opuskiln-analytics";

init({
  endpoint: "https://YOUR_PROJECT.supabase.co/functions/v1/analytics-collect",
  websiteId: "your_site_public_key",
  apiKey: "your_supabase_anon_key", // Supabase gateway only; not stored server-side as identity
  respectDnt: true,
  spa: true,
});

trackPageview();
track("signup_clicked", { section: "hero" });

API

• init(options) — required before tracking
• trackPageview({ path?, title?, referrer? })
• track(eventName, props?)
• installGlobalErrorHandlers() — window error + unhandledrejection → js_error
• trackJsError({ type, message, source?, stack? }) — for React error boundaries
• trackApiError({ status?, path?, code?, message? }) — unexpected HTTP failures
• createAnalyticsFetch(baseFetch?) — wrap fetch (e.g. Supabase global.fetch) to emit api_error

Error events are deduped (same fingerprint once per ~30s) and capped per session. Strings are truncated; script URLs use basename only; API paths drop query strings.

No cookies. Does not send emails, names, or auth tokens. Optional coarse timezone and screen are attached only when enabled (default on).

License

MIT