standard_pagination 0.1.1 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 149b70a719e0da5a83ca318611fd7a97c8c01678022e9ca52831b2007285b138
-  data.tar.gz: 6be9f28d0f29f6179a4a38abcebad5e985ad992a35cf08d5c0eeb1746b2edf35
+  metadata.gz: c8213902bdeb4fed07cf6c759eb52fc064a4f62154a25a7c92dafba705232a7d
+  data.tar.gz: 6fc78271275b84da5b601836cd6b03e100545b43a8c79ffc6ef8ea30a761e139
 SHA512:
-  metadata.gz: 6dc0d679a00cea8898d0da4d9369c38238ffff057eb4e1e691c82f764ce781f9690083d6ce1873fe2c9a0f2dc4409e3da5c44bc4219a092892bd253340a16e4e
-  data.tar.gz: 4f345dc7fb354212d8a4c9b02f950449fe80a8c8c99dee233bb149f770445ae0a9906e82f1443edd22b9118662c2f0a7d3ed51f3f5b6a133e21c803bc5a7b928
+  metadata.gz: 41c6e457018dd8e2c9d320cd7ea298a7c8812cefd64ff47d1828d12851cdcbe6e45da01add2a7cf70b8cda166789b4d851dec5812cc6f8fb8443e6737f914f50
+  data.tar.gz: 631d2e4e9ad5bd57077073417663f19e709912171918b6dd39feaf8370848f7d9fb6ac8ea228ec41b5fe334a992393593a47b622c450c6bfbe7204d78c6efd4d

data/CHANGELOG.md

@@ -7,6 +7,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.1.2] - 2026-10-26
+
+### Added
+- `config.limit_key` accepts an Array of aliases, e.g. `%w[limit per_page]`; the first one the request sends wins. For APIs whose clients use both (luminality-web). The out-of-range redirect drops all of them. (Meant for 0.1.1, but that PR auto-merged before this commit landed.)
+
 ## [0.1.1] - 2026-10-25
 
 ### Fixed

data/README.md

@@ -45,7 +45,7 @@ Delete `max_limit` (or `client_limit`) from `config/initializers/pagy.rb`. Leave
 StandardPagination.configure do |c|
   c.default_limit = 20            # rows when a call site passes no limit:
   c.max_limit = 100               # cap on a client-chosen page size
-  c.limit_key = "limit"           # param a client sets it with ("per_page" in luminality)
+  c.limit_key = "limit"           # param a client sets it with; an Array accepts aliases, e.g. %w[limit per_page]
   c.client_limit_formats = %i[json]
   c.tiebreak = true
   c.raise_range_error = true

data/lib/standard_pagination/config.rb

@@ -4,7 +4,8 @@ module StandardPagination
     attr_accessor :default_limit
     # Largest page size a client may request when client limits are on.
     attr_accessor :max_limit
-    # Request param a client sets the page size with (when allowed).
+    # Request param a client sets the page size with (when allowed). An Array
+    # accepts aliases; the first one the request sends wins.
     attr_accessor :limit_key
     # Formats for which `paginate` honours the client's page size by default.
     # HTML pages keep the size the call site chose.

data/lib/standard_pagination/controller.rb

@@ -96,12 +96,18 @@ module StandardPagination
       cap = pagination_client_limit_cap(client_limit)
       return limit unless cap
 
-      requested = params[StandardPagination.config.limit_key].to_s
+      # The first configured key the request sends wins.
+      key = pagination_limit_keys.find { |candidate| params[candidate].present? }
+      requested = key ? params[key].to_s : ""
       return limit unless requested.match?(/\A\d+\z/) && requested.to_i.positive?
 
       [ requested.to_i, cap ].min
     end
 
+    def pagination_limit_keys
+      Array(StandardPagination.config.limit_key).map(&:to_s)
+    end
+
     def pagination_client_limit_cap(client_limit)
       client_limit = pagination_client_limit_format? if client_limit.nil?
 
@@ -144,7 +150,7 @@ module StandardPagination
       if last_page
         query[page_key] = last_page
       else
-        query = query.except((options[:limit_key] || Pagy::DEFAULT[:limit_key]).to_s, StandardPagination.config.limit_key)
+        query = query.except((options[:limit_key] || Pagy::DEFAULT[:limit_key]).to_s, *pagination_limit_keys)
         # Nothing left to drop: the bad option came from the call site or a
         # param this gem doesn't know, so redirecting would only repeat it.
         return head(:bad_request) if query == original

data/lib/standard_pagination/version.rb

@@ -1,3 +1,3 @@
 module StandardPagination
-  VERSION = "0.1.1"
+  VERSION = "0.1.2"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: standard_pagination
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.1.2
 platform: ruby
 authors:
 - Jaryl Sim