@aglyn/plugins-outreach 1.0.0-beta.143

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

@@ -0,0 +1,200 @@
+/**
+ * @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 { contactDisplayName, normalizeContactEmail } from "@aglyn/aglyn/app-utils/contacts";
+import { CRM_COLLECTIONS, crmViewIsListed, normalizeCrmViewFilters } from "@aglyn/aglyn/app-utils/crm";
+import { CRM_EMAIL_TEMPLATES_LIMIT, crmEmailTemplateIsListed, normalizeCrmEmailTemplate } from "@aglyn/aglyn/app-utils/crm-email-templates";
+import { dynamicListDimensionsForCrmView } from "@aglyn/aglyn/app-utils/dynamic-list-rule";
+import { nameSearchToken } from "@aglyn/aglyn/app-utils/name-search";
+import { visibleToHost } from "@aglyn/aglyn/app-utils/scope-tokens";
+import { useFirestore } from "@aglyn/tenant-feature-instance";
+import { collection, getDocs, limit, onSnapshot, orderBy, query, where } from "firebase/firestore";
+import { useEffect, useState } from "react";
+/**
+ * What Outreach reads from the organization's CRM (AGL-2980): the saved
+ * Contacts views people can be enrolled from, the email templates a step
+ * can send, and the contacts a search finds.
+ *
+ * Through the core's own CRM model — the collection names, the listing
+ * rules, the view translation the dynamic-list sweep uses — and never
+ * through the CRM plugin, which a plugin may not import. The Firestore
+ * rules gate every one of these reads on `data.manage`, the same permission
+ * the enroll routes ask for, so a member who cannot read the people cannot
+ * enroll them either.
+ */ const denied = (error)=>(error == null ? void 0 : error.code) === 'permission-denied';
+/** The most saved views the picker lists. */ export 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 function useOutreachSavedViews(orgId, uid) {
+    const firestore = useFirestore();
+    const [result, setResult] = useState({
+        status: 'loading',
+        data: []
+    });
+    useEffect(()=>{
+        setResult({
+            status: 'loading',
+            data: []
+        });
+        if (!orgId) return undefined;
+        return onSnapshot(query(collection(firestore, 'orgs', orgId, CRM_COLLECTIONS.views), where('section', '==', 'contacts'), orderBy('name'), limit(OUTREACH_VIEWS_LIMIT)), (snapshot)=>setResult({
+                status: 'ready',
+                data: snapshot.docs.map((entry)=>({
+                        id: entry.id,
+                        data: entry.data()
+                    })).filter(({ data })=>{
+                    var _data_ownerUid;
+                    return typeof data['name'] === 'string' && data['name'] !== '' && crmViewIsListed({
+                        shared: data['shared'] === true,
+                        ownerUid: String((_data_ownerUid = data['ownerUid']) != null ? _data_ownerUid : '')
+                    }, uid) && dynamicListDimensionsForCrmView(normalizeCrmViewFilters(data['filters'])).unsupported.length === 0;
+                }).map(({ id, data })=>({
+                        id,
+                        name: String(data['name'])
+                    }))
+            }), (error)=>{
+            if (!denied(error)) console.error('[outreach] saved views could not be read', error);
+            setResult({
+                status: denied(error) ? 'refused' : 'error',
+                data: []
+            });
+        });
+    }, [
+        firestore,
+        orgId,
+        uid
+    ]);
+    return result;
+}
+/**
+ * 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 function useOutreachEmailTemplates(orgId, hostId, uid) {
+    const firestore = useFirestore();
+    const [result, setResult] = useState({
+        status: 'loading',
+        data: []
+    });
+    useEffect(()=>{
+        setResult({
+            status: 'loading',
+            data: []
+        });
+        if (!orgId) return undefined;
+        return onSnapshot(query(collection(firestore, 'orgs', orgId, CRM_COLLECTIONS.emailTemplates), orderBy('name'), limit(CRM_EMAIL_TEMPLATES_LIMIT)), (snapshot)=>setResult({
+                status: 'ready',
+                data: snapshot.docs.map((entry)=>({
+                        id: entry.id,
+                        template: normalizeCrmEmailTemplate(entry.data())
+                    })).filter(({ template })=>template.kind === 'template' && crmEmailTemplateIsListed(template, uid) && (!hostId || visibleToHost(template.visibleTo, hostId))).map(({ id, template })=>({
+                        id,
+                        name: template.name,
+                        subject: template.subject,
+                        body: template.body
+                    }))
+            }), (error)=>{
+            if (!denied(error)) console.error('[outreach] email templates could not be read', error);
+            setResult({
+                status: denied(error) ? 'refused' : 'error',
+                data: []
+            });
+        });
+    }, [
+        firestore,
+        orgId,
+        hostId,
+        uid
+    ]);
+    return result;
+}
+/** The most contacts one search answers with. */ export 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 function useOutreachContactSearch(input) {
+    const { orgId, hostId, contactGroupId, text } = input;
+    const firestore = useFirestore();
+    const [result, setResult] = useState({
+        status: 'ready',
+        data: []
+    });
+    const email = normalizeContactEmail(text);
+    const token = email ? '' : nameSearchToken(text);
+    const idle = !orgId || !hostId || !email && !token;
+    useEffect(()=>{
+        if (idle || !orgId || !hostId) {
+            setResult({
+                status: 'ready',
+                data: []
+            });
+            return undefined;
+        }
+        let current = true;
+        setResult((previous)=>({
+                status: 'loading',
+                data: previous.data
+            }));
+        const contacts = collection(firestore, 'orgs', orgId, 'contacts');
+        // Settles the typing before it reads: one query per pause, not per key.
+        const timer = setTimeout(()=>{
+            getDocs(email ? query(contacts, where('email', '==', email), limit(OUTREACH_SEARCH_LIMIT)) : query(contacts, where('nameTokens', 'array-contains', token), orderBy('nameLower'), limit(OUTREACH_SEARCH_LIMIT))).then((snapshot)=>{
+                if (!current) return;
+                setResult({
+                    status: 'ready',
+                    data: snapshot.docs.map((entry)=>({
+                            id: entry.id,
+                            data: entry.data()
+                        })).filter(({ data })=>visibleToHost(data['visibleTo'], hostId)).map(({ id, data })=>({
+                            id,
+                            name: contactDisplayName(data, contactGroupId != null ? contactGroupId : hostId).trim(),
+                            email: normalizeContactEmail(data['email'])
+                        }))
+                });
+            }).catch((error)=>{
+                if (!current) return;
+                if (!denied(error)) console.error('[outreach] the contact search failed', error);
+                setResult({
+                    status: denied(error) ? 'refused' : 'error',
+                    data: []
+                });
+            });
+        }, 300);
+        return ()=>{
+            current = false;
+            clearTimeout(timer);
+        };
+    }, [
+        firestore,
+        orgId,
+        hostId,
+        contactGroupId,
+        email,
+        token,
+        idle
+    ]);
+    return _extends({}, result, {
+        idle
+    });
+}
+
+//# sourceMappingURL=use-outreach-crm.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/outreach/src/lib/components/use-outreach-crm.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  contactDisplayName,\n  normalizeContactEmail,\n} from '@aglyn/aglyn/app-utils/contacts'\nimport {\n  CRM_COLLECTIONS,\n  crmViewIsListed,\n  normalizeCrmViewFilters,\n} from '@aglyn/aglyn/app-utils/crm'\nimport {\n  CRM_EMAIL_TEMPLATES_LIMIT,\n  crmEmailTemplateIsListed,\n  normalizeCrmEmailTemplate,\n} from '@aglyn/aglyn/app-utils/crm-email-templates'\nimport { dynamicListDimensionsForCrmView } from '@aglyn/aglyn/app-utils/dynamic-list-rule'\nimport { nameSearchToken } from '@aglyn/aglyn/app-utils/name-search'\nimport { visibleToHost } from '@aglyn/aglyn/app-utils/scope-tokens'\nimport { useFirestore } from '@aglyn/tenant-feature-instance'\nimport {\n  collection,\n  getDocs,\n  limit,\n  onSnapshot,\n  orderBy,\n  query,\n  where,\n} from 'firebase/firestore'\nimport { useEffect, useState } from 'react'\nimport type { OutreachLoad } from './use-outreach-data'\n\n/**\n * What Outreach reads from the organization's CRM (AGL-2980): the saved\n * Contacts views people can be enrolled from, the email templates a step\n * can send, and the contacts a search finds.\n *\n * Through the core's own CRM model — the collection names, the listing\n * rules, the view translation the dynamic-list sweep uses — and never\n * through the CRM plugin, which a plugin may not import. The Firestore\n * rules gate every one of these reads on `data.manage`, the same permission\n * the enroll routes ask for, so a member who cannot read the people cannot\n * enroll them either.\n */\n\nconst denied = (error: unknown) =>\n  (error as { code?: unknown } | null)?.code === 'permission-denied'\n\n/** A saved Contacts view people can be enrolled from. */\nexport interface OutreachViewOption {\n  id: string\n  name: string\n}\n\n/** The most saved views the picker lists. */\nexport const OUTREACH_VIEWS_LIMIT = 50\n\n/**\n * The saved Contacts views this reader may enroll from: their own and the\n * shared ones — a colleague's private view is theirs — that translate whole\n * into an audience. A view filtering on something enrolling cannot apply is\n * not offered, because dropping that filter would enroll more people than\n * the view shows.\n */\nexport function useOutreachSavedViews(\n  orgId: string | null,\n  uid: string | null,\n): OutreachLoad<OutreachViewOption[]> {\n  const firestore = useFirestore()\n  const [result, setResult] = useState<OutreachLoad<OutreachViewOption[]>>({\n    status: 'loading',\n    data: [],\n  })\n  useEffect(() => {\n    setResult({ status: 'loading', data: [] })\n    if (!orgId) return undefined\n    return onSnapshot(\n      query(\n        collection(firestore, 'orgs', orgId, CRM_COLLECTIONS.views),\n        where('section', '==', 'contacts'),\n        orderBy('name'),\n        limit(OUTREACH_VIEWS_LIMIT),\n      ),\n      (snapshot) =>\n        setResult({\n          status: 'ready',\n          data: snapshot.docs\n            .map((entry) => ({\n              id: entry.id,\n              data: entry.data() as Record<string, unknown>,\n            }))\n            .filter(\n              ({ data }) =>\n                typeof data['name'] === 'string' &&\n                data['name'] !== '' &&\n                crmViewIsListed(\n                  {\n                    shared: data['shared'] === true,\n                    ownerUid: String(data['ownerUid'] ?? ''),\n                  },\n                  uid,\n                ) &&\n                dynamicListDimensionsForCrmView(\n                  normalizeCrmViewFilters(data['filters']),\n                ).unsupported.length === 0,\n            )\n            .map(({ id, data }) => ({ id, name: String(data['name']) })),\n        }),\n      (error) => {\n        if (!denied(error))\n          console.error('[outreach] saved views could not be read', error)\n        setResult({ status: denied(error) ? 'refused' : 'error', data: [] })\n      },\n    )\n  }, [firestore, orgId, uid])\n  return result\n}\n\n/** A CRM email template a step can send the body of. */\nexport interface OutreachTemplateOption {\n  id: string\n  name: string\n  subject: string\n  body: string\n}\n\n/**\n * The CRM email templates a step at this site can use: whole letters, not\n * snippets; the team's and this reader's own; written for the whole\n * organization or for this site.\n */\nexport function useOutreachEmailTemplates(\n  orgId: string | null,\n  hostId: string | null,\n  uid: string | null,\n): OutreachLoad<OutreachTemplateOption[]> {\n  const firestore = useFirestore()\n  const [result, setResult] = useState<OutreachLoad<OutreachTemplateOption[]>>({\n    status: 'loading',\n    data: [],\n  })\n  useEffect(() => {\n    setResult({ status: 'loading', data: [] })\n    if (!orgId) return undefined\n    return onSnapshot(\n      query(\n        collection(firestore, 'orgs', orgId, CRM_COLLECTIONS.emailTemplates),\n        orderBy('name'),\n        limit(CRM_EMAIL_TEMPLATES_LIMIT),\n      ),\n      (snapshot) =>\n        setResult({\n          status: 'ready',\n          data: snapshot.docs\n            .map((entry) => ({\n              id: entry.id,\n              template: normalizeCrmEmailTemplate(entry.data()),\n            }))\n            .filter(\n              ({ template }) =>\n                template.kind === 'template' &&\n                crmEmailTemplateIsListed(template, uid) &&\n                (!hostId || visibleToHost(template.visibleTo, hostId)),\n            )\n            .map(({ id, template }) => ({\n              id,\n              name: template.name,\n              subject: template.subject,\n              body: template.body,\n            })),\n        }),\n      (error) => {\n        if (!denied(error))\n          console.error('[outreach] email templates could not be read', error)\n        setResult({ status: denied(error) ? 'refused' : 'error', data: [] })\n      },\n    )\n  }, [firestore, orgId, hostId, uid])\n  return result\n}\n\n/** A contact a search found. */\nexport interface OutreachContactOption {\n  id: string\n  name: string\n  email: string | null\n}\n\n/** The most contacts one search answers with. */\nexport const OUTREACH_SEARCH_LIMIT = 25\n\n/**\n * The contacts at `hostId` a search finds: by address when the text is one,\n * otherwise by a word of the name — the `nameTokens` the contacts carry for\n * the CRM's own search. `idle` until something is typed.\n */\nexport function useOutreachContactSearch(input: {\n  orgId: string | null\n  hostId: string | null\n  contactGroupId: string | null\n  text: string\n}): OutreachLoad<OutreachContactOption[]> & { idle: boolean } {\n  const { orgId, hostId, contactGroupId, text } = input\n  const firestore = useFirestore()\n  const [result, setResult] = useState<OutreachLoad<OutreachContactOption[]>>({\n    status: 'ready',\n    data: [],\n  })\n  const email = normalizeContactEmail(text)\n  const token = email ? '' : nameSearchToken(text)\n  const idle = !orgId || !hostId || (!email && !token)\n  useEffect(() => {\n    if (idle || !orgId || !hostId) {\n      setResult({ status: 'ready', data: [] })\n      return undefined\n    }\n    let current = true\n    setResult((previous) => ({ status: 'loading', data: previous.data }))\n    const contacts = collection(firestore, 'orgs', orgId, 'contacts')\n    // Settles the typing before it reads: one query per pause, not per key.\n    const timer = setTimeout(() => {\n      getDocs(\n        email\n          ? query(\n              contacts,\n              where('email', '==', email),\n              limit(OUTREACH_SEARCH_LIMIT),\n            )\n          : query(\n              contacts,\n              where('nameTokens', 'array-contains', token),\n              orderBy('nameLower'),\n              limit(OUTREACH_SEARCH_LIMIT),\n            ),\n      )\n        .then((snapshot) => {\n          if (!current) return\n          setResult({\n            status: 'ready',\n            data: snapshot.docs\n              .map((entry) => ({\n                id: entry.id,\n                data: entry.data() as Record<string, unknown>,\n              }))\n              .filter(({ data }) =>\n                visibleToHost(\n                  data['visibleTo'] as string[] | undefined,\n                  hostId,\n                ),\n              )\n              .map(({ id, data }) => ({\n                id,\n                name: contactDisplayName(data, contactGroupId ?? hostId).trim(),\n                email: normalizeContactEmail(data['email']),\n              })),\n          })\n        })\n        .catch((error: unknown) => {\n          if (!current) return\n          if (!denied(error))\n            console.error('[outreach] the contact search failed', error)\n          setResult({ status: denied(error) ? 'refused' : 'error', data: [] })\n        })\n    }, 300)\n    return () => {\n      current = false\n      clearTimeout(timer)\n    }\n  }, [firestore, orgId, hostId, contactGroupId, email, token, idle])\n  return { ...result, idle }\n}\n"],"names":["contactDisplayName","normalizeContactEmail","CRM_COLLECTIONS","crmViewIsListed","normalizeCrmViewFilters","CRM_EMAIL_TEMPLATES_LIMIT","crmEmailTemplateIsListed","normalizeCrmEmailTemplate","dynamicListDimensionsForCrmView","nameSearchToken","visibleToHost","useFirestore","collection","getDocs","limit","onSnapshot","orderBy","query","where","useEffect","useState","denied","error","code","OUTREACH_VIEWS_LIMIT","useOutreachSavedViews","orgId","uid","firestore","result","setResult","status","data","undefined","views","snapshot","docs","map","entry","id","filter","shared","ownerUid","String","unsupported","length","name","console","useOutreachEmailTemplates","hostId","emailTemplates","template","kind","visibleTo","subject","body","OUTREACH_SEARCH_LIMIT","useOutreachContactSearch","input","contactGroupId","text","email","token","idle","current","previous","contacts","timer","setTimeout","then","trim","catch","clearTimeout"],"mappings":"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"}

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

@@ -0,0 +1,55 @@
+import { type OutreachEnrollment, type OutreachSequence } from '../model/outreach.types';
+/**
+ * The Outreach documents the console reads LIVE (AGL-2980): sequences,
+ * enrollments, and the mailboxes they send from.
+ *
+ * Read straight from Firestore — the rules let an org-wide member holding
+ * `outreach.use` on an entitled organization read them, and every write goes
+ * through a route — so what a page shows is what the routes and the sending
+ * runtime wrote, the moment it lands.
+ *
+ * Every hook answers one of four states, and a page renders each: still
+ * loading, ready, failed, or REFUSED — the rules said no, which is a reader
+ * who may not see Outreach here rather than something that went wrong.
+ */
+export type OutreachLoadStatus = 'loading' | 'ready' | 'error' | 'refused';
+export interface OutreachLoad<T> {
+    status: OutreachLoadStatus;
+    data: T;
+}
+/** The most sequences the list reads. */
+export declare const OUTREACH_SEQUENCES_LIMIT = 200;
+/** The organization's sequences, newest first. */
+export declare function useOutreachSequences(orgId: string | null): OutreachLoad<OutreachSequence[]>;
+/** One sequence, or `null` once it is known not to exist. */
+export declare function useOutreachSequence(orgId: string | null, sequenceId: string | null): OutreachLoad<OutreachSequence | null>;
+/** How many enrollments one page of the table reads; "Show more" reads another. */
+export declare const OUTREACH_ENROLLMENTS_PAGE = 200;
+export interface OutreachEnrollmentsLoad extends OutreachLoad<OutreachEnrollment[]> {
+    /** Whether a further page may exist. */
+    hasMore: boolean;
+    showMore(): void;
+}
+/**
+ * A sequence's enrollments, the most recently enrolled first.
+ *
+ * Paged by document id — an equality on `sequenceId` in the id's own order
+ * needs no composite index — and sorted by enrollment time once read, so a
+ * table of up to a page reads in the order people were enrolled.
+ */
+export declare function useOutreachEnrollments(orgId: string | null, sequenceId: string | null): OutreachEnrollmentsLoad;
+/** The counts the sequence list shows beside each sequence. */
+export interface OutreachSequenceCounts {
+    enrolled: number;
+    active: number;
+    replied: number;
+    bounced: number;
+    optedOut: number;
+}
+/**
+ * Each sequence's enrollment counts, by server-side aggregation — one count
+ * per figure, never a read of the enrollments themselves. Recounted when the
+ * sequences asked about change — the list asks about the page on screen —
+ * and absent while counting, or if a count failed.
+ */
+export declare function useOutreachSequenceCounts(orgId: string | null, sequenceIds: readonly string[]): Record<string, OutreachSequenceCounts>;

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

@@ -0,0 +1,199 @@
+/**
+ * @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 { useFirestore } from "@aglyn/tenant-feature-instance";
+import { collection, doc, documentId, getCountFromServer, limit, onSnapshot, orderBy, query, where } from "firebase/firestore";
+import { useEffect, useMemo, useState } from "react";
+import { OUTREACH_COLLECTIONS } from "../model/outreach.types.js";
+import { readStoredOutreachEnrollment, readStoredOutreachSequence } from "../model/stored-records.js";
+const denied = (error)=>(error == null ? void 0 : error.code) === 'permission-denied';
+function failed(data, error, what) {
+    if (denied(error)) return {
+        status: 'refused',
+        data
+    };
+    console.error(`[outreach] ${what} could not be read`, error);
+    return {
+        status: 'error',
+        data
+    };
+}
+/** The most sequences the list reads. */ export const OUTREACH_SEQUENCES_LIMIT = 200;
+/** The organization's sequences, newest first. */ export function useOutreachSequences(orgId) {
+    const firestore = useFirestore();
+    const [result, setResult] = useState({
+        status: 'loading',
+        data: []
+    });
+    useEffect(()=>{
+        setResult({
+            status: 'loading',
+            data: []
+        });
+        if (!orgId) return undefined;
+        return onSnapshot(query(collection(firestore, 'orgs', orgId, OUTREACH_COLLECTIONS.sequences), // Ordered, so the cap keeps the newest rather than an arbitrary set;
+        // every sequence carries `createdAtMs`, stamped by the save route.
+        orderBy('createdAtMs', 'desc'), limit(OUTREACH_SEQUENCES_LIMIT)), (snapshot)=>{
+            const sequences = snapshot.docs.map((entry)=>readStoredOutreachSequence(entry.id, entry.data())).filter((sequence)=>sequence !== null).sort((a, b)=>b.createdAtMs - a.createdAtMs);
+            setResult({
+                status: 'ready',
+                data: sequences
+            });
+        }, (error)=>setResult(failed([], error, 'sequences')));
+    }, [
+        firestore,
+        orgId
+    ]);
+    return result;
+}
+/** One sequence, or `null` once it is known not to exist. */ export function useOutreachSequence(orgId, sequenceId) {
+    const firestore = useFirestore();
+    const [result, setResult] = useState({
+        status: 'loading',
+        data: null
+    });
+    useEffect(()=>{
+        setResult({
+            status: 'loading',
+            data: null
+        });
+        if (!orgId || !sequenceId) return undefined;
+        return onSnapshot(doc(firestore, 'orgs', orgId, OUTREACH_COLLECTIONS.sequences, sequenceId), (snapshot)=>setResult({
+                status: 'ready',
+                data: readStoredOutreachSequence(snapshot.id, snapshot.exists() ? snapshot.data() : undefined)
+            }), (error)=>setResult(failed(null, error, 'the sequence')));
+    }, [
+        firestore,
+        orgId,
+        sequenceId
+    ]);
+    return result;
+}
+/** How many enrollments one page of the table reads; "Show more" reads another. */ export const OUTREACH_ENROLLMENTS_PAGE = 200;
+/**
+ * A sequence's enrollments, the most recently enrolled first.
+ *
+ * Paged by document id — an equality on `sequenceId` in the id's own order
+ * needs no composite index — and sorted by enrollment time once read, so a
+ * table of up to a page reads in the order people were enrolled.
+ */ export function useOutreachEnrollments(orgId, sequenceId) {
+    const firestore = useFirestore();
+    const [pages, setPages] = useState(1);
+    const [result, setResult] = useState({
+        status: 'loading',
+        data: [],
+        size: 0
+    });
+    useEffect(()=>setPages(1), [
+        orgId,
+        sequenceId
+    ]);
+    useEffect(()=>{
+        if (!orgId || !sequenceId) {
+            setResult({
+                status: 'loading',
+                data: [],
+                size: 0
+            });
+            return undefined;
+        }
+        return onSnapshot(query(collection(firestore, 'orgs', orgId, OUTREACH_COLLECTIONS.enrollments), where('sequenceId', '==', sequenceId), orderBy(documentId()), limit(pages * OUTREACH_ENROLLMENTS_PAGE)), (snapshot)=>{
+            const enrollments = snapshot.docs.map((entry)=>readStoredOutreachEnrollment(entry.id, entry.data())).filter((enrollment)=>enrollment !== null).sort((a, b)=>b.createdAtMs - a.createdAtMs);
+            setResult({
+                status: 'ready',
+                data: enrollments,
+                size: snapshot.size
+            });
+        }, (error)=>setResult(_extends({}, failed([], error, 'the enrollments'), {
+                size: 0
+            })));
+    }, [
+        firestore,
+        orgId,
+        sequenceId,
+        pages
+    ]);
+    return useMemo(()=>({
+            status: result.status,
+            data: result.data,
+            hasMore: result.size >= pages * OUTREACH_ENROLLMENTS_PAGE,
+            showMore: ()=>setPages((count)=>count + 1)
+        }), [
+        result,
+        pages
+    ]);
+}
+const COUNTED = [
+    [
+        'enrolled',
+        null
+    ],
+    [
+        'active',
+        'active'
+    ],
+    [
+        'replied',
+        'replied'
+    ],
+    [
+        'bounced',
+        'bounced'
+    ],
+    [
+        'optedOut',
+        'opted_out'
+    ]
+];
+/**
+ * Each sequence's enrollment counts, by server-side aggregation — one count
+ * per figure, never a read of the enrollments themselves. Recounted when the
+ * sequences asked about change — the list asks about the page on screen —
+ * and absent while counting, or if a count failed.
+ */ export function useOutreachSequenceCounts(orgId, sequenceIds) {
+    const firestore = useFirestore();
+    const [counts, setCounts] = useState({});
+    const key = sequenceIds.join(',');
+    useEffect(()=>{
+        if (!orgId || !key) return undefined;
+        let current = true;
+        const enrollments = collection(firestore, 'orgs', orgId, OUTREACH_COLLECTIONS.enrollments);
+        Promise.all(key.split(',').map(async (sequenceId)=>{
+            const figures = await Promise.all(COUNTED.map(async ([, status])=>{
+                const counted = await getCountFromServer(status ? query(enrollments, where('sequenceId', '==', sequenceId), where('status', '==', status)) : query(enrollments, where('sequenceId', '==', sequenceId)));
+                return counted.data().count;
+            }));
+            return [
+                sequenceId,
+                Object.fromEntries(COUNTED.map(([name], index)=>[
+                        name,
+                        figures[index]
+                    ]))
+            ];
+        })).then((entries)=>current && setCounts(Object.fromEntries(entries))).catch((error)=>console.error('[outreach] enrollment counts could not be read', error));
+        return ()=>{
+            current = false;
+        };
+    }, [
+        firestore,
+        orgId,
+        key
+    ]);
+    return counts;
+}
+
+//# sourceMappingURL=use-outreach-data.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/outreach/src/lib/components/use-outreach-data.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 { useFirestore } from '@aglyn/tenant-feature-instance'\nimport {\n  collection,\n  doc,\n  documentId,\n  getCountFromServer,\n  limit,\n  onSnapshot,\n  orderBy,\n  query,\n  where,\n} from 'firebase/firestore'\nimport { useEffect, useMemo, useState } from 'react'\nimport {\n  OUTREACH_COLLECTIONS,\n  type OutreachEnrollment,\n  type OutreachEnrollmentStatus,\n  type OutreachSequence,\n} from '../model/outreach.types'\nimport {\n  readStoredOutreachEnrollment,\n  readStoredOutreachSequence,\n} from '../model/stored-records'\n\n/**\n * The Outreach documents the console reads LIVE (AGL-2980): sequences,\n * enrollments, and the mailboxes they send from.\n *\n * Read straight from Firestore — the rules let an org-wide member holding\n * `outreach.use` on an entitled organization read them, and every write goes\n * through a route — so what a page shows is what the routes and the sending\n * runtime wrote, the moment it lands.\n *\n * Every hook answers one of four states, and a page renders each: still\n * loading, ready, failed, or REFUSED — the rules said no, which is a reader\n * who may not see Outreach here rather than something that went wrong.\n */\n\nexport type OutreachLoadStatus = 'loading' | 'ready' | 'error' | 'refused'\n\nexport interface OutreachLoad<T> {\n  status: OutreachLoadStatus\n  data: T\n}\n\nconst denied = (error: unknown) =>\n  (error as { code?: unknown } | null)?.code === 'permission-denied'\n\nfunction failed<T>(data: T, error: unknown, what: string): OutreachLoad<T> {\n  if (denied(error)) return { status: 'refused', data }\n  console.error(`[outreach] ${what} could not be read`, error)\n  return { status: 'error', data }\n}\n\n/** The most sequences the list reads. */\nexport const OUTREACH_SEQUENCES_LIMIT = 200\n\n/** The organization's sequences, newest first. */\nexport function useOutreachSequences(\n  orgId: string | null,\n): OutreachLoad<OutreachSequence[]> {\n  const firestore = useFirestore()\n  const [result, setResult] = useState<OutreachLoad<OutreachSequence[]>>({\n    status: 'loading',\n    data: [],\n  })\n  useEffect(() => {\n    setResult({ status: 'loading', data: [] })\n    if (!orgId) return undefined\n    return onSnapshot(\n      query(\n        collection(firestore, 'orgs', orgId, OUTREACH_COLLECTIONS.sequences),\n        // Ordered, so the cap keeps the newest rather than an arbitrary set;\n        // every sequence carries `createdAtMs`, stamped by the save route.\n        orderBy('createdAtMs', 'desc'),\n        limit(OUTREACH_SEQUENCES_LIMIT),\n      ),\n      (snapshot) => {\n        const sequences = snapshot.docs\n          .map((entry) => readStoredOutreachSequence(entry.id, entry.data()))\n          .filter((sequence): sequence is OutreachSequence => sequence !== null)\n          .sort((a, b) => b.createdAtMs - a.createdAtMs)\n        setResult({ status: 'ready', data: sequences })\n      },\n      (error) => setResult(failed([], error, 'sequences')),\n    )\n  }, [firestore, orgId])\n  return result\n}\n\n/** One sequence, or `null` once it is known not to exist. */\nexport function useOutreachSequence(\n  orgId: string | null,\n  sequenceId: string | null,\n): OutreachLoad<OutreachSequence | null> {\n  const firestore = useFirestore()\n  const [result, setResult] = useState<OutreachLoad<OutreachSequence | null>>({\n    status: 'loading',\n    data: null,\n  })\n  useEffect(() => {\n    setResult({ status: 'loading', data: null })\n    if (!orgId || !sequenceId) return undefined\n    return onSnapshot(\n      doc(firestore, 'orgs', orgId, OUTREACH_COLLECTIONS.sequences, sequenceId),\n      (snapshot) =>\n        setResult({\n          status: 'ready',\n          data: readStoredOutreachSequence(\n            snapshot.id,\n            snapshot.exists() ? snapshot.data() : undefined,\n          ),\n        }),\n      (error) => setResult(failed(null, error, 'the sequence')),\n    )\n  }, [firestore, orgId, sequenceId])\n  return result\n}\n\n/** How many enrollments one page of the table reads; \"Show more\" reads another. */\nexport const OUTREACH_ENROLLMENTS_PAGE = 200\n\nexport interface OutreachEnrollmentsLoad extends OutreachLoad<\n  OutreachEnrollment[]\n> {\n  /** Whether a further page may exist. */\n  hasMore: boolean\n  showMore(): void\n}\n\n/**\n * A sequence's enrollments, the most recently enrolled first.\n *\n * Paged by document id — an equality on `sequenceId` in the id's own order\n * needs no composite index — and sorted by enrollment time once read, so a\n * table of up to a page reads in the order people were enrolled.\n */\nexport function useOutreachEnrollments(\n  orgId: string | null,\n  sequenceId: string | null,\n): OutreachEnrollmentsLoad {\n  const firestore = useFirestore()\n  const [pages, setPages] = useState(1)\n  const [result, setResult] = useState<\n    OutreachLoad<OutreachEnrollment[]> & { size: number }\n  >({\n    status: 'loading',\n    data: [],\n    size: 0,\n  })\n  useEffect(() => setPages(1), [orgId, sequenceId])\n  useEffect(() => {\n    if (!orgId || !sequenceId) {\n      setResult({ status: 'loading', data: [], size: 0 })\n      return undefined\n    }\n    return onSnapshot(\n      query(\n        collection(firestore, 'orgs', orgId, OUTREACH_COLLECTIONS.enrollments),\n        where('sequenceId', '==', sequenceId),\n        orderBy(documentId()),\n        limit(pages * OUTREACH_ENROLLMENTS_PAGE),\n      ),\n      (snapshot) => {\n        const enrollments = snapshot.docs\n          .map((entry) => readStoredOutreachEnrollment(entry.id, entry.data()))\n          .filter(\n            (enrollment): enrollment is OutreachEnrollment =>\n              enrollment !== null,\n          )\n          .sort((a, b) => b.createdAtMs - a.createdAtMs)\n        setResult({ status: 'ready', data: enrollments, size: snapshot.size })\n      },\n      (error) =>\n        setResult({ ...failed([], error, 'the enrollments'), size: 0 }),\n    )\n  }, [firestore, orgId, sequenceId, pages])\n  return useMemo(\n    () => ({\n      status: result.status,\n      data: result.data,\n      hasMore: result.size >= pages * OUTREACH_ENROLLMENTS_PAGE,\n      showMore: () => setPages((count) => count + 1),\n    }),\n    [result, pages],\n  )\n}\n\n/** The counts the sequence list shows beside each sequence. */\nexport interface OutreachSequenceCounts {\n  enrolled: number\n  active: number\n  replied: number\n  bounced: number\n  optedOut: number\n}\n\nconst COUNTED: ReadonlyArray<\n  [keyof OutreachSequenceCounts, OutreachEnrollmentStatus | null]\n> = [\n  ['enrolled', null],\n  ['active', 'active'],\n  ['replied', 'replied'],\n  ['bounced', 'bounced'],\n  ['optedOut', 'opted_out'],\n]\n\n/**\n * Each sequence's enrollment counts, by server-side aggregation — one count\n * per figure, never a read of the enrollments themselves. Recounted when the\n * sequences asked about change — the list asks about the page on screen —\n * and absent while counting, or if a count failed.\n */\nexport function useOutreachSequenceCounts(\n  orgId: string | null,\n  sequenceIds: readonly string[],\n): Record<string, OutreachSequenceCounts> {\n  const firestore = useFirestore()\n  const [counts, setCounts] = useState<Record<string, OutreachSequenceCounts>>(\n    {},\n  )\n  const key = sequenceIds.join(',')\n  useEffect(() => {\n    if (!orgId || !key) return undefined\n    let current = true\n    const enrollments = collection(\n      firestore,\n      'orgs',\n      orgId,\n      OUTREACH_COLLECTIONS.enrollments,\n    )\n    Promise.all(\n      key.split(',').map(async (sequenceId) => {\n        const figures = await Promise.all(\n          COUNTED.map(async ([, status]) => {\n            const counted = await getCountFromServer(\n              status\n                ? query(\n                    enrollments,\n                    where('sequenceId', '==', sequenceId),\n                    where('status', '==', status),\n                  )\n                : query(enrollments, where('sequenceId', '==', sequenceId)),\n            )\n            return counted.data().count\n          }),\n        )\n        return [\n          sequenceId,\n          Object.fromEntries(\n            COUNTED.map(([name], index) => [name, figures[index]]),\n          ) as unknown as OutreachSequenceCounts,\n        ] as const\n      }),\n    )\n      .then((entries) => current && setCounts(Object.fromEntries(entries)))\n      .catch((error: unknown) =>\n        console.error('[outreach] enrollment counts could not be read', error),\n      )\n    return () => {\n      current = false\n    }\n  }, [firestore, orgId, key])\n  return counts\n}\n"],"names":["useFirestore","collection","doc","documentId","getCountFromServer","limit","onSnapshot","orderBy","query","where","useEffect","useMemo","useState","OUTREACH_COLLECTIONS","readStoredOutreachEnrollment","readStoredOutreachSequence","denied","error","code","failed","data","what","status","console","OUTREACH_SEQUENCES_LIMIT","useOutreachSequences","orgId","firestore","result","setResult","undefined","sequences","snapshot","docs","map","entry","id","filter","sequence","sort","a","b","createdAtMs","useOutreachSequence","sequenceId","exists","OUTREACH_ENROLLMENTS_PAGE","useOutreachEnrollments","pages","setPages","size","enrollments","enrollment","hasMore","showMore","count","COUNTED","useOutreachSequenceCounts","sequenceIds","counts","setCounts","key","join","current","Promise","all","split","figures","counted","Object","fromEntries","name","index","then","entries","catch"],"mappings":"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"}

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

@@ -0,0 +1,30 @@
+import type { OutreachApiRefusalReason, OutreachConnectCompleteResponse, OutreachMailboxAvailability, OutreachMailboxDisconnectResponse, OutreachMailboxResponse, OutreachMailboxSettingsRequest, OutreachMailboxTestResponse } from '../mailboxes/mailbox-api';
+/** A mailbox route's refusal, carrying the sentence and the stable reason. */
+export declare class OutreachApiError extends Error {
+    readonly reason: OutreachApiRefusalReason | 'unreachable';
+    readonly status: number;
+    constructor(message: string, reason: OutreachApiRefusalReason | 'unreachable', status: number);
+}
+/** The mailbox routes, as the Mailboxes panel calls them. */
+export interface OutreachMailboxApi {
+    availability(): Promise<OutreachMailboxAvailability>;
+    /** Google's consent address for a new connect, or a reconnect. */
+    connect(): Promise<string>;
+    complete(input: {
+        code: string;
+        state: string;
+        timezone?: string;
+    }): Promise<OutreachConnectCompleteResponse>;
+    saveSettings(input: Omit<OutreachMailboxSettingsRequest, 'orgId'>): Promise<OutreachMailboxResponse>;
+    setPaused(mailboxId: string, paused: boolean): Promise<OutreachMailboxResponse>;
+    sendTest(mailboxId: string): Promise<OutreachMailboxTestResponse>;
+    disconnect(mailboxId: string): Promise<OutreachMailboxDisconnectResponse>;
+}
+/**
+ * The Mailboxes panel's one door to the mailbox routes (AGL-2978), with the
+ * member's session attached and the organization named on every call — the
+ * dispatcher's release gate reads it. A refusal is thrown as an
+ * {@link OutreachApiError} carrying the route's own sentence, which is
+ * written for the person reading it.
+ */
+export declare function useOutreachMailboxApi(orgId: string | null): OutreachMailboxApi;

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

@@ -0,0 +1,101 @@
+/**
+ * @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 mailbox route's refusal, carrying the sentence and the stable reason. */ export class OutreachApiError extends Error {
+    constructor(message, reason, status){
+        super(message);
+        this.name = 'OutreachApiError';
+        this.reason = reason;
+        this.status = status;
+    }
+}
+/**
+ * The Mailboxes panel's one door to the mailbox routes (AGL-2978), with the
+ * member's session attached and the organization named on every call — the
+ * dispatcher's release gate reads it. A refusal is thrown as an
+ * {@link OutreachApiError} carrying the route's own sentence, which is
+ * written for the person reading it.
+ */ export function useOutreachMailboxApi(orgId) {
+    const { data: user } = useUser();
+    const call = useCallback(async (route, init)=>{
+        if (!orgId) throw new OutreachApiError('Open an organization first.', 'org-required', 400);
+        const path = init.method === 'GET' ? `/api/${route}?orgId=${encodeURIComponent(orgId)}` : `/api/${route}`;
+        const response = await authorizedFetch(user, path, _extends({
+            method: init.method
+        }, init.method === 'POST' ? {
+            headers: {
+                'Content-Type': 'application/json'
+            },
+            body: JSON.stringify(_extends({
+                orgId
+            }, init.body))
+        } : {}));
+        const payload = await response.json().catch(()=>null);
+        if (!response.ok || !payload) {
+            var _refusal_reason;
+            const refusal = payload != null ? payload : {};
+            throw new OutreachApiError(refusal.error || 'Sequences could not be reached. Try again.', (_refusal_reason = refusal.reason) != null ? _refusal_reason : 'unreachable', response.status);
+        }
+        return payload;
+    }, [
+        user,
+        orgId
+    ]);
+    return useMemo(()=>({
+            availability: ()=>call(OUTREACH_API_ROUTES.mailboxesAvailability, {
+                    method: 'GET'
+                }),
+            connect: async ()=>(await call(OUTREACH_API_ROUTES.mailboxesConnect, {
+                    method: 'POST'
+                })).url,
+            complete: (input)=>call(OUTREACH_API_ROUTES.mailboxesConnectComplete, {
+                    method: 'POST',
+                    body: input
+                }),
+            saveSettings: (input)=>call(OUTREACH_API_ROUTES.mailboxesSettings, {
+                    method: 'POST',
+                    body: input
+                }),
+            setPaused: (mailboxId, paused)=>call(OUTREACH_API_ROUTES.mailboxesStatus, {
+                    method: 'POST',
+                    body: {
+                        mailboxId,
+                        paused
+                    }
+                }),
+            sendTest: (mailboxId)=>call(OUTREACH_API_ROUTES.mailboxesTest, {
+                    method: 'POST',
+                    body: {
+                        mailboxId
+                    }
+                }),
+            disconnect: (mailboxId)=>call(OUTREACH_API_ROUTES.mailboxesDisconnect, {
+                    method: 'POST',
+                    body: {
+                        mailboxId
+                    }
+                })
+        }), [
+        call
+    ]);
+}
+
+//# sourceMappingURL=use-outreach-mailbox-api.js.map