utiller 1.0.346 → 1.0.348

package/lib/utiller/index.js

@@ -6,7 +6,6 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports["default"] = void 0;
 var _regenerator = _interopRequireDefault(require("@babel/runtime/regenerator"));
-var _toArray2 = _interopRequireDefault(require("@babel/runtime/helpers/toArray"));
 var _slicedToArray2 = _interopRequireDefault(require("@babel/runtime/helpers/slicedToArray"));
 var _typeof2 = _interopRequireDefault(require("@babel/runtime/helpers/typeof"));
 var _toConsumableArray2 = _interopRequireDefault(require("@babel/runtime/helpers/toConsumableArray"));
@@ -352,25 +351,6 @@ var Utiller = /*#__PURE__*/function () {
       cloned.splice(targetIndex, 0, object);
       return cloned;
     });
-    /**
-     * 編碼成 Firestore-safe UID（Base64 URL 安全版，可還原）
-     */
-    (0, _defineProperty2["default"])(this, "encodeToUid", function (str) {
-      var utf8Bytes = new TextEncoder().encode(str);
-      var base64 = btoa(String.fromCharCode.apply(String, (0, _toConsumableArray2["default"])(utf8Bytes)));
-      return base64.replace(/\+/g, "-").replace(/\//g, "_").replace(/=+$/, "");
-    });
-    /**
-     * 解碼 UID 回原始組合
-     */
-    (0, _defineProperty2["default"])(this, "decodeFromUid", function (uid) {
-      var base64 = uid.replace(/-/g, "+").replace(/_/g, "/");
-      var binary = atob(base64);
-      var bytes = Uint8Array.from(binary, function (c) {
-        return c.charCodeAt(0);
-      });
-      return new TextDecoder().decode(bytes);
-    });
     /**
      * const origin = [
      *   { label: 'aa', value: 1203 },
@@ -506,10 +486,31 @@ var Utiller = /*#__PURE__*/function () {
      *   { 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", function (arrays) {
       var labelSeparator = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : "｜";
       var valueSeparator = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : "-";
-      var combinations = _lodash["default"].reduce(arrays, function (acc, curr) {
+      // 過濾掉空陣列
+      var nonEmptyArrays = arrays.filter(function (arr) {
+        return arr.length > 0;
+      });
+      if (nonEmptyArrays.length === 0) return [];
+      if (nonEmptyArrays.length === 1) {
+        // 若只有一個非空陣列，回傳它（每項轉為 {label, value} 格式）
+        return nonEmptyArrays[0].map(function (item) {
+          return {
+            label: item.label,
+            value: item.value
+          };
+        });
+      }
+      var combinations = _lodash["default"].reduce(nonEmptyArrays, function (acc, curr) {
         return _lodash["default"].flatMap(acc, function (a) {
           return curr.map(function (b) {
             return [].concat((0, _toConsumableArray2["default"])(a), [b]);
@@ -562,6 +563,37 @@ var Utiller = /*#__PURE__*/function () {
         });
       });
     });
+    /**
+     * 將 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", function (array1, array2) {
+      var idKey = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : "id";
+      var map2 = _lodash["default"].keyBy(array2, function (item) {
+        return _lodash["default"].get(item, idKey);
+      });
+      return array1.map(function (item) {
+        var id = _lodash["default"].get(item, idKey);
+        var match = map2[id];
+        return match ? _lodash["default"].merge({}, item, match) : item;
+      });
+    });
     this.init();
     this.env = "dev";
   }
@@ -3978,107 +4010,9 @@ var Utiller = /*#__PURE__*/function () {
       }).keys().compact() // 過濾掉 null, undefined, '' 等 falsy 值
       .value();
     }
-  }, {
-    key: "generateUidCombinations",
-    value:
-    /** ------------------------------------------------------------------------------------- 起始UID-COMBINATION
-     * 建立組合清單及 UID 映射清單
-     *
-     * 原始資料組合
-     * const array1 = ['黑色', '綠色']
-     * const array2 = ['S', 'M']
-     * const array3 = ['短袖', '長袖']
-     *
-     * 產生 UID 清單
-     * const uidList = generateUidCombinations([array1, array2, array3])
-     *
-     * console.log('📦 所有組合的 UID 對照：')
-     * console.log(uidList)
-     *
-     * 建立查詢表（可選）
-     * const lookupTable = buildLookupTable(uidList)
-     *
-     * 任選一個 UID 測試還原
-     * const sampleUid = Object.keys(uidList[2])[0]
-     * console.log('\n🔍 測試 UID:', sampleUid)
-     * console.log('✅ 還原結果:', getOriginalFromUid(sampleUid, lookupTable))
-     *
-     */
-    /**
-     * 產生所有排列組合並轉成 Firestore-safe UID
-     * @param {string[][]} arrays - 字串陣列的陣列，例如 [['黑色', '綠色'], ['S', 'M']]
-     * @param {string} separator - 分隔符號，預設為 ' | '
-     * @returns {Array<{[uid: string]: string}>} - 每個 UID 對應一組原始組合的對照表陣列
-     */
-    function generateUidCombinations(arrays) {
-      var _this4 = this;
-      var separator = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : " | ";
-      if (!arrays.length) return [];
-
-      // 過濾每個子陣列中的 null、undefined、空字串
-      var sanitizedArrays = arrays.map(function (group) {
-        return group.filter(function (item) {
-          return item !== null && item !== undefined && item !== "";
-        });
-      }).filter(function (group) {
-        return group.length > 0;
-      }); // 移除空子陣列
-
-      // 若最終沒東西，回傳空
-      if (sanitizedArrays.length === 0) return [];
-
-      // 只有一組有效子陣列，直接映射
-      if (sanitizedArrays.length === 1) {
-        return sanitizedArrays[0].map(function (str) {
-          var uid = _this4.encodeToUid(str);
-          return (0, _defineProperty2["default"])({}, uid, str);
-        });
-      }
-
-      // 多組時進行組合
-      var _sanitizedArrays = (0, _toArray2["default"])(sanitizedArrays),
-        first = _sanitizedArrays[0],
-        rest = _sanitizedArrays.slice(1);
-      var combinations = rest.reduce(function (acc, curr) {
-        return _lodash["default"].flatMap(acc, function (a) {
-          return curr.map(function (b) {
-            return (Array.isArray(a) ? a.join(separator) : a) + separator + b;
-          });
-        });
-      }, first);
-      return combinations.map(function (str) {
-        var uid = _this4.encodeToUid(str);
-        return (0, _defineProperty2["default"])({}, uid, str);
-      });
-    }
-
-    /**
-     * 快速建立 UID -> 組合 對照表（Object）
-     */
-  }, {
-    key: "buildLookupTable",
-    value: function buildLookupTable(uidList) {
-      return uidList.reduce(function (acc, item) {
-        var _Object$entries$ = (0, _slicedToArray2["default"])(Object.entries(item)[0], 2),
-          uid = _Object$entries$[0],
-          value = _Object$entries$[1];
-        acc[uid] = value;
-        return acc;
-      }, {});
-    }
-
-    /**
-     * 根據 UID 還原原始組合（透過對照表或解碼備援）
-     */
-  }, {
-    key: "getOriginalFromUid",
-    value: function getOriginalFromUid(uid, lookupTable) {
-      return (lookupTable === null || lookupTable === void 0 ? void 0 : lookupTable[uid]) || this.decodeFromUid(uid) || null;
-    }
   }, {
     key: "getArrayOfFillMissingValues",
-    value: /** ------------------------------------------------------------------------------------- 結束UID-COMBINATION */
-
+    value:
     /**
      * const input = [
      *   { value: 'xx0132', label: 'A款' },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "utiller",
-  "version": "1.0.346",
+  "version": "1.0.348",
   "description": "",
   "main": "index.js",
   "scripts": {

package/template/sample.package.json

@@ -11,7 +11,7 @@
   "license": "ISC",
   "dependencies": {
     "configerer": "^1.0.11",
-    "utiller": "^1.0.345",
+    "utiller": "^1.0.347",
     "linepayer": "^1.0.4",
     "databazer": "^1.0.12",
     "lodash": "^4.17.20",