@pisell/pisellos 3.0.56 → 3.0.57

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

@@ -0,0 +1,550 @@
+import { Module } from '../../types';
+import { OrderModule } from '../../modules/Order';
+import { PaymentModule, PaymentModuleAPI, PaymentOrder, PaymentMethod, PaymentStatus } from '../../modules/Payment';
+import { CartItem } from '../../modules/Cart/types';
+/**
+ * 结账状态枚举
+ */
+export declare enum CheckoutStatus {
+    /** 初始化中 */
+    Initializing = "initializing",
+    /** 准备就绪 */
+    Ready = "ready",
+    /** 创建订单中 */
+    CreatingOrder = "creating_order",
+    /** 订单已创建 */
+    OrderCreated = "order_created",
+    /** 处理支付中 */
+    ProcessingPayment = "processing_payment",
+    /** 支付完成 */
+    PaymentCompleted = "payment_completed",
+    /** 结账完成 */
+    Completed = "completed",
+    /** 已取消 */
+    Cancelled = "cancelled",
+    /** 错误状态 */
+    Error = "error"
+}
+/**
+ * 结账步骤枚举
+ */
+export declare enum CheckoutStep {
+    /** 订单确认 */
+    OrderConfirmation = "order_confirmation",
+    /** 支付方式选择 */
+    PaymentMethod = "payment_method",
+    /** 支付处理 */
+    PaymentProcessing = "payment_processing",
+    /** 完成 */
+    Complete = "complete"
+}
+/**
+ * 结账错误类型
+ */
+export declare enum CheckoutErrorType {
+    /** 订单创建失败 */
+    OrderCreationFailed = "order_creation_failed",
+    /** 支付失败 */
+    PaymentFailed = "payment_failed",
+    /** 验证失败 */
+    ValidationFailed = "validation_failed",
+    /** 网络错误 */
+    NetworkError = "network_error",
+    /** 未知错误 */
+    UnknownError = "unknown_error"
+}
+/**
+ * 结账错误信息
+ */
+export interface CheckoutError {
+    /** 错误类型 */
+    type: CheckoutErrorType;
+    /** 错误消息 */
+    message: string;
+    /** 错误详情 */
+    details?: any;
+    /** 错误时间戳 */
+    timestamp: number;
+}
+/**
+ * 结账初始化参数
+ */
+export interface CheckoutInitParams {
+    /** 购物车商品 */
+    cartItems: CartItem[];
+    /** 订单类型 */
+    orderType?: 'virtual' | 'appointment_booking';
+    /** 平台类型 */
+    platform?: 'pc' | 'h5';
+    /** 自动进入支付 */
+    autoPayment?: boolean;
+}
+/**
+ * 购物车小计项
+ */
+export interface CartSummaryItem {
+    /** 项目键名 */
+    key: string;
+    /** 项目值 */
+    value: number;
+    /** 是否隐藏显示 */
+    hidden?: boolean;
+    /** 显示标签 */
+    label?: string;
+    /** 税费详情 (当 key 为 tax 时) */
+    tax?: Record<string, any>;
+}
+/**
+ * 从购物车小计提取的金额信息
+ */
+export interface ExtractedAmountInfo {
+    /** 总金额 (expect_amount) */
+    totalAmount: string;
+    /** 小计 (sub_total) */
+    subTotal: string;
+    /** 税费 (tax) */
+    taxAmount: string;
+    /** 折扣 (discount) */
+    discountAmount: string;
+    /** 商店折扣 (shop_discount) */
+    shopDiscountAmount: string;
+    /** 四舍五入金额 (custom_roundingAmount) */
+    roundingAmount: string;
+    /** 定金金额 (如果是定金订单) */
+    depositAmount?: string;
+    /** 税费详情 */
+    taxDetails?: Record<string, any>;
+}
+/**
+ * 本地订单创建参数
+ */
+export interface CreateLocalOrderParams {
+    /** 订单数据 (来自购物车的完整订单参数) */
+    orderData: LocalOrderData;
+    /** 购物车小计数据 */
+    cartSummary: CartSummaryItem[];
+    /** 是否自动进入支付流程 */
+    autoPayment?: boolean;
+}
+/**
+ * 手动下单参数
+ */
+export interface PlaceOrderParams {
+    /** 订单提交的 URL (可选，默认使用 /order/appointment) */
+    url?: string;
+    /** 是否自动替换虚拟订单ID为真实订单ID */
+    autoReplaceOrderId?: boolean;
+}
+/**
+ * 本地订单数据结构 (基于 appointmentDemo.json)
+ */
+export interface LocalOrderData {
+    /** 订单类型 */
+    type: 'appointment_booking' | 'virtual';
+    /** 平台 */
+    platform: 'PC' | 'H5';
+    /** 销售渠道 */
+    sales_channel: string;
+    /** 订单销售渠道 */
+    order_sales_channel: string;
+    /** 预订信息 */
+    bookings: LocalBookingItem[];
+    /** 商店备注 */
+    shop_note: string;
+    /** 预约日期 */
+    schedule_date: string;
+    /** 是否定金 */
+    is_deposit: number;
+    /** 关联商品 */
+    relation_products: any[];
+    /** 关联表单 */
+    relation_forms: any[];
+}
+/**
+ * 本地预订项
+ */
+export interface LocalBookingItem {
+    /** ID */
+    id: number;
+    /** 数量 */
+    number: number;
+    /** 注册类型 */
+    registration_type: string;
+    /** 关联商品 */
+    relation_products: any[];
+    /** 是否全部 */
+    is_all: boolean;
+    /** 商品信息 */
+    product: LocalProductInfo;
+    /** 子类型 */
+    sub_type: string;
+    /** 时长 */
+    duration: number;
+    /** 喜好状态 */
+    like_status: string;
+    /** 资源列表 */
+    resources: LocalResourceItem[];
+    /** 预约ID */
+    schedule_id: number;
+    /** 开始日期 */
+    start_date: string;
+    /** 开始时间 */
+    start_time: string;
+    /** 选择日期 */
+    select_date: string;
+    /** 结束时间 */
+    end_time: string;
+    /** 结束日期 */
+    end_date: string;
+    /** 元数据 */
+    metadata: {
+        account?: {
+            id: number;
+            username: string;
+        };
+        capacity?: Array<{
+            id: number;
+            value: number;
+            name: string;
+        }>;
+    };
+    /** 持有者 */
+    holder: any;
+    /** 关联表单 */
+    relation_forms: any[];
+}
+/**
+ * 本地商品信息
+ */
+export interface LocalProductInfo {
+    /** 数量 */
+    num: number;
+    /** 商品ID */
+    product_id: number;
+    /** 商品变体ID */
+    product_variant_id: number;
+    /** 商品套装 */
+    product_bundle: any[];
+    /** 商品选项 */
+    product_option_item: any[];
+    /** 折扣列表 */
+    discount_list: LocalDiscountItem[];
+}
+/**
+ * 本地折扣项
+ */
+export interface LocalDiscountItem {
+    /** 金额 */
+    amount: number;
+    /** 类型 */
+    type: string;
+    /** 折扣详情 */
+    discount: {
+        resource_id: number;
+        title: {
+            auto: string;
+            original: string;
+            en?: string;
+            'zh-CN'?: string;
+            'zh-HK'?: string;
+        };
+        original_amount: number;
+        product_id: number;
+        percent: string;
+    };
+}
+/**
+ * 本地资源项
+ */
+export interface LocalResourceItem {
+    /** 关联类型 */
+    relation_type: string;
+    /** 喜好状态 */
+    like_status: string;
+    /** 表单ID */
+    form_id: number;
+    /** 关联ID */
+    relation_id: number;
+    /** 容量 */
+    capacity: number;
+    /** 元数据 */
+    metadata: {
+        combined_resource?: {
+            status: number;
+            resource_ids: number[];
+        } | null;
+        form_name: string;
+        resource_name: string;
+    };
+    /** 子资源 */
+    children?: LocalResourceItem[];
+    /** ID (可选) */
+    id?: number;
+    /** 主字段 (可选) */
+    main_field?: string;
+    /** 资源类型 (可选) */
+    resourceType?: string;
+}
+/**
+ * 订单创建参数
+ */
+export interface CreateOrderParams {
+    /** 购物车商品 */
+    cartItems: CartItem[];
+    /** 订单类型 */
+    type?: 'virtual' | 'appointment_booking';
+    /** 平台类型 */
+    platform?: 'pc' | 'h5';
+    /** 额外参数 */
+    extra?: Record<string, any>;
+}
+/**
+ * 支付处理参数
+ */
+export interface ProcessPaymentParams {
+    /** 订单UUID */
+    orderUuid: string;
+    /** 支付方式代码 */
+    paymentMethodCode: string;
+    /** 支付金额 */
+    amount: string | number;
+    /** 支付元数据 */
+    metadata?: Record<string, any>;
+}
+/**
+ * 结账状态信息
+ */
+export interface CheckoutStatusInfo {
+    /** 当前状态 */
+    status: CheckoutStatus;
+    /** 当前步骤 */
+    step: CheckoutStep;
+    /** 进度百分比 (0-100) */
+    progress: number;
+    /** 状态消息 */
+    message?: string;
+    /** 错误信息 */
+    error?: CheckoutError;
+}
+/**
+ * 结账摘要信息
+ */
+export interface CheckoutSummary {
+    /** 订单信息 */
+    order?: PaymentOrder;
+    /** 总金额 */
+    totalAmount: string;
+    /** 已支付金额 */
+    paidAmount: string;
+    /** 待支付金额 */
+    remainingAmount: string;
+    /** 支付状态 */
+    paymentStatus: PaymentStatus;
+    /** 可用支付方式 */
+    availablePaymentMethods: PaymentMethod[];
+}
+/**
+ * 结账事件钩子
+ */
+export declare enum CheckoutHooks {
+    /** 结账初始化完成 */
+    OnCheckoutInitialized = "checkout:onInitialized",
+    /** 状态变更 */
+    OnStatusChanged = "checkout:onStatusChanged",
+    /** 步骤变更 */
+    OnStepChanged = "checkout:onStepChanged",
+    /** 订单创建成功 */
+    OnOrderCreated = "checkout:onOrderCreated",
+    /** 订单创建失败 */
+    OnOrderCreationFailed = "checkout:onOrderCreationFailed",
+    /** 支付开始 */
+    OnPaymentStarted = "checkout:onPaymentStarted",
+    /** 支付成功 */
+    OnPaymentSuccess = "checkout:onPaymentSuccess",
+    /** 支付失败 */
+    OnPaymentFailed = "checkout:onPaymentFailed",
+    /** 结账完成 */
+    OnCheckoutCompleted = "checkout:onCompleted",
+    /** 结账取消 */
+    OnCheckoutCancelled = "checkout:onCancelled",
+    /** 错误发生 */
+    OnError = "checkout:onError"
+}
+/**
+ * 结账状态数据
+ */
+export interface CheckoutState {
+    /** 订单模块 */
+    order: OrderModule;
+    /** 支付模块 */
+    payment: PaymentModule;
+    /** 当前状态 */
+    status: CheckoutStatus;
+    /** 当前步骤 */
+    step: CheckoutStep;
+    /** 当前订单 */
+    currentOrder?: PaymentOrder;
+    /** 购物车商品 */
+    cartItems: CartItem[];
+    /** 本地订单数据 */
+    localOrderData?: LocalOrderData;
+    /** 可用支付方式 */
+    paymentMethods: PaymentMethod[];
+    /** 错误信息 */
+    lastError?: CheckoutError;
+}
+/**
+ * 当前订单基础信息
+ */
+export interface CurrentOrderInfo {
+    /** 订单UUID */
+    uuid?: string;
+    /** 订单ID */
+    orderId?: string;
+    /** 订单状态 */
+    status?: CheckoutStatus;
+    /** 当前步骤 */
+    step?: CheckoutStep;
+    /** 订单总金额 */
+    totalAmount?: string;
+    /** 待付金额 */
+    remainingAmount?: string;
+    /** 支付状态 */
+    paymentStatus?: PaymentStatus;
+    /** 是否为定金订单 */
+    isDeposit?: boolean;
+    /** 定金金额 */
+    depositAmount?: string;
+    /** 订单类型 */
+    orderType?: 'virtual' | 'appointment_booking';
+    /** 平台类型 */
+    platform?: 'pc' | 'h5';
+    /** 创建时间 */
+    createdAt?: string;
+    /** 商品数量 */
+    itemCount?: number;
+    /** 是否有本地订单数据 */
+    hasLocalOrderData?: boolean;
+}
+/**
+ * 结账解决方案 API 接口
+ */
+export interface CheckoutModuleAPI extends Module {
+    /**
+     * 初始化结账流程
+     */
+    initializeCheckoutAsync(params: CheckoutInitParams): Promise<void>;
+    /**
+     * 创建本地订单 (前端模拟下单流程)
+     */
+    createLocalOrderAsync(params: CreateLocalOrderParams): Promise<PaymentOrder>;
+    /**
+     * 手动下单 (根据虚拟订单生成实际订单)
+     */
+    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(): PaymentModuleAPI;
+    /**
+     * 替换本地订单ID为真实订单ID
+     */
+    replaceLocalOrderIdAsync(newOrderId: string): Promise<PaymentOrder | null>;
+}
+/**
+ * 结账事件数据类型
+ */
+export interface CheckoutEventData {
+    /** 状态变更事件 */
+    statusChanged: {
+        oldStatus: CheckoutStatus;
+        newStatus: CheckoutStatus;
+        timestamp: number;
+    };
+    /** 步骤变更事件 */
+    stepChanged: {
+        oldStep: CheckoutStep;
+        newStep: CheckoutStep;
+        timestamp: number;
+    };
+    /** 订单创建事件 */
+    orderCreated: {
+        order: PaymentOrder;
+        timestamp: number;
+    };
+    /** 支付事件 */
+    paymentEvent: {
+        orderUuid: string;
+        paymentMethodCode: string;
+        amount: string;
+        timestamp: number;
+    };
+    /** 错误事件 */
+    error: {
+        error: CheckoutError;
+        context?: any;
+        timestamp: number;
+    };
+}

package/lib/solution/Checkout/types.js

@@ -0,0 +1,75 @@
+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/solution/Checkout/types.ts
+var types_exports = {};
+__export(types_exports, {
+  CheckoutErrorType: () => CheckoutErrorType,
+  CheckoutHooks: () => CheckoutHooks,
+  CheckoutStatus: () => CheckoutStatus,
+  CheckoutStep: () => CheckoutStep
+});
+module.exports = __toCommonJS(types_exports);
+var CheckoutStatus = /* @__PURE__ */ ((CheckoutStatus2) => {
+  CheckoutStatus2["Initializing"] = "initializing";
+  CheckoutStatus2["Ready"] = "ready";
+  CheckoutStatus2["CreatingOrder"] = "creating_order";
+  CheckoutStatus2["OrderCreated"] = "order_created";
+  CheckoutStatus2["ProcessingPayment"] = "processing_payment";
+  CheckoutStatus2["PaymentCompleted"] = "payment_completed";
+  CheckoutStatus2["Completed"] = "completed";
+  CheckoutStatus2["Cancelled"] = "cancelled";
+  CheckoutStatus2["Error"] = "error";
+  return CheckoutStatus2;
+})(CheckoutStatus || {});
+var CheckoutStep = /* @__PURE__ */ ((CheckoutStep2) => {
+  CheckoutStep2["OrderConfirmation"] = "order_confirmation";
+  CheckoutStep2["PaymentMethod"] = "payment_method";
+  CheckoutStep2["PaymentProcessing"] = "payment_processing";
+  CheckoutStep2["Complete"] = "complete";
+  return CheckoutStep2;
+})(CheckoutStep || {});
+var CheckoutErrorType = /* @__PURE__ */ ((CheckoutErrorType2) => {
+  CheckoutErrorType2["OrderCreationFailed"] = "order_creation_failed";
+  CheckoutErrorType2["PaymentFailed"] = "payment_failed";
+  CheckoutErrorType2["ValidationFailed"] = "validation_failed";
+  CheckoutErrorType2["NetworkError"] = "network_error";
+  CheckoutErrorType2["UnknownError"] = "unknown_error";
+  return CheckoutErrorType2;
+})(CheckoutErrorType || {});
+var CheckoutHooks = /* @__PURE__ */ ((CheckoutHooks2) => {
+  CheckoutHooks2["OnCheckoutInitialized"] = "checkout:onInitialized";
+  CheckoutHooks2["OnStatusChanged"] = "checkout:onStatusChanged";
+  CheckoutHooks2["OnStepChanged"] = "checkout:onStepChanged";
+  CheckoutHooks2["OnOrderCreated"] = "checkout:onOrderCreated";
+  CheckoutHooks2["OnOrderCreationFailed"] = "checkout:onOrderCreationFailed";
+  CheckoutHooks2["OnPaymentStarted"] = "checkout:onPaymentStarted";
+  CheckoutHooks2["OnPaymentSuccess"] = "checkout:onPaymentSuccess";
+  CheckoutHooks2["OnPaymentFailed"] = "checkout:onPaymentFailed";
+  CheckoutHooks2["OnCheckoutCompleted"] = "checkout:onCompleted";
+  CheckoutHooks2["OnCheckoutCancelled"] = "checkout:onCancelled";
+  CheckoutHooks2["OnError"] = "checkout:onError";
+  return CheckoutHooks2;
+})(CheckoutHooks || {});
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  CheckoutErrorType,
+  CheckoutHooks,
+  CheckoutStatus,
+  CheckoutStep
+});

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

@@ -0,0 +1,73 @@
+import { CheckoutInitParams, CheckoutError, CheckoutErrorType, CheckoutStatus, CheckoutStep } from '../types';
+/**
+ * 验证结账数据
+ */
+export declare function validateCheckoutData(params: CheckoutInitParams): {
+    valid: boolean;
+    errors: string[];
+};
+/**
+ * 创建结账错误对象
+ */
+export declare function createCheckoutError(type: CheckoutErrorType, message: string, details?: any): CheckoutError;
+/**
+ * 计算结账进度
+ */
+export declare function calculateProgress(status: CheckoutStatus, step: CheckoutStep): number;
+/**
+ * 格式化金额
+ */
+export declare function formatAmount(amount: string | number): string;
+/**
+ * 验证金额
+ */
+export declare function validateAmount(amount: string | number): boolean;
+/**
+ * 生成唯一订单ID
+ */
+export declare function generateOrderId(prefix?: string): string;
+/**
+ * 检查是否为有效的支付方式代码
+ */
+export declare function isValidPaymentMethodCode(code: string): boolean;
+/**
+ * 安全地解析JSON
+ */
+export declare function safeJsonParse<T>(jsonString: string, defaultValue: T): T;
+/**
+ * 深度克隆对象
+ */
+export declare function deepClone<T>(obj: T): T;
+/**
+ * 防抖函数
+ */
+export declare function debounce<T extends (...args: any[]) => any>(func: T, wait: number): (...args: Parameters<T>) => void;
+/**
+ * 节流函数
+ */
+export declare function throttle<T extends (...args: any[]) => any>(func: T, wait: number): (...args: Parameters<T>) => void;
+/**
+ * 重试函数
+ */
+export declare function retry<T>(fn: () => Promise<T>, maxAttempts?: number, delay?: number): Promise<T>;
+/**
+ * 检查对象是否为空
+ */
+export declare function isEmpty(obj: any): boolean;
+/**
+ * 获取错误消息
+ */
+export declare function getErrorMessage(error: unknown): string;
+/**
+ * 检查是否为生产环境
+ */
+export declare function isProduction(): boolean;
+/**
+ * 日志记录器
+ */
+export declare const logger: {
+    info: (message: string, ...args: any[]) => void;
+    warn: (message: string, ...args: any[]) => void;
+    error: (message: string, ...args: any[]) => void;
+    debug: (message: string, ...args: any[]) => void;
+};