Tracking

Rule

The tracking system provides a single track() call that fans out to all registered providers. Built-in providers auto-register from env vars -- set the var and tracking starts. Custom providers can be registered for any analytics backend. Tracking is server-side only, best-effort, and never blocks request handling.

How It Works

1. At server startup, registerBuiltinProviders() checks env vars and registers any configured providers.
2. Application code calls track(eventName, properties, meta) from actions, plugins, or server routes.
3. The registry fans out the event to every registered provider. Errors are caught and logged -- a failing provider never crashes the caller.
4. Built-in providers batch HTTP calls (flush every 10 seconds or 50 events, whichever comes first).

API

track(name, properties?, meta?)

Fire an analytics event.