ahoy_email 2.5.0 → 4.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: aa1850e7d07ec2fe43003f8e6c2046a10bd8229c6e5e8d12849cc8a2d819f670
-  data.tar.gz: 4eefd3654e671eb6c65b064025d9ea5c7dd7810d73f12bbc8b34cafb2e5e00f4
+  metadata.gz: bd188dfb55eeecb5ff5b601ab679f04df570515a2176af9184192ea0cd8688bc
+  data.tar.gz: 176f9e44b50fc890e29d522e80bc68143739fcd5c14235977ec8c1f258d84043
 SHA512:
-  metadata.gz: 0e021685e661cbb627a5d95fde8dfccbc0630398a391eea319d64ce268f3219918a6442a23f1ed9a2a06b69761a97f09aa8cb2a633e282affc200e4ac45b7d7b
-  data.tar.gz: 104b6dfebf8f9d3bb3381e09b972708f539122ff2ca062cfc0aaf5a5af529661e06c196dfa35e862a8709b2ede56af3dcf13af9ee1bb15552ce036323ced9f39
+  metadata.gz: 6b375f8a1fbb1d78e6bf87b7092c40484ea889f3d71a7f9d2d7916e365161edb229e947aea7f2db517a430775cfc7b29881223efd00391232bb3cea7a859f4e3
+  data.tar.gz: c9fb82f641e3905f7039b81c6465df26a01d9ddc529a25e600d966eb58b4ed96017e8ff6ae0e2d135a4f7545eb9a9a6eea297f8e6c56edb1e4a632b1926325fb

data/CHANGELOG.md

@@ -1,3 +1,17 @@
+## 4.0.0 (2026-08-08)
+
+See the [upgrade notes](https://github.com/ankane/ahoy_email?tab=readme-ov-file#40)
+
+- Fixed change to key generator hash digest class
+- Removed support for Ruby < 3.3 and Rails < 7.2
+
+## 3.0.0 (2025-07-02)
+
+See the [upgrade notes](https://github.com/ankane/ahoy_email/blob/v3.0.0/README.md#upgrading)
+
+- Switched to HTML5 parsing by default (when available)
+- Removed support for legacy secret token generation
+
 ## 2.5.0 (2025-05-04)
 
 - Removed support for Ruby < 3.2 and Rails < 7.1

data/LICENSE.txt

@@ -1,4 +1,4 @@
-Copyright (c) 2014-2023 Andrew Kane
+Copyright (c) 2014-2025 Andrew Kane
 
 MIT License
 

data/README.md

@@ -2,6 +2,8 @@
 
 First-party email analytics for Rails
 
+**Ahoy Email 4.0 was recently released** - see [how to upgrade](#upgrading)
+
 :fire: For web and native app analytics, check out [Ahoy](https://github.com/ankane/ahoy)
 
 :bullettrain_side: To manage email subscriptions, check out [Mailkick](https://github.com/ankane/mailkick)
@@ -106,7 +108,7 @@ user.messages
 Add extra data to messages. Create a migration like:
 
 ```ruby
-class AddCouponIdToAhoyMessages < ActiveRecord::Migration[8.0]
+class AddCouponIdToAhoyMessages < ActiveRecord::Migration[8.1]
   def change
     add_column :ahoy_messages, :coupon_id, :integer
   end
@@ -324,14 +326,14 @@ Get stats for a campaign
 AhoyEmail.stats("my-campaign")
 ```
 
-## HTML Parsing
+## Upgrading
 
-By default, Nokogiri’s default HTML parser is used to rewrite links for UTM tagging and click analytics. This currently uses HTML4, which [only allows inline elements inside links](https://github.com/sparklemotion/nokogiri/issues/1876#issuecomment-468276937).
+### 4.0
 
-To use HTML5 parsing, create `config/initializers/ahoy_email.rb` with:
+Versions 2.3.0-3.0.0 cause applications to use SHA1 for the key generator hash digest class if `AhoyEmail.secret_token` is not manually set (due to [this behavior in Rails](https://github.com/rails/rails/issues/56736)). To avoid breakage when upgrading, add to `config/application.rb`:
 
 ```ruby
-AhoyEmail.default_options[:html5] = true
+config.active_support.key_generator_hash_digest_class = OpenSSL::Digest::SHA1
 ```
 
 ## History

data/lib/ahoy_email/engine.rb

@@ -3,26 +3,8 @@ require "rails/engine"
 module AhoyEmail
   class Engine < ::Rails::Engine
     initializer "ahoy_email" do |app|
-      AhoyEmail.secret_token ||= begin
-        tokens = []
-        tokens << app.key_generator.generate_key("ahoy_email")
-
-        # TODO remove in 3.0
-        creds =
-          if app.respond_to?(:credentials) && app.credentials.secret_key_base
-            app.credentials
-          elsif app.respond_to?(:secrets) && app.config.paths["config/secrets"].existent.any?
-            app.secrets
-          else
-            app.config
-          end
-
-        token = creds.respond_to?(:secret_key_base) ? creds.secret_key_base : creds.secret_token
-        token ||= app.secret_key_base # should come first, but need to maintain backward compatibility
-        tokens << token
-
-        tokens
-      end
+      # avoid app.key_generator due to https://github.com/ankane/ahoy_email/pull/168
+      AhoyEmail.secret_token ||= ActiveSupport::KeyGenerator.new(app.secret_key_base, iterations: 1000, hash_digest_class: OpenSSL::Digest::SHA1).generate_key("ahoy_email")
     end
   end
 end

data/lib/ahoy_email/processor.rb

@@ -101,7 +101,11 @@ module AhoyEmail
       when false
         Nokogiri::HTML4::Document
       else
-        Nokogiri::HTML::Document
+        if defined?(Nokogiri::HTML5::Document)
+          Nokogiri::HTML5::Document
+        else
+          Nokogiri::HTML4::Document
+        end
       end
     end
 

data/lib/ahoy_email/utils.rb

@@ -20,6 +20,7 @@ module AhoyEmail
         secret_tokens.any? do |secret_token|
           expected_signature =
             if legacy
+              # TODO remove legacy support in 5.0
               OpenSSL::HMAC.hexdigest("SHA1", secret_token, url)
             else
               signature(token: token, campaign: campaign, url: url, secret_token: secret_token)

data/lib/ahoy_email/version.rb

@@ -1,3 +1,3 @@
 module AhoyEmail
-  VERSION = "2.5.0"
+  VERSION = "4.0.0"
 end

data/lib/generators/ahoy/clicks/activerecord_generator.rb

@@ -14,6 +14,14 @@ module Ahoy
         def migration_version
           "[#{ActiveRecord::VERSION::MAJOR}.#{ActiveRecord::VERSION::MINOR}]"
         end
+
+        def primary_key_type
+          ", id: :#{key_type}" if key_type
+        end
+
+        def key_type
+          Rails.configuration.generators.options.dig(:active_record, :primary_key_type)
+        end
       end
     end
   end

data/lib/generators/ahoy/clicks/templates/migration.rb.tt

@@ -1,6 +1,6 @@
 class <%= migration_class_name %> < ActiveRecord::Migration<%= migration_version %>
   def change
-    create_table :ahoy_clicks do |t|
+    create_table :ahoy_clicks<%= primary_key_type %> do |t|
       t.string :campaign, index: true
       t.string :token
     end

data/lib/generators/ahoy/clicks_generator.rb

@@ -9,11 +9,11 @@ module Ahoy
 
         selection =
           if activerecord && mongoid
-            puts <<-MSG
+            puts <<~MSG
 
-Which data store would you like to use?
- 1. Active Record (default)
- 2. Mongoid
+              Which data store would you like to use?
+               1. Active Record (default)
+               2. Mongoid
             MSG
 
             ask(">")

data/lib/generators/ahoy/messages/activerecord_generator.rb

@@ -42,18 +42,10 @@ module Ahoy
           end
         end
 
-        # TODO remove default
         def encryption
           case options[:encryption]
           when "lockbox", "activerecord", "none"
             options[:encryption]
-          when nil
-            if options[:unencrypted]
-              # TODO deprecation warning
-              "none"
-            else
-              "lockbox"
-            end
           else
             abort "Error: encryption must be lockbox, activerecord, or none"
           end
@@ -74,6 +66,18 @@ module Ahoy
         def adapter
           ActiveRecord::Base.connection_db_config.adapter.to_s
         end
+
+        def primary_key_type
+          ", id: :#{key_type}" if key_type
+        end
+
+        def foreign_key_type
+          ", type: :#{key_type}" if key_type
+        end
+
+        def key_type
+          Rails.configuration.generators.options.dig(:active_record, :primary_key_type)
+        end
       end
     end
   end

data/lib/generators/ahoy/messages/mongoid_generator.rb

@@ -19,18 +19,10 @@ module Ahoy
           end
         end
 
-        # TODO remove default
         def encryption
           case options[:encryption]
           when "lockbox", "none"
             options[:encryption]
-          when nil
-            if options[:unencrypted]
-              # TODO deprecation warning
-              "none"
-            else
-              "lockbox"
-            end
           else
             abort "Error: encryption must be lockbox or none"
           end

data/lib/generators/ahoy/messages/templates/migration.rb.tt

@@ -1,7 +1,7 @@
 class <%= migration_class_name %> < ActiveRecord::Migration<%= migration_version %>
   def change
-    create_table :ahoy_messages do |t|
-      t.references :user, polymorphic: true
+    create_table :ahoy_messages<%= primary_key_type %> do |t|
+      t.references :user<%= foreign_key_type %>, polymorphic: true
       <%= to_column %>
       t.string :mailer
       t.text :subject

data/lib/generators/ahoy/messages_generator.rb

@@ -13,11 +13,11 @@ module Ahoy
 
         selection =
           if activerecord && mongoid
-            puts <<-MSG
+            puts <<~MSG
 
-Which data store would you like to use?
- 1. Active Record (default)
- 2. Mongoid
+              Which data store would you like to use?
+               1. Active Record (default)
+               2. Mongoid
             MSG
 
             ask(">")

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ahoy_email
 version: !ruby/object:Gem::Version
-  version: 2.5.0
+  version: 4.0.0
 platform: ruby
 authors:
 - Andrew Kane
@@ -15,56 +15,56 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '7.1'
+        version: '7.2'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '7.1'
+        version: '7.2'
 - !ruby/object:Gem::Dependency
   name: addressable
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 2.3.2
+        version: '2.8'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 2.3.2
+        version: '2.8'
 - !ruby/object:Gem::Dependency
   name: nokogiri
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '1.15'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '1.15'
 - !ruby/object:Gem::Dependency
   name: safely_block
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0.4'
+        version: '0.5'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0.4'
+        version: '0.5'
 email: andrew@ankane.org
 executables: []
 extensions: []
@@ -113,14 +113,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '3.2'
+      version: '3.3'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.7
+rubygems_version: 4.0.16
 specification_version: 4
 summary: First-party email analytics for Rails
 test_files: []