improve Dashboard (WIP)

add Demo Dashboard to website (WIP)
add mail config AllowUnknownSenders

Author: marle3003

Taskfile.yml

@@ -33,7 +33,7 @@ tasks:
       - npm run clean
       - npm run copy-docs
       - npm version {{.VERSION}}
-      - npm run build
+      - npm run build-dashboard
   build-npm-package:
     deps: [build-vue-app]
     cmds:

docs/guides/mail/overview.md

@@ -237,11 +237,12 @@ folders:
 
 The settings object defines global configuration options that influence server behavior.
 
-| Field Name        | Type    | Default | Description                                                                                                                                                                                        |
-|-------------------|---------|---------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| maxRecipients     | integer | 0       | (Optional) Maximum number of recipients per email. Use 0 for unlimited.                                                                                                                            |
-| autoCreateMailbox | boolean | true    | (Optional) Allow create mailboxes at runtime.                                                                                                                                                      |
-| maxInboxMails     | integer | 100     | (Optional) Maximum number of messages kept in the INBOX folder. Oldest mails are removed when the limit is exceeded. Use 0 to disable the limit and store messages indefinitely (not recommended). |
+| Field Name            | Type    | Default | Description                                                                                                                                                                                        |
+|-----------------------|---------|---------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| maxRecipients         | integer | 0       | (Optional) Maximum number of recipients per email. Use 0 for unlimited.                                                                                                                            |
+| autoCreateMailbox     | boolean | true    | (Optional) Allow create mailboxes at runtime.                                                                                                                                                      |
+| maxInboxMails         | integer | 100     | (Optional) Maximum number of messages kept in the INBOX folder. Oldest mails are removed when the limit is exceeded. Use 0 to disable the limit and store messages indefinitely (not recommended). |
+| AllowUnknownSenders   | boolean | true    | (Optional) If true, the server accepts any MAIL FROM: address, even if it’s not listed in the mailboxes: configuration.                                                                            |
 
 ##### Mailbox Object Example
 

examples/mokapi/dashboard.yml

@@ -141,7 +141,7 @@ paths:
               schema:
                 $ref: './mail.yml#/components/schemas/MailboxDetails'
         "404":
-          description: mail not found
+          description: mailbox not found
   /api/services/mail/{name}/mailboxes/{mailbox}/messages:
     get:
       summary: Retrieve mailboxes for given mail server
@@ -166,6 +166,8 @@ paths:
                 type: array
                 items:
                   $ref: './mail.yml#/components/schemas/SmtpMessageInfo'
+        "404":
+          description: mailbox not found
   /api/services/mail/messages/{messageId}:
     get:
       summary: Retrieve the mail with the given messageId

examples/mokapi/services_http.js

@@ -521,7 +521,7 @@ export let apps = [
                 operations: [
                     {
                         method: "get",
-                        summary: "Add a new pet to the store",
+                        summary: "Get books from the store",
                         operationId: "listBooks",
                         responses: [
                             {

images/alpha.Dockerfile

@@ -9,7 +9,7 @@ WORKDIR webui
 COPY ./docs ./src/assets/docs
 
 RUN npm install
-RUN npm run build
+RUN npm run build-dashboard
 
 FROM golang:1.25.5-alpine AS gobuild
 

kafka/request_test.go

@@ -203,7 +203,7 @@ func Test_Offset(t *testing.T) {
 	require.Equal(t, b, buf.Bytes())
 }
 
-func Test_ApiVersion(t *testing.T) {
+func Test_ApiVersion_Version_Newer(t *testing.T) {
 	req := &kafka.Request{
 		Host: "",
 		Header: &kafka.Header{
@@ -226,3 +226,29 @@ func Test_ApiVersion(t *testing.T) {
 	err = result.Read(r)
 	require.NoError(t, err)
 }
+
+func Test_ApiVersion_Tagged(t *testing.T) {
+	req := &kafka.Request{
+		Host: "",
+		Header: &kafka.Header{
+			Size:          0,
+			ApiKey:        kafka.ApiVersions,
+			ApiVersion:    3,
+			CorrelationId: 0,
+		},
+		Message: &apiVersion.Request{
+			TagFields: map[int64]string{3: "abc"},
+		},
+	}
+	var buf bytes.Buffer
+	w := bufio.NewWriter(&buf)
+	err := req.Write(w)
+	require.NoError(t, err)
+	err = w.Flush()
+	require.NoError(t, err)
+
+	r := bufio.NewReader(&buf)
+	result := &kafka.Request{}
+	err = result.Read(r)
+	require.NoError(t, err)
+}

providers/mail/config.go

@@ -4,10 +4,11 @@ import (
 	"bytes"
 	"encoding/json"
 	"fmt"
-	"gopkg.in/yaml.v3"
 	"mokapi/config/dynamic"
 	"mokapi/smtp"
 	"regexp"
+
+	"gopkg.in/yaml.v3"
 )
 
 var serverNamePattern = regexp.MustCompile(`^[A-Za-z0-9_-]+$`)
@@ -42,9 +43,10 @@ type Server struct {
 }
 
 type Settings struct {
-	MaxRecipients     int  `yaml:"maxRecipients" json:"maxRecipients"`
-	AutoCreateMailbox bool `yaml:"autoCreateMailbox" json:"autoCreateMailbox"`
-	MaxInboxMails     int  `yaml:"maxInboxMails" json:"maxInboxMails"`
+	MaxRecipients       int  `yaml:"maxRecipients" json:"maxRecipients"`
+	AutoCreateMailbox   bool `yaml:"autoCreateMailbox" json:"autoCreateMailbox"`
+	MaxInboxMails       int  `yaml:"maxInboxMails" json:"maxInboxMails"`
+	AllowUnknownSenders bool `yaml:"allowUnknownSenders" json:"allowUnknownSenders"`
 }
 
 type MailboxConfig struct {
@@ -125,7 +127,7 @@ func (c *Config) Parse(_ *dynamic.Config, _ dynamic.Reader) error {
 func (c *Config) UnmarshalYAML(value *yaml.Node) error {
 	type alias Config
 	tmp := alias(*c)
-	tmp.Settings = &Settings{AutoCreateMailbox: true}
+	tmp.Settings = &Settings{AutoCreateMailbox: true, AllowUnknownSenders: true}
 	err := value.Decode(&tmp)
 	*c = Config(tmp)
 	return err
@@ -135,7 +137,7 @@ func (c *Config) UnmarshalJSON(b []byte) error {
 	dec := json.NewDecoder(bytes.NewReader(b))
 	type alias Config
 	tmp := alias(*c)
-	tmp.Settings = &Settings{AutoCreateMailbox: true}
+	tmp.Settings = &Settings{AutoCreateMailbox: true, AllowUnknownSenders: true}
 	err := dec.Decode(&tmp)
 	*c = Config(tmp)
 	return err

providers/mail/smtp_handler.go

@@ -2,12 +2,13 @@ package mail
 
 import (
 	"fmt"
-	log "github.com/sirupsen/logrus"
 	"mokapi/engine/common"
 	"mokapi/runtime/events"
 	"mokapi/runtime/monitor"
 	"mokapi/smtp"
 	"time"
+
+	log "github.com/sirupsen/logrus"
 )
 
 type Handler struct {
@@ -89,8 +90,10 @@ func (h *Handler) serveMail(rw smtp.ResponseWriter, r *smtp.MailRequest, ctx *sm
 	if len(h.config.Mailboxes) > 0 {
 
 		if m, ok := h.store.Mailboxes[r.From]; !ok {
-			h.writeErrorResponse(rw, r, smtp.AddressRejected, fmt.Sprintf("Unknown mailbox %v", r.From))
-			return
+			if !h.AllowUnknownSenders() {
+				h.writeErrorResponse(rw, r, smtp.AddressRejected, fmt.Sprintf("Unknown mailbox %v", r.From))
+				return
+			}
 		} else if len(m.Username) > 0 && len(ctx.Auth) == 0 {
 			h.writeErrorResponse(rw, r, smtp.AuthRequired, "")
 			return
@@ -151,3 +154,10 @@ func (h *Handler) writeRuleResponse(rw smtp.ResponseWriter, r smtp.Request, resp
 	l.Error = response.Message
 	_ = rw.Write(res)
 }
+
+func (h *Handler) AllowUnknownSenders() bool {
+	if h.config.Settings == nil {
+		return true
+	}
+	return h.config.Settings.AllowUnknownSenders
+}

providers/mail/smtp_handler_test.go

@@ -3,14 +3,15 @@ package mail_test
 import (
 	"context"
 	"encoding/base64"
-	"github.com/stretchr/testify/require"
 	"mokapi/engine/enginetest"
 	"mokapi/providers/mail"
 	"mokapi/runtime/events/eventstest"
 	"mokapi/smtp"
 	"mokapi/smtp/smtptest"
 	"testing"
 	"time"
+
+	"github.com/stretchr/testify/require"
 )
 
 func TestHandler_ServeSMTP(t *testing.T) {
@@ -71,11 +72,12 @@ func TestHandler_ServeSMTP(t *testing.T) {
 			},
 		},
 		{
-			name: "mail invalid mailbox",
+			name: "mail unknown mailbox with not allowing unknown mailbox",
 			config: &mail.Config{
 				Mailboxes: map[string]*mail.MailboxConfig{
 					"bob@foo.bar": {},
 				},
+				Settings: &mail.Settings{AllowUnknownSenders: false},
 			},
 			test: func(t *testing.T, h *mail.Handler, s *mail.Store, _ *eventstest.Handler) {
 				ctx := smtp.NewClientContext(context.Background(), "")
@@ -85,6 +87,22 @@ func TestHandler_ServeSMTP(t *testing.T) {
 				require.Equal(t, &exp, r.Result)
 			},
 		},
+		{
+			name: "mail unknown mailbox and allowing unknown mailbox",
+			config: &mail.Config{
+				Mailboxes: map[string]*mail.MailboxConfig{
+					"bob@foo.bar": {},
+				},
+				Settings: &mail.Settings{AllowUnknownSenders: true},
+			},
+			test: func(t *testing.T, h *mail.Handler, s *mail.Store, _ *eventstest.Handler) {
+				ctx := smtp.NewClientContext(context.Background(), "")
+				r := sendMail(t, h, ctx)
+				exp := smtp.Ok
+				exp.Message = "OK"
+				require.Equal(t, exp, r.Result)
+			},
+		},
 		{
 			name: "mail valid mailbox",
 			config: &mail.Config{

server/server_mail.go

@@ -2,7 +2,6 @@ package server
 
 import (
 	"fmt"
-	log "github.com/sirupsen/logrus"
 	"mokapi/config/dynamic"
 	engine "mokapi/engine/common"
 	"mokapi/imap"
@@ -13,6 +12,8 @@ import (
 	"mokapi/smtp"
 	"net"
 	"sync"
+
+	log "github.com/sirupsen/logrus"
 )
 
 type MailServer interface {
@@ -75,10 +76,7 @@ func (m *MailManager) startServers(cfg *runtime.MailInfo) error {
 	}
 	h := cfg.Handler(m.app.Monitor.Mail, m.eventEmitter, m.app.Events)
 	for _, server := range cfg.Servers {
-		_, port, err := net.SplitHostPort(server.Host)
-		if err != nil {
-			return err
-		}
+		_, port, _ := net.SplitHostPort(server.Host)
 
 		switch server.Protocol {
 		case "smtp":