solid-process 0.5.0 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 56d7e7dae11f894dafd8cd1970ccf6fa1a9e6f6879a8f6370a3c5fa3b8419fcd
-  data.tar.gz: c15ca09276f4e0a366c980fd44cb6885f7cb5e1439786222c324828b2e7a5632
+  metadata.gz: 8806338db8f3194c5cd5a99ba56a2429f627426f51ac5cfece57d4a629e5328e
+  data.tar.gz: ae0f3c7a19a02b1780e5cd6551d6ae6f0011ad657a3f88778a05fc61400e0d2e
 SHA512:
-  metadata.gz: 3a7afa31c7de01092d6c75130d50e557c83e7e8b12b7a30667fce3bbfdb7c2876298907da67c8c0cfa8b1e1bd375b88d11d106d800bb628cb70e7efe7203324d
-  data.tar.gz: 53b395cec3553f20305db78fc24b51b09283034310363f26bdf53711aec85021aa5aa85cb24645d692d85df0218c8cec2700f42c315f983507dc27375f65f80d
+  metadata.gz: 4981f758d2c29c7449d1852303da4cfded01037ca136729b9ba18887ccf7f172ef833b591b3ee9c42ad61dd920dfa7302df1d99792b84b46681c516631fe1294
+  data.tar.gz: dfa3f9eb10870116af8caee157411f983750d4c1898777fc78b42389f7219bda094aa4a48ae759ad1b5ab33dbc3b356025b72dcdbbb4fb60aa7c9bff1637ab8f

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 ## [Unreleased]
 
+## [0.6.0] - 2026-01-28
+
+### Added
+
+- Add conditional `normalizes` support to `Solid::Model` (requires Rails 8.1+ with `ActiveModel::Attributes::Normalization`).
+
+- Add `normalizes` to `Solid::Value`, automatically prepending `:value` as the attribute name.
+
 ## [0.5.0] - 2025-01-27
 
 ### Added

data/README.md

@@ -2,8 +2,8 @@
   <h1 align="center" id="-solidprocess">⚛️ Solid::Process</h1>
   <p align="center"><i>Write business logic for Ruby/Rails that scales.</i></p>
   <p align="center">
-    <a href="https://codeclimate.com/github/solid-process/solid-process/maintainability"><img src="https://api.codeclimate.com/v1/badges/643a53e99bb591321c9f/maintainability" /></a>
-    <a href="https://codeclimate.com/github/solid-process/solid-process/test_coverage"><img src="https://api.codeclimate.com/v1/badges/643a53e99bb591321c9f/test_coverage" /></a>
+    <a href="https://qlty.sh/gh/solid-process/projects/solid-process"><img src="https://qlty.sh/gh/solid-process/projects/solid-process/maintainability.svg" alt="Maintainability" /></a>
+    <a href="https://qlty.sh/gh/solid-process/projects/solid-process"><img src="https://qlty.sh/gh/solid-process/projects/solid-process/coverage.svg" alt="Code Coverage" /></a>
     <img src="https://img.shields.io/badge/Ruby%20%3E%3D%202.7%2C%20%3C%3D%20Head-ruby.svg?colorA=444&colorB=333" alt="Ruby">
     <img src="https://img.shields.io/badge/Rails%20%3E%3D%206.0%2C%20%3C%3D%20Edge-rails.svg?colorA=444&colorB=333" alt="Rails">
   </p>

data/docs/040_ADVANCED_USAGE.md

@@ -94,3 +94,77 @@ class User::Registration < Solid::Process
   end
 end
 ```
+
+## Input Normalization
+
+### Using `before_validation` (all Rails versions)
+
+The example above uses `before_validation` to normalize the email attribute. This approach works on all supported Rails versions, but normalization only runs when `valid?` is called:
+
+```ruby
+input do
+  attribute :email, :string
+
+  before_validation do
+    self.email = email.downcase.strip
+  end
+end
+```
+
+### Using `normalizes` (Rails 8.1+)
+
+Rails 8.1 introduced `ActiveModel::Attributes::Normalization`, which provides a declarative way to normalize attributes. When available, `Solid::Model` automatically includes it.
+
+Unlike `before_validation`, `normalizes` applies on attribute assignment, so the value is normalized immediately:
+
+```ruby
+input do
+  attribute :email, :string
+
+  normalizes :email, with: -> { _1.strip.downcase }
+end
+```
+
+#### Normalize multiple attributes with the same rule
+
+```ruby
+input do
+  attribute :email, :string
+  attribute :username, :string
+
+  normalizes :email, :username, with: -> { _1.strip.downcase }
+end
+```
+
+#### Different normalizations per attribute
+
+```ruby
+input do
+  attribute :email, :string
+  attribute :phone, :string
+
+  normalizes :email, with: -> { _1.strip.downcase }
+  normalizes :phone, with: -> { _1.delete("^0-9").delete_prefix("1") }
+end
+```
+
+#### Apply normalization to `nil` values
+
+By default, `normalizes` skips `nil` values. Use `apply_to_nil: true` to change this:
+
+```ruby
+input do
+  attribute :phone, :string
+
+  normalizes :phone, with: -> { _1&.delete("^0-9") || "" }, apply_to_nil: true
+end
+```
+
+#### Normalize a value without instantiation
+
+Use `normalize_value_for` on the input class to normalize a value directly:
+
+```ruby
+UserRegistration.input.normalize_value_for(:email, " FOO@BAR.COM\n")
+# => "foo@bar.com"
+```

data/lib/solid/model.rb

@@ -20,6 +20,11 @@ module Solid::Model
     include ::ActiveModel.const_defined?(:Access, false) ? ::ActiveModel::Access : ::Solid::Model::Access
 
     include ::ActiveModel::Attributes
+
+    if ::ActiveModel::Attributes.const_defined?(:Normalization, false)
+      include ::ActiveModel::Attributes::Normalization
+    end
+
     include ::ActiveModel::Dirty
     include ::ActiveModel::Validations::Callbacks
 

data/lib/solid/process/version.rb

@@ -2,6 +2,6 @@
 
 module Solid
   class Process
-    VERSION = "0.5.0"
+    VERSION = "0.6.0"
   end
 end

data/lib/solid/value.rb

@@ -17,6 +17,10 @@ module Solid::Value
     def validates(...)
       super(:value, ...)
     end
+
+    def normalizes(...)
+      super(:value, ...)
+    end
   end
 
   def self.included(subclass)

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: solid-process
 version: !ruby/object:Gem::Version
-  version: 0.5.0
+  version: 0.6.0
 platform: ruby
 authors:
 - Rodrigo Serradura
-autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-01-27 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: solid-result
@@ -123,7 +122,6 @@ metadata:
   source_code_uri: https://github.com/serradura/solid-process
   changelog_uri: https://github.com/solid-process/solid-process/blob/main/CHANGELOG.md
   rubygems_mfa_required: 'true'
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -138,8 +136,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.33
-signing_key:
+rubygems_version: 3.7.2
 specification_version: 4
 summary: Write business logic for Ruby/Rails that scales.
 test_files: []