jexidb 2.0.0 → 2.0.2

package/dist/FileHandler.js

@@ -606,7 +606,7 @@ class FileHandler {
     } catch (error) {
       if (error.code === 'ENOENT') {
         return {
-          version: '2.0.0',
+          version: '2.0.1',
           // Keep version number for internal tracking
           created: new Date().toISOString(),
           lastModified: new Date().toISOString(),

package/dist/JSONLDatabase.js

@@ -36,8 +36,17 @@ class JSONLDatabase extends _events.EventEmitter {
     this.options = {
       batchSize: 100,
       // Batch size for inserts
+      create: true,
+      // Create database if it doesn't exist (default: true)
+      clear: false,
+      // Clear database on load if not empty (default: false)
       ...options
     };
+
+    // If clear is true, create should also be true
+    if (this.options.clear === true) {
+      this.options.create = true;
+    }
     this.isInitialized = false;
     this.offsets = [];
     this.indexOffset = 0;
@@ -80,10 +89,49 @@ class JSONLDatabase extends _events.EventEmitter {
       await _fs.promises.mkdir(dir, {
         recursive: true
       });
+
+      // Check if file exists before loading
+      const fileExists = await _fs.promises.access(this.filePath).then(() => true).catch(() => false);
+
+      // Handle clear option
+      if (this.options.clear && fileExists) {
+        await _fs.promises.writeFile(this.filePath, '');
+        this.offsets = [];
+        this.indexOffset = 0;
+        this.recordCount = 0;
+        console.log(`Database cleared: ${this.filePath}`);
+        this.isInitialized = true;
+        this.emit('init');
+        return;
+      }
+
+      // Handle create option
+      if (!fileExists) {
+        if (this.options.create) {
+          await _fs.promises.writeFile(this.filePath, '');
+          this.offsets = [];
+          this.indexOffset = 0;
+          this.recordCount = 0;
+          console.log(`Database created: ${this.filePath}`);
+          this.isInitialized = true;
+          this.emit('init');
+          return;
+        } else {
+          throw new Error(`Database file does not exist: ${this.filePath}`);
+        }
+      }
+
+      // Load existing database
       await this.loadDataWithOffsets();
       this.isInitialized = true;
       this.emit('init');
     } catch (error) {
+      // If create is false and file doesn't exist or is corrupted, throw error
+      if (!this.options.create) {
+        throw new Error(`Failed to load database: ${error.message}`);
+      }
+
+      // If create is true, initialize empty database
       this.recordCount = 0;
       this.offsets = [];
       this.indexOffset = 0;
@@ -171,9 +219,7 @@ class JSONLDatabase extends _events.EventEmitter {
       }
       this.recordCount = this.offsets.length;
     } catch (error) {
-      this.recordCount = 0;
-      this.offsets = [];
-      this.indexOffset = 0;
+      throw error; // Re-throw to be handled by init()
     }
   }
   async loadLegacyFormat(lines) {
@@ -821,6 +867,22 @@ class JSONLDatabase extends _events.EventEmitter {
     };
   }
 
+  /**
+   * Compatibility method: readColumnIndex - gets unique values from indexed columns only
+   * Maintains compatibility with JexiDB v1 code
+   * @param {string} column - The column name to get unique values from
+   * @returns {Set} Set of unique values in the column (indexed columns only)
+   */
+  readColumnIndex(column) {
+    // Only works with indexed columns
+    if (this.indexes[column]) {
+      return new Set(this.indexes[column].keys());
+    }
+
+    // For non-indexed columns, throw error
+    throw new Error(`Column '${column}' is not indexed. Only indexed columns are supported.`);
+  }
+
   // Intelligent criteria matching for non-indexed fields
   matchesCriteria(record, criteria, options = {}) {
     const {

package/dist/index.js

@@ -3,6 +3,7 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
+exports.Database = void 0;
 Object.defineProperty(exports, "FileHandler", {
   enumerable: true,
   get: function () {
@@ -207,11 +208,15 @@ class JexiDBCompatibility extends _JSONLDatabase.default {
   }
 
   /**
-   * Compatibility method: walk() -> find() with async iteration
+   * Streaming iterator over records without loading all into memory
+   * Supports a limited subset of options: { limit }
    */
   async *walk(options = {}) {
-    const results = await this.find({}, options);
-    for (const record of results) {
+    // Delegate to core engine streaming implementation
+    // Ensure pending inserts are flushed by calling super.walk
+    for await (const record of super.walk({
+      limit: options.limit
+    })) {
       yield record;
     }
   }
@@ -251,6 +256,16 @@ class JexiDBCompatibility extends _JSONLDatabase.default {
     }
     return result;
   }
+
+  /**
+   * Compatibility method: readColumnIndex - gets unique values from indexed columns only
+   * Maintains compatibility with JexiDB v1 code
+   * @param {string} column - The column name to get unique values from
+   * @returns {Set} Set of unique values in the column (indexed columns only)
+   */
+  readColumnIndex(column) {
+    return super.readColumnIndex(column);
+  }
 }
 
 /**
@@ -279,7 +294,11 @@ class JexiDBCompatibility extends _JSONLDatabase.default {
  */
 
 // Export the compatibility wrapper as default
-var _default = exports.default = JexiDBCompatibility; // Export auxiliary classes for advanced use
+var _default = exports.default = JexiDBCompatibility; // Retrocompat: named export 'Database' (JexiDB v1 used { Database })
+const Database = exports.Database = JexiDBCompatibility;
+
+// Export auxiliary classes for advanced use
+
 // Export useful constants
 const OPERATORS = exports.OPERATORS = {
   GT: '>',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jexidb",
-  "version": "2.0.0",
+  "version": "2.0.2",
   "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",

package/src/FileHandler.js

@@ -600,7 +600,7 @@ class FileHandler {
     } catch (error) {
       if (error.code === 'ENOENT') {
         return {
-          version: '2.0.0', // Keep version number for internal tracking
+          version: '2.0.1', // Keep version number for internal tracking
           created: new Date().toISOString(),
           lastModified: new Date().toISOString(),
           recordCount: 0,

package/src/JSONLDatabase.js

@@ -30,9 +30,16 @@ class JSONLDatabase extends EventEmitter {
     
     this.options = {
       batchSize: 100, // Batch size for inserts
+      create: true, // Create database if it doesn't exist (default: true)
+      clear: false, // Clear database on load if not empty (default: false)
       ...options
     };
     
+    // If clear is true, create should also be true
+    if (this.options.clear === true) {
+      this.options.create = true;
+    }
+    
     this.isInitialized = false;
     this.offsets = [];
     this.indexOffset = 0;
@@ -77,12 +84,50 @@ class JSONLDatabase extends EventEmitter {
       const dir = path.dirname(this.filePath);
       await fs.mkdir(dir, { recursive: true });
       
+      // Check if file exists before loading
+      const fileExists = await fs.access(this.filePath).then(() => true).catch(() => false);
+      
+      // Handle clear option
+      if (this.options.clear && fileExists) {
+        await fs.writeFile(this.filePath, '');
+        this.offsets = [];
+        this.indexOffset = 0;
+        this.recordCount = 0;
+        console.log(`Database cleared: ${this.filePath}`);
+        this.isInitialized = true;
+        this.emit('init');
+        return;
+      }
+      
+      // Handle create option
+      if (!fileExists) {
+        if (this.options.create) {
+          await fs.writeFile(this.filePath, '');
+          this.offsets = [];
+          this.indexOffset = 0;
+          this.recordCount = 0;
+          console.log(`Database created: ${this.filePath}`);
+          this.isInitialized = true;
+          this.emit('init');
+          return;
+        } else {
+          throw new Error(`Database file does not exist: ${this.filePath}`);
+        }
+      }
+      
+      // Load existing database
       await this.loadDataWithOffsets();
       
       this.isInitialized = true;
       this.emit('init');
       
     } catch (error) {
+      // If create is false and file doesn't exist or is corrupted, throw error
+      if (!this.options.create) {
+        throw new Error(`Failed to load database: ${error.message}`);
+      }
+      
+      // If create is true, initialize empty database
       this.recordCount = 0;
       this.offsets = [];
       this.indexOffset = 0;
@@ -180,9 +225,7 @@ class JSONLDatabase extends EventEmitter {
       this.recordCount = this.offsets.length;
       
     } catch (error) {
-      this.recordCount = 0;
-      this.offsets = [];
-      this.indexOffset = 0;
+      throw error; // Re-throw to be handled by init()
     }
   }
 
@@ -867,6 +910,22 @@ class JSONLDatabase extends EventEmitter {
     };
   }
 
+  /**
+   * Compatibility method: readColumnIndex - gets unique values from indexed columns only
+   * Maintains compatibility with JexiDB v1 code
+   * @param {string} column - The column name to get unique values from
+   * @returns {Set} Set of unique values in the column (indexed columns only)
+   */
+  readColumnIndex(column) {
+    // Only works with indexed columns
+    if (this.indexes[column]) {
+      return new Set(this.indexes[column].keys());
+    }
+    
+    // For non-indexed columns, throw error
+    throw new Error(`Column '${column}' is not indexed. Only indexed columns are supported.`);
+  }
+
   // Intelligent criteria matching for non-indexed fields
   matchesCriteria(record, criteria, options = {}) {
     const { caseInsensitive = false } = options;

package/src/index.js

@@ -183,11 +183,13 @@ class JexiDBCompatibility extends JSONLDatabase {
   }
 
   /**
-   * Compatibility method: walk() -> find() with async iteration
+   * Streaming iterator over records without loading all into memory
+   * Supports a limited subset of options: { limit }
    */
   async *walk(options = {}) {
-    const results = await this.find({}, options);
-    for (const record of results) {
+    // Delegate to core engine streaming implementation
+    // Ensure pending inserts are flushed by calling super.walk
+    for await (const record of super.walk({ limit: options.limit })) {
       yield record;
     }
   }
@@ -227,6 +229,16 @@ class JexiDBCompatibility extends JSONLDatabase {
     }
     return result;
   }
+
+  /**
+   * Compatibility method: readColumnIndex - gets unique values from indexed columns only
+   * Maintains compatibility with JexiDB v1 code
+   * @param {string} column - The column name to get unique values from
+   * @returns {Set} Set of unique values in the column (indexed columns only)
+   */
+  readColumnIndex(column) {
+    return super.readColumnIndex(column);
+  }
 }
 
 /**
@@ -256,6 +268,8 @@ class JexiDBCompatibility extends JSONLDatabase {
 
 // Export the compatibility wrapper as default
 export default JexiDBCompatibility;
+// Retrocompat: named export 'Database' (JexiDB v1 used { Database })
+export const Database = JexiDBCompatibility;
 
 // Export auxiliary classes for advanced use
 export { FileHandler, IndexManager, IntegrityChecker };