@pisell/pisellos 3.0.55 → 3.0.57

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

@@ -1,47 +1,399 @@
-export declare enum PaymentHooks {
-    OnPaymentInit = "payment:onPaymentInit",
-    OnPaymentSuccess = "payment:onPaymentSuccess",
-    OnPaymentFailure = "payment:onPaymentFailure",
-    OnPaymentRefund = "payment:onPaymentRefund"
+/**
+ * 支付相关类型定义
+ */
+/**
+ * 支付方式枚举
+ */
+export declare enum PaymentMethodType {
+    Cash = "CASHMANUAL",
+    Eftpos = "EFTPOS",
+    Wallet = "WALLET"
 }
 /**
- * 支付方式
+ * 支付状态枚举
  */
-export type PaymentMethod = 'credit_card' | 'debit_card' | 'paypal' | 'alipay' | 'wechat_pay' | 'bank_transfer';
+export declare enum PaymentStatus {
+    /** 支付处理中 - 订单正在进行支付操作 */
+    Processing = "payment_processing",
+    /** 同步中 - 暂时不使用，为了向后兼容保留 */
+    Sync = "sync",
+    /** 部分支付 - 支付金额不足订单总金额 */
+    PartiallyPaid = "partially_paid",
+    /** 已完成 - 本地支付完成，后台自动同步到服务器 */
+    Finished = "finish"
+}
 /**
- * 支付状态
+ * 任务状态枚举
+ */
+export declare enum TaskRunStatus {
+    Pending = "pending",
+    Running = "running",
+    Success = "success",
+    Failed = "failed"
+}
+/**
+ * 支付方式信息
+ */
+export interface PaymentMethod {
+    /** 支付方式ID */
+    id: number;
+    /** 支付方式代码 */
+    code: string;
+    /** 支付方式名称 */
+    name: string;
+    /** 支付方式类型 */
+    type: string;
+    /** 是否启用 */
+    enabled: boolean;
+    /** 其他配置信息 */
+    [key: string]: any;
+}
+/**
+ * 支付项
+ */
+export interface PaymentItem {
+    /** 当前支付项的唯一 ID */
+    uuid: string;
+    /** 当前支付方式付出去多少钱 */
+    amount: string;
+    /** 支付类型，跟支付列表上对应的支付方式保持一致 */
+    code: string;
+    /** 支付类型id，跟支付列表上对应的支付方式保持一致 */
+    id: number;
+    /** 支付类型名称，跟支付列表上对应的支付方式保持一致 */
+    name: string;
+    /** 支付类型type，跟支付列表上对应的支付方式保持一致 */
+    type: string;
+    /** 代金券、充值卡、积分卡等wallet pass id */
+    voucher_id?: string;
+    /** 拓展参数字段 */
+    metadata?: {
+        /** 钱箱 ID */
+        shop_wallet_pass_id?: string;
+        /** 唯一支付号 */
+        unique_payment_number?: string;
+        /** rouding规则 */
+        rounding_rule?: any;
+    };
+    /** rouding金额 */
+    rounding_amount?: string;
+    /** 三方支付手续费 */
+    service_charge?: {
+        percentage: string;
+        amount: string;
+    };
+    /** 该支付项是否已经同步给后端服务器（只有网络请求成功后才为true） */
+    isSynced?: boolean;
+    /** 同步错误信息（业务错误时记录错误信息，用于区分"未同步"和"同步失败"） */
+    syncError?: {
+        error: string;
+        errorCode?: string;
+        statusCode?: number;
+        timestamp: number;
+    };
+}
+/**
+ * 订单信息
  */
-export type PaymentStatus = 'pending' | 'processing' | 'completed' | 'failed' | 'refunded';
+export interface OrderInfo {
+    /** 订单 id */
+    order_id: number;
+    /** 订单总金额 */
+    total_amount: string;
+    /** 是否是定金订单 */
+    is_deposit: number;
+    /** 定金金额 */
+    deposit_amount: string;
+}
 /**
- * 支付信息
+ * 支付订单（简化版，仅保留支付相关信息）
  */
-export interface Payment {
+export interface PaymentOrder {
+    /** 当前订单的唯一 ID */
+    uuid: string;
+    /** 订单ID（字符串类型，支持本地虚拟ID） */
     id: string;
-    orderId: string;
-    amount: number;
-    currency: string;
-    method: PaymentMethod;
-    status: PaymentStatus;
-    transactionId?: string;
-    createdAt: Date;
-    updatedAt: Date;
-    metadata?: Record<string, any>;
+    /** 订单ID（数字类型，兼容旧版本） */
+    order_id: string;
+    /** 支付项列表 */
+    payment: PaymentItem[];
+    /** 修改的支付项列表 */
+    adjust_offline_payments: PaymentItem[];
+    /** 总计金额 */
+    total_amount: string;
+    /** 待付金额 */
+    expect_amount: string;
+    /** 支付状态 */
+    payment_status: PaymentStatus;
+    /** 是否是定金订单 */
+    is_deposit: number;
+    /** 定金金额 */
+    deposit_amount: string;
+    /** 总税费 */
+    tax_fee: string;
+    /** 原始订单数据（由 Checkout 模块传入） */
+    order_info?: any;
 }
 /**
- * 支付模块状态
+ * 支付状态
  */
 export interface PaymentState {
-    currentPayment: Payment | null;
-    paymentHistory: Payment[];
 }
 /**
- * 支付模块 API
+ * 推送订单参数（简化版）
+ */
+export interface PushOrderParams {
+    /** 订单ID */
+    order_id: string;
+    /** 总金额 */
+    total_amount: string;
+    /** 是否是定金订单 */
+    is_deposit?: number;
+    /** 定金金额 */
+    deposit_amount?: string;
+    /** 原始订单数据（可选，由 Checkout 模块传入） */
+    order_info?: any;
+}
+/**
+ * 更新订单参数
+ */
+export interface UpdateOrderParams {
+    /** 订单UUID */
+    uuid: string;
+    /** 更新的字段 */
+    [key: string]: any;
+}
+/**
+ * 支付项输入类型（允许 amount 为数字）
+ */
+export interface PaymentItemInput {
+    /** 当前支付方式付出去多少钱 */
+    amount: string | number;
+    /** 支付类型，跟支付列表上对应的支付方式保持一致 */
+    code: string;
+    /** 支付类型id，跟支付列表上对应的支付方式保持一致 */
+    id: number;
+    /** 支付类型名称，跟支付列表上对应的支付方式保持一致 */
+    name: string;
+    /** 支付类型type，跟支付列表上对应的支付方式保持一致 */
+    type: string;
+    /** 代金券、充值卡、积分卡等wallet pass id */
+    voucher_id?: string;
+}
+/**
+ * 推送支付项参数
+ */
+export interface PushPaymentParams {
+    /** 订单UUID */
+    orderUuid: string;
+    /** 支付项信息 */
+    paymentItem: PaymentItemInput;
+}
+/**
+ * 更新支付项参数中的字段类型（允许 amount 为数字）
+ */
+export interface PaymentUpdateFields {
+    /** 当前支付项的唯一 ID */
+    uuid?: string;
+    /** 当前支付方式付出去多少钱 */
+    amount?: string | number;
+    /** 支付类型，跟支付列表上对应的支付方式保持一致 */
+    code?: string;
+    /** 支付类型id，跟支付列表上对应的支付方式保持一致 */
+    id?: number;
+    /** 支付类型名称，跟支付列表上对应的支付方式保持一致 */
+    name?: string;
+    /** 支付类型type，跟支付列表上对应的支付方式保持一致 */
+    type?: string;
+    /** 代金券、充值卡、积分卡等wallet pass id */
+    voucher_id?: string;
+    /** 该支付项是否已经同步给后端服务器（只有网络请求成功后才为true） */
+    isSynced?: boolean;
+    /** 同步错误信息（业务错误时记录错误信息，用于区分"未同步"和"同步失败"） */
+    syncError?: {
+        error: string;
+        errorCode?: string;
+        statusCode?: number;
+        timestamp: number;
+    };
+}
+/**
+ * 更新支付项参数
+ */
+export interface UpdatePaymentParams {
+    /** 订单UUID */
+    orderUuid: string;
+    /** 支付项UUID */
+    paymentUuid: string;
+    /** 更新的字段 */
+    params: PaymentUpdateFields;
+}
+/**
+ * 删除支付项参数
+ */
+export interface DeletePaymentParams {
+    /** 订单UUID */
+    orderUuid: string;
+    /** 支付项UUID */
+    paymentUuid: string;
+}
+/**
+ * 现金支付接口
+ */
+export interface CashPayment {
+    /** 处理现金支付 */
+    processCashPayment: (amount: number, orderUuid: string) => Promise<void>;
+    /** 获取现金余额 */
+    getCashBalance: () => Promise<number>;
+}
+/**
+ * Eftpos支付接口
+ */
+export interface EftposPayment {
+    /** 处理Eftpos支付 */
+    processEftposPayment: (amount: number, orderUuid: string) => Promise<void>;
+    /** 检查Eftpos设备状态 */
+    checkDeviceStatus: () => Promise<boolean>;
+}
+/**
+ * 钱包支付接口
+ */
+export interface WalletPayment {
+    /** 处理钱包支付 */
+    processWalletPayment: (amount: number, orderUuid: string, voucherId?: string) => Promise<void>;
+    /** 获取钱包余额 */
+    getWalletBalance: (voucherId: string) => Promise<number>;
+}
+/**
+ * 支付模块API接口
  */
 export interface PaymentModuleAPI {
-    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>;
+    /** 现金支付相关方法 */
+    cash: CashPayment;
+    /** Eftpos支付相关方法 */
+    eftpos: EftposPayment;
+    /** 钱包支付相关方法 */
+    wallet: WalletPayment;
+    /** 获取支付方式列表 */
+    getPayMethodListAsync: () => Promise<PaymentMethod[]>;
+    /** 创建支付订单（仅保存支付相关信息） */
+    createPaymentOrderAsync: (params: PushOrderParams) => Promise<PaymentOrder>;
+    /** 根据订单UUID获取支付订单 */
+    getPaymentOrderByUuidAsync: (orderUuid: string) => Promise<PaymentOrder | null>;
+    /** 基于UUID替换订单ID */
+    replaceOrderIdByUuidAsync: (orderUuid: string, newOrderId: string) => Promise<PaymentOrder | null>;
+    /** 删除支付订单 */
+    deletePaymentOrderAsync: (orderUuid: string) => Promise<void>;
+    /** 获取支付项 */
+    getPaymentItemsAsync: (orderUuid: string) => Promise<PaymentItem[]>;
+    /** 为某个订单添加支付项 */
+    addPaymentItemAsync: (orderUuid: string, paymentItem: PaymentItemInput) => Promise<void>;
+    /** 删除支付项 */
+    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';
+    }>;
+    /** 获取部分支付的订单 */
+    getPartiallyPaidOrdersAsync: () => Promise<PaymentOrder[]>;
+    /** 获取未同步到服务器的订单 */
+    getUnsyncedOrdersAsync: () => Promise<PaymentOrder[]>;
+    /** 检测未同步的订单并重新加入任务队列 */
+    recheckAndRequeueUnsyncedOrders: () => Promise<number>;
+    /** 手动执行支付同步队列 */
+    runPaymentSyncQueue: () => Promise<void>;
+    /** @deprecated 使用 createPaymentOrderAsync 替代 */
+    pushOrderAsync: (params: PushOrderParams) => Promise<PaymentOrder>;
+    /** @deprecated 使用 getPaymentItemsAsync 替代 */
+    getPaymentAsync: (orderUuid: string) => Promise<PaymentItem[]>;
+    /** @deprecated 使用 addPaymentItemAsync 替代 */
+    pushPaymentAsync: (orderUuid: string, paymentItem: PaymentItemInput) => Promise<void>;
+    /** @deprecated 使用 deletePaymentItemAsync 替代 */
+    deletePaymentAsync: (orderUuid: string, paymentUuid: string) => Promise<void>;
+    /** @deprecated 使用 updatePaymentItemAsync 替代 */
+    updatePaymentAsync: (orderUuid: string, paymentUuid: string, params: PaymentUpdateFields) => Promise<void>;
+    /** @deprecated 使用 submitPaymentAsync 替代 */
+    submitPayAsync: (orderUuid?: string) => Promise<{
+        status: 'success' | 'failed';
+    }>;
+    /** @deprecated 使用 getRemainingAmountAsync 替代 */
+    getRemainingOrderAmountAsync: (orderUuid: string) => Promise<number>;
+    /** @deprecated 使用 getRemainingAmountWithInputAsync 替代 */
+    getRemainingOrderAmountWithInputAsync: (inputAmount: string | number, orderUuid: string) => Promise<number>;
+}
+/**
+ * 订单变化事件数据
+ */
+export interface OnOrderChangedEventData {
+    /** 操作类型 */
+    action: 'add' | 'delete' | 'update' | 'payment_add' | 'payment_delete' | 'payment_update' | 'submit';
+    /** 当前订单 */
+    order: PaymentOrder;
+    /** 原始订单（仅在 update 操作时提供） */
+    originalOrder?: PaymentOrder;
+    /** 相关的支付项（仅在 payment_* 操作时提供） */
+    paymentItem?: PaymentItem;
+}
+/**
+ * 支付方式变化事件数据
+ */
+export interface OnPaymentMethodsChangedEventData {
+    /** 旧的支付方式列表 */
+    oldMethods: PaymentMethod[];
+    /** 新的支付方式列表 */
+    newMethods: PaymentMethod[];
+}
+/**
+ * 支付同步错误事件数据
+ */
+export interface OnPaymentSyncErrorEventData {
+    /** 订单UUID */
+    orderUuid: string;
+    /** 订单ID */
+    orderId: number;
+    /** 错误信息 */
+    error: string;
+    /** 错误代码 */
+    errorCode?: string;
+    /** HTTP状态码 */
+    statusCode?: number;
+    /** 错误发生时间 */
+    timestamp: number;
+    /** 响应数据（当HTTP请求成功但业务失败时） */
+    responseData?: any;
+}
+/**
+ * 支付同步成功事件数据
+ */
+export interface OnPaymentSyncSuccessEventData {
+    /** 订单UUID */
+    orderUuid: string;
+    /** 订单ID */
+    orderId: number;
+    /** 成功时间 */
+    timestamp: number;
+}
+/**
+ * 支付钩子事件
+ */
+export declare enum PaymentHooks {
+    OnPaymentMethodsLoaded = "payment:onPaymentMethodsLoaded",
+    OnPaymentMethodsChanged = "payment:onPaymentMethodsChanged",
+    OnOrderChanged = "payment:onOrderChanged",
+    OnOrderAdded = "payment:onOrderAdded",
+    OnOrderUpdated = "payment:onOrderUpdated",
+    OnOrderDeleted = "payment:onOrderDeleted",
+    OnPaymentAdded = "payment:onPaymentAdded",
+    OnPaymentUpdated = "payment:onPaymentUpdated",
+    OnPaymentDeleted = "payment:onPaymentDeleted",
+    OnPaymentSubmitted = "payment:onPaymentSubmitted",
+    OnOrderAmountChanged = "payment:onOrderAmountChanged",
+    OnPaymentSyncError = "payment:onPaymentSyncError",
+    OnPaymentSyncSuccess = "payment:onPaymentSyncSuccess"
 }

package/dist/modules/Payment/types.js

@@ -1,33 +1,135 @@
-// import { Order } from '../Order/types'
+/**
+ * 支付相关类型定义
+ */
 
-export var PaymentHooks = /*#__PURE__*/function (PaymentHooks) {
-  PaymentHooks["OnPaymentInit"] = "payment:onPaymentInit";
-  PaymentHooks["OnPaymentSuccess"] = "payment:onPaymentSuccess";
-  PaymentHooks["OnPaymentFailure"] = "payment:onPaymentFailure";
-  PaymentHooks["OnPaymentRefund"] = "payment:onPaymentRefund";
-  return PaymentHooks;
+/**
+ * 支付方式枚举
+ */
+export var PaymentMethodType = /*#__PURE__*/function (PaymentMethodType) {
+  PaymentMethodType["Cash"] = "CASHMANUAL";
+  PaymentMethodType["Eftpos"] = "EFTPOS";
+  PaymentMethodType["Wallet"] = "WALLET";
+  return PaymentMethodType;
+}({});
+
+/**
+ * 支付状态枚举
+ */
+export var PaymentStatus = /*#__PURE__*/function (PaymentStatus) {
+  PaymentStatus["Processing"] = "payment_processing";
+  PaymentStatus["Sync"] = "sync";
+  PaymentStatus["PartiallyPaid"] = "partially_paid";
+  PaymentStatus["Finished"] = "finish";
+  return PaymentStatus;
+}({});
+
+/**
+ * 任务状态枚举
+ */
+export var TaskRunStatus = /*#__PURE__*/function (TaskRunStatus) {
+  TaskRunStatus["Pending"] = "pending";
+  TaskRunStatus["Running"] = "running";
+  TaskRunStatus["Success"] = "success";
+  TaskRunStatus["Failed"] = "failed";
+  return TaskRunStatus;
 }({});
 
 /**
- * 支付方式
+ * 支付方式信息
+ */
+
+/**
+ * 支付项
+ */
+
+/**
+ * 订单信息
  */
 
-// 银行转账
+/**
+ * 支付订单（简化版，仅保留支付相关信息）
+ */
 
 /**
  * 支付状态
  */
 
-// 已退款
+/**
+ * 推送订单参数（简化版）
+ */
+
+/**
+ * 更新订单参数
+ */
+
+/**
+ * 支付项输入类型（允许 amount 为数字）
+ */
 
 /**
- * 支付信息
+ * 推送支付项参数
  */
 
 /**
- * 支付模块状态
+ * 更新支付项参数中的字段类型（允许 amount 为数字）
  */
 
 /**
- * 支付模块 API
- */
+ * 更新支付项参数
+ */
+
+/**
+ * 删除支付项参数
+ */
+
+/**
+ * 现金支付接口
+ */
+
+/**
+ * Eftpos支付接口
+ */
+
+/**
+ * 钱包支付接口
+ */
+
+/**
+ * 支付模块API接口
+ */
+
+/**
+ * 订单变化事件数据
+ */
+
+/**
+ * 支付方式变化事件数据
+ */
+
+/**
+ * 支付同步错误事件数据
+ */
+
+/**
+ * 支付同步成功事件数据
+ */
+
+/**
+ * 支付钩子事件
+ */
+export var PaymentHooks = /*#__PURE__*/function (PaymentHooks) {
+  PaymentHooks["OnPaymentMethodsLoaded"] = "payment:onPaymentMethodsLoaded";
+  PaymentHooks["OnPaymentMethodsChanged"] = "payment:onPaymentMethodsChanged";
+  PaymentHooks["OnOrderChanged"] = "payment:onOrderChanged";
+  PaymentHooks["OnOrderAdded"] = "payment:onOrderAdded";
+  PaymentHooks["OnOrderUpdated"] = "payment:onOrderUpdated";
+  PaymentHooks["OnOrderDeleted"] = "payment:onOrderDeleted";
+  PaymentHooks["OnPaymentAdded"] = "payment:onPaymentAdded";
+  PaymentHooks["OnPaymentUpdated"] = "payment:onPaymentUpdated";
+  PaymentHooks["OnPaymentDeleted"] = "payment:onPaymentDeleted";
+  PaymentHooks["OnPaymentSubmitted"] = "payment:onPaymentSubmitted";
+  PaymentHooks["OnOrderAmountChanged"] = "payment:onOrderAmountChanged";
+  PaymentHooks["OnPaymentSyncError"] = "payment:onPaymentSyncError";
+  PaymentHooks["OnPaymentSyncSuccess"] = "payment:onPaymentSyncSuccess";
+  return PaymentHooks;
+}({});

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

@@ -0,0 +1,11 @@
+import { WalletPayment } from './types';
+import type { PaymentModule } from './index';
+/**
+ * 钱包支付实现
+ */
+export declare class WalletPaymentImpl implements WalletPayment {
+    private paymentModule;
+    constructor(paymentModule: PaymentModule);
+    processWalletPayment(amount: number, orderUuid: string, voucherId?: string): Promise<void>;
+    getWalletBalance(voucherId: string): Promise<number>;
+}