@carlonicora/nextjs-jsonapi 5.5.0 → 5.6.0

package/dist/server/index.js

@@ -3,7 +3,7 @@
 
 
 
-var _chunkYDYVJM4Ijs = require('../chunk-YDYVJM4I.js');
+var _chunk53BAULDPjs = require('../chunk-53BAULDP.js');
 
 
 var _chunkIK65TDQHjs = require('../chunk-IK65TDQH.js');
@@ -35,7 +35,7 @@ require('../chunk-G4JR3SFV.js');
 
 
 
-var _chunkG6UE6MEPjs = require('../chunk-G6UE6MEP.js');
+var _chunkHKZAESS6js = require('../chunk-HKZAESS6.js');
 require('../chunk-GHE4VT2R.js');
 require('../chunk-LXKSUWAV.js');
 require('../chunk-JTPRJNT2.js');
@@ -66,5 +66,5 @@ require('../chunk-7QVYU63E.js');
 
 
 
-exports.CACHE_PROFILES = _chunkIK65TDQHjs.CACHE_PROFILES; exports.ServerAuthService = _chunkG6UE6MEPjs.AuthService; exports.ServerCompanyService = _chunkG6UE6MEPjs.CompanyService; exports.ServerContentService = _chunkG6UE6MEPjs.ContentService; exports.ServerFeatureService = _chunkG6UE6MEPjs.FeatureService; exports.ServerJsonApiDelete = _chunkKSYQEKJXjs.ServerJsonApiDelete; exports.ServerJsonApiGet = _chunkKSYQEKJXjs.ServerJsonApiGet; exports.ServerJsonApiPatch = _chunkKSYQEKJXjs.ServerJsonApiPatch; exports.ServerJsonApiPost = _chunkKSYQEKJXjs.ServerJsonApiPost; exports.ServerJsonApiPut = _chunkKSYQEKJXjs.ServerJsonApiPut; exports.ServerNotificationService = _chunkG6UE6MEPjs.NotificationService; exports.ServerPushService = _chunkG6UE6MEPjs.PushService; exports.ServerRoleService = _chunkG6UE6MEPjs.RoleService; exports.ServerS3Service = _chunkG6UE6MEPjs.S3Service; exports.ServerSession = _chunkYDYVJM4Ijs.ServerSession; exports.ServerUserService = _chunkG6UE6MEPjs.UserService; exports.configureServerJsonApi = _chunkKSYQEKJXjs.configureServerJsonApi; exports.getServerApiUrl = _chunkKSYQEKJXjs.getServerApiUrl; exports.getServerAppUrl = _chunkKSYQEKJXjs.getServerAppUrl; exports.getServerToken = _chunkYUO55Q5Ajs.getServerToken; exports.getServerTrackablePages = _chunkKSYQEKJXjs.getServerTrackablePages; exports.invalidateCacheTag = _chunkYDYVJM4Ijs.invalidateCacheTag; exports.invalidateCacheTags = _chunkYDYVJM4Ijs.invalidateCacheTags; exports.serverRequest = _chunk6TUB7Y6Tjs.serverRequest; exports.updateCacheTag = _chunkYDYVJM4Ijs.updateCacheTag;
+exports.CACHE_PROFILES = _chunkIK65TDQHjs.CACHE_PROFILES; exports.ServerAuthService = _chunkHKZAESS6js.AuthService; exports.ServerCompanyService = _chunkHKZAESS6js.CompanyService; exports.ServerContentService = _chunkHKZAESS6js.ContentService; exports.ServerFeatureService = _chunkHKZAESS6js.FeatureService; exports.ServerJsonApiDelete = _chunkKSYQEKJXjs.ServerJsonApiDelete; exports.ServerJsonApiGet = _chunkKSYQEKJXjs.ServerJsonApiGet; exports.ServerJsonApiPatch = _chunkKSYQEKJXjs.ServerJsonApiPatch; exports.ServerJsonApiPost = _chunkKSYQEKJXjs.ServerJsonApiPost; exports.ServerJsonApiPut = _chunkKSYQEKJXjs.ServerJsonApiPut; exports.ServerNotificationService = _chunkHKZAESS6js.NotificationService; exports.ServerPushService = _chunkHKZAESS6js.PushService; exports.ServerRoleService = _chunkHKZAESS6js.RoleService; exports.ServerS3Service = _chunkHKZAESS6js.S3Service; exports.ServerSession = _chunk53BAULDPjs.ServerSession; exports.ServerUserService = _chunkHKZAESS6js.UserService; exports.configureServerJsonApi = _chunkKSYQEKJXjs.configureServerJsonApi; exports.getServerApiUrl = _chunkKSYQEKJXjs.getServerApiUrl; exports.getServerAppUrl = _chunkKSYQEKJXjs.getServerAppUrl; exports.getServerToken = _chunkYUO55Q5Ajs.getServerToken; exports.getServerTrackablePages = _chunkKSYQEKJXjs.getServerTrackablePages; exports.invalidateCacheTag = _chunk53BAULDPjs.invalidateCacheTag; exports.invalidateCacheTags = _chunk53BAULDPjs.invalidateCacheTags; exports.serverRequest = _chunk6TUB7Y6Tjs.serverRequest; exports.updateCacheTag = _chunk53BAULDPjs.updateCacheTag;
 //# sourceMappingURL=index.js.map

package/dist/server/index.mjs

@@ -3,7 +3,7 @@ import {
   invalidateCacheTag,
   invalidateCacheTags,
   updateCacheTag
-} from "../chunk-3CGROPF3.mjs";
+} from "../chunk-BTPUYUQ3.mjs";
 import {
   CACHE_PROFILES
 } from "../chunk-T7SAW3UW.mjs";
@@ -35,7 +35,7 @@ import {
   RoleService,
   S3Service,
   UserService
-} from "../chunk-VC5A3AUZ.mjs";
+} from "../chunk-EYA2F6AN.mjs";
 import "../chunk-V5MI7RNB.mjs";
 import "../chunk-AUXK7QSA.mjs";
 import "../chunk-PI56A4DG.mjs";

package/messages/en.json

@@ -297,6 +297,118 @@
   },
   "billing": {
     "admin": {
+      "coupons": {
+        "all_products": "All products",
+        "codes": {
+          "automatic": "Automatic",
+          "deactivate": {
+            "confirm": "Deactivate",
+            "description": "Nobody will be able to use \"{code}\" until you reactivate it. Subscriptions that already have it keep their discount.",
+            "title": "Deactivate code"
+          },
+          "empty": {
+            "description": "Add a code customers can use to get this coupon's discount.",
+            "title": "No codes yet"
+          },
+          "entity": "code",
+          "never": "Never",
+          "reactivate": {
+            "confirm": "Reactivate",
+            "description": "\"{code}\" can be used again.",
+            "title": "Reactivate code"
+          },
+          "status": {
+            "active": "Active",
+            "expired": "Expired",
+            "inactive": "Inactive",
+            "used_up": "Used up"
+          },
+          "title": "Codes"
+        },
+        "discount": {
+          "amount": "{amount} off",
+          "forever": "forever",
+          "once": "once",
+          "percent": "{value}% off",
+          "repeating": "for {months} months"
+        },
+        "duration": {
+          "forever": "Forever",
+          "once": "Once",
+          "repeating": "For a number of months"
+        },
+        "empty": {
+          "description": "Create a coupon to offer a discount at checkout.",
+          "title": "No coupons yet"
+        },
+        "entity": "coupon",
+        "errors": {
+          "amountOff": "Enter an amount above zero",
+          "durationInMonths": "Enter at least one month",
+          "minimumAmount": "Enter an amount above zero, or leave it empty",
+          "name": "A coupon name is required",
+          "percentOff": "Enter a percentage between 0.01 and 100"
+        },
+        "fields": {
+          "amountOff": "Amount off",
+          "automatic": "Apply automatically",
+          "code": "Code",
+          "codeMaxRedemptions": "Usage limit for this code",
+          "codes": "Codes",
+          "currency": "Currency",
+          "discount": "Discount",
+          "discountType": "Type",
+          "duration": "Duration",
+          "durationInMonths": "Months",
+          "expiresAt": "Expires",
+          "firstTimeTransaction": "First-time customers only",
+          "first_time_warning": "A GM coming from a trial counts as an existing customer, so leave this off for codes meant for trial GMs.",
+          "maxRedemptions": "Total usage limit",
+          "minimumAmount": "Minimum order amount",
+          "name": "Name",
+          "percentOff": "Percentage off",
+          "places": "Places",
+          "products": "Apply to specific products",
+          "redeemBy": "Redeem by",
+          "status": "Status",
+          "stripeCouponId": "ID",
+          "stripeCustomerId": "Limit to one customer",
+          "stripeId": "Stripe coupon ID"
+        },
+        "first_code": "First code",
+        "fixed_notice": "Stripe doesn't allow changing the discount, duration or limits of a coupon. Make a new coupon instead.",
+        "help": {
+          "automatic": "Applied by itself when a GM first pays. Only one code can have it: switching it on here switches it off on the code that had it.",
+          "products": "Leave empty to apply the coupon to every product."
+        },
+        "placeholders": {
+          "amountOff": "5.00",
+          "code": "Leave empty to let Stripe generate one",
+          "durationInMonths": "3",
+          "maxRedemptions": "No limit",
+          "minimumAmount": "0.00",
+          "name": "e.g. Founding GM",
+          "percentOff": "20",
+          "stripeCouponId": "Leave empty to let Stripe generate one"
+        },
+        "places": {
+          "limited": "{used} / {limit}",
+          "no_limit": "No limit",
+          "unlimited": "{used} / no limit"
+        },
+        "refresh": {
+          "title": "Refresh counts"
+        },
+        "status": {
+          "active": "Active",
+          "ended": "Ended"
+        },
+        "title": "Coupons",
+        "type": {
+          "amount_off": "Fixed amount off",
+          "percent_off": "Percentage off"
+        }
+      },
       "prices": {
         "actions": {
           "addFeature": "Add feature",
@@ -430,7 +542,9 @@
           "archived": "Archived"
         },
         "tabs": {
-          "details": "Details"
+          "codes": "Codes",
+          "details": "Details",
+          "products": "Products"
         },
         "title": "Products"
       }
@@ -626,10 +740,12 @@
       },
       "promo_code": {
         "apply": "Apply",
+        "automatic_label": "Applied automatically",
         "duration_forever": "Applied to all payments",
         "duration_once": "Applied to first payment only",
         "duration_repeating": "Applied for {months} months",
-        "placeholder": "Enter promo code"
+        "placeholder": "Enter promo code",
+        "use_different": "Have a different code?"
       },
       "proration": {
         "net_due_today": "Net Due Today",
@@ -698,8 +814,10 @@
         "change_title": "Change Subscription Plan",
         "errors": {
           "already_subscribed": "You already have an active subscription. Please change your existing plan instead.",
+          "discount_unavailable": "This discount is no longer available. You have not been charged.",
           "invalid_promo_code": "Invalid promotion code",
           "payment_method_required": "A payment method is required to upgrade from your trial.",
+          "payment_not_confirmed": "The payment was not completed. {reason} Nothing was charged: try again, or add another card.",
           "prepare_review": "Failed to prepare review",
           "process_subscription": "Failed to process subscription",
           "validate_promo_code": "Failed to validate promotion code"
@@ -708,6 +826,7 @@
         "payment_description": "Enter your card details to complete your subscription",
         "review": {
           "amount_off": "{amount} off",
+          "card_on_file": "{brand} ending in {last4}",
           "charge_now": "Amount to charge now:",
           "confirm_change": "Confirm Plan Change",
           "due_now": "Amount due now:",
@@ -725,7 +844,10 @@
           "selected_plan": "Selected Plan",
           "subscribe_now": "Subscribe Now",
           "trial_upgrade": "Trial Upgrade",
-          "trial_upgrade_description": "Your trial will end immediately and you will be charged the full price."
+          "trial_upgrade_description": "Your trial will end immediately and you will be charged the full price.",
+          "trial_upgrade_description_discounted": "Your trial will end immediately and you will be charged the discounted price.",
+          "use_another_card": "Use another card",
+          "discount_carries_over": "Your current discount carries over to the new plan."
         },
         "steps": {
           "payment": "Payment",

package/messages/it.json

@@ -297,6 +297,118 @@
   },
   "billing": {
     "admin": {
+      "coupons": {
+        "all_products": "Tutti i prodotti",
+        "codes": {
+          "automatic": "Automatico",
+          "deactivate": {
+            "confirm": "Disattiva",
+            "description": "Nessuno potrà usare \"{code}\" finché non lo riattivi. Gli abbonamenti che lo hanno già mantengono lo sconto.",
+            "title": "Disattiva codice"
+          },
+          "empty": {
+            "description": "Aggiungi un codice che i clienti possono usare per avere lo sconto di questo coupon.",
+            "title": "Ancora nessun codice"
+          },
+          "entity": "codice",
+          "never": "Mai",
+          "reactivate": {
+            "confirm": "Riattiva",
+            "description": "\"{code}\" potrà essere usato di nuovo.",
+            "title": "Riattiva codice"
+          },
+          "status": {
+            "active": "Attivo",
+            "expired": "Scaduto",
+            "inactive": "Inattivo",
+            "used_up": "Esaurito"
+          },
+          "title": "Codici"
+        },
+        "discount": {
+          "amount": "{amount} di sconto",
+          "forever": "per sempre",
+          "once": "una volta",
+          "percent": "{value}% di sconto",
+          "repeating": "per {months} mesi"
+        },
+        "duration": {
+          "forever": "Per sempre",
+          "once": "Una volta",
+          "repeating": "Per un numero di mesi"
+        },
+        "empty": {
+          "description": "Crea un coupon per offrire uno sconto al pagamento.",
+          "title": "Ancora nessun coupon"
+        },
+        "entity": "coupon",
+        "errors": {
+          "amountOff": "Inserisci un importo maggiore di zero",
+          "durationInMonths": "Inserisci almeno un mese",
+          "minimumAmount": "Inserisci un importo maggiore di zero, o lascia vuoto",
+          "name": "Il nome del coupon è obbligatorio",
+          "percentOff": "Inserisci una percentuale tra 0,01 e 100"
+        },
+        "fields": {
+          "amountOff": "Importo dello sconto",
+          "automatic": "Applica automaticamente",
+          "code": "Codice",
+          "codeMaxRedemptions": "Limite di utilizzo per questo codice",
+          "codes": "Codici",
+          "currency": "Valuta",
+          "discount": "Sconto",
+          "discountType": "Tipo",
+          "duration": "Durata",
+          "durationInMonths": "Mesi",
+          "expiresAt": "Scadenza",
+          "firstTimeTransaction": "Solo nuovi clienti",
+          "first_time_warning": "Un GM che arriva da una prova conta come cliente esistente, quindi lascia disattivato per i codici pensati per i GM in prova.",
+          "maxRedemptions": "Limite di utilizzo totale",
+          "minimumAmount": "Importo minimo dell'ordine",
+          "name": "Nome",
+          "percentOff": "Percentuale di sconto",
+          "places": "Posti",
+          "products": "Applica a prodotti specifici",
+          "redeemBy": "Utilizzabile fino al",
+          "status": "Stato",
+          "stripeCouponId": "ID",
+          "stripeCustomerId": "Limita a un solo cliente",
+          "stripeId": "ID coupon Stripe"
+        },
+        "first_code": "Primo codice",
+        "fixed_notice": "Stripe non permette di cambiare sconto, durata o limiti di un coupon. Crea un nuovo coupon.",
+        "help": {
+          "automatic": "Si applica da solo quando un GM paga la prima volta. Solo un codice può averlo: attivarlo qui lo disattiva sul codice che lo aveva.",
+          "products": "Lascia vuoto per applicare il coupon a tutti i prodotti."
+        },
+        "placeholders": {
+          "amountOff": "5,00",
+          "code": "Lascia vuoto per farlo generare a Stripe",
+          "durationInMonths": "3",
+          "maxRedemptions": "Nessun limite",
+          "minimumAmount": "0,00",
+          "name": "es. GM fondatore",
+          "percentOff": "20",
+          "stripeCouponId": "Lascia vuoto per farlo generare a Stripe"
+        },
+        "places": {
+          "limited": "{used} / {limit}",
+          "no_limit": "Nessun limite",
+          "unlimited": "{used} / nessun limite"
+        },
+        "refresh": {
+          "title": "Aggiorna conteggi"
+        },
+        "status": {
+          "active": "Attivo",
+          "ended": "Terminato"
+        },
+        "title": "Coupon",
+        "type": {
+          "amount_off": "Importo fisso",
+          "percent_off": "Percentuale"
+        }
+      },
       "prices": {
         "actions": {
           "addFeature": "Aggiungi caratteristica",
@@ -430,7 +542,9 @@
           "archived": "Archiviato"
         },
         "tabs": {
-          "details": "Dettagli"
+          "codes": "Codici",
+          "details": "Dettagli",
+          "products": "Prodotti"
         },
         "title": "Prodotti"
       }
@@ -626,10 +740,12 @@
       },
       "promo_code": {
         "apply": "Applica",
+        "automatic_label": "Applicato automaticamente",
         "duration_forever": "Applicato a tutti i pagamenti",
         "duration_once": "Applicato solo al primo pagamento",
         "duration_repeating": "Applicato per {months} mesi",
-        "placeholder": "Inserisci il codice promozionale"
+        "placeholder": "Inserisci il codice promozionale",
+        "use_different": "Hai un altro codice?"
       },
       "proration": {
         "net_due_today": "Netto dovuto oggi",
@@ -698,8 +814,10 @@
         "change_title": "Cambia piano di abbonamento",
         "errors": {
           "already_subscribed": "Hai già un abbonamento attivo. Cambia invece il piano attuale.",
+          "discount_unavailable": "Questo sconto non è più disponibile. Non ti è stato addebitato nulla.",
           "invalid_promo_code": "Codice promozionale non valido",
           "payment_method_required": "Per passare dalla prova a un piano a pagamento serve un metodo di pagamento.",
+          "payment_not_confirmed": "Il pagamento non è stato completato. {reason} Non ti è stato addebitato nulla: riprova o aggiungi un'altra carta.",
           "prepare_review": "Impossibile preparare il riepilogo",
           "process_subscription": "Impossibile elaborare l'abbonamento",
           "validate_promo_code": "Impossibile verificare il codice promozionale"
@@ -708,6 +826,7 @@
         "payment_description": "Inserisci i dati della carta per completare l'abbonamento",
         "review": {
           "amount_off": "{amount} di sconto",
+          "card_on_file": "{brand} che termina con {last4}",
           "charge_now": "Importo da addebitare ora:",
           "confirm_change": "Conferma il cambio di piano",
           "due_now": "Importo dovuto ora:",
@@ -725,7 +844,10 @@
           "selected_plan": "Piano selezionato",
           "subscribe_now": "Abbonati ora",
           "trial_upgrade": "Passaggio dalla prova",
-          "trial_upgrade_description": "La tua prova terminerà subito e ti verrà addebitato il prezzo pieno."
+          "trial_upgrade_description": "La tua prova terminerà subito e ti verrà addebitato il prezzo pieno.",
+          "trial_upgrade_description_discounted": "La tua prova terminerà subito e ti verrà addebitato il prezzo scontato.",
+          "use_another_card": "Usa un'altra carta",
+          "discount_carries_over": "Il tuo sconto attuale resta valido anche sul nuovo piano."
         },
         "steps": {
           "payment": "Pagamento",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@carlonicora/nextjs-jsonapi",
-  "version": "5.5.0",
+  "version": "5.6.0",
   "description": "Next.js JSON:API client with server/client support and caching",
   "author": "Carlo Nicora",
   "license": "GPL-3.0-or-later",

package/scripts/validate-messages.mjs

@@ -28,6 +28,7 @@ export const APP_PROVIDED_KEYS = [
   /^features\.assistant\.starters\./, // example questions about the app's own domain
   /^features\.assistant\.empty_state\.subtitle$/, // says what the app's assistant knows about
   /^auth\.gdpr\.marketing_consent$/, // a consent must name who sends the news: the app
+  /^billing\.ui\.wizard\.errors\.discount_sold_out$/, // names who to contact: the app
   // The app's own entities (CommonDeleter / RecentPagesNavigator render
   // `entities.${type}` for any module). Only the library's own entities ship.
   /^entities\.(?!(?:assistants|companies|howtos|rbac|roles|users)(?:\.|$))/,

package/src/billing/index.ts

@@ -5,6 +5,7 @@ export * from "../features/billing/stripe-customer/components";
 export * from "../features/billing/stripe-invoice/components";
 export * from "../features/billing/stripe-price/components";
 export * from "../features/billing/stripe-product/components";
+export * from "../features/billing/stripe-coupon/components";
 export * from "../features/billing/stripe-subscription/components";
 export * from "../features/billing/stripe-usage/components";
 export * from "../features/billing/stripe-promotion-code/components";

package/src/client/index.ts

@@ -21,6 +21,8 @@ import { useRoleTableStructure } from "../features/role/hooks";
 import { useUserTableStructure } from "../features/user/hooks";
 import { useStripePriceTableStructure } from "../features/billing/stripe-price/hooks/useStripePriceTableStructure";
 import { useStripeProductTableStructure } from "../features/billing/stripe-product/hooks/useStripeProductTableStructure";
+import { useStripeCouponTableStructure } from "../features/billing/stripe-coupon/hooks/useStripeCouponTableStructure";
+import { useStripeCouponCodeTableStructure } from "../features/billing/stripe-coupon/hooks/useStripeCouponCodeTableStructure";
 import { useWaitlistTableStructure } from "../features/waitlist/hooks/useWaitlistTableStructure";
 import { registerTableGenerator } from "../hooks";
 
@@ -35,5 +37,7 @@ registerTableGenerator("users", useUserTableStructure);
 registerTableGenerator("companies", useCompanyTableStructure);
 registerTableGenerator("stripe-products", useStripeProductTableStructure);
 registerTableGenerator("stripe-prices", useStripePriceTableStructure);
+registerTableGenerator("stripe-coupons", useStripeCouponTableStructure);
+registerTableGenerator("stripe-coupon-codes", useStripeCouponCodeTableStructure);
 registerTableGenerator("waitlists", useWaitlistTableStructure);
 // Note: Content registration moved to app-level to support app-specific cellTopic

package/src/core/index.ts

@@ -56,6 +56,7 @@ export * from "../features/billing/stripe-product";
 export * from "../features/billing/stripe-subscription";
 export * from "../features/billing/stripe-usage";
 export * from "../features/billing/stripe-promotion-code";
+export * from "../features/billing/stripe-coupon";
 // AI connection administration: data + module only, NOT the feature barrel —
 // that one also re-exports the feature's client components, and core must stay
 // importable from the server (same rationale as the tokenusage entries below).

package/src/core/registry/ModuleRegistry.ts

@@ -34,6 +34,9 @@ export interface FoundationModuleDefinitions {
   StripePrice: ModuleWithPermissions;
   StripeUsage: ModuleWithPermissions;
   StripePromotionCode: ModuleWithPermissions;
+  StripeCoupon: ModuleWithPermissions;
+  StripeCouponCode: ModuleWithPermissions;
+  StripeCouponOffer: ModuleWithPermissions;
   // AI connection administration
   AiConnection: ModuleWithPermissions;
   // OAuth modules

package/src/features/billing/components/cards/InvoicesSummaryCard.tsx

@@ -71,8 +71,9 @@ export function InvoicesSummaryCard({ invoices, loading, error, onViewAllClick }
     );
   }
 
-  // Get the most recent invoice
-  const latestInvoice = invoices[0];
+  // The most recent invoice that could charge something: a void one is an unpaid first-payment
+  // attempt that was replaced, which never charged the GM (fall back to it only when nothing else exists)
+  const latestInvoice = invoices.find((inv) => inv.status !== InvoiceStatus.VOID) ?? invoices[0];
   const paidInvoices = invoices.filter((inv) => inv.status === InvoiceStatus.PAID);
   const openInvoices = invoices.filter((inv) => inv.status === InvoiceStatus.OPEN);
 

package/src/features/billing/components/cards/SubscriptionSummaryCard.tsx

@@ -91,7 +91,8 @@ export function SubscriptionSummaryCard({
         <CreditCard className="h-4 w-4 text-muted-foreground" />
       </CardHeader>
       <CardContent>
-        {subscriptions.length === 0 ? (
+        {/* No active or trialing plan (none at all, or only unpaid / ended ones): offer the plans */}
+        {!primarySubscription ? (
           <div className="space-y-2">
             <p className="text-xl font-bold text-muted-foreground">{t("billing.ui.cards.subscriptions.empty_title")}</p>
             <p className="text-xs text-muted-foreground">{t("billing.ui.cards.subscriptions.empty_description")}</p>
@@ -108,7 +109,7 @@ export function SubscriptionSummaryCard({
               <ChevronRight className="h-4 w-4 ms-1 rtl:rotate-180" />
             </Button>
           </div>
-        ) : primarySubscription ? (
+        ) : (
           <div className="space-y-2">
             <div className="flex items-center gap-2">
               <p className="text-xl font-bold">
@@ -147,7 +148,7 @@ export function SubscriptionSummaryCard({
               </p>
             )}
           </div>
-        ) : null}
+        )}
       </CardContent>
     </Card>
   );

package/src/features/billing/components/containers/BillingDashboardContainer.tsx

@@ -22,6 +22,7 @@ import {
   SubscriptionSummaryCard,
 } from "../cards";
 import { BillingDetailModal } from "../modals/BillingDetailModal";
+import { urlWithoutParam } from "../utils/url";
 import { BillingAlertBanner } from "../widgets/BillingAlertBanner";
 
 type ModalType = "subscriptions" | "payment-methods" | "invoices" | "usage" | null;
@@ -282,14 +283,27 @@ export function BillingDashboardContainer() {
     fetchAllData();
   }, [fetchAllData]);
 
-  // Handle URL action parameter for deep linking
+  // Handle URL action parameter for deep linking. `?action=subscribe` records the
+  // intent to subscribe; the wizard itself only renders once a customer exists, so a
+  // company without one sees the setup card first and the wizard opens right after
+  // "Set Up Billing Account" succeeds.
   useEffect(() => {
     const action = searchParams.get("action");
     if (action === "subscribe") {
-      // Open wizard directly (no wrapper modal)
       setShowWizard(true);
-      // Clear the URL param to prevent re-triggering on refresh
-      window.history.replaceState({}, "", window.location.pathname);
+      // Drop only `action`, so a refresh does not re-trigger it. Every other parameter
+      // must survive: a host page (the settings hub) selects this dashboard through
+      // `?section=`, and losing it switches the page away and unmounts this component.
+      window.history.replaceState(
+        window.history.state,
+        "",
+        urlWithoutParam({
+          pathname: window.location.pathname,
+          search: window.location.search,
+          hash: window.location.hash,
+          param: "action",
+        }),
+      );
     }
   }, [searchParams]);
 
@@ -445,9 +459,12 @@ export function BillingDashboardContainer() {
             onOpenChange={handleModalClose}
             title={getModalTitle("subscriptions")}
           >
+            {/* The dashboard's list, so a wizard success (refreshData) refreshes the dialog too */}
             <SubscriptionsContainer
               onOpenWizard={handleOpenWizard}
               hasActiveRecurringSubscription={hasActiveRecurringSubscription}
+              subscriptions={data.subscriptions}
+              onSubscriptionsChange={refreshData}
             />
           </BillingDetailModal>
 
@@ -477,7 +494,7 @@ export function BillingDashboardContainer() {
 
           {/* Subscription Wizard - rendered at dashboard level to avoid nested dialogs */}
           <SubscriptionWizard
-            open={showWizard}
+            open={showWizard && !!data.customer}
             onOpenChange={(open) => !open && handleWizardClose()}
             onSuccess={refreshData}
             hasActiveRecurringSubscription={hasActiveRecurringSubscription}

package/src/features/billing/components/utils/__tests__/discount.spec.ts

@@ -0,0 +1,59 @@
+import { describe, expect, it } from "vitest";
+import { StripeSubscriptionInterface } from "../../../stripe-subscription/data/stripe-subscription.interface";
+import { applyDiscount, promotionCodeDiscount, subscriptionDiscount } from "../discount";
+
+const subscription = (discount: StripeSubscriptionInterface["discount"]) =>
+  ({ discount }) as unknown as StripeSubscriptionInterface;
+
+describe("applyDiscount", () => {
+  it("takes a percentage off", () => {
+    expect(applyDiscount(999, { discountType: "percent_off", discountValue: 20 })).toBeCloseTo(799.2);
+  });
+
+  it("takes an amount off without going below zero", () => {
+    expect(applyDiscount(499, { discountType: "amount_off", discountValue: 100 })).toBe(399);
+    expect(applyDiscount(499, { discountType: "amount_off", discountValue: 1000 })).toBe(0);
+  });
+
+  it("returns null without a discount or an amount", () => {
+    expect(applyDiscount(999, null)).toBeNull();
+    expect(applyDiscount(undefined, { discountType: "percent_off", discountValue: 20 })).toBeNull();
+  });
+});
+
+describe("promotionCodeDiscount", () => {
+  it("reads a valid code", () => {
+    expect(
+      promotionCodeDiscount({ valid: true, code: "FOUNDER", discountType: "percent_off", discountValue: 20 }),
+    ).toEqual({ discountType: "percent_off", discountValue: 20, currency: undefined });
+  });
+
+  it("ignores an invalid or missing code", () => {
+    expect(
+      promotionCodeDiscount({ valid: false, code: "X", discountType: "percent_off", discountValue: 20 }),
+    ).toBeNull();
+    expect(promotionCodeDiscount(null)).toBeNull();
+  });
+});
+
+describe("subscriptionDiscount", () => {
+  it("reads a percentage discount", () => {
+    expect(subscriptionDiscount(subscription({ percentOff: 20, duration: "forever" }))).toEqual({
+      discountType: "percent_off",
+      discountValue: 20,
+    });
+  });
+
+  it("reads an amount discount with its currency", () => {
+    expect(subscriptionDiscount(subscription({ amountOff: 200, currency: "eur", duration: "once" }))).toEqual({
+      discountType: "amount_off",
+      discountValue: 200,
+      currency: "eur",
+    });
+  });
+
+  it("returns null when the subscription has no discount", () => {
+    expect(subscriptionDiscount(subscription(undefined))).toBeNull();
+    expect(subscriptionDiscount(undefined)).toBeNull();
+  });
+});