Function envNumber

apps/sim/lib/core/config/env.ts:606–625

(
  value: number | string | undefined | null,
  fallback: number,
  options: { min?: number; integer?: boolean } = {}
)

 * type at the boundary instead of relying on JS implicit coercion.
 */
export function envNumber(
  value: number | string | undefined | null,
  fallback: number,
  options: { min?: number; integer?: boolean } = {}
): number {
  const min = options.min ?? 0
  if (
    typeof value === 'number' &&
    Number.isFinite(value) &&
    value >= min &&
    (!options.integer || Number.isInteger(value))
  ) {
    return value
  }
  if (value === undefined || value === null || value === '') return fallback
  const parsed = Number(value)
  return Number.isFinite(parsed) && parsed >= min && (!options.integer || Number.isInteger(parsed))
    ? parsed
    : fallback
}

/**
 * Coerce an env-derived value to a boolean. Returns `undefined` when unset