pulse-framework 0.1.71__tar.gz → 0.1.72__tar.gz

{pulse_framework-0.1.71 → pulse_framework-0.1.72}/PKG-INFO

@@ -1,20 +1,20 @@
 Metadata-Version: 2.3
 Name: pulse-framework
-Version: 0.1.71
+Version: 0.1.72
 Summary: Pulse - Full-stack framework for building real-time React applications in Python
-Requires-Dist: websockets>=12.0
 Requires-Dist: fastapi>=0.128.0
 Requires-Dist: uvicorn>=0.24.0
 Requires-Dist: mako>=1.3.10
 Requires-Dist: typer>=0.16.0
 Requires-Dist: python-socketio>=5.16.0
 Requires-Dist: rich>=13.7.1
-Requires-Dist: python-multipart>=0.0.20
+Requires-Dist: python-multipart>=0.0.22
 Requires-Dist: python-dateutil>=2.9.0.post0
 Requires-Dist: starlette>=0.50.0,<0.51.0
 Requires-Dist: urllib3>=2.6.3
 Requires-Dist: watchfiles>=1.1.0
 Requires-Dist: httpx>=0.28.1
+Requires-Dist: aiohttp>=3.12.0
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown
 

{pulse_framework-0.1.71 → pulse_framework-0.1.72}/pyproject.toml

@@ -1,23 +1,23 @@
 [project]
 name = "pulse-framework"
-version = "0.1.71"
+version = "0.1.72"
 description = "Pulse - Full-stack framework for building real-time React applications in Python"
 readme = "README.md"
 requires-python = ">=3.11"
 dependencies = [
-    "websockets>=12.0",
     "fastapi>=0.128.0",
     "uvicorn>=0.24.0",
     "mako>=1.3.10",
     "typer>=0.16.0",
     "python-socketio>=5.16.0",
     "rich>=13.7.1",
-    "python-multipart>=0.0.20",
+    "python-multipart>=0.0.22",
     "python-dateutil>=2.9.0.post0",
     "starlette>=0.50.0,<0.51.0",
     "urllib3>=2.6.3",
     "watchfiles>=1.1.0",
     "httpx>=0.28.1",
+    "aiohttp>=3.12.0",
 ]
 
 [tool.uv]

{pulse_framework-0.1.71 → pulse_framework-0.1.72}/src/pulse/__init__.py

@@ -1322,6 +1322,9 @@ from pulse.middleware import (
 
 # Plugin
 from pulse.plugin import Plugin as Plugin
+
+# Proxy
+from pulse.proxy import ProxyConfig as ProxyConfig
 from pulse.queries.client import QueryClient as QueryClient
 from pulse.queries.client import QueryFilter as QueryFilter
 from pulse.queries.client import queries as queries

{pulse_framework-0.1.71 → pulse_framework-0.1.72}/src/pulse/app.py

@@ -67,7 +67,7 @@ from pulse.middleware import (
 	Redirect,
 )
 from pulse.plugin import Plugin
-from pulse.proxy import ReactProxy
+from pulse.proxy import ProxyConfig, ReactProxy
 from pulse.render_session import RenderSession
 from pulse.request import PulseRequest
 from pulse.routing import Layout, Route, RouteTree, ensure_absolute_path
@@ -211,6 +211,7 @@ class App:
 	_tasks: TaskRegistry
 	_timers: TimerRegistry
 	_proxy: ReactProxy | None
+	proxy_config: ProxyConfig | None
 	session_timeout: float
 	connection_status: ConnectionStatusConfig
 	render_loop_limit: int
@@ -232,6 +233,7 @@ class App:
 		not_found: str = "/not-found",
 		# Deployment and integration options
 		mode: PulseMode = "single-server",
+		proxy: ProxyConfig | None = None,
 		api_prefix: str = "/_pulse",
 		cors: CORSOptions | None = None,
 		fastapi: dict[str, Any] | None = None,
@@ -245,6 +247,7 @@ class App:
 		# Resolve mode from environment and expose on the app instance
 		self.env = envvars.pulse_env
 		self.mode = mode
+		self.proxy_config = proxy
 		self.status = AppStatus.created
 		# Persist the server address for use by sessions (API calls, etc.) in ci/prod.
 		self.server_address = server_address if self.env in ("ci", "prod") else None
@@ -506,15 +509,22 @@ class App:
 			)
 			render_id = request.headers.get("x-pulse-render-id")
 			render = self._get_render_for_session(render_id, session)
-			with PulseContext.update(session=session, render=render):
-				res: Response = await call_next(request)
-			session.handle_response(res)
-
-			self._sessions_in_request[session.sid] -= 1
-			if self._sessions_in_request[session.sid] == 0:
-				del self._sessions_in_request[session.sid]
-
-			return res
+			try:
+				with PulseContext.update(session=session, render=render):
+					res: Response = await call_next(request)
+				session.handle_response(res)
+				return res
+			except RuntimeError as exc:
+				# Client disconnected before response was sent. This happens when
+				# ASGI handlers (like the proxy) return early on disconnect without
+				# sending a response, which is valid ASGI but breaks BaseHTTPMiddleware.
+				if "No response returned" in str(exc):
+					return Response(status_code=499)
+				raise
+			finally:
+				self._sessions_in_request[session.sid] -= 1
+				if self._sessions_in_request[session.sid] == 0:
+					del self._sessions_in_request[session.sid]
 
 		# Apply prefix to all routes
 		prefix = self.api_prefix
@@ -654,10 +664,8 @@ class App:
 		for plugin in self.plugins:
 			plugin.on_setup(self)
 
-		# In single-server mode, add catch-all route to proxy unmatched requests to React server
-		# This route must be registered last so FastAPI tries all specific routes first
-		# FastAPI will match specific routes before this catch-all, but we add an explicit check
-		# as a safety measure to ensure API routes are never proxied
+		# In single-server mode, add catch-all route to proxy unmatched requests to React server.
+		# This route must be registered last so FastAPI tries all specific routes first.
 		if self.mode == "single-server":
 			react_server_address = envvars.react_server_address
 			if not react_server_address:
@@ -666,11 +674,12 @@ class App:
 					+ "Use 'pulse run' CLI command or set the environment variable."
 				)
 
-			self._proxy = ReactProxy(
+			proxy_handler = ReactProxy(
 				react_server_address=react_server_address,
 				server_address=server_address,
+				config=self.proxy_config,
 			)
-			proxy_handler = self._proxy
+			self._proxy = proxy_handler
 
 			# In dev mode, proxy WebSocket connections to React Router (e.g. Vite HMR)
 			# Socket.IO handles /socket.io/ at ASGI level before reaching FastAPI
@@ -680,14 +689,8 @@ class App:
 				async def websocket_proxy(websocket: WebSocket, path: str):  # pyright: ignore[reportUnusedFunction]
 					await proxy_handler.proxy_websocket(websocket)
 
-			@self.fastapi.api_route(
-				"/{path:path}",
-				methods=["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS"],
-				include_in_schema=False,
-			)
-			async def proxy_catch_all(request: Request, path: str):  # pyright: ignore[reportUnusedFunction]
-				# Proxy all unmatched HTTP requests to React Router
-				return await proxy_handler(request)
+			# Register ASGI-level catch-all last.
+			self.fastapi.mount("/", proxy_handler, name="react-proxy")
 
 		@self.sio.event
 		async def connect(  # pyright: ignore[reportUnusedFunction]

{pulse_framework-0.1.71 → pulse_framework-0.1.72}/src/pulse/cli/cmd.py

@@ -233,7 +233,7 @@ def run(
 		)
 		commands.append(server_cmd)
 
-	with FolderLock(web_root):
+	with FolderLock(web_root, address=address, port=port):
 		try:
 			exit_code = execute_commands(
 				commands,

{pulse_framework-0.1.71 → pulse_framework-0.1.72}/src/pulse/cli/folder_lock.py

@@ -52,7 +52,7 @@ def _write_gitignore_for_lock(lock_path: Path) -> None:
 	ensure_gitignore_has(lock_path.parent, lock_path.name)
 
 
-def _create_lock_file(lock_path: Path) -> None:
+def _create_lock_file(lock_path: Path, *, address: str, port: int) -> None:
 	"""Create a lock file with current process information."""
 	lock_path = Path(lock_path)
 	_write_gitignore_for_lock(lock_path)
@@ -61,18 +61,26 @@ def _create_lock_file(lock_path: Path) -> None:
 		info = _read_lock(lock_path) or {}
 		pid = int(info.get("pid", 0) or 0)
 		if pid and is_process_alive(pid):
+			existing_addr = info.get("address", address)
+			existing_port = info.get("port", port)
+			protocol = (
+				"http" if existing_addr in ("127.0.0.1", "localhost") else "https"
+			)
+			url = f"{protocol}://{existing_addr}:{existing_port}"
 			raise RuntimeError(
-				f"Another Pulse dev instance appears to be running (pid={pid}) for {lock_path.parent}."
+				f"Another Pulse dev instance is running at {url} (pid={pid})"
 			)
 		# Stale lock; continue to overwrite
 
-	payload = {
+	payload: dict[str, Any] = {
 		"pid": os.getpid(),
 		"created_at": int(time.time()),
 		"hostname": socket.gethostname(),
 		"platform": platform.platform(),
 		"python": platform.python_version(),
 		"cwd": os.getcwd(),
+		"address": address,
+		"port": port,
 	}
 	try:
 		lock_path.parent.mkdir(parents=True, exist_ok=True)
@@ -105,23 +113,34 @@ class FolderLock:
 	and know not to delete the lock on exit.
 
 	Example:
-	    with FolderLock(web_root):
+	    with FolderLock(web_root, address="localhost", port=8000):
 	        # Protected region
 	        pass
 	"""
 
-	def __init__(self, web_root: Path, *, filename: str = ".pulse/lock"):
+	def __init__(
+		self,
+		web_root: Path,
+		*,
+		address: str,
+		port: int,
+		filename: str = ".pulse/lock",
+	):
 		"""
 		Initialize FolderLock.
 
 		Args:
 		    web_root: Path to the web root directory
+		    address: Server address to store in lock file
+		    port: Server port to store in lock file
 		    filename: Name of the lock file (default: ".pulse/lock")
 		"""
 		self.lock_path: Path = lock_path_for_web_root(web_root, filename)
+		self.address: str = address
+		self.port: int = port
 
 	def __enter__(self):
-		_create_lock_file(self.lock_path)
+		_create_lock_file(self.lock_path, address=self.address, port=self.port)
 		return self
 
 	def __exit__(

{pulse_framework-0.1.71 → pulse_framework-0.1.72}/src/pulse/codegen/templates/layout.py

@@ -32,7 +32,9 @@ export async function loader(args: LoaderFunctionArgs) {
   if (cookie) fwd.set("cookie", cookie);
   if (authorization) fwd.set("authorization", authorization);
   fwd.set("content-type", "application/json");
-  const res = await fetch(`${internal_server_address}$${"{"}config.apiPrefix}/prerender`, {
+  // Internal server address for server-side loader requests.
+  const internalServerAddress = "${internal_server_address}";
+  const res = await fetch(`$${"{"}internalServerAddress}$${"{"}config.apiPrefix}/prerender`, {
     method: "POST",
     headers: fwd,
     body: JSON.stringify({ paths, routeInfo: extractServerRouteInfo(args) }),

{pulse_framework-0.1.71 → pulse_framework-0.1.72}/src/pulse/hooks/effects.py

@@ -2,7 +2,7 @@ from collections.abc import Callable
 from typing import Any, override
 
 from pulse.hooks.core import HookMetadata, HookState, hooks
-from pulse.reactive import AsyncEffect, Effect
+from pulse.reactive import REACTIVE_CONTEXT, AsyncEffect, Effect
 
 
 class InlineEffectHookState(HookState):
@@ -33,6 +33,20 @@ class InlineEffectHookState(HookState):
 			if key not in self._seen_this_render:
 				self.effects[key].dispose()
 				del self.effects[key]
+		# Remove inline effects from the active render scope to avoid parent cleanup.
+		rc = REACTIVE_CONTEXT.get()
+		scope = rc.scope
+		if scope is None or not scope.effects:
+			return
+		for key in self._seen_this_render:
+			effect = self.effects.get(key)
+			if effect is None:
+				continue
+			try:
+				scope.effects.remove(effect)
+				effect.parent = None
+			except ValueError:
+				pass
 
 	def get_or_create(
 		self,