Function replyUserError

src/utils/errorHandler.js:290–313

(interaction, {
    type = ErrorTypes.UNKNOWN,
    message,
    subtype = null,
    ephemeral = true,
    context = {}
} = {})

 * Reply with a typed user-facing error (early-return validation, permission checks, etc.).
 */
export async function replyUserError(interaction, {
    type = ErrorTypes.UNKNOWN,
    message,
    subtype = null,
    ephemeral = true,
    context = {}
} = {}) {
    const errorType = type || ErrorTypes.UNKNOWN;
    const syntheticError = message
        ? createError('User error', errorType, message, { expected: true, ...context })
        : createError('User error', errorType, null, { expected: true, ...context });

    const userMessage = getUserMessage(syntheticError, { subtype, ...context });
    const { logData, traceId } = buildErrorLogData(interaction, syntheticError, errorType, {
        ...context,
        subtype,
        source: context.source || 'replyUserError'
    });

    logInteractionError(syntheticError, errorType, logData);

    const embed = buildUserErrorEmbed(errorType, userMessage);
    return sendErrorResponse(interaction, embed, { ...context, traceId, ephemeral, subtype });
}

export async function handleInteractionError(interaction, error, context = {}) {
    const errorType = categorizeError(error);