vtlab-generic-functions 1.0.23 → 1.0.24

package/lambdaClass/index.js

@@ -57,9 +57,9 @@ module.exports = class Lambda {
   }
 
   s3 = {
-    upload: async (data, path) => {
+    upload: async (data, path, options = {}) => {
       return await s3bucket.uploadToS3(path, data, {
-        ContentEncoding: "base64", ContentType: "image/png",
+        ContentEncoding: options.contentEncoding || "base64", ContentType: options.ContentType ||  "image/png",
       });
     }, download: async (path) => {
       return await s3bucket.downloadFileFromS3(path);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vtlab-generic-functions",
-  "version": "1.0.23",
+  "version": "1.0.24",
   "scripts": {
     "test": "jest"
   },

package/utils/index.js

@@ -303,7 +303,87 @@ const getValueOrNullControl = (
     throw new Error(`Failed trying to get value with path ${path}`);
   }
 };
+/**
+ * Retrieves a value from a nested object structure based on a given path, 
+ * with an option to fall back to a default value if the path does not yield a valid result.
+ *
+ * @param {Object} [value={}] - The object from which to retrieve the value. Defaults to an empty object if not provided.
+ * @param {Array<string>} [paths=[]] - An array of string paths, each representing a path to a nested value in the object. 
+ *                                     The function tries each path in sequence until a valid result is obtained.
+ * @param {*} [defaultFallback=null] - The default value to return if no valid value is found at any of the specified paths. 
+ *                                     Defaults to null if not provided.
+ * @returns {*} - Returns the value found at the first valid path, the default fallback value if none of the paths are valid,
+ *                or throws an error if no paths are provided or if no fallback is set when a required path yields null.
+ * @throws {Error} - Throws an error if the first path is null (indicating no paths were provided), if a required value 
+ *                   at a path is null and no more paths are left to check (without a valid defaultFallback), or if any 
+ *                   other unexpected error occurs during execution.
+ */
+const getValueOrNullControlWithFallback = (
+  value = {},
+  paths = [],
+  defaultFallback = null
+) => {
+  try {
+    const path = paths[0];
+    if(path == null) throw new Error(`Path is required`);
+    const result = getValueOrNull(value, path);
+    if(result == null && paths.length === 1 && defaultFallback != null) return defaultFallback;
+    if(result == null && paths.length === 1) throw new Error(`Value path ${path} is required`);
+    if (result) return result;
+    if(paths.length === 1) return defaultFallback;
+    return getValueOrNullControlWithFallback(value, paths.slice(1), defaultFallback);
+  } catch (e) {
+    throw e || new Error(`Failed trying to get value with paths ${paths}`);
+  }
+};
 
+/**
+ * Determines the MIME type of a file encoded in base64 format based on the file's signature.
+ *
+ * @param {string} base64 - The base64 encoded string of the file.
+ * @returns {string} - The MIME type of the file. Returns 'application/octet-stream' if the type cannot be determined.
+ */
+const getMimeTypeFromBase64 = (base64,defaultType = 'application/pdf') => {
+  const signatures = {
+    JVBERi0: 'application/pdf',
+    R0lGOD: 'image/gif',
+    iVBOR: 'image/png',
+    '/9j/': 'image/jpg',
+  };
+
+  for (const sign in signatures) {
+    if (base64.includes(sign)) return signatures[sign];
+  }
+  return defaultType;
+};
+
+
+/**
+ * Determines the type of freight charges based on the given INCOTERM.
+ *
+ * @param {string} incoterm - The INCOTERM code based on which the freight charge type is determined.
+ * @returns {string} - Returns "D" for direct charges or "P" for prepaid charges.
+ */
+const getTipoPortes = incoterm => {
+  switch (String(incoterm).toUpperCase()) {
+    case "EXW":
+    case "FAS":
+    case "FOB":
+      return "D";
+    case "FCA":
+    case "CPT":
+    case "CIP":
+    case "DPU":
+    case "DAP":
+    case "DDP":
+    case "CFR":
+    case "CIF":
+      return "P";
+    default:
+      return "P";
+  }
+}
+ 
 // use it to create safe fields for csv files writing
 const generateCSVField = (
   obj,
@@ -576,4 +656,7 @@ module.exports = {
   generateUuid,
   mergePDF,
   getMessageAndCodeFromError,
+  getValueOrNullControlWithFallback,
+  getMimeTypeFromBase64,
+  getTipoPortes,
 };