rack-url-canonicalizer 0.3.0 → 0.3.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0cc0592b66830e51b4f791b9b7c9503fa98ca0c20f25fb4fe92ae9379af404ed
-  data.tar.gz: 572708d83ec547c190e93d78dd900db96af8de7cca0c3760122a132fef8282c6
+  metadata.gz: 894b233627b42a6f6db8d6962f8622cd768b39603f1f569b79a45d413c89a95d
+  data.tar.gz: 1875213c68bdd7bb0cc6df9b84984117d98ef1d23a678c0c0268d3ee51690936
 SHA512:
-  metadata.gz: 1e1b05c26326297a9b6cd425433face278ebeae8d9ca9deddf34f637d092b3f8875d64591cf5b59a0265187933cfcbe88822ef5c0d52a7c30f08b6010c19f0d8
-  data.tar.gz: ffc8f3651b5a9bd64a50365dd86e9a5f9129903bfd4e998d44da3a3a8a024f30a60673bfd4e6aea365954cb12299985de08c95bf12df3e0daa04ad9c59c6989e
+  metadata.gz: d940708d8f98bf171dd7d4e8d521f131a1f85a58256dbcfb985551fc3aa0c61bd923da039e3a6cf5b1addc50e6c508f80f0eda4ac9045559fd58ef94912682e9
+  data.tar.gz: 1eea70a9bb3a300d90133749c1197cf06b492def21d9aa8f84b4fa823a483f37dd78ac57e76ee5699c5a9bbf23810d3712110dd0466f47689cce7c6194ddfc71

data/README.md

@@ -52,6 +52,7 @@ bundle install
 | `downcase_path` | `Boolean` | `false` | Converts path to lowercase (e.g. `/About-Us` ➔ `/about-us`). Query string casing is preserved. |
 | `downcase_paths` | `Array<String \| Regexp \| Proc> \| Boolean` | `nil` | Selective allowlist: only paths matching these prefixes or patterns are downcased. |
 | `downcase_exclude_paths` | `Array<String \| Regexp \| Proc>` | `[]` | Array of path prefixes, patterns, or procs to bypass from downcasing (preserves casing for tokens/IDs). |
+| `downcase_exclude_rails_paths` | `Boolean` | `true` | Automatically preserves casing for Rails internal routes (`/rails/*` such as Active Storage signed URLs, Action Mailbox, Mailers). |
 | `exclude_paths` | `Array<String>` | `[]` | Array of path prefixes to bypass (e.g. `%w[/api /assets]`). |
 | `exclude_hosts` | `Array<String \| Regexp \| Proc>` | `[]` | Array of hosts or patterns to bypass from host redirection. |
 | `locale_param` | `String` | `"locale"` | GET parameter key for locale. |
@@ -95,6 +96,8 @@ config.middleware.use Rack::UrlCanonicalizer,
   exclude_hosts: %w[api.example.com]
 ```
 
+> **Note:** Rails internal routes (`/rails/*`, such as Active Storage case-sensitive signed token URLs, Action Mailbox, and Mailer previews) are automatically protected from `downcase_path` by default (`downcase_exclude_rails_paths: true`). Setting custom `downcase_exclude_paths` will complement this default rather than overwrite it.
+
 ### Sinatra / Plain Rack
 
 In `config.ru`:

data/lib/rack/url_canonicalizer/configuration.rb

@@ -8,6 +8,7 @@ module Rack
                     :downcase_path,
                     :downcase_paths,
                     :downcase_exclude_paths,
+                    :downcase_exclude_rails_paths,
                     :exclude_paths,
                     :exclude_hosts,
                     :locale_param,
@@ -24,6 +25,7 @@ module Rack
         @downcase_path = false
         @downcase_paths = nil
         @downcase_exclude_paths = []
+        @downcase_exclude_rails_paths = true
         @exclude_paths = []
         @exclude_hosts = []
         @locale_param = 'locale'

data/lib/rack/url_canonicalizer/version.rb

@@ -2,6 +2,6 @@
 
 module Rack
   class UrlCanonicalizer
-    VERSION = '0.3.0'
+    VERSION = '0.3.1'
   end
 end

data/lib/rack/url_canonicalizer.rb

@@ -8,6 +8,7 @@ require_relative 'url_canonicalizer/railtie'
 module Rack
   class UrlCanonicalizer
     IPV4_REGEX = /\A\d{1,3}(?:\.\d{1,3}){3}\z/
+    DEFAULT_RAILS_PATH_PATTERN = %r{\A/+rails(/|\z)}i
     REDIRECT_BODIES = {
       301 => 'Moved Permanently',
       302 => 'Found',
@@ -135,6 +136,7 @@ module Rack
     end
 
     def downcase_excluded?(path)
+      return true if @config.downcase_exclude_rails_paths && DEFAULT_RAILS_PATH_PATTERN.match?(path)
       return false if @config.downcase_exclude_paths.nil? || @config.downcase_exclude_paths.empty?
 
       match_path_patterns?(@config.downcase_exclude_paths, path)

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rack-url-canonicalizer
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.3.1
 platform: ruby
 authors:
 - Alex Abramov