@moneymq/react 0.7.0 → 0.9.0

package/dist/{index.d.mts → index.d.cts}

@@ -1,5 +1,7 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import React from 'react';
+import { CheckoutReceipt } from '@moneymq/sdk';
+export { Attachments, CheckoutReceipt, PaymentDetails, BasketItem as ReceiptBasketItem, ReceiptClaims } from '@moneymq/sdk';
 
 interface Branding {
     logo?: string;
@@ -17,6 +19,8 @@ interface MoneyMQProviderProps {
     children: React.ReactNode;
     client: MoneyMQClient;
     branding?: Branding;
+    /** Set to true if the parent app already provides wallet connection (AppProvider) */
+    skipWalletProvider?: boolean;
 }
 interface SandboxAccount {
     id: string;
@@ -36,7 +40,7 @@ declare const MoneyMQContext: React.Context<MoneyMQClient | null>;
 declare const SandboxContext: React.Context<SandboxContextState>;
 declare function useMoneyMQ(): MoneyMQClient;
 declare function useSandbox(): SandboxContextState;
-declare function MoneyMQProvider({ children, client, branding, }: MoneyMQProviderProps): react_jsx_runtime.JSX.Element | null;
+declare function MoneyMQProvider({ children, client, branding, }: MoneyMQProviderProps): react_jsx_runtime.JSX.Element;
 
 /**
  * Represents a completed payment transaction.
@@ -190,42 +194,53 @@ interface CheckoutButtonProps {
 declare const CheckoutButton: React.ForwardRefExoticComponent<CheckoutButtonProps & React.RefAttributes<HTMLButtonElement>>;
 
 /**
- * Represents a line item in the checkout, including product, price, quantity, and calculated subtotal.
+ * Product information for a line item.
+ * Contains the essential fields needed for checkout + experimentId for A/B tracking.
+ */
+interface LineItemProduct {
+    /** Unique product identifier */
+    id: string;
+    /** Display name shown to the customer */
+    name: string;
+    /** Optional description */
+    description?: string;
+    /** Experiment variant ID (e.g., "surfnet-lite#a") - for A/B test tracking */
+    experimentId?: string;
+}
+/**
+ * Price information for a line item.
+ */
+interface LineItemPrice {
+    /** Unique price identifier */
+    id: string;
+    /** Price amount in cents (e.g., 999 for $9.99) */
+    unit_amount: number;
+    /** Currency code (e.g., "USDC") */
+    currency: string;
+}
+/**
+ * Represents a line item in the checkout.
  *
  * @example
  * ```tsx
  * const lineItem: LineItem = {
- *   product: { id: 'prod_123', name: 'Pro Plan' },
+ *   product: { id: 'prod_123', name: 'Pro Plan', experimentId: 'prod_123#a' },
  *   price: { id: 'price_456', unit_amount: 999, currency: 'USDC' },
  *   quantity: 2,
- *   subtotal: 19.98,
  * };
+ * // Subtotal: (lineItem.price.unit_amount / 100) * lineItem.quantity
  * ```
  */
 interface LineItem {
     /** Product information */
-    product: {
-        /** Unique product identifier */
-        id: string;
-        /** Display name shown to the customer */
-        name: string;
-        /** Optional description */
-        description?: string;
-    };
+    product: LineItemProduct;
     /** Price information */
-    price: {
-        /** Unique price identifier */
-        id: string;
-        /** Price amount in cents (e.g., 999 for $9.99) */
-        unit_amount: number;
-        /** Currency code (e.g., "USDC") */
-        currency: string;
-    };
+    price: LineItemPrice;
     /** Quantity of this item */
     quantity: number;
-    /** Calculated subtotal (unit_amount / 100 * quantity) */
-    subtotal: number;
 }
+/** Calculate subtotal for a line item */
+declare function getLineItemSubtotal(item: LineItem): number;
 /**
  * Props for the CheckoutModal component.
  *
@@ -254,8 +269,8 @@ interface CheckoutModalProps {
     recipient: string;
     /** Optional line items to display in the checkout summary */
     lineItems?: LineItem[];
-    /** Callback fired when payment completes. Receives the transaction signature. */
-    onSuccess?: (signature: string) => void;
+    /** Callback fired when payment completes. Receives the CheckoutReceipt with helpers. */
+    onSuccess?: (receipt: CheckoutReceipt) => void;
     /** Callback fired when payment fails. Receives the Error with failure details. */
     onError?: (error: Error) => void;
     /** Accent color for UI elements. @default "#ec4899" */
@@ -295,7 +310,6 @@ interface CheckoutModalProps {
  *             product: { id: 'prod_1', name: 'Pro Plan' },
  *             price: { id: 'price_1', unit_amount: 999, currency: 'USDC' },
  *             quantity: 1,
- *             subtotal: 9.99,
  *           },
  *         ]}
  *         onSuccess={(signature) => {
@@ -311,7 +325,7 @@ interface CheckoutModalProps {
  * @see {@link CheckoutModalProps} for available props
  * @see {@link CheckoutButton} for a simpler button-based checkout
  */
-declare function CheckoutModal({ visible, onClose, amount, currency, recipient, lineItems, onSuccess, onError, accentColor, debug, }: CheckoutModalProps): react_jsx_runtime.JSX.Element | null;
+declare function CheckoutModal({ visible, onClose, amount, currency, recipient, lineItems, onSuccess, onError, accentColor, debug, }: CheckoutModalProps): React.ReactPortal | null;
 
 interface Payment {
     id: string;
@@ -327,4 +341,4 @@ interface UsePaymentReturn {
 }
 declare function usePayment(): UsePaymentReturn;
 
-export { type BasketItem, type Branding, CheckoutButton, type CheckoutButtonProps, CheckoutModal, type CheckoutModalProps, type LineItem, type MoneyMQClient, MoneyMQContext, MoneyMQProvider, type MoneyMQProviderProps, type Payment$1 as Payment, type Price, type Product, type SandboxAccount, SandboxContext, type UsePaymentReturn, useMoneyMQ, usePayment, useSandbox };
+export { type BasketItem, type Branding, CheckoutButton, type CheckoutButtonProps, CheckoutModal, type CheckoutModalProps, type LineItem, type LineItemPrice, type LineItemProduct, type MoneyMQClient, MoneyMQContext, MoneyMQProvider, type MoneyMQProviderProps, type Payment$1 as Payment, type Price, type Product, type SandboxAccount, SandboxContext, type UsePaymentReturn, getLineItemSubtotal, useMoneyMQ, usePayment, useSandbox };

package/dist/index.d.ts

@@ -1,5 +1,7 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import React from 'react';
+import { CheckoutReceipt } from '@moneymq/sdk';
+export { Attachments, CheckoutReceipt, PaymentDetails, BasketItem as ReceiptBasketItem, ReceiptClaims } from '@moneymq/sdk';
 
 interface Branding {
     logo?: string;
@@ -17,6 +19,8 @@ interface MoneyMQProviderProps {
     children: React.ReactNode;
     client: MoneyMQClient;
     branding?: Branding;
+    /** Set to true if the parent app already provides wallet connection (AppProvider) */
+    skipWalletProvider?: boolean;
 }
 interface SandboxAccount {
     id: string;
@@ -36,7 +40,7 @@ declare const MoneyMQContext: React.Context<MoneyMQClient | null>;
 declare const SandboxContext: React.Context<SandboxContextState>;
 declare function useMoneyMQ(): MoneyMQClient;
 declare function useSandbox(): SandboxContextState;
-declare function MoneyMQProvider({ children, client, branding, }: MoneyMQProviderProps): react_jsx_runtime.JSX.Element | null;
+declare function MoneyMQProvider({ children, client, branding, }: MoneyMQProviderProps): react_jsx_runtime.JSX.Element;
 
 /**
  * Represents a completed payment transaction.
@@ -190,42 +194,53 @@ interface CheckoutButtonProps {
 declare const CheckoutButton: React.ForwardRefExoticComponent<CheckoutButtonProps & React.RefAttributes<HTMLButtonElement>>;
 
 /**
- * Represents a line item in the checkout, including product, price, quantity, and calculated subtotal.
+ * Product information for a line item.
+ * Contains the essential fields needed for checkout + experimentId for A/B tracking.
+ */
+interface LineItemProduct {
+    /** Unique product identifier */
+    id: string;
+    /** Display name shown to the customer */
+    name: string;
+    /** Optional description */
+    description?: string;
+    /** Experiment variant ID (e.g., "surfnet-lite#a") - for A/B test tracking */
+    experimentId?: string;
+}
+/**
+ * Price information for a line item.
+ */
+interface LineItemPrice {
+    /** Unique price identifier */
+    id: string;
+    /** Price amount in cents (e.g., 999 for $9.99) */
+    unit_amount: number;
+    /** Currency code (e.g., "USDC") */
+    currency: string;
+}
+/**
+ * Represents a line item in the checkout.
  *
  * @example
  * ```tsx
  * const lineItem: LineItem = {
- *   product: { id: 'prod_123', name: 'Pro Plan' },
+ *   product: { id: 'prod_123', name: 'Pro Plan', experimentId: 'prod_123#a' },
  *   price: { id: 'price_456', unit_amount: 999, currency: 'USDC' },
  *   quantity: 2,
- *   subtotal: 19.98,
  * };
+ * // Subtotal: (lineItem.price.unit_amount / 100) * lineItem.quantity
  * ```
  */
 interface LineItem {
     /** Product information */
-    product: {
-        /** Unique product identifier */
-        id: string;
-        /** Display name shown to the customer */
-        name: string;
-        /** Optional description */
-        description?: string;
-    };
+    product: LineItemProduct;
     /** Price information */
-    price: {
-        /** Unique price identifier */
-        id: string;
-        /** Price amount in cents (e.g., 999 for $9.99) */
-        unit_amount: number;
-        /** Currency code (e.g., "USDC") */
-        currency: string;
-    };
+    price: LineItemPrice;
     /** Quantity of this item */
     quantity: number;
-    /** Calculated subtotal (unit_amount / 100 * quantity) */
-    subtotal: number;
 }
+/** Calculate subtotal for a line item */
+declare function getLineItemSubtotal(item: LineItem): number;
 /**
  * Props for the CheckoutModal component.
  *
@@ -254,8 +269,8 @@ interface CheckoutModalProps {
     recipient: string;
     /** Optional line items to display in the checkout summary */
     lineItems?: LineItem[];
-    /** Callback fired when payment completes. Receives the transaction signature. */
-    onSuccess?: (signature: string) => void;
+    /** Callback fired when payment completes. Receives the CheckoutReceipt with helpers. */
+    onSuccess?: (receipt: CheckoutReceipt) => void;
     /** Callback fired when payment fails. Receives the Error with failure details. */
     onError?: (error: Error) => void;
     /** Accent color for UI elements. @default "#ec4899" */
@@ -295,7 +310,6 @@ interface CheckoutModalProps {
  *             product: { id: 'prod_1', name: 'Pro Plan' },
  *             price: { id: 'price_1', unit_amount: 999, currency: 'USDC' },
  *             quantity: 1,
- *             subtotal: 9.99,
  *           },
  *         ]}
  *         onSuccess={(signature) => {
@@ -311,7 +325,7 @@ interface CheckoutModalProps {
  * @see {@link CheckoutModalProps} for available props
  * @see {@link CheckoutButton} for a simpler button-based checkout
  */
-declare function CheckoutModal({ visible, onClose, amount, currency, recipient, lineItems, onSuccess, onError, accentColor, debug, }: CheckoutModalProps): react_jsx_runtime.JSX.Element | null;
+declare function CheckoutModal({ visible, onClose, amount, currency, recipient, lineItems, onSuccess, onError, accentColor, debug, }: CheckoutModalProps): React.ReactPortal | null;
 
 interface Payment {
     id: string;
@@ -327,4 +341,4 @@ interface UsePaymentReturn {
 }
 declare function usePayment(): UsePaymentReturn;
 
-export { type BasketItem, type Branding, CheckoutButton, type CheckoutButtonProps, CheckoutModal, type CheckoutModalProps, type LineItem, type MoneyMQClient, MoneyMQContext, MoneyMQProvider, type MoneyMQProviderProps, type Payment$1 as Payment, type Price, type Product, type SandboxAccount, SandboxContext, type UsePaymentReturn, useMoneyMQ, usePayment, useSandbox };
+export { type BasketItem, type Branding, CheckoutButton, type CheckoutButtonProps, CheckoutModal, type CheckoutModalProps, type LineItem, type LineItemPrice, type LineItemProduct, type MoneyMQClient, MoneyMQContext, MoneyMQProvider, type MoneyMQProviderProps, type Payment$1 as Payment, type Price, type Product, type SandboxAccount, SandboxContext, type UsePaymentReturn, getLineItemSubtotal, useMoneyMQ, usePayment, useSandbox };