Usage Beacon
RowOps includes an internal usage beacon used for abuse detection around export, sync, and import completion events. It is disabled by default and only sends when explicitly enabled by the host runtime.
Default behavior
- Disabled by default.
- No network traffic unless the host enables it.
- Payloads contain aggregate metrics only (no row data, schema, or column names).
Network path
All usage beacon network activity is centralized in
packages/core/engine/src/internal/usage_beacon.ts via sendUsageBeacon. The endpoint is
host-configured; there is no default endpoint.
Configuration (host runtime)
The host runtime must call configureUsageBeacon with enabled: true, endpoint, and
projectId to allow sending. If enabled is not explicitly true, the beacon does not send.
Payload fields
| Field | Type | Notes |
|---|---|---|
| event | string | One of export, sync, import_complete. |
| projectId | string | Project ID from entitlement token. |
| tier | string | Tier at time of operation. |
| rowCount | number | Rows processed. |
| fileBytes | number | Export only. |
| featuresUsed | string[] | Import completion only. |
| timestamp | number | Unix epoch milliseconds. |
| sessionNonce | string | Random nonce for deduplication. |
| signature | string | Optional HMAC signature when entitlement token is available. |