// Copyright (c) 2026 Probo Inc . // // Permission is hereby granted, free of charge, to any person obtaining a copy // of this software and associated documentation files (the "Software"), to deal // in the Software without restriction, including without limitation the rights // to use, copy, modify, merge, publish, distribute, sublicense, and/or sell // copies of the Software, and to permit persons to whom the Software is // furnished to do so, subject to the following conditions: // // The above copyright notice and this permission notice shall be included in // all copies or substantial portions of the Software. // // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR // IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, // FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE // AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER // LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, // OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE // SOFTWARE. package mailman import ( "fmt" "time" "go.probo.inc/probo/pkg/gid" "go.probo.inc/probo/pkg/mail" "go.probo.inc/probo/pkg/statelesstoken" ) const ( TokenTypeUnsubscribe = "mailing_list_unsubscribe" TokenTypeConfirm = "mailing_list_confirm_subscription" unsubscribeTokenExpiry = 365 * 24 * time.Hour confirmTokenExpiry = 15 * 24 * time.Hour ) type UnsubscribeTokenData struct { MailingListID gid.GID `json:"m"` Email mail.Addr `json:"e"` } func newUnsubscribeToken(secret string, mailingListID gid.GID, recipientEmail mail.Addr) (string, error) { return statelesstoken.NewToken( secret, TokenTypeUnsubscribe, unsubscribeTokenExpiry, UnsubscribeTokenData{ MailingListID: mailingListID, Email: recipientEmail, }, ) } func ValidateUnsubscribeToken(secret, tokenString string) (*UnsubscribeTokenData, error) { payload, err := statelesstoken.ValidateToken[UnsubscribeTokenData](secret, TokenTypeUnsubscribe, tokenString) if err != nil { return nil, fmt.Errorf("cannot validate unsubscribe token: %w", err) } return &payload.Data, nil } type ConfirmTokenData struct { MailingListID gid.GID `json:"m"` Email mail.Addr `json:"e"` } func newConfirmToken(secret string, mailingListID gid.GID, recipientEmail mail.Addr) (string, error) { return statelesstoken.NewToken( secret, TokenTypeConfirm, confirmTokenExpiry, ConfirmTokenData{ MailingListID: mailingListID, Email: recipientEmail, }, ) } // ValidateConfirmToken validates a subscription confirmation token and returns // the embedded payload. Exported so the HTTP handler can use it. func ValidateConfirmToken(secret, tokenString string) (*ConfirmTokenData, error) { payload, err := statelesstoken.ValidateToken[ConfirmTokenData](secret, TokenTypeConfirm, tokenString) if err != nil { return nil, fmt.Errorf("cannot validate confirm token: %w", err) } return &payload.Data, nil }