mailer-log 0.1.4 → 0.1.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 53e392cc0814b660324d0e0c15eb2e495db0a088d95c220a616910d086f25337
-  data.tar.gz: dad01fde647453de9bec1ba62ab4b56c6282cc796c5dc43e60d8914b74ccc4e2
+  metadata.gz: 246ac2bdc7be2049ccdf70145045c59b6e812b5fc1e15e55c34e27d7a9d355a7
+  data.tar.gz: ad4d87236c3317f50782b0036aef15b3b82fb0ad148619085ef76d4e83706cb6
 SHA512:
-  metadata.gz: b0bc20cdbf4a202f20affbd44df45a21d9b401a7a69ca097d0da6d3ec16a3f20f8b418d6958a61f69497f55e2761c7ffc09103935ddb8b6fc1a57a3c910aafea
-  data.tar.gz: 51ec6e61df1eace358a67b24d7289d1bb265276c8f549f45bcf69567a717558dbc6e71e861435dd5e00278cb4a4ab496bbddef5e50d150731587c98670d71af7
+  metadata.gz: 33943c05863643d2c1777cf7815722842f300676a862911832061fb2d3dd32c9cbc69eb195780362eb58cac4f14420d25ab495aafe963ef267137c4f5ef1af3d
+  data.tar.gz: 43e5dadcc5baa827305b13c17d04bab4bdc41a5fb1d73b163f58a9bd62c2c46978062aa79fb609ee0975e9a4623f4a5982979f41ba60b7e84c2e0b5f0fea9eef

data/CHANGELOG.md

@@ -5,6 +5,35 @@ 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.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.1.6] - 2025-12-15
+
+### Added
+
+- Configurable `mount_path` option (default: `/admin/mailer-log`)
+- `MailerLog.routes(self)` helper method for easier route mounting
+
+## [0.1.5] - 2025-12-15
+
+### Added
+
+- Shim file `lib/mailer-log.rb` for auto-require (no more `require: 'mailer_log'` needed in Gemfile)
+
+### Fixed
+
+- Updated README with correct paths and documentation
+
+## [0.1.4] - 2025-12-15
+
+### Added
+
+- Date range picker with presets (Today, This week, Last week, This month, Last month)
+- Tooltips for long email addresses in detail panel
+
+### Changed
+
+- Improved email detail panel layout (From/To stacked vertically, mailer info aligned right)
+- Close button moved to left side with back arrow icon
+
 ## [0.1.0] - 2024-12-14
 
 ### Added

data/README.md

@@ -17,7 +17,7 @@ Rails engine for logging all outgoing emails with Mailgun webhook integration.
 ### 1. Add to Gemfile
 
 ```ruby
-gem 'mailer_log'
+gem 'mailer-log'
 ```
 
 ### 2. Run install generator
@@ -37,10 +37,16 @@ This will:
 ```ruby
 # config/routes.rb
 Rails.application.routes.draw do
-  mount MailerLog::Engine, at: '/mailer_log'
+  MailerLog.routes(self, at: '/admin/email_log')
 end
 ```
 
+Or mount manually:
+
+```ruby
+mount MailerLog::Engine, at: '/admin/email_log'
+```
+
 ### 4. Build the frontend (if needed)
 
 The engine includes pre-built Vue.js frontend assets. If you need to rebuild:
@@ -61,6 +67,9 @@ Edit `config/initializers/mailer_log.rb` to customize settings:
 
 ```ruby
 MailerLog.configure do |config|
+  # Mount path for the engine (default: '/admin/mailer-log')
+  # config.mount_path = '/admin/mailer-log'
+
   # Email retention period (default 1 year)
   config.retention_period = 1.year
 
@@ -95,7 +104,7 @@ end
 
 1. In Mailgun Dashboard, go to **Webhooks**
 2. Add webhook for each event:
-   - URL: `https://your-app.com/admin/email_log/webhooks/mailgun`
+   - URL: `https://your-app.com/admin/mailer-log/webhooks/mailgun` (adjust path based on your mount_path)
    - Events: `delivered`, `opened`, `clicked`, `bounced`, `failed`, `dropped`, `complained`
 
 ### 3. For Each Domain
@@ -106,11 +115,12 @@ If using multiple domains (white-label), configure webhooks for each.
 
 ### Admin UI
 
-After installation, accessible at: `/admin/email_log/admin/emails`
+After installation, accessible at the mounted path (e.g., `/mailer_log` based on routes example above).
 
 **Features:**
 - List of all sent emails with pagination
-- Filtering by: recipient, sender, subject, mailer class, status, date
+- Filtering by: recipient, sender, subject, mailer class, status
+- Date range picker with presets (Today, This week, Last week, This month, Last month)
 - Email details view: headers, body preview, delivery events
 - Call stack view (where in code the email was triggered)
 
@@ -170,6 +180,7 @@ cleanup_mailer_log:
 
 | Parameter | Default | Description |
 |-----------|---------|-------------|
+| `mount_path` | `'/admin/mailer-log'` | Default path for `MailerLog.routes(self)` when `at:` not specified |
 | `retention_period` | `1.year` | Email retention period |
 | `webhook_signing_key` | `nil` | Key for Mailgun webhook verification |
 | `capture_call_stack` | `true` | Capture call stack |
@@ -177,6 +188,20 @@ cleanup_mailer_log:
 | `admin_layout` | `'application'` | Layout for admin views |
 | `per_page` | `25` | Records per page |
 
+## Using as letter_opener Replacement
+
+MailerLog can replace `letter_opener_web` for staging environments. Since MailerLog captures emails **before** delivery (via ActionMailer interceptor), you can use `:test` delivery method to prevent actual sending while still logging all emails.
+
+```ruby
+# config/environments/staging.rb
+Rails.application.configure do
+  # Use :test so emails are not sent, but MailerLog still captures them
+  config.action_mailer.delivery_method = :test
+end
+```
+
+This gives you a full email log UI with filtering, search, and body preview without sending real emails.
+
 ## Troubleshooting
 
 ### Emails Not Being Saved

data/lib/generators/mailer_log/install/templates/README

@@ -12,13 +12,19 @@ Next steps:
 2. Add routes to config/routes.rb:
 
    Rails.application.routes.draw do
-     mount MailerLog::Engine, at: '/mailer_log'
+     MailerLog.routes(self, at: '/admin/email_log')
+   end
+
+   Or mount manually:
+
+   Rails.application.routes.draw do
+     mount MailerLog::Engine, at: '/admin/email_log'
    end
 
 3. Configure Mailgun webhooks (optional, for delivery tracking):
 
    - Go to Mailgun Dashboard -> Sending -> Webhooks
-   - Add webhook URL: https://your-app.com/mailer_log/webhooks/mailgun
+   - Add webhook URL: https://your-app.com/admin/mailer-log/webhooks/mailgun
    - Select events: delivered, opened, clicked, bounced, failed, complained
    - Copy webhook signing key to ENV['MAILGUN_WEBHOOK_SIGNING_KEY']
 
@@ -29,7 +35,7 @@ Next steps:
      cron: '0 3 * * *'
      class: MailerLog::CleanupJob
 
-5. Access admin UI at: /mailer_log/admin/emails
+5. Access admin UI at: /admin/mailer-log (or your configured mount_path)
 
 ===============================================================================
 

data/lib/generators/mailer_log/install/templates/initializer.rb.tt

@@ -1,6 +1,10 @@
 # frozen_string_literal: true
 
 MailerLog.configure do |config|
+  # Mount path for the engine (default: '/admin/mailer-log')
+  # Used when calling MailerLog.routes(self) in config/routes.rb
+  # config.mount_path = '/admin/mailer-log'
+
   # Email retention period (default: 1 year)
   # Emails older than this will be deleted by CleanupJob
   config.retention_period = 1.year

data/lib/mailer-log.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+# Shim file to allow `gem 'mailer-log'` without `require: 'mailer_log'`
+# Bundler auto-requires based on gem name, so this redirects to the actual file.
+require_relative 'mailer_log'

data/lib/mailer_log/configuration.rb

@@ -3,11 +3,12 @@
 module MailerLog
   class Configuration
     attr_accessor :retention_period,
-                  :webhook_signing_key,
-                  :capture_call_stack,
-                  :call_stack_depth,
-                  :admin_layout,
-                  :per_page
+      :webhook_signing_key,
+      :capture_call_stack,
+      :call_stack_depth,
+      :admin_layout,
+      :per_page,
+      :mount_path
 
     attr_reader :authenticate_with_proc, :resolve_accountable_proc
 
@@ -18,6 +19,7 @@ module MailerLog
       @call_stack_depth = 20
       @admin_layout = 'application'
       @per_page = 25
+      @mount_path = '/admin/mailer-log'
       @authenticate_with_proc = nil
       @resolve_accountable_proc = nil
     end

data/lib/mailer_log/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module MailerLog
-  VERSION = '0.1.4'
+  VERSION = '0.1.6'
 end

data/lib/mailer_log.rb

@@ -20,5 +20,15 @@ module MailerLog
     def reset_configuration!
       @configuration = Configuration.new
     end
+
+    # Mount engine routes
+    # Usage in config/routes.rb:
+    #   MailerLog.routes(self, at: '/admin/email_log')
+    # Or use configured mount_path:
+    #   MailerLog.routes(self)  # uses config.mount_path (default: /admin/mailer-log)
+    def routes(router, at: nil)
+      path = at || configuration.mount_path
+      router.mount Engine, at: path
+    end
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: mailer-log
 version: !ruby/object:Gem::Version
-  version: 0.1.4
+  version: 0.1.6
 platform: ruby
 authors:
 - TrafficRunners
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-12-14 00:00:00.000000000 Z
+date: 2025-12-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: has_scope
@@ -62,7 +62,7 @@ description: A Rails engine that captures all outgoing emails, stores them in Po
   provides a Vue.js admin UI for browsing emails, and tracks delivery events via Mailgun
   webhooks.
 email:
-- team@localviking.com
+- sk@trafficrunners.net
 executables: []
 extensions: []
 extra_rdoc_files: []
@@ -93,6 +93,7 @@ files:
 - lib/generators/mailer_log/install/templates/README
 - lib/generators/mailer_log/install/templates/create_mailer_log_tables.rb.tt
 - lib/generators/mailer_log/install/templates/initializer.rb.tt
+- lib/mailer-log.rb
 - lib/mailer_log.rb
 - lib/mailer_log/configuration.rb
 - lib/mailer_log/engine.rb