docs: Add docstrings to SeamWebhook class

Author: andrii-balitskyi

seam/seam_webhook.py

@@ -4,11 +4,40 @@
 
 
 class SeamWebhook:
+    """
+    A class to handle Seam webhook verification.
+
+    This class provides functionality to verify incoming webhook payloads
+    using the Svix library.
+    """
+
     def __init__(self, secret: str):
+        """
+        Initialize the SeamWebhook instance.
+
+        Args:
+            secret (str): The secret key used for webhook verification.
+        """
         self._webhook = Webhook(secret)
 
     def verify(self, payload: str, headers: Dict[str, str]) -> SeamEvent:
+        """
+        Verify the incoming webhook payload and headers.
+
+        This method normalizes the headers, verifies the payload using the Svix
+        Webhook instance, and returns a SeamEvent object.
+
+        Args:
+            payload (str): The webhook payload as a string.
+            headers (Dict[str, str]): A dictionary of HTTP headers.
+
+        Returns:
+            SeamEvent: An instance of SeamEvent created from the verified payload.
+
+        Raises:
+            Any exceptions raised by the Svix Webhook.verify() method.
+        """
         normalized_headers = {k.lower(): v for k, v in headers.items()}
         res = self._webhook.verify(payload, normalized_headers)
 
-        return SeamEvent.from_dict(res)
+        return SeamEvent.from_dict(res)