@daimo/pay 1.7.2 → 1.7.4

package/build/index.d.ts

@@ -1,4 +1,4 @@
-import React$1, { ReactNode } from 'react';
+import React$1, { ReactNode, ReactElement } from 'react';
 export { version } from '../package.json';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { CreateConfigParameters } from '@wagmi/core';
@@ -150,11 +150,6 @@ type DaimoPayEvent = {
      * chain for payment_completed/payment_bounced.
      */
     chainId: number;
-    /**
-     * The transaction hash for this event. Hex for all EVM events, Base58 for
-     * payment_started on Solana.
-     */
-    txHash: Hex | string;
     /**
      * Payment details.
      */
@@ -162,12 +157,22 @@ type DaimoPayEvent = {
 };
 type DaimoPayStartedEvent = DaimoPayEvent & {
     type: "payment_started";
+    /**
+     * The transaction hash sent by the user, if found. (There are rare edge cases
+     * where a payment can be paid without a txhash.) Hex for all EVM events,
+     * Base58 for payment_started on Solana.
+     */
+    txHash: Hex | string | null;
 };
 type DaimoPayCompletedEvent = DaimoPayEvent & {
     type: "payment_completed";
+    /** The transaction hash completing this payment. */
+    txHash: Hex;
 };
 type DaimoPayBouncedEvent = DaimoPayEvent & {
     type: "payment_bounced";
+    /** The transaction hash containing the reverted final call and refund. */
+    txHash: Hex;
 };
 /** Props for DaimoPayButton. */
 type PayButtonPaymentProps = {
@@ -228,6 +233,10 @@ type PayButtonPaymentProps = {
      * Developer metadata. E.g. correlation ID.
      * */
     metadata?: DaimoPayUserMetadata;
+    /**
+     * The address to refund to if the payment bounces or a refund is requested.
+     */
+    refundAddress?: Address;
 } | {
     /** The payment ID, generated via the Daimo Pay API. Replaces params above. */
     payId: string;
@@ -239,6 +248,10 @@ type PayButtonCommonProps = PayButtonPaymentProps & {
     onPaymentCompleted?: (event: DaimoPayCompletedEvent) => void;
     /** Called when destination call reverts and funds are refunded */
     onPaymentBounced?: (event: DaimoPayBouncedEvent) => void;
+    /** Called when the modal is opened. */
+    onOpen?: () => void;
+    /** Called when the modal is closed. */
+    onClose?: () => void;
     /** Automatically close the modal after a successful payment. */
     closeOnSuccess?: boolean;
     /** Open the modal by default. */
@@ -263,18 +276,18 @@ type DaimoPayButtonCustomProps = PayButtonCommonProps & {
     children: (renderProps: {
         show: () => void;
         hide: () => void;
-    }) => React$1.ReactNode;
+    }) => ReactElement;
 };
 /**
  * A button that shows the Daimo Pay checkout. Replaces the traditional
  * Connect Wallet » approve » execute sequence with a single action.
  */
-declare function DaimoPayButton(props: DaimoPayButtonProps): react_jsx_runtime.JSX.Element;
+declare function DaimoPayButton(props: DaimoPayButtonProps): JSX.Element;
 declare namespace DaimoPayButton {
     var Custom: typeof DaimoPayButtonCustom;
 }
 /** Like DaimoPayButton, but with custom styling. */
-declare function DaimoPayButtonCustom(props: DaimoPayButtonCustomProps): React$1.ReactNode;
+declare function DaimoPayButtonCustom(props: DaimoPayButtonCustomProps): JSX.Element;
 declare namespace DaimoPayButtonCustom {
     var displayName: string;
 }
@@ -290,9 +303,10 @@ declare namespace DaimoPayButtonCustom {
  *    to the payment's configured refund address on the destination chain.
  */
 declare function useDaimoPayStatus(): {
-    paymentId: string;
-    status: DaimoPayIntentStatus;
-} | undefined;
+    paymentId?: string;
+    status?: DaimoPayIntentStatus;
+    reset: () => void;
+};
 
 /** Icon for an EVM chain, given chain ID. No ID shows a loading spinner. */
 declare const Chain: React$1.FC<{
@@ -453,6 +467,8 @@ interface PayParams {
     externalId?: string;
     /** Developer metadata. E.g. correlation ID. */
     metadata?: DaimoPayUserMetadata;
+    /** The address to refund to if the payment bounces or a refund is requested. */
+    refundAddress?: Address;
 }
 /** Creates (or loads) a payment and manages the corresponding modal. */
 interface PaymentState {
@@ -460,12 +476,14 @@ interface PaymentState {
     setPayParams: (payParams: PayParams | undefined) => void;
     payParams: PayParams | undefined;
     generatePreviewOrder: (payParams: PayParams) => void;
+    resetOrder: () => void;
     daimoPayOrder: DaimoPayOrder | undefined;
     isDepositFlow: boolean;
     modalOptions: DaimoPayModalOptions;
     setModalOptions: (modalOptions: DaimoPayModalOptions) => void;
     paymentWaitingMessage: string | undefined;
     externalPaymentOptions: ReturnType<typeof useExternalPaymentOptions>;
+    showSolanaPaymentMethod: boolean;
     walletPaymentOptions: ReturnType<typeof useWalletPaymentOptions>;
     solanaPaymentOptions: ReturnType<typeof useSolanaPaymentOptions>;
     depositAddressOptions: ReturnType<typeof useDepositAddressOptions>;
@@ -507,6 +525,8 @@ type PayContextValue = {
     setCustomTheme: React$1.Dispatch<React$1.SetStateAction<CustomTheme | undefined>>;
     lang: Languages$1;
     setLang: React$1.Dispatch<React$1.SetStateAction<Languages$1>>;
+    setOnOpen: (fn?: () => void) => void;
+    setOnClose: (fn?: () => void) => void;
     open: boolean;
     setOpen: (open: boolean, meta?: Record<string, any>) => void;
     route: string;
@@ -544,4 +564,4 @@ type PayContextValue = {
 } & useConnectCallbackProps;
 
 export { Avatar, Chain as ChainIcon, DaimoPayButton, PayContext as DaimoPayContext, DaimoPayProvider, types as Types, daimoPayVersion, defaultConfig as getDefaultConfig, useDaimoPayStatus, usePayContext, wallets };
-export type { DaimoPayBouncedEvent, DaimoPayButtonCustomProps, DaimoPayButtonProps, DaimoPayCompletedEvent, DaimoPayEvent, DaimoPayStartedEvent, DaimoPayment };
+export type { All, CustomAvatarProps, CustomTheme, DaimoPayBouncedEvent, DaimoPayButtonCustomProps, DaimoPayButtonProps, DaimoPayCompletedEvent, DaimoPayContextOptions, DaimoPayEvent, DaimoPayModalOptions, DaimoPayStartedEvent, DaimoPayment, Languages, Mode, PaymentOption, Theme };