@pisell/private-materials 6.6.7 → 6.6.8

package/lib/components/checkout/types.d.ts

@@ -0,0 +1,130 @@
+/// <reference types="react" />
+export interface CurrentOrderInfo {
+    /** 订单UUID */
+    uuid?: string;
+    /** 订单ID */
+    orderId?: string;
+    /** 订单状态 */
+    status?: string;
+    /** 当前步骤 */
+    step?: string;
+    /** 订单总金额 */
+    totalAmount?: string;
+    /** 待付金额 */
+    remainingAmount?: string;
+    /** 支付状态 */
+    paymentStatus?: string;
+    /** 是否为定金订单 */
+    isDeposit?: boolean;
+    /** 定金金额 */
+    depositAmount?: string;
+    /** 订单类型 */
+    orderType?: 'virtual' | 'appointment_booking';
+    /** 平台类型 */
+    platform?: 'pc' | 'h5';
+    /** 创建时间 */
+    createdAt?: string;
+    /** 商品数量 */
+    itemCount?: number;
+    /** 是否有本地订单数据 */
+    hasLocalOrderData?: boolean;
+}
+export interface PaymentData {
+    orderId?: string | number;
+    totalAmount?: number;
+    currency?: string;
+    customerId?: string | number;
+    customerName?: string;
+    description?: string;
+    items?: PaymentItem[];
+}
+export interface PaymentItem {
+    id: string | number;
+    name: string;
+    quantity: number;
+    price: number;
+    total: number;
+}
+export interface ModuleConfig {
+    showWalletPass?: boolean;
+    showCashPayment?: boolean;
+    showAdditionalModule?: boolean;
+    showPaymentOptions?: boolean;
+}
+export interface StatusConfig {
+    leftStatus?: string;
+    rightStatus?: string;
+}
+export interface PaymentResult {
+    type: 'cash' | 'walletpass' | 'etfpos' | 'custom' | 'mx51';
+    amount?: number;
+    status: 'success' | 'failed' | 'cancelled' | 'pending';
+    orderId?: string | number;
+    transactionId?: string;
+    message?: string;
+    timestamp?: number;
+    roundingAmount?: number;
+}
+export interface CheckoutCallbacks {
+    onPaymentComplete?: (result: PaymentResult) => void;
+    onPaymentCancel?: () => void;
+    onStatusChange?: (status: string) => void;
+}
+export interface CheckoutProps {
+    paymentData?: PaymentData;
+    moduleConfig?: ModuleConfig;
+    statusConfig?: StatusConfig;
+    cashAmountButtons?: number[];
+    onPaymentComplete?: (result: PaymentResult) => void;
+    onPaymentCancel?: () => void;
+    onStatusChange?: (status: string) => void;
+}
+export interface StatusSectionProps {
+    config?: StatusConfig;
+    onStatusChange?: (status: string) => void;
+}
+export interface AmountSummaryProps {
+    orderInfo?: CurrentOrderInfo;
+    open_deposit?: boolean;
+    customAmount?: string;
+    onAmountChange?: (amount: string) => void;
+}
+export interface WalletPassModuleProps {
+    orderInfo?: CurrentOrderInfo;
+}
+export interface CashPaymentModuleProps {
+    orderInfo?: CurrentOrderInfo;
+    onPaymentComplete?: (result: PaymentResult) => void;
+    amountButtons?: number[];
+}
+export interface PaymentOptionsModuleProps {
+    orderInfo?: CurrentOrderInfo;
+    onClick?: (method: PaymentMethod) => void;
+}
+export interface AdditionalModuleProps {
+    orderInfo?: CurrentOrderInfo;
+    customAmount?: string;
+    handleButtonClick: (key: string) => void;
+    hasOrderNote?: boolean;
+}
+export interface PaymentMethod {
+    id: string;
+    name: string;
+    nameEn?: string;
+    surcharge: string;
+    surchargeAmount?: number;
+    icon?: string;
+    iconComponent?: React.ReactNode;
+    color?: string;
+    enabled?: boolean;
+    code: string;
+    type: string;
+    fixed?: number;
+    percentage?: number;
+    totalAmount?: string;
+}
+export interface PaymentMethodSelection {
+    method: PaymentMethod;
+    amount: number;
+    totalWithSurcharge: number;
+}

package/lib/components/checkout/utils.d.ts

@@ -0,0 +1,3 @@
+import { PaymentMethod } from './types';
+export declare const getShopWalletPassId: (interaction: any) => Promise<string | null>;
+export declare const reorderPaymentMethodList: (paymentMethodList: PaymentMethod[], interaction: any) => Promise<PaymentMethod[]>;

package/lib/components/eftpos/form/index.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 /**
  * @title: 递归循环表单数据
  * @Author: hongbing.wang

package/lib/components/eftpos/hooks.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 import { Eftpos } from './const';
 /**
  * @title: tyro 设备连接

package/lib/components/eftpos/index.d.ts

@@ -1,3 +1,4 @@
+/// <reference types="react" />
 import { Eftpos, DeviceStatus } from './const';
 import './index.less';
 interface PosProps {

package/lib/components/eftpos/pos.d.ts

@@ -1,3 +1,4 @@
+/// <reference types="react" />
 import { DeviceProp } from "./const";
 interface PosProps {
     eftposName: string;

package/lib/components/eftpos/surcharge/index.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 import './index.css';
 /**
  * @title: 自定义组件设置

package/lib/components/eftposPay/amount.d.ts

@@ -1,3 +1,4 @@
+/// <reference types="react" />
 import { PosProps } from './const';
 /**
  * @title: 支付金额信息配置页
@@ -8,7 +9,7 @@ import { PosProps } from './const';
  */
 declare const _default: ({ className, onChange, onClose, formatAmount, isMobile, net, client }: {
     className?: string | undefined;
-    onChange?: ((status: "success" | "page" | "fail" | "print" | "mark_tx_processed", params?: string | {
+    onChange?: ((status: "page" | "success" | "print" | "fail" | "mark_tx_processed", params?: string | {
         [keys: string]: unknown;
     } | undefined, other?: any) => void) | undefined;
     onClose: () => void;

package/lib/components/eftposPay/app.d.ts

@@ -0,0 +1,10 @@
+import { PosProps, RouteType } from './const';
+declare const App: ({ action, api, device_number, terminal, tyroUrl, tyroVersion, onChangeParams, isMobile, channel, formatAmount, ...props }: Omit<PosProps, "type" | "mode" | "getApi"> & {
+    action: RouteType;
+    device_number: string | number;
+    api: ReturnType<PosProps['getApi']>;
+    isMobile: boolean;
+    channel?: string | undefined;
+    formatAmount(amount: number | string, precision: number, symbol: string): string;
+}) => JSX.Element;
+export default App;

package/lib/components/eftposPay/component/fail/failCustom.d.ts

@@ -1,3 +1,4 @@
+/// <reference types="react" />
 import { ActionProps } from '../../const';
 declare const _default: ({ className, isMobile, onChange }: ActionProps) => JSX.Element;
 export default _default;

package/lib/components/eftposPay/component/fail/network.d.ts

@@ -1,3 +1,4 @@
+/// <reference types="react" />
 import { ActionProps } from '../../const';
 /**
  * @title: 断网(客户端)提示页

package/lib/components/eftposPay/component/fail/unknow.d.ts

@@ -1,3 +1,4 @@
+/// <reference types="react" />
 import { ActionProps } from '../../const';
 /**
  * @title: 支付状态未知页面

package/lib/components/eftposPay/component/manual/index.d.ts

@@ -1,3 +1,4 @@
+/// <reference types="react" />
 import { ActionProps } from '../../const';
 import './index.less';
 /**

package/lib/components/eftposPay/component/signature/index.d.ts

@@ -1,3 +1,4 @@
+/// <reference types="react" />
 import { ActionProps } from '../../const';
 /**
  * @title: 取消签名确认页

package/lib/components/eftposPay/component/step/index.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 import { StatusType } from '../../const';
 declare const _default: (props: {
     status: StatusType;

package/lib/components/eftposPay/const.d.ts

@@ -0,0 +1,190 @@
+import { CSSProperties } from 'react';
+export declare enum EftposEnum {
+    /** 后端支付 - 仅支付  */
+    Payo = "payo",
+    /** 前端支付 */
+    Tyro = "tyro",
+    /** 后端支付 - 支付 + 退款  */
+    Windcave = "windcave",
+    Stripe = "stripe",
+    Linkly = "linkly"
+}
+export declare enum StatusEnum {
+    Loading = "loading",
+    Warn = "warn",
+    Fail = "fail",
+    Success = "success",
+    Pedding = "pedding",
+    Resove = "resove",
+    Reject = "reject",
+    Question = "question"
+}
+export declare enum ModeEnum {
+    /** 支付 */
+    Pay = "pay",
+    /** 完整支付 */
+    FullPay = "fullPay",
+    /** 退款 */
+    Refund = "refund",
+    /** 查询 */
+    Query = "query"
+}
+/**
+ * 崩溃恢复
+ */
+export declare enum RestoreEumn {
+    /** 常规  */
+    Normal = "normal",
+    /** 恢复 */
+    Restore = "restore"
+}
+/**
+ * 订单状态
+ */
+export declare enum OrderEumn {
+    /** 恢复  */
+    Restore = "restore",
+    /** 常规  */
+    Normal = "normal",
+    /** 成功 */
+    Succeed = "succeed",
+    /** 失败 */
+    Failed = "failed",
+    /** 等待 */
+    Pending = "pending",
+    /** 没有订单状态 */
+    Null = "null"
+}
+export declare enum ClientEnum {
+    /** 用户端 */
+    User = "user",
+    /** 商家端 */
+    Merchant = "merchant"
+}
+export declare enum RouteEnum {
+    /** 改价页 */
+    Amount = "amount",
+    /** 门店列表页 */
+    DeviceList = "deviceList",
+    /**支付页 */
+    Pay = "pay"
+}
+export declare enum PayRouteEnum {
+    Step = "step",
+    Unset = "unset"
+}
+export declare type RouteType = `${RouteEnum}`;
+export declare type PayRouteType = `${PayRouteEnum}`;
+export declare type DeviceStatusType = `${EftposEnum}`;
+export declare type StatusType = `${StatusEnum}`;
+export declare type ModeType = `${ModeEnum}`;
+export interface PosProps {
+    /** 厂商类型 */
+    type: DeviceStatusType;
+    getApi: () => {
+        [key: string]: (...agrn: unknown[]) => Promise<unknown>;
+    };
+    params: {
+        [key: string]: unknown;
+    };
+    /** 回调 */
+    onChangeStatus: (status: `${StatusEnum.Success}` | `${StatusEnum.Fail}` | 'page' | 'print' | 'mark_tx_processed', params?: {
+        [keys: string]: unknown;
+    } | string, other?: any) => void;
+    onChangeParams(...agrn: unknown[]): void;
+    terminal: {
+        network: boolean;
+    };
+    device?: {
+        [key: string]: unknown;
+    };
+    mode: ModeEnum;
+    tyroUrl?: string;
+    tyroVersion?: string;
+    source: 'normal' | 'restore';
+    styles?: {
+        device?: CSSProperties;
+        [key: string]: CSSProperties | undefined;
+    };
+    isWebPos?: boolean;
+}
+export interface PayProps {
+    api: ReturnType<PosProps['getApi']>;
+    onChange: PosProps['onChangeStatus'];
+    className?: string;
+}
+export declare type Amount = {
+    name: string;
+    /** 订单金额 */
+    money: number;
+    /** 上一轮操作订单金额 */
+    amount: number;
+    /** 金额单位 */
+    symbol: string;
+    /** 手续费-百分率 */
+    surRate: number;
+    /** 手续费-是否开启 */
+    surMoney: number;
+    /** 手续费-是否存在 */
+    surcharge: boolean;
+    /** 是否使用原始手续费 */
+    useOriginSurcharge: boolean;
+};
+export declare type PayAmount = {
+    /** 手续费-百分比-带百分号  例: 1% =》 数据为 0.01 */
+    surPercentRate: string;
+    /** 手续费-百分比-不带百分号  例:1%  =》 数据为 1 */
+    surRate: string;
+    /** 手续费-比例金额   amount * surPercentRate  */
+    surRateMoney: string;
+    /** 手续费-固定金额 */
+    surMoney: string;
+    /** 手续费 =   surPercentRate + surMoney */
+    surcharge: string;
+    /** 支付金额 (不包含手续费) */
+    amount: string;
+    /** 支付总金额 =  amount + surcharge */
+    total: string;
+    /** 订单金额  */
+    sourceAmount: string;
+    /** 支付总金额带单位  + 单位 */
+    totalUnit: string;
+};
+export declare enum PayStatus {
+    'Success' = "200",
+    /** 未生成交易记录 */
+    'NoPay' = "4004",
+    /** 配对失效 */
+    'PairingFailure' = "606020",
+    /** 支付失败 */
+    'Unknown' = "701000",
+    /** 交易请求超时 */
+    'Timeout' = "701001",
+    /** 繁忙 EFTPOS终端暂时不可用，因为EFTPOS正在处理另一个请求。 */
+    'PayOtherEftposFailed' = "701003",
+    /** 购物者没有出示卡片/卡片金额不足/在线拒绝/卡已过期/卡被锁定 */
+    'PayCardErrorFailed' = "701004",
+    /** 断网 向EFTPOS发送消息失败。可能有网络问题，也可能没有连接websocket。 */
+    'NoNetWork' = "701005",
+    /** 交易等待超时 */
+    'PayTimeout' = "701006",
+    /** 连接失败 */
+    'SocketError' = "701007",
+    /** 银行拒绝 */
+    'PayBankRefuses' = "701008",
+    /** 签名拒绝 */
+    'SignatureDeclined' = "701009",
+    /** 配置参数错误 */
+    'UserConfigError' = "701010"
+}
+export interface ActionProps {
+    onChange: (status: `${StatusEnum.Success}` | `${StatusEnum.Fail}` | 'page', params?: {
+        [key: string]: unknown;
+    } | string) => void;
+    api: {
+        [key: string]: (...agrn: unknown[]) => Promise<unknown>;
+    };
+    className?: string;
+    isMobile?: boolean;
+    formatAmount: (amount: number | string, precision: number, symbol: string) => string;
+}

package/lib/components/eftposPay/device.d.ts

@@ -0,0 +1,25 @@
+import { CSSProperties } from 'react';
+import { PayProps, PosProps } from './const';
+import './device.less';
+/**
+ * @title: 设备选择页
+ * @description: 选择设备信息,无设备增加提示;仅有一条,默认选中跳走;多条记录则停留等待用户选择
+ * @return React.Element
+ * @Author: hongbing.wang
+ * @Date: 2024-08-12 11:40
+ */
+declare const _default: ({ api, onChange, onClose, className, device_number, isMobile, net, client, formatAmount, containerStyle, }: {
+    api: PayProps['api'];
+    className?: string | undefined;
+    onChange?: ((status: "page" | "success" | "print" | "fail" | "mark_tx_processed", params?: string | {
+        [keys: string]: unknown;
+    } | undefined, other?: any) => void) | undefined;
+    onClose: () => void;
+    device_number?: string | number | undefined;
+    isMobile: boolean;
+    net: boolean;
+    client: string;
+    formatAmount(amount: number | string, precision: number, symbol: string): string;
+    containerStyle: CSSProperties;
+}) => JSX.Element;
+export default _default;

package/lib/components/eftposPay/hooks.d.ts

@@ -15,7 +15,7 @@ export declare const useStoreRef: <T extends {
     readonly numRef: React.MutableRefObject<string | number | undefined>;
     readonly orderIdRef: React.MutableRefObject<string | number>;
     readonly modeRef: React.MutableRefObject<ModeEnum>;
-    readonly statusRef: React.MutableRefObject<"success" | "warn" | "loading" | "fail" | "pedding" | "resove" | "reject" | "question">;
+    readonly statusRef: React.MutableRefObject<"loading" | "success" | "warn" | "fail" | "pedding" | "resove" | "reject" | "question">;
     readonly netRef: React.MutableRefObject<boolean | undefined>;
     readonly symbolRef: React.MutableRefObject<string>;
     readonly amountRef: React.MutableRefObject<string | number>;

package/lib/components/eftposPay/index.d.ts

@@ -0,0 +1,4 @@
+import { PosProps } from './const';
+import './index.less';
+declare const _default: (props: PosProps) => JSX.Element | null;
+export default _default;

package/lib/components/eftposPay/linkly/hooks/useTimeQuery.d.ts

@@ -0,0 +1,4 @@
+export declare const useTimeResultQuery: (api: any, resultCheck: () => boolean, handleLinklySuccess: (res: any) => void) => {
+    run: () => Promise<void>;
+    stop: () => void;
+};

package/lib/components/eftposPay/pay.d.ts

@@ -1,3 +1,4 @@
+/// <reference types="react" />
 import { PayProps } from './const';
 import './index.less';
 /**

package/lib/components/eftposPay/payo/config.d.ts

@@ -0,0 +1,13 @@
+/// <reference types="react" />
+import { StatusEnum } from '../const';
+export declare const POS: ({ api, onChange, }: {
+    api: {
+        [key: string]: (...agrn: unknown[]) => Promise<unknown>;
+    };
+    onChange: (status: `${StatusEnum.Success}` | `${StatusEnum.Fail}`, params?: {
+        [keys: string]: unknown;
+    } | undefined) => void;
+}) => JSX.Element;
+export declare const Action: ({ onChange }: {
+    onChange: any;
+}) => JSX.Element;

package/lib/components/eftposPay/payo/payment.d.ts

@@ -0,0 +1,66 @@
+interface RunApiParams {
+    [key: string]: any;
+}
+export declare enum ActionType {
+    Pay = "pay",
+    Refund = "refund",
+    Query = "query"
+}
+interface UsePaymentOptions {
+    /**
+     * 支付接口
+     */
+    payApi: (params: RunApiParams, options?: {
+        signal?: AbortSignal;
+    }) => Promise<any>;
+    /**
+     * 退款接口
+     */
+    refundApi?: (params: RunApiParams, options?: {
+        signal?: AbortSignal;
+    }) => Promise<any>;
+    /**
+     * 查询接口
+     */
+    checkApi: (params: {
+        number: string;
+    }, options?: {
+        signal?: AbortSignal;
+    }) => Promise<any>;
+    /**
+     * 检查是否应该继续处理结果（用于处理网络断开、组件卸载等情况）
+     */
+    shouldContinue?: () => boolean;
+}
+interface RunParams {
+    /** 支付类型 */
+    paymentType: ActionType;
+    /** 支付交易号 */
+    paymentNum: string;
+    /** 订单ID */
+    orderId?: string | number;
+    /** 设备ID */
+    deviceId?: string | number;
+    /** 支付参数 */
+    params: RunApiParams;
+    /** 回调方法 */
+    callbacks: RunCallbacks;
+}
+interface RunCallbacks {
+    /**
+     * 成功回调
+     */
+    onSuccess: (res: any) => void;
+    /**
+     * 失败回调
+     */
+    onError: (error: any) => void;
+}
+export declare const usePayment: (options: UsePaymentOptions) => {
+    run: (options: RunParams) => Promise<void>;
+    stop: () => void;
+    clean: (params?: {
+        clearCallbacks?: boolean;
+    }) => void;
+};
+export {};

package/lib/components/eftposPay/store/index.d.ts

@@ -174,7 +174,7 @@ export declare const updateCustom: (payload: {
 export declare const updateStatus: (status: 'loading' | 'warn' | 'fail' | 'success' | 'question') => {
     type: EActionTypes;
     payload: {
-        status: "success" | "warn" | "loading" | "fail" | "question";
+        status: "loading" | "success" | "warn" | "fail" | "question";
     };
 };
 /**
@@ -295,10 +295,10 @@ export declare const backUpFree: (payload: Partial<State>) => {
         name?: string | undefined;
         symbol?: string | undefined;
         amount?: string | number | undefined;
-        mode?: "pay" | "fullPay" | "refund" | "query" | undefined;
+        mode?: "pay" | "refund" | "fullPay" | "query" | undefined;
         order_id?: string | number | undefined;
-        eftpos?: "payo" | "tyro" | "windcave" | "stripe" | "linkly" | undefined;
-        action?: "amount" | "pay" | "deviceList" | undefined;
+        eftpos?: "stripe" | "payo" | "tyro" | "windcave" | "linkly" | undefined;
+        action?: "pay" | "amount" | "deviceList" | undefined;
         key?: number | undefined;
         step?: number | undefined;
         title?: string | undefined;
@@ -308,7 +308,7 @@ export declare const backUpFree: (payload: Partial<State>) => {
         net?: boolean | undefined;
         component?: string | undefined;
         form?: string | undefined;
-        status?: "success" | "warn" | "loading" | "fail" | "pedding" | "resove" | "reject" | "question" | undefined;
+        status?: "loading" | "success" | "warn" | "fail" | "pedding" | "resove" | "reject" | "question" | undefined;
         warn?: string | undefined;
         steps?: {
             /** 用于重置当前步骤 */

package/lib/components/eftposPay/tip.d.ts

@@ -1,3 +1,4 @@
+/// <reference types="react" />
 import './tip.less';
 /**
  * @title: 支付状态未知页面

package/lib/components/eftposPay/tyro/index.d.ts

@@ -0,0 +1,9 @@
+import React from 'react';
+declare const _default: ({ api, onChange, children, url, version, }: {
+    api: any;
+    onChange: any;
+    children?: React.ReactNode;
+    url?: string | undefined;
+    version?: string | undefined;
+}) => JSX.Element;
+export default _default;