active_typed_store 2.3.0 → 2.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 14bd114be57f358f5e2f39a9ee2c554d2bc150e0b9df39b269081c2b1efc543e
-  data.tar.gz: a7addc73c5a5f5e2147f0b216e4109152aa5d5db44487971de45face6ece273f
+  metadata.gz: 89b2c39e6bd9afe68635f920a123392538160c0eb6bbe9484738ced7600b58fa
+  data.tar.gz: 30ed4d583b2fdb4ebbb4480b479826a54088f6fb2467dc87ba99e393c6c2270a
 SHA512:
-  metadata.gz: 2992b768f9374caf908ed316e5f2fd3fcd37de8495bf89988e27e47726be73c2678ccf7827f6299d901db6c282818993f0027b1113028df07cf79130f387024f
-  data.tar.gz: a41889669cb6d36feac7b129f66d65c747ceac9b0e08ff625fb5d598d6175757a8aa089ab1ee78725a3dcdb289745cac2a5efc09aee5fc2a8e0c16e24f445319
+  metadata.gz: a54b0a60a62d550f6493ac64f36c42d9a5f52eb207572b47b269b2cdd77815a2659b01e16648f1ed53a0ee943b698515ed04a3eb5ed0fcce7ef94b3eda942366
+  data.tar.gz: d57e21409b72efcc79086186aeb4ee8ea542380738cfdd2ddff94892dcb215b9ac05f509188dc5671e799e92f57b9aadabeb9b4f1473c3137f0b8d0f4f9b888b

data/README.md

@@ -1,6 +1,6 @@
 # ActiveTypedStore
 
-`active_typed_store` is a lightweight (__105 lines of code__) and highly performant gem (see [benchmarks](#benchmarks))
+`active_typed_store` is a lightweight (__~100 lines of code [1](https://github.com/corp-gp/active_typed_store/blob/master/lib/active_typed_store/attrs.rb) [2](https://github.com/corp-gp/active_typed_store/blob/master/lib/active_typed_store/store.rb)__) and highly performant gem (see [benchmarks](#benchmarks))
 designed to help you store and manage typed data in JSON format within database.
 This gem provides a simple, yet powerful way to ensure that your JSON data cast
 to specific types, enabling more structured and reliable use of JSON fields in your Rails models.
@@ -80,6 +80,69 @@ class Model < ActiveRecord::Base
 end
 ```
 
+### Active Values
+
+```ruby
+class Model < ActiveRecord::Base
+  typed_store(:params) do
+    attr :name,    :string
+    attr :parcel,  Parcel::TYPE,      default: Parcel.new
+    attr :parcels, Parcel::ARRAY_TYPE, default: []
+
+    # if types registered in ActiveRecord, you can use as symbol name
+    # ActiveRecord::Type.register(:parcel, ParcelType)
+    # ActiveRecord::Type.register(:parcel_array, ParcelArrayType)
+    # attr :parcel,  :parcel,       default: Parcel.new
+    # attr :parcels, :parcel_array, default: []
+  end
+end
+
+record = Model.new
+record.parcel.weight = 10
+record.parcel.height # => 0 is default value
+record.parcels << Parcel.new(weight: 10, height: 20)
+```
+
+Example Active Value defined class:
+```ruby
+class Parcel
+  include ActiveModel::Attributes
+  include ActiveModel::AttributeAssignment
+
+  attribute :height, :float, default: 0
+  attribute :weight, :float
+
+  def initialize(attributes = {})
+    super()
+    assign_attributes(attributes)
+  end
+
+  def inspect = "<Parcel #{attributes.map { |k, v| "#{k}=#{v}" }.join(' ')}>"
+  def as_json = attributes.compact
+
+  class Type < ActiveRecord::Type::Json
+    def cast(value)
+      case value
+      when Hash   then Parcel.new(value)
+      when Parcel then value
+      end
+    end
+  end
+
+  class ArrayType < ActiveRecord::Type::Json
+    def cast(value)
+      case value
+      when Array then value.map { it.is_a?(Parcel) ? it : Parcel.new(it) }
+      end
+    end
+  end
+  
+  # Memoize types to enable sharing across models or attributes, reducing memory usage and optimizing YJIT warm-up.
+  TYPE = Type.new
+  ARRAY_TYPE = ArrayType.new
+end
+```
+
 ### Hash safety
 This gem assumes you're using a database that supports structured data types, such as `json` in `PostgreSQL` or `MySQL`, and leverages Rails' [store_accessor](https://edgeapi.rubyonrails.org/classes/ActiveRecord/Store.html) under the hood. However, there’s one caveat: JSON columns use a string-keyed hash and don’t support access via symbols. To avoid unexpected errors when accessing the hash, we raise an error if a symbol is used. You can disable this behavior by setting `config.hash_safety = false`.
 
@@ -91,16 +154,16 @@ class Model < ActiveRecord::Base
 end
 
 record = Model.new(price: 1)
-record["price"] # 1
-record[:price] # raises "Symbol keys are not allowed `:price` (ActiveTypedStore::SymbolKeysDisallowed)"
+record.params["price"] # 1
+record.params[:price] # raises "Symbol keys are not allowed `:price` (ActiveTypedStore::SymbolKeysDisallowed)"
 
 # initializers/active_type_store.rb
 ActiveTypeStore.configure do |config|
   config.hash_safety = false # default :disallow_symbol_keys
 end
 
-record["price"] # 1
-record[:price] # nil - isn't the expected behavior for most applications
+record.params["price"] # 1
+record.params[:price] # nil - isn't the expected behavior for most applications
 ```
 
 ### Benchmarks

data/lib/active_typed_store/attrs.rb

@@ -37,7 +37,7 @@ module ActiveTypedStore
       store_module.define_method(:"#{field}=") do |value|
         v = (type.respond_to?(:cast) ? type.cast(value) : type[value]) unless value.nil?
         write_store_attribute(store_attribute, field, v)
-        self[store_attribute].delete(field) if v.nil?
+        read_attribute(store_attribute).delete(field) if v.nil?
       end
     end
 
@@ -50,18 +50,19 @@ module ActiveTypedStore
         casted_val =
           if val.nil? && !default.nil?
             v = default.dup
-            self[store_attribute][field] = v
-            clear_attribute_change(store_attribute)
-            self[store_attribute][field] = v
+            is_changed = attribute_changed?(store_attribute)
+            read_attribute(store_attribute)[field] = v
+            clear_attribute_change(store_attribute) unless is_changed
+            read_attribute(store_attribute)[field] = v
           elsif val.nil?
             return nil
           elsif instance_variable_get(ivar_prev).eql?(val)
             return val
           elsif type.respond_to?(:cast)
             casted = type.cast(val)
-            casted.eql?(val) ? val : (self[store_attribute][field] = casted)
+            casted.eql?(val) ? val : (read_attribute(store_attribute)[field] = casted)
           else
-            self[store_attribute][field] = type[val]
+            read_attribute(store_attribute)[field] = type[val]
           end
 
         instance_variable_set(ivar_prev, casted_val)

data/lib/active_typed_store/disallow_symbol_keys.rb

@@ -31,7 +31,7 @@ module ActiveTypedStore
     end
 
     def self.prepare(object, attribute)
-      object.public_send :"#{attribute}=", {} unless object.read_attribute(attribute)
+      object.send :"#{attribute}=", {} unless object.read_attribute(attribute)
     end
   end
 end

data/lib/active_typed_store/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module ActiveTypedStore
-  VERSION = "2.3.0"
+  VERSION = "2.4.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: active_typed_store
 version: !ruby/object:Gem::Version
-  version: 2.3.0
+  version: 2.4.0
 platform: ruby
 authors:
 - Ermolaev Andrey
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-05-29 00:00:00.000000000 Z
+date: 2025-11-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activemodel