@eifi1/ui-kit 0.38.1 → 0.39.0

package/src/billing/checkout-processing.ts

@@ -3,6 +3,7 @@ import { useCallback, useEffect, useEffectEvent, useLayoutEffect, useRef, useSyn
 import { toDate } from "../lib/format";
 import type { DateInput } from "../lib/format";
 import { readStored, removeStored, writeStored } from "../lib/safe-storage";
+import type { PaidPrice } from "./billing-overview";
 import type { BillingStanding } from "./billing-standing";
 
 /**
@@ -43,6 +44,9 @@ export type CheckoutOverview = Pick<BillingStanding, "status" | "in_good_standin
   plan: string;
   source: string;
   current_period_end?: DateInput;
+  /** 0.39 (§15.2.10): what the payer pays — a plan switch moves only this under a grant,
+   *  and keeps `active` without one. Left out or null: nothing paid. */
+  paid?: Pick<PaidPrice, "plan" | "interval"> | null;
 };
 
 /** How long a return keeps the page in "processing" before it trusts the overview. */
@@ -53,9 +57,12 @@ const POLL_EVERY = 4_000;
 const STORAGE_KEY = "eifi1-billing-checkout";
 
 /**
- * What of the overview a completed checkout changes, as one string: the plan (read
- * without case, §12.16), the status, the source, the standing and the period's end (read
- * as an instant, so `…Z` and `…+00:00` agree).
+ * What of the overview a completed checkout — or plan switch — changes, as one string:
+ * the plan (read without case, §12.16), the status, the source, the standing, the
+ * period's end (read as an instant, so `…Z` and `…+00:00` agree) and, since 0.39, the
+ * paid plan and period (`paid`, §15.2.10). A switch keeps `active`, and under a grant
+ * the plan too, so only `paid` shows it landed: one storage key serves the checkout and
+ * the switch.
  */
 export function checkoutFingerprint(o: CheckoutOverview): string {
   const end = toDate(o.current_period_end ?? null);
@@ -65,6 +72,8 @@ export function checkoutFingerprint(o: CheckoutOverview): string {
     o.source,
     String(o.in_good_standing),
     end ? end.toISOString() : "",
+    String(o.paid?.plan ?? "").toLowerCase(),
+    o.paid?.interval ?? "",
   ].join("|");
 }
 
@@ -247,6 +256,11 @@ function claimReturn(store: CheckoutStore): boolean {
  * `payer` is the user's or the company's id: a mark never speaks for another payer.
  * `overview` is what the page shows now; left out, the return waits for `active`. Pass
  * the same `storageKey` as the hook's.
+ *
+ * A plan switch (0.39, §15.2.10) is waited for the same way, under the same key: note
+ * the departure before `POST /billing/plan`, and once it answers put the return marker
+ * on the page's URL yourself (`checkoutReturnUrl`'s `?checkout=done`) — the row follows
+ * by webhook, and the fingerprint's `paid` shows it landed.
  */
 export function noteCheckoutStarted(
   payer: string | number,

package/src/billing/pay-page.ts

@@ -1,21 +1,25 @@
 import type { UiKitLabels } from "../i18n/kit-labels";
-import { checkoutReturnUrl } from "./checkout-return";
 
 /**
- * The kit's pay page (docs/billing-harmonization.md §14.4, decision 19 as amended): a
- * standalone static page that ui-kit ships as `dist/pay/`, and that each app serves on
- * its own pay host, `pay.<app domain>` — a separate origin, approved in Paddle, where
- * Paddle.js shares the origin with nothing: no sign-in, no app code, no storage.
+ * The kit's pay page (docs/billing-harmonization.md §14.4, decision 19 as amended by
+ * §15.2): a standalone static page that ui-kit ships as `dist/pay/`, and that each app
+ * serves on its own pay host, `pay.<app domain>` — a separate origin, approved in Paddle,
+ * where Paddle.js shares the origin with nothing: no sign-in, no app code, no storage.
+ * Since 0.39 every pay page serves ANY app's transaction: it names the app from the
+ * transaction's custom data, from the kit's map {@link PAY_PAGE_APPS}, not from its
+ * domain — Paddle's single default payment link reaches one host for all three apps.
  *
  * Paddle's create-transaction answers `checkout.url`: the pay page's URL plus
  * `?_ptxn=<txn>`, and Paddle.js on that page opens the transaction by itself. The app
  * sends the buyer there with {@link payPageUrl}, which adds the buyer's language; the
  * page maps it to Paddle's checkout locale ({@link paddleLocale}). Everything else the
- * page needs — the client-side token, sandbox or live, the way back — is the app's
- * `pay-config.json`, written at its web build by the `eifi1-pay-page` script.
+ * page needs — the client-side token, sandbox or live, the host's app and the map of
+ * apps with their ways back — is the host's `pay-config.json`, written at its web build
+ * by the `eifi1-pay-page` script.
  *
  * Pure, and React-free: the page's own script (`pay-page/pay.ts`) and that build script
- * bundle this module. The exports below the barrel's four are theirs.
+ * bundle this module. The barrel exports the link's parts and the app map ({@link PAY_PAGE_APPS},
+ * {@link PayPageApp}); the exports marked @internal are theirs.
  */
 
 /** Paddle's two environments: the sandbox's client-side tokens start `test_`, live
@@ -138,6 +142,9 @@ export interface PayPageStrings {
   failed: string;
   /** `billing.payBack`: the buyer closed the checkout. */
   closed: string;
+  /** `billing.payDone` (0.39): paid, for a transaction that names no app the page
+   *  knows — there is no way back to offer. */
+  done: string;
   /** `common.back`: the link to the app's subscription page. */
   back: string;
   /** `legal.links.terms` and `legal.links.privacy`: the footer's links. */
@@ -154,6 +161,7 @@ export function payPageStrings(labels: UiKitLabels): PayPageStrings {
     nothing: labels.billing.payNothing,
     failed: labels.billing.payFailed,
     closed: labels.billing.payBack,
+    done: labels.billing.payDone,
     back: labels.common.back,
     terms: labels.legal.links.terms,
     privacy: labels.legal.links.privacy,
@@ -167,7 +175,45 @@ export function payPageStrings(labels: UiKitLabels): PayPageStrings {
 export const PAY_CONFIG_FILE = "pay-config.json";
 
 /**
- * `pay-config.json`: what the page needs that differs per app and deployment. Read by
+ * One app a pay page serves (docs/billing-harmonization.md §15.2.6): its name, the way
+ * back and its Terms and Privacy. Every pay page knows every app, because Paddle's links
+ * — its single default payment link, a payment-method update from its e-mails — reach
+ * whichever page the account names, whatever app the transaction is for.
+ */
+export interface PayPageApp {
+  /** The app's display name: the footer's line and the page's title. */
+  name: string;
+  /** The app's subscription page. Once paid, the page goes to
+   *  `checkoutReturnUrl(returnUrl)`; "Back" goes here. */
+  returnUrl: string;
+  termsUrl: string;
+  privacyUrl: string;
+}
+
+/** An app's tag: server-kit's `billing_app` pattern, the key of {@link PAY_PAGE_APPS}
+ *  and the `app` of a transaction's custom data (§14.3). */
+const APP_TAG = /^[a-z][a-z0-9_-]{0,63}$/;
+
+/** An app on its site: the name, the Terms and Privacy at `/terms` and `/privacy`, and
+ *  its subscription page. */
+function appAt(name: string, site: string, returnPath: string): PayPageApp {
+  return { name, returnUrl: `${site}${returnPath}`, termsUrl: `${site}/terms`, privacyUrl: `${site}/privacy` };
+}
+
+/**
+ * The apps the kit's pay pages serve, by their `billing_app` tag (§15.2.6) — one source,
+ * so the three pay hosts can't drift. A new app, or a page that moves, is a kit release.
+ * The bin writes it into `pay-config.json`; `--app-url` moves the host's own app to
+ * another site (a local stack, a dev deploy) and `--apps <file>` merges a map over it.
+ */
+export const PAY_PAGE_APPS: Readonly<Record<string, Readonly<PayPageApp>>> = Object.freeze({
+  keksdose: Object.freeze(appAt("Keksdose", "https://keksdose.app", "/settings/subscription")),
+  kastlan: Object.freeze(appAt("kastlan", "https://kastlan.app", "/admin/billing")),
+  kurvenschmiede: Object.freeze(appAt("Kurvenschmiede", "https://kurvenschmiede.app", "/settings/subscription")),
+});
+
+/**
+ * `pay-config.json`: what the page needs that differs per deployment (§15.2.6). Read by
  * the page from its own origin — never from the query, where Paddle's own links (it
  * puts only `_ptxn` there) would lack it and a return URL would be an open redirect on
  * an approved payment domain. @internal
@@ -177,19 +223,19 @@ export interface PayPageConfig {
    *  while billing is off, and the page says `payNothing`. */
   token: string | null;
   environment: PaddleEnvironment | null;
-  /** The app's subscription page. Paddle.js's `successUrl` is
-   *  `checkoutReturnUrl(returnUrl)`; "Back" goes here. */
-  returnUrl: string;
-  appName: string;
-  termsUrl: string;
-  privacyUrl: string;
+  /** The host's own app, a key of `apps`: the page shows it until the checkout loads,
+   *  and its Terms and Privacy stay for a transaction that names no app. */
+  app: string;
+  /** Every app the page serves, by tag. The transaction's `custom_data.app` picks one;
+   *  a return URL only ever comes from here. */
+  apps: Record<string, PayPageApp>;
 }
 
 /** Paddle's client-side token prefixes, per environment. */
 const TOKEN_PREFIX: Readonly<Record<PaddleEnvironment, string>> = { sandbox: "test_", live: "live_" };
 
-/** `https://`, or `http://` on this machine only (`localhost`, `127.0.0.1`, `[::1]`). */
-function isPageUrl(value: unknown): boolean {
+/** `https://`, or `http://` on this machine only (`localhost`, `127.0.0.1`, `[::1]`). @internal */
+export function isPayPageUrl(value: unknown): boolean {
   if (typeof value !== "string") return false;
   let url: URL;
   try {
@@ -201,6 +247,37 @@ function isPageUrl(value: unknown): boolean {
   return url.protocol === "http:" && ["localhost", "127.0.0.1", "[::1]"].includes(url.hostname);
 }
 
+/** Whether `tag` is a tag of `apps`, its own key — never `__proto__` or `constructor`. */
+function hasApp(apps: unknown, tag: unknown): tag is string {
+  return (
+    typeof tag === "string" &&
+    APP_TAG.test(tag) &&
+    typeof apps === "object" &&
+    apps !== null &&
+    Object.prototype.hasOwnProperty.call(apps, tag)
+  );
+}
+
+/**
+ * The app a transaction's custom data names (`custom_data.app`, §14.3), from the page's
+ * map — or undefined for none, or a tag the map doesn't know. @internal
+ */
+export function payPageAppFor(config: Pick<PayPageConfig, "apps">, tag: unknown): PayPageApp | undefined {
+  return hasApp(config.apps, tag) ? config.apps[tag] : undefined;
+}
+
+/** The problems of one app of the map. */
+function appProblems(tag: string, app: unknown): string[] {
+  if (typeof app !== "object" || app === null) return [`apps.${tag} is not an object`];
+  const a = app as Record<string, unknown>;
+  const problems: string[] = [];
+  if (typeof a.name !== "string" || a.name.trim() === "") problems.push(`apps.${tag}.name is missing`);
+  for (const key of ["returnUrl", "termsUrl", "privacyUrl"] as const) {
+    if (!isPayPageUrl(a[key])) problems.push(`apps.${tag}.${key} must be an https:// URL (http:// for localhost only)`);
+  }
+  return problems;
+}
+
 /**
  * What is wrong with a `pay-config.json`, one line each — `[]` when nothing is. The
  * build script refuses to write a file with any (so a wrong pairing fails the build,
@@ -208,8 +285,10 @@ function isPageUrl(value: unknown): boolean {
  *
  * - a token whose prefix disagrees with the environment (`test_` ↔ sandbox, `live_` ↔
  *   live), or a token without an environment;
- * - a return, terms or privacy URL that isn't `https://` (`http://` for localhost only);
- * - no app name. @internal
+ * - an app tag that isn't a `billing_app` tag (`^[a-z][a-z0-9_-]{0,63}$`), an app
+ *   without a name, or a return, terms or privacy URL that isn't `https://` (`http://`
+ *   for localhost only);
+ * - no `app`, or one that isn't in `apps`. @internal
  */
 export function payPageConfigProblems(config: unknown): string[] {
   if (typeof config !== "object" || config === null) return ["the configuration is not an object"];
@@ -233,14 +312,19 @@ export function payPageConfigProblems(config: unknown): string[] {
       );
     }
   }
-  for (const key of ["returnUrl", "termsUrl", "privacyUrl"] as const) {
-    if (!isPageUrl(c[key])) problems.push(`${key} must be an https:// URL (http:// for localhost only)`);
+  const { apps, app } = c;
+  if (typeof apps !== "object" || apps === null || Array.isArray(apps) || Object.keys(apps).length === 0) {
+    problems.push("apps must map each app's tag to its name and URLs");
+  } else {
+    for (const [tag, entry] of Object.entries(apps)) {
+      if (!APP_TAG.test(tag)) problems.push(`apps: ${JSON.stringify(tag)} is not an app tag (a-z, 0-9, _ and -)`);
+      else problems.push(...appProblems(tag, entry));
+    }
+  }
+  if (typeof app !== "string" || app === "") problems.push("app is missing: the host's own app tag");
+  else if (!hasApp(apps, app)) {
+    const known = typeof apps === "object" && apps !== null ? Object.keys(apps).join(", ") : "";
+    problems.push(`app ${JSON.stringify(app)} is not in apps${known ? ` (${known})` : ""}`);
   }
-  if (typeof c.appName !== "string" || c.appName.trim() === "") problems.push("appName is missing");
   return problems;
 }
-
-/** Paddle.js's `successUrl` for a configuration: the way back, `?checkout=done`. @internal */
-export function paySuccessUrl(config: Pick<PayPageConfig, "returnUrl">): string {
-  return checkoutReturnUrl(config.returnUrl);
-}

package/src/billing/plan-switch.tsx

@@ -0,0 +1,201 @@
+import type { KeyboardEvent } from "react";
+
+import { useKitLabels, useKitLocale } from "../i18n/kit-labels";
+import type { LabelOverride } from "../i18n/kit-labels";
+import { DEFAULT_COMMON_LABELS } from "../i18n/shared-labels";
+import { pluralForm } from "../i18n/plurals";
+import type { PluralForms } from "../i18n/plurals";
+import { formatDate, formatMoney, formatNumber } from "../lib/format";
+import { Button } from "../components/button";
+import { DialogFrame } from "../components/dialog-frame";
+import { Spinner } from "../components/spinner";
+import { COMMIT_EXCEPT_BILLING } from "../components/write-lock";
+import { DEFAULT_PLAN_CHANGE_LABELS } from "../admin/plan-change-labels";
+import { useBillingLabels } from "./billing-labels";
+import type { BillingLabels } from "./billing-labels";
+import type { PlanSwitchPreview } from "./billing-overview";
+import { minorToMajor } from "./plan-price";
+import type { BillingInterval } from "./plan-price";
+
+/**
+ * The payer's plan switch (docs/billing-harmonization.md §15.2.10, ui-kit 0.39): built
+ * once in the kits and used by all three apps, instead of Paddle's portal. While a
+ * provider subscription runs, the app sends a `PlanPicker` pick to
+ * `POST /billing/plan/preview` and opens this dialog with the answer; Confirm is the
+ * app's `POST /billing/plan`. Otherwise the pick goes to the checkout, as before.
+ *
+ * The switch is immediate and prorated: an upgrade charges the difference now, a
+ * downgrade credits the unused part to the customer's balance, which Paddle takes off
+ * the next charges. So the payer agrees to a figure — Paddle's preview — and sees the
+ * dimensions over the new plan's limit before agreeing (§3.4: a limit gates creation
+ * only, so the switch is allowed).
+ */
+
+/** One side of a switch: a plan code and its billing period. */
+export interface PlanSwitchSide {
+  plan: string;
+  interval: BillingInterval;
+}
+
+export interface PlanSwitchConfirmProps {
+  open: boolean;
+  /** `false` when the payer dismisses it — Cancel, Escape, the backdrop. Confirm leaves
+   *  it open: close it once the switch answers. */
+  onOpenChange: (open: boolean) => void;
+  /** What the payer pays now: the overview's `paid`. */
+  from: PlanSwitchSide;
+  /** The pick. */
+  to: PlanSwitchSide;
+  /** `POST /billing/plan/preview`'s answer. Undefined while it loads: a spinner, and
+   *  Confirm is held. */
+  preview?: PlanSwitchPreview;
+  /** `POST /billing/plan` is under way: Confirm's spinner, no second press, and Escape
+   *  doesn't close. */
+  pending?: boolean;
+  /** The plan's display name, the app's (§3.1). Default: the code. */
+  planName?: (code: string) => string;
+  /**
+   * The app's word per dimension, for the over-limit lines. A heading's word ("Budgets")
+   * reads "Budgets: 7 of 5" (`billing.limitUsageLine`); its plural forms
+   * (`{ one: "budget", other: "budgets" }`) read "7 of 5 budgets" (`planChange.usageOf`,
+   * the form the limit takes). A dimension without one is named by its key.
+   */
+  dimensionLabels?: Readonly<Record<string, string | PluralForms>>;
+  /** How a usage or limit figure is written. Default: a number in the locale. */
+  formatLimit?: (dimension: string, value: number) => string;
+  /** Confirm: the app's `POST /billing/plan` with `{plan, interval}` of `to`. */
+  onConfirm: () => void;
+  /** The figures' and the date's locale. Default: the provider's. */
+  locale?: string;
+  /** Prop > `<UiKitProvider labels={{ billing }}>` > English. */
+  labels?: LabelOverride<BillingLabels>;
+}
+
+/**
+ * The confirm for a plan switch (§15.2.10): from → to, each with its billing period;
+ * Paddle's preview — "Charged now" (an upgrade) or "Credited towards your next charges"
+ * (a downgrade), and the next charge with its date — in the subscription's currency;
+ * the dimensions over the new plan's limit; and Confirm.
+ *
+ *     const preview = useMutation({ mutationFn: api.previewPlanSwitch });
+ *     <PlanSwitchConfirm
+ *       open={pick !== null}
+ *       onOpenChange={(open) => !open && setPick(null)}
+ *       from={overview.paid}
+ *       to={pick}
+ *       preview={preview.data}
+ *       pending={switching.isPending}
+ *       planName={planName}
+ *       onConfirm={() => switching.mutate(pick)}
+ *     />
+ *
+ * It takes no billing lock (`COMMIT_EXCEPT_BILLING` built in): a read-only payer may
+ * change plan, as they may pay. A demo lock still holds it, as the server's demo guard
+ * does. The kit sends no request.
+ */
+export function PlanSwitchConfirm({
+  open,
+  onOpenChange,
+  from,
+  to,
+  preview,
+  pending = false,
+  planName = (code) => code,
+  dimensionLabels,
+  formatLimit,
+  onConfirm,
+  locale: localeProp,
+  labels: labelsProp,
+}: PlanSwitchConfirmProps) {
+  const labels = useBillingLabels(labelsProp);
+  const planChange = useKitLabels("planChange", DEFAULT_PLAN_CHANGE_LABELS);
+  const common = useKitLabels("common", DEFAULT_COMMON_LABELS);
+  const locale = useKitLocale(localeProp);
+
+  const period = (interval: BillingInterval) => (interval === "year" ? labels.yearly : labels.monthly);
+  const side = (s: PlanSwitchSide) => `${planName(s.plan.toLowerCase())} (${period(s.interval)})`;
+  const money = (minor: number, currency: string) =>
+    formatMoney(minorToMajor(minor, currency), currency, { locale });
+  const figure = (dimension: string, value: number) =>
+    formatLimit ? formatLimit(dimension, value) : formatNumber(value, { locale });
+
+  /** One line per dimension over the new limit, in the word's own sentence. */
+  const overLimit = (p: PlanSwitchPreview): string[] =>
+    (p.over_limit ?? []).flatMap((dimension) => {
+      const limit = p.limits?.[dimension];
+      const used = p.usage?.[dimension];
+      if (limit === null || limit === undefined || used === undefined) return [];
+      const word = dimensionLabels?.[dimension] ?? dimension;
+      return [
+        typeof word === "string"
+          ? labels.limitUsageLine(word, figure(dimension, used), figure(dimension, limit))
+          : planChange.usageOf(figure(dimension, used), figure(dimension, limit), pluralForm(limit, word, locale)),
+      ];
+    });
+
+  const credit = preview !== undefined && preview.now_minor < 0;
+  const lines = preview ? overLimit(preview) : [];
+
+  return (
+    <DialogFrame
+      open={open}
+      title={labels.switchTitle}
+      description={labels.switchFromTo(side(from), side(to))}
+      onClose={() => onOpenChange(false)}
+      onKeyDown={(e: KeyboardEvent<HTMLDivElement>) => {
+        if (pending && e.key === "Escape") e.preventDefault();
+      }}
+      aria-busy={preview === undefined || pending || undefined}
+      actions={(close) => (
+        <>
+          <Button variant="secondary" onClick={close} disabled={pending}>
+            {common.cancel}
+          </Button>
+          <Button
+            commit={COMMIT_EXCEPT_BILLING}
+            pending={pending}
+            disabled={preview === undefined}
+            onClick={() => {
+              if (preview !== undefined && !pending) onConfirm();
+            }}
+          >
+            {labels.switchConfirm}
+          </Button>
+        </>
+      )}
+    >
+      {preview === undefined ? (
+        <div className="flex justify-center py-4">
+          <Spinner showLabel />
+        </div>
+      ) : (
+        <>
+          <dl className="grid grid-cols-[minmax(0,1fr)_auto] gap-x-4 gap-y-1 text-sm" data-plan-switch-preview>
+            <dt className="text-secondary">{credit ? labels.switchCredited : labels.switchChargedNow}</dt>
+            <dd className="text-right font-medium tabular-nums" data-now={credit ? "credit" : "charge"}>
+              {money(Math.abs(preview.now_minor), preview.currency)}
+            </dd>
+            {preview.next_billed_at && preview.next_minor != null && (
+              <>
+                <dt className="text-secondary">
+                  {labels.switchNextCharge(formatDate(preview.next_billed_at, "medium", { locale }))}
+                </dt>
+                <dd className="text-right tabular-nums">{money(preview.next_minor, preview.currency)}</dd>
+              </>
+            )}
+          </dl>
+          {lines.length > 0 && (
+            <div className="space-y-1 text-sm" data-plan-switch-over-limit>
+              <p>{planChange.overLimit}</p>
+              <ul className="list-disc space-y-0.5 ps-5 text-secondary">
+                {lines.map((line) => (
+                  <li key={line}>{line}</li>
+                ))}
+              </ul>
+            </div>
+          )}
+        </>
+      )}
+    </DialogFrame>
+  );
+}

package/src/i18n/german.ts

@@ -1749,6 +1749,14 @@ export function germanLabels(numberLocale: string): UiKitLabels {
         "Der Bezahlvorgang konnte nicht geöffnet werden. Bitte kehren Sie zurück und versuchen Sie es gleich noch einmal.",
       payBack:
         "Der Bezahlvorgang wurde geschlossen. Sie können zurückkehren oder diese Seite neu laden, um ihn wieder zu öffnen.",
+      payDone: "Zahlung abgeschlossen. Sie können diese Seite schließen.",
+      // 0.39 (§15.2.10): PlanSwitchConfirm.
+      switchTitle: "Tarif ändern",
+      switchFromTo: (from, to) => `Von ${from} zu ${to}`,
+      switchChargedNow: "Jetzt belastet",
+      switchCredited: "Gutschrift auf die nächsten Belastungen",
+      switchNextCharge: (date) => `Nächste Belastung am ${date}`,
+      switchConfirm: "Tarif ändern",
       waitingChanges: (count) =>
         count === 1
           ? `${n(count)} Änderung wartet auf einen Tarif`
@@ -1760,9 +1768,13 @@ export function germanLabels(numberLocale: string): UiKitLabels {
       // §14.2: server-kit 0.7's refusals. "Zahlung und Rechnungen", as `manage`.
       providerUnavailable:
         "Der Zahlungsanbieter ist gerade nicht erreichbar. Bitte versuchen Sie es gleich noch einmal.",
-      alreadySubscribed: "Sie haben bereits ein Abonnement. Ihren Tarif ändern Sie unter „Zahlung und Rechnungen“.",
+      alreadySubscribed: "Sie haben bereits ein Abonnement. Ändern Sie Ihren Tarif oben.",
       planNotSold:
         "Dieser Tarif ist für diesen Abrechnungszeitraum oder diese Währung nicht erhältlich. Bitte wählen Sie einen anderen.",
+      // 0.39 (§15.2.10): the plan switch's refusals.
+      notSubscribed:
+        "Es läuft kein Abonnement, das sich ändern ließe. Wählen Sie einen Tarif, um eines abzuschließen.",
+      planUnchanged: "Das ist bereits Ihr Tarif. Wählen Sie einen anderen Tarif oder Abrechnungszeitraum.",
     },
     // 0.33.0 — docs/billing-harmonization.md §14.12: the operator's plan parts, "Tarif" as
     // in `billing`; keksdose's reviewed admin wording where it had one.

package/src/i18n/locales/es.ts

@@ -1699,6 +1699,14 @@ export function uiKitLabelsEs(numberLocale = "es-ES"): UiKitLabels {
       payNothing: "Aquí no hay nada que pagar. Para elegir un plan, vuelva a la aplicación.",
       payFailed: "No se ha podido abrir el pago. Vuelva atrás e inténtelo de nuevo en un momento.",
       payBack: "El pago se ha cerrado. Puede volver atrás o recargar esta página para abrirlo de nuevo.",
+      payDone: "Pago completado. Puede cerrar esta página.",
+      // 0.39 (§15.2.10): PlanSwitchConfirm.
+      switchTitle: "Cambiar de plan",
+      switchFromTo: (from, to) => `De ${from} a ${to}`,
+      switchChargedNow: "Cargo ahora",
+      switchCredited: "Abonado a sus próximos cargos",
+      switchNextCharge: (date) => `Próximo cargo el ${date}`,
+      switchConfirm: "Cambiar de plan",
       waitingChanges: (count) => `${n(count)} ${plural(count, "cambio", "cambios")} a la espera de un plan`,
       // "Descartar", as `wizard.cancelConfirmLabel`.
       discardWaiting: "Descartar los cambios en espera",
@@ -1706,8 +1714,11 @@ export function uiKitLabelsEs(numberLocale = "es-ES"): UiKitLabels {
       disabled: "Las suscripciones no están disponibles aquí.",
       // §14.2: server-kit 0.7's refusals. "Pagos y facturas", as `manage`. "Usted".
       providerUnavailable: "El proveedor de pagos no está disponible en este momento. Inténtelo de nuevo en un momento.",
-      alreadySubscribed: "Ya tiene una suscripción. Para cambiar de plan, vaya a «Pagos y facturas».",
+      alreadySubscribed: "Ya tiene una suscripción. Cambie de plan más arriba.",
       planNotSold: "Este plan no está disponible para ese periodo de facturación o esa moneda. Elija otro.",
+      // 0.39 (§15.2.10): the plan switch's refusals.
+      notSubscribed: "No hay ninguna suscripción activa que cambiar. Elija un plan para suscribirse.",
+      planUnchanged: "Ese ya es su plan. Elija otro plan u otro periodo de facturación.",
     },
     // 0.33.0 — docs/billing-harmonization.md §14.12: the operator's plan parts, "plan" as
     // in `billing`. "Usted".

package/src/i18n/locales/fr.ts

@@ -1733,6 +1733,14 @@ export function uiKitLabelsFr(numberLocale = "fr-FR"): UiKitLabels {
       payNothing: "Il n’y a rien à payer ici. Pour choisir une formule, revenez à l’application.",
       payFailed: "Le paiement n’a pas pu s’ouvrir. Veuillez revenir en arrière et réessayer dans un instant.",
       payBack: "Le paiement a été fermé. Vous pouvez revenir en arrière, ou recharger cette page pour le rouvrir.",
+      payDone: "Paiement effectué. Vous pouvez fermer cette page.",
+      // 0.39 (§15.2.10): PlanSwitchConfirm.
+      switchTitle: "Changer de formule",
+      switchFromTo: (from, to) => `De ${from} à ${to}`,
+      switchChargedNow: "Débité maintenant",
+      switchCredited: "Crédité sur vos prochains paiements",
+      switchNextCharge: (date) => `Prochain prélèvement le ${date}`,
+      switchConfirm: "Changer de formule",
       waitingChanges: (count) =>
         `${n(count)} ${plural(count, "modification en attente", "modifications en attente")} d’une formule`,
       // "Abandonner", as `wizard.cancelConfirmLabel`.
@@ -1742,10 +1750,12 @@ export function uiKitLabelsFr(numberLocale = "fr-FR"): UiKitLabels {
       // §14.2: server-kit 0.7's refusals. "Paiement et factures", as `manage`.
       providerUnavailable:
         "Le prestataire de paiement est injoignable pour le moment. Veuillez réessayer dans un instant.",
-      alreadySubscribed:
-        "Vous avez déjà un abonnement. Pour changer de formule, allez dans «\u202fPaiement et factures\u202f».",
+      alreadySubscribed: "Vous avez déjà un abonnement. Changez de formule ci-dessus.",
       planNotSold:
         "Cette formule n’est pas proposée pour cette période de facturation ou cette devise. Veuillez en choisir une autre.",
+      // 0.39 (§15.2.10): the plan switch's refusals.
+      notSubscribed: "Aucun abonnement en cours à modifier. Choisissez une formule pour vous abonner.",
+      planUnchanged: "C’est déjà votre formule. Choisissez une autre formule ou une autre période de facturation.",
     },
     // 0.33.0 — docs/billing-harmonization.md §14.12: the operator's plan parts, "formule"
     // as in `billing`. "Vous".

package/src/i18n/locales/hu.ts

@@ -1702,6 +1702,14 @@ export function uiKitLabelsHu(numberLocale = "hu-HU"): UiKitLabels {
       payNothing: "Itt nincs mit kifizetni. Csomag választásához térjen vissza az alkalmazásba.",
       payFailed: "A fizetést nem sikerült megnyitni. Kérjük, lépjen vissza, és próbálja újra egy kis idő múlva.",
       payBack: "A fizetés bezárult. Visszaléphet, vagy a megnyitásához töltse újra ezt az oldalt.",
+      payDone: "A fizetés sikerült. Bezárhatja ezt az oldalt.",
+      // 0.39 (§15.2.10): PlanSwitchConfirm.
+      switchTitle: "Csomag módosítása",
+      switchFromTo: (from, to) => `${from} helyett ${to}`,
+      switchChargedNow: "Most terhelt összeg",
+      switchCredited: "A következő terhelésekből levonva",
+      switchNextCharge: (date) => `Következő terhelés: ${date}`,
+      switchConfirm: "Csomag módosítása",
       // No plural after a numeral (convention 2).
       waitingChanges: (count) => `${n(count)} módosítás csomagra vár`,
       // "Elvetés", as `wizard.cancelConfirmLabel`.
@@ -1710,9 +1718,12 @@ export function uiKitLabelsHu(numberLocale = "hu-HU"): UiKitLabels {
       disabled: "Az előfizetés itt nem érhető el.",
       // §14.2: server-kit 0.7's refusals. "Fizetés és számlák", as `manage`.
       providerUnavailable: "A fizetési szolgáltató jelenleg nem érhető el. Kérjük, próbálja újra egy kis idő múlva.",
-      alreadySubscribed: "Már van előfizetése. A csomag módosításához nyissa meg a „Fizetés és számlák” részt.",
+      alreadySubscribed: "Már van előfizetése. A csomagot fent módosíthatja.",
       planNotSold:
         "Ez a csomag ehhez a számlázási időszakhoz vagy pénznemhez nem érhető el. Kérjük, válasszon másikat.",
+      // 0.39 (§15.2.10): the plan switch's refusals.
+      notSubscribed: "Nincs futó előfizetés, amelyet módosítani lehetne. Előfizetéshez válasszon egy csomagot.",
+      planUnchanged: "Ez már az Ön csomagja. Válasszon másik csomagot vagy számlázási időszakot.",
     },
     // 0.33.0 — docs/billing-harmonization.md §14.12: the operator's plan parts, "csomag"
     // as in `billing`. A plan's name takes no case ending: it follows a colon or an arrow.

package/src/i18n/locales/it.ts

@@ -1715,6 +1715,14 @@ export function uiKitLabelsIt(numberLocale = "it-IT"): UiKitLabels {
       payNothing: "Qui non c’è nulla da pagare. Per scegliere un piano, torni all’app.",
       payFailed: "Non è stato possibile aprire il pagamento. Torni indietro e riprovi tra un momento.",
       payBack: "Il pagamento è stato chiuso. Può tornare indietro, oppure ricaricare questa pagina per riaprirlo.",
+      payDone: "Pagamento completato. Può chiudere questa pagina.",
+      // 0.39 (§15.2.10): PlanSwitchConfirm.
+      switchTitle: "Cambia piano",
+      switchFromTo: (from, to) => `Da ${from} a ${to}`,
+      switchChargedNow: "Addebitato ora",
+      switchCredited: "Accreditato sui prossimi addebiti",
+      switchNextCharge: (date) => `Prossimo addebito il ${date}`,
+      switchConfirm: "Cambia piano",
       waitingChanges: (count) =>
         `${n(count)} ${plural(count, "modifica in attesa", "modifiche in attesa")} di un piano`,
       // "Scarta", as `wizard.cancelConfirmLabel`.
@@ -1723,9 +1731,12 @@ export function uiKitLabelsIt(numberLocale = "it-IT"): UiKitLabels {
       disabled: "Gli abbonamenti non sono disponibili qui.",
       // §14.2: server-kit 0.7's refusals. "Pagamento e fatture", as `manage`. "Lei".
       providerUnavailable: "Il fornitore dei pagamenti non è raggiungibile al momento. Riprovi tra un momento.",
-      alreadySubscribed: "Ha già un abbonamento. Per cambiare piano, vada su «Pagamento e fatture».",
+      alreadySubscribed: "Ha già un abbonamento. Cambi piano qui sopra.",
       planNotSold:
         "Questo piano non è disponibile per questo periodo di fatturazione o questa valuta. Ne scelga un altro.",
+      // 0.39 (§15.2.10): the plan switch's refusals.
+      notSubscribed: "Non c’è nessun abbonamento attivo da modificare. Scelga un piano per abbonarsi.",
+      planUnchanged: "Questo è già il Suo piano. Scelga un altro piano o un altro periodo di fatturazione.",
     },
     // 0.33.0 — docs/billing-harmonization.md §14.12: the operator's plan parts, "piano" as
     // in `billing`. "Lei" in sentences, the imperative on the title and the button.

package/src/i18n/locales/zh.ts

@@ -1629,6 +1629,14 @@ export function uiKitLabelsZh(numberLocale = "zh-CN"): UiKitLabels {
       payNothing: "这里没有需要支付的款项。如需选择套餐，请返回应用。",
       payFailed: "无法打开支付页面。请返回后稍候再试。",
       payBack: "支付页面已关闭。您可以返回，或重新加载此页面以再次打开。",
+      payDone: "付款已完成。您可以关闭此页面。",
+      // 0.39 (§15.2.10): PlanSwitchConfirm.
+      switchTitle: "更改套餐",
+      switchFromTo: (from, to) => `从 ${from} 更改为 ${to}`,
+      switchChargedNow: "立即扣款",
+      switchCredited: "抵扣后续扣款",
+      switchNextCharge: (date) => `下次扣款日期：${date}`,
+      switchConfirm: "更改套餐",
       waitingChanges: (count) => `${n(count)} 项修改正在等待套餐`,
       // "放弃", as `wizard.cancelConfirmLabel`.
       discardWaiting: "放弃等待中的修改",
@@ -1636,8 +1644,11 @@ export function uiKitLabelsZh(numberLocale = "zh-CN"): UiKitLabels {
       disabled: "此处不提供订阅。",
       // §14.2: server-kit 0.7's refusals. "付款与发票", as `manage`.
       providerUnavailable: "暂时无法连接支付服务商，请稍后再试。",
-      alreadySubscribed: "您已有订阅。如需更改套餐，请前往“付款与发票”。",
+      alreadySubscribed: "您已有订阅。请在上方更改套餐。",
       planNotSold: "该套餐不支持此计费周期或货币，请选择其他套餐。",
+      // 0.39 (§15.2.10): the plan switch's refusals.
+      notSubscribed: "没有可更改的有效订阅。请选择一个套餐进行订阅。",
+      planUnchanged: "这已经是您当前的套餐。请选择其他套餐或计费周期。",
     },
     // 0.33.0 — docs/billing-harmonization.md §14.12: the operator's plan parts, "套餐" as
     // in `billing`. "测试版", as `landing.beta`.

package/src/i18n/review.ts

@@ -390,6 +390,9 @@ export const KIT_LABEL_SAMPLES: Readonly<Record<string, readonly (readonly unkno
   "billing.waitingChanges": one,
   // 0.33.0: the limit's figure line (§14.11) and the operator's plan parts (§14.12).
   "billing.limitUsageLine": [["{{dimension}}", "{{used}}", "{{limit}}"]],
+  // 0.39: PlanSwitchConfirm's two lines with figures (§15.2.10).
+  "billing.switchFromTo": [["{{from}}", "{{to}}"]],
+  "billing.switchNextCharge": [["{{date}}"]],
   "planChange.current": [["{{plan}}"]],
   "planChange.changed": [["{{from}}", "{{to}}"]],
   "planChange.set": [["{{to}}"]],