@hartl-services/medusa-storefront 0.1.0 → 0.2.0

package/README.md

@@ -73,6 +73,17 @@ The copied files belong to the shop: style them, rename them, change the
 wording. Keep the commerce logic in the package — a fix there reaches the shop
 with the next version; a fix only in a copied file does not.
 
+## Optional actions
+
+Some server functions are optional in `createStorefrontBrowser`'s `actions`,
+so a shop wired before they existed keeps working. Add the `"use server"`
+wrapper (as in the `setup` item's `lib/storefront/actions.ts`) to use them:
+
+| Action | Since | Used by |
+|---|---|---|
+| `registerCustomerWithProfile` | 0.2.0 | `usePasswordAuth().registerWithProfile` (name, phone, default address) |
+| `getOrder` | 0.2.0 | `useAccountOrderDetail` (order lines and totals in the account) |
+
 ## Wiring rules
 
 - Create `createStorefrontServer` and `createStorefrontBrowser` once each, at

package/dist/browser/actions.d.ts

@@ -15,6 +15,8 @@ export interface StorefrontActions {
     loginCustomer: Server["customer"]["loginCustomer"];
     checkCustomerVerification: Server["customer"]["checkCustomerVerification"];
     registerCustomer: Server["customer"]["registerCustomer"];
+    /** Optional (since 0.2.0): registration with name, phone and address. */
+    registerCustomerWithProfile?: Server["customer"]["registerCustomerWithProfile"];
     requestLoginCode: Server["customer"]["requestLoginCode"];
     loginWithCode: Server["customer"]["loginWithCode"];
     requestCustomerPasswordReset: Server["customer"]["requestCustomerPasswordReset"];
@@ -44,6 +46,8 @@ export interface StorefrontActions {
     revokeAffiliateCouponCode: Server["affiliate"]["revokeAffiliateCouponCode"];
     createConsignmentReport: Server["affiliate"]["createConsignmentReport"];
     listOrders: Server["orders"]["listOrders"];
+    /** Optional (since 0.2.0): one order with lines and totals (account order detail). */
+    getOrder?: Server["orders"]["getOrder"];
     listDocuments: Server["documents"]["listDocuments"];
 }
 export {};

package/dist/browser/cart-mutations.d.ts

@@ -25,8 +25,9 @@ export declare function createCartMutations({ actions, createClient, referral, r
     }>;
     completeCart(cartId: string): Promise<HttpTypes.StoreCompleteCartResponse>;
     /** Adds one unit of a variant, creating the cart first when there is none. */
-    addProductToCart({ activeCart, regionId, variantId }: {
+    addProductToCart({ activeCart, quantity, regionId, variantId }: {
         activeCart: Pick<HttpTypes.StoreCart, "id"> | null;
+        quantity?: number;
         regionId: string;
         variantId: string;
     }): Promise<Pick<HttpTypes.StoreCart, "id">>;

package/dist/browser/cart-mutations.js

@@ -125,10 +125,10 @@ export function createCartMutations({ actions, createClient, referral, reportChe
             return result;
         },
         /** Adds one unit of a variant, creating the cart first when there is none. */
-        async addProductToCart({ activeCart, regionId, variantId }) {
+        async addProductToCart({ activeCart, quantity = 1, regionId, variantId }) {
             const cart = activeCart ?? (await createCart({ region_id: regionId }));
             await addCartLineItem(cart.id, {
-                quantity: 1,
+                quantity,
                 variant_id: variantId,
             });
             return cart;

package/dist/browser/index.d.ts

@@ -79,8 +79,9 @@ export declare function createStorefrontBrowser(config: StorefrontBrowserConfig)
             ready: true;
         }>;
         completeCart(cartId: string): Promise<HttpTypes.StoreCompleteCartResponse>;
-        addProductToCart({ activeCart, regionId, variantId }: {
+        addProductToCart({ activeCart, quantity, regionId, variantId }: {
             activeCart: Pick<HttpTypes.StoreCart, "id"> | null;
+            quantity?: number;
             regionId: string;
             variantId: string;
         }): Promise<Pick<HttpTypes.StoreCart, "id">>;
@@ -253,6 +254,9 @@ export declare function createStorefrontBrowser(config: StorefrontBrowserConfig)
             limit: number;
             offset: number;
         }], HttpTypes.StoreOrderListResponse, Error>;
+        orderDetail: (orderId: string) => import("@tanstack/react-query").OmitKeyof<import("@tanstack/react-query").UseQueryOptions<HttpTypes.StoreOrder | null, Error, HttpTypes.StoreOrder | null, readonly ["medusa", "orders", "detail", string]>, "queryFn"> & {
+            queryFn?: import("@tanstack/react-query").QueryFunction<HttpTypes.StoreOrder | null, readonly ["medusa", "orders", "detail", string], never> | undefined;
+        } & import("@tanstack/react-query").QueryKeyWithDataTag<readonly ["medusa", "orders", "detail", string], HttpTypes.StoreOrder | null, Error>;
         customerPasswordPolicy: () => import("@tanstack/react-query").OmitKeyof<import("@tanstack/react-query").UseQueryOptions<{
             min_length: number;
             require_mixed_case: boolean;

package/dist/browser/query-keys.d.ts

@@ -11,6 +11,7 @@ export declare const medusaQueryKeys: {
         limit: number;
         offset: number;
     }];
+    orderDetail: (orderId: string) => readonly ["medusa", "orders", "detail", string];
     ordersAll: () => readonly ["medusa", "orders"];
     paymentProviders: (regionId: string) => readonly ["medusa", "payment-providers", string];
     pluginFeatures: () => readonly ["medusa", "plugin-features"];

package/dist/browser/query-keys.js

@@ -4,6 +4,8 @@ export const medusaQueryKeys = {
     customerPasswordPolicy: () => ["medusa", "customer-password-policy"],
     documents: () => ["medusa", "documents"],
     orders: (page) => ["medusa", "orders", page],
+    // Under ordersAll, so everything that resets the orders resets a detail too.
+    orderDetail: (orderId) => ["medusa", "orders", "detail", orderId],
     ordersAll: () => ["medusa", "orders"],
     paymentProviders: (regionId) => ["medusa", "payment-providers", regionId],
     pluginFeatures: () => ["medusa", "plugin-features"],

package/dist/browser/query-options.d.ts

@@ -111,6 +111,10 @@ export declare function createQueryOptions({ actions, affiliateApiPaths, cart, r
         limit: number;
         offset: number;
     }], import("@medusajs/types").StoreOrderListResponse, Error>;
+    /** One order with its lines and totals; needs the optional `getOrder` action. */
+    orderDetail: (orderId: string) => import("@tanstack/react-query").OmitKeyof<import("@tanstack/react-query").UseQueryOptions<import("@medusajs/types").StoreOrder | null, Error, import("@medusajs/types").StoreOrder | null, readonly ["medusa", "orders", "detail", string]>, "queryFn"> & {
+        queryFn?: import("@tanstack/react-query").QueryFunction<import("@medusajs/types").StoreOrder | null, readonly ["medusa", "orders", "detail", string], never> | undefined;
+    } & import("@tanstack/react-query").QueryKeyWithDataTag<readonly ["medusa", "orders", "detail", string], import("@medusajs/types").StoreOrder | null, Error>;
     customerPasswordPolicy: () => import("@tanstack/react-query").OmitKeyof<import("@tanstack/react-query").UseQueryOptions<{
         min_length: number;
         require_mixed_case: boolean;

package/dist/browser/query-options.js

@@ -78,6 +78,12 @@ export function createQueryOptions({ actions, affiliateApiPaths, cart, referral,
             queryKey: medusaQueryKeys.orders({ limit, offset }),
             queryFn: () => actions.listOrders({ limit, offset }),
         }),
+        /** One order with its lines and totals; needs the optional `getOrder` action. */
+        orderDetail: (orderId) => queryOptions({
+            queryKey: medusaQueryKeys.orderDetail(orderId),
+            queryFn: async () => (actions.getOrder ? await actions.getOrder(orderId) : null),
+            enabled: Boolean(actions.getOrder) && Boolean(orderId),
+        }),
         customerPasswordPolicy: () => queryOptions({
             queryKey: medusaQueryKeys.customerPasswordPolicy(),
             queryFn: () => actions.fetchCustomerPasswordPolicy(),

package/dist/core/catalog/category-filter.d.ts

@@ -0,0 +1,16 @@
+import type { HttpTypes } from "@medusajs/types";
+/** A category with the descendants Medusa returns for `include_descendants_tree`. */
+export type CategoryTreeNode = Pick<HttpTypes.StoreProductCategory, "id" | "handle" | "name"> & {
+    category_children?: CategoryTreeNode[] | null;
+};
+/** The category and all its descendants: choosing a parent filter includes its subcategories. */
+export declare function collectCategoryIds(category: CategoryTreeNode): string[];
+/** The node with this handle anywhere in the trees, or null. */
+export declare function findCategoryByHandle(trees: CategoryTreeNode[], handle: string): CategoryTreeNode | null;
+/**
+ * Keeps the products that match every selected filter: a product matches one
+ * filter when it belongs to the chosen category or one of its descendants.
+ * Medusa's `category_id` is an OR list, so two filters at once (e.g. an
+ * application area AND an ingredient group) are intersected here.
+ */
+export declare function filterProductsByCategories<T extends Pick<HttpTypes.StoreProduct, "categories">>(products: T[], selected: CategoryTreeNode[]): T[];

package/dist/core/catalog/category-filter.js

@@ -0,0 +1,33 @@
+/** The category and all its descendants: choosing a parent filter includes its subcategories. */
+export function collectCategoryIds(category) {
+    return [category.id, ...(category.category_children ?? []).flatMap(collectCategoryIds)];
+}
+/** The node with this handle anywhere in the trees, or null. */
+export function findCategoryByHandle(trees, handle) {
+    for (const node of trees) {
+        if (node.handle === handle) {
+            return node;
+        }
+        const match = findCategoryByHandle(node.category_children ?? [], handle);
+        if (match) {
+            return match;
+        }
+    }
+    return null;
+}
+/**
+ * Keeps the products that match every selected filter: a product matches one
+ * filter when it belongs to the chosen category or one of its descendants.
+ * Medusa's `category_id` is an OR list, so two filters at once (e.g. an
+ * application area AND an ingredient group) are intersected here.
+ */
+export function filterProductsByCategories(products, selected) {
+    if (selected.length === 0) {
+        return products;
+    }
+    const filters = selected.map((category) => new Set(collectCategoryIds(category)));
+    return products.filter((product) => {
+        const productCategoryIds = (product.categories ?? []).map((category) => category.id);
+        return filters.every((filter) => productCategoryIds.some((id) => filter.has(id)));
+    });
+}

package/dist/core/form-values.d.ts

@@ -10,6 +10,47 @@ export declare function createCustomerRegistrationSchema(t: Translate, policy: C
     email: z.ZodString;
     password: z.ZodString;
 }, z.core.$strip>;
+/** The address a registration may carry (stored as the customer's default address). */
+export declare const registrationAddressSchema: z.ZodObject<{
+    address_1: z.ZodString;
+    city: z.ZodString;
+    country_code: z.ZodString;
+    postal_code: z.ZodString;
+}, z.core.$strip>;
+/** What the server takes for a registration with profile (and optional address). */
+export declare const customerRegistrationProfileSchema: z.ZodObject<{
+    email: z.ZodString;
+    password: z.ZodString;
+    address: z.ZodOptional<z.ZodObject<{
+        address_1: z.ZodString;
+        city: z.ZodString;
+        country_code: z.ZodString;
+        postal_code: z.ZodString;
+    }, z.core.$strip>>;
+    first_name: z.ZodString;
+    last_name: z.ZodString;
+    phone: z.ZodString;
+}, z.core.$strip>;
+/**
+ * The registration form with profile, address, a repeated password and the
+ * accepted terms. Address fields are all-or-nothing: none or a complete
+ * address.
+ */
+export declare function createCustomerRegistrationFormSchema(t: Translate, policy: CustomerPasswordPolicy | null): z.ZodObject<{
+    accept_terms: z.ZodBoolean;
+    address_1: z.ZodString;
+    city: z.ZodString;
+    confirmPassword: z.ZodString;
+    country_code: z.ZodString;
+    email: z.ZodString;
+    first_name: z.ZodString;
+    last_name: z.ZodString;
+    password: z.ZodString;
+    phone: z.ZodString;
+    postal_code: z.ZodString;
+}, z.core.$strip>;
+/** The registration form's values as the server takes them. */
+export declare function toRegistrationProfile(value: CustomerRegistrationFormValues): CustomerRegistrationProfileValues;
 export declare function createPasswordResetSchema(t: Translate, policy: CustomerPasswordPolicy | null): z.ZodObject<{
     confirmPassword: z.ZodString;
     password: z.ZodString;
@@ -85,31 +126,33 @@ export declare const createCheckoutAddressSchema: (t: Translate, merchantCountry
     has_different_billing_address: z.ZodBoolean;
     shipping_address: z.ZodObject<{
         address_1: z.ZodString;
-        address_2: z.ZodString;
         city: z.ZodString;
-        company: z.ZodString;
         country_code: z.ZodString;
+        postal_code: z.ZodString;
         first_name: z.ZodString;
         last_name: z.ZodString;
         phone: z.ZodString;
-        postal_code: z.ZodString;
+        address_2: z.ZodString;
+        company: z.ZodString;
         province: z.ZodString;
     }, z.core.$strip>;
     billing_address: z.ZodObject<{
         address_1: z.ZodString;
-        address_2: z.ZodString;
         city: z.ZodString;
-        company: z.ZodString;
         country_code: z.ZodString;
+        postal_code: z.ZodString;
         first_name: z.ZodString;
         last_name: z.ZodString;
         phone: z.ZodString;
-        postal_code: z.ZodString;
+        address_2: z.ZodString;
+        company: z.ZodString;
         province: z.ZodString;
     }, z.core.$strip>;
     vat_number: z.ZodString;
 }, z.core.$strip>;
 export type CustomerAuthValues = z.infer<typeof customerAuthSchema>;
+export type CustomerRegistrationProfileValues = z.infer<typeof customerRegistrationProfileSchema>;
+export type CustomerRegistrationFormValues = z.infer<ReturnType<typeof createCustomerRegistrationFormSchema>>;
 export type LoginCodeRequestValues = z.infer<ReturnType<typeof createLoginCodeRequestSchema>>;
 export type PasswordResetValues = z.infer<ReturnType<typeof createPasswordResetSchema>>;
 export type VerificationResendValues = z.infer<ReturnType<typeof createVerificationResendSchema>>;

package/dist/core/form-values.js

@@ -27,6 +27,71 @@ export function createCustomerRegistrationSchema(t, policy) {
         password: createNewPasswordSchema(t, policy),
     });
 }
+/** The address a registration may carry (stored as the customer's default address). */
+export const registrationAddressSchema = z.object({
+    address_1: z.string().trim().min(1),
+    city: z.string().trim().min(1),
+    country_code: z.string().trim().min(1),
+    postal_code: z.string().trim().min(1),
+});
+/** What the server takes for a registration with profile (and optional address). */
+export const customerRegistrationProfileSchema = customerAuthSchema.extend({
+    address: registrationAddressSchema.optional(),
+    first_name: z.string().trim().min(1),
+    last_name: z.string().trim().min(1),
+    phone: z.string().trim(),
+});
+/**
+ * The registration form with profile, address, a repeated password and the
+ * accepted terms. Address fields are all-or-nothing: none or a complete
+ * address.
+ */
+export function createCustomerRegistrationFormSchema(t, policy) {
+    return z
+        .object({
+        accept_terms: z.boolean().refine((accepted) => accepted, t("registration.terms_required")),
+        address_1: z.string().trim(),
+        city: z.string().trim(),
+        confirmPassword: z.string(),
+        country_code: z.string().trim(),
+        email: z.string().trim().min(1, t("form.email_required")).email(t("form.email_invalid")),
+        first_name: z.string().trim().min(1, t("address.first_name_required")),
+        last_name: z.string().trim().min(1, t("address.last_name_required")),
+        password: createNewPasswordSchema(t, policy),
+        phone: z.string().trim(),
+        postal_code: z.string().trim(),
+    })
+        .superRefine((value, context) => {
+        if (value.password !== value.confirmPassword) {
+            context.addIssue({ code: "custom", message: t("form.passwords_mismatch"), path: ["confirmPassword"] });
+        }
+        const addressFields = [
+            ["address_1", "address.address_1_required"],
+            ["postal_code", "address.postal_code_required"],
+            ["city", "address.city_required"],
+            ["country_code", "address.country_required"],
+        ];
+        if (addressFields.some(([field]) => value[field])) {
+            for (const [field, code] of addressFields) {
+                if (!value[field]) {
+                    context.addIssue({ code: "custom", message: t(code), path: [field] });
+                }
+            }
+        }
+    });
+}
+/** The registration form's values as the server takes them. */
+export function toRegistrationProfile(value) {
+    const hasAddress = Boolean(value.address_1 && value.postal_code && value.city && value.country_code);
+    return {
+        email: value.email.trim(),
+        first_name: value.first_name.trim(),
+        last_name: value.last_name.trim(),
+        password: value.password,
+        phone: value.phone.trim(),
+        ...(hasAddress ? { address: { address_1: value.address_1.trim(), city: value.city.trim(), country_code: value.country_code.trim().toLowerCase(), postal_code: value.postal_code.trim() } } : {}),
+    };
+}
 export function createPasswordResetSchema(t, policy) {
     return z
         .object({

package/dist/core/index.d.ts

@@ -17,6 +17,7 @@ export * from "./cart/cart-tax-breakdown.js";
 export * from "./cart/coupon-promotions.js";
 export * from "./cart/payment-session.js";
 export * from "./cart/refunded-cart.js";
+export * from "./catalog/category-filter.js";
 export * from "./catalog/inventory.js";
 export * from "./catalog/medusa-product-image.js";
 export * from "./catalog/product-price.js";

package/dist/core/index.js

@@ -18,6 +18,7 @@ export * from "./cart/cart-tax-breakdown.js";
 export * from "./cart/coupon-promotions.js";
 export * from "./cart/payment-session.js";
 export * from "./cart/refunded-cart.js";
+export * from "./catalog/category-filter.js";
 export * from "./catalog/inventory.js";
 export * from "./catalog/medusa-product-image.js";
 export * from "./catalog/product-price.js";

package/dist/core/texts-de.d.ts

@@ -6,6 +6,8 @@
 export declare const textsDe: {
     readonly "form.password_required": "Bitte gib ein Passwort ein.";
     readonly "form.passwords_mismatch": "Die Passwörter stimmen nicht überein.";
+    readonly "registration.terms_required": "Bitte akzeptiere die Nutzungsbedingungen und Datenschutzrichtlinien.";
+    readonly "registration.address_not_saved": "Dein Konto wurde angelegt, die Adresse konnte aber nicht gespeichert werden. Du kannst sie in deinem Konto nachtragen.";
     readonly "form.email_required": "Bitte gib deine E-Mail-Adresse ein.";
     readonly "form.email_invalid": "Bitte gib eine gültige E-Mail-Adresse ein.";
     readonly "form.login_code_invalid": "Bitte gib den {length}-stelligen Code ein.";

package/dist/core/texts-de.js

@@ -8,6 +8,8 @@ export const textsDe = {
     // Forms
     "form.password_required": "Bitte gib ein Passwort ein.",
     "form.passwords_mismatch": "Die Passwörter stimmen nicht überein.",
+    "registration.terms_required": "Bitte akzeptiere die Nutzungsbedingungen und Datenschutzrichtlinien.",
+    "registration.address_not_saved": "Dein Konto wurde angelegt, die Adresse konnte aber nicht gespeichert werden. Du kannst sie in deinem Konto nachtragen.",
     "form.email_required": "Bitte gib deine E-Mail-Adresse ein.",
     "form.email_invalid": "Bitte gib eine gültige E-Mail-Adresse ein.",
     "form.login_code_invalid": "Bitte gib den {length}-stelligen Code ein.",

package/dist/react/use-account.d.ts

@@ -76,6 +76,16 @@ export declare function useAccountOrders(): {
     isPending: boolean;
     orders: HttpTypes.StoreOrder[];
 };
+/**
+ * One order of the account with its lines and totals, loaded when it is
+ * opened (the list carries only the total). Needs the shop's optional
+ * `getOrder` action; `null` loads nothing.
+ */
+export declare function useAccountOrderDetail(orderId: string | null): {
+    isError: boolean;
+    isPending: boolean;
+    order: HttpTypes.StoreOrder | null;
+};
 /** The account's address book page: add, edit (with the UID check), delete and default addresses. */
 export declare function useAccountAddresses(): {
     addressBook: {

package/dist/react/use-account.js

@@ -145,6 +145,16 @@ export function useAccountOrders() {
         orders: ordersResponse?.orders ?? [],
     };
 }
+/**
+ * One order of the account with its lines and totals, loaded when it is
+ * opened (the list carries only the total). Needs the shop's optional
+ * `getOrder` action; `null` loads nothing.
+ */
+export function useAccountOrderDetail(orderId) {
+    const { queries } = useStorefront();
+    const { data: order, isError, isFetching } = useQuery({ ...queries.orderDetail(orderId ?? ""), enabled: Boolean(orderId) && queries.orderDetail(orderId ?? "").enabled !== false });
+    return { isError, isPending: Boolean(orderId) && isFetching && !order, order: order ?? null };
+}
 /** The account's address book page: add, edit (with the UID check), delete and default addresses. */
 export function useAccountAddresses() {
     const { actions, t, unwrapMedusaAction } = useStorefront();

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

@@ -1,5 +1,5 @@
 import type { StorefrontBrowser } from "../browser/index.js";
-import type { CustomerAuthValues, PasswordResetValues, VerificationResendValues } from "../core/form-values.js";
+import type { CustomerAuthValues, CustomerRegistrationProfileValues, PasswordResetValues, VerificationResendValues } from "../core/form-values.js";
 /**
  * Start of the backend's 400 for a registration with an address that already
  * has an account; the form then links to the password reset.
@@ -48,6 +48,13 @@ export declare function usePasswordAuth({ getValues, onSuccess }: PasswordAuthOp
     cancelVerification: () => void;
     login: (value: CustomerAuthValues) => Promise<boolean>;
     register: (value: CustomerAuthValues) => Promise<boolean>;
+    /** The registration did not store its address; the account exists (add it in the account). */
+    isAddressNotSaved: boolean;
+    /**
+     * Registration with name, phone and address; needs the shop's optional
+     * `registerCustomerWithProfile` action. True once signed in.
+     */
+    registerWithProfile(value: CustomerRegistrationProfileValues): Promise<boolean>;
     /** "I confirmed it": signs in again with the kept form values, also after a registration (the account exists by now). */
     continueAfterVerification(): Promise<void>;
 };

package/dist/react/use-auth.js

@@ -73,6 +73,8 @@ export function usePasswordAuth({ getValues, onSuccess }) {
     // Set while the backend waits for the address to be confirmed; replaces the form with the next steps.
     const [verification, setVerification] = useState(null);
     const [isContinuing, setIsContinuing] = useState(false);
+    // A registration with profile succeeded but its address could not be stored.
+    const [isAddressNotSaved, setIsAddressNotSaved] = useState(false);
     // The background check and the "continue" button must not sign in twice.
     const confirmationSignIn = useRef("idle");
     async function completeSignIn(sessionToken) {
@@ -130,6 +132,36 @@ export function usePasswordAuth({ getValues, onSuccess }) {
         cancelVerification: () => setVerification(null),
         login: (value) => authenticate(actions.loginCustomer, value),
         register: (value) => authenticate(actions.registerCustomer, value),
+        /** The registration did not store its address; the account exists (add it in the account). */
+        isAddressNotSaved,
+        /**
+         * Registration with name, phone and address; needs the shop's optional
+         * `registerCustomerWithProfile` action. True once signed in.
+         */
+        async registerWithProfile(value) {
+            const action = actions.registerCustomerWithProfile;
+            setErrorMessage(null);
+            setIsAddressNotSaved(false);
+            if (!action) {
+                setErrorMessage(t("auth.registration_unsupported_step"));
+                return false;
+            }
+            try {
+                const result = unwrapMedusaAction(await action(value));
+                if (result.state === "verification_required") {
+                    setVerification((current) => ({ email: value.email, stillUnverified: current !== null }));
+                    return false;
+                }
+                setIsAddressNotSaved(!result.addressSaved);
+                await completeSignIn(result.sessionToken);
+                return true;
+            }
+            catch (error) {
+                setVerification(null);
+                setErrorMessage(t.message(getErrorMessage(error, t("auth.sign_in_failed"))));
+                return false;
+            }
+        },
         /** "I confirmed it": signs in again with the kept form values, also after a registration (the account exists by now). */
         async continueAfterVerification() {
             setIsContinuing(true);

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

@@ -7,11 +7,36 @@ export declare function useActiveCart(): import("@tanstack/react-query").UseQuer
  * opening its cart popover).
  */
 export declare function useAddToCart(countryCode: string): {
-    addToCart: (variant: HttpTypes.StoreProductVariant) => Promise<void>;
+    addToCart: (variant: HttpTypes.StoreProductVariant, quantity?: number) => Promise<void>;
     errorMessage: string | null;
     isReady: boolean;
     isSubmitting: boolean;
 };
+/** A line of an earlier order to put into the cart again. */
+export interface ReorderLine {
+    /** Order line id; reported back for the lines that could not be added. */
+    id: string;
+    quantity: number;
+    title: string;
+    /** Null once the variant was deleted. */
+    variant_id: string | null | undefined;
+}
+/**
+ * Puts lines of an earlier order into the active cart again ("Erneut
+ * bestellen", or one line). Medusa has no reorder endpoint, so the lines are
+ * added one after another into the same cart (the first add may create it);
+ * a deleted, unavailable or refused line is reported in `failedLines` while
+ * the others are still added.
+ */
+export declare function useReorder(countryCode: string): {
+    failedLines: ReorderLine[];
+    isReady: boolean;
+    isSubmitting: boolean;
+    reorder: (lines: ReorderLine[]) => Promise<{
+        added: number;
+        failed: ReorderLine[];
+    } | undefined>;
+};
 /**
  * Runs one line-item change at a time (quantity, removal) through the "cart
  * price changed" boundary; `pendingItemId` marks the line that is busy.

package/dist/react/use-cart.js

@@ -23,16 +23,17 @@ export function useAddToCart(countryCode) {
     const [isSubmitting, setIsSubmitting] = useState(false);
     const { data: activeCart, isPending: isCartPending } = useQuery(queries.activeCart());
     const { data: region } = useQuery(queries.region(countryCode));
-    const addToCart = async (variant) => {
+    /** Adds `quantity` (a whole number of at least 1, default 1) of the variant. */
+    const addToCart = async (variant, quantity = 1) => {
         // activeCart is undefined while the query is still pending - that must
         // never be mistaken for "no cart yet" (which would create a second cart).
-        if (!region?.id || activeCart === undefined) {
+        if (!region?.id || activeCart === undefined || !Number.isInteger(quantity) || quantity < 1) {
             return;
         }
         setErrorMessage(null);
         setIsSubmitting(true);
         try {
-            await storefront.cart.addProductToCart({ activeCart, regionId: region.id, variantId: variant.id });
+            await storefront.cart.addProductToCart({ activeCart, quantity, regionId: region.id, variantId: variant.id });
             await storefront.refreshCartAfterMutation(queryClient);
             callbacks.onAddedToCart?.(variant);
         }
@@ -45,6 +46,52 @@ export function useAddToCart(countryCode) {
     };
     return { addToCart, errorMessage, isReady: Boolean(region?.id) && !isCartPending, isSubmitting };
 }
+/**
+ * Puts lines of an earlier order into the active cart again ("Erneut
+ * bestellen", or one line). Medusa has no reorder endpoint, so the lines are
+ * added one after another into the same cart (the first add may create it);
+ * a deleted, unavailable or refused line is reported in `failedLines` while
+ * the others are still added.
+ */
+export function useReorder(countryCode) {
+    const storefront = useStorefront();
+    const { queries } = storefront;
+    const queryClient = useQueryClient();
+    const [failedLines, setFailedLines] = useState([]);
+    const [isSubmitting, setIsSubmitting] = useState(false);
+    const { data: activeCart, isPending: isCartPending } = useQuery(queries.activeCart());
+    const { data: region } = useQuery(queries.region(countryCode));
+    const reorder = async (lines) => {
+        if (!region?.id || activeCart === undefined) {
+            return;
+        }
+        setFailedLines([]);
+        setIsSubmitting(true);
+        const failed = [];
+        let cart = activeCart;
+        try {
+            for (const line of lines) {
+                if (!line.variant_id || !Number.isInteger(line.quantity) || line.quantity < 1) {
+                    failed.push(line);
+                    continue;
+                }
+                try {
+                    cart = await storefront.cart.addProductToCart({ activeCart: cart, quantity: line.quantity, regionId: region.id, variantId: line.variant_id });
+                }
+                catch {
+                    failed.push(line);
+                }
+            }
+            await storefront.refreshCartAfterMutation(queryClient);
+        }
+        finally {
+            setFailedLines(failed);
+            setIsSubmitting(false);
+        }
+        return { added: lines.length - failed.length, failed };
+    };
+    return { failedLines, isReady: Boolean(region?.id) && !isCartPending, isSubmitting, reorder };
+}
 /**
  * Runs one line-item change at a time (quantity, removal) through the "cart
  * price changed" boundary; `pendingItemId` marks the line that is busy.

package/dist/react/use-checkout-address-form.d.ts

@@ -34,26 +34,26 @@ export declare function useCheckoutAddressForm({ countryCode, countryOptions, in
         has_different_billing_address: boolean;
         shipping_address: {
             address_1: string;
-            address_2: string;
             city: string;
-            company: string;
             country_code: string;
+            postal_code: string;
             first_name: string;
             last_name: string;
             phone: string;
-            postal_code: string;
+            address_2: string;
+            company: string;
             province: string;
         };
         billing_address: {
             address_1: string;
-            address_2: string;
             city: string;
-            company: string;
             country_code: string;
+            postal_code: string;
             first_name: string;
             last_name: string;
             phone: string;
-            postal_code: string;
+            address_2: string;
+            company: string;
             province: string;
         };
         vat_number: string;
@@ -68,26 +68,26 @@ export declare function useCheckoutAddressForm({ countryCode, countryOptions, in
             has_different_billing_address: boolean;
             shipping_address: {
                 address_1: string;
-                address_2: string;
                 city: string;
-                company: string;
                 country_code: string;
+                postal_code: string;
                 first_name: string;
                 last_name: string;
                 phone: string;
-                postal_code: string;
+                address_2: string;
+                company: string;
                 province: string;
             };
             billing_address: {
                 address_1: string;
-                address_2: string;
                 city: string;
-                company: string;
                 country_code: string;
+                postal_code: string;
                 first_name: string;
                 last_name: string;
                 phone: string;
-                postal_code: string;
+                address_2: string;
+                company: string;
                 province: string;
             };
             vat_number: string;
@@ -104,26 +104,26 @@ export declare function useCheckoutAddressForm({ countryCode, countryOptions, in
                 has_different_billing_address: import("zod").ZodBoolean;
                 shipping_address: import("zod").ZodObject<{
                     address_1: import("zod").ZodString;
-                    address_2: import("zod").ZodString;
                     city: import("zod").ZodString;
-                    company: import("zod").ZodString;
                     country_code: import("zod").ZodString;
+                    postal_code: import("zod").ZodString;
                     first_name: import("zod").ZodString;
                     last_name: import("zod").ZodString;
                     phone: import("zod").ZodString;
-                    postal_code: import("zod").ZodString;
+                    address_2: import("zod").ZodString;
+                    company: import("zod").ZodString;
                     province: import("zod").ZodString;
                 }, import("zod/v4/core").$strip>;
                 billing_address: import("zod").ZodObject<{
                     address_1: import("zod").ZodString;
-                    address_2: import("zod").ZodString;
                     city: import("zod").ZodString;
-                    company: import("zod").ZodString;
                     country_code: import("zod").ZodString;
+                    postal_code: import("zod").ZodString;
                     first_name: import("zod").ZodString;
                     last_name: import("zod").ZodString;
                     phone: import("zod").ZodString;
-                    postal_code: import("zod").ZodString;
+                    address_2: import("zod").ZodString;
+                    company: import("zod").ZodString;
                     province: import("zod").ZodString;
                 }, import("zod/v4/core").$strip>;
                 vat_number: import("zod").ZodString;

package/dist/react/use-checkout.d.ts

@@ -28,26 +28,26 @@ export declare function useCheckout(countryCode: string): {
         has_different_billing_address: boolean;
         shipping_address: {
             address_1: string;
-            address_2: string;
             city: string;
-            company: string;
             country_code: string;
+            postal_code: string;
             first_name: string;
             last_name: string;
             phone: string;
-            postal_code: string;
+            address_2: string;
+            company: string;
             province: string;
         };
         billing_address: {
             address_1: string;
-            address_2: string;
             city: string;
-            company: string;
             country_code: string;
+            postal_code: string;
             first_name: string;
             last_name: string;
             phone: string;
-            postal_code: string;
+            address_2: string;
+            company: string;
             province: string;
         };
         vat_number: string;
@@ -59,26 +59,26 @@ export declare function useCheckout(countryCode: string): {
         has_different_billing_address: boolean;
         shipping_address: {
             address_1: string;
-            address_2: string;
             city: string;
-            company: string;
             country_code: string;
+            postal_code: string;
             first_name: string;
             last_name: string;
             phone: string;
-            postal_code: string;
+            address_2: string;
+            company: string;
             province: string;
         };
         billing_address: {
             address_1: string;
-            address_2: string;
             city: string;
-            company: string;
             country_code: string;
+            postal_code: string;
             first_name: string;
             last_name: string;
             phone: string;
-            postal_code: string;
+            address_2: string;
+            company: string;
             province: string;
         };
         vat_number: string;

package/dist/registry/account.json

@@ -4,7 +4,7 @@
   "title": "Customer account",
   "description": "Sign-in with password or e-mail code, password reset, account verification, address book with UID check, profile, orders, the account workspace layout and the document download route.",
   "dependencies": [
-    "@hartl-services/medusa-storefront@^0.1.0",
+    "@hartl-services/medusa-storefront@^0.2.0",
     "@hartl-services/medusa-contracts@^1.1.0",
     "@medusajs/types@^2.19.0",
     "lucide-react"

package/dist/registry/affiliate.json

@@ -4,7 +4,7 @@
   "title": "Partner portal",
   "description": "Partner portal: gated registration with UID check, links, coupon codes, commissions with date filter, consignment reports, and its Route Handlers.",
   "dependencies": [
-    "@hartl-services/medusa-storefront@^0.1.0",
+    "@hartl-services/medusa-storefront@^0.2.0",
     "@hartl-services/medusa-contracts@^1.1.0",
     "@medusajs/types@^2.19.0",
     "lucide-react",

package/dist/registry/cart.json

@@ -4,7 +4,7 @@
   "title": "Cart",
   "description": "Cart widget with popover, line items, totals, cart page, add-to-cart button, variant picker and product price.",
   "dependencies": [
-    "@hartl-services/medusa-storefront@^0.1.0",
+    "@hartl-services/medusa-storefront@^0.2.0",
     "@medusajs/types@^2.19.0",
     "lucide-react"
   ],

package/dist/registry/checkout.json

@@ -4,7 +4,7 @@
   "title": "Checkout",
   "description": "Checkout page (address, login prompt, shipping and Stripe payment, coupon, UID status) and the order confirmation page.",
   "dependencies": [
-    "@hartl-services/medusa-storefront@^0.1.0",
+    "@hartl-services/medusa-storefront@^0.2.0",
     "@medusajs/types@^2.19.0",
     "@stripe/react-stripe-js@^5.6.1",
     "@stripe/stripe-js@^8.11.0",

package/dist/registry/form.json

@@ -4,7 +4,7 @@
   "title": "Storefront form kit",
   "description": "The shop's TanStack form hook (useAppForm) with unstyled field components; the package's hooks hand their formOptions to it.",
   "dependencies": [
-    "@hartl-services/medusa-storefront@^0.1.0",
+    "@hartl-services/medusa-storefront@^0.2.0",
     "@tanstack/react-form@^1.33.5",
     "input-otp",
     "lucide-react"

package/dist/registry/registry.json

@@ -7,7 +7,7 @@
       "title": "Storefront setup",
       "description": "Wires the storefront package into a Next shop: server and browser instances, the Server Action wrappers, texts, error reporting and the provider root for the [countryCode] layout.",
       "dependencies": [
-        "@hartl-services/medusa-storefront@^0.1.0",
+        "@hartl-services/medusa-storefront@^0.2.0",
         "@hartl-services/medusa-contracts@^1.1.0",
         "@medusajs/framework@^2.19.0",
         "@medusajs/js-sdk@^2.19.0",
@@ -73,7 +73,7 @@
       "title": "Storefront form kit",
       "description": "The shop's TanStack form hook (useAppForm) with unstyled field components; the package's hooks hand their formOptions to it.",
       "dependencies": [
-        "@hartl-services/medusa-storefront@^0.1.0",
+        "@hartl-services/medusa-storefront@^0.2.0",
         "@tanstack/react-form@^1.33.5",
         "input-otp",
         "lucide-react"
@@ -197,7 +197,7 @@
       "title": "Cart",
       "description": "Cart widget with popover, line items, totals, cart page, add-to-cart button, variant picker and product price.",
       "dependencies": [
-        "@hartl-services/medusa-storefront@^0.1.0",
+        "@hartl-services/medusa-storefront@^0.2.0",
         "@medusajs/types@^2.19.0",
         "lucide-react"
       ],
@@ -306,7 +306,7 @@
       "title": "Customer account",
       "description": "Sign-in with password or e-mail code, password reset, account verification, address book with UID check, profile, orders, the account workspace layout and the document download route.",
       "dependencies": [
-        "@hartl-services/medusa-storefront@^0.1.0",
+        "@hartl-services/medusa-storefront@^0.2.0",
         "@hartl-services/medusa-contracts@^1.1.0",
         "@medusajs/types@^2.19.0",
         "lucide-react"
@@ -516,7 +516,7 @@
       "title": "Checkout",
       "description": "Checkout page (address, login prompt, shipping and Stripe payment, coupon, UID status) and the order confirmation page.",
       "dependencies": [
-        "@hartl-services/medusa-storefront@^0.1.0",
+        "@hartl-services/medusa-storefront@^0.2.0",
         "@medusajs/types@^2.19.0",
         "@stripe/react-stripe-js@^5.6.1",
         "@stripe/stripe-js@^8.11.0",
@@ -661,7 +661,7 @@
       "title": "Partner portal",
       "description": "Partner portal: gated registration with UID check, links, coupon codes, commissions with date filter, consignment reports, and its Route Handlers.",
       "dependencies": [
-        "@hartl-services/medusa-storefront@^0.1.0",
+        "@hartl-services/medusa-storefront@^0.2.0",
         "@hartl-services/medusa-contracts@^1.1.0",
         "@medusajs/types@^2.19.0",
         "lucide-react",

package/dist/registry/setup.json

@@ -4,7 +4,7 @@
   "title": "Storefront setup",
   "description": "Wires the storefront package into a Next shop: server and browser instances, the Server Action wrappers, texts, error reporting and the provider root for the [countryCode] layout.",
   "dependencies": [
-    "@hartl-services/medusa-storefront@^0.1.0",
+    "@hartl-services/medusa-storefront@^0.2.0",
     "@hartl-services/medusa-contracts@^1.1.0",
     "@medusajs/framework@^2.19.0",
     "@medusajs/js-sdk@^2.19.0",
@@ -34,7 +34,7 @@
       "path": "registry/items/setup/lib/storefront/actions.ts",
       "target": "@lib/storefront/actions.ts",
       "type": "registry:lib",
-      "content": "\"use server\"\n\n// One Server Action per storefront server function: Next only accepts \"use server\"\n// functions defined in the app. The browser side gets them through lib/storefront/client.ts.\n\nimport { storefront } from \"@/lib/storefront/server\"\n\nexport async function getActiveCart(...args: Parameters<typeof storefront.cart.getActiveCart>) {\n  return await storefront.cart.getActiveCart(...args)\n}\n\nexport async function applyCustomerDefaultsToActiveCart(...args: Parameters<typeof storefront.cart.applyCustomerDefaultsToActiveCart>) {\n  return await storefront.cart.applyCustomerDefaultsToActiveCart(...args)\n}\n\nexport async function syncCartId(...args: Parameters<typeof storefront.cart.syncCartId>) {\n  return await storefront.cart.syncCartId(...args)\n}\n\nexport async function clearCartId(...args: Parameters<typeof storefront.cart.clearCartId>) {\n  return await storefront.cart.clearCartId(...args)\n}\n\nexport async function discardActiveCart(...args: Parameters<typeof storefront.cart.discardActiveCart>) {\n  return await storefront.cart.discardActiveCart(...args)\n}\n\nexport async function retrieveCustomer(...args: Parameters<typeof storefront.customer.retrieveCustomer>) {\n  return await storefront.customer.retrieveCustomer(...args)\n}\n\nexport async function loginCustomer(...args: Parameters<typeof storefront.customer.loginCustomer>) {\n  return await storefront.customer.loginCustomer(...args)\n}\n\nexport async function checkCustomerVerification(...args: Parameters<typeof storefront.customer.checkCustomerVerification>) {\n  return await storefront.customer.checkCustomerVerification(...args)\n}\n\nexport async function registerCustomer(...args: Parameters<typeof storefront.customer.registerCustomer>) {\n  return await storefront.customer.registerCustomer(...args)\n}\n\nexport async function requestLoginCode(...args: Parameters<typeof storefront.customer.requestLoginCode>) {\n  return await storefront.customer.requestLoginCode(...args)\n}\n\nexport async function loginWithCode(...args: Parameters<typeof storefront.customer.loginWithCode>) {\n  return await storefront.customer.loginWithCode(...args)\n}\n\nexport async function requestCustomerPasswordReset(...args: Parameters<typeof storefront.customer.requestCustomerPasswordReset>) {\n  return await storefront.customer.requestCustomerPasswordReset(...args)\n}\n\nexport async function resetCustomerPassword(...args: Parameters<typeof storefront.customer.resetCustomerPassword>) {\n  return await storefront.customer.resetCustomerPassword(...args)\n}\n\nexport async function confirmCustomerEmail(...args: Parameters<typeof storefront.customer.confirmCustomerEmail>) {\n  return await storefront.customer.confirmCustomerEmail(...args)\n}\n\nexport async function resendCustomerVerification(...args: Parameters<typeof storefront.customer.resendCustomerVerification>) {\n  return await storefront.customer.resendCustomerVerification(...args)\n}\n\nexport async function fetchCustomerPasswordPolicy(...args: Parameters<typeof storefront.customer.fetchCustomerPasswordPolicy>) {\n  return await storefront.customer.fetchCustomerPasswordPolicy(...args)\n}\n\nexport async function updateCustomer(...args: Parameters<typeof storefront.customer.updateCustomer>) {\n  return await storefront.customer.updateCustomer(...args)\n}\n\nexport async function createCustomerAddress(...args: Parameters<typeof storefront.customer.createCustomerAddress>) {\n  return await storefront.customer.createCustomerAddress(...args)\n}\n\nexport async function saveFirstCheckoutAddresses(...args: Parameters<typeof storefront.customer.saveFirstCheckoutAddresses>) {\n  return await storefront.customer.saveFirstCheckoutAddresses(...args)\n}\n\nexport async function updateCustomerAddress(...args: Parameters<typeof storefront.customer.updateCustomerAddress>) {\n  return await storefront.customer.updateCustomerAddress(...args)\n}\n\nexport async function deleteCustomerAddress(...args: Parameters<typeof storefront.customer.deleteCustomerAddress>) {\n  return await storefront.customer.deleteCustomerAddress(...args)\n}\n\nexport async function logoutCustomer(...args: Parameters<typeof storefront.customer.logoutCustomer>) {\n  return await storefront.customer.logoutCustomer(...args)\n}\n\nexport async function listShippingOptions(...args: Parameters<typeof storefront.checkout.listShippingOptions>) {\n  return await storefront.checkout.listShippingOptions(...args)\n}\n\nexport async function listPaymentProviders(...args: Parameters<typeof storefront.checkout.listPaymentProviders>) {\n  return await storefront.checkout.listPaymentProviders(...args)\n}\n\nexport async function listRegions(...args: Parameters<typeof storefront.region.listRegions>) {\n  return await storefront.region.listRegions(...args)\n}\n\nexport async function fetchPluginFeatures(...args: Parameters<typeof storefront.pluginFeatures.fetchPluginFeatures>) {\n  return await storefront.pluginFeatures.fetchPluginFeatures(...args)\n}\n\nexport async function checkCartTaxIdentification(...args: Parameters<typeof storefront.taxCompliance.checkCartTaxIdentification>) {\n  return await storefront.taxCompliance.checkCartTaxIdentification(...args)\n}\n\nexport async function listCustomerTaxIdentifications(...args: Parameters<typeof storefront.taxCompliance.listCustomerTaxIdentifications>) {\n  return await storefront.taxCompliance.listCustomerTaxIdentifications(...args)\n}\n\nexport async function verifyCustomerAddressTaxIdentification(...args: Parameters<typeof storefront.taxCompliance.verifyCustomerAddressTaxIdentification>) {\n  return await storefront.taxCompliance.verifyCustomerAddressTaxIdentification(...args)\n}\n\nexport async function submitAffiliateApplication(...args: Parameters<typeof storefront.affiliate.submitAffiliateApplication>) {\n  return await storefront.affiliate.submitAffiliateApplication(...args)\n}\n\nexport async function applyAffiliateOwnOrderPromotion(...args: Parameters<typeof storefront.affiliate.applyAffiliateOwnOrderPromotion>) {\n  return await storefront.affiliate.applyAffiliateOwnOrderPromotion(...args)\n}\n\nexport async function createAffiliateSlug(...args: Parameters<typeof storefront.affiliate.createAffiliateSlug>) {\n  return await storefront.affiliate.createAffiliateSlug(...args)\n}\n\nexport async function updateAffiliateSlug(...args: Parameters<typeof storefront.affiliate.updateAffiliateSlug>) {\n  return await storefront.affiliate.updateAffiliateSlug(...args)\n}\n\nexport async function createAffiliateCouponCode(...args: Parameters<typeof storefront.affiliate.createAffiliateCouponCode>) {\n  return await storefront.affiliate.createAffiliateCouponCode(...args)\n}\n\nexport async function rotateAffiliateCouponCode(...args: Parameters<typeof storefront.affiliate.rotateAffiliateCouponCode>) {\n  return await storefront.affiliate.rotateAffiliateCouponCode(...args)\n}\n\nexport async function revokeAffiliateCouponCode(...args: Parameters<typeof storefront.affiliate.revokeAffiliateCouponCode>) {\n  return await storefront.affiliate.revokeAffiliateCouponCode(...args)\n}\n\nexport async function createConsignmentReport(...args: Parameters<typeof storefront.affiliate.createConsignmentReport>) {\n  return await storefront.affiliate.createConsignmentReport(...args)\n}\n\nexport async function listOrders(...args: Parameters<typeof storefront.orders.listOrders>) {\n  return await storefront.orders.listOrders(...args)\n}\n\nexport async function listDocuments(...args: Parameters<typeof storefront.documents.listDocuments>) {\n  return await storefront.documents.listDocuments(...args)\n}\n"
+      "content": "\"use server\"\n\n// One Server Action per storefront server function: Next only accepts \"use server\"\n// functions defined in the app. The browser side gets them through lib/storefront/client.ts.\n\nimport { storefront } from \"@/lib/storefront/server\"\n\nexport async function getActiveCart(...args: Parameters<typeof storefront.cart.getActiveCart>) {\n  return await storefront.cart.getActiveCart(...args)\n}\n\nexport async function applyCustomerDefaultsToActiveCart(...args: Parameters<typeof storefront.cart.applyCustomerDefaultsToActiveCart>) {\n  return await storefront.cart.applyCustomerDefaultsToActiveCart(...args)\n}\n\nexport async function syncCartId(...args: Parameters<typeof storefront.cart.syncCartId>) {\n  return await storefront.cart.syncCartId(...args)\n}\n\nexport async function clearCartId(...args: Parameters<typeof storefront.cart.clearCartId>) {\n  return await storefront.cart.clearCartId(...args)\n}\n\nexport async function discardActiveCart(...args: Parameters<typeof storefront.cart.discardActiveCart>) {\n  return await storefront.cart.discardActiveCart(...args)\n}\n\nexport async function retrieveCustomer(...args: Parameters<typeof storefront.customer.retrieveCustomer>) {\n  return await storefront.customer.retrieveCustomer(...args)\n}\n\nexport async function loginCustomer(...args: Parameters<typeof storefront.customer.loginCustomer>) {\n  return await storefront.customer.loginCustomer(...args)\n}\n\nexport async function checkCustomerVerification(...args: Parameters<typeof storefront.customer.checkCustomerVerification>) {\n  return await storefront.customer.checkCustomerVerification(...args)\n}\n\nexport async function registerCustomer(...args: Parameters<typeof storefront.customer.registerCustomer>) {\n  return await storefront.customer.registerCustomer(...args)\n}\n\nexport async function registerCustomerWithProfile(...args: Parameters<typeof storefront.customer.registerCustomerWithProfile>) {\n  return await storefront.customer.registerCustomerWithProfile(...args)\n}\n\nexport async function requestLoginCode(...args: Parameters<typeof storefront.customer.requestLoginCode>) {\n  return await storefront.customer.requestLoginCode(...args)\n}\n\nexport async function loginWithCode(...args: Parameters<typeof storefront.customer.loginWithCode>) {\n  return await storefront.customer.loginWithCode(...args)\n}\n\nexport async function requestCustomerPasswordReset(...args: Parameters<typeof storefront.customer.requestCustomerPasswordReset>) {\n  return await storefront.customer.requestCustomerPasswordReset(...args)\n}\n\nexport async function resetCustomerPassword(...args: Parameters<typeof storefront.customer.resetCustomerPassword>) {\n  return await storefront.customer.resetCustomerPassword(...args)\n}\n\nexport async function confirmCustomerEmail(...args: Parameters<typeof storefront.customer.confirmCustomerEmail>) {\n  return await storefront.customer.confirmCustomerEmail(...args)\n}\n\nexport async function resendCustomerVerification(...args: Parameters<typeof storefront.customer.resendCustomerVerification>) {\n  return await storefront.customer.resendCustomerVerification(...args)\n}\n\nexport async function fetchCustomerPasswordPolicy(...args: Parameters<typeof storefront.customer.fetchCustomerPasswordPolicy>) {\n  return await storefront.customer.fetchCustomerPasswordPolicy(...args)\n}\n\nexport async function updateCustomer(...args: Parameters<typeof storefront.customer.updateCustomer>) {\n  return await storefront.customer.updateCustomer(...args)\n}\n\nexport async function createCustomerAddress(...args: Parameters<typeof storefront.customer.createCustomerAddress>) {\n  return await storefront.customer.createCustomerAddress(...args)\n}\n\nexport async function saveFirstCheckoutAddresses(...args: Parameters<typeof storefront.customer.saveFirstCheckoutAddresses>) {\n  return await storefront.customer.saveFirstCheckoutAddresses(...args)\n}\n\nexport async function updateCustomerAddress(...args: Parameters<typeof storefront.customer.updateCustomerAddress>) {\n  return await storefront.customer.updateCustomerAddress(...args)\n}\n\nexport async function deleteCustomerAddress(...args: Parameters<typeof storefront.customer.deleteCustomerAddress>) {\n  return await storefront.customer.deleteCustomerAddress(...args)\n}\n\nexport async function logoutCustomer(...args: Parameters<typeof storefront.customer.logoutCustomer>) {\n  return await storefront.customer.logoutCustomer(...args)\n}\n\nexport async function listShippingOptions(...args: Parameters<typeof storefront.checkout.listShippingOptions>) {\n  return await storefront.checkout.listShippingOptions(...args)\n}\n\nexport async function listPaymentProviders(...args: Parameters<typeof storefront.checkout.listPaymentProviders>) {\n  return await storefront.checkout.listPaymentProviders(...args)\n}\n\nexport async function listRegions(...args: Parameters<typeof storefront.region.listRegions>) {\n  return await storefront.region.listRegions(...args)\n}\n\nexport async function fetchPluginFeatures(...args: Parameters<typeof storefront.pluginFeatures.fetchPluginFeatures>) {\n  return await storefront.pluginFeatures.fetchPluginFeatures(...args)\n}\n\nexport async function checkCartTaxIdentification(...args: Parameters<typeof storefront.taxCompliance.checkCartTaxIdentification>) {\n  return await storefront.taxCompliance.checkCartTaxIdentification(...args)\n}\n\nexport async function listCustomerTaxIdentifications(...args: Parameters<typeof storefront.taxCompliance.listCustomerTaxIdentifications>) {\n  return await storefront.taxCompliance.listCustomerTaxIdentifications(...args)\n}\n\nexport async function verifyCustomerAddressTaxIdentification(...args: Parameters<typeof storefront.taxCompliance.verifyCustomerAddressTaxIdentification>) {\n  return await storefront.taxCompliance.verifyCustomerAddressTaxIdentification(...args)\n}\n\nexport async function submitAffiliateApplication(...args: Parameters<typeof storefront.affiliate.submitAffiliateApplication>) {\n  return await storefront.affiliate.submitAffiliateApplication(...args)\n}\n\nexport async function applyAffiliateOwnOrderPromotion(...args: Parameters<typeof storefront.affiliate.applyAffiliateOwnOrderPromotion>) {\n  return await storefront.affiliate.applyAffiliateOwnOrderPromotion(...args)\n}\n\nexport async function createAffiliateSlug(...args: Parameters<typeof storefront.affiliate.createAffiliateSlug>) {\n  return await storefront.affiliate.createAffiliateSlug(...args)\n}\n\nexport async function updateAffiliateSlug(...args: Parameters<typeof storefront.affiliate.updateAffiliateSlug>) {\n  return await storefront.affiliate.updateAffiliateSlug(...args)\n}\n\nexport async function createAffiliateCouponCode(...args: Parameters<typeof storefront.affiliate.createAffiliateCouponCode>) {\n  return await storefront.affiliate.createAffiliateCouponCode(...args)\n}\n\nexport async function rotateAffiliateCouponCode(...args: Parameters<typeof storefront.affiliate.rotateAffiliateCouponCode>) {\n  return await storefront.affiliate.rotateAffiliateCouponCode(...args)\n}\n\nexport async function revokeAffiliateCouponCode(...args: Parameters<typeof storefront.affiliate.revokeAffiliateCouponCode>) {\n  return await storefront.affiliate.revokeAffiliateCouponCode(...args)\n}\n\nexport async function createConsignmentReport(...args: Parameters<typeof storefront.affiliate.createConsignmentReport>) {\n  return await storefront.affiliate.createConsignmentReport(...args)\n}\n\nexport async function listOrders(...args: Parameters<typeof storefront.orders.listOrders>) {\n  return await storefront.orders.listOrders(...args)\n}\n\nexport async function getOrder(...args: Parameters<typeof storefront.orders.getOrder>) {\n  return await storefront.orders.getOrder(...args)\n}\n\nexport async function listDocuments(...args: Parameters<typeof storefront.documents.listDocuments>) {\n  return await storefront.documents.listDocuments(...args)\n}\n"
     },
     {
       "path": "registry/items/setup/lib/storefront/client.ts",

package/dist/server/catalog.d.ts

@@ -6,14 +6,22 @@ export interface CommerceProductListInput {
     collectionId?: string;
     countryCode: string;
     handles?: string[];
+    /** Medusa's product search (title, description, handle, ...). */
+    q?: string;
 }
 /** Medusa's half of a catalog: products priced for a country, categories and collections. */
 export declare function createCatalog(context: ServerContext, region: ServerRegion): {
-    listCommerceProducts({ categoryId, collectionId, countryCode, handles }: CommerceProductListInput): Promise<HttpTypes.StoreProduct[] | null>;
+    listCommerceProducts({ categoryId, collectionId, countryCode, handles, q }: CommerceProductListInput): Promise<HttpTypes.StoreProduct[] | null>;
     commerceProductByHandle({ countryCode, handle }: {
         countryCode: string;
         handle: string;
     }): Promise<HttpTypes.StoreProduct | null>;
+    /**
+     * The top-level categories with all descendants (e.g. "Anwendungsbereiche"
+     * and "Inhaltsstoffe" with their entries) - the filter trees of a product
+     * list; filter with `filterProductsByCategories` from /core.
+     */
+    listCategoryTrees(): Promise<HttpTypes.StoreProductCategory[]>;
     categoryByPath(categoryPath: string[]): Promise<HttpTypes.StoreProductCategory | null>;
     collectionByHandle(handle: string): Promise<HttpTypes.StoreCollection | null>;
 };

package/dist/server/catalog.js

@@ -14,7 +14,7 @@ export function createCatalog(context, region) {
         };
     }
     return {
-        async listCommerceProducts({ categoryId, collectionId, countryCode, handles }) {
+        async listCommerceProducts({ categoryId, collectionId, countryCode, handles, q }) {
             const pricingContext = await getPricingContext(countryCode);
             if (!pricingContext) {
                 return null;
@@ -25,6 +25,7 @@ export function createCatalog(context, region) {
                 ...(categoryId ? { category_id: [categoryId] } : {}),
                 ...(collectionId ? { collection_id: [collectionId] } : {}),
                 ...(handles?.length ? { handle: handles } : {}),
+                ...(q?.trim() ? { q: q.trim() } : {}),
                 fields: PRODUCT_FIELDS,
                 limit: catalogFetchLimit,
             });
@@ -44,6 +45,21 @@ export function createCatalog(context, region) {
             });
             return products[0] ?? null;
         },
+        /**
+         * The top-level categories with all descendants (e.g. "Anwendungsbereiche"
+         * and "Inhaltsstoffe" with their entries) - the filter trees of a product
+         * list; filter with `filterProductsByCategories` from /core.
+         */
+        async listCategoryTrees() {
+            const sdk = context.createMedusaClient();
+            const { product_categories: productCategories } = await sdk.store.category.list({
+                fields: "id,name,handle,description,metadata,rank,*category_children",
+                include_descendants_tree: true,
+                limit: catalogFetchLimit,
+                parent_category_id: "null",
+            });
+            return productCategories;
+        },
         async categoryByPath(categoryPath) {
             const sdk = context.createMedusaClient();
             const { product_categories: productCategories } = await sdk.store.category.list({

package/dist/server/customer.d.ts

@@ -1,5 +1,5 @@
 import type { LoginWithCodeRequest, RequestLoginCodeRequest } from "@hartl-services/medusa-contracts/types/customer-auth-store";
-import type { CheckoutAddressValues, CustomerAddressValues, CustomerAuthValues, CustomerProfileValues, VerificationResendValues } from "../core/form-values.js";
+import type { CheckoutAddressValues, CustomerAddressValues, CustomerAuthValues, CustomerProfileValues, CustomerRegistrationProfileValues, VerificationResendValues } from "../core/form-values.js";
 import type { ServerContext } from "./context.js";
 import type { RunMedusaAction } from "./run-medusa-action.js";
 export interface UpdateCustomerAddressInput {
@@ -31,6 +31,22 @@ export declare function createCustomer(context: ServerContext, runMedusaAction:
         state: "success";
         sessionToken: string;
     }>>;
+    /**
+     * Registration with name, phone and an optional address (the default
+     * address). The account counts as registered even if only the address
+     * fails (`addressSaved: false`, to add it in the account later) - a retry
+     * would otherwise end in "e-mail exists". While the e-mail is unconfirmed
+     * the address waits in the customer's metadata until the first login.
+     */
+    registerCustomerWithProfile(data: CustomerRegistrationProfileValues): Promise<import("../core/action-result.js").MedusaActionResult<{
+        state: "verification_required";
+        addressSaved?: undefined;
+        sessionToken?: undefined;
+    } | {
+        addressSaved: boolean;
+        state: "success";
+        sessionToken: string;
+    }>>;
     requestLoginCode(data: RequestLoginCodeRequest): Promise<import("../core/action-result.js").MedusaActionResult<void>>;
     loginWithCode(data: LoginWithCodeRequest): Promise<import("../core/action-result.js").MedusaActionResult<{
         state: "success";

package/dist/server/customer.js

@@ -6,7 +6,7 @@ import { completeCustomerSignIn as completeCustomerSignInWith, loginWithEmailpas
 import { toCustomerAddressesFromCheckout } from "../core/checkout/checkout-address-draft.js";
 import { StorefrontError } from "../core/errors.js";
 import { CART_OWNER_FIELDS, CUSTOMER_FIELDS } from "../core/fields.js";
-import { createCheckoutAddressSchema, createVerificationResendSchema, customerAddressSchema, customerAuthSchema, customerProfileSchema } from "../core/form-values.js";
+import { createCheckoutAddressSchema, createVerificationResendSchema, customerAddressSchema, customerAuthSchema, customerProfileSchema, customerRegistrationProfileSchema, registrationAddressSchema } from "../core/form-values.js";
 function cartCustomerHasAccount(cart) {
     const customer = Reflect.get(cart, "customer");
     return typeof customer === "object" && customer !== null && Reflect.get(customer, "has_account") === true;
@@ -14,6 +14,12 @@ function cartCustomerHasAccount(cart) {
 function isVerificationRequired(result) {
     return typeof result === "object" && result !== null && Reflect.get(result, "verification_required") === true && typeof Reflect.get(result, "token") === "string";
 }
+/**
+ * Metadata key of the address a registration could not store yet: Medusa takes
+ * no address with the customer, and while the e-mail is unconfirmed there is
+ * no token to add one, so it waits here until the first login.
+ */
+const PENDING_REGISTRATION_ADDRESS_KEY = "pending_registration_address";
 function getAuthenticationToken(result) {
     return typeof result === "string" ? result : null;
 }
@@ -71,12 +77,55 @@ export function createCustomer(context, runMedusaAction) {
             return undefined;
         }
     }
-    function completeCustomerSignIn(token, email) {
-        return completeCustomerSignInWith(token, email, {
+    /**
+     * Stores the registration address as the customer's default address. True
+     * when stored (or nothing to store); never throws - a failing address must
+     * not turn a registration or login into a failure.
+     */
+    async function storeRegistrationAddress(token, profile, address) {
+        const parsed = registrationAddressSchema.safeParse(address);
+        if (!parsed.success) {
+            return true;
+        }
+        try {
+            const sdk = createAuthenticatedMedusaClient(token);
+            await sdk.store.customer.createAddress({
+                ...parsed.data,
+                first_name: profile.first_name ?? undefined,
+                is_default_billing: true,
+                is_default_shipping: true,
+                last_name: profile.last_name ?? undefined,
+                phone: profile.phone || undefined,
+            });
+            await sdk.store.customer.update({ metadata: { [PENDING_REGISTRATION_ADDRESS_KEY]: null } });
+            return true;
+        }
+        catch (error) {
+            context.reportError(error, { area: "customer-auth", context: { step: "registration_address" } });
+            return false;
+        }
+    }
+    /** After a login: adds a registration address that waited for the e-mail confirmation. */
+    async function applyPendingRegistrationAddress(token) {
+        try {
+            const { customer } = await createAuthenticatedMedusaClient(token).store.customer.retrieve({ fields: "first_name,last_name,phone,metadata,*addresses" });
+            const pending = customer.metadata?.[PENDING_REGISTRATION_ADDRESS_KEY];
+            if (pending && (customer.addresses?.length ?? 0) === 0) {
+                await storeRegistrationAddress(token, customer, pending);
+            }
+        }
+        catch (error) {
+            context.reportError(error, { area: "customer-auth", context: { step: "pending_registration_address" } });
+        }
+    }
+    async function completeCustomerSignIn(token, email) {
+        const result = await completeCustomerSignInWith(token, email, {
             createAuthenticatedClient: createAuthenticatedMedusaClient,
             storeToken: session.setMedusaAuthToken,
             transferCart: transferActiveCartToCustomer,
         });
+        await applyPendingRegistrationAddress(result.sessionToken);
+        return result;
     }
     async function signInCustomer(data, { requestVerificationMail }) {
         const parsed = customerAuthSchema.parse(data);
@@ -144,6 +193,43 @@ export function createCustomer(context, runMedusaAction) {
                 return { state: "success", sessionToken: token };
             }, { endSessionOnUnauthorized: false });
         },
+        /**
+         * Registration with name, phone and an optional address (the default
+         * address). The account counts as registered even if only the address
+         * fails (`addressSaved: false`, to add it in the account later) - a retry
+         * would otherwise end in "e-mail exists". While the e-mail is unconfirmed
+         * the address waits in the customer's metadata until the first login.
+         */
+        async registerCustomerWithProfile(data) {
+            const parsed = customerRegistrationProfileSchema.parse(data);
+            const credentials = { email: parsed.email, password: parsed.password };
+            return runMedusaAction(async () => {
+                const registrationSdk = createMedusaClient();
+                const registrationToken = await registrationSdk.auth.register("customer", "emailpass", credentials);
+                const customerSdk = createAuthenticatedMedusaClient(registrationToken);
+                const { customer } = await customerSdk.store.customer.create({
+                    email: parsed.email,
+                    first_name: parsed.first_name,
+                    last_name: parsed.last_name,
+                    ...(parsed.phone ? { phone: parsed.phone } : {}),
+                    ...(parsed.address ? { metadata: { [PENDING_REGISTRATION_ADDRESS_KEY]: parsed.address } } : {}),
+                });
+                const loginSdk = createMedusaClient();
+                const result = await loginSdk.auth.login("customer", "emailpass", credentials);
+                if (isVerificationRequired(result)) {
+                    await requestCustomerVerification(parsed.email, result.token);
+                    return { state: "verification_required" };
+                }
+                const token = getAuthenticationToken(result);
+                if (!token) {
+                    throw new StorefrontError("auth.registration_unsupported_step");
+                }
+                await transferActiveCartToCustomer(createAuthenticatedMedusaClient(token), { id: customer.id, email: parsed.email });
+                await session.setMedusaAuthToken(token);
+                const addressSaved = parsed.address ? await storeRegistrationAddress(token, parsed, parsed.address) : true;
+                return { addressSaved, state: "success", sessionToken: token };
+            }, { endSessionOnUnauthorized: false });
+        },
         // The backend answers 202 for every address (no account enumeration) and
         // sends at most one code per address and minute.
         async requestLoginCode(data) {

package/dist/server/index.d.ts

@@ -61,6 +61,15 @@ export declare function createStorefrontServer(config: StorefrontServerConfig):
             state: "success";
             sessionToken: string;
         }>>;
+        registerCustomerWithProfile(data: import("../core/form-values.js").CustomerRegistrationProfileValues): Promise<import("../core/action-result.js").MedusaActionResult<{
+            state: "verification_required";
+            addressSaved?: undefined;
+            sessionToken?: undefined;
+        } | {
+            addressSaved: boolean;
+            state: "success";
+            sessionToken: string;
+        }>>;
         requestLoginCode(data: import("@hartl-services/medusa-contracts/types/customer-auth-store").RequestLoginCodeRequest): Promise<import("../core/action-result.js").MedusaActionResult<void>>;
         loginWithCode(data: import("@hartl-services/medusa-contracts/types/customer-auth-store").LoginWithCodeRequest): Promise<import("../core/action-result.js").MedusaActionResult<{
             state: "success";
@@ -236,11 +245,12 @@ export declare function createStorefrontServer(config: StorefrontServerConfig):
         }): Promise<Response>;
     };
     catalog: {
-        listCommerceProducts({ categoryId, collectionId, countryCode, handles }: import("./catalog.js").CommerceProductListInput): Promise<import("@medusajs/types").StoreProduct[] | null>;
+        listCommerceProducts({ categoryId, collectionId, countryCode, handles, q }: import("./catalog.js").CommerceProductListInput): Promise<import("@medusajs/types").StoreProduct[] | null>;
         commerceProductByHandle({ countryCode, handle }: {
             countryCode: string;
             handle: string;
         }): Promise<import("@medusajs/types").StoreProduct | null>;
+        listCategoryTrees(): Promise<import("@medusajs/types").StoreProductCategory[]>;
         categoryByPath(categoryPath: string[]): Promise<import("@medusajs/types").StoreProductCategory | null>;
         collectionByHandle(handle: string): Promise<import("@medusajs/types").StoreCollection | null>;
     };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hartl-services/medusa-storefront",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Headless Medusa storefront logic, Next.js server/browser adapters and React hooks for shops built from the @hartl-services/medusa-* plugins.",
   "type": "module",
   "sideEffects": false,