@gooddata/sdk-backend-base 11.49.0-alpha.0 → 11.49.0

package/esm/cachingBackend/index.d.ts

@@ -29,6 +29,10 @@ export type CacheControl = {
      * Resets all workspace facts caches.
      */
     resetFacts: () => void;
+    /**
+     * Resets all workspace dataset caches.
+     */
+    resetDatasets: () => void;
     /**
      * Resets all workspace settings caches.
      */
@@ -285,6 +289,33 @@ export type CachingConfiguration = {
      * tweak the `maxMeasuresWorkspaces` value.
      */
     maxMeasuresPerWorkspace?: number;
+    /**
+     * Maximum number of workspaces for which to cache selected {@link @gooddata/sdk-backend-spi#IWorkspaceDatasetsService} calls.
+     * The workspace identifier is used as cache key.
+     * For each workspace, there will be a cache entry holding `maxDatasetsPerWorkspace` entries for dataset metadata reads.
+     *
+     * When limit is reached, cache entries will be evicted using LRU policy.
+     *
+     * When no maximum number is specified, the cache will be unbounded and no evictions will happen. Unbounded
+     * cache may be OK in applications where number of workspaces is small - the cache will be limited
+     * naturally and will not grow uncontrollably.
+     *
+     * When non-positive number is specified, then no caching will be done.
+     */
+    maxDatasetWorkspaces?: number;
+    /**
+     * Maximum number of datasets to cache per workspace.
+     *
+     * When limit is reached, cache entries will be evicted using LRU policy.
+     *
+     * When no maximum number is specified, the cache will be unbounded and no evictions will happen. Unbounded
+     * dataset cache may be OK in applications where number of datasets is small and/or they are requested
+     * infrequently - the cache will be limited naturally and will not grow uncontrollably.
+     *
+     * Setting non-positive number here is invalid. If you want to turn off dataset caching,
+     * tweak the `maxDatasetWorkspaces` value.
+     */
+    maxDatasetsPerWorkspace?: number;
     /**
      * Maximum number of organizations for which to cache organization-level export templates.
      * Organization export templates are organization-level, so typically a single entry suffices.
@@ -330,6 +361,34 @@ export type CachingConfiguration = {
      * tweak the `maxAttributeWorkspaces` value.
      */
     maxAttributesPerWorkspace?: number;
+    /**
+     * Maximum number of common attribute results to cache per workspace.
+     *
+     * This bounds the cache used by `getCommonAttributes` and `getCommonAttributesBatch`, keyed by the
+     * (order-independent) set of input attribute references.
+     *
+     * When limit is reached, cache entries will be evicted using LRU policy.
+     *
+     * When no maximum number is specified, the cache will be unbounded and no evictions will happen.
+     *
+     * Setting non-positive number here is invalid. If you want to turn off common attribute caching,
+     * tweak the `maxAttributeWorkspaces` value.
+     */
+    maxCommonAttributesPerWorkspace?: number;
+    /**
+     * Maximum number of connected attribute results to cache per workspace.
+     *
+     * This bounds the cache used by `getConnectedAttributesByDisplayForm`, keyed by the display form
+     * reference identifier/uri.
+     *
+     * When limit is reached, cache entries will be evicted using LRU policy.
+     *
+     * When no maximum number is specified, the cache will be unbounded and no evictions will happen.
+     *
+     * Setting non-positive number here is invalid. If you want to turn off connected attribute caching,
+     * tweak the `maxAttributeWorkspaces` value.
+     */
+    maxConnectedAttributesPerWorkspace?: number;
     /**
      * Maximum number of attribute element results 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

@@ -9,6 +9,7 @@ import { areObjRefsEqual, geoFeatureId, idRef, isIdentifierRef, isUriRef, objRef
 import { DecoratedWorkspaceAttributesService } from "../decoratedBackend/attributes.js";
 import { DecoratedAutomationsQuery, DecoratedWorkspaceAutomationsService, } from "../decoratedBackend/automations.js";
 import { DecoratedWorkspaceCatalogFactory } from "../decoratedBackend/catalog.js";
+import { DecoratedWorkspaceDatasetsService } from "../decoratedBackend/datasets.js";
 import { DecoratedElementsQuery, DecoratedElementsQueryFactory } from "../decoratedBackend/elements.js";
 import { DecoratedDataView, DecoratedExecutionFactory, DecoratedExecutionResult, DecoratedPreparedExecution, } from "../decoratedBackend/execution.js";
 import { DecoratedWorkspaceFactsService } from "../decoratedBackend/facts.js";
@@ -673,6 +674,23 @@ function elementsCacheKey(ref, settings) {
     const fingerprint = stringify(settings) || "undefined";
     return new SparkMD5().append(objRefToString(ref)).append(fingerprint).end();
 }
+/**
+ * Returns the identifier- and uri-based cache keys for the given ref. A ref yields at most one of the two.
+ */
+function refCacheKeys(ref) {
+    return {
+        idCacheKey: isIdentifierRef(ref) ? ref.identifier : undefined,
+        uriCacheKey: isUriRef(ref) ? ref.uri : undefined,
+    };
+}
+/**
+ * Builds a stable cache key for a set of refs. The order of refs does not matter (the refs are sorted),
+ * so callers requesting the same set in a different order share the same cache entry.
+ */
+function refSetCacheKey(refs) {
+    const serialized = refs.map(objRefToString).sort();
+    return new SparkMD5().append(stringify(serialized) || "undefined").end();
+}
 function getOrCreateAttributeCache(ctx, workspace) {
     const cache = ctx.caches.workspaceAttributes;
     let cacheEntry = cache.get(workspace);
@@ -687,6 +705,18 @@ function getOrCreateAttributeCache(ctx, workspace) {
             attributesByDisplayForms: new LRUCache({
                 max: ctx.config.maxAttributesPerWorkspace,
             }),
+            attributes: new LRUCache({
+                max: ctx.config.maxAttributesPerWorkspace,
+            }),
+            commonAttributes: new LRUCache({
+                max: (ctx.config.maxCommonAttributesPerWorkspace ?? ctx.config.maxAttributesPerWorkspace),
+            }),
+            commonAttributesBatch: new LRUCache({
+                max: (ctx.config.maxCommonAttributesPerWorkspace ?? ctx.config.maxAttributesPerWorkspace),
+            }),
+            connectedAttributes: new LRUCache({
+                max: (ctx.config.maxConnectedAttributesPerWorkspace ?? ctx.config.maxAttributesPerWorkspace),
+            }),
             attributeElementResults: cachingEnabled(ctx.config.maxAttributeElementResultsPerWorkspace)
                 ? new LRUCache({
                     max: ctx.config.maxAttributeElementResultsPerWorkspace,
@@ -793,43 +823,88 @@ class WithAttributesCaching extends DecoratedWorkspaceAttributesService {
     };
     getAttributeDisplayForms = async (refs) => {
         const cache = getOrCreateAttributeCache(this.ctx, this.workspace).displayForms;
-        // grab a reference to the cache results as soon as possible in case they would get evicted while loading the ones with missing data in cache
-        // then would might not be able to call cache.get again and be guaranteed to get the data
+        // Grab a reference to the cache results as soon as possible in case they would get evicted while
+        // loading the ones missing from the cache - then we might not be able to call cache.get again and
+        // be guaranteed to get the data.
         const refsWithCacheResults = refs.map((ref) => {
-            const idCacheKey = isIdentifierRef(ref) ? ref.identifier : undefined;
-            const uriCacheKey = isUriRef(ref) ? ref.uri : undefined;
+            const { idCacheKey, uriCacheKey } = refCacheKeys(ref);
             const cacheHit = firstDefined([idCacheKey, uriCacheKey].map((key) => key && cache.get(key)));
             return {
                 ref,
+                idCacheKey,
+                uriCacheKey,
                 cacheHit: cacheHit,
             };
         });
         const [withCacheHits, withoutCacheHits] = partition(refsWithCacheResults, ({ cacheHit }) => !!cacheHit);
         const refsToLoad = withoutCacheHits.map((item) => item.ref);
-        const [alreadyInCache, loadedFromServer] = await Promise.all([
-            // await the stuff from cache, we need the data available (we cannot just return the promises)
+        // Use a single shared load promise so that concurrent callers asking for the same uncached refs
+        // collapse onto one underlying request. Per-ref promises are derived from it and registered into
+        // the cache synchronously - before any await - so a concurrent caller sees the in-flight promise.
+        const loadPromise = refsToLoad.length
+            ? Promise.resolve(this.decorated.getAttributeDisplayForms(refsToLoad))
+            : Promise.resolve([]);
+        withoutCacheHits.forEach((item) => {
+            const perRefPromise = loadPromise
+                .then((loaded) => {
+                const match = loaded.find((df) => refMatchesMdObject(item.ref, df, "displayForm"));
+                if (!match) {
+                    // The server omitted this ref; evict so a later call can retry it and so a
+                    // resolved-undefined is never cached.
+                    if (item.idCacheKey) {
+                        cache.delete(item.idCacheKey);
+                    }
+                    if (item.uriCacheKey) {
+                        cache.delete(item.uriCacheKey);
+                    }
+                }
+                return match;
+            })
+                .catch((e) => {
+                if (item.idCacheKey) {
+                    cache.delete(item.idCacheKey);
+                }
+                if (item.uriCacheKey) {
+                    cache.delete(item.uriCacheKey);
+                }
+                throw e;
+            });
+            // Prevent an unhandled rejection if nobody else awaits this per-ref promise (the primary caller
+            // below awaits `loadPromise` directly). Concurrent callers awaiting the cached promise still see
+            // the rejection through their own reference.
+            perRefPromise.catch(() => undefined);
+            // Reuse the per-ref promise as this call's own cache hit so the assembled result awaits it, and
+            // register it so later callers share it. Cast is safe: an omitted ref resolves to undefined but
+            // is compacted out of the result below (and never survives in the cache).
+            item.cacheHit = perRefPromise;
+            if (item.idCacheKey) {
+                cache.set(item.idCacheKey, item.cacheHit);
+            }
+            if (item.uriCacheKey) {
+                cache.set(item.uriCacheKey, item.cacheHit);
+            }
+        });
+        const [loadedFromServer, alreadyInCache] = await Promise.all([
+            loadPromise,
             Promise.all(withCacheHits.map((item) => item.cacheHit)),
-            // load items not in cache using the bulk operation
-            this.decorated.getAttributeDisplayForms(refsToLoad),
         ]);
-        // save newly loaded to cache for future reference
-        loadedFromServer.forEach((loaded) => {
-            const promisifiedResult = Promise.resolve(loaded);
-            // save the cache item for both types of refs
-            cache.set(loaded.id, promisifiedResult);
-            cache.set(loaded.uri, promisifiedResult);
-        });
         const loadedRefs = loadedFromServer.map((item) => item.ref);
         const outputRefs = this.ctx.capabilities.allowsInconsistentRelations
             ? skipMissingReferences(refs, refsToLoad, loadedRefs)
             : refs;
-        // reconstruct the original ordering
-        const candidates = [...loadedFromServer, ...alreadyInCache];
-        return outputRefs.map((ref) => {
-            const match = candidates.find((item) => refMatchesMdObject(ref, item, "displayForm"));
-            // if this bombs, some data got lost in the process
-            invariant(match);
-            return match;
+        // Reconstruct the original ordering. Derive the output from what actually resolved (compact) rather
+        // than from refsToLoad, so a concurrent caller sharing the in-flight promise of a ref the server
+        // omitted does not trip the invariant below.
+        const candidates = compact([...loadedFromServer, ...alreadyInCache]);
+        return outputRefs
+            .map((ref) => candidates.find((item) => refMatchesMdObject(ref, item, "displayForm")))
+            .filter((match) => {
+            // When the backend guarantees consistent relations, every requested ref must resolve.
+            if (!match) {
+                invariant(this.ctx.capabilities.allowsInconsistentRelations);
+                return false;
+            }
+            return true;
         });
     };
     getAttributeByDisplayForm = async (ref) => {
@@ -856,6 +931,168 @@ class WithAttributesCaching extends DecoratedWorkspaceAttributesService {
         }
         return cacheItem;
     };
+    getAttribute = (ref, opts = {}) => {
+        const cache = getOrCreateAttributeCache(this.ctx, this.workspace).attributes;
+        // The `include` option changes the shape of the returned object, so it must be part of the key.
+        // With the default (empty) options the key is just the identifier/uri, which lets `getAttribute`
+        // share cached entries with the bulk `getAttributes` method.
+        const suffix = opts.include?.length ? `:${opts.include.join(",")}` : "";
+        const { idCacheKey, uriCacheKey } = refCacheKeys(ref);
+        const idKey = idCacheKey && `${idCacheKey}${suffix}`;
+        const uriKey = uriCacheKey && `${uriCacheKey}${suffix}`;
+        let cacheItem = firstDefined([idKey, uriKey].map((key) => key && cache.get(key)));
+        if (!cacheItem) {
+            cacheItem = super.getAttribute(ref, opts).catch((e) => {
+                if (idKey) {
+                    cache.delete(idKey);
+                }
+                if (uriKey) {
+                    cache.delete(uriKey);
+                }
+                throw e;
+            });
+            if (idKey) {
+                cache.set(idKey, cacheItem);
+            }
+            if (uriKey) {
+                cache.set(uriKey, cacheItem);
+            }
+        }
+        // The shared `attributes` cache can momentarily hold an in-flight bulk entry that resolves to
+        // `undefined` for a ref the server omitted. Guard against it so the scalar contract (an attribute
+        // or a rejection) is preserved; such a gap is never written back to the cache.
+        return cacheItem.then((value) => value ?? this.decorated.getAttribute(ref, opts));
+    };
+    getAttributes = async (refs) => {
+        const cache = getOrCreateAttributeCache(this.ctx, this.workspace).attributes;
+        // Grab a reference to the cache results as soon as possible in case they would get evicted while
+        // loading the ones missing from the cache.
+        const refsWithCacheResults = refs.map((ref) => {
+            const { idCacheKey, uriCacheKey } = refCacheKeys(ref);
+            const cacheHit = firstDefined([idCacheKey, uriCacheKey].map((key) => key && cache.get(key)));
+            return {
+                ref,
+                idCacheKey,
+                uriCacheKey,
+                cacheHit: cacheHit,
+            };
+        });
+        const [withCacheHits, withoutCacheHits] = partition(refsWithCacheResults, ({ cacheHit }) => !!cacheHit);
+        const refsToLoad = withoutCacheHits.map((item) => item.ref);
+        // Use a single shared load promise so that concurrent callers asking for the same uncached refs
+        // collapse onto one underlying request. Per-ref promises are derived from it and registered into
+        // the cache synchronously - before any await - so a concurrent caller sees the in-flight promise.
+        const loadPromise = refsToLoad.length > 0
+            ? Promise.resolve(this.decorated.getAttributes(refsToLoad))
+            : Promise.resolve([]);
+        withoutCacheHits.forEach((item) => {
+            const perRefPromise = loadPromise
+                .then((loaded) => {
+                const match = loaded.find((attribute) => refMatchesMdObject(item.ref, attribute, "attribute"));
+                if (!match) {
+                    // The server omitted this ref; evict so a later call can retry it.
+                    if (item.idCacheKey) {
+                        cache.delete(item.idCacheKey);
+                    }
+                    if (item.uriCacheKey) {
+                        cache.delete(item.uriCacheKey);
+                    }
+                }
+                return match;
+            })
+                .catch((e) => {
+                if (item.idCacheKey) {
+                    cache.delete(item.idCacheKey);
+                }
+                if (item.uriCacheKey) {
+                    cache.delete(item.uriCacheKey);
+                }
+                throw e;
+            });
+            // Prevent an unhandled rejection if nobody else awaits this per-ref promise (the primary caller
+            // below awaits `loadPromise` directly). Concurrent callers awaiting the cached promise still see
+            // the rejection through their own reference.
+            perRefPromise.catch(() => undefined);
+            item.cacheHit = perRefPromise;
+            if (item.idCacheKey) {
+                cache.set(item.idCacheKey, perRefPromise);
+            }
+            if (item.uriCacheKey) {
+                cache.set(item.uriCacheKey, perRefPromise);
+            }
+        });
+        const [loadedFromServer, alreadyInCache] = await Promise.all([
+            loadPromise,
+            Promise.all(withCacheHits.map((item) => item.cacheHit)),
+        ]);
+        const loadedRefs = loadedFromServer.map((item) => item.ref);
+        const outputRefs = this.ctx.capabilities.allowsInconsistentRelations
+            ? skipMissingReferences(refs, refsToLoad, loadedRefs)
+            : refs;
+        // reconstruct the original ordering
+        const candidates = compact([...loadedFromServer, ...alreadyInCache]);
+        return outputRefs
+            .map((ref) => candidates.find((item) => refMatchesMdObject(ref, item, "attribute")))
+            .filter((match) => {
+            // When the backend guarantees consistent relations, every requested ref must resolve.
+            if (!match) {
+                invariant(this.ctx.capabilities.allowsInconsistentRelations);
+                return false;
+            }
+            return true;
+        });
+    };
+    getCommonAttributes = (attributeRefs) => {
+        const cache = getOrCreateAttributeCache(this.ctx, this.workspace).commonAttributes;
+        const cacheKey = refSetCacheKey(attributeRefs);
+        let result = cache.get(cacheKey);
+        if (!result) {
+            result = super.getCommonAttributes(attributeRefs).catch((e) => {
+                cache.delete(cacheKey);
+                throw e;
+            });
+            cache.set(cacheKey, result);
+        }
+        return result;
+    };
+    getCommonAttributesBatch = (attributesRefsBatch) => {
+        const cache = getOrCreateAttributeCache(this.ctx, this.workspace).commonAttributesBatch;
+        const cacheKey = new SparkMD5()
+            .append(stringify(attributesRefsBatch.map(refSetCacheKey)) || "undefined")
+            .end();
+        let result = cache.get(cacheKey);
+        if (!result) {
+            result = super.getCommonAttributesBatch(attributesRefsBatch).catch((e) => {
+                cache.delete(cacheKey);
+                throw e;
+            });
+            cache.set(cacheKey, result);
+        }
+        return result;
+    };
+    getConnectedAttributesByDisplayForm = (ref) => {
+        const cache = getOrCreateAttributeCache(this.ctx, this.workspace).connectedAttributes;
+        const { idCacheKey, uriCacheKey } = refCacheKeys(ref);
+        let cacheItem = firstDefined([idCacheKey, uriCacheKey].map((key) => key && cache.get(key)));
+        if (!cacheItem) {
+            cacheItem = super.getConnectedAttributesByDisplayForm(ref).catch((e) => {
+                if (idCacheKey) {
+                    cache.delete(idCacheKey);
+                }
+                if (uriCacheKey) {
+                    cache.delete(uriCacheKey);
+                }
+                throw e;
+            });
+            if (idCacheKey) {
+                cache.set(idCacheKey, cacheItem);
+            }
+            if (uriCacheKey) {
+                cache.set(uriCacheKey, cacheItem);
+            }
+        }
+        return cacheItem;
+    };
     getAttributeDatasetMeta = async (ref) => {
         const cache = getOrCreateAttributeCache(this.ctx, this.workspace).dataSetsMeta;
         const idCacheKey = isIdentifierRef(ref) ? ref.identifier : undefined;
@@ -1423,6 +1660,124 @@ function cachedMeasures(ctx) {
     return (original, workspace) => new WithMeasuresCaching(original, ctx, workspace);
 }
 //
+// Datasets caching
+//
+function getOrCreateDatasetsCache(ctx, workspace) {
+    const cache = ctx.caches.workspaceDatasets;
+    let cacheEntry = cache.get(workspace);
+    if (!cacheEntry) {
+        cacheEntry = {
+            datasets: new LRUCache({
+                max: ctx.config.maxDatasetsPerWorkspace,
+            }),
+        };
+        cache.set(workspace, cacheEntry);
+    }
+    return cacheEntry;
+}
+class WithDatasetsCaching extends DecoratedWorkspaceDatasetsService {
+    ctx;
+    workspace;
+    constructor(decorated, ctx, workspace) {
+        super(decorated);
+        this.ctx = ctx;
+        this.workspace = workspace;
+    }
+    // Pattern 1: scalar read keyed by ref identifier/uri (mirrors getAttributeByDisplayForm).
+    getDataset = (ref) => {
+        const cache = getOrCreateDatasetsCache(this.ctx, this.workspace).datasets;
+        const idCacheKey = isIdentifierRef(ref) ? ref.identifier : undefined;
+        const uriCacheKey = isUriRef(ref) ? ref.uri : undefined;
+        let cacheItem = firstDefined([idCacheKey, uriCacheKey].map((key) => key && cache.get(key)));
+        if (!cacheItem) {
+            cacheItem = super.getDataset(ref).catch((e) => {
+                if (idCacheKey) {
+                    cache.delete(idCacheKey);
+                }
+                if (uriCacheKey) {
+                    cache.delete(uriCacheKey);
+                }
+                throw e;
+            });
+            if (idCacheKey) {
+                cache.set(idCacheKey, cacheItem);
+            }
+            if (uriCacheKey) {
+                cache.set(uriCacheKey, cacheItem);
+            }
+        }
+        return cacheItem;
+    };
+    // Pattern 2 (the pilot): bulk read that de-duplicates in-flight requests. A single underlying
+    // load promise is issued for the missing refs and the per-ref promises derived from it are
+    // registered in the cache synchronously, before awaiting, so concurrent callers share them.
+    getDataSets = async (refs) => {
+        const cache = getOrCreateDatasetsCache(this.ctx, this.workspace).datasets;
+        // Grab references to the cache results as soon as possible in case they would get evicted
+        // while loading the ones missing from the cache.
+        const entries = refs.map((ref) => {
+            const idCacheKey = isIdentifierRef(ref) ? ref.identifier : undefined;
+            const uriCacheKey = isUriRef(ref) ? ref.uri : undefined;
+            const cacheHit = firstDefined([idCacheKey, uriCacheKey].map((key) => key && cache.get(key)));
+            return {
+                ref,
+                idCacheKey,
+                uriCacheKey,
+                promise: cacheHit,
+            };
+        });
+        const missing = entries.filter((entry) => !entry.promise);
+        if (missing.length > 0) {
+            // Single underlying request shared by every missing ref.
+            const loadPromise = this.decorated.getDataSets(missing.map((entry) => entry.ref));
+            // Attach a no-op handler so the shared promise never produces an unhandled rejection;
+            // the per-ref promises below carry the real error handling.
+            loadPromise.catch(() => undefined);
+            missing.forEach((entry) => {
+                const perRefPromise = loadPromise.then((loaded) => {
+                    const match = loaded.find((dataSet) => refMatchesMdObject(entry.ref, dataSet, "dataSet"));
+                    // The backend may omit refs it could not resolve (inconsistent relations).
+                    // Evict the omitted ref so it is not cached and gets reloaded next time.
+                    if (!match) {
+                        if (entry.idCacheKey) {
+                            cache.delete(entry.idCacheKey);
+                        }
+                        if (entry.uriCacheKey) {
+                            cache.delete(entry.uriCacheKey);
+                        }
+                    }
+                    return match;
+                });
+                // Evict on error so a rejected promise is never left cached.
+                const guarded = perRefPromise.catch((e) => {
+                    if (entry.idCacheKey) {
+                        cache.delete(entry.idCacheKey);
+                    }
+                    if (entry.uriCacheKey) {
+                        cache.delete(entry.uriCacheKey);
+                    }
+                    throw e;
+                });
+                if (entry.idCacheKey) {
+                    cache.set(entry.idCacheKey, guarded);
+                }
+                if (entry.uriCacheKey) {
+                    cache.set(entry.uriCacheKey, guarded);
+                }
+                entry.promise = guarded;
+            });
+        }
+        // Derive the output from what actually resolved, preserving the input ordering and
+        // dropping refs that the backend omitted. Omitted refs resolve to `undefined` (see the
+        // `match` lookup above), so genuine backend rejections still propagate and are not masked.
+        const resolved = await Promise.all(entries.map((entry) => entry.promise));
+        return resolved.filter((dataSet) => dataSet !== undefined);
+    };
+}
+function cachedDatasets(ctx) {
+    return (original, workspace) => new WithDatasetsCaching(original, ctx, workspace);
+}
+//
 // ORGANIZATION EXPORT TEMPLATES CACHING
 //
 class WithOrganizationExportTemplatesCaching extends DecoratedOrganizationExportTemplatesService {
@@ -1664,6 +2019,9 @@ function cacheControl(ctx) {
         resetFacts: () => {
             ctx.caches.workspaceFacts?.clear();
         },
+        resetDatasets: () => {
+            ctx.caches.workspaceDatasets?.clear();
+        },
         resetWorkspaceSettings: () => {
             ctx.caches.workspaceSettings?.clear();
         },
@@ -1689,6 +2047,7 @@ function cacheControl(ctx) {
             control.resetSecuritySettings();
             control.resetAttributes();
             control.resetFacts();
+            control.resetDatasets();
             control.resetWorkspaceSettings();
             control.resetGeoStyles();
             control.resetExportTemplates();
@@ -1721,6 +2080,8 @@ export const RecommendedCachingConfiguration = {
     maxAttributeWorkspaces: 1,
     maxAttributeDisplayFormsPerWorkspace: 500,
     maxAttributesPerWorkspace: 500,
+    maxCommonAttributesPerWorkspace: 500,
+    maxConnectedAttributesPerWorkspace: 500,
     maxAttributeElementResultsPerWorkspace: 100,
     maxWorkspaceSettings: 1,
     maxAutomationsWorkspaces: 1,
@@ -1729,6 +2090,8 @@ export const RecommendedCachingConfiguration = {
     maxFactsPerWorkspace: 500,
     maxMeasuresWorkspaces: 1,
     maxMeasuresPerWorkspace: 100,
+    maxDatasetWorkspaces: 1,
+    maxDatasetsPerWorkspace: 500,
     maxExportTemplatesOrgs: 1,
     maxExportTemplatesWorkspaces: 1,
     cacheGeoStyles: true,
@@ -1758,6 +2121,7 @@ export function withCaching(realBackend, config) {
     const insightsCaching = cachingEnabled(config.maxInsightsPerWorkspace);
     const factsCaching = cachingEnabled(config.maxFactsWorkspaces);
     const measuresCaching = cachingEnabled(config.maxMeasuresWorkspaces);
+    const datasetsCaching = cachingEnabled(config.maxDatasetWorkspaces);
     // Backward compatibility: `maxExportTemplatesWorkspaces` used to be the (deprecated) alias that
     // sized the org export-templates cache. It now primarily drives workspace caching, but callers
     // that only set the old name must keep getting org caching until the alias is removed.
@@ -1792,6 +2156,9 @@ export function withCaching(realBackend, config) {
             workspaceMeasures: measuresCaching
                 ? new LRUCache({ max: config.maxMeasuresWorkspaces })
                 : undefined,
+            workspaceDatasets: datasetsCaching
+                ? new LRUCache({ max: config.maxDatasetWorkspaces })
+                : undefined,
             organizationExportTemplates: exportTemplatesCaching
                 ? new LRUCache({ max: orgExportTemplatesMax })
                 : undefined,
@@ -1816,6 +2183,7 @@ export function withCaching(realBackend, config) {
     const insights = insightsCaching ? cachedInsights(ctx) : (v) => v;
     const facts = factsCaching ? cachedFacts(ctx) : (v) => v;
     const measures = measuresCaching ? cachedMeasures(ctx) : (v) => v;
+    const datasets = datasetsCaching ? cachedDatasets(ctx) : (v) => v;
     const organizationExportTemplates = exportTemplatesCaching
         ? cachedOrganizationExportTemplates(ctx)
         : undefined;
@@ -1837,6 +2205,7 @@ export function withCaching(realBackend, config) {
         insights,
         facts,
         measures,
+        datasets,
         organizationExportTemplates,
         workspaceExportTemplates,
         geo,

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

@@ -1 +1 @@
-{"version":3,"file":"analyticalWorkspace.d.ts","sourceRoot":"","sources":["../../src/decoratedBackend/analyticalWorkspace.ts"],"names":[],"mappings":"AAEA,OAAO,EACH,KAAK,oBAAoB,EACzB,KAAK,4BAA4B,EACjC,KAAK,mBAAmB,EACxB,KAAK,uBAAuB,EAC5B,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,KAAK,8BAA8B,EACnC,KAAK,uBAAuB,EAC5B,KAAK,2BAA2B,EAChC,KAAK,2BAA2B,EAChC,KAAK,wBAAwB,EAC7B,KAAK,2BAA2B,EAChC,KAAK,yBAAyB,EAC9B,KAAK,oBAAoB,EACzB,KAAK,0BAA0B,EAC/B,KAAK,kCAAkC,EACvC,KAAK,gCAAgC,EACrC,KAAK,sBAAsB,EAC3B,KAAK,yBAAyB,EAC9B,KAAK,kCAAkC,EACvC,KAAK,6BAA6B,EAClC,KAAK,yBAAyB,EAC9B,KAAK,kCAAkC,EACvC,KAAK,2BAA2B,EAChC,KAAK,4BAA4B,EACjC,KAAK,yBAAyB,EAC9B,KAAK,wBAAwB,EAC7B,KAAK,yBAAyB,EAC9B,KAAK,oBAAoB,EAC5B,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EAAE,KAAK,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD,qBAAa,4BAA6B,YAAW,oBAAoB;IAC9D,SAAS,EAAE,MAAM,CAAC;IACzB,OAAO,CAAC,SAAS,CAAuB;IACxC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqB;IAE/C,YAAY,SAAS,EAAE,oBAAoB,EAAE,SAAS,EAAE,kBAAkB,EAIzE;IAEM,aAAa,CAAC,qBAAqB,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAEnF;IAEM,gBAAgB,CAAC,UAAU,EAAE,0BAA0B,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAE7F;IAEM,kBAAkB,IAAI,OAAO,CAAC,oBAAoB,GAAG,SAAS,CAAC,CAErE;IAEM,UAAU,IAAI,2BAA2B,CAQ/C;IAEM,SAAS,IAAI,iBAAiB,CAQpC;IAEM,OAAO,IAAI,wBAAwB,CAQzC;IAEM,iBAAiB,IAAI,kCAAkC,CAE7D;IAEM,QAAQ,IAAI,yBAAyB,CAQ3C;IAEM,UAAU,IAAI,2BAA2B,CAE/C;IAEM,KAAK,IAAI,sBAAsB,CAQrC;IAEM,QAAQ,IAAI,yBAAyB,CAQ3C;IAEM,UAAU,IAAI,2BAA2B,CAQ/C;IAEM,QAAQ,IAAI,yBAAyB,CAQ3C;IAEM,OAAO,IAAI,wBAAwB,CAEzC;IAEM,QAAQ,IAAI,yBAAyB,CAE3C;IAEM,WAAW,IAAI,4BAA4B,CAEjD;IAEM,KAAK,IAAI,oBAAoB,CAEnC;IAEM,iBAAiB,IAAI,uBAAuB,CAElD;IAEM,UAAU,IAAI,yBAAyB,CAE7C;IAEM,aAAa,IAAI,8BAA8B,CAErD;IAEM,iBAAiB,IAAI,kCAAkC,CAE7D;IAEM,oBAAoB,IAAI,4BAA4B,CAE1D;IAEM,MAAM,IAAI,uBAAuB,CAEvC;IAEM,iBAAiB,IAAI,kCAAkC,CAE7D;IAEM,WAAW,IAAI,mBAAmB,CAExC;IAEM,YAAY,IAAI,6BAA6B,CAEnD;IAEM,WAAW,IAAI,2BAA2B,CAQhD;IAEM,KAAK,IAAI,aAAa,CAE5B;IAEM,UAAU,IAAI,kBAAkB,CAEtC;IAEM,eAAe,IAAI,gCAAgC,CAQzD;CACJ"}
+{"version":3,"file":"analyticalWorkspace.d.ts","sourceRoot":"","sources":["../../src/decoratedBackend/analyticalWorkspace.ts"],"names":[],"mappings":"AAEA,OAAO,EACH,KAAK,oBAAoB,EACzB,KAAK,4BAA4B,EACjC,KAAK,mBAAmB,EACxB,KAAK,uBAAuB,EAC5B,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,KAAK,8BAA8B,EACnC,KAAK,uBAAuB,EAC5B,KAAK,2BAA2B,EAChC,KAAK,2BAA2B,EAChC,KAAK,wBAAwB,EAC7B,KAAK,2BAA2B,EAChC,KAAK,yBAAyB,EAC9B,KAAK,oBAAoB,EACzB,KAAK,0BAA0B,EAC/B,KAAK,kCAAkC,EACvC,KAAK,gCAAgC,EACrC,KAAK,sBAAsB,EAC3B,KAAK,yBAAyB,EAC9B,KAAK,kCAAkC,EACvC,KAAK,6BAA6B,EAClC,KAAK,yBAAyB,EAC9B,KAAK,kCAAkC,EACvC,KAAK,2BAA2B,EAChC,KAAK,4BAA4B,EACjC,KAAK,yBAAyB,EAC9B,KAAK,wBAAwB,EAC7B,KAAK,yBAAyB,EAC9B,KAAK,oBAAoB,EAC5B,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EAAE,KAAK,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD,qBAAa,4BAA6B,YAAW,oBAAoB;IAC9D,SAAS,EAAE,MAAM,CAAC;IACzB,OAAO,CAAC,SAAS,CAAuB;IACxC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqB;IAE/C,YAAY,SAAS,EAAE,oBAAoB,EAAE,SAAS,EAAE,kBAAkB,EAIzE;IAEM,aAAa,CAAC,qBAAqB,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAEnF;IAEM,gBAAgB,CAAC,UAAU,EAAE,0BAA0B,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAE7F;IAEM,kBAAkB,IAAI,OAAO,CAAC,oBAAoB,GAAG,SAAS,CAAC,CAErE;IAEM,UAAU,IAAI,2BAA2B,CAQ/C;IAEM,SAAS,IAAI,iBAAiB,CAQpC;IAEM,OAAO,IAAI,wBAAwB,CAQzC;IAEM,iBAAiB,IAAI,kCAAkC,CAE7D;IAEM,QAAQ,IAAI,yBAAyB,CAQ3C;IAEM,UAAU,IAAI,2BAA2B,CAE/C;IAEM,KAAK,IAAI,sBAAsB,CAQrC;IAEM,QAAQ,IAAI,yBAAyB,CAQ3C;IAEM,UAAU,IAAI,2BAA2B,CAQ/C;IAEM,QAAQ,IAAI,yBAAyB,CAQ3C;IAEM,OAAO,IAAI,wBAAwB,CAEzC;IAEM,QAAQ,IAAI,yBAAyB,CAQ3C;IAEM,WAAW,IAAI,4BAA4B,CAEjD;IAEM,KAAK,IAAI,oBAAoB,CAEnC;IAEM,iBAAiB,IAAI,uBAAuB,CAElD;IAEM,UAAU,IAAI,yBAAyB,CAE7C;IAEM,aAAa,IAAI,8BAA8B,CAErD;IAEM,iBAAiB,IAAI,kCAAkC,CAE7D;IAEM,oBAAoB,IAAI,4BAA4B,CAE1D;IAEM,MAAM,IAAI,uBAAuB,CAEvC;IAEM,iBAAiB,IAAI,kCAAkC,CAE7D;IAEM,WAAW,IAAI,mBAAmB,CAExC;IAEM,YAAY,IAAI,6BAA6B,CAEnD;IAEM,WAAW,IAAI,2BAA2B,CAQhD;IAEM,KAAK,IAAI,aAAa,CAE5B;IAEM,UAAU,IAAI,kBAAkB,CAEtC;IAEM,eAAe,IAAI,gCAAgC,CAQzD;CACJ"}

package/esm/decoratedBackend/analyticalWorkspace.js

@@ -83,6 +83,10 @@ export class AnalyticalWorkspaceDecorator {
         return this.decorated.styling();
     }
     datasets() {
+        const { datasets } = this.factories;
+        if (datasets) {
+            return datasets(this.decorated.datasets(), this.workspace);
+        }
         return this.decorated.datasets();
     }
     permissions() {

package/esm/decoratedBackend/datasets.d.ts

@@ -0,0 +1,16 @@
+import { type IDatasetsQuery, type IWorkspaceDatasetsService } from "@gooddata/sdk-backend-spi";
+import { type IDataSetMetadataObject, type IDataset, type IMetadataObject, type IMetadataObjectBase, type IMetadataObjectIdentity, type ObjRef } from "@gooddata/sdk-model";
+/**
+ * @alpha
+ */
+export declare abstract class DecoratedWorkspaceDatasetsService implements IWorkspaceDatasetsService {
+    protected readonly decorated: IWorkspaceDatasetsService;
+    protected constructor(decorated: IWorkspaceDatasetsService);
+    getDatasets(): Promise<IDataset[]>;
+    getAllDatasetsMeta(): Promise<IMetadataObject[]>;
+    getDataSets(refs: ObjRef[]): Promise<IDataSetMetadataObject[]>;
+    getDataset(ref: ObjRef): Promise<IDataSetMetadataObject>;
+    updateDatasetMeta(dataSet: Partial<IMetadataObjectBase> & IMetadataObjectIdentity): Promise<IDataSetMetadataObject>;
+    getDatasetsQuery(): IDatasetsQuery;
+}
+//# sourceMappingURL=datasets.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"datasets.d.ts","sourceRoot":"","sources":["../../src/decoratedBackend/datasets.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,cAAc,EAAE,KAAK,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AAChG,OAAO,EACH,KAAK,sBAAsB,EAC3B,KAAK,QAAQ,EACb,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,KAAK,uBAAuB,EAC5B,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;IAE1E,WAAW,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC,CAExC;IAEM,kBAAkB,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC,CAEtD;IAEM,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,sBAAsB,EAAE,CAAC,CAEpE;IAEM,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAE9D;IAEM,iBAAiB,CACpB,OAAO,EAAE,OAAO,CAAC,mBAAmB,CAAC,GAAG,uBAAuB,GAChE,OAAO,CAAC,sBAAsB,CAAC,CAEjC;IAEM,gBAAgB,IAAI,cAAc,CAExC;CACJ"}

package/esm/decoratedBackend/datasets.js

@@ -0,0 +1,28 @@
+// (C) 2025-2026 GoodData Corporation
+/**
+ * @alpha
+ */
+export class DecoratedWorkspaceDatasetsService {
+    decorated;
+    constructor(decorated) {
+        this.decorated = decorated;
+    }
+    getDatasets() {
+        return this.decorated.getDatasets();
+    }
+    getAllDatasetsMeta() {
+        return this.decorated.getAllDatasetsMeta();
+    }
+    getDataSets(refs) {
+        return this.decorated.getDataSets(refs);
+    }
+    getDataset(ref) {
+        return this.decorated.getDataset(ref);
+    }
+    updateDatasetMeta(dataSet) {
+        return this.decorated.updateDatasetMeta(dataSet);
+    }
+    getDatasetsQuery() {
+        return this.decorated.getDatasetsQuery();
+    }
+}

package/esm/decoratedBackend/types.d.ts

@@ -1,4 +1,4 @@
-import { type IExecutionFactory, type IGeoService, type IOrganizationExportTemplatesService, type ISecuritySettingsService, type IWorkspaceAttributesService, type IWorkspaceAutomationService, type IWorkspaceCatalogFactory, type IWorkspaceDashboardsService, type IWorkspaceExportTemplatesService, type IWorkspaceFactsService, type IWorkspaceInsightsService, type IWorkspaceMeasuresService, type IWorkspaceSettingsService } from "@gooddata/sdk-backend-spi";
+import { type IExecutionFactory, type IGeoService, type IOrganizationExportTemplatesService, type ISecuritySettingsService, type IWorkspaceAttributesService, type IWorkspaceAutomationService, type IWorkspaceCatalogFactory, type IWorkspaceDashboardsService, type IWorkspaceDatasetsService, type IWorkspaceExportTemplatesService, type IWorkspaceFactsService, type IWorkspaceInsightsService, type IWorkspaceMeasuresService, type IWorkspaceSettingsService } from "@gooddata/sdk-backend-spi";
 /**
  * @alpha
  */
@@ -27,6 +27,10 @@ export type AutomationsDecoratorFactory = (automations: IWorkspaceAutomationServ
  * @alpha
  */
 export type MeasuresDecoratorFactory = (measures: IWorkspaceMeasuresService, workspace: string) => IWorkspaceMeasuresService;
+/**
+ * @alpha
+ */
+export type DatasetsDecoratorFactory = (datasets: IWorkspaceDatasetsService, workspace: string) => IWorkspaceDatasetsService;
 /**
  * @alpha
  */
@@ -67,6 +71,7 @@ export type DecoratorFactories = {
     automations?: AutomationsDecoratorFactory;
     insights?: InsightsDecoratorFactory;
     measures?: MeasuresDecoratorFactory;
+    datasets?: DatasetsDecoratorFactory;
     dashboards?: DashboardsDecoratorFactory;
     facts?: FactsDecoratorFactory;
     geo?: GeoDecoratorFactory;

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/decoratedBackend/types.ts"],"names":[],"mappings":"AAEA,OAAO,EACH,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAChB,KAAK,mCAAmC,EACxC,KAAK,wBAAwB,EAC7B,KAAK,2BAA2B,EAChC,KAAK,2BAA2B,EAChC,KAAK,wBAAwB,EAC7B,KAAK,2BAA2B,EAChC,KAAK,gCAAgC,EACrC,KAAK,sBAAsB,EAC3B,KAAK,yBAAyB,EAC9B,KAAK,yBAAyB,EAC9B,KAAK,yBAAyB,EACjC,MAAM,2BAA2B,CAAC;AAEnC;;GAEG;AACH,MAAM,MAAM,yBAAyB,GAAG,CAAC,gBAAgB,EAAE,iBAAiB,KAAK,iBAAiB,CAAC;AAEnG;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG,CAAC,OAAO,EAAE,wBAAwB,KAAK,wBAAwB,CAAC;AAEtG;;GAEG;AACH,MAAM,MAAM,gCAAgC,GAAG,CAC3C,gBAAgB,EAAE,wBAAwB,KACzC,wBAAwB,CAAC;AAE9B;;GAEG;AACH,MAAM,MAAM,iCAAiC,GAAG,CAC5C,QAAQ,EAAE,yBAAyB,EACnC,SAAS,EAAE,MAAM,KAChB,yBAAyB,CAAC;AAE/B;;GAEG;AACH,MAAM,MAAM,0BAA0B,GAAG,CACrC,UAAU,EAAE,2BAA2B,EACvC,SAAS,EAAE,MAAM,KAChB,2BAA2B,CAAC;AAEjC;;GAEG;AACH,MAAM,MAAM,2BAA2B,GAAG,CACtC,WAAW,EAAE,2BAA2B,EACxC,SAAS,EAAE,MAAM,KAChB,2BAA2B,CAAC;AAEjC;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG,CACnC,QAAQ,EAAE,yBAAyB,EACnC,SAAS,EAAE,MAAM,KAChB,yBAAyB,CAAC;AAE/B;;GAEG;AACH,MAAM,MAAM,0BAA0B,GAAG,CACrC,UAAU,EAAE,2BAA2B,EACvC,SAAS,EAAE,MAAM,KAChB,2BAA2B,CAAC;AAEjC;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG,CACnC,QAAQ,EAAE,yBAAyB,EACnC,SAAS,EAAE,MAAM,KAChB,yBAAyB,CAAC;AAE/B;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG,CAChC,KAAK,EAAE,sBAAsB,EAC7B,SAAS,EAAE,MAAM,KAChB,sBAAsB,CAAC;AAE5B;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,GAAG,EAAE,WAAW,KAAK,WAAW,CAAC;AAEpE;;GAEG;AACH,MAAM,MAAM,2CAA2C,GAAG,CACtD,eAAe,EAAE,mCAAmC,EACpD,cAAc,EAAE,MAAM,KACrB,mCAAmC,CAAC;AAEzC;;GAEG;AACH,MAAM,MAAM,wCAAwC,GAAG,CACnD,eAAe,EAAE,gCAAgC,EACjD,SAAS,EAAE,MAAM,KAChB,gCAAgC,CAAC;AAEtC;;;;;;GAMG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC7B,SAAS,CAAC,EAAE,yBAAyB,CAAC;IACtC,OAAO,CAAC,EAAE,uBAAuB,CAAC;IAClC,gBAAgB,CAAC,EAAE,gCAAgC,CAAC;IACpD,iBAAiB,CAAC,EAAE,iCAAiC,CAAC;IACtD,UAAU,CAAC,EAAE,0BAA0B,CAAC;IACxC,WAAW,CAAC,EAAE,2BAA2B,CAAC;IAC1C,QAAQ,CAAC,EAAE,wBAAwB,CAAC;IACpC,QAAQ,CAAC,EAAE,wBAAwB,CAAC;IACpC,UAAU,CAAC,EAAE,0BAA0B,CAAC;IACxC,KAAK,CAAC,EAAE,qBAAqB,CAAC;IAC9B,GAAG,CAAC,EAAE,mBAAmB,CAAC;IAC1B,2BAA2B,CAAC,EAAE,2CAA2C,CAAC;IAC1E,wBAAwB,CAAC,EAAE,wCAAwC,CAAC;CACvE,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/decoratedBackend/types.ts"],"names":[],"mappings":"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"}

package/esm/index.d.ts

@@ -12,7 +12,7 @@ export { type DummyBackendConfig, dummyBackend, dummyBackendEmptyData, dummyData
 export { DummySemanticSearchQueryBuilder } from "./dummyBackend/DummySemanticSearch.js";
 export { DummyGenAIChatThread, DummyChatConversations } from "./dummyBackend/DummyGenAIChatThread.js";
 export { decoratedBackend } from "./decoratedBackend/index.js";
-export type { DecoratorFactories, CatalogDecoratorFactory, ExecutionDecoratorFactory, SecuritySettingsDecoratorFactory, WorkspaceSettingsDecoratorFactory, AutomationsDecoratorFactory, AttributesDecoratorFactory, InsightsDecoratorFactory, MeasuresDecoratorFactory, DashboardsDecoratorFactory, FactsDecoratorFactory, GeoDecoratorFactory, OrganizationExportTemplatesDecoratorFactory, WorkspaceExportTemplatesDecoratorFactory, } from "./decoratedBackend/types.js";
+export type { DecoratorFactories, CatalogDecoratorFactory, ExecutionDecoratorFactory, SecuritySettingsDecoratorFactory, WorkspaceSettingsDecoratorFactory, AutomationsDecoratorFactory, AttributesDecoratorFactory, InsightsDecoratorFactory, MeasuresDecoratorFactory, DatasetsDecoratorFactory, DashboardsDecoratorFactory, FactsDecoratorFactory, GeoDecoratorFactory, OrganizationExportTemplatesDecoratorFactory, WorkspaceExportTemplatesDecoratorFactory, } from "./decoratedBackend/types.js";
 export { type PreparedExecutionWrapper, DecoratedExecutionFactory, DecoratedPreparedExecution, DecoratedExecutionResult, } from "./decoratedBackend/execution.js";
 export { DecoratedWorkspaceDashboardsService } from "./decoratedBackend/dashboards.js";
 export { DecoratedWorkspaceInsightsService } from "./decoratedBackend/insights.js";

package/esm/index.d.ts.map

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

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

@@ -167,6 +167,7 @@ import { IWorkspaceCatalogAvailableItemsFactory } from '@gooddata/sdk-backend-sp
 import { IWorkspaceCatalogFactory } from '@gooddata/sdk-backend-spi';
 import { IWorkspaceCatalogFactoryOptions } from '@gooddata/sdk-backend-spi';
 import { IWorkspaceDashboardsService } from '@gooddata/sdk-backend-spi';
+import { IWorkspaceDatasetsService } from '@gooddata/sdk-backend-spi';
 import { IWorkspaceExportTemplatesService } from '@gooddata/sdk-backend-spi';
 import { IWorkspaceFactsService } from '@gooddata/sdk-backend-spi';
 import { IWorkspaceInsightsService } from '@gooddata/sdk-backend-spi';
@@ -461,6 +462,10 @@ export declare type CacheControl = {
      * Resets all workspace facts caches.
      */
     resetFacts: () => void;
+    /**
+     * Resets all workspace dataset caches.
+     */
+    resetDatasets: () => void;
     /**
      * Resets all workspace settings caches.
      */
@@ -718,6 +723,33 @@ export declare type CachingConfiguration = {
      * tweak the `maxMeasuresWorkspaces` value.
      */
     maxMeasuresPerWorkspace?: number;
+    /**
+     * Maximum number of workspaces for which to cache selected {@link @gooddata/sdk-backend-spi#IWorkspaceDatasetsService} calls.
+     * The workspace identifier is used as cache key.
+     * For each workspace, there will be a cache entry holding `maxDatasetsPerWorkspace` entries for dataset metadata reads.
+     *
+     * When limit is reached, cache entries will be evicted using LRU policy.
+     *
+     * When no maximum number is specified, the cache will be unbounded and no evictions will happen. Unbounded
+     * cache may be OK in applications where number of workspaces is small - the cache will be limited
+     * naturally and will not grow uncontrollably.
+     *
+     * When non-positive number is specified, then no caching will be done.
+     */
+    maxDatasetWorkspaces?: number;
+    /**
+     * Maximum number of datasets to cache per workspace.
+     *
+     * When limit is reached, cache entries will be evicted using LRU policy.
+     *
+     * When no maximum number is specified, the cache will be unbounded and no evictions will happen. Unbounded
+     * dataset cache may be OK in applications where number of datasets is small and/or they are requested
+     * infrequently - the cache will be limited naturally and will not grow uncontrollably.
+     *
+     * Setting non-positive number here is invalid. If you want to turn off dataset caching,
+     * tweak the `maxDatasetWorkspaces` value.
+     */
+    maxDatasetsPerWorkspace?: number;
     /**
      * Maximum number of organizations for which to cache organization-level export templates.
      * Organization export templates are organization-level, so typically a single entry suffices.
@@ -763,6 +795,34 @@ export declare type CachingConfiguration = {
      * tweak the `maxAttributeWorkspaces` value.
      */
     maxAttributesPerWorkspace?: number;
+    /**
+     * Maximum number of common attribute results to cache per workspace.
+     *
+     * This bounds the cache used by `getCommonAttributes` and `getCommonAttributesBatch`, keyed by the
+     * (order-independent) set of input attribute references.
+     *
+     * When limit is reached, cache entries will be evicted using LRU policy.
+     *
+     * When no maximum number is specified, the cache will be unbounded and no evictions will happen.
+     *
+     * Setting non-positive number here is invalid. If you want to turn off common attribute caching,
+     * tweak the `maxAttributeWorkspaces` value.
+     */
+    maxCommonAttributesPerWorkspace?: number;
+    /**
+     * Maximum number of connected attribute results to cache per workspace.
+     *
+     * This bounds the cache used by `getConnectedAttributesByDisplayForm`, keyed by the display form
+     * reference identifier/uri.
+     *
+     * When limit is reached, cache entries will be evicted using LRU policy.
+     *
+     * When no maximum number is specified, the cache will be unbounded and no evictions will happen.
+     *
+     * Setting non-positive number here is invalid. If you want to turn off connected attribute caching,
+     * tweak the `maxAttributeWorkspaces` value.
+     */
+    maxConnectedAttributesPerWorkspace?: number;
     /**
      * Maximum number of attribute element results to cache per workspace.
      *
@@ -1065,6 +1125,11 @@ export declare type DataProviderContext = CustomCallContext & {
 export declare class DataSetMetadataObjectBuilder<T extends IDataSetMetadataObject = IDataSetMetadataObject> extends MetadataObjectBuilder<T> {
 }
 
+/**
+ * @alpha
+ */
+export declare type DatasetsDecoratorFactory = (datasets: IWorkspaceDatasetsService, workspace: string) => IWorkspaceDatasetsService;
+
 /**
  * Decorated backend is a wrapper of any other backend implementations that can be used to enrich
  * functionality of the services that the wrapped backend normally provides.
@@ -1408,6 +1473,7 @@ export declare type DecoratorFactories = {
     automations?: AutomationsDecoratorFactory;
     insights?: InsightsDecoratorFactory;
     measures?: MeasuresDecoratorFactory;
+    datasets?: DatasetsDecoratorFactory;
     dashboards?: DashboardsDecoratorFactory;
     facts?: FactsDecoratorFactory;
     geo?: GeoDecoratorFactory;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gooddata/sdk-backend-base",
-  "version": "11.49.0-alpha.0",
+  "version": "11.49.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.49.0-alpha.0",
-    "@gooddata/sdk-model": "11.49.0-alpha.0",
-    "@gooddata/util": "11.49.0-alpha.0"
+    "@gooddata/sdk-backend-spi": "11.49.0",
+    "@gooddata/sdk-model": "11.49.0",
+    "@gooddata/util": "11.49.0"
   },
   "devDependencies": {
     "@microsoft/api-documenter": "^7.17.0",
@@ -56,9 +56,9 @@
     "oxlint-tsgolint": "0.15.0",
     "typescript": "5.9.3",
     "vitest": "4.1.8",
-    "@gooddata/eslint-config": "11.49.0-alpha.0",
-    "@gooddata/oxlint-config": "11.49.0-alpha.0",
-    "@gooddata/reference-workspace": "11.49.0-alpha.0"
+    "@gooddata/eslint-config": "11.49.0",
+    "@gooddata/oxlint-config": "11.49.0",
+    "@gooddata/reference-workspace": "11.49.0"
   },
   "scripts": {
     "_phase:build": "npm run build",