<%!-- Status Card --%>

<.icon name="hero-cog-6-tooth" class="w-6 h-6" /> Status

Enable Emails

Track email delivery, opens, clicks, and other events

<%= if @email_enabled do %> <%!-- Sender Configuration Card --%>

<.icon name="hero-envelope" class="w-6 h-6" /> Sender Configuration

<%!-- From Email --%>

From Email Email address used as sender for all outgoing emails

<%!-- From Name --%>

From Name Sender name displayed to recipients

<%!-- Save Button --%>

<%!-- Options Card --%>

<.icon name="hero-adjustments-horizontal" class="w-6 h-6" /> Options

<%!-- Save Email Bodies --%>

Save Email Bodies

Store the full content of sent emails for debugging and analysis

<%!-- Save Email Headers --%>

Save Email Headers

Store email headers for debugging and analysis (increases storage usage)

<%!-- AWS SES Events --%>

AWS SES Events Options

Track delivery, bounce, and complaint events from Amazon SES

<%!-- Sampling Rate --%>

Emails Sampling Rate

Percentage of emails to fully track for analytics (0-100%)

<%!-- Data Retention Card --%>

<.icon name="hero-archive-box" class="w-6 h-6" /> Data Retention

Email Retention Period

days

How long to keep emails data before automatic cleanup (1-365 days)

<%= if @email_save_body do %> <%!-- Compress Body After Days --%>

Compress Email Bodies After Auto-saves when you click outside the input field

days

<.icon name="hero-information-circle" class="w-3 h-3" /> Compress old email bodies to save storage space (7-365 days). Changes are saved automatically.

<% end %> <%!-- S3 Archival Toggle --%>

Enable S3 Archival

Move old email data to AWS S3 for long-term cold storage

<%= if @email_archive_to_s3 do %> <%!-- S3 Archival Action Button --%>

Manually trigger S3 archival for emails older than retention period

<% end %>

<.icon name="hero-exclamation-triangle" class="w-5 h-5" />

Data Privacy Notice

Email data will be automatically deleted after the retention period expires. This helps maintain privacy compliance and reduces storage requirements.

<%!-- AWS Configuration Card --%>

<.icon name="hero-cog-6-tooth" class="w-6 h-6" /> AWS Configuration

<%!-- AWS Setup Guide (daisyUI collapse) --%>

<.icon name="hero-book-open" class="w-5 h-5" /> AWS Setup Guide

<%!-- Step 1: Create IAM User --%>

1. Create IAM User

Visit AWS IAM Console
Create new user with programmatic access
Attach policies: SES, SQS, SNS, STS:GetCallerIdentity
Save Access Key ID and Secret Access Key

<%!-- Step 2: Configure Credentials --%>

2. Configure Credentials

Enter Access Key ID (20 characters, e.g., AKIAIOSFODNN7EXAMPLE)
Enter Secret Access Key
Enter AWS Region manually (e.g., eu-north-1)
Click "Verify Credentials" to test connectivity
Optional: Click "Load regions" to see all available regions

<%!-- Step 3: Setup Infrastructure --%>

3. Setup Infrastructure

Click "Setup AWS Infrastructure" to create SNS/SQS resources
Wait for setup completion (typically 30-60 seconds)
All created resources will be automatically filled in the form below
Click "Save AWS Settings" one more time to persist everything

<%!-- Step 4: Verify Email --%>

4. Verify Email/Domain in SES

Go to AWS SES Console
Verify your sender email address or domain
Request production access (if needed to exit sandbox mode)

<%!-- Required Permissions --%>

<.icon name="hero-information-circle" class="h-4 w-4 text-info shrink-0 mt-0.5" />

Required IAM Permissions:

sqs:* - Simple Queue Service
sns:* - Simple Notification Service
ses:* - Simple Email Service
sts:GetCallerIdentity - Credential verification

<%!-- Full Documentation Link --%>

<.icon name="hero-book-open" class="h-4 w-4 text-success shrink-0 mt-0.5" />

Need more help?

See guides/aws_email_setup.md for comprehensive documentation including security best practices, cost optimization, and troubleshooting.

<%!-- Credentials Verification Section --%> <.aws_credentials_verify access_key_id={@aws_settings.access_key_id} secret_access_key={@aws_settings.secret_access_key} region={@aws_settings.region} verifying={@verifying_credentials} verified={@credential_verification_status} message={@credential_verification_message} permissions={@aws_permissions} phx_click="verify_aws_credentials" disabled={@saving or @setting_up_aws} />

<%!-- AWS Access Key ID --%>

AWS Access Key ID Example: AKIAIOSFODNN7EXAMPLE (20 characters)

<%!-- AWS Secret Access Key --%>

AWS Secret Access Key Example: wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY

<%!-- AWS Region --%>

<.aws_region_select id="aws-region-select" name="aws_settings[region]" value={@aws_settings.region} regions={@available_regions} regions_loaded={@regions_loaded} selected_region={@selected_region} verifying={@verifying_credentials} verified={@credential_verification_status} phx_change="select_region" class="flex-1" /> <%!-- Button to load/refresh regions --%>

<%!-- Helper text is now in the component itself --%>

<%= if @email_ses_events do %> <%!-- Advanced AWS Settings (collapse) --%>

<.icon name="hero-cog-6-tooth" class="w-5 h-5" /> Advanced AWS Settings

These settings are automatically configured when you run "Setup AWS Infrastructure". Manual changes may break the integration.

<%!-- SES Configuration Set --%>

SES Configuration Set SES configuration set name

<%!-- SNS Topic ARN --%>

SNS Topic ARN SNS topic for email events

<%!-- SQS Queue URL --%>

SQS Queue URL Main queue for email events

<%!-- SQS Queue ARN --%>

SQS Queue ARN SQS queue ARN for permissions

<%!-- SQS DLQ URL --%>

SQS Dead Letter Queue URL Dead letter queue for failed messages

<%!-- SQS Worker Settings (collapse) --%>

<.icon name="hero-cog-6-tooth" class="w-5 h-5" /> SQS Worker Settings

<%!-- Enable SQS Polling --%>

Enable SQS Polling

Automatically poll SQS queue for email events in background

<%!-- SQS Polling Interval --%>

SQS Polling Interval

How often to check for SQS messages (1-60 seconds)

<%= if @sqs_polling_enabled do %> <%!-- SQS Max Messages Per Poll --%>

Max Messages Per Poll

messages

Maximum number of messages to process in each polling cycle (1-10)

<%!-- SQS Visibility Timeout --%>

Visibility Timeout

seconds

How long messages remain invisible after being received (30-43200 seconds)

<% end %> <%!-- Performance Optimization Tips --%>

<.icon name="hero-light-bulb" class="w-4 h-4" /> Performance Tips

• Use longer polling intervals (5-10 seconds) to reduce API calls
• Set visibility timeout to match processing time
• Monitor queue depth and adjust max messages accordingly
• Enable compression to reduce storage requirements

<% end %> <%!-- Warning for credentials changes --%> <%= if String.trim(@aws_settings.access_key_id) != "" or String.trim(@aws_settings.secret_access_key) != "" do %>

<.icon name="hero-exclamation-triangle" class="w-5 h-5" />

Configuration Changes Detected

You've modified your AWS credentials. Click "Save AWS Settings" first, then use "Setup AWS Infrastructure" to create the required resources.

<% end %> <%!-- Action Buttons --%>

<%!-- Current Configuration Summary --%>

<.icon name="hero-information-circle" class="w-5 h-5" />

Current Configuration

Status: Enabled

Save email bodies: {if @email_save_body, do: "Yes", else: "No"}

AWS SES events: {if @email_ses_events, do: "Yes", else: "No"}

Retention period: {@email_retention_days} days

Sampling rate: {@email_sampling_rate}%

SQS polling: {if @sqs_polling_enabled, do: "Enabled", else: "Disabled"}

<% else %> <%!-- Disabled State Information --%>

<.icon name="hero-exclamation-triangle" class="w-5 h-5" />

Emails Disabled

Enable the emails above to access configuration options and start managing email delivery events.

<%!-- Benefits Card when Disabled --%>

<.icon name="hero-light-bulb" class="w-6 h-6" /> Emails Benefits

<.icon name="hero-check-circle" class="w-5 h-5 text-success mt-0.5" />

Delivery Monitoring

Track successful email deliveries and identify issues

<.icon name="hero-check-circle" class="w-5 h-5 text-success mt-0.5" />

Engagement Analytics

Monitor email opens, clicks, and user engagement

<.icon name="hero-check-circle" class="w-5 h-5 text-success mt-0.5" />

Debugging Support

Store email content for troubleshooting delivery issues

<.icon name="hero-check-circle" class="w-5 h-5 text-success mt-0.5" />

AWS SES Integration

Automatic webhook handling for bounce and complaint events

<% end %>