@aglyn/plugins-crm 1.0.0-beta.143

package/src/lib/components/tasks-section.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/crm/src/lib/components/tasks-section.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 ConsolePluginPageProps,\n  CRM_COLLECTIONS,\n  findOrgMember,\n  pluginDocsHelp,\n} from '@aglyn/aglyn'\nimport { CardDisplay } from '@aglyn/shared-ui-jsx'\nimport { ListTable } from '@aglyn/shared-ui-jsx/components/list-table.component'\nimport { useCrmSavedView } from '../hooks/use-crm-saved-view'\nimport { useCrmScope } from '../hooks/use-crm-scope'\nimport { useCrmViewGrid } from '../hooks/use-crm-view-grid'\nimport { CRM_LIST_SLOTS, CrmColumnOrderProvider } from './crm-column-menu'\nimport CrmViewsControl from './crm-views-control'\nimport EmptyStateComponent from '@aglyn/shared-ui-jsx/components/empty-state.component'\nimport { useSnackbar } from '@aglyn/shared-ui-snackstack'\nimport { useFirestore, useUser } from '@aglyn/tenant-feature-instance'\nimport {\n  Button,\n  Checkbox,\n  Stack,\n  ToggleButton,\n  ToggleButtonGroup,\n  Typography,\n} from '@mui/material'\nimport type { GridColDef } from '@mui/x-data-grid'\nimport { deleteField, doc, serverTimestamp, updateDoc } from 'firebase/firestore'\nimport { useCallback, useEffect, useMemo, useState } from 'react'\nimport { useCrmRecordNames } from '../hooks/use-crm-record-names'\nimport { type CrmTaskRow, useCrmTaskList, useNowMs } from '../hooks/use-crm-tasks'\nimport { useOrgMemberDirectory } from '../hooks/use-org-member-directory'\nimport { downloadTextFile } from '../model/contacts-csv'\nimport { crmRoutes } from '../model/crm-routes'\nimport { refreshCrmNextActivity } from '../model/next-activity-api'\nimport { completeCrmTask } from '../model/task-api'\nimport { crmTaskCallScope } from '../model/task-routes'\nimport { type TaskCsvOptions, tasksCsv } from '../model/tasks-csv'\nimport {\n  CRM_TASK_VIEW_LIMIT,\n  CRM_TASK_VIEWS,\n  type CrmTaskView,\n} from '../model/task-views'\nimport {\n  TaskDueText,\n  TaskKindCell,\n  TaskPriorityChip,\n  TaskRecordLink,\n} from './task-cells'\nimport TaskEditDrawer from './task-edit-drawer'\nimport TasksCalendar from './tasks-calendar'\nimport { TaskImportButton } from './task-import-drawer'\nimport TaskSnoozeMenu from './task-snooze-menu'\nimport TasksBulkBar from './tasks-bulk-bar'\n\n/** What an empty view is headed, by view — \"nothing overdue\" is good news. */\nconst EMPTY_LABEL: Record<CrmTaskView, string> = {\n  mine: 'Nothing is assigned to you',\n  overdue: 'Nothing is overdue',\n  today: 'Nothing is due today',\n  upcoming: 'Nothing is scheduled beyond today',\n  open: 'No open tasks',\n  done: 'No completed tasks yet',\n}\n\n/** The one sentence under it, by view. */\nconst EMPTY_COPY: Record<CrmTaskView, string> = {\n  mine: 'Tasks you create are yours unless you hand them to someone.',\n  overdue: 'Every dated task is on or ahead of schedule.',\n  today: 'Nothing on your calendar day is owed to anyone in the CRM.',\n  upcoming: 'A task with a due date past today would be listed here.',\n  open: 'A task is a call, an email, a meeting or a to-do owed to a contact, a company or a deal.',\n  done: 'Tasks ticked off on their record, or here, are kept for the history.',\n}\n\n/**\n * `/crm/tasks` — what the team owes the people in the CRM (AGL-2599).\n *\n * Six views over `orgs/{orgId}/crmTasks`, each a bounded listener on one of\n * the collection's indexes, chosen by a segmented control. A task hangs off\n * a contact, a company or a deal, but it is listed HERE because \"what is due\n * today\" is a question about the team's day and not about any one record;\n * the record pages carry their own `RecordTasksCard` for the other\n * direction.\n *\n * Completing goes through `crm/task-complete`, because completing fires the\n * `taskCompleted` host event and only the server can run a workflow.\n * Reopening is client-direct: undoing a tick has no side effect beyond the\n * document, and the rules gate it like any other CRM write.\n *\n * The rows are selectable, and a selection raises `TasksBulkBar` over the\n * list — Complete and Assign through their routes, the due date and the\n * delete as batched writes (AGL-2621). Export CSV beside the view control\n * writes the view through `tasksCsv()`, naming the assignee and the linked\n * records; the bar writes the same file over the selection.\n */\nexport function TasksSection(props: ConsolePluginPageProps) {\n  const { hostId, org, basePath = '' } = props\n  const orgRecord = org as Record<string, unknown> | undefined\n  const firestore = useFirestore()\n  const { data: user } = useUser()\n  const { enqueueSnackbar } = useSnackbar()\n  const nowMs = useNowMs()\n  const routes = useMemo(() => crmRoutes(basePath), [basePath])\n  // The viewing group a linked contact is named through, or `null` at the\n  // organization level, where each is named through its own holder.\n  const { consentGroup } = useCrmScope({ hostId, org: orgRecord })\n  const groupId = consentGroup?.groupId ?? null\n\n  /*\n   * Which of the six task views is open is the saved VIEW'S (AGL-2617): a\n   * saved view of tasks holds the task view beside the columns and the\n   * sort, and the toggle below writes into it. Unset reads as \"My tasks\",\n   * which is what the section opened on before views existed.\n   */\n  const views = useCrmSavedView({ section: 'tasks', hostId, org: orgRecord, basePath })\n  const view: CrmTaskView = useMemo(() => {\n    const value = views.state.filters.find((clause) => clause.field === 'view')?.value\n    return CRM_TASK_VIEWS.some((option) => option.id === value)\n      ? (value as CrmTaskView)\n      : 'mine'\n  }, [views.state.filters])\n  const setView = useCallback(\n    (next: CrmTaskView) =>\n      views.setFilters([{ field: 'view', op: 'equals', value: next }]),\n    [views.setFilters],\n  )\n  const list = useCrmTaskList({\n    hostId,\n    org: orgRecord,\n    view,\n    uid: user?.uid,\n    nowMs,\n  })\n  const { tasks, status, fromCache, truncated, scope, orgId, readTokens } = list\n  const directory = useOrgMemberDirectory(orgId)\n\n  /*\n   * Every record a task names, not only the one its \"For\" cell shows: the\n   * export writes the contact, the company and the deal each by name, and\n   * a task that names two would otherwise carry an id in one column.\n   */\n  const linked = useMemo(\n    () =>\n      tasks.flatMap((task) => [\n        ...(task.contactId ? [{ kind: 'contact' as const, id: task.contactId }] : []),\n        ...(task.companyId ? [{ kind: 'company' as const, id: task.companyId }] : []),\n        ...(task.dealId ? [{ kind: 'deal' as const, id: task.dealId }] : []),\n      ]),\n    [tasks],\n  )\n  const nameOf = useCrmRecordNames({ orgId, groupId, org: orgRecord, records: linked })\n\n  const [selectedIds, setSelectedIds] = useState<string[]>([])\n  // A view is a different set of rows; a selection made on the last one\n  // would be a count over rows no longer on screen.\n  useEffect(() => setSelectedIds([]), [view])\n  const csvOptions: TaskCsvOptions = useMemo(\n    () => ({\n      assigneeEmail: (uid) => {\n        const member = findOrgMember(directory.members, uid)\n        return member?.email || member?.label || uid\n      },\n      recordName: nameOf,\n    }),\n    [directory.members, nameOf],\n  )\n  const handleExport = useCallback(() => {\n    downloadTextFile('tasks.csv', 'text/csv', tasksCsv(tasks, csvOptions))\n  }, [tasks, csvOptions])\n\n  /*\n   * List or month (AGL-2662). A layout choice over the SAME rows and the\n   * same view — switching does not narrow anything and costs no read, so\n   * it is a toggle rather than another saved view.\n   */\n  const [layout, setLayout] = useState<'list' | 'calendar'>('list')\n  const [drawer, setDrawer] = useState<{ open: boolean; task: CrmTaskRow | null }>({\n    open: false,\n    task: null,\n  })\n  const [busyId, setBusyId] = useState<string | null>(null)\n\n  /*\n   * Tick or untick. The two directions are two different writes on purpose\n   * — see the module comment — and the row is disabled while either is in\n   * flight so a double-click cannot complete a task and reopen it in the\n   * same breath.\n   */\n  const toggleDone = useCallback(\n    async (task: CrmTaskRow) => {\n      if (!scope || busyId) return\n      setBusyId(task.$id)\n      try {\n        if (task.status === 'done') {\n          await updateDoc(\n            doc(firestore, scope[0], scope[1], CRM_COLLECTIONS.tasks, task.$id),\n            {\n              status: 'open',\n              completedAtMs: null,\n              completedByUid: deleteField(),\n              updatedAt: serverTimestamp(),\n            },\n          )\n          enqueueSnackbar('Task reopened', { variant: 'success' })\n          // A client-direct write: the records it names are told (AGL-2661).\n          await refreshCrmNextActivity(user, crmTaskCallScope(hostId, orgId), [task])\n        } else {\n          // The route runs as the mounted site, which hears the event, or\n          // at the organization level as the org — the org variant, which\n          // emits on the task's own site, or nowhere for an org task.\n          const callScope = crmTaskCallScope(hostId, orgId)\n          if (!callScope) return\n          await completeCrmTask(user, { ...callScope, taskId: task.$id })\n          enqueueSnackbar('Task completed', { variant: 'success' })\n        }\n      } catch (cause) {\n        enqueueSnackbar(\n          cause instanceof Error ? cause.message : 'The task could not be updated.',\n          { variant: 'warning' },\n        )\n      } finally {\n        setBusyId(null)\n      }\n    },\n    [scope, busyId, firestore, user, hostId, orgId, enqueueSnackbar],\n  )\n\n  const columns: GridColDef[] = useMemo(\n    () => [\n      {\n        field: 'status',\n        headerName: '',\n        width: 56,\n        sortable: false,\n        filterable: false,\n        renderCell: ({ row }: { row: CrmTaskRow }) => (\n          <Checkbox\n            size=\"small\"\n            checked={row.status === 'done'}\n            disabled={busyId === row.$id}\n            onClick={(event) => {\n              event.stopPropagation()\n              void toggleDone(row)\n            }}\n            slotProps={{\n              input: {\n                'aria-label':\n                  row.status === 'done'\n                    ? `Reopen \"${row.title}\"`\n                    : `Complete \"${row.title}\"`,\n              },\n            }}\n          />\n        ),\n      },\n      {\n        field: 'title',\n        headerName: 'Task',\n        flex: 2,\n        minWidth: 220,\n        sortable: false,\n        renderCell: ({ row }: { row: CrmTaskRow }) => (\n          <Stack sx={{ justifyContent: 'center', height: '100%', minWidth: 0 }}>\n            <Typography\n              variant=\"body2\"\n              noWrap\n              sx={{\n                textDecoration: row.status === 'done' ? 'line-through' : undefined,\n                color: row.status === 'done' ? 'text.secondary' : undefined,\n              }}\n            >\n              {row.title}\n            </Typography>\n            {row.notes ? (\n              <Typography variant=\"caption\" color=\"text.secondary\" noWrap>\n                {row.notes}\n              </Typography>\n            ) : null}\n          </Stack>\n        ),\n      },\n      {\n        field: 'kind',\n        headerName: 'Kind',\n        width: 120,\n        sortable: false,\n        renderCell: ({ row }: { row: CrmTaskRow }) => <TaskKindCell kind={row.kind} />,\n      },\n      {\n        field: 'priority',\n        headerName: 'Priority',\n        width: 110,\n        sortable: false,\n        renderCell: ({ row }: { row: CrmTaskRow }) => (\n          <TaskPriorityChip priority={row.priority} />\n        ),\n      },\n      {\n        field: 'dueAtMs',\n        headerName: 'Due',\n        width: 260,\n        sortable: false,\n        renderCell: ({ row }: { row: CrmTaskRow }) => (\n          <Stack direction=\"row\" spacing={0.5} sx={{ alignItems: 'center', height: '100%' }}>\n            <TaskDueText task={row} nowMs={nowMs} />\n            {row.status === 'done' || !scope ? null : (\n              <TaskSnoozeMenu\n                dueAtMs={row.dueAtMs}\n                remindAtMs={row.remindAtMs}\n                target={{\n                  write: {\n                    scope,\n                    taskId: row.$id,\n                    call: crmTaskCallScope(hostId, orgId),\n                    links: row,\n                  },\n                }}\n                disabled={busyId === row.$id}\n              />\n            )}\n          </Stack>\n        ),\n      },\n      {\n        field: 'assigneeUid',\n        headerName: 'Assignee',\n        flex: 1,\n        minWidth: 140,\n        sortable: false,\n        valueGetter: (_value: unknown, row: CrmTaskRow) =>\n          directory.nameOf(row.assigneeUid),\n        renderCell: ({ row }: { row: CrmTaskRow }) => (\n          <Typography variant=\"body2\" color={row.assigneeUid ? undefined : 'text.secondary'}>\n            {row.assigneeUid ? directory.nameOf(row.assigneeUid) : 'Unassigned'}\n          </Typography>\n        ),\n      },\n      {\n        field: 'record',\n        headerName: 'For',\n        flex: 1,\n        minWidth: 160,\n        sortable: false,\n        renderCell: ({ row }: { row: CrmTaskRow }) => (\n          <TaskRecordLink task={row} routes={routes} nameOf={nameOf} />\n        ),\n      },\n    ],\n    [busyId, toggleDone, nowMs, directory, routes, nameOf, scope],\n  )\n  /* The column and sort models are the view's (AGL-2617). */\n  const grid = useCrmViewGrid(views, columns)\n\n  return (\n    <>\n      <CardDisplay\n        header={'Tasks'}\n        help={pluginDocsHelp('crmTasks', {\n          anchor: '#the-tasks-page',\n          excerpt:\n            'Calls, emails, meetings and to-dos, each linked to the contact, ' +\n            'company or deal it is for. Overdue and today are read off the ' +\n            'due date as you look.',\n        })}\n        contentGutterX\n        contentGutterY\n        HeaderProps={{\n          action: (\n            <Button\n              size=\"small\"\n              variant=\"contained\"\n              color=\"primary\"\n              onClick={() => setDrawer({ open: true, task: null })}\n            >\n              {'New task'}\n            </Button>\n          ),\n        }}\n      >\n        <Stack spacing={2}>\n          {/* The saved view this list is showing, beside the task view it narrows to (AGL-2617). */}\n          <Stack\n            direction=\"row\"\n            spacing={2}\n            sx={{ alignItems: 'center', flexWrap: 'wrap', rowGap: 1 }}\n          >\n            <CrmViewsControl controller={views} allLabel=\"All tasks\" />\n            <ToggleButtonGroup\n              exclusive\n              size=\"small\"\n              color=\"primary\"\n              value={view}\n              onChange={(_event, next) => {\n                if (next) setView(next as CrmTaskView)\n              }}\n              aria-label=\"Task view\"\n            >\n              {CRM_TASK_VIEWS.map((option) => (\n                <ToggleButton key={option.id} value={option.id}>\n                  {option.label}\n                </ToggleButton>\n              ))}\n            </ToggleButtonGroup>\n            <ToggleButtonGroup\n              exclusive\n              size=\"small\"\n              color=\"primary\"\n              value={layout}\n              onChange={(_event, next) => {\n                if (next) setLayout(next as 'list' | 'calendar')\n              }}\n              aria-label=\"Task layout\"\n            >\n              <ToggleButton value=\"list\">{'List'}</ToggleButton>\n              <ToggleButton value=\"calendar\">{'Calendar'}</ToggleButton>\n            </ToggleButtonGroup>\n            <Stack sx={{ flex: 1 }} />\n            <TaskImportButton hostId={hostId} />\n            <Button size=\"small\" onClick={handleExport} disabled={!tasks.length}>\n              {'Export CSV'}\n            </Button>\n          </Stack>\n          {status === 'error' ? (\n            <Typography variant=\"body2\" color=\"error\">\n              {'The tasks could not be loaded. Reload to try again.'}\n            </Typography>\n          ) : status === 'success' && !tasks.length ? (\n            <EmptyStateComponent\n              label={EMPTY_LABEL[view]}\n              description={EMPTY_COPY[view]}\n              action={\n                <Button\n                  size=\"small\"\n                  variant=\"contained\"\n                  color=\"primary\"\n                  onClick={() => setDrawer({ open: true, task: null })}\n                >\n                  {'New task'}\n                </Button>\n              }\n            />\n          ) : (\n            <>\n              {truncated ? (\n                <Typography variant=\"caption\" color=\"text.secondary\">\n                  {`Showing the first ${CRM_TASK_VIEW_LIMIT} — narrow the view to see the rest.`}\n                </Typography>\n              ) : null}\n              {/*\n                The calendar draws the same rows, so there is no bulk bar\n                over it: a selection is a list gesture, and a month grid\n                offers nowhere to make one.\n              */}\n              {layout === 'calendar' ? (\n                <TasksCalendar\n                  tasks={tasks}\n                  truncated={truncated}\n                  onOpen={(task) => setDrawer({ open: true, task })}\n                />\n              ) : (\n                <>\n              <TasksBulkBar\n                hostId={hostId}\n                scope={scope}\n                rows={tasks}\n                selected={selectedIds}\n                onSelectedChange={setSelectedIds}\n                directory={directory}\n                csv={csvOptions}\n              />\n              <CrmColumnOrderProvider value={grid.columnOrder}>\n                <ListTable\n                  rows={tasks}\n                  columns={grid.columns}\n                  slots={CRM_LIST_SLOTS}\n                  selectable={{ selected: selectedIds, onChange: setSelectedIds }}\n                  loading={status === 'loading'}\n                  onOpen={(id) => {\n                    const found = tasks.find((row) => row.$id === id)\n                    if (found) setDrawer({ open: true, task: found })\n                  }}\n                  disableColumnFilter\n                  // Columns and sort are the view's, controlled (AGL-2617).\n                  columnVisibilityModel={grid.columnVisibilityModel}\n                  onColumnVisibilityModelChange={grid.onColumnVisibilityModelChange}\n                  sortModel={grid.sortModel}\n                  onSortModelChange={grid.onSortModelChange}\n                />\n              </CrmColumnOrderProvider>\n                </>\n              )}\n            </>\n          )}\n        </Stack>\n      </CardDisplay>\n      <TaskEditDrawer\n        open={drawer.open}\n        onClose={() => setDrawer((prev) => ({ ...prev, open: false }))}\n        hostId={hostId}\n        org={orgRecord}\n        orgId={orgId}\n        scope={scope}\n        readTokens={readTokens}\n        task={drawer.task}\n        seed={{ fromCache, unreadable: status === 'error' }}\n      />\n    </>\n  )\n}\nTasksSection.displayName = 'TasksSection'\n\nexport default TasksSection\n"],"names":["CRM_COLLECTIONS","findOrgMember","pluginDocsHelp","CardDisplay","ListTable","useCrmSavedView","useCrmScope","useCrmViewGrid","CRM_LIST_SLOTS","CrmColumnOrderProvider","CrmViewsControl","EmptyStateComponent","useSnackbar","useFirestore","useUser","Button","Checkbox","Stack","ToggleButton","ToggleButtonGroup","Typography","deleteField","doc","serverTimestamp","updateDoc","useCallback","useEffect","useMemo","useState","useCrmRecordNames","useCrmTaskList","useNowMs","useOrgMemberDirectory","downloadTextFile","crmRoutes","refreshCrmNextActivity","completeCrmTask","crmTaskCallScope","tasksCsv","CRM_TASK_VIEW_LIMIT","CRM_TASK_VIEWS","TaskDueText","TaskKindCell","TaskPriorityChip","TaskRecordLink","TaskEditDrawer","TasksCalendar","TaskImportButton","TaskSnoozeMenu","TasksBulkBar","EMPTY_LABEL","mine","overdue","today","upcoming","open","done","EMPTY_COPY","TasksSection","props","hostId","org","basePath","orgRecord","firestore","data","user","enqueueSnackbar","nowMs","routes","consentGroup","groupId","views","section","view","value","state","filters","find","clause","field","some","option","id","setView","next","setFilters","op","list","uid","tasks","status","fromCache","truncated","scope","orgId","readTokens","directory","linked","flatMap","task","contactId","kind","companyId","dealId","nameOf","records","selectedIds","setSelectedIds","csvOptions","assigneeEmail","member","members","email","label","recordName","handleExport","layout","setLayout","drawer","setDrawer","busyId","setBusyId","toggleDone","$id","completedAtMs","completedByUid","updatedAt","variant","callScope","taskId","cause","Error","message","columns","headerName","width","sortable","filterable","renderCell","row","size","checked","disabled","onClick","event","stopPropagation","slotProps","input","title","flex","minWidth","sx","justifyContent","height","noWrap","textDecoration","undefined","color","notes","priority","direction","spacing","alignItems","dueAtMs","remindAtMs","target","write","call","links","valueGetter","_value","assigneeUid","grid","header","help","anchor","excerpt","contentGutterX","contentGutterY","HeaderProps","action","flexWrap","rowGap","controller","allLabel","exclusive","onChange","_event","aria-label","map","length","description","onOpen","rows","selected","onSelectedChange","csv","columnOrder","slots","selectable","loading","found","disableColumnFilter","columnVisibilityModel","onColumnVisibilityModelChange","sortModel","onSortModelChange","onClose","prev","seed","unreadable","displayName"],"mappings":"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"}

package/src/lib/components/use-contact-campaign-emails.d.ts

@@ -0,0 +1,32 @@
+import type { ContactCampaignEmail } from '@aglyn/aglyn';
+/** What the timeline knows about a contact's campaign mail. */
+export interface ContactCampaignEmailsState {
+    emails: ContactCampaignEmail[];
+    status: 'loading' | 'success' | 'error';
+    /**
+     * The server could authorize the read and then could not read the log.
+     * Distinct from `error` because the answer is trustworthy in every other
+     * respect and the timeline should say "unknown" for this one history
+     * rather than for the page.
+     */
+    lookupFailed: boolean;
+}
+/**
+ * The campaign mail one contact was sent (AGL-2616), through
+ * `crm/contact-email-history`.
+ *
+ * ONE request per record open, and on mount rather than behind a button,
+ * because the record page is the ask: the reader opened one person, and
+ * this history is part of what "one person" means on a CRM. The cost is
+ * bounded by that person's own mail — the server reads down their message
+ * subcollection, capped — and never by how much the customer has sent, so
+ * it does not grow with the size of the account the way a scan would.
+ *
+ * Keyed on the api callback, which `useCrmApi` memoizes on the site, and on
+ * the contact id — never on the user object, which is a new object on most
+ * renders and would re-bill the page on every paint.
+ */
+export declare function useContactCampaignEmails(
+/** The site whose campaigns are asked about; nothing is asked without one. */
+hostId: string | null, contactId: string): ContactCampaignEmailsState;
+export default useContactCampaignEmails;

package/src/lib/components/use-contact-campaign-emails.js

@@ -0,0 +1,83 @@
+/**
+ * @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 { useEffect, useState } from "react";
+import { useCrmApi } from "./use-crm-api.js";
+const EMPTY = {
+    emails: [],
+    status: 'loading',
+    lookupFailed: false
+};
+/**
+ * The campaign mail one contact was sent (AGL-2616), through
+ * `crm/contact-email-history`.
+ *
+ * ONE request per record open, and on mount rather than behind a button,
+ * because the record page is the ask: the reader opened one person, and
+ * this history is part of what "one person" means on a CRM. The cost is
+ * bounded by that person's own mail — the server reads down their message
+ * subcollection, capped — and never by how much the customer has sent, so
+ * it does not grow with the size of the account the way a scan would.
+ *
+ * Keyed on the api callback, which `useCrmApi` memoizes on the site, and on
+ * the contact id — never on the user object, which is a new object on most
+ * renders and would re-bill the page on every paint.
+ */ export function useContactCampaignEmails(/** The site whose campaigns are asked about; nothing is asked without one. */ hostId, contactId) {
+    const api = useCrmApi(hostId);
+    const [state, setState] = useState(EMPTY);
+    useEffect(()=>{
+        let cancelled = false;
+        setState(EMPTY);
+        if (!contactId || !hostId) return undefined;
+        api('contact-email-history', {
+            contactId
+        }).then(({ response, payload })=>{
+            if (cancelled) return;
+            if (!response.ok) {
+                setState({
+                    emails: [],
+                    status: 'error',
+                    lookupFailed: false
+                });
+                return;
+            }
+            setState({
+                emails: Array.isArray(payload.emails) ? payload.emails : [],
+                status: 'success',
+                lookupFailed: payload.lookupFailed === true
+            });
+        }).catch(()=>{
+            if (!cancelled) {
+                setState({
+                    emails: [],
+                    status: 'error',
+                    lookupFailed: false
+                });
+            }
+        });
+        return ()=>{
+            cancelled = true;
+        };
+    }, [
+        api,
+        contactId,
+        hostId
+    ]);
+    return state;
+}
+export default useContactCampaignEmails;
+
+//# sourceMappingURL=use-contact-campaign-emails.js.map

package/src/lib/components/use-contact-campaign-emails.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/crm/src/lib/components/use-contact-campaign-emails.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 */\n'use client'\n\nimport type { ContactCampaignEmail } from '@aglyn/aglyn'\nimport { useEffect, useState } from 'react'\nimport { useCrmApi } from './use-crm-api'\n\n/** What the timeline knows about a contact's campaign mail. */\nexport interface ContactCampaignEmailsState {\n  emails: ContactCampaignEmail[]\n  status: 'loading' | 'success' | 'error'\n  /**\n   * The server could authorize the read and then could not read the log.\n   * Distinct from `error` because the answer is trustworthy in every other\n   * respect and the timeline should say \"unknown\" for this one history\n   * rather than for the page.\n   */\n  lookupFailed: boolean\n}\n\nconst EMPTY: ContactCampaignEmailsState = {\n  emails: [],\n  status: 'loading',\n  lookupFailed: false,\n}\n\n/**\n * The campaign mail one contact was sent (AGL-2616), through\n * `crm/contact-email-history`.\n *\n * ONE request per record open, and on mount rather than behind a button,\n * because the record page is the ask: the reader opened one person, and\n * this history is part of what \"one person\" means on a CRM. The cost is\n * bounded by that person's own mail — the server reads down their message\n * subcollection, capped — and never by how much the customer has sent, so\n * it does not grow with the size of the account the way a scan would.\n *\n * Keyed on the api callback, which `useCrmApi` memoizes on the site, and on\n * the contact id — never on the user object, which is a new object on most\n * renders and would re-bill the page on every paint.\n */\nexport function useContactCampaignEmails(\n  /** The site whose campaigns are asked about; nothing is asked without one. */\n  hostId: string | null,\n  contactId: string,\n): ContactCampaignEmailsState {\n  const api = useCrmApi(hostId)\n  const [state, setState] = useState<ContactCampaignEmailsState>(EMPTY)\n\n  useEffect(() => {\n    let cancelled = false\n    setState(EMPTY)\n    if (!contactId || !hostId) return undefined\n    api('contact-email-history', { contactId })\n      .then(({ response, payload }) => {\n        if (cancelled) return\n        if (!response.ok) {\n          setState({ emails: [], status: 'error', lookupFailed: false })\n          return\n        }\n        setState({\n          emails: Array.isArray(payload.emails)\n            ? (payload.emails as ContactCampaignEmail[])\n            : [],\n          status: 'success',\n          lookupFailed: payload.lookupFailed === true,\n        })\n      })\n      .catch(() => {\n        if (!cancelled) {\n          setState({ emails: [], status: 'error', lookupFailed: false })\n        }\n      })\n    return () => {\n      cancelled = true\n    }\n  }, [api, contactId, hostId])\n\n  return state\n}\n\nexport default useContactCampaignEmails\n"],"names":["useEffect","useState","useCrmApi","EMPTY","emails","status","lookupFailed","useContactCampaignEmails","hostId","contactId","api","state","setState","cancelled","undefined","then","response","payload","ok","Array","isArray","catch"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GACD;AAGA,SAASA,SAAS,EAAEC,QAAQ,QAAQ,QAAO;AAC3C,SAASC,SAAS,QAAQ,mBAAe;AAezC,MAAMC,QAAoC;IACxCC,QAAQ,EAAE;IACVC,QAAQ;IACRC,cAAc;AAChB;AAEA;;;;;;;;;;;;;;CAcC,GACD,OAAO,SAASC,yBACd,4EAA4E,GAC5EC,MAAqB,EACrBC,SAAiB;IAEjB,MAAMC,MAAMR,UAAUM;IACtB,MAAM,CAACG,OAAOC,SAAS,GAAGX,SAAqCE;IAE/DH,UAAU;QACR,IAAIa,YAAY;QAChBD,SAAST;QACT,IAAI,CAACM,aAAa,CAACD,QAAQ,OAAOM;QAClCJ,IAAI,yBAAyB;YAAED;QAAU,GACtCM,IAAI,CAAC,CAAC,EAAEC,QAAQ,EAAEC,OAAO,EAAE;YAC1B,IAAIJ,WAAW;YACf,IAAI,CAACG,SAASE,EAAE,EAAE;gBAChBN,SAAS;oBAAER,QAAQ,EAAE;oBAAEC,QAAQ;oBAASC,cAAc;gBAAM;gBAC5D;YACF;YACAM,SAAS;gBACPR,QAAQe,MAAMC,OAAO,CAACH,QAAQb,MAAM,IAC/Ba,QAAQb,MAAM,GACf,EAAE;gBACNC,QAAQ;gBACRC,cAAcW,QAAQX,YAAY,KAAK;YACzC;QACF,GACCe,KAAK,CAAC;YACL,IAAI,CAACR,WAAW;gBACdD,SAAS;oBAAER,QAAQ,EAAE;oBAAEC,QAAQ;oBAASC,cAAc;gBAAM;YAC9D;QACF;QACF,OAAO;YACLO,YAAY;QACd;IACF,GAAG;QAACH;QAAKD;QAAWD;KAAO;IAE3B,OAAOG;AACT;AAEA,eAAeJ,yBAAwB"}

package/src/lib/components/use-crm-api.d.ts

@@ -0,0 +1,44 @@
+/** The routes `registerCrmConsoleApi` registers under `/api/crm/`. */
+export type CrmApiRoute = 'contacts-create' | 'contact-email-history' | 'contact-update' | 'company-delete' | 'contacts-merge' | 'email-send' | 'erase-person' | 'org-activity' | 'recipe-install' | 'recipe-status' | 'inbound-address' | 'email-template-duplicate';
+/** What one call to the CRM API answered with. */
+export interface CrmApiResult {
+    response: Response;
+    payload: Record<string, any>;
+}
+/**
+ * ONE AUTHORIZED POST TO THE CRM's SERVER HALF (AGL-2596).
+ *
+ * The route is a fixed member of {@link CrmApiRoute} rather than a string
+ * the caller composes, so a component cannot post the console's credentials
+ * anywhere this plugin does not own. The site id rides in the body because
+ * that is where the dispatcher's per-site gate reads it from.
+ *
+ * The user is read through a ref, for the reason the campaign API hook
+ * gives: the user object is a new object on most renders, and a callback
+ * that changed identity with it would re-fire every effect that depends on
+ * it. The token is fetched at call time either way — `authorizedFetch`
+ * resolves it under a deadline and answers a 401 of its own rather than
+ * sending the request unauthenticated, so a signed-out caller is told so
+ * through the same `response.ok` branch every other refusal takes.
+ */
+/**
+ * ## The organization level
+ *
+ * Beneath the org hub's mount (AGL-2630) the body also names the ORG, and
+ * that is what makes the call the route's org variant (AGL-2634): the route
+ * authorizes the caller by the org rather than by a site's role, and a
+ * `hostId` beside it — the record's own capturing site, or `null` for a
+ * record no site has captured — is what the act needs a site FOR, never
+ * what it is authorized against. Under a site there is no mount and the
+ * body is what it always was.
+ */
+export declare function useCrmApi(
+/**
+ * The site the request is made for. At the organization level the
+ * record's own site, or `null` for a record no site has captured — the
+ * org variant of a route serves both, and a route with no org variant
+ * (a create, which is always captured BY a site) refuses the null as it
+ * always has.
+ */
+hostId: string | null): (route: CrmApiRoute, payload: Record<string, unknown>) => Promise<CrmApiResult>;
+export default useCrmApi;

package/src/lib/components/use-crm-api.js

@@ -0,0 +1,84 @@
+/**
+ * @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 { authorizedFetch } from "@aglyn/shared-util-http/authorized-token";
+import { useUser } from "@aglyn/tenant-feature-instance";
+import { useCallback, useRef } from "react";
+import { useCrmOrgMount } from "../hooks/use-crm-org-mount.js";
+/**
+ * ONE AUTHORIZED POST TO THE CRM's SERVER HALF (AGL-2596).
+ *
+ * The route is a fixed member of {@link CrmApiRoute} rather than a string
+ * the caller composes, so a component cannot post the console's credentials
+ * anywhere this plugin does not own. The site id rides in the body because
+ * that is where the dispatcher's per-site gate reads it from.
+ *
+ * The user is read through a ref, for the reason the campaign API hook
+ * gives: the user object is a new object on most renders, and a callback
+ * that changed identity with it would re-fire every effect that depends on
+ * it. The token is fetched at call time either way — `authorizedFetch`
+ * resolves it under a deadline and answers a 401 of its own rather than
+ * sending the request unauthenticated, so a signed-out caller is told so
+ * through the same `response.ok` branch every other refusal takes.
+ */ /**
+ * ## The organization level
+ *
+ * Beneath the org hub's mount (AGL-2630) the body also names the ORG, and
+ * that is what makes the call the route's org variant (AGL-2634): the route
+ * authorizes the caller by the org rather than by a site's role, and a
+ * `hostId` beside it — the record's own capturing site, or `null` for a
+ * record no site has captured — is what the act needs a site FOR, never
+ * what it is authorized against. Under a site there is no mount and the
+ * body is what it always was.
+ */ export function useCrmApi(/**
+   * The site the request is made for. At the organization level the
+   * record's own site, or `null` for a record no site has captured — the
+   * org variant of a route serves both, and a route with no org variant
+   * (a create, which is always captured BY a site) refuses the null as it
+   * always has.
+   */ hostId) {
+    var _ref;
+    var _useCrmOrgMount;
+    const { data: user } = useUser();
+    const userRef = useRef(user);
+    userRef.current = user;
+    const orgId = (_ref = (_useCrmOrgMount = useCrmOrgMount()) == null ? void 0 : _useCrmOrgMount.orgId) != null ? _ref : null;
+    return useCallback(async (route, payload)=>{
+        const response = await authorizedFetch(userRef.current, `/api/crm/${route}`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json'
+            },
+            body: JSON.stringify(_extends({
+                hostId
+            }, orgId ? {
+                orgId
+            } : {}, payload))
+        });
+        const json = await response.json().catch(()=>({}));
+        return {
+            response,
+            payload: json
+        };
+    }, [
+        hostId,
+        orgId
+    ]);
+}
+export default useCrmApi;
+
+//# sourceMappingURL=use-crm-api.js.map

package/src/lib/components/use-crm-api.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/crm/src/lib/components/use-crm-api.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 */\n'use client'\n\nimport {\n  authorizedFetch,\n  type TokenSource,\n} from '@aglyn/shared-util-http/authorized-token'\nimport { useUser } from '@aglyn/tenant-feature-instance'\nimport { useCallback, useRef } from 'react'\nimport { useCrmOrgMount } from '../hooks/use-crm-org-mount'\n\n/** The routes `registerCrmConsoleApi` registers under `/api/crm/`. */\nexport type CrmApiRoute =\n  | 'contacts-create'\n  | 'contact-email-history'\n  | 'contact-update'\n  | 'company-delete'\n  | 'contacts-merge'\n  | 'email-send'\n  | 'erase-person'\n  | 'org-activity'\n  | 'recipe-install'\n  | 'recipe-status'\n  | 'inbound-address'\n  | 'email-template-duplicate'\n\n/** What one call to the CRM API answered with. */\nexport interface CrmApiResult {\n  response: Response\n  payload: Record<string, any>\n}\n\n/**\n * ONE AUTHORIZED POST TO THE CRM's SERVER HALF (AGL-2596).\n *\n * The route is a fixed member of {@link CrmApiRoute} rather than a string\n * the caller composes, so a component cannot post the console's credentials\n * anywhere this plugin does not own. The site id rides in the body because\n * that is where the dispatcher's per-site gate reads it from.\n *\n * The user is read through a ref, for the reason the campaign API hook\n * gives: the user object is a new object on most renders, and a callback\n * that changed identity with it would re-fire every effect that depends on\n * it. The token is fetched at call time either way — `authorizedFetch`\n * resolves it under a deadline and answers a 401 of its own rather than\n * sending the request unauthenticated, so a signed-out caller is told so\n * through the same `response.ok` branch every other refusal takes.\n */\n/**\n * ## The organization level\n *\n * Beneath the org hub's mount (AGL-2630) the body also names the ORG, and\n * that is what makes the call the route's org variant (AGL-2634): the route\n * authorizes the caller by the org rather than by a site's role, and a\n * `hostId` beside it — the record's own capturing site, or `null` for a\n * record no site has captured — is what the act needs a site FOR, never\n * what it is authorized against. Under a site there is no mount and the\n * body is what it always was.\n */\nexport function useCrmApi(\n  /**\n   * The site the request is made for. At the organization level the\n   * record's own site, or `null` for a record no site has captured — the\n   * org variant of a route serves both, and a route with no org variant\n   * (a create, which is always captured BY a site) refuses the null as it\n   * always has.\n   */\n  hostId: string | null,\n) {\n  const { data: user } = useUser()\n  const userRef = useRef(user)\n  userRef.current = user\n  const orgId = useCrmOrgMount()?.orgId ?? null\n  return useCallback(\n    async (\n      route: CrmApiRoute,\n      payload: Record<string, unknown>,\n    ): Promise<CrmApiResult> => {\n      const response = await authorizedFetch(\n        userRef.current as TokenSource | null | undefined,\n        `/api/crm/${route}`,\n        {\n          method: 'POST',\n          headers: { 'Content-Type': 'application/json' },\n          body: JSON.stringify({\n            hostId,\n            ...(orgId ? { orgId } : {}),\n            ...payload,\n          }),\n        },\n      )\n      const json = await response.json().catch(() => ({}))\n      return { response, payload: json as Record<string, any> }\n    },\n    [hostId, orgId],\n  )\n}\n\nexport default useCrmApi\n"],"names":["authorizedFetch","useUser","useCallback","useRef","useCrmOrgMount","useCrmApi","hostId","data","user","userRef","current","orgId","route","payload","response","method","headers","body","JSON","stringify","json","catch"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GACD;;AAEA,SACEA,eAAe,QAEV,2CAA0C;AACjD,SAASC,OAAO,QAAQ,iCAAgC;AACxD,SAASC,WAAW,EAAEC,MAAM,QAAQ,QAAO;AAC3C,SAASC,cAAc,QAAQ,gCAA4B;AAuB3D;;;;;;;;;;;;;;;CAeC,GACD;;;;;;;;;;CAUC,GACD,OAAO,SAASC,UACd;;;;;;GAMC,GACDC,MAAqB;;QAKPF;IAHd,MAAM,EAAEG,MAAMC,IAAI,EAAE,GAAGP;IACvB,MAAMQ,UAAUN,OAAOK;IACvBC,QAAQC,OAAO,GAAGF;IAClB,MAAMG,iBAAQP,kBAAAA,qCAAAA,gBAAkBO,KAAK,mBAAI;IACzC,OAAOT,YACL,OACEU,OACAC;QAEA,MAAMC,WAAW,MAAMd,gBACrBS,QAAQC,OAAO,EACf,CAAC,SAAS,EAAEE,OAAO,EACnB;YACEG,QAAQ;YACRC,SAAS;gBAAE,gBAAgB;YAAmB;YAC9CC,MAAMC,KAAKC,SAAS,CAAC;gBACnBb;eACIK,QAAQ;gBAAEA;YAAM,IAAI,CAAC,GACtBE;QAEP;QAEF,MAAMO,OAAO,MAAMN,SAASM,IAAI,GAAGC,KAAK,CAAC,IAAO,CAAA,CAAC,CAAA;QACjD,OAAO;YAAEP;YAAUD,SAASO;QAA4B;IAC1D,GACA;QAACd;QAAQK;KAAM;AAEnB;AAEA,eAAeN,UAAS"}

package/src/lib/components/use-crm-inbound-address.d.ts

@@ -0,0 +1,60 @@
+/**
+ * @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.
+ */
+/** What the address route has answered so far. */
+export type CrmInboundAddressState = {
+    status: 'idle' | 'loading';
+    address: null;
+    error: null;
+} | {
+    status: 'ready';
+    address: string;
+    error: null;
+} | {
+    status: 'error';
+    address: null;
+    error: string;
+};
+export type CrmInboundRotateResult = {
+    ok: true;
+    address: string;
+} | {
+    ok: false;
+    error: string;
+};
+export interface CrmInboundAddress {
+    status: CrmInboundAddressState['status'];
+    address: string | null;
+    error: string | null;
+    /** Replaces the token; the new address is in the answer and in `address`. */
+    rotate: () => Promise<CrmInboundRotateResult>;
+    rotating: boolean;
+}
+/**
+ * The workspace's email capture address (AGL-2657), asked of
+ * `crm/inbound-address` when `enabled` turns on — a dialog's open, a
+ * settings card's mount — and never before: the first ask mints the token,
+ * and a surface that asked on every paint would mint on behalf of members
+ * who never wanted the address.
+ *
+ * The site is whatever the surface is mounted under; at the organization
+ * level `null`, and the route's org variant answers, because the address
+ * is the organization's whichever site asks.
+ */
+export declare function useCrmInboundAddress(hostId: string | null, options: {
+    enabled: boolean;
+}): CrmInboundAddress;
+export default useCrmInboundAddress;

package/src/lib/components/use-crm-inbound-address.js

@@ -0,0 +1,124 @@
+/**
+ * @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 { useCallback, useEffect, useState } from "react";
+import { useCrmApi } from "./use-crm-api.js";
+const READ_FAILED = 'The capture address could not be read.';
+const ROTATE_FAILED = 'The capture address could not be rotated.';
+const addressOf = (payload)=>typeof payload['address'] === 'string' ? payload['address'] : '';
+/**
+ * The workspace's email capture address (AGL-2657), asked of
+ * `crm/inbound-address` when `enabled` turns on — a dialog's open, a
+ * settings card's mount — and never before: the first ask mints the token,
+ * and a surface that asked on every paint would mint on behalf of members
+ * who never wanted the address.
+ *
+ * The site is whatever the surface is mounted under; at the organization
+ * level `null`, and the route's org variant answers, because the address
+ * is the organization's whichever site asks.
+ */ export function useCrmInboundAddress(hostId, options) {
+    const { enabled } = options;
+    const crmApi = useCrmApi(hostId);
+    const [state, setState] = useState({
+        status: 'idle',
+        address: null,
+        error: null
+    });
+    const [rotating, setRotating] = useState(false);
+    useEffect(()=>{
+        if (!enabled) return undefined;
+        let cancelled = false;
+        setState({
+            status: 'loading',
+            address: null,
+            error: null
+        });
+        void crmApi('inbound-address', {}).then(({ response, payload })=>{
+            if (cancelled) return;
+            const address = addressOf(payload);
+            if (!response.ok || !address) {
+                var _payload_error;
+                setState({
+                    status: 'error',
+                    address: null,
+                    error: String((_payload_error = payload['error']) != null ? _payload_error : READ_FAILED)
+                });
+                return;
+            }
+            setState({
+                status: 'ready',
+                address,
+                error: null
+            });
+        }).catch((cause)=>{
+            console.error(cause);
+            if (!cancelled) setState({
+                status: 'error',
+                address: null,
+                error: READ_FAILED
+            });
+        });
+        return ()=>{
+            cancelled = true;
+        };
+    }, [
+        enabled,
+        crmApi
+    ]);
+    const rotate = useCallback(async ()=>{
+        setRotating(true);
+        try {
+            const { response, payload } = await crmApi('inbound-address', {
+                rotate: true
+            });
+            const address = addressOf(payload);
+            if (!response.ok || !address) {
+                var _payload_error;
+                return {
+                    ok: false,
+                    error: String((_payload_error = payload['error']) != null ? _payload_error : ROTATE_FAILED)
+                };
+            }
+            setState({
+                status: 'ready',
+                address,
+                error: null
+            });
+            return {
+                ok: true,
+                address
+            };
+        } catch (cause) {
+            console.error(cause);
+            return {
+                ok: false,
+                error: ROTATE_FAILED
+            };
+        } finally{
+            setRotating(false);
+        }
+    }, [
+        crmApi
+    ]);
+    return _extends({}, state, {
+        rotate,
+        rotating
+    });
+}
+export default useCrmInboundAddress;
+
+//# sourceMappingURL=use-crm-inbound-address.js.map

package/src/lib/components/use-crm-inbound-address.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/crm/src/lib/components/use-crm-inbound-address.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 */\n\n'use client'\n\nimport { useCallback, useEffect, useState } from 'react'\nimport { useCrmApi } from './use-crm-api'\n\n/** What the address route has answered so far. */\nexport type CrmInboundAddressState =\n  | { status: 'idle' | 'loading'; address: null; error: null }\n  | { status: 'ready'; address: string; error: null }\n  | { status: 'error'; address: null; error: string }\n\nexport type CrmInboundRotateResult =\n  | { ok: true; address: string }\n  | { ok: false; error: string }\n\nexport interface CrmInboundAddress {\n  status: CrmInboundAddressState['status']\n  address: string | null\n  error: string | null\n  /** Replaces the token; the new address is in the answer and in `address`. */\n  rotate: () => Promise<CrmInboundRotateResult>\n  rotating: boolean\n}\n\nconst READ_FAILED = 'The capture address could not be read.'\nconst ROTATE_FAILED = 'The capture address could not be rotated.'\n\nconst addressOf = (payload: Record<string, unknown>): string =>\n  typeof payload['address'] === 'string' ? payload['address'] : ''\n\n/**\n * The workspace's email capture address (AGL-2657), asked of\n * `crm/inbound-address` when `enabled` turns on — a dialog's open, a\n * settings card's mount — and never before: the first ask mints the token,\n * and a surface that asked on every paint would mint on behalf of members\n * who never wanted the address.\n *\n * The site is whatever the surface is mounted under; at the organization\n * level `null`, and the route's org variant answers, because the address\n * is the organization's whichever site asks.\n */\nexport function useCrmInboundAddress(\n  hostId: string | null,\n  options: { enabled: boolean },\n): CrmInboundAddress {\n  const { enabled } = options\n  const crmApi = useCrmApi(hostId)\n  const [state, setState] = useState<CrmInboundAddressState>({\n    status: 'idle',\n    address: null,\n    error: null,\n  })\n  const [rotating, setRotating] = useState(false)\n\n  useEffect(() => {\n    if (!enabled) return undefined\n    let cancelled = false\n    setState({ status: 'loading', address: null, error: null })\n    void crmApi('inbound-address', {})\n      .then(({ response, payload }) => {\n        if (cancelled) return\n        const address = addressOf(payload)\n        if (!response.ok || !address) {\n          setState({\n            status: 'error',\n            address: null,\n            error: String(payload['error'] ?? READ_FAILED),\n          })\n          return\n        }\n        setState({ status: 'ready', address, error: null })\n      })\n      .catch((cause) => {\n        console.error(cause)\n        if (!cancelled) setState({ status: 'error', address: null, error: READ_FAILED })\n      })\n    return () => {\n      cancelled = true\n    }\n  }, [enabled, crmApi])\n\n  const rotate = useCallback(async (): Promise<CrmInboundRotateResult> => {\n    setRotating(true)\n    try {\n      const { response, payload } = await crmApi('inbound-address', { rotate: true })\n      const address = addressOf(payload)\n      if (!response.ok || !address) {\n        return { ok: false, error: String(payload['error'] ?? ROTATE_FAILED) }\n      }\n      setState({ status: 'ready', address, error: null })\n      return { ok: true, address }\n    } catch (cause) {\n      console.error(cause)\n      return { ok: false, error: ROTATE_FAILED }\n    } finally {\n      setRotating(false)\n    }\n  }, [crmApi])\n\n  return { ...state, rotate, rotating }\n}\n\nexport default useCrmInboundAddress\n"],"names":["useCallback","useEffect","useState","useCrmApi","READ_FAILED","ROTATE_FAILED","addressOf","payload","useCrmInboundAddress","hostId","options","enabled","crmApi","state","setState","status","address","error","rotating","setRotating","undefined","cancelled","then","response","ok","String","catch","cause","console","rotate"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED;;AAEA,SAASA,WAAW,EAAEC,SAAS,EAAEC,QAAQ,QAAQ,QAAO;AACxD,SAASC,SAAS,QAAQ,mBAAe;AAqBzC,MAAMC,cAAc;AACpB,MAAMC,gBAAgB;AAEtB,MAAMC,YAAY,CAACC,UACjB,OAAOA,OAAO,CAAC,UAAU,KAAK,WAAWA,OAAO,CAAC,UAAU,GAAG;AAEhE;;;;;;;;;;CAUC,GACD,OAAO,SAASC,qBACdC,MAAqB,EACrBC,OAA6B;IAE7B,MAAM,EAAEC,OAAO,EAAE,GAAGD;IACpB,MAAME,SAAST,UAAUM;IACzB,MAAM,CAACI,OAAOC,SAAS,GAAGZ,SAAiC;QACzDa,QAAQ;QACRC,SAAS;QACTC,OAAO;IACT;IACA,MAAM,CAACC,UAAUC,YAAY,GAAGjB,SAAS;IAEzCD,UAAU;QACR,IAAI,CAACU,SAAS,OAAOS;QACrB,IAAIC,YAAY;QAChBP,SAAS;YAAEC,QAAQ;YAAWC,SAAS;YAAMC,OAAO;QAAK;QACzD,KAAKL,OAAO,mBAAmB,CAAC,GAC7BU,IAAI,CAAC,CAAC,EAAEC,QAAQ,EAAEhB,OAAO,EAAE;YAC1B,IAAIc,WAAW;YACf,MAAML,UAAUV,UAAUC;YAC1B,IAAI,CAACgB,SAASC,EAAE,IAAI,CAACR,SAAS;oBAIZT;gBAHhBO,SAAS;oBACPC,QAAQ;oBACRC,SAAS;oBACTC,OAAOQ,QAAOlB,iBAAAA,OAAO,CAAC,QAAQ,YAAhBA,iBAAoBH;gBACpC;gBACA;YACF;YACAU,SAAS;gBAAEC,QAAQ;gBAASC;gBAASC,OAAO;YAAK;QACnD,GACCS,KAAK,CAAC,CAACC;YACNC,QAAQX,KAAK,CAACU;YACd,IAAI,CAACN,WAAWP,SAAS;gBAAEC,QAAQ;gBAASC,SAAS;gBAAMC,OAAOb;YAAY;QAChF;QACF,OAAO;YACLiB,YAAY;QACd;IACF,GAAG;QAACV;QAASC;KAAO;IAEpB,MAAMiB,SAAS7B,YAAY;QACzBmB,YAAY;QACZ,IAAI;YACF,MAAM,EAAEI,QAAQ,EAAEhB,OAAO,EAAE,GAAG,MAAMK,OAAO,mBAAmB;gBAAEiB,QAAQ;YAAK;YAC7E,MAAMb,UAAUV,UAAUC;YAC1B,IAAI,CAACgB,SAASC,EAAE,IAAI,CAACR,SAAS;oBACMT;gBAAlC,OAAO;oBAAEiB,IAAI;oBAAOP,OAAOQ,QAAOlB,iBAAAA,OAAO,CAAC,QAAQ,YAAhBA,iBAAoBF;gBAAe;YACvE;YACAS,SAAS;gBAAEC,QAAQ;gBAASC;gBAASC,OAAO;YAAK;YACjD,OAAO;gBAAEO,IAAI;gBAAMR;YAAQ;QAC7B,EAAE,OAAOW,OAAO;YACdC,QAAQX,KAAK,CAACU;YACd,OAAO;gBAAEH,IAAI;gBAAOP,OAAOZ;YAAc;QAC3C,SAAU;YACRc,YAAY;QACd;IACF,GAAG;QAACP;KAAO;IAEX,OAAO,aAAKC;QAAOgB;QAAQX;;AAC7B;AAEA,eAAeV,qBAAoB"}

package/src/lib/components/use-emails-hub-path.d.ts

@@ -0,0 +1,24 @@
+/**
+ * The Emails hub of the site this page is on — `/{org}/hosts/{site}/emails`
+ * — or `null` when the page is not under a site.
+ *
+ * The sibling-hub pattern the Emails console uses to reach Marketing, in the
+ * other direction: a CRM record page links a campaign entry to the email's
+ * own report, which lives on the Emails surface, and the shell's `basePath`
+ * names only this surface. Read off the URL rather than derived from
+ * `basePath`, because the `[host]` segment is the site's subdomain and
+ * nothing a CRM component holds says what that is.
+ *
+ * ⚠️ Under a site, THIS SITE's hub only. A record page under one site cannot
+ * address a sibling site's Emails console without that site's subdomain,
+ * which a contact document does not carry.
+ *
+ * At the ORGANIZATION level (AGL-2634) the URL names no site, and the mount
+ * holds the org's site list instead: handed a `hostId`, this answers that
+ * site's hub — `${hostsPath}/${subdomain}/emails` — or `null` for a site
+ * whose subdomain the list could not answer, which is named and not linked.
+ * Handed none, `null`: an org-level page has no hub of its own to fall
+ * back to.
+ */
+export declare function useEmailsHubPath(hostId?: string | null): string | null;
+export default useEmailsHubPath;

package/src/lib/components/use-emails-hub-path.js

@@ -0,0 +1,59 @@
+/**
+ * @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 { buildRoute, Route } from "@aglyn/aglyn";
+import { useParams } from "next/navigation";
+import { useCrmOrgMount } from "../hooks/use-crm-org-mount.js";
+/**
+ * The Emails hub of the site this page is on — `/{org}/hosts/{site}/emails`
+ * — or `null` when the page is not under a site.
+ *
+ * The sibling-hub pattern the Emails console uses to reach Marketing, in the
+ * other direction: a CRM record page links a campaign entry to the email's
+ * own report, which lives on the Emails surface, and the shell's `basePath`
+ * names only this surface. Read off the URL rather than derived from
+ * `basePath`, because the `[host]` segment is the site's subdomain and
+ * nothing a CRM component holds says what that is.
+ *
+ * ⚠️ Under a site, THIS SITE's hub only. A record page under one site cannot
+ * address a sibling site's Emails console without that site's subdomain,
+ * which a contact document does not carry.
+ *
+ * At the ORGANIZATION level (AGL-2634) the URL names no site, and the mount
+ * holds the org's site list instead: handed a `hostId`, this answers that
+ * site's hub — `${hostsPath}/${subdomain}/emails` — or `null` for a site
+ * whose subdomain the list could not answer, which is named and not linked.
+ * Handed none, `null`: an org-level page has no hub of its own to fall
+ * back to.
+ */ export function useEmailsHubPath(hostId) {
+    const params = useParams();
+    const mount = useCrmOrgMount();
+    const orgSlug = params == null ? void 0 : params.orgSlug;
+    const host = params == null ? void 0 : params.host;
+    if (orgSlug && host) {
+        return buildRoute(Route.HOST_PLUGIN, {
+            orgSlug,
+            host,
+            pluginSlug: 'emails'
+        });
+    }
+    if (!mount || !hostId) return null;
+    const subdomain = mount.siteSubdomain(hostId);
+    return subdomain ? `${mount.hostsPath}/${encodeURIComponent(subdomain)}/emails` : null;
+}
+export default useEmailsHubPath;
+
+//# sourceMappingURL=use-emails-hub-path.js.map