<?php
/**
 * Administrator-safe text for unexpected errors.
 *
 * @package TurtleReport
 */

namespace TurtleReport\Support;

defined( 'ABSPATH' ) || exit;

/**
 * Catch-all boundaries store a short reason for administrators. Exceptions carry
 * messages written for that purpose; PHP engine errors (TypeError, ValueError...)
 * carry file paths and internals, so they are replaced with a generic reason.
 */
final class ErrorText {

	/**
	 * A short, displayable reason for an error caught at a catch-all boundary.
	 *
	 * @param \Throwable $error  Caught error.
	 * @param int        $length Maximum characters.
	 * @return string
	 */
	public static function from( \Throwable $error, $length = 300 ) {
		if ( ! $error instanceof \Exception ) {
			return __( 'An unexpected internal error occurred. Turn on WordPress debugging to see details.', 'turtlereport' );
		}
		return Text::substr( $error->getMessage(), 0, (int) $length );
	}
}