Self-hosted email delivery platform that enables applications to send emails via HTTP APIs while handling SMTP delivery, templates, storage, security, and analytics. Fully self-hostable alternative to services like SendGrid or Mailgun.
Go email-relayemail-routinghttp-to-smtpmail-deliverymailchimp-alternativemailgun-alternativemailsendermailservermailtemplatemailtestpostmark-alternativesend-emailsendgrid-alternativesendmailtransactional-emailtransactional-outbox
// Copyright (c) 2026 Jonas Kaninda.
//
// This file is part of Posta.
//
// This program is free software: you can redistribute it and/or modify
// it under the terms of the GNU Affero General Public License as published by
// the Free Software Foundation, either version 3 of the License, or
// (at your option) any later version.
//
// This program is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
// GNU Affero General Public License for more details.
//
// You should have received a copy of the GNU Affero General Public License
// along with this program. If not, see <https://www.gnu.org/licenses/>.
//
// SPDX-License-Identifier: AGPL-3.0-or-later
package session
import (
"net/http"
"net/http/httptest"
"testing"
"time"
"github.com/jkaninda/okapi"
)
// A JWT written by SetCookie must come back byte-identical from Cookie(),
// otherwise okapi's cookie TokenLookup hands a corrupted token to the parser.
func TestSetCookie_RoundTripsJWT(t *testing.T) {
const jwt = "eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOjEsImp0aSI6ImEtYl9jIn0.7Hy-_signature"
o := okapi.NewTestServer(t)
o.Get("/login", func(c *okapi.Context) error {
SetCookie(c, jwt, time.Hour)
return c.String(http.StatusOK, "ok")
})
o.Get("/echo", func(c *okapi.Context) error {
v, err := c.Cookie(CookieName)
if err != nil {
return c.String(http.StatusUnauthorized, "missing")
}
return c.String(http.StatusOK, v)
})
rec := httptest.NewRecorder()
o.ServeHTTP(rec, httptest.NewRequest(http.MethodGet, "/login", nil))
cookies := rec.Result().Cookies()
if len(cookies) != 1 {
t.Fatalf("got %d cookies, want 1", len(cookies))
}
ck := cookies[0]
if ck.Name != CookieName {
t.Errorf("name = %q, want %q", ck.Name, CookieName)
}
if !ck.HttpOnly {
t.Error("cookie must be HttpOnly so XSS cannot read the session")
}
if ck.SameSite != http.SameSiteStrictMode {
t.Errorf("SameSite = %v, want Strict", ck.SameSite)
}
if ck.Path != "/" {
t.Errorf("path = %q, want /", ck.Path)
}
if ck.Secure {
t.Error("plain-HTTP request must not get a Secure cookie, the browser would drop it")
}
echo := httptest.NewRequest(http.MethodGet, "/echo", nil)
echo.AddCookie(ck)
rec2 := httptest.NewRecorder()
o.ServeHTTP(rec2, echo)
if got := rec2.Body.String(); got != jwt {
t.Errorf("round-tripped token = %q, want %q", got, jwt)
}
}
func TestSetCookie_SecureBehindTLSTerminatingProxy(t *testing.T) {
o := okapi.NewTestServer(t)
o.Get("/login", func(c *okapi.Context) error {
SetCookie(c, "tok", time.Hour)
return c.String(http.StatusOK, "ok")
})
req := httptest.NewRequest(http.MethodGet, "/login", nil)
req.Header.Set("X-Forwarded-Proto", "https")
rec := httptest.NewRecorder()
o.ServeHTTP(rec, req)
if ck := rec.Result().Cookies()[0]; !ck.Secure {
t.Error("cookie must be Secure when the edge terminated TLS")
}
}
// ClearCookie must expire the cookie; its other attributes have to match
// SetCookie's or the browser keeps the original.
func TestClearCookie_Expires(t *testing.T) {
o := okapi.NewTestServer(t)
o.Get("/logout", func(c *okapi.Context) error {
ClearCookie(c)
return c.String(http.StatusOK, "ok")
})
rec := httptest.NewRecorder()
o.ServeHTTP(rec, httptest.NewRequest(http.MethodGet, "/logout", nil))
ck := rec.Result().Cookies()[0]
if ck.Name != CookieName || ck.Value != "" {
t.Errorf("cookie = %s=%q, want %s empty", ck.Name, ck.Value, CookieName)
}
if ck.MaxAge >= 0 {
t.Errorf("MaxAge = %d, want negative", ck.MaxAge)
}
if ck.Path != "/" || !ck.HttpOnly || ck.SameSite != http.SameSiteStrictMode {
t.Error("clearing cookie attributes must match the ones SetCookie wrote")
}
}