@aglyn/plugins-commerce 1.0.0-beta.289 → 1.0.0-beta.291

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

@@ -29,8 +29,37 @@ export interface QuoteEditorDialogProps {
     canEdit: boolean;
     /** Holds "Send quotes and invoices to customers" (`commerce.quotes.send`). */
     canSend: boolean;
+    /**
+     * What a NEW quote opens with when it is started from a request or a
+     * contact (AGL-4098). The editable fields are filled in; a request's own
+     * parts (which request, its files, its conversation) are stamped by the
+     * server from `from` when the quote is created, never from here.
+     */
+    start?: QuoteEditorStart | null;
     onClose: () => void;
 }
+/** A new quote's start: from a request (with what it carried) or from a contact. */
+export interface QuoteEditorStart {
+    /** The request it is started from, which the server reads again on create; null for a contact. */
+    from: {
+        kind: 'submission';
+        id: string;
+    } | null;
+    prefill: CommerceModel.QuoteStartPrefill;
+    /** The request, as the editor says where the quote came from. */
+    request?: {
+        formName: string;
+        receivedAtMs: number | null;
+    } | null;
+    files?: ReadonlyArray<{
+        id: string;
+        name: string;
+        contentType: string;
+        size: number;
+    }>;
+    /** Whether the request started an email conversation the quote's first email will reply into. */
+    threaded?: boolean;
+}
 /**
  * The quote editor (AGL-4093): who it is for, its lines (products with their
  * options and add-ons, typed items, things included at no charge), discount,

package/src/lib/components/console/quote-editor-dialog.component.js

@@ -27,7 +27,10 @@ import { useFirestore, useFirestoreDoc, useStoreSettingsHref, useUser } from "@a
 import { Alert, Box, Button, Chip, Dialog, DialogActions, DialogContent, DialogContentText, DialogTitle, Divider, FormControlLabel, List, ListItemButton, ListItemText, MenuItem, Paper, Stack, Switch, TextField, Typography } from "@mui/material";
 import { doc } from "firebase/firestore";
 import { useCallback, useEffect, useMemo, useRef, useState } from "react";
+import { downloadCommercePdf } from "./commerce-pdf-download.js";
 import { QuotePayLinkSection } from "./quote-pay-link.component.js";
+import { QuoteProofsSection, QuoteRequestFilesSection } from "./quote-proofs.component.js";
+import { QuoteSendSection } from "./quote-send.component.js";
 const REFUSAL = commerceSitePermissionRefusal('commerce.quotes');
 const SEARCH_DEBOUNCE_MS = 250;
 const money = (cents)=>posMoney(cents);
@@ -112,6 +115,34 @@ function formFromQuote(quote, requireProofApproval) {
         requireProofApproval: section ? section.requireProofApproval === true : requireProofApproval
     };
 }
+/** A new quote's form, filled in from where it was started (AGL-4098). */ function formFromStart(start, requireProofApproval) {
+    var _customer_record, _customer_name, _customer_company, _customer_email, _customer_phone;
+    const blank = formFromQuote(null, requireProofApproval);
+    const { customer, lines, notes } = start.prefill;
+    return _extends({}, blank, {
+        customer: {
+            record: (_customer_record = customer.record) != null ? _customer_record : null,
+            name: (_customer_name = customer.name) != null ? _customer_name : '',
+            company: (_customer_company = customer.company) != null ? _customer_company : '',
+            email: (_customer_email = customer.email) != null ? _customer_email : '',
+            phone: (_customer_phone = customer.phone) != null ? _customer_phone : ''
+        },
+        lines: lines.map((line)=>{
+            var _line_variantId, _line_modifiers, _line_description;
+            return {
+                key: nextLineKey(),
+                kind: 'catalog',
+                productId: line.productId,
+                variantId: (_line_variantId = line.variantId) != null ? _line_variantId : '',
+                quantity: String(line.quantity || 1),
+                modifiers: (_line_modifiers = line.modifiers) != null ? _line_modifiers : [],
+                description: (_line_description = line.description) != null ? _line_description : '',
+                included: line.included === true
+            };
+        }),
+        notes: notes != null ? notes : ''
+    });
+}
 function lineRequest(line) {
     var _centsOf;
     const quantity = Number(line.quantity);
@@ -190,9 +221,10 @@ function addressBody(address) {
  * server prices and saves it; the totals here are the same function's answer
  * over the same inputs, and a connected tax service's figure arrives on save.
  */ export function QuoteEditorDialog(props) {
-    var _centsOf, _ref, _ref1;
-    var _quote_quote_tax, _quote_quote, _quote_quote1, _quote_quote2;
+    var _props_start, _centsOf, _ref, _start_files, _ref1;
+    var _quote_quote_tax, _quote_quote, _quote_quote1, _quote_quote2, _quote_quote3;
     const { hostId, quote, products, canEdit, canSend, onClose } = props;
+    const start = quote ? null : (_props_start = props.start) != null ? _props_start : null;
     const firestore = useFirestore();
     const { data: user } = useUser();
     const { enqueueSnackbar } = useSnackbar();
@@ -202,11 +234,12 @@ function addressBody(address) {
         hostId
     ]);
     const storeDefault = CommerceModel.quoteRequiresProofApprovalByDefault(store == null ? void 0 : store.quotes);
-    const [form, setForm] = useState(()=>formFromQuote(quote, storeDefault));
+    const [form, setForm] = useState(()=>start ? formFromStart(start, storeDefault) : formFromQuote(quote, storeDefault));
     // The version this form was opened on. A change saved elsewhere while it is
     // open arrives on `quote`; the save still names this one, so the server
-    // refuses rather than overwrite that change.
-    const [baseUpdatedAtMs] = useState(()=>{
+    // refuses rather than overwrite that change. A proof added or a revision
+    // started here (AGL-4096) moves it, and the save names the new one.
+    const [baseUpdatedAtMs, setBaseUpdatedAtMs] = useState(()=>{
         var _quote_quote;
         return quote == null ? void 0 : (_quote_quote = quote.quote) == null ? void 0 : _quote_quote.updatedAtMs;
     });
@@ -320,6 +353,8 @@ function addressBody(address) {
                 }, quote ? {
                     quoteId: quote.$id,
                     baseUpdatedAtMs
+                } : {}, !quote && (start == null ? void 0 : start.from) ? {
+                    from: start.from
                 } : {}, {
                     quote: quoteBody(_extends({}, form, {
                         requireProofApproval
@@ -349,6 +384,7 @@ function addressBody(address) {
         quote,
         hostId,
         baseUpdatedAtMs,
+        start,
         form,
         requireProofApproval,
         enqueueSnackbar,
@@ -393,6 +429,36 @@ function addressBody(address) {
         enqueueSnackbar,
         onClose
     ]);
+    const [downloading, setDownloading] = useState(false);
+    const downloadPdf = useCallback(async ()=>{
+        if (!quote) return;
+        setDownloading(true);
+        try {
+            var _quote_number;
+            const refused = await downloadCommercePdf(user, '/api/commerce/quote', {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json'
+                },
+                body: JSON.stringify({
+                    action: 'pdf',
+                    hostId,
+                    quoteId: quote.$id
+                })
+            }, `quote-${(_quote_number = quote.number) != null ? _quote_number : quote.$id.slice(-6)}.pdf`);
+            if (refused) enqueueSnackbar(refused, {
+                variant: 'error',
+                allowDuplicate: true
+            });
+        } finally{
+            setDownloading(false);
+        }
+    }, [
+        user,
+        quote,
+        hostId,
+        enqueueSnackbar
+    ]);
     const readOnly = !canEdit || busy;
     const paid = quote ? !CommerceModel.isUnpaidQuote(quote) : false;
     const title = quote ? CommerceModel.formatQuoteNumber(quote, quote.$id) : 'New quote';
@@ -436,6 +502,13 @@ function addressBody(address) {
                             severity: "success",
                             children: (quote == null ? void 0 : (_quote_quote2 = quote.quote) == null ? void 0 : _quote_quote2.paidAtMs) ? `Paid ${new Date(quote.quote.paidAtMs).toLocaleDateString()}. It is an order now and can no longer be changed.` : 'This quote has been paid, so it is an order now and can no longer be changed.'
                         }) : null,
+                        quote ? /*#__PURE__*/ _jsx(QuoteSendSection, {
+                            hostId: hostId,
+                            quoteId: quote.$id,
+                            quote: quote,
+                            canSend: canSend,
+                            edited: edited
+                        }) : null,
                         quote ? /*#__PURE__*/ _jsx(QuotePayLinkSection, {
                             hostId: hostId,
                             quoteId: quote.$id,
@@ -443,6 +516,26 @@ function addressBody(address) {
                             canSend: canSend,
                             edited: edited
                         }) : null,
+                        quote ? /*#__PURE__*/ _jsx(QuoteProofsSection, {
+                            hostId: hostId,
+                            quoteId: quote.$id,
+                            quote: quote,
+                            canEdit: canEdit,
+                            onEdited: (updatedAtMs)=>{
+                                if (updatedAtMs) setBaseUpdatedAtMs(updatedAtMs);
+                            }
+                        }) : null,
+                        (start == null ? void 0 : start.request) ? /*#__PURE__*/ _jsx(QuoteStartedFromRequest, {
+                            formName: start.request.formName,
+                            receivedAtMs: start.request.receivedAtMs,
+                            files: (_start_files = start.files) != null ? _start_files : [],
+                            threaded: start.threaded === true
+                        }) : null,
+                        (quote == null ? void 0 : (_quote_quote3 = quote.quote) == null ? void 0 : _quote_quote3.request) ? /*#__PURE__*/ _jsx(QuoteRequestFilesSection, {
+                            hostId: hostId,
+                            quoteId: quote.$id,
+                            quote: quote
+                        }) : null,
                         taxBasis.kind === 'none' && taxBasis.reason === 'undecided' ? /*#__PURE__*/ _jsx(PrerequisiteNotice, {
                             href: taxesHref != null ? taxesHref : undefined,
                             actionLabel: "Open Taxes",
@@ -677,6 +770,15 @@ function addressBody(address) {
                             children: 'Delete'
                         })
                     }) : null,
+                    quote ? /*#__PURE__*/ _jsx(BlockedControl, {
+                        blocked: !canEdit || edited,
+                        reason: edited ? 'Save your changes first: the PDF shows the quote as it was last saved.' : REFUSAL,
+                        children: /*#__PURE__*/ _jsx(Button, {
+                            disabled: busy || downloading,
+                            onClick: ()=>void downloadPdf(),
+                            children: downloading ? 'Making PDF…' : 'Download PDF'
+                        })
+                    }) : null,
                     /*#__PURE__*/ _jsx(Button, {
                         onClick: onClose,
                         disabled: busy,
@@ -730,6 +832,53 @@ function addressBody(address) {
     });
 }
 QuoteEditorDialog.displayName = 'QuoteEditorDialog';
+/** A new quote's request (AGL-4098): which form sent it and when, its files by name, and its conversation. */ function QuoteStartedFromRequest(props) {
+    const { formName, receivedAtMs, files, threaded } = props;
+    const when = receivedAtMs ? ` on ${new Date(receivedAtMs).toLocaleString(undefined, {
+        dateStyle: 'medium',
+        timeStyle: 'short'
+    })}` : '';
+    return /*#__PURE__*/ _jsx(Alert, {
+        severity: "info",
+        children: /*#__PURE__*/ _jsxs(Stack, {
+            spacing: 1,
+            children: [
+                /*#__PURE__*/ _jsx(Typography, {
+                    variant: "body2",
+                    children: `From a request sent through “${formName}”${when}.`
+                }),
+                files.length ? /*#__PURE__*/ _jsxs(Stack, {
+                    spacing: 0.5,
+                    children: [
+                        /*#__PURE__*/ _jsx(Typography, {
+                            variant: "caption",
+                            color: "text.secondary",
+                            children: 'Their files, kept on the quote as the customer’s:'
+                        }),
+                        /*#__PURE__*/ _jsx(Stack, {
+                            direction: "row",
+                            spacing: 1,
+                            useFlexGap: true,
+                            sx: {
+                                flexWrap: 'wrap'
+                            },
+                            children: files.map((file)=>/*#__PURE__*/ _jsx(Chip, {
+                                    size: "small",
+                                    variant: "outlined",
+                                    label: file.name
+                                }, file.id))
+                        })
+                    ]
+                }) : null,
+                /*#__PURE__*/ _jsx(Typography, {
+                    variant: "caption",
+                    color: "text.secondary",
+                    children: threaded ? 'When you email the quote, it replies to the confirmation they were sent, in the same conversation.' : 'They weren’t sent a confirmation, so the quote’s email starts the conversation.'
+                })
+            ]
+        })
+    });
+}
 /** Who the quote is for: a person the workspace keeps, or details typed here. */ function QuoteCustomerSection(props) {
     const { hostId, form, disabled, onChange } = props;
     const { data: user } = useUser();