@ethisyscore/plugin-ui 1.111.0 → 1.113.0

package/dist/platform-react/index.cjs

@@ -27,6 +27,7 @@ function _interopNamespace(e) {
   return Object.freeze(n);
 }
 
+var reactQuery__namespace = /*#__PURE__*/_interopNamespace(reactQuery);
 var extensionRuntime__namespace = /*#__PURE__*/_interopNamespace(extensionRuntime);
 
 // src/platform-react/definePlatformReactPluginPage.tsx
@@ -109,6 +110,39 @@ function createPluginQueryClient(config) {
     }
   });
 }
+
+// src/platform-react/hostQueryClient.ts
+var hostRealmExposesContext = isReactContext(reactQuery__namespace.QueryClientContext);
+var resolvedHostContext = hostRealmExposesContext ? reactQuery__namespace.QueryClientContext : react.createContext(void 0);
+function isReactContext(value) {
+  return typeof value === "object" && value !== null && "Provider" in value;
+}
+var bundleQueryClient;
+function pluginBundleQueryClient() {
+  bundleQueryClient ??= createPluginQueryClient();
+  return bundleQueryClient;
+}
+var warnedAboutMissingHostClient = false;
+function warnOnceAboutMissingHostClient() {
+  if (warnedAboutMissingHostClient) {
+    return;
+  }
+  warnedAboutMissingHostClient = true;
+  console.warn(
+    "[plugin-ui] The host realm provides no QueryClient" + (hostRealmExposesContext ? " (@tanstack/react-query is served, but this surface renders outside the host's QueryClientProvider)" : " (the host's @tanstack/react-query namespace has no QueryClientContext export)") + ". This surface falls back to a client of its own, so a mutation here will not invalidate another surface's cache. Deploy a host that mounts plugin surfaces inside its QueryClientProvider to share one cache."
+  );
+}
+function useSurfaceQueryClient(override) {
+  const hostQueryClient = react.useContext(resolvedHostContext);
+  if (override !== void 0) {
+    return override;
+  }
+  if (hostQueryClient !== void 0) {
+    return hostQueryClient;
+  }
+  warnOnceAboutMissingHostClient();
+  return pluginBundleQueryClient();
+}
 var TemplateContext = react.createContext(null);
 function injectPluginStyles(id, css) {
   if (typeof document === "undefined") return;
@@ -328,7 +362,6 @@ function useReportingCurrencySync() {
 }
 
 // src/platform-react/definePlatformReactPluginPage.tsx
-var defaultQueryClient = createPluginQueryClient();
 var EHX_PLUGIN_ROOT_CLASS = "ehx-plugin-root";
 function definePlatformReactPluginPage(Page, options) {
   const {
@@ -336,10 +369,11 @@ function definePlatformReactPluginPage(Page, options) {
     rootClassName,
     styleId,
     css,
-    queryClient = defaultQueryClient,
+    queryClient: queryClientOverride,
     wrapPage
   } = options;
   function PluginPage(props) {
+    const queryClient = useSurfaceQueryClient(queryClientOverride);
     useOrgFormatSync();
     useReportingCurrencySync();
     const page = react.createElement(Page, props);
@@ -819,18 +853,19 @@ function useOverlayHost() {
   }
   return api;
 }
-var defaultQueryClient2 = createPluginQueryClient();
 function definePlatformReactPluginOverlay(Overlay, options) {
-  const { rootClassName, styleId, css, manifest = {}, queryClient = defaultQueryClient2, wrapOverlay } = options;
+  const { rootClassName, styleId, css, manifest = {}, queryClient: queryClientOverride, wrapOverlay } = options;
   return function MountedOverlay(props) {
+    const queryClient = useSurfaceQueryClient(queryClientOverride);
     useOrgFormatSync();
     useReportingCurrencySync();
     const tree = react.createElement(
       OverlayHostContext.Provider,
       { value: props.overlayHost },
-      // react-query provider — an overlay bundle has its own react-query module
-      // instance, so the host's app-wide client is invisible across the bundle
-      // boundary; it needs its own provider exactly as each page gets one.
+      // react-query provider. Normally re-providing the host's own client, which
+      // is a no-op for the subtree and deliberate: the tree shape stays identical
+      // whichever client `useSurfaceQueryClient` returned, so the fallback path is
+      // not a second code path through the renderer.
       react.createElement(
         reactQuery.QueryClientProvider,
         { client: queryClient },
@@ -1289,6 +1324,7 @@ exports.useOrgFormatSync = useOrgFormatSync;
 exports.useOverlayHost = useOverlayHost;
 exports.usePluginRealtime = usePluginRealtime;
 exports.useReportingCurrencySync = useReportingCurrencySync;
+exports.useSurfaceQueryClient = useSurfaceQueryClient;
 exports.useSurfaceUrl = useSurfaceUrl;
 exports.useToolInvoker = useToolInvoker;
 exports.useToolInvokerMap = useToolInvokerMap;