OpenDBS Node.js Client

Official Node.js client library for OpenDBS.

Installation

npm install opendbs

Usage

Initialization (with SSL/TLS support)

const { OpenDBS } = require('opendbs');

const db = new OpenDBS({
    baseURL: 'http://localhost:4402',
    // ignoreSSL: true // Uncomment if using self-signed certs locally
});

// Or login later
await db.login('admin', 'admin123');

Basic Operations

// Create Database
await db.createDatabase('shop');

// Create Racks
await db.createRack('shop', { name: 'products', type: 'sql', schema: {
    name: { type: 'string', required: true },
    price: { type: 'number' }
}});
await db.createRack('shop', { name: 'users', type: 'nosql' });

// Insert Data
await db.insert('shop', 'users', { name: "Alice", age: 30 });
await db.sql('shop', "INSERT INTO products (name, price) VALUES ('Laptop', 1200)");

// Find Data
const users = await db.find('shop', 'users', { name: "Alice" });
const products = await db.sql('shop', "SELECT * FROM products");

Advanced Search

// Fuzzy Search
const fuzzy = await db.fuzzySearch('shop', 'users', 'name', 'Alice');

// Vector Search
const vectors = await db.vectorSearch('shop', 'products', 'embedding', [0.1, 0.2, 0.3]);

// Complex Filter
const results = await db.search('shop', 'users', {
    query: {
        age: { "$gt": 20 }
    }
});

Backup

// Create Backup
await db.createBackup();

// List Backups
const backups = await db.listBackups();