feat: Implement email change functionality

This commit introduces the following changes:

-   Added new API endpoints for email change requests and
    verification.
-   Updated the backend code to support email change workflow,
    including validation, code generation, and email sending.
-   Updated the frontend to include components for initiating and
    verifying email changes.
-   Added new dependencies to support email change functionality.
-   Updated the existing components to include email change
    functionality.

https://codeberg.org/mapleopentech/monorepo/issues/1

cloud/maplefile-backend/internal/interface/http/handlers.go

@@ -21,9 +21,11 @@ type Handlers struct {
 	GetDashboard *dashboard.GetDashboardHTTPHandler
 
 	// Me handlers
-	GetMe    *me.GetMeHTTPHandler
-	UpdateMe *me.PutUpdateMeHTTPHandler
-	DeleteMe *me.DeleteMeHTTPHandler
+	GetMe              *me.GetMeHTTPHandler
+	UpdateMe           *me.PutUpdateMeHTTPHandler
+	DeleteMe           *me.DeleteMeHTTPHandler
+	ChangeEmailRequest *me.PostChangeEmailRequestHTTPHandler
+	ChangeEmailVerify  *me.PostChangeEmailVerifyHTTPHandler
 
 	// User handlers
 	UserPublicLookup *user.UserPublicLookupHTTPHandler
@@ -106,6 +108,8 @@ func NewHandlers(
 	getMe *me.GetMeHTTPHandler,
 	updateMe *me.PutUpdateMeHTTPHandler,
 	deleteMe *me.DeleteMeHTTPHandler,
+	changeEmailRequest *me.PostChangeEmailRequestHTTPHandler,
+	changeEmailVerify *me.PostChangeEmailVerifyHTTPHandler,
 
 	// User
 	userPublicLookup *user.UserPublicLookupHTTPHandler,
@@ -183,9 +187,11 @@ func NewHandlers(
 		GetDashboard: getDashboard,
 
 		// Me
-		GetMe:    getMe,
-		UpdateMe: updateMe,
-		DeleteMe: deleteMe,
+		GetMe:              getMe,
+		UpdateMe:           updateMe,
+		DeleteMe:           deleteMe,
+		ChangeEmailRequest: changeEmailRequest,
+		ChangeEmailVerify:  changeEmailVerify,
 
 		// User
 		UserPublicLookup: userPublicLookup,

cloud/maplefile-backend/internal/interface/http/me/changeemail_request.go

@@ -0,0 +1,106 @@
+// codeberg.org/mapleopentech/monorepo/cloud/maplefile-backend/internal/interface/http/me/changeemail_request.go
+package me
+
+import (
+	"bytes"
+	"context"
+	"encoding/json"
+	"errors"
+	"io"
+	"net/http"
+
+	"go.uber.org/zap"
+
+	"codeberg.org/mapleopentech/monorepo/cloud/maplefile-backend/config"
+	"codeberg.org/mapleopentech/monorepo/cloud/maplefile-backend/internal/interface/http/middleware"
+	svc_me "codeberg.org/mapleopentech/monorepo/cloud/maplefile-backend/internal/service/me"
+	"codeberg.org/mapleopentech/monorepo/cloud/maplefile-backend/pkg/httperror"
+)
+
+type PostChangeEmailRequestHTTPHandler struct {
+	config     *config.Configuration
+	logger     *zap.Logger
+	service    svc_me.ChangeEmailRequestService
+	middleware middleware.Middleware
+}
+
+func NewPostChangeEmailRequestHTTPHandler(
+	config *config.Configuration,
+	logger *zap.Logger,
+	service svc_me.ChangeEmailRequestService,
+	middleware middleware.Middleware,
+) *PostChangeEmailRequestHTTPHandler {
+	logger = logger.With(zap.String("module", "maplefile"))
+	logger = logger.Named("PostChangeEmailRequestHTTPHandler")
+	return &PostChangeEmailRequestHTTPHandler{
+		config:     config,
+		logger:     logger,
+		service:    service,
+		middleware: middleware,
+	}
+}
+
+func (*PostChangeEmailRequestHTTPHandler) Pattern() string {
+	return "POST /api/v1/me/email/change-request"
+}
+
+func (r *PostChangeEmailRequestHTTPHandler) ServeHTTP(w http.ResponseWriter, req *http.Request) {
+	// Apply middleware before handling the request
+	r.middleware.Attach(r.Execute)(w, req)
+}
+
+func (h *PostChangeEmailRequestHTTPHandler) unmarshalRequest(
+	ctx context.Context,
+	r *http.Request,
+) (*svc_me.ChangeEmailRequestDTO, error) {
+	var requestData svc_me.ChangeEmailRequestDTO
+
+	defer r.Body.Close()
+
+	var rawJSON bytes.Buffer
+	teeReader := io.TeeReader(r.Body, &rawJSON) // TeeReader allows you to read the JSON and capture it
+
+	err := json.NewDecoder(teeReader).Decode(&requestData)
+	if err != nil {
+		h.logger.Error("decoding error",
+			zap.Any("err", err),
+			zap.String("json", rawJSON.String()),
+		)
+		return nil, httperror.NewForSingleField(http.StatusBadRequest, "non_field_error", "payload structure is wrong")
+	}
+
+	return &requestData, nil
+}
+
+func (h *PostChangeEmailRequestHTTPHandler) Execute(w http.ResponseWriter, r *http.Request) {
+	// Set response content type
+	w.Header().Set("Content-Type", "application/json")
+
+	ctx := r.Context()
+
+	req, err := h.unmarshalRequest(ctx, r)
+	if err != nil {
+		httperror.RespondWithError(w, r, err)
+		return
+	}
+
+	resp, err := h.service.Execute(ctx, req)
+	if err != nil {
+		httperror.RespondWithError(w, r, err)
+		return
+	}
+
+	// Encode response
+	if resp != nil {
+		if err := json.NewEncoder(w).Encode(resp); err != nil {
+			h.logger.Error("failed to encode response",
+				zap.Any("error", err))
+			httperror.RespondWithError(w, r, err)
+			return
+		}
+	} else {
+		err := errors.New("no result")
+		httperror.RespondWithError(w, r, err)
+		return
+	}
+}

cloud/maplefile-backend/internal/interface/http/me/changeemail_verify.go

@@ -0,0 +1,106 @@
+// codeberg.org/mapleopentech/monorepo/cloud/maplefile-backend/internal/interface/http/me/changeemail_verify.go
+package me
+
+import (
+	"bytes"
+	"context"
+	"encoding/json"
+	"errors"
+	"io"
+	"net/http"
+
+	"go.uber.org/zap"
+
+	"codeberg.org/mapleopentech/monorepo/cloud/maplefile-backend/config"
+	"codeberg.org/mapleopentech/monorepo/cloud/maplefile-backend/internal/interface/http/middleware"
+	svc_me "codeberg.org/mapleopentech/monorepo/cloud/maplefile-backend/internal/service/me"
+	"codeberg.org/mapleopentech/monorepo/cloud/maplefile-backend/pkg/httperror"
+)
+
+type PostChangeEmailVerifyHTTPHandler struct {
+	config     *config.Configuration
+	logger     *zap.Logger
+	service    svc_me.ChangeEmailVerifyService
+	middleware middleware.Middleware
+}
+
+func NewPostChangeEmailVerifyHTTPHandler(
+	config *config.Configuration,
+	logger *zap.Logger,
+	service svc_me.ChangeEmailVerifyService,
+	middleware middleware.Middleware,
+) *PostChangeEmailVerifyHTTPHandler {
+	logger = logger.With(zap.String("module", "maplefile"))
+	logger = logger.Named("PostChangeEmailVerifyHTTPHandler")
+	return &PostChangeEmailVerifyHTTPHandler{
+		config:     config,
+		logger:     logger,
+		service:    service,
+		middleware: middleware,
+	}
+}
+
+func (*PostChangeEmailVerifyHTTPHandler) Pattern() string {
+	return "POST /api/v1/me/email/change-verify"
+}
+
+func (r *PostChangeEmailVerifyHTTPHandler) ServeHTTP(w http.ResponseWriter, req *http.Request) {
+	// Apply middleware before handling the request
+	r.middleware.Attach(r.Execute)(w, req)
+}
+
+func (h *PostChangeEmailVerifyHTTPHandler) unmarshalRequest(
+	ctx context.Context,
+	r *http.Request,
+) (*svc_me.ChangeEmailVerifyRequestDTO, error) {
+	var requestData svc_me.ChangeEmailVerifyRequestDTO
+
+	defer r.Body.Close()
+
+	var rawJSON bytes.Buffer
+	teeReader := io.TeeReader(r.Body, &rawJSON) // TeeReader allows you to read the JSON and capture it
+
+	err := json.NewDecoder(teeReader).Decode(&requestData)
+	if err != nil {
+		h.logger.Error("decoding error",
+			zap.Any("err", err),
+			zap.String("json", rawJSON.String()),
+		)
+		return nil, httperror.NewForSingleField(http.StatusBadRequest, "non_field_error", "payload structure is wrong")
+	}
+
+	return &requestData, nil
+}
+
+func (h *PostChangeEmailVerifyHTTPHandler) Execute(w http.ResponseWriter, r *http.Request) {
+	// Set response content type
+	w.Header().Set("Content-Type", "application/json")
+
+	ctx := r.Context()
+
+	req, err := h.unmarshalRequest(ctx, r)
+	if err != nil {
+		httperror.RespondWithError(w, r, err)
+		return
+	}
+
+	resp, err := h.service.Execute(ctx, req)
+	if err != nil {
+		httperror.RespondWithError(w, r, err)
+		return
+	}
+
+	// Encode response
+	if resp != nil {
+		if err := json.NewEncoder(w).Encode(resp); err != nil {
+			h.logger.Error("failed to encode response",
+				zap.Any("error", err))
+			httperror.RespondWithError(w, r, err)
+			return
+		}
+	} else {
+		err := errors.New("no result")
+		httperror.RespondWithError(w, r, err)
+		return
+	}
+}

cloud/maplefile-backend/internal/interface/http/me/provider.go

@@ -36,3 +36,21 @@ func ProvideDeleteMeHTTPHandler(
 ) *DeleteMeHTTPHandler {
 	return NewDeleteMeHTTPHandler(cfg, logger, service, mw)
 }
+
+func ProvidePostChangeEmailRequestHTTPHandler(
+	cfg *config.Configuration,
+	logger *zap.Logger,
+	service svc_me.ChangeEmailRequestService,
+	mw middleware.Middleware,
+) *PostChangeEmailRequestHTTPHandler {
+	return NewPostChangeEmailRequestHTTPHandler(cfg, logger, service, mw)
+}
+
+func ProvidePostChangeEmailVerifyHTTPHandler(
+	cfg *config.Configuration,
+	logger *zap.Logger,
+	service svc_me.ChangeEmailVerifyService,
+	mw middleware.Middleware,
+) *PostChangeEmailVerifyHTTPHandler {
+	return NewPostChangeEmailVerifyHTTPHandler(cfg, logger, service, mw)
+}

cloud/maplefile-backend/internal/interface/http/middleware/utils.go

@@ -20,10 +20,12 @@ var (
 func init() {
 	// Exact matches
 	exactPaths = map[string]bool{
-		"/api/v1/me":                   true,
-		"/api/v1/me/delete":            true,
-		"/api/v1/me/blocked-emails":    true,
-		"/api/v1/dashboard":            true,
+		"/api/v1/me":                        true,
+		"/api/v1/me/delete":                 true,
+		"/api/v1/me/blocked-emails":         true,
+		"/api/v1/me/email/change-request":   true, // Email change step 1: request
+		"/api/v1/me/email/change-verify":    true, // Email change step 2: verify
+		"/api/v1/dashboard":                 true,
 		"/api/v1/collections":          true,
 		"/api/v1/collections/filtered": true,
 		"/api/v1/collections/root":     true,

cloud/maplefile-backend/internal/interface/http/provider.go

@@ -32,6 +32,8 @@ func ProvideHandlers(
 	getMe *me.GetMeHTTPHandler,
 	updateMe *me.PutUpdateMeHTTPHandler,
 	deleteMe *me.DeleteMeHTTPHandler,
+	changeEmailRequest *me.PostChangeEmailRequestHTTPHandler,
+	changeEmailVerify *me.PostChangeEmailVerifyHTTPHandler,
 
 	// User
 	userPublicLookup *user.UserPublicLookupHTTPHandler,
@@ -112,6 +114,8 @@ func ProvideHandlers(
 		getMe,
 		updateMe,
 		deleteMe,
+		changeEmailRequest,
+		changeEmailVerify,
 
 		// User
 		userPublicLookup,

cloud/maplefile-backend/internal/interface/http/server.go

@@ -110,6 +110,8 @@ func (s *Server) registerRoutes() {
 	s.mux.HandleFunc("GET /api/v1/me", s.handlers.GetMe.ServeHTTP)
 	s.mux.HandleFunc("PUT /api/v1/me", s.handlers.UpdateMe.ServeHTTP)
 	s.mux.HandleFunc("DELETE /api/v1/me", s.handlers.DeleteMe.ServeHTTP)
+	s.mux.HandleFunc("POST /api/v1/me/email/change-request", s.handlers.ChangeEmailRequest.ServeHTTP)
+	s.mux.HandleFunc("POST /api/v1/me/email/change-verify", s.handlers.ChangeEmailVerify.ServeHTTP)
 
 	// Blocked Email routes
 	s.mux.HandleFunc("POST /api/v1/me/blocked-emails", s.handlers.CreateBlockedEmail.ServeHTTP)

cloud/maplefile-backend/internal/interface/http/wire_server.go

@@ -160,6 +160,8 @@ func (s *WireServer) registerRoutes() {
 	s.mux.HandleFunc("GET /api/v1/me", s.handlers.GetMe.ServeHTTP)
 	s.mux.HandleFunc("PUT /api/v1/me", s.handlers.UpdateMe.ServeHTTP)
 	s.mux.HandleFunc("DELETE /api/v1/me", s.handlers.DeleteMe.ServeHTTP)
+	s.mux.HandleFunc("POST /api/v1/me/email/change-request", s.handlers.ChangeEmailRequest.ServeHTTP)
+	s.mux.HandleFunc("POST /api/v1/me/email/change-verify", s.handlers.ChangeEmailVerify.ServeHTTP)
 
 	// Blocked Email routes
 	s.mux.HandleFunc("POST /api/v1/me/blocked-emails", s.handlers.CreateBlockedEmail.ServeHTTP)