@okf/ootils 1.1.0 → 1.2.0

package/dist/index.d.mts

@@ -1,3 +1,25 @@
 declare function add(a: number, b: number): number;
 
-export { add };
+declare const deleteVal: (data: any, valuePath: string) => any;
+
+type ValuePath = string | string[];
+type DataValue = any;
+interface GetValOptions {
+    flattenIfValueIsArray?: boolean;
+}
+
+declare const setVal: (data: any, valuePath: string, value: DataValue) => any;
+
+/**
+ *
+ * @param {*} data
+ * @param {*} valuePath
+ * @returns
+ * - if target value is an array found inside an array, it will flatten them out so that there is a single array
+ * - if target value is an array NOT found inside an array, that will be returned as is.
+ * - if target value is a string/object/number/boolean found inside an array of arrays, then the inner arrays will be flattened so that there is a single array
+ * - if target value is a string/object/number/boolean NOT found inside an array, it will be returned as is.
+ */
+declare const getVal: (data: any, valuePath: ValuePath, options?: GetValOptions, depthIdx?: number) => any;
+
+export { add, deleteVal, getVal, setVal };

package/dist/index.d.ts

@@ -1,3 +1,25 @@
 declare function add(a: number, b: number): number;
 
-export { add };
+declare const deleteVal: (data: any, valuePath: string) => any;
+
+type ValuePath = string | string[];
+type DataValue = any;
+interface GetValOptions {
+    flattenIfValueIsArray?: boolean;
+}
+
+declare const setVal: (data: any, valuePath: string, value: DataValue) => any;
+
+/**
+ *
+ * @param {*} data
+ * @param {*} valuePath
+ * @returns
+ * - if target value is an array found inside an array, it will flatten them out so that there is a single array
+ * - if target value is an array NOT found inside an array, that will be returned as is.
+ * - if target value is a string/object/number/boolean found inside an array of arrays, then the inner arrays will be flattened so that there is a single array
+ * - if target value is a string/object/number/boolean NOT found inside an array, it will be returned as is.
+ */
+declare const getVal: (data: any, valuePath: ValuePath, options?: GetValOptions, depthIdx?: number) => any;
+
+export { add, deleteVal, getVal, setVal };

package/dist/index.js

@@ -20,7 +20,10 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
-  add: () => add
+  add: () => add,
+  deleteVal: () => deleteVal,
+  getVal: () => getVal,
+  setVal: () => setVal
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -28,7 +31,141 @@ module.exports = __toCommonJS(index_exports);
 function add(a, b) {
   return a + b;
 }
+
+// src/utils/getterSetterDeleter/utils/set_deleteVal.ts
+var set_deleteVal = (action, data, valuePath, value) => {
+  if (valuePath === void 0) return;
+  if (valuePath === null && action === "set") {
+    data = value;
+    return data;
+  }
+  let dataRef = data;
+  const keysArray = valuePath.split(".");
+  const len = keysArray.length;
+  let valIsUndefined = false;
+  for (let i = 0; i < len - 1; i++) {
+    const key = keysArray[i];
+    if (!dataRef[key]) {
+      if (action === "set") {
+        const nextKey = keysArray[i + 1];
+        if (nextKey && !isNaN(parseInt(nextKey))) {
+          dataRef[key] = [];
+        } else {
+          dataRef[key] = {};
+        }
+      } else {
+        valIsUndefined = true;
+        break;
+      }
+    }
+    dataRef = dataRef[key];
+  }
+  if (valIsUndefined) return void 0;
+  if (action === "set") {
+    dataRef[keysArray[len - 1]] = value;
+    return data;
+  } else if (action === "delete") {
+    if (Array.isArray(dataRef)) {
+      dataRef.splice(parseInt(keysArray[len - 1]), 1);
+    } else {
+      delete dataRef[keysArray[len - 1]];
+    }
+    return data;
+  }
+};
+
+// src/utils/getterSetterDeleter/deleteVal.ts
+var deleteVal = (data, valuePath) => {
+  return set_deleteVal("delete", data, valuePath);
+};
+
+// src/utils/getterSetterDeleter/setVal.ts
+var setVal = (data, valuePath, value) => {
+  return set_deleteVal("set", data, valuePath, value);
+};
+
+// src/utils/getterSetterDeleter/utils/flattenArrayOfArrays.ts
+var flattenArrayOfArrays = ({
+  array,
+  flattenLastArray = true,
+  toReturn = []
+}) => {
+  array.map((ary) => {
+    if (Array.isArray(ary)) {
+      if (flattenLastArray === true) {
+        if (ary.some((childAry) => !Array.isArray(childAry))) {
+          toReturn.push(ary);
+        } else {
+          flattenArrayOfArrays({ array: ary, flattenLastArray, toReturn });
+        }
+      } else {
+        flattenArrayOfArrays({ array: ary, flattenLastArray, toReturn });
+      }
+    } else {
+      toReturn.push(ary);
+    }
+  });
+  return toReturn;
+};
+
+// src/utils/getterSetterDeleter/getVal.ts
+var getVal = (data, valuePath, options = {}, depthIdx = 0) => {
+  let value = null;
+  const getFinalVal = (data2, valuePath2, options2, depthIdx2) => {
+    return Array.isArray(data2) ? data2.map((R) => getValV2_getter(R, valuePath2, options2, depthIdx2)) : getValV2_getter(data2, valuePath2, options2, depthIdx2);
+  };
+  if (Array.isArray(valuePath)) {
+    for (let i = 0; i < valuePath.length; i++) {
+      value = getFinalVal(data, valuePath[i], options, depthIdx);
+      if (value) break;
+    }
+  } else {
+    value = getFinalVal(data, valuePath, options, depthIdx);
+  }
+  return value;
+};
+var getValV2_getter = (data, valuePath, options, depthIdx) => {
+  const { flattenIfValueIsArray = true } = options;
+  if (valuePath === null) return data;
+  let dataRef = data;
+  const keysArray = valuePath.split(".");
+  const len = keysArray.length;
+  let valIsUndefined = false;
+  let thisIterationFoundAry = false;
+  for (let i = 0; i < len - 1; i++) {
+    const key = keysArray[i];
+    if (!thisIterationFoundAry) {
+      if (!dataRef[key]) {
+        valIsUndefined = true;
+        break;
+      }
+      dataRef = dataRef[key];
+    } else {
+      const nestedAryResponse = dataRef.map((dataRefItem) => {
+        const remainingValuePath = keysArray.filter((dd, ii) => ii >= i).join(".");
+        return getVal(dataRefItem, remainingValuePath, options, depthIdx + 1);
+      });
+      return flattenArrayOfArrays({
+        array: nestedAryResponse,
+        flattenLastArray: depthIdx === 0 && flattenIfValueIsArray === false ? false : true
+      });
+    }
+    if (Array.isArray(dataRef) && Number.isNaN(parseInt(keysArray[i + 1]))) thisIterationFoundAry = true;
+  }
+  if (valIsUndefined) return void 0;
+  if (thisIterationFoundAry) {
+    const toReturn = dataRef.map((d) => d[keysArray[len - 1]]);
+    return flattenArrayOfArrays({
+      array: toReturn,
+      flattenLastArray: flattenIfValueIsArray
+    });
+  }
+  return dataRef[keysArray[len - 1]];
+};
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  add
+  add,
+  deleteVal,
+  getVal,
+  setVal
 });

package/dist/index.mjs

@@ -2,6 +2,140 @@
 function add(a, b) {
   return a + b;
 }
+
+// src/utils/getterSetterDeleter/utils/set_deleteVal.ts
+var set_deleteVal = (action, data, valuePath, value) => {
+  if (valuePath === void 0) return;
+  if (valuePath === null && action === "set") {
+    data = value;
+    return data;
+  }
+  let dataRef = data;
+  const keysArray = valuePath.split(".");
+  const len = keysArray.length;
+  let valIsUndefined = false;
+  for (let i = 0; i < len - 1; i++) {
+    const key = keysArray[i];
+    if (!dataRef[key]) {
+      if (action === "set") {
+        const nextKey = keysArray[i + 1];
+        if (nextKey && !isNaN(parseInt(nextKey))) {
+          dataRef[key] = [];
+        } else {
+          dataRef[key] = {};
+        }
+      } else {
+        valIsUndefined = true;
+        break;
+      }
+    }
+    dataRef = dataRef[key];
+  }
+  if (valIsUndefined) return void 0;
+  if (action === "set") {
+    dataRef[keysArray[len - 1]] = value;
+    return data;
+  } else if (action === "delete") {
+    if (Array.isArray(dataRef)) {
+      dataRef.splice(parseInt(keysArray[len - 1]), 1);
+    } else {
+      delete dataRef[keysArray[len - 1]];
+    }
+    return data;
+  }
+};
+
+// src/utils/getterSetterDeleter/deleteVal.ts
+var deleteVal = (data, valuePath) => {
+  return set_deleteVal("delete", data, valuePath);
+};
+
+// src/utils/getterSetterDeleter/setVal.ts
+var setVal = (data, valuePath, value) => {
+  return set_deleteVal("set", data, valuePath, value);
+};
+
+// src/utils/getterSetterDeleter/utils/flattenArrayOfArrays.ts
+var flattenArrayOfArrays = ({
+  array,
+  flattenLastArray = true,
+  toReturn = []
+}) => {
+  array.map((ary) => {
+    if (Array.isArray(ary)) {
+      if (flattenLastArray === true) {
+        if (ary.some((childAry) => !Array.isArray(childAry))) {
+          toReturn.push(ary);
+        } else {
+          flattenArrayOfArrays({ array: ary, flattenLastArray, toReturn });
+        }
+      } else {
+        flattenArrayOfArrays({ array: ary, flattenLastArray, toReturn });
+      }
+    } else {
+      toReturn.push(ary);
+    }
+  });
+  return toReturn;
+};
+
+// src/utils/getterSetterDeleter/getVal.ts
+var getVal = (data, valuePath, options = {}, depthIdx = 0) => {
+  let value = null;
+  const getFinalVal = (data2, valuePath2, options2, depthIdx2) => {
+    return Array.isArray(data2) ? data2.map((R) => getValV2_getter(R, valuePath2, options2, depthIdx2)) : getValV2_getter(data2, valuePath2, options2, depthIdx2);
+  };
+  if (Array.isArray(valuePath)) {
+    for (let i = 0; i < valuePath.length; i++) {
+      value = getFinalVal(data, valuePath[i], options, depthIdx);
+      if (value) break;
+    }
+  } else {
+    value = getFinalVal(data, valuePath, options, depthIdx);
+  }
+  return value;
+};
+var getValV2_getter = (data, valuePath, options, depthIdx) => {
+  const { flattenIfValueIsArray = true } = options;
+  if (valuePath === null) return data;
+  let dataRef = data;
+  const keysArray = valuePath.split(".");
+  const len = keysArray.length;
+  let valIsUndefined = false;
+  let thisIterationFoundAry = false;
+  for (let i = 0; i < len - 1; i++) {
+    const key = keysArray[i];
+    if (!thisIterationFoundAry) {
+      if (!dataRef[key]) {
+        valIsUndefined = true;
+        break;
+      }
+      dataRef = dataRef[key];
+    } else {
+      const nestedAryResponse = dataRef.map((dataRefItem) => {
+        const remainingValuePath = keysArray.filter((dd, ii) => ii >= i).join(".");
+        return getVal(dataRefItem, remainingValuePath, options, depthIdx + 1);
+      });
+      return flattenArrayOfArrays({
+        array: nestedAryResponse,
+        flattenLastArray: depthIdx === 0 && flattenIfValueIsArray === false ? false : true
+      });
+    }
+    if (Array.isArray(dataRef) && Number.isNaN(parseInt(keysArray[i + 1]))) thisIterationFoundAry = true;
+  }
+  if (valIsUndefined) return void 0;
+  if (thisIterationFoundAry) {
+    const toReturn = dataRef.map((d) => d[keysArray[len - 1]]);
+    return flattenArrayOfArrays({
+      array: toReturn,
+      flattenLastArray: flattenIfValueIsArray
+    });
+  }
+  return dataRef[keysArray[len - 1]];
+};
 export {
-  add
+  add,
+  deleteVal,
+  getVal,
+  setVal
 };

package/package.json

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