@doswiftly/storefront-sdk 4.0.0

package/dist/core/operations/cart.js

@@ -0,0 +1,169 @@
+/**
+ * Cart GraphQL operations — manual query strings (no codegen).
+ *
+ * These match the backend storefront-graphql schema exactly.
+ * Cart mutations always return full Cart + userErrors.
+ */
+// ---------------------------------------------------------------------------
+// Fragments
+// ---------------------------------------------------------------------------
+const MONEY_FRAGMENT = `
+  fragment Money on Money {
+    amount
+    currencyCode
+  }
+`;
+const CART_COST_FRAGMENT = `
+  fragment CartCost on CartCost {
+    totalAmount { ...Money }
+    subtotalAmount { ...Money }
+    totalTaxAmount { ...Money }
+    totalDutyAmount { ...Money }
+  }
+`;
+const CART_LINE_FRAGMENT = `
+  fragment CartLineFields on CartLine {
+    id
+    quantity
+    merchandise {
+      id
+      title
+      sku
+      image { url altText }
+      price { ...Money }
+      compareAtPrice { ...Money }
+    }
+    cost {
+      totalAmount { ...Money }
+      amountPerQuantity { ...Money }
+      compareAtAmountPerQuantity { ...Money }
+    }
+    attributes { key value }
+    productId
+    productTitle
+    productHandle
+  }
+`;
+const CART_FRAGMENT = `
+  fragment CartFields on Cart {
+    id
+    checkoutUrl
+    totalQuantity
+    note
+    createdAt
+    updatedAt
+    cost { ...CartCost }
+    lines(first: 100) {
+      edges {
+        node { ...CartLineFields }
+      }
+    }
+    buyerIdentity {
+      email
+      phone
+      countryCode
+    }
+    discountCodes {
+      code
+      applicable
+    }
+    discountAllocations {
+      discountedAmount { ...Money }
+    }
+    attributes { key value }
+  }
+  ${MONEY_FRAGMENT}
+  ${CART_COST_FRAGMENT}
+  ${CART_LINE_FRAGMENT}
+`;
+const USER_ERROR_FRAGMENT = `
+  fragment UserErrorFields on UserError {
+    message
+    field
+    code
+  }
+`;
+// ---------------------------------------------------------------------------
+// Queries
+// ---------------------------------------------------------------------------
+export const CART_QUERY = `
+  query Cart($id: ID!) {
+    cart(id: $id) {
+      ...CartFields
+    }
+  }
+  ${CART_FRAGMENT}
+`;
+// ---------------------------------------------------------------------------
+// Mutations
+// ---------------------------------------------------------------------------
+export const CART_CREATE = `
+  mutation CartCreate($input: CartCreateInput) {
+    cartCreate(input: $input) {
+      cart { ...CartFields }
+      userErrors { ...UserErrorFields }
+    }
+  }
+  ${CART_FRAGMENT}
+  ${USER_ERROR_FRAGMENT}
+`;
+export const CART_LINES_ADD = `
+  mutation CartLinesAdd($cartId: ID!, $lines: [CartLineInput!]!) {
+    cartLinesAdd(cartId: $cartId, lines: $lines) {
+      cart { ...CartFields }
+      userErrors { ...UserErrorFields }
+    }
+  }
+  ${CART_FRAGMENT}
+  ${USER_ERROR_FRAGMENT}
+`;
+export const CART_LINES_UPDATE = `
+  mutation CartLinesUpdate($cartId: ID!, $lines: [CartLineUpdateInput!]!) {
+    cartLinesUpdate(cartId: $cartId, lines: $lines) {
+      cart { ...CartFields }
+      userErrors { ...UserErrorFields }
+    }
+  }
+  ${CART_FRAGMENT}
+  ${USER_ERROR_FRAGMENT}
+`;
+export const CART_LINES_REMOVE = `
+  mutation CartLinesRemove($cartId: ID!, $lineIds: [ID!]!) {
+    cartLinesRemove(cartId: $cartId, lineIds: $lineIds) {
+      cart { ...CartFields }
+      userErrors { ...UserErrorFields }
+    }
+  }
+  ${CART_FRAGMENT}
+  ${USER_ERROR_FRAGMENT}
+`;
+export const CART_DISCOUNT_CODES_UPDATE = `
+  mutation CartDiscountCodesUpdate($cartId: ID!, $discountCodes: [String!]!) {
+    cartDiscountCodesUpdate(cartId: $cartId, discountCodes: $discountCodes) {
+      cart { ...CartFields }
+      userErrors { ...UserErrorFields }
+    }
+  }
+  ${CART_FRAGMENT}
+  ${USER_ERROR_FRAGMENT}
+`;
+export const CART_NOTE_UPDATE = `
+  mutation CartNoteUpdate($cartId: ID!, $note: String!) {
+    cartNoteUpdate(cartId: $cartId, note: $note) {
+      cart { ...CartFields }
+      userErrors { ...UserErrorFields }
+    }
+  }
+  ${CART_FRAGMENT}
+  ${USER_ERROR_FRAGMENT}
+`;
+export const CART_BUYER_IDENTITY_UPDATE = `
+  mutation CartBuyerIdentityUpdate($cartId: ID!, $buyerIdentity: CartBuyerIdentityInput!) {
+    cartBuyerIdentityUpdate(cartId: $cartId, buyerIdentity: $buyerIdentity) {
+      cart { ...CartFields }
+      userErrors { ...UserErrorFields }
+    }
+  }
+  ${CART_FRAGMENT}
+  ${USER_ERROR_FRAGMENT}
+`;

package/dist/index.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @doswiftly/storefront-sdk v4.0.0
+ *
+ * Layered SDK — Hydrogen-aligned architecture.
+ *
+ * Entry points:
+ *   "."              → Core (framework-agnostic, 0 deps)
+ *   "./react"        → React adapter (providers, stores, hooks)
+ *   "./react/stores" → Zustand stores (direct import)
+ *   "./react/server" → Server-side client factory
+ *   "./cache"        → Cache strategies
+ *
+ * @example Core (CLI, Edge, Remix, Astro — no React)
+ * ```typescript
+ * import { createStorefrontClient, CartClient, errorMiddleware } from '@doswiftly/storefront-sdk';
+ * ```
+ *
+ * @example React
+ * ```tsx
+ * import { StorefrontProvider, useAuth, useCartManager } from '@doswiftly/storefront-sdk/react';
+ * ```
+ */
+export * from './core';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAGH,cAAc,QAAQ,CAAC"}

package/dist/index.js

@@ -0,0 +1,24 @@
+/**
+ * @doswiftly/storefront-sdk v4.0.0
+ *
+ * Layered SDK — Hydrogen-aligned architecture.
+ *
+ * Entry points:
+ *   "."              → Core (framework-agnostic, 0 deps)
+ *   "./react"        → React adapter (providers, stores, hooks)
+ *   "./react/stores" → Zustand stores (direct import)
+ *   "./react/server" → Server-side client factory
+ *   "./cache"        → Cache strategies
+ *
+ * @example Core (CLI, Edge, Remix, Astro — no React)
+ * ```typescript
+ * import { createStorefrontClient, CartClient, errorMiddleware } from '@doswiftly/storefront-sdk';
+ * ```
+ *
+ * @example React
+ * ```tsx
+ * import { StorefrontProvider, useAuth, useCartManager } from '@doswiftly/storefront-sdk/react';
+ * ```
+ */
+// Re-export everything from core
+export * from './core';

package/dist/react/cookies.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Cookie utilities for SDK consumers.
+ *
+ * Simple, framework-agnostic cookie read/write for client-side.
+ * For Next.js server-side cookies, use `cookies()` from next/headers.
+ */
+/**
+ * Get cookie value by name (client-side only).
+ */
+export declare function getCookie(name: string): string | null;
+/**
+ * Set cookie (client-side only).
+ */
+export declare function setCookie(name: string, value: string, options?: {
+    maxAge?: number;
+    path?: string;
+    sameSite?: string;
+}): void;
+/**
+ * Delete cookie (client-side only).
+ */
+export declare function deleteCookie(name: string, path?: string): void;
+/**
+ * Get preferred currency from cookie (async — works with Next.js cookies()).
+ * Falls back to document.cookie on client.
+ */
+export declare function getCurrencyFromCookieAsync(): Promise<string | null>;
+//# sourceMappingURL=cookies.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cookies.d.ts","sourceRoot":"","sources":["../../src/react/cookies.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAIrD;AAED;;GAEG;AACH,wBAAgB,SAAS,CACvB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAO,GAClE,IAAI,CAIN;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,SAAM,GAAG,IAAI,CAG3D;AAED;;;GAGG;AACH,wBAAsB,0BAA0B,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAYzE"}

package/dist/react/cookies.js

@@ -0,0 +1,49 @@
+/**
+ * Cookie utilities for SDK consumers.
+ *
+ * Simple, framework-agnostic cookie read/write for client-side.
+ * For Next.js server-side cookies, use `cookies()` from next/headers.
+ */
+/**
+ * Get cookie value by name (client-side only).
+ */
+export function getCookie(name) {
+    if (typeof document === 'undefined')
+        return null;
+    const match = document.cookie.match(new RegExp(`(?:^|;\\s*)${name}=([^;]*)`));
+    return match ? decodeURIComponent(match[1]) : null;
+}
+/**
+ * Set cookie (client-side only).
+ */
+export function setCookie(name, value, options = {}) {
+    if (typeof document === 'undefined')
+        return;
+    const { maxAge = 365 * 24 * 60 * 60, path = '/', sameSite = 'lax' } = options;
+    document.cookie = `${name}=${encodeURIComponent(value)};max-age=${maxAge};path=${path};samesite=${sameSite}`;
+}
+/**
+ * Delete cookie (client-side only).
+ */
+export function deleteCookie(name, path = '/') {
+    if (typeof document === 'undefined')
+        return;
+    document.cookie = `${name}=;max-age=0;path=${path}`;
+}
+/**
+ * Get preferred currency from cookie (async — works with Next.js cookies()).
+ * Falls back to document.cookie on client.
+ */
+export async function getCurrencyFromCookieAsync() {
+    // Server-side: try Next.js cookies()
+    try {
+        const { cookies } = await import('next/headers');
+        const cookieStore = await cookies();
+        return cookieStore.get('preferred-currency')?.value ?? null;
+    }
+    catch {
+        // Not in a server context or next not available
+    }
+    // Client-side fallback
+    return getCookie('preferred-currency');
+}

package/dist/react/helpers/create-store-context.d.ts

@@ -0,0 +1,37 @@
+import { type ReactNode } from 'react';
+import { type StoreApi } from 'zustand';
+/**
+ * Create a Context-based Zustand store pattern.
+ *
+ * Returns Provider, useStore hook, and useApi hook — eliminates
+ * module-level singleton boilerplate (Turbopack duplication bug).
+ *
+ * @example
+ * ```ts
+ * const { Provider: CartProvider, useStore: useCartStore, useApi: useCartStoreApi } =
+ *   createStoreContext<CartState>('CartStore');
+ *
+ * // In layout:
+ * const cartStore = useRef(createCartStore());
+ * <CartProvider store={cartStore.current}>{children}</CartProvider>
+ *
+ * // In components:
+ * const isOpen = useCartStore((s) => s.isOpen);
+ * const api = useCartStoreApi(); // for .getState() in callbacks
+ * ```
+ */
+export declare function createStoreContext<T>(displayName: string): {
+    readonly Provider: {
+        ({ store, children }: {
+            store: StoreApi<T>;
+            children: ReactNode;
+        }): import("react").FunctionComponentElement<import("react").ProviderProps<StoreApi<T> | null>>;
+        displayName: string;
+    };
+    readonly useStore: {
+        (): T;
+        <U>(selector: (s: T) => U): U;
+    };
+    readonly useApi: () => StoreApi<T>;
+};
+//# sourceMappingURL=create-store-context.d.ts.map

package/dist/react/helpers/create-store-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-store-context.d.ts","sourceRoot":"","sources":["../../../src/react/helpers/create-store-context.ts"],"names":[],"mappings":"AAEA,OAAO,EAA4C,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AACjF,OAAO,EAAY,KAAK,QAAQ,EAAE,MAAM,SAAS,CAAC;AAElD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,WAAW,EAAE,MAAM;;8BAIhB;YAAE,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;YAAC,QAAQ,EAAE,SAAS,CAAA;SAAE;;;;YAMzD,CAAC;SACJ,CAAC,YAAY,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC;;2BAU/B,QAAQ,CAAC,CAAC,CAAC;EAS/B"}

package/dist/react/helpers/create-store-context.js

@@ -0,0 +1,47 @@
+'use client';
+import { createContext, useContext, createElement } from 'react';
+import { useStore } from 'zustand';
+/**
+ * Create a Context-based Zustand store pattern.
+ *
+ * Returns Provider, useStore hook, and useApi hook — eliminates
+ * module-level singleton boilerplate (Turbopack duplication bug).
+ *
+ * @example
+ * ```ts
+ * const { Provider: CartProvider, useStore: useCartStore, useApi: useCartStoreApi } =
+ *   createStoreContext<CartState>('CartStore');
+ *
+ * // In layout:
+ * const cartStore = useRef(createCartStore());
+ * <CartProvider store={cartStore.current}>{children}</CartProvider>
+ *
+ * // In components:
+ * const isOpen = useCartStore((s) => s.isOpen);
+ * const api = useCartStoreApi(); // for .getState() in callbacks
+ * ```
+ */
+export function createStoreContext(displayName) {
+    const StoreContext = createContext(null);
+    StoreContext.displayName = displayName;
+    function Provider({ store, children }) {
+        return createElement(StoreContext.Provider, { value: store }, children);
+    }
+    Provider.displayName = `${displayName}Provider`;
+    function useStoreHook(selector) {
+        const store = useContext(StoreContext);
+        if (!store) {
+            throw new Error(`${displayName}: useStore must be used within its Provider`);
+        }
+        // eslint-disable-next-line react-hooks/rules-of-hooks
+        return selector ? useStore(store, selector) : useStore(store);
+    }
+    function useApi() {
+        const store = useContext(StoreContext);
+        if (!store) {
+            throw new Error(`${displayName}: useApi must be used within its Provider`);
+        }
+        return store;
+    }
+    return { Provider, useStore: useStoreHook, useApi };
+}

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

@@ -0,0 +1,65 @@
+/**
+ * useAuth — wraps AuthClient + updates auth store.
+ *
+ * Centralizes login/logout/renew with dual-layer persistence:
+ * - httpOnly cookie (for SSR/middleware) — via onSetToken/onClearToken callbacks
+ * - Zustand store (for client-side state)
+ *
+ * Does NOT use React Query — plain async + store updates.
+ * Template can wrap in useMutation() if React Query features are needed.
+ *
+ * @example
+ * ```tsx
+ * const { login, logout, isLoading } = useAuth();
+ *
+ * const result = await login('user@example.com', 'password');
+ * if (result.success) router.push('/account');
+ * ```
+ */
+export interface UseAuthOptions {
+    /**
+     * Called after successful login/renewToken with the new access token.
+     * Use to set httpOnly cookie via API route.
+     */
+    onSetToken?: (token: string) => Promise<void>;
+    /**
+     * Called after logout to clear httpOnly cookie.
+     */
+    onClearToken?: () => Promise<void>;
+}
+export interface LoginResult {
+    success: boolean;
+    userErrors: Array<{
+        message: string;
+        field?: string[];
+    }>;
+    accessToken?: string;
+    expiresAt?: string;
+}
+export interface LogoutResult {
+    success: boolean;
+    userErrors: Array<{
+        message: string;
+        field?: string[];
+    }>;
+}
+export interface TokenRenewResult {
+    success: boolean;
+    userErrors: Array<{
+        message: string;
+        field?: string[];
+    }>;
+    accessToken?: string;
+    expiresAt?: string;
+}
+export declare function useAuth(options?: UseAuthOptions): {
+    login: (email: string, password: string) => Promise<LoginResult>;
+    logout: () => Promise<LogoutResult>;
+    renewToken: () => Promise<TokenRenewResult>;
+    isLoggingIn: boolean;
+    isLoggingOut: boolean;
+    isRenewingToken: boolean;
+    isLoading: boolean;
+    error: string | null;
+};
+//# sourceMappingURL=use-auth.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-auth.d.ts","sourceRoot":"","sources":["../../../src/react/hooks/use-auth.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AASH,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACpC;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,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,gBAAgB;IAC/B,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,wBAAgB,OAAO,CAAC,OAAO,GAAE,cAAmB;mBAUV,MAAM,YAAY,MAAM,KAAG,OAAO,CAAC,WAAW,CAAC;kBA2DlD,OAAO,CAAC,YAAY,CAAC;sBA6BjB,OAAO,CAAC,gBAAgB,CAAC;;;;;;EA8DnE"}

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

@@ -0,0 +1,168 @@
+/**
+ * useAuth — wraps AuthClient + updates auth store.
+ *
+ * Centralizes login/logout/renew with dual-layer persistence:
+ * - httpOnly cookie (for SSR/middleware) — via onSetToken/onClearToken callbacks
+ * - Zustand store (for client-side state)
+ *
+ * Does NOT use React Query — plain async + store updates.
+ * Template can wrap in useMutation() if React Query features are needed.
+ *
+ * @example
+ * ```tsx
+ * const { login, logout, isLoading } = useAuth();
+ *
+ * const result = await login('user@example.com', 'password');
+ * if (result.success) router.push('/account');
+ * ```
+ */
+'use client';
+import { useState, useCallback } from 'react';
+import { useStorefrontClientContext } from '../providers/storefront-client-provider';
+import { useAuthStore, useAuthStoreApi } from '../stores/store-context';
+import { StorefrontError } from '../../core/errors';
+export function useAuth(options = {}) {
+    const { authClient } = useStorefrontClientContext();
+    const { setAuth, clearAuth } = useAuthStore();
+    const authStore = useAuthStoreApi();
+    const [isLoggingIn, setIsLoggingIn] = useState(false);
+    const [isLoggingOut, setIsLoggingOut] = useState(false);
+    const [isRenewingToken, setIsRenewingToken] = 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);
+            // Set httpOnly cookie
+            if (options.onSetToken) {
+                await options.onSetToken(result.accessToken);
+            }
+            // Fetch customer data and set store
+            try {
+                const customer = await authClient.getCustomer(result.accessToken);
+                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 {
+                // Customer fetch failed — store minimal data
+                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]);
+    const logout = useCallback(async () => {
+        setError(null);
+        setIsLoggingOut(true);
+        try {
+            const token = authStore.getState().accessToken;
+            if (token) {
+                await authClient.logout(token);
+            }
+            // Clear httpOnly cookie
+            if (options.onClearToken) {
+                await options.onClearToken();
+            }
+            clearAuth();
+            return { success: true, userErrors: [] };
+        }
+        catch (err) {
+            // Even on error, clear local state
+            clearAuth();
+            const message = err instanceof Error ? err.message : 'Logout failed';
+            setError(message);
+            return { success: false, userErrors: [{ message }] };
+        }
+        finally {
+            setIsLoggingOut(false);
+        }
+    }, [authClient, clearAuth, options, authStore]);
+    const renewToken = useCallback(async () => {
+        setError(null);
+        setIsRenewingToken(true);
+        try {
+            const token = authStore.getState().accessToken;
+            if (!token) {
+                return {
+                    success: false,
+                    userErrors: [{ message: 'No token to renew' }],
+                };
+            }
+            const result = await authClient.renewToken(token);
+            // Update httpOnly cookie
+            if (options.onSetToken) {
+                await options.onSetToken(result.accessToken);
+            }
+            // Update store (keep customer data, update token)
+            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 {
+            setIsRenewingToken(false);
+        }
+    }, [authClient, setAuth, options, authStore]);
+    return {
+        login,
+        logout,
+        renewToken,
+        isLoggingIn,
+        isLoggingOut,
+        isRenewingToken,
+        isLoading: isLoggingIn || isLoggingOut || isRenewingToken,
+        error,
+    };
+}

package/dist/react/hooks/use-cart-manager.d.ts

@@ -0,0 +1,30 @@
+/**
+ * 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 }]);
+ * ```
+ */
+import type { Cart, CartLineInput, CartLineUpdateInput } from '../../core/cart/types';
+export declare function useCartManager(): {
+    getCart: () => Promise<Cart | null>;
+    addItem: (lines: CartLineInput[], options?: {
+        forceNewCart?: boolean;
+    }) => Promise<Cart>;
+    updateItem: (lines: CartLineUpdateInput[]) => Promise<Cart>;
+    removeItem: (lineIds: string[]) => Promise<Cart>;
+    updateDiscountCodes: (codes: string[]) => Promise<Cart>;
+    updateNote: (note: string) => Promise<Cart>;
+    clearCart: () => void;
+    getCartId: () => string | null;
+    isLoading: boolean;
+    error: string | null;
+};
+//# sourceMappingURL=use-cart-manager.d.ts.map

package/dist/react/hooks/use-cart-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-cart-manager.d.ts","sourceRoot":"","sources":["../../../src/react/hooks/use-cart-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAMH,OAAO,KAAK,EAAE,IAAI,EAAE,aAAa,EAAE,mBAAmB,EAA2C,MAAM,uBAAuB,CAAC;AAwB/H,wBAAgB,cAAc;mBAiCU,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;qBAoBjD,aAAa,EAAE,YACZ;QAAE,YAAY,CAAC,EAAE,OAAO,CAAA;KAAE,KACnC,OAAO,CAAC,IAAI,CAAC;wBA0BP,mBAAmB,EAAE,KAC3B,OAAO,CAAC,IAAI,CAAC;0BAuB+B,MAAM,EAAE,KAAG,OAAO,CAAC,IAAI,CAAC;iCAuBjB,MAAM,EAAE,KAAG,OAAO,CAAC,IAAI,CAAC;uBAoBlC,MAAM,KAAG,OAAO,CAAC,IAAI,CAAC;;qBA2BhC,MAAM,GAAG,IAAI;;;EAiBhD"}