@pisell/pisellos 2.3.50 → 2.3.53

package/lib/server/index.js

@@ -82,10 +82,6 @@ var Server = class {
     this.productQuerySubscribers = /* @__PURE__ */ new Map();
     /** subscriberId → 智能定价变价时间点定时器句柄（与 subscriber 分离存储，便于 clear） */
     this.productQueryScheduleTimers = /* @__PURE__ */ new Map();
-    /** 餐牌筛选为空时才触发的菜单/日程缓存自愈，避免每次商品查询都请求远端。 */
-    this.menuScheduleRefreshInFlight = null;
-    this.lastMenuScheduleRefreshAt = 0;
-    this.MENU_SCHEDULE_REFRESH_COOLDOWN_MS = 30 * 1e3;
     // ---- 订单 / 预约列表查询订阅者 ----
     this.orderQuerySubscribers = /* @__PURE__ */ new Map();
     this.bookingQuerySubscribers = /* @__PURE__ */ new Map();
@@ -219,11 +215,7 @@ var Server = class {
      */
     this.handleProductQuery = async ({ url, method, data, config }) => {
       console.log("[Server] handleProductQuery:", url, method, data, config);
-      const { menu_list_ids, customer_id, ids, extension_type, strategy_context } = data;
-      const { schedule_date, schedule_datetime } = this.resolveProductQueryScheduleContext({
-        schedule_date: data.schedule_date,
-        schedule_datetime: data.schedule_datetime
-      });
+      const { menu_list_ids, schedule_datetime, schedule_date, customer_id, ids, extension_type, strategy_context } = data;
       const { callback, subscriberId } = config || {};
       this.logInfo("handleProductQuery: 开始处理商品查询请求", {
         menu_list_ids,
@@ -2219,12 +2211,15 @@ var Server = class {
       return;
     const scheduleDate = subscriber.context.schedule_date || (0, import_dayjs.default)().format("YYYY-MM-DD");
     const timerIds = [];
-    setInterval(() => {
-      const currentTime = (0, import_dayjs.default)().format("hh:mm");
-      if (timePoints.includes(currentTime)) {
-        this.onScheduleTimePointTimerFire(subscriberId);
-      }
-    }, 6e4);
+    for (const timePoint of timePoints) {
+      const delayMs = this.computeScheduleTimePointDelayMs(scheduleDate, timePoint);
+      if (delayMs < 0)
+        continue;
+      const timerId = setTimeout(() => {
+        void this.onScheduleTimePointTimerFire(subscriberId, timerId);
+      }, delayMs);
+      timerIds.push(timerId);
+    }
     if (timerIds.length > 0) {
       this.productQueryScheduleTimers.set(subscriberId, timerIds);
       subscriber.scheduleTimerIds = timerIds;
@@ -2239,7 +2234,7 @@ var Server = class {
    * schedule 变价时间点定时器触发：刷新 schedule_datetime 后重算并 callback。
    */
   async onScheduleTimePointTimerFire(subscriberId, timerId) {
-    timerId && this.removeScheduleTimerRef(subscriberId, timerId);
+    this.removeScheduleTimerRef(subscriberId, timerId);
     if (!this.productQuerySubscribers.has(subscriberId))
       return;
     const subscriber = this.productQuerySubscribers.get(subscriberId);
@@ -2282,43 +2277,6 @@ var Server = class {
       this.scheduleSubscriberTimePointReloads(subscriberId, timePoints);
     }
   }
-  /**
-   * ProductList callers such as standalone retail pages do not always have a selected schedule.
-   * In that case query against the current local time so menu availability can still be evaluated.
-   */
-  resolveProductQueryScheduleContext(params) {
-    const now = (0, import_dayjs.default)();
-    const schedule_datetime = typeof params.schedule_datetime === "string" && params.schedule_datetime.trim() ? params.schedule_datetime : now.format("YYYY-MM-DD HH:mm:ss");
-    const schedule_date = typeof params.schedule_date === "string" && params.schedule_date.trim() ? params.schedule_date : (0, import_dayjs.default)(schedule_datetime).isValid() ? (0, import_dayjs.default)(schedule_datetime).format("YYYY-MM-DD") : now.format("YYYY-MM-DD");
-    return { schedule_date, schedule_datetime };
-  }
-  /**
-   * OpenData 的关联餐牌可能已更新，而 server_menu/server_schedule 仍命中本地持久化缓存。
-   * 仅在当前筛选没有任何生效餐牌时刷新一次，并由调用方重新计算筛选结果。
-   */
-  async refreshMenuScheduleCacheAfterEmptyResult() {
-    if (!this.menu || !this.schedule)
-      return false;
-    const now = Date.now();
-    if (now - this.lastMenuScheduleRefreshAt < this.MENU_SCHEDULE_REFRESH_COOLDOWN_MS) {
-      return false;
-    }
-    if (!this.menuScheduleRefreshInFlight) {
-      this.lastMenuScheduleRefreshAt = now;
-      this.menuScheduleRefreshInFlight = Promise.all([
-        this.menu.loadMenuList(),
-        this.schedule.loadAllSchedule()
-      ]).then(() => void 0).catch((error) => {
-        this.logWarning("刷新菜单/日程缓存失败，继续使用现有缓存", {
-          error: error instanceof Error ? error.message : String(error)
-        });
-      }).finally(() => {
-        this.menuScheduleRefreshInFlight = null;
-      });
-    }
-    await this.menuScheduleRefreshInFlight;
-    return true;
-  }
   /**
    * 执行 sales 搜索并登记可见订单号。
    * 搜索参数完全透传后端，OS 不做过滤、筛选、排序。
@@ -3821,22 +3779,10 @@ var Server = class {
           data: (normalized == null ? void 0 : normalized.data) ?? null
         };
       }
-      const response = this.withSyncedOrderIdInCheckoutResponse(
+      return this.withSyncedOrderIdInCheckoutResponse(
         syncResult.normalizedResponse,
         syncResult.syncedOrder
       );
-      const syncedOrder = syncResult.syncedOrder;
-      if (syncedOrder && this.shouldBuildSmallTicketData(syncResult.checkoutData) && this.isSalesOrderFullyPaid(syncedOrder)) {
-        await this.dispatchLocalReceiptPrint({
-          checkoutData: syncResult.checkoutData,
-          order: syncedOrder,
-          response: syncResult.normalizedResponse,
-          requireFullyPaid: true,
-          // print_all 的 type=0 是收据打印；不要沿用同步成功后的券/手环打印 type=99。
-          isManualPrint: true
-        });
-      }
-      return response;
     } catch (error) {
       const backendError = this.extractBackendErrorResponse(error);
       if (backendError) {
@@ -5126,16 +5072,13 @@ var Server = class {
     let activeMenuList = [];
     if (menu_list_ids && Array.isArray(menu_list_ids) && menu_list_ids.length > 0) {
       const tMenu = performance.now();
-      const getActiveMenus = () => this.menu.getMenuByIds(menu_list_ids).filter((menu) => {
+      const menuList = this.menu.getMenuByIds(menu_list_ids);
+      activeMenuList = menuList.filter((menu) => {
         var _a;
         return ((_a = this.schedule) == null ? void 0 : _a.getDateIsInSchedule(schedule_datetime, menu.schedule)) || false;
       });
-      activeMenuList = getActiveMenus();
-      if (!activeMenuList.length && await this.refreshMenuScheduleCacheAfterEmptyResult()) {
-        activeMenuList = getActiveMenus();
-      }
       (0, import_product.perfMark)("computeQuery.filterActiveMenu", performance.now() - tMenu, {
-        totalMenu: menu_list_ids.length,
+        totalMenu: menuList.length,
         activeMenu: activeMenuList.length
       });
     }

package/lib/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/lib/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）也会被登记。

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

@@ -89,6 +89,24 @@ var OrderModule = class extends import_BaseModule.BaseModule {
     };
     await this.core.effects.emit(import_types.OrderHooks.onOrdersChanged, payload);
   }
+  /**
+   * 广播远端商品成员增删。监听器异常必须与订单落库和原有订单广播隔离。
+   */
+  async emitRemoteProductMembershipChanges(changes) {
+    for (const payload of changes) {
+      try {
+        await this.core.effects.emit(import_types.OrderHooks.onRemoteProductMembershipChanged, payload);
+      } catch (error) {
+        this.logError("广播远端订单商品成员变更失败", {
+          order_id: payload.order_id,
+          source: payload.source,
+          added_product_count: payload.added_product_keys.length,
+          removed_product_count: payload.removed_product_keys.length,
+          error: error instanceof Error ? error.message : String(error)
+        });
+      }
+    }
+  }
   async initialize(core, options) {
     var _a;
     this.core = core;
@@ -314,7 +332,7 @@ var OrderModule = class extends import_BaseModule.BaseModule {
    * @example
    * const { toWrite, skipped } = this.filterRedundantPatchOrders('pubsub.bodyUpsert', orders, mergeActions)
    */
-  filterRedundantPatchOrders(source, orders, mergeActions) {
+  filterRedundantPatchOrders(source, orders, mergeActions, forceWriteStorageKeys = /* @__PURE__ */ new Set()) {
     const eligibleSkipSources = /* @__PURE__ */ new Set(["pubsub.bodyUpsert", "pubsub.httpRefresh"]);
     if (!eligibleSkipSources.has(source)) {
       return { toWrite: orders, skipped: [] };
@@ -334,6 +352,10 @@ var OrderModule = class extends import_BaseModule.BaseModule {
         toWrite.push(order);
         continue;
       }
+      if (forceWriteStorageKeys.has(storageKey)) {
+        toWrite.push(order);
+        continue;
+      }
       const recent = this.recentSqliteWriteByStorageKey.get(storageKey);
       if (recent && ORDER_BUSINESS_WRITE_SOURCES.has(recent.source) && now - recent.ts < ORDER_SQLITE_DEDUPE_MS) {
         skipped.push({
@@ -1484,10 +1506,20 @@ var OrderModule = class extends import_BaseModule.BaseModule {
     });
     this.logDuplicateOrders(`${source}.beforeMerge`, this.store.list);
     const normalizedFreshOrders = [];
+    const incomingProductsHaveStableIdentity = /* @__PURE__ */ new Map();
     for (const order of freshOrders) {
       const id = order == null ? void 0 : order.order_id;
       if (id === void 0 || id === null)
         continue;
+      const rawProducts = order.products;
+      if (Array.isArray(rawProducts)) {
+        const allProductsHaveStableIdentity = this.doProductsHaveStableMembershipIdentity(rawProducts);
+        const orderIdKey = this.getIdKey(id);
+        incomingProductsHaveStableIdentity.set(
+          orderIdKey,
+          (incomingProductsHaveStableIdentity.get(orderIdKey) ?? true) && allProductsHaveStableIdentity
+        );
+      }
       normalizedFreshOrders.push(this.normalizeRemoteSyncedOrder(order));
     }
     const uniqueFreshOrders = this.compactOrderListByIdentity(
@@ -1496,7 +1528,14 @@ var OrderModule = class extends import_BaseModule.BaseModule {
     ).list;
     const uniqueFreshCount = uniqueFreshOrders.length;
     const patchedOrders = [];
+    const remoteProductMembershipChanges = [];
+    const forceWriteStorageKeys = /* @__PURE__ */ new Set();
     const mergeActions = {};
+    const existingProductsHaveStableIdentity = this.store.list.map(
+      (order) => this.doProductsHaveStableMembershipIdentity(
+        order.products
+      )
+    );
     const updatedList = this.store.list.map(
       (order) => this.normalizeOrderForMemoryList(order, `${source}.existingMemory`)
     );
@@ -1540,6 +1579,17 @@ var OrderModule = class extends import_BaseModule.BaseModule {
           continue;
         }
         let mergedOrder = this.mergeOrderRecords(existingOrder, fresh);
+        const freshOrderId = fresh.order_id;
+        const incomingProductsAreStable = freshOrderId !== void 0 && freshOrderId !== null && incomingProductsHaveStableIdentity.get(this.getIdKey(freshOrderId)) !== false;
+        let membershipChange = null;
+        if (Array.isArray(fresh.products) && freshOrderId !== void 0 && freshOrderId !== null && existingProductsHaveStableIdentity[matchIndex] !== false && incomingProductsAreStable) {
+          membershipChange = this.getRemoteProductMembershipChange(
+            existingOrder,
+            mergedOrder,
+            source
+          );
+        }
+        let mergedProductsHaveStableIdentity = existingProductsHaveStableIdentity[matchIndex] !== false && incomingProductsAreStable;
         let adjustedMatchIndex = matchIndex;
         const duplicateIndexes = /* @__PURE__ */ new Set();
         for (const key of freshIdentityKeys) {
@@ -1551,7 +1601,9 @@ var OrderModule = class extends import_BaseModule.BaseModule {
         if (duplicateIndexes.size > 0) {
           for (const duplicateIndex of [...duplicateIndexes].sort((left, right) => right - left)) {
             mergedOrder = this.mergeOrderRecords(mergedOrder, updatedList[duplicateIndex]);
+            mergedProductsHaveStableIdentity = mergedProductsHaveStableIdentity && existingProductsHaveStableIdentity[duplicateIndex] !== false;
             updatedList.splice(duplicateIndex, 1);
+            existingProductsHaveStableIdentity.splice(duplicateIndex, 1);
             if (duplicateIndex < adjustedMatchIndex)
               adjustedMatchIndex -= 1;
           }
@@ -1564,6 +1616,13 @@ var OrderModule = class extends import_BaseModule.BaseModule {
           }
         }
         updatedList[adjustedMatchIndex] = mergedOrder;
+        existingProductsHaveStableIdentity[adjustedMatchIndex] = mergedProductsHaveStableIdentity;
+        if (membershipChange) {
+          remoteProductMembershipChanges.push(membershipChange);
+          const mergedStorageKey = this.getOrderStorageKey(mergedOrder);
+          if (mergedStorageKey)
+            forceWriteStorageKeys.add(mergedStorageKey);
+        }
         this.registerOrderIdentityKeys(identityKeyToIndex, mergedOrder, adjustedMatchIndex);
         patchedOrders.push(mergedOrder);
         if (mergeKey)
@@ -1572,6 +1631,9 @@ var OrderModule = class extends import_BaseModule.BaseModule {
       }
       const insertIndex = updatedList.length;
       updatedList.push(fresh);
+      existingProductsHaveStableIdentity.push(
+        fresh.order_id !== void 0 && fresh.order_id !== null && incomingProductsHaveStableIdentity.get(this.getIdKey(fresh.order_id)) !== false
+      );
       this.registerOrderIdentityKeys(identityKeyToIndex, fresh, insertIndex);
       patchedOrders.push(fresh);
       if (mergeKey)
@@ -1586,13 +1648,20 @@ var OrderModule = class extends import_BaseModule.BaseModule {
     });
     this.store.list = this.runOrderStoreSelfCheck(updatedList, `${source}.store`);
     this.syncOrdersMap();
-    await this.patchOrdersInSQLite(patchedOrders, source, mergeActions);
+    await this.patchOrdersInSQLite(
+      patchedOrders,
+      source,
+      mergeActions,
+      {},
+      forceWriteStorageKeys
+    );
     this.logInfo("mergeOrdersToStore-结束", {
       uniqueFreshCount,
       storeOrderCountAfter: this.store.list.length,
       insertCount,
       updateCount
     });
+    await this.emitRemoteProductMembershipChanges(remoteProductMembershipChanges);
     await this.emitOrdersChanged(patchedOrders, source);
   }
   /**
@@ -1616,6 +1685,72 @@ var OrderModule = class extends import_BaseModule.BaseModule {
   isRemoteEchoMergeSource(source) {
     return source === "pubsub.bodyUpsert" || source === "pubsub.httpRefresh";
   }
+  getProductMembershipKey(product) {
+    const persistentId = (0, import_orderCollectionIdentity.getOrderCollectionPersistentId)("product", product);
+    if (persistentId)
+      return `order_detail_id:${persistentId}`;
+    const uid = (0, import_orderCollectionIdentity.getOrderCollectionUid)("product", product);
+    return uid ? `unique_identification_number:${uid}` : "";
+  }
+  doProductsHaveStableMembershipIdentity(products) {
+    if (!Array.isArray(products))
+      return true;
+    return products.every(
+      (product) => Boolean(
+        (0, import_orderCollectionIdentity.getOrderCollectionPersistentId)("product", product) || (0, import_orderCollectionIdentity.getOrderCollectionUid)("product", product)
+      )
+    );
+  }
+  /**
+   * 冲突提示关注逻辑商品行，而不是服务端 checkout 过程中可能被重建的 detail 记录。
+   * 通用集合合并仍以 order_detail_id 为事实主键；这里只允许相同稳定 UID 跨 detail id 对齐，
+   * 避免本机 checkout 回声被误判成“一删一增”。
+   */
+  isSameProductMembershipItem(left, right) {
+    if ((0, import_orderCollectionIdentity.isSameOrderCollectionItem)("product", left, right))
+      return true;
+    const leftUid = (0, import_orderCollectionIdentity.getOrderCollectionUid)("product", left);
+    const rightUid = (0, import_orderCollectionIdentity.getOrderCollectionUid)("product", right);
+    return Boolean(leftUid && rightUid && leftUid === rightUid);
+  }
+  /**
+   * 对比合并前后的商品成员集合。商品字段修改与数组重排不会产生 diff。
+   */
+  getRemoteProductMembershipChange(existingOrder, mergedOrder, source) {
+    if (!this.isRemoteEchoMergeSource(source))
+      return null;
+    const previousProducts = Array.isArray(existingOrder.products) ? existingOrder.products : [];
+    const currentProducts = Array.isArray(mergedOrder.products) ? mergedOrder.products : [];
+    const unmatchedCurrentIndexes = new Set(currentProducts.map((_, index) => index));
+    const removedProductKeys = [];
+    for (const previousProduct of previousProducts) {
+      const matchedIndex = currentProducts.findIndex(
+        (currentProduct, index) => unmatchedCurrentIndexes.has(index) && this.isSameProductMembershipItem(previousProduct, currentProduct)
+      );
+      if (matchedIndex >= 0) {
+        unmatchedCurrentIndexes.delete(matchedIndex);
+        continue;
+      }
+      const productKey = this.getProductMembershipKey(previousProduct);
+      if (productKey)
+        removedProductKeys.push(productKey);
+    }
+    const addedProductKeys = [...unmatchedCurrentIndexes].map((index) => this.getProductMembershipKey(currentProducts[index])).filter(Boolean);
+    if (addedProductKeys.length === 0 && removedProductKeys.length === 0) {
+      return null;
+    }
+    const orderId = mergedOrder.order_id ?? existingOrder.order_id;
+    if (orderId === void 0 || orderId === null)
+      return null;
+    return {
+      order_id: orderId,
+      source,
+      added_product_keys: addedProductKeys,
+      removed_product_keys: removedProductKeys,
+      previous_product_count: previousProducts.length,
+      current_product_count: currentProducts.length
+    };
+  }
   /**
    * 将订单的全部身份键登记到索引并指向其在列表中的下标。
    * 合并后订单新增的身份字段（如挂单同步后拿到 order_id）也会被登记。
@@ -2140,7 +2275,7 @@ var OrderModule = class extends import_BaseModule.BaseModule {
    * @example
    * await this.patchOrdersInSQLite(freshOrders)
    */
-  async patchOrdersInSQLite(orders, source, mergeActions = {}, options = {}) {
+  async patchOrdersInSQLite(orders, source, mergeActions = {}, options = {}, forceWriteStorageKeys = /* @__PURE__ */ new Set()) {
     if (orders.length === 0) {
       return;
     }
@@ -2156,7 +2291,8 @@ var OrderModule = class extends import_BaseModule.BaseModule {
     const { toWrite, skipped } = this.filterRedundantPatchOrders(
       source,
       ordersSnapshot,
-      mergeActions
+      mergeActions,
+      forceWriteStorageKeys
     );
     if (toWrite.length === 0) {
       return;

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

@@ -568,6 +568,19 @@ export interface OrderChangedPayload {
     /** 触发来源，便于订阅者区分 pubsub / 远端覆盖 / 清空等场景 */
     source?: string;
 }
+export type RemoteProductMembershipChangeSource = 'pubsub.bodyUpsert' | 'pubsub.httpRefresh';
+/**
+ * 远端订单快照相对本地订单产生商品成员增删时的广播载荷。
+ * 只表达商品行成员关系变化，不包含数量、价格、备注等字段级修改。
+ */
+export interface RemoteProductMembershipChangedPayload {
+    order_id: OrderId;
+    source: RemoteProductMembershipChangeSource;
+    added_product_keys: string[];
+    removed_product_keys: string[];
+    previous_product_count: number;
+    current_product_count: number;
+}
 /**
  * OrderSyncMessage - pubsub 同步消息结构
  */
@@ -605,5 +618,6 @@ export interface OrderState {
 export declare enum OrderHooks {
     onOrdersLoaded = "order:onOrdersLoaded",
     onOrdersChanged = "order:onOrdersChanged",
+    onRemoteProductMembershipChanged = "order:onRemoteProductMembershipChanged",
     onOrdersSyncCompleted = "order:onOrdersSyncCompleted"
 }

package/lib/server/modules/order/types.js

@@ -25,6 +25,7 @@ module.exports = __toCommonJS(types_exports);
 var OrderHooks = /* @__PURE__ */ ((OrderHooks2) => {
   OrderHooks2["onOrdersLoaded"] = "order:onOrdersLoaded";
   OrderHooks2["onOrdersChanged"] = "order:onOrdersChanged";
+  OrderHooks2["onRemoteProductMembershipChanged"] = "order:onRemoteProductMembershipChanged";
   OrderHooks2["onOrdersSyncCompleted"] = "order:onOrdersSyncCompleted";
   return OrderHooks2;
 })(OrderHooks || {});

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

@@ -2,14 +2,14 @@ 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, LoadSalesDetailParams, OrderPaymentData, OrderPaymentUpdateOptions, OrderPaymentUpdateResult, OrderPaymentSource, SendCustomerPayLinkParams, SyncPaymentsToOrderParams, SyncPaymentsToOrderResult, UpdateTempOrderCustomerInput, UpdateOrderBookingParams, UpdateOrderProductParams, OrderTempOrder, OrderSummary, OrderPromotionEvaluator, OrderGiftSelectResolver, OrderUnfulfilledPromotion, OrderLastGiftActions } 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 } from '../../modules/Order/types';
 import type { SubmitPayloadEnhancer } from '../../modules/Order/utils';
 import type { Discount } from '../../modules/Discount/types';
 import { RequestPlugin, WindowPlugin } from '../../plugins';
 export * from './types';
 import { ProductList } from '../../modules/ProductList';
 import { PaymentModule } from '../../modules/Payment';
-import type { PaymentMethod, RoundingResult, WalletAssetId, WalletAssetsSnapshot, WalletAssetsState, WalletAssetSelectionSource, ScanWalletAssetResult } from '../../modules/Payment/types';
+import type { PaymentMethod, RoundingResult, WalletAssetId, WalletAssetsBehaviorOptions, WalletAssetsSnapshot, WalletAssetsState, WalletAssetSelectionSource, ScanWalletAssetResult } from '../../modules/Payment/types';
 import type { SalesSummaryModule } from '../../modules/SalesSummary';
 import type { ScheduleModule } from '../../modules/Schedule';
 import { QuotationModule } from '../../modules/Quotation';
@@ -109,6 +109,16 @@ export declare class BaseSalesImpl extends BaseModule implements Module {
     private applyQuotationScheduleResolver;
     private loadQuotationForPriceQuery;
     private getPriceQueryProductId;
+    /**
+   * Change Time / customer reprice 必须沿用商品列表的渠道口径。
+   * SalesSdk Provider 通常将渠道存为 platform，因此不能只读取 otherParams.channel。
+   */
+    private getPriceQueryChannel;
+    /**
+     * /product/query 的智能定价评估只读取 strategy_context；
+     * application_code 仅作为接口兼容字段，不能替代 channel / business_code。
+     */
+    private getPriceQueryStrategyContext;
     private getPriceQuerySchedule;
     private loadProductsForPriceQuery;
     private loadProductForPriceQuery;
@@ -180,7 +190,7 @@ export declare class BaseSalesImpl extends BaseModule implements Module {
     /** 获取附加费用（运费/服务费/税费等）。 */
     getSurcharges(): ISalesSurcharge[];
     getTempOrder(): OrderTempOrder | null;
-    replaceTempOrder(tempOrder: OrderTempOrder): Promise<OrderTempOrder>;
+    replaceTempOrder(tempOrder: OrderTempOrder, options?: ReplaceTempOrderOptions): Promise<OrderTempOrder>;
     getOrderIdentity(): import("../../modules/Order/types").OrderIdentitySnapshot | null;
     getOrderSnapshot(): import("../../modules/Order/types").OrderSnapshot | null;
     getOrderSyncState(): import("../../modules/Order/types").OrderSyncState;
@@ -280,13 +290,6 @@ export declare class BaseSalesImpl extends BaseModule implements Module {
         confirmPendingVoucherPayments?: boolean;
         enhancePayload?: SubmitPayloadEnhancer;
     }): Promise<T>;
-    /**
-     * 默认保持 WebPOS 的本地待同步订单模式；需要云端确认后才算成功的渠道可覆盖此策略。
-     * otherParams.checkoutSyncTaskEnabled 优先，便于同一 solution 按入口恢复旧行为。
-     */
-    protected shouldUseCheckoutSyncTask(): boolean;
-    /** 可由特定 solution 为真实 checkout 补充默认收据数据请求。 */
-    protected getDefaultCheckoutSmallTicketDataFlag(): number | undefined;
     printLocalOrderReceipt<T = any>(lookup?: BaseSalesPrintLocalOrderReceiptParams): Promise<T>;
     private getSubmitPaymentStatus;
     syncPaymentsToOrder<T = any>(params: SyncPaymentsToOrderParams): Promise<SyncPaymentsToOrderResult<T>>;
@@ -333,6 +336,8 @@ export declare class BaseSalesImpl extends BaseModule implements Module {
     getWalletAssetsState(): WalletAssetsState;
     /** 导出 Shared Checkout 跨运行时恢复所需的钱包状态与搜索缓存。 */
     exportWalletAssetsSnapshot(): WalletAssetsSnapshot;
+    /** 配置仅影响 Wallet Assets，不改变 Promotion/Voucher 选择流程。 */
+    configureWalletAssetsBehavior(options: WalletAssetsBehaviorOptions): void;
     /**
      * 恢复 Shared Checkout 钱包快照，并把选择重新同步为订单 pending payment。
      */
@@ -419,7 +424,7 @@ export declare class BaseSalesImpl extends BaseModule implements Module {
     getQuotationCustomerScopeInfo(): BaseSalesQuotationCustomerScopeInfo;
     shouldRecalculateProductBookingPricesForContextChange(params: BaseSalesPriceRecalculationContextChange): boolean;
     calculateProductBookingPrices(paramsList: BaseSalesCalculateProductBookingPriceParams[]): Promise<BaseSalesProductBookingPriceResult[]>;
-    addProductToOrder(product: Partial<BaseSalesOrderProduct> & BaseSalesOrderProductIdentity, booking?: AddProductBookingInput): Promise<import("../../modules/Order/types").OrderProduct[]>;
+    addProductToOrder(product: Partial<BaseSalesOrderProduct> & BaseSalesOrderProductIdentity, booking?: AddProductBookingInput, options?: AddProductToOrderOptions): Promise<import("../../modules/Order/types").OrderProduct[]>;
     updateOrderProduct(params: UpdateOrderProductParams): Promise<import("../../modules/Order/types").OrderProduct[]>;
     updateOrderProducts(paramsList: UpdateOrderProductParams[]): Promise<import("../../modules/Order/types").OrderProduct[]>;
     updateOrderProductQuantity(params: BaseSalesUpdateOrderProductQuantityParams): Promise<import("../../modules/Order/types").OrderProduct[]>;
@@ -435,8 +440,8 @@ export declare class BaseSalesImpl extends BaseModule implements Module {
      * @example
      * await baseSales.removeProductsFromOrder([identityA, identityB]);
      */
-    removeProductsFromOrder(identities: BaseSalesOrderProductIdentity[]): Promise<import("../../modules/Order/types").OrderProduct[]>;
-    removeProductFromOrder(identity: BaseSalesOrderProductIdentity): Promise<import("../../modules/Order/types").OrderProduct[]>;
+    removeProductsFromOrder(identities: BaseSalesOrderProductIdentity[], options?: RemoveProductsFromOrderOptions): Promise<import("../../modules/Order/types").OrderProduct[]>;
+    removeProductFromOrder(identity: BaseSalesOrderProductIdentity, options?: RemoveProductsFromOrderOptions): Promise<import("../../modules/Order/types").OrderProduct[]>;
     /**
      * 注入促销评估器到底层 OrderModule。
      *