@aglyn/plugins-crm 1.0.0-beta.143

package/src/lib/components/activity-list.js

@@ -0,0 +1,321 @@
+/**
+ * @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 } from "react/jsx-runtime";
+import * as Aglyn from "@aglyn/aglyn";
+import { mdiAccountGroupOutline, mdiDeleteOutline, mdiDotsHorizontalCircleOutline, mdiEmailOutline, mdiEmailReceiveOutline, mdiNoteTextOutline, mdiPencilOutline, mdiPhoneOutline } from "@aglyn/shared-data-mdi";
+import { MdiIcon, useConfirmationContext } from "@aglyn/shared-ui-jsx";
+import EmptyStateComponent from "@aglyn/shared-ui-jsx/components/empty-state.component";
+import { useSnackbar } from "@aglyn/shared-ui-snackstack";
+import { useUser, useUserName } from "@aglyn/tenant-feature-instance";
+import { Button, Chip, IconButton, Stack, Tooltip, Typography } from "@mui/material";
+import { deleteDoc, doc } from "firebase/firestore";
+import { useCallback } from "react";
+import { useCanEditActivity } from "./activity-queries.js";
+/**
+ * One glyph per kind. Typed against the union so a kind added to the list
+ * cannot render with no icon — `MdiIcon` would fall back to its default
+ * glyph silently, and a log where every note looks like a placeholder is
+ * worse than a build error.
+ */ const KIND_ICONS = {
+    call: mdiPhoneOutline,
+    email: mdiEmailOutline,
+    meeting: mdiAccountGroupOutline,
+    note: mdiNoteTextOutline,
+    other: mdiDotsHorizontalCircleOutline
+};
+/** The icon for a kind — a stored kind outside the union draws as `other`. */ export function ActivityKindIcon(props) {
+    const { kind, size = 1 } = props;
+    const icon = Aglyn.isCrmActivityKind(kind) ? KIND_ICONS[kind] : KIND_ICONS.other;
+    return /*#__PURE__*/ _jsx(MdiIcon, {
+        path: icon.path,
+        size: size
+    });
+}
+ActivityKindIcon.displayName = 'ActivityKindIcon';
+/**
+ * The author's name for a row (AGL-2600).
+ *
+ * The denormalized `byName` leads: it is the only name a scoped colleague
+ * can read, since a member document is readable by its subject and by
+ * org-wide members alone. The signed-in user's OWN rows fall back to their
+ * live name — the one case where a lookup is possible — and a row that
+ * carries neither (written by a door that did not stamp one) reads as a
+ * team member rather than as a uid.
+ */ export function useActivityAuthorName() {
+    const { data: user } = useUser();
+    const ownName = useUserName();
+    const uid = user == null ? void 0 : user.uid;
+    return useCallback((activity)=>{
+        if (activity.byName) return activity.byName;
+        if (uid && activity.byUid === uid && ownName) return ownName;
+        return 'A team member';
+    }, [
+        uid,
+        ownName
+    ]);
+}
+/** "45 min" or "2 h 05 min" — a duration a manager reads at a glance. */ function durationLabel(minutes) {
+    if (minutes < 60) return `${minutes} min`;
+    const hours = Math.floor(minutes / 60);
+    const rest = minutes % 60;
+    return rest ? `${hours} h ${String(rest).padStart(2, '0')} min` : `${hours} h`;
+}
+/**
+ * One logged activity: the kind's icon and label, what was said, how it
+ * went, who logged it and how long ago — with edit and delete for whoever
+ * may (AGL-2600).
+ *
+ * Edit and delete appear only when `editable` says this reader may — the
+ * author or an org-wide member. That is the console's verdict and not the
+ * rules' — see `useCanEditActivity` for why the rules admit more — so the
+ * controls are hidden rather than disabled: a disabled button asks "why
+ * not?", and the honest answer would be "you could, through the API".
+ */ export function ActivityRow(props) {
+    const { activity, scope, onEdit, subject, nowMs, editable } = props;
+    const { firestore, dataScope } = scope;
+    const authorName = useActivityAuthorName();
+    const { confirm } = useConfirmationContext();
+    const { enqueueSnackbar } = useSnackbar();
+    const handleDelete = useCallback(async ()=>{
+        if (!dataScope) return;
+        const confirmed = await confirm({
+            title: 'Delete this activity?',
+            description: `This ${Aglyn.CRM_ACTIVITY_KIND_LABELS[Aglyn.isCrmActivityKind(activity.kind) ? activity.kind : 'other'].toLowerCase()} is removed from the record it was logged against. ` + 'Nothing the platform captured — a form, an order, a booking — is ' + 'affected.',
+            confirmationText: 'Delete activity',
+            confirmationButtonProps: {
+                color: 'error'
+            }
+        }).then(()=>true).catch(()=>false);
+        if (!confirmed) return;
+        try {
+            await deleteDoc(doc(firestore, dataScope[0], dataScope[1], Aglyn.CRM_COLLECTIONS.activities, activity.$id));
+            enqueueSnackbar('Activity deleted', {
+                variant: 'success',
+                persist: false
+            });
+        } catch (error) {
+            console.error(error);
+            enqueueSnackbar('An error has occurred', {
+                variant: 'error',
+                allowDuplicate: true
+            });
+        }
+    }, [
+        dataScope,
+        confirm,
+        activity,
+        firestore,
+        enqueueSnackbar
+    ]);
+    const label = Aglyn.CRM_ACTIVITY_KIND_LABELS[Aglyn.isCrmActivityKind(activity.kind) ? activity.kind : 'other'];
+    /*
+   * A message the platform SENT (AGL-2615) carries a subject, an address
+   * and a delivery state the webhook advances; the state is the chip beside
+   * the kind, red once the message did not land. What was sent is a record
+   * of a fact and offers no edit — a rewritten body would misstate what
+   * left — though whoever may delete a row may still delete this one.
+   */ const sent = activity.direction === 'outbound';
+    /*
+   * A message CAPTURED from a mailbox (AGL-2657) carries the provider's
+   * Message-ID and, when a correspondent wrote it, the `inbound` direction.
+   * It is drawn as its own thing — "Received" beside the kind, the sender
+   * where a sent row shows the recipient, no author because nobody on the
+   * team logged it — and a member's copied send reads "Sent" without a
+   * delivery chip, since the platform did not carry it. Neither takes the
+   * caller's "Logged" chip: nobody logged them.
+   */ const received = activity.direction === 'inbound';
+    const captured = typeof activity.messageId === 'string' && activity.messageId !== '';
+    const deliveryState = Aglyn.isCrmEmailDeliveryState(activity.deliveryState) ? activity.deliveryState : null;
+    const when = new Date(activity.atMs);
+    const detail = [
+        activity.outcome ? activity.outcome : null,
+        typeof activity.durationMinutes === 'number' && activity.durationMinutes > 0 ? durationLabel(activity.durationMinutes) : null
+    ].filter(Boolean);
+    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: received ? /*#__PURE__*/ _jsx(MdiIcon, {
+                    path: mdiEmailReceiveOutline.path
+                }) : /*#__PURE__*/ _jsx(ActivityKindIcon, {
+                    kind: activity.kind
+                })
+            }),
+            /*#__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"
+                            }),
+                            received ? /*#__PURE__*/ _jsx(Chip, {
+                                label: "Received",
+                                size: "small",
+                                variant: "outlined",
+                                color: "info",
+                                "data-testid": "activity-direction"
+                            }) : captured ? /*#__PURE__*/ _jsx(Chip, {
+                                label: "Sent",
+                                size: "small",
+                                variant: "outlined",
+                                "data-testid": "activity-direction"
+                            }) : null,
+                            deliveryState ? /*#__PURE__*/ _jsx(Tooltip, {
+                                title: typeof activity.deliveryAtMs === 'number' ? new Date(activity.deliveryAtMs).toLocaleString() : '',
+                                children: /*#__PURE__*/ _jsx(Chip, {
+                                    label: Aglyn.CRM_EMAIL_DELIVERY_STATE_LABELS[deliveryState],
+                                    size: "small",
+                                    variant: "outlined",
+                                    color: Aglyn.isCrmEmailDeliveryFailure(deliveryState) ? 'error' : 'default',
+                                    "data-testid": "activity-delivery-state"
+                                })
+                            }) : null,
+                            captured ? null : subject,
+                            detail.length ? /*#__PURE__*/ _jsx(Typography, {
+                                variant: "caption",
+                                color: "text.secondary",
+                                children: detail.join(' · ')
+                            }) : null
+                        ]
+                    }),
+                    activity.subject ? /*#__PURE__*/ _jsx(Typography, {
+                        variant: "subtitle2",
+                        children: activity.subject
+                    }) : null,
+                    /*#__PURE__*/ _jsx(Typography, {
+                        variant: "body2",
+                        sx: {
+                            whiteSpace: 'pre-wrap'
+                        },
+                        children: activity.body
+                    }),
+                    /*#__PURE__*/ _jsx(Tooltip, {
+                        title: when.toLocaleString(),
+                        children: /*#__PURE__*/ _jsx(Typography, {
+                            variant: "caption",
+                            color: "text.secondary",
+                            sx: {
+                                alignSelf: 'flex-start'
+                            },
+                            children: [
+                                received ? null : authorName(activity),
+                                received && activity.from ? `from ${activity.from}` : null,
+                                sent && activity.to ? `to ${activity.to}` : null,
+                                Aglyn.activityTimeLabel(activity.atMs, nowMs != null ? nowMs : Date.now())
+                            ].filter(Boolean).join(' · ')
+                        })
+                    })
+                ]
+            }),
+            editable ? /*#__PURE__*/ _jsxs(Stack, {
+                direction: "row",
+                spacing: 0.5,
+                children: [
+                    onEdit && !sent && !received ? /*#__PURE__*/ _jsx(IconButton, {
+                        size: "small",
+                        "aria-label": "Edit activity",
+                        onClick: ()=>onEdit(activity),
+                        children: /*#__PURE__*/ _jsx(MdiIcon, {
+                            path: mdiPencilOutline.path,
+                            size: 0.8
+                        })
+                    }) : null,
+                    /*#__PURE__*/ _jsx(IconButton, {
+                        size: "small",
+                        "aria-label": "Delete activity",
+                        onClick: handleDelete,
+                        children: /*#__PURE__*/ _jsx(MdiIcon, {
+                            path: mdiDeleteOutline.path,
+                            size: 0.8
+                        })
+                    })
+                ]
+            }) : null
+        ]
+    });
+}
+ActivityRow.displayName = 'ActivityRow';
+/**
+ * A newest-first list of logged activities with a "show more" foot
+ * (AGL-2600).
+ *
+ * The rows arrive ordered — the query is `orderBy('atMs', 'desc')` — and the
+ * list does not sort them again; a second sort here is a second place for
+ * the order to be defined. The foot appears only while the probe row says
+ * more exists, so it never leads nowhere.
+ *
+ * Who may edit is decided here, once, and handed to every row: the verdict
+ * reads the member document, and the list is the one place that can ask
+ * for it a single time however many rows it draws.
+ */ export function ActivityList(props) {
+    const { rows, scope, onEdit, emptyText = 'Nothing logged yet.', emptyAction, hasMore, onShowMore, subjectFor, readOnly } = props;
+    const canEdit = useCanEditActivity(scope.orgId, !readOnly);
+    if (!rows.length) {
+        return /*#__PURE__*/ _jsx(EmptyStateComponent, {
+            compact: true,
+            label: 'Nothing logged yet',
+            description: emptyText,
+            action: emptyAction
+        });
+    }
+    return /*#__PURE__*/ _jsxs(Stack, {
+        spacing: 2,
+        children: [
+            rows.map((activity)=>/*#__PURE__*/ _jsx(ActivityRow, {
+                    activity: activity,
+                    scope: scope,
+                    onEdit: onEdit,
+                    subject: subjectFor == null ? void 0 : subjectFor(activity),
+                    editable: canEdit(activity)
+                }, activity.$id)),
+            hasMore && onShowMore ? /*#__PURE__*/ _jsx(Button, {
+                size: "small",
+                onClick: onShowMore,
+                sx: {
+                    alignSelf: 'flex-start'
+                },
+                children: 'Show more'
+            }) : null
+        ]
+    });
+}
+ActivityList.displayName = 'ActivityList';
+export default ActivityList;
+
+//# sourceMappingURL=activity-list.js.map

package/src/lib/components/activity-list.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/crm/src/lib/components/activity-list.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 { CrmActivityKind, CrmActivityRow } from '@aglyn/aglyn'\nimport {\n  mdiAccountGroupOutline,\n  mdiDeleteOutline,\n  mdiDotsHorizontalCircleOutline,\n  mdiEmailOutline,\n  mdiEmailReceiveOutline,\n  mdiNoteTextOutline,\n  mdiPencilOutline,\n  mdiPhoneOutline,\n} from '@aglyn/shared-data-mdi'\nimport { MdiIcon, useConfirmationContext } from '@aglyn/shared-ui-jsx'\nimport EmptyStateComponent from '@aglyn/shared-ui-jsx/components/empty-state.component'\nimport { useSnackbar } from '@aglyn/shared-ui-snackstack'\nimport { useUser, useUserName } from '@aglyn/tenant-feature-instance'\nimport {\n  Button,\n  Chip,\n  IconButton,\n  Stack,\n  Tooltip,\n  Typography,\n} from '@mui/material'\nimport { deleteDoc, doc } from 'firebase/firestore'\nimport { type ReactNode, useCallback } from 'react'\nimport { type ActivityScope, useCanEditActivity } from './activity-queries'\n\n/**\n * One glyph per kind. Typed against the union so a kind added to the list\n * cannot render with no icon — `MdiIcon` would fall back to its default\n * glyph silently, and a log where every note looks like a placeholder is\n * worse than a build error.\n */\nconst KIND_ICONS: Record<CrmActivityKind, { path: string }> = {\n  call: mdiPhoneOutline,\n  email: mdiEmailOutline,\n  meeting: mdiAccountGroupOutline,\n  note: mdiNoteTextOutline,\n  other: mdiDotsHorizontalCircleOutline,\n}\n\n/** The icon for a kind — a stored kind outside the union draws as `other`. */\nexport function ActivityKindIcon(props: { kind: string; size?: number }) {\n  const { kind, size = 1 } = props\n  const icon = Aglyn.isCrmActivityKind(kind) ? KIND_ICONS[kind] : KIND_ICONS.other\n  return <MdiIcon path={icon.path} size={size} />\n}\nActivityKindIcon.displayName = 'ActivityKindIcon'\n\n/**\n * The author's name for a row (AGL-2600).\n *\n * The denormalized `byName` leads: it is the only name a scoped colleague\n * can read, since a member document is readable by its subject and by\n * org-wide members alone. The signed-in user's OWN rows fall back to their\n * live name — the one case where a lookup is possible — and a row that\n * carries neither (written by a door that did not stamp one) reads as a\n * team member rather than as a uid.\n */\nexport function useActivityAuthorName(): (\n  activity: Pick<CrmActivityRow, 'byUid' | 'byName'>,\n) => string {\n  const { data: user } = useUser()\n  const ownName = useUserName()\n  const uid = user?.uid\n  return useCallback(\n    (activity) => {\n      if (activity.byName) return activity.byName\n      if (uid && activity.byUid === uid && ownName) return ownName\n      return 'A team member'\n    },\n    [uid, ownName],\n  )\n}\n\n/** \"45 min\" or \"2 h 05 min\" — a duration a manager reads at a glance. */\nfunction durationLabel(minutes: number): string {\n  if (minutes < 60) return `${minutes} min`\n  const hours = Math.floor(minutes / 60)\n  const rest = minutes % 60\n  return rest ? `${hours} h ${String(rest).padStart(2, '0')} min` : `${hours} h`\n}\n\nexport interface ActivityRowProps {\n  activity: CrmActivityRow\n  /** Where the delete is written, from `useActivityScope`. */\n  scope: ActivityScope\n  /** Opens the dialog on this activity. Absent, the row offers no edit. */\n  onEdit?: (activity: CrmActivityRow) => void\n  /**\n   * What sits after the kind, before the body — a feed puts the record the\n   * activity is about here, a record page needs nothing.\n   */\n  subject?: ReactNode\n  /** The clock the relative time is read against; `Date.now()` when absent. */\n  nowMs?: number\n  /**\n   * Whether THIS reader may edit and delete the row — the author, or an\n   * org-wide member. Decided by whoever draws the rows, through\n   * `useCanEditActivity`, once for the whole list: a row that asked for\n   * itself would read the member document once per row.\n   */\n  editable?: boolean\n}\n\n/**\n * One logged activity: the kind's icon and label, what was said, how it\n * went, who logged it and how long ago — with edit and delete for whoever\n * may (AGL-2600).\n *\n * Edit and delete appear only when `editable` says this reader may — the\n * author or an org-wide member. That is the console's verdict and not the\n * rules' — see `useCanEditActivity` for why the rules admit more — so the\n * controls are hidden rather than disabled: a disabled button asks \"why\n * not?\", and the honest answer would be \"you could, through the API\".\n */\nexport function ActivityRow(props: ActivityRowProps) {\n  const { activity, scope, onEdit, subject, nowMs, editable } = props\n  const { firestore, dataScope } = scope\n  const authorName = useActivityAuthorName()\n  const { confirm } = useConfirmationContext()\n  const { enqueueSnackbar } = useSnackbar()\n\n  const handleDelete = useCallback(async () => {\n    if (!dataScope) return\n    const confirmed = await confirm({\n      title: 'Delete this activity?',\n      description:\n        `This ${Aglyn.CRM_ACTIVITY_KIND_LABELS[\n          Aglyn.isCrmActivityKind(activity.kind) ? activity.kind : 'other'\n        ].toLowerCase()} is removed from the record it was logged against. ` +\n        'Nothing the platform captured — a form, an order, a booking — is ' +\n        'affected.',\n      confirmationText: 'Delete activity',\n      confirmationButtonProps: { color: 'error' },\n    })\n      .then(() => true)\n      .catch(() => false)\n    if (!confirmed) return\n    try {\n      await deleteDoc(\n        doc(\n          firestore,\n          dataScope[0],\n          dataScope[1],\n          Aglyn.CRM_COLLECTIONS.activities,\n          activity.$id,\n        ),\n      )\n      enqueueSnackbar('Activity deleted', { variant: 'success', persist: false })\n    } catch (error) {\n      console.error(error)\n      enqueueSnackbar('An error has occurred', {\n        variant: 'error',\n        allowDuplicate: true,\n      })\n    }\n  }, [dataScope, confirm, activity, firestore, enqueueSnackbar])\n\n  const label =\n    Aglyn.CRM_ACTIVITY_KIND_LABELS[\n      Aglyn.isCrmActivityKind(activity.kind) ? activity.kind : 'other'\n    ]\n  /*\n   * A message the platform SENT (AGL-2615) carries a subject, an address\n   * and a delivery state the webhook advances; the state is the chip beside\n   * the kind, red once the message did not land. What was sent is a record\n   * of a fact and offers no edit — a rewritten body would misstate what\n   * left — though whoever may delete a row may still delete this one.\n   */\n  const sent = activity.direction === 'outbound'\n  /*\n   * A message CAPTURED from a mailbox (AGL-2657) carries the provider's\n   * Message-ID and, when a correspondent wrote it, the `inbound` direction.\n   * It is drawn as its own thing — \"Received\" beside the kind, the sender\n   * where a sent row shows the recipient, no author because nobody on the\n   * team logged it — and a member's copied send reads \"Sent\" without a\n   * delivery chip, since the platform did not carry it. Neither takes the\n   * caller's \"Logged\" chip: nobody logged them.\n   */\n  const received = activity.direction === 'inbound'\n  const captured = typeof activity.messageId === 'string' && activity.messageId !== ''\n  const deliveryState = Aglyn.isCrmEmailDeliveryState(activity.deliveryState)\n    ? activity.deliveryState\n    : null\n  const when = new Date(activity.atMs)\n  const detail = [\n    activity.outcome ? activity.outcome : null,\n    typeof activity.durationMinutes === 'number' && activity.durationMinutes > 0\n      ? durationLabel(activity.durationMinutes)\n      : null,\n  ].filter(Boolean)\n\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        {received ? (\n          <MdiIcon path={mdiEmailReceiveOutline.path} />\n        ) : (\n          <ActivityKindIcon kind={activity.kind} />\n        )}\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          {received ? (\n            <Chip\n              label=\"Received\"\n              size=\"small\"\n              variant=\"outlined\"\n              color=\"info\"\n              data-testid=\"activity-direction\"\n            />\n          ) : captured ? (\n            <Chip\n              label=\"Sent\"\n              size=\"small\"\n              variant=\"outlined\"\n              data-testid=\"activity-direction\"\n            />\n          ) : null}\n          {deliveryState ? (\n            <Tooltip\n              title={\n                typeof activity.deliveryAtMs === 'number'\n                  ? new Date(activity.deliveryAtMs).toLocaleString()\n                  : ''\n              }\n            >\n              <Chip\n                label={Aglyn.CRM_EMAIL_DELIVERY_STATE_LABELS[deliveryState]}\n                size=\"small\"\n                variant=\"outlined\"\n                color={Aglyn.isCrmEmailDeliveryFailure(deliveryState) ? 'error' : 'default'}\n                data-testid=\"activity-delivery-state\"\n              />\n            </Tooltip>\n          ) : null}\n          {captured ? null : subject}\n          {detail.length ? (\n            <Typography variant=\"caption\" color=\"text.secondary\">\n              {detail.join(' · ')}\n            </Typography>\n          ) : null}\n        </Stack>\n        {activity.subject ? (\n          <Typography variant=\"subtitle2\">{activity.subject}</Typography>\n        ) : null}\n        <Typography variant=\"body2\" sx={{ whiteSpace: 'pre-wrap' }}>\n          {activity.body}\n        </Typography>\n        <Tooltip title={when.toLocaleString()}>\n          <Typography\n            variant=\"caption\"\n            color=\"text.secondary\"\n            sx={{ alignSelf: 'flex-start' }}\n          >\n            {[\n              received ? null : authorName(activity),\n              received && activity.from ? `from ${activity.from}` : null,\n              sent && activity.to ? `to ${activity.to}` : null,\n              Aglyn.activityTimeLabel(activity.atMs, nowMs ?? Date.now()),\n            ]\n              .filter(Boolean)\n              .join(' · ')}\n          </Typography>\n        </Tooltip>\n      </Stack>\n      {editable ? (\n        <Stack direction=\"row\" spacing={0.5}>\n          {onEdit && !sent && !received ? (\n            <IconButton\n              size=\"small\"\n              aria-label=\"Edit activity\"\n              onClick={() => onEdit(activity)}\n            >\n              <MdiIcon path={mdiPencilOutline.path} size={0.8} />\n            </IconButton>\n          ) : null}\n          <IconButton\n            size=\"small\"\n            aria-label=\"Delete activity\"\n            onClick={handleDelete}\n          >\n            <MdiIcon path={mdiDeleteOutline.path} size={0.8} />\n          </IconButton>\n        </Stack>\n      ) : null}\n    </Stack>\n  )\n}\nActivityRow.displayName = 'ActivityRow'\n\nexport interface ActivityListProps {\n  /** Newest-first, as the listener hands them back. */\n  rows: readonly CrmActivityRow[]\n  scope: ActivityScope\n  onEdit?: (activity: CrmActivityRow) => void\n  /** What the list says when there is nothing in it. */\n  emptyText?: string\n  /** The way out of an empty list — the record's \"Log activity\" button. */\n  emptyAction?: ReactNode\n  /** A further page exists; `onShowMore` widens the window. */\n  hasMore?: boolean\n  onShowMore?: () => void\n  /** The record each row is about, for a list that spans records. */\n  subjectFor?: (activity: CrmActivityRow) => ReactNode\n  /**\n   * No controls on any row, whoever is reading — and no member read to\n   * decide them. A feed that spans records is a place to see what happened,\n   * not to rewrite it; the record's own page is where an activity is\n   * corrected, beside everything else about it.\n   */\n  readOnly?: boolean\n}\n\n/**\n * A newest-first list of logged activities with a \"show more\" foot\n * (AGL-2600).\n *\n * The rows arrive ordered — the query is `orderBy('atMs', 'desc')` — and the\n * list does not sort them again; a second sort here is a second place for\n * the order to be defined. The foot appears only while the probe row says\n * more exists, so it never leads nowhere.\n *\n * Who may edit is decided here, once, and handed to every row: the verdict\n * reads the member document, and the list is the one place that can ask\n * for it a single time however many rows it draws.\n */\nexport function ActivityList(props: ActivityListProps) {\n  const {\n    rows,\n    scope,\n    onEdit,\n    emptyText = 'Nothing logged yet.',\n    emptyAction,\n    hasMore,\n    onShowMore,\n    subjectFor,\n    readOnly,\n  } = props\n  const canEdit = useCanEditActivity(scope.orgId, !readOnly)\n  if (!rows.length) {\n    return (\n      <EmptyStateComponent\n        compact\n        label={'Nothing logged yet'}\n        description={emptyText}\n        action={emptyAction}\n      />\n    )\n  }\n  return (\n    <Stack spacing={2}>\n      {rows.map((activity) => (\n        <ActivityRow\n          key={activity.$id}\n          activity={activity}\n          scope={scope}\n          onEdit={onEdit}\n          subject={subjectFor?.(activity)}\n          editable={canEdit(activity)}\n        />\n      ))}\n      {hasMore && onShowMore ? (\n        <Button size=\"small\" onClick={onShowMore} sx={{ alignSelf: 'flex-start' }}>\n          {'Show more'}\n        </Button>\n      ) : null}\n    </Stack>\n  )\n}\nActivityList.displayName = 'ActivityList'\n\nexport default ActivityList\n"],"names":["Aglyn","mdiAccountGroupOutline","mdiDeleteOutline","mdiDotsHorizontalCircleOutline","mdiEmailOutline","mdiEmailReceiveOutline","mdiNoteTextOutline","mdiPencilOutline","mdiPhoneOutline","MdiIcon","useConfirmationContext","EmptyStateComponent","useSnackbar","useUser","useUserName","Button","Chip","IconButton","Stack","Tooltip","Typography","deleteDoc","doc","useCallback","useCanEditActivity","KIND_ICONS","call","email","meeting","note","other","ActivityKindIcon","props","kind","size","icon","isCrmActivityKind","path","displayName","useActivityAuthorName","data","user","ownName","uid","activity","byName","byUid","durationLabel","minutes","hours","Math","floor","rest","String","padStart","ActivityRow","scope","onEdit","subject","nowMs","editable","firestore","dataScope","authorName","confirm","enqueueSnackbar","handleDelete","confirmed","title","description","CRM_ACTIVITY_KIND_LABELS","toLowerCase","confirmationText","confirmationButtonProps","color","then","catch","CRM_COLLECTIONS","activities","$id","variant","persist","error","console","allowDuplicate","label","sent","direction","received","captured","messageId","deliveryState","isCrmEmailDeliveryState","when","Date","atMs","detail","outcome","durationMinutes","filter","Boolean","spacing","sx","alignItems","pt","fontSize","theme","typography","h6","flex","minWidth","flexWrap","rowGap","data-testid","deliveryAtMs","toLocaleString","CRM_EMAIL_DELIVERY_STATE_LABELS","isCrmEmailDeliveryFailure","length","join","whiteSpace","body","alignSelf","from","to","activityTimeLabel","now","aria-label","onClick","ActivityList","rows","emptyText","emptyAction","hasMore","onShowMore","subjectFor","readOnly","canEdit","orgId","compact","action","map"],"mappings":"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"}

package/src/lib/components/activity-queries.d.ts

@@ -0,0 +1,117 @@
+import * as Aglyn from '@aglyn/aglyn';
+import type { AglynOrgBilling, CrmActivityRow } from '@aglyn/aglyn';
+/** The org document as the shell passes it: partial, and possibly absent. */
+export type CrmOrg = Partial<AglynOrgBilling> | null | undefined;
+/**
+ * Which record an activity surface is about. Exactly one of the three is set
+ * by a record page; a feed across the CRM sets none.
+ */
+export interface ActivityRecordLink {
+    contactId?: string;
+    companyId?: string;
+    dealId?: string;
+    /** A lead's own log (AGL-2615) — see `CrmActivityLink.leadId`. */
+    leadId?: string;
+}
+/**
+ * Everything an activity surface needs to know about WHERE it is reading
+ * and writing (AGL-2600), resolved once from the two props the shell hands
+ * every CRM page.
+ *
+ * Four surfaces read activities — a record card, a contact's timeline, the
+ * recent feed and the dialog that writes them — and each of them would
+ * otherwise resolve the same org, the same consent group and the same token
+ * set from the same two inputs. Resolved here so that a surface cannot read
+ * with one group and write with another, which is the shape of leak the
+ * contacts list closed (a listener with no `where` at all).
+ *
+ * Pure of Firestore reads: the org document is the one the shell already
+ * loaded, so the group and the tokens cost nothing, and the data scope is
+ * the memoized `['orgs', orgId]` tuple every host-scoped card builds.
+ */
+export declare function useActivityScope(hostId: string | null, org: CrmOrg): {
+    firestore: import("@firebase/firestore").Firestore;
+    dataScope: readonly ["orgs", string];
+    orgId: string;
+    /** The site a NEW activity names as provenance — the mounted site, or the picked one. */
+    hostId: string;
+    /**
+     * The site the surface is MOUNTED under, or `null` at the organization
+     * level — what a dialog reads to decide whether to ask which site.
+     */
+    mountedHostId: string;
+    consentGroup: Aglyn.ConsentGroup;
+    readTokens: readonly Aglyn.ScopeToken[];
+    writeTokens: readonly Aglyn.ScopeToken[];
+};
+export type ActivityScope = ReturnType<typeof useActivityScope>;
+/**
+ * Whether the signed-in user may EDIT or DELETE a given activity (AGL-2600).
+ *
+ * The author may, and so may an org-wide member — the person who administers
+ * the org can correct or remove anything logged in it. Nobody else: a scoped
+ * colleague may read a call log they did not write, and may not rewrite it.
+ *
+ * ⚠️ This is a UI verdict, not an enforced one. The Firestore rules on
+ * `crmActivities` admit any member who may write scoped org data, and they
+ * do not distinguish the author from anybody else — there is no `byUid`
+ * clause in them. The controls are hidden here so that the console does not
+ * offer a colleague's log for editing, and a caller who bypasses the console
+ * is a caller the rules already admit. Tightening the rules to the author is
+ * a decision about what the API permits, not something a card takes on its
+ * own.
+ *
+ * `useScopeTokens` answers org-wide while it loads, so the verdict for a
+ * NON-author waits for `loaded` — a scoped colleague must not see edit
+ * controls flash on for one paint and then vanish.
+ *
+ * Called ONCE by the list that draws the rows, never by a row. The verdict
+ * costs a read of the member document, and a hundred rows each asking would
+ * be a hundred reads of one document on every mount — the shape of cost the
+ * console pays nowhere else. `enabled` is for a surface that offers no
+ * controls at all, the feed: `useScopeTokens` opens nothing for an undefined
+ * org, so a disabled verdict reads nothing and answers no.
+ */
+export declare function useCanEditActivity(orgId: string | undefined, enabled?: boolean): (activity: Pick<CrmActivityRow, "byUid">) => boolean;
+/** How many rows a "show more" step adds, and how many the first paint reads. */
+export declare const ACTIVITY_PAGE_SIZE = 100;
+/**
+ * The activities filed against one record, or across the CRM, newest-first
+ * and bounded (AGL-2600).
+ *
+ * The window is the query. `usePagedCollection` widens the listener by one
+ * page each time the reader asks for more, so a record with three hundred
+ * calls costs a hundred documents until somebody wants the next hundred —
+ * and `hasMore` is a fact from the probe row, not a guess from the length.
+ * The rows handed back are the WHOLE window so far, not the last page alone,
+ * because a log reads as one list that grows at the bottom rather than as
+ * numbered pages.
+ *
+ * Filtered by `array-contains-any` over the reader's tokens, which is the
+ * predicate the rules evaluate with `hasAny`: a filtered query is provable
+ * per document, and an unfiltered one is refused outright rather than
+ * quietly returning everything. The record filter is one equality on top of
+ * it — the four indexes `(visibleTo, contactId|companyId|dealId|leadId, atMs
+ * DESC)` exist for exactly these queries, and `(visibleTo, atMs DESC)` for the
+ * feed that names no record.
+ *
+ * Each record filter is indexed twice. An organization-level reader has no
+ * tokens, so `crmVisibleToClause` contributes no constraint and the query
+ * arrives as `(<record>, atMs DESC)` with the array field gone — a different
+ * index, not a prefix of the one above it. Adding a record kind here means
+ * adding BOTH halves; one of them alone leaves the other audience unserved.
+ *
+ * These are all DESCENDING because this window asks for `desc` outright. A
+ * read over the same rows that names no order is not served by them: Firestore
+ * orders such a query by its range field ascending, and an index serves one
+ * direction or its exact reverse. That is why the report counts carry their
+ * own ascending indexes rather than borrowing these.
+ */
+export declare function useActivityWindow(scope: ActivityScope, link: ActivityRecordLink, pageSize?: number): {
+    rows: Aglyn.CrmActivityRow[];
+    hasMore: boolean;
+    showMore: () => void;
+    status: import("@aglyn/tenant-feature-instance").FirestoreCollectionStatus;
+    /** Whether the listener has a scope to read at all. */
+    ready: boolean;
+};