missive 0.6.2

# Changelog

All notable changes to this project will be documented in this file.

The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

## [0.6.2] - 2026-01-19

### Deprecated

- **`MailerExt::validate()`** - This method does not handle the `EMAIL_FROM` environment variable fallback, incorrectly rejecting valid emails. Use `Email::is_valid()` for a quick check or rely on `deliver()`/`deliver_with()` validation. Will be removed in 0.7.0. ([#1](https://github.com/jeffhuen/missive/issues/1))

## [0.6.1] - 2026-01-17

### Fixed

- Fixed clippy lint errors in JMAP provider (never_loop, unwrap_or_default, useless_conversion)
- Fixed formatting issues in JMAP provider and test module ordering

## [0.6.0] - 2026-01-17

### Added

- **JMAP** - JMAP (JSON Meta Application Protocol) provider (`jmap` feature)
  - Minimal spec-compliant implementation using reqwest+serde (no external JMAP crate)
  - Works with any JMAP server: Stalwart, Fastmail, Cyrus, etc.
  - Basic auth and Bearer token (OAuth2) authentication
  - Full submission flow: session discovery, identity/mailbox lookup, Email/set, EmailSubmission/set
  - Emails placed in drafts mailbox per RFC 8621, auto-deleted after successful submission
  - See `docs/jmap-testing.md` for local testing with Docker

- **Proton Bridge** - Proton Mail via local bridge (`protonbridge` feature)
  - Thin wrapper around SMTP for Proton Bridge integration
  - Pre-configured for localhost:1025, PLAIN auth, no TLS
  - Requires [Proton Mail Bridge](https://proton.me/mail/bridge) running locally

### Documentation

- Added JMAP testing guide with Docker-based Stalwart setup (`docs/jmap-testing.md`)

## [0.5.0] - 2026-01-13

### Added

- **Gmail** - Gmail API provider (`gmail` feature)
  - OAuth2 Bearer token authentication
  - RFC 2822 message format via lettre (media upload with `uploadType=media`)
  - Full support for HTML, text, attachments, CC, BCC, reply-to
  - Response includes `threadId` and `labelIds` from Gmail

- **SocketLabs** - SocketLabs Injection API provider (`socketlabs` feature)
  - Bearer token authentication (v1 API keys have been decommissioned by SocketLabs)
  - Support for AMP emails via `amp_body` provider option
  - Merge data support for personalization
  - Custom headers, message tracking IDs, and template support

### Documentation

- Added HTTP client architecture documentation explaining reqwest choice

## [0.4.0] - 2026-01-09

### Added

- **Standalone preview server** via `tiny_http` (`preview` feature)
  - `PreviewServer::new(addr, storage)` to create a server
  - `.spawn()` for fire-and-forget background execution
  - `.run()` for blocking mode
  - `serve(addr, storage)` convenience function
  - No framework dependencies - works with any Rust application
  - See `docs/preview.md` for usage guide

### Changed

- `preview` feature now uses standalone `tiny_http` server (was alias to `preview-axum`)
- `preview-axum` and `preview-actix` remain for framework embedding
- `dev` feature bundle now uses standalone preview

## [0.3.0] - 2026-01-08

### Added

- **Interceptors** for modifying or blocking emails before delivery
  - `Interceptor` trait for custom email transformations
  - `InterceptorExt` extension trait with `.with_interceptor()` method
  - Closure support: `mailer.with_interceptor(|email| Ok(email.header("X-Foo", "bar")))`
  - Chainable: multiple interceptors can be stacked
  - Works with `deliver()` and `deliver_many()`
  - See `docs/interceptors.md` for usage guide

## [0.2.0] - 2026-01-07

### Added

- **Actix-web support** for mailbox preview UI (`preview-actix` feature)
  - `actix_configure()` function to mount routes on an Actix scope
  - `ActixAppState` for shared state management
- New feature flags:
  - `preview-axum` - Axum-specific preview (extracted from `preview`)
  - `preview-actix` - Actix-web preview support
- `preview` feature now defaults to `preview-axum` for backwards compatibility

### Changed

- Refactored preview module into shared core logic with thin framework adapters
- Internal reorganization: `preview/core.rs`, `preview/axum_routes.rs`, `preview/actix_routes.rs`

## [0.1.0] - 2025-01-07

Initial release.

### Added

#### Email Providers
- **SMTP** - Traditional SMTP delivery via lettre (`smtp` feature)
- **Resend** - Resend API integration (`resend` feature)
- **SendGrid** - SendGrid API integration (`sendgrid` feature)
- **Postmark** - Postmark API integration (`postmark` feature)
- **Unsent** - Unsent API integration (`unsent` feature)
- **LocalMailer** - In-memory storage for development and testing (`local` feature)
- **LoggerMailer** - Console logging without storage (always available)

#### Email Composition
- Fluent builder API for composing emails
- Support for HTML and plain text bodies
- Multiple recipients (to, cc, bcc)
- Reply-to addresses
- Custom headers
- Provider-specific options via `.provider_option()`

#### Attachments
- `Attachment::from_bytes()` - Create from in-memory data
- `Attachment::from_path()` - Eager file loading
- `Attachment::from_path_lazy()` - Lazy file loading at send time
- Inline attachments with Content-ID for HTML embedding
- Automatic MIME type detection

#### Email Validation
- `Address::parse()` - RFC 5321/5322 compliant validation
- `Address::parse_with_name()` - Validated name + email pairs
- `Address::to_ascii()` - IDN/Punycode encoding for international domains
- `ToAddress` trait for custom recipient types

#### Testing Support
- `LocalMailer` with in-memory storage for test assertions
- Assertion helpers: `assert_email_sent`, `assert_email_to`, `assert_email_subject`, etc.
- Regex assertions: `assert_email_subject_matches`, `assert_email_html_matches`
- Failure simulation with `set_failure()` / `clear_failure()`
- `flush_emails()` for atomic get-and-clear in multi-phase tests

#### Development Tools
- Mailbox preview web UI (`preview` feature)
- HTML and plain text email preview
- Attachment downloads
- JSON API for programmatic access
- CSP nonce support

#### Observability
- Tracing spans for all email deliveries
- Prometheus-style metrics (`metrics` feature)
  - `missive_emails_total` counter
  - `missive_delivery_duration_seconds` histogram
  - `missive_batch_total` counter
  - `missive_batch_size` histogram

#### Templates
- Askama template integration (`templates` feature)
- `EmailTemplate` trait for type-safe templates
- `.render_html()` and `.render_text()` methods

#### Configuration
- Zero-config setup via environment variables
- Auto-detection of provider from available API keys
- `EMAIL_PROVIDER` for explicit provider selection
- `EMAIL_FROM` / `EMAIL_FROM_NAME` for default sender
- `init()` for environment-based initialization
- `configure()` for programmatic setup

#### Infrastructure
- Batch sending with `deliver_many()`
- Batch validation via `Mailer::validate_batch()`
- User-Agent headers with version on all API requests
- Detailed error types for different failure modes