@hartl-services/medusa-storefront 0.1.0 → 0.3.0

package/dist/react/use-auth.js

@@ -73,6 +73,10 @@ 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);
+    // A partner registration succeeded but its application could not be submitted.
+    const [isApplicationNotSubmitted, setIsApplicationNotSubmitted] = useState(false);
     // The background check and the "continue" button must not sign in twice.
     const confirmationSignIn = useRef("idle");
     async function completeSignIn(sessionToken) {
@@ -130,6 +134,69 @@ 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;
+            }
+        },
+        /** The partner registration did not submit its application; the account exists. */
+        isApplicationNotSubmitted,
+        /**
+         * Partner registration with company address; the application follows
+         * (after an e-mail confirmation: at the first login). Needs the shop's
+         * optional `registerPartnerWithProfile` action. True once signed in.
+         */
+        async registerPartner(value) {
+            const action = actions.registerPartnerWithProfile;
+            setErrorMessage(null);
+            setIsAddressNotSaved(false);
+            setIsApplicationNotSubmitted(false);
+            if (!action) {
+                setErrorMessage(t("partner_registration.unavailable"));
+                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);
+                setIsApplicationNotSubmitted(!result.applicationSubmitted);
+                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;
             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;
             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;
                 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;
                 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;
                     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;
                     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;
             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;
             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;
             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;
             province: string;
         };
         vat_number: string;

package/dist/registry/account.json

@@ -4,8 +4,8 @@
   "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-contracts@^1.1.0",
+    "@hartl-services/medusa-storefront@^0.3.0",
+    "@hartl-services/medusa-contracts@^1.2.0",
     "@medusajs/types@^2.19.0",
     "lucide-react"
   ],

package/dist/registry/affiliate.json

@@ -4,8 +4,8 @@
   "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-contracts@^1.1.0",
+    "@hartl-services/medusa-storefront@^0.3.0",
+    "@hartl-services/medusa-contracts@^1.2.0",
     "@medusajs/types@^2.19.0",
     "lucide-react",
     "react-day-picker"

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.3.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.3.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.3.0",
     "@tanstack/react-form@^1.33.5",
     "input-otp",
     "lucide-react"

package/dist/registry/registry.json

@@ -7,8 +7,8 @@
       "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-contracts@^1.1.0",
+        "@hartl-services/medusa-storefront@^0.3.0",
+        "@hartl-services/medusa-contracts@^1.2.0",
         "@medusajs/framework@^2.19.0",
         "@medusajs/js-sdk@^2.19.0",
         "@medusajs/types@^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.3.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.3.0",
         "@medusajs/types@^2.19.0",
         "lucide-react"
       ],
@@ -306,8 +306,8 @@
       "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-contracts@^1.1.0",
+        "@hartl-services/medusa-storefront@^0.3.0",
+        "@hartl-services/medusa-contracts@^1.2.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.3.0",
         "@medusajs/types@^2.19.0",
         "@stripe/react-stripe-js@^5.6.1",
         "@stripe/stripe-js@^8.11.0",
@@ -661,8 +661,8 @@
       "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-contracts@^1.1.0",
+        "@hartl-services/medusa-storefront@^0.3.0",
+        "@hartl-services/medusa-contracts@^1.2.0",
         "@medusajs/types@^2.19.0",
         "lucide-react",
         "react-day-picker"

package/dist/registry/setup.json

@@ -4,8 +4,8 @@
   "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-contracts@^1.1.0",
+    "@hartl-services/medusa-storefront@^0.3.0",
+    "@hartl-services/medusa-contracts@^1.2.0",
     "@medusajs/framework@^2.19.0",
     "@medusajs/js-sdk@^2.19.0",
     "@medusajs/types@^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 registerPartnerWithProfile(...args: Parameters<typeof storefront.customer.registerPartnerWithProfile>) {\n  return await storefront.customer.registerPartnerWithProfile(...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/affiliate.d.ts

@@ -1,4 +1,4 @@
-import type { ApplyOwnOrderPromotionResponse, CreatePartnerPortalSlugRequest, CreateStoreAffiliateCouponCodeRequest, RotateStoreAffiliateCouponCodeRequest, SubmitAffiliateApplicationRequest, SubmitConsignmentReportRequest, UpdatePartnerPortalSlugRequest } from "@hartl-services/medusa-contracts/types/affiliate-store";
+import type { ApplyOwnOrderPromotionResponse, CreatePartnerPortalSlugRequest, CreateStoreAffiliateCouponCodeRequest, RotateStoreAffiliateCouponCodeRequest, StoreAffiliatePortalContextResponse, SubmitAffiliateApplicationRequest, SubmitConsignmentReportRequest, UpdatePartnerPortalSlugRequest } from "@hartl-services/medusa-contracts/types/affiliate-store";
 import type { MedusaActionResult } from "../core/action-result.js";
 import type { ServerContext } from "./context.js";
 import type { ServerPluginFeatures } from "./plugin-features.js";
@@ -12,6 +12,9 @@ export interface AffiliateCouponRotationInput {
     command: RotateStoreAffiliateCouponCodeRequest;
 }
 export declare function createAffiliate(context: ServerContext, pluginFeatures: ServerPluginFeatures, runMedusaAction: RunMedusaAction): {
+    loadPartnerPortalState: () => Promise<StoreAffiliatePortalContextResponse["portal_state"] | null>;
+    /** Whether the logged-in customer is an approved, active partner (fail-closed). */
+    isActivePartner(): Promise<boolean>;
     submitAffiliateApplication(data: SubmitAffiliateApplicationRequest): Promise<MedusaActionResult<{
         application: {
             id: string;

package/dist/server/affiliate.js

@@ -1,3 +1,4 @@
+import { cache } from "react";
 import { affiliateStorePaths } from "@hartl-services/medusa-contracts/paths/affiliate";
 import { isPluginFeatureEnabled } from "../core/plugin-features.js";
 import { createMedusaErrorResponse } from "./route-response.js";
@@ -19,7 +20,35 @@ export function createAffiliate(context, pluginFeatures, runMedusaAction) {
             return medusaErrorResponse(error);
         }
     }
+    /**
+     * The logged-in customer's partner state for server rendering (e.g. a
+     * therapist view): null when logged out, while the partner portal is off,
+     * or when the backend cannot answer - every partner view then stays hidden.
+     * Deduplicated per request via React cache().
+     */
+    const loadPartnerPortalState = cache(async () => {
+        if (!(await context.session.getMedusaAuthToken())) {
+            return null;
+        }
+        if (!isPluginFeatureEnabled(await pluginFeatures.loadPluginFeatures(), "affiliate", "partner_portal")) {
+            return null;
+        }
+        try {
+            const sdk = await customerClient();
+            const response = await sdk.client.fetch(affiliateStorePaths.get.me, { method: "GET" });
+            return response.portal_state;
+        }
+        catch (error) {
+            context.reportError(error, { area: "affiliate", context: { step: "portal_state" } });
+            return null;
+        }
+    });
     return {
+        loadPartnerPortalState,
+        /** Whether the logged-in customer is an approved, active partner (fail-closed). */
+        async isActivePartner() {
+            return (await loadPartnerPortalState()) === "active";
+        },
         async submitAffiliateApplication(data) {
             return runMedusaAction(async () => {
                 const sdk = await customerClient();

package/dist/server/catalog.d.ts

@@ -6,14 +6,28 @@ 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>;
+/**
+ * Medusa's half of a catalog: products priced for a country, categories and
+ * collections. Partner-only products and categories (see
+ * `isPartnerOnlyProduct`) are left out unless `isActivePartner` says the
+ * visitor is an active partner; the backend refuses them at checkout anyway.
+ */
+export declare function createCatalog(context: ServerContext, region: ServerRegion, isActivePartner?: () => Promise<boolean>): {
+    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. Partner-only
+     * categories only for an active partner.
+     */
+    listCategoryTrees(): Promise<HttpTypes.StoreProductCategory[]>;
     categoryByPath(categoryPath: string[]): Promise<HttpTypes.StoreProductCategory | null>;
     collectionByHandle(handle: string): Promise<HttpTypes.StoreCollection | null>;
 };