@tagadapay/plugin-sdk 2.6.6 → 2.6.8

package/README.md

@@ -15,6 +15,7 @@ A comprehensive React SDK for building plugins on the TagadaPay platform. Create
 - **[useCheckout (V2)](#usecheckout)** - TanStack Query-based checkout management
 - **[useOffers (V2)](#useoffers)** - Dynamic pricing with automatic caching
 - **[useProducts (V2)](#useproducts)** - Product data management
+- **[useStoreConfig (V2)](#usestoreconfig)** - Store configuration with automatic caching
 - **[usePayment (V2)](#usepayment)** - Payment processing with 3DS support
 - **[V2 Utility Functions](#v2-utility-functions--advanced-features)** - Enhanced utilities and TanStack Query integration
 
@@ -708,6 +709,44 @@ const {
 } = useProducts({ storeId, enabled });
 ```
 
+#### useStoreConfig()
+
+Hook for fetching store configuration with automatic caching.
+
+```typescript
+const {
+  // Query data
+  storeConfig, // StoreConfig | undefined
+  isLoading, // boolean
+  error, // Error | null
+  isSuccess, // boolean
+
+  // Actions
+  refetch, // () => Promise<void>
+} = useStoreConfig({ storeId, enabled });
+```
+
+**Example:**
+
+```tsx
+import { useStoreConfig } from '@tagadapay/plugin-sdk/v2';
+
+function StoreInfo() {
+  const { storeConfig, isLoading } = useStoreConfig();
+
+  if (isLoading) return <div>Loading...</div>;
+
+  return (
+    <div>
+      <h1>{storeConfig?.storeName}</h1>
+      <p>Currency: {storeConfig?.currency}</p>
+    </div>
+  );
+}
+```
+
+See [useStoreConfig documentation](./docs/README-useStoreConfig.md) for more details.
+
 #### useOrder()
 
 Hook for order management and tracking.

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

@@ -12,5 +12,6 @@ export * from './postPurchases';
 export * from './products';
 export * from './promotions';
 export * from './shippingRates';
+export * from './storeConfig';
 export * from './threeds';
 export * from './vipOffers';

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

@@ -12,5 +12,6 @@ export * from './postPurchases';
 export * from './products';
 export * from './promotions';
 export * from './shippingRates';
+export * from './storeConfig';
 export * from './threeds';
 export * from './vipOffers';

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

@@ -0,0 +1,25 @@
+/**
+ * Store Config Resource Client
+ * Axios-based API client for store configuration endpoints
+ */
+import { ApiClient } from './apiClient';
+export interface StoreConfig {
+    storeId: string;
+    storeName?: string;
+    storeUrl?: string;
+    currency?: string;
+    locale?: string;
+    timezone?: string;
+    [key: string]: any;
+}
+export interface GetStoreConfigOptions {
+    storeId: string;
+}
+export declare class StoreConfigResource {
+    private apiClient;
+    constructor(apiClient: ApiClient);
+    /**
+     * Get store configuration by store ID
+     */
+    getStoreConfig(storeId: string): Promise<StoreConfig>;
+}

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

@@ -0,0 +1,16 @@
+/**
+ * Store Config Resource Client
+ * Axios-based API client for store configuration endpoints
+ */
+export class StoreConfigResource {
+    constructor(apiClient) {
+        this.apiClient = apiClient;
+    }
+    /**
+     * Get store configuration by store ID
+     */
+    async getStoreConfig(storeId) {
+        const response = await this.apiClient.get(`/api/v1/checkout/config?storeId=${storeId}`);
+        return response;
+    }
+}

package/dist/v2/index.d.ts

@@ -19,4 +19,5 @@ export type { ApplePayToken, CardPaymentMethod, Payment, PaymentInstrumentCustom
 export type { ShippingRate, ShippingRatesResponse } from './core/resources/shippingRates';
 export type { ApplyDiscountResponse, Discount, DiscountCodeValidation, RemoveDiscountResponse } from './core/resources/discounts';
 export type { ToggleOrderBumpResponse, VipOffer, VipPreviewResponse } from './core/resources/vipOffers';
-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, useTagadaContext, useThreeds, useThreedsModal, useVipOffers } from './react';
+export type { StoreConfig } from './core/resources/storeConfig';
+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 } 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, useDiscounts, useExpressPaymentMethods, useGeoLocation, useGoogleAutocomplete, useInvalidateQuery, useISOData, useLanguageImport, useOffers, useOrder, useOrderBump, usePayment, usePluginConfig, usePostPurchases, usePreloadQuery, useProducts, usePromotions, useRegionOptions, useShippingRates, useTagadaContext, useThreeds, useThreedsModal, useVipOffers } from './react';
+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 } from './react';

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

@@ -16,6 +16,7 @@ export declare const queryKeys: {
     readonly vipPreview: (sessionId: string, offerIds: string[]) => (string | string[])[];
     readonly products: (productIds: string[], options?: Record<string, any>) => (string | string[] | Record<string, any> | undefined)[];
     readonly store: (storeId: string) => string[];
+    readonly storeConfig: (storeId: string) => string[];
     readonly order: (orderId: string) => string[];
 };
 export declare function useApiQuery<T = unknown>(key: readonly unknown[], url: string | null, options?: Omit<UseQueryOptions<T>, 'queryKey' | 'queryFn'>): import("@tanstack/react-query").UseQueryResult<import("@tanstack/react-query").NoInfer<T>, Error>;

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

@@ -27,6 +27,7 @@ export const queryKeys = {
     vipPreview: (sessionId, offerIds) => ['vip-preview', sessionId, offerIds],
     products: (productIds, options) => ['products', productIds, options],
     store: (storeId) => ['store', storeId],
+    storeConfig: (storeId) => ['storeConfig', storeId],
     order: (orderId) => ['order', orderId],
 };
 // Main query hook

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

@@ -0,0 +1,17 @@
+/**
+ * Store Config Hook using TanStack Query
+ * Fetches store configuration with automatic caching
+ */
+import { StoreConfig } from '../../core/resources/storeConfig';
+export interface UseStoreConfigQueryOptions {
+    storeId?: string;
+    enabled?: boolean;
+}
+export interface UseStoreConfigQueryResult {
+    storeConfig: StoreConfig | undefined;
+    isLoading: boolean;
+    error: Error | null;
+    isSuccess: boolean;
+    refetch: () => Promise<void>;
+}
+export declare function useStoreConfigQuery(options?: UseStoreConfigQueryOptions): UseStoreConfigQueryResult;

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

@@ -0,0 +1,52 @@
+/**
+ * Store Config Hook using TanStack Query
+ * Fetches store configuration with automatic caching
+ */
+import { useQuery } from '@tanstack/react-query';
+import { useCallback, useMemo } from 'react';
+import { StoreConfigResource } from '../../core/resources/storeConfig';
+import { useTagadaContext } from '../providers/TagadaProvider';
+import { getGlobalApiClient } from './useApiQuery';
+import { usePluginConfig } from './usePluginConfig';
+export function useStoreConfigQuery(options = {}) {
+    const { storeId: providedStoreId, enabled = true } = options;
+    const { storeId: contextStoreId } = usePluginConfig();
+    const { isSessionInitialized } = useTagadaContext();
+    // Use provided storeId or fall back to context storeId
+    const storeId = providedStoreId || contextStoreId;
+    // Create store config resource client
+    const storeConfigResource = useMemo(() => {
+        try {
+            return new StoreConfigResource(getGlobalApiClient());
+        }
+        catch (error) {
+            throw new Error('Failed to initialize store config resource: ' + (error instanceof Error ? error.message : 'Unknown error'));
+        }
+    }, []);
+    // Use TanStack Query for fetching store config
+    const { data: storeConfig, isLoading, error, isSuccess, refetch } = useQuery({
+        queryKey: ['storeConfig', storeId],
+        enabled: enabled && !!storeId && isSessionInitialized,
+        queryFn: async () => {
+            if (!storeId) {
+                throw new Error('Store ID not found. Make sure the TagadaProvider is properly configured.');
+            }
+            return await storeConfigResource.getStoreConfig(storeId);
+        },
+        staleTime: 5 * 60 * 1000, // 5 minutes - config doesn't change often
+        gcTime: 10 * 60 * 1000, // 10 minutes cache time
+    });
+    // Refetch function
+    const refetchConfig = useCallback(async () => {
+        await refetch();
+    }, [refetch]);
+    return {
+        // Query data
+        storeConfig,
+        isLoading,
+        error,
+        isSuccess,
+        // Actions
+        refetch: refetchConfig,
+    };
+}

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

@@ -24,6 +24,7 @@ export { usePostPurchasesQuery as usePostPurchases } from './hooks/usePostPurcha
 export { useProductsQuery as useProducts } from './hooks/useProductsQuery';
 export { usePromotionsQuery as usePromotions } from './hooks/usePromotionsQuery';
 export { useShippingRatesQuery as useShippingRates } from './hooks/useShippingRatesQuery';
+export { useStoreConfigQuery as useStoreConfig } from './hooks/useStoreConfigQuery';
 export { useThreeds } from './hooks/useThreeds';
 export { useThreedsModal } from './hooks/useThreedsModal';
 export { useVipOffersQuery as useVipOffers } from './hooks/useVipOffersQuery';
@@ -45,6 +46,7 @@ export type { UsePostPurchasesQueryOptions as UsePostPurchasesOptions, UsePostPu
 export type { UseProductsQueryOptions as UseProductsOptions, UseProductsQueryResult as UseProductsResult } from './hooks/useProductsQuery';
 export type { UsePromotionsQueryOptions as UsePromotionsOptions, UsePromotionsQueryResult as UsePromotionsResult } from './hooks/usePromotionsQuery';
 export type { UseShippingRatesQueryOptions as UseShippingRatesOptions, UseShippingRatesQueryResult as UseShippingRatesResult } from './hooks/useShippingRatesQuery';
+export type { UseStoreConfigQueryOptions as UseStoreConfigOptions, UseStoreConfigQueryResult as UseStoreConfigResult } from './hooks/useStoreConfigQuery';
 export type { PaymentInstrument, ThreedsChallenge, ThreedsHook, ThreedsOptions, ThreedsProvider, ThreedsSession } from './hooks/useThreeds';
 export type { UseVipOffersQueryOptions as UseVipOffersOptions, UseVipOffersQueryResult as UseVipOffersResult } from './hooks/useVipOffersQuery';
 export { formatMoney } from '../../react/utils/money';

package/dist/v2/react/index.js

@@ -28,6 +28,7 @@ export { usePostPurchasesQuery as usePostPurchases } from './hooks/usePostPurcha
 export { useProductsQuery as useProducts } from './hooks/useProductsQuery';
 export { usePromotionsQuery as usePromotions } from './hooks/usePromotionsQuery';
 export { useShippingRatesQuery as useShippingRates } from './hooks/useShippingRatesQuery';
+export { useStoreConfigQuery as useStoreConfig } from './hooks/useStoreConfigQuery';
 export { useThreeds } from './hooks/useThreeds';
 export { useThreedsModal } from './hooks/useThreedsModal';
 export { useVipOffersQuery as useVipOffers } from './hooks/useVipOffersQuery';

package/package.json

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