254 lines
10 KiB
TypeScript
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 };
|