@okf/ootils 1.3.4 → 1.3.5

package/dist/node.js

@@ -319,6 +319,7 @@ var node_exports = {};
 __export(node_exports, {
   connectToRedis: () => connectToRedis,
   deleteVal: () => deleteVal,
+  extractAllBlocksFromTpl: () => extractAllBlocksFromTpl,
   genTagId: () => genTagId,
   getAIConfigs: () => getAIConfigs,
   getAnnotationsModelByTenant: () => getAnnotationsModelByTenant,
@@ -332,6 +333,7 @@ __export(node_exports, {
   initializeGlobalConfig: () => initializeGlobalConfig,
   multiConnectToMongoDB: () => multiConnectToMongoDB,
   setVal: () => setVal,
+  toArray: () => toArray,
   updateGlobalConfig: () => updateGlobalConfig
 });
 module.exports = __toCommonJS(node_exports);
@@ -492,6 +494,125 @@ var genTagId = (tagName) => {
   return toReturn.replace(/^_+|_+$/, "");
 };
 
+// src/utils/toArray.ts
+var toArray = (property) => {
+  if (!property && (property !== false && property !== 0)) return [];
+  if (Array.isArray(property)) return property;
+  return [property];
+};
+
+// src/utils/extractAllBlocksFromTpl.ts
+var extractAllBlocksFromTpl = ({
+  tpl,
+  buildersWhitelist
+}) => {
+  if (tpl.category === "userProfiles") {
+    const allBlocksAry = [];
+    if (tpl.kp_templates?.myProfileConfig) {
+      _recursExtractBlocks({
+        data: tpl.kp_templates.myProfileConfig,
+        cb: (block) => allBlocksAry.push(block),
+        sectionStack: [],
+        blockPathPrefix: "kp_templates.myProfileConfig"
+      });
+    }
+    return allBlocksAry;
+  } else {
+    return extractAllBlocksFromStructuredTpls({ tpl, buildersWhitelist });
+  }
+};
+var _recursExtractBlocks = ({
+  data,
+  cb,
+  sectionStack = [],
+  blockPathPrefix = ""
+}) => {
+  data.forEach((d, idx) => {
+    if (!d.blocks) {
+      cb({
+        ...d,
+        sectionStack,
+        blockPath: `${blockPathPrefix}.${idx}`
+      });
+    } else {
+      _recursExtractBlocks({
+        data: d.blocks,
+        cb,
+        sectionStack: [...sectionStack, d],
+        blockPathPrefix: `${blockPathPrefix}.${idx}.blocks`
+      });
+    }
+  });
+};
+var extractAllBlocksFromStructuredTpls = ({
+  tpl,
+  buildersWhitelist
+}) => {
+  const allBlocksAry = [];
+  if (tpl.kp_templates) {
+    for (let spaceId in tpl.kp_templates) {
+      let conf = tpl.kp_templates[spaceId];
+      if (conf.builder && buildersWhitelist && !buildersWhitelist.includes(conf.builder)) {
+        continue;
+      }
+      if (!conf.subSpaces) {
+        _extractBlocksFromSomeBuilders({
+          conf,
+          confPath: `kp_templates.${spaceId}`,
+          allBlocksAry
+        });
+      } else {
+        conf.subSpaces.forEach((sub, subIdx) => {
+          if (sub.builder && buildersWhitelist && !buildersWhitelist.includes(sub.builder)) {
+            return;
+          }
+          _extractBlocksFromSomeBuilders({
+            conf: sub,
+            confPath: `kp_templates.${spaceId}.subSpaces.${subIdx}`,
+            allBlocksAry
+          });
+        });
+      }
+    }
+  }
+  if (buildersWhitelist && !buildersWhitelist.includes("kp_settings")) {
+    return allBlocksAry;
+  }
+  if (tpl.kp_settings && tpl.kp_settings.length > 0) {
+    _recursExtractBlocks({
+      data: tpl.kp_settings,
+      cb: (block) => allBlocksAry.push(block),
+      blockPathPrefix: "kp_settings"
+    });
+  }
+  return allBlocksAry;
+};
+var _extractBlocksFromSomeBuilders = ({
+  conf,
+  confPath,
+  allBlocksAry
+}) => {
+  if (conf.builder === "FormBuilder") {
+    const configs = conf.configs || [];
+    _recursExtractBlocks({
+      data: configs,
+      cb: (block) => allBlocksAry.push(block),
+      blockPathPrefix: `${confPath}.configs`
+    });
+  }
+  if (conf.builder === "MetaBuilder") {
+    const inputs = conf.configs?.inputs || {};
+    const inputBlockConfigsToPush = Object.keys(inputs).map((inputBlockKey) => {
+      const value = inputs[inputBlockKey];
+      return {
+        ...value,
+        blockPath: `${confPath}.configs.inputs.${inputBlockKey}`
+      };
+    });
+    allBlocksAry.push(...inputBlockConfigsToPush);
+  }
+};
+
 // src/db/mongodb.ts
 var import_mongoose = __toESM(require("mongoose"));
 
@@ -738,6 +859,7 @@ var getAIConfigs = async ({
 0 && (module.exports = {
   connectToRedis,
   deleteVal,
+  extractAllBlocksFromTpl,
   genTagId,
   getAIConfigs,
   getAnnotationsModelByTenant,
@@ -751,5 +873,6 @@ var getAIConfigs = async ({
   initializeGlobalConfig,
   multiConnectToMongoDB,
   setVal,
+  toArray,
   updateGlobalConfig
 });

package/dist/node.mjs

@@ -449,6 +449,125 @@ var genTagId = (tagName) => {
   return toReturn.replace(/^_+|_+$/, "");
 };
 
+// src/utils/toArray.ts
+var toArray = (property) => {
+  if (!property && (property !== false && property !== 0)) return [];
+  if (Array.isArray(property)) return property;
+  return [property];
+};
+
+// src/utils/extractAllBlocksFromTpl.ts
+var extractAllBlocksFromTpl = ({
+  tpl,
+  buildersWhitelist
+}) => {
+  if (tpl.category === "userProfiles") {
+    const allBlocksAry = [];
+    if (tpl.kp_templates?.myProfileConfig) {
+      _recursExtractBlocks({
+        data: tpl.kp_templates.myProfileConfig,
+        cb: (block) => allBlocksAry.push(block),
+        sectionStack: [],
+        blockPathPrefix: "kp_templates.myProfileConfig"
+      });
+    }
+    return allBlocksAry;
+  } else {
+    return extractAllBlocksFromStructuredTpls({ tpl, buildersWhitelist });
+  }
+};
+var _recursExtractBlocks = ({
+  data,
+  cb,
+  sectionStack = [],
+  blockPathPrefix = ""
+}) => {
+  data.forEach((d, idx) => {
+    if (!d.blocks) {
+      cb({
+        ...d,
+        sectionStack,
+        blockPath: `${blockPathPrefix}.${idx}`
+      });
+    } else {
+      _recursExtractBlocks({
+        data: d.blocks,
+        cb,
+        sectionStack: [...sectionStack, d],
+        blockPathPrefix: `${blockPathPrefix}.${idx}.blocks`
+      });
+    }
+  });
+};
+var extractAllBlocksFromStructuredTpls = ({
+  tpl,
+  buildersWhitelist
+}) => {
+  const allBlocksAry = [];
+  if (tpl.kp_templates) {
+    for (let spaceId in tpl.kp_templates) {
+      let conf = tpl.kp_templates[spaceId];
+      if (conf.builder && buildersWhitelist && !buildersWhitelist.includes(conf.builder)) {
+        continue;
+      }
+      if (!conf.subSpaces) {
+        _extractBlocksFromSomeBuilders({
+          conf,
+          confPath: `kp_templates.${spaceId}`,
+          allBlocksAry
+        });
+      } else {
+        conf.subSpaces.forEach((sub, subIdx) => {
+          if (sub.builder && buildersWhitelist && !buildersWhitelist.includes(sub.builder)) {
+            return;
+          }
+          _extractBlocksFromSomeBuilders({
+            conf: sub,
+            confPath: `kp_templates.${spaceId}.subSpaces.${subIdx}`,
+            allBlocksAry
+          });
+        });
+      }
+    }
+  }
+  if (buildersWhitelist && !buildersWhitelist.includes("kp_settings")) {
+    return allBlocksAry;
+  }
+  if (tpl.kp_settings && tpl.kp_settings.length > 0) {
+    _recursExtractBlocks({
+      data: tpl.kp_settings,
+      cb: (block) => allBlocksAry.push(block),
+      blockPathPrefix: "kp_settings"
+    });
+  }
+  return allBlocksAry;
+};
+var _extractBlocksFromSomeBuilders = ({
+  conf,
+  confPath,
+  allBlocksAry
+}) => {
+  if (conf.builder === "FormBuilder") {
+    const configs = conf.configs || [];
+    _recursExtractBlocks({
+      data: configs,
+      cb: (block) => allBlocksAry.push(block),
+      blockPathPrefix: `${confPath}.configs`
+    });
+  }
+  if (conf.builder === "MetaBuilder") {
+    const inputs = conf.configs?.inputs || {};
+    const inputBlockConfigsToPush = Object.keys(inputs).map((inputBlockKey) => {
+      const value = inputs[inputBlockKey];
+      return {
+        ...value,
+        blockPath: `${confPath}.configs.inputs.${inputBlockKey}`
+      };
+    });
+    allBlocksAry.push(...inputBlockConfigsToPush);
+  }
+};
+
 // src/db/mongodb.ts
 import mongoose from "mongoose";
 
@@ -694,6 +813,7 @@ var getAIConfigs = async ({
 export {
   connectToRedis,
   deleteVal,
+  extractAllBlocksFromTpl,
   genTagId,
   getAIConfigs,
   getAnnotationsModelByTenant,
@@ -707,5 +827,6 @@ export {
   initializeGlobalConfig,
   multiConnectToMongoDB,
   setVal,
+  toArray,
   updateGlobalConfig
 };

package/dist/universal.d.mts

@@ -31,4 +31,98 @@ interface RichTextValue {
 type TagNameInput = string | number | RichTextValue | null | undefined;
 declare const genTagId: (tagName: TagNameInput) => string;
 
-export { deleteVal, genTagId, getVal, setVal };
+/**
+ * Converts a value to an array, ensuring the result is always an array type.
+ *
+ * This utility function normalizes input values by:
+ * - Returning the input unchanged if it's already an array
+ * - Wrapping single values in an array
+ * - Preserving meaningful falsy values (false, 0) by wrapping them in arrays
+ * - Converting other falsy values (null, undefined, empty string) to empty arrays
+ *
+ * @template T - The type of the input value(s)
+ * @param {T | T[] | null | undefined | false | 0} property - The value to convert to an array
+ * @returns {T[]} An array containing the input value(s)
+ *
+ * @example
+ * ```typescript
+ * toArray("hello")        // ["hello"]
+ * toArray(["a", "b"])     // ["a", "b"] (unchanged)
+ * toArray(42)             // [42]
+ * toArray(false)          // [false] (preserved)
+ * toArray(0)              // [0] (preserved)
+ * toArray(null)           // []
+ * toArray(undefined)      // []
+ * toArray("")             // []
+ * ```
+ */
+declare const toArray: <T>(property: T | T[] | null | undefined | false | 0) => T[];
+
+interface Block {
+    [key: string]: any;
+    comp?: string;
+    valuePath?: string;
+    blocks?: Block[];
+}
+interface ExtractedBlock extends Block {
+    sectionStack: Section[];
+    blockPath: string;
+}
+interface Section {
+    [key: string]: any;
+    blocks?: Block[];
+}
+interface Template {
+    category: string;
+    kp_templates?: {
+        [spaceId: string]: SpaceConfig;
+    } & {
+        myProfileConfig?: Block[];
+    };
+    kp_settings?: Block[];
+}
+interface SpaceConfig {
+    builder?: 'FormBuilder' | 'MetaBuilder' | 'kp_settings' | string;
+    configs?: Block[] | {
+        inputs: {
+            [key: string]: Block;
+        };
+    };
+    subSpaces?: SpaceConfig[];
+}
+type BuilderType = 'FormBuilder' | 'MetaBuilder' | 'kp_settings' | string;
+/**
+ * Extracts all blocks from a template configuration, preserving their hierarchical context.
+ *
+ * This function traverses template structures and extracts individual block configurations
+ * while maintaining information about their location (blockPath) and parent sections
+ * (sectionStack). This metadata is crucial for:
+ * - Updating block properties at their exact location
+ * - Handling display conditions that affect entire sections
+ * - Managing nested block hierarchies in form builders
+ *
+ * @param {Object} params - Extraction parameters
+ * @param {Template} params.tpl - The template configuration to extract blocks from
+ * @param {BuilderType[]} [params.buildersWhitelist] - Optional list of builders to extract from.
+ *   If provided, only blocks from these builders will be included
+ * @returns {ExtractedBlock[]} Array of blocks with added sectionStack and blockPath metadata
+ *
+ * @example
+ * ```typescript
+ * const blocks = extractAllBlocksFromTpl({
+ *   tpl: templateConfig,
+ *   buildersWhitelist: ['FormBuilder', 'kp_settings']
+ * });
+ *
+ * // Each block will have:
+ * // - Original block properties (type, label, valuePath, etc.)
+ * // - sectionStack: Array of parent sections for display condition handling
+ * // - blockPath: Dot-notation path for precise updates (e.g., "kp_templates.header.configs.0")
+ * ```
+ */
+declare const extractAllBlocksFromTpl: ({ tpl, buildersWhitelist }: {
+    tpl: Template;
+    buildersWhitelist?: BuilderType[];
+}) => ExtractedBlock[];
+
+export { deleteVal, extractAllBlocksFromTpl, genTagId, getVal, setVal, toArray };

package/dist/universal.d.ts

@@ -31,4 +31,98 @@ interface RichTextValue {
 type TagNameInput = string | number | RichTextValue | null | undefined;
 declare const genTagId: (tagName: TagNameInput) => string;
 
-export { deleteVal, genTagId, getVal, setVal };
+/**
+ * Converts a value to an array, ensuring the result is always an array type.
+ *
+ * This utility function normalizes input values by:
+ * - Returning the input unchanged if it's already an array
+ * - Wrapping single values in an array
+ * - Preserving meaningful falsy values (false, 0) by wrapping them in arrays
+ * - Converting other falsy values (null, undefined, empty string) to empty arrays
+ *
+ * @template T - The type of the input value(s)
+ * @param {T | T[] | null | undefined | false | 0} property - The value to convert to an array
+ * @returns {T[]} An array containing the input value(s)
+ *
+ * @example
+ * ```typescript
+ * toArray("hello")        // ["hello"]
+ * toArray(["a", "b"])     // ["a", "b"] (unchanged)
+ * toArray(42)             // [42]
+ * toArray(false)          // [false] (preserved)
+ * toArray(0)              // [0] (preserved)
+ * toArray(null)           // []
+ * toArray(undefined)      // []
+ * toArray("")             // []
+ * ```
+ */
+declare const toArray: <T>(property: T | T[] | null | undefined | false | 0) => T[];
+
+interface Block {
+    [key: string]: any;
+    comp?: string;
+    valuePath?: string;
+    blocks?: Block[];
+}
+interface ExtractedBlock extends Block {
+    sectionStack: Section[];
+    blockPath: string;
+}
+interface Section {
+    [key: string]: any;
+    blocks?: Block[];
+}
+interface Template {
+    category: string;
+    kp_templates?: {
+        [spaceId: string]: SpaceConfig;
+    } & {
+        myProfileConfig?: Block[];
+    };
+    kp_settings?: Block[];
+}
+interface SpaceConfig {
+    builder?: 'FormBuilder' | 'MetaBuilder' | 'kp_settings' | string;
+    configs?: Block[] | {
+        inputs: {
+            [key: string]: Block;
+        };
+    };
+    subSpaces?: SpaceConfig[];
+}
+type BuilderType = 'FormBuilder' | 'MetaBuilder' | 'kp_settings' | string;
+/**
+ * Extracts all blocks from a template configuration, preserving their hierarchical context.
+ *
+ * This function traverses template structures and extracts individual block configurations
+ * while maintaining information about their location (blockPath) and parent sections
+ * (sectionStack). This metadata is crucial for:
+ * - Updating block properties at their exact location
+ * - Handling display conditions that affect entire sections
+ * - Managing nested block hierarchies in form builders
+ *
+ * @param {Object} params - Extraction parameters
+ * @param {Template} params.tpl - The template configuration to extract blocks from
+ * @param {BuilderType[]} [params.buildersWhitelist] - Optional list of builders to extract from.
+ *   If provided, only blocks from these builders will be included
+ * @returns {ExtractedBlock[]} Array of blocks with added sectionStack and blockPath metadata
+ *
+ * @example
+ * ```typescript
+ * const blocks = extractAllBlocksFromTpl({
+ *   tpl: templateConfig,
+ *   buildersWhitelist: ['FormBuilder', 'kp_settings']
+ * });
+ *
+ * // Each block will have:
+ * // - Original block properties (type, label, valuePath, etc.)
+ * // - sectionStack: Array of parent sections for display condition handling
+ * // - blockPath: Dot-notation path for precise updates (e.g., "kp_templates.header.configs.0")
+ * ```
+ */
+declare const extractAllBlocksFromTpl: ({ tpl, buildersWhitelist }: {
+    tpl: Template;
+    buildersWhitelist?: BuilderType[];
+}) => ExtractedBlock[];
+
+export { deleteVal, extractAllBlocksFromTpl, genTagId, getVal, setVal, toArray };

package/dist/universal.js

@@ -21,9 +21,11 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var universal_exports = {};
 __export(universal_exports, {
   deleteVal: () => deleteVal,
+  extractAllBlocksFromTpl: () => extractAllBlocksFromTpl,
   genTagId: () => genTagId,
   getVal: () => getVal,
-  setVal: () => setVal
+  setVal: () => setVal,
+  toArray: () => toArray
 });
 module.exports = __toCommonJS(universal_exports);
 
@@ -182,10 +184,131 @@ var genTagId = (tagName) => {
   toReturn = toReturn.replace(/\+/g, "plus");
   return toReturn.replace(/^_+|_+$/, "");
 };
+
+// src/utils/toArray.ts
+var toArray = (property) => {
+  if (!property && (property !== false && property !== 0)) return [];
+  if (Array.isArray(property)) return property;
+  return [property];
+};
+
+// src/utils/extractAllBlocksFromTpl.ts
+var extractAllBlocksFromTpl = ({
+  tpl,
+  buildersWhitelist
+}) => {
+  if (tpl.category === "userProfiles") {
+    const allBlocksAry = [];
+    if (tpl.kp_templates?.myProfileConfig) {
+      _recursExtractBlocks({
+        data: tpl.kp_templates.myProfileConfig,
+        cb: (block) => allBlocksAry.push(block),
+        sectionStack: [],
+        blockPathPrefix: "kp_templates.myProfileConfig"
+      });
+    }
+    return allBlocksAry;
+  } else {
+    return extractAllBlocksFromStructuredTpls({ tpl, buildersWhitelist });
+  }
+};
+var _recursExtractBlocks = ({
+  data,
+  cb,
+  sectionStack = [],
+  blockPathPrefix = ""
+}) => {
+  data.forEach((d, idx) => {
+    if (!d.blocks) {
+      cb({
+        ...d,
+        sectionStack,
+        blockPath: `${blockPathPrefix}.${idx}`
+      });
+    } else {
+      _recursExtractBlocks({
+        data: d.blocks,
+        cb,
+        sectionStack: [...sectionStack, d],
+        blockPathPrefix: `${blockPathPrefix}.${idx}.blocks`
+      });
+    }
+  });
+};
+var extractAllBlocksFromStructuredTpls = ({
+  tpl,
+  buildersWhitelist
+}) => {
+  const allBlocksAry = [];
+  if (tpl.kp_templates) {
+    for (let spaceId in tpl.kp_templates) {
+      let conf = tpl.kp_templates[spaceId];
+      if (conf.builder && buildersWhitelist && !buildersWhitelist.includes(conf.builder)) {
+        continue;
+      }
+      if (!conf.subSpaces) {
+        _extractBlocksFromSomeBuilders({
+          conf,
+          confPath: `kp_templates.${spaceId}`,
+          allBlocksAry
+        });
+      } else {
+        conf.subSpaces.forEach((sub, subIdx) => {
+          if (sub.builder && buildersWhitelist && !buildersWhitelist.includes(sub.builder)) {
+            return;
+          }
+          _extractBlocksFromSomeBuilders({
+            conf: sub,
+            confPath: `kp_templates.${spaceId}.subSpaces.${subIdx}`,
+            allBlocksAry
+          });
+        });
+      }
+    }
+  }
+  if (buildersWhitelist && !buildersWhitelist.includes("kp_settings")) {
+    return allBlocksAry;
+  }
+  if (tpl.kp_settings && tpl.kp_settings.length > 0) {
+    _recursExtractBlocks({
+      data: tpl.kp_settings,
+      cb: (block) => allBlocksAry.push(block),
+      blockPathPrefix: "kp_settings"
+    });
+  }
+  return allBlocksAry;
+};
+var _extractBlocksFromSomeBuilders = ({
+  conf,
+  confPath,
+  allBlocksAry
+}) => {
+  if (conf.builder === "FormBuilder") {
+    const configs = conf.configs || [];
+    _recursExtractBlocks({
+      data: configs,
+      cb: (block) => allBlocksAry.push(block),
+      blockPathPrefix: `${confPath}.configs`
+    });
+  }
+  if (conf.builder === "MetaBuilder") {
+    const inputs = conf.configs?.inputs || {};
+    const inputBlockConfigsToPush = Object.keys(inputs).map((inputBlockKey) => {
+      const value = inputs[inputBlockKey];
+      return {
+        ...value,
+        blockPath: `${confPath}.configs.inputs.${inputBlockKey}`
+      };
+    });
+    allBlocksAry.push(...inputBlockConfigsToPush);
+  }
+};
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   deleteVal,
+  extractAllBlocksFromTpl,
   genTagId,
   getVal,
-  setVal
+  setVal,
+  toArray
 });