@shoppexio/storefront-react 0.2.1 → 0.4.0

package/CHANGELOG.md

@@ -1,5 +1,125 @@
 # Changelog
 
+## 0.4.0
+
+- Account: adding funds, changing a card and handing out reseller keys move to
+  the hosted buyer pages on the checkout host (`/topup`, `/billing`,
+  `/reseller`), behind their own email code. The account links there through
+  `hostedPageUrl`; the "Top up" link shows only when the wallet summary's new
+  `topups_allowed` is true. Removed: the reseller wholesale basket, its quote
+  and the quantity steppers, and `quoteResellerOrder` from the SDK type. An
+  ejected account takes `overview.tsx`, `reseller.tsx`, `rewards.tsx`,
+  `subscriptions.tsx`, `shared.tsx`, `hosted-page.ts` and the message catalogs
+  from `eject/account` again.
+- Referrals: "Your rates" replaces the single "{n}% commission" figure: the
+  rate on most products and the products that earn nothing, the cap and the
+  minimum per order, and how long a referred buyer stays. A link names its
+  commission only when it earns another rate. `SdkCustomerAffiliateSummary`
+  carries `rates` (`SdkCustomerAffiliateRates`, null until the main link is
+  approved and active); its `custom_rate_product_count` counts the products
+  that pay their own rate, so the row says "most products" while any does. An ejected account takes `referrals.tsx`,
+  `account-referrals.ts` and the message catalogs from `eject/account` again.
+- Reviews: `ShopReview.reply` carries the shop's reply under a review (null
+  when the shop has not replied), from the feed's `reply`; `SdkShopReview`
+  declares it.
+
+## 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

package/dist/account.css

@@ -256,10 +256,6 @@
   width: calc(var(--sxa-spacing) * 16);
 }
 
-.sxa\:w-24 {
-  width: calc(var(--sxa-spacing) * 24);
-}
-
 .sxa\:w-36 {
   width: calc(var(--sxa-spacing) * 36);
 }
@@ -667,6 +663,10 @@
   word-break: break-all;
 }
 
+.sxa\:whitespace-pre-line {
+  white-space: pre-line;
+}
+
 .sxa\:whitespace-pre-wrap {
   white-space: pre-wrap;
 }
@@ -738,10 +738,6 @@
     background-color: var(--sx-surface-raised);
   }
 
-  .sxa\:hover\:text-error:hover {
-    color: var(--sx-error);
-  }
-
   .sxa\:hover\:opacity-80:hover {
     opacity: .8;
   }