@pisell/pisellos 0.10.43 → 0.10.44

package/dist/server/index.js

@@ -43,6 +43,7 @@ import { filterBookingsFromOrders, sortBookings } from "./modules/order/utils/fi
 import { buildSmallTicketData, hasSmallTicketData } from "./utils/small-ticket";
 import { BaseSalesImpl } from "../solution/BaseSales";
 import { getOrderPaymentIdentityKeys, isIdentifiedPendingOrderPayment, isPendingOrderPayment, mergeOrderPaymentListsByIdentity } from "../modules/Order/payment-utils";
+import { finalizeSalesNotesForCheckout } from "../modules/Order/salesNotes";
 import { normalizeOrderCollections } from "../modules/Order/utils/orderCollectionIdentity";
 import { stripOsPrivatePayloadFields } from "../utils/os-private-payload";
 import { getDefaultInvoiceLayoutConfig, getDefaultInvoiceTemplateSettings, normalizeRawInvoiceTemplateSettings, resolveInvoiceReceiptLocales } from "../modules/OpenData";
@@ -4369,12 +4370,14 @@ var Server = /*#__PURE__*/function () {
 
     /**
      * 预约查询是否走本地：
+     * - 日历周/月/资源视图通过 compact_fields 显式标识，始终走远端；
      * - 当 sales_time_between 的开始和结束都不是今天时，走远端；
      * - 其余情况走本地。
      */
   }, {
     key: "shouldUseLocalBookingQuery",
     value: function shouldUseLocalBookingQuery(data) {
+      if ((data === null || data === void 0 ? void 0 : data.compact_fields) === true) return false;
       var range = data === null || data === void 0 ? void 0 : data.sales_time_between;
       if (!Array.isArray(range) || range.length < 2) return true;
       return !this.isRangeBothNotToday(range[0], range[1]);
@@ -5868,7 +5871,7 @@ var Server = /*#__PURE__*/function () {
                 _context57.next = 7;
                 break;
               }
-              return _context57.abrupt("return", next);
+              return _context57.abrupt("return", this.finalizeCheckoutSalesNotes(next, title));
             case 7:
               idGenerator = this.getIdGeneratorPlugin();
               if (idGenerator) {
@@ -5879,7 +5882,7 @@ var Server = /*#__PURE__*/function () {
                 needsShopOrderNumber: needsShopOrderNumber,
                 needsShopFullOrderNumber: needsShopFullOrderNumber
               });
-              return _context57.abrupt("return", next);
+              return _context57.abrupt("return", this.finalizeCheckoutSalesNotes(next, title));
             case 11:
               _context57.prev = 11;
               if (!(needsShopOrderNumber && idGenerator.generateShopOrderNumber)) {
@@ -5917,7 +5920,7 @@ var Server = /*#__PURE__*/function () {
                 error: _context57.t0 instanceof Error ? _context57.t0.message : String(_context57.t0)
               });
             case 26:
-              return _context57.abrupt("return", next);
+              return _context57.abrupt("return", this.finalizeCheckoutSalesNotes(next, title));
             case 27:
             case "end":
               return _context57.stop();
@@ -5929,6 +5932,45 @@ var Server = /*#__PURE__*/function () {
       }
       return ensureCheckoutOrderNumbers;
     }()
+    /**
+     * Notes 允许在本地草稿阶段暂存空订单目标；checkout 的统一出口负责用最终
+     * shop_order_number 完成绑定并校验，保证后端请求、pending、设备任务和打印
+     * 都使用同一份完整快照。
+     */
+  }, {
+    key: "finalizeCheckoutSalesNotes",
+    value: function finalizeCheckoutSalesNotes(data, title) {
+      var _data$shop_order_numb;
+      if (!data || _typeof(data) !== 'object') return data;
+      if (!Object.prototype.hasOwnProperty.call(data, 'notes')) return data;
+      if (data.notes === undefined || data.notes === null) return data;
+      if (!Array.isArray(data.notes)) {
+        throw new Error('[Order Notes] checkout notes 必须为数组');
+      }
+      if (data.notes.length === 0) return data;
+      var productTargetUuids = (Array.isArray(data.products) ? data.products : []).map(function (product) {
+        var _product$metadata$uni, _product$metadata;
+        return (_product$metadata$uni = product === null || product === void 0 || (_product$metadata = product.metadata) === null || _product$metadata === void 0 ? void 0 : _product$metadata.unique_identification_number) !== null && _product$metadata$uni !== void 0 ? _product$metadata$uni : product === null || product === void 0 ? void 0 : product.unique_identification_number;
+      }).filter(function (targetUuid) {
+        return targetUuid !== undefined && targetUuid !== null && String(targetUuid).trim().length > 0;
+      }).map(function (targetUuid) {
+        return String(targetUuid);
+      });
+      var shopOrderNumber = String((_data$shop_order_numb = data.shop_order_number) !== null && _data$shop_order_numb !== void 0 ? _data$shop_order_numb : '').trim();
+      var notes = finalizeSalesNotesForCheckout({
+        notes: data.notes,
+        shopOrderNumber: shopOrderNumber,
+        productTargetUuids: productTargetUuids
+      });
+      this.logInfo("".concat(title, ": checkout Notes \u5DF2\u7ED1\u5B9A\u8BA2\u5355\u53F7"), {
+        shop_order_number: shopOrderNumber,
+        note_count: notes.length
+      });
+      return _objectSpread(_objectSpread({}, data), {}, {
+        shop_order_number: shopOrderNumber,
+        notes: notes
+      });
+    }
   }, {
     key: "dispatchCheckoutSyncTask",
     value: function () {

package/dist/server/modules/order/index.js

@@ -3249,6 +3249,12 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
         mergedRecord[_field] = cloneDeep(incomingRecord[_field]);
       }
 
+      // order_meta_list 是一次性生成的完整业务快照。incoming 明确携带时
+      // 必须整体覆盖（包括 null / 空对象 / 空数组）；省略时才保留 existing。
+      if (Object.prototype.hasOwnProperty.call(incomingRecord, 'order_meta_list')) {
+        mergedRecord.order_meta_list = cloneDeep(incomingRecord.order_meta_list);
+      }
+
       // 子项数组遵循完整快照语义：incoming 自有且为数组（包括 []）时权威替换；
       // 字段缺席或不是数组时视为稀疏 patch，继续保留 existing。
       for (var _i6 = 0, _ORDER_AUTHORITATIVE_2 = ORDER_AUTHORITATIVE_COLLECTION_FIELDS; _i6 < _ORDER_AUTHORITATIVE_2.length; _i6++) {

package/dist/server/modules/order/types.d.ts

@@ -456,6 +456,15 @@ export interface OrderData {
             par_value: string;
             used_par_value: string;
         }>;
+        virtual_currency_snapshot?: Array<{
+            id: number | string;
+            tag: 'virtual_currency';
+            product_id?: number | string;
+            product_name: string;
+            par_value: string;
+            used_par_value: string;
+            name: Record<string, string>;
+        }>;
     };
     /**
      * 金额汇总（仅输出）。

package/dist/server/utils/small-ticket.d.ts

@@ -45,6 +45,7 @@ export interface SmallTicketProduct {
     product_uid?: string | number;
     booking_uid?: string | number;
     product_note?: string;
+    allergy?: string;
     options?: Array<{
         name: string;
         num?: number;

package/dist/server/utils/small-ticket.js

@@ -319,6 +319,7 @@ function buildBaseData(params) {
 }
 function buildProducts(order, locale, productMap) {
   var products = Array.isArray(order.products) ? order.products : [];
+  var allergyByProductUid = buildProductAllergyMap(order, locale);
   return products.map(function (rawProduct) {
     var _ref, _ref2, _product$product_quan, _ref3, _ref4, _ref5, _product$original_pri, _ref6, _ref7, _product$selling_pric, _product$product_id, _product$metadata, _product$metadata2;
     var product = restoreReceiptDiscountHierarchy(rawProduct);
@@ -360,10 +361,11 @@ function buildProducts(order, locale, productMap) {
       originalPrice: originalPrice
     });
     var productNote = resolveProductNote(product, locale);
+    var allergy = isPresentId(productUid) ? allergyByProductUid.get(String(productUid).trim()) || '' : '';
     var basePrice = resolveProductBasePrice(product);
     var resolvedCombinations = Array.isArray(product.combinations) && product.combinations.length ? normalizeExistingCombinations(product.combinations, locale, currencySymbol) : combinations;
     var shouldIncludeBasePrice = options.length > 0 || resolvedCombinations.length > 0 || hasProductDiscount(product, extensionList);
-    return _objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread({
+    return _objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread({
       product_title: productTitle,
       product_quantity: quantity,
       selling_price: formatMoney(sellingPrice, currencySymbol),
@@ -385,6 +387,8 @@ function buildProducts(order, locale, productMap) {
       booking_uid: bookingUid
     } : {}), productNote ? {
       product_note: productNote
+    } : {}), allergy ? {
+      allergy: allergy
     } : {}), options.length ? {
       options: options
     } : {}), resolvedVariant ? {
@@ -810,6 +814,25 @@ function resolveProductNote(product, locale) {
   if (productNote) return productNote;
   return getLocalizedValue(product.note, locale).trim();
 }
+function buildProductAllergyMap(order, locale) {
+  var allergyByProductUid = new Map();
+  for (var _i = 0, _normalizeArray = normalizeArray(order.notes); _i < _normalizeArray.length; _i++) {
+    var _note$content, _relation$target_uuid;
+    var note = _normalizeArray[_i];
+    if (!note || _typeof(note) !== 'object' || Array.isArray(note) || String(note.note_type || '').trim() !== 'allergy') {
+      continue;
+    }
+    var content = getLocalizedValue((_note$content = note.content) === null || _note$content === void 0 ? void 0 : _note$content.text, locale).trim();
+    if (!content) continue;
+    var relation = normalizeArray(note.note_relations).find(function (item) {
+      return item && _typeof(item) === 'object' && !Array.isArray(item) && item.relation_type === 'about' && item.target_type === 'order_detail' && Number(item.is_primary) === 1;
+    });
+    var productUid = String((_relation$target_uuid = relation === null || relation === void 0 ? void 0 : relation.target_uuid) !== null && _relation$target_uuid !== void 0 ? _relation$target_uuid : '').trim();
+    if (!productUid || allergyByProductUid.has(productUid)) continue;
+    allergyByProductUid.set(productUid, content);
+  }
+  return allergyByProductUid;
+}
 function resolveBundleProductTitle(params) {
   var _ref29, _ref30, _bundle$bundle_produc;
   var bundle = params.bundle,
@@ -1043,9 +1066,9 @@ function buildFees(params) {
     currencySymbol = params.currencySymbol,
     financials = params.financials;
   var fees = [];
-  for (var _i = 0, _normalizeArray = normalizeArray(order.surcharges || summary.surcharges); _i < _normalizeArray.length; _i++) {
+  for (var _i2 = 0, _normalizeArray2 = normalizeArray(order.surcharges || summary.surcharges); _i2 < _normalizeArray2.length; _i2++) {
     var _ref48, _surcharge$amount;
-    var surcharge = _normalizeArray[_i];
+    var surcharge = _normalizeArray2[_i2];
     var value = (_ref48 = (_surcharge$amount = surcharge.amount) !== null && _surcharge$amount !== void 0 ? _surcharge$amount : surcharge.value) !== null && _ref48 !== void 0 ? _ref48 : surcharge.total_amount;
     if (!isNonZero(value)) continue;
     fees.push({
@@ -1266,8 +1289,8 @@ function firstValidBookingDate() {
   for (var _len2 = arguments.length, values = new Array(_len2), _key2 = 0; _key2 < _len2; _key2++) {
     values[_key2] = arguments[_key2];
   }
-  for (var _i2 = 0, _values = values; _i2 < _values.length; _i2++) {
-    var value = _values[_i2];
+  for (var _i3 = 0, _values = values; _i3 < _values.length; _i3++) {
+    var value = _values[_i3];
     if (!isPresentId(value)) continue;
     var parsed = dayjs(value);
     if (parsed.isValid()) return parsed;
@@ -1324,9 +1347,9 @@ function sortBookings(bookings) {
     var leftStart = bookingStartTimestamp(left.booking);
     var rightStart = bookingStartTimestamp(right.booking);
     if (leftStart !== rightStart) return leftStart < rightStart ? -1 : 1;
-    for (var _i3 = 0, _arr = ['booking_id', 'schedule_event_id']; _i3 < _arr.length; _i3++) {
+    for (var _i4 = 0, _arr = ['booking_id', 'schedule_event_id']; _i4 < _arr.length; _i4++) {
       var _left$booking, _right$booking;
-      var field = _arr[_i3];
+      var field = _arr[_i4];
       var fieldOrder = compareOptionalValues((_left$booking = left.booking) === null || _left$booking === void 0 ? void 0 : _left$booking[field], (_right$booking = right.booking) === null || _right$booking === void 0 ? void 0 : _right$booking[field]);
       if (fieldOrder !== 0) return fieldOrder;
     }
@@ -1339,8 +1362,8 @@ function sortBookings(bookings) {
 }
 function bookingStartTimestamp(booking) {
   var startValues = [booking === null || booking === void 0 ? void 0 : booking.start_at, booking === null || booking === void 0 ? void 0 : booking.start_datetime, booking === null || booking === void 0 ? void 0 : booking.booking_time, isPresentId(booking === null || booking === void 0 ? void 0 : booking.start_date) ? "".concat(booking.start_date, " ").concat(stringify(booking.start_time)).trim() : undefined];
-  for (var _i4 = 0, _startValues = startValues; _i4 < _startValues.length; _i4++) {
-    var startValue = _startValues[_i4];
+  for (var _i5 = 0, _startValues = startValues; _i5 < _startValues.length; _i5++) {
+    var startValue = _startValues[_i5];
     if (!isPresentId(startValue)) continue;
     var timestamp = dayjs(startValue).valueOf();
     if (Number.isFinite(timestamp)) return timestamp;
@@ -1466,17 +1489,20 @@ function resolveRefundPayment(refund, payments) {
   return matchedPayment || refund;
 }
 function buildWallets(params) {
+  var virtualCurrencySnapshots = collectVirtualCurrencySnapshots(params.order);
   var displayedWalletPayments = normalizeArray(params.order.payments).filter(function (payment) {
     return isPrintablePayment(payment) && !!getFundRecord(payment);
   });
   var paymentWallets = displayedWalletPayments.map(function (payment) {
+    var virtualCurrencySnapshot = findVirtualCurrencySnapshotForPayment(payment, virtualCurrencySnapshots.byId);
     return buildPaymentItems({
       payment: payment,
       locale: params.locale,
       currencySymbol: params.currencySymbol,
       includeFundRecordBalance: true,
       includeFundRecordUsage: false,
-      includePaymentAmount: false
+      includePaymentAmount: false,
+      virtualCurrencyUnit: virtualCurrencySnapshot ? getVirtualCurrencySnapshotUnit(virtualCurrencySnapshot, params.locale) : undefined
     });
   });
   var displayedWalletPassIds = collectDisplayedWalletPassIds(displayedWalletPayments);
@@ -1484,6 +1510,11 @@ function buildWallets(params) {
     order: params.order,
     locale: params.locale,
     displayedWalletPassIds: displayedWalletPassIds
+  })), _toConsumableArray(buildVirtualCurrencySnapshotAssets({
+    snapshots: virtualCurrencySnapshots.items,
+    order: params.order,
+    locale: params.locale,
+    displayedWalletPassIds: displayedWalletPassIds
   })));
 }
 function collectDisplayedWalletPassIds(payments) {
@@ -1531,6 +1562,91 @@ function buildPointCardSnapshotAssets(params) {
     return [rows];
   });
 }
+function collectVirtualCurrencySnapshots(order) {
+  var _order$order_meta_lis;
+  var items = [];
+  var byId = new Map();
+  var snapshots = (_order$order_meta_lis = order.order_meta_list) === null || _order$order_meta_lis === void 0 ? void 0 : _order$order_meta_lis.virtual_currency_snapshot;
+  if (!Array.isArray(snapshots)) return {
+    items: items,
+    byId: byId
+  };
+  snapshots.forEach(function (snapshot) {
+    if (!snapshot || _typeof(snapshot) !== 'object' || Array.isArray(snapshot)) return;
+    var virtualCurrency = snapshot;
+    if (stringify(virtualCurrency.tag).trim().toLowerCase() !== 'virtual_currency') return;
+    var id = normalizeWalletPassId(virtualCurrency.id);
+    if (!id || byId.has(id)) return;
+    byId.set(id, virtualCurrency);
+    items.push(virtualCurrency);
+  });
+  return {
+    items: items,
+    byId: byId
+  };
+}
+function findVirtualCurrencySnapshotForPayment(payment, snapshotsById) {
+  var fundRecord = getFundRecord(payment);
+  for (var _i6 = 0, _arr2 = [fundRecord === null || fundRecord === void 0 ? void 0 : fundRecord.voucher_id, payment.voucher_id]; _i6 < _arr2.length; _i6++) {
+    var value = _arr2[_i6];
+    var id = normalizeWalletPassId(value);
+    if (!id) continue;
+    var snapshot = snapshotsById.get(id);
+    if (snapshot) return snapshot;
+  }
+  return undefined;
+}
+function buildVirtualCurrencySnapshotAssets(params) {
+  var snapshotTime = firstPresentValue(params.order.updated_at, params.order.created_at);
+  return params.snapshots.flatMap(function (virtualCurrency) {
+    var id = normalizeWalletPassId(virtualCurrency.id);
+    if (!id || params.displayedWalletPassIds.has(id)) return [];
+    var rows = [{
+      item: stringify(virtualCurrency.product_name).trim(),
+      value: ''
+    }];
+    var balance = getVirtualCurrencySnapshotBalance(virtualCurrency);
+    if (balance) {
+      rows.push({
+        item: label(params.locale, 'balance'),
+        value: formatVirtualCurrencyBalance(balance, getVirtualCurrencySnapshotUnit(virtualCurrency, params.locale))
+      });
+    }
+    if (isPresentId(snapshotTime)) {
+      rows.push({
+        item: formatDateTime(snapshotTime, params.locale),
+        value: ''
+      });
+    }
+    return [rows];
+  });
+}
+function getVirtualCurrencySnapshotBalance(snapshot) {
+  if (!isNumericAmount(snapshot.par_value) || !isNumericAmount(snapshot.used_par_value)) {
+    return null;
+  }
+  return Decimal.max(new Decimal(snapshot.par_value).minus(new Decimal(snapshot.used_par_value)), 0);
+}
+function getVirtualCurrencySnapshotUnit(snapshot, locale) {
+  return getNonEmptyLocalizedValue(snapshot.name, locale);
+}
+function getNonEmptyLocalizedValue(value, locale) {
+  if (value === undefined || value === null) return '';
+  if (_typeof(value) !== 'object' || Array.isArray(value)) return stringify(value).trim();
+  var dashedLocale = locale.replace('_', '-');
+  var underscoredLocale = locale.replace('-', '_');
+  for (var _i7 = 0, _arr3 = [value[locale], value[dashedLocale], value[underscoredLocale], value.original, value.auto, value.default, value.en]; _i7 < _arr3.length; _i7++) {
+    var candidate = _arr3[_i7];
+    var text = stringify(candidate).trim();
+    if (text) return text;
+  }
+  return '';
+}
+function formatVirtualCurrencyBalance(value, unit) {
+  var amount = trimDecimal(value);
+  var normalizedUnit = unit.trim();
+  return normalizedUnit ? "".concat(amount, " ").concat(normalizedUnit) : amount;
+}
 function normalizeWalletPassId(value) {
   if (typeof value === 'number') return Number.isFinite(value) ? String(value) : null;
   if (typeof value !== 'string') return null;
@@ -1583,8 +1699,9 @@ function buildVoucherAssets(params) {
     }].concat(_toConsumableArray(timeRow ? [timeRow] : []))];
   });
 }
+var TICKET_VOUCHER_TAGS = new Set(['ticket', 'product_package_ticket', 'appointment_ticket', 'session_ticket']);
 function isTicketVoucher(voucher) {
-  return stringify(voucher.tag).trim().toLowerCase() === 'ticket';
+  return TICKET_VOUCHER_TAGS.has(stringify(voucher.tag).trim().toLowerCase());
 }
 function getVoucherValidity(voucher, locale) {
   var _voucher$metadata, _voucher$metadata2, _voucher$metadata3, _voucher$metadata4, _voucher$metadata5, _voucher$metadata6, _voucher$metadata7, _voucher$metadata8, _voucher$metadata9, _voucher$metadata10, _voucher$start_time, _voucher$metadata11, _voucher$end_time, _voucher$metadata12;
@@ -1700,7 +1817,8 @@ function buildPaymentItems(params) {
     currencySymbol = params.currencySymbol,
     includeFundRecordBalance = params.includeFundRecordBalance,
     includeFundRecordUsage = params.includeFundRecordUsage,
-    includePaymentAmount = params.includePaymentAmount;
+    includePaymentAmount = params.includePaymentAmount,
+    virtualCurrencyUnit = params.virtualCurrencyUnit;
   var serviceFee = getPaymentServiceFee(payment);
   var items = [{
     item: paymentMethodName(payment, locale),
@@ -1725,7 +1843,8 @@ function buildPaymentItems(params) {
       locale: locale,
       currencySymbol: currencySymbol,
       includeBalance: includeFundRecordBalance,
-      includeUsage: includeFundRecordUsage
+      includeUsage: includeFundRecordUsage,
+      virtualCurrencyUnit: virtualCurrencyUnit
     })));
   } else {
     var _ref59, _payment$remaining_am, _payment$metadata;
@@ -1790,7 +1909,8 @@ function buildFundRecordPaymentItems(params) {
     locale = params.locale,
     currencySymbol = params.currencySymbol,
     includeBalance = params.includeBalance,
-    includeUsage = params.includeUsage;
+    includeUsage = params.includeUsage,
+    virtualCurrencyUnit = params.virtualCurrencyUnit;
   var items = [];
   var usingBeforeValue = fundRecord.using_before_value;
   var usingAfterValue = fundRecord.using_after_value;
@@ -1811,6 +1931,14 @@ function buildFundRecordPaymentItems(params) {
     return items;
   }
   if (includeBalance && usingAfterValue !== undefined && usingAfterValue !== null) {
+    if (virtualCurrencyUnit !== undefined) {
+      if (!isNumericAmount(usingAfterValue)) return items;
+      items.push({
+        item: label(locale, 'balance'),
+        value: formatVirtualCurrencyBalance(new Decimal(usingAfterValue), virtualCurrencyUnit)
+      });
+      return items;
+    }
     items.push({
       item: label(locale, 'balance'),
       value: formatMoney(usingAfterValue, currencySymbol)

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, BaseSalesPriceRecalculationContextChange, BaseSalesProductBookingPriceResult, BaseSalesQuotationCustomerScopeInfo, BaseSalesScanCodeResult, BaseSalesCashPaymentConfig, BaseSalesPayCashParams, BaseSalesPayCashResult, BaseSalesCommitPaymentMethodParams, BaseSalesCommitPaymentMethodResult, BaseSalesConfirmWalletPaymentResult } from './types';
 import { OrderModule } from '../../modules/Order';
-import type { AddProductBookingInput, AddProductToOrderOptions, LoadSalesDetailParams, OrderPaymentData, OrderPaymentUpdateOptions, OrderPaymentUpdateResult, OrderPaymentSource, SendCustomerPayLinkParams, SyncPaymentsToOrderParams, SyncPaymentsToOrderResult, UpdateTempOrderCustomerInput, UpdateOrderBookingParams, UpdateOrderProductParams, OrderTempOrder, OrderSummary, OrderPromotionEvaluator, OrderGiftSelectResolver, OrderUnfulfilledPromotion, OrderLastGiftActions, RemoveProductsFromOrderOptions, ReplaceTempOrderOptions } from '../../modules/Order/types';
+import type { AddProductBookingInput, AddProductToOrderOptions, LoadSalesDetailParams, OrderPaymentData, OrderPaymentUpdateOptions, OrderPaymentUpdateResult, OrderPaymentSource, SendCustomerPayLinkParams, SyncPaymentsToOrderParams, SyncPaymentsToOrderResult, UpdateTempOrderCustomerInput, UpdateOrderBookingParams, UpdateOrderProductParams, OrderTempOrder, OrderSummary, OrderPromotionEvaluator, OrderGiftSelectResolver, OrderUnfulfilledPromotion, OrderLastGiftActions, RemoveProductsFromOrderOptions, ReplaceTempOrderOptions, SalesNote, SalesNotesMutationSnapshot, SetSalesNoteInput, PickupReferenceMode, ShopServiceData, ShopServiceType } from '../../modules/Order/types';
 import type { SubmitPayloadEnhancer } from '../../modules/Order/utils';
 import type { Discount, VirtualCurrencyAsset } from '../../modules/Discount/types';
 import { RequestPlugin, WindowPlugin } from '../../plugins';
@@ -232,6 +232,12 @@ export declare class BaseSalesImpl extends BaseModule implements Module {
     getOrderSyncState(): import("../../modules/Order/types").OrderSyncState;
     getOrderAmountSnapshot(): import("../../modules/Order/types").OrderAmountSnapshot | null;
     getTempOrderNote(): string;
+    getSalesNotes(): SalesNote[];
+    createSalesNotesMutationSnapshot(): SalesNotesMutationSnapshot;
+    restoreSalesNotesMutationSnapshot(snapshot: SalesNotesMutationSnapshot): void;
+    setSalesNote(input: SetSalesNoteInput): Promise<SalesNote>;
+    removeSalesNote(uuid: string): Promise<void>;
+    clearSalesNotes(): Promise<void>;
     updateTempOrderNote(note: string): string;
     updateTempOrderNote(note: string, sync: true): Promise<string>;
     updateTempOrderNote(note: string, sync: boolean): string | Promise<string>;
@@ -240,6 +246,8 @@ export declare class BaseSalesImpl extends BaseModule implements Module {
     setPickupRef(buzzer: string): string;
     updateTempOrderShopDiscount(amount: string | number): string;
     updateTempOrderDepositAmount(amount: string | number): OrderSummary;
+    setPickupReferenceMode(mode: PickupReferenceMode): ShopServiceData;
+    setServiceType(serviceType: ShopServiceType): ShopServiceData;
     updateTempOrderContactsInfo(contactsInfo: Record<string, any> | null): Record<string, any> | null;
     /** @deprecated OrderModule 不再负责 tempOrder localStorage 持久化。 */
     setEnableTempOrderPersist(enabled: boolean): void;
@@ -263,6 +271,12 @@ export declare class BaseSalesImpl extends BaseModule implements Module {
     private mergeHistoricalDiscountList;
     private shouldSkipAutoApplyFetchedDiscountsInEditMode;
     private mergeCurrentDiscountSelectionState;
+    private resolveDiscountConfigCustomerId;
+    /**
+     * Stable across notifyTempOrderChanged's immutable object replacement, while
+     * still distinguishing two local orders for the same customer.
+     */
+    private getDiscountConfigOrderIdentityKey;
     loadDiscountConfig(params?: {
         customerId?: number;
         action?: 'create' | 'edit';