CommonPropertiesUtil class

Constructors

CommonPropertiesUtil()

Properties

hashCode → int

The hash code for this object.

no setter, inherited

runtimeType → Type

A representation of the runtime type of the object.

no setter, inherited

Methods

noSuchMethod(Invocation invocation) → dynamic

Invoked when a nonexistent method or property is accessed.

inherited

toString() → String

A string representation of this object.

inherited

Operators

operator ==(Object other) → bool

The equality operator.

inherited

Static Methods

getCommonProperties() → Future<Map<String, dynamic>>

Thread-safe getter for all common properties.

resetStaticState() → Future<void>

Reset all common properties. Must be called when the SDK is re-initialized to prevent stale user-set properties from a previous session leaking into the new one.

setCommonProperties(Map<String, dynamic> props) → Future<void>

Thread-safe setter for common properties (public API). Filters out reserved keys to prevent accidental overwrites.

setInternalProperty(String key, dynamic value) → Future<void>

Internal setter — bypasses reserved key check. Used by SDK internals (e.g. setting appid, platform, ip_country_code).

Constants

maxCommonProperties → const int

Maximum number of common properties allowed. Prevents unbounded memory growth if the app continuously adds unique keys.

reservedCommonKeys → const Set<String>

Keys reserved by the SDK — cannot be overwritten via public common properties API. Includes core SDK fields and default user property keys (device, geo, app_*).