ZTeraDB Node.js Client Driver

Welcome!
This documentation will walk you through ZTeraDB step-by-step, using simple language and practical examples.

📘 What Is ZTeraDB?

ZTeraDB helps you connect to your existing databases (PostgreSQL, MySQL, MSSQL, etc.) through a single unified platform.
You write one query language (ZQL) instead of different SQL dialects.

🧠 Architecture (Simple Explanation)

Your App → ZTeraDB Node Client → ZTeraDB Server → Your Databases

You never connect to the database directly.
ZTeraDB does that for you.

⭐ Features

🚀 Unified Query Language (ZQL)
🔌 Easy integration with any Node.js app
🧵 Async/await support
⚙️ Auto-managed connections
🔐 Secure key-based authentication
🎯 Clean query builder (insert, select, update, delete)
🧮 Advanced math and logical filters
📖 Beginner-friendly workflows

🛠 Requirements

Node.js 18.20.7+
Basic JavaScript knowledge
ZTeraDB account (for clientKeys)

📦 Install

npm install zteradb

Or Yarn:

yarn add zteradb

🚀 Quick Start (Hello World)

import { ZTeraDBConnect, ZTeraDBQuery } from "zteradb";

const config = JSON.parse(process.env.ZTERADB_CONFIG);

const db = ZTeraDBConnect(config, "db1.zteradb.com", 7777);

const query = new ZTeraDBQuery("user").select();

const users = await db.run(query);

for await (const row of users) {
  console.log(row);
}

db.close();