Interface AnalyticsArtifactIdentityExperimental

Identity of an accepted analytics artifact. The lineage tuple (artifactId, sourceId, planFingerprint) plus the artifact's kind and dimension decides whether a later artifact patches the presentation or invalidates it; sequence orders deltas within one lineage so a late delta is ignored instead of overwriting newer numbers.

interface AnalyticsArtifactIdentity {
    acceptedAt: string;
    artifactId: string;
    cacheKey?: string;
    freshness: AnalyticsFreshnessState;
    planFingerprint?: string;
    planId?: string;
    sequence: number;
    sourceId: string;
    sourceVersion?: string;
}

Properties

acceptedAt: string

RFC-3339 instant the host accepted the artifact.

artifactId: string

Stable id for this widget's artifact lineage (not per-update).

cacheKey?: string

Deterministic cache key of the producing request, when the producer has one.

planFingerprint?: string

Fingerprint of the query plan that produced the artifact — pass QueryExecutionPlan["fingerprint"] when a plan was explained, or any deterministic digest of the request otherwise.

planId?: string

Plan id when the artifact came from an explained/executed plan.

sequence: number

Monotonic counter within one lineage. Deltas must not go backwards.

sourceId: string
sourceVersion?: string

Source version the artifact was computed against.