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

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

@@ -1,20 +1,20 @@
 Metadata-Version: 2.3
 Name: pulse-framework
-Version: 0.1.70
+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.70 → pulse_framework-0.1.72}/pyproject.toml

@@ -1,23 +1,23 @@
 [project]
 name = "pulse-framework"
-version = "0.1.70"
+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.70 → pulse_framework-0.1.72}/src/pulse/__init__.py

@@ -1322,14 +1322,21 @@ 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
 from pulse.queries.common import ActionError as ActionError
 from pulse.queries.common import ActionResult as ActionResult
 from pulse.queries.common import ActionSuccess as ActionSuccess
+from pulse.queries.common import Key as Key
 from pulse.queries.common import QueryKey as QueryKey
+from pulse.queries.common import QueryKeys as QueryKeys
 from pulse.queries.common import QueryStatus as QueryStatus
+from pulse.queries.common import keys as keys
+from pulse.queries.common import normalize_key as normalize_key
 from pulse.queries.infinite_query import infinite_query as infinite_query
 from pulse.queries.mutation import mutation as mutation
 from pulse.queries.protocol import QueryResult as QueryResult

{pulse_framework-0.1.70 → 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.70 → 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.70 → 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.70 → 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.70 → 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,