@gooddata/sdk-ui-pluggable-host 11.57.0-alpha.2 → 11.57.0-alpha.3

package/esm/components/HostErrorBoundary.d.ts

@@ -0,0 +1,45 @@
+import { Component, type ErrorInfo, type ReactNode } from "react";
+import { type ILocale } from "@gooddata/sdk-model";
+import "./Root.scss";
+/**
+ * Properties of {@link HostErrorBoundary}.
+ *
+ * @alpha
+ */
+export interface IHostErrorBoundaryProps {
+    /**
+     * Reports the caught error together with the React component stack it was thrown from.
+     */
+    onError?: (error: string, context: string) => void;
+    locale?: ILocale;
+    /**
+     * A caught error is cleared when this value changes, so the subtree gets a fresh
+     * mount attempt (e.g. on navigation) instead of showing the fallback forever.
+     */
+    resetKey?: string | number;
+    children: ReactNode;
+}
+/**
+ * State of {@link HostErrorBoundary}.
+ *
+ * @alpha
+ */
+export interface IHostErrorBoundaryState {
+    hasError: boolean;
+    resetKey?: string | number;
+}
+/**
+ * Last-resort boundary for errors escaping to the host application root. The host page is
+ * composed of nested React roots rendering into DOM owned by the topmost root, so without
+ * a boundary React unmounts the entire tree — header included — leaving a blank page.
+ *
+ * @alpha
+ */
+export declare class HostErrorBoundary extends Component<IHostErrorBoundaryProps, IHostErrorBoundaryState> {
+    state: IHostErrorBoundaryState;
+    static getDerivedStateFromError(): Partial<IHostErrorBoundaryState>;
+    static getDerivedStateFromProps(props: IHostErrorBoundaryProps, state: IHostErrorBoundaryState): Partial<IHostErrorBoundaryState> | null;
+    componentDidCatch(error: Error, info: ErrorInfo): void;
+    render(): ReactNode;
+}
+//# sourceMappingURL=HostErrorBoundary.d.ts.map

package/esm/components/HostErrorBoundary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HostErrorBoundary.d.ts","sourceRoot":"","sources":["../../src/components/HostErrorBoundary.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAIlE,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAMnD,OAAO,aAAa,CAAC;AAIrB;;;;GAIG;AACH,MAAM,WAAW,uBAAuB;IACpC;;OAEG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACnD,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3B,QAAQ,EAAE,SAAS,CAAC;CACvB;AAED;;;;GAIG;AACH,MAAM,WAAW,uBAAuB;IACpC,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAC9B;AAED;;;;;;GAMG;AACH,qBAAa,iBAAkB,SAAQ,SAAS,CAAC,uBAAuB,EAAE,uBAAuB,CAAC;IACrF,KAAK,EAAE,uBAAuB,CAAuB;IAE9D,MAAM,CAAC,wBAAwB,IAAI,OAAO,CAAC,uBAAuB,CAAC,CAElE;IAED,MAAM,CAAC,wBAAwB,CAC3B,KAAK,EAAE,uBAAuB,EAC9B,KAAK,EAAE,uBAAuB,GAC/B,OAAO,CAAC,uBAAuB,CAAC,GAAG,IAAI,CAKzC;IAEQ,iBAAiB,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,GAAG,IAAI,CAE9D;IAEQ,MAAM,IAAI,SAAS,CAkB3B;CACJ"}

package/esm/components/HostErrorBoundary.js

@@ -0,0 +1,39 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+// (C) 2026 GoodData Corporation
+import { Component } from "react";
+import { FormattedMessage } from "react-intl";
+import { DEFAULT_LANGUAGE } from "@gooddata/sdk-ui";
+import { bemFactory } from "@gooddata/sdk-ui-kit";
+import { HostIntlProvider } from "../ui/HostIntlProvider.js";
+import "./Root.scss";
+const { e } = bemFactory("gd-host-root");
+/**
+ * Last-resort boundary for errors escaping to the host application root. The host page is
+ * composed of nested React roots rendering into DOM owned by the topmost root, so without
+ * a boundary React unmounts the entire tree — header included — leaving a blank page.
+ *
+ * @alpha
+ */
+export class HostErrorBoundary extends Component {
+    state = { hasError: false };
+    static getDerivedStateFromError() {
+        return { hasError: true };
+    }
+    static getDerivedStateFromProps(props, state) {
+        if (props.resetKey !== state.resetKey) {
+            return { resetKey: props.resetKey, hasError: false };
+        }
+        return null;
+    }
+    componentDidCatch(error, info) {
+        this.props.onError?.(String(error), info.componentStack ?? "");
+    }
+    render() {
+        if (!this.state.hasError) {
+            return this.props.children;
+        }
+        // Exception details go to telemetry (onError) and the console only — rendering them
+        // could expose internal backend details in the UI.
+        return (_jsx(HostIntlProvider, { locale: this.props.locale ?? DEFAULT_LANGUAGE, children: _jsx("div", { className: e("error"), role: "alert", children: _jsx("h1", { children: _jsx(FormattedMessage, { id: "gs.host.error.somethingWentWrong" }) }) }) }));
+    }
+}

package/esm/components/HostUiContainer.d.ts

@@ -7,11 +7,12 @@ export interface IHostUiContainerProps {
     apps: PluggableApplicationRegistryItem[];
     pathname: string;
     routerNavigate: NavigateFunction;
+    onError?: (error: string, context: string) => void;
 }
 /**
  * Mounts the host UI module into a container div, then renders the active
  * pluggable application into the host's app slot. Handles all lifecycle
  * updates (context, apps, pathname) via the host mount handle.
  */
-export declare function HostUiContainer({ ctx, apps, pathname, routerNavigate }: IHostUiContainerProps): import("react/jsx-runtime").JSX.Element;
+export declare function HostUiContainer({ ctx, apps, pathname, routerNavigate, onError }: IHostUiContainerProps): import("react/jsx-runtime").JSX.Element;
 //# sourceMappingURL=HostUiContainer.d.ts.map

package/esm/components/HostUiContainer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"HostUiContainer.d.ts","sourceRoot":"","sources":["../../src/components/HostUiContainer.tsx"],"names":[],"mappings":"AAKA,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAErD,OAAO,EAA0B,KAAK,gCAAgC,EAAE,MAAM,qBAAqB,CAAC;AACpG,OAAO,EAGH,KAAK,gBAAgB,EAExB,MAAM,2CAA2C,CAAC;AAiBnD,OAAO,wBAAwB,CAAC;AAKhC,MAAM,WAAW,qBAAqB;IAClC,GAAG,EAAE,gBAAgB,CAAC;IACtB,IAAI,EAAE,gCAAgC,EAAE,CAAC;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,gBAAgB,CAAC;CACpC;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,cAAc,EAAE,EAAE,qBAAqB,2CAqT7F"}
+{"version":3,"file":"HostUiContainer.d.ts","sourceRoot":"","sources":["../../src/components/HostUiContainer.tsx"],"names":[],"mappings":"AAMA,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAErD,OAAO,EAA0B,KAAK,gCAAgC,EAAE,MAAM,qBAAqB,CAAC;AACpG,OAAO,EAGH,KAAK,gBAAgB,EAExB,MAAM,2CAA2C,CAAC;AAiBnD,OAAO,wBAAwB,CAAC;AAMhC,MAAM,WAAW,qBAAqB;IAClC,GAAG,EAAE,gBAAgB,CAAC;IACtB,IAAI,EAAE,gCAAgC,EAAE,CAAC;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,gBAAgB,CAAC;IACjC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACtD;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,cAAc,EAAE,OAAO,EAAE,EAAE,qBAAqB,2CA0VtG"}

package/esm/components/HostUiContainer.js

@@ -1,6 +1,7 @@
 import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 // (C) 2026 GoodData Corporation
 import { useCallback, useEffect, useMemo, useRef, useState } from "react";
+import { isEqual, omit } from "lodash-es";
 import { createRoot } from "react-dom/client";
 import { resolveLocale, useAutoupdateRef } from "@gooddata/sdk-ui";
 import { now } from "../debug.js";
@@ -12,19 +13,40 @@ import { HostIntlProvider } from "../ui/HostIntlProvider.js";
 import { PluggableApplicationRenderer } from "../ui/PluggableApplicationRenderer.js";
 import "./HostUiContainer.scss";
 import { resolveHostUiModule } from "../ui/resolveHostUiModule.js";
+import { HostErrorBoundary } from "./HostErrorBoundary.js";
 import { runGuardedNavigation } from "./navigationGuard.js";
 /**
  * Mounts the host UI module into a container div, then renders the active
  * pluggable application into the host's app slot. Handles all lifecycle
  * updates (context, apps, pathname) via the host mount handle.
  */
-export function HostUiContainer({ ctx, apps, pathname, routerNavigate }) {
+export function HostUiContainer({ ctx, apps, pathname, routerNavigate, onError }) {
     const activeInternalApplication = useMemo(() => getActiveInternalApplication(apps, ctx, pathname), [apps, ctx, pathname]);
     const containerRef = useRef(null);
     const handleRef = useRef(undefined);
     const appRootRef = useRef(undefined);
     const [hostReady, setHostReady] = useState(false);
     const latestMountStateRef = useAutoupdateRef({ ctx, apps, pathname });
+    const onErrorRef = useAutoupdateRef(onError);
+    const reportError = useCallback((error, context) => onErrorRef.current?.(error, context), [onErrorRef]);
+    // Mounted apps hot-apply only auth from updateContext — every other context field
+    // (permissions, settings, entitlements, org permissions, …) is seeded into their stores
+    // at mount only. A refresh that lands ANY content change outside auth must therefore
+    // remount the app. Content comparison, not identity: every refresh produces new objects,
+    // and remounting on each token refresh would defeat keeping the app mounted at all.
+    // The color palette is also excluded: its load is not part of the platform-context gate,
+    // so it legitimately arrives after the first ready context — a styling update, not a
+    // reason to abort the mounted app.
+    const [appContextEpoch, setAppContextEpoch] = useState(0);
+    const prevAppContextRef = useRef(ctx);
+    useEffect(() => {
+        const prev = prevAppContextRef.current;
+        prevAppContextRef.current = ctx;
+        const epochFields = (c) => omit(c, ["auth", "colorPalette"]);
+        if (prev !== ctx && !isEqual(epochFields(prev), epochFields(ctx))) {
+            setAppContextEpoch((epoch) => epoch + 1);
+        }
+    }, [ctx]);
     const [headerOptions, setHeaderOptions] = useState(undefined);
     const [pageTitle, setPageTitle] = useState(undefined);
     // Host-owned chat open-state, sourced from HostChat and forwarded to the active pluggable app.
@@ -124,6 +146,7 @@ export function HostUiContainer({ ctx, apps, pathname, routerNavigate }) {
                 replace: navigationMountRef.current.replace,
                 onChatToggleRequested: navigationMountRef.current.onChatToggleRequested,
                 onAskAiAssistant: navigationMountRef.current.onAskAiAssistant,
+                onError: reportError,
             });
             handleRef.current = handle;
             appRootRef.current = createRoot(handle.getAppContainer());
@@ -152,7 +175,7 @@ export function HostUiContainer({ ctx, apps, pathname, routerNavigate }) {
             });
         };
         // Mount only once; updates are pushed via handle
-    }, [latestMountStateRef, navigationMountRef]);
+    }, [latestMountStateRef, navigationMountRef, reportError]);
     // Push updates when context, apps, or pathname change after initial mount
     useEffect(() => {
         if (!hostReady) {
@@ -218,7 +241,7 @@ export function HostUiContainer({ ctx, apps, pathname, routerNavigate }) {
             return;
         }
         if (activeInternalApplication) {
-            appRootRef.current.render(_jsx(HostIntlProvider, { locale: resolveLocale(ctx.preferredLocale), children: _jsx(PluggableApplicationRenderer, { app: activeInternalApplication, ctx: ctx, pathname: pathname, aiAssistantOpen: aiAssistantOpen, onOpenAiAssistant: requestOpenAi, onCloseAiAssistant: requestCloseAi, onAiAssistantContext: setAiAssistantContext, aiLinkClickHandlerRef: appAiLinkClickRef, navigationRequestRef: appNavigationRequestRef, aiEventReceiveRef: appEventReceiveRef, onHeaderChange: onHeaderChange, onDocumentTitleChange: onDocumentTitleChange }, activeInternalApplication.id) }));
+            appRootRef.current.render(_jsx(HostErrorBoundary, { resetKey: pathname, onError: reportError, locale: resolveLocale(ctx.preferredLocale), children: _jsx(HostIntlProvider, { locale: resolveLocale(ctx.preferredLocale), children: _jsx(PluggableApplicationRenderer, { app: activeInternalApplication, ctx: ctx, pathname: pathname, aiAssistantOpen: aiAssistantOpen, onOpenAiAssistant: requestOpenAi, onCloseAiAssistant: requestCloseAi, onAiAssistantContext: setAiAssistantContext, aiLinkClickHandlerRef: appAiLinkClickRef, navigationRequestRef: appNavigationRequestRef, aiEventReceiveRef: appEventReceiveRef, onHeaderChange: onHeaderChange, onDocumentTitleChange: onDocumentTitleChange }, activeInternalApplication.id) }) }, `${activeInternalApplication.id}:${appContextEpoch}`));
         }
         else {
             appRootRef.current.render(null);
@@ -226,11 +249,13 @@ export function HostUiContainer({ ctx, apps, pathname, routerNavigate }) {
     }, [
         hostReady,
         activeInternalApplication,
+        appContextEpoch,
         ctx,
         onHeaderChange,
         onDocumentTitleChange,
         pathname,
         aiAssistantOpen,
+        reportError,
         requestOpenAi,
         requestCloseAi,
         setAiAssistantContext,

package/esm/components/Root.js

@@ -62,5 +62,5 @@ function ReadyRoot({ ctx, callbacks }) {
     if (redirect.state === "error") {
         return (_jsx(HostIntlProvider, { locale: resolveLocale(ctx.preferredLocale), children: _jsxs("main", { className: e("error"), children: [_jsx("h1", { children: _jsx(FormattedMessage, { id: "gs.host.error.somethingWentWrong" }) }), _jsx("p", { children: redirect.error })] }) }));
     }
-    return _jsx(HostUiContainer, { ctx: ctx, apps: apps, pathname: pathname, routerNavigate: routerNavigate });
+    return (_jsx(HostUiContainer, { ctx: ctx, apps: apps, pathname: pathname, routerNavigate: routerNavigate, onError: callbacks?.onError }));
 }

package/esm/index.d.ts

@@ -6,6 +6,7 @@ export { registerLocalApplications } from "./registry/pluggableApplicationsRegis
 export { registerAppLifecycleCallbacks } from "./loader/pluggableApplicationsLoader.js";
 export { mapLegacyUrlToHost, type ILegacyLocation } from "./loader/legacyRedirect.js";
 export { Root, type IRootCallbacks } from "./components/Root.js";
+export { HostErrorBoundary, type IHostErrorBoundaryProps, type IHostErrorBoundaryState, } from "./components/HostErrorBoundary.js";
 export { type IAppLifecycleCallbacks } from "./types/lifecycle.js";
 export { STALE_CHUNK_RELOAD_PARAM, installPreloadErrorHandler, installVersionWatcher, reloadForStaleChunks, setStaleChunkReloadListener, type IStaleChunkReloadInfo, type IVersionWatcherOptions, type StaleChunkReloadListener, } from "./lib/chunkReloadGuard.js";
 export { dispatchHostNotification } from "./lib/hostNotifications.js";

package/esm/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACjF,OAAO,EAAE,gCAAgC,EAAE,MAAM,6CAA6C,CAAC;AAC/F,OAAO,EAAE,KAAK,6BAA6B,EAAE,MAAM,0CAA0C,CAAC;AAE9F,OAAO,EACH,+BAA+B,EAC/B,KAAK,+BAA+B,GACvC,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,yBAAyB,EAAE,MAAM,6CAA6C,CAAC;AACxF,OAAO,EAAE,6BAA6B,EAAE,MAAM,yCAAyC,CAAC;AAExF,OAAO,EAAE,kBAAkB,EAAE,KAAK,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAEtF,OAAO,EAAE,IAAI,EAAE,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,EAAE,KAAK,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAEnE,OAAO,EACH,wBAAwB,EACxB,0BAA0B,EAC1B,qBAAqB,EACrB,oBAAoB,EACpB,2BAA2B,EAC3B,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,EAC3B,KAAK,wBAAwB,GAChC,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAEtE,OAAO,EACH,uBAAuB,EACvB,KAAK,uBAAuB,EAC5B,KAAK,kBAAkB,GAC1B,MAAM,8BAA8B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACjF,OAAO,EAAE,gCAAgC,EAAE,MAAM,6CAA6C,CAAC;AAC/F,OAAO,EAAE,KAAK,6BAA6B,EAAE,MAAM,0CAA0C,CAAC;AAE9F,OAAO,EACH,+BAA+B,EAC/B,KAAK,+BAA+B,GACvC,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,yBAAyB,EAAE,MAAM,6CAA6C,CAAC;AACxF,OAAO,EAAE,6BAA6B,EAAE,MAAM,yCAAyC,CAAC;AAExF,OAAO,EAAE,kBAAkB,EAAE,KAAK,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAEtF,OAAO,EAAE,IAAI,EAAE,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,EACH,iBAAiB,EACjB,KAAK,uBAAuB,EAC5B,KAAK,uBAAuB,GAC/B,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,KAAK,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAEnE,OAAO,EACH,wBAAwB,EACxB,0BAA0B,EAC1B,qBAAqB,EACrB,oBAAoB,EACpB,2BAA2B,EAC3B,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,EAC3B,KAAK,wBAAwB,GAChC,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAEtE,OAAO,EACH,uBAAuB,EACvB,KAAK,uBAAuB,EAC5B,KAAK,kBAAkB,GAC1B,MAAM,8BAA8B,CAAC"}

package/esm/index.js

@@ -6,6 +6,7 @@ export { registerLocalApplications } from "./registry/pluggableApplicationsRegis
 export { registerAppLifecycleCallbacks } from "./loader/pluggableApplicationsLoader.js";
 export { mapLegacyUrlToHost } from "./loader/legacyRedirect.js";
 export { Root } from "./components/Root.js";
+export { HostErrorBoundary, } from "./components/HostErrorBoundary.js";
 export { STALE_CHUNK_RELOAD_PARAM, installPreloadErrorHandler, installVersionWatcher, reloadForStaleChunks, setStaleChunkReloadListener, } from "./lib/chunkReloadGuard.js";
 export { dispatchHostNotification } from "./lib/hostNotifications.js";
 export { setHostPricingExtension, } from "./ui/useHostChromePricing.js";

package/esm/platformContext/loadPlatformContext.d.ts

@@ -15,15 +15,6 @@ export interface ILoadPlatformContextOptions {
     auth?: IAuthCredentials;
     callbacks?: ILoadPlatformContextCallbacks;
 }
-/**
- * This approach is not correct - the host app should only care about the first part of the URL,
- * and the module should only care about the second part.
- * Here we are crossing the boundaries, and the host app is checking the full URL.
- * The proper fix requires larger changes not only here, but in gdc-nas as well.
- * This is scheduled to happen with the gdc-reports module.
- *
- * @internal - exported for testing
- */
 export declare function detectExportMode(): boolean;
 export declare function loadPlatformContext(options?: ILoadPlatformContextOptions): Promise<IBackendPlatformContext>;
 //# sourceMappingURL=loadPlatformContext.d.ts.map

package/esm/platformContext/loadPlatformContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loadPlatformContext.d.ts","sourceRoot":"","sources":["../../src/platformContext/loadPlatformContext.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,2CAA2C,CAAC;AAMlF,OAAO,EAAE,KAAK,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAE1D,qBAAa,4BAA6B,SAAQ,KAAK;IACnD,cAGC;CACJ;AAED;;GAEG;AACH,MAAM,WAAW,6BAA6B;IAC1C,gBAAgB,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5D,QAAQ,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;CAC3C;AAED,MAAM,WAAW,2BAA2B;IACxC,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,IAAI,CAAC,EAAE,gBAAgB,CAAC;IACxB,SAAS,CAAC,EAAE,6BAA6B,CAAC;CAC7C;AAQD;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,IAAI,OAAO,CAgB1C;AAED,wBAAsB,mBAAmB,CACrC,OAAO,GAAE,2BAAgC,GAC1C,OAAO,CAAC,uBAAuB,CAAC,CA4ClC"}
+{"version":3,"file":"loadPlatformContext.d.ts","sourceRoot":"","sources":["../../src/platformContext/loadPlatformContext.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,2CAA2C,CAAC;AAMlF,OAAO,EAAE,KAAK,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAE1D,qBAAa,4BAA6B,SAAQ,KAAK;IACnD,cAGC;CACJ;AAED;;GAEG;AACH,MAAM,WAAW,6BAA6B;IAC1C,gBAAgB,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5D,QAAQ,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;CAC3C;AAED,MAAM,WAAW,2BAA2B;IACxC,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,IAAI,CAAC,EAAE,gBAAgB,CAAC;IACxB,SAAS,CAAC,EAAE,6BAA6B,CAAC;CAC7C;AAqBD,wBAAgB,gBAAgB,IAAI,OAAO,CAkB1C;AAED,wBAAsB,mBAAmB,CACrC,OAAO,GAAE,2BAAgC,GAC1C,OAAO,CAAC,uBAAuB,CAAC,CA4ClC"}

package/esm/platformContext/loadPlatformContext.js

@@ -22,19 +22,24 @@ function throwIfAborted(signal) {
  *
  * @internal - exported for testing
  */
+// Dashboards name their export render mode `export`, reports `export_slideshow`; both are what the
+// backend exporter opens.
+const EXPORT_MODE_VALUES = new Set(["export", "export_slideshow"]);
 export function detectExportMode() {
     if (typeof window === "undefined") {
         return false;
     }
-    const hash = window.location.hash;
-    const query = hash.indexOf("?");
-    if (query === -1) {
-        return false;
-    }
-    for (const [key, value] of new URLSearchParams(hash.slice(query + 1))) {
-        const name = key.toLowerCase();
-        if ((name === "mode" || name === "displaymode") && value.toLowerCase() === "export") {
-            return true;
+    // A hash-routed app carries its query inside the fragment; a browser-routed one in the search
+    // string. Either may name an export mode.
+    const { search, hash } = window.location;
+    const hashQuery = hash.indexOf("?");
+    const queries = [search ?? "", hashQuery === -1 ? "" : hash.slice(hashQuery + 1)];
+    for (const query of queries) {
+        for (const [key, value] of new URLSearchParams(query)) {
+            const name = key.toLowerCase();
+            if ((name === "mode" || name === "displaymode") && EXPORT_MODE_VALUES.has(value.toLowerCase())) {
+                return true;
+            }
         }
     }
     return false;

package/esm/platformContext/useLoadPlatformContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useLoadPlatformContext.d.ts","sourceRoot":"","sources":["../../src/platformContext/useLoadPlatformContext.ts"],"names":[],"mappings":"AAOA,OAAO,EAA2B,KAAK,gBAAgB,EAAE,MAAM,2CAA2C,CAAC;AAM3G,OAAO,EACH,KAAK,6BAA6B,EAGrC,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACH,KAAK,uBAAuB,EAC5B,KAAK,0BAA0B,EAElC,MAAM,YAAY,CAAC;AAYpB;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,IAAI,0BAA0B,CAAC,gBAAgB,CAAC,CA+ErF;AAED;;;;GAIG;AACH,MAAM,WAAW,+BAA+B;IAC5C,YAAY,CAAC,SAAS,EAAE,6BAA6B,GAAG,IAAI,CAAC;IAC7D,SAAS,EAAE,MAAM,QAAQ,CAAC,0BAA0B,CAAC,uBAAuB,CAAC,CAAC,CAAC;IAC/E,SAAS,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,MAAM,IAAI,CAAC;IAChD,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7B;AAmED;;GAEG;AACH,eAAO,MAAM,8BAA8B,EAAE,+BACA,CAAC;AAE9C;;;;;;GAMG;AACH,wBAAgB,gCAAgC,CAAC,SAAS,EAAE,6BAA6B,GAAG,IAAI,CAE/F"}
+{"version":3,"file":"useLoadPlatformContext.d.ts","sourceRoot":"","sources":["../../src/platformContext/useLoadPlatformContext.ts"],"names":[],"mappings":"AAOA,OAAO,EAA2B,KAAK,gBAAgB,EAAE,MAAM,2CAA2C,CAAC;AAM3G,OAAO,EACH,KAAK,6BAA6B,EAGrC,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACH,KAAK,uBAAuB,EAC5B,KAAK,0BAA0B,EAElC,MAAM,YAAY,CAAC;AAYpB;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,IAAI,0BAA0B,CAAC,gBAAgB,CAAC,CAoJrF;AAED;;;;GAIG;AACH,MAAM,WAAW,+BAA+B;IAC5C,YAAY,CAAC,SAAS,EAAE,6BAA6B,GAAG,IAAI,CAAC;IAC7D,SAAS,EAAE,MAAM,QAAQ,CAAC,0BAA0B,CAAC,uBAAuB,CAAC,CAAC,CAAC;IAC/E,SAAS,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,MAAM,IAAI,CAAC;IAChD,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7B;AAmED;;GAEG;AACH,eAAO,MAAM,8BAA8B,EAAE,+BACA,CAAC;AAE9C;;;;;;GAMG;AACH,wBAAgB,gCAAgC,CAAC,SAAS,EAAE,6BAA6B,GAAG,IAAI,CAE/F"}

package/esm/platformContext/useLoadPlatformContext.js

@@ -1,5 +1,5 @@
 // (C) 2026 GoodData Corporation
-import { useMemo, useSyncExternalStore } from "react";
+import { useEffect, useMemo, useState, useSyncExternalStore } from "react";
 import { useLocation } from "react-router";
 import { isLocale } from "@gooddata/sdk-model";
 import { isProduction } from "../lib/isProduction.js";
@@ -33,7 +33,8 @@ export function useLoadPlatformContext() {
     const workspaceSettingsState = useWorkspaceSettings(backend, workspaceId);
     const workspaceColorPaletteState = useWorkspaceColorPalette(backend, workspaceId);
     const workspaceThemeState = useWorkspaceTheme(backend, workspaceId);
-    return useMemo(() => {
+    const [lastReady, setLastReady] = useState(undefined);
+    const result = useMemo(() => {
         if (backendContext.state !== "ready") {
             return backendContext;
         }
@@ -83,6 +84,57 @@ export function useLoadPlatformContext() {
         workspaceColorPaletteState,
         workspaceThemeState,
     ]);
+    // Remember the last COMMITTED result in state (an effect never runs for a discarded
+    // render, so an abandoned concurrent render cannot leak its context into the fallback).
+    useEffect(() => {
+        if (result.state === "ready") {
+            setLastReady({ workspaceId, result });
+        }
+        else if (result.state === "error") {
+            setLastReady(undefined);
+        }
+    }, [result, workspaceId]);
+    // Fallback served while the same workspace's data refreshes: the previous workspace-scoped
+    // values merged over the CURRENT backend context, so a refreshed auth reaches the mounted
+    // app immediately instead of waiting for every workspace request to finish.
+    const refreshingFallback = useMemo(() => {
+        if (backendContext.state !== "ready" ||
+            lastReady === undefined ||
+            lastReady.workspaceId !== workspaceId ||
+            lastReady.result.state !== "ready" ||
+            // A different principal or organization must never see the previous principal's
+            // permissions/settings, even for the duration of the refresh — fall through to
+            // the loader instead of merging across principals.
+            lastReady.result.ctx.user?.login !== backendContext.ctx.user?.login ||
+            lastReady.result.ctx.organization?.id !== backendContext.ctx.organization?.id) {
+            return undefined;
+        }
+        const { currentApplicationScope, currentWorkspaceId, workspacePermissions, workspaceSettings, colorPalette, settings, preferredLocale, theme, } = lastReady.result.ctx;
+        return {
+            state: "ready",
+            ctx: {
+                ...backendContext.ctx,
+                currentApplicationScope,
+                currentWorkspaceId,
+                workspacePermissions,
+                workspaceSettings,
+                colorPalette,
+                settings,
+                preferredLocale,
+                theme,
+            },
+        };
+    }, [backendContext, lastReady, workspaceId]);
+    // Keep the previously rendered context while the same workspace's data refreshes (backend
+    // re-creation after a token refresh, reload-platform-context requests). Returning "loading"
+    // here would swap the whole HostUiContainer for a loader, unmounting the mounted app and
+    // cancelling its in-flight work; the refreshed context is pushed via handle.updateContext
+    // instead. A workspace change must NOT reuse the old context (permissions/theme belong to
+    // the previous workspace), so it still falls through to the loader.
+    if (result.state === "loading" && refreshingFallback !== undefined) {
+        return refreshingFallback;
+    }
+    return result;
 }
 class BackendPlatformContextProviderClass {
     _loadingStateMemo = { state: "loading" };

package/esm/sdk-ui-pluggable-host.d.ts

@@ -1,5 +1,8 @@
+import { Component } from 'react';
+import { ErrorInfo } from 'react';
 import { IAnalyticalBackend } from '@gooddata/sdk-backend-spi';
 import { IHostUiNotification } from '@gooddata/sdk-pluggable-application-model';
+import { ILocale } from '@gooddata/sdk-model';
 import { IPlatformContext } from '@gooddata/sdk-pluggable-application-model';
 import { IPluggableApp } from '@gooddata/sdk-pluggable-application-model';
 import { IPluggableAppTelemetryCallbacks } from '@gooddata/sdk-pluggable-application-model';
@@ -24,6 +27,21 @@ export declare function dispatchHostNotification(notification: IHostUiNotificati
  */
 export declare function getBackend(): IAnalyticalBackend;
 
+/**
+ * Last-resort boundary for errors escaping to the host application root. The host page is
+ * composed of nested React roots rendering into DOM owned by the topmost root, so without
+ * a boundary React unmounts the entire tree — header included — leaving a blank page.
+ *
+ * @alpha
+ */
+export declare class HostErrorBoundary extends Component<IHostErrorBoundaryProps, IHostErrorBoundaryState> {
+    state: IHostErrorBoundaryState;
+    static getDerivedStateFromError(): Partial<IHostErrorBoundaryState>;
+    static getDerivedStateFromProps(props: IHostErrorBoundaryProps, state: IHostErrorBoundaryState): Partial<IHostErrorBoundaryState> | null;
+    componentDidCatch(error: Error, info: ErrorInfo): void;
+    render(): ReactNode;
+}
+
 /**
  * @alpha
  */
@@ -60,6 +78,35 @@ export declare interface IHostChromePricing {
     onUpsellButtonClick: () => void;
 }
 
+/**
+ * Properties of {@link HostErrorBoundary}.
+ *
+ * @alpha
+ */
+export declare interface IHostErrorBoundaryProps {
+    /**
+     * Reports the caught error together with the React component stack it was thrown from.
+     */
+    onError?: (error: string, context: string) => void;
+    locale?: ILocale;
+    /**
+     * A caught error is cleared when this value changes, so the subtree gets a fresh
+     * mount attempt (e.g. on navigation) instead of showing the fallback forever.
+     */
+    resetKey?: string | number;
+    children: ReactNode;
+}
+
+/**
+ * State of {@link HostErrorBoundary}.
+ *
+ * @alpha
+ */
+export declare interface IHostErrorBoundaryState {
+    hasError: boolean;
+    resetKey?: string | number;
+}
+
 /**
  * @alpha
  */

package/esm/ui/DefaultHostUi.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DefaultHostUi.d.ts","sourceRoot":"","sources":["../../src/ui/DefaultHostUi.tsx"],"names":[],"mappings":"AAQA,OAAO,EAEH,KAAK,aAAa,EAKrB,MAAM,2CAA2C,CAAC;AAInD,OAAO,sBAAsB,CAAC;AAkN9B;;;;;;;;GAQG;AACH,eAAO,MAAM,mBAAmB,EAAE,aAEjC,CAAC"}
+{"version":3,"file":"DefaultHostUi.d.ts","sourceRoot":"","sources":["../../src/ui/DefaultHostUi.tsx"],"names":[],"mappings":"AAQA,OAAO,EAEH,KAAK,aAAa,EAKrB,MAAM,2CAA2C,CAAC;AAOnD,OAAO,sBAAsB,CAAC;AA+N9B;;;;;;;;GAQG;AACH,eAAO,MAAM,mBAAmB,EAAE,aAEjC,CAAC"}

package/esm/ui/DefaultHostUi.js

@@ -3,10 +3,12 @@ import { jsx as _jsx } from "react/jsx-runtime";
 import { useLayoutEffect, useRef, useState } from "react";
 import { flushSync } from "react-dom";
 import { createRoot } from "react-dom/client";
+import { resolveLocale } from "@gooddata/sdk-ui";
+import { HostErrorBoundary } from "../components/HostErrorBoundary.js";
 import { HostChrome } from "./HostChrome.js";
 import { e } from "./hostChromeBem.js";
 import "./DefaultHostUi.scss";
-function HostUiBridge({ initialCtx, initialApps, initialPathname, navigate, replace, onChatToggleRequested, onAskAiAssistant, onAppContainerReady, onReady, }) {
+function HostUiBridge({ initialCtx, initialApps, initialPathname, navigate, replace, onChatToggleRequested, onAskAiAssistant, onError, onAppContainerReady, onReady, }) {
     const [ctx, setCtx] = useState(initialCtx);
     const [apps, setApps] = useState(initialApps);
     const [pathname, setPathname] = useState(initialPathname);
@@ -26,13 +28,13 @@ function HostUiBridge({ initialCtx, initialApps, initialPathname, navigate, repl
         // Only call once on mount
         // eslint-disable-next-line react-hooks/exhaustive-deps
     }, []);
-    return (_jsx(HostChrome, { ctx: ctx, resolvedApplications: apps, pathname: pathname, onNavigate: navigate, onReplace: replace, headerOptions: headerOptions, notification: notification, showChatItem: chatState.showChatItem, chatIsOpen: chatState.isOpen, onChatToggle: onChatToggleRequested, onAskAiAssistant: onAskAiAssistant, appPageTitle: pageTitle, children: _jsx("div", { ref: appContainerRef, className: e("app-container") }) }));
+    return (_jsx(HostErrorBoundary, { onError: onError, locale: resolveLocale(ctx.preferredLocale), children: _jsx(HostChrome, { ctx: ctx, resolvedApplications: apps, pathname: pathname, onNavigate: navigate, onReplace: replace, headerOptions: headerOptions, notification: notification, showChatItem: chatState.showChatItem, chatIsOpen: chatState.isOpen, onChatToggle: onChatToggleRequested, onAskAiAssistant: onAskAiAssistant, appPageTitle: pageTitle, children: _jsx("div", { ref: appContainerRef, className: e("app-container") }) }) }));
 }
 // ---------------------------------------------------------------------------
 // Imperative mount function conforming to IHostUiModule
 // ---------------------------------------------------------------------------
 function mountDefaultHostUi(options) {
-    const { container, ctx, resolvedApplications, pathname, navigate, replace, onChatToggleRequested, onAskAiAssistant, } = options;
+    const { container, ctx, resolvedApplications, pathname, navigate, replace, onChatToggleRequested, onAskAiAssistant, onError, } = options;
     let reactRoot = createRoot(container);
     let appContainer = null;
     let updateCtxFn = null;
@@ -45,17 +47,17 @@ function mountDefaultHostUi(options) {
     // Use flushSync so that the DOM is ready synchronously after mount() returns,
     // making getAppContainer() safe to call immediately.
     flushSync(() => {
-        reactRoot?.render(_jsx(HostUiBridge, { initialCtx: ctx, initialApps: resolvedApplications, initialPathname: pathname, navigate: navigate, replace: replace, onChatToggleRequested: onChatToggleRequested, onAskAiAssistant: onAskAiAssistant, onAppContainerReady: (el) => {
-                appContainer = el;
-            }, onReady: (setCtx, setApps, setPathname, setHeaderOptions, setNotification, setPageTitle, setChatState) => {
-                updateCtxFn = setCtx;
-                updateAppsFn = setApps;
-                updatePathnameFn = setPathname;
-                updateHeaderFn = setHeaderOptions;
-                updateNotificationFn = setNotification;
-                updateDocumentTitleFn = setPageTitle;
-                updateChatStateFn = setChatState;
-            } }));
+        reactRoot?.render(_jsx(HostErrorBoundary, { onError: onError, locale: resolveLocale(ctx.preferredLocale), children: _jsx(HostUiBridge, { initialCtx: ctx, initialApps: resolvedApplications, initialPathname: pathname, navigate: navigate, replace: replace, onChatToggleRequested: onChatToggleRequested, onAskAiAssistant: onAskAiAssistant, onError: onError, onAppContainerReady: (el) => {
+                    appContainer = el;
+                }, onReady: (setCtx, setApps, setPathname, setHeaderOptions, setNotification, setPageTitle, setChatState) => {
+                    updateCtxFn = setCtx;
+                    updateAppsFn = setApps;
+                    updatePathnameFn = setPathname;
+                    updateHeaderFn = setHeaderOptions;
+                    updateNotificationFn = setNotification;
+                    updateDocumentTitleFn = setPageTitle;
+                    updateChatStateFn = setChatState;
+                } }) }));
     });
     return {
         unmount() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gooddata/sdk-ui-pluggable-host",
-  "version": "11.57.0-alpha.2",
+  "version": "11.57.0-alpha.3",
   "description": "GoodData SDK runtime for hosting pluggable applications — registry, loader, routing, platform context, default UI chrome",
   "license": "MIT",
   "author": "GoodData Corporation",
@@ -29,20 +29,20 @@
   "dependencies": {
     "@module-federation/runtime": "2.6.0",
     "lodash-es": "^4.17.23",
-    "@gooddata/sdk-backend-spi": "11.57.0-alpha.2",
-    "@gooddata/sdk-backend-tiger": "11.57.0-alpha.2",
-    "@gooddata/sdk-backend-base": "11.57.0-alpha.2",
-    "@gooddata/sdk-embedding": "11.57.0-alpha.2",
-    "@gooddata/sdk-model": "11.57.0-alpha.2",
-    "@gooddata/sdk-pluggable-application-model": "11.57.0-alpha.2",
-    "@gooddata/sdk-ui-application-header": "11.57.0-alpha.2",
-    "@gooddata/sdk-ui-gen-ai": "11.57.0-alpha.2",
-    "@gooddata/sdk-ui-ext": "11.57.0-alpha.2",
-    "@gooddata/sdk-ui": "11.57.0-alpha.2",
-    "@gooddata/sdk-ui-kit": "11.57.0-alpha.2",
-    "@gooddata/sdk-ui-semantic-search": "11.57.0-alpha.2",
-    "@gooddata/util": "11.57.0-alpha.2",
-    "@gooddata/sdk-ui-theme-provider": "11.57.0-alpha.2"
+    "@gooddata/sdk-backend-base": "11.57.0-alpha.3",
+    "@gooddata/sdk-model": "11.57.0-alpha.3",
+    "@gooddata/sdk-embedding": "11.57.0-alpha.3",
+    "@gooddata/sdk-pluggable-application-model": "11.57.0-alpha.3",
+    "@gooddata/sdk-backend-tiger": "11.57.0-alpha.3",
+    "@gooddata/sdk-ui": "11.57.0-alpha.3",
+    "@gooddata/sdk-backend-spi": "11.57.0-alpha.3",
+    "@gooddata/sdk-ui-ext": "11.57.0-alpha.3",
+    "@gooddata/sdk-ui-application-header": "11.57.0-alpha.3",
+    "@gooddata/sdk-ui-gen-ai": "11.57.0-alpha.3",
+    "@gooddata/sdk-ui-theme-provider": "11.57.0-alpha.3",
+    "@gooddata/util": "11.57.0-alpha.3",
+    "@gooddata/sdk-ui-semantic-search": "11.57.0-alpha.3",
+    "@gooddata/sdk-ui-kit": "11.57.0-alpha.3"
   },
   "devDependencies": {
     "@microsoft/api-documenter": "7.30.10",
@@ -68,9 +68,9 @@
     "jiti": "2.6.1",
     "npm-run-all": "4.1.5",
     "oxfmt": "0.66.0",
-    "oxlint": "1.66.0",
+    "oxlint": "1.67.0",
     "oxlint-plugin-eslint": "1.82.0",
-    "oxlint-tsgolint": "0.18.1",
+    "oxlint-tsgolint": "0.22.1",
     "react": "19.1.1",
     "react-dom": "19.1.1",
     "react-intl": "10.1.25",
@@ -82,8 +82,8 @@
     "vite": "8.0.16",
     "vitest": "4.1.8",
     "vitest-dom": "0.1.1",
-    "@gooddata/eslint-config": "11.57.0-alpha.2",
-    "@gooddata/oxlint-config": "11.57.0-alpha.2"
+    "@gooddata/eslint-config": "11.57.0-alpha.3",
+    "@gooddata/oxlint-config": "11.57.0-alpha.3"
   },
   "peerDependencies": {
     "react": ">=18.3.1",