Interface AnalyticsFreshnessStateExperimental

Freshness of the underlying source observation. The field vocabulary deliberately matches ColumnarFreshnessV1 (src/columnar/types.ts) so a dashboard renders one badge for a columnar batch and an analytics artifact.

validator and generation are opaque, non-secret source identifiers. Producers must never place a bearer token, API key, cookie, or credential in them.

interface AnalyticsFreshnessState {
    authority: AnalyticsFreshness;
    generation?: string;
    observedAt: string;
    staleAfter?: string;
    validator?: string;
}

Properties

generation?: string

Opaque monotonic source generation or revision.

observedAt: string

RFC-3339 instant at which the source result was observed.

staleAfter?: string

RFC-3339 instant after which the artifact must be revalidated.

validator?: string

Opaque source validator, such as an HTTP ETag.