@pisell/pisellos 2.3.49 → 2.3.50

package/lib/server/index.d.ts

@@ -49,6 +49,10 @@ declare class Server {
     private productQuerySubscribers;
     /** subscriberId → 智能定价变价时间点定时器句柄（与 subscriber 分离存储，便于 clear） */
     private productQueryScheduleTimers;
+    /** 餐牌筛选为空时才触发的菜单/日程缓存自愈，避免每次商品查询都请求远端。 */
+    private menuScheduleRefreshInFlight;
+    private lastMenuScheduleRefreshAt;
+    private readonly MENU_SCHEDULE_REFRESH_COOLDOWN_MS;
     private orderQuerySubscribers;
     private bookingQuerySubscribers;
     private bookingRemoteQuerySubscribers;
@@ -262,6 +266,16 @@ declare class Server {
      * 存储订阅者信息，便于数据变更时推送最新结果
      */
     private handleProductQuery;
+    /**
+     * 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.
+     */
+    private resolveProductQueryScheduleContext;
+    /**
+     * OpenData 的关联餐牌可能已更新，而 server_menu/server_schedule 仍命中本地持久化缓存。
+     * 仅在当前筛选没有任何生效餐牌时刷新一次，并由调用方重新计算筛选结果。
+     */
+    private refreshMenuScheduleCacheAfterEmptyResult;
     /**
      * 按商品 id 查询单条（GET /shop/product/query/:productId）
      * schedule_date 必填：query 或 data；schedule_datetime 可选。不走订阅。

package/lib/server/index.js

@@ -82,6 +82,10 @@ 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();
@@ -215,7 +219,11 @@ var Server = class {
      */
     this.handleProductQuery = async ({ url, method, data, config }) => {
       console.log("[Server] handleProductQuery:", url, method, data, config);
-      const { menu_list_ids, schedule_datetime, schedule_date, customer_id, ids, extension_type, strategy_context } = data;
+      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 { callback, subscriberId } = config || {};
       this.logInfo("handleProductQuery: 开始处理商品查询请求", {
         menu_list_ids,
@@ -2211,15 +2219,12 @@ var Server = class {
       return;
     const scheduleDate = subscriber.context.schedule_date || (0, import_dayjs.default)().format("YYYY-MM-DD");
     const timerIds = [];
-    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);
-    }
+    setInterval(() => {
+      const currentTime = (0, import_dayjs.default)().format("hh:mm");
+      if (timePoints.includes(currentTime)) {
+        this.onScheduleTimePointTimerFire(subscriberId);
+      }
+    }, 6e4);
     if (timerIds.length > 0) {
       this.productQueryScheduleTimers.set(subscriberId, timerIds);
       subscriber.scheduleTimerIds = timerIds;
@@ -2234,7 +2239,7 @@ var Server = class {
    * schedule 变价时间点定时器触发：刷新 schedule_datetime 后重算并 callback。
    */
   async onScheduleTimePointTimerFire(subscriberId, timerId) {
-    this.removeScheduleTimerRef(subscriberId, timerId);
+    timerId && this.removeScheduleTimerRef(subscriberId, timerId);
     if (!this.productQuerySubscribers.has(subscriberId))
       return;
     const subscriber = this.productQuerySubscribers.get(subscriberId);
@@ -2277,6 +2282,43 @@ 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 不做过滤、筛选、排序。
@@ -3779,10 +3821,22 @@ var Server = class {
           data: (normalized == null ? void 0 : normalized.data) ?? null
         };
       }
-      return this.withSyncedOrderIdInCheckoutResponse(
+      const response = 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) {
@@ -5072,13 +5126,16 @@ var Server = class {
     let activeMenuList = [];
     if (menu_list_ids && Array.isArray(menu_list_ids) && menu_list_ids.length > 0) {
       const tMenu = performance.now();
-      const menuList = this.menu.getMenuByIds(menu_list_ids);
-      activeMenuList = menuList.filter((menu) => {
+      const getActiveMenus = () => this.menu.getMenuByIds(menu_list_ids).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: menuList.length,
+        totalMenu: menu_list_ids.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, RemoteProductMembershipChangedPayload, RemoteProductMembershipChangeSource, } from './order/types';
+export type { OrderState, OrderData, OrderId, OrderSummary, OrderBookingItem, OrderProductLineItem, OrderPaymentItem, OrderSurchargeItem, OrderProductDiscountItem, OrderWithoutBookings, BookingData, OrderFilters, BookingFilters, OrderFilterResult, OrderFilterRejectDetail, OrderFilterRejectedEntry, BookingFilterResult, OrderModulePagedResult, } 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,10 +30,6 @@ 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>;
     /**
      * 记录信息日志
@@ -235,18 +231,6 @@ 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,24 +89,6 @@ 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;
@@ -332,7 +314,7 @@ var OrderModule = class extends import_BaseModule.BaseModule {
    * @example
    * const { toWrite, skipped } = this.filterRedundantPatchOrders('pubsub.bodyUpsert', orders, mergeActions)
    */
-  filterRedundantPatchOrders(source, orders, mergeActions, forceWriteStorageKeys = /* @__PURE__ */ new Set()) {
+  filterRedundantPatchOrders(source, orders, mergeActions) {
     const eligibleSkipSources = /* @__PURE__ */ new Set(["pubsub.bodyUpsert", "pubsub.httpRefresh"]);
     if (!eligibleSkipSources.has(source)) {
       return { toWrite: orders, skipped: [] };
@@ -352,10 +334,6 @@ 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({
@@ -1506,20 +1484,10 @@ 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(
@@ -1528,14 +1496,7 @@ 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`)
     );
@@ -1579,17 +1540,6 @@ 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) {
@@ -1601,9 +1551,7 @@ 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;
           }
@@ -1616,13 +1564,6 @@ 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)
@@ -1631,9 +1572,6 @@ 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)
@@ -1648,20 +1586,13 @@ var OrderModule = class extends import_BaseModule.BaseModule {
     });
     this.store.list = this.runOrderStoreSelfCheck(updatedList, `${source}.store`);
     this.syncOrdersMap();
-    await this.patchOrdersInSQLite(
-      patchedOrders,
-      source,
-      mergeActions,
-      {},
-      forceWriteStorageKeys
-    );
+    await this.patchOrdersInSQLite(patchedOrders, source, mergeActions);
     this.logInfo("mergeOrdersToStore-结束", {
       uniqueFreshCount,
       storeOrderCountAfter: this.store.list.length,
       insertCount,
       updateCount
     });
-    await this.emitRemoteProductMembershipChanges(remoteProductMembershipChanges);
     await this.emitOrdersChanged(patchedOrders, source);
   }
   /**
@@ -1685,72 +1616,6 @@ 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）也会被登记。
@@ -2275,7 +2140,7 @@ var OrderModule = class extends import_BaseModule.BaseModule {
    * @example
    * await this.patchOrdersInSQLite(freshOrders)
    */
-  async patchOrdersInSQLite(orders, source, mergeActions = {}, options = {}, forceWriteStorageKeys = /* @__PURE__ */ new Set()) {
+  async patchOrdersInSQLite(orders, source, mergeActions = {}, options = {}) {
     if (orders.length === 0) {
       return;
     }
@@ -2291,8 +2156,7 @@ var OrderModule = class extends import_BaseModule.BaseModule {
     const { toWrite, skipped } = this.filterRedundantPatchOrders(
       source,
       ordersSnapshot,
-      mergeActions,
-      forceWriteStorageKeys
+      mergeActions
     );
     if (toWrite.length === 0) {
       return;

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

@@ -568,19 +568,6 @@ 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 同步消息结构
  */
@@ -618,6 +605,5 @@ 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,7 +25,6 @@ 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

@@ -9,7 +9,7 @@ import { RequestPlugin, WindowPlugin } from '../../plugins';
 export * from './types';
 import { ProductList } from '../../modules/ProductList';
 import { PaymentModule } from '../../modules/Payment';
-import type { PaymentMethod, RoundingResult, WalletAssetId, WalletAssetsBehaviorOptions, WalletAssetsSnapshot, WalletAssetsState, WalletAssetSelectionSource, ScanWalletAssetResult } from '../../modules/Payment/types';
+import type { PaymentMethod, RoundingResult, WalletAssetId, 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';
@@ -280,6 +280,13 @@ 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>>;
@@ -326,8 +333,6 @@ 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。
      */

package/lib/solution/BaseSales/index.js

@@ -1008,7 +1008,7 @@ var BaseSalesImpl = class extends import_BaseModule.BaseModule {
     return isChanged;
   }
   async initialize(core, options = {}) {
-    var _a, _b;
+    var _a, _b, _c, _d;
     this.core = core;
     this.initializeOptions = options || {};
     this.paymentNumberDevicePrefix = null;
@@ -1019,10 +1019,9 @@ var BaseSalesImpl = class extends import_BaseModule.BaseModule {
     this.request = core.getPlugin("request");
     this.appPlugin = core.getPlugin("app");
     if (!this.appPlugin) {
-      throw new Error("Checkout 解决方案需要 app 插件支持");
     }
-    const app = this.appPlugin.getApp();
-    this.logger = app.logger;
+    const app = (_c = (_b = this.appPlugin) == null ? void 0 : _b.getApp) == null ? void 0 : _c.call(_b);
+    this.logger = app == null ? void 0 : app.logger;
     const targetCacheData = this.readSessionCacheData();
     const moduleNames = this.getRegisteredModuleNames();
     moduleNames.forEach((step) => {
@@ -1047,7 +1046,7 @@ var BaseSalesImpl = class extends import_BaseModule.BaseModule {
     if (this.store.schedule && !this.isScheduleListLoaded(this.store.schedule)) {
       await this.store.schedule.loadAllSchedule();
     }
-    if (this.store.order && typeof ((_b = this.otherParams) == null ? void 0 : _b.enableTempOrderPersist) === "boolean") {
+    if (this.store.order && typeof ((_d = this.otherParams) == null ? void 0 : _d.enableTempOrderPersist) === "boolean") {
       this.store.order.setEnableTempOrderPersist(
         this.otherParams.enableTempOrderPersist
       );
@@ -1901,6 +1900,7 @@ var BaseSalesImpl = class extends import_BaseModule.BaseModule {
       throw new Error("BaseSales 解决方案需要 order 模块支持");
     }
     const inferredPaymentStatus = this.getSubmitPaymentStatus(params == null ? void 0 : params.paymentStatus);
+    const smallTicketDataFlag = (params == null ? void 0 : params.smallTicketDataFlag) ?? this.getDefaultCheckoutSmallTicketDataFlag();
     const submitParams = {
       cacheId: this.cacheId,
       platform: (_a = this.otherParams) == null ? void 0 : _a.platform,
@@ -1910,11 +1910,11 @@ var BaseSalesImpl = class extends import_BaseModule.BaseModule {
       request_unique_idempotency_token: this.store.order.generateIdempotencyToken(),
       ...(params == null ? void 0 : params.payments) !== void 0 ? { payments: params.payments } : {},
       ...inferredPaymentStatus !== void 0 ? { paymentStatus: inferredPaymentStatus } : {},
-      ...(params == null ? void 0 : params.smallTicketDataFlag) !== void 0 ? { smallTicketDataFlag: params.smallTicketDataFlag } : {},
+      ...smallTicketDataFlag !== void 0 ? { smallTicketDataFlag } : {},
       ...(params == null ? void 0 : params.confirmPendingVoucherPayments) !== void 0 ? { confirmPendingVoucherPayments: params.confirmPendingVoucherPayments } : {},
       ...(params == null ? void 0 : params.enhancePayload) !== void 0 ? { enhancePayload: params.enhancePayload } : {}
     };
-    return this.store.order.submitTempOrder(submitParams);
+    return this.shouldUseCheckoutSyncTask() ? this.store.order.submitTempOrder(submitParams) : this.store.order.submitTempOrderAsync(submitParams);
   }
   async saveSalesOrderDraft(params) {
     var _a, _b, _c, _d;
@@ -1936,20 +1936,35 @@ var BaseSalesImpl = class extends import_BaseModule.BaseModule {
       throw new Error("BaseSales 解决方案需要 order 模块支持");
     }
     const inferredPaymentStatus = this.getSubmitPaymentStatus(params == null ? void 0 : params.paymentStatus);
+    const smallTicketDataFlag = (params == null ? void 0 : params.smallTicketDataFlag) ?? this.getDefaultCheckoutSmallTicketDataFlag();
     const submitParams = {
       cacheId: this.cacheId,
       platform: (_a = this.otherParams) == null ? void 0 : _a.platform,
       businessCode: ((_b = this.otherParams) == null ? void 0 : _b.businessCode) || ((_c = this.otherParams) == null ? void 0 : _c.business_code),
       channel: this.getSubmitOrderSalesChannel(),
       type: (_d = this.otherParams) == null ? void 0 : _d.type,
+      request_unique_idempotency_token: this.store.order.generateIdempotencyToken(),
       ...(params == null ? void 0 : params.payments) !== void 0 ? { payments: params.payments } : {},
       ...inferredPaymentStatus !== void 0 ? { paymentStatus: inferredPaymentStatus } : {},
-      ...(params == null ? void 0 : params.smallTicketDataFlag) !== void 0 ? { smallTicketDataFlag: params.smallTicketDataFlag } : {},
+      ...smallTicketDataFlag !== void 0 ? { smallTicketDataFlag } : {},
       ...(params == null ? void 0 : params.confirmPendingVoucherPayments) !== void 0 ? { confirmPendingVoucherPayments: params.confirmPendingVoucherPayments } : {},
       ...(params == null ? void 0 : params.enhancePayload) !== void 0 ? { enhancePayload: params.enhancePayload } : {}
     };
     return this.store.order.submitTempOrderAsync(submitParams);
   }
+  /**
+   * 默认保持 WebPOS 的本地待同步订单模式；需要云端确认后才算成功的渠道可覆盖此策略。
+   * otherParams.checkoutSyncTaskEnabled 优先，便于同一 solution 按入口恢复旧行为。
+   */
+  shouldUseCheckoutSyncTask() {
+    var _a;
+    const configured = (_a = this.otherParams) == null ? void 0 : _a.checkoutSyncTaskEnabled;
+    return typeof configured === "boolean" ? configured : true;
+  }
+  /** 可由特定 solution 为真实 checkout 补充默认收据数据请求。 */
+  getDefaultCheckoutSmallTicketDataFlag() {
+    return void 0;
+  }
   async printLocalOrderReceipt(lookup) {
     var _a, _b, _c, _d, _e, _f, _g;
     if (!this.store.order) {
@@ -2009,6 +2024,7 @@ var BaseSalesImpl = class extends import_BaseModule.BaseModule {
     const channel = params.channel ?? this.getSubmitOrderSalesChannel();
     const syncParams = {
       ...params,
+      checkoutSyncTaskEnabled: this.shouldUseCheckoutSyncTask(),
       ...businessCode !== void 0 ? { businessCode } : {},
       ...channel !== void 0 ? { channel } : {}
     };
@@ -2535,12 +2551,6 @@ var BaseSalesImpl = class extends import_BaseModule.BaseModule {
       throw new Error("payment 模块未初始化");
     return this.store.payment.wallet.exportWalletAssetsSnapshot();
   }
-  /** 配置仅影响 Wallet Assets，不改变 Promotion/Voucher 选择流程。 */
-  configureWalletAssetsBehavior(options) {
-    if (!this.store.payment)
-      throw new Error("payment 模块未初始化");
-    this.store.payment.wallet.configureWalletAssetsBehavior(options);
-  }
   /**
    * 恢复 Shared Checkout 钱包快照，并把选择重新同步为订单 pending payment。
    */