# `Mailglass.Adapters.Swoosh`
[🔗](https://github.com/szTheory/mailglass/blob/v1.0.0/lib/mailglass/adapters/swoosh.ex#L1)

Adapter bridging to any `Swoosh.Adapter` (TRANS-03).

Adopters configure their Swoosh adapter once and mailglass wraps it —
they keep existing Postmark/SendGrid/Mailgun/SES/Resend/SMTP config.
mailglass adds error normalization into `%Mailglass.SendError{}` and
telemetry instrumentation via `Mailglass.Telemetry.dispatch_span/2`.

Pure: no DB, no PubSub, no `Process.put`. Caller's process owns the
HTTP request via Swoosh's `:api_client` (adopter-supplied, typically
Finch). LIB-06 satisfied.

## Configuration

    config :mailglass,
      adapter: {Mailglass.Adapters.Swoosh,
                swoosh_adapter: {Swoosh.Adapters.Postmark,
                                 api_key: System.fetch_env!("POSTMARK_API_KEY")}}

The `:swoosh_adapter` opt carries either a module (for Swoosh adapters
with no config) or a `{module, opts}` tuple.

## Error mapping (v0.1)

| Swoosh shape | Mapped SendError `:type` | Context fields |
|--------------|--------------------------|----------------|
| `{:api_error, status, body}` | `:adapter_failure` | `provider_status`, `body_preview` (200 bytes), `provider_module` |
| Other `{:error, reason}` atoms | `:adapter_failure` | `reason_class`, `provider_module` |
| Malformed responses | `:adapter_failure` | `reason_class: :malformed` |

**PII policy:** `body_preview` is a 200-byte head of the provider's
response body — may contain provider-emitted error strings (never
user-supplied content). The 8 forbidden keys
(`:to, :from, :body, :html_body, :subject, :headers, :recipient, :email`)
NEVER appear in error context. Phase 6 `LINT-02 NoPiiInTelemetryMeta`
enforces.

## What this module does NOT do

- Does not call `Swoosh.Mailer.deliver/1` — forbidden by LINT-01.
  Calls `Swoosh.Adapter.deliver/2` (the behaviour callback) directly.
- Is not a GenServer — pure function, stateless.
- Does not touch `mailglass_events`, `mailglass_deliveries`, or
  `Phoenix.PubSub`. Side-effect-free by design (LIB-06).

---

*Consult [api-reference.md](api-reference.md) for complete listing*