@wowoengine/sawitdb 2.4.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 SawitDB Community
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,245 @@
+# SawitDB
+
+![SawitDB Banner](docs/sawitdb.jpg)
+
+<div align="center">
+
+[![Docs](https://img.shields.io/badge/Docs-Read%20Now-blue?style=for-the-badge&logo=googledocs)](https://wowoengine.github.io/SawitDB/)
+[![Go Version](https://img.shields.io/badge/Go%20Version-Visit%20Repo-cyan?style=for-the-badge&logo=go)](https://github.com/WowoEngine/SawitDB-Go)
+[![Changelog](https://img.shields.io/badge/Changelog-Read%20Updates-orange?style=for-the-badge&logo=github)](CHANGELOG.md)
+
+</div>
+
+
+**SawitDB** is a unique database solution stored in `.sawit` binary files.
+
+The system features a custom **Paged Heap File** architecture similar to SQLite, using fixed-size 4KB pages to ensure efficient memory usage. What differentiates SawitDB is its unique **Agricultural Query Language (AQL)**, which replaces standard SQL keywords with Indonesian farming terminology.
+
+**Now with Network Edition!** Connect via TCP using `sawitdb://` protocol similar to MongoDB.
+
+**🚨 Emergency: Aceh Flood Relief**
+Please support our brothers and sisters in Aceh.
+
+[![Kitabisa](https://img.shields.io/badge/Kitabisa-Bantu%20Aceh-blue?style=flat&logo=heart)](https://kitabisa.com/campaign/donasipedulibanjiraceh)
+
+*Organized by Human Initiative Aceh*
+
+## Features
+
+- **Paged Architecture**: Data is stored in 4096-byte binary pages. The engine does not load the entire database into memory.
+- **Single File Storage**: All data, schema, and indexes are stored in a single `.sawit` file.
+- **High Stability**: Uses 4KB atomic pages. More stable than a coalition government.
+- **Data Integrity (Anti-Korupsi)**: Implements strict `fsync` protocols. Data cannot be "corrupted" or "disappear" mysteriously like social aid funds (Bansos). No "Sunat Massal" here.
+- **Zero Bureaucracy (Zero Deps)**: Built entirely with standard Node.js. No unnecessary "Vendor Pengadaan" or "Mark-up Anggaran".
+- **Transparansi**: Query language is clear. No "Pasal Karet" (Ambiguous Laws) or "Rapat Tertutup" in 5-star hotels.
+- **Speed**: Faster than printing an e-KTP at the Kelurahan.
+- **Network Support (NEW)**: Client-Server architecture with Multi-database support and Authentication.
+
+## Filosofi
+
+### Filosofi (ID)
+SawitDB dibangun dengan semangat "Kemandirian Data". Kami percaya database yang handal tidak butuh **Infrastruktur Langit** yang harganya triliunan tapi sering *down*. Berbeda dengan proyek negara yang mahal di *budget* tapi murah di kualitas, SawitDB menggunakan arsitektur **Single File** (`.sawit`) yang hemat biaya. Backup cukup *copy-paste*, tidak perlu sewa vendor konsultan asing. Fitur **`fsync`** kami menjamin data tertulis di *disk*, karena bagi kami, integritas data adalah harga mati, bukan sekadar bahan konferensi pers untuk minta maaf.
+
+### Philosophy (EN)
+SawitDB is built with the spirit of "Data Sovereignty". We believe a reliable database doesn't need **"Sky Infrastructure"** that costs trillions yet goes *down* often. Unlike state projects that are expensive in budget but cheap in quality, SawitDB uses a cost-effective **Single File** (`.sawit`) architecture. Backup is just *copy-paste*, no need to hire expensive foreign consultants. Our **`fsync`** feature guarantees data is written to *disk*, because for us, data integrity is non-negotiable, not just material for a press conference to apologize.
+
+## File List
+
+- `src/WowoEngine.js`: Core Database Engine (Class: `SawitDB`).
+- `bin/sawit-server.js`: Server executable.
+- `cli/local.js`: Interactive CLI tool (Local).
+- `cli/remote.js`: Interactive CLI tool (Network).
+- [CHANGELOG.md](CHANGELOG.md): Version history and release notes.
+- `examples/`: Sample scripts.
+
+## Installation
+
+Ensure you have Node.js installed. Clone the repository.
+
+```bash
+# Clone
+git clone https://github.com/WowoEngine/SawitDB.git
+```
+
+## Quick Start (Network Edition)
+
+### 1. Start the Server
+```bash
+node src/SawitServer.js
+```
+The server will start on `0.0.0.0:7878` by default.
+
+### 2. Connect with Client
+Use [SawitClient](#client-api) or any interactive session.
+
+---
+
+## Dual Syntax Support
+
+SawitDB 2.3 introduces the **Generic Syntax** alongside the classic **Agricultural Query Language (AQL)**, making it easier for developers familiar with standard SQL to adopt.
+
+| Operation | Agricultural Query Language (AQL) | Generic SQL (Standard) |
+| :--- | :--- | :--- |
+| **Create DB** | `BUKA WILAYAH sales_db` | `CREATE DATABASE sales_db` |
+| **Use DB** | `MASUK WILAYAH sales_db` | `USE sales_db` |
+| **Show DBs** | `LIHAT WILAYAH` | `SHOW DATABASES` |
+| **Drop DB** | `BAKAR WILAYAH sales_db` | `DROP DATABASE sales_db` |
+| **Create Table** | `LAHAN products` | `CREATE TABLE products` |
+| **Insert** | `TANAM KE products (...) BIBIT (...)` | `INSERT INTO products (...) VALUES (...)` |
+| **Select** | `PANEN * DARI products DIMANA ...` | `SELECT * FROM products WHERE ...` |
+| **Update** | `PUPUK products DENGAN ...` | `UPDATE products SET ...` |
+| **Delete** | `GUSUR DARI products DIMANA ...` | `DELETE FROM products WHERE ...` |
+| **Indexing** | `INDEKS products PADA price` | `CREATE INDEX ON products (price)` |
+| **Aggregation** | `HITUNG SUM(stock) DARI products` | *Same Syntax* |
+
+---
+
+## Query Syntax (Detailed)
+
+### 1. Management Commands
+
+#### Create Table
+```sql
+-- Tani
+LAHAN users
+-- Generic
+CREATE TABLE users
+```
+
+#### Show Tables
+```sql
+-- Tani
+LIHAT LAHAN
+-- Generic
+SHOW TABLES
+```
+
+#### Drop Table
+```sql
+-- Tani
+BAKAR LAHAN users
+-- Generic
+DROP TABLE users
+```
+
+### 2. Data Manipulation
+
+#### Insert Data
+```sql
+-- Tani
+TANAM KE users (name, role) BIBIT ('Alice', 'Admin')
+-- Generic
+INSERT INTO users (name, role) VALUES ('Alice', 'Admin')
+```
+
+#### Select Data
+```sql
+-- Tani
+PANEN name, role DARI users DIMANA role = 'Admin' ORDER BY name ASC LIMIT 10
+-- Generic
+SELECT name, role FROM users WHERE role = 'Admin' ORDER BY name ASC LIMIT 10
+```
+*Operators*: `=`, `!=`, `>`, `<`, `>=`, `<=`
+*Advanced*: `IN ('a','b')`, `LIKE 'pat%'`, `BETWEEN 10 AND 20`, `IS NULL`, `IS NOT NULL`
+
+#### Pagination & Sorting
+```sql
+SELECT * FROM users ORDER BY age DESC LIMIT 5 OFFSET 10
+SELECT * FROM users WHERE age BETWEEN 18 AND 30 AND status IS NOT NULL
+```
+
+#### Update Data
+```sql
+-- Tani
+PUPUK users DENGAN role='SuperAdmin' DIMANA name='Alice'
+-- Generic
+UPDATE users SET role='SuperAdmin' WHERE name='Alice'
+```
+
+#### Delete Data
+```sql
+-- Tani
+GUSUR DARI users DIMANA name='Bob'
+-- Generic
+DELETE FROM users WHERE name='Bob'
+```
+
+### 3. Advanced Features
+
+#### Indexing
+```sql
+INDEKS [table] PADA [field]
+-- or
+CREATE INDEX ON [table] ([field])
+```
+
+#### Aggregation & Grouping
+```sql
+HITUNG COUNT(*) DARI [table]
+HITUNG AVG(price) DARI [products] KELOMPOK [category]
+-- Generic Keyword Alias
+SELECT AVG(price) FROM [products] GROUP BY [category] (Coming Soon)
+```
+
+## Architecture Details
+
+- **Modular Codebase**: Engine logic separated into `src/modules/` (`Pager.js`, `QueryParser.js`, `BTreeIndex.js`) for better maintainability.
+- **Page 0 (Master Page)**: Contains header and Table Directory.
+- **Data & Indexes**: Stored in 4KB atomic pages.
+
+## Benchmark Performance
+Test Environment: Single Thread, Windows Node.js (Local NVMe)
+
+| Operation | Ops/Sec | Latency (avg) |
+|-----------|---------|---------------|
+| **INSERT** | ~3,125 | 0.32 ms |
+| **SELECT (PK Index)** | ~3,846 | 0.26 ms |
+| **SELECT (Scan)** | ~4,762 | 0.21 ms |
+| **UPDATE** | ~3,571 | 0.28 ms |
+
+*Note: Hasil dapat bervariasi tergantung hardware.*
+
+## Full Feature Comparison
+
+| Feature | Tani Edition (AQL) | Generic SQL (Standard) | Notes |
+|---------|-------------------|------------------------|-------|
+| **Create DB** | `BUKA WILAYAH [db]` | `CREATE DATABASE [db]` | Creates `.sawit` in data/ |
+| **Use DB** | `MASUK WILAYAH [db]` | `USE [db]` | Switch context |
+| **Show DBs** | `LIHAT WILAYAH` | `SHOW DATABASES` | Lists available DBs |
+| **Drop DB** | `BAKAR WILAYAH [db]` | `DROP DATABASE [db]` | **Irreversible!** |
+| **Create Table** | `LAHAN [table]` | `CREATE TABLE [table]` | Schema-less creation |
+| **Show Tables** | `LIHAT LAHAN` | `SHOW TABLES` | Lists tables in DB |
+| **Drop Table** | `BAKAR LAHAN [table]` | `DROP TABLE [table]` | Deletes table & data |
+| **Insert** | `TANAM KE [table] ... BIBIT (...)` | `INSERT INTO [table] (...) VALUES (...)` | Auto-ID if omitted |
+| **Select** | `PANEN ... DARI [table] DIMANA ...` | `SELECT ... FROM [table] WHERE ...` | Supports Projection |
+| **Update** | `PUPUK [table] DENGAN ... DIMANA ...` | `UPDATE [table] SET ... WHERE ...` | Atomic update |
+| **Delete** | `GUSUR DARI [table] DIMANA ...` | `DELETE FROM [table] WHERE ...` | Row-level deletion |
+| **Index** | `INDEKS [table] PADA [field]` | `CREATE INDEX ON [table] (field)` | B-Tree Indexing |
+| **Count** | `HITUNG COUNT(*) DARI [table]` | `SELECT COUNT(*) FROM [table]` (via HITUNG) | Aggregation |
+| **Sum** | `HITUNG SUM(col) DARI [table]` | `SELECT SUM(col) FROM [table]` (via HITUNG) | Aggregation |
+| **Average** | `HITUNG AVG(col) DARI [table]` | `SELECT AVG(col) FROM [table]` (via HITUNG) | Aggregation |
+
+### Supported Operators Table
+
+| Operator | Syntax Example | Description |
+|----------|----------------|-------------|
+| **Comparison** | `=`, `!=`, `>`, `<`, `>=`, `<=` | Standard value comparison |
+| **Logical** | `AND`, `OR` | Combine multiple conditions |
+| **In List** | `IN ('coffee', 'tea')` | Matches any value in the list |
+| **Not In** | `NOT IN ('water')` | Matches values NOT in list |
+| **Pattern** | `LIKE 'Jwa%'` | Standard SQL wildcard matching |
+| **Range** | `BETWEEN 1000 AND 5000` | Inclusive range check |
+| **Null** | `IS NULL` | Check if field is empty/null |
+| **Not Null** | `IS NOT NULL` | Check if field has value |
+| **Limit** | `LIMIT 10` | Restrict number of rows |
+| **Offset** | `OFFSET 5` | Skip first N rows (Pagination) |
+| **Order** | `ORDER BY price DESC` | Sort by field (ASC/DESC) |
+## License
+
+MIT License
+<!-- ## Support Developer
+- [![Saweria](https://img.shields.io/badge/Saweria-Support%20Me-orange?style=flat&logo=ko-fi)](https://saweria.co/patradev)
+
+- **BTC**: `12EnneEriimQey3cqvxtv4ZUbvpmEbDinL`
+- **BNB Smart Chain (BEP20)**: `0x471a58a2b5072cb50e3761dba3e15d19f080bdbc`
+- **DOGE**: `DHrFZW6w9akaWuf8BCBGxxRLR3PegKTggF` -->

package/bin/sawit-server.js

@@ -0,0 +1,68 @@
+#!/usr/bin/env node
+
+/**
+ * Start SawitDB Server
+ * 
+ * Usage:
+ *   node start_server.js
+ *   
+ * Environment Variables:
+ *   SAWIT_PORT - Port to listen on (default: 7878)
+ *   SAWIT_HOST - Host to bind to (default: 0.0.0.0)
+ *   SAWIT_DATA_DIR - Directory for database files (default: ./data)
+ *   SAWIT_AUTH - Enable authentication (format: username:password)
+ */
+
+const SawitServer = require('../src/SawitServer');
+const path = require('path');
+
+// Parse configuration
+const config = {
+    port: process.env.SAWIT_PORT || 7878,
+    host: process.env.SAWIT_HOST || '0.0.0.0',
+    dataDir: process.env.SAWIT_DATA_DIR || path.join(__dirname, '../data')
+};
+
+// Parse authentication if provided
+if (process.env.SAWIT_AUTH) {
+    const [username, password] = process.env.SAWIT_AUTH.split(':');
+    if (username && password) {
+        config.auth = { [username]: password };
+        console.log(`[Config] Authentication enabled for user: ${username}`);
+    }
+}
+
+console.log('[Config] Server configuration:');
+console.log(`  - Port: ${config.port}`);
+console.log(`  - Host: ${config.host}`);
+console.log(`  - Data Directory: ${config.dataDir}`);
+console.log(`  - Auth: ${config.auth ? 'Enabled' : 'Disabled'}`);
+console.log('');
+
+// Create and start server
+const server = new SawitServer(config);
+server.start();
+
+// Graceful shutdown
+process.on('SIGINT', () => {
+    console.log('\n[Server] Received SIGINT, shutting down gracefully...');
+    server.stop();
+    setTimeout(() => process.exit(0), 1000);
+});
+
+process.on('SIGTERM', () => {
+    console.log('\n[Server] Received SIGTERM, shutting down gracefully...');
+    server.stop();
+    setTimeout(() => process.exit(0), 1000);
+});
+
+// Handle uncaught errors
+process.on('uncaughtException', (err) => {
+    console.error('[Server] Uncaught Exception:', err);
+    server.stop();
+    process.exit(1);
+});
+
+process.on('unhandledRejection', (reason, promise) => {
+    console.error('[Server] Unhandled Rejection at:', promise, 'reason:', reason);
+});

package/cli/local.js

@@ -0,0 +1,49 @@
+const readline = require('readline');
+const SawitDB = require('../src/WowoEngine');
+const path = require('path');
+
+const dbPath = path.join(__dirname, 'example.sawit');
+const db = new SawitDB(dbPath);
+
+const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout
+});
+
+console.log("--- WOWODB TANI EDITION V2 (SQL-Like) ---");
+console.log("Perintah:");
+console.log("  LAHAN [nama_kebun]");
+console.log("  LIHAT LAHAN");
+console.log("  TANAM KE [kebun] (col,...) BIBIT (val,...)");
+console.log("  PANEN * DARI [kebun]");
+console.log("  PANEN ... DIMANA col [=,>,<,!=] val");
+console.log("  GUSUR DARI [kebun] DIMANA col = val");
+console.log("  PUPUK [kebun] DENGAN col=val ... DIMANA col = val");
+console.log("  BAKAR LAHAN [kebun]");
+console.log("\nContoh:");
+console.log("  TANAM KE sawit (id, bibit) BIBIT (1, 'Dura')");
+console.log("  PANEN * DARI sawit DIMANA id > 0");
+console.log("  BAKAR LAHAN karet");
+console.log("Ketik 'EXIT' untuk pulang.");
+
+function prompt() {
+    rl.question('petani> ', (line) => {
+        const cmd = line.trim();
+        if (cmd.toUpperCase() === 'EXIT') {
+            rl.close();
+            return;
+        }
+
+        if (cmd) {
+            const result = db.query(cmd);
+            if (typeof result === 'object') {
+                console.log(JSON.stringify(result, null, 2));
+            } else {
+                console.log(result);
+            }
+        }
+        prompt();
+    });
+}
+
+prompt();

package/cli/remote.js

@@ -0,0 +1,165 @@
+#!/usr/bin/env node
+
+/**
+ * Interactive CLI Client for SawitDB
+ * 
+ * Usage:
+ *   node cli_client.js [connection_string]
+ *   
+ * Example:
+ *   node cli_client.js sawitdb://localhost:7878/mydb
+ *   node cli_client.js sawitdb://user:pass@localhost:7878/mydb
+ */
+
+const readline = require('readline');
+const SawitClient = require('../src/SawitClient');
+
+const connStr = process.argv[2] || 'sawitdb://localhost:7878/default';
+
+console.log('╔══════════════════════════════════════════════════╗');
+console.log('║   🌴 SawitDB Client - Interactive CLI          ║');
+console.log('╚══════════════════════════════════════════════════╝');
+console.log('');
+console.log(`Connecting to: ${connStr}`);
+console.log('');
+
+const client = new SawitClient(connStr);
+let rl;
+
+async function init() {
+    try {
+        await client.connect();
+        console.log('✓ Connected to SawitDB server\n');
+        console.log('Commands:');
+        console.log('  LAHAN [nama]              - Create table');
+        console.log('  LIHAT LAHAN              - Show tables');
+        console.log('  LIHAT INDEKS [table]     - Show indexes');
+        console.log('  TANAM KE ...             - Insert data');
+        console.log('  PANEN ... DARI ...       - Select data');
+        console.log('  PUPUK ... DENGAN ...     - Update data');
+        console.log('  GUSUR DARI ...           - Delete data');
+        console.log('  BAKAR LAHAN [nama]       - Drop table');
+        console.log('  INDEKS [table] PADA [field] - Create index');
+        console.log('  HITUNG FUNC(...) DARI ... - Aggregate');
+        console.log('  .databases               - List all databases');
+        console.log('  .use [db]                - Switch database');
+        console.log('  .ping                    - Ping server');
+        console.log('  .help                    - Show this help');
+        console.log('  EXIT                     - Disconnect and exit');
+        console.log('');
+
+        rl = readline.createInterface({
+            input: process.stdin,
+            output: process.stdout
+        });
+
+        prompt();
+    } catch (error) {
+        console.error('Failed to connect:', error.message);
+        process.exit(1);
+    }
+}
+
+function prompt() {
+    rl.question(`${client.currentDatabase || 'none'}> `, async (line) => {
+        const cmd = line.trim();
+
+        if (!cmd) {
+            return prompt();
+        }
+
+        if (cmd.toUpperCase() === 'EXIT') {
+            console.log('\nDisconnecting...');
+            client.disconnect();
+            rl.close();
+            process.exit(0);
+            return;
+        }
+
+        // Special commands
+        if (cmd.startsWith('.')) {
+            await handleSpecialCommand(cmd);
+            return prompt();
+        }
+
+        // Regular query
+        try {
+            const result = await client.query(cmd);
+            if (typeof result === 'object') {
+                console.log(JSON.stringify(result, null, 2));
+            } else {
+                console.log(result);
+            }
+        } catch (error) {
+            console.error('Error:', error.message);
+        }
+
+        prompt();
+    });
+}
+
+async function handleSpecialCommand(cmd) {
+    const parts = cmd.split(' ');
+    const command = parts[0];
+
+    try {
+        switch (command) {
+            case '.databases':
+                const dbs = await client.listDatabases();
+                console.log('Databases:', dbs.join(', '));
+                break;
+
+            case '.use':
+                if (parts.length < 2) {
+                    console.log('Usage: .use [database]');
+                } else {
+                    await client.use(parts[1]);
+                }
+                break;
+
+            case '.ping':
+                const ping = await client.ping();
+                console.log(`Pong! Latency: ${ping.latency}ms`);
+                break;
+
+            case '.stats':
+                const stats = await client.stats();
+                console.log('\nServer Statistics:');
+                console.log(`  Uptime: ${stats.uptimeFormatted}`);
+                console.log(`  Total Connections: ${stats.totalConnections}`);
+                console.log(`  Active Connections: ${stats.activeConnections}`);
+                console.log(`  Total Queries: ${stats.totalQueries}`);
+                console.log(`  Errors: ${stats.errors}`);
+                console.log(`  Databases: ${stats.databases}`);
+                console.log(`  Memory: ${Math.round(stats.memoryUsage.heapUsed / 1024 / 1024)}MB / ${Math.round(stats.memoryUsage.heapTotal / 1024 / 1024)}MB`);
+                break;
+
+            case '.help':
+                console.log('\nAvailable commands:');
+                console.log('  .databases    - List all databases');
+                console.log('  .use [db]     - Switch to database');
+                console.log('  .ping         - Test connection');
+                console.log('  .stats        - Show server statistics');
+                console.log('  .help         - Show this help');
+                console.log('');
+                break;
+
+            default:
+                console.log(`Unknown command: ${command}`);
+                console.log('Type .help for available commands');
+        }
+    } catch (error) {
+        console.error('Error:', error.message);
+    }
+}
+
+// Start
+init();
+
+// Handle exit
+process.on('SIGINT', () => {
+    console.log('\n\nDisconnecting...');
+    client.disconnect();
+    if (rl) rl.close();
+    process.exit(0);
+});