@tagadapay/plugin-sdk 1.0.23 → 1.0.26

package/dist/react/hooks/useCheckout.d.ts

@@ -135,6 +135,59 @@ export interface CheckoutSession {
         adjustments: any;
     }[];
 }
+export interface CheckoutSessionPreviewAdjustment {
+    type: 'Promotion' | 'Tax' | 'Shipping';
+    description: string;
+    level: 'Order' | 'LineItem';
+    sourceId: string;
+    amount: number;
+    currency: string;
+}
+export interface CheckoutSessionPreviewItem {
+    id: string;
+    productId: string;
+    product: {
+        name: string;
+        description: string;
+    };
+    variantId: string;
+    variant: {
+        name: string;
+        description: string;
+        imageUrl: string;
+        grams: number;
+    };
+    priceId: string;
+    sku: string;
+    unitAmount: number;
+    quantity: number;
+    amount: number;
+    adjustedAmount: number;
+    currency: string;
+    adjustments: CheckoutSessionPreviewAdjustment[];
+    recurring?: boolean;
+    rebillMode?: 'auth' | 'capture';
+    rebillStepIntervalMs?: number;
+    interval?: 'day' | 'week' | 'month' | 'year';
+    intervalCount?: number;
+    totalBillingCycles?: number;
+    unitAmountAfterFirstCycle?: number;
+    subscriptionSettings?: any;
+    orderLineItemProduct: {
+        name: string | null;
+    } | null;
+    orderLineItemVariant: {
+        name: string | null;
+        imageUrl: string | null;
+    } | null;
+}
+export interface CheckoutSessionPreview {
+    items: CheckoutSessionPreviewItem[];
+    adjustments: CheckoutSessionPreviewAdjustment[];
+    totalAmount: number;
+    totalAdjustedAmount: number;
+    totalPromotionAmount: number;
+}
 export interface CheckoutSummary {
     currency: string;
     totalAmount: number;
@@ -279,6 +332,10 @@ export interface UseCheckoutResult {
         currency: string;
         error?: any;
     }>;
+    previewCheckoutSession: (lineItems: CheckoutLineItem[], promotionIds?: string[]) => Promise<{
+        success: boolean;
+        preview: CheckoutSessionPreview;
+    }>;
     clear: () => void;
 }
 export declare function useCheckout(options?: UseCheckoutOptions): UseCheckoutResult;

package/dist/react/hooks/useCheckout.js

@@ -1,9 +1,9 @@
-import { useState, useCallback, useEffect, useRef } from 'react';
+import { useCallback, useEffect, useRef, useState } from 'react';
+import { useCurrency } from '../hooks/useCurrency';
 import { useTagadaContext } from '../providers/TagadaProvider';
 import { getCheckoutToken } from '../utils/urlUtils';
-import { useCurrency } from '../hooks/useCurrency';
 export function useCheckout(options = {}) {
-    const { apiService, updateCheckoutDebugData, refreshCoordinator } = useTagadaContext();
+    const { apiService, updateCheckoutDebugData, refreshCoordinator, store, currency } = useTagadaContext();
     const { code: currentCurrency } = useCurrency();
     const [checkout, setCheckout] = useState(null);
     const [isLoading, setIsLoading] = useState(false);
@@ -409,6 +409,24 @@ export function useCheckout(options = {}) {
             };
         }
     }, [apiService, checkout?.checkoutSession.id, checkout?.summary?.currency]);
+    const previewCheckoutSession = useCallback(async (lineItems, promotionIds) => {
+        try {
+            const response = await apiService.fetch('/api/v1/checkout-sessions/preview', {
+                method: 'POST',
+                body: {
+                    lineItems,
+                    storeId: store?.id,
+                    currency: currency.code,
+                    promotionIds: promotionIds || [],
+                },
+            });
+            return response;
+        }
+        catch (err) {
+            const error = err instanceof Error ? err : new Error('Failed to preview checkout session');
+            throw error;
+        }
+    }, [apiService, checkout?.checkoutSession.storeId, checkout?.summary?.currency]);
     const clear = useCallback(() => {
         setCheckout(null);
         setError(null);
@@ -465,6 +483,7 @@ export function useCheckout(options = {}) {
         updateCustomer,
         updateCustomerAndSessionInfo,
         previewOrderSummary,
+        previewCheckoutSession,
         clear,
     };
 }

package/dist/react/hooks/usePostPurchases.d.ts

@@ -0,0 +1,109 @@
+export interface PostPurchaseOfferItem {
+    id: string;
+    productId: string;
+    variantId: string;
+    product: {
+        name: string;
+        description: string;
+    };
+    variant: {
+        name: string;
+        description: string;
+        imageUrl: string;
+        grams: number | null;
+    };
+    unitAmount: number;
+    quantity: number;
+    amount: number;
+    adjustedAmount: number;
+}
+export interface PostPurchaseOfferSummary {
+    currency: string;
+    totalAmount: number;
+    totalAdjustedAmount: number;
+    items: PostPurchaseOfferItem[];
+}
+export interface PostPurchaseOfferLineItem {
+    id: string;
+    quantity: number;
+    price: {
+        variant: {
+            id: string;
+            name: string;
+            description: string | null;
+            grams: number | null;
+            product: {
+                id: string;
+                name: string;
+                description: string;
+            };
+        };
+    };
+}
+export interface PostPurchaseOffer {
+    id: string;
+    titleTrans: Record<string, string> | null;
+    summaries: PostPurchaseOfferSummary[];
+    offerLineItems: PostPurchaseOfferLineItem[];
+}
+export interface UsePostPurchasesOptions {
+    /**
+     * OrderID to fetch post-purchase offers for
+     */
+    orderId: string;
+    /**
+     * Whether to fetch offers automatically on mount
+     * @default true
+     */
+    enabled?: boolean;
+}
+export interface UsePostPurchasesResult {
+    /**
+     * Array of fetched post-purchase offers
+     */
+    offers: PostPurchaseOffer[];
+    /**
+     * Loading state
+     */
+    isLoading: boolean;
+    /**
+     * Error state
+     */
+    error: Error | null;
+    /**
+     * Refetch post-purchase offers
+     */
+    refetch: () => Promise<void>;
+    /**
+     * Get offer by ID from the loaded offers
+     */
+    getOffer: (offerId: string) => PostPurchaseOffer | undefined;
+    /**
+     * Get total value of all post-purchase offers
+     */
+    getTotalValue: () => number;
+    /**
+     * Get total savings across all post-purchase offers
+     */
+    getTotalSavings: () => number;
+    /**
+     * Initialize a checkout session for a post-purchase offer
+     */
+    initCheckoutSession: (offerId: string, orderId: string) => Promise<{
+        checkoutSessionId: string;
+    }>;
+    /**
+     * Initialize a checkout session for a post-purchase offer with specific variants
+     */
+    initCheckoutSessionWithVariants: (offerId: string, orderId: string, lineItems: Array<{
+        variantId: string;
+        quantity: number;
+    }>) => Promise<{
+        checkoutSessionId: string;
+    }>;
+    /**
+     * Pay with a checkout session for a post-purchase offer
+     */
+    payWithCheckoutSession: (checkoutSessionId: string, orderId?: string) => Promise<void>;
+}
+export declare function usePostPurchases(options: UsePostPurchasesOptions): UsePostPurchasesResult;

package/dist/react/hooks/usePostPurchases.js

@@ -0,0 +1,104 @@
+import { useCallback, useEffect, useState } from 'react';
+import { useTagadaContext } from '../providers/TagadaProvider';
+export function usePostPurchases(options) {
+    const { apiService } = useTagadaContext();
+    const { orderId, enabled = true } = options;
+    const [offers, setOffers] = useState([]);
+    const [isLoading, setIsLoading] = useState(false);
+    const [error, setError] = useState(null);
+    const fetchOffers = useCallback(async () => {
+        if (!orderId) {
+            setOffers([]);
+            return;
+        }
+        setIsLoading(true);
+        setError(null);
+        try {
+            const response = await apiService.fetch(`/api/v1/post-purchase/${orderId}/offers`, {
+                method: 'GET',
+            });
+            setOffers(response || []);
+        }
+        catch (err) {
+            const error = err instanceof Error ? err : new Error('Failed to fetch post-purchase offers');
+            setError(error);
+            console.error('[SDK] Failed to fetch post-purchase offers:', error);
+        }
+        finally {
+            setIsLoading(false);
+        }
+    }, [orderId]);
+    const initCheckoutSession = useCallback(async (offerId, orderId) => {
+        const response = await apiService.fetch(`/api/v1/checkout/offer/init`, {
+            method: 'POST',
+            body: JSON.stringify({
+                offerId: offerId,
+                returnUrl: window.location.href,
+                customerId: '',
+                orderId,
+            }),
+        });
+        return response;
+    }, []);
+    const initCheckoutSessionWithVariants = useCallback(async (offerId, orderId, lineItems) => {
+        const response = await apiService.fetch(`/api/v1/offers/${offerId}/transform-to-checkout`, {
+            method: 'POST',
+            body: JSON.stringify({
+                offerId: offerId,
+                lineItems: lineItems,
+                returnUrl: window.location.href,
+                mainOrderId: orderId,
+            }),
+        });
+        return response;
+    }, []);
+    const payWithCheckoutSession = useCallback(async (checkoutSessionId, orderId) => {
+        const response = await apiService.fetch(`/api/v1/checkout-sessions/${checkoutSessionId}/pay`, {
+            method: 'POST',
+            body: JSON.stringify({
+                checkoutSessionId,
+                metadata: {
+                    comingFromPostPurchase: true,
+                    postOrder: orderId,
+                },
+            }),
+        });
+        return response;
+    }, []);
+    useEffect(() => {
+        if (enabled && orderId) {
+            fetchOffers();
+        }
+    }, [enabled, orderId, fetchOffers]);
+    const getOffer = useCallback((offerId) => {
+        return offers.find((offer) => offer.id === offerId);
+    }, [offers]);
+    const getTotalValue = useCallback(() => {
+        return offers.reduce((total, offer) => {
+            return (total +
+                offer.summaries.reduce((summaryTotal, summary) => {
+                    return summaryTotal + summary.totalAmount;
+                }, 0));
+        }, 0);
+    }, [offers]);
+    const getTotalSavings = useCallback(() => {
+        return offers.reduce((total, offer) => {
+            return (total +
+                offer.summaries.reduce((summaryTotal, summary) => {
+                    return summaryTotal + (summary.totalAmount - summary.totalAdjustedAmount);
+                }, 0));
+        }, 0);
+    }, [offers]);
+    return {
+        offers,
+        isLoading,
+        error,
+        refetch: fetchOffers,
+        getOffer,
+        getTotalValue,
+        getTotalSavings,
+        initCheckoutSession,
+        initCheckoutSessionWithVariants,
+        payWithCheckoutSession,
+    };
+}

package/dist/react/index.d.ts

@@ -2,28 +2,30 @@
  * React SDK exports
  */
 export { TagadaProvider } from './providers/TagadaProvider';
+export { useAddress } from './hooks/useAddress';
+export { useAuth } from './hooks/useAuth';
 export { useCheckout } from './hooks/useCheckout';
-export { useProducts } from './hooks/useProducts';
-export { useOffers } from './hooks/useOffers';
-export { useOrderBump } from './hooks/useOrderBump';
-export { useSession } from './hooks/useSession';
 export { useCurrency } from './hooks/useCurrency';
 export { useCustomer } from './hooks/useCustomer';
 export { useEnvironment } from './hooks/useEnvironment';
 export { useLocale } from './hooks/useLocale';
-export { useAuth } from './hooks/useAuth';
-export { useAddress } from './hooks/useAddress';
+export { useOffers } from './hooks/useOffers';
+export { useOrderBump } from './hooks/useOrderBump';
+export { usePostPurchases } from './hooks/usePostPurchases';
+export { useProducts } from './hooks/useProducts';
+export { useSession } from './hooks/useSession';
 export { useOrder } from './hooks/useOrder';
 export type { UseOrderOptions, UseOrderResult } from './hooks/useOrder';
 export { usePayment } from './hooks/usePayment';
 export { usePaymentPolling } from './hooks/usePaymentPolling';
 export { useThreeds } from './hooks/useThreeds';
 export { useThreedsModal } from './hooks/useThreedsModal';
-export type { Customer, Session, AuthState, Locale, Currency, Store, Environment, EnvironmentConfig, Order, OrderItem, OrderSummary, OrderAddress, PickupPoint, } from './types';
-export type { UseCheckoutOptions, UseCheckoutResult, CheckoutInitParams, CheckoutLineItem, CheckoutSession, CheckoutData, Promotion, } from './hooks/useCheckout';
-export type { UseOrderBumpOptions, UseOrderBumpResult, OrderBumpPreview } from './hooks/useOrderBump';
-export type { UseAddressOptions, UseAddressResult, AddressData, AddressField, Country, State, } from './hooks/useAddress';
-export type { Payment, PollingOptions, PaymentPollingHook } from './hooks/usePaymentPolling';
-export type { PaymentInstrument, ThreedsSession, ThreedsChallenge, ThreedsOptions, ThreedsHook, ThreedsProvider, } from './hooks/useThreeds';
-export type { ApplePayToken, CardPaymentMethod, PaymentResponse, PaymentOptions, PaymentInstrumentResponse, PaymentHook, } from './hooks/usePayment';
-export { formatMoney, formatMoneyWithoutSymbol, getCurrencyInfo, minorUnitsToMajorUnits, moneyStringOrNumberToMinorUnits, convertCurrency, formatSimpleMoney, } from './utils/money';
+export type { AuthState, Currency, Customer, Environment, EnvironmentConfig, Locale, Order, OrderAddress, OrderItem, OrderSummary, PickupPoint, Session, Store, } from './types';
+export type { CheckoutData, CheckoutInitParams, CheckoutLineItem, CheckoutSession, Promotion, UseCheckoutOptions, UseCheckoutResult, } from './hooks/useCheckout';
+export type { OrderBumpPreview, UseOrderBumpOptions, UseOrderBumpResult } from './hooks/useOrderBump';
+export type { PostPurchaseOffer, PostPurchaseOfferItem, PostPurchaseOfferLineItem, PostPurchaseOfferSummary, UsePostPurchasesOptions, UsePostPurchasesResult, } from './hooks/usePostPurchases';
+export type { AddressData, AddressField, Country, State, UseAddressOptions, UseAddressResult, } from './hooks/useAddress';
+export type { Payment, PaymentPollingHook, PollingOptions } from './hooks/usePaymentPolling';
+export type { PaymentInstrument, ThreedsChallenge, ThreedsHook, ThreedsOptions, ThreedsProvider, ThreedsSession, } from './hooks/useThreeds';
+export type { ApplePayToken, CardPaymentMethod, PaymentHook, PaymentInstrumentResponse, PaymentOptions, PaymentResponse, } from './hooks/usePayment';
+export { convertCurrency, formatMoney, formatMoneyWithoutSymbol, formatSimpleMoney, getCurrencyInfo, minorUnitsToMajorUnits, moneyStringOrNumberToMinorUnits, } from './utils/money';

package/dist/react/index.js

@@ -5,17 +5,18 @@
 // Provider exports
 export { TagadaProvider } from './providers/TagadaProvider';
 // Hook exports
+export { useAddress } from './hooks/useAddress';
+export { useAuth } from './hooks/useAuth';
 export { useCheckout } from './hooks/useCheckout';
-export { useProducts } from './hooks/useProducts';
-export { useOffers } from './hooks/useOffers';
-export { useOrderBump } from './hooks/useOrderBump';
-export { useSession } from './hooks/useSession';
 export { useCurrency } from './hooks/useCurrency';
 export { useCustomer } from './hooks/useCustomer';
 export { useEnvironment } from './hooks/useEnvironment';
 export { useLocale } from './hooks/useLocale';
-export { useAuth } from './hooks/useAuth';
-export { useAddress } from './hooks/useAddress';
+export { useOffers } from './hooks/useOffers';
+export { useOrderBump } from './hooks/useOrderBump';
+export { usePostPurchases } from './hooks/usePostPurchases';
+export { useProducts } from './hooks/useProducts';
+export { useSession } from './hooks/useSession';
 // Order hook exports
 export { useOrder } from './hooks/useOrder';
 // Payment hooks exports
@@ -26,4 +27,4 @@ export { useThreedsModal } from './hooks/useThreedsModal';
 // Component exports (if any)
 // export { SomeComponent } from './components/SomeComponent';
 // Utility exports
-export { formatMoney, formatMoneyWithoutSymbol, getCurrencyInfo, minorUnitsToMajorUnits, moneyStringOrNumberToMinorUnits, convertCurrency, formatSimpleMoney, } from './utils/money';
+export { convertCurrency, formatMoney, formatMoneyWithoutSymbol, formatSimpleMoney, getCurrencyInfo, minorUnitsToMajorUnits, moneyStringOrNumberToMinorUnits, } from './utils/money';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tagadapay/plugin-sdk",
-  "version": "1.0.23",
+  "version": "1.0.26",
   "description": "Modern React SDK for building Tagada Pay plugins",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",