Files
HiveGrid-Wireframes/03 Quellen und Referenzen/hivegrid-cloud/apps/web/app/routes/subscribe.$tenant.$session.success.ui.test.tsx
T

334 lines
16 KiB
TypeScript

import "@testing-library/jest-dom";
import { act, cleanup, fireEvent, render, screen } from "@testing-library/react";
import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
import { SubscriptionBillingPeriod } from "~/application/enums/subscriptions/SubscriptionBillingPeriod";
import { assertNoA11yViolations } from "~/utils/test/a11y";
const mocks = vi.hoisted(() => ({
loaderData: undefined as unknown,
navigate: vi.fn(),
revalidate: vi.fn(),
}));
vi.mock("~/components/brand/Logo", () => ({ default: ({ to }: { to: string }) => <a href={to}>Logo</a> }));
vi.mock("~/locale/format", () => ({
useLocaleFormatters: () => ({
currency: (amount: number, currency: string) => `${currency} ${amount}`,
date: () => "June 27, 2026",
}),
}));
vi.mock("react-i18next", () => ({
useTranslation: () => ({
t: (key: string, values?: Record<string, unknown>) => {
const translations: Record<string, string> = {
"settings.subscription.checkout.success.paid.title": "Payment successful",
"settings.subscription.checkout.success.paid.description": "Acme Inc. is ready.",
"settings.subscription.checkout.success.paid.badge": "Payment confirmed",
"settings.subscription.checkout.success.paid.status": "Active",
"settings.subscription.checkout.success.paid.priceLabel": "Monthly total incl. VAT",
"settings.subscription.checkout.success.paid.nextBillingLabel": "Next invoice",
"settings.subscription.checkout.success.paid.secureNote": "Payment confirmed securely.",
"settings.subscription.checkout.success.trial.title": "Your trial is running",
"settings.subscription.checkout.success.trial.description": "Acme Inc. can now try HiveGrid.",
"settings.subscription.checkout.success.trial.badge": "Payment method confirmed",
"settings.subscription.checkout.success.trial.status": "Trial active",
"settings.subscription.checkout.success.trial.priceLabel": "Monthly after trial incl. VAT",
"settings.subscription.checkout.success.trial.nextBillingLabel": "First invoice",
"settings.subscription.checkout.success.trial.secureNote": "Nothing is charged before the trial ends.",
"settings.subscription.checkout.success.setupAction": "Set up workspace",
"settings.subscription.checkout.success.stepper.label": "Activation progress",
"settings.subscription.checkout.success.stepper.account": "Account",
"settings.subscription.checkout.success.stepper.payment": "Payment",
"settings.subscription.checkout.success.stepper.setup": "Setup",
"settings.subscription.checkout.success.orderSummary": "Order summary",
"settings.subscription.checkout.success.fields.plan": "Plan",
"settings.subscription.checkout.success.intervals.month": "month",
"settings.subscription.checkout.success.intervals.annualCommitment": "month · 12-month term",
"settings.subscription.checkout.success.goToSubscription": "Go to subscription",
"settings.subscription.checkout.success.emailMarketingFollowUp.title": "Email marketing next",
"settings.subscription.checkout.success.emailMarketingFollowUp.description": "Book {{package}} separately now.",
"settings.subscription.checkout.success.emailMarketingFollowUp.action": "Book email package",
"settings.subscription.checkout.success.invalid.title": "Checkout not found",
"settings.subscription.checkout.success.invalid.body": "Invalid checkout session",
"settings.subscription.checkout.success.error.title": "Payment could not be confirmed",
"settings.subscription.checkout.success.error.body": "Try again.",
"settings.subscription.checkout.success.processing.title": "Confirming your payment",
"settings.subscription.checkout.success.processing.body": "Mollie is still processing your payment.",
"settings.subscription.checkout.success.cancelled.title": "Payment cancelled",
"settings.subscription.checkout.success.cancelled.body": "Nothing was enabled after cancellation.",
"settings.subscription.checkout.success.failed.title": "Payment failed",
"settings.subscription.checkout.success.failed.body": "Nothing was enabled after failure.",
"settings.subscription.checkout.success.expired.title": "Checkout expired",
"settings.subscription.checkout.success.expired.body": "Nothing was enabled after expiry.",
"settings.subscription.checkout.success.retry": "Check status again",
"settings.subscription.checkout.success.restartCheckout": "Start a new payment",
};
return (translations[key] ?? key).replace(/\{\{(\w+)\}\}/g, (_, name: string) => String(values?.[name] ?? ""));
},
}),
}));
vi.mock("react-router", async () => {
const actual = await vi.importActual<typeof import("react-router")>("react-router");
return {
...actual,
useLoaderData: () => mocks.loaderData,
useNavigate: () => mocks.navigate,
useRevalidator: () => ({ revalidate: mocks.revalidate, state: "idle" }),
};
});
vi.mock("~/locale/i18next.server", () => ({ getTranslations: vi.fn() }));
vi.mock("~/modules/metrics/services/.server/MetricTracker", () => ({ createMetrics: vi.fn() }));
vi.mock("~/utils/services/.server/urlService", () => ({ getTenantIdFromUrl: vi.fn() }));
vi.mock("~/utils/session.server", () => ({ getUserInfo: vi.fn() }));
vi.mock("~/utils/db/users.db.server", () => ({ getUser: vi.fn() }));
vi.mock("~/utils/db/tenants.db.server", () => ({ getTenant: vi.fn() }));
vi.mock("~/utils/helpers/.server/PermissionsService", () => ({ verifyUserHasPermission: vi.fn() }));
vi.mock("~/utils/services/.server/subscriptionService", () => ({ persistCheckoutSessionStatus: vi.fn() }));
vi.mock("@hivegrid/db/billing-domain.server", () => ({ resolveTenantBillingState: vi.fn() }));
vi.mock("~/utils/services/.server/pricingService", () => ({
addTenantProductsFromCheckoutSession: vi.fn(),
getAcquiredItemsFromCheckoutSession: vi.fn(),
}));
vi.mock("~/utils/data/.server/appData", () => ({ loadAppData: vi.fn() }));
vi.mock("~/utils/db/logs.db.server", () => ({ createLog: vi.fn() }));
vi.mock("@hivegrid/config", () => ({ loadRequiredWebConfig: vi.fn(() => ({ routing: {} })) }));
vi.mock("~/utils/app/CrossHostUrls", () => ({ absoluteAppRootPath: vi.fn(() => "https://app.example.test/") }));
vi.mock("~/utils/app/CanonicalUrlUtils", () => ({
appPath: vi.fn(({ tenantSlug, path }: { tenantSlug: string; path?: string }) => `/app/${tenantSlug}${path ? `/${path}` : ""}`),
}));
import SubscribeTenantSuccessRoute from "./subscribe.$tenant.$session.success";
describe("subscribe success UI", () => {
beforeEach(() => {
vi.clearAllMocks();
mocks.loaderData = {
currentTenant: { id: "tenant-1", name: "Acme Inc.", slug: "acme" },
user: { id: "user-1", email: "ada@example.test" },
checkoutSession: {
status: { status: "paid" },
products: [
{
title: "Pro",
prices: [
{
flatPrice: {
price: 49,
currency: "eur",
billingPeriod: SubscriptionBillingPeriod.MONTHLY,
},
},
],
},
],
},
checkoutState: "paid",
checkoutReceipt: {
subscriptionStatus: "active",
trialEndsAt: null,
currentPeriodEnd: "2026-06-27T00:00:00.000Z",
amountCents: 23_681,
recurringGrossTotalCents: 23_681,
currency: "EUR",
billingCadence: "monthly",
},
emailMarketingFollowUp: null,
};
});
it("keeps the selected email package as an explicit separate checkout after base activation", () => {
mocks.loaderData = {
...(mocks.loaderData as Record<string, unknown>),
emailMarketingFollowUp: {
code: "email_marketing_s",
titleKey: "Email Marketing S",
},
};
const { container } = render(<SubscribeTenantSuccessRoute />);
expect(container.querySelector('[data-ui-id="ui.subscription.checkout.success.emailMarketingFollowUp"]')).toBeVisible();
expect(screen.getByRole("button", { name: "Book email package" })).toHaveClass("w-full", "sm:w-auto", "sm:shrink-0");
expect(screen.getByText("Book Email Marketing S separately now.")).toBeVisible();
fireEvent.click(screen.getByRole("button", { name: "Book email package" }));
expect(mocks.navigate).toHaveBeenCalledWith("/app/acme/settings/billing?email_add_on=email_marketing_s");
});
afterEach(() => {
cleanup();
vi.useRealTimers();
});
it("renders the payment receipt and routes the primary action to workspace setup", () => {
const { container } = render(<SubscribeTenantSuccessRoute />);
expect(screen.getByText("Order summary").closest('[data-ui-id="ui.subscription.checkout.success.receipt"]')).toBeInTheDocument();
expect(screen.getByRole("heading", { name: "Payment successful" })).toBeInTheDocument();
expect(screen.getByText("Order summary")).toBeInTheDocument();
expect(screen.getByText("Pro")).toBeInTheDocument();
expect(screen.getByText("EUR 236.81 / month")).toBeInTheDocument();
expect(screen.getByText("June 27, 2026")).toBeInTheDocument();
expect(document.querySelector('[data-ui-id="ui.subscription.checkout.success.autoRedirect"]')).not.toBeInTheDocument();
fireEvent.click(screen.getByRole("button", { name: "Set up workspace" }));
expect(mocks.navigate).toHaveBeenCalledWith("/app/acme/onboarding/welcome");
fireEvent.click(screen.getByRole("button", { name: "Go to subscription" }));
expect(mocks.navigate).toHaveBeenCalledWith("/app/acme/settings/billing");
assertNoA11yViolations(container);
});
it("presents a persisted trial as a trial instead of claiming an immediate charge", () => {
mocks.loaderData = {
...(mocks.loaderData as Record<string, unknown>),
checkoutReceipt: {
subscriptionStatus: "trial",
trialEndsAt: "2026-06-27T00:00:00.000Z",
currentPeriodEnd: null,
amountCents: 0,
recurringGrossTotalCents: 23_681,
currency: "EUR",
billingCadence: "monthly",
},
};
render(<SubscribeTenantSuccessRoute />);
expect(screen.getByRole("heading", { name: "Your trial is running" })).toBeInTheDocument();
expect(screen.getByText("Payment method confirmed")).toBeInTheDocument();
expect(screen.getByText("Trial active")).toBeInTheDocument();
expect(screen.getByText("Monthly after trial incl. VAT")).toBeInTheDocument();
expect(screen.getByText("First invoice")).toBeInTheDocument();
expect(screen.queryByText("Payment successful")).not.toBeInTheDocument();
});
it("labels annual SEPA commitment as a monthly collection instead of a yearly charge", () => {
const current = mocks.loaderData as {
checkoutSession: { products: Array<{ prices: Array<{ flatPrice: { billingPeriod: number } }> }> };
checkoutReceipt: Record<string, unknown>;
};
mocks.loaderData = {
...current,
checkoutSession: {
...current.checkoutSession,
products: [
{
...current.checkoutSession.products[0],
prices: [{ flatPrice: { price: 199, currency: "eur", billingPeriod: SubscriptionBillingPeriod.YEARLY } }],
},
],
},
checkoutReceipt: { ...current.checkoutReceipt, billingCadence: "annual_sepa" },
};
render(<SubscribeTenantSuccessRoute />);
expect(screen.getByText("EUR 236.81 / month · 12-month term")).toBeInTheDocument();
});
it("uses the confirmed provider amount instead of showing a net catalog fallback as VAT-inclusive", () => {
const current = mocks.loaderData as {
checkoutSession: { products: Array<{ prices: Array<{ flatPrice: { billingPeriod: number } }> }> };
checkoutReceipt: Record<string, unknown>;
};
mocks.loaderData = {
...current,
checkoutSession: {
...current.checkoutSession,
products: [
{
...current.checkoutSession.products[0],
prices: [{ flatPrice: { price: 449, currency: "eur", billingPeriod: SubscriptionBillingPeriod.YEARLY } }],
},
],
},
checkoutReceipt: {
...current.checkoutReceipt,
amountCents: 53_431,
recurringGrossTotalCents: null,
billingCadence: "annual_sepa",
},
};
render(<SubscribeTenantSuccessRoute />);
expect(screen.getByText("EUR 534.31 / month · 12-month term")).toBeInTheDocument();
expect(screen.queryByText("EUR 449 / month · 12-month term")).not.toBeInTheDocument();
});
it("keeps invalid checkout fallback accessible and tenant-scoped", () => {
mocks.loaderData = { ...mocks.loaderData, checkoutSession: null, checkoutState: "invalid" };
const { container } = render(<SubscribeTenantSuccessRoute />);
expect(document.querySelector('[data-ui-id="ui.subscription.checkout.success.invalid"]')).toBeInTheDocument();
expect(screen.getByRole("heading", { name: "Checkout not found" })).toBeInTheDocument();
expect(screen.getByText("Invalid checkout session")).toBeInTheDocument();
fireEvent.click(screen.getByRole("button", { name: "Go to subscription" }));
expect(mocks.navigate).toHaveBeenCalledWith("/app/acme/settings/billing");
assertNoA11yViolations(container);
});
it("keeps a pending payment in an auto-refreshing processing state", () => {
vi.useFakeTimers();
mocks.loaderData = { ...mocks.loaderData, checkoutState: "processing", checkoutReceipt: null };
const { container } = render(<SubscribeTenantSuccessRoute />);
expect(document.querySelector('[data-ui-id="ui.subscription.checkout.success.processing"]')).toBeInTheDocument();
expect(screen.getByRole("heading", { name: "Confirming your payment" })).toBeInTheDocument();
expect(screen.queryByRole("button", { name: "Set up workspace" })).not.toBeInTheDocument();
act(() => vi.advanceTimersByTime(2_500));
expect(mocks.revalidate).toHaveBeenCalledTimes(1);
fireEvent.click(screen.getByRole("button", { name: "Check status again" }));
expect(mocks.revalidate).toHaveBeenCalledTimes(2);
assertNoA11yViolations(container);
});
it("bounds automatic provider status checks and leaves manual retry available", () => {
vi.useFakeTimers();
mocks.loaderData = { ...mocks.loaderData, checkoutState: "processing", checkoutReceipt: null };
render(<SubscribeTenantSuccessRoute />);
act(() => vi.runAllTimers());
expect(mocks.revalidate).toHaveBeenCalledTimes(12);
fireEvent.click(screen.getByRole("button", { name: "Check status again" }));
expect(mocks.revalidate).toHaveBeenCalledTimes(13);
});
it.each([
["cancelled", "Payment cancelled"],
["failed", "Payment failed"],
["expired", "Checkout expired"],
] as const)("shows %s as terminal with a new-checkout and billing action", (checkoutState, title) => {
mocks.loaderData = { ...mocks.loaderData, checkoutState, checkoutReceipt: null };
const storageKey = "hivegrid.billing.checkout-request.v1:/app/acme/settings/billing";
window.sessionStorage.setItem(storageKey, JSON.stringify({ key: "stale" }));
render(<SubscribeTenantSuccessRoute />);
expect(window.sessionStorage.getItem(storageKey)).toBeNull();
expect(document.querySelector(`[data-ui-id="ui.subscription.checkout.success.${checkoutState}"]`)).toBeInTheDocument();
expect(screen.getByRole("heading", { name: title })).toBeInTheDocument();
expect(screen.queryByRole("button", { name: "Set up workspace" })).not.toBeInTheDocument();
fireEvent.click(screen.getByRole("button", { name: "Start a new payment" }));
expect(mocks.navigate).toHaveBeenCalledWith("/app/acme/settings/billing");
expect(mocks.revalidate).not.toHaveBeenCalled();
fireEvent.click(screen.getByRole("button", { name: "Go to subscription" }));
expect(mocks.navigate).toHaveBeenCalledWith("/app/acme/settings/billing");
});
it("keeps activation errors generic, accessible, and tenant-scoped", () => {
mocks.loaderData = { ...mocks.loaderData, error: "Unexpected error" };
const { container } = render(<SubscribeTenantSuccessRoute />);
expect(document.querySelector('[data-ui-id="ui.subscription.checkout.success.error"]')).toBeInTheDocument();
expect(screen.getByRole("heading", { name: "Payment could not be confirmed" })).toBeInTheDocument();
expect(screen.getByText("Unexpected error")).toBeInTheDocument();
expect(screen.queryByText("activation failed")).not.toBeInTheDocument();
fireEvent.click(screen.getByRole("button", { name: "Go to subscription" }));
expect(mocks.navigate).toHaveBeenCalledWith("/app/acme/settings/billing");
assertNoA11yViolations(container);
});
});