react-router 8.2.0 → 8.3.1

package/dist/development/lib/rsc/html-stream/server.js

@@ -1,5 +1,5 @@
 /**
- * react-router v8.2.0
+ * react-router v8.3.1
  *
  * Copyright (c) Remix Software Inc.
  *
@@ -11,11 +11,13 @@
 //#region lib/rsc/html-stream/server.ts
 const encoder = new TextEncoder();
 const trailer = "</body></html>";
-function injectRSCPayload(rscStream) {
+function injectRSCPayload(rscStream, { nonce } = {}) {
 	let decoder = new TextDecoder();
 	let resolveFlightDataPromise;
 	let flightDataPromise = new Promise((resolve) => resolveFlightDataPromise = resolve);
 	let startedRSC = false;
+	let cancelled = false;
+	let rscReader = null;
 	let buffered = [];
 	let timeout = null;
 	function flushBufferedChunks(controller) {
@@ -32,10 +34,12 @@ function injectRSCPayload(rscStream) {
 			buffered.push(chunk);
 			if (timeout) return;
 			timeout = setTimeout(async () => {
+				if (cancelled) return;
 				flushBufferedChunks(controller);
 				if (!startedRSC) {
 					startedRSC = true;
-					writeRSCStream(rscStream, controller).catch((err) => controller.error(err)).then(resolveFlightDataPromise);
+					rscReader = rscStream.getReader();
+					writeRSCStream(rscReader, controller, () => cancelled, nonce).catch((err) => controller.error(err)).then(resolveFlightDataPromise);
 				}
 			}, 0);
 		},
@@ -46,30 +50,45 @@ function injectRSCPayload(rscStream) {
 				flushBufferedChunks(controller);
 			}
 			controller.enqueue(encoder.encode("</body></html>"));
+		},
+		async cancel(reason) {
+			cancelled = true;
+			if (timeout) {
+				clearTimeout(timeout);
+				timeout = null;
+			}
+			buffered.length = 0;
+			if (rscReader) await rscReader.cancel(reason).catch(() => {});
+			else await rscStream.cancel(reason).catch(() => {});
+			resolveFlightDataPromise();
 		}
 	});
 }
-async function writeRSCStream(rscStream, controller) {
+async function writeRSCStream(reader, controller, isCancelled, nonce) {
 	let decoder = new TextDecoder("utf-8", { fatal: true });
-	const reader = rscStream.getReader();
 	try {
 		let read;
 		while ((read = await reader.read()) && !read.done) {
+			if (isCancelled()) return;
 			const chunk = read.value;
 			try {
-				writeChunk(JSON.stringify(decoder.decode(chunk, { stream: true })), controller);
-			} catch (e) {
-				writeChunk(`Uint8Array.from(atob(${JSON.stringify(btoa(String.fromCodePoint(...chunk)))}), m => m.codePointAt(0))`, controller);
+				writeChunk(JSON.stringify(decoder.decode(chunk, { stream: true })), controller, nonce);
+			} catch {
+				writeChunk(`Uint8Array.from(atob(${JSON.stringify(btoa(String.fromCodePoint(...chunk)))}), m => m.codePointAt(0))`, controller, nonce);
 			}
 		}
 	} finally {
 		reader.releaseLock();
 	}
 	let remaining = decoder.decode();
-	if (remaining.length) writeChunk(JSON.stringify(remaining), controller);
+	if (remaining.length && !isCancelled()) writeChunk(JSON.stringify(remaining), controller, nonce);
+}
+function writeChunk(chunk, controller, nonce) {
+	let nonceAttr = nonce == null ? "" : ` nonce="${escapeAttribute(nonce)}"`;
+	controller.enqueue(encoder.encode(`<script${nonceAttr}>${escapeScript(`(self.__FLIGHT_DATA||=[]).push(${chunk})`)}<\/script>`));
 }
-function writeChunk(chunk, controller) {
-	controller.enqueue(encoder.encode(`<script>${escapeScript(`(self.__FLIGHT_DATA||=[]).push(${chunk})`)}<\/script>`));
+function escapeAttribute(value) {
+	return value.replace(/&/g, "&amp;").replace(/"/g, "&quot;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
 }
 function escapeScript(script) {
 	return script.replace(/<!--/g, "<\\!--").replace(/<\/(script)/gi, "</\\$1");

package/dist/development/lib/rsc/route-modules.js

@@ -1,5 +1,5 @@
 /**
- * react-router v8.2.0
+ * react-router v8.3.1
  *
  * Copyright (c) Remix Software Inc.
  *

package/dist/development/lib/rsc/server.rsc.d.ts

@@ -65,13 +65,13 @@ type RSCRenderPayload = {
   type: "render";
   actionData: Record<string, any> | null;
   basename: string | undefined;
+  clientVersion?: string;
   errors: Record<string, any> | null;
   loaderData: Record<string, any>;
   location: Location;
   routeDiscovery: RouteDiscovery;
   matches: RSCRouteMatch[];
   patches?: Promise<RSCRouteManifest[]>;
-  nonce?: string;
   formState?: ReactFormState;
 };
 type RSCManifestPayload = {
@@ -168,6 +168,8 @@ type RouteDiscovery = {
  * encoding the {@link unstable_RSCPayload}.
  * @param opts.loadServerAction Your `react-server-dom-xyz/server`'s
  * `loadServerAction` function, used to load a server action by ID.
+ * @param opts.clientVersion A version derived from the client build output used
+ * to detect stale clients during lazy route discovery.
  * @param opts.onError An optional error handler that will be called with any
  * errors that occur during the request processing.
  * @param opts.request The [`Request`](https://developer.mozilla.org/en-US/docs/Web/API/Request)
@@ -191,6 +193,7 @@ declare function matchRSCServerRequest({
   loadServerAction,
   decodeAction,
   decodeFormState,
+  clientVersion,
   onError,
   request,
   routes,
@@ -204,6 +207,7 @@ declare function matchRSCServerRequest({
   decodeFormState?: DecodeFormStateFunction;
   requestContext?: RouterContextProvider;
   loadServerAction?: LoadServerActionFunction;
+  clientVersion?: string;
   onError?: (error: unknown) => void;
   request: Request;
   routes: RSCRouteConfigEntry[];

package/dist/development/lib/rsc/server.ssr.d.ts

@@ -26,12 +26,17 @@ type SSRCreateFromReadableStreamFunction = (body: ReadableStream<Uint8Array>) =>
  *   request,
  *   serverResponse,
  *   createFromReadableStream,
- *   async renderHTML(getPayload) {
+ *   nonce,
+ *   async renderHTML(getPayload, options) {
  *     const payload = getPayload();
  *
  *     return await renderHTMLToReadableStream(
- *       <RSCStaticRouter getPayload={getPayload} />,
+ *       <RSCStaticRouter
+ *         getPayload={getPayload}
+ *         nonce={options.nonce}
+ *       />,
  *       {
+ *         ...options,
  *         bootstrapScriptContent,
  *         formState: await payload.formState,
  *       }
@@ -49,6 +54,8 @@ type SSRCreateFromReadableStreamFunction = (body: ReadableStream<Uint8Array>) =>
  * @param opts.serverResponse A Response or partial response generated by the [RSC](https://react.dev/reference/rsc/server-components) handler containing a serialized {@link unstable_RSCPayload}.
  * @param opts.hydrate Whether to hydrate the server response with the RSC payload.
  * Defaults to `true`.
+ * @param opts.nonce An optional [`nonce`](https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Global_attributes/nonce)
+ * for inline scripts generated while rendering the HTML document.
  * @param opts.renderHTML A function that renders the {@link unstable_RSCPayload} to
  * HTML, usually using a {@link unstable_RSCStaticRouter | `<RSCStaticRouter>`}.
  * @param opts.request The request to route.
@@ -61,16 +68,19 @@ declare function routeRSCServerRequest({
   serverResponse,
   createFromReadableStream,
   renderHTML,
-  hydrate
+  hydrate,
+  nonce
 }: {
   request: Request;
   serverResponse: Response;
   createFromReadableStream: SSRCreateFromReadableStreamFunction;
   renderHTML: (getPayload: () => DecodedPayload, options: {
+    nonce?: string;
     onError(error: unknown): string | undefined;
     onHeaders(headers: Headers): void;
   }) => ReadableStream<Uint8Array> | Promise<ReadableStream<Uint8Array>>;
   hydrate?: boolean;
+  nonce?: string;
 }): Promise<Response>;
 /**
  * Props for the {@link unstable_RSCStaticRouter} component.
@@ -84,6 +94,12 @@ interface RSCStaticRouterProps {
    * through from {@link unstable_routeRSCServerRequest}'s `renderHTML`.
    */
   getPayload: () => DecodedPayload;
+  /**
+   * An optional [`nonce`](https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Global_attributes/nonce)
+   * used as the default for nonce-aware components such as `<Links>` and
+   * `<ScrollRestoration>`.
+   */
+  nonce?: string;
 }
 /**
  * Pre-renders an {@link unstable_RSCPayload} to HTML. Usually used in
@@ -101,12 +117,17 @@ interface RSCStaticRouterProps {
  *   request,
  *   serverResponse,
  *   createFromReadableStream,
- *   async renderHTML(getPayload) {
+ *   nonce,
+ *   async renderHTML(getPayload, options) {
  *     const payload = getPayload();
  *
  *     return await renderHTMLToReadableStream(
- *       <RSCStaticRouter getPayload={getPayload} />,
+ *       <RSCStaticRouter
+ *         getPayload={getPayload}
+ *         nonce={options.nonce}
+ *       />,
  *       {
+ *         ...options,
  *         bootstrapScriptContent,
  *         formState: await payload.formState,
  *       }
@@ -120,10 +141,12 @@ interface RSCStaticRouterProps {
  * @mode data
  * @param props Props
  * @param {unstable_RSCStaticRouterProps.getPayload} props.getPayload n/a
+ * @param {unstable_RSCStaticRouterProps.nonce} props.nonce n/a
  * @returns A React component that renders the {@link unstable_RSCPayload} as HTML.
  */
 declare function RSCStaticRouter({
-  getPayload
+  getPayload,
+  nonce
 }: RSCStaticRouterProps): React$1.JSX.Element | null;
 //#endregion
 export { RSCStaticRouter, RSCStaticRouterProps, SSRCreateFromReadableStreamFunction, routeRSCServerRequest };

package/dist/development/lib/rsc/server.ssr.js

@@ -1,5 +1,5 @@
 /**
- * react-router v8.2.0
+ * react-router v8.3.1
  *
  * Copyright (c) Remix Software Inc.
  *
@@ -40,12 +40,17 @@ const defaultManifestPath = "/__manifest";
 *   request,
 *   serverResponse,
 *   createFromReadableStream,
-*   async renderHTML(getPayload) {
+*   nonce,
+*   async renderHTML(getPayload, options) {
 *     const payload = getPayload();
 *
 *     return await renderHTMLToReadableStream(
-*       <RSCStaticRouter getPayload={getPayload} />,
+*       <RSCStaticRouter
+*         getPayload={getPayload}
+*         nonce={options.nonce}
+*       />,
 *       {
+*         ...options,
 *         bootstrapScriptContent,
 *         formState: await payload.formState,
 *       }
@@ -63,6 +68,8 @@ const defaultManifestPath = "/__manifest";
 * @param opts.serverResponse A Response or partial response generated by the [RSC](https://react.dev/reference/rsc/server-components) handler containing a serialized {@link unstable_RSCPayload}.
 * @param opts.hydrate Whether to hydrate the server response with the RSC payload.
 * Defaults to `true`.
+* @param opts.nonce An optional [`nonce`](https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Global_attributes/nonce)
+* for inline scripts generated while rendering the HTML document.
 * @param opts.renderHTML A function that renders the {@link unstable_RSCPayload} to
 * HTML, usually using a {@link unstable_RSCStaticRouter | `<RSCStaticRouter>`}.
 * @param opts.request The request to route.
@@ -70,7 +77,7 @@ const defaultManifestPath = "/__manifest";
 * that either contains the [RSC](https://react.dev/reference/rsc/server-components)
 * payload for data requests, or renders the HTML for document requests.
 */
-async function routeRSCServerRequest({ request, serverResponse, createFromReadableStream, renderHTML, hydrate = true }) {
+async function routeRSCServerRequest({ request, serverResponse, createFromReadableStream, renderHTML, hydrate = true, nonce }) {
 	const url = new URL(request.url);
 	if (isReactServerRequest(url) || isManifestRequest(url) || request.headers.has("rsc-action-id") || serverResponse.headers.get("React-Router-Resource") === "true") return serverResponse;
 	if (!serverResponse.body) throw new Error("Missing body in server response");
@@ -140,6 +147,7 @@ async function routeRSCServerRequest({ request, serverResponse, createFromReadab
 		let status = serverResponse.status;
 		let statusText = serverResponse.statusText;
 		let html = await renderHTML(getPayload, {
+			nonce,
 			onError(error) {
 				if (typeof error === "object" && error && "digest" in error && typeof error.digest === "string") {
 					renderRedirect = decodeRedirectErrorDigest(error.digest);
@@ -180,7 +188,7 @@ async function routeRSCServerRequest({ request, serverResponse, createFromReadab
 			headers
 		});
 		if (!serverResponseB?.body) throw new Error("Failed to clone server response");
-		const body = html.pipeThrough(injectRSCPayload(serverResponseB.body)).pipeThrough(redirectTransform);
+		const body = html.pipeThrough(injectRSCPayload(serverResponseB.body, { nonce })).pipeThrough(redirectTransform);
 		return new Response(body, {
 			status,
 			statusText,
@@ -219,6 +227,7 @@ async function routeRSCServerRequest({ request, serverResponse, createFromReadab
 					} }
 				});
 			}, {
+				nonce,
 				onError(error) {
 					if (typeof error === "object" && error && "digest" in error && typeof error.digest === "string") {
 						retryRedirect = decodeRedirectErrorDigest(error.digest);
@@ -258,13 +267,13 @@ async function routeRSCServerRequest({ request, serverResponse, createFromReadab
 				headers
 			});
 			if (!serverResponseB?.body) throw new Error("Failed to clone server response");
-			const body = html.pipeThrough(injectRSCPayload(serverResponseB.body)).pipeThrough(retryRedirectTransform);
+			const body = html.pipeThrough(injectRSCPayload(serverResponseB.body, { nonce })).pipeThrough(retryRedirectTransform);
 			return new Response(body, {
 				status,
 				statusText,
 				headers
 			});
-		} catch (error2) {}
+		} catch {}
 		throw error;
 	}
 }
@@ -284,12 +293,17 @@ async function routeRSCServerRequest({ request, serverResponse, createFromReadab
 *   request,
 *   serverResponse,
 *   createFromReadableStream,
-*   async renderHTML(getPayload) {
+*   nonce,
+*   async renderHTML(getPayload, options) {
 *     const payload = getPayload();
 *
 *     return await renderHTMLToReadableStream(
-*       <RSCStaticRouter getPayload={getPayload} />,
+*       <RSCStaticRouter
+*         getPayload={getPayload}
+*         nonce={options.nonce}
+*       />,
 *       {
+*         ...options,
 *         bootstrapScriptContent,
 *         formState: await payload.formState,
 *       }
@@ -303,9 +317,10 @@ async function routeRSCServerRequest({ request, serverResponse, createFromReadab
 * @mode data
 * @param props Props
 * @param {unstable_RSCStaticRouterProps.getPayload} props.getPayload n/a
+* @param {unstable_RSCStaticRouterProps.nonce} props.nonce n/a
 * @returns A React component that renders the {@link unstable_RSCPayload} as HTML.
 */
-function RSCStaticRouter({ getPayload }) {
+function RSCStaticRouter({ getPayload, nonce }) {
 	const decoded = getPayload();
 	const payload = React$1.use(decoded);
 	if (payload.type === "redirect") {
@@ -385,13 +400,13 @@ function RSCStaticRouter({ getPayload }) {
 			mode: "lazy",
 			manifestPath: payload.routeDiscovery.manifestPath || defaultManifestPath
 		},
-		routeModules: createRSCRouteModules(payload)
+		routeModules: createRSCRouteModules(payload),
+		nonce
 	};
 	return /* @__PURE__ */ React$1.createElement(RSCRouterContext.Provider, { value: true }, /* @__PURE__ */ React$1.createElement(RSCRouterGlobalErrorBoundary, { location: payload.location }, /* @__PURE__ */ React$1.createElement(FrameworkContext.Provider, { value: frameworkContext }, /* @__PURE__ */ React$1.createElement(StaticRouterProvider, {
 		context,
 		router,
-		hydrate: false,
-		nonce: payload.nonce
+		hydrate: false
 	}))));
 }
 function isReactServerRequest(url) {

package/dist/development/lib/server-runtime/cookies.d.ts

@@ -53,13 +53,39 @@ interface Cookie {
 }
 /**
  * Creates a logical container for managing a browser cookie from the server.
+ *
+ * @public
+ * @category Utils
+ * @mode framework
+ * @mode data
+ * @param name The name of the cookie.
+ * @param cookieOptions Options for parsing and serializing the cookie.
+ * @returns A {@link Cookie} object for parsing and serializing the cookie.
  */
 declare const createCookie: (name: string, cookieOptions?: CookieOptions) => Cookie;
+/**
+ * A function that determines whether a value is a React Router {@link Cookie}
+ * object.
+ *
+ * @public
+ * @category Utils
+ * @mode framework
+ * @mode data
+ * @param object The value to check.
+ * @returns `true` if the value is a React Router {@link Cookie} object;
+ * otherwise, `false`.
+ */
 type IsCookieFunction = (object: any) => object is Cookie;
 /**
- * Returns true if an object is a Remix cookie container.
+ * Returns `true` if a value is a React Router {@link Cookie} object.
  *
- * @see https://remix.run/utils/cookies#iscookie
+ * @public
+ * @category Utils
+ * @mode framework
+ * @mode data
+ * @param object The value to check.
+ * @returns `true` if the value is a React Router {@link Cookie} object;
+ * otherwise, `false`.
  */
 declare const isCookie: IsCookieFunction;
 //#endregion

package/dist/development/lib/server-runtime/cookies.js

@@ -1,5 +1,5 @@
 /**
- * react-router v8.2.0
+ * react-router v8.3.1
  *
  * Copyright (c) Remix Software Inc.
  *
@@ -14,6 +14,14 @@ import { parse, serialize } from "cookie-es";
 //#region lib/server-runtime/cookies.ts
 /**
 * Creates a logical container for managing a browser cookie from the server.
+*
+* @public
+* @category Utils
+* @mode framework
+* @mode data
+* @param name The name of the cookie.
+* @param cookieOptions Options for parsing and serializing the cookie.
+* @returns A {@link Cookie} object for parsing and serializing the cookie.
 */
 const createCookie = (name, cookieOptions = {}) => {
 	let { secrets = [], ...options } = {
@@ -53,9 +61,15 @@ const createCookie = (name, cookieOptions = {}) => {
 	};
 };
 /**
-* Returns true if an object is a Remix cookie container.
+* Returns `true` if a value is a React Router {@link Cookie} object.
 *
-* @see https://remix.run/utils/cookies#iscookie
+* @public
+* @category Utils
+* @mode framework
+* @mode data
+* @param object The value to check.
+* @returns `true` if the value is a React Router {@link Cookie} object;
+* otherwise, `false`.
 */
 const isCookie = (object) => {
 	return object != null && typeof object.name === "string" && typeof object.isSigned === "boolean" && typeof object.parse === "function" && typeof object.serialize === "function";
@@ -81,7 +95,7 @@ function encodeData(value) {
 function decodeData(value) {
 	try {
 		return JSON.parse(decodeURIComponent(myEscape(atob(value))));
-	} catch (e) {
+	} catch {
 		return {};
 	}
 }

package/dist/development/lib/server-runtime/crypto.js

@@ -1,5 +1,5 @@
 /**
- * react-router v8.2.0
+ * react-router v8.3.1
  *
  * Copyright (c) Remix Software Inc.
  *
@@ -26,7 +26,7 @@ const unsign = async (cookie, secret) => {
 	try {
 		let signature = byteStringToUint8Array(atob(hash));
 		return await crypto.subtle.verify("HMAC", key, signature, data) ? value : false;
-	} catch (e) {
+	} catch {
 		return false;
 	}
 };

package/dist/development/lib/server-runtime/data.js

@@ -1,5 +1,5 @@
 /**
- * react-router v8.2.0
+ * react-router v8.3.1
  *
  * Copyright (c) Remix Software Inc.
  *

package/dist/development/lib/server-runtime/dev.js

@@ -1,5 +1,5 @@
 /**
- * react-router v8.2.0
+ * react-router v8.3.1
  *
  * Copyright (c) Remix Software Inc.
  *
@@ -19,7 +19,7 @@ function getDevServerHooks() {
 function getBuildTimeHeader(request, headerName) {
 	if (typeof process !== "undefined") try {
 		if (process.env.hasOwnProperty("IS_RR_BUILD_REQUEST") && process.env.IS_RR_BUILD_REQUEST === "yes") return request.headers.get(headerName);
-	} catch (e) {}
+	} catch {}
 	return null;
 }
 //#endregion

package/dist/development/lib/server-runtime/entry.js

@@ -1,5 +1,5 @@
 /**
- * react-router v8.2.0
+ * react-router v8.3.1
  *
  * Copyright (c) Remix Software Inc.
  *

package/dist/development/lib/server-runtime/errors.js

@@ -1,5 +1,5 @@
 /**
- * react-router v8.2.0
+ * react-router v8.3.1
  *
  * Copyright (c) Remix Software Inc.
  *

package/dist/development/lib/server-runtime/headers.js

@@ -1,5 +1,5 @@
 /**
- * react-router v8.2.0
+ * react-router v8.3.1
  *
  * Copyright (c) Remix Software Inc.
  *

package/dist/development/lib/server-runtime/invariant.js

@@ -1,5 +1,5 @@
 /**
- * react-router v8.2.0
+ * react-router v8.3.1
  *
  * Copyright (c) Remix Software Inc.
  *

package/dist/development/lib/server-runtime/mode.js

@@ -1,5 +1,5 @@
 /**
- * react-router v8.2.0
+ * react-router v8.3.1
  *
  * Copyright (c) Remix Software Inc.
  *

package/dist/development/lib/server-runtime/routeMatching.js

@@ -1,5 +1,5 @@
 /**
- * react-router v8.2.0
+ * react-router v8.3.1
  *
  * Copyright (c) Remix Software Inc.
  *

package/dist/development/lib/server-runtime/routes.js

@@ -1,5 +1,5 @@
 /**
- * react-router v8.2.0
+ * react-router v8.3.1
  *
  * Copyright (c) Remix Software Inc.
  *

package/dist/development/lib/server-runtime/server.d.ts

@@ -5,6 +5,18 @@ import { ServerBuild } from "./build.js";
 //#region lib/server-runtime/server.d.ts
 type RequestHandler = (request: Request, loadContext?: RouterContextProvider) => Promise<Response>;
 type CreateRequestHandlerFunction = (build: ServerBuild | (() => ServerBuild | Promise<ServerBuild>), mode?: string) => RequestHandler;
+/**
+ * Creates a request handler for a React Router server build.
+ *
+ * This is a low-level API used by server adapters to translate incoming
+ * requests into React Router responses.
+ *
+ * @category Utils
+ * @param build The server build, or a function that resolves to the server
+ * build, used to handle requests.
+ * @param mode The mode in which the server build is running.
+ * @returns A request handler that returns a response for each incoming request.
+ */
 declare const createRequestHandler: CreateRequestHandlerFunction;
 //#endregion
 export { CreateRequestHandlerFunction, RequestHandler, createRequestHandler };

package/dist/development/lib/server-runtime/server.js

@@ -1,5 +1,5 @@
 /**
- * react-router v8.2.0
+ * react-router v8.3.1
  *
  * Copyright (c) Remix Software Inc.
  *
@@ -137,6 +137,18 @@ function derive(build, mode) {
 		requestHandler
 	};
 }
+/**
+* Creates a request handler for a React Router server build.
+*
+* This is a low-level API used by server adapters to translate incoming
+* requests into React Router responses.
+*
+* @category Utils
+* @param build The server build, or a function that resolves to the server
+* build, used to handle requests.
+* @param mode The mode in which the server build is running.
+* @returns A request handler that returns a response for each incoming request.
+*/
 const createRequestHandler = (build, mode) => {
 	let _build;
 	let serverMode;
@@ -269,7 +281,7 @@ async function handleDocumentRequest(serverMode, build, staticHandler, request,
 			if (isResponse(error)) try {
 				let data = await unwrapResponse(error);
 				errorForSecondRender = new ErrorResponseImpl(error.status, error.statusText, data);
-			} catch (e) {}
+			} catch {}
 			context = getStaticContextFromError(staticHandler.dataRoutes, context, errorForSecondRender);
 			if (context.errors) context.errors = sanitizeErrors(context.errors, serverMode);
 			let state = {

package/dist/development/lib/server-runtime/serverHandoff.js

@@ -1,5 +1,5 @@
 /**
- * react-router v8.2.0
+ * react-router v8.3.1
  *
  * Copyright (c) Remix Software Inc.
  *

package/dist/development/lib/server-runtime/sessions/cookieStorage.d.ts

@@ -17,6 +17,14 @@ interface CookieSessionStorageOptions {
  * needed, and can help to simplify some load-balanced scenarios. However, it
  * also has the limitation that serialized session data may not exceed the
  * browser's maximum cookie size. Trade-offs!
+ *
+ * @public
+ * @category Utils
+ * @mode framework
+ * @mode data
+ * @param options Options for creating the cookie-backed session storage.
+ * @returns A {@link SessionStorage} object that stores all session data in its
+ * cookie.
  */
 declare function createCookieSessionStorage<Data = SessionData, FlashData = Data>({
   cookie: cookieArg

package/dist/development/lib/server-runtime/sessions/cookieStorage.js

@@ -1,5 +1,5 @@
 /**
- * react-router v8.2.0
+ * react-router v8.3.1
  *
  * Copyright (c) Remix Software Inc.
  *
@@ -19,6 +19,14 @@ import { createSession, warnOnceAboutSigningSessionCookie } from "../sessions.js
 * needed, and can help to simplify some load-balanced scenarios. However, it
 * also has the limitation that serialized session data may not exceed the
 * browser's maximum cookie size. Trade-offs!
+*
+* @public
+* @category Utils
+* @mode framework
+* @mode data
+* @param options Options for creating the cookie-backed session storage.
+* @returns A {@link SessionStorage} object that stores all session data in its
+* cookie.
 */
 function createCookieSessionStorage({ cookie: cookieArg } = {}) {
 	let cookie = isCookie(cookieArg) ? cookieArg : createCookie(cookieArg?.name || "__session", cookieArg);