@aglyn/aglyn 1.0.0-beta.143

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../libs/aglyn/src/lib/app-utils/crm-inbound.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { normalizeContactEmail } from './contacts'\nimport {\n  CRM_EMAIL_BODY_MAX,\n  CRM_EMAIL_SUBJECT_MAX,\n  type CrmActivity,\n  type CrmActivityLink,\n  type CrmEmailDirection,\n} from './crm'\nimport {\n  type MemberAddresses,\n  memberEmailAddresses,\n  verifiedMemberEmailAliases,\n} from './member-email-aliases'\n\n/**\n * EMAIL CAPTURE (AGL-2657): the pure half.\n *\n * A workspace gets one address — `crm+<token>@<capture domain>` — and a\n * reply forwarded to it, or a message a teammate copies to it from their\n * own mailbox, is filed on the record of whoever the message was with.\n * This module is everything about that which needs no Firestore and no\n * provider: the shape of the address, the token in it, which of a\n * message's addresses is the correspondent, what of the body is worth\n * keeping, and the activity row the whole thing becomes. The webhook route\n * and the address route read it; the dialog and the settings card read the\n * address helpers; the specs read all of it.\n *\n * ## The token is the whole secret\n *\n * The address is public the moment a member pastes it into a mailbox rule,\n * and the domain is the platform's, so the token is the only thing that\n * says which workspace a message is for. Thirty-two characters from a\n * lowercase alphabet — mail servers may fold the local part's case, and a\n * token that survived folding is one that never depended on case — drawn\n * from the platform's random source, which is the same entropy an API key\n * carries. Rotation replaces it; the old address then files nothing.\n *\n * ## Who the message was with\n *\n * A message names several addresses and exactly one of them is the person\n * the record is about. The rule: the first address among From, To and Cc\n * that is not the capture address and not a member of the workspace — the\n * workspace's own people are never the correspondent — in that order,\n * because a reply's From is the correspondent and a copied send's To is.\n * A member is every address that is theirs: the one they sign in with and\n * each alias they have confirmed (`member-email-aliases.ts`), so a send\n * from an outbound-domain alias is read as the member's, not as a stranger.\n * A message a teammate forwarded names the correspondent nowhere in its\n * headers, only in the forwarded block of the body, so that block's `From:`\n * is the last candidate. Which candidate matched decides the direction:\n * one the correspondent wrote is `inbound`, one the workspace wrote is\n * `outbound`.\n */\n\n/** Where captured mail arrives when the deployment names no domain. */\nexport const CRM_INBOUND_DEFAULT_DOMAIN = 'in.aglyn.com'\n\n/** The local part every capture address begins with: `crm+<token>@…`. */\nexport const CRM_INBOUND_LOCAL_PART = 'crm'\n\n/** How many characters a minted token has. */\nexport const CRM_INBOUND_TOKEN_LENGTH = 32\n\n/** The most a captured message's excerpt keeps: a letter, not a thread. */\nexport const CRM_INBOUND_EXCERPT_MAX = 4_000\n\n/** What the org's feed says about a message that matched no record. */\nexport const CRM_INBOUND_UNMATCHED_ACTION = 'Inbound email matched no record'\n\n/** What the org's feed says about a message the record's ceiling refused. */\nexport const CRM_INBOUND_CEILING_ACTION = 'Inbound email not filed: activity log full'\n\nconst TOKEN_ALPHABET = 'abcdefghijklmnopqrstuvwxyz0123456789'\nconst TOKEN_PATTERN = /^[a-z0-9]{24,64}$/\nconst DOMAIN_PATTERN = /^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)+$/\n\n/**\n * The domain captured mail is addressed at: `CRM_INBOUND_DOMAIN`, or the\n * platform's default when the deployment names none or names something\n * that is not a hostname. Lowercased, because a domain is.\n */\nexport function crmInboundDomain(\n  env: Record<string, string | undefined> = process.env,\n): string {\n  const configured = String(env['CRM_INBOUND_DOMAIN'] ?? '')\n    .trim()\n    .toLowerCase()\n  return DOMAIN_PATTERN.test(configured) ? configured : CRM_INBOUND_DEFAULT_DOMAIN\n}\n\n/**\n * A fresh token from the platform's random source. One byte per character\n * folded onto a 36-symbol alphabet: the fold is very slightly uneven and\n * the token is thirty-two symbols long, which is more than an API key\n * carries and far more than an address anyone guesses.\n */\nexport function mintCrmInboundToken(): string {\n  const bytes = new Uint8Array(CRM_INBOUND_TOKEN_LENGTH)\n  globalThis.crypto.getRandomValues(bytes)\n  let token = ''\n  for (const byte of bytes) token += TOKEN_ALPHABET[byte % TOKEN_ALPHABET.length]\n  return token\n}\n\nexport function isCrmInboundToken(value: unknown): value is string {\n  return typeof value === 'string' && TOKEN_PATTERN.test(value)\n}\n\n/** `crm+<token>@<domain>` — the address a member pastes into a mailbox. */\nexport function crmInboundAddress(token: string, domain: string): string {\n  return `${CRM_INBOUND_LOCAL_PART}+${token}@${domain}`\n}\n\n/**\n * The bare address in a header value — `Ada <ada@example.com>` and\n * `ada@example.com` both answer `ada@example.com` — normalized as every\n * contact address is, or `null` for anything that is not one.\n */\nexport function emailAddressOf(value: unknown): string | null {\n  const raw = String(value ?? '').trim()\n  const angled = /<([^<>]+)>\\s*$/.exec(raw)\n  return normalizeContactEmail(angled ? angled[1] : raw)\n}\n\n/** The part after the `@`, or `null` — what an unmatched message is logged by. */\nexport function emailDomainOf(value: unknown): string | null {\n  const address = emailAddressOf(value)\n  if (!address) return null\n  const at = address.lastIndexOf('@')\n  return at > 0 ? address.slice(at + 1) : null\n}\n\n/**\n * The token a recipient address carries, or `null` when the address is not\n * a capture address on `domain`. The local part is read case-folded — a\n * relay may fold it and the alphabet has no case to lose — and the domain\n * is compared the way domains compare.\n */\nexport function crmInboundTokenOf(recipient: unknown, domain: string): string | null {\n  const raw = String(recipient ?? '').trim()\n  const angled = /<([^<>]+)>\\s*$/.exec(raw)\n  const address = (angled ? angled[1] : raw).trim()\n  const at = address.lastIndexOf('@')\n  if (at <= 0) return null\n  if (address.slice(at + 1).toLowerCase() !== domain.toLowerCase()) return null\n  const local = address.slice(0, at).toLowerCase()\n  const match = new RegExp(`^${CRM_INBOUND_LOCAL_PART}\\\\+([a-z0-9]{24,64})$`).exec(local)\n  return match ? match[1] : null\n}\n\n/** Every distinct token among a message's recipients, in the order met. */\nexport function crmInboundTokensIn(\n  recipients: readonly unknown[],\n  domain: string,\n): string[] {\n  const tokens: string[] = []\n  for (const recipient of recipients) {\n    const token = crmInboundTokenOf(recipient, domain)\n    if (token && !tokens.includes(token)) tokens.push(token)\n  }\n  return tokens\n}\n\nexport function isCrmInboundAddress(address: unknown, domain: string): boolean {\n  return crmInboundTokenOf(address, domain) !== null\n}\n\n/**\n * The subject with its reply and forward prefixes removed, however many\n * were stacked — `Re: Fwd: RE: Renewal` is the `Renewal` thread — and\n * whitespace collapsed, so two rows of one conversation carry one value.\n */\nexport function crmThreadSubject(subject: unknown): string {\n  let value = String(subject ?? '')\n    .replace(/\\s+/g, ' ')\n    .trim()\n  const prefix = /^(re|fwd?|aw|wg|tr|sv|vs)\\s*(\\[\\d+\\])?\\s*:\\s*/i\n  while (prefix.test(value)) value = value.replace(prefix, '')\n  return value.slice(0, CRM_EMAIL_SUBJECT_MAX)\n}\n\nconst ENTITIES: Record<string, string> = {\n  amp: '&',\n  lt: '<',\n  gt: '>',\n  quot: '\"',\n  apos: \"'\",\n  nbsp: ' ',\n}\n\n/**\n * The words in an HTML part, for a message that carried no text part.\n * Block boundaries become line breaks, tags go, the common entities are\n * read back — a best effort over a bounded slice, never a renderer.\n */\nexport function htmlToPlainText(html: unknown): string {\n  return String(html ?? '')\n    .slice(0, 200_000)\n    .replace(/<(script|style)[\\s\\S]*?<\\/\\1>/gi, '')\n    .replace(/<br\\s*\\/?>/gi, '\\n')\n    .replace(/<\\/(p|div|li|tr|h[1-6]|blockquote|pre)>/gi, '\\n')\n    .replace(/<[^>]+>/g, '')\n    .replace(/&(#\\d+|#x[0-9a-f]+|[a-z]+);/gi, (whole, code: string) => {\n      if (code.startsWith('#x') || code.startsWith('#X')) {\n        return String.fromCodePoint(parseInt(code.slice(2), 16))\n      }\n      if (code.startsWith('#')) return String.fromCodePoint(parseInt(code.slice(1), 10))\n      return ENTITIES[code.toLowerCase()] ?? whole\n    })\n}\n\n/** What a forwarded message's header block says, and the words after it. */\nexport interface ForwardedSection {\n  /** The address on the block's `From:` line, or `null` when it carried none. */\n  from: string | null\n  /** The forwarded message's own text, header block removed. */\n  body: string\n}\n\nconst FORWARD_MARKER = /^\\s*(-{2,}\\s*Forwarded message\\s*-{2,}|Begin forwarded message:)\\s*$/i\nconst HEADER_LINE = /^\\s*\\*?(From|Sent|Date|To|Cc|Subject|Reply-To)\\s*:\\*?\\s*(.*)$/i\n\n/**\n * The forwarded message inside a forward — the block a mail client puts\n * under \"Forwarded message\" or, with no marker, a run of `From:` … `Subject:`\n * header lines — or `null` when the text carries none. The `From:` line is\n * where the correspondent of a forwarded reply is named, since the forward's\n * own headers name only the teammate who forwarded it.\n */\nexport function forwardedSection(text: string): ForwardedSection | null {\n  const lines = text.split('\\n')\n  let start = -1\n  for (let index = 0; index < lines.length; index += 1) {\n    if (FORWARD_MARKER.test(lines[index])) {\n      start = index + 1\n      break\n    }\n    if (/^\\s*\\*?From\\s*:/i.test(lines[index]) && !lines[index].trimStart().startsWith('>')) {\n      const window = lines.slice(index, index + 8)\n      if (window.some((line) => /^\\s*\\*?Subject\\s*:/i.test(line))) {\n        start = index\n        break\n      }\n    }\n  }\n  if (start < 0) return null\n  let from: string | null = null\n  let cursor = start\n  // The header block: header lines, blank lines between them allowed, up to\n  // the first line that is neither.\n  let sawHeader = false\n  while (cursor < lines.length) {\n    const line = lines[cursor]\n    const header = HEADER_LINE.exec(line)\n    if (header) {\n      sawHeader = true\n      if (header[1].toLowerCase() === 'from') from = from ?? emailAddressOf(header[2])\n      cursor += 1\n      continue\n    }\n    if (!line.trim() && !sawHeader) {\n      cursor += 1\n      continue\n    }\n    if (!line.trim() && sawHeader) {\n      // A blank line after a header run may precede more headers (Apple\n      // Mail) or the body; look past it.\n      const next = lines[cursor + 1] ?? ''\n      if (HEADER_LINE.test(next)) {\n        cursor += 1\n        continue\n      }\n      cursor += 1\n      break\n    }\n    break\n  }\n  return { from, body: lines.slice(cursor).join('\\n') }\n}\n\nconst QUOTE_INTRO = /^\\s*On\\b.{0,300}$/\nconst QUOTE_END = /wrote:\\s*$/i\nconst HISTORY_MARKERS = [\n  /^\\s*>/,\n  /^\\s*-{2,}\\s*Original Message\\s*-{2,}\\s*$/i,\n  /^\\s*_{5,}\\s*$/,\n  /^\\s*From:\\s.+$/,\n  /^\\s*Sent from my\\b/i,\n  /^\\s*Le .{0,200} a écrit\\s*:\\s*$/i,\n  /^\\s*Am .{0,200} schrieb .{0,100}:\\s*$/i,\n]\n\n/**\n * The words above the quoted history: everything before the first `On …\n * wrote:` line, quote mark, \"Original Message\" rule or reply header block.\n * The intro may wrap onto a second line, so a line that begins `On` is\n * read together with the one after it.\n */\nexport function stripQuotedHistory(text: string): string {\n  const lines = text.split('\\n')\n  let end = lines.length\n  for (let index = 0; index < lines.length; index += 1) {\n    const line = lines[index]\n    if (HISTORY_MARKERS.some((marker) => marker.test(line))) {\n      end = index\n      break\n    }\n    if (QUOTE_INTRO.test(line)) {\n      const joined = `${line} ${lines[index + 1] ?? ''}`\n      if (QUOTE_END.test(line) || QUOTE_END.test(joined)) {\n        end = index\n        break\n      }\n    }\n  }\n  return lines.slice(0, end).join('\\n')\n}\n\n/**\n * What the timeline keeps of a captured message: the text part — or the\n * words of the HTML part when there is none — with a forward's header\n * block and the quoted history below the reply removed, whitespace\n * settled, bounded. Never the whole thread: the thread is in the mailbox,\n * and the row is a note that this exchange happened.\n */\nexport function crmInboundExcerpt(text: unknown, html?: unknown): string {\n  let body = String(text ?? '')\n  if (!body.trim() && html) body = htmlToPlainText(html)\n  body = body.replace(/\\r\\n?/g, '\\n').replace(/\\u00a0/g, ' ')\n  const forwarded = forwardedSection(body)\n  if (forwarded) body = forwarded.body\n  body = stripQuotedHistory(body)\n  return body\n    .split('\\n')\n    .map((line) => line.replace(/[ \\t]+$/g, ''))\n    .join('\\n')\n    .replace(/\\n{3,}/g, '\\n\\n')\n    .trim()\n    .slice(0, CRM_INBOUND_EXCERPT_MAX)\n}\n\n/** One address the message might be with, in the order the rule tries them. */\nexport interface CrmInboundCandidate {\n  email: string\n  /** What a row filed on a match with this address says about the message. */\n  direction: CrmEmailDirection\n  /** Which header the address came from, for the spec and the log. */\n  via: 'from' | 'to' | 'cc' | 'forwarded'\n}\n\n/** One member of the workspace, as the capture filer reads them. */\nexport interface CrmInboundMember extends MemberAddresses {\n  uid: string\n  /** The address they sign in with; `''` for a roster row that carries none. */\n  email: string\n  name?: string | null\n}\n\n/** A roster row as {@link crmInboundRoster} reads it — `AglynOrgMember`'s fields. */\nexport interface CrmInboundRosterRow {\n  $id: string\n  email?: string | null\n  displayName?: string | null\n  orgSuspended?: boolean\n}\n\n/**\n * The roster a captured message is matched against: every roster row that\n * does not carry the org's suspension flag, each with the address the\n * member signs in with and the aliases they have CONFIRMED, read off their\n * stored alias document by uid. The confirmed filter is applied here, from\n * the stored documents, so no caller can hand the rule an address a member\n * only typed. An alias document with no roster row beside it belongs to\n * somebody who is no longer a member, and is never read.\n */\nexport function crmInboundRoster(\n  rows: readonly CrmInboundRosterRow[],\n  aliasDocuments: ReadonlyMap<string, unknown>,\n): CrmInboundMember[] {\n  const roster: CrmInboundMember[] = []\n  for (const row of rows) {\n    if (row.orgSuspended === true) continue\n    const uid = String(row.$id ?? '')\n    if (!uid) continue\n    const email = normalizeContactEmail(row.email) ?? ''\n    const verifiedAliases = verifiedMemberEmailAliases(aliasDocuments.get(uid))\n    if (!email && !verifiedAliases.length) continue\n    roster.push({\n      uid,\n      email,\n      name: row.displayName ?? null,\n      ...(verifiedAliases.length ? { verifiedAliases } : {}),\n    })\n  }\n  return roster\n}\n\nexport interface CrmInboundCandidatesInput {\n  from: unknown\n  to: readonly unknown[]\n  cc?: readonly unknown[]\n  /** The forwarded block's `From:`, when the body carried one. */\n  forwardedFrom?: unknown\n  /** The capture domain, so the capture address itself is never a candidate. */\n  domain: string\n  /**\n   * The workspace's roster. Every address that is a member's — the one\n   * they sign in with and each alias they have confirmed — is theirs, and\n   * none of them is ever a correspondent.\n   */\n  members: readonly MemberAddresses[]\n}\n\nexport interface CrmInboundCandidates {\n  /** The normalized From, or `null` when the header carried no address. */\n  sender: string | null\n  /** Whether a member of the workspace wrote the message. */\n  senderIsMember: boolean\n  candidates: CrmInboundCandidate[]\n}\n\n/**\n * The addresses to try against the workspace's records, in order — see the\n * module comment — each already stamped with the direction a match would\n * mean: a message a member wrote went OUT to whoever it matches, and one\n * anybody else wrote came IN from them.\n */\nexport function crmInboundCandidates(input: CrmInboundCandidatesInput): CrmInboundCandidates {\n  const members = new Set<string>()\n  for (const member of input.members) {\n    for (const address of memberEmailAddresses(member)) members.add(address)\n  }\n  const sender = emailAddressOf(input.from)\n  const senderIsMember = sender !== null && members.has(sender)\n  const seen = new Set<string>()\n  const candidates: CrmInboundCandidate[] = []\n  const consider = (\n    value: unknown,\n    direction: CrmEmailDirection,\n    via: CrmInboundCandidate['via'],\n  ) => {\n    const email = emailAddressOf(value)\n    if (!email || seen.has(email) || members.has(email)) return\n    if (isCrmInboundAddress(email, input.domain)) return\n    seen.add(email)\n    candidates.push({ email, direction, via })\n  }\n  consider(input.from, 'inbound', 'from')\n  const headed = senderIsMember ? 'outbound' : 'inbound'\n  for (const value of input.to) consider(value, headed, 'to')\n  for (const value of input.cc ?? []) consider(value, headed, 'cc')\n  consider(input.forwardedFrom, 'inbound', 'forwarded')\n  return { sender, senderIsMember, candidates }\n}\n\n/**\n * The key one message is filed under, so a second delivery of it is a\n * no-op: its `Message-ID`, which every mail client stamps and every relay\n * preserves, else the provider's own id, which a redelivery of one\n * webhook event repeats. `null` when the message has neither — a message\n * that cannot be told from its own redelivery is filed by a fresh id.\n */\nexport function crmCapturedEmailKey(messageId: unknown, providerId: unknown): string | null {\n  const id = String(messageId ?? '').trim()\n  if (id) return `mid:${id}`\n  const provider = String(providerId ?? '').trim()\n  return provider ? `provider:${provider}` : null\n}\n\n/** What a captured message is logged from — see {@link buildCrmCapturedEmailActivity}. */\nexport interface CrmCapturedEmailInput {\n  direction: CrmEmailDirection\n  subject: string\n  /** The excerpt, already reduced by {@link crmInboundExcerpt}. */\n  excerpt: string\n  /** The address on the message's From. */\n  from: string\n  /** The address the message was addressed to, when one is worth showing. */\n  to?: string | null\n  messageId: string\n  inReplyTo?: string | null\n  /** When the message was received. */\n  atMs: number\n  /** The member who wrote it, or `''` for a message a correspondent wrote. */\n  byUid: string\n  byName?: string | null\n  link: CrmActivityLink\n  hostId: string\n  visibleTo: readonly string[]\n}\n\n/**\n * The activity row a captured message is filed as (AGL-2657): `kind:\n * 'email'`, with the direction the match decided, the excerpt for a body,\n * and the thread facts a later reader groups by. No delivery state — the\n * platform did not send it and can say nothing about where it got to —\n * which is also how the timeline tells a captured send from a platform\n * send. The same shape `buildCrmEmailActivity` writes, so the timeline\n * draws both with one row.\n */\nexport function buildCrmCapturedEmailActivity(input: CrmCapturedEmailInput): CrmActivity {\n  const { link } = input\n  const subject = String(input.subject ?? '')\n    .replace(/\\s+/g, ' ')\n    .trim()\n    .slice(0, CRM_EMAIL_SUBJECT_MAX)\n  const inReplyTo = String(input.inReplyTo ?? '').trim()\n  const to = String(input.to ?? '').trim()\n  const byName = String(input.byName ?? '').trim()\n  return {\n    kind: 'email',\n    subject,\n    body: String(input.excerpt ?? '').slice(0, CRM_EMAIL_BODY_MAX),\n    direction: input.direction,\n    from: input.from,\n    ...(to ? { to } : {}),\n    messageId: String(input.messageId ?? '').trim(),\n    ...(inReplyTo ? { inReplyTo } : {}),\n    threadSubject: crmThreadSubject(subject),\n    atMs: input.atMs,\n    byUid: input.byUid,\n    ...(byName ? { byName } : {}),\n    ...(link.contactId ? { contactId: String(link.contactId) } : {}),\n    ...(link.companyId ? { companyId: String(link.companyId) } : {}),\n    ...(link.dealId ? { dealId: String(link.dealId) } : {}),\n    ...(link.leadId ? { leadId: String(link.leadId) } : {}),\n    hostId: input.hostId,\n    visibleTo: [...input.visibleTo],\n  }\n}\n"],"names":["normalizeContactEmail","CRM_EMAIL_BODY_MAX","CRM_EMAIL_SUBJECT_MAX","memberEmailAddresses","verifiedMemberEmailAliases","CRM_INBOUND_DEFAULT_DOMAIN","CRM_INBOUND_LOCAL_PART","CRM_INBOUND_TOKEN_LENGTH","CRM_INBOUND_EXCERPT_MAX","CRM_INBOUND_UNMATCHED_ACTION","CRM_INBOUND_CEILING_ACTION","TOKEN_ALPHABET","TOKEN_PATTERN","DOMAIN_PATTERN","crmInboundDomain","env","process","configured","String","trim","toLowerCase","test","mintCrmInboundToken","bytes","Uint8Array","globalThis","crypto","getRandomValues","token","byte","length","isCrmInboundToken","value","crmInboundAddress","domain","emailAddressOf","raw","angled","exec","emailDomainOf","address","at","lastIndexOf","slice","crmInboundTokenOf","recipient","local","match","RegExp","crmInboundTokensIn","recipients","tokens","includes","push","isCrmInboundAddress","crmThreadSubject","subject","replace","prefix","ENTITIES","amp","lt","gt","quot","apos","nbsp","htmlToPlainText","html","whole","code","startsWith","fromCodePoint","parseInt","FORWARD_MARKER","HEADER_LINE","forwardedSection","text","lines","split","start","index","trimStart","window","some","line","from","cursor","sawHeader","header","next","body","join","QUOTE_INTRO","QUOTE_END","HISTORY_MARKERS","stripQuotedHistory","end","marker","joined","crmInboundExcerpt","forwarded","map","crmInboundRoster","rows","aliasDocuments","roster","row","orgSuspended","uid","$id","email","verifiedAliases","get","name","displayName","crmInboundCandidates","input","members","Set","member","add","sender","senderIsMember","has","seen","candidates","consider","direction","via","headed","to","cc","forwardedFrom","crmCapturedEmailKey","messageId","providerId","id","provider","buildCrmCapturedEmailActivity","link","inReplyTo","byName","kind","excerpt","threadSubject","atMs","byUid","contactId","companyId","dealId","leadId","hostId","visibleTo"],"mappings":";AAAA;;;;;;;;;;;;;;;CAeC,GAED,SAASA,qBAAqB,QAAQ,gBAAY;AAClD,SACEC,kBAAkB,EAClBC,qBAAqB,QAIhB,WAAO;AACd,SAEEC,oBAAoB,EACpBC,0BAA0B,QACrB,4BAAwB;AAE/B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsCC,GAED,qEAAqE,GACrE,OAAO,MAAMC,6BAA6B,eAAc;AAExD,uEAAuE,GACvE,OAAO,MAAMC,yBAAyB,MAAK;AAE3C,4CAA4C,GAC5C,OAAO,MAAMC,2BAA2B,GAAE;AAE1C,yEAAyE,GACzE,OAAO,MAAMC,0BAA0B,KAAK;AAE5C,qEAAqE,GACrE,OAAO,MAAMC,+BAA+B,kCAAiC;AAE7E,2EAA2E,GAC3E,OAAO,MAAMC,6BAA6B,6CAA4C;AAEtF,MAAMC,iBAAiB;AACvB,MAAMC,gBAAgB;AACtB,MAAMC,iBAAiB;AAEvB;;;;CAIC,GACD,OAAO,SAASC,iBACdC,MAA0CC,QAAQD,GAAG;QAE3BA;IAA1B,MAAME,aAAaC,QAAOH,0BAAAA,GAAG,CAAC,qBAAqB,YAAzBA,0BAA6B,IACpDI,IAAI,GACJC,WAAW;IACd,OAAOP,eAAeQ,IAAI,CAACJ,cAAcA,aAAaZ;AACxD;AAEA;;;;;CAKC,GACD,OAAO,SAASiB;IACd,MAAMC,QAAQ,IAAIC,WAAWjB;IAC7BkB,WAAWC,MAAM,CAACC,eAAe,CAACJ;IAClC,IAAIK,QAAQ;IACZ,KAAK,MAAMC,QAAQN,MAAOK,SAASjB,cAAc,CAACkB,OAAOlB,eAAemB,MAAM,CAAC;IAC/E,OAAOF;AACT;AAEA,OAAO,SAASG,kBAAkBC,KAAc;IAC9C,OAAO,OAAOA,UAAU,YAAYpB,cAAcS,IAAI,CAACW;AACzD;AAEA,yEAAyE,GACzE,OAAO,SAASC,kBAAkBL,KAAa,EAAEM,MAAc;IAC7D,OAAO,GAAG5B,uBAAuB,CAAC,EAAEsB,MAAM,CAAC,EAAEM,QAAQ;AACvD;AAEA;;;;CAIC,GACD,OAAO,SAASC,eAAeH,KAAc;IAC3C,MAAMI,MAAMlB,OAAOc,gBAAAA,QAAS,IAAIb,IAAI;IACpC,MAAMkB,SAAS,iBAAiBC,IAAI,CAACF;IACrC,OAAOpC,sBAAsBqC,SAASA,MAAM,CAAC,EAAE,GAAGD;AACpD;AAEA,gFAAgF,GAChF,OAAO,SAASG,cAAcP,KAAc;IAC1C,MAAMQ,UAAUL,eAAeH;IAC/B,IAAI,CAACQ,SAAS,OAAO;IACrB,MAAMC,KAAKD,QAAQE,WAAW,CAAC;IAC/B,OAAOD,KAAK,IAAID,QAAQG,KAAK,CAACF,KAAK,KAAK;AAC1C;AAEA;;;;;CAKC,GACD,OAAO,SAASG,kBAAkBC,SAAkB,EAAEX,MAAc;IAClE,MAAME,MAAMlB,OAAO2B,oBAAAA,YAAa,IAAI1B,IAAI;IACxC,MAAMkB,SAAS,iBAAiBC,IAAI,CAACF;IACrC,MAAMI,UAAU,AAACH,CAAAA,SAASA,MAAM,CAAC,EAAE,GAAGD,GAAE,EAAGjB,IAAI;IAC/C,MAAMsB,KAAKD,QAAQE,WAAW,CAAC;IAC/B,IAAID,MAAM,GAAG,OAAO;IACpB,IAAID,QAAQG,KAAK,CAACF,KAAK,GAAGrB,WAAW,OAAOc,OAAOd,WAAW,IAAI,OAAO;IACzE,MAAM0B,QAAQN,QAAQG,KAAK,CAAC,GAAGF,IAAIrB,WAAW;IAC9C,MAAM2B,QAAQ,IAAIC,OAAO,CAAC,CAAC,EAAE1C,uBAAuB,qBAAqB,CAAC,EAAEgC,IAAI,CAACQ;IACjF,OAAOC,QAAQA,KAAK,CAAC,EAAE,GAAG;AAC5B;AAEA,yEAAyE,GACzE,OAAO,SAASE,mBACdC,UAA8B,EAC9BhB,MAAc;IAEd,MAAMiB,SAAmB,EAAE;IAC3B,KAAK,MAAMN,aAAaK,WAAY;QAClC,MAAMtB,QAAQgB,kBAAkBC,WAAWX;QAC3C,IAAIN,SAAS,CAACuB,OAAOC,QAAQ,CAACxB,QAAQuB,OAAOE,IAAI,CAACzB;IACpD;IACA,OAAOuB;AACT;AAEA,OAAO,SAASG,oBAAoBd,OAAgB,EAAEN,MAAc;IAClE,OAAOU,kBAAkBJ,SAASN,YAAY;AAChD;AAEA;;;;CAIC,GACD,OAAO,SAASqB,iBAAiBC,OAAgB;IAC/C,IAAIxB,QAAQd,OAAOsC,kBAAAA,UAAW,IAC3BC,OAAO,CAAC,QAAQ,KAChBtC,IAAI;IACP,MAAMuC,SAAS;IACf,MAAOA,OAAOrC,IAAI,CAACW,OAAQA,QAAQA,MAAMyB,OAAO,CAACC,QAAQ;IACzD,OAAO1B,MAAMW,KAAK,CAAC,GAAGzC;AACxB;AAEA,MAAMyD,WAAmC;IACvCC,KAAK;IACLC,IAAI;IACJC,IAAI;IACJC,MAAM;IACNC,MAAM;IACNC,MAAM;AACR;AAEA;;;;CAIC,GACD,OAAO,SAASC,gBAAgBC,IAAa;IAC3C,OAAOjD,OAAOiD,eAAAA,OAAQ,IACnBxB,KAAK,CAAC,GAAG,QACTc,OAAO,CAAC,mCAAmC,IAC3CA,OAAO,CAAC,gBAAgB,MACxBA,OAAO,CAAC,6CAA6C,MACrDA,OAAO,CAAC,YAAY,IACpBA,OAAO,CAAC,iCAAiC,CAACW,OAAOC;YAKzCV;QAJP,IAAIU,KAAKC,UAAU,CAAC,SAASD,KAAKC,UAAU,CAAC,OAAO;YAClD,OAAOpD,OAAOqD,aAAa,CAACC,SAASH,KAAK1B,KAAK,CAAC,IAAI;QACtD;QACA,IAAI0B,KAAKC,UAAU,CAAC,MAAM,OAAOpD,OAAOqD,aAAa,CAACC,SAASH,KAAK1B,KAAK,CAAC,IAAI;QAC9E,QAAOgB,6BAAAA,QAAQ,CAACU,KAAKjD,WAAW,GAAG,YAA5BuC,6BAAgCS;IACzC;AACJ;AAUA,MAAMK,iBAAiB;AACvB,MAAMC,cAAc;AAEpB;;;;;;CAMC,GACD,OAAO,SAASC,iBAAiBC,IAAY;IAC3C,MAAMC,QAAQD,KAAKE,KAAK,CAAC;IACzB,IAAIC,QAAQ,CAAC;IACb,IAAK,IAAIC,QAAQ,GAAGA,QAAQH,MAAM/C,MAAM,EAAEkD,SAAS,EAAG;QACpD,IAAIP,eAAepD,IAAI,CAACwD,KAAK,CAACG,MAAM,GAAG;YACrCD,QAAQC,QAAQ;YAChB;QACF;QACA,IAAI,mBAAmB3D,IAAI,CAACwD,KAAK,CAACG,MAAM,KAAK,CAACH,KAAK,CAACG,MAAM,CAACC,SAAS,GAAGX,UAAU,CAAC,MAAM;YACtF,MAAMY,SAASL,MAAMlC,KAAK,CAACqC,OAAOA,QAAQ;YAC1C,IAAIE,OAAOC,IAAI,CAAC,CAACC,OAAS,sBAAsB/D,IAAI,CAAC+D,QAAQ;gBAC3DL,QAAQC;gBACR;YACF;QACF;IACF;IACA,IAAID,QAAQ,GAAG,OAAO;IACtB,IAAIM,OAAsB;IAC1B,IAAIC,SAASP;IACb,0EAA0E;IAC1E,kCAAkC;IAClC,IAAIQ,YAAY;IAChB,MAAOD,SAAST,MAAM/C,MAAM,CAAE;QAC5B,MAAMsD,OAAOP,KAAK,CAACS,OAAO;QAC1B,MAAME,SAASd,YAAYpC,IAAI,CAAC8C;QAChC,IAAII,QAAQ;YACVD,YAAY;YACZ,IAAIC,MAAM,CAAC,EAAE,CAACpE,WAAW,OAAO,QAAQiE,OAAOA,eAAAA,OAAQlD,eAAeqD,MAAM,CAAC,EAAE;YAC/EF,UAAU;YACV;QACF;QACA,IAAI,CAACF,KAAKjE,IAAI,MAAM,CAACoE,WAAW;YAC9BD,UAAU;YACV;QACF;QACA,IAAI,CAACF,KAAKjE,IAAI,MAAMoE,WAAW;gBAGhBV;YAFb,kEAAkE;YAClE,mCAAmC;YACnC,MAAMY,QAAOZ,UAAAA,KAAK,CAACS,SAAS,EAAE,YAAjBT,UAAqB;YAClC,IAAIH,YAAYrD,IAAI,CAACoE,OAAO;gBAC1BH,UAAU;gBACV;YACF;YACAA,UAAU;YACV;QACF;QACA;IACF;IACA,OAAO;QAAED;QAAMK,MAAMb,MAAMlC,KAAK,CAAC2C,QAAQK,IAAI,CAAC;IAAM;AACtD;AAEA,MAAMC,cAAc;AACpB,MAAMC,YAAY;AAClB,MAAMC,kBAAkB;IACtB;IACA;IACA;IACA;IACA;IACA;IACA;CACD;AAED;;;;;CAKC,GACD,OAAO,SAASC,mBAAmBnB,IAAY;IAC7C,MAAMC,QAAQD,KAAKE,KAAK,CAAC;IACzB,IAAIkB,MAAMnB,MAAM/C,MAAM;IACtB,IAAK,IAAIkD,QAAQ,GAAGA,QAAQH,MAAM/C,MAAM,EAAEkD,SAAS,EAAG;QACpD,MAAMI,OAAOP,KAAK,CAACG,MAAM;QACzB,IAAIc,gBAAgBX,IAAI,CAAC,CAACc,SAAWA,OAAO5E,IAAI,CAAC+D,QAAQ;YACvDY,MAAMhB;YACN;QACF;QACA,IAAIY,YAAYvE,IAAI,CAAC+D,OAAO;gBACAP;YAA1B,MAAMqB,SAAS,GAAGd,KAAK,CAAC,GAAEP,UAAAA,KAAK,CAACG,QAAQ,EAAE,YAAhBH,UAAoB,IAAI;YAClD,IAAIgB,UAAUxE,IAAI,CAAC+D,SAASS,UAAUxE,IAAI,CAAC6E,SAAS;gBAClDF,MAAMhB;gBACN;YACF;QACF;IACF;IACA,OAAOH,MAAMlC,KAAK,CAAC,GAAGqD,KAAKL,IAAI,CAAC;AAClC;AAEA;;;;;;CAMC,GACD,OAAO,SAASQ,kBAAkBvB,IAAa,EAAET,IAAc;IAC7D,IAAIuB,OAAOxE,OAAO0D,eAAAA,OAAQ;IAC1B,IAAI,CAACc,KAAKvE,IAAI,MAAMgD,MAAMuB,OAAOxB,gBAAgBC;IACjDuB,OAAOA,KAAKjC,OAAO,CAAC,UAAU,MAAMA,OAAO,CAAC,WAAW;IACvD,MAAM2C,YAAYzB,iBAAiBe;IACnC,IAAIU,WAAWV,OAAOU,UAAUV,IAAI;IACpCA,OAAOK,mBAAmBL;IAC1B,OAAOA,KACJZ,KAAK,CAAC,MACNuB,GAAG,CAAC,CAACjB,OAASA,KAAK3B,OAAO,CAAC,YAAY,KACvCkC,IAAI,CAAC,MACLlC,OAAO,CAAC,WAAW,QACnBtC,IAAI,GACJwB,KAAK,CAAC,GAAGnC;AACd;AA2BA;;;;;;;;CAQC,GACD,OAAO,SAAS8F,iBACdC,IAAoC,EACpCC,cAA4C;IAE5C,MAAMC,SAA6B,EAAE;IACrC,KAAK,MAAMC,OAAOH,KAAM;YAEHG,UAEL1G,wBAMN0G;QATR,IAAIA,IAAIC,YAAY,KAAK,MAAM;QAC/B,MAAMC,MAAM1F,QAAOwF,WAAAA,IAAIG,GAAG,YAAPH,WAAW;QAC9B,IAAI,CAACE,KAAK;QACV,MAAME,SAAQ9G,yBAAAA,sBAAsB0G,IAAII,KAAK,aAA/B9G,yBAAoC;QAClD,MAAM+G,kBAAkB3G,2BAA2BoG,eAAeQ,GAAG,CAACJ;QACtE,IAAI,CAACE,SAAS,CAACC,gBAAgBjF,MAAM,EAAE;QACvC2E,OAAOpD,IAAI,CAAC;YACVuD;YACAE;YACAG,IAAI,GAAEP,mBAAAA,IAAIQ,WAAW,YAAfR,mBAAmB;WACrBK,gBAAgBjF,MAAM,GAAG;YAAEiF;QAAgB,IAAI,CAAC;IAExD;IACA,OAAON;AACT;AA0BA;;;;;CAKC,GACD,OAAO,SAASU,qBAAqBC,KAAgC;QAuB/CA;IAtBpB,MAAMC,UAAU,IAAIC;IACpB,KAAK,MAAMC,UAAUH,MAAMC,OAAO,CAAE;QAClC,KAAK,MAAM7E,WAAWrC,qBAAqBoH,QAASF,QAAQG,GAAG,CAAChF;IAClE;IACA,MAAMiF,SAAStF,eAAeiF,MAAM/B,IAAI;IACxC,MAAMqC,iBAAiBD,WAAW,QAAQJ,QAAQM,GAAG,CAACF;IACtD,MAAMG,OAAO,IAAIN;IACjB,MAAMO,aAAoC,EAAE;IAC5C,MAAMC,WAAW,CACf9F,OACA+F,WACAC;QAEA,MAAMlB,QAAQ3E,eAAeH;QAC7B,IAAI,CAAC8E,SAASc,KAAKD,GAAG,CAACb,UAAUO,QAAQM,GAAG,CAACb,QAAQ;QACrD,IAAIxD,oBAAoBwD,OAAOM,MAAMlF,MAAM,GAAG;QAC9C0F,KAAKJ,GAAG,CAACV;QACTe,WAAWxE,IAAI,CAAC;YAAEyD;YAAOiB;YAAWC;QAAI;IAC1C;IACAF,SAASV,MAAM/B,IAAI,EAAE,WAAW;IAChC,MAAM4C,SAASP,iBAAiB,aAAa;IAC7C,KAAK,MAAM1F,SAASoF,MAAMc,EAAE,CAAEJ,SAAS9F,OAAOiG,QAAQ;IACtD,KAAK,MAAMjG,UAASoF,YAAAA,MAAMe,EAAE,YAARf,YAAY,EAAE,CAAEU,SAAS9F,OAAOiG,QAAQ;IAC5DH,SAASV,MAAMgB,aAAa,EAAE,WAAW;IACzC,OAAO;QAAEX;QAAQC;QAAgBG;IAAW;AAC9C;AAEA;;;;;;CAMC,GACD,OAAO,SAASQ,oBAAoBC,SAAkB,EAAEC,UAAmB;IACzE,MAAMC,KAAKtH,OAAOoH,oBAAAA,YAAa,IAAInH,IAAI;IACvC,IAAIqH,IAAI,OAAO,CAAC,IAAI,EAAEA,IAAI;IAC1B,MAAMC,WAAWvH,OAAOqH,qBAAAA,aAAc,IAAIpH,IAAI;IAC9C,OAAOsH,WAAW,CAAC,SAAS,EAAEA,UAAU,GAAG;AAC7C;AAwBA;;;;;;;;CAQC,GACD,OAAO,SAASC,8BAA8BtB,KAA4B;QAEjDA,gBAIEA,kBACPA,WACIA,eAIPA,gBAIKA;IAfpB,MAAM,EAAEuB,IAAI,EAAE,GAAGvB;IACjB,MAAM5D,UAAUtC,QAAOkG,iBAAAA,MAAM5D,OAAO,YAAb4D,iBAAiB,IACrC3D,OAAO,CAAC,QAAQ,KAChBtC,IAAI,GACJwB,KAAK,CAAC,GAAGzC;IACZ,MAAM0I,YAAY1H,QAAOkG,mBAAAA,MAAMwB,SAAS,YAAfxB,mBAAmB,IAAIjG,IAAI;IACpD,MAAM+G,KAAKhH,QAAOkG,YAAAA,MAAMc,EAAE,YAARd,YAAY,IAAIjG,IAAI;IACtC,MAAM0H,SAAS3H,QAAOkG,gBAAAA,MAAMyB,MAAM,YAAZzB,gBAAgB,IAAIjG,IAAI;IAC9C,OAAO;QACL2H,MAAM;QACNtF;QACAkC,MAAMxE,QAAOkG,iBAAAA,MAAM2B,OAAO,YAAb3B,iBAAiB,IAAIzE,KAAK,CAAC,GAAG1C;QAC3C8H,WAAWX,MAAMW,SAAS;QAC1B1C,MAAM+B,MAAM/B,IAAI;OACZ6C,KAAK;QAAEA;IAAG,IAAI,CAAC;QACnBI,WAAWpH,QAAOkG,mBAAAA,MAAMkB,SAAS,YAAflB,mBAAmB,IAAIjG,IAAI;OACzCyH,YAAY;QAAEA;IAAU,IAAI,CAAC;QACjCI,eAAezF,iBAAiBC;QAChCyF,MAAM7B,MAAM6B,IAAI;QAChBC,OAAO9B,MAAM8B,KAAK;OACdL,SAAS;QAAEA;IAAO,IAAI,CAAC,GACvBF,KAAKQ,SAAS,GAAG;QAAEA,WAAWjI,OAAOyH,KAAKQ,SAAS;IAAE,IAAI,CAAC,GAC1DR,KAAKS,SAAS,GAAG;QAAEA,WAAWlI,OAAOyH,KAAKS,SAAS;IAAE,IAAI,CAAC,GAC1DT,KAAKU,MAAM,GAAG;QAAEA,QAAQnI,OAAOyH,KAAKU,MAAM;IAAE,IAAI,CAAC,GACjDV,KAAKW,MAAM,GAAG;QAAEA,QAAQpI,OAAOyH,KAAKW,MAAM;IAAE,IAAI,CAAC;QACrDC,QAAQnC,MAAMmC,MAAM;QACpBC,WAAW;eAAIpC,MAAMoC,SAAS;SAAC;;AAEnC"}

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

@@ -0,0 +1,73 @@
+/**
+ * @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 CRM's fixed vocabularies — lifecycle stages, task kinds, activity
+ * kinds — and the guards that check a value against them.
+ *
+ * A leaf module with no imports, re-exported by `crm.ts`, so every existing
+ * `crm` import keeps working. It is separate because the actions builder
+ * validates an automation step against these lists, and the actions builder
+ * ships with the element renderer to every published page: importing them
+ * from `crm.ts` put the whole CRM record model — companies, deals, tasks,
+ * the contact facet helpers it reads — in front of every visitor to check a
+ * string against a four-item list.
+ *
+ * Only the lists, their types, their guards and the task horizon live here.
+ * The on-screen labels stay in `crm.ts`, beside the records they describe.
+ */
+/**
+ * Where a person sits in the relationship, as one of a fixed list.
+ *
+ * A fixed list rather than free text so that a report can count people per
+ * stage and a filter can select one, and in the order a person usually moves
+ * through them so a picker reads as a progression. `other` is the escape
+ * hatch for a business whose funnel has a step none of these name; it is a
+ * deliberate stage, not an absent one.
+ */
+export declare const CONTACT_LIFECYCLE_STAGES: readonly ["subscriber", "lead", "marketing-qualified", "sales-qualified", "opportunity", "customer", "evangelist", "other"];
+export type ContactLifecycleStage = (typeof CONTACT_LIFECYCLE_STAGES)[number];
+export declare function isContactLifecycleStage(value: unknown): value is ContactLifecycleStage;
+/**
+ * What a task is, as a fixed list.
+ *
+ * A const array rather than a bare union because two surfaces have to
+ * enumerate it — the task form's picker and the automation step that creates
+ * a task without a form — and a union cannot be iterated at run time.
+ */
+export declare const CRM_TASK_KINDS: readonly ["call", "email", "meeting", "todo"];
+export type CrmTaskKind = (typeof CRM_TASK_KINDS)[number];
+export declare function isCrmTaskKind(value: unknown): value is CrmTaskKind;
+/**
+ * How far ahead an automation may date a task, in days.
+ *
+ * A year, because the longest follow-up anybody schedules from a trigger is
+ * an annual renewal check, and a task dated further out than that is one
+ * nobody will find on the list when it comes due.
+ */
+export declare const CRM_TASK_MAX_DUE_DAYS = 365;
+/**
+ * What a person can log, in the order the picker offers them (AGL-2600).
+ *
+ * A fixed list rather than free text for the reason the lifecycle stages are
+ * one: a report counts calls per week and a filter selects meetings, and
+ * neither can be done over a string somebody typed. `note` is the plain
+ * entry — something worth writing down that was not a conversation — and
+ * `other` the escape hatch for the kind none of these name.
+ */
+export declare const CRM_ACTIVITY_KINDS: readonly ["call", "email", "meeting", "note", "other"];
+export type CrmActivityKind = (typeof CRM_ACTIVITY_KINDS)[number];
+export declare function isCrmActivityKind(value: unknown): value is CrmActivityKind;

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

@@ -0,0 +1,92 @@
+/**
+ * @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 CRM's fixed vocabularies — lifecycle stages, task kinds, activity
+ * kinds — and the guards that check a value against them.
+ *
+ * A leaf module with no imports, re-exported by `crm.ts`, so every existing
+ * `crm` import keeps working. It is separate because the actions builder
+ * validates an automation step against these lists, and the actions builder
+ * ships with the element renderer to every published page: importing them
+ * from `crm.ts` put the whole CRM record model — companies, deals, tasks,
+ * the contact facet helpers it reads — in front of every visitor to check a
+ * string against a four-item list.
+ *
+ * Only the lists, their types, their guards and the task horizon live here.
+ * The on-screen labels stay in `crm.ts`, beside the records they describe.
+ */ /**
+ * Where a person sits in the relationship, as one of a fixed list.
+ *
+ * A fixed list rather than free text so that a report can count people per
+ * stage and a filter can select one, and in the order a person usually moves
+ * through them so a picker reads as a progression. `other` is the escape
+ * hatch for a business whose funnel has a step none of these name; it is a
+ * deliberate stage, not an absent one.
+ */ export const CONTACT_LIFECYCLE_STAGES = [
+    'subscriber',
+    'lead',
+    'marketing-qualified',
+    'sales-qualified',
+    'opportunity',
+    'customer',
+    'evangelist',
+    'other'
+];
+export function isContactLifecycleStage(value) {
+    return typeof value === 'string' && CONTACT_LIFECYCLE_STAGES.includes(value);
+}
+/**
+ * What a task is, as a fixed list.
+ *
+ * A const array rather than a bare union because two surfaces have to
+ * enumerate it — the task form's picker and the automation step that creates
+ * a task without a form — and a union cannot be iterated at run time.
+ */ export const CRM_TASK_KINDS = [
+    'call',
+    'email',
+    'meeting',
+    'todo'
+];
+export function isCrmTaskKind(value) {
+    return typeof value === 'string' && CRM_TASK_KINDS.includes(value);
+}
+/**
+ * How far ahead an automation may date a task, in days.
+ *
+ * A year, because the longest follow-up anybody schedules from a trigger is
+ * an annual renewal check, and a task dated further out than that is one
+ * nobody will find on the list when it comes due.
+ */ export const CRM_TASK_MAX_DUE_DAYS = 365;
+/**
+ * What a person can log, in the order the picker offers them (AGL-2600).
+ *
+ * A fixed list rather than free text for the reason the lifecycle stages are
+ * one: a report counts calls per week and a filter selects meetings, and
+ * neither can be done over a string somebody typed. `note` is the plain
+ * entry — something worth writing down that was not a conversation — and
+ * `other` the escape hatch for the kind none of these name.
+ */ export const CRM_ACTIVITY_KINDS = [
+    'call',
+    'email',
+    'meeting',
+    'note',
+    'other'
+];
+export function isCrmActivityKind(value) {
+    return typeof value === 'string' && CRM_ACTIVITY_KINDS.includes(value);
+}
+
+//# sourceMappingURL=crm-kinds.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../libs/aglyn/src/lib/app-utils/crm-kinds.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 CRM's fixed vocabularies — lifecycle stages, task kinds, activity\n * kinds — and the guards that check a value against them.\n *\n * A leaf module with no imports, re-exported by `crm.ts`, so every existing\n * `crm` import keeps working. It is separate because the actions builder\n * validates an automation step against these lists, and the actions builder\n * ships with the element renderer to every published page: importing them\n * from `crm.ts` put the whole CRM record model — companies, deals, tasks,\n * the contact facet helpers it reads — in front of every visitor to check a\n * string against a four-item list.\n *\n * Only the lists, their types, their guards and the task horizon live here.\n * The on-screen labels stay in `crm.ts`, beside the records they describe.\n */\n\n/**\n * Where a person sits in the relationship, as one of a fixed list.\n *\n * A fixed list rather than free text so that a report can count people per\n * stage and a filter can select one, and in the order a person usually moves\n * through them so a picker reads as a progression. `other` is the escape\n * hatch for a business whose funnel has a step none of these name; it is a\n * deliberate stage, not an absent one.\n */\nexport const CONTACT_LIFECYCLE_STAGES = [\n  'subscriber',\n  'lead',\n  'marketing-qualified',\n  'sales-qualified',\n  'opportunity',\n  'customer',\n  'evangelist',\n  'other',\n] as const\n\nexport type ContactLifecycleStage = (typeof CONTACT_LIFECYCLE_STAGES)[number]\n\nexport function isContactLifecycleStage(\n  value: unknown,\n): value is ContactLifecycleStage {\n  return (\n    typeof value === 'string' &&\n    (CONTACT_LIFECYCLE_STAGES as readonly string[]).includes(value)\n  )\n}\n\n/**\n * What a task is, as a fixed list.\n *\n * A const array rather than a bare union because two surfaces have to\n * enumerate it — the task form's picker and the automation step that creates\n * a task without a form — and a union cannot be iterated at run time.\n */\nexport const CRM_TASK_KINDS = ['call', 'email', 'meeting', 'todo'] as const\nexport type CrmTaskKind = (typeof CRM_TASK_KINDS)[number]\n\nexport function isCrmTaskKind(value: unknown): value is CrmTaskKind {\n  return (\n    typeof value === 'string' &&\n    (CRM_TASK_KINDS as readonly string[]).includes(value)\n  )\n}\n\n/**\n * How far ahead an automation may date a task, in days.\n *\n * A year, because the longest follow-up anybody schedules from a trigger is\n * an annual renewal check, and a task dated further out than that is one\n * nobody will find on the list when it comes due.\n */\nexport const CRM_TASK_MAX_DUE_DAYS = 365\n\n/**\n * What a person can log, in the order the picker offers them (AGL-2600).\n *\n * A fixed list rather than free text for the reason the lifecycle stages are\n * one: a report counts calls per week and a filter selects meetings, and\n * neither can be done over a string somebody typed. `note` is the plain\n * entry — something worth writing down that was not a conversation — and\n * `other` the escape hatch for the kind none of these name.\n */\nexport const CRM_ACTIVITY_KINDS = ['call', 'email', 'meeting', 'note', 'other'] as const\n\nexport type CrmActivityKind = (typeof CRM_ACTIVITY_KINDS)[number]\n\nexport function isCrmActivityKind(value: unknown): value is CrmActivityKind {\n  return (\n    typeof value === 'string' &&\n    (CRM_ACTIVITY_KINDS as readonly string[]).includes(value)\n  )\n}\n"],"names":["CONTACT_LIFECYCLE_STAGES","isContactLifecycleStage","value","includes","CRM_TASK_KINDS","isCrmTaskKind","CRM_TASK_MAX_DUE_DAYS","CRM_ACTIVITY_KINDS","isCrmActivityKind"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED;;;;;;;;;;;;;;CAcC,GAED;;;;;;;;CAQC,GACD,OAAO,MAAMA,2BAA2B;IACtC;IACA;IACA;IACA;IACA;IACA;IACA;IACA;CACD,CAAS;AAIV,OAAO,SAASC,wBACdC,KAAc;IAEd,OACE,OAAOA,UAAU,YACjB,AAACF,yBAA+CG,QAAQ,CAACD;AAE7D;AAEA;;;;;;CAMC,GACD,OAAO,MAAME,iBAAiB;IAAC;IAAQ;IAAS;IAAW;CAAO,CAAS;AAG3E,OAAO,SAASC,cAAcH,KAAc;IAC1C,OACE,OAAOA,UAAU,YACjB,AAACE,eAAqCD,QAAQ,CAACD;AAEnD;AAEA;;;;;;CAMC,GACD,OAAO,MAAMI,wBAAwB,IAAG;AAExC;;;;;;;;CAQC,GACD,OAAO,MAAMC,qBAAqB;IAAC;IAAQ;IAAS;IAAW;IAAQ;CAAQ,CAAS;AAIxF,OAAO,SAASC,kBAAkBN,KAAc;IAC9C,OACE,OAAOA,UAAU,YACjB,AAACK,mBAAyCJ,QAAQ,CAACD;AAEvD"}

package/src/lib/app-utils/crm-next-activity.d.ts

@@ -0,0 +1,107 @@
+/**
+ * @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.
+ */
+/**
+ * NEXT ACTIVITY (AGL-2661): when the earliest open task against a record
+ * is due, denormalized onto the record as `nextTaskAtMs`.
+ *
+ * The question a sales manager asks of a LIST — "which deals have nothing
+ * scheduled?" — cannot be answered by a task query per row, so every
+ * contact, company and deal carries the answer. This module is the pure
+ * half: what the value IS given a record's open tasks, how a stored one is
+ * read back, the view clause a list filters on, and the report figure. The
+ * admin library's `recomputeCrmNextTaskAt` is the writer; the console's
+ * route is its door for client-direct task writes.
+ */
+import type { CrmDeal, CrmTask, CrmViewFilterClause } from './crm';
+/** The field on a contact, a company and a deal — the one name every list reads. */
+export declare const CRM_NEXT_ACTIVITY_FIELD = "nextTaskAtMs";
+/**
+ * The records one task can be filed against — the ids a recompute reads
+ * off a task, and the three collections it writes to.
+ */
+export interface CrmNextActivityLink {
+    contactId?: string;
+    companyId?: string;
+    dealId?: string;
+}
+/** How the collections are keyed on a task, in the order a recompute walks them. */
+export declare const CRM_NEXT_ACTIVITY_LINK_FIELDS: readonly ["contactId", "companyId", "dealId"];
+export type CrmNextActivityLinkField = (typeof CRM_NEXT_ACTIVITY_LINK_FIELDS)[number];
+/**
+ * When the earliest OPEN task in the list is due, or `null`.
+ *
+ * Only an open task with a finite due time counts: a done task is history,
+ * and an open one with no date is a to-do with no "next" about it — the
+ * record's next activity is unknown rather than immediate, and `null`
+ * says so. A pre-change writer never produced a time outside the finite
+ * range, but a stored `dueAtMs` is trusted no further than that.
+ */
+export declare function nextTaskAtMsOf(tasks: readonly Pick<CrmTask, 'status' | 'dueAtMs'>[]): number | null;
+/**
+ * A stored `nextTaskAtMs`, read back: a finite positive number, else
+ * `null`. Absent — a record written before the field existed — reads as
+ * `null` too, because to every reader "not yet computed" and "nothing
+ * scheduled" draw the same dash; the Fields section's recompute is what
+ * closes the gap for a filter that asks the store rather than the row.
+ */
+export declare function readNextTaskAtMs(record: {
+    nextTaskAtMs?: unknown;
+} | null | undefined): number | null;
+/** Whether nothing is scheduled against the record — the "stuck" test. */
+export declare function hasNoNextActivity(record: {
+    nextTaskAtMs?: unknown;
+} | null | undefined): boolean;
+/** The links one task carries, with the blanks left out. */
+export declare function nextActivityLinksOfTask(task: Partial<Pick<CrmTask, CrmNextActivityLinkField>> | null | undefined): CrmNextActivityLink;
+/**
+ * Several links as one per record, so a bulk action over forty tasks on
+ * one deal recomputes that deal once. Order is first-seen.
+ */
+export declare function mergeNextActivityLinks(links: readonly (CrmNextActivityLink | null | undefined)[]): Array<{
+    field: CrmNextActivityLinkField;
+    id: string;
+}>;
+/**
+ * The saved-view clause "No next activity" is stored as — one clause,
+ * spelled once, so the toggle a list draws and the matcher it runs agree
+ * on the name. `isEmpty` is honest here: a recompute writes `null` for a
+ * record with nothing scheduled, and a record never written reads blank
+ * too (see `readNextTaskAtMs`).
+ */
+export declare const CRM_NO_NEXT_ACTIVITY_CLAUSE: Readonly<CrmViewFilterClause>;
+export declare function isNoNextActivityClause(clause: Pick<CrmViewFilterClause, 'field' | 'op'>): boolean;
+/** A view's filters with the clause switched on or off, the rest untouched. */
+export declare function withNoNextActivity(filters: readonly CrmViewFilterClause[], on: boolean): CrmViewFilterClause[];
+/**
+ * The rows a "No next activity" clause keeps: every one when the view does
+ * not carry it, else those with nothing scheduled. What a list that
+ * filters through a query — companies, deals — runs over the page it
+ * loaded, the way the contacts list runs its window-only clauses.
+ */
+export declare function filterByNextActivity<T extends {
+    nextTaskAtMs?: unknown;
+}>(rows: readonly T[], filters: readonly CrmViewFilterClause[]): T[];
+/**
+ * The report figure: how many OPEN deals have nothing scheduled, and which
+ * (AGL-2661). A won deal needs no next step and a lost one has none, so
+ * only open deals are stuck; the caller hands in the window it already
+ * reads for the pipeline card, so this costs no read of its own.
+ */
+export declare function stuckDeals<T extends Pick<CrmDeal, 'status' | 'nextTaskAtMs'>>(deals: readonly T[]): {
+    count: number;
+    deals: T[];
+};

package/src/lib/app-utils/crm-next-activity.js

@@ -0,0 +1,140 @@
+/**
+ * @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.
+ */ /**
+ * NEXT ACTIVITY (AGL-2661): when the earliest open task against a record
+ * is due, denormalized onto the record as `nextTaskAtMs`.
+ *
+ * The question a sales manager asks of a LIST — "which deals have nothing
+ * scheduled?" — cannot be answered by a task query per row, so every
+ * contact, company and deal carries the answer. This module is the pure
+ * half: what the value IS given a record's open tasks, how a stored one is
+ * read back, the view clause a list filters on, and the report figure. The
+ * admin library's `recomputeCrmNextTaskAt` is the writer; the console's
+ * route is its door for client-direct task writes.
+ */ import { _ as _extends } from "@swc/helpers/_/_extends";
+/** The field on a contact, a company and a deal — the one name every list reads. */ export const CRM_NEXT_ACTIVITY_FIELD = 'nextTaskAtMs';
+/** How the collections are keyed on a task, in the order a recompute walks them. */ export const CRM_NEXT_ACTIVITY_LINK_FIELDS = [
+    'contactId',
+    'companyId',
+    'dealId'
+];
+/**
+ * When the earliest OPEN task in the list is due, or `null`.
+ *
+ * Only an open task with a finite due time counts: a done task is history,
+ * and an open one with no date is a to-do with no "next" about it — the
+ * record's next activity is unknown rather than immediate, and `null`
+ * says so. A pre-change writer never produced a time outside the finite
+ * range, but a stored `dueAtMs` is trusted no further than that.
+ */ export function nextTaskAtMsOf(tasks) {
+    let earliest = null;
+    for (const task of tasks){
+        if (task.status !== 'open') continue;
+        const due = task.dueAtMs;
+        if (typeof due !== 'number' || !Number.isFinite(due)) continue;
+        if (earliest === null || due < earliest) earliest = due;
+    }
+    return earliest;
+}
+/**
+ * A stored `nextTaskAtMs`, read back: a finite positive number, else
+ * `null`. Absent — a record written before the field existed — reads as
+ * `null` too, because to every reader "not yet computed" and "nothing
+ * scheduled" draw the same dash; the Fields section's recompute is what
+ * closes the gap for a filter that asks the store rather than the row.
+ */ export function readNextTaskAtMs(record) {
+    const value = record == null ? void 0 : record.nextTaskAtMs;
+    return typeof value === 'number' && Number.isFinite(value) && value > 0 ? value : null;
+}
+/** Whether nothing is scheduled against the record — the "stuck" test. */ export function hasNoNextActivity(record) {
+    return readNextTaskAtMs(record) === null;
+}
+/** The links one task carries, with the blanks left out. */ export function nextActivityLinksOfTask(task) {
+    const link = {};
+    for (const field of CRM_NEXT_ACTIVITY_LINK_FIELDS){
+        var _ref;
+        const id = String((_ref = task == null ? void 0 : task[field]) != null ? _ref : '').trim();
+        if (id) link[field] = id;
+    }
+    return link;
+}
+/**
+ * Several links as one per record, so a bulk action over forty tasks on
+ * one deal recomputes that deal once. Order is first-seen.
+ */ export function mergeNextActivityLinks(links) {
+    const seen = new Set();
+    const merged = [];
+    for (const link of links){
+        for (const field of CRM_NEXT_ACTIVITY_LINK_FIELDS){
+            var _ref;
+            const id = String((_ref = link == null ? void 0 : link[field]) != null ? _ref : '').trim();
+            if (!id) continue;
+            const key = `${field}:${id}`;
+            if (seen.has(key)) continue;
+            seen.add(key);
+            merged.push({
+                field,
+                id
+            });
+        }
+    }
+    return merged;
+}
+/**
+ * The saved-view clause "No next activity" is stored as — one clause,
+ * spelled once, so the toggle a list draws and the matcher it runs agree
+ * on the name. `isEmpty` is honest here: a recompute writes `null` for a
+ * record with nothing scheduled, and a record never written reads blank
+ * too (see `readNextTaskAtMs`).
+ */ export const CRM_NO_NEXT_ACTIVITY_CLAUSE = Object.freeze({
+    field: CRM_NEXT_ACTIVITY_FIELD,
+    op: 'isEmpty',
+    value: ''
+});
+export function isNoNextActivityClause(clause) {
+    return clause.field === CRM_NEXT_ACTIVITY_FIELD && clause.op === 'isEmpty';
+}
+/** A view's filters with the clause switched on or off, the rest untouched. */ export function withNoNextActivity(filters, on) {
+    const rest = filters.filter((clause)=>!isNoNextActivityClause(clause));
+    return on ? [
+        ...rest,
+        _extends({}, CRM_NO_NEXT_ACTIVITY_CLAUSE)
+    ] : rest;
+}
+/**
+ * The rows a "No next activity" clause keeps: every one when the view does
+ * not carry it, else those with nothing scheduled. What a list that
+ * filters through a query — companies, deals — runs over the page it
+ * loaded, the way the contacts list runs its window-only clauses.
+ */ export function filterByNextActivity(rows, filters) {
+    return filters.some(isNoNextActivityClause) ? rows.filter(hasNoNextActivity) : [
+        ...rows
+    ];
+}
+/**
+ * The report figure: how many OPEN deals have nothing scheduled, and which
+ * (AGL-2661). A won deal needs no next step and a lost one has none, so
+ * only open deals are stuck; the caller hands in the window it already
+ * reads for the pipeline card, so this costs no read of its own.
+ */ export function stuckDeals(deals) {
+    const stuck = deals.filter((deal)=>deal.status === 'open' && hasNoNextActivity(deal));
+    return {
+        count: stuck.length,
+        deals: stuck
+    };
+}
+
+//# sourceMappingURL=crm-next-activity.js.map

package/src/lib/app-utils/crm-next-activity.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../libs/aglyn/src/lib/app-utils/crm-next-activity.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 * NEXT ACTIVITY (AGL-2661): when the earliest open task against a record\n * is due, denormalized onto the record as `nextTaskAtMs`.\n *\n * The question a sales manager asks of a LIST — \"which deals have nothing\n * scheduled?\" — cannot be answered by a task query per row, so every\n * contact, company and deal carries the answer. This module is the pure\n * half: what the value IS given a record's open tasks, how a stored one is\n * read back, the view clause a list filters on, and the report figure. The\n * admin library's `recomputeCrmNextTaskAt` is the writer; the console's\n * route is its door for client-direct task writes.\n */\n\nimport type { CrmDeal, CrmTask, CrmViewFilterClause } from './crm'\n\n/** The field on a contact, a company and a deal — the one name every list reads. */\nexport const CRM_NEXT_ACTIVITY_FIELD = 'nextTaskAtMs'\n\n/**\n * The records one task can be filed against — the ids a recompute reads\n * off a task, and the three collections it writes to.\n */\nexport interface CrmNextActivityLink {\n  contactId?: string\n  companyId?: string\n  dealId?: string\n}\n\n/** How the collections are keyed on a task, in the order a recompute walks them. */\nexport const CRM_NEXT_ACTIVITY_LINK_FIELDS = ['contactId', 'companyId', 'dealId'] as const\n\nexport type CrmNextActivityLinkField = (typeof CRM_NEXT_ACTIVITY_LINK_FIELDS)[number]\n\n/**\n * When the earliest OPEN task in the list is due, or `null`.\n *\n * Only an open task with a finite due time counts: a done task is history,\n * and an open one with no date is a to-do with no \"next\" about it — the\n * record's next activity is unknown rather than immediate, and `null`\n * says so. A pre-change writer never produced a time outside the finite\n * range, but a stored `dueAtMs` is trusted no further than that.\n */\nexport function nextTaskAtMsOf(\n  tasks: readonly Pick<CrmTask, 'status' | 'dueAtMs'>[],\n): number | null {\n  let earliest: number | null = null\n  for (const task of tasks) {\n    if (task.status !== 'open') continue\n    const due = task.dueAtMs\n    if (typeof due !== 'number' || !Number.isFinite(due)) continue\n    if (earliest === null || due < earliest) earliest = due\n  }\n  return earliest\n}\n\n/**\n * A stored `nextTaskAtMs`, read back: a finite positive number, else\n * `null`. Absent — a record written before the field existed — reads as\n * `null` too, because to every reader \"not yet computed\" and \"nothing\n * scheduled\" draw the same dash; the Fields section's recompute is what\n * closes the gap for a filter that asks the store rather than the row.\n */\nexport function readNextTaskAtMs(\n  record: { nextTaskAtMs?: unknown } | null | undefined,\n): number | null {\n  const value = record?.nextTaskAtMs\n  return typeof value === 'number' && Number.isFinite(value) && value > 0 ? value : null\n}\n\n/** Whether nothing is scheduled against the record — the \"stuck\" test. */\nexport function hasNoNextActivity(\n  record: { nextTaskAtMs?: unknown } | null | undefined,\n): boolean {\n  return readNextTaskAtMs(record) === null\n}\n\n/** The links one task carries, with the blanks left out. */\nexport function nextActivityLinksOfTask(\n  task: Partial<Pick<CrmTask, CrmNextActivityLinkField>> | null | undefined,\n): CrmNextActivityLink {\n  const link: CrmNextActivityLink = {}\n  for (const field of CRM_NEXT_ACTIVITY_LINK_FIELDS) {\n    const id = String(task?.[field] ?? '').trim()\n    if (id) link[field] = id\n  }\n  return link\n}\n\n/**\n * Several links as one per record, so a bulk action over forty tasks on\n * one deal recomputes that deal once. Order is first-seen.\n */\nexport function mergeNextActivityLinks(\n  links: readonly (CrmNextActivityLink | null | undefined)[],\n): Array<{ field: CrmNextActivityLinkField; id: string }> {\n  const seen = new Set<string>()\n  const merged: Array<{ field: CrmNextActivityLinkField; id: string }> = []\n  for (const link of links) {\n    for (const field of CRM_NEXT_ACTIVITY_LINK_FIELDS) {\n      const id = String(link?.[field] ?? '').trim()\n      if (!id) continue\n      const key = `${field}:${id}`\n      if (seen.has(key)) continue\n      seen.add(key)\n      merged.push({ field, id })\n    }\n  }\n  return merged\n}\n\n/**\n * The saved-view clause \"No next activity\" is stored as — one clause,\n * spelled once, so the toggle a list draws and the matcher it runs agree\n * on the name. `isEmpty` is honest here: a recompute writes `null` for a\n * record with nothing scheduled, and a record never written reads blank\n * too (see `readNextTaskAtMs`).\n */\nexport const CRM_NO_NEXT_ACTIVITY_CLAUSE: Readonly<CrmViewFilterClause> = Object.freeze({\n  field: CRM_NEXT_ACTIVITY_FIELD,\n  op: 'isEmpty',\n  value: '',\n})\n\nexport function isNoNextActivityClause(clause: Pick<CrmViewFilterClause, 'field' | 'op'>): boolean {\n  return clause.field === CRM_NEXT_ACTIVITY_FIELD && clause.op === 'isEmpty'\n}\n\n/** A view's filters with the clause switched on or off, the rest untouched. */\nexport function withNoNextActivity(\n  filters: readonly CrmViewFilterClause[],\n  on: boolean,\n): CrmViewFilterClause[] {\n  const rest = filters.filter((clause) => !isNoNextActivityClause(clause))\n  return on ? [...rest, { ...CRM_NO_NEXT_ACTIVITY_CLAUSE }] : rest\n}\n\n/**\n * The rows a \"No next activity\" clause keeps: every one when the view does\n * not carry it, else those with nothing scheduled. What a list that\n * filters through a query — companies, deals — runs over the page it\n * loaded, the way the contacts list runs its window-only clauses.\n */\nexport function filterByNextActivity<T extends { nextTaskAtMs?: unknown }>(\n  rows: readonly T[],\n  filters: readonly CrmViewFilterClause[],\n): T[] {\n  return filters.some(isNoNextActivityClause) ? rows.filter(hasNoNextActivity) : [...rows]\n}\n\n/**\n * The report figure: how many OPEN deals have nothing scheduled, and which\n * (AGL-2661). A won deal needs no next step and a lost one has none, so\n * only open deals are stuck; the caller hands in the window it already\n * reads for the pipeline card, so this costs no read of its own.\n */\nexport function stuckDeals<T extends Pick<CrmDeal, 'status' | 'nextTaskAtMs'>>(\n  deals: readonly T[],\n): { count: number; deals: T[] } {\n  const stuck = deals.filter((deal) => deal.status === 'open' && hasNoNextActivity(deal))\n  return { count: stuck.length, deals: stuck }\n}\n"],"names":["CRM_NEXT_ACTIVITY_FIELD","CRM_NEXT_ACTIVITY_LINK_FIELDS","nextTaskAtMsOf","tasks","earliest","task","status","due","dueAtMs","Number","isFinite","readNextTaskAtMs","record","value","nextTaskAtMs","hasNoNextActivity","nextActivityLinksOfTask","link","field","id","String","trim","mergeNextActivityLinks","links","seen","Set","merged","key","has","add","push","CRM_NO_NEXT_ACTIVITY_CLAUSE","Object","freeze","op","isNoNextActivityClause","clause","withNoNextActivity","filters","on","rest","filter","filterByNextActivity","rows","some","stuckDeals","deals","stuck","deal","count","length"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED;;;;;;;;;;;CAWC;AAID,kFAAkF,GAClF,OAAO,MAAMA,0BAA0B,eAAc;AAYrD,kFAAkF,GAClF,OAAO,MAAMC,gCAAgC;IAAC;IAAa;IAAa;CAAS,CAAS;AAI1F;;;;;;;;CAQC,GACD,OAAO,SAASC,eACdC,KAAqD;IAErD,IAAIC,WAA0B;IAC9B,KAAK,MAAMC,QAAQF,MAAO;QACxB,IAAIE,KAAKC,MAAM,KAAK,QAAQ;QAC5B,MAAMC,MAAMF,KAAKG,OAAO;QACxB,IAAI,OAAOD,QAAQ,YAAY,CAACE,OAAOC,QAAQ,CAACH,MAAM;QACtD,IAAIH,aAAa,QAAQG,MAAMH,UAAUA,WAAWG;IACtD;IACA,OAAOH;AACT;AAEA;;;;;;CAMC,GACD,OAAO,SAASO,iBACdC,MAAqD;IAErD,MAAMC,QAAQD,0BAAAA,OAAQE,YAAY;IAClC,OAAO,OAAOD,UAAU,YAAYJ,OAAOC,QAAQ,CAACG,UAAUA,QAAQ,IAAIA,QAAQ;AACpF;AAEA,wEAAwE,GACxE,OAAO,SAASE,kBACdH,MAAqD;IAErD,OAAOD,iBAAiBC,YAAY;AACtC;AAEA,0DAA0D,GAC1D,OAAO,SAASI,wBACdX,IAAyE;IAEzE,MAAMY,OAA4B,CAAC;IACnC,KAAK,MAAMC,SAASjB,8BAA+B;;QACjD,MAAMkB,KAAKC,eAAOf,wBAAAA,IAAM,CAACa,MAAM,mBAAI,IAAIG,IAAI;QAC3C,IAAIF,IAAIF,IAAI,CAACC,MAAM,GAAGC;IACxB;IACA,OAAOF;AACT;AAEA;;;CAGC,GACD,OAAO,SAASK,uBACdC,KAA0D;IAE1D,MAAMC,OAAO,IAAIC;IACjB,MAAMC,SAAiE,EAAE;IACzE,KAAK,MAAMT,QAAQM,MAAO;QACxB,KAAK,MAAML,SAASjB,8BAA+B;;YACjD,MAAMkB,KAAKC,eAAOH,wBAAAA,IAAM,CAACC,MAAM,mBAAI,IAAIG,IAAI;YAC3C,IAAI,CAACF,IAAI;YACT,MAAMQ,MAAM,GAAGT,MAAM,CAAC,EAAEC,IAAI;YAC5B,IAAIK,KAAKI,GAAG,CAACD,MAAM;YACnBH,KAAKK,GAAG,CAACF;YACTD,OAAOI,IAAI,CAAC;gBAAEZ;gBAAOC;YAAG;QAC1B;IACF;IACA,OAAOO;AACT;AAEA;;;;;;CAMC,GACD,OAAO,MAAMK,8BAA6DC,OAAOC,MAAM,CAAC;IACtFf,OAAOlB;IACPkC,IAAI;IACJrB,OAAO;AACT,GAAE;AAEF,OAAO,SAASsB,uBAAuBC,MAAiD;IACtF,OAAOA,OAAOlB,KAAK,KAAKlB,2BAA2BoC,OAAOF,EAAE,KAAK;AACnE;AAEA,6EAA6E,GAC7E,OAAO,SAASG,mBACdC,OAAuC,EACvCC,EAAW;IAEX,MAAMC,OAAOF,QAAQG,MAAM,CAAC,CAACL,SAAW,CAACD,uBAAuBC;IAChE,OAAOG,KAAK;WAAIC;QAAM,aAAKT;KAA8B,GAAGS;AAC9D;AAEA;;;;;CAKC,GACD,OAAO,SAASE,qBACdC,IAAkB,EAClBL,OAAuC;IAEvC,OAAOA,QAAQM,IAAI,CAACT,0BAA0BQ,KAAKF,MAAM,CAAC1B,qBAAqB;WAAI4B;KAAK;AAC1F;AAEA;;;;;CAKC,GACD,OAAO,SAASE,WACdC,KAAmB;IAEnB,MAAMC,QAAQD,MAAML,MAAM,CAAC,CAACO,OAASA,KAAK1C,MAAM,KAAK,UAAUS,kBAAkBiC;IACjF,OAAO;QAAEC,OAAOF,MAAMG,MAAM;QAAEJ,OAAOC;IAAM;AAC7C"}