@youidian/sdk 3.4.1 → 3.4.2

package/dist/client.d.cts

@@ -38,7 +38,7 @@ declare function detectLoginEnvironment(input?: LoginEnvironmentInput): LoginEnv
 /**
  * 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
  */
@@ -56,6 +56,13 @@ interface OrderStatus {
     paidAt?: string;
     channelTransactionId?: string;
 }
+interface PaymentUIThemeColors {
+    primary?: string;
+    secondary?: string;
+    foreground?: string;
+    muted?: string;
+    surface?: string;
+}
 /**
  * Payment UI Options
  */
@@ -64,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
@@ -122,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.
@@ -129,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
@@ -137,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 LoginDeviceType, type LoginEnvironment, type LoginEnvironmentInput, type OrderStatus, type PaymentEventData, type PaymentEventType, type PaymentParams, PaymentUI, type PaymentUIOptions, type PollOptions, createPaymentUI, detectLoginEnvironment };
+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

@@ -38,7 +38,7 @@ declare function detectLoginEnvironment(input?: LoginEnvironmentInput): LoginEnv
 /**
  * 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
  */
@@ -56,6 +56,13 @@ interface OrderStatus {
     paidAt?: string;
     channelTransactionId?: string;
 }
+interface PaymentUIThemeColors {
+    primary?: string;
+    secondary?: string;
+    foreground?: string;
+    muted?: string;
+    surface?: string;
+}
 /**
  * Payment UI Options
  */
@@ -64,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
@@ -122,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.
@@ -129,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
@@ -137,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 LoginDeviceType, type LoginEnvironment, type LoginEnvironmentInput, type OrderStatus, type PaymentEventData, type PaymentEventType, type PaymentParams, PaymentUI, type PaymentUIOptions, type PollOptions, createPaymentUI, detectLoginEnvironment };
+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 };