npm - @okf/ootils - Versions diffs - 1.6.13 → 1.6.14 - Mend

@okf/ootils 1.6.13 → 1.6.14

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (13) hide show

package/dist/browser.d.mts CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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",