Method addValue

packages/db-ivm/src/indexes.ts:300–356

* This method adds a value to the index. * @param key - The key to add the value to. * @param valueTuple - The value tuple [value, multiplicity] to add to the index.

(key: TKey, valueTuple: SingleValue<TValue>)

   * @param valueTuple - The value tuple [value, multiplicity] to add to the index.
   */
  addValue(key: TKey, valueTuple: SingleValue<TValue>) {
    const [value, multiplicity] = valueTuple
    // If the multiplicity is 0, do nothing
    if (multiplicity === 0) return

    // Update consolidated multiplicity tracking
    const newConsolidatedMultiplicity =
      (this.#consolidatedMultiplicity.get(key) || 0) + multiplicity
    if (newConsolidatedMultiplicity === 0) {
      this.#consolidatedMultiplicity.delete(key)
    } else {
      this.#consolidatedMultiplicity.set(key, newConsolidatedMultiplicity)
    }

    const mapOrSingleValue = this.#inner.get(key)

    if (mapOrSingleValue === undefined) {
      // First value for this key
      this.#inner.set(key, valueTuple)
      return
    }

    if (isSingleValue(mapOrSingleValue)) {
      // Handle transition from single value to map
      this.#handleSingleValueTransition(
        key,
        mapOrSingleValue,
        value,
        multiplicity,
      )
      return
    }

    if (mapOrSingleValue instanceof ValueMap) {
      // Handle existing ValueMap
      const prefix = getPrefix<TValue, TPrefix>(value)
      if (prefix !== NO_PREFIX) {
        // Convert ValueMap to PrefixMap since we have a prefixed value
        const prefixMap = new PrefixMap<TValue, TPrefix>()
        prefixMap.set(NO_PREFIX, mapOrSingleValue)
        prefixMap.set(prefix, valueTuple)
        this.#inner.set(key, prefixMap)
      } else {
        // Add to existing ValueMap
        const isEmpty = mapOrSingleValue.addValue(value, multiplicity)
        if (isEmpty) {
          this.#inner.delete(key)
        }
      }
    } else {
      // Handle existing PrefixMap
      const isEmpty = mapOrSingleValue.addValue(value, multiplicity)
      if (isEmpty) {
        this.#inner.delete(key)
      }
    }
  }