@cosmicdrift/kumiko-bundled-features 0.387.0 → 0.389.0

package/dist/billing-foundation/plan-switch.js

@@ -0,0 +1,60 @@
+// Pre-checks shared by switch-plan and plan-switch-preview: both must agree on
+// which subscription, provider and target price a plan switch means.
+// Internal — not re-exported from index.ts.
+import { ConflictError, UnprocessableError } from "@cosmicdrift/kumiko-framework/errors";
+import { assertBillingEnabled, findProviderPlugin, listCatalogProviders, } from "./checkout-core.js";
+import { getSubscriptionForTenant } from "./get-subscription-for-tenant.js";
+import { resolvePlanPrices } from "./plan-catalog.js";
+import { canSwitchPlans } from "./types.js";
+import { isSwitchableSubscriptionStatus } from "./web/constants.js";
+export async function preparePlanSwitch(ctx, catalog, tier, handlerName) {
+    const subscription = await getSubscriptionForTenant(ctx, ctx.user.tenantId);
+    if (!subscription || !isSwitchableSubscriptionStatus(subscription.status)) {
+        throw new ConflictError({
+            i18nKey: "billing-foundation.errors.noActiveSubscription",
+            message: "tenant has no switchable subscription; use billing-foundation:write:start-plan-checkout to start one",
+        });
+    }
+    // providerSubscriptionId only exists at the subscription's own provider; a catalog that
+    // no longer sells through that provider cannot switch it.
+    const provider = findProviderPlugin(ctx, subscription.providerName);
+    const isCatalogProvider = provider !== null &&
+        listCatalogProviders(ctx, catalog).some((candidate) => candidate.name === provider.name);
+    if (!provider || !isCatalogProvider) {
+        throw new ConflictError({
+            i18nKey: "billing-foundation.errors.providerMismatch",
+            message: `tenant's active subscription is on provider "${subscription.providerName}", which the plan catalog does not sell through — switch-plan cannot switch across providers`,
+        });
+    }
+    await assertBillingEnabled(ctx, provider.plugin, handlerName);
+    if (subscription.cancelAt !== null) {
+        throw new ConflictError({
+            i18nKey: "billing-foundation.errors.cancellationScheduled",
+            message: "subscription has a scheduled cancellation; reactivate it via billing-foundation:write:create-portal-session before switching plans",
+        });
+    }
+    if (tier === subscription.tier) {
+        throw new ConflictError({
+            i18nKey: "billing-foundation.errors.alreadyOnPlan",
+            message: `tenant is already on plan "${tier}"`,
+        });
+    }
+    if (!canSwitchPlans(provider.plugin)) {
+        throw new UnprocessableError("plan_switch_not_supported", {
+            i18nKey: "billing-foundation.errors.planSwitchNotSupported",
+            message: `subscription-foundation: provider "${subscription.providerName}" supports neither createPlanSwitchSession nor previewPlanSwitch + applyPlanSwitch`,
+        });
+    }
+    const prices = await resolvePlanPrices(ctx, provider.plugin, catalog);
+    const target = prices.get(tier);
+    if (!target) {
+        throw new UnprocessableError("price_unavailable", {
+            i18nKey: "billing-foundation.errors.priceUnavailable",
+            message: `subscription-foundation: no live price resolved for tier "${tier}"`,
+        });
+    }
+    const allowedPriceIds = [...prices.values()]
+        .filter((p) => p !== null)
+        .map((p) => p.priceId);
+    return { provider, subscription, target, allowedPriceIds };
+}

package/dist/billing-foundation/types.d.ts

@@ -75,6 +75,8 @@ export type PaymentEvent = {
     readonly priceId: string;
 };
 export type SubscriptionProviderPlugin = {
+    /** Human-readable provider name for the plan panel's provider switch. */
+    readonly displayName?: string;
     /**
      * Verify webhook signature + parse provider-event into normalized
      * form. **Pre-tenant-resolution** — no HandlerContext, because at
@@ -228,6 +230,24 @@ export type SubscriptionProviderPlugin = {
     }) => Promise<{
         readonly url: string;
     }>;
+    /**
+     * In-app plan switch, step 1: what the switch would cost right now. Together
+     * with `applyPlanSwitch` an alternative to the hosted `createPlanSwitchSession`.
+     */
+    readonly previewPlanSwitch?: (ctx: HandlerContext, options: {
+        readonly providerSubscriptionId: string;
+        readonly targetPriceId: string;
+    }) => Promise<PlanSwitchPreview>;
+    /**
+     * In-app plan switch, step 2: performs the switch at the provider. The
+     * state change itself arrives later through the webhook.
+     */
+    readonly applyPlanSwitch?: (ctx: HandlerContext, options: {
+        readonly providerSubscriptionId: string;
+        readonly targetPriceId: string;
+        readonly tenantId: string;
+        readonly consentId?: string;
+    }) => Promise<void>;
     /**
      * Fetches the live provider-side state of one subscription, for the
      * `sync-subscriptions` backfill job — catches drift (e.g. a `cancel_at`
@@ -241,6 +261,17 @@ export type SubscriptionProviderPlugin = {
      */
     readonly retrieveSubscription?: (ctx: HandlerContext, providerSubscriptionId: string) => Promise<ProviderSubscriptionSnapshot | null>;
 };
+export type PlanSwitchPreview = {
+    /** Charged immediately, smallest currency unit, tax included. */
+    readonly amountDueNow: number;
+    /** Tax part of `amountDueNow`; null when the provider reports none. */
+    readonly tax: number | null;
+    /** Lower-case ISO currency code. */
+    readonly currency: string;
+    /** Credit for the unused time on the old plan, smallest currency unit. */
+    readonly credit: number;
+    readonly effectiveAt: string;
+};
 export type ProviderSubscriptionSnapshot = {
     readonly providerCustomerId: string;
     readonly providerSubscriptionId: string;
@@ -296,7 +327,8 @@ export type BillingPlanCatalog<TTier extends string = string> = {
      *  `baseUrl` itself when unset) and by `switch-plan` after a plan switch
      *  (defaults to `successPath` there instead). */
     readonly returnPath?: string;
-    /** Defaults to the only registered provider exposing `priceToTier`. */
+    /** Restricts the catalog to one provider; defaults to every registered
+     *  provider exposing `priceToTier`. */
     readonly providerName?: string;
     /** Rendered as the last card, no price, visible to `viewRoles` regardless of `purchaseRoles`. */
     readonly contact?: BillingPlanContactCard;
@@ -319,6 +351,14 @@ export type ConsumerProtectionOptions = {
     readonly termsTextBlock: string;
     /** Per-locale VAT note; must carry at least `de` and `en`. */
     readonly vatNote: Readonly<Record<string, string>>;
+    /** Per-provider texts keyed by provider name, e.g. for a merchant-of-record
+     *  provider that issues the invoice and VAT itself. `vatNote` here replaces
+     *  the global one in that provider's confirmation mail; `checkoutNote` is
+     *  shown under the provider choice. de and en are required for each text. */
+    readonly providerTexts?: Readonly<Record<string, {
+        readonly vatNote?: Readonly<Record<string, string>>;
+        readonly checkoutNote?: Readonly<Record<string, string>>;
+    }>>;
     readonly operatorEmail: string;
     /** Where the public § 312k declaration is reachable. `"tenant-host"`
      *  (default): on a host that resolves a tenant. `"platform"`: also on a
@@ -372,6 +412,15 @@ export type BillingPlanView = {
     readonly isCurrent: boolean;
     readonly action: BillingPlanAction;
 };
+export type BillingProviderView = {
+    readonly name: string;
+    readonly displayName: string;
+    readonly note?: Readonly<Record<string, string>>;
+    readonly plans: readonly BillingPlanView[];
+};
+export declare function canSwitchPlansInApp(plugin: SubscriptionProviderPlugin): boolean;
+/** A provider switches plans via a hosted session or via in-app preview + apply. */
+export declare function canSwitchPlans(plugin: SubscriptionProviderPlugin | null): boolean;
 export type BillingPlansResult = {
     readonly enabled: boolean;
     readonly currentTier: {
@@ -388,6 +437,13 @@ export type BillingPlansResult = {
     } | null;
     readonly canPurchase: boolean;
     readonly plans: readonly BillingPlanView[];
+    /** Present when more than one provider is offered, or the single offered
+     *  provider has a `providerTexts` checkout note. `plans` above are the first
+     *  entry's plans. */
+    readonly providers?: readonly BillingProviderView[];
+    /** True when the subscription's provider switches plans in-app (preview +
+     *  confirm) instead of on a hosted page. */
+    readonly inAppPlanSwitch?: true;
     /** Present only when `catalog.contact` is configured. */
     readonly contact?: BillingPlanContactCard;
     /** Present only when `consumerProtection` is configured. */

package/dist/billing-foundation/types.js

@@ -33,3 +33,12 @@ export const KNOWN_RECURRING_INTERVALS = ["day", "week", "month", "year"];
 export function isLegalLinkSet(links) {
     return "terms" in links;
 }
+export function canSwitchPlansInApp(plugin) {
+    return plugin.previewPlanSwitch !== undefined && plugin.applyPlanSwitch !== undefined;
+}
+/** A provider switches plans via a hosted session or via in-app preview + apply. */
+export function canSwitchPlans(plugin) {
+    if (plugin === null)
+        return false;
+    return plugin.createPlanSwitchSession !== undefined || canSwitchPlansInApp(plugin);
+}

package/dist/billing-foundation/validate-options.js

@@ -20,6 +20,22 @@ function isRootRelativeOrHttpsUrl(link) {
         return false;
     }
 }
+function validateProviderTexts(cp) {
+    for (const [providerName, texts] of Object.entries(cp.providerTexts ?? {})) {
+        for (const [textName, text] of [
+            ["vatNote", texts.vatNote],
+            ["checkoutNote", texts.checkoutNote],
+        ]) {
+            if (text === undefined)
+                continue;
+            for (const locale of ["de", "en"]) {
+                if (!text[locale]?.trim()) {
+                    throw new Error(`createBillingFoundationFeature: consumerProtection.providerTexts.${providerName}.${textName} needs a non-empty "${locale}" entry.`);
+                }
+            }
+        }
+    }
+}
 function validateConsumerProtection(cp) {
     if (cp.termsTextBlock.trim() === "") {
         throw new Error("createBillingFoundationFeature: consumerProtection.termsTextBlock is empty.");
@@ -29,6 +45,7 @@ function validateConsumerProtection(cp) {
             throw new Error(`createBillingFoundationFeature: consumerProtection.vatNote needs a non-empty "${locale}" entry.`);
         }
     }
+    validateProviderTexts(cp);
     if (!z.email().safeParse(cp.operatorEmail).success) {
         throw new Error(`createBillingFoundationFeature: consumerProtection.operatorEmail "${cp.operatorEmail}" is not a valid email address.`);
     }

package/dist/billing-foundation/web/billing-plans-panel.js

@@ -7,21 +7,10 @@ import { BillingContactPlan } from "./billing-contact-plan.js";
 import { CancelContractDialog } from "./cancel-contract-dialog.js";
 import { CheckoutConsentDialog } from "./checkout-consent-dialog.js";
 import { BillingPlanActions, SubscriptionFoundationHandlers, SubscriptionFoundationQueries, SubscriptionStatuses, } from "./constants.js";
+import { resolveConsentLocale } from "./consumer-protection/consent-locale.js";
 import { localizedParams } from "./localized-params.js";
-function intervalKey(price) {
-    if (price === null || price.interval === null)
-        return undefined;
-    return price.intervalCount !== null && price.intervalCount > 1
-        ? `billing-foundation.plans.everyInterval.${price.interval}`
-        : `billing-foundation.plans.perInterval.${price.interval}`;
-}
-function renewalKey(price) {
-    if (price === null || price.interval === null)
-        return undefined;
-    return price.intervalCount !== null && price.intervalCount > 1
-        ? `billing-foundation.consent.renewsEvery.${price.interval}`
-        : `billing-foundation.consent.renews.${price.interval}`;
-}
+import { cheapestPrice, intervalKey, pricesDiffer, renewalKey, tierPrices } from "./plan-price.js";
+import { PlanSwitchConfirmDialog } from "./plan-switch-confirm-dialog.js";
 /** Which action the plan "would" offer if it weren't blocked — mirrors
  *  plan-catalog.ts's own decision tree, since `unavailable` collapses both
  *  "would checkout" and "would switch" into one action and the disabled CTA
@@ -86,8 +75,20 @@ export function BillingPlansPanel(_props) {
     const [redirecting, setRedirecting] = useState(false);
     const [consentTier, setConsentTier] = useState(null);
     const [cancelOpen, setCancelOpen] = useState(false);
+    const [chosenProvider, setChosenProvider] = useState(null);
+    const [switchTier, setSwitchTier] = useState(null);
+    const [switchRequested, setSwitchRequested] = useState(false);
+    // Only present when the tenant can choose (several offered providers) or
+    // the single offered provider has a note; absent means the server decides.
+    const providers = query.data?.providers;
+    const activeProvider = providers?.find((p) => p.name === chosenProvider) ?? providers?.[0];
+    const providerArg = activeProvider ? { providerName: activeProvider.name } : {};
     async function orderWithConsent(tier, consent) {
-        const result = await checkoutMutation.mutate({ tier, consent });
+        const result = await checkoutMutation.mutate({
+            tier,
+            ...(consent !== undefined && { consent }),
+            ...providerArg,
+        });
         if (result.isSuccess) {
             setRedirecting(true);
             window.location.assign(result.data.url);
@@ -95,13 +96,20 @@ export function BillingPlansPanel(_props) {
         return result;
     }
     async function handleAction(tier, kind) {
-        if (kind === "checkout" && query.data?.consumerProtection !== undefined) {
+        if (kind === "checkout" &&
+            (query.data?.consumerProtection !== undefined || (providers?.length ?? 0) > 1)) {
+            setChosenProvider(null);
             setConsentTier(tier);
             return;
         }
+        if (kind === "switch" && query.data?.inAppPlanSwitch) {
+            setSwitchTier(tier);
+            return;
+        }
         setRedirecting(true);
-        const mutation = kind === "checkout" ? checkoutMutation : switchMutation;
-        const result = await mutation.mutate({ tier });
+        const result = kind === "checkout"
+            ? await checkoutMutation.mutate({ tier, ...providerArg })
+            : await switchMutation.mutate({ tier });
         if (result.isSuccess) {
             window.location.assign(result.data.url);
         }
@@ -128,13 +136,19 @@ export function BillingPlansPanel(_props) {
     if (!query.data)
         return null;
     const result = query.data;
+    // Cards show the first provider's price; the dialog then follows the chosen one.
+    const shownPlans = providers?.[0]?.plans ?? result.plans;
+    const dialogPlans = activeProvider?.plans ?? result.plans;
     // The consent dialog shows the checkout error itself.
     const mutationError = (consentTier === null ? checkoutMutation.error : null) ??
         switchMutation.error ??
         portalMutation.error;
     const canManage = result.subscription !== null && !result.subscription.terminal && result.canPurchase;
     function toCardProps(plan) {
-        const key = intervalKey(plan.price);
+        const comparable = providers !== undefined && providers.length > 1 ? tierPrices(providers, plan.tier) : [];
+        const fromPrice = pricesDiffer(comparable) ? cheapestPrice(comparable) : undefined;
+        const shownPrice = fromPrice ?? plan.price;
+        const key = intervalKey(shownPrice);
         return {
             title: t(plan.labelKey),
             description: plan.action === BillingPlanActions.paymentPending
@@ -147,13 +161,14 @@ export function BillingPlansPanel(_props) {
             // provider lookup failure.
             price: !result.enabled && plan.isCurrent
                 ? undefined
-                : plan.price === null
+                : shownPrice === null
                     ? null
                     : {
-                        amount: formatMoney(plan.price.unitAmount, plan.price.currency, locale),
+                        amount: formatMoney(shownPrice.unitAmount, shownPrice.currency, locale),
+                        ...(fromPrice !== undefined && { prefix: t("billing-foundation.plans.priceFrom") }),
                         ...(key !== undefined && {
                             period: t(key, {
-                                count: new Intl.NumberFormat(locale).format(plan.price.intervalCount ?? 1),
+                                count: new Intl.NumberFormat(locale).format(shownPrice.intervalCount ?? 1),
                             }),
                         }),
                     },
@@ -168,26 +183,57 @@ export function BillingPlansPanel(_props) {
     // (a legacy/free/pilot tier outside `catalog.plans`) — when none of the
     // rendered plans is the current one, a synthetic current-tier card (no
     // price, no cta) keeps it visible regardless of enabled/disabled.
-    const consentPlan = consentTier !== null ? result.plans.find((plan) => plan.tier === consentTier) : undefined;
+    const consentPlan = consentTier !== null ? dialogPlans.find((plan) => plan.tier === consentTier) : undefined;
+    const switchPlan = switchTier !== null ? shownPlans.find((plan) => plan.tier === switchTier) : undefined;
     const consumerProtection = result.consumerProtection;
-    const currentTierInPlans = result.plans.some((plan) => plan.isCurrent);
-    const visiblePlans = result.enabled
-        ? result.plans
-        : result.plans.filter((plan) => plan.isCurrent);
-    return (_jsxs("div", { className: "flex flex-col gap-4", "data-testid": "billing-plans-panel", children: [!result.enabled && (_jsx(Banner, { variant: "info", testId: "billing-plans-panel-disabled", children: t("billing-foundation.plans.billingDisabled") })), !result.canPurchase && (_jsx(Banner, { variant: "warning", testId: "billing-plans-panel-readonly", children: t("billing-foundation.plans.purchaseNotAllowed") })), mutationError !== null && (_jsx(Banner, { variant: "error", testId: "billing-plans-panel-mutation-error", children: t(mutationError.i18nKey, mutationError.i18nParams) })), result.subscription?.status === SubscriptionStatuses.pastDue && (_jsx(Banner, { variant: "warning", testId: "billing-plans-panel-past-due", children: t("billing-foundation.plans.pastDue") })), result.subscription !== null &&
+    const noteLocale = resolveConsentLocale(locale);
+    const noteOf = (provider) => provider.note?.[noteLocale] ?? provider.note?.["en"];
+    const singleProviderNote = providers !== undefined && providers.length === 1 && providers[0] !== undefined
+        ? noteOf(providers[0])
+        : undefined;
+    function providerChoiceFor(tier) {
+        if (providers === undefined || providers.length < 2 || activeProvider === undefined) {
+            return undefined;
+        }
+        const prices = tierPrices(providers, tier);
+        const showPrices = pricesDiffer(prices);
+        return {
+            value: activeProvider.name,
+            onChange: setChosenProvider,
+            options: providers.map((provider) => {
+                const price = provider.plans.find((plan) => plan.tier === tier)?.price;
+                const note = noteOf(provider);
+                return {
+                    value: provider.name,
+                    title: provider.displayName,
+                    ...(note !== undefined && { description: note }),
+                    ...(showPrices &&
+                        price && { aside: formatMoney(price.unitAmount, price.currency, locale) }),
+                };
+            }),
+        };
+    }
+    const currentTierInPlans = shownPlans.some((plan) => plan.isCurrent);
+    const visiblePlans = result.enabled ? shownPlans : shownPlans.filter((plan) => plan.isCurrent);
+    return (_jsxs("div", { className: "flex flex-col gap-4", "data-testid": "billing-plans-panel", children: [!result.enabled && (_jsx(Banner, { variant: "info", testId: "billing-plans-panel-disabled", children: t("billing-foundation.plans.billingDisabled") })), !result.canPurchase && (_jsx(Banner, { variant: "warning", testId: "billing-plans-panel-readonly", children: t("billing-foundation.plans.purchaseNotAllowed") })), switchRequested && (_jsx(Banner, { variant: "info", testId: "billing-plans-panel-switch-requested", children: t("billing-foundation.plans.planSwitchRequested") })), mutationError !== null && (_jsx(Banner, { variant: "error", testId: "billing-plans-panel-mutation-error", children: t(mutationError.i18nKey, mutationError.i18nParams) })), result.subscription?.status === SubscriptionStatuses.pastDue && (_jsx(Banner, { variant: "warning", testId: "billing-plans-panel-past-due", children: t("billing-foundation.plans.pastDue") })), result.subscription !== null &&
                 !result.subscription.terminal &&
                 result.subscription.cancelAt != null && (_jsxs(Banner, { variant: "info", testId: "billing-plans-panel-cancel-scheduled", children: [t("billing-foundation.plans.cancelScheduled", {
                         date: toInstant(result.subscription.cancelAt).toLocaleString(locale, {
                             dateStyle: "medium",
                         }),
-                    }), " ", t("billing-foundation.plans.switchRequiresReactivation")] })), consumerProtection !== undefined && canManage && result.subscription?.cancelAt == null && (_jsx("div", { children: _jsx(Button, { variant: "secondary", onClick: () => setCancelOpen(true), testId: "billing-plans-cancel-contract", children: t("billing-foundation.cancel.open") }) })), _jsxs(PlanGrid, { testId: "billing-plans-grid", children: [!currentTierInPlans && (_jsx(PlanCard, { title: t(result.currentTier.labelKey), current: true, testId: "billing-plan-card-current", features: result.currentTier.benefits.map((benefit) => t(benefit.labelKey, localizedParams(benefit.params, locale))), secondaryAction: manageOrReactivateAction(canManage, result.subscription, t, handleManage, redirecting) })), visiblePlans.map((plan) => (_jsx(PlanCard, { testId: `billing-plan-card-${plan.tier}`, ...toCardProps(plan) }, plan.tier))), result.contact !== undefined && _jsx(BillingContactPlan, { contact: result.contact })] }), consumerProtection !== undefined &&
-                consentPlan !== undefined &&
-                consentPlan.price !== null && (_jsx(CheckoutConsentDialog, { open: true, onOpenChange: (open) => {
+                    }), " ", t("billing-foundation.plans.switchRequiresReactivation")] })), consumerProtection !== undefined && canManage && result.subscription?.cancelAt == null && (_jsx("div", { children: _jsx(Button, { variant: "secondary", onClick: () => setCancelOpen(true), testId: "billing-plans-cancel-contract", children: t("billing-foundation.cancel.open") }) })), _jsxs(PlanGrid, { testId: "billing-plans-grid", children: [!currentTierInPlans && (_jsx(PlanCard, { title: t(result.currentTier.labelKey), current: true, testId: "billing-plan-card-current", features: result.currentTier.benefits.map((benefit) => t(benefit.labelKey, localizedParams(benefit.params, locale))), secondaryAction: manageOrReactivateAction(canManage, result.subscription, t, handleManage, redirecting) })), visiblePlans.map((plan) => (_jsx(PlanCard, { testId: `billing-plan-card-${plan.tier}`, ...toCardProps(plan) }, plan.tier))), result.contact !== undefined && _jsx(BillingContactPlan, { contact: result.contact })] }), consentPlan !== undefined && consentPlan.price !== null && (_jsx(CheckoutConsentDialog, { open: true, onOpenChange: (open) => {
                     if (!open)
                         setConsentTier(null);
                 }, planName: t(consentPlan.labelKey), price: {
                     amount: formatMoney(consentPlan.price.unitAmount, consentPlan.price.currency, locale),
                     renewalKey: renewalKey(consentPlan.price),
                     count: new Intl.NumberFormat(locale).format(consentPlan.price.intervalCount ?? 1),
-                }, consumerProtection: consumerProtection, onOrder: (consent) => orderWithConsent(consentPlan.tier, consent), onConsentTextOutdated: () => void query.refetch() })), consumerProtection !== undefined && canManage && (_jsx(CancelContractDialog, { open: cancelOpen, onOpenChange: setCancelOpen, onTerminated: () => void query.refetch() }))] }));
+                }, consumerProtection: consumerProtection, providerChoice: providerChoiceFor(consentPlan.tier), note: singleProviderNote, onOrder: (consent) => orderWithConsent(consentPlan.tier, consent), onConsentTextOutdated: () => void query.refetch() })), switchPlan !== undefined && (_jsx(PlanSwitchConfirmDialog, { open: true, onOpenChange: (open) => {
+                    if (!open)
+                        setSwitchTier(null);
+                }, tier: switchPlan.tier, fromPlanName: t(result.currentTier.labelKey), toPlanName: t(switchPlan.labelKey), consumerProtection: consumerProtection, onApplied: () => {
+                    setSwitchTier(null);
+                    setSwitchRequested(true);
+                    void query.refetch();
+                }, onConsentTextOutdated: () => void query.refetch() })), consumerProtection !== undefined && canManage && (_jsx(CancelContractDialog, { open: cancelOpen, onOpenChange: setCancelOpen, onTerminated: () => void query.refetch() }))] }));
 }

package/dist/billing-foundation/web/checkout-consent-dialog.d.ts

@@ -18,11 +18,25 @@ export type CheckoutConsentDialogProps = {
         readonly renewalKey?: string;
         readonly count?: string;
     };
-    readonly consumerProtection: ConsumerProtectionView;
-    readonly onOrder: (consent: CheckoutConsentPayload) => Promise<WriteResult<{
+    /** Without it the dialog shows no legal links and no consent checkboxes and orders without a consent. */
+    readonly consumerProtection?: ConsumerProtectionView;
+    /** Several providers to pick from; the parent follows `value` for price and order. */
+    readonly providerChoice?: {
+        readonly options: readonly {
+            readonly value: string;
+            readonly title: string;
+            readonly description?: string;
+            readonly aside?: string;
+        }[];
+        readonly value: string;
+        readonly onChange: (value: string) => void;
+    };
+    /** Provider note under the price line when there is no provider choice. */
+    readonly note?: string;
+    readonly onOrder: (consent: CheckoutConsentPayload | undefined) => Promise<WriteResult<{
         url: string;
     }>>;
     readonly onConsentTextOutdated: () => void;
 };
-export declare function CheckoutConsentDialog({ open, onOpenChange, planName, price, consumerProtection, onOrder, onConsentTextOutdated, }: CheckoutConsentDialogProps): ReactNode;
+export declare function CheckoutConsentDialog({ open, onOpenChange, planName, price, consumerProtection, providerChoice, note, onOrder, onConsentTextOutdated, }: CheckoutConsentDialogProps): ReactNode;
 export {};

package/dist/billing-foundation/web/checkout-consent-dialog.js

@@ -1,10 +1,11 @@
 import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { useLocale, usePrimitives, useTranslation } from "@cosmicdrift/kumiko-renderer";
+import { ChoiceCards } from "@cosmicdrift/kumiko-renderer/web";
 import { useState } from "react";
 import { resolveConsentLocale } from "./consumer-protection/consent-locale.js";
 export const CONSENT_TEXT_OUTDATED_CODE = "consent_text_outdated";
 // kumiko-lint-ignore no-custom-primitives Uses usePrimitives().Modal internally, name is a billing domain action, not a primitive reimplementation
-export function CheckoutConsentDialog({ open, onOpenChange, planName, price, consumerProtection, onOrder, onConsentTextOutdated, }) {
+export function CheckoutConsentDialog({ open, onOpenChange, planName, price, consumerProtection, providerChoice, note, onOrder, onConsentTextOutdated, }) {
     const t = useTranslation();
     const uiLocale = useLocale().locale();
     const { Modal, Text, Field, Input, Button, Link, Banner } = usePrimitives();
@@ -13,17 +14,20 @@ export function CheckoutConsentDialog({ open, onOpenChange, planName, price, con
     const [submitting, setSubmitting] = useState(false);
     const [errorText, setErrorText] = useState(null);
     const consentLocale = resolveConsentLocale(uiLocale);
-    const texts = consumerProtection.consentTexts[consentLocale];
-    const legalLinks = consumerProtection.legalLinks[consentLocale];
+    const texts = consumerProtection?.consentTexts[consentLocale];
+    const legalLinks = consumerProtection?.legalLinks[consentLocale];
+    const consentGiven = consumerProtection === undefined || (earlyPerformance && withdrawalLoss);
     async function order() {
         setSubmitting(true);
         setErrorText(null);
-        const result = await onOrder({
-            earlyPerformanceRequested: true,
-            withdrawalLossAcknowledged: true,
-            consentTextVersion: texts.consentTextVersion,
-            locale: consentLocale,
-        });
+        const result = await onOrder(texts === undefined
+            ? undefined
+            : {
+                earlyPerformanceRequested: true,
+                withdrawalLossAcknowledged: true,
+                consentTextVersion: texts.consentTextVersion,
+                locale: consentLocale,
+            });
         if (result.isSuccess)
             return;
         setSubmitting(false);
@@ -34,5 +38,5 @@ export function CheckoutConsentDialog({ open, onOpenChange, planName, price, con
             onConsentTextOutdated();
         }
     }
-    return (_jsx(Modal, { open: open, onOpenChange: onOpenChange, title: t("billing-foundation.consent.title"), testId: "checkout-consent-dialog", children: _jsxs("div", { className: "flex flex-col gap-4", children: [_jsxs("div", { className: "flex flex-col gap-1", "data-testid": "checkout-consent-summary", children: [_jsxs(Text, { children: [planName, " \u2014 ", price.amount] }), price.renewalKey !== undefined && (_jsxs(_Fragment, { children: [_jsx(Text, { variant: "muted", children: t(price.renewalKey, price.count !== undefined ? { count: price.count } : undefined) }), _jsx(Text, { variant: "muted", children: t("billing-foundation.consent.cancelAnytime") })] }))] }), _jsxs("div", { className: "flex flex-wrap gap-4", children: [_jsx(Link, { href: legalLinks.terms, target: "_blank", children: t("billing-foundation.consent.link.terms") }), _jsx(Link, { href: legalLinks.withdrawal, target: "_blank", children: t("billing-foundation.consent.link.withdrawal") }), _jsx(Link, { href: legalLinks.privacy, target: "_blank", children: t("billing-foundation.consent.link.privacy") })] }), _jsx(Field, { id: "consent-early-performance", label: texts.earlyPerformance, layout: "inline", children: _jsx(Input, { kind: "boolean", id: "consent-early-performance", name: "consent-early-performance", value: earlyPerformance, onChange: setEarlyPerformance, disabled: submitting }) }), _jsx(Field, { id: "consent-withdrawal-loss", label: texts.withdrawalLoss, layout: "inline", children: _jsx(Input, { kind: "boolean", id: "consent-withdrawal-loss", name: "consent-withdrawal-loss", value: withdrawalLoss, onChange: setWithdrawalLoss, disabled: submitting }) }), errorText !== null && (_jsx(Banner, { variant: "error", testId: "checkout-consent-error", children: errorText })), _jsxs("div", { className: "flex justify-end gap-2", children: [_jsx(Button, { variant: "secondary", disabled: submitting, onClick: () => onOpenChange(false), testId: "checkout-consent-cancel", children: t("billing-foundation.consent.back") }), _jsx(Button, { disabled: !earlyPerformance || !withdrawalLoss || submitting, loading: submitting, onClick: order, testId: "checkout-consent-order", children: t("billing-foundation.consent.order") })] })] }) }));
+    return (_jsx(Modal, { open: open, onOpenChange: onOpenChange, title: t("billing-foundation.consent.title"), testId: "checkout-consent-dialog", children: _jsxs("div", { className: "flex flex-col gap-4", children: [providerChoice !== undefined && (_jsxs("div", { className: "flex flex-col gap-2", children: [_jsx(Text, { variant: "muted", children: t("billing-foundation.consent.chooseProvider") }), _jsx(ChoiceCards, { value: providerChoice.value, options: providerChoice.options, onChange: providerChoice.onChange, ariaLabel: t("billing-foundation.consent.chooseProvider"), testId: "checkout-provider-choice" })] })), _jsxs("div", { className: "flex flex-col gap-1", "data-testid": "checkout-consent-summary", children: [_jsxs(Text, { children: [planName, " \u2014 ", price.amount] }), price.renewalKey !== undefined && (_jsxs(_Fragment, { children: [_jsx(Text, { variant: "muted", children: t(price.renewalKey, price.count !== undefined ? { count: price.count } : undefined) }), _jsx(Text, { variant: "muted", children: t("billing-foundation.consent.cancelAnytime") })] })), note !== undefined && (_jsx(Text, { variant: "muted", testId: "checkout-consent-note", children: note }))] }), legalLinks !== undefined && (_jsxs("div", { className: "flex flex-wrap gap-4", children: [_jsx(Link, { href: legalLinks.terms, target: "_blank", children: t("billing-foundation.consent.link.terms") }), _jsx(Link, { href: legalLinks.withdrawal, target: "_blank", children: t("billing-foundation.consent.link.withdrawal") }), _jsx(Link, { href: legalLinks.privacy, target: "_blank", children: t("billing-foundation.consent.link.privacy") })] })), texts !== undefined && (_jsxs(_Fragment, { children: [_jsx(Field, { id: "consent-early-performance", label: texts.earlyPerformance, layout: "inline", children: _jsx(Input, { kind: "boolean", id: "consent-early-performance", name: "consent-early-performance", value: earlyPerformance, onChange: setEarlyPerformance, disabled: submitting }) }), _jsx(Field, { id: "consent-withdrawal-loss", label: texts.withdrawalLoss, layout: "inline", children: _jsx(Input, { kind: "boolean", id: "consent-withdrawal-loss", name: "consent-withdrawal-loss", value: withdrawalLoss, onChange: setWithdrawalLoss, disabled: submitting }) })] })), errorText !== null && (_jsx(Banner, { variant: "error", testId: "checkout-consent-error", children: errorText })), _jsxs("div", { className: "flex justify-end gap-2", children: [_jsx(Button, { variant: "secondary", disabled: submitting, onClick: () => onOpenChange(false), testId: "checkout-consent-cancel", children: t("billing-foundation.consent.back") }), _jsx(Button, { disabled: !consentGiven || submitting, loading: submitting, onClick: order, testId: "checkout-consent-order", children: t("billing-foundation.consent.order") })] })] }) }));
 }

package/dist/billing-foundation/web/constants.d.ts

@@ -78,6 +78,10 @@ export declare const SubscriptionFoundationQueries: {
      *  current tier and per-plan action. Only registered when a `catalog` is
      *  configured. */
     readonly billingPlans: "billing-foundation:query:billing-plans";
+    /** What switching to a tier would cost right now, for providers that switch
+     *  plans in-app (preview + apply). Only registered when a `catalog` is
+     *  configured. */
+    readonly planSwitchPreview: "billing-foundation:query:plan-switch-preview";
     /** System-only probe: does the caller tenant hold a non-terminal
      *  subscription (consumerProtection only). */
     readonly terminableSubscription: "billing-foundation:query:terminable-subscription";

package/dist/billing-foundation/web/constants.js

@@ -84,6 +84,10 @@ export const SubscriptionFoundationQueries = {
      *  current tier and per-plan action. Only registered when a `catalog` is
      *  configured. */
     billingPlans: "billing-foundation:query:billing-plans",
+    /** What switching to a tier would cost right now, for providers that switch
+     *  plans in-app (preview + apply). Only registered when a `catalog` is
+     *  configured. */
+    planSwitchPreview: "billing-foundation:query:plan-switch-preview",
     /** System-only probe: does the caller tenant hold a non-terminal
      *  subscription (consumerProtection only). */
     terminableSubscription: "billing-foundation:query:terminable-subscription",

package/dist/billing-foundation/web/plan-price.d.ts

@@ -0,0 +1,15 @@
+import type { BillingPlanView } from "../types.ts";
+type Recurrence = {
+    readonly interval: string | null;
+    readonly intervalCount: number | null;
+};
+export declare function intervalKey(price: Recurrence | null): string | undefined;
+export declare function renewalKey(price: Recurrence | null): string | undefined;
+type PlanPrice = NonNullable<BillingPlanView["price"]>;
+export declare function pricesDiffer(prices: readonly PlanPrice[]): boolean;
+/** Price of `tier` at every provider that offers it, in provider order. */
+export declare function tierPrices(providers: readonly {
+    readonly plans: readonly BillingPlanView[];
+}[], tier: string): PlanPrice[];
+export declare function cheapestPrice(prices: readonly PlanPrice[]): PlanPrice | undefined;
+export {};

package/dist/billing-foundation/web/plan-price.js

@@ -0,0 +1,32 @@
+export function intervalKey(price) {
+    if (price === null || price.interval === null)
+        return undefined;
+    return price.intervalCount !== null && price.intervalCount > 1
+        ? `billing-foundation.plans.everyInterval.${price.interval}`
+        : `billing-foundation.plans.perInterval.${price.interval}`;
+}
+export function renewalKey(price) {
+    if (price === null || price.interval === null)
+        return undefined;
+    return price.intervalCount !== null && price.intervalCount > 1
+        ? `billing-foundation.consent.renewsEvery.${price.interval}`
+        : `billing-foundation.consent.renews.${price.interval}`;
+}
+export function pricesDiffer(prices) {
+    const [first, ...rest] = prices;
+    return (first !== undefined &&
+        rest.some((price) => price.unitAmount !== first.unitAmount ||
+            price.currency !== first.currency ||
+            price.interval !== first.interval ||
+            price.intervalCount !== first.intervalCount));
+}
+/** Price of `tier` at every provider that offers it, in provider order. */
+export function tierPrices(providers, tier) {
+    return providers.flatMap((provider) => {
+        const price = provider.plans.find((plan) => plan.tier === tier)?.price;
+        return price ? [price] : [];
+    });
+}
+export function cheapestPrice(prices) {
+    return prices.reduce((lowest, price) => lowest === undefined || price.unitAmount < lowest.unitAmount ? price : lowest, undefined);
+}

package/dist/billing-foundation/web/plan-switch-confirm-dialog.d.ts

@@ -0,0 +1,15 @@
+import { type ReactNode } from "react";
+import type { BillingPlansResult } from "../types.ts";
+type ConsumerProtectionView = NonNullable<BillingPlansResult["consumerProtection"]>;
+export type PlanSwitchConfirmDialogProps = {
+    readonly open: boolean;
+    readonly onOpenChange: (open: boolean) => void;
+    readonly tier: string;
+    readonly fromPlanName: string;
+    readonly toPlanName: string;
+    readonly consumerProtection?: ConsumerProtectionView;
+    readonly onApplied: () => void;
+    readonly onConsentTextOutdated: () => void;
+};
+export declare function PlanSwitchConfirmDialog({ open, onOpenChange, tier, fromPlanName, toPlanName, consumerProtection, onApplied, onConsentTextOutdated, }: PlanSwitchConfirmDialogProps): ReactNode;
+export {};