Function toBool

apps/api/src/config/env/validate.ts:41–64

(raw: string | undefined, name?: string)

const BOOL_FALSE_TOKENS = new Set(["false", "0", "no", "off", ""]);

export const toBool = (raw: string | undefined, name?: string): boolean => {
  if (raw === undefined) {
    return false;
  }

  const normalized = raw.trim().toLowerCase();

  if (BOOL_TRUE_TOKENS.has(normalized)) {
    return true;
  }

  if (BOOL_FALSE_TOKENS.has(normalized)) {
    return false;
  }

  const label = name ?? "<bool>";
  const accepted = [...BOOL_TRUE_TOKENS, ...BOOL_FALSE_TOKENS]
    .filter((token) => token !== "")
    .join(", ");

  throw new Error(
    `${label}: invalid boolean "${raw}". Accepted (case-insensitive): ${accepted}.`
  );
};

/**
 * For booleans whose schema default is `true`. Calling `toBool` alone