@aglyn/shared-util-email 1.0.0-beta.290 → 1.0.0-beta.292

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aglyn/shared-util-email",
-  "version": "1.0.0-beta.290",
+  "version": "1.0.0-beta.292",
   "license": "Apache-2.0",
   "homepage": "https://aglyn.com",
   "repository": {
@@ -25,8 +25,8 @@
     "./package.json": "./package.json"
   },
   "dependencies": {
-    "@aglyn/shared-data-enums": "1.0.0-beta.290",
-    "@aglyn/shared-util-http": "1.0.0-beta.290",
+    "@aglyn/shared-data-enums": "1.0.0-beta.292",
+    "@aglyn/shared-util-http": "1.0.0-beta.292",
     "@msgpack/msgpack": "^3.1.3",
     "@swc/helpers": "0.5.23"
   },

package/src/index.d.ts

@@ -39,6 +39,7 @@ export * from './lib/host-email-render';
 export * from './lib/email-render';
 export * from './lib/text-email-html';
 export * from './lib/marketing-send';
+export * from './lib/email-thread';
 export * from './lib/list-unsubscribe';
 export * from './lib/email-delivery-events';
 export * from './lib/received-email';

package/src/index.js

@@ -43,6 +43,9 @@ export * from "./lib/host-email-render.js";
 export * from "./lib/email-render.js";
 export * from "./lib/text-email-html.js";
 export * from "./lib/marketing-send.js";
+// One conversation in the recipient's mailbox (AGL-4097): Message-ID,
+// In-Reply-To and References for a record's later messages. Pure.
+export * from "./lib/email-thread.js";
 // The List-Unsubscribe setting sequences and campaigns share (AGL-3307).
 export * from "./lib/list-unsubscribe.js";
 export * from "./lib/email-delivery-events.js";

package/src/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../libs/shared/util/email/src/index.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\nexport * from './lib/send-email'\n// Who carries the mail (AGL-3080): the provider contract, and the selection\n// of the deployment's provider from the built-ins and any a plugin\n// registered. The providers themselves are imported by their own paths —\n// `@aglyn/shared-util-email/mail-provider-resend`, `…/mail-provider-webhook`\n// — because nothing outside the seam should name one.\nexport * from './lib/mail-provider'\nexport * from './lib/mail-providers'\nexport * from './lib/send-rate'\nexport * from './lib/sender-reputation'\nexport * from './lib/send-ceilings'\nexport * from './lib/sending-domain'\nexport * from './lib/tracking-host'\nexport * from './lib/sending-mailbox'\nexport * from './lib/host-sender'\nexport * from './lib/platform-sending-domain'\nexport * from './lib/email-health'\nexport * from './lib/system-email-catalog'\nexport * from './lib/retention-emails'\nexport * from './lib/site-care-emails'\nexport * from './lib/site-care-project-emails'\nexport * from './lib/domain-emails'\nexport * from './lib/pos-hardware-emails'\nexport * from './lib/pos-cellular-emails'\nexport * from './lib/welcome-email'\nexport * from './lib/tenant-email-catalog'\nexport * from './lib/host-email-render'\nexport * from './lib/email-render'\nexport * from './lib/text-email-html'\nexport * from './lib/marketing-send'\n// The List-Unsubscribe setting sequences and campaigns share (AGL-3307).\nexport * from './lib/list-unsubscribe'\nexport * from './lib/email-delivery-events'\n// Received mail in the platform's vocabulary, which the CRM's capture route\n// files from (AGL-2657); the provider reads it.\n// Its neighbor `./lib/svix-signature` is deliberately NOT re-exported here:\n// it holds a `crypto` HMAC, and this barrel is reached from the browser\n// through `@aglyn/shared-ui-email-campaigns`, so a webhook imports it by its\n// own path — `@aglyn/shared-util-email/svix-signature`.\nexport * from './lib/received-email'\nexport * from './lib/email-revenue-window'\n// Exported so the console drift guard can pin it against @aglyn/aglyn.\nexport * from './lib/email-media-src'\n// Same arrangement, same reason (AGL-1223): a copy of `decodeStoredNodes`\n// this scope:shared lib may not import, pinned by `email-nodes-drift.spec.ts`.\nexport * from './lib/stored-email-nodes'\nexport * from './lib/email-merge'\n// The deliverability engine every send path asks (AGL-3328): the gateway an\n// MX names and its ledger, the bounce reader, and the address verdicts. Pure\n// — the DNS lookup and the store are injected by `@aglyn/tenant-data-admin`,\n// so nothing here reaches `node:dns` from the browser.\nexport * from './lib/mail-gateway'\nexport * from './lib/mail-bounce'\nexport * from './lib/email-deliverability'\n// The sender's side of the same engine (AGL-3328): SPF, DKIM and DMARC for\n// the domain mail leaves from, and whether they align. Pure as well; the\n// lookups are `@aglyn/tenant-data-admin`'s.\nexport * from './lib/sender-readiness'\n// The outbound phishing screen a young workspace's campaigns and automated\n// email pass (AGL-3356). Pure; the hold it leads to is `tenant-data-admin`'s.\nexport * from './lib/outbound-phishing-screen'\n// The send seam's gate for that screen — the store a hold writes is injected\n// by `@aglyn/tenant-data-admin`, like the governor's.\nexport * from './lib/outbound-screen-gate'\n// The same screen read over a published page (AGL-3356): lookalike links and\n// embeds, author-defined credential fields, a brand's call to action.\nexport * from './lib/hosted-page-screen'\n// The reputation lookup every foreign link a page, an email or a redirect\n// points at passes (AGL-3451). Pure; the lookup is injected by\n// `@aglyn/tenant-data-admin`, which holds the credential and the cache.\nexport * from './lib/link-reputation'\n// The site's theme palette as plain data (AGL-3370), so a palette token an\n// author picked resolves in mail. Built without MUI; `shared-ui-theme`'s\n// parity spec holds it equal to the theme.\nexport * from './lib/email-palette'\nexport * from './lib/email-design-chrome'\n"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,cAAc,sBAAkB;AAChC,4EAA4E;AAC5E,mEAAmE;AACnE,yEAAyE;AACzE,6EAA6E;AAC7E,sDAAsD;AACtD,cAAc,yBAAqB;AACnC,cAAc,0BAAsB;AACpC,cAAc,qBAAiB;AAC/B,cAAc,6BAAyB;AACvC,cAAc,yBAAqB;AACnC,cAAc,0BAAsB;AACpC,cAAc,yBAAqB;AACnC,cAAc,2BAAuB;AACrC,cAAc,uBAAmB;AACjC,cAAc,mCAA+B;AAC7C,cAAc,wBAAoB;AAClC,cAAc,gCAA4B;AAC1C,cAAc,4BAAwB;AACtC,cAAc,4BAAwB;AACtC,cAAc,oCAAgC;AAC9C,cAAc,yBAAqB;AACnC,cAAc,+BAA2B;AACzC,cAAc,+BAA2B;AACzC,cAAc,yBAAqB;AACnC,cAAc,gCAA4B;AAC1C,cAAc,6BAAyB;AACvC,cAAc,wBAAoB;AAClC,cAAc,2BAAuB;AACrC,cAAc,0BAAsB;AACpC,yEAAyE;AACzE,cAAc,4BAAwB;AACtC,cAAc,iCAA6B;AAC3C,4EAA4E;AAC5E,gDAAgD;AAChD,4EAA4E;AAC5E,wEAAwE;AACxE,6EAA6E;AAC7E,wDAAwD;AACxD,cAAc,0BAAsB;AACpC,cAAc,gCAA4B;AAC1C,uEAAuE;AACvE,cAAc,2BAAuB;AACrC,0EAA0E;AAC1E,+EAA+E;AAC/E,cAAc,8BAA0B;AACxC,cAAc,uBAAmB;AACjC,4EAA4E;AAC5E,6EAA6E;AAC7E,6EAA6E;AAC7E,uDAAuD;AACvD,cAAc,wBAAoB;AAClC,cAAc,uBAAmB;AACjC,cAAc,gCAA4B;AAC1C,2EAA2E;AAC3E,yEAAyE;AACzE,4CAA4C;AAC5C,cAAc,4BAAwB;AACtC,2EAA2E;AAC3E,8EAA8E;AAC9E,cAAc,oCAAgC;AAC9C,6EAA6E;AAC7E,sDAAsD;AACtD,cAAc,gCAA4B;AAC1C,6EAA6E;AAC7E,sEAAsE;AACtE,cAAc,8BAA0B;AACxC,0EAA0E;AAC1E,+DAA+D;AAC/D,wEAAwE;AACxE,cAAc,2BAAuB;AACrC,2EAA2E;AAC3E,yEAAyE;AACzE,2CAA2C;AAC3C,cAAc,yBAAqB;AACnC,cAAc,+BAA2B"}
+{"version":3,"sources":["../../../../../../libs/shared/util/email/src/index.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\nexport * from './lib/send-email'\n// Who carries the mail (AGL-3080): the provider contract, and the selection\n// of the deployment's provider from the built-ins and any a plugin\n// registered. The providers themselves are imported by their own paths —\n// `@aglyn/shared-util-email/mail-provider-resend`, `…/mail-provider-webhook`\n// — because nothing outside the seam should name one.\nexport * from './lib/mail-provider'\nexport * from './lib/mail-providers'\nexport * from './lib/send-rate'\nexport * from './lib/sender-reputation'\nexport * from './lib/send-ceilings'\nexport * from './lib/sending-domain'\nexport * from './lib/tracking-host'\nexport * from './lib/sending-mailbox'\nexport * from './lib/host-sender'\nexport * from './lib/platform-sending-domain'\nexport * from './lib/email-health'\nexport * from './lib/system-email-catalog'\nexport * from './lib/retention-emails'\nexport * from './lib/site-care-emails'\nexport * from './lib/site-care-project-emails'\nexport * from './lib/domain-emails'\nexport * from './lib/pos-hardware-emails'\nexport * from './lib/pos-cellular-emails'\nexport * from './lib/welcome-email'\nexport * from './lib/tenant-email-catalog'\nexport * from './lib/host-email-render'\nexport * from './lib/email-render'\nexport * from './lib/text-email-html'\nexport * from './lib/marketing-send'\n// One conversation in the recipient's mailbox (AGL-4097): Message-ID,\n// In-Reply-To and References for a record's later messages. Pure.\nexport * from './lib/email-thread'\n// The List-Unsubscribe setting sequences and campaigns share (AGL-3307).\nexport * from './lib/list-unsubscribe'\nexport * from './lib/email-delivery-events'\n// Received mail in the platform's vocabulary, which the CRM's capture route\n// files from (AGL-2657); the provider reads it.\n// Its neighbor `./lib/svix-signature` is deliberately NOT re-exported here:\n// it holds a `crypto` HMAC, and this barrel is reached from the browser\n// through `@aglyn/shared-ui-email-campaigns`, so a webhook imports it by its\n// own path — `@aglyn/shared-util-email/svix-signature`.\nexport * from './lib/received-email'\nexport * from './lib/email-revenue-window'\n// Exported so the console drift guard can pin it against @aglyn/aglyn.\nexport * from './lib/email-media-src'\n// Same arrangement, same reason (AGL-1223): a copy of `decodeStoredNodes`\n// this scope:shared lib may not import, pinned by `email-nodes-drift.spec.ts`.\nexport * from './lib/stored-email-nodes'\nexport * from './lib/email-merge'\n// The deliverability engine every send path asks (AGL-3328): the gateway an\n// MX names and its ledger, the bounce reader, and the address verdicts. Pure\n// — the DNS lookup and the store are injected by `@aglyn/tenant-data-admin`,\n// so nothing here reaches `node:dns` from the browser.\nexport * from './lib/mail-gateway'\nexport * from './lib/mail-bounce'\nexport * from './lib/email-deliverability'\n// The sender's side of the same engine (AGL-3328): SPF, DKIM and DMARC for\n// the domain mail leaves from, and whether they align. Pure as well; the\n// lookups are `@aglyn/tenant-data-admin`'s.\nexport * from './lib/sender-readiness'\n// The outbound phishing screen a young workspace's campaigns and automated\n// email pass (AGL-3356). Pure; the hold it leads to is `tenant-data-admin`'s.\nexport * from './lib/outbound-phishing-screen'\n// The send seam's gate for that screen — the store a hold writes is injected\n// by `@aglyn/tenant-data-admin`, like the governor's.\nexport * from './lib/outbound-screen-gate'\n// The same screen read over a published page (AGL-3356): lookalike links and\n// embeds, author-defined credential fields, a brand's call to action.\nexport * from './lib/hosted-page-screen'\n// The reputation lookup every foreign link a page, an email or a redirect\n// points at passes (AGL-3451). Pure; the lookup is injected by\n// `@aglyn/tenant-data-admin`, which holds the credential and the cache.\nexport * from './lib/link-reputation'\n// The site's theme palette as plain data (AGL-3370), so a palette token an\n// author picked resolves in mail. Built without MUI; `shared-ui-theme`'s\n// parity spec holds it equal to the theme.\nexport * from './lib/email-palette'\nexport * from './lib/email-design-chrome'\n"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,cAAc,sBAAkB;AAChC,4EAA4E;AAC5E,mEAAmE;AACnE,yEAAyE;AACzE,6EAA6E;AAC7E,sDAAsD;AACtD,cAAc,yBAAqB;AACnC,cAAc,0BAAsB;AACpC,cAAc,qBAAiB;AAC/B,cAAc,6BAAyB;AACvC,cAAc,yBAAqB;AACnC,cAAc,0BAAsB;AACpC,cAAc,yBAAqB;AACnC,cAAc,2BAAuB;AACrC,cAAc,uBAAmB;AACjC,cAAc,mCAA+B;AAC7C,cAAc,wBAAoB;AAClC,cAAc,gCAA4B;AAC1C,cAAc,4BAAwB;AACtC,cAAc,4BAAwB;AACtC,cAAc,oCAAgC;AAC9C,cAAc,yBAAqB;AACnC,cAAc,+BAA2B;AACzC,cAAc,+BAA2B;AACzC,cAAc,yBAAqB;AACnC,cAAc,gCAA4B;AAC1C,cAAc,6BAAyB;AACvC,cAAc,wBAAoB;AAClC,cAAc,2BAAuB;AACrC,cAAc,0BAAsB;AACpC,sEAAsE;AACtE,kEAAkE;AAClE,cAAc,wBAAoB;AAClC,yEAAyE;AACzE,cAAc,4BAAwB;AACtC,cAAc,iCAA6B;AAC3C,4EAA4E;AAC5E,gDAAgD;AAChD,4EAA4E;AAC5E,wEAAwE;AACxE,6EAA6E;AAC7E,wDAAwD;AACxD,cAAc,0BAAsB;AACpC,cAAc,gCAA4B;AAC1C,uEAAuE;AACvE,cAAc,2BAAuB;AACrC,0EAA0E;AAC1E,+EAA+E;AAC/E,cAAc,8BAA0B;AACxC,cAAc,uBAAmB;AACjC,4EAA4E;AAC5E,6EAA6E;AAC7E,6EAA6E;AAC7E,uDAAuD;AACvD,cAAc,wBAAoB;AAClC,cAAc,uBAAmB;AACjC,cAAc,gCAA4B;AAC1C,2EAA2E;AAC3E,yEAAyE;AACzE,4CAA4C;AAC5C,cAAc,4BAAwB;AACtC,2EAA2E;AAC3E,8EAA8E;AAC9E,cAAc,oCAAgC;AAC9C,6EAA6E;AAC7E,sDAAsD;AACtD,cAAc,gCAA4B;AAC1C,6EAA6E;AAC7E,sEAAsE;AACtE,cAAc,8BAA0B;AACxC,0EAA0E;AAC1E,+DAA+D;AAC/D,wEAAwE;AACxE,cAAc,2BAAuB;AACrC,2EAA2E;AAC3E,yEAAyE;AACzE,2CAA2C;AAC3C,cAAc,yBAAqB;AACnC,cAAc,+BAA2B"}

package/src/lib/email-thread.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.
+ */
+/** A conversation as the record it is about keeps it. */
+export interface EmailThread {
+    /** The latest message's `Message-ID`, angle brackets included: `<a.b@example.com>`. */
+    messageId: string;
+    /**
+     * The conversation's root ({@link emailThreadRootId}; a thread stored
+     * before roots has none), then every message's `Message-ID`, oldest first;
+     * the last is {@link messageId}.
+     */
+    references: string[];
+    /** The subject the conversation runs under, without any `Re:`. */
+    subject: string;
+}
+/**
+ * The most ids a `References` header carries. RFC 5322 sets no limit, but
+ * some servers refuse very long header lines; the first id (the conversation's
+ * root) and the latest ones are what threading reads, so the middle goes.
+ */
+export declare const EMAIL_THREAD_MAX_REFERENCES = 20;
+/** Whether `value` is one well-formed `Message-ID`, brackets included. */
+export declare function isEmailMessageId(value: unknown): value is string;
+/**
+ * A fresh `Message-ID` on the first usable domain of `domains` (the sending
+ * domain first; an address such as a `From` value gives its domain):
+ * `<label.k3x9m1.9f2c4e1a0b7d3e65@mail.acme.com>`. The time and 64 random bits
+ * keep it unique; nothing in it identifies the customer or the record.
+ * Falls back to `localhost.localdomain` only when no domain is usable, which
+ * a send on a resolved identity never meets.
+ */
+export declare function mintEmailMessageId(domains: ReadonlyArray<string | null | undefined>, options?: {
+    label?: string;
+    atMs?: number;
+    random?: string;
+}): string;
+/**
+ * The root a conversation started by the message `messageId` runs under:
+ * `<thread.quote.k3x9m1.9f2c4e1a0b7d3e65@mail.acme.com>` for
+ * `<quote.k3x9m1.9f2c4e1a0b7d3e65@mail.acme.com>`. Derived, so the headers
+ * the first message goes out with and the thread kept after it agree without
+ * either being handed the other; distinct from every id a message carries,
+ * so a provider that replaces `Message-ID` cannot replace it. Null when
+ * `messageId` is not a `Message-ID`, or the root would be too long for one.
+ */
+export declare function emailThreadRootId(messageId: string): string | null;
+/**
+ * A stored thread, checked, or null. Every id must be a well-formed
+ * `Message-ID`, because each is written back into a header: a value that
+ * could carry a line break never reaches one.
+ */
+export declare function readEmailThread(raw: unknown): EmailThread | null;
+/** The subject a message in `thread` goes under: the thread's, else `fallback`. */
+export declare function emailThreadSubject(thread: EmailThread | null | undefined, fallback: string): string;
+/**
+ * The headers that send a message with `Message-ID` `messageId` into
+ * `thread`: the id itself, and, when the thread has begun, `In-Reply-To` the
+ * latest message and `References` the root and the chain. With no thread, the
+ * message starts one: its own id, and the root it starts
+ * ({@link emailThreadRootId}) in `References`.
+ */
+export declare function nextThreadHeaders(thread: EmailThread | null | undefined, messageId: string): Record<string, string>;
+/**
+ * The thread once a message went out in it: the message is the latest, the
+ * chain grows by it, and the subject stays the thread's. A message that
+ * started the thread gives it its root (the one {@link nextThreadHeaders}
+ * sent it with) ahead of its own id, and its subject.
+ */
+export declare function emailThreadAfterSend(thread: EmailThread | null | undefined, sent: {
+    messageId: string;
+    subject: string;
+}): EmailThread;

package/src/lib/email-thread.js

@@ -0,0 +1,187 @@
+/**
+ * @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.
+ */ /*==========================================
+ * ONE CONVERSATION IN THE CUSTOMER'S MAILBOX (AGL-4097).
+ *
+ * A site that writes to one customer about one thing more than once (a
+ * request's confirmation, the quote, a revised quote, the invoice) keeps those
+ * messages in a single conversation by sending each one as a reply to the one
+ * before, all of them under one ROOT:
+ *
+ *   - the first message carries a `Message-ID` minted here and, in
+ *     `References`, the conversation's root: an id derived from that one
+ *     (`<thread.…@…>`, {@link emailThreadRootId}) which no message carries as
+ *     its own. The record it is about keeps both as an {@link EmailThread},
+ *     the root first;
+ *   - every later message carries its own `Message-ID`, `In-Reply-To` naming
+ *     the last one, and `References` naming the root and the chain, and keeps
+ *     the thread's subject ({@link nextThreadHeaders}, {@link emailThreadAfterSend}).
+ *
+ * Why a root no message carries: a provider may replace the `Message-ID` a
+ * caller hands it, and in production one does. The ids a later message then
+ * replies to name no message the mailbox ever received, and on those alone
+ * the first message splits off into a conversation of its own. What every
+ * message still shares is the root in `References`: clients that thread by
+ * those headers group the messages under it as a missing parent, and clients
+ * that group on a shared reference (with the subject) group them by it. When
+ * a provider does keep the caller's id, the chain links them directly too.
+ *
+ * How clients group (what is documented or widely reported, not measured
+ * here): Apple Mail and Thunderbird thread by `In-Reply-To`/`References`;
+ * Gmail groups by subject together with those headers; Outlook groups by
+ * subject (its conversation topic) and its own `Thread-Index`, which only
+ * Outlook writes. Keeping the subject the same is what every one of them
+ * honors, which is why the thread remembers it.
+ *
+ * The sender records the provider's own id beside the one minted here, so a
+ * replaced one can be traced.
+ *
+ * A thread stored before roots were added has none: its later messages keep
+ * sharing its first message's id in `References`, as they always did, and
+ * nothing is migrated.
+ *
+ * Pure, and free of Node built-ins: this barrel is reached from the browser.
+ *=========================================*/ /** A conversation as the record it is about keeps it. */ /**
+ * The most ids a `References` header carries. RFC 5322 sets no limit, but
+ * some servers refuse very long header lines; the first id (the conversation's
+ * root) and the latest ones are what threading reads, so the middle goes.
+ */ export const EMAIL_THREAD_MAX_REFERENCES = 20;
+/** The longest subject kept on a thread. */ const MAX_SUBJECT = 300;
+/** `dot-atom-text` on each side of the `@`, as RFC 5322 §3.6.4 allows a `msg-id`. */ const MESSAGE_ID = /^<[A-Za-z0-9!#$%&'*+/=?^_`{|}~-]+(?:\.[A-Za-z0-9!#$%&'*+/=?^_`{|}~-]+)*@[A-Za-z0-9-]+(?:\.[A-Za-z0-9-]+)+>$/;
+/** A host name a `Message-ID` may end in. */ const DOMAIN = /^(?=.{1,253}$)[A-Za-z0-9](?:[A-Za-z0-9-]{0,61}[A-Za-z0-9])?(?:\.[A-Za-z0-9](?:[A-Za-z0-9-]{0,61}[A-Za-z0-9])?)+$/;
+/** Whether `value` is one well-formed `Message-ID`, brackets included. */ export function isEmailMessageId(value) {
+    return typeof value === 'string' && value.length <= 250 && MESSAGE_ID.test(value);
+}
+/** A domain as a `Message-ID` can carry it, or null. */ function messageIdDomain(value) {
+    const raw = String(value != null ? value : '').trim().toLowerCase();
+    // A `From` value ("Acme <hello@acme.com>") gives its address's domain.
+    const domain = raw.includes('@') ? raw.slice(raw.lastIndexOf('@') + 1).replace(/>.*$/, '') : raw;
+    return DOMAIN.test(domain) ? domain : null;
+}
+/** Sixteen random hex characters, from the platform's crypto. */ function randomHex() {
+    const bytes = new Uint8Array(8);
+    globalThis.crypto.getRandomValues(bytes);
+    return Array.from(bytes, (byte)=>byte.toString(16).padStart(2, '0')).join('');
+}
+/**
+ * A fresh `Message-ID` on the first usable domain of `domains` (the sending
+ * domain first; an address such as a `From` value gives its domain):
+ * `<label.k3x9m1.9f2c4e1a0b7d3e65@mail.acme.com>`. The time and 64 random bits
+ * keep it unique; nothing in it identifies the customer or the record.
+ * Falls back to `localhost.localdomain` only when no domain is usable, which
+ * a send on a resolved identity never meets.
+ */ export function mintEmailMessageId(domains, options = {}) {
+    var _domains_map_find, _options_label, _options_atMs, _options_random;
+    const domain = (_domains_map_find = domains.map(messageIdDomain).find(Boolean)) != null ? _domains_map_find : 'localhost.localdomain';
+    const label = String((_options_label = options.label) != null ? _options_label : 'm').toLowerCase().replace(/[^a-z0-9-]+/g, '-').replace(/^-+|-+$/g, '') || 'm';
+    const time = Math.max(0, Math.floor(Number((_options_atMs = options.atMs) != null ? _options_atMs : Date.now()) || 0)).toString(36);
+    const random = String((_options_random = options.random) != null ? _options_random : randomHex()).toLowerCase().replace(/[^a-z0-9]+/g, '') || randomHex();
+    return `<${label}.${time}.${random}@${domain}>`;
+}
+/**
+ * The root a conversation started by the message `messageId` runs under:
+ * `<thread.quote.k3x9m1.9f2c4e1a0b7d3e65@mail.acme.com>` for
+ * `<quote.k3x9m1.9f2c4e1a0b7d3e65@mail.acme.com>`. Derived, so the headers
+ * the first message goes out with and the thread kept after it agree without
+ * either being handed the other; distinct from every id a message carries,
+ * so a provider that replaces `Message-ID` cannot replace it. Null when
+ * `messageId` is not a `Message-ID`, or the root would be too long for one.
+ */ export function emailThreadRootId(messageId) {
+    if (!isEmailMessageId(messageId)) return null;
+    const root = `<thread.${messageId.slice(1)}`;
+    return isEmailMessageId(root) ? root : null;
+}
+/** The root and the latest ids, at most {@link EMAIL_THREAD_MAX_REFERENCES}. */ function capReferences(ids) {
+    const unique = ids.filter((id, index)=>ids.indexOf(id) === index);
+    if (unique.length <= EMAIL_THREAD_MAX_REFERENCES) return unique;
+    return [
+        unique[0],
+        ...unique.slice(unique.length - (EMAIL_THREAD_MAX_REFERENCES - 1))
+    ];
+}
+/**
+ * A stored thread, checked, or null. Every id must be a well-formed
+ * `Message-ID`, because each is written back into a header: a value that
+ * could carry a line break never reaches one.
+ */ export function readEmailThread(raw) {
+    var _source_subject;
+    if (!raw || typeof raw !== 'object') return null;
+    const source = raw;
+    const messageId = source['messageId'];
+    if (!isEmailMessageId(messageId)) return null;
+    const listed = Array.isArray(source['references']) ? source['references'].filter(isEmailMessageId) : [];
+    const references = capReferences([
+        ...listed.filter((id)=>id !== messageId),
+        messageId
+    ]);
+    const subject = String((_source_subject = source['subject']) != null ? _source_subject : '').replace(/[\r\n]+/g, ' ').trim().slice(0, MAX_SUBJECT);
+    return {
+        messageId,
+        references,
+        subject
+    };
+}
+/** The subject a message in `thread` goes under: the thread's, else `fallback`. */ export function emailThreadSubject(thread, fallback) {
+    var _readEmailThread;
+    const own = (_readEmailThread = readEmailThread(thread)) == null ? void 0 : _readEmailThread.subject;
+    return own || String(fallback != null ? fallback : '').replace(/[\r\n]+/g, ' ').trim();
+}
+/**
+ * The headers that send a message with `Message-ID` `messageId` into
+ * `thread`: the id itself, and, when the thread has begun, `In-Reply-To` the
+ * latest message and `References` the root and the chain. With no thread, the
+ * message starts one: its own id, and the root it starts
+ * ({@link emailThreadRootId}) in `References`.
+ */ export function nextThreadHeaders(thread, messageId) {
+    if (!isEmailMessageId(messageId)) throw new Error('nextThreadHeaders: not a Message-ID');
+    const current = readEmailThread(thread);
+    if (!current) {
+        const root = emailThreadRootId(messageId);
+        return root ? {
+            'Message-ID': messageId,
+            References: root
+        } : {
+            'Message-ID': messageId
+        };
+    }
+    return {
+        'Message-ID': messageId,
+        'In-Reply-To': current.messageId,
+        References: capReferences(current.references).join(' ')
+    };
+}
+/**
+ * The thread once a message went out in it: the message is the latest, the
+ * chain grows by it, and the subject stays the thread's. A message that
+ * started the thread gives it its root (the one {@link nextThreadHeaders}
+ * sent it with) ahead of its own id, and its subject.
+ */ export function emailThreadAfterSend(thread, sent) {
+    if (!isEmailMessageId(sent.messageId)) throw new Error('emailThreadAfterSend: not a Message-ID');
+    const current = readEmailThread(thread);
+    const before = current ? current.references : [
+        emailThreadRootId(sent.messageId)
+    ].filter(isEmailMessageId);
+    return {
+        messageId: sent.messageId,
+        references: capReferences([
+            ...before,
+            sent.messageId
+        ]),
+        subject: emailThreadSubject(current, sent.subject).slice(0, MAX_SUBJECT)
+    };
+}
+
+//# sourceMappingURL=email-thread.js.map

package/src/lib/email-thread.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/shared/util/email/src/lib/email-thread.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 * ONE CONVERSATION IN THE CUSTOMER'S MAILBOX (AGL-4097).\n *\n * A site that writes to one customer about one thing more than once (a\n * request's confirmation, the quote, a revised quote, the invoice) keeps those\n * messages in a single conversation by sending each one as a reply to the one\n * before, all of them under one ROOT:\n *\n *   - the first message carries a `Message-ID` minted here and, in\n *     `References`, the conversation's root: an id derived from that one\n *     (`<thread.…@…>`, {@link emailThreadRootId}) which no message carries as\n *     its own. The record it is about keeps both as an {@link EmailThread},\n *     the root first;\n *   - every later message carries its own `Message-ID`, `In-Reply-To` naming\n *     the last one, and `References` naming the root and the chain, and keeps\n *     the thread's subject ({@link nextThreadHeaders}, {@link emailThreadAfterSend}).\n *\n * Why a root no message carries: a provider may replace the `Message-ID` a\n * caller hands it, and in production one does. The ids a later message then\n * replies to name no message the mailbox ever received, and on those alone\n * the first message splits off into a conversation of its own. What every\n * message still shares is the root in `References`: clients that thread by\n * those headers group the messages under it as a missing parent, and clients\n * that group on a shared reference (with the subject) group them by it. When\n * a provider does keep the caller's id, the chain links them directly too.\n *\n * How clients group (what is documented or widely reported, not measured\n * here): Apple Mail and Thunderbird thread by `In-Reply-To`/`References`;\n * Gmail groups by subject together with those headers; Outlook groups by\n * subject (its conversation topic) and its own `Thread-Index`, which only\n * Outlook writes. Keeping the subject the same is what every one of them\n * honors, which is why the thread remembers it.\n *\n * The sender records the provider's own id beside the one minted here, so a\n * replaced one can be traced.\n *\n * A thread stored before roots were added has none: its later messages keep\n * sharing its first message's id in `References`, as they always did, and\n * nothing is migrated.\n *\n * Pure, and free of Node built-ins: this barrel is reached from the browser.\n *=========================================*/\n\n/** A conversation as the record it is about keeps it. */\nexport interface EmailThread {\n  /** The latest message's `Message-ID`, angle brackets included: `<a.b@example.com>`. */\n  messageId: string\n  /**\n   * The conversation's root ({@link emailThreadRootId}; a thread stored\n   * before roots has none), then every message's `Message-ID`, oldest first;\n   * the last is {@link messageId}.\n   */\n  references: string[]\n  /** The subject the conversation runs under, without any `Re:`. */\n  subject: string\n}\n\n/**\n * The most ids a `References` header carries. RFC 5322 sets no limit, but\n * some servers refuse very long header lines; the first id (the conversation's\n * root) and the latest ones are what threading reads, so the middle goes.\n */\nexport const EMAIL_THREAD_MAX_REFERENCES = 20\n\n/** The longest subject kept on a thread. */\nconst MAX_SUBJECT = 300\n\n/** `dot-atom-text` on each side of the `@`, as RFC 5322 §3.6.4 allows a `msg-id`. */\nconst MESSAGE_ID = /^<[A-Za-z0-9!#$%&'*+/=?^_`{|}~-]+(?:\\.[A-Za-z0-9!#$%&'*+/=?^_`{|}~-]+)*@[A-Za-z0-9-]+(?:\\.[A-Za-z0-9-]+)+>$/\n\n/** A host name a `Message-ID` may end in. */\nconst DOMAIN = /^(?=.{1,253}$)[A-Za-z0-9](?:[A-Za-z0-9-]{0,61}[A-Za-z0-9])?(?:\\.[A-Za-z0-9](?:[A-Za-z0-9-]{0,61}[A-Za-z0-9])?)+$/\n\n/** Whether `value` is one well-formed `Message-ID`, brackets included. */\nexport function isEmailMessageId(value: unknown): value is string {\n  return typeof value === 'string' && value.length <= 250 && MESSAGE_ID.test(value)\n}\n\n/** A domain as a `Message-ID` can carry it, or null. */\nfunction messageIdDomain(value: string | null | undefined): string | null {\n  const raw = String(value ?? '').trim().toLowerCase()\n  // A `From` value (\"Acme <hello@acme.com>\") gives its address's domain.\n  const domain = raw.includes('@') ? raw.slice(raw.lastIndexOf('@') + 1).replace(/>.*$/, '') : raw\n  return DOMAIN.test(domain) ? domain : null\n}\n\n/** Sixteen random hex characters, from the platform's crypto. */\nfunction randomHex(): string {\n  const bytes = new Uint8Array(8)\n  globalThis.crypto.getRandomValues(bytes)\n  return Array.from(bytes, (byte) => byte.toString(16).padStart(2, '0')).join('')\n}\n\n/**\n * A fresh `Message-ID` on the first usable domain of `domains` (the sending\n * domain first; an address such as a `From` value gives its domain):\n * `<label.k3x9m1.9f2c4e1a0b7d3e65@mail.acme.com>`. The time and 64 random bits\n * keep it unique; nothing in it identifies the customer or the record.\n * Falls back to `localhost.localdomain` only when no domain is usable, which\n * a send on a resolved identity never meets.\n */\nexport function mintEmailMessageId(\n  domains: ReadonlyArray<string | null | undefined>,\n  options: { label?: string; atMs?: number; random?: string } = {},\n): string {\n  const domain = domains.map(messageIdDomain).find(Boolean) ?? 'localhost.localdomain'\n  const label = String(options.label ?? 'm').toLowerCase().replace(/[^a-z0-9-]+/g, '-').replace(/^-+|-+$/g, '') || 'm'\n  const time = Math.max(0, Math.floor(Number(options.atMs ?? Date.now()) || 0)).toString(36)\n  const random = String(options.random ?? randomHex()).toLowerCase().replace(/[^a-z0-9]+/g, '') || randomHex()\n  return `<${label}.${time}.${random}@${domain}>`\n}\n\n/**\n * The root a conversation started by the message `messageId` runs under:\n * `<thread.quote.k3x9m1.9f2c4e1a0b7d3e65@mail.acme.com>` for\n * `<quote.k3x9m1.9f2c4e1a0b7d3e65@mail.acme.com>`. Derived, so the headers\n * the first message goes out with and the thread kept after it agree without\n * either being handed the other; distinct from every id a message carries,\n * so a provider that replaces `Message-ID` cannot replace it. Null when\n * `messageId` is not a `Message-ID`, or the root would be too long for one.\n */\nexport function emailThreadRootId(messageId: string): string | null {\n  if (!isEmailMessageId(messageId)) return null\n  const root = `<thread.${messageId.slice(1)}`\n  return isEmailMessageId(root) ? root : null\n}\n\n/** The root and the latest ids, at most {@link EMAIL_THREAD_MAX_REFERENCES}. */\nfunction capReferences(ids: readonly string[]): string[] {\n  const unique = ids.filter((id, index) => ids.indexOf(id) === index)\n  if (unique.length <= EMAIL_THREAD_MAX_REFERENCES) return unique\n  return [unique[0], ...unique.slice(unique.length - (EMAIL_THREAD_MAX_REFERENCES - 1))]\n}\n\n/**\n * A stored thread, checked, or null. Every id must be a well-formed\n * `Message-ID`, because each is written back into a header: a value that\n * could carry a line break never reaches one.\n */\nexport function readEmailThread(raw: unknown): EmailThread | null {\n  if (!raw || typeof raw !== 'object') return null\n  const source = raw as Record<string, unknown>\n  const messageId = source['messageId']\n  if (!isEmailMessageId(messageId)) return null\n  const listed = Array.isArray(source['references']) ? (source['references'] as unknown[]).filter(isEmailMessageId) : []\n  const references = capReferences([...listed.filter((id) => id !== messageId), messageId])\n  const subject = String(source['subject'] ?? '').replace(/[\\r\\n]+/g, ' ').trim().slice(0, MAX_SUBJECT)\n  return { messageId, references, subject }\n}\n\n/** The subject a message in `thread` goes under: the thread's, else `fallback`. */\nexport function emailThreadSubject(thread: EmailThread | null | undefined, fallback: string): string {\n  const own = readEmailThread(thread)?.subject\n  return own || String(fallback ?? '').replace(/[\\r\\n]+/g, ' ').trim()\n}\n\n/**\n * The headers that send a message with `Message-ID` `messageId` into\n * `thread`: the id itself, and, when the thread has begun, `In-Reply-To` the\n * latest message and `References` the root and the chain. With no thread, the\n * message starts one: its own id, and the root it starts\n * ({@link emailThreadRootId}) in `References`.\n */\nexport function nextThreadHeaders(\n  thread: EmailThread | null | undefined,\n  messageId: string,\n): Record<string, string> {\n  if (!isEmailMessageId(messageId)) throw new Error('nextThreadHeaders: not a Message-ID')\n  const current = readEmailThread(thread)\n  if (!current) {\n    const root = emailThreadRootId(messageId)\n    return root ? { 'Message-ID': messageId, References: root } : { 'Message-ID': messageId }\n  }\n  return {\n    'Message-ID': messageId,\n    'In-Reply-To': current.messageId,\n    References: capReferences(current.references).join(' '),\n  }\n}\n\n/**\n * The thread once a message went out in it: the message is the latest, the\n * chain grows by it, and the subject stays the thread's. A message that\n * started the thread gives it its root (the one {@link nextThreadHeaders}\n * sent it with) ahead of its own id, and its subject.\n */\nexport function emailThreadAfterSend(\n  thread: EmailThread | null | undefined,\n  sent: { messageId: string; subject: string },\n): EmailThread {\n  if (!isEmailMessageId(sent.messageId)) throw new Error('emailThreadAfterSend: not a Message-ID')\n  const current = readEmailThread(thread)\n  const before = current ? current.references : [emailThreadRootId(sent.messageId)].filter(isEmailMessageId)\n  return {\n    messageId: sent.messageId,\n    references: capReferences([...before, sent.messageId]),\n    subject: emailThreadSubject(current, sent.subject).slice(0, MAX_SUBJECT),\n  }\n}\n"],"names":["EMAIL_THREAD_MAX_REFERENCES","MAX_SUBJECT","MESSAGE_ID","DOMAIN","isEmailMessageId","value","length","test","messageIdDomain","raw","String","trim","toLowerCase","domain","includes","slice","lastIndexOf","replace","randomHex","bytes","Uint8Array","globalThis","crypto","getRandomValues","Array","from","byte","toString","padStart","join","mintEmailMessageId","domains","options","map","find","Boolean","label","time","Math","max","floor","Number","atMs","Date","now","random","emailThreadRootId","messageId","root","capReferences","ids","unique","filter","id","index","indexOf","readEmailThread","source","listed","isArray","references","subject","emailThreadSubject","thread","fallback","own","nextThreadHeaders","Error","current","References","emailThreadAfterSend","sent","before"],"mappings":"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"}