@pisell/pisellos 0.0.229 → 0.0.231

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

@@ -1,6 +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, WalletPayment } from './types';
+import { PaymentModuleAPI, PaymentMethod, PaymentOrder, PaymentItem, PaymentItemInput, PaymentUpdateFields, PushOrderParams, CashPayment, EftposPayment, WalletPassPayment, RoundingRule, RoundingInterval } from './types';
 export * from './types';
 export { generateRequestUniqueId };
 /**
@@ -12,40 +13,19 @@ declare function generateRequestUniqueId(): string;
 /**
  * 支付模块实现
  *
- * 支付流程说明：
- * 1. 用户操作 → 调用支付API (pushPaymentAsync, submitPayAsync等)
- * 2. 数据处理 → 更新本地IndexDB中的订单和支付项数据
- * 3. 立即完成 → 本地订单状态立即更新为PaymentStatus.Finished（isSynced保持false）
- * 4. 后台同步 → 网络请求推送到TasksManager异步同步到服务器
- * 5. 同步成功 → 网络请求成功后，isSynced设为true
- * 6. 自动重试 → TasksManager自动重试失败的网络请求，直到isSynced为true
- *
- * 数据状态说明：
- * - PaymentStatus.Processing: 订单正在进行支付操作
- * - PaymentStatus.PartiallyPaid + isSynced=false: 部分支付完成，等待服务器同步
- * - PaymentStatus.PartiallyPaid + isSynced=true: 部分支付且已同步到服务器
- * - PaymentStatus.Finished + isSynced=false: 本地支付完成，等待服务器同步
- * - PaymentStatus.Finished + isSynced=true: 支付完成且已同步到服务器
- *
- * 这种设计的优势：
- * - 即时反馈：支付操作后立即显示完成状态，用户体验更佳
- * - 离线支持：即使网络断开也能正常操作，数据保存在本地
- * - 同步追踪：通过isSynced清楚知道哪些数据还未同步到服务器
- * - 自动重试：TasksManager会自动重试失败的网络请求
- * - 异步处理：不阻塞用户界面，网络同步在后台进行
- * - 数据一致性：通过事件系统确保数据状态同步
+ * 负责处理支付相关的数据管理和本地存储
  */
 export declare class PaymentModule extends BaseModule implements Module, PaymentModuleAPI {
     protected defaultName: string;
     protected defaultVersion: string;
-    private request;
+    request: RequestPlugin;
     private app;
     private store;
     private dbManager;
     private logger;
     cash: CashPayment;
     eftpos: EftposPayment;
-    wallet: WalletPayment;
+    wallet: WalletPassPayment;
     constructor(name?: string, version?: string);
     initialize(core: PisellCore, options: ModuleOptions): Promise<void>;
     /**
@@ -86,33 +66,62 @@ export declare class PaymentModule extends BaseModule implements Module, Payment
      */
     getOrderListAsync(): Promise<PaymentOrder[]>;
     /**
-     * 根据uuid获取指定订单
+     * 根据订单UUID获取支付订单（新方法）
      */
-    getOrderByUuidAsync(orderUuid: string): Promise<PaymentOrder | null>;
+    getPaymentOrderByUuidAsync(orderUuid: string): Promise<PaymentOrder | null>;
     /**
-     * 往交易组中添加订单
+     * 创建支付订单（新方法，专注支付数据）
      */
-    pushOrderAsync(params: PushOrderParams): Promise<PaymentOrder>;
+    createPaymentOrderAsync(params: PushOrderParams): Promise<PaymentOrder>;
     /**
-     * 删除订单
+     * 删除支付订单（新方法）
      */
-    deleteOrderAsync(orderUuid: string): Promise<void>;
+    deletePaymentOrderAsync(orderUuid: string): Promise<void>;
     /**
      * 更新订单
      */
     updateOrderAsync(orderUuid: string, params: Partial<PaymentOrder>): Promise<void>;
     /**
-     * 获取支付项
+     * 基于UUID替换订单ID
+     *
+     * 此方法用于将本地虚拟订单ID替换为真实的订单ID。
+     * 当前端模拟下单流程完成后，后端返回真实订单ID时调用此方法。
+     *
+     * @param orderUuid 订单的UUID
+     * @param newOrderId 新的订单ID (来自后端)
+     * @returns 更新后的订单对象，如果订单不存在则返回null
+     */
+    replaceOrderIdByUuidAsync(orderUuid: string, newOrderId: string): Promise<PaymentOrder | null>;
+    /**
+     * 获取支付项（新方法）
+     *
+     * @param orderUuid 订单UUID
+     * @param includeVoided 是否包含已撤销的支付项，默认为false
+     * @returns 支付项数组
      */
-    getPaymentAsync(orderUuid: string): Promise<PaymentItem[]>;
+    getPaymentItemsAsync(orderUuid: string, includeVoided?: boolean): Promise<PaymentItem[]>;
     /**
-     * 为某个订单设置一个支付项
+     * 获取所有支付项（包括已撤销的）
+     *
+     * @param orderUuid 订单UUID
+     * @returns 所有支付项数组（包括撤销的）
      */
-    pushPaymentAsync(orderUuid: string, paymentItem: PaymentItemInput): Promise<void>;
+    getAllPaymentItemsAsync(orderUuid: string): Promise<PaymentItem[]>;
     /**
-     * 删除一个支付项
+     * 为某个订单添加支付项（新方法）
+     */
+    addPaymentItemAsync(orderUuid: string, paymentItem: PaymentItemInput): Promise<void>;
+    /**
+     * 删除一个支付项 - 标记删除而非物理删除
      */
     deletePaymentAsync(orderUuid: string, paymentUuid: string): Promise<void>;
+    /**
+     * 批量更新代金券类支付项（覆盖更新）
+     *
+     * 删除所有现有的带 voucher_id 的支付项，然后添加新的代金券支付项
+     * 这是一个覆盖式更新，确保代金券支付项的一致性
+     */
+    updateVoucherPaymentItemsAsync(orderUuid: string, voucherPaymentItems: PaymentItemInput[]): Promise<void>;
     /**
      * 更新一个支付项
      */
@@ -127,10 +136,6 @@ export declare class PaymentModule extends BaseModule implements Module, Payment
      * 提交单个订单的支付（推送到任务队列）
      */
     private submitSingleOrderPayment;
-    /**
-     * 添加到同步任务队列
-     */
-    private addToSyncQueue;
     /**
      * 获取订单剩余待付金额
      */
@@ -155,15 +160,6 @@ export declare class PaymentModule extends BaseModule implements Module, Payment
      * 获取钱包支付方式
      */
     getWalletPaymentMethod(): Promise<PaymentMethod | null>;
-    /**
-     * 注册任务处理函数
-     */
-    private registerTaskHandlers;
-    /**
-     * 静态方法：处理支付同步任务（后台网络同步）
-     * 这个方法里不允许用 this，因为需要作为静态方法注入到任务队列里
-     */
-    static syncPaymentTask(payload: any): Promise<any>;
     /**
      * 确保支付模块所需的数据库表已创建
      */
@@ -173,55 +169,22 @@ export declare class PaymentModule extends BaseModule implements Module, Payment
      */
     getPartiallyPaidOrdersAsync(): Promise<PaymentOrder[]>;
     /**
-     * 获取未同步到服务器的订单
-     */
-    getUnsyncedOrdersAsync(): Promise<PaymentOrder[]>;
-    /**
-     * 清理已完成且已同步的订单
-     * 注意：只清理完全支付的订单，部分支付的订单保留以便继续支付
-     */
-    cleanupFinishedOrders(): Promise<void>;
-    /**
-     * 检测未同步的订单并重新加入任务队列
-     *
-     * 此方法专门用于处理因网络问题导致任务队列执行失败但队列被清空的情况。
-     * 它会检查本地 IndexDB 中所有未同步的订单（isSynced: false），
-     * 并将这些订单重新添加到任务队列中。
-     *
-     * 使用场景：
-     * - 网络恢复后重新检查未同步的订单
-     * - 应用启动时检查并重新排队未完成的支付
-     * - 用户手动重试前的预检查
-     *
-     * @returns Promise<number> 返回重新加入队列的订单数量
-     */
-    recheckAndRequeueUnsyncedOrders(): Promise<number>;
-    /**
-     * 手动执行支付同步队列
-     * 外部可以调用此方法来触发支付同步任务的执行
-     *
-     * 注意：此方法只执行现有队列中的任务，不会检查未同步的订单。
-     * 如果需要检查未同步订单，请先调用 recheckAndRequeueUnsyncedOrders()
+     * 智能金额舍入
      *
-     * 使用示例：
-     * ```typescript
-     * // 1. 先检查并重新排队未同步订单，然后执行队列
-     * const requeuedCount = await paymentModule.recheckAndRequeueUnsyncedOrders();
-     * if (requeuedCount > 0) {
-     *   await paymentModule.runPaymentSyncQueue();
-     * }
+     * 根据指定的舍入间隔和规则对金额进行舍入处理
      *
-     * // 2. 或者直接执行现有队列（不检查未同步订单）
-     * await paymentModule.runPaymentSyncQueue();
-     * ```
+     * @param originalAmount 原始金额
+     * @param interval 舍入间隔 (0.05, 0.1, 0.5, 1)
+     * @param rule 舍入规则 (standard, standard_down, always_up, always_down)
+     * @returns 舍入后的金额（保留两位小数的字符串）
      */
-    runPaymentSyncQueue(): Promise<void>;
+    roundAmountAsync(originalAmount: number | string, interval: RoundingInterval | number, rule: RoundingRule | string): Promise<string>;
     /**
-     * 重新将订单添加到同步队列
-     * 用于处理因网络问题导致任务队列清空但订单未同步的情况
+     * 标准舍入处理（处理中点情况）
      *
-     * @param order 要重新添加的订单
-     * @returns Promise<boolean> 是否成功添加到队列
+     * @param value 要舍入的值
+     * @param midpointUp 中点是否向上舍入
+     * @returns 舍入后的值
      */
-    private reAddOrderToSyncQueue;
+    private standardRound;
 }