Duke JS Client

A lightweight JavaScript client for interacting with a Duke distributed key-value cluster.

Installation

Copy duke.js into your project and import it:

import Duke from "./duke.js";

Usage

Create a Client

const duke = new Duke();

Add Duke Nodes

duke.seturl(
  "duke://localhost:8000",
  "duke://localhost:8001",
  "duke://localhost:8002",
);

Multiple URLs can be provided.

Connect

Before performing any operations, call connect().

const connected = await duke.connect();

if (!connected) {
  console.log("No healthy Duke nodes found.");
}

The client checks the health of all configured nodes and stores only healthy ones for future requests.

PUT

Store a key-value pair.

await duke.PUT("name", "Baltej");

Returns:

true;

GET

Retrieve a value by key.

const value = await duke.GET("name");

console.log(value);

Output:

Baltej

If the key does not exist:

Error: Key not found.

Health Checking

The client verifies node health using db.checkHealth()

Example

import Duke from "./duke.js";

const duke = new Duke();

duke.seturl(
  "duke://localhost:8000",
  "duke://localhost:8001",
  "duke://localhost:8002",
);

const connected = await duke.connect();

if (!connected) {
  throw new Error("No Duke nodes available.");
}

await duke.PUT("username", "baltej");

const value = await duke.GET("username");

console.log(value);

API

seturl(...urls)

Registers Duke nodes.

duke.seturl("duke://localhost:8000", "duke://localhost:8001");

connect()

Checks node health and builds the list of working nodes.

Returns:

boolean;

GET(key)

Retrieves a value.

Returns:

Promise<any>

Throws if the key is not found.

PUT(key, value)

Stores a key-value pair.

Returns:

Promise<boolean>

Throws if the operation fails.