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

package/esm/iframe/EmbeddedGdc.d.ts

@@ -131,7 +131,13 @@ export interface IRankingFilter {
  * 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.
+ * Conditions are OR-ed; an empty array (or omitted property) clears the filter. `dimensionality`
+ * can define the dashboard-level granularity for the MVF; an empty array clears it.
+ *
+ * `treatNullValuesAs` is a filter-level convenience: when set, NULL metric values are treated as
+ * the given number for every condition that does not define its own `treatNullValuesAs`. The
+ * underlying model represents this per condition, so the value is folded into the conditions when
+ * the command is translated.
  *
  * @public
  */
@@ -140,6 +146,8 @@ export interface IMeasureValueFilter {
         measure: IObjIdentifierQualifier;
         localIdentifier?: string;
         conditions?: MeasureValueFilterCondition[];
+        dimensionality?: ObjQualifier[];
+        treatNullValuesAs?: number;
     };
 }
 /**

package/esm/internal/filterConverters.d.ts

@@ -31,6 +31,7 @@ export interface ITransformedMeasureValueFilter {
     measureIdentifier: string;
     localIdentifier?: string;
     conditions?: MeasureValueFilterCondition[];
+    dimensionality?: ObjQualifier[];
 }
 export interface ITransformedDateFilterItem {
     granularity?: string;

package/esm/internal/filterConverters.js

@@ -108,14 +108,24 @@ function isValidMeasureValueFilterCondition(condition) {
     }
     return false;
 }
+function isValidMeasureValueFilterDimensionality(dimensionality) {
+    return (Array.isArray(dimensionality) &&
+        dimensionality.every((item) => {
+            const { uri, identifier } = getObjectUriIdentifier(item);
+            return typeof uri === "string" || typeof identifier === "string";
+        }));
+}
 function isValidMeasureValueFilterFormat(filterItem) {
-    const { measure, localIdentifier, conditions } = filterItem.measureValueFilter;
+    const { measure, localIdentifier, conditions, dimensionality, treatNullValuesAs } = filterItem.measureValueFilter;
     if (isEmpty(measure) || !isObjIdentifierQualifier(measure)) {
         return false;
     }
     if (localIdentifier !== undefined && typeof localIdentifier !== "string") {
         return false;
     }
+    if (treatNullValuesAs !== undefined && typeof treatNullValuesAs !== "number") {
+        return false;
+    }
     // Omitted or empty `conditions` clears the filter; otherwise every entry must be a valid condition.
     if (conditions !== undefined) {
         if (!Array.isArray(conditions)) {
@@ -125,6 +135,9 @@ function isValidMeasureValueFilterFormat(filterItem) {
             return false;
         }
     }
+    if (dimensionality !== undefined && !isValidMeasureValueFilterDimensionality(dimensionality)) {
+        return false;
+    }
     return true;
 }
 const VALID_MATCH_OPERATORS = ["contains", "startsWith", "endsWith"];
@@ -289,11 +302,12 @@ function transformRankingFilterItem(rankingFilterItem) {
     };
 }
 function transformMeasureValueFilterItem(measureValueFilterItem) {
-    const { measure, localIdentifier, conditions } = measureValueFilterItem.measureValueFilter;
+    const { measure, localIdentifier, conditions, dimensionality } = measureValueFilterItem.measureValueFilter;
     return {
         measureIdentifier: measure.identifier,
         ...(localIdentifier ? { localIdentifier } : {}),
         ...(conditions && conditions.length > 0 ? { conditions } : {}),
+        ...(dimensionality && dimensionality.length > 0 ? { dimensionality } : {}),
     };
 }
 export function transformFilterContext(filters) {

package/esm/sdk-embedding.d.ts

@@ -1883,7 +1883,13 @@ export declare interface IMeasureContent {
  * 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.
+ * Conditions are OR-ed; an empty array (or omitted property) clears the filter. `dimensionality`
+ * can define the dashboard-level granularity for the MVF; an empty array clears it.
+ *
+ * `treatNullValuesAs` is a filter-level convenience: when set, NULL metric values are treated as
+ * the given number for every condition that does not define its own `treatNullValuesAs`. The
+ * underlying model represents this per condition, so the value is folded into the conditions when
+ * the command is translated.
  *
  * @public
  */
@@ -1892,6 +1898,8 @@ export declare interface IMeasureValueFilter {
         measure: IObjIdentifierQualifier;
         localIdentifier?: string;
         conditions?: MeasureValueFilterCondition[];
+        dimensionality?: ObjQualifier[];
+        treatNullValuesAs?: number;
     };
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gooddata/sdk-embedding",
-  "version": "11.39.0-alpha.2",
+  "version": "11.39.0-alpha.4",
   "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.2"
+    "@gooddata/sdk-model": "11.39.0-alpha.4"
   },
   "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.2",
-    "@gooddata/eslint-config": "11.39.0-alpha.2"
+    "@gooddata/eslint-config": "11.39.0-alpha.4",
+    "@gooddata/oxlint-config": "11.39.0-alpha.4"
   },
   "scripts": {
     "_phase:build": "npm run build",