@aglyn/plugins-crm 1.0.0-beta.143

package/src/lib/components/crm-record-insights-zone.js

@@ -0,0 +1,169 @@
+/**
+ * @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 { useConsoleWidgetSlot } from "@aglyn/aglyn/app-utils/console-widget-slot-context";
+import { useConfirmationContext } from "@aglyn/shared-ui-jsx";
+import { useSnackbar } from "@aglyn/shared-ui-snackstack";
+import { useCallback, useMemo, useState } from "react";
+import { useCrmScope } from "../hooks/use-crm-scope.js";
+import { openStages } from "../model/deal-board-model.js";
+import TaskEditDrawer from "./task-edit-drawer.js";
+/** The due time a proposed task opens the form with: the end of the working day, `days` from today. */ export function crmProposedDueAtMs(dueInDays, nowMs = Date.now()) {
+    const due = new Date(nowMs);
+    due.setDate(due.getDate() + Math.max(0, Math.round(dueInDays)));
+    due.setHours(17, 0, 0, 0);
+    return due.getTime();
+}
+/** A proposed next step as the task form's fields, linked to the record. */ export function crmProposedTaskFields(task, link, nowMs = Date.now()) {
+    return _extends({}, link, {
+        title: task.title,
+        notes: task.notes,
+        kind: task.kind,
+        priority: task.priority,
+        dueAtMs: crmProposedDueAtMs(task.dueInDays, nowMs)
+    });
+}
+/**
+ * The `recordInsights` zone on a CRM record's page (AGL-2917), hosted through
+ * the renderer the console shell hands down, as the product editor hosts
+ * `seoFields`: outside the shell it renders nothing, and inside it every gate
+ * a console page's slot applies applies here.
+ *
+ * A widget proposes; this page writes. A proposed task opens the CRM's own
+ * task form with the proposal filled in, and the form's Save is the write,
+ * through `crm/task-save`. A proposed stage is confirmed first and then moved
+ * through `crm/deal-stage`, the one writer of a deal's stage, so the move
+ * emits the event every automation listens for. Only an open stage is
+ * accepted: winning or losing a deal is a decision the stage card takes.
+ */ export function CrmRecordInsightsZone(props) {
+    const Slot = useConsoleWidgetSlot();
+    // Outside the console shell there is no workspace to gate on, and nothing
+    // below is read.
+    return Slot ? /*#__PURE__*/ _jsx(HostedRecordInsightsZone, _extends({}, props, {
+        Slot: Slot
+    })) : null;
+}
+CrmRecordInsightsZone.displayName = 'CrmRecordInsightsZone';
+function HostedRecordInsightsZone(props) {
+    var _ref;
+    var _props_taskLink, _props_taskLink1, _props_taskLink2;
+    const { hostId, org, kind, recordId, name, deal, Slot } = props;
+    // By the ids it names, so a page that passes a fresh object each render
+    // hands the widget the same callback.
+    const contactId = (_props_taskLink = props.taskLink) == null ? void 0 : _props_taskLink.contactId;
+    const companyId = (_props_taskLink1 = props.taskLink) == null ? void 0 : _props_taskLink1.companyId;
+    const dealId = (_props_taskLink2 = props.taskLink) == null ? void 0 : _props_taskLink2.dealId;
+    const linked = Boolean(props.taskLink);
+    const taskLink = useMemo(()=>linked ? _extends({}, contactId ? {
+            contactId
+        } : {}, companyId ? {
+            companyId
+        } : {}, dealId ? {
+            dealId
+        } : {}) : undefined, [
+        linked,
+        contactId,
+        companyId,
+        dealId
+    ]);
+    const { scope, orgId, visibleTo } = useCrmScope({
+        hostId,
+        org
+    });
+    const { confirm } = useConfirmationContext();
+    const { enqueueSnackbar } = useSnackbar();
+    const [proposed, setProposed] = useState(null);
+    const proposeTask = useCallback((task, key)=>{
+        if (!taskLink) return;
+        setProposed({
+            key,
+            fields: crmProposedTaskFields(task, taskLink)
+        });
+    }, [
+        taskLink
+    ]);
+    const stages = useMemo(()=>deal ? openStages(deal.pipeline).map((stage)=>({
+                id: stage.id,
+                name: stage.name
+            })) : undefined, [
+        deal
+    ]);
+    const proposeStage = useCallback(async (stageId)=>{
+        if (!deal || deal.status !== 'open') return;
+        const stage = stages == null ? void 0 : stages.find((entry)=>entry.id === stageId);
+        if (!stage || stage.id === deal.stageId) return;
+        const agreed = await confirm({
+            title: `Move this deal to ${stage.name}?`,
+            description: 'The deal moves as it would from its stage card, and any automation that listens for a stage change runs.',
+            confirmationText: `Move to ${stage.name}`
+        }).then(()=>true).catch(()=>false);
+        if (!agreed) return;
+        try {
+            await deal.api.moveToStage(deal.ref, stage.id);
+            enqueueSnackbar(`Moved to ${stage.name}`, {
+                variant: 'success',
+                persist: false
+            });
+        } catch (error) {
+            enqueueSnackbar(error instanceof Error ? error.message : 'The deal could not be moved.', {
+                variant: 'warning'
+            });
+        }
+    }, [
+        deal,
+        stages,
+        confirm,
+        enqueueSnackbar
+    ]);
+    const zone = _extends({
+        hostId,
+        orgId: orgId != null ? orgId : undefined,
+        record: {
+            kind,
+            id: recordId,
+            name
+        }
+    }, taskLink ? {
+        proposeTask
+    } : {}, deal && stages ? {
+        stages,
+        stageId: deal.stageId,
+        proposeStage: (stageId)=>void proposeStage(stageId)
+    } : {});
+    return /*#__PURE__*/ _jsxs(_Fragment, {
+        children: [
+            /*#__PURE__*/ _jsx(Slot, _extends({
+                slot: "recordInsights"
+            }, zone)),
+            taskLink ? /*#__PURE__*/ _jsx(TaskEditDrawer, {
+                open: Boolean(proposed),
+                onClose: ()=>setProposed(null),
+                hostId: hostId,
+                org: org,
+                orgId: orgId,
+                scope: scope,
+                readTokens: visibleTo,
+                prefill: proposed == null ? void 0 : proposed.fields,
+                onSaved: ()=>setProposed(null)
+            }, (_ref = proposed == null ? void 0 : proposed.key) != null ? _ref : 'none') : null
+        ]
+    });
+}
+export default CrmRecordInsightsZone;
+
+//# sourceMappingURL=crm-record-insights-zone.js.map

package/src/lib/components/crm-record-insights-zone.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/crm/src/lib/components/crm-record-insights-zone.tsx"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n'use client'\n\nimport {\n  type ConsoleWidgetSlotRenderer,\n  useConsoleWidgetSlot,\n} from '@aglyn/aglyn/app-utils/console-widget-slot-context'\nimport type { ConsoleRecordInsightsZoneProps } from '@aglyn/aglyn/plugin-manager/feature-plugins'\nimport type { ConsoleProposedTask } from '@aglyn/aglyn/plugin-manager/record-zone-props'\nimport { useConfirmationContext } from '@aglyn/shared-ui-jsx'\nimport { useSnackbar } from '@aglyn/shared-ui-snackstack'\nimport { useCallback, useMemo, useState } from 'react'\nimport { useCrmScope } from '../hooks/use-crm-scope'\nimport type { DealStageApi, DealStageRef } from '../hooks/use-deal-stage-api'\nimport { openStages, type PipelineDoc } from '../model/deal-board-model'\nimport type { CrmTaskFields } from '../model/task-routes'\nimport TaskEditDrawer from './task-edit-drawer'\n\n/** The record links a task proposed on a record's page is filed under. */\nexport type CrmRecordTaskLink = Pick<Partial<CrmTaskFields>, 'contactId' | 'companyId' | 'dealId'>\n\nexport interface CrmRecordInsightsZoneProps {\n  /** The site the page is under, or `null` at the organization level; a lead's own site on a lead's page. */\n  hostId: string | null\n  org?: Record<string, unknown> | null\n  kind: 'contact' | 'company' | 'deal' | 'lead'\n  recordId: string\n  /** The record's name as the page shows it. */\n  name: string\n  /**\n   * The links a proposed next step is filed under. Absent for a lead, which a\n   * task cannot name, so the zone offers no task there.\n   */\n  taskLink?: CrmRecordTaskLink\n  /** A deal's stage controls: its pipeline, the deal as the stage route names it, and the route. */\n  deal?: { pipeline: PipelineDoc | null; ref: DealStageRef; stageId: string; status: string; api: DealStageApi }\n}\n\n/** The due time a proposed task opens the form with: the end of the working day, `days` from today. */\nexport function crmProposedDueAtMs(dueInDays: number, nowMs: number = Date.now()): number {\n  const due = new Date(nowMs)\n  due.setDate(due.getDate() + Math.max(0, Math.round(dueInDays)))\n  due.setHours(17, 0, 0, 0)\n  return due.getTime()\n}\n\n/** A proposed next step as the task form's fields, linked to the record. */\nexport function crmProposedTaskFields(\n  task: ConsoleProposedTask,\n  link: CrmRecordTaskLink,\n  nowMs: number = Date.now(),\n): Partial<CrmTaskFields> {\n  return {\n    ...link,\n    title: task.title,\n    notes: task.notes,\n    kind: task.kind,\n    priority: task.priority,\n    dueAtMs: crmProposedDueAtMs(task.dueInDays, nowMs),\n  }\n}\n\n/**\n * The `recordInsights` zone on a CRM record's page (AGL-2917), hosted through\n * the renderer the console shell hands down, as the product editor hosts\n * `seoFields`: outside the shell it renders nothing, and inside it every gate\n * a console page's slot applies applies here.\n *\n * A widget proposes; this page writes. A proposed task opens the CRM's own\n * task form with the proposal filled in, and the form's Save is the write,\n * through `crm/task-save`. A proposed stage is confirmed first and then moved\n * through `crm/deal-stage`, the one writer of a deal's stage, so the move\n * emits the event every automation listens for. Only an open stage is\n * accepted: winning or losing a deal is a decision the stage card takes.\n */\nexport function CrmRecordInsightsZone(props: CrmRecordInsightsZoneProps) {\n  const Slot = useConsoleWidgetSlot()\n  // Outside the console shell there is no workspace to gate on, and nothing\n  // below is read.\n  return Slot ? <HostedRecordInsightsZone {...props} Slot={Slot} /> : null\n}\nCrmRecordInsightsZone.displayName = 'CrmRecordInsightsZone'\n\nfunction HostedRecordInsightsZone(props: CrmRecordInsightsZoneProps & { Slot: ConsoleWidgetSlotRenderer }) {\n  const { hostId, org, kind, recordId, name, deal, Slot } = props\n  // By the ids it names, so a page that passes a fresh object each render\n  // hands the widget the same callback.\n  const contactId = props.taskLink?.contactId\n  const companyId = props.taskLink?.companyId\n  const dealId = props.taskLink?.dealId\n  const linked = Boolean(props.taskLink)\n  const taskLink = useMemo<CrmRecordTaskLink | undefined>(\n    () =>\n      linked\n        ? { ...(contactId ? { contactId } : {}), ...(companyId ? { companyId } : {}), ...(dealId ? { dealId } : {}) }\n        : undefined,\n    [linked, contactId, companyId, dealId],\n  )\n  const { scope, orgId, visibleTo } = useCrmScope({ hostId, org })\n  const { confirm } = useConfirmationContext()\n  const { enqueueSnackbar } = useSnackbar()\n  const [proposed, setProposed] = useState<{ key: string; fields: Partial<CrmTaskFields> } | null>(null)\n\n  const proposeTask = useCallback(\n    (task: ConsoleProposedTask, key: string) => {\n      if (!taskLink) return\n      setProposed({ key, fields: crmProposedTaskFields(task, taskLink) })\n    },\n    [taskLink],\n  )\n\n  const stages = useMemo(\n    () => (deal ? openStages(deal.pipeline).map((stage) => ({ id: stage.id, name: stage.name })) : undefined),\n    [deal],\n  )\n\n  const proposeStage = useCallback(\n    async (stageId: string) => {\n      if (!deal || deal.status !== 'open') return\n      const stage = stages?.find((entry) => entry.id === stageId)\n      if (!stage || stage.id === deal.stageId) return\n      const agreed = await confirm({\n        title: `Move this deal to ${stage.name}?`,\n        description: 'The deal moves as it would from its stage card, and any automation that listens for a stage change runs.',\n        confirmationText: `Move to ${stage.name}`,\n      })\n        .then(() => true)\n        .catch(() => false)\n      if (!agreed) return\n      try {\n        await deal.api.moveToStage(deal.ref, stage.id)\n        enqueueSnackbar(`Moved to ${stage.name}`, { variant: 'success', persist: false })\n      } catch (error) {\n        enqueueSnackbar(error instanceof Error ? error.message : 'The deal could not be moved.', { variant: 'warning' })\n      }\n    },\n    [deal, stages, confirm, enqueueSnackbar],\n  )\n\n  const zone: ConsoleRecordInsightsZoneProps = {\n    hostId,\n    orgId: orgId ?? undefined,\n    record: { kind, id: recordId, name },\n    ...(taskLink ? { proposeTask } : {}),\n    ...(deal && stages ? { stages, stageId: deal.stageId, proposeStage: (stageId: string) => void proposeStage(stageId) } : {}),\n  }\n  return (\n    <>\n      <Slot slot=\"recordInsights\" {...zone} />\n      {taskLink ? (\n        <TaskEditDrawer\n          key={proposed?.key ?? 'none'}\n          open={Boolean(proposed)}\n          onClose={() => setProposed(null)}\n          hostId={hostId}\n          org={org}\n          orgId={orgId}\n          scope={scope}\n          readTokens={visibleTo}\n          prefill={proposed?.fields}\n          onSaved={() => setProposed(null)}\n        />\n      ) : null}\n    </>\n  )\n}\n\nexport default CrmRecordInsightsZone\n"],"names":["useConsoleWidgetSlot","useConfirmationContext","useSnackbar","useCallback","useMemo","useState","useCrmScope","openStages","TaskEditDrawer","crmProposedDueAtMs","dueInDays","nowMs","Date","now","due","setDate","getDate","Math","max","round","setHours","getTime","crmProposedTaskFields","task","link","title","notes","kind","priority","dueAtMs","CrmRecordInsightsZone","props","Slot","HostedRecordInsightsZone","displayName","hostId","org","recordId","name","deal","contactId","taskLink","companyId","dealId","linked","Boolean","undefined","scope","orgId","visibleTo","confirm","enqueueSnackbar","proposed","setProposed","proposeTask","key","fields","stages","pipeline","map","stage","id","proposeStage","stageId","status","find","entry","agreed","description","confirmationText","then","catch","api","moveToStage","ref","variant","persist","error","Error","message","zone","record","slot","open","onClose","readTokens","prefill","onSaved"],"mappings":"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"}

package/src/lib/components/crm-record-picker.d.ts

@@ -0,0 +1,42 @@
+import { type CrmRecordKind } from '../hooks/use-crm-record-names';
+/**
+ * How many records a picker offers. The window is the hundred most recently
+ * touched, which is the hundred a person is most likely to be making a task
+ * about; the field says so, and the record pages' own "New task" buttons
+ * arrive with the record already linked, which is how a task about an older
+ * one gets made.
+ */
+export declare const CRM_RECORD_PICKER_LIMIT = 100;
+export interface CrmRecordPickerProps {
+    kind: CrmRecordKind;
+    scope: readonly [string, string] | null;
+    /** The reader's tokens, or `null` at the organization level — no clause (AGL-2630). */
+    readTokens: readonly string[] | null;
+    /**
+     * The viewing group, for a contact's facet name — or `null` at the
+     * organization level, where each contact is named through its own
+     * primary holder (`contactPrimaryGroup`), resolved from {@link org}.
+     */
+    groupId: string | null;
+    /** The org document, for the per-contact holder when {@link groupId} is null. */
+    org?: Record<string, unknown> | null;
+    value: string | null;
+    onChange: (id: string | null) => void;
+    disabled?: boolean;
+}
+/**
+ * Link a task to a contact, company or deal by name (AGL-2599).
+ *
+ * One query shape for all three kinds — the most recently updated hundred
+ * visible to this site, filtered as the person types — because that is the
+ * one shape every CRM collection has an index for (`visibleTo, updatedAt`).
+ * A prefix search on the stored name would need `(visibleTo, nameLower)`,
+ * which companies have and contacts do not, and a picker that searched two
+ * kinds properly and one kind not at all would be worse to explain than a
+ * window. The listener opens with the drawer and closes with it.
+ */
+export declare function CrmRecordPicker(props: CrmRecordPickerProps): import("react").JSX.Element;
+export declare namespace CrmRecordPicker {
+    var displayName: string;
+}
+export default CrmRecordPicker;

package/src/lib/components/crm-record-picker.js

@@ -0,0 +1,104 @@
+/**
+ * @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 } from "react/jsx-runtime";
+import { useFirestore, useFirestoreCollection } from "@aglyn/tenant-feature-instance";
+import { Autocomplete, TextField } from "@mui/material";
+import { collection, limit, orderBy, query } from "firebase/firestore";
+import { useMemo } from "react";
+import { CRM_RECORD_COLLECTIONS, crmRecordName } from "../hooks/use-crm-record-names.js";
+import { crmVisibleToClause } from "../hooks/use-crm-scope.js";
+import { contactPrimaryGroup } from "../model/contact-record.js";
+/**
+ * How many records a picker offers. The window is the hundred most recently
+ * touched, which is the hundred a person is most likely to be making a task
+ * about; the field says so, and the record pages' own "New task" buttons
+ * arrive with the record already linked, which is how a task about an older
+ * one gets made.
+ */ export const CRM_RECORD_PICKER_LIMIT = 100;
+const PICKER_LABELS = {
+    contact: 'Contact',
+    company: 'Company',
+    deal: 'Deal'
+};
+/**
+ * Link a task to a contact, company or deal by name (AGL-2599).
+ *
+ * One query shape for all three kinds — the most recently updated hundred
+ * visible to this site, filtered as the person types — because that is the
+ * one shape every CRM collection has an index for (`visibleTo, updatedAt`).
+ * A prefix search on the stored name would need `(visibleTo, nameLower)`,
+ * which companies have and contacts do not, and a picker that searched two
+ * kinds properly and one kind not at all would be worse to explain than a
+ * window. The listener opens with the drawer and closes with it.
+ */ export function CrmRecordPicker(props) {
+    const { kind, scope, readTokens, groupId, org, value, onChange, disabled } = props;
+    const firestore = useFirestore();
+    const { data, status } = useFirestoreCollection(()=>scope ? query(collection(firestore, scope[0], scope[1], CRM_RECORD_COLLECTIONS[kind]), ...crmVisibleToClause(readTokens), orderBy('updatedAt', 'desc'), limit(CRM_RECORD_PICKER_LIMIT)) : null, [
+        firestore,
+        scope,
+        readTokens,
+        kind
+    ], {
+        idField: '$id'
+    });
+    const options = useMemo(()=>(data != null ? data : []).map((row)=>({
+                id: row.$id,
+                label: crmRecordName(kind, row, groupId != null ? groupId : contactPrimaryGroup(row, org).groupId) || row.$id
+            })).sort((a, b)=>a.label.localeCompare(b.label)), [
+        data,
+        kind,
+        groupId,
+        org
+    ]);
+    /*
+   * The linked record may sit outside the window — an old contact a record
+   * page's button linked — so the value is a placeholder carrying its id
+   * until (unless) the window turns out to hold it.
+   */ const selected = useMemo(()=>{
+        var _options_find;
+        if (!value) return null;
+        return (_options_find = options.find((option)=>option.id === value)) != null ? _options_find : {
+            id: value,
+            label: value
+        };
+    }, [
+        options,
+        value
+    ]);
+    return /*#__PURE__*/ _jsx(Autocomplete, {
+        options: options,
+        value: selected,
+        onChange: (_event, next)=>{
+            var _ref;
+            return onChange((_ref = next == null ? void 0 : next.id) != null ? _ref : null);
+        },
+        getOptionLabel: (option)=>option.label,
+        isOptionEqualToValue: (option, current)=>option.id === current.id,
+        loading: status === 'loading',
+        disabled: disabled,
+        size: "small",
+        renderInput: (params)=>/*#__PURE__*/ _jsx(TextField, _extends({}, params, {
+                label: PICKER_LABELS[kind],
+                helperText: options.length >= CRM_RECORD_PICKER_LIMIT ? `The ${CRM_RECORD_PICKER_LIMIT} most recently updated — type to narrow.` : undefined
+            }))
+    });
+}
+CrmRecordPicker.displayName = 'CrmRecordPicker';
+export default CrmRecordPicker;
+
+//# sourceMappingURL=crm-record-picker.js.map

package/src/lib/components/crm-record-picker.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/crm/src/lib/components/crm-record-picker.tsx"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n'use client'\n\nimport {\n  useFirestore,\n  useFirestoreCollection,\n} from '@aglyn/tenant-feature-instance'\nimport { Autocomplete, TextField } from '@mui/material'\nimport { collection, limit, orderBy, query } from 'firebase/firestore'\nimport { useMemo } from 'react'\nimport {\n  CRM_RECORD_COLLECTIONS,\n  type CrmRecordKind,\n  crmRecordName,\n} from '../hooks/use-crm-record-names'\nimport { crmVisibleToClause } from '../hooks/use-crm-scope'\nimport { contactPrimaryGroup } from '../model/contact-record'\n\n/**\n * How many records a picker offers. The window is the hundred most recently\n * touched, which is the hundred a person is most likely to be making a task\n * about; the field says so, and the record pages' own \"New task\" buttons\n * arrive with the record already linked, which is how a task about an older\n * one gets made.\n */\nexport const CRM_RECORD_PICKER_LIMIT = 100\n\nconst PICKER_LABELS: Record<CrmRecordKind, string> = {\n  contact: 'Contact',\n  company: 'Company',\n  deal: 'Deal',\n}\n\nexport interface CrmRecordPickerProps {\n  kind: CrmRecordKind\n  scope: readonly [string, string] | null\n  /** The reader's tokens, or `null` at the organization level — no clause (AGL-2630). */\n  readTokens: readonly string[] | null\n  /**\n   * The viewing group, for a contact's facet name — or `null` at the\n   * organization level, where each contact is named through its own\n   * primary holder (`contactPrimaryGroup`), resolved from {@link org}.\n   */\n  groupId: string | null\n  /** The org document, for the per-contact holder when {@link groupId} is null. */\n  org?: Record<string, unknown> | null\n  value: string | null\n  onChange: (id: string | null) => void\n  disabled?: boolean\n}\n\n/**\n * Link a task to a contact, company or deal by name (AGL-2599).\n *\n * One query shape for all three kinds — the most recently updated hundred\n * visible to this site, filtered as the person types — because that is the\n * one shape every CRM collection has an index for (`visibleTo, updatedAt`).\n * A prefix search on the stored name would need `(visibleTo, nameLower)`,\n * which companies have and contacts do not, and a picker that searched two\n * kinds properly and one kind not at all would be worse to explain than a\n * window. The listener opens with the drawer and closes with it.\n */\nexport function CrmRecordPicker(props: CrmRecordPickerProps) {\n  const { kind, scope, readTokens, groupId, org, value, onChange, disabled } = props\n  const firestore = useFirestore()\n  const { data, status } = useFirestoreCollection<Record<string, unknown> & { $id: string }>(\n    () =>\n      scope\n        ? query(\n            collection(firestore, scope[0], scope[1], CRM_RECORD_COLLECTIONS[kind]),\n            ...crmVisibleToClause(readTokens),\n            orderBy('updatedAt', 'desc'),\n            limit(CRM_RECORD_PICKER_LIMIT),\n          )\n        : null,\n    [firestore, scope, readTokens, kind],\n    { idField: '$id' },\n  )\n  const options = useMemo(\n    () =>\n      (data ?? [])\n        .map((row) => ({\n          id: row.$id,\n          label:\n            crmRecordName(\n              kind,\n              row,\n              groupId ?? contactPrimaryGroup(row, org).groupId,\n            ) || row.$id,\n        }))\n        .sort((a, b) => a.label.localeCompare(b.label)),\n    [data, kind, groupId, org],\n  )\n  /*\n   * The linked record may sit outside the window — an old contact a record\n   * page's button linked — so the value is a placeholder carrying its id\n   * until (unless) the window turns out to hold it.\n   */\n  const selected = useMemo(() => {\n    if (!value) return null\n    return options.find((option) => option.id === value) ?? { id: value, label: value }\n  }, [options, value])\n\n  return (\n    <Autocomplete\n      options={options}\n      value={selected}\n      onChange={(_event, next) => onChange(next?.id ?? null)}\n      getOptionLabel={(option) => option.label}\n      isOptionEqualToValue={(option, current) => option.id === current.id}\n      loading={status === 'loading'}\n      disabled={disabled}\n      size=\"small\"\n      renderInput={(params) => (\n        <TextField\n          {...params}\n          label={PICKER_LABELS[kind]}\n          helperText={\n            options.length >= CRM_RECORD_PICKER_LIMIT\n              ? `The ${CRM_RECORD_PICKER_LIMIT} most recently updated — type to narrow.`\n              : undefined\n          }\n        />\n      )}\n    />\n  )\n}\nCrmRecordPicker.displayName = 'CrmRecordPicker'\n\nexport default CrmRecordPicker\n"],"names":["useFirestore","useFirestoreCollection","Autocomplete","TextField","collection","limit","orderBy","query","useMemo","CRM_RECORD_COLLECTIONS","crmRecordName","crmVisibleToClause","contactPrimaryGroup","CRM_RECORD_PICKER_LIMIT","PICKER_LABELS","contact","company","deal","CrmRecordPicker","props","kind","scope","readTokens","groupId","org","value","onChange","disabled","firestore","data","status","idField","options","map","row","id","$id","label","sort","a","b","localeCompare","selected","find","option","_event","next","getOptionLabel","isOptionEqualToValue","current","loading","size","renderInput","params","helperText","length","undefined","displayName"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GACD;;;AAEA,SACEA,YAAY,EACZC,sBAAsB,QACjB,iCAAgC;AACvC,SAASC,YAAY,EAAEC,SAAS,QAAQ,gBAAe;AACvD,SAASC,UAAU,EAAEC,KAAK,EAAEC,OAAO,EAAEC,KAAK,QAAQ,qBAAoB;AACtE,SAASC,OAAO,QAAQ,QAAO;AAC/B,SACEC,sBAAsB,EAEtBC,aAAa,QACR,mCAA+B;AACtC,SAASC,kBAAkB,QAAQ,4BAAwB;AAC3D,SAASC,mBAAmB,QAAQ,6BAAyB;AAE7D;;;;;;CAMC,GACD,OAAO,MAAMC,0BAA0B,IAAG;AAE1C,MAAMC,gBAA+C;IACnDC,SAAS;IACTC,SAAS;IACTC,MAAM;AACR;AAoBA;;;;;;;;;;CAUC,GACD,OAAO,SAASC,gBAAgBC,KAA2B;IACzD,MAAM,EAAEC,IAAI,EAAEC,KAAK,EAAEC,UAAU,EAAEC,OAAO,EAAEC,GAAG,EAAEC,KAAK,EAAEC,QAAQ,EAAEC,QAAQ,EAAE,GAAGR;IAC7E,MAAMS,YAAY5B;IAClB,MAAM,EAAE6B,IAAI,EAAEC,MAAM,EAAE,GAAG7B,uBACvB,IACEoB,QACId,MACEH,WAAWwB,WAAWP,KAAK,CAAC,EAAE,EAAEA,KAAK,CAAC,EAAE,EAAEZ,sBAAsB,CAACW,KAAK,MACnET,mBAAmBW,aACtBhB,QAAQ,aAAa,SACrBD,MAAMQ,4BAER,MACN;QAACe;QAAWP;QAAOC;QAAYF;KAAK,EACpC;QAAEW,SAAS;IAAM;IAEnB,MAAMC,UAAUxB,QACd,IACE,CAACqB,eAAAA,OAAQ,EAAE,EACRI,GAAG,CAAC,CAACC,MAAS,CAAA;gBACbC,IAAID,IAAIE,GAAG;gBACXC,OACE3B,cACEU,MACAc,KACAX,kBAAAA,UAAWX,oBAAoBsB,KAAKV,KAAKD,OAAO,KAC7CW,IAAIE,GAAG;YAChB,CAAA,GACCE,IAAI,CAAC,CAACC,GAAGC,IAAMD,EAAEF,KAAK,CAACI,aAAa,CAACD,EAAEH,KAAK,IACjD;QAACR;QAAMT;QAAMG;QAASC;KAAI;IAE5B;;;;GAIC,GACD,MAAMkB,WAAWlC,QAAQ;YAEhBwB;QADP,IAAI,CAACP,OAAO,OAAO;QACnB,QAAOO,gBAAAA,QAAQW,IAAI,CAAC,CAACC,SAAWA,OAAOT,EAAE,KAAKV,kBAAvCO,gBAAiD;YAAEG,IAAIV;YAAOY,OAAOZ;QAAM;IACpF,GAAG;QAACO;QAASP;KAAM;IAEnB,qBACE,KAACvB;QACC8B,SAASA;QACTP,OAAOiB;QACPhB,UAAU,CAACmB,QAAQC;;mBAASpB,iBAASoB,wBAAAA,KAAMX,EAAE,mBAAI;;QACjDY,gBAAgB,CAACH,SAAWA,OAAOP,KAAK;QACxCW,sBAAsB,CAACJ,QAAQK,UAAYL,OAAOT,EAAE,KAAKc,QAAQd,EAAE;QACnEe,SAASpB,WAAW;QACpBH,UAAUA;QACVwB,MAAK;QACLC,aAAa,CAACC,uBACZ,KAAClD,wBACKkD;gBACJhB,OAAOvB,aAAa,CAACM,KAAK;gBAC1BkC,YACEtB,QAAQuB,MAAM,IAAI1C,0BACd,CAAC,IAAI,EAAEA,wBAAwB,wCAAwC,CAAC,GACxE2C;;;AAMhB;AACAtC,gBAAgBuC,WAAW,GAAG;AAE9B,eAAevC,gBAAe"}

package/src/lib/components/crm-send-email-button.d.ts

@@ -0,0 +1,39 @@
+import type { AglynOrgBilling } from '@aglyn/aglyn';
+export interface CrmSendEmailButtonProps {
+    /**
+     * The site the message leaves from — passed in, never read off the URL.
+     * At the organization level the record's own capturing site (AGL-2630),
+     * or `null` for a record no site has captured: beneath the org hub's
+     * mount the dialog offers the org's sites to send from (AGL-2634), and
+     * only a surface mounted nowhere holds the button.
+     */
+    hostId: string | null;
+    org?: Partial<AglynOrgBilling> | null;
+    contactId?: string;
+    leadId?: string;
+    dealId?: string;
+    /** The record's address, when the page holds it. */
+    email?: string | null;
+    name?: string | null;
+    /**
+     * The org's plan lacks the CRM, whose act one-to-one email is
+     * (AGL-2788): the button stands locked where it would be, and no dialog
+     * opens.
+     */
+    suiteLocked?: boolean;
+}
+/**
+ * The **Send email** action a record page carries (AGL-2615): one button,
+ * and the dialog it opens, mounted only while open.
+ *
+ * One component file so a record page adds the action with one import and
+ * one line, whichever header the page draws its actions in. Disabled, with
+ * the reason, for a record that names nobody to write to — a deal with no
+ * contact, a contact with no address — rather than opening a dialog whose
+ * To field is blank.
+ */
+export declare function CrmSendEmailButton(props: CrmSendEmailButtonProps): import("react").JSX.Element;
+export declare namespace CrmSendEmailButton {
+    var displayName: string;
+}
+export default CrmSendEmailButton;

package/src/lib/components/crm-send-email-button.js

@@ -0,0 +1,81 @@
+/**
+ * @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 { Button, Tooltip } from "@mui/material";
+import { useState } from "react";
+import { useCrmOrgMount } from "../hooks/use-crm-org-mount.js";
+import CrmSendEmailDialog from "./crm-send-email-dialog.js";
+import { CrmSuiteLockedButton } from "./crm-suite-lock.js";
+/**
+ * The **Send email** action a record page carries (AGL-2615): one button,
+ * and the dialog it opens, mounted only while open.
+ *
+ * One component file so a record page adds the action with one import and
+ * one line, whichever header the page draws its actions in. Disabled, with
+ * the reason, for a record that names nobody to write to — a deal with no
+ * contact, a contact with no address — rather than opening a dialog whose
+ * To field is blank.
+ */ export function CrmSendEmailButton(props) {
+    const { hostId, org, contactId, leadId, dealId, email, name, suiteLocked = false } = props;
+    const [open, setOpen] = useState(false);
+    const address = String(email != null ? email : '').trim();
+    const orgMount = useCrmOrgMount();
+    if (suiteLocked) {
+        return /*#__PURE__*/ _jsx(CrmSuiteLockedButton, {
+            variant: "outlined",
+            children: 'Send email'
+        });
+    }
+    // A site to send from, or an org whose sites the dialog can offer.
+    const canSend = Boolean(hostId) || Boolean(orgMount);
+    // A contact can be read for its address on open; a deal names one or
+    // nothing; a lead carries its own.
+    const reachable = canSend && (Boolean(address) || Boolean(contactId));
+    const reason = !reachable ? !canSend ? 'No site has captured this record to send from' : dealId && !contactId ? 'This deal names no contact to email' : 'This record has no email address' : '';
+    const button = /*#__PURE__*/ _jsx(Button, {
+        size: "small",
+        variant: "outlined",
+        disabled: !reachable,
+        onClick: ()=>setOpen(true),
+        children: 'Send email'
+    });
+    return /*#__PURE__*/ _jsxs(_Fragment, {
+        children: [
+            reason ? /*#__PURE__*/ _jsx(Tooltip, {
+                title: reason,
+                children: /*#__PURE__*/ _jsx("span", {
+                    children: button
+                })
+            }) : button,
+            open ? /*#__PURE__*/ _jsx(CrmSendEmailDialog, {
+                open: true,
+                onClose: ()=>setOpen(false),
+                hostId: hostId,
+                org: org,
+                contactId: contactId,
+                leadId: leadId,
+                dealId: dealId,
+                email: address || null,
+                name: name
+            }) : null
+        ]
+    });
+}
+CrmSendEmailButton.displayName = 'CrmSendEmailButton';
+export default CrmSendEmailButton;
+
+//# sourceMappingURL=crm-send-email-button.js.map

package/src/lib/components/crm-send-email-button.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/crm/src/lib/components/crm-send-email-button.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 { AglynOrgBilling } from '@aglyn/aglyn'\nimport { Button, Tooltip } from '@mui/material'\nimport { useState } from 'react'\nimport { useCrmOrgMount } from '../hooks/use-crm-org-mount'\nimport CrmSendEmailDialog from './crm-send-email-dialog'\nimport { CrmSuiteLockedButton } from './crm-suite-lock'\n\nexport interface CrmSendEmailButtonProps {\n  /**\n   * The site the message leaves from — passed in, never read off the URL.\n   * At the organization level the record's own capturing site (AGL-2630),\n   * or `null` for a record no site has captured: beneath the org hub's\n   * mount the dialog offers the org's sites to send from (AGL-2634), and\n   * only a surface mounted nowhere holds the button.\n   */\n  hostId: string | null\n  org?: Partial<AglynOrgBilling> | null\n  contactId?: string\n  leadId?: string\n  dealId?: string\n  /** The record's address, when the page holds it. */\n  email?: string | null\n  name?: string | null\n  /**\n   * The org's plan lacks the CRM, whose act one-to-one email is\n   * (AGL-2788): the button stands locked where it would be, and no dialog\n   * opens.\n   */\n  suiteLocked?: boolean\n}\n\n/**\n * The **Send email** action a record page carries (AGL-2615): one button,\n * and the dialog it opens, mounted only while open.\n *\n * One component file so a record page adds the action with one import and\n * one line, whichever header the page draws its actions in. Disabled, with\n * the reason, for a record that names nobody to write to — a deal with no\n * contact, a contact with no address — rather than opening a dialog whose\n * To field is blank.\n */\nexport function CrmSendEmailButton(props: CrmSendEmailButtonProps) {\n  const { hostId, org, contactId, leadId, dealId, email, name, suiteLocked = false } = props\n  const [open, setOpen] = useState(false)\n  const address = String(email ?? '').trim()\n  const orgMount = useCrmOrgMount()\n  if (suiteLocked) {\n    return <CrmSuiteLockedButton variant=\"outlined\">{'Send email'}</CrmSuiteLockedButton>\n  }\n  // A site to send from, or an org whose sites the dialog can offer.\n  const canSend = Boolean(hostId) || Boolean(orgMount)\n  // A contact can be read for its address on open; a deal names one or\n  // nothing; a lead carries its own.\n  const reachable = canSend && (Boolean(address) || Boolean(contactId))\n  const reason = !reachable\n    ? !canSend\n      ? 'No site has captured this record to send from'\n      : dealId && !contactId\n        ? 'This deal names no contact to email'\n        : 'This record has no email address'\n    : ''\n  const button = (\n    <Button\n      size=\"small\"\n      variant=\"outlined\"\n      disabled={!reachable}\n      onClick={() => setOpen(true)}\n    >\n      {'Send email'}\n    </Button>\n  )\n  return (\n    <>\n      {reason ? (\n        <Tooltip title={reason}>\n          <span>{button}</span>\n        </Tooltip>\n      ) : (\n        button\n      )}\n      {open ? (\n        <CrmSendEmailDialog\n          open\n          onClose={() => setOpen(false)}\n          hostId={hostId}\n          org={org}\n          contactId={contactId}\n          leadId={leadId}\n          dealId={dealId}\n          email={address || null}\n          name={name}\n        />\n      ) : null}\n    </>\n  )\n}\nCrmSendEmailButton.displayName = 'CrmSendEmailButton'\n\nexport default CrmSendEmailButton\n"],"names":["Button","Tooltip","useState","useCrmOrgMount","CrmSendEmailDialog","CrmSuiteLockedButton","CrmSendEmailButton","props","hostId","org","contactId","leadId","dealId","email","name","suiteLocked","open","setOpen","address","String","trim","orgMount","variant","canSend","Boolean","reachable","reason","button","size","disabled","onClick","title","span","onClose","displayName"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GACD;;AAGA,SAASA,MAAM,EAAEC,OAAO,QAAQ,gBAAe;AAC/C,SAASC,QAAQ,QAAQ,QAAO;AAChC,SAASC,cAAc,QAAQ,gCAA4B;AAC3D,OAAOC,wBAAwB,6BAAyB;AACxD,SAASC,oBAAoB,QAAQ,sBAAkB;AA0BvD;;;;;;;;;CASC,GACD,OAAO,SAASC,mBAAmBC,KAA8B;IAC/D,MAAM,EAAEC,MAAM,EAAEC,GAAG,EAAEC,SAAS,EAAEC,MAAM,EAAEC,MAAM,EAAEC,KAAK,EAAEC,IAAI,EAAEC,cAAc,KAAK,EAAE,GAAGR;IACrF,MAAM,CAACS,MAAMC,QAAQ,GAAGf,SAAS;IACjC,MAAMgB,UAAUC,OAAON,gBAAAA,QAAS,IAAIO,IAAI;IACxC,MAAMC,WAAWlB;IACjB,IAAIY,aAAa;QACf,qBAAO,KAACV;YAAqBiB,SAAQ;sBAAY;;IACnD;IACA,mEAAmE;IACnE,MAAMC,UAAUC,QAAQhB,WAAWgB,QAAQH;IAC3C,qEAAqE;IACrE,mCAAmC;IACnC,MAAMI,YAAYF,WAAYC,CAAAA,QAAQN,YAAYM,QAAQd,UAAS;IACnE,MAAMgB,SAAS,CAACD,YACZ,CAACF,UACC,kDACAX,UAAU,CAACF,YACT,wCACA,qCACJ;IACJ,MAAMiB,uBACJ,KAAC3B;QACC4B,MAAK;QACLN,SAAQ;QACRO,UAAU,CAACJ;QACXK,SAAS,IAAMb,QAAQ;kBAEtB;;IAGL,qBACE;;YACGS,uBACC,KAACzB;gBAAQ8B,OAAOL;0BACd,cAAA,KAACM;8BAAML;;iBAGTA;YAEDX,qBACC,KAACZ;gBACCY,IAAI;gBACJiB,SAAS,IAAMhB,QAAQ;gBACvBT,QAAQA;gBACRC,KAAKA;gBACLC,WAAWA;gBACXC,QAAQA;gBACRC,QAAQA;gBACRC,OAAOK,WAAW;gBAClBJ,MAAMA;iBAEN;;;AAGV;AACAR,mBAAmB4B,WAAW,GAAG;AAEjC,eAAe5B,mBAAkB"}

package/src/lib/components/crm-send-email-dialog.d.ts

@@ -0,0 +1,61 @@
+import { type AglynOrgBilling } from '@aglyn/aglyn';
+export interface CrmSendEmailDialogProps {
+    open: boolean;
+    onClose: () => void;
+    /**
+     * The site the message leaves from — passed in, never assumed from the
+     * URL. At the organization level the record's own capturing site, or
+     * `null` for a record no site has captured (AGL-2634): the dialog then
+     * offers the org's sites to send from, defaulting to the reader's pick.
+     */
+    hostId: string | null;
+    /** The org the shell passed; lets a deal's contact be read without a lookup. */
+    org?: Partial<AglynOrgBilling> | null;
+    contactId?: string;
+    leadId?: string;
+    dealId?: string;
+    /**
+     * The recipient as the record shows it. A deal's page holds no address,
+     * so a caller with only a `contactId` may leave this out and the dialog
+     * reads it off the contact when it opens.
+     */
+    email?: string | null;
+    /** What the dialog says it is writing to, beside the address. */
+    name?: string | null;
+    /** Told once the route has accepted the message. */
+    onSent?: (result: {
+        activityId: string;
+    }) => void;
+}
+/**
+ * One email to one person, from their record (AGL-2615).
+ *
+ * ## What the reader sees, and what they cannot change
+ *
+ * To is the record's address and is read-only: the route resolves the
+ * recipient off the record again, so an editable field here would be a
+ * promise the server does not keep. From is the site's sending identity as
+ * the sending-identity route reports it — the same answer the campaign
+ * composer prints — and when that route refuses, the dialog says why and
+ * points at **Emails › Sending** rather than offering a Send button that
+ * 409s. Reply-to is the signed-in user's own address, because a reply to a
+ * relationship email belongs in the inbox of the person who wrote it, not
+ * the site's shared mailbox. Subject and Body are the whole of what a
+ * person writes; the body is plain paragraphs, and the email design system
+ * is deliberately not here — this is a letter, not a campaign.
+ *
+ * ## A refusal stays on screen
+ *
+ * The route's refusals — the daily cap, a suppressed address, a stated
+ * refusal, the ceiling — are answers the rep should read, so they render
+ * inside the dialog with the draft intact rather than as a toast over a
+ * closed one. Only a send the provider accepted closes it.
+ *
+ * Mounted on open by its button, so the identity request and the contact
+ * read happen when somebody asks and not on every record page paint.
+ */
+export declare function CrmSendEmailDialog(props: CrmSendEmailDialogProps): import("react").JSX.Element;
+export declare namespace CrmSendEmailDialog {
+    var displayName: string;
+}
+export default CrmSendEmailDialog;