@aglyn/plugins-commerce 1.0.0-beta.290 → 1.0.0-beta.292

package/src/lib/components/console/quote-send.component.js

@@ -0,0 +1,304 @@
+/**
+ * @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 CommerceModel from "../../model/index.js";
+import { commerceSitePermissionRefusal } from "../../model/plugin-permissions.js";
+import { siteContactEmail, resolveHostToken } from "@aglyn/aglyn/app-utils/host-tokens";
+import { BlockedControl } from "@aglyn/shared-ui-jsx/components/blocked-control.component";
+import { useSnackbar } from "@aglyn/shared-ui-snackstack";
+import { authorizedFetch } from "@aglyn/shared-util-http/authorized-token";
+import { useFirestore, useFirestoreDoc, useUser } from "@aglyn/tenant-feature-instance";
+import { Button, Dialog, DialogActions, DialogContent, DialogTitle, Stack, TextField, Typography } from "@mui/material";
+import { doc } from "firebase/firestore";
+import { useCallback, useEffect, useRef, useState } from "react";
+import { InvoiceSendDialog, invoiceSentLine } from "./invoice-send.component.js";
+const SEND_REFUSAL = commerceSitePermissionRefusal('commerce.quotes.send');
+/** `Oct 29, 2026, 3:04 PM`. */ const sentAt = (atMs)=>new Date(atMs).toLocaleString('en-US', {
+        dateStyle: 'medium',
+        timeStyle: 'short'
+    });
+/**
+ * Emailing the quote to the customer (AGL-4097): when it was last sent and to
+ * whom, and Send quote, Send again or Send revision N, which opens a short
+ * form (To, Subject, Message). The server writes the email in the site's
+ * look with the proof, the PDF and the pay button, in the customer's
+ * conversation with the business.
+ *
+ * Send invoice (AGL-4099) sits beside it: for an unpaid quote, an invoice for
+ * a customer who needs one to pay (with the same pay link); for a paid one,
+ * the invoice as their record. Both reply into the quote's conversation.
+ */ export function QuoteSendSection(props) {
+    var _resolveHostToken, _ref;
+    const { hostId, quoteId, quote, canSend, edited } = props;
+    const firestore = useFirestore();
+    const { data: user } = useUser();
+    const { enqueueSnackbar } = useSnackbar();
+    const { data: host } = useFirestoreDoc(()=>doc(firestore, 'hosts', hostId), [
+        firestore,
+        hostId
+    ]);
+    const businessName = String((_resolveHostToken = resolveHostToken('businessName', host != null ? host : {})) != null ? _resolveHostToken : '').trim();
+    const section = quote.quote;
+    const unpaid = CommerceModel.isUnpaidQuote(quote);
+    const last = CommerceModel.lastQuoteSend(section);
+    const revision = Number((_ref = section == null ? void 0 : section.revision) != null ? _ref : 1);
+    const label = CommerceModel.quoteSendLabel(section);
+    const replacesLink = CommerceModel.quoteSendReplacesLink(section);
+    const approvalFirst = CommerceModel.quotePaymentBlockedByApproval(section);
+    const proofCount = CommerceModel.currentQuoteProofs(section).length;
+    const listed = siteContactEmail(host);
+    const contact = listed && /^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(listed) ? listed : null;
+    const [open, setOpen] = useState(false);
+    const [invoicing, setInvoicing] = useState(false);
+    const invoiceLine = invoiceSentLine(quote);
+    const closed = quote.status === 'cancelled' || quote.status === 'refunded';
+    const [busy, setBusy] = useState(false);
+    const [to, setTo] = useState('');
+    const [subject, setSubject] = useState('');
+    const [message, setMessage] = useState('');
+    /*
+   * One attempt per form (AGL-1697's rule): a retried Send presents the same
+   * key and is answered from the first, so the customer never gets two; a
+   * changed form is a new attempt.
+   */ const attemptKey = useRef('');
+    useEffect(()=>{
+        attemptKey.current = '';
+    }, [
+        to,
+        subject,
+        message
+    ]);
+    const openForm = useCallback(()=>{
+        setTo(CommerceModel.quoteSendPrefill(quote));
+        setSubject(CommerceModel.quoteEmailDefaultSubject(quote, businessName, quoteId));
+        setMessage('');
+        setOpen(true);
+    }, [
+        quote,
+        businessName,
+        quoteId
+    ]);
+    const send = useCallback(async ()=>{
+        setBusy(true);
+        try {
+            var _payload_to;
+            if (!attemptKey.current) {
+                var _ref;
+                var _globalThis_crypto_randomUUID, _globalThis_crypto;
+                attemptKey.current = (_ref = (_globalThis_crypto = globalThis.crypto) == null ? void 0 : (_globalThis_crypto_randomUUID = _globalThis_crypto.randomUUID) == null ? void 0 : _globalThis_crypto_randomUUID.call(_globalThis_crypto)) != null ? _ref : `${Date.now()}-${Math.random().toString(36).slice(2)}`;
+            }
+            const response = await authorizedFetch(user, '/api/commerce/quote', {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'Idempotency-Key': attemptKey.current
+                },
+                body: JSON.stringify({
+                    action: 'send',
+                    hostId,
+                    quoteId,
+                    to,
+                    subject,
+                    message
+                })
+            });
+            const payload = await response.json().catch(()=>({}));
+            if (!response.ok) {
+                var _ref1;
+                return void enqueueSnackbar((_ref1 = payload == null ? void 0 : payload.error) != null ? _ref1 : 'The quote could not be sent', {
+                    variant: 'error',
+                    allowDuplicate: true
+                });
+            }
+            enqueueSnackbar(`${CommerceModel.formatQuoteNumber(quote, quoteId)} sent to ${String((_payload_to = payload.to) != null ? _payload_to : to)}` + (payload.linkReplaced ? '. The link in your earlier email no longer opens the quote.' : ''), {
+                variant: 'success',
+                persist: false
+            });
+            setOpen(false);
+        } finally{
+            setBusy(false);
+        }
+    }, [
+        user,
+        hostId,
+        quoteId,
+        to,
+        subject,
+        message,
+        quote,
+        enqueueSnackbar
+    ]);
+    const status = last ? `Sent ${sentAt(Number(last.atMs))} to ${last.to || 'the customer'}` + (Number(last.revision) < revision ? ` (revision ${last.revision})` : '') + '.' : 'Not sent yet. Email it with your message, the proof and the PDF, or copy the pay link below and send it yourself.';
+    return /*#__PURE__*/ _jsxs(Stack, {
+        spacing: 1.5,
+        children: [
+            /*#__PURE__*/ _jsxs(Stack, {
+                spacing: 0.5,
+                children: [
+                    /*#__PURE__*/ _jsx(Typography, {
+                        variant: "subtitle2",
+                        children: 'Email to customer'
+                    }),
+                    /*#__PURE__*/ _jsx(Typography, {
+                        variant: "body2",
+                        color: "text.secondary",
+                        children: unpaid ? status : last ? status : 'This quote was paid without being emailed.'
+                    }),
+                    unpaid && replacesLink ? /*#__PURE__*/ _jsx(Typography, {
+                        variant: "body2",
+                        color: "text.secondary",
+                        children: `Sending revision ${revision} gives your customer a new pay link. The link in your earlier email will say the quote was updated.`
+                    }) : null,
+                    unpaid && edited ? /*#__PURE__*/ _jsx(Typography, {
+                        variant: "body2",
+                        color: "text.secondary",
+                        children: 'Save your changes first: the email shows the quote as it was last saved.'
+                    }) : null,
+                    invoiceLine ? /*#__PURE__*/ _jsx(Typography, {
+                        variant: "body2",
+                        color: "text.secondary",
+                        children: invoiceLine
+                    }) : null
+                ]
+            }),
+            !closed ? /*#__PURE__*/ _jsxs(Stack, {
+                direction: "row",
+                spacing: 1,
+                children: [
+                    unpaid ? /*#__PURE__*/ _jsx(BlockedControl, {
+                        blocked: !canSend,
+                        reason: SEND_REFUSAL,
+                        children: /*#__PURE__*/ _jsx(Button, {
+                            variant: "contained",
+                            size: "small",
+                            disabled: busy || edited,
+                            onClick: openForm,
+                            children: label
+                        })
+                    }) : null,
+                    /*#__PURE__*/ _jsx(BlockedControl, {
+                        blocked: !canSend,
+                        reason: SEND_REFUSAL,
+                        children: /*#__PURE__*/ _jsx(Button, {
+                            variant: unpaid ? 'outlined' : 'contained',
+                            size: "small",
+                            disabled: busy || unpaid && edited,
+                            onClick: ()=>setInvoicing(true),
+                            children: 'Send invoice'
+                        })
+                    })
+                ]
+            }) : null,
+            /*#__PURE__*/ _jsx(InvoiceSendDialog, {
+                open: invoicing,
+                onClose: ()=>setInvoicing(false),
+                hostId: hostId,
+                orderId: quoteId,
+                order: quote
+            }),
+            /*#__PURE__*/ _jsxs(Dialog, {
+                open: open,
+                onClose: busy ? undefined : ()=>setOpen(false),
+                maxWidth: "sm",
+                fullWidth: true,
+                "aria-labelledby": "quote-send-title",
+                children: [
+                    /*#__PURE__*/ _jsx(DialogTitle, {
+                        id: "quote-send-title",
+                        children: `${label}: ${CommerceModel.formatQuoteNumber(quote, quoteId)}`
+                    }),
+                    /*#__PURE__*/ _jsx(DialogContent, {
+                        children: /*#__PURE__*/ _jsxs(Stack, {
+                            spacing: 2,
+                            sx: {
+                                pt: 1
+                            },
+                            children: [
+                                /*#__PURE__*/ _jsx(TextField, {
+                                    label: "To",
+                                    type: "email",
+                                    value: to,
+                                    onChange: (event)=>setTo(event.target.value),
+                                    required: true,
+                                    fullWidth: true,
+                                    disabled: busy
+                                }),
+                                /*#__PURE__*/ _jsx(TextField, {
+                                    label: "Subject",
+                                    value: subject,
+                                    onChange: (event)=>setSubject(event.target.value),
+                                    fullWidth: true,
+                                    disabled: busy,
+                                    slotProps: {
+                                        htmlInput: {
+                                            maxLength: CommerceModel.QUOTE_MAX_SEND_SUBJECT
+                                        }
+                                    },
+                                    helperText: (section == null ? void 0 : section.emailThread) ? 'Keep the subject the same to keep these emails in one conversation in your customer’s inbox.' : undefined
+                                }),
+                                /*#__PURE__*/ _jsx(TextField, {
+                                    label: "Message",
+                                    value: message,
+                                    onChange: (event)=>setMessage(event.target.value),
+                                    multiline: true,
+                                    minRows: 4,
+                                    fullWidth: true,
+                                    disabled: busy,
+                                    slotProps: {
+                                        htmlInput: {
+                                            maxLength: CommerceModel.QUOTE_MAX_SEND_MESSAGE
+                                        }
+                                    },
+                                    helperText: "Shown at the top of the email, in your words."
+                                }),
+                                /*#__PURE__*/ _jsx(Typography, {
+                                    variant: "body2",
+                                    color: "text.secondary",
+                                    children: `The email shows the quote number, revision ${revision} and total` + (proofCount ? ', the proof' : '') + `, with the quote attached as a PDF and a button to ${approvalFirst ? 'approve the proof' : 'pay'} on your site. ` + `Replies go to ${contact || 'your email'}.`
+                                }),
+                                replacesLink ? /*#__PURE__*/ _jsx(Typography, {
+                                    variant: "body2",
+                                    color: "text.secondary",
+                                    children: 'This sends a new pay link. The link in your earlier email will say the quote was updated.'
+                                }) : null
+                            ]
+                        })
+                    }),
+                    /*#__PURE__*/ _jsxs(DialogActions, {
+                        children: [
+                            /*#__PURE__*/ _jsx(Button, {
+                                onClick: ()=>setOpen(false),
+                                disabled: busy,
+                                children: 'Cancel'
+                            }),
+                            /*#__PURE__*/ _jsx(Button, {
+                                variant: "contained",
+                                disabled: busy || !to.trim(),
+                                onClick: ()=>void send(),
+                                children: busy ? 'Sending…' : 'Send'
+                            })
+                        ]
+                    })
+                ]
+            })
+        ]
+    });
+}
+QuoteSendSection.displayName = 'QuoteSendSection';
+export default QuoteSendSection;
+
+//# sourceMappingURL=quote-send.component.js.map

package/src/lib/components/console/quote-send.component.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../libs/plugins/commerce/src/lib/components/console/quote-send.component.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\n'use client'\n\nimport * as CommerceModel from '../../model'\nimport { commerceSitePermissionRefusal } from '../../model/plugin-permissions'\nimport { siteContactEmail, resolveHostToken, type HostTokenSource } from '@aglyn/aglyn/app-utils/host-tokens'\nimport { BlockedControl } from '@aglyn/shared-ui-jsx/components/blocked-control.component'\nimport { useSnackbar } from '@aglyn/shared-ui-snackstack'\nimport { authorizedFetch } from '@aglyn/shared-util-http/authorized-token'\nimport { useFirestore, useFirestoreDoc, useUser } from '@aglyn/tenant-feature-instance'\nimport {\n  Button,\n  Dialog,\n  DialogActions,\n  DialogContent,\n  DialogTitle,\n  Stack,\n  TextField,\n  Typography,\n} from '@mui/material'\nimport { doc } from 'firebase/firestore'\nimport { useCallback, useEffect, useRef, useState } from 'react'\nimport { InvoiceSendDialog, invoiceSentLine } from './invoice-send.component'\n\nconst SEND_REFUSAL = commerceSitePermissionRefusal('commerce.quotes.send')\n\nexport interface QuoteSendSectionProps {\n  hostId: string\n  quoteId: string\n  quote: CommerceModel.HostOrder\n  /** Holds \"Send quotes and invoices to customers\" (`commerce.quotes.send`). */\n  canSend: boolean\n  /** The editor holds changes not saved yet, which the email would not show. */\n  edited: boolean\n}\n\n/** `Oct 29, 2026, 3:04 PM`. */\nconst sentAt = (atMs: number) =>\n  new Date(atMs).toLocaleString('en-US', { dateStyle: 'medium', timeStyle: 'short' })\n\n/**\n * Emailing the quote to the customer (AGL-4097): when it was last sent and to\n * whom, and Send quote, Send again or Send revision N, which opens a short\n * form (To, Subject, Message). The server writes the email in the site's\n * look with the proof, the PDF and the pay button, in the customer's\n * conversation with the business.\n *\n * Send invoice (AGL-4099) sits beside it: for an unpaid quote, an invoice for\n * a customer who needs one to pay (with the same pay link); for a paid one,\n * the invoice as their record. Both reply into the quote's conversation.\n */\nexport function QuoteSendSection(props: QuoteSendSectionProps) {\n  const { hostId, quoteId, quote, canSend, edited } = props\n  const firestore = useFirestore()\n  const { data: user } = useUser()\n  const { enqueueSnackbar } = useSnackbar()\n  const { data: host } = useFirestoreDoc<Record<string, unknown>>(\n    () => doc(firestore, 'hosts', hostId),\n    [firestore, hostId],\n  )\n  const businessName = String(resolveHostToken('businessName', (host ?? {}) as HostTokenSource) ?? '').trim()\n  const section = quote.quote\n  const unpaid = CommerceModel.isUnpaidQuote(quote)\n  const last = CommerceModel.lastQuoteSend(section)\n  const revision = Number(section?.revision ?? 1)\n  const label = CommerceModel.quoteSendLabel(section)\n  const replacesLink = CommerceModel.quoteSendReplacesLink(section)\n  const approvalFirst = CommerceModel.quotePaymentBlockedByApproval(section)\n  const proofCount = CommerceModel.currentQuoteProofs(section).length\n  const listed = siteContactEmail(host as never)\n  const contact = listed && /^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$/.test(listed) ? listed : null\n\n  const [open, setOpen] = useState(false)\n  const [invoicing, setInvoicing] = useState(false)\n  const invoiceLine = invoiceSentLine(quote)\n  const closed = quote.status === 'cancelled' || quote.status === 'refunded'\n  const [busy, setBusy] = useState(false)\n  const [to, setTo] = useState('')\n  const [subject, setSubject] = useState('')\n  const [message, setMessage] = useState('')\n\n  /*\n   * One attempt per form (AGL-1697's rule): a retried Send presents the same\n   * key and is answered from the first, so the customer never gets two; a\n   * changed form is a new attempt.\n   */\n  const attemptKey = useRef('')\n  useEffect(() => {\n    attemptKey.current = ''\n  }, [to, subject, message])\n\n  const openForm = useCallback(() => {\n    setTo(CommerceModel.quoteSendPrefill(quote))\n    setSubject(CommerceModel.quoteEmailDefaultSubject(quote, businessName, quoteId))\n    setMessage('')\n    setOpen(true)\n  }, [quote, businessName, quoteId])\n\n  const send = useCallback(async () => {\n    setBusy(true)\n    try {\n      if (!attemptKey.current) {\n        attemptKey.current = globalThis.crypto?.randomUUID?.() ?? `${Date.now()}-${Math.random().toString(36).slice(2)}`\n      }\n      const response = await authorizedFetch(user, '/api/commerce/quote', {\n        method: 'POST',\n        headers: { 'Content-Type': 'application/json', 'Idempotency-Key': attemptKey.current },\n        body: JSON.stringify({ action: 'send', hostId, quoteId, to, subject, message }),\n      })\n      const payload = await response.json().catch(() => ({}))\n      if (!response.ok) {\n        return void enqueueSnackbar(payload?.error ?? 'The quote could not be sent', { variant: 'error', allowDuplicate: true })\n      }\n      enqueueSnackbar(\n        `${CommerceModel.formatQuoteNumber(quote, quoteId)} sent to ${String(payload.to ?? to)}` +\n          (payload.linkReplaced ? '. The link in your earlier email no longer opens the quote.' : ''),\n        { variant: 'success', persist: false },\n      )\n      setOpen(false)\n    } finally {\n      setBusy(false)\n    }\n  }, [user, hostId, quoteId, to, subject, message, quote, enqueueSnackbar])\n\n  const status = last\n    ? `Sent ${sentAt(Number(last.atMs))} to ${last.to || 'the customer'}` +\n      (Number(last.revision) < revision ? ` (revision ${last.revision})` : '') +\n      '.'\n    : 'Not sent yet. Email it with your message, the proof and the PDF, or copy the pay link below and send it yourself.'\n\n  return (\n    <Stack spacing={1.5}>\n      <Stack spacing={0.5}>\n        <Typography variant=\"subtitle2\">{'Email to customer'}</Typography>\n        <Typography variant=\"body2\" color=\"text.secondary\">\n          {unpaid ? status : last ? status : 'This quote was paid without being emailed.'}\n        </Typography>\n        {unpaid && replacesLink ? (\n          <Typography variant=\"body2\" color=\"text.secondary\">\n            {`Sending revision ${revision} gives your customer a new pay link. The link in your earlier email will say the quote was updated.`}\n          </Typography>\n        ) : null}\n        {unpaid && edited ? (\n          <Typography variant=\"body2\" color=\"text.secondary\">\n            {'Save your changes first: the email shows the quote as it was last saved.'}\n          </Typography>\n        ) : null}\n        {invoiceLine ? (\n          <Typography variant=\"body2\" color=\"text.secondary\">\n            {invoiceLine}\n          </Typography>\n        ) : null}\n      </Stack>\n      {!closed ? (\n        <Stack direction=\"row\" spacing={1}>\n          {unpaid ? (\n            <BlockedControl blocked={!canSend} reason={SEND_REFUSAL}>\n              <Button variant=\"contained\" size=\"small\" disabled={busy || edited} onClick={openForm}>\n                {label}\n              </Button>\n            </BlockedControl>\n          ) : null}\n          <BlockedControl blocked={!canSend} reason={SEND_REFUSAL}>\n            <Button\n              variant={unpaid ? 'outlined' : 'contained'}\n              size=\"small\"\n              disabled={busy || (unpaid && edited)}\n              onClick={() => setInvoicing(true)}\n            >\n              {'Send invoice'}\n            </Button>\n          </BlockedControl>\n        </Stack>\n      ) : null}\n      <InvoiceSendDialog\n        open={invoicing}\n        onClose={() => setInvoicing(false)}\n        hostId={hostId}\n        orderId={quoteId}\n        order={quote}\n      />\n      <Dialog open={open} onClose={busy ? undefined : () => setOpen(false)} maxWidth=\"sm\" fullWidth aria-labelledby=\"quote-send-title\">\n        <DialogTitle id=\"quote-send-title\">{`${label}: ${CommerceModel.formatQuoteNumber(quote, quoteId)}`}</DialogTitle>\n        <DialogContent>\n          <Stack spacing={2} sx={{ pt: 1 }}>\n            <TextField\n              label=\"To\"\n              type=\"email\"\n              value={to}\n              onChange={(event) => setTo(event.target.value)}\n              required\n              fullWidth\n              disabled={busy}\n            />\n            <TextField\n              label=\"Subject\"\n              value={subject}\n              onChange={(event) => setSubject(event.target.value)}\n              fullWidth\n              disabled={busy}\n              slotProps={{ htmlInput: { maxLength: CommerceModel.QUOTE_MAX_SEND_SUBJECT } }}\n              helperText={\n                section?.emailThread\n                  ? 'Keep the subject the same to keep these emails in one conversation in your customer’s inbox.'\n                  : undefined\n              }\n            />\n            <TextField\n              label=\"Message\"\n              value={message}\n              onChange={(event) => setMessage(event.target.value)}\n              multiline\n              minRows={4}\n              fullWidth\n              disabled={busy}\n              slotProps={{ htmlInput: { maxLength: CommerceModel.QUOTE_MAX_SEND_MESSAGE } }}\n              helperText=\"Shown at the top of the email, in your words.\"\n            />\n            <Typography variant=\"body2\" color=\"text.secondary\">\n              {`The email shows the quote number, revision ${revision} and total` +\n                (proofCount ? ', the proof' : '') +\n                `, with the quote attached as a PDF and a button to ${approvalFirst ? 'approve the proof' : 'pay'} on your site. ` +\n                `Replies go to ${contact || 'your email'}.`}\n            </Typography>\n            {replacesLink ? (\n              <Typography variant=\"body2\" color=\"text.secondary\">\n                {'This sends a new pay link. The link in your earlier email will say the quote was updated.'}\n              </Typography>\n            ) : null}\n          </Stack>\n        </DialogContent>\n        <DialogActions>\n          <Button onClick={() => setOpen(false)} disabled={busy}>\n            {'Cancel'}\n          </Button>\n          <Button variant=\"contained\" disabled={busy || !to.trim()} onClick={() => void send()}>\n            {busy ? 'Sending…' : 'Send'}\n          </Button>\n        </DialogActions>\n      </Dialog>\n    </Stack>\n  )\n}\nQuoteSendSection.displayName = 'QuoteSendSection'\n\nexport default QuoteSendSection\n"],"names":["CommerceModel","commerceSitePermissionRefusal","siteContactEmail","resolveHostToken","BlockedControl","useSnackbar","authorizedFetch","useFirestore","useFirestoreDoc","useUser","Button","Dialog","DialogActions","DialogContent","DialogTitle","Stack","TextField","Typography","doc","useCallback","useEffect","useRef","useState","InvoiceSendDialog","invoiceSentLine","SEND_REFUSAL","sentAt","atMs","Date","toLocaleString","dateStyle","timeStyle","QuoteSendSection","props","hostId","quoteId","quote","canSend","edited","firestore","data","user","enqueueSnackbar","host","businessName","String","trim","section","unpaid","isUnpaidQuote","last","lastQuoteSend","revision","Number","label","quoteSendLabel","replacesLink","quoteSendReplacesLink","approvalFirst","quotePaymentBlockedByApproval","proofCount","currentQuoteProofs","length","listed","contact","test","open","setOpen","invoicing","setInvoicing","invoiceLine","closed","status","busy","setBusy","to","setTo","subject","setSubject","message","setMessage","attemptKey","current","openForm","quoteSendPrefill","quoteEmailDefaultSubject","send","payload","globalThis","crypto","randomUUID","now","Math","random","toString","slice","response","method","headers","body","JSON","stringify","action","json","catch","ok","error","variant","allowDuplicate","formatQuoteNumber","linkReplaced","persist","spacing","color","direction","blocked","reason","size","disabled","onClick","onClose","orderId","order","undefined","maxWidth","fullWidth","aria-labelledby","id","sx","pt","type","value","onChange","event","target","required","slotProps","htmlInput","maxLength","QUOTE_MAX_SEND_SUBJECT","helperText","emailThread","multiline","minRows","QUOTE_MAX_SEND_MESSAGE","displayName"],"mappings":"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"}

package/src/lib/components/console/quote-start.component.d.ts

@@ -0,0 +1,45 @@
+/**
+ * @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.
+ */
+/** The Inbox zone's props, restated: this plugin may not import the Inbox. */
+export interface QuoteStartFromRequestProps {
+    hostId: string;
+    submissionId: string;
+    requestKind: string | null;
+    formName: string;
+}
+/** The CRM zone's props, restated: this plugin may not import the CRM. */
+export interface QuoteStartFromContactProps {
+    hostId: string | null;
+    orgId: string | undefined;
+    kind: 'contact' | 'lead';
+    recordId: string;
+    name: string;
+    email: string | null;
+    phone: string;
+    company: string;
+}
+/** "Start a quote" on an open quote request in the Inbox. */
+export declare function QuoteStartFromRequest(props: QuoteStartFromRequestProps): import("react").JSX.Element;
+export declare namespace QuoteStartFromRequest {
+    var displayName: string;
+}
+/** "Start a quote" in a contact's header in the CRM. */
+export declare function QuoteStartFromContact(props: QuoteStartFromContactProps): import("react").JSX.Element;
+export declare namespace QuoteStartFromContact {
+    var displayName: string;
+}
+export default QuoteStartFromRequest;

package/src/lib/components/console/quote-start.component.js

@@ -0,0 +1,182 @@
+/**
+ * @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 { useSnackbar } from "@aglyn/shared-ui-snackstack";
+import { authorizedFetch } from "@aglyn/shared-util-http/authorized-token";
+import { ceilingedWindow, collectionCeiling, useFirestore, useFirestoreCollection, useUser } from "@aglyn/tenant-feature-instance";
+import { Button } from "@mui/material";
+import { collection } from "firebase/firestore";
+import { useCallback, useMemo, useState } from "react";
+import QuoteEditorDialog from "./quote-editor-dialog.component.js";
+/*==========================================
+ * START A QUOTE FROM SOMEWHERE ELSE (AGL-4098).
+ *
+ * Two widgets in other plugins' zones, each a button that opens the quote
+ * editor already filled in:
+ *
+ *  - on an open submission in the Inbox (`inboxSubmissionActions`), for a
+ *    quote request: the editor asks this plugin's route for the request's
+ *    prefill (`start-from-request`), which reads the request through the
+ *    forms plugin's facts for the member asking;
+ *  - in a contact's header in the CRM (`crmRecordActions`): the person as the
+ *    page shows them is the quote's customer.
+ *
+ * Either way the quote is the editor's ordinary new quote, saved by the
+ * ordinary create under "Create and edit quotes"; the route refuses a member
+ * without it, in words naming the permission.
+ *=========================================*/ /** The products the editor's picker offers, as the Quotes card reads them. */ const PRODUCT_WINDOW = 200;
+/** The editor over the store's products, read only while it is open. */ function QuoteStartDialog(props) {
+    const { hostId, start, onClose } = props;
+    const firestore = useFirestore();
+    const { data: productDocs } = useFirestoreCollection(()=>collectionCeiling(collection(firestore, 'hosts', hostId, 'products'), PRODUCT_WINDOW), [
+        firestore,
+        hostId
+    ], {
+        idField: '$id'
+    });
+    const products = useMemo(()=>ceilingedWindow(productDocs != null ? productDocs : undefined, PRODUCT_WINDOW).rows.filter((product)=>!product['deletedAt']), [
+        productDocs
+    ]);
+    // The route decided the member may make quotes when it answered the start.
+    return /*#__PURE__*/ _jsx(QuoteEditorDialog, {
+        hostId: hostId,
+        quote: null,
+        products: products,
+        canEdit: true,
+        canSend: false,
+        start: start,
+        onClose: onClose
+    });
+}
+/** "Start a quote" on an open quote request in the Inbox. */ export function QuoteStartFromRequest(props) {
+    const { hostId, submissionId, requestKind } = props;
+    const { data: user } = useUser();
+    const { enqueueSnackbar } = useSnackbar();
+    const [busy, setBusy] = useState(false);
+    const [start, setStart] = useState(null);
+    const open = useCallback(async ()=>{
+        setBusy(true);
+        try {
+            var _payload_files;
+            const response = await authorizedFetch(user, '/api/commerce/quote', {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json'
+                },
+                body: JSON.stringify({
+                    action: 'start-from-request',
+                    hostId,
+                    submissionId
+                })
+            });
+            const payload = await response.json().catch(()=>({}));
+            if (!response.ok) {
+                var _ref;
+                return void enqueueSnackbar((_ref = payload == null ? void 0 : payload.error) != null ? _ref : 'The quote could not be started', {
+                    variant: 'error',
+                    allowDuplicate: true
+                });
+            }
+            setStart({
+                from: {
+                    kind: 'submission',
+                    id: submissionId
+                },
+                prefill: payload.prefill,
+                request: payload.request,
+                files: (_payload_files = payload.files) != null ? _payload_files : [],
+                threaded: payload.threaded === true
+            });
+        } catch (unused) {
+            enqueueSnackbar('The quote could not be started', {
+                variant: 'error',
+                allowDuplicate: true
+            });
+        } finally{
+            setBusy(false);
+        }
+    }, [
+        user,
+        hostId,
+        submissionId,
+        enqueueSnackbar
+    ]);
+    // Only a quote request has a quote to start.
+    if (requestKind !== 'quote' || !hostId) return null;
+    return /*#__PURE__*/ _jsxs(_Fragment, {
+        children: [
+            /*#__PURE__*/ _jsx(Button, {
+                variant: "outlined",
+                disabled: busy || !user,
+                onClick: ()=>void open(),
+                children: busy ? 'Starting…' : 'Start a quote'
+            }),
+            start ? /*#__PURE__*/ _jsx(QuoteStartDialog, {
+                hostId: hostId,
+                start: start,
+                onClose: ()=>setStart(null)
+            }) : null
+        ]
+    });
+}
+QuoteStartFromRequest.displayName = 'QuoteStartFromRequest';
+/** "Start a quote" in a contact's header in the CRM. */ export function QuoteStartFromContact(props) {
+    const { hostId, kind, recordId, name, email, phone, company } = props;
+    const [start, setStart] = useState(null);
+    // A quote is a site's: at the organization level with no site, there is none to start.
+    if (!hostId) return null;
+    return /*#__PURE__*/ _jsxs(_Fragment, {
+        children: [
+            /*#__PURE__*/ _jsx(Button, {
+                size: "small",
+                variant: "outlined",
+                onClick: ()=>setStart({
+                        from: null,
+                        prefill: {
+                            customer: _extends({
+                                record: {
+                                    kind,
+                                    id: recordId
+                                }
+                            }, name ? {
+                                name
+                            } : {}, email ? {
+                                email
+                            } : {}, phone ? {
+                                phone
+                            } : {}, company ? {
+                                company
+                            } : {}),
+                            lines: [],
+                            notes: ''
+                        }
+                    }),
+                children: 'Start a quote'
+            }),
+            start ? /*#__PURE__*/ _jsx(QuoteStartDialog, {
+                hostId: hostId,
+                start: start,
+                onClose: ()=>setStart(null)
+            }) : null
+        ]
+    });
+}
+QuoteStartFromContact.displayName = 'QuoteStartFromContact';
+export default QuoteStartFromRequest;
+
+//# sourceMappingURL=quote-start.component.js.map

package/src/lib/components/console/quote-start.component.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../libs/plugins/commerce/src/lib/components/console/quote-start.component.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\n'use client'\n\nimport { useSnackbar } from '@aglyn/shared-ui-snackstack'\nimport { authorizedFetch } from '@aglyn/shared-util-http/authorized-token'\nimport {\n  ceilingedWindow,\n  collectionCeiling,\n  useFirestore,\n  useFirestoreCollection,\n  useUser,\n} from '@aglyn/tenant-feature-instance'\nimport { Button } from '@mui/material'\nimport { collection } from 'firebase/firestore'\nimport { useCallback, useMemo, useState } from 'react'\nimport QuoteEditorDialog, { type QuoteEditorStart } from './quote-editor-dialog.component'\n\n/*==========================================\n * START A QUOTE FROM SOMEWHERE ELSE (AGL-4098).\n *\n * Two widgets in other plugins' zones, each a button that opens the quote\n * editor already filled in:\n *\n *  - on an open submission in the Inbox (`inboxSubmissionActions`), for a\n *    quote request: the editor asks this plugin's route for the request's\n *    prefill (`start-from-request`), which reads the request through the\n *    forms plugin's facts for the member asking;\n *  - in a contact's header in the CRM (`crmRecordActions`): the person as the\n *    page shows them is the quote's customer.\n *\n * Either way the quote is the editor's ordinary new quote, saved by the\n * ordinary create under \"Create and edit quotes\"; the route refuses a member\n * without it, in words naming the permission.\n *=========================================*/\n\n/** The products the editor's picker offers, as the Quotes card reads them. */\nconst PRODUCT_WINDOW = 200\n\n/** The Inbox zone's props, restated: this plugin may not import the Inbox. */\nexport interface QuoteStartFromRequestProps {\n  hostId: string\n  submissionId: string\n  requestKind: string | null\n  formName: string\n}\n\n/** The CRM zone's props, restated: this plugin may not import the CRM. */\nexport interface QuoteStartFromContactProps {\n  hostId: string | null\n  orgId: string | undefined\n  kind: 'contact' | 'lead'\n  recordId: string\n  name: string\n  email: string | null\n  phone: string\n  company: string\n}\n\n/** The editor over the store's products, read only while it is open. */\nfunction QuoteStartDialog(props: { hostId: string; start: QuoteEditorStart; onClose: () => void }) {\n  const { hostId, start, onClose } = props\n  const firestore = useFirestore()\n  const { data: productDocs } = useFirestoreCollection<Record<string, any>>(\n    () => collectionCeiling(collection(firestore, 'hosts', hostId, 'products'), PRODUCT_WINDOW),\n    [firestore, hostId],\n    { idField: '$id' },\n  )\n  const products = useMemo(\n    () =>\n      ceilingedWindow<Record<string, any>>(productDocs ?? undefined, PRODUCT_WINDOW).rows.filter(\n        (product) => !product['deletedAt'],\n      ),\n    [productDocs],\n  )\n  // The route decided the member may make quotes when it answered the start.\n  return (\n    <QuoteEditorDialog hostId={hostId} quote={null} products={products} canEdit canSend={false} start={start} onClose={onClose} />\n  )\n}\n\n/** \"Start a quote\" on an open quote request in the Inbox. */\nexport function QuoteStartFromRequest(props: QuoteStartFromRequestProps) {\n  const { hostId, submissionId, requestKind } = props\n  const { data: user } = useUser()\n  const { enqueueSnackbar } = useSnackbar()\n  const [busy, setBusy] = useState(false)\n  const [start, setStart] = useState<QuoteEditorStart | null>(null)\n\n  const open = useCallback(async () => {\n    setBusy(true)\n    try {\n      const response = await authorizedFetch(user, '/api/commerce/quote', {\n        method: 'POST',\n        headers: { 'Content-Type': 'application/json' },\n        body: JSON.stringify({ action: 'start-from-request', hostId, submissionId }),\n      })\n      const payload = await response.json().catch(() => ({}))\n      if (!response.ok) {\n        return void enqueueSnackbar(payload?.error ?? 'The quote could not be started', {\n          variant: 'error',\n          allowDuplicate: true,\n        })\n      }\n      setStart({\n        from: { kind: 'submission', id: submissionId },\n        prefill: payload.prefill,\n        request: payload.request,\n        files: payload.files ?? [],\n        threaded: payload.threaded === true,\n      })\n    } catch {\n      enqueueSnackbar('The quote could not be started', { variant: 'error', allowDuplicate: true })\n    } finally {\n      setBusy(false)\n    }\n  }, [user, hostId, submissionId, enqueueSnackbar])\n\n  // Only a quote request has a quote to start.\n  if (requestKind !== 'quote' || !hostId) return null\n  return (\n    <>\n      <Button variant=\"outlined\" disabled={busy || !user} onClick={() => void open()}>\n        {busy ? 'Starting…' : 'Start a quote'}\n      </Button>\n      {start ? <QuoteStartDialog hostId={hostId} start={start} onClose={() => setStart(null)} /> : null}\n    </>\n  )\n}\nQuoteStartFromRequest.displayName = 'QuoteStartFromRequest'\n\n/** \"Start a quote\" in a contact's header in the CRM. */\nexport function QuoteStartFromContact(props: QuoteStartFromContactProps) {\n  const { hostId, kind, recordId, name, email, phone, company } = props\n  const [start, setStart] = useState<QuoteEditorStart | null>(null)\n  // A quote is a site's: at the organization level with no site, there is none to start.\n  if (!hostId) return null\n  return (\n    <>\n      <Button\n        size=\"small\"\n        variant=\"outlined\"\n        onClick={() =>\n          setStart({\n            from: null,\n            prefill: {\n              customer: {\n                record: { kind, id: recordId },\n                ...(name ? { name } : {}),\n                ...(email ? { email } : {}),\n                ...(phone ? { phone } : {}),\n                ...(company ? { company } : {}),\n              },\n              lines: [],\n              notes: '',\n            },\n          })\n        }\n      >\n        {'Start a quote'}\n      </Button>\n      {start ? <QuoteStartDialog hostId={hostId} start={start} onClose={() => setStart(null)} /> : null}\n    </>\n  )\n}\nQuoteStartFromContact.displayName = 'QuoteStartFromContact'\n\nexport default QuoteStartFromRequest\n"],"names":["useSnackbar","authorizedFetch","ceilingedWindow","collectionCeiling","useFirestore","useFirestoreCollection","useUser","Button","collection","useCallback","useMemo","useState","QuoteEditorDialog","PRODUCT_WINDOW","QuoteStartDialog","props","hostId","start","onClose","firestore","data","productDocs","idField","products","undefined","rows","filter","product","quote","canEdit","canSend","QuoteStartFromRequest","submissionId","requestKind","user","enqueueSnackbar","busy","setBusy","setStart","open","payload","response","method","headers","body","JSON","stringify","action","json","catch","ok","error","variant","allowDuplicate","from","kind","id","prefill","request","files","threaded","disabled","onClick","displayName","QuoteStartFromContact","recordId","name","email","phone","company","size","customer","record","lines","notes"],"mappings":"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"}

package/src/lib/components/product-add-ons.d.ts

@@ -0,0 +1,28 @@
+import { type ModifierSelection, type ProductModifierGroup } from '../model/product-modifiers';
+export interface ProductAddOnsProps {
+    /** The groups the website shows, as the product's page received them. */
+    groups: readonly ProductModifierGroup[];
+    /** The variant picked: a choice priced by variant shows its price on it. */
+    variantId?: string;
+    value: readonly ModifierSelection[];
+    onChange: (next: ModifierSelection[]) => void;
+    /** The store's money, e.g. `$1,250.00`. */
+    formatCents: (cents: number) => string;
+    disabled?: boolean;
+}
+/** The picks with one group's answer replaced, in the groups' own order. */
+export declare function withGroupAnswer(groups: readonly ProductModifierGroup[], value: readonly ModifierSelection[], groupId: string, optionIds: readonly string[]): ModifierSelection[];
+/** What a group asks for, said under it. */
+export declare function addOnGroupHint(group: Pick<ProductModifierGroup, 'min' | 'max'>): string;
+/**
+ * The add-ons a product's page offers (AGL-4100): a group that takes one
+ * choice is a select, one that takes several is a set of checkboxes, each
+ * choice with what it adds on the picked variant. A required group is marked
+ * as the form builder marks a required field. Its own chunk, loaded only by a
+ * product that has add-ons on the website.
+ */
+export declare function ProductAddOns(props: ProductAddOnsProps): import("react").JSX.Element;
+export declare namespace ProductAddOns {
+    var displayName: string;
+}
+export default ProductAddOns;