Migrating Guide: v2.0.0-pre14

This version renames TimeUtils to TimeLiterals for semantic clarity and fixes an ExternalIdentifier bug.

Breaking Change: TimeUtils → TimeLiterals

Migration Required:

Find and replace in your codebase:

# Find files to update
grep -r "using Familia::Refinements::TimeUtils" .

# Replace the import
sed -i 's/using Familia::Refinements::TimeUtils/using Familia::Refinements::TimeLiterals/g' *.rb

Before:

using Familia::Refinements::TimeUtils

After:

using Familia::Refinements::TimeLiterals

All functionality remains identical - only the module name changed.

Bug Fix: ExternalIdentifier

Fixed NoMethodError when using ExternalIdentifier by replacing incorrect .del() calls with .remove_field() in HashKey operations. This affected:

  • Changing external identifier values
  • Looking up objects by external ID
  • Destroying objects with external identifiers

No migration needed - the fix is automatic.