1 files changed, 81 insertions, 0 deletions
diff --git a/internal/hlog/errors.go b/internal/hlog/errors.go
new file mode 100644
index 00000000..d731f57f
--- /dev/null
+++ b/internal/hlog/errors.go
@@ -0,0 +1,81 @@
+package hlog
+
+import (
+	"fmt"
+	"log"
+	"reflect"
+	"strings"
+)
+
+// baseError implements a basic error container
+type baseError struct {
+	Err error
+}
+
+func (e *baseError) Error() string { return e.Err.Error() }
+func (e *baseError) Unwrap() error { return e.Err }
+
+// BaseError implements an error container with a user-facing message
+type BaseError struct {
+	message string
+	baseError
+}
+
+// Message returns a user-facing error message
+func (e *BaseError) Message() string { return e.message }
+
+// WrapErr wraps an error with a corresponding message.
+func WrapErr(err error, a ...any) error {
+	if err == nil {
+		return nil
+	}
+	return wrapErr(err, fmt.Sprintln(a...))
+}
+
+// WrapErrSuffix wraps an error with a corresponding message with err at the end of the message.
+func WrapErrSuffix(err error, a ...any) error {
+	if err == nil {
+		return nil
+	}
+	return wrapErr(err, fmt.Sprintln(append(a, err)...))
+}
+
+// WrapErrFunc wraps an error with a corresponding message returned by f.
+func WrapErrFunc(err error, f func(err error) string) error {
+	if err == nil {
+		return nil
+	}
+	return wrapErr(err, f(err))
+}
+
+func wrapErr(err error, message string) *BaseError {
+	return &BaseError{message, baseError{err}}
+}
+
+var (
+	baseErrorType = reflect.TypeFor[*BaseError]()
+)
+
+func AsBaseError(err error, target **BaseError) bool {
+	v := reflect.ValueOf(err)
+	if !v.CanConvert(baseErrorType) {
+		return false
+	}
+
+	*target = v.Convert(baseErrorType).Interface().(*BaseError)
+	return true
+}
+
+func PrintBaseError(err error, fallback string) {
+	var e *BaseError
+
+	if AsBaseError(err, &e) {
+		if msg := e.Message(); strings.TrimSpace(msg) != "" {
+			log.Print(msg)
+			return
+		}
+		Verbose("*"+fallback, err)
+		return
+	}
+	log.Println(fallback, err)
+}