@aglyn/plugins-crm 1.0.0-beta.143

package/src/lib/components/contact-list-columns.js

@@ -0,0 +1,288 @@
+/**
+ * @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.
+ */ 'use client';
+import { _ as _extends } from "@swc/helpers/_/_extends";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { activityTimeLabel, CONTACT_LIFECYCLE_STAGE_LABELS, CONTACT_SOURCE_LABELS } from "@aglyn/aglyn";
+import { hiddenFilterColumns, listFilterColumn } from "@aglyn/shared-ui-jsx/const/list-filter";
+import { Chip, Stack, Tooltip, Typography } from "@mui/material";
+import { CONTACT_LIST_FILTER_FIELDS, CONTACT_LIST_FILTER_HEADERS } from "../constants/contact-filters.js";
+import { nextActivityColumn } from "./crm-next-activity-column.js";
+/**
+ * The filterable fields that get a column. The rest of
+ * `CONTACT_LIST_FILTER_FIELDS` still reaches the filter panel, hidden.
+ */ /**
+ * The declared filter fields that ARE table columns, so the hidden
+ * filter-only columns are built for the others alone. Owner and Stage
+ * joined it when the grammar learned them (AGL-2617): each is a shown
+ * column already, and a second, hidden one under the same field would be
+ * a duplicate the grid refuses.
+ */ export const CONTACT_FILTER_COLUMNS = [
+    'name',
+    'ownerUid',
+    'lifecycleStage',
+    'sources',
+    'tags',
+    'updatedAt',
+    'nextTaskAtMs'
+];
+/**
+ * The columns that ship HIDDEN, for the grid's visibility model (AGL-2616).
+ *
+ * "Last engaged" is a fact most lists do not need on screen and every list
+ * can turn on from the column menu; shipping it visible would widen a
+ * table that already carries seven columns for a figure only a marketing
+ * reader scans.
+ */ export const CONTACT_OPTIONAL_COLUMNS = [
+    'lastEmailEngagementAtMs'
+];
+/**
+ * The contacts list's columns (AGL-2596), in their own module so the list
+ * file stays about the QUERY and the toolbar while other surfaces — a bulk
+ * bar, an import — grow beside it.
+ *
+ * Owner and Stage read off the flattened row, which is already this
+ * holder's facet (`contactRecordFromDoc`), so neither column can show
+ * another holder's assignment. Both are `filterable: false` on purpose: the
+ * grid's filter panel translates to a Firestore query over the top-level
+ * fields in `CONTACT_LIST_FILTER_FIELDS`, and a facet path is not one of
+ * them. The toolbar's stage select and "Assigned to me" switch narrow the
+ * loaded window instead, and say so.
+ */ export function contactListColumns(options) {
+    var _options_nowMs;
+    const { memberName, siteName } = options;
+    const nowMs = (_options_nowMs = options.nowMs) != null ? _options_nowMs : Date.now();
+    return [
+        _extends({
+            field: 'name',
+            headerName: 'Contact',
+            flex: 1.6,
+            minWidth: 220
+        }, listFilterColumn(CONTACT_LIST_FILTER_FIELDS, 'name'), {
+            valueGetter: (_value, row)=>String(row.name || row.email || ''),
+            renderCell: ({ row })=>/*#__PURE__*/ _jsxs(Stack, {
+                    sx: {
+                        justifyContent: 'center',
+                        height: '100%',
+                        lineHeight: 1.25
+                    },
+                    children: [
+                        /*#__PURE__*/ _jsx(Typography, {
+                            variant: "body2",
+                            sx: {
+                                lineHeight: 1.25
+                            },
+                            children: row.name || row.email
+                        }),
+                        row.name ? /*#__PURE__*/ _jsx(Typography, {
+                            variant: "caption",
+                            color: "text.secondary",
+                            sx: {
+                                lineHeight: 1.25
+                            },
+                            noWrap: true,
+                            children: row.email
+                        }) : null
+                    ]
+                })
+        }),
+        {
+            field: 'ownerUid',
+            headerName: 'Owner',
+            flex: 0.9,
+            minWidth: 140,
+            filterable: false,
+            valueGetter: (_value, row)=>row.ownerUid ? memberName(row.ownerUid) : '',
+            renderCell: ({ row })=>row.ownerUid ? /*#__PURE__*/ _jsx(Typography, {
+                    variant: "body2",
+                    noWrap: true,
+                    children: memberName(row.ownerUid)
+                }) : /*#__PURE__*/ _jsx(Typography, {
+                    variant: "caption",
+                    color: "text.secondary",
+                    children: '—'
+                })
+        },
+        {
+            field: 'lifecycleStage',
+            headerName: 'Stage',
+            flex: 0.9,
+            minWidth: 150,
+            filterable: false,
+            valueGetter: (_value, row)=>row.lifecycleStage ? CONTACT_LIFECYCLE_STAGE_LABELS[row.lifecycleStage] : '',
+            renderCell: ({ row })=>row.lifecycleStage ? /*#__PURE__*/ _jsx(Chip, {
+                    size: "small",
+                    variant: "outlined",
+                    label: CONTACT_LIFECYCLE_STAGE_LABELS[row.lifecycleStage]
+                }) : /*#__PURE__*/ _jsx(Typography, {
+                    variant: "caption",
+                    color: "text.secondary",
+                    children: '—'
+                })
+        },
+        /*
+     * KNOWN BY (AGL-2630): the sites that have captured this person, which
+     * is the cross-site fact the organization-level list exists to show —
+     * one deduplicated row per person, and which of the org's sites know
+     * them. `capturedByHostIds` is a top-level array precisely so the
+     * question can be answered without opening a facet. Not filterable from
+     * the panel: an `array-contains` on it would displace the scope clause
+     * under a site, and at the org level a saved view narrows the window
+     * instead. A row that names no site predates attribution and says so,
+     * rather than reading as "every site".
+     */ ...siteName ? [
+            {
+                field: 'capturedByHostIds',
+                headerName: 'Known by',
+                flex: 1.1,
+                minWidth: 200,
+                sortable: false,
+                filterable: false,
+                valueGetter: (_value, row)=>row.capturedByHostIds.map(siteName).join(', '),
+                renderCell: ({ row })=>row.capturedByHostIds.length ? /*#__PURE__*/ _jsxs(Stack, {
+                        direction: "row",
+                        spacing: 0.5,
+                        sx: {
+                            alignItems: 'center',
+                            height: '100%',
+                            flexWrap: 'nowrap'
+                        },
+                        children: [
+                            row.capturedByHostIds.slice(0, 2).map((hostId)=>/*#__PURE__*/ _jsx(Chip, {
+                                    size: "small",
+                                    label: siteName(hostId)
+                                }, hostId)),
+                            row.capturedByHostIds.length > 2 ? /*#__PURE__*/ _jsx(Chip, {
+                                size: "small",
+                                variant: "outlined",
+                                label: `+${row.capturedByHostIds.length - 2}`
+                            }) : null
+                        ]
+                    }) : /*#__PURE__*/ _jsx(Typography, {
+                        variant: "caption",
+                        color: "text.secondary",
+                        children: 'No site recorded'
+                    })
+            }
+        ] : [],
+        {
+            field: 'sources',
+            headerName: 'Sources',
+            flex: 1,
+            minWidth: 160,
+            // A map of provenance flags, not a scalar — `sources.form == true` is
+            // queryable one key at a time, which is a menu of its own rather than
+            // a filter on this column.
+            filterable: false,
+            sortable: false,
+            valueGetter: (_value, row)=>{
+                var _row_sources;
+                return Object.keys((_row_sources = row.sources) != null ? _row_sources : {}).join(', ');
+            },
+            renderCell: ({ row })=>{
+                var _row_sources;
+                return /*#__PURE__*/ _jsx(Stack, {
+                    direction: "row",
+                    spacing: 0.5,
+                    sx: {
+                        alignItems: 'center',
+                        height: '100%'
+                    },
+                    children: Object.keys((_row_sources = row.sources) != null ? _row_sources : {}).map((source)=>{
+                        var _CONTACT_SOURCE_LABELS_source;
+                        return /*#__PURE__*/ _jsx(Chip, {
+                            label: (_CONTACT_SOURCE_LABELS_source = CONTACT_SOURCE_LABELS[source]) != null ? _CONTACT_SOURCE_LABELS_source : source,
+                            size: "small"
+                        }, source);
+                    })
+                });
+            }
+        },
+        _extends({
+            field: 'tags',
+            headerName: 'Tags',
+            flex: 1,
+            minWidth: 150
+        }, listFilterColumn(CONTACT_LIST_FILTER_FIELDS, 'tags'), {
+            sortable: false,
+            valueGetter: (_value, row)=>{
+                var _row_tags;
+                return ((_row_tags = row.tags) != null ? _row_tags : []).join(', ');
+            },
+            renderCell: ({ row })=>{
+                var _row_tags;
+                return ((_row_tags = row.tags) != null ? _row_tags : []).slice(0, 3).join(', ');
+            }
+        }),
+        _extends({
+            field: 'updatedAt',
+            headerName: 'Last activity',
+            flex: 0.8,
+            minWidth: 150,
+            // `type: 'date'` is what gives the panel a date PICKER rather than a
+            // free-text box for a value the query reads as a day.
+            type: 'date'
+        }, listFilterColumn(CONTACT_LIST_FILTER_FIELDS, 'updatedAt'), {
+            valueGetter: (_value, row)=>{
+                var _row_updatedAt;
+                const seconds = (_row_updatedAt = row.updatedAt) == null ? void 0 : _row_updatedAt.seconds;
+                return seconds ? new Date(seconds * 1000) : null;
+            },
+            renderCell: ({ row })=>{
+                var _row_interactions;
+                return /*#__PURE__*/ _jsx(Typography, {
+                    variant: "caption",
+                    color: "text.secondary",
+                    children: ((_row_interactions = row.interactions) == null ? void 0 : _row_interactions[0]) ? new Date(row.interactions[0].atMs).toLocaleDateString() : '—'
+                });
+            }
+        }),
+        // When the earliest open task against the person is due (AGL-2661).
+        nextActivityColumn(nowMs),
+        {
+            /*
+       * When the person last opened or clicked one of this holder's
+       * campaigns (AGL-2616). Off the facet like Owner and Stage, so it can
+       * never show another holder's readers; `filterable: false` for the
+       * same reason theirs are — a facet path is not a query the panel can
+       * make. A date column, so a sort on it orders by the instant and an
+       * export gets a date; the cell prints the relative form the timeline
+       * uses and carries the full stamp in its tooltip.
+       */ field: 'lastEmailEngagementAtMs',
+            headerName: 'Last engaged',
+            flex: 0.8,
+            minWidth: 140,
+            type: 'date',
+            filterable: false,
+            valueGetter: (_value, row)=>row.lastEmailEngagementAtMs ? new Date(row.lastEmailEngagementAtMs) : null,
+            renderCell: ({ row })=>row.lastEmailEngagementAtMs ? /*#__PURE__*/ _jsx(Tooltip, {
+                    title: new Date(row.lastEmailEngagementAtMs).toLocaleString(),
+                    children: /*#__PURE__*/ _jsx(Typography, {
+                        variant: "caption",
+                        color: "text.secondary",
+                        children: activityTimeLabel(row.lastEmailEngagementAtMs, nowMs)
+                    })
+                }) : /*#__PURE__*/ _jsx(Typography, {
+                    variant: "caption",
+                    color: "text.secondary",
+                    children: '—'
+                })
+        },
+        ...hiddenFilterColumns(CONTACT_LIST_FILTER_FIELDS, CONTACT_FILTER_COLUMNS, CONTACT_LIST_FILTER_HEADERS)
+    ];
+}
+
+//# sourceMappingURL=contact-list-columns.js.map

package/src/lib/components/contact-list-columns.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/crm/src/lib/components/contact-list-columns.tsx"],"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'use client'\n\nimport {\n  activityTimeLabel,\n  CONTACT_LIFECYCLE_STAGE_LABELS,\n  CONTACT_SOURCE_LABELS,\n  type ContactSource,\n} from '@aglyn/aglyn'\nimport {\n  hiddenFilterColumns,\n  listFilterColumn,\n} from '@aglyn/shared-ui-jsx/const/list-filter'\nimport { Chip, Stack, Tooltip, Typography } from '@mui/material'\nimport type { GridColDef } from '@mui/x-data-grid'\nimport {\n  CONTACT_LIST_FILTER_FIELDS,\n  CONTACT_LIST_FILTER_HEADERS,\n} from '../constants/contact-filters'\nimport type { ContactRecord } from '../model/contact-record'\nimport { nextActivityColumn } from './crm-next-activity-column'\n\n/**\n * The filterable fields that get a column. The rest of\n * `CONTACT_LIST_FILTER_FIELDS` still reaches the filter panel, hidden.\n */\n/**\n * The declared filter fields that ARE table columns, so the hidden\n * filter-only columns are built for the others alone. Owner and Stage\n * joined it when the grammar learned them (AGL-2617): each is a shown\n * column already, and a second, hidden one under the same field would be\n * a duplicate the grid refuses.\n */\nexport const CONTACT_FILTER_COLUMNS = [\n  'name',\n  'ownerUid',\n  'lifecycleStage',\n  'sources',\n  'tags',\n  'updatedAt',\n  'nextTaskAtMs',\n]\n\n/**\n * The columns that ship HIDDEN, for the grid's visibility model (AGL-2616).\n *\n * \"Last engaged\" is a fact most lists do not need on screen and every list\n * can turn on from the column menu; shipping it visible would widen a\n * table that already carries seven columns for a figure only a marketing\n * reader scans.\n */\nexport const CONTACT_OPTIONAL_COLUMNS = ['lastEmailEngagementAtMs']\n\nexport interface ContactListColumnOptions {\n  /** The owner's name for a uid — the roster's, or the uid itself. */\n  memberName: (uid: string) => string\n  /**\n   * How a site reads, by document id — handed in at the ORGANIZATION level\n   * only (AGL-2630), where it turns on the \"Known by\" column: the sites\n   * that have captured each person. Absent under a site, where every row\n   * is known by the site and the column would say so on every line.\n   */\n  siteName?: (hostId: string) => string\n  /**\n   * One clock for every row of one paint, so two contacts engaged a second\n   * apart cannot read \"just now\" and \"1 min ago\". Defaults to the paint's\n   * own `Date.now()`.\n   */\n  nowMs?: number\n}\n\n/**\n * The contacts list's columns (AGL-2596), in their own module so the list\n * file stays about the QUERY and the toolbar while other surfaces — a bulk\n * bar, an import — grow beside it.\n *\n * Owner and Stage read off the flattened row, which is already this\n * holder's facet (`contactRecordFromDoc`), so neither column can show\n * another holder's assignment. Both are `filterable: false` on purpose: the\n * grid's filter panel translates to a Firestore query over the top-level\n * fields in `CONTACT_LIST_FILTER_FIELDS`, and a facet path is not one of\n * them. The toolbar's stage select and \"Assigned to me\" switch narrow the\n * loaded window instead, and say so.\n */\nexport function contactListColumns(\n  options: ContactListColumnOptions,\n): GridColDef[] {\n  const { memberName, siteName } = options\n  const nowMs = options.nowMs ?? Date.now()\n  return [\n    {\n      field: 'name',\n      headerName: 'Contact',\n      flex: 1.6,\n      minWidth: 220,\n      ...listFilterColumn(CONTACT_LIST_FILTER_FIELDS, 'name'),\n      valueGetter: (_value, row: ContactRecord) =>\n        String(row.name || row.email || ''),\n      renderCell: ({ row }: { row: ContactRecord }) => (\n        <Stack sx={{ justifyContent: 'center', height: '100%', lineHeight: 1.25 }}>\n          <Typography variant=\"body2\" sx={{ lineHeight: 1.25 }}>\n            {row.name || row.email}\n          </Typography>\n          {row.name ? (\n            <Typography\n              variant=\"caption\"\n              color=\"text.secondary\"\n              sx={{ lineHeight: 1.25 }}\n              noWrap\n            >\n              {row.email}\n            </Typography>\n          ) : null}\n        </Stack>\n      ),\n    },\n    {\n      field: 'ownerUid',\n      headerName: 'Owner',\n      flex: 0.9,\n      minWidth: 140,\n      filterable: false,\n      valueGetter: (_value, row: ContactRecord) =>\n        row.ownerUid ? memberName(row.ownerUid) : '',\n      renderCell: ({ row }: { row: ContactRecord }) =>\n        row.ownerUid ? (\n          <Typography variant=\"body2\" noWrap>\n            {memberName(row.ownerUid)}\n          </Typography>\n        ) : (\n          <Typography variant=\"caption\" color=\"text.secondary\">\n            {'—'}\n          </Typography>\n        ),\n    },\n    {\n      field: 'lifecycleStage',\n      headerName: 'Stage',\n      flex: 0.9,\n      minWidth: 150,\n      filterable: false,\n      valueGetter: (_value, row: ContactRecord) =>\n        row.lifecycleStage ? CONTACT_LIFECYCLE_STAGE_LABELS[row.lifecycleStage] : '',\n      renderCell: ({ row }: { row: ContactRecord }) =>\n        row.lifecycleStage ? (\n          <Chip\n            size=\"small\"\n            variant=\"outlined\"\n            label={CONTACT_LIFECYCLE_STAGE_LABELS[row.lifecycleStage]}\n          />\n        ) : (\n          <Typography variant=\"caption\" color=\"text.secondary\">\n            {'—'}\n          </Typography>\n        ),\n    },\n    /*\n     * KNOWN BY (AGL-2630): the sites that have captured this person, which\n     * is the cross-site fact the organization-level list exists to show —\n     * one deduplicated row per person, and which of the org's sites know\n     * them. `capturedByHostIds` is a top-level array precisely so the\n     * question can be answered without opening a facet. Not filterable from\n     * the panel: an `array-contains` on it would displace the scope clause\n     * under a site, and at the org level a saved view narrows the window\n     * instead. A row that names no site predates attribution and says so,\n     * rather than reading as \"every site\".\n     */\n    ...(siteName\n      ? [\n          {\n            field: 'capturedByHostIds',\n            headerName: 'Known by',\n            flex: 1.1,\n            minWidth: 200,\n            sortable: false,\n            filterable: false,\n            valueGetter: (_value: unknown, row: ContactRecord) =>\n              row.capturedByHostIds.map(siteName).join(', '),\n            renderCell: ({ row }: { row: ContactRecord }) =>\n              row.capturedByHostIds.length ? (\n                <Stack\n                  direction=\"row\"\n                  spacing={0.5}\n                  sx={{ alignItems: 'center', height: '100%', flexWrap: 'nowrap' }}\n                >\n                  {row.capturedByHostIds.slice(0, 2).map((hostId) => (\n                    <Chip key={hostId} size=\"small\" label={siteName(hostId)} />\n                  ))}\n                  {row.capturedByHostIds.length > 2 ? (\n                    <Chip\n                      size=\"small\"\n                      variant=\"outlined\"\n                      label={`+${row.capturedByHostIds.length - 2}`}\n                    />\n                  ) : null}\n                </Stack>\n              ) : (\n                <Typography variant=\"caption\" color=\"text.secondary\">\n                  {'No site recorded'}\n                </Typography>\n              ),\n          } satisfies GridColDef,\n        ]\n      : []),\n    {\n      field: 'sources',\n      headerName: 'Sources',\n      flex: 1,\n      minWidth: 160,\n      // A map of provenance flags, not a scalar — `sources.form == true` is\n      // queryable one key at a time, which is a menu of its own rather than\n      // a filter on this column.\n      filterable: false,\n      sortable: false,\n      valueGetter: (_value, row: ContactRecord) =>\n        Object.keys(row.sources ?? {}).join(', '),\n      renderCell: ({ row }: { row: ContactRecord }) => (\n        <Stack\n          direction=\"row\"\n          spacing={0.5}\n          sx={{ alignItems: 'center', height: '100%' }}\n        >\n          {Object.keys(row.sources ?? {}).map((source) => (\n            <Chip\n              key={source}\n              label={CONTACT_SOURCE_LABELS[source as ContactSource] ?? source}\n              size=\"small\"\n            />\n          ))}\n        </Stack>\n      ),\n    },\n    {\n      field: 'tags',\n      headerName: 'Tags',\n      flex: 1,\n      minWidth: 150,\n      ...listFilterColumn(CONTACT_LIST_FILTER_FIELDS, 'tags'),\n      sortable: false,\n      valueGetter: (_value, row: ContactRecord) => (row.tags ?? []).join(', '),\n      renderCell: ({ row }: { row: ContactRecord }) =>\n        (row.tags ?? []).slice(0, 3).join(', '),\n    },\n    {\n      field: 'updatedAt',\n      headerName: 'Last activity',\n      flex: 0.8,\n      minWidth: 150,\n      // `type: 'date'` is what gives the panel a date PICKER rather than a\n      // free-text box for a value the query reads as a day.\n      type: 'date',\n      ...listFilterColumn(CONTACT_LIST_FILTER_FIELDS, 'updatedAt'),\n      valueGetter: (_value, row: ContactRecord) => {\n        const seconds = (row.updatedAt as { seconds?: number } | undefined)?.seconds\n        return seconds ? new Date(seconds * 1000) : null\n      },\n      renderCell: ({ row }: { row: ContactRecord }) => (\n        <Typography variant=\"caption\" color=\"text.secondary\">\n          {row.interactions?.[0]\n            ? new Date(row.interactions[0].atMs).toLocaleDateString()\n            : '—'}\n        </Typography>\n      ),\n    },\n    // When the earliest open task against the person is due (AGL-2661).\n    nextActivityColumn(nowMs),\n    {\n      /*\n       * When the person last opened or clicked one of this holder's\n       * campaigns (AGL-2616). Off the facet like Owner and Stage, so it can\n       * never show another holder's readers; `filterable: false` for the\n       * same reason theirs are — a facet path is not a query the panel can\n       * make. A date column, so a sort on it orders by the instant and an\n       * export gets a date; the cell prints the relative form the timeline\n       * uses and carries the full stamp in its tooltip.\n       */\n      field: 'lastEmailEngagementAtMs',\n      headerName: 'Last engaged',\n      flex: 0.8,\n      minWidth: 140,\n      type: 'date',\n      filterable: false,\n      valueGetter: (_value, row: ContactRecord) =>\n        row.lastEmailEngagementAtMs ? new Date(row.lastEmailEngagementAtMs) : null,\n      renderCell: ({ row }: { row: ContactRecord }) =>\n        row.lastEmailEngagementAtMs ? (\n          <Tooltip title={new Date(row.lastEmailEngagementAtMs).toLocaleString()}>\n            <Typography variant=\"caption\" color=\"text.secondary\">\n              {activityTimeLabel(row.lastEmailEngagementAtMs, nowMs)}\n            </Typography>\n          </Tooltip>\n        ) : (\n          <Typography variant=\"caption\" color=\"text.secondary\">\n            {'—'}\n          </Typography>\n        ),\n    },\n    ...hiddenFilterColumns(\n      CONTACT_LIST_FILTER_FIELDS,\n      CONTACT_FILTER_COLUMNS,\n      CONTACT_LIST_FILTER_HEADERS,\n    ),\n  ]\n}\n"],"names":["activityTimeLabel","CONTACT_LIFECYCLE_STAGE_LABELS","CONTACT_SOURCE_LABELS","hiddenFilterColumns","listFilterColumn","Chip","Stack","Tooltip","Typography","CONTACT_LIST_FILTER_FIELDS","CONTACT_LIST_FILTER_HEADERS","nextActivityColumn","CONTACT_FILTER_COLUMNS","CONTACT_OPTIONAL_COLUMNS","contactListColumns","options","memberName","siteName","nowMs","Date","now","field","headerName","flex","minWidth","valueGetter","_value","row","String","name","email","renderCell","sx","justifyContent","height","lineHeight","variant","color","noWrap","filterable","ownerUid","lifecycleStage","size","label","sortable","capturedByHostIds","map","join","length","direction","spacing","alignItems","flexWrap","slice","hostId","Object","keys","sources","source","tags","type","seconds","updatedAt","interactions","atMs","toLocaleDateString","lastEmailEngagementAtMs","title","toLocaleString"],"mappings":"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"}

package/src/lib/components/contact-merge-dialog.d.ts

@@ -0,0 +1,79 @@
+import { type ConsentGroup } from '@aglyn/aglyn';
+/** One contact as the dialog holds it: its id and the document as read. */
+export interface ContactPick {
+    id: string;
+    doc: Record<string, unknown>;
+}
+/** Which of the two records stays. */
+export type ContactMergeKeep = 'current' | 'other';
+export interface ContactMergeDialogState {
+    open: boolean;
+    /** The record to merge with, when the opener already knows it. */
+    other: ContactPick | null;
+    keep: ContactMergeKeep;
+}
+/**
+ * The dialog's open state, held by the page so two openers — the record's
+ * overflow menu and the likely-duplicates card — share one dialog.
+ *
+ * The menu opens it empty, to be searched, with the OTHER record surviving:
+ * "merge this into…" is what a reader means when they are on the record
+ * they want gone. The duplicates card opens it with the candidate already
+ * picked and THIS record surviving: the reader is on the record they keep,
+ * looking at the copies. Either way the dialog lets them switch.
+ */
+export declare function useContactMergeDialog(): {
+    state: ContactMergeDialogState;
+    open: (options?: {
+        other?: ContactPick;
+        keep?: ContactMergeKeep;
+    }) => void;
+    close: () => void;
+};
+export interface ContactMergeDialogProps extends ContactMergeDialogState {
+    onClose: () => void;
+    /**
+     * The site the merge runs as — the route logs it on that site's feed. At
+     * the organization level the record's own capturing site (AGL-2630), or
+     * `null` for a row no site has captured: beneath the org hub's mount the
+     * route's org variant merges it anyway (AGL-2634), and only a surface
+     * mounted nowhere holds the button.
+     */
+    hostId: string | null;
+    /** The record whose page this is. */
+    current: ContactPick;
+    /** `['orgs', orgId]` — where the contacts live. */
+    scope: readonly [string, string];
+    consentGroup: ConsentGroup;
+    /**
+     * What this viewer may list — the search's `array-contains-any` — or
+     * `null` at the organization level, where the search carries no clause
+     * (AGL-2630).
+     */
+    visibleTo: readonly string[] | null;
+    /** The owner's name for a uid, for the preview. */
+    memberName?: (uid: string) => string;
+    /** Told which record survived, once the server has merged. */
+    onMerged?: (survivorId: string) => void;
+}
+/**
+ * MERGE TWO RECORDS FOR ONE PERSON (AGL-2625).
+ *
+ * Two steps in one dialog. First the OTHER record, found by address or by
+ * name among the contacts this viewer may list — the same two searches the
+ * company's contacts card runs, one read each, on ask. Then the two records
+ * side by side, field by field, with the value the surviving record will
+ * carry and where it came from — `contactMergePreview` is the same rule the
+ * server writes with, so what the reader is shown is what lands.
+ *
+ * The reader picks which record survives. The survivor keeps its address;
+ * the other record's address becomes an alternate on it, its deals, tasks,
+ * activities and leads move, and the document is deleted. The act is one
+ * server route, because it is one transaction over two documents and a
+ * repoint of rows a browser may not be able to list.
+ */
+export declare function ContactMergeDialog(props: ContactMergeDialogProps): import("react").JSX.Element;
+export declare namespace ContactMergeDialog {
+    var displayName: string;
+}
+export default ContactMergeDialog;