feat: retrieve the message-id from the message sent

.envrc

@@ -0,0 +1 @@
+dotenv

.gitignore

@@ -48,3 +48,5 @@ worker*.log
 project/.gnupg/
 .bloop/
 .metals/
+.bsp/
+.env

build.sbt

@@ -105,4 +105,13 @@ lazy val courier = (project in file("courier"))
       "org.jvnet.mock-javamail" % "mock-javamail" % "1.9" % Test
     ),
     testFrameworks += new TestFramework("munit.Framework")
-  )
+  )
+lazy val it = (project in file("integration-tests"))
+  .settings(commonSettings ++ cFlags)
+  .settings(
+    name := "courier-integration-tests",
+    libraryDependencies ++= Seq(
+      "org.scalameta"     %% "munit"          % "0.7.27" % Test,
+    ),
+    testFrameworks += new TestFramework("munit.Framework")
+  ).dependsOn(courier)

courier/src/main/scala/mailer.scala

@@ -15,7 +15,7 @@ case class Mailer(_session: MailSession = Defaults.session,
                   mimeMessageFactory: MailSession => MimeMessage = Defaults.mimeMessageFactory) {
   def session = Session.Builder(this)
 
-  def apply(e: Envelope)(implicit ec: ExecutionContext): Future[Unit] = {
+  def apply(e: Envelope)(implicit ec: ExecutionContext): Future[Option[String]] = {
     val msg = mimeMessageFactory(_session)
 
     e.subject.foreach {
@@ -37,7 +37,9 @@ case class Mailer(_session: MailSession = Defaults.session,
     }
 
     Future {
-      Transport.send(msg)
+      // sending the email sets the message id
+      val _ = Transport.send(msg)
+      Option(msg.getMessageID())
     }
   }
 }

integration-tests/src/test/scala/mailspec.scala

@@ -0,0 +1,24 @@
+package courier
+
+import scala.concurrent.Await
+import scala.concurrent.ExecutionContext.Implicits.global
+import scala.concurrent.duration._
+
+
+class MailSpec extends munit.FunSuite {
+  // create a gmail app password https://myaccount.google.com/apppasswords
+  test("the mailer should send an email") {
+    assume(sys.env("CI").isEmpty(), "This test is meant to be ran locally.")
+    val email = sys.env("IT_EMAIL")
+    val password = sys.env("IT_PASSWORD")
+    val mailer = Mailer("smtp.gmail.com", 587)
+                .auth(true)
+                .as(email, password)
+                .startTls(true)()
+    val mId = Await.result(mailer(Envelope.from(email.addr)
+            .to(email.addr)
+            .subject("miss you")
+            .content(Text("hi mom"))), 10.seconds)
+    assert(mId.nonEmpty, "Message-ID should be set by the Transport.send call")
+  }
+}