reflex 0.8.17a1__py3-none-any.whl → 0.8.18a1__py3-none-any.whl

reflex/app.py

@@ -120,7 +120,7 @@ from reflex.utils.exec import (
 )
 from reflex.utils.imports import ImportVar
 from reflex.utils.misc import run_in_thread
-from reflex.utils.token_manager import TokenManager
+from reflex.utils.token_manager import RedisTokenManager, TokenManager
 from reflex.utils.types import ASGIApp, Message, Receive, Scope, Send
 
 if TYPE_CHECKING:
@@ -2033,11 +2033,13 @@ class EventNamespace(AsyncNamespace):
         self._token_manager = TokenManager.create()
 
     @property
-    def token_to_sid(self) -> dict[str, str]:
+    def token_to_sid(self) -> Mapping[str, str]:
         """Get token to SID mapping for backward compatibility.
 
+        Note: this mapping is read-only.
+
         Returns:
-            The token to SID mapping dict.
+            The token to SID mapping.
         """
         # For backward compatibility, expose the underlying dict
         return self._token_manager.token_to_sid
@@ -2059,6 +2061,9 @@ class EventNamespace(AsyncNamespace):
             sid: The Socket.IO session id.
             environ: The request information, including HTTP headers.
         """
+        if isinstance(self._token_manager, RedisTokenManager):
+            # Make sure this instance is watching for updates from other instances.
+            self._token_manager.ensure_lost_and_found_task(self.emit_update)
         query_params = urllib.parse.parse_qs(environ.get("QUERY_STRING", ""))
         token_list = query_params.get("token", [])
         if token_list:
@@ -2072,11 +2077,14 @@ class EventNamespace(AsyncNamespace):
                 f"Frontend version {subprotocol} for session {sid} does not match the backend version {constants.Reflex.VERSION}."
             )
 
-    def on_disconnect(self, sid: str):
+    def on_disconnect(self, sid: str) -> asyncio.Task | None:
         """Event for when the websocket disconnects.
 
         Args:
             sid: The Socket.IO session id.
+
+        Returns:
+            An asyncio Task for cleaning up the token, or None.
         """
         # Get token before cleaning up
         disconnect_token = self.sid_to_token.get(sid)
@@ -2091,6 +2099,8 @@ class EventNamespace(AsyncNamespace):
                 lambda t: t.exception()
                 and console.error(f"Token cleanup error: {t.exception()}")
             )
+            return task
+        return None
 
     async def emit_update(self, update: StateUpdate, token: str) -> None:
         """Emit an update to the client.
@@ -2100,16 +2110,30 @@ class EventNamespace(AsyncNamespace):
             token: The client token (tab) associated with the event.
         """
         client_token, _ = _split_substate_key(token)
-        sid = self.token_to_sid.get(client_token)
-        if sid is None:
-            # If the sid is None, we are not connected to a client. Prevent sending
-            # updates to all clients.
-            console.warn(f"Attempting to send delta to disconnected client {token!r}")
+        socket_record = self._token_manager.token_to_socket.get(client_token)
+        if (
+            socket_record is None
+            or socket_record.instance_id != self._token_manager.instance_id
+        ):
+            if isinstance(self._token_manager, RedisTokenManager):
+                # The socket belongs to another instance of the app, send it to the lost and found.
+                if not await self._token_manager.emit_lost_and_found(
+                    client_token, update
+                ):
+                    console.warn(
+                        f"Failed to send delta to lost and found for client {token!r}"
+                    )
+            else:
+                # If the socket record is None, we are not connected to a client. Prevent sending
+                # updates to all clients.
+                console.warn(
+                    f"Attempting to send delta to disconnected client {token!r}"
+                )
             return
         # Creating a task prevents the update from being blocked behind other coroutines.
         await asyncio.create_task(
-            self.emit(str(constants.SocketEvent.EVENT), update, to=sid),
-            name=f"reflex_emit_event|{token}|{sid}|{time.time()}",
+            self.emit(str(constants.SocketEvent.EVENT), update, to=socket_record.sid),
+            name=f"reflex_emit_event|{token}|{socket_record.sid}|{time.time()}",
         )
 
     async def on_event(self, sid: str, data: Any):

reflex/components/base/error_boundary.py

@@ -4,7 +4,7 @@ from __future__ import annotations
 
 from reflex.components.component import Component
 from reflex.components.datadisplay.logo import svg_logo
-from reflex.components.el import a, button, details, div, h2, hr, p, pre, summary
+from reflex.components.el import a, button, div, h2, hr, p, pre, svg
 from reflex.event import EventHandler, set_clipboard
 from reflex.state import FrontendEventExceptionState
 from reflex.vars.base import Var
@@ -65,53 +65,67 @@ class ErrorBoundary(Component):
                     div(
                         div(
                             div(
+                                svg(
+                                    svg.circle(cx="12", cy="12", r="10"),
+                                    svg.path(d="M16 16s-1.5-2-4-2-4 2-4 2"),
+                                    svg.line(x1="9", x2="9.01", y1="9", y2="9"),
+                                    svg.line(x1="15", x2="15.01", y1="9", y2="9"),
+                                    xmlns="http://www.w3.org/2000/svg",
+                                    width="25vmin",
+                                    view_box="0 0 24 24",
+                                    class_name="lucide lucide-frown-icon lucide-frown",
+                                    custom_attrs={
+                                        "fill": "none",
+                                        "stroke": "currentColor",
+                                        "stroke-width": "2",
+                                        "stroke-linecap": "round",
+                                        "stroke-linejoin": "round",
+                                    },
+                                ),
                                 h2(
                                     "An error occurred while rendering this page.",
-                                    font_size="1.25rem",
+                                    font_size="5vmin",
                                     font_weight="bold",
                                 ),
-                                p(
-                                    "This is an error with the application itself.",
-                                    opacity="0.75",
-                                ),
-                                details(
-                                    summary("Error message", padding="0.5rem"),
-                                    div(
-                                        div(
-                                            pre(
-                                                Var(_js_expr=_ERROR_DISPLAY),
-                                            ),
-                                            padding="0.5rem",
-                                            width="fit-content",
-                                        ),
-                                        width="100%",
-                                        max_height="50vh",
-                                        overflow="auto",
-                                        background="#000",
-                                        color="#fff",
-                                        border_radius="0.25rem",
-                                    ),
-                                    button(
-                                        "Copy",
-                                        on_click=set_clipboard(
-                                            Var(_js_expr=_ERROR_DISPLAY)
-                                        ),
-                                        padding="0.35rem 0.75rem",
-                                        margin="0.5rem",
-                                        background="#fff",
-                                        color="#000",
-                                        border="1px solid #000",
-                                        border_radius="0.25rem",
-                                        font_weight="bold",
+                                opacity="0.5",
+                                display="flex",
+                                gap="4vmin",
+                                align_items="center",
+                            ),
+                            p(
+                                "This is an error with the application itself. Refreshing the page might help.",
+                                opacity="0.75",
+                                margin_block="1rem",
+                            ),
+                            div(
+                                div(
+                                    pre(
+                                        Var(_js_expr=_ERROR_DISPLAY),
                                     ),
+                                    padding="0.5rem",
+                                    width="fit-content",
                                 ),
-                                display="flex",
-                                flex_direction="column",
-                                gap="1rem",
-                                max_width="50ch",
-                                border="1px solid #888888",
-                                border_radius="0.25rem",
-                                padding="1rem",
+                                width="100%",
+                                background="color-mix(in srgb, currentColor 5%, transparent)",
+                                max_height="15rem",
+                                overflow="auto",
+                                border_radius="0.4rem",
+                            ),
+                            button(
+                                "Copy",
+                                on_click=set_clipboard(Var(_js_expr=_ERROR_DISPLAY)),
+                                padding="0.35rem 1.35rem",
+                                margin_block="0.5rem",
+                                margin_inline_start="auto",
+                                background="color-mix(in srgb, currentColor 15%, transparent)",
+                                border_radius="0.4rem",
+                                width="fit-content",
+                                _hover={
+                                    "background": "color-mix(in srgb, currentColor 25%, transparent)"
+                                },
+                                _active={
+                                    "background": "color-mix(in srgb, currentColor 35%, transparent)"
+                                },
                             ),
                             hr(
                                 border_color="currentColor",
@@ -131,7 +145,10 @@ class ErrorBoundary(Component):
                             ),
                             display="flex",
                             flex_direction="column",
-                            gap="1rem",
+                            gap="0.5rem",
+                            max_width="min(80ch, 90vw)",
+                            border_radius="0.25rem",
+                            padding="1rem",
                         ),
                         height="100%",
                         width="100%",

reflex/components/lucide/icon.py

@@ -6,7 +6,7 @@ from reflex.utils.imports import ImportVar
 from reflex.vars.base import LiteralVar, Var
 from reflex.vars.sequence import LiteralStringVar, StringVar
 
-LUCIDE_LIBRARY = "lucide-react@0.546.0"
+LUCIDE_LIBRARY = "lucide-react@0.548.0"
 
 
 class LucideIconComponent(Component):
@@ -286,6 +286,7 @@ LUCIDE_ICON_LIST = [
     "binoculars",
     "biohazard",
     "bird",
+    "birdhouse",
     "bitcoin",
     "blend",
     "blinds",
@@ -828,6 +829,7 @@ LUCIDE_ICON_LIST = [
     "gallery_vertical_end",
     "gallery_vertical",
     "gamepad_2",
+    "gamepad_directional",
     "gamepad",
     "gantt_chart",
     "gauge",

reflex/components/lucide/icon.pyi

@@ -11,7 +11,7 @@ from reflex.components.core.breakpoints import Breakpoints
 from reflex.event import EventType, PointerEventInfo
 from reflex.vars.base import Var
 
-LUCIDE_LIBRARY = "lucide-react@0.545.0"
+LUCIDE_LIBRARY = "lucide-react@0.548.0"
 
 class LucideIconComponent(Component):
     @classmethod
@@ -347,6 +347,7 @@ LUCIDE_ICON_LIST = [
     "binoculars",
     "biohazard",
     "bird",
+    "birdhouse",
     "bitcoin",
     "blend",
     "blinds",
@@ -889,6 +890,7 @@ LUCIDE_ICON_LIST = [
     "gallery_vertical_end",
     "gallery_vertical",
     "gamepad_2",
+    "gamepad_directional",
     "gamepad",
     "gantt_chart",
     "gauge",
@@ -1176,6 +1178,7 @@ LUCIDE_ICON_LIST = [
     "minimize",
     "minus",
     "monitor_check",
+    "monitor_cloud",
     "monitor_cog",
     "monitor_dot",
     "monitor_down",

reflex/constants/installer.py

@@ -14,7 +14,7 @@ class Bun(SimpleNamespace):
     """Bun constants."""
 
     # The Bun version.
-    VERSION = "1.3.0"
+    VERSION = "1.3.1"
 
     # Min Bun Version
     MIN_VERSION = "1.3.0"

reflex/istate/manager/redis.py

@@ -67,6 +67,7 @@ class StateManagerRedis(StateManager):
     # The keyspace subscription string when redis is waiting for lock to be released.
     _redis_notify_keyspace_events: str = dataclasses.field(
         default="K"  # Enable keyspace notifications (target a particular key)
+        "$"  # For String commands (like setting keys)
         "g"  # For generic commands (DEL, EXPIRE, etc)
         "x"  # For expired events
         "e"  # For evicted events (i.e. maxmemory exceeded)
@@ -76,7 +77,6 @@ class StateManagerRedis(StateManager):
     _redis_keyspace_lock_release_events: set[bytes] = dataclasses.field(
         default_factory=lambda: {
             b"del",
-            b"expire",
             b"expired",
             b"evicted",
         }

reflex/plugins/tailwind_v4.py

@@ -17,7 +17,7 @@ class Constants(SimpleNamespace):
     """Tailwind constants."""
 
     # The Tailwindcss version
-    VERSION = "tailwindcss@4.1.15"
+    VERSION = "tailwindcss@4.1.16"
     # The Tailwind config.
     CONFIG = "tailwind.config.js"
     # Default Tailwind content paths
@@ -156,7 +156,7 @@ class TailwindV4Plugin(TailwindPlugin):
         return [
             *super().get_frontend_development_dependencies(**context),
             Constants.VERSION,
-            "@tailwindcss/postcss@4.1.15",
+            "@tailwindcss/postcss@4.1.16",
         ]
 
     def pre_compile(self, **context):

reflex/state.py

@@ -2189,14 +2189,12 @@ class BaseState(EvenMoreBasicBaseState):
     async def __aenter__(self) -> BaseState:
         """Enter the async context manager protocol.
 
-        This should not be used for the State class, but exists for
-        type-compatibility with StateProxy.
+        This is a no-op for the State class and mainly used in background-tasks/StateProxy.
 
-        Raises:
-            TypeError: always, because async contextmanager protocol is only supported for background task.
+        Returns:
+            The unmodified state (self)
         """
-        msg = "Only background task should use `async with self` to modify state."
-        raise TypeError(msg)
+        return self
 
     async def __aexit__(self, *exc_info: Any) -> None:
         """Exit the async context manager protocol.
@@ -2486,6 +2484,14 @@ class FrontendEventExceptionState(State):
         ),
         re.compile(re.escape("TypeError: null is not an object")),  # Safari
         re.compile(r"TypeError: can't access property \".*\" of null"),  # Firefox
+        # Firefox: property access is on a function that returns null.
+        re.compile(
+            re.escape("TypeError: can't access property \"")
+            + r".*"
+            + re.escape('", ')
+            + r".*"
+            + re.escape(" is null")
+        ),
     ]
 
     @event

reflex/utils/prerequisites.py

@@ -5,6 +5,7 @@ from __future__ import annotations
 import contextlib
 import importlib
 import importlib.metadata
+import inspect
 import json
 import random
 import re
@@ -435,7 +436,9 @@ async def get_redis_status() -> dict[str, bool | None]:
         status = True
         redis_client = get_redis()
         if redis_client is not None:
-            await redis_client.ping()
+            ping_command = redis_client.ping()
+            if inspect.isawaitable(ping_command):
+                await ping_command
         else:
             status = None
     except RedisError:

reflex/utils/token_manager.py

@@ -2,10 +2,17 @@
 
 from __future__ import annotations
 
+import asyncio
+import dataclasses
+import json
 import uuid
 from abc import ABC, abstractmethod
-from typing import TYPE_CHECKING
+from collections.abc import AsyncIterator, Callable, Coroutine
+from types import MappingProxyType
+from typing import TYPE_CHECKING, Any, ClassVar
 
+from reflex.istate.manager.redis import StateManagerRedis
+from reflex.state import BaseState, StateUpdate
 from reflex.utils import console, prerequisites
 
 if TYPE_CHECKING:
@@ -21,16 +28,54 @@ def _get_new_token() -> str:
     return str(uuid.uuid4())
 
 
+@dataclasses.dataclass(frozen=True, kw_only=True)
+class SocketRecord:
+    """Record for a connected socket client."""
+
+    instance_id: str
+    sid: str
+
+
+@dataclasses.dataclass(frozen=True, kw_only=True)
+class LostAndFoundRecord:
+    """Record for a StateUpdate for a token with its socket on another instance."""
+
+    token: str
+    update: dict[str, Any]
+
+
 class TokenManager(ABC):
     """Abstract base class for managing client token to session ID mappings."""
 
     def __init__(self):
         """Initialize the token manager with local dictionaries."""
-        # Keep a mapping between socket ID and client token.
-        self.token_to_sid: dict[str, str] = {}
+        # Each process has an instance_id to identify its own sockets.
+        self.instance_id: str = _get_new_token()
         # Keep a mapping between client token and socket ID.
+        self.token_to_socket: dict[str, SocketRecord] = {}
+        # Keep a mapping between socket ID and client token.
         self.sid_to_token: dict[str, str] = {}
 
+    @property
+    def token_to_sid(self) -> MappingProxyType[str, str]:
+        """Read-only compatibility property for token_to_socket mapping.
+
+        Returns:
+            The token to session ID mapping.
+        """
+        return MappingProxyType({
+            token: sr.sid for token, sr in self.token_to_socket.items()
+        })
+
+    async def enumerate_tokens(self) -> AsyncIterator[str]:
+        """Iterate over all tokens in the system.
+
+        Yields:
+            All client tokens known to the TokenManager.
+        """
+        for token in self.token_to_socket:
+            yield token
+
     @abstractmethod
     async def link_token_to_sid(self, token: str, sid: str) -> str | None:
         """Link a token to a session ID.
@@ -68,7 +113,9 @@ class TokenManager(ABC):
 
     async def disconnect_all(self):
         """Disconnect all tracked tokens when the server is going down."""
-        token_sid_pairs: set[tuple[str, str]] = set(self.token_to_sid.items())
+        token_sid_pairs: set[tuple[str, str]] = {
+            (token, sr.sid) for token, sr in self.token_to_socket.items()
+        }
         token_sid_pairs.update(
             ((token, sid) for sid, token in self.sid_to_token.items())
         )
@@ -95,14 +142,20 @@ class LocalTokenManager(TokenManager):
             New token if duplicate detected and new token generated, None otherwise.
         """
         # Check if token is already mapped to a different SID (duplicate tab)
-        if token in self.token_to_sid and sid != self.token_to_sid.get(token):
+        if (
+            socket_record := self.token_to_socket.get(token)
+        ) is not None and sid != socket_record.sid:
             new_token = _get_new_token()
-            self.token_to_sid[new_token] = sid
+            self.token_to_socket[new_token] = SocketRecord(
+                instance_id=self.instance_id, sid=sid
+            )
             self.sid_to_token[sid] = new_token
             return new_token
 
         # Normal case - link token to SID
-        self.token_to_sid[token] = sid
+        self.token_to_socket[token] = SocketRecord(
+            instance_id=self.instance_id, sid=sid
+        )
         self.sid_to_token[sid] = token
         return None
 
@@ -114,7 +167,7 @@ class LocalTokenManager(TokenManager):
             sid: The Socket.IO session ID.
         """
         # Clean up both mappings
-        self.token_to_sid.pop(token, None)
+        self.token_to_socket.pop(token, None)
         self.sid_to_token.pop(sid, None)
 
 
@@ -125,6 +178,8 @@ class RedisTokenManager(LocalTokenManager):
     for cross-worker duplicate detection.
     """
 
+    _token_socket_record_prefix: ClassVar[str] = "token_manager_socket_record_"
+
     def __init__(self, redis: Redis):
         """Initialize the Redis token manager.
 
@@ -142,6 +197,10 @@ class RedisTokenManager(LocalTokenManager):
         config = get_config()
         self.token_expiration = config.redis_token_expiration
 
+        # Pub/sub tasks for handling sockets owned by other instances.
+        self._socket_record_task: asyncio.Task | None = None
+        self._lost_and_found_task: asyncio.Task | None = None
+
     def _get_redis_key(self, token: str) -> str:
         """Get Redis key for token mapping.
 
@@ -149,9 +208,78 @@ class RedisTokenManager(LocalTokenManager):
             token: The client token.
 
         Returns:
-            Redis key following Reflex conventions: {token}_sid
+            Redis key following Reflex conventions: token_manager_socket_record_{token}
+        """
+        return f"{self._token_socket_record_prefix}{token}"
+
+    async def enumerate_tokens(self) -> AsyncIterator[str]:
+        """Iterate over all tokens in the system.
+
+        Yields:
+            All client tokens known to the RedisTokenManager.
         """
-        return f"{token}_sid"
+        cursor = 0
+        while scan_result := await self.redis.scan(
+            cursor=cursor, match=self._get_redis_key("*")
+        ):
+            cursor = int(scan_result[0])
+            for key in scan_result[1]:
+                yield key.decode().replace(self._token_socket_record_prefix, "")
+            if not cursor:
+                break
+
+    def _handle_socket_record_del(self, token: str) -> None:
+        """Handle deletion of a socket record from Redis.
+
+        Args:
+            token: The client token whose record was deleted.
+        """
+        if (
+            socket_record := self.token_to_socket.pop(token, None)
+        ) is not None and socket_record.instance_id != self.instance_id:
+            self.sid_to_token.pop(socket_record.sid, None)
+
+    async def _subscribe_socket_record_updates(self, redis_db: int) -> None:
+        """Subscribe to Redis keyspace notifications for socket record updates."""
+        async with self.redis.pubsub() as pubsub:
+            await pubsub.psubscribe(
+                f"__keyspace@{redis_db}__:{self._get_redis_key('*')}"
+            )
+            async for message in pubsub.listen():
+                if message["type"] == "pmessage":
+                    key = message["channel"].split(b":", 1)[1].decode()
+                    token = key.replace(self._token_socket_record_prefix, "")
+
+                    if token not in self.token_to_socket:
+                        # We don't know about this token, skip
+                        continue
+
+                    event = message["data"].decode()
+                    if event in ("del", "expired", "evicted"):
+                        self._handle_socket_record_del(token)
+                    elif event == "set":
+                        await self._get_token_owner(token, refresh=True)
+
+    async def _socket_record_updates_forever(self) -> None:
+        """Background task to monitor Redis keyspace notifications for socket record updates."""
+        await StateManagerRedis(
+            state=BaseState, redis=self.redis
+        )._enable_keyspace_notifications()
+        redis_db = self.redis.get_connection_kwargs().get("db", 0)
+        while True:
+            try:
+                await self._subscribe_socket_record_updates(redis_db)
+            except asyncio.CancelledError:  # noqa: PERF203
+                break
+            except Exception as e:
+                console.error(f"RedisTokenManager socket record update task error: {e}")
+
+    def _ensure_socket_record_task(self) -> None:
+        """Ensure the socket record updates subscriber task is running."""
+        if self._socket_record_task is None or self._socket_record_task.done():
+            self._socket_record_task = asyncio.create_task(
+                self._socket_record_updates_forever()
+            )
 
     async def link_token_to_sid(self, token: str, sid: str) -> str | None:
         """Link a token to a session ID with Redis-based duplicate detection.
@@ -164,9 +292,14 @@ class RedisTokenManager(LocalTokenManager):
             New token if duplicate detected and new token generated, None otherwise.
         """
         # Fast local check first (handles reconnections)
-        if token in self.token_to_sid and self.token_to_sid[token] == sid:
+        if (
+            socket_record := self.token_to_socket.get(token)
+        ) is not None and sid == socket_record.sid:
             return None  # Same token, same SID = reconnection, no Redis check needed
 
+        # Make sure the update subscriber is running
+        self._ensure_socket_record_task()
+
         # Check Redis for cross-worker duplicates
         redis_key = self._get_redis_key(token)
 
@@ -176,34 +309,29 @@ class RedisTokenManager(LocalTokenManager):
             console.error(f"Redis error checking token existence: {e}")
             return await super().link_token_to_sid(token, sid)
 
+        new_token = None
         if token_exists_in_redis:
             # Duplicate exists somewhere - generate new token
-            new_token = _get_new_token()
-            new_redis_key = self._get_redis_key(new_token)
-
-            try:
-                # Store in Redis
-                await self.redis.set(new_redis_key, "1", ex=self.token_expiration)
-            except Exception as e:
-                console.error(f"Redis error storing new token: {e}")
-                # Still update local dicts and continue
+            token = new_token = _get_new_token()
+            redis_key = self._get_redis_key(new_token)
 
-            # Store in local dicts (always do this)
-            self.token_to_sid[new_token] = sid
-            self.sid_to_token[sid] = new_token
-            return new_token
+        # Store in local dicts
+        socket_record = self.token_to_socket[token] = SocketRecord(
+            instance_id=self.instance_id, sid=sid
+        )
+        self.sid_to_token[sid] = token
 
-        # Normal case - store in both Redis and local dicts
+        # Store in Redis if possible
         try:
-            await self.redis.set(redis_key, "1", ex=self.token_expiration)
+            await self.redis.set(
+                redis_key,
+                json.dumps(dataclasses.asdict(socket_record)),
+                ex=self.token_expiration,
+            )
         except Exception as e:
             console.error(f"Redis error storing token: {e}")
-            # Continue with local storage
-
-        # Store in local dicts (always do this)
-        self.token_to_sid[token] = sid
-        self.sid_to_token[sid] = token
-        return None
+        # Return the new token if one was generated
+        return new_token
 
     async def disconnect_token(self, token: str, sid: str) -> None:
         """Clean up token mapping when client disconnects.
@@ -213,7 +341,11 @@ class RedisTokenManager(LocalTokenManager):
             sid: The Socket.IO session ID.
         """
         # Only clean up if we own it locally (fast ownership check)
-        if self.token_to_sid.get(token) == sid:
+        if (
+            (socket_record := self.token_to_socket.get(token)) is not None
+            and socket_record.sid == sid
+            and socket_record.instance_id == self.instance_id
+        ):
             # Clean up Redis
             redis_key = self._get_redis_key(token)
             try:
@@ -223,3 +355,124 @@ class RedisTokenManager(LocalTokenManager):
 
             # Clean up local dicts (always do this)
             await super().disconnect_token(token, sid)
+
+    @staticmethod
+    def _get_lost_and_found_key(instance_id: str) -> str:
+        """Get the Redis key for lost and found deltas for an instance.
+
+        Args:
+            instance_id: The instance ID.
+
+        Returns:
+            The Redis key for lost and found deltas.
+        """
+        return f"token_manager_lost_and_found_{instance_id}"
+
+    async def _subscribe_lost_and_found_updates(
+        self,
+        emit_update: Callable[[StateUpdate, str], Coroutine[None, None, None]],
+    ) -> None:
+        """Subscribe to Redis channel notifications for lost and found deltas.
+
+        Args:
+            emit_update: The function to emit state updates.
+        """
+        async with self.redis.pubsub() as pubsub:
+            await pubsub.psubscribe(
+                f"channel:{self._get_lost_and_found_key(self.instance_id)}"
+            )
+            async for message in pubsub.listen():
+                if message["type"] == "pmessage":
+                    record = LostAndFoundRecord(**json.loads(message["data"].decode()))
+                    await emit_update(StateUpdate(**record.update), record.token)
+
+    async def _lost_and_found_updates_forever(
+        self,
+        emit_update: Callable[[StateUpdate, str], Coroutine[None, None, None]],
+    ):
+        """Background task to monitor Redis lost and found deltas.
+
+        Args:
+            emit_update: The function to emit state updates.
+        """
+        while True:
+            try:
+                await self._subscribe_lost_and_found_updates(emit_update)
+            except asyncio.CancelledError:  # noqa: PERF203
+                break
+            except Exception as e:
+                console.error(f"RedisTokenManager lost and found task error: {e}")
+
+    def ensure_lost_and_found_task(
+        self,
+        emit_update: Callable[[StateUpdate, str], Coroutine[None, None, None]],
+    ) -> None:
+        """Ensure the lost and found subscriber task is running.
+
+        Args:
+            emit_update: The function to emit state updates.
+        """
+        if self._lost_and_found_task is None or self._lost_and_found_task.done():
+            self._lost_and_found_task = asyncio.create_task(
+                self._lost_and_found_updates_forever(emit_update)
+            )
+
+    async def _get_token_owner(self, token: str, refresh: bool = False) -> str | None:
+        """Get the instance ID of the owner of a token.
+
+        Args:
+            token: The client token.
+            refresh: Whether to fetch the latest record from Redis.
+
+        Returns:
+            The instance ID of the owner, or None if not found.
+        """
+        if (
+            not refresh
+            and (socket_record := self.token_to_socket.get(token)) is not None
+        ):
+            return socket_record.instance_id
+
+        redis_key = self._get_redis_key(token)
+        try:
+            record_json = await self.redis.get(redis_key)
+            if record_json:
+                record_data = json.loads(record_json)
+                socket_record = SocketRecord(**record_data)
+                self.token_to_socket[token] = socket_record
+                self.sid_to_token[socket_record.sid] = token
+                return socket_record.instance_id
+            console.warn(f"Redis token owner not found for token {token}")
+        except Exception as e:
+            console.error(f"Redis error getting token owner: {e}")
+        return None
+
+    async def emit_lost_and_found(
+        self,
+        token: str,
+        update: StateUpdate,
+    ) -> bool:
+        """Emit a lost and found delta to Redis.
+
+        Args:
+            token: The client token.
+            update: The state update.
+
+        Returns:
+            True if the delta was published, False otherwise.
+        """
+        # See where this update belongs
+        owner_instance_id = await self._get_token_owner(token)
+        if owner_instance_id is None:
+            return False
+        record = LostAndFoundRecord(token=token, update=dataclasses.asdict(update))
+        try:
+            await self.redis.publish(
+                f"channel:{self._get_lost_and_found_key(owner_instance_id)}",
+                json.dumps(dataclasses.asdict(record)),
+            )
+        except Exception as e:
+            console.error(f"Redis error publishing lost and found delta: {e}")
+        else:
+            return True
+        return False

reflex/utils/types.py

@@ -633,12 +633,22 @@ def _issubclass(cls: GenericType, cls_check: GenericType, instance: Any = None)
         raise TypeError(msg) from te
 
 
-def does_obj_satisfy_typed_dict(obj: Any, cls: GenericType) -> bool:
+def does_obj_satisfy_typed_dict(
+    obj: Any,
+    cls: GenericType,
+    *,
+    nested: int = 0,
+    treat_var_as_type: bool = True,
+    treat_mutable_obj_as_immutable: bool = False,
+) -> bool:
     """Check if an object satisfies a typed dict.
 
     Args:
         obj: The object to check.
         cls: The typed dict to check against.
+        nested: How many levels deep to check.
+        treat_var_as_type: Whether to treat Var as the type it represents, i.e. _var_type.
+        treat_mutable_obj_as_immutable: Whether to treat mutable objects as immutable. Useful if a component declares a mutable object as a prop, but the value is not expected to change.
 
     Returns:
         Whether the object satisfies the typed dict.
@@ -648,19 +658,35 @@ def does_obj_satisfy_typed_dict(obj: Any, cls: GenericType) -> bool:
 
     key_names_to_values = get_type_hints(cls)
     required_keys: frozenset[str] = getattr(cls, "__required_keys__", frozenset())
+    is_closed = getattr(cls, "__closed__", False)
+    extra_items_type = getattr(cls, "__extra_items__", Any)
 
-    if not all(
-        isinstance(key, str)
-        and key in key_names_to_values
-        and _isinstance(value, key_names_to_values[key])
-        for key, value in obj.items()
-    ):
-        return False
-
-    # TODO in 3.14: Implement https://peps.python.org/pep-0728/ if it's approved
+    for key, value in obj.items():
+        if is_closed and key not in key_names_to_values:
+            return False
+        if nested:
+            if key in key_names_to_values:
+                expected_type = key_names_to_values[key]
+                if not _isinstance(
+                    value,
+                    expected_type,
+                    nested=nested - 1,
+                    treat_var_as_type=treat_var_as_type,
+                    treat_mutable_obj_as_immutable=treat_mutable_obj_as_immutable,
+                ):
+                    return False
+            else:
+                if not _isinstance(
+                    value,
+                    extra_items_type,
+                    nested=nested - 1,
+                    treat_var_as_type=treat_var_as_type,
+                    treat_mutable_obj_as_immutable=treat_mutable_obj_as_immutable,
+                ):
+                    return False
 
     # required keys are all present
-    return required_keys.issubset(required_keys)
+    return required_keys.issubset(frozenset(obj))
 
 
 def _isinstance(
@@ -721,7 +747,13 @@ def _isinstance(
         # cls is a typed dict
         if is_typeddict(cls):
             if nested:
-                return does_obj_satisfy_typed_dict(obj, cls)
+                return does_obj_satisfy_typed_dict(
+                    obj,
+                    cls,
+                    nested=nested - 1,
+                    treat_var_as_type=treat_var_as_type,
+                    treat_mutable_obj_as_immutable=treat_mutable_obj_as_immutable,
+                )
             return isinstance(obj, dict)
 
         # cls is a float

{reflex-0.8.17a1.dist-info → reflex-0.8.18a1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: reflex
-Version: 0.8.17a1
+Version: 0.8.18a1
 Summary: Web apps in pure Python.
 Project-URL: homepage, https://reflex.dev
 Project-URL: repository, https://github.com/reflex-dev/reflex
@@ -30,8 +30,8 @@ Requires-Dist: psutil<8.0,>=7.0.0; sys_platform == 'win32'
 Requires-Dist: pydantic<3.0,>=1.10.21
 Requires-Dist: python-multipart<1.0,>=0.0.20
 Requires-Dist: python-socketio<6.0,>=5.12.0
-Requires-Dist: redis<7.0,>=5.2.1
-Requires-Dist: reflex-hosting-cli>=0.1.57
+Requires-Dist: redis<8.0,>=5.2.1
+Requires-Dist: reflex-hosting-cli>=0.1.58
 Requires-Dist: rich<15,>=13
 Requires-Dist: sqlmodel<0.1,>=0.0.27
 Requires-Dist: starlette>=0.47.0

{reflex-0.8.17a1.dist-info → reflex-0.8.18a1.dist-info}/RECORD

@@ -2,7 +2,7 @@ reflex/__init__.py,sha256=7iJASSyU1dxLM-l6q6gFAkw6FniXvawAekgfwN5zKjM,10328
 reflex/__init__.pyi,sha256=Yy3exOO_7-O7fCjTKO1VDFbjPyeMM7F12WBnEXWx_tk,10428
 reflex/__main__.py,sha256=6cVrGEyT3j3tEvlEVUatpaYfbB5EF3UVY-6vc_Z7-hw,108
 reflex/admin.py,sha256=Nbc38y-M8iaRBvh1W6DQu_D3kEhO8JFvxrog4q2cB_E,434
-reflex/app.py,sha256=s3Grrt3p_Lsk9I1gOhEaxyMj0Zj0IgmfFOzmqlQU3IM,79352
+reflex/app.py,sha256=jQCqsNJkR-BhcMKVg7L4j80c_IvHPnzPsNO5lG1tHiI,80468
 reflex/assets.py,sha256=l5O_mlrTprC0lF7Rc_McOe3a0OtSLnRdNl_PqCpDCBA,3431
 reflex/base.py,sha256=ROoDZCLWyEdVqfYKnhYKPZINklTl5nHKWo2x0J4MfoE,2327
 reflex/config.py,sha256=LsHAtdH4nkSn3q_Ie-KNdOGdflLXrFICUQov29oFjVk,21229
@@ -13,7 +13,7 @@ reflex/page.py,sha256=ssCbMVFuIy60vH-YhJUzN0OxzUwXFCCD3ej56dVjp3g,3525
 reflex/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 reflex/reflex.py,sha256=urU9hMWIkmVl6BPuw_-NmfaE8Zlls4s_t31ueFl4uBo,25915
 reflex/route.py,sha256=TnS4m6Hm-b3LfGFpm37iAMEd-_JISAouPW5FqUxTAfU,7858
-reflex/state.py,sha256=IT4IxfpKfvuqKeGX6aqj1DhfJWnRJB8dgUIYxe9jnPk,96723
+reflex/state.py,sha256=xmboaoHRhD4kck15EqZ9lR_Zypdpca0v0Fgjk4eC-ng,96814
 reflex/style.py,sha256=q5Zyc16ULY9xw9CKPPawknrBXIcNNdaSLALXAgdcm2g,13298
 reflex/testing.py,sha256=EzFAVOD9iRfTlQ805NJG6vUynRt1TEkPxId5aCK8eAQ,41974
 reflex/.templates/apps/blank/assets/favicon.ico,sha256=baxxgDAQ2V4-G5Q4S2yK5uUJTUGkv-AOWBQ0xd6myUo,4286
@@ -61,7 +61,7 @@ reflex/components/base/body.py,sha256=KLPOhxVsKyjPwrY9AziCOOG_c9ckOqIhI4n2i3_Q3N
 reflex/components/base/body.pyi,sha256=u_Y3lBkSwGZlnsHWKr_Rtm49UI2bP8Rx2e99gkshENw,2357
 reflex/components/base/document.py,sha256=Fr7y22NbeKeiz8kWPH2q5BpFjKdq-AmY-sxZilee_H8,636
 reflex/components/base/document.pyi,sha256=PlvclB2vyGcQ8zLJpFac_37LHeXLwpe8Qh0UqzXAPfE,11788
-reflex/components/base/error_boundary.py,sha256=sp6W7G6uFWdls6nzl17XSizSSm6zS2OAu3ZqTE2W1CE,6438
+reflex/components/base/error_boundary.py,sha256=eXLO4SxNx2QoIC5tXk7f0kMulXNDJJaEkZNJ985FAcw,7456
 reflex/components/base/error_boundary.pyi,sha256=SvKnZ09jwIL_4-J5BKVZuATclrB4o3Eh457iTmmoNb4,2926
 reflex/components/base/fragment.py,sha256=ys7wkokq-N8WBxa9fqkEaNIrBlSximyD7vqlFVe02hQ,342
 reflex/components/base/fragment.pyi,sha256=1vl8p6SCWd0_QzYVAb-Em70IX6FwIWFvJLxMl5OJTwU,2401
@@ -139,8 +139,8 @@ reflex/components/gridjs/__init__.py,sha256=xJwDm1AZ70L5-t9LLqZwGUtDpijbf1KuMYDT
 reflex/components/gridjs/datatable.py,sha256=7JKrRw1zkpFB0_wwoaIhrVrldsm7-dyi3PASgqLq8Hc,4224
 reflex/components/gridjs/datatable.pyi,sha256=kFgv82vCgfdWZaUq4bZ73G8X3mkw6ecvSRkZ9G9-28E,5185
 reflex/components/lucide/__init__.py,sha256=EggTK2MuQKQeOBLKW-mF0VaDK9zdWBImu1HO2dvHZbE,73
-reflex/components/lucide/icon.py,sha256=WLEzDeVlS68XWj1y4F0DV6pa8S19g-vwuZxMe6BT2Yo,35396
-reflex/components/lucide/icon.pyi,sha256=oFXjvb5SBULQlbeGDY4K5WWkqemktGIaCsiyrentjKY,37987
+reflex/components/lucide/icon.py,sha256=4m82j8mWmgQZ-nl1vzBDjhF5rTAq9ZvlvG9dqNc39uI,35440
+reflex/components/lucide/icon.pyi,sha256=KAdU8jt0vmXokueKPegCSwradW0oWyWB9kV4kPoef-8,38052
 reflex/components/markdown/__init__.py,sha256=Dfl1At5uYoY7H4ufZU_RY2KOGQDLtj75dsZ2BTqqAns,87
 reflex/components/markdown/markdown.py,sha256=Sg3AioKZsNn27KdOzR3o53k1bHzPa2pjpHFVYbxBgCg,16464
 reflex/components/markdown/markdown.pyi,sha256=5SbgUBrklIdxEJOHtOqKVM2aobgulnkWp5DEGUFNmEI,4323
@@ -319,7 +319,7 @@ reflex/constants/compiler.py,sha256=1FXPYQNotaSrTwWcOspA1gCVmEdoiWkNMbbrz_qU0YU,
 reflex/constants/config.py,sha256=8OIjiBdZZJrRVHsNBheMwopE9AwBFFzau0SXqXKcrPg,1715
 reflex/constants/custom_components.py,sha256=joJt4CEt1yKy7wsBH6vYo7_QRW0O_fWXrrTf0VY2q14,1317
 reflex/constants/event.py,sha256=tgoynWQi2L0_Kqc3XhXo7XXL76A-OKhJGHRrNjm7gFw,2885
-reflex/constants/installer.py,sha256=iZvdnTIl2zh0_fPr1G-RsOiHbA4vnnse8ykPJVFBUbE,4191
+reflex/constants/installer.py,sha256=JUTIXWqN_IET_kCJzowVVqrzcdrcGtGIErBJbNa3D2s,4191
 reflex/constants/route.py,sha256=UBjqaAOxiUxlDZCSY4O2JJChKvA4MZrhUU0E5rNvKbM,2682
 reflex/constants/state.py,sha256=VrEeYxXfE9ss8RmOHIXD4T6EGsV9PDqbtMCQMmZxW3I,383
 reflex/constants/utils.py,sha256=e1ChEvbHfmE_V2UJvCSUhD_qTVAIhEGPpRJSqdSd6PA,780
@@ -337,7 +337,7 @@ reflex/istate/wrappers.py,sha256=p8uuioXRbR5hperwbOJHUcWdu7hukLikQdoR7qrnKsI,909
 reflex/istate/manager/__init__.py,sha256=hTg5uqxVbz-xayUZNin-wP51PfAkz1CHDez-jncXTTg,4406
 reflex/istate/manager/disk.py,sha256=RVWDnPt4d2a0El8RBnWDVCksLKv7rPuWbkUPR6Y7Szc,13736
 reflex/istate/manager/memory.py,sha256=tnK2JzJNcEbiXAdGIT5tNA0U1-mQZoeXKF8XNJCfnts,2760
-reflex/istate/manager/redis.py,sha256=LGR8ilvrCZmxKznhIKBHP4-Oe_JT5htcoJldVH53MlU,19020
+reflex/istate/manager/redis.py,sha256=n2JREGIUwevlvx_Kt-b4i1RSrQZCTZUBVMwNOpIeTec,19052
 reflex/middleware/__init__.py,sha256=x7xTeDuc73Hjj43k1J63naC9x8vzFxl4sq7cCFBX7sk,111
 reflex/middleware/hydrate_middleware.py,sha256=1ch7bx2ZhojOR15b-LHD2JztrWCnpPJjTe8MWHJe-5Y,1510
 reflex/middleware/middleware.py,sha256=p5VVoIgQ_NwOg_GOY6g0S4fmrV76_VE1zt-HiwbMw-s,1158
@@ -347,7 +347,7 @@ reflex/plugins/base.py,sha256=5BgzCM7boj9kJ6FGzVzVlgQk-crJuVmOLCl1PXvv4-E,3372
 reflex/plugins/shared_tailwind.py,sha256=XPnswswPW3UIeEu5ghecdEeYtpikG5ksD92sM-VwKYM,7221
 reflex/plugins/sitemap.py,sha256=X_CtH5B1w3CZno-gdPj1rp63WjOuNjFnX4B3fx_-VFQ,6135
 reflex/plugins/tailwind_v3.py,sha256=jCEZ5UYdr706Mw48L-WSHOUB6O55o1C3uG6AMwXqZoI,4810
-reflex/plugins/tailwind_v4.py,sha256=Cjp3vJnrZDYiflwm4imj4SEI0pYBv36mLvmpbI6olao,5230
+reflex/plugins/tailwind_v4.py,sha256=GE-GTFFqBPQ8TmIfvp2-Y3K2wyCtmICEbeYJy6tvISk,5230
 reflex/utils/__init__.py,sha256=y-AHKiRQAhk2oAkvn7W8cRVTZVK625ff8tTwvZtO7S4,24
 reflex/utils/build.py,sha256=j-OY90O7gMP_bclVt_6J3Q2GFgOHQH_uFpTfdaWmuqU,9746
 reflex/utils/codespaces.py,sha256=SIATnmlGCABPvjvRIENUCwP-fcjqKhdoOYiFY_Eua6M,4339
@@ -366,7 +366,7 @@ reflex/utils/misc.py,sha256=emPjhUsL5WV8BFwwN8I0IrYUJyB1VlhsfnTLcCB3xco,4596
 reflex/utils/monitoring.py,sha256=AZ5KZqaPBOIkfNB___rmXK0zEPjwDXHIlUDwKPVPBmI,5235
 reflex/utils/net.py,sha256=q3h5pNbAlFiqy8U15S9DTOvzy_OnenVVug5ROBTGRTA,4267
 reflex/utils/path_ops.py,sha256=_RS17IQDNr5vcoLLGZx2-z1E5WP-JgDHvaRAOgqrZiU,8154
-reflex/utils/prerequisites.py,sha256=CKrzD41-F1KA7H3oob-OtWuAHWOqUcPGbEvgYwbrphE,21164
+reflex/utils/prerequisites.py,sha256=oom949r2G_VvYiujD5FSo59LvYSkMPunJSSuJgCHsAM,21273
 reflex/utils/processes.py,sha256=UzXcQ8Qp8TyOMcHrAG7Q8K2YJcXPXhswzBqDMcok0hc,18131
 reflex/utils/pyi_generator.py,sha256=dDX7pktR6ERE5TPrM4bGhpECu1FaAFadbSqY3W0TlhU,46105
 reflex/utils/redir.py,sha256=UuVMCISI9UJTzIkQGZZPtW9wRwTsBUo4LaKPegs8dIo,1197
@@ -375,8 +375,8 @@ reflex/utils/rename.py,sha256=8f3laR0Zr3uizKKDD_1woPz-FZvUPjzD-fDeNHf7wBk,5232
 reflex/utils/serializers.py,sha256=SBjJ0s6euZYfRsb0gzZy3YQdkYkTNU9_-nzk_LyX2C4,14039
 reflex/utils/telemetry.py,sha256=_jrI6pT3bKedtPFoZXw-tU9cdIh7-fCXl30c6G2jf2M,10756
 reflex/utils/templates.py,sha256=hSZXol3_fE7d51yeK30XNsCG7ZhD6F09JNzqmBy_MaU,14099
-reflex/utils/token_manager.py,sha256=ZtrYR0X8tTs8FpQHtMb09-H2V1xSoLWwVH8jW8OCrU8,7445
-reflex/utils/types.py,sha256=CjGrLXnrPooFCpfzm8TFAf_7tZX7-eThROga4QzDxMY,38781
+reflex/utils/token_manager.py,sha256=tMD6VsPz97Xe-ZAd5vzoSbHiqWD9xt50smngs1heFZw,16796
+reflex/utils/types.py,sha256=Lz2Sf2xS2Oh0g6V0pmlJ_zoZSG7FXTEBnBF0G1NmxeI,40206
 reflex/vars/__init__.py,sha256=pUzFFkY-brpEoqYHQc41VefaOdPQG6xzjer1RJy9IKo,1264
 reflex/vars/base.py,sha256=q2YZv-FywQaC-LHvR1U3QTY8ksPYSdj5RSJEzKGOFo0,112774
 reflex/vars/color.py,sha256=PdZ50n7YqIgueIr8FKBkII-aPpD8x7xqbi3MLgI7iGQ,4856
@@ -387,8 +387,8 @@ reflex/vars/number.py,sha256=Cejba-47shtQt-j0uD_HRfTGOm1IF1uZ1WwpWSrcLSE,28865
 reflex/vars/object.py,sha256=j3b-j66Qa0XDJofMkcJtb8e-TdNx2_hjyEPnrGJEaFY,17833
 reflex/vars/sequence.py,sha256=OyCfMsv50Zr6W26DMISWjLX6FzK3rbxNcgKepgYr7Pk,52326
 scripts/hatch_build.py,sha256=-4pxcLSFmirmujGpQX9UUxjhIC03tQ_fIQwVbHu9kc0,1861
-reflex-0.8.17a1.dist-info/METADATA,sha256=iH8TN8Ktq1RI_4JtlJBly7yBfM4JMREcj_aFY9DrE3Q,13102
-reflex-0.8.17a1.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-reflex-0.8.17a1.dist-info/entry_points.txt,sha256=Rxt4dXc7MLBNt5CSHTehVPuSe9Xqow4HLX55nD9tQQ0,45
-reflex-0.8.17a1.dist-info/licenses/LICENSE,sha256=dw3zLrp9f5ObD7kqS32vWfhcImfO52PMmRqvtxq_YEE,11358
-reflex-0.8.17a1.dist-info/RECORD,,
+reflex-0.8.18a1.dist-info/METADATA,sha256=1IV_Z7FfUs-3MX_TQ2WnPzDm6g1c0AQl42D3ZB-gR6s,13102
+reflex-0.8.18a1.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+reflex-0.8.18a1.dist-info/entry_points.txt,sha256=Rxt4dXc7MLBNt5CSHTehVPuSe9Xqow4HLX55nD9tQQ0,45
+reflex-0.8.18a1.dist-info/licenses/LICENSE,sha256=dw3zLrp9f5ObD7kqS32vWfhcImfO52PMmRqvtxq_YEE,11358
+reflex-0.8.18a1.dist-info/RECORD,,