@pisell/private-materials 6.6.41 → 6.6.43

package/lib/components/eftposPay/aggregatePayment/types.d.ts

@@ -0,0 +1,106 @@
+import PaymentMethod from './utils/payment';
+export declare enum EVisibleButtonType {
+    /** 取消按钮 */
+    CancelButton = "CancelButton",
+    /** 等待按钮 */
+    WaitButton = "WaitButton"
+}
+export declare enum EActionStatus {
+    /** 空 */
+    Empty = "Empty",
+    /** 取消 */
+    Cancel = "Cancel",
+    /** 取消中 */
+    CancelWaiting = "CancelWaiting",
+    /** 签名 */
+    Signature = "Signature",
+    /** 签名等待中 */
+    SignatureWaiting = "SignatureWaiting"
+}
+export declare const QUERY_START_DELAY: number;
+export declare const GLOBAL_TIMEOUT: number;
+export declare const REQUEST_TIMEOUT: number;
+export declare const QUERY_INTERVAL: number;
+/**
+ * 聚合支付初始化参数
+ */
+export interface PaymentMethodOptions {
+    /** 支付类型 */
+    paymentCode: string;
+    /** 交易号 */
+    paymentNum: string;
+    /** 订单ID */
+    orderId?: string | number;
+    /** 设备ID */
+    deviceId?: string | number;
+    /** 统一回调函数 */
+    callback: PaymentCallback;
+    /** 检查是否应该继续处理结果 */
+    shouldContinue?: () => boolean;
+    /** 配置 */
+    config?: PaymentMethodConfig;
+}
+/**
+ * 聚合支付操作类型
+ */
+export declare enum ActionType {
+    /** 支付 */
+    Pay = "pay",
+    /** 支付查询 */
+    PayQuery = "payQuery",
+    /** 支付行为 */
+    PayAction = "payAction",
+    /** 退款 */
+    Refund = "refund",
+    /** 退款查询 */
+    RefundQuery = "refundQuery",
+    /** 退款行为 */
+    RefundAction = "refundAction"
+}
+/** 回调事件 */
+export interface CallbackEvent {
+    /** 事件类型：成功、失败、进度 */
+    status: EPaymentStatus;
+    /** 操作类型 */
+    actionType: ActionType;
+    /** 数据：成功时是结果，失败时是错误信息，进度时是进度数据 */
+    data: any;
+}
+/** 统一回调函数 */
+export declare type PaymentCallback = (instance: PaymentMethod, event: CallbackEvent) => void;
+/**
+ * 执行操作参数
+ */
+export interface RunOptions {
+    /** 操作类型 */
+    actionType: ActionType;
+    /** 请求参数 */
+    params?: Record<string, any>;
+}
+/**
+ * 聚合支付配置参数
+ */
+export interface PaymentMethodConfig {
+    /** 是否需要轮询间隔 */
+    hasQueryInterval?: boolean;
+}
+/**
+ * 支付状态
+ */
+export declare enum EPaymentStatus {
+    /** 支付中 */
+    Processing = "processing",
+    /** 支付成功 */
+    Success = "success",
+    /** 支付失败 */
+    Failed = "failed"
+}
+/**
+ * 执行操作参数
+ */
+export interface HooksRunParams {
+    /** 付款码 */
+    authCode?: string | number;
+    /** 订单支付ID */
+    orderPaymentId?: string | number;
+}

package/lib/components/eftposPay/aggregatePayment/utils/payment.d.ts

@@ -0,0 +1,139 @@
+/**
+ * 聚合支付方法类
+ * 核心点：
+ * 1.发起支付/退款，在十秒钟后发起轮询操作，两个接口谁先返回成功用谁的结果，如果返回的失败是存在明确code信息的则全部失败
+ * 2.轮询操作总查询时间2分钟，超时直接失败，单次轮询超时时间5秒，超时直接abort本次请求，间隔两秒后发起新的请求
+ * 3.最终成功或者失败都需要把定时器给清理掉，并将未完成的接口abort掉
+ */
+import { PaymentMethodOptions } from '../types';
+declare class PaymentMethod {
+    /** 初始化参数 */
+    private initOptions;
+    private paymentNum;
+    private orderId?;
+    private deviceId?;
+    private callback;
+    private shouldContinue;
+    private config;
+    private controller;
+    private queryController;
+    private queryStartTimer;
+    private globalTimeoutTimer;
+    private requestTimeoutTimer;
+    private queryIntervalTimer;
+    private isFinished;
+    private isQuerying;
+    private currentActionType;
+    private currentQueryId;
+    private currentRunId;
+    private currentQueryApi;
+    constructor(options: PaymentMethodOptions);
+    /**
+     * 判断请求是否需要等待轮询结果
+     * 1. 有明确错误code且不是超时和支付超时，则直接失败
+     * @param code 错误码
+     */
+    private isRequestFailed;
+    /**
+     * 清理定时器和请求控制器
+     */
+    private cleanupTimersAndControllers;
+    /**
+     * 清理资源并重置状态
+     * @param markAsFinished 是否标记为已完成（true: 操作完成; false: 准备新操作）
+     */
+    private clean;
+    /**
+     * 开始新的操作流程（统一的流程初始化）
+     * @param actionType 操作类型
+     * @returns 本次流程的唯一ID
+     */
+    private startNewOperation;
+    /**
+     * 处理操作过程
+     */
+    private handleOperationProcess;
+    /**
+     * 处理成功结果
+     */
+    private handleOperationSuccess;
+    /**
+     * 处理错误（最终失败）
+     * @param error 错误信息
+     */
+    private handleOperationError;
+    /**
+     * 处理接口响应
+     */
+    private handleResponse;
+    /**
+     * 创建超时 Promise
+     */
+    private createTimeoutPromise;
+    /**
+     * 单次查询请求
+     */
+    private performQuery;
+    /**
+     * 安排下一次查询
+     */
+    private scheduleNextQuery;
+    /**
+     * 开始轮询
+     */
+    private startQuery;
+    /**
+     * 获取操作API和查询API
+     */
+    private getActionApi;
+    /**
+     * 执行纯查询操作（不需要先调用支付/退款接口）
+     */
+    private runQuery;
+    /**
+     * 执行操作的核心方法
+     */
+    private run;
+    /**
+     * 执行操作
+     */
+    private runAction;
+    /**
+     * 支付
+     * @param params 支付参数
+     */
+    pay(params: Record<string, any>): void;
+    /**
+     * 支付取消
+     * @param params 取消参数
+     */
+    payAction(params: Record<string, any>): void;
+    /**
+     * 退款
+     * @param params 退款参数
+     */
+    refund(params: Record<string, any>): void;
+    /**
+     * 退款取消
+     * @param params 取消参数
+     */
+    refundAction(params: Record<string, any>): void;
+    /**
+     * 支付查询（直接查询，带2分钟超时和轮询机制）
+     */
+    payQuery(): void;
+    /**
+     * 退款查询（直接查询，带2分钟超时和轮询机制）
+     */
+    refundQuery(): void;
+    /**
+     * 停止操作，后续依然可以重新发起操作
+     */
+    stop(): void;
+    /**
+     * 销毁实例（完全清理并上传日志）
+     * 注意：销毁后实例不可再使用
+     */
+    destroy(): void;
+}
+export default PaymentMethod;

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

@@ -1,4 +1,3 @@
-import React from 'react';
 import { PosProps } from './const';
 /**
  * @title: 支付金额信息配置页
@@ -9,7 +8,7 @@ import { PosProps } from './const';
  */
 declare const _default: ({ className, onChange, onClose, formatAmount, isMobile, net, client }: {
     className?: string | undefined;
-    onChange?: ((status: "success" | "page" | "print" | "fail" | "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;
@@ -17,5 +16,5 @@ declare const _default: ({ className, onChange, onClose, formatAmount, isMobile,
     isMobile: boolean;
     net: boolean;
     client: string;
-}) => React.JSX.Element;
+}) => JSX.Element;
 export default _default;

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

@@ -1,4 +1,3 @@
-import React from 'react';
 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;
@@ -7,5 +6,5 @@ declare const App: ({ action, api, device_number, terminal, tyroUrl, tyroVersion
     isMobile: boolean;
     channel?: string | undefined;
     formatAmount(amount: number | string, precision: number, symbol: string): string;
-}) => React.JSX.Element;
+}) => JSX.Element;
 export default App;

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

@@ -2,5 +2,5 @@ import React from 'react';
 import './index.less';
 declare const _default: ({ children }: {
     children: React.ReactNode;
-}) => React.JSX.Element;
+}) => JSX.Element;
 export default _default;

package/lib/components/eftposPay/component/alert/warn.d.ts

@@ -1,3 +1,2 @@
-import React from 'react';
-declare const _default: () => React.JSX.Element;
+declare const _default: () => JSX.Element;
 export default _default;

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

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

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

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

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

@@ -1,9 +1,8 @@
-import React from 'react';
 import { ActionProps } from '../../const';
 /**
  * @title: 断网(客户端)提示页
  * @Author: hongbing.wang
  * @Date: 2024-08-20 11:40
  */
-declare const _default: ({ className }: ActionProps) => React.JSX.Element;
+declare const _default: ({ className }: ActionProps) => JSX.Element;
 export default _default;

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

@@ -1,4 +1,3 @@
-import React from 'react';
 import { ActionProps } from '../../const';
 /**
  * @title: 支付状态未知页面
@@ -6,5 +5,5 @@ import { ActionProps } from '../../const';
  * @Author: hongbing.wang
  * @Date: 2024-08-20 11:42
  */
-declare const _default: ({ onChange, className }: ActionProps) => React.JSX.Element;
+declare const _default: ({ onChange, className }: ActionProps) => JSX.Element;
 export default _default;

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

@@ -6,5 +6,5 @@ declare const _default: ({ status, title, subTitle, children }: {
     title?: string | undefined;
     subTitle?: string | undefined;
     children?: React.ReactNode;
-}) => React.JSX.Element;
+}) => JSX.Element;
 export default _default;

package/lib/components/eftposPay/component/header/titlebar.d.ts

@@ -1,4 +1,3 @@
-import React from 'react';
 import './titlebar.less';
 declare enum EPopupTitleBarVariantType {
     BackTitleClose = "back-title-cancel",
@@ -9,5 +8,5 @@ declare const _default: ({ type, children, onBack, onClose, }: {
     children: string;
     onBack?: (() => void) | undefined;
     onClose?: (() => void) | undefined;
-}) => React.JSX.Element;
+}) => JSX.Element;
 export default _default;

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

@@ -1,4 +1,3 @@
-import React from 'react';
 import { ActionProps } from '../../const';
 import './index.less';
 /**
@@ -6,5 +5,5 @@ import './index.less';
  * @Author: hongbing.wang
  * @Date: 2024-08-20 11:46
  */
-declare const _default: ({ onChange, className, formatAmount }: ActionProps) => React.JSX.Element;
+declare const _default: ({ onChange, className, formatAmount }: ActionProps) => JSX.Element;
 export default _default;

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

@@ -1,9 +1,8 @@
-import React from 'react';
 import { ActionProps } from '../../const';
 /**
  * @title: 取消签名确认页
  * @Author: hongbing.wang
  * @Date: 2024-08-20 11:49
  */
-declare const _default: ({ api, className }: ActionProps) => React.JSX.Element;
+declare const _default: ({ api, className }: ActionProps) => JSX.Element;
 export default _default;

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

@@ -1,4 +1,3 @@
-import React from 'react';
 import { StatusType } from '../../const';
 declare const _default: (props: {
     status: StatusType;
@@ -8,5 +7,5 @@ declare const _default: (props: {
     loading?: string;
     success?: string;
     fail?: string;
-}) => React.JSX.Element;
+}) => JSX.Element;
 export default _default;

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

@@ -1,9 +1,8 @@
-import React from 'react';
 declare const _default: (props: {
     status: string;
     pedding?: string;
     resolve?: string;
     reject?: string;
     className?: string;
-}) => React.JSX.Element;
+}) => JSX.Element;
 export default _default;

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

@@ -0,0 +1,195 @@
+import { CSSProperties } from 'react';
+export declare enum EftposEnum {
+    /** 后端支付 - 仅支付  */
+    Payo = "payo",
+    /** 前端支付 */
+    Tyro = "tyro",
+    /** 后端支付 - 支付 + 退款  */
+    Windcave = "windcave",
+    Stripe = "stripe",
+    Linkly = "linkly",
+    /** 汇付天下 */
+    Huifu = "huifu"
+}
+export declare enum StatusEnum {
+    Init = "init",
+    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",
+    /** 支付失败（汇付天下） */
+    'PaymentFailed' = "701002",
+    /** 繁忙 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

@@ -1,4 +1,4 @@
-import React, { CSSProperties } from 'react';
+import { CSSProperties } from 'react';
 import { PayProps, PosProps } from './const';
 import './device.less';
 /**
@@ -11,7 +11,7 @@ import './device.less';
 declare const _default: ({ api, onChange, onClose, className, device_number, isMobile, net, client, formatAmount, containerStyle, }: {
     api: PayProps['api'];
     className?: string | undefined;
-    onChange?: ((status: "success" | "page" | "print" | "fail" | "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;
@@ -21,5 +21,5 @@ declare const _default: ({ api, onChange, onClose, className, device_number, isM
     client: string;
     formatAmount(amount: number | string, precision: number, symbol: string): string;
     containerStyle: CSSProperties;
-}) => React.JSX.Element;
+}) => JSX.Element;
 export default _default;

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

@@ -15,11 +15,11 @@ 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" | "init" | "fail" | "pedding" | "resove" | "reject" | "question">;
+    readonly statusRef: React.MutableRefObject<"loading" | "success" | "warn" | "init" | "fail" | "pedding" | "resove" | "reject" | "question">;
     readonly netRef: React.MutableRefObject<boolean | undefined>;
     readonly symbolRef: React.MutableRefObject<string>;
     readonly amountRef: React.MutableRefObject<string | number>;
-    readonly eftposRef: React.MutableRefObject<"payo" | "tyro" | "windcave" | "stripe" | "linkly" | "huifu">;
+    readonly eftposRef: React.MutableRefObject<"stripe" | "tyro" | "payo" | "windcave" | "linkly" | "huifu">;
     readonly clientRef: React.MutableRefObject<ClientEnum>;
     readonly dataRef: React.MutableRefObject<import("./store").State>;
 };

package/lib/components/eftposPay/huifu/Action.d.ts

@@ -4,5 +4,5 @@ import { HuifuActionProps } from './types';
 export declare const NativeDeviceStatus: ({ type, status, }: {
     type: 'scanner' | 'camera';
     status: boolean;
-}) => React.JSX.Element;
+}) => JSX.Element;
 export declare const ScanAction: React.FC<HuifuActionProps>;

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

@@ -0,0 +1,25 @@
+export declare const useTerminal: () => {
+    isTerminal: any;
+};
+/**
+ * 获取扫码设备连接状态
+ */
+export declare const useScannerDevice: () => {
+    scannerStatus: boolean;
+};
+/**
+ * 摄像头激活和状态获取
+ */
+export declare const useCameraDevice: () => {
+    activeCamera: () => void;
+    cameraStatus: any;
+};
+/**
+ * 获取外部设备扫描结果
+ */
+export declare const useScanListener: () => {
+    scanResult: {
+        type: 'scanner' | 'nfc' | 'camera';
+        value: string;
+    };
+};

package/lib/components/eftposPay/huifu/types.d.ts

@@ -0,0 +1,14 @@
+export declare type Peripherals = {
+    scanner: 'none' | 'connected' | 'disconnect';
+    nfc: 'none' | 'connected' | 'disconnect';
+};
+export interface HuifuProps {
+    isNativeApp?: boolean;
+    onChange: (status: any, params: any) => void;
+}
+export interface HuifuActionProps {
+    isNativeApp?: boolean;
+    onClose: () => void;
+    onPayClick: (scanResult: string) => void;
+    onScanCallback: (scanResult: string) => void;
+}