@pisell/pisellos 2.3.50 → 2.3.51

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

@@ -487,7 +487,7 @@ export declare class OrderModule extends BaseModule implements Module, OrderModu
     generateIdempotencyToken(): string;
     syncPaymentsToOrder<T = any>(params: SyncPaymentsToOrderParams): Promise<SyncPaymentsToOrderResult<T>>;
     createOrder(params: CommitOrderParams['query']): {
-        type: "appointment_booking" | "virtual";
+        type: "virtual" | "appointment_booking";
         platform: string;
         sales_channel: string;
         order_sales_channel: string;

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

@@ -397,12 +397,18 @@ export interface WalletAssetsState {
 export interface WalletAssetsSnapshot {
     state: WalletAssetsState;
     searchResults: SearchIdentificationCodeItem[];
+    /** 已搜索但尚未满足订单条件、等待首次可用后自动选中的 Wallet Asset code。 */
+    pendingAutoSelectSearchCodes?: string[];
     walletParams: WalletDeductionRecommendParams | null;
     calculationContext: {
         orderTotalAmount: number;
         products: any[];
     };
 }
+export interface WalletAssetsBehaviorOptions {
+    /** 搜索到 Wallet Asset 后，当前或后续首次可用时是否自动选中。 */
+    autoSelectAfterSearch?: boolean;
+}
 export interface RefreshWalletAssetsOptions {
     /** 商品/金额变化默认保留并重验选择；客户变化由实现层强制清空。 */
     preserveSelection?: boolean;
@@ -472,6 +478,8 @@ export interface WalletPassPayment {
     refreshWalletAssetsFromBusinessAsync: (businessData: WalletInitBusinessData, options?: RefreshWalletAssetsOptions) => Promise<WalletAssetsState>;
     /** 获取共享钱包资产状态快照。 */
     getWalletAssetsState: () => WalletAssetsState;
+    /** 配置仅影响 Wallet Assets 的交互行为。 */
+    configureWalletAssetsBehavior: (options: WalletAssetsBehaviorOptions) => void;
     /** 导出供 Shared Checkout 跨运行时传递的 Wallet Assets 快照。 */
     exportWalletAssetsSnapshot: () => WalletAssetsSnapshot;
     /** 恢复 Shared Checkout 传回的 Wallet Assets 快照。 */

package/dist/modules/Payment/walletpass.d.ts

@@ -1,4 +1,4 @@
-import { WalletPassPayment, WalletDeductionRecommendParams, WalletRecommendItem, UserIdentificationCodeParams, UserIdentificationCodeItem, SearchIdentificationCodeParams, SearchIdentificationCodeItem, SearchIdentificationCodeResult, WalletInitBusinessData, WalletAssetId, WalletAssetsSnapshot, WalletAssetsState, RefreshWalletAssetsOptions, SelectWalletAssetOptions, ScanWalletAssetResult } from './types';
+import { WalletPassPayment, WalletDeductionRecommendParams, WalletRecommendItem, UserIdentificationCodeParams, UserIdentificationCodeItem, SearchIdentificationCodeParams, SearchIdentificationCodeItem, SearchIdentificationCodeResult, WalletInitBusinessData, WalletAssetId, WalletAssetsBehaviorOptions, WalletAssetsSnapshot, WalletAssetsState, RefreshWalletAssetsOptions, SelectWalletAssetOptions, ScanWalletAssetResult } from './types';
 import type { PaymentModule } from './index';
 /**
  * 钱包支付实现
@@ -12,8 +12,11 @@ export declare class WalletPassPaymentImpl implements WalletPassPayment {
     private walletInitData;
     private walletAssetsState;
     private walletAssetsRequestSequence;
+    private walletAssetsBehavior;
+    private pendingAutoSelectSearchCodes;
     private walletAssetsCalculationContext;
     constructor(paymentModule: PaymentModule);
+    configureWalletAssetsBehavior(options: WalletAssetsBehaviorOptions): void;
     /**
      * 发送事件的辅助方法
      * 支持使用WalletPassHooks或PaymentHooks
@@ -28,6 +31,9 @@ export declare class WalletPassPaymentImpl implements WalletPassPayment {
      * 接口暂时缺失某个扫码 code 时继续保留旧值，避免列表闪空。
      */
     private syncSearchedWalletAssets;
+    private isPendingAutoSelectAsset;
+    private clearPendingAutoSelectForAsset;
+    private queuePendingAutoSelectForAssets;
     /**
      * 生成钱包API默认参数
      * 根据业务数据生成标准的钱包API参数，并存储在模块中

package/dist/modules/Payment/walletpass.js

@@ -39,6 +39,12 @@ function matchesWalletAssetCode(asset, normalizedCode) {
     return String(identifier !== null && identifier !== void 0 ? identifier : '').trim() === normalizedCode;
   });
 }
+function normalizeWalletAssetCode(code) {
+  return String(code !== null && code !== void 0 ? code : '').trim().toUpperCase();
+}
+function getWalletAssetCodeKeys(asset) {
+  return [asset === null || asset === void 0 ? void 0 : asset.code, asset === null || asset === void 0 ? void 0 : asset.encoded].map(normalizeWalletAssetCode).filter(Boolean);
+}
 function isWalletAssetAvailable(asset) {
   if (!asset) return false;
   if (asset.unified_available_status !== undefined && Number(asset.unified_available_status) !== 1) {
@@ -102,18 +108,31 @@ export var WalletPassPaymentImpl = /*#__PURE__*/function () {
     _defineProperty(this, "walletInitData", null);
     _defineProperty(this, "walletAssetsState", createInitialWalletAssetsState());
     _defineProperty(this, "walletAssetsRequestSequence", 0);
+    _defineProperty(this, "walletAssetsBehavior", {
+      autoSelectAfterSearch: true
+    });
+    _defineProperty(this, "pendingAutoSelectSearchCodes", new Set());
     _defineProperty(this, "walletAssetsCalculationContext", {
       orderTotalAmount: 0,
       products: []
     });
     this.paymentModule = paymentModule;
   }
-
-  /**
-   * 发送事件的辅助方法
-   * 支持使用WalletPassHooks或PaymentHooks
-   */
   _createClass(WalletPassPaymentImpl, [{
+    key: "configureWalletAssetsBehavior",
+    value: function configureWalletAssetsBehavior(options) {
+      if (options.autoSelectAfterSearch === undefined) return;
+      this.walletAssetsBehavior.autoSelectAfterSearch = options.autoSelectAfterSearch;
+      if (!options.autoSelectAfterSearch) {
+        this.pendingAutoSelectSearchCodes.clear();
+      }
+    }
+
+    /**
+     * 发送事件的辅助方法
+     * 支持使用WalletPassHooks或PaymentHooks
+     */
+  }, {
     key: "emitEvent",
     value: function emitEvent(hook, data) {
       try {
@@ -250,6 +269,33 @@ export var WalletPassPaymentImpl = /*#__PURE__*/function () {
       }
       return mergeWalletAssets(cachedAssets, refreshedAssets);
     }
+  }, {
+    key: "isPendingAutoSelectAsset",
+    value: function isPendingAutoSelectAsset(asset) {
+      var _this = this;
+      return getWalletAssetCodeKeys(asset).some(function (code) {
+        return _this.pendingAutoSelectSearchCodes.has(code);
+      });
+    }
+  }, {
+    key: "clearPendingAutoSelectForAsset",
+    value: function clearPendingAutoSelectForAsset(asset) {
+      var _this2 = this;
+      getWalletAssetCodeKeys(asset).forEach(function (code) {
+        _this2.pendingAutoSelectSearchCodes.delete(code);
+      });
+    }
+  }, {
+    key: "queuePendingAutoSelectForAssets",
+    value: function queuePendingAutoSelectForAssets(assets) {
+      var _this3 = this;
+      if (!this.walletAssetsBehavior.autoSelectAfterSearch) return;
+      assets.forEach(function (asset) {
+        getWalletAssetCodeKeys(asset).forEach(function (code) {
+          _this3.pendingAutoSelectSearchCodes.add(code);
+        });
+      });
+    }
 
     /**
      * 生成钱包API默认参数
@@ -960,7 +1006,8 @@ export var WalletPassPaymentImpl = /*#__PURE__*/function () {
     key: "refreshWalletAssetsFromBusinessAsync",
     value: (function () {
       var _refreshWalletAssetsFromBusinessAsync = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee8(businessData) {
-        var _businessData$product2;
+        var _businessData$product2,
+          _this4 = this;
         var options,
           requestSequence,
           nextCustomerId,
@@ -971,6 +1018,7 @@ export var WalletPassPaymentImpl = /*#__PURE__*/function () {
           committedItems,
           selectedIds,
           selectionSources,
+          scanSelectedAssets,
           restoredSearchedAssets,
           searchedWalletAssetCodes,
           useAggregateRecalculate,
@@ -984,6 +1032,11 @@ export var WalletPassPaymentImpl = /*#__PURE__*/function () {
           items,
           latestSelectedIds,
           latestSelectionSources,
+          pendingAutoSelectAssets,
+          requestedKeySet,
+          nextState,
+          selectedKeySet,
+          droppedScanSelectedAssets,
           _args8 = arguments;
         return _regeneratorRuntime().wrap(function _callee8$(_context8) {
           while (1) switch (_context8.prev = _context8.next) {
@@ -1004,12 +1057,18 @@ export var WalletPassPaymentImpl = /*#__PURE__*/function () {
                 return committedKeys.has(getWalletAssetKey(item));
               });
               selectedIds = preserveSelection ? _toConsumableArray(this.walletAssetsState.selectedIds) : [];
-              selectionSources = preserveSelection ? _objectSpread({}, this.walletAssetsState.selectionSources) : {}; // aggregate-recalculate 不接受空商品列表。
-              // 清空购物车时保留扫码资产供后续加购恢复，但必须取消当前选择。
+              selectionSources = preserveSelection ? _objectSpread({}, this.walletAssetsState.selectionSources) : {};
+              scanSelectedAssets = preserveSelection ? this.walletAssetsState.selectedItems.filter(function (asset) {
+                var assetId = getWalletAssetId(asset);
+                return assetId !== undefined && assetId !== null && selectionSources[String(assetId)] === 'scan';
+              }) : []; // aggregate-recalculate 不接受空商品列表。
+              // 清空购物车时保留扫码资产供后续加购恢复；只有手动 Remove/Clear
+              // 会取消自动应用资格，商品变化导致的自动失效需要重新进入待选队列。
               if ((_businessData$product2 = businessData.products) !== null && _businessData$product2 !== void 0 && _businessData$product2.length) {
-                _context8.next = 20;
+                _context8.next = 22;
                 break;
               }
+              this.queuePendingAutoSelectForAssets(scanSelectedAssets);
               this.generateWalletParams(businessData);
               restoredSearchedAssets = this.searchResults.filter(isWalletPaymentAsset).map(function (item) {
                 return _objectSpread(_objectSpread({}, item), {}, {
@@ -1044,7 +1103,7 @@ export var WalletPassPaymentImpl = /*#__PURE__*/function () {
                 totalSelectedAmount: 0,
                 error: null
               }));
-            case 20:
+            case 22:
               this.publishWalletAssetsState({
                 status: 'loading',
                 customerId: nextCustomerId,
@@ -1055,40 +1114,40 @@ export var WalletPassPaymentImpl = /*#__PURE__*/function () {
                 totalSelectedAmount: preserveSelection ? this.walletAssetsState.totalSelectedAmount : 0,
                 error: null
               });
-              _context8.prev = 21;
+              _context8.prev = 23;
               searchedWalletAssetCodes = preserveSelection ? this.getSearchedWalletAssetCodes() : [];
               useAggregateRecalculate = preserveSelection && (selectedIds.length > 0 || searchedWalletAssetCodes.length > 0);
               if (!useAggregateRecalculate) {
-                _context8.next = 30;
+                _context8.next = 32;
                 break;
               }
-              _context8.next = 27;
+              _context8.next = 29;
               return this.aggregateRecalculateWalletAssetsAsync(businessData, selectedIds);
-            case 27:
+            case 29:
               _context8.t0 = _context8.sent;
-              _context8.next = 31;
+              _context8.next = 33;
               break;
-            case 30:
+            case 32:
               _context8.t0 = null;
-            case 31:
+            case 33:
               aggregateResult = _context8.t0;
               _context8.t1 = aggregateResult;
               if (_context8.t1) {
-                _context8.next = 37;
+                _context8.next = 39;
                 break;
               }
-              _context8.next = 36;
+              _context8.next = 38;
               return this.initializeWalletDataFromBusinessAsync(businessData);
-            case 36:
+            case 38:
               _context8.t1 = _context8.sent;
-            case 37:
+            case 39:
               result = _context8.t1;
               if (!(requestSequence !== this.walletAssetsRequestSequence)) {
-                _context8.next = 40;
+                _context8.next = 42;
                 break;
               }
               return _context8.abrupt("return", this.getWalletAssetsState());
-            case 40:
+            case 42:
               this.walletAssetsCalculationContext = {
                 orderTotalAmount: Number(businessData.order_wait_pay_amount || 0),
                 products: result.products || businessData.products || []
@@ -1111,11 +1170,11 @@ export var WalletPassPaymentImpl = /*#__PURE__*/function () {
               }
               searchedWalletAssets = preserveSelection ? this.syncSearchedWalletAssets([].concat(_toConsumableArray(result.transformList || []), _toConsumableArray(result.noApplicableVoucher || []))) : [];
               if (!(requestSequence !== this.walletAssetsRequestSequence)) {
-                _context8.next = 46;
+                _context8.next = 48;
                 break;
               }
               return _context8.abrupt("return", this.getWalletAssetsState());
-            case 46:
+            case 48:
               recommendedKeys = new Set((result.walletRecommendList || []).map(function (asset) {
                 return getWalletAssetKey(asset);
               }));
@@ -1126,16 +1185,47 @@ export var WalletPassPaymentImpl = /*#__PURE__*/function () {
               });
               latestSelectedIds = preserveSelection ? authoritativeSelectedIds : [];
               latestSelectionSources = preserveSelection ? _objectSpread({}, this.walletAssetsState.selectionSources) : {};
-              return _context8.abrupt("return", this.recalculateWalletAssets(items, latestSelectedIds, latestSelectionSources));
-            case 53:
-              _context8.prev = 53;
-              _context8.t2 = _context8["catch"](21);
+              pendingAutoSelectAssets = this.walletAssetsBehavior.autoSelectAfterSearch ? items.filter(function (asset) {
+                return _this4.isPendingAutoSelectAsset(asset) && isWalletAssetAvailable(asset);
+              }) : [];
+              requestedKeySet = new Set(latestSelectedIds.map(function (id) {
+                return String(id);
+              }));
+              pendingAutoSelectAssets.forEach(function (asset) {
+                var assetId = getWalletAssetId(asset);
+                if (assetId === undefined || assetId === null) return;
+                var assetKey = String(assetId);
+                if (!requestedKeySet.has(assetKey)) {
+                  requestedKeySet.add(assetKey);
+                  latestSelectedIds.push(assetId);
+                }
+                latestSelectionSources[assetKey] = 'scan';
+              });
+              nextState = this.recalculateWalletAssets(items, latestSelectedIds, latestSelectionSources);
+              selectedKeySet = new Set(nextState.selectedIds.map(function (id) {
+                return String(id);
+              }));
+              pendingAutoSelectAssets.forEach(function (asset) {
+                var assetId = getWalletAssetId(asset);
+                if (assetId !== undefined && assetId !== null && selectedKeySet.has(String(assetId))) {
+                  _this4.clearPendingAutoSelectForAsset(asset);
+                }
+              });
+              droppedScanSelectedAssets = scanSelectedAssets.filter(function (asset) {
+                var assetId = getWalletAssetId(asset);
+                return assetId !== undefined && assetId !== null && !selectedKeySet.has(String(assetId));
+              });
+              this.queuePendingAutoSelectForAssets(droppedScanSelectedAssets);
+              return _context8.abrupt("return", nextState);
+            case 63:
+              _context8.prev = 63;
+              _context8.t2 = _context8["catch"](23);
               if (!(requestSequence !== this.walletAssetsRequestSequence)) {
-                _context8.next = 57;
+                _context8.next = 67;
                 break;
               }
               return _context8.abrupt("return", this.getWalletAssetsState());
-            case 57:
+            case 67:
               this.paymentModule.logError('[WalletPass] 刷新共享钱包资产失败，保留刷新前状态', _context8.t2, {
                 customer_id: businessData.customer_id,
                 selected_ids: selectedIds,
@@ -1151,11 +1241,11 @@ export var WalletPassPaymentImpl = /*#__PURE__*/function () {
                 customerId: nextCustomerId,
                 error: _context8.t2 instanceof Error ? _context8.t2.message : String(_context8.t2)
               }));
-            case 59:
+            case 69:
             case "end":
               return _context8.stop();
           }
-        }, _callee8, this, [[21, 53]]);
+        }, _callee8, this, [[23, 63]]);
       }));
       function refreshWalletAssetsFromBusinessAsync(_x9) {
         return _refreshWalletAssetsFromBusinessAsync.apply(this, arguments);
@@ -1179,6 +1269,7 @@ export var WalletPassPaymentImpl = /*#__PURE__*/function () {
       return {
         state: this.getWalletAssetsState(),
         searchResults: _toConsumableArray(this.searchResults),
+        pendingAutoSelectSearchCodes: _toConsumableArray(this.pendingAutoSelectSearchCodes),
         walletParams: this.walletParams ? _objectSpread({}, this.walletParams) : null,
         calculationContext: {
           orderTotalAmount: this.walletAssetsCalculationContext.orderTotalAmount,
@@ -1193,6 +1284,7 @@ export var WalletPassPaymentImpl = /*#__PURE__*/function () {
       if (!(snapshot !== null && snapshot !== void 0 && snapshot.state)) return this.getWalletAssetsState();
       this.walletAssetsRequestSequence += 1;
       this.searchResults = Array.isArray(snapshot.searchResults) ? _toConsumableArray(snapshot.searchResults) : [];
+      this.pendingAutoSelectSearchCodes = this.walletAssetsBehavior.autoSelectAfterSearch && Array.isArray(snapshot.pendingAutoSelectSearchCodes) ? new Set(snapshot.pendingAutoSelectSearchCodes.map(normalizeWalletAssetCode).filter(Boolean)) : new Set();
       this.walletParams = snapshot.walletParams ? _objectSpread({}, snapshot.walletParams) : null;
       this.walletAssetsCalculationContext = {
         orderTotalAmount: Number(((_snapshot$calculation = snapshot.calculationContext) === null || _snapshot$calculation === void 0 ? void 0 : _snapshot$calculation.orderTotalAmount) || 0),
@@ -1210,6 +1302,9 @@ export var WalletPassPaymentImpl = /*#__PURE__*/function () {
     key: "selectWalletAsset",
     value: function selectWalletAsset(assetId, options) {
       var assetKey = String(assetId);
+      var asset = this.walletAssetsState.items.find(function (item) {
+        return getWalletAssetKey(item) === assetKey;
+      });
       var committedKeys = new Set(this.walletAssetsState.committedIds.map(function (id) {
         return String(id);
       }));
@@ -1220,22 +1315,27 @@ export var WalletPassPaymentImpl = /*#__PURE__*/function () {
       var selectionSources = _objectSpread({}, this.walletAssetsState.selectionSources);
       delete selectionSources[assetKey];
       if (options.selected) {
-        var asset = this.walletAssetsState.items.find(function (item) {
-          return getWalletAssetKey(item) === assetKey;
-        });
         if (!asset || !isWalletAssetAvailable(asset)) {
           return this.getWalletAssetsState();
         }
         selectedIds.push(assetId);
         selectionSources[assetKey] = options.source || 'manual';
+      } else if (asset) {
+        this.clearPendingAutoSelectForAsset(asset);
       }
-      return this.recalculateWalletAssets(this.walletAssetsState.items, selectedIds, selectionSources);
+      var nextState = this.recalculateWalletAssets(this.walletAssetsState.items, selectedIds, selectionSources);
+      if (options.selected && asset && nextState.selectedIds.some(function (id) {
+        return String(id) === assetKey;
+      })) {
+        this.clearPendingAutoSelectForAsset(asset);
+      }
+      return nextState;
     }
   }, {
     key: "scanWalletAssetAsync",
     value: function () {
       var _scanWalletAssetAsync = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee9(code) {
-        var normalizedCode, selectedAsset, result, paymentAssets, asset, items, assetId, selected;
+        var normalizedCode, selectedAsset, result, paymentAssets, asset, items, recalculatedState, assetId, selected, isSelected;
         return _regeneratorRuntime().wrap(function _callee9$(_context9) {
           while (1) switch (_context9.prev = _context9.next) {
             case 0:
@@ -1288,21 +1388,28 @@ export var WalletPassPaymentImpl = /*#__PURE__*/function () {
               });
             case 14:
               items = mergeWalletAssets(this.walletAssetsState.items, [asset]);
-              this.recalculateWalletAssets(items, this.walletAssetsState.selectedIds, this.walletAssetsState.selectionSources);
+              recalculatedState = this.recalculateWalletAssets(items, this.walletAssetsState.selectedIds, this.walletAssetsState.selectionSources);
               assetId = getWalletAssetId(asset);
-              selected = assetId !== undefined && isWalletAssetAvailable(asset) ? this.selectWalletAsset(assetId, {
+              selected = this.walletAssetsBehavior.autoSelectAfterSearch && assetId !== undefined && isWalletAssetAvailable(asset) ? this.selectWalletAsset(assetId, {
                 selected: true,
                 source: 'scan'
-              }) : this.getWalletAssetsState();
+              }) : recalculatedState;
+              isSelected = assetId !== undefined && selected.selectedIds.some(function (id) {
+                return String(id) === String(assetId);
+              });
+              if (isSelected) {
+                this.clearPendingAutoSelectForAsset(asset);
+              } else if (this.walletAssetsBehavior.autoSelectAfterSearch) {
+                this.pendingAutoSelectSearchCodes.add(normalizeWalletAssetCode(normalizedCode));
+                this.queuePendingAutoSelectForAssets([asset]);
+              }
               return _context9.abrupt("return", {
                 type: result.type,
                 asset: asset,
-                selected: assetId !== undefined && selected.selectedIds.some(function (id) {
-                  return String(id) === String(assetId);
-                }),
+                selected: isSelected,
                 state: selected
               });
-            case 19:
+            case 21:
             case "end":
               return _context9.stop();
           }
@@ -1316,6 +1423,7 @@ export var WalletPassPaymentImpl = /*#__PURE__*/function () {
   }, {
     key: "clearWalletAssetSelection",
     value: function clearWalletAssetSelection() {
+      this.pendingAutoSelectSearchCodes.clear();
       return this.recalculateWalletAssets(this.walletAssetsState.items, [], {});
     }
   }, {
@@ -1491,6 +1599,7 @@ export var WalletPassPaymentImpl = /*#__PURE__*/function () {
     key: "clearSearchResults",
     value: function clearSearchResults() {
       this.searchResults = [];
+      this.pendingAutoSelectSearchCodes.clear();
       this.paymentModule.logInfo('[WalletPass] 搜索结果缓存已清除');
     }
 
@@ -1522,6 +1631,7 @@ export var WalletPassPaymentImpl = /*#__PURE__*/function () {
       this.walletRecommendList = [];
       this.userIdentificationCodes = [];
       this.searchResults = [];
+      this.pendingAutoSelectSearchCodes.clear();
       this.walletParams = null;
       this.walletInitData = null;
       this.walletAssetsRequestSequence += 1;

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

@@ -14,7 +14,7 @@ export { QuotationHooks } from './quotation/types';
 export { ScheduleModuleEx } from './schedule';
 export type { ScheduleState, ScheduleItem } from './schedule/types';
 export { OrderModule } from './order';
-export type { OrderState, OrderData, OrderId, OrderSummary, OrderBookingItem, OrderProductLineItem, OrderPaymentItem, OrderSurchargeItem, OrderProductDiscountItem, OrderWithoutBookings, BookingData, OrderFilters, BookingFilters, OrderFilterResult, OrderFilterRejectDetail, OrderFilterRejectedEntry, BookingFilterResult, OrderModulePagedResult, } from './order/types';
+export type { OrderState, OrderData, OrderId, OrderSummary, OrderBookingItem, OrderProductLineItem, OrderPaymentItem, OrderSurchargeItem, OrderProductDiscountItem, OrderWithoutBookings, BookingData, OrderFilters, BookingFilters, OrderFilterResult, OrderFilterRejectDetail, OrderFilterRejectedEntry, BookingFilterResult, OrderModulePagedResult, RemoteProductMembershipChangedPayload, RemoteProductMembershipChangeSource, } from './order/types';
 export { OrderHooks } from './order/types';
 export { PaymentServerModule } from './payment';
 export type { PaymentMethod, PaymentMethodsChangedEventData, PaymentServerState } from './payment/types';

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

@@ -30,6 +30,10 @@ export declare class OrderModule extends BaseModule implements Module {
      * await this.emitOrdersChanged([freshOrder], 'pubsub.bodyUpsert')
      */
     private emitOrdersChanged;
+    /**
+     * 广播远端商品成员增删。监听器异常必须与订单落库和原有订单广播隔离。
+     */
+    private emitRemoteProductMembershipChanges;
     initialize(core: PisellCore, options?: ModuleOptions): Promise<void>;
     /**
      * 记录信息日志
@@ -231,6 +235,18 @@ export declare class OrderModule extends BaseModule implements Module {
      */
     private lookupOrderIndexByIdentityKeys;
     private isRemoteEchoMergeSource;
+    private getProductMembershipKey;
+    private doProductsHaveStableMembershipIdentity;
+    /**
+     * 冲突提示关注逻辑商品行，而不是服务端 checkout 过程中可能被重建的 detail 记录。
+     * 通用集合合并仍以 order_detail_id 为事实主键；这里只允许相同稳定 UID 跨 detail id 对齐，
+     * 避免本机 checkout 回声被误判成“一删一增”。
+     */
+    private isSameProductMembershipItem;
+    /**
+     * 对比合并前后的商品成员集合。商品字段修改与数组重排不会产生 diff。
+     */
+    private getRemoteProductMembershipChange;
     /**
      * 将订单的全部身份键登记到索引并指向其在列表中的下标。
      * 合并后订单新增的身份字段（如挂单同步后拿到 order_id）也会被登记。