better message formatting

api/pkg/merrors/errors.go

@@ -3,6 +3,7 @@ package merrors
 import (
 	"errors"
 	"fmt"
+	"strings"
 
 	"go.mongodb.org/mongo-driver/bson/primitive"
 )
@@ -27,8 +28,8 @@ func Internal(msg string) error {
 
 var ErrInvalidArg = errors.New("invalidArgError")
 
-func InvalidArgument(msg string) error {
-	return fmt.Errorf("%w: %s", ErrInvalidArg, msg)
+func InvalidArgument(msg string, argumentNames ...string) error {
+	return fmt.Errorf("%w: %s", ErrInvalidArg, invalidArgumentMessage(msg, argumentNames...))
 }
 
 var ErrDataConflict = errors.New("DataConflict")
@@ -64,8 +65,8 @@ func NoMessagingTopic(topic string) error {
 	return fmt.Errorf("%w: messaging topic '%s' not found", ErrNoMessagingTopic, topic)
 }
 
-func InvalidArgumentWrap(err error, msg string) error {
-	return wrapError(ErrInvalidArg, msg, err)
+func InvalidArgumentWrap(err error, msg string, argumentNames ...string) error {
+	return wrapError(ErrInvalidArg, invalidArgumentMessage(msg, argumentNames...), err)
 }
 
 func InternalWrap(err error, msg string) error {
@@ -79,3 +80,23 @@ func wrapError(base error, msg string, err error) error {
 	}
 	return errors.Join(baseErr, err)
 }
+
+func invalidArgumentMessage(msg string, argumentNames ...string) string {
+	names := make([]string, 0, len(argumentNames))
+	for _, name := range argumentNames {
+		name = strings.TrimSpace(name)
+		if name == "" {
+			continue
+		}
+		names = append(names, fmt.Sprintf("%q", name))
+	}
+	if len(names) == 0 {
+		return msg
+	}
+
+	prefix := "broken argument"
+	if len(names) > 1 {
+		prefix = "broken arguments"
+	}
+	return fmt.Sprintf("%s %s: %s", prefix, strings.Join(names, ", "), msg)
+}