feat(domains): add new TLD creation page and update sidebar

- Introduced a new HTMX template for creating TLDs.
- Created a new Django template for the new TLD page.
- Updated the sidebar to include a link to the domains section.

refactor(types): remove unused types and consolidate request handling

- Deleted unused type definitions related to authentication, errors, mailboxes, overview, requests, responses, and users.
- Introduced a new collections package for generic data structures.
- Refactored request handling to use a more streamlined approach with RequestInfo and Param types.

fix(meta): improve pagination and sorting functionality

- Updated pagination logic to handle default values and edge cases.
- Introduced a new Sorting type for better sorting management in queries.

chore(urls): refactor URL handling and registry

- Replaced enums with string constants for HTTP methods.
- Consolidated route registration logic and improved type safety with RegisteredRoute.

style(shortcuts): clean up error handling and rendering functions

- Enhanced error handling functions for better readability and maintainability.
- Removed deprecated functions and improved the structure of rendering logic.

1 files changed, 107 insertions, 1 deletions

diff --git a/utils/shortcuts/render.go b/utils/shortcuts/render.go
index e91ccfa..89779cf 100644
--- a/utils/shortcuts/render.go
+++ b/utils/shortcuts/render.go
@@ -1,6 +1,16 @@
 package shortcuts
 
-import "github.com/gofiber/fiber/v2"
+import (
+	"fmt"
+	"maps"
+	"path"
+	"reflect"
+	"strings"
+
+	"dove/utils/errors"
+
+	"github.com/gofiber/fiber/v2"
+)
 
 func Render(context *fiber.Ctx, templateName string, data any) error {
 	templateData := make(fiber.Map)
@@ -20,3 +30,99 @@ func RenderWithStatus(context *fiber.Ctx, templateName string, data any, statusC
 	context.Status(statusCode)
 	return Render(context, templateName, data)
 }
+
+func resolveTemplate(context *fiber.Ctx, templateName string) string {
+	switch {
+	case context.Get("HX-Request") == "true" && context.Get("HX-Boosted") != "true":
+		directory := path.Dir(templateName)
+		filename := path.Base(templateName)
+		return fmt.Sprintf("%s/htmx/%s.htmx", directory, filename)
+	default:
+		return templateName
+	}
+}
+
+func mergeContextValues(context *fiber.Ctx, targetMap fiber.Map) {
+	context.Context().VisitUserValues(func(key []byte, value any) {
+		targetMap[string(key)] = value
+	})
+}
+
+func mergeBindData(targetMap fiber.Map, data any) error {
+	normalizedData, normalizeError := normalizeToMap(data)
+	if normalizeError != nil {
+		return normalizeError
+	}
+
+	maps.Copy(targetMap, normalizedData)
+	return nil
+}
+
+func normalizeToMap(data any) (fiber.Map, error) {
+	switch typedData := data.(type) {
+	case fiber.Map:
+		return typedData, nil
+	case map[string]any:
+		return fiber.Map(typedData), nil
+	default:
+		return convertStructToMap(data)
+	}
+}
+
+func convertStructToMap(data any) (fiber.Map, error) {
+	structValue := reflect.ValueOf(data)
+
+	switch structValue.Kind() {
+	case reflect.Pointer:
+		structValue = structValue.Elem()
+	}
+
+	switch structValue.Kind() {
+	case reflect.Struct:
+		return extractStructFields(structValue), nil
+	default:
+		return nil, errors.Error(UnsupportedBindType)
+	}
+}
+
+func extractStructFields(structValue reflect.Value) fiber.Map {
+	structType := structValue.Type()
+	fieldMap := make(fiber.Map, structValue.NumField())
+
+	for fieldIndex := range structType.NumField() {
+		fieldDescriptor := structType.Field(fieldIndex)
+
+		if !fieldDescriptor.IsExported() {
+			continue
+		}
+
+		fieldKey := resolveFieldKey(fieldDescriptor)
+		fieldMap[fieldKey] = structValue.Field(fieldIndex).Interface()
+	}
+
+	return fieldMap
+}
+
+func resolveFieldKey(fieldDescriptor reflect.StructField) string {
+	jsonTag := fieldDescriptor.Tag.Get("json")
+
+	switch {
+	case jsonTag == "" || jsonTag == "-":
+		return fieldDescriptor.Name
+	default:
+		return extractTagName(jsonTag, fieldDescriptor.Name)
+	}
+}
+
+func extractTagName(jsonTag string, fallbackName string) string {
+	separatorIndex := strings.IndexByte(jsonTag, ',')
+
+	switch {
+	case separatorIndex < 0:
+		return jsonTag
+	case separatorIndex > 0:
+		return jsonTag[:separatorIndex]
+	default:
+		return fallbackName
+	}
+}