@gooddata/sdk-backend-base 11.56.0-alpha.7 → 11.56.0

package/esm/cachingBackend/index.d.ts

@@ -408,6 +408,21 @@ export type CachingConfiguration = {
      * When non-positive number is specified, then no caching of attribute element results will be done.
      */
     maxAttributeElementResultsPerWorkspace?: number;
+    /**
+     * Maximum number of elements in an element list that may be searched locally.
+     *
+     * A query with a `filter` normally always goes to the backend. When the elements of the same attribute
+     * were already loaded in full and there are no more than this many of them, the filter is instead applied
+     * to that list in memory, which spares the backend a request per keystroke. Clearing the filter is
+     * answered from the same list. Above this many elements the query goes to the backend as before.
+     *
+     * The number of lists kept is bounded by `maxAttributeElementResultsPerWorkspace`, and local filtering is
+     * only done when that cache is enabled too.
+     *
+     * When no maximum number is specified, or the specified number is non-positive, then no local filtering
+     * will be done.
+     */
+    maxAttributeElementsForLocalFiltering?: number;
     /**
      * Maximum number of settings for a workspace and for a user to cache per workspace.
      *

package/esm/cachingBackend/index.d.ts.map

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

package/esm/cachingBackend/index.js

@@ -22,6 +22,7 @@ import { DecoratedSecuritySettingsService } from "../decoratedBackend/securitySe
 import { DecoratedWorkspaceExportTemplatesService } from "../decoratedBackend/workspaceExportTemplates.js";
 import { DecoratedWorkspaceSettingsService } from "../decoratedBackend/workspaceSettings.js";
 import { mergeBbox } from "../toolkit/geoItems.js";
+import { InMemoryPaging } from "../toolkit/paging.js";
 //
 // Execution caching
 //
@@ -679,6 +680,48 @@ function elementsCacheKey(ref, settings) {
     const fingerprint = stringify(settings) || "undefined";
     return new SparkMD5().append(objRefToString(ref)).append(fingerprint).end();
 }
+/**
+ * Cache key of the complete element list a search over the same elements can be answered from. Paging and the
+ * options that only narrow an already loaded list are left out, so that a search finds what the unfiltered
+ * load stored; everything that decides which elements exist at all stays in.
+ */
+function completeElementsCacheKey(ref, settings) {
+    const { limit: _limit, offset: _offset, signal: _signal, options, ...rest } = settings;
+    const { filter: _filter, complement: _complement, cacheId: _cacheId, ...restOptions } = options ?? {};
+    return elementsCacheKey(ref, { ...rest, options: restOptions });
+}
+/**
+ * Options that make the backend match against something other than the loaded titles, or return more than the
+ * elements themselves, cannot be honored locally.
+ */
+function canFilterLocally(options) {
+    return !options?.elements && !options?.filterByPrimaryLabel && !options?.includeTotalCountWithoutFilters;
+}
+/**
+ * Pages over locally filtered elements. Carries the cacheId of the backend result the elements came from, so
+ * that a later backend query can still reuse the same server-side result.
+ */
+class LocallyFilteredElements extends InMemoryPaging {
+    cacheId;
+    constructor(allItems, limit, offset, cacheId) {
+        super(allItems, limit, offset);
+        this.cacheId = cacheId;
+    }
+    async next() {
+        if (this.items.length === 0) {
+            return this;
+        }
+        return new LocallyFilteredElements(this.allItems, this.limit, this.offset + this.items.length, this.cacheId);
+    }
+    async goTo(pageIndex) {
+        if (this.items.length === 0) {
+            return this;
+        }
+        // Paged by the requested limit, the way a server-backed result pages, rather than by how full the
+        // current page happens to be.
+        return new LocallyFilteredElements(this.allItems, this.limit, pageIndex * this.limit, this.cacheId);
+    }
+}
 /**
  * Returns the identifier- and uri-based cache keys for the given ref. A ref yields at most one of the two.
  */
@@ -728,11 +771,22 @@ function getOrCreateAttributeCache(ctx, workspace) {
             computedAttributes: new LRUCache({
                 max: ctx.config.maxAttributesPerWorkspace,
             }),
+            computedAttributeExpressionTokens: new LRUCache({
+                max: ctx.config.maxAttributesPerWorkspace,
+            }),
             attributeElementResults: cachingEnabled(ctx.config.maxAttributeElementResultsPerWorkspace)
                 ? new LRUCache({
                     max: ctx.config.maxAttributeElementResultsPerWorkspace,
                 })
                 : undefined,
+            // Bounded by the same limit as the element results it is populated from, and only ever reached
+            // through the element result cache, so it is off whenever that one is.
+            completeAttributeElements: cachingEnabled(ctx.config.maxAttributeElementsForLocalFiltering) &&
+                cachingEnabled(ctx.config.maxAttributeElementResultsPerWorkspace)
+                ? new LRUCache({
+                    max: ctx.config.maxAttributeElementResultsPerWorkspace,
+                })
+                : undefined,
         };
         cache.set(workspace, cacheEntry);
     }
@@ -749,10 +803,84 @@ class CachedElementsQuery extends DecoratedElementsQuery {
         this.ref = ref;
     }
     query = async () => {
-        const canCache = !this.settings.options?.filter;
-        if (!canCache) {
+        const local = this.queryLocally();
+        if (local) {
+            return local;
+        }
+        if (this.settings.options?.filter) {
             return super.query();
         }
+        const result = await this.queryCached();
+        this.rememberCompleteElements(result);
+        return result;
+    };
+    /**
+     * Answers from an element list already loaded in full, without asking the backend. Covers both a search
+     * over that list and the unfiltered query a cleared search makes, which is the same query the list came
+     * from. Returns undefined when there is no such list, or when the query asks for something it cannot
+     * answer.
+     */
+    queryLocally() {
+        const { limit, offset = 0, options } = this.settings;
+        const filter = options?.filter;
+        const maxElements = this.ctx.config.maxAttributeElementsForLocalFiltering;
+        // A page the local path cannot represent is left to the backend to accept or reject, so that the
+        // decorator never turns a backend's answer into a local failure. Without an explicit limit there is
+        // no page size to honor either - the backend's own default is not known here.
+        if (limit === undefined || limit <= 0 || offset < 0) {
+            return undefined;
+        }
+        if (!cachingEnabled(maxElements) || !canFilterLocally(options)) {
+            return undefined;
+        }
+        // `%` and `_` are wildcards in the pattern the backend matches with and are deliberately left
+        // unescaped there, so a pattern containing either means something a substring match would get wrong.
+        if (filter?.includes("%") || filter?.includes("_")) {
+            return undefined;
+        }
+        const cache = getOrCreateAttributeCache(this.ctx, this.workspace).completeAttributeElements;
+        const complete = cache?.get(completeElementsCacheKey(this.ref, this.settings));
+        if (!complete || complete.items.length > maxElements) {
+            return undefined;
+        }
+        // A caller naming a result keeps the elements of that result, not of whichever one happens to be
+        // loaded. The list can still answer the query that has yet to be given a result to hold on to.
+        if (options?.cacheId !== undefined && options.cacheId !== complete.cacheId) {
+            return undefined;
+        }
+        return new LocallyFilteredElements(this.matching(complete.items), limit, offset, complete.cacheId);
+    }
+    matching(elements) {
+        const { filter, complement = false } = this.settings.options ?? {};
+        if (!filter) {
+            return elements;
+        }
+        const needle = filter.toLowerCase();
+        // Matching goes against the title even where formattedTitle is what the user reads, because that is
+        // what the backend matches. An element without a title matches neither the pattern nor its negation,
+        // the same as SQL NULL against (NOT) ILIKE.
+        return elements.filter((element) => typeof element.title === "string" &&
+            element.title.toLowerCase().includes(needle) !== complement);
+    }
+    /**
+     * Keeps an element list the backend returned in full, so that a later search over it can be answered
+     * locally. A page of a longer list says nothing about the elements it does not contain.
+     */
+    rememberCompleteElements(result) {
+        const maxElements = this.ctx.config.maxAttributeElementsForLocalFiltering;
+        if (!cachingEnabled(maxElements) ||
+            result.offset !== 0 ||
+            result.items.length !== result.totalCount ||
+            result.items.length > maxElements) {
+            return;
+        }
+        const cache = getOrCreateAttributeCache(this.ctx, this.workspace).completeAttributeElements;
+        cache?.set(completeElementsCacheKey(this.ref, this.settings), {
+            items: result.items,
+            cacheId: result.cacheId,
+        });
+    }
+    async queryCached() {
         const cache = getOrCreateAttributeCache(this.ctx, this.workspace).attributeElementResults;
         invariant(cache, "inconsistent attribute element cache config");
         const cacheKey = elementsCacheKey(this.ref, this.settings);
@@ -782,7 +910,7 @@ class CachedElementsQuery extends DecoratedElementsQuery {
             return promise;
         }
         return result;
-    };
+    }
     createNew(decorated, settings) {
         return new CachedElementsQuery(decorated, this.ctx, this.workspace, this.ref, settings);
     }
@@ -1081,26 +1209,20 @@ class WithAttributesCaching extends DecoratedWorkspaceAttributesService {
         }
         return result;
     };
-    getConnectedAttributesByDisplayForm = (ref) => {
+    getConnectedAttributesByDisplayForm = (ref, options) => {
         const cache = getOrCreateAttributeCache(this.ctx, this.workspace).connectedAttributes;
-        const { idCacheKey, uriCacheKey } = refCacheKeys(ref);
-        let cacheItem = firstDefined([idCacheKey, uriCacheKey].map((key) => key && cache.get(key)));
+        // The ref is serialized rather than reduced to its identifier: a computed attribute's
+        // display form and a label may share an id, and this cache must not conflate them. The
+        // option changes the result set, so it is part of the key too.
+        const optionsSuffix = options?.includeComputedAttributes ? ":withComputedAttributes" : "";
+        const cacheKey = `${serializeObjRef(ref)}${optionsSuffix}`;
+        let cacheItem = cache.get(cacheKey);
         if (!cacheItem) {
-            cacheItem = super.getConnectedAttributesByDisplayForm(ref).catch((e) => {
-                if (idCacheKey) {
-                    cache.delete(idCacheKey);
-                }
-                if (uriCacheKey) {
-                    cache.delete(uriCacheKey);
-                }
+            cacheItem = super.getConnectedAttributesByDisplayForm(ref, options).catch((e) => {
+                cache.delete(cacheKey);
                 throw e;
             });
-            if (idCacheKey) {
-                cache.set(idCacheKey, cacheItem);
-            }
-            if (uriCacheKey) {
-                cache.set(uriCacheKey, cacheItem);
-            }
+            cache.set(cacheKey, cacheItem);
         }
         return cacheItem;
     };
@@ -1993,7 +2115,9 @@ class WithComputedAttributesCaching extends DecoratedWorkspaceComputedAttributes
     // (loadUserData), and computed-attribute writes are rare management actions, so one refetch
     // beats chasing every key shape. Same stance as the automations caching above.
     invalidateComputedAttributes = () => {
-        getOrCreateAttributeCache(this.ctx, this.workspace).computedAttributes.clear();
+        const cacheEntry = getOrCreateAttributeCache(this.ctx, this.workspace);
+        cacheEntry.computedAttributes.clear();
+        cacheEntry.computedAttributeExpressionTokens.clear();
     };
     createComputedAttribute = async (computedAttribute) => {
         const result = await super.createComputedAttribute(computedAttribute);
@@ -2030,6 +2154,19 @@ class WithComputedAttributesCaching extends DecoratedWorkspaceComputedAttributes
         }
         return cacheItem;
     };
+    getComputedAttributeExpressionTokens = async (ref) => {
+        const cache = getOrCreateAttributeCache(this.ctx, this.workspace).computedAttributeExpressionTokens;
+        const cacheKey = serializeObjRef(ref);
+        let cacheItem = cache.get(cacheKey);
+        if (!cacheItem) {
+            cacheItem = super.getComputedAttributeExpressionTokens(ref).catch((e) => {
+                cache.delete(cacheKey);
+                throw e;
+            });
+            cache.set(cacheKey, cacheItem);
+        }
+        return cacheItem;
+    };
 }
 function cachedComputedAttributes(ctx) {
     return (original, workspace) => new WithComputedAttributesCaching(original, ctx, workspace);
@@ -2196,6 +2333,7 @@ export const RecommendedCachingConfiguration = {
     maxCommonAttributesPerWorkspace: 500,
     maxConnectedAttributesPerWorkspace: 500,
     maxAttributeElementResultsPerWorkspace: 100,
+    maxAttributeElementsForLocalFiltering: 500,
     maxWorkspaceSettings: 1,
     maxAutomationsWorkspaces: 1,
     maxInsightsPerWorkspace: 50,

package/esm/decoratedBackend/attributes.d.ts

@@ -1,4 +1,4 @@
-import { type IAttributeWithReferences, type IAttributesQuery, type IElementsQueryFactory, type IWorkspaceAttributesService } from "@gooddata/sdk-backend-spi";
+import { type IAttributeWithReferences, type IAttributesQuery, type IConnectedAttributesOptions, type IElementsQueryFactory, type IWorkspaceAttributesService } from "@gooddata/sdk-backend-spi";
 import { type IAttributeDisplayFormMetadataObject, type IAttributeMetadataObject, type IMetadataObject, type IMetadataObjectBase, type IMetadataObjectIdentity, type ObjRef } from "@gooddata/sdk-model";
 /**
  * @alpha
@@ -19,7 +19,7 @@ export declare abstract class DecoratedWorkspaceAttributesService implements IWo
     getCommonAttributesBatch(attributesRefsBatch: ObjRef[][]): Promise<ObjRef[][]>;
     getAttributeDatasetMeta(ref: ObjRef): Promise<IMetadataObject>;
     getAttributesWithReferences(refs: ObjRef[]): Promise<IAttributeWithReferences[]>;
-    getConnectedAttributesByDisplayForm(ref: ObjRef): Promise<ObjRef[]>;
+    getConnectedAttributesByDisplayForm(ref: ObjRef, options?: IConnectedAttributesOptions): Promise<ObjRef[]>;
     getAttributesQuery(): IAttributesQuery;
 }
 //# sourceMappingURL=attributes.d.ts.map

package/esm/decoratedBackend/attributes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"attributes.d.ts","sourceRoot":"","sources":["../../src/decoratedBackend/attributes.ts"],"names":[],"mappings":"AAEA,OAAO,EACH,KAAK,wBAAwB,EAC7B,KAAK,gBAAgB,EACrB,KAAK,qBAAqB,EAC1B,KAAK,2BAA2B,EACnC,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACH,KAAK,mCAAmC,EACxC,KAAK,wBAAwB,EAC7B,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,KAAK,uBAAuB,EAC5B,KAAK,MAAM,EACd,MAAM,qBAAqB,CAAC;AAE7B;;GAEG;AACH,8BAAsB,mCAAoC,YAAW,2BAA2B;IACtE,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,2BAA2B;IAA/E,SAAS,aAAgC,SAAS,EAAE,2BAA2B,EAAI;IAE5E,QAAQ,IAAI,qBAAqB,CAEvC;IAEM,uBAAuB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,mCAAmC,CAAC,CAExF;IAEM,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,mCAAmC,EAAE,CAAC,CAE9F;IAEM,YAAY,CACf,GAAG,EAAE,MAAM,EACX,IAAI,GAAE;QAAE,OAAO,CAAC,EAAE,CAAC,SAAS,CAAC,CAAA;KAAO,GACrC,OAAO,CAAC,wBAAwB,CAAC,CAEnC;IAEM,mBAAmB,CACtB,gBAAgB,EAAE,OAAO,CAAC,mBAAmB,CAAC,GAAG,uBAAuB,GACzE,OAAO,CAAC,wBAAwB,CAAC,CAEnC;IAEM,yBAAyB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAE/E;IAEM,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,wBAAwB,EAAE,CAAC,CAExE;IAEM,mBAAmB,CAAC,aAAa,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAErE;IAEM,wBAAwB,CAAC,mBAAmB,EAAE,MAAM,EAAE,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAEpF;IAEM,uBAAuB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAEpE;IAEM,2BAA2B,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,wBAAwB,EAAE,CAAC,CAEtF;IAEM,mCAAmC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAEzE;IAEM,kBAAkB,IAAI,gBAAgB,CAE5C;CACJ"}
+{"version":3,"file":"attributes.d.ts","sourceRoot":"","sources":["../../src/decoratedBackend/attributes.ts"],"names":[],"mappings":"AAEA,OAAO,EACH,KAAK,wBAAwB,EAC7B,KAAK,gBAAgB,EACrB,KAAK,2BAA2B,EAChC,KAAK,qBAAqB,EAC1B,KAAK,2BAA2B,EACnC,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACH,KAAK,mCAAmC,EACxC,KAAK,wBAAwB,EAC7B,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,KAAK,uBAAuB,EAC5B,KAAK,MAAM,EACd,MAAM,qBAAqB,CAAC;AAE7B;;GAEG;AACH,8BAAsB,mCAAoC,YAAW,2BAA2B;IACtE,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,2BAA2B;IAA/E,SAAS,aAAgC,SAAS,EAAE,2BAA2B,EAAI;IAE5E,QAAQ,IAAI,qBAAqB,CAEvC;IAEM,uBAAuB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,mCAAmC,CAAC,CAExF;IAEM,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,mCAAmC,EAAE,CAAC,CAE9F;IAEM,YAAY,CACf,GAAG,EAAE,MAAM,EACX,IAAI,GAAE;QAAE,OAAO,CAAC,EAAE,CAAC,SAAS,CAAC,CAAA;KAAO,GACrC,OAAO,CAAC,wBAAwB,CAAC,CAEnC;IAEM,mBAAmB,CACtB,gBAAgB,EAAE,OAAO,CAAC,mBAAmB,CAAC,GAAG,uBAAuB,GACzE,OAAO,CAAC,wBAAwB,CAAC,CAEnC;IAEM,yBAAyB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAE/E;IAEM,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,wBAAwB,EAAE,CAAC,CAExE;IAEM,mBAAmB,CAAC,aAAa,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAErE;IAEM,wBAAwB,CAAC,mBAAmB,EAAE,MAAM,EAAE,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAEpF;IAEM,uBAAuB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAEpE;IAEM,2BAA2B,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,wBAAwB,EAAE,CAAC,CAEtF;IAEM,mCAAmC,CACtC,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,2BAA2B,GACtC,OAAO,CAAC,MAAM,EAAE,CAAC,CAEnB;IAEM,kBAAkB,IAAI,gBAAgB,CAE5C;CACJ"}

package/esm/decoratedBackend/attributes.js

@@ -1,4 +1,4 @@
-// (C) 2021-2025 GoodData Corporation
+// (C) 2021-2026 GoodData Corporation
 /**
  * @alpha
  */
@@ -40,8 +40,8 @@ export class DecoratedWorkspaceAttributesService {
     getAttributesWithReferences(refs) {
         return this.decorated.getAttributesWithReferences(refs);
     }
-    getConnectedAttributesByDisplayForm(ref) {
-        return this.decorated.getConnectedAttributesByDisplayForm(ref);
+    getConnectedAttributesByDisplayForm(ref, options) {
+        return this.decorated.getConnectedAttributesByDisplayForm(ref, options);
     }
     getAttributesQuery() {
         return this.decorated.getAttributesQuery();

package/esm/decoratedBackend/measures.d.ts

@@ -1,4 +1,4 @@
-import { type IGetMeasureOptions, type IMeasureExpressionToken, type IMeasureKeyDrivers, type IMeasureReferencing, type IMeasuresQuery, type ISaveMeasureOptions, type IUpdateMeasureMetaPayload, type IWorkspaceMeasuresService } from "@gooddata/sdk-backend-spi";
+import { type IConnectedAttributesOptions, type IGetMeasureOptions, type IMeasureExpressionToken, type IMeasureKeyDrivers, type IMeasureReferencing, type IMeasuresQuery, type ISaveMeasureOptions, type IUpdateMeasureMetaPayload, type IWorkspaceMeasuresService } from "@gooddata/sdk-backend-spi";
 import { type IMeasure, type IMeasureMetadataObject, type IMeasureMetadataObjectDefinition, type IObjectCertificationWrite, type ObjRef } from "@gooddata/sdk-model";
 /**
  * @alpha
@@ -18,6 +18,6 @@ export declare abstract class DecoratedWorkspaceMeasuresService implements IWork
     getMeasureReferencingObjects(measureRef: ObjRef): Promise<IMeasureReferencing>;
     getMeasuresQuery(): IMeasuresQuery;
     getMeasure(ref: ObjRef, options?: IGetMeasureOptions): Promise<IMeasureMetadataObject>;
-    getConnectedAttributes(definition: IMeasure, auxMeasures?: IMeasure[]): Promise<ObjRef[]>;
+    getConnectedAttributes(definition: IMeasure, auxMeasures?: IMeasure[], options?: IConnectedAttributesOptions): Promise<ObjRef[]>;
 }
 //# sourceMappingURL=measures.d.ts.map

package/esm/decoratedBackend/measures.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"measures.d.ts","sourceRoot":"","sources":["../../src/decoratedBackend/measures.ts"],"names":[],"mappings":"AAEA,OAAO,EACH,KAAK,kBAAkB,EACvB,KAAK,uBAAuB,EAC5B,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACxB,KAAK,yBAAyB,EAC9B,KAAK,yBAAyB,EACjC,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACH,KAAK,QAAQ,EACb,KAAK,sBAAsB,EAC3B,KAAK,gCAAgC,EACrC,KAAK,yBAAyB,EAC9B,KAAK,MAAM,EACd,MAAM,qBAAqB,CAAC;AAE7B;;GAEG;AACH,8BAAsB,iCAAkC,YAAW,yBAAyB;IAClE,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,yBAAyB;IAA7E,SAAS,aAAgC,SAAS,EAAE,yBAAyB,EAAI;IAEjF,iBAAiB,CACb,OAAO,EAAE,QAAQ,EACjB,OAAO,CAAC,EAAE;QACN,aAAa,EAAE,KAAK,GAAG,MAAM,CAAC;KACjC,GACF,OAAO,CAAC,kBAAkB,CAAC,CAE7B;IAED,0BAA0B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,EAAE,CAAC,CAE1E;IAED,aAAa,CACT,OAAO,EAAE,gCAAgC,EACzC,OAAO,CAAC,EAAE,mBAAmB,GAC9B,OAAO,CAAC,sBAAsB,CAAC,CAEjC;IAED,aAAa,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAE9E;IAED,iBAAiB,CAAC,OAAO,EAAE,yBAAyB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAErF;IAED,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,yBAAyB,GAAG,OAAO,CAAC,IAAI,CAAC,CAEtF;IAED,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C;IAED,4BAA4B,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAE7E;IAED,gBAAgB,IAAI,cAAc,CAEjC;IAED,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAErF;IAED,sBAAsB,CAAC,UAAU,EAAE,QAAQ,EAAE,WAAW,CAAC,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAExF;CACJ"}
+{"version":3,"file":"measures.d.ts","sourceRoot":"","sources":["../../src/decoratedBackend/measures.ts"],"names":[],"mappings":"AAEA,OAAO,EACH,KAAK,2BAA2B,EAChC,KAAK,kBAAkB,EACvB,KAAK,uBAAuB,EAC5B,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACxB,KAAK,yBAAyB,EAC9B,KAAK,yBAAyB,EACjC,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACH,KAAK,QAAQ,EACb,KAAK,sBAAsB,EAC3B,KAAK,gCAAgC,EACrC,KAAK,yBAAyB,EAC9B,KAAK,MAAM,EACd,MAAM,qBAAqB,CAAC;AAE7B;;GAEG;AACH,8BAAsB,iCAAkC,YAAW,yBAAyB;IAClE,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,yBAAyB;IAA7E,SAAS,aAAgC,SAAS,EAAE,yBAAyB,EAAI;IAEjF,iBAAiB,CACb,OAAO,EAAE,QAAQ,EACjB,OAAO,CAAC,EAAE;QACN,aAAa,EAAE,KAAK,GAAG,MAAM,CAAC;KACjC,GACF,OAAO,CAAC,kBAAkB,CAAC,CAE7B;IAED,0BAA0B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,EAAE,CAAC,CAE1E;IAED,aAAa,CACT,OAAO,EAAE,gCAAgC,EACzC,OAAO,CAAC,EAAE,mBAAmB,GAC9B,OAAO,CAAC,sBAAsB,CAAC,CAEjC;IAED,aAAa,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAE9E;IAED,iBAAiB,CAAC,OAAO,EAAE,yBAAyB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAErF;IAED,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,yBAAyB,GAAG,OAAO,CAAC,IAAI,CAAC,CAEtF;IAED,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C;IAED,4BAA4B,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAE7E;IAED,gBAAgB,IAAI,cAAc,CAEjC;IAED,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAErF;IAED,sBAAsB,CAClB,UAAU,EAAE,QAAQ,EACpB,WAAW,CAAC,EAAE,QAAQ,EAAE,EACxB,OAAO,CAAC,EAAE,2BAA2B,GACtC,OAAO,CAAC,MAAM,EAAE,CAAC,CAEnB;CACJ"}

package/esm/decoratedBackend/measures.js

@@ -37,7 +37,7 @@ export class DecoratedWorkspaceMeasuresService {
     getMeasure(ref, options) {
         return this.decorated.getMeasure(ref, options);
     }
-    getConnectedAttributes(definition, auxMeasures) {
-        return this.decorated.getConnectedAttributes(definition, auxMeasures);
+    getConnectedAttributes(definition, auxMeasures, options) {
+        return this.decorated.getConnectedAttributes(definition, auxMeasures, options);
     }
 }

package/esm/sdk-backend-base.d.ts

@@ -854,6 +854,21 @@ export declare type CachingConfiguration = {
      * When non-positive number is specified, then no caching of attribute element results will be done.
      */
     maxAttributeElementResultsPerWorkspace?: number;
+    /**
+     * Maximum number of elements in an element list that may be searched locally.
+     *
+     * A query with a `filter` normally always goes to the backend. When the elements of the same attribute
+     * were already loaded in full and there are no more than this many of them, the filter is instead applied
+     * to that list in memory, which spares the backend a request per keystroke. Clearing the filter is
+     * answered from the same list. Above this many elements the query goes to the backend as before.
+     *
+     * The number of lists kept is bounded by `maxAttributeElementResultsPerWorkspace`, and local filtering is
+     * only done when that cache is enabled too.
+     *
+     * When no maximum number is specified, or the specified number is non-positive, then no local filtering
+     * will be done.
+     */
+    maxAttributeElementsForLocalFiltering?: number;
     /**
      * Maximum number of settings for a workspace and for a user to cache per workspace.
      *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gooddata/sdk-backend-base",
-  "version": "11.56.0-alpha.7",
+  "version": "11.56.0",
   "description": "GoodData.UI SDK - Base for backend implementations",
   "license": "MIT",
   "author": "GoodData",
@@ -29,9 +29,9 @@
     "ts-invariant": "0.10.3",
     "tslib": "2.8.1",
     "uuid": "11.1.1",
-    "@gooddata/sdk-backend-spi": "11.56.0-alpha.7",
-    "@gooddata/sdk-model": "11.56.0-alpha.7",
-    "@gooddata/util": "11.56.0-alpha.7"
+    "@gooddata/sdk-backend-spi": "11.56.0",
+    "@gooddata/util": "11.56.0",
+    "@gooddata/sdk-model": "11.56.0"
   },
   "devDependencies": {
     "@microsoft/api-documenter": "7.30.10",
@@ -53,9 +53,9 @@
     "oxlint-tsgolint": "0.15.0",
     "typescript": "7.0.2",
     "vitest": "4.1.8",
-    "@gooddata/oxlint-config": "11.56.0-alpha.7",
-    "@gooddata/eslint-config": "11.56.0-alpha.7",
-    "@gooddata/reference-workspace": "11.56.0-alpha.7"
+    "@gooddata/oxlint-config": "11.56.0",
+    "@gooddata/reference-workspace": "11.56.0",
+    "@gooddata/eslint-config": "11.56.0"
   },
   "scripts": {
     "_phase:build": "npm run build",