Changelog

0.1.7 - 2026-06-23

Live-update the Emails admin list on delivery-status changes via PubSub. Log.update_log/2 broadcasts a lightweight {:email_log_updated, …} event only when a log's status actually changes; the emails LiveView refreshes just the affected on-screen row (no 30-day stats recompute). Best-effort — a PubSub failure can never break the DB write. (#11)

Consolidate SQS polling onto a single Oban-based poller: remove the legacy 842-line SQSWorker GenServer. SQSPollingJob + SQSPollingManager are now the sole poller and runtime control surface (enable/disable without an app restart). (#11)
Self-scheduling no longer stalls: the polling job's unique constraint excludes running jobs, so an executing job can enqueue its successor and a crash-orphaned job can't permanently block new inserts. (#11)
SQS messages no longer re-cycle forever: delete_message/3 returns failures instead of swallowing them as :ok, reads both string and atom receipt-handle keys, and won't count an undeleted message as processed. (#11)
The admin SQS-polling toggle now starts/stops the poller at runtime (routed through SQSPollingManager) instead of only persisting the flag and waiting for the next boot. (#11)
Provider detection classifies a message as aws_ses when an SES configuration set is configured, even when the host app sends through its own Swoosh mailer. (#11)
Post-merge review fixes: compile clean under --warnings-as-errors with Oban 2.23 (narrow the polling job's unique states to [:scheduled]), satisfy credo --strict for the new broadcast helper, and drop a stale retired earmark entry from the lockfile.

Refresh dependency lockfile (notable bumps: oban → 2.23, phoenix_kit → 1.7.164, phoenix_live_view → 1.2, swoosh → 1.26, tesla → 1.20, bandit → 1.12, req).

Route all 9 Emails admin LiveViews through the per-module PhoenixKit.Modules.Emails.Gettext backend, so this package's ru/et catalogues resolve at render time instead of falling back to English. Extends gettext coverage across the full template surface (IAM/SES setup walkthrough, template editor, blocklist, metrics, queue); default.pot grows to 447 msgids. (#9)
Localise ~100 put_flash messages across the Emails LiveViews (settings toggles, errors, confirmations) with %{var} interpolation bindings and en/ru/et translations. (#10)

Correct gettext catalogue mis-fills from the bulk regeneration: 12 en entries where msgstr ≠ msgid, and 7 ru/et cross-locale mistranslations (e.g. the "Setup AWS Infrastructure" button rendering a stray "3." step prefix; Archive/Clone template tooltips reading "New Template"; Queued status showing "Queue").

Require phoenix_kit ~> 1.7.106 (per-module Gettext backend API).
Refresh dependency lockfile (notable bumps: phoenix_kit 1.7.108→1.7.120, ecto/ecto_sql 3.13→3.14, fresco 0.1→0.6 plus new etcher, tesla 1.17→1.18, hammer 7.3→7.4, bandit, plug, req).

Wrap Emails settings and email tracking UI strings in gettext (47 new msgids in default.pot, en, ru, et catalogues). Covers tracking-options toggle labels, data retention block, privacy notice, current configuration table, tracking-benefits headers, IAM/SES setup walkthrough, and remaining placeholders.

Widen Emails settings page to use the full container width on wide screens (drop the max-w-4xl mx-auto wrapper). Short numeric inputs keep their max-w-xs caps.
Refresh dependency lockfile to latest compatible versions (notable bumps: finch 0.21→0.22, postgrex 0.22.1→0.22.2, swoosh 1.25.1→1.25.2, phoenix_kit 1.7.106→1.7.108, telemetry 1.4.1→1.4.2).

Per-module Gettext backend (PhoenixKit.Modules.Emails.Gettext) with en/ru/et catalogues for all admin sidebar tab labels. Requires phoenix_kit release that ships the gettext_backend Tab API (BeamLabEU/phoenix_kit#522); on older releases tabs render raw English (graceful degradation).

Suppress EmailInterceptor Logger warnings when the configured Swoosh adapter is not AWS SES.

Refresh dependency lockfile to latest compatible versions (notable bumps: bandit, db_connection, decimal, ecto, ex_doc).

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

This project adheres to Semantic Versioning.

Changed css_sources/0 return type from atom to binary to match PhoenixKit.Module behaviour callback spec.

Removed @behaviour and @impl annotations from Provider to fix compilation warnings (behaviour defined in host app).
Suppressed Hammer undefined module warning in WebhookController.

Rewrote install task to automatically add Tailwind CSS @source directive to app.css (idempotent).
Updated .gitignore with standard Elixir project entries.

Initial extraction from PhoenixKit core into a standalone package.
PhoenixKit.Email.Provider behaviour with 14 callbacks.
AWS SES integration for email sending via SMTP and API.
AWS SNS webhook processing for bounce, complaint, and delivery notifications.
AWS SQS polling for asynchronous event ingestion.
Email tracking and analytics (opens, clicks, deliveries, bounces, complaints).
9 admin LiveViews: dashboard, logs, templates, campaigns, recipients, settings, domains, blocklist, tracking.
Email template management with variable interpolation.
CSV and JSON export for email logs and analytics.
Swoosh interceptor for automatic email tracking.
Rate limiting on webhook endpoints via Hammer.
SNS signature verification for webhook security.
CSV formula injection protection in exports.
Install mix task (mix phoenix_kit_emails.install).