@pisell/pisellos 0.0.229 → 0.0.230

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

@@ -0,0 +1,181 @@
+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 } from './types';
+import { PaymentOrder, PaymentMethod } from '../../modules/Payment/types';
+export * from './types';
+/**
+ * 结账解决方案实现
+ *
+ * 整合订单处理和支付功能，提供完整的结账流程管理。
+ * 支持多种支付方式，提供实时状态跟踪和错误处理。
+ */
+export declare class CheckoutImpl extends BaseModule implements Module, CheckoutModuleAPI {
+    protected defaultName: string;
+    protected defaultVersion: string;
+    isSolution: boolean;
+    private request;
+    private store;
+    private otherParams;
+    constructor(name?: string, version?: string);
+    initialize(core: PisellCore, options: ModuleOptions): Promise<void>;
+    /**
+     * 初始化子模块
+     */
+    private initializeSubModules;
+    /**
+     * 设置支付模块事件监听
+     */
+    private setupPaymentEventListeners;
+    /**
+     * 初始化结账流程
+     */
+    initializeCheckoutAsync(params: CheckoutInitParams): Promise<void>;
+    /**
+     * 创建本地订单 (前端模拟下单流程)
+     *
+     * 此方法用于在前端模拟整个下单流程，创建一个本地的虚拟订单。
+     * 用户在购物车点击下单时，会把购物车参数传递给此方法，
+     * 方法会记录参数并创建本地虚拟订单，然后用 Payment 模块管理支付流程。
+     */
+    createLocalOrderAsync(params: CreateLocalOrderParams): Promise<PaymentOrder>;
+    /**
+     * 手动下单 (根据虚拟订单生成实际订单)
+     *
+     * 使用当前存储的本地订单数据调用 Order 模块创建真实订单
+     */
+    placeOrderAsync(params?: PlaceOrderParams): Promise<{
+        success: boolean;
+        orderId?: string;
+        error?: string;
+    }>;
+    /**
+     * 创建订单
+     */
+    createOrderAsync(params: CreateOrderParams): Promise<PaymentOrder>;
+    /**
+     * 处理支付
+     */
+    processPaymentAsync(params: ProcessPaymentParams): Promise<void>;
+    /**
+     * 完成结账
+     */
+    completeCheckoutAsync(): Promise<{
+        success: boolean;
+        orderId?: string;
+    }>;
+    /**
+     * 取消结账
+     */
+    cancelCheckoutAsync(): Promise<void>;
+    /**
+     * 获取结账状态
+     */
+    getCheckoutStatus(): CheckoutStatusInfo;
+    /**
+     * 获取结账摘要
+     */
+    getCheckoutSummaryAsync(): Promise<CheckoutSummary>;
+    /**
+     * 获取可用支付方式
+     */
+    getAvailablePaymentMethodsAsync(): Promise<PaymentMethod[]>;
+    /**
+     * 刷新支付方式缓存
+     *
+     * 强制重新从服务器获取支付方式列表，更新本地缓存
+     */
+    refreshPaymentMethodsAsync(): Promise<PaymentMethod[]>;
+    /**
+     * 获取当前订单基础信息
+     *
+     * 返回当前订单的基础信息，包括订单状态、金额、支付状态等
+     */
+    getCurrentOrderInfo(): CurrentOrderInfo | null;
+    /**
+     * 验证结账前置条件
+     */
+    validateCheckoutAsync(): Promise<{
+        valid: boolean;
+        errors: string[];
+    }>;
+    /**
+     * 重试失败的操作
+     */
+    retryFailedOperationAsync(): Promise<void>;
+    /**
+     * 设置当前步骤
+     */
+    setCurrentStep(step: CheckoutStep): void;
+    /**
+     * 获取订单模块
+     */
+    getOrderModule(): OrderModule;
+    /**
+     * 获取支付模块
+     */
+    getPaymentModule(): PaymentModule;
+    /**
+     * 替换本地订单ID为真实订单ID
+     *
+     * 当后端订单创建完成后，调用此方法将本地虚拟订单ID替换为真实订单ID
+     *
+     * @param newOrderId 后端返回的真实订单ID
+     * @returns 更新后的订单对象，如果当前没有订单则返回null
+     */
+    replaceLocalOrderIdAsync(newOrderId: string): Promise<PaymentOrder | null>;
+    /**
+     * 设置状态
+     */
+    private setStatus;
+    /**
+     * 设置步骤
+     */
+    private setStep;
+    /**
+     * 处理错误
+     */
+    private handleError;
+    /**
+     * 处理支付成功
+     */
+    private handlePaymentSuccess;
+    /**
+     * 处理支付错误
+     */
+    private handlePaymentError;
+    /**
+     * 验证结账参数
+     */
+    private validateCheckoutParams;
+    /**
+     * 验证本地订单数据
+     */
+    private validateLocalOrderData;
+    /**
+     * 生成本地订单ID
+     */
+    private generateLocalOrderId;
+    /**
+     * 从购物车小计数据中提取金额信息
+     */
+    private extractAmountFromCartSummary;
+    /**
+     * 预加载支付方式（在初始化时调用）
+     */
+    private preloadPaymentMethods;
+    /**
+     * 计算总金额
+     */
+    private calculateTotalAmount;
+    /**
+     * 计算已支付金额
+     */
+    private calculatePaidAmount;
+    /**
+     * 获取状态消息
+     */
+    private getStatusMessage;
+    destroy(): Promise<void>;
+}