@tagadapay/plugin-sdk 2.6.17 → 2.7.0

package/dist/v2/core/resources/customer.d.ts

@@ -0,0 +1,150 @@
+/**
+ * Customer Resource Client
+ * Handles customer-related API operations
+ */
+import { ApiClient } from './apiClient';
+export interface CustomerAddress {
+    firstName: string | null;
+    lastName: string | null;
+    address1: string | null;
+    address2: string | null;
+    city: string | null;
+    province: string | null;
+    country: string | null;
+    zip: string | null;
+    phone: string | null;
+    email?: string | null;
+}
+export interface CustomerOrderSummary {
+    id: string;
+    totalPrice: number;
+    currency: string;
+    createdAt: string;
+    status: string;
+}
+export interface CustomerInfos {
+    customer: {
+        id: string;
+        email: string | null;
+        firstName: string | null;
+        lastName: string | null;
+        externalCustomerId: string | null;
+        lastOrderId: string | null;
+        accountId: string;
+        storeId: string;
+        billingAddress: CustomerAddress | null;
+        shippingAddress: Omit<CustomerAddress, 'email'> | null;
+        currency: string | null;
+        locale: string | null;
+        draft: boolean;
+        acceptsMarketing: boolean;
+        createdAt: string;
+        updatedAt: string;
+        metadata: Record<string, any>;
+        device: any | null;
+        orders: CustomerOrderSummary[];
+        subscriptions: any[];
+    };
+    promotionCodes: any[];
+}
+export interface OrderWithRelations {
+    id: string;
+    currency: string;
+    paidAmount: number;
+    status: string;
+    createdAt: string;
+    metadata?: Record<string, any>;
+    items: any[];
+    summaries?: any[];
+    shippingAddress?: any;
+    billingAddress?: any;
+    pickupAddress?: any;
+    checkoutSession?: {
+        returnUrl?: string;
+        [key: string]: any;
+    };
+    relatedOrders?: any[];
+    customer?: any;
+    store?: any;
+    account?: {
+        id: string;
+        name?: string;
+    };
+    payments?: any[];
+    promotions?: any[];
+    subscriptions?: any[];
+    adjustments: any[];
+}
+export interface Subscription {
+    id: string;
+    status: string;
+    createdAt: string;
+    currency: string;
+    cancelAtPeriodEnd: boolean;
+    currentPeriodEnd: string | null;
+    currentPeriodStart: string | null;
+    quantity: number;
+    trialEnd: string | null;
+    customerId: string;
+    customerEmail: string;
+    customerName: string;
+    priceCurrencyOptions: Record<string, {
+        rate: number;
+        amount: number;
+        lock: boolean;
+        date: string;
+    }>;
+    priceInterval: string;
+    priceIntervalCount: number;
+    priceRecurring: boolean;
+    productId: string;
+    priceId: string;
+    productTitle: string;
+}
+export interface SubscriptionsResponse {
+    items: Subscription[];
+    pagination: {
+        page: number;
+        pageSize: number;
+        hasNext: boolean;
+        nextPage: number | null;
+        previousPage: number | null;
+        totalItems: number;
+    };
+}
+export declare class CustomerResource {
+    private apiClient;
+    constructor(apiClient: ApiClient);
+    /**
+     * Get customer information by ID
+     */
+    getCustomerInfos(customerId: string, storeId: string): Promise<CustomerInfos>;
+    /**
+     * Update customer information
+     */
+    updateCustomer(customerId: string, data: {
+        email?: string;
+        firstName?: string;
+        lastName?: string;
+        acceptsMarketing?: boolean;
+        metadata?: Record<string, any>;
+    }): Promise<CustomerInfos>;
+    /**
+     * Get customer orders
+     */
+    getCustomerOrders(customerId: string, storeId: string): Promise<{
+        orders: OrderWithRelations[];
+    }>;
+    /**
+     * Get customer subscriptions
+     */
+    getCustomerSubscriptions(): Promise<SubscriptionsResponse>;
+    /**
+     * Resume a subscription
+     */
+    resumeSubscription(subscriptionId: string): Promise<void>;
+    /**
+     * Cancel a subscription
+     */
+    cancelSubscription(subscriptionId: string): Promise<void>;
+}

package/dist/v2/core/resources/customer.js

@@ -0,0 +1,53 @@
+/**
+ * Customer Resource Client
+ * Handles customer-related API operations
+ */
+export class CustomerResource {
+    constructor(apiClient) {
+        this.apiClient = apiClient;
+    }
+    /**
+     * Get customer information by ID
+     */
+    async getCustomerInfos(customerId, storeId) {
+        return this.apiClient.get(`/api/v1/customers/${customerId}`, {
+            params: { storeId },
+        });
+    }
+    /**
+     * Update customer information
+     */
+    async updateCustomer(customerId, data) {
+        return this.apiClient.patch(`/api/v1/customers/${customerId}`, data);
+    }
+    /**
+     * Get customer orders
+     */
+    async getCustomerOrders(customerId, storeId) {
+        return this.apiClient.get(`/api/v1/orders/customer/${customerId}`, {
+            params: { storeId },
+        });
+    }
+    /**
+     * Get customer subscriptions
+     */
+    async getCustomerSubscriptions() {
+        return this.apiClient.get('/api/v1/subscriptions');
+    }
+    /**
+     * Resume a subscription
+     */
+    async resumeSubscription(subscriptionId) {
+        return this.apiClient.post('/api/v1/subscriptions/resume', {
+            subscriptionId,
+        });
+    }
+    /**
+     * Cancel a subscription
+     */
+    async cancelSubscription(subscriptionId) {
+        return this.apiClient.post('/api/v1/subscriptions/cancel', {
+            subscriptionId,
+        });
+    }
+}

package/dist/v2/core/resources/index.d.ts

@@ -4,15 +4,17 @@
  */
 export * from './apiClient';
 export * from './checkout';
+export * from './customer';
 export * from './discounts';
+export * from './funnel';
 export * from './offers';
 export * from './orders';
 export * from './payments';
 export * from './postPurchases';
 export * from './products';
 export * from './promotions';
+export * from './session';
 export * from './shippingRates';
 export * from './storeConfig';
 export * from './threeds';
 export * from './vipOffers';
-export * from './funnel';

package/dist/v2/core/resources/index.js

@@ -4,15 +4,17 @@
  */
 export * from './apiClient';
 export * from './checkout';
+export * from './customer';
 export * from './discounts';
+export * from './funnel';
 export * from './offers';
 export * from './orders';
 export * from './payments';
 export * from './postPurchases';
 export * from './products';
 export * from './promotions';
+export * from './session';
 export * from './shippingRates';
 export * from './storeConfig';
 export * from './threeds';
 export * from './vipOffers';
-export * from './funnel';

package/dist/v2/core/resources/session.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Session Resource Client
+ * Handles authentication and session management
+ */
+import { ApiClient } from './apiClient';
+export interface RequestCodeResponse {
+    success: boolean;
+    error?: string;
+}
+export interface VerifyCodeResponse {
+    success: boolean;
+    token?: string;
+    sessionId?: string;
+    error?: string;
+}
+export declare class SessionResource {
+    private apiClient;
+    constructor(apiClient: ApiClient);
+    /**
+     * Request verification code for email
+     */
+    requestCode(email: string, storeId: string): Promise<RequestCodeResponse>;
+    /**
+     * Verify code and login
+     */
+    verifyCode(email: string, code: string, storeId: string): Promise<VerifyCodeResponse>;
+}

package/dist/v2/core/resources/session.js

@@ -0,0 +1,56 @@
+/**
+ * Session Resource Client
+ * Handles authentication and session management
+ */
+export class SessionResource {
+    constructor(apiClient) {
+        this.apiClient = apiClient;
+    }
+    /**
+     * Request verification code for email
+     */
+    async requestCode(email, storeId) {
+        try {
+            await this.apiClient.post('/api/v1/cms/session/request-code', {
+                email,
+                storeId,
+            });
+            return { success: true };
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: error instanceof Error ? error.message : 'Failed to send code',
+            };
+        }
+    }
+    /**
+     * Verify code and login
+     */
+    async verifyCode(email, code, storeId) {
+        try {
+            const response = await this.apiClient.post('/api/v1/cms/session/login', {
+                email,
+                code,
+                storeId,
+            });
+            if (!response) {
+                return {
+                    success: false,
+                    error: 'Invalid code',
+                };
+            }
+            return {
+                success: true,
+                token: response.token,
+                sessionId: response.sessionId,
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: error instanceof Error ? error.message : 'Failed to verify code',
+            };
+        }
+    }
+}

package/dist/v2/index.d.ts

@@ -21,5 +21,12 @@ export type { ApplyDiscountResponse, Discount, DiscountCodeValidation, RemoveDis
 export type { ToggleOrderBumpResponse, VipOffer, VipPreviewResponse } from './core/resources/vipOffers';
 export type { StoreConfig } from './core/resources/storeConfig';
 export type { FunnelContextUpdateRequest, FunnelContextUpdateResponse, FunnelEvent, FunnelInitializeRequest, FunnelInitializeResponse, FunnelNavigateRequest, FunnelNavigateResponse, FunnelNavigationAction, FunnelNavigationResult, SimpleFunnelContext } from './core/resources/funnel';
-export { ApplePayButton, ExpressPaymentMethodsProvider, formatMoney, getAvailableLanguages, GooglePayButton, queryKeys, TagadaProvider, useApiMutation, useApiQuery, useCheckout, useCheckoutToken, useCountryOptions, useCurrency, useDiscount, useDiscounts, useExpressPaymentMethods, useFunnel, useGeoLocation, useGoogleAutocomplete, useInvalidateQuery, useISOData, useLanguageImport, useOffers, useOrder, useOrderBump, usePayment, usePluginConfig, usePostPurchases, usePreloadQuery, useProducts, usePromotions, useRegionOptions, useShippingRates, useSimpleFunnel, useStoreConfig, useTagadaContext, useThreeds, useThreedsModal, useTranslation, useVipOffers } from './react';
-export type { StoreDiscount, TranslateFunction, TranslationText, UseTranslationOptions, UseTranslationResult } from './react';
+export { ApplePayButton, ExpressPaymentMethodsProvider, formatMoney, getAvailableLanguages, GooglePayButton, queryKeys, TagadaProvider, useApiMutation, useApiQuery, useAuth, useCheckout, useCheckoutToken, useClubOffers, useCountryOptions, useCurrency, useCustomer, useCustomerInfos, useCustomerOrders, useCustomerSubscriptions, useDiscounts, useExpressPaymentMethods, useFunnel, useGeoLocation, useGoogleAutocomplete, useInvalidateQuery, useISOData, useLanguageImport, useLogin, useOffers, useOrder, useOrderBump, usePayment, usePluginConfig, usePostPurchases, usePreloadQuery, useProducts, usePromotions, useRegionOptions, useShippingRates, useSimpleFunnel, useStoreConfig, useTagadaContext, useThreeds, useThreedsModal, useTranslation, useVipOffers } from './react';
+export type { TranslateFunction, UseTranslationOptions, UseTranslationResult } from './react/hooks/useTranslation';
+export type { ClubOffer, ClubOfferItem, ClubOfferLineItem, ClubOfferSummary, UseClubOffersOptions, UseClubOffersResult } from './react/hooks/useClubOffers';
+export type { UseLoginOptions, UseLoginResult } from './react/hooks/useLogin';
+export type { CustomerAddress, CustomerInfos, CustomerOrderSummary, OrderWithRelations, Subscription, SubscriptionsResponse } from './core/resources/customer';
+export type { UseCustomerResult } from './react/hooks/useCustomer';
+export type { UseCustomerInfosOptions, UseCustomerInfosResult } from './react/hooks/useCustomerInfos';
+export type { UseCustomerOrdersOptions, UseCustomerOrdersResult } from './react/hooks/useCustomerOrders';
+export type { UseCustomerSubscriptionsOptions, UseCustomerSubscriptionsResult } from './react/hooks/useCustomerSubscriptions';

package/dist/v2/index.js

@@ -12,4 +12,4 @@ export * from './core/utils/currency';
 export * from './core/utils/pluginConfig';
 export * from './core/utils/products';
 // React exports (hooks and components only, types are exported above)
-export { ApplePayButton, ExpressPaymentMethodsProvider, formatMoney, getAvailableLanguages, GooglePayButton, queryKeys, TagadaProvider, useApiMutation, useApiQuery, useCheckout, useCheckoutToken, useCountryOptions, useCurrency, useDiscount, useDiscounts, useExpressPaymentMethods, useFunnel, useGeoLocation, useGoogleAutocomplete, useInvalidateQuery, useISOData, useLanguageImport, useOffers, useOrder, useOrderBump, usePayment, usePluginConfig, usePostPurchases, usePreloadQuery, useProducts, usePromotions, useRegionOptions, useShippingRates, useSimpleFunnel, useStoreConfig, useTagadaContext, useThreeds, useThreedsModal, useTranslation, useVipOffers } from './react';
+export { ApplePayButton, ExpressPaymentMethodsProvider, formatMoney, getAvailableLanguages, GooglePayButton, queryKeys, TagadaProvider, useApiMutation, useApiQuery, useAuth, useCheckout, useCheckoutToken, useClubOffers, useCountryOptions, useCurrency, useCustomer, useCustomerInfos, useCustomerOrders, useCustomerSubscriptions, useDiscounts, useExpressPaymentMethods, useFunnel, useGeoLocation, useGoogleAutocomplete, useInvalidateQuery, useISOData, useLanguageImport, useLogin, useOffers, useOrder, useOrderBump, usePayment, usePluginConfig, usePostPurchases, usePreloadQuery, useProducts, usePromotions, useRegionOptions, useShippingRates, useSimpleFunnel, useStoreConfig, useTagadaContext, useThreeds, useThreedsModal, useTranslation, useVipOffers } from './react';

package/dist/v2/react/hooks/useAuth.d.ts

@@ -0,0 +1,8 @@
+/**
+ * useAuth - Hook to access authentication state (v2)
+ * Uses TagadaContext for auth state management
+ */
+import { AuthState } from '../../../react/types';
+export declare function useAuth(): AuthState & {
+    isInitialized: boolean;
+};

package/dist/v2/react/hooks/useAuth.js

@@ -0,0 +1,9 @@
+'use client';
+import { useTagadaContext } from '../providers/TagadaProvider';
+export function useAuth() {
+    const { auth, isInitialized } = useTagadaContext();
+    return {
+        ...auth,
+        isInitialized,
+    };
+}

package/dist/v2/react/hooks/useClubOffers.d.ts

@@ -0,0 +1,101 @@
+export interface ClubOfferItem {
+    id: string;
+    productId: string;
+    variantId: string;
+    product: {
+        name: string;
+        description: string;
+    };
+    variant: {
+        name: string;
+        description: string;
+        imageUrl: string;
+        grams: number;
+    };
+    unitAmount: number;
+    quantity: number;
+    amount: number;
+    adjustedAmount: number;
+}
+export interface ClubOfferSummary {
+    currency: string;
+    totalAmount: number;
+    totalAdjustedAmount: number;
+    items: ClubOfferItem[];
+}
+export interface ClubOfferLineItem {
+    id: string;
+    quantity: number;
+    price: {
+        variant: {
+            id: string;
+            name: string;
+            description: string | null;
+            imageUrl: string;
+            grams: number;
+            product: {
+                id: string;
+                name: string;
+                description: string;
+            };
+        };
+    };
+}
+export interface ClubOffer {
+    id: string;
+    titleTrans: {
+        en: string;
+    };
+    summaries: ClubOfferSummary[];
+    offerLineItems: ClubOfferLineItem[];
+}
+export interface UseClubOffersOptions {
+    /**
+     * Whether to fetch club offers automatically on mount
+     * @default true
+     */
+    enabled?: boolean;
+    /**
+     * Return URL for payment
+     */
+    returnUrl?: string;
+}
+export interface UseClubOffersResult {
+    /**
+     * Array of fetched club offers
+     */
+    offers: ClubOffer[];
+    /**
+     * Loading state
+     */
+    isLoading: boolean;
+    /**
+     * Error state
+     */
+    error: Error | null;
+    /**
+     * Refetch club offers
+     */
+    refetch: () => Promise<void>;
+    /**
+     * Get club offer by ID from the loaded offers
+     */
+    getOffer: (offerId: string) => ClubOffer | undefined;
+    /**
+     * Get total value of all club offers
+     */
+    getTotalValue: () => number;
+    /**
+     * Get total savings across all club offers
+     */
+    getTotalSavings: () => number;
+    /**
+     * Clear error state
+     */
+    clearError: () => void;
+    /**
+     * Pay for a club offer
+     */
+    payOffer: (offerId: string, returnUrl?: string) => Promise<void>;
+}
+export declare function useClubOffers(options?: UseClubOffersOptions): UseClubOffersResult;

package/dist/v2/react/hooks/useClubOffers.js

@@ -0,0 +1,126 @@
+'use client';
+/**
+ * useClubOffers - Hook for club-specific offers (v2)
+ * Extends the offers functionality with club filtering
+ */
+import { useMutation, useQuery } from '@tanstack/react-query';
+import { useCallback, useMemo } from 'react';
+import { OffersResource } from '../../core/resources/offers';
+import { useTagadaContext } from '../providers/TagadaProvider';
+import { getGlobalApiClient } from './useApiQuery';
+import { usePluginConfig } from './usePluginConfig';
+/**
+ * Transform generic Offer to ClubOffer format
+ */
+function transformToClubOffer(offer) {
+    return {
+        id: offer.id,
+        titleTrans: offer.titleTrans,
+        summaries: offer.summaries.map((summary) => ({
+            currency: summary.currency,
+            totalAmount: summary.totalAmount,
+            totalAdjustedAmount: summary.totalAdjustedAmount,
+            items: summary.items.map((item) => ({
+                id: item.id,
+                productId: item.id, // Using item ID as productId fallback
+                variantId: item.id, // Using item ID as variantId fallback
+                product: item.product,
+                variant: {
+                    name: item.variant.name,
+                    description: '', // Not available in base Offer
+                    imageUrl: item.variant.imageUrl,
+                    grams: 0, // Not available in base Offer
+                },
+                unitAmount: item.unitAmount,
+                quantity: item.quantity,
+                amount: item.amount,
+                adjustedAmount: item.adjustedAmount,
+            })),
+        })),
+        offerLineItems: [], // Not available in base Offer
+    };
+}
+export function useClubOffers(options = {}) {
+    const { enabled = true, returnUrl } = options;
+    const { storeId } = usePluginConfig();
+    const { isSessionInitialized } = useTagadaContext();
+    // Create offers resource client
+    const offersResource = useMemo(() => {
+        try {
+            return new OffersResource(getGlobalApiClient());
+        }
+        catch (error) {
+            throw new Error('Failed to initialize offers resource: ' +
+                (error instanceof Error ? error.message : 'Unknown error'));
+        }
+    }, []);
+    // Create query key
+    const queryKey = useMemo(() => ['club-offers', { storeId }], [storeId]);
+    // Fetch club offers using TanStack Query
+    const { data: offers = [], isLoading, error, refetch, } = useQuery({
+        queryKey,
+        enabled: enabled && !!storeId && isSessionInitialized,
+        queryFn: async () => {
+            if (!storeId) {
+                throw new Error('Store ID not found. Make sure the TagadaProvider is properly configured.');
+            }
+            // Fetch all offers and filter for club type
+            // Note: The API endpoint should support a 'type' parameter
+            const response = await getGlobalApiClient().get(`/api/v1/stores/${storeId}/offers`, {
+                params: {
+                    type: 'club',
+                },
+            });
+            // Transform to club offer format
+            return (response.offers || []).map(transformToClubOffer);
+        },
+        staleTime: 5 * 60 * 1000, // 5 minutes
+        refetchOnWindowFocus: false,
+    });
+    // Pay offer mutation
+    const payOfferMutation = useMutation({
+        mutationFn: async ({ offerId, returnUrl }) => {
+            const url = returnUrl || (typeof window !== 'undefined' ? window.location.href : '');
+            return await offersResource.payOffer(offerId);
+        },
+        onError: (error) => {
+            console.error('[SDK] Failed to pay offer:', error);
+        },
+    });
+    // Helper functions
+    const getOffer = useCallback((offerId) => {
+        return offers.find((offer) => offer.id === offerId);
+    }, [offers]);
+    const getTotalValue = useCallback(() => {
+        return offers.reduce((total, offer) => {
+            const firstSummary = offer.summaries[0];
+            return total + (firstSummary?.totalAdjustedAmount || 0);
+        }, 0);
+    }, [offers]);
+    const getTotalSavings = useCallback(() => {
+        return offers.reduce((total, offer) => {
+            const firstSummary = offer.summaries[0];
+            return total + (firstSummary?.totalAmount - firstSummary?.totalAdjustedAmount || 0);
+        }, 0);
+    }, [offers]);
+    const clearError = useCallback(() => {
+        // TanStack Query doesn't have a direct clearError method
+        // Error will be cleared on next successful fetch
+    }, []);
+    const payOffer = useCallback(async (offerId, returnUrl) => {
+        await payOfferMutation.mutateAsync({ offerId, returnUrl });
+    }, [payOfferMutation]);
+    return {
+        offers,
+        isLoading,
+        error,
+        refetch: async () => {
+            await refetch();
+        },
+        getOffer,
+        getTotalValue,
+        getTotalSavings,
+        clearError,
+        payOffer,
+    };
+}

package/dist/v2/react/hooks/useCustomer.d.ts

@@ -0,0 +1,11 @@
+/**
+ * useCustomer - Hook to access current customer data (v2)
+ */
+import { Customer } from '../../../react/types';
+export interface UseCustomerResult {
+    customer: Customer | null;
+    isAuthenticated: boolean;
+    isLoading: boolean;
+    isAnonymous: boolean;
+}
+export declare function useCustomer(): UseCustomerResult;

package/dist/v2/react/hooks/useCustomer.js

@@ -0,0 +1,11 @@
+'use client';
+import { useTagadaContext } from '../providers/TagadaProvider';
+export function useCustomer() {
+    const { customer, isLoading } = useTagadaContext();
+    return {
+        customer,
+        isAuthenticated: customer?.isAuthenticated || false,
+        isLoading,
+        isAnonymous: customer?.role === 'anonymous',
+    };
+}

package/dist/v2/react/hooks/useCustomerInfos.d.ts

@@ -0,0 +1,12 @@
+import { CustomerInfos } from '../../core/resources/customer';
+export interface UseCustomerInfosOptions {
+    customerId?: string | null;
+    enabled?: boolean;
+}
+export interface UseCustomerInfosResult {
+    data: CustomerInfos | null;
+    isLoading: boolean;
+    error: Error | null;
+    refetch: () => Promise<void>;
+}
+export declare function useCustomerInfos(options?: UseCustomerInfosOptions): UseCustomerInfosResult;