Interface AcceptWidgetArtifactOptionsExperimental

Caller-supplied identity and presentation metadata for the bridge.

interface AcceptWidgetArtifactOptions {
    acceptedAt?: string;
    artifactId: string;
    attribution?: readonly string[];
    freshnessAuthority?:
        | "stale"
        | "live"
        | "replaying"
        | "cached";
    measure?: Partial<AnalyticsMeasure>;
    now?: number;
    observedAt?: string;
    ordering?: AnalyticsOrdering;
    planFingerprint?: string;
    planId?: string;
    rowBudget?: number;
    sequence?: number;
    sourceVersion?: string;
    title?: string;
}

Properties

acceptedAt?: string

RFC-3339 acceptance instant.

now
artifactId: string

Stable lineage id for the widget. Reused across refreshes and deltas.

attribution?: readonly string[]

Attribution a presentation must display.

freshnessAuthority?:
    | "stale"
    | "live"
    | "replaying"
    | "cached"

Freshness authority.

"cached" when the result is cacheable, else "live"

measure?: Partial<AnalyticsMeasure>

Measure metadata overrides (unit, precision, label).

now?: number

Clock injection for status derivation.

observedAt?: string

RFC-3339 source-observation instant.

acceptedAt

Ordering override when the caller sorted the buckets itself.

planFingerprint?: string
planId?: string

Plan id / fingerprint when the widget ran through an explained plan.

rowBudget?: number

Client-fallback row ceiling the widget source was configured with.

sequence?: number

Monotonic counter within the lineage.

0
sourceVersion?: string

Source version / etag the response was computed against.

title?: string