track

fun track(name: String, properties: Map<String, Any?> = emptyMap(), destinations: Set<String>? = null)

Track an event. Returns immediately; persistence and delivery happen on a background dispatcher.

Parameters

name

Event name. Must be 1–128 chars, alphanumeric + underscore. Names outside this pattern are rejected and a diagnostic counter is incremented.

properties

Event properties. Values must be JSON-serialisable primitives, lists, or nested maps. Non-serialisable values are coerced to their toString() representation.

destinations

Optional whitelist of destination IDs (e.g. "backend", "firebase"). When null, all configured adapters that accept the event will receive it.