@hpkv/rest-client NPM

HPKV REST Client

A NodeJs client for the high-performance key-value store (HPKV)

Features

High-performance key-value operations:
- Set/Get records
- Range queries
- Atmoic Increment/Decrement
- Partial updates
Semantic search and query capabilities:
- Semantic search in records
- Natural language querying records

PreRequisites

You need an HPKV API key. You can sign up and generate a free key here.

Find your HPKV API key and urls at HPKV Dashboard

Installation

npm install @hpkv/rest-client

Quick Start

import HPKVRestClient from '@hpkv/rest-client';

const client = new HPKVRestClient('your-hpkv-api-base-url', 'your-hpkv-nexus-api-base-url', 'your-api-key');

// Set a value
await client.set('my-key', 'my-value');

// Get a value
const result = await client.get('my-key');

// Store JSON
await client.set('user:1', {
  name: 'John Doe',
  email: 'john@example.com',
});

// Partial update - updates the value of email and adds a new address property
await client.set(
  'user:1',
  {
    email: 'john.updated@example.com',
    address: 'John Doe address'
  },
  true
);

// Atomic Increment counter
const counter = await client.atomicIncrement('visits', 1);

// Range query 
const records = await client.range('start', 'end', 100);

// Semantic search
const searchResults = await client.nexusSearch('find John Doe''s information');

// AI-powered query
const answer = await client.nexusQuery('What is John Doe''s email address?');

API Reference

Constructor

new HPKVRestClient(baseUrl: string, nexusBaseUrl: string, apiKey: string)

Methods

`set(key: string, value: unknown, partialUpdate?: boolean): Promise<RecordResponse>`

Set a value for a key. If partialUpdate is true, the value will be appended to the existing. If the existing and new values are valid JSON, it performs an atomic JSON patching.