@tagadapay/plugin-sdk 2.6.18 → 2.7.2

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

@@ -0,0 +1,21 @@
+/**
+ * Credits Resource Client
+ * Handles credits-related API operations
+ */
+export class CreditsResource {
+    constructor(apiClient) {
+        this.apiClient = apiClient;
+    }
+    /**
+     * Get customer credit balance and transaction history
+     */
+    async getCustomerCredits(customerId, storeId) {
+        return this.apiClient.get(`/api/v1/credits/balance/${customerId}/${storeId}`);
+    }
+    /**
+     * Redeem a product using credits
+     */
+    async redeemProduct(data) {
+        return this.apiClient.post('/api/v1/credits/redeem', data);
+    }
+}

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,18 @@
  */
 export * from './apiClient';
 export * from './checkout';
+export * from './credits';
+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,18 @@
  */
 export * from './apiClient';
 export * from './checkout';
+export * from './credits';
+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/core/utils/pluginConfig.d.ts

@@ -27,6 +27,20 @@ export type RawPluginConfig<TConfig = Record<string, any>> = {
  * Handles local dev, production, and raw config
  */
 export declare const loadPluginConfig: (configVariant?: string, rawConfig?: RawPluginConfig) => Promise<PluginConfig>;
+/**
+ * Helper to load local config file for development (from /config directory)
+ * Returns the config object that can be passed to TagadaProvider
+ */
+export declare function loadLocalConfig(configName?: string): Promise<Record<string, unknown> | null>;
+export interface CreateRawPluginConfigOptions {
+    config?: any;
+}
+/**
+ * Creates a RawPluginConfig object from provided options
+ * @param options - Configuration options including storeId, accountId, basePath, configName, or a direct config object
+ * @returns A RawPluginConfig object or undefined if required fields are missing
+ */
+export declare function createRawPluginConfig(options?: CreateRawPluginConfigOptions): Promise<RawPluginConfig | undefined>;
 export declare class PluginConfigUtils {
     /**
      * Get plugin configuration from various sources

package/dist/v2/core/utils/pluginConfig.js

@@ -88,33 +88,16 @@ const getMetaContent = (name) => {
     return metaTag?.getAttribute('content') || undefined;
 };
 /**
- * Load production config from headers and meta tags
+ * Load production config from meta tags
+ * Meta tags are injected by the plugin middleware during HTML serving
+ * This avoids making an additional HEAD request (~300ms savings)
  */
 const loadProductionConfig = async () => {
     try {
-        // Try to get headers first
-        let storeId;
-        let accountId;
-        let basePath;
-        try {
-            const response = await fetch(window.location.href, { method: 'HEAD' });
-            storeId = response.headers.get('X-Plugin-Store-Id') || undefined;
-            accountId = response.headers.get('X-Plugin-Account-Id') || undefined;
-            basePath = response.headers.get('X-Plugin-Base-Path') || undefined;
-        }
-        catch {
-            // Headers fetch failed, will fallback to meta tags
-        }
-        // Fallback to meta tags if headers are not available
-        if (!storeId) {
-            storeId = getMetaContent('x-plugin-store-id');
-        }
-        if (!accountId) {
-            accountId = getMetaContent('x-plugin-account-id');
-        }
-        if (!basePath) {
-            basePath = getMetaContent('x-plugin-base-path') || '/';
-        }
+        // Read store/account info from meta tags (injected by middleware)
+        const storeId = getMetaContent('x-plugin-store-id');
+        const accountId = getMetaContent('x-plugin-account-id');
+        const basePath = getMetaContent('x-plugin-base-path') || '/';
         // Get deployment config from meta tags
         let config = {};
         try {
@@ -129,17 +112,22 @@ const loadProductionConfig = async () => {
         }
         // Final validation and warnings
         if (!storeId) {
-            console.warn('⚠️ Plugin config: Store ID not found in headers or meta tags');
+            console.warn('⚠️ Plugin config: Store ID not found in meta tags');
         }
         if (!accountId) {
-            console.warn('⚠️ Plugin config: Account ID not found in headers or meta tags');
+            console.warn('⚠️ Plugin config: Account ID not found in meta tags');
         }
-        const result = { storeId, accountId, basePath: basePath || '/', config };
-        console.log('🏭 Using production plugin config:', result);
+        const result = { storeId, accountId, basePath, config };
+        console.log('🚀 Plugin config loaded from meta tags (no HEAD request needed):', {
+            storeId,
+            accountId,
+            basePath,
+            configKeys: Object.keys(config)
+        });
         return result;
     }
     catch (error) {
-        console.warn('Failed to load production config, using defaults:', error);
+        console.warn('⚠️ Failed to load production config from meta tags, using defaults:', error);
         return { basePath: '/', config: {} };
     }
 };
@@ -166,6 +154,85 @@ export const loadPluginConfig = async (configVariant = 'default', rawConfig) =>
     // Fall back to production config
     return loadProductionConfig();
 };
+/**
+ * Helper to load local config file for development (from /config directory)
+ * Returns the config object that can be passed to TagadaProvider
+ */
+export async function loadLocalConfig(configName = 'default') {
+    try {
+        // Only load in localhost
+        const isLocalhost = typeof window !== 'undefined' &&
+            (window.location.hostname === 'localhost' ||
+                window.location.hostname.includes('.localhost') ||
+                window.location.hostname.includes('127.0.0.1'));
+        if (!isLocalhost) {
+            return null;
+        }
+        // Try .tgd.json first, then .json, then .config.json
+        const possiblePaths = [
+            `/config/${configName}.tgd.json`,
+            `/config/${configName}.json`,
+            `/config/${configName}.config.json`,
+        ];
+        for (const path of possiblePaths) {
+            try {
+                const response = await fetch(path);
+                if (response.ok) {
+                    const config = await response.json();
+                    console.log(`✅ [loadLocalConfig] Loaded config from ${path}:`, {
+                        configName: config.configName,
+                        hasBranding: !!config.branding,
+                    });
+                    return config;
+                }
+            }
+            catch {
+                continue;
+            }
+        }
+        console.warn(`⚠️ [loadLocalConfig] No config found for '${configName}'`);
+        return null;
+    }
+    catch (error) {
+        console.error('[loadLocalConfig] Error loading config:', error);
+        return null;
+    }
+}
+/**
+ * Creates a RawPluginConfig object from provided options
+ * @param options - Configuration options including storeId, accountId, basePath, configName, or a direct config object
+ * @returns A RawPluginConfig object or undefined if required fields are missing
+ */
+export async function createRawPluginConfig(options) {
+    try {
+        const storeId = process.env.TAGADA_STORE_ID;
+        const accountId = process.env.TAGADA_ACCOUNT_ID;
+        const basePath = process.env.TAGADA_BASE_PATH;
+        const configName = process.env.TAGADA_CONFIG_NAME;
+        if (storeId) {
+            console.warn('[createRawPluginConfig] No storeId provided');
+            return undefined;
+        }
+        const resolvedConfig = options?.config ?? await loadLocalConfig(configName);
+        const rawConfig = {
+            storeId: storeId,
+            accountId: accountId,
+            basePath: basePath || '/',
+            config: resolvedConfig,
+        };
+        console.log('[createRawPluginConfig] Created raw plugin config:', {
+            hasStoreId: !!rawConfig.storeId,
+            hasAccountId: !!rawConfig.accountId,
+            basePath: rawConfig.basePath,
+            hasConfig: !!rawConfig.config,
+        });
+        return rawConfig;
+    }
+    catch (error) {
+        console.error('[createRawPluginConfig] Error creating config:', error);
+        return undefined;
+    }
+}
 export class PluginConfigUtils {
     /**
      * Get plugin configuration from various sources

package/dist/v2/index.d.ts

@@ -10,6 +10,7 @@ export * from './core/isoData';
 export * from './core/utils/currency';
 export * from './core/utils/pluginConfig';
 export * from './core/utils/products';
+export * from './core/pathRemapping';
 export type { CheckoutData, CheckoutInitParams, CheckoutLineItem, CheckoutSession, Promotion } from './core/resources/checkout';
 export type { Order, OrderLineItem } from './core/utils/order';
 export type { PostPurchaseOffer, PostPurchaseOfferItem, PostPurchaseOfferSummary } from './core/resources/postPurchases';
@@ -20,5 +21,13 @@ export type { ShippingRate, ShippingRatesResponse } from './core/resources/shipp
 export type { ApplyDiscountResponse, Discount, DiscountCodeValidation, RemoveDiscountResponse } from './core/resources/discounts';
 export type { ToggleOrderBumpResponse, VipOffer, VipPreviewResponse } from './core/resources/vipOffers';
 export type { StoreConfig } from './core/resources/storeConfig';
-export type { FunnelEvent, FunnelNavigationAction, FunnelNavigationResult, SimpleFunnelContext, FunnelInitializeRequest, FunnelInitializeResponse, FunnelNavigateRequest, FunnelNavigateResponse, FunnelContextUpdateRequest, FunnelContextUpdateResponse } from './core/resources/funnel';
-export { ApplePayButton, ExpressPaymentMethodsProvider, formatMoney, getAvailableLanguages, GooglePayButton, queryKeys, TagadaProvider, useApiMutation, useApiQuery, useCheckout, useCheckoutToken, useCountryOptions, useCurrency, useDiscounts, useExpressPaymentMethods, useGeoLocation, useGoogleAutocomplete, useInvalidateQuery, useISOData, useLanguageImport, useOffers, useOrder, useOrderBump, usePayment, usePluginConfig, usePostPurchases, usePreloadQuery, useProducts, usePromotions, useRegionOptions, useShippingRates, useStoreConfig, useTagadaContext, useThreeds, useThreedsModal, useVipOffers, useFunnel, useSimpleFunnel } from './react';
+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, 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

@@ -11,5 +11,7 @@ export * from './core/isoData';
 export * from './core/utils/currency';
 export * from './core/utils/pluginConfig';
 export * from './core/utils/products';
+// Path remapping helpers (framework-agnostic)
+export * from './core/pathRemapping';
 // React exports (hooks and components only, types are exported above)
-export { ApplePayButton, ExpressPaymentMethodsProvider, formatMoney, getAvailableLanguages, GooglePayButton, queryKeys, TagadaProvider, useApiMutation, useApiQuery, useCheckout, useCheckoutToken, useCountryOptions, useCurrency, useDiscounts, useExpressPaymentMethods, useGeoLocation, useGoogleAutocomplete, useInvalidateQuery, useISOData, useLanguageImport, useOffers, useOrder, useOrderBump, usePayment, usePluginConfig, usePostPurchases, usePreloadQuery, useProducts, usePromotions, useRegionOptions, useShippingRates, useStoreConfig, useTagadaContext, useThreeds, useThreedsModal, useVipOffers, useFunnel, useSimpleFunnel } 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,
+    };
+}