utiller 1.0.412 → 1.0.413

package/lib/utiller/index.js

@@ -1,3531 +1 @@
-"use strict";
-
-var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.default = void 0;
-var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
-var _lodash = _interopRequireDefault(require("lodash"));
-var _cryptoJs = _interopRequireDefault(require("crypto-js"));
-var _configerer = require("configerer");
-var _exceptioner = _interopRequireDefault(require("../exceptioner"));
-var _momentTimezone = _interopRequireDefault(require("moment-timezone"));
-var _uuid = require("uuid");
-var _nodeHtmlParser = require("node-html-parser");
-/**
- * npm_module之後每三個月要更新Granular Token
- * 到這裡申請新的token => https://www.npmjs.com/settings/davidtu/tokens/
- * vim ~/.npmrc
- * 更新=> //registry.npmjs.org/:_authToken=${npm_7a9n_xxxxxxxx} <-新token
- * npm publish --dry-run
- * 如果沒報錯 → Token 已生效，可以繼續 deploy。
- */
-
-String.format = function () {
-  let param = [];
-  for (let i = 0, l = arguments.length; i < l; i++) {
-    param.push(arguments[i]);
-  }
-  let statement = param[0]; // get the first element(the original statement)
-  param.shift(); // remove the first element from array
-  return statement.replace(/\{(\d+)\}/g, function (m, n) {
-    return param[n];
-  });
-};
-class Utiller {
-  /**   Key : idOfSetTimout */
-
-  /** '1.九.1' => false
-   *  '1.2.3' => true
-   * */
-
-  /**
-   * 刪除物件裡面特別的屬性，預設是刪除value為undefined
-   **/
-  removeAttributeBy(object, predicate = value => _lodash.default.isUndefined(value)) {
-    for (const key in object) {
-      if (predicate(object[key])) {
-        delete object[key];
-      }
-    }
-  }
-  getNumberOfNormalize(value, defaultValue = 0) {
-    if (_lodash.default.isNumber(value)) return value;
-    try {
-      const force = _lodash.default.toNumber(value);
-      return _lodash.default.isNumber(force) && !isNaN(force) ? force : defaultValue;
-    } catch (error) {
-      Util.appendError(`448561684561 ${error.message}`);
-    }
-    return defaultValue;
-  }
-  getStringOfNormalize(value, defaultValue = "", trim = false) {
-    if (_lodash.default.isString(value)) return trim ? _lodash.default.trim(value) : value;
-    try {
-      const force = _lodash.default.toString(value);
-      return this.isOrEquals(force, "", "undefined") ? defaultValue : trim ? _lodash.default.trim(force) : force;
-    } catch (error) {
-      Util.appendError(`448616845453 ${error.message}`);
-    }
-    return defaultValue;
-  }
-  isValidVersionOfString(versionName) {
-    if (this.isUndefinedNullEmpty(versionName)) {
-      return false;
-    }
-    const numbers = versionName.split(".");
-    for (const number of numbers) {
-      const toNum = _lodash.default.toNumber(number);
-      if (!_lodash.default.isNumber(toNum) || isNaN(toNum)) return false;
-    }
-    return true;
-  }
-  getSeparatorOfUnique() {
-    return "།།";
-  }
-
-  /** 1.0.1 => 1.0.2 */
-  getStringOfVersionIncrement(stringOfVersion, delta = 1) {
-    const numbers = stringOfVersion.split(".").map(each => _lodash.default.toNumber(each));
-    const last = numbers.length - 1;
-    numbers[last] = numbers[last] + delta;
-    return numbers.join(".");
-  }
-  setLocaleOfMoment(locale = "en") {
-    _momentTimezone.default.locale(locale);
-  }
-  getUuidOfV4() {
-    return (0, _uuid.v4)();
-  }
-  constructor() {
-    (0, _defineProperty2.default)(this, "mapOfIdNTimeoutId", {});
-    (0, _defineProperty2.default)(this, "getEnvironment", () => {
-      return this.env;
-    });
-    (0, _defineProperty2.default)(this, "isProductionEnvironment", () => {
-      return _lodash.default.isEqual(this.getEnvironment(), "prod");
-    });
-    /** this is used for unit test,
-     * param 是給 runInBackground 用的 => param */
-    (0, _defineProperty2.default)(this, "asyncUnitTaskFunction", (millionSec = 2000, _funparam = "預設的param", errorSimulator) => async (param = this.getRandomHash(10)) => {
-      const randomValue = this.getRandomValue(millionSec, millionSec * 1.2);
-      try {
-        const symbol = randomValue;
-        this.appendInfo(`before executed ===> i'm symbol of ${symbol}, ready to be executed, inner param = ${_funparam}`);
-        await this.syncDelay(randomValue);
-        if (_lodash.default.isFunction(errorSimulator) && errorSimulator(param)) throw Error("force to made error happen");
-        this.appendInfo(`after executed ===> i'm symbol of ${symbol}, the task cost ${randomValue} million-seconds ${param ? `i hav params ===> ${param}` : ""}`);
-        return {
-          randomValue,
-          symbol,
-          param
-        };
-      } catch (error) {
-        this.appendError(new Error(`asyncUnitTask() catch error ${error.message}`));
-      } finally {
-        this.appendInfo(`wow.... finally got you`);
-      }
-    });
-    (0, _defineProperty2.default)(this, "test", word => {
-      return async () => {
-        await Util.syncDelay(3000);
-        console.log("經過了三秒");
-        await Util.syncDelay(4000);
-        console.log("經過了四秒");
-        await Util.syncDelay(5000);
-        console.log("經過了五秒");
-        await Util.syncDelay(6000);
-        console.log("經過了六秒");
-        return `3423809432804 ${word}`;
-      };
-    });
-    /** const items = [{ price: 10 }, { price: 120 }, { price: 230 }];
-       console.log(findLowestPrice(items)); // 輸出: 10
-       */
-    (0, _defineProperty2.default)(this, "findLowestValue", (items, key = "price") => {
-      // 提取價格並找出最小值
-      const minPrice = _lodash.default.minBy(items, key)[key];
-      // 確保回傳的最低價為 integer 型態
-      return Math.floor(minPrice);
-    });
-    /** const items = [{ price: 10 }, { price: 120 }, { price: 230 }];
-       console.log(findLowestPrice(items)); // 輸出: 120
-       */
-    (0, _defineProperty2.default)(this, "findHighestValue", (items, key = "price") => {
-      // 提取價格並找出最小值
-      const maxPrice = _lodash.default.maxBy(items, key)[key];
-
-      // 確保回傳的最低價為 integer 型態
-      return Math.floor(maxPrice);
-    });
-    /**
-     * // 測試數據
-     *     const items = [{ price: 10 }, { price: 120 }, { price: 230 }];
-     *     console.log(getPriceRange(items)); // 輸出: $10 - $230
-     * */
-    (0, _defineProperty2.default)(this, "getStringOfValueRange", (items, key = "price", sign = "$") => {
-      // 找出最小值和最大值
-      const minV = _lodash.default.minBy(items, key)[key];
-      const maxV = _lodash.default.maxBy(items, key)[key];
-      // 判斷並返回字串
-      return maxV === minV ? `$${minV}` : `${sign}${minV} - ${sign}${maxV}`;
-    });
-    (0, _defineProperty2.default)(this, "getCallersName", () => {
-      let callerName;
-      try {
-        throw new Error();
-      } catch (e) {
-        let re = /(\w+)@|at (\w+) \(/g,
-          st = e.stack,
-          m;
-        re.exec(st), m = re.exec(st);
-        if (!_lodash.default.isNull(m)) callerName = m[1] || m[2];
-      }
-      if (_lodash.default.startsWith("asyncGeneratorStep", callerName)) callerName = "";
-      return callerName;
-    });
-    (0, _defineProperty2.default)(this, "getRandomValue", (min, max) => {
-      min = Math.ceil(min);
-      max = Math.floor(max);
-      return Math.floor(Math.random() * (max - min + 1)) + min;
-    });
-    /**
-     * 將items insert指定的index後方
-     * modify origin array
-     * 如果要insert to head, index 要給 -1
-     * const array = [3, 4, 5];
-     * utiller.insertToArray(array, -1, 'QQ', 'WW'); /** ['QQ','WW',3,4,5]
-     * utiller.insertToArray(array, 1, 'QQ', 'WW'); /** [3,'QQ','WW',4,5]
-     * utiller.insertToArray(array, 999, 'QQ', 'WW'); /**  [3,4,5,'QQ','WW']
-     * */
-    (0, _defineProperty2.default)(this, "insertToArray", (array, index, ...items) => {
-      if (!Array.isArray(array)) {
-        throw new Error("First argument must be an array.");
-      }
-      // splice 的 index 是插入位置，原函式 index 是插入點的前一個位置
-      // index = -1 應插入到開頭 (index 0)
-      // index >= array.length 應插入到結尾
-      const insertAt = Math.max(0, Math.min(index + 1, array.length));
-      array.splice(insertAt, 0, ...items);
-      // 注意：此函式直接修改了傳入的 array，行為與原函式不同（原函式隱式返回 undefined 但修改了 array）
-      // 如果需要保持原函式返回 undefined 的行為，可以不加 return
-      // 如果希望返回修改後的 array，可以 return array;
-    });
-    /** 西元年 轉成 民國年
-     * full = 是否打印出全名 民國 ＸＸ 年
-     * */
-    (0, _defineProperty2.default)(this, "getStringOfYearADConvertToMinguoYear", (gregorianYear, full = false) => {
-      const minguoYear = gregorianYear - 1911;
-      if (minguoYear > 0) {
-        return `${full ? "民國" : ""}${minguoYear}${full ? "年" : ""}`;
-      } else {
-        return `${full ? "民國" : ""}前${Math.abs(minguoYear)}${full ? "年" : ""}`;
-      }
-    });
-    /**
-     * // Example usage
-     * const date = '2024-07-25';
-     * console.log(convertDateToTimestamp(date)); // Outputs the timestamp for 2024-07-25*/
-    (0, _defineProperty2.default)(this, "convertDateToTimestamp", date => {
-      return (0, _momentTimezone.default)(date).valueOf(); // valueOf() returns the timestamp in milliseconds
-    });
-    /** // 示例函數來測試運行時間
-       async function exampleFunction() {
-       return new Promise((resolve) => setTimeout(resolve, 3210)); // 模擬3.21秒延遲
-       }
-        // 測試 measureExecutionTime 函數
-       measureExecutionTime(exampleFunction).then(result => {
-       console.log(result); // 輸出：0小時 0分 3.210秒 (合計 3.210 秒)
-       });
-        */
-    (0, _defineProperty2.default)(this, "measureExecutionTime", async (fn, ...param) => {
-      // 開始計時
-      const startTime = Date.now();
-
-      // 執行傳入的函數
-      await fn(...param);
-
-      // 結束計時
-      const endTime = Date.now();
-
-      // 計算總運行時間（毫秒）
-      const durationInMilliseconds = endTime - startTime;
-
-      // 使用 moment.duration 格式化為 hh:mm:ss.SSS
-      const duration = _momentTimezone.default.duration(durationInMilliseconds, "milliseconds");
-      const hours = Math.floor(duration.asHours());
-      const minutes = duration.minutes();
-      const seconds = duration.seconds();
-      const milliseconds = duration.milliseconds();
-
-      // 計算總秒數（包含小數點）
-      const totalSeconds = (durationInMilliseconds / 1000).toFixed(3);
-
-      // 返回結果
-      this.appendInfo(`${hours}小時 ${minutes}分 ${seconds}.${milliseconds.toString().padStart(3, "0")}秒 (合計 ${totalSeconds} 秒)`);
-    });
-    (0, _defineProperty2.default)(this, "formatPriceWithCurrency", (number, locale) => {
-      if (typeof number !== "number" || typeof locale !== "string") {
-        throw new TypeError("Invalid input: number must be a number and locale must be a string.");
-      }
-      return new Intl.NumberFormat(locale, {
-        style: "currency",
-        currency: new Intl.Locale(locale).maximize().currency || "USD",
-        minimumFractionDigits: 0 // 確保不顯示小數
-      }).format(number);
-    });
-    (0, _defineProperty2.default)(this, "formatPrice", (number, locale) => {
-      if (typeof number !== "number") {
-        throw new TypeError("Invalid input: number must be a number.");
-      }
-
-      // 如果沒有傳入 locale，僅格式化數字
-      if (!locale) {
-        return number.toLocaleString("en-US"); // 預設使用美式數字格式
-      }
-
-      // 有傳入 locale，使用貨幣格式化
-      return new Intl.NumberFormat(locale, {
-        style: "currency",
-        currency: new Intl.Locale(locale).maximize().currency || "USD",
-        minimumFractionDigits: 0 // 確保不顯示小數
-      }).format(number);
-    });
-    /**
-     * 使用 ES10+ 和 Lodash，將短句子轉換為潛在的搜尋關鍵字陣列。
-     * 策略：1. 提取英文單字 2. 提取規格/色號詞組 3. 清理中文 4. 窮舉中文 N-gram 5. 去重和過濾
-     * @param {string} sentence - 原始字串。
-     * @param {number} [maxLength=50] - 允許的最大字串長度。
-     * @param {number} [maxNgramLength=3] - N-gram 的最大長度，預設為 3。
-     * @returns {string[]} - 潛在關鍵字陣列（至少 2 個字/中文字）。
-     */
-    (0, _defineProperty2.default)(this, "generateUniversalKeywords", (sentence, maxLength = 50, maxNgramLength = 4) => {
-      // 引入 Lodash，確保在執行環境中可用
-      if (!sentence || typeof sentence !== "string") {
-        return [];
-      }
-
-      // 假設 Lodash 已經全域引入為 '_'
-      if (typeof _lodash.default === "undefined") {
-        console.error("Lodash is not available. Please ensure it is imported.");
-        return [];
-      }
-      let textToProcess = sentence.trim();
-      let keywords = []; // 最終所有關鍵字的集合
-
-      // 參數安全檢查 (確保 N-gram 長度至少為 2)
-      maxNgramLength = Math.max(2, maxNgramLength);
-
-      // 警告/截斷邏輯
-      if (textToProcess.length > maxLength) {
-        console.warn(`警告：輸入字串長度為 ${textToProcess.length}，已根據 maxLength: ${maxLength} 截斷。`);
-        textToProcess = textToProcess.substring(0, maxLength);
-      }
-
-      // --- 步驟 1: 提取完整英文單字 (SACHIA, sachia, Sachia) ---
-      const englishWords = textToProcess.match(/[a-zA-Z]+/g) || [];
-      englishWords.forEach(word => {
-        if (word.length >= 2) {
-          keywords.push(word.toUpperCase());
-          keywords.push(word.toLowerCase());
-          const capitalized = word.charAt(0).toUpperCase() + word.slice(1).toLowerCase();
-          keywords.push(capitalized);
-        }
-      });
-
-      // --- 步驟 2: 提取規格、數量和色號關鍵字 (12W, 10ml, 10色, 1號) ---
-      const specKeywordsRegex = /\b[0-9]+[a-zA-Z]{1,4}\b|\b[0-9]{1,3}(w|ml|g|oz|k)\b|[\u4e00-\u9fa5a-zA-Z0-9]{1,4}(色|號)[\u4e00-\u9fa5a-zA-Z0-9]{0,2}/gi;
-      const specKeywords = (textToProcess.match(specKeywordsRegex) || []).filter(k => k.length >= 2).map(k => k.toLowerCase());
-      keywords.push(...specKeywords);
-
-      // --- 步驟 3: 清理和標準化 (用於 N-gram 提取) ---
-
-      let cleanText = textToProcess.toLowerCase();
-
-      // 1. 將所有提取過的規格詞彙（數字+單位/字母）替換為空格
-      cleanText = cleanText.replace(/[0-9]+([\u4e00-\u9fa5a-z]{1,4}|[\/\-\~\\])/g, " ").replace(/\b[a-z]{1,4}\b/g, " ").replace(/\b[0-9]{1,3}\b/g, " ");
-
-      // 2. 移除通用詞和符號
-      cleanText = cleanText.replace(/[!@#$%^&*()_+={}\[\]:;"'<>,.?\/\\|`~]/g, " ").replace(/系列|一組|單色|多款|套組|全套|專用|迷你|頂級|高品質|超閃|奢華|最新|款式|新款|超亮|的|與|和|閃|美甲/g, " ").replace(/\s+/g, "") // **移除所有空格**
-      .trim();
-
-      // --- 步驟 4: 窮舉所有 >= 2 個字的 N-gram 詞組 (針對純中文) ---
-      const minLength = 2;
-      // maxNgramLength 現在是從參數傳入的
-
-      for (let len = minLength; len <= maxNgramLength; len++) {
-        for (let i = 0; i <= cleanText.length - len; i++) {
-          const keyword = cleanText.substring(i, i + len);
-          keywords.push(keyword);
-        }
-      }
-
-      // --- 步驟 5: 標準化、去重和過濾 ---
-      const finalKeywords = _lodash.default.chain(keywords).filter(k => k.length >= 2).filter(k => k.length > 2 || !/^[\u4e00-\u9fa5a-z0-9]$/.test(k)).uniq().sortBy().value();
-      return finalKeywords;
-    });
-    /**
-     * 直接修改原本 array，將 object 移動到指定 index
-     * @param {Array} array - 要修改的陣列
-     * @param {Object} object - 要移動的物件
-     * @param {number} index - 目標位置（預設為 0）
-     * @returns {Array} 修改後的原陣列（in-place）
-     */
-    (0, _defineProperty2.default)(this, "mutateIndexOfArrayItem", (array, object, index = 0) => {
-      if (!Array.isArray(array) || !_lodash.default.isObject(object)) return array;
-      const currentIndex = _lodash.default.findIndex(array, item => _lodash.default.isEqual(item, object));
-      if (currentIndex === -1) return array; // 找不到物件，直接回傳
-
-      array.splice(currentIndex, 1); // 先移除原位置
-      const targetIndex = _lodash.default.clamp(index, 0, array.length);
-      array.splice(targetIndex, 0, object); // 插入到新位置
-
-      return array;
-    });
-    /**
-     * 將指定 object 移動到 array 中的指定位置
-     * @param {Array} array - 要操作的陣列
-     * @param {Object} object - 要移動的目標物件
-     * @param {number} index - 新的位置（預設為 0）
-     * @returns {Array} 新的陣列
-     */
-    (0, _defineProperty2.default)(this, "getArrayOfModifyObject2Index", (array, object, index = 0) => {
-      if (!Array.isArray(array) || !_lodash.default.isObject(object)) return array;
-      const cloned = _lodash.default.cloneDeep(array); // 深拷貝以避免原陣列被 mutate
-      const currentIndex = _lodash.default.findIndex(cloned, item => _lodash.default.isEqual(item, object));
-      if (currentIndex === -1) return array; // 沒找到物件就回傳原陣列
-
-      // 移除原來位置
-      cloned.splice(currentIndex, 1);
-
-      // 插入到指定位置（修正越界 index）
-      const targetIndex = _lodash.default.clamp(index, 0, cloned.length);
-      cloned.splice(targetIndex, 0, object);
-      return cloned;
-    });
-    /**
-     * const origin = [
-     *   { label: 'aa', value: 1203 },
-     *   { label: 'cc', value: 1204 },
-     *   { label: 'gg', value: 2 }
-     * ];
-     *
-     * const latest = ['aa', 'bb', 'aa', 'dd'];
-     * console.log(generateLabelValuePairsWithOrigin(origin, latest));
-     * [
-     *   { label: 'aa', value: 1203 },        // 來自 origin
-     *   { label: 'bb', value: 843910 },      // 隨機唯一值
-     *   { label: 'dd', value: 692384 }       // 隨機唯一值
-     * ]
-     *
-     * 根據 latest 字串陣列建立 label/value 物件陣列。
-     * 若 label 存在於 origin 中，則沿用 origin 的 value；
-     * 若 label 不存在，則產生唯一隨機數值作為 value（value 不可重複）。
-     *
-     * @param {Array<{label: string, value: number}>} origin - 原始資料來源，包含已知 label 與對應的 value。
-     * @param {Array<string>} latest - 最新輸入的 label 陣列，可能有重複或新值。
-     * @returns {Array<{label: string, value: number}>} - 轉換完成的唯一 label/value 陣列。
-     */
-    (0, _defineProperty2.default)(this, "generateLabelValuePairsWithOrigin", (origin = [{
-      label: "aa",
-      value: 1203
-    }, {
-      label: "cc",
-      value: 1204
-    }, {
-      label: "gg",
-      value: 2
-    }], latest = ["aa", "bb"]) => {
-      // 建立已使用過的 value 集合，避免重複
-      const usedValues = new Set(origin.map(o => o.value));
-
-      // 處理 latest label 清單
-      return _lodash.default.chain(latest).uniq() // 1. 移除重複的 label（只保留唯一值）
-      .map(label => {
-        // 2. 嘗試從 origin 找出是否已存在該 label
-        const originItem = _lodash.default.find(origin, {
-          label
-        });
-        if (originItem) {
-          // 3. 若存在，直接使用 origin 中的 value
-          return {
-            label,
-            value: originItem.value
-          };
-        }
-
-        // 4. 若不存在，產生一個不重複的隨機 value
-        let value;
-        do {
-          // Firestore 可接受的整數範圍（可調整範圍）
-          value = _lodash.default.random(2, 999999999);
-        } while (usedValues.has(value)); // 確保 value 唯一
-
-        // 5. 記錄該值為已使用，避免後續重複
-        usedValues.add(value);
-
-        // 6. 回傳新的物件
-        return {
-          label,
-          value
-        };
-      }).value(); // 7. 輸出處理完成的物件陣列
-    });
-    /**
-     * 比對 values 是否出現在 sourceArray 的指定欄位中，並標記 flagKey 欄位
-     *
-     * @param {Array} values - 要比對的值陣列，例如: [1, 3]
-     * @param {Array} sourceArray - 要處理的物件陣列
-     * @param {string} [valueKey='value'] - 要比對的欄位名稱，預設為 'value'
-     * @param {string} [flagKey='belong'] - 回傳中標記的欄位名稱，預設為 'belong'
-     * @returns {Array} 處理後的陣列
-     *           const B = [
-     *               { value: 1, label: 'hi' },
-     *               { value: 2, label: 'hii' },
-     *               { value: 3, label: 'hiii' }
-     *           ];
-     *           console.log(utiller.getItemsOfMarkMatching( B,[1]))
-     *           [
-     *            { value: 1, label: 'hi', belong: true },
-     *            { value: 2, label: 'hii', belong: false },
-     *            { value: 3, label: 'hiii', belong: false }
-     *          ]
-     **/
-    (0, _defineProperty2.default)(this, "getItemsOfMarkMatching", (sourceArray = [], values = [], valueKey = "value", flagKey = "belong") => {
-      const valuesSet = new Set(values); // 使用 Set 提高效能
-      return _lodash.default.map(sourceArray, item => ({
-        ...item,
-        [flagKey]: valuesSet.has(item[valueKey])
-      }));
-    });
-    /**
-     * 將多維屬性陣列進行排列組合，輸出為組合 label 和 value。
-     * @param {Array<Array<{label: string, value: string}>>} arrays - 多個陣列，每個陣列包含 {label, value}
-     * @param {string} labelSeparator - 標籤用的分隔符號（預設為 '｜'）
-     * @param {string} valueSeparator - 值用的分隔符號（預設為 '-'）
-     * @returns {Array<{label: string, value: string}>}
-     *
-     * const arrays = [
-     *   [
-     *     { label: '紅', value: '1b' },
-     *     { label: '黑', value: 'ca' }
-     *   ],
-     *   [
-     *     { label: 'M號', value: 'f2' },
-     *     { label: 'L號', value: 'q5' }
-     *   ],
-     *   [
-     *     { label: '短袖', value: 's1' },
-     *     { label: '長袖', value: 's2' }
-     *   ]
-     * ];
-     * output
-     * [
-     *   { label: '紅｜M號｜短袖', value: '1b-f2-s1' },
-     *   { label: '紅｜M號｜長袖', value: '1b-f2-s2' },
-     *   { label: '紅｜L號｜短袖', value: '1b-q5-s1' },
-     *   { label: '紅｜L號｜長袖', value: '1b-q5-s2' },
-     *   { label: '黑｜M號｜短袖', value: 'ca-f2-s1' },
-     *   { label: '黑｜M號｜長袖', value: 'ca-f2-s2' },
-     *   { label: '黑｜L號｜短袖', value: 'ca-q5-s1' },
-     *   { label: '黑｜L號｜長袖', value: 'ca-q5-s2' }
-     * ]     *
-     */
-    /**
-     * 產生排列組合（容忍空陣列，將非空單一陣列視為結果）
-     * @param {Array<Array<{label: string, value: string}>>} arrays
-     * @param {string} labelSeparator
-     * @param {string} valueSeparator
-     * @returns {Array<{label: string, value: string}>}
-     */
-    (0, _defineProperty2.default)(this, "generateVariants", (arrays, labelSeparator = "｜", valueSeparator = "-") => {
-      // 過濾掉空陣列
-      const nonEmptyArrays = arrays.filter(arr => arr.length > 0);
-      if (nonEmptyArrays.length === 0) return [];
-      if (nonEmptyArrays.length === 1) {
-        // 若只有一個非空陣列，回傳它（每項轉為 {label, value} 格式）
-        return nonEmptyArrays[0].map(item => ({
-          label: item.label,
-          value: item.value
-        }));
-      }
-      const combinations = _lodash.default.reduce(nonEmptyArrays, (acc, curr) => _lodash.default.flatMap(acc, a => curr.map(b => [...a, b])), [[]]);
-      return combinations.map(comb => ({
-        label: comb.map(item => item.label).join(labelSeparator),
-        value: comb.map(item => item.value).join(valueSeparator)
-      }));
-    });
-    /**
-     * 對物件陣列中的 key 進行重新命名
-     * @param {Array<Object>} arr - 原始資料陣列
-     * @param  {...[string, string]} keyMappings - key 對應對照，例如 ['label', 'labelOfVariant']
-     * @returns {Array<Object>}
-     *
-     * const originalVariants = [
-     *   { label: '紅｜M號', value: '1b-f2' },
-     *   { label: '紅｜L號', value: '1b-q5' }
-     * ];
-     *
-     * renameKeysInArray(
-     *   originalVariants,
-     *   ['label', 'labelOfVariant'],
-     *   ['value', 'valueOfVariant']
-     * );
-     *
-     * outputs:
-     *     [
-     *       { labelOfVariant: '紅｜M號', valueOfVariant: '1b-f2' },
-     *       { labelOfVariant: '紅｜L號', valueOfVariant: '1b-q5' }
-     *     ]
-     *
-     */
-    (0, _defineProperty2.default)(this, "renameKeysInArray", (arr, ...keyMappings) => {
-      const mapping = Object.fromEntries(keyMappings);
-      return arr.map(item => _lodash.default.mapKeys(item, (value, key) => mapping[key] || key));
-    });
-    /**
-     * 將 array2 的對應項目合併到 array1 中（支援巢狀 idKey 路徑）
-     * @param {Array<Object>} array1
-     * @param {Array<Object>} array2
-     * @param {string} idKey - 用來比對的 key（可為巢狀路徑，例如 'meta.id'）
-     * @returns {Array<Object>} - 合併後的 array1
-     *
-     * const array1 = [
-     *   { meta: { id: 'a1' }, name: 'Red' },
-     *   { meta: { id: 'b2' }, name: 'Black' }
-     * ];
-     *
-     * const array2 = [
-     *   { meta: { id: 'a1' }, price: 200 },
-     *   { meta: { id: 'b2' }, name: 'Black Special' }
-     * ];
-     *
-     * const result = mergeById(array1, array2, 'meta.id');
-     * console.log(result);
-     */
-    (0, _defineProperty2.default)(this, "getArrayOfMergeBySpecificId", (array1, array2, idKey = "id") => {
-      if (!Array.isArray(array2)) return array1;
-      const map2 = _lodash.default.keyBy(array2, item => _lodash.default.get(item, idKey));
-      return array1.map(item => {
-        const id = _lodash.default.get(item, idKey);
-        const match = map2[id];
-        return match ? _lodash.default.merge({}, item, match) : item;
-      });
-    });
-    /**
-     * 將百分比數值轉換為小數形式。
-     *
-     * @example
-     * toPercentageDecimal(100);     // 1
-     * toPercentageDecimal(97);      // 0.97
-     * toPercentageDecimal('97');    // 0.97
-     * toPercentageDecimal('97%');   // 0.97
-     * toPercentageDecimal('10 %');  // 0.1
-     * toPercentageDecimal('abc');   // 1  （非數字字串時，回傳 1）
-     *
-     * @param {number|string} num - 百分比值，可包含 "%" 符號或字串格式。
-     * @returns {number} - 轉換後的小數值，若轉換失敗則回傳 1。
-     */
-    (0, _defineProperty2.default)(this, "toPercentageDecimal", num => {
-      if (_lodash.default.isNil(num)) return 1;
-
-      // 若輸入為字串，先移除 "%" 符號與多餘空白
-      if (_lodash.default.isString(num)) {
-        num = num.replace(/%/g, "").trim();
-      }
-
-      // 轉換為數字
-      const parsed = _lodash.default.toNumber(num);
-
-      // 若不是有限數字，回傳預設值 1
-      if (!_lodash.default.isFinite(parsed)) return 1;
-
-      // 四捨五入到小數點第 10 位
-      return _lodash.default.round(parsed / 100, 10);
-    });
-    /**
-     *     無條件進位的公式
-     *     multiplyCeil(1.24, 3);        // => 4
-     *     multiplyCeil(1.24, 3, 1);     // => 3.8
-     *     multiplyCeil(1.24, 3, 2);     // => 3.72
-     */
-    (0, _defineProperty2.default)(this, "getNumberOfMultiplyCeil", (a, b, precision = 0) => {
-      const factor = Math.pow(10, precision);
-      return Math.ceil(a * b * factor) / factor;
-    });
-    /**
-     * 根據課程資訊生成 Google Calendar 的行事曆新增連結。
-     * 若部分參數為空值，則不加入連結中。
-     *
-     * @param {object} event - 行程物件。
-     * @param {string} event.title - 行程主題 (e.g., '吉他課')。
-     * @param {string} event.startDate - 開始日期 (e.g., '2025/11/10')。
-     * @param {string} event.startTime - 開始時間 (e.g., '14:00')。
-     * @param {string} event.endDate - 結束日期 (e.g., '2025/11/10')。
-     * @param {string} event.endTime - 結束時間 (e.g., '16:00')。
-     * @param {string} [event.location] - 地點/地址。
-     * @param {string} [event.details] - 描述/備註。
-     * @returns {string} Google Calendar 的新增連結。
-     */
-    (0, _defineProperty2.default)(this, "generateGoogleCalendarLink", ({
-      title,
-      startDate,
-      startTime,
-      endDate,
-      endTime,
-      location,
-      details
-    }) => {
-      const startDateTime = (0, _momentTimezone.default)(`${startDate} ${startTime}`, "YYYY/MM/DD HH:mm").format("YYYYMMDDTHHmmss");
-      const endDateTime = (0, _momentTimezone.default)(`${endDate} ${endTime}`, "YYYY/MM/DD HH:mm").format("YYYYMMDDTHHmmss");
-      const params = new URLSearchParams();
-      if (title) params.append("text", title);
-      if (startDateTime && endDateTime) params.append("dates", `${startDateTime}/${endDateTime}`);
-      if (details) params.append("details", details);
-      if (location) params.append("location", location);
-      params.append("ctz", "Asia/Taipei");
-      params.append("trp", "true");
-      return `https://calendar.google.com/calendar/r/eventedit?${params.toString()}`;
-    });
-    /**
-     * 根據課程資訊生成 TimeTree 的行事曆新增連結。
-     * 若部分參數為空值，則不加入連結中。
-     *
-     * @param {object} event - 行程物件。
-     * @param {string} event.title - 行程主題。
-     * @param {string} event.startDate - 開始日期 (YYYY/MM/DD)。
-     * @param {string} event.startTime - 開始時間 (HH:MM)。
-     * @param {string} event.endDate - 結束日期 (YYYY/MM/DD)。
-     * @param {string} event.endTime - 結束時間 (HH:MM)。
-     * @param {string} [event.location] - 地點/地址。
-     * @param {string} [event.memo] - 描述/備註 (TimeTree 使用 'memo')。
-     * @returns {string} TimeTree 行事曆新增連結。
-     */
-    (0, _defineProperty2.default)(this, "generateTimeTreeLink", ({
-      title,
-      startDate,
-      startTime,
-      endDate,
-      endTime,
-      location,
-      memo
-    }) => {
-      const params = new URLSearchParams();
-      if (title) params.append("title", title);
-      if (startDate) params.append("start_date", startDate.replace(/\//g, "-"));
-      if (startTime) params.append("start_time", startTime);
-      if (endDate) params.append("end_date", endDate.replace(/\//g, "-"));
-      if (endTime) params.append("end_time", endTime);
-      if (location) params.append("location", location);
-      if (memo) params.append("memo", memo);
-      return `https://timetreeapp.com/plans/new?${params.toString()}`;
-    });
-    /**
-     * 根據課程資訊生成 iCalendar (.ics) 檔案內容。
-     * 若部分欄位為空值，則不寫入該欄位。
-     *
-     * @param {object} event - 行程物件。
-     * @param {string} event.title - 行程主題。
-     * @param {string} event.startDate - 開始日期 (YYYY/MM/DD)。
-     * @param {string} event.startTime - 開始時間 (HH:MM)。
-     * @param {string} event.endDate - 結束日期 (YYYY/MM/DD)。
-     * @param {string} event.endTime - 結束時間 (HH:MM)。
-     * @param {string} [event.location] - 地點/地址。
-     * @param {string} [event.details] - 描述/備註。
-     * @returns {string} 遵循 iCalendar 規範的字串內容。
-     */
-    (0, _defineProperty2.default)(this, "generateIcsContent", ({
-      title,
-      startDate,
-      startTime,
-      endDate,
-      endTime,
-      location,
-      details
-    }) => {
-      const startDateTime = _momentTimezone.default.tz(`${startDate} ${startTime}`, "YYYY/MM/DD HH:mm", "Asia/Taipei").format("YYYYMMDDTHHmmss");
-      const endDateTime = _momentTimezone.default.tz(`${endDate} ${endTime}`, "YYYY/MM/DD HH:mm", "Asia/Taipei").format("YYYYMMDDTHHmmss");
-      const stamp = (0, _momentTimezone.default)().utc().format("YYYYMMDDTHHmmss") + "Z";
-      const uid = Date.now().toString(36) + Math.random().toString(36).substring(2, 5) + "@gemini-app.com";
-      const escapeIcs = text => text.replace(/\\/g, "\\\\").replace(/,/g, "\\,").replace(/;/g, "\\;").replace(/\n/g, "\\n");
-      const lines = ["BEGIN:VCALENDAR", "VERSION:2.0", "PRODID:-//Gemini AI//NONSGML v1.0//EN", "BEGIN:VEVENT", `UID:${uid}`, `DTSTAMP:${stamp}`];
-      if (startDateTime) lines.push(`DTSTART;TZID=Asia/Taipei:${startDateTime}`);
-      if (endDateTime) lines.push(`DTEND;TZID=Asia/Taipei:${endDateTime}`);
-      if (title) lines.push(`SUMMARY:${escapeIcs(title)}`);
-      if (location) lines.push(`LOCATION:${escapeIcs(location)}`);
-      if (details) lines.push(`DESCRIPTION:${escapeIcs(details)}`);
-      lines.push("END:VEVENT", "END:VCALENDAR");
-      return lines.join("\r\n");
-    });
-    /**
-     * 根據行程物件，生成所有主要的行事曆新增連結 (Google, TimeTree, iCalendar/ICS)。
-     * @param {object} event - 行程物件。
-     * @param {string} event.title - 行程主題。
-     * @param {string} event.startDate - 開始日期 (YYYY/MM/DD)。
-     * @param {string} event.startTime - 開始時間 (HH:MM)。
-     * @param {string} event.endDate - 結束日期 (YYYY/MM/DD)。
-     * @param {string} event.endTime - 結束時間 (HH:MM)。
-     * @param {string} event.location - 地點/地址。
-     * @param {string} event.details - 描述/備註。
-     * @returns {{google: string, timeTree: string, ics: string}} 包含所有連結的物件。
-     */
-    (0, _defineProperty2.default)(this, "generateAllCalendarLinks", event => {
-      // 1. Google Calendar Link
-      const googleLink = this.generateGoogleCalendarLink(event);
-
-      // 2. TimeTree Link
-      // TimeTree 使用 'memo' 參數，因此將 event.details 映射到 memo
-      const timeTreeEvent = {
-        ...event,
-        memo: event.details
-      };
-      const timeTreeLink = this.generateTimeTreeLink(timeTreeEvent);
-
-      // 3. iCalendar (ICS) Link (Data URI 格式，用於 iOS/Outlook/下載)
-      const icsContent = this.generateIcsContent(event);
-      const icsLink = `data:text/calendar;charset=utf8,${encodeURIComponent(icsContent)}`;
-      return {
-        google: googleLink,
-        timeTree: timeTreeLink,
-        ics: icsLink // iCalendar 連結
-      };
-    });
-    /**
-     * @param {Array<Object>} current - 要更新的目標陣列
-     * @param {Array<Object>} reference - 用來替換屬性的參照陣列
-     * @returns {Array<Object>} - 更新後的陣列
-     *
-     * const current = [{ value: 1, label: 'one' }, { value: 2, label: 'two' }];
-     * const reference = [{ value: 1, label: 'ㄧ', type: 'a' }, { value: 2, label: '二', type: 'b' }, { value: 3, label: '三' }, { value: 3, label: '四' }];
-     * const latest = updateArrayByReference(current, reference);
-     * console.log(latest);
-     *  預期輸出:
-     *  [
-     *    { value: 1, label: 'ㄧ', type: 'a' },
-     *    { value: 2, label: '二', type: 'b' }
-     *  ]
-     */
-    (0, _defineProperty2.default)(this, "getArrayOfMappingRef", (current, reference) => {
-      // 使用 _.map 迭代 current 陣列，為每個物件建立一個新物件
-      return _lodash.default.map(current, currentObj => {
-        // 使用 _.find 在 reference 陣列中尋找與 currentObj.value 相同的物件
-        const referenceObj = _lodash.default.find(reference, {
-          value: currentObj.value
-        });
-        // 如果找到對應的參考物件，則使用 _.merge 來合併它們
-        // _.merge 會將 referenceObj 的屬性覆蓋到 currentObj 上
-        // 否則，返回原始的 currentObj
-        return referenceObj ? _lodash.default.merge({}, currentObj, referenceObj) : currentObj;
-      });
-    });
-    /**
-     * 檢查多個鍵 (authorId 和 teamId)
-     * const result2 = areAllValuesTheSameOnKeys(items, 'authorId', 'teamId');
-     * console.log(`檢查 authorId 和 teamId: ${result2}`); // 輸出: true (A, T1 都相同)
-     */
-    (0, _defineProperty2.default)(this, "areAllValuesTheSameOnKeys", (array, ...keys) => {
-      // 處理邊界情況：陣列為空、只有一個元素，或沒有指定任何鍵時，直接返回 true
-      if (!array || array.length <= 1 || keys.length === 0) {
-        return true;
-      }
-
-      // 依序檢查每個傳入的 keyName
-      for (const keyName of keys) {
-        // 確保第一個元素有所需的鍵，避免不必要的檢查
-        // 使用 ES10 可選鏈 (Optional Chaining)
-        const firstValue = array[0]?.[keyName];
-
-        // 使用 _.every 檢查陣列中所有元素，確保其值與第一個元素的值相同
-        const isCurrentKeySame = _lodash.default.every(array, item => {
-          return item[keyName] === firstValue;
-        });
-
-        // 只要發現有一個鍵的值不相同，立即返回 false
-        if (!isCurrentKeySame) {
-          return false;
-        }
-      }
-
-      // 如果所有鍵都通過了檢查，則返回 true
-      return true;
-    });
-    this.init();
-    this.env = "dev";
-  }
-  performActionWithoutTimingIssue(task = () => true, wait = 10) {
-    this.syncDelay(wait).then(() => task());
-  }
-
-  /**
-   * 執行為了避免沒意義的任務重複執行, 像是search 輸入關鍵字後, 不應該每次onchange就呼叫一次建議列表, 應該等到打完後500ms後在去 執行搜尋任務
-   * */
-  executeTimeoutTask(functionOfAsyncTask, ms = 1000, id = this.getRandomHash(), ...params) {
-    const self = this;
-    const idOfCurrentTimeoutTask = this.mapOfIdNTimeoutId[id];
-    if (idOfCurrentTimeoutTask) clearTimeout(idOfCurrentTimeoutTask);
-    const idOfTimeoutTask = setTimeout(async (...param) => {
-      await functionOfAsyncTask();
-      delete self.mapOfIdNTimeoutId[id];
-    }, ms, ...params);
-    self.mapOfIdNTimeoutId[id] = idOfTimeoutTask;
-  }
-  printLogMessage(message, error = false, ...infos) {
-    if (!this.isProductionEnvironment()) {
-      if (error) {
-        this.appendError(message, ...infos);
-      } else {
-        this.appendInfo(message, ...infos);
-      }
-    }
-  }
-  init() {
-    // this.enrichZhTw();
-  }
-  setEnvironment(env) {
-    this.env = env;
-  }
-  appendInfo(...logs) {
-    if (this.isProductionEnvironment()) return;
-    console.log(...logs);
-  }
-  appendError(...logs) {
-    if (this.isProductionEnvironment()) return;
-    console.error(...logs);
-  }
-  async syncDelay(delayInms = 2000) {
-    return new Promise(resolve => {
-      setTimeout(() => {
-        resolve(delayInms);
-      }, delayInms);
-    });
-  }
-
-  /**
-   * sample:
-   *
-   *  string = `@desktop: ~"only screen and (min-width: 600px) and (max-width: 1680px)";`;
-   *  rule = '@[desktop|mobile|desktop]';
-   *  return true | false
-   *
-   */
-  startWithRegex(string = "", rule = ".") {
-    let pattern = new RegExp(`^${rule}`, "i");
-    return pattern.test(string);
-  }
-  /**
-   * 把敘述句和條件子句累加在一起，讓其變成一個合理的functional呼叫
-   * condition2(condition1(target)) =>  為了應付 collection(path).where('age','>',11).orderBy('age');
-   * */
-  accumulate(target, conditions) {
-    let beginning = target;
-    for (const condition of conditions) {
-      if (condition !== undefined && _lodash.default.isFunction(condition)) {
-        beginning = condition(beginning);
-      }
-    }
-    return beginning;
-  }
-  isOrEquals(target, ...several) {
-    for (const each of several) {
-      if (_lodash.default.isEqual(target, each)) return true;
-    }
-    return false;
-  }
-  isAndEquals(...predicates) {
-    for (const predicate of predicates) {
-      if (!predicate()) {
-        return false;
-      }
-    }
-    return true;
-  }
-
-  /** 取得reg match 第一個項目, 不然好煩呀 */
-  getStringOfHeadMatch(string, regex, flag = "g") {
-    const result = string.match(new RegExp(regex, flag));
-    return this.isUndefinedNullEmpty(result) ? undefined : result[0];
-  }
-  or(...booleans) {
-    for (const boo of booleans) {
-      if (_lodash.default.isBoolean(boo) && boo) return true;
-    }
-    return false;
-  }
-  and(...booleans) {
-    for (const boo of booleans) {
-      if (!!!boo) return false;
-    }
-    return true;
-  }
-
-  /**
-   *
-   * const array = [1,2,3,4,5,6,7,8];
-   *  nth(array, -9)
-   *  // => 8
-   * */
-  nth(array, index = -1) {
-    return _lodash.default.nth(array, index % _lodash.default.size(array));
-  }
-
-  /** 選一個exist的candidate回傳, 像是firebase 可以 idToken 又可以 oauthIdToken*/
-  getExistOne(...candidates) {
-    for (const candidate of candidates) {
-      if (candidate) return candidate;
-    }
-  }
-
-  /** '###string' =>  'string' */
-  getStringOfDropHeadSign(string, sign) {
-    return _lodash.default.dropWhile(Array.from(string), each => _lodash.default.isEqual(each, sign)).join("");
-  }
-  isAndWith(self, predicate, ...several) {
-    for (const each of several) {
-      if (!predicate(self, each)) return false;
-    }
-    return true;
-  }
-  async syncDelayRandom(min = 3000, max = 5000) {
-    const random = this.getRandomValue(min, max);
-    await this.syncDelay(random);
-    return random;
-  }
-
-  /** 如果是array,用 indexOf檢查each
-   *  如果是object,看有沒有這個key
-   *  如果是string, 就檢查有沒有包含
-   *  precisely 就是用findIndex,去比較value
-   *
-   *  */
-  has(collection, item, precisely = false) {
-    if (_lodash.default.isArray(collection)) {
-      if (precisely) return _lodash.default.findIndex(collection, each => _lodash.default.isEqual(item, each)) > -1;else return _lodash.default.indexOf(collection, item) > -1;
-    }
-    if (_lodash.default.isObject(item)) {
-      return collection[item];
-    }
-    if (_lodash.default.isString(collection)) {
-      return collection.indexOf(item) > -1;
-    }
-    return false;
-  }
-
-  /** 就是比較_.isEqual(isEqual的註解很重要), 不是用address去判斷 */
-  containsBy(array, item) {
-    return _lodash.default.findIndex(array, each => _lodash.default.isEqual(each, item)) >= 0;
-  }
-
-  /** (Parentheses) */
-  getStringOfInsideParentheses(string, rule = `.`) {
-    return this.getStringOfRule(string, rule, "(", ")");
-  }
-
-  /** [Brackets] */
-  getStringOfInsideBrackets(string, rule = `.`) {
-    return this.getStringOfRule(string, rule, "[", "]");
-  }
-
-  /** {Braces} */
-  getStringOfInsideBraces(string, rule = `.`) {
-    return this.getStringOfRule(string, rule, "{", "}");
-  }
-
-  /** rules 只抓文字 [\\w] |*/
-  getStringOfRule(string, rule = `.`, left = "{", right = "}") {
-    return this.getStringOfHeadMatch(string, `(?<=\\${left})${rule}+?(?=\\${right})`);
-  }
-  getRandomHash(length = 20) {
-    const randomBytes = _cryptoJs.default.lib.WordArray.random(length);
-    const base64String = _cryptoJs.default.enc.Base64.stringify(randomBytes);
-    // 根據需要調整格式
-    return base64String.substring(0, length);
-  }
-  getRandomHashV2(length) {
-    const characters = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789";
-    let result = "";
-    for (let i = 0; i < length; i++) {
-      const randomIndex = Math.floor(Math.random() * characters.length);
-      result += characters.charAt(randomIndex);
-    }
-    return result;
-  }
-
-  /** alwaysTheSame 就是產出的encrypt value會固定(適合用在欄位的key), 不然會產生隨機偏移量, 但皆不影響解譯 */
-  getEncryptString(texts, key = _configerer.configerer.ENCRYPT_KEY, alwaysTheSame = false) {
-    const maxLengthOfKey = 22;
-    if (key.length > maxLengthOfKey) throw new _exceptioner.default(8010, _lodash.default.size(key));
-    /** 帶入偏移量, keyOfkeyOfCrypto 需要是長度為22的字串, 太獵奇了*/
-    const ivOfCrypto = _cryptoJs.default.enc.Base64.parse("thisIsIVWeNeedToGenerateTheSameValue");
-    const keyOfCrypto = alwaysTheSame ? _cryptoJs.default.enc.Base64.parse(`${key}${_lodash.default.range(0, maxLengthOfKey - key.length).join("")}`) : key;
-    return _cryptoJs.default.AES.encrypt(texts, keyOfCrypto, {
-      iv: ivOfCrypto
-    }).toString();
-  }
-
-  /** alwaysTheSame 就是產出的encrypt value會固定(適合用在欄位的key), 不然會產生隨機偏移量, 但皆不影響解譯 */
-  getEncryptStringV2(texts, key = _configerer.configerer.ENCRYPT_KEY, alwaysTheSame = false) {
-    const maxLengthOfKey = 22;
-    if (key.length > maxLengthOfKey) throw new _exceptioner.default(8010, _lodash.default.size(key));
-    /** 帶入偏移量, keyOfkeyOfCrypto 需要是長度為22的字串, 太獵奇了*/
-    const ivOfCrypto = _cryptoJs.default.enc.Base64.parse("thisIsIVWeNeedToGenerateTheSameValue");
-    const keyOfCrypto = alwaysTheSame ? _cryptoJs.default.enc.Base64.parse(`${key}${_lodash.default.range(0, maxLengthOfKey - key.length).join("")}`) : key;
-    return _cryptoJs.default.AES.encrypt(JSON.stringify({
-      content: texts
-    }), keyOfCrypto, {
-      iv: ivOfCrypto
-    }).toString();
-  }
-  getDecryptString(ciphertext, key = _configerer.configerer.ENCRYPT_KEY) {
-    const maxLengthOfKey = 22;
-    if (key.length > maxLengthOfKey) throw new _exceptioner.default(8010, _lodash.default.size(key));
-    const ivOfCrypto = _cryptoJs.default.enc.Base64.parse("thisIsIVWeNeedToGenerateTheSameValue");
-    try {
-      const value = _cryptoJs.default.AES.decrypt(ciphertext, key, {
-        iv: ivOfCrypto
-      }).toString(_cryptoJs.default.enc.Utf8);
-      if (!_lodash.default.isEmpty(value.trim())) return value;
-    } catch (e) {
-      /** 把問題給吃掉了, 也不能紀錄, 因為用了appendError*/
-    }
-    return _cryptoJs.default.AES.decrypt(ciphertext, _cryptoJs.default.enc.Base64.parse(`${key}${_lodash.default.range(0, maxLengthOfKey - key.length).join("")}`), {
-      iv: ivOfCrypto
-    }).toString(_cryptoJs.default.enc.Utf8);
-  }
-  getDecryptStringV2(ciphertext, key = _configerer.configerer.ENCRYPT_KEY) {
-    const maxLengthOfKey = 22;
-    if (key.length > maxLengthOfKey) throw new _exceptioner.default(8010, _lodash.default.size(key));
-    const ivOfCrypto = _cryptoJs.default.enc.Base64.parse("thisIsIVWeNeedToGenerateTheSameValue");
-    try {
-      const stringOfObj = _cryptoJs.default.AES.decrypt(ciphertext, key, {
-        iv: ivOfCrypto
-      }).toString(_cryptoJs.default.enc.Utf8);
-      if (!_lodash.default.isEmpty(stringOfObj.trim())) {
-        const obj = JSON.parse(stringOfObj);
-        return obj.content;
-      }
-    } catch (e) {
-      /** 把問題給吃掉了, 也不能紀錄, 因為用了appendError*/
-    }
-    const stringOfObj = _cryptoJs.default.AES.decrypt(ciphertext, _cryptoJs.default.enc.Base64.parse(`${key}${_lodash.default.range(0, maxLengthOfKey - key.length).join("")}`), {
-      iv: ivOfCrypto
-    }).toString(_cryptoJs.default.enc.Utf8);
-    const obj = JSON.parse(stringOfObj);
-    return obj.content;
-  }
-  getFirebaseFormattedString(texts) {
-    return _lodash.default.replace(texts, /[\.\#\$\[\]]/g, "-").trim();
-  }
-  formalizeNamesToArray(singerString) {
-    let normalize = singerString;
-    /** avoid this situation, 演唱：陳勢安、畢書盡 (Bii)   編曲：Jerry C */
-    normalize = normalize.split(_configerer.configerer.SEPARATE_TONE_SINGER)[0].trim();
-    normalize = _lodash.default.replace(normalize, /[,\/#!$%\^&\*;:{}=_`、~()（）]/g, "_").trim();
-    /** avoid this situation, 陳勢安_畢書盡__Bii_ */
-    normalize = this.getFirebaseFormattedString(normalize);
-    normalize = _lodash.default.replace(normalize, /\_\_+/g, "_").trim();
-    while (_lodash.default.endsWith(normalize, "_")) {
-      /** avoid this situation, 陳勢安_畢書盡_Bii_ */
-      normalize = normalize.slice(0, -1).trim();
-    }
-    const words = normalize.split("_");
-    /** avoid this situation, ["畢書盡 ","Bii","陳勢安 "] */
-    return _lodash.default.map(words, word => _lodash.default.trim(word));
-  }
-  getShuffledArrayWithLimitCountHighPerformance(arr, n) {
-    let result = new Array(n),
-      len = arr.length,
-      taken = new Array(len);
-    if (n > len) n = len; // Handle n > arr.length case gracefully
-
-    while (n--) {
-      let x = Math.floor(Math.random() * len);
-      result[n] = arr[x in taken ? taken[x] : x];
-      taken[x] = --len in taken ? taken[len] : len;
-    }
-    return result;
-  }
-  getFileNameFromPath(path, extension = false) {
-    const segments = path.split("/");
-    const target = segments.pop();
-    return extension ? target : target.split(".").shift();
-  }
-
-  /** http://wnj.cdji/david.mp3 => david.mp3 */
-  getFileNameExtensionFromPath(path) {
-    const name = path.split("/").pop();
-    return name;
-  }
-
-  /** getPathOfReplaceLastDir('folder1/folder2/folder3', 'folder7') => 'folder1/folder2/folder7' */
-  getPathOfReplaceLastDir(path, name) {
-    const split = path.split("/");
-    split.pop();
-    split.push(name);
-    return split.join("/");
-  }
-
-  /** http://wnj.cdji/david.mp3 => mp3 */
-  getExtensionFromPath(path) {
-    const name = path.split("/").pop();
-    const segments = name.split(".");
-    return _lodash.default.size(segments) > 1 ? segments.pop() : "";
-  }
-
-  /** ../folderName/fileName.xxx  => ./folderName */
-  getFolderPathOfSpecificPath(path) {
-    const split = path.split("/");
-    split.pop();
-    return split.join("/");
-  }
-
-  /**
-   * 取得folderName
-   * console.log(utiller.getFolderNameOfFilePath(`das/asdiasjiosd/jif/d.js`)); //ans:'jif'
-   * */
-  getFolderNameOfFilePath(path) {
-    if (this.isValidFilePath(path)) {
-      const splits = path.split("/");
-      return _lodash.default.nth(splits, -2);
-    } else {
-      throw new _exceptioner.default(9999, `64255615 path is not valid '${path}'`);
-    }
-  }
-
-  /** absolute=> /acc/bbv/{target}/index.js 檢查有沒有在他下面 */
-  isUnderTargetPath(absolute, target) {
-    const segments = absolute.split("/");
-    return this.has(segments, target);
-  }
-
-  /** 取得檔案的目錄, path => c://folderName/fileName.js to c://folderName */
-  getFileDirPath(path, slash = true) {
-    return _lodash.default.join(_lodash.default.initial(_lodash.default.split(path, "/")), "/") + (slash ? "/" : "");
-  }
-
-  /** path ==> /asd/cc/dfj/jei3.mp3 => */
-  isPathEqualsFileType(path, type) {
-    const extension = path.split(".").pop();
-    return _lodash.default.isEqual(extension, type);
-  }
-
-  /** 是一個/a/b/c.js 的檔案路徑 */
-  isValidFilePath(path) {
-    const extension = this.getExtensionFromPath(path);
-    return _lodash.default.size(extension) > 0;
-  }
-
-  /** 拿前面n個items */
-  getArrayOfSize(array, n = 1) {
-    return _lodash.default.take(array, n);
-  }
-  getShuffledArrayWithLimitCount(arr, n) {
-    return this.getShuffledArrayWithLimitCountHighPerformance(arr, n); // 使用已優化的版本
-  }
-
-  /** ignore 就是黑名單的意思 */
-  getRandomItemOfArray(array, ...ignores) {
-    if (!_lodash.default.isArray(array)) throw new _exceptioner.default(9999, `why are you so stupid, typeof array should be array, not ==> ${array} `);
-    const filter = _lodash.default.without(array, ...ignores);
-    const target = _lodash.default.size(filter) > 0 ? filter : array;
-    const item = this.getShuffledArrayWithLimitCount(target, 1);
-    return item.length > 0 ? item[0] : undefined;
-  }
-
-  /**
-   *  const aaa = {};
-   *  utiller.appendMapOfKeyArray(aaa, 'a', 11);
-   *  utiller.appendMapOfKeyArray(aaa, 'c', 13);
-   *  utiller.appendMapOfKeyArray(aaa, 'a', 23);
-   *  utiller.appendMapOfKeyArray(aaa, 'c', 'vsdd')
-   *  utiller.appendMapOfKeyArray(aaa, 'a', 'sd');
-   *  console.log(aaa);
-   *  // { a: [ 11, 23, 'sd' ], c: [ 13, 'vsdd' ] }
-   * */
-  appendMapOfKeyArray(object, key, ...value) {
-    if (this.isUndefinedNullEmpty(object[key])) {
-      object[key] = [...value];
-    } else {
-      object[key].push(...value);
-    }
-  }
-
-  /**
-     * 優化版本：針對基於唯一 Key 的合併
-     * @param {Array} major - 主要陣列
-     * @param {Array} sub - 次要陣列
-     * @param {string} key - 用於匹配的唯一鍵名 (e.g., 'id')
-     * @returns {Array} - 合併後的新陣列
-     *
-     *
-     * util.getMergedArrayBy(
-     [{id: 123, name: 'david'}, {id: 321, name: 'Joe'}],
-     [{id: 321, age: 13}, {id: 123, age: 30}],
-     'id')
-     *
-     * result:
-     [
-     { id: 123, age: 30, name: 'david' },
-     { id: 321, age: 13, name: 'Joe' }
-     ]
-     *
-     */
-  getMergedArrayBy(major = [], sub = [], key) {
-    if (!key || major.length === 0 || sub.length === 0) {
-      // 如果沒有 key 或任一陣列為空，無法優化或無需合併，回傳 major 的淺拷貝
-      return [...major];
-    }
-
-    // 1. 將 sub 陣列轉換為以 key 為鍵的 Map，時間複雜度 O(N)
-    const subMap = new Map(sub.map(item => [item[key], item]));
-
-    // 2. 遍歷 major 陣列，從 Map 中查找匹配項，時間複雜度 O(M)
-    return major.map(majorItem => {
-      const subItem = subMap.get(majorItem[key]);
-      // 合併找到的 subItem 和 majorItem，majorItem 的屬性優先
-      return {
-        ...(subItem || {}),
-        ...majorItem
-      };
-    });
-    // 整體時間複雜度約為 O(M + N)
-  }
-  getShuffledItemFromArray(arr) {
-    let shuffled = _lodash.default.shuffle(arr);
-    return shuffled[0];
-  }
-  getShuffledArray(arr) {
-    let shuffled = _lodash.default.shuffle(arr);
-    return shuffled;
-  }
-  isJson(item) {
-    item = typeof item !== "string" ? JSON.stringify(item) : item;
-    try {
-      item = JSON.parse(item);
-    } catch (e) {
-      return false;
-    }
-    if (typeof item === "object" && item !== null) {
-      return true;
-    }
-    return false;
-  }
-  getObjectValue(obj) {
-    if (_lodash.default.isObject(obj)) {
-      return Object.values(obj)[0];
-    }
-    return "";
-  }
-  getObject(key, value) {
-    const object = {};
-    object[key] = value;
-    return object;
-  }
-  getStringOfCreditCardFormatted(string = 0) {
-    const inputValue = string.replace(/\D/g, ""); // Remove all non-digit characters
-    const result = inputValue.replace(/(\d{4})(?=\d)/g, "$1-"); // Add a dash every 4 digits
-    return result.slice(0, 19);
-  }
-  getObjectKey(obj) {
-    if (_lodash.default.isObject(obj)) {
-      return Object.keys(obj)[0];
-    }
-    return "";
-  }
-  printf() {
-    this.appendInfo("i can use in web || react.js");
-  }
-  isKeywordRule(constraint) {
-    if (_lodash.default.isUndefined(constraint) || _lodash.default.isEmpty(constraint)) throw new Error("PARAMS CAN NOT BE EMPTY");
-    if (!_lodash.default.isString(constraint)) throw new Error("PARAMS SHOULD BE STRING");
-    if (constraint.length > 20) throw new Error("EXCEED 20 WORDS IS NOT ALLOWED");
-  }
-  getItsKeyByValue(object, value) {
-    return Object.keys(object).find(key => object[key] === value);
-  }
-  startWiths(string, key = []) {
-    for (const _key of key) {
-      if (_lodash.default.startsWith(string, _key)) {
-        return true;
-      }
-    }
-    return false;
-  }
-  replaceAll(string, patten, to) {
-    return _lodash.default.replace(string, new RegExp(`${patten}`, `g`), to); /** g就是 global */
-  }
-
-  /** pattern => {from:'㊟',to:'注'}, {from:'\\(土\\)',to:'(土)'}*/
-  replaceAllWithSets(string = "", ...patterns) {
-    let after = string;
-    for (const pattern of patterns) {
-      if (this.isOrEquals(undefined, pattern.from, pattern.to)) {
-        throw (0, _exceptioner.default)(9999, `from or to can't be empty`);
-      }
-      after = this.replaceAll(after, pattern.from, pattern.to);
-    }
-    return after;
-  }
-
-  /** 就是用address去找出current index(比較內文要用findIndex),然後取代之
-   * array = ['a','b','c'];
-   * current = array[1] === 'b'
-   * latest = 'd'
-   * return ['a','d','c']
-   * */
-  replaceArrayByContentIndex(array, current, latest) {
-    const index = _lodash.default.indexOf(array, current);
-    array[index] = latest;
-  }
-  deepFlat(collection, sign = "_") {
-    let result = "";
-    const stack = [[collection, ""]]; // 儲存 [項目, 目前的前綴]
-
-    while (stack.length > 0) {
-      const [current, prefix] = stack.pop();
-      if (_lodash.default.isArray(current)) {
-        // 將陣列元素反向推入堆疊以保持順序
-        for (let i = current.length - 1; i >= 0; i--) {
-          stack.push([current[i], prefix]); // 陣列元素不加前綴
-        }
-      } else if (_lodash.default.isObject(current)) {
-        // 將物件鍵值對反向推入堆疊
-        const keys = Object.keys(current);
-        for (let i = keys.length - 1; i >= 0; i--) {
-          const key = keys[i];
-          // 值推入堆疊，前綴包含當前鍵
-          stack.push([current[key], prefix + key + sign]);
-        }
-      } else {
-        // 基本型別，添加到結果字串
-        const valueString = _lodash.default.trim(String(current)); // 確保轉為字串並去除頭尾空白
-        if (valueString.length > 0) {
-          // 避免添加空字串或只有空白的字串
-          result += (result.length > 0 ? sign : "") + prefix + valueString;
-        } else if (prefix.length > 0 && result.length > 0) {
-          // 如果值為空但有前綴，且結果已非空，則添加分隔符
-          result += sign;
-        } else if (prefix.length > 0 && result.length === 0) {
-          // 如果值為空但有前綴，且結果為空，則只添加前綴（去掉末尾的 sign）
-          result += prefix.endsWith(sign) ? prefix.slice(0, -sign.length) : prefix;
-        }
-      }
-    }
-    // 最後可能需要處理結尾多餘的 sign
-    if (result.endsWith(sign)) {
-      result = result.slice(0, -sign.length);
-    }
-    return result;
-  }
-  joinEscapeChar(str) {
-    return (str + "").replace(/[\\"']/g, "\\$&").replace(/\u0000/g, "\\0");
-  }
-  getValueWithIntegerType(whatever) {
-    try {
-      const value = parseInt(whatever);
-      return isNaN(value) ? 0 : value;
-    } catch (error) {
-      return 0;
-    }
-  }
-
-  /** 如果有優先順序的值,需要檢查是否isUndefinedEmpty,這樣程式邏輯就不用一直 if else switch */
-  getValueOfPriority(...compares) {
-    for (const compare of compares) {
-      if (!this.isUndefinedNullEmpty(compare)) return compare;
-    }
-    return undefined;
-  }
-  async asyncPool(poolLimit, array, iteratorFn) {
-    const ret = [];
-    const executing = [];
-    for (const item of array) {
-      const p = Promise.resolve().then(() => {
-        return iteratorFn(item, array);
-      });
-      ret.push(p);
-      if (poolLimit <= array.length) {
-        const e = p.then(() => {
-          return executing.splice(executing.indexOf(e), 1);
-        });
-        executing.push(e);
-        if (executing.length >= poolLimit) {
-          await Promise.race(executing);
-        }
-      }
-    }
-    return Promise.all(ret);
-  }
-  getAttrValueInSequence(info, ...attrs) {
-    for (const attr of attrs) {
-      if (!_lodash.default.isEmpty(info[attr])) {
-        return info[attr];
-      }
-    }
-    return info;
-  }
-
-  // 半形轉化為全形
-  toDBC(txtstring) {
-    var tmp = "";
-    for (var i = 0; i < txtstring.length; i++) {
-      if (txtstring.charCodeAt(i) === 32) {
-        tmp = tmp + String.fromCharCode(12288);
-      }
-      if (txtstring.charCodeAt(i) < 127) {
-        tmp = tmp + String.fromCharCode(txtstring.charCodeAt(i) + 65248);
-      }
-    }
-    return tmp;
-  }
-
-  // 全形轉換為半形
-  toCDB(str) {
-    var tmp = "";
-    for (var i = 0; i < str.length; i++) {
-      if (str.charCodeAt(i) === 12288) {
-        tmp += String.fromCharCode(str.charCodeAt(i) - 12256);
-        continue;
-      }
-      if (str.charCodeAt(i) > 65280 && str.charCodeAt(i) < 65375) {
-        tmp += String.fromCharCode(str.charCodeAt(i) - 65248);
-      } else {
-        tmp += String.fromCharCode(str.charCodeAt(i));
-      }
-    }
-    return tmp;
-  }
-
-  /** 用_.findIndex(比較內文的方式) 去找出array裡所有符合條件的 */
-  findIndexes(array, predicate) {
-    const indexes = [];
-    let hasIndex = true;
-    let indexOfLatest = 0;
-    while (hasIndex) {
-      indexOfLatest = _lodash.default.findIndex(array, predicate, indexOfLatest + 1);
-      if (indexOfLatest > -1) {
-        indexes.push(indexOfLatest);
-      } else {
-        hasIndex = false;
-      }
-    }
-    return indexes;
-  }
-
-  /**
-   * 得到slice array 從指定的index
-   * console.log(utiller.getSliceArrayOfSpecificIndexes(['a','v','c','d'], 1, 2, 3));
-   * [ 'v', 'c', 'd' ]
-   * */
-  getSliceArrayOfSpecificIndexes(array, ...indexes) {
-    const items = [];
-    const size = _lodash.default.size(array);
-    for (const index of indexes) {
-      if (!_lodash.default.isNumber(index)) throw new _exceptioner.default(9999, `59941278 index should be number => ${index}, ${array}`);
-      if (index > size - 1) throw new _exceptioner.default(9999, `5994123 index=>${index} is not valid, exceed than array size=${size}, ${array}`);
-      items.push(_lodash.default.nth(array, index));
-    }
-    return items;
-  }
-
-  /** 找到關鍵字所有的index */
-  indexesOf(arr, val) {
-    const indexes = [];
-    let i = -1;
-    while ((i = arr.indexOf(val, i + 1)) !== -1) {
-      indexes.push(i);
-    }
-    return indexes;
-  }
-  /** 比較內文, 不是只比較 memory address */
-  getIndexOfContext(context, stmt) {
-    return _lodash.default.findIndex(context, per => {
-      return _lodash.default.isEqual(per.trim(), stmt);
-    });
-  }
-
-  /** 去掉文字裡討厭的換行*/
-  toOneLineString(string) {
-    return _lodash.default.join(_lodash.default.split(string, "\n"), "");
-  }
-  toSpaceLessString(string) {
-    /** 這樣寫也可以 string.split('').map((each) => each.trim()).join(''); */
-    return _lodash.default.split(string, "").map(each => _lodash.default.trim(each)).join("");
-  }
-  toNewLineLessString(string) {
-    /** 這樣寫也可以 string.split('').map((each) => each.trim()).join(''); */
-    return _lodash.default.split(string, "\n").map(each => _lodash.default.trim(each)).join("");
-  }
-  exist(obj) {
-    return !_lodash.default.isNull(obj) && !_lodash.default.isUndefined(obj);
-  }
-  isUndefinedNullEmpty(obj) {
-    const first = obj === undefined || obj === null;
-    const second = _lodash.default.isString(obj) || _lodash.default.isArray(obj) || _lodash.default.isObject(obj) ? _lodash.default.isEmpty(obj) : false;
-    return first || second;
-  }
-  isAndConditionOfUndefinedNullEmpty(...objs) {
-    for (const obj of objs) {
-      if (!this.isUndefinedNullEmpty(obj)) return false;
-    }
-    return true;
-  }
-  isOrConditionOfUndefinedNullEmpty(...objs) {
-    for (const obj of objs) {
-      if (this.isUndefinedNullEmpty(obj)) return true;
-    }
-    return false;
-  }
-
-  /** this method mutates segments */
-  getStringHandledByEachLine(string, predict = (segment, index, segments) => true, separator = "\n") {
-    const segments = string.split(separator);
-    for (const segment of segments) {
-      predict(segment, _lodash.default.indexOf(segments, segment), segments);
-    }
-    return segments.join(separator);
-  }
-  getSegmentsOfEachLine(string) {
-    return string.split("\n");
-  }
-
-  /** 讓字串結尾必須是指定的 predicate, ex: `i'm good today?,,` => `i'm good today` */
-  getNormalizedStringEndWith(string, predicate) {
-    string = this.toCDB(string);
-    predicate = this.toCDB(predicate);
-    const after = _lodash.default.join(_lodash.default.dropRightWhile(string, each => !_lodash.default.isEqual(each, predicate)), "");
-    return _lodash.default.isEmpty(after) ? string : after;
-  }
-
-  /** 讓字串開頭不可以是 predicate, ex: `,, \n\t\s i'm good today?` => `i'm good today?` */
-  getNormalizedStringNotStartWith(string, ...predicate) {
-    string = this.toCDB(string);
-    const after = _lodash.default.join(_lodash.default.dropWhile(string, each => this.has(predicate, each)), "");
-    return _lodash.default.isEmpty(after) ? string : after;
-  }
-
-  /** 讓字串開頭不可以是 predicate, ex: `,, \n\t\s i'm good today?` => `\n\t\s i'm good today` */
-  getNormalizedStringNotEndWith(string, ...predicate) {
-    string = this.toCDB(string);
-    const after = _lodash.default.join(_lodash.default.dropRightWhile(string, each => this.has(predicate, each)), "");
-    return _lodash.default.isEmpty(after) ? string : after;
-  }
-
-  /** 取得 YYYY-MM-DD */
-  getTodayTimeFormat(ts) {
-    return (0, _momentTimezone.default)(ts ? ts : this.getCurrentTimeStamp()).format("YYYY-MM-DD");
-  }
-  getCustomFormatOfDatePresent(ts, format = "YY/MM") {
-    return (0, _momentTimezone.default)(ts ? ts : this.getCurrentTimeStamp()).format(format);
-  }
-  getSimpleDateYYMMDDFormat(ts) {
-    return (0, _momentTimezone.default)(ts ? ts : this.getCurrentTimeStamp()).format("YY/MM/DD");
-  }
-  getSimpleTimeYYMMDDHHmmFormat(ts) {
-    return (0, _momentTimezone.default)(ts ? ts : this.getCurrentTimeStamp()).format("YY/MM/DD HH:mm");
-  }
-  getECPayCurrentTimeFormat(ts) {
-    return (0, _momentTimezone.default)(ts ? ts : this.getCurrentTimeStamp()).format("YYYY/MM/DD HH:mm:ss");
-  }
-  getCurrentTimeFormatV2(ts) {
-    return (0, _momentTimezone.default)(ts ? ts : this.getCurrentTimeStamp()).format("YYYY/MM/DD HH:mm:ss");
-  }
-  getCurrentTimeFormatYMDHM(ts) {
-    return (0, _momentTimezone.default)(ts ? ts : this.getCurrentTimeStamp()).format("YYYY/MM/DD HH:mm");
-  }
-  getCurrentTimeFormatYMDHMS(ts) {
-    return (0, _momentTimezone.default)(ts ? ts : this.getCurrentTimeStamp()).format("YYYY/MM/DD HH:mm:ss");
-  }
-
-  /** 取得 YYY-MM-DD-HH-mm-ss */
-  getCurrentTimeFormat(ts) {
-    return (0, _momentTimezone.default)(ts ? ts : this.getCurrentTimeStamp()).format("YYYY-MM-DD-HH-mm-ss");
-  }
-  getCurrentMillionSecTimeFormat(ts) {
-    return (0, _momentTimezone.default)(ts ? ts : undefined).format("YYYY-MM-DD-HH-mm-ss-SSS");
-  }
-  isBetweenTimeStamp(target = this.getCurrentTimeStamp(), min, max) {
-    return (0, _momentTimezone.default)(target).isBetween(min, max);
-  }
-  isBeforeTimeStamp(target = this.getCurrentTimeStamp(), time) {
-    return (0, _momentTimezone.default)(target).isBefore(time);
-  }
-  isAfterTimeStamp(target = this.getCurrentTimeStamp(), time) {
-    return (0, _momentTimezone.default)(target).isAfter(time);
-  }
-
-  /**
-   * 根據地區語系與時區輸出 yyyy/MM/dd hh:mm 時間字串
-   * @param {Date | number | string} ts - 時間戳記、日期物件或字串
-   * @param {string} location - 語系地區代碼（如 'zh-TW'、'en-US'）
-   * @param {string} timezone - 時區（預設為 'Asia/Taipei'）
-   * @param {boolean} use24Hour - 是否使用 24 小時制（預設 true）
-   * @returns {string}
-   */
-  formatTimeByLocale(ts, location = "zh-TW", timezone = "Asia/Taipei", use24Hour = true) {
-    // 設定 moment 語系
-    _momentTimezone.default.locale(location);
-
-    // 轉換時區
-    const m = (0, _momentTimezone.default)(ts).tz(timezone);
-
-    // 格式化字串
-    const formatStr = use24Hour ? "YYYY/MM/DD HH:mm" : "YYYY/MM/DD hh:mm A";
-    return m.format(formatStr);
-  }
-
-  /** 獲得 幾天後的timestamp 的概念 {months: 2,days:3} =>
-     * ts => 1643434497341
-     再利用 getCurrentTimeStamp(ts) => 2022-01-29
-     */
-  getTimeStampWithConditions(param = {
-    days: 0,
-    months: 0,
-    years: 0,
-    minutes: 0,
-    seconds: 0,
-    hours: 0
-  }, target = this.getCurrentTimeStamp()) {
-    let base = (0, _momentTimezone.default)(target);
-    for (const each in param) {
-      const number = param[each];
-      const unit = each;
-      if (number > 0) {
-        base = base.add(number, unit);
-      }
-      if (number < 0) {
-        base = base.subtract(Math.abs(number), unit);
-      }
-    }
-    return base.valueOf();
-  }
-
-  /** 把 YYYY-MM-DD HH:mm:ss 轉換成 timestamp
-   * 請注意 DD HH 之間有一個空格
-   * */
-  getTimeStampByStringFormat(string) {
-    return this.getTimeStampFromSpecificFormat(string, "YYYY/MM/DD HH:mm:ss").valueOf();
-  }
-  getTimeStampFromSpecificFormat(string, format = "YYYY/MM/DD HH:mm:ss") {
-    return (0, _momentTimezone.default)(string, format).valueOf();
-  }
-  getTimeStampFromECPayStringFormat(string) {
-    return this.getTimeStampFromSpecificFormat(string, "YYYY/MM/DD HH:mm:ss").valueOf();
-  }
-
-  /** 要記住timestamp 可以轉換成西元時間(timestamp),或是期間(duration) 把duration time-stamp 轉成 02:13.445 */
-  getTimeFormatOfDurationToMillionSecond(duration) {
-    return _momentTimezone.default.utc(duration).format("HH小時mm分鐘ss秒SSS");
-  }
-
-  /** duration是兩個timestamp相減,把duration time-stamp 轉成 02:13,moment.utc 就是不會加八小時啦幹 */
-  getTimeFormatOfDurationToSecond(duration) {
-    return _momentTimezone.default.utc(duration).format("HH小時mm分鐘ss秒");
-  }
-
-  /** duration是兩個timestamp相減,把duration time-stamp 轉成 02:13,moment.utc 就是不會加八小時啦幹 , 為什麼對多1天 超怪 */
-  getTimeFormatOfDurationToDay(duration) {
-    return _momentTimezone.default.utc(duration).format("DD天HH小時mm分鐘ss秒");
-  }
-  getChineseTimeFormat(ts) {
-    _momentTimezone.default.locale("zh-TW");
-    return (0, _momentTimezone.default)(ts).format("LLLL");
-  }
-  getMinuteFormatOfDuration(ds) {
-    return _momentTimezone.default.duration(ds).asMinutes();
-  }
-  getSecondFormatOfDuration(ds) {
-    return _momentTimezone.default.duration(ds).asSeconds();
-  }
-  getDayFormatOfDuration(ds) {
-    return _momentTimezone.default.duration(ds).asDays();
-  }
-
-  /** param可以是timeStamp,也可是date,或是string
-   * timestamp : 1231231279
-   * date :(new Date).now()
-   * string: '2021-11-21'
-   *
-   * getDurationOfMillionSec('2022-01-21' || 123123112312 || (new Date).now())) */
-  getDurationOfMillionSec(dateOrTimeStamp) {
-    const currentTimestamp = this.getCurrentTimeStamp();
-    const targetTimeStamp = (0, _momentTimezone.default)(dateOrTimeStamp).valueOf();
-    const queue = _lodash.default.sortBy([{
-      ts: currentTimestamp
-    }, {
-      ts: targetTimeStamp
-    }], each => each.ts).map(each => each.ts);
-    let after = (0, _momentTimezone.default)(queue.pop());
-    let before = (0, _momentTimezone.default)(queue.shift()); // another date
-    let duration = _momentTimezone.default.duration(after.diff(before));
-    let ms = duration.asMilliseconds();
-    return ms;
-  }
-  getCurrentTimeStamp() {
-    return (0, _momentTimezone.default)().valueOf();
-  }
-  isStringContainInLines(context, key) {
-    for (let each of _lodash.default.split(context, "\n")) {
-      if (this.has(each, key)) return true;
-    }
-    return false;
-  }
-  camel(...words) {
-    return _lodash.default.camelCase(words.join("_"));
-  }
-  upperCamel(...words) {
-    return _lodash.default.upperFirst(this.camel(...words));
-  }
-
-  /**
-   * [{key1:value1},{key2:values2}]
-   * =>
-   * {key1:value1,key2:value2}
-   *
-   * */
-  array2Obj(array) {
-    const obj = {};
-    for (const each of array) {
-      obj[`${this.getObjectKey(each)}`] = this.getObjectValue(each);
-    }
-    return obj;
-  }
-
-  /**
-   *
-   * [{name:'aaa',sign:2},{name:'aaa',sign:3},{name:'b',sign:4}] =>
-   * {aaa:[{{name:'aaa',sign:2},{name:'aaa',sign:3}}], b:[{name:'b',sign:4}]}
-   */
-  arrayToObjWith(array, predicate) {
-    const obj = {};
-    for (const item of array) {
-      const key = predicate(item);
-      const content = obj[key];
-      if (content && _lodash.default.isArray(content)) {
-        content.push(item);
-      } else {
-        obj[key] = [item];
-      }
-    }
-    return obj;
-  }
-  isEmptyString(string) {
-    return _lodash.default.isEqual(_lodash.default.trim(string), "");
-  }
-
-  /** 放在後面的priority 越大 */
-  mergeObject(...obj) {
-    return _lodash.default.merge(...obj);
-  }
-  syncSetTimeout(func, ms, callback = () => {}) {
-    (function sync(done) {
-      if (!done) {
-        setTimeout(function () {
-          func();
-          sync(true);
-        }, ms);
-        return;
-      }
-      callback();
-    })();
-  }
-
-  /**
-   * Merge multiple arrays of objects based on a specific identifier key.
-   * If objects have the same identifier, they will be merged,
-   * with properties from later arrays overwriting earlier ones.
-   *
-   * const list1 = [{ id: '123', name: 'david' }];
-   * const list2 = [{ id: '123', age: 13 }];
-   * const list3 = [{ id: '456', name: 'alice' }];
-   * console.log(mergeArrayBy('id', list1, list2, list3)); //[ { href: '123', name: 'david', age: 13 },{ href: '456', name: 'alice' } ]
-   *
-   * @param {string} identifier - The object property used to identify and merge items. Default is 'id'.
-   * @param {...Array<Object>} array - Multiple arrays containing objects to merge.
-   * @returns {Array<Object>} A new array with merged objects based on the identifier.
-   */
-  mergeArrayBy(identifier = "id", ...array) {
-    return Object.values(array.flat().reduce((acc, item) => {
-      if (item[identifier]) acc[item[identifier]] = {
-        ...(acc[item[identifier]] || {}),
-        ...item
-      };
-      return acc;
-    }, {}));
-  }
-
-  /**
-   *  rootName : /free_marker/src/exam/web
-   *  pathName : /free_marker/src/exam/web/src/base/AlertDialog.js
-   *  return: /src/base/AlertDialog.js
-   * */
-  getRelativePath(pathName, rootName) {
-    return _lodash.default.dropWhile(pathName, (each, index) => {
-      return _lodash.default.isEqual(each, rootName[index]);
-    }).join("");
-  }
-
-  /**
-     * mutated;
-     const arr = [0,1,2,3,4,5,6,7,8];
-     dropItemsByIndex(arr,1,3);
-     this.appendInfo(arr); [ 0, 4, 5, 6, 7, 8 ]
-     */
-  dropItemsByIndex(array, from, end) {
-    _lodash.default.remove(array, (value, index, array) => end >= index && index >= from);
-  }
-  isEven(n) {
-    return n % 2 === 0;
-  }
-  isOdd(n) {
-    return Math.abs(n % 2) === 1;
-  }
-  enrichZhTw() {
-    _momentTimezone.default.locale("zh-tw", {
-      months: "一月_二月_三月_四月_五月_六月_七月_八月_九月_十月_十一月_十二月".split("_"),
-      monthsShort: "1月_2月_3月_4月_5月_6月_7月_8月_9月_10月_11月_12月".split("_"),
-      weekdays: "星期日_星期一_星期二_星期三_星期四_星期五_星期六".split("_"),
-      weekdaysShort: "周日_周一_周二_周三_周四_周五_周六".split("_"),
-      weekdaysMin: "日_一_二_三_四_五_六".split("_"),
-      longDateFormat: {
-        LT: "Ah點mm分",
-        LTS: "Ah點m分s秒",
-        L: "YYYY-MM-DD",
-        LL: "YYYY年MMMD日",
-        LLL: "YYYY年MMMD日Ah點mm分",
-        LLLL: "YYYY年MMMD日ddddAh點mm分",
-        l: "YYYY-MM-DD",
-        ll: "YYYY年MMMD日",
-        lll: "YYYY年MMMD日Ah點mm分",
-        llll: "YYYY年MMMD日ddddAh點mm分"
-      },
-      meridiemParse: /凌晨|早上|上午|中午|下午|晚上/,
-      meridiemHour: function (h, meridiem) {
-        let hour = h;
-        if (hour === 12) {
-          hour = 0;
-        }
-        if (meridiem === "凌晨" || meridiem === "早上" || meridiem === "上午") {
-          return hour;
-        } else if (meridiem === "下午" || meridiem === "晚上") {
-          return hour + 12;
-        } else {
-          // '中午'
-          return hour >= 11 ? hour : hour + 12;
-        }
-      },
-      meridiem: function (hour, minute, isLower) {
-        const hm = hour * 100 + minute;
-        if (hm < 600) {
-          return "凌晨";
-        } else if (hm < 900) {
-          return "早上";
-        } else if (hm < 1130) {
-          return "上午";
-        } else if (hm < 1230) {
-          return "中午";
-        } else if (hm < 1800) {
-          return "下午";
-        } else {
-          return "晚上";
-        }
-      },
-      calendar: {
-        sameDay: function () {
-          return this.minutes() === 0 ? "[今天]Ah[點整]" : "[今天]LT";
-        },
-        nextDay: function () {
-          return this.minutes() === 0 ? "[明天]Ah[點整]" : "[明天]LT";
-        },
-        lastDay: function () {
-          return this.minutes() === 0 ? "[昨天]Ah[點整]" : "[昨天]LT";
-        },
-        nextWeek: function () {
-          let startOfWeek, prefix;
-          startOfWeek = (0, _momentTimezone.default)().startOf("week");
-          prefix = this.diff(startOfWeek, "days") >= 7 ? "[下]" : "[本]";
-          return this.minutes() === 0 ? prefix + "dddA點整" : prefix + "dddAh點mm";
-        },
-        lastWeek: function () {
-          let startOfWeek, prefix;
-          startOfWeek = (0, _momentTimezone.default)().startOf("week");
-          prefix = this.unix() < startOfWeek.unix() ? "[上]" : "[本]";
-          return this.minutes() === 0 ? prefix + "dddAh點整" : prefix + "dddAh點mm";
-        },
-        sameElse: "LL"
-      },
-      ordinalParse: /\d{1,2}(日|月|周)/,
-      ordinal: function (number, period) {
-        switch (period) {
-          case "d":
-          case "D":
-          case "DDD":
-            return number + "日";
-          case "M":
-            return number + "月";
-          case "w":
-          case "W":
-            return number + "周";
-          default:
-            return number;
-        }
-      },
-      relativeTime: {
-        future: "%s内",
-        past: "%s前",
-        s: "幾秒",
-        m: "1 分鐘",
-        mm: "%d 分鐘",
-        h: "1 小時",
-        hh: "%d 小時",
-        d: "1 天",
-        dd: "%d 天",
-        M: "1 個月",
-        MM: "%d 个月",
-        y: "1 年",
-        yy: "%d 年"
-      },
-      week: {
-        // GB/T 7408-1994《数据元和交换格式·信息交换·日期和时间表示法》与ISO 8601:1988等效
-        dow: 1,
-        // Monday is the first day of the week.
-        doy: 4 // The week that contains Jan 4th is the first week of the year.
-      }
-    });
-  }
-
-  /** react js Util */
-  getVisibleOrHidden(judgement) {
-    return {
-      visibility: judgement ? "visible" : "hidden"
-    };
-  }
-
-  /**
-   * 將百分比轉換為浮點數
-   * @param {string} percentage - 以百分比表示的字串，例如 "50%" 或 "12.5%"
-   * @returns {number} - 對應的浮點數，例如 0.5 或 0.125
-   */
-  getNumberOfPercentageToFloat(percentage) {
-    // 移除百分比符號
-    let cleanedPercentage = percentage.replace("%", "");
-    // 將字串轉換為浮點數並除以 100
-    let floatNumber = parseFloat(cleanedPercentage) / 100;
-    return floatNumber;
-  }
-  getVisibleOrNone(judgement, flex = false) {
-    return {
-      display: judgement ? flex ? "flex" : "inherit" : "none"
-    };
-  }
-  stringToInteger(string) {
-    string = _lodash.default.toUpper(string);
-    switch (string) {
-      case "A":
-        return 0;
-      case "B":
-        return 1;
-      case "C":
-        return 2;
-      case "D":
-        return 3;
-      case "E":
-        return 4;
-      case "F":
-        return 5;
-      case "G":
-        return 6;
-      case "H":
-        return 7;
-      case "I":
-        return 8;
-      case "J":
-        return 9;
-      case "K":
-        return 10;
-      case "L":
-        return 11;
-      case "M":
-        return 12;
-      case "N":
-        return 13;
-      default:
-        return 101;
-    }
-  }
-  integerToString(integer) {
-    switch (integer) {
-      case 0:
-        return "A";
-      case 1:
-        return "B";
-      case 2:
-        return "C";
-      case 3:
-        return "D";
-      case 4:
-        return "E";
-      case 5:
-        return "F";
-      case 6:
-        return "G";
-      case 7:
-        return "H";
-      case 8:
-        return "I";
-      case 9:
-        return "J";
-      case 10:
-        return "K";
-      case 11:
-        return "L";
-      case 12:
-        return "M";
-      case 13:
-        return "N";
-      default:
-        return "Z";
-    }
-  }
-
-  /**
-   * const sample = [{name: 'a'}, {name: 'b'}];
-   *
-   * rules => {to:'newKeyName', from: 'name', func: (stmt) => stmt}
-   * to指的是新的屬性名稱, from指的就是sample物件裏面要被取代的原屬性(這裡是指name),如果屬性的的value(string,number).表示each的內容就是value. func就可以把再包一層邏輯
-   *
-   * sample:
-   * const sample = [{name: 'a'}, {name: 'b'}];
-   * console.log(util.toObjectMap(sample, {to: 'newName', from: 'name',func:(p) => (p+'yaya')}));
-   * result : [ { newName: 'ayaya' }, { newName: 'byaya' } ]
-   */
-  toObjectMap(array, ...rules) {
-    const newbies = [];
-    for (const each of array) {
-      const object = {};
-      for (const rule of rules) {
-        const func = rule.func ? rule.func : stmt => stmt;
-        object[rule.to] = this.isUndefinedNullEmpty(rule.from) || !_lodash.default.isObject(each) ? func(each) : func(each[rule.from]);
-      }
-      newbies.push(object);
-    }
-    return newbies;
-  }
-
-  /**
-     * sample:
-     const array = [{aa: '1'},{ aa: '2'}, {aa: '3'}];
-     const object = {aa: '1', bb: '2', cc: '3'};
-     util.exeAll(object,(each) => each + 1)
-     util.exeAll(array,(each) => {each.aa = each.aa + 1});
-     console.log(object);  // { aa: '11', bb: '21', cc: '31' }
-     console.log(array); // [ { aa: '11' }, { aa: '21' }, { aa: '31' } ]
-     * 把collection 裏面的物件執行一下,會mutate本身*/
-  exeAll(collection, ...funcs) {
-    if (_lodash.default.isArray(collection)) {
-      for (const each of collection) {
-        for (const func of funcs) {
-          func(each);
-        }
-      }
-      /** 陣列專屬邏輯 */
-    } else if (_lodash.default.isObject(collection)) {
-      for (const each in collection) {
-        for (const func of funcs) {
-          collection[each] = func(collection[each]);
-        }
-      }
-      /** 物件專屬邏輯 */
-    } else {
-      throw new _exceptioner.default(9999, `7841212 type can't be array or object`);
-    }
-    return collection;
-  }
-  getObjectWhile(major, minor, predicate = target => true) {
-    const collection = {};
-    for (const key in major) {
-      if (predicate(major, minor, key)) {
-        collection[key] = major[key];
-      }
-    }
-    return collection;
-  }
-
-  /** 找出兩個object,相同的屬性
-     sample:
-     const obj1 = {a:1,b:4,c:3};
-     const obj2 = {b:3};
-     console.log(util.getIntersectionObject(obj1,obj2)) => { b: 4 }
-     */
-  getIntersectionObject(objOfMajor, objOfMinor) {
-    return this.getObjectWhile(objOfMajor, objOfMinor, (major, minor, key) => minor[key] !== undefined);
-  }
-
-  /** 找出兩個object,相同的屬性
-     sample:
-     const obj1 = {a:1,b:4,c:3};
-     const obj2 = {b:3};
-     console.log(util.getIntersectionObject(obj1,obj2)) => { a: 1, c: 3 }
-     */
-  getDifferenceObject(objOfMajor, objOfMinor) {
-    return this.getObjectWhile(objOfMajor, objOfMinor, (major, minor, key) => minor[key] === undefined);
-  }
-
-  /**
-     *
-     const obj1 = {b:4,c:2};
-     const obj2 = {b:4,c:3};
-     const obj3 = {a:1,b:4,c:3};
-     console.log(util.isObjectContainAndEqual(obj1,obj3)) false
-     console.log(util.isObjectContainAndEqual(obj1,obj3)) true
-     targetObject 是數量比較小那個
-     */
-  isObjectContainAndEqual(targetObject, mainObject) {
-    let equal = true;
-    for (const key in targetObject) {
-      if (mainObject[key] === undefined || mainObject[key] !== targetObject[key]) {
-        equal = false;
-        break;
-      }
-    }
-    return equal;
-  }
-
-  /** 把 /a/v/c/d => /a/v/c/ */
-  getStringOfPop(string, separator) {
-    if (!_lodash.default.isString(string)) {
-      throw new _exceptioner.default(9999, `445115,type should be string but ==> ${typeof string}`);
-    }
-    const segments = string.split(separator);
-    segments.pop();
-    return segments.join(separator);
-  }
-
-  /** 把 /a/v/c/d => /v/c/d */
-  getStringOfShift(string, separator) {
-    if (!_lodash.default.isString(string)) {
-      throw new _exceptioner.default(9999, `445116,type should be string but ==> ${typeof string}`);
-    }
-    const segments = string.split(separator);
-    segments.shift();
-    return segments.join(separator);
-  }
-
-  /**
-   * array = [{name:'david',id:'kfgijifd'},{name:'serena',id:'kdffof'}....]
-   * attrKeyOfPK = 'id'
-   * result => { kfgijifd: {name:'david',id:'kfgijifd'}, kdffof:{name:'serena',id:'kdffof'} }
-   * */
-  toObjectWithAttributeKey(array, attrKeyOfPK) {
-    const object = {};
-    for (const each of array) {
-      const pk = each[attrKeyOfPK];
-      if (this.isUndefinedNullEmpty(pk)) {
-        throw new _exceptioner.default(9999, `48157232 pk can't be empty => '${pk}'`);
-      }
-      object[pk] = each;
-    }
-    return object;
-  }
-  getObjectOfArraySpecifyAttr(array, attr) {
-    return this.toObjectWithAttributeKey(array, attr);
-  }
-
-  /**
-   * 用來檢查string是否包含字元
-   * string = '|C    G/B|'
-   * signs = ['/','$']
-   * return ==> {exist:true,sign:'/'}
-   *
-   * @param string
-   * @param signs
-   * @returns {{exists: boolean}|{sign: *, exists: boolean}}
-   */
-  getStateOfStringContainsSign(string, ...signs) {
-    for (const sign of signs) {
-      if (this.has(string, sign)) {
-        return {
-          exists: true,
-          sign
-        };
-      }
-    }
-    return {
-      exists: false
-    };
-  }
-
-  /** others returns  [{logic:true|false,message:'oops'}]
-   *  */
-  constraintOfParam(collection, type, ...others) {
-    let result = false;
-    const validOfOthersCondition = _lodash.default.isEmpty(others) ? true : this.and(...others.map(each => each.logic));
-    switch (type) {
-      case "array":
-        if (_lodash.default.isArray(collection) && validOfOthersCondition) result = true;
-        break;
-      case "object":
-        if (_lodash.default.isObject(collection) && validOfOthersCondition) result = true;
-        break;
-      case "string":
-        if (_lodash.default.isString(collection) && validOfOthersCondition) result = true;
-        break;
-      case "number":
-        if (_lodash.default.isNumber(collection) && validOfOthersCondition) result = true;
-        break;
-      case "other":
-        if (validOfOthersCondition) return true;
-    }
-    const stringOfRules = _lodash.default.isEmpty(others) ? "" : `, ${others.map(each => each.message).join(" | ")}`;
-    if (result === false) {
-      throw new _exceptioner.default(9999, `7474423 type should be ${type} but get '${typeof type}' ${stringOfRules} `);
-    }
-  }
-
-  /**
-     const array = _.range(0, 50).map((each) => `index Of each`);
-     console.log('origin: ==> ', array.length) //origin: ==>  50
-     const result = util.getSliceArrayWithMutate(array, 10);
-     console.log('after: ==> ', result.length, ' | ', array.length) //after: ==>  10  |  40
-     */
-  getSliceArrayWithMutate(array, n) {
-    const slice = _lodash.default.remove(array, (each, index) => index < n);
-    return slice;
-  }
-
-  /**
-   * const array1 = [1, 2, 3, 4, 5];
-   * const array2 = [3, 4, 5, 6, 7];
-   * Output: [1, 2]
-   * */
-  getArrayOfInteraction(one, two) {
-    return one.filter(element => !two.includes(element));
-  }
-
-  /**
-     *
-     * 把array裏面的'指定index' 移動到 '特定index'
-     *
-     const array = [0,1,2,3,4,5,6,7];
-     console.log(util.getArrayOfMoveToSpecificIndex(array,1,0));const array = [0,1,2,3,4,5,6,7];
-     console.log(util.getArrayOfMoveToSpecificIndex(array,1,0));
-     [
-     1, 0, 2, 3,
-     4, 5, 6, 7
-     ]
-     |-------如果有paginate, 有可能讓功能錯亂-------|
-     */
-  getArrayOfMoveToSpecificIndex(array, from, to) {
-    if (!Array.isArray(array)) {
-      throw new Error("First argument must be an array.");
-    }
-    const length = array.length;
-    // 驗證索引範圍
-    if (from < 0 || from >= length || to < 0 || to >= length) {
-      console.warn("Invalid 'from' or 'to' index for getArrayOfMoveToSpecificIndexOptimized.");
-      // 可以選擇拋出錯誤或返回原陣列的副本
-      // throw new RangeError("Index out of bounds");
-      return [...array]; // 返回副本
-    }
-    if (from === to) {
-      return [...array]; // 位置相同，無需移動，返回副本
-    }
-    const copy = [...array]; // 創建副本
-    const [item] = copy.splice(from, 1); // 從副本中移除元素
-    copy.splice(to, 0, item); // 將元素插入到副本的新位置
-    return copy; // 返回修改後的副本
-  }
-
-  /** 把array裏面的項目移動到指定的index
-     *
-     *  const array = ['a','b','c','d'];
-     console.log(util.getArrayOfMoveItemToSpecificIndex(array,array[1],0));
-     //[ 'b', 'a', 'c', 'd' ]
-     * */
-  getArrayOfMoveItemToSpecificIndex(array, item, indexOfDestination) {
-    const indexOfItem = _lodash.default.indexOf(array, item);
-    return this.getArrayOfMoveToSpecificIndex(array, indexOfItem, indexOfDestination);
-  }
-
-  /**
-   *  把指定的array item 放到頭尾
-   *  const array = ['a','b','c','d'];
-   *  console.log(util.getArrayOfMoveSpecificItemToAside(array,array[1]));
-   *[ 'a', 'c', 'd', 'b' ]
-   */
-  getArrayOfMoveSpecificItemToAside(array, item, toTail = true) {
-    const indexOfItem = _lodash.default.indexOf(array, item);
-    return this.getArrayOfMoveSpecificIndexToAside(array, indexOfItem, toTail);
-  }
-
-  /** 把指定的index放到頭尾
-     *  const array = ['a','b','c','d'];
-     console.log(util.getArrayOfMoveSpecificIndexToAside(array,3,false));
-     [ 'd', 'a', 'b', 'c' ]
-     **/
-  getArrayOfMoveSpecificIndexToAside(array, index, toTail = true) {
-    const indexOfLast = _lodash.default.size(array) - 1;
-    return this.getArrayOfMoveToSpecificIndex(array, index, toTail ? indexOfLast : 0);
-  }
-  getECPayCheckMacValue(data, hashKey = "5294y06JbISpM5x9", hashIV = "v77hoKGq4kWxNNIS") {
-    const clone = _lodash.default.cloneDeep(data);
-    delete clone.CheckMacValue;
-    const keys = Object.keys(clone).sort((l, r) => l > r ? 1 : -1);
-    let checkValue = "";
-    for (const key of keys) {
-      checkValue += `${key}=${clone[key]}&`;
-    }
-    checkValue = `HashKey=${hashKey}&${checkValue}HashIV=${hashIV}`; // There is already an & in the end of checkValue
-    checkValue = encodeURIComponent(checkValue).toLowerCase();
-    checkValue = checkValue.replace(/%20/g, "+").replace(/%2d/g, "-").replace(/%5f/g, "_").replace(/%2e/g, ".").replace(/%21/g, "!").replace(/%2a/g, "*").replace(/%28/g, "(").replace(/%29/g, ")").replace(/%20/g, "+");
-
-    /** checkValue = Crypto.createHash('sha256').update(checkValue).digest('hex');
-     * 之前用crypto做出來的，後來crypto-browsify多年沒有更新，所以都要用CryptoJS處理 2024/03/12
-     * */
-    return _lodash.default.toUpper(_cryptoJs.default.SHA256(checkValue).toString(_cryptoJs.default.enc.Hex));
-  }
-
-  /** 把一段html文字轉換成類似document的結構 處理後再回傳文字
-      const result = utiller.getStringOfHandleHtml(
-     '<form id="_form_aiochk" action="https://payment-stage.ecpay.com.tw/Cashier/AioCheckOut/V5" method="post"><input type="hidden" name="MerchantTradeNo" id="MerchantTradeNo" value="sO6E2IilSGYpCChDqrI2" /><input type="hidden" name="MerchantTradeDate" id="MerchantTradeDate" value="2022/07/02 05:16:32" />' +
-     '<input type="hidden" name="TotalAmount" id="TotalAmount" value="350" /><input type="hidden" name="TradeDesc" id="TradeDesc" value="綠界第三方支付(明悅科技-線上支付)" /><input type="hidden" name="ItemName" id="ItemName" value="iphone13 pro x 2 = 200 元#iphone11 x 3 = 150 元#總價 350 元##※備註: 無備註內容" /><input type="hidden" name="ReturnURL" id="ReturnURL" value="https://us-central1-davidtu-dev.cloudfunctions.net/confirmedByByECPay" /><input type="hidden" name="ClientBackURL" id="ClientBackURL" value="https://www.google.com/" /><input type="hidden" name="ExpireDate" id="ExpireDate" value="1" /><input type="hidden" name="PaymentInfoURL" id="PaymentInfoURL" value="https://us-central1-davidtu-dev.cloudfunctions.net/paymentInfoByECPay" /><input type="hidden" name="ChoosePayment" id="ChoosePayment" value="ALL" /><input type="hidden" name="PlatformID" id="PlatformID" value="" /><input type="hidden" name="MerchantID" id="MerchantID" value="2000132" /><input type="hidden" name="InvoiceMark" id="InvoiceMark" value="N" /><input type="hidden" name="IgnorePayment" id="IgnorePayment" value="BARCODE#AndroidPay#ApplePay" /><input type="hidden" name="DeviceSource" id="DeviceSource" value="" /><input type="hidden" name="EncryptType" id="EncryptType" value="1" /><input type="hidden" name="PaymentType" id="PaymentType" value="aio" />' +
-     '<input type="hidden" name="CheckMacValue" id="CheckMacValue" value="D55E9E48C6AB83C063E0E13AD1B8C2EE8FA6547A7D7FCB33860B532E97D808BC" /><script type="text/javascript">document.getElementById("_form_aiochk").submit();</script></form>'
-     ,(document) => {
-     const element = document.getElementById('CheckMacValue');
-     element.setAttribute('value', '123456');
-     })
-      */
-  getStringOfHandledHtml(htmlString, predicate = document => {
-    console.log(document);
-  }) {
-    const document = (0, _nodeHtmlParser.parse)(htmlString);
-    predicate(document);
-    return document.toString();
-  }
-
-  /** 會有物件在比較優先權，例如option = {id:1,photo:'url'} choice = {id, photo:'url'}
-   *
-   *  const selected = getSpecifyObjectBy([option.photo,choice.photo],(string) => !_.isEmpty(string))
-   * */
-  getSpecifyObjectBy(array, predicate) {
-    for (const item of array) {
-      if (predicate(item)) return item;
-    }
-  }
-
-  /**
-   * @param content = object
-   * @param rules {KEY:predicate} | 'KEY', rules如果只放字串, rule = KEY就代表這個欄位不得為isUndefinedEmpty(), 如果是物件 => {key:predicate}
-   * @param idOfError 用在每個呼叫的method, 有個stack trace的概念
-   *
-   *
-   *   console.log(utiller.validatePayloadObjectValid({a: 3, b: 4}, ['a',{b:(value) => value > 5}]));
-   *   //ATTRIBUTE:'b' is not valid of custom rule
-   *
-   *   utiller.validatePayloadObjectValid({id: 'djksaio', num: 3, items: [1, 2, 3]},
-   *                 [
-   *                     {'id': (value) => _.isString(value)},
-   *                     {'num': (v) => _.isNumber(v)},
-   *                     {items: (v) => _.isArray(v)}
-   *                  ])
-   *   // =>true
-   */
-  validatePayloadObjectValid(content, rules = [], idOfError = this.getRandomHash(10)) {
-    if (this.isUndefinedNullEmpty(content)) {
-      throw new _exceptioner.default(9999, `${idOfError} content(pay-load) is undefined || empty`);
-    }
-    for (const rule of rules) {
-      if (_lodash.default.isString(rule)) {
-        if (this.isUndefinedNullEmpty(content[rule])) {
-          throw new _exceptioner.default(9999, `${idOfError} ATTRIBUTE:'${rule}' is not Exist`);
-        }
-      } else if (_lodash.default.isObject(rule)) {
-        const key = this.getObjectKey(rule);
-        const predicate = this.getObjectValue(rule);
-        if (!predicate(content[key])) {
-          throw new _exceptioner.default(9999, `${idOfError} ATTRIBUTE:'${key}' is not valid of custom rule`);
-        }
-      }
-    }
-    return true;
-  }
-
-  /**
-     * 做個總和
-     *
-     const result = utiller.getArrayOfSummarizeBy([{name:'david',count:5},{name:'nina',count:3},{name:'david',count:3},{name:'joe',count:3},{name:'joe',count:4}]
-     ,'name','count');
-     console.log(result);
-     [
-     { name: 'david', count: 8 },
-     { name: 'nina', count: 3 },
-     { name: 'joe', count: 7 }
-     ]
-     *
-     */
-  getArrayOfSummarizeBy(array, keyOfId, keyOfSum) {
-    const obj = {};
-    for (const item of array) {
-      const key = item[keyOfId];
-      if (obj[key] !== undefined) {
-        obj[key] = obj[key] + item[keyOfSum];
-      } else {
-        obj[key] = item[keyOfSum];
-      }
-    }
-    const items = [];
-    for (const key in obj) {
-      const _obj = {};
-      _obj[keyOfId] = key;
-      _obj[keyOfSum] = obj[key];
-      items.push(_obj);
-    }
-    return items;
-  }
-  getHeadStringSplitBy(string, sign = this.getSeparatorOfUnique()) {
-    return _lodash.default.split(string, sign).shift();
-  }
-  getTailStringSplitBy(string, sign = this.getSeparatorOfUnique()) {
-    return _lodash.default.split(string, sign).pop();
-  }
-
-  /** 把array根據indexes分割成slices(array)
-   * array = [0,1,2,3,4,5,6,7]
-   * indexes = [0,3,5,7];
-   * return [... [array1(0,3) ],[array2(3,5)],[array3(5,7)] ],
-   * */
-  getSlicesByIndexes(array = [], indexes = []) {
-    const slices = [];
-    _lodash.default.each(indexes, (each, index, arrayOfIndexes) => {
-      if (_lodash.default.isEqual(index, indexes.length - 1)) return false;
-      const slice = _lodash.default.slice(array, each, indexes[index + 1]);
-      slices.push(slice);
-    });
-    return slices;
-  }
-
-  /** 用_.findIndex(比較內文的方式) 去找出array裡所有符合條件的
-   * array = [-2, -1, 65, -4, 77]
-   * predicate = (item) => item > 1;
-   * return [3,5]
-   * */
-  findIndexes(array, predicate) {
-    const indexes = [];
-    let hasIndex = true;
-    let indexOfLatest = 0;
-    while (hasIndex) {
-      indexOfLatest = _lodash.default.findIndex(array, predicate, indexOfLatest + 1);
-      if (indexOfLatest > -1) {
-        indexes.push(indexOfLatest);
-      } else {
-        hasIndex = false;
-      }
-    }
-    return indexes;
-  }
-
-  /**
-     // 使用範例
-     const birthDate = '2005-01-01';
-     console.log(isOver18(birthDate)); // 會返回 true 或 false
-     */
-  isOverSpecificAge(birthDate, target = 18) {
-    const age = (0, _momentTimezone.default)().diff((0, _momentTimezone.default)(birthDate, "YYYY-MM-DD"), "years");
-    return age >= target;
-  }
-  isValidEmail(email) {
-    // 正規表達式，用於匹配常見的電子郵件格式
-    const emailRegex = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
-    return emailRegex.test(email);
-  }
-  isValidTaiwaneseID(idNumber) {
-    // 正規表達式，用於匹配中華民國身分證號碼的格式
-    const idRegex = /^[A-Z][1-2]\d{8}$/;
-
-    // 檢查是否符合基本格式
-    if (!idRegex.test(idNumber)) {
-      return false;
-    }
-
-    // 檢查檢查碼
-    const weight = [1, 9, 8, 7, 6, 5, 4, 3, 2, 1];
-    const firstChar = idNumber.charCodeAt(0) - 65; // 將英文字母轉換為數字
-    let sum = firstChar * 10 + parseInt(idNumber.slice(1));
-    for (let i = 0; i < weight.length; i++) {
-      sum += parseInt(idNumber.charAt(i + 1)) * weight[i];
-    }
-    return sum % 10 === 0;
-  }
-  validatePersonalInfoInput(name, email, idNumber, phoneNumber, birthday, ageOfQualify = 12) {
-    // 檢查姓名
-    if (name.length < 2) {
-      return {
-        valid: false,
-        message: "姓名至少要兩個字"
-      };
-    }
-
-    // 檢查電子郵件
-    const emailRegex = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
-    if (!emailRegex.test(email)) {
-      return {
-        valid: false,
-        message: "電子郵件格式不正確"
-      };
-    }
-
-    // 檢查身分證號碼 (這裡使用簡化的檢查，實際上還需要更詳細的驗證)
-    const idRegex = /^[A-Z][1-2]\d{8}$/;
-    if (!idRegex.test(idNumber)) {
-      return {
-        valid: false,
-        message: "身分證號碼格式不正確"
-      };
-    }
-
-    // 檢查手機號碼 (這裡以台灣手機號碼為例，09開頭，共10位數字)
-    const phoneRegex = /^09\d{8}$/;
-    if (!phoneRegex.test(phoneNumber)) {
-      return {
-        valid: false,
-        message: "手機號碼格式不正確"
-      };
-    }
-
-    // 檢查生日和年齡
-    if (this.isUndefinedNullEmpty(birthday)) return {
-      valid: false,
-      message: `出生日期格式不正確`
-    };
-    const now = (0, _momentTimezone.default)();
-    const age = now.diff(birthday, "years");
-    if (age < ageOfQualify) {
-      return {
-        valid: false,
-        message: `年齡不得小於 ${ageOfQualify} 歲`
-      };
-    }
-
-    // 所有項目都通過檢查
-    return {
-      valid: true,
-      message: "格式檢查通過"
-    };
-  }
-
-  /**
-   * // 測試範例
-   *     const startTimestamp = 1683004800000; // 2023-05-01
-   *     const endTimestamp = 1688160000000; // 2023-06-30
-   *
-   *     console.log(formatTimestampRangeWithMoment(startTimestamp, endTimestamp));
-   * // 輸出：23/05/01 - 06/30
-   *
-   *     const startTimestampCrossYear = 1609459200000; // 2021-01-01
-   *     const endTimestampCrossYear = 1640995200000; // 2022-01-01
-   *
-   *     console.log(formatTimestampRangeWithMoment(startTimestampCrossYear, endTimestampCrossYear));
-   * // 輸出：21/01/01 - 22/01/01
-   * */
-
-  getStringOfFormatTimestampRange(startTimestamp, endTimestamp) {
-    // 使用 moment 解析 timestamp
-    const startDate = (0, _momentTimezone.default)(startTimestamp);
-    const endDate = (0, _momentTimezone.default)(endTimestamp);
-
-    // 格式化日期為 YY/MM/DD 格式
-    const formatDate = date => date.format("YY/MM/DD");
-
-    // 判斷是否跨年份
-    const startYear = startDate.year();
-    const endYear = endDate.year();
-    if (startYear === endYear) {
-      // 如果沒有跨年份，顯示 YY/MM/DD - MM/DD
-      return `${formatDate(startDate)} - ${endDate.format("MM/DD")}`;
-    } else {
-      // 如果跨年份，顯示 YY/MM/DD - YY/MM/DD
-      return `${formatDate(startDate)} - ${formatDate(endDate)}`;
-    }
-  }
-
-  /**
-   * // 測試範例
-   *     const startTimestamp = 1683004800000; // 2023-05-01
-   *     const endTimestamp = 1688160000000; // 2023-06-30
-   *     const weeklyMinutes = 180; // 每週上課 180 分鐘 (3 小時)
-   *
-   *     console.log(calculateClassTimeWithMoment(startTimestamp, endTimestamp, weeklyMinutes));
-   * // 輸出：12小時
-   *
-   * console.log(utiller.getStringOfCalculateClassTime(utiller.convertDateToTimestamp('2024-09-15'),utiller.convertDateToTimestamp('2024-10-15'),60))
-   *
-   */
-  getStringOfCalculateClassTime(startTimestamp, endTimestamp, weeklyMinutes) {
-    // 使用 moment 解析 timestamp
-    const startDate = (0, _momentTimezone.default)(startTimestamp);
-    const endDate = (0, _momentTimezone.default)(endTimestamp);
-
-    // 計算時間範圍內的天數
-    const totalDays = endDate.diff(startDate, "days") + 1; // 包含起始日
-    const totalWeeks = Math.ceil(totalDays / 7); // 計算有幾週
-
-    // 計算總上課時間（分鐘）
-    const totalMinutes = totalWeeks * weeklyMinutes;
-
-    // 將分鐘轉換為小時和分鐘
-    const hours = Math.floor(totalMinutes / 60);
-    const minutes = totalMinutes % 60;
-
-    // 判斷是否需要顯示分鐘
-    if (minutes === 0) {
-      return `${hours}小時`;
-    } else {
-      return `${hours}小時${minutes}分鐘`;
-    }
-  }
-
-  /** // 測試範例
-     const startTimestamp = 1683004800000; // 2023-05-01 00:00
-     const endTimestamp = 1683040800000;   // 2023-05-01 10:00
-      const totalMinutes = getNumberOfPeriodMinute(startTimestamp, endTimestamp);
-     console.log(totalMinutes); // 輸出：600（相當於10個小時，600分鐘）
-     */
-  getNumberOfPeriodMinute(startTimestamp, endTimestamp) {
-    // 使用 moment 解析 timestamp
-    // 使用 moment 解析 timestamp 並只取時間的 hh:mm 部分
-    const startTime = (0, _momentTimezone.default)(startTimestamp).format("HH:mm");
-    const endTime = (0, _momentTimezone.default)(endTimestamp).format("HH:mm");
-
-    // 使用 moment 重新將 hh:mm 轉換為完整的日期對象
-    const startDate = (0, _momentTimezone.default)(startTime, "HH:mm");
-    const endDate = (0, _momentTimezone.default)(endTime, "HH:mm");
-
-    // 計算兩個時間之間的分鐘差距
-    const durationInMinutes = _momentTimezone.default.duration(endDate.diff(startDate)).asMinutes();
-    return durationInMinutes;
-  }
-  /**
-   * const day = 1; // 週一
-   *     const startTimestamp = 1683004800000; // 2023-05-01 00:00
-   *     const endTimestamp = 1683019200000;   // 2023-05-01 04:00
-   *     const formattedString = formatTimeRange(day, startTimestamp, endTimestamp);
-   *     console.log(formattedString); // 輸出：週一 00:00-04:00
-   */
-  getStringOfWeekTime(day, startTimestamp, endTimestamp) {
-    // 檢查 day 是否在 1 到 7 之間
-    const daysOfWeek = {
-      1: "週一",
-      2: "週二",
-      3: "週三",
-      4: "週四",
-      5: "週五",
-      6: "週六",
-      7: "週日"
-    };
-    if (day < 1 || day > 7) {
-      throw new Error("day 必須在 1 到 7 之間");
-    }
-
-    // 使用 moment 將 timestamp 轉換為只保留 hh:mm 的格式
-    const startTime = (0, _momentTimezone.default)(startTimestamp).format("HH:mm");
-    const endTime = (0, _momentTimezone.default)(endTimestamp).format("HH:mm");
-
-    // 組合結果並返回
-    return `${daysOfWeek[day]} ${startTime}-${endTime}`;
-  }
-
-  /** 這個函式使用了正則表達式 \d+ 來匹配字串中的數字，並將其轉換為 number 型態。如果字串中沒有找到數字，則會回傳 null。
-   *     console.log(extractNumber('NTD 320')); // 輸出: 320
-   * */
-  extractNumber(str) {
-    // 使用正則表達式提取數字部分
-    if (this.isUndefinedNullEmpty(str)) return -1;
-    const match = str.match(/\d+/);
-
-    // 如果找到數字，轉換為數字型態並回傳
-    return match ? Number(match[0]) : -1;
-  }
-
-  /** puppeteer 的 fetch function
-   * 使用這個function的朋友必須安裝puppeteer:v23.6
-   * dom => <p id='_id' class='_class'>innerText /p>
-   * dom的物件型態為 CdpElementHandler
-   * * */
-  async fetchElementAttribute(dom, attr = "innerText", defaultValue = "") {
-    return await dom.evaluate(el => el[attr]);
-  }
-
-  /** puppeteer 的 fetch function
-   * 使用這個function的朋友必須安裝puppeteer:v23.6
-   *
-   * dom的物件型態為 CdpElementHandler
-   * */
-  async fetchElementAttributes(dom, stringOfTrait, defaultValue = "", ...attributes) {
-    const element = await dom.$(stringOfTrait);
-    if (!this.isUndefinedNullEmpty(element)) {
-      try {
-        return await element.evaluate((el, attributes) => {
-          if (attributes.length === 1) return el[attributes.shift()];
-          return {
-            ...attributes.map(attr => el[attr])
-          }; //或者 el.getAttribute('src') 更精確!
-        }, attributes);
-      } catch (error) {
-        this.appendError(`1581532 ${stringOfTrait} fetch ${JSON.stringify(attributes)} fail, element is not found`);
-        return defaultValue;
-      }
-    }
-    return defaultValue;
-  }
-
-  /** puppeteer 的 write dom function
-   * 使用這個function的朋友必須安裝puppeteer:v23.6
-   * attribute = {name:value}; // {value:'100000'}, {src:'http://123.com'}
-   * dom的物件型態為 CdpElementHandler
-   * */
-  async writeElementAttributes(dom, stringOfTrait, ...attributes) {
-    const element = await dom.$(stringOfTrait);
-    if (!this.isUndefinedNullEmpty(element)) {
-      await element.evaluate((element, attributes) => {
-        attributes.map(attr => {
-          const entries = Object.entries(attr);
-          const key = entries[0][0]; // 获取键 'name'
-          const value = entries[0][1]; // 获取值 'value'
-          element[key] = value;
-        });
-      }, attributes);
-    } else this.appendError(`1231232 ${stringOfTrait} fetch ${JSON.stringify(attributes)} fail, element is not found`);
-  }
-  /**
-   * 優化版本：根據元素類型選擇最高效的去重方式
-   * @param {Array} array - 要去重的陣列
-   * @param {string} [key] - (可選) 如果是物件陣列，指定用於判斷唯一的屬性鍵名
-   * @returns {Array} - 去重後的數組
-   *
-   * // 使用範例
-   * const strings = ['eee', 'aaa', 'bbb', 'ccc', 'bbb', 'ddd', 'eee'];
-   * const objects = [
-   *   { aa: 1, bb: 2 },
-   *   { cc: 1, dd: 2 },
-   *   { aa: 1, bb: 2 },
-   *   { ee: 4, ff: 5 },
-   *   { cc: 1, dd: 2 },
-   * ];
-   *
-   * console.log(uniqueArray(strings)); // ['eee', 'aaa', 'bbb', 'ccc', 'ddd']
-   * console.log(uniqueArray(objects)); // [{'aa': 1, 'bb': 2}, {'cc': 1, 'dd': 2}, {'ee': 4, 'ff': 5}]
-   */
-  getSliceArrayOfUnique(array) {
-    if (!Array.isArray(array) || array.length === 0) {
-      return [];
-    }
-    const firstElement = array[0];
-
-    // 1. 處理物件陣列，且提供了 key
-    if (_lodash.default.isObject(firstElement) && key) {
-      // 使用 Map 根據 key 去重，效率 O(N)
-      const uniqueMap = new Map(array.map(item => [item[key], item]));
-      return Array.from(uniqueMap.values());
-    }
-    // 2. 處理物件陣列，但未提供 key (或 key 無效)
-    else if (_lodash.default.isObject(firstElement)) {
-      // 回退到 lodash 的深度比較，效率較低 O(N^2)
-      console.warn("getSliceArrayOfUniqueOptimized: No key provided for object array, using potentially slow deep comparison.");
-      return _lodash.default.uniqWith(array, _lodash.default.isEqual);
-    }
-    // 3. 處理基本型別陣列 (string, number, boolean, null, undefined, symbol)
-    else {
-      // 使用 Set 去重，效率 O(N)
-      return Array.from(new Set(array));
-    }
-  }
-
-  /**
-     * Extract unique values of a specific key from an array of objects.
-     * array = [ { valueOfType: 1 }, { valueOfType: 7, valueOfSubType: 6 }, { valueOfType: 1 } ];
-       console.log(getUniqueValuesBy(array, 'valueOfType')); //[1, 7]
-     *
-     * @param {Array<Object>} array - The array of objects to process.
-     * @param {string} key - The key to extract values from. Default is 'valueOfType'.
-     * @returns {Array<any>} A deduplicated array of the extracted values.
-     */
-  getUniqueValuesBy(array, key = "valueOfType") {
-    return _lodash.default.uniq(array.map(item => item[key]));
-  }
-
-  /**
-      * ({key: 'color', label: '顏色', options: [  { value: 0, label: '紅' }, { value: 1, label: '白' }, { value: 2, label: '黑'}]},
-      *  {key: 'size', label: '尺寸', options: [ { value: 0, label: 'S號' }, { value: 1, label: 'M號' }, { value: 2, label: 'L號' }]})
-      *
-      * [
-      *   { trait: {color: 0, size: 0}, id: 'color_0_size_0', content: '紅｜S號' },
-      *   { trait: {color: 0, size: 1}, id: 'color_0_size_1', content: '紅｜M號' },
-      *   { trait: {color: 0, size: 2}, id: 'color_0_size_2', content: '紅｜L號' },
-      *   { trait: {color: 1, size: 0}, id: 'color_1_size_0', content: '白｜S號' },
-      *   { trait: {color: 1, size: 1}, id: 'color_1_size_1', content: '白｜M號' },
-      *   { trait: {color: 1, size: 2}, id: 'color_1_size_2', content: '白｜L號' },
-      * ]
-      *
-    /**
-     * 生成所有組合並依照 value 遞增排序，並回傳指定格式
-     * @param {Array} attributes - 屬性陣列
-     * @returns {Array} - 格式化組合
-     */
-  generateCombinations(...attributes) {
-    const keys = attributes.map(attr => attr.key); // 屬性順序
-    const labelMap = _lodash.default.keyBy(attributes, "key"); // 用於 content 查 label
-
-    // 把每個屬性的 options 提取成格式化陣列
-    const optionArrays = attributes.map(attr => attr.options.map(option => ({
-      key: attr.key,
-      value: option.value,
-      label: option.label
-    })));
-
-    // 計算笛卡兒積
-    const cartesianProduct = _lodash.default.reduce(optionArrays, (acc, curr) => _lodash.default.flatMap(acc, a => curr.map(b => [...a, b])), [[]]);
-
-    // 格式化每一筆組合
-    const results = cartesianProduct.map(combination => {
-      const trait = {};
-      const idParts = [];
-      const contentParts = [];
-      for (const {
-        key,
-        value,
-        label
-      } of combination) {
-        trait[key] = value;
-        idParts.push(`${key}_${value}`);
-        contentParts.push(`${label}`);
-      }
-      return {
-        trait,
-        id: idParts.join("_"),
-        content: contentParts.join("｜")
-      };
-    });
-
-    // 排序：依照屬性順序的 value 遞增（右邊 key 變化最快）
-    return _lodash.default.sortBy(results, item => keys.map(key => item.trait[key]));
-  }
-
-  /**
-   * 從路徑字串中擷取靜態片段（忽略以指定字元開頭的參數）
-   * @param {string} path - 輸入的路徑字串
-   * @param {string[]} rules - 要忽略的前綴符號規則，預設為 [':']
-   * @returns {string[]} - 篩選後的靜態段落，例如 ['dionysus', 'variants']
-   *
-   * const samples = [
-   *   '/dionysus/:pid/variants',
-   *   './dionysus/*pid/variants/',
-   *   '/shop/@category/:id'
-   * ];
-   * // 預設只忽略 ':'
-   *
-   * console.log(extractStaticSegments(samples[0])); // ['dionysus', 'variants']
-   * // 忽略 ':' 與 '*'
-   * console.log(extractStaticSegments(samples[1], [':', '*'])); // ['dionysus', 'variants']
-   * // 忽略 ':' 與 '@'
-   * console.log(extractStaticSegments(samples[2], [':', '@'])); // ['shop']
-   *
-   */
-  extractStaticSegments(path, rules = [":"]) {
-    return path.trim().replace(/^\.?\/*|\/*$/g, "") // 移除開頭 './' 或 '/'，結尾 '/'
-    .split("/").filter(segment => segment && !rules.some(rule => segment.startsWith(rule)));
-  }
-
-  /**
-   * const array = [{ a: 1, b: 2, c: 3 }, { a: 1, b: 2, d: 4 }];
-   * mutateRemoveKeys(array, ['b', 'c']);
-   * console.log(array); // ➜ [ { a: 1 }, { a: 1, d: 4 } ]
-   *
-   * 移除指定 keys，並原地改動原始陣列
-   * @param {Array<Object>} array - 要修改的原始 array
-   * @param {Array<string>} keysToRemove - 要刪除的 key 清單
-   */
-  mutateRemoveKeys(array, keysToRemove) {
-    _lodash.default.forEach(array, (obj, index) => {
-      const filtered = Object.fromEntries(Object.entries(obj).filter(([key]) => !keysToRemove.includes(key)));
-      // 原地替換每個 object 的 key
-      Object.keys(obj).forEach(k => delete obj[k]);
-      Object.assign(obj, filtered);
-    });
-  }
-
-  /**
-   * const array = [{ a: 1, b: 2, c: 3 }, { a: 1, b: 2, d: 4 }];
-   * const newArray = removeKeysFromArrayObjects(array, ['b', 'c']);
-   *
-   * console.log(newArray); // ➜ [ { a: 1 }, { a: 1, d: 4 } ]
-   * console.log(array);    // ➜ 原始 array 不變
-   *
-   * 回傳一個新的 array，移除每個物件中的指定 keys
-   * @param {Array<Object>} array - 原始資料陣列
-   * @param {Array<string>} keysToRemove - 要移除的 key 名稱陣列
-   * @returns {Array<Object>} - 新的 array（不改變原本的 array）
-   */
-  removeKeysFromArrayObjects(array, keysToRemove) {
-    return _lodash.default.map(array, obj => Object.fromEntries(Object.entries(obj).filter(([key]) => !keysToRemove.includes(key))));
-  }
-
-  /**
-   * 將過長的文字裁切為「前段......後段」格式
-   * @param {string} originalText - 原始文字內容
-   * @param {number} maxLength - 最終輸出不得超過的總字數（含省略號）
-   * @returns {string} - 處理後的顯示文字
-   */
-  formatTextWithEllipsis(originalText, maxLength) {
-    const ellipsis = "......";
-    const ellipsisLength = ellipsis.length;
-
-    // 若文字本身就短，無需裁切
-    if (_lodash.default.size(originalText) <= maxLength) return originalText;
-
-    // 若 maxLength 小於 ellipsis 自身長度，回傳空字串或提示錯誤
-    if (maxLength <= ellipsisLength) return "";
-
-    // 可用來切出前後字串的總長度
-    const remainingLength = maxLength - ellipsisLength;
-
-    // 前後平均切一半（如果是奇數則前段較短）
-    const frontLength = Math.floor(remainingLength / 2);
-    const backLength = remainingLength - frontLength;
-    const front = _lodash.default.truncate(originalText, {
-      length: frontLength,
-      omission: ""
-    });
-    const back = _lodash.default.takeRight(originalText, backLength).join("");
-    return `${front}${ellipsis}${back}`;
-  }
-
-  /**
-   * const obj = {
-   *   a: { idOfBooze: 1, checked: true },
-   *   b: { idOfBooze: 2, checked: false },
-   *   c: { idOfBooze: 3 }, // 無 checked
-   *   d: { idOfBooze: 4, checked: true }
-   * };
-   *
-   * getObjectBy(obj) ==> { b: { idOfBooze: 2, checked: false }, c: { idOfBooze: 3 } }
-   *
-   * 從物件中依條件過濾出符合條件的 key-value pair
-   * @param {Object} obj - 原始物件
-   * @param {Function} predict - 過濾條件函式，預設為 each.used === true
-   * @returns {Object} - 符合條件的新物件
-   */
-  getObjectBy(obj, predict = attr => attr.checked !== true) {
-    return _lodash.default.fromPairs(_lodash.default.toPairs(obj).filter(([_, value]) => predict(value)));
-  }
-
-  /**
-     *
-     const array = [
-     { serial: 'A023' },
-     { serial: 'Z001' },
-     { serial: 'C002' },
-     { serial: 'G123' },
-     { serial: 'A001' },
-     { serial: 'A999' }
-     ];
-      mutateBy(array, (item) => {
-     const serial = item.serial;
-     const match = serial.match(/^([A-Z]+)(\d+)$/i);
-     const [letter, number] = match ? [match[1], parseInt(match[2], 10)] : [serial, 0];
-     return [letter, number]; // 多層排序：先字母，再數字
-     });
-     *
-     * [ { serial: 'A001' }, { serial: 'A023' }, { serial: 'A999' }, { serial: 'C002' }, { serial: 'G123' }, { serial: 'Z001' } ]
-     *
-     *
-     * 通用的排序變異工具：依照 predict 提供的排序 key 對 array 進行原地排序(mutated)
-     *
-     * @param {Array} array - 要排序的陣列（會就地變異）
-     * @param {Function} predict - 回傳排序 key（可以是陣列以支援多層排序）
-     */
-  mutateBy(array, predict = item => item) {
-    const sorted = _lodash.default.sortBy(array, predict);
-    array.splice(0, array.length, ...sorted);
-  }
-
-  /**
-   *
-   * const array1 = ['a', 'b', 'c', null];
-   * const array2 = ['b', '', 'd'];
-   * const array3 = ['c', undefined, 'e'];
-   * const result = findUniqueStrings(array1, array2, array3);
-   * console.log(result); // ['a', 'd', 'e']
-   *
-   **/
-  findUniqueStrings(...arrays) {
-    const allStrings = _lodash.default.flatten(arrays);
-    const grouped = _lodash.default.countBy(allStrings);
-    return _lodash.default.chain(grouped).pickBy(count => count === 1).keys().compact() // 移除 null、undefined、''、0、false、NaN
-    .value();
-  }
-  /**
-   * 減少不必要的{}
-   * 例如 array.map(each => {return {key,value}})
-   **/
-  getObjectOfSpecifyKey(value, key) {
-    const object = {};
-    object[key] = value;
-    return object;
-  }
-
-  /**
-   *
-   * 參考第一個陣列（array1）；
-   * 回傳所有其他陣列中：
-   * 不在第一個陣列中的字串；
-   * 只出現一次的字串（全體中只出現一次）；
-   *
-   * const array1 = ['apple', 'banana', 'cherry'];
-   * const array2 = ['banana', '', 'date', null];
-   * const array3 = ['apple', undefined, 'elderberry'];
-   * const array4 = ['grape', '', 'honeydew', 'grape'];
-   * const result = findUniqueNonReferenceStrings(array1, array2, array3, array4);
-   * console.log(result); // ['date', 'elderberry', 'honeydew']
-   *
-   */
-  findUniqueNonReferenceStrings(...arrays) {
-    if (arrays.length === 0) return [];
-    const [reference, ...rest] = arrays;
-    const allExceptRef = _lodash.default.flatten(rest);
-    const counted = _lodash.default.countBy(allExceptRef);
-    return _lodash.default.chain(counted).pickBy((count, str) => count === 1 && !reference.includes(str)).keys().compact() // 過濾掉 null, undefined, '' 等 falsy 值
-    .value();
-  }
-  /**
-   * const input = [
-   *   { value: 'xx0132', label: 'A款' },
-   *   { value: 'y1y123', label: 'B款' },
-   *   { value: 'yy0123', label: 'C款' },
-   *   { value: '', label: 'D款' },
-   *   { value: null, label: 'E款' },
-   *   { value: undefined, label: 'F款' },
-   * ]
-   *
-   * const output = getArrayOfFillMissingValues(input)
-   * console.log(output)
-   * */
-  getArrayOfFillMissingValues(array) {
-    const charset = "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789";
-    const generateRandomValue = () => _lodash.default.times(8, () => _lodash.default.sample(charset)).join("");
-    const usedValues = new Set(array.map(item => item.value).filter(Boolean));
-    return array.map(item => {
-      if (_lodash.default.isEmpty(item.value)) {
-        let newValue;
-        do {
-          newValue = generateRandomValue();
-        } while (usedValues.has(newValue));
-        usedValues.add(newValue);
-        return {
-          ...item,
-          value: newValue
-        };
-      }
-      return item;
-    });
-  }
-
-  /**
-   * 判斷是否為 Firestore 自動產生的 Document ID
-   * @param {string} id - 欲檢查的字串
-   * @returns {boolean}
-   *
-   * isFirestoreAutoId('Ab3dEFghiJKLmnPQrStu'); // ✅ true
-   * isFirestoreAutoId('1234567890abcdefghij'); // ✅ true
-   * isFirestoreAutoId('a-b-c-d-e-f-g-h-i-j');  // ❌ false（有非法字元）
-   * isFirestoreAutoId('shortId');              // ❌ false（長度錯誤）
-   * isFirestoreAutoId(null);                   // ❌ false（不是字串）
-   */
-  isFirestoreAutoId(id) {
-    return _lodash.default.isString(id) && id.length === 20 && /^[A-Za-z0-9]{20}$/.test(id);
-  }
-  getAutoIdOfFirestore() {
-    return this.getRandomHashV2(20);
-  }
-  /** const result = convertTimeRange('2025/08/18(一)｜16:00-17:00');
-        console.log(result); // '202508181600-202508181700'*/
-  getStringOfConvertTimeRange(input) {
-    const [datePart, timeRange] = input.split("｜");
-    const dateStr = datePart.split("(")[0]; // 取 '2025/08/18'
-    const [start, end] = timeRange.split("-");
-    const formatDate = time => (0, _momentTimezone.default)(`${dateStr} ${time}`, "YYYY/MM/DD HH:mm").format("YYYYMMDDHHmm");
-    return `${formatDate(start)}-${formatDate(end)}`;
-  }
-
-  /**
-   * console.log(getTSOfSpecificDate("2025/08/18(一)", { end: false })); // 20250818000000 (number)
-   * console.log(getTSOfSpecificDate("2025/08/18(一)", { end: true }));  // 20250818235959 (number)
-   */
-  getTSOfSpecificDate(dateStr, {
-    end = false
-  } = {}) {
-    return Number((0, _lodash.default)(dateStr).thru(str => (0, _momentTimezone.default)(str.split("(")[0], "YYYY/MM/DD")).thru(m => end ? m.endOf("day") : m.startOf("day")).value() // 取出 moment 物件
-    .format("YYYYMMDDHHmmss"));
-  }
-
-  /**
-   * 檢查是否為 HTTPS 網址
-   * @param {string} url
-   * @returns {boolean}
-   */
-  isHttpsURL(url) {
-    if (!_lodash.default.isString(url)) return false;
-    try {
-      const decoded = decodeURIComponent(url.trim());
-      const parsed = new URL(decoded);
-      return parsed.protocol === "https:";
-    } catch (e) {
-      return false;
-    }
-  }
-  /**
-   * 🧩 產生合法變數命名的唯一亂碼代碼對照表（支援自訂長度）
-   *
-   * 將輸入的字串陣列轉換成：
-   * 1️⃣ 合法變數命名 key（以 _.camelCase() 處理）
-   * 2️⃣ 對應唯一亂碼代碼（預設長度 3，第一字母必須為英文字母）
-   * 3️⃣ 若 key 重複，拋出錯誤並指出是哪個 key 重複
-   *
-   * @param {string[]} array - 要轉換的字串陣列
-   * @param {number} [length=3] - 代碼長度（預設為 3，最小為 2）
-   * @returns {Object} 回傳一個 JSON 物件，例如：
-   *                   { mainDiv: 'f2x', mainBanner: 'k9A' }
-   *
-   * 📘 範例：
-   * ```js
-   * const arr = ["MainDiv", "MainPromotedBannerSwiperSlide", "MainPromotedBannerSwiperList"];
-   *
-   * console.log(generateUniqueCodeMap(arr)); // 預設長度3
-   * // => { mainDiv: 'a9F', mainPromotedBannerSwiperSlide: 'm2q', mainPromotedBannerSwiperList: 'z5K' }
-   *
-   * console.log(generateUniqueCodeMap(arr, 4)); // 改為4字元
-   * // => { mainDiv: 'a9Fz', mainPromotedBannerSwiperSlide: 'm2qR', mainPromotedBannerSwiperList: 'z5K2' }
-   * ```
-   *
-   * // === 🧪 測試範例 ===
-   *     const arr = [
-   *         "MainDiv",
-   *         "MainPromotedBannerSwiperSlide",
-   *         "MainPromotedBannerSwiperList",
-   *     ];
-   *
-   *     console.log("3字元預設：", generateUniqueCodeMap(arr));
-   *     console.log("4字元代碼：", generateUniqueCodeMap(arr, 4));
-   *
-   */
-  generateUniqueCodeMap(array, length = 3) {
-    if (length < 2) {
-      throw new Error("代碼長度最少必須為 2。");
-    }
-    const usedCodes = new Set();
-    const usedKeys = new Set();
-
-    /**
-     * 產生合法變數代碼（指定長度亂碼）
-     * 第1字母：a-zA-Z
-     * 其餘字元：a-zA-Z0-9
-     */
-    const generateRandomCode = () => {
-      const letters = "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ";
-      const chars = letters + "0123456789";
-      let code;
-      do {
-        // 第一個字母必須是英文
-        code = letters[Math.floor(Math.random() * letters.length)];
-        // 其餘字元隨機取
-        for (let i = 1; i < length; i++) {
-          code += chars[Math.floor(Math.random() * chars.length)];
-        }
-      } while (usedCodes.has(code));
-      usedCodes.add(code);
-      return code;
-    };
-    return _lodash.default.transform(array, (result, key) => {
-      if (usedKeys.has(key)) {
-        throw new Error(`23125453 Duplicate key detected: "${key}"`);
-      }
-      usedKeys.add(key);
-      result[key] = generateRandomCode();
-    }, {});
-  }
-  /**
-   * 根據百分比計算價格變化後的金額(折扣後的總金額)。
-   *
-   * @param {number} price - 原始價格。
-   * @param {number} percentage - 百分比（例如 10 表示 10%）。
-   * @param {boolean} [discount=false] - 是否為折扣模式。
-   *    - true：表示減價（例如 10% 折扣 → 價格 * (1 - 0.1)）
-   *    - false：表示加價（例如 10% 加成 → 價格 * (1 + 0.1)）
-   * @returns {number} - 計算後的金額，並取「向上取整」結果。
-   *
-   * 範例：
-   * getPriceOfPercentageBehavior(100, 10, true)  → 90
-   * getPriceOfPercentageBehavior(100, 10, false) → 110
-   */
-  getPriceOfPercentageBehavior(price, percentage, discount = false) {
-    // 將百分比（例如 10）轉為小數（0.1）
-    const decimal = this.toPercentageDecimal(percentage);
-
-    // 根據是否為折扣，決定乘上 (1 - 0.1) 或 (1 + 0.1)
-    // 並呼叫 getNumberOfMultiplyCeil 進行乘法後向上取整
-    return this.getNumberOfMultiplyCeil(price, discount ? 1 - decimal : 1 + decimal);
-  }
-  getFeeOfDiscount(origin, percentage) {
-    return Math.round(_lodash.default.multiply(origin, this.toPercentageDecimal(percentage)));
-  }
-
-  /**
-   * 📦 mergeArrayByKey(array)
-   * ---------------------------------------
-   * 將陣列中相同 key 的物件進行「巢狀合併」，並直接 mutate 原陣列內容。
-   *
-   * ✅ 特點：
-   * - 自動合併相同 key 的物件內容（深層合併）
-   * - 不建立新陣列，會直接修改傳入的 array
-   * - 適用於需要整併設定、狀態、表單資料等情境
-   *
-   * 🧩 範例：
-   * ```js
-   * const array = [
-   *   { a: { b: { c: 2 } } },
-   *   { b: { d: { g: 1 } }, a: { b: { y: 1 }, h: { e: 1 } } }
-   * ];
-   *
-   * ArrayHelper.mergeArrayByKey(array);
-   *
-   * console.log(array);
-   * // 👉 [ { a: { b: { c: 2, y: 1 }, h: { e: 1 } } }, { b: { d: { g: 1 } } } ]
-   * ```
-   *
-   * @param {Array<Object>} array - 需被合併的物件陣列
-   * @returns {Array<Object>} - 回傳同一個（已被 mutate 的）陣列
-   */
-  mergeArrayByKey(array) {
-    if (!Array.isArray(array)) return array;
-
-    // 收集所有 key 的合併結果
-    const resultMap = {};
-    for (const obj of array) {
-      if (!_lodash.default.isPlainObject(obj)) continue;
-      for (const [key, value] of Object.entries(obj)) {
-        if (!resultMap[key]) {
-          resultMap[key] = _lodash.default.cloneDeep(value);
-        } else {
-          _lodash.default.merge(resultMap[key], value);
-        }
-      }
-    }
-
-    // 清空原陣列（mutate）
-    array.length = 0;
-
-    // 重建結構
-    Object.entries(resultMap).forEach(([key, value]) => {
-      array.push({
-        [key]: value
-      });
-    });
-    return array;
-  }
-
-  /**
-   * 將時間字串解析為物件，回傳 {startDate, startTime, endDate, endTime}
-   *
-   * 支援格式：
-   * 1. '2025/11/10 (一)｜13:00-15:00'
-   *    => { startDate:'2025/11/10', startTime:'13:00', endDate:'2025/11/10', endTime:'15:00' }
-   *
-   * 2. '2025/11/10 (一) 13:00 - 2025/11/12 (三) 15:00'
-   *    => { startDate:'2025/11/10', startTime:'13:00', endDate:'2025/11/12', endTime:'15:00' }
-   *
-   * @param {string} input - 欲解析的時間字串
-   * @returns {{startDate: string, startTime: string, endDate: string, endTime: string}} 解析後的時間物件
-   *
-   * @example
-   * getObjectOfStartEndDateTime('2025/11/10 (一)｜13:00-15:00');
-   * // => { startDate:'2025/11/10', startTime:'13:00', endDate:'2025/11/10', endTime:'15:00' }
-   *
-   * @example
-   * getObjectOfStartEndDateTime('2025/11/10 (一) 13:00 - 2025/11/12 (三) 15:00');
-   * // => { startDate:'2025/11/10', startTime:'13:00', endDate:'2025/11/12', endTime:'15:00' }
-   */
-  getObjectOfStartEndDateTime(input) {
-    if (!input || typeof input !== "string") {
-      return {
-        startDate: "",
-        startTime: "",
-        endDate: "",
-        endTime: ""
-      };
-    }
-
-    // 將全形符號與多餘空白轉換為標準形式
-    const cleaned = input.replace(/｜/g, " ").replace(/－/g, "-") // 全形破折號轉半形
-    .replace(/\s+/g, " ").trim();
-
-    // 跨日期格式 (例：2025/11/10 13:00 - 2025/11/12 15:00)
-    const crossDatePattern = /(\d{4}\/\d{1,2}\/\d{1,2})(?:\s*\([^)]*\))?\s*(\d{2}:\d{2})\s*-\s*(\d{4}\/\d{1,2}\/\d{1,2})(?:\s*\([^)]*\))?\s*(\d{2}:\d{2})/;
-
-    // 同日期格式 (例：2025/11/10 13:00 - 15:00)
-    const sameDatePattern = /(\d{4}\/\d{1,2}\/\d{1,2})(?:\s*\([^)]*\))?\s*(\d{2}:\d{2})\s*-\s*(\d{2}:\d{2})/;
-    let startDate, startTime, endDate, endTime;
-    if (crossDatePattern.test(cleaned)) {
-      [, startDate, startTime, endDate, endTime] = cleaned.match(crossDatePattern);
-    } else if (sameDatePattern.test(cleaned)) {
-      [, startDate, startTime, endTime] = cleaned.match(sameDatePattern);
-      endDate = startDate;
-    } else {
-      return {
-        startDate: "",
-        startTime: "",
-        endDate: "",
-        endTime: ""
-      };
-    }
-
-    // 將日期時間轉為可比較的 Date 物件
-    const start = new Date(`${startDate} ${startTime}`);
-    const end = new Date(`${endDate} ${endTime}`);
-    if (end < start) {
-      throw new Error(`End time cannot be earlier than start time: ${input}`);
-    }
-    return {
-      startDate,
-      startTime,
-      endDate,
-      endTime
-    };
-  }
-  // 範例用法 (請確保 moment.js 已載入)
-  /*
-    const myEvent = {
-        title: '吉他課 (Moment.js)',
-        startDate: '2026/01/15', // 使用新的 YYYY/MM/DD 格式
-        startTime: '10:30',
-        endDate: '2026/01/15',
-        endTime: '12:00',
-        location: '新北市板橋區縣民大道一段 1 號',
-        details: 'Moment.js 測試：請記得帶譜架。'
-    };
-     if (typeof moment !== 'undefined') {
-        const links = generateAllCalendarLinks(myEvent);
-        console.log('--- 使用 Moment.js 生成的連結 ---');
-        console.log(links);
-    } else {
-        console.warn('moment.js 函式庫未載入，無法執行。');
-    }
-    */
-
-  /** ============== 排課系統公式 開始 ============== */
-
-  /**
-   * /const arrayWithDup = [
-   *   { idOfBooze: "A111", idOfVariant: "V001", period: "202508151400-202508151500" },
-   *   { idOfBooze: "B222", idOfVariant: "V002", period: "202508151600-202508151700" },
-   *   { idOfBooze: "A111", idOfVariant: "V001", period: "202508161400-202508161500" }, // 🔁 與第一筆 PK 相同
-   *   { idOfBooze: "B222", idOfVariant: "V003", period: "202508171600-202508171700" },
-   *   { idOfBooze: "A111", idOfVariant: "V004", period: "202508181400-202508181500" }
-   *
-   * ];
-   * const result = getFilteredPeriods(arrayWithDup, "B222"); console.log(result);
-   *   [ "202508151400-202508151500", "202508181400-202508181500" ]
-   * 1. 刪掉所有 idOfBooze = "B222" 的項目
-   * 2. idOfBooze和idOfVariant為PK， 重複的只保留一組
-   * 3. 回傳filter array,(反查出哪些課程重複會用到其他資訊)
-   * */
-  getFilteredHeraPeriods(arr, idOfCurrentBooze) {
-    return _lodash.default.chain(arr)
-    // 1️⃣ 刪掉 idOfBooze 等於目標值的項目
-    .filter(item => item.idOfBooze !== idOfCurrentBooze)
-    // 2️⃣ 根據 idOfBooze+idOfVariant 組成唯一鍵 僅保留一組
-    .uniqBy(item => `${item.idOfBooze}_${item.idOfVariant}`)
-    // 3️⃣ 只保留 period 欄位
-    // .map('period')
-    // 4️⃣ 過濾掉沒有 period 的項目（避免 undefined）
-    // .filter(Boolean)
-    // 5️⃣ 轉回陣列
-    .value();
-  }
-
-  /**
-   * 檢查新任務與既有任務是否有時間衝突
-   * @param {Object} newTask - 新任務物件，需包含 timeSlot 屬性 (格式: YYYY/MM/DD (週)｜HH:mm-HH:mm)
-   * @param {Array} existingTasks - 已安排的任務陣列，每個物件需包含 period 屬性 (格式: yyyymmddHHmm-yyyymmddHHmm)
-   * @param {number} resourceCount - 可同時處理任務的人員/資源數量
-   * @returns {Object} { conflict: boolean, items: Array }
-   */
-  checkPeriodConflict(newTask, existingTasks, resourceCount = 1) {
-    // 1️⃣ 解析 timeSlot 拆成日期與時間
-    const [datePart, timePart] = newTask.content.split("｜");
-    const date = (0, _momentTimezone.default)(datePart.split(" ")[0], "YYYY/MM/DD");
-    const [startTimeStr, endTimeStr] = timePart.split("-");
-    const start = (0, _momentTimezone.default)(`${date.format("YYYY/MM/DD")} ${startTimeStr}`, "YYYY/MM/DD HH:mm");
-    const end = (0, _momentTimezone.default)(`${date.format("YYYY/MM/DD")} ${endTimeStr}`, "YYYY/MM/DD HH:mm");
-
-    // 2️⃣ 篩選出有真實時間重疊的任務
-    const conflictItems = _lodash.default.filter(existingTasks, task => {
-      const [pStartStr, pEndStr] = task.period.split("-");
-      const pStart = (0, _momentTimezone.default)(pStartStr, "YYYYMMDDHHmm");
-      const pEnd = (0, _momentTimezone.default)(pEndStr, "YYYYMMDDHHmm");
-
-      // 判斷條件：有交集才算衝突
-      return start.isBefore(pEnd) && end.isAfter(pStart);
-    });
-
-    // 3️⃣ 根據資源數量判斷是否真的構成衝突
-    const conflict = conflictItems.length >= resourceCount;
-
-    // 4️⃣ 回傳結果
-    return {
-      conflict,
-      // true: 超過資源負荷
-      items: conflictItems // 衝突的任務列表
-    };
-  } // testOfConflict() {
-  //     // ===== 測試資料 =====
-  //     const newTask = {
-  //         timeSlot: "2025/08/20 (三)｜16:00-17:00", // 格式: YYYY/MM/DD (週)｜HH:mm-HH:mm
-  //         id: "JOB001",
-  //         description: "安裝冷氣"
-  //     };
-  //
-  //     const existingTasks = [
-  //         { id: "T001", period: "202508151400-202508151500" },
-  //         { id: "T002", period: "202508151600-202508151700" },
-  //         { id: "T003", period: "202508161400-202508161500" },
-  //         { id: "T004", period: "202508171600-202508171700" },
-  //         { id: "T005", period: "202508201630-202508201700" }, // 衝突
-  //         { id: "T006", period: "202508201645-202508201700" }  // 衝突
-  //     ];
-  //
-  //     // 測試：一人資源
-  //     console.log(this.checkPeriodConflict(newTask, existingTasks, 1));
-  //     /*
-  //     {
-  //       conflict: true,
-  //       items: [
-  //         { id: 'T005', period: '202508201630-202508201700' },
-  //         { id: 'T006', period: '202508201645-202508201700' }
-  //       ]
-  //     }
-  //     */
-  //
-  //     // 測試：兩人資源
-  //     console.log(this.checkPeriodConflict(newTask, existingTasks, 2));
-  //     /*
-  //     {
-  //       conflict: false,
-  //       items: [
-  //         { id: 'T005', period: '202508201630-202508201700' },
-  //         { id: 'T006', period: '202508201645-202508201700' }
-  //       ]
-  //     }
-  //     */
-  // }
-  /** ============== 排課系統公式 結束 ============== */
-}
-var _default = exports.default = Utiller;
+"use strict";var _interopRequireDefault=require("@babel/runtime/helpers/interopRequireDefault");Object.defineProperty(exports,"__esModule",{value:!0}),exports.default=void 0;var _defineProperty2=_interopRequireDefault(require("@babel/runtime/helpers/defineProperty")),_lodash=_interopRequireDefault(require("lodash")),_cryptoJs=_interopRequireDefault(require("crypto-js")),_configerer=require("configerer"),_exceptioner=_interopRequireDefault(require("../exceptioner")),_momentTimezone=_interopRequireDefault(require("moment-timezone")),_uuid=require("uuid"),_nodeHtmlParser=require("node-html-parser");String.format=function(){let e=[];for(let t=0,r=arguments.length;t<r;t++)e.push(arguments[t]);let t=e[0];return e.shift(),t.replace(/\{(\d+)\}/g,function(t,r){return e[r]})};class Utiller{removeAttributeBy(e,t=e=>_lodash.default.isUndefined(e)){for(const r in e)t(e[r])&&delete e[r]}getNumberOfNormalize(e,t=0){if(_lodash.default.isNumber(e))return e;try{const r=_lodash.default.toNumber(e);return _lodash.default.isNumber(r)&&!isNaN(r)?r:t}catch(e){Util.appendError(`448561684561 ${e.message}`)}return t}getStringOfNormalize(e,t="",r=!1){if(_lodash.default.isString(e))return r?_lodash.default.trim(e):e;try{const a=_lodash.default.toString(e);return this.isOrEquals(a,"","undefined")?t:r?_lodash.default.trim(a):a}catch(e){Util.appendError(`448616845453 ${e.message}`)}return t}isValidVersionOfString(e){if(this.isUndefinedNullEmpty(e))return!1;const t=e.split(".");for(const e of t){const t=_lodash.default.toNumber(e);if(!_lodash.default.isNumber(t)||isNaN(t))return!1}return!0}getSeparatorOfUnique(){return"།།"}getStringOfVersionIncrement(e,t=1){const r=e.split(".").map(e=>_lodash.default.toNumber(e)),a=r.length-1;return r[a]=r[a]+t,r.join(".")}setLocaleOfMoment(e="en"){_momentTimezone.default.locale(e)}getUuidOfV4(){return(0,_uuid.v4)()}constructor(){(0,_defineProperty2.default)(this,"mapOfIdNTimeoutId",{}),(0,_defineProperty2.default)(this,"getEnvironment",()=>this.env),(0,_defineProperty2.default)(this,"isProductionEnvironment",()=>_lodash.default.isEqual(this.getEnvironment(),"prod")),(0,_defineProperty2.default)(this,"asyncUnitTaskFunction",(e=2e3,t="預設的param",r)=>async(a=this.getRandomHash(10))=>{const n=this.getRandomValue(e,1.2*e);try{const e=n;if(this.appendInfo(`before executed ===> i'm symbol of ${e}, ready to be executed, inner param = ${t}`),await this.syncDelay(n),_lodash.default.isFunction(r)&&r(a))throw Error("force to made error happen");return this.appendInfo(`after executed ===> i'm symbol of ${e}, the task cost ${n} million-seconds ${a?`i hav params ===> ${a}`:""}`),{randomValue:n,symbol:e,param:a}}catch(e){this.appendError(new Error(`asyncUnitTask() catch error ${e.message}`))}finally{this.appendInfo("wow.... finally got you")}}),(0,_defineProperty2.default)(this,"test",e=>async()=>(await Util.syncDelay(3e3),await Util.syncDelay(4e3),await Util.syncDelay(5e3),await Util.syncDelay(6e3),`3423809432804 ${e}`)),(0,_defineProperty2.default)(this,"findLowestValue",(e,t="price")=>{const r=_lodash.default.minBy(e,t)[t];return Math.floor(r)}),(0,_defineProperty2.default)(this,"findHighestValue",(e,t="price")=>{const r=_lodash.default.maxBy(e,t)[t];return Math.floor(r)}),(0,_defineProperty2.default)(this,"getStringOfValueRange",(e,t="price",r="$")=>{const a=_lodash.default.minBy(e,t)[t],n=_lodash.default.maxBy(e,t)[t];return n===a?`$${a}`:`${r}${a} - ${r}${n}`}),(0,_defineProperty2.default)(this,"getCallersName",()=>{let e;try{throw new Error}catch(t){let r,a=/(\w+)@|at (\w+) \(/g,n=t.stack;a.exec(n),r=a.exec(n),_lodash.default.isNull(r)||(e=r[1]||r[2])}return _lodash.default.startsWith("asyncGeneratorStep",e)&&(e=""),e}),(0,_defineProperty2.default)(this,"getRandomValue",(e,t)=>(e=Math.ceil(e),t=Math.floor(t),Math.floor(Math.random()*(t-e+1))+e)),(0,_defineProperty2.default)(this,"insertToArray",(e,t,...r)=>{if(!Array.isArray(e))throw new Error("First argument must be an array.");const a=Math.max(0,Math.min(t+1,e.length));e.splice(a,0,...r)}),(0,_defineProperty2.default)(this,"getStringOfYearADConvertToMinguoYear",(e,t=!1)=>{const r=e-1911;return r>0?`${t?"民國":""}${r}${t?"年":""}`:`${t?"民國":""}前${Math.abs(r)}${t?"年":""}`}),(0,_defineProperty2.default)(this,"convertDateToTimestamp",e=>(0,_momentTimezone.default)(e).valueOf()),(0,_defineProperty2.default)(this,"measureExecutionTime",async(e,...t)=>{const r=Date.now();await e(...t);const a=Date.now()-r,n=_momentTimezone.default.duration(a,"milliseconds"),i=Math.floor(n.asHours()),o=n.minutes(),s=n.seconds(),l=n.milliseconds(),u=(a/1e3).toFixed(3);this.appendInfo(`${i}小時 ${o}分 ${s}.${l.toString().padStart(3,"0")}秒 (合計 ${u} 秒)`)}),(0,_defineProperty2.default)(this,"formatPriceWithCurrency",(e,t)=>{if("number"!=typeof e||"string"!=typeof t)throw new TypeError("Invalid input: number must be a number and locale must be a string.");return new Intl.NumberFormat(t,{style:"currency",currency:new Intl.Locale(t).maximize().currency||"USD",minimumFractionDigits:0}).format(e)}),(0,_defineProperty2.default)(this,"formatPrice",(e,t)=>{if("number"!=typeof e)throw new TypeError("Invalid input: number must be a number.");return t?new Intl.NumberFormat(t,{style:"currency",currency:new Intl.Locale(t).maximize().currency||"USD",minimumFractionDigits:0}).format(e):e.toLocaleString("en-US")}),(0,_defineProperty2.default)(this,"generateUniversalKeywords",(e,t=50,r=4)=>{if(!e||"string"!=typeof e)return[];if(void 0===_lodash.default)return[];let a=e.trim(),n=[];r=Math.max(2,r),a.length>t&&(a=a.substring(0,t)),(a.match(/[a-zA-Z]+/g)||[]).forEach(e=>{if(e.length>=2){n.push(e.toUpperCase()),n.push(e.toLowerCase());const t=e.charAt(0).toUpperCase()+e.slice(1).toLowerCase();n.push(t)}});const i=(a.match(/\b[0-9]+[a-zA-Z]{1,4}\b|\b[0-9]{1,3}(w|ml|g|oz|k)\b|[\u4e00-\u9fa5a-zA-Z0-9]{1,4}(色|號)[\u4e00-\u9fa5a-zA-Z0-9]{0,2}/gi)||[]).filter(e=>e.length>=2).map(e=>e.toLowerCase());n.push(...i);let o=a.toLowerCase();o=o.replace(/[0-9]+([\u4e00-\u9fa5a-z]{1,4}|[\/\-\~\\])/g," ").replace(/\b[a-z]{1,4}\b/g," ").replace(/\b[0-9]{1,3}\b/g," "),o=o.replace(/[!@#$%^&*()_+={}\[\]:;"'<>,.?\/\\|`~]/g," ").replace(/系列|一組|單色|多款|套組|全套|專用|迷你|頂級|高品質|超閃|奢華|最新|款式|新款|超亮|的|與|和|閃|美甲/g," ").replace(/\s+/g,"").trim();for(let e=2;e<=r;e++)for(let t=0;t<=o.length-e;t++){const r=o.substring(t,t+e);n.push(r)}return _lodash.default.chain(n).filter(e=>e.length>=2).filter(e=>e.length>2||!/^[\u4e00-\u9fa5a-z0-9]$/.test(e)).uniq().sortBy().value()}),(0,_defineProperty2.default)(this,"mutateIndexOfArrayItem",(e,t,r=0)=>{if(!Array.isArray(e)||!_lodash.default.isObject(t))return e;const a=_lodash.default.findIndex(e,e=>_lodash.default.isEqual(e,t));if(-1===a)return e;e.splice(a,1);const n=_lodash.default.clamp(r,0,e.length);return e.splice(n,0,t),e}),(0,_defineProperty2.default)(this,"getArrayOfModifyObject2Index",(e,t,r=0)=>{if(!Array.isArray(e)||!_lodash.default.isObject(t))return e;const a=_lodash.default.cloneDeep(e),n=_lodash.default.findIndex(a,e=>_lodash.default.isEqual(e,t));if(-1===n)return e;a.splice(n,1);const i=_lodash.default.clamp(r,0,a.length);return a.splice(i,0,t),a}),(0,_defineProperty2.default)(this,"generateLabelValuePairsWithOrigin",(e=[{label:"aa",value:1203},{label:"cc",value:1204},{label:"gg",value:2}],t=["aa","bb"])=>{const r=new Set(e.map(e=>e.value));return _lodash.default.chain(t).uniq().map(t=>{const a=_lodash.default.find(e,{label:t});if(a)return{label:t,value:a.value};let n;do{n=_lodash.default.random(2,999999999)}while(r.has(n));return r.add(n),{label:t,value:n}}).value()}),(0,_defineProperty2.default)(this,"getItemsOfMarkMatching",(e=[],t=[],r="value",a="belong")=>{const n=new Set(t);return _lodash.default.map(e,e=>({...e,[a]:n.has(e[r])}))}),(0,_defineProperty2.default)(this,"generateVariants",(e,t="｜",r="-")=>{const a=e.filter(e=>e.length>0);return 0===a.length?[]:1===a.length?a[0].map(e=>({label:e.label,value:e.value})):_lodash.default.reduce(a,(e,t)=>_lodash.default.flatMap(e,e=>t.map(t=>[...e,t])),[[]]).map(e=>({label:e.map(e=>e.label).join(t),value:e.map(e=>e.value).join(r)}))}),(0,_defineProperty2.default)(this,"renameKeysInArray",(e,...t)=>{const r=Object.fromEntries(t);return e.map(e=>_lodash.default.mapKeys(e,(e,t)=>r[t]||t))}),(0,_defineProperty2.default)(this,"getArrayOfMergeBySpecificId",(e,t,r="id")=>{if(!Array.isArray(t))return e;const a=_lodash.default.keyBy(t,e=>_lodash.default.get(e,r));return e.map(e=>{const t=_lodash.default.get(e,r),n=a[t];return n?_lodash.default.merge({},e,n):e})}),(0,_defineProperty2.default)(this,"toPercentageDecimal",e=>{if(_lodash.default.isNil(e))return 1;_lodash.default.isString(e)&&(e=e.replace(/%/g,"").trim());const t=_lodash.default.toNumber(e);return _lodash.default.isFinite(t)?_lodash.default.round(t/100,10):1}),(0,_defineProperty2.default)(this,"getNumberOfMultiplyCeil",(e,t,r=0)=>{const a=Math.pow(10,r);return Math.ceil(e*t*a)/a}),(0,_defineProperty2.default)(this,"generateGoogleCalendarLink",({title:e,startDate:t,startTime:r,endDate:a,endTime:n,location:i,details:o})=>{const s=(0,_momentTimezone.default)(`${t} ${r}`,"YYYY/MM/DD HH:mm").format("YYYYMMDDTHHmmss"),l=(0,_momentTimezone.default)(`${a} ${n}`,"YYYY/MM/DD HH:mm").format("YYYYMMDDTHHmmss"),u=new URLSearchParams;return e&&u.append("text",e),s&&l&&u.append("dates",`${s}/${l}`),o&&u.append("details",o),i&&u.append("location",i),u.append("ctz","Asia/Taipei"),u.append("trp","true"),`https://calendar.google.com/calendar/r/eventedit?${u.toString()}`}),(0,_defineProperty2.default)(this,"generateTimeTreeLink",({title:e,startDate:t,startTime:r,endDate:a,endTime:n,location:i,memo:o})=>{const s=new URLSearchParams;return e&&s.append("title",e),t&&s.append("start_date",t.replace(/\//g,"-")),r&&s.append("start_time",r),a&&s.append("end_date",a.replace(/\//g,"-")),n&&s.append("end_time",n),i&&s.append("location",i),o&&s.append("memo",o),`https://timetreeapp.com/plans/new?${s.toString()}`}),(0,_defineProperty2.default)(this,"generateIcsContent",({title:e,startDate:t,startTime:r,endDate:a,endTime:n,location:i,details:o})=>{const s=_momentTimezone.default.tz(`${t} ${r}`,"YYYY/MM/DD HH:mm","Asia/Taipei").format("YYYYMMDDTHHmmss"),l=_momentTimezone.default.tz(`${a} ${n}`,"YYYY/MM/DD HH:mm","Asia/Taipei").format("YYYYMMDDTHHmmss"),u=(0,_momentTimezone.default)().utc().format("YYYYMMDDTHHmmss")+"Z",d=e=>e.replace(/\\/g,"\\\\").replace(/,/g,"\\,").replace(/;/g,"\\;").replace(/\n/g,"\\n"),f=["BEGIN:VCALENDAR","VERSION:2.0","PRODID:-//Gemini AI//NONSGML v1.0//EN","BEGIN:VEVENT","UID:"+(Date.now().toString(36)+Math.random().toString(36).substring(2,5)+"@gemini-app.com"),`DTSTAMP:${u}`];return s&&f.push(`DTSTART;TZID=Asia/Taipei:${s}`),l&&f.push(`DTEND;TZID=Asia/Taipei:${l}`),e&&f.push(`SUMMARY:${d(e)}`),i&&f.push(`LOCATION:${d(i)}`),o&&f.push(`DESCRIPTION:${d(o)}`),f.push("END:VEVENT","END:VCALENDAR"),f.join("\r\n")}),(0,_defineProperty2.default)(this,"generateAllCalendarLinks",e=>{const t=this.generateGoogleCalendarLink(e),r={...e,memo:e.details},a=this.generateTimeTreeLink(r),n=this.generateIcsContent(e);return{google:t,timeTree:a,ics:`data:text/calendar;charset=utf8,${encodeURIComponent(n)}`}}),(0,_defineProperty2.default)(this,"getArrayOfMappingRef",(e,t)=>_lodash.default.map(e,e=>{const r=_lodash.default.find(t,{value:e.value});return r?_lodash.default.merge({},e,r):e})),(0,_defineProperty2.default)(this,"areAllValuesTheSameOnKeys",(e,...t)=>{if(!e||e.length<=1||0===t.length)return!0;for(const r of t){const t=e[0]?.[r];if(!_lodash.default.every(e,e=>e[r]===t))return!1}return!0}),this.init(),this.env="dev"}performActionWithoutTimingIssue(e=()=>!0,t=10){this.syncDelay(t).then(()=>e())}executeTimeoutTask(e,t=1e3,r=this.getRandomHash(),...a){const n=this,i=this.mapOfIdNTimeoutId[r];i&&clearTimeout(i);const o=setTimeout(async(...t)=>{await e(),delete n.mapOfIdNTimeoutId[r]},t,...a);n.mapOfIdNTimeoutId[r]=o}printLogMessage(e,t=!1,...r){this.isProductionEnvironment()||(t?this.appendError(e,...r):this.appendInfo(e,...r))}init(){}setEnvironment(e){this.env=e}appendInfo(...e){this.isProductionEnvironment()}appendError(...e){this.isProductionEnvironment()}async syncDelay(e=2e3){return new Promise(t=>{setTimeout(()=>{t(e)},e)})}startWithRegex(e="",t="."){return new RegExp(`^${t}`,"i").test(e)}accumulate(e,t){let r=e;for(const e of t)void 0!==e&&_lodash.default.isFunction(e)&&(r=e(r));return r}isOrEquals(e,...t){for(const r of t)if(_lodash.default.isEqual(e,r))return!0;return!1}isAndEquals(...e){for(const t of e)if(!t())return!1;return!0}getStringOfHeadMatch(e,t,r="g"){const a=e.match(new RegExp(t,r));return this.isUndefinedNullEmpty(a)?void 0:a[0]}or(...e){for(const t of e)if(_lodash.default.isBoolean(t)&&t)return!0;return!1}and(...e){for(const t of e)if(!t)return!1;return!0}nth(e,t=-1){return _lodash.default.nth(e,t%_lodash.default.size(e))}getExistOne(...e){for(const t of e)if(t)return t}getStringOfDropHeadSign(e,t){return _lodash.default.dropWhile(Array.from(e),e=>_lodash.default.isEqual(e,t)).join("")}isAndWith(e,t,...r){for(const a of r)if(!t(e,a))return!1;return!0}async syncDelayRandom(e=3e3,t=5e3){const r=this.getRandomValue(e,t);return await this.syncDelay(r),r}has(e,t,r=!1){return _lodash.default.isArray(e)?r?_lodash.default.findIndex(e,e=>_lodash.default.isEqual(t,e))>-1:_lodash.default.indexOf(e,t)>-1:_lodash.default.isObject(t)?e[t]:!!_lodash.default.isString(e)&&e.indexOf(t)>-1}containsBy(e,t){return _lodash.default.findIndex(e,e=>_lodash.default.isEqual(e,t))>=0}getStringOfInsideParentheses(e,t="."){return this.getStringOfRule(e,t,"(",")")}getStringOfInsideBrackets(e,t="."){return this.getStringOfRule(e,t,"[","]")}getStringOfInsideBraces(e,t="."){return this.getStringOfRule(e,t,"{","}")}getStringOfRule(e,t=".",r="{",a="}"){return this.getStringOfHeadMatch(e,`(?<=\\${r})${t}+?(?=\\${a})`)}getRandomHash(e=20){const t=_cryptoJs.default.lib.WordArray.random(e);return _cryptoJs.default.enc.Base64.stringify(t).substring(0,e)}getRandomHashV2(e){let t="";for(let r=0;r<e;r++){const e=Math.floor(62*Math.random());t+="ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789".charAt(e)}return t}getEncryptString(e,t=_configerer.configerer.ENCRYPT_KEY,r=!1){if(t.length>22)throw new _exceptioner.default(8010,_lodash.default.size(t));const a=_cryptoJs.default.enc.Base64.parse("thisIsIVWeNeedToGenerateTheSameValue"),n=r?_cryptoJs.default.enc.Base64.parse(`${t}${_lodash.default.range(0,22-t.length).join("")}`):t;return _cryptoJs.default.AES.encrypt(e,n,{iv:a}).toString()}getEncryptStringV2(e,t=_configerer.configerer.ENCRYPT_KEY,r=!1){if(t.length>22)throw new _exceptioner.default(8010,_lodash.default.size(t));const a=_cryptoJs.default.enc.Base64.parse("thisIsIVWeNeedToGenerateTheSameValue"),n=r?_cryptoJs.default.enc.Base64.parse(`${t}${_lodash.default.range(0,22-t.length).join("")}`):t;return _cryptoJs.default.AES.encrypt(JSON.stringify({content:e}),n,{iv:a}).toString()}getDecryptString(e,t=_configerer.configerer.ENCRYPT_KEY){if(t.length>22)throw new _exceptioner.default(8010,_lodash.default.size(t));const r=_cryptoJs.default.enc.Base64.parse("thisIsIVWeNeedToGenerateTheSameValue");try{const a=_cryptoJs.default.AES.decrypt(e,t,{iv:r}).toString(_cryptoJs.default.enc.Utf8);if(!_lodash.default.isEmpty(a.trim()))return a}catch(e){}return _cryptoJs.default.AES.decrypt(e,_cryptoJs.default.enc.Base64.parse(`${t}${_lodash.default.range(0,22-t.length).join("")}`),{iv:r}).toString(_cryptoJs.default.enc.Utf8)}getDecryptStringV2(e,t=_configerer.configerer.ENCRYPT_KEY){if(t.length>22)throw new _exceptioner.default(8010,_lodash.default.size(t));const r=_cryptoJs.default.enc.Base64.parse("thisIsIVWeNeedToGenerateTheSameValue");try{const a=_cryptoJs.default.AES.decrypt(e,t,{iv:r}).toString(_cryptoJs.default.enc.Utf8);if(!_lodash.default.isEmpty(a.trim()))return JSON.parse(a).content}catch(e){}const a=_cryptoJs.default.AES.decrypt(e,_cryptoJs.default.enc.Base64.parse(`${t}${_lodash.default.range(0,22-t.length).join("")}`),{iv:r}).toString(_cryptoJs.default.enc.Utf8);return JSON.parse(a).content}getFirebaseFormattedString(e){return _lodash.default.replace(e,/[\.\#\$\[\]]/g,"-").trim()}formalizeNamesToArray(e){let t=e;for(t=t.split(_configerer.configerer.SEPARATE_TONE_SINGER)[0].trim(),t=_lodash.default.replace(t,/[,\/#!$%\^&\*;:{}=_`、~()（）]/g,"_").trim(),t=this.getFirebaseFormattedString(t),t=_lodash.default.replace(t,/\_\_+/g,"_").trim();_lodash.default.endsWith(t,"_");)t=t.slice(0,-1).trim();const r=t.split("_");return _lodash.default.map(r,e=>_lodash.default.trim(e))}getShuffledArrayWithLimitCountHighPerformance(e,t){let r=new Array(t),a=e.length,n=new Array(a);for(t>a&&(t=a);t--;){let i=Math.floor(Math.random()*a);r[t]=e[i in n?n[i]:i],n[i]=--a in n?n[a]:a}return r}getFileNameFromPath(e,t=!1){const r=e.split("/").pop();return t?r:r.split(".").shift()}getFileNameExtensionFromPath(e){return e.split("/").pop()}getPathOfReplaceLastDir(e,t){const r=e.split("/");return r.pop(),r.push(t),r.join("/")}getExtensionFromPath(e){const t=e.split("/").pop().split(".");return _lodash.default.size(t)>1?t.pop():""}getFolderPathOfSpecificPath(e){const t=e.split("/");return t.pop(),t.join("/")}getFolderNameOfFilePath(e){if(this.isValidFilePath(e)){const t=e.split("/");return _lodash.default.nth(t,-2)}throw new _exceptioner.default(9999,`64255615 path is not valid '${e}'`)}isUnderTargetPath(e,t){const r=e.split("/");return this.has(r,t)}getFileDirPath(e,t=!0){return _lodash.default.join(_lodash.default.initial(_lodash.default.split(e,"/")),"/")+(t?"/":"")}isPathEqualsFileType(e,t){const r=e.split(".").pop();return _lodash.default.isEqual(r,t)}isValidFilePath(e){const t=this.getExtensionFromPath(e);return _lodash.default.size(t)>0}getArrayOfSize(e,t=1){return _lodash.default.take(e,t)}getShuffledArrayWithLimitCount(e,t){return this.getShuffledArrayWithLimitCountHighPerformance(e,t)}getRandomItemOfArray(e,...t){if(!_lodash.default.isArray(e))throw new _exceptioner.default(9999,`why are you so stupid, typeof array should be array, not ==> ${e} `);const r=_lodash.default.without(e,...t),a=_lodash.default.size(r)>0?r:e,n=this.getShuffledArrayWithLimitCount(a,1);return n.length>0?n[0]:void 0}appendMapOfKeyArray(e,t,...r){this.isUndefinedNullEmpty(e[t])?e[t]=[...r]:e[t].push(...r)}getMergedArrayBy(e=[],t=[],r){if(!r||0===e.length||0===t.length)return[...e];const a=new Map(t.map(e=>[e[r],e]));return e.map(e=>({...a.get(e[r])||{},...e}))}getShuffledItemFromArray(e){return _lodash.default.shuffle(e)[0]}getShuffledArray(e){return _lodash.default.shuffle(e)}isJson(e){e="string"!=typeof e?JSON.stringify(e):e;try{e=JSON.parse(e)}catch(e){return!1}return"object"==typeof e&&null!==e}getObjectValue(e){return _lodash.default.isObject(e)?Object.values(e)[0]:""}getObject(e,t){const r={};return r[e]=t,r}getStringOfCreditCardFormatted(e=0){return e.replace(/\D/g,"").replace(/(\d{4})(?=\d)/g,"$1-").slice(0,19)}getObjectKey(e){return _lodash.default.isObject(e)?Object.keys(e)[0]:""}printf(){this.appendInfo("i can use in web || react.js")}isKeywordRule(e){if(_lodash.default.isUndefined(e)||_lodash.default.isEmpty(e))throw new Error("PARAMS CAN NOT BE EMPTY");if(!_lodash.default.isString(e))throw new Error("PARAMS SHOULD BE STRING");if(e.length>20)throw new Error("EXCEED 20 WORDS IS NOT ALLOWED")}getItsKeyByValue(e,t){return Object.keys(e).find(r=>e[r]===t)}startWiths(e,t=[]){for(const r of t)if(_lodash.default.startsWith(e,r))return!0;return!1}replaceAll(e,t,r){return _lodash.default.replace(e,new RegExp(`${t}`,"g"),r)}replaceAllWithSets(e="",...t){let r=e;for(const e of t){if(this.isOrEquals(void 0,e.from,e.to))throw(0,_exceptioner.default)(9999,"from or to can't be empty");r=this.replaceAll(r,e.from,e.to)}return r}replaceArrayByContentIndex(e,t,r){e[_lodash.default.indexOf(e,t)]=r}deepFlat(e,t="_"){let r="";const a=[[e,""]];for(;a.length>0;){const[e,n]=a.pop();if(_lodash.default.isArray(e))for(let t=e.length-1;t>=0;t--)a.push([e[t],n]);else if(_lodash.default.isObject(e)){const r=Object.keys(e);for(let i=r.length-1;i>=0;i--){const o=r[i];a.push([e[o],n+o+t])}}else{const a=_lodash.default.trim(String(e));a.length>0?r+=(r.length>0?t:"")+n+a:n.length>0&&r.length>0?r+=t:n.length>0&&0===r.length&&(r+=n.endsWith(t)?n.slice(0,-t.length):n)}}return r.endsWith(t)&&(r=r.slice(0,-t.length)),r}joinEscapeChar(e){return(e+"").replace(/[\\"']/g,"\\$&").replace(/\u0000/g,"\\0")}getValueWithIntegerType(e){try{const t=parseInt(e);return isNaN(t)?0:t}catch(e){return 0}}getValueOfPriority(...e){for(const t of e)if(!this.isUndefinedNullEmpty(t))return t}async asyncPool(e,t,r){const a=[],n=[];for(const i of t){const o=Promise.resolve().then(()=>r(i,t));if(a.push(o),e<=t.length){const t=o.then(()=>n.splice(n.indexOf(t),1));n.push(t),n.length>=e&&await Promise.race(n)}}return Promise.all(a)}getAttrValueInSequence(e,...t){for(const r of t)if(!_lodash.default.isEmpty(e[r]))return e[r];return e}toDBC(e){for(var t="",r=0;r<e.length;r++)32===e.charCodeAt(r)&&(t+=String.fromCharCode(12288)),e.charCodeAt(r)<127&&(t+=String.fromCharCode(e.charCodeAt(r)+65248));return t}toCDB(e){for(var t="",r=0;r<e.length;r++)12288!==e.charCodeAt(r)?e.charCodeAt(r)>65280&&e.charCodeAt(r)<65375?t+=String.fromCharCode(e.charCodeAt(r)-65248):t+=String.fromCharCode(e.charCodeAt(r)):t+=String.fromCharCode(e.charCodeAt(r)-12256);return t}findIndexes(e,t){const r=[];let a=!0,n=0;for(;a;)n=_lodash.default.findIndex(e,t,n+1),n>-1?r.push(n):a=!1;return r}getSliceArrayOfSpecificIndexes(e,...t){const r=[],a=_lodash.default.size(e);for(const n of t){if(!_lodash.default.isNumber(n))throw new _exceptioner.default(9999,`59941278 index should be number => ${n}, ${e}`);if(n>a-1)throw new _exceptioner.default(9999,`5994123 index=>${n} is not valid, exceed than array size=${a}, ${e}`);r.push(_lodash.default.nth(e,n))}return r}indexesOf(e,t){const r=[];let a=-1;for(;-1!==(a=e.indexOf(t,a+1));)r.push(a);return r}getIndexOfContext(e,t){return _lodash.default.findIndex(e,e=>_lodash.default.isEqual(e.trim(),t))}toOneLineString(e){return _lodash.default.join(_lodash.default.split(e,"\n"),"")}toSpaceLessString(e){return _lodash.default.split(e,"").map(e=>_lodash.default.trim(e)).join("")}toNewLineLessString(e){return _lodash.default.split(e,"\n").map(e=>_lodash.default.trim(e)).join("")}exist(e){return!_lodash.default.isNull(e)&&!_lodash.default.isUndefined(e)}isUndefinedNullEmpty(e){const t=null==e,r=!!(_lodash.default.isString(e)||_lodash.default.isArray(e)||_lodash.default.isObject(e))&&_lodash.default.isEmpty(e);return t||r}isAndConditionOfUndefinedNullEmpty(...e){for(const t of e)if(!this.isUndefinedNullEmpty(t))return!1;return!0}isOrConditionOfUndefinedNullEmpty(...e){for(const t of e)if(this.isUndefinedNullEmpty(t))return!0;return!1}getStringHandledByEachLine(e,t=(e,t,r)=>!0,r="\n"){const a=e.split(r);for(const e of a)t(e,_lodash.default.indexOf(a,e),a);return a.join(r)}getSegmentsOfEachLine(e){return e.split("\n")}getNormalizedStringEndWith(e,t){e=this.toCDB(e),t=this.toCDB(t);const r=_lodash.default.join(_lodash.default.dropRightWhile(e,e=>!_lodash.default.isEqual(e,t)),"");return _lodash.default.isEmpty(r)?e:r}getNormalizedStringNotStartWith(e,...t){e=this.toCDB(e);const r=_lodash.default.join(_lodash.default.dropWhile(e,e=>this.has(t,e)),"");return _lodash.default.isEmpty(r)?e:r}getNormalizedStringNotEndWith(e,...t){e=this.toCDB(e);const r=_lodash.default.join(_lodash.default.dropRightWhile(e,e=>this.has(t,e)),"");return _lodash.default.isEmpty(r)?e:r}getTodayTimeFormat(e){return(0,_momentTimezone.default)(e||this.getCurrentTimeStamp()).format("YYYY-MM-DD")}getCustomFormatOfDatePresent(e,t="YY/MM"){return(0,_momentTimezone.default)(e||this.getCurrentTimeStamp()).format(t)}getSimpleDateYYMMDDFormat(e){return(0,_momentTimezone.default)(e||this.getCurrentTimeStamp()).format("YY/MM/DD")}getSimpleTimeYYMMDDHHmmFormat(e){return(0,_momentTimezone.default)(e||this.getCurrentTimeStamp()).format("YY/MM/DD HH:mm")}getECPayCurrentTimeFormat(e){return(0,_momentTimezone.default)(e||this.getCurrentTimeStamp()).format("YYYY/MM/DD HH:mm:ss")}getCurrentTimeFormatV2(e){return(0,_momentTimezone.default)(e||this.getCurrentTimeStamp()).format("YYYY/MM/DD HH:mm:ss")}getCurrentTimeFormatYMDHM(e){return(0,_momentTimezone.default)(e||this.getCurrentTimeStamp()).format("YYYY/MM/DD HH:mm")}getCurrentTimeFormatYMDHMS(e){return(0,_momentTimezone.default)(e||this.getCurrentTimeStamp()).format("YYYY/MM/DD HH:mm:ss")}getCurrentTimeFormat(e){return(0,_momentTimezone.default)(e||this.getCurrentTimeStamp()).format("YYYY-MM-DD-HH-mm-ss")}getCurrentMillionSecTimeFormat(e){return(0,_momentTimezone.default)(e||void 0).format("YYYY-MM-DD-HH-mm-ss-SSS")}isBetweenTimeStamp(e=this.getCurrentTimeStamp(),t,r){return(0,_momentTimezone.default)(e).isBetween(t,r)}isBeforeTimeStamp(e=this.getCurrentTimeStamp(),t){return(0,_momentTimezone.default)(e).isBefore(t)}isAfterTimeStamp(e=this.getCurrentTimeStamp(),t){return(0,_momentTimezone.default)(e).isAfter(t)}formatTimeByLocale(e,t="zh-TW",r="Asia/Taipei",a=!0){_momentTimezone.default.locale(t);const n=a?"YYYY/MM/DD HH:mm":"YYYY/MM/DD hh:mm A";return(0,_momentTimezone.default)(e).tz(r).format(n)}getTimeStampWithConditions(e={days:0,months:0,years:0,minutes:0,seconds:0,hours:0},t=this.getCurrentTimeStamp()){let r=(0,_momentTimezone.default)(t);for(const t in e){const a=e[t],n=t;a>0&&(r=r.add(a,n)),a<0&&(r=r.subtract(Math.abs(a),n))}return r.valueOf()}getTimeStampByStringFormat(e){return this.getTimeStampFromSpecificFormat(e,"YYYY/MM/DD HH:mm:ss").valueOf()}getTimeStampFromSpecificFormat(e,t="YYYY/MM/DD HH:mm:ss"){return(0,_momentTimezone.default)(e,t).valueOf()}getTimeStampFromECPayStringFormat(e){return this.getTimeStampFromSpecificFormat(e,"YYYY/MM/DD HH:mm:ss").valueOf()}getTimeFormatOfDurationToMillionSecond(e){return _momentTimezone.default.utc(e).format("HH小時mm分鐘ss秒SSS")}getTimeFormatOfDurationToSecond(e){return _momentTimezone.default.utc(e).format("HH小時mm分鐘ss秒")}getTimeFormatOfDurationToDay(e){return _momentTimezone.default.utc(e).format("DD天HH小時mm分鐘ss秒")}getChineseTimeFormat(e){return _momentTimezone.default.locale("zh-TW"),(0,_momentTimezone.default)(e).format("LLLL")}getMinuteFormatOfDuration(e){return _momentTimezone.default.duration(e).asMinutes()}getSecondFormatOfDuration(e){return _momentTimezone.default.duration(e).asSeconds()}getDayFormatOfDuration(e){return _momentTimezone.default.duration(e).asDays()}getDurationOfMillionSec(e){const t=this.getCurrentTimeStamp(),r=(0,_momentTimezone.default)(e).valueOf(),a=_lodash.default.sortBy([{ts:t},{ts:r}],e=>e.ts).map(e=>e.ts);let n=(0,_momentTimezone.default)(a.pop()),i=(0,_momentTimezone.default)(a.shift());return _momentTimezone.default.duration(n.diff(i)).asMilliseconds()}getCurrentTimeStamp(){return(0,_momentTimezone.default)().valueOf()}isStringContainInLines(e,t){for(let r of _lodash.default.split(e,"\n"))if(this.has(r,t))return!0;return!1}camel(...e){return _lodash.default.camelCase(e.join("_"))}upperCamel(...e){return _lodash.default.upperFirst(this.camel(...e))}array2Obj(e){const t={};for(const r of e)t[`${this.getObjectKey(r)}`]=this.getObjectValue(r);return t}arrayToObjWith(e,t){const r={};for(const a of e){const e=t(a),n=r[e];n&&_lodash.default.isArray(n)?n.push(a):r[e]=[a]}return r}isEmptyString(e){return _lodash.default.isEqual(_lodash.default.trim(e),"")}mergeObject(...e){return _lodash.default.merge(...e)}syncSetTimeout(e,t,r=()=>{}){!function a(n){n?r():setTimeout(function(){e(),a(!0)},t)}()}mergeArrayBy(e="id",...t){return Object.values(t.flat().reduce((t,r)=>(r[e]&&(t[r[e]]={...t[r[e]]||{},...r}),t),{}))}getRelativePath(e,t){return _lodash.default.dropWhile(e,(e,r)=>_lodash.default.isEqual(e,t[r])).join("")}dropItemsByIndex(e,t,r){_lodash.default.remove(e,(e,a,n)=>r>=a&&a>=t)}isEven(e){return e%2==0}isOdd(e){return 1===Math.abs(e%2)}enrichZhTw(){_momentTimezone.default.locale("zh-tw",{months:"一月_二月_三月_四月_五月_六月_七月_八月_九月_十月_十一月_十二月".split("_"),monthsShort:"1月_2月_3月_4月_5月_6月_7月_8月_9月_10月_11月_12月".split("_"),weekdays:"星期日_星期一_星期二_星期三_星期四_星期五_星期六".split("_"),weekdaysShort:"周日_周一_周二_周三_周四_周五_周六".split("_"),weekdaysMin:"日_一_二_三_四_五_六".split("_"),longDateFormat:{LT:"Ah點mm分",LTS:"Ah點m分s秒",L:"YYYY-MM-DD",LL:"YYYY年MMMD日",LLL:"YYYY年MMMD日Ah點mm分",LLLL:"YYYY年MMMD日ddddAh點mm分",l:"YYYY-MM-DD",ll:"YYYY年MMMD日",lll:"YYYY年MMMD日Ah點mm分",llll:"YYYY年MMMD日ddddAh點mm分"},meridiemParse:/凌晨|早上|上午|中午|下午|晚上/,meridiemHour:function(e,t){let r=e;return 12===r&&(r=0),"凌晨"===t||"早上"===t||"上午"===t?r:"下午"===t||"晚上"===t?r+12:r>=11?r:r+12},meridiem:function(e,t,r){const a=100*e+t;return a<600?"凌晨":a<900?"早上":a<1130?"上午":a<1230?"中午":a<1800?"下午":"晚上"},calendar:{sameDay:function(){return 0===this.minutes()?"[今天]Ah[點整]":"[今天]LT"},nextDay:function(){return 0===this.minutes()?"[明天]Ah[點整]":"[明天]LT"},lastDay:function(){return 0===this.minutes()?"[昨天]Ah[點整]":"[昨天]LT"},nextWeek:function(){let e,t;return e=(0,_momentTimezone.default)().startOf("week"),t=this.diff(e,"days")>=7?"[下]":"[本]",0===this.minutes()?t+"dddA點整":t+"dddAh點mm"},lastWeek:function(){let e,t;return e=(0,_momentTimezone.default)().startOf("week"),t=this.unix()<e.unix()?"[上]":"[本]",0===this.minutes()?t+"dddAh點整":t+"dddAh點mm"},sameElse:"LL"},ordinalParse:/\d{1,2}(日|月|周)/,ordinal:function(e,t){switch(t){case"d":case"D":case"DDD":return e+"日";case"M":return e+"月";case"w":case"W":return e+"周";default:return e}},relativeTime:{future:"%s内",past:"%s前",s:"幾秒",m:"1 分鐘",mm:"%d 分鐘",h:"1 小時",hh:"%d 小時",d:"1 天",dd:"%d 天",M:"1 個月",MM:"%d 个月",y:"1 年",yy:"%d 年"},week:{dow:1,doy:4}})}getVisibleOrHidden(e){return{visibility:e?"visible":"hidden"}}getNumberOfPercentageToFloat(e){let t=e.replace("%","");return parseFloat(t)/100}getVisibleOrNone(e,t=!1){return{display:e?t?"flex":"inherit":"none"}}stringToInteger(e){switch(e=_lodash.default.toUpper(e)){case"A":return 0;case"B":return 1;case"C":return 2;case"D":return 3;case"E":return 4;case"F":return 5;case"G":return 6;case"H":return 7;case"I":return 8;case"J":return 9;case"K":return 10;case"L":return 11;case"M":return 12;case"N":return 13;default:return 101}}integerToString(e){switch(e){case 0:return"A";case 1:return"B";case 2:return"C";case 3:return"D";case 4:return"E";case 5:return"F";case 6:return"G";case 7:return"H";case 8:return"I";case 9:return"J";case 10:return"K";case 11:return"L";case 12:return"M";case 13:return"N";default:return"Z"}}toObjectMap(e,...t){const r=[];for(const a of e){const e={};for(const r of t){const t=r.func?r.func:e=>e;e[r.to]=this.isUndefinedNullEmpty(r.from)||!_lodash.default.isObject(a)?t(a):t(a[r.from])}r.push(e)}return r}exeAll(e,...t){if(_lodash.default.isArray(e))for(const r of e)for(const e of t)e(r);else{if(!_lodash.default.isObject(e))throw new _exceptioner.default(9999,"7841212 type can't be array or object");for(const r in e)for(const a of t)e[r]=a(e[r])}return e}getObjectWhile(e,t,r=e=>!0){const a={};for(const n in e)r(e,t,n)&&(a[n]=e[n]);return a}getIntersectionObject(e,t){return this.getObjectWhile(e,t,(e,t,r)=>void 0!==t[r])}getDifferenceObject(e,t){return this.getObjectWhile(e,t,(e,t,r)=>void 0===t[r])}isObjectContainAndEqual(e,t){let r=!0;for(const a in e)if(void 0===t[a]||t[a]!==e[a]){r=!1;break}return r}getStringOfPop(e,t){if(!_lodash.default.isString(e))throw new _exceptioner.default(9999,"445115,type should be string but ==> "+typeof e);const r=e.split(t);return r.pop(),r.join(t)}getStringOfShift(e,t){if(!_lodash.default.isString(e))throw new _exceptioner.default(9999,"445116,type should be string but ==> "+typeof e);const r=e.split(t);return r.shift(),r.join(t)}toObjectWithAttributeKey(e,t){const r={};for(const a of e){const e=a[t];if(this.isUndefinedNullEmpty(e))throw new _exceptioner.default(9999,`48157232 pk can't be empty => '${e}'`);r[e]=a}return r}getObjectOfArraySpecifyAttr(e,t){return this.toObjectWithAttributeKey(e,t)}getStateOfStringContainsSign(e,...t){for(const r of t)if(this.has(e,r))return{exists:!0,sign:r};return{exists:!1}}constraintOfParam(e,t,...r){let a=!1;const n=!!_lodash.default.isEmpty(r)||this.and(...r.map(e=>e.logic));switch(t){case"array":_lodash.default.isArray(e)&&n&&(a=!0);break;case"object":_lodash.default.isObject(e)&&n&&(a=!0);break;case"string":_lodash.default.isString(e)&&n&&(a=!0);break;case"number":_lodash.default.isNumber(e)&&n&&(a=!0);break;case"other":if(n)return!0}const i=_lodash.default.isEmpty(r)?"":`, ${r.map(e=>e.message).join(" | ")}`;if(!1===a)throw new _exceptioner.default(9999,`7474423 type should be ${t} but get '${typeof t}' ${i} `)}getSliceArrayWithMutate(e,t){return _lodash.default.remove(e,(e,r)=>r<t)}getArrayOfInteraction(e,t){return e.filter(e=>!t.includes(e))}getArrayOfMoveToSpecificIndex(e,t,r){if(!Array.isArray(e))throw new Error("First argument must be an array.");const a=e.length;if(t<0||t>=a||r<0||r>=a)return[...e];if(t===r)return[...e];const n=[...e],[i]=n.splice(t,1);return n.splice(r,0,i),n}getArrayOfMoveItemToSpecificIndex(e,t,r){const a=_lodash.default.indexOf(e,t);return this.getArrayOfMoveToSpecificIndex(e,a,r)}getArrayOfMoveSpecificItemToAside(e,t,r=!0){const a=_lodash.default.indexOf(e,t);return this.getArrayOfMoveSpecificIndexToAside(e,a,r)}getArrayOfMoveSpecificIndexToAside(e,t,r=!0){const a=_lodash.default.size(e)-1;return this.getArrayOfMoveToSpecificIndex(e,t,r?a:0)}getECPayCheckMacValue(e,t="5294y06JbISpM5x9",r="v77hoKGq4kWxNNIS"){const a=_lodash.default.cloneDeep(e);delete a.CheckMacValue;const n=Object.keys(a).sort((e,t)=>e>t?1:-1);let i="";for(const e of n)i+=`${e}=${a[e]}&`;return i=`HashKey=${t}&${i}HashIV=${r}`,i=encodeURIComponent(i).toLowerCase(),i=i.replace(/%20/g,"+").replace(/%2d/g,"-").replace(/%5f/g,"_").replace(/%2e/g,".").replace(/%21/g,"!").replace(/%2a/g,"*").replace(/%28/g,"(").replace(/%29/g,")").replace(/%20/g,"+"),_lodash.default.toUpper(_cryptoJs.default.SHA256(i).toString(_cryptoJs.default.enc.Hex))}getStringOfHandledHtml(e,t=e=>{}){const r=(0,_nodeHtmlParser.parse)(e);return t(r),r.toString()}getSpecifyObjectBy(e,t){for(const r of e)if(t(r))return r}validatePayloadObjectValid(e,t=[],r=this.getRandomHash(10)){if(this.isUndefinedNullEmpty(e))throw new _exceptioner.default(9999,`${r} content(pay-load) is undefined || empty`);for(const a of t)if(_lodash.default.isString(a)){if(this.isUndefinedNullEmpty(e[a]))throw new _exceptioner.default(9999,`${r} ATTRIBUTE:'${a}' is not Exist`)}else if(_lodash.default.isObject(a)){const t=this.getObjectKey(a);if(!this.getObjectValue(a)(e[t]))throw new _exceptioner.default(9999,`${r} ATTRIBUTE:'${t}' is not valid of custom rule`)}return!0}getArrayOfSummarizeBy(e,t,r){const a={};for(const n of e){const e=n[t];void 0!==a[e]?a[e]=a[e]+n[r]:a[e]=n[r]}const n=[];for(const e in a){const i={};i[t]=e,i[r]=a[e],n.push(i)}return n}getHeadStringSplitBy(e,t=this.getSeparatorOfUnique()){return _lodash.default.split(e,t).shift()}getTailStringSplitBy(e,t=this.getSeparatorOfUnique()){return _lodash.default.split(e,t).pop()}getSlicesByIndexes(e=[],t=[]){const r=[];return _lodash.default.each(t,(a,n,i)=>{if(_lodash.default.isEqual(n,t.length-1))return!1;const o=_lodash.default.slice(e,a,t[n+1]);r.push(o)}),r}findIndexes(e,t){const r=[];let a=!0,n=0;for(;a;)n=_lodash.default.findIndex(e,t,n+1),n>-1?r.push(n):a=!1;return r}isOverSpecificAge(e,t=18){return(0,_momentTimezone.default)().diff((0,_momentTimezone.default)(e,"YYYY-MM-DD"),"years")>=t}isValidEmail(e){return/^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(e)}isValidTaiwaneseID(e){if(!/^[A-Z][1-2]\d{8}$/.test(e))return!1;const t=[1,9,8,7,6,5,4,3,2,1];let r=10*(e.charCodeAt(0)-65)+parseInt(e.slice(1));for(let a=0;a<t.length;a++)r+=parseInt(e.charAt(a+1))*t[a];return r%10==0}validatePersonalInfoInput(e,t,r,a,n,i=12){return e.length<2?{valid:!1,message:"姓名至少要兩個字"}:/^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(t)?/^[A-Z][1-2]\d{8}$/.test(r)?/^09\d{8}$/.test(a)?this.isUndefinedNullEmpty(n)?{valid:!1,message:"出生日期格式不正確"}:(0,_momentTimezone.default)().diff(n,"years")<i?{valid:!1,message:`年齡不得小於 ${i} 歲`}:{valid:!0,message:"格式檢查通過"}:{valid:!1,message:"手機號碼格式不正確"}:{valid:!1,message:"身分證號碼格式不正確"}:{valid:!1,message:"電子郵件格式不正確"}}getStringOfFormatTimestampRange(e,t){const r=(0,_momentTimezone.default)(e),a=(0,_momentTimezone.default)(t),n=e=>e.format("YY/MM/DD");return r.year()===a.year()?`${n(r)} - ${a.format("MM/DD")}`:`${n(r)} - ${n(a)}`}getStringOfCalculateClassTime(e,t,r){const a=(0,_momentTimezone.default)(e),n=(0,_momentTimezone.default)(t).diff(a,"days")+1,i=Math.ceil(n/7)*r,o=Math.floor(i/60),s=i%60;return 0===s?`${o}小時`:`${o}小時${s}分鐘`}getNumberOfPeriodMinute(e,t){const r=(0,_momentTimezone.default)(e).format("HH:mm"),a=(0,_momentTimezone.default)(t).format("HH:mm"),n=(0,_momentTimezone.default)(r,"HH:mm"),i=(0,_momentTimezone.default)(a,"HH:mm");return _momentTimezone.default.duration(i.diff(n)).asMinutes()}getStringOfWeekTime(e,t,r){if(e<1||e>7)throw new Error("day 必須在 1 到 7 之間");const a=(0,_momentTimezone.default)(t).format("HH:mm"),n=(0,_momentTimezone.default)(r).format("HH:mm");return`${{1:"週一",2:"週二",3:"週三",4:"週四",5:"週五",6:"週六",7:"週日"}[e]} ${a}-${n}`}extractNumber(e){if(this.isUndefinedNullEmpty(e))return-1;const t=e.match(/\d+/);return t?Number(t[0]):-1}async fetchElementAttribute(e,t="innerText",r=""){return await e.evaluate(e=>e[t])}async fetchElementAttributes(e,t,r="",...a){const n=await e.$(t);if(!this.isUndefinedNullEmpty(n))try{return await n.evaluate((e,t)=>1===t.length?e[t.shift()]:{...t.map(t=>e[t])},a)}catch(e){return this.appendError(`1581532 ${t} fetch ${JSON.stringify(a)} fail, element is not found`),r}return r}async writeElementAttributes(e,t,...r){const a=await e.$(t);this.isUndefinedNullEmpty(a)?this.appendError(`1231232 ${t} fetch ${JSON.stringify(r)} fail, element is not found`):await a.evaluate((e,t)=>{t.map(t=>{const r=Object.entries(t),a=r[0][0],n=r[0][1];e[a]=n})},r)}getSliceArrayOfUnique(e){if(!Array.isArray(e)||0===e.length)return[];const t=e[0];if(_lodash.default.isObject(t)&&key){const t=new Map(e.map(e=>[e[key],e]));return Array.from(t.values())}return _lodash.default.isObject(t)?_lodash.default.uniqWith(e,_lodash.default.isEqual):Array.from(new Set(e))}getUniqueValuesBy(e,t="valueOfType"){return _lodash.default.uniq(e.map(e=>e[t]))}generateCombinations(...e){const t=e.map(e=>e.key),r=(_lodash.default.keyBy(e,"key"),e.map(e=>e.options.map(t=>({key:e.key,value:t.value,label:t.label})))),a=_lodash.default.reduce(r,(e,t)=>_lodash.default.flatMap(e,e=>t.map(t=>[...e,t])),[[]]).map(e=>{const t={},r=[],a=[];for(const{key:n,value:i,label:o}of e)t[n]=i,r.push(`${n}_${i}`),a.push(`${o}`);return{trait:t,id:r.join("_"),content:a.join("｜")}});return _lodash.default.sortBy(a,e=>t.map(t=>e.trait[t]))}extractStaticSegments(e,t=[":"]){return e.trim().replace(/^\.?\/*|\/*$/g,"").split("/").filter(e=>e&&!t.some(t=>e.startsWith(t)))}mutateRemoveKeys(e,t){_lodash.default.forEach(e,(e,r)=>{const a=Object.fromEntries(Object.entries(e).filter(([e])=>!t.includes(e)));Object.keys(e).forEach(t=>delete e[t]),Object.assign(e,a)})}removeKeysFromArrayObjects(e,t){return _lodash.default.map(e,e=>Object.fromEntries(Object.entries(e).filter(([e])=>!t.includes(e))))}formatTextWithEllipsis(e,t){if(_lodash.default.size(e)<=t)return e;if(t<=6)return"";const r=t-6,a=Math.floor(r/2),n=r-a;return`${_lodash.default.truncate(e,{length:a,omission:""})}......${_lodash.default.takeRight(e,n).join("")}`}getObjectBy(e,t=e=>!0!==e.checked){return _lodash.default.fromPairs(_lodash.default.toPairs(e).filter(([e,r])=>t(r)))}mutateBy(e,t=e=>e){const r=_lodash.default.sortBy(e,t);e.splice(0,e.length,...r)}findUniqueStrings(...e){const t=_lodash.default.flatten(e),r=_lodash.default.countBy(t);return _lodash.default.chain(r).pickBy(e=>1===e).keys().compact().value()}getObjectOfSpecifyKey(e,t){const r={};return r[t]=e,r}findUniqueNonReferenceStrings(...e){if(0===e.length)return[];const[t,...r]=e,a=_lodash.default.flatten(r),n=_lodash.default.countBy(a);return _lodash.default.chain(n).pickBy((e,r)=>1===e&&!t.includes(r)).keys().compact().value()}getArrayOfFillMissingValues(e){const t=()=>_lodash.default.times(8,()=>_lodash.default.sample("abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789")).join(""),r=new Set(e.map(e=>e.value).filter(Boolean));return e.map(e=>{if(_lodash.default.isEmpty(e.value)){let a;do{a=t()}while(r.has(a));return r.add(a),{...e,value:a}}return e})}isFirestoreAutoId(e){return _lodash.default.isString(e)&&20===e.length&&/^[A-Za-z0-9]{20}$/.test(e)}getAutoIdOfFirestore(){return this.getRandomHashV2(20)}getStringOfConvertTimeRange(e){const[t,r]=e.split("｜"),a=t.split("(")[0],[n,i]=r.split("-"),o=e=>(0,_momentTimezone.default)(`${a} ${e}`,"YYYY/MM/DD HH:mm").format("YYYYMMDDHHmm");return`${o(n)}-${o(i)}`}getTSOfSpecificDate(e,{end:t=!1}={}){return Number((0,_lodash.default)(e).thru(e=>(0,_momentTimezone.default)(e.split("(")[0],"YYYY/MM/DD")).thru(e=>t?e.endOf("day"):e.startOf("day")).value().format("YYYYMMDDHHmmss"))}isHttpsURL(e){if(!_lodash.default.isString(e))return!1;try{const t=decodeURIComponent(e.trim());return"https:"===new URL(t).protocol}catch(e){return!1}}generateUniqueCodeMap(e,t=3){if(t<2)throw new Error("代碼長度最少必須為 2。");const r=new Set,a=new Set;return _lodash.default.transform(e,(e,n)=>{if(a.has(n))throw new Error(`23125453 Duplicate key detected: "${n}"`);a.add(n),e[n]=(()=>{const e="abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ",a=e+"0123456789";let n;do{n=e[Math.floor(52*Math.random())];for(let e=1;e<t;e++)n+=a[Math.floor(62*Math.random())]}while(r.has(n));return r.add(n),n})()},{})}getPriceOfPercentageBehavior(e,t,r=!1){const a=this.toPercentageDecimal(t);return this.getNumberOfMultiplyCeil(e,r?1-a:1+a)}getFeeOfDiscount(e,t){return Math.round(_lodash.default.multiply(e,this.toPercentageDecimal(t)))}mergeArrayByKey(e){if(!Array.isArray(e))return e;const t={};for(const r of e)if(_lodash.default.isPlainObject(r))for(const[e,a]of Object.entries(r))t[e]?_lodash.default.merge(t[e],a):t[e]=_lodash.default.cloneDeep(a);return e.length=0,Object.entries(t).forEach(([t,r])=>{e.push({[t]:r})}),e}getObjectOfStartEndDateTime(e){if(!e||"string"!=typeof e)return{startDate:"",startTime:"",endDate:"",endTime:""};const t=e.replace(/｜/g," ").replace(/－/g,"-").replace(/\s+/g," ").trim(),r=/(\d{4}\/\d{1,2}\/\d{1,2})(?:\s*\([^)]*\))?\s*(\d{2}:\d{2})\s*-\s*(\d{4}\/\d{1,2}\/\d{1,2})(?:\s*\([^)]*\))?\s*(\d{2}:\d{2})/,a=/(\d{4}\/\d{1,2}\/\d{1,2})(?:\s*\([^)]*\))?\s*(\d{2}:\d{2})\s*-\s*(\d{2}:\d{2})/;let n,i,o,s;if(r.test(t))[,n,i,o,s]=t.match(r);else{if(!a.test(t))return{startDate:"",startTime:"",endDate:"",endTime:""};[,n,i,s]=t.match(a),o=n}const l=new Date(`${n} ${i}`);if(new Date(`${o} ${s}`)<l)throw new Error(`End time cannot be earlier than start time: ${e}`);return{startDate:n,startTime:i,endDate:o,endTime:s}}getFilteredHeraPeriods(e,t){return _lodash.default.chain(e).filter(e=>e.idOfBooze!==t).uniqBy(e=>`${e.idOfBooze}_${e.idOfVariant}`).value()}checkPeriodConflict(e,t,r=1){const[a,n]=e.content.split("｜"),i=(0,_momentTimezone.default)(a.split(" ")[0],"YYYY/MM/DD"),[o,s]=n.split("-"),l=(0,_momentTimezone.default)(`${i.format("YYYY/MM/DD")} ${o}`,"YYYY/MM/DD HH:mm"),u=(0,_momentTimezone.default)(`${i.format("YYYY/MM/DD")} ${s}`,"YYYY/MM/DD HH:mm"),d=_lodash.default.filter(t,e=>{const[t,r]=e.period.split("-"),a=(0,_momentTimezone.default)(t,"YYYYMMDDHHmm"),n=(0,_momentTimezone.default)(r,"YYYYMMDDHHmm");return l.isBefore(n)&&u.isAfter(a)});return{conflict:d.length>=r,items:d}}}var _default=exports.default=Utiller;