@okf/ootils 1.8.3 → 1.8.5

package/dist/browser.d.mts

@@ -58,6 +58,27 @@ declare const genTagId: (tagName: TagNameInput) => string;
  */
 declare const toArray: <T>(property: T | T[] | null | undefined | false | 0) => T[];
 
+interface SegrigateDocsOptions {
+    skipUndefined?: boolean;
+    idPath?: string;
+    titlePath?: string;
+    aryKey?: string;
+}
+/**
+ * Groups an array of documents by a specified property path
+ *
+ * @param docs - Array of documents to group
+ * @param sortByPath - Dot-separated path to group by (e.g., "user.id")
+ * @param options - Optional configuration
+ * @returns Object with grouped documents
+ *
+ * @example
+ * // Basic usage
+ * segrigateDocs(users, "department")
+ * // Returns: { "Engineering": [...], "Marketing": [...] }
+ */
+declare const segrigateDocs: (docs: any[], sortByPath: string, options?: SegrigateDocsOptions) => Record<string, any>;
+
 interface Block {
     [key: string]: any;
     comp?: string;
@@ -629,4 +650,4 @@ interface GetPlatformContextContentParams {
 }
 declare const getPlatformContextContent: ({ platformConfigs_ai, }: GetPlatformContextContentParams) => string;
 
-export { BASE_BULLMQ_CONFIG, deleteVal, extractAllBlocksFromTpl, genTagId, getPlatformContextContent, getRollupPossibilities, getVal, _recursExtractBlocks as recursivelyExtractBlocks, setVal, toArray };
+export { BASE_BULLMQ_CONFIG, deleteVal, extractAllBlocksFromTpl, genTagId, getPlatformContextContent, getRollupPossibilities, getVal, _recursExtractBlocks as recursivelyExtractBlocks, segrigateDocs, setVal, toArray };

package/dist/browser.d.ts

@@ -58,6 +58,27 @@ declare const genTagId: (tagName: TagNameInput) => string;
  */
 declare const toArray: <T>(property: T | T[] | null | undefined | false | 0) => T[];
 
+interface SegrigateDocsOptions {
+    skipUndefined?: boolean;
+    idPath?: string;
+    titlePath?: string;
+    aryKey?: string;
+}
+/**
+ * Groups an array of documents by a specified property path
+ *
+ * @param docs - Array of documents to group
+ * @param sortByPath - Dot-separated path to group by (e.g., "user.id")
+ * @param options - Optional configuration
+ * @returns Object with grouped documents
+ *
+ * @example
+ * // Basic usage
+ * segrigateDocs(users, "department")
+ * // Returns: { "Engineering": [...], "Marketing": [...] }
+ */
+declare const segrigateDocs: (docs: any[], sortByPath: string, options?: SegrigateDocsOptions) => Record<string, any>;
+
 interface Block {
     [key: string]: any;
     comp?: string;
@@ -629,4 +650,4 @@ interface GetPlatformContextContentParams {
 }
 declare const getPlatformContextContent: ({ platformConfigs_ai, }: GetPlatformContextContentParams) => string;
 
-export { BASE_BULLMQ_CONFIG, deleteVal, extractAllBlocksFromTpl, genTagId, getPlatformContextContent, getRollupPossibilities, getVal, _recursExtractBlocks as recursivelyExtractBlocks, setVal, toArray };
+export { BASE_BULLMQ_CONFIG, deleteVal, extractAllBlocksFromTpl, genTagId, getPlatformContextContent, getRollupPossibilities, getVal, _recursExtractBlocks as recursivelyExtractBlocks, segrigateDocs, setVal, toArray };

package/dist/browser.js

@@ -28,6 +28,7 @@ __export(browser_exports, {
   getRollupPossibilities: () => getRollupPossibilities,
   getVal: () => getVal,
   recursivelyExtractBlocks: () => _recursExtractBlocks,
+  segrigateDocs: () => segrigateDocs,
   setVal: () => setVal,
   toArray: () => toArray
 });
@@ -196,6 +197,40 @@ var toArray = (property) => {
   return [property];
 };
 
+// src/utils/segrigateDocs.ts
+var segrigateDocs = (docs, sortByPath, options = {}) => {
+  let newSegrigatedObj = {};
+  docs.map((d, i) => {
+    let sortByValue = getVal(d, sortByPath);
+    if (sortByValue || !options.skipUndefined) {
+      if (Array.isArray(sortByValue)) {
+        sortByValue.map((v) => {
+          if (!newSegrigatedObj[v]) {
+            newSegrigatedObj[v] = [];
+          }
+          newSegrigatedObj[v].push(d);
+        });
+      } else {
+        if (!newSegrigatedObj[sortByValue]) {
+          newSegrigatedObj[sortByValue] = [];
+        }
+        newSegrigatedObj[sortByValue].push(d);
+      }
+    }
+  });
+  if (options.idPath || options.titlePath) {
+    Object.values(newSegrigatedObj).map((v, i) => {
+      let key = Object.keys(newSegrigatedObj)[i];
+      newSegrigatedObj[key] = {
+        id: options.idPath ? getVal(v[0], options.idPath) : void 0,
+        title: options.titlePath ? getVal(v[0], options.titlePath) : void 0,
+        [options.aryKey ? options.aryKey : "ary"]: v
+      };
+    });
+  }
+  return newSegrigatedObj;
+};
+
 // src/utils/extractAllBlocksFromTpl.ts
 var extractAllBlocksFromTpl = ({
   tpl,
@@ -717,6 +752,7 @@ ${v?.markdownText || ""}` : v?.markdownText || "";
   getRollupPossibilities,
   getVal,
   recursivelyExtractBlocks,
+  segrigateDocs,
   setVal,
   toArray
 });

package/dist/browser.mjs

@@ -161,6 +161,40 @@ var toArray = (property) => {
   return [property];
 };
 
+// src/utils/segrigateDocs.ts
+var segrigateDocs = (docs, sortByPath, options = {}) => {
+  let newSegrigatedObj = {};
+  docs.map((d, i) => {
+    let sortByValue = getVal(d, sortByPath);
+    if (sortByValue || !options.skipUndefined) {
+      if (Array.isArray(sortByValue)) {
+        sortByValue.map((v) => {
+          if (!newSegrigatedObj[v]) {
+            newSegrigatedObj[v] = [];
+          }
+          newSegrigatedObj[v].push(d);
+        });
+      } else {
+        if (!newSegrigatedObj[sortByValue]) {
+          newSegrigatedObj[sortByValue] = [];
+        }
+        newSegrigatedObj[sortByValue].push(d);
+      }
+    }
+  });
+  if (options.idPath || options.titlePath) {
+    Object.values(newSegrigatedObj).map((v, i) => {
+      let key = Object.keys(newSegrigatedObj)[i];
+      newSegrigatedObj[key] = {
+        id: options.idPath ? getVal(v[0], options.idPath) : void 0,
+        title: options.titlePath ? getVal(v[0], options.titlePath) : void 0,
+        [options.aryKey ? options.aryKey : "ary"]: v
+      };
+    });
+  }
+  return newSegrigatedObj;
+};
+
 // src/utils/extractAllBlocksFromTpl.ts
 var extractAllBlocksFromTpl = ({
   tpl,
@@ -681,6 +715,7 @@ export {
   getRollupPossibilities,
   getVal,
   _recursExtractBlocks as recursivelyExtractBlocks,
+  segrigateDocs,
   setVal,
   toArray
 };

package/dist/node.d.mts

@@ -65,6 +65,27 @@ declare const genTagId: (tagName: TagNameInput) => string;
  */
 declare const toArray: <T>(property: T | T[] | null | undefined | false | 0) => T[];
 
+interface SegrigateDocsOptions {
+    skipUndefined?: boolean;
+    idPath?: string;
+    titlePath?: string;
+    aryKey?: string;
+}
+/**
+ * Groups an array of documents by a specified property path
+ *
+ * @param docs - Array of documents to group
+ * @param sortByPath - Dot-separated path to group by (e.g., "user.id")
+ * @param options - Optional configuration
+ * @returns Object with grouped documents
+ *
+ * @example
+ * // Basic usage
+ * segrigateDocs(users, "department")
+ * // Returns: { "Engineering": [...], "Marketing": [...] }
+ */
+declare const segrigateDocs: (docs: any[], sortByPath: string, options?: SegrigateDocsOptions) => Record<string, any>;
+
 interface Block {
     [key: string]: any;
     comp?: string;
@@ -696,13 +717,15 @@ declare class RedisCacheConnector {
      * @param {string} params.tenant - The tenant identifier
      * @param {'platformConfigs'|'tpl'} params.modelName - The collection to search in
      * @param {string} [params.type] - When modelName='platformConfigs': one of platformConfigTypes array values; when modelName='tpl': content type string. If omitted, returns all documents for the collection.
+     * @param {string} [params.env] - Environment (defaults to current env)
      * @returns {Promise<Array>} Array of matching documents
      * @see {platformConfigTypes} for valid platformConfigs type values
      */
-    static findConfigsInCache({ tenant, modelName, type }: {
+    static findConfigsInCache({ tenant, modelName, type, env }: {
         tenant: string;
         modelName: "platformConfigs" | "tpl";
         type?: string | undefined;
+        env?: string | undefined;
     }): Promise<any[]>;
     /**
      * Find a single document in Redis cache (returns first match)
@@ -710,13 +733,15 @@ declare class RedisCacheConnector {
      * @param {string} params.tenant - The tenant identifier
      * @param {'platformConfigs'|'tpl'} params.modelName - The collection to search in
      * @param {string} [params.type] - When modelName='platformConfigs': one of platformConfigTypes array values; when modelName='tpl': content type string. If omitted, returns first document of any type.
+     * @param {string} [params.env] - Environment (defaults to current env)
      * @returns {Promise<Object|undefined>} First matching document or undefined if none found
      * @see {platformConfigTypes} for valid platformConfigs type values
      */
-    static findOneConfigInCache({ tenant, modelName, type }: {
+    static findOneConfigInCache({ tenant, modelName, type, env }: {
         tenant: string;
         modelName: "platformConfigs" | "tpl";
         type?: string | undefined;
+        env?: string | undefined;
     }): Promise<Object | undefined>;
     /**
      * Generate Redis key for config caching
@@ -1163,4 +1188,4 @@ declare function GET_GLOBAL_BULLMQ_CONFIG({ env, redisCredentials }: {
     };
 }): Object;
 
-export { AIChatSchema, AnnotationSchema, BASE_BULLMQ_CONFIG, BaseProducer, BaseWorker, ElasticSearchConnector, GET_GLOBAL_BULLMQ_CONFIG, MongoConnector, PlatformConfigsSchema, ProducerManager, RedisCacheConnector, TplSchema, WorkerManager, deleteVal, extractAllBlocksFromTpl, genTagId, getAIChatModelByTenant, getAnnotationsModelByTenant, getDbByTenant, getModelByTenant, getPlatformConfigsModelByTenant, getPlatformContextContent, getRollupPossibilities, getTplModelByTenant, getVal, _recursExtractBlocks as recursivelyExtractBlocks, setVal, toArray };
+export { AIChatSchema, AnnotationSchema, BASE_BULLMQ_CONFIG, BaseProducer, BaseWorker, ElasticSearchConnector, GET_GLOBAL_BULLMQ_CONFIG, MongoConnector, PlatformConfigsSchema, ProducerManager, RedisCacheConnector, TplSchema, WorkerManager, deleteVal, extractAllBlocksFromTpl, genTagId, getAIChatModelByTenant, getAnnotationsModelByTenant, getDbByTenant, getModelByTenant, getPlatformConfigsModelByTenant, getPlatformContextContent, getRollupPossibilities, getTplModelByTenant, getVal, _recursExtractBlocks as recursivelyExtractBlocks, segrigateDocs, setVal, toArray };

package/dist/node.d.ts

@@ -65,6 +65,27 @@ declare const genTagId: (tagName: TagNameInput) => string;
  */
 declare const toArray: <T>(property: T | T[] | null | undefined | false | 0) => T[];
 
+interface SegrigateDocsOptions {
+    skipUndefined?: boolean;
+    idPath?: string;
+    titlePath?: string;
+    aryKey?: string;
+}
+/**
+ * Groups an array of documents by a specified property path
+ *
+ * @param docs - Array of documents to group
+ * @param sortByPath - Dot-separated path to group by (e.g., "user.id")
+ * @param options - Optional configuration
+ * @returns Object with grouped documents
+ *
+ * @example
+ * // Basic usage
+ * segrigateDocs(users, "department")
+ * // Returns: { "Engineering": [...], "Marketing": [...] }
+ */
+declare const segrigateDocs: (docs: any[], sortByPath: string, options?: SegrigateDocsOptions) => Record<string, any>;
+
 interface Block {
     [key: string]: any;
     comp?: string;
@@ -696,13 +717,15 @@ declare class RedisCacheConnector {
      * @param {string} params.tenant - The tenant identifier
      * @param {'platformConfigs'|'tpl'} params.modelName - The collection to search in
      * @param {string} [params.type] - When modelName='platformConfigs': one of platformConfigTypes array values; when modelName='tpl': content type string. If omitted, returns all documents for the collection.
+     * @param {string} [params.env] - Environment (defaults to current env)
      * @returns {Promise<Array>} Array of matching documents
      * @see {platformConfigTypes} for valid platformConfigs type values
      */
-    static findConfigsInCache({ tenant, modelName, type }: {
+    static findConfigsInCache({ tenant, modelName, type, env }: {
         tenant: string;
         modelName: "platformConfigs" | "tpl";
         type?: string | undefined;
+        env?: string | undefined;
     }): Promise<any[]>;
     /**
      * Find a single document in Redis cache (returns first match)
@@ -710,13 +733,15 @@ declare class RedisCacheConnector {
      * @param {string} params.tenant - The tenant identifier
      * @param {'platformConfigs'|'tpl'} params.modelName - The collection to search in
      * @param {string} [params.type] - When modelName='platformConfigs': one of platformConfigTypes array values; when modelName='tpl': content type string. If omitted, returns first document of any type.
+     * @param {string} [params.env] - Environment (defaults to current env)
      * @returns {Promise<Object|undefined>} First matching document or undefined if none found
      * @see {platformConfigTypes} for valid platformConfigs type values
      */
-    static findOneConfigInCache({ tenant, modelName, type }: {
+    static findOneConfigInCache({ tenant, modelName, type, env }: {
         tenant: string;
         modelName: "platformConfigs" | "tpl";
         type?: string | undefined;
+        env?: string | undefined;
     }): Promise<Object | undefined>;
     /**
      * Generate Redis key for config caching
@@ -1163,4 +1188,4 @@ declare function GET_GLOBAL_BULLMQ_CONFIG({ env, redisCredentials }: {
     };
 }): Object;
 
-export { AIChatSchema, AnnotationSchema, BASE_BULLMQ_CONFIG, BaseProducer, BaseWorker, ElasticSearchConnector, GET_GLOBAL_BULLMQ_CONFIG, MongoConnector, PlatformConfigsSchema, ProducerManager, RedisCacheConnector, TplSchema, WorkerManager, deleteVal, extractAllBlocksFromTpl, genTagId, getAIChatModelByTenant, getAnnotationsModelByTenant, getDbByTenant, getModelByTenant, getPlatformConfigsModelByTenant, getPlatformContextContent, getRollupPossibilities, getTplModelByTenant, getVal, _recursExtractBlocks as recursivelyExtractBlocks, setVal, toArray };
+export { AIChatSchema, AnnotationSchema, BASE_BULLMQ_CONFIG, BaseProducer, BaseWorker, ElasticSearchConnector, GET_GLOBAL_BULLMQ_CONFIG, MongoConnector, PlatformConfigsSchema, ProducerManager, RedisCacheConnector, TplSchema, WorkerManager, deleteVal, extractAllBlocksFromTpl, genTagId, getAIChatModelByTenant, getAnnotationsModelByTenant, getDbByTenant, getModelByTenant, getPlatformConfigsModelByTenant, getPlatformContextContent, getRollupPossibilities, getTplModelByTenant, getVal, _recursExtractBlocks as recursivelyExtractBlocks, segrigateDocs, setVal, toArray };

package/dist/node.js

@@ -1455,6 +1455,7 @@ __export(node_exports, {
   getTplModelByTenant: () => import_getModelByTenant2.getTplModelByTenant,
   getVal: () => getVal,
   recursivelyExtractBlocks: () => _recursExtractBlocks,
+  segrigateDocs: () => segrigateDocs,
   setVal: () => setVal,
   toArray: () => toArray
 });
@@ -1623,6 +1624,40 @@ var toArray = (property) => {
   return [property];
 };
 
+// src/utils/segrigateDocs.ts
+var segrigateDocs = (docs, sortByPath, options = {}) => {
+  let newSegrigatedObj = {};
+  docs.map((d, i) => {
+    let sortByValue = getVal(d, sortByPath);
+    if (sortByValue || !options.skipUndefined) {
+      if (Array.isArray(sortByValue)) {
+        sortByValue.map((v) => {
+          if (!newSegrigatedObj[v]) {
+            newSegrigatedObj[v] = [];
+          }
+          newSegrigatedObj[v].push(d);
+        });
+      } else {
+        if (!newSegrigatedObj[sortByValue]) {
+          newSegrigatedObj[sortByValue] = [];
+        }
+        newSegrigatedObj[sortByValue].push(d);
+      }
+    }
+  });
+  if (options.idPath || options.titlePath) {
+    Object.values(newSegrigatedObj).map((v, i) => {
+      let key = Object.keys(newSegrigatedObj)[i];
+      newSegrigatedObj[key] = {
+        id: options.idPath ? getVal(v[0], options.idPath) : void 0,
+        title: options.titlePath ? getVal(v[0], options.titlePath) : void 0,
+        [options.aryKey ? options.aryKey : "ary"]: v
+      };
+    });
+  }
+  return newSegrigatedObj;
+};
+
 // src/utils/extractAllBlocksFromTpl.ts
 var extractAllBlocksFromTpl = ({
   tpl,
@@ -1952,13 +1987,14 @@ var RedisCacheConnector = class _RedisCacheConnector {
    * @param {string} params.tenant - The tenant identifier
    * @param {'platformConfigs'|'tpl'} params.modelName - The collection to search in
    * @param {string} [params.type] - When modelName='platformConfigs': one of platformConfigTypes array values; when modelName='tpl': content type string. If omitted, returns all documents for the collection.
+   * @param {string} [params.env] - Environment (defaults to current env)
    * @returns {Promise<Array>} Array of matching documents
    * @see {platformConfigTypes} for valid platformConfigs type values
    */
-  static async findConfigsInCache({ tenant, modelName, type }) {
+  static async findConfigsInCache({ tenant, modelName, type, env }) {
     try {
       const client = this.getClient();
-      const environment = this.getEnv();
+      const environment = env || this.getEnv();
       const keyPrefix = `${environment}:${tenant}:${modelName}:`;
       const keys = await client.keys(`${keyPrefix}${type || "*"}`);
       if (keys.length === 0) {
@@ -1982,7 +2018,8 @@ var RedisCacheConnector = class _RedisCacheConnector {
               tenant,
               modelName,
               type: doc[typeKey],
-              val: doc
+              val: doc,
+              env: environment
             })
           )
         );
@@ -2006,14 +2043,16 @@ var RedisCacheConnector = class _RedisCacheConnector {
    * @param {string} params.tenant - The tenant identifier
    * @param {'platformConfigs'|'tpl'} params.modelName - The collection to search in
    * @param {string} [params.type] - When modelName='platformConfigs': one of platformConfigTypes array values; when modelName='tpl': content type string. If omitted, returns first document of any type.
+   * @param {string} [params.env] - Environment (defaults to current env)
    * @returns {Promise<Object|undefined>} First matching document or undefined if none found
    * @see {platformConfigTypes} for valid platformConfigs type values
    */
-  static async findOneConfigInCache({ tenant, modelName, type }) {
+  static async findOneConfigInCache({ tenant, modelName, type, env }) {
     const cacheData = await this.findConfigsInCache({
       tenant,
       modelName,
-      type
+      type,
+      env
     });
     return cacheData?.[0];
   }
@@ -2081,14 +2120,19 @@ var RedisCacheConnector = class _RedisCacheConnector {
       type,
       env
     });
-    await client.del(cacheKey);
+    const delResult = await client.del(cacheKey);
+    let setResult;
     if (newVal) {
       try {
-        await client.set(cacheKey, JSON.stringify(newVal));
+        setResult = await client.set(cacheKey, JSON.stringify(newVal));
       } catch (err) {
         console.log("invalidateCache - Cache set failed: ", err);
       }
     }
+    return {
+      delResult,
+      setResult
+    };
   }
   /**
    * Load all collections and templates into Redis cache for all tenants
@@ -2193,6 +2237,7 @@ var import_GET_GLOBAL_BULLMQ_CONFIG = __toESM(require_GET_GLOBAL_BULLMQ_CONFIG()
   getTplModelByTenant,
   getVal,
   recursivelyExtractBlocks,
+  segrigateDocs,
   setVal,
   toArray
 });

package/dist/node.mjs

@@ -1594,6 +1594,40 @@ var toArray = (property) => {
   return [property];
 };
 
+// src/utils/segrigateDocs.ts
+var segrigateDocs = (docs, sortByPath, options = {}) => {
+  let newSegrigatedObj = {};
+  docs.map((d, i) => {
+    let sortByValue = getVal(d, sortByPath);
+    if (sortByValue || !options.skipUndefined) {
+      if (Array.isArray(sortByValue)) {
+        sortByValue.map((v) => {
+          if (!newSegrigatedObj[v]) {
+            newSegrigatedObj[v] = [];
+          }
+          newSegrigatedObj[v].push(d);
+        });
+      } else {
+        if (!newSegrigatedObj[sortByValue]) {
+          newSegrigatedObj[sortByValue] = [];
+        }
+        newSegrigatedObj[sortByValue].push(d);
+      }
+    }
+  });
+  if (options.idPath || options.titlePath) {
+    Object.values(newSegrigatedObj).map((v, i) => {
+      let key = Object.keys(newSegrigatedObj)[i];
+      newSegrigatedObj[key] = {
+        id: options.idPath ? getVal(v[0], options.idPath) : void 0,
+        title: options.titlePath ? getVal(v[0], options.titlePath) : void 0,
+        [options.aryKey ? options.aryKey : "ary"]: v
+      };
+    });
+  }
+  return newSegrigatedObj;
+};
+
 // src/utils/extractAllBlocksFromTpl.ts
 var extractAllBlocksFromTpl = ({
   tpl,
@@ -1923,13 +1957,14 @@ var RedisCacheConnector = class _RedisCacheConnector {
    * @param {string} params.tenant - The tenant identifier
    * @param {'platformConfigs'|'tpl'} params.modelName - The collection to search in
    * @param {string} [params.type] - When modelName='platformConfigs': one of platformConfigTypes array values; when modelName='tpl': content type string. If omitted, returns all documents for the collection.
+   * @param {string} [params.env] - Environment (defaults to current env)
    * @returns {Promise<Array>} Array of matching documents
    * @see {platformConfigTypes} for valid platformConfigs type values
    */
-  static async findConfigsInCache({ tenant, modelName, type }) {
+  static async findConfigsInCache({ tenant, modelName, type, env }) {
     try {
       const client = this.getClient();
-      const environment = this.getEnv();
+      const environment = env || this.getEnv();
       const keyPrefix = `${environment}:${tenant}:${modelName}:`;
       const keys = await client.keys(`${keyPrefix}${type || "*"}`);
       if (keys.length === 0) {
@@ -1953,7 +1988,8 @@ var RedisCacheConnector = class _RedisCacheConnector {
               tenant,
               modelName,
               type: doc[typeKey],
-              val: doc
+              val: doc,
+              env: environment
             })
           )
         );
@@ -1977,14 +2013,16 @@ var RedisCacheConnector = class _RedisCacheConnector {
    * @param {string} params.tenant - The tenant identifier
    * @param {'platformConfigs'|'tpl'} params.modelName - The collection to search in
    * @param {string} [params.type] - When modelName='platformConfigs': one of platformConfigTypes array values; when modelName='tpl': content type string. If omitted, returns first document of any type.
+   * @param {string} [params.env] - Environment (defaults to current env)
    * @returns {Promise<Object|undefined>} First matching document or undefined if none found
    * @see {platformConfigTypes} for valid platformConfigs type values
    */
-  static async findOneConfigInCache({ tenant, modelName, type }) {
+  static async findOneConfigInCache({ tenant, modelName, type, env }) {
     const cacheData = await this.findConfigsInCache({
       tenant,
       modelName,
-      type
+      type,
+      env
     });
     return cacheData?.[0];
   }
@@ -2052,14 +2090,19 @@ var RedisCacheConnector = class _RedisCacheConnector {
       type,
       env
     });
-    await client.del(cacheKey);
+    const delResult = await client.del(cacheKey);
+    let setResult;
     if (newVal) {
       try {
-        await client.set(cacheKey, JSON.stringify(newVal));
+        setResult = await client.set(cacheKey, JSON.stringify(newVal));
       } catch (err) {
         console.log("invalidateCache - Cache set failed: ", err);
       }
     }
+    return {
+      delResult,
+      setResult
+    };
   }
   /**
    * Load all collections and templates into Redis cache for all tenants
@@ -2175,6 +2218,7 @@ export {
   export_getTplModelByTenant as getTplModelByTenant,
   getVal,
   _recursExtractBlocks as recursivelyExtractBlocks,
+  segrigateDocs,
   setVal,
   toArray
 };

package/dist/universal.d.mts

@@ -58,6 +58,27 @@ declare const genTagId: (tagName: TagNameInput) => string;
  */
 declare const toArray: <T>(property: T | T[] | null | undefined | false | 0) => T[];
 
+interface SegrigateDocsOptions {
+    skipUndefined?: boolean;
+    idPath?: string;
+    titlePath?: string;
+    aryKey?: string;
+}
+/**
+ * Groups an array of documents by a specified property path
+ *
+ * @param docs - Array of documents to group
+ * @param sortByPath - Dot-separated path to group by (e.g., "user.id")
+ * @param options - Optional configuration
+ * @returns Object with grouped documents
+ *
+ * @example
+ * // Basic usage
+ * segrigateDocs(users, "department")
+ * // Returns: { "Engineering": [...], "Marketing": [...] }
+ */
+declare const segrigateDocs: (docs: any[], sortByPath: string, options?: SegrigateDocsOptions) => Record<string, any>;
+
 interface Block {
     [key: string]: any;
     comp?: string;
@@ -629,4 +650,4 @@ interface GetPlatformContextContentParams {
 }
 declare const getPlatformContextContent: ({ platformConfigs_ai, }: GetPlatformContextContentParams) => string;
 
-export { BASE_BULLMQ_CONFIG, deleteVal, extractAllBlocksFromTpl, genTagId, getPlatformContextContent, getRollupPossibilities, getVal, _recursExtractBlocks as recursivelyExtractBlocks, setVal, toArray };
+export { BASE_BULLMQ_CONFIG, deleteVal, extractAllBlocksFromTpl, genTagId, getPlatformContextContent, getRollupPossibilities, getVal, _recursExtractBlocks as recursivelyExtractBlocks, segrigateDocs, setVal, toArray };

package/dist/universal.d.ts

@@ -58,6 +58,27 @@ declare const genTagId: (tagName: TagNameInput) => string;
  */
 declare const toArray: <T>(property: T | T[] | null | undefined | false | 0) => T[];
 
+interface SegrigateDocsOptions {
+    skipUndefined?: boolean;
+    idPath?: string;
+    titlePath?: string;
+    aryKey?: string;
+}
+/**
+ * Groups an array of documents by a specified property path
+ *
+ * @param docs - Array of documents to group
+ * @param sortByPath - Dot-separated path to group by (e.g., "user.id")
+ * @param options - Optional configuration
+ * @returns Object with grouped documents
+ *
+ * @example
+ * // Basic usage
+ * segrigateDocs(users, "department")
+ * // Returns: { "Engineering": [...], "Marketing": [...] }
+ */
+declare const segrigateDocs: (docs: any[], sortByPath: string, options?: SegrigateDocsOptions) => Record<string, any>;
+
 interface Block {
     [key: string]: any;
     comp?: string;
@@ -629,4 +650,4 @@ interface GetPlatformContextContentParams {
 }
 declare const getPlatformContextContent: ({ platformConfigs_ai, }: GetPlatformContextContentParams) => string;
 
-export { BASE_BULLMQ_CONFIG, deleteVal, extractAllBlocksFromTpl, genTagId, getPlatformContextContent, getRollupPossibilities, getVal, _recursExtractBlocks as recursivelyExtractBlocks, setVal, toArray };
+export { BASE_BULLMQ_CONFIG, deleteVal, extractAllBlocksFromTpl, genTagId, getPlatformContextContent, getRollupPossibilities, getVal, _recursExtractBlocks as recursivelyExtractBlocks, segrigateDocs, setVal, toArray };

package/dist/universal.js

@@ -28,6 +28,7 @@ __export(universal_exports, {
   getRollupPossibilities: () => getRollupPossibilities,
   getVal: () => getVal,
   recursivelyExtractBlocks: () => _recursExtractBlocks,
+  segrigateDocs: () => segrigateDocs,
   setVal: () => setVal,
   toArray: () => toArray
 });
@@ -196,6 +197,40 @@ var toArray = (property) => {
   return [property];
 };
 
+// src/utils/segrigateDocs.ts
+var segrigateDocs = (docs, sortByPath, options = {}) => {
+  let newSegrigatedObj = {};
+  docs.map((d, i) => {
+    let sortByValue = getVal(d, sortByPath);
+    if (sortByValue || !options.skipUndefined) {
+      if (Array.isArray(sortByValue)) {
+        sortByValue.map((v) => {
+          if (!newSegrigatedObj[v]) {
+            newSegrigatedObj[v] = [];
+          }
+          newSegrigatedObj[v].push(d);
+        });
+      } else {
+        if (!newSegrigatedObj[sortByValue]) {
+          newSegrigatedObj[sortByValue] = [];
+        }
+        newSegrigatedObj[sortByValue].push(d);
+      }
+    }
+  });
+  if (options.idPath || options.titlePath) {
+    Object.values(newSegrigatedObj).map((v, i) => {
+      let key = Object.keys(newSegrigatedObj)[i];
+      newSegrigatedObj[key] = {
+        id: options.idPath ? getVal(v[0], options.idPath) : void 0,
+        title: options.titlePath ? getVal(v[0], options.titlePath) : void 0,
+        [options.aryKey ? options.aryKey : "ary"]: v
+      };
+    });
+  }
+  return newSegrigatedObj;
+};
+
 // src/utils/extractAllBlocksFromTpl.ts
 var extractAllBlocksFromTpl = ({
   tpl,
@@ -717,6 +752,7 @@ ${v?.markdownText || ""}` : v?.markdownText || "";
   getRollupPossibilities,
   getVal,
   recursivelyExtractBlocks,
+  segrigateDocs,
   setVal,
   toArray
 });

package/dist/universal.mjs

@@ -161,6 +161,40 @@ var toArray = (property) => {
   return [property];
 };
 
+// src/utils/segrigateDocs.ts
+var segrigateDocs = (docs, sortByPath, options = {}) => {
+  let newSegrigatedObj = {};
+  docs.map((d, i) => {
+    let sortByValue = getVal(d, sortByPath);
+    if (sortByValue || !options.skipUndefined) {
+      if (Array.isArray(sortByValue)) {
+        sortByValue.map((v) => {
+          if (!newSegrigatedObj[v]) {
+            newSegrigatedObj[v] = [];
+          }
+          newSegrigatedObj[v].push(d);
+        });
+      } else {
+        if (!newSegrigatedObj[sortByValue]) {
+          newSegrigatedObj[sortByValue] = [];
+        }
+        newSegrigatedObj[sortByValue].push(d);
+      }
+    }
+  });
+  if (options.idPath || options.titlePath) {
+    Object.values(newSegrigatedObj).map((v, i) => {
+      let key = Object.keys(newSegrigatedObj)[i];
+      newSegrigatedObj[key] = {
+        id: options.idPath ? getVal(v[0], options.idPath) : void 0,
+        title: options.titlePath ? getVal(v[0], options.titlePath) : void 0,
+        [options.aryKey ? options.aryKey : "ary"]: v
+      };
+    });
+  }
+  return newSegrigatedObj;
+};
+
 // src/utils/extractAllBlocksFromTpl.ts
 var extractAllBlocksFromTpl = ({
   tpl,
@@ -681,6 +715,7 @@ export {
   getRollupPossibilities,
   getVal,
   _recursExtractBlocks as recursivelyExtractBlocks,
+  segrigateDocs,
   setVal,
   toArray
 };

package/package.json

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