@lightdash/common 0.2104.6 → 0.2104.8

package/dist/types/ee/AiAgent/filterExploreByTags.js

@@ -0,0 +1,94 @@
+import concat from 'lodash/concat';
+import flatMap from 'lodash/flatMap';
+import intersection from 'lodash/intersection';
+import mapValues from 'lodash/mapValues';
+import pickBy from 'lodash/pickBy';
+function matcher(tags, availableTags) {
+    return intersection(tags, availableTags).length > 0;
+}
+function hasFieldMatchingTags(table, availableTags) {
+    return matcher(concat(flatMap(table.metrics, (m) => m.tags ?? []), flatMap(table.dimensions, (d) => d.tags ?? [])), availableTags);
+}
+function hasTableAnyFieldTags(table) {
+    const allFields = concat(Object.values(table.metrics), Object.values(table.dimensions));
+    return allFields.some((field) => field.tags !== undefined);
+}
+function hasMatchingTags(explore, baseTable, availableTags) {
+    if (matcher(explore.tags, availableTags)) {
+        return true;
+    }
+    if (hasFieldMatchingTags(baseTable, availableTags)) {
+        return true;
+    }
+    return false;
+}
+/**
+ * @description
+ * Filters an explore based on available tags configured in AI settings.
+ *
+ * ## Base Table Requirement
+ * An explore is only visible if the base table has matching tags at either:
+ * - Explore level (explore.tags matches availableTags), OR
+ * - Field level (at least one base table field has matching tags)
+ *
+ * ## Per-Table Filtering Modes
+ * Each table in the explore is filtered independently:
+ *
+ * **Field-Level Mode** (if table has ANY field with tags defined):
+ * - Expose only fields where field.tags matches availableTags
+ * - Empty tags arrays (tags: []) activate this mode but match nothing
+ *
+ * **Explore-Level Mode** (if table has NO fields with tags defined):
+ * - If explore.tags matches → expose ALL fields in this table
+ * - If explore.tags doesn't match → expose NO fields (empty dimensions/metrics)
+ *
+ * ## Tagging Scenarios
+ *
+ * | Scenario                                        | Result                                    |
+ * |-------------------------------------------------|-------------------------------------------|
+ * | No tags configured (availableTags = null/[])    | Everything is visible                     |
+ * | Explore tagged, no field tags                   | All tables/fields visible (explore-level) |
+ * | Explore tagged, some fields tagged              | Per-table: field-level or explore-level   |
+ * | No explore tag, base table fields tagged        | Only matching fields visible              |
+ * | No explore tag, only joined table fields tagged | Explore hidden (base table requirement)   |
+ * | No matching tags anywhere                       | Explore hidden                            |
+ */
+export function filterExploreByTags({ explore, availableTags, }) {
+    if (!availableTags || availableTags.length === 0) {
+        return explore;
+    }
+    const baseTable = explore.tables[explore.baseTable];
+    if (!baseTable) {
+        throw new Error(`Base table not found`);
+    }
+    if (!hasMatchingTags(explore, baseTable, availableTags)) {
+        return undefined;
+    }
+    // Apply per-table filtering logic
+    const filteredExplore = {
+        ...explore,
+        tables: mapValues(explore.tables, (table) => {
+            if (hasTableAnyFieldTags(table)) {
+                // Field-level tagging mode: expose only fields with matching tags
+                return {
+                    ...table,
+                    dimensions: pickBy(table.dimensions, (d) => matcher(d.tags ?? [], availableTags)),
+                    metrics: pickBy(table.metrics, (m) => matcher(m.tags ?? [], availableTags)),
+                };
+            }
+            // Explore-level tagging mode
+            if (matcher(explore.tags, availableTags)) {
+                // Explore tagged: expose all fields in this table
+                return table;
+            }
+            // Explore not tagged: expose no fields
+            return {
+                ...table,
+                dimensions: {},
+                metrics: {},
+            };
+        }),
+    };
+    return filteredExplore;
+}
+//# sourceMappingURL=filterExploreByTags.js.map

package/dist/types/ee/AiAgent/filterExploreByTags.js.map

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