Interface ReadOfflineRegionQueryOptions<T>Experimental

Answering a protocol-neutral Query from a persisted region.

The read path is deliberately narrow. It replays the snapshot a selection captured and refines only the pagination window, because that is the one refinement a stored batch can honour exactly. Everything else fails closed: a construct the region cannot answer raises HonuaCapabilityNotSupportedError, and a selection the region does not cover raises a typed cache miss. Nothing here reaches the network, revalidates, or widens a query, and no result is ever presented as live.

interface ReadOfflineRegionQueryOptions<T> {
    authorizationScopeFingerprint: string;
    bounds?: OfflineRegionBounds;
    expect?: {
        planVersion?: string;
        schemaVersion?: string;
        sourceVersion?: string;
    };
    now?: (() => Date);
    query?: Query<T>;
    selector?: OfflineRegionResourceSelector;
    signal?: AbortSignal;
    staleAfterMs?: number;
    store: OfflineRegionStore;
}

Type Parameters

  • T = Record<string, unknown>

Hierarchy

Properties

authorizationScopeFingerprint: string

The caller's current authorization-scope partition input. Its digest must equal the region's, so a scope change can never serve another principal's cached bytes.

Extent the caller is asking about. Must equal the region's own extent.

expect?: {
    planVersion?: string;
    schemaVersion?: string;
    sourceVersion?: string;
}

Versions the caller expects. A drift fails closed instead of serving stale schema.

now?: (() => Date)
query?: Query<T>

Protocol-neutral query intent. Omitted means the snapshot's own selection.

Discriminator when a selection stores several feature batches.

signal?: AbortSignal
staleAfterMs?: number