local-storefront 0.3.0-rc.3 → 0.3.0-rc.5

package/CHANGELOG.md

@@ -3,6 +3,49 @@
 What changed in each version of `lsf`, for someone who uses it. The section of a version is
 what its [GitHub release](https://github.com/0xtlt/local-storefront/releases) says.
 
+## 0.3.0-rc.5 - 2026-11-13
+
+Fifth release candidate of 0.3.0. The errors of `/cart/change.js` read as a store's.
+
+### Breaking changes
+
+What to change when you upgrade from 0.3.0-rc.4.
+
+- **The `message` of a `/cart/change.js` error is its `description`**, no longer `Cart Error`.
+  Theme tests that expect `Cart Error` from `change.js` need the description instead. `add.js`
+  and `update.js` keep `Cart Error`.
+
+### Fixed
+
+#### Themes and the storefront
+
+- **`/cart/change.js` capped at the stock counts what the line holds.** A line of 1 asked for 5
+  with 2 in stock answers "Only 2 items were added to your cart due to availability.", as a
+  store does, no longer "Only 1 item". `add.js` still counts the units it added.
+
+## 0.3.0-rc.4 - 2026-11-12
+
+Fourth release candidate of 0.3.0. It fixes the code discounts of 0.3.0-rc.3: their uses, their
+minimums and their one use per customer now follow what Shopify does.
+
+### Fixed
+
+#### The checkout of an app
+
+- **A code discount's `usageLimit` and `appliesOncePerCustomer` hold when checkouts complete at
+  once.** The code is checked again when the order is recorded; when the buyer can no longer use
+  it, the completion answers `422` with the checkout without it and "`<code>` discount code isn't
+  available to you right now".
+- **A free shipping code that takes nothing off is not on the order.** Over its
+  `maximumShippingPrice` for the selected rate, on a cart with nothing to ship, or beaten by a
+  Function's shipping discount, it is no longer in `discount_codes` of the order and its
+  webhooks, and it is not counted as a use.
+- **Minimums count the discounts before them**, as Shopify's help center describes: a free
+  shipping minimum the cart after the product and order discounts, an amount off minimum the
+  items it applies to after the product discounts.
+- **Renaming or deleting a redeemed code no longer resets `appliesOncePerCustomer`.** Uses are
+  matched by discount, not by its codes of the moment.
+
 ## 0.3.0-rc.3 - 2026-11-12
 
 Third release candidate of 0.3.0. The local checkout applies the code discounts a backend makes

package/docs/admin.md

@@ -1631,13 +1631,21 @@ What the backend changes through the Admin API is what the storefront and the
   checkout takes the code while the discount is `ACTIVE` by its dates, its `usageLimit` is not
   reached, the buyer is one of its `context` (all buyers, the customers it lists, the members of
   the segments it lists: a guest is the customer whose email they gave), has not used it when it
-  `appliesOncePerCustomer`, and the cart meets its `minimumRequirement` (the subtotal or the
-  quantity of the items it applies to, before discounts); free shipping makes free the rates up
-  to its `maximumShippingPrice`, to the countries of its `destination`. Otherwise the page says
-  "Enter a valid discount code", and the state's `discountCodes` says why (`reason`). The order
-  carries the code (`discountCodes`, a `DiscountCodeApplication`, the allocations), so do the
-  `discount_codes` and `discount_applications` of `orders/create` and `orders/paid`, and the
-  discount's `asyncUsageCount` (and its code's) goes up by one at once. One code of these types
+  `appliesOncePerCustomer`, and the cart meets its `minimumRequirement` (the quantity of the
+  items it applies to; a subtotal at the prices the discounts before it left, as on Shopify:
+  the items it applies to after the product discounts for an amount off, the cart after the
+  product and order discounts for free shipping); free shipping makes free the rates up to its
+  `maximumShippingPrice`, to the countries of its `destination`. Otherwise the page says "Enter
+  a valid discount code", and the state's `discountCodes` says why (`reason`). The order carries
+  the code it took something off with (`discountCodes`, a `DiscountCodeApplication`, the
+  allocations), so do the `discount_codes` and `discount_applications` of `orders/create` and
+  `orders/paid` (`type` `shipping` for free shipping), and the discount's `asyncUsageCount` (and
+  its code's) goes up by one at once. A free shipping code that took nothing off (a rate over
+  its maximum, nothing to ship) is neither on the order nor used. The usage limit and the one
+  use per customer are checked again as the order is recorded, so that two checkouts priced at
+  once do not both take the last use: the second completion is refused. A use is the
+  discount's: renaming its code or deleting it (`discountCodeRedeemCodeBulkDelete`) does not
+  give a buyer who used it another one. One code of these types
   applies per checkout (lsf does not read `combinesWith`), and it stacks with the discounts of
   the Functions; of the shipping discounts, the best one applies. Not read: a `context` of
   markets (every buyer), `appliesOnOneTimePurchase` and `appliesOnSubscription`. Buy X get Y

package/docs/checkout.md

@@ -1124,15 +1124,30 @@ amount off the order is an order discount, one off listed products, variants or
 off each item) a product discount, free shipping a shipping discount, and each takes its place
 among the discounts of the Functions by the rules above. The code is checked when the
 checkout is computed: the discount's dates and usage limit, its buyers, one use per customer,
-its minimum (on the items it applies to, before discounts), and for free shipping the country
-of the address (a code is taken before there is one). A refused code shows "Enter a valid
-discount code", and its entry of `discountCodes` in the state has a `reason`
-(`"its minimum purchase is 50.00 USD, and the items it applies to come to 32.00 USD"`). One code
-of these types applies per checkout, the first one entered that qualifies: a second is refused,
-as on Shopify when a discount combines with no other (lsf does not read `combinesWith`). Its
+its minimum, and for free shipping the country of the address (a code is taken before there is
+one). A minimum subtotal counts the prices the discounts before it left, as Shopify's do
+([amount off](https://help.shopify.com/en/manual/discounts/discount-types/percentage-fixed-amount),
+[free shipping](https://help.shopify.com/en/manual/discounts/discount-types/free-shipping),
+"Understanding minimum purchase requirements"): for an amount off, the items it applies to
+after the product discounts of the Functions; for free shipping, the whole cart after the
+product and order discounts. A refused code shows "Enter a valid discount code", and its entry
+of `discountCodes` in the state has a `reason` (`"its minimum purchase is 50.00 USD, and the
+items it applies to come to 32.00 USD after the product discounts"`). One code of these types
+applies per checkout, the first one entered that qualifies: a second is refused, as on Shopify
+when a discount combines with no other (lsf does not read `combinesWith`). Its
 `DiscountApplication` is `ACROSS` (`EACH` off each item), `ALL` for the order and `ENTITLED`
 for listed items; free shipping is 100% off the shipping line, `EACH`.
 
+A free shipping code that takes nothing off (the selected rate costs more than its
+`maximumShippingPrice`, nothing in the cart ships, or a shipping discount of a Function beat it)
+stays applicable on the page, as entered, but it is not the order's: the order does not carry it
+and it is not counted as a use. The codes are checked again as the order is recorded: when
+another order took the last use of the discount (`usageLimit`) or the buyer's one
+(`appliesOncePerCustomer`) after the checkout was priced, the order is not placed. The
+completion answers 422 with the checkout as it now is (the code refused, with its `reason`, the
+price without it) and the error "`<code>` discount code isn't available to you right now" on
+`$.cart.discountCodes`; the buyer pays again for what they now see.
+
 An amount is shared between the lines in proportion to what they cost, to the cent, and the
 allocations of the lines (`discountAllocations`, in the page and for the Functions that run
 later) add up to the discount.
@@ -1645,8 +1660,9 @@ store before a release:
 - **Discount combinations and conditions**: lsf combines every product and order discount
   ([how discounts stack](#how-discounts-stack)).
 - **Codes of Shopify's own discount types**: one applies per checkout whatever its
-  `combinesWith`, its minimum is checked on the items it applies to before any discount, and a
-  refused code says lsf's reason, where Shopify's checkout has messages of its own.
+  `combinesWith`, a minimum subtotal counts the prices after every discount before it (Shopify
+  counts only those that combine with it), and a refused code says lsf's reason, where
+  Shopify's checkout has messages of its own.
 - **Currencies and price lists**: a buyer pays in the currency of the country of the shipping
   address (else of the one selected on the storefront), at its market's `rate` or fixed `prices`
   ([localization](data-format.md#localization)); the Functions read that rate as

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "local-storefront",
-  "version": "0.3.0-rc.3",
+  "version": "0.3.0-rc.5",
   "description": "Run Shopify themes and apps locally, without Shopify: the storefront, a local checkout for Functions and checkout UI extensions, and a local GraphQL Admin API with webhooks, from JSON store data. Made for tests in CI.",
   "keywords": [
     "shopify",
@@ -38,11 +38,11 @@
     "node": ">=18"
   },
   "optionalDependencies": {
-    "local-storefront-darwin-arm64": "0.3.0-rc.3",
-    "local-storefront-darwin-x64": "0.3.0-rc.3",
-    "local-storefront-linux-arm64": "0.3.0-rc.3",
-    "local-storefront-linux-x64": "0.3.0-rc.3",
-    "local-storefront-win32-arm64": "0.3.0-rc.3",
-    "local-storefront-win32-x64": "0.3.0-rc.3"
+    "local-storefront-darwin-arm64": "0.3.0-rc.5",
+    "local-storefront-darwin-x64": "0.3.0-rc.5",
+    "local-storefront-linux-arm64": "0.3.0-rc.5",
+    "local-storefront-linux-x64": "0.3.0-rc.5",
+    "local-storefront-win32-arm64": "0.3.0-rc.5",
+    "local-storefront-win32-x64": "0.3.0-rc.5"
   }
 }