Skip to content

v0.3.1: Email Archiving with AWS SES Mail Manager

Choose a tag to compare

View all tags
@stewartjarod stewartjarod released this 16 Nov 00:32
· 2845 commits to main since this release
Immutable release. Only release title and notes can be modified.
v0.3.1
b22e152
This commit was signed with the committer’s verified signature.
Verified
Learn about vigilant mode.

🎉 What's New

Email Archiving

Store complete email copies for compliance, debugging, and customer support with AWS SES Mail Manager integration.

Key Features:

  • 📧 Full Email Storage: Store complete RFC 822/MIME emails including headers, HTML, text, and attachments
  • ⏱️ Flexible Retention: Choose from 7 days to 18 months retention periods
  • 👁️ Dashboard Viewer: View archived emails directly in the Wraps dashboard
  • 🔒 Automatic Security: HTML sanitization prevents XSS attacks
  • 💰 Cost Transparency: Clear pricing estimates for each retention period (~$5-10/mo for 10k emails/mo at 90 days)

Configuration

Enable email archiving during wraps init or upgrade existing deployments with wraps upgrade:

wraps init
# Select "Custom" configuration
# Enable "Email archiving" when prompted
# Choose your retention period (7 days, 30 days, 90 days, 6 months, 1 year, or 18 months)

Retention Options

Retention Period Estimated Cost* Use Case
7 days ~$1-2/mo Short-term debugging
30 days ~$2-4/mo Standard retention
90 days ~$5-10/mo Recommended - Compliance
6 months ~$15-25/mo Extended compliance
1 year ~$30-50/mo Long-term archival
18 months ~$45-75/mo Maximum retention

*For 10,000 emails/month

Dashboard Integration

View archived emails with:

  • Full email headers
  • HTML and plain text versions
  • SMTP metadata (sender IP, TLS info)
  • Timestamp and message ID
  • Security-sanitized HTML rendering

🧪 Testing

This release includes comprehensive test coverage:

  • ✅ 71 new tests for email archiving
  • ✅ 560 total tests passing
  • ✅ Security tests for XSS prevention
  • ✅ Cost calculation tests for all retention periods
  • ✅ Service integration tests
  • ✅ Fixed all pre-existing test failures

📦 Installation

npm install -g @wraps.dev/cli@0.3.1

Or upgrade existing installation:

npm update -g @wraps.dev/cli

🔧 Technical Details

Infrastructure:

  • AWS SES Mail Manager for email archiving
  • Automatic lifecycle management based on retention
  • S3-compatible storage with encryption at rest
  • Archive retrieval API with authentication

Security:

  • HTML sanitization removes script tags, iframes, and event handlers
  • JavaScript protocol URL removal
  • Safe rendering of email content
  • No execution of malicious code

📚 Documentation

🐛 Bug Fixes

  • Fixed DynamoDB field type in event processor tests
  • Added missing DNS resolver mock in verify tests
  • Fixed Pulumi automation module mocking
  • Excluded dist directory from test execution

📝 Commits

This release includes the complete email archiving feature:

  1. feat(cli): implement email archiving with AWS SES Mail Manager (0c76790)

    • Mail Manager infrastructure deployment
    • Archive retrieval service and API
    • Dashboard viewer component
    • Cost calculations and configuration prompts
    • IAM permissions and event routing

  2. chore(cli): bump version to 0.3.0 (43863fd)

    • Initial version bump for feature release

  3. test(cli): add comprehensive test coverage for email archiving (0e1526f)

    • 71 new tests across 5 test files
    • Security tests (XSS prevention)
    • Cost calculation tests (all retention periods)
    • Service integration tests
    • Fixed all pre-existing test failures

  4. chore(cli): bump version to 0.3.1 (b22e152)

    • Final version bump after release process

🙏 Credits

Built with ❤️ by the Wraps team

Full Changelog: v0.1.1...v0.3.1

Assets 3
Loading