Replace LambdaContext with a Protocol that matches source

Signed-off-by: Astraea Sinclair <quinsclr@amazon.com>

Author: FullyTyped

src/aws_durable_execution_sdk_python/__init__.py

@@ -1 +0,0 @@
-"""AWS Lambda Durable Executions Python SDK."""

src/aws_durable_execution_sdk_python/context.py

@@ -53,6 +53,7 @@
     from collections.abc import Callable, Sequence
 
     from aws_durable_execution_sdk_python.state import CheckpointedResult
+    from aws_durable_execution_sdk_python.types import LambdaContext
 
 P = TypeVar("P")  # Payload type
 R = TypeVar("R")  # Result type
@@ -149,7 +150,7 @@ class DurableContext(DurableContextProtocol):
     def __init__(
         self,
         state: ExecutionState,
-        lambda_context: Any | None = None,
+        lambda_context: LambdaContext | None = None,
         parent_id: str | None = None,
         logger: Logger | None = None,
     ) -> None:
@@ -171,7 +172,7 @@ def __init__(
     @staticmethod
     def from_lambda_context(
         state: ExecutionState,
-        lambda_context: Any,
+        lambda_context: LambdaContext,
     ):
         return DurableContext(
             state=state,

src/aws_durable_execution_sdk_python/execution.py

@@ -25,6 +25,8 @@
 if TYPE_CHECKING:
     from collections.abc import Callable, MutableMapping
 
+    from aws_durable_execution_sdk_python.types import LambdaContext
+
 
 logger = logging.getLogger(__name__)
 
@@ -187,10 +189,10 @@ def create_succeeded(cls, result: str) -> DurableExecutionInvocationOutput:
 
 def durable_handler(
     func: Callable[[Any, DurableContext], Any],
-) -> Callable[[Any, Any], Any]:
+) -> Callable[[Any, LambdaContext], Any]:
     logger.debug("Starting durable execution handler...")
 
-    def wrapper(event: Any, context: Any) -> MutableMapping[str, Any]:
+    def wrapper(event: Any, context: LambdaContext) -> MutableMapping[str, Any]:
         invocation_input: DurableExecutionInvocationInput
         service_client: DurableServiceClient
 

src/aws_durable_execution_sdk_python/lambda_context.py

@@ -4,7 +4,7 @@
 
 from abc import abstractmethod
 from dataclasses import dataclass
-from typing import TYPE_CHECKING, Any, Generic, Protocol, TypeVar
+from typing import TYPE_CHECKING, Any, Generic, Protocol, TypeVar, runtime_checkable
 
 if TYPE_CHECKING:
     from collections.abc import Callable, Mapping, Sequence
@@ -135,3 +135,39 @@ def create_callback(
     ) -> Callback:
         """Create a callback."""
         ...  # pragma: no cover
+
+
+class CognitoIdentity(Protocol):  # pragma: no cover
+    cognito_identity_id: str | None
+    cognito_identity_pool_id: str | None
+
+
+class Client(Protocol):  # pragma: no cover
+    installation_id: str | None
+    app_title: str | None
+    app_version_name: str | None
+    app_version_code: str | None
+    app_package_name: str | None
+
+
+class ClientContext(Protocol):  # pragma: no cover
+    custom: str | None
+    env: str | None
+    client: Client | None
+
+
+@runtime_checkable
+class LambdaContext(Protocol):  # pragma: no cover
+    aws_request_id: str
+    log_group_name: str | None
+    log_stream_name: str | None
+    function_name: str | None
+    memory_limit_in_mb: str | None
+    function_version: str | None
+    invoked_function_arn: str | None
+    tenant_id: str | None
+    client_context: ClientContext | None
+    identity: CognitoIdentity
+
+    def get_remaining_time_in_millis(self) -> int: ...
+    def log(self, msg) -> None: ...