@pisell/pisellos 2.2.244 → 2.2.246

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

@@ -0,0 +1,206 @@
+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);
+
+// 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
+});
+module.exports = __toCommonJS(manualProductDiscount_exports);
+var import_decimal = __toESM(require("decimal.js"));
+function resolveSafeProductNum(num) {
+  const parsed = Number(num);
+  if (!Number.isFinite(parsed) || parsed <= 0)
+    return 1;
+  return Math.floor(parsed);
+}
+function syncManualProductDiscountProductNum(discountList, productNum) {
+  const quantity = resolveSafeProductNum(productNum);
+  return (discountList || []).map((item) => {
+    if ((item == null ? void 0 : item.type) !== "product")
+      return item;
+    return {
+      ...item,
+      discount: {
+        ...item.discount || {},
+        product_num: quantity
+      }
+    };
+  });
+}
+function resolveManualDiscountOriginTotal(sources) {
+  const candidates = [
+    sources.originTotal,
+    sources.extendOriginTotal,
+    sources.originExtendOriginTotal,
+    sources.sourceExtendOriginTotal
+  ];
+  for (const candidate of candidates) {
+    if (candidate === void 0 || candidate === null || candidate === "")
+      continue;
+    const parsed = Number(candidate);
+    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 NaN;
+}
+function resolveManualDiscountReasonFromSources(sources) {
+  for (const candidate of [
+    sources.discountReason,
+    sources.extendDiscountReason,
+    sources.originExtendDiscountReason
+  ]) {
+    if (candidate != null && String(candidate).trim() !== "") {
+      return String(candidate);
+    }
+  }
+  return "";
+}
+function hasManualProductDiscountFlag(metadata) {
+  if (!metadata)
+    return false;
+  const override = metadata.price_override;
+  if (override !== void 0 && override !== null && override !== "") {
+    return true;
+  }
+  return metadata.is_manual_discount === 1 || metadata.is_manual_discount === true;
+}
+function ensureManualProductDiscountList(params) {
+  var _a, _b, _c, _d, _e, _f, _g, _h;
+  const list = params.discountList || [];
+  const quantity = resolveSafeProductNum(params.quantity);
+  if (findManualProductDiscountItem(list)) {
+    return syncManualProductDiscountProductNum(list, quantity);
+  }
+  const metadata = params.metadata || {};
+  const originalNum = Number(params.originalPrice);
+  const sellingNum = Number(params.sellingPrice);
+  const hasPriceOverride = hasManualProductDiscountFlag(metadata);
+  const shouldBuild = shouldBuildManualProductDiscount({
+    hasPriceOverride,
+    originTotal: originalNum,
+    sellingTotal: sellingNum
+  });
+  if (!shouldBuild) {
+    return list;
+  }
+  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
+    })
+  );
+}
+function findManualProductDiscountItem(discountList) {
+  return (discountList || []).find((item) => (item == null ? void 0 : item.type) === "product");
+}
+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() !== "") {
+    return String(message);
+  }
+  return fallback ?? "";
+}
+function stripManualProductDiscountItems(discountList) {
+  return (discountList || []).filter((item) => (item == null ? void 0 : item.type) !== "product");
+}
+function buildManualProductDiscountItem(params) {
+  const origin = new import_decimal.default(Number(params.originTotal) || 0);
+  const selling = new import_decimal.default(Number(params.sellingTotal) || 0);
+  const diff = origin.minus(selling);
+  const quantity = resolveSafeProductNum(params.quantity);
+  return {
+    amount: diff.toDecimalPlaces(2).toNumber(),
+    type: "product",
+    discount: {
+      message: params.message ?? "",
+      discountway: params.discountway ?? "num",
+      product_num: quantity,
+      discount_per: params.discount_per ?? "",
+      discount_type: diff.isNegative() ? "change_price" : "discount"
+    }
+  };
+}
+function mergeManualProductDiscountIntoList(discountList, manualItem) {
+  const base = stripManualProductDiscountItems(discountList);
+  if (!manualItem)
+    return base;
+  if (manualItem.amount === 0 && !manualItem.discount.message)
+    return base;
+  return [...base, manualItem];
+}
+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
+});

package/lib/modules/Order/utils.d.ts

@@ -1,8 +1,19 @@
 import Decimal from 'decimal.js';
-import { CartItem } from "../Cart";
-import type { OrderSubmitPayload, OrderSubmitProduct, OrderSummary, OrderTempOrder } from './types';
+import type { CartItem } from "../Cart";
+import type { OrderProductDiscountItem, OrderProduct, OrderSubmitPayload, OrderSubmitProduct, OrderSummary, OrderTempOrder } from './types';
 import type { RulesParamsHooks } from '../Rules/types';
 import type { MapOrderPaymentsOptions, OrderPaymentData, OrderPaymentSource } from './types';
+export interface OrderProductsDepositProtocol {
+    id: number;
+    title: string;
+}
+export interface OrderProductsDepositSummary {
+    total: number;
+    totalText: string;
+    protocols: OrderProductsDepositProtocol[];
+    deposit_policy_ids: number[];
+    hasDeposit: boolean;
+}
 /**
  * 把"含 option 的主商品单价"与 bundle 合成"单行 composite 单价"。
  *
@@ -21,21 +32,68 @@ export declare function composeLinePrice(params: {
     bundle?: Array<{
         bundle_selling_price?: any;
         price?: any;
+        custom_price?: any;
         num?: any;
         quantity?: any;
         original_price?: any;
         product_price?: any;
+        price_type?: any;
+        price_type_ext?: any;
+        custom_price_type?: any;
+        custom_price_type_ext?: any;
+        option?: Array<{
+            add_price?: any;
+            price?: any;
+            num?: any;
+        }>;
     }> | null;
     useOriginalBundle?: boolean;
 }): string;
+export declare function normalizeProductSkuOptions(options?: unknown): Record<string, any>[];
+export declare function ensureProductSku(product?: Record<string, any> | null): Record<string, any> & {
+    option: Record<string, any>[];
+};
+export declare function getProductSkuOptions(product?: Record<string, any> | null): Record<string, any>[];
 /**
- * 计算 option 单价合计：Σ(option.price × option.num)。
+ * 计算 option 单价合计：Σ(option.add_price × option.num)。
+ * 兼容入参仍带旧 `price` 的调用方，但运行时归一化后只维护 `add_price`。
  * 在新语义 v2 下，main_product_original_price = source_product_price + 本函数结果。
  */
 export declare function sumOptionUnitPrice(options?: Array<{
+    add_price?: any;
     price?: any;
     num?: any;
 }> | null): Decimal;
+/**
+ * 仅基于 tempOrder.products 重算整单定金。
+ *
+ * 对齐 Checkout relation_products 分支：商品定金先按商品规则计算，
+ * 再扣减商品券/折扣卡抵扣金额；tempOrder.bookings 不参与这里的计算。
+ */
+export declare function calculateOrderProductsDeposit(products?: OrderProduct[], options?: {
+    productsByUid?: Record<string, Record<string, any>>;
+}): OrderProductsDepositSummary;
+/**
+ * 判定套餐子商品是否为 markdown（减价）类型。
+ * 与后端口径一致：price_type='markdown' 且 price_type_ext 非 'product_price'（原价子商品）。
+ */
+export declare function isMarkdownBundle(bundle: Record<string, any> | null | undefined): boolean;
+/**
+ * 套餐子商品对「行价」的带符号单位贡献（与后端 markdown 口径对齐）。
+ *
+ * - markdown（减价）：净额 = |catalog 毛价| − Σ(option.add_price×num)，**取负**（行内减）。
+ *   catalog 毛价优先 `price`/`custom_price`（避免读已落净额的 `bundle_selling_price` 造成 option 二次扣减）；
+ *   仅当毛价缺失（历史/hydrate 仅剩净额）时退回 `bundle_selling_price`，且此时不再扣 option。
+ * - markup（加价）/原价子商品：维持 `+(bundle_selling_price ?? price)`，行为不变。
+ */
+export declare function getBundleSignedUnit(bundle: Record<string, any> | null | undefined, options?: {
+    useOriginal?: boolean;
+}): Decimal;
+/**
+ * 套餐子商品 `bundle_selling_price` 的存储净额（正值幅度）。
+ * markdown 取净额绝对值（3.70）；markup/原价维持原值。
+ */
+export declare function getBundleSellingMagnitude(bundle: Record<string, any> | null | undefined): Decimal;
 /**
  * OrderModule 默认 Rules 钩子工厂。
  *
@@ -48,7 +106,7 @@ export declare function sumOptionUnitPrice(options?: Array<{
  *   不含折扣。**权威源**。
  * - `metadata.main_product_original_price` = source + Σ(option.price × option.num)（含 option、不含折扣）。
  * - `metadata.main_product_selling_price` = main_original − 主商品券 per-unit amount（含 option、含折扣）。
- * - `payment_price`：出站 payload 中由 `selling_price` 派生以兼容后端（composite）。
+ * - `payment_price`：出站 payload 中为行 composite 已减整单折扣均摊价（无折扣时与 `selling_price` 同义）。
  *
  * Rules 钩子契约（hook_adapt 方案，Rules 内部保持不变）：
  * - `getProduct.price` / `getProduct.original_price` 回传 **source-level 主价**
@@ -65,6 +123,37 @@ export declare function sumOptionUnitPrice(options?: Array<{
  *
  * 导出为纯函数方便单测直接驱动钩子，不依赖 OrderModule 实例。
  */
+/** Rules calcDiscount 用手动价标记；undefined 表示交给 Rules 用 total/origin_total 推断 */
+export declare function resolveRulesManualDiscountFlag(metadata: Record<string, any> | null | undefined): boolean | undefined;
+/**
+ * 商品行折扣只保留后端 OrderProductDiscountItem 协议字段。
+ * Rules/券计算过程中的 `_num`、`config` 等运行态字段不应进入 tempOrder 或提交 payload。
+ */
+export declare function normalizeOrderProductDiscountList(discountList?: unknown[] | null): OrderProductDiscountItem[];
+/**
+ * 手动改价（price_override）时行级 original_price（composite 单价）：
+ * 购物车划线价应对齐 metadata.origin._extend.origin_total（改价前单价 composite，如 40），
+ * 而非 bundle 子项 catalog 原价合成的 composedOriginalPrice（如 30）。
+ *
+ * origin_total 与 SkuDetailModal / cacheItem._extend 一致，为单价语义，不再除以 num。
+ */
+export declare function resolveManualOverrideLineOriginalPrice(params: {
+    num?: number;
+    metadata?: Record<string, any> | null;
+    /** 已有行级 original_price（origin 被裁剪时兜底划线价） */
+    lineOriginalPrice?: string | number | null;
+}, fallbackCompositeOriginal: string): string;
+/**
+ * 计算商品行「每单位有效折扣」：discount_list 合计 + 被 Rules 剥离但仍 inPromotion 的差额。
+ *
+ * Rules.calcDiscount 会把 type=promotion 从 discount_list 去掉，但 metadata._promotion 仍保留；
+ * applyProductDiscountPrices 必须回读 _promotion，否则抬价/降价都会在第二步被 source 原价覆盖。
+ *
+ * @example
+ * resolveEffectivePerUnitDiscount({ metadata: { _promotion: { inPromotion: true, originalPrice: 1, finalPrice: 5 } }, discount_list: [] });
+ * // => -4
+ */
+export declare function resolveEffectivePerUnitDiscount(product: Record<string, any>): number;
 export declare function createDefaultOrderRulesHooks(): RulesParamsHooks;
 /**
  * 通过 session 类商品的开始时间结束时间生成商品的时长
@@ -118,6 +207,8 @@ export declare function buildSubmitPayload(params: {
     businessCode?: string;
     channel?: string;
     type?: string;
+    summary?: OrderSummary | null;
+    request_unique_idempotency_token?: string;
     enhance?: SubmitPayloadEnhancer;
 }): OrderSubmitPayload;
 export declare function mapPaymentItemToOrderPayment(paymentItem: OrderPaymentSource): OrderPaymentData;
@@ -131,7 +222,7 @@ export declare function mapPaymentItemsToOrderPayments(paymentItems: OrderPaymen
 export declare function formatV1Product(products: OrderSubmitProduct[]): {
     bundle: any[];
     key: number | null;
-    option: any;
+    option: any[];
     product_id: number | null;
     product_variant_id: number;
     num: number;
@@ -140,4 +231,55 @@ export declare function formatV1Product(products: OrderSubmitProduct[]): {
     session: null;
     unique: string;
 }[];
+/**
+ * 判断 holder_id 是否已分配（非空）。
+ *
+ * @example
+ * hasAssignedHolderId(12); // true
+ * hasAssignedHolderId([]); // false
+ */
+export declare function hasAssignedHolderId(value: unknown): boolean;
+/**
+ * 清空 tempOrder 购物车行上的 holder 分配（products / bookings / runtime origin）。
+ * 移除或更换下单客户时调用，与 booking 页换客户清 holder 行为对齐。
+ *
+ * @example
+ * clearTempOrderHolderAssignments(tempOrder);
+ */
+export declare function clearTempOrderHolderAssignments(tempOrder: OrderTempOrder): boolean;
+/**
+ * 读取购物车行的 stable uid（优先 metadata.unique_identification_number）。
+ *
+ * @example
+ * getOrderProductLineUid({ metadata: { unique_identification_number: 'line-1' } }); // 'line-1'
+ */
+export declare function getOrderProductLineUid(product: Record<string, any> | null | undefined): string | null;
+/**
+ * 判断展示字段是否为空（含 i18n 对象全空）。
+ *
+ * @example
+ * isEmptyOrderProductDisplayValue(''); // true
+ * isEmptyOrderProductDisplayValue({ auto: '桌台费' }); // false
+ */
+export declare function isEmptyOrderProductDisplayValue(value: unknown): boolean;
+/**
+ * calcDiscount / applyDiscount 回写时 Rules 往往不带 product_title 等展示字段；
+ * 用旧行补齐，避免编辑态 hydrate 后标题被冲掉。
+ *
+ * @example
+ * mergeOrderProductDisplayFields(
+ *   { product_title: { auto: '桌台费' }, metadata: { unique_identification_number: 'u1' } },
+ *   { selling_price: '10.00', metadata: { unique_identification_number: 'u1' } },
+ * );
+ */
+export declare function mergeOrderProductDisplayFields(previous: Record<string, any>, next: Record<string, any>): Record<string, any>;
+/**
+ * 按 uid 索引 tempOrder.products，供 applyDiscount 合并展示字段。
+ *
+ * @example
+ * indexOrderProductsByUid([{ metadata: { unique_identification_number: 'u1' } }]);
+ */
+export declare function indexOrderProductsByUid(products: Array<Record<string, any>> | null | undefined): Map<string, Record<string, any>>;
 export { createEmptySummary } from '../../solution/ScanOrder/utils';
+export { buildManualProductDiscountItem, ensureManualProductDiscountList, findManualProductDiscountItem, mergeManualProductDiscountIntoList, resolveManualDiscountMessage, resolveManualDiscountOriginTotal, resolveManualDiscountReasonFromSources, resolveSafeProductNum, shouldBuildManualProductDiscount, syncManualProductDiscountProductNum, stripManualProductDiscountItems, } from './utils/manualProductDiscount';
+export type { ManualProductDiscountItem } from './utils/manualProductDiscount';