@moonbase.sh/storefront 3.7.0 → 3.8.1

package/README.md

@@ -297,6 +297,28 @@ offer claimed from a card does. A buyer can already put a multi-target offer on
 product and never add the other, so nothing here is a cart they couldn't have built
 by hand.
 
+`cart.minimumTotal` sets the smallest order the cart will check out. Below it, the
+checkout button gives way to a meter of the same size that fills as the cart grows
+and tells the buyer how much more to spend; it turns back into the button once the
+cart reaches the minimum.
+
+```ts
+Moonbase.configure({
+  cart: {
+    minimumTotal: { USD: 25, EUR: 25, GBP: 20 },
+  },
+})
+```
+
+Amounts are keyed by currency code, in major units, because Moonbase picks each
+visitor's currency and the widget never converts one into another. A currency you
+leave out has no minimum. The minimum is measured on the cart's Total, after product
+discounts and offers but before coupons and tax, and a cart holding nothing but free
+items is exempt. The `checkout` intent respects it too: below the minimum it opens
+the cart instead of checking out. The widget enforces this, not the API, so
+`purchase()` and checkouts you build outside the widget are not held to it. A value
+you pass replaces the previous one; pass `{}` to remove it. No minimum by default.
+
 You can also control where the widget mounts by providing `target`.
 
 ## Promotions

package/dist/moonbase.d.ts

@@ -227,6 +227,7 @@ declare class MoonbaseImpl implements MoonbaseInstance {
     add_to_cart(parameters?: MoonbaseIntentArgs['add_to_cart']): Promise<void>;
     purchase(parameters?: MoonbaseIntentArgs['purchase']): Promise<void>;
     checkout(parameters?: MoonbaseIntentArgs['checkout']): void;
+    private checkoutCart;
     close_checkout(): void;
     view_about(): void;
 }
@@ -497,6 +498,22 @@ export declare interface MoonbaseOptions {
         leadMagnets: {
             quantity: 'selectable' | 'single';
         };
+        /**
+         * The smallest order the cart will check out, keyed by currency code in major units, e.g.
+         * `{ USD: 25, EUR: 25 }`. Below it the checkout button gives way to a meter showing how much
+         * further the buyer has to go, and the `checkout` intent opens the cart instead of checking out.
+         *
+         * Per currency because the API picks each visitor's currency and the widget never converts one
+         * into another. A currency with no entry has no minimum, so a buyer priced in one you did not
+         * list checks out as before.
+         *
+         * Measured on the cart's own Total: after product discounts and offers, before coupons and tax.
+         * A cart of nothing but free items is exempt, since there is no purchase to hold back.
+         *
+         * The widget enforces this, not the API: `purchase()` and checkouts built outside the widget are
+         * not held to it. A value you pass replaces the previous one outright; pass `{}` to remove it.
+         */
+        minimumTotal: Record<string, number>;
     };
     activation: {
         deviceTokenFileExtension: string;