optify-config 1.22.3-x86_64-linux → 1.23.0-x86_64-linux

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 15484b0d54fc7325f04828c65d8896556adbd52a807480f5e5bb28408cf8cf8a
-  data.tar.gz: e13e220936f918e97b6ccbc304c10602a18e916962fc89bf7b49ada6f080ea9d
+  metadata.gz: 36849131ee76c03ca491e65b27045dc5f2c84a151ae32de8e0c89db3e8a41e3e
+  data.tar.gz: 0beedff38b332b5756810a22f654a383d27e1ef120d0f7d4340dc940ec1431c2
 SHA512:
-  metadata.gz: 1566302118bceb0a3a98ca21a5dfc7709a08e060dc84df5bb8c4a093ac8d780a3fcf0ded2ed0c4f1743faadcb5d917446b4863c56a83f060822491a9d1637f41
-  data.tar.gz: '069c7e64b82d4ee8cfdb9db8de217f13fca75f8e576262c2d9633b1b7afcf4f8d4ffdb135f251df164656b27c9ff2ca2148b54170396e5c96220078d4ada344b'
+  metadata.gz: d0c77421d2ee266dee02487225ad233644c56f2910bdab5c90025086c3eab4216d6f9d84260bc8fe58185d69c35cefe89577fedcb2329f451865383e80297306
+  data.tar.gz: b73ab36488fa1c75efff9dfecbc9b23f5616ce26483e07cf056c249c69f53da28d8e8b3e8ad7932dec1fe359e602e9015075415dcdd9452bf464974f9299b458

data/lib/optify_ruby/implementation.rb

@@ -11,8 +11,16 @@ require_relative './provider_module'
 # Tools for working with configurations declared in files.
 module Optify
   # Options for caching.
-  # Only enabling or disabling caching is supported for now.
-  class CacheOptions < FromHashable
+  class CacheOptions
+    #: (^(Array[untyped] key, untyped value, bool is_cache_hit) -> void)?
+    attr_accessor :on_cache_event
+
+    #: (
+    #|   ?on_cache_event: (^(Array[untyped] key, untyped value, bool is_cache_hit) -> void)?,
+    #| ) -> void
+    def initialize(on_cache_event: nil)
+      @on_cache_event = on_cache_event
+    end
   end
 
   # Provides configurations based on keys and enabled feature names.

data/lib/optify_ruby/provider_module.rb

@@ -8,17 +8,23 @@ require 'sorbet-runtime'
 module Optify
   # @!visibility private
   module ProviderModule
-    #: [T] (LruRedux::Cache | Hash[untyped, untyped], Array[untyped]) { -> T } -> T
-    def self._cache_getset(cache, cache_key, &block)
-      if cache.is_a? LruRedux::Cache
-        cache.getset(cache_key, &block)
-      else
-        # Plain Hash - use fetch with block and store result
-        cache.fetch(cache_key) do
-          result = block.call
-          cache[cache_key] = result
-        end
-      end
+    #: [T] (LruRedux::Cache | Hash[Array[untyped], T], Array[untyped], (^(Array[untyped] key, T value, bool is_cache_hit) -> void)?) { -> T } -> T
+    def self._cache_getset(cache, cache_key, on_cache_event, &block)
+      is_cache_hit = true #: bool
+      result = if cache.is_a? LruRedux::Cache
+                 cache.getset(cache_key) do
+                   is_cache_hit = false
+                   block.call
+                 end
+               else
+                 # Plain Hash - use fetch with block and store result
+                 cache.fetch(cache_key) do
+                   is_cache_hit = false
+                   cache[cache_key] = block.call
+                 end
+               end
+      on_cache_event&.call(cache_key, result, is_cache_hit)
+      result
     end
 
     #: (CacheInitOptions?) -> ( Hash[Array[untyped], untyped] | LruRedux::Cache)
@@ -109,8 +115,8 @@ module Optify
         .from_hash(hash)
     end
 
-    #: [Config] (String key, Array[String] feature_names, Class[Config] config_class, Optify::CacheOptions _cache_options, ?Optify::GetOptionsPreferences? preferences) -> Config
-    def _get_options_with_cache(key, feature_names, config_class, _cache_options, preferences = nil)
+    #: [Config] (String, Array[String], Class[Config], Optify::CacheOptions, ?Optify::GetOptionsPreferences? ) -> Config
+    def _get_options_with_cache(key, feature_names, config_class, cache_options, preferences = nil)
       # Cache directly in Ruby instead of Rust because:
       # * Avoid any possible conversion overhead.
       # * Memory management: probably better to do it in Ruby for a Ruby app and avoid memory in Rust.
@@ -133,6 +139,7 @@ module Optify
       ProviderModule._cache_getset(
         @cache, #: as !nil
         cache_key,
+        cache_options.on_cache_event,
       ) do
         # Handle a cache miss.
 

data/rbi/optify.rbi

@@ -19,8 +19,33 @@ module Optify
   end
 
   # Options for caching.
-  # Only enabling or disabling caching is supported for now.
-  class CacheOptions < FromHashable
+  class CacheOptions
+    sig do
+      returns(
+        T.nilable(
+          T.proc.params(
+            key: T::Array[T.untyped],
+            value: T.untyped,
+            is_cache_hit: T::Boolean,
+          )
+              .void,
+        ),
+      )
+    end
+    attr_reader :on_cache_event
+
+    sig do
+      params(
+        on_cache_event: T.nilable(
+          T.proc.params(
+            key: T::Array[T.untyped],
+            value: T.untyped,
+            is_cache_hit: T::Boolean,
+          ).void,
+        ),
+      ).void
+    end
+    def initialize(on_cache_event: nil); end
   end
 
   # The mode for the cache.

data/sig/optify.rbs

@@ -17,8 +17,9 @@ class Optify::BaseConfig < FromHashable
 end
 
 # Options for caching.
-# Only enabling or disabling caching is supported for now.
-class Optify::CacheOptions < FromHashable
+class Optify::CacheOptions
+  def initialize: () -> (^(::Array[untyped] key, untyped value, bool is_cache_hit) -> void)?
+                | (?on_cache_event: (^(::Array[untyped] key, untyped value, bool is_cache_hit) -> void)? on_cache_event) -> void
 end
 
 # The mode for the cache.

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: optify-config
 version: !ruby/object:Gem::Version
-  version: 1.22.3
+  version: 1.23.0
 platform: x86_64-linux
 authors:
 - Justin D. Harris
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2026-06-29 00:00:00.000000000 Z
+date: 2026-07-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: optify-from_hash