respondo 1.0.0 → 2.1.0

data/lib/respondo/controller_helpers.rb

@@ -4,20 +4,39 @@ module Respondo
   # Mixed into Rails controllers to provide render_success and render_error.
   #
   # Success helpers (2xx):
-  #   render_success, render_created, render_accepted, render_no_content,
-  #   render_partial_content, render_multi_status
+  #   render_success, render_ok, render_created, render_accepted,
+  #   render_non_authoritative, render_no_content, render_reset_content,
+  #   render_partial_content, render_multi_status, render_already_reported,
+  #   render_im_used
+  #
+  # Informational helpers (1xx):
+  #   render_continue, render_switching_protocols, render_processing,
+  #   render_early_hints
+  #
+  # Redirect helpers (3xx):
+  #   render_multiple_choices, render_moved_permanently, render_found,
+  #   render_see_other, render_not_modified, render_temporary_redirect,
+  #   render_permanent_redirect
   #
   # Client error helpers (4xx):
   #   render_bad_request, render_unauthorized, render_payment_required,
   #   render_forbidden, render_not_found, render_method_not_allowed,
-  #   render_not_acceptable, render_conflict, render_gone,
-  #   render_unprocessable, render_too_many_requests, render_locked,
-  #   render_precondition_failed, render_unsupported_media_type,
-  #   render_request_timeout
+  #   render_not_acceptable, render_proxy_auth_required, render_request_timeout,
+  #   render_conflict, render_gone, render_length_required,
+  #   render_precondition_failed, render_payload_too_large, render_uri_too_long,
+  #   render_unsupported_media_type, render_range_not_satisfiable,
+  #   render_expectation_failed, render_im_a_teapot, render_misdirected_request,
+  #   render_unprocessable, render_locked, render_failed_dependency,
+  #   render_too_early, render_upgrade_required, render_precondition_required,
+  #   render_too_many_requests, render_request_header_fields_too_large,
+  #   render_unavailable_for_legal_reasons
   #
   # Server error helpers (5xx):
   #   render_server_error, render_not_implemented, render_bad_gateway,
-  #   render_service_unavailable, render_gateway_timeout
+  #   render_service_unavailable, render_gateway_timeout,
+  #   render_http_version_not_supported, render_variant_also_negotiates,
+  #   render_insufficient_storage, render_loop_detected, render_not_extended,
+  #   render_network_authentication_required
   module ControllerHelpers
 
     # =========================================================================
@@ -29,19 +48,19 @@ module Respondo
     # @param data       [Object]          payload — AR model, collection, Hash, Array, nil
     # @param message    [String]          human-readable description
     # @param meta       [Hash]            extra meta fields merged into the meta block
-    # @param pagy       [Pagy]            optional Pagy object (pass when using Pagy backend)
-    # @param pagination [Boolean]         true  = include pagination meta when available (default)
-    #                                     false = always suppress pagination meta
+    # @param pagination [Hash, nil]       pagination hash built by the caller, e.g.
+    #                                     { current_page: 1, per_page: 25, total_pages: 4,
+    #                                       total_count: 100, next_page: 2, prev_page: nil }
+    #                                     Pass nil (default) to omit pagination from meta.
     # @param status     [Symbol, Integer] HTTP status (default: :ok / 200)
-    def render_success(data: nil, message: nil, meta: {}, code: nil, pagy: nil, pagination: true, status: :ok)
-      merged_meta  = code ? meta.merge(code: code, status: status) : meta
+    def render_success(data: nil, message: nil, meta: {}, code: nil, pagination: nil, status: :ok)
+      merged_meta = code ? meta.merge(code: code, status: status) : meta
 
       payload = ResponseBuilder.new(
         success:    true,
         data:       data,
         message:    message,
         meta:       merged_meta,
-        pagy:       pagy,
         pagination: pagination,
         request:    try(:request)
       ).build
@@ -67,46 +86,132 @@ module Respondo
         message:    message,
         meta:       merged_meta,
         errors:     extracted_errors,
-        pagination: false,
         request:    try(:request)
       ).build
 
       render json: payload, status: status
     end
 
+    # =========================================================================
+    # 1xx Informational helpers
+    # NOTE: 1xx responses are protocol-level and don't carry a body in HTTP/1.1.
+    # These helpers return a JSON body for API consistency / logging purposes,
+    # but most HTTP clients will not receive them as normal responses.
+    # =========================================================================
+
+    # 100 Continue
+    def render_continue(message: "Continue", meta: {})
+      render_success(data: nil, message: message, meta: meta, code: 100, status: :continue)
+    end
+
+    # 101 Switching Protocols
+    def render_switching_protocols(message: "Switching protocols", meta: {})
+      render_success(data: nil, message: message, meta: meta, code: 101, status: :switching_protocols)
+    end
+
+    # 102 Processing (WebDAV)
+    def render_processing(message: "Processing", meta: {})
+      render_success(data: nil, message: message, meta: meta, code: 102, status: :processing)
+    end
+
+    # 103 Early Hints
+    def render_early_hints(message: "Early hints", meta: {})
+      render_success(data: nil, message: message, meta: meta, code: 103, status: :early_hints)
+    end
+
     # =========================================================================
     # 2xx Success helpers
     # =========================================================================
 
     # 200 OK — alias for render_success with no pagination (single record)
-    def render_ok(data: nil, message: nil, meta: {}, pagination: true)
-      render_success(data: data, message: message, meta: meta, pagination: pagination, code:200, status: :ok)
+    def render_ok(data: nil, message: nil, meta: {}, pagination: nil)
+      render_success(data: data, message: message, meta: meta, pagination: pagination, code: 200, status: :ok)
     end
 
     # 201 Created
-    def render_created(data: nil, message: "Created successfully", pagination: false)
-      render_success(data: data, message: message, pagination: pagination, code:201, status: :created)
+    def render_created(data: nil, message: "Created successfully", meta: {}, pagination: nil)
+      render_success(data: data, message: message, meta: meta, pagination: pagination, code: 201, status: :created)
     end
 
     # 202 Accepted — async jobs, background processing
-    def render_accepted(data: nil, message: "Request accepted and is being processed")
-      render_success(data: data, message: message, pagination: false, code:202, status: :accepted)
+    def render_accepted(data: nil, message: "Request accepted and is being processed", meta: {}, pagination: nil)
+      render_success(data: data, message: message, meta: meta, pagination: pagination, code: 202, status: :accepted)
+    end
+
+    # 203 Non-Authoritative Information — response from a third-party cache/proxy
+    def render_non_authoritative(data: nil, message: "Non-authoritative information", meta: {}, pagination: nil)
+      render_success(data: data, message: message, meta: meta, pagination: pagination, code: 203, status: :non_authoritative_information)
     end
 
     # 204 No Content — deletions, actions with no response body
     # Note: we still return our standard JSON structure for consistency
-    def render_no_content(message: "Deleted successfully")
-      render_success(data: nil, message: message, pagination: false, code:204, status: :ok)
+    def render_no_content(message: "Deleted successfully", meta: {}, pagination: nil)
+      render_success(data: nil, message: message, meta: meta, pagination: pagination, code: 204, status: :ok)
+    end
+
+    # 205 Reset Content — tell the client to reset the document view
+    def render_reset_content(message: "Reset content", meta: {}, pagination: nil)
+      render_success(data: nil, message: message, meta: meta, pagination: pagination, code: 205, status: :reset_content)
     end
 
     # 206 Partial Content — chunked / range responses
-    def render_partial_content(data: nil, message: "Partial content returned", meta: {})
-      render_success(data: data, message: message, meta: meta, pagination: false, code:206, status: :partial_content)
+    def render_partial_content(data: nil, message: "Partial content returned", meta: {}, pagination: nil)
+      render_success(data: data, message: message, meta: meta, pagination: pagination, code: 206, status: :partial_content)
     end
 
-    # 207 Multi-Status — batch operations with mixed results
-    def render_multi_status(data: nil, message: "Multi-status response", meta: {})
-      render_success(data: data, message: message, meta: meta, pagination: false, code:207, status: :multi_status)
+    # 207 Multi-Status (WebDAV) — batch operations with mixed results
+    def render_multi_status(data: nil, message: "Multi-status response", meta: {}, pagination: nil)
+      render_success(data: data, message: message, meta: meta, pagination: pagination, code: 207, status: :multi_status)
+    end
+
+    # 208 Already Reported (WebDAV) — members already enumerated
+    def render_already_reported(data: nil, message: "Already reported", meta: {}, pagination: nil)
+      render_success(data: data, message: message, meta: meta, pagination: pagination, code: 208, status: :already_reported)
+    end
+
+    # 226 IM Used — instance manipulations applied
+    def render_im_used(data: nil, message: "IM used", meta: {}, pagination: nil)
+      render_success(data: data, message: message, meta: meta, pagination: pagination, code: 226, status: :im_used)
+    end
+
+    # =========================================================================
+    # 3xx Redirect helpers
+    # NOTE: Pass the target URL via meta: render_moved_permanently(meta: { redirect_url: new_url })
+    # =========================================================================
+
+    # 300 Multiple Choices
+    def render_multiple_choices(data: nil, message: "Multiple choices available", meta: {}, pagination: nil)
+      render_success(data: data, message: message, meta: meta, pagination: pagination, code: 300, status: :multiple_choices)
+    end
+
+    # 301 Moved Permanently
+    def render_moved_permanently(message: "Resource has moved permanently", meta: {}, pagination: nil)
+      render_success(data: nil, message: message, meta: meta, pagination: pagination, code: 301, status: :moved_permanently)
+    end
+
+    # 302 Found (temporary redirect)
+    def render_found(message: "Resource temporarily located elsewhere", meta: {}, pagination: nil)
+      render_success(data: nil, message: message, meta: meta, pagination: pagination, code: 302, status: :found)
+    end
+
+    # 303 See Other — redirect to another URI with GET
+    def render_see_other(message: "See other resource", meta: {}, pagination: nil)
+      render_success(data: nil, message: message, meta: meta, pagination: pagination, code: 303, status: :see_other)
+    end
+
+    # 304 Not Modified — client cache is still valid
+    def render_not_modified(message: "Resource not modified", meta: {}, pagination: nil)
+      render_success(data: nil, message: message, meta: meta, pagination: pagination, code: 304, status: :not_modified)
+    end
+
+    # 307 Temporary Redirect — repeat request with same method to new URL
+    def render_temporary_redirect(message: "Temporary redirect", meta: {}, pagination: nil)
+      render_success(data: nil, message: message, meta: meta, pagination: pagination, code: 307, status: :temporary_redirect)
+    end
+
+    # 308 Permanent Redirect — like 301 but method must not change
+    def render_permanent_redirect(message: "Permanent redirect", meta: {}, pagination: nil)
+      render_success(data: nil, message: message, meta: meta, pagination: pagination, code: 308, status: :permanent_redirect)
     end
 
     # =========================================================================
@@ -148,6 +253,11 @@ module Respondo
       render_error(message: message, errors: errors, meta: meta, code: 406, status: :not_acceptable)
     end
 
+    # 407 Proxy Authentication Required
+    def render_proxy_auth_required(message: "Proxy authentication required", errors: nil, meta: {})
+      render_error(message: message, errors: errors, meta: meta, code: 407, status: :proxy_authentication_required)
+    end
+
     # 408 Request Timeout
     def render_request_timeout(message: "Request timed out", errors: nil, meta: {})
       render_error(message: message, errors: errors, meta: meta, code: 408, status: :request_timeout)
@@ -163,16 +273,51 @@ module Respondo
       render_error(message: message, errors: errors, meta: meta, code: 410, status: :gone)
     end
 
+    # 411 Length Required — Content-Length header missing
+    def render_length_required(message: "Content-Length header required", errors: nil, meta: {})
+      render_error(message: message, errors: errors, meta: meta, code: 411, status: :length_required)
+    end
+
     # 412 Precondition Failed — conditional request failed
     def render_precondition_failed(message: "Precondition failed", errors: nil, meta: {})
       render_error(message: message, errors: errors, meta: meta, code: 412, status: :precondition_failed)
     end
 
+    # 413 Payload Too Large — request body exceeds server limit
+    def render_payload_too_large(message: "Payload too large", errors: nil, meta: {})
+      render_error(message: message, errors: errors, meta: meta, code: 413, status: :payload_too_large)
+    end
+
+    # 414 URI Too Long — request URI exceeds server limit
+    def render_uri_too_long(message: "URI too long", errors: nil, meta: {})
+      render_error(message: message, errors: errors, meta: meta, code: 414, status: :uri_too_long)
+    end
+
     # 415 Unsupported Media Type — wrong Content-Type header
     def render_unsupported_media_type(message: "Unsupported media type", errors: nil, meta: {})
       render_error(message: message, errors: errors, meta: meta, code: 415, status: :unsupported_media_type)
     end
 
+    # 416 Range Not Satisfiable — Range header cannot be fulfilled
+    def render_range_not_satisfiable(message: "Range not satisfiable", errors: nil, meta: {})
+      render_error(message: message, errors: errors, meta: meta, code: 416, status: :range_not_satisfiable)
+    end
+
+    # 417 Expectation Failed — Expect header cannot be met
+    def render_expectation_failed(message: "Expectation failed", errors: nil, meta: {})
+      render_error(message: message, errors: errors, meta: meta, code: 417, status: :expectation_failed)
+    end
+
+    # 418 I'm a Teapot — RFC 2324
+    def render_im_a_teapot(message: "I'm a teapot", errors: nil, meta: {})
+      render_error(message: message, errors: errors, meta: meta, code: 418, status: :im_a_teapot)
+    end
+
+    # 421 Misdirected Request — request sent to wrong server
+    def render_misdirected_request(message: "Misdirected request", errors: nil, meta: {})
+      render_error(message: message, errors: errors, meta: meta, code: 421, status: :misdirected_request)
+    end
+
     # 422 Unprocessable Entity — validation errors (most common for APIs)
     def render_unprocessable(message: "Validation failed", errors: nil, meta: {})
       render_error(message: message, errors: errors, meta: meta, code: 422, status: :unprocessable_content)
@@ -183,11 +328,41 @@ module Respondo
       render_error(message: message, errors: errors, meta: meta, code: 423, status: :locked)
     end
 
+    # 424 Failed Dependency (WebDAV) — previous request failed
+    def render_failed_dependency(message: "Failed dependency", errors: nil, meta: {})
+      render_error(message: message, errors: errors, meta: meta, code: 424, status: :failed_dependency)
+    end
+
+    # 425 Too Early — server unwilling to risk processing replayed request
+    def render_too_early(message: "Too early", errors: nil, meta: {})
+      render_error(message: message, errors: errors, meta: meta, code: 425, status: :too_early)
+    end
+
+    # 426 Upgrade Required — client must switch protocols
+    def render_upgrade_required(message: "Upgrade required", errors: nil, meta: {})
+      render_error(message: message, errors: errors, meta: meta, code: 426, status: :upgrade_required)
+    end
+
+    # 428 Precondition Required — request must be conditional
+    def render_precondition_required(message: "Precondition required", errors: nil, meta: {})
+      render_error(message: message, errors: errors, meta: meta, code: 428, status: :precondition_required)
+    end
+
     # 429 Too Many Requests — rate limiting
     def render_too_many_requests(message: "Too many requests. Please slow down.", errors: nil, meta: {})
       render_error(message: message, errors: errors, meta: meta, code: 429, status: :too_many_requests)
     end
 
+    # 431 Request Header Fields Too Large
+    def render_request_header_fields_too_large(message: "Request header fields too large", errors: nil, meta: {})
+      render_error(message: message, errors: errors, meta: meta, code: 431, status: :request_header_fields_too_large)
+    end
+
+    # 451 Unavailable for Legal Reasons — censored/DMCA etc.
+    def render_unavailable_for_legal_reasons(message: "Unavailable for legal reasons", errors: nil, meta: {})
+      render_error(message: message, errors: errors, meta: meta, code: 451, status: :unavailable_for_legal_reasons)
+    end
+
     # =========================================================================
     # 5xx Server error helpers
     # =========================================================================
@@ -217,6 +392,36 @@ module Respondo
       render_error(message: message, errors: errors, meta: meta, code: 504, status: :gateway_timeout)
     end
 
+    # 505 HTTP Version Not Supported
+    def render_http_version_not_supported(message: "HTTP version not supported", errors: nil, meta: {})
+      render_error(message: message, errors: errors, meta: meta, code: 505, status: :http_version_not_supported)
+    end
+
+    # 506 Variant Also Negotiates — server configuration error
+    def render_variant_also_negotiates(message: "Variant also negotiates", errors: nil, meta: {})
+      render_error(message: message, errors: errors, meta: meta, code: 506, status: :variant_also_negotiates)
+    end
+
+    # 507 Insufficient Storage (WebDAV)
+    def render_insufficient_storage(message: "Insufficient storage", errors: nil, meta: {})
+      render_error(message: message, errors: errors, meta: meta, code: 507, status: :insufficient_storage)
+    end
+
+    # 508 Loop Detected (WebDAV)
+    def render_loop_detected(message: "Loop detected", errors: nil, meta: {})
+      render_error(message: message, errors: errors, meta: meta, code: 508, status: :loop_detected)
+    end
+
+    # 510 Not Extended — further extensions needed
+    def render_not_extended(message: "Not extended", errors: nil, meta: {})
+      render_error(message: message, errors: errors, meta: meta, code: 510, status: :not_extended)
+    end
+
+    # 511 Network Authentication Required — must authenticate to access network
+    def render_network_authentication_required(message: "Network authentication required", errors: nil, meta: {})
+      render_error(message: message, errors: errors, meta: meta, code: 511, status: :network_authentication_required)
+    end
+
     private
 
     # Normalize errors into a plain Hash regardless of source type.

data/lib/respondo/response_builder.rb

@@ -17,24 +17,24 @@ module Respondo
   #   { timestamp: ISO8601 String }
   # Plus pagination keys when pagination: true and the data is a paginated collection.
   # Plus request_id when config.include_request_id is true.
+  # Plus pagination when a pagination hash is supplied by the caller.
   class ResponseBuilder
     # @param success    [Boolean]
     # @param data       [Object]   anything — serialized automatically
     # @param message    [String]
     # @param meta       [Hash]     caller-supplied extra meta (merged in)
     # @param errors     [Hash]     field-level errors (for 422 responses)
-    # @param pagy       [Pagy]     optional Pagy object for pagination meta
-    # @param pagination [Boolean]  true = include pagination meta (default),
-    #                              false = always suppress pagination meta
+    # @param pagination [Hash, nil] plain pagination hash supplied by the caller, e.g.
+    #                               { current_page: 1, per_page: 25, total_pages: 4,
+    #                                 total_count: 100, next_page: 2, prev_page: nil }
     # @param request    [Object]   ActionDispatch::Request (for request_id)
     def initialize(success:, data: nil, message: nil, meta: {}, errors: nil,
-                   pagy: nil, pagination: true, request: nil)
+                   pagination: nil, request: nil)
       @success    = success
       @raw_data   = data
       @message    = message
       @extra_meta = meta || {}
       @errors     = errors
-      @pagy       = pagy
       @pagination = pagination
       @request    = request
     end
@@ -85,14 +85,10 @@ module Respondo
       # 4. Caller-supplied meta (overrides defaults)
       meta.merge!(@extra_meta)
 
-      # 5. Pagination
-      if @pagination
-        pagination = @pagy ? Pagination.extract(@pagy) : Pagination.extract(@raw_data)
-        meta[:pagination] = pagination if pagination
-      end
+      # 5. Pagination — plain hash from the caller, placed last before code/status
+      meta[:pagination] = @pagination if @pagination.is_a?(Hash) && !@pagination.empty?
 
-      # 6. Code and status always last
-      # (these come from @extra_meta via render_error, so we re-pin them to the end)
+      # 6. Re-pin code and status to the very end
       code   = meta.delete(:code)
       status = meta.delete(:status)
       meta[:code]   = code   if code

data/lib/respondo/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Respondo
-  VERSION = "1.0.0"
+  VERSION = "2.1.0"
 end

data/lib/respondo.rb

@@ -3,7 +3,7 @@
 require_relative "respondo/version"
 require_relative "respondo/configuration"
 require_relative "respondo/serializer"
-require_relative "respondo/pagination"
+# require_relative "respondo/pagination"
 require_relative "respondo/response_builder"
 require_relative "respondo/controller_helpers"
 

data/respondo.gemspec

@@ -19,11 +19,20 @@ Gem::Specification.new do |spec|
   spec.license       = "MIT"
   spec.required_ruby_version = ">= 2.7.0"
 
+  spec.metadata = {
+    "homepage_uri" => spec.homepage,
+    "source_code_uri" => spec.homepage,
+    "changelog_uri" => "#{spec.homepage}/blob/main/CHANGELOG.md",
+    "bug_tracker_uri" => "#{spec.homepage}/auditron/issues",
+    "rubygems_mfa_required" => "true"
+  }
+
   spec.files = Dir["lib/**/*.rb", "README.md", "LICENSE.txt", "CHANGELOG.md", "respondo.gemspec"]
   spec.require_paths = ["lib"]
 
-  spec.add_development_dependency "rspec",        "~> 3.12"
-  spec.add_development_dependency "rake",         "~> 13.0"
-  spec.add_development_dependency "activesupport","~> 7.0"
-  spec.add_development_dependency 'simplecov', '~> 0.22'
+  spec.add_development_dependency "railties",        "~> 8.1.3"
+  spec.add_development_dependency "rspec",           "~> 3.12"
+  spec.add_development_dependency "rake",            "~> 13.0"
+  spec.add_development_dependency "activesupport",   "~> 8.1.3"
+  spec.add_development_dependency 'simplecov',       "~> 0.22"
 end

metadata

@@ -1,15 +1,29 @@
 --- !ruby/object:Gem::Specification
 name: respondo
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 2.1.0
 platform: ruby
 authors:
 - shailendra Kumar
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-04-03 00:00:00.000000000 Z
+date: 2026-04-13 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: railties
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 8.1.3
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 8.1.3
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
@@ -44,14 +58,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '7.0'
+        version: 8.1.3
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '7.0'
+        version: 8.1.3
 - !ruby/object:Gem::Dependency
   name: simplecov
   requirement: !ruby/object:Gem::Requirement
@@ -80,10 +94,10 @@ files:
 - CHANGELOG.md
 - LICENSE.txt
 - README.md
+- lib/generators/respondo/install/install_generator.rb
 - lib/respondo.rb
 - lib/respondo/configuration.rb
 - lib/respondo/controller_helpers.rb
-- lib/respondo/pagination.rb
 - lib/respondo/railtie.rb
 - lib/respondo/response_builder.rb
 - lib/respondo/serializer.rb
@@ -92,7 +106,12 @@ files:
 homepage: https://github.com/spatelpatidar/respondo
 licenses:
 - MIT
-metadata: {}
+metadata:
+  homepage_uri: https://github.com/spatelpatidar/respondo
+  source_code_uri: https://github.com/spatelpatidar/respondo
+  changelog_uri: https://github.com/spatelpatidar/respondo/blob/main/CHANGELOG.md
+  bug_tracker_uri: https://github.com/spatelpatidar/respondo/auditron/issues
+  rubygems_mfa_required: 'true'
 post_install_message:
 rdoc_options: []
 require_paths:

data/lib/respondo/pagination.rb

@@ -1,94 +0,0 @@
-# frozen_string_literal: true
-
-module Respondo
-  # Extracts pagination metadata from Kaminari or Pagy collection objects.
-  #
-  # Returned hash shape (always the same regardless of pagination library):
-  #   {
-  #     current_page:  Integer,
-  #     per_page:      Integer,
-  #     total_pages:   Integer,
-  #     total_count:   Integer,
-  #     next_page:     Integer | nil,
-  #     prev_page:     Integer | nil
-  #   }
-  module Pagination
-    module_function
-
-    # @param collection [Object] any object — returns nil if not a paginated collection
-    # @return [Hash, nil]
-    def extract(collection)
-      return nil if collection.nil?
-
-      if pagy?(collection)
-        from_pagy(collection)
-      elsif kaminari?(collection)
-        from_kaminari(collection)
-      elsif will_paginate?(collection)
-        from_will_paginate(collection)
-      else
-        nil
-      end
-    end
-
-    private
-
-    module_function
-
-    # ----- Pagy ---------------------------------------------------------------
-    # Pagy stores metadata on a separate Pagy object, not the collection itself.
-    # We support both: passing the Pagy object directly, or a collection that
-    # has been decorated with pagy metadata via pagy_metadata.
-    def pagy?(object)
-      defined?(Pagy) && object.is_a?(Pagy)
-    end
-
-    def from_pagy(pagy)
-      {
-        current_page: pagy.page,
-        per_page:     pagy.items,
-        total_pages:  pagy.pages,
-        total_count:  pagy.count,
-        next_page:    pagy.next,
-        prev_page:    pagy.prev
-      }
-    end
-
-    # ----- Kaminari -----------------------------------------------------------
-    def kaminari?(object)
-      object.respond_to?(:current_page) &&
-        object.respond_to?(:total_pages) &&
-        object.respond_to?(:limit_value)
-    end
-
-    def from_kaminari(collection)
-      {
-        current_page: collection.current_page,
-        per_page:     collection.limit_value,
-        total_pages:  collection.total_pages,
-        total_count:  collection.total_count,
-        next_page:    collection.next_page,
-        prev_page:    collection.prev_page
-      }
-    end
-
-    # ----- WillPaginate -------------------------------------------------------
-    def will_paginate?(object)
-      object.respond_to?(:current_page) &&
-        object.respond_to?(:total_pages) &&
-        object.respond_to?(:per_page) &&
-        !object.respond_to?(:limit_value) # distinguishes from Kaminari
-    end
-
-    def from_will_paginate(collection)
-      {
-        current_page: collection.current_page,
-        per_page:     collection.per_page,
-        total_pages:  collection.total_pages,
-        total_count:  collection.total_entries,
-        next_page:    collection.next_page,
-        prev_page:    collection.previous_page
-      }
-    end
-  end
-end