@okf/ootils 1.27.0 → 1.28.1

package/dist/node.d.ts

@@ -1027,6 +1027,51 @@ declare const _self_managed_buildAnnoHierarchyConfig: ({ annotationTagsCount, }:
     };
 } | null;
 
+/**
+ * Builds a consolidated docHierarchyType config for self-managed tenants.
+ *
+ * Produces a single filter config that contains:
+ * - commonFilters: filters present in ALL selected templates
+ * - sharedAcrossMultiple: groups of filters shared by 2+ (but not all) templates
+ * - perDataset: each template's complete filter list + rollup configs
+ * - commonDocumentFilters: Author, Published Date, etc.
+ *
+ * This is consumed by DocHierarchyFilter on the frontend to render the
+ * drilldown-based document filter UI.
+ */
+declare const _self_managed_buildDocHierarchyConfig: ({ combinedDocumentBlocks, docRollupBlocks, selectedTpls, allTpls, commonDocumentFilters, flatDocFilters, }: {
+    combinedDocumentBlocks: any[];
+    docRollupBlocks: any[];
+    selectedTpls: any[];
+    allTpls: any[];
+    commonDocumentFilters: any[];
+    flatDocFilters?: boolean;
+}) => {
+    filterId: string;
+    display: string;
+    filterKey: string;
+    source: {
+        filterType: string;
+        flatDocFilters: boolean;
+        commonFilters: any[];
+        sharedAcrossMultiple: {
+            contentTypes: any;
+            display: any;
+            filters: any[];
+        }[];
+        commonDocumentFilters: any[];
+        perDataset: {
+            contentType: any;
+            display: any;
+            filters: any[];
+            rollups: any[];
+        }[];
+    };
+    target: {
+        filterType: string;
+    };
+} | null;
+
 /**
  * TEMP_removeDuplicateFilters - Removes duplicate rollup and tag-type filters
  *
@@ -1121,6 +1166,37 @@ declare const autoGenFilterConfigsFromTpl: ({ selectedTpls, allTpls, filterScope
         sectionId: string;
         configs: any[];
     }[];
+} | {
+    sectionId: string;
+    configs: {
+        sectionId: string;
+        configs: {
+            filterId: string;
+            display: string;
+            filterKey: string;
+            source: {
+                filterType: string;
+                flatDocFilters: boolean;
+                commonFilters: any[];
+                sharedAcrossMultiple: {
+                    contentTypes: any;
+                    display: any;
+                    filters: any[];
+                }[];
+                commonDocumentFilters: any[];
+                perDataset: {
+                    contentType: any;
+                    display: any;
+                    filters: any[];
+                    rollups: any[];
+                }[];
+            };
+            target: {
+                filterType: string;
+            };
+        }[];
+    }[];
+    sectionTitle?: undefined;
 } | {
     sectionId: string;
     sectionTitle: string;
@@ -1191,11 +1267,30 @@ declare const UI_CONTENT: {
     };
 };
 
-declare const genCleanCamelCaseId: (id: string) => string;
+interface GenCleanCamelCaseIdOptions {
+    /** Strip all non-alphanumeric chars (A-Z, a-z, 0-9 only). Default: false */
+    stripNonAlphanumeric?: boolean;
+    /** Truncate result to this max length. Default: no limit */
+    maxLength?: number;
+}
+declare const genCleanCamelCaseId: (id: string, options?: GenCleanCamelCaseIdOptions) => string;
+
+/**
+ * Generates a clean, deterministic contentType ID from text.
+ * Wraps genCleanCamelCaseId with stripNonAlphanumeric + maxLength 40.
+ *
+ * Idempotent: running twice produces the same output.
+ *
+ * @example
+ * genCleanContentTypeId("My Articles!")  => "myArticles"
+ * genCleanContentTypeId("myArticles")    => "myArticles" (idempotent)
+ * genCleanContentTypeId("123 Test")      => "a123Test"
+ */
+declare const genCleanContentTypeId: (text: string) => string;
 
 /**
  * Generates a clean, short, unique ID from text input.
- * Used for both contentType IDs and block valuePaths.
+ * Used for block valuePaths in templates.
  *
  * 1. Strips all characters except A-Z, a-z, 0-9
  * 2. Lowercases the result
@@ -1203,16 +1298,19 @@ declare const genCleanCamelCaseId: (id: string) => string;
  * 4. Truncates to maxLength (default 10)
  * 5. Appends _{random id} (default 4 chars)
  *
+ * Idempotent: if input already matches the output pattern
+ * (lowercase alphanumeric + _hash suffix), returns as-is.
+ *
  * @param text - The input text to convert
- * @param maxLength - Max characters before the random suffix (default 10, use 20 for contentType)
+ * @param maxLength - Max characters before the random suffix (default 10)
  * @param shortIdLength - Length of the random suffix (default 4)
  *
  * @example
- * genCleanIdForContentTypeAndValuePaths("Author Name")        => "authorname_x7k2"
- * genCleanIdForContentTypeAndValuePaths("My Articles!", 20)   => "myarticles_m3p1"
- * genCleanIdForContentTypeAndValuePaths("123 Test")           => "a123test_ab4d"
+ * genCleanValuePath("Author Name")       => "authorname_x7k2"
+ * genCleanValuePath("authorname_x7k2")   => "authorname_x7k2" (idempotent)
+ * genCleanValuePath("123 Test")           => "a123test_ab4d"
  */
-declare const genCleanIdForContentTypeAndValuePaths: (text: string, maxLength?: number, shortIdLength?: number) => string;
+declare const genCleanValuePath: (text: string) => string;
 
 declare class MongoConnector {
     static getInstance(): any;
@@ -1944,4 +2042,4 @@ declare function GET_GLOBAL_BULLMQ_CONFIG({ env, redisCredentials }: {
     };
 }): Object;
 
-export { AIChatSchema, AnnosElasticSyncProducer, AnnotationSchema, BASE_BULLMQ_CONFIG, BaseProducer, BaseWorker, ChunksElasticSyncProducer, ElasticSearchConnector, FILTER_IDS, GET_GLOBAL_BULLMQ_CONFIG, GeneratedEntitiesSchema, GeneratedTopicsSchema, MongoConnector, PlatformConfigsSchema, ProducerManager, RedisCacheConnector, SecretManagerConnector, TEMP_removeDuplicateFilters, TplSchema, UI_CONTENT, WorkerManager, _self_managed_buildAnnoHierarchyConfig, _self_managed_getFixedAnnoRollupBlocks, _self_managed_getFixedAnnoTagBlock, autoGenFilterConfigsFromTpl, buildFilterConfigurations, compareAndGroupBlocks, deleteVal, extractAllBlocksFromTpl, extractAndOrganizeBlocks, genCleanCamelCaseId, genCleanIdForContentTypeAndValuePaths, genTagId, generateFilterKey, getAIChatModelByTenant, getAnnotationsModelByTenant, getDbByTenant, getFilterKeyForBlock, getGeneratedEntitiesModelByTenant, getGeneratedTopicsModelByTenant, getModelByTenant, getPlatformConfigsModelByTenant, getPlatformContextContent, getRollupPossibilities, getRoutePathToEditContent, getRoutePathToModerateContent, getRoutePathToPublishedContent, getTplModelByTenant, getVal, mergeAnnoDataIntoAnnotationsTags, parseSpecialConfigSyntax, processAuthorAndCommonFilters, _recursExtractBlocks as recursivelyExtractBlocks, segrigateDocs, setVal, toArray };
+export { AIChatSchema, AnnosElasticSyncProducer, AnnotationSchema, BASE_BULLMQ_CONFIG, BaseProducer, BaseWorker, ChunksElasticSyncProducer, ElasticSearchConnector, FILTER_IDS, GET_GLOBAL_BULLMQ_CONFIG, GeneratedEntitiesSchema, GeneratedTopicsSchema, MongoConnector, PlatformConfigsSchema, ProducerManager, RedisCacheConnector, SecretManagerConnector, TEMP_removeDuplicateFilters, TplSchema, UI_CONTENT, WorkerManager, _self_managed_buildAnnoHierarchyConfig, _self_managed_buildDocHierarchyConfig, _self_managed_getFixedAnnoRollupBlocks, _self_managed_getFixedAnnoTagBlock, autoGenFilterConfigsFromTpl, buildFilterConfigurations, compareAndGroupBlocks, deleteVal, extractAllBlocksFromTpl, extractAndOrganizeBlocks, genCleanCamelCaseId, genCleanContentTypeId, genCleanValuePath, genTagId, generateFilterKey, getAIChatModelByTenant, getAnnotationsModelByTenant, getDbByTenant, getFilterKeyForBlock, getGeneratedEntitiesModelByTenant, getGeneratedTopicsModelByTenant, getModelByTenant, getPlatformConfigsModelByTenant, getPlatformContextContent, getRollupPossibilities, getRoutePathToEditContent, getRoutePathToModerateContent, getRoutePathToPublishedContent, getTplModelByTenant, getVal, mergeAnnoDataIntoAnnotationsTags, parseSpecialConfigSyntax, processAuthorAndCommonFilters, _recursExtractBlocks as recursivelyExtractBlocks, segrigateDocs, setVal, toArray };

package/dist/node.js

@@ -1939,6 +1939,7 @@ __export(node_exports, {
   UI_CONTENT: () => UI_CONTENT,
   WorkerManager: () => import_WorkerManager.WorkerManager,
   _self_managed_buildAnnoHierarchyConfig: () => _self_managed_buildAnnoHierarchyConfig,
+  _self_managed_buildDocHierarchyConfig: () => _self_managed_buildDocHierarchyConfig,
   _self_managed_getFixedAnnoRollupBlocks: () => _self_managed_getFixedAnnoRollupBlocks,
   _self_managed_getFixedAnnoTagBlock: () => _self_managed_getFixedAnnoTagBlock,
   autoGenFilterConfigsFromTpl: () => autoGenFilterConfigsFromTpl,
@@ -1948,7 +1949,8 @@ __export(node_exports, {
   extractAllBlocksFromTpl: () => extractAllBlocksFromTpl,
   extractAndOrganizeBlocks: () => extractAndOrganizeBlocks,
   genCleanCamelCaseId: () => genCleanCamelCaseId,
-  genCleanIdForContentTypeAndValuePaths: () => genCleanIdForContentTypeAndValuePaths,
+  genCleanContentTypeId: () => genCleanContentTypeId,
+  genCleanValuePath: () => genCleanValuePath,
   genTagId: () => genTagId,
   generateFilterKey: () => generateFilterKey,
   getAIChatModelByTenant: () => import_getModelByTenant2.getAIChatModelByTenant,
@@ -2664,6 +2666,7 @@ var buildFilterConfigurations = ({ groups, type, selectedTpls, allTpls, isRollup
             filterKey,
             contentType: element.contentType,
             path: element.valuePath,
+            ...element.comp && { comp: element.comp },
             source: {
               filterType: "tplType",
               contentType: element.contentType,
@@ -2689,6 +2692,7 @@ var buildFilterConfigurations = ({ groups, type, selectedTpls, allTpls, isRollup
           filterKey: valuePathFilterKey,
           contentType: element.contentType,
           path: element.valuePath,
+          ...element.comp && { comp: element.comp },
           source: {
             filterType: "tplType",
             contentType: element.contentType,
@@ -2714,6 +2718,7 @@ var buildFilterConfigurations = ({ groups, type, selectedTpls, allTpls, isRollup
           filterKey: dateFilterKey,
           contentType: element.contentType,
           path: element.valuePath,
+          ...element.comp && { comp: element.comp },
           source: { filterType: "dateRangeType" },
           target: { filterType: "dateRangeType", valuePath: element.valuePath }
         };
@@ -2731,6 +2736,7 @@ var buildFilterConfigurations = ({ groups, type, selectedTpls, allTpls, isRollup
           filterKey: numberFilterKey,
           contentType: element.contentType,
           path: element.valuePath,
+          ...element.comp && { comp: element.comp },
           source: { filterType: "numberRangeType", valuePath: element.valuePath },
           target: { filterType: "numberRangeType", valuePath: element.valuePath }
         };
@@ -2851,6 +2857,7 @@ var buildFilterConfigurations = ({ groups, type, selectedTpls, allTpls, isRollup
           filterKey: tagFilterKey,
           contentType: element.tagType,
           path: `tags.${element.tagType}`,
+          ...element.comp && { comp: element.comp },
           source: allProfileTpls.some(
             (tpl) => tpl.kp_content_type === element.tagType
           ) ? {
@@ -2992,6 +2999,7 @@ var extractAndOrganizeBlocks = (selectedTpls, allTpls) => {
       contentType: tpl.kp_content_type,
       blocks: allBlocks.filter((block) => block.valuePath.startsWith("tags.")).map((block) => ({
         tagType: block.props.tagType,
+        comp: block.comp,
         filterType: "tagType"
       }))
     };
@@ -3019,6 +3027,7 @@ var extractAndOrganizeBlocks = (selectedTpls, allTpls) => {
         value: block.valuePath,
         saveValueAsString: block.props?.saveValueAsString,
         contentType: tpl.kp_content_type,
+        comp: block.comp,
         filterType: "valuePathType"
       }))
     };
@@ -3033,6 +3042,7 @@ var extractAndOrganizeBlocks = (selectedTpls, allTpls) => {
         value: block.valuePath,
         saveValueAsString: block.props?.saveValueAsString,
         contentType: tpl.kp_content_type,
+        comp: block.comp,
         block,
         filterType: "split_valuePathType"
       }))
@@ -3047,6 +3057,7 @@ var extractAndOrganizeBlocks = (selectedTpls, allTpls) => {
         display: block.props?.shortLabel || block.props?.label || block.valuePath,
         value: block.valuePath,
         contentType: tpl.kp_content_type,
+        comp: block.comp,
         filterType: "dateRangeType"
       }))
     };
@@ -3060,6 +3071,7 @@ var extractAndOrganizeBlocks = (selectedTpls, allTpls) => {
         display: block.props?.shortLabel || block.props?.label || block.valuePath,
         value: block.valuePath,
         contentType: tpl.kp_content_type,
+        comp: block.comp,
         filterType: "numberRangeType"
       }))
     };
@@ -3306,6 +3318,240 @@ var _self_managed_buildAnnoHierarchyConfig = ({
   };
 };
 
+// src/utils/autoGenFilterConfigsFromTpl/utils/buildTagTypeParentMap.ts
+var buildTagTypeParentMap = (tagTypesInGroup, allTpls) => {
+  const tagTypeSet = new Set(tagTypesInGroup);
+  const parentMap = /* @__PURE__ */ new Map();
+  for (const tagType of tagTypesInGroup) {
+    const tpl = allTpls.find((t) => t.kp_content_type === tagType);
+    if (!tpl) continue;
+    const blocks = extractAllBlocksFromTpl({ tpl });
+    const tagBlocks = blocks.filter(
+      (block) => block.valuePath?.startsWith("tags.") && block.props?.tagType
+    );
+    for (const block of tagBlocks) {
+      const referencedTagType = block.props.tagType;
+      if (tagTypeSet.has(referencedTagType) && referencedTagType !== tagType) {
+        parentMap.set(tagType, referencedTagType);
+        break;
+      }
+    }
+  }
+  for (const child of parentMap.keys()) {
+    const visited = /* @__PURE__ */ new Set();
+    let current = child;
+    while (current && parentMap.has(current)) {
+      if (visited.has(current)) {
+        parentMap.delete(current);
+        break;
+      }
+      visited.add(current);
+      current = parentMap.get(current);
+    }
+  }
+  return parentMap;
+};
+var attachParentFields = (filters, allTpls) => {
+  const tagTypeFilters = filters.filter(
+    (f) => f.source?.filterType === "tagType" && f.source?.tagType
+  );
+  if (tagTypeFilters.length === 0) return filters;
+  const tagTypesInGroup = tagTypeFilters.map((f) => f.source.tagType);
+  const parentMap = buildTagTypeParentMap(tagTypesInGroup, allTpls);
+  if (parentMap.size === 0) return filters;
+  const tagTypeToFilterId = /* @__PURE__ */ new Map();
+  for (const f of tagTypeFilters) {
+    tagTypeToFilterId.set(f.source.tagType, f.filterId);
+  }
+  return filters.map((f) => {
+    if (f.source?.filterType !== "tagType" || !f.source?.tagType) return f;
+    const parentTagType = parentMap.get(f.source.tagType);
+    if (!parentTagType) return f;
+    const parentFilterId = tagTypeToFilterId.get(parentTagType);
+    if (!parentFilterId) return f;
+    return { ...f, parentFilterId };
+  });
+};
+var sortFiltersHierarchically = (filters) => {
+  if (filters.length <= 1) return filters;
+  const hasHierarchy = filters.some((f) => f.parentFilterId);
+  if (!hasHierarchy) return filters;
+  const childrenOf = /* @__PURE__ */ new Map();
+  const roots = [];
+  for (const f of filters) {
+    if (!f.parentFilterId) {
+      roots.push(f);
+    } else {
+      const siblings = childrenOf.get(f.parentFilterId) || [];
+      siblings.push(f);
+      childrenOf.set(f.parentFilterId, siblings);
+    }
+  }
+  const sorted = [];
+  const visited = /* @__PURE__ */ new Set();
+  const visit = (filter) => {
+    if (visited.has(filter.filterId)) return;
+    visited.add(filter.filterId);
+    sorted.push(filter);
+    const children = childrenOf.get(filter.filterId) || [];
+    for (const child of children) {
+      visit(child);
+    }
+  };
+  for (const root of roots) {
+    visit(root);
+  }
+  for (const f of filters) {
+    if (!visited.has(f.filterId)) {
+      sorted.push(f);
+    }
+  }
+  return sorted;
+};
+
+// src/utils/autoGenFilterConfigsFromTpl/utils/_self_managed_buildDocHierarchyConfig.ts
+var _self_managed_buildDocHierarchyConfig = ({
+  combinedDocumentBlocks,
+  docRollupBlocks,
+  selectedTpls,
+  allTpls,
+  commonDocumentFilters,
+  flatDocFilters = false
+}) => {
+  const allGroups = compareAndGroupBlocks(combinedDocumentBlocks);
+  const commonGroup = allGroups.find(
+    (g) => g.contentTypes.length === selectedTpls.length
+  );
+  const commonFilterConfigs = commonGroup ? sortFiltersHierarchically(
+    attachParentFields(
+      buildFilterConfigurations({
+        groups: [commonGroup],
+        type: "tags",
+        selectedTpls,
+        allTpls,
+        isRollup: false,
+        isAnno: false
+      }).flatMap((s) => s.configs),
+      allTpls
+    )
+  ) : [];
+  const multiDatasetGroups = selectedTpls.length >= 2 ? allGroups.filter(
+    (g) => g.contentTypes.length > 1 && g.contentTypes.length < selectedTpls.length
+  ) : [];
+  const sharedAcrossMultiple = multiDatasetGroups.map((group) => {
+    const groupFilterConfigs = sortFiltersHierarchically(
+      attachParentFields(
+        buildFilterConfigurations({
+          groups: [group],
+          type: "tags",
+          selectedTpls,
+          allTpls,
+          isRollup: false,
+          isAnno: false
+        }).flatMap((s) => s.configs),
+        allTpls
+      )
+    );
+    const display = group.contentTypes.map((ct) => {
+      const tplData = allTpls.find(
+        (t) => t.kp_content_type === ct
+      );
+      return tplData?.general?.content?.title || ct;
+    }).join(" + ");
+    return {
+      contentTypes: group.contentTypes,
+      display,
+      filters: groupFilterConfigs
+    };
+  }).filter((g) => g.filters.length > 0);
+  const commonFilterIds = new Set(commonFilterConfigs.map((f) => f.filterId));
+  const perDataset = selectedTpls.map((tpl) => {
+    const tplBlocks = combinedDocumentBlocks.find(
+      (b) => b.contentType === tpl.kp_content_type
+    );
+    const singleTplGroup = [
+      {
+        contentTypes: [tpl.kp_content_type],
+        elements: tplBlocks?.blocks || []
+      }
+    ];
+    const filters = buildFilterConfigurations({
+      groups: singleTplGroup,
+      type: "tags",
+      selectedTpls: [tpl],
+      allTpls,
+      isRollup: false,
+      isAnno: false
+    }).flatMap((s) => s.configs);
+    const filtersWithCommonFlag = filters.map((f) => ({
+      ...f,
+      isSharedFilter: commonFilterIds.has(f.filterId)
+    }));
+    const rollupData = docRollupBlocks?.find(
+      (b) => b.contentType === tpl.kp_content_type
+    );
+    const rollupGroups = rollupData?.blocks?.length ? compareAndGroupBlocks([rollupData]) : [];
+    const rollupConfigs = rollupGroups.length ? buildFilterConfigurations({
+      groups: rollupGroups,
+      type: "tags",
+      selectedTpls: [tpl],
+      allTpls,
+      isRollup: true,
+      isAnno: false
+    }).flatMap((s) => s.configs) : [];
+    const tplData = allTpls.find(
+      (t) => t.kp_content_type === tpl.kp_content_type
+    );
+    const rollupSourceKeys = new Set(
+      rollupConfigs.map((r) => JSON.stringify(r.source))
+    );
+    const dedupedFilters = filtersWithCommonFlag.filter(
+      (f) => !rollupSourceKeys.has(JSON.stringify(f.source))
+    );
+    const combined = [...dedupedFilters, ...rollupConfigs];
+    const combinedWithParents = sortFiltersHierarchically(
+      attachParentFields(combined, allTpls)
+    );
+    const rollupFilterIds = new Set(rollupConfigs.map((r) => r.filterId));
+    const filtersWithParents = combinedWithParents.filter(
+      (f) => !rollupFilterIds.has(f.filterId)
+    );
+    const rollupsWithParents = combinedWithParents.filter(
+      (f) => rollupFilterIds.has(f.filterId)
+    );
+    return {
+      contentType: tpl.kp_content_type,
+      display: tplData?.general?.content?.title || tpl.kp_content_type,
+      filters: filtersWithParents,
+      rollups: rollupsWithParents
+    };
+  });
+  const filteredPerDataset = perDataset.filter(
+    (d) => d.filters.length > 0 || d.rollups.length > 0
+  );
+  if (commonFilterConfigs.length === 0 && sharedAcrossMultiple.length === 0 && filteredPerDataset.every((d) => d.filters.length === 0)) {
+    return null;
+  }
+  const flatCommonDocFilters = commonDocumentFilters.flatMap(
+    (s) => s.configs || [s]
+  );
+  const shouldFlatten = flatDocFilters && selectedTpls.length === 1;
+  return {
+    filterId: "docHierarchy_document_filters",
+    display: "Combined Content Filters",
+    filterKey: "docHierarchyType::doc",
+    source: {
+      filterType: "docHierarchyType",
+      flatDocFilters: shouldFlatten,
+      commonFilters: commonFilterConfigs,
+      sharedAcrossMultiple,
+      commonDocumentFilters: flatCommonDocFilters,
+      perDataset: filteredPerDataset
+    },
+    target: { filterType: "docHierarchyType" }
+  };
+};
+
 // src/utils/autoGenFilterConfigsFromTpl/utils/TEMP_removeDuplicateFilters.ts
 var TEMP_removeDuplicateFilters = (filterGroups) => {
   return filterGroups.map((group) => {
@@ -3442,7 +3688,25 @@ var autoGenFilterConfigsFromTpl = ({
       ...annotationRollupSections
     ].filter((section) => Array.isArray(section.configs) ? section.configs.length > 0 : true)
   };
-  const final_documentTagsFilterConfigs = {
+  const isSMTDocFilterUI = isSelfManagedTenant && filterScopes.includes("doc");
+  const final_documentTagsFilterConfigs = isSMTDocFilterUI ? (() => {
+    const docHierarchyConfig = _self_managed_buildDocHierarchyConfig({
+      combinedDocumentBlocks: extractedBlocks.combinedDocumentBlocks,
+      docRollupBlocks: extractedBlocks.docRollupBlocks,
+      selectedTpls,
+      allTpls,
+      commonDocumentFilters
+    });
+    if (!docHierarchyConfig) return { sectionId: "documentTagsSection", sectionTitle: "Document Filters", configs: [] };
+    return {
+      sectionId: "documentTagsSection",
+      // sectionTitle: 'Document Filters',
+      configs: [{
+        sectionId: "self_managed_consolidated_doc_filters",
+        configs: [docHierarchyConfig]
+      }]
+    };
+  })() : {
     sectionId: "documentTagsSection",
     sectionTitle: "Document Filters",
     configs: [
@@ -3458,20 +3722,33 @@ var autoGenFilterConfigsFromTpl = ({
 };
 
 // src/utils/genCleanCamelCaseId.ts
-var genCleanCamelCaseId = (id) => {
+var genCleanCamelCaseId = (id, options) => {
   if (!id || typeof id !== "string") return id;
-  const isAlreadyClean = /^\p{Ll}[\p{L}\p{N}]*$/u.test(id) || /^a\d[\p{L}\p{N}]*$/u.test(id);
-  if (isAlreadyClean) return id;
+  const { stripNonAlphanumeric = false, maxLength } = options || {};
+  const baseClean = /^\p{Ll}[\p{L}\p{N}]*$/u.test(id) || /^a\d[\p{L}\p{N}]*$/u.test(id);
+  const withinMaxLength = maxLength ? id.length <= maxLength : true;
+  const hasNoNonAlpha = stripNonAlphanumeric ? /^[a-zA-Z0-9]+$/.test(id) : true;
+  if (baseClean && withinMaxLength && hasNoNonAlpha) return id;
   const words = id.split(/[^\p{L}\p{N}]+/u).filter(Boolean);
   if (words.length === 0) return "a";
-  const result = words.map((word, i) => {
+  let result = words.map((word, i) => {
     const lower = word.toLowerCase();
     return i === 0 ? lower : lower.charAt(0).toUpperCase() + lower.slice(1);
   }).join("");
-  return /^\d/.test(result) ? "a" + result : result;
+  if (/^\d/.test(result)) result = "a" + result;
+  if (stripNonAlphanumeric) {
+    result = result.replace(/[^a-zA-Z0-9]/g, "");
+  }
+  if (maxLength) {
+    result = result.slice(0, maxLength);
+  }
+  return result;
 };
 
-// src/utils/genCleanIdForContentTypeAndValuePaths.ts
+// src/utils/genCleanContentTypeId.ts
+var genCleanContentTypeId = (text) => genCleanCamelCaseId(text, { stripNonAlphanumeric: true, maxLength: 40 });
+
+// src/utils/genCleanValuePath.ts
 var CHARS = "abcdefghijklmnopqrstuvwxyz0123456789";
 function genShortId(length = 4) {
   let result = "";
@@ -3480,11 +3757,15 @@ function genShortId(length = 4) {
   }
   return result;
 }
-var genCleanIdForContentTypeAndValuePaths = (text, maxLength = 10, shortIdLength = 4) => {
+var genCleanValuePath = (text) => {
+  const maxLength = 10;
+  const shortIdLength = 4;
   if (!text || typeof text !== "string") return text;
+  const idempotencyPattern = new RegExp(`^[a-z][a-z0-9]*_[a-z0-9]{${shortIdLength}}$`);
+  if (idempotencyPattern.test(text)) return text;
   let cleaned = text.replace(/[^a-zA-Z0-9]/g, "").toLowerCase();
   if (!cleaned) {
-    throw new Error(`[genCleanIdForContentTypeAndValuePaths] Input "${text}" contains no alphanumeric characters`);
+    throw new Error(`[genCleanValuePath] Input "${text}" contains no alphanumeric characters`);
   }
   if (/^\d/.test(cleaned)) cleaned = "a" + cleaned;
   const truncated = cleaned.slice(0, maxLength);
@@ -3898,6 +4179,7 @@ var import_GET_GLOBAL_BULLMQ_CONFIG = __toESM(require_GET_GLOBAL_BULLMQ_CONFIG()
   UI_CONTENT,
   WorkerManager,
   _self_managed_buildAnnoHierarchyConfig,
+  _self_managed_buildDocHierarchyConfig,
   _self_managed_getFixedAnnoRollupBlocks,
   _self_managed_getFixedAnnoTagBlock,
   autoGenFilterConfigsFromTpl,
@@ -3907,7 +4189,8 @@ var import_GET_GLOBAL_BULLMQ_CONFIG = __toESM(require_GET_GLOBAL_BULLMQ_CONFIG()
   extractAllBlocksFromTpl,
   extractAndOrganizeBlocks,
   genCleanCamelCaseId,
-  genCleanIdForContentTypeAndValuePaths,
+  genCleanContentTypeId,
+  genCleanValuePath,
   genTagId,
   generateFilterKey,
   getAIChatModelByTenant,