@shopbb/helium 0.3.1 → 0.4.0

package/dist/components/DiscountProvider.js

@@ -0,0 +1,317 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * <DiscountProvider> + useDiscounts() + useProductDiscounts()
+ *
+ * 优惠券完整能力：
+ *   - publicDiscounts: 公开可领的券（storefront 首页 / cart 展示）
+ *   - myDiscounts: 我领过的有效券（卡包）
+ *   - claim(code): 领取
+ *   - cart 上的折扣：appliedToCart / applyToCart / removeFromCart
+ *   - bestApplicableForCart: 当前 cart 最大可省（哪张最划算）
+ *
+ * 内部走 Storefront GraphQL + Customer Account GraphQL。
+ */
+import * as React from 'react';
+import { useShop } from './ShopProvider';
+import { useCartOptional } from './CartProvider';
+const Ctx = React.createContext(null);
+const DEFAULT_TOKEN_KEY = 'shopbb:buyer_token';
+export function DiscountProvider(props) {
+    const { children, fetchPublicOnMount = true, fetchMyOnMount = true, tokenProvider } = props;
+    const shop = useShop();
+    const cartCtx = useCartOptional();
+    const [publicDiscounts, setPublicDiscounts] = React.useState([]);
+    const [publicDiscountsStatus, setPublicDiscountsStatus] = React.useState('idle');
+    const [myDiscounts, setMyDiscounts] = React.useState([]);
+    const [myDiscountsStatus, setMyDiscountsStatus] = React.useState('idle');
+    const [error, setError] = React.useState(null);
+    const customerEndpoint = React.useMemo(() => {
+        try {
+            const u = new URL(shop.apiUrl);
+            return `${u.origin}/customer/api/2026-04/graphql`;
+        }
+        catch {
+            return shop.apiUrl;
+        }
+    }, [shop.apiUrl]);
+    const getToken = React.useCallback(() => {
+        if (tokenProvider)
+            return tokenProvider();
+        if (typeof localStorage === 'undefined')
+            return null;
+        return localStorage.getItem(DEFAULT_TOKEN_KEY) || localStorage.getItem('shopflare:buyer_token');
+    }, [tokenProvider]);
+    const storefrontGql = React.useCallback(async (query, variables) => {
+        const res = await fetch(shop.apiUrl, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'X-Storefront-Access-Token': shop.storefrontAccessToken,
+            },
+            body: JSON.stringify({ query, variables }),
+            credentials: 'include',
+        });
+        return res.json();
+    }, [shop.apiUrl, shop.storefrontAccessToken]);
+    const customerGql = React.useCallback(async (query, variables) => {
+        const token = getToken();
+        if (!token)
+            throw new Error('not authenticated');
+        const res = await fetch(customerEndpoint, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json', Authorization: `Bearer ${token}` },
+            body: JSON.stringify({ query, variables }),
+        });
+        return res.json();
+    }, [customerEndpoint, getToken]);
+    // ----- public discounts -----
+    const refetchPublicDiscounts = React.useCallback(async () => {
+        setPublicDiscountsStatus('loading');
+        try {
+            const result = await storefrontGql(`query { publicDiscounts(first: 50) {
+           nodes {
+             id code title description distribution appliesTo
+             valueType
+             value {
+               __typename
+               ... on DiscountPercentage { percentage }
+               ... on DiscountAmount { amount { amount currencyCode } }
+               ... on DiscountFreeShipping { freeShipping }
+             }
+             minSubtotal { amount currencyCode }
+             startsAt endsAt
+             bannerImage { url altText }
+           }
+         } }`);
+            if (result.errors?.length)
+                throw new Error(result.errors[0].message);
+            setPublicDiscounts(result.data?.publicDiscounts?.nodes ?? []);
+            setPublicDiscountsStatus('idle');
+        }
+        catch (e) {
+            setError(e?.message);
+            setPublicDiscountsStatus('error');
+        }
+    }, [storefrontGql]);
+    // ----- my discounts -----
+    const refetchMyDiscounts = React.useCallback(async () => {
+        const token = getToken();
+        if (!token) {
+            setMyDiscountsStatus('unauthenticated');
+            setMyDiscounts([]);
+            return;
+        }
+        setMyDiscountsStatus('loading');
+        try {
+            const result = await customerGql(`query { customer { discountClaims(first: 50) {
+           nodes {
+             id claimedAt usedCount remainingUses expiresAt isExpired
+             discount {
+               id code title description
+               valueType valuePercentage
+               valueAmount { amount currencyCode }
+               minSubtotal { amount currencyCode }
+               endsAt bannerImage
+             }
+           }
+         } } }`);
+            if (result.errors?.length)
+                throw new Error(result.errors[0].message);
+            setMyDiscounts(result.data?.customer?.discountClaims?.nodes ?? []);
+            setMyDiscountsStatus('idle');
+        }
+        catch (e) {
+            setError(e?.message);
+            setMyDiscountsStatus('error');
+        }
+    }, [customerGql, getToken]);
+    React.useEffect(() => {
+        if (fetchPublicOnMount)
+            void refetchPublicDiscounts();
+    }, [fetchPublicOnMount, refetchPublicDiscounts]);
+    React.useEffect(() => {
+        if (fetchMyOnMount)
+            void refetchMyDiscounts();
+    }, [fetchMyOnMount, refetchMyDiscounts]);
+    // ----- claim -----
+    const claim = React.useCallback(async (code) => {
+        try {
+            const result = await customerGql(`mutation C($code: String!) {
+             discountClaim(code: $code) {
+               discountClaim {
+                 id claimedAt usedCount remainingUses expiresAt isExpired
+                 discount {
+                   id code title valueType valuePercentage
+                   valueAmount { amount currencyCode }
+                   minSubtotal { amount currencyCode }
+                 }
+               }
+               userErrors { field code message }
+             }
+           }`, { code });
+            if (result.errors?.length)
+                throw new Error(result.errors[0].message);
+            await refetchMyDiscounts();
+            const payload = result.data.discountClaim;
+            return { claim: payload.discountClaim ?? undefined, userErrors: payload.userErrors };
+        }
+        catch (e) {
+            return { userErrors: [{ code: 'NETWORK_ERROR', message: e?.message ?? String(e) }] };
+        }
+    }, [customerGql, refetchMyDiscounts]);
+    // ----- cart apply / remove -----
+    const appliedToCart = cartCtx?.cart && cartCtx.cart.discountCodes ? cartCtx.cart.discountCodes : [];
+    const cartAllocations = cartCtx?.cart && cartCtx.cart.discountAllocations ? cartCtx.cart.discountAllocations : [];
+    const applyCodes = React.useCallback(async (codes) => {
+        if (!cartCtx?.cart)
+            return { userErrors: [{ code: 'NO_CART', message: 'cart 不存在' }] };
+        const result = await storefrontGql(`mutation U($id: ID!, $codes: [String!]!) {
+           cartDiscountCodesUpdate(cartId: $id, discountCodes: $codes) {
+             cart { id }
+             userErrors { field code message }
+           }
+         }`, { id: cartCtx.cart.id, codes });
+        if (result.errors?.length) {
+            return { userErrors: [{ code: 'NETWORK_ERROR', message: result.errors[0].message }] };
+        }
+        // 刷 cart（拉新的 discountCodes / allocations）
+        await cartCtx.refetch();
+        return { userErrors: result.data.cartDiscountCodesUpdate.userErrors };
+    }, [cartCtx, storefrontGql]);
+    const applyToCart = React.useCallback(async (code) => {
+        const existing = appliedToCart.map((d) => d.code);
+        if (existing.includes(code.toUpperCase()))
+            return { userErrors: [] };
+        return applyCodes([...existing, code.toUpperCase()]);
+    }, [appliedToCart, applyCodes]);
+    const removeFromCart = React.useCallback(async (code) => {
+        const next = appliedToCart.map((d) => d.code).filter((c) => c !== code.toUpperCase());
+        return applyCodes(next);
+    }, [appliedToCart, applyCodes]);
+    // ----- best applicable for cart -----
+    const bestApplicableForCart = React.useMemo(() => {
+        if (!cartCtx?.cart || myDiscounts.length === 0)
+            return null;
+        const subtotalStr = cartCtx.cart.cost?.subtotalAmount?.amount;
+        const subtotal = Number(subtotalStr || 0);
+        if (subtotal <= 0)
+            return null;
+        const currentApplied = new Set(appliedToCart.map((d) => d.code));
+        let best = null;
+        for (const claimed of myDiscounts) {
+            const d = claimed.discount;
+            if (!d.code || claimed.isExpired)
+                continue;
+            if (currentApplied.has(d.code))
+                continue;
+            // 门槛
+            if (d.minSubtotal && Number(d.minSubtotal.amount) > subtotal)
+                continue;
+            // 估算折扣
+            let amount = 0;
+            if (d.valueType === 'PERCENTAGE' && d.valuePercentage != null) {
+                amount = Math.floor(subtotal * (d.valuePercentage / 100) * 100) / 100;
+            }
+            else if (d.valueType === 'FIXED_AMOUNT' && d.valueAmount) {
+                amount = Math.min(Number(d.valueAmount.amount), subtotal);
+            }
+            if (amount > 0 && (best == null || amount > best.estimatedAmount)) {
+                best = { discount: claimed, estimatedAmount: amount };
+            }
+        }
+        return best;
+    }, [cartCtx, myDiscounts, appliedToCart]);
+    const value = React.useMemo(() => ({
+        publicDiscounts, publicDiscountsStatus,
+        myDiscounts, myDiscountsStatus,
+        appliedToCart, cartAllocations,
+        bestApplicableForCart,
+        error,
+        claim, applyToCart, removeFromCart,
+        refetchMyDiscounts, refetchPublicDiscounts,
+    }), [
+        publicDiscounts, publicDiscountsStatus,
+        myDiscounts, myDiscountsStatus,
+        appliedToCart, cartAllocations,
+        bestApplicableForCart, error,
+        claim, applyToCart, removeFromCart,
+        refetchMyDiscounts, refetchPublicDiscounts,
+    ]);
+    return _jsx(Ctx.Provider, { value: value, children: children });
+}
+export function useDiscounts() {
+    const v = React.useContext(Ctx);
+    if (!v)
+        throw new Error('useDiscounts must be used inside <DiscountProvider>');
+    return v;
+}
+export function useDiscountsOptional() {
+    return React.useContext(Ctx);
+}
+// ============================================================
+// useProductDiscounts(handle) — 商品页用
+// ============================================================
+export function useProductDiscounts(productHandle) {
+    const shop = useShop();
+    const [discounts, setDiscounts] = React.useState([]);
+    const [loading, setLoading] = React.useState(false);
+    const [error, setError] = React.useState(null);
+    React.useEffect(() => {
+        if (!productHandle) {
+            setDiscounts([]);
+            return;
+        }
+        let cancelled = false;
+        setLoading(true);
+        (async () => {
+            try {
+                const res = await fetch(shop.apiUrl, {
+                    method: 'POST',
+                    headers: {
+                        'Content-Type': 'application/json',
+                        'X-Storefront-Access-Token': shop.storefrontAccessToken,
+                    },
+                    body: JSON.stringify({
+                        query: `query P($h: String!) {
+               productDiscounts(productHandle: $h) {
+                 id code title description
+                 valueType
+                 value {
+                   __typename
+                   ... on DiscountPercentage { percentage }
+                   ... on DiscountAmount { amount { amount currencyCode } }
+                   ... on DiscountFreeShipping { freeShipping }
+                 }
+                 minSubtotal { amount currencyCode }
+                 endsAt
+                 bannerImage { url }
+               }
+             }`,
+                        variables: { h: productHandle },
+                    }),
+                    credentials: 'include',
+                });
+                const r = await res.json();
+                if (cancelled)
+                    return;
+                if (r.errors?.length) {
+                    setError(r.errors[0].message);
+                }
+                else {
+                    setDiscounts(r.data?.productDiscounts ?? []);
+                }
+            }
+            catch (e) {
+                if (!cancelled)
+                    setError(e?.message);
+            }
+            finally {
+                if (!cancelled)
+                    setLoading(false);
+            }
+        })();
+        return () => { cancelled = true; };
+    }, [productHandle, shop.apiUrl, shop.storefrontAccessToken]);
+    return { discounts, loading, error };
+}
+//# sourceMappingURL=DiscountProvider.js.map

package/dist/components/DiscountProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DiscountProvider.js","sourceRoot":"","sources":["../../src/components/DiscountProvider.tsx"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AA2FjD,MAAM,GAAG,GAAG,KAAK,CAAC,aAAa,CAA8B,IAAI,CAAC,CAAC;AAgBnE,MAAM,iBAAiB,GAAG,oBAAoB,CAAC;AAE/C,MAAM,UAAU,gBAAgB,CAAC,KAA4B;IAC3D,MAAM,EAAE,QAAQ,EAAE,kBAAkB,GAAG,IAAI,EAAE,cAAc,GAAG,IAAI,EAAE,aAAa,EAAE,GAAG,KAAK,CAAC;IAC5F,MAAM,IAAI,GAAG,OAAO,EAAE,CAAC;IACvB,MAAM,OAAO,GAAG,eAAe,EAAE,CAAC;IAElC,MAAM,CAAC,eAAe,EAAE,kBAAkB,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAa,EAAE,CAAC,CAAC;IAC7E,MAAM,CAAC,qBAAqB,EAAE,wBAAwB,CAAC,GAAG,KAAK,CAAC,QAAQ,CAA+B,MAAM,CAAC,CAAC;IAC/G,MAAM,CAAC,WAAW,EAAE,cAAc,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAkB,EAAE,CAAC,CAAC;IAC1E,MAAM,CAAC,iBAAiB,EAAE,oBAAoB,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAmD,MAAM,CAAC,CAAC;IAC3H,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAgB,IAAI,CAAC,CAAC;IAE9D,MAAM,gBAAgB,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE;QAC1C,IAAI,CAAC;YACH,MAAM,CAAC,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAC/B,OAAO,GAAG,CAAC,CAAC,MAAM,+BAA+B,CAAC;QACpD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC,MAAM,CAAC;QACrB,CAAC;IACH,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;IAElB,MAAM,QAAQ,GAAG,KAAK,CAAC,WAAW,CAAC,GAAG,EAAE;QACtC,IAAI,aAAa;YAAE,OAAO,aAAa,EAAE,CAAC;QAC1C,IAAI,OAAO,YAAY,KAAK,WAAW;YAAE,OAAO,IAAI,CAAC;QACrD,OAAO,YAAY,CAAC,OAAO,CAAC,iBAAiB,CAAC,IAAI,YAAY,CAAC,OAAO,CAAC,uBAAuB,CAAC,CAAC;IAClG,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC;IAEpB,MAAM,aAAa,GAAG,KAAK,CAAC,WAAW,CACrC,KAAK,EAAW,KAAa,EAAE,SAAe,EAAyC,EAAE;QACvF,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE;YACnC,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;gBAClC,2BAA2B,EAAE,IAAI,CAAC,qBAAqB;aACxD;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;YAC1C,WAAW,EAAE,SAAS;SACvB,CAAC,CAAC;QACH,OAAO,GAAG,CAAC,IAAI,EAAE,CAAC;IACpB,CAAC,EACD,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,qBAAqB,CAAC,CAC1C,CAAC;IAEF,MAAM,WAAW,GAAG,KAAK,CAAC,WAAW,CACnC,KAAK,EAAW,KAAa,EAAE,SAAe,EAAyC,EAAE;QACvF,MAAM,KAAK,GAAG,QAAQ,EAAE,CAAC;QACzB,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC;QACjD,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,gBAAgB,EAAE;YACxC,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,aAAa,EAAE,UAAU,KAAK,EAAE,EAAE;YACjF,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;SAC3C,CAAC,CAAC;QACH,OAAO,GAAG,CAAC,IAAI,EAAE,CAAC;IACpB,CAAC,EACD,CAAC,gBAAgB,EAAE,QAAQ,CAAC,CAC7B,CAAC;IAEF,+BAA+B;IAC/B,MAAM,sBAAsB,GAAG,KAAK,CAAC,WAAW,CAAC,KAAK,IAAI,EAAE;QAC1D,wBAAwB,CAAC,SAAS,CAAC,CAAC;QACpC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,aAAa,CAChC;;;;;;;;;;;;;;aAcK,CACN,CAAC;YACF,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM;gBAAE,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;YACrE,kBAAkB,CAAC,MAAM,CAAC,IAAI,EAAE,eAAe,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;YAC9D,wBAAwB,CAAC,MAAM,CAAC,CAAC;QACnC,CAAC;QAAC,OAAO,CAAM,EAAE,CAAC;YAChB,QAAQ,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;YACrB,wBAAwB,CAAC,OAAO,CAAC,CAAC;QACpC,CAAC;IACH,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC;IAEpB,2BAA2B;IAC3B,MAAM,kBAAkB,GAAG,KAAK,CAAC,WAAW,CAAC,KAAK,IAAI,EAAE;QACtD,MAAM,KAAK,GAAG,QAAQ,EAAE,CAAC;QACzB,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,oBAAoB,CAAC,iBAAiB,CAAC,CAAC;YACxC,cAAc,CAAC,EAAE,CAAC,CAAC;YACnB,OAAO;QACT,CAAC;QACD,oBAAoB,CAAC,SAAS,CAAC,CAAC;QAChC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,WAAW,CAC9B;;;;;;;;;;;eAWO,CACR,CAAC;YACF,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM;gBAAE,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;YACrE,cAAc,CAAC,MAAM,CAAC,IAAI,EAAE,QAAQ,EAAE,cAAc,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;YACnE,oBAAoB,CAAC,MAAM,CAAC,CAAC;QAC/B,CAAC;QAAC,OAAO,CAAM,EAAE,CAAC;YAChB,QAAQ,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;YACrB,oBAAoB,CAAC,OAAO,CAAC,CAAC;QAChC,CAAC;IACH,CAAC,EAAE,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC,CAAC;IAE5B,KAAK,CAAC,SAAS,CAAC,GAAG,EAAE;QACnB,IAAI,kBAAkB;YAAE,KAAK,sBAAsB,EAAE,CAAC;IACxD,CAAC,EAAE,CAAC,kBAAkB,EAAE,sBAAsB,CAAC,CAAC,CAAC;IAEjD,KAAK,CAAC,SAAS,CAAC,GAAG,EAAE;QACnB,IAAI,cAAc;YAAE,KAAK,kBAAkB,EAAE,CAAC;IAChD,CAAC,EAAE,CAAC,cAAc,EAAE,kBAAkB,CAAC,CAAC,CAAC;IAEzC,oBAAoB;IACpB,MAAM,KAAK,GAAG,KAAK,CAAC,WAAW,CAC7B,KAAK,EAAE,IAAY,EAAE,EAAE;QACrB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,WAAW,CAC9B;;;;;;;;;;;;aAYG,EACH,EAAE,IAAI,EAAE,CACT,CAAC;YACF,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM;gBAAE,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;YACrE,MAAM,kBAAkB,EAAE,CAAC;YAC3B,MAAM,OAAO,GAAG,MAAM,CAAC,IAAK,CAAC,aAAa,CAAC;YAC3C,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,aAAa,IAAI,SAAS,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC;QACvF,CAAC;QAAC,OAAO,CAAM,EAAE,CAAC;YAChB,OAAO,EAAE,UAAU,EAAE,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;QACvF,CAAC;IACH,CAAC,EACD,CAAC,WAAW,EAAE,kBAAkB,CAAC,CAClC,CAAC;IAEF,kCAAkC;IAClC,MAAM,aAAa,GAAG,OAAO,EAAE,IAAI,IAAK,OAAO,CAAC,IAAY,CAAC,aAAa,CAAC,CAAC,CAAE,OAAO,CAAC,IAAY,CAAC,aAAmC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC5I,MAAM,eAAe,GAAG,OAAO,EAAE,IAAI,IAAK,OAAO,CAAC,IAAY,CAAC,mBAAmB,CAAC,CAAC,CAAE,OAAO,CAAC,IAAY,CAAC,mBAA+C,CAAC,CAAC,CAAC,EAAE,CAAC;IAEhK,MAAM,UAAU,GAAG,KAAK,CAAC,WAAW,CAClC,KAAK,EAAE,KAAe,EAAE,EAAE;QACxB,IAAI,CAAC,OAAO,EAAE,IAAI;YAAE,OAAO,EAAE,UAAU,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC;QACtF,MAAM,MAAM,GAAG,MAAM,aAAa,CAChC;;;;;WAKG,EACH,EAAE,EAAE,EAAE,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,CAC/B,CAAC;QACF,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;YAC1B,OAAO,EAAE,UAAU,EAAE,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;QACxF,CAAC;QACD,0CAA0C;QAC1C,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC;QACxB,OAAO,EAAE,UAAU,EAAE,MAAM,CAAC,IAAK,CAAC,uBAAuB,CAAC,UAAU,EAAE,CAAC;IACzE,CAAC,EACD,CAAC,OAAO,EAAE,aAAa,CAAC,CACzB,CAAC;IAEF,MAAM,WAAW,GAAG,KAAK,CAAC,WAAW,CACnC,KAAK,EAAE,IAAY,EAAE,EAAE;QACrB,MAAM,QAAQ,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAClD,IAAI,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YAAE,OAAO,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC;QACrE,OAAO,UAAU,CAAC,CAAC,GAAG,QAAQ,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;IACvD,CAAC,EACD,CAAC,aAAa,EAAE,UAAU,CAAC,CAC5B,CAAC;IAEF,MAAM,cAAc,GAAG,KAAK,CAAC,WAAW,CACtC,KAAK,EAAE,IAAY,EAAE,EAAE;QACrB,MAAM,IAAI,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;QACtF,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC,EACD,CAAC,aAAa,EAAE,UAAU,CAAC,CAC5B,CAAC;IAEF,uCAAuC;IACvC,MAAM,qBAAqB,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE;QAC/C,IAAI,CAAC,OAAO,EAAE,IAAI,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QAC5D,MAAM,WAAW,GAAI,OAAO,CAAC,IAAY,CAAC,IAAI,EAAE,cAAc,EAAE,MAAM,CAAC;QACvE,MAAM,QAAQ,GAAG,MAAM,CAAC,WAAW,IAAI,CAAC,CAAC,CAAC;QAC1C,IAAI,QAAQ,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC;QAE/B,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QAEjE,IAAI,IAAI,GAAgE,IAAI,CAAC;QAC7E,KAAK,MAAM,OAAO,IAAI,WAAW,EAAE,CAAC;YAClC,MAAM,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC;YAC3B,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,OAAO,CAAC,SAAS;gBAAE,SAAS;YAC3C,IAAI,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;gBAAE,SAAS;YACzC,KAAK;YACL,IAAI,CAAC,CAAC,WAAW,IAAI,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC,GAAG,QAAQ;gBAAE,SAAS;YACvE,OAAO;YACP,IAAI,MAAM,GAAG,CAAC,CAAC;YACf,IAAI,CAAC,CAAC,SAAS,KAAK,YAAY,IAAI,CAAC,CAAC,eAAe,IAAI,IAAI,EAAE,CAAC;gBAC9D,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,eAAe,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC;YACxE,CAAC;iBAAM,IAAI,CAAC,CAAC,SAAS,KAAK,cAAc,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;gBAC3D,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,CAAC;YAC5D,CAAC;YACD,IAAI,MAAM,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,IAAI,MAAM,GAAG,IAAI,CAAC,eAAe,CAAC,EAAE,CAAC;gBAClE,IAAI,GAAG,EAAE,QAAQ,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,EAAE,CAAC;YACxD,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,EAAE,aAAa,CAAC,CAAC,CAAC;IAE1C,MAAM,KAAK,GAAyB,KAAK,CAAC,OAAO,CAC/C,GAAG,EAAE,CAAC,CAAC;QACL,eAAe,EAAE,qBAAqB;QACtC,WAAW,EAAE,iBAAiB;QAC9B,aAAa,EAAE,eAAe;QAC9B,qBAAqB;QACrB,KAAK;QACL,KAAK,EAAE,WAAW,EAAE,cAAc;QAClC,kBAAkB,EAAE,sBAAsB;KAC3C,CAAC,EACF;QACE,eAAe,EAAE,qBAAqB;QACtC,WAAW,EAAE,iBAAiB;QAC9B,aAAa,EAAE,eAAe;QAC9B,qBAAqB,EAAE,KAAK;QAC5B,KAAK,EAAE,WAAW,EAAE,cAAc;QAClC,kBAAkB,EAAE,sBAAsB;KAC3C,CACF,CAAC;IAEF,OAAO,KAAC,GAAG,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,YAAG,QAAQ,GAAgB,CAAC;AAC/D,CAAC;AAED,MAAM,UAAU,YAAY;IAC1B,MAAM,CAAC,GAAG,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IAChC,IAAI,CAAC,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;IAC/E,OAAO,CAAC,CAAC;AACX,CAAC;AAED,MAAM,UAAU,oBAAoB;IAClC,OAAO,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;AAC/B,CAAC;AAED,+DAA+D;AAC/D,qCAAqC;AACrC,+DAA+D;AAE/D,MAAM,UAAU,mBAAmB,CAAC,aAAwC;IAK1E,MAAM,IAAI,GAAG,OAAO,EAAE,CAAC;IACvB,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAa,EAAE,CAAC,CAAC;IACjE,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IACpD,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAgB,IAAI,CAAC,CAAC;IAE9D,KAAK,CAAC,SAAS,CAAC,GAAG,EAAE;QACnB,IAAI,CAAC,aAAa,EAAE,CAAC;YACnB,YAAY,CAAC,EAAE,CAAC,CAAC;YACjB,OAAO;QACT,CAAC;QACD,IAAI,SAAS,GAAG,KAAK,CAAC;QACtB,UAAU,CAAC,IAAI,CAAC,CAAC;QACjB,CAAC,KAAK,IAAI,EAAE;YACV,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE;oBACnC,MAAM,EAAE,MAAM;oBACd,OAAO,EAAE;wBACP,cAAc,EAAE,kBAAkB;wBAClC,2BAA2B,EAAE,IAAI,CAAC,qBAAqB;qBACxD;oBACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;wBACnB,KAAK,EAAE;;;;;;;;;;;;;;eAcJ;wBACH,SAAS,EAAE,EAAE,CAAC,EAAE,aAAa,EAAE;qBAChC,CAAC;oBACF,WAAW,EAAE,SAAS;iBACvB,CAAC,CAAC;gBACH,MAAM,CAAC,GAAQ,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;gBAChC,IAAI,SAAS;oBAAE,OAAO;gBACtB,IAAI,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;oBACrB,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;gBAChC,CAAC;qBAAM,CAAC;oBACN,YAAY,CAAC,CAAC,CAAC,IAAI,EAAE,gBAAgB,IAAI,EAAE,CAAC,CAAC;gBAC/C,CAAC;YACH,CAAC;YAAC,OAAO,CAAM,EAAE,CAAC;gBAChB,IAAI,CAAC,SAAS;oBAAE,QAAQ,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;YACvC,CAAC;oBAAS,CAAC;gBACT,IAAI,CAAC,SAAS;oBAAE,UAAU,CAAC,KAAK,CAAC,CAAC;YACpC,CAAC;QACH,CAAC,CAAC,EAAE,CAAC;QACL,OAAO,GAAG,EAAE,GAAG,SAAS,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACrC,CAAC,EAAE,CAAC,aAAa,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,qBAAqB,CAAC,CAAC,CAAC;IAE7D,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;AACvC,CAAC"}

package/dist/components/index.d.ts

@@ -38,4 +38,16 @@ export { CartLineQuantityAdjustButton } from './CartLineQuantityAdjustButton';
 export type { CartLineQuantityAdjustButtonProps } from './CartLineQuantityAdjustButton';
 export { VariantSelector } from './VariantSelector';
 export type { VariantSelectorProps, VariantSelectorRenderProps, VariantOption, } from './VariantSelector';
+export { AddressBookProvider, useAddressBook, useAddressBookOptional, } from './AddressBookProvider';
+export type { Address, AddressInput, AddressBookStatus, AddressBookUserError, AddressBookContextValue, AddressBookProviderProps, } from './AddressBookProvider';
+export { AddressList } from './AddressList';
+export type { AddressListProps, AddressListItemActions } from './AddressList';
+export { AddressForm } from './AddressForm';
+export type { AddressFormProps, AddressFormI18n } from './AddressForm';
+export { AddressPicker } from './AddressPicker';
+export type { AddressPickerProps } from './AddressPicker';
+export { DiscountProvider, useDiscounts, useDiscountsOptional, useProductDiscounts, } from './DiscountProvider';
+export type { Discount, DiscountClaim, DiscountValueType, DiscountValuePercentage, DiscountValueAmount, DiscountValueFreeShipping, CartDiscountCode, CartDiscountAllocation, DiscountUserError, DiscountContextValue, DiscountProviderProps, } from './DiscountProvider';
+export { DiscountCodeInput, AppliedDiscountList, BestDiscountHint, ClaimableDiscountList, DiscountClaimButton, MyDiscountList, } from './DiscountComponents';
+export type { DiscountCodeInputProps, AppliedDiscountListProps, BestDiscountHintProps, ClaimableDiscountListProps, DiscountClaimButtonProps, MyDiscountListProps, } from './DiscountComponents';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAGH,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACxE,YAAY,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAE1E,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACxE,YAAY,EACV,IAAI,EACJ,QAAQ,EACR,mBAAmB,EACnB,UAAU,EACV,aAAa,EACb,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,sBAAsB,EACtB,iBAAiB,GAClB,MAAM,0BAA0B,CAAC;AAClC,YAAY,EACV,0BAA0B,EAC1B,2BAA2B,EAC3B,iBAAiB,GAClB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACjF,YAAY,EAAE,cAAc,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAGzG,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAEvE,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAErD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAExD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,YAAY,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAE9D,OAAO,EAAE,4BAA4B,EAAE,MAAM,gCAAgC,CAAC;AAC9E,YAAY,EAAE,iCAAiC,EAAE,MAAM,gCAAgC,CAAC;AAExF,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,YAAY,EACV,oBAAoB,EACpB,0BAA0B,EAC1B,aAAa,GACd,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"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"}

package/dist/components/index.js

@@ -30,4 +30,12 @@ export { ProductPrice } from './ProductPrice';
 export { AddToCartButton } from './AddToCartButton';
 export { CartLineQuantityAdjustButton } from './CartLineQuantityAdjustButton';
 export { VariantSelector } from './VariantSelector';
+// 地址簿（W4a）
+export { AddressBookProvider, useAddressBook, useAddressBookOptional, } from './AddressBookProvider';
+export { AddressList } from './AddressList';
+export { AddressForm } from './AddressForm';
+export { AddressPicker } from './AddressPicker';
+// 优惠券（W4b）
+export { DiscountProvider, useDiscounts, useDiscountsOptional, useProductDiscounts, } from './DiscountProvider';
+export { DiscountCodeInput, AppliedDiscountList, BestDiscountHint, ClaimableDiscountList, DiscountClaimButton, MyDiscountList, } from './DiscountComponents';
 //# sourceMappingURL=index.js.map

package/dist/components/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,oBAAoB;AACpB,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAGxE,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAWxE,OAAO,EACL,sBAAsB,EACtB,iBAAiB,GAClB,MAAM,0BAA0B,CAAC;AAOlC,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAGjF,QAAQ;AACR,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAGhC,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAGhC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAG9C,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGpD,OAAO,EAAE,4BAA4B,EAAE,MAAM,gCAAgC,CAAC;AAG9E,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,oBAAoB;AACpB,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAGxE,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAWxE,OAAO,EACL,sBAAsB,EACtB,iBAAiB,GAClB,MAAM,0BAA0B,CAAC;AAOlC,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAGjF,QAAQ;AACR,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAGhC,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAGhC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAG9C,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGpD,OAAO,EAAE,4BAA4B,EAAE,MAAM,gCAAgC,CAAC;AAG9E,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAOpD,WAAW;AACX,OAAO,EACL,mBAAmB,EACnB,cAAc,EACd,sBAAsB,GACvB,MAAM,uBAAuB,CAAC;AAU/B,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAG5C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAG5C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGhD,WAAW;AACX,OAAO,EACL,gBAAgB,EAChB,YAAY,EACZ,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,oBAAoB,CAAC;AAe5B,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,gBAAgB,EAChB,qBAAqB,EACrB,mBAAmB,EACnB,cAAc,GACf,MAAM,sBAAsB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shopbb/helium",
-  "version": "0.3.1",
+  "version": "0.4.0",
   "description": "shopbb storefront framework — components, React SSR, GraphQL client, cart handler, cache for Cloudflare Workers",
   "license": "MIT",
   "type": "module",

package/src/components/AddressBookProvider.tsx

@@ -0,0 +1,279 @@
+/**
+ * <AddressBookProvider> + useAddressBook()
+ *
+ * 接管买家地址簿全部能力。内部走 Customer Account GraphQL（不直接 fetch REST），
+ * 让商家代码不需要关心后端实现细节。
+ *
+ * 鉴权：内部通过 ShopProvider 拿 apiUrl，通过浏览器 localStorage 读 buyer token
+ * （key: 'shopbb:buyer_token'）。商家也可以传 `tokenProvider` 自定义 token 取法。
+ *
+ * 用法：
+ *   <ShopProvider {...}>
+ *     <AddressBookProvider>
+ *       <App />
+ *     </AddressBookProvider>
+ *   </ShopProvider>
+ *
+ *   const { addresses, defaultAddress, createAddress, ... } = useAddressBook();
+ */
+
+import * as React from 'react';
+import { useShop } from './ShopProvider';
+
+export interface Address {
+  id: string;
+  firstName?: string | null;
+  lastName?: string | null;
+  company?: string | null;
+  address1?: string | null;
+  address2?: string | null;
+  city?: string | null;
+  district?: string | null;
+  province?: string | null;
+  provinceCode?: string | null;
+  country?: string | null;
+  countryCode?: string | null;
+  zip?: string | null;
+  phone?: string | null;
+  latitude?: number | null;
+  longitude?: number | null;
+  isDefault: boolean;
+}
+
+export interface AddressInput {
+  firstName?: string;
+  lastName?: string;
+  company?: string;
+  address1?: string;
+  address2?: string;
+  city?: string;
+  district?: string;
+  province?: string;
+  provinceCode?: string;
+  country?: string;
+  countryCode?: string;
+  zip?: string;
+  phone?: string;
+}
+
+export type AddressBookStatus = 'unauthenticated' | 'loading' | 'idle' | 'updating' | 'error';
+
+export interface AddressBookUserError {
+  field?: string[];
+  code?: string;
+  message: string;
+}
+
+export interface AddressBookContextValue {
+  addresses: Address[];
+  defaultAddress: Address | null;
+  status: AddressBookStatus;
+  error: string | null;
+  createAddress: (input: AddressInput, asDefault?: boolean) => Promise<{ address?: Address; userErrors: AddressBookUserError[] }>;
+  updateAddress: (id: string, input: AddressInput, asDefault?: boolean) => Promise<{ address?: Address; userErrors: AddressBookUserError[] }>;
+  deleteAddress: (id: string) => Promise<{ userErrors: AddressBookUserError[] }>;
+  setDefault: (id: string) => Promise<{ userErrors: AddressBookUserError[] }>;
+  refetch: () => Promise<void>;
+}
+
+const Ctx = React.createContext<AddressBookContextValue | null>(null);
+
+const DEFAULT_TOKEN_KEY = 'shopbb:buyer_token';
+
+export interface AddressBookProviderProps {
+  children: React.ReactNode;
+  /** 自定义 token 取法。默认 localStorage[DEFAULT_TOKEN_KEY] */
+  tokenProvider?: () => string | null;
+  /** 自动 fetch；默认 true */
+  fetchOnMount?: boolean;
+  /** Customer Account GraphQL endpoint。默认 ${shop.apiUrl 替换为 /customer/api/2026-04/graphql} */
+  endpoint?: string;
+}
+
+export function AddressBookProvider(props: AddressBookProviderProps) {
+  const { children, tokenProvider, fetchOnMount = true, endpoint: endpointProp } = props;
+  const shop = useShop();
+
+  const [addresses, setAddresses] = React.useState<Address[]>([]);
+  const [defaultAddress, setDefaultAddressState] = React.useState<Address | null>(null);
+  const [status, setStatus] = React.useState<AddressBookStatus>('loading');
+  const [error, setError] = React.useState<string | null>(null);
+
+  const endpoint = React.useMemo(() => {
+    if (endpointProp) return endpointProp;
+    try {
+      const u = new URL(shop.apiUrl);
+      return `${u.origin}/customer/api/2026-04/graphql`;
+    } catch {
+      return shop.apiUrl;
+    }
+  }, [endpointProp, shop.apiUrl]);
+
+  const getToken = React.useCallback(() => {
+    if (tokenProvider) return tokenProvider();
+    if (typeof localStorage === 'undefined') return null;
+    return localStorage.getItem(DEFAULT_TOKEN_KEY) || localStorage.getItem('shopflare:buyer_token');
+  }, [tokenProvider]);
+
+  const gql = React.useCallback(
+    async <T = any>(query: string, variables?: any): Promise<{ data?: T; errors?: any[] }> => {
+      const token = getToken();
+      if (!token) throw new Error('未登录');
+      const res = await fetch(endpoint, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json', Authorization: `Bearer ${token}` },
+        body: JSON.stringify({ query, variables }),
+      });
+      return res.json();
+    },
+    [endpoint, getToken],
+  );
+
+  const refetch = React.useCallback(async () => {
+    const token = getToken();
+    if (!token) {
+      setStatus('unauthenticated');
+      setAddresses([]);
+      setDefaultAddressState(null);
+      return;
+    }
+    setStatus('loading');
+    try {
+      const result = await gql<{ customer: { defaultAddress: Address | null; addresses: { nodes: Address[] } } | null }>(
+        `query { customer { defaultAddress { id firstName lastName phone city district province address1 address2 country zip isDefault } addresses(first: 50) { nodes { id firstName lastName company phone city district province provinceCode country countryCode address1 address2 zip latitude longitude isDefault } } } }`,
+      );
+      if (result.errors?.length) throw new Error(result.errors[0].message);
+      const c = result.data?.customer;
+      setAddresses(c?.addresses?.nodes ?? []);
+      setDefaultAddressState(c?.defaultAddress ?? null);
+      setStatus('idle');
+      setError(null);
+    } catch (e: any) {
+      setError(e?.message ?? String(e));
+      setStatus('error');
+    }
+  }, [gql, getToken]);
+
+  React.useEffect(() => {
+    if (fetchOnMount) void refetch();
+  }, [fetchOnMount, refetch]);
+
+  const createAddress = React.useCallback(
+    async (input: AddressInput, asDefault?: boolean) => {
+      setStatus('updating');
+      try {
+        const result = await gql<{ customerAddressCreate: { customerAddress: Address | null; userErrors: AddressBookUserError[] } }>(
+          `mutation Create($a: MailingAddressInput!, $d: Boolean) {
+             customerAddressCreate(address: $a, defaultAddress: $d) {
+               customerAddress { id firstName lastName phone city district province address1 address2 country zip isDefault }
+               userErrors { field code message }
+             }
+           }`,
+          { a: input, d: asDefault ?? false },
+        );
+        if (result.errors?.length) throw new Error(result.errors[0].message);
+        const payload = result.data!.customerAddressCreate;
+        await refetch();
+        return { address: payload.customerAddress ?? undefined, userErrors: payload.userErrors };
+      } catch (e: any) {
+        setStatus('error');
+        setError(e?.message);
+        return { userErrors: [{ code: 'NETWORK_ERROR', message: e?.message ?? String(e) }] };
+      }
+    },
+    [gql, refetch],
+  );
+
+  const updateAddress = React.useCallback(
+    async (id: string, input: AddressInput, asDefault?: boolean) => {
+      setStatus('updating');
+      try {
+        const result = await gql<{ customerAddressUpdate: { customerAddress: Address | null; userErrors: AddressBookUserError[] } }>(
+          `mutation Upd($id: ID!, $a: MailingAddressInput!, $d: Boolean) {
+             customerAddressUpdate(addressId: $id, address: $a, defaultAddress: $d) {
+               customerAddress { id firstName lastName phone city district province address1 address2 country zip isDefault }
+               userErrors { field code message }
+             }
+           }`,
+          { id, a: input, d: asDefault },
+        );
+        if (result.errors?.length) throw new Error(result.errors[0].message);
+        const payload = result.data!.customerAddressUpdate;
+        await refetch();
+        return { address: payload.customerAddress ?? undefined, userErrors: payload.userErrors };
+      } catch (e: any) {
+        setStatus('error');
+        setError(e?.message);
+        return { userErrors: [{ code: 'NETWORK_ERROR', message: e?.message ?? String(e) }] };
+      }
+    },
+    [gql, refetch],
+  );
+
+  const deleteAddress = React.useCallback(
+    async (id: string) => {
+      setStatus('updating');
+      try {
+        const result = await gql<{ customerAddressDelete: { deletedAddressId: string | null; userErrors: AddressBookUserError[] } }>(
+          `mutation D($id: ID!) {
+             customerAddressDelete(addressId: $id) {
+               deletedAddressId
+               userErrors { field code message }
+             }
+           }`,
+          { id },
+        );
+        if (result.errors?.length) throw new Error(result.errors[0].message);
+        await refetch();
+        return { userErrors: result.data!.customerAddressDelete.userErrors };
+      } catch (e: any) {
+        setStatus('error');
+        setError(e?.message);
+        return { userErrors: [{ code: 'NETWORK_ERROR', message: e?.message ?? String(e) }] };
+      }
+    },
+    [gql, refetch],
+  );
+
+  const setDefault = React.useCallback(
+    async (id: string) => {
+      setStatus('updating');
+      try {
+        const result = await gql<{ customerDefaultAddressUpdate: { customer: any; userErrors: AddressBookUserError[] } }>(
+          `mutation SD($id: ID!) {
+             customerDefaultAddressUpdate(addressId: $id) {
+               customer { id }
+               userErrors { field code message }
+             }
+           }`,
+          { id },
+        );
+        if (result.errors?.length) throw new Error(result.errors[0].message);
+        await refetch();
+        return { userErrors: result.data!.customerDefaultAddressUpdate.userErrors };
+      } catch (e: any) {
+        setStatus('error');
+        setError(e?.message);
+        return { userErrors: [{ code: 'NETWORK_ERROR', message: e?.message ?? String(e) }] };
+      }
+    },
+    [gql, refetch],
+  );
+
+  const value: AddressBookContextValue = React.useMemo(
+    () => ({ addresses, defaultAddress, status, error, createAddress, updateAddress, deleteAddress, setDefault, refetch }),
+    [addresses, defaultAddress, status, error, createAddress, updateAddress, deleteAddress, setDefault, refetch],
+  );
+
+  return <Ctx.Provider value={value}>{children}</Ctx.Provider>;
+}
+
+export function useAddressBook(): AddressBookContextValue {
+  const v = React.useContext(Ctx);
+  if (!v) throw new Error('useAddressBook must be used inside <AddressBookProvider>');
+  return v;
+}
+
+export function useAddressBookOptional(): AddressBookContextValue | null {
+  return React.useContext(Ctx);
+}