@aglyn/plugins-crm 1.0.0-beta.143

package/src/lib/components/email-templates-card.js

@@ -0,0 +1,370 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ 'use client';
+import { _ as _extends } from "@swc/helpers/_/_extends";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { CRM_COLLECTIONS, CRM_EMAIL_TEMPLATE_KIND_LABELS, CRM_EMAIL_TEMPLATE_VISIBILITY_LABELS, CRM_EMAIL_TEMPLATES_LIMIT, createResourceUid, pluginDocsHelp } from "@aglyn/aglyn";
+import { mdiContentCopy, mdiDeleteOutline, mdiPencilOutline } from "@aglyn/shared-data-mdi";
+import EmptyStateComponent from "@aglyn/shared-ui-jsx/components/empty-state.component";
+import { CardDisplay, MdiIcon, useConfirmationContext } from "@aglyn/shared-ui-jsx";
+import RowActionsMenu from "@aglyn/shared-ui-jsx/components/row-actions-menu.component";
+import { ScrollTable } from "@aglyn/shared-ui-jsx/components/scroll-table.component";
+import { useSnackbar } from "@aglyn/shared-ui-snackstack";
+import { DUPLICATE_MENU_LABEL, useDuplicateResource, useFirestore, useUser } from "@aglyn/tenant-feature-instance";
+import { useCrmApi } from "./use-crm-api.js";
+import { Button, Chip, Stack, TableBody, TableCell, TableHead, TableRow, Typography } from "@mui/material";
+import { collection, deleteDoc, deleteField, doc, setDoc, updateDoc } from "firebase/firestore";
+import { useCallback, useState } from "react";
+import { useCrmEmailTemplates, useCrmEmailTemplateScope } from "../hooks/use-crm-email-templates.js";
+import EmailTemplateDrawer from "./email-template-drawer.js";
+/**
+ * "Email templates" — the letters the team keeps for **Send email**
+ * (AGL-2658): every template and snippet this member can use, with a
+ * drawer to write one and a row menu to edit or delete it.
+ *
+ * ## Whose card this is
+ *
+ * Unlike the switches above it, which the org's owner or admin alone may
+ * move, this card is every CRM editor's: a template is working material,
+ * not policy. The rules gate the rest — a shared row is any editor's, a
+ * personal row its owner's — and a colleague's personal rows are not
+ * listed here at all, so every row on screen is one this member may
+ * change.
+ *
+ * ## Where a new template lands
+ *
+ * Under a site, in that site's scope; from the organization's own hub, in
+ * the org's — the same rule the send dialog's Save as template follows
+ * (`useCrmEmailTemplateScope`). A personal template is owned by its
+ * writer; switching one to shared drops the owner, and back to personal
+ * makes the member editing it the owner.
+ */ export function EmailTemplatesCard(props) {
+    var _ref;
+    const { hostId, org } = props;
+    const firestore = useFirestore();
+    const { enqueueSnackbar } = useSnackbar();
+    const { confirm } = useConfirmationContext();
+    const { data: user } = useUser();
+    const uid = (_ref = user == null ? void 0 : user.uid) != null ? _ref : null;
+    const templateScope = useCrmEmailTemplateScope({
+        hostId,
+        org
+    });
+    const { scope, ready: scopeReady } = templateScope;
+    const { templates, ready } = useCrmEmailTemplates({
+        scope,
+        visibleTo: templateScope.visibleTo,
+        uid
+    });
+    // Duplicate (AGL-2936): through the plugin's own door, which files the
+    // copy under this person and keeps the original's scope.
+    const callCrm = useCrmApi(hostId != null ? hostId : null);
+    const duplicate = useDuplicateResource({
+        hostId: hostId != null ? hostId : '',
+        perform: async ({ sourceId, name, attemptKey })=>{
+            var _ref, _payload_name;
+            const { response, payload } = await callCrm('email-template-duplicate', {
+                templateId: sourceId,
+                name,
+                attemptKey
+            });
+            if (!response.ok) throw new Error((_ref = payload == null ? void 0 : payload.error) != null ? _ref : 'Duplicate failed');
+            return {
+                id: String(payload.templateId),
+                versionId: null,
+                name: String((_payload_name = payload.name) != null ? _payload_name : name)
+            };
+        },
+        onDuplicated: (_kind, copy)=>enqueueSnackbar(`Duplicated as “${copy.name}”`, {
+                variant: 'success',
+                persist: false
+            })
+    });
+    const [drawerOpen, setDrawerOpen] = useState(false);
+    const [editing, setEditing] = useState(null);
+    const [busyId, setBusyId] = useState('');
+    const templateRef = useCallback((id)=>{
+        if (!scope) throw new Error('an email template needs an organization');
+        return doc(firestore, scope[0], scope[1], CRM_COLLECTIONS.emailTemplates, id);
+    }, [
+        firestore,
+        scope
+    ]);
+    const openCreate = useCallback(()=>{
+        setEditing(null);
+        setDrawerOpen(true);
+    }, []);
+    const openEdit = useCallback((template)=>{
+        setEditing(template);
+        setDrawerOpen(true);
+    }, []);
+    const handleSubmit = useCallback(async (draft)=>{
+        if (!scope || !uid) return;
+        const now = Date.now();
+        const ownership = draft.visibility === 'personal' ? {
+            ownerUid: uid
+        } : {
+            ownerUid: deleteField()
+        };
+        if (editing) {
+            await updateDoc(templateRef(editing.$id), _extends({
+                name: draft.name,
+                kind: draft.kind,
+                visibility: draft.visibility,
+                subject: draft.subject,
+                body: draft.body
+            }, ownership, {
+                updatedAtMs: now,
+                updatedAt: new Date(now)
+            }));
+            enqueueSnackbar('Template saved', {
+                variant: 'success',
+                persist: false
+            });
+        } else {
+            await setDoc(doc(collection(firestore, scope[0], scope[1], CRM_COLLECTIONS.emailTemplates), createResourceUid()), _extends({
+                name: draft.name,
+                kind: draft.kind,
+                visibility: draft.visibility,
+                subject: draft.subject,
+                body: draft.body
+            }, draft.visibility === 'personal' ? {
+                ownerUid: uid
+            } : {}, {
+                createdByUid: uid,
+                createdAtMs: now,
+                updatedAtMs: now,
+                hostId: templateScope.createHostId,
+                visibleTo: [
+                    ...templateScope.createTokens
+                ],
+                createdAt: new Date(now),
+                updatedAt: new Date(now)
+            }));
+            enqueueSnackbar(`Template "${draft.name}" added`, {
+                variant: 'success',
+                persist: false
+            });
+        }
+        setDrawerOpen(false);
+        setEditing(null);
+    }, [
+        scope,
+        uid,
+        editing,
+        templateRef,
+        enqueueSnackbar,
+        firestore,
+        templateScope
+    ]);
+    const handleDelete = useCallback(async (template)=>{
+        if (!scope || busyId) return;
+        const accepted = await confirm({
+            title: `Delete "${template.name}"?`,
+            description: template.kind === 'snippet' ? 'The snippet is removed for everyone it is listed for. Emails already sent are not changed.' : 'The template is removed for everyone it is listed for. Emails already sent are not changed.',
+            confirmationText: 'Delete',
+            confirmationButtonProps: {
+                color: 'error'
+            }
+        }).then(()=>true).catch(()=>false);
+        if (!accepted) return;
+        setBusyId(template.$id);
+        try {
+            await deleteDoc(templateRef(template.$id));
+            enqueueSnackbar('Template deleted', {
+                variant: 'success',
+                persist: false
+            });
+        } catch (error) {
+            console.error(error);
+            enqueueSnackbar('An error has occurred', {
+                variant: 'error',
+                allowDuplicate: true
+            });
+        } finally{
+            setBusyId('');
+        }
+    }, [
+        scope,
+        busyId,
+        confirm,
+        templateRef,
+        enqueueSnackbar
+    ]);
+    const rowActions = (template)=>[
+            {
+                key: 'edit',
+                label: 'Edit',
+                icon: /*#__PURE__*/ _jsx(MdiIcon, {
+                    path: mdiPencilOutline.path,
+                    size: 0.8
+                }),
+                onClick: ()=>openEdit(template)
+            },
+            {
+                key: 'duplicate',
+                label: DUPLICATE_MENU_LABEL,
+                icon: /*#__PURE__*/ _jsx(MdiIcon, {
+                    path: mdiContentCopy.path,
+                    size: 0.8
+                }),
+                onClick: ()=>duplicate.request('emailTemplate', {
+                        id: template.$id,
+                        name: template.name
+                    })
+            },
+            {
+                key: 'delete',
+                label: 'Delete',
+                icon: /*#__PURE__*/ _jsx(MdiIcon, {
+                    path: mdiDeleteOutline.path,
+                    size: 0.8
+                }),
+                destructive: true,
+                disabled: Boolean(busyId),
+                onClick: ()=>void handleDelete(template)
+            }
+        ];
+    const atCap = templates.length >= CRM_EMAIL_TEMPLATES_LIMIT;
+    const canCreate = Boolean(scope) && Boolean(uid) && !atCap;
+    return /*#__PURE__*/ _jsxs(CardDisplay, {
+        header: 'Email templates',
+        help: pluginDocsHelp('crmEmailTemplates', {
+            anchor: '#managing-templates'
+        }),
+        contentGutterX: true,
+        contentGutterY: true,
+        contentBordered: "all",
+        HeaderProps: {
+            action: /*#__PURE__*/ _jsx(Button, {
+                variant: "contained",
+                disabled: !canCreate,
+                onClick: openCreate,
+                children: 'New template'
+            })
+        },
+        children: [
+            duplicate.dialog,
+            /*#__PURE__*/ _jsxs(Stack, {
+                spacing: 2,
+                children: [
+                    /*#__PURE__*/ _jsx(Typography, {
+                        variant: "body2",
+                        color: "text.secondary",
+                        children: 'The letters your team sends from a record. A template fills in the ' + 'subject and the message of Send email; a snippet drops a paragraph ' + 'in where the cursor is. Merge fields such as {{contact.firstName}} ' + 'are filled in from the record when the email is sent.'
+                    }),
+                    scopeReady && !scope ? /*#__PURE__*/ _jsx(Typography, {
+                        variant: "body2",
+                        color: "text.secondary",
+                        children: 'This site has no organization, so it has no email templates.'
+                    }) : !ready ? null : templates.length === 0 ? /*#__PURE__*/ _jsx(EmptyStateComponent, {
+                        label: 'No templates yet',
+                        description: 'Write one here, or save an email you are about to send as a template.',
+                        action: canCreate ? /*#__PURE__*/ _jsx(Button, {
+                            variant: "contained",
+                            onClick: openCreate,
+                            children: 'New template'
+                        }) : undefined
+                    }) : /*#__PURE__*/ _jsxs(ScrollTable, {
+                        size: "small",
+                        children: [
+                            /*#__PURE__*/ _jsx(TableHead, {
+                                children: /*#__PURE__*/ _jsxs(TableRow, {
+                                    children: [
+                                        /*#__PURE__*/ _jsx(TableCell, {
+                                            children: 'Name'
+                                        }),
+                                        /*#__PURE__*/ _jsx(TableCell, {
+                                            children: 'Kind'
+                                        }),
+                                        /*#__PURE__*/ _jsx(TableCell, {
+                                            children: 'For'
+                                        }),
+                                        /*#__PURE__*/ _jsx(TableCell, {
+                                            children: 'Subject'
+                                        }),
+                                        /*#__PURE__*/ _jsx(TableCell, {
+                                            align: "right"
+                                        })
+                                    ]
+                                })
+                            }),
+                            /*#__PURE__*/ _jsx(TableBody, {
+                                children: templates.map((template)=>/*#__PURE__*/ _jsxs(TableRow, {
+                                        hover: true,
+                                        children: [
+                                            /*#__PURE__*/ _jsx(TableCell, {
+                                                children: /*#__PURE__*/ _jsx(Typography, {
+                                                    variant: "body2",
+                                                    children: template.name
+                                                })
+                                            }),
+                                            /*#__PURE__*/ _jsx(TableCell, {
+                                                children: /*#__PURE__*/ _jsx(Typography, {
+                                                    variant: "body2",
+                                                    children: CRM_EMAIL_TEMPLATE_KIND_LABELS[template.kind]
+                                                })
+                                            }),
+                                            /*#__PURE__*/ _jsx(TableCell, {
+                                                children: /*#__PURE__*/ _jsx(Chip, {
+                                                    size: "small",
+                                                    variant: template.visibility === 'personal' ? 'outlined' : 'filled',
+                                                    label: CRM_EMAIL_TEMPLATE_VISIBILITY_LABELS[template.visibility]
+                                                })
+                                            }),
+                                            /*#__PURE__*/ _jsx(TableCell, {
+                                                children: /*#__PURE__*/ _jsx(Typography, {
+                                                    variant: "body2",
+                                                    color: "text.secondary",
+                                                    noWrap: true,
+                                                    children: template.kind === 'template' ? template.subject || '—' : template.body
+                                                })
+                                            }),
+                                            /*#__PURE__*/ _jsx(TableCell, {
+                                                align: "right",
+                                                sx: {
+                                                    width: 56
+                                                },
+                                                children: /*#__PURE__*/ _jsx(RowActionsMenu, {
+                                                    label: template.name,
+                                                    items: rowActions(template)
+                                                })
+                                            })
+                                        ]
+                                    }, template.$id))
+                            })
+                        ]
+                    }),
+                    atCap ? /*#__PURE__*/ _jsx(Typography, {
+                        variant: "caption",
+                        color: "text.secondary",
+                        children: `A workspace keeps at most ${CRM_EMAIL_TEMPLATES_LIMIT} templates and snippets. Delete one to add another.`
+                    }) : null
+                ]
+            }),
+            /*#__PURE__*/ _jsx(EmailTemplateDrawer, {
+                open: drawerOpen,
+                onClose: ()=>setDrawerOpen(false),
+                template: editing,
+                onSubmit: handleSubmit
+            })
+        ]
+    });
+}
+EmailTemplatesCard.displayName = 'EmailTemplatesCard';
+export default EmailTemplatesCard;
+
+//# sourceMappingURL=email-templates-card.js.map

package/src/lib/components/email-templates-card.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/crm/src/lib/components/email-templates-card.tsx"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n'use client'\n\nimport {\n  type AglynOrgBilling,\n  CRM_COLLECTIONS,\n  CRM_EMAIL_TEMPLATE_KIND_LABELS,\n  CRM_EMAIL_TEMPLATE_VISIBILITY_LABELS,\n  CRM_EMAIL_TEMPLATES_LIMIT,\n  type CrmEmailTemplateRow,\n  createResourceUid,\n  pluginDocsHelp,\n} from '@aglyn/aglyn'\nimport {\n  mdiContentCopy,\n  mdiDeleteOutline,\n  mdiPencilOutline,\n} from '@aglyn/shared-data-mdi'\nimport EmptyStateComponent from '@aglyn/shared-ui-jsx/components/empty-state.component'\nimport { CardDisplay, MdiIcon, useConfirmationContext } from '@aglyn/shared-ui-jsx'\nimport RowActionsMenu, {\n  type RowActionsMenuItem,\n} from '@aglyn/shared-ui-jsx/components/row-actions-menu.component'\nimport { ScrollTable } from '@aglyn/shared-ui-jsx/components/scroll-table.component'\nimport { useSnackbar } from '@aglyn/shared-ui-snackstack'\nimport {\n  DUPLICATE_MENU_LABEL,\n  useDuplicateResource,\n  useFirestore,\n  useUser,\n} from '@aglyn/tenant-feature-instance'\nimport { useCrmApi } from './use-crm-api'\nimport {\n  Button,\n  Chip,\n  Stack,\n  TableBody,\n  TableCell,\n  TableHead,\n  TableRow,\n  Typography,\n} from '@mui/material'\nimport { collection, deleteDoc, deleteField, doc, setDoc, updateDoc } from 'firebase/firestore'\nimport { useCallback, useState } from 'react'\nimport {\n  useCrmEmailTemplates,\n  useCrmEmailTemplateScope,\n} from '../hooks/use-crm-email-templates'\nimport EmailTemplateDrawer, { type EmailTemplateDraft } from './email-template-drawer'\n\nexport interface EmailTemplatesCardProps {\n  /** The site the section is read under, or `null` at the organization level. */\n  hostId: string | null\n  org?: Partial<AglynOrgBilling> | null\n}\n\n/**\n * \"Email templates\" — the letters the team keeps for **Send email**\n * (AGL-2658): every template and snippet this member can use, with a\n * drawer to write one and a row menu to edit or delete it.\n *\n * ## Whose card this is\n *\n * Unlike the switches above it, which the org's owner or admin alone may\n * move, this card is every CRM editor's: a template is working material,\n * not policy. The rules gate the rest — a shared row is any editor's, a\n * personal row its owner's — and a colleague's personal rows are not\n * listed here at all, so every row on screen is one this member may\n * change.\n *\n * ## Where a new template lands\n *\n * Under a site, in that site's scope; from the organization's own hub, in\n * the org's — the same rule the send dialog's Save as template follows\n * (`useCrmEmailTemplateScope`). A personal template is owned by its\n * writer; switching one to shared drops the owner, and back to personal\n * makes the member editing it the owner.\n */\nexport function EmailTemplatesCard(props: EmailTemplatesCardProps) {\n  const { hostId, org } = props\n  const firestore = useFirestore()\n  const { enqueueSnackbar } = useSnackbar()\n  const { confirm } = useConfirmationContext()\n  const { data: user } = useUser()\n  const uid = user?.uid ?? null\n  const templateScope = useCrmEmailTemplateScope({ hostId, org })\n  const { scope, ready: scopeReady } = templateScope\n  const { templates, ready } = useCrmEmailTemplates({\n    scope,\n    visibleTo: templateScope.visibleTo,\n    uid,\n  })\n  // Duplicate (AGL-2936): through the plugin's own door, which files the\n  // copy under this person and keeps the original's scope.\n  const callCrm = useCrmApi(hostId ?? null)\n  const duplicate = useDuplicateResource({\n    hostId: hostId ?? '',\n    perform: async ({ sourceId, name, attemptKey }) => {\n      const { response, payload } = await callCrm('email-template-duplicate', {\n        templateId: sourceId,\n        name,\n        attemptKey,\n      })\n      if (!response.ok) throw new Error(payload?.error ?? 'Duplicate failed')\n      return {\n        id: String(payload.templateId),\n        versionId: null,\n        name: String(payload.name ?? name),\n      }\n    },\n    onDuplicated: (_kind, copy) =>\n      enqueueSnackbar(`Duplicated as “${copy.name}”`, { variant: 'success', persist: false }),\n  })\n\n  const [drawerOpen, setDrawerOpen] = useState(false)\n  const [editing, setEditing] = useState<CrmEmailTemplateRow | null>(null)\n  const [busyId, setBusyId] = useState('')\n\n  const templateRef = useCallback(\n    (id: string) => {\n      if (!scope) throw new Error('an email template needs an organization')\n      return doc(firestore, scope[0], scope[1], CRM_COLLECTIONS.emailTemplates, id)\n    },\n    [firestore, scope],\n  )\n\n  const openCreate = useCallback(() => {\n    setEditing(null)\n    setDrawerOpen(true)\n  }, [])\n  const openEdit = useCallback((template: CrmEmailTemplateRow) => {\n    setEditing(template)\n    setDrawerOpen(true)\n  }, [])\n\n  const handleSubmit = useCallback(\n    async (draft: EmailTemplateDraft) => {\n      if (!scope || !uid) return\n      const now = Date.now()\n      const ownership =\n        draft.visibility === 'personal' ? { ownerUid: uid } : { ownerUid: deleteField() }\n      if (editing) {\n        await updateDoc(templateRef(editing.$id), {\n          name: draft.name,\n          kind: draft.kind,\n          visibility: draft.visibility,\n          subject: draft.subject,\n          body: draft.body,\n          ...ownership,\n          updatedAtMs: now,\n          updatedAt: new Date(now),\n        })\n        enqueueSnackbar('Template saved', { variant: 'success', persist: false })\n      } else {\n        await setDoc(\n          doc(\n            collection(firestore, scope[0], scope[1], CRM_COLLECTIONS.emailTemplates),\n            createResourceUid(),\n          ),\n          {\n            name: draft.name,\n            kind: draft.kind,\n            visibility: draft.visibility,\n            subject: draft.subject,\n            body: draft.body,\n            ...(draft.visibility === 'personal' ? { ownerUid: uid } : {}),\n            createdByUid: uid,\n            createdAtMs: now,\n            updatedAtMs: now,\n            hostId: templateScope.createHostId,\n            visibleTo: [...templateScope.createTokens],\n            createdAt: new Date(now),\n            updatedAt: new Date(now),\n          },\n        )\n        enqueueSnackbar(`Template \"${draft.name}\" added`, { variant: 'success', persist: false })\n      }\n      setDrawerOpen(false)\n      setEditing(null)\n    },\n    [scope, uid, editing, templateRef, enqueueSnackbar, firestore, templateScope],\n  )\n\n  const handleDelete = useCallback(\n    async (template: CrmEmailTemplateRow) => {\n      if (!scope || busyId) return\n      const accepted = await confirm({\n        title: `Delete \"${template.name}\"?`,\n        description:\n          template.kind === 'snippet'\n            ? 'The snippet is removed for everyone it is listed for. Emails already sent are not changed.'\n            : 'The template is removed for everyone it is listed for. Emails already sent are not changed.',\n        confirmationText: 'Delete',\n        confirmationButtonProps: { color: 'error' },\n      })\n        .then(() => true)\n        .catch(() => false)\n      if (!accepted) return\n      setBusyId(template.$id)\n      try {\n        await deleteDoc(templateRef(template.$id))\n        enqueueSnackbar('Template deleted', { variant: 'success', persist: false })\n      } catch (error) {\n        console.error(error)\n        enqueueSnackbar('An error has occurred', { variant: 'error', allowDuplicate: true })\n      } finally {\n        setBusyId('')\n      }\n    },\n    [scope, busyId, confirm, templateRef, enqueueSnackbar],\n  )\n\n  const rowActions = (template: CrmEmailTemplateRow): RowActionsMenuItem[] => [\n    {\n      key: 'edit',\n      label: 'Edit',\n      icon: <MdiIcon path={mdiPencilOutline.path} size={0.8} />,\n      onClick: () => openEdit(template),\n    },\n    {\n      key: 'duplicate',\n      label: DUPLICATE_MENU_LABEL,\n      icon: <MdiIcon path={mdiContentCopy.path} size={0.8} />,\n      onClick: () =>\n        duplicate.request('emailTemplate', { id: template.$id, name: template.name }),\n    },\n    {\n      key: 'delete',\n      label: 'Delete',\n      icon: <MdiIcon path={mdiDeleteOutline.path} size={0.8} />,\n      destructive: true,\n      disabled: Boolean(busyId),\n      onClick: () => void handleDelete(template),\n    },\n  ]\n\n  const atCap = templates.length >= CRM_EMAIL_TEMPLATES_LIMIT\n  const canCreate = Boolean(scope) && Boolean(uid) && !atCap\n  return (\n    <CardDisplay\n      header={'Email templates'}\n      help={pluginDocsHelp('crmEmailTemplates', { anchor: '#managing-templates' })}\n      contentGutterX\n      contentGutterY\n      contentBordered=\"all\"\n      HeaderProps={{\n        action: (\n          <Button variant=\"contained\" disabled={!canCreate} onClick={openCreate}>\n            {'New template'}\n          </Button>\n        ),\n      }}\n    >\n      {duplicate.dialog}\n      <Stack spacing={2}>\n        <Typography variant=\"body2\" color=\"text.secondary\">\n          {'The letters your team sends from a record. A template fills in the ' +\n            'subject and the message of Send email; a snippet drops a paragraph ' +\n            'in where the cursor is. Merge fields such as {{contact.firstName}} ' +\n            'are filled in from the record when the email is sent.'}\n        </Typography>\n        {scopeReady && !scope ? (\n          <Typography variant=\"body2\" color=\"text.secondary\">\n            {'This site has no organization, so it has no email templates.'}\n          </Typography>\n        ) : !ready ? null : templates.length === 0 ? (\n          <EmptyStateComponent\n            label={'No templates yet'}\n            description={'Write one here, or save an email you are about to send as a template.'}\n            action={\n              canCreate ? (\n                <Button variant=\"contained\" onClick={openCreate}>\n                  {'New template'}\n                </Button>\n              ) : undefined\n            }\n          />\n        ) : (\n          <ScrollTable size=\"small\">\n            <TableHead>\n              <TableRow>\n                <TableCell>{'Name'}</TableCell>\n                <TableCell>{'Kind'}</TableCell>\n                <TableCell>{'For'}</TableCell>\n                <TableCell>{'Subject'}</TableCell>\n                <TableCell align=\"right\" />\n              </TableRow>\n            </TableHead>\n            <TableBody>\n              {templates.map((template) => (\n                <TableRow key={template.$id} hover>\n                  <TableCell>\n                    <Typography variant=\"body2\">{template.name}</Typography>\n                  </TableCell>\n                  <TableCell>\n                    <Typography variant=\"body2\">\n                      {CRM_EMAIL_TEMPLATE_KIND_LABELS[template.kind]}\n                    </Typography>\n                  </TableCell>\n                  <TableCell>\n                    <Chip\n                      size=\"small\"\n                      variant={template.visibility === 'personal' ? 'outlined' : 'filled'}\n                      label={CRM_EMAIL_TEMPLATE_VISIBILITY_LABELS[template.visibility]}\n                    />\n                  </TableCell>\n                  <TableCell>\n                    <Typography variant=\"body2\" color=\"text.secondary\" noWrap>\n                      {template.kind === 'template' ? template.subject || '—' : template.body}\n                    </Typography>\n                  </TableCell>\n                  <TableCell align=\"right\" sx={{ width: 56 }}>\n                    <RowActionsMenu label={template.name} items={rowActions(template)} />\n                  </TableCell>\n                </TableRow>\n              ))}\n            </TableBody>\n          </ScrollTable>\n        )}\n        {atCap ? (\n          <Typography variant=\"caption\" color=\"text.secondary\">\n            {`A workspace keeps at most ${CRM_EMAIL_TEMPLATES_LIMIT} templates and snippets. Delete one to add another.`}\n          </Typography>\n        ) : null}\n      </Stack>\n      <EmailTemplateDrawer\n        open={drawerOpen}\n        onClose={() => setDrawerOpen(false)}\n        template={editing}\n        onSubmit={handleSubmit}\n      />\n    </CardDisplay>\n  )\n}\nEmailTemplatesCard.displayName = 'EmailTemplatesCard'\n\nexport default EmailTemplatesCard\n"],"names":["CRM_COLLECTIONS","CRM_EMAIL_TEMPLATE_KIND_LABELS","CRM_EMAIL_TEMPLATE_VISIBILITY_LABELS","CRM_EMAIL_TEMPLATES_LIMIT","createResourceUid","pluginDocsHelp","mdiContentCopy","mdiDeleteOutline","mdiPencilOutline","EmptyStateComponent","CardDisplay","MdiIcon","useConfirmationContext","RowActionsMenu","ScrollTable","useSnackbar","DUPLICATE_MENU_LABEL","useDuplicateResource","useFirestore","useUser","useCrmApi","Button","Chip","Stack","TableBody","TableCell","TableHead","TableRow","Typography","collection","deleteDoc","deleteField","doc","setDoc","updateDoc","useCallback","useState","useCrmEmailTemplates","useCrmEmailTemplateScope","EmailTemplateDrawer","EmailTemplatesCard","props","hostId","org","firestore","enqueueSnackbar","confirm","data","user","uid","templateScope","scope","ready","scopeReady","templates","visibleTo","callCrm","duplicate","perform","sourceId","name","attemptKey","payload","response","templateId","ok","Error","error","id","String","versionId","onDuplicated","_kind","copy","variant","persist","drawerOpen","setDrawerOpen","editing","setEditing","busyId","setBusyId","templateRef","emailTemplates","openCreate","openEdit","template","handleSubmit","draft","now","Date","ownership","visibility","ownerUid","$id","kind","subject","body","updatedAtMs","updatedAt","createdByUid","createdAtMs","createHostId","createTokens","createdAt","handleDelete","accepted","title","description","confirmationText","confirmationButtonProps","color","then","catch","console","allowDuplicate","rowActions","key","label","icon","path","size","onClick","request","destructive","disabled","Boolean","atCap","length","canCreate","header","help","anchor","contentGutterX","contentGutterY","contentBordered","HeaderProps","action","dialog","spacing","undefined","align","map","hover","noWrap","sx","width","items","open","onClose","onSubmit","displayName"],"mappings":"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"}

package/src/lib/components/erase-person-action.d.ts

@@ -0,0 +1,92 @@
+import type { RowActionsMenuItem } from '@aglyn/shared-ui-jsx/components/row-actions-menu.component';
+import { type ReactNode } from 'react';
+/** The record the action is offered on: which kind, its id, and its address. */
+export type ErasePersonSubject = {
+    kind: 'contact';
+    id: string;
+    email: string;
+} | {
+    kind: 'lead';
+    id: string;
+    email: string;
+};
+export interface UseErasePersonActionProps {
+    /**
+     * The site the request is filed from — the route logs it on that site's
+     * feed. At the organization level the record's own capturing site
+     * (AGL-2630), or `null` for a record no site has captured: beneath the
+     * org hub's mount the route's org variant files it anyway (AGL-2634), and
+     * only a surface mounted nowhere holds the item.
+     */
+    hostId: string | null;
+    orgId: string | null | undefined;
+    /** Null while the record has not loaded; the item is then disabled. */
+    subject: ErasePersonSubject | null;
+    /** The record's marker, when a request is already waiting. */
+    requestedAtMs: number | null;
+}
+export interface ErasePersonAction {
+    /** Zero or one item, to spread into the record header's overflow menu. */
+    menuItems: RowActionsMenuItem[];
+    /** The pending banner, or null. Render it where the record's cards begin. */
+    banner: ReactNode;
+    /** The dialog. Render it once, anywhere in the page. */
+    dialog: ReactNode;
+    /**
+     * When the waiting request was filed, or null while none waits: the
+     * record's marker, or the route's answer until the listener carries the
+     * marker. What a page gates its other acts on — Convert, on a lead — so
+     * they close the moment the item does.
+     */
+    pendingSinceMs: number | null;
+}
+/**
+ * **Erase this person** on a record page (AGL-2623).
+ *
+ * Owned by a hook rather than a component because the overflow menu takes
+ * items as data: the page spreads `menuItems` into its own list, renders
+ * `banner` under the header and `dialog` at the end, and everything the
+ * action knows — who may, whether a request is already waiting, what the
+ * dialog says, what the route answers — lives here.
+ *
+ * Offered to workspace admins and owners only, and the item is present but
+ * disabled for everyone else with the reason as its tooltip: an absent item
+ * and an inapplicable one look alike, and a site editor who cannot find
+ * the action should learn who can rather than conclude it does not exist.
+ *
+ * Takes the site from the page and the workspace from `useOrgDataScope`,
+ * never a route, so an org-level mount can offer the same item.
+ */
+export declare function useErasePersonAction(props: UseErasePersonActionProps): ErasePersonAction;
+export interface ErasurePendingBannerProps {
+    requestedAtMs: number;
+}
+/**
+ * The state a record wears between the request and the run. Says when it
+ * was asked and what will happen, so a reader arriving cold neither files
+ * it again nor keeps working the record.
+ */
+export declare function ErasurePendingBanner(props: ErasurePendingBannerProps): import("react").JSX.Element;
+export declare namespace ErasurePendingBanner {
+    var displayName: string;
+}
+export interface ErasePersonDialogProps {
+    open: boolean;
+    onClose: () => void;
+    /** The site the request is filed from, or `null` beneath the org hub's mount. */
+    hostId: string | null;
+    subject: ErasePersonSubject;
+    /** Called with the request's queue time once the route has filed it. */
+    onFiled: (pendingSinceMs: number) => void;
+}
+/**
+ * The confirmation: everything the request removes, everything it keeps
+ * and how, what it does not reach, and the two facts that follow the click
+ * — the address is closed to capture at once, and the sweep runs with the
+ * nightly job. The admin types the address back; the route checks the same
+ * match before it files anything.
+ */
+export declare function ErasePersonDialog(props: ErasePersonDialogProps): import("react").JSX.Element;
+export declare namespace ErasePersonDialog {
+    var displayName: string;
+}