pulse-framework 0.1.65__py3-none-any.whl → 0.1.66a1__py3-none-any.whl

pulse/app.py

@@ -107,8 +107,8 @@ PulseMode = Literal["subdomains", "single-server"]
 """Deployment mode for the application.
 
 Values:
-    "single-server": Python and React served from the same origin (default).
-    "subdomains": Python API on a subdomain (e.g., api.example.com).
+		"single-server": Python and React served from the same origin (default).
+		"subdomains": Python API on a subdomain (e.g., api.example.com).
 """
 
 
@@ -118,12 +118,12 @@ class ConnectionStatusConfig:
 	Configuration for connection status message delays.
 
 	Attributes:
-	    initial_connecting_delay: Delay in seconds before showing "Connecting..." message
-	        on initial connection attempt. Default: 2.0
-	    initial_error_delay: Additional delay in seconds before showing error message
-	        on initial connection attempt (after connecting message). Default: 8.0
-	    reconnect_error_delay: Delay in seconds before showing error message when
-	        reconnecting after losing connection. Default: 8.0
+			initial_connecting_delay: Delay in seconds before showing "Connecting..." message
+					on initial connection attempt. Default: 2.0
+			initial_error_delay: Additional delay in seconds before showing error message
+					on initial connection attempt (after connecting message). Default: 8.0
+			reconnect_error_delay: Delay in seconds before showing error message when
+					reconnecting after losing connection. Default: 8.0
 	"""
 
 	initial_connecting_delay: float = 2.0
@@ -171,15 +171,15 @@ class App:
 		import pulse as ps
 
 		app = ps.App(
-		    routes=[
-		        ps.Route("/", render=home),
-		        ps.Route("/users/:id", render=user_detail),
-		    ],
-		    session_timeout=120.0,
+				routes=[
+						ps.Route("/", render=home),
+						ps.Route("/users/:id", render=user_detail),
+				],
+				session_timeout=120.0,
 		)
 
 		if __name__ == "__main__":
-		    app.run(port=8000)
+				app.run(port=8000)
 		```
 	"""
 
@@ -544,10 +544,21 @@ class App:
 			paths = [ensure_absolute_path(path) for path in paths]
 			payload["paths"] = paths
 			route_info = payload.get("routeInfo")
+			debug = os.environ.get("PULSE_DEBUG_RENDER")
+			if debug:
+				logger.info(
+					"[PulseDebug][prerender] session=%s header_render_id=%s payload_render_id=%s paths=%s route_info=%s",
+					session.sid,
+					request.headers.get("x-pulse-render-id"),
+					payload.get("renderId"),
+					paths,
+					route_info,
+				)
 
 			client_addr: str | None = get_client_address(request)
 			# Reuse render session from header (set by middleware) or create new one
 			render = PulseContext.get().render
+			reused = render is not None
 			if render is not None:
 				render_id = render.id
 			else:
@@ -556,9 +567,19 @@ class App:
 				render = self.create_render(
 					render_id, session, client_address=client_addr
 				)
+			if debug:
+				logger.info(
+					"[PulseDebug][prerender] session=%s render=%s reused=%s connected=%s",
+					session.sid,
+					render_id,
+					reused,
+					render.connected,
+				)
+			print(f"Prerendering for RenderSession {render_id}")
 
 			# Schedule cleanup timeout (will cancel/reschedule on activity)
-			self._schedule_render_cleanup(render_id)
+			if not render.connected:
+				self._schedule_render_cleanup(render_id)
 
 			def _normalize_prerender_result(
 				captured: ServerInitMessage | ServerNavigateToMessage,
@@ -698,6 +719,13 @@ class App:
 			if cookie is None:
 				raise ConnectionRefusedError("Socket connect missing cookie")
 			session = await self.get_or_create_session(cookie)
+			debug = os.environ.get("PULSE_DEBUG_RENDER")
+			if debug:
+				logger.info(
+					"[PulseDebug][connect] session=%s render_id=%s",
+					session.sid,
+					rid,
+				)
 
 			if not rid:
 				# Still refuse connections without a renderId
@@ -708,6 +736,13 @@ class App:
 			# Allow reconnects where the provided renderId no longer exists by creating a new RenderSession
 			render = self.render_sessions.get(rid)
 			if render is None:
+				# The client will try to attach to a non-existing RouteMount, which will cause a reload down the line
+				if debug:
+					logger.info(
+						"[PulseDebug][connect] render_missing session=%s render_id=%s creating=true",
+						session.sid,
+						rid,
+					)
 				render = self.create_render(
 					rid, session, client_address=get_client_address_socketio(environ)
 				)
@@ -718,6 +753,15 @@ class App:
 						f"Socket connect session mismatch render={render.id} "
 						+ f"owner={owner} session={session.sid}"
 					)
+				if debug:
+					logger.info(
+						"[PulseDebug][connect] render_found session=%s render_id=%s owner=%s connected=%s",
+						session.sid,
+						render.id,
+						owner,
+						render.connected,
+					)
+			print(f"Connected to RenderSession {render.id}")
 
 			def on_message(message: ServerMessage):
 				payload = serialize(message)
@@ -830,6 +874,20 @@ class App:
 	async def _handle_pulse_message(
 		self, render: RenderSession, session: UserSession, msg: ClientPulseMessage
 	) -> None:
+		if os.environ.get("PULSE_DEBUG_RENDER") and msg["type"] in (
+			"attach",
+			"update",
+			"detach",
+		):
+			logger.info(
+				"[PulseDebug][client-message] session=%s render=%s type=%s path=%s route_info=%s",
+				session.sid,
+				render.id,
+				msg["type"],
+				msg.get("path"),
+				msg.get("routeInfo"),
+			)
+
 		async def _next() -> Ok[None]:
 			if msg["type"] == "attach":
 				render.attach(msg["path"], msg["routeInfo"])

pulse/codegen/templates/layout.py

@@ -53,15 +53,11 @@ export async function loader(args: LoaderFunctionArgs) {
   return data(prerenderData, { headers });
 }
 
-// Client loader: re-prerender on navigation while reusing renderId
+// Client loader: re-prerender on navigation while reusing directives
 export async function clientLoader(args: ClientLoaderFunctionArgs) {
   const url = new URL(args.request.url);
   const matches = matchRoutes(rrPulseRouteTree, url.pathname) ?? [];
   const paths = matches.map(m => m.route.uniquePath);
-  const renderId = 
-    typeof window !== "undefined" && typeof sessionStorage !== "undefined"
-      ? (sessionStorage.getItem("__PULSE_RENDER_ID") ?? undefined) 
-      : undefined;
   const directives = 
     typeof window !== "undefined" && typeof sessionStorage !== "undefined"
       ? (JSON.parse(sessionStorage.getItem("__PULSE_DIRECTIVES") ?? "{}"))
@@ -76,7 +72,7 @@ export async function clientLoader(args: ClientLoaderFunctionArgs) {
     method: "POST",
     headers,
     credentials: "include",
-    body: JSON.stringify({ paths, routeInfo: extractServerRouteInfo(args), renderId }),
+    body: JSON.stringify({ paths, routeInfo: extractServerRouteInfo(args) }),
   });
   if (!res.ok) throw new Error("Failed to prerender batch:" + res.status);
   const body = await res.json();
@@ -92,7 +88,6 @@ export async function clientLoader(args: ClientLoaderFunctionArgs) {
 export default function PulseLayout() {
   const data = useLoaderData<typeof loader>();
   if (typeof window !== "undefined" && typeof sessionStorage !== "undefined") {
-    sessionStorage.setItem("__PULSE_RENDER_ID", data.renderId);
     sessionStorage.setItem("__PULSE_DIRECTIVES", JSON.stringify(data.directives));
   }
   return (
@@ -101,6 +96,6 @@ export default function PulseLayout() {
     </PulseProvider>
   );
 }
-// Persist renderId and directives in sessionStorage for reuse in clientLoader is handled within the component
+// Persist directives in sessionStorage for reuse in clientLoader is handled within the component
 """
 )

pulse/render_session.py

@@ -1,5 +1,6 @@
 import asyncio
 import logging
+import os
 import traceback
 import uuid
 from asyncio import iscoroutine
@@ -137,6 +138,14 @@ class RouteMount:
 		if self.state != "pending":
 			return
 		action = self.pending_action
+		if os.environ.get("PULSE_DEBUG_RENDER"):
+			logger.info(
+				"[PulseDebug][mount-timeout] render=%s path=%s action=%s state=%s",
+				self.render.id,
+				self.path,
+				action,
+				self.state,
+			)
 		self.pending_action = None
 		if action == "dispose":
 			self.render.dispose_mount(self.path, self)
@@ -144,6 +153,15 @@ class RouteMount:
 		self.to_idle()
 
 	def start_pending(self, timeout: float, *, action: PendingAction = "idle") -> None:
+		if os.environ.get("PULSE_DEBUG_RENDER"):
+			logger.info(
+				"[PulseDebug][mount-pending] render=%s path=%s state=%s action=%s timeout=%s",
+				self.render.id,
+				self.path,
+				self.state,
+				action,
+				timeout,
+			)
 		if self.state == "pending":
 			prev_action = self.pending_action
 			next_action: PendingAction = (
@@ -166,6 +184,14 @@ class RouteMount:
 		)
 
 	def activate(self, send_message: Callable[[ServerMessage], Any]) -> None:
+		if os.environ.get("PULSE_DEBUG_RENDER"):
+			logger.info(
+				"[PulseDebug][mount-activate] render=%s path=%s state=%s queued=%s",
+				self.render.id,
+				self.path,
+				self.state,
+				0 if not self.queue else len(self.queue),
+			)
 		if self.state != "pending":
 			return
 		self._cancel_pending_timeout()
@@ -192,6 +218,12 @@ class RouteMount:
 	def to_idle(self) -> None:
 		if self.state != "pending":
 			return
+		if os.environ.get("PULSE_DEBUG_RENDER"):
+			logger.info(
+				"[PulseDebug][mount-idle] render=%s path=%s",
+				self.render.id,
+				self.path,
+			)
 		self.state = "idle"
 		self.queue = None
 		self._cancel_pending_timeout()
@@ -317,11 +349,15 @@ class RenderSession:
 
 	def connect(self, send_message: Callable[[ServerMessage], Any]):
 		"""WebSocket connected. Set sender, don't auto-flush (attach does that)."""
+		if os.environ.get("PULSE_DEBUG_RENDER"):
+			logger.info("[PulseDebug][render-connect] render=%s", self.id)
 		self._send_message = send_message
 		self.connected = True
 
 	def disconnect(self):
 		"""WebSocket disconnected. Start queuing briefly before pausing."""
+		if os.environ.get("PULSE_DEBUG_RENDER"):
+			logger.info("[PulseDebug][render-disconnect] render=%s", self.id)
 		self._send_message = None
 		self.connected = False
 
@@ -395,6 +431,13 @@ class RenderSession:
 		- Creates mounts in PENDING state and starts queue
 		"""
 		normalized = [ensure_absolute_path(path) for path in paths]
+		if os.environ.get("PULSE_DEBUG_RENDER"):
+			logger.info(
+				"[PulseDebug][prerender] render=%s paths=%s route_info=%s",
+				self.id,
+				normalized,
+				route_info,
+			)
 
 		results: dict[str, ServerInitMessage | ServerNavigateToMessage] = {}
 
@@ -402,6 +445,15 @@ class RenderSession:
 			route = self.routes.find(path)
 			info = route_info or route.default_route_info()
 			mount = self.route_mounts.get(path)
+			if os.environ.get("PULSE_DEBUG_RENDER"):
+				route_label = repr(route)
+				logger.info(
+					"[PulseDebug][prerender] render=%s path=%s mount_state=%s route=%s",
+					self.id,
+					path,
+					mount.state if mount else None,
+					route_label,
+				)
 
 			if mount is None:
 				mount = RouteMount(self, path, route, info)
@@ -440,6 +492,15 @@ class RenderSession:
 		mount = self.route_mounts.get(path)
 
 		if mount is None or mount.state == "idle":
+			if os.environ.get("PULSE_DEBUG_RENDER"):
+				logger.info(
+					"[PulseDebug][attach] render=%s path=%s mount_state=%s mounts=%s route_info=%s",
+					self.id,
+					path,
+					mount.state if mount else None,
+					{key: value.state for key, value in self.route_mounts.items()},
+					route_info,
+				)
 			# Initial render must come from prerender
 			print(f"[DEBUG] Missing or idle route '{path}', reloading")
 			self.send({"type": "reload"})
@@ -448,6 +509,12 @@ class RenderSession:
 		# Update route info for active and pending mounts
 		mount.update_route(route_info)
 		if mount.state == "pending" and self._send_message:
+			if os.environ.get("PULSE_DEBUG_RENDER"):
+				logger.info(
+					"[PulseDebug][attach] render=%s path=%s activating=true",
+					self.id,
+					path,
+				)
 			mount.activate(self._send_message)
 
 	def update_route(self, path: str, route_info: RouteInfo):
@@ -463,6 +530,13 @@ class RenderSession:
 		current = self.route_mounts.get(path)
 		if current is not mount:
 			return
+		if os.environ.get("PULSE_DEBUG_RENDER"):
+			logger.info(
+				"[PulseDebug][mount-dispose] render=%s path=%s state=%s",
+				self.id,
+				path,
+				mount.state,
+			)
 		try:
 			self.route_mounts.pop(path, None)
 			mount.dispose()

{pulse_framework-0.1.65.dist-info → pulse_framework-0.1.66a1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: pulse-framework
-Version: 0.1.65
+Version: 0.1.66a1
 Summary: Pulse - Full-stack framework for building real-time React applications in Python
 Requires-Dist: websockets>=12.0
 Requires-Dist: fastapi>=0.128.0

{pulse_framework-0.1.65.dist-info → pulse_framework-0.1.66a1.dist-info}/RECORD

@@ -1,6 +1,6 @@
 pulse/__init__.py,sha256=cXNVXz0aizbkOG1aj2zytgzodyVNv7nNylsXcWmH-Lc,32183
 pulse/_examples.py,sha256=dFuhD2EVXsbvAeexoG57s4VuN4gWLaTMOEMNYvlPm9A,561
-pulse/app.py,sha256=hYqCgesH1T4qTTcU0yDNPrx6zIgL7_BGKzVdJhLNmbM,35777
+pulse/app.py,sha256=oVwe7ioAGl7OXIEiT8J0bj5GBxEkBroOJw6qgdyA7Bg,37343
 pulse/channel.py,sha256=ePpvD2mDbddt_LMxxxDjNRgOLbVi8Ed6TmJFgkrALB0,15790
 pulse/cli/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 pulse/cli/cmd.py,sha256=zh3Ah6c16cNg3o_v_If_S58Qe8rvxNe5M2VrTkwvDU8,15957
@@ -17,7 +17,7 @@ pulse/code_analysis.py,sha256=NBba_7VtOxZYMyfku_p-bWkG0O_1pi1AxcaNyVM1nmY,1024
 pulse/codegen/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 pulse/codegen/codegen.py,sha256=Zw55vzevg_17hFtSi6KLl-EWSiABKRfZe6fB-cWpLAk,10330
 pulse/codegen/templates/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-pulse/codegen/templates/layout.py,sha256=nmWPQcO9SRXc3mCCVLCmykreSF96TqQfdDY7dvUBxRg,4737
+pulse/codegen/templates/layout.py,sha256=xz2ImZrbpu-tUkHZ38U6npIDzeYhrR_s41BuNPJUnOU,4470
 pulse/codegen/templates/route.py,sha256=UjBrb3e_8tMkd1OjBjEsnYmK6PCQqOYZBWDuU59FcrI,9234
 pulse/codegen/templates/routes_ts.py,sha256=nPgKCvU0gzue2k6KlOL1TJgrBqqRLmyy7K_qKAI8zAE,1129
 pulse/codegen/utils.py,sha256=QoXcV-h-DLLmq_t03hDNUePS0fNnofUQLoR-TXzDFCY,539
@@ -88,7 +88,7 @@ pulse/queries/store.py,sha256=4pWTDSl71LUM7YqhWanKjZkFh3t8F_04o48js_H4ttQ,3728
 pulse/react_component.py,sha256=8RLg4Bi7IcjqbnbEnp4hJpy8t1UsE7mG0UR1Q655LDk,2332
 pulse/reactive.py,sha256=GSh9wSH3THCBjDTafwWttyx7djeKBWV_KqjaKRYUNsA,31393
 pulse/reactive_extensions.py,sha256=yQ1PpdAh4kMvll7R15T72FOg8NFdG_HGBsGc63dawYk,33754
-pulse/render_session.py,sha256=-ILYIkI2N9W2fJEVSw4u7UMVEyuXNPkduYBLXsaW65U,22807
+pulse/render_session.py,sha256=w6eJcMt4VFu84HeBAmBeEogxPtiwRHnRgQSTabrSXQM,24889
 pulse/renderer.py,sha256=fjSsUvCqV12jyN7Y5XspKUfjQJJzKX-Chha5oF5PrAk,16001
 pulse/request.py,sha256=N0oFOLiGxpbgSgxznjvu64lG3YyOcZPKC8JFyKx6X7w,6023
 pulse/requirements.py,sha256=nMnE25Uu-TUuQd88jW7m2xwus6fD-HvXxQ9UNb7OOGc,1254
@@ -122,7 +122,7 @@ pulse/types/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 pulse/types/event_handler.py,sha256=psQCydj-WEtBcFU5JU4mDwvyzkW8V2O0g_VFRU2EOHI,1618
 pulse/user_session.py,sha256=nsnsMgqq2xGJZLpbHRMHUHcLrElMP8WcA4gjGMrcoBk,10208
 pulse/version.py,sha256=711vaM1jVIQPgkisGgKZqwmw019qZIsc_QTae75K2pg,1895
-pulse_framework-0.1.65.dist-info/WHEEL,sha256=eh7sammvW2TypMMMGKgsM83HyA_3qQ5Lgg3ynoecH3M,79
-pulse_framework-0.1.65.dist-info/entry_points.txt,sha256=i7aohd3QaPu5IcuGKKvsQQEiMYMe5HcF56QEsaLVO64,46
-pulse_framework-0.1.65.dist-info/METADATA,sha256=sVBQbxUQWt5E7xaAiRpuPi-3kzMeDyO4Z7u8uQrZdGk,8300
-pulse_framework-0.1.65.dist-info/RECORD,,
+pulse_framework-0.1.66a1.dist-info/WHEEL,sha256=eh7sammvW2TypMMMGKgsM83HyA_3qQ5Lgg3ynoecH3M,79
+pulse_framework-0.1.66a1.dist-info/entry_points.txt,sha256=i7aohd3QaPu5IcuGKKvsQQEiMYMe5HcF56QEsaLVO64,46
+pulse_framework-0.1.66a1.dist-info/METADATA,sha256=5eOY1sXHWh-_WZB1EUlHxRKoqU3jIAJH0_iqQ2niZhI,8302
+pulse_framework-0.1.66a1.dist-info/RECORD,,