@doswiftly/storefront-sdk 11.1.0 → 11.3.1

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';
@@ -28,7 +31,7 @@ export type { LanguageStore } from './stores/language.store';
 export type { ShopConfig } from './types/shop-config';
 export { selectCurrency, selectBaseCurrency, selectSupportedCurrencies, selectIsLoaded } from './stores/currency.store';
 export { selectLanguage, selectDefaultLanguage, selectSupportedLanguages, selectLanguageIsLoaded } from './stores/language.store';
-export { getCookie, setCookie, deleteCookie, getCurrencyFromCookieAsync, getCartIdFromCookieAsync } from './cookies';
+export { getCookie, setCookie, deleteCookie, getCurrencyFromCookieAsync, getCartIdFromCookieAsync, createBrowserCartCookieStore, } from './cookies';
 export { useBotProtection } from './hooks/use-bot-protection';
 export { useHydrated } from './hooks/use-hydrated';
 export { useDebouncedValue } from './hooks/use-debounced-value';
@@ -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,EAAE,SAAS,EAAE,SAAS,EAAE,YAAY,EAAE,0BAA0B,EAAE,wBAAwB,EAAE,MAAM,WAAW,CAAC;AAGrH,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';
@@ -29,7 +32,7 @@ export { useLanguageStore, useLanguageStoreApi } from './stores/store-context';
 export { selectCurrency, selectBaseCurrency, selectSupportedCurrencies, selectIsLoaded } from './stores/currency.store';
 export { selectLanguage, selectDefaultLanguage, selectSupportedLanguages, selectLanguageIsLoaded } from './stores/language.store';
 // Cookie utilities
-export { getCookie, setCookie, deleteCookie, getCurrencyFromCookieAsync, getCartIdFromCookieAsync } from './cookies';
+export { getCookie, setCookie, deleteCookie, getCurrencyFromCookieAsync, getCartIdFromCookieAsync, createBrowserCartCookieStore, } from './cookies';
 // Bot protection
 export { useBotProtection } from './hooks/use-bot-protection';
 // Generic hooks
@@ -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

@@ -1,27 +1,50 @@
 /**
- * Cart Store — DI-based cart state management with cookie persistence.
+ * Cart Store — DI-based cart state management with cookie persistence and
+ * automatic stale-cart recovery.
  *
- * SDK orchestrates cart lifecycle (init, mutations, error handling).
- * Template provides CartActions implementation via DI (getActions getter).
- * Cart ID persisted in cookie (SSR/edge visible) — follows currency store pattern.
+ * SDK orchestrates cart lifecycle (init, mutations, recovery, error handling).
+ * Template provides `CartActions` via DI (getActions getter). Cart id persisted
+ * in cookie (SSR/edge visible) — follows currency store pattern.
+ *
+ * Per-operation recovery strategy (DX-first — caller never thinks about it):
+ *
+ *   - **`addToCart`** auto-replays on stale-cart errors. If the template
+ *     implements the optional `actions.createCartWithLines`, recovery is atomic
+ *     (single `cartCreate({ lines })` round trip). Otherwise falls back to
+ *     `createCart()` + `addLines()` (2 round trips, same end result).
+ *
+ *   - **`updateQuantity`** and **`removeFromCart`** bail on stale-cart errors:
+ *     local cart id is cleared, `onExpired` listeners fire, error surfaces via
+ *     `onMutationError`. Replaying on a fresh empty cart would silently lose
+ *     user intent (the lineId no longer exists).
+ *
+ * Stale-cart detection inspects `err.userErrors[].code` (CART_NOT_FOUND /
+ * ALREADY_COMPLETED) — locale-proof, see {@link isCartRecoverableError}.
  *
  * @example
  * ```typescript
  * import { createCartStore, type CartActions } from '@doswiftly/storefront-sdk/react';
  *
  * const actions: CartActions = {
- *   fetchCart: async (cartId) => api.getCart(cartId),
- *   createCart: async () => api.createCart().then(c => c.id),
- *   addLines: async (cartId, lines) => api.addLines(cartId, lines),
- *   updateLines: async (cartId, lines) => api.updateLines(cartId, lines),
- *   removeLines: async (cartId, lineIds) => api.removeLines(cartId, lineIds),
+ *   fetchCart: (id) => api.getCart(id),
+ *   createCart: () => api.createCart().then(c => c.id),
+ *   addLines: (id, lines) => api.addLines(id, lines),
+ *   updateLines: (id, lines) => api.updateLines(id, lines),
+ *   removeLines: (id, ids) => api.removeLines(id, ids),
+ *   // optional — enables atomic add-to-cart recovery
+ *   createCartWithLines: (lines) => api.cartCreate({ lines }),
  * };
  *
- * const store = createCartStore({ getActions: () => actions });
+ * const store = createCartStore({
+ *   getActions: () => actions,
+ *   onExpired: (e) => toast.error('Koszyk wygasł, dodaj produkty ponownie'),
+ * });
  * ```
  */
 import type { CartLineInput, CartLineUpdateInput } from '../../core/cart/types';
+import { type CartExpiredEvent } from '../../core/cart/cart-recovery';
 export type { CartLineInput, CartLineUpdateInput } from '../../core/cart/types';
+export type { CartExpiredEvent } from '../../core/cart/cart-recovery';
 /** Minimal cart data returned by DI actions. */
 export interface CartData {
     id: string;
@@ -39,6 +62,16 @@ export interface CartActions {
     updateLines: (cartId: string, lines: CartLineUpdateInput[]) => Promise<CartData>;
     /** Remove line items. Return updated cart or throw. */
     removeLines: (cartId: string, lineIds: string[]) => Promise<CartData>;
+    /**
+     * Optional — atomic create-with-lines for stale-cart recovery. When provided,
+     * the store recovers from `CART_NOT_FOUND` / `ALREADY_COMPLETED` in a single
+     * `cartCreate({ lines })` round trip. When omitted, store falls back to
+     * `createCart()` + `addLines()` (2 round trips, identical outcome).
+     *
+     * Wire this when your GraphQL `cartCreate` mutation accepts an initial
+     * `lines` payload (DoSwiftly Storefront API does).
+     */
+    createCartWithLines?: (lines: CartLineInput[]) => Promise<CartData>;
 }
 /** Action names passed to mutation callbacks. */
 export type CartMutationAction = 'initCart' | 'addToCart' | 'updateQuantity' | 'removeFromCart';
@@ -49,6 +82,20 @@ export interface CartStoreConfig {
     onMutationSuccess?: (action: CartMutationAction, cart: CartData) => void;
     /** Called on mutation error. */
     onMutationError?: (action: CartMutationAction, error: unknown) => void;
+    /**
+     * Called when a stale-cart event terminates an operation:
+     *
+     *   - `state-dependent` — bail-on-stale operation (`updateQuantity`,
+     *     `removeFromCart`) cannot be safely replayed on a new cart.
+     *   - `recreate-failed` — recovery attempted but creating the replacement
+     *     cart failed (network / backend error).
+     *   - `retry-also-failed` — replacement cart also rejected by backend
+     *     (rare; usually indicates a backend race / bug).
+     *
+     * Typical UI usage: subscribe once globally and surface a toast / banner
+     * inviting the user to add products again.
+     */
+    onExpired?: (event: CartExpiredEvent) => void;
 }
 export interface CartState {
     cartId: string | null;

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":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAKhF,YAAY,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAMhF,gDAAgD;AAChD,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,uDAAuD;AACvD,MAAM,WAAW,WAAW;IAC1B,+DAA+D;IAC/D,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC;IACxD,iDAAiD;IACjD,UAAU,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IAClC,oDAAoD;IACpD,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,EAAE,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;IACxE,4DAA4D;IAC5D,WAAW,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,mBAAmB,EAAE,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;IACjF,uDAAuD;IACvD,WAAW,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;CACvE;AAMD,iDAAiD;AACjD,MAAM,MAAM,kBAAkB,GAAG,UAAU,GAAG,WAAW,GAAG,gBAAgB,GAAG,gBAAgB,CAAC;AAEhG,MAAM,WAAW,eAAe;IAC9B,wEAAwE;IACxE,UAAU,EAAE,MAAM,WAAW,CAAC;IAC9B,wCAAwC;IACxC,iBAAiB,CAAC,EAAE,CAAC,MAAM,EAAE,kBAAkB,EAAE,IAAI,EAAE,QAAQ,KAAK,IAAI,CAAC;IACzE,gCAAgC;IAChC,eAAe,CAAC,EAAE,CAAC,MAAM,EAAE,kBAAkB,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CACxE;AAMD,MAAM,WAAW,SAAS;IAExB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;IAGtB,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB,UAAU,EAAE,MAAM,IAAI,CAAC;IAGvB,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9B,SAAS,EAAE,CAAC,KAAK,EAAE,aAAa,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACrD,cAAc,EAAE,CAAC,KAAK,EAAE,mBAAmB,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAChE,cAAc,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACrD,SAAS,EAAE,MAAM,IAAI,CAAC;CACvB;AAMD,eAAO,MAAM,YAAY,GAAI,OAAO,SAAS,kBAAiB,CAAC;AAC/D,eAAO,MAAM,gBAAgB,GAAI,OAAO,SAAS,YAAiB,CAAC;AACnE,eAAO,MAAM,mBAAmB,GAAI,OAAO,SAAS,YAAoB,CAAC;AAMzE,wBAAgB,eAAe,CAAC,MAAM,EAAE,eAAe,yCAkJtD"}
+{"version":3,"file":"cart.store.d.ts","sourceRoot":"","sources":["../../../src/react/stores/cart.store.ts"],"names":[],"mappings":"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"}