@behio/storefront-sdk 0.1.0

package/dist/react.d.mts

@@ -0,0 +1,166 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as _tanstack_react_query from '@tanstack/react-query';
+import { QueryClient } from '@tanstack/react-query';
+import { BehioStorefront, ProductsQuery, PaginatedResponse, ProductListItem, ProductDetail, Category, ProductLabel, FilterField, Cart, CustomerProfile, RegisterInput, CustomerAddress, OrderListItem, OrderDetail, CheckoutInput, PageDetail, Page, ShopInfo } from './index.mjs';
+export { AddToCartInput, AuthTokens, BehioApiError, CartDiscount, CartItem, CategoryDetail, CheckoutAddress, FulfillmentStatus, LoginInput, MessageResponse, OrderItem, OrderStatus, PaymentStatus, ProductPrice, ProductVariant } from './index.mjs';
+
+interface StorageAdapter {
+    get(key: string): string | null;
+    set(key: string, value: string): void;
+    remove(key: string): void;
+}
+declare const cookieStorage: StorageAdapter;
+declare const localStorageAdapter: StorageAdapter;
+declare function createMemoryStorage(): StorageAdapter;
+declare const memoryStorage: StorageAdapter;
+declare function detectStorage(): StorageAdapter;
+
+interface BehioProviderProps {
+    apiKey: string;
+    baseUrl?: string;
+    locale?: string;
+    currency?: string;
+    storage?: "cookies" | "localStorage" | "memory" | StorageAdapter;
+    queryClient?: QueryClient;
+    children: React.ReactNode;
+}
+declare function BehioProvider({ apiKey, baseUrl, locale, currency, storage: storageOption, queryClient: externalQueryClient, children, }: BehioProviderProps): react_jsx_runtime.JSX.Element;
+
+interface BehioContextValue {
+    client: BehioStorefront;
+    storage: StorageAdapter;
+}
+declare function useBehio(): BehioContextValue;
+
+interface UseProductsOptions extends ProductsQuery {
+    initialData?: PaginatedResponse<ProductListItem>;
+    enabled?: boolean;
+}
+declare function useProducts(query?: UseProductsOptions): _tanstack_react_query.UseQueryResult<PaginatedResponse<ProductListItem>, Error>;
+
+interface UseProductOptions {
+    locale?: string;
+    currency?: string;
+    initialData?: ProductDetail;
+    enabled?: boolean;
+}
+declare function useProduct(slug: string, options?: UseProductOptions): _tanstack_react_query.UseQueryResult<ProductDetail, Error>;
+
+declare function useCategories(locale?: string): _tanstack_react_query.UseQueryResult<Category[], Error>;
+
+declare function useLabels(locale?: string): _tanstack_react_query.UseQueryResult<ProductLabel[], Error>;
+
+interface UseFeaturedOptions {
+    locale?: string;
+    currency?: string;
+    initialData?: PaginatedResponse<ProductListItem>;
+    enabled?: boolean;
+}
+declare function useFeatured(options?: UseFeaturedOptions): _tanstack_react_query.UseQueryResult<PaginatedResponse<ProductListItem>, Error>;
+
+declare function useFilters(): _tanstack_react_query.UseQueryResult<FilterField[], Error>;
+
+interface UseSearchOptions {
+    page?: number;
+    limit?: number;
+    debounceMs?: number;
+    enabled?: boolean;
+}
+declare function useSearch(query: string, options?: UseSearchOptions): _tanstack_react_query.UseQueryResult<PaginatedResponse<ProductListItem>, Error>;
+
+declare function useCart(): {
+    cart: Cart | null;
+    isLoading: boolean;
+    error: Error | null;
+    addItem: (productId: string, quantity?: number) => Promise<Cart & {
+        newSessionToken?: string;
+    }>;
+    updateQuantity: (itemId: string, quantity: number) => Promise<Cart>;
+    removeItem: (itemId: string) => Promise<Cart>;
+    clear: () => Promise<void>;
+    applyDiscount: (code: string) => Promise<Cart>;
+    removeDiscount: () => Promise<Cart>;
+    merge: () => Promise<Cart>;
+    itemCount: number;
+    isEmpty: boolean;
+    isAdding: boolean;
+    isUpdating: boolean;
+    isRemoving: boolean;
+};
+
+declare function useCartCount(): number;
+
+declare function useAuth(): {
+    isLoggedIn: boolean;
+    customer: CustomerProfile | null;
+    isLoading: boolean;
+    login: (email: string, password: string) => Promise<undefined>;
+    register: (input: RegisterInput) => Promise<undefined>;
+    logout: () => Promise<undefined>;
+    forgotPassword: (email: string) => Promise<undefined>;
+    resetPassword: (token: string, newPassword: string) => Promise<undefined>;
+    verifyEmail: (token: string) => Promise<undefined>;
+    isLoggingIn: boolean;
+    isRegistering: boolean;
+    loginError: Error | null;
+    registerError: Error | null;
+};
+
+declare function useCustomer(): {
+    data: CustomerProfile | null;
+    isLoading: boolean;
+    error: Error | null;
+    updateProfile: (profileData: Partial<Pick<CustomerProfile, "firstName" | "lastName" | "phone">>) => Promise<CustomerProfile>;
+    isUpdating: boolean;
+};
+
+declare function useAddresses(): {
+    addresses: CustomerAddress[];
+    isLoading: boolean;
+    error: Error | null;
+    createAddress: (address: Omit<CustomerAddress, "id">) => Promise<CustomerAddress>;
+    updateAddress: (addressId: string, addressData: Partial<CustomerAddress>) => Promise<CustomerAddress>;
+    deleteAddress: (addressId: string) => Promise<void>;
+    isCreating: boolean;
+    isDeleting: boolean;
+};
+
+interface UseOrdersOptions {
+    page?: number;
+    limit?: number;
+    enabled?: boolean;
+}
+declare function useOrders(options?: UseOrdersOptions): _tanstack_react_query.UseQueryResult<PaginatedResponse<OrderListItem>, Error>;
+
+declare function useOrder(orderNumber: string): {
+    data: OrderDetail | null;
+    isLoading: boolean;
+    error: Error | null;
+    cancel: () => Promise<OrderDetail>;
+    isCancelling: boolean;
+};
+
+declare function useCheckout(): {
+    createOrder: (input: CheckoutInput) => Promise<OrderDetail>;
+    isCreating: boolean;
+    error: Error | null;
+    order: OrderDetail | null;
+    reset: () => void;
+};
+
+declare function usePages(locale?: string): _tanstack_react_query.UseQueryResult<Page[], Error>;
+declare function usePage(slug: string, locale?: string): _tanstack_react_query.UseQueryResult<PageDetail, Error>;
+
+declare function useShopInfo(): _tanstack_react_query.UseQueryResult<ShopInfo, Error>;
+
+/**
+ * Format a price amount with currency using Intl.NumberFormat.
+ *
+ * @param amount - The price amount (e.g. 1499, 24.99)
+ * @param currency - ISO 4217 currency code (e.g. "CZK", "EUR", "USD")
+ * @param locale - BCP 47 locale string (e.g. "cs", "en", "de"). Defaults to "cs".
+ * @returns Formatted price string (e.g. "1 499 Kč", "24,99 €")
+ */
+declare function formatPrice(amount: number, currency: string, locale?: string): string;
+
+export { BehioProvider, type BehioProviderProps, Cart, Category, CheckoutInput, CustomerAddress, CustomerProfile, FilterField, OrderDetail, OrderListItem, Page, PageDetail, PaginatedResponse, ProductDetail, ProductLabel, ProductListItem, ProductsQuery, RegisterInput, ShopInfo, type StorageAdapter, type UseFeaturedOptions, type UseOrdersOptions, type UseProductOptions, type UseProductsOptions, type UseSearchOptions, cookieStorage, createMemoryStorage, detectStorage, formatPrice, localStorageAdapter, memoryStorage, useAddresses, useAuth, useBehio, useCart, useCartCount, useCategories, useCheckout, useCustomer, useFeatured, useFilters, useLabels, useOrder, useOrders, usePage, usePages, useProduct, useProducts, useSearch, useShopInfo };

package/dist/react.d.ts

@@ -0,0 +1,166 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as _tanstack_react_query from '@tanstack/react-query';
+import { QueryClient } from '@tanstack/react-query';
+import { BehioStorefront, ProductsQuery, PaginatedResponse, ProductListItem, ProductDetail, Category, ProductLabel, FilterField, Cart, CustomerProfile, RegisterInput, CustomerAddress, OrderListItem, OrderDetail, CheckoutInput, PageDetail, Page, ShopInfo } from './index.js';
+export { AddToCartInput, AuthTokens, BehioApiError, CartDiscount, CartItem, CategoryDetail, CheckoutAddress, FulfillmentStatus, LoginInput, MessageResponse, OrderItem, OrderStatus, PaymentStatus, ProductPrice, ProductVariant } from './index.js';
+
+interface StorageAdapter {
+    get(key: string): string | null;
+    set(key: string, value: string): void;
+    remove(key: string): void;
+}
+declare const cookieStorage: StorageAdapter;
+declare const localStorageAdapter: StorageAdapter;
+declare function createMemoryStorage(): StorageAdapter;
+declare const memoryStorage: StorageAdapter;
+declare function detectStorage(): StorageAdapter;
+
+interface BehioProviderProps {
+    apiKey: string;
+    baseUrl?: string;
+    locale?: string;
+    currency?: string;
+    storage?: "cookies" | "localStorage" | "memory" | StorageAdapter;
+    queryClient?: QueryClient;
+    children: React.ReactNode;
+}
+declare function BehioProvider({ apiKey, baseUrl, locale, currency, storage: storageOption, queryClient: externalQueryClient, children, }: BehioProviderProps): react_jsx_runtime.JSX.Element;
+
+interface BehioContextValue {
+    client: BehioStorefront;
+    storage: StorageAdapter;
+}
+declare function useBehio(): BehioContextValue;
+
+interface UseProductsOptions extends ProductsQuery {
+    initialData?: PaginatedResponse<ProductListItem>;
+    enabled?: boolean;
+}
+declare function useProducts(query?: UseProductsOptions): _tanstack_react_query.UseQueryResult<PaginatedResponse<ProductListItem>, Error>;
+
+interface UseProductOptions {
+    locale?: string;
+    currency?: string;
+    initialData?: ProductDetail;
+    enabled?: boolean;
+}
+declare function useProduct(slug: string, options?: UseProductOptions): _tanstack_react_query.UseQueryResult<ProductDetail, Error>;
+
+declare function useCategories(locale?: string): _tanstack_react_query.UseQueryResult<Category[], Error>;
+
+declare function useLabels(locale?: string): _tanstack_react_query.UseQueryResult<ProductLabel[], Error>;
+
+interface UseFeaturedOptions {
+    locale?: string;
+    currency?: string;
+    initialData?: PaginatedResponse<ProductListItem>;
+    enabled?: boolean;
+}
+declare function useFeatured(options?: UseFeaturedOptions): _tanstack_react_query.UseQueryResult<PaginatedResponse<ProductListItem>, Error>;
+
+declare function useFilters(): _tanstack_react_query.UseQueryResult<FilterField[], Error>;
+
+interface UseSearchOptions {
+    page?: number;
+    limit?: number;
+    debounceMs?: number;
+    enabled?: boolean;
+}
+declare function useSearch(query: string, options?: UseSearchOptions): _tanstack_react_query.UseQueryResult<PaginatedResponse<ProductListItem>, Error>;
+
+declare function useCart(): {
+    cart: Cart | null;
+    isLoading: boolean;
+    error: Error | null;
+    addItem: (productId: string, quantity?: number) => Promise<Cart & {
+        newSessionToken?: string;
+    }>;
+    updateQuantity: (itemId: string, quantity: number) => Promise<Cart>;
+    removeItem: (itemId: string) => Promise<Cart>;
+    clear: () => Promise<void>;
+    applyDiscount: (code: string) => Promise<Cart>;
+    removeDiscount: () => Promise<Cart>;
+    merge: () => Promise<Cart>;
+    itemCount: number;
+    isEmpty: boolean;
+    isAdding: boolean;
+    isUpdating: boolean;
+    isRemoving: boolean;
+};
+
+declare function useCartCount(): number;
+
+declare function useAuth(): {
+    isLoggedIn: boolean;
+    customer: CustomerProfile | null;
+    isLoading: boolean;
+    login: (email: string, password: string) => Promise<undefined>;
+    register: (input: RegisterInput) => Promise<undefined>;
+    logout: () => Promise<undefined>;
+    forgotPassword: (email: string) => Promise<undefined>;
+    resetPassword: (token: string, newPassword: string) => Promise<undefined>;
+    verifyEmail: (token: string) => Promise<undefined>;
+    isLoggingIn: boolean;
+    isRegistering: boolean;
+    loginError: Error | null;
+    registerError: Error | null;
+};
+
+declare function useCustomer(): {
+    data: CustomerProfile | null;
+    isLoading: boolean;
+    error: Error | null;
+    updateProfile: (profileData: Partial<Pick<CustomerProfile, "firstName" | "lastName" | "phone">>) => Promise<CustomerProfile>;
+    isUpdating: boolean;
+};
+
+declare function useAddresses(): {
+    addresses: CustomerAddress[];
+    isLoading: boolean;
+    error: Error | null;
+    createAddress: (address: Omit<CustomerAddress, "id">) => Promise<CustomerAddress>;
+    updateAddress: (addressId: string, addressData: Partial<CustomerAddress>) => Promise<CustomerAddress>;
+    deleteAddress: (addressId: string) => Promise<void>;
+    isCreating: boolean;
+    isDeleting: boolean;
+};
+
+interface UseOrdersOptions {
+    page?: number;
+    limit?: number;
+    enabled?: boolean;
+}
+declare function useOrders(options?: UseOrdersOptions): _tanstack_react_query.UseQueryResult<PaginatedResponse<OrderListItem>, Error>;
+
+declare function useOrder(orderNumber: string): {
+    data: OrderDetail | null;
+    isLoading: boolean;
+    error: Error | null;
+    cancel: () => Promise<OrderDetail>;
+    isCancelling: boolean;
+};
+
+declare function useCheckout(): {
+    createOrder: (input: CheckoutInput) => Promise<OrderDetail>;
+    isCreating: boolean;
+    error: Error | null;
+    order: OrderDetail | null;
+    reset: () => void;
+};
+
+declare function usePages(locale?: string): _tanstack_react_query.UseQueryResult<Page[], Error>;
+declare function usePage(slug: string, locale?: string): _tanstack_react_query.UseQueryResult<PageDetail, Error>;
+
+declare function useShopInfo(): _tanstack_react_query.UseQueryResult<ShopInfo, Error>;
+
+/**
+ * Format a price amount with currency using Intl.NumberFormat.
+ *
+ * @param amount - The price amount (e.g. 1499, 24.99)
+ * @param currency - ISO 4217 currency code (e.g. "CZK", "EUR", "USD")
+ * @param locale - BCP 47 locale string (e.g. "cs", "en", "de"). Defaults to "cs".
+ * @returns Formatted price string (e.g. "1 499 Kč", "24,99 €")
+ */
+declare function formatPrice(amount: number, currency: string, locale?: string): string;
+
+export { BehioProvider, type BehioProviderProps, Cart, Category, CheckoutInput, CustomerAddress, CustomerProfile, FilterField, OrderDetail, OrderListItem, Page, PageDetail, PaginatedResponse, ProductDetail, ProductLabel, ProductListItem, ProductsQuery, RegisterInput, ShopInfo, type StorageAdapter, type UseFeaturedOptions, type UseOrdersOptions, type UseProductOptions, type UseProductsOptions, type UseSearchOptions, cookieStorage, createMemoryStorage, detectStorage, formatPrice, localStorageAdapter, memoryStorage, useAddresses, useAuth, useBehio, useCart, useCartCount, useCategories, useCheckout, useCustomer, useFeatured, useFilters, useLabels, useOrder, useOrders, usePage, usePages, useProduct, useProducts, useSearch, useShopInfo };