@shopbb/helium 0.3.0 → 0.4.0

package/dist/components/AddressBookProvider.d.ts

@@ -0,0 +1,93 @@
+/**
+ * <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';
+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>;
+}
+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 declare function AddressBookProvider(props: AddressBookProviderProps): import("react/jsx-runtime").JSX.Element;
+export declare function useAddressBook(): AddressBookContextValue;
+export declare function useAddressBookOptional(): AddressBookContextValue | null;
+//# sourceMappingURL=AddressBookProvider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AddressBookProvider.d.ts","sourceRoot":"","sources":["../../src/components/AddressBookProvider.tsx"],"names":[],"mappings":"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"}

package/dist/components/AddressBookProvider.js

@@ -0,0 +1,182 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * <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';
+const Ctx = React.createContext(null);
+const DEFAULT_TOKEN_KEY = 'shopbb:buyer_token';
+export function AddressBookProvider(props) {
+    const { children, tokenProvider, fetchOnMount = true, endpoint: endpointProp } = props;
+    const shop = useShop();
+    const [addresses, setAddresses] = React.useState([]);
+    const [defaultAddress, setDefaultAddressState] = React.useState(null);
+    const [status, setStatus] = React.useState('loading');
+    const [error, setError] = React.useState(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 (query, variables) => {
+        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(`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) {
+            setError(e?.message ?? String(e));
+            setStatus('error');
+        }
+    }, [gql, getToken]);
+    React.useEffect(() => {
+        if (fetchOnMount)
+            void refetch();
+    }, [fetchOnMount, refetch]);
+    const createAddress = React.useCallback(async (input, asDefault) => {
+        setStatus('updating');
+        try {
+            const result = await gql(`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) {
+            setStatus('error');
+            setError(e?.message);
+            return { userErrors: [{ code: 'NETWORK_ERROR', message: e?.message ?? String(e) }] };
+        }
+    }, [gql, refetch]);
+    const updateAddress = React.useCallback(async (id, input, asDefault) => {
+        setStatus('updating');
+        try {
+            const result = await gql(`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) {
+            setStatus('error');
+            setError(e?.message);
+            return { userErrors: [{ code: 'NETWORK_ERROR', message: e?.message ?? String(e) }] };
+        }
+    }, [gql, refetch]);
+    const deleteAddress = React.useCallback(async (id) => {
+        setStatus('updating');
+        try {
+            const result = await gql(`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) {
+            setStatus('error');
+            setError(e?.message);
+            return { userErrors: [{ code: 'NETWORK_ERROR', message: e?.message ?? String(e) }] };
+        }
+    }, [gql, refetch]);
+    const setDefault = React.useCallback(async (id) => {
+        setStatus('updating');
+        try {
+            const result = await gql(`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) {
+            setStatus('error');
+            setError(e?.message);
+            return { userErrors: [{ code: 'NETWORK_ERROR', message: e?.message ?? String(e) }] };
+        }
+    }, [gql, refetch]);
+    const value = React.useMemo(() => ({ addresses, defaultAddress, status, error, createAddress, updateAddress, deleteAddress, setDefault, refetch }), [addresses, defaultAddress, status, error, createAddress, updateAddress, deleteAddress, setDefault, refetch]);
+    return _jsx(Ctx.Provider, { value: value, children: children });
+}
+export function useAddressBook() {
+    const v = React.useContext(Ctx);
+    if (!v)
+        throw new Error('useAddressBook must be used inside <AddressBookProvider>');
+    return v;
+}
+export function useAddressBookOptional() {
+    return React.useContext(Ctx);
+}
+//# sourceMappingURL=AddressBookProvider.js.map

package/dist/components/AddressBookProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AddressBookProvider.js","sourceRoot":"","sources":["../../src/components/AddressBookProvider.tsx"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AA0DzC,MAAM,GAAG,GAAG,KAAK,CAAC,aAAa,CAAiC,IAAI,CAAC,CAAC;AAEtE,MAAM,iBAAiB,GAAG,oBAAoB,CAAC;AAY/C,MAAM,UAAU,mBAAmB,CAAC,KAA+B;IACjE,MAAM,EAAE,QAAQ,EAAE,aAAa,EAAE,YAAY,GAAG,IAAI,EAAE,QAAQ,EAAE,YAAY,EAAE,GAAG,KAAK,CAAC;IACvF,MAAM,IAAI,GAAG,OAAO,EAAE,CAAC;IAEvB,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAY,EAAE,CAAC,CAAC;IAChE,MAAM,CAAC,cAAc,EAAE,sBAAsB,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAiB,IAAI,CAAC,CAAC;IACtF,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAoB,SAAS,CAAC,CAAC;IACzE,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAgB,IAAI,CAAC,CAAC;IAE9D,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE;QAClC,IAAI,YAAY;YAAE,OAAO,YAAY,CAAC;QACtC,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,YAAY,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;IAEhC,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,GAAG,GAAG,KAAK,CAAC,WAAW,CAC3B,KAAK,EAAW,KAAa,EAAE,SAAe,EAAyC,EAAE;QACvF,MAAM,KAAK,GAAG,QAAQ,EAAE,CAAC;QACzB,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC;QACnC,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,QAAQ,EAAE;YAChC,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,QAAQ,EAAE,QAAQ,CAAC,CACrB,CAAC;IAEF,MAAM,OAAO,GAAG,KAAK,CAAC,WAAW,CAAC,KAAK,IAAI,EAAE;QAC3C,MAAM,KAAK,GAAG,QAAQ,EAAE,CAAC;QACzB,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,SAAS,CAAC,iBAAiB,CAAC,CAAC;YAC7B,YAAY,CAAC,EAAE,CAAC,CAAC;YACjB,sBAAsB,CAAC,IAAI,CAAC,CAAC;YAC7B,OAAO;QACT,CAAC;QACD,SAAS,CAAC,SAAS,CAAC,CAAC;QACrB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,GAAG,CACtB,wTAAwT,CACzT,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,CAAC,GAAG,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC;YAChC,YAAY,CAAC,CAAC,EAAE,SAAS,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;YACxC,sBAAsB,CAAC,CAAC,EAAE,cAAc,IAAI,IAAI,CAAC,CAAC;YAClD,SAAS,CAAC,MAAM,CAAC,CAAC;YAClB,QAAQ,CAAC,IAAI,CAAC,CAAC;QACjB,CAAC;QAAC,OAAO,CAAM,EAAE,CAAC;YAChB,QAAQ,CAAC,CAAC,EAAE,OAAO,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;YAClC,SAAS,CAAC,OAAO,CAAC,CAAC;QACrB,CAAC;IACH,CAAC,EAAE,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC;IAEpB,KAAK,CAAC,SAAS,CAAC,GAAG,EAAE;QACnB,IAAI,YAAY;YAAE,KAAK,OAAO,EAAE,CAAC;IACnC,CAAC,EAAE,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC,CAAC;IAE5B,MAAM,aAAa,GAAG,KAAK,CAAC,WAAW,CACrC,KAAK,EAAE,KAAmB,EAAE,SAAmB,EAAE,EAAE;QACjD,SAAS,CAAC,UAAU,CAAC,CAAC;QACtB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,GAAG,CACtB;;;;;aAKG,EACH,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,SAAS,IAAI,KAAK,EAAE,CACpC,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,OAAO,GAAG,MAAM,CAAC,IAAK,CAAC,qBAAqB,CAAC;YACnD,MAAM,OAAO,EAAE,CAAC;YAChB,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,eAAe,IAAI,SAAS,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC;QAC3F,CAAC;QAAC,OAAO,CAAM,EAAE,CAAC;YAChB,SAAS,CAAC,OAAO,CAAC,CAAC;YACnB,QAAQ,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;YACrB,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,GAAG,EAAE,OAAO,CAAC,CACf,CAAC;IAEF,MAAM,aAAa,GAAG,KAAK,CAAC,WAAW,CACrC,KAAK,EAAE,EAAU,EAAE,KAAmB,EAAE,SAAmB,EAAE,EAAE;QAC7D,SAAS,CAAC,UAAU,CAAC,CAAC;QACtB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,GAAG,CACtB;;;;;aAKG,EACH,EAAE,EAAE,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,SAAS,EAAE,CAC/B,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,OAAO,GAAG,MAAM,CAAC,IAAK,CAAC,qBAAqB,CAAC;YACnD,MAAM,OAAO,EAAE,CAAC;YAChB,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,eAAe,IAAI,SAAS,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC;QAC3F,CAAC;QAAC,OAAO,CAAM,EAAE,CAAC;YAChB,SAAS,CAAC,OAAO,CAAC,CAAC;YACnB,QAAQ,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;YACrB,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,GAAG,EAAE,OAAO,CAAC,CACf,CAAC;IAEF,MAAM,aAAa,GAAG,KAAK,CAAC,WAAW,CACrC,KAAK,EAAE,EAAU,EAAE,EAAE;QACnB,SAAS,CAAC,UAAU,CAAC,CAAC;QACtB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,GAAG,CACtB;;;;;aAKG,EACH,EAAE,EAAE,EAAE,CACP,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,OAAO,EAAE,CAAC;YAChB,OAAO,EAAE,UAAU,EAAE,MAAM,CAAC,IAAK,CAAC,qBAAqB,CAAC,UAAU,EAAE,CAAC;QACvE,CAAC;QAAC,OAAO,CAAM,EAAE,CAAC;YAChB,SAAS,CAAC,OAAO,CAAC,CAAC;YACnB,QAAQ,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;YACrB,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,GAAG,EAAE,OAAO,CAAC,CACf,CAAC;IAEF,MAAM,UAAU,GAAG,KAAK,CAAC,WAAW,CAClC,KAAK,EAAE,EAAU,EAAE,EAAE;QACnB,SAAS,CAAC,UAAU,CAAC,CAAC;QACtB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,GAAG,CACtB;;;;;aAKG,EACH,EAAE,EAAE,EAAE,CACP,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,OAAO,EAAE,CAAC;YAChB,OAAO,EAAE,UAAU,EAAE,MAAM,CAAC,IAAK,CAAC,4BAA4B,CAAC,UAAU,EAAE,CAAC;QAC9E,CAAC;QAAC,OAAO,CAAM,EAAE,CAAC;YAChB,SAAS,CAAC,OAAO,CAAC,CAAC;YACnB,QAAQ,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;YACrB,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,GAAG,EAAE,OAAO,CAAC,CACf,CAAC;IAEF,MAAM,KAAK,GAA4B,KAAK,CAAC,OAAO,CAClD,GAAG,EAAE,CAAC,CAAC,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,aAAa,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,EACtH,CAAC,SAAS,EAAE,cAAc,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,aAAa,EAAE,UAAU,EAAE,OAAO,CAAC,CAC7G,CAAC;IAEF,OAAO,KAAC,GAAG,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,YAAG,QAAQ,GAAgB,CAAC;AAC/D,CAAC;AAED,MAAM,UAAU,cAAc;IAC5B,MAAM,CAAC,GAAG,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IAChC,IAAI,CAAC,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAC;IACpF,OAAO,CAAC,CAAC;AACX,CAAC;AAED,MAAM,UAAU,sBAAsB;IACpC,OAAO,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;AAC/B,CAAC"}

package/dist/components/AddressForm.d.ts

@@ -0,0 +1,54 @@
+/**
+ * <AddressForm>
+ *
+ * 地址编辑 / 新增表单。**自带**：
+ *   - 表单 state（useState）
+ *   - 必填验证
+ *   - 调 useAddressBook().createAddress / updateAddress
+ *   - userErrors 显示
+ *   - loading 态
+ *
+ * 用法（新增）：
+ *   <AddressForm onSave={() => setCreating(false)} onCancel={...} />
+ *
+ * 用法（编辑）：
+ *   <AddressForm initial={editingAddress} onSave={...} onCancel={...} />
+ *
+ * 表单不带样式（用 data-* 钩子或商家自己 className 控制）。
+ */
+import { type Address, type AddressInput } from './AddressBookProvider';
+export interface AddressFormProps {
+    /** 传 = 编辑模式；不传 = 新增模式 */
+    initial?: Address;
+    /** 保存成功后触发 */
+    onSave?: (address?: Address) => void;
+    /** 取消按钮触发 */
+    onCancel?: () => void;
+    /** 自定义提交按钮文字 */
+    submitText?: string;
+    cancelText?: string;
+    /** 显示"设为默认"复选框，默认 true */
+    showDefaultCheckbox?: boolean;
+    /** 哪些字段必填，默认 ['firstName','phone','address1','city','province'] */
+    requiredFields?: Array<keyof AddressInput>;
+    className?: string;
+    /** i18n 文案覆盖 */
+    i18n?: Partial<AddressFormI18n>;
+}
+export interface AddressFormI18n {
+    firstName: string;
+    lastName: string;
+    company: string;
+    phone: string;
+    country: string;
+    province: string;
+    city: string;
+    district: string;
+    address1: string;
+    address2: string;
+    zip: string;
+    setDefault: string;
+    saving: string;
+}
+export declare function AddressForm(props: AddressFormProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=AddressForm.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AddressForm.d.ts","sourceRoot":"","sources":["../../src/components/AddressForm.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAGH,OAAO,EAAkB,KAAK,OAAO,EAAE,KAAK,YAAY,EAA6B,MAAM,uBAAuB,CAAC;AAEnH,MAAM,WAAW,gBAAgB;IAC/B,yBAAyB;IACzB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,cAAc;IACd,MAAM,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;IACrC,aAAa;IACb,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IACtB,gBAAgB;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,0BAA0B;IAC1B,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,mEAAmE;IACnE,cAAc,CAAC,EAAE,KAAK,CAAC,MAAM,YAAY,CAAC,CAAC;IAC3C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC;CACjC;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;CAChB;AAkBD,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,2CA4HlD"}

package/dist/components/AddressForm.js

@@ -0,0 +1,87 @@
+import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
+/**
+ * <AddressForm>
+ *
+ * 地址编辑 / 新增表单。**自带**：
+ *   - 表单 state（useState）
+ *   - 必填验证
+ *   - 调 useAddressBook().createAddress / updateAddress
+ *   - userErrors 显示
+ *   - loading 态
+ *
+ * 用法（新增）：
+ *   <AddressForm onSave={() => setCreating(false)} onCancel={...} />
+ *
+ * 用法（编辑）：
+ *   <AddressForm initial={editingAddress} onSave={...} onCancel={...} />
+ *
+ * 表单不带样式（用 data-* 钩子或商家自己 className 控制）。
+ */
+import * as React from 'react';
+import { useAddressBook } from './AddressBookProvider';
+const DEFAULT_I18N = {
+    firstName: '收货人',
+    lastName: '姓氏',
+    company: '公司',
+    phone: '手机号',
+    country: '国家',
+    province: '省',
+    city: '市',
+    district: '区',
+    address1: '详细地址',
+    address2: '地址补充',
+    zip: '邮编',
+    setDefault: '设为默认地址',
+    saving: '保存中…',
+};
+export function AddressForm(props) {
+    const { initial, onSave, onCancel, submitText = '保存', cancelText = '取消', showDefaultCheckbox = true, requiredFields = ['firstName', 'phone', 'address1', 'city', 'province'], className, i18n: i18nOverride, } = props;
+    const { createAddress, updateAddress } = useAddressBook();
+    const i18n = { ...DEFAULT_I18N, ...i18nOverride };
+    const [form, setForm] = React.useState({
+        firstName: initial?.firstName ?? '',
+        lastName: initial?.lastName ?? '',
+        company: initial?.company ?? '',
+        phone: initial?.phone ?? '',
+        country: initial?.country ?? 'China',
+        countryCode: initial?.countryCode ?? 'CN',
+        province: initial?.province ?? '',
+        provinceCode: initial?.provinceCode ?? '',
+        city: initial?.city ?? '',
+        district: initial?.district ?? '',
+        address1: initial?.address1 ?? '',
+        address2: initial?.address2 ?? '',
+        zip: initial?.zip ?? '',
+    });
+    const [asDefault, setAsDefault] = React.useState(initial?.isDefault ?? false);
+    const [saving, setSaving] = React.useState(false);
+    const [errors, setErrors] = React.useState([]);
+    const update = (k, v) => setForm((f) => ({ ...f, [k]: v }));
+    const handleSubmit = async (e) => {
+        e.preventDefault();
+        // 客户端必填校验
+        const missing = requiredFields.filter((k) => !(form[k] && String(form[k]).trim()));
+        if (missing.length > 0) {
+            setErrors([{ field: missing, code: 'MISSING_FIELD', message: '请填写完整地址' }]);
+            return;
+        }
+        setSaving(true);
+        setErrors([]);
+        try {
+            const result = initial
+                ? await updateAddress(initial.id, form, asDefault)
+                : await createAddress(form, asDefault);
+            if (result.userErrors.length > 0) {
+                setErrors(result.userErrors);
+                return;
+            }
+            onSave?.(result.address);
+        }
+        finally {
+            setSaving(false);
+        }
+    };
+    const isRequired = (k) => requiredFields.includes(k);
+    return (_jsxs("form", { onSubmit: handleSubmit, "data-address-form": true, className: className, children: [_jsxs("div", { "data-row": true, children: [_jsxs("label", { children: [_jsxs("span", { children: [i18n.firstName, isRequired('firstName') && ' *'] }), _jsx("input", { value: form.firstName, onChange: (e) => update('firstName', e.target.value), required: isRequired('firstName') })] }), _jsxs("label", { children: [_jsxs("span", { children: [i18n.phone, isRequired('phone') && ' *'] }), _jsx("input", { value: form.phone, onChange: (e) => update('phone', e.target.value), required: isRequired('phone'), type: "tel" })] })] }), _jsxs("div", { "data-row": true, "data-row-3": true, children: [_jsxs("label", { children: [_jsxs("span", { children: [i18n.province, isRequired('province') && ' *'] }), _jsx("input", { value: form.province, onChange: (e) => update('province', e.target.value), required: isRequired('province') })] }), _jsxs("label", { children: [_jsxs("span", { children: [i18n.city, isRequired('city') && ' *'] }), _jsx("input", { value: form.city, onChange: (e) => update('city', e.target.value), required: isRequired('city') })] }), _jsxs("label", { children: [_jsx("span", { children: i18n.district }), _jsx("input", { value: form.district, onChange: (e) => update('district', e.target.value) })] })] }), _jsxs("label", { children: [_jsxs("span", { children: [i18n.address1, isRequired('address1') && ' *'] }), _jsx("input", { value: form.address1, onChange: (e) => update('address1', e.target.value), required: isRequired('address1') })] }), _jsxs("label", { children: [_jsx("span", { children: i18n.address2 }), _jsx("input", { value: form.address2, onChange: (e) => update('address2', e.target.value) })] }), _jsxs("div", { "data-row": true, children: [_jsxs("label", { children: [_jsx("span", { children: i18n.zip }), _jsx("input", { value: form.zip, onChange: (e) => update('zip', e.target.value) })] }), showDefaultCheckbox && (_jsxs("label", { "data-checkbox": true, children: [_jsx("input", { type: "checkbox", checked: asDefault, onChange: (e) => setAsDefault(e.target.checked) }), _jsx("span", { children: i18n.setDefault })] }))] }), errors.length > 0 && (_jsx("div", { "data-form-errors": true, children: errors.map((er, i) => (_jsx("div", { "data-error": true, children: er.message }, i))) })), _jsxs("div", { "data-actions": true, children: [onCancel && (_jsx("button", { type: "button", onClick: onCancel, disabled: saving, "data-action": "cancel", children: cancelText })), _jsx("button", { type: "submit", disabled: saving, "data-action": "submit", children: saving ? i18n.saving : submitText })] })] }));
+}
+//# sourceMappingURL=AddressForm.js.map

package/dist/components/AddressForm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AddressForm.js","sourceRoot":"","sources":["../../src/components/AddressForm.tsx"],"names":[],"mappings":"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"}

package/dist/components/AddressList.d.ts

@@ -0,0 +1,35 @@
+/**
+ * <AddressList>
+ *
+ * 渲染当前买家的地址列表。
+ *
+ * 用法：
+ *   <AddressList
+ *     onEdit={(addr) => openEditModal(addr)}
+ *     onAdd={() => openCreateModal()}
+ *     emptyText="还没有保存的地址"
+ *   />
+ */
+import * as React from 'react';
+import { type Address } from './AddressBookProvider';
+export interface AddressListProps {
+    /** 编辑按钮点击 */
+    onEdit?: (address: Address) => void;
+    /** "新增" 按钮点击。不传 = 不显示新增按钮（商家自己渲染外面） */
+    onAdd?: () => void;
+    /** 空状态文案 */
+    emptyText?: React.ReactNode;
+    /** 渲染单个地址卡片的覆盖（高级用法） */
+    renderItem?: (address: Address, actions: AddressListItemActions) => React.ReactNode;
+    /** 整体容器 className */
+    className?: string;
+    /** 加载中渲染 */
+    loadingFallback?: React.ReactNode;
+}
+export interface AddressListItemActions {
+    setDefault: () => Promise<void>;
+    remove: () => Promise<void>;
+    edit?: () => void;
+}
+export declare function AddressList(props: AddressListProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=AddressList.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AddressList.d.ts","sourceRoot":"","sources":["../../src/components/AddressList.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAkB,KAAK,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAErE,MAAM,WAAW,gBAAgB;IAC/B,aAAa;IACb,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IACpC,uCAAuC;IACvC,KAAK,CAAC,EAAE,MAAM,IAAI,CAAC;IACnB,YAAY;IACZ,SAAS,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC5B,wBAAwB;IACxB,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,sBAAsB,KAAK,KAAK,CAAC,SAAS,CAAC;IACpF,qBAAqB;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY;IACZ,eAAe,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CACnC;AAED,MAAM,WAAW,sBAAsB;IACrC,UAAU,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAChC,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,IAAI,CAAC,EAAE,MAAM,IAAI,CAAC;CACnB;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,2CA6ClD"}

package/dist/components/AddressList.js

@@ -0,0 +1,40 @@
+import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * <AddressList>
+ *
+ * 渲染当前买家的地址列表。
+ *
+ * 用法：
+ *   <AddressList
+ *     onEdit={(addr) => openEditModal(addr)}
+ *     onAdd={() => openCreateModal()}
+ *     emptyText="还没有保存的地址"
+ *   />
+ */
+import * as React from 'react';
+import { useAddressBook } from './AddressBookProvider';
+export function AddressList(props) {
+    const { onEdit, onAdd, emptyText = '还没有保存的地址', renderItem, className, loadingFallback = null, } = props;
+    const { addresses, status, setDefault, deleteAddress } = useAddressBook();
+    if (status === 'loading' || status === 'unauthenticated') {
+        return _jsx(_Fragment, { children: loadingFallback });
+    }
+    if (addresses.length === 0) {
+        return (_jsxs("div", { "data-empty": true, className: className, children: [_jsx("p", { children: emptyText }), onAdd && (_jsx("button", { type: "button", onClick: onAdd, "data-add-address": true, children: "+ \u65B0\u589E\u5730\u5740" }))] }));
+    }
+    return (_jsxs("div", { "data-address-list": true, className: className, children: [onAdd && (_jsxs("div", { "data-list-toolbar": true, children: [_jsxs("span", { "data-muted": true, children: [addresses.length, " \u4E2A\u5730\u5740"] }), _jsx("button", { type: "button", onClick: onAdd, "data-add-address": true, children: "+ \u65B0\u589E\u5730\u5740" })] })), _jsx("div", { "data-items": true, children: addresses.map((a) => {
+                    const actions = {
+                        setDefault: async () => { await setDefault(a.id); },
+                        remove: async () => { await deleteAddress(a.id); },
+                        edit: onEdit ? () => onEdit(a) : undefined,
+                    };
+                    if (renderItem)
+                        return _jsx(React.Fragment, { children: renderItem(a, actions) }, a.id);
+                    return _jsx(DefaultAddressItem, { address: a, actions: actions }, a.id);
+                }) })] }));
+}
+// 默认渲染
+function DefaultAddressItem({ address: a, actions }) {
+    return (_jsxs("div", { "data-address-item": true, "data-default": a.isDefault ? '' : undefined, children: [_jsxs("div", { "data-row": true, children: [_jsxs("div", { "data-name": true, children: [a.firstName || '', a.lastName || '', a.isDefault && _jsx("span", { "data-default-tag": true, children: "\u9ED8\u8BA4" })] }), _jsxs("div", { "data-actions": true, children: [!a.isDefault && (_jsx("button", { type: "button", onClick: actions.setDefault, "data-action": "default", children: "\u8BBE\u4E3A\u9ED8\u8BA4" })), actions.edit && (_jsx("button", { type: "button", onClick: actions.edit, "data-action": "edit", children: "\u7F16\u8F91" })), _jsx("button", { type: "button", onClick: actions.remove, "data-action": "remove", "data-danger": true, children: "\u5220\u9664" })] })] }), _jsx("div", { "data-line": true, children: a.phone || '' }), _jsxs("div", { "data-line": true, children: [a.province || '', a.city || '', a.district || '', a.address1 || '', a.address2 ? ' ' + a.address2 : ''] })] }));
+}
+//# sourceMappingURL=AddressList.js.map

package/dist/components/AddressList.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AddressList.js","sourceRoot":"","sources":["../../src/components/AddressList.tsx"],"names":[],"mappings":"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"}

package/dist/components/AddressPicker.d.ts

@@ -0,0 +1,39 @@
+/**
+ * <AddressPicker>
+ *
+ * Checkout 用的地址选择器。**自带**：
+ *   - 从 useAddressBook() 拿 list
+ *   - radio 渲染 + 默认选 defaultAddress
+ *   - 选 "新地址" 时展开新增表单
+ *
+ * 用法（受控）：
+ *   <AddressPicker
+ *     value={selectedAddressId}
+ *     onChange={(id, addr) => setSelectedAddressId(id)}
+ *     allowNewAddress
+ *     onUseNewAddress={(addr) => setInlineAddress(addr)}
+ *   />
+ *
+ * 用法（非受控）：
+ *   <AddressPicker onSelect={(addr) => ...} />
+ *   组件内部 state；选择后回调商家拿值。
+ */
+import * as React from 'react';
+import { type Address } from './AddressBookProvider';
+export interface AddressPickerProps {
+    /** 受控：当前选中的 address ID */
+    value?: string | null;
+    /** 受控：选中变化（同时拿到 address 对象） */
+    onChange?: (addressId: string | null, address: Address | null) => void;
+    /** 非受控：选择时回调（不需要外面 state） */
+    onSelect?: (address: Address | null) => void;
+    /** 是否允许"使用新地址"选项 */
+    allowNewAddress?: boolean;
+    /** 选了"新地址"后填表保存的回调（拿到新建好的 Address） */
+    onUseNewAddress?: (address: Address) => void;
+    /** 空状态：没保存地址时显示什么。默认渲染内嵌 AddressForm */
+    emptyFallback?: React.ReactNode;
+    className?: string;
+}
+export declare function AddressPicker(props: AddressPickerProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=AddressPicker.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AddressPicker.d.ts","sourceRoot":"","sources":["../../src/components/AddressPicker.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAkB,KAAK,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAGrE,MAAM,WAAW,kBAAkB;IACjC,0BAA0B;IAC1B,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,+BAA+B;IAC/B,QAAQ,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,KAAK,IAAI,CAAC;IACvE,6BAA6B;IAC7B,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,KAAK,IAAI,CAAC;IAC7C,oBAAoB;IACpB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,sCAAsC;IACtC,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IAC7C,wCAAwC;IACxC,aAAa,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,kBAAkB,2CA8GtD"}