@moonbase.sh/storefront 2.0.1 → 2.2.0

package/README.md

@@ -29,7 +29,31 @@ Moonbase.on(MoonbaseEvent.CheckoutCompleted, ({ order }) => {
 })
 ```
 
-`setup` should be run once, client-side, after the DOM is available.
+`setup` should be run once, client-side.
+
+When you load the widget via the CDN script tag:
+
+```html
+<script src="https://assets.moonbase.sh/storefront/moonbase.js"></script>
+<script>
+  Moonbase.setup('https://demo.moonbase.sh')
+  Moonbase.on('checkout-completed', ({ order }) => console.log(order.id))
+</script>
+```
+
+…you can call `Moonbase.setup(...)`, `Moonbase.on(...)`, and any intent method from anywhere on the page — including inline `<script>` in `<head>` — without waiting for `DOMContentLoaded`. The CDN script is a tiny loader that queues calls and replays them once the real bundle and the DOM are both ready.
+
+When you import from npm (`import Moonbase from '@moonbase.sh/storefront'`), `setup` still needs the DOM to be available before it runs, since there is no loader in that path.
+
+## Testing pre-release builds with `?mb_version=`
+
+The CDN loader recognises an `?mb_version=` query parameter for opting into a non-default storefront build on a per-page-load basis. This is intended for testing pre-release changes on a live merchant site without changing the embed code.
+
+- `?mb_version=next` — loads the latest `@next` snapshot from `/storefront/next/moonbase.js`
+- `?mb_version=2.1.0` — pins to a specific published version from `/storefront/<version>/moonbase.js`
+- `?mb_version=latest` or omitted — loads the current stable release (default)
+
+Don't use this to pin a production embed to a specific version — pin the `<script src>` URL instead.
 
 ## Trigger intents
 

package/dist/moonbase.d.ts

@@ -32,6 +32,7 @@ export declare enum MoonbaseEvent {
     DownloadedProduct = "downloaded-product",
     ActivatedProduct = "activated-product",
     AddedToCart = "added-to-cart",
+    CouponRejected = "coupon-rejected",
     CheckoutInitiated = "checkout-initiated",
     CheckoutClosed = "checkout-closed",
     CheckoutCompleted = "checkout-completed"
@@ -70,6 +71,10 @@ export declare interface MoonbaseEventArgs {
         currency: string;
         user?: User | null;
     };
+    [MoonbaseEvent.CouponRejected]: {
+        code: string;
+        user?: User | null;
+    };
     [MoonbaseEvent.CheckoutInitiated]: {
         order: OpenOrder;
         total: Money;
@@ -236,11 +241,13 @@ export declare interface MoonbaseIntentArgs {
         bundle_id?: string;
         variation_id?: string;
         quantity?: number;
+        coupon_code?: string;
     } | {
         product_id?: string;
         bundle_id?: string;
         variation_id?: string;
         quantity?: number;
+        coupon_code?: string;
     }[];
     [MoonbaseIntent.Checkout]: {
         complete?: boolean;