@tagadapay/plugin-sdk 2.4.39 → 2.5.0

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

@@ -0,0 +1,189 @@
+/**
+ * Checkout Resource Client
+ * Axios-based API client for checkout endpoints
+ */
+import { ApiClient } from './apiClient';
+export interface CheckoutLineItem {
+    externalProductId?: string | null;
+    externalVariantId?: string | null;
+    variantId?: string | null;
+    priceId?: string | null;
+    quantity: number;
+}
+export interface CheckoutInitParams {
+    lineItems: CheckoutLineItem[];
+    cartToken?: string;
+    promotionIds?: string[];
+    returnUrl?: string;
+    draft?: boolean;
+    useCustomDomain?: boolean;
+    customerMetadata?: Record<string, unknown>;
+    metadata?: Record<string, unknown>;
+    storeId?: string;
+    customer?: {
+        currency?: string;
+        locale?: string;
+    };
+}
+export interface CheckoutSession {
+    id: string;
+    checkoutToken: string;
+    status: string;
+    storeId: string;
+    accountId: string;
+    customerId: string;
+    draft: boolean;
+    createdAt: string;
+    updatedAt: string;
+    lastActiveDate: string;
+    selectedPresentmentCurrency: string;
+    [key: string]: any;
+}
+export interface CheckoutData {
+    checkoutSession: CheckoutSession;
+    customerIsClubMember: boolean;
+    clubProductId?: string;
+    summary: any;
+    availablePromotions: any[];
+}
+export interface Promotion {
+    id: string;
+    name: string;
+    description: string | null;
+    type: string;
+    rules: any[];
+    actions: any[];
+}
+export declare class CheckoutResource {
+    private apiClient;
+    constructor(apiClient: ApiClient);
+    /**
+     * Initialize a new checkout session
+     */
+    initCheckout(params: CheckoutInitParams): Promise<{
+        checkoutUrl: string;
+        checkoutSession: CheckoutSession;
+        checkoutToken: string;
+    }>;
+    /**
+     * Get checkout session by token
+     */
+    getCheckout(checkoutToken: string, currency?: string): Promise<CheckoutData>;
+    /**
+     * Update checkout address
+     */
+    updateAddress(checkoutSessionId: string, data: {
+        shippingAddress: any;
+        billingAddress?: any;
+    }): Promise<{
+        success: boolean;
+        errors?: Record<string, {
+            message: string;
+            type: string;
+        }>;
+        shippingCountryChanged: boolean;
+        billingCountryChanged: boolean;
+    }>;
+    /**
+     * Set checkout info
+     */
+    setCheckoutInfo(checkoutSessionId: string, data: {
+        shippingAddress: any;
+        billingAddress?: any;
+        differentBillingAddress?: boolean;
+    }): Promise<{
+        success: boolean;
+        errors?: Record<string, {
+            message: string;
+            type: string;
+        }>;
+        shippingCountryChanged?: boolean;
+        billingCountryChanged?: boolean;
+    }>;
+    /**
+     * Apply promotion code
+     */
+    applyPromotionCode(checkoutSessionId: string, code: string): Promise<{
+        success: boolean;
+        error?: any;
+    }>;
+    /**
+     * Remove promotion
+     */
+    removePromotion(checkoutSessionId: string, promotionId: string): Promise<{
+        success: boolean;
+        error?: any;
+    }>;
+    /**
+     * Get applied promotions
+     */
+    getAppliedPromotions(checkoutSessionId: string): Promise<Promotion[]>;
+    /**
+     * Update line items
+     */
+    updateLineItems(checkoutSessionId: string, lineItems: CheckoutLineItem[]): Promise<{
+        success: boolean;
+        error?: any;
+    }>;
+    /**
+     * Add line items
+     */
+    addLineItems(checkoutSessionId: string, lineItems: CheckoutLineItem[]): Promise<{
+        success: boolean;
+        error?: any;
+    }>;
+    /**
+     * Remove line items
+     */
+    removeLineItems(checkoutSessionId: string, lineItems: {
+        variantId: string;
+        quantity?: number;
+    }[]): Promise<{
+        success: boolean;
+        error?: any;
+    }>;
+    /**
+     * Set item quantity
+     */
+    setItemQuantity(checkoutSessionId: string, variantId: string, quantity: number, priceId?: string): Promise<{
+        success: boolean;
+        error?: any;
+    }>;
+    /**
+     * Toggle order bump
+     */
+    toggleOrderBump(checkoutSessionId: string, orderBumpOfferId: string, selected: boolean): Promise<{
+        success: boolean;
+        error?: any;
+    }>;
+    /**
+     * Update customer
+     */
+    updateCustomer(checkoutSessionId: string, data: {
+        email: string;
+        acceptsMarketing?: boolean;
+    }): Promise<{
+        success: boolean;
+        error?: any;
+    }>;
+    /**
+     * Update customer and session info
+     */
+    updateCustomerAndSessionInfo(checkoutSessionId: string, data: {
+        customerData: {
+            email: string;
+            acceptsMarketing?: boolean;
+        };
+        shippingAddress: any;
+        billingAddress?: any;
+        differentBillingAddress?: boolean;
+    }): Promise<{
+        success: boolean;
+        errors?: Record<string, {
+            message: string;
+            type: string;
+        }>;
+        shippingCountryChanged?: boolean;
+        billingCountryChanged?: boolean;
+    }>;
+}

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

@@ -0,0 +1,119 @@
+/**
+ * Checkout Resource Client
+ * Axios-based API client for checkout endpoints
+ */
+export class CheckoutResource {
+    constructor(apiClient) {
+        this.apiClient = apiClient;
+    }
+    /**
+     * Initialize a new checkout session
+     */
+    async initCheckout(params) {
+        return this.apiClient.post('/api/v1/checkout/session/init', params);
+    }
+    /**
+     * Get checkout session by token
+     */
+    async getCheckout(checkoutToken, currency) {
+        const queryParams = new URLSearchParams();
+        if (currency) {
+            queryParams.set('currency', currency);
+        }
+        const url = `/api/v1/checkout-sessions/${checkoutToken}/v2${queryParams.toString() ? `?${queryParams.toString()}` : ''}`;
+        return this.apiClient.get(url);
+    }
+    /**
+     * Update checkout address
+     */
+    async updateAddress(checkoutSessionId, data) {
+        return this.apiClient.post(`/api/v1/checkout-sessions/${checkoutSessionId}/address`, {
+            data,
+        });
+    }
+    /**
+     * Set checkout info
+     */
+    async setCheckoutInfo(checkoutSessionId, data) {
+        return this.apiClient.post(`/api/v1/checkout-sessions/${checkoutSessionId}/checkout-info`, {
+            shippingAddress: data.shippingAddress,
+            billingAddress: data.differentBillingAddress ? data.billingAddress : data.shippingAddress,
+            differentBillingAddress: data.differentBillingAddress || false,
+        });
+    }
+    /**
+     * Apply promotion code
+     */
+    async applyPromotionCode(checkoutSessionId, code) {
+        return this.apiClient.post(`/api/v1/checkout-sessions/${checkoutSessionId}/promotions/apply`, {
+            code,
+        });
+    }
+    /**
+     * Remove promotion
+     */
+    async removePromotion(checkoutSessionId, promotionId) {
+        return this.apiClient.delete(`/api/v1/checkout-sessions/${checkoutSessionId}/promotions/${promotionId}`);
+    }
+    /**
+     * Get applied promotions
+     */
+    async getAppliedPromotions(checkoutSessionId) {
+        return this.apiClient.get(`/api/v1/checkout-sessions/${checkoutSessionId}/promotions`);
+    }
+    /**
+     * Update line items
+     */
+    async updateLineItems(checkoutSessionId, lineItems) {
+        return this.apiClient.post(`/api/v1/checkout-sessions/${checkoutSessionId}/line-items`, {
+            lineItems,
+        });
+    }
+    /**
+     * Add line items
+     */
+    async addLineItems(checkoutSessionId, lineItems) {
+        return this.apiClient.post(`/api/v1/checkout-sessions/${checkoutSessionId}/line-items/add`, {
+            lineItems,
+        });
+    }
+    /**
+     * Remove line items
+     */
+    async removeLineItems(checkoutSessionId, lineItems) {
+        return this.apiClient.post(`/api/v1/checkout-sessions/${checkoutSessionId}/line-items/remove`, {
+            lineItems,
+        });
+    }
+    /**
+     * Set item quantity
+     */
+    async setItemQuantity(checkoutSessionId, variantId, quantity, priceId) {
+        return this.apiClient.post(`/api/v1/checkout-sessions/${checkoutSessionId}/line-items/set-quantity`, {
+            variantId,
+            quantity,
+            priceId,
+        });
+    }
+    /**
+     * Toggle order bump
+     */
+    async toggleOrderBump(checkoutSessionId, orderBumpOfferId, selected) {
+        return this.apiClient.post(`/api/v1/checkout-sessions/${checkoutSessionId}/toggle-order-bump`, {
+            orderBumpOfferId,
+            selected,
+        });
+    }
+    /**
+     * Update customer
+     */
+    async updateCustomer(checkoutSessionId, data) {
+        return this.apiClient.post(`/api/v1/checkout-sessions/${checkoutSessionId}/customer`, data);
+    }
+    /**
+     * Update customer and session info
+     */
+    async updateCustomerAndSessionInfo(checkoutSessionId, data) {
+        return this.apiClient.post(`/api/v1/checkout-sessions/${checkoutSessionId}/customer-and-session-info`, data);
+    }
+}

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

@@ -0,0 +1,13 @@
+/**
+ * Resource Clients
+ * Axios-based API clients for all endpoints
+ */
+export * from './apiClient';
+export * from './products';
+export * from './orders';
+export * from './payments';
+export * from './checkout';
+export * from './promotions';
+export * from './postPurchases';
+export * from './offers';
+export * from './threeds';

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

@@ -0,0 +1,13 @@
+/**
+ * Resource Clients
+ * Axios-based API clients for all endpoints
+ */
+export * from './apiClient';
+export * from './products';
+export * from './orders';
+export * from './payments';
+export * from './checkout';
+export * from './promotions';
+export * from './postPurchases';
+export * from './offers';
+export * from './threeds';

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

@@ -0,0 +1,98 @@
+/**
+ * Offers Resource Client
+ * Axios-based API client for offers endpoints
+ */
+import { ApiClient } from './apiClient';
+export interface OfferItem {
+    id: string;
+    product: {
+        name: string;
+        description: string;
+    };
+    variant: {
+        name: string;
+        imageUrl: string;
+    };
+    quantity: number;
+    unitAmount: number;
+    amount: number;
+    adjustedAmount: number;
+    currency: string;
+}
+export interface OfferSummary {
+    items: OfferItem[];
+    totalAmount: number;
+    totalAdjustedAmount: number;
+    totalPromotionAmount: number;
+    currency: string;
+    adjustments: {
+        type: string;
+        description: string;
+        amount: number;
+    }[];
+}
+import type { CurrencyOptions, VariantOption, OrderSummaryItem, OrderSummary, CheckoutSessionState } from './postPurchases';
+export type { CurrencyOptions, VariantOption, OrderSummaryItem, OrderSummary, CheckoutSessionState };
+export interface Offer {
+    id: string;
+    titleTrans: Record<string, string>;
+    summaries: OfferSummary[];
+}
+export declare class OffersResource {
+    private apiClient;
+    constructor(apiClient: ApiClient);
+    /**
+     * Get offers for a store
+     */
+    getOffers(storeId: string): Promise<Offer[]>;
+    /**
+     * Get offers by IDs
+     */
+    getOffersByIds(storeId: string, offerIds: string[]): Promise<Offer[]>;
+    /**
+     * Initialize checkout session for an offer
+     */
+    initCheckoutSession(offerId: string, orderId: string, customerId?: string): Promise<{
+        checkoutSessionId: string;
+    }>;
+    /**
+     * Create checkout session for an offer
+     */
+    createCheckoutSession(offerId: string, returnUrl?: string): Promise<{
+        checkoutUrl: string;
+    }>;
+    /**
+     * Pay with checkout session
+     */
+    payWithCheckoutSession(checkoutSessionId: string, orderId?: string): Promise<void>;
+    /**
+     * Pay for an offer directly
+     */
+    payOffer(offerId: string, orderId?: string): Promise<any>;
+    /**
+     * Transform offer to checkout session with dynamic variant selection
+     */
+    transformToCheckout(offerId: string, returnUrl?: string): Promise<{
+        checkoutUrl: string;
+    }>;
+    /**
+     * Initialize checkout session for an offer with variants (similar to postPurchases)
+     */
+    initCheckoutSessionWithVariants(offerId: string, lineItems: {
+        variantId: string;
+        quantity: number;
+    }[], returnUrl?: string): Promise<{
+        checkoutSessionId: string;
+    }>;
+    /**
+     * Get order summary for a checkout session
+     */
+    getOrderSummary(sessionId: string, includeVariantOptions?: boolean): Promise<any>;
+    /**
+     * Update line items for a checkout session
+     */
+    updateLineItems(sessionId: string, lineItems: {
+        variantId: string;
+        quantity: number;
+    }[]): Promise<any>;
+}

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

@@ -0,0 +1,115 @@
+/**
+ * Offers Resource Client
+ * Axios-based API client for offers endpoints
+ */
+export class OffersResource {
+    constructor(apiClient) {
+        this.apiClient = apiClient;
+    }
+    /**
+     * Get offers for a store
+     */
+    async getOffers(storeId) {
+        const response = await this.apiClient.get(`/api/v1/stores/${storeId}/offers`);
+        return response.offers || [];
+    }
+    /**
+     * Get offers by IDs
+     */
+    async getOffersByIds(storeId, offerIds) {
+        const allOffers = await this.getOffers(storeId);
+        return allOffers.filter(offer => offerIds.includes(offer.id));
+    }
+    /**
+     * Initialize checkout session for an offer
+     */
+    async initCheckoutSession(offerId, orderId, customerId) {
+        const response = await this.apiClient.post('/api/v1/checkout/offer/init', {
+            offerId,
+            returnUrl: typeof window !== 'undefined' ? window.location.href : '',
+            customerId: customerId || '',
+            orderId,
+        });
+        return { checkoutSessionId: response.checkoutSessionId };
+    }
+    /**
+     * Create checkout session for an offer
+     */
+    async createCheckoutSession(offerId, returnUrl) {
+        const response = await this.apiClient.post(`/api/v1/offers/${offerId}/checkout`, {
+            returnUrl: returnUrl || (typeof window !== 'undefined' ? window.location.origin : ''),
+        });
+        return { checkoutUrl: response.checkoutUrl };
+    }
+    /**
+     * Pay with checkout session
+     */
+    async payWithCheckoutSession(checkoutSessionId, orderId) {
+        await this.apiClient.post(`/api/v1/checkout-sessions/${checkoutSessionId}/pay`, {
+            checkoutSessionId,
+            draft: false,
+            returnUrl: typeof window !== 'undefined' ? window.location.href : '',
+            metadata: {
+                comingFromPostPurchase: true,
+                postOrder: orderId,
+                upsell: true,
+                source: 'offer',
+            },
+        });
+    }
+    /**
+     * Pay for an offer directly
+     */
+    async payOffer(offerId, orderId) {
+        return this.apiClient.post(`/api/v1/offers/${offerId}/pay`, {
+            offerId,
+            draft: false,
+            returnUrl: typeof window !== 'undefined' ? window.location.href : '',
+            metadata: orderId ? {
+                comingFromPostPurchase: true,
+                postOrder: orderId,
+                upsell: true,
+                source: 'offer',
+            } : {
+                upsell: true,
+                source: 'offer',
+            },
+        });
+    }
+    /**
+     * Transform offer to checkout session with dynamic variant selection
+     */
+    async transformToCheckout(offerId, returnUrl) {
+        const response = await this.apiClient.post(`/api/v1/offers/${offerId}/transform-to-checkout`, {
+            returnUrl: returnUrl || (typeof window !== 'undefined' ? window.location.origin : ''),
+        });
+        return { checkoutUrl: response.checkoutUrl };
+    }
+    /**
+     * Initialize checkout session for an offer with variants (similar to postPurchases)
+     */
+    async initCheckoutSessionWithVariants(offerId, lineItems, returnUrl) {
+        const response = await this.apiClient.post(`/api/v1/offers/${offerId}/transform-to-checkout`, {
+            offerId,
+            lineItems,
+            returnUrl: returnUrl || (typeof window !== 'undefined' ? window.location.href : ''),
+        });
+        return { checkoutSessionId: response.checkoutSessionId };
+    }
+    /**
+     * Get order summary for a checkout session
+     */
+    async getOrderSummary(sessionId, includeVariantOptions = false) {
+        return this.apiClient.post(`/api/v1/checkout-sessions/${sessionId}/order-summary`, {
+            includeVariantOptions,
+        });
+    }
+    /**
+     * Update line items for a checkout session
+     */
+    async updateLineItems(sessionId, lineItems) {
+        return this.apiClient.post(`/api/v1/checkout-sessions/${sessionId}/line-items`, {
+            lineItems,
+        });
+    }
+}

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

@@ -0,0 +1,40 @@
+/**
+ * Orders Resource Client
+ * Axios-based API client for order endpoints
+ */
+import { Order, OrderLineItem } from '../utils/order';
+import { ApiClient } from './apiClient';
+export declare class OrdersResource {
+    private apiClient;
+    constructor(apiClient: ApiClient);
+    /**
+     * Fetch order by ID
+     */
+    getOrder(orderId: string): Promise<Order>;
+    /**
+     * Create a new order
+     */
+    createOrder(checkoutSessionId: string): Promise<{
+        success: boolean;
+        order?: Order;
+        error?: string;
+    }>;
+    /**
+     * Update order status
+     */
+    updateOrderStatus(orderId: string, status: string): Promise<{
+        success: boolean;
+        error?: string;
+    }>;
+    /**
+     * Add items to an order
+     */
+    addOrderItems(orderId: string, items: Omit<OrderLineItem, 'id'>[]): Promise<{
+        success: boolean;
+        error?: string;
+    }>;
+    /**
+     * Get order line items
+     */
+    getOrderLineItems(orderId: string): Promise<OrderLineItem[]>;
+}

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

@@ -0,0 +1,59 @@
+/**
+ * Orders Resource Client
+ * Axios-based API client for order endpoints
+ */
+export class OrdersResource {
+    constructor(apiClient) {
+        this.apiClient = apiClient;
+    }
+    /**
+     * Fetch order by ID
+     */
+    async getOrder(orderId) {
+        const response = await this.apiClient.get(`/api/v1/orders/${orderId}`);
+        // Handle both response formats: { success, order } and { order }
+        if (typeof response === 'object' && response !== null && 'success' in response && response.success === false) {
+            throw new Error(response.error || 'Failed to fetch order');
+        }
+        // If response has success property, use response.order
+        // Otherwise, assume the response itself is the order data or has order property
+        const orderData = typeof response === 'object' && response !== null && 'order' in response
+            ? response.order
+            : response;
+        if (!orderData) {
+            throw new Error('Order not found');
+        }
+        return orderData;
+    }
+    /**
+     * Create a new order
+     */
+    async createOrder(checkoutSessionId) {
+        return this.apiClient.post('/api/v1/orders', {
+            checkoutSessionId,
+        });
+    }
+    /**
+     * Update order status
+     */
+    async updateOrderStatus(orderId, status) {
+        return this.apiClient.patch(`/api/v1/orders/${orderId}/status`, {
+            status,
+        });
+    }
+    /**
+     * Add items to an order
+     */
+    async addOrderItems(orderId, items) {
+        return this.apiClient.post(`/api/v1/orders/${orderId}/items`, {
+            items,
+        });
+    }
+    /**
+     * Get order line items
+     */
+    async getOrderLineItems(orderId) {
+        const order = await this.getOrder(orderId);
+        return order.items || [];
+    }
+}