@rpcbase/client 0.290.0 → 0.291.0

package/dist/index.d.ts

@@ -4,4 +4,5 @@ export * from './types';
 export * from './getFeatureFlag';
 export * from './RootProvider';
 export * from './hooks';
+export * from './ssrErrorState';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAC3B,cAAc,kBAAkB,CAAA;AAChC,cAAc,SAAS,CAAA;AACvB,cAAc,kBAAkB,CAAA;AAChC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,SAAS,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAC3B,cAAc,kBAAkB,CAAA;AAChC,cAAc,SAAS,CAAA;AACvB,cAAc,kBAAkB,CAAA;AAChC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,SAAS,CAAA;AACvB,cAAc,iBAAiB,CAAA"}

package/dist/index.js

@@ -77,6 +77,32 @@ const cleanupURL = () => {
     document.addEventListener("DOMContentLoaded", runCleanup, { once: true });
   }
 };
+const SSR_ERROR_STATE_GLOBAL_KEY = "__RPCBASE_SSR_ERROR__";
+const ESCAPED_LT = /</g;
+const ESCAPED_U2028 = /\u2028/g;
+const ESCAPED_U2029 = /\u2029/g;
+const serializeSsrErrorState = (state) => JSON.stringify(state).replace(ESCAPED_LT, "\\u003c").replace(ESCAPED_U2028, "\\u2028").replace(ESCAPED_U2029, "\\u2029");
+const peekClientSsrErrorState = () => {
+  if (typeof window === "undefined") {
+    return null;
+  }
+  const globalScope = window;
+  const state = globalScope[SSR_ERROR_STATE_GLOBAL_KEY];
+  if (state && typeof state === "object") {
+    return state;
+  }
+  return null;
+};
+const consumeClientSsrErrorState = () => {
+  const state = peekClientSsrErrorState();
+  if (!state) {
+    return null;
+  }
+  if (typeof window !== "undefined") {
+    delete window[SSR_ERROR_STATE_GLOBAL_KEY];
+  }
+  return state;
+};
 const isProduction = globalThis.__rb_env__.MODE === "production";
 const showErrorOverlay = (err) => {
   const ErrorOverlay = customElements.get("vite-error-overlay");
@@ -98,7 +124,34 @@ const handleServerErrors = () => {
     });
   }
 };
+const getRootElement = () => {
+  const el = document.getElementById("root");
+  if (!el) {
+    throw new Error("Root element #root not found");
+  }
+  return el;
+};
+const hydrateSsrFallbackIfPresent = (rootElement, renderSsrErrorFallback) => {
+  const ssrErrorState = peekClientSsrErrorState();
+  if (!ssrErrorState) {
+    return false;
+  }
+  const fallback = renderSsrErrorFallback?.(ssrErrorState);
+  if (!fallback) {
+    return false;
+  }
+  consumeClientSsrErrorState();
+  hydrateRoot(
+    rootElement,
+    /* @__PURE__ */ jsx(StrictMode, { children: fallback })
+  );
+  return true;
+};
 const initWithRoutes = async (routesElement, opts) => {
+  const rootElement = getRootElement();
+  if (hydrateSsrFallbackIfPresent(rootElement, opts?.renderSsrErrorFallback)) {
+    return;
+  }
   await initApiClient();
   cleanupURL();
   handleServerErrors();
@@ -143,7 +196,7 @@ const initWithRoutes = async (routesElement, opts) => {
     }
   } : void 0;
   hydrateRoot(
-    document.getElementById("root"),
+    rootElement,
     /* @__PURE__ */ jsx(StrictMode, { children: /* @__PURE__ */ jsx(RouterProvider, { router }) }),
     hydrationOptions
   );
@@ -1516,10 +1569,14 @@ const useMediaQuery = (query) => {
 };
 export {
   RootProvider,
+  SSR_ERROR_STATE_GLOBAL_KEY,
   apiClient,
+  consumeClientSsrErrorState,
   getFeatureFlag,
   initApiClient,
   initWithRoutes,
+  peekClientSsrErrorState,
+  serializeSsrErrorState,
   useMediaQuery,
   useThrottledMeasure
 };

package/dist/initWithRoutes.d.ts

@@ -1,6 +1,9 @@
+import { ReactElement } from 'react';
 import { createRoutesFromElements } from '../../router/src';
+import { SsrErrorStatePayload } from './ssrErrorState';
 type InitWithRoutesOptions = {
     devThrowsOnHydrationErrors?: boolean;
+    renderSsrErrorFallback?: (state: SsrErrorStatePayload) => ReactElement | null;
 };
 type RoutesElement = Parameters<typeof createRoutesFromElements>[0];
 export declare const initWithRoutes: (routesElement: RoutesElement, opts?: InitWithRoutesOptions) => Promise<void>;

package/dist/initWithRoutes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"initWithRoutes.d.ts","sourceRoot":"","sources":["../src/initWithRoutes.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAsB,wBAAwB,EAAiB,MAAM,iBAAiB,CAAA;AAqC7F,KAAK,qBAAqB,GAAG;IAC3B,0BAA0B,CAAC,EAAE,OAAO,CAAA;CACrC,CAAA;AAED,KAAK,aAAa,GAAG,UAAU,CAAC,OAAO,wBAAwB,CAAC,CAAC,CAAC,CAAC,CAAA;AAEnE,eAAO,MAAM,cAAc,GACzB,eAAe,aAAa,EAC5B,OAAO,qBAAqB,kBA0E7B,CAAA"}
+{"version":3,"file":"initWithRoutes.d.ts","sourceRoot":"","sources":["../src/initWithRoutes.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAc,MAAM,OAAO,CAAA;AAEhD,OAAO,EAAsB,wBAAwB,EAAiB,MAAM,iBAAiB,CAAA;AAK7F,OAAO,EAGL,oBAAoB,EACrB,MAAM,iBAAiB,CAAA;AAiCxB,KAAK,qBAAqB,GAAG;IAC3B,0BAA0B,CAAC,EAAE,OAAO,CAAA;IACpC,sBAAsB,CAAC,EAAE,CAAC,KAAK,EAAE,oBAAoB,KAAK,YAAY,GAAG,IAAI,CAAA;CAC9E,CAAA;AAED,KAAK,aAAa,GAAG,UAAU,CAAC,OAAO,wBAAwB,CAAC,CAAC,CAAC,CAAC,CAAA;AAkCnE,eAAO,MAAM,cAAc,GACzB,eAAe,aAAa,EAC5B,OAAO,qBAAqB,kBA+E7B,CAAA"}

package/dist/ssrErrorState.d.ts

@@ -0,0 +1,11 @@
+export declare const SSR_ERROR_STATE_GLOBAL_KEY = "__RPCBASE_SSR_ERROR__";
+export type SsrErrorStatePayload = {
+    statusCode?: number;
+    title?: string;
+    message?: string;
+    details?: string;
+};
+export declare const serializeSsrErrorState: (state: SsrErrorStatePayload) => string;
+export declare const peekClientSsrErrorState: () => SsrErrorStatePayload | null;
+export declare const consumeClientSsrErrorState: () => SsrErrorStatePayload | null;
+//# sourceMappingURL=ssrErrorState.d.ts.map

package/dist/ssrErrorState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ssrErrorState.d.ts","sourceRoot":"","sources":["../src/ssrErrorState.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,0BAA0B,0BAA0B,CAAA;AAEjE,MAAM,MAAM,oBAAoB,GAAG;IACjC,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB,CAAA;AAMD,eAAO,MAAM,sBAAsB,GAAI,OAAO,oBAAoB,KAAG,MAI/B,CAAA;AAEtC,eAAO,MAAM,uBAAuB,QAAO,oBAAoB,GAAG,IAUjE,CAAA;AAED,eAAO,MAAM,0BAA0B,QAAO,oBAAoB,GAAG,IASpE,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rpcbase/client",
-  "version": "0.290.0",
+  "version": "0.291.0",
   "type": "module",
   "files": [
     "dist"