@pisell/pisellos 3.0.55 → 3.0.57

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

@@ -0,0 +1,146 @@
+import { ICustomer } from "../AccountList/types";
+export declare enum CustomerHooks {
+    OnCustomerListUpdate = "customer:onUpdate",
+    OnCustomerListError = "customer:onError",
+    OnCustomerSelected = "customer:onSelected",
+    OnPaginationChange = "customer:onPaginationChange",
+    OnScrollLoadMore = "customer:onScrollLoadMore",
+    OnScrollLoadComplete = "customer:onScrollLoadComplete"
+}
+/**
+ * 客户数据
+ */
+export interface ShopCustomer extends ICustomer {
+    /** 客户ID */
+    id: string | number;
+    /** 客户姓名 */
+    name: string;
+    /** 客户电话 */
+    phone?: string;
+    /** 客户邮箱 */
+    email?: string;
+    /** 客户创建时间 */
+    created_at?: string;
+    /** 客户更新时间 */
+    updated_at?: string;
+    /** 其他客户信息 */
+    [key: string]: any;
+}
+/**
+ * 客户列表关联查询参数
+ *
+ * formRecord: 用户表单记录
+ * walletDetails.wallet: 用户所有wallet
+ * latestWalletDetail.wallet: 用户最新wallet
+ */
+type CustomerWith = 'formRecord' | 'walletDetails.wallet' | 'latestWalletDetail.wallet';
+/**
+ * 获取客户列表参数
+ */
+export interface ShopGetCustomerListParams {
+    /** 页码 */
+    skip?: number;
+    /** 每页数量 */
+    num?: number;
+    /** 搜索关键词 */
+    search?: string;
+    /** 关联查询参数 */
+    with?: CustomerWith[];
+    /** wallet搜索标识 */
+    search_wallet_flag?: 0 | 1;
+    /** wallet pass搜索标识 */
+    search_wallet_pass_flag?: 0 | 1;
+    /** 其他筛选参数 */
+    [key: string]: any;
+}
+/**
+ * 分页信息
+ */
+export interface IPaginationInfo {
+    /** 当前页码 */
+    page: number;
+    /** 每页数量 */
+    pageSize: number;
+    /** 总数 */
+    total: number;
+    /** 总页数 */
+    totalPages: number;
+}
+/**
+ * 客户列表响应
+ */
+export interface ICustomerListResponse {
+    /** 客户列表 */
+    list: ShopCustomer[];
+    /** 总数 */
+    total: number;
+    /** 当前页 */
+    page?: number;
+    /** 每页数量 */
+    pageSize?: number;
+}
+/**
+ * 客户列表状态
+ */
+export interface CustomerState {
+    /** 客户列表 */
+    customerList: ShopCustomer[];
+    /** 当前选择的客户 */
+    selectedCustomer: ShopCustomer | null;
+    /** 列表总数 */
+    total: number;
+    /** 当前页码 */
+    currentPage: number;
+    /** 每页数量 */
+    pageSize: number;
+    /** 加载状态 */
+    loading: boolean;
+    /** 错误信息 */
+    error: string | null;
+    /** 是否支持滚动加载更多 */
+    hasMore: boolean;
+    /** 滚动加载状态 */
+    loadingMore: boolean;
+    /** 当前搜索条件 */
+    searchParams: Omit<ShopGetCustomerListParams, 'skip' | 'num'>;
+}
+/**
+ * 客户模块 API
+ */
+export interface CustomerModuleAPI {
+    /** 获取客户列表 */
+    getCustomerList: (params?: ShopGetCustomerListParams) => Promise<ICustomerListResponse>;
+    /** 设置客户列表 */
+    setCustomerList: (customers: ShopCustomer[], total?: number) => void;
+    /** 设置当前选择的客户 */
+    setSelectedCustomer: (customer: ShopCustomer | null) => void;
+    /** 获取当前选择的客户 */
+    getSelectedCustomer: () => ShopCustomer | null;
+    /** 获取客户列表 */
+    getCustomers: () => ShopCustomer[];
+    /** 根据ID查找客户 */
+    getCustomerById: (id: string | number) => ShopCustomer | null;
+    /** 清空客户列表 */
+    clearCustomers: () => void;
+    /** 添加客户到列表第一位 */
+    addCustomerToFirst: (customer: ShopCustomer) => void;
+    /** 获取当前状态 */
+    getState: () => CustomerState;
+    /** 获取分页信息 */
+    getPaginationInfo: () => IPaginationInfo;
+    /** 触发分页变化事件 */
+    triggerPaginationChange: (pagination: IPaginationInfo) => void;
+    /** 设置分页信息 */
+    setPaginationInfo: (page: number, pageSize: number) => void;
+    /** 便捷方法：切换分页并自动获取数据 */
+    changeCustomerPage: (page: number, pageSize?: number) => Promise<ICustomerListResponse>;
+    /** 滚动加载更多客户数据 */
+    loadMoreCustomers: () => Promise<ICustomerListResponse>;
+    /** 重置并重新开始滚动加载 */
+    resetAndLoadCustomers: (params?: ShopGetCustomerListParams) => Promise<ICustomerListResponse>;
+    /** 检查是否还有更多数据可以加载 */
+    hasMoreCustomers: () => boolean;
+    /** 获取当前的搜索条件 */
+    getCurrentSearchParams: () => Omit<ShopGetCustomerListParams, 'skip' | 'num'>;
+}
+export {};

package/lib/modules/Customer/types.js

@@ -0,0 +1,37 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/modules/Customer/types.ts
+var types_exports = {};
+__export(types_exports, {
+  CustomerHooks: () => CustomerHooks
+});
+module.exports = __toCommonJS(types_exports);
+var CustomerHooks = /* @__PURE__ */ ((CustomerHooks2) => {
+  CustomerHooks2["OnCustomerListUpdate"] = "customer:onUpdate";
+  CustomerHooks2["OnCustomerListError"] = "customer:onError";
+  CustomerHooks2["OnCustomerSelected"] = "customer:onSelected";
+  CustomerHooks2["OnPaginationChange"] = "customer:onPaginationChange";
+  CustomerHooks2["OnScrollLoadMore"] = "customer:onScrollLoadMore";
+  CustomerHooks2["OnScrollLoadComplete"] = "customer:onScrollLoadComplete";
+  return CustomerHooks2;
+})(CustomerHooks || {});
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  CustomerHooks
+});

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

@@ -0,0 +1,11 @@
+import { CashPayment } from './types';
+import type { PaymentModule } from './index';
+/**
+ * 现金支付实现
+ */
+export declare class CashPaymentImpl implements CashPayment {
+    private paymentModule;
+    constructor(paymentModule: PaymentModule);
+    processCashPayment(amount: number, orderUuid: string): Promise<void>;
+    getCashBalance(): Promise<number>;
+}

package/lib/modules/Payment/cash.js

@@ -0,0 +1,51 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/modules/Payment/cash.ts
+var cash_exports = {};
+__export(cash_exports, {
+  CashPaymentImpl: () => CashPaymentImpl
+});
+module.exports = __toCommonJS(cash_exports);
+var CashPaymentImpl = class {
+  constructor(paymentModule) {
+    this.paymentModule = paymentModule;
+  }
+  async processCashPayment(amount, orderUuid) {
+    const cashMethod = await this.paymentModule.getCashPaymentMethod();
+    if (!cashMethod) {
+      throw new Error("现金支付方式未找到");
+    }
+    const paymentItem = {
+      amount: amount.toString(),
+      code: cashMethod.code,
+      id: cashMethod.id,
+      name: cashMethod.name,
+      type: cashMethod.type,
+      voucher_id: ""
+    };
+    await this.paymentModule.pushPaymentAsync(orderUuid, paymentItem);
+  }
+  async getCashBalance() {
+    return 0;
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  CashPaymentImpl
+});

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

@@ -0,0 +1,11 @@
+import { EftposPayment } from './types';
+import type { PaymentModule } from './index';
+/**
+ * Eftpos支付实现
+ */
+export declare class EftposPaymentImpl implements EftposPayment {
+    private paymentModule;
+    constructor(paymentModule: PaymentModule);
+    processEftposPayment(amount: number, orderUuid: string): Promise<void>;
+    checkDeviceStatus(): Promise<boolean>;
+}

package/lib/modules/Payment/eftpos.js

@@ -0,0 +1,51 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/modules/Payment/eftpos.ts
+var eftpos_exports = {};
+__export(eftpos_exports, {
+  EftposPaymentImpl: () => EftposPaymentImpl
+});
+module.exports = __toCommonJS(eftpos_exports);
+var EftposPaymentImpl = class {
+  constructor(paymentModule) {
+    this.paymentModule = paymentModule;
+  }
+  async processEftposPayment(amount, orderUuid) {
+    const eftposMethod = await this.paymentModule.getEftposPaymentMethod();
+    if (!eftposMethod) {
+      throw new Error("Eftpos支付方式未找到");
+    }
+    const paymentItem = {
+      amount: amount.toString(),
+      code: eftposMethod.code,
+      id: eftposMethod.id,
+      name: eftposMethod.name,
+      type: eftposMethod.type,
+      voucher_id: ""
+    };
+    await this.paymentModule.pushPaymentAsync(orderUuid, paymentItem);
+  }
+  async checkDeviceStatus() {
+    return true;
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  EftposPaymentImpl
+});

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

@@ -1,16 +1,280 @@
 import { Module, PisellCore, ModuleOptions } from '../../types';
 import { BaseModule } from '../BaseModule';
-import { Payment, PaymentModuleAPI, PaymentMethod, PaymentStatus } from './types';
+import { PaymentModuleAPI, PaymentMethod, PaymentOrder, PaymentItem, PaymentItemInput, PaymentUpdateFields, PushOrderParams, CashPayment, EftposPayment, WalletPayment } from './types';
+export * from './types';
+export { generateRequestUniqueId };
+/**
+ * 生成请求唯一ID
+ * 格式: 年月日时分秒毫秒+4位随机数
+ * 示例: 20241201143025123456
+ */
+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 state;
+    private request;
+    private app;
+    private store;
+    private dbManager;
+    private logger;
+    cash: CashPayment;
+    eftpos: EftposPayment;
+    wallet: WalletPayment;
     constructor(name?: string, version?: string);
-    initialize(core: PisellCore, options?: ModuleOptions): Promise<void>;
-    processPayment(paymentId: string): Promise<void>;
-    getPayment(paymentId: string): Promise<Payment>;
-    getPaymentHistory(): Promise<Payment[]>;
-    refund(paymentId: string): Promise<void>;
-    getAvailablePaymentMethods(): PaymentMethod[];
-    checkPaymentStatus(paymentId: string): Promise<PaymentStatus>;
+    initialize(core: PisellCore, options: ModuleOptions): Promise<void>;
+    /**
+     * 记录信息日志
+     */
+    private logInfo;
+    /**
+     * 记录警告日志
+     */
+    private logWarning;
+    /**
+     * 记录错误日志
+     */
+    private logError;
+    /**
+     * 记录调试日志
+     */
+    private logDebug;
+    /**
+     * 网络恢复以后，尝试执行队列
+     *
+     */
+    private registerNetworkHandlers;
+    /**
+     * 获取支付方式列表
+     */
+    getPayMethodListAsync(): Promise<PaymentMethod[]>;
+    /**
+     * 后台刷新支付方式列表
+     */
+    private refreshPaymentMethodsInBackground;
+    /**
+     * 检查支付方式列表是否有变化
+     */
+    private hasPaymentMethodsChanged;
+    /**
+     * 获取订单列表
+     */
+    getOrderListAsync(): Promise<PaymentOrder[]>;
+    /**
+     * 根据订单UUID获取支付订单（新方法）
+     */
+    getPaymentOrderByUuidAsync(orderUuid: string): Promise<PaymentOrder | null>;
+    /**
+     * 创建支付订单（新方法，专注支付数据）
+     */
+    createPaymentOrderAsync(params: PushOrderParams): Promise<PaymentOrder>;
+    /**
+     * 往交易组中添加订单（兼容性方法）
+     * @deprecated 使用 createPaymentOrderAsync 替代
+     */
+    pushOrderAsync(params: PushOrderParams): Promise<PaymentOrder>;
+    /**
+     * 删除支付订单（新方法）
+     */
+    deletePaymentOrderAsync(orderUuid: string): Promise<void>;
+    /**
+     * 删除订单（兼容性方法）
+     * @deprecated 使用 deletePaymentOrderAsync 替代
+     */
+    deleteOrderAsync(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>;
+    /**
+     * 获取支付项（新方法）
+     */
+    getPaymentItemsAsync(orderUuid: string): Promise<PaymentItem[]>;
+    /**
+     * 获取支付项（兼容性方法）
+     * @deprecated 使用 getPaymentItemsAsync 替代
+     */
+    getPaymentAsync(orderUuid: string): Promise<PaymentItem[]>;
+    /**
+     * 为某个订单添加支付项（新方法）
+     */
+    addPaymentItemAsync(orderUuid: string, paymentItem: PaymentItemInput): Promise<void>;
+    /**
+     * 为某个订单设置一个支付项（兼容性方法）
+     * @deprecated 使用 addPaymentItemAsync 替代
+     */
+    pushPaymentAsync(orderUuid: string, paymentItem: PaymentItemInput): Promise<void>;
+    /**
+     * 删除一个支付项
+     */
+    deletePaymentAsync(orderUuid: string, paymentUuid: string): Promise<void>;
+    /**
+     * 更新一个支付项
+     */
+    updatePaymentAsync(orderUuid: string, paymentUuid: string, params: PaymentUpdateFields): Promise<void>;
+    /**
+     * 提交支付
+     */
+    submitPayAsync(orderUuid?: string): Promise<{
+        status: 'success' | 'failed';
+    }>;
+    /**
+     * 提交单个订单的支付（推送到任务队列）
+     */
+    private submitSingleOrderPayment;
+    /**
+     * 添加到同步任务队列
+     */
+    private addToSyncQueue;
+    /**
+     * 获取订单剩余待付金额
+     */
+    getRemainingOrderAmountAsync(orderUuid: string): Promise<number>;
+    /**
+     * 在比如现金支付界面的地方，用户输入了一个金额，在下方显示剩余多少金额，通过此方法获取
+     */
+    getRemainingOrderAmountWithInputAsync(inputAmount: string | number, orderUuid: string): Promise<number>;
+    /**
+     * 重新计算订单金额
+     */
+    private recalculateOrderAmount;
+    /**
+     * 获取现金支付方式
+     */
+    getCashPaymentMethod(): Promise<PaymentMethod | null>;
+    /**
+     * 获取Eftpos支付方式
+     */
+    getEftposPaymentMethod(): Promise<PaymentMethod | null>;
+    /**
+     * 获取钱包支付方式
+     */
+    getWalletPaymentMethod(): Promise<PaymentMethod | null>;
+    /**
+     * 注册任务处理函数
+     */
+    private registerTaskHandlers;
+    /**
+     * 静态方法：处理支付同步任务（后台网络同步）
+     * 这个方法里不允许用 this，因为需要作为静态方法注入到任务队列里
+     */
+    static syncPaymentTask(payload: any): Promise<any>;
+    /**
+     * 确保支付模块所需的数据库表已创建
+     */
+    private ensurePaymentTables;
+    /**
+     * 获取部分支付的订单
+     */
+    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();
+     * ```
+     */
+    runPaymentSyncQueue(): Promise<void>;
+    /**
+     * 重新将订单添加到同步队列
+     * 用于处理因网络问题导致任务队列清空但订单未同步的情况
+     *
+     * @param order 要重新添加的订单
+     * @returns Promise<boolean> 是否成功添加到队列
+     */
+    private reAddOrderToSyncQueue;
+    /**
+     * 删除支付项（新方法）
+     */
+    deletePaymentItemAsync(orderUuid: string, paymentUuid: string): Promise<void>;
+    /**
+     * 更新支付项（新方法）
+     */
+    updatePaymentItemAsync(orderUuid: string, paymentUuid: string, params: PaymentUpdateFields): Promise<void>;
+    /**
+     * 获取订单剩余待付金额（新方法）
+     */
+    getRemainingAmountAsync(orderUuid: string): Promise<number>;
+    /**
+     * 获取订单剩余待付金额（基于用户输入的金额）（新方法）
+     */
+    getRemainingAmountWithInputAsync(inputAmount: string | number, orderUuid: string): Promise<number>;
+    /**
+     * 提交支付（新方法）
+     */
+    submitPaymentAsync(orderUuid: string): Promise<{
+        status: 'success' | 'failed';
+    }>;
 }