@trackunit/react-core-contexts 1.30.3 → 1.30.5-alpha-d37885bfce4.0

package/index.cjs.js

@@ -2,13 +2,13 @@
 
 var jsxRuntime = require('react/jsx-runtime');
 var client = require('@apollo/client');
+var reactCoreHooks = require('@trackunit/react-core-hooks');
+var react = require('react');
 var context = require('@apollo/client/link/context');
 var removeTypename = require('@apollo/client/link/remove-typename');
 var utilities = require('@apollo/client/utilities');
-var reactCoreHooks = require('@trackunit/react-core-hooks');
 var graphql = require('graphql');
 var graphqlSse = require('graphql-sse');
-var react = require('react');
 var error = require('@apollo/client/link/error');
 var irisAppRuntimeCore = require('@trackunit/iris-app-runtime-core');
 var reactCoreContextsApi = require('@trackunit/react-core-contexts-api');
@@ -19,7 +19,7 @@ var irisAppRuntimeCoreApi = require('@trackunit/iris-app-runtime-core-api');
 /**
  * This error link is used to capture error information, i. e. traceId, graphQL errors, network errors, etc.
  */
-const createErrorLink = ({ errorHandler, token, }) => {
+const createErrorLink = ({ errorHandler, getToken, }) => {
     return error.onError(({ graphQLErrors, networkError, operation, forward }) => {
         if (networkError) {
             // We skip the error logging if the error is an AbortError
@@ -67,7 +67,7 @@ const createErrorLink = ({ errorHandler, token, }) => {
                     x.message.includes("Invalid token specified") ||
                     x.message.includes("Access denied! You need to be authorized to perform this action!"));
             });
-            if (invalidToken && token) {
+            if (invalidToken && getToken()) {
                 errorHandler.captureException(new Error(JSON.stringify({
                     category: "GraphQL",
                     info: "GraphQL Error - invalidToken",
@@ -103,6 +103,69 @@ const createErrorLink = ({ errorHandler, token, }) => {
     });
 };
 
+/**
+ * Wraps an SSE subscription link and provides the same error monitoring as the
+ * HTTP error link — capturing GraphQL errors, traceIds, FORCE_RELOAD_BROWSER,
+ * and UNAUTHENTICATED codes — for long-lived subscription Observables.
+ */
+const createSubscriptionErrorLink = ({ errorHandler, getToken, }) => {
+    return new client.ApolloLink((operation, forward) => {
+        return new client.Observable(observer => {
+            const subscription = forward(operation).subscribe({
+                next: response => {
+                    const { errors } = response;
+                    if (errors) {
+                        const code = errors[0]?.extensions?.code;
+                        if (code === "FORCE_RELOAD_BROWSER") {
+                            window.location.reload();
+                        }
+                        const traceIds = [];
+                        errors.forEach(error => {
+                            if ("extensions" in error && error.extensions && typeof error.extensions.traceId === "string") {
+                                traceIds.push(error.extensions.traceId);
+                            }
+                        });
+                        if (traceIds.length) {
+                            errorHandler.setTag("traceIds", traceIds.join(", "));
+                        }
+                        errorHandler.addBreadcrumb({
+                            category: "GraphQL",
+                            message: "GraphQL Subscription Error",
+                            level: "error",
+                            data: { log: JSON.stringify(errors) },
+                        });
+                        const invalidToken = errors.some(x => x.extensions?.code === "UNAUTHENTICATED" ||
+                            x.message.includes("Invalid token specified") ||
+                            x.message.includes("Access denied! You need to be authorized to perform this action!"));
+                        if (invalidToken && getToken()) {
+                            errorHandler.captureException(new Error(JSON.stringify({
+                                category: "GraphQL",
+                                info: "GraphQL Subscription Error - invalidToken",
+                                level: "warning",
+                                data: { log: JSON.stringify(errors) },
+                            })), { level: "warning", fingerprint: ["GraphQL Subscription Error - invalidToken"] });
+                        }
+                    }
+                    observer.next(response);
+                },
+                error: err => {
+                    // eslint-disable-next-line no-console
+                    console.error(err);
+                    errorHandler.addBreadcrumb({
+                        category: "GraphQL",
+                        message: "GraphQL Subscription Network Error",
+                        level: "error",
+                        data: { log: String(err) },
+                    });
+                    observer.error(err);
+                },
+                complete: () => observer.complete(),
+            });
+            return () => subscription.unsubscribe();
+        });
+    });
+};
+
 // Use a widened `string` key so TypeScript picks the `unknown` overload of
 // `Reflect.get` instead of the typed one — otherwise reads like `module`
 // resolve to `NodeModule` from @types/node.
@@ -170,11 +233,12 @@ const isInternalGqlContext = () => {
     return Reflect.get(globalThis, "gql") === "internal";
 };
 
-const createApolloClient = ({ graphqlPublicUrl, graphqlInternalUrl, graphqlReportUrl, isDev, tracingHeaders, firstToken, errorHandler, }) => {
-    let token;
-    if (!token) {
-        token = firstToken;
-    }
+/**
+ * @internal
+ */
+const createApolloClient = ({ graphqlPublicUrl, graphqlInternalUrl, graphqlReportUrl, isDev, tracingHeaders: initialTracingHeaders, firstToken, errorHandler, }) => {
+    let token = firstToken;
+    let tracingHeaders = initialTracingHeaders;
     const publicGraphQLLink = client.createHttpLink({
         uri: request => graphqlPublicUrl + "/" + request.operationName,
     });
@@ -184,7 +248,7 @@ const createApolloClient = ({ graphqlPublicUrl, graphqlInternalUrl, graphqlRepor
     const reportGraphQLLink = client.createHttpLink({
         uri: request => graphqlReportUrl + "/" + request.operationName,
     });
-    const authLink = context.setContext(async (_, { headers: existingHeaders }) => {
+    const authLink = context.setContext((_, { headers: existingHeaders }) => {
         return {
             headers: {
                 ...existingHeaders,
@@ -192,7 +256,7 @@ const createApolloClient = ({ graphqlPublicUrl, graphqlInternalUrl, graphqlRepor
             },
         };
     });
-    const errorLink = createErrorLink({ errorHandler, token });
+    const errorLink = createErrorLink({ errorHandler, getToken: () => token });
     const defaultOptions = {
         watchQuery: {
             fetchPolicy: "no-cache",
@@ -209,10 +273,12 @@ const createApolloClient = ({ graphqlPublicUrl, graphqlInternalUrl, graphqlRepor
     };
     const removeTypenameLink = removeTypename.removeTypenameFromVariables();
     class SSELink extends client.ApolloLink {
+        /** @inheritdoc */
         constructor(options) {
             super();
             this.client = graphqlSse.createClient(options);
         }
+        /** @inheritdoc */
         request(operation) {
             return new utilities.Observable(sink => {
                 return this.client.subscribe({ ...operation, query: graphql.print(operation.query) }, {
@@ -228,12 +294,13 @@ const createApolloClient = ({ graphqlPublicUrl, graphqlInternalUrl, graphqlRepor
         headers: () => generateHeaders(token, tracingHeaders),
     });
     // Split links based on operation type
+    const subscriptionErrorLink = createSubscriptionErrorLink({ errorHandler, getToken: () => token });
     const splitLink = client.from([
         authLink,
         client.split(({ query }) => {
             const definition = utilities.getMainDefinition(query);
             return definition.kind === "OperationDefinition" && definition.operation === "subscription";
-        }, sseLink, client.from([
+        }, client.from([subscriptionErrorLink, sseLink]), client.from([
             errorLink,
             removeTypenameLink,
             client.split(operation => operation.getContext().clientName === "report", reportGraphQLLink, client.split(() => isInternalGqlContext(), internalGraphQLLink, publicGraphQLLink)),
@@ -261,8 +328,12 @@ const createApolloClient = ({ graphqlPublicUrl, graphqlInternalUrl, graphqlRepor
         getToken: () => {
             return token;
         },
+        setTracingHeaders: (newHeaders) => {
+            tracingHeaders = newHeaders;
+        },
     };
 };
+
 const useApolloClient = () => {
     const { graphqlPublicUrl, graphqlInternalUrl, graphqlReportUrl, environment, tracingHeaders } = reactCoreHooks.useEnvironment();
     const { token: currentToken } = reactCoreHooks.useToken();
@@ -281,11 +352,17 @@ const useApolloClient = () => {
             errorHandler,
         });
     });
-    react.useMemo(() => {
-        if (client.getToken() !== currentToken) {
-            client.setToken(currentToken);
-        }
-    }, [client, currentToken]);
+    // Synchronously propagate the token into the Apollo client closure during render
+    // so that child components' effects (useLayoutEffect / useEffect) always see the
+    // current token when they fire their first request in the same commit.
+    // React runs child effects before parent effects, so a parent useEffect here would
+    // be too late — child queries would go out with the previous token for one commit.
+    if (client.getToken() !== currentToken) {
+        client.setToken(currentToken);
+    }
+    react.useEffect(() => {
+        client.setTracingHeaders(tracingHeaders);
+    }, [client, tracingHeaders]);
     return client;
 };
 /**
@@ -352,16 +429,57 @@ const AnalyticsProviderIrisApp = ({ children }) => {
 };
 
 /**
- * Subscribe to methods initiated by changes in the host
+ * Subscribe to methods initiated by changes in the host.
+ *
+ * Handlers are registered on the singleton `host-runtime` penpal channel via
+ * {@link registerHostChangeHandler}, so push events from the host
+ * (`onTokenChanged`, `onTimeRangeChanged`, filter-bar updates, …) reach every
+ * mounted provider in the iris-app without forcing the host to open one
+ * penpal connection per subscription channel.
  *
- * @param methods STABLE object with the methods you'd want to subscribe to. Wrap in useMemo for instance to make it stable
+ * @param methods STABLE object with the methods you'd want to subscribe to.
+ *   Wrap in `useMemo` (or build with stable callback references) so the
+ *   effect doesn't re-register on every render.
+ * @param _channel Deprecated. Pre-v7 builds used a dedicated penpal channel
+ *   per subscription provider (e.g. `token-subscription`); v7 collapses all
+ *   subscriptions onto the singleton's `host-runtime` channel through a
+ *   handler registry. The argument is accepted for source-compatibility with
+ *   the v6 API and is ignored.
  */
-const useSubscribeToHostChanges = (methods) => {
+const useSubscribeToHostChanges = (methods, _channel) => {
     react.useEffect(() => {
-        const connection = irisAppRuntimeCore.setupHostConnector(methods);
-        return () => {
-            connection.destroy();
-        };
+        const unregisters = [];
+        // Listed explicitly (rather than via `Object.entries`) so each call to
+        // `registerHostChangeHandler<K>` keeps the K → handler-type connection,
+        // which a runtime iteration over keys would erase.
+        if (methods.onTokenChanged) {
+            unregisters.push(irisAppRuntimeCore.registerHostChangeHandler("onTokenChanged", methods.onTokenChanged));
+        }
+        if (methods.onTimeRangeChanged) {
+            unregisters.push(irisAppRuntimeCore.registerHostChangeHandler("onTimeRangeChanged", methods.onTimeRangeChanged));
+        }
+        if (methods.onFilterBarValuesChanged) {
+            unregisters.push(irisAppRuntimeCore.registerHostChangeHandler("onFilterBarValuesChanged", methods.onFilterBarValuesChanged));
+        }
+        if (methods.onAssetsFilterBarValuesChanged) {
+            unregisters.push(irisAppRuntimeCore.registerHostChangeHandler("onAssetsFilterBarValuesChanged", methods.onAssetsFilterBarValuesChanged));
+        }
+        if (methods.onCustomersFilterBarValuesChanged) {
+            unregisters.push(irisAppRuntimeCore.registerHostChangeHandler("onCustomersFilterBarValuesChanged", methods.onCustomersFilterBarValuesChanged));
+        }
+        if (methods.onSitesFilterBarValuesChanged) {
+            unregisters.push(irisAppRuntimeCore.registerHostChangeHandler("onSitesFilterBarValuesChanged", methods.onSitesFilterBarValuesChanged));
+        }
+        if (methods.onTablePersistenceStateChanged) {
+            unregisters.push(irisAppRuntimeCore.registerHostChangeHandler("onTablePersistenceStateChanged", methods.onTablePersistenceStateChanged));
+        }
+        if (methods.onAssetSortingStateChanged) {
+            unregisters.push(irisAppRuntimeCore.registerHostChangeHandler("onAssetSortingStateChanged", methods.onAssetSortingStateChanged));
+        }
+        if (methods.onWidgetPollIntervalChanged) {
+            unregisters.push(irisAppRuntimeCore.registerHostChangeHandler("onWidgetPollIntervalChanged", methods.onWidgetPollIntervalChanged));
+        }
+        return () => unregisters.forEach(unregister => unregister());
     }, [methods]);
 };
 
@@ -378,7 +496,7 @@ const AssetSortingProviderIrisApp = ({ children }) => {
     const methods = react.useMemo(() => ({
         onAssetSortingStateChanged: setAssetSortingState,
     }), [setAssetSortingState]);
-    useSubscribeToHostChanges(methods);
+    useSubscribeToHostChanges(methods, irisAppRuntimeCoreApi.Channels.AssetSortingSubscription);
     const contextValue = react.useMemo(() => ({
         sortingState: assetSortingState ?? {
             sortBy: irisAppRuntimeCoreApi.AssetSortByProperty.Criticality,
@@ -493,7 +611,7 @@ const FilterBarProviderIrisApp = ({ children }) => {
             setSitesFilterBarValues(values);
         },
     }), []);
-    useSubscribeToHostChanges(methods);
+    useSubscribeToHostChanges(methods, irisAppRuntimeCoreApi.Channels.FilterBarSubscription);
     const isLoading = react.useMemo(() => assetsFilterBarValues === undefined ||
         customersFilterBarValues === undefined ||
         sitesFilterBarValues === undefined, [assetsFilterBarValues, customersFilterBarValues, sitesFilterBarValues]);
@@ -596,7 +714,7 @@ const TimeRangeProviderIrisApp = ({ children }) => {
             }));
         },
     }), []);
-    useSubscribeToHostChanges(methods);
+    useSubscribeToHostChanges(methods, irisAppRuntimeCoreApi.Channels.TimeRangeSubscription);
     if (!timeRangeContext) {
         return null;
     }
@@ -634,7 +752,7 @@ const TokenProviderIrisApp = ({ children }) => {
     const methods = react.useMemo(() => ({
         onTokenChanged,
     }), [onTokenChanged]);
-    useSubscribeToHostChanges(methods);
+    useSubscribeToHostChanges(methods, irisAppRuntimeCoreApi.Channels.TokenSubscription);
     if (state.status === "error") {
         throw new Error("Token context is invalid");
     }
@@ -762,7 +880,7 @@ const WidgetConfigProviderIrisApp = ({ children }) => {
     const methods = react.useMemo(() => ({
         onWidgetPollIntervalChanged: setPollInterval,
     }), [setPollInterval]);
-    useSubscribeToHostChanges(methods);
+    useSubscribeToHostChanges(methods, irisAppRuntimeCoreApi.Channels.WidgetConfigSubscription);
     const widgetConfigContextValue = react.useMemo(() => ({
         getData: irisAppRuntimeCore.WidgetConfigRuntime.getWidgetData,
         setData: irisAppRuntimeCore.WidgetConfigRuntime.setWidgetData,

package/index.esm.js

@@ -1,23 +1,23 @@
 import { jsx, Fragment } from 'react/jsx-runtime';
-import { ApolloProvider, createHttpLink, from, split, ApolloClient, InMemoryCache, ApolloLink } from '@apollo/client';
+import { ApolloLink, Observable, createHttpLink, from, split, ApolloClient, InMemoryCache, ApolloProvider } from '@apollo/client';
+import { useEnvironment, useToken, useErrorHandler } from '@trackunit/react-core-hooks';
+import { useState, useEffect, useMemo, useCallback, useReducer, Suspense } from 'react';
 import { setContext } from '@apollo/client/link/context';
 import { removeTypenameFromVariables } from '@apollo/client/link/remove-typename';
-import { getMainDefinition, Observable } from '@apollo/client/utilities';
-import { useEnvironment, useToken, useErrorHandler } from '@trackunit/react-core-hooks';
+import { getMainDefinition, Observable as Observable$1 } from '@apollo/client/utilities';
 import { print } from 'graphql';
 import { createClient } from 'graphql-sse';
-import { useState, useMemo, useEffect, useCallback, useReducer, Suspense } from 'react';
 import { onError } from '@apollo/client/link/error';
-import { ToastRuntime, AnalyticsRuntime, setupHostConnector, AssetSortingRuntime, ConfirmationDialogRuntime, EnvironmentRuntime, ExportDataRuntime, AssetsFilterBarRuntime, CustomersFilterBarRuntime, SitesFilterBarRuntime, GeolocationRuntime, ModalDialogRuntime, NavigationRuntime, OemBrandingRuntime, ThemeCssRuntime, TimeRangeRuntime, TokenRuntime, CurrentUserRuntime, CurrentUserPreferenceRuntime, UserSubscriptionRuntime, WidgetConfigRuntime } from '@trackunit/iris-app-runtime-core';
+import { ToastRuntime, AnalyticsRuntime, registerHostChangeHandler, AssetSortingRuntime, ConfirmationDialogRuntime, EnvironmentRuntime, ExportDataRuntime, AssetsFilterBarRuntime, CustomersFilterBarRuntime, SitesFilterBarRuntime, GeolocationRuntime, ModalDialogRuntime, NavigationRuntime, OemBrandingRuntime, ThemeCssRuntime, TimeRangeRuntime, TokenRuntime, CurrentUserRuntime, CurrentUserPreferenceRuntime, UserSubscriptionRuntime, WidgetConfigRuntime } from '@trackunit/iris-app-runtime-core';
 import { ToastProvider, AnalyticsContextProvider, AssetSortingProvider, ConfirmationDialogProvider, EnvironmentContextProvider, ErrorHandlingContextProvider, ExportDataContext, FilterBarProvider, GeolocationProvider, ModalDialogContextProvider, NavigationContextProvider, OemBrandingContextProvider, TimeRangeProvider, TokenProvider, CurrentUserProvider, CurrentUserPreferenceProvider, UserSubscriptionProvider, WidgetConfigProvider } from '@trackunit/react-core-contexts-api';
 import { registerTranslations, initializeTranslationsForApp } from '@trackunit/i18n-library-translation';
 import { Spinner } from '@trackunit/react-components';
-import { SortOrder, AssetSortByProperty } from '@trackunit/iris-app-runtime-core-api';
+import { Channels, SortOrder, AssetSortByProperty } from '@trackunit/iris-app-runtime-core-api';
 
 /**
  * This error link is used to capture error information, i. e. traceId, graphQL errors, network errors, etc.
  */
-const createErrorLink = ({ errorHandler, token, }) => {
+const createErrorLink = ({ errorHandler, getToken, }) => {
     return onError(({ graphQLErrors, networkError, operation, forward }) => {
         if (networkError) {
             // We skip the error logging if the error is an AbortError
@@ -65,7 +65,7 @@ const createErrorLink = ({ errorHandler, token, }) => {
                     x.message.includes("Invalid token specified") ||
                     x.message.includes("Access denied! You need to be authorized to perform this action!"));
             });
-            if (invalidToken && token) {
+            if (invalidToken && getToken()) {
                 errorHandler.captureException(new Error(JSON.stringify({
                     category: "GraphQL",
                     info: "GraphQL Error - invalidToken",
@@ -101,6 +101,69 @@ const createErrorLink = ({ errorHandler, token, }) => {
     });
 };
 
+/**
+ * Wraps an SSE subscription link and provides the same error monitoring as the
+ * HTTP error link — capturing GraphQL errors, traceIds, FORCE_RELOAD_BROWSER,
+ * and UNAUTHENTICATED codes — for long-lived subscription Observables.
+ */
+const createSubscriptionErrorLink = ({ errorHandler, getToken, }) => {
+    return new ApolloLink((operation, forward) => {
+        return new Observable(observer => {
+            const subscription = forward(operation).subscribe({
+                next: response => {
+                    const { errors } = response;
+                    if (errors) {
+                        const code = errors[0]?.extensions?.code;
+                        if (code === "FORCE_RELOAD_BROWSER") {
+                            window.location.reload();
+                        }
+                        const traceIds = [];
+                        errors.forEach(error => {
+                            if ("extensions" in error && error.extensions && typeof error.extensions.traceId === "string") {
+                                traceIds.push(error.extensions.traceId);
+                            }
+                        });
+                        if (traceIds.length) {
+                            errorHandler.setTag("traceIds", traceIds.join(", "));
+                        }
+                        errorHandler.addBreadcrumb({
+                            category: "GraphQL",
+                            message: "GraphQL Subscription Error",
+                            level: "error",
+                            data: { log: JSON.stringify(errors) },
+                        });
+                        const invalidToken = errors.some(x => x.extensions?.code === "UNAUTHENTICATED" ||
+                            x.message.includes("Invalid token specified") ||
+                            x.message.includes("Access denied! You need to be authorized to perform this action!"));
+                        if (invalidToken && getToken()) {
+                            errorHandler.captureException(new Error(JSON.stringify({
+                                category: "GraphQL",
+                                info: "GraphQL Subscription Error - invalidToken",
+                                level: "warning",
+                                data: { log: JSON.stringify(errors) },
+                            })), { level: "warning", fingerprint: ["GraphQL Subscription Error - invalidToken"] });
+                        }
+                    }
+                    observer.next(response);
+                },
+                error: err => {
+                    // eslint-disable-next-line no-console
+                    console.error(err);
+                    errorHandler.addBreadcrumb({
+                        category: "GraphQL",
+                        message: "GraphQL Subscription Network Error",
+                        level: "error",
+                        data: { log: String(err) },
+                    });
+                    observer.error(err);
+                },
+                complete: () => observer.complete(),
+            });
+            return () => subscription.unsubscribe();
+        });
+    });
+};
+
 // Use a widened `string` key so TypeScript picks the `unknown` overload of
 // `Reflect.get` instead of the typed one — otherwise reads like `module`
 // resolve to `NodeModule` from @types/node.
@@ -168,11 +231,12 @@ const isInternalGqlContext = () => {
     return Reflect.get(globalThis, "gql") === "internal";
 };
 
-const createApolloClient = ({ graphqlPublicUrl, graphqlInternalUrl, graphqlReportUrl, isDev, tracingHeaders, firstToken, errorHandler, }) => {
-    let token;
-    if (!token) {
-        token = firstToken;
-    }
+/**
+ * @internal
+ */
+const createApolloClient = ({ graphqlPublicUrl, graphqlInternalUrl, graphqlReportUrl, isDev, tracingHeaders: initialTracingHeaders, firstToken, errorHandler, }) => {
+    let token = firstToken;
+    let tracingHeaders = initialTracingHeaders;
     const publicGraphQLLink = createHttpLink({
         uri: request => graphqlPublicUrl + "/" + request.operationName,
     });
@@ -182,7 +246,7 @@ const createApolloClient = ({ graphqlPublicUrl, graphqlInternalUrl, graphqlRepor
     const reportGraphQLLink = createHttpLink({
         uri: request => graphqlReportUrl + "/" + request.operationName,
     });
-    const authLink = setContext(async (_, { headers: existingHeaders }) => {
+    const authLink = setContext((_, { headers: existingHeaders }) => {
         return {
             headers: {
                 ...existingHeaders,
@@ -190,7 +254,7 @@ const createApolloClient = ({ graphqlPublicUrl, graphqlInternalUrl, graphqlRepor
             },
         };
     });
-    const errorLink = createErrorLink({ errorHandler, token });
+    const errorLink = createErrorLink({ errorHandler, getToken: () => token });
     const defaultOptions = {
         watchQuery: {
             fetchPolicy: "no-cache",
@@ -207,12 +271,14 @@ const createApolloClient = ({ graphqlPublicUrl, graphqlInternalUrl, graphqlRepor
     };
     const removeTypenameLink = removeTypenameFromVariables();
     class SSELink extends ApolloLink {
+        /** @inheritdoc */
         constructor(options) {
             super();
             this.client = createClient(options);
         }
+        /** @inheritdoc */
         request(operation) {
-            return new Observable(sink => {
+            return new Observable$1(sink => {
                 return this.client.subscribe({ ...operation, query: print(operation.query) }, {
                     next: value => sink.next(value),
                     complete: sink.complete.bind(sink),
@@ -226,12 +292,13 @@ const createApolloClient = ({ graphqlPublicUrl, graphqlInternalUrl, graphqlRepor
         headers: () => generateHeaders(token, tracingHeaders),
     });
     // Split links based on operation type
+    const subscriptionErrorLink = createSubscriptionErrorLink({ errorHandler, getToken: () => token });
     const splitLink = from([
         authLink,
         split(({ query }) => {
             const definition = getMainDefinition(query);
             return definition.kind === "OperationDefinition" && definition.operation === "subscription";
-        }, sseLink, from([
+        }, from([subscriptionErrorLink, sseLink]), from([
             errorLink,
             removeTypenameLink,
             split(operation => operation.getContext().clientName === "report", reportGraphQLLink, split(() => isInternalGqlContext(), internalGraphQLLink, publicGraphQLLink)),
@@ -259,8 +326,12 @@ const createApolloClient = ({ graphqlPublicUrl, graphqlInternalUrl, graphqlRepor
         getToken: () => {
             return token;
         },
+        setTracingHeaders: (newHeaders) => {
+            tracingHeaders = newHeaders;
+        },
     };
 };
+
 const useApolloClient = () => {
     const { graphqlPublicUrl, graphqlInternalUrl, graphqlReportUrl, environment, tracingHeaders } = useEnvironment();
     const { token: currentToken } = useToken();
@@ -279,11 +350,17 @@ const useApolloClient = () => {
             errorHandler,
         });
     });
-    useMemo(() => {
-        if (client.getToken() !== currentToken) {
-            client.setToken(currentToken);
-        }
-    }, [client, currentToken]);
+    // Synchronously propagate the token into the Apollo client closure during render
+    // so that child components' effects (useLayoutEffect / useEffect) always see the
+    // current token when they fire their first request in the same commit.
+    // React runs child effects before parent effects, so a parent useEffect here would
+    // be too late — child queries would go out with the previous token for one commit.
+    if (client.getToken() !== currentToken) {
+        client.setToken(currentToken);
+    }
+    useEffect(() => {
+        client.setTracingHeaders(tracingHeaders);
+    }, [client, tracingHeaders]);
     return client;
 };
 /**
@@ -350,16 +427,57 @@ const AnalyticsProviderIrisApp = ({ children }) => {
 };
 
 /**
- * Subscribe to methods initiated by changes in the host
+ * Subscribe to methods initiated by changes in the host.
+ *
+ * Handlers are registered on the singleton `host-runtime` penpal channel via
+ * {@link registerHostChangeHandler}, so push events from the host
+ * (`onTokenChanged`, `onTimeRangeChanged`, filter-bar updates, …) reach every
+ * mounted provider in the iris-app without forcing the host to open one
+ * penpal connection per subscription channel.
  *
- * @param methods STABLE object with the methods you'd want to subscribe to. Wrap in useMemo for instance to make it stable
+ * @param methods STABLE object with the methods you'd want to subscribe to.
+ *   Wrap in `useMemo` (or build with stable callback references) so the
+ *   effect doesn't re-register on every render.
+ * @param _channel Deprecated. Pre-v7 builds used a dedicated penpal channel
+ *   per subscription provider (e.g. `token-subscription`); v7 collapses all
+ *   subscriptions onto the singleton's `host-runtime` channel through a
+ *   handler registry. The argument is accepted for source-compatibility with
+ *   the v6 API and is ignored.
  */
-const useSubscribeToHostChanges = (methods) => {
+const useSubscribeToHostChanges = (methods, _channel) => {
     useEffect(() => {
-        const connection = setupHostConnector(methods);
-        return () => {
-            connection.destroy();
-        };
+        const unregisters = [];
+        // Listed explicitly (rather than via `Object.entries`) so each call to
+        // `registerHostChangeHandler<K>` keeps the K → handler-type connection,
+        // which a runtime iteration over keys would erase.
+        if (methods.onTokenChanged) {
+            unregisters.push(registerHostChangeHandler("onTokenChanged", methods.onTokenChanged));
+        }
+        if (methods.onTimeRangeChanged) {
+            unregisters.push(registerHostChangeHandler("onTimeRangeChanged", methods.onTimeRangeChanged));
+        }
+        if (methods.onFilterBarValuesChanged) {
+            unregisters.push(registerHostChangeHandler("onFilterBarValuesChanged", methods.onFilterBarValuesChanged));
+        }
+        if (methods.onAssetsFilterBarValuesChanged) {
+            unregisters.push(registerHostChangeHandler("onAssetsFilterBarValuesChanged", methods.onAssetsFilterBarValuesChanged));
+        }
+        if (methods.onCustomersFilterBarValuesChanged) {
+            unregisters.push(registerHostChangeHandler("onCustomersFilterBarValuesChanged", methods.onCustomersFilterBarValuesChanged));
+        }
+        if (methods.onSitesFilterBarValuesChanged) {
+            unregisters.push(registerHostChangeHandler("onSitesFilterBarValuesChanged", methods.onSitesFilterBarValuesChanged));
+        }
+        if (methods.onTablePersistenceStateChanged) {
+            unregisters.push(registerHostChangeHandler("onTablePersistenceStateChanged", methods.onTablePersistenceStateChanged));
+        }
+        if (methods.onAssetSortingStateChanged) {
+            unregisters.push(registerHostChangeHandler("onAssetSortingStateChanged", methods.onAssetSortingStateChanged));
+        }
+        if (methods.onWidgetPollIntervalChanged) {
+            unregisters.push(registerHostChangeHandler("onWidgetPollIntervalChanged", methods.onWidgetPollIntervalChanged));
+        }
+        return () => unregisters.forEach(unregister => unregister());
     }, [methods]);
 };
 
@@ -376,7 +494,7 @@ const AssetSortingProviderIrisApp = ({ children }) => {
     const methods = useMemo(() => ({
         onAssetSortingStateChanged: setAssetSortingState,
     }), [setAssetSortingState]);
-    useSubscribeToHostChanges(methods);
+    useSubscribeToHostChanges(methods, Channels.AssetSortingSubscription);
     const contextValue = useMemo(() => ({
         sortingState: assetSortingState ?? {
             sortBy: AssetSortByProperty.Criticality,
@@ -491,7 +609,7 @@ const FilterBarProviderIrisApp = ({ children }) => {
             setSitesFilterBarValues(values);
         },
     }), []);
-    useSubscribeToHostChanges(methods);
+    useSubscribeToHostChanges(methods, Channels.FilterBarSubscription);
     const isLoading = useMemo(() => assetsFilterBarValues === undefined ||
         customersFilterBarValues === undefined ||
         sitesFilterBarValues === undefined, [assetsFilterBarValues, customersFilterBarValues, sitesFilterBarValues]);
@@ -594,7 +712,7 @@ const TimeRangeProviderIrisApp = ({ children }) => {
             }));
         },
     }), []);
-    useSubscribeToHostChanges(methods);
+    useSubscribeToHostChanges(methods, Channels.TimeRangeSubscription);
     if (!timeRangeContext) {
         return null;
     }
@@ -632,7 +750,7 @@ const TokenProviderIrisApp = ({ children }) => {
     const methods = useMemo(() => ({
         onTokenChanged,
     }), [onTokenChanged]);
-    useSubscribeToHostChanges(methods);
+    useSubscribeToHostChanges(methods, Channels.TokenSubscription);
     if (state.status === "error") {
         throw new Error("Token context is invalid");
     }
@@ -760,7 +878,7 @@ const WidgetConfigProviderIrisApp = ({ children }) => {
     const methods = useMemo(() => ({
         onWidgetPollIntervalChanged: setPollInterval,
     }), [setPollInterval]);
-    useSubscribeToHostChanges(methods);
+    useSubscribeToHostChanges(methods, Channels.WidgetConfigSubscription);
     const widgetConfigContextValue = useMemo(() => ({
         getData: WidgetConfigRuntime.getWidgetData,
         setData: WidgetConfigRuntime.setWidgetData,

package/package.json

@@ -1,20 +1,20 @@
 {
   "name": "@trackunit/react-core-contexts",
-  "version": "1.30.3",
+  "version": "1.30.5-alpha-d37885bfce4.0",
   "repository": "https://github.com/Trackunit/manager",
   "license": "SEE LICENSE IN LICENSE.txt",
   "engines": {
     "node": ">=24.x"
   },
   "dependencies": {
-    "@trackunit/iris-app-api": "1.20.7",
-    "@trackunit/iris-app-runtime-core-api": "1.16.6",
-    "@trackunit/react-core-hooks": "1.17.10",
-    "@trackunit/i18n-library-translation": "1.22.1",
-    "@trackunit/react-components": "1.26.3",
-    "@trackunit/iris-app-runtime-core": "1.17.6",
+    "@trackunit/iris-app-api": "1.20.9-alpha-d37885bfce4.0",
+    "@trackunit/iris-app-runtime-core-api": "1.16.8-alpha-d37885bfce4.0",
+    "@trackunit/react-core-hooks": "1.17.12-alpha-d37885bfce4.0",
+    "@trackunit/i18n-library-translation": "1.22.3-alpha-d37885bfce4.0",
+    "@trackunit/react-components": "1.26.5-alpha-d37885bfce4.0",
+    "@trackunit/iris-app-runtime-core": "1.17.8-alpha-d37885bfce4.0",
     "graphql-sse": "^2.5.4",
-    "@trackunit/react-core-contexts-api": "1.17.6"
+    "@trackunit/react-core-contexts-api": "1.17.8-alpha-d37885bfce4.0"
   },
   "peerDependencies": {
     "@apollo/client": "^3.13.8",

package/src/createApolloClient.d.ts

@@ -0,0 +1,19 @@
+import { ApolloClient } from "@apollo/client";
+import { ErrorHandlingContextValue, TracingHeaders } from "@trackunit/iris-app-runtime-core-api";
+/**
+ * @internal
+ */
+export declare const createApolloClient: ({ graphqlPublicUrl, graphqlInternalUrl, graphqlReportUrl, isDev, tracingHeaders: initialTracingHeaders, firstToken, errorHandler, }: {
+    graphqlPublicUrl: string;
+    graphqlInternalUrl: string;
+    graphqlReportUrl: string;
+    tracingHeaders: TracingHeaders;
+    isDev: boolean;
+    firstToken?: string;
+    errorHandler: ErrorHandlingContextValue;
+}) => {
+    client: ApolloClient<import("@apollo/client").NormalizedCacheObject>;
+    setToken: (newToken: string | undefined) => void;
+    getToken: () => string | undefined;
+    setTracingHeaders: (newHeaders: TracingHeaders) => void;
+};

package/src/errorLink/errorLink.d.ts

@@ -3,7 +3,7 @@ import { ErrorHandlingContextValue } from "@trackunit/iris-app-runtime-core-api"
 /**
  * This error link is used to capture error information, i. e. traceId, graphQL errors, network errors, etc.
  */
-export declare const createErrorLink: ({ errorHandler, token, }: {
+export declare const createErrorLink: ({ errorHandler, getToken, }: {
     errorHandler: ErrorHandlingContextValue;
-    token: string | undefined;
+    getToken: () => string | undefined;
 }) => ApolloLink;

package/src/errorLink/subscriptionErrorLink.d.ts

@@ -0,0 +1,11 @@
+import { ApolloLink } from "@apollo/client";
+import { ErrorHandlingContextValue } from "@trackunit/iris-app-runtime-core-api";
+/**
+ * Wraps an SSE subscription link and provides the same error monitoring as the
+ * HTTP error link — capturing GraphQL errors, traceIds, FORCE_RELOAD_BROWSER,
+ * and UNAUTHENTICATED codes — for long-lived subscription Observables.
+ */
+export declare const createSubscriptionErrorLink: ({ errorHandler, getToken, }: {
+    errorHandler: ErrorHandlingContextValue;
+    getToken: () => string | undefined;
+}) => ApolloLink;

package/src/useSubscribeToHostChanges.d.ts

@@ -1,9 +1,20 @@
-import { setupHostConnector } from "@trackunit/iris-app-runtime-core";
-type ChildConnectorApi = Parameters<typeof setupHostConnector>[0];
+import { ChildConnectorApi } from "@trackunit/iris-app-runtime-core-api";
 /**
- * Subscribe to methods initiated by changes in the host
+ * Subscribe to methods initiated by changes in the host.
  *
- * @param methods STABLE object with the methods you'd want to subscribe to. Wrap in useMemo for instance to make it stable
+ * Handlers are registered on the singleton `host-runtime` penpal channel via
+ * {@link registerHostChangeHandler}, so push events from the host
+ * (`onTokenChanged`, `onTimeRangeChanged`, filter-bar updates, …) reach every
+ * mounted provider in the iris-app without forcing the host to open one
+ * penpal connection per subscription channel.
+ *
+ * @param methods STABLE object with the methods you'd want to subscribe to.
+ *   Wrap in `useMemo` (or build with stable callback references) so the
+ *   effect doesn't re-register on every render.
+ * @param _channel Deprecated. Pre-v7 builds used a dedicated penpal channel
+ *   per subscription provider (e.g. `token-subscription`); v7 collapses all
+ *   subscriptions onto the singleton's `host-runtime` channel through a
+ *   handler registry. The argument is accepted for source-compatibility with
+ *   the v6 API and is ignored.
  */
-export declare const useSubscribeToHostChanges: (methods: ChildConnectorApi) => void;
-export {};
+export declare const useSubscribeToHostChanges: (methods: Partial<ChildConnectorApi>, _channel?: string) => void;