Function normalizeScriptResult

src/assertions/scriptResultNormalization.ts:115–159

(
  assertion: AssertionParams['assertion'],
  result: ScriptAssertionResult,
  inverse: boolean,
  labels: ScriptLabels,
  reasonSuffix?: AssertionParams['assertion']['value'],
)

 * keys, threshold comparison, and inverse logic.
 */
export function normalizeScriptResult(
  assertion: AssertionParams['assertion'],
  result: ScriptAssertionResult,
  inverse: boolean,
  labels: ScriptLabels,
  reasonSuffix?: AssertionParams['assertion']['value'],
): GradingResult {
  const lowerStringResult = typeof result === 'string' ? result.toLowerCase() : undefined;

  if ((typeof result === 'boolean' && result) || lowerStringResult === 'true') {
    return normalizeScriptAssertionResult(assertion, true, inverse, labels, reasonSuffix);
  }

  if (typeof result === 'boolean' || lowerStringResult === 'false') {
    return normalizeScriptAssertionResult(assertion, false, inverse, labels, reasonSuffix);
  }

  if (typeof result === 'string' && result.startsWith('{')) {
    let parsed: unknown;
    try {
      parsed = JSON.parse(result);
    } catch (err) {
      throw new Error(`Invalid JSON: ${err} when parsing result: ${result}`);
    }

    if (typeof parsed !== 'object' || parsed === null) {
      throw new Error(
        `${labels.language} assertion must return a boolean, number, or {pass, score, reason} object. Got instead: ${result}`,
      );
    }
    return normalizeScriptObjectResult(assertion, parsed, inverse, labels, reasonSuffix);
  }

  if (typeof result === 'object' && result !== null) {
    return normalizeScriptObjectResult(assertion, result, inverse, labels, reasonSuffix);
  }

  const score = Number.parseFloat(String(result));
  if (Number.isNaN(score)) {
    throw new Error(
      `${labels.language} assertion must return a boolean, number, or {pass, score, reason} object. Instead got:\n${result}`,
    );
  }
  return normalizeScriptAssertionResult(assertion, score, inverse, labels, reasonSuffix);
}