dbx-native 0.1.2-beta → 0.2.0-beta

package/README.md

@@ -1,88 +1,88 @@
-# dbx-native
-
-[![npm](https://img.shields.io/npm/v/dbx-native.svg)](https://www.npmjs.com/package/dbx-native)
-[![License](https://img.shields.io/badge/license-MIT%20OR%20Commercial-green.svg)](LICENSE)
-[![Guide](https://img.shields.io/badge/guide-GitHub%20Pages-blue)](https://bytelogiccore-spec.github.io/DBX/english/packages/nodejs)
-
-> High-performance Node.js bindings for DBX embedded database
-
-**dbx-native** provides native Node.js bindings to the DBX database engine via N-API, delivering near-zero overhead access to the high-performance Rust core.
-
-## Installation
-
-```bash
-npm install dbx-native
-```
-
-## Quick Start
-
-```javascript
-const dbx = require('dbx-native');
-
-// Open an in-memory database
-const db = dbx.openInMemory();
-
-// Insert data
-db.insert('users', Buffer.from('user:1'), Buffer.from('Alice'));
-db.insert('users', Buffer.from('user:2'), Buffer.from('Bob'));
-
-// Get data
-const value = db.get('users', Buffer.from('user:1'));
-console.log(value.toString()); // Alice
-
-// Delete data
-db.delete('users', Buffer.from('user:2'));
-
-// Close database
-db.close();
-```
-
-## SQL Interface
-
-```javascript
-const dbx = require('dbx-native');
-
-const db = dbx.openInMemory();
-
-// Execute SQL
-db.executeSql('CREATE TABLE users (id INTEGER, name TEXT)');
-db.executeSql("INSERT INTO users VALUES (1, 'Alice')");
-
-const result = db.executeSql('SELECT * FROM users');
-console.log(result);
-
-db.close();
-```
-
-## API Reference
-
-| Method | Description |
-|--------|-------------|
-| `openInMemory()` | Open an in-memory database |
-| `open(path)` | Open a file-based database |
-| `insert(table, key, value)` | Insert a key-value pair |
-| `get(table, key)` | Get value by key |
-| `delete(table, key)` | Delete a key |
-| `executeSql(sql)` | Execute a SQL statement |
-| `close()` | Close and free resources |
-
-## Benchmarks
-
-```bash
-npm run bench
-```
-
-## Requirements
-
-- Node.js 18+
-- Windows x64 (native addon included)
-
-## License
-
-Dual-licensed under:
-- **MIT License** — for open-source projects
-- **Commercial License** — for proprietary/commercial use
-
-See [LICENSE](https://github.com/bytelogiccore-spec/DBX/blob/main/LICENSE) for details.
-
-For commercial licensing inquiries, contact: [ByteLogicCore](https://github.com/bytelogiccore-spec)
+# dbx-native
+
+[![npm](https://img.shields.io/npm/v/dbx-native.svg)](https://www.npmjs.com/package/dbx-native)
+[![License](https://img.shields.io/badge/license-MIT%20OR%20Commercial-green.svg)](LICENSE)
+[![Guide](https://img.shields.io/badge/guide-GitHub%20Pages-blue)](https://bytelogiccore-spec.github.io/DBX/english/packages/nodejs)
+
+> High-performance Node.js bindings for DBX embedded database
+
+**dbx-native** provides native Node.js bindings to the DBX database engine via N-API, delivering near-zero overhead access to the high-performance Rust core.
+
+## Installation
+
+```bash
+npm install dbx-native
+```
+
+## Quick Start
+
+```javascript
+const dbx = require('dbx-native');
+
+// Open an in-memory database
+const db = dbx.openInMemory();
+
+// Insert data
+db.insert('users', Buffer.from('user:1'), Buffer.from('Alice'));
+db.insert('users', Buffer.from('user:2'), Buffer.from('Bob'));
+
+// Get data
+const value = db.get('users', Buffer.from('user:1'));
+console.log(value.toString()); // Alice
+
+// Delete data
+db.delete('users', Buffer.from('user:2'));
+
+// Close database
+db.close();
+```
+
+## SQL Interface
+
+```javascript
+const dbx = require('dbx-native');
+
+const db = dbx.openInMemory();
+
+// Execute SQL
+db.executeSql('CREATE TABLE users (id INTEGER, name TEXT)');
+db.executeSql("INSERT INTO users VALUES (1, 'Alice')");
+
+const result = db.executeSql('SELECT * FROM users');
+console.log(result);
+
+db.close();
+```
+
+## API Reference
+
+| Method | Description |
+|--------|-------------|
+| `openInMemory()` | Open an in-memory database |
+| `open(path)` | Open a file-based database |
+| `insert(table, key, value)` | Insert a key-value pair |
+| `get(table, key)` | Get value by key |
+| `delete(table, key)` | Delete a key |
+| `executeSql(sql)` | Execute a SQL statement |
+| `close()` | Close and free resources |
+
+## Benchmarks
+
+```bash
+npm run bench
+```
+
+## Requirements
+
+- Node.js 18+
+- Windows x64 (native addon included)
+
+## License
+
+Dual-licensed under:
+- **MIT License** — for open-source projects
+- **Commercial License** — for proprietary/commercial use
+
+See [LICENSE](https://github.com/bytelogiccore-spec/DBX/blob/main/LICENSE) for details.
+
+For commercial licensing inquiries, contact: [ByteLogicCore](https://github.com/bytelogiccore-spec)

package/benchmarks/auto_batch_benchmark.js

@@ -1,98 +1,98 @@
-/**
- * Auto-Batching Performance Benchmark
- * 
- * Compares standard individual get() calls vs auto-batched get() calls
- * 
- * Run with: node benchmarks/auto_batch_benchmark.js
- */
-
-const Benchmark = require('benchmark');
-const { Database } = require('../');
-const { SmartDatabase } = require('../smart_database');
-
-const NUM_ENTRIES = 10_000;
-
-function generateTestData() {
-    const data = [];
-    for (let i = 0; i < NUM_ENTRIES; i++) {
-        const key = Buffer.from(`key_${i.toString().padStart(8, '0')}`);
-        const value = Buffer.from(`value_${i.toString().padStart(8, '0')}_data`);
-        data.push([key, value]);
-    }
-    return data;
-}
-
-// Prepare databases
-let standardDb, smartDb, testData, testKeys;
-
-const suite = new Benchmark.Suite();
-
-suite
-    .add('Standard GET 10k (individual calls)', {
-        onStart: function () {
-            standardDb = Database.openInMemory();
-            testData = generateTestData();
-            testKeys = testData.map(([key]) => key);
-            for (const [key, value] of testData) {
-                standardDb.insert('bench', key, value);
-            }
-        },
-        fn: function () {
-            for (const key of testKeys) {
-                standardDb.get('bench', key);
-            }
-        }
-    })
-    .add('Auto-Batched GET 10k (SmartDatabase)', {
-        onStart: function () {
-            const rawDb = Database.openInMemory();
-            smartDb = new SmartDatabase(rawDb);
-            testData = generateTestData();
-            testKeys = testData.map(([key]) => key);
-            for (const [key, value] of testData) {
-                smartDb.insert('bench', key, value);
-            }
-        },
-        fn: async function (deferred) {
-            // All get() calls are automatically batched
-            await Promise.all(testKeys.map(key => smartDb.get('bench', key)));
-            deferred.resolve();
-        },
-        defer: true
-    })
-    .add('Manual Batch GET 10k', {
-        onStart: function () {
-            standardDb = Database.openInMemory();
-            testData = generateTestData();
-            testKeys = testData.map(([key]) => key);
-            for (const [key, value] of testData) {
-                standardDb.insert('bench', key, value);
-            }
-        },
-        fn: function () {
-            standardDb.getBatch('bench', testKeys);
-        }
-    })
-    .on('cycle', function (event) {
-        console.log(String(event.target));
-        const timeMs = event.target.stats.mean * 1000;
-        console.log(`  → ${timeMs.toFixed(2)}ms per operation\n`);
-    })
-    .on('complete', function () {
-        console.log('\n=== Performance Comparison ===');
-
-        const standard = this.filter(name => name === 'Standard GET 10k (individual calls)')[0];
-        const autoBatch = this.filter(name => name === 'Auto-Batched GET 10k (SmartDatabase)')[0];
-        const manualBatch = this.filter(name => name === 'Manual Batch GET 10k')[0];
-
-        if (standard && autoBatch) {
-            const improvement = ((standard.stats.mean - autoBatch.stats.mean) / standard.stats.mean * 100).toFixed(1);
-            console.log(`Auto-batching: ${improvement}% faster than individual calls`);
-        }
-
-        if (autoBatch && manualBatch) {
-            const overhead = ((autoBatch.stats.mean - manualBatch.stats.mean) / manualBatch.stats.mean * 100).toFixed(1);
-            console.log(`Auto-batching overhead: ${overhead}% vs manual batch`);
-        }
-    })
-    .run({ 'async': true });
+/**
+ * Auto-Batching Performance Benchmark
+ * 
+ * Compares standard individual get() calls vs auto-batched get() calls
+ * 
+ * Run with: node benchmarks/auto_batch_benchmark.js
+ */
+
+const Benchmark = require('benchmark');
+const { Database } = require('../');
+const { SmartDatabase } = require('../smart_database');
+
+const NUM_ENTRIES = 10_000;
+
+function generateTestData() {
+    const data = [];
+    for (let i = 0; i < NUM_ENTRIES; i++) {
+        const key = Buffer.from(`key_${i.toString().padStart(8, '0')}`);
+        const value = Buffer.from(`value_${i.toString().padStart(8, '0')}_data`);
+        data.push([key, value]);
+    }
+    return data;
+}
+
+// Prepare databases
+let standardDb, smartDb, testData, testKeys;
+
+const suite = new Benchmark.Suite();
+
+suite
+    .add('Standard GET 10k (individual calls)', {
+        onStart: function () {
+            standardDb = Database.openInMemory();
+            testData = generateTestData();
+            testKeys = testData.map(([key]) => key);
+            for (const [key, value] of testData) {
+                standardDb.insert('bench', key, value);
+            }
+        },
+        fn: function () {
+            for (const key of testKeys) {
+                standardDb.get('bench', key);
+            }
+        }
+    })
+    .add('Auto-Batched GET 10k (SmartDatabase)', {
+        onStart: function () {
+            const rawDb = Database.openInMemory();
+            smartDb = new SmartDatabase(rawDb);
+            testData = generateTestData();
+            testKeys = testData.map(([key]) => key);
+            for (const [key, value] of testData) {
+                smartDb.insert('bench', key, value);
+            }
+        },
+        fn: async function (deferred) {
+            // All get() calls are automatically batched
+            await Promise.all(testKeys.map(key => smartDb.get('bench', key)));
+            deferred.resolve();
+        },
+        defer: true
+    })
+    .add('Manual Batch GET 10k', {
+        onStart: function () {
+            standardDb = Database.openInMemory();
+            testData = generateTestData();
+            testKeys = testData.map(([key]) => key);
+            for (const [key, value] of testData) {
+                standardDb.insert('bench', key, value);
+            }
+        },
+        fn: function () {
+            standardDb.getBatch('bench', testKeys);
+        }
+    })
+    .on('cycle', function (event) {
+        console.log(String(event.target));
+        const timeMs = event.target.stats.mean * 1000;
+        console.log(`  → ${timeMs.toFixed(2)}ms per operation\n`);
+    })
+    .on('complete', function () {
+        console.log('\n=== Performance Comparison ===');
+
+        const standard = this.filter(name => name === 'Standard GET 10k (individual calls)')[0];
+        const autoBatch = this.filter(name => name === 'Auto-Batched GET 10k (SmartDatabase)')[0];
+        const manualBatch = this.filter(name => name === 'Manual Batch GET 10k')[0];
+
+        if (standard && autoBatch) {
+            const improvement = ((standard.stats.mean - autoBatch.stats.mean) / standard.stats.mean * 100).toFixed(1);
+            console.log(`Auto-batching: ${improvement}% faster than individual calls`);
+        }
+
+        if (autoBatch && manualBatch) {
+            const overhead = ((autoBatch.stats.mean - manualBatch.stats.mean) / manualBatch.stats.mean * 100).toFixed(1);
+            console.log(`Auto-batching overhead: ${overhead}% vs manual batch`);
+        }
+    })
+    .run({ 'async': true });