Class ServerKvClient

Server-backed key-value store using HTTP API.

This implementation communicates with a Hubert server via HTTP POST requests.

Port of struct ServerKvClient from server/kv.rs lines 6-37.

Example

const store = new ServerKvClient("http://127.0.0.1:45678");
const arid = ARID.new();
const envelope = Envelope.new("Hello, Server!");

// Put envelope (write-once)
await store.put(arid, envelope);

// Get envelope with verbose logging
const retrieved = await store.get(arid, undefined, true);

Implements

KvStore

Index

Constructors

constructor

Methods

put get exists

Constructors

constructor

new ServerKvClient(baseUrl: string): ServerKvClient
Create a new server KV store client.

Port of ServerKvClient::new() from server/kv.rs lines 39-46.
Parameters
- baseUrl: string
  Base URL of the Hubert server (e.g., "http://127.0.0.1:45678")
Returns ServerKvClient
- Defined in server/kv.ts:49

Methods

put

put(
    arid: ARID,
    envelope: Envelope,
    ttlSeconds?: number,
    verbose?: boolean,
): Promise<string>
Store an envelope at the given ARID.

Port of KvStore::put() implementation from server/kv.rs lines 67-122.
Parameters
- arid: ARID
- envelope: Envelope
- OptionalttlSeconds: number
- Optionalverbose: boolean
Returns Promise<string>
Implementation of KvStore.put
- Defined in server/kv.ts:58

get

get(
    arid: ARID,
    timeoutSeconds?: number,
    verbose?: boolean,
): Promise<Envelope | null>
Retrieve an envelope for the given ARID.

Port of KvStore::get() implementation from server/kv.rs lines 124-212.
Parameters
- arid: ARID
- OptionaltimeoutSeconds: number
- Optionalverbose: boolean
Returns Promise<Envelope | null>
Implementation of KvStore.get
- Defined in server/kv.ts:119

exists

exists(arid: ARID): Promise<boolean>
Check if an envelope exists at the given ARID.

Port of KvStore::exists() implementation from server/kv.rs lines 214-218.
Parameters
- arid: ARID
Returns Promise<boolean>
Implementation of KvStore.exists
- Defined in server/kv.ts:206

Class ServerKvClient

Example

Implements

Index

Constructors

Methods

Constructors

constructor

Parameters

Returns ServerKvClient

Methods

put

Parameters

Returns Promise<string>

get

Parameters

Returns Promise<Envelope | null>

exists

Parameters

Returns Promise<boolean>

Settings

On This Page