@pisell/pisellos 0.10.69 → 0.10.70

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

@@ -208,8 +208,10 @@ export interface AddAddTimeProductsToBookingInput {
 }
 /** 扫码宿主桥接：SalesSdk 在 pubsub 订阅回调里注入，OS 需要 UI 时直接调用 */
 export interface GlobalScanHostBridge {
-    /** Restrict redemption scans before customer/product side effects. */
-    scanScope?: 'all' | 'product-voucher';
+    /** 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: {
@@ -234,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>;
@@ -246,7 +250,7 @@ export interface GlobalScanHostBridge {
     refresh?: () => void;
 }
 /** handleGlobalScanCode 结构化返回 */
-export type GlobalScanHandleResult = {
+export type GlobalScanHandleResult = ({
     status: 'success';
     kind: 'customer' | 'products' | 'promotion';
     meta?: {
@@ -259,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/scan/applyGlobalScan.js

@@ -289,6 +289,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) {
@@ -298,9 +310,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/package.json

@@ -1,7 +1,7 @@
 {
   "private": false,
   "name": "@pisell/pisellos",
-  "version": "0.10.69",
+  "version": "0.10.70",
   "description": "一个可扩展的前端模块化SDK框架，支持插件系统",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",