@shoppexio/storefront-react 0.2.0 → 0.3.0

package/CHANGELOG.md

@@ -1,5 +1,111 @@
 # Changelog
 
+## 0.3.0
+
+Added, in the customer account (`@shoppexio/storefront-react/account`). Each
+needs the storefront SDK build that carries the matching customer method;
+against an older SDK the control answers with the account's generic error.
+
+- Referrals: a buyer makes a referral link with a code of their own, when the
+  shop allows it (`can_create_custom_links`; a shop that does not shows its
+  own reason instead). A buyer the shop has not enrolled yet (auto-join off)
+  gets the control too, without the balance and history. A link that asks for
+  its own rates is reported as waiting for approval. Payouts, conversions and
+  sharebacks stay out.
+- Orders: "Download invoice (PDF)" on an order.
+- Settings: three order-mail switches (order confirmations, order receipts,
+  payment issues), next to the marketing lists.
+- `ShoppexSdk` declares `createAffiliateLink`, `invoicePdf`,
+  `notificationPreferences`
+  and `updateNotificationPreferences`; `SdkCustomerAffiliateSummary` carries
+  `can_create_custom_links` and `custom_link_request_disabled_reason`.
+
+A project that already ejected the account keeps its own copy. Take
+`referrals.tsx`, `orders.tsx`, `settings.tsx` and `account-referrals.ts` from `eject/account` again to get these.
+
+Added, in the cart:
+
+- `useCart().requote()`: asks the server to price the cart again, for a Retry
+  under a failed quote. It is the cart's own refresh, so it writes only the
+  quote and `quoteError`, never clears a failed write's `mutationError`, and
+  settles once the answer is in.
+
+Added, in the payload:
+
+- `ProductCustomField.options`: the labels of a `type: 'select'` field, in
+  the merchant's order. Draw a select as a dropdown of exactly these labels.
+- `StorefrontProduct.addonsRequired` and `addonChoiceMissing(product, chosen)`:
+  the buyer must pick one of the product's add-ons, the rule the server
+  refuses a line by (`errors.checkout.addon_required`). It asks nothing when
+  the product offers no add-on; a required (locked) add-on counts as the pick.
+  A template's buy box reads it to ask before the add; a card or tile that adds
+  without a choice sends the buyer to the product page.
+- `StorefrontProduct.upsellProductIds`: the merchant's upsell picks as product
+  uniqids (`StorefrontProduct.id`), in the merchant's order; empty when they
+  picked none. The Easy lane lists them on the product page instead of the
+  automatic related products.
+
+A template that builds `StorefrontProduct` objects itself adds
+`addonsRequired` and `upsellProductIds`.
+
+- `ProductAddon.description`: the merchant's line under an add-on's title,
+  `null` when they wrote none (the wire sends `''`). The Easy lane prints it
+  under the title; a template that builds `ProductAddon` objects itself adds
+  the field.
+- `StorefrontProduct.images`: the gallery with each image's `kind`
+  (`'art' | 'logo' | null`) and `inkColor` (`#rrggbb` or `null`), next to
+  `imageUrls`. Both are the backend's pixel analysis; null means "not analysed",
+  and an unknown value is read as null, never guessed. A template draws a logo
+  on a contrasting plate from them.
+- `StorefrontShop.description`: the shop's one-line description, or `null`
+  when the merchant set none. The Easy lane's footer shows it under the
+  brand; a code template shows it where its own footer copy is blank, so both
+  lanes say the same thing.
+- `StorefrontProduct.deliveryType` (`ProductDeliveryType`): what the buyer
+  receives, `'key' | 'download' | 'service' | 'shipped'`, as the backend reads
+  it off the product's delivery mechanism. `null` where the mechanism does not
+  say (an item the merchant's webhook makes, an information card) and for a
+  value this version does not know. The Loadout Easy-lane card shows it as its
+  type cell, in `unitLabelSingular` when the merchant set one.
+
+Changed:
+
+- `validateCheckoutFieldValue` refuses a select answer that is not one of its
+  `options` with "<name> must be one of the listed options." (the server
+  refuses it with `custom_field_option_invalid`).
+- A product's `customFields` leave out the fields the merchant collects after
+  payment (`collect_after_payment`): the buyer answers those on the invoice,
+  and the server drops a value the cart sends for them.
+- `useCart().add` refuses a product with `addonsRequired` when the line names
+  none of its add-ons ("Choose an add-on for <product> to continue."), and a
+  bundle add refuses such a member, instead of writing a line the quote
+  refuses.
+- Rewards: when a points conversion's result is unknown (the API answered
+  `RESPONSE_CONTRACT_VIOLATION`), the account shows "Loading your rewards"
+  and keeps the conversion form locked until a fresh read of the balance
+  answers, so a buyer cannot convert the same points twice.
+- Line prices match the invoice to the cent. `calculateDisplayLineTotal`,
+  `calculateLinePricing` and the cart view now use the backend's decimal line
+  math: a mill unit price is multiplied before rounding ($0.012 × 3 is $0.04,
+  not $0.03), an exact half cent rounds up, totals above ~$90 billion keep
+  their last cent, and add-on prices are added as decimals instead of a float
+  sum. `calculateDisplayLineTotal` takes the selected add-on prices as an
+  optional fifth argument. Volume-discount rules are read like the invoice
+  reads them (`"3units"` is no tier, `value: true` is 1).
+- `formatMoney` keeps the currency's decimals on a whole amount too: `$64.00`,
+  not `$64`, as the Easy lane prints every price. Card prices, the "from"
+  price, buy box totals and the cart all follow. A template test that pinned
+  `$49` reads `$49.00` after the bump.
+
+## 0.2.1
+
+- Favorites follow the account session without a reload. Signing in on the
+  account page reloads the favorites store, so the hearts on cards and the
+  product page work at once instead of sending the buyer back to Account.
+  Signing out reloads it too, which clears the previous buyer's saved set
+  instead of leaving it on the page for whoever uses the browser next.
+  (`announceCustomerSessionChange()`, `signOutEndedSession()`.)
+
 ## 0.2.0
 
 Breaking: