@gooddata/sdk-ui-pluggable-application 11.42.0-alpha.2 → 11.42.0-alpha.3

package/esm/index.d.ts

@@ -7,4 +7,5 @@ export { type IClientPlatformContext, PlatformContextProvider, type IPlatformCon
 export { createBackendForModule, type ICreateBackendForModuleOptions } from "./backend.js";
 export { AppProviders, type IAppProvidersProps } from "./AppProviders.js";
 export { type IPluggableAppEventsContextValue, type IPluggableAppEventsProviderProps, PluggableAppEventsProvider, usePluggableAppEvents, } from "./events.js";
+export { type IModuleTelemetryMetadata, type IPluggableAppTelemetryProviderProps, enrichTelemetryCallbacks, PluggableAppTelemetryProvider, usePluggableAppTelemetry, } from "./telemetry.js";
 //# sourceMappingURL=index.d.ts.map

package/esm/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA;;;;GAIG;AAEH,OAAO,EACH,KAAK,sBAAsB,EAC3B,uBAAuB,EACvB,KAAK,6BAA6B,EAClC,kBAAkB,EAClB,wBAAwB,GAC3B,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,sBAAsB,EAAE,KAAK,8BAA8B,EAAE,MAAM,cAAc,CAAC;AAE3F,OAAO,EAAE,YAAY,EAAE,KAAK,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC1E,OAAO,EACH,KAAK,+BAA+B,EACpC,KAAK,gCAAgC,EACrC,0BAA0B,EAC1B,qBAAqB,GACxB,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA;;;;GAIG;AAEH,OAAO,EACH,KAAK,sBAAsB,EAC3B,uBAAuB,EACvB,KAAK,6BAA6B,EAClC,kBAAkB,EAClB,wBAAwB,GAC3B,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,sBAAsB,EAAE,KAAK,8BAA8B,EAAE,MAAM,cAAc,CAAC;AAE3F,OAAO,EAAE,YAAY,EAAE,KAAK,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC1E,OAAO,EACH,KAAK,+BAA+B,EACpC,KAAK,gCAAgC,EACrC,0BAA0B,EAC1B,qBAAqB,GACxB,MAAM,aAAa,CAAC;AACrB,OAAO,EACH,KAAK,wBAAwB,EAC7B,KAAK,mCAAmC,EACxC,wBAAwB,EACxB,6BAA6B,EAC7B,wBAAwB,GAC3B,MAAM,gBAAgB,CAAC"}

package/esm/index.js

@@ -9,3 +9,4 @@ export { PlatformContextProvider, usePlatformContext, usePlatformContextStrict,
 export { createBackendForModule } from "./backend.js";
 export { AppProviders } from "./AppProviders.js";
 export { PluggableAppEventsProvider, usePluggableAppEvents, } from "./events.js";
+export { enrichTelemetryCallbacks, PluggableAppTelemetryProvider, usePluggableAppTelemetry, } from "./telemetry.js";

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

@@ -9,6 +9,7 @@ import { IAuthCredentials } from '@gooddata/sdk-pluggable-application-model';
 import { ILocale } from '@gooddata/sdk-model';
 import { IPlatformContext } from '@gooddata/sdk-pluggable-application-model';
 import { IPluggableAppEvent } from '@gooddata/sdk-pluggable-application-model';
+import { IPluggableAppTelemetryCallbacks } from '@gooddata/sdk-pluggable-application-model';
 import { ITranslations } from '@gooddata/sdk-ui';
 import { JSX } from 'react/jsx-runtime';
 import { PropsWithChildren } from 'react';
@@ -66,6 +67,19 @@ export declare function AppProviders({ ctx, packageName, resolveMessages: resolv
  */
 export declare function createBackendForModule(auth: IAuthCredentials, options: ICreateBackendForModuleOptions): IAnalyticalBackend;
 
+/**
+ * Wraps host telemetry callbacks so every `trackEvent` call also reports the module's runtime metadata.
+ *
+ * @remarks
+ * The metadata is merged into the event `data` before the host's own `data` keys, so an explicit key in
+ * the call site's `data` wins on collision (mirroring how the host merges its common properties).
+ * `trackPageView` and `trackTiming` are passed through unchanged — they carry no `data` slot today.
+ * Returns `undefined` when given `undefined`, so a standalone module (mounted outside the host) stays a no-op.
+ *
+ * @alpha
+ */
+export declare function enrichTelemetryCallbacks(callbacks: IPluggableAppTelemetryCallbacks | undefined, metadata: IModuleTelemetryMetadata): IPluggableAppTelemetryCallbacks | undefined;
+
 /**
  * Props for {@link AppProviders}.
  *
@@ -137,6 +151,33 @@ export declare interface ICreateBackendForModuleOptions {
     packageVersion?: string;
 }
 
+/**
+ * Metadata describing the module runtime that owns the telemetry callbacks.
+ *
+ * @remarks
+ * Attached to every {@link @gooddata/sdk-pluggable-application-model#IPluggableAppTelemetryCallbacks.trackEvent}
+ * payload so events can be attributed to the module's own React / SDK versions. These may differ from the
+ * host's (which the host attaches as `hostReactVersion` / `hostSdkVersion`) when a module bundles its own
+ * React instead of consuming the host's shared singleton.
+ *
+ * Capture the versions at the module's mount entry — `import { version } from "react"` and
+ * `import { LIB_VERSION } from "@gooddata/sdk-pluggable-application-model"` — and pass them in. Reading them
+ * inside this shared library would resolve to the host's copies under module federation.
+ *
+ * @alpha
+ */
+export declare interface IModuleTelemetryMetadata {
+    /**
+     * Version of React that rendered the module, e.g. `import { version } from "react"`.
+     */
+    moduleReactVersion?: string;
+    /**
+     * Version of the GoodData SDK the module is built against, e.g.
+     * `import { LIB_VERSION } from "@gooddata/sdk-pluggable-application-model"`.
+     */
+    moduleSdkVersion?: string;
+}
+
 /**
  * Props for {@link PlatformContextProvider}.
  *
@@ -186,6 +227,18 @@ export declare interface IPluggableAppEventsProviderProps extends PropsWithChild
     onEvent?: (event: IPluggableAppEvent) => void;
 }
 
+/**
+ * Props for {@link PluggableAppTelemetryProvider}.
+ *
+ * @alpha
+ */
+export declare interface IPluggableAppTelemetryProviderProps extends PropsWithChildren, IModuleTelemetryMetadata {
+    /**
+     * Host telemetry callbacks passed through pluggable mount options.
+     */
+    onTelemetryEvent?: IPluggableAppTelemetryCallbacks;
+}
+
 /**
  * React provider that binds platform context into React context.
  *
@@ -200,6 +253,18 @@ export declare function PlatformContextProvider({ value, children }: IPlatformCo
  */
 export declare function PluggableAppEventsProvider({ onEvent, children }: IPluggableAppEventsProviderProps): JSX.Element;
 
+/**
+ * React provider exposing telemetry callbacks enriched with the module's runtime metadata.
+ *
+ * @remarks
+ * Components consume the enriched callbacks via {@link usePluggableAppTelemetry} and never handle the
+ * module metadata themselves — it lives in the provider's closure. No-ops safely when `onTelemetryEvent`
+ * is absent (e.g. standalone runs outside the host).
+ *
+ * @alpha
+ */
+export declare function PluggableAppTelemetryProvider({ onTelemetryEvent, moduleReactVersion, moduleSdkVersion, children }: IPluggableAppTelemetryProviderProps): JSX.Element;
+
 /**
  * Returns client platform context snapshot (or undefined if not available yet).
  *
@@ -221,4 +286,11 @@ export declare function usePlatformContextStrict(context?: string): IClientPlatf
  */
 export declare function usePluggableAppEvents(): IPluggableAppEventsContextValue;
 
+/**
+ * Returns telemetry callbacks enriched with the module's runtime metadata.
+ *
+ * @alpha
+ */
+export declare function usePluggableAppTelemetry(): IPluggableAppTelemetryCallbacks;
+
 export { }

package/esm/telemetry.d.ts

@@ -0,0 +1,69 @@
+import { type PropsWithChildren } from "react";
+import { type IPluggableAppTelemetryCallbacks } from "@gooddata/sdk-pluggable-application-model";
+/**
+ * Metadata describing the module runtime that owns the telemetry callbacks.
+ *
+ * @remarks
+ * Attached to every {@link @gooddata/sdk-pluggable-application-model#IPluggableAppTelemetryCallbacks.trackEvent}
+ * payload so events can be attributed to the module's own React / SDK versions. These may differ from the
+ * host's (which the host attaches as `hostReactVersion` / `hostSdkVersion`) when a module bundles its own
+ * React instead of consuming the host's shared singleton.
+ *
+ * Capture the versions at the module's mount entry — `import { version } from "react"` and
+ * `import { LIB_VERSION } from "@gooddata/sdk-pluggable-application-model"` — and pass them in. Reading them
+ * inside this shared library would resolve to the host's copies under module federation.
+ *
+ * @alpha
+ */
+export interface IModuleTelemetryMetadata {
+    /**
+     * Version of React that rendered the module, e.g. `import { version } from "react"`.
+     */
+    moduleReactVersion?: string;
+    /**
+     * Version of the GoodData SDK the module is built against, e.g.
+     * `import { LIB_VERSION } from "@gooddata/sdk-pluggable-application-model"`.
+     */
+    moduleSdkVersion?: string;
+}
+/**
+ * Wraps host telemetry callbacks so every `trackEvent` call also reports the module's runtime metadata.
+ *
+ * @remarks
+ * The metadata is merged into the event `data` before the host's own `data` keys, so an explicit key in
+ * the call site's `data` wins on collision (mirroring how the host merges its common properties).
+ * `trackPageView` and `trackTiming` are passed through unchanged — they carry no `data` slot today.
+ * Returns `undefined` when given `undefined`, so a standalone module (mounted outside the host) stays a no-op.
+ *
+ * @alpha
+ */
+export declare function enrichTelemetryCallbacks(callbacks: IPluggableAppTelemetryCallbacks | undefined, metadata: IModuleTelemetryMetadata): IPluggableAppTelemetryCallbacks | undefined;
+/**
+ * Props for {@link PluggableAppTelemetryProvider}.
+ *
+ * @alpha
+ */
+export interface IPluggableAppTelemetryProviderProps extends PropsWithChildren, IModuleTelemetryMetadata {
+    /**
+     * Host telemetry callbacks passed through pluggable mount options.
+     */
+    onTelemetryEvent?: IPluggableAppTelemetryCallbacks;
+}
+/**
+ * React provider exposing telemetry callbacks enriched with the module's runtime metadata.
+ *
+ * @remarks
+ * Components consume the enriched callbacks via {@link usePluggableAppTelemetry} and never handle the
+ * module metadata themselves — it lives in the provider's closure. No-ops safely when `onTelemetryEvent`
+ * is absent (e.g. standalone runs outside the host).
+ *
+ * @alpha
+ */
+export declare function PluggableAppTelemetryProvider({ onTelemetryEvent, moduleReactVersion, moduleSdkVersion, children }: IPluggableAppTelemetryProviderProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Returns telemetry callbacks enriched with the module's runtime metadata.
+ *
+ * @alpha
+ */
+export declare function usePluggableAppTelemetry(): IPluggableAppTelemetryCallbacks;
+//# sourceMappingURL=telemetry.d.ts.map

package/esm/telemetry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.d.ts","sourceRoot":"","sources":["../src/telemetry.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,iBAAiB,EAAsC,MAAM,OAAO,CAAC;AAEnF,OAAO,EAAE,KAAK,+BAA+B,EAAE,MAAM,2CAA2C,CAAC;AAEjG;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,wBAAwB;IACrC;;OAEG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,wBAAwB,CACpC,SAAS,EAAE,+BAA+B,GAAG,SAAS,EACtD,QAAQ,EAAE,wBAAwB,GACnC,+BAA+B,GAAG,SAAS,CAU7C;AAaD;;;;GAIG;AACH,MAAM,WAAW,mCAAoC,SAAQ,iBAAiB,EAAE,wBAAwB;IACpG;;OAEG;IACH,gBAAgB,CAAC,EAAE,+BAA+B,CAAC;CACtD;AAED;;;;;;;;;GASG;AACH,wBAAgB,6BAA6B,CAAC,EAC1C,gBAAgB,EAChB,kBAAkB,EAClB,gBAAgB,EAChB,QAAQ,EACX,EAAE,mCAAmC,2CAarC;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,IAAI,+BAA+B,CAE1E"}

package/esm/telemetry.js

@@ -0,0 +1,56 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+// (C) 2026 GoodData Corporation
+import { createContext, useContext, useMemo } from "react";
+/**
+ * Wraps host telemetry callbacks so every `trackEvent` call also reports the module's runtime metadata.
+ *
+ * @remarks
+ * The metadata is merged into the event `data` before the host's own `data` keys, so an explicit key in
+ * the call site's `data` wins on collision (mirroring how the host merges its common properties).
+ * `trackPageView` and `trackTiming` are passed through unchanged — they carry no `data` slot today.
+ * Returns `undefined` when given `undefined`, so a standalone module (mounted outside the host) stays a no-op.
+ *
+ * @alpha
+ */
+export function enrichTelemetryCallbacks(callbacks, metadata) {
+    if (!callbacks) {
+        return undefined;
+    }
+    return {
+        ...callbacks,
+        trackEvent(eventName, data, options) {
+            callbacks.trackEvent(eventName, { ...metadata, ...data }, options);
+        },
+    };
+}
+const noop = () => undefined;
+const defaultTelemetry = {
+    trackEvent: noop,
+    trackPageView: noop,
+    trackTiming: noop,
+};
+const PluggableAppTelemetryContext = createContext(defaultTelemetry);
+PluggableAppTelemetryContext.displayName = "PluggableAppTelemetryContext";
+/**
+ * React provider exposing telemetry callbacks enriched with the module's runtime metadata.
+ *
+ * @remarks
+ * Components consume the enriched callbacks via {@link usePluggableAppTelemetry} and never handle the
+ * module metadata themselves — it lives in the provider's closure. No-ops safely when `onTelemetryEvent`
+ * is absent (e.g. standalone runs outside the host).
+ *
+ * @alpha
+ */
+export function PluggableAppTelemetryProvider({ onTelemetryEvent, moduleReactVersion, moduleSdkVersion, children, }) {
+    const value = useMemo(() => enrichTelemetryCallbacks(onTelemetryEvent, { moduleReactVersion, moduleSdkVersion }) ??
+        defaultTelemetry, [onTelemetryEvent, moduleReactVersion, moduleSdkVersion]);
+    return (_jsx(PluggableAppTelemetryContext.Provider, { value: value, children: children }));
+}
+/**
+ * Returns telemetry callbacks enriched with the module's runtime metadata.
+ *
+ * @alpha
+ */
+export function usePluggableAppTelemetry() {
+    return useContext(PluggableAppTelemetryContext);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gooddata/sdk-ui-pluggable-application",
-  "version": "11.42.0-alpha.2",
+  "version": "11.42.0-alpha.3",
   "description": "GoodData SDK React helpers for pluggable applications",
   "license": "MIT",
   "author": "GoodData Corporation",
@@ -24,12 +24,12 @@
     "react-intl": "7.1.11",
     "ts-invariant": "0.10.3",
     "tslib": "2.8.1",
-    "@gooddata/sdk-backend-base": "11.42.0-alpha.2",
-    "@gooddata/sdk-backend-tiger": "11.42.0-alpha.2",
-    "@gooddata/sdk-backend-spi": "11.42.0-alpha.2",
-    "@gooddata/sdk-model": "11.42.0-alpha.2",
-    "@gooddata/sdk-pluggable-application-model": "11.42.0-alpha.2",
-    "@gooddata/sdk-ui": "11.42.0-alpha.2"
+    "@gooddata/sdk-backend-base": "11.42.0-alpha.3",
+    "@gooddata/sdk-backend-spi": "11.42.0-alpha.3",
+    "@gooddata/sdk-model": "11.42.0-alpha.3",
+    "@gooddata/sdk-pluggable-application-model": "11.42.0-alpha.3",
+    "@gooddata/sdk-backend-tiger": "11.42.0-alpha.3",
+    "@gooddata/sdk-ui": "11.42.0-alpha.3"
   },
   "devDependencies": {
     "@microsoft/api-documenter": "^7.17.0",
@@ -61,8 +61,8 @@
     "react-dom": "19.1.1",
     "typescript": "5.9.3",
     "vitest": "4.1.8",
-    "@gooddata/oxlint-config": "11.42.0-alpha.2",
-    "@gooddata/eslint-config": "11.42.0-alpha.2"
+    "@gooddata/eslint-config": "11.42.0-alpha.3",
+    "@gooddata/oxlint-config": "11.42.0-alpha.3"
   },
   "peerDependencies": {
     "react": "^18.0.0 || ^19.0.0",
@@ -70,7 +70,7 @@
   },
   "scripts": {
     "_phase:build": "npm run build",
-    "_phase:test": "echo \"No tests for @gooddata/sdk-ui-pluggable-application\"",
+    "_phase:test": "npm run test-once",
     "_phase:validate": "npm run validate",
     "api-extractor": "mkdir -p api && [ -z \"${CI}\" ] && (api-extractor run -l) || (api-extractor run)",
     "build": "npm-run-all -p build-check build-ts && npm run api-extractor",