Appearance
namespace flake::MetaProperties
Meta-property tags (attached as auxiliary data, not user properties).
Attributes
| Name | |
|---|---|
| constexpr uint32_t | TIMESTAMP Timestamp of the last property modification (datetime). |
| constexpr uint32_t | TIMESTAMP_OFFSETS Per-property timestamp offsets, packed as a binary blob. |
| constexpr uint32_t | PROP_HISTORY Per-property value history, packed as a binary blob. |
| constexpr uint32_t | REPORT_SEQ Sequence number of one transmitted report part (uint32). |
Attributes Documentation
variable TIMESTAMP
cpp
constexpr uint32_t flake::MetaProperties::TIMESTAMPTimestamp of the last property modification (datetime).
variable TIMESTAMP_OFFSETS
cpp
constexpr uint32_t flake::MetaProperties::TIMESTAMP_OFFSETSPer-property timestamp offsets, packed as a binary blob.
Layout: a sequence of ``(tag_id:uint16, offset_sec:uint16) pairs in host byte order. For each pair, the receiver reconstructs the property's true timestamp as TIMESTAMP + offset_sec, where TIMESTAMP is the message-level meta property carrying the snapshot's base time. Properties not listed in the blob are treated as offset 0 (i.e. they share the snapshot base).
Used by ObjectImpl::defer() to preserve per-defer timing when multiple defers merge into a single deferred slot (offset_sec caps at 65535 — slots split before that). Senders may omit this meta entry entirely when all offsets in a snapshot are 0.
variable PROP_HISTORY
cpp
constexpr uint32_t flake::MetaProperties::PROP_HISTORYPer-property value history, packed as a binary blob.
Carries the older samples of one or more user properties whose value was overwritten by a subsequent defer() merge on the same deferred slot. The current (newest) value of each such property still travels as a regular Property in the message body — receivers ignoring this meta see exactly the latest value, matching the long-standing "changed = property is now this value" semantics. Interested receivers (e.g. time-series loggers) decode the blob to reconstruct intermediate samples.
Layout (all integers host byte order):
* blob := entry*
* entry :=
* [tag : u32] full Property tag (id | type | flags)
* [count : u16] number of older samples for this tag
* sample[count] :=
* [offset_sec : u16] seconds since the slot's base TIMESTAMP
* [value : N] type-dependent bytes (see Note)
* ```
The newest sample is _not_ present here — it sits in the regular [Property](/embed/2.2.0/API/Classes/classflake_1_1Property.md) body, with its offset (if any) carried by [TIMESTAMP_OFFSETS](/embed/2.2.0/API/Namespaces/namespaceflake_1_1MetaProperties.md#variable-timestamp-offsets). Samples are written in chronological order so the receiver's reconstruction is just `[entries by ascending offset_sec...] + [body value]`.
Note on value encoding: fixed-size scalar types (bool, u8/i8 ... u64/i64, float, datetime, uuid) emit their native byte width with no length prefix. Variable-length types (TT_STRING, TT_BIN) emit a `u16` length prefix followed by the raw bytes. [Array](/embed/2.2.0/API/Classes/classflake_1_1Array.md) and stream type codes are not representable in a history entry; `defer()` does not archive properties of those types.
### variable **REPORT_SEQ**
```cpp
constexpr uint32_t flake::MetaProperties::REPORT_SEQSequence number of one transmitted report part (uint32).
``(boot_random << 16) | part_counter. Every transmission gets a fresh number, a retransmission after a lost confirmation included, because the retried part may carry samples that were merged in meanwhile. The number therefore identifies network duplicates and gaps; idempotent storage of retransmitted samples rests on (property, time, value). Only sent once the router has confirmed the contact interval (ParameterProperties::CONTACT_INTERVAL), which is how a sender knows the receiver speaks Spec 1.2.