Adds separate configs for attributes and parameters

CHANGELOG.md

@@ -0,0 +1,30 @@
+# Changelog
+
+## [1.1.0] - 2026-03-25
+
+### Added
+
+- **`conversions` configuration** with independent `query_parameters` and `json_attributes` sub-keys. This allows APIs that use different naming conventions for query parameters vs JSON body attributes to be configured correctly:
+
+  ```ruby
+  module MyAPI
+    extend RestEasy
+
+    configure do
+      conversions.json_attributes = :camelCase
+      conversions.query_parameters = :PascalCase
+    end
+  end
+  ```
+
+- **Automatic query parameter key transformation.** `Resource.get` now transforms parameter keys according to the `query_parameters` convention before sending the request. This removes the need for manual `transform_keys` calls in consuming gems.
+
+- `conversions` can be overridden per Resource class, with inheritance falling back to the parent API module configuration.
+
+### Deprecated
+
+- **`attribute_convention`** is deprecated in favour of `conversions.json_attributes`. The old setting continues to work and is respected as a fallback, but emits a deprecation warning when used at the Resource level. Module-level `attribute_convention` is silently supported for backwards compatibility.
+
+## [1.0.0]
+
+Initial release.

Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    rest-easy (0.1.0)
+    rest-easy (1.1.0)
       dry-configurable (~> 0.14)
       dry-inflector (~> 0.2.1)
       dry-types (~> 1.2)

README.md

@@ -34,7 +34,7 @@ module Acme
   configure do
     base_url "https://api.acme.com/v1"
     authentication RestEasy::Auth::PSK.new(api_key: ENV["ACME_API_KEY"])
-    attribute_convention :PascalCase
+    conversions.json_attributes = :PascalCase
   end
 end
 
@@ -85,19 +85,21 @@ module Fortnox
     base_url "https://api.fortnox.se/3"
     max_retries 3
     authentication RestEasy::Auth::PSK.new(api_key: ENV["FORTNOX_KEY"])
-    attribute_convention :PascalCase
+    conversions.json_attributes = :PascalCase
+    conversions.query_parameters = :PascalCase
   end
 end
 ```
 
 ### Available settings
 
-| Setting                | Default                    | Description                              |
-|------------------------|----------------------------|------------------------------------------|
-| `base_url`             | `"https://example.com"`    | Base URL for all requests                |
-| `max_retries`          | `3`                        | Retry count on request failure           |
-| `authentication`       | `Auth::Null.new`           | Authentication strategy                  |
-| `attribute_convention` | `:PascalCase`              | Naming convention for API field mapping  |
+| Setting                          | Default                    | Description                                       |
+|----------------------------------|----------------------------|---------------------------------------------------|
+| `base_url`                       | `"https://example.com"`    | Base URL for all requests                         |
+| `max_retries`                    | `3`                        | Retry count on request failure                    |
+| `authentication`                 | `Auth::Null.new`           | Authentication strategy                           |
+| `conversions.json_attributes`    | `:snake_case`              | Naming convention for JSON response/request fields|
+| `conversions.query_parameters`   | `:snake_case`              | Naming convention for query parameter keys        |
 
 ### Faraday middleware
 
@@ -189,20 +191,35 @@ The full `Dry::Types` vocabulary is available inside resource bodies — `Strict
 
 ### Naming conventions
 
-RestEasy automatically maps between Ruby's `snake_case` attribute names and the API's naming convention:
+RestEasy automatically maps between Ruby's `snake_case` attribute names and the API's naming convention. The `conversions` config controls this independently for JSON attributes and query parameters:
 
 | Convention    | Ruby attr          | API field            |
 |---------------|--------------------|----------------------|
 | `:PascalCase` | `:document_number` | `"DocumentNumber"`   |
 | `:camelCase`  | `:document_number` | `"documentNumber"`   |
 | `:snake_case` | `:document_number` | `"document_number"`  |
 
-Set the convention at the module level (applies to all resources) or override per resource:
+Set conventions at the module level (applies to all resources):
 
 ```ruby
-attribute_convention :camelCase
+configure do
+  conversions.json_attributes = :camelCase
+  conversions.query_parameters = :PascalCase
+end
 ```
 
+Or override per resource:
+
+```ruby
+class MyAPI::Special < MyAPI::Resource
+  configure do
+    conversions.json_attributes = :PascalCase
+  end
+end
+```
+
+Query parameter keys are automatically transformed when calling `get` with `params:`. For example, with `query_parameters: :PascalCase`, `params: { sort_order: "asc" }` becomes `?SortOrder=asc` in the request.
+
 You can also provide a custom convention object with `parse(api_name)` and `serialise(model_name)` methods.
 
 ### Explicit name mapping
@@ -735,7 +752,7 @@ module MyAPI
     base_url "https://api.example.com/v1"
     max_retries 3
     authentication RestEasy::Auth::PSK.new(api_key: ENV["MY_API_KEY"])
-    attribute_convention :PascalCase
+    conversions.json_attributes = :PascalCase
   end
 end
 ```

lib/rest_easy.rb

@@ -83,6 +83,13 @@ def configure(&block)
         else
           yield self::Settings.config
         end
+
+        # BC: propagate deprecated attribute_convention to conversions
+        ac = self::Settings.config.attribute_convention
+        if ac
+          warn "RestEasy: attribute_convention is deprecated, use `conversions.json_attributes = #{ac.inspect}` instead"
+          self::Settings.config.conversions.json_attributes = ac
+        end
       end
     end
 

lib/rest_easy/resource.rb

@@ -9,6 +9,11 @@ class Resource
     setting :path
     setting :debug, default: false
 
+    setting :conversions do
+      setting :query_parameters  # nil default — falls back to parent module
+      setting :json_attributes   # nil default — falls back to parent module
+    end
+
     # ── Types ─────────────────────────────────────────────────────────────
     # Include Types so the full Dry::Types vocabulary (Strict::String,
     # Coercible::Integer, Params::Date, etc.) is available without prefix.
@@ -143,16 +148,31 @@ def metadata(**kwargs)
         end
       end
 
-      # -- attribute_convention ------------------------------------------
+      # -- conversions ---------------------------------------------------
+
+      def json_attribute_converter
+        @json_attribute_converter ||= Conventions.resolve(
+          config.conversions.json_attributes ||
+          parent&.config&.conversions&.json_attributes
+        )
+      end
+
+      def query_parameter_converter
+        @query_parameter_converter ||= Conventions.resolve(
+          config.conversions.query_parameters ||
+          parent&.config&.conversions&.query_parameters
+        )
+      end
+
+      # -- attribute_convention (deprecated) -------------------------------
 
       def attribute_convention(value = nil)
         if value
-          @attribute_convention = Conventions.resolve(value)
-        else
-          @attribute_convention ||
-            (superclass.respond_to?(:attribute_convention) ? superclass.attribute_convention : nil) ||
-            Conventions.resolve(parent&.config&.attribute_convention || :PascalCase)
+          warn "RestEasy: attribute_convention is deprecated, use `configure { conversions.json_attributes = #{value.inspect} }` instead"
+          config.conversions.json_attributes = value
+          @json_attribute_converter = nil # bust memoization
         end
+        json_attribute_converter
       end
 
       private
@@ -191,7 +211,7 @@ def attr(name_or_mapping, *args, &block)
           attribute_api_name = name_or_mapping[1].to_s
         else
           attribute_model_name = name_or_mapping.to_sym
-          attribute_api_name = attribute_convention.serialise(attribute_model_name)
+          attribute_api_name = json_attribute_converter.serialise(attribute_model_name)
         end
 
         # Extract type (non-Symbol), flags (Symbols), and optional mapper object
@@ -459,6 +479,7 @@ def delete(id)
       # HTTP primitives — delegate to the parent API module's connection
 
       def get(path:, params: {}, headers: {})
+        params.transform_keys! { |k| query_parameter_converter.serialise(k) }
         parent.get(path:, params:, headers:)
       end
 
@@ -578,7 +599,7 @@ def serialise
           serialised = attr_def.serialise_value(value)
           if serialised.is_a?(::Array)
             # Array return: zip with source field API names
-            convention = klass.attribute_convention
+            convention = klass.json_attribute_converter
             attr_def.source_fields.zip(serialised).each do |field_name, field_value|
               api_key = convention.serialise(field_name)
               result[api_key] = field_value

lib/rest_easy/settings.rb

@@ -9,6 +9,11 @@ class Settings
     setting :base_url, default: "https://example.com", reader: true
     setting :max_retries, default: 3, reader: true
     setting :authentication, default: Auth::Null.new, reader: true
-    setting :attribute_convention, default: :PascalCase, reader: true
+    setting :attribute_convention # deprecated — propagated to conversions.json_attributes in configure
+
+    setting :conversions do
+      setting :query_parameters, default: :snake_case, reader: true
+      setting :json_attributes, default: :snake_case, reader: true
+    end
   end
 end

lib/rest_easy/version.rb

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