feat: refactor serializers & code cleanup

[cofin]

Summary

• non-breaking code cleanup/organization in the repository layer.
• Improved serialization and removed duplication between cache handler and normal serializers
• Bug Fixes

Detailed Changes

Repository & Caching Refactor

• Reduced Bloat: Moved internal caching helpers (_normalize_cache_key_value, _build_list_cache_key, etc.) out of advanced_alchemy/repository/_async.py and into advanced_alchemy/repository/_util.py.
• Unified Serialization:
  • Refactored advanced_alchemy/_serialization.py to expose encode_complex_type and decode_complex_type.
  • Updated advanced_alchemy/cache/serializers.py and repository/_util.py to share this logic, removing duplicate handling for types like UUID, datetime, and Decimal.
• Cleanup: Removed unused imports (dataclasses, hashlib, etc.) from the repository files.

Bug Fixes

• Issue Bug: SQLAlchemy's StatementError (or OperationalError) is incorrectly wrapped as IntegrityError #606 (Error Misclassification):
  • Problem: StatementError (often caused by transient connection issues) was incorrectly wrapped as IntegrityError.
  • Fix: Updated advanced_alchemy/exceptions.py to correctly map StatementError to RepositoryError.
• Issue Bug: Core dependencies not installed by default #651 (Alembic Migrations):
  • Problem: Migration templates unconditionally imported optional dependencies (Argon2, Passlib, Pwdlib), causing crashes for users who hadn't installed them.
  • Fix: Wrapped these imports in try/except ImportError blocks in both sync and asyncio Alembic templates (script.py.mako).
• Issue Bug: Problem with certain hybrid properties starting with 1.8.0 #646 (DTO Regression):
  • Problem: SQLAlchemyDTO crashed when encountering hybrid_property attributes because inspect.getmembers triggered their evaluation.
  • Fix: Switched to iterating over the class dictionary (dict) and MRO in dto.py to inspect properties safely without executing them.

[codecov-commenter]

Codecov Report

❌ Patch coverage is 92.24806% with 10 lines in your changes missing coverage. Please review.
✅ Project coverage is 80.04%. Comparing base (658d417) to head (d819f47).

Files with missing lines	Patch %	Lines
advanced_alchemy/repository/_util.py	88.40%	4 Missing and 4 partials ⚠️
advanced_alchemy/_serialization.py	96.22%	1 Missing and 1 partial ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             main     #661      +/-   ##
==========================================
+ Coverage   79.08%   80.04%   +0.95%     
==========================================
  Files          99       99              
  Lines        7922     7836      -86     
  Branches     1073     1050      -23     
==========================================
+ Hits         6265     6272       +7     
+ Misses       1316     1233      -83     
+ Partials      341      331      -10     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
95.1% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud