Skip to content

namespace flake::MetaProperties ​

Meta-property tags (attached as auxiliary data, not user properties).

Attributes ​

Name
constexpr uint32_tTIMESTAMP
Timestamp of the last property modification (datetime).
constexpr uint32_tTIMESTAMP_OFFSETS
Per-property timestamp offsets, packed as a binary blob.
constexpr uint32_tPROP_HISTORY
Per-property value history, packed as a binary blob.
constexpr uint32_tREPORT_SEQ
Sequence number of one transmitted report part (uint32).

Attributes Documentation ​

variable TIMESTAMP ​

cpp
constexpr uint32_t flake::MetaProperties::TIMESTAMP

Timestamp of the last property modification (datetime).

variable TIMESTAMP_OFFSETS ​

cpp
constexpr uint32_t flake::MetaProperties::TIMESTAMP_OFFSETS

Per-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_HISTORY

Per-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_SEQ

Sequence 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.