@aglyn/plugins-crm 1.0.0-beta.143

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

@@ -0,0 +1,255 @@
+import { _ as _object_without_properties_loose } from "@swc/helpers/_/_object_without_properties_loose";
+/**
+ * @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.
+ */ /**
+ * BRINGING A SPREADSHEET OF LEADS INTO THE CRM — the pure half (AGL-2701).
+ *
+ * The contact import's three stages (`crm-import.ts`) over the lead
+ * vocabulary. A lead is the one CRM record a person does not type: it is
+ * what a capture door wrote when somebody signed up, booked or submitted a
+ * form, plus the working state the team wrote on top. A file therefore
+ * carries HALF a lead — the person, and the team's annotations — and the
+ * capture half is the door's to write.
+ *
+ * ## The address is the identity, because it is the document id
+ *
+ * A lead lives at `hosts/{hostId}/leads/{personKey}`, and `personKey` is
+ * the sha256 of the normalized address. So the address is not merely the
+ * one required cell: it is the row's name. A cell the normalizer cannot
+ * read is refused as `invalid-email`, and two rows of one file that
+ * normalize to the same address are one person — the second is skipped as
+ * `duplicate` rather than merged onto the first, for the reason the
+ * contacts import gives: one person reported once created and once merged
+ * is a number the operator cannot reconcile against the rows they sent.
+ *
+ * ## What a file may NOT say
+ *
+ * The export's `Sources`, `First seen`, `Last seen` and `Captures` columns
+ * are the capture door's own record of what the visitor did, and
+ * `Converted` is stamped by `crm/lead-convert` after the contact exists.
+ * None of them is a field here, so the mapping leaves those columns
+ * unmapped rather than mis-mapping them — a file that could write
+ * "first seen" could rewrite the history it is supposed to describe. The
+ * organization-level file's `Site` column is left out for a second reason:
+ * the site is the drawer's question and the route's permission is granted
+ * for that ONE site, so a cell must not be able to redirect a row to
+ * another.
+ *
+ * ## Qualified is a conversion, not a status a cell can claim
+ *
+ * `qualified` means a lead BECAME a contact, and `convertedContactId`
+ * beside it names the contact that was really created. Only the convert
+ * route writes the pair, so the list's own status control offers new,
+ * working and unqualified and nothing else. A cell naming `qualified` is
+ * dropped and reported here for the same reason: a status claiming a
+ * conversion that never happened would show a contact link to nowhere.
+ *
+ * ## A bad cell is dropped and named; a bad row is skipped and named
+ *
+ * The address is the only cell that can make a row unstorable. An
+ * unreadable status, or an unqualified reason with no unqualified status
+ * 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 { normalizeContactEmail } from "@aglyn/aglyn/app-utils/contacts";
+import { CRM_LEAD_STATUS_LABELS, CRM_LEAD_STATUSES, isCrmLeadStatus } from "@aglyn/aglyn/app-utils/crm";
+import { CSV_IMPORT_CHUNK_SIZE, CSV_IMPORT_MAX_BODY_BYTES, CSV_IMPORT_MAX_ROWS, CSV_IMPORT_PREVIEW_ROWS, emptyImportResult, guessImportMapping, importAliasKeys, importSkippedCsv, importTextValue, mapImportRow, mergeImportResults } from "@aglyn/aglyn/app-utils/csv-import";
+/** The shared ceilings, under this collection's names. */ export const LEAD_IMPORT_MAX_ROWS = CSV_IMPORT_MAX_ROWS;
+export const LEAD_IMPORT_CHUNK_SIZE = CSV_IMPORT_CHUNK_SIZE;
+export const LEAD_IMPORT_MAX_BODY_BYTES = CSV_IMPORT_MAX_BODY_BYTES;
+export const LEAD_IMPORT_PREVIEW_ROWS = CSV_IMPORT_PREVIEW_ROWS;
+/** The same caps the lead's own cards hold a typed value to. */ export const LEAD_IMPORT_NOTES_MAX = 4000;
+export const LEAD_IMPORT_REASON_MAX = 500;
+/** A person's name, capped where every other import caps one. */ const NAME_MAX = 120;
+/**
+ * The statuses a file may set.
+ *
+ * The list's own status control offers exactly these three, 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');
+/** The fields a column may be mapped to, in the order the mapping menu lists them. */ export const LEAD_IMPORT_FIELDS = [
+    'email',
+    'name',
+    'status',
+    'ownerEmail',
+    'unqualifiedReason',
+    'notes'
+];
+/** How each field reads in the mapping menu. Typed so a field cannot ship unlabeled. */ export const LEAD_IMPORT_FIELD_LABELS = {
+    email: 'Email (required)',
+    name: 'Name',
+    status: 'Status (new, working, unqualified)',
+    ownerEmail: 'Owner (team member email)',
+    unqualifiedReason: 'Unqualified reason',
+    notes: 'Notes'
+};
+/**
+ * Header aliases per field, matched after the shared header normalization.
+ *
+ * First in each list is the header this CRM's own leads export writes, so
+ * an export re-imports without a hand mapping; the export's Sources, First
+ * seen, Last seen, Captures, Converted and Site columns are deliberately
+ * absent from every list, so they land on "Do not import".
+ */ const FIELD_ALIASES = {
+    email: [
+        'email',
+        'email address',
+        'e mail',
+        'mail',
+        'contact email',
+        'work email'
+    ],
+    name: [
+        'name',
+        'full name',
+        'lead',
+        'lead name',
+        'contact',
+        'contact name',
+        'person'
+    ],
+    status: [
+        'status',
+        'lead status',
+        'stage',
+        'lead stage',
+        'state'
+    ],
+    ownerEmail: [
+        'owner',
+        'owner email',
+        'assigned to',
+        'assignee',
+        'rep',
+        'sales rep'
+    ],
+    unqualifiedReason: [
+        'unqualified reason',
+        'reason',
+        'disqualified reason',
+        'lost reason',
+        'reason lost'
+    ],
+    notes: [
+        'notes',
+        'note',
+        'description',
+        'comments',
+        'details'
+    ]
+};
+const FIELD_ALIAS_KEYS = importAliasKeys(LEAD_IMPORT_FIELDS, FIELD_ALIASES);
+/** A proposed mapping from a file's header row, each field taken at most once. */ export function guessLeadImportMapping(columns) {
+    return guessImportMapping(columns, LEAD_IMPORT_FIELDS, FIELD_ALIAS_KEYS);
+}
+/** One parsed line under the mapping. Empty cells are left absent; a lead has no custom fields. */ export function mapLeadImportRow(cells, mapping) {
+    const _mapImportRow = mapImportRow(cells, mapping), { custom: _custom } = _mapImportRow, row = _object_without_properties_loose(_mapImportRow, [
+        "custom"
+    ]);
+    return row;
+}
+/** How a skip reason reads on screen and in the downloaded file. */ export const LEAD_IMPORT_SKIP_LABELS = {
+    'invalid-email': 'No usable email address',
+    duplicate: 'The same address appears earlier in this file',
+    'lead-ceiling': 'This site is at the platform lead limit',
+    'write-failed': 'Could not be saved'
+};
+/**
+ * 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
+ * includes the well-spelled `Qualified` the export writes for a converted
+ * lead.
+ */ export function parseImportLeadStatus(value) {
+    var _LEAD_IMPORT_STATUSES_find;
+    const text = String(value != null ? value : '').trim().toLowerCase();
+    if (!text) return null;
+    const byId = isCrmLeadStatus(text) ? text : null;
+    const byLabel = (_LEAD_IMPORT_STATUSES_find = LEAD_IMPORT_STATUSES.find((status)=>CRM_LEAD_STATUS_LABELS[status].toLowerCase() === text)) != null ? _LEAD_IMPORT_STATUSES_find : null;
+    const status = byId != null ? byId : byLabel;
+    return status && LEAD_IMPORT_STATUSES.includes(status) ? status : null;
+}
+/**
+ * One raw row as the values that will be written, or the reason it cannot
+ * be. Refused here only for an unusable address, because the address is
+ * the document id; the owner is refused by the server, which alone can
+ * look them up.
+ */ export function normalizeLeadImportRow(raw) {
+    var _importTextValue;
+    var _importTextValue1;
+    const emailText = (_importTextValue = importTextValue(raw.email, 320)) != null ? _importTextValue : '';
+    const email = normalizeContactEmail(emailText);
+    if (!email) {
+        return {
+            ok: false,
+            reason: 'invalid-email',
+            input: emailText
+        };
+    }
+    const dropped = [];
+    const drop = (field, value)=>{
+        dropped.push({
+            field,
+            value: String(value != null ? value : '').trim()
+        });
+    };
+    const row = {
+        email,
+        dropped
+    };
+    const name = (_importTextValue1 = importTextValue(raw.name, NAME_MAX)) == null ? void 0 : _importTextValue1.replace(/\s+/g, ' ');
+    if (name) row.name = name;
+    const statusText = importTextValue(raw.status, 32);
+    if (statusText) {
+        const status = parseImportLeadStatus(statusText);
+        if (status) row.status = status;
+        else drop('status', statusText);
+    }
+    const ownerText = importTextValue(raw.ownerEmail, 320);
+    if (ownerText) {
+        const owner = normalizeContactEmail(ownerText);
+        if (owner) row.ownerEmail = owner;
+        else drop('ownerEmail', ownerText);
+    }
+    /*
+   * The reason belongs to the status: it is what an unqualified lead was
+   * closed FOR, and on a lead that is not unqualified it describes
+   * nothing. A row that carries one without the other keeps the status and
+   * reports the reason, so a mis-mapped column is visible rather than
+   * stored where nothing reads it.
+   */ const reasonText = importTextValue(raw.unqualifiedReason, LEAD_IMPORT_REASON_MAX);
+    if (reasonText) {
+        if (row.status === 'unqualified') row.unqualifiedReason = reasonText;
+        else drop('unqualifiedReason', reasonText);
+    }
+    const notes = importTextValue(raw.notes, LEAD_IMPORT_NOTES_MAX);
+    if (notes) row.notes = notes;
+    return {
+        ok: true,
+        row
+    };
+}
+export function emptyLeadImportResult() {
+    return emptyImportResult();
+}
+export function mergeLeadImportResults(total, chunk, offset = 0) {
+    return mergeImportResults(total, chunk, offset);
+}
+/** The skipped rows as a file the operator can fix and re-import. */ export function leadImportSkippedCsv(columns, entries) {
+    return importSkippedCsv(columns, entries, LEAD_IMPORT_SKIP_LABELS);
+}
+
+//# sourceMappingURL=crm-lead-import.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/crm/src/lib/model/crm-lead-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 LEADS INTO THE CRM — the pure half (AGL-2701).\n *\n * The contact import's three stages (`crm-import.ts`) over the lead\n * vocabulary. A lead is the one CRM record a person does not type: it is\n * what a capture door wrote when somebody signed up, booked or submitted a\n * form, plus the working state the team wrote on top. A file therefore\n * carries HALF a lead — the person, and the team's annotations — and the\n * capture half is the door's to write.\n *\n * ## The address is the identity, because it is the document id\n *\n * A lead lives at `hosts/{hostId}/leads/{personKey}`, and `personKey` is\n * the sha256 of the normalized address. So the address is not merely the\n * one required cell: it is the row's name. A cell the normalizer cannot\n * read is refused as `invalid-email`, and two rows of one file that\n * normalize to the same address are one person — the second is skipped as\n * `duplicate` rather than merged onto the first, for the reason the\n * contacts import gives: one person reported once created and once merged\n * is a number the operator cannot reconcile against the rows they sent.\n *\n * ## What a file may NOT say\n *\n * The export's `Sources`, `First seen`, `Last seen` and `Captures` columns\n * are the capture door's own record of what the visitor did, and\n * `Converted` is stamped by `crm/lead-convert` after the contact exists.\n * None of them is a field here, so the mapping leaves those columns\n * unmapped rather than mis-mapping them — a file that could write\n * \"first seen\" could rewrite the history it is supposed to describe. The\n * organization-level file's `Site` column is left out for a second reason:\n * the site is the drawer's question and the route's permission is granted\n * for that ONE site, so a cell must not be able to redirect a row to\n * another.\n *\n * ## Qualified is a conversion, not a status a cell can claim\n *\n * `qualified` means a lead BECAME a contact, and `convertedContactId`\n * beside it names the contact that was really created. Only the convert\n * route writes the pair, so the list's own status control offers new,\n * working and unqualified and nothing else. A cell naming `qualified` is\n * dropped and reported here for the same reason: a status claiming a\n * conversion that never happened would show a contact link to nowhere.\n *\n * ## A bad cell is dropped and named; a bad row is skipped and named\n *\n * The address is the only cell that can make a row unstorable. An\n * unreadable status, or an unqualified reason with no unqualified status\n * to belong to, is left off the lead and REPORTED under\n * {@link LeadImportRow.dropped}, so the operator learns that a column went\n * nowhere rather than discovering it weeks later.\n */\n\nimport { normalizeContactEmail } from '@aglyn/aglyn/app-utils/contacts'\nimport {\n  CRM_LEAD_STATUS_LABELS,\n  CRM_LEAD_STATUSES,\n  type CrmLeadStatus,\n  isCrmLeadStatus,\n} from '@aglyn/aglyn/app-utils/crm'\nimport {\n  CSV_IMPORT_CHUNK_SIZE,\n  CSV_IMPORT_MAX_BODY_BYTES,\n  CSV_IMPORT_MAX_ROWS,\n  CSV_IMPORT_PREVIEW_ROWS,\n  emptyImportResult,\n  guessImportMapping,\n  importAliasKeys,\n  type ImportChunkResult,\n  type ImportDroppedValue,\n  importSkippedCsv,\n  importTextValue,\n  mapImportRow,\n  mergeImportResults,\n} from '@aglyn/aglyn/app-utils/csv-import'\n\n/** The shared ceilings, under this collection's names. */\nexport const LEAD_IMPORT_MAX_ROWS = CSV_IMPORT_MAX_ROWS\nexport const LEAD_IMPORT_CHUNK_SIZE = CSV_IMPORT_CHUNK_SIZE\nexport const LEAD_IMPORT_MAX_BODY_BYTES = CSV_IMPORT_MAX_BODY_BYTES\nexport const LEAD_IMPORT_PREVIEW_ROWS = CSV_IMPORT_PREVIEW_ROWS\n\n/** The same caps the lead's own cards hold a typed value to. */\nexport const LEAD_IMPORT_NOTES_MAX = 4000\nexport const LEAD_IMPORT_REASON_MAX = 500\n\n/** A person's name, capped where every other import caps one. */\nconst NAME_MAX = 120\n\n/**\n * The statuses a file may set.\n *\n * The list's own status control offers exactly these three, and for the\n * reason given above: `qualified` is written by the conversion, beside the\n * contact it produced.\n */\nexport const LEAD_IMPORT_STATUSES: readonly CrmLeadStatus[] =\n  CRM_LEAD_STATUSES.filter((status) => status !== 'qualified')\n\n/** The fields a column may be mapped to, in the order the mapping menu lists them. */\nexport const LEAD_IMPORT_FIELDS = [\n  'email',\n  'name',\n  'status',\n  'ownerEmail',\n  'unqualifiedReason',\n  'notes',\n] as const\n\nexport type LeadImportField = (typeof LEAD_IMPORT_FIELDS)[number]\n\n/** How each field reads in the mapping menu. Typed so a field cannot ship unlabeled. */\nexport const LEAD_IMPORT_FIELD_LABELS: Record<LeadImportField, string> = {\n  email: 'Email (required)',\n  name: 'Name',\n  status: 'Status (new, working, unqualified)',\n  ownerEmail: 'Owner (team member email)',\n  unqualifiedReason: 'Unqualified reason',\n  notes: 'Notes',\n}\n\n/**\n * Header aliases per field, matched after the shared header normalization.\n *\n * First in each list is the header this CRM's own leads export writes, so\n * an export re-imports without a hand mapping; the export's Sources, First\n * seen, Last seen, Captures, Converted and Site columns are deliberately\n * absent from every list, so they land on \"Do not import\".\n */\nconst FIELD_ALIASES: Record<LeadImportField, readonly string[]> = {\n  email: ['email', 'email address', 'e mail', 'mail', 'contact email', 'work email'],\n  name: ['name', 'full name', 'lead', 'lead name', 'contact', 'contact name', 'person'],\n  status: ['status', 'lead status', 'stage', 'lead stage', 'state'],\n  ownerEmail: ['owner', 'owner email', 'assigned to', 'assignee', 'rep', 'sales rep'],\n  unqualifiedReason: [\n    'unqualified reason',\n    'reason',\n    'disqualified reason',\n    'lost reason',\n    'reason lost',\n  ],\n  notes: ['notes', 'note', 'description', 'comments', 'details'],\n}\n\nconst FIELD_ALIAS_KEYS = importAliasKeys(LEAD_IMPORT_FIELDS, FIELD_ALIASES)\n\n/** Column index → field. A column absent from the map is not imported. */\nexport type LeadImportMapping = Record<number, LeadImportField>\n\n/** A proposed mapping from a file's header row, each field taken at most once. */\nexport function guessLeadImportMapping(columns: readonly string[]): LeadImportMapping {\n  return guessImportMapping(columns, LEAD_IMPORT_FIELDS, FIELD_ALIAS_KEYS)\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. `unknown` because the\n * server reads this off an untrusted body.\n */\nexport type LeadImportRawRow = Partial<Record<LeadImportField, unknown>>\n\n/** One parsed line under the mapping. Empty cells are left absent; a lead has no custom fields. */\nexport function mapLeadImportRow(\n  cells: readonly string[],\n  mapping: Record<number, LeadImportField | `custom:${string}`>,\n): LeadImportRawRow {\n  const { custom: _custom, ...row } = mapImportRow(cells, mapping)\n  return row\n}\n\nexport type LeadImportSkipReason =\n  | 'invalid-email'\n  | 'duplicate'\n  | 'lead-ceiling'\n  | 'write-failed'\n\n/** How a skip reason reads on screen and in the downloaded file. */\nexport const LEAD_IMPORT_SKIP_LABELS: Record<LeadImportSkipReason, string> = {\n  'invalid-email': 'No usable email address',\n  duplicate: 'The same address appears earlier in this file',\n  'lead-ceiling': 'This site is at the platform lead limit',\n  'write-failed': 'Could not be saved',\n}\n\n/** One row, ready for the server to resolve and write. */\nexport interface LeadImportRow {\n  /** Normalized — the address `personKey` derives the document id from. */\n  email: string\n  name?: string\n  /** Absent leaves an existing lead's status alone and a new one reading as `new`. */\n  status?: CrmLeadStatus\n  /** Normalized, for the server to resolve against the org's members. */\n  ownerEmail?: string\n  /** Only ever set beside `status: 'unqualified'` — the pair is one fact. */\n  unqualifiedReason?: string\n  notes?: string\n  dropped: ImportDroppedValue[]\n}\n\nexport type LeadImportRowVerdict =\n  | { ok: true; row: LeadImportRow }\n  | { ok: false; reason: 'invalid-email'; input: string }\n\n/**\n * A status cell by id or by label — `working`, `Working` and `WORKING` are\n * one status. `null` for a cell naming no status a file may set, which\n * includes the well-spelled `Qualified` the export writes for a converted\n * lead.\n */\nexport function parseImportLeadStatus(value: unknown): CrmLeadStatus | null {\n  const text = String(value ?? '')\n    .trim()\n    .toLowerCase()\n  if (!text) return null\n  const byId = isCrmLeadStatus(text) ? text : null\n  const byLabel =\n    LEAD_IMPORT_STATUSES.find(\n      (status) => CRM_LEAD_STATUS_LABELS[status].toLowerCase() === text,\n    ) ?? null\n  const status = byId ?? byLabel\n  return status && LEAD_IMPORT_STATUSES.includes(status) ? status : null\n}\n\n/**\n * One raw row as the values that will be written, or the reason it cannot\n * be. Refused here only for an unusable address, because the address is\n * the document id; the owner is refused by the server, which alone can\n * look them up.\n */\nexport function normalizeLeadImportRow(raw: LeadImportRawRow): LeadImportRowVerdict {\n  const emailText = importTextValue(raw.email, 320) ?? ''\n  const email = normalizeContactEmail(emailText)\n  if (!email) {\n    return { ok: false, reason: 'invalid-email', input: emailText }\n  }\n  const dropped: ImportDroppedValue[] = []\n  const drop = (field: LeadImportField, value: unknown) => {\n    dropped.push({ field, value: String(value ?? '').trim() })\n  }\n  const row: LeadImportRow = { email, dropped }\n\n  const name = importTextValue(raw.name, NAME_MAX)?.replace(/\\s+/g, ' ')\n  if (name) row.name = name\n\n  const statusText = importTextValue(raw.status, 32)\n  if (statusText) {\n    const status = parseImportLeadStatus(statusText)\n    if (status) row.status = status\n    else drop('status', statusText)\n  }\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  /*\n   * The reason belongs to the status: it is what an unqualified lead was\n   * closed FOR, and on a lead that is not unqualified it describes\n   * nothing. A row that carries one without the other keeps the status and\n   * reports the reason, so a mis-mapped column is visible rather than\n   * stored where nothing reads it.\n   */\n  const reasonText = importTextValue(raw.unqualifiedReason, LEAD_IMPORT_REASON_MAX)\n  if (reasonText) {\n    if (row.status === 'unqualified') row.unqualifiedReason = reasonText\n    else drop('unqualifiedReason', reasonText)\n  }\n\n  const notes = importTextValue(raw.notes, LEAD_IMPORT_NOTES_MAX)\n  if (notes) row.notes = notes\n\n  return { ok: true, row }\n}\n\n/** One row the server did not store, by its index in the request, named by the address. */\nexport interface LeadImportSkippedRow {\n  index: number\n  email: string\n  reason: LeadImportSkipReason\n}\n\n/** What one request did. The drawer sums these across a file. */\nexport type LeadImportChunkResult = ImportChunkResult<LeadImportSkippedRow>\n\nexport function emptyLeadImportResult(): LeadImportChunkResult {\n  return emptyImportResult<LeadImportSkippedRow>()\n}\n\nexport function mergeLeadImportResults(\n  total: LeadImportChunkResult,\n  chunk: LeadImportChunkResult,\n  offset = 0,\n): LeadImportChunkResult {\n  return mergeImportResults(total, chunk, offset)\n}\n\n/** The skipped rows as a file the operator can fix and re-import. */\nexport function leadImportSkippedCsv(\n  columns: readonly string[],\n  entries: readonly { cells: readonly string[]; reason: LeadImportSkipReason }[],\n): string {\n  return importSkippedCsv(columns, entries, LEAD_IMPORT_SKIP_LABELS)\n}\n"],"names":["normalizeContactEmail","CRM_LEAD_STATUS_LABELS","CRM_LEAD_STATUSES","isCrmLeadStatus","CSV_IMPORT_CHUNK_SIZE","CSV_IMPORT_MAX_BODY_BYTES","CSV_IMPORT_MAX_ROWS","CSV_IMPORT_PREVIEW_ROWS","emptyImportResult","guessImportMapping","importAliasKeys","importSkippedCsv","importTextValue","mapImportRow","mergeImportResults","LEAD_IMPORT_MAX_ROWS","LEAD_IMPORT_CHUNK_SIZE","LEAD_IMPORT_MAX_BODY_BYTES","LEAD_IMPORT_PREVIEW_ROWS","LEAD_IMPORT_NOTES_MAX","LEAD_IMPORT_REASON_MAX","NAME_MAX","LEAD_IMPORT_STATUSES","filter","status","LEAD_IMPORT_FIELDS","LEAD_IMPORT_FIELD_LABELS","email","name","ownerEmail","unqualifiedReason","notes","FIELD_ALIASES","FIELD_ALIAS_KEYS","guessLeadImportMapping","columns","mapLeadImportRow","cells","mapping","custom","_custom","row","LEAD_IMPORT_SKIP_LABELS","duplicate","parseImportLeadStatus","value","text","String","trim","toLowerCase","byId","byLabel","find","includes","normalizeLeadImportRow","raw","emailText","ok","reason","input","dropped","drop","field","push","replace","statusText","ownerText","owner","reasonText","emptyLeadImportResult","mergeLeadImportResults","total","chunk","offset","leadImportSkippedCsv","entries"],"mappings":"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"}

package/src/lib/model/crm-record-routes.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @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 one narrowing the contacts list publishes: the form that captured them. */
+export declare const CRM_CONTACT_FILTER_FORM = "form";
+/**
+ * Called from the console registrar. The owner is named rather than read off
+ * the loader's marker, so the routes register the same way under a spec that
+ * calls the registrar directly.
+ */
+export declare function registerCrmRecordRoutes(): void;

package/src/lib/model/crm-record-routes.js

@@ -0,0 +1,70 @@
+/**
+ * @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 { buildRoute, Route } from "@aglyn/aglyn/app-utils/console-routes";
+import { registerPluginRecordRoute } from "@aglyn/aglyn/plugin-manager/plugin-record-routes";
+import { BUNDLE_ID } from "../constants/bundle-common.js";
+import { crmRoutes } from "./crm-routes.js";
+/**
+ * Where the CRM's records are read, published for every other surface.
+ *
+ * The Inbox links a lead, a submission links its sender, a form links the
+ * people it captured. Each used to import {@link crmRoutes} and spell the
+ * CRM's nav slug to do it, which made every one of them a reader of this
+ * plugin's address table. They ask the record-route registry now, and get
+ * `null` — text instead of a link — in a workspace where the CRM is not
+ * loaded, which is also the first time that link stopped pointing at a page
+ * the workspace cannot open.
+ */ /** The nav slug the shell resolves this plugin's hub by, at either scope. */ const CRM_SLUG = 'crm';
+function hub(context) {
+    return crmRoutes(context.host ? buildRoute(Route.HOST_PLUGIN, {
+        orgSlug: context.orgSlug,
+        host: context.host,
+        pluginSlug: CRM_SLUG
+    }) : buildRoute(Route.ORG_PLUGIN, {
+        orgSlug: context.orgSlug,
+        pluginSlug: CRM_SLUG
+    }));
+}
+/** The one narrowing the contacts list publishes: the form that captured them. */ export const CRM_CONTACT_FILTER_FORM = 'form';
+/**
+ * Called from the console registrar. The owner is named rather than read off
+ * the loader's marker, so the routes register the same way under a spec that
+ * calls the registrar directly.
+ */ export function registerCrmRecordRoutes() {
+    const owner = {
+        pluginId: BUNDLE_ID
+    };
+    registerPluginRecordRoute('contact', {
+        list: (context)=>hub(context).section('contacts'),
+        record: (context, id)=>hub(context).contact(id),
+        byEmail: (context, email)=>hub(context).contactByEmail(email),
+        filtered: (context, filter, value)=>filter === CRM_CONTACT_FILTER_FORM ? hub(context).contactsByForm(value) : null
+    }, owner);
+    registerPluginRecordRoute('lead', {
+        list: (context)=>hub(context).section('leads'),
+        // A lead is keyed by person under ONE site, so the organization's hub
+        // addresses it by site and id; a caller that names no site has no
+        // address to be given.
+        record: (context, id)=>context.host ? hub(context).lead(id) : null
+    }, owner);
+    registerPluginRecordRoute('company', {
+        list: (context)=>hub(context).section('companies'),
+        record: (context, id)=>hub(context).company(id)
+    }, owner);
+    registerPluginRecordRoute('deal', {
+        list: (context)=>hub(context).section('deals'),
+        record: (context, id)=>hub(context).deal(id)
+    }, owner);
+}
+
+//# sourceMappingURL=crm-record-routes.js.map

package/src/lib/model/crm-record-routes.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/crm/src/lib/model/crm-record-routes.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\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 *   http://www.apache.org/licenses/LICENSE-2.0\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 { buildRoute, Route } from '@aglyn/aglyn/app-utils/console-routes'\nimport {\n  registerPluginRecordRoute,\n  type PluginRecordRouteContext,\n} from '@aglyn/aglyn/plugin-manager/plugin-record-routes'\nimport { BUNDLE_ID } from '../constants/bundle-common'\nimport { crmRoutes, type CrmRoutes } from './crm-routes'\n\n/**\n * Where the CRM's records are read, published for every other surface.\n *\n * The Inbox links a lead, a submission links its sender, a form links the\n * people it captured. Each used to import {@link crmRoutes} and spell the\n * CRM's nav slug to do it, which made every one of them a reader of this\n * plugin's address table. They ask the record-route registry now, and get\n * `null` — text instead of a link — in a workspace where the CRM is not\n * loaded, which is also the first time that link stopped pointing at a page\n * the workspace cannot open.\n */\n\n/** The nav slug the shell resolves this plugin's hub by, at either scope. */\nconst CRM_SLUG = 'crm'\n\nfunction hub(context: PluginRecordRouteContext): CrmRoutes {\n  return crmRoutes(\n    context.host\n      ? buildRoute(Route.HOST_PLUGIN, {\n          orgSlug: context.orgSlug,\n          host: context.host,\n          pluginSlug: CRM_SLUG,\n        })\n      : buildRoute(Route.ORG_PLUGIN, {\n          orgSlug: context.orgSlug,\n          pluginSlug: CRM_SLUG,\n        }),\n  )\n}\n\n/** The one narrowing the contacts list publishes: the form that captured them. */\nexport const CRM_CONTACT_FILTER_FORM = 'form'\n\n/**\n * Called from the console registrar. The owner is named rather than read off\n * the loader's marker, so the routes register the same way under a spec that\n * calls the registrar directly.\n */\nexport function registerCrmRecordRoutes(): void {\n  const owner = { pluginId: BUNDLE_ID }\n  registerPluginRecordRoute('contact', {\n    list: (context) => hub(context).section('contacts'),\n    record: (context, id) => hub(context).contact(id),\n    byEmail: (context, email) => hub(context).contactByEmail(email),\n    filtered: (context, filter, value) =>\n      filter === CRM_CONTACT_FILTER_FORM\n        ? hub(context).contactsByForm(value)\n        : null,\n  }, owner)\n  registerPluginRecordRoute('lead', {\n    list: (context) => hub(context).section('leads'),\n    // A lead is keyed by person under ONE site, so the organization's hub\n    // addresses it by site and id; a caller that names no site has no\n    // address to be given.\n    record: (context, id) => (context.host ? hub(context).lead(id) : null),\n  }, owner)\n  registerPluginRecordRoute('company', {\n    list: (context) => hub(context).section('companies'),\n    record: (context, id) => hub(context).company(id),\n  }, owner)\n  registerPluginRecordRoute('deal', {\n    list: (context) => hub(context).section('deals'),\n    record: (context, id) => hub(context).deal(id),\n  }, owner)\n}\n"],"names":["buildRoute","Route","registerPluginRecordRoute","BUNDLE_ID","crmRoutes","CRM_SLUG","hub","context","host","HOST_PLUGIN","orgSlug","pluginSlug","ORG_PLUGIN","CRM_CONTACT_FILTER_FORM","registerCrmRecordRoutes","owner","pluginId","list","section","record","id","contact","byEmail","email","contactByEmail","filtered","filter","value","contactsByForm","lead","company","deal"],"mappings":"AAAA;;;;;;;;;;;;CAYC,GAED,SAASA,UAAU,EAAEC,KAAK,QAAQ,wCAAuC;AACzE,SACEC,yBAAyB,QAEpB,mDAAkD;AACzD,SAASC,SAAS,QAAQ,gCAA4B;AACtD,SAASC,SAAS,QAAwB,kBAAc;AAExD;;;;;;;;;;CAUC,GAED,2EAA2E,GAC3E,MAAMC,WAAW;AAEjB,SAASC,IAAIC,OAAiC;IAC5C,OAAOH,UACLG,QAAQC,IAAI,GACRR,WAAWC,MAAMQ,WAAW,EAAE;QAC5BC,SAASH,QAAQG,OAAO;QACxBF,MAAMD,QAAQC,IAAI;QAClBG,YAAYN;IACd,KACAL,WAAWC,MAAMW,UAAU,EAAE;QAC3BF,SAASH,QAAQG,OAAO;QACxBC,YAAYN;IACd;AAER;AAEA,gFAAgF,GAChF,OAAO,MAAMQ,0BAA0B,OAAM;AAE7C;;;;CAIC,GACD,OAAO,SAASC;IACd,MAAMC,QAAQ;QAAEC,UAAUb;IAAU;IACpCD,0BAA0B,WAAW;QACnCe,MAAM,CAACV,UAAYD,IAAIC,SAASW,OAAO,CAAC;QACxCC,QAAQ,CAACZ,SAASa,KAAOd,IAAIC,SAASc,OAAO,CAACD;QAC9CE,SAAS,CAACf,SAASgB,QAAUjB,IAAIC,SAASiB,cAAc,CAACD;QACzDE,UAAU,CAAClB,SAASmB,QAAQC,QAC1BD,WAAWb,0BACPP,IAAIC,SAASqB,cAAc,CAACD,SAC5B;IACR,GAAGZ;IACHb,0BAA0B,QAAQ;QAChCe,MAAM,CAACV,UAAYD,IAAIC,SAASW,OAAO,CAAC;QACxC,sEAAsE;QACtE,kEAAkE;QAClE,uBAAuB;QACvBC,QAAQ,CAACZ,SAASa,KAAQb,QAAQC,IAAI,GAAGF,IAAIC,SAASsB,IAAI,CAACT,MAAM;IACnE,GAAGL;IACHb,0BAA0B,WAAW;QACnCe,MAAM,CAACV,UAAYD,IAAIC,SAASW,OAAO,CAAC;QACxCC,QAAQ,CAACZ,SAASa,KAAOd,IAAIC,SAASuB,OAAO,CAACV;IAChD,GAAGL;IACHb,0BAA0B,QAAQ;QAChCe,MAAM,CAACV,UAAYD,IAAIC,SAASW,OAAO,CAAC;QACxCC,QAAQ,CAACZ,SAASa,KAAOd,IAAIC,SAASwB,IAAI,CAACX;IAC7C,GAAGL;AACL"}

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

@@ -0,0 +1,101 @@
+/**
+ * @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 ConsolePluginPageProps } from '@aglyn/aglyn';
+import type { CrmConsoleSectionId } from '../components/crm-console-sections';
+/**
+ * Every address inside the Contacts surface, built from the one string the
+ * shell hands the page (AGL-2595).
+ *
+ * The hub owns three kinds of deeper route — `people/{contactId}`,
+ * `companies/{companyId}`, `deals/{dealId}` — and eight surfaces link into
+ * them: a deal names its contact and company, a task names all three, a
+ * report drills into a deal, an activity names whoever it happened with.
+ * Eight surfaces each spelling `${basePath}/people/${id}` is eight places
+ * for one of them to spell it `contacts/`, and a link that 404s inside the
+ * hub is indistinguishable from a record that was deleted.
+ *
+ * The id is URL-encoded because Firestore ids are opaque: the console mints
+ * them, but an import or an API caller may not, and a slash in an id would
+ * otherwise read as a further segment.
+ */
+export declare function crmRoutes(basePath: string): {
+    section: (id: CrmConsoleSectionId) => string;
+    contact: (id: string) => string;
+    /**
+     * The Contacts list narrowed to the people one form captured (AGL-2612):
+     * source `form`, and the `formIds` filter on the form's id. The form's
+     * own page links here; the list reads the two keys back through
+     * `contactsListSeed`, which is the other half of this address.
+     */
+    contactsByForm: (formId: string) => string;
+    /**
+     * The Contacts list asked to OPEN the one person with this address
+     * (AGL-2612). The list is the lookup: a contact's id is minted at
+     * capture and nothing outside the CRM holds it, so a surface that has
+     * only an email — an Inbox submission row — links here, the list
+     * filters on the address (a whole-collection query, under the scope
+     * the viewer may read) and moves straight on to the record when exactly
+     * one matches. No match leaves the filtered list on screen, which is
+     * the honest answer for a submission whose contact the band dropped.
+     */
+    contactByEmail: (email: string) => string;
+    /**
+     * A lead's page — and, at the ORGANIZATION level (AGL-2630), the site
+     * it lives under, as a segment before the id: a lead's id is a person
+     * key, the same on every site that met the person, and `hosts/{hostId}
+     * /leads` is host-scoped by path, so an address that spans sites has to
+     * name one. Under a site the address is the id alone, as it always was.
+     */
+    lead: (id: string, hostId?: string | null) => string;
+    company: (id: string) => string;
+    deal: (id: string) => string;
+    /**
+     * A section opened on one of its saved views (AGL-2617). The list reads
+     * the key back through `crmViewIdFromParams`; the same key composes
+     * with the Contacts seeds above, which is why it is a query key and not
+     * a path segment.
+     */
+    sectionView: (id: CrmConsoleSectionId, viewId: string) => string;
+};
+/**
+ * The query keys the Contacts list reads on arrival — written by the two
+ * builders above and parsed by `contactsListSeed`, named once so neither
+ * side can misspell the other.
+ */
+export declare const CONTACTS_LIST_SOURCE_PARAM = "source";
+export declare const CONTACTS_LIST_FORM_PARAM = "formId";
+/**
+ * The email key is the SHARED constant (AGL-2622): the console app — which
+ * the module boundaries keep from importing this plugin — builds the same
+ * address through `crmContactByEmailHref`, and `crm-routes.spec.ts` pins
+ * `contactByEmail` against it so the plugin and the app cannot spell the
+ * key two ways.
+ */
+export declare const CONTACTS_LIST_EMAIL_PARAM = "email";
+export type CrmRoutes = ReturnType<typeof crmRoutes>;
+/**
+ * What the hub hands a record page: the shell's context, the record's id and
+ * the surface's own path so the page can link back to its list.
+ *
+ * `basePath` is required here where the shell's prop is optional, because a
+ * record page is only ever reached THROUGH the hub, which has already refused
+ * to render without one.
+ */
+export type CrmDetailPageProps = Pick<ConsolePluginPageProps, 'hostId' | 'org' | 'permissions' | 'releaseFlag' | 'hostRole'> & {
+    id: string;
+    basePath: string;
+};

package/src/lib/model/crm-routes.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.
+ */ import { CRM_CONTACTS_EMAIL_PARAM } from "@aglyn/aglyn";
+import { CRM_VIEW_PARAM } from "./crm-view-param.js";
+/**
+ * Every address inside the Contacts surface, built from the one string the
+ * shell hands the page (AGL-2595).
+ *
+ * The hub owns three kinds of deeper route — `people/{contactId}`,
+ * `companies/{companyId}`, `deals/{dealId}` — and eight surfaces link into
+ * them: a deal names its contact and company, a task names all three, a
+ * report drills into a deal, an activity names whoever it happened with.
+ * Eight surfaces each spelling `${basePath}/people/${id}` is eight places
+ * for one of them to spell it `contacts/`, and a link that 404s inside the
+ * hub is indistinguishable from a record that was deleted.
+ *
+ * The id is URL-encoded because Firestore ids are opaque: the console mints
+ * them, but an import or an API caller may not, and a slash in an id would
+ * otherwise read as a further segment.
+ */ export function crmRoutes(basePath) {
+    const section = (id)=>`${basePath}/${id}`;
+    return {
+        section,
+        contact: (id)=>`${section('contacts')}/${encodeURIComponent(id)}`,
+        /**
+     * The Contacts list narrowed to the people one form captured (AGL-2612):
+     * source `form`, and the `formIds` filter on the form's id. The form's
+     * own page links here; the list reads the two keys back through
+     * `contactsListSeed`, which is the other half of this address.
+     */ contactsByForm: (formId)=>`${section('contacts')}?${new URLSearchParams({
+                [CONTACTS_LIST_SOURCE_PARAM]: 'form',
+                [CONTACTS_LIST_FORM_PARAM]: formId
+            }).toString()}`,
+        /**
+     * The Contacts list asked to OPEN the one person with this address
+     * (AGL-2612). The list is the lookup: a contact's id is minted at
+     * capture and nothing outside the CRM holds it, so a surface that has
+     * only an email — an Inbox submission row — links here, the list
+     * filters on the address (a whole-collection query, under the scope
+     * the viewer may read) and moves straight on to the record when exactly
+     * one matches. No match leaves the filtered list on screen, which is
+     * the honest answer for a submission whose contact the band dropped.
+     */ contactByEmail: (email)=>`${section('contacts')}?${new URLSearchParams({
+                [CONTACTS_LIST_EMAIL_PARAM]: email
+            }).toString()}`,
+        /**
+     * A lead's page — and, at the ORGANIZATION level (AGL-2630), the site
+     * it lives under, as a segment before the id: a lead's id is a person
+     * key, the same on every site that met the person, and `hosts/{hostId}
+     * /leads` is host-scoped by path, so an address that spans sites has to
+     * name one. Under a site the address is the id alone, as it always was.
+     */ lead: (id, hostId)=>hostId ? `${section('leads')}/${encodeURIComponent(hostId)}/${encodeURIComponent(id)}` : `${section('leads')}/${encodeURIComponent(id)}`,
+        company: (id)=>`${section('companies')}/${encodeURIComponent(id)}`,
+        deal: (id)=>`${section('deals')}/${encodeURIComponent(id)}`,
+        /**
+     * A section opened on one of its saved views (AGL-2617). The list reads
+     * the key back through `crmViewIdFromParams`; the same key composes
+     * with the Contacts seeds above, which is why it is a query key and not
+     * a path segment.
+     */ sectionView: (id, viewId)=>`${section(id)}?${new URLSearchParams({
+                [CRM_VIEW_PARAM]: viewId
+            }).toString()}`
+    };
+}
+/**
+ * The query keys the Contacts list reads on arrival — written by the two
+ * builders above and parsed by `contactsListSeed`, named once so neither
+ * side can misspell the other.
+ */ export const CONTACTS_LIST_SOURCE_PARAM = 'source';
+export const CONTACTS_LIST_FORM_PARAM = 'formId';
+/**
+ * The email key is the SHARED constant (AGL-2622): the console app — which
+ * the module boundaries keep from importing this plugin — builds the same
+ * address through `crmContactByEmailHref`, and `crm-routes.spec.ts` pins
+ * `contactByEmail` against it so the plugin and the app cannot spell the
+ * key two ways.
+ */ export const CONTACTS_LIST_EMAIL_PARAM = CRM_CONTACTS_EMAIL_PARAM;
+
+//# sourceMappingURL=crm-routes.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/crm/src/lib/model/crm-routes.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 { CRM_CONTACTS_EMAIL_PARAM, type ConsolePluginPageProps } from '@aglyn/aglyn'\nimport type { CrmConsoleSectionId } from '../components/crm-console-sections'\nimport { CRM_VIEW_PARAM } from './crm-view-param'\n\n/**\n * Every address inside the Contacts surface, built from the one string the\n * shell hands the page (AGL-2595).\n *\n * The hub owns three kinds of deeper route — `people/{contactId}`,\n * `companies/{companyId}`, `deals/{dealId}` — and eight surfaces link into\n * them: a deal names its contact and company, a task names all three, a\n * report drills into a deal, an activity names whoever it happened with.\n * Eight surfaces each spelling `${basePath}/people/${id}` is eight places\n * for one of them to spell it `contacts/`, and a link that 404s inside the\n * hub is indistinguishable from a record that was deleted.\n *\n * The id is URL-encoded because Firestore ids are opaque: the console mints\n * them, but an import or an API caller may not, and a slash in an id would\n * otherwise read as a further segment.\n */\nexport function crmRoutes(basePath: string) {\n  const section = (id: CrmConsoleSectionId) => `${basePath}/${id}`\n  return {\n    section,\n    contact: (id: string) => `${section('contacts')}/${encodeURIComponent(id)}`,\n    /**\n     * The Contacts list narrowed to the people one form captured (AGL-2612):\n     * source `form`, and the `formIds` filter on the form's id. The form's\n     * own page links here; the list reads the two keys back through\n     * `contactsListSeed`, which is the other half of this address.\n     */\n    contactsByForm: (formId: string) =>\n      `${section('contacts')}?${new URLSearchParams({\n        [CONTACTS_LIST_SOURCE_PARAM]: 'form',\n        [CONTACTS_LIST_FORM_PARAM]: formId,\n      }).toString()}`,\n    /**\n     * The Contacts list asked to OPEN the one person with this address\n     * (AGL-2612). The list is the lookup: a contact's id is minted at\n     * capture and nothing outside the CRM holds it, so a surface that has\n     * only an email — an Inbox submission row — links here, the list\n     * filters on the address (a whole-collection query, under the scope\n     * the viewer may read) and moves straight on to the record when exactly\n     * one matches. No match leaves the filtered list on screen, which is\n     * the honest answer for a submission whose contact the band dropped.\n     */\n    contactByEmail: (email: string) =>\n      `${section('contacts')}?${new URLSearchParams({\n        [CONTACTS_LIST_EMAIL_PARAM]: email,\n      }).toString()}`,\n    /**\n     * A lead's page — and, at the ORGANIZATION level (AGL-2630), the site\n     * it lives under, as a segment before the id: a lead's id is a person\n     * key, the same on every site that met the person, and `hosts/{hostId}\n     * /leads` is host-scoped by path, so an address that spans sites has to\n     * name one. Under a site the address is the id alone, as it always was.\n     */\n    lead: (id: string, hostId?: string | null) =>\n      hostId\n        ? `${section('leads')}/${encodeURIComponent(hostId)}/${encodeURIComponent(id)}`\n        : `${section('leads')}/${encodeURIComponent(id)}`,\n    company: (id: string) => `${section('companies')}/${encodeURIComponent(id)}`,\n    deal: (id: string) => `${section('deals')}/${encodeURIComponent(id)}`,\n    /**\n     * A section opened on one of its saved views (AGL-2617). The list reads\n     * the key back through `crmViewIdFromParams`; the same key composes\n     * with the Contacts seeds above, which is why it is a query key and not\n     * a path segment.\n     */\n    sectionView: (id: CrmConsoleSectionId, viewId: string) =>\n      `${section(id)}?${new URLSearchParams({\n        [CRM_VIEW_PARAM]: viewId,\n      }).toString()}`,\n  }\n}\n\n/**\n * The query keys the Contacts list reads on arrival — written by the two\n * builders above and parsed by `contactsListSeed`, named once so neither\n * side can misspell the other.\n */\nexport const CONTACTS_LIST_SOURCE_PARAM = 'source'\nexport const CONTACTS_LIST_FORM_PARAM = 'formId'\n/**\n * The email key is the SHARED constant (AGL-2622): the console app — which\n * the module boundaries keep from importing this plugin — builds the same\n * address through `crmContactByEmailHref`, and `crm-routes.spec.ts` pins\n * `contactByEmail` against it so the plugin and the app cannot spell the\n * key two ways.\n */\nexport const CONTACTS_LIST_EMAIL_PARAM = CRM_CONTACTS_EMAIL_PARAM\n\nexport type CrmRoutes = ReturnType<typeof crmRoutes>\n\n/**\n * What the hub hands a record page: the shell's context, the record's id and\n * the surface's own path so the page can link back to its list.\n *\n * `basePath` is required here where the shell's prop is optional, because a\n * record page is only ever reached THROUGH the hub, which has already refused\n * to render without one.\n */\nexport type CrmDetailPageProps = Pick<\n  ConsolePluginPageProps,\n  'hostId' | 'org' | 'permissions' | 'releaseFlag' | 'hostRole'\n> & {\n  id: string\n  basePath: string\n}\n"],"names":["CRM_CONTACTS_EMAIL_PARAM","CRM_VIEW_PARAM","crmRoutes","basePath","section","id","contact","encodeURIComponent","contactsByForm","formId","URLSearchParams","CONTACTS_LIST_SOURCE_PARAM","CONTACTS_LIST_FORM_PARAM","toString","contactByEmail","email","CONTACTS_LIST_EMAIL_PARAM","lead","hostId","company","deal","sectionView","viewId"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,SAASA,wBAAwB,QAAqC,eAAc;AAEpF,SAASC,cAAc,QAAQ,sBAAkB;AAEjD;;;;;;;;;;;;;;;CAeC,GACD,OAAO,SAASC,UAAUC,QAAgB;IACxC,MAAMC,UAAU,CAACC,KAA4B,GAAGF,SAAS,CAAC,EAAEE,IAAI;IAChE,OAAO;QACLD;QACAE,SAAS,CAACD,KAAe,GAAGD,QAAQ,YAAY,CAAC,EAAEG,mBAAmBF,KAAK;QAC3E;;;;;KAKC,GACDG,gBAAgB,CAACC,SACf,GAAGL,QAAQ,YAAY,CAAC,EAAE,IAAIM,gBAAgB;gBAC5C,CAACC,2BAA2B,EAAE;gBAC9B,CAACC,yBAAyB,EAAEH;YAC9B,GAAGI,QAAQ,IAAI;QACjB;;;;;;;;;KASC,GACDC,gBAAgB,CAACC,QACf,GAAGX,QAAQ,YAAY,CAAC,EAAE,IAAIM,gBAAgB;gBAC5C,CAACM,0BAA0B,EAAED;YAC/B,GAAGF,QAAQ,IAAI;QACjB;;;;;;KAMC,GACDI,MAAM,CAACZ,IAAYa,SACjBA,SACI,GAAGd,QAAQ,SAAS,CAAC,EAAEG,mBAAmBW,QAAQ,CAAC,EAAEX,mBAAmBF,KAAK,GAC7E,GAAGD,QAAQ,SAAS,CAAC,EAAEG,mBAAmBF,KAAK;QACrDc,SAAS,CAACd,KAAe,GAAGD,QAAQ,aAAa,CAAC,EAAEG,mBAAmBF,KAAK;QAC5Ee,MAAM,CAACf,KAAe,GAAGD,QAAQ,SAAS,CAAC,EAAEG,mBAAmBF,KAAK;QACrE;;;;;KAKC,GACDgB,aAAa,CAAChB,IAAyBiB,SACrC,GAAGlB,QAAQC,IAAI,CAAC,EAAE,IAAIK,gBAAgB;gBACpC,CAACT,eAAe,EAAEqB;YACpB,GAAGT,QAAQ,IAAI;IACnB;AACF;AAEA;;;;CAIC,GACD,OAAO,MAAMF,6BAA6B,SAAQ;AAClD,OAAO,MAAMC,2BAA2B,SAAQ;AAChD;;;;;;CAMC,GACD,OAAO,MAAMI,4BAA4BhB,yBAAwB"}