@shoppexio/storefront-react 0.6.2 → 0.6.3

package/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Changelog
 
+## 0.6.3
+
+- Product: whether a subscription's buyer can switch plans is the selected option's answer. `StorefrontPriceVariant.planChangeOffered` reads each option's `plan_change_offered` (false when the backend does not send it), and `subscriptionForVariant` puts it on the subscription, so `formatSubscriptionRenewal` promises "Switch plans any time in your account." only for an option that has another plan to switch to (under "Upgrades only" the top plan has none). With no option selected the product's answer stands.
+
 ## 0.6.2
 
 - Product: `formatSubscriptionRenewal(subscription)` gives the line under a subscription's buy buttons, "Renews every month until you cancel.", plus "Switch plans any time in your account." only when the catalog's `plan_change_offered` says the buyer can switch (the shop allows buyer plan changes and a second plan is offered); `ProductSubscription.planChangeOffered` carries it, false when the backend does not send the field. Empty for a plan without an interval.

package/dist/index.d.ts

@@ -1583,6 +1583,12 @@ interface StorefrontPriceVariant {
      * with the product's (`subscriptionForVariant`).
      */
     ownTrial: SubscriptionTrial | 'none' | null;
+    /**
+     * A buyer of this option can switch its plan in their account (the option's
+     * `plan_change_offered`): under "Upgrades only" the top plan has nothing to
+     * switch to. False when the wire does not say so.
+     */
+    planChangeOffered: boolean;
 }
 interface VolumeDiscountRule {
     quantity: number;
@@ -1822,9 +1828,11 @@ declare function formatSubscriptionTrial(subscription: ProductSubscription, form
  * interval (`billing_interval`, stored with its count or not at all) is charged
  * at that cadence, every other one at the product's. An option with its own
  * trial ("No trial" included) starts with it, every other one with the
- * product's: the rule checkout's `resolveProductTrial` applies.
+ * product's: the rule checkout's `resolveProductTrial` applies. Whether the
+ * buyer can switch plans is the option's own answer (`plan_change_offered`),
+ * the rule the Easy-lane buy box applies.
  */
-declare function subscriptionForVariant(subscription: ProductSubscription, variant: Pick<StorefrontPriceVariant, 'billingInterval' | 'ownTrial'> | null | undefined): ProductSubscription;
+declare function subscriptionForVariant(subscription: ProductSubscription, variant: Pick<StorefrontPriceVariant, 'billingInterval' | 'ownTrial' | 'planChangeOffered'> | null | undefined): ProductSubscription;
 /**
  * What a product image shows, from the backend's pixel analysis. `art` is a
  * cover, artwork or photo; `logo` is a flat mark, drawn on a contrasting plate.

package/dist/index.js

@@ -590,13 +590,14 @@ function formatSubscriptionTrial(subscription, formatAmount) {
   return `${formatAmount(trial.price, trial.currency)} for ${trial.days} ${trial.days === 1 ? "day" : "days"}`;
 }
 function subscriptionForVariant(subscription, variant) {
-  const own = variant?.billingInterval;
-  const ownTrial = variant?.ownTrial;
-  if (!own && !ownTrial) return subscription;
+  if (!variant) return subscription;
+  const own = variant.billingInterval;
+  const ownTrial = variant.ownTrial;
   return {
     ...subscription,
     ...own ? { intervalUnit: own.unit, intervalCount: own.count } : {},
-    ...ownTrial ? { trial: ownTrial === "none" ? null : ownTrial } : {}
+    ...ownTrial ? { trial: ownTrial === "none" ? null : ownTrial } : {},
+    planChangeOffered: variant.planChangeOffered
   };
 }
 function parseSubscription(product, productType) {
@@ -1058,6 +1059,7 @@ function parsePriceVariants(value, productContext) {
       license: parseVariantLicense(variant),
       billingInterval: parseVariantBillingInterval(variant),
       ownTrial: parseVariantTrial(variant),
+      planChangeOffered: variant.plan_change_offered === true,
       price: unitPrice,
       baseUnitPrice: unitPrice,
       stock: normalizeStock(variant.stock, `${context}.stock`),