refactor(app): drop redundant server keying from session route boundary

This commit is contained in:
LukeParkerDev 2026-07-02 14:57:44 +10:00
commit a09f6a87c3
3 changed files with 27 additions and 45 deletions

View file

@ -89,7 +89,7 @@ import { formatServerError, isSessionNotFoundError } from "@/utils/server-errors
import { legacySessionHref, requireServerKey, sessionHref } from "@/utils/session-route"
import { useUsageExceededDialogs } from "./session/usage-exceeded-dialogs"
import { createSessionOwnership } from "./session/session-ownership"
import { SessionRouteBoundary } from "./session/route-boundary"
import { SessionRouteErrorBoundary } from "./session/route-boundary"
type FollowupItem = FollowupDraft & { id: string }
type FollowupEdit = Pick<FollowupItem, "id" | "prompt" | "context">
@ -147,8 +147,7 @@ export function SessionPage() {
export function TargetSessionRoute() {
const params = useParams<{ serverKey: string; id: string }>()
return (
<SessionRouteBoundary
serverKey={params.serverKey}
<SessionRouteErrorBoundary
sessionID={params.id}
fallback={(error) => (
<SessionRouteFallback
@ -160,7 +159,7 @@ export function TargetSessionRoute() {
)}
>
<ResolvedTargetSessionRoute />
</SessionRouteBoundary>
</SessionRouteErrorBoundary>
)
}

View file

@ -1,37 +1,27 @@
import { ErrorBoundary, Show, createComponent, createEffect, on } from "solid-js"
import { ErrorBoundary, createComponent, createEffect, on } from "solid-js"
import type { JSX } from "solid-js"
// Structural boundary for the target session route: decides when the route
// subtree remounts and how route-level errors are scoped. Kept free of app
// contexts (and JSX) so the remount semantics can be tested directly.
//
// Keyed by server only. Workspace-scoped state (notably TerminalProvider and
// its PTY WebSockets) lives inside the route subtree, so switching session
// tabs within the same workspace must not remount it; session changes are
// handled reactively below (TargetSessionPage re-keys per workspace).
export function SessionRouteBoundary(props: {
serverKey: string | undefined
// Error scope for the target session route. All session tabs on a server share
// one route instance, so this must NOT key or remount per session: the subtree
// holds workspace-scoped state (notably TerminalProvider and its PTY
// WebSockets) that has to survive switching tabs within the same workspace.
// Remount boundaries live elsewhere: app.tsx keys the route per server around
// the server-scoped providers, and TargetSessionPage re-keys per workspace.
// Kept free of app contexts (and JSX) so these semantics are directly testable.
export function SessionRouteErrorBoundary(props: {
sessionID: string | undefined
fallback: (error: unknown) => JSX.Element
children: JSX.Element
}) {
return createComponent(Show, {
get when() {
return props.serverKey
return createComponent(ErrorBoundary, {
fallback: (error: unknown, reset: () => void) => {
// A stale error (e.g. session not found) must clear when navigating to a
// different session tab; mirrors the panel boundary reset inside Page.
createEffect(on(() => props.sessionID, reset, { defer: true }))
return props.fallback(error)
},
keyed: true,
get children() {
return createComponent(ErrorBoundary, {
fallback: (error: unknown, reset: () => void) => {
// Without a per-session remount, a stale error (e.g. session not
// found) must clear when navigating to a different session.
createEffect(on(() => props.sessionID, reset, { defer: true }))
return props.fallback(error)
},
get children() {
return props.children
},
})
return props.children
},
})
}

View file

@ -1,12 +1,13 @@
import { expect, test } from "bun:test"
import { createComponent, createSignal, onCleanup } from "solid-js"
import { render } from "solid-js/web"
import { SessionRouteBoundary } from "@/pages/session/route-boundary"
import { SessionRouteErrorBoundary } from "@/pages/session/route-boundary"
// Terminals (and other workspace-scoped state) live inside the route subtree,
// so switching session tabs within the same server must not remount it.
test("switching sessions on the same server does not remount the route subtree", () => {
const [server, setServer] = createSignal("srv_1")
// All session tabs on a server share one route instance, and the subtree holds
// workspace-scoped state (notably the terminal and its PTY WebSockets), so
// switching session tabs must not remount it. Remounting is owned elsewhere:
// per server in app.tsx and per workspace in TargetSessionPage.
test("switching sessions does not remount the route subtree", () => {
const [session, setSession] = createSignal("ses_a")
let mounts = 0
let disposals = 0
@ -20,10 +21,7 @@ test("switching sessions on the same server does not remount the route subtree",
const dispose = render(
() =>
createComponent(SessionRouteBoundary, {
get serverKey() {
return server()
},
createComponent(SessionRouteErrorBoundary, {
get sessionID() {
return session()
},
@ -42,10 +40,6 @@ test("switching sessions on the same server does not remount the route subtree",
expect(mounts).toBe(initialMounts)
expect(disposals).toBe(0)
setServer("srv_2")
expect(mounts).toBeGreaterThan(initialMounts)
expect(disposals).toBeGreaterThan(0)
dispose()
})
@ -62,8 +56,7 @@ test("route error clears when navigating to a different session", () => {
const container = document.createElement("div")
const dispose = render(
() =>
createComponent(SessionRouteBoundary, {
serverKey: "srv_1",
createComponent(SessionRouteErrorBoundary, {
get sessionID() {
return session()
},