site_maps 0.1.1 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9246737e11d28f750005fedc117c0c2afb8c5f5ef606218fc505e1042c4da002
-  data.tar.gz: 80f005cca72244cfe1044c30cf91d1656b22bb7ff3047a2fd159eee2ddd2f3a5
+  metadata.gz: e5ccf5d0f2a84dbe95a4848980ac22b8863244e05e5d0a93bd4007bce78e9c48
+  data.tar.gz: 71392ff9ab92e741bb58dfc190f2f29f012682b256347043ab7f686f3e631572
 SHA512:
-  metadata.gz: 6ebb8a69803018a65c995e61cc714385ae965b04fc8df330cb7a5e99fd37539568cc1661e86da70f1e7e90eef108ba9a9c5ba1bc6e4b50d5c17f41856e4df934
-  data.tar.gz: 9dbf41444903708643f4639ae773470fc2043eeb0deb9061dedccef5ceda30210435db6faec1d1f949baa8200841d7245c40ac97df88f8993b57e5c1caeaa41b
+  metadata.gz: 4824b2c466af7db2f1e1ba521045a75dbf52dcbcb528cdcce7417cfa797b0c2aa3b516645963a375f9e82bc07d91cda1522eaabbaa80c67028c2fbf2b5131b58
+  data.tar.gz: fac8d331b39a52baafc9831aa424060da7d7e2666a54bfea14e2c2b776d661efd2e91aeb2149d11aa02a0ee1a52049986708c343380470d32e7189034fe14539

data/.tool-versions

@@ -1 +1 @@
-ruby 3.4.9
+ruby 3.2.2

data/CHANGELOG.md

@@ -4,6 +4,11 @@ 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.2 - 2026-07-17
+
+### Added
+- Middleware `aliases:` option: maps an incoming public request path to another public request path (applied before the prefix options), so the same content can be served at multiple locations without a redirect — e.g. `aliases: { "/sitemap.xml" => "/sitemap_index.xml" }`. Accepts a hash or a callable returning a hash.
+
 ## 0.1.1 - 2026-05-12
 
 ### Fixed

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    site_maps (0.1.1)
+    site_maps (0.1.2)
       builder (~> 3.0)
       concurrent-ruby (>= 1.1)
       rack (>= 2.0)
@@ -37,7 +37,7 @@ GEM
     bigdecimal (4.1.1)
     builder (3.3.0)
     coderay (1.1.3)
-    concurrent-ruby (1.3.6)
+    concurrent-ruby (1.3.7)
     crack (1.0.1)
       bigdecimal
       rexml
@@ -126,7 +126,7 @@ GEM
       addressable (>= 2.8.0)
       crack (>= 0.3.2)
       hashdiff (>= 0.4.0, < 2.0.0)
-    zeitwerk (2.7.5)
+    zeitwerk (2.8.2)
 
 PLATFORMS
   x86_64-linux

data/README.md

@@ -269,6 +269,7 @@ Use these when the public URL path and the storage path differ:
 |---|---|---|
 | `public_prefix:` | Public URL has an extra prefix → strip it to find the file | Stored at `/sitemap.xml`, served at `/sitemaps/tenant/sitemap.xml` |
 | `storage_prefix:` | Storage has an extra prefix → prepend it to the public path | Stored at `/sitemaps/tenant/sitemap.xml`, served at `/sitemap.xml` |
+| `aliases:` | Serve one public path's content at another public path (no redirect) | `/sitemap.xml` serves the content of `/sitemap_index.xml` |
 
 ```ruby
 # Sitemaps stored at /sitemaps/{slug}/sitemap.xml, served at /sitemap.xml
@@ -283,6 +284,20 @@ Rails.application.middleware.insert_after MultitenancyMiddleware, SiteMaps::Midd
   adapter: -> { ... }
 ```
 
+`aliases:` maps an incoming public request path to another public request path,
+applied before the prefix options. Use it to serve the same content at multiple
+locations — for example, to answer the conventional `/sitemap.xml` with the
+sitemap index that is stored/served as `/sitemap_index.xml`:
+
+```ruby
+Rails.application.middleware.insert_after MultitenancyMiddleware, SiteMaps::Middleware,
+  aliases: { "/sitemap.xml" => "/sitemap_index.xml" },
+  storage_prefix: -> { site = Current.site; "/sitemaps/#{site.slug}" if site },
+  adapter: -> { ... }
+```
+
+It accepts a hash or a callable (0-arg or 1-arg receiving `env`) returning a hash.
+
 XSL stylesheet requests (`/_sitemap-stylesheet.xsl`, `/_sitemap-index-stylesheet.xsl`) are served directly without resolving the adapter or prefix.
 
 ### Thread safety
@@ -536,6 +551,7 @@ use SiteMaps::Middleware,
   adapter: SiteMaps.current_adapter,        # defaults to SiteMaps.current_adapter
   public_prefix: nil,                       # strip this prefix from the public URL before lookup
   storage_prefix: nil,                      # prepend this prefix to the public URL for storage lookup
+  aliases: nil,                             # map a public path to another public path, e.g. { "/sitemap.xml" => "/sitemap_index.xml" }
   x_robots_tag: "noindex, follow",          # default
   cache_control: "public, max-age=3600"     # default
 ```

data/lib/site_maps/middleware.rb

@@ -28,11 +28,21 @@ module SiteMaps
     # Both options accept a callable (0-arg or 1-arg receiving env), which is useful
     # in multi-tenant setups where the prefix depends on the current request/site.
     #
+    # @param aliases [Hash{String=>String}, #call, nil] Maps an incoming **public
+    #   request path** to another public request path, applied before prefix
+    #   handling. Serves the target's content at the alias path (no redirect).
+    #
+    #   Example: serve the sitemap index at both locations →
+    #   `aliases: { "/sitemap.xml" => "/sitemap_index.xml" }`
+    #
+    #   Accepts a callable (0-arg or 1-arg receiving env) returning such a hash.
+    #
     def initialize(
       app,
       adapter: nil,
       public_prefix: nil,
       storage_prefix: nil,
+      aliases: nil,
       x_robots_tag: DEFAULT_X_ROBOTS_TAG,
       cache_control: DEFAULT_CACHE_CONTROL
     )
@@ -40,12 +50,13 @@ module SiteMaps
       @adapter = adapter
       @public_prefix = public_prefix
       @storage_prefix = storage_prefix
+      @aliases = aliases
       @x_robots_tag = x_robots_tag
       @cache_control = cache_control
     end
 
     def call(env)
-      path = env["PATH_INFO"]
+      path = resolve_alias(env["PATH_INFO"], env)
 
       if xsl_request?(path)
         serve_xsl(path)
@@ -74,6 +85,16 @@ module SiteMaps
 
     private
 
+    # Rewrites the incoming public path through the alias map (if configured)
+    # before any prefix handling, so the aliased path takes the exact same code
+    # path as a real request for the target.
+    def resolve_alias(path, env)
+      aliases = @aliases.respond_to?(:call) ? call_with_env(@aliases, env) : @aliases
+      return path unless aliases
+
+      aliases[path] || path
+    end
+
     def resolve_adapter(env)
       if @adapter.respond_to?(:call)
         call_with_env(@adapter, env)

data/lib/site_maps/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module SiteMaps
-  VERSION = "0.1.1"
+  VERSION = "0.1.2"
 end

metadata

@@ -1,13 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: site_maps
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.1.2
 platform: ruby
 authors:
 - Marcos G. Zimmermann
+autorequire:
 bindir: exec
 cert_chain: []
-date: 1980-01-02 00:00:00.000000000 Z
+date: 2026-07-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rack
@@ -165,6 +166,7 @@ metadata:
   bug_tracker_uri: https://github.com/marcosgz/site_maps/issues
   documentation_uri: https://github.com/marcosgz/site_maps
   source_code_uri: https://github.com/marcosgz/site_maps
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -179,7 +181,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.9
+rubygems_version: 3.4.10
+signing_key:
 specification_version: 4
 summary: Concurrent and Incremental sitemap.xml builder for ruby applications
 test_files: []