@aglyn/plugins-crm 1.0.0-beta.143

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

@@ -0,0 +1,94 @@
+/**
+ * @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 CrmTaskKind, type CrmTaskPriority, type CrmTaskStatus } 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 TASK_IMPORT_MAX_ROWS = 5000;
+export declare const TASK_IMPORT_CHUNK_SIZE = 200;
+export declare const TASK_IMPORT_MAX_BODY_BYTES = 2000000;
+export declare const TASK_IMPORT_PREVIEW_ROWS = 10;
+/** The same caps the task drawer holds a typed task to. */
+export declare const TASK_IMPORT_TITLE_MAX = 200;
+export declare const TASK_IMPORT_NOTES_MAX = 4000;
+/** The fields a column may be mapped to, in the order the mapping menu lists them. */
+export declare const TASK_IMPORT_FIELDS: readonly ["title", "kind", "priority", "status", "due", "assigneeEmail", "notes"];
+export type TaskImportField = (typeof TASK_IMPORT_FIELDS)[number];
+/** How each field reads in the mapping menu. Typed so a field cannot ship unlabeled. */
+export declare const TASK_IMPORT_FIELD_LABELS: Record<TaskImportField, string>;
+/** Column index → field. A column absent from the map is not imported. */
+export type TaskImportMapping = Record<number, TaskImportField>;
+/** A proposed mapping from a file's header row, each field taken at most once. */
+export declare function guessTaskImportMapping(columns: readonly string[]): TaskImportMapping;
+/**
+ * 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 TaskImportRawRow = Partial<Record<TaskImportField, unknown>>;
+/** One parsed line under the mapping. Empty cells are left absent; a task has no custom fields. */
+export declare function mapTaskImportRow(cells: readonly string[], mapping: Record<number, TaskImportField | `custom:${string}`>): TaskImportRawRow;
+export type TaskImportSkipReason = 'missing-title' | 'unknown-assignee' | 'write-failed';
+/** How a skip reason reads on screen and in the downloaded file. */
+export declare const TASK_IMPORT_SKIP_LABELS: Record<TaskImportSkipReason, string>;
+/** One row, ready for the server to resolve and write. */
+export interface TaskImportRow {
+    title: string;
+    kind: CrmTaskKind;
+    priority: CrmTaskPriority;
+    status: CrmTaskStatus;
+    /** Epoch ms, or `null` for no due date — the shape the document stores. */
+    dueAtMs: number | null;
+    /** Normalized, for the server to resolve against the org's members. */
+    assigneeEmail?: string;
+    notes?: string;
+    dropped: ImportDroppedValue[];
+}
+export type TaskImportRowVerdict = {
+    ok: true;
+    row: TaskImportRow;
+} | {
+    ok: false;
+    reason: 'missing-title';
+    input: string;
+};
+/** A kind cell by id or by label — `todo`, `To-do`, `to do` are one kind. */
+export declare function parseImportTaskKind(value: unknown): CrmTaskKind | null;
+/** A priority cell as one of the three, `medium` and `urgent` folded in. */
+export declare function parseImportTaskPriority(value: unknown): CrmTaskPriority | null;
+/** A status cell as open or done — `done`, `complete`, `yes`, `true` all close it. */
+export declare function parseImportTaskStatus(value: unknown): CrmTaskStatus | 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 assignee is refused by
+ * the server, which alone can look them up.
+ */
+export declare function normalizeTaskImportRow(raw: TaskImportRawRow): TaskImportRowVerdict;
+/** One row the server did not store, by its index in the request, named by the task. */
+export interface TaskImportSkippedRow {
+    index: number;
+    title: string;
+    reason: TaskImportSkipReason;
+}
+/** What one request did. The drawer sums these across a file. */
+export type TaskImportChunkResult = ImportChunkResult<TaskImportSkippedRow>;
+export declare function emptyTaskImportResult(): TaskImportChunkResult;
+export declare function mergeTaskImportResults(total: TaskImportChunkResult, chunk: TaskImportChunkResult, offset?: number): TaskImportChunkResult;
+/** The skipped rows as a file the operator can fix and re-import. */
+export declare function taskImportSkippedCsv(columns: readonly string[], entries: readonly {
+    cells: readonly string[];
+    reason: TaskImportSkipReason;
+}[]): string;

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

@@ -0,0 +1,275 @@
+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 TASKS INTO THE CRM — the pure half (AGL-2662).
+ *
+ * The contact import's three stages (`crm-import.ts`) over the task
+ * vocabulary. A task is the simplest CRM record — a title, what kind of
+ * thing it is, how urgent, when it is due, whose it is — and the file
+ * carries exactly that.
+ *
+ * ## The assignee is resolved by address, and a stranger refuses the row
+ *
+ * A contact or a company whose owner address matches nobody is filed
+ * without an owner and the address is named at the end, because the
+ * record is worth having either way. A task is different: a task nobody
+ * holds is a task nobody does, and a file that names an assignee meant
+ * that person. So an address that matches no member of the organization
+ * refuses the ROW as `unknown-assignee`, and the operator fixes the sheet.
+ * A row with no assignee cell is filed unassigned, which is a choice.
+ *
+ * ## A task has no key, so nothing is merged
+ *
+ * Every row CREATES; importing a file twice files it twice. An imported
+ * task does not notify its assignee: forty notifications for a spreadsheet
+ * is noise, and the drawer's assignment notice is for one task at a time.
+ *
+ * ## A bad cell is dropped and named; a bad row is skipped and named
+ *
+ * A kind or a priority the CRM does not have falls back to the drawer's
+ * own defaults (`todo`, `normal`) and is REPORTED under
+ * {@link TaskImportRow.dropped}; a due date that is not a date is dropped
+ * the same way; a status other than open or done reads as open.
+ */ import { normalizeContactEmail } from "@aglyn/aglyn/app-utils/contacts";
+import { parseImportDate } from "./crm-deal-import.js";
+import { CRM_TASK_KIND_LABELS, isCrmTaskKind } from "@aglyn/aglyn/app-utils/crm";
+import { CSV_IMPORT_CHUNK_SIZE, CSV_IMPORT_MAX_BODY_BYTES, CSV_IMPORT_MAX_ROWS, CSV_IMPORT_PREVIEW_ROWS, emptyImportResult, guessImportMapping, importAliasKeys, importSkippedCsv, importTextValue, mapImportRow, mergeImportResults } from "@aglyn/aglyn/app-utils/csv-import";
+/** The shared ceilings, under this collection's names. */ export const TASK_IMPORT_MAX_ROWS = CSV_IMPORT_MAX_ROWS;
+export const TASK_IMPORT_CHUNK_SIZE = CSV_IMPORT_CHUNK_SIZE;
+export const TASK_IMPORT_MAX_BODY_BYTES = CSV_IMPORT_MAX_BODY_BYTES;
+export const TASK_IMPORT_PREVIEW_ROWS = CSV_IMPORT_PREVIEW_ROWS;
+/** The same caps the task drawer holds a typed task to. */ export const TASK_IMPORT_TITLE_MAX = 200;
+export const TASK_IMPORT_NOTES_MAX = 4000;
+/** The fields a column may be mapped to, in the order the mapping menu lists them. */ export const TASK_IMPORT_FIELDS = [
+    'title',
+    'kind',
+    'priority',
+    'status',
+    'due',
+    'assigneeEmail',
+    'notes'
+];
+/** How each field reads in the mapping menu. Typed so a field cannot ship unlabeled. */ export const TASK_IMPORT_FIELD_LABELS = {
+    title: 'Title (required)',
+    kind: 'Kind (call, email, meeting, to-do)',
+    priority: 'Priority (low, normal, high)',
+    status: 'Status (open or done)',
+    due: 'Due (date or timestamp)',
+    assigneeEmail: 'Assignee (team member email)',
+    notes: 'Notes'
+};
+/**
+ * Header aliases per field, matched after the shared header normalization.
+ *
+ * First in each list is the header this CRM's own tasks export writes, so
+ * an export re-imports without a hand mapping; the export's Contact,
+ * Company, Deal and Completed columns are deliberately absent, because a
+ * link is made on the record, not from a file, and the completion is
+ * stamped by the import when the status says done.
+ */ const FIELD_ALIASES = {
+    title: [
+        'title',
+        'task',
+        'task title',
+        'task name',
+        'name',
+        'subject',
+        'summary'
+    ],
+    kind: [
+        'kind',
+        'type',
+        'task type',
+        'activity type'
+    ],
+    priority: [
+        'priority',
+        'importance',
+        'urgency'
+    ],
+    status: [
+        'status',
+        'state',
+        'done',
+        'completed'
+    ],
+    due: [
+        'due',
+        'due date',
+        'due at',
+        'deadline',
+        'due on'
+    ],
+    assigneeEmail: [
+        'assignee',
+        'assignee email',
+        'assigned to',
+        'owner',
+        'owner email',
+        'rep'
+    ],
+    notes: [
+        'notes',
+        'note',
+        'description',
+        'comments',
+        'details'
+    ]
+};
+const FIELD_ALIAS_KEYS = importAliasKeys(TASK_IMPORT_FIELDS, FIELD_ALIASES);
+/** A proposed mapping from a file's header row, each field taken at most once. */ export function guessTaskImportMapping(columns) {
+    return guessImportMapping(columns, TASK_IMPORT_FIELDS, FIELD_ALIAS_KEYS);
+}
+/** One parsed line under the mapping. Empty cells are left absent; a task has no custom fields. */ export function mapTaskImportRow(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 TASK_IMPORT_SKIP_LABELS = {
+    'missing-title': 'No title',
+    'unknown-assignee': 'No team member has that assignee address',
+    'write-failed': 'Could not be saved'
+};
+/** A kind cell by id or by label — `todo`, `To-do`, `to do` are one kind. */ export function parseImportTaskKind(value) {
+    const text = String(value != null ? value : '').trim().toLowerCase();
+    if (!text) return null;
+    if (isCrmTaskKind(text)) return text;
+    const bare = text.replace(/[\s-]+/g, '');
+    for (const [kind, label] of Object.entries(CRM_TASK_KIND_LABELS)){
+        if (label.toLowerCase().replace(/[\s-]+/g, '') === bare) return kind;
+    }
+    return null;
+}
+const PRIORITIES = {
+    low: 'low',
+    normal: 'normal',
+    medium: 'normal',
+    high: 'high',
+    urgent: 'high'
+};
+/** A priority cell as one of the three, `medium` and `urgent` folded in. */ export function parseImportTaskPriority(value) {
+    var _PRIORITIES_String_trim_toLowerCase;
+    return (_PRIORITIES_String_trim_toLowerCase = PRIORITIES[String(value != null ? value : '').trim().toLowerCase()]) != null ? _PRIORITIES_String_trim_toLowerCase : null;
+}
+/** A status cell as open or done — `done`, `complete`, `yes`, `true` all close it. */ export function parseImportTaskStatus(value) {
+    const text = String(value != null ? value : '').trim().toLowerCase();
+    if (!text) return null;
+    if ([
+        'done',
+        'complete',
+        'completed',
+        'closed',
+        'yes',
+        'y',
+        'true',
+        '1'
+    ].includes(text)) {
+        return 'done';
+    }
+    if ([
+        'open',
+        'todo',
+        'to do',
+        'pending',
+        'no',
+        'n',
+        'false',
+        '0',
+        'incomplete'
+    ].includes(text)) {
+        return 'open';
+    }
+    return 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 assignee is refused by
+ * the server, which alone can look them up.
+ */ export function normalizeTaskImportRow(raw) {
+    var _importTextValue;
+    const title = (_importTextValue = importTextValue(raw.title, TASK_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,
+        kind: 'todo',
+        priority: 'normal',
+        status: 'open',
+        dueAtMs: null,
+        dropped
+    };
+    const kindText = importTextValue(raw.kind, 32);
+    if (kindText) {
+        const kind = parseImportTaskKind(kindText);
+        if (kind) row.kind = kind;
+        else drop('kind', kindText);
+    }
+    const priorityText = importTextValue(raw.priority, 32);
+    if (priorityText) {
+        const priority = parseImportTaskPriority(priorityText);
+        if (priority) row.priority = priority;
+        else drop('priority', priorityText);
+    }
+    const statusText = importTextValue(raw.status, 32);
+    if (statusText) {
+        const status = parseImportTaskStatus(statusText);
+        if (status) row.status = status;
+        else drop('status', statusText);
+    }
+    const dueText = importTextValue(raw.due, 64);
+    if (dueText) {
+        const ms = parseImportDate(dueText);
+        if (ms !== null) row.dueAtMs = ms;
+        else drop('due', dueText);
+    }
+    const assigneeText = importTextValue(raw.assigneeEmail, 320);
+    if (assigneeText) {
+        const assignee = normalizeContactEmail(assigneeText);
+        if (assignee) row.assigneeEmail = assignee;
+        else drop('assigneeEmail', assigneeText);
+    }
+    const notes = importTextValue(raw.notes, TASK_IMPORT_NOTES_MAX);
+    if (notes) row.notes = notes;
+    return {
+        ok: true,
+        row
+    };
+}
+export function emptyTaskImportResult() {
+    return emptyImportResult();
+}
+export function mergeTaskImportResults(total, chunk, offset = 0) {
+    return mergeImportResults(total, chunk, offset);
+}
+/** The skipped rows as a file the operator can fix and re-import. */ export function taskImportSkippedCsv(columns, entries) {
+    return importSkippedCsv(columns, entries, TASK_IMPORT_SKIP_LABELS);
+}
+
+//# sourceMappingURL=crm-task-import.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/crm/src/lib/model/crm-task-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 TASKS INTO THE CRM — the pure half (AGL-2662).\n *\n * The contact import's three stages (`crm-import.ts`) over the task\n * vocabulary. A task is the simplest CRM record — a title, what kind of\n * thing it is, how urgent, when it is due, whose it is — and the file\n * carries exactly that.\n *\n * ## The assignee is resolved by address, and a stranger refuses the row\n *\n * A contact or a company whose owner address matches nobody is filed\n * without an owner and the address is named at the end, because the\n * record is worth having either way. A task is different: a task nobody\n * holds is a task nobody does, and a file that names an assignee meant\n * that person. So an address that matches no member of the organization\n * refuses the ROW as `unknown-assignee`, and the operator fixes the sheet.\n * A row with no assignee cell is filed unassigned, which is a choice.\n *\n * ## A task has no key, so nothing is merged\n *\n * Every row CREATES; importing a file twice files it twice. An imported\n * task does not notify its assignee: forty notifications for a spreadsheet\n * is noise, and the drawer's assignment notice is for one task at a time.\n *\n * ## A bad cell is dropped and named; a bad row is skipped and named\n *\n * A kind or a priority the CRM does not have falls back to the drawer's\n * own defaults (`todo`, `normal`) and is REPORTED under\n * {@link TaskImportRow.dropped}; a due date that is not a date is dropped\n * the same way; a status other than open or done reads as open.\n */\n\nimport { normalizeContactEmail } from '@aglyn/aglyn/app-utils/contacts'\nimport { parseImportDate } from './crm-deal-import'\nimport {\n  CRM_TASK_KIND_LABELS,\n  type CrmTaskKind,\n  type CrmTaskPriority,\n  type CrmTaskStatus,\n  isCrmTaskKind,\n} from '@aglyn/aglyn/app-utils/crm'\nimport {\n  CSV_IMPORT_CHUNK_SIZE,\n  CSV_IMPORT_MAX_BODY_BYTES,\n  CSV_IMPORT_MAX_ROWS,\n  CSV_IMPORT_PREVIEW_ROWS,\n  emptyImportResult,\n  guessImportMapping,\n  importAliasKeys,\n  type ImportChunkResult,\n  type ImportDroppedValue,\n  importSkippedCsv,\n  importTextValue,\n  mapImportRow,\n  mergeImportResults,\n} from '@aglyn/aglyn/app-utils/csv-import'\n\n/** The shared ceilings, under this collection's names. */\nexport const TASK_IMPORT_MAX_ROWS = CSV_IMPORT_MAX_ROWS\nexport const TASK_IMPORT_CHUNK_SIZE = CSV_IMPORT_CHUNK_SIZE\nexport const TASK_IMPORT_MAX_BODY_BYTES = CSV_IMPORT_MAX_BODY_BYTES\nexport const TASK_IMPORT_PREVIEW_ROWS = CSV_IMPORT_PREVIEW_ROWS\n\n/** The same caps the task drawer holds a typed task to. */\nexport const TASK_IMPORT_TITLE_MAX = 200\nexport const TASK_IMPORT_NOTES_MAX = 4000\n\n/** The fields a column may be mapped to, in the order the mapping menu lists them. */\nexport const TASK_IMPORT_FIELDS = [\n  'title',\n  'kind',\n  'priority',\n  'status',\n  'due',\n  'assigneeEmail',\n  'notes',\n] as const\n\nexport type TaskImportField = (typeof TASK_IMPORT_FIELDS)[number]\n\n/** How each field reads in the mapping menu. Typed so a field cannot ship unlabeled. */\nexport const TASK_IMPORT_FIELD_LABELS: Record<TaskImportField, string> = {\n  title: 'Title (required)',\n  kind: 'Kind (call, email, meeting, to-do)',\n  priority: 'Priority (low, normal, high)',\n  status: 'Status (open or done)',\n  due: 'Due (date or timestamp)',\n  assigneeEmail: 'Assignee (team member email)',\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 tasks export writes, so\n * an export re-imports without a hand mapping; the export's Contact,\n * Company, Deal and Completed columns are deliberately absent, because a\n * link is made on the record, not from a file, and the completion is\n * stamped by the import when the status says done.\n */\nconst FIELD_ALIASES: Record<TaskImportField, readonly string[]> = {\n  title: ['title', 'task', 'task title', 'task name', 'name', 'subject', 'summary'],\n  kind: ['kind', 'type', 'task type', 'activity type'],\n  priority: ['priority', 'importance', 'urgency'],\n  status: ['status', 'state', 'done', 'completed'],\n  due: ['due', 'due date', 'due at', 'deadline', 'due on'],\n  assigneeEmail: ['assignee', 'assignee email', 'assigned to', 'owner', 'owner email', 'rep'],\n  notes: ['notes', 'note', 'description', 'comments', 'details'],\n}\n\nconst FIELD_ALIAS_KEYS = importAliasKeys(TASK_IMPORT_FIELDS, FIELD_ALIASES)\n\n/** Column index → field. A column absent from the map is not imported. */\nexport type TaskImportMapping = Record<number, TaskImportField>\n\n/** A proposed mapping from a file's header row, each field taken at most once. */\nexport function guessTaskImportMapping(columns: readonly string[]): TaskImportMapping {\n  return guessImportMapping(columns, TASK_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 TaskImportRawRow = Partial<Record<TaskImportField, unknown>>\n\n/** One parsed line under the mapping. Empty cells are left absent; a task has no custom fields. */\nexport function mapTaskImportRow(\n  cells: readonly string[],\n  mapping: Record<number, TaskImportField | `custom:${string}`>,\n): TaskImportRawRow {\n  const { custom: _custom, ...row } = mapImportRow(cells, mapping)\n  return row\n}\n\nexport type TaskImportSkipReason =\n  | 'missing-title'\n  | 'unknown-assignee'\n  | 'write-failed'\n\n/** How a skip reason reads on screen and in the downloaded file. */\nexport const TASK_IMPORT_SKIP_LABELS: Record<TaskImportSkipReason, string> = {\n  'missing-title': 'No title',\n  'unknown-assignee': 'No team member has that assignee address',\n  'write-failed': 'Could not be saved',\n}\n\n/** One row, ready for the server to resolve and write. */\nexport interface TaskImportRow {\n  title: string\n  kind: CrmTaskKind\n  priority: CrmTaskPriority\n  status: CrmTaskStatus\n  /** Epoch ms, or `null` for no due date — the shape the document stores. */\n  dueAtMs: number | null\n  /** Normalized, for the server to resolve against the org's members. */\n  assigneeEmail?: string\n  notes?: string\n  dropped: ImportDroppedValue[]\n}\n\nexport type TaskImportRowVerdict =\n  | { ok: true; row: TaskImportRow }\n  | { ok: false; reason: 'missing-title'; input: string }\n\n/** A kind cell by id or by label — `todo`, `To-do`, `to do` are one kind. */\nexport function parseImportTaskKind(value: unknown): CrmTaskKind | null {\n  const text = String(value ?? '')\n    .trim()\n    .toLowerCase()\n  if (!text) return null\n  if (isCrmTaskKind(text)) return text\n  const bare = text.replace(/[\\s-]+/g, '')\n  for (const [kind, label] of Object.entries(CRM_TASK_KIND_LABELS)) {\n    if (label.toLowerCase().replace(/[\\s-]+/g, '') === bare) return kind as CrmTaskKind\n  }\n  return null\n}\n\nconst PRIORITIES: Record<string, CrmTaskPriority> = {\n  low: 'low',\n  normal: 'normal',\n  medium: 'normal',\n  high: 'high',\n  urgent: 'high',\n}\n\n/** A priority cell as one of the three, `medium` and `urgent` folded in. */\nexport function parseImportTaskPriority(value: unknown): CrmTaskPriority | null {\n  return PRIORITIES[String(value ?? '').trim().toLowerCase()] ?? null\n}\n\n/** A status cell as open or done — `done`, `complete`, `yes`, `true` all close it. */\nexport function parseImportTaskStatus(value: unknown): CrmTaskStatus | null {\n  const text = String(value ?? '')\n    .trim()\n    .toLowerCase()\n  if (!text) return null\n  if (['done', 'complete', 'completed', 'closed', 'yes', 'y', 'true', '1'].includes(text)) {\n    return 'done'\n  }\n  if (['open', 'todo', 'to do', 'pending', 'no', 'n', 'false', '0', 'incomplete'].includes(text)) {\n    return 'open'\n  }\n  return 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 assignee is refused by\n * the server, which alone can look them up.\n */\nexport function normalizeTaskImportRow(raw: TaskImportRawRow): TaskImportRowVerdict {\n  const title = importTextValue(raw.title, TASK_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: TaskImportField, value: unknown) => {\n    dropped.push({ field, value: String(value ?? '').trim() })\n  }\n  const row: TaskImportRow = {\n    title,\n    kind: 'todo',\n    priority: 'normal',\n    status: 'open',\n    dueAtMs: null,\n    dropped,\n  }\n\n  const kindText = importTextValue(raw.kind, 32)\n  if (kindText) {\n    const kind = parseImportTaskKind(kindText)\n    if (kind) row.kind = kind\n    else drop('kind', kindText)\n  }\n\n  const priorityText = importTextValue(raw.priority, 32)\n  if (priorityText) {\n    const priority = parseImportTaskPriority(priorityText)\n    if (priority) row.priority = priority\n    else drop('priority', priorityText)\n  }\n\n  const statusText = importTextValue(raw.status, 32)\n  if (statusText) {\n    const status = parseImportTaskStatus(statusText)\n    if (status) row.status = status\n    else drop('status', statusText)\n  }\n\n  const dueText = importTextValue(raw.due, 64)\n  if (dueText) {\n    const ms = parseImportDate(dueText)\n    if (ms !== null) row.dueAtMs = ms\n    else drop('due', dueText)\n  }\n\n  const assigneeText = importTextValue(raw.assigneeEmail, 320)\n  if (assigneeText) {\n    const assignee = normalizeContactEmail(assigneeText)\n    if (assignee) row.assigneeEmail = assignee\n    else drop('assigneeEmail', assigneeText)\n  }\n\n  const notes = importTextValue(raw.notes, TASK_IMPORT_NOTES_MAX)\n  if (notes) row.notes = notes\n\n  return { ok: true, row }\n}\n\n/** One row the server did not store, by its index in the request, named by the task. */\nexport interface TaskImportSkippedRow {\n  index: number\n  title: string\n  reason: TaskImportSkipReason\n}\n\n/** What one request did. The drawer sums these across a file. */\nexport type TaskImportChunkResult = ImportChunkResult<TaskImportSkippedRow>\n\nexport function emptyTaskImportResult(): TaskImportChunkResult {\n  return emptyImportResult<TaskImportSkippedRow>()\n}\n\nexport function mergeTaskImportResults(\n  total: TaskImportChunkResult,\n  chunk: TaskImportChunkResult,\n  offset = 0,\n): TaskImportChunkResult {\n  return mergeImportResults(total, chunk, offset)\n}\n\n/** The skipped rows as a file the operator can fix and re-import. */\nexport function taskImportSkippedCsv(\n  columns: readonly string[],\n  entries: readonly { cells: readonly string[]; reason: TaskImportSkipReason }[],\n): string {\n  return importSkippedCsv(columns, entries, TASK_IMPORT_SKIP_LABELS)\n}\n"],"names":["normalizeContactEmail","parseImportDate","CRM_TASK_KIND_LABELS","isCrmTaskKind","CSV_IMPORT_CHUNK_SIZE","CSV_IMPORT_MAX_BODY_BYTES","CSV_IMPORT_MAX_ROWS","CSV_IMPORT_PREVIEW_ROWS","emptyImportResult","guessImportMapping","importAliasKeys","importSkippedCsv","importTextValue","mapImportRow","mergeImportResults","TASK_IMPORT_MAX_ROWS","TASK_IMPORT_CHUNK_SIZE","TASK_IMPORT_MAX_BODY_BYTES","TASK_IMPORT_PREVIEW_ROWS","TASK_IMPORT_TITLE_MAX","TASK_IMPORT_NOTES_MAX","TASK_IMPORT_FIELDS","TASK_IMPORT_FIELD_LABELS","title","kind","priority","status","due","assigneeEmail","notes","FIELD_ALIASES","FIELD_ALIAS_KEYS","guessTaskImportMapping","columns","mapTaskImportRow","cells","mapping","custom","_custom","row","TASK_IMPORT_SKIP_LABELS","parseImportTaskKind","value","text","String","trim","toLowerCase","bare","replace","label","Object","entries","PRIORITIES","low","normal","medium","high","urgent","parseImportTaskPriority","parseImportTaskStatus","includes","normalizeTaskImportRow","raw","ok","reason","input","dropped","drop","field","push","dueAtMs","kindText","priorityText","statusText","dueText","ms","assigneeText","assignee","emptyTaskImportResult","mergeTaskImportResults","total","chunk","offset","taskImportSkippedCsv"],"mappings":"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"}

package/src/lib/model/crm-view-param.d.ts

@@ -0,0 +1,43 @@
+/**
+ * @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.
+ */
+/**
+ * A view's place in a section's address (AGL-2617).
+ *
+ * `?view=<id>` is what makes a view linkable: a rep pastes the address of
+ * "my open leads" into a chat and a colleague opens the same list. The key
+ * COMPOSES with the other keys a section reads — the Contacts list's
+ * `formId` and `email` seeds — rather than replacing them, so a form's page
+ * can link to "the people this form captured, in my usual view" and the
+ * list answers both. Pure, so the seed parser and the views controller read
+ * one spelling of the key.
+ */
+export declare const CRM_VIEW_PARAM = "view";
+/** The view id a section's address names, or none. */
+export declare function crmViewIdFromParams(params: {
+    get(name: string): string | null;
+} | null | undefined): string | null;
+/**
+ * The same address with the view set or, with `null`, cleared — every
+ * other key kept exactly as it was.
+ *
+ * Built from the section path and the current query rather than from
+ * `location`, so a list mounted anywhere the shell mounts it links to
+ * itself; `pathname` carries no query of its own.
+ */
+export declare function crmViewHref(pathname: string, params: {
+    toString(): string;
+} | null | undefined, viewId: string | null): string;

package/src/lib/model/crm-view-param.js

@@ -0,0 +1,49 @@
+/**
+ * @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.
+ */ /**
+ * A view's place in a section's address (AGL-2617).
+ *
+ * `?view=<id>` is what makes a view linkable: a rep pastes the address of
+ * "my open leads" into a chat and a colleague opens the same list. The key
+ * COMPOSES with the other keys a section reads — the Contacts list's
+ * `formId` and `email` seeds — rather than replacing them, so a form's page
+ * can link to "the people this form captured, in my usual view" and the
+ * list answers both. Pure, so the seed parser and the views controller read
+ * one spelling of the key.
+ */ export const CRM_VIEW_PARAM = 'view';
+/** The view id a section's address names, or none. */ export function crmViewIdFromParams(params) {
+    var _ref;
+    const raw = (_ref = params == null ? void 0 : params.get(CRM_VIEW_PARAM)) != null ? _ref : '';
+    const trimmed = raw.trim();
+    return trimmed ? trimmed : null;
+}
+/**
+ * The same address with the view set or, with `null`, cleared — every
+ * other key kept exactly as it was.
+ *
+ * Built from the section path and the current query rather than from
+ * `location`, so a list mounted anywhere the shell mounts it links to
+ * itself; `pathname` carries no query of its own.
+ */ export function crmViewHref(pathname, params, viewId) {
+    var _ref;
+    const next = new URLSearchParams((_ref = params == null ? void 0 : params.toString()) != null ? _ref : '');
+    if (viewId) next.set(CRM_VIEW_PARAM, viewId);
+    else next.delete(CRM_VIEW_PARAM);
+    const query = next.toString();
+    return query ? `${pathname}?${query}` : pathname;
+}
+
+//# sourceMappingURL=crm-view-param.js.map

package/src/lib/model/crm-view-param.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/crm/src/lib/model/crm-view-param.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 * A view's place in a section's address (AGL-2617).\n *\n * `?view=<id>` is what makes a view linkable: a rep pastes the address of\n * \"my open leads\" into a chat and a colleague opens the same list. The key\n * COMPOSES with the other keys a section reads — the Contacts list's\n * `formId` and `email` seeds — rather than replacing them, so a form's page\n * can link to \"the people this form captured, in my usual view\" and the\n * list answers both. Pure, so the seed parser and the views controller read\n * one spelling of the key.\n */\n\nexport const CRM_VIEW_PARAM = 'view'\n\n/** The view id a section's address names, or none. */\nexport function crmViewIdFromParams(\n  params: { get(name: string): string | null } | null | undefined,\n): string | null {\n  const raw = params?.get(CRM_VIEW_PARAM) ?? ''\n  const trimmed = raw.trim()\n  return trimmed ? trimmed : null\n}\n\n/**\n * The same address with the view set or, with `null`, cleared — every\n * other key kept exactly as it was.\n *\n * Built from the section path and the current query rather than from\n * `location`, so a list mounted anywhere the shell mounts it links to\n * itself; `pathname` carries no query of its own.\n */\nexport function crmViewHref(\n  pathname: string,\n  params: { toString(): string } | null | undefined,\n  viewId: string | null,\n): string {\n  const next = new URLSearchParams(params?.toString() ?? '')\n  if (viewId) next.set(CRM_VIEW_PARAM, viewId)\n  else next.delete(CRM_VIEW_PARAM)\n  const query = next.toString()\n  return query ? `${pathname}?${query}` : pathname\n}\n"],"names":["CRM_VIEW_PARAM","crmViewIdFromParams","params","raw","get","trimmed","trim","crmViewHref","pathname","viewId","next","URLSearchParams","toString","set","delete","query"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED;;;;;;;;;;CAUC,GAED,OAAO,MAAMA,iBAAiB,OAAM;AAEpC,oDAAoD,GACpD,OAAO,SAASC,oBACdC,MAA+D;;IAE/D,MAAMC,cAAMD,0BAAAA,OAAQE,GAAG,CAACJ,kCAAmB;IAC3C,MAAMK,UAAUF,IAAIG,IAAI;IACxB,OAAOD,UAAUA,UAAU;AAC7B;AAEA;;;;;;;CAOC,GACD,OAAO,SAASE,YACdC,QAAgB,EAChBN,MAAiD,EACjDO,MAAqB;;IAErB,MAAMC,OAAO,IAAIC,wBAAgBT,0BAAAA,OAAQU,QAAQ,qBAAM;IACvD,IAAIH,QAAQC,KAAKG,GAAG,CAACb,gBAAgBS;SAChCC,KAAKI,MAAM,CAACd;IACjB,MAAMe,QAAQL,KAAKE,QAAQ;IAC3B,OAAOG,QAAQ,GAAGP,SAAS,CAAC,EAAEO,OAAO,GAAGP;AAC1C"}