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

package/src/lib/components/quote-proof-panel.js

@@ -0,0 +1,436 @@
+import { _ as _extends } from "@swc/helpers/_/_extends";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * @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.
+ */ import { checkVisitorUploadSelection, describeVisitorUploadTypes, formatVisitorUploadBytes, VISITOR_UPLOAD_ACCEPT, VISITOR_UPLOAD_HONEYPOT_FIELD, VISITOR_UPLOAD_MAX_BYTES, VISITOR_UPLOAD_MAX_FILES } from "@aglyn/aglyn/app-utils/visitor-upload";
+import { sendVisitorUpload } from "@aglyn/aglyn/app-utils/visitor-upload-client";
+import Alert from "@mui/material/Alert";
+import Box from "@mui/material/Box";
+import Button from "@mui/material/Button";
+import Chip from "@mui/material/Chip";
+import Paper from "@mui/material/Paper";
+import Stack from "@mui/material/Stack";
+import TextField from "@mui/material/TextField";
+import Typography from "@mui/material/Typography";
+import { useCallback, useRef, useState } from "react";
+function dateLabel(atMs) {
+    return new Date(atMs).toLocaleDateString(undefined, {
+        month: 'short',
+        day: 'numeric',
+        year: 'numeric'
+    });
+}
+const newKey = ()=>{
+    var _ref;
+    var _globalThis_crypto_randomUUID, _globalThis_crypto;
+    return (_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)}`;
+};
+/**
+ * The quote's proofs on the customer's page (AGL-4096): each image shown,
+ * every other file a download, and while the quote is open for an answer,
+ * "Approve this proof" (under a typed name) and "Request changes" (a comment
+ * and any artwork). The latest answer is the one that counts, so a customer
+ * who asked for changes can still approve, and the panel says what they last
+ * said. A paid quote shows its proofs and nothing to press.
+ */ export function QuoteProofPanel(props) {
+    const { view, hostId, quoteId, token, siteFetch, onView, onReload, onReplaced } = props;
+    const [mode, setMode] = useState('idle');
+    const [name, setName] = useState('');
+    const [comment, setComment] = useState('');
+    const [files, setFiles] = useState([]);
+    const [uploading, setUploading] = useState(null);
+    const [sending, setSending] = useState(false);
+    const [error, setError] = useState('');
+    // Whatever a bot types into the hidden field, sent as typed.
+    const [honeypot, setHoneypot] = useState('');
+    const picker = useRef(null);
+    const attempt = useRef('');
+    const link = `hostId=${encodeURIComponent(hostId)}&q=${encodeURIComponent(quoteId)}&t=${encodeURIComponent(token)}`;
+    const proofHref = (id)=>`/api/commerce/quote-proof?${link}&file=${encodeURIComponent(id)}`;
+    const business = view.storeName || 'the business';
+    const post = useCallback(async (path, body, headers = {})=>{
+        const response = await siteFetch(path, {
+            method: 'POST',
+            headers: _extends({
+                'Content-Type': 'application/json'
+            }, headers),
+            body: JSON.stringify(_extends({
+                hostId,
+                q: quoteId,
+                t: token
+            }, body))
+        });
+        return {
+            response,
+            payload: await response.json().catch(()=>({}))
+        };
+    }, [
+        siteFetch,
+        hostId,
+        quoteId,
+        token
+    ]);
+    const attach = useCallback(async (picked)=>{
+        setError('');
+        const problem = checkVisitorUploadSelection(picked, files.length);
+        if (problem) return void setError(problem);
+        setUploading({
+            done: 0,
+            total: picked.length
+        });
+        try {
+            for (const [index, file] of picked.entries()){
+                const sent = await sendVisitorUpload({
+                    file,
+                    requestTicket: async (request)=>{
+                        var _payload_error;
+                        const { response, payload } = await post('/api/commerce/quote-upload', {
+                            action: 'ticket',
+                            file: request,
+                            [VISITOR_UPLOAD_HONEYPOT_FIELD]: honeypot
+                        });
+                        return response.ok && payload['ticket'] ? payload : {
+                            error: String((_payload_error = payload['error']) != null ? _payload_error : 'The file could not be sent. Try again.')
+                        };
+                    },
+                    finalize: async (ticket)=>{
+                        var _payload_error;
+                        const { response, payload } = await post('/api/commerce/quote-upload', {
+                            action: 'finalize',
+                            ticket
+                        });
+                        return response.ok && payload['file'] ? {
+                            file: payload['file']
+                        } : {
+                            error: String((_payload_error = payload['error']) != null ? _payload_error : 'The file could not be sent. Try again.')
+                        };
+                    }
+                });
+                if ('error' in sent) {
+                    setError(sent.error);
+                    break;
+                }
+                setFiles((prev)=>[
+                        ...prev,
+                        sent.file
+                    ]);
+                setUploading({
+                    done: index + 1,
+                    total: picked.length
+                });
+            }
+        } finally{
+            setUploading(null);
+        }
+    }, [
+        files.length,
+        post,
+        honeypot
+    ]);
+    const respond = useCallback(async ()=>{
+        if (sending) return;
+        setError('');
+        if (mode === 'approve' && name.trim().length < 2) return void setError('Type your name to approve the proof.');
+        if (mode === 'changes' && !comment.trim()) return void setError('Tell us what to change.');
+        setSending(true);
+        // One key per answer: a retry of the same press is answered from the first.
+        if (!attempt.current) attempt.current = newKey();
+        try {
+            var _payload_error;
+            const { response, payload } = await post('/api/commerce/quote-respond', _extends({
+                v: view.version,
+                action: mode === 'approve' ? 'approve' : 'changes'
+            }, mode === 'approve' ? {
+                name: name.trim()
+            } : {
+                comment: comment.trim(),
+                fileIds: files.map((file)=>file.id)
+            }, {
+                [VISITOR_UPLOAD_HONEYPOT_FIELD]: honeypot
+            }), {
+                'Idempotency-Key': attempt.current
+            });
+            attempt.current = '';
+            if (response.ok && payload['view']) {
+                setMode('idle');
+                setName('');
+                setComment('');
+                setFiles([]);
+                onView(payload['view']);
+                return;
+            }
+            if (payload['replaced']) return onReplaced();
+            if (payload['reason'] === 'updated' || payload['reason'] === 'paid') onReload();
+            setError(String((_payload_error = payload['error']) != null ? _payload_error : 'Your answer could not be sent. Try again.'));
+        } catch (unused) {
+            setError('Your answer could not be sent. Check your connection and try again.');
+        } finally{
+            setSending(false);
+        }
+    }, [
+        sending,
+        mode,
+        name,
+        comment,
+        files,
+        view.version,
+        honeypot,
+        post,
+        onView,
+        onReload,
+        onReplaced
+    ]);
+    if (!view.proofs.length) return null;
+    const response = view.response;
+    return /*#__PURE__*/ _jsx(Paper, {
+        variant: "outlined",
+        sx: {
+            p: {
+                xs: 2,
+                sm: 3
+            }
+        },
+        children: /*#__PURE__*/ _jsxs(Stack, {
+            spacing: 2,
+            children: [
+                /*#__PURE__*/ _jsxs(Stack, {
+                    spacing: 0.5,
+                    children: [
+                        /*#__PURE__*/ _jsx(Typography, {
+                            variant: "h6",
+                            component: "h2",
+                            children: view.proofs.length === 1 ? 'Your proof' : 'Your proofs'
+                        }),
+                        /*#__PURE__*/ _jsx(Typography, {
+                            variant: "body2",
+                            color: "text.secondary",
+                            children: view.status === 'unpaid' ? `Revision ${view.revision}. Look it over, then approve it or tell ${business} what to change.` : `Revision ${view.revision}.`
+                        })
+                    ]
+                }),
+                /*#__PURE__*/ _jsx(Stack, {
+                    spacing: 1.5,
+                    children: view.proofs.map((proof)=>proof.inline ? /*#__PURE__*/ _jsxs(Stack, {
+                            spacing: 0.5,
+                            children: [
+                                /*#__PURE__*/ _jsx(Box, {
+                                    component: "img",
+                                    src: proofHref(proof.id),
+                                    alt: proof.name,
+                                    loading: "lazy",
+                                    sx: {
+                                        display: 'block',
+                                        maxWidth: 1,
+                                        height: 'auto',
+                                        borderRadius: 1,
+                                        border: 1,
+                                        borderColor: 'divider'
+                                    }
+                                }),
+                                /*#__PURE__*/ _jsx(Typography, {
+                                    variant: "caption",
+                                    color: "text.secondary",
+                                    children: proof.name
+                                })
+                            ]
+                        }, proof.id) : /*#__PURE__*/ _jsx(Box, {
+                            children: /*#__PURE__*/ _jsx(Button, {
+                                variant: "outlined",
+                                size: "small",
+                                href: proofHref(proof.id),
+                                download: proof.name,
+                                children: `Download ${proof.name} (${formatVisitorUploadBytes(proof.size)})`
+                            })
+                        }, proof.id))
+                }),
+                response ? response.action === 'approve' ? /*#__PURE__*/ _jsx(Alert, {
+                    severity: "success",
+                    children: `You approved this proof on ${dateLabel(response.atMs)}${response.name ? ` as ${response.name}` : ''}.`
+                }) : /*#__PURE__*/ _jsx(Alert, {
+                    severity: "info",
+                    children: `You asked for changes on ${dateLabel(response.atMs)}. ${business.charAt(0).toUpperCase()}${business.slice(1)} will send you a new proof.`
+                }) : null,
+                view.respondable ? /*#__PURE__*/ _jsxs(Stack, {
+                    spacing: 2,
+                    children: [
+                        /*#__PURE__*/ _jsx(Box, {
+                            component: "input",
+                            type: "text",
+                            name: VISITOR_UPLOAD_HONEYPOT_FIELD,
+                            tabIndex: -1,
+                            autoComplete: "off",
+                            "aria-hidden": "true",
+                            value: honeypot,
+                            onChange: (event)=>setHoneypot(event.target.value),
+                            sx: {
+                                position: 'absolute',
+                                left: '-100vw',
+                                width: 0,
+                                height: 0,
+                                opacity: 0
+                            }
+                        }),
+                        mode === 'idle' ? /*#__PURE__*/ _jsxs(Stack, {
+                            direction: {
+                                xs: 'column',
+                                sm: 'row'
+                            },
+                            spacing: 1,
+                            children: [
+                                (response == null ? void 0 : response.action) !== 'approve' ? /*#__PURE__*/ _jsx(Button, {
+                                    variant: "contained",
+                                    onClick: ()=>setMode('approve'),
+                                    children: 'Approve this proof'
+                                }) : null,
+                                /*#__PURE__*/ _jsx(Button, {
+                                    variant: (response == null ? void 0 : response.action) === 'approve' ? 'outlined' : 'text',
+                                    onClick: ()=>setMode('changes'),
+                                    children: 'Request changes'
+                                })
+                            ]
+                        }) : mode === 'approve' ? /*#__PURE__*/ _jsxs(Stack, {
+                            spacing: 1.5,
+                            children: [
+                                /*#__PURE__*/ _jsx(Typography, {
+                                    variant: "body2",
+                                    children: `Type your name to approve revision ${view.revision}. ${business.charAt(0).toUpperCase()}${business.slice(1)} keeps your name and the time as the record of your approval.`
+                                }),
+                                /*#__PURE__*/ _jsx(TextField, {
+                                    label: "Your name",
+                                    value: name,
+                                    autoComplete: "name",
+                                    onChange: (event)=>setName(event.target.value),
+                                    slotProps: {
+                                        htmlInput: {
+                                            maxLength: 120
+                                        }
+                                    }
+                                }),
+                                /*#__PURE__*/ _jsxs(Stack, {
+                                    direction: "row",
+                                    spacing: 1,
+                                    children: [
+                                        /*#__PURE__*/ _jsx(Button, {
+                                            variant: "contained",
+                                            disabled: sending,
+                                            onClick: ()=>void respond(),
+                                            children: sending ? 'Approving…' : 'Approve'
+                                        }),
+                                        /*#__PURE__*/ _jsx(Button, {
+                                            disabled: sending,
+                                            onClick: ()=>setMode('idle'),
+                                            children: 'Cancel'
+                                        })
+                                    ]
+                                })
+                            ]
+                        }) : /*#__PURE__*/ _jsxs(Stack, {
+                            spacing: 1.5,
+                            children: [
+                                /*#__PURE__*/ _jsx(TextField, {
+                                    label: "What should change?",
+                                    value: comment,
+                                    multiline: true,
+                                    minRows: 3,
+                                    required: true,
+                                    onChange: (event)=>setComment(event.target.value),
+                                    slotProps: {
+                                        htmlInput: {
+                                            maxLength: 5000
+                                        }
+                                    }
+                                }),
+                                /*#__PURE__*/ _jsx("input", {
+                                    ref: picker,
+                                    type: "file",
+                                    multiple: true,
+                                    hidden: true,
+                                    accept: VISITOR_UPLOAD_ACCEPT,
+                                    "data-testid": "quote-artwork-picker",
+                                    onChange: (event)=>{
+                                        var _event_target_files;
+                                        const picked = Array.from((_event_target_files = event.target.files) != null ? _event_target_files : []);
+                                        event.target.value = '';
+                                        if (picked.length) void attach(picked);
+                                    }
+                                }),
+                                files.length ? /*#__PURE__*/ _jsx(Stack, {
+                                    direction: "row",
+                                    spacing: 1,
+                                    useFlexGap: true,
+                                    sx: {
+                                        flexWrap: 'wrap'
+                                    },
+                                    children: files.map((file)=>/*#__PURE__*/ _jsx(Chip, {
+                                            label: `${file.name} · ${formatVisitorUploadBytes(file.size)}`,
+                                            onDelete: sending ? undefined : ()=>setFiles((prev)=>prev.filter((entry)=>entry.id !== file.id))
+                                        }, file.id))
+                                }) : null,
+                                /*#__PURE__*/ _jsxs(Box, {
+                                    children: [
+                                        /*#__PURE__*/ _jsx(Button, {
+                                            size: "small",
+                                            variant: "outlined",
+                                            disabled: sending || Boolean(uploading) || files.length >= VISITOR_UPLOAD_MAX_FILES,
+                                            onClick: ()=>{
+                                                var _picker_current;
+                                                return (_picker_current = picker.current) == null ? void 0 : _picker_current.click();
+                                            },
+                                            children: uploading ? `Sending ${uploading.done + 1} of ${uploading.total}…` : 'Attach artwork'
+                                        }),
+                                        /*#__PURE__*/ _jsx(Typography, {
+                                            variant: "caption",
+                                            color: "text.secondary",
+                                            component: "p",
+                                            sx: {
+                                                mt: 0.5
+                                            },
+                                            children: `Optional. ${describeVisitorUploadTypes()}, up to ${VISITOR_UPLOAD_MAX_FILES} files of ${formatVisitorUploadBytes(VISITOR_UPLOAD_MAX_BYTES)} each.`
+                                        })
+                                    ]
+                                }),
+                                /*#__PURE__*/ _jsxs(Stack, {
+                                    direction: "row",
+                                    spacing: 1,
+                                    children: [
+                                        /*#__PURE__*/ _jsx(Button, {
+                                            variant: "contained",
+                                            disabled: sending || Boolean(uploading),
+                                            onClick: ()=>void respond(),
+                                            children: sending ? 'Sending…' : 'Send changes'
+                                        }),
+                                        /*#__PURE__*/ _jsx(Button, {
+                                            disabled: sending,
+                                            onClick: ()=>setMode('idle'),
+                                            children: 'Cancel'
+                                        })
+                                    ]
+                                })
+                            ]
+                        }),
+                        error ? /*#__PURE__*/ _jsx(Alert, {
+                            severity: "error",
+                            children: error
+                        }) : null
+                    ]
+                }) : null
+            ]
+        })
+    });
+}
+export default QuoteProofPanel;
+
+//# sourceMappingURL=quote-proof-panel.js.map

package/src/lib/components/quote-proof-panel.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/commerce/src/lib/components/quote-proof-panel.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\nimport {\n  checkVisitorUploadSelection,\n  describeVisitorUploadTypes,\n  formatVisitorUploadBytes,\n  VISITOR_UPLOAD_ACCEPT,\n  VISITOR_UPLOAD_HONEYPOT_FIELD,\n  VISITOR_UPLOAD_MAX_BYTES,\n  VISITOR_UPLOAD_MAX_FILES,\n  type VisitorUploadFileView,\n} from '@aglyn/aglyn/app-utils/visitor-upload'\nimport { sendVisitorUpload } from '@aglyn/aglyn/app-utils/visitor-upload-client'\nimport Alert from '@mui/material/Alert'\nimport Box from '@mui/material/Box'\nimport Button from '@mui/material/Button'\nimport Chip from '@mui/material/Chip'\nimport Paper from '@mui/material/Paper'\nimport Stack from '@mui/material/Stack'\nimport TextField from '@mui/material/TextField'\nimport Typography from '@mui/material/Typography'\nimport { useCallback, useRef, useState, type ChangeEvent } from 'react'\nimport type { QuotePageView } from '../model'\n\n/** The page's own fetch: the site's API, with the site's preview rules. */\ntype SiteFetch = (input: string, init?: RequestInit) => Promise<Response>\n\nexport interface QuoteProofPanelProps {\n  view: QuotePageView\n  hostId: string\n  quoteId: string\n  token: string\n  siteFetch: SiteFetch\n  /** The quote as the server answered after a response, or after it changed. */\n  onView: (view: QuotePageView) => void\n  /** Reload the quote: it changed since the page loaded. */\n  onReload: () => void\n  /** The link was replaced. */\n  onReplaced: () => void\n}\n\nfunction dateLabel(atMs: number): string {\n  return new Date(atMs).toLocaleDateString(undefined, { month: 'short', day: 'numeric', year: 'numeric' })\n}\n\nconst newKey = () => globalThis.crypto?.randomUUID?.() ?? `${Date.now()}-${Math.random().toString(36).slice(2)}`\n\n/**\n * The quote's proofs on the customer's page (AGL-4096): each image shown,\n * every other file a download, and while the quote is open for an answer,\n * \"Approve this proof\" (under a typed name) and \"Request changes\" (a comment\n * and any artwork). The latest answer is the one that counts, so a customer\n * who asked for changes can still approve, and the panel says what they last\n * said. A paid quote shows its proofs and nothing to press.\n */\nexport function QuoteProofPanel(props: QuoteProofPanelProps) {\n  const { view, hostId, quoteId, token, siteFetch, onView, onReload, onReplaced } = props\n  const [mode, setMode] = useState<'idle' | 'approve' | 'changes'>('idle')\n  const [name, setName] = useState('')\n  const [comment, setComment] = useState('')\n  const [files, setFiles] = useState<VisitorUploadFileView[]>([])\n  const [uploading, setUploading] = useState<{ done: number; total: number } | null>(null)\n  const [sending, setSending] = useState(false)\n  const [error, setError] = useState('')\n  // Whatever a bot types into the hidden field, sent as typed.\n  const [honeypot, setHoneypot] = useState('')\n  const picker = useRef<HTMLInputElement>(null)\n  const attempt = useRef('')\n\n  const link = `hostId=${encodeURIComponent(hostId)}&q=${encodeURIComponent(quoteId)}&t=${encodeURIComponent(token)}`\n  const proofHref = (id: string) => `/api/commerce/quote-proof?${link}&file=${encodeURIComponent(id)}`\n  const business = view.storeName || 'the business'\n\n  const post = useCallback(\n    async (path: string, body: Record<string, unknown>, headers: Record<string, string> = {}) => {\n      const response = await siteFetch(path, {\n        method: 'POST',\n        headers: { 'Content-Type': 'application/json', ...headers },\n        body: JSON.stringify({ hostId, q: quoteId, t: token, ...body }),\n      })\n      return { response, payload: (await response.json().catch(() => ({}))) as Record<string, any> }\n    },\n    [siteFetch, hostId, quoteId, token],\n  )\n\n  const attach = useCallback(\n    async (picked: File[]) => {\n      setError('')\n      const problem = checkVisitorUploadSelection(picked, files.length)\n      if (problem) return void setError(problem)\n      setUploading({ done: 0, total: picked.length })\n      try {\n        for (const [index, file] of picked.entries()) {\n          const sent = await sendVisitorUpload({\n            file,\n            requestTicket: async (request) => {\n              const { response, payload } = await post('/api/commerce/quote-upload', {\n                action: 'ticket',\n                file: request,\n                [VISITOR_UPLOAD_HONEYPOT_FIELD]: honeypot,\n              })\n              return response.ok && payload['ticket']\n                ? (payload as { ticket: string; upload: { url: string; fields: Record<string, string> } })\n                : { error: String(payload['error'] ?? 'The file could not be sent. Try again.') }\n            },\n            finalize: async (ticket) => {\n              const { response, payload } = await post('/api/commerce/quote-upload', { action: 'finalize', ticket })\n              return response.ok && payload['file']\n                ? { file: payload['file'] as VisitorUploadFileView }\n                : { error: String(payload['error'] ?? 'The file could not be sent. Try again.') }\n            },\n          })\n          if ('error' in sent) {\n            setError(sent.error)\n            break\n          }\n          setFiles((prev) => [...prev, sent.file])\n          setUploading({ done: index + 1, total: picked.length })\n        }\n      } finally {\n        setUploading(null)\n      }\n    },\n    [files.length, post, honeypot],\n  )\n\n  const respond = useCallback(async () => {\n    if (sending) return\n    setError('')\n    if (mode === 'approve' && name.trim().length < 2) return void setError('Type your name to approve the proof.')\n    if (mode === 'changes' && !comment.trim()) return void setError('Tell us what to change.')\n    setSending(true)\n    // One key per answer: a retry of the same press is answered from the first.\n    if (!attempt.current) attempt.current = newKey()\n    try {\n      const { response, payload } = await post(\n        '/api/commerce/quote-respond',\n        {\n          v: view.version,\n          action: mode === 'approve' ? 'approve' : 'changes',\n          ...(mode === 'approve' ? { name: name.trim() } : { comment: comment.trim(), fileIds: files.map((file) => file.id) }),\n          [VISITOR_UPLOAD_HONEYPOT_FIELD]: honeypot,\n        },\n        { 'Idempotency-Key': attempt.current },\n      )\n      attempt.current = ''\n      if (response.ok && payload['view']) {\n        setMode('idle')\n        setName('')\n        setComment('')\n        setFiles([])\n        onView(payload['view'] as QuotePageView)\n        return\n      }\n      if (payload['replaced']) return onReplaced()\n      if (payload['reason'] === 'updated' || payload['reason'] === 'paid') onReload()\n      setError(String(payload['error'] ?? 'Your answer could not be sent. Try again.'))\n    } catch {\n      setError('Your answer could not be sent. Check your connection and try again.')\n    } finally {\n      setSending(false)\n    }\n  }, [sending, mode, name, comment, files, view.version, honeypot, post, onView, onReload, onReplaced])\n\n  if (!view.proofs.length) return null\n  const response = view.response\n\n  return (\n    <Paper variant=\"outlined\" sx={{ p: { xs: 2, sm: 3 } }}>\n      <Stack spacing={2}>\n        <Stack spacing={0.5}>\n          <Typography variant=\"h6\" component=\"h2\">\n            {view.proofs.length === 1 ? 'Your proof' : 'Your proofs'}\n          </Typography>\n          <Typography variant=\"body2\" color=\"text.secondary\">\n            {view.status === 'unpaid'\n              ? `Revision ${view.revision}. Look it over, then approve it or tell ${business} what to change.`\n              : `Revision ${view.revision}.`}\n          </Typography>\n        </Stack>\n\n        <Stack spacing={1.5}>\n          {view.proofs.map((proof) =>\n            proof.inline ? (\n              <Stack key={proof.id} spacing={0.5}>\n                <Box\n                  component=\"img\"\n                  src={proofHref(proof.id)}\n                  alt={proof.name}\n                  loading=\"lazy\"\n                  sx={{ display: 'block', maxWidth: 1, height: 'auto', borderRadius: 1, border: 1, borderColor: 'divider' }}\n                />\n                <Typography variant=\"caption\" color=\"text.secondary\">\n                  {proof.name}\n                </Typography>\n              </Stack>\n            ) : (\n              <Box key={proof.id}>\n                <Button variant=\"outlined\" size=\"small\" href={proofHref(proof.id)} download={proof.name}>\n                  {`Download ${proof.name} (${formatVisitorUploadBytes(proof.size)})`}\n                </Button>\n              </Box>\n            ),\n          )}\n        </Stack>\n\n        {response ? (\n          response.action === 'approve' ? (\n            <Alert severity=\"success\">\n              {`You approved this proof on ${dateLabel(response.atMs)}${response.name ? ` as ${response.name}` : ''}.`}\n            </Alert>\n          ) : (\n            <Alert severity=\"info\">\n              {`You asked for changes on ${dateLabel(response.atMs)}. ${business.charAt(0).toUpperCase()}${business.slice(1)} will send you a new proof.`}\n            </Alert>\n          )\n        ) : null}\n\n        {view.respondable ? (\n          <Stack spacing={2}>\n            {/* Honeypot: people never see or fill this. */}\n            <Box\n              component=\"input\"\n              type=\"text\"\n              name={VISITOR_UPLOAD_HONEYPOT_FIELD}\n              tabIndex={-1}\n              autoComplete=\"off\"\n              aria-hidden=\"true\"\n              value={honeypot}\n              onChange={(event: ChangeEvent<HTMLInputElement>) => setHoneypot(event.target.value)}\n              sx={{ position: 'absolute', left: '-100vw', width: 0, height: 0, opacity: 0 }}\n            />\n            {mode === 'idle' ? (\n              <Stack direction={{ xs: 'column', sm: 'row' }} spacing={1}>\n                {response?.action !== 'approve' ? (\n                  <Button variant=\"contained\" onClick={() => setMode('approve')}>\n                    {'Approve this proof'}\n                  </Button>\n                ) : null}\n                <Button variant={response?.action === 'approve' ? 'outlined' : 'text'} onClick={() => setMode('changes')}>\n                  {'Request changes'}\n                </Button>\n              </Stack>\n            ) : mode === 'approve' ? (\n              <Stack spacing={1.5}>\n                <Typography variant=\"body2\">\n                  {`Type your name to approve revision ${view.revision}. ${business.charAt(0).toUpperCase()}${business.slice(1)} keeps your name and the time as the record of your approval.`}\n                </Typography>\n                <TextField\n                  label=\"Your name\"\n                  value={name}\n                  autoComplete=\"name\"\n                  onChange={(event) => setName(event.target.value)}\n                  slotProps={{ htmlInput: { maxLength: 120 } }}\n                />\n                <Stack direction=\"row\" spacing={1}>\n                  <Button variant=\"contained\" disabled={sending} onClick={() => void respond()}>\n                    {sending ? 'Approving…' : 'Approve'}\n                  </Button>\n                  <Button disabled={sending} onClick={() => setMode('idle')}>\n                    {'Cancel'}\n                  </Button>\n                </Stack>\n              </Stack>\n            ) : (\n              <Stack spacing={1.5}>\n                <TextField\n                  label=\"What should change?\"\n                  value={comment}\n                  multiline\n                  minRows={3}\n                  required\n                  onChange={(event) => setComment(event.target.value)}\n                  slotProps={{ htmlInput: { maxLength: 5000 } }}\n                />\n                <input\n                  ref={picker}\n                  type=\"file\"\n                  multiple\n                  hidden\n                  accept={VISITOR_UPLOAD_ACCEPT}\n                  data-testid=\"quote-artwork-picker\"\n                  onChange={(event) => {\n                    const picked = Array.from(event.target.files ?? [])\n                    event.target.value = ''\n                    if (picked.length) void attach(picked)\n                  }}\n                />\n                {files.length ? (\n                  <Stack direction=\"row\" spacing={1} useFlexGap sx={{ flexWrap: 'wrap' }}>\n                    {files.map((file) => (\n                      <Chip\n                        key={file.id}\n                        label={`${file.name} · ${formatVisitorUploadBytes(file.size)}`}\n                        onDelete={sending ? undefined : () => setFiles((prev) => prev.filter((entry) => entry.id !== file.id))}\n                      />\n                    ))}\n                  </Stack>\n                ) : null}\n                <Box>\n                  <Button\n                    size=\"small\"\n                    variant=\"outlined\"\n                    disabled={sending || Boolean(uploading) || files.length >= VISITOR_UPLOAD_MAX_FILES}\n                    onClick={() => picker.current?.click()}\n                  >\n                    {uploading ? `Sending ${uploading.done + 1} of ${uploading.total}…` : 'Attach artwork'}\n                  </Button>\n                  <Typography variant=\"caption\" color=\"text.secondary\" component=\"p\" sx={{ mt: 0.5 }}>\n                    {`Optional. ${describeVisitorUploadTypes()}, up to ${VISITOR_UPLOAD_MAX_FILES} files of ${formatVisitorUploadBytes(VISITOR_UPLOAD_MAX_BYTES)} each.`}\n                  </Typography>\n                </Box>\n                <Stack direction=\"row\" spacing={1}>\n                  <Button variant=\"contained\" disabled={sending || Boolean(uploading)} onClick={() => void respond()}>\n                    {sending ? 'Sending…' : 'Send changes'}\n                  </Button>\n                  <Button disabled={sending} onClick={() => setMode('idle')}>\n                    {'Cancel'}\n                  </Button>\n                </Stack>\n              </Stack>\n            )}\n            {error ? <Alert severity=\"error\">{error}</Alert> : null}\n          </Stack>\n        ) : null}\n      </Stack>\n    </Paper>\n  )\n}\n\nexport default QuoteProofPanel\n"],"names":["checkVisitorUploadSelection","describeVisitorUploadTypes","formatVisitorUploadBytes","VISITOR_UPLOAD_ACCEPT","VISITOR_UPLOAD_HONEYPOT_FIELD","VISITOR_UPLOAD_MAX_BYTES","VISITOR_UPLOAD_MAX_FILES","sendVisitorUpload","Alert","Box","Button","Chip","Paper","Stack","TextField","Typography","useCallback","useRef","useState","dateLabel","atMs","Date","toLocaleDateString","undefined","month","day","year","newKey","globalThis","crypto","randomUUID","now","Math","random","toString","slice","QuoteProofPanel","props","view","hostId","quoteId","token","siteFetch","onView","onReload","onReplaced","mode","setMode","name","setName","comment","setComment","files","setFiles","uploading","setUploading","sending","setSending","error","setError","honeypot","setHoneypot","picker","attempt","link","encodeURIComponent","proofHref","id","business","storeName","post","path","body","headers","response","method","JSON","stringify","q","t","payload","json","catch","attach","picked","problem","length","done","total","index","file","entries","sent","requestTicket","request","action","ok","String","finalize","ticket","prev","respond","trim","current","v","version","fileIds","map","proofs","variant","sx","p","xs","sm","spacing","component","color","status","revision","proof","inline","src","alt","loading","display","maxWidth","height","borderRadius","border","borderColor","size","href","download","severity","charAt","toUpperCase","respondable","type","tabIndex","autoComplete","aria-hidden","value","onChange","event","target","position","left","width","opacity","direction","onClick","label","slotProps","htmlInput","maxLength","disabled","multiline","minRows","required","input","ref","multiple","hidden","accept","data-testid","Array","from","useFlexGap","flexWrap","onDelete","filter","entry","Boolean","click","mt"],"mappings":"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"}

package/src/lib/model/commerce-invoices.d.ts

@@ -0,0 +1,132 @@
+/**
+ * @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.
+ */
+import { type HostOrder, type OrderTimelineEvent } from './commerce-orders';
+import { type QuoteCheckoutCharge, type QuotePageView, type QuotePayRefusal } from './commerce-quote-pay';
+import { type OrderInvoiceSendRecord, type QuoteEmailThread, type QuoteTaxBasis } from './commerce-quotes';
+import type { ResolvedShippingRate } from './commerce-shipping';
+/** Which page a pay link opens for an order: a quote, an invoice, or none. */
+export type OrderPayLinkKind = 'quote' | 'invoice';
+/** The most invoice sends an order keeps on record; the oldest go first. */
+export declare const INVOICE_MAX_SENDS = 50;
+/**
+ * Which page the lasting pay link opens for an order, or null when it opens
+ * none: a quote (with its quote section), or a draft order as an invoice.
+ */
+export declare function orderPayLinkKind(order: Pick<HostOrder, 'channel'> & Partial<Pick<HostOrder, 'quote'>> | null | undefined): OrderPayLinkKind | null;
+/** `Invoice #1042`: the order's own number, which a paid quote keeps too. */
+export declare function formatInvoiceNumber(order: Pick<HostOrder, 'number'>, orderId?: string): string;
+/** The order is paid (and not refunded or canceled): its invoice is the record. */
+export declare function invoiceIsPaid(order: Pick<HostOrder, 'status'> | null | undefined): boolean;
+/**
+ * When the order was paid: a quote's stamp, else the timeline's `paid`
+ * event, else (an order created paid, as checkout's are) when it was made.
+ * Null for an order not paid.
+ */
+export declare function orderPaidAtMs(order: Pick<HostOrder, 'status' | 'quote' | 'timeline'> & {
+    createdAtMs?: number;
+} | null | undefined): number | null;
+/** What an invoice's Checkout Session charges, with the rates a draft lets the buyer pick from. */
+export interface InvoiceCheckoutCharge extends QuoteCheckoutCharge {
+    /** The draft's shipping rates, picked at payment; empty when shipping is fixed or there is none. */
+    shippingOptions: ResolvedShippingRate[];
+    /** Where those rates ship; empty with none. */
+    shippingCountries: string[];
+}
+/**
+ * The tax basis an order's stored figures give its invoice: Stripe Tax at
+ * payment where the order was composed under it, its frozen tax as a fixed
+ * figure (charged as the rate that yields it on the taxed line, the way a tax
+ * service's quote is), else none.
+ */
+export declare function invoiceTaxBasis(order: Pick<HostOrder, 'taxMode' | 'totals'>): QuoteTaxBasis;
+/**
+ * What an invoice's pay link charges, from the stored order alone. A quote is
+ * charged as slice 2 charges it; any other order from its lines, its
+ * discount, its tax ({@link invoiceTaxBasis}) and, for a draft, the shipping
+ * rates it offered when it was made (Stripe asks for the address and the
+ * buyer picks one, as on the draft's first link).
+ */
+export declare function invoiceCheckoutCharge(order: Pick<HostOrder, 'number' | 'lineItems' | 'quote' | 'totals' | 'taxMode'> & Partial<Pick<HostOrder, 'draftShipping'>>, orderId: string): InvoiceCheckoutCharge;
+/**
+ * Why an order cannot be paid through its pay link now: a quote's reasons,
+ * and two of an invoice's own. `not-payable` is an order the link does not
+ * open (a register sale still open, say); `shipping-unknown` is a draft made
+ * before drafts kept their shipping rates, whose shipping cannot be charged.
+ */
+export type InvoicePayRefusal = QuotePayRefusal | 'not-payable' | 'shipping-unknown';
+export declare function invoicePayRefusal(order: Pick<HostOrder, 'number' | 'status' | 'lineItems' | 'quote' | 'totals' | 'taxMode' | 'channel'> & Partial<Pick<HostOrder, 'draftShipping'>>, orderId: string): InvoicePayRefusal | null;
+/** What the customer is told for a refusal, in the page's words: "quote" or "invoice". */
+export declare function invoicePayRefusalMessage(reason: InvoicePayRefusal, storeName: string, kind: OrderPayLinkKind): string;
+/**
+ * The pay link's page for an order that is not a quote: "Invoice #N", its
+ * lines and totals, the customer's addresses, and Pay while it is unpaid. No
+ * proofs, no approval, no notes or terms (an order carries none). Allow-listed
+ * as the quote's view is: the order's email, phone, Stripe ids and timeline
+ * never leave the server.
+ */
+export declare function buildInvoicePageView(input: {
+    order: Pick<HostOrder, 'number' | 'status' | 'channel' | 'lineItems' | 'totals' | 'quote' | 'timeline' | 'taxMode' | 'customerName' | 'billingAddress' | 'shippingAddress'> & Partial<Pick<HostOrder, 'draftShipping'>> & {
+        createdAtMs?: number;
+    };
+    orderId: string;
+    storeName: string;
+    currency: string;
+    /** The order's status page, once paid. */
+    receiptUrl?: string | null;
+}): QuotePageView;
+/** The order's invoice sends on record, oldest first. */
+export declare function invoiceSends(order: Pick<HostOrder, 'invoiceSends'> | null | undefined): OrderInvoiceSendRecord[];
+/** The last time the order's invoice was emailed, or null. */
+export declare function lastInvoiceSend(order: Pick<HostOrder, 'invoiceSends'> | null | undefined): OrderInvoiceSendRecord | null;
+/** Where the invoice goes: what was typed, else the order's customer, else a quote's. */
+export declare function invoiceSendRecipient(order: Pick<HostOrder, 'customerEmail' | 'quote'> | null | undefined, typed: string | null | undefined): string;
+/**
+ * The conversation an invoice replies into: a quote's own (its emails, and a
+ * request's confirmation before them), else the order's, which the first
+ * invoice starts.
+ */
+export declare function invoiceEmailThread(order: Pick<HostOrder, 'quote' | 'emailThread'> | null | undefined): QuoteEmailThread | null;
+/**
+ * The subject an invoice defaults to: the conversation's, so it stays one
+ * conversation in the customer's mailbox, else `Invoice #1042 from Acme Signs`.
+ */
+export declare function invoiceEmailDefaultSubject(order: Pick<HostOrder, 'number' | 'quote' | 'emailThread'>, businessName: string, orderId?: string): string;
+/** Why an invoice cannot be emailed now, and what the console says. */
+export type InvoiceSendRefusal = 'unknown' | 'closed' | 'empty' | 'not-payable' | 'approval-required' | 'tax-undecided' | 'nothing-to-pay' | 'shipping-unknown' | 'no-address' | 'bad-address';
+/**
+ * Why the order's invoice cannot be emailed to `to` now, if it cannot:
+ * a canceled or refunded order, one with nothing on it, an unpaid order its
+ * pay link cannot take payment for (and why), and the address.
+ */
+export declare function invoiceSendRefusal(order: (Pick<HostOrder, 'number' | 'status' | 'channel' | 'lineItems' | 'totals' | 'quote' | 'taxMode'> & Partial<Pick<HostOrder, 'draftShipping'>>) | null | undefined, orderId: string, to: string): InvoiceSendRefusal | null;
+/** What the console says for a refused invoice send. */
+export declare function invoiceSendRefusalMessage(reason: InvoiceSendRefusal): string;
+/** The HTTP status a refused send answers with. */
+export declare function invoiceSendRefusalStatus(reason: InvoiceSendRefusal): number;
+/**
+ * What an invoice email changes on the order, as a merge: the send on
+ * record, a line on the timeline, and the conversation moved on, on the
+ * quote for a quote and on the order otherwise.
+ */
+export declare function invoiceSendPatch(order: Pick<HostOrder, 'timeline' | 'invoiceSends' | 'quote'>, send: OrderInvoiceSendRecord, thread: QuoteEmailThread): {
+    timeline: OrderTimelineEvent[];
+    invoiceSends: OrderInvoiceSendRecord[];
+    emailThread?: QuoteEmailThread;
+    quote?: {
+        emailThread: QuoteEmailThread;
+    };
+};