@okf/ootils 1.26.4 → 1.27.0

package/dist/browser.d.mts

@@ -1184,4 +1184,27 @@ declare const UI_CONTENT: {
     };
 };
 
-export { BASE_BULLMQ_CONFIG, FILTER_IDS, TEMP_removeDuplicateFilters, UI_CONTENT, _self_managed_buildAnnoHierarchyConfig, _self_managed_getFixedAnnoRollupBlocks, _self_managed_getFixedAnnoTagBlock, autoGenFilterConfigsFromTpl, buildFilterConfigurations, compareAndGroupBlocks, deleteVal, extractAllBlocksFromTpl, extractAndOrganizeBlocks, genTagId, generateFilterKey, getFilterKeyForBlock, getPlatformContextContent, getRollupPossibilities, getRoutePathToEditContent, getRoutePathToModerateContent, getRoutePathToPublishedContent, getVal, mergeAnnoDataIntoAnnotationsTags, parseSpecialConfigSyntax, processAuthorAndCommonFilters, _recursExtractBlocks as recursivelyExtractBlocks, segrigateDocs, setVal, toArray };
+declare const genCleanCamelCaseId: (id: string) => string;
+
+/**
+ * Generates a clean, short, unique ID from text input.
+ * Used for both contentType IDs and block valuePaths.
+ *
+ * 1. Strips all characters except A-Z, a-z, 0-9
+ * 2. Lowercases the result
+ * 3. Prepends 'a' if starts with a digit
+ * 4. Truncates to maxLength (default 10)
+ * 5. Appends _{random id} (default 4 chars)
+ *
+ * @param text - The input text to convert
+ * @param maxLength - Max characters before the random suffix (default 10, use 20 for contentType)
+ * @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"
+ */
+declare const genCleanIdForContentTypeAndValuePaths: (text: string, maxLength?: number, shortIdLength?: number) => string;
+
+export { BASE_BULLMQ_CONFIG, FILTER_IDS, TEMP_removeDuplicateFilters, UI_CONTENT, _self_managed_buildAnnoHierarchyConfig, _self_managed_getFixedAnnoRollupBlocks, _self_managed_getFixedAnnoTagBlock, autoGenFilterConfigsFromTpl, buildFilterConfigurations, compareAndGroupBlocks, deleteVal, extractAllBlocksFromTpl, extractAndOrganizeBlocks, genCleanCamelCaseId, genCleanIdForContentTypeAndValuePaths, genTagId, generateFilterKey, getFilterKeyForBlock, getPlatformContextContent, getRollupPossibilities, getRoutePathToEditContent, getRoutePathToModerateContent, getRoutePathToPublishedContent, getVal, mergeAnnoDataIntoAnnotationsTags, parseSpecialConfigSyntax, processAuthorAndCommonFilters, _recursExtractBlocks as recursivelyExtractBlocks, segrigateDocs, setVal, toArray };

package/dist/browser.d.ts

@@ -1184,4 +1184,27 @@ declare const UI_CONTENT: {
     };
 };
 
-export { BASE_BULLMQ_CONFIG, FILTER_IDS, TEMP_removeDuplicateFilters, UI_CONTENT, _self_managed_buildAnnoHierarchyConfig, _self_managed_getFixedAnnoRollupBlocks, _self_managed_getFixedAnnoTagBlock, autoGenFilterConfigsFromTpl, buildFilterConfigurations, compareAndGroupBlocks, deleteVal, extractAllBlocksFromTpl, extractAndOrganizeBlocks, genTagId, generateFilterKey, getFilterKeyForBlock, getPlatformContextContent, getRollupPossibilities, getRoutePathToEditContent, getRoutePathToModerateContent, getRoutePathToPublishedContent, getVal, mergeAnnoDataIntoAnnotationsTags, parseSpecialConfigSyntax, processAuthorAndCommonFilters, _recursExtractBlocks as recursivelyExtractBlocks, segrigateDocs, setVal, toArray };
+declare const genCleanCamelCaseId: (id: string) => string;
+
+/**
+ * Generates a clean, short, unique ID from text input.
+ * Used for both contentType IDs and block valuePaths.
+ *
+ * 1. Strips all characters except A-Z, a-z, 0-9
+ * 2. Lowercases the result
+ * 3. Prepends 'a' if starts with a digit
+ * 4. Truncates to maxLength (default 10)
+ * 5. Appends _{random id} (default 4 chars)
+ *
+ * @param text - The input text to convert
+ * @param maxLength - Max characters before the random suffix (default 10, use 20 for contentType)
+ * @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"
+ */
+declare const genCleanIdForContentTypeAndValuePaths: (text: string, maxLength?: number, shortIdLength?: number) => string;
+
+export { BASE_BULLMQ_CONFIG, FILTER_IDS, TEMP_removeDuplicateFilters, UI_CONTENT, _self_managed_buildAnnoHierarchyConfig, _self_managed_getFixedAnnoRollupBlocks, _self_managed_getFixedAnnoTagBlock, autoGenFilterConfigsFromTpl, buildFilterConfigurations, compareAndGroupBlocks, deleteVal, extractAllBlocksFromTpl, extractAndOrganizeBlocks, genCleanCamelCaseId, genCleanIdForContentTypeAndValuePaths, genTagId, generateFilterKey, getFilterKeyForBlock, getPlatformContextContent, getRollupPossibilities, getRoutePathToEditContent, getRoutePathToModerateContent, getRoutePathToPublishedContent, getVal, mergeAnnoDataIntoAnnotationsTags, parseSpecialConfigSyntax, processAuthorAndCommonFilters, _recursExtractBlocks as recursivelyExtractBlocks, segrigateDocs, setVal, toArray };

package/dist/browser.js

@@ -33,6 +33,8 @@ __export(browser_exports, {
   deleteVal: () => deleteVal,
   extractAllBlocksFromTpl: () => extractAllBlocksFromTpl,
   extractAndOrganizeBlocks: () => extractAndOrganizeBlocks,
+  genCleanCamelCaseId: () => genCleanCamelCaseId,
+  genCleanIdForContentTypeAndValuePaths: () => genCleanIdForContentTypeAndValuePaths,
   genTagId: () => genTagId,
   generateFilterKey: () => generateFilterKey,
   getFilterKeyForBlock: () => getFilterKeyForBlock,
@@ -1860,6 +1862,40 @@ var autoGenFilterConfigsFromTpl = ({
   ].filter(Boolean);
   return result;
 };
+
+// src/utils/genCleanCamelCaseId.ts
+var genCleanCamelCaseId = (id) => {
+  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 words = id.split(/[^\p{L}\p{N}]+/u).filter(Boolean);
+  if (words.length === 0) return "a";
+  const 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;
+};
+
+// src/utils/genCleanIdForContentTypeAndValuePaths.ts
+var CHARS = "abcdefghijklmnopqrstuvwxyz0123456789";
+function genShortId(length = 4) {
+  let result = "";
+  for (let i = 0; i < length; i++) {
+    result += CHARS[Math.floor(Math.random() * CHARS.length)];
+  }
+  return result;
+}
+var genCleanIdForContentTypeAndValuePaths = (text, maxLength = 10, shortIdLength = 4) => {
+  if (!text || typeof text !== "string") return text;
+  let cleaned = text.replace(/[^a-zA-Z0-9]/g, "").toLowerCase();
+  if (!cleaned) {
+    throw new Error(`[genCleanIdForContentTypeAndValuePaths] Input "${text}" contains no alphanumeric characters`);
+  }
+  if (/^\d/.test(cleaned)) cleaned = "a" + cleaned;
+  const truncated = cleaned.slice(0, maxLength);
+  return `${truncated}_${genShortId(shortIdLength)}`;
+};
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   BASE_BULLMQ_CONFIG,
@@ -1875,6 +1911,8 @@ var autoGenFilterConfigsFromTpl = ({
   deleteVal,
   extractAllBlocksFromTpl,
   extractAndOrganizeBlocks,
+  genCleanCamelCaseId,
+  genCleanIdForContentTypeAndValuePaths,
   genTagId,
   generateFilterKey,
   getFilterKeyForBlock,

package/dist/browser.mjs

@@ -1806,6 +1806,40 @@ var autoGenFilterConfigsFromTpl = ({
   ].filter(Boolean);
   return result;
 };
+
+// src/utils/genCleanCamelCaseId.ts
+var genCleanCamelCaseId = (id) => {
+  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 words = id.split(/[^\p{L}\p{N}]+/u).filter(Boolean);
+  if (words.length === 0) return "a";
+  const 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;
+};
+
+// src/utils/genCleanIdForContentTypeAndValuePaths.ts
+var CHARS = "abcdefghijklmnopqrstuvwxyz0123456789";
+function genShortId(length = 4) {
+  let result = "";
+  for (let i = 0; i < length; i++) {
+    result += CHARS[Math.floor(Math.random() * CHARS.length)];
+  }
+  return result;
+}
+var genCleanIdForContentTypeAndValuePaths = (text, maxLength = 10, shortIdLength = 4) => {
+  if (!text || typeof text !== "string") return text;
+  let cleaned = text.replace(/[^a-zA-Z0-9]/g, "").toLowerCase();
+  if (!cleaned) {
+    throw new Error(`[genCleanIdForContentTypeAndValuePaths] Input "${text}" contains no alphanumeric characters`);
+  }
+  if (/^\d/.test(cleaned)) cleaned = "a" + cleaned;
+  const truncated = cleaned.slice(0, maxLength);
+  return `${truncated}_${genShortId(shortIdLength)}`;
+};
 export {
   BASE_BULLMQ_CONFIG,
   FILTER_IDS,
@@ -1820,6 +1854,8 @@ export {
   deleteVal,
   extractAllBlocksFromTpl,
   extractAndOrganizeBlocks,
+  genCleanCamelCaseId,
+  genCleanIdForContentTypeAndValuePaths,
   genTagId,
   generateFilterKey,
   getFilterKeyForBlock,

package/dist/node.d.mts

@@ -1191,6 +1191,29 @@ declare const UI_CONTENT: {
     };
 };
 
+declare const genCleanCamelCaseId: (id: string) => string;
+
+/**
+ * Generates a clean, short, unique ID from text input.
+ * Used for both contentType IDs and block valuePaths.
+ *
+ * 1. Strips all characters except A-Z, a-z, 0-9
+ * 2. Lowercases the result
+ * 3. Prepends 'a' if starts with a digit
+ * 4. Truncates to maxLength (default 10)
+ * 5. Appends _{random id} (default 4 chars)
+ *
+ * @param text - The input text to convert
+ * @param maxLength - Max characters before the random suffix (default 10, use 20 for contentType)
+ * @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"
+ */
+declare const genCleanIdForContentTypeAndValuePaths: (text: string, maxLength?: number, shortIdLength?: number) => string;
+
 declare class MongoConnector {
     static getInstance(): any;
     static getClusterConnections(): any;
@@ -1921,4 +1944,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, 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_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 };

package/dist/node.d.ts

@@ -1191,6 +1191,29 @@ declare const UI_CONTENT: {
     };
 };
 
+declare const genCleanCamelCaseId: (id: string) => string;
+
+/**
+ * Generates a clean, short, unique ID from text input.
+ * Used for both contentType IDs and block valuePaths.
+ *
+ * 1. Strips all characters except A-Z, a-z, 0-9
+ * 2. Lowercases the result
+ * 3. Prepends 'a' if starts with a digit
+ * 4. Truncates to maxLength (default 10)
+ * 5. Appends _{random id} (default 4 chars)
+ *
+ * @param text - The input text to convert
+ * @param maxLength - Max characters before the random suffix (default 10, use 20 for contentType)
+ * @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"
+ */
+declare const genCleanIdForContentTypeAndValuePaths: (text: string, maxLength?: number, shortIdLength?: number) => string;
+
 declare class MongoConnector {
     static getInstance(): any;
     static getClusterConnections(): any;
@@ -1921,4 +1944,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, 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_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 };

package/dist/node.js

@@ -1947,6 +1947,8 @@ __export(node_exports, {
   deleteVal: () => deleteVal,
   extractAllBlocksFromTpl: () => extractAllBlocksFromTpl,
   extractAndOrganizeBlocks: () => extractAndOrganizeBlocks,
+  genCleanCamelCaseId: () => genCleanCamelCaseId,
+  genCleanIdForContentTypeAndValuePaths: () => genCleanIdForContentTypeAndValuePaths,
   genTagId: () => genTagId,
   generateFilterKey: () => generateFilterKey,
   getAIChatModelByTenant: () => import_getModelByTenant2.getAIChatModelByTenant,
@@ -3455,6 +3457,40 @@ var autoGenFilterConfigsFromTpl = ({
   return result;
 };
 
+// src/utils/genCleanCamelCaseId.ts
+var genCleanCamelCaseId = (id) => {
+  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 words = id.split(/[^\p{L}\p{N}]+/u).filter(Boolean);
+  if (words.length === 0) return "a";
+  const 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;
+};
+
+// src/utils/genCleanIdForContentTypeAndValuePaths.ts
+var CHARS = "abcdefghijklmnopqrstuvwxyz0123456789";
+function genShortId(length = 4) {
+  let result = "";
+  for (let i = 0; i < length; i++) {
+    result += CHARS[Math.floor(Math.random() * CHARS.length)];
+  }
+  return result;
+}
+var genCleanIdForContentTypeAndValuePaths = (text, maxLength = 10, shortIdLength = 4) => {
+  if (!text || typeof text !== "string") return text;
+  let cleaned = text.replace(/[^a-zA-Z0-9]/g, "").toLowerCase();
+  if (!cleaned) {
+    throw new Error(`[genCleanIdForContentTypeAndValuePaths] Input "${text}" contains no alphanumeric characters`);
+  }
+  if (/^\d/.test(cleaned)) cleaned = "a" + cleaned;
+  const truncated = cleaned.slice(0, maxLength);
+  return `${truncated}_${genShortId(shortIdLength)}`;
+};
+
 // src/node.ts
 var import_MongoConnector3 = __toESM(require_MongoConnector());
 var import_ElasticSearchConnector = __toESM(require_ElasticSearchConnector());
@@ -3870,6 +3906,8 @@ var import_GET_GLOBAL_BULLMQ_CONFIG = __toESM(require_GET_GLOBAL_BULLMQ_CONFIG()
   deleteVal,
   extractAllBlocksFromTpl,
   extractAndOrganizeBlocks,
+  genCleanCamelCaseId,
+  genCleanIdForContentTypeAndValuePaths,
   genTagId,
   generateFilterKey,
   getAIChatModelByTenant,

package/dist/node.mjs

@@ -3400,6 +3400,40 @@ var autoGenFilterConfigsFromTpl = ({
   return result;
 };
 
+// src/utils/genCleanCamelCaseId.ts
+var genCleanCamelCaseId = (id) => {
+  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 words = id.split(/[^\p{L}\p{N}]+/u).filter(Boolean);
+  if (words.length === 0) return "a";
+  const 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;
+};
+
+// src/utils/genCleanIdForContentTypeAndValuePaths.ts
+var CHARS = "abcdefghijklmnopqrstuvwxyz0123456789";
+function genShortId(length = 4) {
+  let result = "";
+  for (let i = 0; i < length; i++) {
+    result += CHARS[Math.floor(Math.random() * CHARS.length)];
+  }
+  return result;
+}
+var genCleanIdForContentTypeAndValuePaths = (text, maxLength = 10, shortIdLength = 4) => {
+  if (!text || typeof text !== "string") return text;
+  let cleaned = text.replace(/[^a-zA-Z0-9]/g, "").toLowerCase();
+  if (!cleaned) {
+    throw new Error(`[genCleanIdForContentTypeAndValuePaths] Input "${text}" contains no alphanumeric characters`);
+  }
+  if (/^\d/.test(cleaned)) cleaned = "a" + cleaned;
+  const truncated = cleaned.slice(0, maxLength);
+  return `${truncated}_${genShortId(shortIdLength)}`;
+};
+
 // src/node.ts
 var import_MongoConnector3 = __toESM(require_MongoConnector());
 var import_ElasticSearchConnector = __toESM(require_ElasticSearchConnector());
@@ -3830,6 +3864,8 @@ export {
   deleteVal,
   extractAllBlocksFromTpl,
   extractAndOrganizeBlocks,
+  genCleanCamelCaseId,
+  genCleanIdForContentTypeAndValuePaths,
   genTagId,
   generateFilterKey,
   export_getAIChatModelByTenant as getAIChatModelByTenant,

package/dist/universal.d.mts

@@ -1184,4 +1184,27 @@ declare const UI_CONTENT: {
     };
 };
 
-export { BASE_BULLMQ_CONFIG, FILTER_IDS, TEMP_removeDuplicateFilters, UI_CONTENT, _self_managed_buildAnnoHierarchyConfig, _self_managed_getFixedAnnoRollupBlocks, _self_managed_getFixedAnnoTagBlock, autoGenFilterConfigsFromTpl, buildFilterConfigurations, compareAndGroupBlocks, deleteVal, extractAllBlocksFromTpl, extractAndOrganizeBlocks, genTagId, generateFilterKey, getFilterKeyForBlock, getPlatformContextContent, getRollupPossibilities, getRoutePathToEditContent, getRoutePathToModerateContent, getRoutePathToPublishedContent, getVal, mergeAnnoDataIntoAnnotationsTags, parseSpecialConfigSyntax, processAuthorAndCommonFilters, _recursExtractBlocks as recursivelyExtractBlocks, segrigateDocs, setVal, toArray };
+declare const genCleanCamelCaseId: (id: string) => string;
+
+/**
+ * Generates a clean, short, unique ID from text input.
+ * Used for both contentType IDs and block valuePaths.
+ *
+ * 1. Strips all characters except A-Z, a-z, 0-9
+ * 2. Lowercases the result
+ * 3. Prepends 'a' if starts with a digit
+ * 4. Truncates to maxLength (default 10)
+ * 5. Appends _{random id} (default 4 chars)
+ *
+ * @param text - The input text to convert
+ * @param maxLength - Max characters before the random suffix (default 10, use 20 for contentType)
+ * @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"
+ */
+declare const genCleanIdForContentTypeAndValuePaths: (text: string, maxLength?: number, shortIdLength?: number) => string;
+
+export { BASE_BULLMQ_CONFIG, FILTER_IDS, TEMP_removeDuplicateFilters, UI_CONTENT, _self_managed_buildAnnoHierarchyConfig, _self_managed_getFixedAnnoRollupBlocks, _self_managed_getFixedAnnoTagBlock, autoGenFilterConfigsFromTpl, buildFilterConfigurations, compareAndGroupBlocks, deleteVal, extractAllBlocksFromTpl, extractAndOrganizeBlocks, genCleanCamelCaseId, genCleanIdForContentTypeAndValuePaths, genTagId, generateFilterKey, getFilterKeyForBlock, getPlatformContextContent, getRollupPossibilities, getRoutePathToEditContent, getRoutePathToModerateContent, getRoutePathToPublishedContent, getVal, mergeAnnoDataIntoAnnotationsTags, parseSpecialConfigSyntax, processAuthorAndCommonFilters, _recursExtractBlocks as recursivelyExtractBlocks, segrigateDocs, setVal, toArray };

package/dist/universal.d.ts

@@ -1184,4 +1184,27 @@ declare const UI_CONTENT: {
     };
 };
 
-export { BASE_BULLMQ_CONFIG, FILTER_IDS, TEMP_removeDuplicateFilters, UI_CONTENT, _self_managed_buildAnnoHierarchyConfig, _self_managed_getFixedAnnoRollupBlocks, _self_managed_getFixedAnnoTagBlock, autoGenFilterConfigsFromTpl, buildFilterConfigurations, compareAndGroupBlocks, deleteVal, extractAllBlocksFromTpl, extractAndOrganizeBlocks, genTagId, generateFilterKey, getFilterKeyForBlock, getPlatformContextContent, getRollupPossibilities, getRoutePathToEditContent, getRoutePathToModerateContent, getRoutePathToPublishedContent, getVal, mergeAnnoDataIntoAnnotationsTags, parseSpecialConfigSyntax, processAuthorAndCommonFilters, _recursExtractBlocks as recursivelyExtractBlocks, segrigateDocs, setVal, toArray };
+declare const genCleanCamelCaseId: (id: string) => string;
+
+/**
+ * Generates a clean, short, unique ID from text input.
+ * Used for both contentType IDs and block valuePaths.
+ *
+ * 1. Strips all characters except A-Z, a-z, 0-9
+ * 2. Lowercases the result
+ * 3. Prepends 'a' if starts with a digit
+ * 4. Truncates to maxLength (default 10)
+ * 5. Appends _{random id} (default 4 chars)
+ *
+ * @param text - The input text to convert
+ * @param maxLength - Max characters before the random suffix (default 10, use 20 for contentType)
+ * @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"
+ */
+declare const genCleanIdForContentTypeAndValuePaths: (text: string, maxLength?: number, shortIdLength?: number) => string;
+
+export { BASE_BULLMQ_CONFIG, FILTER_IDS, TEMP_removeDuplicateFilters, UI_CONTENT, _self_managed_buildAnnoHierarchyConfig, _self_managed_getFixedAnnoRollupBlocks, _self_managed_getFixedAnnoTagBlock, autoGenFilterConfigsFromTpl, buildFilterConfigurations, compareAndGroupBlocks, deleteVal, extractAllBlocksFromTpl, extractAndOrganizeBlocks, genCleanCamelCaseId, genCleanIdForContentTypeAndValuePaths, genTagId, generateFilterKey, getFilterKeyForBlock, getPlatformContextContent, getRollupPossibilities, getRoutePathToEditContent, getRoutePathToModerateContent, getRoutePathToPublishedContent, getVal, mergeAnnoDataIntoAnnotationsTags, parseSpecialConfigSyntax, processAuthorAndCommonFilters, _recursExtractBlocks as recursivelyExtractBlocks, segrigateDocs, setVal, toArray };

package/dist/universal.js

@@ -33,6 +33,8 @@ __export(universal_exports, {
   deleteVal: () => deleteVal,
   extractAllBlocksFromTpl: () => extractAllBlocksFromTpl,
   extractAndOrganizeBlocks: () => extractAndOrganizeBlocks,
+  genCleanCamelCaseId: () => genCleanCamelCaseId,
+  genCleanIdForContentTypeAndValuePaths: () => genCleanIdForContentTypeAndValuePaths,
   genTagId: () => genTagId,
   generateFilterKey: () => generateFilterKey,
   getFilterKeyForBlock: () => getFilterKeyForBlock,
@@ -1860,6 +1862,40 @@ var autoGenFilterConfigsFromTpl = ({
   ].filter(Boolean);
   return result;
 };
+
+// src/utils/genCleanCamelCaseId.ts
+var genCleanCamelCaseId = (id) => {
+  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 words = id.split(/[^\p{L}\p{N}]+/u).filter(Boolean);
+  if (words.length === 0) return "a";
+  const 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;
+};
+
+// src/utils/genCleanIdForContentTypeAndValuePaths.ts
+var CHARS = "abcdefghijklmnopqrstuvwxyz0123456789";
+function genShortId(length = 4) {
+  let result = "";
+  for (let i = 0; i < length; i++) {
+    result += CHARS[Math.floor(Math.random() * CHARS.length)];
+  }
+  return result;
+}
+var genCleanIdForContentTypeAndValuePaths = (text, maxLength = 10, shortIdLength = 4) => {
+  if (!text || typeof text !== "string") return text;
+  let cleaned = text.replace(/[^a-zA-Z0-9]/g, "").toLowerCase();
+  if (!cleaned) {
+    throw new Error(`[genCleanIdForContentTypeAndValuePaths] Input "${text}" contains no alphanumeric characters`);
+  }
+  if (/^\d/.test(cleaned)) cleaned = "a" + cleaned;
+  const truncated = cleaned.slice(0, maxLength);
+  return `${truncated}_${genShortId(shortIdLength)}`;
+};
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   BASE_BULLMQ_CONFIG,
@@ -1875,6 +1911,8 @@ var autoGenFilterConfigsFromTpl = ({
   deleteVal,
   extractAllBlocksFromTpl,
   extractAndOrganizeBlocks,
+  genCleanCamelCaseId,
+  genCleanIdForContentTypeAndValuePaths,
   genTagId,
   generateFilterKey,
   getFilterKeyForBlock,

package/dist/universal.mjs

@@ -1806,6 +1806,40 @@ var autoGenFilterConfigsFromTpl = ({
   ].filter(Boolean);
   return result;
 };
+
+// src/utils/genCleanCamelCaseId.ts
+var genCleanCamelCaseId = (id) => {
+  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 words = id.split(/[^\p{L}\p{N}]+/u).filter(Boolean);
+  if (words.length === 0) return "a";
+  const 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;
+};
+
+// src/utils/genCleanIdForContentTypeAndValuePaths.ts
+var CHARS = "abcdefghijklmnopqrstuvwxyz0123456789";
+function genShortId(length = 4) {
+  let result = "";
+  for (let i = 0; i < length; i++) {
+    result += CHARS[Math.floor(Math.random() * CHARS.length)];
+  }
+  return result;
+}
+var genCleanIdForContentTypeAndValuePaths = (text, maxLength = 10, shortIdLength = 4) => {
+  if (!text || typeof text !== "string") return text;
+  let cleaned = text.replace(/[^a-zA-Z0-9]/g, "").toLowerCase();
+  if (!cleaned) {
+    throw new Error(`[genCleanIdForContentTypeAndValuePaths] Input "${text}" contains no alphanumeric characters`);
+  }
+  if (/^\d/.test(cleaned)) cleaned = "a" + cleaned;
+  const truncated = cleaned.slice(0, maxLength);
+  return `${truncated}_${genShortId(shortIdLength)}`;
+};
 export {
   BASE_BULLMQ_CONFIG,
   FILTER_IDS,
@@ -1820,6 +1854,8 @@ export {
   deleteVal,
   extractAllBlocksFromTpl,
   extractAndOrganizeBlocks,
+  genCleanCamelCaseId,
+  genCleanIdForContentTypeAndValuePaths,
   genTagId,
   generateFilterKey,
   getFilterKeyForBlock,

package/package.json

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