jexidb 2.0.1 → 2.0.3

package/examples/close-vs-delete-example.js

@@ -0,0 +1,71 @@
+import Database from '../src/index.js';
+
+async function demonstrateCloseVsDelete() {
+  console.log('🔍 Demonstrating close() vs destroy() vs deleteDatabase()\n');
+
+  // Example 1: close() - Fecha instância, mantém arquivo
+  console.log('📁 Example 1: close() - Closes instance, keeps file');
+  const db1 = new Database('./example-close.jdb', { indexes: { id: 'number' } });
+  await db1.init();
+  await db1.insert({ id: 1, name: 'John' });
+  await db1.insert({ id: 2, name: 'Jane' });
+  
+  console.log('   Records before close:', await db1.count());
+  await db1.close();  // Fecha instância, mantém arquivo
+  console.log('   ✅ Instance closed, file preserved\n');
+
+  // Reopen the same file
+  const db1Reopened = new Database('./example-close.jdb', { indexes: { id: 'number' } });
+  await db1Reopened.init();
+  console.log('   Records after reopening:', await db1Reopened.count());
+  await db1Reopened.close();
+  console.log('   ✅ Same data preserved\n');
+
+  // Example 2: destroy() - Equivalente a close()
+  console.log('📁 Example 2: destroy() - Equivalent to close()');
+  const db2 = new Database('./example-destroy.jdb', { indexes: { id: 'number' } });
+  await db2.init();
+  await db2.insert({ id: 1, name: 'Alice' });
+  await db2.insert({ id: 2, name: 'Bob' });
+  
+  console.log('   Records before destroy:', await db2.count());
+  await db2.destroy();  // Equivalente a close()
+  console.log('   ✅ Instance destroyed, file preserved\n');
+
+  // Reopen the same file
+  const db2Reopened = new Database('./example-destroy.jdb', { indexes: { id: 'number' } });
+  await db2Reopened.init();
+  console.log('   Records after reopening:', await db2Reopened.count());
+  await db2Reopened.close();
+  console.log('   ✅ Same data preserved\n');
+
+  // Example 3: deleteDatabase() - Remove arquivo físico
+  console.log('🗑️  Example 3: deleteDatabase() - Removes physical file');
+  const db3 = new Database('./example-delete.jdb', { indexes: { id: 'number' } });
+  await db3.init();
+  await db3.insert({ id: 1, name: 'Charlie' });
+  await db3.insert({ id: 2, name: 'Diana' });
+  
+  console.log('   Records before delete:', await db3.count());
+  
+  // Delete database file permanently
+  await db3.deleteDatabase();
+  console.log('   ✅ Database file deleted\n');
+
+  // Try to reopen - should fail
+  try {
+    const db3Reopened = new Database('./example-delete.jdb', { indexes: { id: 'number' } });
+    await db3Reopened.init();
+  } catch (error) {
+    console.log('   ❌ Cannot reopen (expected):', error.message);
+  }
+
+  console.log('\n📋 Summary:');
+  console.log('   • close()     - Closes instance, keeps file');
+  console.log('   • destroy()   - Equivalent to close()');
+  console.log('   • deleteDatabase() - Permanently deletes database file');
+  console.log('   • removeDatabase() - Alias for deleteDatabase()');
+}
+
+// Run the demonstration
+demonstrateCloseVsDelete().catch(console.error);

package/examples/esm-usage.js

@@ -0,0 +1,113 @@
+// Example: Using JexiDB with ESM (ES Modules)
+// This file demonstrates how to use the library in modern ESM environments
+
+import Database from 'jexidb';
+
+async function main() {
+  console.log('🚀 JexiDB Examples\n');
+
+  // Example 1: Basic usage
+  console.log('=== Example 1: Basic Usage ===');
+  
+  const db = new Database('./example-users.jdb', {
+    indexes: { id: 'number', email: 'string', age: 'number' }
+  });
+  
+  await db.init();
+  
+  // Insert records
+  await db.insert({ id: 1, name: 'John Doe', email: 'john@example.com', age: 30 });
+  await db.insert({ id: 2, name: 'Jane Smith', email: 'jane@example.com', age: 25 });
+  
+  console.log('✅ Records inserted: John Doe, Jane Smith');
+  
+  // Find all records
+  const allUsers = await db.find({});
+  console.log('📋 All users:', allUsers.length);
+  
+  // Find with criteria
+  const youngUsers = await db.find({ age: { '<': 30 } });
+  console.log('👶 Young users:', youngUsers.length);
+  
+  // Find one record
+  const john = await db.findOne({ name: 'John Doe' });
+  console.log('👤 John user:', john?.name);
+  
+  // Update records
+  const updated = await db.update({ id: 1 }, { age: 31 });
+  console.log('🔄 Updated records:', updated?.length);
+  
+  // Get statistics
+  const stats = await db.getStats();
+  console.log('📊 Database stats:', stats.summary);
+  
+  await db.save();
+  console.log('💾 Database saved');
+  
+  await db.destroy();
+  console.log('🔒 Database closed\n');
+
+  // Example 2: New options (create, clear)
+  console.log('=== Example 2: New Options (create, clear) ===');
+  
+  const db2 = new Database('./example-options.jdb', {
+    indexes: { category: 'string' },
+    create: true,
+    clear: false
+  });
+  
+  await db2.init();
+  console.log('✅ Database created with create: true');
+  
+  await db2.insert({ id: 1, category: 'Electronics' });
+  await db2.insert({ id: 2, category: 'Books' });
+  await db2.save();
+  await db2.destroy();
+  
+  // Test clear option
+  const db3 = new Database('./example-options.jdb', {
+    indexes: { category: 'string' },
+    clear: true
+  });
+  
+  await db3.init();
+  console.log('✅ Database cleared with clear: true, length:', db3.length);
+  await db3.destroy();
+
+  // Example 3: readColumnIndex
+  console.log('\n=== Example 3: readColumnIndex ===');
+  
+  const db4 = new Database('./example-columns.jdb', {
+    indexes: { category: 'string', status: 'string' },
+    create: true
+  });
+  
+  await db4.init();
+  
+  await db4.insertMany([
+    { id: 1, category: 'Electronics', status: 'active' },
+    { id: 2, category: 'Books', status: 'inactive' },
+    { id: 3, category: 'Electronics', status: 'active' },
+    { id: 4, category: 'Clothing', status: 'active' }
+  ]);
+  
+  // Get unique values from indexed columns
+  const categories = db4.readColumnIndex('category');
+  console.log('📊 Unique categories:', Array.from(categories));
+  
+  const statuses = db4.readColumnIndex('status');
+  console.log('📊 Unique statuses:', Array.from(statuses));
+  
+  // Test error for non-indexed column
+  try {
+    db4.readColumnIndex('name');
+  } catch (error) {
+    console.log('✅ Correctly threw error for non-indexed column:', error.message);
+  }
+  
+  await db4.destroy();
+  
+  console.log('\n🎉 All examples completed successfully!');
+}
+
+main().catch(console.error); 

package/examples/example-columns.jdb

@@ -0,0 +1,9 @@
+{"id":1,"category":"Electronics","status":"active","_id":0,"_created":1754747670129,"_updated":1754747670129}
+{"id":2,"category":"Books","status":"inactive","_id":1,"_created":1754747670129,"_updated":1754747670129}
+{"id":3,"category":"Electronics","status":"active","_id":2,"_created":1754747670129,"_updated":1754747670129}
+{"id":4,"category":"Clothing","status":"active","_id":3,"_created":1754747670129,"_updated":1754747670129}
+{"id":1,"category":"Electronics","status":"active","_id":4,"_created":1754747697710,"_updated":1754747697710}
+{"id":2,"category":"Books","status":"inactive","_id":5,"_created":1754747697710,"_updated":1754747697710}
+{"id":3,"category":"Electronics","status":"active","_id":6,"_created":1754747697710,"_updated":1754747697710}
+{"id":4,"category":"Clothing","status":"active","_id":7,"_created":1754747697710,"_updated":1754747697710}
+[0,110,216,326,433,543,649,759]

package/examples/example-users.jdb

@@ -0,0 +1,5 @@
+{"id":1,"name":"John Doe","email":"john@example.com","age":31,"_id":0,"_created":1754747670096,"_updated":1754747670100}
+{"id":2,"name":"Jane Smith","email":"jane@example.com","age":25,"_id":1,"_created":1754747670096,"_updated":1754747670096}
+{"id":1,"name":"John Doe","email":"john@example.com","age":31,"_id":2,"_created":1754747697684,"_updated":1754747697691}
+{"id":2,"name":"Jane Smith","email":"jane@example.com","age":25,"_id":3,"_created":1754747697684,"_updated":1754747697684}
+[0,121,244,365]

package/examples/simple-test.js

@@ -0,0 +1,55 @@
+// Simple test to demonstrate readColumnIndex method
+const Database = require('../dist/index.js').default;
+
+async function testReadColumnIndex() {
+  console.log('🧪 Testing readColumnIndex Method\n');
+
+  const db = new Database('./test-columns.jdb', { 
+    indexes: { category: 'string', status: 'string' },
+    create: true
+  });
+  
+  await db.init();
+  
+  // Insert test data with duplicates
+  await db.insertMany([
+    { id: 1, category: 'Electronics', status: 'active', price: 100 },
+    { id: 2, category: 'Books', status: 'inactive', price: 20 },
+    { id: 3, category: 'Electronics', status: 'active', price: 150 }, // Duplicate category and status
+    { id: 4, category: 'Clothing', status: 'active', price: 50 },
+    { id: 5, category: 'Electronics', status: 'active', price: 200 }  // Another duplicate
+  ]);
+  await db.save();
+  
+  console.log('📊 Test Data Inserted:');
+  console.log('  - 5 records total');
+  console.log('  - 3 Electronics, 1 Books, 1 Clothing');
+  console.log('  - 4 active, 1 inactive status');
+  console.log('  - 5 different prices\n');
+  
+  // Test indexed columns
+  console.log('=== Indexed Columns ===');
+  
+  const categories = db.readColumnIndex('category');
+  console.log('📂 readColumnIndex("category"):', Array.from(categories));
+  // Expected: ['Electronics', 'Books', 'Clothing']
+  
+  const statuses = db.readColumnIndex('status');
+  console.log('📊 readColumnIndex("status"):', Array.from(statuses));
+  // Expected: ['active', 'inactive']
+  
+  // Test non-indexed columns (should throw error)
+  console.log('\n=== Non-Indexed Columns ===');
+  
+  try {
+    const prices = db.readColumnIndex('price');
+    console.log('❌ This should not appear');
+  } catch (error) {
+    console.log('❌ readColumnIndex("price") error:', error.message);
+  }
+  
+  await db.destroy();
+  console.log('\n✅ Test completed successfully!');
+}
+
+testReadColumnIndex().catch(console.error);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jexidb",
-  "version": "2.0.1",
+  "version": "2.0.3",
   "description": "JexiDB - A fast and reliable local CRUD database for Electron apps with pure JavaScript JSONL architecture",
   "main": "./dist/index.js",
   "module": "./src/index.js",
@@ -58,7 +58,10 @@
   "files": [
     "dist",
     "src",
-    "README.md"
+    "README.md",
+    "CHANGELOG.md",
+    "docs",
+    "examples"
   ],
   "dependencies": {
   }