improved dx

Author: chrishayuk

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "chuk-sessions"
-version = "0.5"
+version = "0.5.1"
 description = "CHUK Sessions provides a comprehensive, async-first session management system with automatic expiration, and support for both in-memory and Redis storage backends. Perfect for web applications, MCP servers, API gateways, and microservices that need reliable, scalable session handling."
 readme = "README.md"
 requires-python = ">=3.11"

src/chuk_sessions/session_manager.py

@@ -144,9 +144,23 @@ async def validate_session(self, session_id: str) -> bool:
             return False
 
     async def get_session_info(self, session_id: str) -> Optional[dict[str, Any]]:
+        """
+        Get session information as a dict.
+
+        For typed access, use get_session_metadata() instead.
+        """
         metadata = await self._get_session_metadata(session_id)
         return metadata.to_dict() if metadata else None
 
+    async def get_session_metadata(self, session_id: str) -> Optional[SessionMetadata]:
+        """
+        Get session information as typed SessionMetadata.
+
+        This returns the Pydantic model directly for better type safety.
+        For backwards compatibility, use get_session_info() which returns dict.
+        """
+        return await self._get_session_metadata(session_id)
+
     async def update_session_metadata(
         self,
         session_id: str,