@aglyn/plugins-crm 1.0.0-beta.143

package/src/lib/components/assignment-rule-drawer.js

@@ -0,0 +1,293 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ 'use client';
+import { _ as _extends } from "@swc/helpers/_/_extends";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { CONTACT_SOURCE_LABELS, newAssignmentRuleId, readCrmAssignmentRule } from "@aglyn/aglyn";
+import { Button, Drawer, FormControl, FormControlLabel, FormHelperText, FormLabel, MenuItem, Radio, RadioGroup, Stack, TextField, Typography } from "@mui/material";
+import { useCallback, useEffect, useState } from "react";
+/** The `value` of the source picker's "any door" entry. */ const ANY_SOURCE = '';
+/**
+ * The one form an assignment rule is written through (AGL-2618).
+ *
+ * ## Every condition is optional, and none is a form above the list
+ *
+ * A rule names the captures it claims — a source, a form, an email domain,
+ * a tag — and a field left blank is not a condition, so a rule with every
+ * field blank is the catch-all, which is a rule a team writes on purpose
+ * ("everything else goes to Sam"). The drawer says so rather than refusing
+ * it. The email domain is typed the way a person sees one in an address,
+ * `@acme.com` or `acme.com`, and the reader strips the `@`; what it cannot
+ * read as a domain is refused here, with the field, rather than stored as
+ * a condition nothing will ever match.
+ *
+ * ## The target is a member, or the rotation
+ *
+ * A member is picked from the roster by name, never typed as an address —
+ * an address is resolved at run time and a rule must not depend on a
+ * resolution that can change. The rotation is offered whatever the pool
+ * holds, with the pool's size beside it: an empty pool is a rule the pass
+ * steps over until somebody fills the pool, which the card below explains,
+ * and refusing the rule here would make the two cards order-dependent.
+ */ export function AssignmentRuleDrawer(props) {
+    var _readCrmAssignmentRule;
+    const { open, onClose, members, membersLoading, poolSize, existingIds, onSubmit } = props;
+    const [source, setSource] = useState(ANY_SOURCE);
+    const [formId, setFormId] = useState('');
+    const [emailDomain, setEmailDomain] = useState('');
+    const [tag, setTag] = useState('');
+    const [target, setTarget] = useState('member');
+    const [memberUid, setMemberUid] = useState('');
+    const [busy, setBusy] = useState(false);
+    const [error, setError] = useState(null);
+    // Seeded on every open, so a drawer that was cancelled halfway does not
+    // offer the abandoned draft as the next rule.
+    useEffect(()=>{
+        if (!open) return;
+        setSource(ANY_SOURCE);
+        setFormId('');
+        setEmailDomain('');
+        setTag('');
+        setTarget('member');
+        setMemberUid('');
+        setBusy(false);
+        setError(null);
+    }, [
+        open
+    ]);
+    const domainTyped = emailDomain.trim().length > 0;
+    const domainReadable = !domainTyped || ((_readCrmAssignmentRule = readCrmAssignmentRule({
+        id: 'probe',
+        when: {
+            emailDomain
+        },
+        assign: {
+            roundRobin: true
+        }
+    })) == null ? void 0 : _readCrmAssignmentRule.when.emailDomain) !== undefined;
+    const canSubmit = !busy && domainReadable && (target === 'roundRobin' || memberUid.length > 0);
+    const handleSubmit = useCallback(async ()=>{
+        if (!canSubmit) return;
+        const rule = readCrmAssignmentRule({
+            id: newAssignmentRuleId(existingIds),
+            when: _extends({}, source ? {
+                source
+            } : {}, formId.trim() ? {
+                formId: formId.trim()
+            } : {}, emailDomain.trim() ? {
+                emailDomain: emailDomain.trim()
+            } : {}, tag.trim() ? {
+                tag: tag.trim()
+            } : {}),
+            assign: target === 'roundRobin' ? {
+                roundRobin: true
+            } : {
+                memberUid
+            }
+        });
+        if (!rule) {
+            setError('The rule could not be read back. Check each field.');
+            return;
+        }
+        setBusy(true);
+        setError(null);
+        try {
+            await onSubmit(rule);
+        } catch (caught) {
+            console.error(caught);
+            setError('Could not save the rule. Try again.');
+        } finally{
+            setBusy(false);
+        }
+    }, [
+        canSubmit,
+        existingIds,
+        source,
+        formId,
+        emailDomain,
+        tag,
+        target,
+        memberUid,
+        onSubmit
+    ]);
+    const conditions = [
+        source,
+        formId.trim(),
+        emailDomain.trim(),
+        tag.trim()
+    ].filter(Boolean);
+    return /*#__PURE__*/ _jsx(Drawer, {
+        anchor: "right",
+        open: open,
+        onClose: onClose,
+        children: /*#__PURE__*/ _jsxs(Stack, {
+            spacing: 2,
+            sx: {
+                width: 380,
+                p: 3
+            },
+            children: [
+                /*#__PURE__*/ _jsx(Typography, {
+                    variant: "h6",
+                    children: 'New assignment rule'
+                }),
+                /*#__PURE__*/ _jsx(Typography, {
+                    variant: "body2",
+                    color: "text.secondary",
+                    children: 'When a new contact matches every condition below, it is assigned ' + 'as the rule says. Leave every condition blank for a rule that ' + 'catches everything the rules above it did not.'
+                }),
+                /*#__PURE__*/ _jsxs(TextField, {
+                    select: true,
+                    size: "small",
+                    label: "Source",
+                    value: source,
+                    onChange: (event)=>setSource(event.target.value),
+                    fullWidth: true,
+                    children: [
+                        /*#__PURE__*/ _jsx(MenuItem, {
+                            value: ANY_SOURCE,
+                            children: 'Any source'
+                        }),
+                        Object.keys(CONTACT_SOURCE_LABELS).map((option)=>/*#__PURE__*/ _jsx(MenuItem, {
+                                value: option,
+                                children: CONTACT_SOURCE_LABELS[option]
+                            }, option))
+                    ]
+                }),
+                /*#__PURE__*/ _jsx(TextField, {
+                    size: "small",
+                    label: "Form",
+                    value: formId,
+                    onChange: (event)=>setFormId(event.target.value),
+                    helperText: "The form's id, from its address in Forms. Blank for any form.",
+                    slotProps: {
+                        htmlInput: {
+                            maxLength: 128,
+                            spellCheck: false
+                        }
+                    },
+                    fullWidth: true
+                }),
+                /*#__PURE__*/ _jsx(TextField, {
+                    size: "small",
+                    label: "Email domain",
+                    value: emailDomain,
+                    onChange: (event)=>setEmailDomain(event.target.value),
+                    error: !domainReadable,
+                    helperText: domainReadable ? 'acme.com — the domain of the captured address. Public mailboxes such as gmail.com count.' : 'That does not look like a domain.',
+                    slotProps: {
+                        htmlInput: {
+                            maxLength: 253,
+                            spellCheck: false
+                        }
+                    },
+                    fullWidth: true
+                }),
+                /*#__PURE__*/ _jsx(TextField, {
+                    size: "small",
+                    label: "Tag",
+                    value: tag,
+                    onChange: (event)=>setTag(event.target.value),
+                    helperText: "A tag the capture carries, or the contact already has.",
+                    slotProps: {
+                        htmlInput: {
+                            maxLength: 60
+                        }
+                    },
+                    fullWidth: true
+                }),
+                /*#__PURE__*/ _jsxs(FormControl, {
+                    children: [
+                        /*#__PURE__*/ _jsx(FormLabel, {
+                            id: "assignment-rule-target",
+                            children: 'Assign to'
+                        }),
+                        /*#__PURE__*/ _jsxs(RadioGroup, {
+                            "aria-labelledby": "assignment-rule-target",
+                            value: target,
+                            onChange: (event)=>setTarget(event.target.value === 'roundRobin' ? 'roundRobin' : 'member'),
+                            children: [
+                                /*#__PURE__*/ _jsx(FormControlLabel, {
+                                    value: "member",
+                                    control: /*#__PURE__*/ _jsx(Radio, {
+                                        size: "small"
+                                    }),
+                                    label: "A team member"
+                                }),
+                                /*#__PURE__*/ _jsx(FormControlLabel, {
+                                    value: "roundRobin",
+                                    control: /*#__PURE__*/ _jsx(Radio, {
+                                        size: "small"
+                                    }),
+                                    label: "Round robin — the next member of the pool"
+                                })
+                            ]
+                        }),
+                        target === 'roundRobin' ? /*#__PURE__*/ _jsx(FormHelperText, {
+                            children: poolSize > 0 ? `The pool has ${poolSize} ${poolSize === 1 ? 'member' : 'members'}; each new contact goes to the next in turn.` : 'The pool is empty. This rule is skipped until somebody is added to it below.'
+                        }) : null
+                    ]
+                }),
+                target === 'member' ? /*#__PURE__*/ _jsx(TextField, {
+                    select: true,
+                    size: "small",
+                    label: "Member",
+                    value: memberUid,
+                    onChange: (event)=>setMemberUid(event.target.value),
+                    disabled: membersLoading,
+                    helperText: membersLoading ? 'Loading the team…' : members.length ? undefined : 'The team could not be listed.',
+                    fullWidth: true,
+                    children: members.map((member)=>/*#__PURE__*/ _jsx(MenuItem, {
+                            value: member.uid,
+                            children: member.label
+                        }, member.uid))
+                }) : null,
+                conditions.length === 0 ? /*#__PURE__*/ _jsx(Typography, {
+                    variant: "caption",
+                    color: "text.secondary",
+                    children: 'No conditions: this rule matches every new contact the rules above it did not claim.'
+                }) : null,
+                error ? /*#__PURE__*/ _jsx(Typography, {
+                    variant: "body2",
+                    color: "error",
+                    children: error
+                }) : null,
+                /*#__PURE__*/ _jsxs(Stack, {
+                    direction: "row",
+                    spacing: 1,
+                    children: [
+                        /*#__PURE__*/ _jsx(Button, {
+                            variant: "contained",
+                            color: "primary",
+                            disabled: !canSubmit,
+                            onClick: handleSubmit,
+                            children: 'Add rule'
+                        }),
+                        /*#__PURE__*/ _jsx(Button, {
+                            onClick: onClose,
+                            disabled: busy,
+                            children: 'Cancel'
+                        })
+                    ]
+                })
+            ]
+        })
+    });
+}
+AssignmentRuleDrawer.displayName = 'AssignmentRuleDrawer';
+export default AssignmentRuleDrawer;
+
+//# sourceMappingURL=assignment-rule-drawer.js.map

package/src/lib/components/assignment-rule-drawer.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/crm/src/lib/components/assignment-rule-drawer.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  CONTACT_SOURCE_LABELS,\n  type ContactSource,\n  type CrmAssignmentRule,\n  newAssignmentRuleId,\n  readCrmAssignmentRule,\n} from '@aglyn/aglyn'\nimport {\n  Button,\n  Drawer,\n  FormControl,\n  FormControlLabel,\n  FormHelperText,\n  FormLabel,\n  MenuItem,\n  Radio,\n  RadioGroup,\n  Stack,\n  TextField,\n  Typography,\n} from '@mui/material'\nimport { useCallback, useEffect, useState } from 'react'\nimport type { OrgMemberOption } from '../hooks/use-org-member-directory'\n\n/** The `value` of the source picker's \"any door\" entry. */\nconst ANY_SOURCE = ''\n\nexport interface AssignmentRuleDrawerProps {\n  open: boolean\n  onClose: () => void\n  /** The roster the member target is picked from. */\n  members: readonly OrgMemberOption[]\n  membersLoading: boolean\n  /** How many people the round-robin pool holds, for the target's helper text. */\n  poolSize: number\n  /** The ids the org already holds, so the new one is minted apart from them. */\n  existingIds: readonly string[]\n  /** Receives the rule; closing on success is the caller's job. */\n  onSubmit: (rule: CrmAssignmentRule) => Promise<void> | void\n}\n\n/**\n * The one form an assignment rule is written through (AGL-2618).\n *\n * ## Every condition is optional, and none is a form above the list\n *\n * A rule names the captures it claims — a source, a form, an email domain,\n * a tag — and a field left blank is not a condition, so a rule with every\n * field blank is the catch-all, which is a rule a team writes on purpose\n * (\"everything else goes to Sam\"). The drawer says so rather than refusing\n * it. The email domain is typed the way a person sees one in an address,\n * `@acme.com` or `acme.com`, and the reader strips the `@`; what it cannot\n * read as a domain is refused here, with the field, rather than stored as\n * a condition nothing will ever match.\n *\n * ## The target is a member, or the rotation\n *\n * A member is picked from the roster by name, never typed as an address —\n * an address is resolved at run time and a rule must not depend on a\n * resolution that can change. The rotation is offered whatever the pool\n * holds, with the pool's size beside it: an empty pool is a rule the pass\n * steps over until somebody fills the pool, which the card below explains,\n * and refusing the rule here would make the two cards order-dependent.\n */\nexport function AssignmentRuleDrawer(props: AssignmentRuleDrawerProps) {\n  const { open, onClose, members, membersLoading, poolSize, existingIds, onSubmit } =\n    props\n  const [source, setSource] = useState<string>(ANY_SOURCE)\n  const [formId, setFormId] = useState('')\n  const [emailDomain, setEmailDomain] = useState('')\n  const [tag, setTag] = useState('')\n  const [target, setTarget] = useState<'member' | 'roundRobin'>('member')\n  const [memberUid, setMemberUid] = useState('')\n  const [busy, setBusy] = useState(false)\n  const [error, setError] = useState<string | null>(null)\n\n  // Seeded on every open, so a drawer that was cancelled halfway does not\n  // offer the abandoned draft as the next rule.\n  useEffect(() => {\n    if (!open) return\n    setSource(ANY_SOURCE)\n    setFormId('')\n    setEmailDomain('')\n    setTag('')\n    setTarget('member')\n    setMemberUid('')\n    setBusy(false)\n    setError(null)\n  }, [open])\n\n  const domainTyped = emailDomain.trim().length > 0\n  const domainReadable =\n    !domainTyped ||\n    readCrmAssignmentRule({\n      id: 'probe',\n      when: { emailDomain },\n      assign: { roundRobin: true },\n    })?.when.emailDomain !== undefined\n  const canSubmit =\n    !busy && domainReadable && (target === 'roundRobin' || memberUid.length > 0)\n\n  const handleSubmit = useCallback(async () => {\n    if (!canSubmit) return\n    const rule = readCrmAssignmentRule({\n      id: newAssignmentRuleId(existingIds),\n      when: {\n        ...(source ? { source } : {}),\n        ...(formId.trim() ? { formId: formId.trim() } : {}),\n        ...(emailDomain.trim() ? { emailDomain: emailDomain.trim() } : {}),\n        ...(tag.trim() ? { tag: tag.trim() } : {}),\n      },\n      assign: target === 'roundRobin' ? { roundRobin: true } : { memberUid },\n    })\n    if (!rule) {\n      setError('The rule could not be read back. Check each field.')\n      return\n    }\n    setBusy(true)\n    setError(null)\n    try {\n      await onSubmit(rule)\n    } catch (caught) {\n      console.error(caught)\n      setError('Could not save the rule. Try again.')\n    } finally {\n      setBusy(false)\n    }\n  }, [canSubmit, existingIds, source, formId, emailDomain, tag, target, memberUid, onSubmit])\n\n  const conditions = [source, formId.trim(), emailDomain.trim(), tag.trim()].filter(Boolean)\n\n  return (\n    <Drawer anchor=\"right\" open={open} onClose={onClose}>\n      <Stack spacing={2} sx={{ width: 380, p: 3 }}>\n        <Typography variant=\"h6\">{'New assignment rule'}</Typography>\n        <Typography variant=\"body2\" color=\"text.secondary\">\n          {'When a new contact matches every condition below, it is assigned ' +\n            'as the rule says. Leave every condition blank for a rule that ' +\n            'catches everything the rules above it did not.'}\n        </Typography>\n        <TextField\n          select\n          size=\"small\"\n          label=\"Source\"\n          value={source}\n          onChange={(event) => setSource(event.target.value)}\n          fullWidth\n        >\n          <MenuItem value={ANY_SOURCE}>{'Any source'}</MenuItem>\n          {(Object.keys(CONTACT_SOURCE_LABELS) as ContactSource[]).map((option) => (\n            <MenuItem key={option} value={option}>\n              {CONTACT_SOURCE_LABELS[option]}\n            </MenuItem>\n          ))}\n        </TextField>\n        <TextField\n          size=\"small\"\n          label=\"Form\"\n          value={formId}\n          onChange={(event) => setFormId(event.target.value)}\n          helperText=\"The form's id, from its address in Forms. Blank for any form.\"\n          slotProps={{ htmlInput: { maxLength: 128, spellCheck: false } }}\n          fullWidth\n        />\n        <TextField\n          size=\"small\"\n          label=\"Email domain\"\n          value={emailDomain}\n          onChange={(event) => setEmailDomain(event.target.value)}\n          error={!domainReadable}\n          helperText={\n            domainReadable\n              ? 'acme.com — the domain of the captured address. Public mailboxes such as gmail.com count.'\n              : 'That does not look like a domain.'\n          }\n          slotProps={{ htmlInput: { maxLength: 253, spellCheck: false } }}\n          fullWidth\n        />\n        <TextField\n          size=\"small\"\n          label=\"Tag\"\n          value={tag}\n          onChange={(event) => setTag(event.target.value)}\n          helperText=\"A tag the capture carries, or the contact already has.\"\n          slotProps={{ htmlInput: { maxLength: 60 } }}\n          fullWidth\n        />\n        <FormControl>\n          <FormLabel id=\"assignment-rule-target\">{'Assign to'}</FormLabel>\n          <RadioGroup\n            aria-labelledby=\"assignment-rule-target\"\n            value={target}\n            onChange={(event) =>\n              setTarget(event.target.value === 'roundRobin' ? 'roundRobin' : 'member')\n            }\n          >\n            <FormControlLabel value=\"member\" control={<Radio size=\"small\" />} label=\"A team member\" />\n            <FormControlLabel\n              value=\"roundRobin\"\n              control={<Radio size=\"small\" />}\n              label=\"Round robin — the next member of the pool\"\n            />\n          </RadioGroup>\n          {target === 'roundRobin' ? (\n            <FormHelperText>\n              {poolSize > 0\n                ? `The pool has ${poolSize} ${poolSize === 1 ? 'member' : 'members'}; each new contact goes to the next in turn.`\n                : 'The pool is empty. This rule is skipped until somebody is added to it below.'}\n            </FormHelperText>\n          ) : null}\n        </FormControl>\n        {target === 'member' ? (\n          <TextField\n            select\n            size=\"small\"\n            label=\"Member\"\n            value={memberUid}\n            onChange={(event) => setMemberUid(event.target.value)}\n            disabled={membersLoading}\n            helperText={\n              membersLoading\n                ? 'Loading the team…'\n                : members.length\n                  ? undefined\n                  : 'The team could not be listed.'\n            }\n            fullWidth\n          >\n            {members.map((member) => (\n              <MenuItem key={member.uid} value={member.uid}>\n                {member.label}\n              </MenuItem>\n            ))}\n          </TextField>\n        ) : null}\n        {conditions.length === 0 ? (\n          <Typography variant=\"caption\" color=\"text.secondary\">\n            {'No conditions: this rule matches every new contact the rules above it did not claim.'}\n          </Typography>\n        ) : null}\n        {error ? (\n          <Typography variant=\"body2\" color=\"error\">\n            {error}\n          </Typography>\n        ) : null}\n        <Stack direction=\"row\" spacing={1}>\n          <Button variant=\"contained\" color=\"primary\" disabled={!canSubmit} onClick={handleSubmit}>\n            {'Add rule'}\n          </Button>\n          <Button onClick={onClose} disabled={busy}>\n            {'Cancel'}\n          </Button>\n        </Stack>\n      </Stack>\n    </Drawer>\n  )\n}\nAssignmentRuleDrawer.displayName = 'AssignmentRuleDrawer'\n\nexport default AssignmentRuleDrawer\n"],"names":["CONTACT_SOURCE_LABELS","newAssignmentRuleId","readCrmAssignmentRule","Button","Drawer","FormControl","FormControlLabel","FormHelperText","FormLabel","MenuItem","Radio","RadioGroup","Stack","TextField","Typography","useCallback","useEffect","useState","ANY_SOURCE","AssignmentRuleDrawer","props","open","onClose","members","membersLoading","poolSize","existingIds","onSubmit","source","setSource","formId","setFormId","emailDomain","setEmailDomain","tag","setTag","target","setTarget","memberUid","setMemberUid","busy","setBusy","error","setError","domainTyped","trim","length","domainReadable","id","when","assign","roundRobin","undefined","canSubmit","handleSubmit","rule","caught","console","conditions","filter","Boolean","anchor","spacing","sx","width","p","variant","color","select","size","label","value","onChange","event","fullWidth","Object","keys","map","option","helperText","slotProps","htmlInput","maxLength","spellCheck","aria-labelledby","control","disabled","member","uid","direction","onClick","displayName"],"mappings":"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"}

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

@@ -0,0 +1,29 @@
+import type { OrgMemberOptions } from '../hooks/use-org-member-options';
+import { type CompanyBulkRow } from '../model/companies-bulk-writes';
+import { type CompanyCsvOptions, type CompanyCsvRow } from '../model/companies-csv';
+export interface CompaniesBulkBarProps {
+    /**
+     * The site whose activity feed the bar's acts are logged in, or `null`
+     * at the organization level (AGL-2630), where the selection spans sites
+     * and no one feed is written.
+     */
+    hostId: string | null;
+    /** `['orgs', orgId]`, or `null` while the org is unresolved. */
+    scope: readonly ['orgs', string] | null;
+    rows: readonly (CompanyBulkRow & CompanyCsvRow)[];
+    selected: readonly string[];
+    onSelectedChange: (ids: string[]) => void;
+    /** The section's roster — already read for the Owner column. */
+    members: OrgMemberOptions;
+    /** How the export names an owner — the table's own options. */
+    csv?: CompanyCsvOptions;
+}
+/**
+ * The bar, or nothing — a separate boundary so the body's hooks never run
+ * on the visit to the list that ticks no row.
+ */
+export declare function CompaniesBulkBar(props: CompaniesBulkBarProps): import("react").JSX.Element;
+export declare namespace CompaniesBulkBar {
+    var displayName: string;
+}
+export default CompaniesBulkBar;

package/src/lib/components/companies-bulk-bar.js

@@ -0,0 +1,274 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ 'use client';
+import { _ as _extends } from "@swc/helpers/_/_extends";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * The bar over the companies table, for whatever rows are ticked
+ * (AGL-2621).
+ *
+ * Tag or untag them, hand them to an owner, take them into a spreadsheet,
+ * or delete them. The patches come from `companies-bulk-writes.ts` and go
+ * through the shared runner; the delete is the record page's own
+ * `crm/company-delete`, per company, one after another — the route unlinks a
+ * company's contacts before it goes, and a company past the detach bound is
+ * left standing and NAMED, the way the page says it, so a second delete
+ * continues where this one stopped.
+ *
+ * ## The delete is logged, per company
+ *
+ * Each company that goes is one line in the site's activity feed, as it
+ * would be from its own page. A bulk delete of forty companies is forty
+ * acts and forty lines; a single "deleted 40 companies" line would name
+ * none of them, and the feed exists to answer "where did Acme go".
+ */ import { CRM_COLLECTIONS } from "@aglyn/aglyn";
+import { useConfirmationContext } from "@aglyn/shared-ui-jsx";
+import { useFirestore, useHostActivityLogger } from "@aglyn/tenant-feature-instance";
+import { Button, MenuItem, TextField } from "@mui/material";
+import { doc } from "firebase/firestore";
+import { useCallback, useMemo, useState } from "react";
+import { useCrmBulkApply } from "../hooks/use-crm-bulk-apply.js";
+import { planCompanyAddTag, planCompanyRemoveTag, planCompanySetOwner } from "../model/companies-bulk-writes.js";
+import { companiesCsv } from "../model/companies-csv.js";
+import { COMPANY_DETACH_LIMIT } from "../model/companies.js";
+import { deleteCompanyThroughRoute } from "../model/company-delete.js";
+import { normalizeBulkTag } from "../model/contacts-bulk-writes.js";
+import { downloadTextFile } from "../model/contacts-csv.js";
+import { crmBulkWriters, runCrmBulkCalls, runCrmBulkWrites } from "../model/crm-bulk-writes.js";
+import { CrmBulkBarFrame, CrmBulkValueDialog, countNoun } from "./crm-bulk-bar-frame.js";
+import CrmExportAllButton from "./crm-export-all-button.js";
+import { useCrmApi } from "./use-crm-api.js";
+const NOUN = {
+    singular: 'company',
+    plural: 'companies'
+};
+const ACTION_TITLES = {
+    'add-tag': 'Add a tag',
+    'remove-tag': 'Remove a tag',
+    owner: 'Set the owner'
+};
+const doneSentence = (action, done)=>{
+    const rows = countNoun(done, NOUN);
+    switch(action){
+        case 'add-tag':
+            return `Tagged ${rows}`;
+        case 'remove-tag':
+            return `Removed the tag from ${rows}`;
+        case 'owner':
+            return `Owner set on ${rows}`;
+    }
+};
+/**
+ * The bar, or nothing — a separate boundary so the body's hooks never run
+ * on the visit to the list that ticks no row.
+ */ export function CompaniesBulkBar(props) {
+    if (!props.selected.length) return null;
+    return /*#__PURE__*/ _jsx(CompaniesBulkBarBody, _extends({}, props));
+}
+CompaniesBulkBar.displayName = 'CompaniesBulkBar';
+function CompaniesBulkBarBody(props) {
+    var _members_error, _ref;
+    const { hostId, scope, rows, selected, onSelectedChange, members, csv } = props;
+    const firestore = useFirestore();
+    const { confirm } = useConfirmationContext();
+    const logActivity = useHostActivityLogger(hostId != null ? hostId : undefined);
+    const callCrm = useCrmApi(hostId);
+    const { busy, report, apply, dismissReport } = useCrmBulkApply({
+        recordKind: 'company'
+    });
+    const selectedRows = useMemo(()=>{
+        const chosen = new Set(selected);
+        return rows.filter((row)=>chosen.has(row.$id));
+    }, [
+        rows,
+        selected
+    ]);
+    const [pending, setPending] = useState(null);
+    const [value, setValue] = useState('');
+    const writers = useMemo(()=>crmBulkWriters(firestore, (id)=>{
+            var _ref, _ref1;
+            return doc(firestore, (_ref = scope == null ? void 0 : scope[0]) != null ? _ref : 'orgs', (_ref1 = scope == null ? void 0 : scope[1]) != null ? _ref1 : '', CRM_COLLECTIONS.companies, id);
+        }), [
+        firestore,
+        scope
+    ]);
+    const openAction = (action)=>{
+        setValue('');
+        setPending(action);
+    };
+    const runPlan = useCallback((action, plan)=>apply({
+            attempted: plan.writes.length,
+            skipped: plan.skipped,
+            job: ()=>runCrmBulkWrites(writers, plan.writes, (write)=>write.label),
+            done: (count)=>doneSentence(action, count)
+        }), [
+        apply,
+        writers
+    ]);
+    const handleApply = useCallback(async ()=>{
+        if (!pending || !scope) return;
+        const nowMs = Date.now();
+        const tag = normalizeBulkTag(value);
+        if (pending !== 'owner' && !tag) return;
+        const plan = pending === 'add-tag' ? planCompanyAddTag(selectedRows, tag != null ? tag : '', nowMs) : pending === 'remove-tag' ? planCompanyRemoveTag(selectedRows, tag != null ? tag : '', nowMs) : planCompanySetOwner(selectedRows, value || null, nowMs);
+        const action = pending;
+        setPending(null);
+        await runPlan(action, plan);
+    }, [
+        pending,
+        scope,
+        value,
+        selectedRows,
+        runPlan
+    ]);
+    const handleExport = useCallback(()=>{
+        downloadTextFile('companies-selected.csv', 'text/csv', companiesCsv(selectedRows, csv));
+    }, [
+        selectedRows,
+        csv
+    ]);
+    const handleDelete = useCallback(async ()=>{
+        if (!scope || !selectedRows.length) return;
+        const count = selectedRows.length;
+        const confirmed = await confirm({
+            title: count === 1 ? 'Delete this company?' : `Delete ${count} companies?`,
+            description: `${count === 1 ? 'It is' : 'They are'} removed from Companies and ` + 'unlinked from every contact at them. The contacts themselves are ' + 'kept, and so is anything else filed against the companies.',
+            confirmationText: count === 1 ? 'Delete company' : 'Delete companies',
+            confirmationButtonProps: {
+                color: 'error'
+            }
+        })// `confirm` resolves with no value and REJECTS on cancel.
+        .then(()=>true).catch(()=>false);
+        if (!confirmed) return;
+        const outcome = await apply({
+            attempted: count,
+            skipped: [],
+            job: ()=>runCrmBulkCalls(selectedRows, (row)=>String(row.name || row.$id), async (row)=>{
+                    const result = await deleteCompanyThroughRoute(callCrm, row.$id);
+                    if (!result.deleted) {
+                        throw new Error(`${COMPANY_DETACH_LIMIT.toLocaleString()} contacts were unlinked ` + 'and more remain — delete again to continue');
+                    }
+                    logActivity('Deleted company', {
+                        type: 'company',
+                        id: row.$id,
+                        name: row.name
+                    });
+                }),
+            done: (done)=>`Deleted ${countNoun(done, NOUN)}`
+        });
+        // The rows that went are gone from the table; the refused ones stay
+        // selected, so the reader can see which they are and try again.
+        const refused = new Set(outcome.refused.map((row)=>row.label));
+        onSelectedChange(selectedRows.filter((row)=>refused.has(String(row.name || row.$id))).map((row)=>row.$id));
+    }, [
+        scope,
+        selectedRows,
+        confirm,
+        apply,
+        callCrm,
+        logActivity,
+        onSelectedChange
+    ]);
+    return /*#__PURE__*/ _jsxs(CrmBulkBarFrame, {
+        count: selected.length,
+        noun: NOUN,
+        busy: busy,
+        onClear: ()=>onSelectedChange([]),
+        report: report,
+        onDismissReport: dismissReport,
+        extras: /*#__PURE__*/ _jsx(CrmBulkValueDialog, {
+            open: pending !== null,
+            title: pending ? ACTION_TITLES[pending] : '',
+            count: selected.length,
+            noun: NOUN,
+            busy: busy,
+            canApply: pending === 'owner' || Boolean(normalizeBulkTag(value)),
+            onClose: ()=>setPending(null),
+            onApply: ()=>void handleApply(),
+            children: pending === 'add-tag' || pending === 'remove-tag' ? /*#__PURE__*/ _jsx(TextField, {
+                autoFocus: true,
+                size: "small",
+                label: "Tag",
+                placeholder: "enterprise",
+                value: value,
+                onChange: (event)=>setValue(event.target.value),
+                helperText: pending === 'add-tag' ? 'Lowercased, like the tags on a company' : 'Removed wherever it is present'
+            }) : pending === 'owner' ? /*#__PURE__*/ _jsxs(TextField, {
+                select: true,
+                size: "small",
+                label: "Owner",
+                value: value,
+                onChange: (event)=>setValue(event.target.value),
+                disabled: !members.ready,
+                error: Boolean(members.error),
+                helperText: (_members_error = members.error) != null ? _members_error : members.ready ? undefined : 'Loading the team…',
+                children: [
+                    /*#__PURE__*/ _jsx(MenuItem, {
+                        value: "",
+                        children: 'Nobody — clear the owner'
+                    }),
+                    members.options.map((member)=>/*#__PURE__*/ _jsx(MenuItem, {
+                            value: member.uid,
+                            children: member.label
+                        }, member.uid))
+                ]
+            }) : null
+        }),
+        children: [
+            /*#__PURE__*/ _jsx(Button, {
+                size: "small",
+                disabled: busy || !scope,
+                onClick: ()=>openAction('add-tag'),
+                children: 'Add tag'
+            }),
+            /*#__PURE__*/ _jsx(Button, {
+                size: "small",
+                disabled: busy || !scope,
+                onClick: ()=>openAction('remove-tag'),
+                children: 'Remove tag'
+            }),
+            /*#__PURE__*/ _jsx(Button, {
+                size: "small",
+                disabled: busy || !scope,
+                onClick: ()=>openAction('owner'),
+                children: 'Set owner'
+            }),
+            /*#__PURE__*/ _jsx(Button, {
+                size: "small",
+                disabled: busy,
+                onClick: handleExport,
+                children: 'Export CSV'
+            }),
+            /*#__PURE__*/ _jsx(CrmExportAllButton, {
+                resource: "companies",
+                orgId: (_ref = scope == null ? void 0 : scope[1]) != null ? _ref : null,
+                hostId: hostId,
+                disabled: busy
+            }),
+            /*#__PURE__*/ _jsx(Button, {
+                size: "small",
+                color: "error",
+                disabled: busy || !scope,
+                onClick: ()=>void handleDelete(),
+                children: 'Delete'
+            })
+        ]
+    });
+}
+CompaniesBulkBarBody.displayName = 'CompaniesBulkBarBody';
+export default CompaniesBulkBar;
+
+//# sourceMappingURL=companies-bulk-bar.js.map