Merge branch 'main' into fix-test-warnings

Author: WilliamBergamin

docs/english/web.md

@@ -61,11 +61,8 @@ You can have your app's messages stream in to replicate conventional AI chatbot
 * [`chat_appendStream`](/reference/methods/chat.appendStream)
 * [`chat_stopStream`](/reference/methods/chat.stopStream)
 
-:::tip[The Python Slack SDK provides a [`chat_stream()`](https://docs.slack.dev/tools/python-slack-sdk/reference/web/client.html#slack_sdk.web.client.WebClient.chat_stream) helper utility to streamline calling these methods.]
 
-See the [_Streaming messages_](/tools/bolt-python/concepts/message-sending#streaming-messages) section of the Bolt for Python docs for implementation instructions. 
-
-:::
+You can streamline calling these methods by using the [`chat_stream()`](#chat_stream) helper.
 
 #### Starting the message stream {#starting-stream}
 
@@ -161,6 +158,30 @@ def handle_message(message, client):
 
 See [Formatting messages with Block Kit](#block-kit) below for more details on using Block Kit with messages.
 
+#### Using the `chat_stream()` helper {#chat_stream}
+
+The Python Slack SDK provides a [`chat_stream()`](https://docs.slack.dev/tools/python-slack-sdk/reference/web/client.html#slack_sdk.web.client.WebClient.chat_stream) helper utility to streamline calling these methods. Here's an excerpt from our [Assistant template app](https://github.com/slack-samples/bolt-python-assistant-template):
+
+```python
+streamer = client.chat_stream(
+    channel=channel_id,
+    recipient_team_id=team_id,
+    recipient_user_id=user_id,
+    thread_ts=thread_ts,
+)
+
+# Loop over OpenAI response stream
+# https://platform.openai.com/docs/api-reference/responses/create
+for event in returned_message:
+    if event.type == "response.output_text.delta":
+        streamer.append(markdown_text=f"{event.delta}")
+    else:
+        continue
+
+feedback_block = create_feedback_block()
+streamer.stop(blocks=feedback_block)
+```
+
 ## Formatting messages with Block Kit {#block-kit}
 
 Messages posted from apps can contain more than just text; they can also include full user interfaces composed of blocks using [Block Kit](/block-kit).

docs/reference/models/blocks/blocks.html

@@ -1601,7 +1601,7 @@ <h3>Inherited members</h3>
                 else:
                     field_objects.append(PlainTextObject(**d))  # type: ignore[arg-type]
             else:
-                self.logger.warning(f&#34;Unsupported filed detected and skipped {f}&#34;)
+                self.logger.warning(f&#34;Unsupported field detected and skipped {f}&#34;)
         self.fields = field_objects
         self.accessory = BlockElement.parse(accessory)  # type: ignore[arg-type]
         self.expand = expand

docs/reference/models/blocks/index.html

@@ -6592,7 +6592,7 @@ <h3>Inherited members</h3>
                 else:
                     field_objects.append(PlainTextObject(**d))  # type: ignore[arg-type]
             else:
-                self.logger.warning(f&#34;Unsupported filed detected and skipped {f}&#34;)
+                self.logger.warning(f&#34;Unsupported field detected and skipped {f}&#34;)
         self.fields = field_objects
         self.accessory = BlockElement.parse(accessory)  # type: ignore[arg-type]
         self.expand = expand

slack_sdk/models/blocks/blocks.py

@@ -179,7 +179,7 @@ def __init__(
                 else:
                     field_objects.append(PlainTextObject(**d))  # type: ignore[arg-type]
             else:
-                self.logger.warning(f"Unsupported filed detected and skipped {f}")
+                self.logger.warning(f"Unsupported field detected and skipped: {f}")
         self.fields = field_objects
         self.accessory = BlockElement.parse(accessory)  # type: ignore[arg-type]
         self.expand = expand

slack_sdk/signature/__init__.py

@@ -3,7 +3,13 @@
 import hashlib
 import hmac
 from time import time
-from typing import Dict, Optional, Union
+from typing import Dict, Optional, Union, TYPE_CHECKING
+
+# Fallback to Dict for Python 3.7/3.8 compatibility (safe to remove once these versions are no longer supported)
+if TYPE_CHECKING:
+    from collections.abc import Mapping
+else:
+    Mapping = Dict
 
 
 class Clock:
@@ -26,23 +32,23 @@ def __init__(self, signing_secret: str, clock: Clock = Clock()):
     def is_valid_request(
         self,
         body: Union[str, bytes],
-        headers: Dict[str, str],
+        headers: Mapping[str, str],
     ) -> bool:
         """Verifies if the given signature is valid"""
         if headers is None:
             return False
         normalized_headers = {k.lower(): v for k, v in headers.items()}
         return self.is_valid(
             body=body,
-            timestamp=normalized_headers.get("x-slack-request-timestamp", None),  # type: ignore[arg-type]
-            signature=normalized_headers.get("x-slack-signature", None),  # type: ignore[arg-type]
+            timestamp=normalized_headers.get("x-slack-request-timestamp", None),
+            signature=normalized_headers.get("x-slack-signature", None),
         )
 
     def is_valid(
         self,
         body: Union[str, bytes],
-        timestamp: str,
-        signature: str,
+        timestamp: Optional[str],
+        signature: Optional[str],
     ) -> bool:
         """Verifies if the given signature is valid"""
         if timestamp is None or signature is None: