Struct Email 

pub struct Email {
    pub id: String,
    pub domains: Vec<String>,
    pub inbound: Option<EmailInbound>,
    pub events: Option<EmailEvents>,
}

Email infrastructure for sending and receiving mail on customer-owned domains. On AWS this is backed by SES: a shared configuration set, optional inbound/event wiring, and one email identity (Easy DKIM) per seed domain.

Infrastructure vs runtime data

This resource owns the email infrastructure and the capability to use it, not the domain lifecycle. Deployment manages the configuration set, the event topology, the inbound receipt topology, and any seed identities listed in domains. Email identities created at runtime through the email/manage-identities grant are application data: they are not tracked by the deployment, are not removed when the stack is deleted, and their lifecycle — including deletion — belongs to the application.

The operator (or the application, for runtime-created identities) owns DNS: the per-domain DKIM CNAME records surfaced in EmailOutputs must be created before SES verifies a domain and allows sending from it.

Inbound mail (AWS)

When inbound is set, a SES receipt rule set is provisioned that writes raw incoming mail into the linked Storage bucket. The receipt rule is a catch-all (no recipient filter), so mail for identities verified at runtime lands in the bucket without any infrastructure change.

Alien activates the provisioned receipt rule set as part of setup. Because SES permits only one active receipt rule set per AWS account and region, an AWS stack may contain only one email resource with inbound delivery, and installing it makes its rule set the account’s active rule set. SES email receiving is available only in a subset of AWS regions; deploying inbound to an unsupported region fails during setup.

Update semantics

domains is append-friendly: adding a domain provisions a new identity, removing a domain deletes its identity (and its DKIM verification state). The list may be empty. inbound and events may be added, removed, or repointed; removing them tears down the corresponding receipt rule set / event destination wiring.

Fields

id: String

Identifier for the email resource. Must contain only alphanumeric characters, hyphens, and underscores ([A-Za-z0-9-_]). Maximum 64 characters.

domains: Vec<String>

Seed mail domains provisioned at deploy time (one SES identity each). Useful for day-0 bootstrap and products with a static domain set. May be empty (the default): products that create and verify domains dynamically should manage identities at runtime through the email/manage-identities grant instead of listing them here.

inbound: Option<EmailInbound>

Optional inbound-mail configuration: raw incoming mail (for any identity the account receives mail for — the receipt rule is a catch-all) is written to the linked Storage bucket.

events: Option<EmailEvents>

Optional sending-event configuration: send / delivery / bounce / complaint / delivery-delay / reject events are delivered to the linked Queue.

Implementations

impl Email

pub fn new(id: String) -> EmailBuilder

Create an instance of Email using the builder syntax

impl Email

pub const RESOURCE_TYPE: ResourceType

The resource type identifier for Email.

pub fn id(&self) -> &str

Returns the email resource’s unique identifier.

Trait Implementations

impl Clone for Email

fn clone(&self) -> Email

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Email

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Email

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for Email

impl PartialEq for Email

fn eq(&self, other: &Email) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl ResourceDefinition for Email

fn get_resource_type(&self) -> ResourceType

Returns the resource type for this instance

fn id(&self) -> &str

Returns the unique identifier for this specific resource instance

fn get_dependencies(&self) -> Vec<ResourceRef>

Returns the list of other resources this resource depends on

fn validate_update(&self, new_config: &dyn ResourceDefinition) -> Result<()>

Validates if an update from the current configuration to a new configuration is allowed

fn as_any(&self) -> &dyn Any

Provides access to the underlying concrete type for downcasting

fn as_any_mut(&mut self) -> &mut dyn Any

Provides mutable access to the underlying concrete type for downcasting

fn box_clone(&self) -> Box<dyn ResourceDefinition>

Creates a boxed clone of this resource definition

fn resource_eq(&self, other: &dyn ResourceDefinition) -> bool

For equality comparison between resource definitions

fn to_json_value(&self) -> Result<Value>

Serialize this resource to a JSON value (without the “type” tag - that’s added by Resource)

fn get_permissions(&self) -> Option<&str>

Returns the permission profile name for this resource, if it has one.

impl Serialize for Email

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Email