@aglyn/plugins-crm 1.0.0-beta.143

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

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

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

@@ -0,0 +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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"}

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

@@ -0,0 +1,105 @@
+/**
+ * @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 CrmLeadStatus } from '@aglyn/aglyn/app-utils/crm';
+import { type ImportChunkResult, type ImportDroppedValue } from '@aglyn/aglyn/app-utils/csv-import';
+/** The shared ceilings, under this collection's names. */
+export declare const LEAD_IMPORT_MAX_ROWS = 5000;
+export declare const LEAD_IMPORT_CHUNK_SIZE = 200;
+export declare const LEAD_IMPORT_MAX_BODY_BYTES = 2000000;
+export declare const LEAD_IMPORT_PREVIEW_ROWS = 10;
+/** The same caps the lead's own cards hold a typed value to. */
+export declare const LEAD_IMPORT_NOTES_MAX = 4000;
+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
+ * reason given above: `qualified` is written by the conversion, beside the
+ * contact it produced.
+ */
+export declare const LEAD_IMPORT_STATUSES: readonly CrmLeadStatus[];
+/** The fields a column may be mapped to, in the order the mapping menu lists them. */
+export declare const LEAD_IMPORT_FIELDS: readonly ["email", "name", "status", "ownerEmail", "unqualifiedReason", "notes"];
+export type LeadImportField = (typeof LEAD_IMPORT_FIELDS)[number];
+/** How each field reads in the mapping menu. Typed so a field cannot ship unlabeled. */
+export declare const LEAD_IMPORT_FIELD_LABELS: Record<LeadImportField, string>;
+/** Column index → field. A column absent from the map is not imported. */
+export type LeadImportMapping = Record<number, LeadImportField>;
+/** A proposed mapping from a file's header row, each field taken at most once. */
+export declare function guessLeadImportMapping(columns: readonly string[]): LeadImportMapping;
+/**
+ * What the browser posts for one line: the cells the mapping selected,
+ * under the field they were mapped to, verbatim. `unknown` because the
+ * server reads this off an untrusted body.
+ */
+export type LeadImportRawRow = Partial<Record<LeadImportField, unknown>>;
+/** One parsed line under the mapping. Empty cells are left absent; a lead has no custom fields. */
+export declare function mapLeadImportRow(cells: readonly string[], mapping: Record<number, LeadImportField | `custom:${string}`>): LeadImportRawRow;
+export type LeadImportSkipReason = 'invalid-email' | 'duplicate' | 'lead-ceiling' | 'write-failed';
+/** How a skip reason reads on screen and in the downloaded file. */
+export declare const LEAD_IMPORT_SKIP_LABELS: Record<LeadImportSkipReason, string>;
+/** One row, ready for the server to resolve and write. */
+export interface LeadImportRow {
+    /** Normalized — the address `personKey` derives the document id from. */
+    email: string;
+    name?: string;
+    /** Absent leaves an existing lead's status alone and a new one reading as `new`. */
+    status?: CrmLeadStatus;
+    /** Normalized, for the server to resolve against the org's members. */
+    ownerEmail?: string;
+    /** Only ever set beside `status: 'unqualified'` — the pair is one fact. */
+    unqualifiedReason?: string;
+    notes?: string;
+    dropped: ImportDroppedValue[];
+}
+export type LeadImportRowVerdict = {
+    ok: true;
+    row: LeadImportRow;
+} | {
+    ok: false;
+    reason: 'invalid-email';
+    input: string;
+};
+/**
+ * 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 declare function parseImportLeadStatus(value: unknown): CrmLeadStatus | 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 declare function normalizeLeadImportRow(raw: LeadImportRawRow): LeadImportRowVerdict;
+/** One row the server did not store, by its index in the request, named by the address. */
+export interface LeadImportSkippedRow {
+    index: number;
+    email: string;
+    reason: LeadImportSkipReason;
+}
+/** What one request did. The drawer sums these across a file. */
+export type LeadImportChunkResult = ImportChunkResult<LeadImportSkippedRow>;
+export declare function emptyLeadImportResult(): LeadImportChunkResult;
+export declare function mergeLeadImportResults(total: LeadImportChunkResult, chunk: LeadImportChunkResult, offset?: number): LeadImportChunkResult;
+/** The skipped rows as a file the operator can fix and re-import. */
+export declare function leadImportSkippedCsv(columns: readonly string[], entries: readonly {
+    cells: readonly string[];
+    reason: LeadImportSkipReason;
+}[]): string;