esse-pagy 0.0.2 → 0.43.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5a5bc051ed525825e1e41fa010dd7192dc1417cd5988fc772a969060fd398b1c
-  data.tar.gz: 98cc1531ffb9d3e514584628b564bdbd4710d7cbd10bfff40708e26e0949238d
+  metadata.gz: 5aab1fef790c9d1d136cb6c05d818645495c02ceec882b00b6b71e9bebb0f286
+  data.tar.gz: 7af8032792e1ca50ce4673f800c0f6d77427aba635b069e1b0b106f426f24652
 SHA512:
-  metadata.gz: 75905c59da32a8bd9c9c24abb1cc114f1ff338a5ac6c4611e70052d2ed8b66e483c6a822eacc6da15968fa91cfe1e7e603950a30ffcf60050448c44460275e38
-  data.tar.gz: d9c2fb8ba6f11e1d6d15612d9dac6a8b89fc31b945c0d0ec07b23814b58d2781f85c8d5d339de8d065f867944920c267abcadf04299a7eded8e0288bbc4e9b60
+  metadata.gz: 435eb6d94097ab144ddafc1c63dab793b5c08f215503acaeced3b008f54db706d4197edcbf9b892859c531f9431d58c923be4c0988514488ebffa03b003f853f
+  data.tar.gz: e4acd964c62740ef144cfddd99a9f96bde82c6b4e97071009a8d8029e588b6d5396670833a85a73e34c5791bfb09b30c6e5e6f536123f8eef2a2072b3bb0e94a

data/CHANGELOG.md

@@ -4,6 +4,12 @@ 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.43.0
+
+### Added
+* Pagy 43 support: `new_from_esse` builds a `Pagy::Offset` (bare `Pagy` is abstract in 43), and the controller-helper defaults / `Pagy::Backend` integration are only registered on Pagy versions that ship them (43 froze `Pagy::DEFAULT` and removed `Pagy::Backend`).
+* CI gemfile + matrix entry for Pagy 43.
+
 ## 0.0.2 - 2024-12-19
 
 ### Added

data/README.md

@@ -2,6 +2,10 @@
 
 This gem is a [esse](https://github.com/marcosgz/esse) plugin for the [pagy](https://github.com/ddnexus/pagy) pagination.
 
+## Documentation
+
+Full guides, pagination examples, and API reference are published at **[gems.marcosz.com.br/esse-pagy](https://gems.marcosz.com.br/esse-pagy/)** — part of the [marcosgz Ruby gem catalogue](https://gems.marcosz.com.br).
+
 ## Installation
 
 Add this line to your application's Gemfile:
@@ -18,12 +22,26 @@ $ bundle install
 
 ## Pagy Version Compatibility
 
-This gem supports Pagy versions 5.x through 9.x, but with different Ruby version requirements:
+Pagy 43 reorganized its internals (it froze `Pagy::DEFAULT`, removed the
+`Pagy::Backend` mixin, and split paginators into `Pagy::Offset`/`Keyset`/`Search`),
+which is not backward compatible. esse-pagy releases track the supported Pagy major:
+
+| esse-pagy   | Pagy        | Ruby Version Required                       |
+|-------------|-------------|--------------------------------------------|
+| `>= 0.43`   | 43.x        | >= 3.1.0                                    |
+| `<= 0.0.2`  | 5.x – 9.x   | >= 2.5.0 (5.x, 6.x), >= 3.1.0 (7.x–9.x)     |
+
+If your app is still on Pagy 5–9, pin the previous esse-pagy release:
+
+```ruby
+gem "esse-pagy", "~> 0.0.2"
+```
+
+For Pagy 43+:
 
-| Pagy Version | Ruby Version Required |
-|--------------|----------------------|
-| 5.x, 6.x     | >= 2.5.0             |
-| 7.x, 8.x, 9.x| >= 3.1.0             |
+```ruby
+gem "esse-pagy", ">= 0.43"
+```
 
 ## Usage
 

data/docs/README.md

@@ -0,0 +1,59 @@
+# esse-pagy
+
+[Pagy](https://github.com/ddnexus/pagy) pagination for [Esse](../../esse/docs/README.md) search queries.
+
+Unlike `esse-kaminari`, which adds chainable query methods, `esse-pagy` uses Pagy's **controller-backend** pattern: the index builds a delayed search description, and the `pagy_esse` controller helper executes it with pagination.
+
+## Contents
+
+- [Usage guide](usage.md)
+- [API reference](api.md)
+
+## Install
+
+```ruby
+# Gemfile
+gem 'esse', '>= 0.2.4'
+gem 'pagy', '>= 5'
+gem 'esse-pagy'
+```
+
+In your controller (Pagy's `Pagy::Backend` is typically included in `ApplicationController`):
+
+```ruby
+class UsersController < ApplicationController
+  def index
+    @pagy, @response = pagy_esse(
+      UsersIndex.pagy_search(body: { query: { match: { name: params[:q] } } }),
+      items: 10
+    )
+    @results = @response.results
+  end
+end
+```
+
+In the view:
+
+```erb
+<%== pagy_nav(@pagy) %>
+<% @results.each { |hit| %><%= hit.dig('_source', 'name') %><br><% } %>
+```
+
+## Multi-index pagination
+
+```ruby
+@pagy, @response = pagy_esse(
+  Esse.cluster.pagy_search(CitiesIndex, CountiesIndex, body: body),
+  items: 25
+)
+```
+
+## Version
+
+- Version: **0.0.1**
+- Ruby: `>= 2.5.0`
+- Depends on: `esse >= 0.2.4`, `pagy >= 5`
+
+## License
+
+MIT.

data/docs/api.md

@@ -0,0 +1,125 @@
+# API Reference
+
+The gem adds methods at four layers:
+
+1. `Esse::Index.pagy_search` — build a deferred search description.
+2. `Esse::Cluster#pagy_search` — same, for multi-index/cluster searches.
+3. `Pagy.new_from_esse` — build a Pagy instance from an already-executed query.
+4. `Pagy::Backend#pagy_esse` — controller helper that executes the description with pagination.
+
+---
+
+## `Esse::Index.pagy_search`
+
+Module: `Esse::Pagy::IndexSearch` (extended into `Esse::Index`).
+
+### `.pagy_search(q = nil, **kwargs, &block) → Array`
+
+Returns `[cluster, self, { q: q, **kwargs }, block]` — a **description** of what to search, not an actual search.
+
+```ruby
+args = UsersIndex.pagy_search(body: { query: { match_all: {} } })
+# => [UsersIndex.cluster, UsersIndex, { body: {...} }, nil]
+```
+
+Alias configurable via `Pagy::DEFAULT[:esse_pagy_search]` (default: `:pagy_search`).
+
+---
+
+## `Esse::Cluster#pagy_search`
+
+Module: `Esse::Pagy::ClusterSearch` (prepended into `Esse::Cluster`).
+
+### `#pagy_search(*indices, **kwargs, &block) → Array`
+
+Returns `[self, indices, kwargs, block]`.
+
+```ruby
+Esse.cluster.pagy_search(CitiesIndex, CountiesIndex, body: { ... })
+```
+
+Indices can be classes, strings, or wildcard patterns.
+
+---
+
+## `Pagy.new_from_esse`
+
+Module: `Esse::Pagy::ClassMethods` (extended into `Pagy`).
+
+### `Pagy.new_from_esse(query, vars = {}) → Pagy`
+
+Builds a Pagy instance from an already-executed `Esse::Search::Query`.
+
+```ruby
+query = UsersIndex.search(body: body).limit(10).offset(20)
+pagy  = Pagy.new_from_esse(query)
+```
+
+Internally:
+
+```ruby
+vars[:count] = query.response.total
+vars[:page]  = (query.offset_value / query.limit_value.to_f).ceil + 1
+vars[:items] = query.limit_value
+Pagy.new(vars)
+```
+
+---
+
+## `Pagy::Backend#pagy_esse`
+
+Module: `Esse::Pagy::Backend` (prepended into `Pagy::Backend`).
+
+### `#pagy_esse(pagy_search_args, vars = {}) → [Pagy, Esse::Search::Query]`
+
+Executes the deferred search with pagination applied.
+
+```ruby
+@pagy, @response = pagy_esse(UsersIndex.pagy_search(body: body), items: 10)
+```
+
+Flow:
+
+1. Extract `cluster, indices, kwargs, block` from the description.
+2. Merge pagination vars with `params` (uses `Pagy::DEFAULT[:page_param]` and `Pagy::DEFAULT[:items]`).
+3. Build the query by calling the search method (default `.search`, configurable via `Pagy::DEFAULT[:esse_search]`) and applying `.limit(items).offset((page - 1) * items)`.
+4. Extract total count from `query.response.total`.
+5. Construct a `Pagy` instance.
+6. Handle `overflow: :last_page` if `Pagy::OverflowExtra` is loaded.
+7. Return `[pagy, query]`.
+
+### `#pagy_esse_get_vars(_query, vars)`
+
+Helper: merges Pagy configuration and request params into the vars hash.
+
+| Precedence (high → low) | Source |
+|-------------------------|--------|
+| Explicit `vars[:page]` / `vars[:items]` | caller |
+| `params[page_param]`, `params[:items]` | request |
+| `Pagy::DEFAULT[:items]` | config |
+
+---
+
+## Pagy configuration keys used
+
+| Key | Default | Purpose |
+|-----|---------|---------|
+| `Pagy::DEFAULT[:esse_search]` | `:search` | Name of the search method to call (`.search` by default) |
+| `Pagy::DEFAULT[:esse_pagy_search]` | `:pagy_search` | Alias name for the deferred-search method |
+| `Pagy::DEFAULT[:items]` | Pagy default | Items per page fallback |
+| `Pagy::DEFAULT[:page_param]` | `:page` | Request parameter name for page |
+
+---
+
+## Integration summary
+
+On load:
+
+```ruby
+Esse::Index.extend(Esse::Pagy::IndexSearch)
+Esse::Cluster.prepend(Esse::Pagy::ClusterSearch)
+Pagy::Backend.prepend(Esse::Pagy::Backend)
+Pagy.extend(Esse::Pagy::ClassMethods)
+```
+
+No configuration is required beyond whatever Pagy setup you already have.

data/docs/usage.md

@@ -0,0 +1,140 @@
+# Usage Guide
+
+## Installation
+
+```ruby
+# Gemfile
+gem 'esse'
+gem 'pagy'
+gem 'esse-pagy'
+```
+
+Loading the gem:
+
+- Extends every `Esse::Index` with `pagy_search`.
+- Prepends `pagy_search` into `Esse::Cluster`.
+- Adds `pagy_esse` to `Pagy::Backend` (already included in your controllers).
+- Adds `Pagy.new_from_esse`.
+
+No initializer needed.
+
+## Basic controller usage
+
+```ruby
+class UsersController < ApplicationController
+  def index
+    @pagy, @response = pagy_esse(
+      UsersIndex.pagy_search(body: { query: { match_all: {} } }),
+      items: 10
+    )
+  end
+end
+```
+
+- `UsersIndex.pagy_search(...)` returns a deferred "search description" (it does **not** execute a query).
+- `pagy_esse(description, **vars)` executes the search with the pagination info pulled from `params` (or provided `vars`) and returns `[pagy_instance, query_or_response]`.
+
+## Rendering
+
+```erb
+<%== pagy_nav(@pagy) %>
+
+<% @response.results.each do |hit| %>
+  <%= hit.dig('_source', 'name') %>
+<% end %>
+```
+
+## Multiple indices / cluster search
+
+Use `Esse.cluster.pagy_search`:
+
+```ruby
+@pagy, @response = pagy_esse(
+  Esse.cluster.pagy_search(CitiesIndex, CountiesIndex, body: body),
+  items: 20
+)
+```
+
+You can also pass wildcard index names:
+
+```ruby
+@pagy, @response = pagy_esse(
+  Esse.cluster.pagy_search('geos_*', body: { query: { match_all: {} } }),
+  items: 15
+)
+```
+
+## Passing a query-modification block
+
+The block is forwarded to the underlying `search` call:
+
+```ruby
+@pagy, @response = pagy_esse(
+  UsersIndex.pagy_search("*") { |query| query.filter('status', 'active') },
+  items: 10
+)
+```
+
+## Reading params
+
+By default `pagy_esse` reads `params[:page]` and `params[:items]`:
+
+```
+/users?page=2&items=25
+```
+
+Override by passing `vars`:
+
+```ruby
+pagy_esse(description, page: 3, items: 50)
+```
+
+Pagy's standard configuration applies:
+
+```ruby
+# config/initializers/pagy.rb
+Pagy::DEFAULT[:items] = 20
+Pagy::DEFAULT[:page_param] = :p
+```
+
+## Creating a Pagy from an executed query
+
+If you have a query already executed, use:
+
+```ruby
+query = UsersIndex.search(body: body).limit(10).offset(20)
+pagy  = Pagy.new_from_esse(query)
+
+# pagy.page  => 3
+# pagy.items => 10
+# pagy.count => total hits
+```
+
+## Overflow handling
+
+With `Pagy::OverflowExtra` loaded:
+
+```ruby
+@pagy, @response = pagy_esse(description, items: 10, overflow: :last_page)
+```
+
+When the requested page is beyond the available pages, Pagy falls back to the last valid page instead of raising `Pagy::OverflowError`.
+
+## Customizing method names
+
+The default method is `pagy_search`, aliased from `pagy_esse`. Change the alias name via Pagy's defaults:
+
+```ruby
+Pagy::DEFAULT[:esse_pagy_search] = :my_method
+```
+
+Now call `UsersIndex.my_method(...)` and `Esse.cluster.my_method(...)`.
+
+## Comparing to esse-kaminari
+
+| Aspect | esse-pagy | esse-kaminari |
+|--------|-----------|---------------|
+| Style | Controller backend | Chainable query methods |
+| Multi-index | Built-in via cluster | Single-index focus |
+| Execution | Deferred until `pagy_esse` | Lazy until `.response` |
+| Best for | Rails controllers, multi-index | Service objects, single-index |

data/gemfiles/Gemfile.pagy-43

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+source "https://rubygems.org"
+
+gem "pagy", "~> 43.0"
+gem "esse", "~> 0.2.4"
+gem "esse-rspec", "~> 0.0.1"
+
+group :test do
+  gem "activesupport"
+  gem "rack"
+  gem "rake-manifest"
+end
+
+# Specify your gem's dependencies in esse-pagy.gemspec
+gemspec path: ".."

data/gemfiles/Gemfile.pagy-43.lock

@@ -0,0 +1,202 @@
+PATH
+  remote: ..
+  specs:
+    esse-pagy (0.43.0)
+      esse (>= 0.2.4)
+      pagy (>= 5)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    activesupport (8.1.3)
+      base64
+      bigdecimal
+      concurrent-ruby (~> 1.0, >= 1.3.1)
+      connection_pool (>= 2.2.5)
+      drb
+      i18n (>= 1.6, < 2)
+      json
+      logger (>= 1.4.2)
+      minitest (>= 5.1)
+      securerandom (>= 0.3)
+      tzinfo (~> 2.0, >= 2.0.5)
+      uri (>= 0.13.1)
+    ast (2.4.3)
+    base64 (0.3.0)
+    bigdecimal (4.1.2)
+    coderay (1.1.3)
+    concurrent-ruby (1.3.7)
+    connection_pool (3.0.2)
+    diff-lcs (1.6.2)
+    drb (2.2.3)
+    esse (0.2.6)
+      multi_json
+      thor (>= 0.19)
+    esse-rspec (0.0.6)
+      esse (>= 0.2.4)
+      rspec (>= 3)
+    i18n (1.15.2)
+      concurrent-ruby (~> 1.0)
+    io-console (0.8.2)
+    json (2.20.0)
+    language_server-protocol (3.17.0.5)
+    lint_roller (1.1.0)
+    logger (1.7.0)
+    method_source (1.1.0)
+    minitest (6.0.6)
+      drb (~> 2.0)
+      prism (~> 1.5)
+    multi_json (1.21.1)
+    pagy (43.5.6)
+      json
+      uri
+      yaml
+    parallel (2.1.0)
+    parser (3.3.11.1)
+      ast (~> 2.4.1)
+      racc
+    prism (1.9.0)
+    pry (0.16.0)
+      coderay (~> 1.1)
+      method_source (~> 1.0)
+      reline (>= 0.6.0)
+    racc (1.8.1)
+    rack (3.2.6)
+    rainbow (3.1.1)
+    rake-manifest (0.2.4)
+    regexp_parser (2.12.0)
+    reline (0.6.3)
+      io-console (~> 0.5)
+    rspec (3.13.2)
+      rspec-core (~> 3.13.0)
+      rspec-expectations (~> 3.13.0)
+      rspec-mocks (~> 3.13.0)
+    rspec-core (3.13.6)
+      rspec-support (~> 3.13.0)
+    rspec-expectations (3.13.5)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.13.0)
+    rspec-mocks (3.13.8)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.13.0)
+    rspec-support (3.13.7)
+    rubocop (1.88.0)
+      json (~> 2.3)
+      language_server-protocol (~> 3.17.0.2)
+      lint_roller (~> 1.1.0)
+      parallel (>= 1.10)
+      parser (>= 3.3.0.2)
+      rainbow (>= 2.2.2, < 4.0)
+      regexp_parser (>= 2.9.3, < 3.0)
+      rubocop-ast (>= 1.49.0, < 2.0)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (>= 2.4.0, < 4.0)
+    rubocop-ast (1.49.1)
+      parser (>= 3.3.7.2)
+      prism (~> 1.7)
+    rubocop-performance (1.26.1)
+      lint_roller (~> 1.1)
+      rubocop (>= 1.75.0, < 2.0)
+      rubocop-ast (>= 1.47.1, < 2.0)
+    rubocop-rspec (3.10.2)
+      lint_roller (~> 1.1)
+      regexp_parser (>= 2.0)
+      rubocop (~> 1.86, >= 1.86.2)
+    ruby-progressbar (1.13.0)
+    securerandom (0.4.1)
+    standard (1.35.0.1)
+      language_server-protocol (~> 3.17.0.2)
+      lint_roller (~> 1.0)
+      rubocop (~> 1.62)
+      standard-custom (~> 1.0.0)
+      standard-performance (~> 1.3)
+    standard-custom (1.0.2)
+      lint_roller (~> 1.0)
+      rubocop (~> 1.50)
+    standard-performance (1.9.0)
+      lint_roller (~> 1.1)
+      rubocop-performance (~> 1.26.0)
+    thor (1.5.0)
+    tzinfo (2.0.6)
+      concurrent-ruby (~> 1.0)
+    unicode-display_width (3.2.0)
+      unicode-emoji (~> 4.1)
+    unicode-emoji (4.2.0)
+    uri (1.1.1)
+    yaml (0.4.0)
+
+PLATFORMS
+  ruby
+  x86_64-linux
+
+DEPENDENCIES
+  activesupport
+  esse (~> 0.2.4)
+  esse-pagy!
+  esse-rspec (~> 0.0.1)
+  pagy (~> 43.0)
+  pry
+  rack
+  rake-manifest
+  rspec
+  rubocop
+  rubocop-performance
+  rubocop-rspec
+  standard
+
+CHECKSUMS
+  activesupport (8.1.3) sha256=21a5e0dfbd4c3ddd9e1317ec6a4d782fa226e7867dc70b0743acda81a1dca20e
+  ast (2.4.3) sha256=954615157c1d6a382bc27d690d973195e79db7f55e9765ac7c481c60bdb4d383
+  base64 (0.3.0) sha256=27337aeabad6ffae05c265c450490628ef3ebd4b67be58257393227588f5a97b
+  bigdecimal (4.1.2) sha256=53d217666027eab4280346fba98e7d5b66baaae1b9c3c1c0ffe89d48188a3fbd
+  coderay (1.1.3) sha256=dc530018a4684512f8f38143cd2a096c9f02a1fc2459edcfe534787a7fc77d4b
+  concurrent-ruby (1.3.7) sha256=4412caec3a5ea2e5fdc52076724c071a81f2c0593d83b2ac8cbb8ca63b3151b0
+  connection_pool (3.0.2) sha256=33fff5ba71a12d2aa26cb72b1db8bba2a1a01823559fb01d29eb74c286e62e0a
+  diff-lcs (1.6.2) sha256=9ae0d2cba7d4df3075fe8cd8602a8604993efc0dfa934cff568969efb1909962
+  drb (2.2.3) sha256=0b00d6fdb50995fe4a45dea13663493c841112e4068656854646f418fda13373
+  esse (0.2.6) sha256=0cada03f5230ea4637add87e918d3b4e88c9c46e4e560c57ad7878f4b3793486
+  esse-pagy (0.43.0)
+  esse-rspec (0.0.6) sha256=7f373949721ffc45fec44fc4946cce77ea7fb07bafb603584e1ff4b08c5ccfd6
+  i18n (1.15.2) sha256=00f9eb62412fe593b2a65a97daa75300d37abb8f7202ec748e94b6d46a9dd1b5
+  io-console (0.8.2) sha256=d6e3ae7a7cc7574f4b8893b4fca2162e57a825b223a177b7afa236c5ef9814cc
+  json (2.20.0) sha256=9362bc6e55a952b056abf9167cf053358181c904cb70cd6eee0808ea830fc32b
+  language_server-protocol (3.17.0.5) sha256=fd1e39a51a28bf3eec959379985a72e296e9f9acfce46f6a79d31ca8760803cc
+  lint_roller (1.1.0) sha256=2c0c845b632a7d172cb849cc90c1bce937a28c5c8ccccb50dfd46a485003cc87
+  logger (1.7.0) sha256=196edec7cc44b66cfb40f9755ce11b392f21f7967696af15d274dde7edff0203
+  method_source (1.1.0) sha256=181301c9c45b731b4769bc81e8860e72f9161ad7d66dd99103c9ab84f560f5c5
+  minitest (6.0.6) sha256=153ea36d1d987a62942382b61075745042a2b3123b1cd48f4c3675af9cc7d6f1
+  multi_json (1.21.1) sha256=e6126a31808e3b4d19f483c775ceac34df190dffa62adfb63a165ee14ba68080
+  pagy (43.5.6) sha256=4d46d262826e055d69713fbbd2c42257cc1d0e87c13a1221764c15d30e46ff85
+  parallel (2.1.0) sha256=b35258865c2e31134c5ecb708beaaf6772adf9d5efae28e93e99260877b09356
+  parser (3.3.11.1) sha256=d17ace7aabe3e72c3cc94043714be27cc6f852f104d81aa284c2281aecc65d54
+  prism (1.9.0) sha256=7b530c6a9f92c24300014919c9dcbc055bf4cdf51ec30aed099b06cd6674ef85
+  pry (0.16.0) sha256=d76c69065698ed1f85e717bd33d7942c38a50868f6b0673c636192b3d1b6054e
+  racc (1.8.1) sha256=4a7f6929691dbec8b5209a0b373bc2614882b55fc5d2e447a21aaa691303d62f
+  rack (3.2.6) sha256=5ed78e1f73b2e25679bec7d45ee2d4483cc4146eb1be0264fc4d94cb5ef212c2
+  rainbow (3.1.1) sha256=039491aa3a89f42efa1d6dec2fc4e62ede96eb6acd95e52f1ad581182b79bc6a
+  rake-manifest (0.2.4) sha256=a53781f6100f37fcc33e9518b65b025111e0d17be894fa3bc319888552a28970
+  regexp_parser (2.12.0) sha256=35a916a1d63190ab5c9009457136ae5f3c0c7512d60291d0d1378ba18ce08ebb
+  reline (0.6.3) sha256=1198b04973565b36ec0f11542ab3f5cfeeec34823f4e54cebde90968092b1835
+  rspec (3.13.2) sha256=206284a08ad798e61f86d7ca3e376718d52c0bc944626b2349266f239f820587
+  rspec-core (3.13.6) sha256=a8823c6411667b60a8bca135364351dda34cd55e44ff94c4be4633b37d828b2d
+  rspec-expectations (3.13.5) sha256=33a4d3a1d95060aea4c94e9f237030a8f9eae5615e9bd85718fe3a09e4b58836
+  rspec-mocks (3.13.8) sha256=086ad3d3d17533f4237643de0b5c42f04b66348c28bf6b9c2d3f4a3b01af1d47
+  rspec-support (3.13.7) sha256=0640e5570872aafefd79867901deeeeb40b0c9875a36b983d85f54fb7381c47c
+  rubocop (1.88.0) sha256=e420ddf1662d0ef34bc8a2910ac4b396a7ddda0b51a708264405241734b08e0b
+  rubocop-ast (1.49.1) sha256=4412f3ee70f6fe4546cc489548e0f6fcf76cafcfa80fa03af67098ffed755035
+  rubocop-performance (1.26.1) sha256=cd19b936ff196df85829d264b522fd4f98b6c89ad271fa52744a8c11b8f71834
+  rubocop-rspec (3.10.2) sha256=0b3e2ecc592cd10ecbf0095bb58d1e357905276e069643523cc19eb7495f65e2
+  ruby-progressbar (1.13.0) sha256=80fc9c47a9b640d6834e0dc7b3c94c9df37f08cb072b7761e4a71e22cff29b33
+  securerandom (0.4.1) sha256=cc5193d414a4341b6e225f0cb4446aceca8e50d5e1888743fac16987638ea0b1
+  standard (1.35.0.1) sha256=ec8992af82aede242b86755970336fe481e2264d23e96de3da7eb28101601e97
+  standard-custom (1.0.2) sha256=424adc84179a074f1a2a309bb9cf7cd6bfdb2b6541f20c6bf9436c0ba22a652b
+  standard-performance (1.9.0) sha256=49483d31be448292951d80e5e67cdcb576c2502103c7b40aec6f1b6e9c88e3f2
+  thor (1.5.0) sha256=e3a9e55fe857e44859ce104a84675ab6e8cd59c650a49106a05f55f136425e73
+  tzinfo (2.0.6) sha256=8daf828cc77bcf7d63b0e3bdb6caa47e2272dcfaf4fbfe46f8c3a9df087a829b
+  unicode-display_width (3.2.0) sha256=0cdd96b5681a5949cdbc2c55e7b420facae74c4aaf9a9815eee1087cb1853c42
+  unicode-emoji (4.2.0) sha256=519e69150f75652e40bf736106cfbc8f0f73aa3fb6a65afe62fefa7f80b0f80f
+  uri (1.1.1) sha256=379fa58d27ffb1387eaada68c749d1426738bd0f654d812fcc07e7568f5c57c6
+  yaml (0.4.0) sha256=240e69d1e6ce3584d6085978719a0faa6218ae426e034d8f9b02fb54d3471942
+
+BUNDLED WITH
+  4.0.7

data/gemfiles/Gemfile.pagy-5.lock

@@ -1,7 +1,7 @@
 PATH
   remote: ..
   specs:
-    esse-pagy (0.0.2)
+    esse-pagy (0.43.0)
       esse (>= 0.2.4)
       pagy (>= 5)
 

data/gemfiles/Gemfile.pagy-6.lock

@@ -1,7 +1,7 @@
 PATH
   remote: ..
   specs:
-    esse-pagy (0.0.2)
+    esse-pagy (0.43.0)
       esse (>= 0.2.4)
       pagy (>= 5)
 

data/gemfiles/Gemfile.pagy-7.lock

@@ -1,7 +1,7 @@
 PATH
   remote: ..
   specs:
-    esse-pagy (0.0.2)
+    esse-pagy (0.43.0)
       esse (>= 0.2.4)
       pagy (>= 5)
 

data/gemfiles/Gemfile.pagy-8.lock

@@ -1,7 +1,7 @@
 PATH
   remote: ..
   specs:
-    esse-pagy (0.0.2)
+    esse-pagy (0.43.0)
       esse (>= 0.2.4)
       pagy (>= 5)
 

data/gemfiles/Gemfile.pagy-9.lock

@@ -1,7 +1,7 @@
 PATH
   remote: ..
   specs:
-    esse-pagy (0.0.2)
+    esse-pagy (0.43.0)
       esse (>= 0.2.4)
       pagy (>= 5)
 

data/lib/esse/pagy.rb

@@ -3,8 +3,14 @@
 require "esse"
 require "pagy"
 
-::Pagy::DEFAULT[:esse_search] ||= :search
-::Pagy::DEFAULT[:esse_pagy_search] ||= :pagy_search
+# Pagy < 43 ships a mutable DEFAULT and a Backend mixin used by the
+# `pagy_esse`/`pagy_search` controller helpers. Pagy 43 froze DEFAULT, removed
+# the Backend mixin, and split paginators into Pagy::Offset/Keyset/Search.
+# Only register the controller-helper defaults where they apply.
+unless ::Pagy::DEFAULT.frozen?
+  ::Pagy::DEFAULT[:esse_search] ||= :search
+  ::Pagy::DEFAULT[:esse_pagy_search] ||= :pagy_search
+end
 
 # I'll try to move this to the `pagy` gem. But we need to wait for the `pagy` author to accept the PR.
 # @see https://github.com/ddnexus/pagy/blob/master/lib/pagy/extras/elasticsearch_rails.rb
@@ -18,7 +24,7 @@ module Esse
           args.define_singleton_method(:method_missing) { |*a| args += a }
         end
       end
-      alias_method ::Pagy::DEFAULT[:esse_pagy_search], :pagy_esse
+      alias_method :pagy_search, :pagy_esse
     end
 
     module ClusterSearch
@@ -27,7 +33,7 @@ module Esse
           args.define_singleton_method(:method_missing) { |*a| args += a }
         end
       end
-      alias_method ::Pagy::DEFAULT[:esse_pagy_search], :pagy_esse
+      alias_method :pagy_search, :pagy_esse
     end
 
     module ClassMethods
@@ -36,7 +42,10 @@ module Esse
         vars[:page] = (query.offset_value / query.limit_value.to_f).ceil + 1
         vars[:limit] = query.limit_value
 
-        if ::Pagy::VERSION.to_i < 9
+        if defined?(::Pagy::Offset)
+          # Pagy 43+: bare Pagy is abstract; offset pagination is Pagy::Offset.
+          ::Pagy::Offset.new(**vars)
+        elsif ::Pagy::VERSION.to_i < 9
           # Convert :limit back to :items for older Pagy versions
           vars[:items] = vars.delete(:limit)
           ::Pagy.new(vars)
@@ -46,7 +55,8 @@ module Esse
       end
     end
 
-    # Add specialized backend methods to paginate Esse::Search::Query
+    # Add specialized backend methods to paginate Esse::Search::Query.
+    # Only relevant on Pagy versions that still ship Pagy::Backend (< 43).
     module Backend
       private
 
@@ -95,7 +105,13 @@ module Esse
   end
 end
 
-::Pagy::Backend.prepend(Esse::Pagy::Backend)
 ::Pagy.extend(Esse::Pagy::ClassMethods)
 ::Esse::Index.extend(Esse::Pagy::IndexSearch)
 ::Esse::Cluster.prepend(Esse::Pagy::ClusterSearch)
+# Pagy::Backend was removed in Pagy 43; reference it (autoloads on older Pagy)
+# and skip the integration when it is gone.
+begin
+  ::Pagy::Backend.prepend(Esse::Pagy::Backend)
+rescue NameError
+  nil
+end

data/mise.toml

@@ -1,2 +1,2 @@
 [tools]
-ruby = "2.7.8"
+ruby = "3.4.8"

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: esse-pagy
 version: !ruby/object:Gem::Version
-  version: 0.0.2
+  version: 0.43.0
 platform: ruby
 authors:
 - Marcos G. Zimmermann
-autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-09-26 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: esse
@@ -135,6 +134,11 @@ files:
 - Gemfile.lock
 - LICENSE
 - README.md
+- docs/README.md
+- docs/api.md
+- docs/usage.md
+- gemfiles/Gemfile.pagy-43
+- gemfiles/Gemfile.pagy-43.lock
 - gemfiles/Gemfile.pagy-5
 - gemfiles/Gemfile.pagy-5.lock
 - gemfiles/Gemfile.pagy-6
@@ -154,7 +158,6 @@ metadata:
   homepage_uri: https://github.com/marcosgz/esse-pagy
   source_code_uri: https://github.com/marcosgz/esse-pagy
   changelog_uri: https://github.com/marcosgz/esse-pagy/blob/main/CHANGELOG.md
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -169,8 +172,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.22
-signing_key:
+rubygems_version: 3.6.9
 specification_version: 4
 summary: Pagy extensions for Esse
 test_files: []