@lightdash/common 0.2077.5 → 0.2078.1

package/dist/types/ee/AiAgent/filterExploreByTags.d.ts

@@ -15,23 +15,34 @@ type FilterableExplore<T extends FilterableTable = FilterableTable> = {
 };
 /**
  * @description
+ * Filters an explore based on available tags configured in AI settings.
  *
- * No tags are configured in settings UI:
+ * ## 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)
  *
- * | Tagging Scenario                  | AI Visibility                    |
- * |-----------------------------------|----------------------------------|
- * | No tags configured in settings UI | Everything is visible by default |
+ * ## 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
  *
- * Tags are configured in settings UI:
+ * **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 Scenario                     | AI Visibility               |
- * |--------------------------------------|-----------------------------|
- * | Explore only (with matching tag)     | All fields in the Explore   |
- * | Some fields only (with matching tag) | Only those tagged fields    |
- * | Explore + some fields (with match)   | Only those tagged fields    |
- * | No matching tags                     | Nothing is visible          |
+ * ## 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 declare function filterExploreByTags<E extends FilterableExplore>({ explore, availableTags, }: {
     explore: E;

package/dist/types/ee/AiAgent/filterExploreByTags.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"filterExploreByTags.d.ts","sourceRoot":"","sources":["../../../../src/ee/AiAgent/filterExploreByTags.ts"],"names":[],"mappings":"AAMA,KAAK,eAAe,GAAG;IACnB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;IAChD,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;CAChD,CAAC;AAEF,KAAK,iBAAiB,CAAC,CAAC,SAAS,eAAe,GAAG,eAAe,IAAI;IAClE,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE;QAAE,CAAC,SAAS,EAAE,MAAM,GAAG,CAAC,CAAA;KAAE,CAAC;CACtC,CAAC;AAkCF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,iBAAiB,EAAE,EAC7D,OAAO,EACP,aAAa,GAChB,EAAE;IACC,OAAO,EAAE,CAAC,CAAC;IACX,aAAa,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;CAClC,iBAgCA"}
+{"version":3,"file":"filterExploreByTags.d.ts","sourceRoot":"","sources":["../../../../src/ee/AiAgent/filterExploreByTags.ts"],"names":[],"mappings":"AAMA,KAAK,eAAe,GAAG;IACnB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;IAChD,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;CAChD,CAAC;AAEF,KAAK,iBAAiB,CAAC,CAAC,SAAS,eAAe,GAAG,eAAe,IAAI;IAClE,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE;QAAE,CAAC,SAAS,EAAE,MAAM,GAAG,CAAC,CAAA;KAAE,CAAC;CACtC,CAAC;AA0CF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,iBAAiB,EAAE,EAC7D,OAAO,EACP,aAAa,GAChB,EAAE;IACC,OAAO,EAAE,CAAC,CAAC;IACX,aAAa,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;CAClC,iBA+CA"}