@pisell/pisellos 0.0.567 → 0.0.568

package/lib/solution/ScanOrder/utils.js

@@ -1,120 +1,114 @@
-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/solution/ScanOrder/utils.ts
-var utils_exports = {};
-__export(utils_exports, {
-  aggregateItemRuleLimit: () => aggregateItemRuleLimit,
-  attachItemRuleLimitsToTopLevelProducts: () => attachItemRuleLimitsToTopLevelProducts,
-  buildItemRuleBusinessData: () => buildItemRuleBusinessData,
-  buildProductKey: () => buildProductKey,
-  buildProductLineFingerprint: () => buildProductLineFingerprint,
-  buildQuantityLimitIndex: () => buildQuantityLimitIndex,
-  collectLinkProductIdsFromReservationRules: () => collectLinkProductIdsFromReservationRules,
-  computeResourceIsFull: () => computeResourceIsFull,
-  createEmptySummary: () => createEmptySummary,
-  extractStrategyModelIdsFromTableConfig: () => extractStrategyModelIdsFromTableConfig,
-  findReservationRuleProductByResourceId: () => findReservationRuleProductByResourceId,
-  getProductIdentityIndex: () => getProductIdentityIndex,
-  getSafeProductNum: () => getSafeProductNum,
-  getTopLevelProductId: () => getTopLevelProductId,
-  getTopLevelVariantId: () => getTopLevelVariantId,
-  hasCustomCapacityProduct: () => hasCustomCapacityProduct,
-  isIdentityMatch: () => isIdentityMatch,
-  isSkuOnlyDeleteIdentity: () => isSkuOnlyDeleteIdentity,
-  normalizeEnabledItemRuleIds: () => normalizeEnabledItemRuleIds,
-  normalizeItemRuleStrategies: () => normalizeItemRuleStrategies,
-  normalizeOrderProduct: () => normalizeOrderProduct,
-  pickFirstCustomCapacityDimensionId: () => pickFirstCustomCapacityDimensionId,
-  pickFirstCustomCapacityPaxBounds: () => pickFirstCustomCapacityPaxBounds,
-  pickFirstDurationMinutesFromProducts: () => pickFirstDurationMinutesFromProducts,
-  resolveSkuMatchedQuantityLimits: () => resolveSkuMatchedQuantityLimits,
-  toBoolean: () => toBoolean,
-  toNonNegativeInt: () => toNonNegativeInt,
-  toNonNegativeNumber: () => toNonNegativeNumber,
-  toPositiveString: () => toPositiveString,
-  toPriceString: () => toPriceString
+Object.defineProperty(exports, "__esModule", {
+  value: true
 });
-module.exports = __toCommonJS(utils_exports);
-var import_dayjs = __toESM(require("dayjs"));
-var import_decimal = __toESM(require("decimal.js"));
-var import_utils = require("../../modules/Order/utils");
+exports.aggregateItemRuleLimit = aggregateItemRuleLimit;
+exports.attachItemRuleLimitsToTopLevelProducts = attachItemRuleLimitsToTopLevelProducts;
+exports.buildItemRuleBusinessData = buildItemRuleBusinessData;
+exports.buildProductKey = buildProductKey;
+exports.buildProductLineFingerprint = buildProductLineFingerprint;
+exports.buildQuantityLimitIndex = buildQuantityLimitIndex;
+exports.collectLinkProductIdsFromReservationRules = collectLinkProductIdsFromReservationRules;
+exports.computeResourceIsFull = computeResourceIsFull;
+exports.createEmptySummary = createEmptySummary;
+exports.extractStrategyModelIdsFromTableConfig = extractStrategyModelIdsFromTableConfig;
+exports.findReservationRuleProductByResourceId = findReservationRuleProductByResourceId;
+exports.getProductIdentityIndex = getProductIdentityIndex;
+exports.getSafeProductNum = getSafeProductNum;
+exports.getTopLevelProductId = getTopLevelProductId;
+exports.getTopLevelVariantId = getTopLevelVariantId;
+exports.hasCustomCapacityProduct = hasCustomCapacityProduct;
+exports.isIdentityMatch = isIdentityMatch;
+exports.isSkuOnlyDeleteIdentity = isSkuOnlyDeleteIdentity;
+exports.normalizeEnabledItemRuleIds = normalizeEnabledItemRuleIds;
+exports.normalizeItemRuleStrategies = normalizeItemRuleStrategies;
+exports.normalizeOrderProduct = normalizeOrderProduct;
+exports.pickFirstCustomCapacityDimensionId = pickFirstCustomCapacityDimensionId;
+exports.pickFirstCustomCapacityPaxBounds = pickFirstCustomCapacityPaxBounds;
+exports.pickFirstDurationMinutesFromProducts = pickFirstDurationMinutesFromProducts;
+exports.resolveSkuMatchedQuantityLimits = resolveSkuMatchedQuantityLimits;
+exports.toBoolean = toBoolean;
+exports.toNonNegativeInt = toNonNegativeInt;
+exports.toNonNegativeNumber = toNonNegativeNumber;
+exports.toPositiveString = toPositiveString;
+exports.toPriceString = toPriceString;
+var _dayjs = _interopRequireDefault(require("dayjs"));
+var _decimal = _interopRequireDefault(require("decimal.js"));
+var _utils = require("../../modules/Order/utils");
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+/**
+ * 构建金额全为 0 的空 summary。
+ * 作为尚未计算金额时的兜底默认值，避免下游因 undefined 报错。
+ */
 function createEmptySummary() {
   return {
     product_quantity: 0,
-    product_original_amount: "0.00",
-    product_amount: "0.00",
-    product_expect_amount: "0.00",
-    product_tax_fee: "0.00",
-    shipping_fee: "0.00",
-    shipping_tax_fee: "0.00",
-    tax_fee: "0.00",
-    surcharge_fee: "0.00",
-    discount_amount: "0.00",
-    deposit_amount: "0.00",
-    expect_amount: "0.00",
-    total_amount: "0.00",
-    amount_gap: "0.00",
-    rounding_amount: "0.00",
-    pay_service_charge_amount: "0.00"
+    product_original_amount: '0.00',
+    product_amount: '0.00',
+    product_expect_amount: '0.00',
+    product_tax_fee: '0.00',
+    shipping_fee: '0.00',
+    shipping_tax_fee: '0.00',
+    tax_fee: '0.00',
+    surcharge_fee: '0.00',
+    discount_amount: '0.00',
+    deposit_amount: '0.00',
+    expect_amount: '0.00',
+    total_amount: '0.00',
+    amount_gap: '0.00',
+    rounding_amount: '0.00',
+    pay_service_charge_amount: '0.00'
   };
 }
+
+/**
+ * 商品数量安全取值。
+ * - NaN / undefined / < 1 均视作 1（最低起订量）
+ * - 有值时取整（不支持小数数量）
+ */
 function getSafeProductNum(num) {
-  if (!num || Number.isNaN(num))
-    return 1;
-  if (num < 1)
-    return 1;
+  if (!num || Number.isNaN(num)) return 1;
+  if (num < 1) return 1;
   return Math.floor(num);
 }
+
+/**
+ * 宽松布尔值转换。
+ * 兼容后端/配置中心常见的 boolean / number / string 表达，统一归一成 true/false。
+ */
 function toBoolean(value) {
-  if (typeof value === "boolean")
-    return value;
-  if (typeof value === "number")
-    return value !== 0;
-  if (typeof value === "string") {
+  if (typeof value === 'boolean') return value;
+  if (typeof value === 'number') return value !== 0;
+  if (typeof value === 'string') {
     const normalized = value.trim().toLowerCase();
-    return ["1", "true", "yes", "y", "on"].includes(normalized);
+    return ['1', 'true', 'yes', 'y', 'on'].includes(normalized);
   }
   return false;
 }
+
+/**
+ * 将值归一化为有效的正向字符串。
+ * null / undefined / 空串 / '0' / 'null' 统一视为无效值并返回 undefined。
+ */
 function toPositiveString(value) {
-  if (value === null || value === void 0 || value === "")
-    return void 0;
+  if (value === null || value === undefined || value === '') return undefined;
   const normalized = String(value).trim();
-  if (!normalized || normalized === "0" || normalized.toLowerCase() === "null") {
-    return void 0;
+  if (!normalized || normalized === '0' || normalized.toLowerCase() === 'null') {
+    return undefined;
   }
   return normalized;
 }
+
+/**
+ * 归一化 item rule 策略模型 ID 列表。
+ * - 支持 string / number 混合输入
+ * - 仅保留 > 0 的合法数字
+ * - 自动去重
+ */
 function normalizeEnabledItemRuleIds(rawIds) {
-  if (!Array.isArray(rawIds))
-    return [];
-  const uniqueIds = /* @__PURE__ */ new Set();
+  if (!Array.isArray(rawIds)) return [];
+  const uniqueIds = new Set();
   for (const item of rawIds) {
     const strategyId = Number(item);
     if (Number.isFinite(strategyId) && strategyId > 0) {
@@ -123,27 +117,27 @@ function normalizeEnabledItemRuleIds(rawIds) {
   }
   return Array.from(uniqueIds);
 }
+
+/**
+ * 从 tableConfig 中提取合法策略模型 ID 列表。
+ */
 function extractStrategyModelIdsFromTableConfig(tableConfig) {
-  const rawIds = Array.isArray(tableConfig == null ? void 0 : tableConfig.strategy_model_ids) ? tableConfig.strategy_model_ids : [];
-  return rawIds.map((id) => Number(id)).filter((id) => Number.isFinite(id) && id > 0);
+  const rawIds = Array.isArray(tableConfig?.strategy_model_ids) ? tableConfig.strategy_model_ids : [];
+  return rawIds.map(id => Number(id)).filter(id => Number.isFinite(id) && id > 0);
 }
+
+/**
+ * 仅保留 item_rule 类型策略。
+ */
 function normalizeItemRuleStrategies(configs) {
-  if (!Array.isArray(configs))
-    return [];
-  return configs.filter(
-    (config) => {
-      var _a;
-      return Boolean(
-        config && typeof config === "object" && ((_a = config == null ? void 0 : config.metadata) == null ? void 0 : _a.type) === "item_rule"
-      );
-    }
-  );
+  if (!Array.isArray(configs)) return [];
+  return configs.filter(config => Boolean(config && typeof config === 'object' && config?.metadata?.type === 'item_rule'));
 }
 function toNonNegativeNumber(value) {
-  if (typeof value === "number") {
+  if (typeof value === 'number') {
     return Number.isFinite(value) && value >= 0 ? value : 0;
   }
-  if (typeof value === "string") {
+  if (typeof value === 'string') {
     const parsed = Number(value);
     return Number.isFinite(parsed) && parsed >= 0 ? parsed : 0;
   }
@@ -152,10 +146,9 @@ function toNonNegativeNumber(value) {
 function toNonNegativeInt(value) {
   return Math.floor(toNonNegativeNumber(value));
 }
-function toPriceString(value, fallback = "0.00") {
+function toPriceString(value, fallback = '0.00') {
   const parsedValue = Number(value);
-  if (Number.isNaN(parsedValue))
-    return fallback;
+  if (Number.isNaN(parsedValue)) return fallback;
   return parsedValue.toFixed(2);
 }
 function buildProductKey(productId, productVariantId) {
@@ -164,31 +157,29 @@ function buildProductKey(productId, productVariantId) {
 function getTopLevelProductId(product) {
   const rawProductId = product.product_id ?? product.id;
   const productId = Number(rawProductId);
-  if (!Number.isFinite(productId) || productId <= 0)
-    return null;
+  if (!Number.isFinite(productId) || productId <= 0) return null;
   return productId;
 }
 function getTopLevelVariantId(product) {
   const rawVariantId = product.product_variant_id ?? product.variant_id;
-  if (rawVariantId === void 0 || rawVariantId === null || rawVariantId === "") {
+  if (rawVariantId === undefined || rawVariantId === null || rawVariantId === '') {
     return null;
   }
   const variantId = Number(rawVariantId);
-  if (!Number.isFinite(variantId) || variantId <= 0)
-    return null;
+  if (!Number.isFinite(variantId) || variantId <= 0) return null;
   return variantId;
 }
 function buildQuantityLimitIndex(limits) {
-  const exactLimitMap = /* @__PURE__ */ new Map();
-  const productLimitMap = /* @__PURE__ */ new Map();
+  const exactLimitMap = new Map();
+  const productLimitMap = new Map();
   for (const limit of limits) {
     const targets = limit.targets || [];
-    if (targets.length !== 1)
-      continue;
+    // 多目标规则（OR 组）只做购物车聚合校验，不下发到单品维度，
+    // 避免 UI 把「组内至少 1 份」误当作每款商品各自的 min，锁死减号按钮。
+    if (targets.length !== 1) continue;
     const target = targets[0];
     const productId = Number(target.product_id);
-    if (!Number.isFinite(productId) || productId <= 0)
-      continue;
+    if (!Number.isFinite(productId) || productId <= 0) continue;
     const variantId = Number(target.product_variant_id);
     const hasVariant = Number.isFinite(variantId) && variantId > 0;
     if (hasVariant) {
@@ -206,44 +197,53 @@ function buildQuantityLimitIndex(limits) {
   };
 }
 function resolveSkuMatchedQuantityLimits(params) {
-  const { productId, variantId, limitIndex } = params;
+  const {
+    productId,
+    variantId,
+    limitIndex
+  } = params;
   const exactMatched = variantId && variantId > 0 ? limitIndex.exactLimitMap.get(buildProductKey(productId, variantId)) || [] : [];
   const productMatched = limitIndex.productLimitMap.get(productId) || [];
   return [...exactMatched, ...productMatched];
 }
 function aggregateItemRuleLimit(matchedLimits) {
-  if (!matchedLimits.length)
-    return null;
+  if (!matchedLimits.length) return null;
   let min;
   let max;
   let remainingMax;
   let exact;
   let mustInclude = false;
+
+  // 聚合 validationMessage 按 min / max 两个方向分别输出：
+  //   - maxValidationMessage：触发"当前 max / remainingMax / exact"的那条规则的文案
+  //   - minValidationMessage：触发"当前 min / exact"的那条规则的文案
+  // 各自再回退到其他带文案的规则（最后回退到第一条非空 validationMessage）。
+  // 前端可根据"加号/减号被拦"的方向取对应文案。
   let maxSourceLimit;
   let remainingMaxSourceLimit;
   let exactSourceLimit;
   let minSourceLimit;
   let firstMessagedLimit;
   for (const limit of matchedLimits) {
-    if (typeof limit.requiredMin === "number" && Number.isFinite(limit.requiredMin)) {
-      if (min === void 0 || limit.requiredMin > min) {
+    if (typeof limit.requiredMin === 'number' && Number.isFinite(limit.requiredMin)) {
+      if (min === undefined || limit.requiredMin > min) {
         min = limit.requiredMin;
         minSourceLimit = limit;
       }
     }
-    if (typeof limit.requiredMax === "number" && Number.isFinite(limit.requiredMax)) {
-      if (max === void 0 || limit.requiredMax < max) {
+    if (typeof limit.requiredMax === 'number' && Number.isFinite(limit.requiredMax)) {
+      if (max === undefined || limit.requiredMax < max) {
         max = limit.requiredMax;
         maxSourceLimit = limit;
       }
     }
-    if (typeof limit.remainingMax === "number" && Number.isFinite(limit.remainingMax)) {
-      if (remainingMax === void 0 || limit.remainingMax < remainingMax) {
+    if (typeof limit.remainingMax === 'number' && Number.isFinite(limit.remainingMax)) {
+      if (remainingMax === undefined || limit.remainingMax < remainingMax) {
         remainingMax = limit.remainingMax;
         remainingMaxSourceLimit = limit;
       }
     }
-    if (typeof limit.requiredExact === "number" && Number.isFinite(limit.requiredExact)) {
+    if (typeof limit.requiredExact === 'number' && Number.isFinite(limit.requiredExact)) {
       exact = limit.requiredExact;
       exactSourceLimit = limit;
     }
@@ -252,16 +252,19 @@ function aggregateItemRuleLimit(matchedLimits) {
       firstMessagedLimit = limit;
     }
   }
-  if (typeof exact === "number" && Number.isFinite(exact)) {
+  if (typeof exact === 'number' && Number.isFinite(exact)) {
     min = exact;
     max = exact;
   }
   const maxMessageSource = maxSourceLimit || remainingMaxSourceLimit || exactSourceLimit || firstMessagedLimit;
   const minMessageSource = minSourceLimit || exactSourceLimit || firstMessagedLimit;
-  const maxValidationMessage = maxMessageSource == null ? void 0 : maxMessageSource.validationMessage;
-  const rawMaxValidationMessage = maxMessageSource == null ? void 0 : maxMessageSource.rawValidationMessage;
-  const minValidationMessage = minMessageSource == null ? void 0 : minMessageSource.validationMessage;
-  const rawMinValidationMessage = minMessageSource == null ? void 0 : minMessageSource.rawValidationMessage;
+  const maxValidationMessage = maxMessageSource?.validationMessage;
+  const rawMaxValidationMessage = maxMessageSource?.rawValidationMessage;
+  const minValidationMessage = minMessageSource?.validationMessage;
+  const rawMinValidationMessage = minMessageSource?.rawValidationMessage;
+
+  // validationMessage / rawValidationMessage 保留为"最严格限制"的聚合文案，
+  // 便于旧消费者（只关心 max 侧）不破坏。优先 max → min。
   const validationMessage = maxValidationMessage ?? minValidationMessage;
   const rawValidationMessage = rawMaxValidationMessage ?? rawMinValidationMessage;
   return {
@@ -279,28 +282,34 @@ function aggregateItemRuleLimit(matchedLimits) {
   };
 }
 function buildItemRuleBusinessData(params) {
-  const { tempOrder, runtimeConfig, itemRuleConfigs } = params;
+  const {
+    tempOrder,
+    runtimeConfig,
+    itemRuleConfigs
+  } = params;
   const rawPax = runtimeConfig.pax || {};
   const adultPax = toNonNegativeInt(rawPax.adult);
   const childPax = toNonNegativeInt(rawPax.child);
   const totalPax = toNonNegativeInt(rawPax.total) || adultPax + childPax || 1;
   const cartItems = tempOrder.products.reduce((result, product) => {
-    if (typeof product.product_id !== "number")
-      return result;
+    if (typeof product.product_id !== 'number') return result;
     result.push({
       product_id: product.product_id,
       quantity: toNonNegativeInt(product.num),
-      ...typeof product.product_variant_id === "number" ? { product_variant_id: product.product_variant_id } : {}
+      ...(typeof product.product_variant_id === 'number' ? {
+        product_variant_id: product.product_variant_id
+      } : {})
     });
     return result;
   }, []);
   const historicalItems = Array.isArray(runtimeConfig.historicalItems) ? runtimeConfig.historicalItems.reduce((result, item) => {
-    if (typeof (item == null ? void 0 : item.product_id) !== "number")
-      return result;
+    if (typeof item?.product_id !== 'number') return result;
     result.push({
       product_id: item.product_id,
       quantity: toNonNegativeInt(item.quantity),
-      ...typeof item.product_variant_id === "number" ? { product_variant_id: item.product_variant_id } : {}
+      ...(typeof item.product_variant_id === 'number' ? {
+        product_variant_id: item.product_variant_id
+      } : {})
     });
     return result;
   }, []) : [];
@@ -312,23 +321,20 @@ function buildItemRuleBusinessData(params) {
     },
     cartItems,
     historicalItems,
-    serviceType: runtimeConfig.serviceType || "dine-in",
-    submissionIndex: typeof runtimeConfig.submissionIndex === "number" ? toNonNegativeInt(runtimeConfig.submissionIndex) : tempOrder.order_id ? 1 : 0,
+    serviceType: runtimeConfig.serviceType || 'dine-in',
+    submissionIndex: typeof runtimeConfig.submissionIndex === 'number' ? toNonNegativeInt(runtimeConfig.submissionIndex) : tempOrder.order_id ? 1 : 0,
     custom: runtimeConfig.custom || {},
     strategyConfigs: itemRuleConfigs
   };
 }
 function attachItemRuleLimitsToTopLevelProducts(productList, limits) {
-  if (!Array.isArray(productList))
-    return productList;
+  if (!Array.isArray(productList)) return productList;
   const limitIndex = buildQuantityLimitIndex(limits || []);
   for (const item of productList) {
-    if (!item || typeof item !== "object")
-      continue;
+    if (!item || typeof item !== 'object') continue;
     const productItem = item;
     const productId = getTopLevelProductId(productItem);
-    if (productId === null)
-      continue;
+    if (productId === null) continue;
     const variantId = getTopLevelVariantId(productItem);
     const matchedLimits = limits.length ? resolveSkuMatchedQuantityLimits({
       productId,
@@ -338,137 +344,201 @@ function attachItemRuleLimitsToTopLevelProducts(productList, limits) {
     const aggregatedLimit = aggregateItemRuleLimit(matchedLimits);
     if (aggregatedLimit) {
       productItem.item_rule_limit = aggregatedLimit;
-    } else if ("item_rule_limit" in productItem) {
+    } else if ('item_rule_limit' in productItem) {
       delete productItem.item_rule_limit;
     }
   }
   return productList;
 }
+
+/**
+ * 将选项行 / 套餐行归一成稳定 JSON，用于「同 SKU 是否合并」判断。
+ * 数组元素先按主键排序再序列化，避免顺序差异导致误判为不同行。
+ */
 function buildProductLineFingerprint(productOptionItem, productBundle) {
   const optArr = Array.isArray(productOptionItem) ? productOptionItem : [];
-  const normalizedOpts = optArr.map((item) => ({
-    product_option_item_id: Number(item == null ? void 0 : item.product_option_item_id) || 0,
-    option_group_id: Number(item == null ? void 0 : item.option_group_id) || 0,
-    num: typeof (item == null ? void 0 : item.num) === "number" && !Number.isNaN(item.num) ? Math.max(1, Math.floor(item.num)) : 1,
-    price: String((item == null ? void 0 : item.price) ?? "")
+  const normalizedOpts = optArr.map(item => ({
+    product_option_item_id: Number(item?.product_option_item_id) || 0,
+    option_group_id: Number(item?.option_group_id) || 0,
+    num: typeof item?.num === 'number' && !Number.isNaN(item.num) ? Math.max(1, Math.floor(item.num)) : 1,
+    price: String(item?.price ?? '')
   })).sort((p, q) => {
     if (p.product_option_item_id !== q.product_option_item_id) {
       return p.product_option_item_id - q.product_option_item_id;
     }
-    if (p.option_group_id !== q.option_group_id)
-      return p.option_group_id - q.option_group_id;
-    if (p.num !== q.num)
-      return p.num - q.num;
+    if (p.option_group_id !== q.option_group_id) return p.option_group_id - q.option_group_id;
+    if (p.num !== q.num) return p.num - q.num;
     return p.price.localeCompare(q.price);
   });
   const bundleArr = Array.isArray(productBundle) ? productBundle : [];
-  const normalizedBundles = bundleArr.map((item) => ({
-    bundle_id: Number((item == null ? void 0 : item.bundle_id) ?? (item == null ? void 0 : item.id) ?? 0) || 0,
-    product_id: Number(item == null ? void 0 : item.product_id) || 0,
-    num: typeof (item == null ? void 0 : item.num) === "number" && !Number.isNaN(item.num) ? Math.max(1, Math.floor(item.num)) : 1
+  const normalizedBundles = bundleArr.map(item => ({
+    bundle_id: Number(item?.bundle_id ?? item?.id ?? 0) || 0,
+    product_id: Number(item?.product_id) || 0,
+    num: typeof item?.num === 'number' && !Number.isNaN(item.num) ? Math.max(1, Math.floor(item.num)) : 1
   })).sort((p, q) => {
-    if (p.bundle_id !== q.bundle_id)
-      return p.bundle_id - q.bundle_id;
-    if (p.product_id !== q.product_id)
-      return p.product_id - q.product_id;
+    if (p.bundle_id !== q.bundle_id) return p.bundle_id - q.bundle_id;
+    if (p.product_id !== q.product_id) return p.product_id - q.product_id;
     return p.num - q.num;
   });
   return JSON.stringify([normalizedOpts, normalizedBundles]);
 }
+
+/**
+ * removeProductFromOrder 仅传 SKU 时的通配 identity（对象上未声明选项键）。
+ * 与显式 `product_option_item: []` 区分：后者只匹配「无选项」行。
+ */
 function isSkuOnlyDeleteIdentity(x) {
-  if (x.identity_key)
-    return false;
-  return !("product_option_item" in x) && !("product_bundle" in x);
+  if (x.identity_key) return false;
+  return !('product_option_item' in x) && !('product_bundle' in x);
 }
 function fingerprintForIdentityWithOptionKeys(x) {
   const row = x;
-  const opts = "product_option_item" in row ? Array.isArray(row.product_option_item) ? row.product_option_item : [] : [];
-  const buds = "product_bundle" in row ? Array.isArray(row.product_bundle) ? row.product_bundle : [] : [];
+  const opts = 'product_option_item' in row ? Array.isArray(row.product_option_item) ? row.product_option_item : [] : [];
+  const buds = 'product_bundle' in row ? Array.isArray(row.product_bundle) ? row.product_bundle : [] : [];
   return buildProductLineFingerprint(opts, buds);
 }
+
+/**
+ * 判断两个商品 identity 是否匹配（不透明 identity 契约）。
+ *
+ * 调用约定：始终 `isIdentityMatch(line, callerIdentity)`。
+ * - 若 SKU（product_id + product_variant_id）不一致 → 不匹配。
+ * - **双方都带** `identity_key` → 严格字符串相等比较（不再猜测合成 key / metadata 桥接）。
+ *   这是 opaque identity 契约的标准路径：UI 删改时透传 SDK 回灌的 identity_key。
+ * - 否则（即至少一侧未声明 identity_key）→ 进入「SKU 通配 / 显式空选项 / 指纹」回退路径，
+ *   忽略线侧 identity_key，按内容语义匹配。这给「行已 opaque、调用方却想按 SKU 通配 / 选项指纹删除」留兼容入口。
+ */
 function isIdentityMatch(a, b) {
-  if (a.product_id !== b.product_id || a.product_variant_id !== b.product_variant_id)
-    return false;
-  const aHasKey = typeof a.identity_key === "string" && a.identity_key.length > 0;
-  const bHasKey = typeof b.identity_key === "string" && b.identity_key.length > 0;
-  if (aHasKey && bHasKey)
-    return a.identity_key === b.identity_key;
-  if (isSkuOnlyDeleteIdentity(a) || isSkuOnlyDeleteIdentity(b))
-    return true;
+  if (a.product_id !== b.product_id || a.product_variant_id !== b.product_variant_id) return false;
+  const aHasKey = typeof a.identity_key === 'string' && a.identity_key.length > 0;
+  const bHasKey = typeof b.identity_key === 'string' && b.identity_key.length > 0;
+  if (aHasKey && bHasKey) return a.identity_key === b.identity_key;
+  if (isSkuOnlyDeleteIdentity(a) || isSkuOnlyDeleteIdentity(b)) return true;
   return fingerprintForIdentityWithOptionKeys(a) === fingerprintForIdentityWithOptionKeys(b);
 }
+
+/**
+ * 根据 identity 在商品列表中定位下标。
+ * 用于判断商品是否已存在（已存在则累加数量，否则新增）。
+ */
 function getProductIdentityIndex(products, identity) {
-  return products.findIndex((item) => isIdentityMatch(item, identity));
+  return products.findIndex(item => isIdentityMatch(item, identity));
 }
+
+/**
+ * 对外部传入的商品对象做归一化（v2 composite 语义）：
+ * - 补全可选字段默认值（未传则使用兜底值，避免后续计算时因 undefined 导致异常）
+ * - 对 num 调用 getSafeProductNum 做安全处理
+ * - 保留 _origin 供后续业务流程（如促销规则）使用
+ *
+ * 价格字段语义（metadata 权威源 + composite 派生）：
+ * - `metadata.source_product_price`：主商品/variant 基础价（已应用报价单），**不含 option**、
+ *   **不含折扣**。是推导 main_product_* 的起点。variant 分支优先读 `metadata.origin.variant[vid].price`。
+ * - `metadata.main_product_original_price`：`source + Σ(option.price × option.num)`，**含 option**、
+ *   **不含折扣**。
+ * - `metadata.main_product_selling_price`：`main_product_original_price - 主商品券 per-unit amount`，
+ *   **含 option**、**含折扣**。
+ * - 行级 `selling_price` = `main_product_selling_price + Σ(bundle_selling_price × num)`。
+ * - 行级 `original_price` = `main_product_original_price + Σ(bundle 原价 × num)`。
+ *
+ * 迁移与幂等：
+ * - `metadata.price_schema_version === 2` → 已新语义归一化，保留 main_product_* 原值（保留折扣）。
+ * - 其它情况（v1 / 缺字段 / 无 metadata）→ 按"main_product_selling_price 曾是 main-only"的旧约定
+ *   反推 legacyDiscount，再以新 source + options 基准重算。最终统一打上 `price_schema_version: 2`。
+ * - 因此多次 normalize 不会重复叠加 option/bundle。
+ */
 function normalizeOrderProduct(product) {
-  var _a, _b;
-  const metadata = { ...product.metadata || {} };
-  const resolvedIdentityKey = product.identity_key && String(product.identity_key).length > 0 ? String(product.identity_key) : (0, import_utils.createUuidV4)();
+  const metadata = {
+    ...(product.metadata || {})
+  };
+  // 不透明 identity 契约：每条订单行必须带 identity_key。
+  // 调用方未传时由 SDK 自动生成 UUID，后续 update/remove 只做严格比对，避免猜测合成 key。
+  const resolvedIdentityKey = product.identity_key && String(product.identity_key).length > 0 ? String(product.identity_key) : (0, _utils.createUuidV4)();
   if (!metadata.unique_identification_number) {
     metadata.unique_identification_number = resolvedIdentityKey;
   }
-  const normalizedBundle = (product.product_bundle || []).map((item) => ({
+  const normalizedBundle = (product.product_bundle || []).map(item => ({
     ...item,
-    bundle_selling_price: item.bundle_selling_price ?? item.price ?? "0.00"
+    bundle_selling_price: item.bundle_selling_price ?? item.price ?? '0.00'
     // custom_price: item.custom_price ?? item.bundle_selling_price ?? item.price ?? '0.00',
   }));
   const normalizedOptions = product.product_option_item || [];
-  const optionSum = (0, import_utils.sumOptionUnitPrice)(normalizedOptions);
-  const isV2 = metadata.price_schema_version === 2 || metadata.price_schema_version === "2";
+  const optionSum = (0, _utils.sumOptionUnitPrice)(normalizedOptions);
+
+  // 1) 解析 source_product_price。
+  // 优先级：
+  //   1) metadata.source_product_price（v2 权威）
+  //   2) variantPrice（命中 variant_id，从 metadata.origin.variant[vid].price 读）
+  //   3) _origin.price / _origin.base_price（后端语义的基础价）
+  //   4) v1 兼容：无 v2 标记但存在 metadata.main_product_original_price（v1 main-only，即旧 source）
+  //   5) 入参 original_price（v1 addProduct 约定：original_price 为 pre-discount 基础价）
+  //   6) 入参 selling_price（最末兜底，新添加路径 caller 只给 selling_price）
+  const isV2 = metadata.price_schema_version === 2 || metadata.price_schema_version === '2';
   const variantId = Number(product.product_variant_id || 0);
-  const variantList = variantId ? (_a = metadata == null ? void 0 : metadata.origin) == null ? void 0 : _a.variant : null;
-  const variantPrice = Array.isArray(variantList) ? (_b = variantList.find((v) => Number(v == null ? void 0 : v.id) === variantId)) == null ? void 0 : _b.price : void 0;
+  const variantList = variantId ? metadata?.origin?.variant : null;
+  const variantPrice = Array.isArray(variantList) ? variantList.find(v => Number(v?.id) === variantId)?.price : undefined;
   const resolvedSource = (() => {
-    var _a2, _b2;
-    if (metadata.source_product_price !== void 0) {
+    if (metadata.source_product_price !== undefined) {
       return String(metadata.source_product_price);
     }
-    if (variantPrice !== void 0 && variantPrice !== null) {
+    if (variantPrice !== undefined && variantPrice !== null) {
       return String(variantPrice);
     }
-    const originPrice = (_a2 = product._origin) == null ? void 0 : _a2.price;
-    if (originPrice !== void 0 && originPrice !== null) {
+    const originPrice = product._origin?.price;
+    if (originPrice !== undefined && originPrice !== null) {
       return String(originPrice);
     }
-    const originBasePrice = (_b2 = product._origin) == null ? void 0 : _b2.base_price;
-    if (originBasePrice !== void 0 && originBasePrice !== null) {
+    const originBasePrice = product._origin?.base_price;
+    if (originBasePrice !== undefined && originBasePrice !== null) {
       return String(originBasePrice);
     }
-    if (!isV2 && metadata.main_product_original_price !== void 0) {
+    if (!isV2 && metadata.main_product_original_price !== undefined) {
       return String(metadata.main_product_original_price);
     }
-    return product.original_price ?? product.selling_price ?? "0.00";
+    return product.original_price ?? product.selling_price ?? '0.00';
   })();
-  const mainOriginalDec = new import_decimal.default(Number(resolvedSource) || 0).plus(optionSum);
+
+  // 2) 派生 main_product_original_price（含 option、不含折扣）
+  const mainOriginalDec = new _decimal.default(Number(resolvedSource) || 0).plus(optionSum);
   const mainOriginalStr = mainOriginalDec.toDecimalPlaces(2).toFixed(2);
+
+  // 3) 派生 main_product_selling_price（含 option、含主商品折扣）
+  //    - v2 数据：直接沿用 metadata.main_product_selling_price（保留折扣）
+  //    - v1 metadata：main_product_selling_price 旧语义是 main-only（≈ source-level 折后价），
+  //      反推 legacyDiscount = main_original(旧) - main_selling(旧)，再用新 main_original - legacyDiscount
+  //    - v1 addProduct 入参：top-level selling_price < original_price 表示主商品折扣；
+  //      用差额作为 legacyDiscount 映射到新 main_selling
+  //    - 其它：视为无折扣，main_selling = main_original
   let mainSellingDec;
   if (isV2 && metadata.main_product_selling_price != null) {
-    mainSellingDec = new import_decimal.default(Number(metadata.main_product_selling_price) || 0);
+    mainSellingDec = new _decimal.default(Number(metadata.main_product_selling_price) || 0);
   } else if (metadata.main_product_selling_price != null && metadata.main_product_original_price != null) {
-    const legacyOriginal = new import_decimal.default(Number(metadata.main_product_original_price) || 0);
-    const legacySelling = new import_decimal.default(Number(metadata.main_product_selling_price) || 0);
+    const legacyOriginal = new _decimal.default(Number(metadata.main_product_original_price) || 0);
+    const legacySelling = new _decimal.default(Number(metadata.main_product_selling_price) || 0);
     const legacyDiscount = legacyOriginal.minus(legacySelling);
     mainSellingDec = mainOriginalDec.minus(legacyDiscount);
-  } else if (product.original_price != null && product.selling_price != null && new import_decimal.default(Number(product.original_price) || 0).greaterThan(
-    new import_decimal.default(Number(product.selling_price) || 0)
-  )) {
-    const topOriginal = new import_decimal.default(Number(product.original_price) || 0);
-    const topSelling = new import_decimal.default(Number(product.selling_price) || 0);
+  } else if (product.original_price != null && product.selling_price != null && new _decimal.default(Number(product.original_price) || 0).greaterThan(new _decimal.default(Number(product.selling_price) || 0))) {
+    const topOriginal = new _decimal.default(Number(product.original_price) || 0);
+    const topSelling = new _decimal.default(Number(product.selling_price) || 0);
     const legacyDiscount = topOriginal.minus(topSelling);
     mainSellingDec = mainOriginalDec.minus(legacyDiscount);
   } else {
     mainSellingDec = mainOriginalDec;
   }
   const mainSellingStr = mainSellingDec.toDecimalPlaces(2).toFixed(2);
+
+  // 4) 落盘 metadata：三字段 + schema 版本 sentinel
   metadata.source_product_price = resolvedSource;
   metadata.main_product_original_price = mainOriginalStr;
   metadata.main_product_selling_price = mainSellingStr;
   metadata.price_schema_version = 2;
-  const composedSellingPrice = (0, import_utils.composeLinePrice)({
+
+  // 5) 合成行级 composite（main 已含 option，本步只叠 bundle）
+  const composedSellingPrice = (0, _utils.composeLinePrice)({
     mainPrice: mainSellingStr,
     bundle: normalizedBundle
   });
-  const composedOriginalPrice = (0, import_utils.composeLinePrice)({
+  const composedOriginalPrice = (0, _utils.composeLinePrice)({
     mainPrice: mainOriginalStr,
     bundle: normalizedBundle,
     useOriginalBundle: true
@@ -482,177 +552,148 @@ function normalizeOrderProduct(product) {
     product_option_item: normalizedOptions,
     selling_price: composedSellingPrice,
     original_price: composedOriginalPrice,
-    tax_fee: product.tax_fee || "0.00",
+    tax_fee: product.tax_fee || '0.00',
     is_charge_tax: product.is_charge_tax ?? 0,
     discount_list: product.discount_list || [],
     product_bundle: normalizedBundle,
     metadata,
-    note: product.note != null ? String(product.note) : "",
+    note: product.note != null ? String(product.note) : '',
     _origin: product._origin
   };
 }
+
+/**
+ * 从 reservation.enabled_reservation_rules 中收集 type=link 的商品 id。
+ */
 function collectLinkProductIdsFromReservationRules(rules) {
-  if (!Array.isArray(rules))
-    return [];
+  if (!Array.isArray(rules)) return [];
   const ids = [];
   for (const entry of rules) {
-    if (!entry || typeof entry !== "object")
-      continue;
+    if (!entry || typeof entry !== 'object') continue;
     const rec = entry;
-    if (rec.type !== "link")
-      continue;
-    if (!Array.isArray(rec.value))
-      continue;
+    if (rec.type !== 'link') continue;
+    if (!Array.isArray(rec.value)) continue;
     for (const v of rec.value) {
       const n = Number(v);
-      if (Number.isFinite(n) && n > 0)
-        ids.push(Math.floor(n));
+      if (Number.isFinite(n) && n > 0) ids.push(Math.floor(n));
     }
   }
   return [...new Set(ids)];
 }
+
+/**
+ * 找到第一个归属指定桌台的预约规则商品。
+ * 归属判断基于商品资源中的 default_resource / optional_resource。
+ */
 function findReservationRuleProductByResourceId(products, resourceId) {
-  var _a;
   const numericResourceId = Number(resourceId);
-  if (!Number.isFinite(numericResourceId) || numericResourceId <= 0)
-    return void 0;
+  if (!Number.isFinite(numericResourceId) || numericResourceId <= 0) return undefined;
   for (const product of products) {
-    const resources = (_a = product == null ? void 0 : product.product_resource) == null ? void 0 : _a.resources;
-    if (!Array.isArray(resources))
-      continue;
-    const hasMatchedResource = resources.some((resource) => {
-      const defaultResources = Array.isArray(resource == null ? void 0 : resource.default_resource) ? resource.default_resource : [];
-      const optionalResources = Array.isArray(resource == null ? void 0 : resource.optional_resource) ? resource.optional_resource : [];
-      return [...defaultResources, ...optionalResources].some(
-        (id) => Number(id) === numericResourceId
-      );
+    const resources = product?.product_resource?.resources;
+    if (!Array.isArray(resources)) continue;
+    const hasMatchedResource = resources.some(resource => {
+      const defaultResources = Array.isArray(resource?.default_resource) ? resource.default_resource : [];
+      const optionalResources = Array.isArray(resource?.optional_resource) ? resource.optional_resource : [];
+      return [...defaultResources, ...optionalResources].some(id => Number(id) === numericResourceId);
     });
-    if (hasMatchedResource)
-      return product;
+    if (hasMatchedResource) return product;
   }
-  return void 0;
+  return undefined;
 }
+
+/**
+ * 返回列表中第一个带有效 duration.value（分钟）的商品时长。
+ */
 function pickFirstDurationMinutesFromProducts(products) {
-  var _a;
   for (const product of products) {
-    const value = (_a = product == null ? void 0 : product.duration) == null ? void 0 : _a.value;
+    const value = product?.duration?.value;
     const n = Number(value);
-    if (Number.isFinite(n) && n > 0)
-      return Math.floor(n);
+    if (Number.isFinite(n) && n > 0) return Math.floor(n);
   }
-  return void 0;
+  return undefined;
 }
+
+/** 是否存在 capacity.type === 'custom' 的商品 */
 function hasCustomCapacityProduct(products) {
-  return products.some((p) => {
-    var _a;
-    return ((_a = p == null ? void 0 : p.capacity) == null ? void 0 : _a.type) === "custom";
-  });
+  return products.some(p => p?.capacity?.type === 'custom');
 }
+
+/**
+ * 根据预约规则商品的 resource.type 计算桌台是否已被"占满"。
+ * - single：只要有 `lastOrderId` 即视为占用
+ * - multiple：当前时间落在 `capacity_list[i]` 的 `[start_at, end_at]`（inclusive）内的 pax 之和 >= 总容量
+ * - 其他（'capacity' / undefined）：返回 false，不施加限制
+ */
 function computeResourceIsFull(params) {
-  const { resourceSelectType, lastOrderId, capacityList, capacity } = params;
-  if (resourceSelectType === "single")
-    return Boolean(lastOrderId);
-  if (resourceSelectType !== "multiple")
-    return false;
+  const {
+    resourceSelectType,
+    lastOrderId,
+    capacityList,
+    capacity
+  } = params;
+  if (resourceSelectType === 'single') return Boolean(lastOrderId);
+  if (resourceSelectType !== 'multiple') return false;
   const totalCapacity = Number(capacity);
-  if (!Number.isFinite(totalCapacity) || totalCapacity <= 0)
-    return false;
-  const now = (0, import_dayjs.default)();
+  if (!Number.isFinite(totalCapacity) || totalCapacity <= 0) return false;
+  const now = (0, _dayjs.default)();
   let occupied = 0;
   for (const slot of capacityList || []) {
-    const start = (0, import_dayjs.default)(slot == null ? void 0 : slot.start_at);
-    const end = (0, import_dayjs.default)(slot == null ? void 0 : slot.end_at);
-    if (!start.isValid() || !end.isValid())
-      continue;
+    const start = (0, _dayjs.default)(slot?.start_at);
+    const end = (0, _dayjs.default)(slot?.end_at);
+    if (!start.isValid() || !end.isValid()) continue;
     if ((now.isAfter(start) || now.isSame(start)) && (now.isBefore(end) || now.isSame(end))) {
-      const pax = Number(slot == null ? void 0 : slot.pax);
-      if (Number.isFinite(pax) && pax > 0)
-        occupied += pax;
+      const pax = Number(slot?.pax);
+      if (Number.isFinite(pax) && pax > 0) occupied += pax;
     }
   }
   return occupied >= totalCapacity;
 }
+
+/**
+ * 在商品列表中找到第一个 `capacity.type === 'custom'` 的商品，取其 `custom` 数组第一项的 min/max。
+ * 仅返回有限数字字段；若均无法解析则返回 `undefined`。
+ */
 function pickFirstCustomCapacityPaxBounds(products) {
   for (const p of products) {
-    const cap = p == null ? void 0 : p.capacity;
-    if (!cap || cap.type !== "custom")
-      continue;
-    if (!Array.isArray(cap.custom) || cap.custom.length === 0)
-      continue;
+    const cap = p?.capacity;
+    if (!cap || cap.type !== 'custom') continue;
+    if (!Array.isArray(cap.custom) || cap.custom.length === 0) continue;
     const row = cap.custom[0];
-    if (!row || typeof row !== "object")
-      continue;
+    if (!row || typeof row !== 'object') continue;
     const raw = row;
     const out = {};
-    if (raw.min !== null && raw.min !== void 0 && raw.min !== "") {
+    if (raw.min !== null && raw.min !== undefined && raw.min !== '') {
       const min = Number(raw.min);
-      if (Number.isFinite(min))
-        out.min = min;
+      if (Number.isFinite(min)) out.min = min;
     }
-    if (raw.max !== null && raw.max !== void 0 && raw.max !== "") {
+    if (raw.max !== null && raw.max !== undefined && raw.max !== '') {
       const max = Number(raw.max);
-      if (Number.isFinite(max))
-        out.max = max;
+      if (Number.isFinite(max)) out.max = max;
     }
-    if (out.min !== void 0 || out.max !== void 0)
-      return out;
+    if (out.min !== undefined || out.max !== undefined) return out;
   }
-  return void 0;
+  return undefined;
 }
+
+/**
+ * 第一个 `capacity.type === 'custom'` 的商品，取其 `custom[0].id`（提交 booking metadata.capacity 维度 id）。
+ * 无匹配时返回 `undefined`，调用方应回退为 `0`。
+ */
 function pickFirstCustomCapacityDimensionId(products) {
   for (const p of products) {
-    const cap = p == null ? void 0 : p.capacity;
-    if (!cap || cap.type !== "custom")
-      continue;
-    if (!Array.isArray(cap.custom) || cap.custom.length === 0)
-      continue;
+    const cap = p?.capacity;
+    if (!cap || cap.type !== 'custom') continue;
+    if (!Array.isArray(cap.custom) || cap.custom.length === 0) continue;
     const row = cap.custom[0];
-    if (!row || typeof row !== "object")
-      continue;
+    if (!row || typeof row !== 'object') continue;
     const id = row.id;
-    if (id === null || id === void 0 || id === "")
-      continue;
-    if (typeof id === "number" && Number.isFinite(id))
-      return id;
-    if (typeof id === "string") {
+    if (id === null || id === undefined || id === '') continue;
+    if (typeof id === 'number' && Number.isFinite(id)) return id;
+    if (typeof id === 'string') {
       const trimmed = id.trim();
-      if (!trimmed)
-        continue;
+      if (!trimmed) continue;
       return trimmed;
     }
   }
-  return void 0;
-}
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  aggregateItemRuleLimit,
-  attachItemRuleLimitsToTopLevelProducts,
-  buildItemRuleBusinessData,
-  buildProductKey,
-  buildProductLineFingerprint,
-  buildQuantityLimitIndex,
-  collectLinkProductIdsFromReservationRules,
-  computeResourceIsFull,
-  createEmptySummary,
-  extractStrategyModelIdsFromTableConfig,
-  findReservationRuleProductByResourceId,
-  getProductIdentityIndex,
-  getSafeProductNum,
-  getTopLevelProductId,
-  getTopLevelVariantId,
-  hasCustomCapacityProduct,
-  isIdentityMatch,
-  isSkuOnlyDeleteIdentity,
-  normalizeEnabledItemRuleIds,
-  normalizeItemRuleStrategies,
-  normalizeOrderProduct,
-  pickFirstCustomCapacityDimensionId,
-  pickFirstCustomCapacityPaxBounds,
-  pickFirstDurationMinutesFromProducts,
-  resolveSkuMatchedQuantityLimits,
-  toBoolean,
-  toNonNegativeInt,
-  toNonNegativeNumber,
-  toPositiveString,
-  toPriceString
-});
+  return undefined;
+}