jexidb 2.2.1 → 2.2.2

package/dist/Database.cjs

@@ -2652,6 +2652,27 @@ 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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jexidb",
-  "version": "2.2.1",
+  "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/managers/IndexManager.mjs

@@ -2341,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