Files
2026-07-08 16:15:37 +02:00

254 lines
10 KiB
TypeScript

// VA-P23 · mailbox connect settings route (M09 Block B/D). Lists the current
// user's OWN mailboxes (read_all admins see every tenant mailbox) + the two
// provider connect actions + reconnect/disconnect. Connect redirects to the
// provider consent screen with a signed, provider-pinned state. Module off ->
// locked empty; missing email.read_own -> 404 (A.5.3).
import { type ActionFunctionArgs, type LoaderFunctionArgs, redirect, useLoaderData, useSearchParams, Form } from "react-router";
import { useTranslation } from "react-i18next";
import {
aggregateInitialSync,
buildEmailMailboxListVM,
emailMailboxProviderKey,
emailMailboxStatusKey,
type EmailMailboxListVM,
type EmailMailboxRow,
} from "@hivegrid/view-models";
import { getTranslations } from "~/locale/i18next.server";
import { validateCSRFToken } from "~/utils/session.server";
import { useRootData } from "~/utils/data/useRootData";
import {
EMAIL_PERMISSIONS,
canReadAllMailboxes,
canWriteEmail,
loadEmailInboxContext,
requireEmailRead,
requireMailboxVisibility,
} from "~/modules/emailInbox/routes/emailInboxAccess.server";
import { EMAIL_INBOX_MODULE_KEY, notFoundResponse } from "~/modules/emailInbox/routes/emailInboxRoutePaths";
import { getMailboxForTenant, listMailboxesForTenant, listMailboxesForUser, listSyncCursorsForMailboxes } from "~/modules/emailInbox/db/emailInbox.db.server";
import { MailboxConnectError, buildConnectUrl, configuredEmailProviders, disconnectMailbox } from "~/modules/emailInbox/services/MailboxConnectionService.server";
import type { EmailOAuthProvider } from "~/modules/emailInbox/services/oauthState.server";
import ServerError from "~/components/ui/errors/ServerError";
type LoaderData = { title: string; vm: EmailMailboxListVM };
export const loader = async ({ request, params }: LoaderFunctionArgs) => {
const { t } = await getTranslations(request);
const ctx = await loadEmailInboxContext({ request, params });
const title = `${t("emailInbox.settings.title")} | ${process.env.APP_NAME}`;
if (!ctx.hasModule) {
return Response.json({
title,
vm: buildEmailMailboxListVM({ rows: [], canConnect: false, configuredProviders: { gmail: false, microsoft: false } }),
} satisfies LoaderData);
}
try {
requireEmailRead(ctx);
} catch {
throw notFoundResponse();
}
const mailboxes = canReadAllMailboxes(ctx) ? await listMailboxesForTenant(ctx.tenantId) : await listMailboxesForUser(ctx.tenantId, ctx.userId);
const cursors = await listSyncCursorsForMailboxes(
ctx.tenantId,
mailboxes.map((m) => m.id),
);
const rows: EmailMailboxRow[] = mailboxes.map((mailbox) => ({
id: mailbox.id,
provider: mailbox.provider,
providerKey: emailMailboxProviderKey(mailbox.provider),
emailAddress: mailbox.emailAddress,
displayName: mailbox.displayName,
isDefaultForUser: mailbox.isDefaultForUser,
isOwn: mailbox.ownerUserId === ctx.userId,
status: mailbox.status,
statusKey: emailMailboxStatusKey(mailbox.status),
lastSyncAt: mailbox.lastSyncAt ? mailbox.lastSyncAt.toISOString() : null,
lastErrorText: mailbox.lastErrorText,
initialSync: aggregateInitialSync(cursors.filter((c) => c.mailboxId === mailbox.id)),
}));
const vm = buildEmailMailboxListVM({
rows,
canConnect: canWriteEmail(ctx),
configuredProviders: configuredEmailProviders(),
});
return Response.json({ title, vm } satisfies LoaderData);
};
export const action = async ({ request, params }: ActionFunctionArgs) => {
const ctx = await loadEmailInboxContext({ request, params, requireModule: true });
await validateCSRFToken(request);
const form = await request.formData();
const intent = String(form.get("intent") ?? "");
if (intent === "connect-gmail" || intent === "connect-microsoft") {
try {
requireEmailRead(ctx);
} catch {
throw notFoundResponse();
}
if (!canWriteEmail(ctx)) {
throw notFoundResponse();
}
const provider: EmailOAuthProvider = intent === "connect-gmail" ? "gmail" : "microsoft";
try {
const url = buildConnectUrl({ tenantId: ctx.tenantId, userId: ctx.userId, tenantSlug: params.tenant ?? "", provider });
return redirect(url);
} catch (error) {
if (error instanceof MailboxConnectError) {
return Response.json({ error: "emailInbox.settings.notConfigured" }, { status: 400 });
}
throw error;
}
}
if (intent === "disconnect") {
const mailboxId = String(form.get("mailboxId") ?? "");
const mailbox = mailboxId ? await getMailboxForTenant(ctx.tenantId, mailboxId) : null;
if (!mailbox) {
throw notFoundResponse();
}
// Owner may disconnect their own mailbox; read_all admins may force-disconnect.
requireMailboxVisibility(ctx, mailbox.ownerUserId);
if (mailbox.ownerUserId === ctx.userId && !canWriteEmail(ctx)) {
throw notFoundResponse();
}
await disconnectMailbox({ tenantId: ctx.tenantId, mailboxId });
return Response.json({ ok: true, disconnected: mailboxId });
}
throw notFoundResponse();
};
function MailboxRowItem({ row, csrf }: { row: EmailMailboxRow; csrf?: string }) {
const { t } = useTranslation();
return (
<li className="py-3" data-row-id={row.id}>
<div className="flex items-center justify-between">
<div>
<p className="text-foreground font-medium">
{row.emailAddress}
<span className="text-muted-foreground ml-2 text-xs">{t(row.providerKey)}</span>
</p>
{row.lastSyncAt && (
<p className="text-muted-foreground text-xs">
{t("emailInbox.settings.lastSync")}: {new Date(row.lastSyncAt).toLocaleString()}
</p>
)}
</div>
<div className="flex items-center gap-3">
<span className="text-muted-foreground text-xs" data-status={row.status}>
{t(row.statusKey)}
</span>
{row.isOwn && (
<Form method="post">
{csrf && <input type="hidden" name="csrf" value={csrf} />}
<input type="hidden" name="intent" value="disconnect" />
<input type="hidden" name="mailboxId" value={row.id} />
<button type="submit" className="text-destructive text-xs underline" data-ui-id="ui.email.settings.disconnect">
{t("emailInbox.settings.disconnect")}
</button>
</Form>
)}
</div>
</div>
{row.initialSync.status !== "completed" && (
<p className="text-muted-foreground mt-1 text-xs" data-ui-id="ui.email.settings.initialSync" data-sync-status={row.initialSync.status}>
{t(row.initialSync.statusKey)}
{row.initialSync.progressPercent !== null && ` — ${row.initialSync.progressPercent}%`}
{row.initialSync.fetchedCount !== null && ` (${t("emailInbox.settings.initialSync.fetched", { count: row.initialSync.fetchedCount })})`}
</p>
)}
{row.lastErrorText && (
<p className="text-destructive mt-1 text-xs" data-ui-id="ui.email.settings.error">
{row.lastErrorText.startsWith("emailInbox.") ? t(row.lastErrorText) : row.lastErrorText}
</p>
)}
</li>
);
}
export default function EmailSettingsRoute() {
const { t } = useTranslation();
const rootData = useRootData();
const { vm } = useLoaderData<LoaderData>();
const [searchParams] = useSearchParams();
const flash = searchParams.get("email");
if (vm.status !== "ready" || !vm.data) {
return <main className="mx-auto max-w-3xl px-4 py-10" data-ui-id="ui.email.settings" />;
}
const { rows, canConnect, configuredProviders, emptyHeadlineKey, emptyBodyKey, notConfiguredKey } = vm.data;
const anyConfigured = configuredProviders.gmail || configuredProviders.microsoft;
return (
<main className="mx-auto max-w-3xl px-4 py-10" data-ui-id="ui.email.settings">
<h1 className="text-foreground text-xl font-semibold">{t("emailInbox.settings.title")}</h1>
<p className="text-muted-foreground mt-1 text-sm">{t("emailInbox.settings.subtitle")}</p>
{flash === "connected" && (
<p className="border-border text-foreground mt-4 rounded-md border px-3 py-2 text-sm" data-ui-id="ui.email.settings.flash.connected">
{t("emailInbox.settings.flash.connected")}
</p>
)}
{flash === "error" && (
<p className="text-destructive border-border mt-4 rounded-md border px-3 py-2 text-sm" data-ui-id="ui.email.settings.flash.error">
{t("emailInbox.settings.flash.error")}
</p>
)}
{!anyConfigured && (
<p className="border-border text-muted-foreground mt-4 rounded-md border px-3 py-2 text-sm" data-ui-id="ui.email.settings.notConfigured">
{t(notConfiguredKey)}
</p>
)}
{canConnect && anyConfigured && (
<div className="mt-4 flex gap-3">
{configuredProviders.gmail && (
<Form method="post">
{rootData.csrf && <input type="hidden" name="csrf" value={rootData.csrf} />}
<input type="hidden" name="intent" value="connect-gmail" />
<button type="submit" className="bg-theme-600 rounded-md px-4 py-2 text-sm font-medium text-white" data-ui-id="ui.email.settings.connect.gmail">
{t("emailInbox.settings.connectGmail")}
</button>
</Form>
)}
{configuredProviders.microsoft && (
<Form method="post">
{rootData.csrf && <input type="hidden" name="csrf" value={rootData.csrf} />}
<input type="hidden" name="intent" value="connect-microsoft" />
<button type="submit" className="bg-theme-600 rounded-md px-4 py-2 text-sm font-medium text-white" data-ui-id="ui.email.settings.connect.microsoft">
{t("emailInbox.settings.connectMicrosoft")}
</button>
</Form>
)}
</div>
)}
{rows.length === 0 ? (
<div className="mt-10 text-center" data-ui-id="ui.email.settings.empty">
<p className="text-foreground font-medium">{t(emptyHeadlineKey)}</p>
<p className="text-muted-foreground mt-1 text-sm">{t(emptyBodyKey)}</p>
</div>
) : (
<ul className="divide-border mt-6 divide-y" data-ui-id="ui.email.settings.list">
{rows.map((row) => (
<MailboxRowItem key={row.id} row={row} csrf={rootData.csrf} />
))}
</ul>
)}
</main>
);
}
export function ErrorBoundary() {
return <ServerError />;
}
export const handle = { moduleKey: EMAIL_INBOX_MODULE_KEY };