@pisell/private-materials 6.3.149 → 6.3.150

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

@@ -0,0 +1,358 @@
+import { ReactNode } from 'react';
+import { DeviceStatusType, StatusType, ModeType, RouteType, ClientEnum } from '../const';
+import { ThunkDispatch } from './useThunkReducer';
+export declare enum EActionTypes {
+    UPDATE_INIT = "UPDATE_INIT",
+    UPDATE_CUSTOM = "UPDATE_CUSTOM",
+    UPDATE_KEY = "UPDATE_KEY",
+    UPDATE_STEP_KEY = "UPDATE_STEP_KEY",
+    UPDATE_DEVICE = "UPDATE_DEVICE",
+    UPDATE_NEXT_STEP = "UPDATE_NEXT_STEP",
+    UPDATE_STATUS = "UPDATE_STATUS",
+    UPDATE_TITLE = "UPDATE_TITLE",
+    UPDATE_LOADING = "UPDATE_LOADING",
+    UPDATE_COMPONENT = "UPDATE_COMPONENT",
+    UPDATE_STEPS = "UPDATE_STEPS",
+    UPDATE_STEP_CURRENT_ITEM_CUSTOM = "UPDATE_STEP_CURRENT_ITEM_CUSTOM",
+    UPDATE_STEP_ITEM = "UPDATE_STEP_ITEM",
+    BACKUP_PRODUCTION = "BACKUP_PRODUCTION",
+    BACKUP_FREE = "BACKUP_FREE",
+    UPDATE_CLIENT = "UPDATE_CLIENT"
+}
+export declare type State = {
+    /** 支付名称 */
+    name: string;
+    /** 金额单位 */
+    symbol: string;
+    /** 支付原始金额 */
+    amount: string | number;
+    /** 模式 */
+    mode: ModeType;
+    /** 订单号 */
+    order_id: string | number;
+    /** 厂商 */
+    eftpos: DeviceStatusType;
+    action?: RouteType;
+    /** 用于重置页面特指 =》全部步骤 */
+    key: number;
+    /** 当前执行到哪一步了 */
+    step: number;
+    /** 标题 */
+    title: string;
+    /** 标题 */
+    subTitle?: string;
+    /** step : 常规步骤页面 ,unset 自定义页面 */
+    type: 'step' | 'unset';
+    render: boolean;
+    /** 网络 */
+    net?: boolean;
+    /** 上面  unset 自定义页面,这里需要指定到具体页面 */
+    component: string;
+    form?: string;
+    /** 页面状态 */
+    status: StatusType;
+    /** 警告文案 */
+    warn: string;
+    steps: {
+        /** 用于重置当前步骤 */
+        key: number;
+        title?: string;
+        text?: string;
+        warn?: string;
+        tip?: string;
+        success?: string;
+        fail?: string;
+        loading?: string;
+        /** 步骤状态 */
+        status: StatusType;
+        custom?: {
+            /**  步骤自定义 */
+            [key: string]: unknown;
+        };
+    }[];
+    /** 支付流水号 */
+    number?: string | number;
+    /** 设备信息 */
+    device?: {
+        [key: string]: unknown;
+    };
+    /** 支付信息 */
+    pay?: {
+        [key: string]: unknown;
+    };
+    custom?: {
+        [key: string]: unknown;
+    };
+    manual?: {
+        title: string;
+        text: string;
+        status?: boolean;
+        money?: number;
+    };
+    backup?: Omit<State, 'backup'>;
+    client: ClientEnum;
+    /** 支付原始参数 */
+    originalParams?: Record<string, any>;
+};
+export declare type Action = {
+    type: EActionTypes;
+    payload: Partial<State>;
+};
+/**
+ * @title: 刷新 key
+ * @description: 用户重置组件生命周期,
+ * @param {number} key
+ * @Author: hongbing.wang
+ * @Date: 2024-08-19 09:56
+ */
+export declare const updateKey: (key: number) => {
+    type: EActionTypes;
+    payload: {
+        key: number;
+    };
+};
+/**
+ * @title: 更新设备信息
+ * @description: 用户选择设备将回填到此处
+ * @param {object} payload
+ * @Author: hongbing.wang
+ * @Date: 2024-08-19 09:57
+ */
+export declare const updateDevice: (payload: {
+    device: State['device'];
+}) => {
+    type: EActionTypes;
+    payload: {
+        device: State['device'];
+    };
+};
+/**
+ * @title: 刷新 步骤key
+ * @description: 重置某一步生命周期
+ * @Author: hongbing.wang
+ * @Date: 2024-08-19 09:58
+ */
+export declare const updateStepKey: () => {
+    type: EActionTypes;
+    payload: {};
+};
+/**
+ * @title: 更新至下一步
+ * @description: 更新至下一步
+ * @param {string} warn?: 错误信息
+ * @Author: hongbing.wang
+ * @Date: 2024-08-19 09:58
+ */
+export declare const updateNextStep: (warn?: string) => {
+    type: EActionTypes;
+    payload: {
+        warn: string;
+    } | {
+        warn?: undefined;
+    };
+};
+/**
+ * @title: 更新自定义信息
+ * @description: 更新自定义信息
+ * @param {object} payload
+ * @Author: hongbing.wang
+ * @Date: 2024-08-19 10:03
+ */
+export declare const updateCustom: (payload: {
+    [key: string]: unknown;
+}) => {
+    type: EActionTypes;
+    payload: {
+        [key: string]: unknown;
+    };
+};
+/**
+ * @title: 更新 全局状态
+ * @description: 更新 全局状态
+ * @param {string} status : 状态
+ *  * @Author: hongbing.wang
+ * @Date: 2024-08-19 10:03
+ */
+export declare const updateStatus: (status: 'loading' | 'warn' | 'fail' | 'success' | 'question') => {
+    type: EActionTypes;
+    payload: {
+        status: "warn" | "success" | "loading" | "fail" | "question";
+    };
+};
+/**
+ * @title: 更新自定义组件
+ * @description: 更新自定义组件
+ * @param {string} component 组件名称
+ * @param {boolean} render : true : 隐藏 原组件(维持原组件内状态)  ;false : 卸载
+ * @return {*}
+ * @Author: hongbing.wang
+ * @Date: 2024-08-19 10:04
+ */
+export declare const updateComponent: (component: string, render?: boolean) => {
+    type: EActionTypes;
+    payload: {
+        readonly component: string;
+        readonly type: "unset";
+        readonly render: boolean;
+    } | {
+        readonly type: "step";
+        readonly render: boolean;
+        component?: undefined;
+    };
+};
+/**
+ * @title: 更新步骤信息
+ * @description: 更新某一步骤信息
+ * @param {State} steps 某一步骤信息
+ * @Author: hongbing.wang
+ * @Date: 2024-08-19 10:07
+ */
+export declare const updateSteps: (steps: State['steps']) => {
+    type: EActionTypes;
+    payload: {
+        steps: {
+            /** 用于重置当前步骤 */
+            key: number;
+            title?: string | undefined;
+            text?: string | undefined;
+            warn?: string | undefined;
+            tip?: string | undefined;
+            success?: string | undefined;
+            fail?: string | undefined;
+            loading?: string | undefined;
+            /** 步骤状态 */
+            status: StatusType;
+            custom?: {
+                [key: string]: unknown;
+            } | undefined;
+        }[];
+    };
+};
+/**
+ * @title: 更新状态管理信息
+ * @description: 更新状态管理信息
+ * @param {Partial} payload
+ * @return {*}
+ * @Author: hongbing.wang
+ * @Date: 2024-08-19 10:08
+ */
+export declare const updateState: (payload: Partial<State>) => {
+    type: EActionTypes;
+    payload: Partial<State>;
+};
+/**
+ * @title: 更新当前步骤自定义信息
+ * @description: 更新当前步骤自定义信息
+ * @Author: hongbing.wang
+ * @Date: 2024-08-19 10:09
+ */
+export declare const updateCurrentCustomStemItem: (payload: NonNullable<Partial<State['steps'][number]['custom']>>) => {
+    type: EActionTypes;
+    payload: Partial<{
+        [key: string]: unknown;
+    }>;
+};
+/**
+ * @title: 更新当前步骤信息
+ * @description: 更新当前步骤信息
+ * @Author: hongbing.wang
+ * @Date: 2024-08-19 10:09
+ */
+export declare const updateCurrentStemItem: (payload: any) => {
+    type: EActionTypes;
+    payload: any;
+};
+/**
+ * @title: 更新当前步骤信息
+ * @description: 更新当前步骤信息
+ * @Author: hongbing.wang
+ * @Date: 2024-08-19 10:09
+ */
+export declare const updateClient: (payload: ClientEnum) => {
+    type: EActionTypes;
+    payload: {
+        client: ClientEnum;
+    };
+};
+/**
+ * @title: 更新备份信息
+ * @description: 更新备份信息
+ * @Author: hongbing.wang
+ * @Date: 2024-08-19 10:25
+ */
+export declare const backUpProduction: (payload: Partial<State>) => {
+    type: EActionTypes;
+    payload: Partial<State>;
+};
+/**
+ * @title: 释放备份信息
+ * @description: 释放备份信息
+ * @param {Partial} payload
+ * @Author: hongbing.wang
+ * @Date: 2024-08-19 10:27
+ */
+export declare const backUpFree: (payload: Partial<State>) => {
+    type: EActionTypes;
+    payload: {
+        name?: string | undefined;
+        symbol?: string | undefined;
+        amount?: string | number | undefined;
+        mode?: "refund" | "pay" | "fullPay" | "query" | undefined;
+        order_id?: string | number | undefined;
+        eftpos?: "stripe" | "payo" | "tyro" | "windcave" | "linkly" | undefined;
+        action?: "amount" | "pay" | "deviceList" | undefined;
+        key?: number | undefined;
+        step?: number | undefined;
+        title?: string | undefined;
+        subTitle?: string | undefined;
+        type?: "unset" | "step" | undefined;
+        render?: boolean | undefined;
+        net?: boolean | undefined;
+        component?: string | undefined;
+        form?: string | undefined;
+        status?: "warn" | "success" | "loading" | "fail" | "pedding" | "resove" | "reject" | "question" | undefined;
+        warn?: string | undefined;
+        steps?: {
+            /** 用于重置当前步骤 */
+            key: number;
+            title?: string | undefined;
+            text?: string | undefined;
+            warn?: string | undefined;
+            tip?: string | undefined;
+            success?: string | undefined;
+            fail?: string | undefined;
+            loading?: string | undefined;
+            /** 步骤状态 */
+            status: StatusType;
+            custom?: {
+                [key: string]: unknown;
+            } | undefined;
+        }[] | undefined;
+        number?: string | number | undefined;
+        device?: {
+            [key: string]: unknown;
+        } | undefined;
+        pay?: {
+            [key: string]: unknown;
+        } | undefined;
+        custom?: {
+            [key: string]: unknown;
+        } | undefined;
+        manual?: {
+            title: string;
+            text: string;
+            status?: boolean | undefined;
+            money?: number | undefined;
+        } | undefined;
+        backup?: Omit<State, "backup"> | undefined;
+        client?: ClientEnum | undefined;
+        originalParams?: Record<string, any> | undefined;
+    };
+};
+export declare function reducers(state: State, action: Action): State;
+export declare const Provider: ({ children, state: providerState, }: {
+    children: ReactNode;
+    state?: State | undefined;
+}) => JSX.Element;
+export declare function useContextData(): State;
+export declare function useDispatch(): ThunkDispatch<State, Action>;

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

@@ -0,0 +1,10 @@
+/// <reference types="react" />
+import './tip.less';
+/**
+ * @title: 支付状态未知页面
+ * @description:
+ * @Author: hongbing.wang
+ * @Date: 2024-08-20 11:42
+ */
+declare const _default: ({ onChangeStatus, className, formatAmount, cardSurcharge, receipts, successTime, onChangeParams, }: any) => JSX.Element;
+export default _default;

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;

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

@@ -0,0 +1,110 @@
+export interface LogEntry {
+    /** 日志标题 */
+    title: string;
+    /** 日志内容 */
+    content?: any;
+    /** 支付时间（精确到毫秒） */
+    time: string;
+}
+interface PaymentLogRecord {
+    /** 交易记录号 */
+    number: string;
+    /** 订单ID */
+    orderId?: string | number;
+    /** 设备ID */
+    deviceId?: string | number;
+    /** 支付类型 */
+    paymentType?: string;
+    /** 创建时间 */
+    createdAt: string;
+    /** 日志条目列表 */
+    logs: LogEntry[];
+}
+declare class PaymentLogInstance {
+    private static instance;
+    /** 当前交易记录号 */
+    private currentNumber;
+    /** 当前日志记录 */
+    private currentRecord;
+    private constructor();
+    /**
+     * 获取单例实例
+     */
+    static getInstance(): PaymentLogInstance;
+    /**
+     * 初始化支付日志
+     * @param number 交易记录号
+     * @param options 初始化选项
+     */
+    init(number: string, options?: {
+        orderId?: string | number;
+        deviceId?: string | number;
+        paymentType?: string;
+        [key: string]: any;
+    }): void;
+    /**
+     * 添加日志条目
+     * @param title 日志标题
+     * @param content 日志内容
+     */
+    addLog(params: {
+        title: string;
+        content?: any;
+    }): void;
+    /**
+     * 构建日志内容
+     * @param record 日志记录
+     * @returns 格式化的日志内容数组
+     */
+    private buildLogContent;
+    /**
+     * 发送单条日志记录到飞书
+     * @param record 日志记录
+     * @param isRestore 是否是恢复上传
+     */
+    private sendLogRecord;
+    /**
+     * 发送日志到飞书
+     * @param title 日志标题（可选，仅在需要自定义标题时使用）
+     */
+    sendLogs(title?: string): void;
+    /**
+     * 清除当前日志
+     * @param shouldSend 清除前是否发送到飞书，默认为 true
+     */
+    clearLogs(shouldSend?: boolean): void;
+    /**
+     * 检查并上传旧日志
+     */
+    private checkAndUploadOldLogs;
+    /**
+     * 获取所有支付日志对象
+     */
+    private getAllLogsObject;
+    /**
+     * 保存所有支付日志对象
+     */
+    private saveAllLogsObject;
+    /**
+     * 保存到 localStorage
+     */
+    private saveToLocalStorage;
+    /**
+     * 从 localStorage 中删除
+     */
+    private removeFromLocalStorage;
+    /**
+     * 获取所有旧日志
+     */
+    private getOldLogsFromLocalStorage;
+    /**
+     * 获取当前日志记录（用于调试）
+     */
+    getCurrentRecord(): PaymentLogRecord | null;
+    /**
+     * 获取当前交易号（用于调试）
+     */
+    getCurrentNumber(): string | null;
+}
+declare const paymentLog: PaymentLogInstance;
+export default paymentLog;

package/lib/components/eftposPay/utils/payLog.d.ts

@@ -0,0 +1,81 @@
+export interface PayLogContext {
+    /** 渠道 */
+    channel?: string;
+    /** 订单ID */
+    orderId?: string | number;
+    /** 设备ID */
+    deviceId?: string | number;
+    /** 支付类型：PAYO / WINDCAVE / LINKLY / TYRO */
+    paymentType?: string;
+    /** 交易记录号 */
+    transactionNumber?: string;
+    /** 模式：pay / refund / query */
+    mode?: string;
+    /** 其他扩展信息 */
+    extra?: Record<string, any>;
+}
+declare class PayLog {
+    private static instance;
+    private sessionKey;
+    private context;
+    private logs;
+    private startTime;
+    private flushed;
+    private constructor();
+    static getInstance(): PayLog;
+    /**
+     * 初始化一次交易会话
+     * - 生成唯一 sessionKey
+     * - 恢复上报 localStorage 中残留的旧日志
+     * - 接受部分 context（后续可通过 setContext 补充）
+     */
+    init(context?: Partial<PayLogContext>): void;
+    /**
+     * 补充/更新上下文信息
+     * 新值覆盖旧值，extra 做浅合并
+     */
+    setContext(partial: Partial<PayLogContext>): void;
+    /**
+     * 记录一条日志
+     */
+    log(title: string, data?: any): void;
+    /**
+     * 上报日志到飞书并清理 localStorage
+     */
+    flush(customTitle?: string): void;
+    /**
+     * flush + 重置内部状态
+     */
+    destroy(): void;
+    /**
+     * 构建 sendWarningLog 所需的 content 数组
+     */
+    private buildContent;
+    /**
+     * 持久化当前会话到 localStorage
+     */
+    private persistToStorage;
+    /**
+     * 从 localStorage 移除指定 session
+     */
+    private removeFromStorage;
+    /**
+     * 获取 localStorage 中所有 session
+     */
+    private getAllSessions;
+    /**
+     * 恢复上报 localStorage 中残留的旧日志（崩溃/异常退出场景）
+     */
+    private recoverOrphanedLogs;
+}
+declare const payLog: PayLog;
+export default payLog;
+/**
+ * 在根组件中使用，管理 PayLog 生命周期
+ * - mount 时 init（+ 恢复上报残留日志）
+ * - unmount 时 flush
+ */
+export declare function usePayLog(context?: Partial<PayLogContext>): {
+    log: (title: string, data?: any) => void;
+    setContext: (partial: Partial<PayLogContext>) => void;
+};

package/lib/components/eftposPay/windcave/helper.d.ts

@@ -0,0 +1,23 @@
+import React from 'react';
+import { PayStatus } from '../const';
+import XhrTimer from './timer';
+/**
+ * @title: windcave 支付,退款,查询 错误逻辑处理
+ * @description: 动态步骤页 异常前往 FailCustom 页面
+ * @return null
+ * @Author: hongbing.wang
+ * @Date: 2024-08-12 10:29
+ */
+export declare const useFail: () => (res: {
+    code?: `${PayStatus}`;
+}, isMark?: boolean) => void;
+/**
+ * @title: 轮询 check 接口
+ * @description: 轮询 终止条件 1.超时 , 2. 返回非200状态码 , 3. 外部关闭
+ * @return [run, XhrTimer] run: 启动函数 , XhrTimer 轮询类
+ * @Author: hongbing.wang
+ * @Date: 2024-08-12 10:30
+ */
+export declare const useValidate: (check: (...agrn: unknown[]) => Promise<unknown>, num: number, onChange: (params: {
+    [key: string]: unknown;
+}) => unknown) => readonly [(timeout?: number) => void, React.MutableRefObject<((res: any, isRun?: boolean) => unknown) | undefined>, React.MutableRefObject<XhrTimer | undefined>];

package/lib/components/eftposPay/windcave/receiptAction.d.ts

@@ -0,0 +1,23 @@
+/// <reference types="react" />
+/**
+ * @title: 按钮操作区
+ * @description: 仅包含签名
+ * @Author: hongbing.wang
+ * @Date: 2024-08-20 12:33
+ */
+export declare const ReceiptAction: ({ api, onChange, }: {
+    api: any;
+    onChange: (status: boolean) => void;
+}) => JSX.Element;
+/**
+ * @title: 按钮操作区
+ * @description: 不包含签名
+ * @Author: hongbing.wang
+ * @Date: 2024-08-20 12:32
+ */
+declare const Action: ({ index, onCancel, disabled, }: {
+    index: number;
+    onCancel: () => void;
+    disabled: boolean;
+}) => JSX.Element | null;
+export default Action;

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

@@ -0,0 +1,7 @@
+/// <reference types="react" />
+declare const _default: ({ api, onChange, formatAmount, }: {
+    api: any;
+    onChange: any;
+    formatAmount(amount: number | string, precision: number, symbol: string): string;
+}) => JSX.Element;
+export default _default;

package/lib/components/eventBooking/components/Provider/Cart/Deposit/index.d.ts

@@ -1,3 +1,4 @@
+/// <reference types="react" />
 interface DepositProps {
     showTitle?: boolean;
 }

package/lib/components/eventBooking/components/Provider/Cart/Item/index.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 import './index.less';
 declare const CartItem: () => JSX.Element;
 export default CartItem;