Function emitAnalyticsEvent

Emit one declared analytics event, surfacing refusals as typed errors.

forbidden | invalid-params | budget — see the module header.

  • Parameters

    • name: string

      a declared, app-namespaced event name (myapp.somethingHappened). It may not collide with the host vocabulary.

    • Optionalprops: Record<string, AnalyticsPropValue>

      declared properties only. An undeclared key REJECTS the event — nothing is stripped, because a silently dropped key turns a leak into a green test.

    Returns Promise<AnalyticsAck>