@aglyn/plugins-crm 1.0.0-beta.218 → 1.0.0-beta.220

package/src/lib/model/crm-import.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../../libs/plugins/crm/src/lib/model/crm-import.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 * BRINGING A SPREADSHEET OF PEOPLE INTO THE CRM — the pure half (AGL-2602).\n *\n * A merchant arriving from another CRM has a CSV: a header row naming\n * columns in that product's vocabulary, and one person per line. Nothing\n * about that file is in our shape. This module is every decision about the\n * file that needs no Firestore and no React — which columns mean what, how a\n * cell becomes a stored value, and what to say about a row that cannot be\n * stored — so that the console drawer and the server route read the same\n * rules rather than two copies of them.\n *\n * ## Three stages, and only the last one touches a record\n *\n *  1. {@link guessContactImportMapping} reads the header and proposes a\n *     column → field mapping from a table of aliases. It is a PROPOSAL: the\n *     drawer shows it and the operator corrects it, because an export's\n *     \"Company\" column may hold a job title and no alias table can know.\n *  2. {@link mapContactImportRow} applies the mapping to one line, producing\n *     the raw row the browser posts. Strings only — the browser trims nothing\n *     and validates nothing, so the server is the one place the file is\n *     judged and a stale drawer cannot judge it differently.\n *  3. {@link normalizeContactImportRow} turns a raw row into the values that\n *     will be written, through the SAME normalizers every other door uses:\n *     `normalizeContactEmail` for the dedupe key, `normalizePhone` for E.164,\n *     `normalizeAddress` for the postal shape, `isContactLifecycleStage` for\n *     the stage. An importer with its own idea of a valid phone number is how\n *     one collection ends up storing a value three ways.\n *\n * ## A bad cell is dropped and named; a bad row is skipped and named\n *\n * The only thing that makes a row unstorable is an unusable address, because\n * the address is the identity the shared row is keyed by. Everything else is\n * a value on the row: a phone that cannot be read as a number is left off\n * the contact and REPORTED under {@link ContactImportRow.dropped}, so the\n * operator learns that forty rows had a phone in a format we could not read\n * rather than discovering, weeks later, that the phone column silently went\n * nowhere. `list-import.ts` applies the same rule to a line that is not an\n * address: reported, never quietly discarded.\n *\n * ## Ceilings are on the work, never on the audience\n *\n * {@link CONTACT_IMPORT_MAX_ROWS} bounds one FILE, and the drawer says so\n * before anything is sent. {@link CONTACT_IMPORT_CHUNK_SIZE} bounds one\n * REQUEST, so a five-thousand-row file is twenty-five requests with a\n * progress bar between them rather than one that times out halfway with no\n * record of what it did. Neither one ever trims a person to fit: a row past\n * the file ceiling is refused with the file, and a row is never dropped to\n * make a chunk smaller. The audience band is enforced where every capture\n * enforces it — inside `upsertHostContact` — and an import reports that\n * refusal per row rather than pre-empting it with a count of its own.\n */\n\nimport type { AglynPostalAddress } from '@aglyn/aglyn/foundation/definitions/contact.types'\nimport { normalizeAddress, normalizePhone } from '@aglyn/aglyn/foundation/definitions/contact.types'\nimport { normalizeContactEmail } from '@aglyn/aglyn/app-utils/contacts'\nimport {\n  CSV_IMPORT_CHUNK_SIZE,\n  CSV_IMPORT_MAX_BODY_BYTES,\n  CSV_IMPORT_MAX_ROWS,\n  CSV_IMPORT_PREVIEW_ROWS,\n  customImportTarget,\n  customImportTargetKey,\n  emptyImportResult,\n  guessImportMapping,\n  importAliasKeys,\n  type ImportChunkResult,\n  type ImportDroppedValue,\n  importSkippedCsv,\n  importTextValue,\n  mapImportRow,\n  mergeImportResults,\n  parseImportFlag,\n  parseImportTags,\n} from '@aglyn/aglyn/app-utils/csv-import'\nimport {\n  CONTACT_LIFECYCLE_STAGE_LABELS,\n  CONTACT_LIFECYCLE_STAGES,\n  type ContactCustomValue,\n  type ContactFieldDefinition,\n  type ContactLifecycleStage,\n  isContactLifecycleStage,\n} from '@aglyn/aglyn/app-utils/crm'\n\n/*\n * The custom-target grammar is the shared module's; it is re-exported here\n * because every reader of a contact mapping has always taken it from this\n * file, and the companies import reads the same two functions from theirs.\n */\nexport { customImportTarget, customImportTargetKey } from '@aglyn/aglyn/app-utils/csv-import'\n\n/**\n * The ceilings are the shared ones (`csv-import.ts`), under the names this\n * file has always exported: one file, one request and one preview are\n * bounded the same way for every collection, because the bounds are about\n * the browser's memory and a request's budget rather than about people.\n */\nexport const CONTACT_IMPORT_MAX_ROWS = CSV_IMPORT_MAX_ROWS\n\nexport const CONTACT_IMPORT_CHUNK_SIZE = CSV_IMPORT_CHUNK_SIZE\n\nexport const CONTACT_IMPORT_MAX_BODY_BYTES = CSV_IMPORT_MAX_BODY_BYTES\n\nexport const CONTACT_IMPORT_PREVIEW_ROWS = CSV_IMPORT_PREVIEW_ROWS\n\n/**\n * The most tags one row may carry — the profile drawer's own cap, so an\n * imported person cannot hold more tags than a hand-edited one.\n */\nexport const CONTACT_IMPORT_TAGS_MAX = 20\n\n/** The longest text a name, title, company name or custom text value keeps. */\nconst NAME_MAX = 120\nconst CUSTOM_TEXT_MAX = 1_000\n\n/**\n * The standard fields a column may be mapped to, in the order the mapping\n * menu lists them. A custom field is mapped by its key — see\n * {@link ContactImportTargetId}.\n */\nexport const CONTACT_IMPORT_FIELDS = [\n  'email',\n  'name',\n  'phone',\n  'jobTitle',\n  'companyName',\n  'addressLine1',\n  'addressLine2',\n  'addressCity',\n  'addressState',\n  'addressPostalCode',\n  'addressCountry',\n  'tags',\n  'ownerEmail',\n  'lifecycleStage',\n  'marketingConsent',\n] as const\n\nexport type ContactImportField = (typeof CONTACT_IMPORT_FIELDS)[number]\n\n/** How each field reads in the mapping menu. Typed so a field cannot ship unlabeled. */\nexport const CONTACT_IMPORT_FIELD_LABELS: Record<ContactImportField, string> = {\n  email: 'Email (required)',\n  name: 'Name',\n  phone: 'Phone',\n  jobTitle: 'Job title',\n  companyName: 'Company name',\n  addressLine1: 'Address line 1',\n  addressLine2: 'Address line 2',\n  addressCity: 'City',\n  addressState: 'State or region',\n  addressPostalCode: 'Postal code',\n  addressCountry: 'Country (two-letter code)',\n  tags: 'Tags (comma or | separated)',\n  ownerEmail: 'Owner (team member email)',\n  lifecycleStage: 'Lifecycle stage',\n  marketingConsent: 'Marketing consent (yes/no)',\n}\n\n/**\n * Header aliases per field, matched after `importHeaderKey` normalization.\n *\n * The vocabulary of the exports people actually arrive with — HubSpot's\n * \"First Name\"/\"Last Name\" pair is deliberately NOT here, because two columns\n * cannot map to one field and a guess that took only the first name would\n * store half a name and look right in the preview. An operator with a split\n * name maps one of the two by hand, and the preview shows what they chose.\n */\nconst FIELD_ALIASES: Record<ContactImportField, readonly string[]> = {\n  email: [\n    'email',\n    'email address',\n    'e-mail',\n    'e-mail address',\n    'contact email',\n    'primary email',\n    'work email',\n  ],\n  name: ['name', 'full name', 'contact name', 'display name', 'person'],\n  phone: [\n    'phone',\n    'phone number',\n    'telephone',\n    'mobile',\n    'mobile phone',\n    'cell',\n    'work phone',\n  ],\n  jobTitle: ['job title', 'title', 'position', 'role'],\n  companyName: ['company', 'company name', 'organization', 'organisation', 'account'],\n  addressLine1: ['address', 'address line 1', 'street', 'street address', 'address 1'],\n  addressLine2: ['address line 2', 'address 2', 'street 2', 'apartment', 'suite'],\n  addressCity: ['city', 'town', 'locality'],\n  addressState: ['state', 'region', 'province', 'county', 'state/region'],\n  addressPostalCode: ['postal code', 'postcode', 'zip', 'zip code', 'post code'],\n  addressCountry: ['country', 'country code', 'country/region'],\n  tags: ['tags', 'tag', 'labels', 'groups', 'segments'],\n  ownerEmail: ['owner', 'owner email', 'contact owner', 'assigned to', 'account owner'],\n  lifecycleStage: ['lifecycle stage', 'stage', 'lifecycle', 'status', 'lead status'],\n  marketingConsent: [\n    'marketing consent',\n    'consent',\n    'opt in',\n    'opt-in',\n    'opted in',\n    'subscribed',\n    'marketing opt in',\n    'email consent',\n  ],\n}\n\n/**\n * What a column is mapped to: a standard field by name, or a custom field\n * as `custom:<key>` — see `customImportTarget`.\n */\nexport type ContactImportTargetId = ContactImportField | `custom:${string}`\n\n/** Column index → target. A column absent from the map is not imported. */\nexport type ContactImportMapping = Record<number, ContactImportTargetId>\n\n/** {@link FIELD_ALIASES}, normalized once for the matcher. */\nconst FIELD_ALIAS_KEYS = importAliasKeys(CONTACT_IMPORT_FIELDS, FIELD_ALIASES)\n\n/**\n * A proposed mapping from a file's header row — the shared matcher over the\n * contact vocabulary. Custom fields win over standard aliases when a header\n * matches a definition's label or key exactly: a merchant who defined a\n * field called \"Status\" meant THEIR status, not our lifecycle stage.\n */\nexport function guessContactImportMapping(\n  columns: readonly string[],\n  fields: readonly Pick<ContactFieldDefinition, 'key' | 'label'>[] = [],\n): ContactImportMapping {\n  return guessImportMapping(columns, CONTACT_IMPORT_FIELDS, FIELD_ALIAS_KEYS, fields)\n}\n\n/**\n * What the browser posts for one line: the cells the mapping selected,\n * under the field they were mapped to, verbatim.\n *\n * Values are `unknown` because the server reads this off an untrusted body;\n * the mapper below only ever writes strings into it.\n */\nexport interface ContactImportRawRow {\n  email?: unknown\n  name?: unknown\n  phone?: unknown\n  jobTitle?: unknown\n  companyName?: unknown\n  addressLine1?: unknown\n  addressLine2?: unknown\n  addressCity?: unknown\n  addressState?: unknown\n  addressPostalCode?: unknown\n  addressCountry?: unknown\n  tags?: unknown\n  ownerEmail?: unknown\n  lifecycleStage?: unknown\n  marketingConsent?: unknown\n  /** Custom values keyed by definition key. */\n  custom?: unknown\n}\n\n/** One parsed line under the mapping. Empty cells are left absent. */\nexport function mapContactImportRow(\n  cells: readonly string[],\n  mapping: ContactImportMapping,\n): ContactImportRawRow {\n  return mapImportRow(cells, mapping)\n}\n\n/** Why one row was not stored. */\nexport type ContactImportSkipReason =\n  | 'invalid-email'\n  | 'duplicate'\n  | 'audience-band'\n  /** The person was erased from this workspace at their request (AGL-2623). */\n  | 'erased'\n  | 'write-failed'\n\n/** How a skip reason reads on screen and in the downloaded file. */\nexport const CONTACT_IMPORT_SKIP_LABELS: Record<ContactImportSkipReason, string> = {\n  'invalid-email': 'Not a valid email address',\n  duplicate: 'Appears earlier in the file',\n  'audience-band': 'Contact limit reached',\n  erased: 'Erased from this workspace at their request',\n  'write-failed': 'Could not be saved',\n}\n\n/** A cell the file carried that could not be read as the field it was mapped to. */\nexport type ContactImportDroppedValue = ImportDroppedValue\n\n/** One row, ready to be written. */\nexport interface ContactImportRow {\n  email: string\n  name?: string\n  /** E.164. */\n  phone?: string\n  jobTitle?: string\n  companyName?: string\n  address?: AglynPostalAddress\n  /** Lowercased, deduplicated, capped at {@link CONTACT_IMPORT_TAGS_MAX}. */\n  tags: string[]\n  /** Normalized, for the server to resolve against the org's members. */\n  ownerEmail?: string\n  lifecycleStage?: ContactLifecycleStage\n  marketingConsent: boolean\n  /** Only the keys whose definition the caller supplied and whose value read. */\n  custom: Record<string, ContactCustomValue>\n  dropped: ContactImportDroppedValue[]\n}\n\nexport type ContactImportRowVerdict =\n  | { ok: true; row: ContactImportRow }\n  | { ok: false; reason: 'invalid-email'; input: string }\n\n/**\n * A tag cell as the tags it names.\n *\n * `|` or `,` separated — the CSV export writes `|`, most other products\n * write `,` — lowercased and trimmed like the profile drawer's own tag\n * field, so an imported `VIP` and a typed `vip` are one tag and not two.\n */\nexport function parseContactImportTags(value: unknown): string[] {\n  return parseImportTags(value, CONTACT_IMPORT_TAGS_MAX)\n}\n\n/**\n * A yes/no cell as a boolean, or `null` when it is neither.\n *\n * The affirmatives are the ones consent and checkbox columns actually\n * carry; the negatives are listed so that an explicit `no` is a `false`\n * rather than an unreadable value that gets reported as dropped.\n */\nexport function parseContactImportFlag(value: unknown): boolean | null {\n  return parseImportFlag(value)\n}\n\n/**\n * A stage cell as a stage, accepting the stored id (`sales-qualified`), its\n * label (\"Sales qualified\") and the spellings between them\n * (`Sales_Qualified`), or `null` when it names none of them.\n */\nexport function parseContactImportLifecycleStage(\n  value: unknown,\n): ContactLifecycleStage | null {\n  const text = String(value ?? '')\n    .trim()\n    .toLowerCase()\n  if (!text) return null\n  const key = text.replace(/[\\s_]+/g, '-')\n  if (isContactLifecycleStage(key)) return key\n  for (const stage of CONTACT_LIFECYCLE_STAGES) {\n    if (CONTACT_LIFECYCLE_STAGE_LABELS[stage].toLowerCase() === text) return stage\n  }\n  return null\n}\n\n/**\n * A cell as the value a custom field of this type stores.\n *\n * `{ value }` when it read, `{ value: undefined }` for a blank cell (nothing\n * to write and nothing to report), and `null` when the cell held something\n * the type cannot hold — a word in a number field, a choice a select does\n * not offer. A date is stored as epoch milliseconds, the shape every other\n * timestamp on a CRM record takes (`dueAtMs`, `expectedCloseAtMs`).\n */\nexport function parseContactImportCustomValue(\n  definition: Pick<ContactFieldDefinition, 'type' | 'options'>,\n  value: unknown,\n): { value: ContactCustomValue | undefined } | null {\n  const text = String(value ?? '').trim()\n  if (!text) return { value: undefined }\n  switch (definition.type) {\n    case 'text':\n    case 'url':\n      return { value: text.slice(0, CUSTOM_TEXT_MAX) }\n    case 'number': {\n      const number = Number(text.replace(/[,\\s$€£]/g, ''))\n      return Number.isFinite(number) ? { value: number } : null\n    }\n    case 'date': {\n      const ms = Date.parse(text)\n      return Number.isFinite(ms) ? { value: ms } : null\n    }\n    case 'select': {\n      const wanted = text.toLowerCase()\n      const option = (definition.options ?? []).find(\n        (candidate) => String(candidate).trim().toLowerCase() === wanted,\n      )\n      return option === undefined ? null : { value: String(option) }\n    }\n    case 'checkbox': {\n      const flag = parseContactImportFlag(text)\n      return flag === null ? null : { value: flag }\n    }\n    default:\n      return null\n  }\n}\n\n/**\n * One raw row as the values that will be written, or the reason it cannot\n * be.\n *\n * `fields` is the holder's live definitions: a custom value under a key\n * with no definition is dropped and reported, because a value nobody\n * defined a field for is a value no form will ever show.\n */\nexport function normalizeContactImportRow(\n  raw: ContactImportRawRow,\n  fields: readonly Pick<ContactFieldDefinition, 'key' | 'type' | 'options'>[] = [],\n): ContactImportRowVerdict {\n  const email = normalizeContactEmail(raw.email)\n  if (!email) {\n    return { ok: false, reason: 'invalid-email', input: String(raw.email ?? '').trim() }\n  }\n  const dropped: ContactImportDroppedValue[] = []\n  const drop = (field: string, value: unknown) => {\n    dropped.push({ field, value: String(value ?? '').trim() })\n  }\n\n  const row: ContactImportRow = {\n    email,\n    tags: parseContactImportTags(raw.tags),\n    marketingConsent: false,\n    custom: {},\n    dropped,\n  }\n\n  const name = importTextValue(raw.name, NAME_MAX)\n  if (name) row.name = name\n  const jobTitle = importTextValue(raw.jobTitle, NAME_MAX)\n  if (jobTitle) row.jobTitle = jobTitle\n  const companyName = importTextValue(raw.companyName, NAME_MAX)\n  if (companyName) row.companyName = companyName\n\n  const phoneText = importTextValue(raw.phone, 64)\n  if (phoneText) {\n    const phone = normalizePhone(phoneText)\n    if (phone) row.phone = phone\n    else drop('phone', phoneText)\n  }\n\n  const address = normalizeAddress({\n    line1: importTextValue(raw.addressLine1, 200),\n    line2: importTextValue(raw.addressLine2, 200),\n    city: importTextValue(raw.addressCity, 120),\n    state: importTextValue(raw.addressState, 120),\n    postalCode: importTextValue(raw.addressPostalCode, 32),\n    country: importTextValue(raw.addressCountry, 8),\n  })\n  if (address) row.address = address\n  // The country is the one address part the normalizer drops silently — a\n  // typed name is not a code — so it is the one part the report has to name.\n  const countryText = importTextValue(raw.addressCountry, 64)\n  if (countryText && !address?.country) drop('addressCountry', countryText)\n\n  const ownerText = importTextValue(raw.ownerEmail, 320)\n  if (ownerText) {\n    const owner = normalizeContactEmail(ownerText)\n    if (owner) row.ownerEmail = owner\n    else drop('ownerEmail', ownerText)\n  }\n\n  const stageText = importTextValue(raw.lifecycleStage, 64)\n  if (stageText) {\n    const stage = parseContactImportLifecycleStage(stageText)\n    if (stage) row.lifecycleStage = stage\n    else drop('lifecycleStage', stageText)\n  }\n\n  const consentText = raw.marketingConsent\n  if (consentText !== undefined && consentText !== null && String(consentText).trim()) {\n    const flag = parseContactImportFlag(consentText)\n    if (flag === null) drop('marketingConsent', consentText)\n    else row.marketingConsent = flag\n  }\n\n  const custom =\n    raw.custom && typeof raw.custom === 'object' && !Array.isArray(raw.custom)\n      ? (raw.custom as Record<string, unknown>)\n      : {}\n  const definitions = new Map(fields.map((field) => [field.key, field]))\n  for (const [key, value] of Object.entries(custom)) {\n    const definition = definitions.get(key)\n    if (!definition) {\n      drop(customImportTarget(key), value)\n      continue\n    }\n    const parsed = parseContactImportCustomValue(definition, value)\n    if (!parsed) drop(customImportTarget(key), value)\n    else if (parsed.value !== undefined) row.custom[key] = parsed.value\n  }\n\n  return { ok: true, row }\n}\n\n/** One row the server did not store, by its index in the request, named by address. */\nexport interface ContactImportSkippedRow {\n  index: number\n  email: string\n  reason: ContactImportSkipReason\n}\n\n/**\n * What one request did — the shared tally plus how many companies the\n * company column brought into being. The drawer sums these across a file.\n */\nexport interface ContactImportChunkResult\n  extends ImportChunkResult<ContactImportSkippedRow> {\n  companiesCreated: number\n}\n\n/** An empty tally, for the drawer to fold chunk results into. */\nexport function emptyContactImportResult(): ContactImportChunkResult {\n  return { ...emptyImportResult<ContactImportSkippedRow>(), companiesCreated: 0 }\n}\n\n/**\n * Two results as one — the shared fold, with the company tally beside it.\n * `offset` is where the chunk started in the file, so a skipped row's index\n * comes back as its position in the FILE rather than in the request.\n */\nexport function mergeContactImportResults(\n  total: ContactImportChunkResult,\n  chunk: ContactImportChunkResult,\n  offset = 0,\n): ContactImportChunkResult {\n  return {\n    ...mergeImportResults(total, chunk, offset),\n    companiesCreated: total.companiesCreated + Number(chunk.companiesCreated ?? 0),\n  }\n}\n\n/**\n * The skipped rows as a file the operator can fix and re-import: the\n * original columns verbatim plus a trailing `Skipped because` column.\n */\nexport function contactImportSkippedCsv(\n  columns: readonly string[],\n  entries: readonly { cells: readonly string[]; reason: ContactImportSkipReason }[],\n): string {\n  return importSkippedCsv(columns, entries, CONTACT_IMPORT_SKIP_LABELS)\n}\n"],"names":["normalizeAddress","normalizePhone","normalizeContactEmail","CSV_IMPORT_CHUNK_SIZE","CSV_IMPORT_MAX_BODY_BYTES","CSV_IMPORT_MAX_ROWS","CSV_IMPORT_PREVIEW_ROWS","customImportTarget","emptyImportResult","guessImportMapping","importAliasKeys","importSkippedCsv","importTextValue","mapImportRow","mergeImportResults","parseImportFlag","parseImportTags","CONTACT_LIFECYCLE_STAGE_LABELS","CONTACT_LIFECYCLE_STAGES","isContactLifecycleStage","customImportTargetKey","CONTACT_IMPORT_MAX_ROWS","CONTACT_IMPORT_CHUNK_SIZE","CONTACT_IMPORT_MAX_BODY_BYTES","CONTACT_IMPORT_PREVIEW_ROWS","CONTACT_IMPORT_TAGS_MAX","NAME_MAX","CUSTOM_TEXT_MAX","CONTACT_IMPORT_FIELDS","CONTACT_IMPORT_FIELD_LABELS","email","name","phone","jobTitle","companyName","addressLine1","addressLine2","addressCity","addressState","addressPostalCode","addressCountry","tags","ownerEmail","lifecycleStage","marketingConsent","FIELD_ALIASES","FIELD_ALIAS_KEYS","guessContactImportMapping","columns","fields","mapContactImportRow","cells","mapping","CONTACT_IMPORT_SKIP_LABELS","duplicate","erased","parseContactImportTags","value","parseContactImportFlag","parseContactImportLifecycleStage","text","String","trim","toLowerCase","key","replace","stage","parseContactImportCustomValue","definition","undefined","type","slice","number","Number","isFinite","ms","Date","parse","wanted","option","options","find","candidate","flag","normalizeContactImportRow","raw","ok","reason","input","dropped","drop","field","push","row","custom","phoneText","address","line1","line2","city","state","postalCode","country","countryText","ownerText","owner","stageText","consentText","Array","isArray","definitions","Map","map","Object","entries","get","parsed","emptyContactImportResult","companiesCreated","mergeContactImportResults","total","chunk","offset","contactImportSkippedCsv"],"mappings":"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"}
+{"version":3,"sources":["../../../../../../../libs/plugins/crm/src/lib/model/crm-import.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 * BRINGING A SPREADSHEET OF PEOPLE INTO THE CRM — the pure half (AGL-2602).\n *\n * A merchant arriving from another CRM has a CSV: a header row naming\n * columns in that product's vocabulary, and one person per line. Nothing\n * about that file is in our shape. This module is every decision about the\n * file that needs no Firestore and no React — which columns mean what, how a\n * cell becomes a stored value, and what to say about a row that cannot be\n * stored — so that the console drawer and the server route read the same\n * rules rather than two copies of them.\n *\n * ## Three stages, and only the last one touches a record\n *\n *  1. {@link guessContactImportMapping} reads the header and proposes a\n *     column → field mapping from a table of aliases. It is a PROPOSAL: the\n *     drawer shows it and the operator corrects it, because an export's\n *     \"Company\" column may hold a job title and no alias table can know.\n *  2. {@link mapContactImportRow} applies the mapping to one line, producing\n *     the raw row the browser posts. Strings only — the browser trims nothing\n *     and validates nothing, so the server is the one place the file is\n *     judged and a stale drawer cannot judge it differently.\n *  3. {@link normalizeContactImportRow} turns a raw row into the values that\n *     will be written, through the SAME normalizers every other door uses:\n *     `normalizeContactEmail` for the dedupe key, `normalizePhone` for E.164,\n *     `normalizeAddress` for the postal shape, `isContactLifecycleStage` for\n *     the stage. An importer with its own idea of a valid phone number is how\n *     one collection ends up storing a value three ways.\n *\n * ## A bad cell is dropped and named; a bad row is skipped and named\n *\n * The only thing that makes a row unstorable is an unusable address, because\n * the address is the identity the shared row is keyed by. Everything else is\n * a value on the row: a phone that cannot be read as a number is left off\n * the contact and REPORTED under {@link ContactImportRow.dropped}, so the\n * operator learns that forty rows had a phone in a format we could not read\n * rather than discovering, weeks later, that the phone column silently went\n * nowhere. `list-import.ts` applies the same rule to a line that is not an\n * address: reported, never quietly discarded.\n *\n * ## Ceilings are on the work, never on the audience\n *\n * {@link CONTACT_IMPORT_MAX_ROWS} bounds one FILE, and the drawer says so\n * before anything is sent. {@link CONTACT_IMPORT_CHUNK_SIZE} bounds one\n * REQUEST, so a five-thousand-row file is twenty-five requests with a\n * progress bar between them rather than one that times out halfway with no\n * record of what it did. Neither one ever trims a person to fit: a row past\n * the file ceiling is refused with the file, and a row is never dropped to\n * make a chunk smaller. The audience band is enforced where every capture\n * enforces it — inside `upsertHostContact` — and an import reports that\n * refusal per row rather than pre-empting it with a count of its own.\n */\n\nimport type { AglynPostalAddress } from '@aglyn/aglyn/foundation/definitions/contact.types'\nimport { normalizeAddress, normalizePhone } from '@aglyn/aglyn/foundation/definitions/contact.types'\nimport { normalizeContactEmail } from '@aglyn/aglyn/app-utils/contacts'\nimport {\n  CSV_IMPORT_CHUNK_SIZE,\n  CSV_IMPORT_MAX_BODY_BYTES,\n  CSV_IMPORT_MAX_ROWS,\n  CSV_IMPORT_PREVIEW_ROWS,\n  customImportTarget,\n  customImportTargetKey,\n  emptyImportResult,\n  guessImportMapping,\n  importAliasKeys,\n  type ImportChunkResult,\n  type ImportDroppedValue,\n  importSkippedCsv,\n  importTextValue,\n  mapImportRow,\n  mergeImportResults,\n  parseImportFlag,\n  parseImportTags,\n} from '@aglyn/aglyn/app-utils/csv-import'\nimport {\n  CONTACT_LIFECYCLE_STAGE_LABELS,\n  CONTACT_LIFECYCLE_STAGES,\n  type ContactCustomValue,\n  type ContactFieldDefinition,\n  type ContactLifecycleStage,\n  isContactLifecycleStage,\n} from '@aglyn/aglyn/app-utils/crm'\n\n/*\n * The custom-target grammar is the shared module's; it is re-exported here\n * because every reader of a contact mapping has always taken it from this\n * file, and the companies import reads the same two functions from theirs.\n */\nexport { customImportTarget, customImportTargetKey } from '@aglyn/aglyn/app-utils/csv-import'\n\n/**\n * The ceilings are the shared ones (`csv-import.ts`), under the names this\n * file has always exported: one file, one request and one preview are\n * bounded the same way for every collection, because the bounds are about\n * the browser's memory and a request's budget rather than about people.\n */\nexport const CONTACT_IMPORT_MAX_ROWS = CSV_IMPORT_MAX_ROWS\n\nexport const CONTACT_IMPORT_CHUNK_SIZE = CSV_IMPORT_CHUNK_SIZE\n\nexport const CONTACT_IMPORT_MAX_BODY_BYTES = CSV_IMPORT_MAX_BODY_BYTES\n\nexport const CONTACT_IMPORT_PREVIEW_ROWS = CSV_IMPORT_PREVIEW_ROWS\n\n/**\n * The most tags one row may carry — the profile drawer's own cap, so an\n * imported person cannot hold more tags than a hand-edited one.\n */\nexport const CONTACT_IMPORT_TAGS_MAX = 20\n\n/** The longest text a name, title, company name or custom text value keeps. */\nconst NAME_MAX = 120\nconst CUSTOM_TEXT_MAX = 1_000\n\n/**\n * The standard fields a column may be mapped to, in the order the mapping\n * menu lists them. A custom field is mapped by its key — see\n * {@link ContactImportTargetId}.\n */\nexport const CONTACT_IMPORT_FIELDS = [\n  'email',\n  'name',\n  'phone',\n  'jobTitle',\n  'companyName',\n  'addressLine1',\n  'addressLine2',\n  'addressCity',\n  'addressState',\n  'addressPostalCode',\n  'addressCountry',\n  'tags',\n  'ownerEmail',\n  'lifecycleStage',\n  'marketingConsent',\n] as const\n\nexport type ContactImportField = (typeof CONTACT_IMPORT_FIELDS)[number]\n\n/** How each field reads in the mapping menu. Typed so a field cannot ship unlabeled. */\nexport const CONTACT_IMPORT_FIELD_LABELS: Record<ContactImportField, string> = {\n  email: 'Email (required)',\n  name: 'Name',\n  phone: 'Phone',\n  jobTitle: 'Job title',\n  companyName: 'Company name',\n  addressLine1: 'Address line 1',\n  addressLine2: 'Address line 2',\n  addressCity: 'City',\n  addressState: 'State or region',\n  addressPostalCode: 'Postal code',\n  addressCountry: 'Country (two-letter code)',\n  tags: 'Tags (comma or | separated)',\n  ownerEmail: 'Owner (team member email)',\n  lifecycleStage: 'Lifecycle stage',\n  marketingConsent: 'Marketing consent (yes/no)',\n}\n\n/**\n * Header aliases per field, matched after `importHeaderKey` normalization.\n *\n * The vocabulary of the exports people actually arrive with — HubSpot's\n * \"First Name\"/\"Last Name\" pair is deliberately NOT here, because two columns\n * cannot map to one field and a guess that took only the first name would\n * store half a name and look right in the preview. An operator with a split\n * name maps one of the two by hand, and the preview shows what they chose.\n */\nconst FIELD_ALIASES: Record<ContactImportField, readonly string[]> = {\n  email: [\n    'email',\n    'email address',\n    'e-mail',\n    'e-mail address',\n    'contact email',\n    'primary email',\n    'work email',\n  ],\n  name: ['name', 'full name', 'contact name', 'display name', 'person'],\n  phone: [\n    'phone',\n    'phone number',\n    'telephone',\n    'mobile',\n    'mobile phone',\n    'cell',\n    'work phone',\n  ],\n  jobTitle: ['job title', 'title', 'position', 'role'],\n  companyName: ['company', 'company name', 'organization', 'organisation', 'account'],\n  addressLine1: ['address', 'address line 1', 'street', 'street address', 'address 1'],\n  addressLine2: ['address line 2', 'address 2', 'street 2', 'apartment', 'suite'],\n  addressCity: ['city', 'town', 'locality'],\n  addressState: ['state', 'region', 'province', 'county', 'state/region'],\n  addressPostalCode: ['postal code', 'postcode', 'zip', 'zip code', 'post code'],\n  addressCountry: ['country', 'country code', 'country/region'],\n  tags: ['tags', 'tag', 'labels', 'groups', 'segments'],\n  ownerEmail: ['owner', 'owner email', 'contact owner', 'assigned to', 'account owner'],\n  lifecycleStage: ['lifecycle stage', 'stage', 'lifecycle', 'status', 'lead status'],\n  marketingConsent: [\n    'marketing consent',\n    'consent',\n    'opt in',\n    'opt-in',\n    'opted in',\n    'subscribed',\n    'marketing opt in',\n    'email consent',\n  ],\n}\n\n/**\n * What a column is mapped to: a standard field by name, or a custom field\n * as `custom:<key>` — see `customImportTarget`.\n */\nexport type ContactImportTargetId = ContactImportField | `custom:${string}`\n\n/** Column index → target. A column absent from the map is not imported. */\nexport type ContactImportMapping = Record<number, ContactImportTargetId>\n\n/** {@link FIELD_ALIASES}, normalized once for the matcher. */\nconst FIELD_ALIAS_KEYS = importAliasKeys(CONTACT_IMPORT_FIELDS, FIELD_ALIASES)\n\n/**\n * A proposed mapping from a file's header row — the shared matcher over the\n * contact vocabulary. Custom fields win over standard aliases when a header\n * matches a definition's label or key exactly: a merchant who defined a\n * field called \"Status\" meant THEIR status, not our lifecycle stage.\n */\nexport function guessContactImportMapping(\n  columns: readonly string[],\n  fields: readonly Pick<ContactFieldDefinition, 'key' | 'label'>[] = [],\n): ContactImportMapping {\n  return guessImportMapping(columns, CONTACT_IMPORT_FIELDS, FIELD_ALIAS_KEYS, fields)\n}\n\n/**\n * What the browser posts for one line: the cells the mapping selected,\n * under the field they were mapped to, verbatim.\n *\n * Values are `unknown` because the server reads this off an untrusted body;\n * the mapper below only ever writes strings into it.\n */\nexport interface ContactImportRawRow {\n  email?: unknown\n  name?: unknown\n  phone?: unknown\n  jobTitle?: unknown\n  companyName?: unknown\n  addressLine1?: unknown\n  addressLine2?: unknown\n  addressCity?: unknown\n  addressState?: unknown\n  addressPostalCode?: unknown\n  addressCountry?: unknown\n  tags?: unknown\n  ownerEmail?: unknown\n  lifecycleStage?: unknown\n  marketingConsent?: unknown\n  /** Custom values keyed by definition key. */\n  custom?: unknown\n}\n\n/** One parsed line under the mapping. Empty cells are left absent. */\nexport function mapContactImportRow(\n  cells: readonly string[],\n  mapping: ContactImportMapping,\n): ContactImportRawRow {\n  return mapImportRow(cells, mapping)\n}\n\n/** Why one row was not stored. */\nexport type ContactImportSkipReason =\n  | 'invalid-email'\n  | 'duplicate'\n  | 'audience-band'\n  /** The person was erased from this workspace at their request (AGL-2623). */\n  | 'erased'\n  | 'write-failed'\n  /**\n   * The request ran out of time before it reached the row (AGL-3423). Nothing\n   * was written for it, and importing the skipped file again is safe: a row\n   * that did land merges into its record rather than creating a second one.\n   */\n  | 'not-reached'\n\n/** How a skip reason reads on screen and in the downloaded file. */\nexport const CONTACT_IMPORT_SKIP_LABELS: Record<ContactImportSkipReason, string> = {\n  'invalid-email': 'Not a valid email address',\n  duplicate: 'Appears earlier in the file',\n  'audience-band': 'Contact limit reached',\n  erased: 'Erased from this workspace at their request',\n  'write-failed': 'Could not be saved',\n  'not-reached': 'Not reached in time; import the skipped rows again',\n}\n\n/** A cell the file carried that could not be read as the field it was mapped to. */\nexport type ContactImportDroppedValue = ImportDroppedValue\n\n/** One row, ready to be written. */\nexport interface ContactImportRow {\n  email: string\n  name?: string\n  /** E.164. */\n  phone?: string\n  jobTitle?: string\n  companyName?: string\n  address?: AglynPostalAddress\n  /** Lowercased, deduplicated, capped at {@link CONTACT_IMPORT_TAGS_MAX}. */\n  tags: string[]\n  /** Normalized, for the server to resolve against the org's members. */\n  ownerEmail?: string\n  lifecycleStage?: ContactLifecycleStage\n  marketingConsent: boolean\n  /** Only the keys whose definition the caller supplied and whose value read. */\n  custom: Record<string, ContactCustomValue>\n  dropped: ContactImportDroppedValue[]\n}\n\nexport type ContactImportRowVerdict =\n  | { ok: true; row: ContactImportRow }\n  | { ok: false; reason: 'invalid-email'; input: string }\n\n/**\n * A tag cell as the tags it names.\n *\n * `|` or `,` separated — the CSV export writes `|`, most other products\n * write `,` — lowercased and trimmed like the profile drawer's own tag\n * field, so an imported `VIP` and a typed `vip` are one tag and not two.\n */\nexport function parseContactImportTags(value: unknown): string[] {\n  return parseImportTags(value, CONTACT_IMPORT_TAGS_MAX)\n}\n\n/**\n * A yes/no cell as a boolean, or `null` when it is neither.\n *\n * The affirmatives are the ones consent and checkbox columns actually\n * carry; the negatives are listed so that an explicit `no` is a `false`\n * rather than an unreadable value that gets reported as dropped.\n */\nexport function parseContactImportFlag(value: unknown): boolean | null {\n  return parseImportFlag(value)\n}\n\n/**\n * A stage cell as a stage, accepting the stored id (`sales-qualified`), its\n * label (\"Sales qualified\") and the spellings between them\n * (`Sales_Qualified`), or `null` when it names none of them.\n */\nexport function parseContactImportLifecycleStage(\n  value: unknown,\n): ContactLifecycleStage | null {\n  const text = String(value ?? '')\n    .trim()\n    .toLowerCase()\n  if (!text) return null\n  const key = text.replace(/[\\s_]+/g, '-')\n  if (isContactLifecycleStage(key)) return key\n  for (const stage of CONTACT_LIFECYCLE_STAGES) {\n    if (CONTACT_LIFECYCLE_STAGE_LABELS[stage].toLowerCase() === text) return stage\n  }\n  return null\n}\n\n/**\n * A cell as the value a custom field of this type stores.\n *\n * `{ value }` when it read, `{ value: undefined }` for a blank cell (nothing\n * to write and nothing to report), and `null` when the cell held something\n * the type cannot hold — a word in a number field, a choice a select does\n * not offer. A date is stored as epoch milliseconds, the shape every other\n * timestamp on a CRM record takes (`dueAtMs`, `expectedCloseAtMs`).\n */\nexport function parseContactImportCustomValue(\n  definition: Pick<ContactFieldDefinition, 'type' | 'options'>,\n  value: unknown,\n): { value: ContactCustomValue | undefined } | null {\n  const text = String(value ?? '').trim()\n  if (!text) return { value: undefined }\n  switch (definition.type) {\n    case 'text':\n    case 'url':\n      return { value: text.slice(0, CUSTOM_TEXT_MAX) }\n    case 'number': {\n      const number = Number(text.replace(/[,\\s$€£]/g, ''))\n      return Number.isFinite(number) ? { value: number } : null\n    }\n    case 'date': {\n      const ms = Date.parse(text)\n      return Number.isFinite(ms) ? { value: ms } : null\n    }\n    case 'select': {\n      const wanted = text.toLowerCase()\n      const option = (definition.options ?? []).find(\n        (candidate) => String(candidate).trim().toLowerCase() === wanted,\n      )\n      return option === undefined ? null : { value: String(option) }\n    }\n    case 'checkbox': {\n      const flag = parseContactImportFlag(text)\n      return flag === null ? null : { value: flag }\n    }\n    default:\n      return null\n  }\n}\n\n/**\n * One raw row as the values that will be written, or the reason it cannot\n * be.\n *\n * `fields` is the holder's live definitions: a custom value under a key\n * with no definition is dropped and reported, because a value nobody\n * defined a field for is a value no form will ever show.\n */\nexport function normalizeContactImportRow(\n  raw: ContactImportRawRow,\n  fields: readonly Pick<ContactFieldDefinition, 'key' | 'type' | 'options'>[] = [],\n): ContactImportRowVerdict {\n  const email = normalizeContactEmail(raw.email)\n  if (!email) {\n    return { ok: false, reason: 'invalid-email', input: String(raw.email ?? '').trim() }\n  }\n  const dropped: ContactImportDroppedValue[] = []\n  const drop = (field: string, value: unknown) => {\n    dropped.push({ field, value: String(value ?? '').trim() })\n  }\n\n  const row: ContactImportRow = {\n    email,\n    tags: parseContactImportTags(raw.tags),\n    marketingConsent: false,\n    custom: {},\n    dropped,\n  }\n\n  const name = importTextValue(raw.name, NAME_MAX)\n  if (name) row.name = name\n  const jobTitle = importTextValue(raw.jobTitle, NAME_MAX)\n  if (jobTitle) row.jobTitle = jobTitle\n  const companyName = importTextValue(raw.companyName, NAME_MAX)\n  if (companyName) row.companyName = companyName\n\n  const phoneText = importTextValue(raw.phone, 64)\n  if (phoneText) {\n    const phone = normalizePhone(phoneText)\n    if (phone) row.phone = phone\n    else drop('phone', phoneText)\n  }\n\n  const address = normalizeAddress({\n    line1: importTextValue(raw.addressLine1, 200),\n    line2: importTextValue(raw.addressLine2, 200),\n    city: importTextValue(raw.addressCity, 120),\n    state: importTextValue(raw.addressState, 120),\n    postalCode: importTextValue(raw.addressPostalCode, 32),\n    country: importTextValue(raw.addressCountry, 8),\n  })\n  if (address) row.address = address\n  // The country is the one address part the normalizer drops silently — a\n  // typed name is not a code — so it is the one part the report has to name.\n  const countryText = importTextValue(raw.addressCountry, 64)\n  if (countryText && !address?.country) drop('addressCountry', countryText)\n\n  const ownerText = importTextValue(raw.ownerEmail, 320)\n  if (ownerText) {\n    const owner = normalizeContactEmail(ownerText)\n    if (owner) row.ownerEmail = owner\n    else drop('ownerEmail', ownerText)\n  }\n\n  const stageText = importTextValue(raw.lifecycleStage, 64)\n  if (stageText) {\n    const stage = parseContactImportLifecycleStage(stageText)\n    if (stage) row.lifecycleStage = stage\n    else drop('lifecycleStage', stageText)\n  }\n\n  const consentText = raw.marketingConsent\n  if (consentText !== undefined && consentText !== null && String(consentText).trim()) {\n    const flag = parseContactImportFlag(consentText)\n    if (flag === null) drop('marketingConsent', consentText)\n    else row.marketingConsent = flag\n  }\n\n  const custom =\n    raw.custom && typeof raw.custom === 'object' && !Array.isArray(raw.custom)\n      ? (raw.custom as Record<string, unknown>)\n      : {}\n  const definitions = new Map(fields.map((field) => [field.key, field]))\n  for (const [key, value] of Object.entries(custom)) {\n    const definition = definitions.get(key)\n    if (!definition) {\n      drop(customImportTarget(key), value)\n      continue\n    }\n    const parsed = parseContactImportCustomValue(definition, value)\n    if (!parsed) drop(customImportTarget(key), value)\n    else if (parsed.value !== undefined) row.custom[key] = parsed.value\n  }\n\n  return { ok: true, row }\n}\n\n/** One row the server did not store, by its index in the request, named by address. */\nexport interface ContactImportSkippedRow {\n  index: number\n  email: string\n  reason: ContactImportSkipReason\n}\n\n/**\n * What one request did — the shared tally plus how many companies the\n * company column brought into being. The drawer sums these across a file.\n */\nexport interface ContactImportChunkResult\n  extends ImportChunkResult<ContactImportSkippedRow> {\n  companiesCreated: number\n}\n\n/** An empty tally, for the drawer to fold chunk results into. */\nexport function emptyContactImportResult(): ContactImportChunkResult {\n  return { ...emptyImportResult<ContactImportSkippedRow>(), companiesCreated: 0 }\n}\n\n/**\n * Two results as one — the shared fold, with the company tally beside it.\n * `offset` is where the chunk started in the file, so a skipped row's index\n * comes back as its position in the FILE rather than in the request.\n */\nexport function mergeContactImportResults(\n  total: ContactImportChunkResult,\n  chunk: ContactImportChunkResult,\n  offset = 0,\n): ContactImportChunkResult {\n  return {\n    ...mergeImportResults(total, chunk, offset),\n    companiesCreated: total.companiesCreated + Number(chunk.companiesCreated ?? 0),\n  }\n}\n\n/**\n * The skipped rows as a file the operator can fix and re-import: the\n * original columns verbatim plus a trailing `Skipped because` column.\n */\nexport function contactImportSkippedCsv(\n  columns: readonly string[],\n  entries: readonly { cells: readonly string[]; reason: ContactImportSkipReason }[],\n): string {\n  return importSkippedCsv(columns, entries, CONTACT_IMPORT_SKIP_LABELS)\n}\n"],"names":["normalizeAddress","normalizePhone","normalizeContactEmail","CSV_IMPORT_CHUNK_SIZE","CSV_IMPORT_MAX_BODY_BYTES","CSV_IMPORT_MAX_ROWS","CSV_IMPORT_PREVIEW_ROWS","customImportTarget","emptyImportResult","guessImportMapping","importAliasKeys","importSkippedCsv","importTextValue","mapImportRow","mergeImportResults","parseImportFlag","parseImportTags","CONTACT_LIFECYCLE_STAGE_LABELS","CONTACT_LIFECYCLE_STAGES","isContactLifecycleStage","customImportTargetKey","CONTACT_IMPORT_MAX_ROWS","CONTACT_IMPORT_CHUNK_SIZE","CONTACT_IMPORT_MAX_BODY_BYTES","CONTACT_IMPORT_PREVIEW_ROWS","CONTACT_IMPORT_TAGS_MAX","NAME_MAX","CUSTOM_TEXT_MAX","CONTACT_IMPORT_FIELDS","CONTACT_IMPORT_FIELD_LABELS","email","name","phone","jobTitle","companyName","addressLine1","addressLine2","addressCity","addressState","addressPostalCode","addressCountry","tags","ownerEmail","lifecycleStage","marketingConsent","FIELD_ALIASES","FIELD_ALIAS_KEYS","guessContactImportMapping","columns","fields","mapContactImportRow","cells","mapping","CONTACT_IMPORT_SKIP_LABELS","duplicate","erased","parseContactImportTags","value","parseContactImportFlag","parseContactImportLifecycleStage","text","String","trim","toLowerCase","key","replace","stage","parseContactImportCustomValue","definition","undefined","type","slice","number","Number","isFinite","ms","Date","parse","wanted","option","options","find","candidate","flag","normalizeContactImportRow","raw","ok","reason","input","dropped","drop","field","push","row","custom","phoneText","address","line1","line2","city","state","postalCode","country","countryText","ownerText","owner","stageText","consentText","Array","isArray","definitions","Map","map","Object","entries","get","parsed","emptyContactImportResult","companiesCreated","mergeContactImportResults","total","chunk","offset","contactImportSkippedCsv"],"mappings":"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"}

package/src/lib/model/crm-inbound.d.ts

@@ -0,0 +1,162 @@
+/**
+ * @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 '@aglyn/aglyn/app-utils/crm';
+import { type MemberAddresses } from '@aglyn/aglyn/app-utils/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, and the activity row the whole
+ * thing becomes. How a message is read — the address in a header, the
+ * reply above the quoted history — is the platform's (`email-text.ts`), and
+ * so is the domain mail arrives on (`inbound-mail-domain.ts`). The webhook
+ * route and the address route read it; 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`.
+ */
+/** 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;
+/** 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";
+/**
+ * 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 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;
+/** 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';
+}
+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 `emailExcerpt`. */
+    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;

package/src/lib/model/crm-inbound.js

@@ -0,0 +1,208 @@
+import { _ as _extends } from "@swc/helpers/_/_extends";
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ import { CRM_EMAIL_BODY_MAX, CRM_EMAIL_SUBJECT_MAX } from "@aglyn/aglyn/app-utils/crm";
+import { emailAddressOf, threadSubject } from "@aglyn/aglyn/app-utils/email-text";
+import { memberEmailAddresses } from "@aglyn/aglyn/app-utils/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, and the activity row the whole
+ * thing becomes. How a message is read — the address in a header, the
+ * reply above the quoted history — is the platform's (`email-text.ts`), and
+ * so is the domain mail arrives on (`inbound-mail-domain.ts`). The webhook
+ * route and the address route read it; 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`.
+ */ /** The local part every capture address begins with: `crm+<token>@…`. */ export const CRM_INBOUND_LOCAL_PART = 'crm';
+/** How many characters a minted token has. */ export const CRM_INBOUND_TOKEN_LENGTH = 32;
+/** What the org's feed says about a message that matched no record. */ export 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 const CRM_INBOUND_CEILING_ACTION = 'Inbound email not filed: activity log full';
+const TOKEN_ALPHABET = 'abcdefghijklmnopqrstuvwxyz0123456789';
+const TOKEN_PATTERN = /^[a-z0-9]{24,64}$/;
+/**
+ * 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 function mintCrmInboundToken() {
+    const bytes = new Uint8Array(CRM_INBOUND_TOKEN_LENGTH);
+    globalThis.crypto.getRandomValues(bytes);
+    let token = '';
+    for (const byte of bytes)token += TOKEN_ALPHABET[byte % TOKEN_ALPHABET.length];
+    return token;
+}
+export function isCrmInboundToken(value) {
+    return typeof value === 'string' && TOKEN_PATTERN.test(value);
+}
+/** `crm+<token>@<domain>` — the address a member pastes into a mailbox. */ export function crmInboundAddress(token, domain) {
+    return `${CRM_INBOUND_LOCAL_PART}+${token}@${domain}`;
+}
+/**
+ * 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 function crmInboundTokenOf(recipient, domain) {
+    const raw = String(recipient != null ? recipient : '').trim();
+    const angled = /<([^<>]+)>\s*$/.exec(raw);
+    const address = (angled ? angled[1] : raw).trim();
+    const at = address.lastIndexOf('@');
+    if (at <= 0) return null;
+    if (address.slice(at + 1).toLowerCase() !== domain.toLowerCase()) return null;
+    const local = address.slice(0, at).toLowerCase();
+    const match = new RegExp(`^${CRM_INBOUND_LOCAL_PART}\\+([a-z0-9]{24,64})$`).exec(local);
+    return match ? match[1] : null;
+}
+/** Every distinct token among a message's recipients, in the order met. */ export function crmInboundTokensIn(recipients, domain) {
+    const tokens = [];
+    for (const recipient of recipients){
+        const token = crmInboundTokenOf(recipient, domain);
+        if (token && !tokens.includes(token)) tokens.push(token);
+    }
+    return tokens;
+}
+export function isCrmInboundAddress(address, domain) {
+    return crmInboundTokenOf(address, domain) !== null;
+}
+/**
+ * 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 function crmInboundCandidates(input) {
+    var _input_cc;
+    const members = new Set();
+    for (const member of input.members){
+        for (const address of memberEmailAddresses(member))members.add(address);
+    }
+    const sender = emailAddressOf(input.from);
+    const senderIsMember = sender !== null && members.has(sender);
+    const seen = new Set();
+    const candidates = [];
+    const consider = (value, direction, via)=>{
+        const email = emailAddressOf(value);
+        if (!email || seen.has(email) || members.has(email)) return;
+        if (isCrmInboundAddress(email, input.domain)) return;
+        seen.add(email);
+        candidates.push({
+            email,
+            direction,
+            via
+        });
+    };
+    consider(input.from, 'inbound', 'from');
+    const headed = senderIsMember ? 'outbound' : 'inbound';
+    for (const value of input.to)consider(value, headed, 'to');
+    for (const value of (_input_cc = input.cc) != null ? _input_cc : [])consider(value, headed, 'cc');
+    consider(input.forwardedFrom, 'inbound', 'forwarded');
+    return {
+        sender,
+        senderIsMember,
+        candidates
+    };
+}
+/**
+ * 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 function crmCapturedEmailKey(messageId, providerId) {
+    const id = String(messageId != null ? messageId : '').trim();
+    if (id) return `mid:${id}`;
+    const provider = String(providerId != null ? providerId : '').trim();
+    return provider ? `provider:${provider}` : null;
+}
+/**
+ * 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 function buildCrmCapturedEmailActivity(input) {
+    var _input_subject, _input_inReplyTo, _input_to, _input_byName, _input_excerpt, _input_messageId;
+    const { link } = input;
+    const subject = String((_input_subject = input.subject) != null ? _input_subject : '').replace(/\s+/g, ' ').trim().slice(0, CRM_EMAIL_SUBJECT_MAX);
+    const inReplyTo = String((_input_inReplyTo = input.inReplyTo) != null ? _input_inReplyTo : '').trim();
+    const to = String((_input_to = input.to) != null ? _input_to : '').trim();
+    const byName = String((_input_byName = input.byName) != null ? _input_byName : '').trim();
+    return _extends({
+        kind: 'email',
+        subject,
+        body: String((_input_excerpt = input.excerpt) != null ? _input_excerpt : '').slice(0, CRM_EMAIL_BODY_MAX),
+        direction: input.direction,
+        from: input.from
+    }, to ? {
+        to
+    } : {}, {
+        messageId: String((_input_messageId = input.messageId) != null ? _input_messageId : '').trim()
+    }, inReplyTo ? {
+        inReplyTo
+    } : {}, {
+        threadSubject: threadSubject(subject),
+        atMs: input.atMs,
+        byUid: input.byUid
+    }, byName ? {
+        byName
+    } : {}, link.contactId ? {
+        contactId: String(link.contactId)
+    } : {}, link.companyId ? {
+        companyId: String(link.companyId)
+    } : {}, link.dealId ? {
+        dealId: String(link.dealId)
+    } : {}, link.leadId ? {
+        leadId: String(link.leadId)
+    } : {}, {
+        hostId: input.hostId,
+        visibleTo: [
+            ...input.visibleTo
+        ]
+    });
+}
+
+//# sourceMappingURL=crm-inbound.js.map

package/src/lib/model/crm-inbound.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/crm/src/lib/model/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 {\n  CRM_EMAIL_BODY_MAX,\n  CRM_EMAIL_SUBJECT_MAX,\n  type CrmActivity,\n  type CrmActivityLink,\n  type CrmEmailDirection,\n} from '@aglyn/aglyn/app-utils/crm'\nimport { emailAddressOf, threadSubject } from '@aglyn/aglyn/app-utils/email-text'\nimport {\n  type MemberAddresses,\n  memberEmailAddresses,\n} from '@aglyn/aglyn/app-utils/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, and the activity row the whole\n * thing becomes. How a message is read — the address in a header, the\n * reply above the quoted history — is the platform's (`email-text.ts`), and\n * so is the domain mail arrives on (`inbound-mail-domain.ts`). The webhook\n * route and the address route read it; 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/** 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/** 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}$/\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 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/** 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\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 `emailExcerpt`. */\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: threadSubject(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":["CRM_EMAIL_BODY_MAX","CRM_EMAIL_SUBJECT_MAX","emailAddressOf","threadSubject","memberEmailAddresses","CRM_INBOUND_LOCAL_PART","CRM_INBOUND_TOKEN_LENGTH","CRM_INBOUND_UNMATCHED_ACTION","CRM_INBOUND_CEILING_ACTION","TOKEN_ALPHABET","TOKEN_PATTERN","mintCrmInboundToken","bytes","Uint8Array","globalThis","crypto","getRandomValues","token","byte","length","isCrmInboundToken","value","test","crmInboundAddress","domain","crmInboundTokenOf","recipient","raw","String","trim","angled","exec","address","at","lastIndexOf","slice","toLowerCase","local","match","RegExp","crmInboundTokensIn","recipients","tokens","includes","push","isCrmInboundAddress","crmInboundCandidates","input","members","Set","member","add","sender","from","senderIsMember","has","seen","candidates","consider","direction","via","email","headed","to","cc","forwardedFrom","crmCapturedEmailKey","messageId","providerId","id","provider","buildCrmCapturedEmailActivity","link","subject","replace","inReplyTo","byName","kind","body","excerpt","atMs","byUid","contactId","companyId","dealId","leadId","hostId","visibleTo"],"mappings":"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"}

package/src/lib/model/crm-lead-import.d.ts

@@ -27,7 +27,7 @@ export declare const LEAD_IMPORT_REASON_MAX = 500;
 /**
  * The statuses a file may set.
  *
- * The list's own status control offers exactly these three, and for the
+ * The list's own status control offers exactly these four, and for the
  * reason given above: `qualified` is written by the conversion, beside the
  * contact it produced.
  */

package/src/lib/model/crm-lead-import.js

@@ -64,7 +64,7 @@ import { _ as _object_without_properties_loose } from "@swc/helpers/_/_object_wi
  * to belong to, is left off the lead and REPORTED under
  * {@link LeadImportRow.dropped}, so the operator learns that a column went
  * nowhere rather than discovering it weeks later.
- */ import { CAMPAIGN_MEMBERSHIP_CAP } from "@aglyn/aglyn/app-utils/campaign-membership";
+ */ import { CONTAINER_MEMBERSHIP_CAP } from "@aglyn/aglyn/app-utils/container-membership";
 import { normalizeContactEmail } from "@aglyn/aglyn/app-utils/contacts";
 import { CRM_LEAD_STATUS_LABELS, CRM_LEAD_STATUSES, CRM_LEAD_TEXT_MAX, isCrmLeadStatus, judgeCrmLeadSource, normalizeCrmPicklistLabel, normalizeCrmLeadTags, normalizeCompanyWebsite } from "@aglyn/aglyn/app-utils/crm";
 import { normalizeAddress, normalizePhone } from "@aglyn/aglyn/foundation/definitions/contact.types";
@@ -79,7 +79,7 @@ export const LEAD_IMPORT_REASON_MAX = 500;
 /**
  * The statuses a file may set.
  *
- * The list's own status control offers exactly these three, and for the
+ * The list's own status control offers exactly these four, and for the
  * reason given above: `qualified` is written by the conversion, beside the
  * contact it produced.
  */ export const LEAD_IMPORT_STATUSES = CRM_LEAD_STATUSES.filter((status)=>status !== 'qualified');
@@ -121,7 +121,7 @@ export const LEAD_IMPORT_REASON_MAX = 500;
     phone: 'Phone',
     website: 'Website',
     leadSource: 'Lead source',
-    status: 'Status (new, working, unqualified)',
+    status: 'Status (new, nurturing, working, unqualified)',
     ownerEmail: 'Owner (team member email)',
     addressLine1: 'Address line 1',
     addressLine2: 'Address line 2',
@@ -296,7 +296,7 @@ const FIELD_ALIAS_KEYS = importAliasKeys(LEAD_IMPORT_FIELDS, FIELD_ALIASES);
     'lead-source-unknown': "Names a lead source that isn't one of this organization's active values",
     'write-failed': 'Could not be saved'
 };
-/** The most campaigns one row may name — the membership field's own cap. */ export const LEAD_IMPORT_CAMPAIGNS_MAX = CAMPAIGN_MEMBERSHIP_CAP;
+/** The most campaigns one row may name — the membership field's own cap. */ export const LEAD_IMPORT_CAMPAIGNS_MAX = CONTAINER_MEMBERSHIP_CAP;
 /**
  * A status cell by id or by label — `working`, `Working` and `WORKING` are
  * one status. `null` for a cell naming no status a file may set, which