@doswiftly/storefront-sdk 4.0.0

package/dist/react/hooks/use-cart-manager.js

@@ -0,0 +1,223 @@
+/**
+ * useCartManager — wraps CartClient with cart ID persistence + loading states.
+ *
+ * Auto-creates cart on first add. CartId persisted in cookie (SSR/edge visible).
+ * Does NOT use React Query — plain async + useState.
+ * Template wraps in useMutation() if React Query features are needed.
+ *
+ * @example
+ * ```tsx
+ * const { addItem, updateQuantity, removeItem, isLoading } = useCartManager();
+ *
+ * await addItem([{ merchandiseId: 'variant-123', quantity: 1 }]);
+ * ```
+ */
+'use client';
+import { useState, useCallback } from 'react';
+import { useStorefrontClientContext } from '../providers/storefront-client-provider';
+import { StorefrontError } from '../../core/errors';
+// ---------------------------------------------------------------------------
+// Cart ID persistence (cookie — SSR/edge visible)
+// ---------------------------------------------------------------------------
+function getCartIdFromCookie() {
+    if (typeof document === 'undefined')
+        return null;
+    const match = document.cookie.match(/(?:^|;\s*)cart-id=([^;]*)/);
+    return match ? decodeURIComponent(match[1]) : null;
+}
+function setCartIdCookie(cartId) {
+    if (typeof document === 'undefined')
+        return;
+    const maxAge = 30 * 24 * 60 * 60; // 30 days
+    document.cookie = `cart-id=${encodeURIComponent(cartId)};max-age=${maxAge};path=/;samesite=lax`;
+}
+function clearCartIdCookie() {
+    if (typeof document === 'undefined')
+        return;
+    document.cookie = 'cart-id=;max-age=0;path=/';
+}
+export function useCartManager() {
+    const { cartClient } = useStorefrontClientContext();
+    const [isLoading, setIsLoading] = useState(false);
+    const [error, setError] = useState(null);
+    /**
+     * Get existing cart ID from cookie or create a new cart.
+     */
+    const getOrCreateCartId = useCallback(async (forceNew = false) => {
+        if (!forceNew) {
+            const existing = getCartIdFromCookie();
+            if (existing)
+                return existing;
+        }
+        const cart = await cartClient.create();
+        setCartIdCookie(cart.id);
+        return cart.id;
+    }, [cartClient]);
+    /**
+     * Check if error indicates cart not found (expired).
+     */
+    const isCartExpired = (err) => {
+        if (err instanceof StorefrontError) {
+            return err.message.toLowerCase().includes('cart not found') ||
+                err.message.toLowerCase().includes('cart does not exist');
+        }
+        return false;
+    };
+    /**
+     * Fetch current cart. Returns null if no cart exists.
+     */
+    const getCart = useCallback(async () => {
+        const cartId = getCartIdFromCookie();
+        if (!cartId)
+            return null;
+        try {
+            return await cartClient.get(cartId);
+        }
+        catch (err) {
+            if (isCartExpired(err)) {
+                clearCartIdCookie();
+                return null;
+            }
+            throw err;
+        }
+    }, [cartClient]);
+    /**
+     * Add items to cart. Creates cart if needed.
+     * On expired cart, clears cookie, creates new cart, retries once.
+     */
+    const addItem = useCallback(async (lines, options) => {
+        setError(null);
+        setIsLoading(true);
+        try {
+            const cartId = await getOrCreateCartId(options?.forceNewCart);
+            const cart = await cartClient.addItems(cartId, lines);
+            return cart;
+        }
+        catch (err) {
+            if (isCartExpired(err) && !options?.forceNewCart) {
+                clearCartIdCookie();
+                return addItem(lines, { forceNewCart: true });
+            }
+            const message = err instanceof Error ? err.message : 'Failed to add to cart';
+            setError(message);
+            throw err;
+        }
+        finally {
+            setIsLoading(false);
+        }
+    }, [cartClient, getOrCreateCartId]);
+    /**
+     * Update line items (quantity, attributes).
+     */
+    const updateItem = useCallback(async (lines) => {
+        setError(null);
+        setIsLoading(true);
+        try {
+            const cartId = getCartIdFromCookie();
+            if (!cartId)
+                throw new Error('No cart found');
+            return await cartClient.updateItems(cartId, lines);
+        }
+        catch (err) {
+            if (isCartExpired(err)) {
+                clearCartIdCookie();
+            }
+            const message = err instanceof Error ? err.message : 'Failed to update cart';
+            setError(message);
+            throw err;
+        }
+        finally {
+            setIsLoading(false);
+        }
+    }, [cartClient]);
+    /**
+     * Remove items by line IDs.
+     */
+    const removeItem = useCallback(async (lineIds) => {
+        setError(null);
+        setIsLoading(true);
+        try {
+            const cartId = getCartIdFromCookie();
+            if (!cartId)
+                throw new Error('No cart found');
+            return await cartClient.removeItems(cartId, lineIds);
+        }
+        catch (err) {
+            if (isCartExpired(err)) {
+                clearCartIdCookie();
+            }
+            const message = err instanceof Error ? err.message : 'Failed to remove from cart';
+            setError(message);
+            throw err;
+        }
+        finally {
+            setIsLoading(false);
+        }
+    }, [cartClient]);
+    /**
+     * Update discount codes (replaces all existing).
+     */
+    const updateDiscountCodes = useCallback(async (codes) => {
+        setError(null);
+        setIsLoading(true);
+        try {
+            const cartId = getCartIdFromCookie();
+            if (!cartId)
+                throw new Error('No cart found');
+            return await cartClient.updateDiscountCodes(cartId, codes);
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : 'Failed to update discount codes';
+            setError(message);
+            throw err;
+        }
+        finally {
+            setIsLoading(false);
+        }
+    }, [cartClient]);
+    /**
+     * Update cart note.
+     */
+    const updateNote = useCallback(async (note) => {
+        setError(null);
+        setIsLoading(true);
+        try {
+            const cartId = getCartIdFromCookie();
+            if (!cartId)
+                throw new Error('No cart found');
+            return await cartClient.updateNote(cartId, note);
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : 'Failed to update note';
+            setError(message);
+            throw err;
+        }
+        finally {
+            setIsLoading(false);
+        }
+    }, [cartClient]);
+    /**
+     * Clear cart — removes cookie.
+     */
+    const clearCart = useCallback(() => {
+        clearCartIdCookie();
+    }, []);
+    /**
+     * Get current cart ID from cookie (if exists).
+     */
+    const getCartId = useCallback(() => {
+        return getCartIdFromCookie();
+    }, []);
+    return {
+        getCart,
+        addItem,
+        updateItem,
+        removeItem,
+        updateDiscountCodes,
+        updateNote,
+        clearCart,
+        getCartId,
+        isLoading,
+        error,
+    };
+}

package/dist/react/hooks/use-currency.d.ts

@@ -0,0 +1,11 @@
+/**
+ * useCurrency — convenience hook for currency state.
+ */
+export declare function useCurrency(): {
+    currency: string | null;
+    baseCurrency: string | null;
+    supportedCurrencies: string[];
+    setCurrency: (currency: string) => void;
+    isLoaded: boolean;
+};
+//# sourceMappingURL=use-currency.d.ts.map

package/dist/react/hooks/use-currency.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-currency.d.ts","sourceRoot":"","sources":["../../../src/react/hooks/use-currency.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,wBAAgB,WAAW;;;;;;EAc1B"}

package/dist/react/hooks/use-currency.js

@@ -0,0 +1,19 @@
+/**
+ * useCurrency — convenience hook for currency state.
+ */
+'use client';
+import { useCurrencyStore } from '../stores/store-context';
+export function useCurrency() {
+    const currency = useCurrencyStore((s) => s.currency);
+    const baseCurrency = useCurrencyStore((s) => s.baseCurrency);
+    const supportedCurrencies = useCurrencyStore((s) => s.supportedCurrencies);
+    const setCurrency = useCurrencyStore((s) => s.setCurrency);
+    const isLoaded = useCurrencyStore((s) => s.isLoaded);
+    return {
+        currency,
+        baseCurrency,
+        supportedCurrencies,
+        setCurrency,
+        isLoaded,
+    };
+}

package/dist/react/hooks/use-debounced-value.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Debounce a value.
+ *
+ * @param value - Value to debounce
+ * @param delay - Delay in ms (default: 300)
+ * @returns Debounced value
+ *
+ * @example
+ * ```tsx
+ * const [query, setQuery] = useState("");
+ * const debouncedQuery = useDebouncedValue(query, 300);
+ * ```
+ */
+export declare function useDebouncedValue<T>(value: T, delay?: number): T;
+//# sourceMappingURL=use-debounced-value.d.ts.map

package/dist/react/hooks/use-debounced-value.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-debounced-value.d.ts","sourceRoot":"","sources":["../../../src/react/hooks/use-debounced-value.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,SAAM,GAAG,CAAC,CAY7D"}

package/dist/react/hooks/use-debounced-value.js

@@ -0,0 +1,25 @@
+'use client';
+import { useState, useEffect } from 'react';
+/**
+ * Debounce a value.
+ *
+ * @param value - Value to debounce
+ * @param delay - Delay in ms (default: 300)
+ * @returns Debounced value
+ *
+ * @example
+ * ```tsx
+ * const [query, setQuery] = useState("");
+ * const debouncedQuery = useDebouncedValue(query, 300);
+ * ```
+ */
+export function useDebouncedValue(value, delay = 300) {
+    const [debouncedValue, setDebouncedValue] = useState(value);
+    useEffect(() => {
+        const timer = setTimeout(() => {
+            setDebouncedValue(value);
+        }, delay);
+        return () => clearTimeout(timer);
+    }, [value, delay]);
+    return debouncedValue;
+}

package/dist/react/hooks/use-hydrated.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Returns false during SSR and first client render,
+ * then true after hydration completes.
+ *
+ * Use this to guard any content that depends on browser-only state
+ * (localStorage, cookies, window) to prevent hydration mismatches.
+ */
+export declare function useHydrated(): boolean;
+//# sourceMappingURL=use-hydrated.d.ts.map

package/dist/react/hooks/use-hydrated.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-hydrated.d.ts","sourceRoot":"","sources":["../../../src/react/hooks/use-hydrated.ts"],"names":[],"mappings":"AAMA;;;;;;GAMG;AACH,wBAAgB,WAAW,YAM1B"}

package/dist/react/hooks/use-hydrated.js

@@ -0,0 +1,14 @@
+'use client';
+import { useSyncExternalStore } from 'react';
+const emptySubscribe = () => () => { };
+/**
+ * Returns false during SSR and first client render,
+ * then true after hydration completes.
+ *
+ * Use this to guard any content that depends on browser-only state
+ * (localStorage, cookies, window) to prevent hydration mismatches.
+ */
+export function useHydrated() {
+    return useSyncExternalStore(emptySubscribe, () => true, // Client: true
+    () => false);
+}

package/dist/react/hooks/use-storefront-client.d.ts

@@ -0,0 +1,6 @@
+/**
+ * useStorefrontClient — access StorefrontClient from context.
+ */
+import type { StorefrontClient } from '../../core/client/types';
+export declare function useStorefrontClient(): StorefrontClient;
+//# sourceMappingURL=use-storefront-client.d.ts.map

package/dist/react/hooks/use-storefront-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-storefront-client.d.ts","sourceRoot":"","sources":["../../../src/react/hooks/use-storefront-client.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,wBAAgB,mBAAmB,IAAI,gBAAgB,CAEtD"}

package/dist/react/hooks/use-storefront-client.js

@@ -0,0 +1,8 @@
+/**
+ * useStorefrontClient — access StorefrontClient from context.
+ */
+'use client';
+import { useStorefrontClientContext } from '../providers/storefront-client-provider';
+export function useStorefrontClient() {
+    return useStorefrontClientContext().client;
+}

package/dist/react/index.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @doswiftly/storefront-sdk/react — React adapter
+ *
+ * Provides React providers, Zustand stores, and hooks
+ * that wrap the framework-agnostic core.
+ *
+ * Peer dependencies: react ^18 || ^19, zustand ^5
+ *
+ * @example
+ * ```tsx
+ * import { StorefrontProvider, useAuth, useCartManager, useCurrency } from '@doswiftly/storefront-sdk/react';
+ * ```
+ */
+export { StorefrontProvider, type StorefrontProviderProps } from './providers/storefront-provider';
+export { StorefrontClientProvider, type StorefrontClientProviderProps } from './providers/storefront-client-provider';
+export { CurrencyProvider, type CurrencyProviderProps } from './providers/currency-provider';
+export { useAuth, type UseAuthOptions, type LoginResult, type LogoutResult, type TokenRenewResult } from './hooks/use-auth';
+export { useCartManager } from './hooks/use-cart-manager';
+export { useStorefrontClient } from './hooks/use-storefront-client';
+export { useCurrency } from './hooks/use-currency';
+export { useAuthStore, useAuthStoreApi, useAuthHydrated } from './stores/store-context';
+export { useCurrencyStore, useCurrencyStoreApi } from './stores/store-context';
+export type { AuthStore, CustomerInfo } from './stores/auth.store';
+export type { CurrencyStore, ShopCurrencyData } from './stores/currency.store';
+export { selectCurrency, selectBaseCurrency, selectSupportedCurrencies, selectIsLoaded } from './stores/currency.store';
+export { getCookie, setCookie, deleteCookie, getCurrencyFromCookieAsync } from './cookies';
+export { useHydrated } from './hooks/use-hydrated';
+export { useDebouncedValue } from './hooks/use-debounced-value';
+export { createStoreContext } from './helpers/create-store-context';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,EAAE,kBAAkB,EAAE,KAAK,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AACnG,OAAO,EAAE,wBAAwB,EAAE,KAAK,6BAA6B,EAAE,MAAM,wCAAwC,CAAC;AACtH,OAAO,EAAE,gBAAgB,EAAE,KAAK,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAG7F,OAAO,EAAE,OAAO,EAAE,KAAK,cAAc,EAAE,KAAK,WAAW,EAAE,KAAK,YAAY,EAAE,KAAK,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAC5H,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAGnD,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACxF,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAG/E,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnE,YAAY,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAG/E,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,yBAAyB,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAGxH,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,YAAY,EAAE,0BAA0B,EAAE,MAAM,WAAW,CAAC;AAG3F,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAGhE,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC"}

package/dist/react/index.js

@@ -0,0 +1,34 @@
+/**
+ * @doswiftly/storefront-sdk/react — React adapter
+ *
+ * Provides React providers, Zustand stores, and hooks
+ * that wrap the framework-agnostic core.
+ *
+ * Peer dependencies: react ^18 || ^19, zustand ^5
+ *
+ * @example
+ * ```tsx
+ * import { StorefrontProvider, useAuth, useCartManager, useCurrency } from '@doswiftly/storefront-sdk/react';
+ * ```
+ */
+// Providers
+export { StorefrontProvider } from './providers/storefront-provider';
+export { StorefrontClientProvider } from './providers/storefront-client-provider';
+export { CurrencyProvider } from './providers/currency-provider';
+// Hooks
+export { useAuth } from './hooks/use-auth';
+export { useCartManager } from './hooks/use-cart-manager';
+export { useStorefrontClient } from './hooks/use-storefront-client';
+export { useCurrency } from './hooks/use-currency';
+// Store hooks (Context-based)
+export { useAuthStore, useAuthStoreApi, useAuthHydrated } from './stores/store-context';
+export { useCurrencyStore, useCurrencyStoreApi } from './stores/store-context';
+// Selectors
+export { selectCurrency, selectBaseCurrency, selectSupportedCurrencies, selectIsLoaded } from './stores/currency.store';
+// Cookie utilities
+export { getCookie, setCookie, deleteCookie, getCurrencyFromCookieAsync } from './cookies';
+// Generic hooks
+export { useHydrated } from './hooks/use-hydrated';
+export { useDebouncedValue } from './hooks/use-debounced-value';
+// Store context helper
+export { createStoreContext } from './helpers/create-store-context';

package/dist/react/providers/currency-provider.d.ts

@@ -0,0 +1,14 @@
+/**
+ * CurrencyProvider — initializes currency store from Shop data.
+ *
+ * Thin wrapper that calls useCurrencyStore.initialize() on mount
+ * with the shop's currency configuration from the server.
+ */
+import React from 'react';
+import type { ShopCurrencyData } from '../stores/currency.store';
+export interface CurrencyProviderProps {
+    children: React.ReactNode;
+    shopData: ShopCurrencyData;
+}
+export declare function CurrencyProvider({ children, shopData }: CurrencyProviderProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=currency-provider.d.ts.map

package/dist/react/providers/currency-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"currency-provider.d.ts","sourceRoot":"","sources":["../../../src/react/providers/currency-provider.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAoB,MAAM,OAAO,CAAC;AAEzC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAEjE,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,QAAQ,EAAE,gBAAgB,CAAC;CAC5B;AAED,wBAAgB,gBAAgB,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE,qBAAqB,2CAW7E"}

package/dist/react/providers/currency-provider.js

@@ -0,0 +1,20 @@
+/**
+ * CurrencyProvider — initializes currency store from Shop data.
+ *
+ * Thin wrapper that calls useCurrencyStore.initialize() on mount
+ * with the shop's currency configuration from the server.
+ */
+'use client';
+import { Fragment as _Fragment, jsx as _jsx } from "react/jsx-runtime";
+import { useEffect } from 'react';
+import { useCurrencyStore } from '../stores/store-context';
+export function CurrencyProvider({ children, shopData }) {
+    const initialize = useCurrencyStore((s) => s.initialize);
+    const isLoaded = useCurrencyStore((s) => s.isLoaded);
+    useEffect(() => {
+        if (!isLoaded) {
+            initialize(shopData);
+        }
+    }, [initialize, isLoaded, shopData]);
+    return _jsx(_Fragment, { children: children });
+}

package/dist/react/providers/storefront-client-provider.d.ts

@@ -0,0 +1,33 @@
+/**
+ * StorefrontClientProvider — React context for SDK clients.
+ *
+ * Creates StorefrontClient + CartClient + AuthClient and provides them
+ * to the component tree via React context.
+ *
+ * Registers default middleware pipeline: auth → currency → retry → timeout → errors.
+ */
+import React from 'react';
+import { CartClient } from '../../core/cart/cart-client';
+import { AuthClient } from '../../core/auth/auth-client';
+import type { StorefrontClient, StorefrontClientConfig, Middleware } from '../../core/client/types';
+export interface StorefrontClientContextValue {
+    client: StorefrontClient;
+    cartClient: CartClient;
+    authClient: AuthClient;
+}
+export interface StorefrontClientProviderProps {
+    children: React.ReactNode;
+    config: StorefrontClientConfig;
+    /**
+     * Additional middleware to prepend to the default pipeline.
+     * Default pipeline: auth → currency → [custom] → retry → timeout → errors
+     */
+    middleware?: Middleware[];
+}
+export declare function StorefrontClientProvider({ children, config, middleware: customMiddleware, }: StorefrontClientProviderProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Get StorefrontClient context value.
+ * Must be used within StorefrontClientProvider.
+ */
+export declare function useStorefrontClientContext(): StorefrontClientContextValue;
+//# sourceMappingURL=storefront-client-provider.d.ts.map

package/dist/react/providers/storefront-client-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storefront-client-provider.d.ts","sourceRoot":"","sources":["../../../src/react/providers/storefront-client-provider.tsx"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAA6C,MAAM,OAAO,CAAC;AAElE,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAOzD,OAAO,KAAK,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAEpG,MAAM,WAAW,4BAA4B;IAC3C,MAAM,EAAE,gBAAgB,CAAC;IACzB,UAAU,EAAE,UAAU,CAAC;IACvB,UAAU,EAAE,UAAU,CAAC;CACxB;AAID,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,MAAM,EAAE,sBAAsB,CAAC;IAC/B;;;OAGG;IACH,UAAU,CAAC,EAAE,UAAU,EAAE,CAAC;CAC3B;AAED,wBAAgB,wBAAwB,CAAC,EACvC,QAAQ,EACR,MAAM,EACN,UAAU,EAAE,gBAAqB,GAClC,EAAE,6BAA6B,2CAgC/B;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,IAAI,4BAA4B,CAMzE"}

package/dist/react/providers/storefront-client-provider.js

@@ -0,0 +1,57 @@
+/**
+ * StorefrontClientProvider — React context for SDK clients.
+ *
+ * Creates StorefrontClient + CartClient + AuthClient and provides them
+ * to the component tree via React context.
+ *
+ * Registers default middleware pipeline: auth → currency → retry → timeout → errors.
+ */
+'use client';
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useContext, useMemo } from 'react';
+import { createStorefrontClient } from '../../core/client/create-client';
+import { CartClient } from '../../core/cart/cart-client';
+import { AuthClient } from '../../core/auth/auth-client';
+import { authMiddleware } from '../../core/middleware/auth';
+import { currencyMiddleware } from '../../core/middleware/currency';
+import { retryMiddleware } from '../../core/middleware/retry';
+import { timeoutMiddleware } from '../../core/middleware/timeout';
+import { errorMiddleware } from '../../core/middleware/errors';
+import { useAuthStoreApi, useCurrencyStoreApi } from '../stores/store-context';
+const StorefrontClientContext = createContext(null);
+export function StorefrontClientProvider({ children, config, middleware: customMiddleware = [], }) {
+    const authStore = useAuthStoreApi();
+    const currencyStore = useCurrencyStoreApi();
+    const value = useMemo(() => {
+        const client = createStorefrontClient({
+            ...config,
+            middleware: [
+                // Header middleware (runs first)
+                authMiddleware(() => authStore.getState().accessToken),
+                currencyMiddleware(() => currencyStore.getState().currency),
+                // Custom middleware from props
+                ...customMiddleware,
+                // Infrastructure middleware (runs last)
+                retryMiddleware({ maxRetries: 2 }),
+                timeoutMiddleware({ timeout: 5000 }),
+                errorMiddleware(),
+            ],
+        });
+        const cartClient = new CartClient(client);
+        const authClient = new AuthClient(client);
+        return { client, cartClient, authClient };
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [config.apiUrl, config.shopSlug, authStore, currencyStore]);
+    return (_jsx(StorefrontClientContext.Provider, { value: value, children: children }));
+}
+/**
+ * Get StorefrontClient context value.
+ * Must be used within StorefrontClientProvider.
+ */
+export function useStorefrontClientContext() {
+    const ctx = useContext(StorefrontClientContext);
+    if (!ctx) {
+        throw new Error('useStorefrontClientContext must be used within StorefrontClientProvider');
+    }
+    return ctx;
+}

package/dist/react/providers/storefront-provider.d.ts

@@ -0,0 +1,42 @@
+/**
+ * StorefrontProvider — convenience composition of all SDK providers.
+ *
+ * Creates store instances via useRef (stable across re-renders) and provides
+ * them through React Context. Store Contexts wrap StorefrontClientProvider
+ * so that middleware can access store state via useAuthStoreApi/useCurrencyStoreApi.
+ *
+ * Composition order: Store Contexts → StorefrontClientProvider → CurrencyProvider
+ *
+ * @example
+ * ```tsx
+ * // app/layout.tsx
+ * import { StorefrontProvider } from '@doswiftly/storefront-sdk/react';
+ *
+ * export default async function RootLayout({ children }) {
+ *   const shopData = await fetchShop();
+ *   return (
+ *     <StorefrontProvider
+ *       config={{ apiUrl: '...', shopSlug: '...' }}
+ *       shopData={shopData}
+ *     >
+ *       {children}
+ *     </StorefrontProvider>
+ *   );
+ * }
+ * ```
+ */
+import { type StorefrontClientProviderProps } from './storefront-client-provider';
+import { type CurrencyProviderProps } from './currency-provider';
+export interface StorefrontProviderProps extends StorefrontClientProviderProps {
+    shopData: CurrencyProviderProps['shopData'];
+    /**
+     * Server-side auth hint — set to `true` when httpOnly auth cookie exists.
+     * This allows the auth store to start with `isAuthenticated: true` on first render,
+     * eliminating the flash of "Sign In" while Zustand persist rehydrates from localStorage.
+     *
+     * Read from cookies() in a Server Component (layout.tsx) and pass here.
+     */
+    initialIsAuthenticated?: boolean;
+}
+export declare function StorefrontProvider({ children, config, middleware, shopData, initialIsAuthenticated, }: StorefrontProviderProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=storefront-provider.d.ts.map

package/dist/react/providers/storefront-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storefront-provider.d.ts","sourceRoot":"","sources":["../../../src/react/providers/storefront-provider.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAQH,OAAO,EAA4B,KAAK,6BAA6B,EAAE,MAAM,8BAA8B,CAAC;AAC5G,OAAO,EAAoB,KAAK,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAEnF,MAAM,WAAW,uBAAwB,SAAQ,6BAA6B;IAC5E,QAAQ,EAAE,qBAAqB,CAAC,UAAU,CAAC,CAAC;IAC5C;;;;;;OAMG;IACH,sBAAsB,CAAC,EAAE,OAAO,CAAC;CAClC;AAED,wBAAgB,kBAAkB,CAAC,EACjC,QAAQ,EACR,MAAM,EACN,UAAU,EACV,QAAQ,EACR,sBAAsB,GACvB,EAAE,uBAAuB,2CAezB"}

package/dist/react/providers/storefront-provider.js

@@ -0,0 +1,40 @@
+/**
+ * StorefrontProvider — convenience composition of all SDK providers.
+ *
+ * Creates store instances via useRef (stable across re-renders) and provides
+ * them through React Context. Store Contexts wrap StorefrontClientProvider
+ * so that middleware can access store state via useAuthStoreApi/useCurrencyStoreApi.
+ *
+ * Composition order: Store Contexts → StorefrontClientProvider → CurrencyProvider
+ *
+ * @example
+ * ```tsx
+ * // app/layout.tsx
+ * import { StorefrontProvider } from '@doswiftly/storefront-sdk/react';
+ *
+ * export default async function RootLayout({ children }) {
+ *   const shopData = await fetchShop();
+ *   return (
+ *     <StorefrontProvider
+ *       config={{ apiUrl: '...', shopSlug: '...' }}
+ *       shopData={shopData}
+ *     >
+ *       {children}
+ *     </StorefrontProvider>
+ *   );
+ * }
+ * ```
+ */
+'use client';
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useRef } from 'react';
+import { AuthStoreContext, CurrencyStoreContext } from '../stores/store-context';
+import { createAuthStore } from '../stores/auth.store';
+import { createCurrencyStore } from '../stores/currency.store';
+import { StorefrontClientProvider } from './storefront-client-provider';
+import { CurrencyProvider } from './currency-provider';
+export function StorefrontProvider({ children, config, middleware, shopData, initialIsAuthenticated, }) {
+    const authStoreRef = useRef(createAuthStore(initialIsAuthenticated));
+    const currencyStoreRef = useRef(createCurrencyStore());
+    return (_jsx(AuthStoreContext.Provider, { value: authStoreRef.current, children: _jsx(CurrencyStoreContext.Provider, { value: currencyStoreRef.current, children: _jsx(StorefrontClientProvider, { config: config, middleware: middleware, children: _jsx(CurrencyProvider, { shopData: shopData, children: children }) }) }) }));
+}