eventpayload

type AgentSuppressionAddedData struct {
	AgentEmail string `json:"agent_email"`
	Address    string `json:"address"`
	Source     string `json:"source" doc:"How the suppression was created. Known values: unsubscribe, manual."`
}

type AttachmentMetaView struct {
	Filename    string `json:"filename,omitempty"`
	ContentType string `json:"content_type,omitempty"`
	// SizeBytes is the DECODED attachment payload size — the byte count of the
	// file after the MIME Content-Transfer-Encoding (base64 / quoted-printable)
	// is undone: the size of the file a download yields. NOT the encoded
	// on-the-wire size inside the raw MIME, and NOT the message-level
	// size_bytes (which is the raw MIME length of the whole message).
	SizeBytes int `` /* 185-byte string literal not displayed */
	Index     int `json:"index" doc:"Stable 0-based attachment index (document order) — the fetch key for the attachment-bytes endpoint."`
	// ContentID is the attachment's Content-ID with angle brackets stripped
	// (e.g. "ii_abc@mail.gmail.com"), present only for parts that carry one —
	// typically inline images embedded by a mail client. It is the key an HTML
	// body's `cid:` reference resolves against: a renderer maps
	// `<img src="cid:ii_abc@mail.gmail.com">` to the attachment whose
	// content_id matches, then fetches the bytes via the attachment endpoint.
	// Omitted (empty) for ordinary, non-inline attachments.
	ContentID string `` /* 225-byte string literal not displayed */
}

type DomainSendingFailedData struct {
	Domain        string `json:"domain"`
	SendingStatus string `json:"sending_status" doc:"Terminal sending-identity status. Open set; tolerate unknown values. Known values: failed."`
	Reason        string `json:"reason,omitempty"`
}

type DomainSendingVerifiedData struct {
	Domain        string `json:"domain"`
	SendingStatus string `json:"sending_status" doc:"Terminal sending-identity status. Open set; tolerate unknown values. Known values: verified."`
}

type DomainSuppressionAddedData struct {
	Address string `json:"address"`
	// Source is an OPEN set (evolving response-side vocabulary, like the REST
	// Suppression.source it mirrors — and the DB CHECK in
	// migrations/031_delivery_feedback.sql already admits source='manual').
	Source string `` /* 185-byte string literal not displayed */
	Reason string `json:"reason,omitempty"`
	// MessageID is the outbound message whose feedback triggered the
	// suppression, when still known.
	MessageID string `json:"message_id,omitempty"`
}

type EmailBouncedData struct {
	MessageID   string `json:"message_id"`
	AgentEmail  string `json:"agent_email"`
	Direction   string `json:"direction" doc:"Always \"outbound\" on this event."`
	DeliveredTo string `json:"delivered_to" doc:"The one recipient address this per-recipient outcome is about."`
	Subject     string `json:"subject,omitempty"`
	SMTPDetail  string `json:"smtp_detail,omitempty"`
	// BounceType is the normalized SES bounce classification. Only a
	// permanent (hard) bounce auto-suppresses the address.
	//
	// Deliberately a CLOSED enum, unlike the evolving response vocabularies
	// (which are open sets): this is a normalized, exhaustive classification —
	// normalizeBounceType in internal/delivery/ses.go maps every provider
	// value into exactly these three, with `undetermined` as the guaranteed
	// catch-all — so the vocabulary cannot grow without a deliberate contract
	// change.
	BounceType string `json:"bounce_type" enum:"permanent,transient,undetermined"`
	// BounceSubType is the raw SES bounceSubType (e.g. General, NoEmail,
	// MailboxFull), when present.
	BounceSubType string `json:"bounce_sub_type,omitempty"`
}

type EmailComplainedData struct {
	MessageID   string `json:"message_id"`
	AgentEmail  string `json:"agent_email"`
	Direction   string `json:"direction" doc:"Always \"outbound\" on this event."`
	DeliveredTo string `json:"delivered_to" doc:"The one recipient address this per-recipient outcome is about."`
	Subject     string `json:"subject,omitempty"`
	SMTPDetail  string `json:"smtp_detail,omitempty"`
}

type EmailDeliveredData struct {
	MessageID  string `json:"message_id"`
	AgentEmail string `json:"agent_email"`
	Direction  string `json:"direction" doc:"Always \"outbound\" on this event."`
	// DeliveredTo is the ONE recipient address this per-recipient outcome is
	// about (scalar by construction).
	DeliveredTo string `json:"delivered_to" doc:"The one recipient address this per-recipient outcome is about."`
	Subject     string `json:"subject,omitempty"`
	// SMTPDetail is the provider diagnostic string (e.g. the remote SMTP
	// response), when the feedback notification carried one.
	SMTPDetail string `json:"smtp_detail,omitempty"`
}

type EmailFailedData struct {
	MessageID      string   `json:"message_id"`
	AgentEmail     string   `json:"agent_email"`
	Direction      string   `json:"direction" doc:"Always \"outbound\" on this event."`
	ConversationID string   `json:"conversation_id,omitempty"`
	Method         string   `json:"method" doc:"Transport used for the send. Open set; tolerate unknown values. Known values: smtp."`
	From           string   `json:"from"`
	To             []string `json:"to" nullable:"false"`
	CC             []string `json:"cc,omitempty" nullable:"false"`
	BCC            []string `json:"bcc,omitempty" nullable:"false"`
	Subject        string   `json:"subject"`
	MessageType    string   `json:"message_type" doc:"Send kind. Open set; tolerate unknown values. Known values: send, reply, forward."`
	// Reason is the human-readable terminal failure diagnostic (e.g. the SMTP
	// response of a permanent reject).
	Reason string `json:"reason"`
	// ReasonCode is an optional machine-readable failure code. Omitted when
	// the send path has no classification beyond Reason.
	ReasonCode string `json:"reason_code,omitempty"`
	// Retryable reports whether re-submitting the same send could succeed.
	// Populated only where the send path genuinely knows it; omitted
	// otherwise (absent ≠ false).
	Retryable *bool `json:"retryable,omitempty"`
}

type EmailReceivedData struct {
	MessageID  string `json:"message_id"`
	AgentEmail string `json:"agent_email" doc:"The receiving agent's email — its id and address (an agent's id IS its email)."`
	Direction  string `json:"direction" doc:"Always \"inbound\" on this event."`
	// ConversationID is empty for a thread-starting message.
	ConversationID string                    `json:"conversation_id,omitempty"`
	HeaderFrom     *string                   `json:"header_from" nullable:"true" doc:"Parsed RFC 5322 From address; never replaced by Reply-To."`
	EnvelopeFrom   *string                   `` /* 147-byte string literal not displayed */
	VerifiedDomain *string                   `` /* 471-byte string literal not displayed */
	To             []string                  `json:"to" nullable:"false"`
	CC             []string                  `json:"cc" nullable:"false"`
	ReplyTo        []string                  `json:"reply_to" nullable:"false"`
	Authentication *emailauth.Authentication `` /* 326-byte string literal not displayed */
	// DeliveredTo is the agent address this copy was delivered to — a SCALAR
	// by construction: the relay emits one event per per-agent delivery, so
	// unlike the peer To/CC lists (the message's parsed headers) this is
	// always exactly one address. It is the fetch key for the message.
	DeliveredTo string    `` /* 164-byte string literal not displayed */
	Subject     string    `json:"subject"`
	ReceivedAt  time.Time `json:"received_at" format:"date-time"`
	// Attachments is per-attachment METADATA (never bytes) parsed from the
	// raw message. Omitted when the message has none.
	Attachments []AttachmentMetaView `json:"attachments,omitempty" nullable:"false"`
}

type EmailSentData struct {
	MessageID      string `json:"message_id"`
	AgentEmail     string `json:"agent_email"`
	Direction      string `json:"direction" doc:"Always \"outbound\" on this event."`
	ConversationID string `json:"conversation_id,omitempty"`
	// ProviderMessageID is the provider-assigned (SES) message id — distinct
	// from the e2a message_id, and the correlation key for the async
	// delivered/bounced/complained feedback events. Omitted for providerless
	// local loopback delivery.
	ProviderMessageID string   `json:"provider_message_id,omitempty"`
	Method            string   `json:"method" doc:"Transport used for the send. Open set; tolerate unknown values. Known values: smtp, loopback."`
	From              string   `json:"from"`
	To                []string `json:"to" nullable:"false"`
	CC                []string `json:"cc,omitempty" nullable:"false"`
	BCC               []string `json:"bcc,omitempty" nullable:"false"`
	Subject           string   `json:"subject"`
	MessageType       string   `json:"message_type" doc:"Send kind. Open set; tolerate unknown values. Known values: send, reply, forward."`
}

type StableEvent struct {
	Type           string
	SchemaName     string
	Payload        any
	Fixture        string
	MinimalFixture string
}