@aglyn/plugins-outreach 1.0.0-beta.143

package/src/lib/routes/enroll-routes.js

@@ -0,0 +1,350 @@
+import { _ as _extends } from "@swc/helpers/_/_extends";
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ import { consentGroupForHost } from "@aglyn/aglyn/app-utils/consent-groups";
+import { CRM_COLLECTIONS, crmViewIsListed, normalizeCrmViewFilters } from "@aglyn/aglyn/app-utils/crm";
+import { dynamicListDimensionsForCrmView } from "@aglyn/aglyn/app-utils/dynamic-list-rule";
+import { findContactByEmail } from "@aglyn/tenant-data-admin/server/contact-email-index";
+import { buildOutreachEnrollment, planOutreachFirstDue } from "../engine/enrollment-state.js";
+import { decideOutreachEnrollment, previewOutreachPerson, readOutreachEnrollCandidates } from "../enrollment/enroll-people.js";
+import { readOutreachGateLookups } from "../enrollment/gate-lookups.js";
+import { effectiveOutreachAllowedCountries } from "../model/compliance-settings.js";
+import { OUTREACH_ENROLL_BATCH_MAX } from "../model/outreach-api.js";
+import { readOutreachComplianceSettingsDoc } from "../storage/compliance-settings-store.js";
+import { outreachEnrollmentId, outreachOrgCollection, readStoredOutreachMailbox, readStoredOutreachSequence } from "../storage/outreach-records.js";
+import { OUTREACH_SEQUENCE_ACTIVITY_TARGET } from "./route-deps.js";
+import { outreachRouteGate } from "./route-gate.js";
+import { outreachMethodNotAllowed, outreachOk, outreachRefusal, readOutreachDocumentId, readOutreachJsonBody } from "./route-http.js";
+/**
+ * ENROLLING PEOPLE IN A SEQUENCE (AGL-2980): `outreach/enroll/preview` and
+ * `outreach/enroll`.
+ *
+ * The preview reads the people a saved Contacts view or a search named —
+ * at most {@link OUTREACH_ENROLL_BATCH_MAX} — and says where each stands:
+ * eligible, blocked with the gate's own sentence, or waiting on the rep for
+ * a personal line and the attestations only they can make. Confirm reads
+ * everything again and asks the gates again with what the rep supplied,
+ * because a preview is a picture of a moment: someone can unsubscribe
+ * between the two, and a request can claim anything. Nothing the preview
+ * answered is trusted by the enroll.
+ *
+ * Both read the CRM's people, so both ask for `data.manage` beside
+ * `outreach.use` — the permission the contacts' own rules read with, so
+ * Outreach is no side door into the address book.
+ *
+ * Only an ACTIVE sequence takes people: enrolling schedules the first step
+ * in the mailbox's hours, and a draft's steps and a paused sequence's timing
+ * are not yet what will be sent.
+ */ /** The permission enrolling reads the CRM with. */ export const OUTREACH_READS_PEOPLE = {
+    key: 'data.manage',
+    refusal: "Enrolling reads your CRM's contacts, and your role does not include Manage data."
+};
+/** The activity line an enroll writes. */ export function outreachEnrolledActivity(count) {
+    return count === 1 ? 'Enrolled 1 person in a sequence' : `Enrolled ${count} people in a sequence`;
+}
+/** Lookups for a person the gates will never be asked about: every one unchecked. */ const UNCHECKED = {
+    platformSuppressed: null,
+    hostSuppressed: null,
+    salesTopicState: null,
+    doNotContact: null,
+    workspaceMembers: null,
+    openEnrollments: null,
+    hasInboundEmail: null
+};
+/** gRPC `ALREADY_EXISTS`, which `create()` rejects with when the document is there. */ const ALREADY_EXISTS = 6;
+async function loadActiveSequence(firestore, orgId, rawSequenceId) {
+    const sequenceId = readOutreachDocumentId(rawSequenceId);
+    if (!sequenceId) return outreachRefusal(400, 'invalid-request', 'Name the sequence to enroll people in.');
+    const snapshot = await outreachOrgCollection(firestore, orgId, 'sequences').doc(sequenceId).get();
+    const sequence = readStoredOutreachSequence(sequenceId, snapshot.exists ? snapshot.data() : undefined);
+    if (!sequence) return outreachRefusal(404, 'sequence-not-found', 'That sequence no longer exists.');
+    if (sequence.status === 'archived') {
+        return outreachRefusal(409, 'sequence-archived', 'This sequence is archived and takes no one new.');
+    }
+    if (sequence.status !== 'active') {
+        return outreachRefusal(409, 'sequence-not-active', 'Activate this sequence before enrolling people.');
+    }
+    return sequence;
+}
+async function enrollContext(firestore, caller, sequence) {
+    var _host_get;
+    const [orgSettings, host] = await Promise.all([
+        readOutreachComplianceSettingsDoc(firestore, caller.orgId),
+        firestore.collection('hosts').doc(sequence.hostId).get()
+    ]);
+    return {
+        // The organization's countries are a ceiling over the sequence's.
+        settings: _extends({}, sequence.settings, {
+            allowedCountries: effectiveOutreachAllowedCountries(sequence.settings.allowedCountries, orgSettings.allowedCountries)
+        }),
+        contactGroupId: consentGroupForHost(caller.org, sequence.hostId).groupId,
+        siteName: host.exists ? String((_host_get = host.get('name')) != null ? _host_get : '') : ''
+    };
+}
+/** The candidates, the enrollments they already have here, and the gates' lookups. */ async function readPeople(firestore, caller, sequence, context, contactIds) {
+    const candidates = await readOutreachEnrollCandidates(firestore, {
+        orgId: caller.orgId,
+        hostId: sequence.hostId,
+        contactGroupId: context.contactGroupId,
+        contactIds
+    });
+    const enrollments = outreachOrgCollection(firestore, caller.orgId, 'enrollments');
+    const existing = candidates.length ? await firestore.getAll(...candidates.map((candidate)=>enrollments.doc(outreachEnrollmentId(sequence.id, candidate.contactId)))) : [];
+    const enrolledHere = new Set(candidates.filter((_candidate, index)=>{
+        var _existing_index;
+        return (_existing_index = existing[index]) == null ? void 0 : _existing_index.exists;
+    }).map((candidate)=>candidate.contactId));
+    const askable = candidates.filter((candidate)=>candidate.contact && candidate.visible && candidate.email);
+    const lookups = askable.length ? await readOutreachGateLookups(firestore, {
+        orgId: caller.orgId,
+        hostId: sequence.hostId,
+        people: askable.map((candidate)=>({
+                contactId: candidate.contactId,
+                email: String(candidate.email)
+            }))
+    }) : new Map();
+    return {
+        candidates,
+        enrolledHere,
+        lookups
+    };
+}
+const uniqueIds = (values)=>Array.isArray(values) ? [
+        ...new Set(values.map(readOutreachDocumentId).filter((id)=>id !== null))
+    ] : [];
+export function createOutreachEnrollRoutes(deps) {
+    /**
+   * The contacts a source names, the batch limit applied: every contact a
+   * search picked, or the people a saved Contacts view selects at the
+   * sequence's site, found by address.
+   */ async function sourceContactIds(firestore, caller, sequence, source) {
+        var _data_ownerUid;
+        if (source['kind'] === 'contacts') {
+            const ids = uniqueIds(source['contactIds']);
+            if (!ids.length) return outreachRefusal(400, 'invalid-request', 'Pick the people to enroll.');
+            return {
+                contactIds: ids.slice(0, OUTREACH_ENROLL_BATCH_MAX),
+                total: ids.length,
+                truncated: ids.length > OUTREACH_ENROLL_BATCH_MAX
+            };
+        }
+        if (source['kind'] !== 'view') {
+            return outreachRefusal(400, 'invalid-request', 'Enroll people from a saved view or a search.');
+        }
+        const viewId = readOutreachDocumentId(source['viewId']);
+        const view = viewId ? await firestore.collection('orgs').doc(caller.orgId).collection(CRM_COLLECTIONS.views).doc(viewId).get() : null;
+        const data = (view == null ? void 0 : view.exists) ? view.data() : null;
+        // A colleague's private view is theirs: it is not listed for this
+        // reader, so it does not exist for them here either.
+        if (!viewId || !data || !crmViewIsListed({
+            shared: data['shared'] === true,
+            ownerUid: String((_data_ownerUid = data['ownerUid']) != null ? _data_ownerUid : '')
+        }, caller.uid)) {
+            return outreachRefusal(404, 'view-not-found', 'That saved view no longer exists.');
+        }
+        if (data['section'] !== 'contacts') {
+            return outreachRefusal(400, 'view-unsupported', 'Enroll from a saved view of Contacts.');
+        }
+        const { unsupported } = dynamicListDimensionsForCrmView(normalizeCrmViewFilters(data['filters']));
+        if (unsupported.length) {
+            // Dropping the filter enrolling cannot read would enroll more people
+            // than the view shows, so the view is refused whole.
+            return outreachRefusal(400, 'view-unsupported', `This view filters on ${unsupported.map((clause)=>clause.label || clause.field).join(', ')}, which enrolling can't apply. Pick another view, or search.`);
+        }
+        const { emails, complete } = await deps.crmViewEmails({
+            hostId: sequence.hostId,
+            viewId
+        });
+        const ordered = [
+            ...new Set(emails)
+        ].sort();
+        const contacts = firestore.collection('orgs').doc(caller.orgId).collection('contacts');
+        const found = await Promise.all(ordered.slice(0, OUTREACH_ENROLL_BATCH_MAX).map((email)=>findContactByEmail(contacts, email, {
+                hostId: sequence.hostId
+            })));
+        return {
+            contactIds: [
+                ...new Set(found.filter((snapshot)=>snapshot).map((snapshot)=>String(snapshot == null ? void 0 : snapshot.id)))
+            ],
+            total: ordered.length,
+            truncated: ordered.length > OUTREACH_ENROLL_BATCH_MAX || !complete
+        };
+    }
+    const preview = async (request)=>{
+        if (request.method !== 'POST') return outreachMethodNotAllowed('POST');
+        const body = await readOutreachJsonBody(request);
+        const caller = await outreachRouteGate(request, body['orgId'], deps.gate, [
+            OUTREACH_READS_PEOPLE
+        ]);
+        if (caller instanceof Response) return caller;
+        const firestore = deps.firestore();
+        const sequence = await loadActiveSequence(firestore, caller.orgId, body['sequenceId']);
+        if (sequence instanceof Response) return sequence;
+        const source = body['source'] && typeof body['source'] === 'object' ? body['source'] : {};
+        const named = await sourceContactIds(firestore, caller, sequence, source);
+        if (named instanceof Response) return named;
+        const context = await enrollContext(firestore, caller, sequence);
+        const { candidates, enrolledHere, lookups } = await readPeople(firestore, caller, sequence, context, named.contactIds);
+        const people = candidates.map((candidate)=>{
+            var _lookups_get;
+            return previewOutreachPerson({
+                candidate,
+                lookups: (_lookups_get = lookups.get(candidate.contactId)) != null ? _lookups_get : UNCHECKED,
+                settings: context.settings,
+                contactGroupId: context.contactGroupId
+            }, {
+                siteName: context.siteName,
+                alreadyInSequence: enrolledHere.has(candidate.contactId)
+            });
+        });
+        return outreachOk({
+            ok: true,
+            people,
+            total: named.total,
+            truncated: named.truncated
+        });
+    };
+    const confirm = async (request)=>{
+        if (request.method !== 'POST') return outreachMethodNotAllowed('POST');
+        const body = await readOutreachJsonBody(request);
+        const caller = await outreachRouteGate(request, body['orgId'], deps.gate, [
+            OUTREACH_READS_PEOPLE
+        ]);
+        if (caller instanceof Response) return caller;
+        const firestore = deps.firestore();
+        const sequence = await loadActiveSequence(firestore, caller.orgId, body['sequenceId']);
+        if (sequence instanceof Response) return sequence;
+        const requested = new Map();
+        for (const entry of Array.isArray(body['people']) ? body['people'] : []){
+            const person = entry && typeof entry === 'object' ? entry : {};
+            const contactId = readOutreachDocumentId(person['contactId']);
+            if (!contactId || requested.has(contactId)) continue;
+            requested.set(contactId, {
+                personalLine: typeof person['personalLine'] === 'string' ? person['personalLine'] : '',
+                attestations: Array.isArray(person['attestations']) ? person['attestations'] : []
+            });
+        }
+        if (!requested.size) return outreachRefusal(400, 'invalid-request', 'Pick the people to enroll.');
+        if (requested.size > OUTREACH_ENROLL_BATCH_MAX) {
+            return outreachRefusal(400, 'invalid-request', `Enroll at most ${OUTREACH_ENROLL_BATCH_MAX} people at a time.`);
+        }
+        const mailboxSnapshot = sequence.mailboxId ? await outreachOrgCollection(firestore, caller.orgId, 'mailboxes').doc(sequence.mailboxId).get() : null;
+        const mailbox = readStoredOutreachMailbox(sequence.mailboxId, (mailboxSnapshot == null ? void 0 : mailboxSnapshot.exists) ? mailboxSnapshot.data() : undefined);
+        if (!mailbox || mailbox.status === 'disconnected') {
+            return outreachRefusal(409, 'mailbox-unavailable', "This sequence's mailbox is no longer connected. Choose another mailbox for it before enrolling people.");
+        }
+        const nowMs = deps.now();
+        if (planOutreachFirstDue({
+            sequence,
+            mailbox,
+            enrolledAtMs: nowMs,
+            random: deps.random
+        }) === null) {
+            return outreachRefusal(409, 'mailbox-unavailable', "This sequence's sending hours never open in its mailbox's timezone. Fix the hours before enrolling people.");
+        }
+        const context = await enrollContext(firestore, caller, sequence);
+        const { candidates, enrolledHere, lookups } = await readPeople(firestore, caller, sequence, context, [
+            ...requested.keys()
+        ]);
+        const enrollments = outreachOrgCollection(firestore, caller.orgId, 'enrollments');
+        const results = await Promise.all(candidates.map(async (candidate)=>{
+            var _requested_get, _lookups_get;
+            const supplied = (_requested_get = requested.get(candidate.contactId)) != null ? _requested_get : {
+                personalLine: '',
+                attestations: []
+            };
+            const decision = decideOutreachEnrollment({
+                candidate,
+                lookups: (_lookups_get = lookups.get(candidate.contactId)) != null ? _lookups_get : UNCHECKED,
+                settings: context.settings,
+                contactGroupId: context.contactGroupId
+            }, {
+                siteName: context.siteName,
+                alreadyInSequence: enrolledHere.has(candidate.contactId)
+            }, _extends({}, supplied, {
+                uid: caller.uid,
+                nowMs
+            }));
+            if (!decision.allowed || !decision.email) {
+                return {
+                    contactId: candidate.contactId,
+                    email: candidate.email,
+                    outcome: 'blocked',
+                    blocks: decision.blocks
+                };
+            }
+            const id = outreachEnrollmentId(sequence.id, candidate.contactId);
+            const enrollment = buildOutreachEnrollment({
+                id,
+                sequence,
+                mailbox,
+                contactId: candidate.contactId,
+                contactName: candidate.name,
+                email: decision.email,
+                cold: decision.cold,
+                personalLine: supplied.personalLine,
+                attestations: decision.attestations,
+                enrolledByUid: caller.uid,
+                nowMs,
+                random: deps.random
+            });
+            try {
+                await enrollments.doc(id).create(enrollment);
+            } catch (error) {
+                if ((error == null ? void 0 : error.code) !== ALREADY_EXISTS) throw error;
+                return {
+                    contactId: candidate.contactId,
+                    email: candidate.email,
+                    outcome: 'blocked',
+                    blocks: [
+                        {
+                            code: 'already_in_sequence',
+                            reason: "This person has already been in this sequence, so they won't be sent its emails again."
+                        }
+                    ]
+                };
+            }
+            return {
+                contactId: candidate.contactId,
+                email: decision.email,
+                outcome: 'enrolled',
+                enrollmentId: id
+            };
+        }));
+        const enrolled = results.filter((result)=>result.outcome === 'enrolled').length;
+        if (enrolled) {
+            await deps.logOrgActivity(caller.orgId, {
+                uid: caller.uid,
+                email: caller.email
+            }, outreachEnrolledActivity(enrolled), {
+                type: OUTREACH_SEQUENCE_ACTIVITY_TARGET,
+                id: sequence.id,
+                name: sequence.name
+            });
+        }
+        return outreachOk({
+            ok: true,
+            results,
+            enrolled
+        });
+    };
+    return {
+        preview,
+        confirm
+    };
+}
+
+//# sourceMappingURL=enroll-routes.js.map

package/src/lib/routes/enroll-routes.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/outreach/src/lib/routes/enroll-routes.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\nimport { consentGroupForHost } from '@aglyn/aglyn/app-utils/consent-groups'\nimport {\n  CRM_COLLECTIONS,\n  crmViewIsListed,\n  normalizeCrmViewFilters,\n} from '@aglyn/aglyn/app-utils/crm'\nimport { dynamicListDimensionsForCrmView } from '@aglyn/aglyn/app-utils/dynamic-list-rule'\nimport type { PluginWebApiHandler } from '@aglyn/aglyn/server'\nimport { findContactByEmail } from '@aglyn/tenant-data-admin/server/contact-email-index'\nimport { buildOutreachEnrollment, planOutreachFirstDue } from '../engine/enrollment-state'\nimport type { OutreachGateLookups } from '../engine/gates'\nimport {\n  decideOutreachEnrollment,\n  previewOutreachPerson,\n  readOutreachEnrollCandidates,\n  type OutreachEnrollCandidate,\n  type OutreachGateQuestion,\n} from '../enrollment/enroll-people'\nimport { readOutreachGateLookups } from '../enrollment/gate-lookups'\nimport { effectiveOutreachAllowedCountries } from '../model/compliance-settings'\nimport {\n  OUTREACH_ENROLL_BATCH_MAX,\n  type OutreachEnrollOutcome,\n  type OutreachEnrollPreviewResponse,\n  type OutreachEnrollResponse,\n} from '../model/outreach-api'\nimport type { OutreachSequence } from '../model/outreach.types'\nimport { readOutreachComplianceSettingsDoc } from '../storage/compliance-settings-store'\nimport {\n  outreachEnrollmentId,\n  outreachOrgCollection,\n  readStoredOutreachMailbox,\n  readStoredOutreachSequence,\n} from '../storage/outreach-records'\nimport { OUTREACH_SEQUENCE_ACTIVITY_TARGET, type OutreachRouteDeps } from './route-deps'\nimport { outreachRouteGate, type OutreachRouteCaller, type OutreachRouteExtraPermission } from './route-gate'\nimport {\n  outreachMethodNotAllowed,\n  outreachOk,\n  outreachRefusal,\n  readOutreachDocumentId,\n  readOutreachJsonBody,\n} from './route-http'\n\n/**\n * ENROLLING PEOPLE IN A SEQUENCE (AGL-2980): `outreach/enroll/preview` and\n * `outreach/enroll`.\n *\n * The preview reads the people a saved Contacts view or a search named —\n * at most {@link OUTREACH_ENROLL_BATCH_MAX} — and says where each stands:\n * eligible, blocked with the gate's own sentence, or waiting on the rep for\n * a personal line and the attestations only they can make. Confirm reads\n * everything again and asks the gates again with what the rep supplied,\n * because a preview is a picture of a moment: someone can unsubscribe\n * between the two, and a request can claim anything. Nothing the preview\n * answered is trusted by the enroll.\n *\n * Both read the CRM's people, so both ask for `data.manage` beside\n * `outreach.use` — the permission the contacts' own rules read with, so\n * Outreach is no side door into the address book.\n *\n * Only an ACTIVE sequence takes people: enrolling schedules the first step\n * in the mailbox's hours, and a draft's steps and a paused sequence's timing\n * are not yet what will be sent.\n */\n\n/** The permission enrolling reads the CRM with. */\nexport const OUTREACH_READS_PEOPLE: OutreachRouteExtraPermission = {\n  key: 'data.manage',\n  refusal: \"Enrolling reads your CRM's contacts, and your role does not include Manage data.\",\n}\n\n/** Everything enrolling reaches beyond the routes' own dependencies. */\nexport interface OutreachEnrollRouteDeps extends OutreachRouteDeps {\n  /**\n   * The addresses a saved Contacts view selects among one site's contacts,\n   * read the way the dynamic-list sweep reads one, and whether the read\n   * reached the whole view before its budget.\n   */\n  crmViewEmails(input: { hostId: string; viewId: string }): Promise<{ emails: string[]; complete: boolean }>\n}\n\nexport interface OutreachEnrollRoutes {\n  preview: PluginWebApiHandler\n  confirm: PluginWebApiHandler\n}\n\n/** The activity line an enroll writes. */\nexport function outreachEnrolledActivity(count: number): string {\n  return count === 1\n    ? 'Enrolled 1 person in a sequence'\n    : `Enrolled ${count} people in a sequence`\n}\n\n/** Lookups for a person the gates will never be asked about: every one unchecked. */\nconst UNCHECKED: OutreachGateLookups = {\n  platformSuppressed: null,\n  hostSuppressed: null,\n  salesTopicState: null,\n  doNotContact: null,\n  workspaceMembers: null,\n  openEnrollments: null,\n  hasInboundEmail: null,\n}\n\ntype Firestore = FirebaseFirestore.Firestore\n\n/** gRPC `ALREADY_EXISTS`, which `create()` rejects with when the document is there. */\nconst ALREADY_EXISTS = 6\n\nasync function loadActiveSequence(\n  firestore: Firestore,\n  orgId: string,\n  rawSequenceId: unknown,\n): Promise<Response | OutreachSequence> {\n  const sequenceId = readOutreachDocumentId(rawSequenceId)\n  if (!sequenceId) return outreachRefusal(400, 'invalid-request', 'Name the sequence to enroll people in.')\n  const snapshot = await outreachOrgCollection(firestore, orgId, 'sequences').doc(sequenceId).get()\n  const sequence = readStoredOutreachSequence(sequenceId, snapshot.exists ? snapshot.data() : undefined)\n  if (!sequence) return outreachRefusal(404, 'sequence-not-found', 'That sequence no longer exists.')\n  if (sequence.status === 'archived') {\n    return outreachRefusal(409, 'sequence-archived', 'This sequence is archived and takes no one new.')\n  }\n  if (sequence.status !== 'active') {\n    return outreachRefusal(409, 'sequence-not-active', 'Activate this sequence before enrolling people.')\n  }\n  return sequence\n}\n\n/** What every person in one request is judged against. */\ninterface EnrollContext {\n  settings: OutreachGateQuestion['settings']\n  contactGroupId: string\n  siteName: string\n}\n\nasync function enrollContext(\n  firestore: Firestore,\n  caller: OutreachRouteCaller,\n  sequence: OutreachSequence,\n): Promise<EnrollContext> {\n  const [orgSettings, host] = await Promise.all([\n    readOutreachComplianceSettingsDoc(firestore, caller.orgId),\n    firestore.collection('hosts').doc(sequence.hostId).get(),\n  ])\n  return {\n    // The organization's countries are a ceiling over the sequence's.\n    settings: {\n      ...sequence.settings,\n      allowedCountries: effectiveOutreachAllowedCountries(\n        sequence.settings.allowedCountries,\n        orgSettings.allowedCountries,\n      ),\n    },\n    contactGroupId: consentGroupForHost(caller.org, sequence.hostId).groupId,\n    siteName: host.exists ? String(host.get('name') ?? '') : '',\n  }\n}\n\n/** The candidates, the enrollments they already have here, and the gates' lookups. */\nasync function readPeople(\n  firestore: Firestore,\n  caller: OutreachRouteCaller,\n  sequence: OutreachSequence,\n  context: EnrollContext,\n  contactIds: readonly string[],\n): Promise<{\n  candidates: OutreachEnrollCandidate[]\n  enrolledHere: Set<string>\n  lookups: Map<string, OutreachGateLookups>\n}> {\n  const candidates = await readOutreachEnrollCandidates(firestore, {\n    orgId: caller.orgId,\n    hostId: sequence.hostId,\n    contactGroupId: context.contactGroupId,\n    contactIds,\n  })\n  const enrollments = outreachOrgCollection(firestore, caller.orgId, 'enrollments')\n  const existing = candidates.length\n    ? await firestore.getAll(\n        ...candidates.map((candidate) => enrollments.doc(outreachEnrollmentId(sequence.id, candidate.contactId))),\n      )\n    : []\n  const enrolledHere = new Set(\n    candidates.filter((_candidate, index) => existing[index]?.exists).map((candidate) => candidate.contactId),\n  )\n  const askable = candidates.filter((candidate) => candidate.contact && candidate.visible && candidate.email)\n  const lookups = askable.length\n    ? await readOutreachGateLookups(firestore, {\n        orgId: caller.orgId,\n        hostId: sequence.hostId,\n        people: askable.map((candidate) => ({ contactId: candidate.contactId, email: String(candidate.email) })),\n      })\n    : new Map<string, OutreachGateLookups>()\n  return { candidates, enrolledHere, lookups }\n}\n\nconst uniqueIds = (values: unknown): string[] =>\n  Array.isArray(values)\n    ? [...new Set(values.map(readOutreachDocumentId).filter((id): id is string => id !== null))]\n    : []\n\nexport function createOutreachEnrollRoutes(deps: OutreachEnrollRouteDeps): OutreachEnrollRoutes {\n  /**\n   * The contacts a source names, the batch limit applied: every contact a\n   * search picked, or the people a saved Contacts view selects at the\n   * sequence's site, found by address.\n   */\n  async function sourceContactIds(\n    firestore: Firestore,\n    caller: OutreachRouteCaller,\n    sequence: OutreachSequence,\n    source: Record<string, unknown>,\n  ): Promise<Response | { contactIds: string[]; total: number; truncated: boolean }> {\n    if (source['kind'] === 'contacts') {\n      const ids = uniqueIds(source['contactIds'])\n      if (!ids.length) return outreachRefusal(400, 'invalid-request', 'Pick the people to enroll.')\n      return {\n        contactIds: ids.slice(0, OUTREACH_ENROLL_BATCH_MAX),\n        total: ids.length,\n        truncated: ids.length > OUTREACH_ENROLL_BATCH_MAX,\n      }\n    }\n    if (source['kind'] !== 'view') {\n      return outreachRefusal(400, 'invalid-request', 'Enroll people from a saved view or a search.')\n    }\n    const viewId = readOutreachDocumentId(source['viewId'])\n    const view = viewId\n      ? await firestore.collection('orgs').doc(caller.orgId).collection(CRM_COLLECTIONS.views).doc(viewId).get()\n      : null\n    const data = view?.exists ? (view.data() as Record<string, unknown>) : null\n    // A colleague's private view is theirs: it is not listed for this\n    // reader, so it does not exist for them here either.\n    if (\n      !viewId ||\n      !data ||\n      !crmViewIsListed({ shared: data['shared'] === true, ownerUid: String(data['ownerUid'] ?? '') }, caller.uid)\n    ) {\n      return outreachRefusal(404, 'view-not-found', 'That saved view no longer exists.')\n    }\n    if (data['section'] !== 'contacts') {\n      return outreachRefusal(400, 'view-unsupported', 'Enroll from a saved view of Contacts.')\n    }\n    const { unsupported } = dynamicListDimensionsForCrmView(normalizeCrmViewFilters(data['filters']))\n    if (unsupported.length) {\n      // Dropping the filter enrolling cannot read would enroll more people\n      // than the view shows, so the view is refused whole.\n      return outreachRefusal(\n        400,\n        'view-unsupported',\n        `This view filters on ${unsupported.map((clause) => clause.label || clause.field).join(', ')}, which enrolling can't apply. Pick another view, or search.`,\n      )\n    }\n    const { emails, complete } = await deps.crmViewEmails({ hostId: sequence.hostId, viewId })\n    const ordered = [...new Set(emails)].sort()\n    const contacts = firestore.collection('orgs').doc(caller.orgId).collection('contacts')\n    const found = await Promise.all(\n      ordered\n        .slice(0, OUTREACH_ENROLL_BATCH_MAX)\n        .map((email) => findContactByEmail(contacts, email, { hostId: sequence.hostId })),\n    )\n    return {\n      contactIds: [...new Set(found.filter((snapshot) => snapshot).map((snapshot) => String(snapshot?.id)))],\n      total: ordered.length,\n      truncated: ordered.length > OUTREACH_ENROLL_BATCH_MAX || !complete,\n    }\n  }\n\n  const preview: PluginWebApiHandler = async (request) => {\n    if (request.method !== 'POST') return outreachMethodNotAllowed('POST')\n    const body = await readOutreachJsonBody(request)\n    const caller = await outreachRouteGate(request, body['orgId'], deps.gate, [OUTREACH_READS_PEOPLE])\n    if (caller instanceof Response) return caller\n    const firestore = deps.firestore()\n    const sequence = await loadActiveSequence(firestore, caller.orgId, body['sequenceId'])\n    if (sequence instanceof Response) return sequence\n    const source = body['source'] && typeof body['source'] === 'object' ? (body['source'] as Record<string, unknown>) : {}\n    const named = await sourceContactIds(firestore, caller, sequence, source)\n    if (named instanceof Response) return named\n    const context = await enrollContext(firestore, caller, sequence)\n    const { candidates, enrolledHere, lookups } = await readPeople(\n      firestore,\n      caller,\n      sequence,\n      context,\n      named.contactIds,\n    )\n    const people = candidates.map((candidate) =>\n      previewOutreachPerson(\n        {\n          candidate,\n          lookups: lookups.get(candidate.contactId) ?? UNCHECKED,\n          settings: context.settings,\n          contactGroupId: context.contactGroupId,\n        },\n        { siteName: context.siteName, alreadyInSequence: enrolledHere.has(candidate.contactId) },\n      ),\n    )\n    return outreachOk({\n      ok: true,\n      people,\n      total: named.total,\n      truncated: named.truncated,\n    } satisfies OutreachEnrollPreviewResponse)\n  }\n\n  const confirm: PluginWebApiHandler = async (request) => {\n    if (request.method !== 'POST') return outreachMethodNotAllowed('POST')\n    const body = await readOutreachJsonBody(request)\n    const caller = await outreachRouteGate(request, body['orgId'], deps.gate, [OUTREACH_READS_PEOPLE])\n    if (caller instanceof Response) return caller\n    const firestore = deps.firestore()\n    const sequence = await loadActiveSequence(firestore, caller.orgId, body['sequenceId'])\n    if (sequence instanceof Response) return sequence\n\n    const requested = new Map<string, { personalLine: string; attestations: unknown[] }>()\n    for (const entry of Array.isArray(body['people']) ? body['people'] : []) {\n      const person = (entry && typeof entry === 'object' ? entry : {}) as Record<string, unknown>\n      const contactId = readOutreachDocumentId(person['contactId'])\n      if (!contactId || requested.has(contactId)) continue\n      requested.set(contactId, {\n        personalLine: typeof person['personalLine'] === 'string' ? person['personalLine'] : '',\n        attestations: Array.isArray(person['attestations']) ? person['attestations'] : [],\n      })\n    }\n    if (!requested.size) return outreachRefusal(400, 'invalid-request', 'Pick the people to enroll.')\n    if (requested.size > OUTREACH_ENROLL_BATCH_MAX) {\n      return outreachRefusal(\n        400,\n        'invalid-request',\n        `Enroll at most ${OUTREACH_ENROLL_BATCH_MAX} people at a time.`,\n      )\n    }\n\n    const mailboxSnapshot = sequence.mailboxId\n      ? await outreachOrgCollection(firestore, caller.orgId, 'mailboxes').doc(sequence.mailboxId).get()\n      : null\n    const mailbox = readStoredOutreachMailbox(\n      sequence.mailboxId,\n      mailboxSnapshot?.exists ? mailboxSnapshot.data() : undefined,\n    )\n    if (!mailbox || mailbox.status === 'disconnected') {\n      return outreachRefusal(\n        409,\n        'mailbox-unavailable',\n        \"This sequence's mailbox is no longer connected. Choose another mailbox for it before enrolling people.\",\n      )\n    }\n    const nowMs = deps.now()\n    if (planOutreachFirstDue({ sequence, mailbox, enrolledAtMs: nowMs, random: deps.random }) === null) {\n      return outreachRefusal(\n        409,\n        'mailbox-unavailable',\n        \"This sequence's sending hours never open in its mailbox's timezone. Fix the hours before enrolling people.\",\n      )\n    }\n\n    const context = await enrollContext(firestore, caller, sequence)\n    const { candidates, enrolledHere, lookups } = await readPeople(\n      firestore,\n      caller,\n      sequence,\n      context,\n      [...requested.keys()],\n    )\n    const enrollments = outreachOrgCollection(firestore, caller.orgId, 'enrollments')\n    const results: OutreachEnrollOutcome[] = await Promise.all(\n      candidates.map(async (candidate): Promise<OutreachEnrollOutcome> => {\n        const supplied = requested.get(candidate.contactId) ?? { personalLine: '', attestations: [] }\n        const decision = decideOutreachEnrollment(\n          {\n            candidate,\n            lookups: lookups.get(candidate.contactId) ?? UNCHECKED,\n            settings: context.settings,\n            contactGroupId: context.contactGroupId,\n          },\n          { siteName: context.siteName, alreadyInSequence: enrolledHere.has(candidate.contactId) },\n          { ...supplied, uid: caller.uid, nowMs },\n        )\n        if (!decision.allowed || !decision.email) {\n          return { contactId: candidate.contactId, email: candidate.email, outcome: 'blocked', blocks: decision.blocks }\n        }\n        const id = outreachEnrollmentId(sequence.id, candidate.contactId)\n        const enrollment = buildOutreachEnrollment({\n          id,\n          sequence,\n          mailbox,\n          contactId: candidate.contactId,\n          contactName: candidate.name,\n          email: decision.email,\n          cold: decision.cold,\n          personalLine: supplied.personalLine,\n          attestations: decision.attestations,\n          enrolledByUid: caller.uid,\n          nowMs,\n          random: deps.random,\n        })\n        try {\n          await enrollments.doc(id).create(enrollment)\n        } catch (error) {\n          if ((error as { code?: unknown })?.code !== ALREADY_EXISTS) throw error\n          return {\n            contactId: candidate.contactId,\n            email: candidate.email,\n            outcome: 'blocked',\n            blocks: [\n              {\n                code: 'already_in_sequence',\n                reason: \"This person has already been in this sequence, so they won't be sent its emails again.\",\n              },\n            ],\n          }\n        }\n        return { contactId: candidate.contactId, email: decision.email, outcome: 'enrolled', enrollmentId: id }\n      }),\n    )\n    const enrolled = results.filter((result) => result.outcome === 'enrolled').length\n    if (enrolled) {\n      await deps.logOrgActivity(\n        caller.orgId,\n        { uid: caller.uid, email: caller.email },\n        outreachEnrolledActivity(enrolled),\n        { type: OUTREACH_SEQUENCE_ACTIVITY_TARGET, id: sequence.id, name: sequence.name },\n      )\n    }\n    return outreachOk({ ok: true, results, enrolled } satisfies OutreachEnrollResponse)\n  }\n\n  return { preview, confirm }\n}\n"],"names":["consentGroupForHost","CRM_COLLECTIONS","crmViewIsListed","normalizeCrmViewFilters","dynamicListDimensionsForCrmView","findContactByEmail","buildOutreachEnrollment","planOutreachFirstDue","decideOutreachEnrollment","previewOutreachPerson","readOutreachEnrollCandidates","readOutreachGateLookups","effectiveOutreachAllowedCountries","OUTREACH_ENROLL_BATCH_MAX","readOutreachComplianceSettingsDoc","outreachEnrollmentId","outreachOrgCollection","readStoredOutreachMailbox","readStoredOutreachSequence","OUTREACH_SEQUENCE_ACTIVITY_TARGET","outreachRouteGate","outreachMethodNotAllowed","outreachOk","outreachRefusal","readOutreachDocumentId","readOutreachJsonBody","OUTREACH_READS_PEOPLE","key","refusal","outreachEnrolledActivity","count","UNCHECKED","platformSuppressed","hostSuppressed","salesTopicState","doNotContact","workspaceMembers","openEnrollments","hasInboundEmail","ALREADY_EXISTS","loadActiveSequence","firestore","orgId","rawSequenceId","sequenceId","snapshot","doc","get","sequence","exists","data","undefined","status","enrollContext","caller","host","orgSettings","Promise","all","collection","hostId","settings","allowedCountries","contactGroupId","org","groupId","siteName","String","readPeople","context","contactIds","candidates","enrollments","existing","length","getAll","map","candidate","id","contactId","enrolledHere","Set","filter","_candidate","index","askable","contact","visible","email","lookups","people","Map","uniqueIds","values","Array","isArray","createOutreachEnrollRoutes","deps","sourceContactIds","source","ids","slice","total","truncated","viewId","view","views","shared","ownerUid","uid","unsupported","clause","label","field","join","emails","complete","crmViewEmails","ordered","sort","contacts","found","preview","request","method","body","gate","Response","named","alreadyInSequence","has","ok","confirm","requested","entry","person","set","personalLine","attestations","size","mailboxSnapshot","mailboxId","mailbox","nowMs","now","enrolledAtMs","random","keys","results","supplied","decision","allowed","outcome","blocks","enrollment","contactName","name","cold","enrolledByUid","create","error","code","reason","enrollmentId","enrolled","result","logOrgActivity","type"],"mappings":"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"}

package/src/lib/routes/enrollment-routes.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import type { PluginWebApiHandler } from '@aglyn/aglyn/server';
+import type { OutreachRouteDeps } from './route-deps';
+export declare function createOutreachEnrollmentActionRoute(deps: OutreachRouteDeps): PluginWebApiHandler;

package/src/lib/routes/enrollment-routes.js

@@ -0,0 +1,171 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ import { _ as _extends } from "@swc/helpers/_/_extends";
+import { applyOutreachEnrollmentEvent } from "../engine/enrollment-state.js";
+import { OUTREACH_OPEN_ENROLLMENT_STATUSES } from "../engine/gates.js";
+import { addOutreachDoNotContact } from "../storage/do-not-contact-store.js";
+import { outreachOrgCollection, readStoredOutreachEnrollment } from "../storage/outreach-records.js";
+import { outreachRouteGate } from "./route-gate.js";
+import { outreachMethodNotAllowed, outreachOk, outreachRefusal, readOutreachDocumentId, readOutreachJsonBody } from "./route-http.js";
+/**
+ * WHAT A MEMBER DOES TO ONE ENROLLMENT (AGL-2980):
+ * `outreach/enrollments/action` — pause, resume, stop, or mark the person
+ * do-not-contact.
+ *
+ * Every transition is the engine's (`applyOutreachEnrollmentEvent`): the
+ * route decides nothing about which status may follow which. Each write is
+ * a transaction over the one document, so a member's pause and the sending
+ * runtime's step completion cannot interleave and leave a paused enrollment
+ * with a step it should not have run.
+ *
+ * MARK DO-NOT-CONTACT puts the address on the organization's list, with
+ * the member as its author, and then opts out every enrollment that address
+ * has in the organization — this one wherever it stood, and any other that
+ * is still active or paused — so no sequence emails it again, whichever one
+ * would have been next.
+ */ const ACTIONS = [
+    'pause',
+    'resume',
+    'stop',
+    'do_not_contact'
+];
+function eventFor(action, atMs, byUid, detail) {
+    switch(action){
+        case 'pause':
+            return {
+                type: 'pause',
+                atMs,
+                byUid,
+                detail
+            };
+        case 'resume':
+            return {
+                type: 'resume',
+                atMs,
+                byUid
+            };
+        case 'stop':
+            return {
+                type: 'stop',
+                atMs,
+                byUid,
+                reason: 'manual',
+                detail
+            };
+        case 'do_not_contact':
+            return {
+                type: 'opt_out',
+                atMs,
+                reason: 'do_not_contact',
+                detail
+            };
+    }
+}
+export function createOutreachEnrollmentActionRoute(deps) {
+    return async (request)=>{
+        if (request.method !== 'POST') return outreachMethodNotAllowed('POST');
+        const body = await readOutreachJsonBody(request);
+        const caller = await outreachRouteGate(request, body['orgId'], deps.gate);
+        if (caller instanceof Response) return caller;
+        const enrollmentId = readOutreachDocumentId(body['enrollmentId']);
+        const action = body['action'];
+        if (!enrollmentId || !ACTIONS.includes(action)) {
+            return outreachRefusal(400, 'invalid-request', 'Name the enrollment, and pause, resume, stop or mark it do-not-contact.');
+        }
+        const detail = typeof body['detail'] === 'string' ? body['detail'] : null;
+        const firestore = deps.firestore();
+        const enrollments = outreachOrgCollection(firestore, caller.orgId, 'enrollments');
+        const ref = enrollments.doc(enrollmentId);
+        const nowMs = deps.now();
+        const applied = await firestore.runTransaction(async (transaction)=>{
+            const snapshot = await transaction.get(ref);
+            const enrollment = readStoredOutreachEnrollment(enrollmentId, snapshot.exists ? snapshot.data() : undefined);
+            if (!enrollment) return null;
+            const { patch, error } = applyOutreachEnrollmentEvent(enrollment, eventFor(action, nowMs, caller.uid, detail));
+            if (!patch) return {
+                enrollment,
+                error,
+                changed: false
+            };
+            // The opt-out event names no member; the person who marked it is
+            // recorded here, beside the reason, and on the list entry.
+            const written = _extends({}, patch, {
+                stoppedByUid: action === 'do_not_contact' ? caller.uid : patch.stoppedByUid,
+                updatedAtMs: nowMs
+            });
+            transaction.update(ref, written);
+            return {
+                enrollment: _extends({}, enrollment, written),
+                error: null,
+                changed: true
+            };
+        });
+        if (!applied) return outreachRefusal(404, 'enrollment-not-found', 'That enrollment no longer exists.');
+        // An address that bounced still goes on the list when a member asks:
+        // the enrollment's own status stays final, the list entry is what they
+        // asked for.
+        if (applied.error && action !== 'do_not_contact') {
+            return outreachRefusal(409, 'transition-refused', applied.error);
+        }
+        let stoppedOthers = 0;
+        if (action === 'do_not_contact') {
+            await addOutreachDoNotContact(firestore, {
+                orgId: caller.orgId,
+                email: applied.enrollment.email,
+                reason: 'manual',
+                source: 'member',
+                addedByUid: caller.uid,
+                nowMs,
+                enrollmentId,
+                sequenceId: applied.enrollment.sequenceId,
+                detail
+            });
+            stoppedOthers = await optOutOtherEnrollments(firestore, enrollments, applied.enrollment, caller.uid, nowMs);
+        }
+        return outreachOk({
+            ok: true,
+            changed: applied.changed,
+            enrollment: applied.enrollment,
+            stoppedOthers
+        });
+    };
+}
+/** Opts out every OTHER open enrollment of the same address; returns how many. */ async function optOutOtherEnrollments(firestore, enrollments, marked, byUid, nowMs) {
+    const found = await enrollments.where('email', '==', marked.email).get();
+    const batch = firestore.batch();
+    let writes = 0;
+    for (const doc of found.docs){
+        if (doc.id === marked.id) continue;
+        const other = readStoredOutreachEnrollment(doc.id, doc.data());
+        if (!other || !OUTREACH_OPEN_ENROLLMENT_STATUSES.includes(other.status)) continue;
+        const { patch } = applyOutreachEnrollmentEvent(other, {
+            type: 'opt_out',
+            atMs: nowMs,
+            reason: 'do_not_contact',
+            detail: 'Marked do-not-contact from another sequence.'
+        });
+        if (!patch) continue;
+        batch.update(doc.ref, _extends({}, patch, {
+            stoppedByUid: byUid,
+            updatedAtMs: nowMs
+        }));
+        writes += 1;
+    }
+    if (writes) await batch.commit();
+    return writes;
+}
+
+//# sourceMappingURL=enrollment-routes.js.map

package/src/lib/routes/enrollment-routes.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/outreach/src/lib/routes/enrollment-routes.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\nimport type { PluginWebApiHandler } from '@aglyn/aglyn/server'\nimport {\n  applyOutreachEnrollmentEvent,\n  type OutreachEnrollmentEvent,\n} from '../engine/enrollment-state'\nimport { OUTREACH_OPEN_ENROLLMENT_STATUSES } from '../engine/gates'\nimport type {\n  OutreachEnrollmentAction,\n  OutreachEnrollmentActionResponse,\n} from '../model/outreach-api'\nimport type { OutreachEnrollment } from '../model/outreach.types'\nimport { addOutreachDoNotContact } from '../storage/do-not-contact-store'\nimport { outreachOrgCollection, readStoredOutreachEnrollment } from '../storage/outreach-records'\nimport type { OutreachRouteDeps } from './route-deps'\nimport { outreachRouteGate } from './route-gate'\nimport {\n  outreachMethodNotAllowed,\n  outreachOk,\n  outreachRefusal,\n  readOutreachDocumentId,\n  readOutreachJsonBody,\n} from './route-http'\n\n/**\n * WHAT A MEMBER DOES TO ONE ENROLLMENT (AGL-2980):\n * `outreach/enrollments/action` — pause, resume, stop, or mark the person\n * do-not-contact.\n *\n * Every transition is the engine's (`applyOutreachEnrollmentEvent`): the\n * route decides nothing about which status may follow which. Each write is\n * a transaction over the one document, so a member's pause and the sending\n * runtime's step completion cannot interleave and leave a paused enrollment\n * with a step it should not have run.\n *\n * MARK DO-NOT-CONTACT puts the address on the organization's list, with\n * the member as its author, and then opts out every enrollment that address\n * has in the organization — this one wherever it stood, and any other that\n * is still active or paused — so no sequence emails it again, whichever one\n * would have been next.\n */\n\nconst ACTIONS: readonly OutreachEnrollmentAction[] = ['pause', 'resume', 'stop', 'do_not_contact']\n\nfunction eventFor(\n  action: OutreachEnrollmentAction,\n  atMs: number,\n  byUid: string,\n  detail: string | null,\n): OutreachEnrollmentEvent {\n  switch (action) {\n    case 'pause':\n      return { type: 'pause', atMs, byUid, detail }\n    case 'resume':\n      return { type: 'resume', atMs, byUid }\n    case 'stop':\n      return { type: 'stop', atMs, byUid, reason: 'manual', detail }\n    case 'do_not_contact':\n      return { type: 'opt_out', atMs, reason: 'do_not_contact', detail }\n  }\n}\n\nexport function createOutreachEnrollmentActionRoute(deps: OutreachRouteDeps): PluginWebApiHandler {\n  return async (request) => {\n    if (request.method !== 'POST') return outreachMethodNotAllowed('POST')\n    const body = await readOutreachJsonBody(request)\n    const caller = await outreachRouteGate(request, body['orgId'], deps.gate)\n    if (caller instanceof Response) return caller\n    const enrollmentId = readOutreachDocumentId(body['enrollmentId'])\n    const action = body['action'] as OutreachEnrollmentAction\n    if (!enrollmentId || !ACTIONS.includes(action)) {\n      return outreachRefusal(400, 'invalid-request', 'Name the enrollment, and pause, resume, stop or mark it do-not-contact.')\n    }\n    const detail = typeof body['detail'] === 'string' ? body['detail'] : null\n    const firestore = deps.firestore()\n    const enrollments = outreachOrgCollection(firestore, caller.orgId, 'enrollments')\n    const ref = enrollments.doc(enrollmentId)\n    const nowMs = deps.now()\n\n    const applied = await firestore.runTransaction(async (transaction) => {\n      const snapshot = await transaction.get(ref)\n      const enrollment = readStoredOutreachEnrollment(enrollmentId, snapshot.exists ? snapshot.data() : undefined)\n      if (!enrollment) return null\n      const { patch, error } = applyOutreachEnrollmentEvent(\n        enrollment,\n        eventFor(action, nowMs, caller.uid, detail),\n      )\n      if (!patch) return { enrollment, error, changed: false }\n      // The opt-out event names no member; the person who marked it is\n      // recorded here, beside the reason, and on the list entry.\n      const written = {\n        ...patch,\n        stoppedByUid: action === 'do_not_contact' ? caller.uid : patch.stoppedByUid,\n        updatedAtMs: nowMs,\n      }\n      transaction.update(ref, written)\n      return { enrollment: { ...enrollment, ...written } as OutreachEnrollment, error: null, changed: true }\n    })\n    if (!applied) return outreachRefusal(404, 'enrollment-not-found', 'That enrollment no longer exists.')\n    // An address that bounced still goes on the list when a member asks:\n    // the enrollment's own status stays final, the list entry is what they\n    // asked for.\n    if (applied.error && action !== 'do_not_contact') {\n      return outreachRefusal(409, 'transition-refused', applied.error)\n    }\n\n    let stoppedOthers = 0\n    if (action === 'do_not_contact') {\n      await addOutreachDoNotContact(firestore, {\n        orgId: caller.orgId,\n        email: applied.enrollment.email,\n        reason: 'manual',\n        source: 'member',\n        addedByUid: caller.uid,\n        nowMs,\n        enrollmentId,\n        sequenceId: applied.enrollment.sequenceId,\n        detail,\n      })\n      stoppedOthers = await optOutOtherEnrollments(firestore, enrollments, applied.enrollment, caller.uid, nowMs)\n    }\n    return outreachOk({\n      ok: true,\n      changed: applied.changed,\n      enrollment: applied.enrollment,\n      stoppedOthers,\n    } satisfies OutreachEnrollmentActionResponse)\n  }\n}\n\n/** Opts out every OTHER open enrollment of the same address; returns how many. */\nasync function optOutOtherEnrollments(\n  firestore: FirebaseFirestore.Firestore,\n  enrollments: FirebaseFirestore.CollectionReference,\n  marked: OutreachEnrollment,\n  byUid: string,\n  nowMs: number,\n): Promise<number> {\n  const found = await enrollments.where('email', '==', marked.email).get()\n  const batch = firestore.batch()\n  let writes = 0\n  for (const doc of found.docs) {\n    if (doc.id === marked.id) continue\n    const other = readStoredOutreachEnrollment(doc.id, doc.data())\n    if (!other || !OUTREACH_OPEN_ENROLLMENT_STATUSES.includes(other.status)) continue\n    const { patch } = applyOutreachEnrollmentEvent(other, {\n      type: 'opt_out',\n      atMs: nowMs,\n      reason: 'do_not_contact',\n      detail: 'Marked do-not-contact from another sequence.',\n    })\n    if (!patch) continue\n    batch.update(doc.ref, { ...patch, stoppedByUid: byUid, updatedAtMs: nowMs })\n    writes += 1\n  }\n  if (writes) await batch.commit()\n  return writes\n}\n"],"names":["applyOutreachEnrollmentEvent","OUTREACH_OPEN_ENROLLMENT_STATUSES","addOutreachDoNotContact","outreachOrgCollection","readStoredOutreachEnrollment","outreachRouteGate","outreachMethodNotAllowed","outreachOk","outreachRefusal","readOutreachDocumentId","readOutreachJsonBody","ACTIONS","eventFor","action","atMs","byUid","detail","type","reason","createOutreachEnrollmentActionRoute","deps","request","method","body","caller","gate","Response","enrollmentId","includes","firestore","enrollments","orgId","ref","doc","nowMs","now","applied","runTransaction","transaction","snapshot","get","enrollment","exists","data","undefined","patch","error","uid","changed","written","stoppedByUid","updatedAtMs","update","stoppedOthers","email","source","addedByUid","sequenceId","optOutOtherEnrollments","ok","marked","found","where","batch","writes","docs","id","other","status","commit"],"mappings":"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"}