mirror of
https://github.com/foxcpp/maddy.git
synced 2025-04-03 05:07:38 +03:00
58 lines
2.2 KiB
Go
58 lines
2.2 KiB
Go
/*
|
|
Maddy Mail Server - Composable all-in-one email server.
|
|
Copyright © 2019-2020 Max Mazurov <fox.cpp@disroot.org>, Maddy Mail Server contributors
|
|
|
|
This program is free software: you can redistribute it and/or modify
|
|
it under the terms of the GNU 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 General Public License for more details.
|
|
|
|
You should have received a copy of the GNU General Public License
|
|
along with this program. If not, see <https://www.gnu.org/licenses/>.
|
|
*/
|
|
|
|
package module
|
|
|
|
import (
|
|
"context"
|
|
|
|
"github.com/emersion/go-message/textproto"
|
|
"github.com/foxcpp/maddy/framework/buffer"
|
|
)
|
|
|
|
// StatusCollector is an object that is passed by message source
|
|
// that is interested in intermediate status reports about partial
|
|
// delivery failures.
|
|
type StatusCollector interface {
|
|
// SetStatus sets the error associated with the recipient.
|
|
//
|
|
// rcptTo should match exactly the value that was passed to the
|
|
// AddRcpt, i.e. if any translations was made by the target,
|
|
// they should not affect the rcptTo argument here.
|
|
//
|
|
// It should not be called multiple times for the same
|
|
// value of rcptTo. It also should not be called
|
|
// after BodyNonAtomic returns.
|
|
//
|
|
// SetStatus is goroutine-safe. Implementations
|
|
// provide necessary serialization.
|
|
SetStatus(rcptTo string, err error)
|
|
}
|
|
|
|
// PartialDelivery is an optional interface that may be implemented
|
|
// by the object returned by DeliveryTarget.Start. See PartialDelivery.BodyNonAtomic
|
|
// documentation for details.
|
|
type PartialDelivery interface {
|
|
// BodyNonAtomic is similar to Body method of the regular Delivery interface
|
|
// with the except that it allows target to reject the body only for some
|
|
// recipients by setting statuses using passed collector object.
|
|
//
|
|
// This interface is preferred by the LMTP endpoint and queue implementation
|
|
// to ensure correct handling of partial failures.
|
|
BodyNonAtomic(ctx context.Context, c StatusCollector, header textproto.Header, body buffer.Buffer)
|
|
}
|