Initial commit

internal/platform/environment/environment.go

@@ -0,0 +1,95 @@
+// Package environment provides strict parsing for runtime configuration.
+package environment
+
+import (
+	"fmt"
+	"os"
+	"strconv"
+	"strings"
+	"time"
+)
+
+// String returns a trimmed environment value or fallback when it is empty.
+func String(name, fallback string) string {
+	if value := strings.TrimSpace(os.Getenv(name)); value != "" {
+		return value
+	}
+	return fallback
+}
+
+// Required returns a non-empty environment value.
+func Required(name string) (string, error) {
+	value := strings.TrimSpace(os.Getenv(name))
+	if value == "" {
+		return "", fmt.Errorf("%s must be set", name)
+	}
+	return value, nil
+}
+
+// Int parses an integer environment value.
+func Int(name string, fallback int) (int, error) {
+	value := strings.TrimSpace(os.Getenv(name))
+	if value == "" {
+		return fallback, nil
+	}
+	parsed, err := strconv.Atoi(value)
+	if err != nil {
+		return 0, fmt.Errorf("%s must be an integer: %w", name, err)
+	}
+	return parsed, nil
+}
+
+// Float parses a floating-point environment value.
+func Float(name string, fallback float64) (float64, error) {
+	value := strings.TrimSpace(os.Getenv(name))
+	if value == "" {
+		return fallback, nil
+	}
+	parsed, err := strconv.ParseFloat(value, 64)
+	if err != nil {
+		return 0, fmt.Errorf("%s must be a number: %w", name, err)
+	}
+	return parsed, nil
+}
+
+// Bool parses a boolean environment value.
+func Bool(name string, fallback bool) (bool, error) {
+	value := strings.TrimSpace(os.Getenv(name))
+	if value == "" {
+		return fallback, nil
+	}
+	parsed, err := strconv.ParseBool(value)
+	if err != nil {
+		return false, fmt.Errorf("%s must be a boolean: %w", name, err)
+	}
+	return parsed, nil
+}
+
+// Duration parses a Go duration environment value.
+func Duration(name string, fallback time.Duration) (time.Duration, error) {
+	value := strings.TrimSpace(os.Getenv(name))
+	if value == "" {
+		return fallback, nil
+	}
+	parsed, err := time.ParseDuration(value)
+	if err != nil {
+		return 0, fmt.Errorf("%s must be a duration: %w", name, err)
+	}
+	return parsed, nil
+}
+
+// CSV returns non-empty, trimmed comma-separated values.
+func CSV(name string) []string {
+	value := strings.TrimSpace(os.Getenv(name))
+	if value == "" {
+		return nil
+	}
+	parts := strings.Split(value, ",")
+	result := make([]string, 0, len(parts))
+	for _, part := range parts {
+		if part = strings.TrimSpace(part); part != "" {
+			result = append(result, part)
+		}
+	}
+	return result
+}

internal/platform/environment/environment_test.go

@@ -0,0 +1,44 @@
+package environment
+
+import (
+	"testing"
+	"time"
+)
+
+func TestParsers(t *testing.T) {
+	t.Setenv("TEST_INT", "42")
+	t.Setenv("TEST_FLOAT", "2.5")
+	t.Setenv("TEST_BOOL", "true")
+	t.Setenv("TEST_DURATION", "15m")
+	t.Setenv("TEST_CSV", " one, two ,,three ")
+
+	if value, err := Int("TEST_INT", 0); err != nil || value != 42 {
+		t.Fatalf("Int() = %d, %v", value, err)
+	}
+	if value, err := Float("TEST_FLOAT", 0); err != nil || value != 2.5 {
+		t.Fatalf("Float() = %f, %v", value, err)
+	}
+	if value, err := Bool("TEST_BOOL", false); err != nil || !value {
+		t.Fatalf("Bool() = %t, %v", value, err)
+	}
+	if value, err := Duration("TEST_DURATION", 0); err != nil || value != 15*time.Minute {
+		t.Fatalf("Duration() = %s, %v", value, err)
+	}
+	values := CSV("TEST_CSV")
+	if len(values) != 3 || values[1] != "two" {
+		t.Fatalf("CSV() = %#v", values)
+	}
+}
+
+func TestInvalidValues(t *testing.T) {
+	t.Setenv("TEST_VALUE", "not-valid")
+	if _, err := Int("TEST_VALUE", 0); err == nil {
+		t.Fatal("Int() did not return an error")
+	}
+	if _, err := Bool("TEST_VALUE", false); err == nil {
+		t.Fatal("Bool() did not return an error")
+	}
+	if _, err := Duration("TEST_VALUE", 0); err == nil {
+		t.Fatal("Duration() did not return an error")
+	}
+}

internal/platform/validate/doc.go

@@ -0,0 +1,3 @@
+// Package validate contains reusable validation helpers and an error collector
+// for API and form inputs.
+package validate

internal/platform/validate/helper.go

@@ -0,0 +1,44 @@
+package validate
+
+import (
+	"regexp"
+	"slices"
+	"strings"
+	"unicode/utf8"
+)
+
+// PermittedValue reports whether value appears in permittedValues.
+func PermittedValue[T comparable](value T, permittedValues ...T) bool {
+	return slices.Contains(permittedValues, value)
+}
+
+// Matches reports whether value satisfies rx.
+func Matches(value string, rx *regexp.Regexp) bool {
+	return rx.MatchString(value)
+}
+
+// Unique reports whether values contains no duplicate elements.
+func Unique[T comparable](values []T) bool {
+	uniqueValues := make(map[T]bool)
+
+	for _, value := range values {
+		uniqueValues[value] = true
+	}
+
+	return len(values) == len(uniqueValues)
+}
+
+// NotBlank reports whether value contains non-whitespace characters.
+func NotBlank(value string) bool {
+	return strings.TrimSpace(value) != ""
+}
+
+// MaxChars reports whether value contains at most n Unicode code points.
+func MaxChars(value string, n int) bool {
+	return utf8.RuneCountInString(value) <= n
+}
+
+// MinChars reports whether value contains at least n Unicode code points.
+func MinChars(value string, n int) bool {
+	return utf8.RuneCountInString(value) >= n
+}

internal/platform/validate/validator.go

@@ -0,0 +1,67 @@
+package validate
+
+import (
+	"regexp"
+)
+
+var (
+	// EmailRX matches the email-address format accepted by Gardomatic.
+	EmailRX = regexp.MustCompile("^[a-zA-Z0-9.!#$%&'*+/=?^_`{|}~-]+@[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?(?:\\.[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?)*$")
+	// ColorRX matches the hexadecimal RGB colors accepted for user colors.
+	ColorRX = regexp.MustCompile(`^#[0-9a-fA-F]{6}$`)
+)
+
+// Validator collects validation failures keyed by input field.
+type Validator struct {
+	Errors         map[string]string
+	NonFieldErrors []string
+	FieldErrors    map[string]string
+}
+
+// New returns an empty Validator.
+func New() *Validator {
+	return &Validator{Errors: make(map[string]string)}
+}
+
+// Valid reports whether no validation errors have been recorded.
+func (v *Validator) Valid() bool {
+	return len(v.Errors) == 0 && len(v.FieldErrors) == 0 && len(v.NonFieldErrors) == 0
+}
+
+// AddError records message for key unless key already has an error.
+func (v *Validator) AddError(key, message string) {
+	if _, exists := v.Errors[key]; !exists {
+		v.Errors[key] = message
+	}
+}
+
+// Check records message for key when ok is false.
+func (v *Validator) Check(ok bool, key, message string) {
+	if !ok {
+		v.AddError(key, message)
+	}
+}
+
+// AddNonFieldError records an error that is not associated with one field.
+func (v *Validator) AddNonFieldError(message string) {
+	v.NonFieldErrors = append(v.NonFieldErrors, message)
+}
+
+// AddFieldError records a form-specific field error.
+func (v *Validator) AddFieldError(key, message string) {
+
+	if v.FieldErrors == nil {
+		v.FieldErrors = make(map[string]string)
+	}
+
+	if _, exists := v.FieldErrors[key]; !exists {
+		v.FieldErrors[key] = message
+	}
+}
+
+// CheckField records a form-specific field error when ok is false.
+func (v *Validator) CheckField(ok bool, key, message string) {
+	if !ok {
+		v.AddFieldError(key, message)
+	}
+}