Clears all items in a specific category. If no category is specified, clears the default category only.
The category to clear
Gets all keys in a specific category.
The category to list keys from
Retrieves a value from storage. The implementation is responsible for any deserialization required by the underlying medium:
Returns null for missing keys or corrupt entries.
Expected type of the stored value. Caller-controlled — the provider does
not validate the runtime shape against this type. Falls back to unknown.
The key to retrieve
Optionalcategory: stringOptional category for key isolation (e.g., 'RunViewCache', 'Metadata')
Batched retrieval — reads N values for N keys in one logical operation.
Returns a Map keyed by the input key strings. Missing keys map to null.
The map preserves the original key set so callers can index by key without
relying on array-position alignment.
Why batch? IndexedDB serializes transactions on the same object store —
Promise.all([...N GetItem calls]) looks parallel but pays per-transaction
setup cost (~3–10ms each) for every key. A single transaction with N
get() calls amortizes that overhead. Redis can use MGET/pipelines.
In-memory implementations have no real win but implement consistently for
a uniform API.
Implementations are free to fall back to per-key reads internally if the
underlying medium doesn't support batching — the contract is just "read
all of these as efficiently as you can". An empty keys array returns
an empty map without touching the storage backend.
Expected type of all stored values. Caller-controlled.
The keys to retrieve. Duplicates are deduplicated; the returned map has one entry per unique key.
Optionalcategory: stringOptional category for key isolation (applies to all keys)
Removes an item from storage.
The key to remove
Optionalcategory: stringOptional category for key isolation
Stores a value. Callers should pass plain data (objects/arrays/primitives/Date/etc). Implementations handle any serialization required by the medium:
Class instances lose their prototype on retrieval — store the underlying data
(e.g. via entity.GetAll()) and reconstruct on read if needed.
Type of the value being stored. Caller-controlled.
The key to store under
The value to store
Optionalcategory: stringOptional category for key isolation
In-memory storage provider using a nested Map structure for category isolation. Used as a fallback when browser storage is not available, and as the base for the localStorage / IndexedDB providers below.
Stores values by reference — no serialization. Suitable as long as the calling tier doesn't need persistence across page loads.
Storage structure:
Map<category, Map<key, unknown>>