@armada/sdk / index / LevelStorageAdapter
Class: LevelStorageAdapter
Defined in: src/storage/level.ts:48
Node-persistent StorageAdapter over an abstract-level DB, with the shared namespace/reset semantics. Writes run one at a time through an in-process queue, so update is atomic against every other write; the database's own on-disk lock keeps a second process out entirely.
Implements
Constructors
Constructor
new LevelStorageAdapter(
db):LevelStorageAdapter
Defined in: src/storage/level.ts:56
Parameters
db
Returns
LevelStorageAdapter
Methods
open()
open(
namespace):Promise<{reset:boolean; }>
Defined in: src/storage/level.ts:73
Bind the store to namespace. Returns { reset: true } when a namespace mismatch (a redeploy under a preserved identity) triggered a chain-state reset, so the instance can surface it as telemetry. Opening an already-open adapter under a DIFFERENT namespace throws StorageConflictError (it would wipe the chain state of whoever is using it); the same namespace again is a no-op.
Parameters
namespace
Returns
Promise<{ reset: boolean; }>
Implementation of
get()
get(
key):Promise<Uint8Array<ArrayBufferLike> |undefined>
Defined in: src/storage/level.ts:98
Parameters
key
string
Returns
Promise<Uint8Array<ArrayBufferLike> | undefined>
Implementation of
put()
put(
key,value):Promise<void>
Defined in: src/storage/level.ts:104
Parameters
key
string
value
Uint8Array
Returns
Promise<void>
Implementation of
del()
del(
key):Promise<void>
Defined in: src/storage/level.ts:108
Parameters
key
string
Returns
Promise<void>
Implementation of
update()
update(
key,fn,options?):Promise<Uint8Array<ArrayBufferLike> |undefined>
Defined in: src/storage/level.ts:112
Atomic read-modify-write: fn gets the current value (or undefined) and returns the new one (undefined deletes the record). Atomic with respect to every other write to this adapter. fn MUST be synchronous: an IndexedDB transaction commits as soon as it awaits anything else. Resolves to the value stored.
Parameters
key
string
fn
(current) => Uint8Array<ArrayBufferLike> | undefined
options?
Returns
Promise<Uint8Array<ArrayBufferLike> | undefined>
Implementation of
batch()
batch(
ops,options?):Promise<void>
Defined in: src/storage/level.ts:127
Apply ops in order as one atomic write: all of them land, or none do.
Parameters
ops
readonly StorageOp[]
options?
Returns
Promise<void>
Implementation of
list()
list(
prefix):AsyncIterable<{key:string;value:Uint8Array; }>
Defined in: src/storage/level.ts:136
Iterate entries whose key starts with prefix, in key order.
Parameters
prefix
string
Returns
AsyncIterable<{ key: string; value: Uint8Array; }>
Implementation of
resetChainState()
resetChainState():
Promise<void>
Defined in: src/storage/level.ts:144
Targeted reset of chain-derived namespaces, preserving identity records.
Returns
Promise<void>
Implementation of
StorageAdapter.resetChainState
close()
close():
Promise<void>
Defined in: src/storage/level.ts:153
Returns
Promise<void>