Squashed 'vendor/ruvector/' content from commit b64c2172

git-subtree-dir: vendor/ruvector
git-subtree-split: b64c21726f2bb37286d9ee36a7869fef60cc6900

examples/nodejs/basic_usage.js

@@ -0,0 +1,68 @@
+/**
+ * Basic usage example for Ruvector (Node.js)
+ *
+ * Demonstrates:
+ * - Creating a database
+ * - Inserting vectors
+ * - Searching for similar vectors
+ */
+
+const { VectorDB } = require('ruvector');
+
+async function main() {
+    console.log('🚀 Ruvector Basic Usage Example (Node.js)\n');
+
+    // 1. Create a database
+    console.log('1. Creating database...');
+    const db = new VectorDB({
+        dimensions: 128,
+        storagePath: './examples_basic_node.db',
+        distanceMetric: 'cosine'
+    });
+    console.log('   ✓ Database created with 128 dimensions\n');
+
+    // 2. Insert a single vector
+    console.log('2. Inserting single vector...');
+    const vector = new Float32Array(128).fill(0.1);
+    const id = await db.insert({
+        id: 'doc_001',
+        vector: vector,
+        metadata: { text: 'Example document' }
+    });
+    console.log(`   ✓ Inserted vector: ${id}\n`);
+
+    // 3. Insert multiple vectors
+    console.log('3. Inserting multiple vectors...');
+    const entries = Array.from({ length: 100 }, (_, i) => ({
+        id: `doc_${String(i + 2).padStart(3, '0')}`,
+        vector: new Float32Array(128).fill(0.1 + i * 0.001),
+        metadata: { index: i + 2 }
+    }));
+
+    const ids = await db.insertBatch(entries);
+    console.log(`   ✓ Inserted ${ids.length} vectors\n`);
+
+    // 4. Search for similar vectors
+    console.log('4. Searching for similar vectors...');
+    const queryVector = new Float32Array(128).fill(0.15);
+    const results = await db.search({
+        vector: queryVector,
+        k: 5,
+        includeMetadata: true
+    });
+
+    console.log(`   ✓ Found ${results.length} results:`);
+    results.forEach((result, i) => {
+        console.log(`     ${i + 1}. ID: ${result.id}, Distance: ${result.distance.toFixed(6)}`);
+    });
+    console.log();
+
+    // 5. Get database stats
+    console.log('5. Database statistics:');
+    const total = db.count();
+    console.log(`   ✓ Total vectors: ${total}\n`);
+
+    console.log('✅ Example completed successfully!');
+}
+
+main().catch(console.error);