@okf/ootils 1.18.3 → 1.19.0

package/dist/browser.d.mts

@@ -723,4 +723,30 @@ interface GetPlatformContextContentParams {
 }
 declare const getPlatformContextContent: ({ platformConfigs_ai, }: GetPlatformContextContentParams) => string;
 
-export { BASE_BULLMQ_CONFIG, deleteVal, extractAllBlocksFromTpl, genTagId, getPlatformContextContent, getRollupPossibilities, getVal, _recursExtractBlocks as recursivelyExtractBlocks, segrigateDocs, setVal, toArray };
+interface Author {
+    id: string | null;
+    name: string;
+}
+interface MergeParams {
+    prevObj: any;
+    newLexValue: any;
+    thisBlockValuePath: string;
+    author?: Author;
+}
+/**
+ * Merges annoData from a Lexical field into the consolidated annotations.tags structure.
+ *
+ * This function:
+ * 1. Removes all fragments from prevObj that belong to the given valuePath
+ * 2. Injects new fragments from annoData into the consolidated structure
+ * 3. Removes tags that have no fragments left
+ *
+ * @param prevObj - The existing consolidated annotations.tags object
+ * @param newLexValue - The new Lexical field value containing annoData
+ * @param thisBlockValuePath - The valuePath of the Lexical field being processed
+ * @param author - Optional author object. Defaults to { id: null, name: "AI" } for backend usage
+ * @returns The updated consolidated annotations.tags object
+ */
+declare const mergeAnnoDataIntoAnnotationsTags: ({ prevObj, newLexValue, thisBlockValuePath, author, }: MergeParams) => any;
+
+export { BASE_BULLMQ_CONFIG, deleteVal, extractAllBlocksFromTpl, genTagId, getPlatformContextContent, getRollupPossibilities, getVal, mergeAnnoDataIntoAnnotationsTags, _recursExtractBlocks as recursivelyExtractBlocks, segrigateDocs, setVal, toArray };

package/dist/browser.d.ts

@@ -723,4 +723,30 @@ interface GetPlatformContextContentParams {
 }
 declare const getPlatformContextContent: ({ platformConfigs_ai, }: GetPlatformContextContentParams) => string;
 
-export { BASE_BULLMQ_CONFIG, deleteVal, extractAllBlocksFromTpl, genTagId, getPlatformContextContent, getRollupPossibilities, getVal, _recursExtractBlocks as recursivelyExtractBlocks, segrigateDocs, setVal, toArray };
+interface Author {
+    id: string | null;
+    name: string;
+}
+interface MergeParams {
+    prevObj: any;
+    newLexValue: any;
+    thisBlockValuePath: string;
+    author?: Author;
+}
+/**
+ * Merges annoData from a Lexical field into the consolidated annotations.tags structure.
+ *
+ * This function:
+ * 1. Removes all fragments from prevObj that belong to the given valuePath
+ * 2. Injects new fragments from annoData into the consolidated structure
+ * 3. Removes tags that have no fragments left
+ *
+ * @param prevObj - The existing consolidated annotations.tags object
+ * @param newLexValue - The new Lexical field value containing annoData
+ * @param thisBlockValuePath - The valuePath of the Lexical field being processed
+ * @param author - Optional author object. Defaults to { id: null, name: "AI" } for backend usage
+ * @returns The updated consolidated annotations.tags object
+ */
+declare const mergeAnnoDataIntoAnnotationsTags: ({ prevObj, newLexValue, thisBlockValuePath, author, }: MergeParams) => any;
+
+export { BASE_BULLMQ_CONFIG, deleteVal, extractAllBlocksFromTpl, genTagId, getPlatformContextContent, getRollupPossibilities, getVal, mergeAnnoDataIntoAnnotationsTags, _recursExtractBlocks as recursivelyExtractBlocks, segrigateDocs, setVal, toArray };

package/dist/browser.js

@@ -27,6 +27,7 @@ __export(browser_exports, {
   getPlatformContextContent: () => getPlatformContextContent,
   getRollupPossibilities: () => getRollupPossibilities,
   getVal: () => getVal,
+  mergeAnnoDataIntoAnnotationsTags: () => mergeAnnoDataIntoAnnotationsTags,
   recursivelyExtractBlocks: () => _recursExtractBlocks,
   segrigateDocs: () => segrigateDocs,
   setVal: () => setVal,
@@ -765,6 +766,90 @@ ${v?.markdownText || ""}` : v?.markdownText || "";
   }
   return "";
 };
+
+// src/utils/mergeAnnoDataIntoAnnotationsTags.ts
+var import_lodash = require("lodash");
+var mergeAnnoDataIntoAnnotationsTags = ({
+  prevObj,
+  newLexValue,
+  thisBlockValuePath,
+  author = { id: null, name: "AI" }
+}) => {
+  let newConsolidated = (0, import_lodash.cloneDeep)(prevObj) || {};
+  const { annoData = {} } = newLexValue || {};
+  const existingKeys = /* @__PURE__ */ new Map();
+  Object.keys(newConsolidated).map((tagType) => {
+    if (newConsolidated[tagType].data?.length > 0) {
+      newConsolidated[tagType].data.forEach((tag, tagIdx) => {
+        if (tag.fragments?.length > 0) {
+          newConsolidated[tagType].data[tagIdx].fragments = newConsolidated[tagType].data[tagIdx].fragments.filter((frag) => {
+            existingKeys.set(frag.annoDataId, frag?.author ?? "");
+            if (frag.extractedFromValuePath !== thisBlockValuePath) {
+              return true;
+            } else {
+              return false;
+            }
+          });
+        }
+      });
+    }
+  });
+  Object.keys(annoData).map((annoDataId) => {
+    const { tags, fragment = {}, ...restAnnoData } = annoData[annoDataId];
+    const tagTypes = Object.keys(tags || {});
+    const buildFragment = () => ({
+      ...fragment,
+      ...restAnnoData,
+      annoDataId,
+      // Fallback to provided author if author not set (for backwards compatibility)
+      author: restAnnoData.author || existingKeys.get(annoDataId) || author,
+      extractedFromValuePath: thisBlockValuePath
+    });
+    if (tagTypes.length > 0) {
+      tagTypes.forEach((tagType) => {
+        const value = tags[tagType];
+        if (newConsolidated[tagType]?.data?.length > 0) {
+          value.data.forEach((d) => {
+            const foundTagIdx = newConsolidated[tagType].data.findIndex(
+              (dd) => dd._id === d._id
+            );
+            if (foundTagIdx !== -1) {
+              const fragsAry = newConsolidated[tagType].data[foundTagIdx].fragments || [];
+              if (fragsAry.length === 0) {
+                newConsolidated[tagType].data[foundTagIdx].fragments = [
+                  buildFragment()
+                ];
+              } else {
+                newConsolidated[tagType].data[foundTagIdx].fragments.push(
+                  buildFragment()
+                );
+              }
+            } else {
+              newConsolidated[tagType].data.push({
+                ...d,
+                fragments: [buildFragment()]
+              });
+            }
+          });
+        } else {
+          newConsolidated[tagType] = {
+            collectionId: value.collectionId,
+            data: value.data.map((d) => ({
+              ...d,
+              fragments: [buildFragment()]
+            }))
+          };
+        }
+      });
+    }
+  });
+  Object.keys(newConsolidated).forEach((tagType) => {
+    newConsolidated[tagType].data = newConsolidated[tagType].data.filter(
+      (d) => d.fragments?.length > 0
+    );
+  });
+  return newConsolidated;
+};
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   BASE_BULLMQ_CONFIG,
@@ -774,6 +859,7 @@ ${v?.markdownText || ""}` : v?.markdownText || "";
   getPlatformContextContent,
   getRollupPossibilities,
   getVal,
+  mergeAnnoDataIntoAnnotationsTags,
   recursivelyExtractBlocks,
   segrigateDocs,
   setVal,

package/dist/browser.mjs

@@ -729,6 +729,90 @@ ${v?.markdownText || ""}` : v?.markdownText || "";
   }
   return "";
 };
+
+// src/utils/mergeAnnoDataIntoAnnotationsTags.ts
+import { cloneDeep } from "lodash";
+var mergeAnnoDataIntoAnnotationsTags = ({
+  prevObj,
+  newLexValue,
+  thisBlockValuePath,
+  author = { id: null, name: "AI" }
+}) => {
+  let newConsolidated = cloneDeep(prevObj) || {};
+  const { annoData = {} } = newLexValue || {};
+  const existingKeys = /* @__PURE__ */ new Map();
+  Object.keys(newConsolidated).map((tagType) => {
+    if (newConsolidated[tagType].data?.length > 0) {
+      newConsolidated[tagType].data.forEach((tag, tagIdx) => {
+        if (tag.fragments?.length > 0) {
+          newConsolidated[tagType].data[tagIdx].fragments = newConsolidated[tagType].data[tagIdx].fragments.filter((frag) => {
+            existingKeys.set(frag.annoDataId, frag?.author ?? "");
+            if (frag.extractedFromValuePath !== thisBlockValuePath) {
+              return true;
+            } else {
+              return false;
+            }
+          });
+        }
+      });
+    }
+  });
+  Object.keys(annoData).map((annoDataId) => {
+    const { tags, fragment = {}, ...restAnnoData } = annoData[annoDataId];
+    const tagTypes = Object.keys(tags || {});
+    const buildFragment = () => ({
+      ...fragment,
+      ...restAnnoData,
+      annoDataId,
+      // Fallback to provided author if author not set (for backwards compatibility)
+      author: restAnnoData.author || existingKeys.get(annoDataId) || author,
+      extractedFromValuePath: thisBlockValuePath
+    });
+    if (tagTypes.length > 0) {
+      tagTypes.forEach((tagType) => {
+        const value = tags[tagType];
+        if (newConsolidated[tagType]?.data?.length > 0) {
+          value.data.forEach((d) => {
+            const foundTagIdx = newConsolidated[tagType].data.findIndex(
+              (dd) => dd._id === d._id
+            );
+            if (foundTagIdx !== -1) {
+              const fragsAry = newConsolidated[tagType].data[foundTagIdx].fragments || [];
+              if (fragsAry.length === 0) {
+                newConsolidated[tagType].data[foundTagIdx].fragments = [
+                  buildFragment()
+                ];
+              } else {
+                newConsolidated[tagType].data[foundTagIdx].fragments.push(
+                  buildFragment()
+                );
+              }
+            } else {
+              newConsolidated[tagType].data.push({
+                ...d,
+                fragments: [buildFragment()]
+              });
+            }
+          });
+        } else {
+          newConsolidated[tagType] = {
+            collectionId: value.collectionId,
+            data: value.data.map((d) => ({
+              ...d,
+              fragments: [buildFragment()]
+            }))
+          };
+        }
+      });
+    }
+  });
+  Object.keys(newConsolidated).forEach((tagType) => {
+    newConsolidated[tagType].data = newConsolidated[tagType].data.filter(
+      (d) => d.fragments?.length > 0
+    );
+  });
+  return newConsolidated;
+};
 export {
   BASE_BULLMQ_CONFIG,
   deleteVal,
@@ -737,6 +821,7 @@ export {
   getPlatformContextContent,
   getRollupPossibilities,
   getVal,
+  mergeAnnoDataIntoAnnotationsTags,
   _recursExtractBlocks as recursivelyExtractBlocks,
   segrigateDocs,
   setVal,

package/dist/node.d.mts

@@ -731,6 +731,32 @@ interface GetPlatformContextContentParams {
 }
 declare const getPlatformContextContent: ({ platformConfigs_ai, }: GetPlatformContextContentParams) => string;
 
+interface Author {
+    id: string | null;
+    name: string;
+}
+interface MergeParams {
+    prevObj: any;
+    newLexValue: any;
+    thisBlockValuePath: string;
+    author?: Author;
+}
+/**
+ * Merges annoData from a Lexical field into the consolidated annotations.tags structure.
+ *
+ * This function:
+ * 1. Removes all fragments from prevObj that belong to the given valuePath
+ * 2. Injects new fragments from annoData into the consolidated structure
+ * 3. Removes tags that have no fragments left
+ *
+ * @param prevObj - The existing consolidated annotations.tags object
+ * @param newLexValue - The new Lexical field value containing annoData
+ * @param thisBlockValuePath - The valuePath of the Lexical field being processed
+ * @param author - Optional author object. Defaults to { id: null, name: "AI" } for backend usage
+ * @returns The updated consolidated annotations.tags object
+ */
+declare const mergeAnnoDataIntoAnnotationsTags: ({ prevObj, newLexValue, thisBlockValuePath, author, }: MergeParams) => any;
+
 declare class MongoConnector {
     static getInstance(): any;
     static getClusterConnections(): any;
@@ -1296,4 +1322,4 @@ declare function GET_GLOBAL_BULLMQ_CONFIG({ env, redisCredentials }: {
     };
 }): Object;
 
-export { AIChatSchema, AnnotationSchema, BASE_BULLMQ_CONFIG, BaseProducer, BaseWorker, ElasticSearchConnector, GET_GLOBAL_BULLMQ_CONFIG, GeneratedTopicsSchema, MongoConnector, PlatformConfigsSchema, ProducerManager, RedisCacheConnector, TplSchema, WorkerManager, deleteVal, extractAllBlocksFromTpl, genTagId, getAIChatModelByTenant, getAnnotationsModelByTenant, getDbByTenant, getGeneratedTopicsModelByTenant, getModelByTenant, getPlatformConfigsModelByTenant, getPlatformContextContent, getRollupPossibilities, getTplModelByTenant, getVal, _recursExtractBlocks as recursivelyExtractBlocks, segrigateDocs, setVal, toArray };
+export { AIChatSchema, AnnotationSchema, BASE_BULLMQ_CONFIG, BaseProducer, BaseWorker, ElasticSearchConnector, GET_GLOBAL_BULLMQ_CONFIG, GeneratedTopicsSchema, MongoConnector, PlatformConfigsSchema, ProducerManager, RedisCacheConnector, TplSchema, WorkerManager, deleteVal, extractAllBlocksFromTpl, genTagId, getAIChatModelByTenant, getAnnotationsModelByTenant, getDbByTenant, getGeneratedTopicsModelByTenant, getModelByTenant, getPlatformConfigsModelByTenant, getPlatformContextContent, getRollupPossibilities, getTplModelByTenant, getVal, mergeAnnoDataIntoAnnotationsTags, _recursExtractBlocks as recursivelyExtractBlocks, segrigateDocs, setVal, toArray };

package/dist/node.d.ts

@@ -731,6 +731,32 @@ interface GetPlatformContextContentParams {
 }
 declare const getPlatformContextContent: ({ platformConfigs_ai, }: GetPlatformContextContentParams) => string;
 
+interface Author {
+    id: string | null;
+    name: string;
+}
+interface MergeParams {
+    prevObj: any;
+    newLexValue: any;
+    thisBlockValuePath: string;
+    author?: Author;
+}
+/**
+ * Merges annoData from a Lexical field into the consolidated annotations.tags structure.
+ *
+ * This function:
+ * 1. Removes all fragments from prevObj that belong to the given valuePath
+ * 2. Injects new fragments from annoData into the consolidated structure
+ * 3. Removes tags that have no fragments left
+ *
+ * @param prevObj - The existing consolidated annotations.tags object
+ * @param newLexValue - The new Lexical field value containing annoData
+ * @param thisBlockValuePath - The valuePath of the Lexical field being processed
+ * @param author - Optional author object. Defaults to { id: null, name: "AI" } for backend usage
+ * @returns The updated consolidated annotations.tags object
+ */
+declare const mergeAnnoDataIntoAnnotationsTags: ({ prevObj, newLexValue, thisBlockValuePath, author, }: MergeParams) => any;
+
 declare class MongoConnector {
     static getInstance(): any;
     static getClusterConnections(): any;
@@ -1296,4 +1322,4 @@ declare function GET_GLOBAL_BULLMQ_CONFIG({ env, redisCredentials }: {
     };
 }): Object;
 
-export { AIChatSchema, AnnotationSchema, BASE_BULLMQ_CONFIG, BaseProducer, BaseWorker, ElasticSearchConnector, GET_GLOBAL_BULLMQ_CONFIG, GeneratedTopicsSchema, MongoConnector, PlatformConfigsSchema, ProducerManager, RedisCacheConnector, TplSchema, WorkerManager, deleteVal, extractAllBlocksFromTpl, genTagId, getAIChatModelByTenant, getAnnotationsModelByTenant, getDbByTenant, getGeneratedTopicsModelByTenant, getModelByTenant, getPlatformConfigsModelByTenant, getPlatformContextContent, getRollupPossibilities, getTplModelByTenant, getVal, _recursExtractBlocks as recursivelyExtractBlocks, segrigateDocs, setVal, toArray };
+export { AIChatSchema, AnnotationSchema, BASE_BULLMQ_CONFIG, BaseProducer, BaseWorker, ElasticSearchConnector, GET_GLOBAL_BULLMQ_CONFIG, GeneratedTopicsSchema, MongoConnector, PlatformConfigsSchema, ProducerManager, RedisCacheConnector, TplSchema, WorkerManager, deleteVal, extractAllBlocksFromTpl, genTagId, getAIChatModelByTenant, getAnnotationsModelByTenant, getDbByTenant, getGeneratedTopicsModelByTenant, getModelByTenant, getPlatformConfigsModelByTenant, getPlatformContextContent, getRollupPossibilities, getTplModelByTenant, getVal, mergeAnnoDataIntoAnnotationsTags, _recursExtractBlocks as recursivelyExtractBlocks, segrigateDocs, setVal, toArray };

package/dist/node.js

@@ -1582,6 +1582,7 @@ __export(node_exports, {
   getRollupPossibilities: () => getRollupPossibilities,
   getTplModelByTenant: () => import_getModelByTenant2.getTplModelByTenant,
   getVal: () => getVal,
+  mergeAnnoDataIntoAnnotationsTags: () => mergeAnnoDataIntoAnnotationsTags,
   recursivelyExtractBlocks: () => _recursExtractBlocks,
   segrigateDocs: () => segrigateDocs,
   setVal: () => setVal,
@@ -2021,6 +2022,90 @@ ${v?.markdownText || ""}` : v?.markdownText || "";
   return "";
 };
 
+// src/utils/mergeAnnoDataIntoAnnotationsTags.ts
+var import_lodash = require("lodash");
+var mergeAnnoDataIntoAnnotationsTags = ({
+  prevObj,
+  newLexValue,
+  thisBlockValuePath,
+  author = { id: null, name: "AI" }
+}) => {
+  let newConsolidated = (0, import_lodash.cloneDeep)(prevObj) || {};
+  const { annoData = {} } = newLexValue || {};
+  const existingKeys = /* @__PURE__ */ new Map();
+  Object.keys(newConsolidated).map((tagType) => {
+    if (newConsolidated[tagType].data?.length > 0) {
+      newConsolidated[tagType].data.forEach((tag, tagIdx) => {
+        if (tag.fragments?.length > 0) {
+          newConsolidated[tagType].data[tagIdx].fragments = newConsolidated[tagType].data[tagIdx].fragments.filter((frag) => {
+            existingKeys.set(frag.annoDataId, frag?.author ?? "");
+            if (frag.extractedFromValuePath !== thisBlockValuePath) {
+              return true;
+            } else {
+              return false;
+            }
+          });
+        }
+      });
+    }
+  });
+  Object.keys(annoData).map((annoDataId) => {
+    const { tags, fragment = {}, ...restAnnoData } = annoData[annoDataId];
+    const tagTypes = Object.keys(tags || {});
+    const buildFragment = () => ({
+      ...fragment,
+      ...restAnnoData,
+      annoDataId,
+      // Fallback to provided author if author not set (for backwards compatibility)
+      author: restAnnoData.author || existingKeys.get(annoDataId) || author,
+      extractedFromValuePath: thisBlockValuePath
+    });
+    if (tagTypes.length > 0) {
+      tagTypes.forEach((tagType) => {
+        const value = tags[tagType];
+        if (newConsolidated[tagType]?.data?.length > 0) {
+          value.data.forEach((d) => {
+            const foundTagIdx = newConsolidated[tagType].data.findIndex(
+              (dd) => dd._id === d._id
+            );
+            if (foundTagIdx !== -1) {
+              const fragsAry = newConsolidated[tagType].data[foundTagIdx].fragments || [];
+              if (fragsAry.length === 0) {
+                newConsolidated[tagType].data[foundTagIdx].fragments = [
+                  buildFragment()
+                ];
+              } else {
+                newConsolidated[tagType].data[foundTagIdx].fragments.push(
+                  buildFragment()
+                );
+              }
+            } else {
+              newConsolidated[tagType].data.push({
+                ...d,
+                fragments: [buildFragment()]
+              });
+            }
+          });
+        } else {
+          newConsolidated[tagType] = {
+            collectionId: value.collectionId,
+            data: value.data.map((d) => ({
+              ...d,
+              fragments: [buildFragment()]
+            }))
+          };
+        }
+      });
+    }
+  });
+  Object.keys(newConsolidated).forEach((tagType) => {
+    newConsolidated[tagType].data = newConsolidated[tagType].data.filter(
+      (d) => d.fragments?.length > 0
+    );
+  });
+  return newConsolidated;
+};
+
 // src/node.ts
 var import_MongoConnector2 = __toESM(require_MongoConnector());
 var import_ElasticSearchConnector = __toESM(require_ElasticSearchConnector());
@@ -2383,6 +2468,7 @@ var import_GET_GLOBAL_BULLMQ_CONFIG = __toESM(require_GET_GLOBAL_BULLMQ_CONFIG()
   getRollupPossibilities,
   getTplModelByTenant,
   getVal,
+  mergeAnnoDataIntoAnnotationsTags,
   recursivelyExtractBlocks,
   segrigateDocs,
   setVal,

package/dist/node.mjs

@@ -1989,6 +1989,90 @@ ${v?.markdownText || ""}` : v?.markdownText || "";
   return "";
 };
 
+// src/utils/mergeAnnoDataIntoAnnotationsTags.ts
+import { cloneDeep } from "lodash";
+var mergeAnnoDataIntoAnnotationsTags = ({
+  prevObj,
+  newLexValue,
+  thisBlockValuePath,
+  author = { id: null, name: "AI" }
+}) => {
+  let newConsolidated = cloneDeep(prevObj) || {};
+  const { annoData = {} } = newLexValue || {};
+  const existingKeys = /* @__PURE__ */ new Map();
+  Object.keys(newConsolidated).map((tagType) => {
+    if (newConsolidated[tagType].data?.length > 0) {
+      newConsolidated[tagType].data.forEach((tag, tagIdx) => {
+        if (tag.fragments?.length > 0) {
+          newConsolidated[tagType].data[tagIdx].fragments = newConsolidated[tagType].data[tagIdx].fragments.filter((frag) => {
+            existingKeys.set(frag.annoDataId, frag?.author ?? "");
+            if (frag.extractedFromValuePath !== thisBlockValuePath) {
+              return true;
+            } else {
+              return false;
+            }
+          });
+        }
+      });
+    }
+  });
+  Object.keys(annoData).map((annoDataId) => {
+    const { tags, fragment = {}, ...restAnnoData } = annoData[annoDataId];
+    const tagTypes = Object.keys(tags || {});
+    const buildFragment = () => ({
+      ...fragment,
+      ...restAnnoData,
+      annoDataId,
+      // Fallback to provided author if author not set (for backwards compatibility)
+      author: restAnnoData.author || existingKeys.get(annoDataId) || author,
+      extractedFromValuePath: thisBlockValuePath
+    });
+    if (tagTypes.length > 0) {
+      tagTypes.forEach((tagType) => {
+        const value = tags[tagType];
+        if (newConsolidated[tagType]?.data?.length > 0) {
+          value.data.forEach((d) => {
+            const foundTagIdx = newConsolidated[tagType].data.findIndex(
+              (dd) => dd._id === d._id
+            );
+            if (foundTagIdx !== -1) {
+              const fragsAry = newConsolidated[tagType].data[foundTagIdx].fragments || [];
+              if (fragsAry.length === 0) {
+                newConsolidated[tagType].data[foundTagIdx].fragments = [
+                  buildFragment()
+                ];
+              } else {
+                newConsolidated[tagType].data[foundTagIdx].fragments.push(
+                  buildFragment()
+                );
+              }
+            } else {
+              newConsolidated[tagType].data.push({
+                ...d,
+                fragments: [buildFragment()]
+              });
+            }
+          });
+        } else {
+          newConsolidated[tagType] = {
+            collectionId: value.collectionId,
+            data: value.data.map((d) => ({
+              ...d,
+              fragments: [buildFragment()]
+            }))
+          };
+        }
+      });
+    }
+  });
+  Object.keys(newConsolidated).forEach((tagType) => {
+    newConsolidated[tagType].data = newConsolidated[tagType].data.filter(
+      (d) => d.fragments?.length > 0
+    );
+  });
+  return newConsolidated;
+};
+
 // src/node.ts
 var import_MongoConnector2 = __toESM(require_MongoConnector());
 var import_ElasticSearchConnector = __toESM(require_ElasticSearchConnector());
@@ -2363,6 +2447,7 @@ export {
   getRollupPossibilities,
   export_getTplModelByTenant as getTplModelByTenant,
   getVal,
+  mergeAnnoDataIntoAnnotationsTags,
   _recursExtractBlocks as recursivelyExtractBlocks,
   segrigateDocs,
   setVal,

package/dist/universal.d.mts

@@ -723,4 +723,30 @@ interface GetPlatformContextContentParams {
 }
 declare const getPlatformContextContent: ({ platformConfigs_ai, }: GetPlatformContextContentParams) => string;
 
-export { BASE_BULLMQ_CONFIG, deleteVal, extractAllBlocksFromTpl, genTagId, getPlatformContextContent, getRollupPossibilities, getVal, _recursExtractBlocks as recursivelyExtractBlocks, segrigateDocs, setVal, toArray };
+interface Author {
+    id: string | null;
+    name: string;
+}
+interface MergeParams {
+    prevObj: any;
+    newLexValue: any;
+    thisBlockValuePath: string;
+    author?: Author;
+}
+/**
+ * Merges annoData from a Lexical field into the consolidated annotations.tags structure.
+ *
+ * This function:
+ * 1. Removes all fragments from prevObj that belong to the given valuePath
+ * 2. Injects new fragments from annoData into the consolidated structure
+ * 3. Removes tags that have no fragments left
+ *
+ * @param prevObj - The existing consolidated annotations.tags object
+ * @param newLexValue - The new Lexical field value containing annoData
+ * @param thisBlockValuePath - The valuePath of the Lexical field being processed
+ * @param author - Optional author object. Defaults to { id: null, name: "AI" } for backend usage
+ * @returns The updated consolidated annotations.tags object
+ */
+declare const mergeAnnoDataIntoAnnotationsTags: ({ prevObj, newLexValue, thisBlockValuePath, author, }: MergeParams) => any;
+
+export { BASE_BULLMQ_CONFIG, deleteVal, extractAllBlocksFromTpl, genTagId, getPlatformContextContent, getRollupPossibilities, getVal, mergeAnnoDataIntoAnnotationsTags, _recursExtractBlocks as recursivelyExtractBlocks, segrigateDocs, setVal, toArray };

package/dist/universal.d.ts

@@ -723,4 +723,30 @@ interface GetPlatformContextContentParams {
 }
 declare const getPlatformContextContent: ({ platformConfigs_ai, }: GetPlatformContextContentParams) => string;
 
-export { BASE_BULLMQ_CONFIG, deleteVal, extractAllBlocksFromTpl, genTagId, getPlatformContextContent, getRollupPossibilities, getVal, _recursExtractBlocks as recursivelyExtractBlocks, segrigateDocs, setVal, toArray };
+interface Author {
+    id: string | null;
+    name: string;
+}
+interface MergeParams {
+    prevObj: any;
+    newLexValue: any;
+    thisBlockValuePath: string;
+    author?: Author;
+}
+/**
+ * Merges annoData from a Lexical field into the consolidated annotations.tags structure.
+ *
+ * This function:
+ * 1. Removes all fragments from prevObj that belong to the given valuePath
+ * 2. Injects new fragments from annoData into the consolidated structure
+ * 3. Removes tags that have no fragments left
+ *
+ * @param prevObj - The existing consolidated annotations.tags object
+ * @param newLexValue - The new Lexical field value containing annoData
+ * @param thisBlockValuePath - The valuePath of the Lexical field being processed
+ * @param author - Optional author object. Defaults to { id: null, name: "AI" } for backend usage
+ * @returns The updated consolidated annotations.tags object
+ */
+declare const mergeAnnoDataIntoAnnotationsTags: ({ prevObj, newLexValue, thisBlockValuePath, author, }: MergeParams) => any;
+
+export { BASE_BULLMQ_CONFIG, deleteVal, extractAllBlocksFromTpl, genTagId, getPlatformContextContent, getRollupPossibilities, getVal, mergeAnnoDataIntoAnnotationsTags, _recursExtractBlocks as recursivelyExtractBlocks, segrigateDocs, setVal, toArray };

package/dist/universal.js

@@ -27,6 +27,7 @@ __export(universal_exports, {
   getPlatformContextContent: () => getPlatformContextContent,
   getRollupPossibilities: () => getRollupPossibilities,
   getVal: () => getVal,
+  mergeAnnoDataIntoAnnotationsTags: () => mergeAnnoDataIntoAnnotationsTags,
   recursivelyExtractBlocks: () => _recursExtractBlocks,
   segrigateDocs: () => segrigateDocs,
   setVal: () => setVal,
@@ -765,6 +766,90 @@ ${v?.markdownText || ""}` : v?.markdownText || "";
   }
   return "";
 };
+
+// src/utils/mergeAnnoDataIntoAnnotationsTags.ts
+var import_lodash = require("lodash");
+var mergeAnnoDataIntoAnnotationsTags = ({
+  prevObj,
+  newLexValue,
+  thisBlockValuePath,
+  author = { id: null, name: "AI" }
+}) => {
+  let newConsolidated = (0, import_lodash.cloneDeep)(prevObj) || {};
+  const { annoData = {} } = newLexValue || {};
+  const existingKeys = /* @__PURE__ */ new Map();
+  Object.keys(newConsolidated).map((tagType) => {
+    if (newConsolidated[tagType].data?.length > 0) {
+      newConsolidated[tagType].data.forEach((tag, tagIdx) => {
+        if (tag.fragments?.length > 0) {
+          newConsolidated[tagType].data[tagIdx].fragments = newConsolidated[tagType].data[tagIdx].fragments.filter((frag) => {
+            existingKeys.set(frag.annoDataId, frag?.author ?? "");
+            if (frag.extractedFromValuePath !== thisBlockValuePath) {
+              return true;
+            } else {
+              return false;
+            }
+          });
+        }
+      });
+    }
+  });
+  Object.keys(annoData).map((annoDataId) => {
+    const { tags, fragment = {}, ...restAnnoData } = annoData[annoDataId];
+    const tagTypes = Object.keys(tags || {});
+    const buildFragment = () => ({
+      ...fragment,
+      ...restAnnoData,
+      annoDataId,
+      // Fallback to provided author if author not set (for backwards compatibility)
+      author: restAnnoData.author || existingKeys.get(annoDataId) || author,
+      extractedFromValuePath: thisBlockValuePath
+    });
+    if (tagTypes.length > 0) {
+      tagTypes.forEach((tagType) => {
+        const value = tags[tagType];
+        if (newConsolidated[tagType]?.data?.length > 0) {
+          value.data.forEach((d) => {
+            const foundTagIdx = newConsolidated[tagType].data.findIndex(
+              (dd) => dd._id === d._id
+            );
+            if (foundTagIdx !== -1) {
+              const fragsAry = newConsolidated[tagType].data[foundTagIdx].fragments || [];
+              if (fragsAry.length === 0) {
+                newConsolidated[tagType].data[foundTagIdx].fragments = [
+                  buildFragment()
+                ];
+              } else {
+                newConsolidated[tagType].data[foundTagIdx].fragments.push(
+                  buildFragment()
+                );
+              }
+            } else {
+              newConsolidated[tagType].data.push({
+                ...d,
+                fragments: [buildFragment()]
+              });
+            }
+          });
+        } else {
+          newConsolidated[tagType] = {
+            collectionId: value.collectionId,
+            data: value.data.map((d) => ({
+              ...d,
+              fragments: [buildFragment()]
+            }))
+          };
+        }
+      });
+    }
+  });
+  Object.keys(newConsolidated).forEach((tagType) => {
+    newConsolidated[tagType].data = newConsolidated[tagType].data.filter(
+      (d) => d.fragments?.length > 0
+    );
+  });
+  return newConsolidated;
+};
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   BASE_BULLMQ_CONFIG,
@@ -774,6 +859,7 @@ ${v?.markdownText || ""}` : v?.markdownText || "";
   getPlatformContextContent,
   getRollupPossibilities,
   getVal,
+  mergeAnnoDataIntoAnnotationsTags,
   recursivelyExtractBlocks,
   segrigateDocs,
   setVal,

package/dist/universal.mjs

@@ -729,6 +729,90 @@ ${v?.markdownText || ""}` : v?.markdownText || "";
   }
   return "";
 };
+
+// src/utils/mergeAnnoDataIntoAnnotationsTags.ts
+import { cloneDeep } from "lodash";
+var mergeAnnoDataIntoAnnotationsTags = ({
+  prevObj,
+  newLexValue,
+  thisBlockValuePath,
+  author = { id: null, name: "AI" }
+}) => {
+  let newConsolidated = cloneDeep(prevObj) || {};
+  const { annoData = {} } = newLexValue || {};
+  const existingKeys = /* @__PURE__ */ new Map();
+  Object.keys(newConsolidated).map((tagType) => {
+    if (newConsolidated[tagType].data?.length > 0) {
+      newConsolidated[tagType].data.forEach((tag, tagIdx) => {
+        if (tag.fragments?.length > 0) {
+          newConsolidated[tagType].data[tagIdx].fragments = newConsolidated[tagType].data[tagIdx].fragments.filter((frag) => {
+            existingKeys.set(frag.annoDataId, frag?.author ?? "");
+            if (frag.extractedFromValuePath !== thisBlockValuePath) {
+              return true;
+            } else {
+              return false;
+            }
+          });
+        }
+      });
+    }
+  });
+  Object.keys(annoData).map((annoDataId) => {
+    const { tags, fragment = {}, ...restAnnoData } = annoData[annoDataId];
+    const tagTypes = Object.keys(tags || {});
+    const buildFragment = () => ({
+      ...fragment,
+      ...restAnnoData,
+      annoDataId,
+      // Fallback to provided author if author not set (for backwards compatibility)
+      author: restAnnoData.author || existingKeys.get(annoDataId) || author,
+      extractedFromValuePath: thisBlockValuePath
+    });
+    if (tagTypes.length > 0) {
+      tagTypes.forEach((tagType) => {
+        const value = tags[tagType];
+        if (newConsolidated[tagType]?.data?.length > 0) {
+          value.data.forEach((d) => {
+            const foundTagIdx = newConsolidated[tagType].data.findIndex(
+              (dd) => dd._id === d._id
+            );
+            if (foundTagIdx !== -1) {
+              const fragsAry = newConsolidated[tagType].data[foundTagIdx].fragments || [];
+              if (fragsAry.length === 0) {
+                newConsolidated[tagType].data[foundTagIdx].fragments = [
+                  buildFragment()
+                ];
+              } else {
+                newConsolidated[tagType].data[foundTagIdx].fragments.push(
+                  buildFragment()
+                );
+              }
+            } else {
+              newConsolidated[tagType].data.push({
+                ...d,
+                fragments: [buildFragment()]
+              });
+            }
+          });
+        } else {
+          newConsolidated[tagType] = {
+            collectionId: value.collectionId,
+            data: value.data.map((d) => ({
+              ...d,
+              fragments: [buildFragment()]
+            }))
+          };
+        }
+      });
+    }
+  });
+  Object.keys(newConsolidated).forEach((tagType) => {
+    newConsolidated[tagType].data = newConsolidated[tagType].data.filter(
+      (d) => d.fragments?.length > 0
+    );
+  });
+  return newConsolidated;
+};
 export {
   BASE_BULLMQ_CONFIG,
   deleteVal,
@@ -737,6 +821,7 @@ export {
   getPlatformContextContent,
   getRollupPossibilities,
   getVal,
+  mergeAnnoDataIntoAnnotationsTags,
   _recursExtractBlocks as recursivelyExtractBlocks,
   segrigateDocs,
   setVal,

package/package.json

@@ -3,7 +3,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "1.18.3",
+  "version": "1.19.0",
   "description": "Utility functions for both browser and Node.js",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -65,6 +65,7 @@
     "@semantic-release/npm": "^13.1.3",
     "@semantic-release/release-notes-generator": "^14.0.3",
     "@types/ioredis": "^4.28.10",
+    "@types/lodash": "^4.17.23",
     "@types/mongoose": "^5.11.97",
     "@types/node": "^22.13.10",
     "commitizen": "^4.3.1",
@@ -77,6 +78,7 @@
     "@elastic/elasticsearch": "^8.2.1",
     "bullmq": "^5.58.2",
     "ioredis": "^5.6.1",
+    "lodash": "^4.17.23",
     "mongodb": "^6.13.0",
     "mongoose": "^8.15.1"
   }