familia 2.0.0.pre15 → 2.0.0.pre16

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

data/try/debugging/encryption_method_tracer.rb

@@ -22,9 +22,9 @@ module Familia
         puts "   Plaintext length: #{plaintext&.length} chars"
         puts "   AAD: #{additional_data ? 'present' : 'none'}"
 
-        start_time = Time.now
+        start_time = Familia.now
         result = orig_encrypt(plaintext, context: context, additional_data: additional_data)
-        elapsed = ((Time.now - start_time) * 1000).round(2)
+        elapsed = ((Familia.now - start_time) * 1000).round(2)
 
         puts "   Result length: #{result ? result.length : 'nil'} chars"
         puts "   Elapsed: #{elapsed}ms"
@@ -38,17 +38,17 @@ module Familia
         puts "   Encrypted length: #{encrypted_json&.length} chars"
         puts "   AAD: #{additional_data ? 'present' : 'none'}"
 
-        start_time = Time.now
+        start_time = Familia.now
         begin
           result = orig_decrypt(encrypted_json, context: context, additional_data: additional_data)
-          elapsed = ((Time.now - start_time) * 1000).round(2)
+          elapsed = ((Familia.now - start_time) * 1000).round(2)
 
           puts "   Result length: #{result ? result.length : 'nil'} chars"
           puts "   Elapsed: #{elapsed}ms"
           puts
           result
         rescue => e
-          elapsed = ((Time.now - start_time) * 1000).round(2)
+          elapsed = ((Familia.now - start_time) * 1000).round(2)
           puts "   ERROR: #{e.class}: #{e.message}"
           puts "   Elapsed: #{elapsed}ms"
           puts
@@ -66,16 +66,16 @@ module Familia
         puts "   Context: #{context}"
         puts "   Version: #{version || 'current'}"
 
-        cache = Thread.current[:familia_key_cache] ||= {}
+        cache = Fiber[:familia_key_cache] ||= {}
         cache_key = "#{version || current_key_version}:#{context}"
         puts "   Cache key: #{cache_key}"
         puts "   Cache before: #{cache.keys.inspect}"
 
-        start_time = Time.now
+        start_time = Familia.now
         result = orig_derive_key_with_provider(provider, context, version: version)
-        elapsed = ((Time.now - start_time) * 1000).round(2)
+        elapsed = ((Familia.now - start_time) * 1000).round(2)
 
-        cache_after = Thread.current[:familia_key_cache] || {}
+        cache_after = Fiber[:familia_key_cache] || {}
         puts "   Cache after: #{cache_after.keys.inspect}"
         puts "   Derived key: [#{result.bytesize} bytes]"
         puts "   Elapsed: #{elapsed}ms"
@@ -92,7 +92,7 @@ Familia.config.encryption_keys = test_keys
 Familia.config.current_key_version = :v1
 
 # Clear cache
-Thread.current[:familia_key_cache] = nil
+Fiber[:familia_key_cache] = nil
 
 # Define test model
 class TraceTestModel < Familia::Horreum

data/try/edge_cases/hash_symbolization_try.rb

@@ -34,7 +34,7 @@ end
 @test_obj.config[:nested].keys
 #=> [:theme]
 
-## Get raw JSON from Redis
+## Get raw JSON from Valkey/Redis
 @raw_json = @test_obj.hget('config')
 @raw_json.class
 #=> String

data/try/edge_cases/ttl_side_effects_try.rb

@@ -16,7 +16,7 @@ begin
   session = session_class.new(session_id: 'test123', name: 'Session')
   session.save
 
-  # Set shorter TTL
+  # UnsortedSet shorter TTL
   session.expire(60)
   original_ttl = session.realttl
 

data/try/encryption/config_persistence_try.rb

@@ -90,7 +90,7 @@ end
 provider = @provider_class.new
 master_key = 'a' * 32
 context = 'TestModel:field:user123'
-# Set config with null byte
+# UnsortedSet config with null byte
 original_personal = Familia.config.encryption_personalization
 Familia.config.encryption_personalization = "bad\0config"
 begin
@@ -189,4 +189,4 @@ true
 #=> true
 
 # TEARDOWN
-Thread.current[:familia_key_cache]&.clear if Thread.current[:familia_key_cache]
+Fiber[:familia_key_cache]&.clear if Fiber[:familia_key_cache]