feat: nexus account manager scaffold with auth, characters, realmsHEADmain

7 files changed, 203 insertions, 0 deletions

diff --git a/nexus/utils/shortcuts/errors.go b/nexus/utils/shortcuts/errors.go
new file mode 100644
index 0000000..cdb2ad2
--- /dev/null
+++ b/nexus/utils/shortcuts/errors.go
@@ -0,0 +1,20 @@
+package shortcuts

+

+import "github.com/gofiber/fiber/v2"

+

+func RouteError(context *fiber.Ctx, err *fiber.Error) error {

+	if isAPIRequest(context) {

+		return context.Status(err.Code).JSON(fiber.Map{

+			"error": err.Message,

+		})

+	}

+	return RenderWithStatus(context, "errors/error", err, err.Code)

+}

+

+func ServiceError(code int, message string) *fiber.Error {

+	return fiber.NewError(code, message)

+}

+

+func isAPIRequest(context *fiber.Ctx) bool {

+	return len(context.Path()) >= 4 && context.Path()[:4] == "/api"

+}

diff --git a/nexus/utils/shortcuts/flash.go b/nexus/utils/shortcuts/flash.go
new file mode 100644
index 0000000..c82b37d
--- /dev/null
+++ b/nexus/utils/shortcuts/flash.go
@@ -0,0 +1,36 @@
+package shortcuts

+

+import (

+	"nexus/sessions"

+	"nexus/utils/collections"

+

+	"github.com/gofiber/fiber/v2"

+	"github.com/gofiber/fiber/v2/middleware/session"

+)

+

+func Flash(context *fiber.Ctx, data collections.Record[string, any]) error {

+	sess, ok := context.Locals(sessions.SessionLocalKey).(*session.Session)

+	if !ok {

+		return nil

+	}

+	return sessions.SetFlash(sess, data)

+}

+

+func ConsumeFlash(context *fiber.Ctx) collections.Record[string, any] {

+	sess, ok := context.Locals(sessions.SessionLocalKey).(*session.Session)

+	if !ok {

+		return nil

+	}

+	data := sessions.GetFlash(sess)

+	if data != nil {

+		_ = sessions.ClearFlash(sess)

+	}

+	return data

+}

+

+func RedirectWithFlash(context *fiber.Ctx, routeName string, data collections.Record[string, any]) error {

+	if err := Flash(context, data); err != nil {

+		return err

+	}

+	return Redirect(context, routeName)

+}

diff --git a/nexus/utils/shortcuts/json.go b/nexus/utils/shortcuts/json.go
new file mode 100644
index 0000000..210d1a9
--- /dev/null
+++ b/nexus/utils/shortcuts/json.go
@@ -0,0 +1,12 @@
+package shortcuts

+

+import "github.com/gofiber/fiber/v2"

+

+func JSON(context *fiber.Ctx, data any) error {

+	return context.JSON(data)

+}

+

+func Created(context *fiber.Ctx, data any) error {

+	context.Status(fiber.StatusCreated)

+	return context.JSON(data)

+}

diff --git a/nexus/utils/shortcuts/messages.go b/nexus/utils/shortcuts/messages.go
new file mode 100644
index 0000000..819e536
--- /dev/null
+++ b/nexus/utils/shortcuts/messages.go
@@ -0,0 +1,5 @@
+package shortcuts

+

+const (

+	UnsupportedBindType = "Unsupported data type for binding. Only struct, collections.Record[string, any] are supported."

+)

diff --git a/nexus/utils/shortcuts/redirect.go b/nexus/utils/shortcuts/redirect.go
new file mode 100644
index 0000000..8999b7c
--- /dev/null
+++ b/nexus/utils/shortcuts/redirect.go
@@ -0,0 +1,11 @@
+package shortcuts

+

+import "github.com/gofiber/fiber/v2"

+

+func Redirect(context *fiber.Ctx, path string) error {

+	return context.Redirect(path)

+}

+

+func RedirectWithStatus(context *fiber.Ctx, path string, statusCode int) error {

+	return context.Redirect(path, statusCode)

+}

diff --git a/nexus/utils/shortcuts/render.go b/nexus/utils/shortcuts/render.go
new file mode 100644
index 0000000..5f3678f
--- /dev/null
+++ b/nexus/utils/shortcuts/render.go
@@ -0,0 +1,103 @@
+package shortcuts

+

+import (

+	"maps"

+	"nexus/utils/collections"

+	"reflect"

+	"strings"

+

+	"github.com/gofiber/fiber/v2"

+)

+

+func Render(context *fiber.Ctx, templateName string, data any) error {

+	templateData := make(collections.Record[string, any])

+

+	if flash := ConsumeFlash(context); flash != nil {

+		maps.Copy(templateData, flash)

+	}

+

+	mergeContextValues(context, templateData)

+

+	if data != nil {

+		if mergeError := mergeBindData(templateData, data); mergeError != nil {

+			return mergeError

+		}

+	}

+

+	return context.Render(templateName, templateData)

+}

+

+func RenderWithStatus(context *fiber.Ctx, templateName string, data any, statusCode int) error {

+	context.Status(statusCode)

+	return Render(context, templateName, data)

+}

+

+func NoContent(context *fiber.Ctx) error {

+	return context.SendStatus(fiber.StatusNoContent)

+}

+

+func mergeContextValues(context *fiber.Ctx, target collections.Record[string, any]) {

+	context.Context().VisitUserValuesAll(func(key any, value any) {

+		switch typedKey := key.(type) {

+		case string:

+			if typedKey != "" {

+				target[typedKey] = value

+			}

+		case []byte:

+			if len(typedKey) > 0 {

+				target[string(typedKey)] = value

+			}

+		}

+	})

+}

+

+func mergeBindData(target collections.Record[string, any], data any) error {

+	normalized, err := normalizeToMap(data)

+	if err != nil {

+		return err

+	}

+	maps.Copy(target, normalized)

+	return nil

+}

+

+func normalizeToMap(data any) (collections.Record[string, any], error) {

+	switch v := data.(type) {

+	case collections.Record[string, any]:

+		return v, nil

+	default:

+		return convertStructToMap(data)

+	}

+}

+

+func convertStructToMap(data any) (collections.Record[string, any], error) {

+	v := reflect.ValueOf(data)

+	if v.Kind() == reflect.Pointer {

+		v = v.Elem()

+	}

+	if v.Kind() != reflect.Struct {

+		return nil, fiber.NewError(fiber.StatusInternalServerError, UnsupportedBindType)

+	}

+

+	t := v.Type()

+	result := make(collections.Record[string, any], t.NumField())

+

+	for i := range t.NumField() {

+		field := t.Field(i)

+		if !field.IsExported() {

+			continue

+		}

+

+		key := field.Name

+		if tag := field.Tag.Get("json"); tag != "" && tag != "-" {

+			if idx := strings.IndexByte(tag, ','); idx > 0 {

+				key = tag[:idx]

+			} else if idx < 0 {

+				key = tag

+			}

+		}

+

+		result[key] = v.Field(i).Interface()

+	}

+

+	return result, nil

+}

diff --git a/nexus/utils/shortcuts/token.go b/nexus/utils/shortcuts/token.go
new file mode 100644
index 0000000..be9990f
--- /dev/null
+++ b/nexus/utils/shortcuts/token.go
@@ -0,0 +1,16 @@
+package shortcuts

+

+import (

+	"strings"

+

+	"github.com/gofiber/fiber/v2"

+)

+

+func BearerToken(context *fiber.Ctx) string {

+	authHeader := context.Get("Authorization")

+	parts := strings.SplitN(authHeader, " ", 2)

+	if len(parts) != 2 || parts[0] != "Bearer" {

+		return ""

+	}

+	return parts[1]

+}