@aglyn/plugins-email 1.0.0-beta.143

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

@@ -0,0 +1,327 @@
+/**
+ * @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 { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { createResourceUid, isEmailTopicId, pluginDocsHelp, DEFAULT_EMAIL_TOPICS, EMAIL_TOPICS_COLLECTION } from "@aglyn/aglyn";
+import { mdiArchiveArrowUpOutline, mdiArchiveOutline, mdiPencilOutline } from "@aglyn/shared-data-mdi";
+import { AppLink, CardDisplay, MdiIcon, useConfirmationContext } from "@aglyn/shared-ui-jsx";
+import RowActionsMenu from "@aglyn/shared-ui-jsx/components/row-actions-menu.component";
+import { CreateArtifactDrawer } from "@aglyn/shared-ui-jsx-forms";
+import { ScrollTable } from "@aglyn/shared-ui-jsx/components/scroll-table.component";
+import { useSnackbar } from "@aglyn/shared-ui-snackstack";
+import { Button, Chip, Stack, TableBody, TableCell, TableHead, TableRow, Typography } from "@mui/material";
+import { doc, setDoc } from "firebase/firestore";
+import { useRouter } from "next/navigation";
+import { useCallback, useState } from "react";
+import { useFirestore } from "@aglyn/tenant-feature-instance";
+import { useOrgEmailTopics, writeEmailTopic } from "./use-org-email-topics.js";
+/**
+ * Email topics: the streams a recipient can leave one at a time.
+ *
+ * ## What this closes
+ *
+ * `docs/specs/email-competitive-gaps.md` §1f is a table of what six
+ * competitors have, and the preference-center row was the one where every one
+ * of them had something and we had nothing: unsubscribe was all-or-nothing per
+ * site. This card is the merchant's half of the fix — the recipient's half is
+ * the hosted preference page the campaign footer now links to.
+ *
+ * ## Why the four built-ins are not documents
+ *
+ * Every org that exists today has an empty `emailTopics` collection, and a
+ * seeding migration would leave any org created while it ran with none. So
+ * `DEFAULT_EMAIL_TOPICS` is the FLOOR of the catalog rather than its initial
+ * contents: the four are present for every org with no write anywhere, and
+ * saving one on its detail page writes a document at the same id that renames
+ * or retires it. A built-in with no stored document is not a missing row, it
+ * is a row nobody has needed to change.
+ *
+ * ## Create is a drawer; edit is the topic's own page
+ *
+ * The console's standing shape for a list surface: creating opens the shared
+ * `CreateArtifactDrawer`, the same one Screens, Components, Layouts and
+ * Templates use, and changing an existing record happens on that record's
+ * page rather than in a form stacked above the table. So this card lists and
+ * routes, and `email-topic-detail.tsx` edits.
+ *
+ * ## The row grammar the rest of the surface uses
+ *
+ * The same one the audiences table sets: the row opens the topic, the topic's
+ * name is ALSO a real link so it can be middle-clicked and copied, and the
+ * secondary actions sit behind the shared `RowActionsMenu` rather than as text
+ * buttons in the row. Retire is the reason the menu has more than one entry —
+ * it is the only thing that can be done to a topic without opening it, and it
+ * is destructive enough that it should not sit one mis-click from the row's
+ * own open handler.
+ */ export function EmailTopicsCard(props) {
+    const { hostId, basePath } = props;
+    const firestore = useFirestore();
+    const router = useRouter();
+    const { enqueueSnackbar } = useSnackbar();
+    const { confirm } = useConfirmationContext();
+    const { topics, scope } = useOrgEmailTopics(hostId);
+    const [drawerOpen, setDrawerOpen] = useState(false);
+    const [error, setError] = useState(null);
+    const [busyTopicId, setBusyTopicId] = useState('');
+    /** The topic's own page, which is also its edit page. */ const topicHref = useCallback((topicId)=>`${basePath}/topics/${topicId}`, [
+        basePath
+    ]);
+    const create = useCallback(async (values)=>{
+        var _ref;
+        if (!scope) return;
+        const name = String((_ref = values == null ? void 0 : values.displayName) != null ? _ref : '').trim();
+        if (!name) return;
+        // `createResourceUid` is nanoid's `A-Za-z0-9_-`, so the id it mints
+        // always satisfies `isEmailTopicId`. Checked anyway, because this id is
+        // signed into every unsubscribe link the topic ever mints and the send
+        // path refuses one that is not usable — a topic nothing can be sent
+        // under is a row the merchant would have no way to diagnose.
+        const id = createResourceUid();
+        if (!isEmailTopicId(id)) {
+            return void enqueueSnackbar('Could not create the topic', {
+                variant: 'error'
+            });
+        }
+        try {
+            var _ref1;
+            await setDoc(doc(firestore, scope[0], scope[1], EMAIL_TOPICS_COLLECTION, id), {
+                name,
+                description: String((_ref1 = values == null ? void 0 : values.description) != null ? _ref1 : '').trim(),
+                archived: false
+            });
+            setDrawerOpen(false);
+            setError(null);
+            enqueueSnackbar('Topic added', {
+                variant: 'success',
+                persist: false
+            });
+            // Straight to the record, which is where every further change is made.
+            router.push(topicHref(id));
+        } catch (caught) {
+            console.error(caught);
+            setError(caught);
+        }
+    }, [
+        scope,
+        firestore,
+        enqueueSnackbar,
+        topicHref,
+        router
+    ]);
+    /**
+   * Retire a topic, or bring one back.
+   *
+   * Retire and not delete: campaigns already sent under a topic minted
+   * unsubscribe links carrying its id, those links are sitting in inboxes, and
+   * an id that stops resolving is a preference page that cannot name the
+   * message the recipient is holding. The Firestore rules refuse a delete for
+   * the same reason.
+   *
+   * Restoring is not asked about — it puts a choice back rather than taking
+   * one away, and it is undone by retiring again.
+   */ const toggleArchived = useCallback(async (topic)=>{
+        if (!scope || busyTopicId) return;
+        if (!topic.archived) {
+            const accepted = await confirm({
+                title: `Retire “${topic.name}”?`,
+                description: 'It leaves the composer and the preference page, so nothing new ' + 'can be sent under it and recipients stop seeing it as a choice. ' + 'Campaigns already sent under it keep working — their ' + 'unsubscribe links still name this topic. You can bring it back ' + 'at any time.',
+                confirmationText: 'Retire'
+            })// `confirm` resolves with NO VALUE and REJECTS on cancel, so gating
+            // on the resolved value alone makes this always return (AGL-950).
+            .then(()=>true).catch(()=>false);
+            if (!accepted) return;
+        }
+        setBusyTopicId(topic.id);
+        try {
+            await writeEmailTopic(firestore, scope, {
+                id: topic.id,
+                name: topic.name,
+                description: topic.description,
+                archived: !topic.archived
+            });
+            enqueueSnackbar(topic.archived ? 'Topic restored' : 'Topic retired', {
+                variant: 'success',
+                persist: false
+            });
+        } catch (caught) {
+            console.error(caught);
+            enqueueSnackbar('An error has occurred', {
+                variant: 'error'
+            });
+        } finally{
+            setBusyTopicId('');
+        }
+    }, [
+        scope,
+        busyTopicId,
+        confirm,
+        firestore,
+        enqueueSnackbar
+    ]);
+    const rowActions = (topic)=>[
+            {
+                key: 'edit',
+                label: 'Edit topic',
+                icon: /*#__PURE__*/ _jsx(MdiIcon, {
+                    path: mdiPencilOutline.path,
+                    size: 0.8
+                }),
+                href: topicHref(topic.id)
+            },
+            {
+                key: 'archive',
+                label: topic.archived ? 'Restore' : 'Retire',
+                icon: /*#__PURE__*/ _jsx(MdiIcon, {
+                    path: topic.archived ? mdiArchiveArrowUpOutline.path : mdiArchiveOutline.path,
+                    size: 0.8
+                }),
+                destructive: !topic.archived,
+                disabled: Boolean(busyTopicId),
+                disabledReason: busyTopicId ? 'Another topic is being saved' : undefined,
+                onClick: ()=>void toggleArchived(topic)
+            }
+        ];
+    return /*#__PURE__*/ _jsxs(CardDisplay, {
+        header: "Topics",
+        help: pluginDocsHelp('emailCampaigns', {
+            anchor: '#topics'
+        }),
+        contentGutterX: true,
+        contentGutterY: true,
+        contentBordered: "all",
+        HeaderProps: {
+            action: scope ? /*#__PURE__*/ _jsx(Button, {
+                variant: "contained",
+                onClick: ()=>setDrawerOpen(true),
+                children: 'New topic'
+            }) : null
+        },
+        children: [
+            /*#__PURE__*/ _jsxs(Stack, {
+                spacing: 2,
+                children: [
+                    /*#__PURE__*/ _jsx(Typography, {
+                        variant: "body2",
+                        color: "text.secondary",
+                        children: 'The streams your recipients can leave one at a time. Every ' + 'campaign belongs to one, and the preference page linked from ' + 'each email lets someone stop that stream without stopping ' + 'everything. Topics are shared across every site in this ' + 'organization, the same way your lists are.'
+                    }),
+                    !scope ? /*#__PURE__*/ _jsx(Typography, {
+                        variant: "body2",
+                        color: "text.secondary",
+                        children: 'This site has no organization, so it has no topic list.'
+                    }) : /*#__PURE__*/ _jsxs(ScrollTable, {
+                        size: "small",
+                        children: [
+                            /*#__PURE__*/ _jsx(TableHead, {
+                                children: /*#__PURE__*/ _jsxs(TableRow, {
+                                    children: [
+                                        /*#__PURE__*/ _jsx(TableCell, {
+                                            children: 'Topic'
+                                        }),
+                                        /*#__PURE__*/ _jsx(TableCell, {
+                                            children: 'What recipients are told they get'
+                                        }),
+                                        /*#__PURE__*/ _jsx(TableCell, {
+                                            align: "right"
+                                        })
+                                    ]
+                                })
+                            }),
+                            /*#__PURE__*/ _jsx(TableBody, {
+                                children: topics.map((topic)=>{
+                                    const href = topicHref(topic.id);
+                                    return /*#__PURE__*/ _jsxs(TableRow, {
+                                        hover: true,
+                                        onClick: ()=>router.push(href),
+                                        sx: {
+                                            cursor: 'pointer'
+                                        },
+                                        children: [
+                                            /*#__PURE__*/ _jsx(TableCell, {
+                                                children: /*#__PURE__*/ _jsxs(Stack, {
+                                                    direction: "row",
+                                                    spacing: 1,
+                                                    sx: {
+                                                        flexWrap: 'wrap',
+                                                        alignItems: 'center'
+                                                    },
+                                                    children: [
+                                                        /*#__PURE__*/ _jsx(AppLink, {
+                                                            href: href,
+                                                            onClick: (event)=>event.stopPropagation(),
+                                                            children: topic.name
+                                                        }),
+                                                        topic.archived ? /*#__PURE__*/ _jsx(Chip, {
+                                                            size: "small",
+                                                            variant: "outlined",
+                                                            color: "warning",
+                                                            label: "Retired"
+                                                        }) : null,
+                                                        DEFAULT_EMAIL_TOPICS.some((it)=>it.id === topic.id) ? /*#__PURE__*/ _jsx(Typography, {
+                                                            variant: "overline",
+                                                            color: "text.secondary",
+                                                            children: 'Built in'
+                                                        }) : null
+                                                    ]
+                                                })
+                                            }),
+                                            /*#__PURE__*/ _jsx(TableCell, {
+                                                children: /*#__PURE__*/ _jsx(Typography, {
+                                                    variant: "body2",
+                                                    color: "text.secondary",
+                                                    children: topic.description || '—'
+                                                })
+                                            }),
+                                            /*#__PURE__*/ _jsx(TableCell, {
+                                                align: "right",
+                                                sx: {
+                                                    width: 56
+                                                },
+                                                onClick: (event)=>event.stopPropagation(),
+                                                children: /*#__PURE__*/ _jsx(RowActionsMenu, {
+                                                    label: topic.name,
+                                                    items: rowActions(topic)
+                                                })
+                                            })
+                                        ]
+                                    }, topic.id);
+                                })
+                            })
+                        ]
+                    })
+                ]
+            }),
+            /*#__PURE__*/ _jsx(CreateArtifactDrawer, {
+                open: drawerOpen,
+                onClose: ()=>setDrawerOpen(false),
+                title: "New email topic",
+                submitLabel: "Create topic",
+                onSubmit: create,
+                errorSlot: error ? /*#__PURE__*/ _jsx(Typography, {
+                    variant: "body2",
+                    color: "error",
+                    sx: {
+                        mt: 2
+                    },
+                    children: 'Could not create the topic. Try again.'
+                }) : null
+            })
+        ]
+    });
+}
+export default EmailTopicsCard;
+
+//# sourceMappingURL=email-topics-card.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/email/src/lib/components/email-topics-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  createResourceUid,\n  isEmailTopicId,\n  pluginDocsHelp,\n  DEFAULT_EMAIL_TOPICS,\n  EMAIL_TOPICS_COLLECTION,\n} from '@aglyn/aglyn'\nimport {\n  mdiArchiveArrowUpOutline,\n  mdiArchiveOutline,\n  mdiPencilOutline,\n} from '@aglyn/shared-data-mdi'\nimport {\n  AppLink,\n  CardDisplay,\n  MdiIcon,\n  useConfirmationContext,\n} from '@aglyn/shared-ui-jsx'\nimport RowActionsMenu, {\n  type RowActionsMenuItem,\n} from '@aglyn/shared-ui-jsx/components/row-actions-menu.component'\nimport { CreateArtifactDrawer } from '@aglyn/shared-ui-jsx-forms'\nimport { ScrollTable } from '@aglyn/shared-ui-jsx/components/scroll-table.component'\nimport { useSnackbar } from '@aglyn/shared-ui-snackstack'\nimport {\n  Button,\n  Chip,\n  Stack,\n  TableBody,\n  TableCell,\n  TableHead,\n  TableRow,\n  Typography,\n} from '@mui/material'\nimport { doc, setDoc } from 'firebase/firestore'\nimport { useRouter } from 'next/navigation'\nimport { useCallback, useState } from 'react'\nimport { useFirestore } from '@aglyn/tenant-feature-instance'\nimport { useOrgEmailTopics, writeEmailTopic } from './use-org-email-topics'\n\nexport interface EmailTopicsCardProps {\n  hostId: string\n  /** The emails hub URL, which every topic route hangs beneath. */\n  basePath: string\n}\n\n/**\n * Email topics: the streams a recipient can leave one at a time.\n *\n * ## What this closes\n *\n * `docs/specs/email-competitive-gaps.md` §1f is a table of what six\n * competitors have, and the preference-center row was the one where every one\n * of them had something and we had nothing: unsubscribe was all-or-nothing per\n * site. This card is the merchant's half of the fix — the recipient's half is\n * the hosted preference page the campaign footer now links to.\n *\n * ## Why the four built-ins are not documents\n *\n * Every org that exists today has an empty `emailTopics` collection, and a\n * seeding migration would leave any org created while it ran with none. So\n * `DEFAULT_EMAIL_TOPICS` is the FLOOR of the catalog rather than its initial\n * contents: the four are present for every org with no write anywhere, and\n * saving one on its detail page writes a document at the same id that renames\n * or retires it. A built-in with no stored document is not a missing row, it\n * is a row nobody has needed to change.\n *\n * ## Create is a drawer; edit is the topic's own page\n *\n * The console's standing shape for a list surface: creating opens the shared\n * `CreateArtifactDrawer`, the same one Screens, Components, Layouts and\n * Templates use, and changing an existing record happens on that record's\n * page rather than in a form stacked above the table. So this card lists and\n * routes, and `email-topic-detail.tsx` edits.\n *\n * ## The row grammar the rest of the surface uses\n *\n * The same one the audiences table sets: the row opens the topic, the topic's\n * name is ALSO a real link so it can be middle-clicked and copied, and the\n * secondary actions sit behind the shared `RowActionsMenu` rather than as text\n * buttons in the row. Retire is the reason the menu has more than one entry —\n * it is the only thing that can be done to a topic without opening it, and it\n * is destructive enough that it should not sit one mis-click from the row's\n * own open handler.\n */\nexport function EmailTopicsCard(props: EmailTopicsCardProps) {\n  const { hostId, basePath } = props\n  const firestore = useFirestore()\n  const router = useRouter()\n  const { enqueueSnackbar } = useSnackbar()\n  const { confirm } = useConfirmationContext()\n  const { topics, scope } = useOrgEmailTopics(hostId)\n\n  const [drawerOpen, setDrawerOpen] = useState(false)\n  const [error, setError] = useState<unknown>(null)\n  const [busyTopicId, setBusyTopicId] = useState('')\n\n  /** The topic's own page, which is also its edit page. */\n  const topicHref = useCallback(\n    (topicId: string) => `${basePath}/topics/${topicId}`,\n    [basePath],\n  )\n\n  const create = useCallback(\n    async (values: Record<string, any>) => {\n      if (!scope) return\n      const name = String(values?.displayName ?? '').trim()\n      if (!name) return\n      // `createResourceUid` is nanoid's `A-Za-z0-9_-`, so the id it mints\n      // always satisfies `isEmailTopicId`. Checked anyway, because this id is\n      // signed into every unsubscribe link the topic ever mints and the send\n      // path refuses one that is not usable — a topic nothing can be sent\n      // under is a row the merchant would have no way to diagnose.\n      const id = createResourceUid()\n      if (!isEmailTopicId(id)) {\n        return void enqueueSnackbar('Could not create the topic', {\n          variant: 'error',\n        })\n      }\n      try {\n        await setDoc(\n          doc(firestore, scope[0], scope[1], EMAIL_TOPICS_COLLECTION, id),\n          {\n            name,\n            description: String(values?.description ?? '').trim(),\n            archived: false,\n          },\n        )\n        setDrawerOpen(false)\n        setError(null)\n        enqueueSnackbar('Topic added', { variant: 'success', persist: false })\n        // Straight to the record, which is where every further change is made.\n        router.push(topicHref(id))\n      } catch (caught) {\n        console.error(caught)\n        setError(caught)\n      }\n    },\n    [scope, firestore, enqueueSnackbar, topicHref, router],\n  )\n\n  /**\n   * Retire a topic, or bring one back.\n   *\n   * Retire and not delete: campaigns already sent under a topic minted\n   * unsubscribe links carrying its id, those links are sitting in inboxes, and\n   * an id that stops resolving is a preference page that cannot name the\n   * message the recipient is holding. The Firestore rules refuse a delete for\n   * the same reason.\n   *\n   * Restoring is not asked about — it puts a choice back rather than taking\n   * one away, and it is undone by retiring again.\n   */\n  const toggleArchived = useCallback(\n    async (topic: { id: string; name: string; description: string; archived?: boolean }) => {\n      if (!scope || busyTopicId) return\n      if (!topic.archived) {\n        const accepted = await confirm({\n          title: `Retire “${topic.name}”?`,\n          description:\n            'It leaves the composer and the preference page, so nothing new ' +\n            'can be sent under it and recipients stop seeing it as a choice. ' +\n            'Campaigns already sent under it keep working — their ' +\n            'unsubscribe links still name this topic. You can bring it back ' +\n            'at any time.',\n          confirmationText: 'Retire',\n        })\n          // `confirm` resolves with NO VALUE and REJECTS on cancel, so gating\n          // on the resolved value alone makes this always return (AGL-950).\n          .then(() => true)\n          .catch(() => false)\n        if (!accepted) return\n      }\n      setBusyTopicId(topic.id)\n      try {\n        await writeEmailTopic(firestore, scope, {\n          id: topic.id,\n          name: topic.name,\n          description: topic.description,\n          archived: !topic.archived,\n        })\n        enqueueSnackbar(topic.archived ? 'Topic restored' : 'Topic retired', {\n          variant: 'success',\n          persist: false,\n        })\n      } catch (caught) {\n        console.error(caught)\n        enqueueSnackbar('An error has occurred', { variant: 'error' })\n      } finally {\n        setBusyTopicId('')\n      }\n    },\n    [scope, busyTopicId, confirm, firestore, enqueueSnackbar],\n  )\n\n  const rowActions = (topic: {\n    id: string\n    name: string\n    description: string\n    archived?: boolean\n  }): RowActionsMenuItem[] => [\n    {\n      key: 'edit',\n      label: 'Edit topic',\n      icon: <MdiIcon path={mdiPencilOutline.path} size={0.8} />,\n      href: topicHref(topic.id),\n    },\n    {\n      key: 'archive',\n      label: topic.archived ? 'Restore' : 'Retire',\n      icon: (\n        <MdiIcon\n          path={\n            topic.archived\n              ? mdiArchiveArrowUpOutline.path\n              : mdiArchiveOutline.path\n          }\n          size={0.8}\n        />\n      ),\n      destructive: !topic.archived,\n      disabled: Boolean(busyTopicId),\n      disabledReason: busyTopicId ? 'Another topic is being saved' : undefined,\n      onClick: () => void toggleArchived(topic),\n    },\n  ]\n\n  return (\n    <CardDisplay\n      header=\"Topics\"\n      help={pluginDocsHelp('emailCampaigns', { anchor: '#topics' })}\n      contentGutterX\n      contentGutterY\n      contentBordered=\"all\"\n      HeaderProps={{\n        action: scope ? (\n          <Button variant=\"contained\" onClick={() => setDrawerOpen(true)}>\n            {'New topic'}\n          </Button>\n        ) : null,\n      }}\n    >\n      <Stack spacing={2}>\n        <Typography variant=\"body2\" color=\"text.secondary\">\n          {'The streams your recipients can leave one at a time. Every ' +\n            'campaign belongs to one, and the preference page linked from ' +\n            'each email lets someone stop that stream without stopping ' +\n            'everything. Topics are shared across every site in this ' +\n            'organization, the same way your lists are.'}\n        </Typography>\n        {!scope ? (\n          <Typography variant=\"body2\" color=\"text.secondary\">\n            {'This site has no organization, so it has no topic list.'}\n          </Typography>\n        ) : (\n          <ScrollTable size=\"small\">\n            <TableHead>\n              <TableRow>\n                <TableCell>{'Topic'}</TableCell>\n                <TableCell>{'What recipients are told they get'}</TableCell>\n                <TableCell align=\"right\" />\n              </TableRow>\n            </TableHead>\n            <TableBody>\n              {topics.map((topic) => {\n                const href = topicHref(topic.id)\n                return (\n                  <TableRow\n                    key={topic.id}\n                    hover\n                    onClick={() => router.push(href)}\n                    sx={{ cursor: 'pointer' }}\n                  >\n                    <TableCell>\n                      <Stack\n                        direction=\"row\"\n                        spacing={1}\n                        sx={{ flexWrap: 'wrap', alignItems: 'center' }}\n                      >\n                        {/*\n                          The row's own handler would fire too and push the\n                          same route twice — one history entry per back press.\n                         */}\n                        <AppLink\n                          href={href}\n                          onClick={(event: { stopPropagation: () => void }) =>\n                            event.stopPropagation()\n                          }\n                        >\n                          {topic.name}\n                        </AppLink>\n                        {topic.archived ? (\n                          <Chip\n                            size=\"small\"\n                            variant=\"outlined\"\n                            color=\"warning\"\n                            label=\"Retired\"\n                          />\n                        ) : null}\n                        {DEFAULT_EMAIL_TOPICS.some(\n                          (it) => it.id === topic.id,\n                        ) ? (\n                          <Typography\n                            variant=\"overline\"\n                            color=\"text.secondary\"\n                          >\n                            {'Built in'}\n                          </Typography>\n                        ) : null}\n                      </Stack>\n                    </TableCell>\n                    <TableCell>\n                      <Typography variant=\"body2\" color=\"text.secondary\">\n                        {topic.description || '—'}\n                      </Typography>\n                    </TableCell>\n                    <TableCell\n                      align=\"right\"\n                      sx={{ width: 56 }}\n                      onClick={(event) => event.stopPropagation()}\n                    >\n                      <RowActionsMenu\n                        label={topic.name}\n                        items={rowActions(topic)}\n                      />\n                    </TableCell>\n                  </TableRow>\n                )\n              })}\n            </TableBody>\n          </ScrollTable>\n        )}\n      </Stack>\n      <CreateArtifactDrawer\n        open={drawerOpen}\n        onClose={() => setDrawerOpen(false)}\n        title=\"New email topic\"\n        submitLabel=\"Create topic\"\n        onSubmit={create}\n        errorSlot={\n          error ? (\n            <Typography variant=\"body2\" color=\"error\" sx={{ mt: 2 }}>\n              {'Could not create the topic. Try again.'}\n            </Typography>\n          ) : null\n        }\n      />\n    </CardDisplay>\n  )\n}\n\nexport default EmailTopicsCard\n"],"names":["createResourceUid","isEmailTopicId","pluginDocsHelp","DEFAULT_EMAIL_TOPICS","EMAIL_TOPICS_COLLECTION","mdiArchiveArrowUpOutline","mdiArchiveOutline","mdiPencilOutline","AppLink","CardDisplay","MdiIcon","useConfirmationContext","RowActionsMenu","CreateArtifactDrawer","ScrollTable","useSnackbar","Button","Chip","Stack","TableBody","TableCell","TableHead","TableRow","Typography","doc","setDoc","useRouter","useCallback","useState","useFirestore","useOrgEmailTopics","writeEmailTopic","EmailTopicsCard","props","hostId","basePath","firestore","router","enqueueSnackbar","confirm","topics","scope","drawerOpen","setDrawerOpen","error","setError","busyTopicId","setBusyTopicId","topicHref","topicId","create","values","name","String","displayName","trim","id","variant","description","archived","persist","push","caught","console","toggleArchived","topic","accepted","title","confirmationText","then","catch","rowActions","key","label","icon","path","size","href","destructive","disabled","Boolean","disabledReason","undefined","onClick","header","help","anchor","contentGutterX","contentGutterY","contentBordered","HeaderProps","action","spacing","color","align","map","hover","sx","cursor","direction","flexWrap","alignItems","event","stopPropagation","some","it","width","items","open","onClose","submitLabel","onSubmit","errorSlot","mt"],"mappings":"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"}

package/src/lib/components/email-zones.d.ts

@@ -0,0 +1,28 @@
+/**
+ * The Messages section of the Emails page.
+ *
+ * A message is one email that was or will be sent. Writing one, scheduling
+ * it, sending it and reporting what came of it are a campaign's work — the
+ * routes that do all of it are served by whichever plugin owns campaigns — so
+ * this plugin hosts the section and that plugin draws it. What is handed over
+ * is what the shell handed this page: the site, this page's own base path,
+ * and the segments under `messages` (`[]` the list, `[id]` one message,
+ * `[id, 'edit']` its composer).
+ */
+export interface EmailMessagesZoneProps {
+    hostId: string;
+    basePath: string;
+    detail: readonly string[];
+}
+export declare const EMAIL_MESSAGES_ZONE: import("@aglyn/aglyn/plugin-manager/plugin-zones").PluginZone<EmailMessagesZoneProps>;
+/**
+ * Who received the messages built from one template, under its report.
+ *
+ * The template is this plugin's; the recipients of a send are read through
+ * the campaign owner's route, so the table is that plugin's to draw.
+ */
+export interface EmailTemplateRecipientsZoneProps {
+    hostId: string;
+    screenId: string;
+}
+export declare const EMAIL_TEMPLATE_RECIPIENTS_ZONE: import("@aglyn/aglyn/plugin-manager/plugin-zones").PluginZone<EmailTemplateRecipientsZoneProps>;

package/src/lib/components/email-zones.js

@@ -0,0 +1,20 @@
+/**
+ * @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.
+ */ import { definePluginZone } from "@aglyn/aglyn/plugin-manager/plugin-zones";
+export const EMAIL_MESSAGES_ZONE = definePluginZone('emailMessages');
+export const EMAIL_TEMPLATE_RECIPIENTS_ZONE = definePluginZone('emailTemplateRecipients');
+
+//# sourceMappingURL=email-zones.js.map

package/src/lib/components/email-zones.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/email/src/lib/components/email-zones.ts"],"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 */\nimport { definePluginZone } from '@aglyn/aglyn/plugin-manager/plugin-zones'\n\n/**\n * The Messages section of the Emails page.\n *\n * A message is one email that was or will be sent. Writing one, scheduling\n * it, sending it and reporting what came of it are a campaign's work — the\n * routes that do all of it are served by whichever plugin owns campaigns — so\n * this plugin hosts the section and that plugin draws it. What is handed over\n * is what the shell handed this page: the site, this page's own base path,\n * and the segments under `messages` (`[]` the list, `[id]` one message,\n * `[id, 'edit']` its composer).\n */\nexport interface EmailMessagesZoneProps {\n  hostId: string\n  basePath: string\n  detail: readonly string[]\n}\n\nexport const EMAIL_MESSAGES_ZONE =\n  definePluginZone<EmailMessagesZoneProps>('emailMessages')\n\n/**\n * Who received the messages built from one template, under its report.\n *\n * The template is this plugin's; the recipients of a send are read through\n * the campaign owner's route, so the table is that plugin's to draw.\n */\nexport interface EmailTemplateRecipientsZoneProps {\n  hostId: string\n  screenId: string\n}\n\nexport const EMAIL_TEMPLATE_RECIPIENTS_ZONE =\n  definePluginZone<EmailTemplateRecipientsZoneProps>('emailTemplateRecipients')\n"],"names":["definePluginZone","EMAIL_MESSAGES_ZONE","EMAIL_TEMPLATE_RECIPIENTS_ZONE"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GACD,SAASA,gBAAgB,QAAQ,2CAA0C;AAmB3E,OAAO,MAAMC,sBACXD,iBAAyC,iBAAgB;AAa3D,OAAO,MAAME,iCACXF,iBAAmD,2BAA0B"}

package/src/lib/components/emails-console-page.d.ts

@@ -0,0 +1,32 @@
+import { type ConsolePluginPageProps } from '@aglyn/aglyn';
+/**
+ * Emails page (AGL-395): the console surface owned by the email plugin,
+ * rendered by the shell's generic plugin route.
+ *
+ * Two of its sections are two different things a merchant calls "an email":
+ * an EMAIL is one message that was or will be sent, and a TEMPLATE is the
+ * reusable besigner document a message is built from. Keeping them apart is
+ * what lets each carry its own report — a message's own numbers, and a
+ * template's summed across every message sent from it. Audience lists, the
+ * topic catalog, the sending identities and the suppression list complete the
+ * surface.
+ *
+ * The CAMPAIGN that groups messages is not here. It is a container with a
+ * window of dates, a set of lists, a topic and revenue attribution — a
+ * marketing object that reaches people by email — so it is a section of the
+ * Marketing console, and a message's page links out to the campaign it
+ * belongs to.
+ *
+ * Sections are ROUTES (AGL-2501). `HubTabs lazy` already mounted one panel, so
+ * this is not a read saving — `emails-console-read-cost.spec.tsx` was written
+ * BEFORE the conversion precisely to hold that line, and reports the same
+ * counts after. What routing adds is that the URL names the section: it is
+ * linkable, the back button walks sections, the breadcrumb says where you are,
+ * and "mount only what is open" is structural rather than a `lazy` flag
+ * somebody has to remember on the next surface.
+ */
+export declare function EmailsConsolePage(props: ConsolePluginPageProps): import("react").JSX.Element;
+export declare namespace EmailsConsolePage {
+    var displayName: string;
+}
+export default EmailsConsolePage;