@youidian/sdk 3.3.10 → 3.4.2

package/dist/client.d.cts

@@ -1,5 +1,33 @@
-import { H as HostedFrameModal } from './login-DerOcXcH.cjs';
-export { L as LoginCallbackOptions, a as LoginDisplayMode, b as LoginEventData, c as LoginEventType, e as LoginParams, f as LoginResult, g as LoginUI, h as LoginUIOptions, i as createLoginUI, j as handleLoginCallbackIfPresent } from './login-DerOcXcH.cjs';
+import { H as HostedFrameModal } from './login-Dqemys65.cjs';
+export { L as LoginCallbackOptions, a as LoginDisplayMode, b as LoginEventData, c as LoginEventType, e as LoginParams, f as LoginResult, g as LoginUI, h as LoginUIOptions, i as createLoginUI, j as handleLoginCallbackIfPresent } from './login-Dqemys65.cjs';
+
+type LoginDeviceType = "desktop" | "mobile" | "tablet" | "unknown";
+type LoginEnvironmentInput = {
+    coarsePointer?: boolean;
+    maxTouchPoints?: number;
+    platform?: string;
+    standalone?: boolean;
+    userAgent?: string;
+    userAgentDataMobile?: boolean;
+};
+type LoginEnvironment = {
+    deviceType: LoginDeviceType;
+    isAndroid: boolean;
+    isCoarsePointer: boolean;
+    isDesktop: boolean;
+    isIOS: boolean;
+    isIPadOS: boolean;
+    isMobile: boolean;
+    isStandalone: boolean;
+    isTablet: boolean;
+    isTouch: boolean;
+    isWeChat: boolean;
+    maxTouchPoints: number;
+    platform: string;
+    shouldUseRedirectLogin: boolean;
+    userAgent: string;
+};
+declare function detectLoginEnvironment(input?: LoginEnvironmentInput): LoginEnvironment;
 
 /**
  * Youidian Payment SDK - Client Module
@@ -10,7 +38,7 @@ export { L as LoginCallbackOptions, a as LoginDisplayMode, b as LoginEventData,
 /**
  * Payment event types from checkout pages
  */
-type PaymentEventType = "PAYMENT_SUCCESS" | "PAYMENT_CANCELLED" | "PAYMENT_CLOSE" | "PAYMENT_RESIZE" | "PAYMENT_STARTED";
+type PaymentEventType = "PAYMENT_READY" | "PAYMENT_SUCCESS" | "PAYMENT_CANCELLED" | "PAYMENT_CLOSE" | "PAYMENT_RESIZE" | "PAYMENT_STARTED";
 /**
  * Payment event data from postMessage
  */
@@ -28,6 +56,13 @@ interface OrderStatus {
     paidAt?: string;
     channelTransactionId?: string;
 }
+interface PaymentUIThemeColors {
+    primary?: string;
+    secondary?: string;
+    foreground?: string;
+    muted?: string;
+    surface?: string;
+}
 /**
  * Payment UI Options
  */
@@ -36,8 +71,23 @@ interface PaymentUIOptions {
     onSuccess?: (orderId?: string) => void;
     onCancel?: (orderId?: string) => void;
     onClose?: () => void;
+    onFallbackBlocked?: (url: string) => void;
+    onFallbackOpen?: (url: string) => void;
+    onFallbackVisible?: () => void;
     /** Origin to validate postMessage (defaults to '*', set for security) */
     allowedOrigin?: string;
+    /** Theme colors for SDK fallback/loading chrome. Defaults to Youidian green. */
+    theme?: PaymentUIThemeColors;
+    /** Text for the fallback button shown when the checkout iframe is slow. */
+    fallbackButtonText?: string;
+    /** Text for retrying the embedded checkout iframe. */
+    fallbackRetryText?: string;
+    /** How long to wait for PAYMENT_READY or PAYMENT_RESIZE. Defaults to 8000ms. */
+    iframeLoadTimeoutMs?: number;
+    /** Description shown while the hosted checkout iframe is loading. */
+    loadingDescription?: string;
+    /** Title shown while the hosted checkout iframe is loading. */
+    loadingTitle?: string;
 }
 /**
  * Poll Options
@@ -94,6 +144,16 @@ declare class PaymentUI extends HostedFrameModal<PaymentEventData> {
     private activeOrderId;
     private paymentCompleted;
     private cancelRequestedOrderId;
+    private iframeFallbackPanel;
+    private iframeLoadingPanel;
+    private iframeLoadTimer;
+    private iframeReady;
+    private cleanupPaymentFrameState;
+    private markPaymentIframeReady;
+    private showPaymentIframeLoading;
+    private openFallbackPaymentPage;
+    private showPaymentIframeFallback;
+    private startPaymentIframeWatchdog;
     private cancelHostedOrder;
     /**
      * Opens the payment checkout page in an iframe modal.
@@ -101,6 +161,7 @@ declare class PaymentUI extends HostedFrameModal<PaymentEventData> {
      * @param options - UI options
      */
     openPayment(urlOrParams: string | PaymentParams, options?: PaymentUIOptions): void;
+    close(): void;
     /**
      * Poll order status from integrator's API endpoint
      * @param statusUrl - The integrator's API endpoint to check order status
@@ -109,9 +170,18 @@ declare class PaymentUI extends HostedFrameModal<PaymentEventData> {
      */
     pollOrderStatus(statusUrl: string, options?: PollOptions): Promise<OrderStatus>;
 }
+interface WechatMessageBindingUIOptions {
+    bindingUrl: string;
+    displayMode?: "redirect" | "popup";
+    popupName?: string;
+}
+declare class MessageUI {
+    openWechatBinding(options: WechatMessageBindingUIOptions): void;
+}
+declare function createMessageUI(): MessageUI;
 /**
  * Convenience function to create a PaymentUI instance
  */
 declare function createPaymentUI(): PaymentUI;
 
-export { type OrderStatus, type PaymentEventData, type PaymentEventType, type PaymentParams, PaymentUI, type PaymentUIOptions, type PollOptions, createPaymentUI };
+export { type LoginDeviceType, type LoginEnvironment, type LoginEnvironmentInput, MessageUI, type OrderStatus, type PaymentEventData, type PaymentEventType, type PaymentParams, PaymentUI, type PaymentUIOptions, type PaymentUIThemeColors, type PollOptions, type WechatMessageBindingUIOptions, createMessageUI, createPaymentUI, detectLoginEnvironment };

package/dist/client.d.ts

@@ -1,5 +1,33 @@
-import { H as HostedFrameModal } from './login-DerOcXcH.js';
-export { L as LoginCallbackOptions, a as LoginDisplayMode, b as LoginEventData, c as LoginEventType, e as LoginParams, f as LoginResult, g as LoginUI, h as LoginUIOptions, i as createLoginUI, j as handleLoginCallbackIfPresent } from './login-DerOcXcH.js';
+import { H as HostedFrameModal } from './login-Dqemys65.js';
+export { L as LoginCallbackOptions, a as LoginDisplayMode, b as LoginEventData, c as LoginEventType, e as LoginParams, f as LoginResult, g as LoginUI, h as LoginUIOptions, i as createLoginUI, j as handleLoginCallbackIfPresent } from './login-Dqemys65.js';
+
+type LoginDeviceType = "desktop" | "mobile" | "tablet" | "unknown";
+type LoginEnvironmentInput = {
+    coarsePointer?: boolean;
+    maxTouchPoints?: number;
+    platform?: string;
+    standalone?: boolean;
+    userAgent?: string;
+    userAgentDataMobile?: boolean;
+};
+type LoginEnvironment = {
+    deviceType: LoginDeviceType;
+    isAndroid: boolean;
+    isCoarsePointer: boolean;
+    isDesktop: boolean;
+    isIOS: boolean;
+    isIPadOS: boolean;
+    isMobile: boolean;
+    isStandalone: boolean;
+    isTablet: boolean;
+    isTouch: boolean;
+    isWeChat: boolean;
+    maxTouchPoints: number;
+    platform: string;
+    shouldUseRedirectLogin: boolean;
+    userAgent: string;
+};
+declare function detectLoginEnvironment(input?: LoginEnvironmentInput): LoginEnvironment;
 
 /**
  * Youidian Payment SDK - Client Module
@@ -10,7 +38,7 @@ export { L as LoginCallbackOptions, a as LoginDisplayMode, b as LoginEventData,
 /**
  * Payment event types from checkout pages
  */
-type PaymentEventType = "PAYMENT_SUCCESS" | "PAYMENT_CANCELLED" | "PAYMENT_CLOSE" | "PAYMENT_RESIZE" | "PAYMENT_STARTED";
+type PaymentEventType = "PAYMENT_READY" | "PAYMENT_SUCCESS" | "PAYMENT_CANCELLED" | "PAYMENT_CLOSE" | "PAYMENT_RESIZE" | "PAYMENT_STARTED";
 /**
  * Payment event data from postMessage
  */
@@ -28,6 +56,13 @@ interface OrderStatus {
     paidAt?: string;
     channelTransactionId?: string;
 }
+interface PaymentUIThemeColors {
+    primary?: string;
+    secondary?: string;
+    foreground?: string;
+    muted?: string;
+    surface?: string;
+}
 /**
  * Payment UI Options
  */
@@ -36,8 +71,23 @@ interface PaymentUIOptions {
     onSuccess?: (orderId?: string) => void;
     onCancel?: (orderId?: string) => void;
     onClose?: () => void;
+    onFallbackBlocked?: (url: string) => void;
+    onFallbackOpen?: (url: string) => void;
+    onFallbackVisible?: () => void;
     /** Origin to validate postMessage (defaults to '*', set for security) */
     allowedOrigin?: string;
+    /** Theme colors for SDK fallback/loading chrome. Defaults to Youidian green. */
+    theme?: PaymentUIThemeColors;
+    /** Text for the fallback button shown when the checkout iframe is slow. */
+    fallbackButtonText?: string;
+    /** Text for retrying the embedded checkout iframe. */
+    fallbackRetryText?: string;
+    /** How long to wait for PAYMENT_READY or PAYMENT_RESIZE. Defaults to 8000ms. */
+    iframeLoadTimeoutMs?: number;
+    /** Description shown while the hosted checkout iframe is loading. */
+    loadingDescription?: string;
+    /** Title shown while the hosted checkout iframe is loading. */
+    loadingTitle?: string;
 }
 /**
  * Poll Options
@@ -94,6 +144,16 @@ declare class PaymentUI extends HostedFrameModal<PaymentEventData> {
     private activeOrderId;
     private paymentCompleted;
     private cancelRequestedOrderId;
+    private iframeFallbackPanel;
+    private iframeLoadingPanel;
+    private iframeLoadTimer;
+    private iframeReady;
+    private cleanupPaymentFrameState;
+    private markPaymentIframeReady;
+    private showPaymentIframeLoading;
+    private openFallbackPaymentPage;
+    private showPaymentIframeFallback;
+    private startPaymentIframeWatchdog;
     private cancelHostedOrder;
     /**
      * Opens the payment checkout page in an iframe modal.
@@ -101,6 +161,7 @@ declare class PaymentUI extends HostedFrameModal<PaymentEventData> {
      * @param options - UI options
      */
     openPayment(urlOrParams: string | PaymentParams, options?: PaymentUIOptions): void;
+    close(): void;
     /**
      * Poll order status from integrator's API endpoint
      * @param statusUrl - The integrator's API endpoint to check order status
@@ -109,9 +170,18 @@ declare class PaymentUI extends HostedFrameModal<PaymentEventData> {
      */
     pollOrderStatus(statusUrl: string, options?: PollOptions): Promise<OrderStatus>;
 }
+interface WechatMessageBindingUIOptions {
+    bindingUrl: string;
+    displayMode?: "redirect" | "popup";
+    popupName?: string;
+}
+declare class MessageUI {
+    openWechatBinding(options: WechatMessageBindingUIOptions): void;
+}
+declare function createMessageUI(): MessageUI;
 /**
  * Convenience function to create a PaymentUI instance
  */
 declare function createPaymentUI(): PaymentUI;
 
-export { type OrderStatus, type PaymentEventData, type PaymentEventType, type PaymentParams, PaymentUI, type PaymentUIOptions, type PollOptions, createPaymentUI };
+export { type LoginDeviceType, type LoginEnvironment, type LoginEnvironmentInput, MessageUI, type OrderStatus, type PaymentEventData, type PaymentEventType, type PaymentParams, PaymentUI, type PaymentUIOptions, type PaymentUIThemeColors, type PollOptions, type WechatMessageBindingUIOptions, createMessageUI, createPaymentUI, detectLoginEnvironment };