familia 2.0.0.pre14 → 2.0.0.pre16

data/try/core/pools_try.rb

@@ -51,10 +51,28 @@ class PoolTestSession < Familia::Horreum
 
   def init
     @session_id ||= SecureRandom.hex(8)
-    @created_at ||= Time.now.to_i
+    @created_at ||= Familia.now.to_i
   end
 end
 
+class PoolTestAccountDB1 < Familia::Horreum
+  logical_database 1
+  identifier_field :account_id
+  field :account_id
+  field :balance, on_conflict: :skip
+  field :holder_name
+
+  def init
+    @account_id ||= SecureRandom.hex(6)
+    @balance = @balance.to_f if @balance
+  end
+
+  def balance
+    @balance&.to_f
+  end
+end
+
+
 ## Clean up before tests
 PoolTestAccount.dbclient.flushdb
 #=> "OK"
@@ -79,23 +97,6 @@ Familia.connection_provider.is_a?(Proc)
 #=> true
 
 ## Test 5: Account in DB 1 via class configuration
-class PoolTestAccountDB1 < Familia::Horreum
-  self.logical_database = 1
-  identifier_field :account_id
-  field :account_id
-  field :balance, on_conflict: :skip
-  field :holder_name
-
-  def init
-    @account_id ||= SecureRandom.hex(6)
-    @balance = @balance.to_f if @balance
-  end
-
-  def balance
-    @balance&.to_f
-  end
-end
-
 @account_db1 = PoolTestAccountDB1.new(balance: 750, holder_name: "Charlie")
 @account_db1.save
 #=> true
@@ -140,8 +141,8 @@ threads.each(&:join)
   # Test that transaction connection is available
   conn.ping
 end
-# Transaction returns array with results
-@transfer_result.first
+# Transaction returns MultiResult with success status and results
+@transfer_result.results.first
 #=> "PONG"
 
 ## Test 12: Transaction block executes properly
@@ -149,19 +150,19 @@ end
 [@account_a.balance, @account_b.balance]
 #=> [1000.0, 500.0]
 
-## Test 13: with_connection method
-@connection_test_result = Familia.with_connection do |conn|
+## Test 13: with_dbclient method
+@connection_test_result = Familia.with_dbclient do |conn|
   conn.set("test_key_#{SecureRandom.hex(4)}", "test_value")
 end
 @connection_test_result
 #=> "OK"
 
 ## Test 14: Pipeline operations with connection pool
-@pipeline_results = Familia.pipeline do |conn|
+@pipeline_results = Familia.pipelined do |conn|
   conn.ping
 end
 # Pipeline executes successfully
-@pipeline_results.first
+@pipeline_results.results.first
 #=> "PONG"
 
 ## Test 15: Multi/EXEC operations with connection pool
@@ -169,7 +170,7 @@ end
   conn.ping
 end
 # Multi/EXEC executes successfully
-@multi_results.first
+@multi_results.results.first
 #=> "PONG"
 
 ## Test 16: Error handling in transactions
@@ -208,7 +209,7 @@ timeout_mutex = Mutex.new
 3.times do |i|
   timeout_threads << Thread.new do
     begin
-      result = Familia.with_connection do |conn|
+      result = Familia.with_dbclient do |conn|
         sleep(0.1)  # Brief hold
         conn.ping
       end
@@ -270,4 +271,19 @@ Familia.connection_provider = original_provider
 @captured_uris.any? { |uri| uri.include?('redis://') }
 #=> true
 
+## Check PoolTestAccountDB1 config name
+PoolTestAccountDB1.config_name
+#=> 'pool_test_account_db1'
+
+
 puts "Connection pool tests completed successfully!"
+
+# Teardown
+Familia.connection_provider = nil
+Fiber[:familia_connection] = nil
+Fiber[:familia_connection_handler_class] = nil
+Fiber[:familia_transaction] = nil
+Fiber[:familia_pipeline] = nil
+Fiber[:familia_key_cache] = nil
+Fiber[:familia_request_cache] = nil
+Fiber[:familia_request_cache_enabled] = nil

data/try/core/secure_identifier_try.rb

@@ -24,6 +24,20 @@ hex_id = Familia.generate_id(16)
 [hex_id.class, hex_id.length == 64, hex_id.match?(/^[a-f0-9]+$/)]
 #=> [String, true, true]
 
+## Familia.generate_lite_id
+Familia.respond_to?(:generate_lite_id)
+#=> true
+
+## Can generate a default base-36 lite ID
+lite_id = Familia.generate_lite_id
+[lite_id.class, lite_id.length > 10, lite_id.match?(/^[a-z0-9]+$/)]
+#=> [String, true, true]
+
+## Can generate a lite ID with a custom base (hex)
+hex_lite_id = Familia.generate_lite_id(16)
+[hex_lite_id.class, hex_lite_id.length == 32, hex_lite_id.match?(/^[a-f0-9]+$/)]
+#=> [String, true, true]
+
 ## Familia.generate_trace_id
 Familia.respond_to?(:generate_trace_id)
 #=> true
@@ -35,39 +49,29 @@ trace_id = Familia.generate_trace_id
 
 ## Can generate a trace ID with a custom base (hex)
 hex_trace_id = Familia.generate_trace_id(16)
-[hex_trace_id.class, hex_trace_id.length == 16]
-#=> [String, true]
-
-## Familia.generate_hex_id
-Familia.respond_to?(:generate_hex_id)
-#=> true
-
-## Can generate a 256-bit hex ID
-hex_id = Familia.generate_hex_id
-[hex_id.class, hex_id.length == 64, hex_id.match?(/^[a-f0-9]+$/)]
+[hex_trace_id.class, hex_trace_id.length == 16, hex_trace_id.match?(/^[a-f0-9]+$/)]
 #=> [String, true, true]
 
-## Familia.generate_hex_trace_id
-Familia.respond_to?(:generate_hex_trace_id)
-#=> true
+## Generated lite IDs are unique
+[Familia.generate_lite_id == Familia.generate_lite_id]
+#=> [false]
 
-## Can generate a 64-bit hex trace ID
-hex_trace_id = Familia.generate_hex_trace_id
-[hex_trace_id.class, hex_trace_id.length == 16, hex_trace_id.match?(/^[a-f0-9]+$/)]
-#=> [String, true, true]
+## Generated trace IDs are unique
+[Familia.generate_trace_id == Familia.generate_trace_id]
+#=> [false]
 
 ## Familia.shorten_to_trace_id
 Familia.respond_to?(:shorten_to_trace_id)
 #=> true
 
 ## Can shorten hex ID to trace ID (64 bits)
-hex_id = Familia.generate_hex_id
+hex_id = Familia.generate_id(16)
 trace_id = Familia.shorten_to_trace_id(hex_id)
 [trace_id.class, trace_id.length < hex_id.length]
 #=> [String, true]
 
 ## Can shorten hex ID to trace ID with custom base (hex)
-hex_id = Familia.generate_hex_id
+hex_id = Familia.generate_id(16)
 hex_trace_id = Familia.shorten_to_trace_id(hex_id, base: 16)
 [hex_trace_id.class, hex_trace_id.length == 16]
 #=> [String, true]
@@ -77,25 +81,25 @@ Familia.respond_to?(:truncate_hex)
 #=> true
 
 ## Can truncate hex ID to 128 bits by default
-hex_id = Familia.generate_hex_id
+hex_id = Familia.generate_id(16)
 truncated_id = Familia.truncate_hex(hex_id)
 [truncated_id.class, truncated_id.length < hex_id.length]
 #=> [String, true]
 
 ## Can truncate hex ID to a custom bit length (64 bits)
-hex_id = Familia.generate_hex_id
+hex_id = Familia.generate_id(16)
 truncated_64 = Familia.truncate_hex(hex_id, bits: 64)
 [truncated_64.class, truncated_64.length < hex_id.length]
 #=> [String, true]
 
 ## Can truncate with a custom base (hex)
-hex_id = Familia.generate_hex_id
+hex_id = Familia.generate_id(16)
 hex_truncated = Familia.truncate_hex(hex_id, bits: 128, base: 16)
 [hex_truncated.class, hex_truncated.length == 32]
 #=> [String, true]
 
 ## Truncated IDs are deterministic
-hex_id = Familia.generate_hex_id
+hex_id = Familia.generate_id(16)
 id1 = Familia.truncate_hex(hex_id)
 id2 = Familia.truncate_hex(hex_id)
 id1 == id2
@@ -118,7 +122,7 @@ end
 #=> "Input bits (12) cannot be less than desired output bits (64)."
 
 ## Shortened IDs are deterministic
-hex_id = Familia.generate_hex_id
+hex_id = Familia.generate_id(16)
 id1 = Familia.shorten_to_trace_id(hex_id)
 id2 = Familia.shorten_to_trace_id(hex_id)
 id1 == id2

data/try/core/time_utils_try.rb

@@ -52,51 +52,51 @@ result.round(0)
 #=> 31556952.0
 
 ## Numeric#age_in - calculate age in months from timestamp (approximately 1 month ago)
-timestamp = Time.now.to_f - Familia::Refinements::TimeLiterals::PER_MONTH
+timestamp = Familia.now - Familia::Refinements::TimeLiterals::PER_MONTH
 result = RefinedContext.eval_in_refined_context("#{timestamp}.age_in(:months)")
 (result - 1.0).abs < 0.01
 #=> true
 
 ## Numeric#age_in - calculate age in years from timestamp (approximately 1 year ago)
-timestamp = Time.now.to_f - Familia::Refinements::TimeLiterals::PER_YEAR
+timestamp = Familia.now - Familia::Refinements::TimeLiterals::PER_YEAR
 result = RefinedContext.instance_eval_in_refined_context("#{timestamp}.age_in(:years)")
 (result - 1.0).abs < 0.01
 #=> true
 
 ## Numeric#months_old - convenience method for age_in(:months)
-timestamp = Time.now.to_f - Familia::Refinements::TimeLiterals::PER_MONTH
+timestamp = Familia.now - Familia::Refinements::TimeLiterals::PER_MONTH
 result = RefinedContext.eval_in_refined_context("#{timestamp}.months_old")
 (result - 1.0).abs < 0.01
 #=> true
 
 ## Numeric#years_old - convenience method for age_in(:years)
-timestamp = Time.now.to_f - Familia::Refinements::TimeLiterals::PER_YEAR
+timestamp = Familia.now - Familia::Refinements::TimeLiterals::PER_YEAR
 result = RefinedContext.instance_eval_in_refined_context("#{timestamp}.years_old")
 (result - 1.0).abs < 0.01
 #=> true
 
 ## Numeric#months_old - should NOT return seconds (the original bug)
-timestamp = Time.now.to_f - Familia::Refinements::TimeLiterals::PER_MONTH
+timestamp = Familia.now - Familia::Refinements::TimeLiterals::PER_MONTH
 result = RefinedContext.eval_in_refined_context("#{timestamp}.months_old")
 result.between?(0.9, 1.1)  # Should be ~1 month, not millions of seconds
 #=> true
 
 ## Numeric#years_old - should NOT return seconds (the original bug)
-timestamp = Time.now.to_f - Familia::Refinements::TimeLiterals::PER_YEAR
+timestamp = Familia.now - Familia::Refinements::TimeLiterals::PER_YEAR
 result = RefinedContext.instance_eval_in_refined_context("#{timestamp}.years_old")
 result.between?(0.9, 1.1)  # Should be ~1 year, not millions of seconds
 #=> true
 
 ## age_in with from_time parameter - months
-past_time = Time.now - (2 * Familia::Refinements::TimeLiterals::PER_MONTH)  # 2 months ago
-from_time = Time.now - Familia::Refinements::TimeLiterals::PER_MONTH  # 1 month ago
+past_time = Familia.now - (2 * Familia::Refinements::TimeLiterals::PER_MONTH)  # 2 months ago
+from_time = Familia.now - Familia::Refinements::TimeLiterals::PER_MONTH  # 1 month ago
 result = RefinedContext.eval_in_refined_context("#{past_time.to_f}.age_in(:months, #{from_time.to_f})")
 (result - 1.0).abs < 0.01
 #=> true
 
 ## age_in with from_time parameter - years
-past_time = Time.now - (2 * Familia::Refinements::TimeLiterals::PER_YEAR)  # 2 years ago
-from_time = Time.now - Familia::Refinements::TimeLiterals::PER_YEAR  # 1 year ago
+past_time = Familia.now - (2 * Familia::Refinements::TimeLiterals::PER_YEAR)  # 2 years ago
+from_time = Familia.now - Familia::Refinements::TimeLiterals::PER_YEAR  # 1 year ago
 result = RefinedContext.instance_eval_in_refined_context("#{past_time.to_f}.age_in(:years, #{from_time.to_f})")
 (result - 1.0).abs < 0.01
 #=> true

data/try/core/tools_try.rb

@@ -4,7 +4,7 @@
 
 require_relative '../helpers/test_helpers'
 
-## move_keys across Redis instances (if available)
+## move_keys across Valkey/Redis instances (if available)
 begin
   source_redis = Redis.new(db: 10)
   dest_redis = Redis.new(db: 11)

data/try/core/utils_try.rb

@@ -72,10 +72,10 @@ sym_result = Familia.distinguisher(:symbol)
 ## distinguisher raises error for high-risk types with strict mode
 begin
   Familia.distinguisher(true, strict_values: true)
-rescue Familia::HighRiskFactor => e
+rescue Familia::NotDistinguishableError => e
   e.class
 end
-#=> Familia::HighRiskFactor
+#=> Familia::NotDistinguishableError
 
 ## distinguisher allows high-risk types with non-strict mode
 result = Familia.distinguisher(false, strict_values: false)

data/try/data_types/boolean_try.rb

@@ -17,10 +17,10 @@ Familia.debug = false
 ## Trying to store a boolean value to a hash key raises an exception
 begin
   @hashkey['test'] = true
-rescue Familia::HighRiskFactor => e
+rescue Familia::NotDistinguishableError => e
   e.message
 end
-#=> "High risk factor for serialization bugs: true<TrueClass>"
+#=> "Cannot represent true<TrueClass> as a string"
 
 ## Boolean values are returned as strings
 @hashkey['test']
@@ -29,10 +29,10 @@ end
 ## Trying to store a nil value to a hash key raises an exception
 begin
   @hashkey['test'] = nil
-rescue Familia::HighRiskFactor => e
+rescue Familia::NotDistinguishableError => e
   e.message
 end
-#=> "High risk factor for serialization bugs: <NilClass>"
+#=> "Cannot represent <NilClass> as a string"
 
 ## The exceptions prevented the hash from being updated
 @hashkey['test']

data/try/data_types/datatype_base_try.rb

@@ -30,8 +30,6 @@ RefinedContext.eval_in_refined_context("@limiter1.counter.qstamp(10.minutes, '%H
 
 ## Limiter#qstamp as a number
 @limiter2 = Limiter.new :requests
-p [@limiter1.default_expiration, @limiter2.default_expiration]
-p [@limiter1.counter.parent.default_expiration, @limiter2.counter.parent.default_expiration]
 RefinedContext.instance_variable_set(:@limiter2, @limiter2)
 RefinedContext.eval_in_refined_context("@limiter2.counter.qstamp(10.minutes, pattern: nil, time: 1_302_468_980)")
 #=> 1302468600

data/try/data_types/list_try.rb

@@ -4,37 +4,37 @@ require_relative '../helpers/test_helpers'
 
 @a = Bone.new 'atoken'
 
-## Familia::List#push
+## Familia::ListKey#push
 ret = @a.owners.push :value1
 ret.class
-#=> Familia::List
+#=> Familia::ListKey
 
-## Familia::List#<<
+## Familia::ListKey#<<
 ret = @a.owners << :value2 << :value3 << :value4
 ret.class
-#=> Familia::List
+#=> Familia::ListKey
 
-## Familia::List#pop
+## Familia::ListKey#pop
 @a.owners.pop
 #=> 'value4'
 
-## Familia::List#first
+## Familia::ListKey#first
 @a.owners.first
 #=> 'value1'
 
-## Familia::List#last
+## Familia::ListKey#last
 @a.owners.last
 #=> 'value3'
 
-## Familia::List#to_a
+## Familia::ListKey#to_a
 @a.owners.to_a
 #=> ['value1','value2','value3']
 
-## Familia::List#delete
+## Familia::ListKey#delete
 @a.owners.remove 'value3'
 #=> 1
 
-## Familia::List#size
+## Familia::ListKey#size
 @a.owners.size
 #=> 2
 

data/try/data_types/sorted_set_try.rb

@@ -6,11 +6,11 @@ require_relative '../helpers/test_helpers'
 
 ## Familia::SortedSet#add
 @a = Bone.new 'atoken'
-@a.metrics.add 2, :metric2
-@a.metrics.add 4, :metric4
-@a.metrics.add 0, :metric0
-@a.metrics.add 1, :metric1
-@a.metrics.add 3, :metric3
+@a.metrics.add :metric2, 2
+@a.metrics.add :metric4, 4
+@a.metrics.add :metric0, 0
+@a.metrics.add :metric1, 1
+@a.metrics.add :metric3, 3
 #=> true
 
 ## Familia::SortedSet#members

data/try/data_types/string_try.rb

@@ -8,24 +8,24 @@ require_relative '../helpers/test_helpers'
 @a.dbkey
 #=> 'bone:atoken2:object'
 
-## Familia::String#value should give default value
+## Familia::StringKey#value should give default value
 @a.value.value
 #=> 'GREAT!'
 
-## Familia::String#value=
+## Familia::StringKey#value=
 @a.value.value = 'DECENT!'
 #=> 'DECENT!'
 
-## Familia::String#to_s
+## Familia::StringKey#to_s
 @a.value.to_s
 #=> 'DECENT!'
 
-## Familia::String#destroy!
+## Familia::StringKey#destroy!
 @a.value.delete!
 #=> true
 
-## Familia::String.new
-@ret = Familia::String.new 'arbitrary:key'
+## Familia::StringKey.new
+@ret = Familia::StringKey.new 'arbitrary:key'
 @ret.dbkey
 #=> 'arbitrary:key'
 
@@ -37,27 +37,27 @@ require_relative '../helpers/test_helpers'
 @ret.value
 #=> '1000'
 
-## Familia::String#increment
+## Familia::StringKey#increment
 @ret.increment
 #=> 1001
 
-## Familia::String#incrementby
+## Familia::StringKey#incrementby
 @ret.incrementby 99
 #=> 1100
 
-## Familia::String#decrement
+## Familia::StringKey#decrement
 @ret.decrement
 #=> 1099
 
-## Familia::String#decrementby
+## Familia::StringKey#decrementby
 @ret.decrementby 49
 #=> 1050
 
-## Familia::String#append
+## Familia::StringKey#append
 @ret.append 'bytes'
 #=> 9
 
-## Familia::String#value after append
+## Familia::StringKey#value after append
 @ret.value
 #=> '1050bytes'
 

data/try/data_types/unsortedset_try.rb

@@ -0,0 +1,33 @@
+# try/data_types/unsortedset_try.rb
+
+require_relative '../helpers/test_helpers'
+
+@a = Bone.new 'atoken'
+
+## Familia::UnsortedSet#add
+ret = @a.tags.add :a
+ret.class
+#=> Familia::UnsortedSet
+
+## Familia::UnsortedSet#<<
+ret = @a.tags << :a << :b << :c
+ret.class
+#=> Familia::UnsortedSet
+
+## Familia::UnsortedSet#members
+@a.tags.members.sort
+#=> ['a', 'b', 'c']
+
+## Familia::UnsortedSet#member? knows when a value exists
+@a.tags.member? :a
+#=> true
+
+## Familia::UnsortedSet#member? knows when a value doesn't exist
+@a.tags.member? :x
+#=> false
+
+## Familia::UnsortedSet#member? knows when a value doesn't exist
+@a.tags.size
+#=> 3
+
+@a.tags.delete!

data/try/debugging/cache_behavior_tracer.rb

@@ -14,9 +14,9 @@ Familia.config.encryption_keys = test_keys
 Familia.config.current_key_version = :v1
 
 # Clear any existing cache
-Thread.current[:familia_key_cache] = nil
+Fiber[:familia_key_cache] = nil
 puts "1. Initial Cache State:"
-puts "   Cache: #{Thread.current[:familia_key_cache].inspect}"
+puts "   Cache: #{Fiber[:familia_key_cache].inspect}"
 puts
 
 # Define test model with multiple encrypted fields
@@ -32,14 +32,14 @@ end
 
 puts "2. Model Creation:"
 user = CacheTraceModel.new(user_id: 'cache-user-1')
-puts "   After model creation: #{Thread.current[:familia_key_cache].inspect}"
+puts "   After model creation: #{Fiber[:familia_key_cache].inspect}"
 puts
 
 puts "3. Setting Encrypted Fields:"
 ['field_a', 'field_b', 'field_c'].each_with_index do |field, i|
   puts "   Setting #{field}..."
   user.public_send("#{field}=", "test-value-#{i+1}")
-  cache = Thread.current[:familia_key_cache]
+  cache = Fiber[:familia_key_cache]
   if cache
     puts "     Cache size: #{cache.size}"
     puts "     Cache keys: #{cache.keys.inspect}"
@@ -54,7 +54,7 @@ puts "4. Reading Encrypted Fields:"
   puts "   Reading #{field}..."
   value = user.public_send(field)
   puts "     Retrieved: #{value}"
-  cache = Thread.current[:familia_key_cache]
+  cache = Fiber[:familia_key_cache]
   if cache
     puts "     Cache size: #{cache.size}"
     puts "     Cache keys: #{cache.keys.inspect}"
@@ -65,7 +65,7 @@ end
 puts
 
 puts "5. Final Cache Analysis:"
-cache = Thread.current[:familia_key_cache]
+cache = Fiber[:familia_key_cache]
 if cache && !cache.empty?
   puts "   Cache size: #{cache.size} entries"
   cache.each_with_index do |(key, value), i|
@@ -81,7 +81,7 @@ puts "6. Multiple Models Cache Test:"
 user2 = CacheTraceModel.new(user_id: 'cache-user-2')
 user2.field_a = 'different-value'
 puts "   After second model field set:"
-cache = Thread.current[:familia_key_cache]
+cache = Fiber[:familia_key_cache]
 if cache
   puts "     Cache size: #{cache.size}"
   puts "     Unique contexts: #{cache.keys.map { |k| k.split(':').last }.uniq.size}"

data/try/debugging/debug_aad_process.rb

@@ -3,7 +3,7 @@
 $LOAD_PATH.unshift(File.expand_path('lib', __dir__))
 ENV['TEST'] = 'true'
 require 'familia'
-require_relative 'try/helpers/test_helpers'
+require_relative '../helpers/test_helpers'
 
 puts "Debugging AAD during encrypt/decrypt process..."
 

data/try/debugging/debug_concealed_internal.rb

@@ -3,7 +3,7 @@
 $LOAD_PATH.unshift(File.expand_path('lib', __dir__))
 ENV['TEST'] = 'true'  # Mark as test environment
 require 'familia'
-require_relative 'try/helpers/test_helpers'
+require_relative '../helpers/test_helpers'
 
 puts "Testing ConcealedString internal call chain..."
 

data/try/debugging/debug_cross_context.rb

@@ -44,7 +44,7 @@ puts "cipher_b: #{cipher_b.class} - #{cipher_b.encrypted_value}"
 # Now try cross-context access
 puts "\n=== Cross-context test ==="
 model_a.instance_variable_set(:@api_key, cipher_b)
-puts "Set cipher_b into model_a"
+puts "UnsortedSet cipher_b into model_a"
 
 begin
   result = model_a.api_key

data/try/debugging/debug_fresh_cross_context.rb

@@ -45,7 +45,7 @@ puts "cipher_b encrypted: #{cipher_b.encrypted_value}"
 # Now try cross-context access
 puts "\n=== Cross-context test ==="
 model_a.instance_variable_set(:@api_key, cipher_b)
-puts "Set cipher_b into model_a"
+puts "UnsortedSet cipher_b into model_a"
 
 begin
   result = model_a.api_key