@shoppexio/storefront-react 0.6.2 → 0.6.4

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.6.4
+
+- Product: `formatSubscriptionRenewal(subscription, lang?)` reads in the page's locale (`<html lang>`, which the edge sets to the served locale; `lang` overrides it) with the Easy-lane buy boxes' words in all 16 locales, so a German page reads "Verlängert sich monatlich, bis du kündigst." instead of the English line. Unknown locales read English.
+
+## 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;
@@ -1809,9 +1815,10 @@ declare function formatSubscriptionCadence(subscription: ProductSubscription): s
 /**
  * The line under a subscription's buy buttons: "Renews every month until you cancel." and, when the
  * producer says the buyer can switch plans, "Switch plans any time in your account." Empty for a plan
- * without an interval. Same wording as the Easy-lane buy boxes.
+ * without an interval. In the page's locale (`lang` defaults to `<html lang>`), with the Easy-lane buy
+ * boxes' words in every one.
  */
-declare function formatSubscriptionRenewal(subscription: ProductSubscription): string;
+declare function formatSubscriptionRenewal(subscription: ProductSubscription, lang?: string | null): string;
 /**
  * "7-day free trial" for a free trial, "$4.99 for 7 days" for a paid intro
  * (`formatAmount` prints its price); empty when the plan has no trial.
@@ -1822,9 +1829,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

@@ -445,6 +445,210 @@ function buildStatusPageModel(products) {
   return { entries, counts, presentStates, lastUpdatedAt };
 }
 
+// src/subscription-renewal-messages.ts
+var SUBSCRIPTION_RENEWAL_MESSAGES = {
+  ar: {
+    renewsUntilCancel: "\u064A\u062A\u062C\u062F\u062F {interval} \u062D\u062A\u0649 \u062A\u0644\u063A\u064A\u0647.",
+    switchPlansInAccount: "\u064A\u0645\u0643\u0646\u0643 \u062A\u063A\u064A\u064A\u0631 \u0627\u0644\u062E\u0637\u0629 \u0641\u064A \u0623\u064A \u0648\u0642\u062A \u0645\u0646 \u062D\u0633\u0627\u0628\u0643.",
+    renewEveryDay: "\u0643\u0644 \u064A\u0648\u0645",
+    renewEveryDays: "\u0643\u0644 {count} \u064A\u0648\u0645",
+    renewEveryWeek: "\u0643\u0644 \u0623\u0633\u0628\u0648\u0639",
+    renewEveryWeeks: "\u0643\u0644 {count} \u0623\u0633\u0628\u0648\u0639",
+    renewEveryMonth: "\u0643\u0644 \u0634\u0647\u0631",
+    renewEveryMonths: "\u0643\u0644 {count} \u0634\u0647\u0631",
+    renewEveryYear: "\u0643\u0644 \u0633\u0646\u0629",
+    renewEveryYears: "\u0643\u0644 {count} \u0633\u0646\u0629"
+  },
+  de: {
+    renewsUntilCancel: "Verl\xE4ngert sich {interval}, bis du k\xFCndigst.",
+    switchPlansInAccount: "Du kannst den Plan jederzeit in deinem Konto wechseln.",
+    renewEveryDay: "t\xE4glich",
+    renewEveryDays: "alle {count} Tage",
+    renewEveryWeek: "w\xF6chentlich",
+    renewEveryWeeks: "alle {count} Wochen",
+    renewEveryMonth: "monatlich",
+    renewEveryMonths: "alle {count} Monate",
+    renewEveryYear: "j\xE4hrlich",
+    renewEveryYears: "alle {count} Jahre"
+  },
+  en: {
+    renewsUntilCancel: "Renews {interval} until you cancel.",
+    switchPlansInAccount: "Switch plans any time in your account.",
+    renewEveryDay: "every day",
+    renewEveryDays: "every {count} days",
+    renewEveryWeek: "every week",
+    renewEveryWeeks: "every {count} weeks",
+    renewEveryMonth: "every month",
+    renewEveryMonths: "every {count} months",
+    renewEveryYear: "every year",
+    renewEveryYears: "every {count} years"
+  },
+  es: {
+    renewsUntilCancel: "Se renueva {interval} hasta que lo canceles.",
+    switchPlansInAccount: "Cambia de plan cuando quieras desde tu cuenta.",
+    renewEveryDay: "cada d\xEDa",
+    renewEveryDays: "cada {count} d\xEDas",
+    renewEveryWeek: "cada semana",
+    renewEveryWeeks: "cada {count} semanas",
+    renewEveryMonth: "cada mes",
+    renewEveryMonths: "cada {count} meses",
+    renewEveryYear: "cada a\xF1o",
+    renewEveryYears: "cada {count} a\xF1os"
+  },
+  fi: {
+    renewsUntilCancel: "Uusiutuu {interval}, kunnes peruutat.",
+    switchPlansInAccount: "Vaihda tilausta milloin tahansa tilill\xE4si.",
+    renewEveryDay: "p\xE4ivitt\xE4in",
+    renewEveryDays: "{count} p\xE4iv\xE4n v\xE4lein",
+    renewEveryWeek: "viikoittain",
+    renewEveryWeeks: "{count} viikon v\xE4lein",
+    renewEveryMonth: "kuukausittain",
+    renewEveryMonths: "{count} kuukauden v\xE4lein",
+    renewEveryYear: "vuosittain",
+    renewEveryYears: "{count} vuoden v\xE4lein"
+  },
+  fr: {
+    renewsUntilCancel: "Se renouvelle {interval} jusqu'\xE0 ce que vous r\xE9siliiez.",
+    switchPlansInAccount: "Changez de formule \xE0 tout moment depuis votre compte.",
+    renewEveryDay: "chaque jour",
+    renewEveryDays: "tous les {count} jours",
+    renewEveryWeek: "chaque semaine",
+    renewEveryWeeks: "toutes les {count} semaines",
+    renewEveryMonth: "chaque mois",
+    renewEveryMonths: "tous les {count} mois",
+    renewEveryYear: "chaque ann\xE9e",
+    renewEveryYears: "tous les {count} ans"
+  },
+  hi: {
+    renewsUntilCancel: "\u0930\u0926\u094D\u0926 \u0915\u0930\u0928\u0947 \u0924\u0915 {interval} \u0928\u0935\u0940\u0928\u0940\u0915\u0943\u0924 \u0939\u094B\u0924\u093E \u0939\u0948\u0964",
+    switchPlansInAccount: "\u0905\u092A\u0928\u0947 \u0916\u093E\u0924\u0947 \u092E\u0947\u0902 \u0915\u092D\u0940 \u092D\u0940 \u092A\u094D\u0932\u093E\u0928 \u092C\u0926\u0932\u0947\u0902\u0964",
+    renewEveryDay: "\u0939\u0930 \u0926\u093F\u0928",
+    renewEveryDays: "\u0939\u0930 {count} \u0926\u093F\u0928",
+    renewEveryWeek: "\u0939\u0930 \u0939\u092B\u093C\u094D\u0924\u0947",
+    renewEveryWeeks: "\u0939\u0930 {count} \u0939\u092B\u093C\u094D\u0924\u0947",
+    renewEveryMonth: "\u0939\u0930 \u092E\u0939\u0940\u0928\u0947",
+    renewEveryMonths: "\u0939\u0930 {count} \u092E\u0939\u0940\u0928\u0947",
+    renewEveryYear: "\u0939\u0930 \u0938\u093E\u0932",
+    renewEveryYears: "\u0939\u0930 {count} \u0938\u093E\u0932"
+  },
+  it: {
+    renewsUntilCancel: "Si rinnova {interval} finch\xE9 non annulli.",
+    switchPlansInAccount: "Cambia piano quando vuoi dal tuo account.",
+    renewEveryDay: "ogni giorno",
+    renewEveryDays: "ogni {count} giorni",
+    renewEveryWeek: "ogni settimana",
+    renewEveryWeeks: "ogni {count} settimane",
+    renewEveryMonth: "ogni mese",
+    renewEveryMonths: "ogni {count} mesi",
+    renewEveryYear: "ogni anno",
+    renewEveryYears: "ogni {count} anni"
+  },
+  lt: {
+    renewsUntilCancel: "Atnaujinama {interval}, kol at\u0161auksite.",
+    switchPlansInAccount: "Plan\u0105 galite bet kada pakeisti savo paskyroje.",
+    renewEveryDay: "kasdien",
+    renewEveryDays: "kas {count} d.",
+    renewEveryWeek: "kas savait\u0119",
+    renewEveryWeeks: "kas {count} sav.",
+    renewEveryMonth: "kas m\u0117nes\u012F",
+    renewEveryMonths: "kas {count} m\u0117n.",
+    renewEveryYear: "kasmet",
+    renewEveryYears: "kas {count} m."
+  },
+  nl: {
+    renewsUntilCancel: "Wordt {interval} verlengd tot je opzegt.",
+    switchPlansInAccount: "Wissel op elk moment van abonnement in je account.",
+    renewEveryDay: "elke dag",
+    renewEveryDays: "elke {count} dagen",
+    renewEveryWeek: "elke week",
+    renewEveryWeeks: "elke {count} weken",
+    renewEveryMonth: "elke maand",
+    renewEveryMonths: "elke {count} maanden",
+    renewEveryYear: "elk jaar",
+    renewEveryYears: "elke {count} jaar"
+  },
+  pl: {
+    renewsUntilCancel: "Odnawia si\u0119 {interval}, dop\xF3ki nie anulujesz.",
+    switchPlansInAccount: "Zmie\u0144 plan w dowolnym momencie na swoim koncie.",
+    renewEveryDay: "codziennie",
+    renewEveryDays: "co {count} dni",
+    renewEveryWeek: "co tydzie\u0144",
+    renewEveryWeeks: "co {count} tyg.",
+    renewEveryMonth: "co miesi\u0105c",
+    renewEveryMonths: "co {count} mies.",
+    renewEveryYear: "co roku",
+    renewEveryYears: "co {count} l."
+  },
+  pt: {
+    renewsUntilCancel: "Renova {interval} at\xE9 voc\xEA cancelar.",
+    switchPlansInAccount: "Troque de plano quando quiser na sua conta.",
+    renewEveryDay: "todos os dias",
+    renewEveryDays: "a cada {count} dias",
+    renewEveryWeek: "toda semana",
+    renewEveryWeeks: "a cada {count} semanas",
+    renewEveryMonth: "todo m\xEAs",
+    renewEveryMonths: "a cada {count} meses",
+    renewEveryYear: "todo ano",
+    renewEveryYears: "a cada {count} anos"
+  },
+  ru: {
+    renewsUntilCancel: "\u041F\u0440\u043E\u0434\u043B\u0435\u0432\u0430\u0435\u0442\u0441\u044F {interval}, \u043F\u043E\u043A\u0430 \u0432\u044B \u043D\u0435 \u043E\u0442\u043C\u0435\u043D\u0438\u0442\u0435.",
+    switchPlansInAccount: "\u0421\u043C\u0435\u043D\u0438\u0442\u044C \u0442\u0430\u0440\u0438\u0444 \u043C\u043E\u0436\u043D\u043E \u0432 \u043B\u044E\u0431\u043E\u0439 \u043C\u043E\u043C\u0435\u043D\u0442 \u0432 \u0430\u043A\u043A\u0430\u0443\u043D\u0442\u0435.",
+    renewEveryDay: "\u043A\u0430\u0436\u0434\u044B\u0439 \u0434\u0435\u043D\u044C",
+    renewEveryDays: "\u0440\u0430\u0437 \u0432 {count} \u0434\u043D.",
+    renewEveryWeek: "\u043A\u0430\u0436\u0434\u0443\u044E \u043D\u0435\u0434\u0435\u043B\u044E",
+    renewEveryWeeks: "\u0440\u0430\u0437 \u0432 {count} \u043D\u0435\u0434.",
+    renewEveryMonth: "\u043A\u0430\u0436\u0434\u044B\u0439 \u043C\u0435\u0441\u044F\u0446",
+    renewEveryMonths: "\u0440\u0430\u0437 \u0432 {count} \u043C\u0435\u0441.",
+    renewEveryYear: "\u043A\u0430\u0436\u0434\u044B\u0439 \u0433\u043E\u0434",
+    renewEveryYears: "\u0440\u0430\u0437 \u0432 {count} \u0433."
+  },
+  tr: {
+    renewsUntilCancel: "\u0130ptal edene kadar {interval} yenilenir.",
+    switchPlansInAccount: "Plan\u0131n\u0131z\u0131 istedi\u011Finiz zaman hesab\u0131n\u0131zdan de\u011Fi\u015Ftirebilirsiniz.",
+    renewEveryDay: "her g\xFCn",
+    renewEveryDays: "her {count} g\xFCnde bir",
+    renewEveryWeek: "her hafta",
+    renewEveryWeeks: "her {count} haftada bir",
+    renewEveryMonth: "her ay",
+    renewEveryMonths: "her {count} ayda bir",
+    renewEveryYear: "her y\u0131l",
+    renewEveryYears: "her {count} y\u0131lda bir"
+  },
+  uk: {
+    renewsUntilCancel: "\u041F\u043E\u0434\u043E\u0432\u0436\u0443\u0454\u0442\u044C\u0441\u044F {interval}, \u0434\u043E\u043A\u0438 \u0432\u0438 \u043D\u0435 \u0441\u043A\u0430\u0441\u0443\u0454\u0442\u0435.",
+    switchPlansInAccount: "\u0417\u043C\u0456\u043D\u0438\u0442\u0438 \u043F\u043B\u0430\u043D \u043C\u043E\u0436\u043D\u0430 \u0431\u0443\u0434\u044C-\u043A\u043E\u043B\u0438 \u0432 \u043E\u0431\u043B\u0456\u043A\u043E\u0432\u043E\u043C\u0443 \u0437\u0430\u043F\u0438\u0441\u0456.",
+    renewEveryDay: "\u0449\u043E\u0434\u043D\u044F",
+    renewEveryDays: "\u0440\u0430\u0437 \u043D\u0430 {count} \u0434\u043D.",
+    renewEveryWeek: "\u0449\u043E\u0442\u0438\u0436\u043D\u044F",
+    renewEveryWeeks: "\u0440\u0430\u0437 \u043D\u0430 {count} \u0442\u0438\u0436.",
+    renewEveryMonth: "\u0449\u043E\u043C\u0456\u0441\u044F\u0446\u044F",
+    renewEveryMonths: "\u0440\u0430\u0437 \u043D\u0430 {count} \u043C\u0456\u0441.",
+    renewEveryYear: "\u0449\u043E\u0440\u043E\u043A\u0443",
+    renewEveryYears: "\u0440\u0430\u0437 \u043D\u0430 {count} \u0440."
+  },
+  zh: {
+    renewsUntilCancel: "{interval}\u81EA\u52A8\u7EED\u8BA2\uFF0C\u76F4\u5230\u4F60\u53D6\u6D88\u3002",
+    switchPlansInAccount: "\u53EF\u968F\u65F6\u5728\u4F60\u7684\u8D26\u6237\u4E2D\u5207\u6362\u65B9\u6848\u3002",
+    renewEveryDay: "\u6BCF\u5929",
+    renewEveryDays: "\u6BCF {count} \u5929",
+    renewEveryWeek: "\u6BCF\u5468",
+    renewEveryWeeks: "\u6BCF {count} \u5468",
+    renewEveryMonth: "\u6BCF\u6708",
+    renewEveryMonths: "\u6BCF {count} \u4E2A\u6708",
+    renewEveryYear: "\u6BCF\u5E74",
+    renewEveryYears: "\u6BCF {count} \u5E74"
+  }
+};
+function resolveSubscriptionRenewalLocale(lang) {
+  const base = (lang ?? "").trim().toLowerCase().split(/[-_]/)[0] ?? "";
+  return base in SUBSCRIPTION_RENEWAL_MESSAGES ? base : "en";
+}
+function subscriptionRenewalMessage(key, lang) {
+  const activeLang = lang === void 0 && typeof document !== "undefined" ? document.documentElement.getAttribute("lang") : lang;
+  return SUBSCRIPTION_RENEWAL_MESSAGES[resolveSubscriptionRenewalLocale(activeLang)][key];
+}
+
 // src/video-embed.ts
 var ALLOWED_VIDEO_EMBED_HOSTS = /* @__PURE__ */ new Set([
   "www.youtube-nocookie.com",
@@ -575,13 +779,19 @@ function formatSubscriptionCadence(subscription) {
   const noun = SUBSCRIPTION_INTERVAL_NOUNS[unit];
   return subscription.intervalCount === 1 ? `per ${noun}` : `every ${subscription.intervalCount} ${noun}s`;
 }
-function formatSubscriptionRenewal(subscription) {
+var RENEWAL_INTERVAL_KEYS = {
+  DAY: ["renewEveryDay", "renewEveryDays"],
+  WEEK: ["renewEveryWeek", "renewEveryWeeks"],
+  MONTH: ["renewEveryMonth", "renewEveryMonths"],
+  YEAR: ["renewEveryYear", "renewEveryYears"]
+};
+function formatSubscriptionRenewal(subscription, lang) {
   const unit = subscription.intervalUnit;
   if (unit === null) return "";
-  const noun = SUBSCRIPTION_INTERVAL_NOUNS[unit];
-  const every = subscription.intervalCount === 1 ? `every ${noun}` : `every ${subscription.intervalCount} ${noun}s`;
-  const renews = `Renews ${every} until you cancel.`;
-  return subscription.planChangeOffered ? `${renews} Switch plans any time in your account.` : renews;
+  const [one, many] = RENEWAL_INTERVAL_KEYS[unit];
+  const interval = subscription.intervalCount === 1 ? subscriptionRenewalMessage(one, lang) : subscriptionRenewalMessage(many, lang).replace("{count}", String(subscription.intervalCount));
+  const renews = subscriptionRenewalMessage("renewsUntilCancel", lang).replace("{interval}", interval);
+  return subscription.planChangeOffered ? `${renews} ${subscriptionRenewalMessage("switchPlansInAccount", lang)}` : renews;
 }
 function formatSubscriptionTrial(subscription, formatAmount) {
   const trial = subscription.trial;
@@ -590,13 +800,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 +1269,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`),