jexidb 2.2.2 → 2.2.3

package/dist/Database.cjs

@@ -2662,6 +2662,11 @@ class IndexManager {
    * on-disk index after an unload must first ensure it is loaded again, e.g.
    * `await database._ensureLazyIndexLoaded()`.
    *
+   * The return format is ALWAYS the actual term strings (words/values), never the
+   * internal numeric term IDs. For term-mapped columns the index stores term IDs as
+   * keys, so they are translated back to words through the TermManager before being
+   * returned. This keeps the API consistent across indexed fields.
+   *
    * @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)
@@ -2670,7 +2675,29 @@ class IndexManager {
     if (!this.index || !this.index.data || !this.index.data[column]) {
       return new Set();
     }
-    return new Set(Object.keys(this.index.data[column]));
+    const keys = Object.keys(this.index.data[column]);
+
+    // Consistent contract: always return term strings, never numeric term IDs.
+    const termManager = this.database?.termManager;
+    const isTermMappingField = Boolean(termManager && termManager.termMappingFields && termManager.termMappingFields.includes(column));
+    if (!isTermMappingField) {
+      return new Set(keys);
+    }
+
+    // Term-mapped column: index keys are numeric term IDs -> translate back to words.
+    const terms = new Set();
+    for (const key of keys) {
+      if (/^\d+$/.test(key)) {
+        const word = termManager.getTerm?.(Number(key));
+        if (word !== null && word !== undefined) {
+          terms.add(word);
+        }
+      } else {
+        // Defensive: key is already a term string (legacy/in-memory data)
+        terms.add(key);
+      }
+    }
+    return terms;
   }
 
   /**

package/package.json

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

@@ -2351,6 +2351,11 @@ export default class IndexManager {
    * on-disk index after an unload must first ensure it is loaded again, e.g.
    * `await database._ensureLazyIndexLoaded()`.
    *
+   * The return format is ALWAYS the actual term strings (words/values), never the
+   * internal numeric term IDs. For term-mapped columns the index stores term IDs as
+   * keys, so they are translated back to words through the TermManager before being
+   * returned. This keeps the API consistent across indexed fields.
+   *
    * @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)
@@ -2359,7 +2364,35 @@ export default class IndexManager {
     if (!this.index || !this.index.data || !this.index.data[column]) {
       return new Set()
     }
-    return new Set(Object.keys(this.index.data[column]))
+
+    const keys = Object.keys(this.index.data[column])
+
+    // Consistent contract: always return term strings, never numeric term IDs.
+    const termManager = this.database?.termManager
+    const isTermMappingField = Boolean(
+      termManager &&
+      termManager.termMappingFields &&
+      termManager.termMappingFields.includes(column)
+    )
+
+    if (!isTermMappingField) {
+      return new Set(keys)
+    }
+
+    // Term-mapped column: index keys are numeric term IDs -> translate back to words.
+    const terms = new Set()
+    for (const key of keys) {
+      if (/^\d+$/.test(key)) {
+        const word = termManager.getTerm?.(Number(key))
+        if (word !== null && word !== undefined) {
+          terms.add(word)
+        }
+      } else {
+        // Defensive: key is already a term string (legacy/in-memory data)
+        terms.add(key)
+      }
+    }
+    return terms
   }
 
   /**