@paykka/card-checkout-ui 0.13.17 → 0.14.0

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

@@ -18,11 +18,4 @@ export * from './CardIBANField';
 export * from './EncryptedCard';
 export * from './CombinedCardInfo';
 export * from './DropIn';
-export * from './Boost';
-export * from './LinePay';
-export * from './MayBankQRPay';
-export * from './NinePay';
-export * from './GrabPay';
-export * from './TNGWallet';
-export * from './ShopeePay';
 export * from './wallets';

package/dist/types/components/internal/CheckBox/type.d.ts

@@ -1,6 +1,7 @@
-import type { CustomAttributes } from "../../../types";
+import type { CustomAttributes } from '../../../types';
 export interface CheckBoxProps extends CustomAttributes<HTMLDivElement> {
     checked?: boolean;
     label?: string;
+    disabled?: boolean;
     onChange?: (checked: boolean) => void;
 }

package/dist/types/components/internal/Select/type.d.ts

@@ -9,7 +9,7 @@ export type SelectOption = BaseSelectOption<string | number>;
 export interface SelectRef {
     blur: () => void;
 }
-export interface SelectProps extends CustomAttributes<HTMLInputElement, 'onBlur' | 'onFocus' | 'placeholder'> {
+export interface SelectProps extends CustomAttributes<HTMLInputElement, 'onBlur' | 'onFocus' | 'placeholder' | 'disabled'> {
     /** 选中值 */
     value?: string | number;
     /** 校验状态 */

package/dist/types/components/internal/icons/IconArrowDown.d.ts

@@ -1,2 +1,2 @@
 import type { IconProps } from './type';
-export declare function IconArrowDown({ size, style, className }: IconProps): import("preact").JSX.Element;
+export declare const IconArrowDown: ({ size, style, className }: IconProps) => import("preact").JSX.Element;

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

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

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

@@ -1,5 +1,5 @@
-import type { PayKKaCommonConfig } from '../../types';
-import type { PaymentCommonProps } from '../../types/payment';
+import type { PayKKaCommonConfig } from '../../../types';
+import type { PaymentCommonProps } from '../../../types/payment';
 export interface BoostProps extends PayKKaCommonConfig, PaymentCommonProps {
     /**
      * 是否展示邮箱

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

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

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

@@ -1,10 +1,10 @@
 import type { GrabPayProps } from './type';
 import type { GrabPayRef } from './type';
 import './grab-pay.scss';
-export declare const GrabPay: import("preact").FunctionalComponent<import("preact/compat").PropsWithoutRef<GrabPayProps & import("../../types").PayKKaCommonConfig & {
-    session: import("../../core").Session;
-    core: import("../../core").PayKKaCheckout;
-    threeDSFrame?: import("../../types").ThreeDSFrameConfig | undefined;
+export declare const GrabPay: import("preact").FunctionalComponent<import("preact/compat").PropsWithoutRef<GrabPayProps & import("../../../types").PayKKaCommonConfig & {
+    session: import("../../../core").Session;
+    core: import("../../../core").PayKKaCheckout;
+    threeDSFrame?: import("../../../types").ThreeDSFrameConfig | undefined;
     isDropIn?: boolean | undefined;
 }> & {
     ref?: import("preact").Ref<GrabPayRef> | undefined;

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

@@ -0,0 +1,17 @@
+import type { PayKKaCommonConfig } from '../../../types';
+import type { PaymentCommonProps } from '../../../types/payment';
+import type { WalletRedirectProps, WalletCustomProps } from '../type';
+export interface GrabPayProps extends PayKKaCommonConfig, WalletRedirectProps, WalletCustomProps, PaymentCommonProps {
+}
+export interface GrabPayRef {
+    /** 停止轮询支付结果 */
+    stopRetry: () => void;
+    /** 开始轮询支付结果 */
+    startRetry: (timeout?: number) => void;
+    /** 更新表单地址 */
+    updateAddress: () => void;
+    /** 更新表单邮箱 */
+    updateEmail: () => void;
+    /** 不展示支付按钮时，可调用该方法进行支付 */
+    payment: () => void;
+}

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

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

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

@@ -1,5 +1,5 @@
-import type { PayKKaCommonConfig } from '../../types';
-import type { PaymentCommonProps } from '../../types/payment';
+import type { PayKKaCommonConfig } from '../../../types';
+import type { PaymentCommonProps } from '../../../types/payment';
 export interface LinePayProps extends PayKKaCommonConfig, PaymentCommonProps {
     /**
      * 是否展示邮箱

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

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

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

@@ -1,5 +1,5 @@
-import type { PayKKaCommonConfig } from '../../types';
-import type { PaymentCommonProps } from '../../types/payment';
+import type { PayKKaCommonConfig } from '../../../types';
+import type { PaymentCommonProps } from '../../../types/payment';
 export interface MayBankQRPayProps extends PayKKaCommonConfig, PaymentCommonProps {
     /**
      * 是否展示邮箱

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

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

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

@@ -1,5 +1,5 @@
-import type { PayKKaCommonConfig } from '../../types';
-import type { PaymentCommonProps } from '../../types/payment';
+import type { PayKKaCommonConfig } from '../../../types';
+import type { PaymentCommonProps } from '../../../types/payment';
 export interface NinePayProps extends PayKKaCommonConfig, PaymentCommonProps {
     /**
      * 是否展示邮箱

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

@@ -1,5 +1,10 @@
 import type { OpayWalletProps, OpayWalletRef } from './type';
 import './opay-wallet.scss';
+/**
+ * OpayWallet 支付方式
+ * - 表单：邮箱，地址
+ * - 支付：跳转至 OpayWallet 页面完成支付
+ */
 export declare const OpayWallet: import("preact").FunctionalComponent<import("preact/compat").PropsWithoutRef<OpayWalletProps & import("../../../types").PayKKaCommonConfig & {
     session: import("../../../core").Session;
     core: import("../../../core").PayKKaCheckout;

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

@@ -1,5 +1,10 @@
 import type { PagaWalletProps, PagaWalletRef } from './type';
 import './paga-wallet.scss';
+/**
+ * PagaWallet 支付方式
+ * - 表单：邮箱，地址
+ * - 支付：跳转至 PagaWallet 页面完成支付
+ */
 export declare const PagaWallet: import("preact").FunctionalComponent<import("preact/compat").PropsWithoutRef<PagaWalletProps & import("../../../types").PayKKaCommonConfig & {
     session: import("../../../core").Session;
     core: import("../../../core").PayKKaCheckout;

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

@@ -1,5 +1,10 @@
 import type { PaymayaProps, PaymayaRef } from './type';
 import './paymaya.scss';
+/**
+ * Paymaya 支付方式
+ * - 表单：邮箱，地址
+ * - 支付：跳转至 Paymaya 页面完成支付
+ */
 export declare const Paymaya: import("preact").FunctionalComponent<import("preact/compat").PropsWithoutRef<PaymayaProps & import("../../../types").PayKKaCommonConfig & {
     session: import("../../../core").Session;
     core: import("../../../core").PayKKaCheckout;

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

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

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

@@ -1,5 +1,5 @@
-import type { PayKKaCommonConfig } from '../../types';
-import type { PaymentCommonProps } from '../../types/payment';
+import type { PayKKaCommonConfig } from '../../../types';
+import type { PaymentCommonProps } from '../../../types/payment';
 export interface ShopeePayProps extends PayKKaCommonConfig, PaymentCommonProps {
     /**
      * 是否展示邮箱

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

@@ -2,18 +2,6 @@ import type { PayKKaCommonConfig } from '../../../types';
 import type { WalletCustomProps, WalletRedirectProps } from '../type';
 import type { PaymentCommonProps } from '../../../types/payment';
 export interface SkrillProps extends PayKKaCommonConfig, WalletRedirectProps, WalletCustomProps, PaymentCommonProps {
-    /**
-     * 是否展示邮箱
-     * 若配置 true 但创建收银台时已经传了，就展示禁用状态。
-     * 若配置 false 但创建收银台时未传，依旧会展示该输入框。
-     */
-    showEmail?: boolean;
-    /**
-     * 是否展示地址
-     * 若配置 true 但创建收银台时已经传了，就展示禁用状态。
-     * 若配置 false 但创建收银台时未传，依旧会展示该输入框。
-     */
-    showAddress?: boolean;
 }
 export interface SkrillRef {
     /** 停止轮询支付结果 */

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,5 +1,5 @@
-import type { PayKKaCommonConfig } from '../../types';
-import type { PaymentCommonProps } from '../../types/payment';
+import type { PayKKaCommonConfig } from '../../../types';
+import type { PaymentCommonProps } from '../../../types/payment';
 export interface TNGWalletProps extends PayKKaCommonConfig, PaymentCommonProps {
     /**
      * 是否展示邮箱

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/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/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';

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

@@ -3,10 +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>;
 /**
  * 收银台实例
@@ -14,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;
@@ -46,7 +39,7 @@ export declare class PayKKaCheckout {
      */
     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/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/useBaseWallet.d.ts

@@ -1,6 +1,6 @@
 import { PaymentMethod } from '../constant';
 import type { WalletCustomProps, WalletRedirectProps, WalletQRCodeModalProps } from '../components/wallets/type';
-import type { CoreProps } from '../types';
+import type { BasePaymentInfo, CoreProps } from '../types';
 import { type FieldStatusConfig } from '../api';
 import type { PaymentButtonStatus } from '../components/PaymentButton';
 import type { PaymentCommonProps, PaymentMethodContext } from '../types/payment';
@@ -13,7 +13,7 @@ export type BaseWalletOptions = {
     /** 获取最终处理过的表单数据 */
     getFormData: () => Recordable;
     /** 处理支付中状态 */
-    onProcessing?: () => void;
+    onProcessing?: (paymentInfo: BasePaymentInfo) => void | Promise<void>;
 };
 /**
  * 基础钱包通用逻辑

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;
 };

package/dist/types/out/base-fraud-detection.d.ts

@@ -18,6 +18,7 @@ export declare abstract class BaseFraudDetection {
     protected timeout: number;
     private timer;
     private initPromise;
+    private fraudDetectionStartTime?;
     constructor(params: {
         channel: ChannelCode;
         channelConfig?: ChannelSDKConfig;

package/dist/types/out/config.d.ts

@@ -14,7 +14,7 @@ export declare const STRIPE_RADAR_SCRIPT_ORIGIN = "https://js.stripe.com";
 export declare const STRIPE_RADAR_SCRIPT_URL = "https://js.stripe.com/v3/";
 /** ddc 超时时间, 15s */
 export declare const DDC_TIMEOUT = 15000;
-/** stripe 超时时间, 10s */
+/** stripe 超时时间, 12s */
 export declare const STRIPE_RADAR_TIMEOUT = 12000;
 /** 默认超时时间, 10s */
 export declare const DEFAULT_TIMEOUT = 10000;

package/dist/types/out/fraud-detection.d.ts

@@ -1,8 +1,8 @@
-import { type CollModeType } from '../types';
 import type { FraudDetectionConfig, FraudDetectionOptions } from './types';
 type FraudDetectionType = {
     getFraudDetectionId: (options?: {
         bin?: string;
+        hiddenIframeName?: string;
     }) => Promise<string>;
     createFraudDetection: () => Promise<void>;
 };
@@ -11,11 +11,5 @@ export default function getFraudDetectionInstance(config: FraudDetectionConfig,
  * 内部配置
  * @internal
  */
-options?: FraudDetectionOptions, 
-/**
- * 可用渠道列表
- * 仅供Hosted等页面收银台使用，不能让用户知道我们有哪些渠道
- * @internal
- */
-mode?: CollModeType[]): FraudDetectionType;
+options?: FraudDetectionOptions): FraudDetectionType;
 export {};

package/dist/types/out/types.d.ts

@@ -3,9 +3,11 @@ export type FraudDetectionOptions = {
     sessionMode?: string;
 } & Pick<PayKKaInitConfiguration, 'onEvent'>;
 export type FraudDetectionConfig = {
-    env?: FraudDetectionEnv;
     clientKey: string;
+    /** 环境，默认 eu */
+    env?: FraudDetectionEnv;
 };
 export interface FraudDetectionInitOption {
     bin?: string;
+    hiddenIframeName?: string;
 }

package/dist/types/out/worldpay-ddc-manager.d.ts

@@ -1,18 +1,17 @@
 import type { ChannelSDKConfig } from '../api/modules/risk';
 import type { FraudDetectionInitOption, FraudDetectionOptions } from './types';
 /**
- * 管理多个 WorldpayDDC 实例：按 key（'' 或 bin）分配实例，并串行执行 init，避免回包错配。
- * fraud-detection 只依赖本类，不写 map / lock 等 Worldpay 专属逻辑。
+ * 每次支付都要最新 ddc id：
+ * - 不按 bin 缓存、不用兜底 id
+ * - 每次 init 都 new 一个 WorldpayDDC 并采集
  */
 export declare class WorldpayDDCManager {
     private static instance;
     private options?;
     private channelConfig?;
-    /** bin 到 WorldpayDDC 实例的映射 */
-    private worldpayDDCMap;
+    /** 本次（最近一次）init 对应的 DDC 实例 */
+    private currentDDC;
     constructor(options?: FraudDetectionOptions, channelConfig?: ChannelSDKConfig);
-    /** 创建 WorldpayDDC，如果缓存中有就用缓存的 */
-    private createWorldpayDDC;
     init(options?: FraudDetectionInitOption): Promise<void>;
-    getFraudDetectionId(bin: string): string | undefined | null;
+    getFraudDetectionId(): string | undefined | null;
 }