@okf/ootils 1.6.13 → 1.6.14

package/dist/browser.d.mts

@@ -151,6 +151,51 @@ declare const _recursExtractBlocks: ({ data, cb, sectionStack, blockPathPrefix }
     blockPathPrefix?: string;
 }) => void;
 
+/**
+ * Calculates all possible rollup relationships for a tag type
+ *
+ * Rollups allow indirect filtering (e.g., filter stories by topic type where stories are tagged with topics)
+ *
+ * Returns two types of possibilities:
+ * 1. **valuePathType**: Direct field rollups within the tag (e.g., topics.main.category)
+ * 2. **tagType**: Nested tag chain rollups (e.g., topics → themes → categories)
+ *
+ * Performance optimizations:
+ * - Caches template blocks to avoid repeated extractAllBlocksFromTpl calls
+ * - Limits recursion depth to MAX_DEPTH_ROLLUP_POSSIBILITIES (10 levels)
+ *
+ * @param {Object} params - Parameters object
+ * @param {string} params.tagType - The tag type to find rollup possibilities for (e.g., 'topics', 'districts')
+ * @param {Array} params.allTpls - All templates in the system
+ *
+ * @returns {Array} Array of rollup possibilities
+ *
+ * @example
+ * // Input:
+ * getRollupPossibilities({ tagType: 'topics', allTpls: [...] })
+ *
+ * // Output:
+ * [
+ *   {
+ *     rollupType: 'valuePathType',
+ *     tagTypeCollectionToRollup: 'topics',
+ *     valuePathInRolledUpCollection: 'main.category.value',
+ *     filterSourceValuePath: 'main.category',
+ *     blockValuePath: 'main.category',
+ *     filterDisplay: 'Topic Category'
+ *   },
+ *   {
+ *     rollupType: 'tagType',
+ *     tagTypeCollectionToRollup: 'topics',
+ *     rollupPath: ['topics', 'themes']
+ *   }
+ * ]
+ */
+declare function getRollupPossibilities({ tagType, allTpls }: {
+    tagType: string;
+    allTpls: any[];
+}): any[];
+
 declare namespace BASE_BULLMQ_CONFIG {
     namespace PLUGIN__MAD_USERS_SYNC_QUEUE {
         let id: string;
@@ -498,4 +543,4 @@ interface GetPlatformContextContentParams {
 }
 declare const getPlatformContextContent: ({ platformConfigs_ai, }: GetPlatformContextContentParams) => string;
 
-export { BASE_BULLMQ_CONFIG, deleteVal, extractAllBlocksFromTpl, genTagId, getPlatformContextContent, getVal, _recursExtractBlocks as recursivelyExtractBlocks, setVal, toArray };
+export { BASE_BULLMQ_CONFIG, deleteVal, extractAllBlocksFromTpl, genTagId, getPlatformContextContent, getRollupPossibilities, getVal, _recursExtractBlocks as recursivelyExtractBlocks, setVal, toArray };

package/dist/browser.d.ts

@@ -151,6 +151,51 @@ declare const _recursExtractBlocks: ({ data, cb, sectionStack, blockPathPrefix }
     blockPathPrefix?: string;
 }) => void;
 
+/**
+ * Calculates all possible rollup relationships for a tag type
+ *
+ * Rollups allow indirect filtering (e.g., filter stories by topic type where stories are tagged with topics)
+ *
+ * Returns two types of possibilities:
+ * 1. **valuePathType**: Direct field rollups within the tag (e.g., topics.main.category)
+ * 2. **tagType**: Nested tag chain rollups (e.g., topics → themes → categories)
+ *
+ * Performance optimizations:
+ * - Caches template blocks to avoid repeated extractAllBlocksFromTpl calls
+ * - Limits recursion depth to MAX_DEPTH_ROLLUP_POSSIBILITIES (10 levels)
+ *
+ * @param {Object} params - Parameters object
+ * @param {string} params.tagType - The tag type to find rollup possibilities for (e.g., 'topics', 'districts')
+ * @param {Array} params.allTpls - All templates in the system
+ *
+ * @returns {Array} Array of rollup possibilities
+ *
+ * @example
+ * // Input:
+ * getRollupPossibilities({ tagType: 'topics', allTpls: [...] })
+ *
+ * // Output:
+ * [
+ *   {
+ *     rollupType: 'valuePathType',
+ *     tagTypeCollectionToRollup: 'topics',
+ *     valuePathInRolledUpCollection: 'main.category.value',
+ *     filterSourceValuePath: 'main.category',
+ *     blockValuePath: 'main.category',
+ *     filterDisplay: 'Topic Category'
+ *   },
+ *   {
+ *     rollupType: 'tagType',
+ *     tagTypeCollectionToRollup: 'topics',
+ *     rollupPath: ['topics', 'themes']
+ *   }
+ * ]
+ */
+declare function getRollupPossibilities({ tagType, allTpls }: {
+    tagType: string;
+    allTpls: any[];
+}): any[];
+
 declare namespace BASE_BULLMQ_CONFIG {
     namespace PLUGIN__MAD_USERS_SYNC_QUEUE {
         let id: string;
@@ -498,4 +543,4 @@ interface GetPlatformContextContentParams {
 }
 declare const getPlatformContextContent: ({ platformConfigs_ai, }: GetPlatformContextContentParams) => string;
 
-export { BASE_BULLMQ_CONFIG, deleteVal, extractAllBlocksFromTpl, genTagId, getPlatformContextContent, getVal, _recursExtractBlocks as recursivelyExtractBlocks, setVal, toArray };
+export { BASE_BULLMQ_CONFIG, deleteVal, extractAllBlocksFromTpl, genTagId, getPlatformContextContent, getRollupPossibilities, getVal, _recursExtractBlocks as recursivelyExtractBlocks, setVal, toArray };

package/dist/browser.js

@@ -25,6 +25,7 @@ __export(browser_exports, {
   extractAllBlocksFromTpl: () => extractAllBlocksFromTpl,
   genTagId: () => genTagId,
   getPlatformContextContent: () => getPlatformContextContent,
+  getRollupPossibilities: () => getRollupPossibilities,
   getVal: () => getVal,
   recursivelyExtractBlocks: () => _recursExtractBlocks,
   setVal: () => setVal,
@@ -307,6 +308,85 @@ var _extractBlocksFromSomeBuilders = ({
   }
 };
 
+// src/utils/getRollupPossibilities.ts
+var MAX_DEPTH_ROLLUP_POSSIBILITIES = 10;
+function getRollupPossibilities({
+  tagType,
+  allTpls
+}) {
+  const thisTagTpl = allTpls.find((d) => d.kp_content_type === tagType);
+  if (!thisTagTpl) return [];
+  const allBlocks = extractAllBlocksFromTpl({ tpl: thisTagTpl });
+  const templateBlocksCache = /* @__PURE__ */ new Map();
+  const getCachedTemplateBlocks = (templateTagType) => {
+    if (!templateBlocksCache.has(templateTagType)) {
+      const template = allTpls.find((d) => d.kp_content_type === templateTagType);
+      if (template) {
+        templateBlocksCache.set(templateTagType, extractAllBlocksFromTpl({ tpl: template }));
+      } else {
+        templateBlocksCache.set(templateTagType, []);
+      }
+    }
+    return templateBlocksCache.get(templateTagType);
+  };
+  const findTagChains = (startTagType, visited = [], maxDepth = 10) => {
+    if (visited.includes(startTagType) || visited.length >= maxDepth) {
+      return [];
+    }
+    const tagBlocks = getCachedTemplateBlocks(startTagType).filter(
+      (block) => block.valuePath?.startsWith("tags.")
+    );
+    const chains = [];
+    for (const block of tagBlocks) {
+      const nextTagType = block.props?.tagType;
+      if (nextTagType) {
+        chains.push({
+          rollupType: "tagType",
+          tagTypeCollectionToRollup: tagType,
+          rollupPath: [...visited, startTagType, nextTagType]
+        });
+        if (visited.length < maxDepth - 1) {
+          const nextChains = findTagChains(
+            nextTagType,
+            [...visited, startTagType],
+            maxDepth
+          );
+          chains.push(...nextChains);
+        }
+      }
+    }
+    return chains;
+  };
+  const singleLevelValuePathRollups = allBlocks.map((block) => {
+    if (block.props?.options?.length > 0) {
+      return {
+        rollupType: "valuePathType",
+        tagTypeCollectionToRollup: tagType,
+        // Handle both string values and object values (with .value accessor)
+        valuePathInRolledUpCollection: block.props?.saveValueAsString ? block.valuePath : `${block.valuePath}.value`,
+        filterSourceValuePath: block.valuePath,
+        blockValuePath: block.valuePath,
+        filterDisplay: block.props?.shortLabel || block.props?.label || block.valuePath
+      };
+    }
+    return void 0;
+  }).filter(Boolean);
+  const nestedTagRollups = allBlocks.filter((block) => block.valuePath?.startsWith("tags.")).flatMap((block) => {
+    const directChain = {
+      rollupType: "tagType",
+      tagTypeCollectionToRollup: tagType,
+      rollupPath: [tagType, block.props.tagType]
+    };
+    const deeperChains = findTagChains(
+      block.props?.tagType,
+      [tagType],
+      MAX_DEPTH_ROLLUP_POSSIBILITIES
+    );
+    return [directChain, ...deeperChains];
+  });
+  return [...singleLevelValuePathRollups, ...nestedTagRollups];
+}
+
 // src/bullmq/GLOBAL_BULLMQ_CONFIG.js
 var BASE_BULLMQ_CONFIG = {
   PLUGIN__MAD_USERS_SYNC_QUEUE: {
@@ -577,6 +657,7 @@ ${v?.markdownText || ""}` : v?.markdownText || "";
   extractAllBlocksFromTpl,
   genTagId,
   getPlatformContextContent,
+  getRollupPossibilities,
   getVal,
   recursivelyExtractBlocks,
   setVal,

package/dist/browser.mjs

@@ -273,6 +273,85 @@ var _extractBlocksFromSomeBuilders = ({
   }
 };
 
+// src/utils/getRollupPossibilities.ts
+var MAX_DEPTH_ROLLUP_POSSIBILITIES = 10;
+function getRollupPossibilities({
+  tagType,
+  allTpls
+}) {
+  const thisTagTpl = allTpls.find((d) => d.kp_content_type === tagType);
+  if (!thisTagTpl) return [];
+  const allBlocks = extractAllBlocksFromTpl({ tpl: thisTagTpl });
+  const templateBlocksCache = /* @__PURE__ */ new Map();
+  const getCachedTemplateBlocks = (templateTagType) => {
+    if (!templateBlocksCache.has(templateTagType)) {
+      const template = allTpls.find((d) => d.kp_content_type === templateTagType);
+      if (template) {
+        templateBlocksCache.set(templateTagType, extractAllBlocksFromTpl({ tpl: template }));
+      } else {
+        templateBlocksCache.set(templateTagType, []);
+      }
+    }
+    return templateBlocksCache.get(templateTagType);
+  };
+  const findTagChains = (startTagType, visited = [], maxDepth = 10) => {
+    if (visited.includes(startTagType) || visited.length >= maxDepth) {
+      return [];
+    }
+    const tagBlocks = getCachedTemplateBlocks(startTagType).filter(
+      (block) => block.valuePath?.startsWith("tags.")
+    );
+    const chains = [];
+    for (const block of tagBlocks) {
+      const nextTagType = block.props?.tagType;
+      if (nextTagType) {
+        chains.push({
+          rollupType: "tagType",
+          tagTypeCollectionToRollup: tagType,
+          rollupPath: [...visited, startTagType, nextTagType]
+        });
+        if (visited.length < maxDepth - 1) {
+          const nextChains = findTagChains(
+            nextTagType,
+            [...visited, startTagType],
+            maxDepth
+          );
+          chains.push(...nextChains);
+        }
+      }
+    }
+    return chains;
+  };
+  const singleLevelValuePathRollups = allBlocks.map((block) => {
+    if (block.props?.options?.length > 0) {
+      return {
+        rollupType: "valuePathType",
+        tagTypeCollectionToRollup: tagType,
+        // Handle both string values and object values (with .value accessor)
+        valuePathInRolledUpCollection: block.props?.saveValueAsString ? block.valuePath : `${block.valuePath}.value`,
+        filterSourceValuePath: block.valuePath,
+        blockValuePath: block.valuePath,
+        filterDisplay: block.props?.shortLabel || block.props?.label || block.valuePath
+      };
+    }
+    return void 0;
+  }).filter(Boolean);
+  const nestedTagRollups = allBlocks.filter((block) => block.valuePath?.startsWith("tags.")).flatMap((block) => {
+    const directChain = {
+      rollupType: "tagType",
+      tagTypeCollectionToRollup: tagType,
+      rollupPath: [tagType, block.props.tagType]
+    };
+    const deeperChains = findTagChains(
+      block.props?.tagType,
+      [tagType],
+      MAX_DEPTH_ROLLUP_POSSIBILITIES
+    );
+    return [directChain, ...deeperChains];
+  });
+  return [...singleLevelValuePathRollups, ...nestedTagRollups];
+}
+
 // src/bullmq/GLOBAL_BULLMQ_CONFIG.js
 var BASE_BULLMQ_CONFIG = {
   PLUGIN__MAD_USERS_SYNC_QUEUE: {
@@ -542,6 +621,7 @@ export {
   extractAllBlocksFromTpl,
   genTagId,
   getPlatformContextContent,
+  getRollupPossibilities,
   getVal,
   _recursExtractBlocks as recursivelyExtractBlocks,
   setVal,

package/dist/node.d.mts

@@ -158,6 +158,51 @@ declare const _recursExtractBlocks: ({ data, cb, sectionStack, blockPathPrefix }
     blockPathPrefix?: string;
 }) => void;
 
+/**
+ * Calculates all possible rollup relationships for a tag type
+ *
+ * Rollups allow indirect filtering (e.g., filter stories by topic type where stories are tagged with topics)
+ *
+ * Returns two types of possibilities:
+ * 1. **valuePathType**: Direct field rollups within the tag (e.g., topics.main.category)
+ * 2. **tagType**: Nested tag chain rollups (e.g., topics → themes → categories)
+ *
+ * Performance optimizations:
+ * - Caches template blocks to avoid repeated extractAllBlocksFromTpl calls
+ * - Limits recursion depth to MAX_DEPTH_ROLLUP_POSSIBILITIES (10 levels)
+ *
+ * @param {Object} params - Parameters object
+ * @param {string} params.tagType - The tag type to find rollup possibilities for (e.g., 'topics', 'districts')
+ * @param {Array} params.allTpls - All templates in the system
+ *
+ * @returns {Array} Array of rollup possibilities
+ *
+ * @example
+ * // Input:
+ * getRollupPossibilities({ tagType: 'topics', allTpls: [...] })
+ *
+ * // Output:
+ * [
+ *   {
+ *     rollupType: 'valuePathType',
+ *     tagTypeCollectionToRollup: 'topics',
+ *     valuePathInRolledUpCollection: 'main.category.value',
+ *     filterSourceValuePath: 'main.category',
+ *     blockValuePath: 'main.category',
+ *     filterDisplay: 'Topic Category'
+ *   },
+ *   {
+ *     rollupType: 'tagType',
+ *     tagTypeCollectionToRollup: 'topics',
+ *     rollupPath: ['topics', 'themes']
+ *   }
+ * ]
+ */
+declare function getRollupPossibilities({ tagType, allTpls }: {
+    tagType: string;
+    allTpls: any[];
+}): any[];
+
 declare namespace BASE_BULLMQ_CONFIG {
     namespace PLUGIN__MAD_USERS_SYNC_QUEUE {
         let id: string;
@@ -1030,4 +1075,4 @@ declare function GET_GLOBAL_BULLMQ_CONFIG({ env, redisCredentials }: {
     };
 }): Object;
 
-export { AIChatSchema, AnnotationSchema, BASE_BULLMQ_CONFIG, BaseProducer, BaseWorker, ElasticSearchConnector, GET_GLOBAL_BULLMQ_CONFIG, MongoConnector, PlatformConfigsSchema, ProducerManager, RedisCacheConnector, TplSchema, WorkerManager, deleteVal, extractAllBlocksFromTpl, genTagId, getAIChatModelByTenant, getAnnotationsModelByTenant, getDbByTenant, getModelByTenant, getPlatformConfigsModelByTenant, getPlatformContextContent, getTplModelByTenant, getVal, _recursExtractBlocks as recursivelyExtractBlocks, setVal, toArray };
+export { AIChatSchema, AnnotationSchema, BASE_BULLMQ_CONFIG, BaseProducer, BaseWorker, ElasticSearchConnector, GET_GLOBAL_BULLMQ_CONFIG, MongoConnector, PlatformConfigsSchema, ProducerManager, RedisCacheConnector, TplSchema, WorkerManager, deleteVal, extractAllBlocksFromTpl, genTagId, getAIChatModelByTenant, getAnnotationsModelByTenant, getDbByTenant, getModelByTenant, getPlatformConfigsModelByTenant, getPlatformContextContent, getRollupPossibilities, getTplModelByTenant, getVal, _recursExtractBlocks as recursivelyExtractBlocks, setVal, toArray };

package/dist/node.d.ts

@@ -158,6 +158,51 @@ declare const _recursExtractBlocks: ({ data, cb, sectionStack, blockPathPrefix }
     blockPathPrefix?: string;
 }) => void;
 
+/**
+ * Calculates all possible rollup relationships for a tag type
+ *
+ * Rollups allow indirect filtering (e.g., filter stories by topic type where stories are tagged with topics)
+ *
+ * Returns two types of possibilities:
+ * 1. **valuePathType**: Direct field rollups within the tag (e.g., topics.main.category)
+ * 2. **tagType**: Nested tag chain rollups (e.g., topics → themes → categories)
+ *
+ * Performance optimizations:
+ * - Caches template blocks to avoid repeated extractAllBlocksFromTpl calls
+ * - Limits recursion depth to MAX_DEPTH_ROLLUP_POSSIBILITIES (10 levels)
+ *
+ * @param {Object} params - Parameters object
+ * @param {string} params.tagType - The tag type to find rollup possibilities for (e.g., 'topics', 'districts')
+ * @param {Array} params.allTpls - All templates in the system
+ *
+ * @returns {Array} Array of rollup possibilities
+ *
+ * @example
+ * // Input:
+ * getRollupPossibilities({ tagType: 'topics', allTpls: [...] })
+ *
+ * // Output:
+ * [
+ *   {
+ *     rollupType: 'valuePathType',
+ *     tagTypeCollectionToRollup: 'topics',
+ *     valuePathInRolledUpCollection: 'main.category.value',
+ *     filterSourceValuePath: 'main.category',
+ *     blockValuePath: 'main.category',
+ *     filterDisplay: 'Topic Category'
+ *   },
+ *   {
+ *     rollupType: 'tagType',
+ *     tagTypeCollectionToRollup: 'topics',
+ *     rollupPath: ['topics', 'themes']
+ *   }
+ * ]
+ */
+declare function getRollupPossibilities({ tagType, allTpls }: {
+    tagType: string;
+    allTpls: any[];
+}): any[];
+
 declare namespace BASE_BULLMQ_CONFIG {
     namespace PLUGIN__MAD_USERS_SYNC_QUEUE {
         let id: string;
@@ -1030,4 +1075,4 @@ declare function GET_GLOBAL_BULLMQ_CONFIG({ env, redisCredentials }: {
     };
 }): Object;
 
-export { AIChatSchema, AnnotationSchema, BASE_BULLMQ_CONFIG, BaseProducer, BaseWorker, ElasticSearchConnector, GET_GLOBAL_BULLMQ_CONFIG, MongoConnector, PlatformConfigsSchema, ProducerManager, RedisCacheConnector, TplSchema, WorkerManager, deleteVal, extractAllBlocksFromTpl, genTagId, getAIChatModelByTenant, getAnnotationsModelByTenant, getDbByTenant, getModelByTenant, getPlatformConfigsModelByTenant, getPlatformContextContent, getTplModelByTenant, getVal, _recursExtractBlocks as recursivelyExtractBlocks, setVal, toArray };
+export { AIChatSchema, AnnotationSchema, BASE_BULLMQ_CONFIG, BaseProducer, BaseWorker, ElasticSearchConnector, GET_GLOBAL_BULLMQ_CONFIG, MongoConnector, PlatformConfigsSchema, ProducerManager, RedisCacheConnector, TplSchema, WorkerManager, deleteVal, extractAllBlocksFromTpl, genTagId, getAIChatModelByTenant, getAnnotationsModelByTenant, getDbByTenant, getModelByTenant, getPlatformConfigsModelByTenant, getPlatformContextContent, getRollupPossibilities, getTplModelByTenant, getVal, _recursExtractBlocks as recursivelyExtractBlocks, setVal, toArray };

package/dist/node.js

@@ -1390,6 +1390,7 @@ __export(node_exports, {
   getModelByTenant: () => import_getModelByTenant2.getModelByTenant,
   getPlatformConfigsModelByTenant: () => import_getModelByTenant2.getPlatformConfigsModelByTenant,
   getPlatformContextContent: () => getPlatformContextContent,
+  getRollupPossibilities: () => getRollupPossibilities,
   getTplModelByTenant: () => import_getModelByTenant2.getTplModelByTenant,
   getVal: () => getVal,
   recursivelyExtractBlocks: () => _recursExtractBlocks,
@@ -1673,6 +1674,85 @@ var _extractBlocksFromSomeBuilders = ({
   }
 };
 
+// src/utils/getRollupPossibilities.ts
+var MAX_DEPTH_ROLLUP_POSSIBILITIES = 10;
+function getRollupPossibilities({
+  tagType,
+  allTpls
+}) {
+  const thisTagTpl = allTpls.find((d) => d.kp_content_type === tagType);
+  if (!thisTagTpl) return [];
+  const allBlocks = extractAllBlocksFromTpl({ tpl: thisTagTpl });
+  const templateBlocksCache = /* @__PURE__ */ new Map();
+  const getCachedTemplateBlocks = (templateTagType) => {
+    if (!templateBlocksCache.has(templateTagType)) {
+      const template = allTpls.find((d) => d.kp_content_type === templateTagType);
+      if (template) {
+        templateBlocksCache.set(templateTagType, extractAllBlocksFromTpl({ tpl: template }));
+      } else {
+        templateBlocksCache.set(templateTagType, []);
+      }
+    }
+    return templateBlocksCache.get(templateTagType);
+  };
+  const findTagChains = (startTagType, visited = [], maxDepth = 10) => {
+    if (visited.includes(startTagType) || visited.length >= maxDepth) {
+      return [];
+    }
+    const tagBlocks = getCachedTemplateBlocks(startTagType).filter(
+      (block) => block.valuePath?.startsWith("tags.")
+    );
+    const chains = [];
+    for (const block of tagBlocks) {
+      const nextTagType = block.props?.tagType;
+      if (nextTagType) {
+        chains.push({
+          rollupType: "tagType",
+          tagTypeCollectionToRollup: tagType,
+          rollupPath: [...visited, startTagType, nextTagType]
+        });
+        if (visited.length < maxDepth - 1) {
+          const nextChains = findTagChains(
+            nextTagType,
+            [...visited, startTagType],
+            maxDepth
+          );
+          chains.push(...nextChains);
+        }
+      }
+    }
+    return chains;
+  };
+  const singleLevelValuePathRollups = allBlocks.map((block) => {
+    if (block.props?.options?.length > 0) {
+      return {
+        rollupType: "valuePathType",
+        tagTypeCollectionToRollup: tagType,
+        // Handle both string values and object values (with .value accessor)
+        valuePathInRolledUpCollection: block.props?.saveValueAsString ? block.valuePath : `${block.valuePath}.value`,
+        filterSourceValuePath: block.valuePath,
+        blockValuePath: block.valuePath,
+        filterDisplay: block.props?.shortLabel || block.props?.label || block.valuePath
+      };
+    }
+    return void 0;
+  }).filter(Boolean);
+  const nestedTagRollups = allBlocks.filter((block) => block.valuePath?.startsWith("tags.")).flatMap((block) => {
+    const directChain = {
+      rollupType: "tagType",
+      tagTypeCollectionToRollup: tagType,
+      rollupPath: [tagType, block.props.tagType]
+    };
+    const deeperChains = findTagChains(
+      block.props?.tagType,
+      [tagType],
+      MAX_DEPTH_ROLLUP_POSSIBILITIES
+    );
+    return [directChain, ...deeperChains];
+  });
+  return [...singleLevelValuePathRollups, ...nestedTagRollups];
+}
+
 // src/universal.ts
 init_GLOBAL_BULLMQ_CONFIG();
 
@@ -2048,6 +2128,7 @@ var import_GET_GLOBAL_BULLMQ_CONFIG = __toESM(require_GET_GLOBAL_BULLMQ_CONFIG()
   getModelByTenant,
   getPlatformConfigsModelByTenant,
   getPlatformContextContent,
+  getRollupPossibilities,
   getTplModelByTenant,
   getVal,
   recursivelyExtractBlocks,

package/dist/node.mjs

@@ -1645,6 +1645,85 @@ var _extractBlocksFromSomeBuilders = ({
   }
 };
 
+// src/utils/getRollupPossibilities.ts
+var MAX_DEPTH_ROLLUP_POSSIBILITIES = 10;
+function getRollupPossibilities({
+  tagType,
+  allTpls
+}) {
+  const thisTagTpl = allTpls.find((d) => d.kp_content_type === tagType);
+  if (!thisTagTpl) return [];
+  const allBlocks = extractAllBlocksFromTpl({ tpl: thisTagTpl });
+  const templateBlocksCache = /* @__PURE__ */ new Map();
+  const getCachedTemplateBlocks = (templateTagType) => {
+    if (!templateBlocksCache.has(templateTagType)) {
+      const template = allTpls.find((d) => d.kp_content_type === templateTagType);
+      if (template) {
+        templateBlocksCache.set(templateTagType, extractAllBlocksFromTpl({ tpl: template }));
+      } else {
+        templateBlocksCache.set(templateTagType, []);
+      }
+    }
+    return templateBlocksCache.get(templateTagType);
+  };
+  const findTagChains = (startTagType, visited = [], maxDepth = 10) => {
+    if (visited.includes(startTagType) || visited.length >= maxDepth) {
+      return [];
+    }
+    const tagBlocks = getCachedTemplateBlocks(startTagType).filter(
+      (block) => block.valuePath?.startsWith("tags.")
+    );
+    const chains = [];
+    for (const block of tagBlocks) {
+      const nextTagType = block.props?.tagType;
+      if (nextTagType) {
+        chains.push({
+          rollupType: "tagType",
+          tagTypeCollectionToRollup: tagType,
+          rollupPath: [...visited, startTagType, nextTagType]
+        });
+        if (visited.length < maxDepth - 1) {
+          const nextChains = findTagChains(
+            nextTagType,
+            [...visited, startTagType],
+            maxDepth
+          );
+          chains.push(...nextChains);
+        }
+      }
+    }
+    return chains;
+  };
+  const singleLevelValuePathRollups = allBlocks.map((block) => {
+    if (block.props?.options?.length > 0) {
+      return {
+        rollupType: "valuePathType",
+        tagTypeCollectionToRollup: tagType,
+        // Handle both string values and object values (with .value accessor)
+        valuePathInRolledUpCollection: block.props?.saveValueAsString ? block.valuePath : `${block.valuePath}.value`,
+        filterSourceValuePath: block.valuePath,
+        blockValuePath: block.valuePath,
+        filterDisplay: block.props?.shortLabel || block.props?.label || block.valuePath
+      };
+    }
+    return void 0;
+  }).filter(Boolean);
+  const nestedTagRollups = allBlocks.filter((block) => block.valuePath?.startsWith("tags.")).flatMap((block) => {
+    const directChain = {
+      rollupType: "tagType",
+      tagTypeCollectionToRollup: tagType,
+      rollupPath: [tagType, block.props.tagType]
+    };
+    const deeperChains = findTagChains(
+      block.props?.tagType,
+      [tagType],
+      MAX_DEPTH_ROLLUP_POSSIBILITIES
+    );
+    return [directChain, ...deeperChains];
+  });
+  return [...singleLevelValuePathRollups, ...nestedTagRollups];
+}
+
 // src/universal.ts
 init_GLOBAL_BULLMQ_CONFIG();
 
@@ -2031,6 +2110,7 @@ export {
   export_getModelByTenant as getModelByTenant,
   export_getPlatformConfigsModelByTenant as getPlatformConfigsModelByTenant,
   getPlatformContextContent,
+  getRollupPossibilities,
   export_getTplModelByTenant as getTplModelByTenant,
   getVal,
   _recursExtractBlocks as recursivelyExtractBlocks,

package/dist/universal.d.mts

@@ -151,6 +151,51 @@ declare const _recursExtractBlocks: ({ data, cb, sectionStack, blockPathPrefix }
     blockPathPrefix?: string;
 }) => void;
 
+/**
+ * Calculates all possible rollup relationships for a tag type
+ *
+ * Rollups allow indirect filtering (e.g., filter stories by topic type where stories are tagged with topics)
+ *
+ * Returns two types of possibilities:
+ * 1. **valuePathType**: Direct field rollups within the tag (e.g., topics.main.category)
+ * 2. **tagType**: Nested tag chain rollups (e.g., topics → themes → categories)
+ *
+ * Performance optimizations:
+ * - Caches template blocks to avoid repeated extractAllBlocksFromTpl calls
+ * - Limits recursion depth to MAX_DEPTH_ROLLUP_POSSIBILITIES (10 levels)
+ *
+ * @param {Object} params - Parameters object
+ * @param {string} params.tagType - The tag type to find rollup possibilities for (e.g., 'topics', 'districts')
+ * @param {Array} params.allTpls - All templates in the system
+ *
+ * @returns {Array} Array of rollup possibilities
+ *
+ * @example
+ * // Input:
+ * getRollupPossibilities({ tagType: 'topics', allTpls: [...] })
+ *
+ * // Output:
+ * [
+ *   {
+ *     rollupType: 'valuePathType',
+ *     tagTypeCollectionToRollup: 'topics',
+ *     valuePathInRolledUpCollection: 'main.category.value',
+ *     filterSourceValuePath: 'main.category',
+ *     blockValuePath: 'main.category',
+ *     filterDisplay: 'Topic Category'
+ *   },
+ *   {
+ *     rollupType: 'tagType',
+ *     tagTypeCollectionToRollup: 'topics',
+ *     rollupPath: ['topics', 'themes']
+ *   }
+ * ]
+ */
+declare function getRollupPossibilities({ tagType, allTpls }: {
+    tagType: string;
+    allTpls: any[];
+}): any[];
+
 declare namespace BASE_BULLMQ_CONFIG {
     namespace PLUGIN__MAD_USERS_SYNC_QUEUE {
         let id: string;
@@ -498,4 +543,4 @@ interface GetPlatformContextContentParams {
 }
 declare const getPlatformContextContent: ({ platformConfigs_ai, }: GetPlatformContextContentParams) => string;
 
-export { BASE_BULLMQ_CONFIG, deleteVal, extractAllBlocksFromTpl, genTagId, getPlatformContextContent, getVal, _recursExtractBlocks as recursivelyExtractBlocks, setVal, toArray };
+export { BASE_BULLMQ_CONFIG, deleteVal, extractAllBlocksFromTpl, genTagId, getPlatformContextContent, getRollupPossibilities, getVal, _recursExtractBlocks as recursivelyExtractBlocks, setVal, toArray };

package/dist/universal.d.ts

@@ -151,6 +151,51 @@ declare const _recursExtractBlocks: ({ data, cb, sectionStack, blockPathPrefix }
     blockPathPrefix?: string;
 }) => void;
 
+/**
+ * Calculates all possible rollup relationships for a tag type
+ *
+ * Rollups allow indirect filtering (e.g., filter stories by topic type where stories are tagged with topics)
+ *
+ * Returns two types of possibilities:
+ * 1. **valuePathType**: Direct field rollups within the tag (e.g., topics.main.category)
+ * 2. **tagType**: Nested tag chain rollups (e.g., topics → themes → categories)
+ *
+ * Performance optimizations:
+ * - Caches template blocks to avoid repeated extractAllBlocksFromTpl calls
+ * - Limits recursion depth to MAX_DEPTH_ROLLUP_POSSIBILITIES (10 levels)
+ *
+ * @param {Object} params - Parameters object
+ * @param {string} params.tagType - The tag type to find rollup possibilities for (e.g., 'topics', 'districts')
+ * @param {Array} params.allTpls - All templates in the system
+ *
+ * @returns {Array} Array of rollup possibilities
+ *
+ * @example
+ * // Input:
+ * getRollupPossibilities({ tagType: 'topics', allTpls: [...] })
+ *
+ * // Output:
+ * [
+ *   {
+ *     rollupType: 'valuePathType',
+ *     tagTypeCollectionToRollup: 'topics',
+ *     valuePathInRolledUpCollection: 'main.category.value',
+ *     filterSourceValuePath: 'main.category',
+ *     blockValuePath: 'main.category',
+ *     filterDisplay: 'Topic Category'
+ *   },
+ *   {
+ *     rollupType: 'tagType',
+ *     tagTypeCollectionToRollup: 'topics',
+ *     rollupPath: ['topics', 'themes']
+ *   }
+ * ]
+ */
+declare function getRollupPossibilities({ tagType, allTpls }: {
+    tagType: string;
+    allTpls: any[];
+}): any[];
+
 declare namespace BASE_BULLMQ_CONFIG {
     namespace PLUGIN__MAD_USERS_SYNC_QUEUE {
         let id: string;
@@ -498,4 +543,4 @@ interface GetPlatformContextContentParams {
 }
 declare const getPlatformContextContent: ({ platformConfigs_ai, }: GetPlatformContextContentParams) => string;
 
-export { BASE_BULLMQ_CONFIG, deleteVal, extractAllBlocksFromTpl, genTagId, getPlatformContextContent, getVal, _recursExtractBlocks as recursivelyExtractBlocks, setVal, toArray };
+export { BASE_BULLMQ_CONFIG, deleteVal, extractAllBlocksFromTpl, genTagId, getPlatformContextContent, getRollupPossibilities, getVal, _recursExtractBlocks as recursivelyExtractBlocks, setVal, toArray };

package/dist/universal.js

@@ -25,6 +25,7 @@ __export(universal_exports, {
   extractAllBlocksFromTpl: () => extractAllBlocksFromTpl,
   genTagId: () => genTagId,
   getPlatformContextContent: () => getPlatformContextContent,
+  getRollupPossibilities: () => getRollupPossibilities,
   getVal: () => getVal,
   recursivelyExtractBlocks: () => _recursExtractBlocks,
   setVal: () => setVal,
@@ -307,6 +308,85 @@ var _extractBlocksFromSomeBuilders = ({
   }
 };
 
+// src/utils/getRollupPossibilities.ts
+var MAX_DEPTH_ROLLUP_POSSIBILITIES = 10;
+function getRollupPossibilities({
+  tagType,
+  allTpls
+}) {
+  const thisTagTpl = allTpls.find((d) => d.kp_content_type === tagType);
+  if (!thisTagTpl) return [];
+  const allBlocks = extractAllBlocksFromTpl({ tpl: thisTagTpl });
+  const templateBlocksCache = /* @__PURE__ */ new Map();
+  const getCachedTemplateBlocks = (templateTagType) => {
+    if (!templateBlocksCache.has(templateTagType)) {
+      const template = allTpls.find((d) => d.kp_content_type === templateTagType);
+      if (template) {
+        templateBlocksCache.set(templateTagType, extractAllBlocksFromTpl({ tpl: template }));
+      } else {
+        templateBlocksCache.set(templateTagType, []);
+      }
+    }
+    return templateBlocksCache.get(templateTagType);
+  };
+  const findTagChains = (startTagType, visited = [], maxDepth = 10) => {
+    if (visited.includes(startTagType) || visited.length >= maxDepth) {
+      return [];
+    }
+    const tagBlocks = getCachedTemplateBlocks(startTagType).filter(
+      (block) => block.valuePath?.startsWith("tags.")
+    );
+    const chains = [];
+    for (const block of tagBlocks) {
+      const nextTagType = block.props?.tagType;
+      if (nextTagType) {
+        chains.push({
+          rollupType: "tagType",
+          tagTypeCollectionToRollup: tagType,
+          rollupPath: [...visited, startTagType, nextTagType]
+        });
+        if (visited.length < maxDepth - 1) {
+          const nextChains = findTagChains(
+            nextTagType,
+            [...visited, startTagType],
+            maxDepth
+          );
+          chains.push(...nextChains);
+        }
+      }
+    }
+    return chains;
+  };
+  const singleLevelValuePathRollups = allBlocks.map((block) => {
+    if (block.props?.options?.length > 0) {
+      return {
+        rollupType: "valuePathType",
+        tagTypeCollectionToRollup: tagType,
+        // Handle both string values and object values (with .value accessor)
+        valuePathInRolledUpCollection: block.props?.saveValueAsString ? block.valuePath : `${block.valuePath}.value`,
+        filterSourceValuePath: block.valuePath,
+        blockValuePath: block.valuePath,
+        filterDisplay: block.props?.shortLabel || block.props?.label || block.valuePath
+      };
+    }
+    return void 0;
+  }).filter(Boolean);
+  const nestedTagRollups = allBlocks.filter((block) => block.valuePath?.startsWith("tags.")).flatMap((block) => {
+    const directChain = {
+      rollupType: "tagType",
+      tagTypeCollectionToRollup: tagType,
+      rollupPath: [tagType, block.props.tagType]
+    };
+    const deeperChains = findTagChains(
+      block.props?.tagType,
+      [tagType],
+      MAX_DEPTH_ROLLUP_POSSIBILITIES
+    );
+    return [directChain, ...deeperChains];
+  });
+  return [...singleLevelValuePathRollups, ...nestedTagRollups];
+}
+
 // src/bullmq/GLOBAL_BULLMQ_CONFIG.js
 var BASE_BULLMQ_CONFIG = {
   PLUGIN__MAD_USERS_SYNC_QUEUE: {
@@ -577,6 +657,7 @@ ${v?.markdownText || ""}` : v?.markdownText || "";
   extractAllBlocksFromTpl,
   genTagId,
   getPlatformContextContent,
+  getRollupPossibilities,
   getVal,
   recursivelyExtractBlocks,
   setVal,

package/dist/universal.mjs

@@ -273,6 +273,85 @@ var _extractBlocksFromSomeBuilders = ({
   }
 };
 
+// src/utils/getRollupPossibilities.ts
+var MAX_DEPTH_ROLLUP_POSSIBILITIES = 10;
+function getRollupPossibilities({
+  tagType,
+  allTpls
+}) {
+  const thisTagTpl = allTpls.find((d) => d.kp_content_type === tagType);
+  if (!thisTagTpl) return [];
+  const allBlocks = extractAllBlocksFromTpl({ tpl: thisTagTpl });
+  const templateBlocksCache = /* @__PURE__ */ new Map();
+  const getCachedTemplateBlocks = (templateTagType) => {
+    if (!templateBlocksCache.has(templateTagType)) {
+      const template = allTpls.find((d) => d.kp_content_type === templateTagType);
+      if (template) {
+        templateBlocksCache.set(templateTagType, extractAllBlocksFromTpl({ tpl: template }));
+      } else {
+        templateBlocksCache.set(templateTagType, []);
+      }
+    }
+    return templateBlocksCache.get(templateTagType);
+  };
+  const findTagChains = (startTagType, visited = [], maxDepth = 10) => {
+    if (visited.includes(startTagType) || visited.length >= maxDepth) {
+      return [];
+    }
+    const tagBlocks = getCachedTemplateBlocks(startTagType).filter(
+      (block) => block.valuePath?.startsWith("tags.")
+    );
+    const chains = [];
+    for (const block of tagBlocks) {
+      const nextTagType = block.props?.tagType;
+      if (nextTagType) {
+        chains.push({
+          rollupType: "tagType",
+          tagTypeCollectionToRollup: tagType,
+          rollupPath: [...visited, startTagType, nextTagType]
+        });
+        if (visited.length < maxDepth - 1) {
+          const nextChains = findTagChains(
+            nextTagType,
+            [...visited, startTagType],
+            maxDepth
+          );
+          chains.push(...nextChains);
+        }
+      }
+    }
+    return chains;
+  };
+  const singleLevelValuePathRollups = allBlocks.map((block) => {
+    if (block.props?.options?.length > 0) {
+      return {
+        rollupType: "valuePathType",
+        tagTypeCollectionToRollup: tagType,
+        // Handle both string values and object values (with .value accessor)
+        valuePathInRolledUpCollection: block.props?.saveValueAsString ? block.valuePath : `${block.valuePath}.value`,
+        filterSourceValuePath: block.valuePath,
+        blockValuePath: block.valuePath,
+        filterDisplay: block.props?.shortLabel || block.props?.label || block.valuePath
+      };
+    }
+    return void 0;
+  }).filter(Boolean);
+  const nestedTagRollups = allBlocks.filter((block) => block.valuePath?.startsWith("tags.")).flatMap((block) => {
+    const directChain = {
+      rollupType: "tagType",
+      tagTypeCollectionToRollup: tagType,
+      rollupPath: [tagType, block.props.tagType]
+    };
+    const deeperChains = findTagChains(
+      block.props?.tagType,
+      [tagType],
+      MAX_DEPTH_ROLLUP_POSSIBILITIES
+    );
+    return [directChain, ...deeperChains];
+  });
+  return [...singleLevelValuePathRollups, ...nestedTagRollups];
+}
+
 // src/bullmq/GLOBAL_BULLMQ_CONFIG.js
 var BASE_BULLMQ_CONFIG = {
   PLUGIN__MAD_USERS_SYNC_QUEUE: {
@@ -542,6 +621,7 @@ export {
   extractAllBlocksFromTpl,
   genTagId,
   getPlatformContextContent,
+  getRollupPossibilities,
   getVal,
   _recursExtractBlocks as recursivelyExtractBlocks,
   setVal,

package/package.json

@@ -3,7 +3,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "1.6.13",
+  "version": "1.6.14",
   "description": "Utility functions for both browser and Node.js",
   "main": "dist/index.js",
   "module": "dist/index.mjs",