tempest-react-sdk 0.80.0 → 0.82.0

package/dist/ws/use-web-socket.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"use-web-socket.cjs","names":["useState","useRef","useLatestRef","createWebSocket","useCallback","require_use_latest_ref","require_create_web_socket","react","useWebSocket","options","status","setStatus","lastMessage","setLastMessage","controllerRef","optionsRef","protocolsKey","protocols","enabled","url","hasParser","hasParseError","hasValidationError","controller","raw","error","issues","event","attempt","total","reason","message","maxRetries","initialBackoff","maxBackoff","jitter","handshakeTimeout","silenceTimeout","waitForOnline","pingInterval","respondToPing","queueWhileClosed","maxQueuedMessages","payload","ms"],"sources":["../../src/ws/use-web-socket.ts"],"sourcesContent":["import { useCallback, useEffect, useRef, useState } from \"react\";\nimport { useLatestRef } from \"@/hooks/use-latest-ref\";\nimport {\n    createWebSocket,\n    type CreateWebSocketOptions,\n    type WebSocketController,\n    type WebSocketMessage,\n    type WebSocketStatus,\n} from \"./create-web-socket\";\n\nexport interface UseWebSocketOptions<T> extends Omit<CreateWebSocketOptions<T>, \"onStatusChange\"> {\n    /** When false, the socket is not opened. Default: true. */\n    enabled?: boolean;\n}\n\nexport interface UseWebSocketResult<T> {\n    status: WebSocketStatus;\n    /**\n     * Last decoded frame received.\n     *\n     * A snapshot, not a stream: two frames arriving in the same tick collapse\n     * into a single render and only the later one is ever visible. One server\n     * action often emits several frames in a row, so anything that must see\n     * every message has to use `onMessage`, which fires once per frame. Read\n     * `lastMessage` for \"what is the current state\" rendering only.\n     */\n    lastMessage: WebSocketMessage<T> | null;\n    /** Send a payload through the active connection. Returns false when not open. */\n    send: (payload: string | Blob | BufferSource) => boolean;\n    /** Force a reconnect, resetting the retry counter. */\n    reconnect: () => void;\n    /**\n     * Change the silence watchdog at runtime, in ms. `0` disables it.\n     *\n     * For a server that announces its own heartbeat interval in the first frame,\n     * so the tolerated silence is not hard-coded on both ends.\n     */\n    setSilenceTimeout: (ms: number) => void;\n}\n\n/**\n * React hook around {@link createWebSocket}. Manages the connection lifecycle\n * for the host component and tears it down on unmount.\n *\n * Every callback is read through a ref, so `onOpen` / `onMessage` / `onClose` /\n * `onError` / `onReconnecting` / `onReconnected` / `onLost` always run the\n * latest closure — an inline arrow function is fine and never reopens the\n * socket. Connection-shaping options (`protocols`, `maxRetries`,\n * `initialBackoff`, `maxBackoff`, `jitter`, `handshakeTimeout`,\n * `silenceTimeout`, `waitForOnline`, `pingInterval`, `queueWhileClosed`) are\n * baked into the connection, so changing one reopens it with the new value\n * rather than being silently ignored.\n *\n * `schema` is read when the socket opens, so declare it outside the component\n * (or memoize it): a schema built inline is a new object on every render, and\n * the one in force is whichever existed at the last open.\n *\n * @param url - Full ws:// or wss:// URL.\n * @param options - Connection configuration and callbacks.\n * @returns Status, last frame, and the `send` / `reconnect` controls.\n */\nexport function useWebSocket<T = unknown>(\n    url: string,\n    options: UseWebSocketOptions<T> = {},\n): UseWebSocketResult<T> {\n    const {\n        enabled = true,\n        protocols,\n        maxRetries,\n        initialBackoff,\n        maxBackoff,\n        jitter,\n        handshakeTimeout,\n        silenceTimeout,\n        waitForOnline,\n        pingInterval,\n        respondToPing,\n        queueWhileClosed,\n        maxQueuedMessages,\n    } = options;\n    const [status, setStatus] = useState<WebSocketStatus>(\"idle\");\n    const [lastMessage, setLastMessage] = useState<WebSocketMessage<T> | null>(null);\n    const controllerRef = useRef<WebSocketController | null>(null);\n\n    const optionsRef = useLatestRef(options);\n\n    const protocolsKey = Array.isArray(protocols) ? protocols.join(\",\") : (protocols ?? \"\");\n\n    useEffect(() => {\n        if (!enabled || !url) {\n            setStatus(\"idle\");\n            return;\n        }\n\n        /*\n         * Presence is read once, when the socket opens, and decides whether the\n         * forwarder is passed at all. A forwarder is always truthy, so wrapping\n         * an absent `parser` — or an absent `onParseError` — would tell\n         * `decodeFrame` the caller had supplied one and silently pick the wrong\n         * branch.\n         */\n        const hasParser = optionsRef.current.parser !== undefined;\n        const hasParseError = optionsRef.current.onParseError !== undefined;\n        const hasValidationError = optionsRef.current.onValidationError !== undefined;\n\n        const controller = createWebSocket<T>(url, {\n            protocols: optionsRef.current.protocols,\n            maxRetries,\n            initialBackoff,\n            maxBackoff,\n            jitter,\n            handshakeTimeout,\n            silenceTimeout,\n            waitForOnline,\n            pingInterval,\n            pingPayload: optionsRef.current.pingPayload,\n            respondToPing,\n            pongPayload: optionsRef.current.pongPayload,\n            queueWhileClosed,\n            maxQueuedMessages,\n            parser: hasParser ? (raw) => optionsRef.current.parser?.(raw) as T : undefined,\n            onParseError: hasParseError\n                ? (error, raw) => optionsRef.current.onParseError?.(error, raw)\n                : undefined,\n            schema: optionsRef.current.schema,\n            onValidationError: hasValidationError\n                ? (issues, raw) => optionsRef.current.onValidationError?.(issues, raw)\n                : undefined,\n            onStatusChange: setStatus,\n            onOpen: (event) => optionsRef.current.onOpen?.(event),\n            onClose: (event) => optionsRef.current.onClose?.(event),\n            onError: (event) => optionsRef.current.onError?.(event),\n            onReconnecting: (attempt, total) => optionsRef.current.onReconnecting?.(attempt, total),\n            onReconnected: () => optionsRef.current.onReconnected?.(),\n            onLost: (reason) => optionsRef.current.onLost?.(reason),\n            onMessage: (message) => {\n                setLastMessage(message);\n                optionsRef.current.onMessage?.(message);\n            },\n        });\n        controllerRef.current = controller;\n\n        return () => {\n            controller.close();\n            controllerRef.current = null;\n        };\n    }, [\n        url,\n        enabled,\n        protocolsKey,\n        maxRetries,\n        initialBackoff,\n        maxBackoff,\n        jitter,\n        handshakeTimeout,\n        silenceTimeout,\n        waitForOnline,\n        pingInterval,\n        respondToPing,\n        queueWhileClosed,\n        maxQueuedMessages,\n        optionsRef,\n    ]);\n\n    const send = useCallback((payload: string | Blob | BufferSource): boolean => {\n        return controllerRef.current?.send(payload) ?? false;\n    }, []);\n\n    const reconnect = useCallback((): void => {\n        controllerRef.current?.reconnect();\n    }, []);\n\n    const setSilenceTimeout = useCallback((ms: number): void => {\n        controllerRef.current?.setSilenceTimeout(ms);\n    }, []);\n\n    return { status, lastMessage, send, reconnect, setSilenceTimeout };\n}\n"],"mappings":"A,2GA6DA,SAAgBQ,EACZ,EACA,EAAkC,CAAC,EACd,CACrB,GAAM,CACF,UAAU,GACV,YACA,aACA,iBACA,aACA,SACA,mBACA,iBACA,gBACA,eACA,gBACA,mBACA,qBACAC,EACE,CAACC,EAAQC,IAAA,EAAaX,EAAAA,SAAAA,CAA0B,MAAM,EACtD,CAACY,EAAaC,IAAA,EAAkBb,EAAAA,SAAAA,CAAqC,IAAI,EACzEc,GAAA,EAAgBb,EAAAA,OAAAA,CAAmC,IAAI,EAEvDc,EAAab,EAAAA,aAAaO,CAAO,EAEjCO,EAAe,MAAM,QAAQC,CAAS,EAAIA,EAAU,KAAK,GAAG,EAAKA,GAAa,GA0FpF,OAxFA,EAAAV,EAAA,UAAA,KAAgB,CACZ,GAAI,CAACW,GAAW,CAACC,EAAK,CAClBR,EAAU,MAAM,EAChB,MACJ,CASA,IAAMS,EAAYL,EAAW,QAAQ,SAAW,IAAA,GAC1CM,EAAgBN,EAAW,QAAQ,eAAiB,IAAA,GACpDO,EAAqBP,EAAW,QAAQ,oBAAsB,IAAA,GAE9DQ,EAAapB,EAAAA,gBAAmBgB,EAAK,CACvC,UAAWJ,EAAW,QAAQ,UAC9B,aACA,iBACA,aACA,SACA,mBACA,iBACA,gBACA,eACA,YAAaA,EAAW,QAAQ,YAChC,gBACA,YAAaA,EAAW,QAAQ,YAChC,mBACA,oBACA,OAAQK,EAAa,GAAQL,EAAW,QAAQ,SAASS,CAAG,EAAS,IAAA,GACrE,aAAcH,GACP,EAAO,IAAQN,EAAW,QAAQ,eAAeU,EAAOD,CAAG,EAC5D,IAAA,GACN,OAAQT,EAAW,QAAQ,OAC3B,kBAAmBO,GACZ,EAAQ,IAAQP,EAAW,QAAQ,oBAAoBW,EAAQF,CAAG,EACnE,IAAA,GACN,eAAgBb,EAChB,OAAS,GAAUI,EAAW,QAAQ,SAASY,CAAK,EACpD,QAAU,GAAUZ,EAAW,QAAQ,UAAUY,CAAK,EACtD,QAAU,GAAUZ,EAAW,QAAQ,UAAUY,CAAK,EACtD,gBAAiB,EAAS,IAAUZ,EAAW,QAAQ,iBAAiBa,EAASC,CAAK,EACtF,kBAAqBd,EAAW,QAAQ,gBAAgB,EACxD,OAAS,GAAWA,EAAW,QAAQ,SAASe,CAAM,EACtD,UAAY,GAAY,CACpBjB,EAAekB,CAAO,EACtBhB,EAAW,QAAQ,YAAYgB,CAAO,CAC1C,CACJ,CAAC,EAGD,MAFA,GAAc,QAAUR,MAEX,CACTA,EAAW,MAAM,EACjB,EAAc,QAAU,IAC5B,CACJ,EAAG,CACCJ,EACAD,EACAF,EACAgB,EACAC,EACAC,EACAC,EACAC,EACAC,EACAC,EACAC,EACAC,EACAC,EACAC,EACA3B,CACJ,CAAC,EAcM,CAAE,SAAQ,cAAa,MAAA,EAZjBX,EAAAA,YAAAA,CAAa,GACfU,EAAc,SAAS,KAAK6B,CAAO,GAAK,GAChD,CAAC,CAU0B,EAAM,WAAA,EARlBvC,EAAAA,YAAAA,KAAwB,CACtCU,EAAc,SAAS,UAAU,CACrC,EAAG,CAAC,CAMgC,EAAW,mBAAA,EAJrBV,EAAAA,YAAAA,CAAa,GAAqB,CACxDU,EAAc,SAAS,kBAAkB8B,CAAE,CAC/C,EAAG,CAAC,CAE2C,CAAkB,CACrE,C"}
+{"version":3,"file":"use-web-socket.cjs","names":["useState","useRef","useLatestRef","createWebSocket","useCallback","require_use_latest_ref","require_create_web_socket","react","useWebSocket","options","status","setStatus","lastMessage","setLastMessage","controllerRef","optionsRef","protocolsKey","protocols","enabled","url","hasParser","hasParseError","hasValidationError","hasPrincipal","controller","raw","error","issues","event","attempt","total","reason","message","maxRetries","initialBackoff","maxBackoff","jitter","handshakeTimeout","silenceTimeout","waitForOnline","pingInterval","respondToPing","queueWhileClosed","maxQueuedMessages","payload","ms"],"sources":["../../src/ws/use-web-socket.ts"],"sourcesContent":["import { useCallback, useEffect, useRef, useState } from \"react\";\nimport { useLatestRef } from \"@/hooks/use-latest-ref\";\nimport {\n    createWebSocket,\n    type CreateWebSocketOptions,\n    type WebSocketController,\n    type WebSocketMessage,\n    type WebSocketStatus,\n} from \"./create-web-socket\";\n\nexport interface UseWebSocketOptions<T> extends Omit<CreateWebSocketOptions<T>, \"onStatusChange\"> {\n    /** When false, the socket is not opened. Default: true. */\n    enabled?: boolean;\n}\n\nexport interface UseWebSocketResult<T> {\n    status: WebSocketStatus;\n    /**\n     * Last decoded frame received.\n     *\n     * A snapshot, not a stream: two frames arriving in the same tick collapse\n     * into a single render and only the later one is ever visible. One server\n     * action often emits several frames in a row, so anything that must see\n     * every message has to use `onMessage`, which fires once per frame. Read\n     * `lastMessage` for \"what is the current state\" rendering only.\n     */\n    lastMessage: WebSocketMessage<T> | null;\n    /** Send a payload through the active connection. Returns false when not open. */\n    send: (payload: string | Blob | BufferSource) => boolean;\n    /** Force a reconnect, resetting the retry counter. */\n    reconnect: () => void;\n    /**\n     * Change the silence watchdog at runtime, in ms. `0` disables it.\n     *\n     * For a server that announces its own heartbeat interval in the first frame,\n     * so the tolerated silence is not hard-coded on both ends.\n     */\n    setSilenceTimeout: (ms: number) => void;\n}\n\n/**\n * React hook around {@link createWebSocket}. Manages the connection lifecycle\n * for the host component and tears it down on unmount.\n *\n * Every callback is read through a ref, so `onOpen` / `onMessage` / `onClose` /\n * `onError` / `onReconnecting` / `onReconnected` / `onLost` / `getPrincipal` always run the\n * latest closure — an inline arrow function is fine and never reopens the\n * socket. Connection-shaping options (`protocols`, `maxRetries`,\n * `initialBackoff`, `maxBackoff`, `jitter`, `handshakeTimeout`,\n * `silenceTimeout`, `waitForOnline`, `pingInterval`, `queueWhileClosed`) are\n * baked into the connection, so changing one reopens it with the new value\n * rather than being silently ignored.\n *\n * `schema` is read when the socket opens, so declare it outside the component\n * (or memoize it): a schema built inline is a new object on every render, and\n * the one in force is whichever existed at the last open.\n *\n * @param url - Full ws:// or wss:// URL.\n * @param options - Connection configuration and callbacks.\n * @returns Status, last frame, and the `send` / `reconnect` controls.\n */\nexport function useWebSocket<T = unknown>(\n    url: string,\n    options: UseWebSocketOptions<T> = {},\n): UseWebSocketResult<T> {\n    const {\n        enabled = true,\n        protocols,\n        maxRetries,\n        initialBackoff,\n        maxBackoff,\n        jitter,\n        handshakeTimeout,\n        silenceTimeout,\n        waitForOnline,\n        pingInterval,\n        respondToPing,\n        queueWhileClosed,\n        maxQueuedMessages,\n    } = options;\n    const [status, setStatus] = useState<WebSocketStatus>(\"idle\");\n    const [lastMessage, setLastMessage] = useState<WebSocketMessage<T> | null>(null);\n    const controllerRef = useRef<WebSocketController | null>(null);\n\n    const optionsRef = useLatestRef(options);\n\n    const protocolsKey = Array.isArray(protocols) ? protocols.join(\",\") : (protocols ?? \"\");\n\n    useEffect(() => {\n        if (!enabled || !url) {\n            setStatus(\"idle\");\n            return;\n        }\n\n        /*\n         * Presence is read once, when the socket opens, and decides whether the\n         * forwarder is passed at all. A forwarder is always truthy, so wrapping\n         * an absent `parser` — or an absent `onParseError` — would tell\n         * `decodeFrame` the caller had supplied one and silently pick the wrong\n         * branch.\n         */\n        const hasParser = optionsRef.current.parser !== undefined;\n        const hasParseError = optionsRef.current.onParseError !== undefined;\n        const hasValidationError = optionsRef.current.onValidationError !== undefined;\n        const hasPrincipal = optionsRef.current.getPrincipal !== undefined;\n\n        const controller = createWebSocket<T>(url, {\n            protocols: optionsRef.current.protocols,\n            maxRetries,\n            initialBackoff,\n            maxBackoff,\n            jitter,\n            handshakeTimeout,\n            silenceTimeout,\n            waitForOnline,\n            pingInterval,\n            pingPayload: optionsRef.current.pingPayload,\n            respondToPing,\n            pongPayload: optionsRef.current.pongPayload,\n            queueWhileClosed,\n            maxQueuedMessages,\n            getPrincipal: hasPrincipal ? () => optionsRef.current.getPrincipal?.() : undefined,\n            parser: hasParser ? (raw) => optionsRef.current.parser?.(raw) as T : undefined,\n            onParseError: hasParseError\n                ? (error, raw) => optionsRef.current.onParseError?.(error, raw)\n                : undefined,\n            schema: optionsRef.current.schema,\n            onValidationError: hasValidationError\n                ? (issues, raw) => optionsRef.current.onValidationError?.(issues, raw)\n                : undefined,\n            onStatusChange: setStatus,\n            onOpen: (event) => optionsRef.current.onOpen?.(event),\n            onClose: (event) => optionsRef.current.onClose?.(event),\n            onError: (event) => optionsRef.current.onError?.(event),\n            onReconnecting: (attempt, total) => optionsRef.current.onReconnecting?.(attempt, total),\n            onReconnected: () => optionsRef.current.onReconnected?.(),\n            onLost: (reason) => optionsRef.current.onLost?.(reason),\n            onMessage: (message) => {\n                setLastMessage(message);\n                optionsRef.current.onMessage?.(message);\n            },\n        });\n        controllerRef.current = controller;\n\n        return () => {\n            controller.close();\n            controllerRef.current = null;\n        };\n    }, [\n        url,\n        enabled,\n        protocolsKey,\n        maxRetries,\n        initialBackoff,\n        maxBackoff,\n        jitter,\n        handshakeTimeout,\n        silenceTimeout,\n        waitForOnline,\n        pingInterval,\n        respondToPing,\n        queueWhileClosed,\n        maxQueuedMessages,\n        optionsRef,\n    ]);\n\n    const send = useCallback((payload: string | Blob | BufferSource): boolean => {\n        return controllerRef.current?.send(payload) ?? false;\n    }, []);\n\n    const reconnect = useCallback((): void => {\n        controllerRef.current?.reconnect();\n    }, []);\n\n    const setSilenceTimeout = useCallback((ms: number): void => {\n        controllerRef.current?.setSilenceTimeout(ms);\n    }, []);\n\n    return { status, lastMessage, send, reconnect, setSilenceTimeout };\n}\n"],"mappings":"A,2GA6DA,SAAgBQ,EACZ,EACA,EAAkC,CAAC,EACd,CACrB,GAAM,CACF,UAAU,GACV,YACA,aACA,iBACA,aACA,SACA,mBACA,iBACA,gBACA,eACA,gBACA,mBACA,qBACAC,EACE,CAACC,EAAQC,IAAA,EAAaX,EAAAA,SAAAA,CAA0B,MAAM,EACtD,CAACY,EAAaC,IAAA,EAAkBb,EAAAA,SAAAA,CAAqC,IAAI,EACzEc,GAAA,EAAgBb,EAAAA,OAAAA,CAAmC,IAAI,EAEvDc,EAAab,EAAAA,aAAaO,CAAO,EAEjCO,EAAe,MAAM,QAAQC,CAAS,EAAIA,EAAU,KAAK,GAAG,EAAKA,GAAa,GA4FpF,OA1FA,EAAAV,EAAA,UAAA,KAAgB,CACZ,GAAI,CAACW,GAAW,CAACC,EAAK,CAClBR,EAAU,MAAM,EAChB,MACJ,CASA,IAAMS,EAAYL,EAAW,QAAQ,SAAW,IAAA,GAC1CM,EAAgBN,EAAW,QAAQ,eAAiB,IAAA,GACpDO,EAAqBP,EAAW,QAAQ,oBAAsB,IAAA,GAC9DQ,EAAeR,EAAW,QAAQ,eAAiB,IAAA,GAEnDS,EAAarB,EAAAA,gBAAmBgB,EAAK,CACvC,UAAWJ,EAAW,QAAQ,UAC9B,aACA,iBACA,aACA,SACA,mBACA,iBACA,gBACA,eACA,YAAaA,EAAW,QAAQ,YAChC,gBACA,YAAaA,EAAW,QAAQ,YAChC,mBACA,oBACA,aAAcQ,MAAqBR,EAAW,QAAQ,eAAe,EAAI,IAAA,GACzE,OAAQK,EAAa,GAAQL,EAAW,QAAQ,SAASU,CAAG,EAAS,IAAA,GACrE,aAAcJ,GACP,EAAO,IAAQN,EAAW,QAAQ,eAAeW,EAAOD,CAAG,EAC5D,IAAA,GACN,OAAQV,EAAW,QAAQ,OAC3B,kBAAmBO,GACZ,EAAQ,IAAQP,EAAW,QAAQ,oBAAoBY,EAAQF,CAAG,EACnE,IAAA,GACN,eAAgBd,EAChB,OAAS,GAAUI,EAAW,QAAQ,SAASa,CAAK,EACpD,QAAU,GAAUb,EAAW,QAAQ,UAAUa,CAAK,EACtD,QAAU,GAAUb,EAAW,QAAQ,UAAUa,CAAK,EACtD,gBAAiB,EAAS,IAAUb,EAAW,QAAQ,iBAAiBc,EAASC,CAAK,EACtF,kBAAqBf,EAAW,QAAQ,gBAAgB,EACxD,OAAS,GAAWA,EAAW,QAAQ,SAASgB,CAAM,EACtD,UAAY,GAAY,CACpBlB,EAAemB,CAAO,EACtBjB,EAAW,QAAQ,YAAYiB,CAAO,CAC1C,CACJ,CAAC,EAGD,MAFA,GAAc,QAAUR,MAEX,CACTA,EAAW,MAAM,EACjB,EAAc,QAAU,IAC5B,CACJ,EAAG,CACCL,EACAD,EACAF,EACAiB,EACAC,EACAC,EACAC,EACAC,EACAC,EACAC,EACAC,EACAC,EACAC,EACAC,EACA5B,CACJ,CAAC,EAcM,CAAE,SAAQ,cAAa,MAAA,EAZjBX,EAAAA,YAAAA,CAAa,GACfU,EAAc,SAAS,KAAK8B,CAAO,GAAK,GAChD,CAAC,CAU0B,EAAM,WAAA,EARlBxC,EAAAA,YAAAA,KAAwB,CACtCU,EAAc,SAAS,UAAU,CACrC,EAAG,CAAC,CAMgC,EAAW,mBAAA,EAJrBV,EAAAA,YAAAA,CAAa,GAAqB,CACxDU,EAAc,SAAS,kBAAkB+B,CAAE,CAC/C,EAAG,CAAC,CAE2C,CAAkB,CACrE,C"}

package/dist/ws/use-web-socket.js

@@ -9,7 +9,7 @@ function o(o, s = {}) {
 			S("idle");
 			return;
 		}
-		let e = E.current.parser !== void 0, n = E.current.onParseError !== void 0, r = E.current.onValidationError !== void 0, i = t(o, {
+		let e = E.current.parser !== void 0, n = E.current.onParseError !== void 0, r = E.current.onValidationError !== void 0, i = E.current.getPrincipal !== void 0, a = t(o, {
 			protocols: E.current.protocols,
 			maxRetries: u,
 			initialBackoff: d,
@@ -24,6 +24,7 @@ function o(o, s = {}) {
 			pongPayload: E.current.pongPayload,
 			queueWhileClosed: y,
 			maxQueuedMessages: b,
+			getPrincipal: i ? () => E.current.getPrincipal?.() : void 0,
 			parser: e ? (e) => E.current.parser?.(e) : void 0,
 			onParseError: n ? (e, t) => E.current.onParseError?.(e, t) : void 0,
 			schema: E.current.schema,
@@ -39,8 +40,8 @@ function o(o, s = {}) {
 				w(e), E.current.onMessage?.(e);
 			}
 		});
-		return T.current = i, () => {
-			i.close(), T.current = null;
+		return T.current = a, () => {
+			a.close(), T.current = null;
 		};
 	}, [
 		o,

package/dist/ws/use-web-socket.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-web-socket.js","names":["useWebSocket","options","status","setStatus","useState","lastMessage","setLastMessage","controllerRef","useRef","optionsRef","useLatestRef","protocolsKey","protocols","useEffect","enabled","url","hasParser","hasParseError","hasValidationError","controller","createWebSocket","raw","error","issues","event","attempt","total","reason","message","maxRetries","initialBackoff","maxBackoff","jitter","handshakeTimeout","silenceTimeout","waitForOnline","pingInterval","respondToPing","queueWhileClosed","maxQueuedMessages","useCallback","payload","ms"],"sources":["../../src/ws/use-web-socket.ts"],"sourcesContent":["import { useCallback, useEffect, useRef, useState } from \"react\";\nimport { useLatestRef } from \"@/hooks/use-latest-ref\";\nimport {\n    createWebSocket,\n    type CreateWebSocketOptions,\n    type WebSocketController,\n    type WebSocketMessage,\n    type WebSocketStatus,\n} from \"./create-web-socket\";\n\nexport interface UseWebSocketOptions<T> extends Omit<CreateWebSocketOptions<T>, \"onStatusChange\"> {\n    /** When false, the socket is not opened. Default: true. */\n    enabled?: boolean;\n}\n\nexport interface UseWebSocketResult<T> {\n    status: WebSocketStatus;\n    /**\n     * Last decoded frame received.\n     *\n     * A snapshot, not a stream: two frames arriving in the same tick collapse\n     * into a single render and only the later one is ever visible. One server\n     * action often emits several frames in a row, so anything that must see\n     * every message has to use `onMessage`, which fires once per frame. Read\n     * `lastMessage` for \"what is the current state\" rendering only.\n     */\n    lastMessage: WebSocketMessage<T> | null;\n    /** Send a payload through the active connection. Returns false when not open. */\n    send: (payload: string | Blob | BufferSource) => boolean;\n    /** Force a reconnect, resetting the retry counter. */\n    reconnect: () => void;\n    /**\n     * Change the silence watchdog at runtime, in ms. `0` disables it.\n     *\n     * For a server that announces its own heartbeat interval in the first frame,\n     * so the tolerated silence is not hard-coded on both ends.\n     */\n    setSilenceTimeout: (ms: number) => void;\n}\n\n/**\n * React hook around {@link createWebSocket}. Manages the connection lifecycle\n * for the host component and tears it down on unmount.\n *\n * Every callback is read through a ref, so `onOpen` / `onMessage` / `onClose` /\n * `onError` / `onReconnecting` / `onReconnected` / `onLost` always run the\n * latest closure — an inline arrow function is fine and never reopens the\n * socket. Connection-shaping options (`protocols`, `maxRetries`,\n * `initialBackoff`, `maxBackoff`, `jitter`, `handshakeTimeout`,\n * `silenceTimeout`, `waitForOnline`, `pingInterval`, `queueWhileClosed`) are\n * baked into the connection, so changing one reopens it with the new value\n * rather than being silently ignored.\n *\n * `schema` is read when the socket opens, so declare it outside the component\n * (or memoize it): a schema built inline is a new object on every render, and\n * the one in force is whichever existed at the last open.\n *\n * @param url - Full ws:// or wss:// URL.\n * @param options - Connection configuration and callbacks.\n * @returns Status, last frame, and the `send` / `reconnect` controls.\n */\nexport function useWebSocket<T = unknown>(\n    url: string,\n    options: UseWebSocketOptions<T> = {},\n): UseWebSocketResult<T> {\n    const {\n        enabled = true,\n        protocols,\n        maxRetries,\n        initialBackoff,\n        maxBackoff,\n        jitter,\n        handshakeTimeout,\n        silenceTimeout,\n        waitForOnline,\n        pingInterval,\n        respondToPing,\n        queueWhileClosed,\n        maxQueuedMessages,\n    } = options;\n    const [status, setStatus] = useState<WebSocketStatus>(\"idle\");\n    const [lastMessage, setLastMessage] = useState<WebSocketMessage<T> | null>(null);\n    const controllerRef = useRef<WebSocketController | null>(null);\n\n    const optionsRef = useLatestRef(options);\n\n    const protocolsKey = Array.isArray(protocols) ? protocols.join(\",\") : (protocols ?? \"\");\n\n    useEffect(() => {\n        if (!enabled || !url) {\n            setStatus(\"idle\");\n            return;\n        }\n\n        /*\n         * Presence is read once, when the socket opens, and decides whether the\n         * forwarder is passed at all. A forwarder is always truthy, so wrapping\n         * an absent `parser` — or an absent `onParseError` — would tell\n         * `decodeFrame` the caller had supplied one and silently pick the wrong\n         * branch.\n         */\n        const hasParser = optionsRef.current.parser !== undefined;\n        const hasParseError = optionsRef.current.onParseError !== undefined;\n        const hasValidationError = optionsRef.current.onValidationError !== undefined;\n\n        const controller = createWebSocket<T>(url, {\n            protocols: optionsRef.current.protocols,\n            maxRetries,\n            initialBackoff,\n            maxBackoff,\n            jitter,\n            handshakeTimeout,\n            silenceTimeout,\n            waitForOnline,\n            pingInterval,\n            pingPayload: optionsRef.current.pingPayload,\n            respondToPing,\n            pongPayload: optionsRef.current.pongPayload,\n            queueWhileClosed,\n            maxQueuedMessages,\n            parser: hasParser ? (raw) => optionsRef.current.parser?.(raw) as T : undefined,\n            onParseError: hasParseError\n                ? (error, raw) => optionsRef.current.onParseError?.(error, raw)\n                : undefined,\n            schema: optionsRef.current.schema,\n            onValidationError: hasValidationError\n                ? (issues, raw) => optionsRef.current.onValidationError?.(issues, raw)\n                : undefined,\n            onStatusChange: setStatus,\n            onOpen: (event) => optionsRef.current.onOpen?.(event),\n            onClose: (event) => optionsRef.current.onClose?.(event),\n            onError: (event) => optionsRef.current.onError?.(event),\n            onReconnecting: (attempt, total) => optionsRef.current.onReconnecting?.(attempt, total),\n            onReconnected: () => optionsRef.current.onReconnected?.(),\n            onLost: (reason) => optionsRef.current.onLost?.(reason),\n            onMessage: (message) => {\n                setLastMessage(message);\n                optionsRef.current.onMessage?.(message);\n            },\n        });\n        controllerRef.current = controller;\n\n        return () => {\n            controller.close();\n            controllerRef.current = null;\n        };\n    }, [\n        url,\n        enabled,\n        protocolsKey,\n        maxRetries,\n        initialBackoff,\n        maxBackoff,\n        jitter,\n        handshakeTimeout,\n        silenceTimeout,\n        waitForOnline,\n        pingInterval,\n        respondToPing,\n        queueWhileClosed,\n        maxQueuedMessages,\n        optionsRef,\n    ]);\n\n    const send = useCallback((payload: string | Blob | BufferSource): boolean => {\n        return controllerRef.current?.send(payload) ?? false;\n    }, []);\n\n    const reconnect = useCallback((): void => {\n        controllerRef.current?.reconnect();\n    }, []);\n\n    const setSilenceTimeout = useCallback((ms: number): void => {\n        controllerRef.current?.setSilenceTimeout(ms);\n    }, []);\n\n    return { status, lastMessage, send, reconnect, setSilenceTimeout };\n}\n"],"mappings":";;;;AA6DA,SAAgBA,EACZ,GACA,IAAkC,CAAC,GACd;CACrB,IAAM,EACF,aAAU,IACV,cACA,eACA,mBACA,eACA,WACA,qBACA,mBACA,kBACA,iBACA,kBACA,qBACA,yBACAC,GACE,CAACC,GAAQC,KAAaC,EAA0B,MAAM,GACtD,CAACC,GAAaC,KAAkBF,EAAqC,IAAI,GACzEG,IAAgBC,EAAmC,IAAI,GAEvDC,IAAaC,EAAaT,CAAO,GAEjCU,IAAe,MAAM,QAAQC,CAAS,IAAIA,EAAU,KAAK,GAAG,IAAKA,KAAa;CA0FpF,OAxFAC,QAAgB;EACZ,IAAI,CAACC,KAAW,CAACC,GAAK;GAClB,EAAU,MAAM;GAChB;EACJ;EASA,IAAMC,IAAYP,EAAW,QAAQ,WAAW,KAAA,GAC1CQ,IAAgBR,EAAW,QAAQ,iBAAiB,KAAA,GACpDS,IAAqBT,EAAW,QAAQ,sBAAsB,KAAA,GAE9DU,IAAaC,EAAmBL,GAAK;GACvC,WAAWN,EAAW,QAAQ;GAC9B;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA,aAAaA,EAAW,QAAQ;GAChC;GACA,aAAaA,EAAW,QAAQ;GAChC;GACA;GACA,QAAQO,KAAa,MAAQP,EAAW,QAAQ,SAASY,CAAG,IAAS,KAAA;GACrE,cAAcJ,KACP,GAAO,MAAQR,EAAW,QAAQ,eAAea,GAAOD,CAAG,IAC5D,KAAA;GACN,QAAQZ,EAAW,QAAQ;GAC3B,mBAAmBS,KACZ,GAAQ,MAAQT,EAAW,QAAQ,oBAAoBc,GAAQF,CAAG,IACnE,KAAA;GACN,gBAAgBlB;GAChB,SAAS,MAAUM,EAAW,QAAQ,SAASe,CAAK;GACpD,UAAU,MAAUf,EAAW,QAAQ,UAAUe,CAAK;GACtD,UAAU,MAAUf,EAAW,QAAQ,UAAUe,CAAK;GACtD,iBAAiB,GAAS,MAAUf,EAAW,QAAQ,iBAAiBgB,GAASC,CAAK;GACtF,qBAAqBjB,EAAW,QAAQ,gBAAgB;GACxD,SAAS,MAAWA,EAAW,QAAQ,SAASkB,CAAM;GACtD,YAAY,MAAY;IAEpB,AADArB,EAAesB,CAAO,GACtBnB,EAAW,QAAQ,YAAYmB,CAAO;GAC1C;EACJ,CAAC;EAGD,OAFA,EAAc,UAAUT,SAEX;GAET,AADAA,EAAW,MAAM,GACjB,EAAc,UAAU;EAC5B;CACJ,GAAG;EACCJ;EACAD;EACAH;EACAkB;EACAC;EACAC;EACAC;EACAC;EACAC;EACAC;EACAC;EACAC;EACAC;EACAC;EACA9B;CACJ,CAAC,GAcM;EAAE;EAAQ;EAAa,MAZjB+B,GAAa,MACfjC,EAAc,SAAS,KAAKkC,CAAO,KAAK,IAChD,CAAC,CAU0B;EAAM,WARlBD,QAAwB;GACtC,EAAc,SAAS,UAAU;EACrC,GAAG,CAAC,CAMgC;EAAW,mBAJrBA,GAAa,MAAqB;GACxD,EAAc,SAAS,kBAAkBE,CAAE;EAC/C,GAAG,CAAC,CAE2C;CAAkB;AACrE"}
+{"version":3,"file":"use-web-socket.js","names":["useWebSocket","options","status","setStatus","useState","lastMessage","setLastMessage","controllerRef","useRef","optionsRef","useLatestRef","protocolsKey","protocols","useEffect","enabled","url","hasParser","hasParseError","hasValidationError","hasPrincipal","controller","createWebSocket","raw","error","issues","event","attempt","total","reason","message","maxRetries","initialBackoff","maxBackoff","jitter","handshakeTimeout","silenceTimeout","waitForOnline","pingInterval","respondToPing","queueWhileClosed","maxQueuedMessages","useCallback","payload","ms"],"sources":["../../src/ws/use-web-socket.ts"],"sourcesContent":["import { useCallback, useEffect, useRef, useState } from \"react\";\nimport { useLatestRef } from \"@/hooks/use-latest-ref\";\nimport {\n    createWebSocket,\n    type CreateWebSocketOptions,\n    type WebSocketController,\n    type WebSocketMessage,\n    type WebSocketStatus,\n} from \"./create-web-socket\";\n\nexport interface UseWebSocketOptions<T> extends Omit<CreateWebSocketOptions<T>, \"onStatusChange\"> {\n    /** When false, the socket is not opened. Default: true. */\n    enabled?: boolean;\n}\n\nexport interface UseWebSocketResult<T> {\n    status: WebSocketStatus;\n    /**\n     * Last decoded frame received.\n     *\n     * A snapshot, not a stream: two frames arriving in the same tick collapse\n     * into a single render and only the later one is ever visible. One server\n     * action often emits several frames in a row, so anything that must see\n     * every message has to use `onMessage`, which fires once per frame. Read\n     * `lastMessage` for \"what is the current state\" rendering only.\n     */\n    lastMessage: WebSocketMessage<T> | null;\n    /** Send a payload through the active connection. Returns false when not open. */\n    send: (payload: string | Blob | BufferSource) => boolean;\n    /** Force a reconnect, resetting the retry counter. */\n    reconnect: () => void;\n    /**\n     * Change the silence watchdog at runtime, in ms. `0` disables it.\n     *\n     * For a server that announces its own heartbeat interval in the first frame,\n     * so the tolerated silence is not hard-coded on both ends.\n     */\n    setSilenceTimeout: (ms: number) => void;\n}\n\n/**\n * React hook around {@link createWebSocket}. Manages the connection lifecycle\n * for the host component and tears it down on unmount.\n *\n * Every callback is read through a ref, so `onOpen` / `onMessage` / `onClose` /\n * `onError` / `onReconnecting` / `onReconnected` / `onLost` / `getPrincipal` always run the\n * latest closure — an inline arrow function is fine and never reopens the\n * socket. Connection-shaping options (`protocols`, `maxRetries`,\n * `initialBackoff`, `maxBackoff`, `jitter`, `handshakeTimeout`,\n * `silenceTimeout`, `waitForOnline`, `pingInterval`, `queueWhileClosed`) are\n * baked into the connection, so changing one reopens it with the new value\n * rather than being silently ignored.\n *\n * `schema` is read when the socket opens, so declare it outside the component\n * (or memoize it): a schema built inline is a new object on every render, and\n * the one in force is whichever existed at the last open.\n *\n * @param url - Full ws:// or wss:// URL.\n * @param options - Connection configuration and callbacks.\n * @returns Status, last frame, and the `send` / `reconnect` controls.\n */\nexport function useWebSocket<T = unknown>(\n    url: string,\n    options: UseWebSocketOptions<T> = {},\n): UseWebSocketResult<T> {\n    const {\n        enabled = true,\n        protocols,\n        maxRetries,\n        initialBackoff,\n        maxBackoff,\n        jitter,\n        handshakeTimeout,\n        silenceTimeout,\n        waitForOnline,\n        pingInterval,\n        respondToPing,\n        queueWhileClosed,\n        maxQueuedMessages,\n    } = options;\n    const [status, setStatus] = useState<WebSocketStatus>(\"idle\");\n    const [lastMessage, setLastMessage] = useState<WebSocketMessage<T> | null>(null);\n    const controllerRef = useRef<WebSocketController | null>(null);\n\n    const optionsRef = useLatestRef(options);\n\n    const protocolsKey = Array.isArray(protocols) ? protocols.join(\",\") : (protocols ?? \"\");\n\n    useEffect(() => {\n        if (!enabled || !url) {\n            setStatus(\"idle\");\n            return;\n        }\n\n        /*\n         * Presence is read once, when the socket opens, and decides whether the\n         * forwarder is passed at all. A forwarder is always truthy, so wrapping\n         * an absent `parser` — or an absent `onParseError` — would tell\n         * `decodeFrame` the caller had supplied one and silently pick the wrong\n         * branch.\n         */\n        const hasParser = optionsRef.current.parser !== undefined;\n        const hasParseError = optionsRef.current.onParseError !== undefined;\n        const hasValidationError = optionsRef.current.onValidationError !== undefined;\n        const hasPrincipal = optionsRef.current.getPrincipal !== undefined;\n\n        const controller = createWebSocket<T>(url, {\n            protocols: optionsRef.current.protocols,\n            maxRetries,\n            initialBackoff,\n            maxBackoff,\n            jitter,\n            handshakeTimeout,\n            silenceTimeout,\n            waitForOnline,\n            pingInterval,\n            pingPayload: optionsRef.current.pingPayload,\n            respondToPing,\n            pongPayload: optionsRef.current.pongPayload,\n            queueWhileClosed,\n            maxQueuedMessages,\n            getPrincipal: hasPrincipal ? () => optionsRef.current.getPrincipal?.() : undefined,\n            parser: hasParser ? (raw) => optionsRef.current.parser?.(raw) as T : undefined,\n            onParseError: hasParseError\n                ? (error, raw) => optionsRef.current.onParseError?.(error, raw)\n                : undefined,\n            schema: optionsRef.current.schema,\n            onValidationError: hasValidationError\n                ? (issues, raw) => optionsRef.current.onValidationError?.(issues, raw)\n                : undefined,\n            onStatusChange: setStatus,\n            onOpen: (event) => optionsRef.current.onOpen?.(event),\n            onClose: (event) => optionsRef.current.onClose?.(event),\n            onError: (event) => optionsRef.current.onError?.(event),\n            onReconnecting: (attempt, total) => optionsRef.current.onReconnecting?.(attempt, total),\n            onReconnected: () => optionsRef.current.onReconnected?.(),\n            onLost: (reason) => optionsRef.current.onLost?.(reason),\n            onMessage: (message) => {\n                setLastMessage(message);\n                optionsRef.current.onMessage?.(message);\n            },\n        });\n        controllerRef.current = controller;\n\n        return () => {\n            controller.close();\n            controllerRef.current = null;\n        };\n    }, [\n        url,\n        enabled,\n        protocolsKey,\n        maxRetries,\n        initialBackoff,\n        maxBackoff,\n        jitter,\n        handshakeTimeout,\n        silenceTimeout,\n        waitForOnline,\n        pingInterval,\n        respondToPing,\n        queueWhileClosed,\n        maxQueuedMessages,\n        optionsRef,\n    ]);\n\n    const send = useCallback((payload: string | Blob | BufferSource): boolean => {\n        return controllerRef.current?.send(payload) ?? false;\n    }, []);\n\n    const reconnect = useCallback((): void => {\n        controllerRef.current?.reconnect();\n    }, []);\n\n    const setSilenceTimeout = useCallback((ms: number): void => {\n        controllerRef.current?.setSilenceTimeout(ms);\n    }, []);\n\n    return { status, lastMessage, send, reconnect, setSilenceTimeout };\n}\n"],"mappings":";;;;AA6DA,SAAgBA,EACZ,GACA,IAAkC,CAAC,GACd;CACrB,IAAM,EACF,aAAU,IACV,cACA,eACA,mBACA,eACA,WACA,qBACA,mBACA,kBACA,iBACA,kBACA,qBACA,yBACAC,GACE,CAACC,GAAQC,KAAaC,EAA0B,MAAM,GACtD,CAACC,GAAaC,KAAkBF,EAAqC,IAAI,GACzEG,IAAgBC,EAAmC,IAAI,GAEvDC,IAAaC,EAAaT,CAAO,GAEjCU,IAAe,MAAM,QAAQC,CAAS,IAAIA,EAAU,KAAK,GAAG,IAAKA,KAAa;CA4FpF,OA1FAC,QAAgB;EACZ,IAAI,CAACC,KAAW,CAACC,GAAK;GAClB,EAAU,MAAM;GAChB;EACJ;EASA,IAAMC,IAAYP,EAAW,QAAQ,WAAW,KAAA,GAC1CQ,IAAgBR,EAAW,QAAQ,iBAAiB,KAAA,GACpDS,IAAqBT,EAAW,QAAQ,sBAAsB,KAAA,GAC9DU,IAAeV,EAAW,QAAQ,iBAAiB,KAAA,GAEnDW,IAAaC,EAAmBN,GAAK;GACvC,WAAWN,EAAW,QAAQ;GAC9B;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA,aAAaA,EAAW,QAAQ;GAChC;GACA,aAAaA,EAAW,QAAQ;GAChC;GACA;GACA,cAAcU,UAAqBV,EAAW,QAAQ,eAAe,IAAI,KAAA;GACzE,QAAQO,KAAa,MAAQP,EAAW,QAAQ,SAASa,CAAG,IAAS,KAAA;GACrE,cAAcL,KACP,GAAO,MAAQR,EAAW,QAAQ,eAAec,GAAOD,CAAG,IAC5D,KAAA;GACN,QAAQb,EAAW,QAAQ;GAC3B,mBAAmBS,KACZ,GAAQ,MAAQT,EAAW,QAAQ,oBAAoBe,GAAQF,CAAG,IACnE,KAAA;GACN,gBAAgBnB;GAChB,SAAS,MAAUM,EAAW,QAAQ,SAASgB,CAAK;GACpD,UAAU,MAAUhB,EAAW,QAAQ,UAAUgB,CAAK;GACtD,UAAU,MAAUhB,EAAW,QAAQ,UAAUgB,CAAK;GACtD,iBAAiB,GAAS,MAAUhB,EAAW,QAAQ,iBAAiBiB,GAASC,CAAK;GACtF,qBAAqBlB,EAAW,QAAQ,gBAAgB;GACxD,SAAS,MAAWA,EAAW,QAAQ,SAASmB,CAAM;GACtD,YAAY,MAAY;IAEpB,AADAtB,EAAeuB,CAAO,GACtBpB,EAAW,QAAQ,YAAYoB,CAAO;GAC1C;EACJ,CAAC;EAGD,OAFA,EAAc,UAAUT,SAEX;GAET,AADAA,EAAW,MAAM,GACjB,EAAc,UAAU;EAC5B;CACJ,GAAG;EACCL;EACAD;EACAH;EACAmB;EACAC;EACAC;EACAC;EACAC;EACAC;EACAC;EACAC;EACAC;EACAC;EACAC;EACA/B;CACJ,CAAC,GAcM;EAAE;EAAQ;EAAa,MAZjBgC,GAAa,MACflC,EAAc,SAAS,KAAKmC,CAAO,KAAK,IAChD,CAAC,CAU0B;EAAM,WARlBD,QAAwB;GACtC,EAAc,SAAS,UAAU;EACrC,GAAG,CAAC,CAMgC;EAAW,mBAJrBA,GAAa,MAAqB;GACxD,EAAc,SAAS,kBAAkBE,CAAE;EAC/C,GAAG,CAAC,CAE2C;CAAkB;AACrE"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tempest-react-sdk",
-  "version": "0.80.0",
+  "version": "0.82.0",
   "description": "SDK público da Tempest com componentes, hooks e integrações para projetos React.",
   "type": "module",
   "license": "MIT",

package/template-pwa/src/pwa.tsx

@@ -8,8 +8,33 @@ import {
     requestPersistentStorage,
     useServiceWorkerUpdate,
 } from "tempest-react-sdk";
+import { clearSessionData } from "tempest-react-sdk/sw";
 import { useAuth } from "@/stores/auth";
 
+/**
+ * Remove what this device keeps for the account that just signed out: the
+ * service worker's runtime caches and background-sync queue
+ * (`clearSessionData()`, which keeps the app-shell precache), and the browser's
+ * push subscription, so the next person on this device does not receive the
+ * previous account's notifications.
+ *
+ * The push subscription is released in the browser only: the backend delete
+ * needs the token that logout just dropped. The push service answers the
+ * backend's next send to the dead endpoint with `404`/`410`, which is when the
+ * backend prunes it. Every step is best-effort — logout must not fail because
+ * the worker is missing (as under `npm run dev`) or push is unsupported.
+ */
+async function forgetSignedOutAccount(): Promise<void> {
+    await Promise.allSettled([
+        clearSessionData(),
+        (async () => {
+            const registration = await navigator.serviceWorker?.getRegistration();
+            const subscription = await registration?.pushManager?.getSubscription();
+            await subscription?.unsubscribe();
+        })(),
+    ]);
+}
+
 /**
  * PWA shell: registers the service worker, wires the consent-based update
  * prompt and the offline indicator, requests persistent storage (so the
@@ -24,6 +49,12 @@ import { useAuth } from "@/stores/auth";
  * would wait unsent until they expire. A project without accounts deletes this
  * effect along with `@/stores/auth`.
  *
+ * And it ends the device session whenever the signed-in account goes away —
+ * the Logout button, a `401` reaching `onUnauthorized`, or a different account
+ * signing in over it — by watching the auth store instead of each logout path
+ * (see `forgetSignedOutAccount`). A token refresh keeps the same user, so it
+ * clears nothing.
+ *
  * Wraps the app so the fixed-position overlays render as siblings of the tree.
  * The SDK helpers no-op gracefully where a capability is unsupported.
  */
@@ -49,6 +80,17 @@ export function PwaShell({ children }: { children: ReactNode }) {
         [],
     );
 
+    useEffect(
+        () =>
+            useAuth.subscribe((state, previous) => {
+                const ended =
+                    previous.isAuthenticated &&
+                    (!state.isAuthenticated || state.user?.id !== previous.user?.id);
+                if (ended) void forgetSignedOutAccount();
+            }),
+        [],
+    );
+
     useEffect(() => {
         if (!registration) return;
         void registerPeriodicSync({ registration, minIntervalMinutes: 360 });

package/template-pwa/src/sw.ts

@@ -14,27 +14,30 @@ import {
  *
  * Layers, in order:
  *  1. Push + notifications + skip-waiting (the SDK push helpers).
- *  2. Background sync — failed POST/PUT/PATCH/DELETE to `/api` are queued and
- *     replayed online. Credential headers are never stored; on replay the
- *     worker asks the open pages for the current ones and for who is signed in,
- *     which `src/pwa.tsx` answers from the auth store
+ *  2. Background sync — failed POST/PUT/PATCH/DELETE to this origin's `/api`
+ *     are queued and replayed online. Credential headers are never stored; on
+ *     replay the worker asks the open pages for the current ones and for who
+ *     is signed in, which `src/pwa.tsx` answers from the auth store
  *     (`provideBackgroundSyncCredentials`). Remove that and queued
- *     authenticated mutations never replay.
+ *     authenticated mutations never replay. The credential only goes back to
+ *     this origin: an API on another host goes in both the `match` and
+ *     `trustedOrigins`, or its credentialed entries are dropped on replay.
  *  3. Runtime caching: unauthenticated API GETs (network-first) + media
  *     (cache-first with Range support, so audio/video seeking works offline).
  *     Every request the API client sends with a bearer (`Authorization`, or any
  *     other credential header) bypasses this cache and goes to the network: in
  *     an app with accounts, most `/api` GETs. To serve them offline, add
  *     `cacheAuthenticated: true` to the route — entries then vary on the
- *     credential, so another account never reads them — and keep
- *     `clearSessionData()` in the logout flow.
+ *     credential, so another account never reads them. `src/pwa.tsx` already
+ *     calls `clearSessionData()` whenever the signed-in account goes away.
  *  4. Precache of the app shell so the app launches offline (API navigations
  *     excluded). Reads the `precache-manifest.json` emitted by
  *     `tempestPwaManifest()` in `vite.config.ts`.
  *
  * Cache names carry the `tempest-` prefix so `inspectCaches({ filter: "tempest-" })`
- * reports them. On logout, call `clearSessionData()` from the page: it drops
- * the runtime caches and the background-sync queue, keeping the precache.
+ * reports them. On logout `src/pwa.tsx` calls `clearSessionData()` from the
+ * page: it drops the runtime caches and the background-sync queue, keeping the
+ * precache.
  *
  * `installRuntimeCache` is registered BEFORE `installPrecache` so its specific
  * routes win over the precache catch-all. The trailing `activate` listener takes
@@ -53,7 +56,9 @@ installPushHandler({
 installNotificationClickHandler();
 installSkipWaitingListener();
 
-installBackgroundSync({ match: (url) => url.pathname.startsWith("/api/") });
+installBackgroundSync({
+    match: (url) => url.origin === self.location.origin && url.pathname.startsWith("/api/"),
+});
 
 installRuntimeCache([
     {