Interface ColumnarBatchCacheRecordV1Experimental

One persisted cache record. Metadata only: the serialized envelope travels beside it so a backend can enumerate and evict without loading payloads.

observedAt is when this store wrote the record and drives eviction order; freshness.observedAt is when the producer observed the source and drives expiry.

interface ColumnarBatchCacheRecordV1 {
    authorizationScopeDigest: `sha256:${string}`;
    byteLength: number;
    envelopeVersion: string;
    format: "honua.columnar-batch-cache/1.0";
    freshness: ColumnarBatchCacheFreshnessV1;
    integrity: `sha256:${string}`;
    key: `sha256:${string}`;
    observedAt: string;
    orderingDigest: `sha256:${string}`;
    planId: string;
    rowCount: number;
    schemaVersion: string;
    sourceId: string;
    sourceVersion: string;
}

Properties

authorizationScopeDigest: `sha256:${string}`

Digest of the identity's authorization scope, never the scope itself.

byteLength: number
envelopeVersion: string

Envelope layout the payload was written at.

format
integrity: `sha256:${string}`

SHA-256 over the stored envelope bytes, verified on every read.

key: `sha256:${string}`
observedAt: string
orderingDigest: `sha256:${string}`

Digest of the ordering contract the batch was produced under.

planId: string
rowCount: number
schemaVersion: string
sourceId: string
sourceVersion: string