/** * Tenant admin: form-widget list + create (Phase 05 Task #58, layer 3). * * Permissions: `app.settings.account.update` (admin-only) — forms expose * a public submission endpoint so we keep authoring tightly scoped. * * The page renders existing forms with their public key + submission * count + embed-code snippet, plus a minimal create form that seeds a * single text+email definition. Field editing happens on the detail * route (forms.$id.tsx). */ import { type ActionFunctionArgs, type LoaderFunctionArgs, useLoaderData, Form, Link, useActionData } from "react-router"; import { useTranslation } from "react-i18next"; import slugify from "@sindresorhus/slugify"; import { db } from "~/utils/db.server"; import { getTranslations } from "~/locale/i18next.server"; import { useLocaleFormatters } from "~/locale/format"; import { validateCSRFToken } from "~/utils/session.server"; import { FormDefinitionSchema, HONEYPOT_FIELD_KEY } from "@hivegrid/form-widget"; import { seedShkFormTemplates } from "~/modules/forms/services/shkFormTemplates.server"; import { formsOwnerWhere, loadFormsContext, requireFormsPermission } from "~/modules/forms/routes/formsAccess.server"; import { useRootData } from "~/utils/data/useRootData"; type Row = { id: string; key: string; slug: string | null; name: string; subtype: string; status: string; isEnabled: boolean; submissions: number; createdAt: string; }; type LoaderData = { forms: Row[]; embedScriptBase: string; }; type ActionData = { error?: string; createdId?: string }; export async function loader({ request, params }: LoaderFunctionArgs): Promise { const ctx = await loadFormsContext({ request, params, requireModule: true }); requireFormsPermission(ctx, "forms.basic"); const forms = await db.form.findMany({ where: { tenantId: ctx.tenantId, ...formsOwnerWhere(ctx) }, orderBy: { createdAt: "desc" }, select: { id: true, key: true, slug: true, name: true, subtype: true, status: true, isEnabled: true, createdAt: true, _count: { select: { submissions: true } }, }, }); return { forms: forms.map((f) => ({ id: f.id, key: f.key, slug: f.slug, name: f.name, subtype: f.subtype, status: f.status, isEnabled: f.isEnabled, submissions: f._count.submissions, createdAt: f.createdAt.toISOString(), })), embedScriptBase: process.env.FORM_WIDGET_CDN_URL?.trim() || process.env.APP_URL?.trim() || "", }; } export async function action({ request, params }: ActionFunctionArgs): Promise { const ctx = await loadFormsContext({ request, params, requireModule: true }); requireFormsPermission(ctx, "forms.builder"); await validateCSRFToken(request); const { t } = await getTranslations(request); const body = await request.formData(); const op = body.get("op")?.toString() ?? ""; if (op === "create") { const name = body.get("name")?.toString()?.trim(); const origin = body.get("allowedOrigin")?.toString()?.trim() ?? ""; if (!name) return { error: t("settings.forms.admin.errors.nameRequired") }; const baseSlug = slugify(name).slice(0, 80) || "form"; let slug = baseSlug; for (let i = 2; i < 100; i += 1) { const exists = await db.form.findFirst({ where: { tenantId: ctx.tenantId, slug }, select: { id: true } }); if (!exists) break; slug = `${baseSlug}-${i}`; } const definition = FormDefinitionSchema.parse({ title: name, submitLabel: t("settings.forms.admin.defaults.submitLabel"), successMessage: t("settings.forms.admin.defaults.successMessage"), gdprConsentLabel: t("settings.forms.admin.defaults.gdprConsentLabel"), fields: [ { key: "full_name", type: "text", label: t("settings.forms.admin.defaults.fields.fullName"), required: true }, { key: "email", type: "email", label: t("settings.forms.admin.defaults.fields.email"), required: true }, { key: "message", type: "textarea", label: t("settings.forms.admin.defaults.fields.message"), required: false }, { key: HONEYPOT_FIELD_KEY, type: "honeypot", label: t("settings.forms.admin.defaults.fields.honeypot") }, ], }); const created = await db.form.create({ data: { tenantId: ctx.tenantId, createdByUserId: ctx.userId, name, slug, subtype: "standard", status: "draft", definition: definition as object, allowedOrigins: origin ? [origin] : [], config: { honeypotEnabled: true } as object, }, select: { id: true }, }); return { createdId: created.id }; } if (op === "seed-shk-templates") { await seedShkFormTemplates({ tenantId: ctx.tenantId, userId: ctx.userId, t }); return { error: undefined }; } if (op === "toggle") { const id = body.get("id")?.toString(); if (!id) return { error: t("settings.forms.admin.errors.missingFormId") }; const target = await db.form.findFirst({ where: { id, tenantId: ctx.tenantId, ...formsOwnerWhere(ctx) }, select: { isEnabled: true } }); if (!target) return { error: t("settings.forms.admin.errors.formNotFound") }; await db.form.update({ where: { id }, data: { isEnabled: !target.isEnabled } }); return { error: undefined }; } if (op === "delete") { const id = body.get("id")?.toString(); if (!id) return { error: t("settings.forms.admin.errors.missingFormId") }; await db.form.deleteMany({ where: { id, tenantId: ctx.tenantId, ...formsOwnerWhere(ctx) } }); return { error: undefined }; } return { error: t("settings.forms.admin.errors.unknownOperation") }; } export default function FormsAdmin(): React.JSX.Element { const data = useLoaderData() as LoaderData; const actionData = useActionData() as ActionData | undefined; const { t } = useTranslation(); const formatters = useLocaleFormatters(); const rootData = useRootData(); return (

{t("settings.forms.admin.title")}

{t("settings.forms.admin.description")}

{t("settings.forms.admin.create.title")}

{actionData?.error ?

{actionData.error}

: null}

{t("settings.forms.admin.existing.title")}

{data.forms.length === 0 ? (

{t("settings.forms.admin.existing.empty")}

) : (
    {data.forms.map((f) => (
  • {f.name}
    {t("settings.forms.admin.existing.key")}: {f.key} ·{" "} {t("settings.forms.admin.existing.slug")}: {f.slug ?? "n/a"} ·{" "} {t("settings.forms.admin.existing.status")}: {f.status} ·{" "} {t("settings.forms.admin.existing.submissionsCount", { count: f.submissions, formattedCount: formatters.number(f.submissions), })}{" "} · {f.isEnabled ? t("shared.enabled") : t("shared.disabled")} ·{" "} {t("settings.forms.admin.existing.createdAtWithDate", { date: formatters.date(f.createdAt, { dateStyle: "medium", timeStyle: "short" }), })}
                        {``}
                      
    { if (!confirm(t("settings.forms.admin.delete.confirm"))) e.preventDefault(); }}>
  • ))}
)}
); }