Interface: StorageAdapter
Defined in: packages/core/src/types.ts:278
Where a store keeps its bytes: entries by string key, and version bodies by id. Write one to keep a node's data somewhere new. The optional methods only save round trips.
Extended by
Methods
batch()
batch(ops): Promise<void>;Defined in: packages/core/src/types.ts:294
Applies these puts and deletes; should be atomic
Parameters
| Parameter | Type |
|---|---|
ops | readonly BatchOp[] |
Returns
Promise<void>
close()
close(): Promise<void>;Defined in: packages/core/src/types.ts:296
Releases it
Returns
Promise<void>
commit()?
commit?(write): Promise<void>;Defined in: packages/core/src/types.ts:306
Optional: stores these versions, applies these entry ops and deletes
these versions in one atomic write. Without it: putVersion each,
then batch, then deleteVersion each.
Parameters
| Parameter | Type |
|---|---|
write | { ops: readonly BatchOp[]; remove: readonly string[]; store: readonly Version<unknown>[]; } |
write.ops | readonly BatchOp[] |
write.remove | readonly string[] |
write.store | readonly Version<unknown>[] |
Returns
Promise<void>
delete()
delete(key): Promise<void>;Defined in: packages/core/src/types.ts:284
Removes an entry; absent is fine
Parameters
| Parameter | Type |
|---|---|
key | string |
Returns
Promise<void>
deleteVersion()
deleteVersion(id): Promise<void>;Defined in: packages/core/src/types.ts:292
Delete a version by ID
Parameters
| Parameter | Type |
|---|---|
id | string |
Returns
Promise<void>
entries()?
entries?(prefix): Promise<readonly (readonly [string, Uint8Array<ArrayBufferLike>])[]>;Defined in: packages/core/src/types.ts:298
Optional: every entry under a prefix with its value, in one read. Without it, list then get each.
Parameters
| Parameter | Type |
|---|---|
prefix | string |
Returns
Promise<readonly (readonly [string, Uint8Array<ArrayBufferLike>])[]>
get()
get(key): Promise<Uint8Array<ArrayBufferLike> | null>;Defined in: packages/core/src/types.ts:280
The entry's bytes, or null
Parameters
| Parameter | Type |
|---|---|
key | string |
Returns
Promise<Uint8Array<ArrayBufferLike> | null>
getVersion()
getVersion(id): Promise<Version<unknown> | null>;Defined in: packages/core/src/types.ts:290
Get a version by ID
Parameters
| Parameter | Type |
|---|---|
id | string |
Returns
Promise<Version<unknown> | null>
getVersions()?
getVersions?(ids): Promise<readonly (Version<unknown> | null)[]>;Defined in: packages/core/src/types.ts:300
Optional: many versions by id in one read, null where absent, in the order asked. Without it, getVersion each.
Parameters
| Parameter | Type |
|---|---|
ids | readonly string[] |
Returns
Promise<readonly (Version<unknown> | null)[]>
list()
list(prefix?): Promise<string[]>;Defined in: packages/core/src/types.ts:286
Every key starting with prefix, in any order
Parameters
| Parameter | Type |
|---|---|
prefix? | string |
Returns
Promise<string[]>
put()
put(key, value): Promise<void>;Defined in: packages/core/src/types.ts:282
Sets an entry
Parameters
| Parameter | Type |
|---|---|
key | string |
value | Uint8Array |
Returns
Promise<void>
putVersion()
putVersion(version): Promise<void>;Defined in: packages/core/src/types.ts:288
Store a version
Parameters
| Parameter | Type |
|---|---|
version | Version |
Returns
Promise<void>