@aglyn/plugins-crm 1.0.0-beta.143

package/src/lib/components/contact-custom-fields-card.js

@@ -0,0 +1,204 @@
+/**
+ * @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 * as Aglyn from "@aglyn/aglyn";
+import { pluginDocsHelp } from "@aglyn/aglyn";
+import { AppLink, CardDisplay } from "@aglyn/shared-ui-jsx";
+import EmptyStateComponent from "@aglyn/shared-ui-jsx/components/empty-state.component";
+import { useSnackbar } from "@aglyn/shared-ui-snackstack";
+import { useFirestore, useFirestoreDoc, writeGuardedBySeed } from "@aglyn/tenant-feature-instance";
+import { Button, Stack, Typography } from "@mui/material";
+import { doc } from "firebase/firestore";
+import { useCallback, useMemo, useState } from "react";
+import { useContactFieldDefinitions } from "../hooks/use-contact-field-definitions.js";
+import { useContactUpdate } from "../hooks/use-contact-update.js";
+import { useCrmScope } from "../hooks/use-crm-scope.js";
+import { contactPrimaryGroup } from "../model/contact-record.js";
+import { crmCustomDraftChanges, crmCustomDraftMissingRequired, crmCustomDraftValue } from "../model/crm-custom-draft.js";
+import { crmRoutes } from "../model/crm-routes.js";
+import { CrmCustomFieldControl } from "./crm-custom-field-control.js";
+/**
+ * The custom fields on one contact, as THIS holder's values (AGL-2601).
+ *
+ * Every active definition draws the control its type calls for, seeded
+ * from the viewing group's facet — `facets.{group}.custom.{key}` — and
+ * never from another holder's, because a value is one business's knowledge
+ * of a person.
+ *
+ * Save sends ONLY the keys that changed to `crm/contact-update` (AGL-2804):
+ * the values are the holder's facet, which the server writes, judging each
+ * against its definition and writing it at its own dotted path — a nested
+ * `custom` object would replace the map and take every key this card did
+ * not touch out with it — and refusing a plan without the CRM. A
+ * refusal is shown in the route's own words, with the draft kept.
+ *
+ * A cleared control sends `null`, the explicit "cleared" the model keeps the
+ * key present with, rather than deleting the field: a `where` on the key can
+ * still find the contact, and an export still shows the column.
+ */ export function ContactCustomFieldsCard(props) {
+    var _ref, _ownRead_data;
+    const { hostId, org, contactId, contact, basePath } = props;
+    const firestore = useFirestore();
+    const { enqueueSnackbar } = useSnackbar();
+    const contactUpdate = useContactUpdate(hostId != null ? hostId : null);
+    const { scope, consentGroup: viewingGroup } = useCrmScope({
+        hostId,
+        org
+    });
+    const orgId = (_ref = scope == null ? void 0 : scope[1]) != null ? _ref : null;
+    const { active, ready } = useContactFieldDefinitions(orgId);
+    // The record, read here only when the page did not hand one over.
+    const ownRead = useFirestoreDoc(()=>contact === undefined && scope ? doc(firestore, scope[0], scope[1], 'contacts', contactId) : null, [
+        firestore,
+        scope,
+        contactId,
+        contact === undefined
+    ]);
+    const record = contact === undefined ? (_ownRead_data = ownRead.data) != null ? _ownRead_data : null : contact;
+    // The facet the values live on: the viewing group's under a site, the
+    // person's own primary holder's at the organization level (AGL-2630).
+    const consentGroup = useMemo(()=>viewingGroup != null ? viewingGroup : contactPrimaryGroup(record, org), [
+        viewingGroup,
+        record,
+        org
+    ]);
+    const stored = useMemo(()=>{
+        var _Aglyn_readContactFacet_custom;
+        return (_Aglyn_readContactFacet_custom = Aglyn.readContactFacet(record, consentGroup.groupId).custom) != null ? _Aglyn_readContactFacet_custom : {};
+    }, [
+        record,
+        consentGroup.groupId
+    ]);
+    /** Only the keys the reader touched; everything else reads from `stored` — see `crm-custom-draft`. */ const [draft, setDraft] = useState({});
+    const [saving, setSaving] = useState(false);
+    const setValue = useCallback((key, value)=>{
+        setDraft((current)=>_extends({}, current, {
+                [key]: value
+            }));
+    }, []);
+    /** The keys whose draft differs from what is stored — what Save sends. */ const changed = useMemo(()=>crmCustomDraftChanges(stored, draft), [
+        draft,
+        stored
+    ]);
+    const clearingRequired = crmCustomDraftMissingRequired(active, stored, draft, 'edit').length > 0;
+    const handleSave = useCallback(async ()=>{
+        if (!scope || !changed.length || clearingRequired) return;
+        setSaving(true);
+        try {
+            const verdict = await writeGuardedBySeed({
+                subject: 'contact',
+                unreadable: contact === undefined && ownRead.status === 'error',
+                fromCache: contact === undefined && ownRead.fromCache
+            }, ()=>contactUpdate.updateOne(contactId, {
+                    custom: Object.fromEntries(changed)
+                }));
+            if (!verdict.ok) {
+                return void enqueueSnackbar(verdict.message, {
+                    variant: 'warning',
+                    persist: false
+                });
+            }
+            setDraft({});
+            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);
+        }
+    }, [
+        scope,
+        changed,
+        clearingRequired,
+        contact,
+        ownRead.status,
+        ownRead.fromCache,
+        contactUpdate,
+        contactId,
+        enqueueSnackbar
+    ]);
+    return /*#__PURE__*/ _jsx(CardDisplay, {
+        header: 'Custom fields',
+        help: pluginDocsHelp('contactFields', {
+            anchor: '#where-values-show'
+        }),
+        contentGutterX: true,
+        contentGutterY: true,
+        children: /*#__PURE__*/ _jsx(Stack, {
+            spacing: 2,
+            children: !ready ? null : active.length === 0 ? /*#__PURE__*/ _jsx(EmptyStateComponent, {
+                compact: true,
+                label: 'No custom fields yet',
+                description: 'A field defined under Fields is kept on every contact and shows here.',
+                action: basePath ? /*#__PURE__*/ _jsx(Button, _extends({
+                    component: AppLink
+                }, {
+                    componentVariant: 'naked',
+                    nativeButton: false
+                }, {
+                    href: crmRoutes(basePath).section('fields'),
+                    size: "small",
+                    variant: "contained",
+                    color: "primary",
+                    children: 'New field'
+                })) : undefined
+            }) : /*#__PURE__*/ _jsxs(_Fragment, {
+                children: [
+                    active.map((definition)=>/*#__PURE__*/ _jsx(CrmCustomFieldControl, {
+                            definition: definition,
+                            value: crmCustomDraftValue(stored, draft, definition.key),
+                            onChange: (value)=>setValue(definition.key, value)
+                        }, definition.$id)),
+                    clearingRequired ? /*#__PURE__*/ _jsx(Typography, {
+                        variant: "caption",
+                        color: "error",
+                        children: 'A required field cannot be left empty.'
+                    }) : null,
+                    /*#__PURE__*/ _jsxs(Stack, {
+                        direction: "row",
+                        spacing: 1,
+                        children: [
+                            /*#__PURE__*/ _jsx(Button, {
+                                variant: "contained",
+                                color: "primary",
+                                disabled: !changed.length || clearingRequired || saving || !scope,
+                                onClick: handleSave,
+                                children: 'Save'
+                            }),
+                            changed.length ? /*#__PURE__*/ _jsx(Button, {
+                                onClick: ()=>setDraft({}),
+                                disabled: saving,
+                                children: 'Discard'
+                            }) : null
+                        ]
+                    })
+                ]
+            })
+        })
+    });
+}
+ContactCustomFieldsCard.displayName = 'ContactCustomFieldsCard';
+export default ContactCustomFieldsCard;
+
+//# sourceMappingURL=contact-custom-fields-card.js.map

package/src/lib/components/contact-custom-fields-card.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/crm/src/lib/components/contact-custom-fields-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 { type ConsolePluginPageProps, type ContactCustomValue, pluginDocsHelp } from '@aglyn/aglyn'\nimport { AppLink, CardDisplay } from '@aglyn/shared-ui-jsx'\nimport EmptyStateComponent from '@aglyn/shared-ui-jsx/components/empty-state.component'\nimport { useSnackbar } from '@aglyn/shared-ui-snackstack'\nimport {\n  useFirestore,\n  useFirestoreDoc,\n  writeGuardedBySeed,\n} from '@aglyn/tenant-feature-instance'\nimport { Button, Stack, Typography } from '@mui/material'\nimport { doc } from 'firebase/firestore'\nimport { useCallback, useMemo, useState } from 'react'\nimport { useContactFieldDefinitions } from '../hooks/use-contact-field-definitions'\nimport { useContactUpdate } from '../hooks/use-contact-update'\nimport { useCrmScope } from '../hooks/use-crm-scope'\nimport { contactPrimaryGroup } from '../model/contact-record'\nimport {\n  type CrmCustomDraft,\n  crmCustomDraftChanges,\n  crmCustomDraftMissingRequired,\n  crmCustomDraftValue,\n} from '../model/crm-custom-draft'\nimport { crmRoutes } from '../model/crm-routes'\nimport { CrmCustomFieldControl } from './crm-custom-field-control'\n\nexport interface ContactCustomFieldsCardProps\n  extends Pick<ConsolePluginPageProps, 'hostId' | 'org'> {\n  contactId: string\n  /** The CRM surface's own path, for the link to the Fields section. */\n  basePath?: string\n  /**\n   * The contact document, facets and all, when the page already holds it.\n   *\n   * Omit it and the card reads the document once itself — the shape the\n   * record stub mounts it in. A page that passes it pays no second read,\n   * and owns the seed discipline for it: the card's own guard covers only\n   * the read the card made.\n   */\n  contact?: Record<string, unknown> | null\n}\n\n/**\n * The custom fields on one contact, as THIS holder's values (AGL-2601).\n *\n * Every active definition draws the control its type calls for, seeded\n * from the viewing group's facet — `facets.{group}.custom.{key}` — and\n * never from another holder's, because a value is one business's knowledge\n * of a person.\n *\n * Save sends ONLY the keys that changed to `crm/contact-update` (AGL-2804):\n * the values are the holder's facet, which the server writes, judging each\n * against its definition and writing it at its own dotted path — a nested\n * `custom` object would replace the map and take every key this card did\n * not touch out with it — and refusing a plan without the CRM. A\n * refusal is shown in the route's own words, with the draft kept.\n *\n * A cleared control sends `null`, the explicit \"cleared\" the model keeps the\n * key present with, rather than deleting the field: a `where` on the key can\n * still find the contact, and an export still shows the column.\n */\nexport function ContactCustomFieldsCard(props: ContactCustomFieldsCardProps) {\n  const { hostId, org, contactId, contact, basePath } = props\n  const firestore = useFirestore()\n  const { enqueueSnackbar } = useSnackbar()\n  const contactUpdate = useContactUpdate(hostId ?? null)\n  const { scope, consentGroup: viewingGroup } = useCrmScope({ hostId, org })\n  const orgId = scope?.[1] ?? null\n  const { active, ready } = useContactFieldDefinitions(orgId)\n\n  // The record, read here only when the page did not hand one over.\n  const ownRead = useFirestoreDoc<Record<string, unknown>>(\n    () =>\n      contact === undefined && scope\n        ? doc(firestore, scope[0], scope[1], 'contacts', contactId)\n        : null,\n    [firestore, scope, contactId, contact === undefined],\n  )\n  const record = contact === undefined ? (ownRead.data ?? null) : contact\n  // The facet the values live on: the viewing group's under a site, the\n  // person's own primary holder's at the organization level (AGL-2630).\n  const consentGroup = useMemo(\n    () => viewingGroup ?? contactPrimaryGroup(record, org as Record<string, unknown>),\n    [viewingGroup, record, org],\n  )\n  const stored = useMemo(\n    () => Aglyn.readContactFacet(record, consentGroup.groupId).custom ?? {},\n    [record, consentGroup.groupId],\n  )\n\n  /** Only the keys the reader touched; everything else reads from `stored` — see `crm-custom-draft`. */\n  const [draft, setDraft] = useState<CrmCustomDraft>({})\n  const [saving, setSaving] = useState(false)\n  const setValue = useCallback((key: string, value: ContactCustomValue) => {\n    setDraft((current) => ({ ...current, [key]: value }))\n  }, [])\n\n  /** The keys whose draft differs from what is stored — what Save sends. */\n  const changed = useMemo(() => crmCustomDraftChanges(stored, draft), [draft, stored])\n  const clearingRequired =\n    crmCustomDraftMissingRequired(active, stored, draft, 'edit').length > 0\n\n  const handleSave = useCallback(async () => {\n    if (!scope || !changed.length || clearingRequired) return\n    setSaving(true)\n    try {\n      const verdict = await writeGuardedBySeed(\n        {\n          subject: 'contact',\n          unreadable: contact === undefined && ownRead.status === 'error',\n          fromCache: contact === undefined && ownRead.fromCache,\n        },\n        () => contactUpdate.updateOne(contactId, { custom: Object.fromEntries(changed) }),\n      )\n      if (!verdict.ok) {\n        return void enqueueSnackbar(verdict.message, { variant: 'warning', persist: false })\n      }\n      setDraft({})\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    scope,\n    changed,\n    clearingRequired,\n    contact,\n    ownRead.status,\n    ownRead.fromCache,\n    contactUpdate,\n    contactId,\n    enqueueSnackbar,\n  ])\n\n  return (\n    <CardDisplay\n      header={'Custom fields'}\n      help={pluginDocsHelp('contactFields', { anchor: '#where-values-show' })}\n      contentGutterX\n      contentGutterY\n    >\n      <Stack spacing={2}>\n        {!ready ? null : active.length === 0 ? (\n          <EmptyStateComponent\n            compact\n            label={'No custom fields yet'}\n            description={'A field defined under Fields is kept on every contact and shows here.'}\n            action={\n              basePath ? (\n                <Button\n                  component={AppLink as any}\n                  {...({ componentVariant: 'naked', nativeButton: false } as any)}\n                  href={crmRoutes(basePath).section('fields')}\n                  size=\"small\"\n                  variant=\"contained\"\n                  color=\"primary\"\n                >\n                  {'New field'}\n                </Button>\n              ) : undefined\n            }\n          />\n        ) : (\n          <>\n            {active.map((definition) => (\n              <CrmCustomFieldControl\n                key={definition.$id}\n                definition={definition}\n                value={crmCustomDraftValue(stored, draft, definition.key)}\n                onChange={(value) => setValue(definition.key, value)}\n              />\n            ))}\n            {clearingRequired ? (\n              <Typography variant=\"caption\" color=\"error\">\n                {'A required field cannot be left empty.'}\n              </Typography>\n            ) : null}\n            <Stack direction=\"row\" spacing={1}>\n              <Button\n                variant=\"contained\"\n                color=\"primary\"\n                disabled={!changed.length || clearingRequired || saving || !scope}\n                onClick={handleSave}\n              >\n                {'Save'}\n              </Button>\n              {changed.length ? (\n                <Button onClick={() => setDraft({})} disabled={saving}>\n                  {'Discard'}\n                </Button>\n              ) : null}\n            </Stack>\n          </>\n        )}\n      </Stack>\n    </CardDisplay>\n  )\n}\nContactCustomFieldsCard.displayName = 'ContactCustomFieldsCard'\n\nexport default ContactCustomFieldsCard\n"],"names":["Aglyn","pluginDocsHelp","AppLink","CardDisplay","EmptyStateComponent","useSnackbar","useFirestore","useFirestoreDoc","writeGuardedBySeed","Button","Stack","Typography","doc","useCallback","useMemo","useState","useContactFieldDefinitions","useContactUpdate","useCrmScope","contactPrimaryGroup","crmCustomDraftChanges","crmCustomDraftMissingRequired","crmCustomDraftValue","crmRoutes","CrmCustomFieldControl","ContactCustomFieldsCard","props","ownRead","hostId","org","contactId","contact","basePath","firestore","enqueueSnackbar","contactUpdate","scope","consentGroup","viewingGroup","orgId","active","ready","undefined","record","data","stored","readContactFacet","groupId","custom","draft","setDraft","saving","setSaving","setValue","key","value","current","changed","clearingRequired","length","handleSave","verdict","subject","unreadable","status","fromCache","updateOne","Object","fromEntries","ok","message","variant","persist","error","console","Error","allowDuplicate","header","help","anchor","contentGutterX","contentGutterY","spacing","compact","label","description","action","component","componentVariant","nativeButton","href","section","size","color","map","definition","onChange","$id","direction","disabled","onClick","displayName"],"mappings":"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"}

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

@@ -0,0 +1,20 @@
+import type { CrmOrgDoc } from '../hooks/use-crm-scope';
+export interface ContactDealsCardProps {
+    /** The site the record is read under, or `null` at the organization level. */
+    hostId: string | null;
+    org: CrmOrgDoc;
+    basePath: string;
+    contactId: string;
+    /** The name the drawer preselects with; the id is the link either way. */
+    contactName?: string;
+}
+/**
+ * The deals a contact is party to, on the contact's page (AGL-2598) —
+ * `orgs/{orgId}/deals` where `contactId ==` this person, with a "New deal"
+ * that starts one already linked to them.
+ */
+export declare function ContactDealsCard(props: ContactDealsCardProps): import("react").JSX.Element;
+export declare namespace ContactDealsCard {
+    var displayName: string;
+}
+export default ContactDealsCard;

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

@@ -0,0 +1,38 @@
+/**
+ * @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 { jsx as _jsx } from "react/jsx-runtime";
+import { LinkedDealsCard } from "./linked-deals-card.js";
+/**
+ * The deals a contact is party to, on the contact's page (AGL-2598) —
+ * `orgs/{orgId}/deals` where `contactId ==` this person, with a "New deal"
+ * that starts one already linked to them.
+ */ export function ContactDealsCard(props) {
+    const { hostId, org, basePath, contactId, contactName } = props;
+    return /*#__PURE__*/ _jsx(LinkedDealsCard, {
+        hostId: hostId,
+        org: org,
+        basePath: basePath,
+        link: {
+            contactId,
+            contactName
+        }
+    });
+}
+ContactDealsCard.displayName = 'ContactDealsCard';
+export default ContactDealsCard;
+
+//# sourceMappingURL=contact-deals-card.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/crm/src/lib/components/contact-deals-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 type { CrmOrgDoc } from '../hooks/use-crm-scope'\nimport { LinkedDealsCard } from './linked-deals-card'\n\nexport interface ContactDealsCardProps {\n  /** The site the record is read under, or `null` at the organization level. */\n  hostId: string | null\n  org: CrmOrgDoc\n  basePath: string\n  contactId: string\n  /** The name the drawer preselects with; the id is the link either way. */\n  contactName?: string\n}\n\n/**\n * The deals a contact is party to, on the contact's page (AGL-2598) —\n * `orgs/{orgId}/deals` where `contactId ==` this person, with a \"New deal\"\n * that starts one already linked to them.\n */\nexport function ContactDealsCard(props: ContactDealsCardProps) {\n  const { hostId, org, basePath, contactId, contactName } = props\n  return (\n    <LinkedDealsCard\n      hostId={hostId}\n      org={org}\n      basePath={basePath}\n      link={{ contactId, contactName }}\n    />\n  )\n}\nContactDealsCard.displayName = 'ContactDealsCard'\n\nexport default ContactDealsCard\n"],"names":["LinkedDealsCard","ContactDealsCard","props","hostId","org","basePath","contactId","contactName","link","displayName"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GACD;;AAGA,SAASA,eAAe,QAAQ,yBAAqB;AAYrD;;;;CAIC,GACD,OAAO,SAASC,iBAAiBC,KAA4B;IAC3D,MAAM,EAAEC,MAAM,EAAEC,GAAG,EAAEC,QAAQ,EAAEC,SAAS,EAAEC,WAAW,EAAE,GAAGL;IAC1D,qBACE,KAACF;QACCG,QAAQA;QACRC,KAAKA;QACLC,UAAUA;QACVG,MAAM;YAAEF;YAAWC;QAAY;;AAGrC;AACAN,iBAAiBQ,WAAW,GAAG;AAE/B,eAAeR,iBAAgB"}

package/src/lib/components/contact-detail-page.d.ts

@@ -0,0 +1,46 @@
+import { type CrmDetailPageProps } from '../model/crm-routes';
+/**
+ * `/crm/contacts/{contactId}` — one person (AGL-2596).
+ *
+ * A ROUTE rather than the v1 drawer, because a person is the thing every
+ * other CRM record points at: a deal, a task and an activity all name a
+ * contact, and a link that opens a drawer on top of a list is not a link
+ * anybody can paste.
+ *
+ * ## What this page reads
+ *
+ * ONE document, by id, through the scoped rules — a single-document get is
+ * judged on that document's own `visibleTo`, so no `array-contains-any`
+ * filter is needed here the way it is on the list. The row is then flattened
+ * through the viewing group's facet ONCE (`contactRecordFromDoc`) and the
+ * cards below read the flat record: none of them reaches into
+ * `facets.{groupId}` for itself, which is what keeps a card from ever
+ * showing another holder's notes.
+ *
+ * Beyond the document: the team roster (one request, for the owner picker)
+ * and the site's campaigns (one listen, for the filing picker) — both paid
+ * here because opening a record IS the ask for them, and neither is paid by
+ * the list.
+ *
+ * ## The cards
+ *
+ * Each in its own file, so a card can grow without this page growing:
+ * properties (the editable profile), the relationship (sources, attribution,
+ * consent, campaign filing) and the timeline. Other CRM sections add a card
+ * here by inserting one import and one line.
+ *
+ * ## Delete is a detach
+ *
+ * The row is shared by every site that has captured this person, so the
+ * action in the overflow menu drops THIS group's facet, consent, attribution
+ * and scope tokens, and deletes the document only when nobody else is left
+ * holding it — `planContactDetach` does the counting off `visibleTo`, which
+ * is what both enforcement layers evaluate, and the rules refuse a delete by
+ * a caller who is not the sole holder. Not the erasure path: a privacy
+ * erasure removes the person regardless of who else holds them.
+ */
+export declare function ContactDetailPage(props: CrmDetailPageProps): import("react").JSX.Element;
+export declare namespace ContactDetailPage {
+    var displayName: string;
+}
+export default ContactDetailPage;