dbx-native 0.1.2-beta → 0.2.0-beta

package/benchmarks/zero_copy_benchmark.js

@@ -1,109 +1,109 @@
-/**
- * Zero-Copy FFI Performance Benchmark for DBX Node.js Bindings
- * 
- * Compares standard API vs zero-copy API performance
- * 
- * Run with: node benchmarks/zero_copy_benchmark.js
- */
-
-const Benchmark = require('benchmark');
-const { Database } = require('../');
-
-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, zeroCopyDb, batchDb;
-let testData, testKeys;
-
-const suite = new Benchmark.Suite();
-
-suite
-    .add('Standard SCAN 10k', {
-        onStart: function () {
-            standardDb = Database.openInMemory();
-            const data = generateTestData();
-            for (const [key, value] of data) {
-                standardDb.insert('bench', key, value);
-            }
-        },
-        fn: function () {
-            standardDb.scan('bench');
-        }
-    })
-    .add('Zero-Copy SCAN 10k', {
-        onStart: function () {
-            zeroCopyDb = Database.openInMemory();
-            const data = generateTestData();
-            for (const [key, value] of data) {
-                zeroCopyDb.insert('bench', key, value);
-            }
-        },
-        fn: function () {
-            const result = zeroCopyDb.scanZeroCopy('bench');
-            // Access the buffer (zero-copy)
-            const buffer = result.asBuffer();
-            const count = result.count();
-        }
-    })
-    .add('Standard 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 () {
-            for (const key of testKeys) {
-                standardDb.get('bench', key);
-            }
-        }
-    })
-    .add('Batch GET 10k', {
-        onStart: function () {
-            batchDb = Database.openInMemory();
-            testData = generateTestData();
-            testKeys = testData.map(([key]) => key);
-            for (const [key, value] of testData) {
-                batchDb.insert('bench', key, value);
-            }
-        },
-        fn: function () {
-            batchDb.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 standardScan = this.filter(name => name === 'Standard SCAN 10k')[0];
-        const zeroCopyScan = this.filter(name => name === 'Zero-Copy SCAN 10k')[0];
-        const standardGet = this.filter(name => name === 'Standard GET 10k')[0];
-        const batchGet = this.filter(name => name === 'Batch GET 10k')[0];
-
-        if (standardScan && zeroCopyScan) {
-            const scanImprovement = ((standardScan.stats.mean - zeroCopyScan.stats.mean) / standardScan.stats.mean * 100).toFixed(1);
-            console.log(`SCAN: ${scanImprovement}% faster with zero-copy`);
-        }
-
-        if (standardGet && batchGet) {
-            const getImprovement = ((standardGet.stats.mean - batchGet.stats.mean) / standardGet.stats.mean * 100).toFixed(1);
-            console.log(`GET: ${getImprovement}% faster with batch API`);
-        }
-    })
-    .run({ 'async': false });
+/**
+ * Zero-Copy FFI Performance Benchmark for DBX Node.js Bindings
+ * 
+ * Compares standard API vs zero-copy API performance
+ * 
+ * Run with: node benchmarks/zero_copy_benchmark.js
+ */
+
+const Benchmark = require('benchmark');
+const { Database } = require('../');
+
+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, zeroCopyDb, batchDb;
+let testData, testKeys;
+
+const suite = new Benchmark.Suite();
+
+suite
+    .add('Standard SCAN 10k', {
+        onStart: function () {
+            standardDb = Database.openInMemory();
+            const data = generateTestData();
+            for (const [key, value] of data) {
+                standardDb.insert('bench', key, value);
+            }
+        },
+        fn: function () {
+            standardDb.scan('bench');
+        }
+    })
+    .add('Zero-Copy SCAN 10k', {
+        onStart: function () {
+            zeroCopyDb = Database.openInMemory();
+            const data = generateTestData();
+            for (const [key, value] of data) {
+                zeroCopyDb.insert('bench', key, value);
+            }
+        },
+        fn: function () {
+            const result = zeroCopyDb.scanZeroCopy('bench');
+            // Access the buffer (zero-copy)
+            const buffer = result.asBuffer();
+            const count = result.count();
+        }
+    })
+    .add('Standard 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 () {
+            for (const key of testKeys) {
+                standardDb.get('bench', key);
+            }
+        }
+    })
+    .add('Batch GET 10k', {
+        onStart: function () {
+            batchDb = Database.openInMemory();
+            testData = generateTestData();
+            testKeys = testData.map(([key]) => key);
+            for (const [key, value] of testData) {
+                batchDb.insert('bench', key, value);
+            }
+        },
+        fn: function () {
+            batchDb.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 standardScan = this.filter(name => name === 'Standard SCAN 10k')[0];
+        const zeroCopyScan = this.filter(name => name === 'Zero-Copy SCAN 10k')[0];
+        const standardGet = this.filter(name => name === 'Standard GET 10k')[0];
+        const batchGet = this.filter(name => name === 'Batch GET 10k')[0];
+
+        if (standardScan && zeroCopyScan) {
+            const scanImprovement = ((standardScan.stats.mean - zeroCopyScan.stats.mean) / standardScan.stats.mean * 100).toFixed(1);
+            console.log(`SCAN: ${scanImprovement}% faster with zero-copy`);
+        }
+
+        if (standardGet && batchGet) {
+            const getImprovement = ((standardGet.stats.mean - batchGet.stats.mean) / standardGet.stats.mean * 100).toFixed(1);
+            console.log(`GET: ${getImprovement}% faster with batch API`);
+        }
+    })
+    .run({ 'async': false });

package/examples/basic.js

@@ -1,34 +1,34 @@
-const { Database } = require('../index.js');
-
-console.log('DBX Native (napi-rs) - Basic Example\n');
-
-// Open in-memory database
-const db = Database.openInMemory();
-console.log('✓ Opened in-memory database');
-
-// Insert some data
-db.insert('users', Buffer.from('user:1'), Buffer.from('Alice'));
-db.insert('users', Buffer.from('user:2'), Buffer.from('Bob'));
-console.log('✓ Inserted 2 users');
-
-// Get data
-const alice = db.get('users', Buffer.from('user:1'));
-console.log(`✓ Retrieved: ${alice.toString()}`);
-
-// Use transaction for batch operations
-const tx = db.beginTransaction();
-for (let i = 3; i <= 10; i++) {
-    tx.insert('users', Buffer.from(`user:${i}`), Buffer.from(`User${i}`));
-}
-tx.commit();
-console.log('✓ Inserted 8 more users via transaction');
-
-// Delete data
-db.delete('users', Buffer.from('user:1'));
-console.log('✓ Deleted user:1');
-
-// Close database
-db.close();
-console.log('✓ Closed database');
-
-console.log('\n✅ All operations completed successfully!');
+const { Database } = require('../index.js');
+
+console.log('DBX Native (napi-rs) - Basic Example\n');
+
+// Open in-memory database
+const db = Database.openInMemory();
+console.log('✓ Opened in-memory database');
+
+// Insert some data
+db.insert('users', Buffer.from('user:1'), Buffer.from('Alice'));
+db.insert('users', Buffer.from('user:2'), Buffer.from('Bob'));
+console.log('✓ Inserted 2 users');
+
+// Get data
+const alice = db.get('users', Buffer.from('user:1'));
+console.log(`✓ Retrieved: ${alice.toString()}`);
+
+// Use transaction for batch operations
+const tx = db.beginTransaction();
+for (let i = 3; i <= 10; i++) {
+    tx.insert('users', Buffer.from(`user:${i}`), Buffer.from(`User${i}`));
+}
+tx.commit();
+console.log('✓ Inserted 8 more users via transaction');
+
+// Delete data
+db.delete('users', Buffer.from('user:1'));
+console.log('✓ Deleted user:1');
+
+// Close database
+db.close();
+console.log('✓ Closed database');
+
+console.log('\n✅ All operations completed successfully!');

package/index.js

@@ -1,2 +1,2 @@
-// DBX Native Node.js bindings
-module.exports = require('./index.node');
+// DBX Native Node.js bindings
+module.exports = require('./index.node');

package/package.json

@@ -1,46 +1,46 @@
-{
-    "name": "dbx-native",
-    "version": "0.1.2-beta",
-    "description": "DBX native Node.js bindings using napi-rs",
-    "main": "index.js",
-    "types": "index.d.ts",
-    "napi": {
-        "binaryName": "dbx-native",
-        "targets": [
-            "x86_64-pc-windows-msvc",
-            "x86_64-apple-darwin",
-            "aarch64-apple-darwin",
-            "x86_64-unknown-linux-gnu"
-        ]
-    },
-    "scripts": {
-        "build": "napi build --platform --release --manifest-path ../../core/dbx-node/Cargo.toml",
-        "build:debug": "napi build --platform --manifest-path ../../core/dbx-node/Cargo.toml",
-        "prepublishOnly": "napi prepublish -t npm",
-        "test": "node examples/basic.js",
-        "bench": "node benchmarks/benchmark.js"
-    },
-    "devDependencies": {
-        "@napi-rs/cli": "^3.0.0",
-        "better-sqlite3": "^11.0.0"
-    },
-    "keywords": [
-        "database",
-        "key-value",
-        "rust",
-        "napi",
-        "native"
-    ],
-    "homepage": "https://bytelogiccore-spec.github.io/DBX/english/packages/nodejs",
-    "repository": {
-        "type": "git",
-        "url": "https://github.com/bytelogiccore-spec/DBX.git"
-    },
-    "license": "MIT",
-    "engines": {
-        "node": ">= 16"
-    },
-    "dependencies": {
-        "benchmark": "^2.1.4"
-    }
-}
+{
+    "name": "dbx-native",
+    "version": "0.2.0-beta",
+    "description": "DBX native Node.js bindings using napi-rs",
+    "main": "index.js",
+    "types": "index.d.ts",
+    "napi": {
+        "binaryName": "dbx-native",
+        "targets": [
+            "x86_64-pc-windows-msvc",
+            "x86_64-apple-darwin",
+            "aarch64-apple-darwin",
+            "x86_64-unknown-linux-gnu"
+        ]
+    },
+    "scripts": {
+        "build": "napi build --platform --release --manifest-path ../../core/dbx-node/Cargo.toml",
+        "build:debug": "napi build --platform --manifest-path ../../core/dbx-node/Cargo.toml",
+        "prepublishOnly": "napi prepublish -t npm",
+        "test": "node examples/basic.js",
+        "bench": "node benchmarks/benchmark.js"
+    },
+    "devDependencies": {
+        "@napi-rs/cli": "^3.0.0",
+        "better-sqlite3": "^11.0.0"
+    },
+    "keywords": [
+        "database",
+        "key-value",
+        "rust",
+        "napi",
+        "native"
+    ],
+    "homepage": "https://bytelogiccore-spec.github.io/DBX/english/packages/nodejs",
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/bytelogiccore-spec/DBX.git"
+    },
+    "license": "MIT",
+    "engines": {
+        "node": ">= 16"
+    },
+    "dependencies": {
+        "benchmark": "^2.1.4"
+    }
+}