@gooddata/sdk-pluggable-application-model 11.43.0-alpha.0 → 11.43.0-alpha.2

package/esm/__version.js

@@ -1,7 +1,7 @@
 // (C) 2026 GoodData Corporation
 // DO NOT CHANGE THIS FILE, IT IS RE-GENERATED ON EVERY BUILD
 /** @alpha */
-export const LIB_VERSION = "11.43.0-alpha.0";
+export const LIB_VERSION = "11.43.0-alpha.2";
 /** @alpha */
 export const LIB_DESCRIPTION = "GoodData SDK model contracts for pluggable applications";
 /** @alpha */

package/esm/index.d.ts

@@ -7,6 +7,7 @@ export { DefaultApplicationId } from "./defaultPlatformApplications.js";
 export { LIB_VERSION, LIB_DESCRIPTION, LIB_NAME } from "./__version.js";
 export { type EmbeddingMode, type IApiTokenAuthCredentials, type IAuthCredentials, type IContextDeferredAuthCredentials, type IEffectiveSettings, type IJwtAuthCredentials, type IOrganization, type IOrganizationPermissions, type IPlatformContext, type IPlatformContextV1, type IPluggableApplicationNavigation, PantherTier, isPlatformContextV1, isWorkspaceScopedSettings, } from "./platformContext.js";
 export { type ILocale } from "@gooddata/sdk-model";
-export { type IAppHeaderOptions, type IAppInstance, type KnownPluggableAppEventTypeName, type IDocumentTitleChangedEvent, type IOpenAiAssistantRequestedEvent, type ICloseAiAssistantRequestedEvent, type IAiAssistantContextChangedEvent, type IPluggableApp, type IPluggableApplicationMountHandle, type IPluggableApplicationMountOptions, type IPluggableAppEvent, type IPluggableAppTelemetryCallbacks, type IReloadPlatformContextRequestedEvent, type ITelemetryEventOptions, documentTitleChanged, isDocumentTitleChangedEvent, isOpenAiAssistantRequestedEvent, isCloseAiAssistantRequestedEvent, isAiAssistantContextChangedEvent, isReloadPlatformContextRequestedEvent, openAiAssistantRequested, closeAiAssistantRequested, aiAssistantContextChanged, type PluggableApplicationMount, PluggableAppEventType, type PluggableAppEventTypeName, reloadPlatformContextRequested, type TelemetryChannel, } from "./mount.js";
+export { type IAppHeaderOptions, type IAppInstance, type KnownPluggableAppEventTypeName, type IDocumentTitleChangedEvent, type IOpenAiAssistantRequestedEvent, type ICloseAiAssistantRequestedEvent, type IAiAssistantContextChangedEvent, type IPluggableApp, type IPluggableApplicationMountHandle, type IPluggableApplicationMountOptions, type IPluggableAppEvent, type IPluggableAppLogRecord, type IPluggableAppTelemetryCallbacks, type IPluggableAppTelemetryEventData, type IReloadPlatformContextRequestedEvent, type ITelemetryEventOptions, documentTitleChanged, isDocumentTitleChangedEvent, isOpenAiAssistantRequestedEvent, isCloseAiAssistantRequestedEvent, isAiAssistantContextChangedEvent, isReloadPlatformContextRequestedEvent, openAiAssistantRequested, closeAiAssistantRequested, aiAssistantContextChanged, type PluggableApplicationMount, PluggableAppEventType, type PluggableAppEventTypeName, reloadPlatformContextRequested, type TelemetryChannel, } from "./mount.js";
+export { type ITelemetryPropertySlot, type TelemetryPropertyScope, TELEMETRY_PROPERTIES, } from "./telemetry/telemetryProperties.js";
 export { type IHostUiModule, type IHostUiMountHandle, type IHostUiMountOptions, type IHostUiNotification, type INewDeploymentAvailableHostUiNotification, type IOpenAiAssistantHostUiNotification, type ICloseAiAssistantHostUiNotification, type IAiAssistantContextHostUiNotification, type HostUiMount, } from "./hostUi.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,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AAExE,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAExE,OAAO,EACH,KAAK,aAAa,EAClB,KAAK,wBAAwB,EAC7B,KAAK,gBAAgB,EACrB,KAAK,+BAA+B,EACpC,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,aAAa,EAClB,KAAK,wBAAwB,EAC7B,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,+BAA+B,EACpC,WAAW,EACX,mBAAmB,EACnB,yBAAyB,GAC5B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAEnD,OAAO,EACH,KAAK,iBAAiB,EACtB,KAAK,YAAY,EACjB,KAAK,8BAA8B,EACnC,KAAK,0BAA0B,EAC/B,KAAK,8BAA8B,EACnC,KAAK,+BAA+B,EACpC,KAAK,+BAA+B,EACpC,KAAK,aAAa,EAClB,KAAK,gCAAgC,EACrC,KAAK,iCAAiC,EACtC,KAAK,kBAAkB,EACvB,KAAK,+BAA+B,EACpC,KAAK,oCAAoC,EACzC,KAAK,sBAAsB,EAC3B,oBAAoB,EACpB,2BAA2B,EAC3B,+BAA+B,EAC/B,gCAAgC,EAChC,gCAAgC,EAChC,qCAAqC,EACrC,wBAAwB,EACxB,yBAAyB,EACzB,yBAAyB,EACzB,KAAK,yBAAyB,EAC9B,qBAAqB,EACrB,KAAK,yBAAyB,EAC9B,8BAA8B,EAC9B,KAAK,gBAAgB,GACxB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACH,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,yCAAyC,EAC9C,KAAK,kCAAkC,EACvC,KAAK,mCAAmC,EACxC,KAAK,qCAAqC,EAC1C,KAAK,WAAW,GACnB,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA;;;;GAIG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AAExE,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAExE,OAAO,EACH,KAAK,aAAa,EAClB,KAAK,wBAAwB,EAC7B,KAAK,gBAAgB,EACrB,KAAK,+BAA+B,EACpC,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,aAAa,EAClB,KAAK,wBAAwB,EAC7B,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,+BAA+B,EACpC,WAAW,EACX,mBAAmB,EACnB,yBAAyB,GAC5B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAEnD,OAAO,EACH,KAAK,iBAAiB,EACtB,KAAK,YAAY,EACjB,KAAK,8BAA8B,EACnC,KAAK,0BAA0B,EAC/B,KAAK,8BAA8B,EACnC,KAAK,+BAA+B,EACpC,KAAK,+BAA+B,EACpC,KAAK,aAAa,EAClB,KAAK,gCAAgC,EACrC,KAAK,iCAAiC,EACtC,KAAK,kBAAkB,EACvB,KAAK,sBAAsB,EAC3B,KAAK,+BAA+B,EACpC,KAAK,+BAA+B,EACpC,KAAK,oCAAoC,EACzC,KAAK,sBAAsB,EAC3B,oBAAoB,EACpB,2BAA2B,EAC3B,+BAA+B,EAC/B,gCAAgC,EAChC,gCAAgC,EAChC,qCAAqC,EACrC,wBAAwB,EACxB,yBAAyB,EACzB,yBAAyB,EACzB,KAAK,yBAAyB,EAC9B,qBAAqB,EACrB,KAAK,yBAAyB,EAC9B,8BAA8B,EAC9B,KAAK,gBAAgB,GACxB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACH,KAAK,sBAAsB,EAC3B,KAAK,sBAAsB,EAC3B,oBAAoB,GACvB,MAAM,oCAAoC,CAAC;AAE5C,OAAO,EACH,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,yCAAyC,EAC9C,KAAK,kCAAkC,EACvC,KAAK,mCAAmC,EACxC,KAAK,qCAAqC,EAC1C,KAAK,WAAW,GACnB,MAAM,aAAa,CAAC"}

package/esm/index.js

@@ -9,3 +9,4 @@ export { DefaultApplicationId } from "./defaultPlatformApplications.js";
 export { LIB_VERSION, LIB_DESCRIPTION, LIB_NAME } from "./__version.js";
 export { PantherTier, isPlatformContextV1, isWorkspaceScopedSettings, } from "./platformContext.js";
 export { documentTitleChanged, isDocumentTitleChangedEvent, isOpenAiAssistantRequestedEvent, isCloseAiAssistantRequestedEvent, isAiAssistantContextChangedEvent, isReloadPlatformContextRequestedEvent, openAiAssistantRequested, closeAiAssistantRequested, aiAssistantContextChanged, PluggableAppEventType, reloadPlatformContextRequested, } from "./mount.js";
+export { TELEMETRY_PROPERTIES, } from "./telemetry/telemetryProperties.js";

package/esm/mount.d.ts

@@ -233,6 +233,52 @@ export interface ITelemetryEventOptions {
      */
     channel?: TelemetryChannel;
 }
+/**
+ * A structured OpenTelemetry log record forwarded by a pluggable application to the host shell.
+ *
+ * @remarks
+ * Mirrors the shape of an OpenTelemetry `LogRecord` body/severity/attributes. The host emits it through
+ * its own page-level OTel logger (see {@link IPluggableAppTelemetryCallbacks.logRecord}), so the module
+ * does not need its own `LoggerProvider`. The host fills in the timestamp, resource and shared context
+ * (deployment / organization / user / source application) — the module supplies only the event-specific
+ * fields.
+ *
+ * @alpha
+ */
+export interface IPluggableAppLogRecord {
+    /** Log body — typically an event name such as `"timing-dashboard-load-kd"`. */
+    body: string;
+    /** OTel severity number (1–24). Defaults to `9` (INFO) when omitted. */
+    severityNumber?: number;
+    /** OTel severity text, e.g. `"INFO"`. Defaults to `"INFO"` when omitted. */
+    severityText?: string;
+    /** Event-specific attributes (e.g. `{ duration }`). Merged with the host's shared context. */
+    attributes?: Record<string, unknown>;
+}
+/**
+ * Transport-neutral structured data a pluggable application may attach to a telemetry event.
+ *
+ * @remarks
+ * Pluggable applications describe an event with these neutral groups and must NOT assume any particular
+ * analytics backend (Matomo, Amplitude, …) — the host shell decides how to record them. `identifiers` are
+ * sensitive entity ids (workspace, dashboard, report, …) the shell may hash and aggregate; `stats` are
+ * contextual metrics (counts, types, …). Any other key is a free-form event property. Passed as the `data`
+ * argument of {@link IPluggableAppTelemetryCallbacks.trackEvent}.
+ *
+ * @alpha
+ */
+export interface IPluggableAppTelemetryEventData {
+    [key: string]: unknown;
+    /**
+     * Sensitive entity identifiers for the event (e.g. `{ workspaceId, dashboardId }`). The shell decides
+     * how to record them — modules must not hash, pack or otherwise format them for a specific backend.
+     */
+    identifiers?: Record<string, string>;
+    /**
+     * Contextual metrics / stats for the event (e.g. `{ insightsCount, attributeFiltersCount }`).
+     */
+    stats?: Record<string, string | number | boolean>;
+}
 /**
  * Telemetry callbacks provided by the shell to pluggable applications.
  *
@@ -252,10 +298,35 @@ export interface IPluggableAppTelemetryCallbacks {
      * @param options - Optional event configuration (e.g. channel routing).
      */
     trackEvent: (eventName: string, data?: Record<string, unknown>, options?: ITelemetryEventOptions) => void;
-    /** Track a page view within the pluggable application. */
-    trackPageView: (page: string) => void;
-    /** Track a timing measurement from the pluggable application. */
-    trackTiming: (variable: string, label: string, valueMs: number) => void;
+    /**
+     * Track a page view within the pluggable application.
+     *
+     * @param page - The page path/identifier.
+     * @param data - Optional neutral event data ({@link IPluggableAppTelemetryEventData}); `identifiers`
+     *   keep the page view's workspace/dashboard attribution, `stats` carry contextual metrics.
+     */
+    trackPageView: (page: string, data?: IPluggableAppTelemetryEventData) => void;
+    /**
+     * Track a timing measurement from the pluggable application.
+     *
+     * @param variable - The timing variable name.
+     * @param label - The timing label.
+     * @param valueMs - The measured duration in milliseconds.
+     * @param data - Optional neutral event data ({@link IPluggableAppTelemetryEventData}); a `category`
+     *   property attributes the timing to the source app rather than the shell, `stats` carry metrics.
+     */
+    trackTiming: (variable: string, label: string, valueMs: number, data?: IPluggableAppTelemetryEventData) => void;
+    /**
+     * Forward a structured OpenTelemetry log record to the host's page-level OTel logger.
+     *
+     * @remarks
+     * Unlike {@link IPluggableAppTelemetryCallbacks.trackEvent} (which routes to the analytics
+     * trackers — Matomo / Amplitude), this targets the host's OpenTelemetry logging pipeline (OTLP
+     * `/v1/logs`). It exists because the OTel Logs API cannot be reliably shared across module-federation
+     * bundles the way the global tracer is, so module logs are forwarded as plain data and re-emitted by
+     * the host. Optional: a host that has no OTel logger configured simply omits it (the call is a no-op).
+     */
+    logRecord?: (record: IPluggableAppLogRecord) => void;
 }
 /**
  * Header customization options that a pluggable application can push to the host shell.

package/esm/mount.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mount.d.ts","sourceRoot":"","sources":["../src/mount.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"mount.d.ts","sourceRoot":"","sources":["../src/mount.ts"],"names":[],"mappings":"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"}

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

@@ -762,6 +762,29 @@ export declare interface IPluggableApplicationNavigation {
     openApp(id: string, path?: string): void;
 }
 
+/**
+ * A structured OpenTelemetry log record forwarded by a pluggable application to the host shell.
+ *
+ * @remarks
+ * Mirrors the shape of an OpenTelemetry `LogRecord` body/severity/attributes. The host emits it through
+ * its own page-level OTel logger (see {@link IPluggableAppTelemetryCallbacks.logRecord}), so the module
+ * does not need its own `LoggerProvider`. The host fills in the timestamp, resource and shared context
+ * (deployment / organization / user / source application) — the module supplies only the event-specific
+ * fields.
+ *
+ * @alpha
+ */
+export declare interface IPluggableAppLogRecord {
+    /** Log body — typically an event name such as `"timing-dashboard-load-kd"`. */
+    body: string;
+    /** OTel severity number (1–24). Defaults to `9` (INFO) when omitted. */
+    severityNumber?: number;
+    /** OTel severity text, e.g. `"INFO"`. Defaults to `"INFO"` when omitted. */
+    severityText?: string;
+    /** Event-specific attributes (e.g. `{ duration }`). Merged with the host's shared context. */
+    attributes?: Record<string, unknown>;
+}
+
 /**
  * Telemetry callbacks provided by the shell to pluggable applications.
  *
@@ -781,10 +804,60 @@ export declare interface IPluggableAppTelemetryCallbacks {
      * @param options - Optional event configuration (e.g. channel routing).
      */
     trackEvent: (eventName: string, data?: Record<string, unknown>, options?: ITelemetryEventOptions) => void;
-    /** Track a page view within the pluggable application. */
-    trackPageView: (page: string) => void;
-    /** Track a timing measurement from the pluggable application. */
-    trackTiming: (variable: string, label: string, valueMs: number) => void;
+    /**
+     * Track a page view within the pluggable application.
+     *
+     * @param page - The page path/identifier.
+     * @param data - Optional neutral event data ({@link IPluggableAppTelemetryEventData}); `identifiers`
+     *   keep the page view's workspace/dashboard attribution, `stats` carry contextual metrics.
+     */
+    trackPageView: (page: string, data?: IPluggableAppTelemetryEventData) => void;
+    /**
+     * Track a timing measurement from the pluggable application.
+     *
+     * @param variable - The timing variable name.
+     * @param label - The timing label.
+     * @param valueMs - The measured duration in milliseconds.
+     * @param data - Optional neutral event data ({@link IPluggableAppTelemetryEventData}); a `category`
+     *   property attributes the timing to the source app rather than the shell, `stats` carry metrics.
+     */
+    trackTiming: (variable: string, label: string, valueMs: number, data?: IPluggableAppTelemetryEventData) => void;
+    /**
+     * Forward a structured OpenTelemetry log record to the host's page-level OTel logger.
+     *
+     * @remarks
+     * Unlike {@link IPluggableAppTelemetryCallbacks.trackEvent} (which routes to the analytics
+     * trackers — Matomo / Amplitude), this targets the host's OpenTelemetry logging pipeline (OTLP
+     * `/v1/logs`). It exists because the OTel Logs API cannot be reliably shared across module-federation
+     * bundles the way the global tracer is, so module logs are forwarded as plain data and re-emitted by
+     * the host. Optional: a host that has no OTel logger configured simply omits it (the call is a no-op).
+     */
+    logRecord?: (record: IPluggableAppLogRecord) => void;
+}
+
+/**
+ * Transport-neutral structured data a pluggable application may attach to a telemetry event.
+ *
+ * @remarks
+ * Pluggable applications describe an event with these neutral groups and must NOT assume any particular
+ * analytics backend (Matomo, Amplitude, …) — the host shell decides how to record them. `identifiers` are
+ * sensitive entity ids (workspace, dashboard, report, …) the shell may hash and aggregate; `stats` are
+ * contextual metrics (counts, types, …). Any other key is a free-form event property. Passed as the `data`
+ * argument of {@link IPluggableAppTelemetryCallbacks.trackEvent}.
+ *
+ * @alpha
+ */
+export declare interface IPluggableAppTelemetryEventData {
+    [key: string]: unknown;
+    /**
+     * Sensitive entity identifiers for the event (e.g. `{ workspaceId, dashboardId }`). The shell decides
+     * how to record them — modules must not hash, pack or otherwise format them for a specific backend.
+     */
+    identifiers?: Record<string, string>;
+    /**
+     * Contextual metrics / stats for the event (e.g. `{ insightsCount, attributeFiltersCount }`).
+     */
+    stats?: Record<string, string | number | boolean>;
 }
 
 /**
@@ -869,6 +942,21 @@ export declare interface ITelemetryEventOptions {
     channel?: TelemetryChannel;
 }
 
+/**
+ * A single telemetry property slot: its 1-based index, the name reported under that index, and scope.
+ *
+ * @remarks
+ * The analytics backend the shell uses aggregates these by `(scope, index)`, so the index — not the name —
+ * is the stable contract.
+ *
+ * @alpha
+ */
+export declare interface ITelemetryPropertySlot {
+    index: number;
+    name: string;
+    scope: TelemetryPropertyScope;
+}
+
 /**
  * Union of known pluggable application event type names.
  *
@@ -947,6 +1035,90 @@ export declare type PluggableApplicationMount = (options: IPluggableApplicationM
  */
 export declare function reloadPlatformContextRequested(): IReloadPlatformContextRequestedEvent;
 
+/**
+ * Canonical, single-source-of-truth allocation of the shell's telemetry property slots, so a given
+ * `(scope, index)` means the same thing everywhere it is reported.
+ *
+ * @remarks
+ * The shell's analytics backend aggregates properties by `(scope, index)`, not by the name passed at call
+ * time — so the index is the contract, and slots must be sourced from here rather than assigned by array
+ * position.
+ *
+ * This registry is **shell-owned**: only the host shell consumes it when serializing telemetry. Pluggable
+ * modules never reference it — they forward transport-neutral telemetry (see the `identifiers` / `stats`
+ * groups on {@link IPluggableAppTelemetryEventData}) and the host alone maps that onto the packed page
+ * slots below. (The legacy standalone trackers still read it directly until standalone mode is removed.)
+ *
+ * Page slots:
+ * - `Multivalue` (1) — packed `key1=v1,…` of the event's sensitive identifiers (the shell hashes them).
+ * - `StatsValue` (2) — packed `key1=v1,…` of the event's contextual stats/metrics (verbatim).
+ * - `ModuleReactVersion` / `ModuleSdkVersion` (3/4) — the emitting module's runtime versions.
+ *
+ * Both packed values are bounded to ~200 chars by the backend. Module React / SDK versions use `"page"`
+ * scope (not `"visit"`): the active pluggable module can change within a session as the user navigates
+ * between apps, so the version is an action-level attribute that must ride only the event it describes.
+ * (The host's own React / SDK versions are constant per session, so they stay in `"visit"` scope at 6/7.)
+ *
+ * @alpha
+ */
+export declare const TELEMETRY_PROPERTIES: {
+    readonly deploymentId: {
+        readonly index: 1;
+        readonly name: "DeploymentId";
+        readonly scope: "visit";
+    };
+    readonly organizationId: {
+        readonly index: 2;
+        readonly name: "OrganizationId";
+        readonly scope: "visit";
+    };
+    readonly sessionId: {
+        readonly index: 3;
+        readonly name: "SessionId";
+        readonly scope: "visit";
+    };
+    readonly revHash: {
+        readonly index: 4;
+        readonly name: "RevHash";
+        readonly scope: "visit";
+    };
+    readonly isExport: {
+        readonly index: 5;
+        readonly name: "isExport";
+        readonly scope: "visit";
+    };
+    readonly hostReactVersion: {
+        readonly index: 6;
+        readonly name: "HostReactVersion";
+        readonly scope: "visit";
+    };
+    readonly hostSdkVersion: {
+        readonly index: 7;
+        readonly name: "HostSdkVersion";
+        readonly scope: "visit";
+    };
+    readonly multivalue: {
+        readonly index: 1;
+        readonly name: "Multivalue";
+        readonly scope: "page";
+    };
+    readonly statsValue: {
+        readonly index: 2;
+        readonly name: "StatsValue";
+        readonly scope: "page";
+    };
+    readonly moduleReactVersion: {
+        readonly index: 3;
+        readonly name: "ModuleReactVersion";
+        readonly scope: "page";
+    };
+    readonly moduleSdkVersion: {
+        readonly index: 4;
+        readonly name: "ModuleSdkVersion";
+        readonly scope: "page";
+    };
+};
+
 /**
  * Telemetry channel determines which analytics pipeline receives the event.
  *
@@ -958,4 +1130,11 @@ export declare function reloadPlatformContextRequested(): IReloadPlatformContext
  */
 export declare type TelemetryChannel = "standard" | "ai";
 
+/**
+ * Scope of a telemetry property slot — `"visit"` persists for the whole session, `"page"` is per action.
+ *
+ * @alpha
+ */
+export declare type TelemetryPropertyScope = "visit" | "page";
+
 export { }

package/esm/telemetry/telemetryProperties.d.ts

@@ -0,0 +1,104 @@
+/**
+ * Scope of a telemetry property slot — `"visit"` persists for the whole session, `"page"` is per action.
+ *
+ * @alpha
+ */
+export type TelemetryPropertyScope = "visit" | "page";
+/**
+ * A single telemetry property slot: its 1-based index, the name reported under that index, and scope.
+ *
+ * @remarks
+ * The analytics backend the shell uses aggregates these by `(scope, index)`, so the index — not the name —
+ * is the stable contract.
+ *
+ * @alpha
+ */
+export interface ITelemetryPropertySlot {
+    index: number;
+    name: string;
+    scope: TelemetryPropertyScope;
+}
+/**
+ * Canonical, single-source-of-truth allocation of the shell's telemetry property slots, so a given
+ * `(scope, index)` means the same thing everywhere it is reported.
+ *
+ * @remarks
+ * The shell's analytics backend aggregates properties by `(scope, index)`, not by the name passed at call
+ * time — so the index is the contract, and slots must be sourced from here rather than assigned by array
+ * position.
+ *
+ * This registry is **shell-owned**: only the host shell consumes it when serializing telemetry. Pluggable
+ * modules never reference it — they forward transport-neutral telemetry (see the `identifiers` / `stats`
+ * groups on {@link IPluggableAppTelemetryEventData}) and the host alone maps that onto the packed page
+ * slots below. (The legacy standalone trackers still read it directly until standalone mode is removed.)
+ *
+ * Page slots:
+ * - `Multivalue` (1) — packed `key1=v1,…` of the event's sensitive identifiers (the shell hashes them).
+ * - `StatsValue` (2) — packed `key1=v1,…` of the event's contextual stats/metrics (verbatim).
+ * - `ModuleReactVersion` / `ModuleSdkVersion` (3/4) — the emitting module's runtime versions.
+ *
+ * Both packed values are bounded to ~200 chars by the backend. Module React / SDK versions use `"page"`
+ * scope (not `"visit"`): the active pluggable module can change within a session as the user navigates
+ * between apps, so the version is an action-level attribute that must ride only the event it describes.
+ * (The host's own React / SDK versions are constant per session, so they stay in `"visit"` scope at 6/7.)
+ *
+ * @alpha
+ */
+export declare const TELEMETRY_PROPERTIES: {
+    readonly deploymentId: {
+        readonly index: 1;
+        readonly name: "DeploymentId";
+        readonly scope: "visit";
+    };
+    readonly organizationId: {
+        readonly index: 2;
+        readonly name: "OrganizationId";
+        readonly scope: "visit";
+    };
+    readonly sessionId: {
+        readonly index: 3;
+        readonly name: "SessionId";
+        readonly scope: "visit";
+    };
+    readonly revHash: {
+        readonly index: 4;
+        readonly name: "RevHash";
+        readonly scope: "visit";
+    };
+    readonly isExport: {
+        readonly index: 5;
+        readonly name: "isExport";
+        readonly scope: "visit";
+    };
+    readonly hostReactVersion: {
+        readonly index: 6;
+        readonly name: "HostReactVersion";
+        readonly scope: "visit";
+    };
+    readonly hostSdkVersion: {
+        readonly index: 7;
+        readonly name: "HostSdkVersion";
+        readonly scope: "visit";
+    };
+    readonly multivalue: {
+        readonly index: 1;
+        readonly name: "Multivalue";
+        readonly scope: "page";
+    };
+    readonly statsValue: {
+        readonly index: 2;
+        readonly name: "StatsValue";
+        readonly scope: "page";
+    };
+    readonly moduleReactVersion: {
+        readonly index: 3;
+        readonly name: "ModuleReactVersion";
+        readonly scope: "page";
+    };
+    readonly moduleSdkVersion: {
+        readonly index: 4;
+        readonly name: "ModuleSdkVersion";
+        readonly scope: "page";
+    };
+};
+//# sourceMappingURL=telemetryProperties.d.ts.map

package/esm/telemetry/telemetryProperties.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetryProperties.d.ts","sourceRoot":"","sources":["../../src/telemetry/telemetryProperties.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,MAAM,sBAAsB,GAAG,OAAO,GAAG,MAAM,CAAC;AAEtD;;;;;;;;GAQG;AACH,MAAM,WAAW,sBAAsB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,sBAAsB,CAAC;CACjC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAY0B,CAAC"}

package/esm/telemetry/telemetryProperties.js

@@ -0,0 +1,40 @@
+// (C) 2026 GoodData Corporation
+/**
+ * Canonical, single-source-of-truth allocation of the shell's telemetry property slots, so a given
+ * `(scope, index)` means the same thing everywhere it is reported.
+ *
+ * @remarks
+ * The shell's analytics backend aggregates properties by `(scope, index)`, not by the name passed at call
+ * time — so the index is the contract, and slots must be sourced from here rather than assigned by array
+ * position.
+ *
+ * This registry is **shell-owned**: only the host shell consumes it when serializing telemetry. Pluggable
+ * modules never reference it — they forward transport-neutral telemetry (see the `identifiers` / `stats`
+ * groups on {@link IPluggableAppTelemetryEventData}) and the host alone maps that onto the packed page
+ * slots below. (The legacy standalone trackers still read it directly until standalone mode is removed.)
+ *
+ * Page slots:
+ * - `Multivalue` (1) — packed `key1=v1,…` of the event's sensitive identifiers (the shell hashes them).
+ * - `StatsValue` (2) — packed `key1=v1,…` of the event's contextual stats/metrics (verbatim).
+ * - `ModuleReactVersion` / `ModuleSdkVersion` (3/4) — the emitting module's runtime versions.
+ *
+ * Both packed values are bounded to ~200 chars by the backend. Module React / SDK versions use `"page"`
+ * scope (not `"visit"`): the active pluggable module can change within a session as the user navigates
+ * between apps, so the version is an action-level attribute that must ride only the event it describes.
+ * (The host's own React / SDK versions are constant per session, so they stay in `"visit"` scope at 6/7.)
+ *
+ * @alpha
+ */
+export const TELEMETRY_PROPERTIES = {
+    deploymentId: { index: 1, name: "DeploymentId", scope: "visit" },
+    organizationId: { index: 2, name: "OrganizationId", scope: "visit" },
+    sessionId: { index: 3, name: "SessionId", scope: "visit" },
+    revHash: { index: 4, name: "RevHash", scope: "visit" },
+    isExport: { index: 5, name: "isExport", scope: "visit" },
+    hostReactVersion: { index: 6, name: "HostReactVersion", scope: "visit" },
+    hostSdkVersion: { index: 7, name: "HostSdkVersion", scope: "visit" },
+    multivalue: { index: 1, name: "Multivalue", scope: "page" },
+    statsValue: { index: 2, name: "StatsValue", scope: "page" },
+    moduleReactVersion: { index: 3, name: "ModuleReactVersion", scope: "page" },
+    moduleSdkVersion: { index: 4, name: "ModuleSdkVersion", scope: "page" },
+};

package/esm/tsdoc-metadata.json

@@ -5,7 +5,7 @@
   "toolPackages": [
     {
       "packageName": "@microsoft/api-extractor",
-      "packageVersion": "7.58.7"
+      "packageVersion": "7.58.9"
     }
   ]
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gooddata/sdk-pluggable-application-model",
-  "version": "11.43.0-alpha.0",
+  "version": "11.43.0-alpha.2",
   "description": "GoodData SDK model contracts for pluggable applications",
   "license": "MIT",
   "author": "GoodData Corporation",
@@ -23,7 +23,7 @@
   "dependencies": {
     "ts-invariant": "0.10.3",
     "tslib": "2.8.1",
-    "@gooddata/sdk-model": "11.43.0-alpha.0"
+    "@gooddata/sdk-model": "11.43.0-alpha.2"
   },
   "devDependencies": {
     "@microsoft/api-documenter": "^7.17.0",
@@ -47,8 +47,8 @@
     "oxlint-tsgolint": "0.15.0",
     "typescript": "5.9.3",
     "vitest": "4.1.8",
-    "@gooddata/eslint-config": "11.43.0-alpha.0",
-    "@gooddata/oxlint-config": "11.43.0-alpha.0"
+    "@gooddata/eslint-config": "11.43.0-alpha.2",
+    "@gooddata/oxlint-config": "11.43.0-alpha.2"
   },
   "scripts": {
     "_phase:build": "npm run build",