@tagadapay/plugin-sdk 1.0.25 → 1.0.26

package/README.md

@@ -1,414 +1,414 @@
-# TagadaPay Plugin SDK
-
-A comprehensive SDK for building checkout plugins on the TagadaPay platform. Create custom checkout experiences with React components, payment processing, and advanced features.
-
-## 📚 Documentation
-
-### Core APIs
-
-- **[useCheckout](./README-useCheckout.md)** - Checkout state management and flow control
-- **[setCheckoutInfo](./README-setCheckoutInfo.md)** - Customer information and validation
-- **[useOffers](./README-useOffers.md)** - Dynamic pricing and promotional offers
-- **[Money utilities](./README-money.md)** - Currency formatting and calculations
-- **[URL utilities](./README-urlUtils.md)** - Navigation and routing helpers
-
-### Examples
-
-- **[Vite Checkout Demo](../checkout-vite)** - Complete checkout implementation
-
-## 🚀 Quick Start
-
-### Installation
-
-```bash
-npm install @tagadapay/plugin-sdk
-```
-
-### Basic Usage
-
-```typescript
-import { useCheckout, setCheckoutInfo } from '@tagadapay/plugin-sdk';
-
-function CheckoutPage() {
-  const { customer, cart, payment } = useCheckout();
-
-  const handleSubmit = async (data) => {
-    await setCheckoutInfo({
-      customer: data.customer,
-      payment: data.payment
-    });
-  };
-
-  return (
-    <div>
-      {/* Your checkout UI */}
-    </div>
-  );
-}
-```
-
-## 🎯 Key Features
-
-### Payment Processing
-
-- Secure tokenized payments
-- Multiple payment method support
-- Real-time validation
-- PCI compliance
-
-### Customer Management
-
-- Profile management
-- Address validation
-- Order history
-- Preferences
-
-### Cart & Pricing
-
-- Dynamic pricing
-- Promotional offers
-- Tax calculations
-- Currency conversion
-
-### UI Components
-
-- Pre-built checkout components
-- Customizable themes
-- Mobile-optimized
-- Accessibility features
-
-## 📖 API Reference
-
-### Core Hooks
-
-#### useCheckout()
-
-Primary hook for checkout state management.
-
-```typescript
-const {
-  customer, // Customer information
-  cart, // Shopping cart state
-  payment, // Payment details
-  shipping, // Shipping information
-  loading, // Loading states
-  errors, // Error handling
-} = useCheckout();
-```
-
-#### useOffers()
-
-Hook for managing dynamic offers and pricing.
-
-```typescript
-const {
-  offers, // Available offers
-  applyOffer, // Apply offer function
-  removeOffer, // Remove offer function
-  total, // Calculated total
-} = useOffers();
-```
-
-### Utility Functions
-
-#### setCheckoutInfo()
-
-Update checkout information with validation.
-
-```typescript
-await setCheckoutInfo({
-  customer: {
-    email: 'user@example.com',
-    firstName: 'John',
-    lastName: 'Doe',
-  },
-  payment: {
-    method: 'card',
-    token: 'pm_token_123',
-  },
-});
-```
-
-#### Money utilities
-
-Format and calculate monetary values.
-
-```typescript
-import { formatMoney, convertCurrency } from '@tagadapay/plugin-sdk';
-
-const formatted = formatMoney(2999, 'USD'); // "$29.99"
-const converted = convertCurrency(2999, 'USD', 'EUR'); // 2699
-```
-
-## 🛠️ Development
-
-### Local Development
-
-```bash
-# Install dependencies
-npm install
-
-# Start development server
-npm run dev
-
-# Build for production
-npm run build
-```
-
-### Testing
-
-```bash
-# Run tests
-npm test
-
-# Run tests with coverage
-npm run test:coverage
-```
-
-### Linting
-
-```bash
-# Check code style
-npm run lint
-
-# Fix linting issues
-npm run lint:fix
-```
-
-## 📦 Build & Deploy
-
-### Building Your Plugin
-
-```bash
-# Build optimized bundle
-npm run build
-
-# Analyze bundle size
-npm run analyze
-```
-
-### Deployment
-
-```bash
-# Deploy using TagadaPay CLI
-npx @tagadapay/plugin-cli deploy
-
-# Deploy specific environment
-npx @tagadapay/plugin-cli deploy --env production
-```
-
-## 🔧 Configuration
-
-### Plugin Configuration
-
-```json
-{
-  "name": "My Checkout Plugin",
-  "version": "1.0.0",
-  "description": "Custom checkout experience",
-  "main": "dist/index.js",
-  "tagadapay": {
-    "type": "checkout",
-    "mode": "direct",
-    "framework": "react"
-  }
-}
-```
-
-### Environment Variables
-
-```env
-TAGADAPAY_API_KEY=your_api_key
-TAGADAPAY_ENVIRONMENT=sandbox
-TAGADAPAY_STORE_ID=your_store_id
-```
-
-## 🎨 Styling & Themes
-
-### CSS Custom Properties
-
-```css
-:root {
-  --tagada-primary: #007bff;
-  --tagada-secondary: #6c757d;
-  --tagada-success: #28a745;
-  --tagada-danger: #dc3545;
-  --tagada-border-radius: 4px;
-  --tagada-font-family: -apple-system, BlinkMacSystemFont, sans-serif;
-}
-```
-
-### Component Styling
-
-```typescript
-import { styled } from '@tagadapay/plugin-sdk';
-
-const StyledButton = styled.button`
-  background: var(--tagada-primary);
-  color: white;
-  border-radius: var(--tagada-border-radius);
-  padding: 12px 24px;
-  border: none;
-  cursor: pointer;
-
-  &:hover {
-    opacity: 0.9;
-  }
-`;
-```
-
-## 🔐 Security
-
-### Best Practices
-
-- Never store sensitive payment data
-- Always validate user inputs
-- Use HTTPS in production
-- Implement proper error handling
-- Follow PCI DSS guidelines
-
-### Token Management
-
-```typescript
-// ✅ Good: Use tokenized payments
-const paymentToken = await tokenizePayment(cardData);
-await processPayment({ token: paymentToken });
-
-// ❌ Bad: Never store raw card data
-// const cardNumber = '4111111111111111'; // Don't do this
-```
-
-## 📱 Mobile Optimization
-
-### Responsive Design
-
-```css
-.checkout-container {
-  max-width: 600px;
-  margin: 0 auto;
-  padding: 16px;
-}
-
-@media (max-width: 768px) {
-  .checkout-container {
-    padding: 8px;
-  }
-
-  .checkout-form {
-    font-size: 16px; /* Prevent zoom on iOS */
-  }
-}
-```
-
-### Touch Interactions
-
-```typescript
-const handleTouchStart = (e) => {
-  // Optimize for touch devices
-  e.preventDefault();
-  // Handle touch interaction
-};
-```
-
-## 🌐 Internationalization
-
-### Multi-language Support
-
-```typescript
-import { useTranslation } from '@tagadapay/plugin-sdk';
-
-function CheckoutForm() {
-  const { t } = useTranslation();
-
-  return (
-    <form>
-      <label>{t('checkout.email')}</label>
-      <input type="email" placeholder={t('checkout.email_placeholder')} />
-    </form>
-  );
-}
-```
-
-### Currency Support
-
-```typescript
-import { useCurrency } from '@tagadapay/plugin-sdk';
-
-function PriceDisplay({ amount }) {
-  const { formatPrice, currency } = useCurrency();
-
-  return <span>{formatPrice(amount, currency)}</span>;
-}
-```
-
-## 📊 Analytics & Monitoring
-
-### Event Tracking
-
-```typescript
-import { trackEvent } from '@tagadapay/plugin-sdk';
-
-// Track user interactions
-trackEvent('checkout_started', {
-  product_id: 'prod_123',
-  value: 2999,
-  currency: 'USD',
-});
-
-// Track conversions
-trackEvent('purchase_completed', {
-  transaction_id: 'txn_456',
-  value: 2999,
-  currency: 'USD',
-});
-```
-
-### Performance Monitoring
-
-```typescript
-import { performance } from '@tagadapay/plugin-sdk';
-
-// Measure load times
-performance.mark('checkout-start');
-// ... checkout logic
-performance.mark('checkout-end');
-performance.measure('checkout-duration', 'checkout-start', 'checkout-end');
-```
-
-## 🤝 Contributing
-
-### Development Setup
-
-```bash
-# Clone the repository
-git clone https://github.com/tagadapay/plugin-sdk.git
-
-# Install dependencies
-npm install
-
-# Start development
-npm run dev
-```
-
-### Submitting Changes
-
-1. Fork the repository
-2. Create a feature branch
-3. Make your changes
-4. Add tests
-5. Submit a pull request
-
-## 📄 License
-
-MIT License - see [LICENSE](./LICENSE) for details.
-
-## 🆘 Support
-
-- **Documentation**: [docs.tagadapay.com](https://docs.tagadapay.com)
-- **Discord**: [discord.gg/tagadapay](https://discord.gg/tagadapay)
-- **Email**: support@tagadapay.com
-- **GitHub Issues**: [github.com/tagadapay/plugin-sdk/issues](https://github.com/tagadapay/plugin-sdk/issues)
-
----
-
-Built with ❤️ by the TagadaPay team
+# TagadaPay Plugin SDK
+
+A comprehensive SDK for building checkout plugins on the TagadaPay platform. Create custom checkout experiences with React components, payment processing, and advanced features.
+
+## 📚 Documentation
+
+### Core APIs
+
+- **[useCheckout](./README-useCheckout.md)** - Checkout state management and flow control
+- **[setCheckoutInfo](./README-setCheckoutInfo.md)** - Customer information and validation
+- **[useOffers](./README-useOffers.md)** - Dynamic pricing and promotional offers
+- **[Money utilities](./README-money.md)** - Currency formatting and calculations
+- **[URL utilities](./README-urlUtils.md)** - Navigation and routing helpers
+
+### Examples
+
+- **[Vite Checkout Demo](../checkout-vite)** - Complete checkout implementation
+
+## 🚀 Quick Start
+
+### Installation
+
+```bash
+npm install @tagadapay/plugin-sdk
+```
+
+### Basic Usage
+
+```typescript
+import { useCheckout, setCheckoutInfo } from '@tagadapay/plugin-sdk';
+
+function CheckoutPage() {
+  const { customer, cart, payment } = useCheckout();
+
+  const handleSubmit = async (data) => {
+    await setCheckoutInfo({
+      customer: data.customer,
+      payment: data.payment
+    });
+  };
+
+  return (
+    <div>
+      {/* Your checkout UI */}
+    </div>
+  );
+}
+```
+
+## 🎯 Key Features
+
+### Payment Processing
+
+- Secure tokenized payments
+- Multiple payment method support
+- Real-time validation
+- PCI compliance
+
+### Customer Management
+
+- Profile management
+- Address validation
+- Order history
+- Preferences
+
+### Cart & Pricing
+
+- Dynamic pricing
+- Promotional offers
+- Tax calculations
+- Currency conversion
+
+### UI Components
+
+- Pre-built checkout components
+- Customizable themes
+- Mobile-optimized
+- Accessibility features
+
+## 📖 API Reference
+
+### Core Hooks
+
+#### useCheckout()
+
+Primary hook for checkout state management.
+
+```typescript
+const {
+  customer, // Customer information
+  cart, // Shopping cart state
+  payment, // Payment details
+  shipping, // Shipping information
+  loading, // Loading states
+  errors, // Error handling
+} = useCheckout();
+```
+
+#### useOffers()
+
+Hook for managing dynamic offers and pricing.
+
+```typescript
+const {
+  offers, // Available offers
+  applyOffer, // Apply offer function
+  removeOffer, // Remove offer function
+  total, // Calculated total
+} = useOffers();
+```
+
+### Utility Functions
+
+#### setCheckoutInfo()
+
+Update checkout information with validation.
+
+```typescript
+await setCheckoutInfo({
+  customer: {
+    email: 'user@example.com',
+    firstName: 'John',
+    lastName: 'Doe',
+  },
+  payment: {
+    method: 'card',
+    token: 'pm_token_123',
+  },
+});
+```
+
+#### Money utilities
+
+Format and calculate monetary values.
+
+```typescript
+import { formatMoney, convertCurrency } from '@tagadapay/plugin-sdk';
+
+const formatted = formatMoney(2999, 'USD'); // "$29.99"
+const converted = convertCurrency(2999, 'USD', 'EUR'); // 2699
+```
+
+## 🛠️ Development
+
+### Local Development
+
+```bash
+# Install dependencies
+npm install
+
+# Start development server
+npm run dev
+
+# Build for production
+npm run build
+```
+
+### Testing
+
+```bash
+# Run tests
+npm test
+
+# Run tests with coverage
+npm run test:coverage
+```
+
+### Linting
+
+```bash
+# Check code style
+npm run lint
+
+# Fix linting issues
+npm run lint:fix
+```
+
+## 📦 Build & Deploy
+
+### Building Your Plugin
+
+```bash
+# Build optimized bundle
+npm run build
+
+# Analyze bundle size
+npm run analyze
+```
+
+### Deployment
+
+```bash
+# Deploy using TagadaPay CLI
+npx @tagadapay/plugin-cli deploy
+
+# Deploy specific environment
+npx @tagadapay/plugin-cli deploy --env production
+```
+
+## 🔧 Configuration
+
+### Plugin Configuration
+
+```json
+{
+  "name": "My Checkout Plugin",
+  "version": "1.0.0",
+  "description": "Custom checkout experience",
+  "main": "dist/index.js",
+  "tagadapay": {
+    "type": "checkout",
+    "mode": "direct",
+    "framework": "react"
+  }
+}
+```
+
+### Environment Variables
+
+```env
+TAGADAPAY_API_KEY=your_api_key
+TAGADAPAY_ENVIRONMENT=sandbox
+TAGADAPAY_STORE_ID=your_store_id
+```
+
+## 🎨 Styling & Themes
+
+### CSS Custom Properties
+
+```css
+:root {
+  --tagada-primary: #007bff;
+  --tagada-secondary: #6c757d;
+  --tagada-success: #28a745;
+  --tagada-danger: #dc3545;
+  --tagada-border-radius: 4px;
+  --tagada-font-family: -apple-system, BlinkMacSystemFont, sans-serif;
+}
+```
+
+### Component Styling
+
+```typescript
+import { styled } from '@tagadapay/plugin-sdk';
+
+const StyledButton = styled.button`
+  background: var(--tagada-primary);
+  color: white;
+  border-radius: var(--tagada-border-radius);
+  padding: 12px 24px;
+  border: none;
+  cursor: pointer;
+
+  &:hover {
+    opacity: 0.9;
+  }
+`;
+```
+
+## 🔐 Security
+
+### Best Practices
+
+- Never store sensitive payment data
+- Always validate user inputs
+- Use HTTPS in production
+- Implement proper error handling
+- Follow PCI DSS guidelines
+
+### Token Management
+
+```typescript
+// ✅ Good: Use tokenized payments
+const paymentToken = await tokenizePayment(cardData);
+await processPayment({ token: paymentToken });
+
+// ❌ Bad: Never store raw card data
+// const cardNumber = '4111111111111111'; // Don't do this
+```
+
+## 📱 Mobile Optimization
+
+### Responsive Design
+
+```css
+.checkout-container {
+  max-width: 600px;
+  margin: 0 auto;
+  padding: 16px;
+}
+
+@media (max-width: 768px) {
+  .checkout-container {
+    padding: 8px;
+  }
+
+  .checkout-form {
+    font-size: 16px; /* Prevent zoom on iOS */
+  }
+}
+```
+
+### Touch Interactions
+
+```typescript
+const handleTouchStart = (e) => {
+  // Optimize for touch devices
+  e.preventDefault();
+  // Handle touch interaction
+};
+```
+
+## 🌐 Internationalization
+
+### Multi-language Support
+
+```typescript
+import { useTranslation } from '@tagadapay/plugin-sdk';
+
+function CheckoutForm() {
+  const { t } = useTranslation();
+
+  return (
+    <form>
+      <label>{t('checkout.email')}</label>
+      <input type="email" placeholder={t('checkout.email_placeholder')} />
+    </form>
+  );
+}
+```
+
+### Currency Support
+
+```typescript
+import { useCurrency } from '@tagadapay/plugin-sdk';
+
+function PriceDisplay({ amount }) {
+  const { formatPrice, currency } = useCurrency();
+
+  return <span>{formatPrice(amount, currency)}</span>;
+}
+```
+
+## 📊 Analytics & Monitoring
+
+### Event Tracking
+
+```typescript
+import { trackEvent } from '@tagadapay/plugin-sdk';
+
+// Track user interactions
+trackEvent('checkout_started', {
+  product_id: 'prod_123',
+  value: 2999,
+  currency: 'USD',
+});
+
+// Track conversions
+trackEvent('purchase_completed', {
+  transaction_id: 'txn_456',
+  value: 2999,
+  currency: 'USD',
+});
+```
+
+### Performance Monitoring
+
+```typescript
+import { performance } from '@tagadapay/plugin-sdk';
+
+// Measure load times
+performance.mark('checkout-start');
+// ... checkout logic
+performance.mark('checkout-end');
+performance.measure('checkout-duration', 'checkout-start', 'checkout-end');
+```
+
+## 🤝 Contributing
+
+### Development Setup
+
+```bash
+# Clone the repository
+git clone https://github.com/tagadapay/plugin-sdk.git
+
+# Install dependencies
+npm install
+
+# Start development
+npm run dev
+```
+
+### Submitting Changes
+
+1. Fork the repository
+2. Create a feature branch
+3. Make your changes
+4. Add tests
+5. Submit a pull request
+
+## 📄 License
+
+MIT License - see [LICENSE](./LICENSE) for details.
+
+## 🆘 Support
+
+- **Documentation**: [docs.tagadapay.com](https://docs.tagadapay.com)
+- **Discord**: [discord.gg/tagadapay](https://discord.gg/tagadapay)
+- **Email**: support@tagadapay.com
+- **GitHub Issues**: [github.com/tagadapay/plugin-sdk/issues](https://github.com/tagadapay/plugin-sdk/issues)
+
+---
+
+Built with ❤️ by the TagadaPay team

package/dist/react/hooks/useAddress.js

@@ -277,25 +277,25 @@ export function useAddress(options = {}) {
     // Custom styles for Google Places dropdown
     useEffect(() => {
         if (enableGooglePlaces && !document.getElementById('google-places-custom-styles')) {
-            const autocompleteStyles = `
-        .pac-container {
-          border-radius: 8px;
-          box-shadow: 0 4px 12px rgba(0, 0, 0, 0.15);
-          border: 1px solid #e2e8f0;
-          margin-top: 4px;
-          font-family: inherit;
-          z-index: 9999;
-        }
-        .pac-item {
-          padding: 10px 12px;
-          font-size: 14px;
-          cursor: pointer;
-          border-top: 1px solid #f3f4f6;
-        }
-        .pac-item:first-child { border-top: none; }
-        .pac-item:hover { background-color: #f8fafc; }
-        .pac-item-selected, .pac-item-selected:hover { background-color: #eef2ff; }
-        .pac-matched { font-weight: 600; }
+            const autocompleteStyles = `
+        .pac-container {
+          border-radius: 8px;
+          box-shadow: 0 4px 12px rgba(0, 0, 0, 0.15);
+          border: 1px solid #e2e8f0;
+          margin-top: 4px;
+          font-family: inherit;
+          z-index: 9999;
+        }
+        .pac-item {
+          padding: 10px 12px;
+          font-size: 14px;
+          cursor: pointer;
+          border-top: 1px solid #f3f4f6;
+        }
+        .pac-item:first-child { border-top: none; }
+        .pac-item:hover { background-color: #f8fafc; }
+        .pac-item-selected, .pac-item-selected:hover { background-color: #eef2ff; }
+        .pac-matched { font-weight: 600; }
       `;
             const styleElement = document.createElement('style');
             styleElement.id = 'google-places-custom-styles';

package/dist/react/hooks/useCheckout.js

@@ -1,7 +1,7 @@
-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, store, currency } = useTagadaContext();
     const { code: currentCurrency } = useCurrency();

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/dist/react/providers/TagadaProvider.js

@@ -22,11 +22,11 @@ const InitializationLoader = () => (_jsx("div", { style: {
         backgroundSize: '200% 100%',
         animation: 'tagada-loading 1.5s ease-in-out infinite',
         zIndex: 9999,
-    }, children: _jsx("style", { children: `
-        @keyframes tagada-loading {
-          0% { background-position: 200% 0; }
-          100% { background-position: -200% 0; }
-        }
+    }, children: _jsx("style", { children: `
+        @keyframes tagada-loading {
+          0% { background-position: 200% 0; }
+          100% { background-position: -200% 0; }
+        }
       ` }) }));
 const TagadaContext = createContext(null);
 export function TagadaProvider({ children, environment, customApiConfig, debugMode, // Remove default, will be set based on environment

package/package.json

@@ -1,66 +1,66 @@
-{
-  "name": "@tagadapay/plugin-sdk",
-  "version": "1.0.25",
-  "description": "Modern React SDK for building Tagada Pay plugins",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
-  "scripts": {
-    "build": "tsc",
-    "clean": "rm -rf dist",
-    "lint": "echo \"No linting configured\"",
-    "test": "echo \"No tests yet\" && exit 0",
-    "dev": "tsc --watch",
-    "prepublishOnly": "npm run clean && npm run build",
-    "publish:patch": "npm version patch && npm publish",
-    "publish:minor": "npm version minor && npm publish",
-    "publish:major": "npm version major && npm publish",
-    "publish:beta": "npm version prerelease --preid=beta && npm publish --tag beta",
-    "publish:alpha": "npm version prerelease --preid=alpha && npm publish --tag alpha",
-    "version:patch": "npm version patch",
-    "version:minor": "npm version minor",
-    "version:major": "npm version major",
-    "version:beta": "npm version prerelease --preid=beta",
-    "version:alpha": "npm version prerelease --preid=alpha"
-  },
-  "keywords": [
-    "tagadapay",
-    "cms",
-    "plugin",
-    "sdk",
-    "react",
-    "typescript"
-  ],
-  "author": "Tagada Pay",
-  "license": "MIT",
-  "dependencies": {
-    "@basis-theory/apple-pay-js": "^2.0.2",
-    "@basis-theory/basis-theory-js": "^4.30.0",
-    "@basis-theory/basis-theory-react": "^1.32.5",
-    "@basis-theory/web-threeds": "^1.0.1",
-    "axios": "^1.6.0",
-    "react-google-autocomplete": "^2.7.3",
-    "react-intl": "^7.1.11"
-  },
-  "devDependencies": {
-    "@types/node": "^18.0.0",
-    "@types/react": "^19",
-    "@types/react-dom": "^19",
-    "typescript": "^5.0.0"
-  },
-  "peerDependencies": {
-    "react": "^18.0.0 || ^19.0.0",
-    "react-dom": "^18.0.0 || ^19.0.0"
-  },
-  "files": [
-    "dist/**/*",
-    "README.md"
-  ],
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/tagadapay/plugin-sdk.git"
-  },
-  "bugs": {
-    "url": "https://github.com/tagadapay/plugin-sdk/issues"
-  },
-  "homepage": "https://github.com/tagadapay/plugin-sdk#readme"
-}
+{
+  "name": "@tagadapay/plugin-sdk",
+  "version": "1.0.26",
+  "description": "Modern React SDK for building Tagada Pay plugins",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "lint": "echo \"No linting configured\"",
+    "test": "echo \"No tests yet\" && exit 0",
+    "dev": "tsc --watch",
+    "prepublishOnly": "npm run clean && npm run build",
+    "publish:patch": "npm version patch && npm publish",
+    "publish:minor": "npm version minor && npm publish",
+    "publish:major": "npm version major && npm publish",
+    "publish:beta": "npm version prerelease --preid=beta && npm publish --tag beta",
+    "publish:alpha": "npm version prerelease --preid=alpha && npm publish --tag alpha",
+    "version:patch": "npm version patch",
+    "version:minor": "npm version minor",
+    "version:major": "npm version major",
+    "version:beta": "npm version prerelease --preid=beta",
+    "version:alpha": "npm version prerelease --preid=alpha"
+  },
+  "keywords": [
+    "tagadapay",
+    "cms",
+    "plugin",
+    "sdk",
+    "react",
+    "typescript"
+  ],
+  "author": "Tagada Pay",
+  "license": "MIT",
+  "dependencies": {
+    "@basis-theory/apple-pay-js": "^2.0.2",
+    "@basis-theory/basis-theory-js": "^4.30.0",
+    "@basis-theory/basis-theory-react": "^1.32.5",
+    "@basis-theory/web-threeds": "^1.0.1",
+    "axios": "^1.6.0",
+    "react-google-autocomplete": "^2.7.3",
+    "react-intl": "^7.1.11"
+  },
+  "devDependencies": {
+    "@types/node": "^18.0.0",
+    "@types/react": "^19",
+    "@types/react-dom": "^19",
+    "typescript": "^5.0.0"
+  },
+  "peerDependencies": {
+    "react": "^18.0.0 || ^19.0.0",
+    "react-dom": "^18.0.0 || ^19.0.0"
+  },
+  "files": [
+    "dist/**/*",
+    "README.md"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/tagadapay/plugin-sdk.git"
+  },
+  "bugs": {
+    "url": "https://github.com/tagadapay/plugin-sdk/issues"
+  },
+  "homepage": "https://github.com/tagadapay/plugin-sdk#readme"
+}