jexidb 2.2.0 → 2.2.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jexidb",
-  "version": "2.2.0",
+  "version": "2.2.2",
   "type": "module",
   "description": "JexiDB is a pure JS NPM library for managing data on disk efficiently, without the need for a server.",
   "main": "./dist/Database.cjs",

package/src/Database.mjs

@@ -4056,12 +4056,23 @@ class Database extends EventEmitter {
       this.termManager.termMappingFields && 
       this.termManager.termMappingFields.includes(fieldName)
     
+    // CRITICAL FIX: Ensure index is loaded before accessing data
+    // After idle unload, index.data[fieldName] becomes {} (truthy but empty)
+    // Use _ensureLazyIndexLoaded() to reload from disk instead of _rebuildIndexesIfNeeded()
+    // which requires allowIndexRebuild=true and rebuilds from scratch
+    if (!this.indexManager.indexLoaded) {
+      await this._ensureLazyIndexLoaded()
+    }
+    
     // Access the index for this field
     const fieldIndex = this.indexManager.index.data[fieldName]
-    if (!fieldIndex) {
+    if (!fieldIndex || Object.keys(fieldIndex).length === 0) {
       return []
     }
     
+    // Reset idle unload timer since we're using the index
+    this.indexManager.markIndexUsed()
+    
     // Accumulate scores for each line number
     const scoreMap = new Map()
     const countMap = opts.mode === 'avg' ? new Map() : null

package/src/managers/IndexManager.mjs

@@ -103,6 +103,11 @@ export default class IndexManager {
       console.log(`🧹 IndexManager.unload: Unloading index data after ${this.indexIdleUnloadMs}ms idle`)
     }
 
+    // Mark rebuild as needed so score() can trigger lazy reload
+    if (this.database) {
+      this.database._indexRebuildNeeded = true
+    }
+
     this._clearIdleUnloadTimer()
     const newData = {}
     for (const field of this.indexedFields) {
@@ -2336,6 +2341,27 @@ export default class IndexManager {
     this.markIndexUsed()
   }
 
+  /**
+   * Restored public API: return the indexed terms (keys) currently held in memory
+   * for a given column.
+   *
+   * IMPORTANT: This method reads ONLY the in-memory index. It never triggers a lazy
+   * reload and never performs any disk I/O. If the index was idle-unloaded
+   * (`indexLoaded === false`), it returns an empty Set. Callers that need the
+   * on-disk index after an unload must first ensure it is loaded again, e.g.
+   * `await database._ensureLazyIndexLoaded()`.
+   *
+   * @param {string} column - Indexed field name (e.g. 'nameTerms', 'groupTerms', 'category')
+   * @returns {Set<string>} Terms currently indexed for the column (empty Set if the
+   * column is not indexed or the index is not loaded)
+   */
+  readColumnIndex(column) {
+    if (!this.index || !this.index.data || !this.index.data[column]) {
+      return new Set()
+    }
+    return new Set(Object.keys(this.index.data[column]))
+  }
+
   /**
    * Convert index to JSON-serializable format for debugging and export
    * This resolves the issue where Sets appear as empty objects in JSON.stringify