chore: update dependencies and changelog for cache decorator improvements

Author: HosseinNejatiJavaremi

docs/changelog.md

@@ -2,6 +2,62 @@
 
 All notable changes to ArchiPy are documented in this changelog, organized by version.
 
+## [v4.0.1] - 2025-12-10
+
+### Added
+
+#### Helpers - Decorators
+
+- **Comprehensive Cache Decorator BDD Tests** - Added extensive BDD test suite for cache decorators
+    - Test scenarios for function caching with TTL expiration
+    - Test scenarios for async function caching
+    - Test scenarios for method caching (both sync and async)
+    - Test scenarios for bound method caching with instance isolation
+    - Test scenarios for cache key generation with different argument types
+    - Test scenarios for cache invalidation and clearing
+    - Test scenarios for cache statistics and monitoring
+    - Test scenarios for error handling and edge cases
+
+### Fixed
+
+#### Helpers - Decorators
+
+- **Bound Method Caching** - Fixed cache decorator to properly handle bound methods
+    - Fixed cache key generation for bound methods to include instance identity
+    - Ensures each instance has its own cache namespace
+    - Prevents cache collisions between different instances of the same class
+    - Improved cache statistics tracking for bound methods
+
+- **Type Checker Errors** - Resolved all Ty type checker errors (22 fixes)
+    - Refactored decorators with `ParamSpec` for proper type preservation
+    - Implemented descriptor protocol for cache decorator
+    - Updated port interfaces with correct type annotations
+    - Added `TYPE_CHECKING` imports for better type checking
+    - No `cast()` usage - all types properly inferred
+
+### Changed
+
+#### Development Tools
+
+- **Type Checker Migration** - Migrated from MyPy to Ty type checker
+    - Replaced MyPy with Ty for Python 3.14 type checking
+    - Updated all type hints to use Python 3.14 syntax (`|` for unions, lowercase built-ins)
+    - Updated Makefile to use `ty check` instead of `mypy`
+    - Changed cache directory from `.mypy_cache/` to `.ty_cache/`
+    - Updated pre-commit hooks to use Ty
+    - Updated documentation and contributing guides
+
+#### Dependencies
+
+- **Optional Dependencies**
+    - Updated `fastapi` from `>=0.124.0` to `>=0.124.2`
+    - Updated `sqlalchemy` from `>=2.0.44` to `>=2.0.45`
+
+- **Development Dependencies**
+    - Removed `mypy>=1.19.0`
+    - Added `ty` (Ty type checker)
+    - Updated `types-protobuf` from `>=6.32.1.20251105` to `>=6.32.1.20251210`
+
 ## [v4.0.0] - 2025-12-08
 
 ### Changed

pyproject.toml

@@ -26,7 +26,7 @@ elastic-apm = ["elastic-apm>=6.24.1"]
 elasticsearch = ["elasticsearch>=9.2.0"]
 elasticsearch-async = ["elasticsearch[async]>=9.2.0"]
 fakeredis = ["fakeredis>=2.32.1"]
-fastapi = ["fastapi[all]>=0.124.0"]
+fastapi = ["fastapi[all]>=0.124.2"]
 grpc = ["grpcio>=1.76.0", "grpcio-health-checking>=1.76.0", "protobuf>=6.33.1"]
 jwt = ["pyjwt>=2.10.1"]
 kafka = ["confluent-kafka>=2.12.2"]
@@ -40,7 +40,7 @@ redis = ["redis[hiredis]>=7.1.0"]
 scheduler = ["apscheduler>=3.11.1"]
 scylladb = ["scylla-driver>=3.29.6", "lz4>=4.4.5", "cachetools>=6.2.2", "async-lru>=2.0.5"]
 sentry = ["sentry-sdk>=2.47.0"]
-sqlalchemy = ["sqlalchemy>=2.0.44"]
+sqlalchemy = ["sqlalchemy>=2.0.45"]
 starrocks = ["starrocks>=1.3.1", "pymysql>=1.1.2"]
 starrocks-async = ["starrocks>=1.3.1", "aiomysql>=0.3.2"]
 temporalio = ["temporalio>=1.20.0"]
@@ -74,7 +74,7 @@ dev = [
     "ruff>=0.14.7",
     "types-cachetools>=6.2.0.20251022",
     "types-grpcio>=1.0.0.20251009",
-    "types-protobuf>=6.32.1.20251105",
+    "types-protobuf>=6.32.1.20251210",
     "types-pymysql>=1.1.0.20250916",
     "types-regex>=2025.11.3.20251106",
     "types-requests>=2.32.4.20250913",