@pisell/pisellos 0.0.195 → 0.0.199

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

@@ -181,9 +181,47 @@ export declare class PaymentModule extends BaseModule implements Module, Payment
      * 注意：只清理完全支付的订单，部分支付的订单保留以便继续支付
      */
     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();
+     * ```
      */
     runPaymentSyncQueue(): Promise<void>;
+    /**
+     * 重新将订单添加到同步队列
+     * 用于处理因网络问题导致任务队列清空但订单未同步的情况
+     *
+     * @param order 要重新添加的订单
+     * @returns Promise<boolean> 是否成功添加到队列
+     */
+    private reAddOrderToSyncQueue;
 }