@pisell/pisellos 2.2.311 → 2.2.312-vm.0

package/lib/solution/BaseSales/index.js

@@ -7,6 +7,7 @@ var _exportNames = {
   BaseSalesImpl: true
 };
 exports.BaseSalesImpl = void 0;
+var _inventory = require("../../inventory");
 var _BaseModule = require("../../modules/BaseModule");
 var _types = require("./types");
 Object.keys(_types).forEach(function (key) {
@@ -468,6 +469,40 @@ class BaseSalesImpl extends _BaseModule.BaseModule {
     order: undefined
   };
   otherParams = {};
+  getInventory() {
+    return this.otherParams.inventory;
+  }
+  async prepareCheckout(signal) {
+    const inventory = this.getInventory();
+    const hooks = this.otherParams.checkoutHooks;
+    if (!inventory && !hooks?.beforeCheckout) return undefined;
+    if (!this.store.order) throw new Error('Order module is not ready');
+    return this.store.order.prepareCheckout(async items => {
+      const assertCurrent = () => {
+        if (signal?.aborted) throw Object.assign(new Error('Checkout cancelled'), {
+          name: 'AbortError'
+        });
+        if (inventory !== this.getInventory() || hooks !== this.otherParams.checkoutHooks) throw (0, _inventory.salesGuardError)('The sales context changed. Please try again.');
+      };
+      assertCurrent();
+      try {
+        await hooks?.beforeCheckout?.({
+          items,
+          signal
+        });
+        if (inventory) await inventory.refresh({
+          reason: 'checkout',
+          force: true,
+          signal
+        });
+        assertCurrent();
+        return inventory?.freezeCheckout(items);
+      } catch (error) {
+        if (error?.name === 'AbortError') throw error;
+        throw (0, _inventory.salesGuardError)(error instanceof Error ? error.message : String(error));
+      }
+    });
+  }
   cacheId;
   /**
    * 由已在初始化阶段解析过设备短号的业务解决方案写入。
@@ -1235,12 +1270,35 @@ class BaseSalesImpl extends _BaseModule.BaseModule {
     }
     return (0, _types2.createModule)(moduleName, this.name);
   }
+  inventoryOrderHooks;
   getSubModuleHooks(moduleName) {
     const optionHooks = this.initializeOptions.hooks || {};
     const otherHooks = this.otherParams.hooks || {};
     if (moduleName === 'order') {
       const directOrderHooks = optionHooks;
-      return optionHooks.order || this.otherParams.order?.hooks || otherHooks.order || (directOrderHooks.onBeforeMergeProductToOrder ? directOrderHooks : undefined);
+      const hooks = optionHooks.order || this.otherParams.order?.hooks || otherHooks.order || (directOrderHooks.onBeforeMergeProductToOrder || directOrderHooks.onBeforeCartCommit ? directOrderHooks : undefined);
+      const inventory = this.getInventory();
+      if (!inventory) {
+        this.inventoryOrderHooks = undefined;
+        return hooks;
+      }
+      if (this.inventoryOrderHooks?.inventory === inventory && this.inventoryOrderHooks.base === hooks) {
+        return this.inventoryOrderHooks.hooks;
+      }
+      const combined = {
+        ...hooks,
+        onBeforeCartCommit: async context => {
+          await hooks?.onBeforeCartCommit?.(context);
+          if (inventory !== this.getInventory()) throw (0, _inventory.salesGuardError)('The sales context changed. Please try again.');
+          inventory.validate(context.proposedItems, context.currentItems);
+        }
+      };
+      this.inventoryOrderHooks = {
+        inventory,
+        base: hooks,
+        hooks: combined
+      };
+      return combined;
     }
     return optionHooks[moduleName] || this.otherParams[moduleName]?.hooks || otherHooks[moduleName];
   }
@@ -1288,7 +1346,10 @@ class BaseSalesImpl extends _BaseModule.BaseModule {
       const nextSubModuleOtherParams = this.buildSubModuleOtherParams(moduleName);
       await targetModule.updateOtherParams(nextSubModuleOtherParams, {
         changedParams,
-        cover
+        cover,
+        ...(moduleName === 'order' ? {
+          hooks: this.getSubModuleHooks(moduleName)
+        } : {})
       });
     }));
   }
@@ -1437,7 +1498,17 @@ class BaseSalesImpl extends _BaseModule.BaseModule {
     }
     return isChanged;
   }
-  async initialize(core, options = {}) {
+  initialization;
+
+  /** Hosts can await readiness without changing Core's synchronous registration API. */
+  whenInitialized() {
+    return this.initialization || Promise.reject(new Error('Sales module is not registered'));
+  }
+  initialize(core, options = {}) {
+    this.initialization = this.initializeSalesRuntime(core, options);
+    return this.initialization;
+  }
+  async initializeSalesRuntime(core, options = {}) {
     this.core = core;
     this.initializeOptions = options || {};
     this.paymentNumberDevicePrefix = null;
@@ -1494,17 +1565,19 @@ class BaseSalesImpl extends _BaseModule.BaseModule {
     this.serverOrderChangeUnsubscribe = null;
     this.paymentMethodsChangedUnsubscribe?.();
     this.paymentMethodsChangedUnsubscribe = null;
-    Object.keys(this.store).forEach(key => {
-      if (this.reusedSharedSubModuleNames.has(key)) return;
+    for (const key of Object.keys(this.store)) {
+      if (this.reusedSharedSubModuleNames.has(key)) continue;
       const sub = this.store[key];
       if (sub && typeof sub.destroy === 'function') {
         try {
-          sub.destroy();
+          // A host may register a replacement after destroy resolves. Wait for
+          // nested modules so their cleanup cannot unregister the replacement.
+          await sub.destroy();
         } catch (error) {
           console.warn(`[BaseSales] 子模块 ${key} 销毁失败`, error);
         }
       }
-    });
+    }
     this.currentSalesDetail = null;
     this.paymentNumberDevicePrefix = null;
     this.queuedServerOrderChanges = [];
@@ -2218,10 +2291,10 @@ class BaseSalesImpl extends _BaseModule.BaseModule {
     }
     await discountModule.setDiscountList(params.discountList);
   }
-  async scanPromotionCode(code, customerId) {
+  async scanPromotionCode(code, customerId, options) {
     try {
       if (!this.store.order) throw new Error('order 模块未初始化');
-      const raw = await this.store.order.scanCode(code, customerId);
+      const raw = await this.store.order.scanCode(code, customerId, options);
       if (raw.isAvailable) {
         await this.store.order.recalculateSummary({
           createIfMissing: true
@@ -3884,6 +3957,13 @@ class BaseSalesImpl extends _BaseModule.BaseModule {
       });
     });
   }
+  setProductVoucherGroups(groups) {
+    if (!this.store.order) throw new Error('order 模块未初始化');
+    this.store.order.setProductVoucherGroups(groups);
+  }
+  validateProductVoucherSelection() {
+    this.store.order?.validateProductVoucherSelection();
+  }
   async addProductToOrder(product, booking, options) {
     try {
       if (!this.store.order) throw new Error('order 模块未初始化');

package/lib/solution/BookingTicket/index.js

@@ -30,6 +30,7 @@ var _handleScan = require("./utils/scan/handleScan");
 var _scanCache = _interopRequireDefault(require("./utils/scan/scanCache"));
 var _formatGlobalScan = require("./utils/scan/formatGlobalScan");
 var _applyGlobalScan = require("./utils/scan/applyGlobalScan");
+var _applyProductVoucherCollectionScan = require("./utils/scan/applyProductVoucherCollectionScan");
 var _cartView = require("./utils/cartView");
 var _addProductDecision = require("./utils/addProductDecision");
 var _buildCacheItemFromOrderLine = require("../../modules/BookingContext/utils/buildCacheItemFromOrderLine");
@@ -1672,6 +1673,20 @@ class BookingTicketImpl extends _BaseSales.BaseSalesImpl {
       };
     }
     try {
+      if (bridge?.scanScope === 'product-voucher') {
+        if (!bridge.applyPromotionCode) return {
+          status: 'failed',
+          reason: 'no_bridge'
+        };
+        const promotion = await bridge.applyPromotionCode(trimmed);
+        return promotion.isAccepted ?? promotion.isAvailable ? {
+          status: 'success',
+          kind: 'promotion'
+        } : {
+          status: 'failed',
+          reason: 'not_found'
+        };
+      }
       const localSearch = v => this.store.products.findProductsByCodeOrBarcode(v);
       const scanCallback = (0, _handleScan.handleGlobalScan)(this.request, localSearch, this.getSubmitOrderSalesChannel());
       const raw = await scanCallback({
@@ -1686,7 +1701,7 @@ class BookingTicketImpl extends _BaseSales.BaseSalesImpl {
           reason: 'not_found'
         };
       }
-      const result = await (0, _applyGlobalScan.applyGlobalScan)({
+      const host = {
         setOrderCustomer: customer => this.setOrderCustomer(customer),
         getOrderCustomerSnapshot: () => this.getOrderCustomerSnapshot(),
         resolveCustomerById: customerId => this.resolveCustomerById(customerId),
@@ -1698,10 +1713,29 @@ class BookingTicketImpl extends _BaseSales.BaseSalesImpl {
         addProductToOrder: (product, booking) => this.addProductToOrder(product, booking),
         refreshWalletAssets: params => this.refreshWalletAssets(params),
         scanWalletAsset: scanCode => this.scanWalletAsset(scanCode)
-      }, formatted, bridge);
+      };
+      const result = bridge?.scanScope === 'product-voucher-collection' ? await (0, _applyProductVoucherCollectionScan.applyProductVoucherCollectionScan)({
+        ...host,
+        waitForCustomerDiscounts: () => this.orderCustomerDiscountRefreshInFlight || Promise.resolve(),
+        loadCustomerDiscounts: async () => {
+          const customerId = Number(this.getOrderCustomer()?.customer_id || 0);
+          if (customerId <= 1) return [];
+          await this.refreshDiscountConfigAfterOrderCustomerChange(customerId);
+          return this.getDiscountList();
+        }
+      }, formatted, bridge) : await (0, _applyGlobalScan.applyGlobalScan)(host, formatted, bridge);
       bridge?.refresh?.();
       return result;
     } catch (error) {
+      if (bridge?.scanScope === 'product-voucher-collection') {
+        if (bridge.isCurrent?.() === false) return {
+          status: 'cancelled'
+        };
+        return {
+          status: 'failed',
+          reason: 'entry_resolution_failed'
+        };
+      }
       console.error('[BookingTicket] handleGlobalScanCode failed', error);
       bridge?.onNotify?.('fail', 'pisell2.text.scan-global-failed');
       return {

package/lib/solution/BookingTicket/types.d.ts

@@ -208,6 +208,10 @@ export interface AddAddTimeProductsToBookingInput {
 }
 /** 扫码宿主桥接：SalesSdk 在 pubsub 订阅回调里注入，OS 需要 UI 时直接调用 */
 export interface GlobalScanHostBridge {
+    /** product-voucher handles voucher codes only; product-voucher-collection also resolves wallet customer vouchers. */
+    scanScope?: 'all' | 'product-voucher' | 'product-voucher-collection';
+    /** A one-shot entry may outlive its page while requests are in flight. */
+    isCurrent?: () => boolean;
     openProductDetail?: (payload: Record<string, any>) => Promise<any | null>;
     openBookingEdit?: (payload: Record<string, any>) => Promise<any | null>;
     confirmDetail?: (input: {
@@ -232,11 +236,13 @@ export interface GlobalScanHostBridge {
      */
     applyPromotionCode?: (code: string, customerId?: number, options?: {
         suppressFailureNotification?: boolean;
+        productVouchersOnly?: boolean;
     }) => Promise<{
         isAvailable?: boolean;
         isAccepted?: boolean;
         type?: string;
         unavailableReason?: string;
+        scannedDiscountList?: Record<string, any>[];
     }>;
     /** 当前订单已有其他客户时，由宿主复用客户组件完成确认及切换。 */
     requestCustomerSwitch?: (customer: ICustomer) => Promise<boolean | null>;
@@ -244,7 +250,7 @@ export interface GlobalScanHostBridge {
     refresh?: () => void;
 }
 /** handleGlobalScanCode 结构化返回 */
-export type GlobalScanHandleResult = {
+export type GlobalScanHandleResult = ({
     status: 'success';
     kind: 'customer' | 'products' | 'promotion';
     meta?: {
@@ -257,5 +263,11 @@ export type GlobalScanHandleResult = {
     status: 'cancelled';
 } | {
     status: 'failed';
-    reason: 'empty_code' | 'not_found' | 'invalid_data' | 'no_bridge';
+    reason: 'empty_code' | 'not_found' | 'invalid_data' | 'no_bridge' | 'entry_resolution_failed';
+}) & {
+    /** product-voucher-collection returns voucher candidates; the caller decides how to use them. */
+    redemption?: {
+        source: 'wallet' | 'scan';
+        vouchers: Record<string, any>[];
+    };
 };

package/lib/solution/BookingTicket/utils/addProductDecision.d.ts

@@ -5,7 +5,7 @@ import type { OrderProduct, OrderProductIdentity, AddProductBookingInput } from
  * cart.addProduct 两阶段决策（与 ticketBooking `handleSelectProduct` 对齐）：
  *
  * 1. `requiresDetail`：规格 / SKU / 套餐 / Session / 称重弹窗（门禁：`isOpenDetailModal` / `cartDetailValue` / `open_sold_weight`）
- * 2. `requiresBookingEdit`：资源 / 时间编辑抽屉（kiosk 强制进入；其他渠道由 `getIsAutoClose` 决定）
+ * 2. `requiresBookingEdit`：资源 / 时间编辑抽屉（自助终端强制进入；其他渠道由 `getIsAutoClose` 决定）
  * 3. `add`：两关均通过，直接 transform + 加车
  */
 export type AddProductDecision = {

package/lib/solution/BookingTicket/utils/addProductDecision.js

@@ -17,12 +17,13 @@ var _dayjs = _interopRequireDefault(require("dayjs"));
 var _BookingContext = require("../../../modules/BookingContext");
 var _transformBaseProductToOrderProduct = require("../../BaseSales/utils/transformBaseProductToOrderProduct");
 var _weighingProductSku = require("./weighingProductSku");
+var _platform = require("../../../utils/platform");
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
 /**
  * cart.addProduct 两阶段决策（与 ticketBooking `handleSelectProduct` 对齐）：
  *
  * 1. `requiresDetail`：规格 / SKU / 套餐 / Session / 称重弹窗（门禁：`isOpenDetailModal` / `cartDetailValue` / `open_sold_weight`）
- * 2. `requiresBookingEdit`：资源 / 时间编辑抽屉（kiosk 强制进入；其他渠道由 `getIsAutoClose` 决定）
+ * 2. `requiresBookingEdit`：资源 / 时间编辑抽屉（自助终端强制进入；其他渠道由 `getIsAutoClose` 决定）
  * 3. `add`：两关均通过，直接 transform + 加车
  */
 
@@ -39,11 +40,11 @@ function needsSpecDetailModal(item) {
 }
 
 /**
- * 第二段：预约商品是否仍需打开资源 / 时间编辑（kiosk 强制打开，其他渠道与 info2 `cacheItem.autoClose` 等价）。
+ * 第二段：预约商品是否仍需打开资源 / 时间编辑（自助终端强制打开，其他渠道与 info2 `cacheItem.autoClose` 等价）。
  */
 function needsBookingEdit(cacheItem, ctx) {
   if (isNormalBookingProduct(cacheItem)) return false;
-  if (ctx?.channel === 'kiosk') return true;
+  if ((0, _platform.isSelfServicePlatform)(ctx?.channel)) return true;
   const isAutoAllocationOn = ctx?.isAutoAllocationOn || (() => true);
   return !(0, _BookingContext.getIsAutoClose)(cacheItem, isAutoAllocationOn);
 }

package/lib/solution/BookingTicket/utils/scan/applyGlobalScan.js

@@ -283,6 +283,18 @@ async function applyGlobalScan(host, formatted, bridge) {
     // batch-search 可能返回来源门店客户；先映射到当前门店，确保 Wallet
     // 支付资产查询使用本店客户上下文。
     const bindResult = await bindWalletPassCustomer();
+    // Voucher collection prioritizes goods coupons resolved from the wristband/order.
+    // Only this opt-in flow checks them before selecting a payment wallet asset.
+    const collectionPromotion = bridge?.scanScope === 'product-voucher-collection' && bridge.applyPromotionCode ? await bridge.applyPromotionCode(scanCode, getRealCustomerId(activeCustomer), {
+      suppressFailureNotification: true,
+      productVouchersOnly: true
+    }) : undefined;
+    if (collectionPromotion?.isAccepted ?? collectionPromotion?.isAvailable) {
+      return {
+        status: 'success',
+        kind: 'promotion'
+      };
+    }
     const walletSelection = await trySelectWalletAsset();
     if (walletSelection) return walletSelection;
     if (!bridge?.applyPromotionCode) {
@@ -292,9 +304,9 @@ async function applyGlobalScan(host, formatted, bridge) {
       };
     }
     const promotionCustomerId = getRealCustomerId(activeCustomer);
-    const promotionResult = bindResult.customerBound ? await bridge.applyPromotionCode(scanCode, promotionCustomerId, {
+    const promotionResult = collectionPromotion ?? (bindResult.customerBound ? await bridge.applyPromotionCode(scanCode, promotionCustomerId, {
       suppressFailureNotification: true
-    }) : await bridge.applyPromotionCode(scanCode, promotionCustomerId);
+    }) : await bridge.applyPromotionCode(scanCode, promotionCustomerId));
     if (promotionResult?.isAccepted ?? promotionResult?.isAvailable) {
       return {
         status: 'success',

package/lib/solution/BookingTicket/utils/scan/applyProductVoucherCollectionScan.d.ts

@@ -0,0 +1,10 @@
+import type { GlobalScanHandleResult, GlobalScanHostBridge } from '../../types';
+import { type GlobalScanApplyHost } from './applyGlobalScan';
+import type { GlobalScanFormattedResult } from './formatGlobalScan';
+export interface ProductVoucherCollectionScanHost extends GlobalScanApplyHost {
+    waitForCustomerDiscounts(): Promise<void>;
+    loadCustomerDiscounts(): Promise<Record<string, any>[]>;
+}
+/** Collect voucher candidates after customer binding and coupon loading finish.
+ * Never expand a wristband's result to other orders of the same customer. */
+export declare function applyProductVoucherCollectionScan(host: ProductVoucherCollectionScanHost, formatted: GlobalScanFormattedResult, bridge: GlobalScanHostBridge): Promise<GlobalScanHandleResult>;

package/lib/solution/BookingTicket/utils/scan/applyProductVoucherCollectionScan.js

@@ -0,0 +1,71 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.applyProductVoucherCollectionScan = applyProductVoucherCollectionScan;
+var _applyGlobalScan = require("./applyGlobalScan");
+/** Collect voucher candidates after customer binding and coupon loading finish.
+ * Never expand a wristband's result to other orders of the same customer. */
+async function applyProductVoucherCollectionScan(host, formatted, bridge) {
+  const assertCurrent = () => {
+    if (bridge.isCurrent?.() === false) {
+      throw new DOMException('Scan session ended', 'AbortError');
+    }
+  };
+  let vouchers = [];
+  assertCurrent();
+  const result = await (0, _applyGlobalScan.applyGlobalScan)({
+    ...host,
+    setOrderCustomer: customer => {
+      assertCurrent();
+      host.setOrderCustomer(customer);
+    },
+    addProductToOrder: (product, booking) => {
+      assertCurrent();
+      return host.addProductToOrder(product, booking);
+    }
+  }, formatted, {
+    ...bridge,
+    applyPromotionCode: bridge.applyPromotionCode && (async (code, customerId, options) => {
+      // Customer binding starts prepare/config in the background. Let it finish
+      // before adding scanned coupons so its response cannot overwrite them.
+      await host.waitForCustomerDiscounts();
+      assertCurrent();
+      const promotion = await bridge.applyPromotionCode(code, customerId, {
+        ...options,
+        productVouchersOnly: true,
+        suppressFailureNotification: true
+      });
+      assertCurrent();
+      // An empty successful search is different from a swallowed request error.
+      if (!Array.isArray(promotion.scannedDiscountList)) {
+        throw new Error('Could not resolve scanned vouchers');
+      }
+      vouchers = promotion.scannedDiscountList;
+      return promotion;
+    })
+  });
+  assertCurrent();
+  if (formatted.searchType === 'wallet' && result.status === 'success') {
+    vouchers = await host.loadCustomerDiscounts();
+    assertCurrent();
+    return {
+      ...result,
+      redemption: {
+        source: 'wallet',
+        vouchers
+      }
+    };
+  }
+  if (formatted.searchType === 'walletPass') {
+    return {
+      ...result,
+      redemption: {
+        source: 'scan',
+        vouchers
+      }
+    };
+  }
+  return result;
+}

package/lib/solution/BookingTicket/utils/scan/cloudSearch.js

@@ -10,6 +10,7 @@ exports.searchWalletPass = exports.searchWallet = exports.searchProduct = export
 const searchWalletPass = async (request, code) => {
   const params = {
     code,
+    resolve_ticket_order: 1,
     translate_flag: 1,
     // 翻译识别码名称 0:不翻译 1:翻译
     relation_product: 1,

package/lib/solution/BookingTicket/utils/scan/handleScan.js

@@ -6,6 +6,7 @@ Object.defineProperty(exports, "__esModule", {
 exports.handleUniversalScan = exports.handleGlobalScan = exports.handleCustomerScan = void 0;
 var _cloudSearch = require("./cloudSearch");
 var _scanCache = _interopRequireDefault(require("./scanCache"));
+var _platform = require("../../../../utils/platform");
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
 /**
  * Promise.any 的替代实现
@@ -107,7 +108,7 @@ const handleGlobalScan = (request, localSearch, channel) => {
     if (value.startsWith('WL')) {
       requestList = [(0, _cloudSearch.searchWallet)(request, value)];
     } else {
-      requestList = [...(channel === 'kiosk' ? [] : [(0, _cloudSearch.searchOrder)(request, value)]), (0, _cloudSearch.searchWalletPass)(request, value), (0, _cloudSearch.searchWallet)(request, value), (0, _cloudSearch.searchProduct)(request, value)];
+      requestList = [...((0, _platform.isSelfServicePlatform)(channel) ? [] : [(0, _cloudSearch.searchOrder)(request, value)]), (0, _cloudSearch.searchWalletPass)(request, value), (0, _cloudSearch.searchWallet)(request, value), (0, _cloudSearch.searchProduct)(request, value)];
     }
     return requestList;
   };

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

@@ -127,7 +127,7 @@ export declare class UnifiedBookingSalesImpl extends BookingTicket {
      */
     clearSessionStorageOrderSnapshot(): void;
     /**
-     * PC/H5/Kiosk 结账默认直接等待云端 checkout；POS/WebPOS 仍保持本地待同步。
+     * PC/H5 及自助终端结账默认直接等待云端 checkout；POS/WebPOS 仍保持本地待同步。
      * 显式传 checkoutSyncTaskEnabled: true 时仍可回退到本地同步模式。
      */
     protected shouldUseCheckoutSyncTask(): boolean;

package/lib/solution/UnifiedBookingSales/index.js

@@ -1366,11 +1366,16 @@ class UnifiedBookingSalesImpl extends _BookingTicket.BookingTicket {
     cover = false
   } = {}) {
     const previousScope = this.getAvailabilityScopeDescriptor(this.otherParams || {});
+    const previousCatalogScope = this.otherParams?.catalogScopeKey;
     const previousItemRuleConfig = this.otherParams?.itemRule;
     const explicitlySetsOpenData = Object.prototype.hasOwnProperty.call(params, 'openData');
     await super.setOtherParams(params, {
       cover
     });
+    if (previousCatalogScope !== this.otherParams?.catalogScopeKey && (previousCatalogScope || this.otherParams?.catalogScopeKey)) {
+      this.unifiedProductCatalog = [];
+      await this.core.effects.emit(`${this.name}:onProductsLoaded`, []);
+    }
     const nextScope = this.getAvailabilityScopeDescriptor(this.otherParams || {});
     if (explicitlySetsOpenData) {
       this.openDataTarget = this.otherParams?.openData && nextScope.businessCode && nextScope.channel ? `${nextScope.businessCode}+${nextScope.channel}` : null;
@@ -1580,14 +1585,14 @@ class UnifiedBookingSalesImpl extends _BookingTicket.BookingTicket {
   }
 
   /**
-   * PC/H5/Kiosk 结账默认直接等待云端 checkout；POS/WebPOS 仍保持本地待同步。
+   * PC/H5 及自助终端结账默认直接等待云端 checkout；POS/WebPOS 仍保持本地待同步。
    * 显式传 checkoutSyncTaskEnabled: true 时仍可回退到本地同步模式。
    */
   shouldUseCheckoutSyncTask() {
     const configured = this.otherParams?.checkoutSyncTaskEnabled;
     if (configured === true) return true;
     const platform = (0, _platform.normalizeRuntimePlatform)(this.otherParams?.platform);
-    return !(0, _platform.isCustomerUserPlatform)(platform) && platform !== 'kiosk';
+    return !(0, _platform.isCustomerUserPlatform)(platform) && !(0, _platform.isSelfServicePlatform)(platform);
   }
 
   /** UnifiedBookingSales 的真实结账默认请求收据数据，供云端确认后再本地打印。 */
@@ -1874,7 +1879,7 @@ class UnifiedBookingSalesImpl extends _BookingTicket.BookingTicket {
       throw new Error('[UnifiedBookingSales] getProtocol 需要 policyId');
     }
     let policyUrl = 'shop-policy';
-    if (this.otherParams.platform === 'kiosk' || this.otherParams.platform === 'pos' || this.otherParams.platform === 'shop') {
+    if ((0, _platform.isSelfServicePlatform)(this.otherParams.platform) || this.otherParams.platform === 'pos' || this.otherParams.platform === 'shop') {
       policyUrl = 'policy';
     }
     return this.request.get(`/${policyUrl}/${encodeURIComponent(normalizedPolicyId)}`);
@@ -1886,6 +1891,7 @@ class UnifiedBookingSalesImpl extends _BookingTicket.BookingTicket {
    */
   async loadProducts(params = {}, options) {
     if (!this.store.products) throw new Error('[UnifiedBookingSales] products 模块未初始化');
+    const catalogScope = this.otherParams.catalogScopeKey;
     const schedule_date = params.schedule_date || (0, _dayjs.default)().format('YYYY-MM-DD');
     const schedule_datetime = params.schedule_datetime || `${schedule_date} ${(0, _dayjs.default)().format('HH:mm:ss')}`;
     const result = await this.store.products.loadProducts({
@@ -1896,6 +1902,11 @@ class UnifiedBookingSalesImpl extends _BookingTicket.BookingTicket {
       schedule_datetime,
       cacheId: this.cacheId
     }, options);
+    if (catalogScope !== this.otherParams.catalogScopeKey) {
+      throw Object.assign(new Error('Product scope changed'), {
+        name: 'AbortError'
+      });
+    }
     this.unifiedProductCatalog = Array.isArray(result) ? [...result] : [];
     await this.core.effects.emit(`${this.name}:onProductsLoaded`, result);
     return result;

package/lib/utils/platform.d.ts

@@ -6,3 +6,5 @@ export declare function normalizeRuntimePlatform(platform: unknown): string;
  * PC and H5 are authenticated-customer clients rather than staff terminals.
  */
 export declare function isCustomerUserPlatform(platform: unknown): boolean;
+/** Kiosk and vending retain distinct channels but share self-service checkout behavior. */
+export declare function isSelfServicePlatform(platform: unknown): boolean;

package/lib/utils/platform.js

@@ -4,8 +4,10 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.isCustomerUserPlatform = isCustomerUserPlatform;
+exports.isSelfServicePlatform = isSelfServicePlatform;
 exports.normalizeRuntimePlatform = normalizeRuntimePlatform;
 const CUSTOMER_USER_PLATFORMS = new Set(['pc', 'h5']);
+const SELF_SERVICE_PLATFORMS = new Set(['kiosk', 'vending']);
 
 /**
  * Normalize the runtime platform passed through solution/module otherParams.
@@ -19,4 +21,9 @@ function normalizeRuntimePlatform(platform) {
  */
 function isCustomerUserPlatform(platform) {
   return CUSTOMER_USER_PLATFORMS.has(normalizeRuntimePlatform(platform));
+}
+
+/** Kiosk and vending retain distinct channels but share self-service checkout behavior. */
+function isSelfServicePlatform(platform) {
+  return SELF_SERVICE_PLATFORMS.has(normalizeRuntimePlatform(platform));
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "private": false,
   "name": "@pisell/pisellos",
-  "version": "2.2.311",
+  "version": "2.2.312-vm.0",
   "description": "一个可扩展的前端模块化SDK框架，支持插件系统",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -68,6 +68,8 @@
     "node": ">=18.0.0"
   },
   "publishConfig": {
-    "access": "public"
+    "access": "public",
+    "registry": "https://registry.npmjs.org/",
+    "tag": "vm"
   }
 }