@growth-operations/ui-shared 1.12.4 → 1.13.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@growth-operations/ui-shared",
-  "version": "1.12.4",
+  "version": "1.13.1",
   "description": "Shared HubSpot UI-extension modules (Home, Billing) for Growth Operations apps.",
   "license": "MIT",
   "private": false,

package/src/billing/BillingTab.jsx

@@ -350,13 +350,25 @@ function CreditsBilling({ context, state, appKey, openIframe = null }) {
         `&return_url=${encodeURIComponent(returnUrl)}`
       : null;
 
-  // PAID: do NOT show the plan picker. The picker's "Choose" starts a NEW Stripe
-  // Checkout subscription — clicking another tier would create a SECOND
-  // subscription (double-bill), not switch in place. Plan changes (upgrade/
-  // downgrade/cancel) go through the Stripe Customer Portal, which swaps the
-  // subscription item with proration. So on a paid plan we show the meter + a
-  // "Manage subscription" portal link only. (Matches toast/sparkfly.)
+  // PAID: an UPGRADE-ONLY picker, same trial-archetype pattern as
+  // TrialSubscriptionBilling above — higher tiers are one-click in-app via
+  // /v1/billing/upgrade/start, which swaps the EXISTING subscription's item
+  // in place (never a new Checkout session), so a click here can never
+  // double-bill. currentOrder (this tier's rank) makes PlanCard mark the
+  // current tier and disable everything ranked below it ("Talk to sales to
+  // switch") — the backend independently re-validates the same upgrade
+  // direction (start_upgrade_redirect's tier_order check), so this is safe
+  // even if currentOrder were ever wrong. Downgrade is intentionally NOT
+  // self-serve (policy, not a Stripe portal gap): PlanCard's own
+  // "Talk to sales to switch" is the one and only downgrade path. Cancel /
+  // payment method / invoices still go through the Stripe Customer Portal
+  // link below — the footnote must not imply Manage subscription can also
+  // downgrade (some apps' Stripe portal config has subscription_update
+  // disabled anyway, so it silently couldn't even if we wanted it to).
   if (onPaidPlan) {
+    const plans = state?.plans ?? [];
+    const currentOrder = plans.find((p) => p.current)?.tier_order;
+    const showPicker = currentOrder != null && plans.length > 0;
     return (
       <Flex direction="column" gap="medium">
         <CreditMeter
@@ -372,10 +384,24 @@ function CreditsBilling({ context, state, appKey, openIframe = null }) {
         >
           {portalStartUrl ? "Manage subscription" : "Preparing billing…"}
         </LoadingButton>
-        <Text format={{ fontStyle: "italic" }}>
-          Change or cancel your plan in Stripe — billing is managed across all
-          Growth Operations apps.
-        </Text>
+        {showPicker ? (
+          <PlanGrid
+            context={context}
+            state={state}
+            appKey={appKey}
+            currentOrder={currentOrder}
+            endpoint="upgrade/start"
+            ctaLabel="Upgrade to"
+            heading="Your plan"
+            footnote="Upgrade any time — the new tier applies immediately with prorated billing. To move to a lower tier, contact us. Use Manage subscription above to cancel or update your payment method."
+            openIframe={openIframe}
+          />
+        ) : (
+          <Text format={{ fontStyle: "italic" }}>
+            Change or cancel your plan in Stripe — billing is managed across all
+            Growth Operations apps.
+          </Text>
+        )}
       </Flex>
     );
   }