pulse-framework 0.1.65__tar.gz → 0.1.66a1__tar.gz

{pulse_framework-0.1.65 → pulse_framework-0.1.66a1}/PKG-INFO

@@ -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 → pulse_framework-0.1.66a1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "pulse-framework"
-version = "0.1.65"
+version = "0.1.66a1"
 description = "Pulse - Full-stack framework for building real-time React applications in Python"
 readme = "README.md"
 requires-python = ">=3.11"

{pulse_framework-0.1.65 → pulse_framework-0.1.66a1}/src/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_framework-0.1.65 → pulse_framework-0.1.66a1}/src/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_framework-0.1.65 → pulse_framework-0.1.66a1}/src/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()