@aglyn/plugins-crm 1.0.0-beta.221 → 1.0.0-beta.223

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

@@ -1,112 +0,0 @@
-/**
- * @license
- * Copyright 2026 Aglyn LLC
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *   http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-import { type ImportChunkResult, type ImportDroppedValue } from '@aglyn/aglyn/app-utils/csv-import';
-/** The shared ceilings, under this collection's names. */
-export declare const DEAL_IMPORT_MAX_ROWS = 5000;
-export declare const DEAL_IMPORT_CHUNK_SIZE = 200;
-export declare const DEAL_IMPORT_MAX_BODY_BYTES = 2000000;
-export declare const DEAL_IMPORT_PREVIEW_ROWS = 10;
-/** The same caps the deal drawer holds a typed deal to. */
-export declare const DEAL_IMPORT_TITLE_MAX = 120;
-export declare const DEAL_IMPORT_NOTES_MAX = 4000;
-/** The most cents one row may carry — past this the number is a slip. */
-export declare const DEAL_IMPORT_AMOUNT_CENTS_MAX = 1000000000000;
-/** The fields a column may be mapped to, in the order the mapping menu lists them. */
-export declare const DEAL_IMPORT_FIELDS: readonly ["title", "pipeline", "stage", "amount", "currency", "ownerEmail", "expectedClose", "notes"];
-export type DealImportField = (typeof DEAL_IMPORT_FIELDS)[number];
-/** How each field reads in the mapping menu. Typed so a field cannot ship unlabeled. */
-export declare const DEAL_IMPORT_FIELD_LABELS: Record<DealImportField, string>;
-/** Column index → field. A column absent from the map is not imported. */
-export type DealImportMapping = Record<number, DealImportField>;
-/** A proposed mapping from a file's header row, each field taken at most once. */
-export declare function guessDealImportMapping(columns: readonly string[]): DealImportMapping;
-/**
- * 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 DealImportRawRow = Partial<Record<DealImportField, unknown>>;
-/**
- * One parsed line under the mapping. Empty cells are left absent. A deal
- * has no custom fields yet, so a custom target the shared drawer could
- * name is dropped here rather than refused at the type.
- */
-export declare function mapDealImportRow(cells: readonly string[], mapping: Record<number, DealImportField | `custom:${string}`>): DealImportRawRow;
-export type DealImportSkipReason = 'missing-title' | 'unknown-pipeline' | 'unknown-stage' | 'records-band' | 'write-failed';
-/** How a skip reason reads on screen and in the downloaded file. */
-export declare const DEAL_IMPORT_SKIP_LABELS: Record<DealImportSkipReason, string>;
-/** One row, ready for the server to resolve and write. */
-export interface DealImportRow {
-    title: string;
-    /** The pipeline's name as typed, trimmed; absent means the default pipeline. */
-    pipeline?: string;
-    /** The stage's name as typed, trimmed; absent means the pipeline's first open stage. */
-    stage?: string;
-    amountCents?: number;
-    /** Lowercase ISO 4217. */
-    currency?: string;
-    /** Normalized, for the server to resolve against the org's members. */
-    ownerEmail?: string;
-    /** Epoch ms at noon UTC of the typed calendar day, or the typed instant. */
-    expectedCloseAtMs?: number;
-    notes?: string;
-    dropped: ImportDroppedValue[];
-}
-export type DealImportRowVerdict = {
-    ok: true;
-    row: DealImportRow;
-} | {
-    ok: false;
-    reason: 'missing-title';
-    input: string;
-};
-/**
- * A money cell as cents — `1,250.00`, `$1250`, `1250` → 125000 — or
- * `null` when it is not a number. Rounded to the cent: a spreadsheet
- * that computed `12.345` meant a price, not a third of a cent.
- */
-export declare function parseImportAmountCents(value: unknown): number | null;
-/**
- * A date cell as epoch ms: a calendar day (`2026-09-30`) at noon UTC — a
- * day, not an instant, so any zone reads the same date back — or an ISO
- * instant as itself. `null` when it is neither.
- */
-export declare function parseImportDate(value: unknown): number | null;
-/**
- * One raw row as the values that will be written, or the reason it cannot
- * be. Refused here only for a missing title; the pipeline and the stage
- * are refused by the server, which alone can look them up; every other
- * unreadable cell is dropped and named.
- */
-export declare function normalizeDealImportRow(raw: DealImportRawRow): DealImportRowVerdict;
-/** A name as the key two spellings of one pipeline or stage meet at. */
-export declare function dealImportNameKey(name: string): string;
-/** One row the server did not store, by its index in the request, named by the deal. */
-export interface DealImportSkippedRow {
-    index: number;
-    title: string;
-    reason: DealImportSkipReason;
-}
-/** What one request did. The drawer sums these across a file. */
-export type DealImportChunkResult = ImportChunkResult<DealImportSkippedRow>;
-export declare function emptyDealImportResult(): DealImportChunkResult;
-export declare function mergeDealImportResults(total: DealImportChunkResult, chunk: DealImportChunkResult, offset?: number): DealImportChunkResult;
-/** The skipped rows as a file the operator can fix and re-import. */
-export declare function dealImportSkippedCsv(columns: readonly string[], entries: readonly {
-    cells: readonly string[];
-    reason: DealImportSkipReason;
-}[]): string;

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

@@ -1,263 +0,0 @@
-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 DEALS INTO THE CRM — the pure half (AGL-2662).
- *
- * The contact import's three stages (`crm-import.ts`) over the deal
- * vocabulary: a header row is matched to a proposed mapping, one line is
- * mapped to a raw row of verbatim strings, and the server normalizes each
- * row here before it resolves the two names a deal cannot be filed without.
- *
- * ## A deal names its pipeline and its stage by NAME
- *
- * A spreadsheet says "Sales" and "Proposal sent", never a document id, so
- * the file carries names and the server resolves them against the org's
- * own pipelines — case-insensitively, trimmed — and REFUSES the row, by
- * name, when it cannot: an unknown pipeline is `unknown-pipeline`, an
- * unknown stage in a known pipeline `unknown-stage`. A row with no
- * pipeline cell lands in the default pipeline, and one with no stage cell
- * in that pipeline's first open stage, the way the deal drawer opens.
- *
- * ## A deal has no key, so nothing is merged
- *
- * A contact is one address and a company one domain, but two deals titled
- * "Renewal" are two deals. Every row CREATES; importing a file twice files
- * it twice. What is refused is refused before any write.
- *
- * ## A bad cell is dropped and named; a bad row is skipped and named
- *
- * The contact import's rule: an amount that is not a number, a currency
- * that is not a code, a close date that is not a date, an owner address
- * that is not an address — each is left off the record and REPORTED under
- * {@link DealImportRow.dropped}, never silently discarded.
- */ 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, emptyImportResult, guessImportMapping, importAliasKeys, importSkippedCsv, importTextValue, mapImportRow, mergeImportResults } from "@aglyn/aglyn/app-utils/csv-import";
-/** The shared ceilings, under this collection's names. */ export const DEAL_IMPORT_MAX_ROWS = CSV_IMPORT_MAX_ROWS;
-export const DEAL_IMPORT_CHUNK_SIZE = CSV_IMPORT_CHUNK_SIZE;
-export const DEAL_IMPORT_MAX_BODY_BYTES = CSV_IMPORT_MAX_BODY_BYTES;
-export const DEAL_IMPORT_PREVIEW_ROWS = CSV_IMPORT_PREVIEW_ROWS;
-/** The same caps the deal drawer holds a typed deal to. */ export const DEAL_IMPORT_TITLE_MAX = 120;
-export const DEAL_IMPORT_NOTES_MAX = 4000;
-/** The most cents one row may carry — past this the number is a slip. */ export const DEAL_IMPORT_AMOUNT_CENTS_MAX = 1000000000000;
-/** The fields a column may be mapped to, in the order the mapping menu lists them. */ export const DEAL_IMPORT_FIELDS = [
-    'title',
-    'pipeline',
-    'stage',
-    'amount',
-    'currency',
-    'ownerEmail',
-    'expectedClose',
-    'notes'
-];
-/** How each field reads in the mapping menu. Typed so a field cannot ship unlabeled. */ export const DEAL_IMPORT_FIELD_LABELS = {
-    title: 'Title (required)',
-    pipeline: 'Pipeline (by name)',
-    stage: 'Stage (by name)',
-    amount: 'Amount (major units, 1250.00)',
-    currency: 'Currency (three-letter code)',
-    ownerEmail: 'Owner (team member email)',
-    expectedClose: 'Expected close (YYYY-MM-DD)',
-    notes: 'Notes'
-};
-/**
- * Header aliases per field, matched after the shared header normalization.
- *
- * First in each list is the header this CRM's own deals export writes, so
- * an export re-imports without a hand mapping; the export's Status,
- * Contact, Company, Closed and Lost reason columns are deliberately
- * absent, because the stage decides the status and a link is made on the
- * record, not from a file.
- */ const FIELD_ALIASES = {
-    title: [
-        'title',
-        'deal',
-        'deal name',
-        'deal title',
-        'name',
-        'opportunity',
-        'opportunity name'
-    ],
-    pipeline: [
-        'pipeline',
-        'pipeline name',
-        'board'
-    ],
-    stage: [
-        'stage',
-        'stage name',
-        'deal stage',
-        'step'
-    ],
-    amount: [
-        'amount',
-        'value',
-        'deal value',
-        'deal amount',
-        'total',
-        'price'
-    ],
-    currency: [
-        'currency',
-        'currency code'
-    ],
-    ownerEmail: [
-        'owner',
-        'owner email',
-        'deal owner',
-        'assigned to',
-        'rep'
-    ],
-    expectedClose: [
-        'expected close',
-        'close date',
-        'expected close date',
-        'closing date',
-        'expected closing'
-    ],
-    notes: [
-        'notes',
-        'note',
-        'description',
-        'comments'
-    ]
-};
-const FIELD_ALIAS_KEYS = importAliasKeys(DEAL_IMPORT_FIELDS, FIELD_ALIASES);
-/** A proposed mapping from a file's header row, each field taken at most once. */ export function guessDealImportMapping(columns) {
-    return guessImportMapping(columns, DEAL_IMPORT_FIELDS, FIELD_ALIAS_KEYS);
-}
-/**
- * One parsed line under the mapping. Empty cells are left absent. A deal
- * has no custom fields yet, so a custom target the shared drawer could
- * name is dropped here rather than refused at the type.
- */ export function mapDealImportRow(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 DEAL_IMPORT_SKIP_LABELS = {
-    'missing-title': 'No title',
-    'unknown-pipeline': 'No pipeline by that name',
-    'unknown-stage': 'No stage by that name in that pipeline',
-    'records-band': 'CRM records limit reached',
-    'write-failed': 'Could not be saved'
-};
-/**
- * A money cell as cents — `1,250.00`, `$1250`, `1250` → 125000 — or
- * `null` when it is not a number. Rounded to the cent: a spreadsheet
- * that computed `12.345` meant a price, not a third of a cent.
- */ export function parseImportAmountCents(value) {
-    if (typeof value === 'number') {
-        return Number.isFinite(value) && value >= 0 ? Math.round(value * 100) : null;
-    }
-    const text = String(value != null ? value : '').trim().replace(/[,\s]/g, '').replace(/^[^\d.-]+/, '');
-    if (!/^\d+(\.\d+)?$/.test(text)) return null;
-    const cents = Math.round(Number(text) * 100);
-    return Number.isFinite(cents) && cents <= DEAL_IMPORT_AMOUNT_CENTS_MAX ? cents : null;
-}
-/**
- * A date cell as epoch ms: a calendar day (`2026-09-30`) at noon UTC — a
- * day, not an instant, so any zone reads the same date back — or an ISO
- * instant as itself. `null` when it is neither.
- */ export function parseImportDate(value) {
-    const text = String(value != null ? value : '').trim();
-    const day = /^(\d{4})-(\d{2})-(\d{2})$/.exec(text);
-    if (day) {
-        const ms = Date.UTC(Number(day[1]), Number(day[2]) - 1, Number(day[3]), 12);
-        // `Date.UTC` rolls February 30 into March; a typed day that moved is not a day.
-        const back = new Date(ms);
-        return back.getUTCMonth() === Number(day[2]) - 1 && back.getUTCDate() === Number(day[3]) ? ms : null;
-    }
-    if (!/^\d{4}-\d{2}-\d{2}T/.test(text)) return null;
-    const ms = Date.parse(text);
-    return Number.isFinite(ms) ? ms : null;
-}
-/**
- * One raw row as the values that will be written, or the reason it cannot
- * be. Refused here only for a missing title; the pipeline and the stage
- * are refused by the server, which alone can look them up; every other
- * unreadable cell is dropped and named.
- */ export function normalizeDealImportRow(raw) {
-    var _importTextValue;
-    const title = (_importTextValue = importTextValue(raw.title, DEAL_IMPORT_TITLE_MAX)) == null ? void 0 : _importTextValue.replace(/\s+/g, ' ');
-    if (!title) {
-        return {
-            ok: false,
-            reason: 'missing-title',
-            input: ''
-        };
-    }
-    const dropped = [];
-    const drop = (field, value)=>{
-        dropped.push({
-            field,
-            value: String(value != null ? value : '').trim()
-        });
-    };
-    const row = {
-        title,
-        dropped
-    };
-    const pipeline = importTextValue(raw.pipeline, 120);
-    if (pipeline) row.pipeline = pipeline;
-    const stage = importTextValue(raw.stage, 120);
-    if (stage) row.stage = stage;
-    const amountText = importTextValue(raw.amount, 64);
-    if (amountText) {
-        const cents = parseImportAmountCents(amountText);
-        if (cents !== null) row.amountCents = cents;
-        else drop('amount', amountText);
-    }
-    const currencyText = importTextValue(raw.currency, 16);
-    if (currencyText) {
-        const code = currencyText.toLowerCase();
-        if (/^[a-z]{3}$/.test(code)) row.currency = code;
-        else drop('currency', currencyText);
-    }
-    const ownerText = importTextValue(raw.ownerEmail, 320);
-    if (ownerText) {
-        const owner = normalizeContactEmail(ownerText);
-        if (owner) row.ownerEmail = owner;
-        else drop('ownerEmail', ownerText);
-    }
-    const closeText = importTextValue(raw.expectedClose, 64);
-    if (closeText) {
-        const ms = parseImportDate(closeText);
-        if (ms !== null) row.expectedCloseAtMs = ms;
-        else drop('expectedClose', closeText);
-    }
-    const notes = importTextValue(raw.notes, DEAL_IMPORT_NOTES_MAX);
-    if (notes) row.notes = notes;
-    return {
-        ok: true,
-        row
-    };
-}
-/** A name as the key two spellings of one pipeline or stage meet at. */ export function dealImportNameKey(name) {
-    return name.trim().replace(/\s+/g, ' ').toLowerCase();
-}
-export function emptyDealImportResult() {
-    return emptyImportResult();
-}
-export function mergeDealImportResults(total, chunk, offset = 0) {
-    return mergeImportResults(total, chunk, offset);
-}
-/** The skipped rows as a file the operator can fix and re-import. */ export function dealImportSkippedCsv(columns, entries) {
-    return importSkippedCsv(columns, entries, DEAL_IMPORT_SKIP_LABELS);
-}
-
-//# sourceMappingURL=crm-deal-import.js.map

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

@@ -1 +0,0 @@
-{"version":3,"sources":["../../../../../../../libs/plugins/crm/src/lib/model/crm-deal-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 DEALS INTO THE CRM — the pure half (AGL-2662).\n *\n * The contact import's three stages (`crm-import.ts`) over the deal\n * vocabulary: a header row is matched to a proposed mapping, one line is\n * mapped to a raw row of verbatim strings, and the server normalizes each\n * row here before it resolves the two names a deal cannot be filed without.\n *\n * ## A deal names its pipeline and its stage by NAME\n *\n * A spreadsheet says \"Sales\" and \"Proposal sent\", never a document id, so\n * the file carries names and the server resolves them against the org's\n * own pipelines — case-insensitively, trimmed — and REFUSES the row, by\n * name, when it cannot: an unknown pipeline is `unknown-pipeline`, an\n * unknown stage in a known pipeline `unknown-stage`. A row with no\n * pipeline cell lands in the default pipeline, and one with no stage cell\n * in that pipeline's first open stage, the way the deal drawer opens.\n *\n * ## A deal has no key, so nothing is merged\n *\n * A contact is one address and a company one domain, but two deals titled\n * \"Renewal\" are two deals. Every row CREATES; importing a file twice files\n * it twice. What is refused is refused before any write.\n *\n * ## A bad cell is dropped and named; a bad row is skipped and named\n *\n * The contact import's rule: an amount that is not a number, a currency\n * that is not a code, a close date that is not a date, an owner address\n * that is not an address — each is left off the record and REPORTED under\n * {@link DealImportRow.dropped}, never silently discarded.\n */\n\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  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 DEAL_IMPORT_MAX_ROWS = CSV_IMPORT_MAX_ROWS\nexport const DEAL_IMPORT_CHUNK_SIZE = CSV_IMPORT_CHUNK_SIZE\nexport const DEAL_IMPORT_MAX_BODY_BYTES = CSV_IMPORT_MAX_BODY_BYTES\nexport const DEAL_IMPORT_PREVIEW_ROWS = CSV_IMPORT_PREVIEW_ROWS\n\n/** The same caps the deal drawer holds a typed deal to. */\nexport const DEAL_IMPORT_TITLE_MAX = 120\nexport const DEAL_IMPORT_NOTES_MAX = 4000\n/** The most cents one row may carry — past this the number is a slip. */\nexport const DEAL_IMPORT_AMOUNT_CENTS_MAX = 1_000_000_000_000\n\n/** The fields a column may be mapped to, in the order the mapping menu lists them. */\nexport const DEAL_IMPORT_FIELDS = [\n  'title',\n  'pipeline',\n  'stage',\n  'amount',\n  'currency',\n  'ownerEmail',\n  'expectedClose',\n  'notes',\n] as const\n\nexport type DealImportField = (typeof DEAL_IMPORT_FIELDS)[number]\n\n/** How each field reads in the mapping menu. Typed so a field cannot ship unlabeled. */\nexport const DEAL_IMPORT_FIELD_LABELS: Record<DealImportField, string> = {\n  title: 'Title (required)',\n  pipeline: 'Pipeline (by name)',\n  stage: 'Stage (by name)',\n  amount: 'Amount (major units, 1250.00)',\n  currency: 'Currency (three-letter code)',\n  ownerEmail: 'Owner (team member email)',\n  expectedClose: 'Expected close (YYYY-MM-DD)',\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 deals export writes, so\n * an export re-imports without a hand mapping; the export's Status,\n * Contact, Company, Closed and Lost reason columns are deliberately\n * absent, because the stage decides the status and a link is made on the\n * record, not from a file.\n */\nconst FIELD_ALIASES: Record<DealImportField, readonly string[]> = {\n  title: ['title', 'deal', 'deal name', 'deal title', 'name', 'opportunity', 'opportunity name'],\n  pipeline: ['pipeline', 'pipeline name', 'board'],\n  stage: ['stage', 'stage name', 'deal stage', 'step'],\n  amount: ['amount', 'value', 'deal value', 'deal amount', 'total', 'price'],\n  currency: ['currency', 'currency code'],\n  ownerEmail: ['owner', 'owner email', 'deal owner', 'assigned to', 'rep'],\n  expectedClose: ['expected close', 'close date', 'expected close date', 'closing date', 'expected closing'],\n  notes: ['notes', 'note', 'description', 'comments'],\n}\n\nconst FIELD_ALIAS_KEYS = importAliasKeys(DEAL_IMPORT_FIELDS, FIELD_ALIASES)\n\n/** Column index → field. A column absent from the map is not imported. */\nexport type DealImportMapping = Record<number, DealImportField>\n\n/** A proposed mapping from a file's header row, each field taken at most once. */\nexport function guessDealImportMapping(columns: readonly string[]): DealImportMapping {\n  return guessImportMapping(columns, DEAL_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 DealImportRawRow = Partial<Record<DealImportField, unknown>>\n\n/**\n * One parsed line under the mapping. Empty cells are left absent. A deal\n * has no custom fields yet, so a custom target the shared drawer could\n * name is dropped here rather than refused at the type.\n */\nexport function mapDealImportRow(\n  cells: readonly string[],\n  mapping: Record<number, DealImportField | `custom:${string}`>,\n): DealImportRawRow {\n  const { custom: _custom, ...row } = mapImportRow(cells, mapping)\n  return row\n}\n\nexport type DealImportSkipReason =\n  | 'missing-title'\n  | 'unknown-pipeline'\n  | 'unknown-stage'\n  | 'records-band'\n  | 'write-failed'\n\n/** How a skip reason reads on screen and in the downloaded file. */\nexport const DEAL_IMPORT_SKIP_LABELS: Record<DealImportSkipReason, string> = {\n  'missing-title': 'No title',\n  'unknown-pipeline': 'No pipeline by that name',\n  'unknown-stage': 'No stage by that name in that pipeline',\n  'records-band': 'CRM records limit reached',\n  'write-failed': 'Could not be saved',\n}\n\n/** One row, ready for the server to resolve and write. */\nexport interface DealImportRow {\n  title: string\n  /** The pipeline's name as typed, trimmed; absent means the default pipeline. */\n  pipeline?: string\n  /** The stage's name as typed, trimmed; absent means the pipeline's first open stage. */\n  stage?: string\n  amountCents?: number\n  /** Lowercase ISO 4217. */\n  currency?: string\n  /** Normalized, for the server to resolve against the org's members. */\n  ownerEmail?: string\n  /** Epoch ms at noon UTC of the typed calendar day, or the typed instant. */\n  expectedCloseAtMs?: number\n  notes?: string\n  dropped: ImportDroppedValue[]\n}\n\nexport type DealImportRowVerdict =\n  | { ok: true; row: DealImportRow }\n  | { ok: false; reason: 'missing-title'; input: string }\n\n/**\n * A money cell as cents — `1,250.00`, `$1250`, `1250` → 125000 — or\n * `null` when it is not a number. Rounded to the cent: a spreadsheet\n * that computed `12.345` meant a price, not a third of a cent.\n */\nexport function parseImportAmountCents(value: unknown): number | null {\n  if (typeof value === 'number') {\n    return Number.isFinite(value) && value >= 0 ? Math.round(value * 100) : null\n  }\n  const text = String(value ?? '')\n    .trim()\n    .replace(/[,\\s]/g, '')\n    .replace(/^[^\\d.-]+/, '')\n  if (!/^\\d+(\\.\\d+)?$/.test(text)) return null\n  const cents = Math.round(Number(text) * 100)\n  return Number.isFinite(cents) && cents <= DEAL_IMPORT_AMOUNT_CENTS_MAX ? cents : null\n}\n\n/**\n * A date cell as epoch ms: a calendar day (`2026-09-30`) at noon UTC — a\n * day, not an instant, so any zone reads the same date back — or an ISO\n * instant as itself. `null` when it is neither.\n */\nexport function parseImportDate(value: unknown): number | null {\n  const text = String(value ?? '').trim()\n  const day = /^(\\d{4})-(\\d{2})-(\\d{2})$/.exec(text)\n  if (day) {\n    const ms = Date.UTC(Number(day[1]), Number(day[2]) - 1, Number(day[3]), 12)\n    // `Date.UTC` rolls February 30 into March; a typed day that moved is not a day.\n    const back = new Date(ms)\n    return back.getUTCMonth() === Number(day[2]) - 1 && back.getUTCDate() === Number(day[3])\n      ? ms\n      : null\n  }\n  if (!/^\\d{4}-\\d{2}-\\d{2}T/.test(text)) return null\n  const ms = Date.parse(text)\n  return Number.isFinite(ms) ? ms : 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 a missing title; the pipeline and the stage\n * are refused by the server, which alone can look them up; every other\n * unreadable cell is dropped and named.\n */\nexport function normalizeDealImportRow(raw: DealImportRawRow): DealImportRowVerdict {\n  const title = importTextValue(raw.title, DEAL_IMPORT_TITLE_MAX)?.replace(/\\s+/g, ' ')\n  if (!title) {\n    return { ok: false, reason: 'missing-title', input: '' }\n  }\n  const dropped: ImportDroppedValue[] = []\n  const drop = (field: DealImportField, value: unknown) => {\n    dropped.push({ field, value: String(value ?? '').trim() })\n  }\n  const row: DealImportRow = { title, dropped }\n\n  const pipeline = importTextValue(raw.pipeline, 120)\n  if (pipeline) row.pipeline = pipeline\n  const stage = importTextValue(raw.stage, 120)\n  if (stage) row.stage = stage\n\n  const amountText = importTextValue(raw.amount, 64)\n  if (amountText) {\n    const cents = parseImportAmountCents(amountText)\n    if (cents !== null) row.amountCents = cents\n    else drop('amount', amountText)\n  }\n\n  const currencyText = importTextValue(raw.currency, 16)\n  if (currencyText) {\n    const code = currencyText.toLowerCase()\n    if (/^[a-z]{3}$/.test(code)) row.currency = code\n    else drop('currency', currencyText)\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  const closeText = importTextValue(raw.expectedClose, 64)\n  if (closeText) {\n    const ms = parseImportDate(closeText)\n    if (ms !== null) row.expectedCloseAtMs = ms\n    else drop('expectedClose', closeText)\n  }\n\n  const notes = importTextValue(raw.notes, DEAL_IMPORT_NOTES_MAX)\n  if (notes) row.notes = notes\n\n  return { ok: true, row }\n}\n\n/** A name as the key two spellings of one pipeline or stage meet at. */\nexport function dealImportNameKey(name: string): string {\n  return name.trim().replace(/\\s+/g, ' ').toLowerCase()\n}\n\n/** One row the server did not store, by its index in the request, named by the deal. */\nexport interface DealImportSkippedRow {\n  index: number\n  title: string\n  reason: DealImportSkipReason\n}\n\n/** What one request did. The drawer sums these across a file. */\nexport type DealImportChunkResult = ImportChunkResult<DealImportSkippedRow>\n\nexport function emptyDealImportResult(): DealImportChunkResult {\n  return emptyImportResult<DealImportSkippedRow>()\n}\n\nexport function mergeDealImportResults(\n  total: DealImportChunkResult,\n  chunk: DealImportChunkResult,\n  offset = 0,\n): DealImportChunkResult {\n  return mergeImportResults(total, chunk, offset)\n}\n\n/** The skipped rows as a file the operator can fix and re-import. */\nexport function dealImportSkippedCsv(\n  columns: readonly string[],\n  entries: readonly { cells: readonly string[]; reason: DealImportSkipReason }[],\n): string {\n  return importSkippedCsv(columns, entries, DEAL_IMPORT_SKIP_LABELS)\n}\n"],"names":["normalizeContactEmail","CSV_IMPORT_CHUNK_SIZE","CSV_IMPORT_MAX_BODY_BYTES","CSV_IMPORT_MAX_ROWS","CSV_IMPORT_PREVIEW_ROWS","emptyImportResult","guessImportMapping","importAliasKeys","importSkippedCsv","importTextValue","mapImportRow","mergeImportResults","DEAL_IMPORT_MAX_ROWS","DEAL_IMPORT_CHUNK_SIZE","DEAL_IMPORT_MAX_BODY_BYTES","DEAL_IMPORT_PREVIEW_ROWS","DEAL_IMPORT_TITLE_MAX","DEAL_IMPORT_NOTES_MAX","DEAL_IMPORT_AMOUNT_CENTS_MAX","DEAL_IMPORT_FIELDS","DEAL_IMPORT_FIELD_LABELS","title","pipeline","stage","amount","currency","ownerEmail","expectedClose","notes","FIELD_ALIASES","FIELD_ALIAS_KEYS","guessDealImportMapping","columns","mapDealImportRow","cells","mapping","custom","_custom","row","DEAL_IMPORT_SKIP_LABELS","parseImportAmountCents","value","Number","isFinite","Math","round","text","String","trim","replace","test","cents","parseImportDate","day","exec","ms","Date","UTC","back","getUTCMonth","getUTCDate","parse","normalizeDealImportRow","raw","ok","reason","input","dropped","drop","field","push","amountText","amountCents","currencyText","code","toLowerCase","ownerText","owner","closeText","expectedCloseAtMs","dealImportNameKey","name","emptyDealImportResult","mergeDealImportResults","total","chunk","offset","dealImportSkippedCsv","entries"],"mappings":";AAAA;;;;;;;;;;;;;;;CAeC,GAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8BC,GAED,SAASA,qBAAqB,QAAQ,kCAAiC;AACvE,SACEC,qBAAqB,EACrBC,yBAAyB,EACzBC,mBAAmB,EACnBC,uBAAuB,EACvBC,iBAAiB,EACjBC,kBAAkB,EAClBC,eAAe,EAGfC,gBAAgB,EAChBC,eAAe,EACfC,YAAY,EACZC,kBAAkB,QACb,oCAAmC;AAE1C,wDAAwD,GACxD,OAAO,MAAMC,uBAAuBT,oBAAmB;AACvD,OAAO,MAAMU,yBAAyBZ,sBAAqB;AAC3D,OAAO,MAAMa,6BAA6BZ,0BAAyB;AACnE,OAAO,MAAMa,2BAA2BX,wBAAuB;AAE/D,yDAAyD,GACzD,OAAO,MAAMY,wBAAwB,IAAG;AACxC,OAAO,MAAMC,wBAAwB,KAAI;AACzC,uEAAuE,GACvE,OAAO,MAAMC,+BAA+B,cAAiB;AAE7D,oFAAoF,GACpF,OAAO,MAAMC,qBAAqB;IAChC;IACA;IACA;IACA;IACA;IACA;IACA;IACA;CACD,CAAS;AAIV,sFAAsF,GACtF,OAAO,MAAMC,2BAA4D;IACvEC,OAAO;IACPC,UAAU;IACVC,OAAO;IACPC,QAAQ;IACRC,UAAU;IACVC,YAAY;IACZC,eAAe;IACfC,OAAO;AACT,EAAC;AAED;;;;;;;;CAQC,GACD,MAAMC,gBAA4D;IAChER,OAAO;QAAC;QAAS;QAAQ;QAAa;QAAc;QAAQ;QAAe;KAAmB;IAC9FC,UAAU;QAAC;QAAY;QAAiB;KAAQ;IAChDC,OAAO;QAAC;QAAS;QAAc;QAAc;KAAO;IACpDC,QAAQ;QAAC;QAAU;QAAS;QAAc;QAAe;QAAS;KAAQ;IAC1EC,UAAU;QAAC;QAAY;KAAgB;IACvCC,YAAY;QAAC;QAAS;QAAe;QAAc;QAAe;KAAM;IACxEC,eAAe;QAAC;QAAkB;QAAc;QAAuB;QAAgB;KAAmB;IAC1GC,OAAO;QAAC;QAAS;QAAQ;QAAe;KAAW;AACrD;AAEA,MAAME,mBAAmBvB,gBAAgBY,oBAAoBU;AAK7D,gFAAgF,GAChF,OAAO,SAASE,uBAAuBC,OAA0B;IAC/D,OAAO1B,mBAAmB0B,SAASb,oBAAoBW;AACzD;AASA;;;;CAIC,GACD,OAAO,SAASG,iBACdC,KAAwB,EACxBC,OAA6D;IAE7D,MAAoCzB,gBAAAA,aAAawB,OAAOC,UAAlD,EAAEC,QAAQC,OAAO,EAAU,GAAG3B,eAAR4B,uCAAQ5B;;;IACpC,OAAO4B;AACT;AASA,kEAAkE,GAClE,OAAO,MAAMC,0BAAgE;IAC3E,iBAAiB;IACjB,oBAAoB;IACpB,iBAAiB;IACjB,gBAAgB;IAChB,gBAAgB;AAClB,EAAC;AAwBD;;;;CAIC,GACD,OAAO,SAASC,uBAAuBC,KAAc;IACnD,IAAI,OAAOA,UAAU,UAAU;QAC7B,OAAOC,OAAOC,QAAQ,CAACF,UAAUA,SAAS,IAAIG,KAAKC,KAAK,CAACJ,QAAQ,OAAO;IAC1E;IACA,MAAMK,OAAOC,OAAON,gBAAAA,QAAS,IAC1BO,IAAI,GACJC,OAAO,CAAC,UAAU,IAClBA,OAAO,CAAC,aAAa;IACxB,IAAI,CAAC,gBAAgBC,IAAI,CAACJ,OAAO,OAAO;IACxC,MAAMK,QAAQP,KAAKC,KAAK,CAACH,OAAOI,QAAQ;IACxC,OAAOJ,OAAOC,QAAQ,CAACQ,UAAUA,SAASjC,+BAA+BiC,QAAQ;AACnF;AAEA;;;;CAIC,GACD,OAAO,SAASC,gBAAgBX,KAAc;IAC5C,MAAMK,OAAOC,OAAON,gBAAAA,QAAS,IAAIO,IAAI;IACrC,MAAMK,MAAM,4BAA4BC,IAAI,CAACR;IAC7C,IAAIO,KAAK;QACP,MAAME,KAAKC,KAAKC,GAAG,CAACf,OAAOW,GAAG,CAAC,EAAE,GAAGX,OAAOW,GAAG,CAAC,EAAE,IAAI,GAAGX,OAAOW,GAAG,CAAC,EAAE,GAAG;QACxE,gFAAgF;QAChF,MAAMK,OAAO,IAAIF,KAAKD;QACtB,OAAOG,KAAKC,WAAW,OAAOjB,OAAOW,GAAG,CAAC,EAAE,IAAI,KAAKK,KAAKE,UAAU,OAAOlB,OAAOW,GAAG,CAAC,EAAE,IACnFE,KACA;IACN;IACA,IAAI,CAAC,sBAAsBL,IAAI,CAACJ,OAAO,OAAO;IAC9C,MAAMS,KAAKC,KAAKK,KAAK,CAACf;IACtB,OAAOJ,OAAOC,QAAQ,CAACY,MAAMA,KAAK;AACpC;AAEA;;;;;CAKC,GACD,OAAO,SAASO,uBAAuBC,GAAqB;QAC5CtD;IAAd,MAAMY,SAAQZ,mBAAAA,gBAAgBsD,IAAI1C,KAAK,EAAEL,2CAA3BP,iBAAmDwC,OAAO,CAAC,QAAQ;IACjF,IAAI,CAAC5B,OAAO;QACV,OAAO;YAAE2C,IAAI;YAAOC,QAAQ;YAAiBC,OAAO;QAAG;IACzD;IACA,MAAMC,UAAgC,EAAE;IACxC,MAAMC,OAAO,CAACC,OAAwB5B;QACpC0B,QAAQG,IAAI,CAAC;YAAED;YAAO5B,OAAOM,OAAON,gBAAAA,QAAS,IAAIO,IAAI;QAAG;IAC1D;IACA,MAAMV,MAAqB;QAAEjB;QAAO8C;IAAQ;IAE5C,MAAM7C,WAAWb,gBAAgBsD,IAAIzC,QAAQ,EAAE;IAC/C,IAAIA,UAAUgB,IAAIhB,QAAQ,GAAGA;IAC7B,MAAMC,QAAQd,gBAAgBsD,IAAIxC,KAAK,EAAE;IACzC,IAAIA,OAAOe,IAAIf,KAAK,GAAGA;IAEvB,MAAMgD,aAAa9D,gBAAgBsD,IAAIvC,MAAM,EAAE;IAC/C,IAAI+C,YAAY;QACd,MAAMpB,QAAQX,uBAAuB+B;QACrC,IAAIpB,UAAU,MAAMb,IAAIkC,WAAW,GAAGrB;aACjCiB,KAAK,UAAUG;IACtB;IAEA,MAAME,eAAehE,gBAAgBsD,IAAItC,QAAQ,EAAE;IACnD,IAAIgD,cAAc;QAChB,MAAMC,OAAOD,aAAaE,WAAW;QACrC,IAAI,aAAazB,IAAI,CAACwB,OAAOpC,IAAIb,QAAQ,GAAGiD;aACvCN,KAAK,YAAYK;IACxB;IAEA,MAAMG,YAAYnE,gBAAgBsD,IAAIrC,UAAU,EAAE;IAClD,IAAIkD,WAAW;QACb,MAAMC,QAAQ7E,sBAAsB4E;QACpC,IAAIC,OAAOvC,IAAIZ,UAAU,GAAGmD;aACvBT,KAAK,cAAcQ;IAC1B;IAEA,MAAME,YAAYrE,gBAAgBsD,IAAIpC,aAAa,EAAE;IACrD,IAAImD,WAAW;QACb,MAAMvB,KAAKH,gBAAgB0B;QAC3B,IAAIvB,OAAO,MAAMjB,IAAIyC,iBAAiB,GAAGxB;aACpCa,KAAK,iBAAiBU;IAC7B;IAEA,MAAMlD,QAAQnB,gBAAgBsD,IAAInC,KAAK,EAAEX;IACzC,IAAIW,OAAOU,IAAIV,KAAK,GAAGA;IAEvB,OAAO;QAAEoC,IAAI;QAAM1B;IAAI;AACzB;AAEA,sEAAsE,GACtE,OAAO,SAAS0C,kBAAkBC,IAAY;IAC5C,OAAOA,KAAKjC,IAAI,GAAGC,OAAO,CAAC,QAAQ,KAAK0B,WAAW;AACrD;AAYA,OAAO,SAASO;IACd,OAAO7E;AACT;AAEA,OAAO,SAAS8E,uBACdC,KAA4B,EAC5BC,KAA4B,EAC5BC,SAAS,CAAC;IAEV,OAAO3E,mBAAmByE,OAAOC,OAAOC;AAC1C;AAEA,mEAAmE,GACnE,OAAO,SAASC,qBACdvD,OAA0B,EAC1BwD,OAA8E;IAE9E,OAAOhF,iBAAiBwB,SAASwD,SAASjD;AAC5C"}

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

@@ -1,250 +0,0 @@
-/**
- * @license
- * Copyright 2026 Aglyn LLC
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *   http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-/**
- * 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 type { AglynPostalAddress } from '@aglyn/aglyn/foundation/definitions/contact.types';
-import { type ImportChunkResult, type ImportDroppedValue } from '@aglyn/aglyn/app-utils/csv-import';
-import { type ContactCustomValue, type ContactFieldDefinition, type ContactLifecycleStage } from '@aglyn/aglyn/app-utils/crm';
-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 declare const CONTACT_IMPORT_MAX_ROWS = 5000;
-export declare const CONTACT_IMPORT_CHUNK_SIZE = 200;
-export declare const CONTACT_IMPORT_MAX_BODY_BYTES = 2000000;
-export declare const CONTACT_IMPORT_PREVIEW_ROWS = 10;
-/**
- * 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 declare const CONTACT_IMPORT_TAGS_MAX = 20;
-/**
- * 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 declare const CONTACT_IMPORT_FIELDS: readonly ["email", "name", "phone", "jobTitle", "companyName", "addressLine1", "addressLine2", "addressCity", "addressState", "addressPostalCode", "addressCountry", "tags", "ownerEmail", "lifecycleStage", "marketingConsent"];
-export type ContactImportField = (typeof CONTACT_IMPORT_FIELDS)[number];
-/** How each field reads in the mapping menu. Typed so a field cannot ship unlabeled. */
-export declare const CONTACT_IMPORT_FIELD_LABELS: Record<ContactImportField, string>;
-/**
- * What a column is mapped to: a standard field by name, or a custom field
- * as `custom:<key>` — see `customImportTarget`.
- */
-export type ContactImportTargetId = ContactImportField | `custom:${string}`;
-/** Column index → target. A column absent from the map is not imported. */
-export type ContactImportMapping = Record<number, ContactImportTargetId>;
-/**
- * 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 declare function guessContactImportMapping(columns: readonly string[], fields?: readonly Pick<ContactFieldDefinition, 'key' | 'label'>[]): ContactImportMapping;
-/**
- * What the browser posts for one line: the cells the mapping selected,
- * under the field they were mapped to, verbatim.
- *
- * Values are `unknown` because the server reads this off an untrusted body;
- * the mapper below only ever writes strings into it.
- */
-export interface ContactImportRawRow {
-    email?: unknown;
-    name?: unknown;
-    phone?: unknown;
-    jobTitle?: unknown;
-    companyName?: unknown;
-    addressLine1?: unknown;
-    addressLine2?: unknown;
-    addressCity?: unknown;
-    addressState?: unknown;
-    addressPostalCode?: unknown;
-    addressCountry?: unknown;
-    tags?: unknown;
-    ownerEmail?: unknown;
-    lifecycleStage?: unknown;
-    marketingConsent?: unknown;
-    /** Custom values keyed by definition key. */
-    custom?: unknown;
-}
-/** One parsed line under the mapping. Empty cells are left absent. */
-export declare function mapContactImportRow(cells: readonly string[], mapping: ContactImportMapping): ContactImportRawRow;
-/** Why one row was not stored. */
-export type ContactImportSkipReason = 'invalid-email' | 'duplicate' | 'audience-band'
-/** The person was erased from this workspace at their request (AGL-2623). */
- | 'erased' | 'write-failed'
-/**
- * The request ran out of time before it reached the row (AGL-3423). Nothing
- * was written for it, and importing the skipped file again is safe: a row
- * that did land merges into its record rather than creating a second one.
- */
- | 'not-reached';
-/** How a skip reason reads on screen and in the downloaded file. */
-export declare const CONTACT_IMPORT_SKIP_LABELS: Record<ContactImportSkipReason, string>;
-/** A cell the file carried that could not be read as the field it was mapped to. */
-export type ContactImportDroppedValue = ImportDroppedValue;
-/** One row, ready to be written. */
-export interface ContactImportRow {
-    email: string;
-    name?: string;
-    /** E.164. */
-    phone?: string;
-    jobTitle?: string;
-    companyName?: string;
-    address?: AglynPostalAddress;
-    /** Lowercased, deduplicated, capped at {@link CONTACT_IMPORT_TAGS_MAX}. */
-    tags: string[];
-    /** Normalized, for the server to resolve against the org's members. */
-    ownerEmail?: string;
-    lifecycleStage?: ContactLifecycleStage;
-    marketingConsent: boolean;
-    /** Only the keys whose definition the caller supplied and whose value read. */
-    custom: Record<string, ContactCustomValue>;
-    dropped: ContactImportDroppedValue[];
-}
-export type ContactImportRowVerdict = {
-    ok: true;
-    row: ContactImportRow;
-} | {
-    ok: false;
-    reason: 'invalid-email';
-    input: string;
-};
-/**
- * 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 declare function parseContactImportTags(value: unknown): string[];
-/**
- * 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 declare function parseContactImportFlag(value: unknown): boolean | null;
-/**
- * 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 declare function parseContactImportLifecycleStage(value: unknown): ContactLifecycleStage | 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 declare function parseContactImportCustomValue(definition: Pick<ContactFieldDefinition, 'type' | 'options'>, value: unknown): {
-    value: ContactCustomValue | undefined;
-} | 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 declare function normalizeContactImportRow(raw: ContactImportRawRow, fields?: readonly Pick<ContactFieldDefinition, 'key' | 'type' | 'options'>[]): ContactImportRowVerdict;
-/** One row the server did not store, by its index in the request, named by address. */
-export interface ContactImportSkippedRow {
-    index: number;
-    email: string;
-    reason: ContactImportSkipReason;
-}
-/**
- * What one request did — the shared tally plus how many companies the
- * company column brought into being. The drawer sums these across a file.
- */
-export interface ContactImportChunkResult extends ImportChunkResult<ContactImportSkippedRow> {
-    companiesCreated: number;
-}
-/** An empty tally, for the drawer to fold chunk results into. */
-export declare function emptyContactImportResult(): ContactImportChunkResult;
-/**
- * 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 declare function mergeContactImportResults(total: ContactImportChunkResult, chunk: ContactImportChunkResult, offset?: number): ContactImportChunkResult;
-/**
- * The skipped rows as a file the operator can fix and re-import: the
- * original columns verbatim plus a trailing `Skipped because` column.
- */
-export declare function contactImportSkippedCsv(columns: readonly string[], entries: readonly {
-    cells: readonly string[];
-    reason: ContactImportSkipReason;
-}[]): string;