@aglyn/plugins-crm 1.0.0-beta.143

package/src/lib/components/contact-merge-dialog.js

@@ -0,0 +1,405 @@
+/**
+ * @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, Fragment as _Fragment } from "react/jsx-runtime";
+import { contactDisplayName, contactMergePreview, nameSearchKey, normalizeContactEmail } from "@aglyn/aglyn";
+import { useSnackbar } from "@aglyn/shared-ui-snackstack";
+import { useFirestore } from "@aglyn/tenant-feature-instance";
+import { ScrollTable } from "@aglyn/shared-ui-jsx/components/scroll-table.component";
+import { Alert, Button, Dialog, DialogActions, DialogContent, DialogTitle, FormControl, FormControlLabel, FormLabel, List, ListItemButton, ListItemText, Radio, RadioGroup, Stack, TableBody, TableCell, TableHead, TableRow, TextField, Typography } from "@mui/material";
+import { collection, endAt, getDocs, limit, orderBy, query, startAt, where } from "firebase/firestore";
+import { useCallback, useEffect, useMemo, useState } from "react";
+import { useCrmOrgMount } from "../hooks/use-crm-org-mount.js";
+import { crmVisibleToClause } from "../hooks/use-crm-scope.js";
+import { useCrmApi } from "./use-crm-api.js";
+/** How many rows a search answers — a picker, not a list. */ const SEARCH_LIMIT = 8;
+/** The high code point that closes a `nameLower` prefix range. */ const HIGH = '';
+/**
+ * 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 function useContactMergeDialog() {
+    const [state, setState] = useState({
+        open: false,
+        other: null,
+        keep: 'other'
+    });
+    const open = useCallback((options = {})=>{
+        var _options_other, _options_keep;
+        return setState({
+            open: true,
+            other: (_options_other = options.other) != null ? _options_other : null,
+            keep: (_options_keep = options.keep) != null ? _options_keep : options.other ? 'current' : 'other'
+        });
+    }, []);
+    const close = useCallback(()=>setState((previous)=>_extends({}, previous, {
+                open: false
+            })), []);
+    return {
+        state,
+        open,
+        close
+    };
+}
+const label = (pick, groupId)=>{
+    var _pick_doc_email;
+    return contactDisplayName(pick.doc, groupId) || String((_pick_doc_email = pick.doc['email']) != null ? _pick_doc_email : pick.id);
+};
+/**
+ * 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 function ContactMergeDialog(props) {
+    var _current_doc_email, _other_doc_email;
+    const { open, onClose, hostId, current, scope, consentGroup, visibleTo, memberName, onMerged } = props;
+    const firestore = useFirestore();
+    const callCrm = useCrmApi(hostId);
+    const { enqueueSnackbar } = useSnackbar();
+    const groupId = consentGroup.groupId;
+    const orgMount = useCrmOrgMount();
+    // A site to run as, or the org to run as (AGL-2634): one of the two is
+    // what the route authorizes against, and with neither there is no door.
+    const canMerge = Boolean(hostId) || Boolean(orgMount);
+    const [other, setOther] = useState(props.other);
+    const [keep, setKeep] = useState(props.keep);
+    const [term, setTerm] = useState('');
+    const [searching, setSearching] = useState(false);
+    const [results, setResults] = useState(null);
+    const [busy, setBusy] = useState(false);
+    const [error, setError] = useState(null);
+    // Reset on every open to what the opener handed over.
+    useEffect(()=>{
+        if (!open) return;
+        setOther(props.other);
+        setKeep(props.keep);
+        setTerm('');
+        setResults(null);
+        setError(null);
+        setBusy(false);
+    }, [
+        open,
+        props.other,
+        props.keep
+    ]);
+    const search = useCallback(async ()=>{
+        const raw = term.trim();
+        if (!raw || searching) return;
+        setSearching(true);
+        setError(null);
+        try {
+            const contactsRef = collection(firestore, scope[0], scope[1], 'contacts');
+            const scoped = crmVisibleToClause(visibleTo);
+            let found;
+            if (raw.includes('@')) {
+                const email = normalizeContactEmail(raw);
+                if (!email) {
+                    setResults([]);
+                    return;
+                }
+                found = await getDocs(query(contactsRef, ...scoped, where('email', '==', email), limit(SEARCH_LIMIT)));
+            } else {
+                const key = nameSearchKey(raw);
+                found = await getDocs(query(contactsRef, ...scoped, orderBy('nameLower'), startAt(key), endAt(`${key}${HIGH}`), limit(SEARCH_LIMIT)));
+            }
+            setResults(found.docs.filter((snapshot)=>snapshot.id !== current.id).map((snapshot)=>({
+                    id: snapshot.id,
+                    doc: snapshot.data()
+                })));
+        } catch (searchError) {
+            console.error(searchError);
+            setResults(null);
+            setError('The search could not be run.');
+        } finally{
+            setSearching(false);
+        }
+    }, [
+        term,
+        searching,
+        firestore,
+        scope,
+        visibleTo,
+        current.id
+    ]);
+    const survivor = keep === 'current' ? current : other;
+    const merged = keep === 'current' ? other : current;
+    const rows = useMemo(()=>survivor && merged ? contactMergePreview(survivor.doc, merged.doc, groupId, {
+            memberName
+        }) : [], [
+        survivor,
+        merged,
+        groupId,
+        memberName
+    ]);
+    const submit = useCallback(async ()=>{
+        if (!survivor || !merged || busy || !canMerge) return;
+        setBusy(true);
+        setError(null);
+        try {
+            const { response, payload } = await callCrm('contacts-merge', {
+                survivorId: survivor.id,
+                mergedId: merged.id
+            });
+            if (!response.ok) {
+                var _payload_error;
+                setError(String((_payload_error = payload['error']) != null ? _payload_error : 'The contacts could not be merged.'));
+                return;
+            }
+            enqueueSnackbar('Contacts merged', {
+                variant: 'success',
+                persist: false
+            });
+            onClose();
+            onMerged == null ? void 0 : onMerged(survivor.id);
+        } catch (submitError) {
+            console.error(submitError);
+            setError('The contacts could not be merged.');
+        } finally{
+            setBusy(false);
+        }
+    }, [
+        survivor,
+        merged,
+        busy,
+        canMerge,
+        callCrm,
+        enqueueSnackbar,
+        onClose,
+        onMerged
+    ]);
+    const currentLabel = label(current, groupId);
+    const otherLabel = other ? label(other, groupId) : '';
+    return /*#__PURE__*/ _jsxs(Dialog, {
+        open: open,
+        onClose: busy ? undefined : onClose,
+        maxWidth: "md",
+        fullWidth: true,
+        children: [
+            /*#__PURE__*/ _jsx(DialogTitle, {
+                children: 'Merge contacts'
+            }),
+            /*#__PURE__*/ _jsx(DialogContent, {
+                children: /*#__PURE__*/ _jsxs(Stack, {
+                    spacing: 2,
+                    sx: {
+                        pt: 1
+                    },
+                    children: [
+                        !other ? /*#__PURE__*/ _jsxs(_Fragment, {
+                            children: [
+                                /*#__PURE__*/ _jsx(Typography, {
+                                    variant: "body2",
+                                    color: "text.secondary",
+                                    children: `Find the other record for ${currentLabel} — by email address, or by name.`
+                                }),
+                                /*#__PURE__*/ _jsxs(Stack, {
+                                    direction: "row",
+                                    spacing: 1,
+                                    sx: {
+                                        alignItems: 'flex-start'
+                                    },
+                                    children: [
+                                        /*#__PURE__*/ _jsx(TextField, {
+                                            label: "Email or name",
+                                            value: term,
+                                            onChange: (event)=>setTerm(event.target.value),
+                                            onKeyDown: (event)=>{
+                                                if (event.key === 'Enter') {
+                                                    event.preventDefault();
+                                                    void search();
+                                                }
+                                            },
+                                            size: "small",
+                                            fullWidth: true,
+                                            autoFocus: true
+                                        }),
+                                        /*#__PURE__*/ _jsx(Button, {
+                                            variant: "outlined",
+                                            onClick: ()=>void search(),
+                                            disabled: !term.trim() || searching,
+                                            children: searching ? 'Searching…' : 'Search'
+                                        })
+                                    ]
+                                }),
+                                results ? results.length ? /*#__PURE__*/ _jsx(List, {
+                                    dense: true,
+                                    disablePadding: true,
+                                    "aria-label": "Matching contacts",
+                                    children: results.map((pick)=>{
+                                        var _pick_doc_email;
+                                        return /*#__PURE__*/ _jsx(ListItemButton, {
+                                            onClick: ()=>setOther(pick),
+                                            children: /*#__PURE__*/ _jsx(ListItemText, {
+                                                primary: label(pick, groupId),
+                                                secondary: String((_pick_doc_email = pick.doc['email']) != null ? _pick_doc_email : '')
+                                            })
+                                        }, pick.id);
+                                    })
+                                }) : /*#__PURE__*/ _jsx(Typography, {
+                                    variant: "body2",
+                                    color: "text.secondary",
+                                    children: 'No other contact matches among the ones you can see.'
+                                }) : null
+                            ]
+                        }) : /*#__PURE__*/ _jsxs(_Fragment, {
+                            children: [
+                                /*#__PURE__*/ _jsxs(FormControl, {
+                                    children: [
+                                        /*#__PURE__*/ _jsx(FormLabel, {
+                                            id: "contact-merge-keep",
+                                            children: 'Keep'
+                                        }),
+                                        /*#__PURE__*/ _jsxs(RadioGroup, {
+                                            "aria-labelledby": "contact-merge-keep",
+                                            value: keep,
+                                            onChange: (event)=>setKeep(event.target.value),
+                                            children: [
+                                                /*#__PURE__*/ _jsx(FormControlLabel, {
+                                                    value: "current",
+                                                    control: /*#__PURE__*/ _jsx(Radio, {
+                                                        size: "small"
+                                                    }),
+                                                    label: `${currentLabel} (${String((_current_doc_email = current.doc['email']) != null ? _current_doc_email : '')})`
+                                                }),
+                                                /*#__PURE__*/ _jsx(FormControlLabel, {
+                                                    value: "other",
+                                                    control: /*#__PURE__*/ _jsx(Radio, {
+                                                        size: "small"
+                                                    }),
+                                                    label: `${otherLabel} (${String((_other_doc_email = other.doc['email']) != null ? _other_doc_email : '')})`
+                                                })
+                                            ]
+                                        })
+                                    ]
+                                }),
+                                /*#__PURE__*/ _jsx(Typography, {
+                                    variant: "body2",
+                                    color: "text.secondary",
+                                    children: 'The kept record keeps every value it has; empty fields fill from the ' + 'other record. Tags, filings and the timeline are combined, and the ' + "other record's deals, tasks, activities and leads move across. Its " + 'address becomes an alternate on the kept record, so a later capture ' + 'on it lands here — and the other record is deleted.'
+                                }),
+                                /*#__PURE__*/ _jsxs(ScrollTable, {
+                                    size: "small",
+                                    "aria-label": "What the merge keeps",
+                                    children: [
+                                        /*#__PURE__*/ _jsx(TableHead, {
+                                            children: /*#__PURE__*/ _jsxs(TableRow, {
+                                                children: [
+                                                    /*#__PURE__*/ _jsx(TableCell, {
+                                                        children: 'Field'
+                                                    }),
+                                                    /*#__PURE__*/ _jsx(TableCell, {
+                                                        children: 'Kept'
+                                                    }),
+                                                    /*#__PURE__*/ _jsx(TableCell, {
+                                                        children: 'Merged'
+                                                    }),
+                                                    /*#__PURE__*/ _jsx(TableCell, {
+                                                        children: 'After'
+                                                    })
+                                                ]
+                                            })
+                                        }),
+                                        /*#__PURE__*/ _jsx(TableBody, {
+                                            children: rows.map((row)=>/*#__PURE__*/ _jsxs(TableRow, {
+                                                    children: [
+                                                        /*#__PURE__*/ _jsx(TableCell, {
+                                                            component: "th",
+                                                            scope: "row",
+                                                            children: row.label
+                                                        }),
+                                                        /*#__PURE__*/ _jsx(TableCell, {
+                                                            sx: {
+                                                                whiteSpace: 'pre-wrap'
+                                                            },
+                                                            children: row.survivor
+                                                        }),
+                                                        /*#__PURE__*/ _jsx(TableCell, {
+                                                            sx: {
+                                                                whiteSpace: 'pre-wrap'
+                                                            },
+                                                            children: row.merged
+                                                        }),
+                                                        /*#__PURE__*/ _jsx(TableCell, {
+                                                            sx: {
+                                                                whiteSpace: 'pre-wrap',
+                                                                fontWeight: row.from === 'merged' || row.from === 'both' ? 600 : undefined
+                                                            },
+                                                            children: row.result
+                                                        })
+                                                    ]
+                                                }, row.key))
+                                        })
+                                    ]
+                                }),
+                                !props.other ? /*#__PURE__*/ _jsx(Button, {
+                                    size: "small",
+                                    onClick: ()=>setOther(null),
+                                    sx: {
+                                        alignSelf: 'flex-start'
+                                    },
+                                    children: 'Pick a different contact'
+                                }) : null
+                            ]
+                        }),
+                        error ? /*#__PURE__*/ _jsx(Alert, {
+                            severity: "error",
+                            children: error
+                        }) : null,
+                        !canMerge ? /*#__PURE__*/ _jsx(Alert, {
+                            severity: "info",
+                            children: 'No site has captured this contact, so there is no site to ' + 'merge it from. Open it from one of your sites instead.'
+                        }) : null
+                    ]
+                })
+            }),
+            /*#__PURE__*/ _jsxs(DialogActions, {
+                children: [
+                    /*#__PURE__*/ _jsx(Button, {
+                        onClick: onClose,
+                        disabled: busy,
+                        children: 'Cancel'
+                    }),
+                    /*#__PURE__*/ _jsx(Button, {
+                        variant: "contained",
+                        onClick: ()=>void submit(),
+                        disabled: !other || busy || !canMerge,
+                        children: busy ? 'Merging…' : 'Merge'
+                    })
+                ]
+            })
+        ]
+    });
+}
+ContactMergeDialog.displayName = 'ContactMergeDialog';
+export default ContactMergeDialog;
+
+//# sourceMappingURL=contact-merge-dialog.js.map

package/src/lib/components/contact-merge-dialog.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/crm/src/lib/components/contact-merge-dialog.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  type ConsentGroup,\n  type ContactMergePreviewRow,\n  contactDisplayName,\n  contactMergePreview,\n  nameSearchKey,\n  normalizeContactEmail,\n} from '@aglyn/aglyn'\nimport { useSnackbar } from '@aglyn/shared-ui-snackstack'\nimport { useFirestore } from '@aglyn/tenant-feature-instance'\nimport { ScrollTable } from '@aglyn/shared-ui-jsx/components/scroll-table.component'\nimport {\n  Alert,\n  Button,\n  Dialog,\n  DialogActions,\n  DialogContent,\n  DialogTitle,\n  FormControl,\n  FormControlLabel,\n  FormLabel,\n  List,\n  ListItemButton,\n  ListItemText,\n  Radio,\n  RadioGroup,\n  Stack,\n  TableBody,\n  TableCell,\n  TableHead,\n  TableRow,\n  TextField,\n  Typography,\n} from '@mui/material'\nimport {\n  collection,\n  endAt,\n  getDocs,\n  limit,\n  orderBy,\n  query,\n  startAt,\n  where,\n} from 'firebase/firestore'\nimport { useCallback, useEffect, useMemo, useState } from 'react'\nimport { useCrmOrgMount } from '../hooks/use-crm-org-mount'\nimport { crmVisibleToClause } from '../hooks/use-crm-scope'\nimport { useCrmApi } from './use-crm-api'\n\n/** One contact as the dialog holds it: its id and the document as read. */\nexport interface ContactPick {\n  id: string\n  doc: Record<string, unknown>\n}\n\n/** Which of the two records stays. */\nexport type ContactMergeKeep = 'current' | 'other'\n\n/** How many rows a search answers — a picker, not a list. */\nconst SEARCH_LIMIT = 8\n/** The high code point that closes a `nameLower` prefix range. */\nconst HIGH = ''\n\nexport interface ContactMergeDialogState {\n  open: boolean\n  /** The record to merge with, when the opener already knows it. */\n  other: ContactPick | null\n  keep: ContactMergeKeep\n}\n\n/**\n * The dialog's open state, held by the page so two openers — the record's\n * overflow menu and the likely-duplicates card — share one dialog.\n *\n * The menu opens it empty, to be searched, with the OTHER record surviving:\n * \"merge this into…\" is what a reader means when they are on the record\n * they want gone. The duplicates card opens it with the candidate already\n * picked and THIS record surviving: the reader is on the record they keep,\n * looking at the copies. Either way the dialog lets them switch.\n */\nexport function useContactMergeDialog() {\n  const [state, setState] = useState<ContactMergeDialogState>({\n    open: false,\n    other: null,\n    keep: 'other',\n  })\n  const open = useCallback(\n    (options: { other?: ContactPick; keep?: ContactMergeKeep } = {}) =>\n      setState({\n        open: true,\n        other: options.other ?? null,\n        keep: options.keep ?? (options.other ? 'current' : 'other'),\n      }),\n    [],\n  )\n  const close = useCallback(\n    () => setState((previous) => ({ ...previous, open: false })),\n    [],\n  )\n  return { state, open, close }\n}\n\nexport interface ContactMergeDialogProps extends ContactMergeDialogState {\n  onClose: () => void\n  /**\n   * The site the merge runs as — the route logs it on that site's feed. At\n   * the organization level the record's own capturing site (AGL-2630), or\n   * `null` for a row no site has captured: beneath the org hub's mount the\n   * route's org variant merges it anyway (AGL-2634), and only a surface\n   * mounted nowhere holds the button.\n   */\n  hostId: string | null\n  /** The record whose page this is. */\n  current: ContactPick\n  /** `['orgs', orgId]` — where the contacts live. */\n  scope: readonly [string, string]\n  consentGroup: ConsentGroup\n  /**\n   * What this viewer may list — the search's `array-contains-any` — or\n   * `null` at the organization level, where the search carries no clause\n   * (AGL-2630).\n   */\n  visibleTo: readonly string[] | null\n  /** The owner's name for a uid, for the preview. */\n  memberName?: (uid: string) => string\n  /** Told which record survived, once the server has merged. */\n  onMerged?: (survivorId: string) => void\n}\n\nconst label = (pick: ContactPick, groupId: string) =>\n  contactDisplayName(pick.doc, groupId) || String(pick.doc['email'] ?? pick.id)\n\n/**\n * MERGE TWO RECORDS FOR ONE PERSON (AGL-2625).\n *\n * Two steps in one dialog. First the OTHER record, found by address or by\n * name among the contacts this viewer may list — the same two searches the\n * company's contacts card runs, one read each, on ask. Then the two records\n * side by side, field by field, with the value the surviving record will\n * carry and where it came from — `contactMergePreview` is the same rule the\n * server writes with, so what the reader is shown is what lands.\n *\n * The reader picks which record survives. The survivor keeps its address;\n * the other record's address becomes an alternate on it, its deals, tasks,\n * activities and leads move, and the document is deleted. The act is one\n * server route, because it is one transaction over two documents and a\n * repoint of rows a browser may not be able to list.\n */\nexport function ContactMergeDialog(props: ContactMergeDialogProps) {\n  const {\n    open,\n    onClose,\n    hostId,\n    current,\n    scope,\n    consentGroup,\n    visibleTo,\n    memberName,\n    onMerged,\n  } = props\n  const firestore = useFirestore()\n  const callCrm = useCrmApi(hostId)\n  const { enqueueSnackbar } = useSnackbar()\n  const groupId = consentGroup.groupId\n  const orgMount = useCrmOrgMount()\n  // A site to run as, or the org to run as (AGL-2634): one of the two is\n  // what the route authorizes against, and with neither there is no door.\n  const canMerge = Boolean(hostId) || Boolean(orgMount)\n\n  const [other, setOther] = useState<ContactPick | null>(props.other)\n  const [keep, setKeep] = useState<ContactMergeKeep>(props.keep)\n  const [term, setTerm] = useState('')\n  const [searching, setSearching] = useState(false)\n  const [results, setResults] = useState<ContactPick[] | null>(null)\n  const [busy, setBusy] = useState(false)\n  const [error, setError] = useState<string | null>(null)\n\n  // Reset on every open to what the opener handed over.\n  useEffect(() => {\n    if (!open) return\n    setOther(props.other)\n    setKeep(props.keep)\n    setTerm('')\n    setResults(null)\n    setError(null)\n    setBusy(false)\n  }, [open, props.other, props.keep])\n\n  const search = useCallback(async () => {\n    const raw = term.trim()\n    if (!raw || searching) return\n    setSearching(true)\n    setError(null)\n    try {\n      const contactsRef = collection(firestore, scope[0], scope[1], 'contacts')\n      const scoped = crmVisibleToClause(visibleTo)\n      let found\n      if (raw.includes('@')) {\n        const email = normalizeContactEmail(raw)\n        if (!email) {\n          setResults([])\n          return\n        }\n        found = await getDocs(\n          query(contactsRef, ...scoped, where('email', '==', email), limit(SEARCH_LIMIT)),\n        )\n      } else {\n        const key = nameSearchKey(raw)\n        found = await getDocs(\n          query(\n            contactsRef,\n            ...scoped,\n            orderBy('nameLower'),\n            startAt(key),\n            endAt(`${key}${HIGH}`),\n            limit(SEARCH_LIMIT),\n          ),\n        )\n      }\n      setResults(\n        found.docs\n          .filter((snapshot) => snapshot.id !== current.id)\n          .map((snapshot) => ({ id: snapshot.id, doc: snapshot.data() })),\n      )\n    } catch (searchError) {\n      console.error(searchError)\n      setResults(null)\n      setError('The search could not be run.')\n    } finally {\n      setSearching(false)\n    }\n  }, [term, searching, firestore, scope, visibleTo, current.id])\n\n  const survivor = keep === 'current' ? current : other\n  const merged = keep === 'current' ? other : current\n  const rows: ContactMergePreviewRow[] = useMemo(\n    () =>\n      survivor && merged\n        ? contactMergePreview(survivor.doc, merged.doc, groupId, { memberName })\n        : [],\n    [survivor, merged, groupId, memberName],\n  )\n\n  const submit = useCallback(async () => {\n    if (!survivor || !merged || busy || !canMerge) return\n    setBusy(true)\n    setError(null)\n    try {\n      const { response, payload } = await callCrm('contacts-merge', {\n        survivorId: survivor.id,\n        mergedId: merged.id,\n      })\n      if (!response.ok) {\n        setError(String(payload['error'] ?? 'The contacts could not be merged.'))\n        return\n      }\n      enqueueSnackbar('Contacts merged', { variant: 'success', persist: false })\n      onClose()\n      onMerged?.(survivor.id)\n    } catch (submitError) {\n      console.error(submitError)\n      setError('The contacts could not be merged.')\n    } finally {\n      setBusy(false)\n    }\n  }, [survivor, merged, busy, canMerge, callCrm, enqueueSnackbar, onClose, onMerged])\n\n  const currentLabel = label(current, groupId)\n  const otherLabel = other ? label(other, groupId) : ''\n\n  return (\n    <Dialog open={open} onClose={busy ? undefined : onClose} maxWidth=\"md\" fullWidth>\n      <DialogTitle>{'Merge contacts'}</DialogTitle>\n      <DialogContent>\n        <Stack spacing={2} sx={{ pt: 1 }}>\n          {!other ? (\n            <>\n              <Typography variant=\"body2\" color=\"text.secondary\">\n                {`Find the other record for ${currentLabel} — by email address, or by name.`}\n              </Typography>\n              <Stack direction=\"row\" spacing={1} sx={{ alignItems: 'flex-start' }}>\n                <TextField\n                  label=\"Email or name\"\n                  value={term}\n                  onChange={(event) => setTerm(event.target.value)}\n                  onKeyDown={(event) => {\n                    if (event.key === 'Enter') {\n                      event.preventDefault()\n                      void search()\n                    }\n                  }}\n                  size=\"small\"\n                  fullWidth\n                  autoFocus\n                />\n                <Button\n                  variant=\"outlined\"\n                  onClick={() => void search()}\n                  disabled={!term.trim() || searching}\n                >\n                  {searching ? 'Searching…' : 'Search'}\n                </Button>\n              </Stack>\n              {results ? (\n                results.length ? (\n                  <List dense disablePadding aria-label=\"Matching contacts\">\n                    {results.map((pick) => (\n                      <ListItemButton key={pick.id} onClick={() => setOther(pick)}>\n                        <ListItemText\n                          primary={label(pick, groupId)}\n                          secondary={String(pick.doc['email'] ?? '')}\n                        />\n                      </ListItemButton>\n                    ))}\n                  </List>\n                ) : (\n                  <Typography variant=\"body2\" color=\"text.secondary\">\n                    {'No other contact matches among the ones you can see.'}\n                  </Typography>\n                )\n              ) : null}\n            </>\n          ) : (\n            <>\n              <FormControl>\n                <FormLabel id=\"contact-merge-keep\">{'Keep'}</FormLabel>\n                <RadioGroup\n                  aria-labelledby=\"contact-merge-keep\"\n                  value={keep}\n                  onChange={(event) => setKeep(event.target.value as ContactMergeKeep)}\n                >\n                  <FormControlLabel\n                    value=\"current\"\n                    control={<Radio size=\"small\" />}\n                    label={`${currentLabel} (${String(current.doc['email'] ?? '')})`}\n                  />\n                  <FormControlLabel\n                    value=\"other\"\n                    control={<Radio size=\"small\" />}\n                    label={`${otherLabel} (${String(other.doc['email'] ?? '')})`}\n                  />\n                </RadioGroup>\n              </FormControl>\n              <Typography variant=\"body2\" color=\"text.secondary\">\n                {'The kept record keeps every value it has; empty fields fill from the ' +\n                  'other record. Tags, filings and the timeline are combined, and the ' +\n                  \"other record's deals, tasks, activities and leads move across. Its \" +\n                  'address becomes an alternate on the kept record, so a later capture ' +\n                  'on it lands here — and the other record is deleted.'}\n              </Typography>\n              <ScrollTable size=\"small\" aria-label=\"What the merge keeps\">\n                <TableHead>\n                  <TableRow>\n                    <TableCell>{'Field'}</TableCell>\n                    <TableCell>{'Kept'}</TableCell>\n                    <TableCell>{'Merged'}</TableCell>\n                    <TableCell>{'After'}</TableCell>\n                  </TableRow>\n                </TableHead>\n                <TableBody>\n                  {rows.map((row) => (\n                    <TableRow key={row.key}>\n                      <TableCell component=\"th\" scope=\"row\">\n                        {row.label}\n                      </TableCell>\n                      <TableCell sx={{ whiteSpace: 'pre-wrap' }}>{row.survivor}</TableCell>\n                      <TableCell sx={{ whiteSpace: 'pre-wrap' }}>{row.merged}</TableCell>\n                      <TableCell\n                        sx={{\n                          whiteSpace: 'pre-wrap',\n                          fontWeight: row.from === 'merged' || row.from === 'both' ? 600 : undefined,\n                        }}\n                      >\n                        {row.result}\n                      </TableCell>\n                    </TableRow>\n                  ))}\n                </TableBody>\n              </ScrollTable>\n              {!props.other ? (\n                <Button size=\"small\" onClick={() => setOther(null)} sx={{ alignSelf: 'flex-start' }}>\n                  {'Pick a different contact'}\n                </Button>\n              ) : null}\n            </>\n          )}\n          {error ? <Alert severity=\"error\">{error}</Alert> : null}\n          {!canMerge ? (\n            <Alert severity=\"info\">\n              {'No site has captured this contact, so there is no site to ' +\n                'merge it from. Open it from one of your sites instead.'}\n            </Alert>\n          ) : null}\n        </Stack>\n      </DialogContent>\n      <DialogActions>\n        <Button onClick={onClose} disabled={busy}>\n          {'Cancel'}\n        </Button>\n        <Button\n          variant=\"contained\"\n          onClick={() => void submit()}\n          disabled={!other || busy || !canMerge}\n        >\n          {busy ? 'Merging…' : 'Merge'}\n        </Button>\n      </DialogActions>\n    </Dialog>\n  )\n}\nContactMergeDialog.displayName = 'ContactMergeDialog'\n\nexport default ContactMergeDialog\n"],"names":["contactDisplayName","contactMergePreview","nameSearchKey","normalizeContactEmail","useSnackbar","useFirestore","ScrollTable","Alert","Button","Dialog","DialogActions","DialogContent","DialogTitle","FormControl","FormControlLabel","FormLabel","List","ListItemButton","ListItemText","Radio","RadioGroup","Stack","TableBody","TableCell","TableHead","TableRow","TextField","Typography","collection","endAt","getDocs","limit","orderBy","query","startAt","where","useCallback","useEffect","useMemo","useState","useCrmOrgMount","crmVisibleToClause","useCrmApi","SEARCH_LIMIT","HIGH","useContactMergeDialog","state","setState","open","other","keep","options","close","previous","label","pick","groupId","doc","String","id","ContactMergeDialog","props","current","onClose","hostId","scope","consentGroup","visibleTo","memberName","onMerged","firestore","callCrm","enqueueSnackbar","orgMount","canMerge","Boolean","setOther","setKeep","term","setTerm","searching","setSearching","results","setResults","busy","setBusy","error","setError","search","raw","trim","contactsRef","scoped","found","includes","email","key","docs","filter","snapshot","map","data","searchError","console","survivor","merged","rows","submit","response","payload","survivorId","mergedId","ok","variant","persist","submitError","currentLabel","otherLabel","undefined","maxWidth","fullWidth","spacing","sx","pt","color","direction","alignItems","value","onChange","event","target","onKeyDown","preventDefault","size","autoFocus","onClick","disabled","length","dense","disablePadding","aria-label","primary","secondary","aria-labelledby","control","row","component","whiteSpace","fontWeight","from","result","alignSelf","severity","displayName"],"mappings":"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"}

package/src/lib/components/contact-properties-card.d.ts

@@ -0,0 +1,89 @@
+import { type AglynOrgBilling, type ConsentGroup } from '@aglyn/aglyn';
+import { type ContactRecord } from '../model/contact-record';
+import type { OrgMembers } from './use-org-members';
+export interface ContactPropertiesCardProps {
+    /** The site the record is read under, or `null` at the organization level. */
+    hostId: string | null;
+    /** The org document the shell passed, for the company picker's scope. */
+    org?: Partial<AglynOrgBilling> | null;
+    /** The row, flattened through the viewing group's facet. */
+    record: ContactRecord;
+    /** The controller whose facet the edits are saved into. */
+    consentGroup: ConsentGroup;
+    /**
+     * The listener's verdict on the row the drafts were seeded from, for the
+     * guard that refuses a save over an unconfirmed read.
+     */
+    seed: {
+        status: 'loading' | 'success' | 'error';
+        fromCache: boolean;
+    };
+    /** The team, for the owner picker and the owner's name. */
+    members: OrgMembers;
+    /**
+     * The org's plan lacks the CRM (AGL-2788), which the shell mounts no CRM
+     * page for (AGL-2851). The owner, the lifecycle stage and the company
+     * show, locked, and are left out of a save; `crm/contact-update` refuses
+     * such a plan the rest of the profile, the tags and the notes too.
+     */
+    suiteLocked?: boolean;
+}
+/**
+ * THE RECORD ITSELF: every field a team keeps on a person, in one card with
+ * one Save (AGL-2596).
+ *
+ * ## One save, one request, one guard
+ *
+ * A field-at-a-time save would be nine requests and nine chances for the
+ * stale-seed guard to refuse one of them — so the card holds a draft of the
+ * whole profile and sends it once. The guard WRAPS the send: a row seeded
+ * from the cache or from a failed read is refused with the message the guard
+ * chooses, and what was typed stays in the fields, because a refusal that
+ * also emptied the form would read as a save that worked.
+ *
+ * ## The server writes the facet (AGL-2804)
+ *
+ * Every field here lives in THIS holder's facet, and the Firestore rules
+ * cannot tell one field of a facet from another, so the card writes nothing
+ * itself. The draft goes to `crm/contact-update`, which writes each field by
+ * dotted path into the holder's facet — never a nested object, which would
+ * take every other holder's records with it — clears a blank field rather
+ * than storing it empty, keeps the phone's and the company's search echoes
+ * at the top of the document, and refuses every field to a plan without
+ * the CRM. A refusal is shown in the route's own words.
+ *
+ * ## The stage goes to its own route
+ *
+ * The lifecycle stage is the one field an automation listens for:
+ * `contactStageChanged` (AGL-2605) is emitted by `crm/contact-stage` after it
+ * performs the write, and by nothing else. So when the stage the reader
+ * picked differs from the one the record holds, it is sent to that route
+ * once the rest of the profile has landed — the stage picked, or `null` for
+ * "Not placed yet", which clears it and announces nothing. A refusal from
+ * that route is reported on its own, with its sentence, after the fields that
+ * did save.
+ *
+ * ## The name is an override
+ *
+ * The canonical name is shared by every site holding the person, so this
+ * card never edits it. What it saves is this holder's own name for them,
+ * and the helper says what a blank falls back to, so nobody clears the
+ * field expecting the record to go nameless.
+ *
+ * ## Company is a record, with its name kept beside it
+ *
+ * The Company field is the picker (AGL-2613): the link is `companyId` in
+ * this holder's facet, mirrored into the top-level `companyIds` for the
+ * company page's query, and the company's contacts count moves with it —
+ * all planned by the route from the stored document, so this card never
+ * reasons about another holder's link. The name is sent too, from the picked
+ * company, because the list column and the global search read the name and
+ * not the id; a record that carries a name with no link — an import, a save
+ * from before the picker — keeps it as the label, and the picker offers it
+ * as the company to link or create.
+ */
+export declare function ContactPropertiesCard(props: ContactPropertiesCardProps): import("react").JSX.Element;
+export declare namespace ContactPropertiesCard {
+    var displayName: string;
+}
+export default ContactPropertiesCard;