@pisell/pisellos 2.3.74 → 2.3.75

package/lib/modules/Order/utils/discountProductLineIdentity.js

@@ -1,170 +1,212 @@
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+"use strict";
 
-// src/modules/Order/utils/discountProductLineIdentity.ts
-var discountProductLineIdentity_exports = {};
-__export(discountProductLineIdentity_exports, {
-  DISCOUNT_SPLIT_ORIGIN_UID_KEY: () => DISCOUNT_SPLIT_ORIGIN_UID_KEY,
-  consolidateDiscountFreeProductLines: () => consolidateDiscountFreeProductLines,
-  ensureUniqueProductLineUids: () => ensureUniqueProductLineUids
+Object.defineProperty(exports, "__esModule", {
+  value: true
 });
-module.exports = __toCommonJS(discountProductLineIdentity_exports);
-var import_lodash_es = require("lodash-es");
-var import_utils = require("../../../solution/ScanOrder/utils");
-var import_orderCollectionIdentity = require("./orderCollectionIdentity");
-var DISCOUNT_SPLIT_ORIGIN_UID_KEY = "discountSplitOriginUid";
+exports.DISCOUNT_SPLIT_ORIGIN_UID_KEY = void 0;
+exports.consolidateDiscountFreeProductLines = consolidateDiscountFreeProductLines;
+exports.ensureUniqueProductLineUids = ensureUniqueProductLineUids;
+var _lodashEs = require("lodash-es");
+var _utils = require("../../../solution/ScanOrder/utils");
+var _orderCollectionIdentity = require("./orderCollectionIdentity");
+/**
+ * 商品券拆行的身份与回并工具。
+ *
+ * 背景：
+ * Rules.calcDiscount 应用 good_pass 时，会把一个数量行拆成若干「用券行」和
+ * 「普通余量行」。Rules 返回的拆分行可能复制同一份
+ * metadata.unique_identification_number，进而造成：
+ * - 按 UID 删除时同时命中多行；
+ * - UI 把不同券行视为同一个商品；
+ * - 后续商品更新无法准确定位目标行。
+ *
+ * 处理原则：
+ * 1. 拆分后每一行必须拥有独立 UID；
+ * 2. 原始拆分来源仅记录在 tempOrder._extend.productsByUid 的运行态索引中，
+ *    不写入商品 metadata，不污染提交协议；
+ * 3. 券被移除后，只回并被本工具确认来自同一折扣拆分源的行；
+ * 4. 预约、赠品、促销、手动折扣、备注、称重、holder 和已落库行均为硬边界。
+ *
+ * 两个导出函数都会原地更新 tempOrder。调用顺序必须是：
+ * ensureUniqueProductLineUids -> consolidateDiscountFreeProductLines。
+ */
+
+/** productsByUid 运行态记录中用于关联同一次折扣拆分的字段。 */
+const DISCOUNT_SPLIT_ORIGIN_UID_KEY = exports.DISCOUNT_SPLIT_ORIGIN_UID_KEY = 'discountSplitOriginUid';
+
+// 这里只保留本模块所需的最小读取逻辑，避免反向依赖体量较大的 Order/utils.ts
+// 并形成 utils.ts -> 本文件 -> utils.ts 的循环引用。
 function getProductLineUid(product) {
-  var _a;
-  if (!product || typeof product !== "object")
-    return null;
-  const uid = ((_a = product.metadata) == null ? void 0 : _a.unique_identification_number) ?? product.unique_identification_number;
-  if (uid === void 0 || uid === null || uid === "")
-    return null;
+  if (!product || typeof product !== 'object') return null;
+  const uid = product.metadata?.unique_identification_number ?? product.unique_identification_number;
+  if (uid === undefined || uid === null || uid === '') return null;
   return String(uid);
 }
 function getProductSkuOptions(product) {
-  var _a;
-  return Array.isArray((_a = product.product_sku) == null ? void 0 : _a.option) ? product.product_sku.option : [];
+  return Array.isArray(product.product_sku?.option) ? product.product_sku.option : [];
 }
 function hasProductLineNote(product) {
-  return typeof product.note === "string" && product.note.trim().length > 0;
+  return typeof product.note === 'string' && product.note.trim().length > 0;
 }
 function isManualProductDiscountLine(product) {
-  var _a, _b;
-  return ((_a = product.metadata) == null ? void 0 : _a.is_manual_discount) === true || ((_b = product.metadata) == null ? void 0 : _b.is_manual_discount) === 1 || (product.discount_list || []).some((item) => (item == null ? void 0 : item.type) === "product");
+  return product.metadata?.is_manual_discount === true || product.metadata?.is_manual_discount === 1 || (product.discount_list || []).some(item => item?.type === 'product');
 }
 function ensureProductsByUid(tempOrder) {
-  if (!tempOrder._extend || typeof tempOrder._extend !== "object") {
-    tempOrder._extend = { productsByUid: {} };
+  if (!tempOrder._extend || typeof tempOrder._extend !== 'object') {
+    tempOrder._extend = {
+      productsByUid: {}
+    };
   }
   if (!tempOrder._extend.productsByUid) {
     tempOrder._extend.productsByUid = {};
   }
   return tempOrder._extend.productsByUid;
 }
+
+/**
+ * 修复 Rules 折扣拆行复制 UID 的问题，并为拆分行记录共同来源。
+ *
+ * 第一条商品保留原 UID，后续重复行生成新 UUID；对应的 productsByUid.runtime
+ * 会复制原行 runtime（包括 origin），以保证删除、编辑及展示字段回读仍可工作。
+ *
+ * 没有 UID 的裸商品不会被补写 UID。这是为了兼容 Rules/mock 的历史协议形状；
+ * 正常 Order 写路径会在 normalize 阶段提前创建 UID。
+ */
 function ensureUniqueProductLineUids(tempOrder) {
-  const usedUids = /* @__PURE__ */ new Set();
+  // usedUids 只描述本次 Rules 返回的商品集合，不能直接依赖 productsByUid：
+  // productsByUid 可能还保留已删除行的历史 runtime，历史 UID 不应导致当前行被改号。
+  const usedUids = new Set();
   const productsByUid = ensureProductsByUid(tempOrder);
-  tempOrder.products = (tempOrder.products || []).map((product) => {
+  tempOrder.products = (tempOrder.products || []).map(product => {
     const sourceUid = getProductLineUid(product);
-    if (!sourceUid)
-      return product;
+    // 单测 mock 或兼容旧 Rules 时可能返回没有 UID 的裸商品。
+    // 这里不主动补 UID，避免一个“校验重复”的工具意外改变旧协议对象形状。
+    if (!sourceUid) return product;
+
+    // 实际场景：可乐 ×5 首次进入 Rules 时只有一行。
+    // 使用三张券后 Rules 可能返回「可乐 ×2 + 三条可乐 ×1」，但四条都复制原 UID。
+    // 第一条继续使用原 UID，可保留购物车已有引用、runtime origin 和删除定位的稳定性。
     if (!usedUids.has(sourceUid)) {
       usedUids.add(sourceUid);
       return product;
     }
-    let splitUid = (0, import_orderCollectionIdentity.createUuidV4)();
+
+    // 从第二条重复 UID 开始生成真正的行级身份。
+    // 这样点击任意一条“可乐 ×1”时，只会删除该行，不会把所有同 UID 行一起删除。
+    let splitUid = (0, _orderCollectionIdentity.createUuidV4)();
     while (usedUids.has(splitUid)) {
-      splitUid = (0, import_orderCollectionIdentity.createUuidV4)();
+      splitUid = (0, _orderCollectionIdentity.createUuidV4)();
     }
     product.metadata = {
-      ...product.metadata || {},
+      ...(product.metadata || {}),
       unique_identification_number: splitUid
     };
     const sourceRuntime = productsByUid[sourceUid] || {};
-    const discountSplitOriginUid = String(
-      sourceRuntime[DISCOUNT_SPLIT_ORIGIN_UID_KEY] || sourceUid
-    );
+    // 如果当前行已经是上一轮拆分出来的子行，继续沿用最初的拆分来源。
+    // 例如删除一条券行后，空出的券再次把「可乐 ×2」拆成两条 ×1，
+    // 新行仍应归属于最初那条可乐，而不是形成一个无法回并的新分组。
+    const discountSplitOriginUid = String(sourceRuntime[DISCOUNT_SPLIT_ORIGIN_UID_KEY] || sourceUid);
+
+    // 来源只写入 _extend.productsByUid：
+    // - metadata.unique_identification_number 是对外的行身份，必须各不相同；
+    // - discountSplitOriginUid 是内部回并依据，不能进入提交给后端的商品 metadata。
     productsByUid[sourceUid] = {
       ...sourceRuntime,
       [DISCOUNT_SPLIT_ORIGIN_UID_KEY]: discountSplitOriginUid
     };
+    // 克隆 origin 等 runtime 数据，保证新拆分行仍能正确展示标题、封面等商品信息。
     productsByUid[splitUid] = {
-      ...(0, import_lodash_es.cloneDeep)(sourceRuntime),
+      ...(0, _lodashEs.cloneDeep)(sourceRuntime),
       [DISCOUNT_SPLIT_ORIGIN_UID_KEY]: discountSplitOriginUid
     };
     usedUids.add(splitUid);
     return product;
   });
 }
+
+/**
+ * 把券移除后已经恢复原价的同源折扣拆分行重新合并。
+ *
+ * 此函数刻意不执行通用的「同 SKU 合并」：没有 discountSplitOriginUid 的普通行
+ * 可能是业务 hook、导入订单或其它流程主动拆开的，不能在折扣重算时擅自合并。
+ *
+ * payment_price、tax_fee、surcharge_fee 属于 summary 计算层的派生值。券行与普通行
+ * 在回并前可能暂时不同，因此它们不参与 mergeKey；原始价格、SKU/option/bundle
+ * 结构以及税务/商品类型配置仍参与比较，防止不同商品语义被误合并。
+ */
 function consolidateDiscountFreeProductLines(tempOrder) {
-  var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k, _l, _m, _n;
+  // 实际目标场景：
+  // 选择客户后「可乐 ×5」被三张商品券拆成「×2、×1、×1、×1」；
+  // 清除客户/商品券后，四行都恢复为无折扣状态，应在本轮重算中立即回并为「可乐 ×5」。
   const consolidatedProducts = [];
-  const productIndexByKey = /* @__PURE__ */ new Map();
+  const productIndexByKey = new Map();
   for (const product of tempOrder.products || []) {
     const productBundle = Array.isArray(product.product_bundle) ? product.product_bundle : [];
-    const hasDiscount = (product.discount_list || []).length > 0 || productBundle.some((bundle) => ((bundle == null ? void 0 : bundle.discount_list) || []).length > 0);
-    const bookingUid = product.booking_uid ?? ((_a = product.metadata) == null ? void 0 : _a.booking_uid);
-    const bookingId = product.booking_id ?? ((_b = product.metadata) == null ? void 0 : _b.booking_id);
+    const hasDiscount = (product.discount_list || []).length > 0 || productBundle.some(bundle => (bundle?.discount_list || []).length > 0);
+    const bookingUid = product.booking_uid ?? product.metadata?.booking_uid;
+    const bookingId = product.booking_id ?? product.metadata?.booking_id;
     const orderDetailId = product.order_detail_id ?? product.orderDetailId;
-    const holderId = product.holder_id ?? ((_c = product.metadata) == null ? void 0 : _c.holder_id);
-    const hasMergeBoundary = hasDiscount || Boolean(((_d = product.metadata) == null ? void 0 : _d._giftInfo) || product._giftInfo) || Boolean((_e = product.metadata) == null ? void 0 : _e._promotion) || isManualProductDiscountLine(product) || hasProductLineNote(product) || Number(((_f = product.product_sku) == null ? void 0 : _f.open_sold_weight) || 0) === 1 || ((_g = product.metadata) == null ? void 0 : _g.is_edit_for_runtime) === true || bookingId !== void 0 && bookingId !== null && bookingId !== 0 && bookingId !== "0" || bookingUid !== void 0 && bookingUid !== null && String(bookingUid) !== "" || holderId !== void 0 && holderId !== null && String(holderId) !== "" || orderDetailId !== void 0 && orderDetailId !== null && orderDetailId !== "";
+    const holderId = product.holder_id ?? product.metadata?.holder_id;
+
+    // 以下情况即使“看起来是同一个 SKU”也必须保持独立：
+    // - 仍有商品券/折扣：每条券行分别承担券归属和 savedAmount；
+    // - 赠品/促销：独立行承载策略来源，合并会破坏促销撤销和展示；
+    // - 手动改价/备注：用户显式表达了不同价格或不同制作要求；
+    // - 称重商品：每次称重的净重和金额属于独立交易事实；
+    // - 预约/holder/历史订单行：分别关联预约、持有人或后端 order_detail。
+    const hasMergeBoundary = hasDiscount || Boolean(product.metadata?._giftInfo || product._giftInfo) || Boolean(product.metadata?._promotion) || isManualProductDiscountLine(product) || hasProductLineNote(product) || Number(product.product_sku?.open_sold_weight || 0) === 1 || product.metadata?.is_edit_for_runtime === true || bookingId !== undefined && bookingId !== null && bookingId !== 0 && bookingId !== '0' || bookingUid !== undefined && bookingUid !== null && String(bookingUid) !== '' || holderId !== undefined && holderId !== null && String(holderId) !== '' || orderDetailId !== undefined && orderDetailId !== null && orderDetailId !== '';
     if (hasMergeBoundary) {
       consolidatedProducts.push(product);
       continue;
     }
     const productUid = getProductLineUid(product);
-    const discountSplitOriginUid = productUid ? (_j = (_i = (_h = tempOrder._extend) == null ? void 0 : _h.productsByUid) == null ? void 0 : _i[productUid]) == null ? void 0 : _j[DISCOUNT_SPLIT_ORIGIN_UID_KEY] : void 0;
+    const discountSplitOriginUid = productUid ? tempOrder._extend?.productsByUid?.[productUid]?.[DISCOUNT_SPLIT_ORIGIN_UID_KEY] : undefined;
+
+    // 没有同源标记的两条可乐，可能是 onBeforeMergeProductToOrder 返回 false 后
+    // 由业务主动保留的独立行，也可能来自导入订单；不能仅凭 SKU 相同就擅自合并。
     if (!discountSplitOriginUid) {
       consolidatedProducts.push(product);
       continue;
     }
-    const fingerprint = (0, import_utils.buildProductLineFingerprint)(
-      getProductSkuOptions(product),
-      productBundle
-    );
+
+    // 同属一次券拆分仍不代表一定可以合并。
+    // 例如两行后来选择了不同 option、套餐子商品或自定义价格，需要继续保持独立。
+    const fingerprint = (0, _utils.buildProductLineFingerprint)(getProductSkuOptions(product), productBundle);
     const priceSignature = JSON.stringify({
-      selling_price: String(product.selling_price ?? ""),
-      original_price: String(product.original_price ?? ""),
-      custom_price: String(product.custom_price ?? ""),
+      selling_price: String(product.selling_price ?? ''),
+      original_price: String(product.original_price ?? ''),
+      custom_price: String(product.custom_price ?? ''),
       is_charge_tax: Number(product.is_charge_tax ?? 0),
       gift_card: Number(product.gift_card ?? 0),
       bundle_edit: Number(product.bundle_edit ?? 0),
-      price_schema_version: ((_k = product.metadata) == null ? void 0 : _k.price_schema_version) ?? "",
-      source_product_price: String(((_l = product.metadata) == null ? void 0 : _l.source_product_price) ?? ""),
-      main_product_selling_price: String(
-        ((_m = product.metadata) == null ? void 0 : _m.main_product_selling_price) ?? ""
-      ),
-      main_product_original_price: String(
-        ((_n = product.metadata) == null ? void 0 : _n.main_product_original_price) ?? ""
-      ),
-      bundle: productBundle.map((bundle) => ({
-        bundle_id: (bundle == null ? void 0 : bundle.bundle_id) ?? (bundle == null ? void 0 : bundle.id) ?? "",
-        product_id: (bundle == null ? void 0 : bundle.bundle_product_id) ?? (bundle == null ? void 0 : bundle._bundle_product_id) ?? (bundle == null ? void 0 : bundle.product_id) ?? "",
-        product_variant_id: (bundle == null ? void 0 : bundle.bundle_variant_id) ?? (bundle == null ? void 0 : bundle.variant_id) ?? (bundle == null ? void 0 : bundle.product_variant_id) ?? 0,
-        price: String((bundle == null ? void 0 : bundle.price) ?? ""),
-        original_price: String((bundle == null ? void 0 : bundle.original_price) ?? ""),
-        bundle_selling_price: String((bundle == null ? void 0 : bundle.bundle_selling_price) ?? "")
+      price_schema_version: product.metadata?.price_schema_version ?? '',
+      source_product_price: String(product.metadata?.source_product_price ?? ''),
+      main_product_selling_price: String(product.metadata?.main_product_selling_price ?? ''),
+      main_product_original_price: String(product.metadata?.main_product_original_price ?? ''),
+      bundle: productBundle.map(bundle => ({
+        bundle_id: bundle?.bundle_id ?? bundle?.id ?? '',
+        product_id: bundle?.bundle_product_id ?? bundle?._bundle_product_id ?? bundle?.product_id ?? '',
+        product_variant_id: bundle?.bundle_variant_id ?? bundle?.variant_id ?? bundle?.product_variant_id ?? 0,
+        price: String(bundle?.price ?? ''),
+        original_price: String(bundle?.original_price ?? ''),
+        bundle_selling_price: String(bundle?.bundle_selling_price ?? '')
       }))
     });
-    const mergeKey = [
-      discountSplitOriginUid,
-      product.product_id,
-      product.product_variant_id ?? 0,
-      fingerprint,
-      priceSignature
-    ].join("#");
+    const mergeKey = [discountSplitOriginUid, product.product_id, product.product_variant_id ?? 0, fingerprint, priceSignature].join('#');
     const matchedIndex = productIndexByKey.get(mergeKey);
-    if (matchedIndex === void 0) {
+
+    // 当前拆分来源 + 商品结构组合第一次出现时，保留该行作为回并目标。
+    // 后续相同行只累加数量，从而稳定保留首行 UID，避免 UI key 再次变化。
+    if (matchedIndex === undefined) {
       productIndexByKey.set(mergeKey, consolidatedProducts.length);
       consolidatedProducts.push(product);
       continue;
     }
     const matchedProduct = consolidatedProducts[matchedIndex];
-    matchedProduct.num = (0, import_utils.getSafeProductNum)(
-      Number(matchedProduct.num || 0) + Number(product.num || 0)
-    );
+    matchedProduct.num = (0, _utils.getSafeProductNum)(Number(matchedProduct.num || 0) + Number(product.num || 0));
+    // 示例：目标行 ×2，依次吸收三条 ×1，最终得到 ×5。
+    // 被吸收行的 productsByUid runtime 暂不删除：异步 UI/日志可能仍持有旧 UID，
+    // 保留历史索引比立即清理更安全；当前购物车身份始终以 tempOrder.products 为准。
   }
   tempOrder.products = consolidatedProducts;
-}
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  DISCOUNT_SPLIT_ORIGIN_UID_KEY,
-  consolidateDiscountFreeProductLines,
-  ensureUniqueProductLineUids
-});
+}

package/lib/modules/Order/utils/manualProductDiscount.js

@@ -1,113 +1,98 @@
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
-  // If the importer is in node compatibility mode or this is not an ESM
-  // file that has been converted to a CommonJS file using a Babel-
-  // compatible transform (i.e. "__esModule" has not been set), then set
-  // "default" to the CommonJS "module.exports" for node compatibility.
-  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
-  mod
-));
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+"use strict";
 
-// src/modules/Order/utils/manualProductDiscount.ts
-var manualProductDiscount_exports = {};
-__export(manualProductDiscount_exports, {
-  buildManualProductDiscountItem: () => buildManualProductDiscountItem,
-  ensureManualProductDiscountList: () => ensureManualProductDiscountList,
-  findManualProductDiscountItem: () => findManualProductDiscountItem,
-  hasManualProductDiscountFlag: () => hasManualProductDiscountFlag,
-  mergeManualProductDiscountIntoList: () => mergeManualProductDiscountIntoList,
-  resolveManualDiscountMessage: () => resolveManualDiscountMessage,
-  resolveManualDiscountOriginTotal: () => resolveManualDiscountOriginTotal,
-  resolveManualDiscountReasonFromSources: () => resolveManualDiscountReasonFromSources,
-  resolveSafeProductNum: () => resolveSafeProductNum,
-  shouldBuildManualProductDiscount: () => shouldBuildManualProductDiscount,
-  stripManualProductDiscountItems: () => stripManualProductDiscountItems,
-  syncManualProductDiscountProductNum: () => syncManualProductDiscountProductNum
+Object.defineProperty(exports, "__esModule", {
+  value: true
 });
-module.exports = __toCommonJS(manualProductDiscount_exports);
-var import_decimal = __toESM(require("decimal.js"));
+exports.buildManualProductDiscountItem = buildManualProductDiscountItem;
+exports.ensureManualProductDiscountList = ensureManualProductDiscountList;
+exports.findManualProductDiscountItem = findManualProductDiscountItem;
+exports.hasManualProductDiscountFlag = hasManualProductDiscountFlag;
+exports.mergeManualProductDiscountIntoList = mergeManualProductDiscountIntoList;
+exports.resolveManualDiscountMessage = resolveManualDiscountMessage;
+exports.resolveManualDiscountOriginTotal = resolveManualDiscountOriginTotal;
+exports.resolveManualDiscountReasonFromSources = resolveManualDiscountReasonFromSources;
+exports.resolveSafeProductNum = resolveSafeProductNum;
+exports.shouldBuildManualProductDiscount = shouldBuildManualProductDiscount;
+exports.stripManualProductDiscountItems = stripManualProductDiscountItems;
+exports.syncManualProductDiscountProductNum = syncManualProductDiscountProductNum;
+var _decimal = _interopRequireDefault(require("decimal.js"));
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+/** 解析商品行数量（checkout 协议 product_num 语义 = 当前行 num） */
 function resolveSafeProductNum(num) {
   const parsed = Number(num);
-  if (!Number.isFinite(parsed) || parsed <= 0)
-    return 1;
+  if (!Number.isFinite(parsed) || parsed <= 0) return 1;
   return Math.floor(parsed);
 }
+
+/**
+ * 将 discount_list 中 type=product 项的 product_num 同步为当前商品数量。
+ *
+ * @example
+ * syncManualProductDiscountProductNum(line.discount_list, line.num);
+ */
 function syncManualProductDiscountProductNum(discountList, productNum) {
   const quantity = resolveSafeProductNum(productNum);
-  return (discountList || []).map((item) => {
-    if ((item == null ? void 0 : item.type) !== "product")
-      return item;
+  return (discountList || []).map(item => {
+    if (item?.type !== 'product') return item;
     return {
       ...item,
       discount: {
-        ...item.discount || {},
+        ...(item.discount || {}),
         product_num: quantity
       }
     };
   });
 }
+
+/** 从多源解析改价前行总价（与 cacheItem._extend.origin_total 语义一致） */
 function resolveManualDiscountOriginTotal(sources) {
-  const candidates = [
-    sources.originTotal,
-    sources.extendOriginTotal,
-    sources.originExtendOriginTotal,
-    sources.sourceExtendOriginTotal
-  ];
+  const candidates = [sources.originTotal, sources.extendOriginTotal, sources.originExtendOriginTotal, sources.sourceExtendOriginTotal];
   for (const candidate of candidates) {
-    if (candidate === void 0 || candidate === null || candidate === "")
-      continue;
+    if (candidate === undefined || candidate === null || candidate === '') continue;
     const parsed = Number(candidate);
-    if (Number.isFinite(parsed))
-      return parsed;
+    if (Number.isFinite(parsed)) return parsed;
   }
   const unit = Number(sources.catalogUnitPrice);
   const quantity = sources.quantity ?? 1;
   if (Number.isFinite(unit) && unit > 0) {
-    return new import_decimal.default(unit).mul(quantity).toNumber();
+    return new _decimal.default(unit).mul(quantity).toNumber();
   }
   return NaN;
 }
+
+/** 从 payload / extend / origin 解析手动折扣原因 */
 function resolveManualDiscountReasonFromSources(sources) {
-  for (const candidate of [
-    sources.discountReason,
-    sources.extendDiscountReason,
-    sources.originExtendDiscountReason
-  ]) {
-    if (candidate != null && String(candidate).trim() !== "") {
+  for (const candidate of [sources.discountReason, sources.extendDiscountReason, sources.originExtendDiscountReason]) {
+    if (candidate != null && String(candidate).trim() !== '') {
       return String(candidate);
     }
   }
-  return "";
+  return '';
 }
+
+/** 是否带手动改价标记（price_override / is_manual_discount） */
 function hasManualProductDiscountFlag(metadata) {
-  if (!metadata)
-    return false;
+  if (!metadata) return false;
   const override = metadata.price_override;
-  if (override !== void 0 && override !== null && override !== "") {
+  if (override !== undefined && override !== null && override !== '') {
     return true;
   }
   return metadata.is_manual_discount === 1 || metadata.is_manual_discount === true;
 }
+
+/**
+ * normalize 兜底：手动改价但 discount_list 缺 type=product 时，按行级原价/折后价补写。
+ *
+ * @example
+ * ensureManualProductDiscountList({
+ *   discountList: [],
+ *   metadata: { price_override: '5', is_manual_discount: 1 },
+ *   originalPrice: '11.00',
+ *   sellingPrice: '5.00',
+ *   quantity: 1,
+ * });
+ */
 function ensureManualProductDiscountList(params) {
-  var _a, _b, _c, _d, _e, _f, _g, _h;
   const list = params.discountList || [];
   const quantity = resolveSafeProductNum(params.quantity);
   if (findManualProductDiscountItem(list)) {
@@ -128,79 +113,95 @@ function ensureManualProductDiscountList(params) {
   if (!Number.isFinite(originalNum) || !Number.isFinite(sellingNum) || originalNum === sellingNum) {
     return list;
   }
-  const message = resolveManualDiscountMessage(
-    list,
-    resolveManualDiscountReasonFromSources({
-      extendDiscountReason: (_b = (_a = metadata.origin) == null ? void 0 : _a._extend) == null ? void 0 : _b.discount_reason,
-      originExtendDiscountReason: (_d = (_c = metadata.origin) == null ? void 0 : _c._extend) == null ? void 0 : _d.discount_reason
-    })
-  );
-  return mergeManualProductDiscountIntoList(
-    list,
-    buildManualProductDiscountItem({
-      originTotal: originalNum,
-      sellingTotal: sellingNum,
-      quantity,
-      message,
-      discountway: (_f = (_e = metadata.origin) == null ? void 0 : _e._extend) == null ? void 0 : _f.discountway,
-      discount_per: (_h = (_g = metadata.origin) == null ? void 0 : _g._extend) == null ? void 0 : _h.discount_per
-    })
-  );
+  const message = resolveManualDiscountMessage(list, resolveManualDiscountReasonFromSources({
+    extendDiscountReason: metadata.origin?._extend?.discount_reason,
+    originExtendDiscountReason: metadata.origin?._extend?.discount_reason
+  }));
+  return mergeManualProductDiscountIntoList(list, buildManualProductDiscountItem({
+    originTotal: originalNum,
+    sellingTotal: sellingNum,
+    quantity,
+    message,
+    discountway: metadata.origin?._extend?.discountway,
+    discount_per: metadata.origin?._extend?.discount_per
+  }));
 }
+
+/** 商品手动折扣 discount_list 项（checkout 协议，type = product） */
+
+/**
+ * 从 discount_list 中取手动改价项（type = product）。
+ *
+ * @example
+ * const manual = findManualProductDiscountItem(product.discount_list);
+ * manual?.discount.message; // 折扣原因
+ */
 function findManualProductDiscountItem(discountList) {
-  return (discountList || []).find((item) => (item == null ? void 0 : item.type) === "product");
+  return (discountList || []).find(item => item?.type === 'product');
 }
+
+/**
+ * 解析折扣原因：优先 discount_list[type=product].discount.message。
+ *
+ * @example
+ * resolveManualDiscountMessage(line.discount_list, line.metadata?.legacy_reason);
+ */
 function resolveManualDiscountMessage(discountList, fallback) {
-  var _a, _b;
-  const message = (_b = (_a = findManualProductDiscountItem(discountList)) == null ? void 0 : _a.discount) == null ? void 0 : _b.message;
-  if (message != null && String(message).trim() !== "") {
+  const message = findManualProductDiscountItem(discountList)?.discount?.message;
+  if (message != null && String(message).trim() !== '') {
     return String(message);
   }
-  return fallback ?? "";
+  return fallback ?? '';
 }
+
+/** 去掉 discount_list 中已有的手动改价项，避免重复叠加 */
 function stripManualProductDiscountItems(discountList) {
-  return (discountList || []).filter((item) => (item == null ? void 0 : item.type) !== "product");
+  return (discountList || []).filter(item => item?.type !== 'product');
 }
+
+/**
+ * 由改价前后行总价构建手动折扣项；amount = |originTotal - sellingTotal|（行级差额）。
+ *
+ * @example
+ * buildManualProductDiscountItem({
+ *   originTotal: 11,
+ *   sellingTotal: 4,
+ *   quantity: 1,
+ *   message: 'VIP',
+ * });
+ */
 function buildManualProductDiscountItem(params) {
-  const origin = new import_decimal.default(Number(params.originTotal) || 0);
-  const selling = new import_decimal.default(Number(params.sellingTotal) || 0);
+  const origin = new _decimal.default(Number(params.originTotal) || 0);
+  const selling = new _decimal.default(Number(params.sellingTotal) || 0);
   const diff = origin.minus(selling);
   const quantity = resolveSafeProductNum(params.quantity);
   return {
     amount: diff.toDecimalPlaces(2).toNumber(),
-    type: "product",
+    type: 'product',
     discount: {
-      message: params.message ?? "",
-      discountway: params.discountway ?? "num",
+      message: params.message ?? '',
+      discountway: params.discountway ?? 'num',
       product_num: quantity,
-      discount_per: params.discount_per ?? "",
-      discount_type: diff.isNegative() ? "change_price" : "discount"
+      discount_per: params.discount_per ?? '',
+      discount_type: diff.isNegative() ? 'change_price' : 'discount'
     }
   };
 }
+
+/**
+ * 将手动改价项合并进 discount_list（替换已有 type=product 项）。
+ *
+ * @example
+ * mergeManualProductDiscountIntoList(coupons, manualItem);
+ */
 function mergeManualProductDiscountIntoList(discountList, manualItem) {
   const base = stripManualProductDiscountItems(discountList);
-  if (!manualItem)
-    return base;
-  if (manualItem.amount === 0 && !manualItem.discount.message)
-    return base;
+  if (!manualItem) return base;
+  if (manualItem.amount === 0 && !manualItem.discount.message) return base;
   return [...base, manualItem];
 }
+
+/** 是否应写入手动改价 discount_list 项 */
 function shouldBuildManualProductDiscount(params) {
   return Boolean(params.hasPriceOverride);
-}
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  buildManualProductDiscountItem,
-  ensureManualProductDiscountList,
-  findManualProductDiscountItem,
-  hasManualProductDiscountFlag,
-  mergeManualProductDiscountIntoList,
-  resolveManualDiscountMessage,
-  resolveManualDiscountOriginTotal,
-  resolveManualDiscountReasonFromSources,
-  resolveSafeProductNum,
-  shouldBuildManualProductDiscount,
-  stripManualProductDiscountItems,
-  syncManualProductDiscountProductNum
-});
+}