Enum TimestampResolution 

pub enum TimestampResolution {
    Offset(Offset),
    BeforeRetentionHorizon {
        horizon_ns: i64,
    },
    LogEmpty,
}

Outcome returned by a timestamp→offset resolver.

v0.6.0 Tier 2 #6 — a resolver that owns its own index (the runtime’s in-memory timestamp index, an audit-log-backed index, etc.) can distinguish three cases that Option<Offset> cannot:

• We found an offset at or before the requested timestamp.
• The log has entries, but the earliest is after the requested timestamp — i.e. the request predates the retention horizon. Surfacing this as a distinct variant lets the query layer emit QueryError::AsOfBeforeRetentionHorizon with the horizon attached, which is far more actionable to the caller.
• The log is empty — no timestamps recorded yet.

See QueryEngine::query_at_timestamp_resolved for the consumer of this type.

Variants

Offset(Offset)

Resolver found a projection offset whose commit timestamp is the greatest value ≤ the target.

BeforeRetentionHorizon

Resolver has entries, but the earliest commit timestamp is strictly greater than the target. horizon_ns is that earliest timestamp, so callers can tell users “the oldest retained data is <horizon>, try a later instant”.

Fields

horizon_ns: i64

LogEmpty

Resolver has no entries at all (fresh DB or the index hasn’t been seeded yet). Indistinguishable from “predates genesis” in observable behaviour — surfaced via UnsupportedFeature.

Trait Implementations

impl Clone for TimestampResolution

fn clone(&self) -> TimestampResolution

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for TimestampResolution

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl PartialEq for TimestampResolution

fn eq(&self, other: &TimestampResolution) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for TimestampResolution

impl Eq for TimestampResolution

impl StructuralPartialEq for TimestampResolution