Function parseOptionalNumberInput

apps/sim/blocks/utils.ts:469–510

(
  value: unknown,
  label: string,
  options: ParseOptionalNumberInputOptions = {}
)

 * Returns `undefined` for empty values and throws when the provided value is not a valid number.
 */
export function parseOptionalNumberInput(
  value: unknown,
  label: string,
  options: ParseOptionalNumberInputOptions = {}
): number | undefined {
  if (value === undefined || value === null || value === '') {
    return undefined
  }

  let parsed: number

  if (typeof value === 'number') {
    parsed = value
  } else if (typeof value === 'string') {
    const trimmed = value.trim()
    if (trimmed.length === 0) {
      return undefined
    }

    parsed = Number(trimmed)
  } else {
    throw new Error(`Invalid number for ${label}: expected a valid number.`)
  }

  if (!Number.isFinite(parsed)) {
    throw new Error(`Invalid number for ${label}: expected a valid number.`)
  }

  if (options.integer && !Number.isInteger(parsed)) {
    throw new Error(`Invalid number for ${label}: expected an integer.`)
  }

  if (options.min != null && parsed < options.min) {
    throw new Error(`${label} must be at least ${options.min}.`)
  }

  if (options.max != null && parsed > options.max) {
    throw new Error(`${label} must be at most ${options.max}.`)
  }

  return parsed
}

/**
 * Parses an optional boolean block input value.