@pisell/pisellos 0.0.233 → 0.0.235

package/dist/solution/Checkout/types.d.ts

@@ -389,7 +389,9 @@ export declare enum CheckoutHooks {
     /** 订单备注变更 */
     OnOrderNoteChanged = "checkout:onOrderNoteChanged",
     /** 商店折扣变更 */
-    OnShopDiscountChanged = "checkout:onShopDiscountChanged"
+    OnShopDiscountChanged = "checkout:onShopDiscountChanged",
+    /** 订单取消 */
+    OnOrderCancelled = "checkout:onOrderCancelled"
 }
 /**
  * 结账状态数据
@@ -610,11 +612,12 @@ export interface CheckoutModuleAPI extends Module {
         orderUuid?: string;
     }>;
     /**
-     * 检查订单是否需要手动同步
+     * 检查订单是否需要手动同步（异步版本）
      *
      * 返回订单是否为纯代金券支付且待付金额<=0但未同步的状态
+     * 从 Payment 模块获取最新的支付项数据
      */
-    needsManualSync(): boolean;
+    needsManualSyncAsync(): Promise<boolean>;
     /**
      * 更新订单备注
      *
@@ -633,6 +636,25 @@ export interface CheckoutModuleAPI extends Module {
      * @returns 当前订单的ID，如果没有订单则返回null
      */
     getCurrentOrderId(): string | null;
+    /**
+     * 获取当前订单是否已同步到后端
+     *
+     * @returns 当前订单是否已同步状态，如果没有订单则返回false
+     */
+    isCurrentOrderSynced(): boolean;
+    /**
+     * 取消当前本地订单
+     *
+     * 只能取消未同步到后端的本地订单，如果订单已同步则不能取消
+     *
+     * @param cancelReason 取消原因（可选）
+     * @returns 取消结果
+     */
+    cancelCurrentOrderAsync(cancelReason?: string): Promise<{
+        success: boolean;
+        message?: string;
+        orderId?: string;
+    }>;
     /**
      * 更新订单商店折扣
      *
@@ -675,6 +697,42 @@ export interface CheckoutModuleAPI extends Module {
         message?: string;
         orderId?: string | number;
     }>;
+    /**
+     * 发送客户支付链接邮件
+     *
+     * 向指定邮箱发送订单支付提醒邮件
+     *
+     * @param params 发送参数
+     * @returns 发送结果
+     */
+    sendCustomerPayLinkAsync(params: SendCustomerPayLinkParams): Promise<{
+        success: boolean;
+        message?: string;
+    }>;
+    /**
+     * 金额舍入
+     *
+     * 根据系统配置的舍入设置对金额进行舍入处理
+     *
+     * @param amount 原始金额
+     * @returns 舍入结果详情，包含原始金额、舍入后金额和舍入差额
+     */
+    roundAmountAsync(amount: number): Promise<{
+        originalAmount: string;
+        roundedAmount: string;
+        roundingDifference: string;
+    }>;
+}
+/**
+ * 发送客户支付链接参数
+ */
+export interface SendCustomerPayLinkParams {
+    /** 订单ID列表 */
+    order_ids: string[];
+    /** 通知动作，固定为订单支付提醒 */
+    notify_action?: string;
+    /** 邮箱地址列表 */
+    emails: string[];
 }
 /**
  * 结账事件数据类型
@@ -748,4 +806,12 @@ export interface CheckoutEventData {
         newDiscount: number;
         timestamp: number;
     };
+    /** 订单取消事件 */
+    orderCancelled: {
+        orderUuid?: string;
+        orderId?: string;
+        cancelReason?: string;
+        wasSynced: boolean;
+        timestamp: number;
+    };
 }

package/dist/solution/Checkout/types.js

@@ -117,6 +117,7 @@ export var CheckoutHooks = /*#__PURE__*/function (CheckoutHooks) {
   CheckoutHooks["OnOrderSynced"] = "checkout:onOrderSynced";
   CheckoutHooks["OnOrderNoteChanged"] = "checkout:onOrderNoteChanged";
   CheckoutHooks["OnShopDiscountChanged"] = "checkout:onShopDiscountChanged";
+  CheckoutHooks["OnOrderCancelled"] = "checkout:onOrderCancelled";
   return CheckoutHooks;
 }({});
 
@@ -132,6 +133,10 @@ export var CheckoutHooks = /*#__PURE__*/function (CheckoutHooks) {
  * 结账解决方案 API 接口
  */
 
+/**
+ * 发送客户支付链接参数
+ */
+
 /**
  * 结账事件数据类型
  */

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

@@ -11,7 +11,7 @@ export declare class OrderModule extends BaseModule implements Module, OrderModu
     initialize(core: PisellCore, options: ModuleOptions): Promise<void>;
     createOrder(params: CommitOrderParams['query']): {
         type: "virtual" | "appointment_booking";
-        platform: "pc" | "h5";
+        platform: string;
         sales_channel: string;
         order_sales_channel: string;
         bookings: any[];

package/lib/modules/Order/index.js

@@ -41,7 +41,7 @@ var OrderModule = class extends import_BaseModule.BaseModule {
     const order = {
       type: (params == null ? void 0 : params.type) || "appointment_booking",
       // 要从外面拿，virtual
-      platform: (params == null ? void 0 : params.platform) || "pc",
+      platform: (params == null ? void 0 : params.platform) === "pc" ? "PC" : "H5",
       sales_channel: "my_pisel",
       order_sales_channel: "online_store",
       bookings: [],

package/lib/modules/Payment/index.d.ts

@@ -1,7 +1,7 @@
 import { Module, PisellCore, ModuleOptions } from '../../types';
 import { RequestPlugin } from '../../plugins';
 import { BaseModule } from '../BaseModule';
-import { PaymentModuleAPI, PaymentMethod, PaymentOrder, PaymentItem, PaymentItemInput, PaymentUpdateFields, PushOrderParams, CashPayment, EftposPayment, WalletPassPayment, RoundingRule, RoundingInterval } from './types';
+import { PaymentModuleAPI, PaymentMethod, PaymentOrder, PaymentItem, PaymentItemInput, PaymentUpdateFields, PushOrderParams, CashPayment, EftposPayment, WalletPassPayment, RoundingRule, RoundingInterval, RoundingResult } from './types';
 export * from './types';
 export { generateRequestUniqueId };
 /**
@@ -176,9 +176,9 @@ export declare class PaymentModule extends BaseModule implements Module, Payment
      * @param originalAmount 原始金额
      * @param interval 舍入间隔 (0.05, 0.1, 0.5, 1)
      * @param rule 舍入规则 (standard, standard_down, always_up, always_down)
-     * @returns 舍入后的金额（保留两位小数的字符串）
+     * @returns 舍入结果详情（包含原始金额、舍入后金额和舍入差额）
      */
-    roundAmountAsync(originalAmount: number | string, interval: RoundingInterval | number, rule: RoundingRule | string): Promise<string>;
+    roundAmountAsync(originalAmount: number | string, interval: RoundingInterval | number, rule: RoundingRule | string): Promise<RoundingResult>;
     /**
      * 标准舍入处理（处理中点情况）
      *

package/lib/modules/Payment/index.js

@@ -257,7 +257,25 @@ var PaymentModule = class extends import_BaseModule.BaseModule {
       if (!oldMethod) {
         return true;
       }
-      if (oldMethod.code !== newMethod.code || oldMethod.name !== newMethod.name || oldMethod.type !== newMethod.type || oldMethod.enabled !== newMethod.enabled) {
+      if (oldMethod.code !== newMethod.code || oldMethod.name !== newMethod.name || oldMethod.type !== newMethod.type || oldMethod.description !== newMethod.description || oldMethod.status !== newMethod.status || oldMethod.disable !== newMethod.disable || oldMethod.is_surcharge !== newMethod.is_surcharge || oldMethod.fixed !== newMethod.fixed || oldMethod.percentage !== newMethod.percentage || oldMethod.enabled !== newMethod.enabled || JSON.stringify(oldMethod.channel_application || []) !== JSON.stringify(newMethod.channel_application || []) || JSON.stringify(oldMethod.companies || []) !== JSON.stringify(newMethod.companies || []) || JSON.stringify(oldMethod.metadata || {}) !== JSON.stringify(newMethod.metadata || {})) {
+        console.log(`[PaymentModule] 支付方式 ${newMethod.id} (${newMethod.code}) 发生变化:`, {
+          id: newMethod.id,
+          changes: {
+            code: oldMethod.code !== newMethod.code ? { old: oldMethod.code, new: newMethod.code } : void 0,
+            name: oldMethod.name !== newMethod.name ? { old: oldMethod.name, new: newMethod.name } : void 0,
+            type: oldMethod.type !== newMethod.type ? { old: oldMethod.type, new: newMethod.type } : void 0,
+            description: oldMethod.description !== newMethod.description ? { old: oldMethod.description, new: newMethod.description } : void 0,
+            status: oldMethod.status !== newMethod.status ? { old: oldMethod.status, new: newMethod.status } : void 0,
+            disable: oldMethod.disable !== newMethod.disable ? { old: oldMethod.disable, new: newMethod.disable } : void 0,
+            is_surcharge: oldMethod.is_surcharge !== newMethod.is_surcharge ? { old: oldMethod.is_surcharge, new: newMethod.is_surcharge } : void 0,
+            fixed: oldMethod.fixed !== newMethod.fixed ? { old: oldMethod.fixed, new: newMethod.fixed } : void 0,
+            percentage: oldMethod.percentage !== newMethod.percentage ? { old: oldMethod.percentage, new: newMethod.percentage } : void 0,
+            enabled: oldMethod.enabled !== newMethod.enabled ? { old: oldMethod.enabled, new: newMethod.enabled } : void 0,
+            channel_application: JSON.stringify(oldMethod.channel_application || []) !== JSON.stringify(newMethod.channel_application || []) ? { old: oldMethod.channel_application, new: newMethod.channel_application } : void 0,
+            companies: JSON.stringify(oldMethod.companies || []) !== JSON.stringify(newMethod.companies || []) ? { old: oldMethod.companies, new: newMethod.companies } : void 0,
+            metadata: JSON.stringify(oldMethod.metadata || {}) !== JSON.stringify(newMethod.metadata || {}) ? { old: oldMethod.metadata, new: newMethod.metadata } : void 0
+          }
+        });
         return true;
       }
     }
@@ -948,7 +966,7 @@ var PaymentModule = class extends import_BaseModule.BaseModule {
    * @param originalAmount 原始金额
    * @param interval 舍入间隔 (0.05, 0.1, 0.5, 1)
    * @param rule 舍入规则 (standard, standard_down, always_up, always_down)
-   * @returns 舍入后的金额（保留两位小数的字符串）
+   * @returns 舍入结果详情（包含原始金额、舍入后金额和舍入差额）
    */
   async roundAmountAsync(originalAmount, interval, rule) {
     try {
@@ -986,9 +1004,16 @@ var PaymentModule = class extends import_BaseModule.BaseModule {
           throw new Error(`不支持的舍入规则: ${rule}`);
       }
       const finalAmount = roundedValue.mul(roundingInterval);
-      const result = finalAmount.toFixed(2);
-      console.log(`[PaymentModule] 舍入结果 - 舍入值: ${roundedValue.toString()}, 最终金额: ${result}`);
-      return result;
+      const roundedAmountStr = finalAmount.toFixed(2);
+      const originalAmountStr = amount.toFixed(2);
+      const roundingDifference = finalAmount.sub(amount);
+      const roundingDifferenceStr = roundingDifference.toFixed(2);
+      console.log(`[PaymentModule] 舍入结果 - 原始金额: ${originalAmountStr}, 舍入后金额: ${roundedAmountStr}, 舍入差额: ${roundingDifferenceStr}`);
+      return {
+        originalAmount: originalAmountStr,
+        roundedAmount: roundedAmountStr,
+        roundingDifference: roundingDifferenceStr
+      };
     } catch (error) {
       console.error("[PaymentModule] 金额舍入失败:", error);
       throw new Error(`金额舍入失败: ${error instanceof Error ? error.message : String(error)}`);

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

@@ -36,7 +36,7 @@ export declare enum TaskRunStatus {
  */
 export declare enum RoundingRule {
     /** 标准舍入（中点向上） */
-    Standard = "standard",
+    Standard = "standard_rounding",
     /** 标准舍入（中点向下） */
     StandardDown = "standard_down",
     /** 总是向上舍入 */
@@ -44,6 +44,17 @@ export declare enum RoundingRule {
     /** 总是向下舍入 */
     AlwaysDown = "always_down"
 }
+/**
+ * 舍入结果
+ */
+export interface RoundingResult {
+    /** 原始金额 */
+    originalAmount: string;
+    /** 舍入后的金额 */
+    roundedAmount: string;
+    /** 舍入差额（舍入后金额 - 原始金额） */
+    roundingDifference: string;
+}
 /**
  * 舍入间隔枚举
  */
@@ -306,7 +317,7 @@ export interface WalletPassPayment {
     /** 查询用户识别码列表（异步获取并缓存） */
     getUserIdentificationCodeListAsync: (params: UserIdentificationCodeParams) => Promise<UserIdentificationCodeItem[]>;
     /** 搜索识别码信息 */
-    searchIdentificationCodeAsync: (params: SearchIdentificationCodeParams) => Promise<SearchIdentificationCodeItem[]>;
+    searchIdentificationCodeAsync: (params: SearchIdentificationCodeParams) => Promise<SearchIdentificationCodeResult>;
     /** 获取缓存的搜索结果列表 */
     getSearchResults: () => SearchIdentificationCodeItem[];
     /** 根据识别码查找搜索结果 */
@@ -371,7 +382,7 @@ export interface PaymentModuleAPI {
      * @param rule 舍入规则 (standard, standard_down, always_up, always_down)
      * @returns 舍入后的金额
      */
-    roundAmountAsync: (originalAmount: number | string, interval: RoundingInterval | number, rule: RoundingRule | string) => Promise<string>;
+    roundAmountAsync: (originalAmount: number | string, interval: RoundingInterval | number, rule: RoundingRule | string) => Promise<RoundingResult>;
     /** 提交支付 */
     submitPayAsync: (orderUuid?: string) => Promise<{
         status: 'success' | 'failed';
@@ -636,6 +647,16 @@ export interface SearchIdentificationCodeResponse {
     /** 响应数据 */
     data?: SearchIdentificationCodeItem[];
 }
+/**
+ * 搜索识别码结果类型
+ */
+export type SearchIdentificationCodeResult = {
+    type: 'walletCode';
+    data: SearchIdentificationCodeItem[];
+} | {
+    type: 'normalCode';
+    data: SearchIdentificationCodeItem[];
+};
 /**
  * 搜索识别码项目
  */

package/lib/modules/Payment/types.js

@@ -49,7 +49,7 @@ var TaskRunStatus = /* @__PURE__ */ ((TaskRunStatus2) => {
   return TaskRunStatus2;
 })(TaskRunStatus || {});
 var RoundingRule = /* @__PURE__ */ ((RoundingRule2) => {
-  RoundingRule2["Standard"] = "standard";
+  RoundingRule2["Standard"] = "standard_rounding";
   RoundingRule2["StandardDown"] = "standard_down";
   RoundingRule2["AlwaysUp"] = "always_up";
   RoundingRule2["AlwaysDown"] = "always_down";

package/lib/modules/Payment/utils.js

@@ -31,7 +31,7 @@ var formatWalletPassList2PreparePayments = (list) => {
   return (list || []).map((item) => {
     return {
       voucher_id: item.id || 0,
-      amount: Number(getAvailableMaxAmount(item)) || 0,
+      amount: Number(item.edit_current_amount || getAvailableMaxAmount(item)) || 0,
       tag: item.tag || ""
     };
   });

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

@@ -1,4 +1,4 @@
-import { WalletPassPayment, WalletDeductionRecommendParams, WalletRecommendItem, UserIdentificationCodeParams, UserIdentificationCodeItem, SearchIdentificationCodeParams, SearchIdentificationCodeItem, WalletInitBusinessData } from './types';
+import { WalletPassPayment, WalletDeductionRecommendParams, WalletRecommendItem, UserIdentificationCodeParams, UserIdentificationCodeItem, SearchIdentificationCodeParams, SearchIdentificationCodeItem, SearchIdentificationCodeResult, WalletInitBusinessData } from './types';
 import type { PaymentModule } from './index';
 /**
  * 钱包支付实现
@@ -57,8 +57,11 @@ export declare class WalletPassPaymentImpl implements WalletPassPayment {
      * 搜索识别码信息
      * 通过识别码搜索相关的钱包通行证信息
      * 基于 WalletDeductionRecommendParams 参数结构
+     * 特殊逻辑：当识别码长度为9位且前3位为"000"时，调用 /wallet/detail/search 接口
      */
-    searchIdentificationCodeAsync(params: SearchIdentificationCodeParams): Promise<SearchIdentificationCodeItem[]>;
+    searchIdentificationCodeAsync(params: SearchIdentificationCodeParams, config?: {
+        noCache?: boolean;
+    }): Promise<SearchIdentificationCodeResult>;
     processWalletPayment(amount: number, orderUuid: string, voucherId?: string): Promise<void>;
     getWalletBalance(voucherId: string): Promise<number>;
     /**

package/lib/modules/Payment/walletpass.js

@@ -175,9 +175,28 @@ var WalletPassPaymentImpl = class {
    * 搜索识别码信息
    * 通过识别码搜索相关的钱包通行证信息
    * 基于 WalletDeductionRecommendParams 参数结构
+   * 特殊逻辑：当识别码长度为9位且前3位为"000"时，调用 /wallet/detail/search 接口
    */
-  async searchIdentificationCodeAsync(params) {
+  async searchIdentificationCodeAsync(params, config = {}) {
     try {
+      const { code } = params;
+      const isWalletCode = code.startsWith("WL");
+      if (isWalletCode) {
+        const walletDetailParams = {
+          code,
+          with_customer: 1,
+          with: ["latestWalletDetail.wallet"]
+        };
+        const response2 = await this.paymentModule.request.post(
+          "/wallet/detail/search",
+          walletDetailParams
+        );
+        const searchResults2 = (response2 == null ? void 0 : response2.data) || [];
+        return {
+          type: "walletCode",
+          data: searchResults2
+        };
+      }
       const baseWalletParams = this.walletParams;
       const searchParams = {
         // 基础钱包参数
@@ -198,6 +217,12 @@ var WalletPassPaymentImpl = class {
         searchParams
       );
       const searchResults = (response == null ? void 0 : response.data) || [];
+      if (config.noCache) {
+        return {
+          type: "normalCode",
+          data: searchResults
+        };
+      }
       if (searchResults.length > 0) {
         const existingCodes = new Set(
           this.searchResults.map((item) => item.code)
@@ -213,7 +238,10 @@ var WalletPassPaymentImpl = class {
         cachedSearchResults: [...this.searchResults],
         searchParams: params
       });
-      return searchResults;
+      return {
+        type: "normalCode",
+        data: searchResults
+      };
     } catch (error) {
       console.error("[WalletPass] 搜索识别码信息失败:", error);
       throw error;

package/lib/solution/BookingByStep/utils/timeslots.js

@@ -79,7 +79,7 @@ function findFastestAvailableResource({
   currentCapacity = 1,
   countMap = {}
 }) {
-  var _a, _b;
+  var _a, _b, _c;
   const currentTime = (0, import_dayjs.default)();
   let fastestTime = null;
   let fastestResources = [];
@@ -168,8 +168,43 @@ function findFastestAvailableResource({
     console.log(`[TimeslotUtils] 返回唯一最快资源: ${fastestResources[0].main_field}`);
     return fastestResources[0];
   }
-  const selectedResource = fastestResources[0];
-  console.log(`[TimeslotUtils] 返回多个资源中的第一个: ${selectedResource.main_field}`);
+  let selectedResource = fastestResources[0];
+  let maxIdleTime = 0;
+  console.log(`[TimeslotUtils] 比较 ${fastestResources.length} 个资源的空闲时间:`);
+  for (const resource of fastestResources) {
+    const workingTime = resource.times.find((time) => {
+      const isToday = (0, import_dayjs.default)(time.start_at).isSame(fastestTime, "day");
+      const isStillWorking = (0, import_dayjs.default)(time.end_at).isAfter(fastestTime);
+      return isToday && isStillWorking;
+    });
+    if (!workingTime)
+      continue;
+    const workEndTime = (0, import_dayjs.default)(workingTime.end_at);
+    let totalIdleTime = workEndTime.diff(fastestTime, "minute");
+    const relevantEvents = ((_c = workingTime.event_list) == null ? void 0 : _c.filter((event) => {
+      const eventStart = (0, import_dayjs.default)(event.start_at);
+      const eventEnd = (0, import_dayjs.default)(event.end_at);
+      return eventEnd.isAfter(fastestTime) && eventStart.isAfter(fastestTime);
+    })) || [];
+    for (const event of relevantEvents) {
+      const eventStart = (0, import_dayjs.default)(event.start_at);
+      const eventEnd = (0, import_dayjs.default)(event.end_at);
+      const eventDuration = eventEnd.diff(eventStart, "minute");
+      totalIdleTime -= eventDuration;
+    }
+    console.log(`[TimeslotUtils] 资源 ${resource.id}(${resource.main_field}):`, {
+      工作结束时间: workEndTime.format("HH:mm"),
+      总工作时长: workEndTime.diff(fastestTime, "minute") + "分钟",
+      预约占用时长: workEndTime.diff(fastestTime, "minute") - totalIdleTime + "分钟",
+      实际空闲时长: totalIdleTime + "分钟"
+    });
+    if (totalIdleTime > maxIdleTime) {
+      maxIdleTime = totalIdleTime;
+      selectedResource = resource;
+      console.log(`[TimeslotUtils] 更新最佳选择: ${resource.main_field} (空闲${totalIdleTime}分钟)`);
+    }
+  }
+  console.log(`[TimeslotUtils] 最终选择资源: ${selectedResource.main_field} (最长空闲${maxIdleTime}分钟)`);
   return selectedResource;
 }
 function filterConditionTimeSlots(times, startTime, endTime) {

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

@@ -131,6 +131,14 @@ export declare class BookingTicketImpl extends BaseModule implements Module {
     scanCustomerListener(callback: (data: IScanResult) => void): {
         remove: () => void;
     };
+    /**
+     * @title 通用扫描监听
+     * @description 直接将扫描结果返回给调用方
+     * @param callback 回调
+     */
+    scanUniversalListener(callback: (data: IScanResult) => void, key: string): {
+        remove: () => void;
+    };
     /**
      * 调用摄像头
      * @param data 用户自定义数据

package/lib/solution/BookingTicket/index.js

@@ -302,7 +302,7 @@ var BookingTicketImpl = class extends import_BaseModule.BaseModule {
       try {
         callback(d);
       } catch (error) {
-        console.error("scanGlobalListener回掉函数异常", error);
+        console.error("scanGlobalListener传入的回调函数异常", error);
       }
     };
     const listener = { key: "global", callback: safeCallback };
@@ -319,13 +319,34 @@ var BookingTicketImpl = class extends import_BaseModule.BaseModule {
       try {
         callback(d);
       } catch (error) {
-        console.error("scanCustomerListener回掉函数异常", error);
+        console.error("scanCustomerListener传入的回调函数异常", error);
       }
     };
     const listener = { key: "customer", callback: safeCallback };
     const removeListener = this.scan.addListener(listener, scanCallback);
     return removeListener;
   }
+  /**
+   * @title 通用扫描监听
+   * @description 直接将扫描结果返回给调用方
+   * @param callback 回调
+   */
+  scanUniversalListener(callback, key) {
+    const scanCallback = (0, import_handleScan.handleUniversalScan)();
+    const safeCallback = (d) => {
+      try {
+        callback(d);
+      } catch (error) {
+        console.error(
+          `scanUniversalListener传入的回调函数异常, key: ${key}`,
+          error
+        );
+      }
+    };
+    const listener = { key, callback: safeCallback };
+    const removeListener = this.scan.addListener(listener, scanCallback);
+    return removeListener;
+  }
   /**
    * 调用摄像头
    * @param data 用户自定义数据

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

@@ -14,3 +14,9 @@ export declare const handleGlobalScan: (request: RequestPlugin, localSearch: (v:
  * @returns 处理结果
  */
 export declare const handleCustomerScan: () => () => Promise<{}>;
+/**
+ * 处理钱包扫码
+ * @param request 请求插件
+ * @returns 处理结果
+ */
+export declare const handleUniversalScan: () => () => Promise<{}>;

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

@@ -30,7 +30,8 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var handleScan_exports = {};
 __export(handleScan_exports, {
   handleCustomerScan: () => handleCustomerScan,
-  handleGlobalScan: () => handleGlobalScan
+  handleGlobalScan: () => handleGlobalScan,
+  handleUniversalScan: () => handleUniversalScan
 });
 module.exports = __toCommonJS(handleScan_exports);
 var import_cloudSearch = require("./cloudSearch");
@@ -61,19 +62,21 @@ var promiseAny = async (promises) => {
 var handleScanFn = (getRequestList, localSearch) => {
   return async (scanResult) => {
     const { value } = scanResult || {};
-    try {
-      const localResult = localSearch == null ? void 0 : localSearch(value);
-      if ((localResult == null ? void 0 : localResult.length) > 0) {
-        console.log("本地搜索到数据>>>>>>>", localResult);
-        return {
-          searchType: "local_product",
-          response: { data: { list: localResult } }
-        };
-      } else {
-        console.log("本地搜索无数据>>>>>>>");
+    if (localSearch) {
+      try {
+        const localResult = localSearch == null ? void 0 : localSearch(value);
+        if ((localResult == null ? void 0 : localResult.length) > 0) {
+          console.log("本地搜索到数据>>>>>>>", localResult);
+          return {
+            searchType: "local_product",
+            response: { data: { list: localResult } }
+          };
+        } else {
+          console.log("本地搜索无数据>>>>>>>");
+        }
+      } catch (error) {
+        console.error("本地搜索到数据失败>>>>>>>", error);
       }
-    } catch (error) {
-      console.error("本地搜索到数据失败>>>>>>>", error);
     }
     try {
       if (import_scanCache.default.has(value)) {
@@ -118,8 +121,12 @@ var handleGlobalScan = (request, localSearch) => {
 var handleCustomerScan = () => {
   return () => Promise.resolve({});
 };
+var handleUniversalScan = () => {
+  return () => Promise.resolve({});
+};
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   handleCustomerScan,
-  handleGlobalScan
+  handleGlobalScan,
+  handleUniversalScan
 });

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

@@ -2,7 +2,7 @@ import { Module, PisellCore, ModuleOptions } from '../../types';
 import { BaseModule } from '../../modules/BaseModule';
 import { OrderModule } from '../../modules/Order';
 import { PaymentModule } from '../../modules/Payment';
-import { CheckoutModuleAPI, CheckoutStep, CheckoutInitParams, CreateLocalOrderParams, PlaceOrderParams, CreateOrderParams, ProcessPaymentParams, CheckoutStatusInfo, CheckoutSummary, CurrentOrderInfo, CartSummaryItem, ExtractedAmountInfo } from './types';
+import { CheckoutModuleAPI, CheckoutStep, CheckoutInitParams, CreateLocalOrderParams, PlaceOrderParams, CreateOrderParams, ProcessPaymentParams, CheckoutStatusInfo, CheckoutSummary, CurrentOrderInfo, CartSummaryItem, ExtractedAmountInfo, SendCustomerPayLinkParams } from './types';
 import { PaymentOrder, PaymentMethod, PaymentItem, PaymentItemInput } from '../../modules/Payment/types';
 export * from './types';
 /**
@@ -251,11 +251,12 @@ export declare class CheckoutImpl extends BaseModule implements Module, Checkout
         customer_name?: string;
     } | null;
     /**
-     * 检查订单是否需要手动同步
+     * 检查订单是否需要手动同步（异步版本）
      *
      * 返回订单是否为纯代金券支付且待付金额<=0但未同步的状态
+     * 从 Payment 模块获取最新的支付项数据
      */
-    needsManualSync(): boolean;
+    needsManualSyncAsync(): Promise<boolean>;
     /**
      * 手动同步订单到后端
      *
@@ -279,6 +280,25 @@ export declare class CheckoutImpl extends BaseModule implements Module, Checkout
      * @returns 当前订单的ID，如果没有订单则返回null
      */
     getCurrentOrderId(): string | null;
+    /**
+     * 获取当前订单是否已同步到后端
+     *
+     * @returns 当前订单是否已同步状态，如果没有订单则返回false
+     */
+    isCurrentOrderSynced(): boolean;
+    /**
+     * 取消当前本地订单
+     *
+     * 只能取消未同步到后端的本地订单，如果订单已同步则不能取消
+     *
+     * @param cancelReason 取消原因（可选）
+     * @returns 取消结果
+     */
+    cancelCurrentOrderAsync(cancelReason?: string): Promise<{
+        success: boolean;
+        message?: string;
+        orderId?: string;
+    }>;
     /**
      * 保存订单并稍后支付
      *
@@ -363,13 +383,13 @@ export declare class CheckoutImpl extends BaseModule implements Module, Checkout
      */
     private calculateTotalAmount;
     /**
-     * 计算已支付金额
+     * 计算已支付金额（从 Payment 模块获取最新数据）
      */
-    private calculatePaidAmount;
+    private calculatePaidAmountAsync;
     /**
-     * 计算剩余未支付金额
+     * 计算剩余未支付金额（从 Payment 模块获取最新数据）
      */
-    private calculateRemainingAmount;
+    private calculateRemainingAmountAsync;
     /**
      * 更新 stateAmount 为当前剩余未支付金额
      */
@@ -432,5 +452,28 @@ export declare class CheckoutImpl extends BaseModule implements Module, Checkout
         message?: string;
         orderId?: string | number;
     }>;
+    /**
+     * 发送客户支付链接邮件
+     *
+     * 向指定邮箱发送订单支付提醒邮件
+     *
+     * @param params 发送参数
+     * @returns 发送结果
+     */
+    sendCustomerPayLinkAsync(params: SendCustomerPayLinkParams): Promise<{
+        success: boolean;
+        message?: string;
+    }>;
+    /**
+     * 金额舍入
+     *
+     * @param amount 原始金额
+     * @returns 舍入结果详情，包含原始金额、舍入后金额和舍入差额
+     */
+    roundAmountAsync(amount: number): Promise<{
+        originalAmount: string;
+        roundedAmount: string;
+        roundingDifference: string;
+    }>;
     destroy(): Promise<void>;
 }