Skip to content

v1.0.0 – Initial Release

Choose a tag to compare

@Maatify Maatify released this 12 Mar 00:11
· 13 commits to main since this release

Maatify Email Delivery v1.0.0

Initial public release of the Maatify Email Delivery library.

This package provides a framework-agnostic asynchronous email delivery pipeline for PHP applications.


✨ Features

  • Async transactional email queue
  • Twig-based email rendering
  • SMTP transport via PHPMailer
  • Background worker processing
  • Encrypted queue payloads using maatify/crypto
  • Retry mechanism with backoff strategies
  • Batch processing support
  • Scheduled email delivery
  • Framework-agnostic architecture

🧱 Architecture

The email pipeline is built around four core components:

  1. Queue Writer
    Encrypts and stores email jobs in the database queue.

  2. Renderer
    Renders Twig email templates with payload data.

  3. Worker
    Processes queued jobs, handles retries, and manages delivery lifecycle.

  4. SMTP Transport
    Sends emails using PHPMailer.


🔐 Security

Sensitive data stored in the queue is encrypted using the maatify/crypto library:

  • recipient email encryption
  • payload encryption
  • key rotation support

This ensures queue data remains protected even if the database is compromised.


🧪 Testing

The library includes a full PHPUnit test suite:

  • Unit tests for DTOs, renderer, and queue writer
  • Integration tests for the worker pipeline
  • Retry mechanism validation
  • Encryption round-trip validation
  • SQLite in-memory test database

23 tests, 132 assertions

All tests pass through the CI pipeline.


📚 Documentation

Full documentation is available in the repository:

  • Book documentation → docs/book
  • Guides → docs/how-to
  • Examples → docs/examples

📦 Installation

composer require maatify/email-delivery

🧩 Part of the Maatify Ecosystem

This package integrates with:

  • maatify/crypto

License

MIT License