allow webhook only mode

Author: sultaniman

config/config.go

@@ -179,34 +179,36 @@ func (c *Config) Validate() []error {
 		c.Server.MessageSize = DefaultMessageSize
 	}
 
-	// validate mailer options
-	if c.Mailer.From == "" {
-		errorList = append(errorList, errors.New("mailer from is required"))
+	// validate mailer options if configured or required
+	if c.Mailer.DSN == "" && c.Webhook.Url == "" {
+		errorList = append(errorList, errors.New("either mailer dsn or webhook url is required"))
 	}
 
-	if _, err := mail.ParseAddress(c.Mailer.From); err != nil {
-		errorList = append(errorList, errors.New("invalid sender address"))
-	}
+	if c.Mailer.DSN != "" {
+		if c.Mailer.From == "" {
+			errorList = append(errorList, errors.New("mailer from is required"))
+		}
 
-	if c.Mailer.To == "" {
-		errorList = append(errorList, errors.New("recipient email is required"))
-	}
+		if _, err := mail.ParseAddress(c.Mailer.From); err != nil {
+			errorList = append(errorList, errors.New("invalid sender address"))
+		}
 
-	if _, err := mail.ParseAddress(c.Mailer.To); err != nil {
-		errorList = append(errorList, errors.New("invalid recipient address"))
-	}
+		if c.Mailer.To == "" {
+			errorList = append(errorList, errors.New("recipient email is required"))
+		}
 
-	if c.Mailer.DSN == "" {
-		errorList = append(errorList, errors.New("mailer dsn is required"))
-	}
+		if _, err := mail.ParseAddress(c.Mailer.To); err != nil {
+			errorList = append(errorList, errors.New("invalid recipient address"))
+		}
 
-	parts, err := url.Parse(c.Mailer.DSN)
-	if err != nil {
-		errorList = append(errorList, errors.New("invalid mailer dsn"))
-	}
+		parts, err := url.Parse(c.Mailer.DSN)
+		if err != nil {
+			errorList = append(errorList, errors.New("invalid mailer dsn"))
+		}
 
-	if parts.Scheme != "smtp" {
-		errorList = append(errorList, errors.New("only smtp servers supported"))
+		if parts.Scheme != "smtp" {
+			errorList = append(errorList, errors.New("only smtp servers supported"))
+		}
 	}
 
 	// validate webhook url

config/config_test.go

@@ -61,6 +61,5 @@ func TestConfigValidate(t *testing.T) {
 
 	assert.Contains(t, combined, "public key file does not exist")
 	assert.Contains(t, combined, "unable to read pubkey")
-	assert.Contains(t, combined, "mailer dsn is required")
-	assert.Contains(t, combined, "only smtp servers supported")
+	assert.Contains(t, combined, "either mailer dsn or webhook url is required")
 }

docs/qy/developer-guide.md

@@ -85,15 +85,15 @@ openssl rsa -pubout -in rsa_private.pem -out rsa_public.pem
 flowchart TD
     A[Cañy qabar ciberüü] --> B{Daroo ciberüü işke aştyby?}
     B -- Ooba --> C[Qabar ciberildi]
-    B -- Cok --> D[Inbox folderge saktoo]
+    B -- Cok --> D[Inbox folderine saktoo]
     D --> E[Cron cügürüü]
     E --> F[Qabarlardy oquu]
     F --> G{Qajra ciberüügö macburbu?}
     G -- Ooba --> H[Qabar ciberildi]
     G -- Ooba --> E
 ```
 
-## Testterdi Jügürtüü
+## Testterdi Cügürtüü
 
 ```sh
 go test ./...

docs/qy/readme.md

@@ -1,3 +1,7 @@
+[![Test](https://github.com/sultaniman/kpow/actions/workflows/test.yml/badge.svg)](https://github.com/sultaniman/kpow/actions/workflows/test.yml)
+---
+<a href="https://coff.ee/sultaniman" target="_blank"><img src="https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png" alt="Kofe alyp beriñiz" height="36"></a>
+
 # KPow 💥
 
 KPow bul öz aldynça tejlengen, kupujaluuluk türdö bagyttalgan bajlanyş formasy,
@@ -93,6 +97,9 @@ $ kpow verify --config=path-to-config.toml
 | `KPOW_INBOX_PATH`       | Inbox folderin coly             | string | ""              |
 | `KPOW_INBOX_CRON`       | Inboxtu iştetüü cron tartibi    | string | `*/5 * * * *`   |
 
+> [!note]
+> KPowğo Messec cetkirüü üçün `KPOW_MAILER_DSN` ce `KPOW_WEBHOOK_URL` boluşu kerek.
+
 ## Şifrlöö
 
 KPow Age, PGP, cana RSA açyk açkyç menen qatty şifrlöö üçün koldonulat.
@@ -110,7 +117,7 @@ age-keygen -o age.key
 grep "^# public key:" age.key | cut -d' ' -f3 > age.pub
 ```
 
-`age.pub` fajlyn `--pubkey` boluup qoldonuñuz.
+`age.pub` fajlyn `--pubkey` arqyluu qoldonuñuz.
 
 #### PGP
 

readme.md

@@ -101,6 +101,9 @@ $ kpow verify --config=path-to-config.toml
 | `KPOW_INBOX_PATH`       | Path to inbox                         | string | ""            |
 | `KPOW_INBOX_CRON`       | Cron schedule for inbox processing    | string | `*/5 * * * *` |
 
+> [!note]
+> Either `KPOW_MAILER_DSN` or `KPOW_WEBHOOK_URL` must be provided so KPow can deliver messages.
+
 ## Encryption
 
 KPow supports Age, PGP, and RSA public keys for encrypting messages.