waaseyaa/mail

Transport-agnostic mail API for Waaseyaa

Maintainers

Package info

github.com/waaseyaa/mail

pkg:composer/waaseyaa/mail

Transparency log

Statistics

Installs: 5 619

Dependents: 5

Suggesters: 0

Stars: 0

Open Issues: 0

Security

Advisories: 0

Aikido package health analysis

v0.1.0-alpha.256 2026-07-06 21:24 UTC

Requires

Requires (Dev)

Suggests

  • sendgrid/sendgrid: Required for SendGrid API transport when using mail.sendgrid_api_key (^8.1)
  • twig/twig: Required for TwigMailRenderer template support

GPL-2.0-or-later de6c6fcb4c48cbf54d77c459e7fcceb7a0db801d

Published on Packagist.org on 2026-07-06 21:32 UTC

This package is auto-updated.

Last update: 2026-07-06 21:32:25 UTC

README

Layer 0 — Foundation

Email delivery abstraction for Waaseyaa applications.

Provides a MailerInterface and Twig-powered TwigMailRenderer for template-based emails.

Key classes: MailerInterface, Envelope, TwigMailRenderer, TransportInterface (local, array, SendGrid).

Error handling

Non-critical mail (e.g. notification side effects, activity digests): wrap the MailerInterface::send() call in a try-catch and log the failure via LoggerInterface to avoid crashing the primary request. These are best-effort deliveries where a failure is recoverable.

Auth-critical mail (password resets, email-address verification, security alerts): let the exception propagate. Swallowing a send failure here would silently leave the user unable to regain access or verify their account. Catch only to add context or translate the exception, then re-throw.