@aglyn/plugins-outreach 1.0.0-beta.143

package/src/lib/components/sequences-section.js

@@ -0,0 +1,310 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ 'use client';
+import { _ as _extends } from "@swc/helpers/_/_extends";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { pluginDocsHelp } from "@aglyn/aglyn";
+import { mdiPlus } from "@aglyn/shared-data-mdi";
+import { CardDisplay, MdiIcon } from "@aglyn/shared-ui-jsx";
+import EmptyStateComponent from "@aglyn/shared-ui-jsx/components/empty-state.component";
+import { ListPagination } from "@aglyn/shared-ui-jsx/components/list-pagination.component";
+import { ListTable } from "@aglyn/shared-ui-jsx/components/list-table.component";
+import { TABLE_PAGE_SIZE_DEFAULT } from "@aglyn/shared-ui-jsx/const/table-pagination";
+import { Button, Card, CardContent, Chip, Stack, Typography, useMediaQuery, useTheme } from "@mui/material";
+import { useState } from "react";
+import { OutreachLink, OutreachLoading, OutreachLoadProblem, OutreachSequenceStatusChip, useOutreachNavigate } from "./outreach-ui.js";
+import { OutreachSequenceDetail } from "./sequence-detail.js";
+import { OutreachSequenceEditor } from "./sequence-editor.js";
+import { useOutreachApi } from "./use-outreach-api.js";
+import { useOutreachSequenceCounts, useOutreachSequences } from "./use-outreach-data.js";
+import { useOutreachMailboxes } from "./use-outreach-mailboxes.js";
+import { useOutreachComplianceSettings } from "./use-outreach-settings.js";
+/** The new-sequence page's segment below the section. */ export const OUTREACH_NEW_SEQUENCE_SEGMENT = 'new';
+/**
+ * The Sequences section (AGL-2980), and the pages below it: the list, a new
+ * sequence, and one sequence's steps and enrollments. Each is a real URL, so
+ * a sequence is a link a rep can keep and the back button walks them.
+ */ export function OutreachSequencesSection(props) {
+    const { orgId, sectionPath, subpath } = props;
+    const api = useOutreachApi(orgId);
+    const settings = useOutreachComplianceSettings(api, orgId);
+    const mailboxes = useOutreachMailboxes(orgId);
+    const navigate = useOutreachNavigate();
+    if (!orgId) return /*#__PURE__*/ _jsx(OutreachLoading, {
+        label: "Loading sequences…"
+    });
+    const [first, second] = subpath;
+    if (first === OUTREACH_NEW_SEQUENCE_SEGMENT) {
+        return /*#__PURE__*/ _jsxs(Stack, {
+            spacing: 2,
+            children: [
+                /*#__PURE__*/ _jsx(OutreachLink, {
+                    href: sectionPath,
+                    children: "Sequences"
+                }),
+                /*#__PURE__*/ _jsx(Typography, {
+                    variant: "h5",
+                    component: "h2",
+                    children: "New sequence"
+                }),
+                /*#__PURE__*/ _jsx(OutreachSequenceEditor, {
+                    orgId: orgId,
+                    orgMount: props.orgMount,
+                    sequence: null,
+                    settings: settings,
+                    mailboxes: mailboxes,
+                    mailboxesPath: props.mailboxesPath,
+                    onSaved: (sequence)=>navigate(`${sectionPath}/${sequence.id}`),
+                    onCancel: ()=>navigate(sectionPath)
+                })
+            ]
+        });
+    }
+    if (first) {
+        return /*#__PURE__*/ _jsx(OutreachSequenceDetail, {
+            orgId: orgId,
+            orgMount: props.orgMount,
+            org: props.org,
+            sectionPath: sectionPath,
+            sequenceId: first,
+            tab: second === 'enrollments' ? 'enrollments' : 'steps',
+            settings: settings,
+            mailboxes: mailboxes,
+            mailboxesPath: props.mailboxesPath,
+            compliancePath: props.compliancePath
+        });
+    }
+    return /*#__PURE__*/ _jsx(OutreachSequenceList, {
+        orgId: orgId,
+        sectionPath: sectionPath,
+        mailboxes: mailboxes.mailboxes
+    });
+}
+OutreachSequencesSection.displayName = 'OutreachSequencesSection';
+const COUNT_COLUMNS = [
+    [
+        'enrolled',
+        'Enrolled'
+    ],
+    [
+        'active',
+        'Active'
+    ],
+    [
+        'replied',
+        'Replied'
+    ],
+    [
+        'bounced',
+        'Bounced'
+    ],
+    [
+        'optedOut',
+        'Opted out'
+    ]
+];
+/**
+ * Every sequence: its mailbox, its status, and how many people it enrolled
+ * and where they stand — a table on wider screens, cards on a phone.
+ */ export function OutreachSequenceList(props) {
+    const { orgId, sectionPath } = props;
+    const theme = useTheme();
+    const narrow = useMediaQuery(theme.breakpoints.down('md'));
+    const navigate = useOutreachNavigate();
+    const sequences = useOutreachSequences(orgId);
+    const [page, setPage] = useState(0);
+    const [pageSize, setPageSize] = useState(TABLE_PAGE_SIZE_DEFAULT);
+    const pageRows = sequences.data.slice(page * pageSize, (page + 1) * pageSize);
+    // Counted for the page on screen only: five aggregations a sequence.
+    const counts = useOutreachSequenceCounts(orgId, pageRows.map((sequence)=>sequence.id));
+    const footer = /*#__PURE__*/ _jsx(ListPagination, {
+        page: page,
+        pageSize: pageSize,
+        rowCount: pageRows.length,
+        count: sequences.data.length,
+        onPageChange: setPage,
+        onPageSizeChange: setPageSize
+    });
+    const newHref = `${sectionPath}/${OUTREACH_NEW_SEQUENCE_SEGMENT}`;
+    const newButton = /*#__PURE__*/ _jsx(Button, {
+        variant: "contained",
+        startIcon: /*#__PURE__*/ _jsx(MdiIcon, {
+            path: mdiPlus.path,
+            fontSize: "small"
+        }),
+        href: newHref,
+        onClick: (event)=>{
+            event.preventDefault();
+            navigate(newHref);
+        },
+        children: "New sequence"
+    });
+    const mailboxLabel = (sequence)=>{
+        const mailbox = props.mailboxes.find((entry)=>entry.id === sequence.mailboxId);
+        return mailbox ? mailbox.sendAs || mailbox.email : sequence.mailboxId ? 'Mailbox removed' : 'No mailbox yet';
+    };
+    const count = (sequence, key)=>counts[sequence.id] ? String(counts[sequence.id][key]) : '—';
+    let body;
+    if (sequences.status === 'loading') body = /*#__PURE__*/ _jsx(OutreachLoading, {
+        label: "Loading sequences…"
+    });
+    else if (sequences.status === 'error' || sequences.status === 'refused') {
+        body = /*#__PURE__*/ _jsx(OutreachLoadProblem, {
+            status: sequences.status,
+            what: "sequences"
+        });
+    } else if (!sequences.data.length) {
+        body = /*#__PURE__*/ _jsx(Card, {
+            variant: "outlined",
+            children: /*#__PURE__*/ _jsx(EmptyStateComponent, {
+                label: "No sequences yet",
+                description: "A sequence is the emails, and the tasks between them, one person gets from one rep.",
+                action: newButton
+            })
+        });
+    } else if (narrow) {
+        body = /*#__PURE__*/ _jsxs(Stack, {
+            spacing: 1,
+            children: [
+                /*#__PURE__*/ _jsx(Stack, {
+                    spacing: 1,
+                    component: "ul",
+                    sx: {
+                        listStyle: 'none',
+                        p: 0,
+                        m: 0
+                    },
+                    "aria-label": "Sequences",
+                    children: pageRows.map((sequence)=>/*#__PURE__*/ _jsx(Card, {
+                            variant: "outlined",
+                            component: "li",
+                            children: /*#__PURE__*/ _jsx(CardContent, {
+                                children: /*#__PURE__*/ _jsxs(Stack, {
+                                    spacing: 1,
+                                    children: [
+                                        /*#__PURE__*/ _jsxs(Stack, {
+                                            direction: "row",
+                                            spacing: 1,
+                                            sx: {
+                                                alignItems: 'center',
+                                                justifyContent: 'space-between'
+                                            },
+                                            children: [
+                                                /*#__PURE__*/ _jsx(OutreachLink, {
+                                                    href: `${sectionPath}/${sequence.id}`,
+                                                    children: sequence.name || 'Untitled'
+                                                }),
+                                                /*#__PURE__*/ _jsx(OutreachSequenceStatusChip, {
+                                                    status: sequence.status
+                                                })
+                                            ]
+                                        }),
+                                        /*#__PURE__*/ _jsx(Typography, {
+                                            variant: "body2",
+                                            color: "text.secondary",
+                                            children: mailboxLabel(sequence)
+                                        }),
+                                        /*#__PURE__*/ _jsx(Stack, {
+                                            direction: "row",
+                                            spacing: 0.5,
+                                            sx: {
+                                                flexWrap: 'wrap',
+                                                rowGap: 0.5
+                                            },
+                                            children: COUNT_COLUMNS.map(([key, label])=>/*#__PURE__*/ _jsx(Chip, {
+                                                    size: "small",
+                                                    variant: "outlined",
+                                                    label: `${label} ${count(sequence, key)}`
+                                                }, key))
+                                        })
+                                    ]
+                                })
+                            })
+                        }, sequence.id))
+                }),
+                footer
+            ]
+        });
+    } else {
+        const columns = [
+            {
+                field: 'name',
+                headerName: 'Name',
+                flex: 1,
+                minWidth: 180
+            },
+            {
+                field: 'mailbox',
+                headerName: 'Mailbox',
+                flex: 1,
+                minWidth: 180
+            },
+            {
+                field: 'status',
+                headerName: 'Status',
+                width: 110,
+                renderCell: ({ row })=>/*#__PURE__*/ _jsx(OutreachSequenceStatusChip, {
+                        status: row.status
+                    })
+            },
+            ...COUNT_COLUMNS.map(([key, label])=>({
+                    field: key,
+                    headerName: label,
+                    width: 96,
+                    align: 'right',
+                    headerAlign: 'right'
+                }))
+        ];
+        body = /*#__PURE__*/ _jsxs(Stack, {
+            spacing: 1,
+            children: [
+                /*#__PURE__*/ _jsx(ListTable, {
+                    "aria-label": "Sequences",
+                    columns: columns,
+                    rows: pageRows.map((sequence)=>_extends({
+                            $id: sequence.id,
+                            name: sequence.name || 'Untitled',
+                            mailbox: mailboxLabel(sequence),
+                            status: sequence.status
+                        }, Object.fromEntries(COUNT_COLUMNS.map(([key])=>[
+                                key,
+                                count(sequence, key)
+                            ])))),
+                    onOpen: (id)=>navigate(`${sectionPath}/${id}`),
+                    quickFilter: false,
+                    hideFooter: true
+                }),
+                footer
+            ]
+        });
+    }
+    return /*#__PURE__*/ _jsx(CardDisplay, {
+        header: "Sequences",
+        help: pluginDocsHelp('sequences', {
+            anchor: '#sequences'
+        }),
+        HeaderProps: {
+            action: sequences.status === 'ready' && sequences.data.length ? newButton : undefined
+        },
+        contentGutterX: true,
+        contentGutterY: true,
+        children: body
+    });
+}
+OutreachSequenceList.displayName = 'OutreachSequenceList';
+export default OutreachSequencesSection;
+
+//# sourceMappingURL=sequences-section.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/outreach/src/lib/components/sequences-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 { pluginDocsHelp, type ConsolePluginOrgMount } from '@aglyn/aglyn'\nimport { mdiPlus } from '@aglyn/shared-data-mdi'\nimport { CardDisplay, MdiIcon } from '@aglyn/shared-ui-jsx'\nimport EmptyStateComponent from '@aglyn/shared-ui-jsx/components/empty-state.component'\nimport { ListPagination } from '@aglyn/shared-ui-jsx/components/list-pagination.component'\nimport {\n  ListTable,\n  type ListTableProps,\n} from '@aglyn/shared-ui-jsx/components/list-table.component'\nimport { TABLE_PAGE_SIZE_DEFAULT } from '@aglyn/shared-ui-jsx/const/table-pagination'\nimport {\n  Button,\n  Card,\n  CardContent,\n  Chip,\n  Stack,\n  Typography,\n  useMediaQuery,\n  useTheme,\n} from '@mui/material'\nimport { useState } from 'react'\nimport type { OutreachMailbox, OutreachSequence } from '../model/outreach.types'\nimport {\n  OutreachLink,\n  OutreachLoading,\n  OutreachLoadProblem,\n  OutreachSequenceStatusChip,\n  useOutreachNavigate,\n} from './outreach-ui'\nimport {\n  OutreachSequenceDetail,\n  type OutreachSequenceTab,\n} from './sequence-detail'\nimport { OutreachSequenceEditor } from './sequence-editor'\nimport { useOutreachApi } from './use-outreach-api'\nimport {\n  type OutreachSequenceCounts,\n  useOutreachSequenceCounts,\n  useOutreachSequences,\n} from './use-outreach-data'\nimport { useOutreachMailboxes } from './use-outreach-mailboxes'\nimport { useOutreachComplianceSettings } from './use-outreach-settings'\n\nexport interface OutreachSequencesSectionProps {\n  /** The organization the hub is mounted under; `null` until the shell knows it. */\n  orgId: string | null\n  orgMount?: ConsolePluginOrgMount\n  org?: Record<string, unknown> | null\n  /** The section's own path: `/[orgSlug]/outreach/sequences`. */\n  sectionPath: string\n  /** The path below the section: `[]`, `['new']`, `[id]` or `[id, 'enrollments']`. */\n  subpath: readonly string[]\n  /** The Mailboxes section: `/[orgSlug]/outreach/mailboxes`. */\n  mailboxesPath: string\n  /** The Compliance section: `/[orgSlug]/outreach/compliance`. */\n  compliancePath: string\n}\n\n/** The new-sequence page's segment below the section. */\nexport const OUTREACH_NEW_SEQUENCE_SEGMENT = 'new'\n\n/**\n * The Sequences section (AGL-2980), and the pages below it: the list, a new\n * sequence, and one sequence's steps and enrollments. Each is a real URL, so\n * a sequence is a link a rep can keep and the back button walks them.\n */\nexport function OutreachSequencesSection(props: OutreachSequencesSectionProps) {\n  const { orgId, sectionPath, subpath } = props\n  const api = useOutreachApi(orgId)\n  const settings = useOutreachComplianceSettings(api, orgId)\n  const mailboxes = useOutreachMailboxes(orgId)\n  const navigate = useOutreachNavigate()\n\n  if (!orgId) return <OutreachLoading label=\"Loading sequences…\" />\n  const [first, second] = subpath\n  if (first === OUTREACH_NEW_SEQUENCE_SEGMENT) {\n    return (\n      <Stack spacing={2}>\n        <OutreachLink href={sectionPath}>Sequences</OutreachLink>\n        <Typography variant=\"h5\" component=\"h2\">\n          New sequence\n        </Typography>\n        <OutreachSequenceEditor\n          orgId={orgId}\n          orgMount={props.orgMount}\n          sequence={null}\n          settings={settings}\n          mailboxes={mailboxes}\n          mailboxesPath={props.mailboxesPath}\n          onSaved={(sequence) => navigate(`${sectionPath}/${sequence.id}`)}\n          onCancel={() => navigate(sectionPath)}\n        />\n      </Stack>\n    )\n  }\n  if (first) {\n    return (\n      <OutreachSequenceDetail\n        orgId={orgId}\n        orgMount={props.orgMount}\n        org={props.org}\n        sectionPath={sectionPath}\n        sequenceId={first}\n        tab={\n          (second === 'enrollments'\n            ? 'enrollments'\n            : 'steps') as OutreachSequenceTab\n        }\n        settings={settings}\n        mailboxes={mailboxes}\n        mailboxesPath={props.mailboxesPath}\n        compliancePath={props.compliancePath}\n      />\n    )\n  }\n  return (\n    <OutreachSequenceList\n      orgId={orgId}\n      sectionPath={sectionPath}\n      mailboxes={mailboxes.mailboxes}\n    />\n  )\n}\nOutreachSequencesSection.displayName = 'OutreachSequencesSection'\n\nconst COUNT_COLUMNS: ReadonlyArray<[keyof OutreachSequenceCounts, string]> = [\n  ['enrolled', 'Enrolled'],\n  ['active', 'Active'],\n  ['replied', 'Replied'],\n  ['bounced', 'Bounced'],\n  ['optedOut', 'Opted out'],\n]\n\n/**\n * Every sequence: its mailbox, its status, and how many people it enrolled\n * and where they stand — a table on wider screens, cards on a phone.\n */\nexport function OutreachSequenceList(props: {\n  orgId: string\n  sectionPath: string\n  mailboxes: readonly OutreachMailbox[]\n}) {\n  const { orgId, sectionPath } = props\n  const theme = useTheme()\n  const narrow = useMediaQuery(theme.breakpoints.down('md'))\n  const navigate = useOutreachNavigate()\n  const sequences = useOutreachSequences(orgId)\n  const [page, setPage] = useState(0)\n  const [pageSize, setPageSize] = useState(TABLE_PAGE_SIZE_DEFAULT)\n  const pageRows = sequences.data.slice(page * pageSize, (page + 1) * pageSize)\n  // Counted for the page on screen only: five aggregations a sequence.\n  const counts = useOutreachSequenceCounts(\n    orgId,\n    pageRows.map((sequence) => sequence.id),\n  )\n  const footer = (\n    <ListPagination\n      page={page}\n      pageSize={pageSize}\n      rowCount={pageRows.length}\n      count={sequences.data.length}\n      onPageChange={setPage}\n      onPageSizeChange={setPageSize}\n    />\n  )\n  const newHref = `${sectionPath}/${OUTREACH_NEW_SEQUENCE_SEGMENT}`\n  const newButton = (\n    <Button\n      variant=\"contained\"\n      startIcon={<MdiIcon path={mdiPlus.path} fontSize=\"small\" />}\n      href={newHref}\n      onClick={(event) => {\n        event.preventDefault()\n        navigate(newHref)\n      }}\n    >\n      New sequence\n    </Button>\n  )\n  const mailboxLabel = (sequence: OutreachSequence) => {\n    const mailbox = props.mailboxes.find(\n      (entry) => entry.id === sequence.mailboxId,\n    )\n    return mailbox\n      ? mailbox.sendAs || mailbox.email\n      : sequence.mailboxId\n        ? 'Mailbox removed'\n        : 'No mailbox yet'\n  }\n  const count = (\n    sequence: OutreachSequence,\n    key: keyof OutreachSequenceCounts,\n  ) => (counts[sequence.id] ? String(counts[sequence.id][key]) : '—')\n\n  let body\n  if (sequences.status === 'loading')\n    body = <OutreachLoading label=\"Loading sequences…\" />\n  else if (sequences.status === 'error' || sequences.status === 'refused') {\n    body = <OutreachLoadProblem status={sequences.status} what=\"sequences\" />\n  } else if (!sequences.data.length) {\n    body = (\n      <Card variant=\"outlined\">\n        <EmptyStateComponent\n          label=\"No sequences yet\"\n          description=\"A sequence is the emails, and the tasks between them, one person gets from one rep.\"\n          action={newButton}\n        />\n      </Card>\n    )\n  } else if (narrow) {\n    body = (\n      <Stack spacing={1}>\n        <Stack\n          spacing={1}\n          component=\"ul\"\n          sx={{ listStyle: 'none', p: 0, m: 0 }}\n          aria-label=\"Sequences\"\n        >\n          {pageRows.map((sequence) => (\n            <Card key={sequence.id} variant=\"outlined\" component=\"li\">\n              <CardContent>\n                <Stack spacing={1}>\n                  <Stack\n                    direction=\"row\"\n                    spacing={1}\n                    sx={{\n                      alignItems: 'center',\n                      justifyContent: 'space-between',\n                    }}\n                  >\n                    <OutreachLink href={`${sectionPath}/${sequence.id}`}>\n                      {sequence.name || 'Untitled'}\n                    </OutreachLink>\n                    <OutreachSequenceStatusChip status={sequence.status} />\n                  </Stack>\n                  <Typography variant=\"body2\" color=\"text.secondary\">\n                    {mailboxLabel(sequence)}\n                  </Typography>\n                  <Stack\n                    direction=\"row\"\n                    spacing={0.5}\n                    sx={{ flexWrap: 'wrap', rowGap: 0.5 }}\n                  >\n                    {COUNT_COLUMNS.map(([key, label]) => (\n                      <Chip\n                        key={key}\n                        size=\"small\"\n                        variant=\"outlined\"\n                        label={`${label} ${count(sequence, key)}`}\n                      />\n                    ))}\n                  </Stack>\n                </Stack>\n              </CardContent>\n            </Card>\n          ))}\n        </Stack>\n        {footer}\n      </Stack>\n    )\n  } else {\n    const columns: NonNullable<ListTableProps['columns']> = [\n      { field: 'name', headerName: 'Name', flex: 1, minWidth: 180 },\n      { field: 'mailbox', headerName: 'Mailbox', flex: 1, minWidth: 180 },\n      {\n        field: 'status',\n        headerName: 'Status',\n        width: 110,\n        renderCell: ({ row }) => (\n          <OutreachSequenceStatusChip status={row.status} />\n        ),\n      },\n      ...COUNT_COLUMNS.map(([key, label]) => ({\n        field: key,\n        headerName: label,\n        width: 96,\n        align: 'right' as const,\n        headerAlign: 'right' as const,\n      })),\n    ]\n    body = (\n      <Stack spacing={1}>\n        <ListTable\n          aria-label=\"Sequences\"\n          columns={columns}\n          rows={pageRows.map((sequence) => ({\n            $id: sequence.id,\n            name: sequence.name || 'Untitled',\n            mailbox: mailboxLabel(sequence),\n            status: sequence.status,\n            ...Object.fromEntries(\n              COUNT_COLUMNS.map(([key]) => [key, count(sequence, key)]),\n            ),\n          }))}\n          onOpen={(id) => navigate(`${sectionPath}/${id}`)}\n          quickFilter={false}\n          hideFooter\n        />\n        {footer}\n      </Stack>\n    )\n  }\n\n  return (\n    <CardDisplay\n      header=\"Sequences\"\n      help={pluginDocsHelp('sequences', { anchor: '#sequences' })}\n      HeaderProps={{\n        action:\n          sequences.status === 'ready' && sequences.data.length\n            ? newButton\n            : undefined,\n      }}\n      contentGutterX\n      contentGutterY\n    >\n      {body}\n    </CardDisplay>\n  )\n}\nOutreachSequenceList.displayName = 'OutreachSequenceList'\n\nexport default OutreachSequencesSection\n"],"names":["pluginDocsHelp","mdiPlus","CardDisplay","MdiIcon","EmptyStateComponent","ListPagination","ListTable","TABLE_PAGE_SIZE_DEFAULT","Button","Card","CardContent","Chip","Stack","Typography","useMediaQuery","useTheme","useState","OutreachLink","OutreachLoading","OutreachLoadProblem","OutreachSequenceStatusChip","useOutreachNavigate","OutreachSequenceDetail","OutreachSequenceEditor","useOutreachApi","useOutreachSequenceCounts","useOutreachSequences","useOutreachMailboxes","useOutreachComplianceSettings","OUTREACH_NEW_SEQUENCE_SEGMENT","OutreachSequencesSection","props","orgId","sectionPath","subpath","api","settings","mailboxes","navigate","label","first","second","spacing","href","variant","component","orgMount","sequence","mailboxesPath","onSaved","id","onCancel","org","sequenceId","tab","compliancePath","OutreachSequenceList","displayName","COUNT_COLUMNS","theme","narrow","breakpoints","down","sequences","page","setPage","pageSize","setPageSize","pageRows","data","slice","counts","map","footer","rowCount","length","count","onPageChange","onPageSizeChange","newHref","newButton","startIcon","path","fontSize","onClick","event","preventDefault","mailboxLabel","mailbox","find","entry","mailboxId","sendAs","email","key","String","body","status","what","description","action","sx","listStyle","p","m","aria-label","direction","alignItems","justifyContent","name","color","flexWrap","rowGap","size","columns","field","headerName","flex","minWidth","width","renderCell","row","align","headerAlign","rows","$id","Object","fromEntries","onOpen","quickFilter","hideFooter","header","help","anchor","HeaderProps","undefined","contentGutterX","contentGutterY"],"mappings":"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"}

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

@@ -0,0 +1,38 @@
+import type { OutreachComplianceIssue } from '../model/compliance-settings';
+import type { OutreachEnrollmentAction, OutreachEnrollmentActionResponse, OutreachEnrollPersonRequest, OutreachEnrollPreviewResponse, OutreachEnrollResponse, OutreachEnrollSource, OutreachPreviewRequest, OutreachPreviewResponse, OutreachRouteRefusalReason, OutreachSequenceAction, OutreachSequenceSaveResponse, OutreachSequenceStatusResponse, OutreachSettingsResponse, OutreachSettingsSaveRequest, OutreachSettingsSaveResponse } from '../model/outreach-api';
+import type { OutreachSequenceDraft, OutreachSequenceIssue } from '../model/sequence-draft';
+/**
+ * A route's refusal, carrying its sentence, its stable reason and any
+ * field-level issues. `refused` is the one a page shows as "you can't use
+ * this here" rather than as something that went wrong: no permission, no
+ * entitlement, or the release gate answering as if the route did not exist.
+ */
+export declare class OutreachRouteError extends Error {
+    readonly reason: OutreachRouteRefusalReason | 'unreachable' | 'not-found';
+    readonly status: number;
+    readonly issues: ReadonlyArray<OutreachComplianceIssue | OutreachSequenceIssue>;
+    constructor(message: string, reason: OutreachRouteError['reason'], status: number, issues?: OutreachRouteError['issues']);
+    get refused(): boolean;
+}
+/** The routes, as the Outreach pages call them. */
+export interface OutreachApi {
+    readSettings(): Promise<OutreachSettingsResponse>;
+    saveSettings(input: Omit<OutreachSettingsSaveRequest, 'orgId'>): Promise<OutreachSettingsSaveResponse>;
+    saveSequence(sequenceId: string | null, sequence: OutreachSequenceDraft): Promise<OutreachSequenceSaveResponse>;
+    setSequenceStatus(sequenceId: string, action: OutreachSequenceAction): Promise<OutreachSequenceStatusResponse>;
+    deleteSequence(sequenceId: string): Promise<{
+        ok: true;
+    }>;
+    previewEnrollment(sequenceId: string, source: OutreachEnrollSource): Promise<OutreachEnrollPreviewResponse>;
+    enroll(sequenceId: string, people: OutreachEnrollPersonRequest[]): Promise<OutreachEnrollResponse>;
+    actOnEnrollment(enrollmentId: string, action: OutreachEnrollmentAction, detail?: string): Promise<OutreachEnrollmentActionResponse>;
+    previewEmail(input: Omit<OutreachPreviewRequest, 'orgId'>): Promise<OutreachPreviewResponse>;
+}
+/**
+ * The Outreach pages' one door to the settings, sequence and enrollment
+ * routes (AGL-2980), with the member's session attached and the
+ * organization named on every call. A refusal is thrown as an
+ * {@link OutreachRouteError} carrying the route's own sentence, which is
+ * written for the person reading it.
+ */
+export declare function useOutreachApi(orgId: string | null): OutreachApi;

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

@@ -0,0 +1,139 @@
+/**
+ * @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, useMemo } from "react";
+import { OUTREACH_API_ROUTES } from "../constants/api-routes.js";
+/**
+ * A route's refusal, carrying its sentence, its stable reason and any
+ * field-level issues. `refused` is the one a page shows as "you can't use
+ * this here" rather than as something that went wrong: no permission, no
+ * entitlement, or the release gate answering as if the route did not exist.
+ */ export class OutreachRouteError extends Error {
+    get refused() {
+        return this.reason === 'permission' || this.reason === 'entitlement' || this.reason === 'not-org-wide' || this.reason === 'not-a-member' || // The dispatcher answers a route whose plugin is not released to this
+        // workspace as though it did not exist.
+        this.reason === 'not-found';
+    }
+    constructor(message, reason, status, issues = []){
+        super(message);
+        this.name = 'OutreachRouteError';
+        this.reason = reason;
+        this.status = status;
+        this.issues = issues;
+    }
+}
+/**
+ * The Outreach pages' one door to the settings, sequence and enrollment
+ * routes (AGL-2980), with the member's session attached and the
+ * organization named on every call. A refusal is thrown as an
+ * {@link OutreachRouteError} carrying the route's own sentence, which is
+ * written for the person reading it.
+ */ export function useOutreachApi(orgId) {
+    const { data: user } = useUser();
+    const call = useCallback(async (route, init)=>{
+        if (!orgId) throw new OutreachRouteError('Open an organization first.', 'org-required', 400);
+        const path = init.method === 'GET' ? `/api/${route}?orgId=${encodeURIComponent(orgId)}` : `/api/${route}`;
+        let response;
+        try {
+            response = await authorizedFetch(user, path, _extends({
+                method: init.method
+            }, init.method === 'POST' ? {
+                headers: {
+                    'Content-Type': 'application/json'
+                },
+                body: JSON.stringify(_extends({
+                    orgId
+                }, init.body))
+            } : {}));
+        } catch (unused) {
+            throw new OutreachRouteError('Sequences could not be reached. Try again.', 'unreachable', 0);
+        }
+        const payload = await response.json().catch(()=>null);
+        if (!response.ok || !payload) {
+            var _refusal_reason, _refusal_issues;
+            const refusal = payload != null ? payload : {};
+            throw new OutreachRouteError(refusal.error && refusal.reason ? refusal.error : response.status === 404 ? "Sequences isn't available to this workspace yet." : 'Sequences could not be reached. Try again.', (_refusal_reason = refusal.reason) != null ? _refusal_reason : response.status === 404 ? 'not-found' : 'unreachable', response.status, (_refusal_issues = refusal.issues) != null ? _refusal_issues : []);
+        }
+        return payload;
+    }, [
+        user,
+        orgId
+    ]);
+    return useMemo(()=>({
+            readSettings: ()=>call(OUTREACH_API_ROUTES.settings, {
+                    method: 'GET'
+                }),
+            saveSettings: (input)=>call(OUTREACH_API_ROUTES.settings, {
+                    method: 'POST',
+                    body: _extends({}, input)
+                }),
+            saveSequence: (sequenceId, sequence)=>call(OUTREACH_API_ROUTES.sequencesSave, {
+                    method: 'POST',
+                    body: _extends({}, sequenceId ? {
+                        sequenceId
+                    } : {}, {
+                        sequence
+                    })
+                }),
+            setSequenceStatus: (sequenceId, action)=>call(OUTREACH_API_ROUTES.sequencesStatus, {
+                    method: 'POST',
+                    body: {
+                        sequenceId,
+                        action
+                    }
+                }),
+            deleteSequence: (sequenceId)=>call(OUTREACH_API_ROUTES.sequencesDelete, {
+                    method: 'POST',
+                    body: {
+                        sequenceId
+                    }
+                }),
+            previewEnrollment: (sequenceId, source)=>call(OUTREACH_API_ROUTES.enrollPreview, {
+                    method: 'POST',
+                    body: {
+                        sequenceId,
+                        source
+                    }
+                }),
+            enroll: (sequenceId, people)=>call(OUTREACH_API_ROUTES.enroll, {
+                    method: 'POST',
+                    body: {
+                        sequenceId,
+                        people
+                    }
+                }),
+            actOnEnrollment: (enrollmentId, action, detail)=>call(OUTREACH_API_ROUTES.enrollmentsAction, {
+                    method: 'POST',
+                    body: _extends({
+                        enrollmentId,
+                        action
+                    }, detail ? {
+                        detail
+                    } : {})
+                }),
+            previewEmail: (input)=>call(OUTREACH_API_ROUTES.preview, {
+                    method: 'POST',
+                    body: _extends({}, input)
+                })
+        }), [
+        call
+    ]);
+}
+
+//# sourceMappingURL=use-outreach-api.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/outreach/src/lib/components/use-outreach-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 { authorizedFetch } from '@aglyn/shared-util-http/authorized-token'\nimport { useUser } from '@aglyn/tenant-feature-instance'\nimport { useCallback, useMemo } from 'react'\nimport { OUTREACH_API_ROUTES } from '../constants/api-routes'\nimport type { OutreachComplianceIssue } from '../model/compliance-settings'\nimport type {\n  OutreachEnrollmentAction,\n  OutreachEnrollmentActionResponse,\n  OutreachEnrollPersonRequest,\n  OutreachEnrollPreviewResponse,\n  OutreachEnrollResponse,\n  OutreachEnrollSource,\n  OutreachPreviewRequest,\n  OutreachPreviewResponse,\n  OutreachRouteRefusal,\n  OutreachRouteRefusalReason,\n  OutreachSequenceAction,\n  OutreachSequenceSaveResponse,\n  OutreachSequenceStatusResponse,\n  OutreachSettingsResponse,\n  OutreachSettingsSaveRequest,\n  OutreachSettingsSaveResponse,\n} from '../model/outreach-api'\nimport type {\n  OutreachSequenceDraft,\n  OutreachSequenceIssue,\n} from '../model/sequence-draft'\n\n/**\n * A route's refusal, carrying its sentence, its stable reason and any\n * field-level issues. `refused` is the one a page shows as \"you can't use\n * this here\" rather than as something that went wrong: no permission, no\n * entitlement, or the release gate answering as if the route did not exist.\n */\nexport class OutreachRouteError extends Error {\n  readonly reason: OutreachRouteRefusalReason | 'unreachable' | 'not-found'\n  readonly status: number\n  readonly issues: ReadonlyArray<\n    OutreachComplianceIssue | OutreachSequenceIssue\n  >\n\n  constructor(\n    message: string,\n    reason: OutreachRouteError['reason'],\n    status: number,\n    issues: OutreachRouteError['issues'] = [],\n  ) {\n    super(message)\n    this.name = 'OutreachRouteError'\n    this.reason = reason\n    this.status = status\n    this.issues = issues\n  }\n\n  get refused(): boolean {\n    return (\n      this.reason === 'permission' ||\n      this.reason === 'entitlement' ||\n      this.reason === 'not-org-wide' ||\n      this.reason === 'not-a-member' ||\n      // The dispatcher answers a route whose plugin is not released to this\n      // workspace as though it did not exist.\n      this.reason === 'not-found'\n    )\n  }\n}\n\n/** The routes, as the Outreach pages call them. */\nexport interface OutreachApi {\n  readSettings(): Promise<OutreachSettingsResponse>\n  saveSettings(\n    input: Omit<OutreachSettingsSaveRequest, 'orgId'>,\n  ): Promise<OutreachSettingsSaveResponse>\n  saveSequence(\n    sequenceId: string | null,\n    sequence: OutreachSequenceDraft,\n  ): Promise<OutreachSequenceSaveResponse>\n  setSequenceStatus(\n    sequenceId: string,\n    action: OutreachSequenceAction,\n  ): Promise<OutreachSequenceStatusResponse>\n  deleteSequence(sequenceId: string): Promise<{ ok: true }>\n  previewEnrollment(\n    sequenceId: string,\n    source: OutreachEnrollSource,\n  ): Promise<OutreachEnrollPreviewResponse>\n  enroll(\n    sequenceId: string,\n    people: OutreachEnrollPersonRequest[],\n  ): Promise<OutreachEnrollResponse>\n  actOnEnrollment(\n    enrollmentId: string,\n    action: OutreachEnrollmentAction,\n    detail?: string,\n  ): Promise<OutreachEnrollmentActionResponse>\n  previewEmail(\n    input: Omit<OutreachPreviewRequest, 'orgId'>,\n  ): Promise<OutreachPreviewResponse>\n}\n\n/**\n * The Outreach pages' one door to the settings, sequence and enrollment\n * routes (AGL-2980), with the member's session attached and the\n * organization named on every call. A refusal is thrown as an\n * {@link OutreachRouteError} carrying the route's own sentence, which is\n * written for the person reading it.\n */\nexport function useOutreachApi(orgId: string | null): OutreachApi {\n  const { data: user } = useUser()\n\n  const call = useCallback(\n    async <T>(\n      route: string,\n      init: { method: 'GET' | 'POST'; body?: Record<string, unknown> },\n    ): Promise<T> => {\n      if (!orgId)\n        throw new OutreachRouteError(\n          'Open an organization first.',\n          'org-required',\n          400,\n        )\n      const path =\n        init.method === 'GET'\n          ? `/api/${route}?orgId=${encodeURIComponent(orgId)}`\n          : `/api/${route}`\n      let response: Response\n      try {\n        response = await authorizedFetch(user, path, {\n          method: init.method,\n          ...(init.method === 'POST'\n            ? {\n                headers: { 'Content-Type': 'application/json' },\n                body: JSON.stringify({ orgId, ...init.body }),\n              }\n            : {}),\n        })\n      } catch {\n        throw new OutreachRouteError(\n          'Sequences could not be reached. Try again.',\n          'unreachable',\n          0,\n        )\n      }\n      const payload = (await response.json().catch(() => null)) as\n        (T & { error?: undefined }) | Partial<OutreachRouteRefusal> | null\n      if (!response.ok || !payload) {\n        const refusal = (payload ?? {}) as Partial<OutreachRouteRefusal>\n        throw new OutreachRouteError(\n          refusal.error && refusal.reason\n            ? refusal.error\n            : response.status === 404\n              ? \"Sequences isn't available to this workspace yet.\"\n              : 'Sequences could not be reached. Try again.',\n          refusal.reason ??\n            (response.status === 404 ? 'not-found' : 'unreachable'),\n          response.status,\n          refusal.issues ?? [],\n        )\n      }\n      return payload as T\n    },\n    [user, orgId],\n  )\n\n  return useMemo<OutreachApi>(\n    () => ({\n      readSettings: () => call(OUTREACH_API_ROUTES.settings, { method: 'GET' }),\n      saveSettings: (input) =>\n        call(OUTREACH_API_ROUTES.settings, {\n          method: 'POST',\n          body: { ...input },\n        }),\n      saveSequence: (sequenceId, sequence) =>\n        call(OUTREACH_API_ROUTES.sequencesSave, {\n          method: 'POST',\n          body: { ...(sequenceId ? { sequenceId } : {}), sequence },\n        }),\n      setSequenceStatus: (sequenceId, action) =>\n        call(OUTREACH_API_ROUTES.sequencesStatus, {\n          method: 'POST',\n          body: { sequenceId, action },\n        }),\n      deleteSequence: (sequenceId) =>\n        call(OUTREACH_API_ROUTES.sequencesDelete, {\n          method: 'POST',\n          body: { sequenceId },\n        }),\n      previewEnrollment: (sequenceId, source) =>\n        call(OUTREACH_API_ROUTES.enrollPreview, {\n          method: 'POST',\n          body: { sequenceId, source },\n        }),\n      enroll: (sequenceId, people) =>\n        call(OUTREACH_API_ROUTES.enroll, {\n          method: 'POST',\n          body: { sequenceId, people },\n        }),\n      actOnEnrollment: (enrollmentId, action, detail) =>\n        call(OUTREACH_API_ROUTES.enrollmentsAction, {\n          method: 'POST',\n          body: { enrollmentId, action, ...(detail ? { detail } : {}) },\n        }),\n      previewEmail: (input) =>\n        call(OUTREACH_API_ROUTES.preview, {\n          method: 'POST',\n          body: { ...input },\n        }),\n    }),\n    [call],\n  )\n}\n"],"names":["authorizedFetch","useUser","useCallback","useMemo","OUTREACH_API_ROUTES","OutreachRouteError","Error","refused","reason","message","status","issues","name","useOutreachApi","orgId","data","user","call","route","init","path","method","encodeURIComponent","response","headers","body","JSON","stringify","payload","json","catch","ok","refusal","error","readSettings","settings","saveSettings","input","saveSequence","sequenceId","sequence","sequencesSave","setSequenceStatus","action","sequencesStatus","deleteSequence","sequencesDelete","previewEnrollment","source","enrollPreview","enroll","people","actOnEnrollment","enrollmentId","detail","enrollmentsAction","previewEmail","preview"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GACD;;AAEA,SAASA,eAAe,QAAQ,2CAA0C;AAC1E,SAASC,OAAO,QAAQ,iCAAgC;AACxD,SAASC,WAAW,EAAEC,OAAO,QAAQ,QAAO;AAC5C,SAASC,mBAAmB,QAAQ,6BAAyB;AAyB7D;;;;;CAKC,GACD,OAAO,MAAMC,2BAA2BC;IAoBtC,IAAIC,UAAmB;QACrB,OACE,IAAI,CAACC,MAAM,KAAK,gBAChB,IAAI,CAACA,MAAM,KAAK,iBAChB,IAAI,CAACA,MAAM,KAAK,kBAChB,IAAI,CAACA,MAAM,KAAK,kBAChB,sEAAsE;QACtE,wCAAwC;QACxC,IAAI,CAACA,MAAM,KAAK;IAEpB;IAvBA,YACEC,OAAe,EACfD,MAAoC,EACpCE,MAAc,EACdC,SAAuC,EAAE,CACzC;QACA,KAAK,CAACF;QACN,IAAI,CAACG,IAAI,GAAG;QACZ,IAAI,CAACJ,MAAM,GAAGA;QACd,IAAI,CAACE,MAAM,GAAGA;QACd,IAAI,CAACC,MAAM,GAAGA;IAChB;AAaF;AAmCA;;;;;;CAMC,GACD,OAAO,SAASE,eAAeC,KAAoB;IACjD,MAAM,EAAEC,MAAMC,IAAI,EAAE,GAAGf;IAEvB,MAAMgB,OAAOf,YACX,OACEgB,OACAC;QAEA,IAAI,CAACL,OACH,MAAM,IAAIT,mBACR,+BACA,gBACA;QAEJ,MAAMe,OACJD,KAAKE,MAAM,KAAK,QACZ,CAAC,KAAK,EAAEH,MAAM,OAAO,EAAEI,mBAAmBR,QAAQ,GAClD,CAAC,KAAK,EAAEI,OAAO;QACrB,IAAIK;QACJ,IAAI;YACFA,WAAW,MAAMvB,gBAAgBgB,MAAMI,MAAM;gBAC3CC,QAAQF,KAAKE,MAAM;eACfF,KAAKE,MAAM,KAAK,SAChB;gBACEG,SAAS;oBAAE,gBAAgB;gBAAmB;gBAC9CC,MAAMC,KAAKC,SAAS,CAAC;oBAAEb;mBAAUK,KAAKM,IAAI;YAC5C,IACA,CAAC;QAET,EAAE,eAAM;YACN,MAAM,IAAIpB,mBACR,8CACA,eACA;QAEJ;QACA,MAAMuB,UAAW,MAAML,SAASM,IAAI,GAAGC,KAAK,CAAC,IAAM;QAEnD,IAAI,CAACP,SAASQ,EAAE,IAAI,CAACH,SAAS;gBAQ1BI,iBAGAA;YAVF,MAAMA,UAAWJ,kBAAAA,UAAW,CAAC;YAC7B,MAAM,IAAIvB,mBACR2B,QAAQC,KAAK,IAAID,QAAQxB,MAAM,GAC3BwB,QAAQC,KAAK,GACbV,SAASb,MAAM,KAAK,MAClB,qDACA,+CACNsB,kBAAAA,QAAQxB,MAAM,YAAdwB,kBACGT,SAASb,MAAM,KAAK,MAAM,cAAc,eAC3Ca,SAASb,MAAM,GACfsB,kBAAAA,QAAQrB,MAAM,YAAdqB,kBAAkB,EAAE;QAExB;QACA,OAAOJ;IACT,GACA;QAACZ;QAAMF;KAAM;IAGf,OAAOX,QACL,IAAO,CAAA;YACL+B,cAAc,IAAMjB,KAAKb,oBAAoB+B,QAAQ,EAAE;oBAAEd,QAAQ;gBAAM;YACvEe,cAAc,CAACC,QACbpB,KAAKb,oBAAoB+B,QAAQ,EAAE;oBACjCd,QAAQ;oBACRI,MAAM,aAAKY;gBACb;YACFC,cAAc,CAACC,YAAYC,WACzBvB,KAAKb,oBAAoBqC,aAAa,EAAE;oBACtCpB,QAAQ;oBACRI,MAAM,aAAMc,aAAa;wBAAEA;oBAAW,IAAI,CAAC;wBAAIC;;gBACjD;YACFE,mBAAmB,CAACH,YAAYI,SAC9B1B,KAAKb,oBAAoBwC,eAAe,EAAE;oBACxCvB,QAAQ;oBACRI,MAAM;wBAAEc;wBAAYI;oBAAO;gBAC7B;YACFE,gBAAgB,CAACN,aACftB,KAAKb,oBAAoB0C,eAAe,EAAE;oBACxCzB,QAAQ;oBACRI,MAAM;wBAAEc;oBAAW;gBACrB;YACFQ,mBAAmB,CAACR,YAAYS,SAC9B/B,KAAKb,oBAAoB6C,aAAa,EAAE;oBACtC5B,QAAQ;oBACRI,MAAM;wBAAEc;wBAAYS;oBAAO;gBAC7B;YACFE,QAAQ,CAACX,YAAYY,SACnBlC,KAAKb,oBAAoB8C,MAAM,EAAE;oBAC/B7B,QAAQ;oBACRI,MAAM;wBAAEc;wBAAYY;oBAAO;gBAC7B;YACFC,iBAAiB,CAACC,cAAcV,QAAQW,SACtCrC,KAAKb,oBAAoBmD,iBAAiB,EAAE;oBAC1ClC,QAAQ;oBACRI,MAAM;wBAAE4B;wBAAcV;uBAAYW,SAAS;wBAAEA;oBAAO,IAAI,CAAC;gBAC3D;YACFE,cAAc,CAACnB,QACbpB,KAAKb,oBAAoBqD,OAAO,EAAE;oBAChCpC,QAAQ;oBACRI,MAAM,aAAKY;gBACb;QACJ,CAAA,GACA;QAACpB;KAAK;AAEV"}

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

@@ -0,0 +1,50 @@
+import type { OutreachLoad } from './use-outreach-data';
+/** A saved Contacts view people can be enrolled from. */
+export interface OutreachViewOption {
+    id: string;
+    name: string;
+}
+/** The most saved views the picker lists. */
+export declare const OUTREACH_VIEWS_LIMIT = 50;
+/**
+ * The saved Contacts views this reader may enroll from: their own and the
+ * shared ones — a colleague's private view is theirs — that translate whole
+ * into an audience. A view filtering on something enrolling cannot apply is
+ * not offered, because dropping that filter would enroll more people than
+ * the view shows.
+ */
+export declare function useOutreachSavedViews(orgId: string | null, uid: string | null): OutreachLoad<OutreachViewOption[]>;
+/** A CRM email template a step can send the body of. */
+export interface OutreachTemplateOption {
+    id: string;
+    name: string;
+    subject: string;
+    body: string;
+}
+/**
+ * The CRM email templates a step at this site can use: whole letters, not
+ * snippets; the team's and this reader's own; written for the whole
+ * organization or for this site.
+ */
+export declare function useOutreachEmailTemplates(orgId: string | null, hostId: string | null, uid: string | null): OutreachLoad<OutreachTemplateOption[]>;
+/** A contact a search found. */
+export interface OutreachContactOption {
+    id: string;
+    name: string;
+    email: string | null;
+}
+/** The most contacts one search answers with. */
+export declare const OUTREACH_SEARCH_LIMIT = 25;
+/**
+ * The contacts at `hostId` a search finds: by address when the text is one,
+ * otherwise by a word of the name — the `nameTokens` the contacts carry for
+ * the CRM's own search. `idle` until something is typed.
+ */
+export declare function useOutreachContactSearch(input: {
+    orgId: string | null;
+    hostId: string | null;
+    contactGroupId: string | null;
+    text: string;
+}): OutreachLoad<OutreachContactOption[]> & {
+    idle: boolean;
+};