Interface OfflineRegionReadCacheDecisionV1

What the persistent cache did, and why.

regionId is the region manifest's own content digest, so anything served from storage is traceable to the exact snapshot identity that produced it.

interface OfflineRegionReadCacheDecisionV1 {
    action: "reuse";
    ageMs: number;
    authorizationScopeDigest: `sha256:${string}`;
    completeness: "complete" | "partial";
    freshness: OfflineRegionReadFreshness;
    kind: "honua.offline-region-read";
    observedAt: string;
    policy: "prefer-cache";
    queryFingerprint: `sha256:${string}`;
    reason: "stale-entry" | "offline-entry";
    regionId: `sha256:${string}`;
    resources: readonly {
        byteLength: number;
        id: string;
        integrity: `sha256:${string}`;
        kind: OfflineRegionResourceKind;
    }[];
    staleAfterMs: number;
    state: "offline";
    version: "1.0";
}

Properties

action ageMs authorizationScopeDigest completeness freshness kind observedAt policy queryFingerprint reason regionId resources staleAfterMs state version

Properties

Readonlyaction

action

ReadonlyageMs

ageMs: number

ReadonlyauthorizationScopeDigest

authorizationScopeDigest: `sha256:${string}`

Readonlycompleteness

completeness: "complete" | "partial"

Readonlyfreshness

freshness: OfflineRegionReadFreshness

Readonlykind

kind

ReadonlyobservedAt

observedAt: string

Readonlypolicy

policy

ReadonlyqueryFingerprint

queryFingerprint: `sha256:${string}`

Readonlyreason

reason: "stale-entry" | "offline-entry"

ReadonlyregionId

regionId: `sha256:${string}`

Region manifest identity. Binds this answer to one snapshot.

Readonlyresources

resources: readonly {
    byteLength: number;
    id: string;
    integrity: `sha256:${string}`;
    kind: OfflineRegionResourceKind;
}[]

Exactly which stored resources answered this read.

ReadonlystaleAfterMs

staleAfterMs: number

Readonlystate

state

Readonlyversion

version

Settings

Member Visibility

On This Page

Properties