feat(system): build the Email SMTP settings screen + a live send test

CAPABILITIES.md

@@ -5,7 +5,7 @@
 > before assuming something isn't built. `@api` = stable to build on; `@internal` = may change.
 > Grouped by **capability** (across layers), not by directory.
 
-**185 classes** across **32 capabilities** · **19 modules**. Full prose: [FEATURES.md](FEATURES.md) (what) · [ARCHITECTURE.md](ARCHITECTURE.md) (why). Not-yet-built: [BACKLOG.md](BACKLOG.md).
+**194 classes** across **32 capabilities** · **19 modules**. Full prose: [FEATURES.md](FEATURES.md) (what) · [ARCHITECTURE.md](ARCHITECTURE.md) (why). Not-yet-built: [BACKLOG.md](BACKLOG.md).
 
 ## Capabilities (`library/Tiger`)
 
@@ -149,6 +149,15 @@
 ### Mail
 
 - **Tiger_Mail** `@api` — a thin, fluent wrapper over Zend_Mail.  ·  `library/Tiger/Mail.php`
+- **Tiger_Mail_Provider** `@api` — the catalog of mail providers the admin can choose from.  ·  `library/Tiger/Mail/Provider.php`
+- **Tiger_Mail_Transport_Api** `@api` — base for the HTTPS mail-API drivers (SendGrid, Mailgun, Postmark, Resend, Brevo, Mailjet, SES).  ·  `library/Tiger/Mail/Transport/Api.php`
+- **Tiger_Mail_Transport_Brevo** `@api` — send over the Brevo (formerly Sendinblue) transactional API.  ·  `library/Tiger/Mail/Transport/Brevo.php`
+- **Tiger_Mail_Transport_Mailgun** `@api` — send over the Mailgun Messages API.  ·  `library/Tiger/Mail/Transport/Mailgun.php`
+- **Tiger_Mail_Transport_Mailjet** `@api` — send over the Mailjet Send API v3.1.  ·  `library/Tiger/Mail/Transport/Mailjet.php`
+- **Tiger_Mail_Transport_Postmark** `@api` — send over the Postmark Email API.  ·  `library/Tiger/Mail/Transport/Postmark.php`
+- **Tiger_Mail_Transport_Resend** `@api` — send over the Resend API.  ·  `library/Tiger/Mail/Transport/Resend.php`
+- **Tiger_Mail_Transport_SendGrid** `@api` — send over the SendGrid v3 Mail Send API.  ·  `library/Tiger/Mail/Transport/SendGrid.php`
+- **Tiger_Mail_Transport_Ses** `@api` — send over the Amazon SES v2 API using the vendored AWS SDK.  ·  `library/Tiger/Mail/Transport/Ses.php`
 
 ### Location
 

core/languages/de/core.php

@@ -193,4 +193,17 @@
     'core.media.field.clear'           => 'Entfernen',
     'core.media.field.preview_alt'     => 'Vorschau des ausgewählten Mediums',
     'core.media.field.file'            => 'Ausgewählte Datei',
+
+    // --- Mail providers (Tiger_Mail_Provider) ---
+    'core.mail.provider.help.ses_smtp'         => 'SES-SMTP-Zugangsdaten werden in der SES-Konsole erzeugt — sie sind NICHT Ihre AWS-Zugriffsschlüssel. Tragen Sie sie unten als Benutzername und Passwort ein.',
+    'core.mail.provider.help.ses_api'          => 'Versendet über die SES-v2-API mit dem mitgelieferten AWS-SDK.',
+    'core.mail.provider.help.ses_api_iam'      => 'Lassen Sie Schlüssel und Secret leer, um die IAM-Rolle der Instanz zu verwenden — dann wird gar kein Zugangsdatum gespeichert.',
+    'core.mail.provider.help.sendgrid_smtp'    => 'Verwenden Sie den wörtlichen Benutzernamen „apikey“ und Ihren API-Schlüssel als Passwort.',
+    'core.mail.provider.help.postmark_smtp'    => 'Verwenden Sie Ihr Server-API-Token SOWOHL als Benutzernamen ALS AUCH als Passwort.',
+    'core.mail.provider.help.resend_smtp'      => 'Verwenden Sie den wörtlichen Benutzernamen „resend“ und Ihren API-Schlüssel als Passwort.',
+    'core.mail.provider.help.mailgun_region'   => 'Mailgun betreibt getrennte US- und EU-Regionen; ein Schlüssel funktioniert nur in der Region, in der er erstellt wurde.',
+    'core.mail.provider.help.google_smtp'      => 'Erfordert ein App-Passwort bei aktivierter Bestätigung in zwei Schritten — das normale Kontopasswort funktioniert nicht.',
+    'core.mail.provider.help.microsoft_smtp'   => 'Microsoft deaktiviert SMTP AUTH standardmäßig und stellt die Basisauthentifizierung ein; möglicherweise müssen Sie sie für dieses Postfach aktivieren.',
+    'core.mail.provider.requires.aws_sdk'      => 'Dieser Treiber benötigt das AWS-SDK-Modul (tiger-sdk-aws). Installieren und aktivieren Sie es, oder verwenden Sie Amazon SES (SMTP).',
+    'core.mail.provider.requires.generic'      => 'Der Treiber dieses Anbieters ist auf dieser Installation nicht verfügbar.',
 ];

core/languages/en/core.php

@@ -197,4 +197,17 @@
     'core.media.field.clear'           => 'Clear',
     'core.media.field.preview_alt'     => 'Selected media preview',
     'core.media.field.file'            => 'Selected file',
+
+    // --- Mail providers (Tiger_Mail_Provider) ---
+    'core.mail.provider.help.ses_smtp'         => 'SES SMTP credentials are generated in the SES console — they are NOT your AWS access keys. Enter them as the username and password below.',
+    'core.mail.provider.help.ses_api'          => 'Sends through the SES v2 API using the vendored AWS SDK.',
+    'core.mail.provider.help.ses_api_iam'      => 'Leave the key and secret blank to use the instance IAM role — then no credentials are stored at all.',
+    'core.mail.provider.help.sendgrid_smtp'    => 'Use the literal username "apikey" and your API key as the password.',
+    'core.mail.provider.help.postmark_smtp'    => 'Use your Server API token as BOTH the username and the password.',
+    'core.mail.provider.help.resend_smtp'      => 'Use the literal username "resend" and your API key as the password.',
+    'core.mail.provider.help.mailgun_region'   => 'Mailgun runs separate US and EU regions, and a key only works in the region it was created in.',
+    'core.mail.provider.help.google_smtp'      => 'Requires an App Password with 2-Step Verification enabled — a normal account password will not work.',
+    'core.mail.provider.help.microsoft_smtp'   => 'Microsoft disables SMTP AUTH by default and is retiring basic authentication; you may need to enable it for this mailbox.',
+    'core.mail.provider.requires.aws_sdk'      => 'This driver needs the AWS SDK module (tiger-sdk-aws). Install and activate it, or use Amazon SES (SMTP) instead.',
+    'core.mail.provider.requires.generic'      => 'This provider\'s driver is not available on this install.',
 ];

core/languages/es/core.php

@@ -193,4 +193,17 @@
     'core.media.field.clear'           => 'Quitar',
     'core.media.field.preview_alt'     => 'Vista previa del medio seleccionado',
     'core.media.field.file'            => 'Archivo seleccionado',
+
+    // --- Mail providers (Tiger_Mail_Provider) ---
+    'core.mail.provider.help.ses_smtp'         => 'Las credenciales SMTP de SES se generan en la consola de SES; NO son tus claves de acceso de AWS. Introdúcelas como usuario y contraseña más abajo.',
+    'core.mail.provider.help.ses_api'          => 'Envía mediante la API SES v2 usando el SDK de AWS incluido.',
+    'core.mail.provider.help.ses_api_iam'      => 'Deja la clave y el secreto en blanco para usar el rol IAM de la instancia: así no se almacena ninguna credencial.',
+    'core.mail.provider.help.sendgrid_smtp'    => 'Usa el usuario literal «apikey» y tu clave de API como contraseña.',
+    'core.mail.provider.help.postmark_smtp'    => 'Usa tu Server API token TANTO como usuario como contraseña.',
+    'core.mail.provider.help.resend_smtp'      => 'Usa el usuario literal «resend» y tu clave de API como contraseña.',
+    'core.mail.provider.help.mailgun_region'   => 'Mailgun opera regiones separadas de EE. UU. y UE, y una clave solo funciona en la región donde se creó.',
+    'core.mail.provider.help.google_smtp'      => 'Requiere una contraseña de aplicación con la verificación en dos pasos activada; la contraseña normal de la cuenta no funciona.',
+    'core.mail.provider.help.microsoft_smtp'   => 'Microsoft desactiva SMTP AUTH de forma predeterminada y está retirando la autenticación básica; puede que tengas que habilitarla para este buzón.',
+    'core.mail.provider.requires.aws_sdk'      => 'Este controlador necesita el módulo del SDK de AWS (tiger-sdk-aws). Instálalo y actívalo, o usa Amazon SES (SMTP).',
+    'core.mail.provider.requires.generic'      => 'El controlador de este proveedor no está disponible en esta instalación.',
 ];

core/languages/fr/core.php

@@ -193,4 +193,17 @@
     'core.media.field.clear'           => 'Retirer',
     'core.media.field.preview_alt'     => 'Aperçu du média sélectionné',
     'core.media.field.file'            => 'Fichier sélectionné',
+
+    // --- Mail providers (Tiger_Mail_Provider) ---
+    'core.mail.provider.help.ses_smtp'         => 'Les identifiants SMTP SES se génèrent dans la console SES — ce ne sont PAS vos clés d\'accès AWS. Saisissez-les ci-dessous comme nom d\'utilisateur et mot de passe.',
+    'core.mail.provider.help.ses_api'          => 'Envoie via l\'API SES v2 à l\'aide du SDK AWS fourni.',
+    'core.mail.provider.help.ses_api_iam'      => 'Laissez la clé et le secret vides pour utiliser le rôle IAM de l\'instance — aucun identifiant n\'est alors stocké.',
+    'core.mail.provider.help.sendgrid_smtp'    => 'Utilisez le nom d\'utilisateur littéral « apikey » et votre clé d\'API comme mot de passe.',
+    'core.mail.provider.help.postmark_smtp'    => 'Utilisez votre jeton Server API À LA FOIS comme nom d\'utilisateur et comme mot de passe.',
+    'core.mail.provider.help.resend_smtp'      => 'Utilisez le nom d\'utilisateur littéral « resend » et votre clé d\'API comme mot de passe.',
+    'core.mail.provider.help.mailgun_region'   => 'Mailgun exploite des régions US et UE distinctes ; une clé ne fonctionne que dans la région où elle a été créée.',
+    'core.mail.provider.help.google_smtp'      => 'Nécessite un mot de passe d\'application avec la validation en deux étapes activée — le mot de passe habituel du compte ne fonctionnera pas.',
+    'core.mail.provider.help.microsoft_smtp'   => 'Microsoft désactive SMTP AUTH par défaut et retire l\'authentification de base ; vous devrez peut-être l\'activer pour cette boîte aux lettres.',
+    'core.mail.provider.requires.aws_sdk'      => 'Ce pilote nécessite le module SDK AWS (tiger-sdk-aws). Installez-le et activez-le, ou utilisez Amazon SES (SMTP).',
+    'core.mail.provider.requires.generic'      => 'Le pilote de ce fournisseur n\'est pas disponible sur cette installation.',
 ];

core/languages/hi/core.php

@@ -193,4 +193,17 @@
     'core.media.field.clear'           => 'हटाएँ',
     'core.media.field.preview_alt'     => 'चयनित मीडिया का प्रीव्यू',
     'core.media.field.file'            => 'चयनित फ़ाइल',
+
+    // --- Mail providers (Tiger_Mail_Provider) ---
+    'core.mail.provider.help.ses_smtp'         => 'SES SMTP क्रेडेंशियल SES कंसोल में बनाए जाते हैं — ये आपकी AWS एक्सेस कुंजियाँ नहीं हैं। इन्हें नीचे उपयोगकर्ता नाम और पासवर्ड के रूप में डालें।',
+    'core.mail.provider.help.ses_api'          => 'साथ में शामिल AWS SDK का उपयोग करके SES v2 API से भेजता है।',
+    'core.mail.provider.help.ses_api_iam'      => 'इंस्टेंस की IAM भूमिका उपयोग करने के लिए कुंजी और सीक्रेट खाली छोड़ें — तब कोई क्रेडेंशियल संग्रहीत नहीं होता।',
+    'core.mail.provider.help.sendgrid_smtp'    => 'उपयोगकर्ता नाम के रूप में शब्दशः "apikey" और पासवर्ड के रूप में अपनी API कुंजी उपयोग करें।',
+    'core.mail.provider.help.postmark_smtp'    => 'अपने Server API token को उपयोगकर्ता नाम और पासवर्ड दोनों के रूप में उपयोग करें।',
+    'core.mail.provider.help.resend_smtp'      => 'उपयोगकर्ता नाम के रूप में शब्दशः "resend" और पासवर्ड के रूप में अपनी API कुंजी उपयोग करें।',
+    'core.mail.provider.help.mailgun_region'   => 'Mailgun अलग-अलग US और EU क्षेत्र चलाता है, और कुंजी केवल उसी क्षेत्र में काम करती है जहाँ बनाई गई थी।',
+    'core.mail.provider.help.google_smtp'      => 'इसके लिए 2-स्टेप वेरिफिकेशन चालू होने के साथ ऐप पासवर्ड आवश्यक है — सामान्य खाता पासवर्ड काम नहीं करेगा।',
+    'core.mail.provider.help.microsoft_smtp'   => 'Microsoft डिफ़ॉल्ट रूप से SMTP AUTH बंद रखता है और बेसिक प्रमाणीकरण हटा रहा है; आपको इस मेलबॉक्स के लिए इसे सक्षम करना पड़ सकता है।',
+    'core.mail.provider.requires.aws_sdk'      => 'इस ड्राइवर के लिए AWS SDK मॉड्यूल (tiger-sdk-aws) चाहिए। इसे इंस्टॉल और सक्रिय करें, या Amazon SES (SMTP) उपयोग करें।',
+    'core.mail.provider.requires.generic'      => 'इस प्रदाता का ड्राइवर इस इंस्टॉल पर उपलब्ध नहीं है।',
 ];

core/languages/pt/core.php

@@ -193,4 +193,17 @@
     'core.media.field.clear'           => 'Remover',
     'core.media.field.preview_alt'     => 'Pré-visualização da mídia selecionada',
     'core.media.field.file'            => 'Arquivo selecionado',
+
+    // --- Mail providers (Tiger_Mail_Provider) ---
+    'core.mail.provider.help.ses_smtp'         => 'As credenciais SMTP do SES são geradas no console do SES — elas NÃO são suas chaves de acesso da AWS. Informe-as como usuário e senha abaixo.',
+    'core.mail.provider.help.ses_api'          => 'Envia pela API SES v2 usando o SDK da AWS incluído.',
+    'core.mail.provider.help.ses_api_iam'      => 'Deixe a chave e o segredo em branco para usar a role IAM da instância — assim nenhuma credencial é armazenada.',
+    'core.mail.provider.help.sendgrid_smtp'    => 'Use o usuário literal "apikey" e sua chave de API como senha.',
+    'core.mail.provider.help.postmark_smtp'    => 'Use seu Server API token TANTO como usuário quanto como senha.',
+    'core.mail.provider.help.resend_smtp'      => 'Use o usuário literal "resend" e sua chave de API como senha.',
+    'core.mail.provider.help.mailgun_region'   => 'O Mailgun opera regiões separadas nos EUA e na UE, e uma chave só funciona na região em que foi criada.',
+    'core.mail.provider.help.google_smtp'      => 'Requer uma Senha de app com a verificação em duas etapas ativada — a senha normal da conta não funciona.',
+    'core.mail.provider.help.microsoft_smtp'   => 'A Microsoft desativa o SMTP AUTH por padrão e está descontinuando a autenticação básica; pode ser necessário habilitá-la para esta caixa de correio.',
+    'core.mail.provider.requires.aws_sdk'      => 'Este driver precisa do módulo do SDK da AWS (tiger-sdk-aws). Instale e ative-o, ou use o Amazon SES (SMTP).',
+    'core.mail.provider.requires.generic'      => 'O driver deste provedor não está disponível nesta instalação.',
 ];