@tagadapay/plugin-sdk 2.6.14 → 2.6.16

package/dist/v2/index.d.ts

@@ -21,5 +21,5 @@ 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, useVipOffers } from './react';
-export type { StoreDiscount } from './react';
+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';

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, useVipOffers } from './react';
+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';

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

@@ -0,0 +1,46 @@
+import { LanguageCode } from '../../../data/languages';
+export type TranslationText = {
+    [key in LanguageCode | string]?: string;
+};
+export interface UseTranslationOptions {
+    defaultLanguage?: string;
+}
+export type TranslateFunction = (text: TranslationText | string | undefined, fallback?: string, languageCode?: string) => string;
+export interface UseTranslationResult {
+    /**
+     * Translate function that handles multi-language text objects
+     * @param text - The text to translate (can be a string or MultiLangText object)
+     * @param fallback - Optional fallback text if translation is not found
+     * @param languageCode - Optional language code to override the current locale
+     * @returns The translated string
+     */
+    t: TranslateFunction;
+    /**
+     * Current locale code (e.g., 'en', 'fr', 'es')
+     */
+    locale: string;
+}
+/**
+ * Hook for translating multi-language text objects
+ *
+ * @example
+ * ```tsx
+ * const { t, locale } = useTranslation({ defaultLanguage: 'en' });
+ *
+ * const multiLangText = {
+ *   en: 'Hello',
+ *   fr: 'Bonjour',
+ *   es: 'Hola'
+ * };
+ *
+ * // Translates to current locale
+ * const translated = t(multiLangText);
+ *
+ * // With fallback
+ * const withFallback = t(multiLangText, 'Default text');
+ *
+ * // Override locale
+ * const inFrench = t(multiLangText, '', 'fr');
+ * ```
+ */
+export declare const useTranslation: (options?: UseTranslationOptions) => UseTranslationResult;

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

@@ -0,0 +1,61 @@
+import { useCallback, useMemo } from 'react';
+/**
+ * Hook for translating multi-language text objects
+ *
+ * @example
+ * ```tsx
+ * const { t, locale } = useTranslation({ defaultLanguage: 'en' });
+ *
+ * const multiLangText = {
+ *   en: 'Hello',
+ *   fr: 'Bonjour',
+ *   es: 'Hola'
+ * };
+ *
+ * // Translates to current locale
+ * const translated = t(multiLangText);
+ *
+ * // With fallback
+ * const withFallback = t(multiLangText, 'Default text');
+ *
+ * // Override locale
+ * const inFrench = t(multiLangText, '', 'fr');
+ * ```
+ */
+export const useTranslation = (options = {}) => {
+    const { defaultLanguage = 'en' } = options;
+    // Get the current language from query params, browser, or fallback to default
+    const locale = useMemo(() => {
+        // Check for language query parameter
+        if (typeof window !== 'undefined') {
+            const urlParams = new URLSearchParams(window.location.search);
+            const langFromQuery = urlParams.get('language');
+            if (langFromQuery)
+                return langFromQuery;
+        }
+        // Try to get browser language
+        if (typeof navigator !== 'undefined') {
+            const browserLang = navigator.language.split('-')[0]; // e.g., 'en-US' -> 'en'
+            return browserLang;
+        }
+        return defaultLanguage;
+    }, [defaultLanguage]);
+    const t = useCallback((text, fallback, languageCode) => {
+        if (!text)
+            return fallback || '';
+        if (typeof text === 'string')
+            return text;
+        const targetLocale = languageCode || locale;
+        if (text[targetLocale])
+            return text[targetLocale];
+        if (fallback)
+            return fallback;
+        if (text[defaultLanguage])
+            return text[defaultLanguage];
+        const firstAvailable = Object.values(text).find((value) => value !== undefined && value !== '');
+        if (firstAvailable)
+            return firstAvailable;
+        return '';
+    }, [locale, defaultLanguage]);
+    return { t, locale };
+};

package/dist/v2/react/index.d.ts

@@ -12,6 +12,7 @@ export { useGeoLocation } from './hooks/useGeoLocation';
 export { useGoogleAutocomplete } from './hooks/useGoogleAutocomplete';
 export { getAvailableLanguages, useCountryOptions, useISOData, useLanguageImport, useRegionOptions } from './hooks/useISOData';
 export { usePluginConfig } from './hooks/usePluginConfig';
+export { useTranslation } from './hooks/useTranslation';
 export { queryKeys, useApiMutation, useApiQuery, useInvalidateQuery, usePreloadQuery } from './hooks/useApiQuery';
 export { useCheckoutQuery as useCheckout } from './hooks/useCheckoutQuery';
 export { useCurrency } from './hooks/useCurrency';
@@ -38,6 +39,7 @@ export type { GeoLocationData, UseGeoLocationOptions, UseGeoLocationReturn } fro
 export type { ExtractedAddress, GooglePlaceDetails, GooglePrediction, UseGoogleAutocompleteOptions, UseGoogleAutocompleteResult } from './hooks/useGoogleAutocomplete';
 export type { ISOCountry, ISORegion, UseISODataResult } from './hooks/useISOData';
 export type { UsePluginConfigOptions, UsePluginConfigResult } from './hooks/usePluginConfig';
+export type { TranslateFunction, TranslationText, UseTranslationOptions, UseTranslationResult } from './hooks/useTranslation';
 export type { UseCheckoutQueryOptions as UseCheckoutOptions, UseCheckoutQueryResult as UseCheckoutResult } from './hooks/useCheckoutQuery';
 export type { StoreDiscount, UseDiscountQueryOptions as UseDiscountOptions, UseDiscountQueryResult as UseDiscountResult } from './hooks/useDiscountQuery';
 export type { UseDiscountsQueryOptions as UseDiscountsOptions, UseDiscountsQueryResult as UseDiscountsResult } from './hooks/useDiscountsQuery';

package/dist/v2/react/index.js

@@ -15,6 +15,7 @@ export { useGeoLocation } from './hooks/useGeoLocation';
 export { useGoogleAutocomplete } from './hooks/useGoogleAutocomplete';
 export { getAvailableLanguages, useCountryOptions, useISOData, useLanguageImport, useRegionOptions } from './hooks/useISOData';
 export { usePluginConfig } from './hooks/usePluginConfig';
+export { useTranslation } from './hooks/useTranslation';
 // TanStack Query hooks (recommended)
 export { queryKeys, useApiMutation, useApiQuery, useInvalidateQuery, usePreloadQuery } from './hooks/useApiQuery';
 export { useCheckoutQuery as useCheckout } from './hooks/useCheckoutQuery';

package/package.json

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