Merge branch 'main' into main

README.md

@@ -30,10 +30,6 @@
     <img src="https://img.shields.io/pypi/pyversions/faststream.svg" alt="Supported Python versions"/>
   </a>
 
-  <a href="https://gurubase.io/g/faststream" target="_blank">
-    <img src="https://img.shields.io/badge/Gurubase-Ask%20FastStream%20Guru-006BFF" alt="Gurubase"/>
-  </a>
-
   <br/>
 
   <a href="https://github.com/airtai/faststream/actions/workflows/pr_codeql.yaml" target="_blank">
@@ -59,6 +55,12 @@
   <a href="https://t.me/python_faststream" target="_blank">
     <img alt="Telegram" src="https://img.shields.io/badge/-telegram-black?color=blue&logo=telegram&label=RU"/>
   </a>
+
+  <br/>
+
+  <a href="https://gurubase.io/g/faststream" target="_blank">
+    <img src="https://img.shields.io/badge/Gurubase-Ask%20FastStream%20Guru-006BFF" alt="Gurubase"/>
+  </a>
 </p>
 
 ---

docs/docs/en/faststream.md

@@ -62,6 +62,12 @@ search:
   <a href="https://t.me/python_faststream" target="_blank">
     <img alt="Telegram" src="https://img.shields.io/badge/-telegram-black?color=blue&logo=telegram&label=RU"/>
   </a>
+
+  <br/>
+
+  <a href="https://gurubase.io/g/faststream" target="_blank">
+    <img alt="Gurubase" src="https://img.shields.io/badge/Gurubase-Ask%20FastStream%20Guru-006BFF"/>
+  </a>
 </p>
 
 ---

faststream/__about__.py

@@ -1,5 +1,5 @@
 """Simple and fast framework to create message brokers based microservices."""
 
-__version__ = "0.5.29"
+__version__ = "0.5.30"
 
 SERVICE_NAME = f"faststream-{__version__}"

faststream/nats/broker/broker.py

@@ -194,6 +194,10 @@ class NatsInitKwargs(TypedDict, total=False):
             Doc("A user credentials file or tuple of files."),
         ]
         nkeys_seed: Annotated[
+            Optional[str],
+            Doc("Path-like object containing nkeys seed that will be used."),
+        ]
+        nkeys_seed_str: Annotated[
             Optional[str],
             Doc("Nkeys seed to be used."),
         ]
@@ -350,7 +354,11 @@ def __init__(
         ] = None,
         nkeys_seed: Annotated[
             Optional[str],
-            Doc("Nkeys seed to be used."),
+            Doc("Path-like object containing nkeys seed that will be used."),
+        ] = None,
+        nkeys_seed_str: Annotated[
+            Optional[str],
+            Doc("Raw nkeys seed to be used."),
         ] = None,
         inbox_prefix: Annotated[
             Union[str, bytes],
@@ -509,6 +517,7 @@ def __init__(
             token=token,
             user_credentials=user_credentials,
             nkeys_seed=nkeys_seed,
+            nkeys_seed_str=nkeys_seed_str,
             **secure_kwargs,
             # callbacks
             error_cb=self._log_connection_broken(error_cb),