@pisell/pisellos 2.2.309 → 2.2.310

package/dist/modules/Discount/index.js

@@ -29,6 +29,7 @@ import { uniqueById } from "../../solution/ShopDiscount/utils";
 import { BaseModule } from "../BaseModule";
 import { DiscountHooks } from "./types";
 import Decimal from 'decimal.js';
+import { getDiscountLifecycleReason, getDiscountUsageBlockReason, getDiscountUsageLimitFailKey, hasAvailableDiscountBalance } from "./availability";
 export var DiscountModule = /*#__PURE__*/function (_BaseModule) {
   _inherits(DiscountModule, _BaseModule);
   var _super = _createSuper(DiscountModule);
@@ -165,8 +166,8 @@ export var DiscountModule = /*#__PURE__*/function (_BaseModule) {
     key: "loadPrepareConfig",
     value: function () {
       var _loadPrepareConfig = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee4(params) {
-        var _params$with_availabl, _params$with_availabl2, _params$with_virtual_, _prepareConfig$data, _prepareConfig$data2, _prepareConfig$data3, _prepareConfig$data4, _prepareConfig$data5, _prepareConfig$data6;
-        var prepareConfig, rawDiscountList, availableWalletList, availableWalletPassList, availableWalletIds, virtualCurrencyList, goodPassList;
+        var _params$with_availabl, _params$with_availabl2, _params$with_virtual_, _prepareConfig$data, _prepareConfig$data2, _prepareConfig$data3, _prepareConfig$data4, _prepareConfig$data5, _prepareConfig$data6, _prepareConfig$data7;
+        var prepareConfig, entitlementPassList, entitlementPassIds, excludeEntitlementDuplicates, rawDiscountList, availableWalletList, availableWalletPassList, availableWalletIds, virtualCurrencyList, goodPassList;
         return _regeneratorRuntime().wrap(function _callee4$(_context4) {
           while (1) switch (_context4.prev = _context4.next) {
             case 0:
@@ -181,15 +182,27 @@ export var DiscountModule = /*#__PURE__*/function (_BaseModule) {
               }));
             case 3:
               prepareConfig = _context4.sent;
-              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) || []));
-              availableWalletList = [].concat(_toConsumableArray((prepareConfig === null || prepareConfig === void 0 || (_prepareConfig$data3 = prepareConfig.data) === null || _prepareConfig$data3 === void 0 ? void 0 : _prepareConfig$data3.avaiable_wallet_list) || []), _toConsumableArray((prepareConfig === null || prepareConfig === void 0 || (_prepareConfig$data4 = prepareConfig.data) === null || _prepareConfig$data4 === void 0 ? void 0 : _prepareConfig$data4.available_wallet_list) || []));
-              availableWalletPassList = (prepareConfig === null || prepareConfig === void 0 || (_prepareConfig$data5 = prepareConfig.data) === null || _prepareConfig$data5 === void 0 ? void 0 : _prepareConfig$data5.available_wallet_pass_list) || [];
+              entitlementPassList = (prepareConfig === null || prepareConfig === void 0 || (_prepareConfig$data = prepareConfig.data) === null || _prepareConfig$data === void 0 ? void 0 : _prepareConfig$data.entitlement_pass_list) || [];
+              entitlementPassIds = new Set(entitlementPassList.map(function (discount) {
+                return discount === null || discount === void 0 ? void 0 : discount.id;
+              }).filter(function (id) {
+                return id !== undefined && id !== null;
+              }).map(function (id) {
+                return String(id);
+              }));
+              excludeEntitlementDuplicates = function excludeEntitlementDuplicates(discount) {
+                var id = discount === null || discount === void 0 ? void 0 : discount.id;
+                return id === undefined || id === null || !entitlementPassIds.has(String(id));
+              };
+              rawDiscountList = [].concat(_toConsumableArray(entitlementPassList), _toConsumableArray(((prepareConfig === null || prepareConfig === void 0 || (_prepareConfig$data2 = prepareConfig.data) === null || _prepareConfig$data2 === void 0 ? void 0 : _prepareConfig$data2.good_pass_list) || []).filter(excludeEntitlementDuplicates)), _toConsumableArray(((prepareConfig === null || prepareConfig === void 0 || (_prepareConfig$data3 = prepareConfig.data) === null || _prepareConfig$data3 === void 0 ? void 0 : _prepareConfig$data3.discount_card_list) || []).filter(excludeEntitlementDuplicates)));
+              availableWalletList = [].concat(_toConsumableArray((prepareConfig === null || prepareConfig === void 0 || (_prepareConfig$data4 = prepareConfig.data) === null || _prepareConfig$data4 === void 0 ? void 0 : _prepareConfig$data4.avaiable_wallet_list) || []), _toConsumableArray((prepareConfig === null || prepareConfig === void 0 || (_prepareConfig$data5 = prepareConfig.data) === null || _prepareConfig$data5 === void 0 ? void 0 : _prepareConfig$data5.available_wallet_list) || []));
+              availableWalletPassList = (prepareConfig === null || prepareConfig === void 0 || (_prepareConfig$data6 = prepareConfig.data) === null || _prepareConfig$data6 === void 0 ? void 0 : _prepareConfig$data6.available_wallet_pass_list) || [];
               availableWalletIds = this.normalizePositiveNumberIds([].concat(_toConsumableArray(availableWalletList.map(function (item) {
                 return item === null || item === void 0 ? void 0 : item.wallet_id;
               })), _toConsumableArray(availableWalletPassList.map(function (item) {
                 return item === null || item === void 0 ? void 0 : item.product_id;
               }))));
-              virtualCurrencyList = this.normalizeVirtualCurrencyList(prepareConfig === null || prepareConfig === void 0 || (_prepareConfig$data6 = prepareConfig.data) === null || _prepareConfig$data6 === void 0 ? void 0 : _prepareConfig$data6.virtual_currency_list);
+              virtualCurrencyList = this.normalizeVirtualCurrencyList(prepareConfig === null || prepareConfig === void 0 || (_prepareConfig$data7 = prepareConfig.data) === null || _prepareConfig$data7 === void 0 ? void 0 : _prepareConfig$data7.virtual_currency_list);
               goodPassList = this.filterEnabledDiscountList(rawDiscountList) || []; // this.setDiscountList(goodPassList);
               return _context4.abrupt("return", {
                 discountList: goodPassList,
@@ -199,7 +212,7 @@ export var DiscountModule = /*#__PURE__*/function (_BaseModule) {
                   return _objectSpread({}, item || {});
                 })
               });
-            case 11:
+            case 14:
             case "end":
               return _context4.stop();
           }
@@ -253,7 +266,7 @@ export var DiscountModule = /*#__PURE__*/function (_BaseModule) {
               return this.request.get("/machinecode/batch-search", _objectSpread(_objectSpread({
                 code: code,
                 translate_flag: 1,
-                tags: ['good_pass', 'product_discount_card'],
+                tags: ['entitlement_pass', 'good_pass', 'product_discount_card'],
                 // available: 1,
                 relation_product: 1,
                 with: ['extensionData', 'customScheduleSnapshot', 'holder.detail'],
@@ -292,8 +305,11 @@ export var DiscountModule = /*#__PURE__*/function (_BaseModule) {
               return this.request.get("/machinecode/batch-search", {
                 ids: productIds,
                 translate_flag: 1,
-                tags: ['good_pass', 'product_discount_card'],
-                relation_product: 1
+                tags: ['entitlement_pass', 'good_pass', 'product_discount_card'],
+                relation_product: 1,
+                with: ['extensionData', 'customScheduleSnapshot', 'holder.detail'],
+                unified_status_info_flag: 1,
+                request_timezone: Intl.DateTimeFormat().resolvedOptions().timeZone
               });
             case 2:
               result = _context6.sent;
@@ -308,160 +324,30 @@ export var DiscountModule = /*#__PURE__*/function (_BaseModule) {
         return _batchSearchByProductIds.apply(this, arguments);
       }
       return batchSearchByProductIds;
-    }()
+    }() // 展示列表只剔除已失效项，当前不可用项保留并携带原因。
   }, {
     key: "filterEnabledDiscountList",
     value: function filterEnabledDiscountList(discountList) {
-      var _this2 = this;
       return discountList.filter(function (discount) {
-        return discount.limit_status === 'enable' && new Decimal((discount === null || discount === void 0 ? void 0 : discount.par_value) || 0).minus(new Decimal((discount === null || discount === void 0 ? void 0 : discount.used_par_value) || 0)).greaterThan(0) && _this2.checkUsageCreditsLimit(discount);
+        return discount.limit_status === 'enable' && hasAvailableDiscountBalance(discount) && !getDiscountLifecycleReason(discount);
+      }).map(function (discount) {
+        return _objectSpread(_objectSpread({}, discount), {}, {
+          usageLimitFailKey: getDiscountUsageLimitFailKey(discount),
+          reasonCode: getDiscountUsageBlockReason(discount)
+        });
       });
     }
-
-    // 检查使用次数限制
-  }, {
-    key: "checkUsageCreditsLimit",
-    value: function checkUsageCreditsLimit(discount) {
-      // 如果没有 extension_data，则不需要限制
-      if (!discount.extension_data || discount.extension_data.length === 0) {
-        return true;
-      }
-
-      // 查找 field_key 为 usage_credits 的数据
-      var usageCreditsData = discount.extension_data.find(function (data) {
-        return data.field_key === 'usage_credits';
-      });
-
-      // 如果没有找到 usage_credits 数据，则不需要限制
-      if (!usageCreditsData) {
-        return true;
-      }
-      var value = usageCreditsData.value;
-
-      // 检查总次数限制
-      if (value.total_credits && value.total_credits > 0) {
-        if ((discount.total_order_behavior_count || 0) >= value.total_credits) {
-          return false;
-        }
-      }
-
-      // 检查单用户限制
-      if (value.per_user_limit && value.per_user_limit > 0) {
-        if ((discount.customer_order_behavior_count || 0) >= value.per_user_limit) {
-          return false;
-        }
-      }
-
-      // 检查单日限制
-      if (value.max_per_day && value.max_per_day > 0) {
-        if ((discount.today_order_behavior_count || 0) >= value.max_per_day) {
-          return false;
-        }
-      }
-
-      // 检查单周限制
-      if (value.max_per_week && value.max_per_week > 0) {
-        if ((discount.week_order_behavior_count || 0) >= value.max_per_week) {
-          return false;
-        }
-      }
-
-      // 检查单月限制
-      if (value.max_per_month && value.max_per_month > 0) {
-        if ((discount.month_order_behavior_count || 0) >= value.max_per_month) {
-          return false;
-        }
-      }
-
-      // 所有检查都通过
-      return true;
-    }
-
-    // 过滤启用且可用的优惠券，并返回校验失败原因
   }, {
     key: "filterEnabledDiscountListWithReason",
     value: function filterEnabledDiscountListWithReason(discountList) {
-      var _this3 = this;
-      var lists = discountList.filter(function (discount) {
-        return discount.limit_status === 'enable';
-      }).filter(function (discount) {
-        var remaining = new Decimal((discount === null || discount === void 0 ? void 0 : discount.par_value) || 0).minus(new Decimal((discount === null || discount === void 0 ? void 0 : discount.used_par_value) || 0)).greaterThan(0);
-        return remaining;
-      }).map(function (discount) {
-        var limitFailKey = _this3.checkUsageCreditsLimitWithFailKey(discount);
-        return _objectSpread(_objectSpread({}, discount), {}, {
-          usageLimitFailKey: limitFailKey
-        });
-      });
-
-      // 可用的列表
-      var availableLists = lists.filter(function (item) {
-        return !item.usageLimitFailKey && item.unified_available_status !== 0;
-      });
-      // 不可用数据
-      var currentFailDiscount = lists.find(function (item) {
-        return item.usageLimitFailKey;
-      });
       return {
-        discountList: availableLists,
-        unavailableReasonKey: currentFailDiscount === null || currentFailDiscount === void 0 ? void 0 : currentFailDiscount.usageLimitFailKey
+        discountList: this.filterEnabledDiscountList(discountList),
+        unavailableReasonKey: discountList.map(getDiscountUsageLimitFailKey).find(function (key) {
+          return key !== null;
+        }) || null
       };
     }
 
-    // 检查使用次数限制，并返回校验失败原因
-  }, {
-    key: "checkUsageCreditsLimitWithFailKey",
-    value: function checkUsageCreditsLimitWithFailKey(discount) {
-      if (!discount.extension_data || discount.extension_data.length === 0) {
-        return null;
-      }
-      var usageCreditsData = discount.extension_data.find(function (data) {
-        return data.field_key === 'usage_credits';
-      });
-      if (!usageCreditsData) {
-        return null;
-      }
-      var value = usageCreditsData.value;
-
-      // 总次数限制
-      if (value.total_credits && value.total_credits > 0) {
-        if ((discount.total_order_behavior_count || 0) >= value.total_credits) {
-          return 'total_credits';
-        }
-      }
-
-      // 单用户限制
-      if (value.per_user_limit && value.per_user_limit > 0) {
-        if ((discount.customer_order_behavior_count || 0) >= value.per_user_limit) {
-          return 'per_user_limit';
-        }
-      }
-
-      // 单日限制
-      if (value.max_per_day && value.max_per_day > 0) {
-        if ((discount.today_order_behavior_count || 0) >= value.max_per_day) {
-          return 'max_per_day';
-        }
-      }
-
-      // 单周限制
-      if (value.max_per_week && value.max_per_week > 0) {
-        if ((discount.week_order_behavior_count || 0) >= value.max_per_week) {
-          return 'max_per_week';
-        }
-      }
-
-      // 单月限制
-      if (value.max_per_month && value.max_per_month > 0) {
-        if ((discount.month_order_behavior_count || 0) >= value.max_per_month) {
-          return 'max_per_month';
-        }
-      }
-
-      // 全部通过
-      return null;
-    }
-
     // 根据productIds去重
   }, {
     key: "uniqueByProductId",

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

@@ -44,7 +44,10 @@ interface ApplicableProductDetails {
     original_amount: string;
     num: number;
     metadata?: {
+        encoded?: string;
         product_discount_difference?: number;
+        /** 月卡扣除本单新增使用后的剩余次数；不限次数时为 null。 */
+        balance?: number | null;
     };
     discount?: {
         fixed_amount?: number;
@@ -63,6 +66,13 @@ interface UsageCreditsValue {
     max_per_week: number;
     max_per_month: number;
 }
+export type IncludedUses = {
+    type: 'limited';
+    value: number;
+} | {
+    type: 'unlimited';
+    value: null;
+};
 export type DiscountFilterRejectKey = 'total_credits' | 'per_user_limit' | 'max_per_day' | 'max_per_week' | 'max_per_month';
 export interface DiscountWithReason {
     discountList: Discount[];
@@ -107,30 +117,37 @@ interface ExtensionData {
 }
 export interface Discount {
     id: number;
+    shop_id?: number;
     product_name: string;
     encoded: string;
     code: string;
     tag: string;
-    expire_time?: string;
+    expire_time?: string | null;
+    expire_date?: string | null;
+    end_time?: string | null;
     product_id: number;
     relation_type: string;
     par_value: string;
     used_par_value: string;
     limit_status: string;
     limited_relation_product_data: Limitedrelationproductdata;
-    balance: string;
+    balance?: string | number | null;
+    available_num?: number;
+    available_products_info?: any[];
     format_title: Formattitle;
     metadata?: {
+        encoded?: string;
         discount_card_type?: 'fixed_amount' | 'percent';
         custom_product_bundle_map_id?: string;
         validity_type?: "custom_schedule_validity" | "fixed_validity";
-        discount_calculation_mode: 'item_level' | 'order_level';
-        holder: {
+        included_uses?: IncludedUses;
+        discount_calculation_mode?: 'item_level' | 'order_level';
+        holder?: {
             type: "customer" | "custom";
         };
     };
     product: Product;
-    type: "product" | 'good_pass';
+    type?: "product" | 'good_pass' | 'entitlement_pass' | 'discount_card' | 'product_discount_card';
     resource_id?: number;
     savedAmount?: number;
     isEditMode?: boolean;
@@ -163,9 +180,17 @@ export interface Discount {
     applicableProductIds?: number[];
     applicableProductDetails: ApplicableProductDetails[];
     appliedProductDetails: ApplicableProductDetails[];
+    /** Entitlement Pass 编辑订单时已经提交的使用明细。 */
+    committedAppliedProductDetails?: ApplicableProductDetails[];
     isDisabledForProductUsed?: boolean;
     amount?: number;
     customer_id?: number | string | null;
+    holder?: {
+        holder_type?: 'customer' | 'form' | string;
+        holder_id?: number | string | Array<number | string>;
+        created_at?: string | null;
+        [key: string]: any;
+    };
     extension_data?: ExtensionData[];
     total_order_behavior_count?: number;
     today_order_behavior_count?: number;
@@ -180,6 +205,12 @@ export interface Discount {
     start_time?: string;
     discount_rule_uncheck_flag?: boolean;
     usageLimitFailKey?: string | null;
+    /** 本次规则计算的不可用原因；可用性恢复后清除。 */
+    reason?: string;
+    reasonCode?: string;
+    unified_messages?: {
+        title?: string | Record<string, string>;
+    };
     unified_available_status?: number | undefined | null;
 }
 export interface DiscountState {

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

@@ -33,7 +33,7 @@ export declare class OpenDataModule extends BaseModule implements Module {
     getOpenData(): OpenDataConfig | null;
     getInvoiceLayoutConfig(): InvoiceLayoutConfig;
     getInvoiceTemplateSettings(): InvoiceTemplateSettings;
-    ensureInvoiceTemplateSettings(target: string): Promise<InvoiceTemplateSettings>;
+    ensureInvoiceTemplateSettings(target: string, openDataConfig?: OpenDataConfig): Promise<InvoiceTemplateSettings>;
     private commitInvoiceTemplateSettings;
     private resolveInvoiceTemplateSettings;
     private buildInvoiceTemplateCacheKey;

package/dist/modules/OpenData/index.js

@@ -132,7 +132,8 @@ export var OpenDataModule = /*#__PURE__*/function (_BaseModule) {
     key: "shouldSkipInvoiceTemplateDocument",
     value: function shouldSkipInvoiceTemplateDocument() {
       var _this$otherParams;
-      return String(((_this$otherParams = this.otherParams) === null || _this$otherParams === void 0 ? void 0 : _this$otherParams.platform) || '').trim().toLowerCase() === 'h5';
+      var platform = String(((_this$otherParams = this.otherParams) === null || _this$otherParams === void 0 ? void 0 : _this$otherParams.platform) || '').trim().toLowerCase();
+      return platform === 'pc' || platform === 'h5';
     }
   }, {
     key: "fetchOpenData",
@@ -233,39 +234,47 @@ export var OpenDataModule = /*#__PURE__*/function (_BaseModule) {
   }, {
     key: "ensureInvoiceTemplateSettings",
     value: function () {
-      var _ensureInvoiceTemplateSettings = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee3(target) {
+      var _ensureInvoiceTemplateSettings = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee3(target, openDataConfig) {
         var normalizedTarget, config, fetchRevision, resolved;
         return _regeneratorRuntime().wrap(function _callee3$(_context3) {
           while (1) switch (_context3.prev = _context3.next) {
             case 0:
               normalizedTarget = String(target || '').trim();
+              if (openDataConfig && openDataConfig !== this.store.data) {
+                // 部分解决方案会在初始化参数中直接收到已经拉取完成的 OpenData。
+                // 将它纳入模块状态后再解析 Document，避免为了 Invoice 重复请求 setting，
+                // 同时让后续同步 getter 能校验同一份 document id 与 target。
+                this.fetchRevision += 1;
+                this.store.data = openDataConfig;
+                this.store.lastFetchedAt = Date.now();
+              }
               config = this.store.data;
               if (!(!normalizedTarget || !config)) {
-                _context3.next = 4;
+                _context3.next = 5;
                 break;
               }
               return _context3.abrupt("return", getDefaultInvoiceTemplateSettings());
-            case 4:
+            case 5:
               fetchRevision = this.fetchRevision;
-              _context3.next = 7;
+              _context3.next = 8;
               return this.resolveInvoiceTemplateSettings(config, normalizedTarget);
-            case 7:
+            case 8:
               resolved = _context3.sent;
               if (!(fetchRevision !== this.fetchRevision || this.store.data !== config)) {
-                _context3.next = 10;
+                _context3.next = 11;
                 break;
               }
               return _context3.abrupt("return", getDefaultInvoiceTemplateSettings());
-            case 10:
+            case 11:
               this.commitInvoiceTemplateSettings(normalizedTarget, resolved);
               return _context3.abrupt("return", normalizeRawInvoiceTemplateSettings(resolved.settings));
-            case 12:
+            case 13:
             case "end":
               return _context3.stop();
           }
         }, _callee3, this);
       }));
-      function ensureInvoiceTemplateSettings(_x4) {
+      function ensureInvoiceTemplateSettings(_x4, _x5) {
         return _ensureInvoiceTemplateSettings.apply(this, arguments);
       }
       return ensureInvoiceTemplateSettings;
@@ -367,7 +376,7 @@ export var OpenDataModule = /*#__PURE__*/function (_BaseModule) {
           }
         }, _callee4, this);
       }));
-      function resolveInvoiceTemplateSettings(_x5, _x6) {
+      function resolveInvoiceTemplateSettings(_x6, _x7) {
         return _resolveInvoiceTemplateSettings.apply(this, arguments);
       }
       return resolveInvoiceTemplateSettings;
@@ -424,7 +433,7 @@ export var OpenDataModule = /*#__PURE__*/function (_BaseModule) {
           }
         }, _callee5, this);
       }));
-      function fetchInvoiceTemplateDocument(_x7) {
+      function fetchInvoiceTemplateDocument(_x8) {
         return _fetchInvoiceTemplateDocument.apply(this, arguments);
       }
       return fetchInvoiceTemplateDocument;

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

@@ -3,7 +3,7 @@ import { BaseModule } from '../BaseModule';
 import { OrderModuleAPI, CommitOrderParams, UpdateOrderBookingParams, UpdateOrderProductParams, UpdateOrderProductQuantityParams, CancelOrderParams, ChangeBookingStatusParams, CheckoutOrderParams } from './types';
 import { CartItem } from '../Cart/types';
 import { type SubmitPayloadEnhancer } from './utils';
-import type { OrderAmountSnapshot, AddProductBookingInput, AddProductToOrderOptions, OrderIdentitySnapshot, OrderPaymentSource, OrderSnapshot, OrderSyncState, SyncPaymentsToOrderParams, SyncPaymentsToOrderResult, SubmitSalesOrderParams, OrderProduct, OrderProductIdentity, OrderSummary, OrderTempOrder, OrderPaymentData, OrderPaymentUpdateOptions, OrderPaymentUpdateResult, SendCustomerPayLinkParams, UpdateTempOrderCustomerInput, OrderCustomerPatch, OrderCustomerView, ReplaceTempOrderOptions, OrderPromotionEvaluator, OrderGiftSelectResolver, OrderUnfulfilledPromotion, OrderLastGiftActions, RemoveProductsFromOrderOptions, SalesNote, SalesNotesMutationSnapshot, SetSalesNoteInput, PickupReferenceMode, ShopServiceData, ShopServiceType } from './types';
+import type { OrderAmountSnapshot, AddProductBookingInput, AddProductToOrderOptions, OrderIdentitySnapshot, OrderPaymentSource, OrderSnapshot, OrderSyncState, SyncPaymentsToOrderParams, SyncPaymentsToOrderResult, SubmitSalesOrderParams, OrderProduct, OrderProductIdentity, OrderSummary, OrderTempOrder, OrderPaymentData, OrderPaymentUpdateOptions, OrderPaymentUpdateResult, SendCustomerPayLinkParams, UpdateTempOrderCustomerInput, OrderCustomerPatch, OrderCustomerView, ReplaceTempOrderOptions, OrderPromotionEvaluator, OrderGiftSelectResolver, OrderUnfulfilledPromotion, OrderLastGiftActions, RemoveProductsFromOrderOptions, SalesNote, SalesNotesMutationSnapshot, SetSalesNoteInput, PickupReferenceMode, PointCardSnapshotMergeContext, PointCardSnapshotItem, ShopServiceData, ShopServiceType } from './types';
 import type { ICustomer } from '../AccountList/types';
 import type { Discount } from '../Discount/types';
 import { UnavailableReason } from '../Rules/types';
@@ -20,6 +20,10 @@ export declare class OrderModule extends BaseModule implements Module, OrderModu
     private openCache;
     private sessionStoragePersistEnabled;
     private sessionStorageRestoreRecord;
+    /** 只允许当前订单最新的 prepare/config 请求回写客户资产态。 */
+    private customerWalletPrepareConfigEpoch;
+    /** Payment 可能早于 prepare/config 返回；先按实例 ID 暂存卡号等待 Snapshot。 */
+    private pointCardSnapshotCodeCandidates;
     private salesSummaryModuleName;
     private rulesHooksOverride?;
     private moduleHooksOverride?;
@@ -78,6 +82,11 @@ export declare class OrderModule extends BaseModule implements Module, OrderModu
     private logError;
     private registerDiscountModules;
     private createDefaultRulesHooks;
+    /**
+     * Stable across notifyTempOrderChanged's immutable copy, but changes when a
+     * different local/server order becomes current.
+     */
+    private getDiscountConfigOrderIdentityKey;
     loadDiscountConfig(params: {
         customerId: number;
         action?: 'create' | 'edit';
@@ -87,6 +96,7 @@ export declare class OrderModule extends BaseModule implements Module, OrderModu
     getDiscountList(): Discount[];
     getAvailableWalletIds(): number[];
     getVirtualCurrencyList(): import("../Discount/types").VirtualCurrencyAsset[];
+    getCustomerWalletPrepareConfigEpoch(): number;
     private syncScannedDiscountsToOriginalDiscountList;
     private ensureEditDiscountConfigForProductChange;
     scanCode(code: string, customerId?: number): Promise<{
@@ -101,6 +111,7 @@ export declare class OrderModule extends BaseModule implements Module, OrderModu
     applyDiscount(options?: {
         reapplyBookingDiscountProductUids?: string[];
         reapplyWeighedDiscountProductUids?: string[];
+        preferredEntitlementPassIds?: number[];
     }): void;
     /**
      * 注入促销评估器。
@@ -177,8 +188,19 @@ export declare class OrderModule extends BaseModule implements Module, OrderModu
     consumeSessionStorageRestore(): Record<string, any> | null;
     notifyTempOrderChanged(): void;
     private createDefaultTempOrderInstance;
-    private clearTempOrderPointCardSnapshot;
-    private writePointCardSnapshotFromPrepareConfig;
+    private clearTempOrderCustomerWalletSnapshots;
+    private clearCustomerWalletState;
+    private clearCustomerWalletRuntimeState;
+    private rememberPointCardSnapshotCodeCandidates;
+    private getRememberedPointCardSnapshotCodeCandidates;
+    private getPointCardSnapshotOrderIdentityKey;
+    private isPointCardSnapshotMergeContextCurrent;
+    private writeCustomerWalletSnapshotsFromPrepareConfig;
+    /**
+     * 将 Payment WalletPass 返回的实例 code 回填到当前订单 Snapshot。
+     * 这里只按资产 ID 补空值，不新增卡、不覆盖 prepare/config 冻结的余额。
+     */
+    mergePointCardSnapshotCodes(walletPassList: unknown, context?: PointCardSnapshotMergeContext): PointCardSnapshotItem[];
     private createExternalSaleNumber;
     private ensureExternalSaleNumber;
     private ensureRequestUniqueIdempotencyToken;
@@ -468,7 +490,12 @@ export declare class OrderModule extends BaseModule implements Module, OrderModu
     }>, options?: {
         skipEditDiscountConfigRefresh?: boolean;
     }): Promise<OrderProduct[]>;
+    private getFullCoveragePassDiscounts;
+    private hasEntitlementPassDiscount;
     private hasGoodPassDiscount;
+    private isPersistedProductLine;
+    private isRuntimeEntitlementAppend;
+    private hasSameEntitlementMergePriceConfig;
     private getBundleRuntimeIdentity;
     private preservePersistedBundlePriceFields;
     private applyOrderProductUpdateToTempOrder;
@@ -589,6 +616,7 @@ export declare class OrderModule extends BaseModule implements Module, OrderModu
      */
     createOrderByCheckout(params: CheckoutOrderParams): Promise<any>;
     submitSalesOrder<T = any>(params: SubmitSalesOrderParams): Promise<T>;
+    private isSalesCheckoutHandledByOsServer;
     /**
      * 发送支付链接邮件。
      *
@@ -635,4 +663,4 @@ export declare class OrderModule extends BaseModule implements Module, OrderModu
     getOrderInfo(order_id: number): Promise<any>;
     getVouchers(): any[];
 }
-export type { AddProductToOrderOptions, OrderMetaList, PointCardSnapshotItem, RemoveProductsFromOrderOptions, SalesNote, SalesNoteDraftInput, SalesNoteLocalizedSelection, SalesNoteLocalizedText, SalesNoteRelation, SalesNoteTextInput, SetSalesNoteInput, UpdateOrderBookingParams, UpdateOrderProductParams, UpdateOrderProductQuantityParams, } from './types';
+export type { AddProductToOrderOptions, OrderMetaList, PointCardSnapshotItem, VirtualCurrencySnapshotItem, RemoveProductsFromOrderOptions, SalesNote, SalesNoteDraftInput, SalesNoteLocalizedSelection, SalesNoteLocalizedText, SalesNoteRelation, SalesNoteTextInput, SetSalesNoteInput, UpdateOrderBookingParams, UpdateOrderProductParams, UpdateOrderProductQuantityParams, } from './types';