Type Alias: PreferenceChangedPaths

type PreferenceChangedPaths = Record<string, true> | [];

Paths affected by a preferences update, without their values.

Remarks

The server returns a map such as { 'theme.color': true }, or the empty array [] when a write makes no effective change. A non-empty array of ChangeSet writes or path strings is never returned.

The empty-string key ({ '': true }) signals a global refresh: consumers must reread all preferences instead of interpreting it as a preference path. An update notification may also carry [] during runtime resynchronization, when no path details are available. The SDK refreshes the complete local preferences before emitting EVENTS.UPDATED, including in that case.

Use Object.keys(changeset) to enumerate paths in either representation; do not call changeset.map(). Read updated values with preferences.get().