@pisell/pisellos 2.2.180 → 2.2.182

package/dist/modules/Customer/index.js

@@ -95,7 +95,7 @@ export var CustomerModule = /*#__PURE__*/function (_BaseModule) {
               } else {
                 this.store.currentPage = 1;
               }
-              if (typeof (options === null || options === void 0 || (_options$initialState5 = options.initialState) === null || _options$initialState5 === void 0 ? void 0 : _options$initialState5.pageSize) === 'number') {
+              if (typeof (options === null || options === void 0 || (_options$initialState5 = options.initialState) === null || _options$initialState5 === void 0 ? void 0 : _options$initialState5.pageSize) === 'number' && options.initialState.pageSize > 1) {
                 this.store.pageSize = options.initialState.pageSize;
               } else {
                 this.store.pageSize = DEFAULT_PAGE_SIZE;
@@ -236,6 +236,52 @@ export var CustomerModule = /*#__PURE__*/function (_BaseModule) {
       }
       return handleCustomerListError;
     }()
+    /**
+     * 查询客户列表但不写入 customerList / pagination 状态。
+     *
+     * 用于按 ID 补齐客户等内部查询，避免把临时的 num/searchParams 污染到滚动列表。
+     */
+    )
+  }, {
+    key: "queryCustomerList",
+    value: (function () {
+      var _queryCustomerList = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee4() {
+        var params,
+          _yield$this$fetchCust,
+          customerList,
+          total,
+          page,
+          pageSize,
+          _args4 = arguments;
+        return _regeneratorRuntime().wrap(function _callee4$(_context4) {
+          while (1) switch (_context4.prev = _context4.next) {
+            case 0:
+              params = _args4.length > 0 && _args4[0] !== undefined ? _args4[0] : {};
+              _context4.next = 3;
+              return this.fetchCustomerListData(params);
+            case 3:
+              _yield$this$fetchCust = _context4.sent;
+              customerList = _yield$this$fetchCust.customerList;
+              total = _yield$this$fetchCust.total;
+              page = _yield$this$fetchCust.page;
+              pageSize = _yield$this$fetchCust.pageSize;
+              return _context4.abrupt("return", {
+                list: customerList,
+                total: total,
+                page: page,
+                pageSize: pageSize
+              });
+            case 9:
+            case "end":
+              return _context4.stop();
+          }
+        }, _callee4, this);
+      }));
+      function queryCustomerList() {
+        return _queryCustomerList.apply(this, arguments);
+      }
+      return queryCustomerList;
+    }()
     /**
      * 获取客户列表
      * @param params 查询参数
@@ -245,9 +291,9 @@ export var CustomerModule = /*#__PURE__*/function (_BaseModule) {
   }, {
     key: "getCustomerList",
     value: (function () {
-      var _getCustomerList = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee4() {
+      var _getCustomerList = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee5() {
         var params,
-          _yield$this$fetchCust,
+          _yield$this$fetchCust2,
           customerList,
           total,
           page,
@@ -256,22 +302,22 @@ export var CustomerModule = /*#__PURE__*/function (_BaseModule) {
           num,
           searchParams,
           response,
-          _args4 = arguments;
-        return _regeneratorRuntime().wrap(function _callee4$(_context4) {
-          while (1) switch (_context4.prev = _context4.next) {
+          _args5 = arguments;
+        return _regeneratorRuntime().wrap(function _callee5$(_context5) {
+          while (1) switch (_context5.prev = _context5.next) {
             case 0:
-              params = _args4.length > 0 && _args4[0] !== undefined ? _args4[0] : {};
-              _context4.prev = 1;
+              params = _args5.length > 0 && _args5[0] !== undefined ? _args5[0] : {};
+              _context5.prev = 1;
               this.store.loading = true;
               this.store.error = null;
-              _context4.next = 6;
+              _context5.next = 6;
               return this.fetchCustomerListData(params);
             case 6:
-              _yield$this$fetchCust = _context4.sent;
-              customerList = _yield$this$fetchCust.customerList;
-              total = _yield$this$fetchCust.total;
-              page = _yield$this$fetchCust.page;
-              pageSize = _yield$this$fetchCust.pageSize;
+              _yield$this$fetchCust2 = _context5.sent;
+              customerList = _yield$this$fetchCust2.customerList;
+              total = _yield$this$fetchCust2.total;
+              page = _yield$this$fetchCust2.page;
+              pageSize = _yield$this$fetchCust2.pageSize;
               // 保存搜索条件（排除skip和num）
               skip = params.skip, num = params.num, searchParams = _objectWithoutProperties(params, _excluded2);
               this.store.searchParams = cloneDeep(searchParams);
@@ -286,9 +332,7 @@ export var CustomerModule = /*#__PURE__*/function (_BaseModule) {
 
               // 设置客户列表（替换模式）
               this.store.customerList = cloneDeep(customerList);
-              _context4.next = 20;
-              return this.core.effects.emit("".concat(this.name, ":onCustomerListUpdate"), this.store);
-            case 20:
+
               // 触发分页变化事件
               this.triggerPaginationChange({
                 page: page,
@@ -302,24 +346,27 @@ export var CustomerModule = /*#__PURE__*/function (_BaseModule) {
                 page: page,
                 pageSize: pageSize
               };
-              return _context4.abrupt("return", response);
-            case 25:
-              _context4.prev = 25;
-              _context4.t0 = _context4["catch"](1);
-              _context4.next = 29;
-              return this.handleCustomerListError(_context4.t0, 'fetch customer list');
-            case 29:
-              throw _context4.t0;
-            case 30:
-              _context4.prev = 30;
+              return _context5.abrupt("return", response);
+            case 23:
+              _context5.prev = 23;
+              _context5.t0 = _context5["catch"](1);
+              _context5.next = 27;
+              return this.handleCustomerListError(_context5.t0, 'fetch customer list');
+            case 27:
+              throw _context5.t0;
+            case 28:
+              _context5.prev = 28;
               this.store.loading = false;
               this.storeChange();
-              return _context4.finish(30);
+              _context5.next = 33;
+              return this.core.effects.emit("".concat(this.name, ":onCustomerListUpdate"), this.store);
+            case 33:
+              return _context5.finish(28);
             case 34:
             case "end":
-              return _context4.stop();
+              return _context5.stop();
           }
-        }, _callee4, this, [[1, 25, 30, 34]]);
+        }, _callee5, this, [[1, 23, 28, 34]]);
       }));
       function getCustomerList() {
         return _getCustomerList.apply(this, arguments);
@@ -493,10 +540,10 @@ export var CustomerModule = /*#__PURE__*/function (_BaseModule) {
   }, {
     key: "changeCustomerPage",
     value: (function () {
-      var _changeCustomerPage = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee5(page, pageSize) {
+      var _changeCustomerPage = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee6(page, pageSize) {
         var targetPageSize, skip, num;
-        return _regeneratorRuntime().wrap(function _callee5$(_context5) {
-          while (1) switch (_context5.prev = _context5.next) {
+        return _regeneratorRuntime().wrap(function _callee6$(_context6) {
+          while (1) switch (_context6.prev = _context6.next) {
             case 0:
               targetPageSize = pageSize || this.store.pageSize; // 先更新分页状态
               this.setPaginationInfo(page, targetPageSize);
@@ -504,18 +551,18 @@ export var CustomerModule = /*#__PURE__*/function (_BaseModule) {
               // skip直接使用page，num使用pageSize
               skip = page;
               num = targetPageSize; // 自动调用获取客户列表，使用存储的搜索条件
-              _context5.next = 6;
+              _context6.next = 6;
               return this.getCustomerList(_objectSpread({
                 skip: skip,
                 num: num
               }, this.store.searchParams));
             case 6:
-              return _context5.abrupt("return", _context5.sent);
+              return _context6.abrupt("return", _context6.sent);
             case 7:
             case "end":
-              return _context5.stop();
+              return _context6.stop();
           }
-        }, _callee5, this);
+        }, _callee6, this);
       }));
       function changeCustomerPage(_x5, _x6) {
         return _changeCustomerPage.apply(this, arguments);
@@ -530,16 +577,16 @@ export var CustomerModule = /*#__PURE__*/function (_BaseModule) {
   }, {
     key: "loadMoreCustomers",
     value: (function () {
-      var _loadMoreCustomers = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee6() {
-        var nextPage, _yield$this$fetchCust2, newCustomers, total, page, pageSize, updatedCustomerList, response;
-        return _regeneratorRuntime().wrap(function _callee6$(_context6) {
-          while (1) switch (_context6.prev = _context6.next) {
+      var _loadMoreCustomers = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee7() {
+        var nextPage, loadMoreParams, _yield$this$fetchCust3, newCustomers, total, page, pageSize, updatedCustomerList, response;
+        return _regeneratorRuntime().wrap(function _callee7$(_context7) {
+          while (1) switch (_context7.prev = _context7.next) {
             case 0:
               if (!(!this.store.hasMore || this.store.loadingMore)) {
-                _context6.next = 2;
+                _context7.next = 2;
                 break;
               }
-              return _context6.abrupt("return", {
+              return _context7.abrupt("return", {
                 list: [],
                 total: this.store.total,
                 page: this.store.currentPage,
@@ -548,22 +595,21 @@ export var CustomerModule = /*#__PURE__*/function (_BaseModule) {
             case 2:
               // 计算下一页
               nextPage = this.store.currentPage + 1;
-              _context6.prev = 3;
+              _context7.prev = 3;
               this.store.loadingMore = true;
               this.store.error = null;
-
-              // 使用公共方法获取数据，传入存储的搜索条件
-              _context6.next = 8;
-              return this.fetchCustomerListData(_objectSpread({
+              loadMoreParams = _objectSpread({
                 skip: nextPage,
                 num: this.store.pageSize
-              }, this.store.searchParams));
-            case 8:
-              _yield$this$fetchCust2 = _context6.sent;
-              newCustomers = _yield$this$fetchCust2.customerList;
-              total = _yield$this$fetchCust2.total;
-              page = _yield$this$fetchCust2.page;
-              pageSize = _yield$this$fetchCust2.pageSize;
+              }, this.store.searchParams); // 使用公共方法获取数据，传入存储的搜索条件
+              _context7.next = 9;
+              return this.fetchCustomerListData(loadMoreParams);
+            case 9:
+              _yield$this$fetchCust3 = _context7.sent;
+              newCustomers = _yield$this$fetchCust3.customerList;
+              total = _yield$this$fetchCust3.total;
+              page = _yield$this$fetchCust3.page;
+              pageSize = _yield$this$fetchCust3.pageSize;
               // 将新数据追加到现有列表（追加模式）
               updatedCustomerList = [].concat(_toConsumableArray(this.store.customerList), _toConsumableArray(cloneDeep(newCustomers))); // 更新状态
               this.store.customerList = updatedCustomerList;
@@ -572,17 +618,14 @@ export var CustomerModule = /*#__PURE__*/function (_BaseModule) {
               this.store.hasMore = page * pageSize < total;
 
               // 触发滚动加载特定事件
-              _context6.next = 20;
+              _context7.next = 21;
               return this.core.effects.emit("".concat(this.name, ":onScrollLoadMore"), {
                 newCustomers: newCustomers,
                 allCustomers: this.store.customerList,
                 currentPage: page,
                 hasMore: this.store.hasMore
               });
-            case 20:
-              _context6.next = 22;
-              return this.core.effects.emit("".concat(this.name, ":onCustomerListUpdate"), this.store);
-            case 22:
+            case 21:
               // 触发分页变化事件
               this.triggerPaginationChange({
                 page: page,
@@ -597,24 +640,27 @@ export var CustomerModule = /*#__PURE__*/function (_BaseModule) {
                 page: page,
                 pageSize: pageSize
               };
-              return _context6.abrupt("return", response);
-            case 27:
-              _context6.prev = 27;
-              _context6.t0 = _context6["catch"](3);
-              _context6.next = 31;
-              return this.handleCustomerListError(_context6.t0, 'load more customers');
+              return _context7.abrupt("return", response);
+            case 26:
+              _context7.prev = 26;
+              _context7.t0 = _context7["catch"](3);
+              _context7.next = 30;
+              return this.handleCustomerListError(_context7.t0, 'load more customers');
+            case 30:
+              throw _context7.t0;
             case 31:
-              throw _context6.t0;
-            case 32:
-              _context6.prev = 32;
+              _context7.prev = 31;
               this.store.loadingMore = false;
               this.storeChange();
-              return _context6.finish(32);
+              _context7.next = 36;
+              return this.core.effects.emit("".concat(this.name, ":onCustomerListUpdate"), this.store);
             case 36:
+              return _context7.finish(31);
+            case 37:
             case "end":
-              return _context6.stop();
+              return _context7.stop();
           }
-        }, _callee6, this, [[3, 27, 32, 36]]);
+        }, _callee7, this, [[3, 26, 31, 37]]);
       }));
       function loadMoreCustomers() {
         return _loadMoreCustomers.apply(this, arguments);
@@ -630,15 +676,15 @@ export var CustomerModule = /*#__PURE__*/function (_BaseModule) {
   }, {
     key: "resetAndLoadCustomers",
     value: (function () {
-      var _resetAndLoadCustomers = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee7() {
+      var _resetAndLoadCustomers = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee8() {
         var params,
           resetParams,
           response,
-          _args7 = arguments;
-        return _regeneratorRuntime().wrap(function _callee7$(_context7) {
-          while (1) switch (_context7.prev = _context7.next) {
+          _args8 = arguments;
+        return _regeneratorRuntime().wrap(function _callee8$(_context8) {
+          while (1) switch (_context8.prev = _context8.next) {
             case 0:
-              params = _args7.length > 0 && _args7[0] !== undefined ? _args7[0] : {};
+              params = _args8.length > 0 && _args8[0] !== undefined ? _args8[0] : {};
               // 重置状态
               this.store.customerList = [];
               this.store.currentPage = 1;
@@ -650,23 +696,23 @@ export var CustomerModule = /*#__PURE__*/function (_BaseModule) {
                 skip: 1,
                 num: params.num || this.store.pageSize
               }); // 调用普通的获取列表方法
-              _context7.next = 8;
+              _context8.next = 8;
               return this.getCustomerList(resetParams);
             case 8:
-              response = _context7.sent;
-              _context7.next = 11;
+              response = _context8.sent;
+              _context8.next = 11;
               return this.core.effects.emit("".concat(this.name, ":onScrollLoadComplete"), {
                 customers: this.store.customerList,
                 total: this.store.total,
                 hasMore: this.store.hasMore
               });
             case 11:
-              return _context7.abrupt("return", response);
+              return _context8.abrupt("return", response);
             case 12:
             case "end":
-              return _context7.stop();
+              return _context8.stop();
           }
-        }, _callee7, this);
+        }, _callee8, this);
       }));
       function resetAndLoadCustomers() {
         return _resetAndLoadCustomers.apply(this, arguments);

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

@@ -110,6 +110,8 @@ export interface CustomerState {
 export interface CustomerModuleAPI {
     /** 获取客户列表 */
     getCustomerList: (params?: ShopGetCustomerListParams) => Promise<ICustomerListResponse>;
+    /** 查询客户列表但不更新列表分页状态 */
+    queryCustomerList: (params?: ShopGetCustomerListParams) => Promise<ICustomerListResponse>;
     /** 设置客户列表 */
     setCustomerList: (customers: ShopCustomer[], total?: number) => void;
     /** 设置当前选择的客户 */

package/dist/modules/Discount/index.js

@@ -154,7 +154,7 @@ export var DiscountModule = /*#__PURE__*/function (_BaseModule) {
     value: function () {
       var _loadPrepareConfig = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee4(params) {
         var _prepareConfig$data, _prepareConfig$data2;
-        var prepareConfig, goodPassList;
+        var prepareConfig, rawDiscountList, goodPassList;
         return _regeneratorRuntime().wrap(function _callee4$(_context4) {
           while (1) switch (_context4.prev = _context4.next) {
             case 0:
@@ -162,9 +162,10 @@ export var DiscountModule = /*#__PURE__*/function (_BaseModule) {
               return this.request.post("/order/prepare/config", params);
             case 2:
               prepareConfig = _context4.sent;
-              goodPassList = this.filterEnabledDiscountList([].concat(_toConsumableArray((prepareConfig === null || prepareConfig === void 0 || (_prepareConfig$data = prepareConfig.data) === null || _prepareConfig$data === void 0 ? void 0 : _prepareConfig$data.good_pass_list) || []), _toConsumableArray((prepareConfig === null || prepareConfig === void 0 || (_prepareConfig$data2 = prepareConfig.data) === null || _prepareConfig$data2 === void 0 ? void 0 : _prepareConfig$data2.discount_card_list) || []))) || []; // this.setDiscountList(goodPassList);
+              rawDiscountList = [].concat(_toConsumableArray((prepareConfig === null || prepareConfig === void 0 || (_prepareConfig$data = prepareConfig.data) === null || _prepareConfig$data === void 0 ? void 0 : _prepareConfig$data.good_pass_list) || []), _toConsumableArray((prepareConfig === null || prepareConfig === void 0 || (_prepareConfig$data2 = prepareConfig.data) === null || _prepareConfig$data2 === void 0 ? void 0 : _prepareConfig$data2.discount_card_list) || []));
+              goodPassList = this.filterEnabledDiscountList(rawDiscountList) || []; // this.setDiscountList(goodPassList);
               return _context4.abrupt("return", goodPassList);
-            case 5:
+            case 6:
             case "end":
               return _context4.stop();
           }

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

@@ -140,6 +140,7 @@ export interface Discount {
     appliedProductDetails: ApplicableProductDetails[];
     isDisabledForProductUsed?: boolean;
     amount?: number;
+    customer_id?: number | string | null;
     extension_data?: ExtensionData[];
     total_order_behavior_count?: number;
     today_order_behavior_count?: number;

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

@@ -1,9 +1,9 @@
 import { Module, PisellCore, ModuleOptions } from '../../types';
 import { BaseModule } from '../BaseModule';
-import { OrderModuleAPI, CommitOrderParams, UpdateProductInOrderParams, CheckoutOrderParams, CancelOrderParams, ChangeBookingStatusParams } from './types';
+import { OrderModuleAPI, CommitOrderParams, UpdateOrderBookingParams, UpdateOrderProductParams, UpdateOrderProductQuantityParams, CheckoutOrderParams, CancelOrderParams, ChangeBookingStatusParams } from './types';
 import { CartItem } from '../Cart/types';
 import { type SubmitPayloadEnhancer } from './utils';
-import type { OrderAmountSnapshot, AddProductBookingInput, OrderIdentitySnapshot, OrderPaymentSource, OrderSnapshot, OrderSyncState, SyncPaymentsToOrderParams, SyncPaymentsToOrderResult, SubmitSalesOrderParams, OrderProduct, OrderProductIdentity, OrderSummary, OrderTempOrder, OrderPaymentData, SendCustomerPayLinkParams, UpdateTempOrderCustomerInput, OrderCustomerPatch, OrderCustomerView } from './types';
+import type { OrderAmountSnapshot, AddProductBookingInput, OrderIdentitySnapshot, OrderPaymentSource, OrderSnapshot, OrderSyncState, SyncPaymentsToOrderParams, SyncPaymentsToOrderResult, SubmitSalesOrderParams, OrderProduct, OrderProductIdentity, OrderSummary, OrderTempOrder, OrderPaymentData, SendCustomerPayLinkParams, UpdateTempOrderCustomerInput, OrderCustomerPatch, OrderCustomerView, ReplaceTempOrderOptions, OrderPromotionEvaluator, OrderGiftSelectResolver, OrderUnfulfilledPromotion, OrderLastGiftActions } from './types';
 import type { ICustomer } from '../AccountList/types';
 import type { Discount } from '../Discount/types';
 import { UnavailableReason } from '../Rules/types';
@@ -20,11 +20,27 @@ export declare class OrderModule extends BaseModule implements Module, OrderModu
     private rulesHooksOverride?;
     private orderHooks?;
     private otherParams?;
+    /** 评估器引用；由 SalesSdkProvider 注入，未注入时 applyPromotion 静默跳过 */
+    private promotionEvaluator;
+    /** 赠品选择 resolver；由 SDK host bridge 注入 */
+    private giftSelectResolver;
+    /** applyPromotion 递归保护 flag（写路径同步调 applyPromotion，禁止重入） */
+    private isApplyingPromotion;
+    /** 最近一次 applyPromotion 的未满足促销提示 */
+    private lastUnfulfilledPromotions;
+    /** 最近一次 applyPromotion 的赠品操作 diff（debug / SDK 读取使用） */
+    private lastGiftActions;
+    /**
+     * 是否将 tempOrder 写入 IndexedDB 草稿（orders store）。
+     * BigSale 弹窗等短生命周期场景通过 setEnableTempOrderPersist(false) 关闭。
+     */
+    private draftPersistEnabled;
     /**
      * Populate `savedAmount` on each discount based on product-level discount details.
      * Only selected discounts get a non-zero value.
      */
     static populateSavedAmounts(productList: Array<Record<string, any>>, discountList: Array<Record<string, any>>): void;
+    private applyProductDiscountPrices;
     constructor(name?: string, version?: string);
     initialize(core: PisellCore, options: ModuleOptions): Promise<void>;
     /**
@@ -43,8 +59,10 @@ export declare class OrderModule extends BaseModule implements Module, OrderModu
     private createDefaultRulesHooks;
     loadDiscountConfig(params: {
         customerId: number;
-        action?: 'create';
-    }): Promise<void>;
+        action?: 'create' | 'edit';
+        orderId?: number;
+        apply?: boolean;
+    }): Promise<Discount[]>;
     getDiscountList(): Discount[];
     scanCode(code: string, customerId?: number): Promise<{
         isAvailable: boolean;
@@ -52,34 +70,92 @@ export declare class OrderModule extends BaseModule implements Module, OrderModu
         type: 'server' | 'clientCalc';
         unavailableReason?: UnavailableReason;
         unavailableReasonKey?: string | null;
+        scannedDiscountList?: Discount[];
     }>;
     applyDiscount(): void;
+    /**
+     * 注入促销评估器。
+     *
+     * @example
+     * order.setPromotionEvaluator(appHelper.utils.promotionEvaluator);
+     */
+    setPromotionEvaluator(evaluator: OrderPromotionEvaluator | null): void;
+    /**
+     * 注入赠品选择 resolver。OS 需要补赠品时会 await 调用 resolver；缺省时跳过新增并 console.warn。
+     *
+     * @example
+     * order.setGiftSelectResolver(async (ctx) => {
+     *   // SDK 内部决定弹窗 or 自动选第一项，返回完整 OrderProduct[]
+     *   return giftSelectBridge.request(ctx);
+     * });
+     */
+    setGiftSelectResolver(resolver: OrderGiftSelectResolver | null): void;
+    /**
+     * 为商品目录追加促销标签，供上层 Sales 门面复用。
+     *
+     * @example
+     * const products = order.appendPromotionTags(catalogProducts);
+     */
+    appendPromotionTags<T extends Record<string, any>>(products: T[]): T[];
+    /**
+     * 应用购物车促销：计算 → 差异化赠品 → 写回 tempOrder.products → emit onPromotionApplied。
+     *
+     * 调用时机：写路径（add/update/remove/clear/setCustomer）末尾自动触发；外部一般无需手动调。
+     *
+     * 关键约束：
+     * - 不调用任何公开 CRUD API（如 removeProductFromOrder），全部内部 mutate tempOrder.products，避免事件风暴；
+     * - 用 `isApplyingPromotion` 防递归；
+     * - 多选项赠品依赖 giftSelectResolver，未注入则跳过且 console.warn；
+     * - 不主动调用 applyDiscount / recalculateSummary，调用方负责跟进。
+     */
+    applyPromotion(): Promise<void>;
+    /** 最近一次 applyPromotion 输出的未满足促销列表 */
+    getUnfulfilledPromotions(): OrderUnfulfilledPromotion[];
+    /** 最近一次 applyPromotion 输出的赠品操作 diff */
+    getLastGiftActions(): OrderLastGiftActions | null;
     initTempOrder(params: {
         cacheId?: string;
         salesSummaryModuleName?: string;
     }): void;
-    private getTempOrderStorageKey;
-    private restoreTempOrderFromStorage;
+    /**
+     * 控制 IndexedDB 草稿（saveDraft）是否写入。
+     * localStorage 版 tempOrder 持久化已废弃，此方法仅影响 saveDraft。
+     *
+     * @example
+     * order.setEnableTempOrderPersist(false); // BigSale 弹窗：跳过 ~1s 的 dbUpdate
+     */
+    setEnableTempOrderPersist(enabled: boolean): void;
+    /** 是否允许 saveDraft 写入 IndexedDB 草稿。 */
+    isTempOrderPersistEnabled(): boolean;
+    /** @deprecated OrderModule 不再负责 tempOrder localStorage 持久化；草稿保存请使用 IndexedDB saveDraft。 */
     persistTempOrder(): void;
     private createDefaultTempOrderInstance;
     private createExternalSaleNumber;
     private ensureExternalSaleNumber;
     private ensureRequestUniqueIdempotencyToken;
+    private buildPaymentSyncIdempotencyToken;
     hasLocalDatabase(): boolean;
     private buildLocalOrderRecord;
     getLocalOrderByOrderId(orderId: number | string): Promise<Record<string, any> | null>;
     getLocalOrderByOrderNumber(orderNumber: string): Promise<Record<string, any> | null>;
     getLocalOrderByExternalSaleNumber(externalSaleNumber: string): Promise<Record<string, any> | null>;
     saveDraft(): Promise<void>;
+    private saveDraftInBackground;
     private hydrateTempOrderFromLocalRecord;
     private extractOrderIdFromSubmitResult;
     private calculatePaymentTotal;
+    private normalizePaymentSource;
+    private updateTempOrderPaymentStatus;
     private calculatePaidPaymentSummary;
     private calculatePaymentServiceFee;
+    private formatSummaryMetadataMoney;
+    private syncSummaryProductMetadata;
+    private calculateSummaryAmountGap;
     private getPaymentTargetAmount;
     ensureTempOrder(): OrderTempOrder;
     restoreOrder(): OrderTempOrder;
     getTempOrder(): OrderTempOrder | null;
+    replaceTempOrder(tempOrder: OrderTempOrder, options?: ReplaceTempOrderOptions): Promise<OrderTempOrder>;
     getOrderIdentity(): OrderIdentitySnapshot | null;
     getOrderSyncState(): OrderSyncState;
     getOrderAmountSnapshot(): OrderAmountSnapshot | null;
@@ -90,20 +166,27 @@ export declare class OrderModule extends BaseModule implements Module, OrderModu
     private ensureExtend;
     private captureProductRuntime;
     private createLinkedProductAndBooking;
+    private getBookingUniqueIdentificationNumber;
+    private findBookingIndexByUniqueIdentificationNumber;
+    private removeLinkedBookingsForProduct;
     private getSalesSummary;
     recalculateSummary(options?: {
         createIfMissing?: boolean;
     }): Promise<OrderSummary | null>;
     getOrderSummary(): Promise<OrderSummary>;
     updateTempOrderNote(note: string): string;
+    updateTempOrderNote(note: string, sync: true): Promise<string>;
+    updateTempOrderNote(note: string, sync: boolean): string | Promise<string>;
+    syncTempOrderNoteToRemote(orderId: number | string, note: string): Promise<string>;
     getTempOrderNote(): string;
     updateTempOrderShopDiscount(amount: string | number): string;
     updateTempOrderBuzzer(buzzer: string): string;
     updateTempOrderContactsInfo(contactsInfo: Record<string, any> | null): Record<string, any> | null;
+    private buildTempOrderCustomer;
     /**
      * 更新当前 tempOrder 的客户协议字段。
      *
-     * PaymentModal 只需要修改订单里的客户字段；如果外部还有客户模块需要同步，
+     * PaymentModal 只需要修改订单里的客户事实；如果外部还有客户模块需要同步，
      * 应由调用方通过回调处理，不能把外部 UI 状态写进 tempOrder。
      */
     updateTempOrderCustomer(customer: UpdateTempOrderCustomerInput): OrderSnapshot['customer'];
@@ -148,8 +231,15 @@ export declare class OrderModule extends BaseModule implements Module, OrderModu
     private shouldMergeProductToOrder;
     addProductToOrder(product: Partial<OrderProduct> & OrderProductIdentity, booking?: AddProductBookingInput): Promise<OrderProduct[]>;
     private hasGoodPassDiscount;
-    updateProductInOrder(params: UpdateProductInOrderParams): Promise<OrderProduct[]>;
+    updateOrderProduct(params: UpdateOrderProductParams): Promise<OrderProduct[]>;
+    updateOrderProductQuantity(params: UpdateOrderProductQuantityParams): Promise<OrderProduct[]>;
+    updateOrderBooking(params: UpdateOrderBookingParams): any[];
     removeProductFromOrder(identity: OrderProductIdentity): Promise<OrderProduct[]>;
+    /**
+     * 仅清空购物车行（products / bookings），不重置整单。
+     * 用于「仅清空商品」；客户、备注、支付等协议字段保持不变。
+     */
+    clearOrderCartLines(): Promise<OrderTempOrder>;
     /**
      * 提交当前 Sales tempOrder。
      *
@@ -174,7 +264,7 @@ export declare class OrderModule extends BaseModule implements Module, OrderModu
     private logSubmitBackendRejected;
     syncPaymentsToOrder<T = any>(params: SyncPaymentsToOrderParams): Promise<SyncPaymentsToOrderResult<T>>;
     createOrder(params: CommitOrderParams['query']): {
-        type: "virtual" | "appointment_booking";
+        type: "appointment_booking" | "virtual";
         platform: string;
         sales_channel: string;
         order_sales_channel: string;
@@ -221,8 +311,9 @@ export declare class OrderModule extends BaseModule implements Module, OrderModu
     hydrateTempOrderFromRecord(record: Record<string, any>, options?: {
         recalcOnHydrate?: boolean;
     }): Promise<OrderTempOrder>;
+    private normalizeTempOrderForRuntime;
     private normalizeHydratedOrderProduct;
     getLastOrderInfo(): Record<string, any> | undefined;
     getOrderInfo(order_id: number): Promise<any>;
 }
-export type { UpdateProductInOrderParams } from './types';
+export type { UpdateOrderBookingParams, UpdateOrderProductParams, UpdateOrderProductQuantityParams, } from './types';