Send mailing list emails

Signed-off-by: Sacha Al Himdani <sacha@getprobo.com>

pkg/server/mailactions/mux.go

@@ -0,0 +1,40 @@
+// Copyright (c) 2025 Probo Inc <hello@getprobo.com>.
+//
+// Permission to use, copy, modify, and/or distribute this software for any
+// purpose with or without fee is hereby granted, provided that the above
+// copyright notice and this permission notice appear in all copies.
+//
+// THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+// REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
+// AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+// INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+// LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+// OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+// PERFORMANCE OF THIS SOFTWARE.
+
+// Package mailactions provides HTTP handlers for mailing list subscription
+// management. All routes are mounted at /mail-actions/ with no API version
+// prefix so they can be linked directly from emails and bookmarked by users.
+//
+//	GET  /mail-actions/unsubscribe   shows an unsubscribe confirmation page
+//	POST /mail-actions/unsubscribe   RFC 8058 one-click unsubscribe
+//	GET  /mail-actions/confirm       shows a subscription confirmation page
+//	POST /mail-actions/confirm       confirms a pending subscription
+package mailactions
+
+import (
+	"github.com/go-chi/chi/v5"
+	"go.probo.inc/probo/pkg/mailman"
+)
+
+func NewMux(mailmanSvc *mailman.Service, tokenSecret string) *chi.Mux {
+	r := chi.NewMux()
+
+	r.Get("/unsubscribe", unsubscribeGetHandler())
+	r.Post("/unsubscribe", unsubscribePostHandler(mailmanSvc, tokenSecret))
+
+	r.Get("/confirm", confirmGetHandler())
+	r.Post("/confirm", confirmPostHandler(mailmanSvc, tokenSecret))
+
+	return r
+}