@aglyn/plugins-crm 1.0.0-beta.143

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

@@ -0,0 +1,435 @@
+/**
+ * @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, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import * as Aglyn from "@aglyn/aglyn";
+import { CONTACT_SOURCE_LABELS, pluginDocsHelp } from "@aglyn/aglyn";
+import { mdiAccountCircleOutline, mdiAccountEditOutline, mdiAccountPlusOutline, mdiApi, mdiBullhornOutline, mdiCalendarCheckOutline, mdiCartOutline, mdiEmailNewsletter, mdiFileImportOutline, mdiFormSelect } from "@aglyn/shared-data-mdi";
+import { AppLink, CardDisplay, MdiIcon } from "@aglyn/shared-ui-jsx";
+import EmptyStateComponent from "@aglyn/shared-ui-jsx/components/empty-state.component";
+import { Button, Chip, Stack, Tooltip, Typography } from "@mui/material";
+import { useParams } from "next/navigation";
+import { useCallback, useMemo, useState } from "react";
+import { contactPrimaryGroup } from "../model/contact-record.js";
+import { ActivityRow } from "./activity-list.js";
+import { useActivityScope, useActivityWindow, useCanEditActivity } from "./activity-queries.js";
+import { CrmSuiteLockedButton } from "./crm-suite-lock.js";
+import { LogActivityDialog } from "./log-activity-dialog.js";
+import { useContactCampaignEmails } from "./use-contact-campaign-emails.js";
+/**
+ * One glyph per capture door. Typed against the source union so a door added
+ * to it cannot render as the placeholder glyph.
+ */ const SOURCE_ICONS = {
+    form: mdiFormSelect,
+    member: mdiAccountPlusOutline,
+    order: mdiCartOutline,
+    booking: mdiCalendarCheckOutline,
+    newsletter: mdiEmailNewsletter,
+    api: mdiApi,
+    manual: mdiAccountEditOutline,
+    import: mdiFileImportOutline,
+    account: mdiAccountCircleOutline
+};
+/**
+ * One thing the platform recorded: the door it came through, what the door
+ * wrote, when, and the page the person was on.
+ *
+ * Read-only by nature — nobody logged it, so nobody edits it. The entry
+ * point sits beside the timestamp rather than in the summary, the way the
+ * contacts drawer draws it: the summary is the sentence the door wrote, the
+ * path is a fact the door recorded, and a long path on the sentence's line
+ * pushes out the thing the row is about.
+ */ function CapturedRow(props) {
+    var _CONTACT_SOURCE_LABELS_source, _interaction_summary, _Aglyn_INTERACTION_LINK_LABELS_source;
+    const { interaction, nowMs, href } = props;
+    const source = interaction.type;
+    const label = (_CONTACT_SOURCE_LABELS_source = CONTACT_SOURCE_LABELS[source]) != null ? _CONTACT_SOURCE_LABELS_source : String(source);
+    const icon = SOURCE_ICONS[source];
+    const when = new Date(interaction.atMs);
+    return /*#__PURE__*/ _jsxs(Stack, {
+        direction: "row",
+        spacing: 1.5,
+        sx: {
+            alignItems: 'flex-start'
+        },
+        children: [
+            /*#__PURE__*/ _jsx(Stack, {
+                sx: {
+                    color: 'text.secondary',
+                    pt: 0.25,
+                    fontSize: (theme)=>theme.typography.h6.fontSize
+                },
+                children: /*#__PURE__*/ _jsx(MdiIcon, {
+                    path: icon == null ? void 0 : icon.path
+                })
+            }),
+            /*#__PURE__*/ _jsxs(Stack, {
+                spacing: 0.5,
+                sx: {
+                    flex: 1,
+                    minWidth: 0
+                },
+                children: [
+                    /*#__PURE__*/ _jsxs(Stack, {
+                        direction: "row",
+                        spacing: 1,
+                        sx: {
+                            alignItems: 'center',
+                            flexWrap: 'wrap',
+                            rowGap: 0.5
+                        },
+                        children: [
+                            /*#__PURE__*/ _jsx(Chip, {
+                                label: label,
+                                size: "small"
+                            }),
+                            /*#__PURE__*/ _jsx(Chip, {
+                                label: "Captured",
+                                size: "small",
+                                variant: "outlined"
+                            })
+                        ]
+                    }),
+                    /*#__PURE__*/ _jsx(Typography, {
+                        variant: "body2",
+                        children: (_interaction_summary = interaction.summary) != null ? _interaction_summary : label
+                    }),
+                    /*#__PURE__*/ _jsx(Tooltip, {
+                        title: when.toLocaleString(),
+                        children: /*#__PURE__*/ _jsx(Typography, {
+                            variant: "caption",
+                            color: "text.secondary",
+                            sx: {
+                                alignSelf: 'flex-start'
+                            },
+                            children: interaction.path ? `${Aglyn.activityTimeLabel(interaction.atMs, nowMs)} · ${interaction.path}` : Aglyn.activityTimeLabel(interaction.atMs, nowMs)
+                        })
+                    }),
+                    href ? /*#__PURE__*/ _jsx(Typography, {
+                        variant: "caption",
+                        sx: {
+                            alignSelf: 'flex-start'
+                        },
+                        children: /*#__PURE__*/ _jsx(AppLink, {
+                            href: href,
+                            children: (_Aglyn_INTERACTION_LINK_LABELS_source = Aglyn.INTERACTION_LINK_LABELS[source]) != null ? _Aglyn_INTERACTION_LINK_LABELS_source : 'Open'
+                        })
+                    }) : null
+                ]
+            })
+        ]
+    });
+}
+CapturedRow.displayName = 'CapturedRow';
+/**
+ * One campaign email the platform sent this person (AGL-2616): which email,
+ * and what became of it — `sent · delivered · opened ×2 · clicked`.
+ *
+ * Read-only like a captured row, and drawn apart from BOTH the captured and
+ * the logged rows: its glyph is the campaign's, never the envelope a logged
+ * `email` activity carries, and its chips say "Campaign" and "Sent" where
+ * the others say "Captured" and "Logged". The name links to the email's own
+ * report when the page can address it; an email the team has deleted, or
+ * one a sibling site sent, keeps its name and loses the link.
+ */ function CampaignEmailRow(props) {
+    var _ref, _email_campaignName;
+    const { email, href, nowMs } = props;
+    const name = (_ref = (_email_campaignName = email.campaignName) != null ? _email_campaignName : email.subject) != null ? _ref : 'Campaign email';
+    const summary = Aglyn.campaignEmailSummary(email).join(' · ');
+    const when = new Date(email.sentAtMs);
+    return /*#__PURE__*/ _jsxs(Stack, {
+        direction: "row",
+        spacing: 1.5,
+        sx: {
+            alignItems: 'flex-start'
+        },
+        children: [
+            /*#__PURE__*/ _jsx(Stack, {
+                sx: {
+                    color: 'text.secondary',
+                    pt: 0.25,
+                    fontSize: (theme)=>theme.typography.h6.fontSize
+                },
+                children: /*#__PURE__*/ _jsx(MdiIcon, {
+                    path: mdiBullhornOutline.path
+                })
+            }),
+            /*#__PURE__*/ _jsxs(Stack, {
+                spacing: 0.5,
+                sx: {
+                    flex: 1,
+                    minWidth: 0
+                },
+                children: [
+                    /*#__PURE__*/ _jsxs(Stack, {
+                        direction: "row",
+                        spacing: 1,
+                        sx: {
+                            alignItems: 'center',
+                            flexWrap: 'wrap',
+                            rowGap: 0.5
+                        },
+                        children: [
+                            /*#__PURE__*/ _jsx(Chip, {
+                                label: "Campaign",
+                                size: "small"
+                            }),
+                            /*#__PURE__*/ _jsx(Chip, {
+                                label: "Sent",
+                                size: "small",
+                                variant: "outlined"
+                            })
+                        ]
+                    }),
+                    /*#__PURE__*/ _jsxs(Typography, {
+                        variant: "body2",
+                        children: [
+                            href ? /*#__PURE__*/ _jsx(AppLink, {
+                                href: href,
+                                children: name
+                            }) : name,
+                            ` · ${summary}`
+                        ]
+                    }),
+                    /*#__PURE__*/ _jsx(Tooltip, {
+                        title: when.toLocaleString(),
+                        children: /*#__PURE__*/ _jsx(Typography, {
+                            variant: "caption",
+                            color: "text.secondary",
+                            sx: {
+                                alignSelf: 'flex-start'
+                            },
+                            children: email.subject && email.subject !== name ? `${Aglyn.activityTimeLabel(email.sentAtMs, nowMs)} · ${email.subject}` : Aglyn.activityTimeLabel(email.sentAtMs, nowMs)
+                        })
+                    })
+                ]
+            })
+        ]
+    });
+}
+CampaignEmailRow.displayName = 'CampaignEmailRow';
+/**
+ * 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 function ContactTimelineCard(props) {
+    const { hostId, org, contactId, contact, campaignHref, suiteLocked = false } = props;
+    const scope = useActivityScope(hostId, org);
+    /*
+   * THIS holder's captured history, and only the visits this group may see.
+   * A read off the top of the document, or of another group's facet, would
+   * be another business's records — the disclosure the facet shape ended.
+   * At the organization level (AGL-2630) the holder is the person's own
+   * primary one, the group the record page reads the profile through.
+   */ const consentGroup = useMemo(()=>{
+        var _scope_consentGroup;
+        return (_scope_consentGroup = scope.consentGroup) != null ? _scope_consentGroup : contactPrimaryGroup(contact, org != null ? org : null);
+    }, [
+        scope.consentGroup,
+        contact,
+        org
+    ]);
+    const interactions = useMemo(()=>{
+        const facet = Aglyn.readContactFacet(contact, consentGroup.groupId);
+        return Aglyn.interactionsForGroup(facet.interactions, consentGroup.hostIds);
+    }, [
+        contact,
+        consentGroup
+    ]);
+    const link = useMemo(()=>({
+            contactId
+        }), [
+        contactId
+    ]);
+    const activities = useActivityWindow(scope, link);
+    /*
+   * Where a captured entry's record is READ (AGL-2622). The site console's
+   * two route params are already in the URL this page is on, so the link is
+   * built from them rather than from two document reads per timeline. Only
+   * an interaction on THIS site links: a sibling site's order is that
+   * site's record, read on that site's console, and a link built with this
+   * site's segment would 404 or — worse — open the wrong site's row under
+   * the same id. An interaction with no site recorded predates the stamp
+   * and is left unlinked rather than guessed at. Off a site — the org-level
+   * mount — there is no segment to build with, and nothing links.
+   */ const params = useParams();
+    const siteContext = useMemo(()=>(params == null ? void 0 : params.orgSlug) && (params == null ? void 0 : params.host) ? {
+            orgSlug: String(params.orgSlug),
+            host: String(params.host)
+        } : null, [
+        params == null ? void 0 : params.orgSlug,
+        params == null ? void 0 : params.host
+    ]);
+    const interactionHref = useCallback((interaction)=>siteContext && interaction.hostId === hostId ? Aglyn.contactInteractionHref(interaction, siteContext) : null, [
+        siteContext,
+        hostId
+    ]);
+    // The campaign history is asked of a site: the mounted one, or the holder's.
+    const campaigns = useContactCampaignEmails(hostId != null ? hostId : consentGroup.hostId || null, contactId);
+    // One member read for the whole stream, however many rows it has.
+    const canEdit = useCanEditActivity(scope.orgId);
+    const entries = useMemo(()=>Aglyn.mergeContactTimeline(interactions, activities.rows, campaigns.emails), [
+        interactions,
+        activities.rows,
+        campaigns.emails
+    ]);
+    // One clock for every row of one paint, so two rows logged a second apart
+    // cannot read "just now" and "1 min ago" from being rendered across a
+    // minute boundary.
+    const nowMs = Date.now();
+    const [dialogOpen, setDialogOpen] = useState(false);
+    const [editing, setEditing] = useState(null);
+    const openNew = useCallback(()=>{
+        setEditing(null);
+        setDialogOpen(true);
+    }, []);
+    const openEdit = useCallback((activity)=>{
+        setEditing(activity);
+        setDialogOpen(true);
+    }, []);
+    const close = useCallback(()=>setDialogOpen(false), []);
+    const loggedChip = useMemo(()=>/*#__PURE__*/ _jsx(Chip, {
+            label: "Logged",
+            size: "small",
+            variant: "outlined"
+        }), []);
+    return /*#__PURE__*/ _jsxs(_Fragment, {
+        children: [
+            /*#__PURE__*/ _jsx(CardDisplay, {
+                header: 'Timeline',
+                help: pluginDocsHelp('contactActivities', {
+                    anchor: '#four-kinds-of-history'
+                }),
+                actions: suiteLocked ? /*#__PURE__*/ _jsx(CrmSuiteLockedButton, {
+                    variant: "contained",
+                    color: "primary",
+                    children: 'Log activity'
+                }) : /*#__PURE__*/ _jsx(Button, {
+                    size: "small",
+                    variant: "contained",
+                    color: "primary",
+                    onClick: openNew,
+                    disabled: !activities.ready,
+                    children: 'Log activity'
+                }),
+                contentGutterX: true,
+                contentGutterY: true,
+                children: /*#__PURE__*/ _jsxs(Stack, {
+                    spacing: 2,
+                    children: [
+                        activities.status === 'error' ? /*#__PURE__*/ _jsx(Typography, {
+                            variant: "body2",
+                            color: "error",
+                            children: 'Logged activity could not be loaded; what follows is what the platform captured.'
+                        }) : null,
+                        campaigns.status === 'error' || campaigns.lookupFailed ? // "Unknown", not "none": an empty campaign history and one that
+                        // could not be read lead a reader to opposite conclusions.
+                        /*#__PURE__*/ _jsx(Typography, {
+                            variant: "body2",
+                            color: "error",
+                            children: 'Campaign email could not be loaded; the stream below may be missing the mail this person was sent.'
+                        }) : null,
+                        entries.length === 0 ? campaigns.status === 'loading' ? // The campaign history is one request on mount; an empty state
+                        // before it answers would read as "none" for a person who was mailed.
+                        /*#__PURE__*/ _jsx(Typography, {
+                            variant: "body2",
+                            color: "text.secondary",
+                            children: 'Loading…'
+                        }) : /*#__PURE__*/ _jsx(EmptyStateComponent, {
+                            compact: true,
+                            label: 'No history yet',
+                            description: 'What this person does on the site, the campaigns they are sent, and what you log about them, shows here.',
+                            action: suiteLocked ? /*#__PURE__*/ _jsx(CrmSuiteLockedButton, {
+                                variant: "contained",
+                                color: "primary",
+                                children: 'Log activity'
+                            }) : /*#__PURE__*/ _jsx(Button, {
+                                size: "small",
+                                variant: "contained",
+                                color: "primary",
+                                onClick: openNew,
+                                disabled: !activities.ready,
+                                children: 'Log activity'
+                            })
+                        }) : entries.map((entry)=>entry.kind === 'captured' ? /*#__PURE__*/ _jsx(CapturedRow, {
+                                interaction: entry.interaction,
+                                nowMs: nowMs,
+                                href: interactionHref(entry.interaction)
+                            }, entry.key) : entry.kind === 'campaign' ? /*#__PURE__*/ _jsx(CampaignEmailRow, {
+                                email: entry.email,
+                                href: campaignHref ? campaignHref(entry.email) : null,
+                                nowMs: nowMs
+                            }, entry.key) : /*#__PURE__*/ _jsx(ActivityRow, {
+                                activity: entry.activity,
+                                scope: scope,
+                                onEdit: openEdit,
+                                subject: loggedChip,
+                                nowMs: nowMs,
+                                editable: !suiteLocked && canEdit(entry.activity)
+                            }, entry.key)),
+                        activities.hasMore ? /*#__PURE__*/ _jsx(Button, {
+                            size: "small",
+                            onClick: activities.showMore,
+                            sx: {
+                                alignSelf: 'flex-start'
+                            },
+                            children: 'Show more activity'
+                        }) : null
+                    ]
+                })
+            }),
+            /*#__PURE__*/ _jsx(LogActivityDialog, {
+                open: dialogOpen,
+                onClose: close,
+                scope: scope,
+                link: link,
+                activity: editing
+            })
+        ]
+    });
+}
+ContactTimelineCard.displayName = 'ContactTimelineCard';
+export default ContactTimelineCard;
+
+//# sourceMappingURL=contact-timeline-card.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/crm/src/lib/components/contact-timeline-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 {\n  ContactCampaignEmail,\n  ContactInteraction,\n  ContactSource,\n  CrmActivityRow,\n} from '@aglyn/aglyn'\nimport { CONTACT_SOURCE_LABELS, pluginDocsHelp } from '@aglyn/aglyn'\nimport {\n  mdiAccountCircleOutline,\n  mdiAccountEditOutline,\n  mdiAccountPlusOutline,\n  mdiApi,\n  mdiBullhornOutline,\n  mdiCalendarCheckOutline,\n  mdiCartOutline,\n  mdiEmailNewsletter,\n  mdiFileImportOutline,\n  mdiFormSelect,\n} from '@aglyn/shared-data-mdi'\nimport { AppLink, CardDisplay, MdiIcon } from '@aglyn/shared-ui-jsx'\nimport EmptyStateComponent from '@aglyn/shared-ui-jsx/components/empty-state.component'\nimport { Button, Chip, Stack, Tooltip, Typography } from '@mui/material'\nimport { useParams } from 'next/navigation'\nimport { useCallback, useMemo, useState } from 'react'\nimport { contactPrimaryGroup } from '../model/contact-record'\nimport { ActivityRow } from './activity-list'\nimport {\n  type ActivityRecordLink,\n  type CrmOrg,\n  useActivityScope,\n  useActivityWindow,\n  useCanEditActivity,\n} from './activity-queries'\nimport { CrmSuiteLockedButton } from './crm-suite-lock'\nimport { LogActivityDialog } from './log-activity-dialog'\nimport { useContactCampaignEmails } from './use-contact-campaign-emails'\n\n/**\n * One glyph per capture door. Typed against the source union so a door added\n * to it cannot render as the placeholder glyph.\n */\nconst SOURCE_ICONS: Record<ContactSource, { path: string }> = {\n  form: mdiFormSelect,\n  member: mdiAccountPlusOutline,\n  order: mdiCartOutline,\n  booking: mdiCalendarCheckOutline,\n  newsletter: mdiEmailNewsletter,\n  api: mdiApi,\n  manual: mdiAccountEditOutline,\n  import: mdiFileImportOutline,\n  account: mdiAccountCircleOutline,\n}\n\n/**\n * One thing the platform recorded: the door it came through, what the door\n * wrote, when, and the page the person was on.\n *\n * Read-only by nature — nobody logged it, so nobody edits it. The entry\n * point sits beside the timestamp rather than in the summary, the way the\n * contacts drawer draws it: the summary is the sentence the door wrote, the\n * path is a fact the door recorded, and a long path on the sentence's line\n * pushes out the thing the row is about.\n */\nfunction CapturedRow(props: {\n  interaction: ContactInteraction\n  nowMs: number\n  /** The console page the door's record is read on, when it left one. */\n  href: string | null\n}) {\n  const { interaction, nowMs, href } = props\n  const source = interaction.type\n  const label = CONTACT_SOURCE_LABELS[source] ?? String(source)\n  const icon = SOURCE_ICONS[source]\n  const when = new Date(interaction.atMs)\n  return (\n    <Stack direction=\"row\" spacing={1.5} sx={{ alignItems: 'flex-start' }}>\n      <Stack\n        sx={{\n          color: 'text.secondary',\n          pt: 0.25,\n          fontSize: (theme) => theme.typography.h6.fontSize,\n        }}\n      >\n        <MdiIcon path={icon?.path} />\n      </Stack>\n      <Stack spacing={0.5} sx={{ flex: 1, minWidth: 0 }}>\n        <Stack\n          direction=\"row\"\n          spacing={1}\n          sx={{ alignItems: 'center', flexWrap: 'wrap', rowGap: 0.5 }}\n        >\n          <Chip label={label} size=\"small\" />\n          <Chip label=\"Captured\" size=\"small\" variant=\"outlined\" />\n        </Stack>\n        <Typography variant=\"body2\">\n          {interaction.summary ?? label}\n        </Typography>\n        <Tooltip title={when.toLocaleString()}>\n          <Typography\n            variant=\"caption\"\n            color=\"text.secondary\"\n            sx={{ alignSelf: 'flex-start' }}\n          >\n            {interaction.path\n              ? `${Aglyn.activityTimeLabel(interaction.atMs, nowMs)} · ${interaction.path}`\n              : Aglyn.activityTimeLabel(interaction.atMs, nowMs)}\n          </Typography>\n        </Tooltip>\n        {/*\n          The record the door left, where the console reads it (AGL-2622):\n          the submission in the Inbox reader, the order in its dialog. A door\n          that left nothing to open — a newsletter opt-in, an import — has no\n          link, and the caption above is the whole entry.\n        */}\n        {href ? (\n          <Typography variant=\"caption\" sx={{ alignSelf: 'flex-start' }}>\n            <AppLink href={href}>\n              {Aglyn.INTERACTION_LINK_LABELS[source] ?? 'Open'}\n            </AppLink>\n          </Typography>\n        ) : null}\n      </Stack>\n    </Stack>\n  )\n}\nCapturedRow.displayName = 'CapturedRow'\n\n/**\n * One campaign email the platform sent this person (AGL-2616): which email,\n * and what became of it — `sent · delivered · opened ×2 · clicked`.\n *\n * Read-only like a captured row, and drawn apart from BOTH the captured and\n * the logged rows: its glyph is the campaign's, never the envelope a logged\n * `email` activity carries, and its chips say \"Campaign\" and \"Sent\" where\n * the others say \"Captured\" and \"Logged\". The name links to the email's own\n * report when the page can address it; an email the team has deleted, or\n * one a sibling site sent, keeps its name and loses the link.\n */\nfunction CampaignEmailRow(props: {\n  email: ContactCampaignEmail\n  href: string | null\n  nowMs: number\n}) {\n  const { email, href, nowMs } = props\n  const name = email.campaignName ?? email.subject ?? 'Campaign email'\n  const summary = Aglyn.campaignEmailSummary(email).join(' · ')\n  const when = new Date(email.sentAtMs)\n  return (\n    <Stack direction=\"row\" spacing={1.5} sx={{ alignItems: 'flex-start' }}>\n      <Stack\n        sx={{\n          color: 'text.secondary',\n          pt: 0.25,\n          fontSize: (theme) => theme.typography.h6.fontSize,\n        }}\n      >\n        <MdiIcon path={mdiBullhornOutline.path} />\n      </Stack>\n      <Stack spacing={0.5} sx={{ flex: 1, minWidth: 0 }}>\n        <Stack\n          direction=\"row\"\n          spacing={1}\n          sx={{ alignItems: 'center', flexWrap: 'wrap', rowGap: 0.5 }}\n        >\n          <Chip label=\"Campaign\" size=\"small\" />\n          <Chip label=\"Sent\" size=\"small\" variant=\"outlined\" />\n        </Stack>\n        <Typography variant=\"body2\">\n          {href ? <AppLink href={href}>{name}</AppLink> : name}\n          {` · ${summary}`}\n        </Typography>\n        <Tooltip title={when.toLocaleString()}>\n          <Typography\n            variant=\"caption\"\n            color=\"text.secondary\"\n            sx={{ alignSelf: 'flex-start' }}\n          >\n            {email.subject && email.subject !== name\n              ? `${Aglyn.activityTimeLabel(email.sentAtMs, nowMs)} · ${email.subject}`\n              : Aglyn.activityTimeLabel(email.sentAtMs, nowMs)}\n          </Typography>\n        </Tooltip>\n      </Stack>\n    </Stack>\n  )\n}\nCampaignEmailRow.displayName = 'CampaignEmailRow'\n\nexport interface ContactTimelineCardProps {\n  /** The site the record is read under, or `null` at the organization level. */\n  hostId: string | null\n  org: CrmOrg\n  contactId: string\n  /**\n   * The RAW contact document, as the page's listener hands it back. The card\n   * resolves the viewing group and reads that group's facet itself, so a\n   * page cannot hand it another holder's timeline by flattening the row\n   * through the wrong group.\n   */\n  contact: Record<string, unknown> | null | undefined\n  /**\n   * Where a campaign entry links to — the email's report — or `null` for\n   * one the page cannot address. Handed in rather than built here because\n   * the report lives on another surface whose path is the MOUNT's to know:\n   * a site's record page reaches its own Emails hub, an org-level mount\n   * holds the org's site list and can reach every site's. No builder means\n   * no links, never a guessed one.\n   */\n  campaignHref?: (email: ContactCampaignEmail) => string | null\n  /**\n   * The org's plan lacks the CRM (AGL-2788), which the shell mounts no CRM\n   * page for (AGL-2851). The history still draws; logging an activity stands\n   * locked, and one already logged cannot be edited.\n   */\n  suiteLocked?: boolean\n}\n\n/**\n * A person's whole history in one newest-first stream (AGL-2600): what the\n * platform CAPTURED — a form, an order, a booking, a sign-up — what a person\n * LOGGED beside it — a call, an email, a meeting, a note — and, since\n * AGL-2616, the campaign mail the platform SENT them and what became of it.\n *\n * ## Why one stream\n *\n * The histories answer one question, \"what has happened with this person\",\n * and a page showing them as separate lists asks the reader to interleave\n * them by eye. The merge is `mergeContactTimeline`, pure and specced: newest\n * first, stable at a tie, an undated entry last, a campaign at the instant\n * it was sent.\n *\n * Each entry says which it is. A captured entry carries the door's label and\n * a \"Captured\" chip and offers no controls; a logged entry carries its kind\n * and a \"Logged\" chip, and its author may edit or delete it; a campaign\n * entry carries \"Campaign\" and \"Sent\", links to the email's report, and is\n * nobody's to edit.\n *\n * ## What is read\n *\n * The captured side comes off the contact document the page already holds\n * — THIS group's facet, filtered to the sites the group may see, the same\n * projection the contacts list makes — and costs no read. The logged side is\n * the bounded listener every activity surface uses, filtered to this\n * contact, with a foot for the next hundred. The campaign side is one\n * request to `crm/contact-email-history`, which reads down this person's\n * own delivery log, capped, and never a campaign's recipients. The facet's\n * history is capped at fifty by the platform, so past the window the stream\n * is the logged side alone; the foot says as much by asking for \"more\n * activity\" rather than \"more history\".\n */\nexport function ContactTimelineCard(props: ContactTimelineCardProps) {\n  const { hostId, org, contactId, contact, campaignHref, suiteLocked = false } = props\n  const scope = useActivityScope(hostId, org)\n  /*\n   * THIS holder's captured history, and only the visits this group may see.\n   * A read off the top of the document, or of another group's facet, would\n   * be another business's records — the disclosure the facet shape ended.\n   * At the organization level (AGL-2630) the holder is the person's own\n   * primary one, the group the record page reads the profile through.\n   */\n  const consentGroup = useMemo(\n    () =>\n      scope.consentGroup ??\n      contactPrimaryGroup(contact, (org ?? null) as Record<string, unknown> | null),\n    [scope.consentGroup, contact, org],\n  )\n  const interactions = useMemo(() => {\n    const facet = Aglyn.readContactFacet(contact, consentGroup.groupId)\n    return Aglyn.interactionsForGroup(facet.interactions, consentGroup.hostIds)\n  }, [contact, consentGroup])\n  const link = useMemo<ActivityRecordLink>(() => ({ contactId }), [contactId])\n  const activities = useActivityWindow(scope, link)\n  /*\n   * Where a captured entry's record is READ (AGL-2622). The site console's\n   * two route params are already in the URL this page is on, so the link is\n   * built from them rather than from two document reads per timeline. Only\n   * an interaction on THIS site links: a sibling site's order is that\n   * site's record, read on that site's console, and a link built with this\n   * site's segment would 404 or — worse — open the wrong site's row under\n   * the same id. An interaction with no site recorded predates the stamp\n   * and is left unlinked rather than guessed at. Off a site — the org-level\n   * mount — there is no segment to build with, and nothing links.\n   */\n  const params = useParams<{ orgSlug?: string; host?: string }>()\n  const siteContext = useMemo(\n    () =>\n      params?.orgSlug && params?.host\n        ? { orgSlug: String(params.orgSlug), host: String(params.host) }\n        : null,\n    [params?.orgSlug, params?.host],\n  )\n  const interactionHref = useCallback(\n    (interaction: ContactInteraction): string | null =>\n      siteContext && interaction.hostId === hostId\n        ? Aglyn.contactInteractionHref(interaction, siteContext)\n        : null,\n    [siteContext, hostId],\n  )\n  // The campaign history is asked of a site: the mounted one, or the holder's.\n  const campaigns = useContactCampaignEmails(\n    hostId ?? (consentGroup.hostId || null),\n    contactId,\n  )\n  // One member read for the whole stream, however many rows it has.\n  const canEdit = useCanEditActivity(scope.orgId)\n  const entries = useMemo(\n    () =>\n      Aglyn.mergeContactTimeline(interactions, activities.rows, campaigns.emails),\n    [interactions, activities.rows, campaigns.emails],\n  )\n  // One clock for every row of one paint, so two rows logged a second apart\n  // cannot read \"just now\" and \"1 min ago\" from being rendered across a\n  // minute boundary.\n  const nowMs = Date.now()\n\n  const [dialogOpen, setDialogOpen] = useState(false)\n  const [editing, setEditing] = useState<CrmActivityRow | null>(null)\n  const openNew = useCallback(() => {\n    setEditing(null)\n    setDialogOpen(true)\n  }, [])\n  const openEdit = useCallback((activity: CrmActivityRow) => {\n    setEditing(activity)\n    setDialogOpen(true)\n  }, [])\n  const close = useCallback(() => setDialogOpen(false), [])\n\n  const loggedChip = useMemo(\n    () => <Chip label=\"Logged\" size=\"small\" variant=\"outlined\" />,\n    [],\n  )\n\n  return (\n    <>\n      <CardDisplay\n        header={'Timeline'}\n        help={pluginDocsHelp('contactActivities', { anchor: '#four-kinds-of-history' })}\n        actions={\n          suiteLocked ? (\n            <CrmSuiteLockedButton variant=\"contained\" color=\"primary\">\n              {'Log activity'}\n            </CrmSuiteLockedButton>\n          ) : (\n            <Button\n              size=\"small\"\n              variant=\"contained\"\n              color=\"primary\"\n              onClick={openNew}\n              disabled={!activities.ready}\n            >\n              {'Log activity'}\n            </Button>\n          )\n        }\n        contentGutterX\n        contentGutterY\n      >\n        <Stack spacing={2}>\n          {activities.status === 'error' ? (\n            <Typography variant=\"body2\" color=\"error\">\n              {'Logged activity could not be loaded; what follows is what the platform captured.'}\n            </Typography>\n          ) : null}\n          {campaigns.status === 'error' || campaigns.lookupFailed ? (\n            // \"Unknown\", not \"none\": an empty campaign history and one that\n            // could not be read lead a reader to opposite conclusions.\n            <Typography variant=\"body2\" color=\"error\">\n              {'Campaign email could not be loaded; the stream below may be missing the mail this person was sent.'}\n            </Typography>\n          ) : null}\n          {entries.length === 0 ? (\n            campaigns.status === 'loading' ? (\n              // The campaign history is one request on mount; an empty state\n              // before it answers would read as \"none\" for a person who was mailed.\n              <Typography variant=\"body2\" color=\"text.secondary\">\n                {'Loading…'}\n              </Typography>\n            ) : (\n            <EmptyStateComponent\n              compact\n              label={'No history yet'}\n              description={'What this person does on the site, the campaigns they are sent, and what you log about them, shows here.'}\n              action={\n                suiteLocked ? (\n                  <CrmSuiteLockedButton variant=\"contained\" color=\"primary\">\n                    {'Log activity'}\n                  </CrmSuiteLockedButton>\n                ) : (\n                  <Button\n                    size=\"small\"\n                    variant=\"contained\"\n                    color=\"primary\"\n                    onClick={openNew}\n                    disabled={!activities.ready}\n                  >\n                    {'Log activity'}\n                  </Button>\n                )\n              }\n            />\n            )\n          ) : (\n            entries.map((entry) =>\n              entry.kind === 'captured' ? (\n                <CapturedRow\n                  key={entry.key}\n                  interaction={entry.interaction}\n                  nowMs={nowMs}\n                  href={interactionHref(entry.interaction)}\n                />\n              ) : entry.kind === 'campaign' ? (\n                <CampaignEmailRow\n                  key={entry.key}\n                  email={entry.email}\n                  href={campaignHref ? campaignHref(entry.email) : null}\n                  nowMs={nowMs}\n                />\n              ) : (\n                <ActivityRow\n                  key={entry.key}\n                  activity={entry.activity}\n                  scope={scope}\n                  onEdit={openEdit}\n                  subject={loggedChip}\n                  nowMs={nowMs}\n                  editable={!suiteLocked && canEdit(entry.activity)}\n                />\n              ),\n            )\n          )}\n          {activities.hasMore ? (\n            <Button\n              size=\"small\"\n              onClick={activities.showMore}\n              sx={{ alignSelf: 'flex-start' }}\n            >\n              {'Show more activity'}\n            </Button>\n          ) : null}\n        </Stack>\n      </CardDisplay>\n      <LogActivityDialog\n        open={dialogOpen}\n        onClose={close}\n        scope={scope}\n        link={link}\n        activity={editing}\n      />\n    </>\n  )\n}\nContactTimelineCard.displayName = 'ContactTimelineCard'\n\nexport default ContactTimelineCard\n"],"names":["Aglyn","CONTACT_SOURCE_LABELS","pluginDocsHelp","mdiAccountCircleOutline","mdiAccountEditOutline","mdiAccountPlusOutline","mdiApi","mdiBullhornOutline","mdiCalendarCheckOutline","mdiCartOutline","mdiEmailNewsletter","mdiFileImportOutline","mdiFormSelect","AppLink","CardDisplay","MdiIcon","EmptyStateComponent","Button","Chip","Stack","Tooltip","Typography","useParams","useCallback","useMemo","useState","contactPrimaryGroup","ActivityRow","useActivityScope","useActivityWindow","useCanEditActivity","CrmSuiteLockedButton","LogActivityDialog","useContactCampaignEmails","SOURCE_ICONS","form","member","order","booking","newsletter","api","manual","import","account","CapturedRow","props","interaction","nowMs","href","source","type","label","String","icon","when","Date","atMs","direction","spacing","sx","alignItems","color","pt","fontSize","theme","typography","h6","path","flex","minWidth","flexWrap","rowGap","size","variant","summary","title","toLocaleString","alignSelf","activityTimeLabel","INTERACTION_LINK_LABELS","displayName","CampaignEmailRow","email","name","campaignName","subject","campaignEmailSummary","join","sentAtMs","ContactTimelineCard","hostId","org","contactId","contact","campaignHref","suiteLocked","scope","consentGroup","interactions","facet","readContactFacet","groupId","interactionsForGroup","hostIds","link","activities","params","siteContext","orgSlug","host","interactionHref","contactInteractionHref","campaigns","canEdit","orgId","entries","mergeContactTimeline","rows","emails","now","dialogOpen","setDialogOpen","editing","setEditing","openNew","openEdit","activity","close","loggedChip","header","help","anchor","actions","onClick","disabled","ready","contentGutterX","contentGutterY","status","lookupFailed","length","compact","description","action","map","entry","kind","key","onEdit","editable","hasMore","showMore","open","onClose"],"mappings":"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"}

package/src/lib/components/contacts-bulk-bar.d.ts

@@ -0,0 +1,91 @@
+/**
+ * The bar over the contacts table, for whatever rows are ticked (AGL-2603).
+ *
+ * The table's selection is opt-in and this is what it is for: a chosen set
+ * of people, and one act over all of them. Tag or untag them, hand them to
+ * an owner, move them along the funnel, put them on an email audience, take
+ * them into a spreadsheet, or let them go from this site's CRM.
+ *
+ * ## The chrome is the shared frame
+ *
+ * This bar settled how a bar over a table reads — it appears only for a
+ * selection and says how many, its actions sit in one wrapping row with
+ * Clear at the end, and whatever the last action could not do is listed by
+ * name in an alert under it — and the companies, deals and tasks bars were
+ * built on that shape as `CrmBulkBarFrame` and `useCrmBulkApply` (AGL-2621).
+ * The contacts bar stands on the same two (AGL-2635): what is its own is the
+ * actions, the dialog's field, the audience door, and how each act is sent.
+ *
+ * ## Each act goes where its field is written (AGL-2804)
+ *
+ * A contact's tags, owner and company live in the holder's facet, which is
+ * the server's to write — the rules cannot tell one field of a facet from
+ * another — so each of those acts is ONE request to `crm/contact-update` for
+ * the rows it reaches (`contacts-bulk-writes.ts` decides which), sent in
+ * pieces the route accepts. A stage move is `crm/contact-stage`, row by row:
+ * a move is what an automation listens for, and only the route that
+ * performed it can announce it. Letting the rows go is the one act written
+ * client-direct, because a holder dropping its own facet is the one facet
+ * change the rules leave the browser.
+ *
+ * ## A refused row is named
+ *
+ * Whatever the server or the store refused comes back by address into the
+ * alert under the bar — not into a count, and not into the console. A
+ * merchant who tagged four hundred people and got three hundred and
+ * ninety-eight needs the two addresses.
+ *
+ * ## Add to list goes through the audience's own door
+ *
+ * The membership routes, with the check-then-attest sequence the Emails
+ * console runs — see `add-to-list-dialog.tsx`. Nothing here writes a
+ * membership document.
+ */
+import { type AglynOrgBilling, type ConsentGroup } from '@aglyn/aglyn';
+import { type ContactBulkRow } from '../model/contacts-bulk-writes';
+import { type ContactCsvOptions, type ContactCsvRow } from '../model/contacts-csv';
+export interface ContactsBulkBarProps {
+    /** The site the list 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;
+    /** `['orgs', orgId]`, or `null` while the org is unresolved. */
+    scope: readonly [string, string] | null;
+    /**
+     * The holder these rows are being read AS — whose facet the acts land in.
+     * `null` at the organization level (AGL-2630), where each row's own holder
+     * (`groupId`) takes the act instead, and "Remove from this site" is not
+     * offered because there is no site to remove from.
+     */
+    consentGroup: ConsentGroup | null;
+    /** The table's rows, already projected through the holder's facet. */
+    rows: readonly (ContactBulkRow & ContactCsvRow)[];
+    selected: readonly string[];
+    onSelectedChange: (ids: string[]) => void;
+    /**
+     * How the export names an owner and which custom fields it carries — the
+     * table's own options, so the selection's file and the table's are one
+     * format (AGL-2621).
+     */
+    csv?: ContactCsvOptions;
+    /**
+     * The org's plan lacks the CRM (AGL-2788), which the shell mounts no CRM
+     * page for (AGL-2851). The owner, the stage and the company stand locked;
+     * tags, the exports, the audience door and removing people from a site
+     * draw no lock of their own.
+     */
+    suiteLocked?: boolean;
+}
+/**
+ * The bar, or nothing.
+ *
+ * The empty state is a separate component boundary on purpose: with no
+ * selection the body below is never mounted, so none of its hooks run — no
+ * roster hook armed, no dialog state held — on the visit to the list that
+ * every reader makes and most never tick a row on.
+ */
+export declare function ContactsBulkBar(props: ContactsBulkBarProps): import("react").JSX.Element;
+export declare namespace ContactsBulkBar {
+    var displayName: string;
+}
+export default ContactsBulkBar;