<?php

if (!defined('ABSPATH')) {
    exit;
}

/**
 * Error with a message that is safe and useful to show to a site owner.
 *
 * Messages are HTML-escaped when thrown (WordPress coding standards); use text() to get
 * the plain message for JSON, email and logs. HTML output escapes it again, and
 * esc_html() never double-encodes, so it displays correctly everywhere.
 */
class SWPB_Exception extends Exception
{
    public static function text(Throwable $e): string
    {
        return wp_specialchars_decode($e->getMessage(), ENT_QUOTES);
    }
}