@okf/ootils 1.28.0 → 1.28.2

package/dist/browser.d.mts

@@ -1260,27 +1260,27 @@ 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.
+ * Generates a clean, deterministic, alphanumeric camelCase ID from text.
  *
- * 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)
+ * 1. Splits on non-alphanumeric characters, builds camelCase
+ * 2. Strips all non a-zA-Z0-9 from result
+ * 3. If input had no unicode letters/numbers at all (e.g. "---"), returns 'a'
+ * 4. If camelCase had content but nothing survived ASCII strip (pure non-Latin),
+ *    generates a deterministic hash (FNV-1a) of the unicode camelCase
+ * 5. Prepends 'a' if starts with digit
+ * 6. Truncates to 40 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)
+ * Idempotent: running twice produces the same output.
  *
  * @example
- * genCleanIdForContentTypeAndValuePaths("Author Name")        => "authorname_x7k2"
- * genCleanIdForContentTypeAndValuePaths("My Articles!", 20)   => "myarticles_m3p1"
- * genCleanIdForContentTypeAndValuePaths("123 Test")           => "a123test_ab4d"
+ * genCleanCamelCaseId("Author Name")   => "authorName"
+ * genCleanCamelCaseId("authorName")    => "authorName" (idempotent)
+ * genCleanCamelCaseId("123 Test")      => "a123Test"
+ * genCleanCamelCaseId("café latté")    => "cafLatt"
+ * genCleanCamelCaseId("مرحبا")         => deterministic hash
+ * genCleanCamelCaseId("---")           => "a"
  */
-declare const genCleanIdForContentTypeAndValuePaths: (text: string, maxLength?: number, shortIdLength?: number) => string;
+declare const genCleanCamelCaseId: (id: string) => string;
 
-export { BASE_BULLMQ_CONFIG, FILTER_IDS, TEMP_removeDuplicateFilters, UI_CONTENT, _self_managed_buildAnnoHierarchyConfig, _self_managed_buildDocHierarchyConfig, _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 };
+export { BASE_BULLMQ_CONFIG, FILTER_IDS, TEMP_removeDuplicateFilters, UI_CONTENT, _self_managed_buildAnnoHierarchyConfig, _self_managed_buildDocHierarchyConfig, _self_managed_getFixedAnnoRollupBlocks, _self_managed_getFixedAnnoTagBlock, autoGenFilterConfigsFromTpl, buildFilterConfigurations, compareAndGroupBlocks, deleteVal, extractAllBlocksFromTpl, extractAndOrganizeBlocks, genCleanCamelCaseId, genTagId, generateFilterKey, getFilterKeyForBlock, getPlatformContextContent, getRollupPossibilities, getRoutePathToEditContent, getRoutePathToModerateContent, getRoutePathToPublishedContent, getVal, mergeAnnoDataIntoAnnotationsTags, parseSpecialConfigSyntax, processAuthorAndCommonFilters, _recursExtractBlocks as recursivelyExtractBlocks, segrigateDocs, setVal, toArray };

package/dist/browser.d.ts

@@ -1260,27 +1260,27 @@ 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.
+ * Generates a clean, deterministic, alphanumeric camelCase ID from text.
  *
- * 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)
+ * 1. Splits on non-alphanumeric characters, builds camelCase
+ * 2. Strips all non a-zA-Z0-9 from result
+ * 3. If input had no unicode letters/numbers at all (e.g. "---"), returns 'a'
+ * 4. If camelCase had content but nothing survived ASCII strip (pure non-Latin),
+ *    generates a deterministic hash (FNV-1a) of the unicode camelCase
+ * 5. Prepends 'a' if starts with digit
+ * 6. Truncates to 40 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)
+ * Idempotent: running twice produces the same output.
  *
  * @example
- * genCleanIdForContentTypeAndValuePaths("Author Name")        => "authorname_x7k2"
- * genCleanIdForContentTypeAndValuePaths("My Articles!", 20)   => "myarticles_m3p1"
- * genCleanIdForContentTypeAndValuePaths("123 Test")           => "a123test_ab4d"
+ * genCleanCamelCaseId("Author Name")   => "authorName"
+ * genCleanCamelCaseId("authorName")    => "authorName" (idempotent)
+ * genCleanCamelCaseId("123 Test")      => "a123Test"
+ * genCleanCamelCaseId("café latté")    => "cafLatt"
+ * genCleanCamelCaseId("مرحبا")         => deterministic hash
+ * genCleanCamelCaseId("---")           => "a"
  */
-declare const genCleanIdForContentTypeAndValuePaths: (text: string, maxLength?: number, shortIdLength?: number) => string;
+declare const genCleanCamelCaseId: (id: string) => string;
 
-export { BASE_BULLMQ_CONFIG, FILTER_IDS, TEMP_removeDuplicateFilters, UI_CONTENT, _self_managed_buildAnnoHierarchyConfig, _self_managed_buildDocHierarchyConfig, _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 };
+export { BASE_BULLMQ_CONFIG, FILTER_IDS, TEMP_removeDuplicateFilters, UI_CONTENT, _self_managed_buildAnnoHierarchyConfig, _self_managed_buildDocHierarchyConfig, _self_managed_getFixedAnnoRollupBlocks, _self_managed_getFixedAnnoTagBlock, autoGenFilterConfigsFromTpl, buildFilterConfigurations, compareAndGroupBlocks, deleteVal, extractAllBlocksFromTpl, extractAndOrganizeBlocks, genCleanCamelCaseId, genTagId, generateFilterKey, getFilterKeyForBlock, getPlatformContextContent, getRollupPossibilities, getRoutePathToEditContent, getRoutePathToModerateContent, getRoutePathToPublishedContent, getVal, mergeAnnoDataIntoAnnotationsTags, parseSpecialConfigSyntax, processAuthorAndCommonFilters, _recursExtractBlocks as recursivelyExtractBlocks, segrigateDocs, setVal, toArray };

package/dist/browser.js

@@ -35,7 +35,6 @@ __export(browser_exports, {
   extractAllBlocksFromTpl: () => extractAllBlocksFromTpl,
   extractAndOrganizeBlocks: () => extractAndOrganizeBlocks,
   genCleanCamelCaseId: () => genCleanCamelCaseId,
-  genCleanIdForContentTypeAndValuePaths: () => genCleanIdForContentTypeAndValuePaths,
   genTagId: () => genTagId,
   generateFilterKey: () => generateFilterKey,
   getFilterKeyForBlock: () => getFilterKeyForBlock,
@@ -2127,37 +2126,28 @@ var autoGenFilterConfigsFromTpl = ({
 };
 
 // src/utils/genCleanCamelCaseId.ts
+var MAX_LENGTH = 40;
+function fnv1a(str, length = 8) {
+  let hash = 2166136261;
+  for (let i = 0; i < str.length; i++) {
+    hash ^= str.charCodeAt(i);
+    hash = hash * 16777619 >>> 0;
+  }
+  return hash.toString(36).slice(0, length);
+}
 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;
+  if ((/^[a-z][a-zA-Z0-9]*$/.test(id) || /^a\d[a-zA-Z0-9]*$/.test(id)) && id.length <= MAX_LENGTH) 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;
-};
-
-// 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)}`;
+  const strippedResult = result.replace(/[^a-zA-Z0-9]/g, "");
+  result = strippedResult || fnv1a(result);
+  if (/^\d/.test(result)) result = "a" + result;
+  return result.slice(0, MAX_LENGTH);
 };
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
@@ -2176,7 +2166,6 @@ var genCleanIdForContentTypeAndValuePaths = (text, maxLength = 10, shortIdLength
   extractAllBlocksFromTpl,
   extractAndOrganizeBlocks,
   genCleanCamelCaseId,
-  genCleanIdForContentTypeAndValuePaths,
   genTagId,
   generateFilterKey,
   getFilterKeyForBlock,

package/dist/browser.mjs

@@ -2070,37 +2070,28 @@ var autoGenFilterConfigsFromTpl = ({
 };
 
 // src/utils/genCleanCamelCaseId.ts
+var MAX_LENGTH = 40;
+function fnv1a(str, length = 8) {
+  let hash = 2166136261;
+  for (let i = 0; i < str.length; i++) {
+    hash ^= str.charCodeAt(i);
+    hash = hash * 16777619 >>> 0;
+  }
+  return hash.toString(36).slice(0, length);
+}
 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;
+  if ((/^[a-z][a-zA-Z0-9]*$/.test(id) || /^a\d[a-zA-Z0-9]*$/.test(id)) && id.length <= MAX_LENGTH) 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;
-};
-
-// 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)}`;
+  const strippedResult = result.replace(/[^a-zA-Z0-9]/g, "");
+  result = strippedResult || fnv1a(result);
+  if (/^\d/.test(result)) result = "a" + result;
+  return result.slice(0, MAX_LENGTH);
 };
 export {
   BASE_BULLMQ_CONFIG,
@@ -2118,7 +2109,6 @@ export {
   extractAllBlocksFromTpl,
   extractAndOrganizeBlocks,
   genCleanCamelCaseId,
-  genCleanIdForContentTypeAndValuePaths,
   genTagId,
   generateFilterKey,
   getFilterKeyForBlock,

package/dist/node.d.mts

@@ -1267,28 +1267,28 @@ 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.
+ * Generates a clean, deterministic, alphanumeric camelCase ID from text.
  *
- * 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)
+ * 1. Splits on non-alphanumeric characters, builds camelCase
+ * 2. Strips all non a-zA-Z0-9 from result
+ * 3. If input had no unicode letters/numbers at all (e.g. "---"), returns 'a'
+ * 4. If camelCase had content but nothing survived ASCII strip (pure non-Latin),
+ *    generates a deterministic hash (FNV-1a) of the unicode camelCase
+ * 5. Prepends 'a' if starts with digit
+ * 6. Truncates to 40 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)
+ * Idempotent: running twice produces the same output.
  *
  * @example
- * genCleanIdForContentTypeAndValuePaths("Author Name")        => "authorname_x7k2"
- * genCleanIdForContentTypeAndValuePaths("My Articles!", 20)   => "myarticles_m3p1"
- * genCleanIdForContentTypeAndValuePaths("123 Test")           => "a123test_ab4d"
+ * genCleanCamelCaseId("Author Name")   => "authorName"
+ * genCleanCamelCaseId("authorName")    => "authorName" (idempotent)
+ * genCleanCamelCaseId("123 Test")      => "a123Test"
+ * genCleanCamelCaseId("café latté")    => "cafLatt"
+ * genCleanCamelCaseId("مرحبا")         => deterministic hash
+ * genCleanCamelCaseId("---")           => "a"
  */
-declare const genCleanIdForContentTypeAndValuePaths: (text: string, maxLength?: number, shortIdLength?: number) => string;
+declare const genCleanCamelCaseId: (id: string) => string;
 
 declare class MongoConnector {
     static getInstance(): any;
@@ -2020,4 +2020,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_buildDocHierarchyConfig, _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, 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

@@ -1267,28 +1267,28 @@ 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.
+ * Generates a clean, deterministic, alphanumeric camelCase ID from text.
  *
- * 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)
+ * 1. Splits on non-alphanumeric characters, builds camelCase
+ * 2. Strips all non a-zA-Z0-9 from result
+ * 3. If input had no unicode letters/numbers at all (e.g. "---"), returns 'a'
+ * 4. If camelCase had content but nothing survived ASCII strip (pure non-Latin),
+ *    generates a deterministic hash (FNV-1a) of the unicode camelCase
+ * 5. Prepends 'a' if starts with digit
+ * 6. Truncates to 40 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)
+ * Idempotent: running twice produces the same output.
  *
  * @example
- * genCleanIdForContentTypeAndValuePaths("Author Name")        => "authorname_x7k2"
- * genCleanIdForContentTypeAndValuePaths("My Articles!", 20)   => "myarticles_m3p1"
- * genCleanIdForContentTypeAndValuePaths("123 Test")           => "a123test_ab4d"
+ * genCleanCamelCaseId("Author Name")   => "authorName"
+ * genCleanCamelCaseId("authorName")    => "authorName" (idempotent)
+ * genCleanCamelCaseId("123 Test")      => "a123Test"
+ * genCleanCamelCaseId("café latté")    => "cafLatt"
+ * genCleanCamelCaseId("مرحبا")         => deterministic hash
+ * genCleanCamelCaseId("---")           => "a"
  */
-declare const genCleanIdForContentTypeAndValuePaths: (text: string, maxLength?: number, shortIdLength?: number) => string;
+declare const genCleanCamelCaseId: (id: string) => string;
 
 declare class MongoConnector {
     static getInstance(): any;
@@ -2020,4 +2020,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_buildDocHierarchyConfig, _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, 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

@@ -1949,7 +1949,6 @@ __export(node_exports, {
   extractAllBlocksFromTpl: () => extractAllBlocksFromTpl,
   extractAndOrganizeBlocks: () => extractAndOrganizeBlocks,
   genCleanCamelCaseId: () => genCleanCamelCaseId,
-  genCleanIdForContentTypeAndValuePaths: () => genCleanIdForContentTypeAndValuePaths,
   genTagId: () => genTagId,
   generateFilterKey: () => generateFilterKey,
   getAIChatModelByTenant: () => import_getModelByTenant2.getAIChatModelByTenant,
@@ -3721,37 +3720,28 @@ var autoGenFilterConfigsFromTpl = ({
 };
 
 // src/utils/genCleanCamelCaseId.ts
+var MAX_LENGTH = 40;
+function fnv1a(str, length = 8) {
+  let hash = 2166136261;
+  for (let i = 0; i < str.length; i++) {
+    hash ^= str.charCodeAt(i);
+    hash = hash * 16777619 >>> 0;
+  }
+  return hash.toString(36).slice(0, length);
+}
 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;
+  if ((/^[a-z][a-zA-Z0-9]*$/.test(id) || /^a\d[a-zA-Z0-9]*$/.test(id)) && id.length <= MAX_LENGTH) 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;
-};
-
-// 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)}`;
+  const strippedResult = result.replace(/[^a-zA-Z0-9]/g, "");
+  result = strippedResult || fnv1a(result);
+  if (/^\d/.test(result)) result = "a" + result;
+  return result.slice(0, MAX_LENGTH);
 };
 
 // src/node.ts
@@ -4171,7 +4161,6 @@ var import_GET_GLOBAL_BULLMQ_CONFIG = __toESM(require_GET_GLOBAL_BULLMQ_CONFIG()
   extractAllBlocksFromTpl,
   extractAndOrganizeBlocks,
   genCleanCamelCaseId,
-  genCleanIdForContentTypeAndValuePaths,
   genTagId,
   generateFilterKey,
   getAIChatModelByTenant,

package/dist/node.mjs

@@ -3663,37 +3663,28 @@ var autoGenFilterConfigsFromTpl = ({
 };
 
 // src/utils/genCleanCamelCaseId.ts
+var MAX_LENGTH = 40;
+function fnv1a(str, length = 8) {
+  let hash = 2166136261;
+  for (let i = 0; i < str.length; i++) {
+    hash ^= str.charCodeAt(i);
+    hash = hash * 16777619 >>> 0;
+  }
+  return hash.toString(36).slice(0, length);
+}
 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;
+  if ((/^[a-z][a-zA-Z0-9]*$/.test(id) || /^a\d[a-zA-Z0-9]*$/.test(id)) && id.length <= MAX_LENGTH) 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;
-};
-
-// 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)}`;
+  const strippedResult = result.replace(/[^a-zA-Z0-9]/g, "");
+  result = strippedResult || fnv1a(result);
+  if (/^\d/.test(result)) result = "a" + result;
+  return result.slice(0, MAX_LENGTH);
 };
 
 // src/node.ts
@@ -4128,7 +4119,6 @@ export {
   extractAllBlocksFromTpl,
   extractAndOrganizeBlocks,
   genCleanCamelCaseId,
-  genCleanIdForContentTypeAndValuePaths,
   genTagId,
   generateFilterKey,
   export_getAIChatModelByTenant as getAIChatModelByTenant,

package/dist/universal.d.mts

@@ -1260,27 +1260,27 @@ 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.
+ * Generates a clean, deterministic, alphanumeric camelCase ID from text.
  *
- * 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)
+ * 1. Splits on non-alphanumeric characters, builds camelCase
+ * 2. Strips all non a-zA-Z0-9 from result
+ * 3. If input had no unicode letters/numbers at all (e.g. "---"), returns 'a'
+ * 4. If camelCase had content but nothing survived ASCII strip (pure non-Latin),
+ *    generates a deterministic hash (FNV-1a) of the unicode camelCase
+ * 5. Prepends 'a' if starts with digit
+ * 6. Truncates to 40 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)
+ * Idempotent: running twice produces the same output.
  *
  * @example
- * genCleanIdForContentTypeAndValuePaths("Author Name")        => "authorname_x7k2"
- * genCleanIdForContentTypeAndValuePaths("My Articles!", 20)   => "myarticles_m3p1"
- * genCleanIdForContentTypeAndValuePaths("123 Test")           => "a123test_ab4d"
+ * genCleanCamelCaseId("Author Name")   => "authorName"
+ * genCleanCamelCaseId("authorName")    => "authorName" (idempotent)
+ * genCleanCamelCaseId("123 Test")      => "a123Test"
+ * genCleanCamelCaseId("café latté")    => "cafLatt"
+ * genCleanCamelCaseId("مرحبا")         => deterministic hash
+ * genCleanCamelCaseId("---")           => "a"
  */
-declare const genCleanIdForContentTypeAndValuePaths: (text: string, maxLength?: number, shortIdLength?: number) => string;
+declare const genCleanCamelCaseId: (id: string) => string;
 
-export { BASE_BULLMQ_CONFIG, FILTER_IDS, TEMP_removeDuplicateFilters, UI_CONTENT, _self_managed_buildAnnoHierarchyConfig, _self_managed_buildDocHierarchyConfig, _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 };
+export { BASE_BULLMQ_CONFIG, FILTER_IDS, TEMP_removeDuplicateFilters, UI_CONTENT, _self_managed_buildAnnoHierarchyConfig, _self_managed_buildDocHierarchyConfig, _self_managed_getFixedAnnoRollupBlocks, _self_managed_getFixedAnnoTagBlock, autoGenFilterConfigsFromTpl, buildFilterConfigurations, compareAndGroupBlocks, deleteVal, extractAllBlocksFromTpl, extractAndOrganizeBlocks, genCleanCamelCaseId, genTagId, generateFilterKey, getFilterKeyForBlock, getPlatformContextContent, getRollupPossibilities, getRoutePathToEditContent, getRoutePathToModerateContent, getRoutePathToPublishedContent, getVal, mergeAnnoDataIntoAnnotationsTags, parseSpecialConfigSyntax, processAuthorAndCommonFilters, _recursExtractBlocks as recursivelyExtractBlocks, segrigateDocs, setVal, toArray };

package/dist/universal.d.ts

@@ -1260,27 +1260,27 @@ 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.
+ * Generates a clean, deterministic, alphanumeric camelCase ID from text.
  *
- * 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)
+ * 1. Splits on non-alphanumeric characters, builds camelCase
+ * 2. Strips all non a-zA-Z0-9 from result
+ * 3. If input had no unicode letters/numbers at all (e.g. "---"), returns 'a'
+ * 4. If camelCase had content but nothing survived ASCII strip (pure non-Latin),
+ *    generates a deterministic hash (FNV-1a) of the unicode camelCase
+ * 5. Prepends 'a' if starts with digit
+ * 6. Truncates to 40 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)
+ * Idempotent: running twice produces the same output.
  *
  * @example
- * genCleanIdForContentTypeAndValuePaths("Author Name")        => "authorname_x7k2"
- * genCleanIdForContentTypeAndValuePaths("My Articles!", 20)   => "myarticles_m3p1"
- * genCleanIdForContentTypeAndValuePaths("123 Test")           => "a123test_ab4d"
+ * genCleanCamelCaseId("Author Name")   => "authorName"
+ * genCleanCamelCaseId("authorName")    => "authorName" (idempotent)
+ * genCleanCamelCaseId("123 Test")      => "a123Test"
+ * genCleanCamelCaseId("café latté")    => "cafLatt"
+ * genCleanCamelCaseId("مرحبا")         => deterministic hash
+ * genCleanCamelCaseId("---")           => "a"
  */
-declare const genCleanIdForContentTypeAndValuePaths: (text: string, maxLength?: number, shortIdLength?: number) => string;
+declare const genCleanCamelCaseId: (id: string) => string;
 
-export { BASE_BULLMQ_CONFIG, FILTER_IDS, TEMP_removeDuplicateFilters, UI_CONTENT, _self_managed_buildAnnoHierarchyConfig, _self_managed_buildDocHierarchyConfig, _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 };
+export { BASE_BULLMQ_CONFIG, FILTER_IDS, TEMP_removeDuplicateFilters, UI_CONTENT, _self_managed_buildAnnoHierarchyConfig, _self_managed_buildDocHierarchyConfig, _self_managed_getFixedAnnoRollupBlocks, _self_managed_getFixedAnnoTagBlock, autoGenFilterConfigsFromTpl, buildFilterConfigurations, compareAndGroupBlocks, deleteVal, extractAllBlocksFromTpl, extractAndOrganizeBlocks, genCleanCamelCaseId, genTagId, generateFilterKey, getFilterKeyForBlock, getPlatformContextContent, getRollupPossibilities, getRoutePathToEditContent, getRoutePathToModerateContent, getRoutePathToPublishedContent, getVal, mergeAnnoDataIntoAnnotationsTags, parseSpecialConfigSyntax, processAuthorAndCommonFilters, _recursExtractBlocks as recursivelyExtractBlocks, segrigateDocs, setVal, toArray };

package/dist/universal.js

@@ -35,7 +35,6 @@ __export(universal_exports, {
   extractAllBlocksFromTpl: () => extractAllBlocksFromTpl,
   extractAndOrganizeBlocks: () => extractAndOrganizeBlocks,
   genCleanCamelCaseId: () => genCleanCamelCaseId,
-  genCleanIdForContentTypeAndValuePaths: () => genCleanIdForContentTypeAndValuePaths,
   genTagId: () => genTagId,
   generateFilterKey: () => generateFilterKey,
   getFilterKeyForBlock: () => getFilterKeyForBlock,
@@ -2127,37 +2126,28 @@ var autoGenFilterConfigsFromTpl = ({
 };
 
 // src/utils/genCleanCamelCaseId.ts
+var MAX_LENGTH = 40;
+function fnv1a(str, length = 8) {
+  let hash = 2166136261;
+  for (let i = 0; i < str.length; i++) {
+    hash ^= str.charCodeAt(i);
+    hash = hash * 16777619 >>> 0;
+  }
+  return hash.toString(36).slice(0, length);
+}
 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;
+  if ((/^[a-z][a-zA-Z0-9]*$/.test(id) || /^a\d[a-zA-Z0-9]*$/.test(id)) && id.length <= MAX_LENGTH) 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;
-};
-
-// 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)}`;
+  const strippedResult = result.replace(/[^a-zA-Z0-9]/g, "");
+  result = strippedResult || fnv1a(result);
+  if (/^\d/.test(result)) result = "a" + result;
+  return result.slice(0, MAX_LENGTH);
 };
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
@@ -2176,7 +2166,6 @@ var genCleanIdForContentTypeAndValuePaths = (text, maxLength = 10, shortIdLength
   extractAllBlocksFromTpl,
   extractAndOrganizeBlocks,
   genCleanCamelCaseId,
-  genCleanIdForContentTypeAndValuePaths,
   genTagId,
   generateFilterKey,
   getFilterKeyForBlock,

package/dist/universal.mjs

@@ -2070,37 +2070,28 @@ var autoGenFilterConfigsFromTpl = ({
 };
 
 // src/utils/genCleanCamelCaseId.ts
+var MAX_LENGTH = 40;
+function fnv1a(str, length = 8) {
+  let hash = 2166136261;
+  for (let i = 0; i < str.length; i++) {
+    hash ^= str.charCodeAt(i);
+    hash = hash * 16777619 >>> 0;
+  }
+  return hash.toString(36).slice(0, length);
+}
 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;
+  if ((/^[a-z][a-zA-Z0-9]*$/.test(id) || /^a\d[a-zA-Z0-9]*$/.test(id)) && id.length <= MAX_LENGTH) 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;
-};
-
-// 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)}`;
+  const strippedResult = result.replace(/[^a-zA-Z0-9]/g, "");
+  result = strippedResult || fnv1a(result);
+  if (/^\d/.test(result)) result = "a" + result;
+  return result.slice(0, MAX_LENGTH);
 };
 export {
   BASE_BULLMQ_CONFIG,
@@ -2118,7 +2109,6 @@ export {
   extractAllBlocksFromTpl,
   extractAndOrganizeBlocks,
   genCleanCamelCaseId,
-  genCleanIdForContentTypeAndValuePaths,
   genTagId,
   generateFilterKey,
   getFilterKeyForBlock,

package/package.json

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