@doswiftly/storefront-sdk 11.2.0 → 11.3.1

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

@@ -42,8 +42,7 @@ import { createCartRecoveryRunner, recreateWithInput, } from '../../core/cart/ca
 import { createBrowserCartCookieStore } from '../cookies';
 export function useCartManager() {
     const { cartClient } = useStorefrontClientContext();
-    const [isLoading, setIsLoading] = useState(false);
-    const [error, setError] = useState(null);
+    const [status, setStatus] = useState({ type: 'idle' });
     // Cookie store is stateless — keep one instance per hook mount.
     const cookieStore = useMemo(() => createBrowserCartCookieStore(), []);
     // Recovery runner is bound to cartClient identity (changes only on provider
@@ -55,64 +54,67 @@ export function useCartManager() {
     // `useEffect(() => onExpired(...), [onExpired])` so React re-subscribes when
     // the provider (and thus the runner) remounts.
     const onExpired = useCallback((listener) => runner.onExpired(listener), [runner]);
-    // Generic mutation wrapper — sets loading + error state, delegates recovery
-    // semantics to the runner.
-    const wrapMutation = useCallback(async (run, failureFallbackMessage) => {
-        setError(null);
-        setIsLoading(true);
+    // Generic mutation wrapper — drives the tagged-union status. Delegates
+    // recovery semantics to the runner (which fires onExpired separately).
+    const wrapMutation = useCallback(async (operation, run, failureFallbackMessage) => {
+        setStatus({ type: 'loading', operation });
         try {
-            return await run();
+            const result = await run();
+            setStatus({ type: 'success', operation });
+            return result;
         }
         catch (err) {
-            setError(err instanceof Error ? err.message : failureFallbackMessage);
+            const error = err instanceof Error ? err : new Error(failureFallbackMessage);
+            setStatus({ type: 'error', operation, error });
             throw err;
         }
-        finally {
-            setIsLoading(false);
-        }
     }, []);
     // --- Read ---
     const getCart = useCallback(() => runner.getCart(), [runner]);
     const getCartId = useCallback(() => cookieStore.get(), [cookieStore]);
     // --- Auto-replay mutations ---
-    const addItem = useCallback((lines) => wrapMutation(() => runner.execute({
+    const addItem = useCallback((lines) => wrapMutation('addItem', () => runner.execute({
         name: 'addItem',
         run: (cartId) => cartClient.addItems(cartId, lines),
         recreateAndRun: recreateWithInput({ lines }),
     }), 'Failed to add to cart'), [runner, cartClient, wrapMutation]);
-    const updateBuyerIdentity = useCallback((buyerIdentity) => wrapMutation(() => runner.execute({
+    const updateBuyerIdentity = useCallback((buyerIdentity) => wrapMutation('updateBuyerIdentity', () => runner.execute({
         name: 'updateBuyerIdentity',
         run: (cartId) => cartClient.updateBuyerIdentity(cartId, buyerIdentity),
         recreateAndRun: recreateWithInput({ buyerIdentity }),
     }), 'Failed to update buyer identity'), [runner, cartClient, wrapMutation]);
-    const setShippingAddress = useCallback((address) => wrapMutation(() => runner.execute({
+    const setShippingAddress = useCallback((address) => wrapMutation('setShippingAddress', () => runner.execute({
         name: 'setShippingAddress',
         run: (cartId) => cartClient.setShippingAddress({ cartId, address }),
         recreateAndRun: recreateWithInput({ shippingAddress: address }),
     }), 'Failed to set shipping address'), [runner, cartClient, wrapMutation]);
-    const updateDiscountCodes = useCallback((codes) => wrapMutation(() => runner.execute({
+    const updateDiscountCodes = useCallback((codes) => wrapMutation('updateDiscountCodes', () => runner.execute({
         name: 'updateDiscountCodes',
         run: (cartId) => cartClient.updateDiscountCodes(cartId, codes),
         recreateAndRun: recreateWithInput({ discountCodes: codes }),
     }), 'Failed to update discount codes'), [runner, cartClient, wrapMutation]);
-    const updateNote = useCallback((note) => wrapMutation(() => runner.execute({
+    const updateNote = useCallback((note) => wrapMutation('updateNote', () => runner.execute({
         name: 'updateNote',
         run: (cartId) => cartClient.updateNote(cartId, note),
         recreateAndRun: recreateWithInput({ note }),
     }), 'Failed to update note'), [runner, cartClient, wrapMutation]);
     // --- Bail-on-stale mutations (no recreateAndRun — fires onExpired + throws) ---
-    const updateItem = useCallback((lines) => wrapMutation(() => runner.execute({
+    const updateItem = useCallback((lines) => wrapMutation('updateItem', () => runner.execute({
         name: 'updateItem',
         run: (cartId) => cartClient.updateItems(cartId, lines),
     }), 'Failed to update cart'), [runner, cartClient, wrapMutation]);
-    const removeItem = useCallback((lineIds) => wrapMutation(() => runner.execute({
+    const removeItem = useCallback((lineIds) => wrapMutation('removeItem', () => runner.execute({
         name: 'removeItem',
         run: (cartId) => cartClient.removeItems(cartId, lineIds),
     }), 'Failed to remove from cart'), [runner, cartClient, wrapMutation]);
     // --- Lifecycle ---
     const clearCart = useCallback(() => {
         cookieStore.clear();
+        setStatus({ type: 'idle' });
     }, [cookieStore]);
+    // Backward-compatible derived selectors over the tagged-union status.
+    const isLoading = status.type === 'loading';
+    const error = status.type === 'error' ? status.error.message : null;
     return {
         getCart,
         getCartId,
@@ -125,6 +127,7 @@ export function useCartManager() {
         removeItem,
         clearCart,
         onExpired,
+        status,
         isLoading,
         error,
     };

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

@@ -0,0 +1,40 @@
+/**
+ * useLogin — focused hook for the login flow.
+ *
+ * Composes the auth client + Zustand store + httpOnly cookie BFF callback.
+ * Returns `success`/`userErrors` rather than throwing on credential errors —
+ * standard form submission pattern.
+ *
+ * @example
+ * ```tsx
+ * const { login, isLoggingIn, error } = useLogin({ onSetToken });
+ * const result = await login(email, password);
+ * if (!result.success) showErrors(result.userErrors);
+ * ```
+ */
+export interface UseLoginOptions {
+    /**
+     * Called after successful login with the new access token. Use this to set
+     * the httpOnly cookie via an API route handler (`createSetTokenHandler`).
+     */
+    onSetToken?: (token: string) => Promise<void>;
+}
+export interface LoginResult {
+    success: boolean;
+    userErrors: Array<{
+        message: string;
+        field?: string[];
+    }>;
+    accessToken?: string;
+    expiresAt?: string;
+}
+export interface UseLoginReturn {
+    /** Submit the login form. Resolves with `{success, userErrors}` rather than throwing on credential failures. */
+    login: (email: string, password: string) => Promise<LoginResult>;
+    /** `true` while a login request is in flight. */
+    isLoggingIn: boolean;
+    /** Last unexpected error message (network, server) — credential failures land in `userErrors` instead. */
+    error: string | null;
+}
+export declare function useLogin(options?: UseLoginOptions): UseLoginReturn;
+//# sourceMappingURL=use-login.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-login.d.ts","sourceRoot":"","sources":["../../../src/react/hooks/use-login.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AASH,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/C;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;IACzD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,gHAAgH;IAChH,KAAK,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,WAAW,CAAC,CAAC;IACjE,iDAAiD;IACjD,WAAW,EAAE,OAAO,CAAC;IACrB,0GAA0G;IAC1G,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED,wBAAgB,QAAQ,CAAC,OAAO,GAAE,eAAoB,GAAG,cAAc,CA+DtE"}

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

@@ -0,0 +1,75 @@
+/**
+ * useLogin — focused hook for the login flow.
+ *
+ * Composes the auth client + Zustand store + httpOnly cookie BFF callback.
+ * Returns `success`/`userErrors` rather than throwing on credential errors —
+ * standard form submission pattern.
+ *
+ * @example
+ * ```tsx
+ * const { login, isLoggingIn, error } = useLogin({ onSetToken });
+ * const result = await login(email, password);
+ * if (!result.success) showErrors(result.userErrors);
+ * ```
+ */
+'use client';
+import { useCallback, useState } from 'react';
+import { useStorefrontClientContext } from '../providers/storefront-client-provider';
+import { useAuthStore } from '../stores/store-context';
+import { StorefrontError } from '../../core/errors';
+export function useLogin(options = {}) {
+    const { authClient } = useStorefrontClientContext();
+    const { setAuth } = useAuthStore();
+    const [isLoggingIn, setIsLoggingIn] = useState(false);
+    const [error, setError] = useState(null);
+    const login = useCallback(async (email, password) => {
+        setError(null);
+        setIsLoggingIn(true);
+        try {
+            const result = await authClient.login(email, password);
+            if (options.onSetToken) {
+                await options.onSetToken(result.accessToken);
+            }
+            // Fetch customer data and set store (best-effort — fallback to minimal data)
+            try {
+                const customer = await authClient.getCustomer();
+                if (customer) {
+                    setAuth({
+                        id: customer.id,
+                        email: customer.email,
+                        firstName: customer.firstName ?? undefined,
+                        lastName: customer.lastName ?? undefined,
+                        phone: customer.phone ?? undefined,
+                    }, result.accessToken);
+                }
+                else {
+                    setAuth({ id: '', email }, result.accessToken);
+                }
+            }
+            catch {
+                setAuth({ id: '', email }, result.accessToken);
+            }
+            return {
+                success: true,
+                userErrors: [],
+                accessToken: result.accessToken,
+                expiresAt: result.expiresAt,
+            };
+        }
+        catch (err) {
+            if (err instanceof StorefrontError && err.hasUserErrors) {
+                return {
+                    success: false,
+                    userErrors: err.userErrors.map((e) => ({ message: e.message, field: e.field })),
+                };
+            }
+            const message = err instanceof Error ? err.message : 'Login failed';
+            setError(message);
+            return { success: false, userErrors: [{ message }] };
+        }
+        finally {
+            setIsLoggingIn(false);
+        }
+    }, [authClient, setAuth, options]);
+    return { login, isLoggingIn, error };
+}

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

@@ -0,0 +1,40 @@
+/**
+ * useLogout — focused hook for the logout flow.
+ *
+ * Calls the auth client logout (which clears the backend's httpOnly cookie),
+ * invokes the consumer's `onClearToken` callback (BFF), and resets the local
+ * auth store. Even when the backend request fails, the local state is
+ * cleared (defensive — better to log a user out than leave them in a half
+ * state).
+ *
+ * @example
+ * ```tsx
+ * const { logout, isLoggingOut } = useLogout({ onClearToken });
+ * await logout();
+ * router.push('/');
+ * ```
+ */
+export interface UseLogoutOptions {
+    /**
+     * Called after logout to clear the httpOnly cookie via an API route handler
+     * (`createClearTokenHandler`).
+     */
+    onClearToken?: () => Promise<void>;
+}
+export interface LogoutResult {
+    success: boolean;
+    userErrors: Array<{
+        message: string;
+        field?: string[];
+    }>;
+}
+export interface UseLogoutReturn {
+    /** Run the logout flow. Resolves with `{success}` — local state is always cleared. */
+    logout: () => Promise<LogoutResult>;
+    /** `true` while the logout request is in flight. */
+    isLoggingOut: boolean;
+    /** Last error message (network, server) — local state is cleared regardless. */
+    error: string | null;
+}
+export declare function useLogout(options?: UseLogoutOptions): UseLogoutReturn;
+//# sourceMappingURL=use-logout.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-logout.d.ts","sourceRoot":"","sources":["../../../src/react/hooks/use-logout.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAQH,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;CAC1D;AAED,MAAM,WAAW,eAAe;IAC9B,sFAAsF;IACtF,MAAM,EAAE,MAAM,OAAO,CAAC,YAAY,CAAC,CAAC;IACpC,oDAAoD;IACpD,YAAY,EAAE,OAAO,CAAC;IACtB,gFAAgF;IAChF,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED,wBAAgB,SAAS,CAAC,OAAO,GAAE,gBAAqB,GAAG,eAAe,CAgCzE"}

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

@@ -0,0 +1,50 @@
+/**
+ * useLogout — focused hook for the logout flow.
+ *
+ * Calls the auth client logout (which clears the backend's httpOnly cookie),
+ * invokes the consumer's `onClearToken` callback (BFF), and resets the local
+ * auth store. Even when the backend request fails, the local state is
+ * cleared (defensive — better to log a user out than leave them in a half
+ * state).
+ *
+ * @example
+ * ```tsx
+ * const { logout, isLoggingOut } = useLogout({ onClearToken });
+ * await logout();
+ * router.push('/');
+ * ```
+ */
+'use client';
+import { useCallback, useState } from 'react';
+import { useStorefrontClientContext } from '../providers/storefront-client-provider';
+import { useAuthStore } from '../stores/store-context';
+export function useLogout(options = {}) {
+    const { authClient } = useStorefrontClientContext();
+    const { clearAuth } = useAuthStore();
+    const [isLoggingOut, setIsLoggingOut] = useState(false);
+    const [error, setError] = useState(null);
+    const logout = useCallback(async () => {
+        setError(null);
+        setIsLoggingOut(true);
+        try {
+            // Auth context resolved server-side from cookie/Bearer — no token arg needed
+            await authClient.logout();
+            if (options.onClearToken) {
+                await options.onClearToken();
+            }
+            clearAuth();
+            return { success: true, userErrors: [] };
+        }
+        catch (err) {
+            // Even on error, clear local state — better than a stuck half-state
+            clearAuth();
+            const message = err instanceof Error ? err.message : 'Logout failed';
+            setError(message);
+            return { success: false, userErrors: [{ message }] };
+        }
+        finally {
+            setIsLoggingOut(false);
+        }
+    }, [authClient, clearAuth, options]);
+    return { logout, isLoggingOut, error };
+}

package/dist/react/hooks/use-refresh-token.d.ts

@@ -0,0 +1,40 @@
+/**
+ * useRefreshToken — focused hook for renewing the access token.
+ *
+ * Wraps `AuthClient.refreshToken`. On success the new token is propagated to
+ * the consumer's BFF (`onSetToken`) and the store keeps the existing customer
+ * data with the new token attached.
+ *
+ * @example
+ * ```tsx
+ * // Periodic refresh (e.g. every 30 min)
+ * const { refreshToken } = useRefreshToken({ onSetToken });
+ * useEffect(() => {
+ *   const timer = setInterval(() => refreshToken(), 30 * 60 * 1000);
+ *   return () => clearInterval(timer);
+ * }, [refreshToken]);
+ * ```
+ */
+export interface UseRefreshTokenOptions {
+    /** Called after a successful refresh with the new access token (BFF cookie sync). */
+    onSetToken?: (token: string) => Promise<void>;
+}
+export interface TokenRefreshResult {
+    success: boolean;
+    userErrors: Array<{
+        message: string;
+        field?: string[];
+    }>;
+    accessToken?: string;
+    expiresAt?: string;
+}
+export interface UseRefreshTokenReturn {
+    /** Renew the access token. Resolves with `{success}`. */
+    refreshToken: () => Promise<TokenRefreshResult>;
+    /** `true` while a refresh request is in flight. */
+    isRefreshingToken: boolean;
+    /** Last unexpected error message — credential / session expiry lands in `userErrors`. */
+    error: string | null;
+}
+export declare function useRefreshToken(options?: UseRefreshTokenOptions): UseRefreshTokenReturn;
+//# sourceMappingURL=use-refresh-token.d.ts.map

package/dist/react/hooks/use-refresh-token.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-refresh-token.d.ts","sourceRoot":"","sources":["../../../src/react/hooks/use-refresh-token.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AASH,MAAM,WAAW,sBAAsB;IACrC,qFAAqF;IACrF,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/C;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;IACzD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,qBAAqB;IACpC,yDAAyD;IACzD,YAAY,EAAE,MAAM,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAChD,mDAAmD;IACnD,iBAAiB,EAAE,OAAO,CAAC;IAC3B,yFAAyF;IACzF,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED,wBAAgB,eAAe,CAAC,OAAO,GAAE,sBAA2B,GAAG,qBAAqB,CA+C3F"}

package/dist/react/hooks/use-refresh-token.js

@@ -0,0 +1,66 @@
+/**
+ * useRefreshToken — focused hook for renewing the access token.
+ *
+ * Wraps `AuthClient.refreshToken`. On success the new token is propagated to
+ * the consumer's BFF (`onSetToken`) and the store keeps the existing customer
+ * data with the new token attached.
+ *
+ * @example
+ * ```tsx
+ * // Periodic refresh (e.g. every 30 min)
+ * const { refreshToken } = useRefreshToken({ onSetToken });
+ * useEffect(() => {
+ *   const timer = setInterval(() => refreshToken(), 30 * 60 * 1000);
+ *   return () => clearInterval(timer);
+ * }, [refreshToken]);
+ * ```
+ */
+'use client';
+import { useCallback, useState } from 'react';
+import { useStorefrontClientContext } from '../providers/storefront-client-provider';
+import { useAuthStore, useAuthStoreApi } from '../stores/store-context';
+import { StorefrontError } from '../../core/errors';
+export function useRefreshToken(options = {}) {
+    const { authClient } = useStorefrontClientContext();
+    const { setAuth } = useAuthStore();
+    const authStore = useAuthStoreApi();
+    const [isRefreshingToken, setIsRefreshingToken] = useState(false);
+    const [error, setError] = useState(null);
+    const refreshToken = useCallback(async () => {
+        setError(null);
+        setIsRefreshingToken(true);
+        try {
+            // Auth context resolved server-side from cookie/Bearer. If no active
+            // session, backend returns 401 and refreshToken throws.
+            const result = await authClient.refreshToken();
+            if (options.onSetToken) {
+                await options.onSetToken(result.accessToken);
+            }
+            const currentCustomer = authStore.getState().customer;
+            if (currentCustomer) {
+                setAuth(currentCustomer, result.accessToken);
+            }
+            return {
+                success: true,
+                userErrors: [],
+                accessToken: result.accessToken,
+                expiresAt: result.expiresAt,
+            };
+        }
+        catch (err) {
+            if (err instanceof StorefrontError && err.hasUserErrors) {
+                return {
+                    success: false,
+                    userErrors: err.userErrors.map((e) => ({ message: e.message, field: e.field })),
+                };
+            }
+            const message = err instanceof Error ? err.message : 'Token renewal failed';
+            setError(message);
+            return { success: false, userErrors: [{ message }] };
+        }
+        finally {
+            setIsRefreshingToken(false);
+        }
+    }, [authClient, setAuth, authStore, options]);
+    return { refreshToken, isRefreshingToken, error };
+}

package/dist/react/index.d.ts

@@ -16,7 +16,10 @@ export { StorefrontClientProvider, type StorefrontClientProviderProps } from './
 export { CurrencyProvider, type CurrencyProviderProps } from './providers/currency-provider';
 export { LanguageProvider, type LanguageProviderProps } from './providers/language-provider';
 export { useAuth, type UseAuthOptions, type LoginResult, type LogoutResult, type TokenRefreshResult } from './hooks/use-auth';
-export { useCartManager } from './hooks/use-cart-manager';
+export { useLogin, type UseLoginOptions, type UseLoginReturn } from './hooks/use-login';
+export { useLogout, type UseLogoutOptions, type UseLogoutReturn } from './hooks/use-logout';
+export { useRefreshToken, type UseRefreshTokenOptions, type UseRefreshTokenReturn } from './hooks/use-refresh-token';
+export { useCartManager, type CartManagerOperation, type CartManagerStatus, type UseCartManagerResult } 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';
@@ -36,4 +39,5 @@ export { createCartStore, selectCartId, selectIsCartOpen, selectCartIsLoading, }
 export type { CartState, CartStoreConfig, CartActions, CartData, CartMutationAction, CartLineInput, CartLineUpdateInput, } from './stores/cart.store';
 export { CartProvider, useCartStore, useCartStoreApi } from './stores/cart.context';
 export { createStoreContext } from './helpers/create-store-context';
+export { Money, type MoneyProps, Image, type ImageComponentProps, CartCount, type CartCountProps, AddToCartButton, type AddToCartButtonProps, PriceDisplay, type PriceDisplayProps, CartTotals, type CartTotalsProps, type CartTotalsLabels, } from './components';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +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;AAC7F,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,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAC9H,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;AAC/E,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;AAC/E,YAAY,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC7D,YAAY,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAGtD,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,yBAAyB,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACxH,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,wBAAwB,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAGlI,OAAO,EACL,SAAS,EACT,SAAS,EACT,YAAY,EACZ,0BAA0B,EAC1B,wBAAwB,EACxB,4BAA4B,GAC7B,MAAM,WAAW,CAAC;AAGnB,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAG9D,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAGhE,OAAO,EACL,eAAe,EACf,YAAY,EACZ,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACV,SAAS,EACT,eAAe,EACf,WAAW,EACX,QAAQ,EACR,kBAAkB,EAClB,aAAa,EACb,mBAAmB,GACpB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAGpF,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"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"}

package/dist/react/index.js

@@ -18,6 +18,9 @@ export { CurrencyProvider } from './providers/currency-provider';
 export { LanguageProvider } from './providers/language-provider';
 // Hooks
 export { useAuth } from './hooks/use-auth';
+export { useLogin } from './hooks/use-login';
+export { useLogout } from './hooks/use-logout';
+export { useRefreshToken } from './hooks/use-refresh-token';
 export { useCartManager } from './hooks/use-cart-manager';
 export { useStorefrontClient } from './hooks/use-storefront-client';
 export { useCurrency } from './hooks/use-currency';
@@ -40,3 +43,5 @@ export { createCartStore, selectCartId, selectIsCartOpen, selectCartIsLoading, }
 export { CartProvider, useCartStore, useCartStoreApi } from './stores/cart.context';
 // Store context helper
 export { createStoreContext } from './helpers/create-store-context';
+// Pre-built components (headless — no styling, accessibility-aware)
+export { Money, Image, CartCount, AddToCartButton, PriceDisplay, CartTotals, } from './components';

package/dist/react/server/get-storefront-client.d.ts

@@ -21,13 +21,23 @@
  */
 import type { StorefrontClient, StorefrontClientConfig, Middleware } from '../../core/client/types';
 export interface ServerClientOptions extends Omit<StorefrontClientConfig, 'middleware'> {
-    /**
-     * Function that returns request-scoped headers (e.g. currency from cookie).
-     * Called once per client creation.
-     */
-    getHeaders?: () => Record<string, string> | Promise<Record<string, string>>;
     /**
      * Additional middleware (prepended to default pipeline).
+     *
+     * Use this for request-scoped headers (e.g. currency from cookie, language
+     * from URL, custom tracking):
+     *
+     * ```ts
+     * getStorefrontClient({
+     *   apiUrl, shopSlug,
+     *   middleware: [
+     *     async (req, next) => {
+     *       req.headers['X-Preferred-Currency'] = await readCookieFromHeaders();
+     *       return next(req);
+     *     },
+     *   ],
+     * });
+     * ```
      */
     middleware?: Middleware[];
 }

package/dist/react/server/get-storefront-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-storefront-client.d.ts","sourceRoot":"","sources":["../../../src/react/server/get-storefront-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAMH,OAAO,KAAK,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAEpG,MAAM,WAAW,mBAAoB,SAAQ,IAAI,CAAC,sBAAsB,EAAE,YAAY,CAAC;IACrF;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC5E;;OAEG;IACH,UAAU,CAAC,EAAE,UAAU,EAAE,CAAC;CAC3B;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,mBAAmB,GAAG,gBAAgB,CAYlF"}
+{"version":3,"file":"get-storefront-client.d.ts","sourceRoot":"","sources":["../../../src/react/server/get-storefront-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAMH,OAAO,KAAK,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAEpG,MAAM,WAAW,mBAAoB,SAAQ,IAAI,CAAC,sBAAsB,EAAE,YAAY,CAAC;IACrF;;;;;;;;;;;;;;;;;OAiBG;IACH,UAAU,CAAC,EAAE,UAAU,EAAE,CAAC;CAC3B;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,mBAAmB,GAAG,gBAAgB,CAYlF"}

package/dist/react/stores/cart.store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cart.store.d.ts","sourceRoot":"","sources":["../../../src/react/stores/cart.store.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"cart.store.d.ts","sourceRoot":"","sources":["../../../src/react/stores/cart.store.ts"],"names":[],"mappings":"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"}

package/dist/react/stores/cart.store.js

@@ -62,13 +62,6 @@ export function createCartStore(config) {
     let initPromise = null;
     // Read initial cartId from cookie (client-side only, returns null on server)
     const initialCartId = getCookie(CART_COOKIE_NAME);
-    // Clean up old localStorage entry from pre-cookie era (v1 persist)
-    if (typeof localStorage !== 'undefined') {
-        try {
-            localStorage.removeItem('cart-storage');
-        }
-        catch { /* ignore */ }
-    }
     function emitExpired(event) {
         if (!config.onExpired)
             return;

package/dist/react/stores/store-context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"store-context.d.ts","sourceRoot":"","sources":["../../../src/react/stores/store-context.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,EAAY,KAAK,QAAQ,EAAE,MAAM,SAAS,CAAC;AAClD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAMtD,eAAO,MAAM,gBAAgB,qDAAkD,CAAC;AAChF,eAAO,MAAM,oBAAoB,yDAAsD,CAAC;AACxF,eAAO,MAAM,oBAAoB,yDAAsD,CAAC;AAMxF,wBAAgB,YAAY,IAAI,SAAS,CAAC;AAC1C,wBAAgB,YAAY,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,EAAE,SAAS,KAAK,CAAC,GAAG,CAAC,CAAC;AAQlE,wBAAgB,eAAe,IAAI,QAAQ,CAAC,SAAS,CAAC,CAIrD;AAED;;;GAGG;AACH,wBAAgB,eAAe,IAAI,OAAO,CAczC;AAMD,wBAAgB,gBAAgB,IAAI,aAAa,CAAC;AAClD,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,EAAE,aAAa,KAAK,CAAC,GAAG,CAAC,CAAC;AAQ1E,wBAAgB,mBAAmB,IAAI,QAAQ,CAAC,aAAa,CAAC,CAI7D;AAMD,wBAAgB,gBAAgB,IAAI,aAAa,CAAC;AAClD,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,EAAE,aAAa,KAAK,CAAC,GAAG,CAAC,CAAC;AAQ1E,wBAAgB,mBAAmB,IAAI,QAAQ,CAAC,aAAa,CAAC,CAI7D"}
+{"version":3,"file":"store-context.d.ts","sourceRoot":"","sources":["../../../src/react/stores/store-context.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,EAAY,KAAK,QAAQ,EAAE,MAAM,SAAS,CAAC;AAClD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAMtD,eAAO,MAAM,gBAAgB,qDAAkD,CAAC;AAChF,eAAO,MAAM,oBAAoB,yDAAsD,CAAC;AACxF,eAAO,MAAM,oBAAoB,yDAAsD,CAAC;AAMxF,wBAAgB,YAAY,IAAI,SAAS,CAAC;AAC1C,wBAAgB,YAAY,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,EAAE,SAAS,KAAK,CAAC,GAAG,CAAC,CAAC;AAQlE,wBAAgB,eAAe,IAAI,QAAQ,CAAC,SAAS,CAAC,CAIrD;AAED;;;GAGG;AACH,wBAAgB,eAAe,IAAI,OAAO,CAoBzC;AAMD,wBAAgB,gBAAgB,IAAI,aAAa,CAAC;AAClD,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,EAAE,aAAa,KAAK,CAAC,GAAG,CAAC,CAAC;AAQ1E,wBAAgB,mBAAmB,IAAI,QAAQ,CAAC,aAAa,CAAC,CAI7D;AAMD,wBAAgB,gBAAgB,IAAI,aAAa,CAAC;AAClD,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,EAAE,aAAa,KAAK,CAAC,GAAG,CAAC,CAAC;AAQ1E,wBAAgB,mBAAmB,IAAI,QAAQ,CAAC,aAAa,CAAC,CAI7D"}

package/dist/react/stores/store-context.js

@@ -39,9 +39,7 @@ export function useAuthHydrated() {
     const [hydrated, setHydrated] = useState(false);
     useEffect(() => {
         const persistApi = store.persist;
-        // Subscribe to future hydration completions
         const unsubFinish = persistApi.onFinishHydration(() => setHydrated(true));
-        // Check if hydration already completed before effect ran
         if (persistApi.hasHydrated())
             setHydrated(true);
         return unsubFinish;

package/package.json

@@ -1,8 +1,9 @@
 {
   "name": "@doswiftly/storefront-sdk",
-  "version": "11.2.0",
+  "version": "11.3.1",
   "description": "Storefront runtime SDK for DoSwiftly Commerce — layered transport, middleware pipeline, React providers, Zustand stores, cache strategies. 0 runtime dependencies in core.",
   "type": "module",
+  "sideEffects": false,
   "files": [
     "dist",
     "README.md",
@@ -44,6 +45,7 @@
     "@types/node": "^22.10.2",
     "@types/react": "^18.3.0 || ^19.0.0",
     "@types/react-dom": "^19.0.0",
+    "@vitest/coverage-v8": "^4.1.0",
     "fast-check": "^3.23.2",
     "jsdom": "^25.0.1",
     "next": "^16.2.3",
@@ -74,6 +76,8 @@
     "test:watch": "vitest",
     "test:unit": "vitest run src/__tests__/unit/",
     "test:contract": "vitest run src/__tests__/contract/",
+    "test:coverage": "vitest run --coverage",
+    "doctor": "node scripts/doctor.cjs",
     "validate:cart": "node scripts/validate-cart-operations.cjs --strict"
   }
 }

package/dist/__tests__/unit/test-helpers.d.ts

@@ -1,46 +0,0 @@
-/**
- * Shared test helpers — mock fetch factory, mock client builder.
- */
-/**
- * Create a mock fetch that returns the specified GraphQL response.
- */
-export declare function createMockFetch(responseData: unknown, options?: {
-    errors?: Array<{
-        message: string;
-    }>;
-    status?: number;
-    delay?: number;
-}): typeof globalThis.fetch;
-/**
- * Create a mock fetch that tracks all calls and returns specified response.
- */
-export declare function createSpyFetch(responseData: unknown, options?: {
-    errors?: Array<{
-        message: string;
-    }>;
-    status?: number;
-}): {
-    fetch: typeof globalThis.fetch;
-    calls: {
-        url: string;
-        init: RequestInit;
-    }[];
-};
-/**
- * Create a mock fetch that fails with a network error.
- */
-export declare function createNetworkErrorFetch(errorMessage?: string): typeof globalThis.fetch;
-/**
- * Create a mock fetch that returns different responses on subsequent calls.
- */
-export declare function createSequenceFetch(responses: Array<{
-    data?: unknown;
-    errors?: Array<{
-        message: string;
-    }>;
-    status?: number;
-}>): {
-    fetch: typeof globalThis.fetch;
-    callCount: () => number;
-};
-//# sourceMappingURL=test-helpers.d.ts.map

package/dist/__tests__/unit/test-helpers.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"test-helpers.d.ts","sourceRoot":"","sources":["../../../src/__tests__/unit/test-helpers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;GAEG;AACH,wBAAgB,eAAe,CAC7B,YAAY,EAAE,OAAO,EACrB,OAAO,CAAC,EAAE;IACR,MAAM,CAAC,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GACA,OAAO,UAAU,CAAC,KAAK,CAqBzB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,YAAY,EAAE,OAAO,EACrB,OAAO,CAAC,EAAE;IACR,MAAM,CAAC,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;WAqB0B,OAAO,UAAU,CAAC,KAAK;;aAnBxB,MAAM;cAAQ,WAAW;;EAoBpD;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,YAAY,SAAiB,GAAG,OAAO,UAAU,CAAC,KAAK,CAI9F;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,KAAK,CAAC;IAAE,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,GACzF;IAAE,KAAK,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;IAAC,SAAS,EAAE,MAAM,MAAM,CAAA;CAAE,CAiB7D"}