Function joinTextTokens

packages/util/src/logger/index.js:430–459

(textTokens)

 * This function ensures that it can handle both array and non-array inputs gracefully.
 */
const joinTextTokens = (textTokens) => {
  // Function to deeply flatten an array
  const flattenDeep = (array) => {
    // Make sure the input is actually an array; otherwise, wrap it in one
    if (!Array.isArray(array)) return [array]

    return array.reduce(
      (acc, val) =>
        Array.isArray(val) ? acc.concat(flattenDeep(val)) : acc.concat(val),
      [],
    )
  }

  // Make sure the initial input is treated as an array if it is not
  const flattened = flattenDeep(
    Array.isArray(textTokens) ? textTokens : [textTokens],
  )

  // Filter out non-string elements and join the remaining strings with newlines
  const finalText = flattened
    .filter((textToken) => typeof textToken === 'string')
    .join('\n')

  // If the final text does not end with a new line, add one for separation
  if (!finalText.endsWith('\n')) {
    return finalText + '\n'
  }

  return finalText
}

/**
 * Handles progress state and write operations