@gooddata/sdk-embedding 11.39.0-alpha.0 → 11.39.0-alpha.2

package/esm/iframe/EmbeddedGdc.d.ts

@@ -1,5 +1,5 @@
 import { type DashboardAttributeFilterConfigMode, type DashboardDateFilterConfigMode, type ILowerBoundedFilter, type IUpperBoundedFilter } from "@gooddata/sdk-model";
-import { type ILocalIdentifierQualifier, type IObjIdentifierQualifier, type ObjQualifier, type RankingFilterOperator } from "./legacyTypes.js";
+import { type ILocalIdentifierQualifier, type IObjIdentifierQualifier, type MeasureValueFilterCondition, type ObjQualifier, type RankingFilterOperator } from "./legacyTypes.js";
 /**
  * Attribute filter config with props non relevant for execution, but important for UI.
  * @public
@@ -121,6 +121,27 @@ export interface IRankingFilter {
         value: number;
     };
 }
+/**
+ * Measure value (numeric) filter exchanged via the postMessage embedding API.
+ *
+ * @remarks
+ * Used by KD/AD embedding to set, change or clear measure value filter conditions on a dashboard.
+ * Dashboards apply the condition only to an existing MVF — embedded clients cannot add new MVFs
+ * via postMessage. The measure is identified by a catalog identifier (Tiger backend; URI
+ * references are not supported). When the dashboard holds multiple MVFs for the same metric,
+ * `localIdentifier` disambiguates which one is targeted; without it the dashboard matches by
+ * metric only and silently ignores the change if more than one filter exists for that metric.
+ * Conditions are OR-ed; an empty array (or omitted property) clears the filter.
+ *
+ * @public
+ */
+export interface IMeasureValueFilter {
+    measureValueFilter: {
+        measure: IObjIdentifierQualifier;
+        localIdentifier?: string;
+        conditions?: MeasureValueFilterCondition[];
+    };
+}
 /**
  * @public
  */
@@ -132,7 +153,7 @@ export type DateFilterItem = IAbsoluteDateFilter | IRelativeDateFilter;
 /**
  * @public
  */
-export type FilterItem = DateFilterItem | AttributeFilterItem | IRankingFilter;
+export type FilterItem = DateFilterItem | AttributeFilterItem | IRankingFilter | IMeasureValueFilter;
 /**
  * @public
  */
@@ -155,10 +176,23 @@ export interface IRemoveAttributeFilterItem {
 export interface IRemoveRankingFilterItem {
     removeRankingFilter: unknown;
 }
+/**
+ * Removes the conditions of a measure value filter on the dashboard, identified by its target
+ * catalog metric identifier (Tiger backend; URI references are not supported). When the dashboard
+ * holds multiple MVFs for the same metric, `localIdentifier` disambiguates which one is targeted.
+ *
+ * @public
+ */
+export interface IRemoveMeasureValueFilterItem {
+    removeMeasureValueFilter: {
+        measure: IObjIdentifierQualifier;
+        localIdentifier?: string;
+    };
+}
 /**
  * @public
  */
-export type RemoveFilterItem = IRemoveDateFilterItem | IRemoveAttributeFilterItem | IRemoveRankingFilterItem;
+export type RemoveFilterItem = IRemoveDateFilterItem | IRemoveAttributeFilterItem | IRemoveRankingFilterItem | IRemoveMeasureValueFilterItem;
 /**
  * @public
  */
@@ -187,6 +221,10 @@ export declare function isNegativeAttributeFilter(filter: unknown): filter is IN
  * @public
  */
 export declare function isRankingFilter(filter: unknown): filter is IRankingFilter;
+/**
+ * @public
+ */
+export declare function isMeasureValueFilter(filter: unknown): filter is IMeasureValueFilter;
 /**
  * @public
  */
@@ -223,6 +261,10 @@ export declare function isRemoveAttributeFilter(filter: unknown): filter is IRem
  * @public
  */
 export declare function isRemoveRankingFilter(filter: unknown): filter is IRemoveRankingFilterItem;
+/**
+ * @public
+ */
+export declare function isRemoveMeasureValueFilter(filter: unknown): filter is IRemoveMeasureValueFilterItem;
 /**
  * @public
  */

package/esm/iframe/EmbeddedGdc.js

@@ -46,6 +46,12 @@ export function isNegativeAttributeFilter(filter) {
 export function isRankingFilter(filter) {
     return !isEmpty(filter) && filter.rankingFilter !== undefined;
 }
+/**
+ * @public
+ */
+export function isMeasureValueFilter(filter) {
+    return !isEmpty(filter) && filter.measureValueFilter !== undefined;
+}
 /**
  * @public
  */
@@ -76,6 +82,12 @@ export function isRemoveAttributeFilter(filter) {
 export function isRemoveRankingFilter(filter) {
     return !isEmpty(filter) && filter.removeRankingFilter !== undefined;
 }
+/**
+ * @public
+ */
+export function isRemoveMeasureValueFilter(filter) {
+    return (!isEmpty(filter) && filter.removeMeasureValueFilter !== undefined);
+}
 /**
  * @public
  */

package/esm/index.d.ts

@@ -7,7 +7,7 @@
  *
  * @packageDocumentation
  */
-export { type IAttributeFilterConfig, type IPositiveAttributeFilter, type INegativeAttributeFilter, type IAbsoluteDateFilter, type IRelativeDateFilter, type IRankingFilter, type IArbitraryAttributeFilterItem, type IMatchAttributeFilterItem, type AttributeFilterItem, type DateFilterItem, type FilterItem, type AttributeFilterItemSelectionMode, type IRemoveDateFilterItem, type IRemoveAttributeFilterItem, type IRemoveRankingFilterItem, type RemoveFilterItem, type IFilterContextContent, type IRemoveFilterContextContent, type AllTimeType, type AbsoluteType, type RelativeType, type DateString, type DateFilterGranularity, type IDashboardAllTimeDateFilter, type IDashboardAbsoluteDateFilter, type IDashboardRelativeDateFilter, type DashboardDateFilter, type IDashboardAttributeFilter, type IResolvedAttributeFilterValues, type IResolvedDateFilterValue, type ResolvedDateFilterValues, type IResolvedFilterValues, isDateFilter, isRelativeDateFilter, isAbsoluteDateFilter, isAttributeFilter, isPositiveAttributeFilter, isNegativeAttributeFilter, isRankingFilter, isArbitraryAttributeFilterItem, isMatchAttributeFilterItem, isRemoveDateFilter, isRemoveAttributeFilter, isRemoveRankingFilter, isDashboardDateFilter, isDashboardAllTimeDateFilter, isDashboardAbsoluteDateFilter, isDashboardRelativeDateFilter, isDashboardAttributeFilter, type IDashboardArbitraryAttributeFilter, isDashboardArbitraryAttributeFilter, type IDashboardMatchAttributeFilter, isDashboardMatchAttributeFilter, type DashboardTextAttributeFilter, } from "./iframe/EmbeddedGdc.js";
+export { type IAttributeFilterConfig, type IPositiveAttributeFilter, type INegativeAttributeFilter, type IAbsoluteDateFilter, type IRelativeDateFilter, type IRankingFilter, type IMeasureValueFilter, type IArbitraryAttributeFilterItem, type IMatchAttributeFilterItem, type AttributeFilterItem, type DateFilterItem, type FilterItem, type AttributeFilterItemSelectionMode, type IRemoveDateFilterItem, type IRemoveAttributeFilterItem, type IRemoveRankingFilterItem, type IRemoveMeasureValueFilterItem, type RemoveFilterItem, type IFilterContextContent, type IRemoveFilterContextContent, type AllTimeType, type AbsoluteType, type RelativeType, type DateString, type DateFilterGranularity, type IDashboardAllTimeDateFilter, type IDashboardAbsoluteDateFilter, type IDashboardRelativeDateFilter, type DashboardDateFilter, type IDashboardAttributeFilter, type IResolvedAttributeFilterValues, type IResolvedDateFilterValue, type ResolvedDateFilterValues, type IResolvedFilterValues, isDateFilter, isRelativeDateFilter, isAbsoluteDateFilter, isAttributeFilter, isPositiveAttributeFilter, isNegativeAttributeFilter, isRankingFilter, isMeasureValueFilter, isArbitraryAttributeFilterItem, isMatchAttributeFilterItem, isRemoveDateFilter, isRemoveAttributeFilter, isRemoveRankingFilter, isRemoveMeasureValueFilter, isDashboardDateFilter, isDashboardAllTimeDateFilter, isDashboardAbsoluteDateFilter, isDashboardRelativeDateFilter, isDashboardAttributeFilter, type IDashboardArbitraryAttributeFilter, isDashboardArbitraryAttributeFilter, type IDashboardMatchAttributeFilter, isDashboardMatchAttributeFilter, type DashboardTextAttributeFilter, } from "./iframe/EmbeddedGdc.js";
 export { type IInsightExportConfig, type IGdcAdMessageEvent, type IGdcAdMessageEnvelope, type AdCommandFailed, type AdCommandFailedData, type AdDrillableItemsCommand, type AdDrillableItemsCommandData, type IAdOpenInsightCommandBody, type AdOpenInsightCommand, type AdOpenInsightCommandData, type AdClearCommand, type AdClearCommandData, type AdClearInsightCommand, type AdClearInsightCommandData, type AdRequestCancellationCommand, type AdRequestCancellationCommandData, type IAdSaveCommandBody, type AdSaveInsightCommand, type AdSaveInsightCommandData, type IAdSaveAsInsightCommandBody, type AdSaveAsInsightCommand, type AdSaveAsInsightCommandData, type IAdExportInsightCommandBody, type AdExportInsightCommand, type AdExportInsightCommandData, type AdUndoCommand, type AdUndoCommandData, type AdRedoCommand, type AdRedoCommandData, type AdSetFilterContextCommandData, type AdSetFilterContextCommand, type AdRemoveFilterContextCommandData, type AdRemoveFilterContextCommand, type IAdAvailableCommands, type AdNewInsightInitializedBody, type AdNewInsightInitialized, type AdNewInsightInitializedData, type AdInsightOpenedBody, type AdInsightOpened, type AdInsightOpenedData, type AdInsightRenderedBody, type AdInsightRendered, type AdInsightRenderedData, type AdClearFinished, type AdClearFinishedData, type AdClearInsightFinished, type AdClearInsightFinishedData, type AdInsightSavedBody, type AdInsightSaved, type AdInsightSavedData, type AdExportFinishedBody, type AdExportFinished, type AdExportFinishedData, type AdUndoFinishedBody, type AdUndoFinished, type AdUndoFinishedData, type AdRedoFinishedBody, type AdRedoFinished, type AdRedoFinishedData, type AdSetFilterContextFinishedData, type AdRemoveFilterContextFinishedData, type AdFilterContextChangedBody, type AdFilterContextChangedData, type AdInsightChangedBody, type AdInsightChangedData, type IAdSetApiTokenBody, type AdSetApiTokenCommand, type AdSetApiTokenCommandData, type AdAttributeHierarchyModifiedCommand, type AdAttributeHierarchyModifiedCommandData, GdcAdCommandType, GdcAdEventType, isAdCommandFailedData, isAdDrillableItemsCommandData, isAdOpenInsightCommandData, isAdClearCommandData, isAdClearInsightCommandData, isAdRequestCancellationCommandData, isAdSaveInsightCommandData, isAdSaveAsInsightCommandData, isAdExportInsightCommandData, isAdUndoCommandData, isAdRedoCommandData, isAdSetFilterContextCommandData, isAdRemoveFilterContextCommandData, isAdNewInsightInitializedData, isAdInsightOpenedData, isAdInsightRenderedData, isAdClearFinishedData, isAdClearInsightFinishedData, isAdInsightSavedData, isAdExportFinishedData, isAdUndoFinishedData, isAdRedoFinishedData, isAdSetApiTokenCommandData, isAttributeHierarchyModifiedCommandData, } from "./iframe/EmbeddedAnalyticalDesigner.js";
 export { type IGdcKdMessageEvent, type IGdcKdMessageEnvelope, type IKdAvailableCommands, type IKdSaveCommandBody, type KdSaveDashboardCommand, type KdSaveDashboardCommandData, type KdSaveAsDashboardCommand, type KdSaveAsDashboardCommandData, type KdCancelEditCommand, type KdCancelEditCommandData, type KdDeleteDashboardCommand, type KdDeleteDashboardCommandData, type KdSwitchToEditCommand, type KdSwitchToEditCommandData, type KdDrillableItemsCommand, type KdDrillableItemsCommandData, type IKdSetSizeCommandBody, type KdSetSizeCommand, type KdSetSizeCommandData, type KdSetFilterContextCommandData, type KdSetFilterContextCommand, type KdRemoveFilterContextCommandData, type KdRemoveFilterContextCommand, type IKdKpiWidget, type IKdIdentifierInsightRef, type IKdUriInsightRef, type IKdInsightWidget, type IKdAddWidgetBody, type KdAddWidgetCommand, type KdAddWidgetCommandData, type KdAddFilterCommand, type KdAddFilterCommandData, type KdExportToPdfCommand, type KdExportToPdfCommandData, type IKdNoPermissionsBody, type KdNoPermissionsEventData, type IKdResizedBody, type KdResizedEventData, type IKdDashboardObjectMeta, type KdDashboardBody, type IKdDashboardCreatedData, type IKdDashboardLoadedData, type IKdDashboardUpdatedData, type IKdDashboardSavedData, type IKdDashboardDeletedData, type KdSwitchedToEditData, type KdSwitchedToViewData, type IKdPlatformBody, type KdPlatformData, type IKdInsightWidgetBody, type IKdAddedWidgetBody, type KdWidgetAddedData, type KdFilterAddedBody, type KdFilterAddedData, type KdExportToPdfFinishedBody, type KdExportToPdfFinishedData, type KdSetFilterContextFinishedData, type KdRemoveFilterContextFinishedData, type KdFilterContextChangedBody, type KdFilterContextChangedData, type KdDrillToUrlFilters, type IKdDrillToUrlStartedDataBody, type IKdDrillToUrlResolvedDataBody, type KdDrillToUrlStartedData, type KdDrillToUrlResolvedData, type IKdSetFilterParentsAttributeFilter, type KdSetFilterParentsItemFilter, type IKdSetFilterParentsItemParent, type IKdSetFilterParentsItem, type IKdSetFilterParentsDataBody, type KdSetFilterParentsCommand, type KdSetFilterParentsCommandData, type KdSetFilterParentsFinished, type KdSetFilterParentsFinishedData, type IKdSetFilterParentsFailedDataBody, type KdSetFilterParentsFailed, type KdSetFilterParentsFailedData, type IKdInsightSavedBody, type KdInsightSavedData, type KdOpenDeleteDashboardDialogCommand, type KdOpenDeleteDashboardDialogCommandData, type IKdSetApiTokenBody, type KdSetApiTokenCommand, type KdSetApiTokenCommandData, GdcKdCommandType, GdcKdEventType, KdSetFilterParentsErrorCode, isKdSaveDashboardCommandData, isKdSaveAsDashboardCommandData, isKdCancelEditCommandData, isKdSwitchToEditCommandData, isKdDrillableItemsCommandData, isKdSetSizeCommandData, isKdSetFilterContextCommandData, isKdRemoveFilterContextCommandData, isKdIdentifierInsight, isKdUriInsight, isKdAddWidgetCommandData, isKdAddFilterCommandData, isKdExportToPdfCommandData, isKdSetFilterParentsCommandData, isKdOpenDeleteDashboardDialogCommandData, isKdSetApiTokenCommandData, } from "./iframe/EmbeddedKpiDashboard.js";
 export { type ILegacyBaseExportConfig, type IVisualizationObjectRelativeDateFilter, type IVisualizationObjectAbsoluteDateFilter, type IVisualizationObjectPositiveAttributeFilter, type IVisualizationObjectNegativeAttributeFilter, type VisualizationObjectAttributeFilter, type VisualizationObjectDateFilter, type VisualizationObjectFilter, type ArithmeticMeasureOperator, type MeasureAggregation, type IPreviousPeriodDateDataSet, type IObjUriQualifier, type IObjIdentifierQualifier, type ObjQualifier, type IVisualizationObjectMeasureDefinition, type IVisualizationObjectArithmeticMeasureDefinition, type IVisualizationObjectPoPMeasureDefinition, type IVisualizationObjectPreviousPeriodMeasureDefinition, type VisualizationObjectMeasureDefinitionType, type IMeasureContent, type IVisualizationObjectMeasure, type IVisualizationObjectAttribute, type IVisualizationAttributeContent, type BucketItem, type Identifier, type TotalType, type ITotal, type IBucket, type ILocalIdentifierQualifier, type ComparisonConditionOperator, type IComparisonCondition, type RangeConditionOperator, type IRangeCondition, type MeasureValueFilterCondition, type IVisualizationObjectMeasureValueFilter, type RankingFilterOperator, type IVisualizationObjectRankingFilter, type VisualizationObjectExtendedFilter, type IReferenceItems, type IVisualizationObjectContent, type ObjectCategory, type Timestamp, type ILegacyObjectMeta, type IVisualizationObject, type IVisualization, isObjIdentifierQualifier, isObjectUriQualifier, isLocalIdentifierQualifier, } from "./iframe/legacyTypes.js";

package/esm/index.js

@@ -10,7 +10,7 @@
  * @packageDocumentation
  */
 // EmbeddedGdc
-export { isDateFilter, isRelativeDateFilter, isAbsoluteDateFilter, isAttributeFilter, isPositiveAttributeFilter, isNegativeAttributeFilter, isRankingFilter, isArbitraryAttributeFilterItem, isMatchAttributeFilterItem, isRemoveDateFilter, isRemoveAttributeFilter, isRemoveRankingFilter, isDashboardDateFilter, isDashboardAllTimeDateFilter, isDashboardAbsoluteDateFilter, isDashboardRelativeDateFilter, isDashboardAttributeFilter, isDashboardArbitraryAttributeFilter, isDashboardMatchAttributeFilter, } from "./iframe/EmbeddedGdc.js";
+export { isDateFilter, isRelativeDateFilter, isAbsoluteDateFilter, isAttributeFilter, isPositiveAttributeFilter, isNegativeAttributeFilter, isRankingFilter, isMeasureValueFilter, isArbitraryAttributeFilterItem, isMatchAttributeFilterItem, isRemoveDateFilter, isRemoveAttributeFilter, isRemoveRankingFilter, isRemoveMeasureValueFilter, isDashboardDateFilter, isDashboardAllTimeDateFilter, isDashboardAbsoluteDateFilter, isDashboardRelativeDateFilter, isDashboardAttributeFilter, isDashboardArbitraryAttributeFilter, isDashboardMatchAttributeFilter, } from "./iframe/EmbeddedGdc.js";
 // EmbeddedAnalyticalDesigner
 export { GdcAdCommandType, GdcAdEventType, isAdCommandFailedData, isAdDrillableItemsCommandData, isAdOpenInsightCommandData, isAdClearCommandData, isAdClearInsightCommandData, isAdRequestCancellationCommandData, isAdSaveInsightCommandData, isAdSaveAsInsightCommandData, isAdExportInsightCommandData, isAdUndoCommandData, isAdRedoCommandData, isAdSetFilterContextCommandData, isAdRemoveFilterContextCommandData, isAdNewInsightInitializedData, isAdInsightOpenedData, isAdInsightRenderedData, isAdClearFinishedData, isAdClearInsightFinishedData, isAdInsightSavedData, isAdExportFinishedData, isAdUndoFinishedData, isAdRedoFinishedData, isAdSetApiTokenCommandData, isAttributeHierarchyModifiedCommandData, } from "./iframe/EmbeddedAnalyticalDesigner.js";
 // EmbeddedKpiDashboard

package/esm/internal/filterConverters.d.ts

@@ -1,6 +1,6 @@
 import { type ILowerBoundedFilter, type IUpperBoundedFilter, type ObjRef } from "@gooddata/sdk-model";
 import { type DateFilterItem, type FilterItem } from "../iframe/EmbeddedGdc.js";
-import { type ObjQualifier, type RankingFilterOperator } from "../iframe/legacyTypes.js";
+import { type MeasureValueFilterCondition, type ObjQualifier, type RankingFilterOperator } from "../iframe/legacyTypes.js";
 export interface ITransformedArbitraryAttributeFilter {
     dfIdentifier: string;
     values: string[];
@@ -19,6 +19,7 @@ export interface IExternalFiltersObject {
     rankingFilter?: ITransformedRankingFilter;
     arbitraryAttributeFilters?: ITransformedArbitraryAttributeFilter[];
     matchAttributeFilters?: ITransformedMatchAttributeFilter[];
+    measureValueFilters?: ITransformedMeasureValueFilter[];
 }
 export interface ITransformedRankingFilter {
     measureLocalIdentifier: string;
@@ -26,6 +27,11 @@ export interface ITransformedRankingFilter {
     operator: RankingFilterOperator;
     value: number;
 }
+export interface ITransformedMeasureValueFilter {
+    measureIdentifier: string;
+    localIdentifier?: string;
+    conditions?: MeasureValueFilterCondition[];
+}
 export interface ITransformedDateFilterItem {
     granularity?: string;
     from: string | number;

package/esm/internal/filterConverters.js

@@ -1,7 +1,7 @@
 // (C) 2020-2026 GoodData Corporation
 import { isEmpty } from "lodash-es";
 import { idRef } from "@gooddata/sdk-model";
-import { isAbsoluteDateFilter, isArbitraryAttributeFilterItem, isAttributeFilter, isDateFilter, isMatchAttributeFilterItem, isNegativeAttributeFilter, isPositiveAttributeFilter, isRankingFilter, isRemoveAttributeFilter, isRemoveDateFilter, isRemoveRankingFilter, } from "../iframe/EmbeddedGdc.js";
+import { isAbsoluteDateFilter, isArbitraryAttributeFilterItem, isAttributeFilter, isDateFilter, isMatchAttributeFilterItem, isMeasureValueFilter, isNegativeAttributeFilter, isPositiveAttributeFilter, isRankingFilter, isRemoveAttributeFilter, isRemoveDateFilter, isRemoveMeasureValueFilter, isRemoveRankingFilter, } from "../iframe/EmbeddedGdc.js";
 import { isLocalIdentifierQualifier, isObjIdentifierQualifier, isObjectUriQualifier, } from "../iframe/legacyTypes.js";
 const EXTERNAL_DATE_FILTER_FORMAT = "YYYY-MM-DD";
 const DATE_FORMAT_REGEX = /^\d{4}-\d{2}-\d{2}$/;
@@ -84,6 +84,49 @@ function isValidRankingFilterFormat(rankingFilterItem) {
         isValidRankingFilterOperator(operator) &&
         isValidRankingFilterValue(value));
 }
+const VALID_COMPARISON_OPERATORS = [
+    "GREATER_THAN",
+    "GREATER_THAN_OR_EQUAL_TO",
+    "LESS_THAN",
+    "LESS_THAN_OR_EQUAL_TO",
+    "EQUAL_TO",
+    "NOT_EQUAL_TO",
+];
+const VALID_RANGE_OPERATORS = ["BETWEEN", "NOT_BETWEEN"];
+function isValidMeasureValueFilterCondition(condition) {
+    if (isEmpty(condition)) {
+        return false;
+    }
+    const candidate = condition;
+    if ("comparison" in candidate && candidate.comparison) {
+        const { operator, value } = candidate.comparison;
+        return VALID_COMPARISON_OPERATORS.includes(operator) && typeof value === "number";
+    }
+    if ("range" in candidate && candidate.range) {
+        const { operator, from, to } = candidate.range;
+        return VALID_RANGE_OPERATORS.includes(operator) && typeof from === "number" && typeof to === "number";
+    }
+    return false;
+}
+function isValidMeasureValueFilterFormat(filterItem) {
+    const { measure, localIdentifier, conditions } = filterItem.measureValueFilter;
+    if (isEmpty(measure) || !isObjIdentifierQualifier(measure)) {
+        return false;
+    }
+    if (localIdentifier !== undefined && typeof localIdentifier !== "string") {
+        return false;
+    }
+    // Omitted or empty `conditions` clears the filter; otherwise every entry must be a valid condition.
+    if (conditions !== undefined) {
+        if (!Array.isArray(conditions)) {
+            return false;
+        }
+        if (conditions.length > 0 && !conditions.every(isValidMeasureValueFilterCondition)) {
+            return false;
+        }
+    }
+    return true;
+}
 const VALID_MATCH_OPERATORS = ["contains", "startsWith", "endsWith"];
 function isValidArbitraryAttributeFilterFormat(filterItem) {
     const { arbitraryAttributeFilter: { displayForm, values, negativeSelection }, } = filterItem;
@@ -111,6 +154,9 @@ function isValidFilterItemFormat(filterItem, shouldValidateDataSet = true, isTim
     else if (isRankingFilter(filterItem)) {
         return isValidRankingFilterFormat(filterItem);
     }
+    else if (isMeasureValueFilter(filterItem)) {
+        return isValidMeasureValueFilterFormat(filterItem);
+    }
     return false;
 }
 function isValidRemoveFilterItemFormat(filterItem) {
@@ -127,6 +173,13 @@ function isValidRemoveFilterItemFormat(filterItem) {
     else if (isRemoveRankingFilter(filterItem)) {
         return true;
     }
+    else if (isRemoveMeasureValueFilter(filterItem)) {
+        const { measure, localIdentifier } = filterItem.removeMeasureValueFilter;
+        if (!isObjIdentifierQualifier(measure) || typeof measure.identifier !== "string") {
+            return false;
+        }
+        return localIdentifier === undefined || typeof localIdentifier === "string";
+    }
     return false;
 }
 export function isValidRemoveFiltersFormat(filters) {
@@ -235,6 +288,14 @@ function transformRankingFilterItem(rankingFilterItem) {
         operator,
     };
 }
+function transformMeasureValueFilterItem(measureValueFilterItem) {
+    const { measure, localIdentifier, conditions } = measureValueFilterItem.measureValueFilter;
+    return {
+        measureIdentifier: measure.identifier,
+        ...(localIdentifier ? { localIdentifier } : {}),
+        ...(conditions && conditions.length > 0 ? { conditions } : {}),
+    };
+}
 export function transformFilterContext(filters) {
     const defaultFiltersObject = {
         attributeFilters: [],
@@ -272,6 +333,13 @@ export function transformFilterContext(filters) {
             const rankingFilter = transformRankingFilterItem(filterItem);
             externalFilters.rankingFilter = rankingFilter;
         }
+        else if (isMeasureValueFilter(filterItem)) {
+            const measureValueFilter = transformMeasureValueFilterItem(filterItem);
+            if (!externalFilters.measureValueFilters) {
+                externalFilters.measureValueFilters = [];
+            }
+            externalFilters.measureValueFilters.push(measureValueFilter);
+        }
         return externalFilters;
     }, defaultFiltersObject);
 }

package/esm/sdk-embedding.d.ts

@@ -670,7 +670,7 @@ export declare type DateString = string;
 /**
  * @public
  */
-export declare type FilterItem = DateFilterItem | AttributeFilterItem | IRankingFilter;
+export declare type FilterItem = DateFilterItem | AttributeFilterItem | IRankingFilter | IMeasureValueFilter;
 
 /**
  * All AD command Types
@@ -1873,6 +1873,28 @@ export declare interface IMeasureContent {
     format?: string;
 }
 
+/**
+ * Measure value (numeric) filter exchanged via the postMessage embedding API.
+ *
+ * @remarks
+ * Used by KD/AD embedding to set, change or clear measure value filter conditions on a dashboard.
+ * Dashboards apply the condition only to an existing MVF — embedded clients cannot add new MVFs
+ * via postMessage. The measure is identified by a catalog identifier (Tiger backend; URI
+ * references are not supported). When the dashboard holds multiple MVFs for the same metric,
+ * `localIdentifier` disambiguates which one is targeted; without it the dashboard matches by
+ * metric only and silently ignores the change if more than one filter exists for that metric.
+ * Conditions are OR-ed; an empty array (or omitted property) clears the filter.
+ *
+ * @public
+ */
+export declare interface IMeasureValueFilter {
+    measureValueFilter: {
+        measure: IObjIdentifierQualifier;
+        localIdentifier?: string;
+        conditions?: MeasureValueFilterCondition[];
+    };
+}
+
 /**
  * @public
  */
@@ -2042,6 +2064,20 @@ export declare interface IRemoveFilterContextContent {
     filters: RemoveFilterItem[];
 }
 
+/**
+ * Removes the conditions of a measure value filter on the dashboard, identified by its target
+ * catalog metric identifier (Tiger backend; URI references are not supported). When the dashboard
+ * holds multiple MVFs for the same metric, `localIdentifier` disambiguates which one is targeted.
+ *
+ * @public
+ */
+export declare interface IRemoveMeasureValueFilterItem {
+    removeMeasureValueFilter: {
+        measure: IObjIdentifierQualifier;
+        localIdentifier?: string;
+    };
+}
+
 /**
  * @public
  */
@@ -2510,6 +2546,11 @@ export declare function isLocalIdentifierQualifier(qualifier: unknown): qualifie
  */
 export declare function isMatchAttributeFilterItem(filter: unknown): filter is IMatchAttributeFilterItem;
 
+/**
+ * @public
+ */
+export declare function isMeasureValueFilter(filter: unknown): filter is IMeasureValueFilter;
+
 /**
  * @public
  */
@@ -2550,6 +2591,11 @@ export declare function isRemoveAttributeFilter(filter: unknown): filter is IRem
  */
 export declare function isRemoveDateFilter(filter: unknown): filter is IRemoveDateFilterItem;
 
+/**
+ * @public
+ */
+export declare function isRemoveMeasureValueFilter(filter: unknown): filter is IRemoveMeasureValueFilterItem;
+
 /**
  * @public
  */
@@ -3321,7 +3367,7 @@ export declare type RelativeType = "relative";
 /**
  * @public
  */
-export declare type RemoveFilterItem = IRemoveDateFilterItem | IRemoveAttributeFilterItem | IRemoveRankingFilterItem;
+export declare type RemoveFilterItem = IRemoveDateFilterItem | IRemoveAttributeFilterItem | IRemoveRankingFilterItem | IRemoveMeasureValueFilterItem;
 
 /**
  * @public

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gooddata/sdk-embedding",
-  "version": "11.39.0-alpha.0",
+  "version": "11.39.0-alpha.2",
   "description": "GoodData Embedding APIs",
   "license": "MIT",
   "author": "GoodData",
@@ -29,7 +29,7 @@
     "lodash-es": "^4.17.23",
     "ts-invariant": "0.10.3",
     "tslib": "2.8.1",
-    "@gooddata/sdk-model": "11.39.0-alpha.0"
+    "@gooddata/sdk-model": "11.39.0-alpha.2"
   },
   "devDependencies": {
     "@microsoft/api-documenter": "^7.17.0",
@@ -53,8 +53,8 @@
     "oxlint-tsgolint": "0.11.4",
     "typescript": "5.9.3",
     "vitest": "4.1.0",
-    "@gooddata/oxlint-config": "11.39.0-alpha.0",
-    "@gooddata/eslint-config": "11.39.0-alpha.0"
+    "@gooddata/oxlint-config": "11.39.0-alpha.2",
+    "@gooddata/eslint-config": "11.39.0-alpha.2"
   },
   "scripts": {
     "_phase:build": "npm run build",