@aglyn/plugins-crm 1.0.0-beta.143

package/src/lib/components/contact-properties-card.js

@@ -0,0 +1,492 @@
+/**
+ * @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 * as Aglyn from "@aglyn/aglyn";
+import { CONTACT_LIFECYCLE_STAGE_LABELS, CONTACT_LIFECYCLE_STAGES, crmTelHref, normalizePhone } from "@aglyn/aglyn";
+import { mdiPhoneOutline } from "@aglyn/shared-data-mdi";
+import { CardDisplay, MdiIcon } from "@aglyn/shared-ui-jsx";
+import { useSnackbar } from "@aglyn/shared-ui-snackstack";
+import { useUser, writeGuardedBySeed } from "@aglyn/tenant-feature-instance";
+import { Button, Grid, IconButton, InputAdornment, MenuItem, Stack, TextField, Tooltip, Typography } from "@mui/material";
+import { useCallback, useEffect, useState } from "react";
+import { useContactUpdate } from "../hooks/use-contact-update.js";
+import { useCrmActivityLogger } from "../hooks/use-crm-activity-logger.js";
+import { parseContactTags } from "../model/contact-record.js";
+import { setContactStage } from "../model/crm-api.js";
+import { CompanyPicker, useCompanyOptions, useCreateCompany } from "./company-picker.js";
+import { addressDraftFrom, ContactAddressFields } from "./contact-address-fields.js";
+import { crmSuiteLockedReason } from "./crm-suite-lock.js";
+/**
+ * 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 function ContactPropertiesCard(props) {
+    const { hostId, org, record, consentGroup, seed, members, suiteLocked = false } = props;
+    const { data: user } = useUser();
+    const { enqueueSnackbar } = useSnackbar();
+    const contactUpdate = useContactUpdate(hostId);
+    // The site a stage move is routed through: the mounted one, or at the
+    // organization level the holder's own (AGL-2630).
+    const siteHostId = hostId != null ? hostId : consentGroup.hostId || null;
+    /*
+   * The feed the act is logged in, decided by the level it was performed
+   * at (AGL-2738) and so given the MOUNTED site rather than `siteHostId`:
+   * at the org hub a client-direct append to the holder's own site would
+   * face a gate the record write never had to pass.
+   */ const logActivity = useCrmActivityLogger(hostId);
+    const companies = useCompanyOptions({
+        hostId,
+        org
+    });
+    const createCompany = useCreateCompany({
+        hostId,
+        org
+    });
+    const [nameOverride, setNameOverride] = useState(record.nameOverride);
+    const [phone, setPhone] = useState(record.phone);
+    const [jobTitle, setJobTitle] = useState(record.jobTitle);
+    const [companyName, setCompanyName] = useState(record.companyName);
+    const [companyId, setCompanyId] = useState(record.companyId || null);
+    const [ownerUid, setOwnerUid] = useState(record.ownerUid);
+    const [lifecycleStage, setLifecycleStage] = useState(record.lifecycleStage);
+    const [tags, setTags] = useState(record.tags.join(', '));
+    const [notes, setNotes] = useState(record.notes);
+    const [address, setAddress] = useState(addressDraftFrom(record.address));
+    const [phoneError, setPhoneError] = useState('');
+    const [saving, setSaving] = useState(false);
+    /*
+   * Re-seeded when the RECORD changes, not when it re-renders. The listener
+   * delivers a fresh row on every snapshot, including the one this card's
+   * own save produces; re-seeding on each would overwrite what somebody is
+   * in the middle of typing with what the server last confirmed.
+   */ const recordId = record.$id;
+    useEffect(()=>{
+        setNameOverride(record.nameOverride);
+        setPhone(record.phone);
+        setJobTitle(record.jobTitle);
+        setCompanyName(record.companyName);
+        setCompanyId(record.companyId || null);
+        setOwnerUid(record.ownerUid);
+        setLifecycleStage(record.lifecycleStage);
+        setTags(record.tags.join(', '));
+        setNotes(record.notes);
+        setAddress(addressDraftFrom(record.address));
+        setPhoneError('');
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [
+        recordId
+    ]);
+    const handleSave = useCallback(async ()=>{
+        const trimmedPhone = phone.trim();
+        const normalizedPhone = trimmedPhone ? normalizePhone(trimmedPhone) : '';
+        if (trimmedPhone && !normalizedPhone) {
+            setPhoneError('Enter it with its country code, like +1 512 555 0107.');
+            return;
+        }
+        setPhoneError('');
+        // A stage that differs from the record's is the stage route's to write —
+        // see the note above.
+        const stageChanged = !suiteLocked && lifecycleStage !== record.lifecycleStage;
+        const set = _extends({
+            name: nameOverride.trim().slice(0, 120),
+            phone: normalizedPhone != null ? normalizedPhone : '',
+            jobTitle: jobTitle.trim().slice(0, 120),
+            address,
+            tags: parseContactTags(tags),
+            notes: notes.slice(0, 2000)
+        }, suiteLocked ? {} : {
+            ownerUid,
+            companyId,
+            companyName: companyName.trim().slice(0, 120)
+        });
+        setSaving(true);
+        try {
+            const verdict = await writeGuardedBySeed({
+                subject: 'contact',
+                unreadable: seed.status === 'error',
+                fromCache: seed.fromCache
+            }, ()=>contactUpdate.updateOne(record.$id, set));
+            if (!verdict.ok) {
+                return void enqueueSnackbar(verdict.message, {
+                    variant: 'warning',
+                    persist: false
+                });
+            }
+            logActivity('Updated contact', {
+                type: 'contact',
+                id: record.$id,
+                name: record.name || record.email
+            });
+            if (stageChanged && siteHostId) {
+                try {
+                    await setContactStage(user, siteHostId, record.$id, lifecycleStage || null);
+                } catch (error) {
+                    // The rest of the profile is saved; only the stage was refused, and
+                    // the route's own sentence says why.
+                    return void enqueueSnackbar(`Saved, but the stage could not be changed: ${error instanceof Error ? error.message : 'the request failed'}`, {
+                        variant: 'warning',
+                        persist: false
+                    });
+                }
+            }
+            enqueueSnackbar('Contact saved', {
+                variant: 'success',
+                persist: false
+            });
+        } catch (error) {
+            console.error(error);
+            enqueueSnackbar(error instanceof Error && error.message ? error.message : 'An error has occurred', {
+                variant: 'error',
+                allowDuplicate: true
+            });
+        } finally{
+            setSaving(false);
+        }
+    }, [
+        address,
+        companyId,
+        companyName,
+        contactUpdate,
+        enqueueSnackbar,
+        siteHostId,
+        jobTitle,
+        lifecycleStage,
+        logActivity,
+        nameOverride,
+        notes,
+        ownerUid,
+        phone,
+        record.$id,
+        record.email,
+        record.lifecycleStage,
+        record.name,
+        seed.fromCache,
+        seed.status,
+        suiteLocked,
+        tags,
+        user
+    ]);
+    /*
+   * An owner the roster no longer lists — somebody who left the team — is
+   * still offered as the current value, named by their uid, so the select is
+   * never handed a value it has no option for and the reader can see who it
+   * was before reassigning.
+   */ const ownerKnown = members.options.some((option)=>option.uid === ownerUid);
+    /** The number in the box as something a dialer takes, or nothing (AGL-2661). */ const telHref = crmTelHref(phone);
+    return /*#__PURE__*/ _jsx(CardDisplay, {
+        header: 'Properties',
+        help: Aglyn.pluginDocsHelp('contactRecord', {
+            anchor: '#the-record-page'
+        }),
+        contentGutterX: true,
+        contentGutterY: true,
+        HeaderProps: {
+            action: /*#__PURE__*/ _jsx(Button, {
+                variant: "contained",
+                color: "primary",
+                size: "small",
+                disabled: saving,
+                onClick: ()=>void handleSave(),
+                children: saving ? 'Saving…' : 'Save'
+            })
+        },
+        children: /*#__PURE__*/ _jsxs(Grid, {
+            container: true,
+            spacing: 2,
+            children: [
+                /*#__PURE__*/ _jsx(Grid, {
+                    size: {
+                        xs: 12,
+                        sm: 6
+                    },
+                    children: /*#__PURE__*/ _jsx(TextField, {
+                        size: "small",
+                        label: "Email",
+                        value: record.email,
+                        slotProps: {
+                            input: {
+                                readOnly: true
+                            }
+                        },
+                        helperText: "The identity every site shares — it cannot be edited here.",
+                        fullWidth: true
+                    })
+                }),
+                /*#__PURE__*/ _jsx(Grid, {
+                    size: {
+                        xs: 12,
+                        sm: 6
+                    },
+                    children: /*#__PURE__*/ _jsx(TextField, {
+                        size: "small",
+                        label: "Name",
+                        value: nameOverride,
+                        onChange: (event)=>setNameOverride(event.target.value),
+                        slotProps: {
+                            htmlInput: {
+                                maxLength: 120
+                            }
+                        },
+                        helperText: record.canonicalName ? `Your own name for this person. Blank shows the name they gave: ${record.canonicalName}.` : 'Your own name for this person.',
+                        fullWidth: true
+                    })
+                }),
+                /*#__PURE__*/ _jsx(Grid, {
+                    size: {
+                        xs: 12,
+                        sm: 6
+                    },
+                    children: /*#__PURE__*/ _jsx(TextField, {
+                        size: "small",
+                        label: "Phone",
+                        value: phone,
+                        onChange: (event)=>setPhone(event.target.value),
+                        error: Boolean(phoneError),
+                        helperText: phoneError || 'With the country code, like +1 512 555 0107',
+                        fullWidth: true,
+                        slotProps: {
+                            input: {
+                                /*
+                 * Click-to-call (AGL-2661), off what is IN the box rather
+                 * than off the saved value: the number on screen is the one
+                 * a reader means to ring, and `crmTelHref` withholds the
+                 * link from anything half-typed.
+                 */ endAdornment: telHref ? /*#__PURE__*/ _jsx(InputAdornment, {
+                                    position: "end",
+                                    children: /*#__PURE__*/ _jsx(Tooltip, {
+                                        title: `Call ${phone.trim()}`,
+                                        children: /*#__PURE__*/ _jsx(IconButton, {
+                                            component: "a",
+                                            href: telHref,
+                                            size: "small",
+                                            edge: "end",
+                                            "aria-label": `Call ${phone.trim()}`,
+                                            children: /*#__PURE__*/ _jsx(MdiIcon, {
+                                                path: mdiPhoneOutline.path,
+                                                size: 0.8
+                                            })
+                                        })
+                                    })
+                                }) : null
+                            }
+                        }
+                    })
+                }),
+                /*#__PURE__*/ _jsx(Grid, {
+                    size: {
+                        xs: 12,
+                        sm: 6
+                    },
+                    children: /*#__PURE__*/ _jsx(TextField, {
+                        size: "small",
+                        label: "Job title",
+                        value: jobTitle,
+                        onChange: (event)=>setJobTitle(event.target.value),
+                        slotProps: {
+                            htmlInput: {
+                                maxLength: 120
+                            }
+                        },
+                        fullWidth: true
+                    })
+                }),
+                /*#__PURE__*/ _jsx(Grid, {
+                    size: {
+                        xs: 12,
+                        sm: 6
+                    },
+                    children: /*#__PURE__*/ _jsx(CompanyPicker, {
+                        options: companies.options,
+                        ready: companies.ready,
+                        truncated: companies.truncated,
+                        value: companyId,
+                        onChange: (id, company)=>{
+                            setCompanyId(id);
+                            // The label follows the link: the picked name, or nothing
+                            // once the link is cleared. A company the list cannot name
+                            // keeps whatever label the record already had.
+                            setCompanyName(company ? company.name : id ? companyName : '');
+                        },
+                        onCreate: createCompany,
+                        email: record.email,
+                        fallbackName: companyName,
+                        disabled: saving || suiteLocked,
+                        helperText: suiteLocked ? crmSuiteLockedReason() : undefined
+                    })
+                }),
+                /*#__PURE__*/ _jsx(Grid, {
+                    size: {
+                        xs: 12,
+                        sm: 6
+                    },
+                    children: /*#__PURE__*/ _jsxs(TextField, {
+                        select: true,
+                        size: "small",
+                        label: "Lifecycle stage",
+                        value: lifecycleStage,
+                        onChange: (event)=>setLifecycleStage(event.target.value),
+                        disabled: suiteLocked,
+                        helperText: suiteLocked ? crmSuiteLockedReason() : undefined,
+                        fullWidth: true,
+                        children: [
+                            /*#__PURE__*/ _jsx(MenuItem, {
+                                value: "",
+                                children: 'Not placed yet'
+                            }),
+                            CONTACT_LIFECYCLE_STAGES.map((stage)=>/*#__PURE__*/ _jsx(MenuItem, {
+                                    value: stage,
+                                    children: CONTACT_LIFECYCLE_STAGE_LABELS[stage]
+                                }, stage))
+                        ]
+                    })
+                }),
+                /*#__PURE__*/ _jsx(Grid, {
+                    size: {
+                        xs: 12,
+                        sm: 6
+                    },
+                    children: /*#__PURE__*/ _jsxs(TextField, {
+                        select: true,
+                        size: "small",
+                        label: "Owner",
+                        value: ownerUid,
+                        onChange: (event)=>setOwnerUid(event.target.value),
+                        disabled: suiteLocked,
+                        helperText: suiteLocked ? crmSuiteLockedReason() : members.ready && !members.options.length ? 'The team roster could not be read, so nobody can be picked yet.' : 'The team member responsible for this relationship',
+                        fullWidth: true,
+                        children: [
+                            /*#__PURE__*/ _jsx(MenuItem, {
+                                value: "",
+                                children: 'Unassigned'
+                            }),
+                            ownerUid && !ownerKnown ? /*#__PURE__*/ _jsx(MenuItem, {
+                                value: ownerUid,
+                                children: members.memberName(ownerUid)
+                            }) : null,
+                            members.options.map((owner)=>/*#__PURE__*/ _jsx(MenuItem, {
+                                    value: owner.uid,
+                                    children: owner.label
+                                }, owner.uid))
+                        ]
+                    })
+                }),
+                /*#__PURE__*/ _jsx(Grid, {
+                    size: {
+                        xs: 12,
+                        sm: 6
+                    },
+                    children: /*#__PURE__*/ _jsx(TextField, {
+                        size: "small",
+                        label: "Tags",
+                        placeholder: "vip, beta",
+                        helperText: "Comma-separated",
+                        value: tags,
+                        onChange: (event)=>setTags(event.target.value),
+                        fullWidth: true
+                    })
+                }),
+                /*#__PURE__*/ _jsx(Grid, {
+                    size: {
+                        xs: 12
+                    },
+                    children: /*#__PURE__*/ _jsxs(Stack, {
+                        spacing: 1,
+                        children: [
+                            /*#__PURE__*/ _jsx(Typography, {
+                                variant: "subtitle2",
+                                children: 'Address'
+                            }),
+                            /*#__PURE__*/ _jsx(ContactAddressFields, {
+                                value: address,
+                                onChange: setAddress
+                            })
+                        ]
+                    })
+                }),
+                /*#__PURE__*/ _jsx(Grid, {
+                    size: {
+                        xs: 12
+                    },
+                    children: /*#__PURE__*/ _jsx(TextField, {
+                        size: "small",
+                        label: "About",
+                        value: notes,
+                        onChange: (event)=>setNotes(event.target.value),
+                        helperText: "Notes for your team. Nobody outside this site's group can read them.",
+                        multiline: true,
+                        minRows: 3,
+                        fullWidth: true
+                    })
+                })
+            ]
+        })
+    });
+}
+ContactPropertiesCard.displayName = 'ContactPropertiesCard';
+export default ContactPropertiesCard;
+
+//# sourceMappingURL=contact-properties-card.js.map

package/src/lib/components/contact-properties-card.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/crm/src/lib/components/contact-properties-card.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 * as Aglyn from '@aglyn/aglyn'\nimport {\n  type AglynOrgBilling,\n  CONTACT_LIFECYCLE_STAGE_LABELS,\n  CONTACT_LIFECYCLE_STAGES,\n  type ConsentGroup,\n  type ContactLifecycleStage,\n  crmTelHref,\n  normalizePhone,\n} from '@aglyn/aglyn'\nimport { mdiPhoneOutline } from '@aglyn/shared-data-mdi'\nimport { CardDisplay, MdiIcon } from '@aglyn/shared-ui-jsx'\nimport { useSnackbar } from '@aglyn/shared-ui-snackstack'\nimport { useUser, writeGuardedBySeed } from '@aglyn/tenant-feature-instance'\nimport {\n  Button,\n  Grid,\n  IconButton,\n  InputAdornment,\n  MenuItem,\n  Stack,\n  TextField,\n  Tooltip,\n  Typography,\n} from '@mui/material'\nimport { useCallback, useEffect, useState } from 'react'\nimport { useContactUpdate } from '../hooks/use-contact-update'\nimport { useCrmActivityLogger } from '../hooks/use-crm-activity-logger'\nimport { type ContactRecord, parseContactTags } from '../model/contact-record'\nimport type { ContactUpdateFields } from '../model/contact-update'\nimport { setContactStage } from '../model/crm-api'\nimport {\n  CompanyPicker,\n  useCompanyOptions,\n  useCreateCompany,\n} from './company-picker'\nimport {\n  addressDraftFrom,\n  ContactAddressFields,\n  type AddressDraft,\n} from './contact-address-fields'\nimport { crmSuiteLockedReason } from './crm-suite-lock'\nimport type { OrgMembers } from './use-org-members'\n\nexport interface ContactPropertiesCardProps {\n  /** The site the record is read under, or `null` at the organization level. */\n  hostId: string | null\n  /** The org document the shell passed, for the company picker's scope. */\n  org?: Partial<AglynOrgBilling> | null\n  /** The row, flattened through the viewing group's facet. */\n  record: ContactRecord\n  /** The controller whose facet the edits are saved into. */\n  consentGroup: ConsentGroup\n  /**\n   * The listener's verdict on the row the drafts were seeded from, for the\n   * guard that refuses a save over an unconfirmed read.\n   */\n  seed: { status: 'loading' | 'success' | 'error'; fromCache: boolean }\n  /** The team, for the owner picker and the owner's name. */\n  members: OrgMembers\n  /**\n   * The org's plan lacks the CRM (AGL-2788), which the shell mounts no CRM\n   * page for (AGL-2851). The owner, the lifecycle stage and the company\n   * show, locked, and are left out of a save; `crm/contact-update` refuses\n   * such a plan the rest of the profile, the tags and the notes too.\n   */\n  suiteLocked?: boolean\n}\n\n/**\n * THE RECORD ITSELF: every field a team keeps on a person, in one card with\n * one Save (AGL-2596).\n *\n * ## One save, one request, one guard\n *\n * A field-at-a-time save would be nine requests and nine chances for the\n * stale-seed guard to refuse one of them — so the card holds a draft of the\n * whole profile and sends it once. The guard WRAPS the send: a row seeded\n * from the cache or from a failed read is refused with the message the guard\n * chooses, and what was typed stays in the fields, because a refusal that\n * also emptied the form would read as a save that worked.\n *\n * ## The server writes the facet (AGL-2804)\n *\n * Every field here lives in THIS holder's facet, and the Firestore rules\n * cannot tell one field of a facet from another, so the card writes nothing\n * itself. The draft goes to `crm/contact-update`, which writes each field by\n * dotted path into the holder's facet — never a nested object, which would\n * take every other holder's records with it — clears a blank field rather\n * than storing it empty, keeps the phone's and the company's search echoes\n * at the top of the document, and refuses every field to a plan without\n * the CRM. A refusal is shown in the route's own words.\n *\n * ## The stage goes to its own route\n *\n * The lifecycle stage is the one field an automation listens for:\n * `contactStageChanged` (AGL-2605) is emitted by `crm/contact-stage` after it\n * performs the write, and by nothing else. So when the stage the reader\n * picked differs from the one the record holds, it is sent to that route\n * once the rest of the profile has landed — the stage picked, or `null` for\n * \"Not placed yet\", which clears it and announces nothing. A refusal from\n * that route is reported on its own, with its sentence, after the fields that\n * did save.\n *\n * ## The name is an override\n *\n * The canonical name is shared by every site holding the person, so this\n * card never edits it. What it saves is this holder's own name for them,\n * and the helper says what a blank falls back to, so nobody clears the\n * field expecting the record to go nameless.\n *\n * ## Company is a record, with its name kept beside it\n *\n * The Company field is the picker (AGL-2613): the link is `companyId` in\n * this holder's facet, mirrored into the top-level `companyIds` for the\n * company page's query, and the company's contacts count moves with it —\n * all planned by the route from the stored document, so this card never\n * reasons about another holder's link. The name is sent too, from the picked\n * company, because the list column and the global search read the name and\n * not the id; a record that carries a name with no link — an import, a save\n * from before the picker — keeps it as the label, and the picker offers it\n * as the company to link or create.\n */\nexport function ContactPropertiesCard(props: ContactPropertiesCardProps) {\n  const {\n    hostId,\n    org,\n    record,\n    consentGroup,\n    seed,\n    members,\n    suiteLocked = false,\n  } = props\n  const { data: user } = useUser()\n  const { enqueueSnackbar } = useSnackbar()\n  const contactUpdate = useContactUpdate(hostId)\n  // The site a stage move is routed through: the mounted one, or at the\n  // organization level the holder's own (AGL-2630).\n  const siteHostId = hostId ?? (consentGroup.hostId || null)\n  /*\n   * The feed the act is logged in, decided by the level it was performed\n   * at (AGL-2738) and so given the MOUNTED site rather than `siteHostId`:\n   * at the org hub a client-direct append to the holder's own site would\n   * face a gate the record write never had to pass.\n   */\n  const logActivity = useCrmActivityLogger(hostId)\n  const companies = useCompanyOptions({ hostId, org })\n  const createCompany = useCreateCompany({ hostId, org })\n\n  const [nameOverride, setNameOverride] = useState(record.nameOverride)\n  const [phone, setPhone] = useState(record.phone)\n  const [jobTitle, setJobTitle] = useState(record.jobTitle)\n  const [companyName, setCompanyName] = useState(record.companyName)\n  const [companyId, setCompanyId] = useState<string | null>(\n    record.companyId || null,\n  )\n  const [ownerUid, setOwnerUid] = useState(record.ownerUid)\n  const [lifecycleStage, setLifecycleStage] = useState<ContactLifecycleStage | ''>(\n    record.lifecycleStage,\n  )\n  const [tags, setTags] = useState(record.tags.join(', '))\n  const [notes, setNotes] = useState(record.notes)\n  const [address, setAddress] = useState<AddressDraft>(\n    addressDraftFrom(record.address),\n  )\n  const [phoneError, setPhoneError] = useState('')\n  const [saving, setSaving] = useState(false)\n\n  /*\n   * Re-seeded when the RECORD changes, not when it re-renders. The listener\n   * delivers a fresh row on every snapshot, including the one this card's\n   * own save produces; re-seeding on each would overwrite what somebody is\n   * in the middle of typing with what the server last confirmed.\n   */\n  const recordId = record.$id\n  useEffect(() => {\n    setNameOverride(record.nameOverride)\n    setPhone(record.phone)\n    setJobTitle(record.jobTitle)\n    setCompanyName(record.companyName)\n    setCompanyId(record.companyId || null)\n    setOwnerUid(record.ownerUid)\n    setLifecycleStage(record.lifecycleStage)\n    setTags(record.tags.join(', '))\n    setNotes(record.notes)\n    setAddress(addressDraftFrom(record.address))\n    setPhoneError('')\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [recordId])\n\n  const handleSave = useCallback(async () => {\n    const trimmedPhone = phone.trim()\n    const normalizedPhone = trimmedPhone ? normalizePhone(trimmedPhone) : ''\n    if (trimmedPhone && !normalizedPhone) {\n      setPhoneError('Enter it with its country code, like +1 512 555 0107.')\n      return\n    }\n    setPhoneError('')\n    // A stage that differs from the record's is the stage route's to write —\n    // see the note above.\n    const stageChanged = !suiteLocked && lifecycleStage !== record.lifecycleStage\n    const set: ContactUpdateFields = {\n      name: nameOverride.trim().slice(0, 120),\n      phone: normalizedPhone ?? '',\n      jobTitle: jobTitle.trim().slice(0, 120),\n      address,\n      tags: parseContactTags(tags),\n      notes: notes.slice(0, 2000),\n      // The owner and the company, sent only on a plan that carries the CRM.\n      ...(suiteLocked\n        ? {}\n        : { ownerUid, companyId, companyName: companyName.trim().slice(0, 120) }),\n    }\n    setSaving(true)\n    try {\n      const verdict = await writeGuardedBySeed(\n        {\n          subject: 'contact',\n          unreadable: seed.status === 'error',\n          fromCache: seed.fromCache,\n        },\n        () => contactUpdate.updateOne(record.$id, set),\n      )\n      if (!verdict.ok) {\n        return void enqueueSnackbar(verdict.message, {\n          variant: 'warning',\n          persist: false,\n        })\n      }\n      logActivity('Updated contact', {\n        type: 'contact',\n        id: record.$id,\n        name: record.name || record.email,\n      })\n      if (stageChanged && siteHostId) {\n        try {\n          await setContactStage(user, siteHostId, record.$id, lifecycleStage || null)\n        } catch (error) {\n          // The rest of the profile is saved; only the stage was refused, and\n          // the route's own sentence says why.\n          return void enqueueSnackbar(\n            `Saved, but the stage could not be changed: ${\n              error instanceof Error ? error.message : 'the request failed'\n            }`,\n            { variant: 'warning', persist: false },\n          )\n        }\n      }\n      enqueueSnackbar('Contact saved', { variant: 'success', persist: false })\n    } catch (error) {\n      console.error(error)\n      enqueueSnackbar(\n        error instanceof Error && error.message ? error.message : 'An error has occurred',\n        { variant: 'error', allowDuplicate: true },\n      )\n    } finally {\n      setSaving(false)\n    }\n  }, [\n    address,\n    companyId,\n    companyName,\n    contactUpdate,\n    enqueueSnackbar,\n    siteHostId,\n    jobTitle,\n    lifecycleStage,\n    logActivity,\n    nameOverride,\n    notes,\n    ownerUid,\n    phone,\n    record.$id,\n    record.email,\n    record.lifecycleStage,\n    record.name,\n    seed.fromCache,\n    seed.status,\n    suiteLocked,\n    tags,\n    user,\n  ])\n\n  /*\n   * An owner the roster no longer lists — somebody who left the team — is\n   * still offered as the current value, named by their uid, so the select is\n   * never handed a value it has no option for and the reader can see who it\n   * was before reassigning.\n   */\n  const ownerKnown = members.options.some((option) => option.uid === ownerUid)\n\n  /** The number in the box as something a dialer takes, or nothing (AGL-2661). */\n  const telHref = crmTelHref(phone)\n\n  return (\n    <CardDisplay\n      header={'Properties'}\n      help={Aglyn.pluginDocsHelp('contactRecord', { anchor: '#the-record-page' })}\n      contentGutterX\n      contentGutterY\n      HeaderProps={{\n        action: (\n          <Button\n            variant=\"contained\"\n            color=\"primary\"\n            size=\"small\"\n            disabled={saving}\n            onClick={() => void handleSave()}\n          >\n            {saving ? 'Saving…' : 'Save'}\n          </Button>\n        ),\n      }}\n    >\n      <Grid container spacing={2}>\n        <Grid size={{ xs: 12, sm: 6 }}>\n          <TextField\n            size=\"small\"\n            label=\"Email\"\n            value={record.email}\n            slotProps={{ input: { readOnly: true } }}\n            helperText=\"The identity every site shares — it cannot be edited here.\"\n            fullWidth\n          />\n        </Grid>\n        <Grid size={{ xs: 12, sm: 6 }}>\n          <TextField\n            size=\"small\"\n            label=\"Name\"\n            value={nameOverride}\n            onChange={(event) => setNameOverride(event.target.value)}\n            slotProps={{ htmlInput: { maxLength: 120 } }}\n            helperText={\n              record.canonicalName\n                ? `Your own name for this person. Blank shows the name they gave: ${record.canonicalName}.`\n                : 'Your own name for this person.'\n            }\n            fullWidth\n          />\n        </Grid>\n        <Grid size={{ xs: 12, sm: 6 }}>\n          <TextField\n            size=\"small\"\n            label=\"Phone\"\n            value={phone}\n            onChange={(event) => setPhone(event.target.value)}\n            error={Boolean(phoneError)}\n            helperText={phoneError || 'With the country code, like +1 512 555 0107'}\n            fullWidth\n            slotProps={{\n              input: {\n                /*\n                 * Click-to-call (AGL-2661), off what is IN the box rather\n                 * than off the saved value: the number on screen is the one\n                 * a reader means to ring, and `crmTelHref` withholds the\n                 * link from anything half-typed.\n                 */\n                endAdornment: telHref ? (\n                  <InputAdornment position=\"end\">\n                    <Tooltip title={`Call ${phone.trim()}`}>\n                      <IconButton\n                        component=\"a\"\n                        href={telHref}\n                        size=\"small\"\n                        edge=\"end\"\n                        aria-label={`Call ${phone.trim()}`}\n                      >\n                        <MdiIcon path={mdiPhoneOutline.path} size={0.8} />\n                      </IconButton>\n                    </Tooltip>\n                  </InputAdornment>\n                ) : null,\n              },\n            }}\n          />\n        </Grid>\n        <Grid size={{ xs: 12, sm: 6 }}>\n          <TextField\n            size=\"small\"\n            label=\"Job title\"\n            value={jobTitle}\n            onChange={(event) => setJobTitle(event.target.value)}\n            slotProps={{ htmlInput: { maxLength: 120 } }}\n            fullWidth\n          />\n        </Grid>\n        <Grid size={{ xs: 12, sm: 6 }}>\n          <CompanyPicker\n            options={companies.options}\n            ready={companies.ready}\n            truncated={companies.truncated}\n            value={companyId}\n            onChange={(id, company) => {\n              setCompanyId(id)\n              // The label follows the link: the picked name, or nothing\n              // once the link is cleared. A company the list cannot name\n              // keeps whatever label the record already had.\n              setCompanyName(company ? company.name : id ? companyName : '')\n            }}\n            onCreate={createCompany}\n            email={record.email}\n            fallbackName={companyName}\n            disabled={saving || suiteLocked}\n            helperText={suiteLocked ? crmSuiteLockedReason() : undefined}\n          />\n        </Grid>\n        <Grid size={{ xs: 12, sm: 6 }}>\n          <TextField\n            select\n            size=\"small\"\n            label=\"Lifecycle stage\"\n            value={lifecycleStage}\n            onChange={(event) =>\n              setLifecycleStage(event.target.value as ContactLifecycleStage | '')\n            }\n            disabled={suiteLocked}\n            helperText={suiteLocked ? crmSuiteLockedReason() : undefined}\n            fullWidth\n          >\n            <MenuItem value=\"\">{'Not placed yet'}</MenuItem>\n            {CONTACT_LIFECYCLE_STAGES.map((stage) => (\n              <MenuItem key={stage} value={stage}>\n                {CONTACT_LIFECYCLE_STAGE_LABELS[stage]}\n              </MenuItem>\n            ))}\n          </TextField>\n        </Grid>\n        <Grid size={{ xs: 12, sm: 6 }}>\n          <TextField\n            select\n            size=\"small\"\n            label=\"Owner\"\n            value={ownerUid}\n            onChange={(event) => setOwnerUid(event.target.value)}\n            disabled={suiteLocked}\n            helperText={\n              suiteLocked\n                ? crmSuiteLockedReason()\n                : members.ready && !members.options.length\n                  ? 'The team roster could not be read, so nobody can be picked yet.'\n                  : 'The team member responsible for this relationship'\n            }\n            fullWidth\n          >\n            <MenuItem value=\"\">{'Unassigned'}</MenuItem>\n            {ownerUid && !ownerKnown ? (\n              <MenuItem value={ownerUid}>{members.memberName(ownerUid)}</MenuItem>\n            ) : null}\n            {members.options.map((owner) => (\n              <MenuItem key={owner.uid} value={owner.uid}>\n                {owner.label}\n              </MenuItem>\n            ))}\n          </TextField>\n        </Grid>\n        <Grid size={{ xs: 12, sm: 6 }}>\n          <TextField\n            size=\"small\"\n            label=\"Tags\"\n            placeholder=\"vip, beta\"\n            helperText=\"Comma-separated\"\n            value={tags}\n            onChange={(event) => setTags(event.target.value)}\n            fullWidth\n          />\n        </Grid>\n        <Grid size={{ xs: 12 }}>\n          <Stack spacing={1}>\n            <Typography variant=\"subtitle2\">{'Address'}</Typography>\n            <ContactAddressFields value={address} onChange={setAddress} />\n          </Stack>\n        </Grid>\n        <Grid size={{ xs: 12 }}>\n          <TextField\n            size=\"small\"\n            label=\"About\"\n            value={notes}\n            onChange={(event) => setNotes(event.target.value)}\n            helperText=\"Notes for your team. Nobody outside this site's group can read them.\"\n            multiline\n            minRows={3}\n            fullWidth\n          />\n        </Grid>\n      </Grid>\n    </CardDisplay>\n  )\n}\nContactPropertiesCard.displayName = 'ContactPropertiesCard'\n\nexport default ContactPropertiesCard\n"],"names":["Aglyn","CONTACT_LIFECYCLE_STAGE_LABELS","CONTACT_LIFECYCLE_STAGES","crmTelHref","normalizePhone","mdiPhoneOutline","CardDisplay","MdiIcon","useSnackbar","useUser","writeGuardedBySeed","Button","Grid","IconButton","InputAdornment","MenuItem","Stack","TextField","Tooltip","Typography","useCallback","useEffect","useState","useContactUpdate","useCrmActivityLogger","parseContactTags","setContactStage","CompanyPicker","useCompanyOptions","useCreateCompany","addressDraftFrom","ContactAddressFields","crmSuiteLockedReason","ContactPropertiesCard","props","hostId","org","record","consentGroup","seed","members","suiteLocked","data","user","enqueueSnackbar","contactUpdate","siteHostId","logActivity","companies","createCompany","nameOverride","setNameOverride","phone","setPhone","jobTitle","setJobTitle","companyName","setCompanyName","companyId","setCompanyId","ownerUid","setOwnerUid","lifecycleStage","setLifecycleStage","tags","setTags","join","notes","setNotes","address","setAddress","phoneError","setPhoneError","saving","setSaving","recordId","$id","handleSave","trimmedPhone","trim","normalizedPhone","stageChanged","set","name","slice","verdict","subject","unreadable","status","fromCache","updateOne","ok","message","variant","persist","type","id","email","error","Error","console","allowDuplicate","ownerKnown","options","some","option","uid","telHref","header","help","pluginDocsHelp","anchor","contentGutterX","contentGutterY","HeaderProps","action","color","size","disabled","onClick","container","spacing","xs","sm","label","value","slotProps","input","readOnly","helperText","fullWidth","onChange","event","target","htmlInput","maxLength","canonicalName","Boolean","endAdornment","position","title","component","href","edge","aria-label","path","ready","truncated","company","onCreate","fallbackName","undefined","select","map","stage","length","memberName","owner","placeholder","multiline","minRows","displayName"],"mappings":"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"}

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

@@ -0,0 +1,68 @@
+import type { ContactCampaignEmail } from '@aglyn/aglyn';
+import { type CrmOrg } from './activity-queries';
+export interface ContactTimelineCardProps {
+    /** The site the record is read under, or `null` at the organization level. */
+    hostId: string | null;
+    org: CrmOrg;
+    contactId: string;
+    /**
+     * The RAW contact document, as the page's listener hands it back. The card
+     * resolves the viewing group and reads that group's facet itself, so a
+     * page cannot hand it another holder's timeline by flattening the row
+     * through the wrong group.
+     */
+    contact: Record<string, unknown> | null | undefined;
+    /**
+     * Where a campaign entry links to — the email's report — or `null` for
+     * one the page cannot address. Handed in rather than built here because
+     * the report lives on another surface whose path is the MOUNT's to know:
+     * a site's record page reaches its own Emails hub, an org-level mount
+     * holds the org's site list and can reach every site's. No builder means
+     * no links, never a guessed one.
+     */
+    campaignHref?: (email: ContactCampaignEmail) => string | null;
+    /**
+     * The org's plan lacks the CRM (AGL-2788), which the shell mounts no CRM
+     * page for (AGL-2851). The history still draws; logging an activity stands
+     * locked, and one already logged cannot be edited.
+     */
+    suiteLocked?: boolean;
+}
+/**
+ * A person's whole history in one newest-first stream (AGL-2600): what the
+ * platform CAPTURED — a form, an order, a booking, a sign-up — what a person
+ * LOGGED beside it — a call, an email, a meeting, a note — and, since
+ * AGL-2616, the campaign mail the platform SENT them and what became of it.
+ *
+ * ## Why one stream
+ *
+ * The histories answer one question, "what has happened with this person",
+ * and a page showing them as separate lists asks the reader to interleave
+ * them by eye. The merge is `mergeContactTimeline`, pure and specced: newest
+ * first, stable at a tie, an undated entry last, a campaign at the instant
+ * it was sent.
+ *
+ * Each entry says which it is. A captured entry carries the door's label and
+ * a "Captured" chip and offers no controls; a logged entry carries its kind
+ * and a "Logged" chip, and its author may edit or delete it; a campaign
+ * entry carries "Campaign" and "Sent", links to the email's report, and is
+ * nobody's to edit.
+ *
+ * ## What is read
+ *
+ * The captured side comes off the contact document the page already holds
+ * — THIS group's facet, filtered to the sites the group may see, the same
+ * projection the contacts list makes — and costs no read. The logged side is
+ * the bounded listener every activity surface uses, filtered to this
+ * contact, with a foot for the next hundred. The campaign side is one
+ * request to `crm/contact-email-history`, which reads down this person's
+ * own delivery log, capped, and never a campaign's recipients. The facet's
+ * history is capped at fifty by the platform, so past the window the stream
+ * is the logged side alone; the foot says as much by asking for "more
+ * activity" rather than "more history".
+ */
+export declare function ContactTimelineCard(props: ContactTimelineCardProps): import("react").JSX.Element;
+export declare namespace ContactTimelineCard {
+    var displayName: string;
+}
+export default ContactTimelineCard;