@aglyn/plugins-outreach 1.0.0-beta.143

package/src/lib/declarations.console-server.js

@@ -0,0 +1,99 @@
+/**
+ * @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.
+ */ // Each registry from its own module, not the `@aglyn/aglyn/server` barrel:
+// boot needs one registry, not the whole server surface.
+import { registerPluginConsoleCron } from "@aglyn/aglyn/plugin-manager/plugin-console-crons";
+import { listPluginOrgErasers, registerPluginOrgEraser } from "@aglyn/aglyn/plugin-manager/plugin-org-erasure";
+import { registerPluginPersonEraser } from "@aglyn/aglyn/plugin-manager/plugin-person-erasure";
+import { listPluginUserErasers, registerPluginUserEraser } from "@aglyn/aglyn/plugin-manager/plugin-user-erasure";
+import { OUTREACH_PLUGIN_ID } from "./constants/bundle-common.js";
+import { OUTREACH_SEND_JOB_ID, OUTREACH_SYNC_JOB_ID } from "./constants/runtime-jobs.js";
+/**
+ * Outreach's CONSOLE-ONLY server declarations (AGL-2978), named under
+ * `consoleServerDeclarations` in `plugins.config.json` and run at the
+ * console's boot.
+ *
+ * The erasers are registered here rather than from `serverDeclarations`,
+ * which the tenant runtime also loads: the workspace eraser revokes each
+ * rep's Google grant, and the account eraser (AGL-3106) revokes and deletes
+ * the person's own, and both open a sealed token with `OUTREACH_TOKEN_KEY`,
+ * which only the console holds. The tenant may not so much as bundle the code
+ * that does (`outreach-credential-isolation.spec.ts`). Every erasure runs in
+ * the console, so this is where the erasers are needed.
+ *
+ * The sending runtime (AGL-2981) is declared here too, for the same reason:
+ * the send and sync jobs open each rep's sealed grant, so they run on the
+ * console's `plugin-console-crons` tick and nowhere else, and the person
+ * eraser removes the enrollments a workspace kept about someone it erases.
+ *
+ * Light at boot: every module that does the work is imported when a job, an
+ * erasure or a tick first asks for it, so the boot cost is the registration.
+ */ export function registerOutreachConsoleServerDeclarations() {
+    // Idempotent against the REGISTRY, so a reset (a spec) registers again.
+    if (!listPluginOrgErasers().includes(OUTREACH_PLUGIN_ID)) {
+        registerPluginOrgEraser(async (request)=>{
+            const { createOutreachOrgEraser, defaultOutreachErasureDeps } = await import("./mailboxes/mailbox-erasure.js");
+            return createOutreachOrgEraser(defaultOutreachErasureDeps())(request);
+        }, {
+            pluginId: OUTREACH_PLUGIN_ID
+        });
+    }
+    if (!listPluginUserErasers().includes(OUTREACH_PLUGIN_ID)) {
+        registerPluginUserEraser(async (request)=>{
+            const { createOutreachUserEraser, defaultOutreachErasureDeps } = await import("./mailboxes/mailbox-erasure.js");
+            return createOutreachUserEraser(defaultOutreachErasureDeps())(request);
+        }, {
+            pluginId: OUTREACH_PLUGIN_ID
+        });
+    }
+    // A person erased from a workspace takes their enrollments with them; the
+    // do-not-contact entry stays, stripped of anything that names them.
+    registerPluginPersonEraser(async (request)=>(await runtime()).platformOutreachPersonEraser()(request), {
+        pluginId: OUTREACH_PLUGIN_ID
+    });
+    // The sending runtime, on the console's fifteen-minute tick.
+    registerPluginConsoleCron({
+        id: OUTREACH_SEND_JOB_ID,
+        label: 'Sequence sends',
+        drives: 'Sends every sequence step that has come due, from the rep’s own connected mailbox, and files each on the contact’s timeline. If it stops, no sequence sends anything and every task step waits.',
+        run: async (context)=>{
+            const [{ runOutreachSendJob }, platform] = await Promise.all([
+                import("./runtime/send-job.js"),
+                runtime()
+            ]);
+            return runOutreachSendJob(platform.platformOutreachRuntimeDeps(), context);
+        }
+    }, {
+        pluginId: OUTREACH_PLUGIN_ID
+    });
+    registerPluginConsoleCron({
+        id: OUTREACH_SYNC_JOB_ID,
+        label: 'Sequence replies and bounces',
+        drives: 'Reads each connected mailbox for replies, out-of-office answers, opt-outs and bounces, and stops or postpones the sequence each one is about. If it stops, a person who replied or asked to be left alone keeps getting follow-ups, and a mailbox that bounces never pauses itself.',
+        run: async (context)=>{
+            const [{ runOutreachSyncJob }, platform] = await Promise.all([
+                import("./runtime/sync-job.js"),
+                runtime()
+            ]);
+            return runOutreachSyncJob(platform.platformOutreachRuntimeDeps(), context);
+        }
+    }, {
+        pluginId: OUTREACH_PLUGIN_ID
+    });
+}
+/** The runtime's platform reach, loaded when a job or an erasure first runs. */ const runtime = ()=>import("./runtime/platform-runtime-deps.js");
+
+//# sourceMappingURL=declarations.console-server.js.map

package/src/lib/declarations.console-server.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../libs/plugins/outreach/src/lib/declarations.console-server.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n// Each registry from its own module, not the `@aglyn/aglyn/server` barrel:\n// boot needs one registry, not the whole server surface.\nimport { registerPluginConsoleCron } from '@aglyn/aglyn/plugin-manager/plugin-console-crons'\nimport {\n  listPluginOrgErasers,\n  registerPluginOrgEraser,\n} from '@aglyn/aglyn/plugin-manager/plugin-org-erasure'\nimport { registerPluginPersonEraser } from '@aglyn/aglyn/plugin-manager/plugin-person-erasure'\nimport {\n  listPluginUserErasers,\n  registerPluginUserEraser,\n} from '@aglyn/aglyn/plugin-manager/plugin-user-erasure'\nimport { OUTREACH_PLUGIN_ID } from './constants/bundle-common'\nimport { OUTREACH_SEND_JOB_ID, OUTREACH_SYNC_JOB_ID } from './constants/runtime-jobs'\n\n/**\n * Outreach's CONSOLE-ONLY server declarations (AGL-2978), named under\n * `consoleServerDeclarations` in `plugins.config.json` and run at the\n * console's boot.\n *\n * The erasers are registered here rather than from `serverDeclarations`,\n * which the tenant runtime also loads: the workspace eraser revokes each\n * rep's Google grant, and the account eraser (AGL-3106) revokes and deletes\n * the person's own, and both open a sealed token with `OUTREACH_TOKEN_KEY`,\n * which only the console holds. The tenant may not so much as bundle the code\n * that does (`outreach-credential-isolation.spec.ts`). Every erasure runs in\n * the console, so this is where the erasers are needed.\n *\n * The sending runtime (AGL-2981) is declared here too, for the same reason:\n * the send and sync jobs open each rep's sealed grant, so they run on the\n * console's `plugin-console-crons` tick and nowhere else, and the person\n * eraser removes the enrollments a workspace kept about someone it erases.\n *\n * Light at boot: every module that does the work is imported when a job, an\n * erasure or a tick first asks for it, so the boot cost is the registration.\n */\nexport function registerOutreachConsoleServerDeclarations(): void {\n  // Idempotent against the REGISTRY, so a reset (a spec) registers again.\n  if (!listPluginOrgErasers().includes(OUTREACH_PLUGIN_ID)) {\n    registerPluginOrgEraser(\n      async (request) => {\n        const { createOutreachOrgEraser, defaultOutreachErasureDeps } = await import(\n          './mailboxes/mailbox-erasure'\n        )\n        return createOutreachOrgEraser(defaultOutreachErasureDeps())(request)\n      },\n      { pluginId: OUTREACH_PLUGIN_ID },\n    )\n  }\n  if (!listPluginUserErasers().includes(OUTREACH_PLUGIN_ID)) {\n    registerPluginUserEraser(\n      async (request) => {\n        const { createOutreachUserEraser, defaultOutreachErasureDeps } = await import(\n          './mailboxes/mailbox-erasure'\n        )\n        return createOutreachUserEraser(defaultOutreachErasureDeps())(request)\n      },\n      { pluginId: OUTREACH_PLUGIN_ID },\n    )\n  }\n  // A person erased from a workspace takes their enrollments with them; the\n  // do-not-contact entry stays, stripped of anything that names them.\n  registerPluginPersonEraser(\n    async (request) => (await runtime()).platformOutreachPersonEraser()(request),\n    { pluginId: OUTREACH_PLUGIN_ID },\n  )\n  // The sending runtime, on the console's fifteen-minute tick.\n  registerPluginConsoleCron(\n    {\n      id: OUTREACH_SEND_JOB_ID,\n      label: 'Sequence sends',\n      drives:\n        'Sends every sequence step that has come due, from the rep’s own connected mailbox, and files each on the contact’s timeline. If it stops, no sequence sends anything and every task step waits.',\n      run: async (context) => {\n        const [{ runOutreachSendJob }, platform] = await Promise.all([import('./runtime/send-job'), runtime()])\n        return runOutreachSendJob(platform.platformOutreachRuntimeDeps(), context)\n      },\n    },\n    { pluginId: OUTREACH_PLUGIN_ID },\n  )\n  registerPluginConsoleCron(\n    {\n      id: OUTREACH_SYNC_JOB_ID,\n      label: 'Sequence replies and bounces',\n      drives:\n        'Reads each connected mailbox for replies, out-of-office answers, opt-outs and bounces, and stops or postpones the sequence each one is about. If it stops, a person who replied or asked to be left alone keeps getting follow-ups, and a mailbox that bounces never pauses itself.',\n      run: async (context) => {\n        const [{ runOutreachSyncJob }, platform] = await Promise.all([import('./runtime/sync-job'), runtime()])\n        return runOutreachSyncJob(platform.platformOutreachRuntimeDeps(), context)\n      },\n    },\n    { pluginId: OUTREACH_PLUGIN_ID },\n  )\n}\n\n/** The runtime's platform reach, loaded when a job or an erasure first runs. */\nconst runtime = () => import('./runtime/platform-runtime-deps')\n"],"names":["registerPluginConsoleCron","listPluginOrgErasers","registerPluginOrgEraser","registerPluginPersonEraser","listPluginUserErasers","registerPluginUserEraser","OUTREACH_PLUGIN_ID","OUTREACH_SEND_JOB_ID","OUTREACH_SYNC_JOB_ID","registerOutreachConsoleServerDeclarations","includes","request","createOutreachOrgEraser","defaultOutreachErasureDeps","pluginId","createOutreachUserEraser","runtime","platformOutreachPersonEraser","id","label","drives","run","context","runOutreachSendJob","platform","Promise","all","platformOutreachRuntimeDeps","runOutreachSyncJob"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,2EAA2E;AAC3E,yDAAyD;AACzD,SAASA,yBAAyB,QAAQ,mDAAkD;AAC5F,SACEC,oBAAoB,EACpBC,uBAAuB,QAClB,iDAAgD;AACvD,SAASC,0BAA0B,QAAQ,oDAAmD;AAC9F,SACEC,qBAAqB,EACrBC,wBAAwB,QACnB,kDAAiD;AACxD,SAASC,kBAAkB,QAAQ,+BAA2B;AAC9D,SAASC,oBAAoB,EAAEC,oBAAoB,QAAQ,8BAA0B;AAErF;;;;;;;;;;;;;;;;;;;;CAoBC,GACD,OAAO,SAASC;IACd,wEAAwE;IACxE,IAAI,CAACR,uBAAuBS,QAAQ,CAACJ,qBAAqB;QACxDJ,wBACE,OAAOS;YACL,MAAM,EAAEC,uBAAuB,EAAEC,0BAA0B,EAAE,GAAG,MAAM,MAAM,CAC1E;YAEF,OAAOD,wBAAwBC,8BAA8BF;QAC/D,GACA;YAAEG,UAAUR;QAAmB;IAEnC;IACA,IAAI,CAACF,wBAAwBM,QAAQ,CAACJ,qBAAqB;QACzDD,yBACE,OAAOM;YACL,MAAM,EAAEI,wBAAwB,EAAEF,0BAA0B,EAAE,GAAG,MAAM,MAAM,CAC3E;YAEF,OAAOE,yBAAyBF,8BAA8BF;QAChE,GACA;YAAEG,UAAUR;QAAmB;IAEnC;IACA,0EAA0E;IAC1E,oEAAoE;IACpEH,2BACE,OAAOQ,UAAY,AAAC,CAAA,MAAMK,SAAQ,EAAGC,4BAA4B,GAAGN,UACpE;QAAEG,UAAUR;IAAmB;IAEjC,6DAA6D;IAC7DN,0BACE;QACEkB,IAAIX;QACJY,OAAO;QACPC,QACE;QACFC,KAAK,OAAOC;YACV,MAAM,CAAC,EAAEC,kBAAkB,EAAE,EAAEC,SAAS,GAAG,MAAMC,QAAQC,GAAG,CAAC;gBAAC,MAAM,CAAC;gBAAuBV;aAAU;YACtG,OAAOO,mBAAmBC,SAASG,2BAA2B,IAAIL;QACpE;IACF,GACA;QAAER,UAAUR;IAAmB;IAEjCN,0BACE;QACEkB,IAAIV;QACJW,OAAO;QACPC,QACE;QACFC,KAAK,OAAOC;YACV,MAAM,CAAC,EAAEM,kBAAkB,EAAE,EAAEJ,SAAS,GAAG,MAAMC,QAAQC,GAAG,CAAC;gBAAC,MAAM,CAAC;gBAAuBV;aAAU;YACtG,OAAOY,mBAAmBJ,SAASG,2BAA2B,IAAIL;QACpE;IACF,GACA;QAAER,UAAUR;IAAmB;AAEnC;AAEA,8EAA8E,GAC9E,MAAMU,UAAU,IAAM,MAAM,CAAC"}

package/src/lib/engine/compose.d.ts

@@ -0,0 +1,86 @@
+/**
+ * @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 CrmMergeContext } from '@aglyn/aglyn/app-utils/crm-email-templates';
+import type { OutreachEnrollment, OutreachOrgSettings, OutreachSequence } from '../model/outreach.types';
+/** The way out every email offers, word for word. */
+export declare const OUTREACH_OPT_OUT_LINE = "Not relevant? Reply \"no\" and I won't email again.";
+/** The sentence that says what the email is. */
+export declare function outreachSolicitationStatement(senderName: string): string;
+/**
+ * The message the transport sends. Header values are single lines already;
+ * the text uses `\n` line breaks, which the transport writes as CRLF.
+ */
+export interface ComposedOutreachEmail {
+    /** The recipient's address, normalized. */
+    to: string;
+    subject: string;
+    /** The plain-text body, footer included. */
+    text: string;
+    /** The provider thread a reply step is sent into. */
+    threadId?: string;
+    /** The `Message-ID` this email answers, angle brackets included. */
+    inReplyTo?: string;
+    /** Every `Message-ID` in the thread so far, oldest first, space-separated. */
+    references?: string;
+    /** The one-click unsubscribe URL, for `List-Unsubscribe` with `List-Unsubscribe-Post`. */
+    listUnsubscribeUrl?: string;
+    /** A `mailto:` URI for `List-Unsubscribe`. */
+    listUnsubscribeMailto?: string;
+}
+export type OutreachComposeErrorCode = 'missing_postal_address' | 'missing_legal_name' | 'not_an_email_step' | 'invalid_recipient' | 'missing_subject' | 'subject_reply_prefix' | 'missing_body' | 'missing_thread' | 'invalid_unsubscribe_url' | 'invalid_unsubscribe_mailto';
+export interface OutreachComposeError {
+    code: OutreachComposeErrorCode;
+    message: string;
+}
+export interface ComposeOutreachEmailInput {
+    sequence: Pick<OutreachSequence, 'steps'>;
+    enrollment: Pick<OutreachEnrollment, 'email' | 'stepIndex' | 'personalLine' | 'threadSubject' | 'messageIds' | 'gmailThreadId'>;
+    orgSettings: Pick<OutreachOrgSettings, 'legalName' | 'brandName' | 'postalAddress'> | null | undefined;
+    /**
+     * What the CRM resolver reads: the contact, the sending site's group id,
+     * the sender (the mailbox's display name and address), the site. Its
+     * `extra` may carry fields of the caller's own; the personal line is added
+     * here.
+     */
+    merge: CrmMergeContext | null | undefined;
+    /** The CRM template's body, read by the caller, when the step names a template. */
+    templateBody?: string | null;
+    /** The signed one-click unsubscribe URL, minted by the runtime. */
+    listUnsubscribeUrl?: string | null;
+    /** An address, or a `mailto:` URI, that unsubscribes whoever writes to it. */
+    listUnsubscribeMailto?: string | null;
+}
+export interface OutreachComposeResult {
+    email: ComposedOutreachEmail | null;
+    error: OutreachComposeError | null;
+    /** Merge fields that rendered empty, unique, in order of appearance. */
+    unresolvedFields: string[];
+}
+/**
+ * The footer every email ends with, or the reason it cannot be written.
+ *
+ * The postal address may be stored over several lines; the footer prints it
+ * on one, the parts separated by commas.
+ */
+export declare function composeOutreachFooter(settings: Pick<OutreachOrgSettings, 'legalName' | 'brandName' | 'postalAddress'> | null | undefined): {
+    footer: string | null;
+    error: OutreachComposeError | null;
+};
+/** A `Message-ID` in its header form — `<id@host>` — or `null` for one that is not. */
+export declare function outreachMessageIdHeader(value: unknown): string | null;
+/** The email one step sends to one person — see the module note. */
+export declare function composeOutreachEmail(input: ComposeOutreachEmailInput): OutreachComposeResult;

package/src/lib/engine/compose.js

@@ -0,0 +1,212 @@
+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.
+ */ /*==========================================
+ * WHAT EXACTLY IS SENT (AGL-2979).
+ *
+ * The composer turns a step, an enrollment and the organization's settings
+ * into the message the transport sends: the recipient, the subject, the
+ * plain text, and the headers that thread it and let the recipient leave.
+ * The transport adds the From line and the MIME; nothing here knows either.
+ *
+ * ## The footer is not optional
+ *
+ * Every email ends with the organization's legal name, its postal address,
+ * a sentence saying the email is a business solicitation, and the way out —
+ * reply "no". Those are what CAN-SPAM requires of a commercial email, and
+ * the composer appends them itself, after the merge, as literal text: no
+ * template can leave them off, and no merge field can rewrite them. With no
+ * postal address or no legal name, it refuses to compose at all.
+ *
+ * ## Threading
+ *
+ * An email after the first is a reply in the thread unless its step says
+ * otherwise: `Re:` and the thread's own subject, `In-Reply-To` the last
+ * message sent into the thread, `References` every one of them, and the
+ * provider thread to send into. A `Re:` on an email that answers nothing is
+ * a deception, so a reply step with no thread to answer is refused rather
+ * than sent with a borrowed one, and a subject that starts with `Re:` or
+ * `Fwd:` on an email that starts a thread is refused too.
+ *
+ * ## Merge fields
+ *
+ * The CRM's own resolver fills them, from the documents the runtime already
+ * read, and the enrollment's personal line joins them as
+ * `{{enrollment.personalLine}}` through the resolver's `extra` fields.
+ * Fields that render empty are returned beside the message, for the
+ * runtime to decide whether "Hi ," is worth sending.
+ *==========================================*/ import { normalizeContactEmail } from "@aglyn/aglyn/app-utils/contacts";
+import { CRM_EMAIL_SUBJECT_MAX } from "@aglyn/aglyn/app-utils/crm";
+import { resolveCrmMergeFields } from "@aglyn/aglyn/app-utils/crm-email-templates";
+import { crmThreadSubject } from "@aglyn/aglyn/app-utils/crm-inbound";
+import { normalizeOutreachPersonalLine } from "./gates.js";
+import { isInThreadEmailStep, OUTREACH_PERSONAL_LINE_FIELD, outreachSubjectHasReplyPrefix } from "./sequence-validation.js";
+/** The way out every email offers, word for word. */ export const OUTREACH_OPT_OUT_LINE = 'Not relevant? Reply "no" and I won\'t email again.';
+/** The sentence that says what the email is. */ export function outreachSolicitationStatement(senderName) {
+    return `This is a business solicitation from ${senderName}.`;
+}
+const oneLine = (value)=>typeof value === 'string' ? value.replace(/\s+/g, ' ').trim() : '';
+/**
+ * The footer every email ends with, or the reason it cannot be written.
+ *
+ * The postal address may be stored over several lines; the footer prints it
+ * on one, the parts separated by commas.
+ */ export function composeOutreachFooter(settings) {
+    var _ref;
+    const postalAddress = String((_ref = settings == null ? void 0 : settings.postalAddress) != null ? _ref : '').split(/\r\n|\r|\n/).map((line)=>oneLine(line).replace(/,+$/, '')).filter(Boolean).join(', ');
+    if (!postalAddress) {
+        return {
+            footer: null,
+            error: {
+                code: 'missing_postal_address',
+                message: "This email can't be sent without your organization's postal address. Add it in Sequences settings."
+            }
+        };
+    }
+    const legalName = oneLine(settings == null ? void 0 : settings.legalName);
+    if (!legalName) {
+        return {
+            footer: null,
+            error: {
+                code: 'missing_legal_name',
+                message: "This email can't be sent without your organization's legal name. Add it in Sequences settings."
+            }
+        };
+    }
+    const senderName = oneLine(settings == null ? void 0 : settings.brandName) || legalName;
+    return {
+        footer: `${legalName} · ${postalAddress}\n${outreachSolicitationStatement(senderName)} ${OUTREACH_OPT_OUT_LINE}`,
+        error: null
+    };
+}
+/** A `Message-ID` in its header form — `<id@host>` — or `null` for one that is not. */ export function outreachMessageIdHeader(value) {
+    const bare = String(value != null ? value : '').trim().replace(/^<+/, '').replace(/>+$/, '');
+    if (!bare || /[\s<>]/.test(bare)) return null;
+    return `<${bare}>`;
+}
+function unsubscribeUrl(value) {
+    const raw = String(value != null ? value : '').trim();
+    if (!raw) return undefined;
+    if (/[\r\n]/.test(raw)) return null;
+    try {
+        const url = new URL(raw);
+        return url.protocol === 'https:' ? url.href : null;
+    } catch (unused) {
+        return null;
+    }
+}
+function unsubscribeMailto(value) {
+    const raw = String(value != null ? value : '').trim();
+    if (!raw) return undefined;
+    if (/[\r\n]/.test(raw)) return null;
+    if (!/^mailto:/i.test(raw)) {
+        const address = normalizeContactEmail(raw);
+        return address ? `mailto:${address}?subject=unsubscribe` : null;
+    }
+    let target = raw.slice('mailto:'.length).split('?')[0];
+    try {
+        target = decodeURIComponent(target);
+    } catch (unused) {
+        return null;
+    }
+    return normalizeContactEmail(target) ? raw : null;
+}
+const refuse = (code, message)=>({
+        email: null,
+        error: {
+            code,
+            message
+        },
+        unresolvedFields: []
+    });
+/** The email one step sends to one person — see the module note. */ export function composeOutreachEmail(input) {
+    var _ref, _input_merge, _ref1, _input_templateBody, _step_body;
+    var _input_sequence, _input_enrollment, _input_merge1;
+    const { footer, error } = composeOutreachFooter(input.orgSettings);
+    if (error) return {
+        email: null,
+        error,
+        unresolvedFields: []
+    };
+    const steps = (_ref = (_input_sequence = input.sequence) == null ? void 0 : _input_sequence.steps) != null ? _ref : [];
+    const stepIndex = (_input_enrollment = input.enrollment) == null ? void 0 : _input_enrollment.stepIndex;
+    const step = steps[stepIndex];
+    if ((step == null ? void 0 : step.kind) !== 'email') {
+        return refuse('not_an_email_step', 'The step this enrollment is on does not send an email.');
+    }
+    const to = normalizeContactEmail(input.enrollment.email);
+    if (!to) {
+        return refuse('invalid_recipient', "This enrollment's address isn't a valid email address.");
+    }
+    const context = _extends({}, (_input_merge = input.merge) != null ? _input_merge : {}, {
+        extra: _extends({}, (_ref1 = (_input_merge1 = input.merge) == null ? void 0 : _input_merge1.extra) != null ? _ref1 : {}, {
+            [OUTREACH_PERSONAL_LINE_FIELD]: normalizeOutreachPersonalLine(input.enrollment.personalLine)
+        })
+    });
+    const unresolved = [];
+    const render = (text)=>{
+        const result = resolveCrmMergeFields(text, context);
+        for (const key of result.unresolved)if (!unresolved.includes(key)) unresolved.push(key);
+        return result.text;
+    };
+    const email = {
+        to,
+        subject: '',
+        text: ''
+    };
+    if (isInThreadEmailStep(steps, stepIndex)) {
+        var _input_enrollment_messageIds, _input_enrollment_gmailThreadId;
+        const threadSubject = crmThreadSubject(input.enrollment.threadSubject);
+        const messageIds = ((_input_enrollment_messageIds = input.enrollment.messageIds) != null ? _input_enrollment_messageIds : []).map(outreachMessageIdHeader).filter((id)=>id !== null);
+        const threadId = String((_input_enrollment_gmailThreadId = input.enrollment.gmailThreadId) != null ? _input_enrollment_gmailThreadId : '').trim();
+        if (!threadSubject || !messageIds.length || !threadId) {
+            return refuse('missing_thread', 'This email replies in the thread, and no earlier email in the thread was sent.');
+        }
+        email.subject = `Re: ${threadSubject}`.slice(0, CRM_EMAIL_SUBJECT_MAX);
+        email.threadId = threadId;
+        email.inReplyTo = messageIds[messageIds.length - 1];
+        email.references = messageIds.join(' ');
+    } else {
+        var _step_subject;
+        const subject = oneLine(render(String((_step_subject = step.subject) != null ? _step_subject : '')));
+        if (!subject) return refuse('missing_subject', 'This email has no subject.');
+        if (outreachSubjectHasReplyPrefix(subject)) {
+            return refuse('subject_reply_prefix', 'This email starts a thread, so its subject may not begin with "Re:" or "Fwd:".');
+        }
+        email.subject = subject.slice(0, CRM_EMAIL_SUBJECT_MAX);
+    }
+    const source = step.templateId ? String((_input_templateBody = input.templateBody) != null ? _input_templateBody : '') : String((_step_body = step.body) != null ? _step_body : '');
+    const body = render(source).replace(/\r\n?/g, '\n').split('\n').map((line)=>line.replace(/[ \t]+$/, '')).join('\n').replace(/^\n+|\n+$/g, '');
+    if (!body.trim()) return refuse('missing_body', 'This email has no body.');
+    email.text = `${body}\n\n${footer}`;
+    const url = unsubscribeUrl(input.listUnsubscribeUrl);
+    if (url === null) {
+        return refuse('invalid_unsubscribe_url', 'The unsubscribe link must be an https URL.');
+    }
+    if (url) email.listUnsubscribeUrl = url;
+    const mailto = unsubscribeMailto(input.listUnsubscribeMailto);
+    if (mailto === null) {
+        return refuse('invalid_unsubscribe_mailto', 'The unsubscribe address is not an email address.');
+    }
+    if (mailto) email.listUnsubscribeMailto = mailto;
+    return {
+        email,
+        error: null,
+        unresolvedFields: unresolved
+    };
+}
+
+//# sourceMappingURL=compose.js.map

package/src/lib/engine/compose.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/outreach/src/lib/engine/compose.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n/*==========================================\n * WHAT EXACTLY IS SENT (AGL-2979).\n *\n * The composer turns a step, an enrollment and the organization's settings\n * into the message the transport sends: the recipient, the subject, the\n * plain text, and the headers that thread it and let the recipient leave.\n * The transport adds the From line and the MIME; nothing here knows either.\n *\n * ## The footer is not optional\n *\n * Every email ends with the organization's legal name, its postal address,\n * a sentence saying the email is a business solicitation, and the way out —\n * reply \"no\". Those are what CAN-SPAM requires of a commercial email, and\n * the composer appends them itself, after the merge, as literal text: no\n * template can leave them off, and no merge field can rewrite them. With no\n * postal address or no legal name, it refuses to compose at all.\n *\n * ## Threading\n *\n * An email after the first is a reply in the thread unless its step says\n * otherwise: `Re:` and the thread's own subject, `In-Reply-To` the last\n * message sent into the thread, `References` every one of them, and the\n * provider thread to send into. A `Re:` on an email that answers nothing is\n * a deception, so a reply step with no thread to answer is refused rather\n * than sent with a borrowed one, and a subject that starts with `Re:` or\n * `Fwd:` on an email that starts a thread is refused too.\n *\n * ## Merge fields\n *\n * The CRM's own resolver fills them, from the documents the runtime already\n * read, and the enrollment's personal line joins them as\n * `{{enrollment.personalLine}}` through the resolver's `extra` fields.\n * Fields that render empty are returned beside the message, for the\n * runtime to decide whether \"Hi ,\" is worth sending.\n *==========================================*/\n\nimport { normalizeContactEmail } from '@aglyn/aglyn/app-utils/contacts'\nimport { CRM_EMAIL_SUBJECT_MAX } from '@aglyn/aglyn/app-utils/crm'\nimport {\n  type CrmMergeContext,\n  resolveCrmMergeFields,\n} from '@aglyn/aglyn/app-utils/crm-email-templates'\nimport { crmThreadSubject } from '@aglyn/aglyn/app-utils/crm-inbound'\nimport type {\n  OutreachEnrollment,\n  OutreachOrgSettings,\n  OutreachSequence,\n} from '../model/outreach.types'\nimport { normalizeOutreachPersonalLine } from './gates'\nimport {\n  isInThreadEmailStep,\n  OUTREACH_PERSONAL_LINE_FIELD,\n  outreachSubjectHasReplyPrefix,\n} from './sequence-validation'\n\n/** The way out every email offers, word for word. */\nexport const OUTREACH_OPT_OUT_LINE = 'Not relevant? Reply \"no\" and I won\\'t email again.'\n\n/** The sentence that says what the email is. */\nexport function outreachSolicitationStatement(senderName: string): string {\n  return `This is a business solicitation from ${senderName}.`\n}\n\n/**\n * The message the transport sends. Header values are single lines already;\n * the text uses `\\n` line breaks, which the transport writes as CRLF.\n */\nexport interface ComposedOutreachEmail {\n  /** The recipient's address, normalized. */\n  to: string\n  subject: string\n  /** The plain-text body, footer included. */\n  text: string\n  /** The provider thread a reply step is sent into. */\n  threadId?: string\n  /** The `Message-ID` this email answers, angle brackets included. */\n  inReplyTo?: string\n  /** Every `Message-ID` in the thread so far, oldest first, space-separated. */\n  references?: string\n  /** The one-click unsubscribe URL, for `List-Unsubscribe` with `List-Unsubscribe-Post`. */\n  listUnsubscribeUrl?: string\n  /** A `mailto:` URI for `List-Unsubscribe`. */\n  listUnsubscribeMailto?: string\n}\n\nexport type OutreachComposeErrorCode =\n  | 'missing_postal_address'\n  | 'missing_legal_name'\n  | 'not_an_email_step'\n  | 'invalid_recipient'\n  | 'missing_subject'\n  | 'subject_reply_prefix'\n  | 'missing_body'\n  | 'missing_thread'\n  | 'invalid_unsubscribe_url'\n  | 'invalid_unsubscribe_mailto'\n\nexport interface OutreachComposeError {\n  code: OutreachComposeErrorCode\n  message: string\n}\n\nexport interface ComposeOutreachEmailInput {\n  sequence: Pick<OutreachSequence, 'steps'>\n  enrollment: Pick<\n    OutreachEnrollment,\n    'email' | 'stepIndex' | 'personalLine' | 'threadSubject' | 'messageIds' | 'gmailThreadId'\n  >\n  orgSettings: Pick<OutreachOrgSettings, 'legalName' | 'brandName' | 'postalAddress'> | null | undefined\n  /**\n   * What the CRM resolver reads: the contact, the sending site's group id,\n   * the sender (the mailbox's display name and address), the site. Its\n   * `extra` may carry fields of the caller's own; the personal line is added\n   * here.\n   */\n  merge: CrmMergeContext | null | undefined\n  /** The CRM template's body, read by the caller, when the step names a template. */\n  templateBody?: string | null\n  /** The signed one-click unsubscribe URL, minted by the runtime. */\n  listUnsubscribeUrl?: string | null\n  /** An address, or a `mailto:` URI, that unsubscribes whoever writes to it. */\n  listUnsubscribeMailto?: string | null\n}\n\nexport interface OutreachComposeResult {\n  email: ComposedOutreachEmail | null\n  error: OutreachComposeError | null\n  /** Merge fields that rendered empty, unique, in order of appearance. */\n  unresolvedFields: string[]\n}\n\nconst oneLine = (value: unknown): string =>\n  typeof value === 'string' ? value.replace(/\\s+/g, ' ').trim() : ''\n\n/**\n * The footer every email ends with, or the reason it cannot be written.\n *\n * The postal address may be stored over several lines; the footer prints it\n * on one, the parts separated by commas.\n */\nexport function composeOutreachFooter(\n  settings: Pick<OutreachOrgSettings, 'legalName' | 'brandName' | 'postalAddress'> | null | undefined,\n): { footer: string | null; error: OutreachComposeError | null } {\n  const postalAddress = String(settings?.postalAddress ?? '')\n    .split(/\\r\\n|\\r|\\n/)\n    .map((line) => oneLine(line).replace(/,+$/, ''))\n    .filter(Boolean)\n    .join(', ')\n  if (!postalAddress) {\n    return {\n      footer: null,\n      error: {\n        code: 'missing_postal_address',\n        message:\n          \"This email can't be sent without your organization's postal address. Add it in Sequences settings.\",\n      },\n    }\n  }\n  const legalName = oneLine(settings?.legalName)\n  if (!legalName) {\n    return {\n      footer: null,\n      error: {\n        code: 'missing_legal_name',\n        message:\n          \"This email can't be sent without your organization's legal name. Add it in Sequences settings.\",\n      },\n    }\n  }\n  const senderName = oneLine(settings?.brandName) || legalName\n  return {\n    footer: `${legalName} · ${postalAddress}\\n${outreachSolicitationStatement(senderName)} ${OUTREACH_OPT_OUT_LINE}`,\n    error: null,\n  }\n}\n\n/** A `Message-ID` in its header form — `<id@host>` — or `null` for one that is not. */\nexport function outreachMessageIdHeader(value: unknown): string | null {\n  const bare = String(value ?? '').trim().replace(/^<+/, '').replace(/>+$/, '')\n  if (!bare || /[\\s<>]/.test(bare)) return null\n  return `<${bare}>`\n}\n\nfunction unsubscribeUrl(value: unknown): string | null | undefined {\n  const raw = String(value ?? '').trim()\n  if (!raw) return undefined\n  if (/[\\r\\n]/.test(raw)) return null\n  try {\n    const url = new URL(raw)\n    return url.protocol === 'https:' ? url.href : null\n  } catch {\n    return null\n  }\n}\n\nfunction unsubscribeMailto(value: unknown): string | null | undefined {\n  const raw = String(value ?? '').trim()\n  if (!raw) return undefined\n  if (/[\\r\\n]/.test(raw)) return null\n  if (!/^mailto:/i.test(raw)) {\n    const address = normalizeContactEmail(raw)\n    return address ? `mailto:${address}?subject=unsubscribe` : null\n  }\n  let target = raw.slice('mailto:'.length).split('?')[0]\n  try {\n    target = decodeURIComponent(target)\n  } catch {\n    return null\n  }\n  return normalizeContactEmail(target) ? raw : null\n}\n\nconst refuse = (\n  code: OutreachComposeErrorCode,\n  message: string,\n): OutreachComposeResult => ({ email: null, error: { code, message }, unresolvedFields: [] })\n\n/** The email one step sends to one person — see the module note. */\nexport function composeOutreachEmail(input: ComposeOutreachEmailInput): OutreachComposeResult {\n  const { footer, error } = composeOutreachFooter(input.orgSettings)\n  if (error) return { email: null, error, unresolvedFields: [] }\n\n  const steps = input.sequence?.steps ?? []\n  const stepIndex = input.enrollment?.stepIndex\n  const step = steps[stepIndex]\n  if (step?.kind !== 'email') {\n    return refuse('not_an_email_step', 'The step this enrollment is on does not send an email.')\n  }\n  const to = normalizeContactEmail(input.enrollment.email)\n  if (!to) {\n    return refuse('invalid_recipient', \"This enrollment's address isn't a valid email address.\")\n  }\n\n  const context: CrmMergeContext = {\n    ...(input.merge ?? {}),\n    extra: {\n      ...(input.merge?.extra ?? {}),\n      [OUTREACH_PERSONAL_LINE_FIELD]: normalizeOutreachPersonalLine(input.enrollment.personalLine),\n    },\n  }\n  const unresolved: string[] = []\n  const render = (text: string): string => {\n    const result = resolveCrmMergeFields(text, context)\n    for (const key of result.unresolved) if (!unresolved.includes(key)) unresolved.push(key)\n    return result.text\n  }\n\n  const email: ComposedOutreachEmail = { to, subject: '', text: '' }\n  if (isInThreadEmailStep(steps, stepIndex)) {\n    const threadSubject = crmThreadSubject(input.enrollment.threadSubject)\n    const messageIds = (input.enrollment.messageIds ?? [])\n      .map(outreachMessageIdHeader)\n      .filter((id): id is string => id !== null)\n    const threadId = String(input.enrollment.gmailThreadId ?? '').trim()\n    if (!threadSubject || !messageIds.length || !threadId) {\n      return refuse(\n        'missing_thread',\n        'This email replies in the thread, and no earlier email in the thread was sent.',\n      )\n    }\n    email.subject = `Re: ${threadSubject}`.slice(0, CRM_EMAIL_SUBJECT_MAX)\n    email.threadId = threadId\n    email.inReplyTo = messageIds[messageIds.length - 1]\n    email.references = messageIds.join(' ')\n  } else {\n    const subject = oneLine(render(String(step.subject ?? '')))\n    if (!subject) return refuse('missing_subject', 'This email has no subject.')\n    if (outreachSubjectHasReplyPrefix(subject)) {\n      return refuse(\n        'subject_reply_prefix',\n        'This email starts a thread, so its subject may not begin with \"Re:\" or \"Fwd:\".',\n      )\n    }\n    email.subject = subject.slice(0, CRM_EMAIL_SUBJECT_MAX)\n  }\n\n  const source = step.templateId ? String(input.templateBody ?? '') : String(step.body ?? '')\n  const body = render(source)\n    .replace(/\\r\\n?/g, '\\n')\n    .split('\\n')\n    .map((line) => line.replace(/[ \\t]+$/, ''))\n    .join('\\n')\n    .replace(/^\\n+|\\n+$/g, '')\n  if (!body.trim()) return refuse('missing_body', 'This email has no body.')\n  email.text = `${body}\\n\\n${footer}`\n\n  const url = unsubscribeUrl(input.listUnsubscribeUrl)\n  if (url === null) {\n    return refuse('invalid_unsubscribe_url', 'The unsubscribe link must be an https URL.')\n  }\n  if (url) email.listUnsubscribeUrl = url\n  const mailto = unsubscribeMailto(input.listUnsubscribeMailto)\n  if (mailto === null) {\n    return refuse('invalid_unsubscribe_mailto', 'The unsubscribe address is not an email address.')\n  }\n  if (mailto) email.listUnsubscribeMailto = mailto\n\n  return { email, error: null, unresolvedFields: unresolved }\n}\n"],"names":["normalizeContactEmail","CRM_EMAIL_SUBJECT_MAX","resolveCrmMergeFields","crmThreadSubject","normalizeOutreachPersonalLine","isInThreadEmailStep","OUTREACH_PERSONAL_LINE_FIELD","outreachSubjectHasReplyPrefix","OUTREACH_OPT_OUT_LINE","outreachSolicitationStatement","senderName","oneLine","value","replace","trim","composeOutreachFooter","settings","postalAddress","String","split","map","line","filter","Boolean","join","footer","error","code","message","legalName","brandName","outreachMessageIdHeader","bare","test","unsubscribeUrl","raw","undefined","url","URL","protocol","href","unsubscribeMailto","address","target","slice","length","decodeURIComponent","refuse","email","unresolvedFields","composeOutreachEmail","input","step","orgSettings","steps","sequence","stepIndex","enrollment","kind","to","context","merge","extra","personalLine","unresolved","render","text","result","key","includes","push","subject","threadSubject","messageIds","id","threadId","gmailThreadId","inReplyTo","references","source","templateId","templateBody","body","listUnsubscribeUrl","mailto","listUnsubscribeMailto"],"mappings":"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"}

package/src/lib/engine/delivery-status.d.ts

@@ -0,0 +1,53 @@
+/**
+ * @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 OutreachThreadMessage } from './thread-message';
+export type OutreachBounceKind = 'hard' | 'soft';
+/** What a delivery report says about one recipient. */
+export interface OutreachDeliveryRecipient {
+    /** `Final-Recipient`, or `Original-Recipient` when that is all there is; normalized. */
+    address: string | null;
+    /** `Action`, lowercased: `failed`, `delayed`, `delivered`, `relayed`, `expanded`. */
+    action: string | null;
+    /** `Status`: the enhanced code, `5.1.1`. */
+    status: string | null;
+    /** `Diagnostic-Code`, without its type prefix. */
+    diagnostic: string | null;
+    /** `hard`, `soft`, or `null` for a block that reports no failure. */
+    kind: OutreachBounceKind | null;
+}
+export interface OutreachDeliveryReport {
+    /** The worst failure the report carries, or `null` when it reports none. */
+    kind: OutreachBounceKind | null;
+    /** Every recipient the report names, in order. */
+    recipients: OutreachDeliveryRecipient[];
+    /**
+     * The addresses `kind` is about, normalized — `X-Failed-Recipients` when no
+     * block names one. Empty when nothing says which recipient failed.
+     */
+    failedAddresses: string[];
+    /** The status code of the worst failure, when one was found. */
+    status: string | null;
+    /** The diagnostic of the worst failure, when one was given. */
+    diagnostic: string | null;
+}
+/** Whether a message comes from a mail system rather than from a person. */
+export declare function isMailerDaemonMessage(message: Pick<OutreachThreadMessage, 'from'>): boolean;
+/**
+ * What a delivery report says, or `null` when the message is not one — see
+ * the module note for how a standard report and a prose bounce are read.
+ */
+export declare function readOutreachDeliveryReport(message: OutreachThreadMessage): OutreachDeliveryReport | null;