@aglyn/aglyn 1.0.0-beta.219 → 1.0.0-beta.221

package/src/lib/app-utils/crm-booking.js

@@ -1,133 +0,0 @@
-/**
- * @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.
- */ /**
- * THE BOOKING DOOR BETWEEN THE CRM AND BOOKINGS (AGL-2660) — the pure half.
- *
- * A rep drops a booking link into an email from a record; the visitor books
- * through it; the booking comes back to the record as a meeting on its
- * timeline and, when the service asks for one, a follow-up task. The two
- * plugins never import each other's server code, so everything both sides
- * must agree on — the query key the link carries, the shape of the record
- * reference inside it, the wording of the meeting and the task, the day the
- * task falls due — lives here, in the library both already read.
- */ import { isValidTimeZone, zonedDateTime } from "@aglyn/shared-util-timestamp/zoned-time";
-/**
- * The query key a booking link carries the record on: `?crm=contact:abc`.
- *
- * The reference rides the LINK rather than relying on the booker's address
- * because the two routinely differ — a rep emails somebody's work address
- * and they book with a personal one — and a booking that could only be
- * matched by address would then land on nobody. The widget copies the value
- * onto the booking request, the booking row keeps it as `crmRef`, and the
- * server files the meeting under the record it names.
- */ export const CRM_BOOKING_REF_PARAM = 'crm';
-/**
- * The query key that preselects a service in the booking widget:
- * `?service={serviceId}`. The widget lists every active service and this
- * opens it on the one the link was about.
- */ export const BOOKING_SERVICE_PARAM = 'service';
-/** The three records a booking link can be dropped from. */ export const CRM_BOOKING_REF_KINDS = [
-    'contact',
-    'lead',
-    'deal'
-];
-/**
- * What a record id may look like inside the reference. A contact's and a
- * deal's ids are Firestore-minted; a lead's is a person key (hex). Nothing
- * legitimate carries a slash or a space, and a value that does is not a
- * reference the server should go looking for.
- */ const REF_ID_PATTERN = /^[A-Za-z0-9_-]{1,128}$/;
-/** `contact:abc` — the wire form of a reference. */ export function formatCrmBookingRef(ref) {
-    return `${ref.kind}:${ref.id}`;
-}
-/**
- * The reference a query value names, or `null` for anything that is not one.
- *
- * Strict on purpose: the value arrives on a public, unauthenticated booking
- * request, so an unknown kind or a malformed id is dropped rather than
- * stored — a booking still lands, it simply matches by address instead.
- */ export function parseCrmBookingRef(raw) {
-    if (typeof raw !== 'string') return null;
-    const separator = raw.indexOf(':');
-    if (separator <= 0) return null;
-    const kind = raw.slice(0, separator);
-    const id = raw.slice(separator + 1);
-    if (!CRM_BOOKING_REF_KINDS.includes(kind)) return null;
-    if (!REF_ID_PATTERN.test(id)) return null;
-    return {
-        kind: kind,
-        id
-    };
-}
-/** The slot, as the meeting entry and the task print it. */ function formatSlot(startsAtMs, timezone) {
-    try {
-        return new Intl.DateTimeFormat('en-US', {
-            timeZone: timezone,
-            dateStyle: 'full',
-            timeStyle: 'short'
-        }).format(new Date(startsAtMs));
-    } catch (unused) {
-        // An unknown zone name on the service falls back to UTC rather than
-        // failing the write: a meeting filed with a slightly wrong clock is
-        // better than no meeting at all.
-        return new Intl.DateTimeFormat('en-US', {
-            timeZone: 'UTC',
-            dateStyle: 'full',
-            timeStyle: 'short'
-        }).format(new Date(startsAtMs));
-    }
-}
-/**
- * What the meeting entry on the timeline says — the service and the slot,
- * in the service's own timezone, with the zone named so a rep in another
- * one is not misled. The body, not the subject: `subject` is the field a
- * sent email carries, and the timeline draws it as one.
- */ export function crmBookingMeetingBody(input) {
-    var _input_serviceName;
-    const timezone = input.timezone || 'UTC';
-    const service = String((_input_serviceName = input.serviceName) != null ? _input_serviceName : '').trim() || 'Booking';
-    return `${service} — ${formatSlot(input.startsAtMs, timezone)} (${timezone})`;
-}
-/** The title of the task a service files when it asks for a follow-up. */ export function crmBookingFollowUpTitle(serviceName) {
-    const service = String(serviceName != null ? serviceName : '').trim() || 'the booking';
-    return `Follow up after ${service}`;
-}
-const DAY_MS = 24 * 60 * 60 * 1000;
-/**
- * Weekday (0 = Sunday … 6 = Saturday) of an instant in a timezone, read in
- * UTC when the zone name is one `Intl` does not know — for the reason
- * `formatSlot` gives.
- */ function weekdayIn(atMs, timezone) {
-    return zonedDateTime(atMs, isValidTimeZone(timezone) ? timezone : 'UTC').weekday;
-}
-/**
- * When the follow-up falls due: ONE BUSINESS DAY after the slot, at the
- * slot's own clock time.
- *
- * A meeting on a Friday is followed up on Monday, one on a Saturday or a
- * Sunday on Monday too; any other day is followed up the next. Whole days
- * are added to the instant rather than a calendar walked, so the arithmetic
- * cannot land on a clock time that does not exist across a DST change —
- * the task is due "about this time tomorrow", and an hour either way is not
- * a fact the task keeps.
- */ export function crmBookingFollowUpDueMs(endsAtMs, timezone) {
-    const weekday = weekdayIn(endsAtMs, timezone || 'UTC');
-    // Friday (5) skips the weekend; Saturday (6) reaches Monday in two days.
-    const daysAhead = weekday === 5 ? 3 : weekday === 6 ? 2 : 1;
-    return endsAtMs + daysAhead * DAY_MS;
-}
-
-//# sourceMappingURL=crm-booking.js.map

package/src/lib/app-utils/crm-booking.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../../../../../libs/aglyn/src/lib/app-utils/crm-booking.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 * THE BOOKING DOOR BETWEEN THE CRM AND BOOKINGS (AGL-2660) — the pure half.\n *\n * A rep drops a booking link into an email from a record; the visitor books\n * through it; the booking comes back to the record as a meeting on its\n * timeline and, when the service asks for one, a follow-up task. The two\n * plugins never import each other's server code, so everything both sides\n * must agree on — the query key the link carries, the shape of the record\n * reference inside it, the wording of the meeting and the task, the day the\n * task falls due — lives here, in the library both already read.\n */\n\nimport {\n  isValidTimeZone,\n  zonedDateTime,\n} from '@aglyn/shared-util-timestamp/zoned-time'\n\n/**\n * The query key a booking link carries the record on: `?crm=contact:abc`.\n *\n * The reference rides the LINK rather than relying on the booker's address\n * because the two routinely differ — a rep emails somebody's work address\n * and they book with a personal one — and a booking that could only be\n * matched by address would then land on nobody. The widget copies the value\n * onto the booking request, the booking row keeps it as `crmRef`, and the\n * server files the meeting under the record it names.\n */\nexport const CRM_BOOKING_REF_PARAM = 'crm'\n\n/**\n * The query key that preselects a service in the booking widget:\n * `?service={serviceId}`. The widget lists every active service and this\n * opens it on the one the link was about.\n */\nexport const BOOKING_SERVICE_PARAM = 'service'\n\n/** The three records a booking link can be dropped from. */\nexport const CRM_BOOKING_REF_KINDS = ['contact', 'lead', 'deal'] as const\n\nexport type CrmBookingRefKind = (typeof CRM_BOOKING_REF_KINDS)[number]\n\nexport interface CrmBookingRef {\n  kind: CrmBookingRefKind\n  id: string\n}\n\n/**\n * What a record id may look like inside the reference. A contact's and a\n * deal's ids are Firestore-minted; a lead's is a person key (hex). Nothing\n * legitimate carries a slash or a space, and a value that does is not a\n * reference the server should go looking for.\n */\nconst REF_ID_PATTERN = /^[A-Za-z0-9_-]{1,128}$/\n\n/** `contact:abc` — the wire form of a reference. */\nexport function formatCrmBookingRef(ref: CrmBookingRef): string {\n  return `${ref.kind}:${ref.id}`\n}\n\n/**\n * The reference a query value names, or `null` for anything that is not one.\n *\n * Strict on purpose: the value arrives on a public, unauthenticated booking\n * request, so an unknown kind or a malformed id is dropped rather than\n * stored — a booking still lands, it simply matches by address instead.\n */\nexport function parseCrmBookingRef(raw: unknown): CrmBookingRef | null {\n  if (typeof raw !== 'string') return null\n  const separator = raw.indexOf(':')\n  if (separator <= 0) return null\n  const kind = raw.slice(0, separator)\n  const id = raw.slice(separator + 1)\n  if (!(CRM_BOOKING_REF_KINDS as readonly string[]).includes(kind)) return null\n  if (!REF_ID_PATTERN.test(id)) return null\n  return { kind: kind as CrmBookingRefKind, id }\n}\n\n/** The slot, as the meeting entry and the task print it. */\nfunction formatSlot(startsAtMs: number, timezone: string): string {\n  try {\n    return new Intl.DateTimeFormat('en-US', {\n      timeZone: timezone,\n      dateStyle: 'full',\n      timeStyle: 'short',\n    }).format(new Date(startsAtMs))\n  } catch {\n    // An unknown zone name on the service falls back to UTC rather than\n    // failing the write: a meeting filed with a slightly wrong clock is\n    // better than no meeting at all.\n    return new Intl.DateTimeFormat('en-US', {\n      timeZone: 'UTC',\n      dateStyle: 'full',\n      timeStyle: 'short',\n    }).format(new Date(startsAtMs))\n  }\n}\n\n/**\n * What the meeting entry on the timeline says — the service and the slot,\n * in the service's own timezone, with the zone named so a rep in another\n * one is not misled. The body, not the subject: `subject` is the field a\n * sent email carries, and the timeline draws it as one.\n */\nexport function crmBookingMeetingBody(input: {\n  serviceName: string\n  startsAtMs: number\n  timezone?: string | null\n}): string {\n  const timezone = input.timezone || 'UTC'\n  const service = String(input.serviceName ?? '').trim() || 'Booking'\n  return `${service} — ${formatSlot(input.startsAtMs, timezone)} (${timezone})`\n}\n\n/** The title of the task a service files when it asks for a follow-up. */\nexport function crmBookingFollowUpTitle(serviceName: string): string {\n  const service = String(serviceName ?? '').trim() || 'the booking'\n  return `Follow up after ${service}`\n}\n\nconst DAY_MS = 24 * 60 * 60 * 1000\n\n/**\n * Weekday (0 = Sunday … 6 = Saturday) of an instant in a timezone, read in\n * UTC when the zone name is one `Intl` does not know — for the reason\n * `formatSlot` gives.\n */\nfunction weekdayIn(atMs: number, timezone: string): number {\n  return zonedDateTime(atMs, isValidTimeZone(timezone) ? timezone : 'UTC').weekday\n}\n\n/**\n * When the follow-up falls due: ONE BUSINESS DAY after the slot, at the\n * slot's own clock time.\n *\n * A meeting on a Friday is followed up on Monday, one on a Saturday or a\n * Sunday on Monday too; any other day is followed up the next. Whole days\n * are added to the instant rather than a calendar walked, so the arithmetic\n * cannot land on a clock time that does not exist across a DST change —\n * the task is due \"about this time tomorrow\", and an hour either way is not\n * a fact the task keeps.\n */\nexport function crmBookingFollowUpDueMs(\n  endsAtMs: number,\n  timezone?: string | null,\n): number {\n  const weekday = weekdayIn(endsAtMs, timezone || 'UTC')\n  // Friday (5) skips the weekend; Saturday (6) reaches Monday in two days.\n  const daysAhead = weekday === 5 ? 3 : weekday === 6 ? 2 : 1\n  return endsAtMs + daysAhead * DAY_MS\n}\n"],"names":["isValidTimeZone","zonedDateTime","CRM_BOOKING_REF_PARAM","BOOKING_SERVICE_PARAM","CRM_BOOKING_REF_KINDS","REF_ID_PATTERN","formatCrmBookingRef","ref","kind","id","parseCrmBookingRef","raw","separator","indexOf","slice","includes","test","formatSlot","startsAtMs","timezone","Intl","DateTimeFormat","timeZone","dateStyle","timeStyle","format","Date","crmBookingMeetingBody","input","service","String","serviceName","trim","crmBookingFollowUpTitle","DAY_MS","weekdayIn","atMs","weekday","crmBookingFollowUpDueMs","endsAtMs","daysAhead"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED;;;;;;;;;;CAUC,GAED,SACEA,eAAe,EACfC,aAAa,QACR,0CAAyC;AAEhD;;;;;;;;;CASC,GACD,OAAO,MAAMC,wBAAwB,MAAK;AAE1C;;;;CAIC,GACD,OAAO,MAAMC,wBAAwB,UAAS;AAE9C,0DAA0D,GAC1D,OAAO,MAAMC,wBAAwB;IAAC;IAAW;IAAQ;CAAO,CAAS;AASzE;;;;;CAKC,GACD,MAAMC,iBAAiB;AAEvB,kDAAkD,GAClD,OAAO,SAASC,oBAAoBC,GAAkB;IACpD,OAAO,GAAGA,IAAIC,IAAI,CAAC,CAAC,EAAED,IAAIE,EAAE,EAAE;AAChC;AAEA;;;;;;CAMC,GACD,OAAO,SAASC,mBAAmBC,GAAY;IAC7C,IAAI,OAAOA,QAAQ,UAAU,OAAO;IACpC,MAAMC,YAAYD,IAAIE,OAAO,CAAC;IAC9B,IAAID,aAAa,GAAG,OAAO;IAC3B,MAAMJ,OAAOG,IAAIG,KAAK,CAAC,GAAGF;IAC1B,MAAMH,KAAKE,IAAIG,KAAK,CAACF,YAAY;IACjC,IAAI,CAAC,AAACR,sBAA4CW,QAAQ,CAACP,OAAO,OAAO;IACzE,IAAI,CAACH,eAAeW,IAAI,CAACP,KAAK,OAAO;IACrC,OAAO;QAAED,MAAMA;QAA2BC;IAAG;AAC/C;AAEA,0DAA0D,GAC1D,SAASQ,WAAWC,UAAkB,EAAEC,QAAgB;IACtD,IAAI;QACF,OAAO,IAAIC,KAAKC,cAAc,CAAC,SAAS;YACtCC,UAAUH;YACVI,WAAW;YACXC,WAAW;QACb,GAAGC,MAAM,CAAC,IAAIC,KAAKR;IACrB,EAAE,eAAM;QACN,oEAAoE;QACpE,oEAAoE;QACpE,iCAAiC;QACjC,OAAO,IAAIE,KAAKC,cAAc,CAAC,SAAS;YACtCC,UAAU;YACVC,WAAW;YACXC,WAAW;QACb,GAAGC,MAAM,CAAC,IAAIC,KAAKR;IACrB;AACF;AAEA;;;;;CAKC,GACD,OAAO,SAASS,sBAAsBC,KAIrC;QAEwBA;IADvB,MAAMT,WAAWS,MAAMT,QAAQ,IAAI;IACnC,MAAMU,UAAUC,QAAOF,qBAAAA,MAAMG,WAAW,YAAjBH,qBAAqB,IAAII,IAAI,MAAM;IAC1D,OAAO,GAAGH,QAAQ,GAAG,EAAEZ,WAAWW,MAAMV,UAAU,EAAEC,UAAU,EAAE,EAAEA,SAAS,CAAC,CAAC;AAC/E;AAEA,wEAAwE,GACxE,OAAO,SAASc,wBAAwBF,WAAmB;IACzD,MAAMF,UAAUC,OAAOC,sBAAAA,cAAe,IAAIC,IAAI,MAAM;IACpD,OAAO,CAAC,gBAAgB,EAAEH,SAAS;AACrC;AAEA,MAAMK,SAAS,KAAK,KAAK,KAAK;AAE9B;;;;CAIC,GACD,SAASC,UAAUC,IAAY,EAAEjB,QAAgB;IAC/C,OAAOlB,cAAcmC,MAAMpC,gBAAgBmB,YAAYA,WAAW,OAAOkB,OAAO;AAClF;AAEA;;;;;;;;;;CAUC,GACD,OAAO,SAASC,wBACdC,QAAgB,EAChBpB,QAAwB;IAExB,MAAMkB,UAAUF,UAAUI,UAAUpB,YAAY;IAChD,yEAAyE;IACzE,MAAMqB,YAAYH,YAAY,IAAI,IAAIA,YAAY,IAAI,IAAI;IAC1D,OAAOE,WAAWC,YAAYN;AAChC"}

package/src/lib/app-utils/crm-inbound.d.ts

@@ -1,245 +0,0 @@
-/**
- * @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 CrmActivity, type CrmActivityLink, type CrmEmailDirection } from './crm';
-import { type MemberAddresses } from './member-email-aliases';
-/**
- * EMAIL CAPTURE (AGL-2657): the pure half.
- *
- * A workspace gets one address — `crm+<token>@<capture domain>` — and a
- * reply forwarded to it, or a message a teammate copies to it from their
- * own mailbox, is filed on the record of whoever the message was with.
- * This module is everything about that which needs no Firestore and no
- * provider: the shape of the address, the token in it, which of a
- * message's addresses is the correspondent, what of the body is worth
- * keeping, and the activity row the whole thing becomes. The webhook route
- * and the address route read it; the dialog and the settings card read the
- * address helpers; the specs read all of it.
- *
- * ## The token is the whole secret
- *
- * The address is public the moment a member pastes it into a mailbox rule,
- * and the domain is the platform's, so the token is the only thing that
- * says which workspace a message is for. Thirty-two characters from a
- * lowercase alphabet — mail servers may fold the local part's case, and a
- * token that survived folding is one that never depended on case — drawn
- * from the platform's random source, which is the same entropy an API key
- * carries. Rotation replaces it; the old address then files nothing.
- *
- * ## Who the message was with
- *
- * A message names several addresses and exactly one of them is the person
- * the record is about. The rule: the first address among From, To and Cc
- * that is not the capture address and not a member of the workspace — the
- * workspace's own people are never the correspondent — in that order,
- * because a reply's From is the correspondent and a copied send's To is.
- * A member is every address that is theirs: the one they sign in with and
- * each alias they have confirmed (`member-email-aliases.ts`), so a send
- * from an outbound-domain alias is read as the member's, not as a stranger.
- * A message a teammate forwarded names the correspondent nowhere in its
- * headers, only in the forwarded block of the body, so that block's `From:`
- * is the last candidate. Which candidate matched decides the direction:
- * one the correspondent wrote is `inbound`, one the workspace wrote is
- * `outbound`.
- */
-/** Where captured mail arrives when the deployment names no domain. */
-export declare const CRM_INBOUND_DEFAULT_DOMAIN = "in.aglyn.com";
-/** The local part every capture address begins with: `crm+<token>@…`. */
-export declare const CRM_INBOUND_LOCAL_PART = "crm";
-/** How many characters a minted token has. */
-export declare const CRM_INBOUND_TOKEN_LENGTH = 32;
-/** The most a captured message's excerpt keeps: a letter, not a thread. */
-export declare const CRM_INBOUND_EXCERPT_MAX = 4000;
-/** What the org's feed says about a message that matched no record. */
-export declare const CRM_INBOUND_UNMATCHED_ACTION = "Inbound email matched no record";
-/** What the org's feed says about a message the record's ceiling refused. */
-export declare const CRM_INBOUND_CEILING_ACTION = "Inbound email not filed: activity log full";
-/**
- * The domain captured mail is addressed at: `CRM_INBOUND_DOMAIN`, or the
- * platform's default when the deployment names none or names something
- * that is not a hostname. Lowercased, because a domain is.
- */
-export declare function crmInboundDomain(env?: Record<string, string | undefined>): string;
-/**
- * A fresh token from the platform's random source. One byte per character
- * folded onto a 36-symbol alphabet: the fold is very slightly uneven and
- * the token is thirty-two symbols long, which is more than an API key
- * carries and far more than an address anyone guesses.
- */
-export declare function mintCrmInboundToken(): string;
-export declare function isCrmInboundToken(value: unknown): value is string;
-/** `crm+<token>@<domain>` — the address a member pastes into a mailbox. */
-export declare function crmInboundAddress(token: string, domain: string): string;
-/**
- * The bare address in a header value — `Ada <ada@example.com>` and
- * `ada@example.com` both answer `ada@example.com` — normalized as every
- * contact address is, or `null` for anything that is not one.
- */
-export declare function emailAddressOf(value: unknown): string | null;
-/** The part after the `@`, or `null` — what an unmatched message is logged by. */
-export declare function emailDomainOf(value: unknown): string | null;
-/**
- * The token a recipient address carries, or `null` when the address is not
- * a capture address on `domain`. The local part is read case-folded — a
- * relay may fold it and the alphabet has no case to lose — and the domain
- * is compared the way domains compare.
- */
-export declare function crmInboundTokenOf(recipient: unknown, domain: string): string | null;
-/** Every distinct token among a message's recipients, in the order met. */
-export declare function crmInboundTokensIn(recipients: readonly unknown[], domain: string): string[];
-export declare function isCrmInboundAddress(address: unknown, domain: string): boolean;
-/**
- * The subject with its reply and forward prefixes removed, however many
- * were stacked — `Re: Fwd: RE: Renewal` is the `Renewal` thread — and
- * whitespace collapsed, so two rows of one conversation carry one value.
- */
-export declare function crmThreadSubject(subject: unknown): string;
-/**
- * The words in an HTML part, for a message that carried no text part.
- * Block boundaries become line breaks, tags go, the common entities are
- * read back — a best effort over a bounded slice, never a renderer.
- */
-export declare function htmlToPlainText(html: unknown): string;
-/** What a forwarded message's header block says, and the words after it. */
-export interface ForwardedSection {
-    /** The address on the block's `From:` line, or `null` when it carried none. */
-    from: string | null;
-    /** The forwarded message's own text, header block removed. */
-    body: string;
-}
-/**
- * The forwarded message inside a forward — the block a mail client puts
- * under "Forwarded message" or, with no marker, a run of `From:` … `Subject:`
- * header lines — or `null` when the text carries none. The `From:` line is
- * where the correspondent of a forwarded reply is named, since the forward's
- * own headers name only the teammate who forwarded it.
- */
-export declare function forwardedSection(text: string): ForwardedSection | null;
-/**
- * The words above the quoted history: everything before the first `On …
- * wrote:` line, quote mark, "Original Message" rule or reply header block.
- * The intro may wrap onto a second line, so a line that begins `On` is
- * read together with the one after it.
- */
-export declare function stripQuotedHistory(text: string): string;
-/**
- * What the timeline keeps of a captured message: the text part — or the
- * words of the HTML part when there is none — with a forward's header
- * block and the quoted history below the reply removed, whitespace
- * settled, bounded. Never the whole thread: the thread is in the mailbox,
- * and the row is a note that this exchange happened.
- */
-export declare function crmInboundExcerpt(text: unknown, html?: unknown): string;
-/** One address the message might be with, in the order the rule tries them. */
-export interface CrmInboundCandidate {
-    email: string;
-    /** What a row filed on a match with this address says about the message. */
-    direction: CrmEmailDirection;
-    /** Which header the address came from, for the spec and the log. */
-    via: 'from' | 'to' | 'cc' | 'forwarded';
-}
-/** One member of the workspace, as the capture filer reads them. */
-export interface CrmInboundMember extends MemberAddresses {
-    uid: string;
-    /** The address they sign in with; `''` for a roster row that carries none. */
-    email: string;
-    name?: string | null;
-}
-/** A roster row as {@link crmInboundRoster} reads it — `AglynOrgMember`'s fields. */
-export interface CrmInboundRosterRow {
-    $id: string;
-    email?: string | null;
-    displayName?: string | null;
-    orgSuspended?: boolean;
-}
-/**
- * The roster a captured message is matched against: every roster row that
- * does not carry the org's suspension flag, each with the address the
- * member signs in with and the aliases they have CONFIRMED, read off their
- * stored alias document by uid. The confirmed filter is applied here, from
- * the stored documents, so no caller can hand the rule an address a member
- * only typed. An alias document with no roster row beside it belongs to
- * somebody who is no longer a member, and is never read.
- */
-export declare function crmInboundRoster(rows: readonly CrmInboundRosterRow[], aliasDocuments: ReadonlyMap<string, unknown>): CrmInboundMember[];
-export interface CrmInboundCandidatesInput {
-    from: unknown;
-    to: readonly unknown[];
-    cc?: readonly unknown[];
-    /** The forwarded block's `From:`, when the body carried one. */
-    forwardedFrom?: unknown;
-    /** The capture domain, so the capture address itself is never a candidate. */
-    domain: string;
-    /**
-     * The workspace's roster. Every address that is a member's — the one
-     * they sign in with and each alias they have confirmed — is theirs, and
-     * none of them is ever a correspondent.
-     */
-    members: readonly MemberAddresses[];
-}
-export interface CrmInboundCandidates {
-    /** The normalized From, or `null` when the header carried no address. */
-    sender: string | null;
-    /** Whether a member of the workspace wrote the message. */
-    senderIsMember: boolean;
-    candidates: CrmInboundCandidate[];
-}
-/**
- * The addresses to try against the workspace's records, in order — see the
- * module comment — each already stamped with the direction a match would
- * mean: a message a member wrote went OUT to whoever it matches, and one
- * anybody else wrote came IN from them.
- */
-export declare function crmInboundCandidates(input: CrmInboundCandidatesInput): CrmInboundCandidates;
-/**
- * The key one message is filed under, so a second delivery of it is a
- * no-op: its `Message-ID`, which every mail client stamps and every relay
- * preserves, else the provider's own id, which a redelivery of one
- * webhook event repeats. `null` when the message has neither — a message
- * that cannot be told from its own redelivery is filed by a fresh id.
- */
-export declare function crmCapturedEmailKey(messageId: unknown, providerId: unknown): string | null;
-/** What a captured message is logged from — see {@link buildCrmCapturedEmailActivity}. */
-export interface CrmCapturedEmailInput {
-    direction: CrmEmailDirection;
-    subject: string;
-    /** The excerpt, already reduced by {@link crmInboundExcerpt}. */
-    excerpt: string;
-    /** The address on the message's From. */
-    from: string;
-    /** The address the message was addressed to, when one is worth showing. */
-    to?: string | null;
-    messageId: string;
-    inReplyTo?: string | null;
-    /** When the message was received. */
-    atMs: number;
-    /** The member who wrote it, or `''` for a message a correspondent wrote. */
-    byUid: string;
-    byName?: string | null;
-    link: CrmActivityLink;
-    hostId: string;
-    visibleTo: readonly string[];
-}
-/**
- * The activity row a captured message is filed as (AGL-2657): `kind:
- * 'email'`, with the direction the match decided, the excerpt for a body,
- * and the thread facts a later reader groups by. No delivery state — the
- * platform did not send it and can say nothing about where it got to —
- * which is also how the timeline tells a captured send from a platform
- * send. The same shape `buildCrmEmailActivity` writes, so the timeline
- * draws both with one row.
- */
-export declare function buildCrmCapturedEmailActivity(input: CrmCapturedEmailInput): CrmActivity;