@pisell/pisellos 2.2.174 → 2.2.176

package/dist/modules/Order/types.d.ts

@@ -13,7 +13,106 @@ export declare enum OrderHooks {
     OnOrderUpdate = "order:onOrderUpdate",
     OnOrderCancel = "order:onOrderCancel",
     OnOrderStatusChange = "order:onOrderStatusChange",
-    OnOrderCustomerChange = "order:onOrderCustomerChange"
+    OnOrderCustomerChange = "order:onOrderCustomerChange",
+    OnPromotionApplied = "order:onPromotionApplied"
+}
+/**
+ * 促销评估器协议（OS 与 PromotionEvaluator 之间的桥接接口）。
+ *
+ * 与 `pisell_os/src/model/strategy/adapter/promotion/evaluator.ts` 中的
+ * `PromotionEvaluator` 实例结构保持兼容。SalesSdkProvider 会从 `appHelper.utils.promotionEvaluator`
+ * 读取实例并通过 `setPromotionEvaluator` 注入到 OrderModule。
+ *
+ * 这里只声明 OrderModule 需要调用的子集，避免反向依赖具体 evaluator 实现。
+ */
+export interface OrderPromotionEvaluator {
+    evaluateCartWithPricing(input: {
+        products: any[];
+        channel?: string;
+    }): any;
+    getProductsApplicableStrategies(input: {
+        products: any[];
+        channel?: string;
+    }, matchVariant?: boolean): any[];
+}
+/** 赠品解析回调 context（OS → SDK 的请求体） */
+export interface OrderGiftSelectContext {
+    strategyId: string;
+    strategyName: string | Record<string, string>;
+    giftCount: number;
+    giftOptions: Array<{
+        product_id: number;
+        product_variant_id: number;
+    }>;
+    /** 触发此赠品的主商品 metadata.unique_identification_number 列表 */
+    sourceProductIds: string[];
+}
+/**
+ * 赠品解析回调签名（SDK → OS 的返回值）。
+ *
+ * - 单选项：SDK 内部自动构造商品，不弹窗
+ * - 多选项：SDK 弹窗等用户确认后构造
+ * - 用户取消：抛错或返回空数组（OS 视为放弃本次添加）
+ *
+ * 返回的 OrderProduct 必须是完整的购物车行（含 metadata._giftInfo 标记），OS 会直接 push 入 tempOrder.products。
+ */
+export type OrderGiftSelectResolver = (ctx: OrderGiftSelectContext) => Promise<Partial<OrderProduct>[] | null>;
+/** 未满足的促销策略（购物车底部 alert 渲染源） */
+export interface OrderUnfulfilledPromotion {
+    strategyId: string;
+    strategyName: string | Record<string, string>;
+    actionType: string;
+    needQuantity: number;
+    currentQuantity: number;
+    requiredQuantity: number;
+    eligibleProducts: Array<{
+        product_id: number;
+        product_variant_id: number;
+    }>;
+    strategyMetadata?: any;
+    display?: {
+        text: string | Record<string, string>;
+        type: string;
+    };
+}
+/** 上一次 applyPromotion 计算出的赠品操作（仅供调试/读取使用） */
+export interface OrderLastGiftActions {
+    toAdd: Array<{
+        strategyId: string;
+        strategyName: string | Record<string, string>;
+        giftCount: number;
+        giftOptions: Array<{
+            product_id: number;
+            product_variant_id: number;
+        }>;
+        sourceProductIds: string[];
+    }>;
+    toReduce: Array<{
+        strategyId: string;
+        items: Array<{
+            uid: string;
+            currentQuantity: number;
+            newQuantity: number;
+        }>;
+    }>;
+    toRemove: string[];
+}
+/** onPromotionApplied 事件 payload */
+export interface OrderPromotionAppliedPayload {
+    unfulfilledPromotions: OrderUnfulfilledPromotion[];
+    giftActions: OrderLastGiftActions;
+    /** evaluator 返回的赠品摘要 */
+    gifts: Array<{
+        strategyId: string;
+        strategyName: string | Record<string, string>;
+        giftCount: number;
+        giftOptions: Array<{
+            product_id: number;
+            product_variant_id: number;
+        }>;
+    }>;
+    /** 处理后的商品列表 */
+    products: OrderProduct[];
 }
 /**
  * tempOrder 上的下单客户协议字段视图。
@@ -561,6 +660,46 @@ export interface OrderModuleAPI {
     }) => Promise<Discount[]>;
     getDiscountList: () => Discount[];
     applyDiscount: () => void;
+    /**
+     * 注入促销评估器。
+     *
+     * SalesSdkProvider 在初始化 bookingTicket 后会自动从 `appHelper.utils.promotionEvaluator`
+     * 读取实例并调用本方法注入。host 透明，业务 UI 不感知。
+     *
+     * @example
+     * order.setPromotionEvaluator(appHelper.utils.promotionEvaluator);
+     */
+    setPromotionEvaluator: (evaluator: OrderPromotionEvaluator | null) => void;
+    /**
+     * 注入赠品选择 resolver。OS 在 applyPromotion 内部当需要新增赠品时会 await 调用 resolver。
+     *
+     * 缺省时 OS 会 `console.warn` 并跳过新增（既有赠品的 reduce/remove 仍会执行）。
+     *
+     * @example
+     * order.setGiftSelectResolver((ctx) => giftSelectBridge.request(ctx));
+     */
+    setGiftSelectResolver: (resolver: OrderGiftSelectResolver | null) => void;
+    /**
+     * 为商品目录追加促销标签。
+     *
+     * @example
+     * const taggedProducts = order.appendPromotionTags(products);
+     */
+    appendPromotionTags: <T extends Record<string, any>>(products: T[]) => T[];
+    /**
+     * 应用购物车促销（评估 → 差异化赠品 → 写回 tempOrder.products → emit onPromotionApplied）。
+     *
+     * 自动在 addProductToOrder / updateOrderProductQuantity / removeProductFromOrder /
+     * clearOrderCartLines / setOrderCustomer 等写路径末尾触发，业务一般无需手动调用。
+     *
+     * 多选项赠品依赖 giftSelectResolver；如未注入则跳过且 console.warn。
+     * 内部以 `_isApplyingPromotion` flag 防递归。
+     */
+    applyPromotion: () => Promise<void>;
+    /** 读取上次 applyPromotion 产出的未满足促销提示 */
+    getUnfulfilledPromotions: () => OrderUnfulfilledPromotion[];
+    /** 读取上次 applyPromotion 产出的赠品操作 diff（toAdd / toReduce / toRemove） */
+    getLastGiftActions: () => OrderLastGiftActions | null;
     /**
    * 取消订单
    * @param params 取消订单参数

package/dist/modules/Order/types.js

@@ -4,9 +4,38 @@ export var OrderHooks = /*#__PURE__*/function (OrderHooks) {
   OrderHooks["OnOrderCancel"] = "order:onOrderCancel";
   OrderHooks["OnOrderStatusChange"] = "order:onOrderStatusChange";
   OrderHooks["OnOrderCustomerChange"] = "order:onOrderCustomerChange";
+  OrderHooks["OnPromotionApplied"] = "order:onPromotionApplied";
   return OrderHooks;
 }({});
 
+/**
+ * 促销评估器协议（OS 与 PromotionEvaluator 之间的桥接接口）。
+ *
+ * 与 `pisell_os/src/model/strategy/adapter/promotion/evaluator.ts` 中的
+ * `PromotionEvaluator` 实例结构保持兼容。SalesSdkProvider 会从 `appHelper.utils.promotionEvaluator`
+ * 读取实例并通过 `setPromotionEvaluator` 注入到 OrderModule。
+ *
+ * 这里只声明 OrderModule 需要调用的子集，避免反向依赖具体 evaluator 实现。
+ */
+
+/** 赠品解析回调 context（OS → SDK 的请求体） */
+
+/**
+ * 赠品解析回调签名（SDK → OS 的返回值）。
+ *
+ * - 单选项：SDK 内部自动构造商品，不弹窗
+ * - 多选项：SDK 弹窗等用户确认后构造
+ * - 用户取消：抛错或返回空数组（OS 视为放弃本次添加）
+ *
+ * 返回的 OrderProduct 必须是完整的购物车行（含 metadata._giftInfo 标记），OS 会直接 push 入 tempOrder.products。
+ */
+
+/** 未满足的促销策略（购物车底部 alert 渲染源） */
+
+/** 上一次 applyPromotion 计算出的赠品操作（仅供调试/读取使用） */
+
+/** onPromotionApplied 事件 payload */
+
 /**
  * tempOrder 上的下单客户协议字段视图。
  * 这些字段会随订单提交到后端。

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

@@ -85,6 +85,17 @@ export declare function resolveManualOverrideLineOriginalPrice(params: {
     /** 已有行级 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 类商品的开始时间结束时间生成商品的时长

package/dist/modules/Order/utils.js

@@ -197,6 +197,44 @@ export function resolveManualOverrideLineOriginalPrice(params, fallbackComposite
   }
   return fallbackCompositeOriginal;
 }
+
+/**
+ * 计算商品行「每单位有效折扣」：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 function resolveEffectivePerUnitDiscount(product) {
+  var discountList = Array.isArray(product === null || product === void 0 ? void 0 : product.discount_list) ? product.discount_list : [];
+  var fromList = discountList.reduce(function (sum, discount) {
+    return sum + Number((discount === null || discount === void 0 ? void 0 : discount.amount) || 0);
+  }, 0);
+  var hasPromoDiscountItem = discountList.some(function (item) {
+    return (item === null || item === void 0 ? void 0 : item.type) === 'promotion';
+  });
+  if (hasPromoDiscountItem) return fromList;
+  var metadata = (product === null || product === void 0 ? void 0 : product.metadata) || {};
+  var optionSum = sumOptionUnitPrice(product === null || product === void 0 ? void 0 : product.product_option_item).toNumber();
+
+  // applyPromotion 写价后、Rules 剥离 promotion discount 的兜底
+  if (metadata.source_product_price != null && metadata.main_product_selling_price != null) {
+    var source = Number(metadata.source_product_price);
+    var selling = Number(metadata.main_product_selling_price) - optionSum;
+    if (Number.isFinite(source) && Number.isFinite(selling) && source !== selling) {
+      return fromList + (source - selling);
+    }
+  }
+  var promo = metadata._promotion;
+  if ((promo === null || promo === void 0 ? void 0 : promo.inPromotion) !== true) return fromList;
+  var originalPrice = Number(promo.originalPrice);
+  var finalPrice = Number(promo.finalPrice);
+  if (!Number.isFinite(originalPrice) || !Number.isFinite(finalPrice)) return fromList;
+  return fromList + (originalPrice - finalPrice);
+}
 export function createDefaultOrderRulesHooks() {
   var toUnitPriceString = function toUnitPriceString(totalLike, num) {
     var effectiveNum = Number(num) > 0 ? Number(num) : 1;
@@ -204,7 +242,7 @@ export function createDefaultOrderRulesHooks() {
   };
   return {
     getProduct: function getProduct(product) {
-      var _product$metadata, _product$metadata2, _product$metadata3, _product$metadata4, _product$metadata5;
+      var _product$metadata, _product$metadata2, _product$metadata3, _product$metadata4, _product$metadata5, _metadataAny$_promoti;
       // source_product_price 是权威源；兜底链：source → mainSelling − options（反推）→ 行 selling_price
       var metadataAny = product.metadata || {};
       var optionSum = sumOptionUnitPrice(product.product_option_item);
@@ -249,7 +287,10 @@ export function createDefaultOrderRulesHooks() {
         // 无券时会把 bundle 价还原成 original_price（手动改价套餐会从 20 回到 30）。
         isManualDiscount: resolveRulesManualDiscountFlag(metadataAny),
         holder_id: (_product$metadata3 = product.metadata) === null || _product$metadata3 === void 0 ? void 0 : _product$metadata3.holder_id,
-        startDate: ((_product$metadata4 = product.metadata) === null || _product$metadata4 === void 0 ? void 0 : _product$metadata4.start_date) || ((_product$metadata5 = product.metadata) === null || _product$metadata5 === void 0 ? void 0 : _product$metadata5.startDate)
+        startDate: ((_product$metadata4 = product.metadata) === null || _product$metadata4 === void 0 ? void 0 : _product$metadata4.start_date) || ((_product$metadata5 = product.metadata) === null || _product$metadata5 === void 0 ? void 0 : _product$metadata5.startDate),
+        main_product_selling_price: metadataAny.main_product_selling_price !== undefined ? new Decimal(Number(metadataAny.main_product_selling_price) || 0).minus(optionSum).toDecimalPlaces(2).toString() : undefined,
+        inPromotion: ((_metadataAny$_promoti = metadataAny._promotion) === null || _metadataAny$_promoti === void 0 ? void 0 : _metadataAny$_promoti.inPromotion) === true,
+        _promotion: metadataAny._promotion
       };
     },
     setProduct: function setProduct(product, values) {

package/dist/modules/SalesSummary/utils.js

@@ -458,8 +458,8 @@ export function calculateSalesSummary(params) {
     }, new Decimal(0));
   }
   var shopDiscountAmount = Decimal.max(new Decimal(Number(shopDiscount) || 0), 0);
-  var expectAmount = Decimal.max(0, productAmount.plus(surchargeAmount).minus(shopDiscountAmount));
-  var totalAmount = isPriceIncludeTax === 1 ? expectAmount : expectAmount.plus(productTaxFee);
+  var preTaxExpectAmount = Decimal.max(0, productAmount.plus(surchargeAmount).minus(shopDiscountAmount));
+  var totalAmount = isPriceIncludeTax === 1 ? preTaxExpectAmount : preTaxExpectAmount.plus(productTaxFee);
   var deposit = calculateProductsDeposit(products);
   return {
     product_quantity: productQuantity,
@@ -475,7 +475,7 @@ export function calculateSalesSummary(params) {
     discount_amount: toFixed2(Decimal.max(productOriginalAmount.minus(productAmount), 0).plus(shopDiscountAmount)),
     deposit_amount: deposit ? deposit.total : '0.00',
     deposit: deposit,
-    expect_amount: toFixed2(expectAmount),
+    expect_amount: toFixed2(totalAmount),
     total_amount: toFixed2(totalAmount),
     total_refund_amount: '0.00',
     customer_paid_amount: '0.00',

package/dist/server/index.js

@@ -168,16 +168,17 @@ var Server = /*#__PURE__*/function () {
      */
     _defineProperty(this, "handleProductQuery", /*#__PURE__*/function () {
       var _ref2 = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee(_ref) {
-        var url, method, data, config, menu_list_ids, schedule_datetime, schedule_date, customer_id, _ref3, callback, subscriberId;
+        var url, method, data, config, menu_list_ids, schedule_datetime, schedule_date, customer_id, ids, _ref3, callback, subscriberId;
         return _regeneratorRuntime().wrap(function _callee$(_context) {
           while (1) switch (_context.prev = _context.next) {
             case 0:
               url = _ref.url, method = _ref.method, data = _ref.data, config = _ref.config;
               console.log('[Server] handleProductQuery:', url, method, data, config);
-              menu_list_ids = data.menu_list_ids, schedule_datetime = data.schedule_datetime, schedule_date = data.schedule_date, customer_id = data.customer_id;
+              menu_list_ids = data.menu_list_ids, schedule_datetime = data.schedule_datetime, schedule_date = data.schedule_date, customer_id = data.customer_id, ids = data.ids;
               _ref3 = config || {}, callback = _ref3.callback, subscriberId = _ref3.subscriberId;
               _this.logInfo('handleProductQuery: 开始处理商品查询请求', {
                 menu_list_ids: menu_list_ids,
+                ids: ids,
                 schedule_datetime: schedule_datetime,
                 schedule_date: schedule_date,
                 customer_id: customer_id
@@ -189,6 +190,7 @@ var Server = /*#__PURE__*/function () {
                   callback: callback,
                   context: {
                     menu_list_ids: menu_list_ids,
+                    ids: ids,
                     schedule_date: schedule_date,
                     schedule_datetime: schedule_datetime,
                     customer_id: customer_id
@@ -201,6 +203,7 @@ var Server = /*#__PURE__*/function () {
               }
               return _context.abrupt("return", _this.computeProductQueryResult({
                 menu_list_ids: menu_list_ids,
+                ids: ids,
                 schedule_date: schedule_date,
                 schedule_datetime: schedule_datetime,
                 customer_id: customer_id
@@ -3307,14 +3310,20 @@ var Server = /*#__PURE__*/function () {
       var _computeProductQueryResult = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee29(context, options) {
         var _menu_list_ids$length3,
           _this6 = this;
-        var tTotal, menu_list_ids, schedule_date, schedule_datetime, customer_id, product_id, _published$find, pid, _tPrice, allProductsWithPrice, published, item, activeMenuList, tMenu, menuList, tFilter, productScope, scopedProductIds, tPrice, filteredProducts, tStatus, beforeStatusCount, tSort;
+        var tTotal, menu_list_ids, ids, schedule_date, schedule_datetime, customer_id, product_id, queryIds, uniqueIds, _tPrice, productsWithPrice, _filteredProducts, _published$find, pid, _tPrice2, allProductsWithPrice, published, item, activeMenuList, tMenu, menuList, tFilter, productScope, scopedProductIds, tPrice, filteredProducts, tStatus, beforeStatusCount, tSort;
         return _regeneratorRuntime().wrap(function _callee29$(_context29) {
           while (1) switch (_context29.prev = _context29.next) {
             case 0:
               tTotal = performance.now();
-              menu_list_ids = context.menu_list_ids, schedule_date = context.schedule_date, schedule_datetime = context.schedule_datetime, customer_id = context.customer_id, product_id = context.product_id;
+              menu_list_ids = context.menu_list_ids, ids = context.ids, schedule_date = context.schedule_date, schedule_datetime = context.schedule_datetime, customer_id = context.customer_id, product_id = context.product_id;
+              queryIds = Array.isArray(ids) ? ids.map(function (id) {
+                return Number(id);
+              }).filter(function (id) {
+                return Number.isFinite(id);
+              }) : [];
               this.logInfo('computeProductQueryResult 开始', {
                 menuListIdsCount: (_menu_list_ids$length3 = menu_list_ids === null || menu_list_ids === void 0 ? void 0 : menu_list_ids.length) !== null && _menu_list_ids$length3 !== void 0 ? _menu_list_ids$length3 : 0,
+                ids: queryIds,
                 schedule_datetime: schedule_datetime,
                 schedule_date: schedule_date,
                 customer_id: customer_id,
@@ -3322,7 +3331,7 @@ var Server = /*#__PURE__*/function () {
                 changedIds: options === null || options === void 0 ? void 0 : options.changedIds
               });
               if (this.products) {
-                _context29.next = 6;
+                _context29.next = 7;
                 break;
               }
               this.logError('computeProductQueryResult: Products 模块未注册');
@@ -3333,22 +3342,67 @@ var Server = /*#__PURE__*/function () {
                   count: 0
                 }
               });
-            case 6:
-              if (!(product_id != null && Number.isFinite(Number(product_id)))) {
+            case 7:
+              if (!(queryIds.length > 0)) {
                 _context29.next = 18;
                 break;
               }
-              pid = Number(product_id);
+              uniqueIds = Array.from(new Set(queryIds));
               _tPrice = performance.now();
-              _context29.next = 11;
+              _context29.next = 12;
+              return this.products.getProductsWithPrice(schedule_date, {
+                scheduleModule: this.getSchedule(),
+                schedule_datetime: schedule_datetime,
+                customer_id: customer_id
+              }, {
+                changedIds: options === null || options === void 0 ? void 0 : options.changedIds,
+                productIds: uniqueIds
+              });
+            case 12:
+              productsWithPrice = _context29.sent;
+              perfMark('computeQuery.getProductsWithPrice(ids)', performance.now() - _tPrice, {
+                count: productsWithPrice.length,
+                ids: uniqueIds
+              });
+              _filteredProducts = productsWithPrice.filter(function (p) {
+                return uniqueIds.includes(Number(p === null || p === void 0 ? void 0 : p.id));
+              }).filter(function (p) {
+                return ((p === null || p === void 0 ? void 0 : p.status) || 'published') === 'published';
+              });
+              perfMark('computeProductQueryResult', performance.now() - tTotal, {
+                mode: 'ids',
+                ids: uniqueIds,
+                count: _filteredProducts.length
+              });
+              this.logInfo('computeProductQueryResult 完成（ids）', {
+                ids: uniqueIds,
+                count: _filteredProducts.length
+              });
+              return _context29.abrupt("return", {
+                code: 200,
+                data: {
+                  list: _filteredProducts,
+                  count: _filteredProducts.length
+                },
+                message: '',
+                status: true
+              });
+            case 18:
+              if (!(product_id != null && Number.isFinite(Number(product_id)))) {
+                _context29.next = 30;
+                break;
+              }
+              pid = Number(product_id);
+              _tPrice2 = performance.now();
+              _context29.next = 23;
               return this.products.getProductsWithPrice(schedule_date, {
                 scheduleModule: this.getSchedule()
               }, {
                 changedIds: options === null || options === void 0 ? void 0 : options.changedIds
               });
-            case 11:
+            case 23:
               allProductsWithPrice = _context29.sent;
-              perfMark('computeQuery.getProductsWithPrice(single)', performance.now() - _tPrice, {
+              perfMark('computeQuery.getProductsWithPrice(single)', performance.now() - _tPrice2, {
                 count: allProductsWithPrice.length,
                 productId: pid
               });
@@ -3373,9 +3427,9 @@ var Server = /*#__PURE__*/function () {
                 message: item ? '' : '商品不存在或未发布',
                 status: true
               });
-            case 18:
+            case 30:
               if (this.menu) {
-                _context29.next = 21;
+                _context29.next = 33;
                 break;
               }
               this.logError('computeProductQueryResult: Menu 模块未注册');
@@ -3386,9 +3440,9 @@ var Server = /*#__PURE__*/function () {
                   count: 0
                 }
               });
-            case 21:
+            case 33:
               if (this.schedule) {
-                _context29.next = 24;
+                _context29.next = 36;
                 break;
               }
               this.logError('computeProductQueryResult: Schedule 模块未注册');
@@ -3399,7 +3453,7 @@ var Server = /*#__PURE__*/function () {
                   count: 0
                 }
               });
-            case 24:
+            case 36:
               activeMenuList = [];
               if (menu_list_ids && Array.isArray(menu_list_ids) && menu_list_ids.length > 0) {
                 tMenu = performance.now();
@@ -3423,10 +3477,10 @@ var Server = /*#__PURE__*/function () {
               });
               tPrice = performance.now();
               if (!(scopedProductIds.length > 0)) {
-                _context29.next = 37;
+                _context29.next = 49;
                 break;
               }
-              _context29.next = 34;
+              _context29.next = 46;
               return this.products.getProductsWithPrice(schedule_date, {
                 scheduleModule: this.getSchedule(),
                 schedule_datetime: schedule_datetime,
@@ -3435,13 +3489,13 @@ var Server = /*#__PURE__*/function () {
                 changedIds: options === null || options === void 0 ? void 0 : options.changedIds,
                 productIds: productScope.isAllProducts ? undefined : scopedProductIds
               });
-            case 34:
+            case 46:
               _context29.t0 = _context29.sent;
-              _context29.next = 38;
+              _context29.next = 50;
               break;
-            case 37:
+            case 49:
               _context29.t0 = [];
-            case 38:
+            case 50:
               filteredProducts = _context29.t0;
               perfMark('computeQuery.getProductsWithPrice', performance.now() - tPrice, {
                 count: filteredProducts.length,
@@ -3484,7 +3538,7 @@ var Server = /*#__PURE__*/function () {
                 message: '',
                 status: true
               });
-            case 50:
+            case 62:
             case "end":
               return _context29.stop();
           }

package/dist/solution/BaseSales/index.d.ts

@@ -2,7 +2,7 @@ import { Module, ModuleOptions, PisellCore } from '../../types';
 import { BaseModule } from '../../modules/BaseModule';
 import { BaseSalesOrderProduct, BaseSalesOrderProductIdentity, BaseSalesPaymentStatus, BaseSalesUpdateOrderProductQuantityParams, BaseSalesCalculateProductBookingPriceParams, BaseSalesProductBookingPriceResult, BaseSalesScanCodeResult } from './types';
 import { OrderModule } from '../../modules/Order';
-import type { AddProductBookingInput, LoadSalesDetailParams, OrderPaymentData, OrderPaymentSource, SendCustomerPayLinkParams, SyncPaymentsToOrderParams, SyncPaymentsToOrderResult, UpdateTempOrderCustomerInput, UpdateOrderBookingParams, UpdateOrderProductParams, OrderTempOrder } from '../../modules/Order/types';
+import type { AddProductBookingInput, LoadSalesDetailParams, OrderPaymentData, OrderPaymentSource, SendCustomerPayLinkParams, SyncPaymentsToOrderParams, SyncPaymentsToOrderResult, UpdateTempOrderCustomerInput, UpdateOrderBookingParams, UpdateOrderProductParams, OrderTempOrder, OrderPromotionEvaluator, OrderGiftSelectResolver, OrderUnfulfilledPromotion, OrderLastGiftActions } from '../../modules/Order/types';
 import type { SubmitPayloadEnhancer } from '../../modules/Order/utils';
 import type { Discount } from '../../modules/Discount/types';
 import { RequestPlugin, WindowPlugin } from '../../plugins';
@@ -63,6 +63,13 @@ export declare class BaseSalesImpl extends BaseModule implements Module {
     private getCurrentOrderCustomerId;
     private applyQuotationScheduleResolver;
     private loadQuotationForPriceQuery;
+    private getPriceQueryProductId;
+    private getPriceQuerySchedule;
+    private loadProductForPriceQuery;
+    private getAuthoritativeBundleItems;
+    private findAuthoritativeBundleItem;
+    private getAuthoritativeBundleUnitPrice;
+    private mergeProductForPriceQuery;
     protected getSubmitOrderSalesChannel(): string | undefined;
     /**
      * 工厂入口：根据子模块名实例化对应模块。
@@ -237,6 +244,35 @@ export declare class BaseSalesImpl extends BaseModule implements Module {
      */
     setOrderProductLineNote(identity: BaseSalesOrderProductIdentity, note: string): Promise<import("../../modules/Order/types").OrderProduct[]>;
     removeProductFromOrder(identity: BaseSalesOrderProductIdentity): Promise<import("../../modules/Order/types").OrderProduct[]>;
+    /**
+     * 注入促销评估器到底层 OrderModule。
+     *
+     * @example
+     * solution.setPromotionEvaluator(appHelper.utils.promotionEvaluator);
+     */
+    setPromotionEvaluator(evaluator: OrderPromotionEvaluator | null): void;
+    /**
+     * 注入赠品选择 resolver。UI 层（SalesSdk）通过 bridge 提供。
+     *
+     * @example
+     * solution.setGiftSelectResolver(async (ctx) => bridge.request(ctx));
+     */
+    setGiftSelectResolver(resolver: OrderGiftSelectResolver | null): void;
+    /**
+     * 为商品目录追加促销标签，供 SalesSdkProductProvider 等商品列表入口复用。
+     *
+     * @example
+     * const products = solution.appendPromotionTags(catalogProducts);
+     */
+    appendPromotionTags<T extends Record<string, any>>(products: T[]): T[];
+    /**
+     * 主动触发一次促销应用（一般写路径会自动触发，少数场景如客户切换后可手动调）。
+     */
+    applyPromotion(): Promise<void>;
+    /** 最近一次促销计算输出的未满足提示。 */
+    getUnfulfilledPromotions(): OrderUnfulfilledPromotion[];
+    /** 最近一次促销计算输出的赠品操作 diff。 */
+    getLastGiftActions(): OrderLastGiftActions | null;
     getProductList(): Promise<any>;
     getOtherParams(): Record<string, any>;
     setOtherParams(params: Record<string, any>, { cover }?: {