mirror of
https://github.com/memohai/Memoh.git
synced 2026-04-27 07:16:19 +09:00
cc5f00355f
* feat: add email service with multi-adapter support Implement a full-stack email service with global provider management, per-bot bindings with granular read/write permissions, outbox audit storage, and MCP tool integration for direct mailbox access. Backend: - Email providers: CRUD with dynamic config schema (generic SMTP/IMAP, Mailgun) - Generic adapter: go-mail (SMTP) + go-imap/v2 (IMAP IDLE real-time push via UnilateralDataHandler + UID-based tracking + periodic check fallback) - Mailgun adapter: mailgun-go/v5 with dual inbound mode (webhook + poll) - Bot email bindings: per-bot provider binding with independent r/w permissions - Outbox: outbound email audit log with status tracking - Trigger: inbound emails push notification to bot_inbox (from/subject only, LLM reads full content on demand via MCP tools) - MailboxReader interface: on-demand IMAP queries for listing/reading emails - MCP tools: email_accounts, email_send, email_list (paginated mailbox), email_read (by UID) — all with multi-binding and provider_id selection - Webhook: /email/mailgun/webhook/:config_id (JWT-skipped, signature-verified) - DB migration: 0019_add_email (email_providers, bot_email_bindings, email_outbox) Frontend: - Email Providers page: /email-providers with MasterDetailSidebarLayout - Dynamic config form rendered from ordered provider meta schema with i18n keys - Bot detail: Email tab with bindings management + outbox audit table - Sidebar navigation entry - Full i18n support (en + zh) - Auto-generated SDK from Swagger Closes #17 * feat(email): trigger bot conversation immediately on inbound email Instead of only storing an inbox item and waiting for the next chat, the email trigger now proactively invokes the conversation resolver so the bot processes new emails right away — aligned with the schedule/heartbeat trigger pattern. * fix: lint --------- Co-authored-by: Acbox <acbox0328@gmail.com>
153 lines
4.7 KiB
Go
153 lines
4.7 KiB
Go
package handlers
|
|
|
|
import (
|
|
"log/slog"
|
|
"net/http"
|
|
"strings"
|
|
|
|
"github.com/labstack/echo/v4"
|
|
|
|
"github.com/memohai/memoh/internal/email"
|
|
)
|
|
|
|
type EmailProvidersHandler struct {
|
|
service *email.Service
|
|
logger *slog.Logger
|
|
}
|
|
|
|
func NewEmailProvidersHandler(log *slog.Logger, service *email.Service) *EmailProvidersHandler {
|
|
return &EmailProvidersHandler{
|
|
service: service,
|
|
logger: log.With(slog.String("handler", "email_providers")),
|
|
}
|
|
}
|
|
|
|
func (h *EmailProvidersHandler) Register(e *echo.Echo) {
|
|
g := e.Group("/email-providers")
|
|
g.GET("/meta", h.ListMeta)
|
|
g.POST("", h.Create)
|
|
g.GET("", h.List)
|
|
g.GET("/:id", h.Get)
|
|
g.PUT("/:id", h.Update)
|
|
g.DELETE("/:id", h.Delete)
|
|
}
|
|
|
|
// ListMeta godoc
|
|
// @Summary List email provider metadata
|
|
// @Description List available email provider types and config schemas
|
|
// @Tags email-providers
|
|
// @Success 200 {array} email.ProviderMeta
|
|
// @Router /email-providers/meta [get]
|
|
func (h *EmailProvidersHandler) ListMeta(c echo.Context) error {
|
|
return c.JSON(http.StatusOK, h.service.ListMeta(c.Request().Context()))
|
|
}
|
|
|
|
// Create godoc
|
|
// @Summary Create an email provider
|
|
// @Tags email-providers
|
|
// @Accept json
|
|
// @Produce json
|
|
// @Param request body email.CreateProviderRequest true "Email provider configuration"
|
|
// @Success 201 {object} email.ProviderResponse
|
|
// @Failure 400 {object} ErrorResponse
|
|
// @Failure 500 {object} ErrorResponse
|
|
// @Router /email-providers [post]
|
|
func (h *EmailProvidersHandler) Create(c echo.Context) error {
|
|
var req email.CreateProviderRequest
|
|
if err := c.Bind(&req); err != nil {
|
|
return echo.NewHTTPError(http.StatusBadRequest, err.Error())
|
|
}
|
|
if strings.TrimSpace(req.Name) == "" {
|
|
return echo.NewHTTPError(http.StatusBadRequest, "name is required")
|
|
}
|
|
if strings.TrimSpace(string(req.Provider)) == "" {
|
|
return echo.NewHTTPError(http.StatusBadRequest, "provider is required")
|
|
}
|
|
resp, err := h.service.CreateProvider(c.Request().Context(), req)
|
|
if err != nil {
|
|
return echo.NewHTTPError(http.StatusInternalServerError, err.Error())
|
|
}
|
|
return c.JSON(http.StatusCreated, resp)
|
|
}
|
|
|
|
// List godoc
|
|
// @Summary List email providers
|
|
// @Tags email-providers
|
|
// @Produce json
|
|
// @Param provider query string false "Provider type filter"
|
|
// @Success 200 {array} email.ProviderResponse
|
|
// @Failure 500 {object} ErrorResponse
|
|
// @Router /email-providers [get]
|
|
func (h *EmailProvidersHandler) List(c echo.Context) error {
|
|
items, err := h.service.ListProviders(c.Request().Context(), c.QueryParam("provider"))
|
|
if err != nil {
|
|
return echo.NewHTTPError(http.StatusInternalServerError, err.Error())
|
|
}
|
|
return c.JSON(http.StatusOK, items)
|
|
}
|
|
|
|
// Get godoc
|
|
// @Summary Get an email provider
|
|
// @Tags email-providers
|
|
// @Produce json
|
|
// @Param id path string true "Provider ID"
|
|
// @Success 200 {object} email.ProviderResponse
|
|
// @Failure 404 {object} ErrorResponse
|
|
// @Router /email-providers/{id} [get]
|
|
func (h *EmailProvidersHandler) Get(c echo.Context) error {
|
|
id := strings.TrimSpace(c.Param("id"))
|
|
if id == "" {
|
|
return echo.NewHTTPError(http.StatusBadRequest, "id is required")
|
|
}
|
|
resp, err := h.service.GetProvider(c.Request().Context(), id)
|
|
if err != nil {
|
|
return echo.NewHTTPError(http.StatusNotFound, err.Error())
|
|
}
|
|
return c.JSON(http.StatusOK, resp)
|
|
}
|
|
|
|
// Update godoc
|
|
// @Summary Update an email provider
|
|
// @Tags email-providers
|
|
// @Accept json
|
|
// @Produce json
|
|
// @Param id path string true "Provider ID"
|
|
// @Param request body email.UpdateProviderRequest true "Updated configuration"
|
|
// @Success 200 {object} email.ProviderResponse
|
|
// @Failure 400 {object} ErrorResponse
|
|
// @Failure 500 {object} ErrorResponse
|
|
// @Router /email-providers/{id} [put]
|
|
func (h *EmailProvidersHandler) Update(c echo.Context) error {
|
|
id := strings.TrimSpace(c.Param("id"))
|
|
if id == "" {
|
|
return echo.NewHTTPError(http.StatusBadRequest, "id is required")
|
|
}
|
|
var req email.UpdateProviderRequest
|
|
if err := c.Bind(&req); err != nil {
|
|
return echo.NewHTTPError(http.StatusBadRequest, err.Error())
|
|
}
|
|
resp, err := h.service.UpdateProvider(c.Request().Context(), id, req)
|
|
if err != nil {
|
|
return echo.NewHTTPError(http.StatusInternalServerError, err.Error())
|
|
}
|
|
return c.JSON(http.StatusOK, resp)
|
|
}
|
|
|
|
// Delete godoc
|
|
// @Summary Delete an email provider
|
|
// @Tags email-providers
|
|
// @Param id path string true "Provider ID"
|
|
// @Success 204 "No Content"
|
|
// @Failure 500 {object} ErrorResponse
|
|
// @Router /email-providers/{id} [delete]
|
|
func (h *EmailProvidersHandler) Delete(c echo.Context) error {
|
|
id := strings.TrimSpace(c.Param("id"))
|
|
if id == "" {
|
|
return echo.NewHTTPError(http.StatusBadRequest, "id is required")
|
|
}
|
|
if err := h.service.DeleteProvider(c.Request().Context(), id); err != nil {
|
|
return echo.NewHTTPError(http.StatusInternalServerError, err.Error())
|
|
}
|
|
return c.NoContent(http.StatusNoContent)
|
|
}
|