@paykka/card-checkout-ui 0.13.16 → 0.14.0

package/dist/types/components/{TNGWallet → wallets/TNGWallet}/TNGWallet.d.ts

@@ -1,10 +1,15 @@
 import type { TNGWalletProps } from './type';
 import type { TNGWalletRef } from './type';
 import './tng-wallet.scss';
-export declare const TNGWallet: import("preact").FunctionalComponent<import("preact/compat").PropsWithoutRef<TNGWalletProps & import("../../types").PayKKaCommonConfig & {
-    session: import("../../core").Session;
-    core: import("../../core").PayKKaCheckout;
-    threeDSFrame?: import("../../types").ThreeDSFrameConfig | undefined;
+/**
+ * TNGWallet 支付方式
+ * - 表单：邮箱，地址
+ * - 支付：跳转至 TNGWallet 页面完成支付
+ */
+export declare const TNGWallet: import("preact").FunctionalComponent<import("preact/compat").PropsWithoutRef<TNGWalletProps & import("../../../types").PayKKaCommonConfig & {
+    session: import("../../../core").Session;
+    core: import("../../../core").PayKKaCheckout;
+    threeDSFrame?: import("../../../types").ThreeDSFrameConfig | undefined;
     isDropIn?: boolean | undefined;
 }> & {
     ref?: import("preact").Ref<TNGWalletRef> | undefined;

package/dist/types/components/{TNGWallet → wallets/TNGWallet}/type.d.ts

@@ -1,7 +1,6 @@
-import type { PayKKaError } from '../../core';
-import type { FormValidateError } from '../internal/Form';
-import type { PayKKaCommonConfig, PaymentInfo } from '../../types';
-export interface TNGWalletProps extends PayKKaCommonConfig {
+import type { PayKKaCommonConfig } from '../../../types';
+import type { PaymentCommonProps } from '../../../types/payment';
+export interface TNGWalletProps extends PayKKaCommonConfig, PaymentCommonProps {
     /**
      * 是否展示邮箱
      * 若配置 true 但创建收银台时已经传了，就展示禁用状态。
@@ -14,16 +13,6 @@ export interface TNGWalletProps extends PayKKaCommonConfig {
      * 若配置 false 但创建收银台时未传，依旧会展示该输入框。
      */
     showAddress?: boolean;
-    /** 提交表单时触发 */
-    onSubmit?: (formValidateError?: Recordable<FormValidateError[]>) => void;
-    /** 支付成功后触发 */
-    onSuccess?: (data: PaymentInfo) => void;
-    /** 支付失败时触发 */
-    onError?: (error: PayKKaError) => void;
-    /** 支付超时时触发 */
-    onTimeout?: () => void;
-    /** 收银台已过期时触发 */
-    onExpired?: () => void;
 }
 export interface TNGWalletRef {
     /** 停止轮询支付结果 */

package/dist/types/components/wallets/Trustly/Trustly.d.ts

@@ -0,0 +1,15 @@
+import './trustly.scss';
+import type { TrustlyProps, TrustlyRef } from './type';
+/**
+ * Trustly 支付方式
+ * - 表单：指定国家，姓名，邮箱
+ * - 支付：跳转至 Trustly 页面完成支付
+ */
+export declare const Trustly: import("preact").FunctionalComponent<import("preact/compat").PropsWithoutRef<TrustlyProps & import("../../../types").PayKKaCommonConfig & {
+    session: import("../../../core").Session;
+    core: import("../../../core").PayKKaCheckout;
+    threeDSFrame?: import("../../../types").ThreeDSFrameConfig | undefined;
+    isDropIn?: boolean | undefined;
+}> & {
+    ref?: import("preact").Ref<TrustlyRef> | undefined;
+}>;

package/dist/types/components/wallets/Trustly/index.d.ts

@@ -0,0 +1,2 @@
+export * from './Trustly';
+export * from './type';

package/dist/types/components/wallets/Trustly/type.d.ts

@@ -0,0 +1,21 @@
+import type { PayKKaCommonConfig } from '../../../types';
+import type { PaymentCommonProps } from '../../../types/payment';
+import type { WalletCustomProps, WalletRedirectProps } from '../type';
+export interface TrustlyProps extends PayKKaCommonConfig, WalletRedirectProps, WalletCustomProps, PaymentCommonProps {
+    /**
+     * 是否展示地址
+     * 若配置 true 但创建收银台时已经传了，就展示禁用状态。
+     * 若配置 false 但创建收银台时未传，依旧会展示该输入框。
+     */
+    showAddress?: boolean;
+}
+export interface TrustlyRef {
+    /** 停止轮询支付结果 */
+    stopRetry: () => void;
+    /** 开始轮询支付结果 */
+    startRetry: (timeout?: number) => void;
+    /** 更新表单地址 */
+    updateAddress: () => void;
+    /** 不展示支付按钮时，可调用该方法进行支付 */
+    payment: () => void;
+}

package/dist/types/components/wallets/Vietqr/Vietqr.d.ts

@@ -1,5 +1,10 @@
 import type { VietqrProps, VietqrRef } from './type';
 import './vietqr.scss';
+/**
+ * Vietqr 支付方式
+ * - 表单：邮箱，地址
+ * - 支付：移动端跳转，PC 端展示二维码弹窗
+ */
 export declare const Vietqr: import("preact").FunctionalComponent<import("preact/compat").PropsWithoutRef<VietqrProps & import("../../../types").PayKKaCommonConfig & {
     session: import("../../../core").Session;
     core: import("../../../core").PayKKaCheckout;

package/dist/types/components/wallets/Vietqr/type.d.ts

@@ -1,7 +1,6 @@
-import type { PayKKaError } from '../../..';
-import type { PayKKaCommonConfig, PaymentInfo } from '../../../types';
-import type { FormValidateError } from '../../internal/Form';
-export interface VietqrProps extends PayKKaCommonConfig {
+import type { PayKKaCommonConfig } from '../../../types';
+import type { PaymentCommonProps } from '../../../types/payment';
+export interface VietqrProps extends PayKKaCommonConfig, PaymentCommonProps {
     /**
      * 是否展示邮箱
      * 若配置 true 但创建收银台时已经传了，就展示禁用状态。
@@ -14,16 +13,6 @@ export interface VietqrProps extends PayKKaCommonConfig {
      * 若配置 false 但创建收银台时未传，依旧会展示该输入框。
      */
     showAddress?: boolean;
-    /** 提交表单时触发 */
-    onSubmit?: (formValidateError?: Recordable<FormValidateError[]>) => void;
-    /** 支付成功后触发 */
-    onSuccess?: (data: PaymentInfo) => void;
-    /** 支付失败时触发 */
-    onError?: (error: PayKKaError) => void;
-    /** 支付超时时触发 */
-    onTimeout?: (type: 'retry' | 'channel') => void;
-    /** 收银台已过期时触发 */
-    onExpired?: () => void;
 }
 export interface VietqrRef {
     /** 停止轮询支付结果 */

package/dist/types/components/wallets/Zalopay/Zalopay.d.ts

@@ -1,5 +1,10 @@
 import type { ZalopayProps, ZalopayRef } from './type';
 import './zalopay.scss';
+/**
+ * Zalopay 支付方式
+ * - 表单：邮箱，地址
+ * - 支付：移动端跳转，PC 端展示二维码弹窗
+ */
 export declare const Zalopay: import("preact").FunctionalComponent<import("preact/compat").PropsWithoutRef<ZalopayProps & import("../../../types").PayKKaCommonConfig & {
     session: import("../../../core").Session;
     core: import("../../../core").PayKKaCheckout;

package/dist/types/components/wallets/Zalopay/type.d.ts

@@ -1,7 +1,6 @@
-import type { PayKKaError } from '../../..';
-import type { PayKKaCommonConfig, PaymentInfo } from '../../../types';
-import type { FormValidateError } from '../../internal/Form';
-export interface ZalopayProps extends PayKKaCommonConfig {
+import type { PayKKaCommonConfig } from '../../../types';
+import type { PaymentCommonProps } from '../../../types/payment';
+export interface ZalopayProps extends PayKKaCommonConfig, PaymentCommonProps {
     /**
      * 是否展示邮箱
      * 若配置 true 但创建收银台时已经传了，就展示禁用状态。
@@ -14,16 +13,6 @@ export interface ZalopayProps extends PayKKaCommonConfig {
      * 若配置 false 但创建收银台时未传，依旧会展示该输入框。
      */
     showAddress?: boolean;
-    /** 提交表单时触发 */
-    onSubmit?: (formValidateError?: Recordable<FormValidateError[]>) => void;
-    /** 支付成功后触发 */
-    onSuccess?: (data: PaymentInfo) => void;
-    /** 支付失败时触发 */
-    onError?: (error: PayKKaError) => void;
-    /** 支付超时时触发 */
-    onTimeout?: (type: 'retry' | 'channel') => void;
-    /** 收银台已过期时触发 */
-    onExpired?: () => void;
 }
 export interface ZalopayRef {
     /** 停止轮询支付结果 */

package/dist/types/components/wallets/index.d.ts

@@ -1,3 +1,10 @@
+export * from './Boost';
+export * from './GrabPay';
+export * from './LinePay';
+export * from './NinePay';
+export * from './MayBankQRPay';
+export * from './ShopeePay';
+export * from './TNGWallet';
 export * from './GCash';
 export * from './Paymaya';
 export * from './Zalopay';
@@ -6,3 +13,10 @@ export * from './Pix';
 export * from './PicPay';
 export * from './PagaWallet';
 export * from './OpayWallet';
+export * from './OVO';
+export * from './Bancontact';
+export * from './Blik';
+export * from './IDeal';
+export * from './Skrill';
+export * from './P24';
+export * from './Trustly';

package/dist/types/components/wallets/type.d.ts

@@ -1,9 +1,23 @@
-/** 钱包支付方式公共配置 */
-export interface WalletCommonProps {
+/** 钱包自定义配置，主要作用于展示 */
+export interface WalletCustomProps {
+    /**
+     * 是否展示邮箱
+     * 若配置 true 但创建收银台时已经传了，就展示禁用状态。
+     * 若配置 false 但创建收银台时未传，依旧会展示该输入框。
+     * @defaultValue false
+     */
+    showEmail?: boolean;
+    /**
+     * 是否展示邮箱
+     * 若配置 true 但创建收银台时已经传了，还是展示，先不禁用。
+     * 若配置 false 但创建收银台时未传，依旧会展示该输入框。
+     * @defaultValue false
+     */
+    showAddress?: boolean;
 }
 /** 通过跳转支付的钱包配置 */
-export interface WalletRedirectProps extends WalletCommonProps {
+export interface WalletRedirectProps {
 }
 /** 通过弹窗支付的钱包配置 */
-export interface WalletQRCodeModalProps extends WalletCommonProps {
+export interface WalletQRCodeModalProps {
 }

package/dist/types/constant.d.ts

@@ -33,6 +33,13 @@ export declare enum PaymentMethod {
     PIC_PAY = "PIC_PAY",
     OPAY_WALLET = "OPAY_WALLET",
     PAGA_WALLET = "PAGA_WALLET",
+    BANCONTACT = "BANCONTACT",
+    IDEAL = "IDEAL",
+    BLIK = "BLIK",
+    OVO = "OVO",
+    SKRILL = "SKRILL",
+    TRUSTLY = "TRUSTLY",
+    P24 = "P24",
     /** 目前没用 */
     SEPA_DEBIT = "SEPA_DEBIT"
 }
@@ -60,7 +67,14 @@ export declare enum PaymentCategory {
     PIX = "pix",
     PIC_PAY = "picPay",
     OPAY_WALLET = "opayWallet",
-    PAGA_WALLET = "pagaWallet"
+    PAGA_WALLET = "pagaWallet",
+    BANCONTACT = "bancontact",
+    IDEAL = "ideal",
+    BLIK = "blik",
+    OVO = "ovo",
+    SKRILL = "skrill",
+    TRUSTLY = "trustly",
+    P24 = "p24"
 }
 export declare const PaymentMethod2CategoryMap: Partial<Record<PaymentMethod, PaymentCategory>>;
 export declare const PaymentCategory2MethodMap: Partial<Record<PaymentCategory, PaymentMethod[]>>;

package/dist/types/core/address.d.ts

@@ -1,5 +1,4 @@
 import { EAddressType } from '../constant';
-import type { I18n } from '../i18n';
 interface Option {
     label: string;
     value: string;
@@ -24,13 +23,11 @@ export declare class AddressCore {
     private provinceOptions;
     private cityOptions;
     private addressState;
-    private i18n;
+    private locale;
     private addressFormat;
     private validateAllFields;
     constructor();
-    setI18n({ i18n }: {
-        i18n: I18n;
-    }): void;
+    setLocale(locale: string): void;
     requestCountryOption(): Promise<void>;
     countryOptionReady(): Promise<boolean | null>;
     getCountryOption(): Option[];

package/dist/types/core/checkout.d.ts

@@ -3,9 +3,10 @@ import { type CoreProps, type PayKKaEnvConfig, type PayKKaInitConfiguration } fr
 import { type ComponentInst } from './create';
 import { Session } from './session';
 import getFraudDetectionInstance from '../out/fraud-detection';
-import type { PaymentMethod } from '../constant';
 import { AddressCore } from './address';
 import { PayKKaTheme } from './theme';
+import { PayKKaLogger } from './logger';
+import { PayKKaPayment } from './payment';
 export type FraudDetectionType = ReturnType<typeof getFraudDetectionInstance>;
 /**
  * 收银台实例
@@ -13,13 +14,6 @@ export type FraudDetectionType = ReturnType<typeof getFraudDetectionInstance>;
  */
 export declare class PayKKaCheckout {
     #private;
-    /** 当前正在处理的支付方式，在第三方支付页面跳回收银台时，会通过 url 参数传递过来 */
-    processingPaymentMethod: PaymentMethod | null;
-    /**
-     * 当前启用的支付方式（禁用则展示禁用样式）
-     * 在 DropIn 且有正在处理的支付方式时，会设置为当前支付方式，并把其他支付方式设为禁用
-     */
-    enablePaymentMethod: import("@preact/signals").Signal<PaymentMethod | null>;
     constructor(config: PayKKaInitConfiguration);
     init(): Promise<void>;
     private initCheckoutConfig;
@@ -32,14 +26,20 @@ export declare class PayKKaCheckout {
     private initLocale;
     private initTheme;
     private initOtherData;
+    private initLogger;
     get session(): Session;
     get theme(): PayKKaTheme;
     get envConfig(): PayKKaEnvConfig;
     get config(): PayKKaInitConfiguration;
     get id(): string;
-    /** 创建组件，把 session 作为组件的 props 传递 */
+    /**
+     * 创建组件
+     * @param component 组件
+     * @param props 组件 props
+     */
     create<P extends Recordable>(component: ComponentType<P> | ((props: P) => JSX.Element), props?: Partial<P> | null): ComponentInst<P>;
     getCoreProps(): CoreProps;
-    resetEnablePaymentMethod(): void;
     getAddressCore(): AddressCore;
+    get logger(): PayKKaLogger | undefined;
+    get payment(): PayKKaPayment | undefined;
 }

package/dist/types/core/create-child.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/core/environment.d.ts

@@ -4,6 +4,11 @@
  * 为什么不用环境变量？因为需要打包成 NPM 包，环境由用户传入
  */
 import type { PayKKaEnvType } from '../types';
+export declare const DEV_ORIGIN = "https://checkout-dev.eu.paykka.com";
+export declare const FAT_ORIGIN = "https://checkout-fat.eu.paykka.com";
+export declare const SANDBOX_ORIGIN = "https://checkout-sandbox.aq.paykka.com";
+export declare const HK_ORIGIN = "https://checkout.aq.paykka.com";
+export declare const EU_ORIGIN = "https://checkout.eu.paykka.com";
 export declare const origin2Env: Record<string, PayKKaEnvType>;
 export declare const apiEnv: Record<PayKKaEnvType, string>;
 export declare const cdnEnv: Record<PayKKaEnvType, string>;

package/dist/types/core/error.d.ts

@@ -1,5 +1,5 @@
 /** 前端错误信息枚举，为了防止与后端 code 冲突做的区分 */
-export declare enum EPayKKaErrorMessage {
+export declare enum EPayKKaErrorReason {
     /** worldpay ddc 错误 */
     DDC_ERROR = "DDC_ERROR",
     /** worldpay ddc 超时 */
@@ -20,11 +20,17 @@ export declare enum EPayKKaError {
     TIMEOUT = "TIMEOUT"
 }
 export declare class PayKKaError extends Error {
+    /** 错误名称，用来在上报时进行区分 */
+    name: string;
     /** 错误类型 */
     type: keyof typeof EPayKKaError;
-    /** 错误代码 */
+    /** 错误信息 */
+    msg?: string;
+    /** 错误码 */
     code?: string;
-    constructor(type: keyof typeof EPayKKaError, message?: string | EPayKKaErrorMessage, info?: {
+    /** 错误原因 */
+    cause?: any;
+    constructor(type: keyof typeof EPayKKaError, msg?: string | EPayKKaErrorReason, info?: {
         code?: string;
         cause?: any;
     });

package/dist/types/core/index.d.ts

@@ -5,3 +5,5 @@ export * from './query';
 export * from './checkout';
 export * from './error';
 export * from './theme';
+export * from './create-child';
+export * from './logger';

package/dist/types/core/logger.d.ts

@@ -0,0 +1,55 @@
+/**
+ * 监控上报相关工具函数
+ *
+ * @see {@link https://jlpay.yuque.com/fsx9z5/zxl6gq/gllvvfa22s7mat85#bDnRM}
+ */
+import type { PayKKaError } from '../core';
+import { type EventData, type EventType, type PayKKaEnvType } from '../types';
+type LoggerCollect = 'ENV' | 'BEHAVIOR';
+interface LoggerOptions {
+    /** 监控项目 id */
+    pid?: string;
+    /** 监控会话 id */
+    sid?: string;
+    /** 监控环境 */
+    env?: PayKKaEnvType;
+    /** 收集监控数据，默认收集所有数据 */
+    collect?: LoggerCollect[];
+}
+export interface RequestLogInfo {
+    /** 请求接口 */
+    api: string;
+    /** 是否调用成功 */
+    success: boolean;
+    /** 接口耗时 */
+    time: number;
+    /** 返回码 */
+    code?: string;
+    /** 返回信息 */
+    msg?: string;
+    /** API请求开始时间戳 */
+    timestamp?: number;
+    /** 业务状态码 */
+    retCode?: string;
+}
+/** 监控上报，只上报收银台相关日志 */
+export declare class PayKKaLogger {
+    constructor();
+    init(options?: LoggerOptions): Promise<void>;
+    /** 上报自定义事件 */
+    reportCustomEvent(event: EventType, data?: EventData<EventType>): void;
+    /** 上报错误 */
+    reportErrorEvent(error: PayKKaError): void;
+    /** 上报请求 */
+    reportRequestEvent(request: RequestLogInfo): void;
+    setLoggerOptions(options: Recordable): void;
+    /**
+     * 在日志上报前执行，拦截部分日志上报
+     * 1. 过滤接口日志，只上报收银台相关接口，用接口域名判断
+     * 2. 过滤错误日志，只上报包含特定属性的错误
+     * 3. 过滤资源加载日志，只上报收银台相关资源
+     */
+    private beforeSendEvent;
+    private load;
+}
+export {};

package/dist/types/core/payment.d.ts

@@ -0,0 +1,21 @@
+import { PaymentMethod } from '../constant';
+import type { Session } from './session';
+/** 储存全局支付相关状态和方法 */
+export declare class PayKKaPayment {
+    #private;
+    /**
+     * 当前正在处理(支付或查询)的支付方式
+     * @remarks
+     * 当 currPaymentMethod 不为 null，就表示当前处于支付或查询状态，所有支付方式表单、按钮禁用，也无法切换支付方式
+     */
+    currPaymentMethod: import("@preact/signals").Signal<PaymentMethod | null>;
+    constructor(session: Session);
+    init(): void;
+    /**
+     * 根据 url 参数获取当前正在处理(支付或查询)的支付方式
+     * @remarks
+     * 如果 url 参数中的支付方式不在支持的支付方式列表中，则不做处理
+     */
+    getCurrPaymentMethodByUrlParam(): void;
+    resetCurrPaymentMethod(): void;
+}

package/dist/types/hooks/index.d.ts

@@ -4,3 +4,4 @@ export * from './usePayState';
 export * from './useRetry';
 export * from './useBreakpoints';
 export * from './usePayment';
+export * from './useBaseWallet';

package/dist/types/hooks/useBaseWallet.d.ts

@@ -0,0 +1,54 @@
+import { PaymentMethod } from '../constant';
+import type { WalletCustomProps, WalletRedirectProps, WalletQRCodeModalProps } from '../components/wallets/type';
+import type { BasePaymentInfo, CoreProps } from '../types';
+import { type FieldStatusConfig } from '../api';
+import type { PaymentButtonStatus } from '../components/PaymentButton';
+import type { PaymentCommonProps, PaymentMethodContext } from '../types/payment';
+export type BaseWalletProps = WalletCustomProps & WalletRedirectProps & WalletQRCodeModalProps & CoreProps & PaymentCommonProps;
+export type BaseWalletOptions = {
+    /** 轮询超时时间 */
+    retryTimeout?: number;
+    /** 是否支持二维码支付弹窗，若不支持，则直接采用跳转方式 */
+    supportQRCodeModal?: boolean;
+    /** 获取最终处理过的表单数据 */
+    getFormData: () => Recordable;
+    /** 处理支付中状态 */
+    onProcessing?: (paymentInfo: BasePaymentInfo) => void | Promise<void>;
+};
+/**
+ * 基础钱包通用逻辑
+ * @param paymentMethod - 支付方式
+ * @param baseProps - 钱包组件 props
+ */
+export declare const useBaseWallet: (paymentMethod: PaymentMethod, baseProps: BaseWalletProps, options: BaseWalletOptions) => {
+    payment: (timeout?: number) => Promise<{
+        end: boolean;
+    }>;
+    search: (timeout?: number) => Promise<{
+        end: boolean;
+    }>;
+    startRetry: (timeout?: number) => void;
+    stopRetry: () => void;
+    setPaymentButtonStatus: import("preact/hooks").Dispatch<import("preact/hooks").StateUpdater<PaymentButtonStatus>>;
+    paymentButtonStatus: PaymentButtonStatus;
+    errorMessage: string;
+    setErrorMessage: import("preact/hooks").Dispatch<import("preact/hooks").StateUpdater<string>>;
+    showQRCodeModal: boolean;
+    setShowQRCodeModal: import("preact/hooks").Dispatch<import("preact/hooks").StateUpdater<boolean>>;
+    qrCodeInfo: {
+        /** 二维码地址 */
+        qrCode: string;
+        /** 二维码过期时间 */
+        expiredTime?: string | undefined;
+    } | undefined;
+    setQrCodeInfo: import("preact/hooks").Dispatch<import("preact/hooks").StateUpdater<{
+        /** 二维码地址 */
+        qrCode: string;
+        /** 二维码过期时间 */
+        expiredTime?: string | undefined;
+    } | undefined>>;
+    processCloseQRCodeModal: () => void;
+    isEnabled: boolean;
+    fieldStatus: FieldStatusConfig | undefined;
+    getPaymentMethodContext: () => PaymentMethodContext;
+};

package/dist/types/hooks/usePayState.d.ts

@@ -1,5 +1,5 @@
 import type { PayKKaCheckout, Session } from '../core';
-export declare function usePayState(session: Session, core?: PayKKaCheckout): {
+export declare const usePayState: (session: Session, core?: PayKKaCheckout) => {
     validated: boolean;
     setValidated: import("preact/hooks").Dispatch<import("preact/hooks").StateUpdater<boolean>>;
     errorMsg: string;
@@ -8,8 +8,10 @@ export declare function usePayState(session: Session, core?: PayKKaCheckout): {
     fraudDetection: {
         getFraudDetectionId: (options?: {
             bin?: string | undefined;
+            hiddenIframeName?: string | undefined;
         } | undefined) => Promise<string>;
         createFraudDetection: () => Promise<void>;
     } | null;
     sessionReady: boolean;
+    disabled: boolean;
 };

package/dist/types/hooks/useRetry.console-tests.d.ts

@@ -0,0 +1,41 @@
+/** 纯函数：阶梯解析 + 抖动公式（固定 Math.random，便于对照） */
+export declare function runPureConsoleTests(): {
+    ok: boolean;
+    passed: number;
+    failed: number;
+    failures: string[];
+};
+/** Hook：固定 interval，cb 第 3 次 end；校验首段延迟、次数、resolve 结果 */
+export declare function runHookFixedIntervalDemo(): Promise<{
+    ok: boolean;
+    detail: string[];
+}>;
+/** Hook：短阶梯 + pollTiers；校验 cb 次数与 resolve */
+export declare function runHookPollTiersDemo(): Promise<{
+    ok: boolean;
+    detail: string[];
+}>;
+export type UseRetryConsoleRunSummary = {
+    pure: {
+        ok: boolean;
+        passed: number;
+        failed: number;
+        failures: string[];
+    };
+    hookFixed: {
+        ok: boolean;
+        detail: string[];
+    };
+    hookTiers: {
+        ok: boolean;
+        detail: string[];
+    };
+    allOk: boolean;
+};
+export declare function runAll(): Promise<UseRetryConsoleRunSummary>;
+export declare const __paykkaUseRetryTests: {
+    readonly runPureConsoleTests: typeof runPureConsoleTests;
+    readonly runHookFixedIntervalDemo: typeof runHookFixedIntervalDemo;
+    readonly runHookPollTiersDemo: typeof runHookPollTiersDemo;
+    readonly runAll: typeof runAll;
+};

package/dist/types/hooks/useRetry.d.ts

@@ -1,15 +1,34 @@
-export declare function useRetry(fn: (timeout: number) => Promise<{
+export declare const withRetryIntervalJitter: (interval: number) => number;
+export type RetryPollTier = {
+    /**
+     * 已流逝时间（毫秒）严格小于本值时用本档 `interval`。
+     * 最后一档常用 {@link Number.POSITIVE_INFINITY}，表示之后不再换档；总轮询时长仍由 `useRetry` 的 `timeout` 决定。
+     */
+    until: number;
+    /** 该档内每轮间隔；值为毫秒 */
+    interval: number;
+};
+/**
+ * 前 15s 每 3s 一次
+ * 15s～60s 每 6s 一次
+ * 之后每 12s 一次，直至达到外层设置的轮询时间
+ */
+export declare const DEFAULT_RETRY_POLL_TIERS: RetryPollTier[];
+export declare const getRetryIntervalForElapsed: (elapsedMs: number, tiers?: RetryPollTier[]) => number;
+export declare const useRetry: (cb: (timeout: number) => Promise<{
     end: boolean;
     res?: any;
-}>, { timeout, interval, onTimeout, onEnd }: {
+}>, { timeout, interval, pollTiers, onTimeout, onEnd }?: {
     timeout?: number;
     interval?: number;
+    pollTiers?: RetryPollTier[];
     onTimeout?: () => void;
     onEnd?: (res: any) => void;
-}): {
+}) => {
     start: (opts?: {
         timeout?: number;
         interval?: number;
+        pollTiers?: RetryPollTier[];
     }) => Promise<unknown>;
     stop: () => void;
 };