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

package/src/lib/model/commerce-quote-email.d.ts

@@ -0,0 +1,67 @@
+/**
+ * @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 } from './commerce-orders';
+import { type OrderQuote, type QuoteEmailThread, type QuoteSendRecord } from './commerce-quotes';
+/** The most sends a quote keeps on record; the oldest go first. */
+export declare const QUOTE_MAX_SENDS = 50;
+/** The longest message a send carries. */
+export declare const QUOTE_MAX_SEND_MESSAGE = 5000;
+/** The longest subject a send carries. */
+export declare const QUOTE_MAX_SEND_SUBJECT = 200;
+/** The quote's sends on record, oldest first. */
+export declare function quoteSends(quote: Pick<OrderQuote, 'sends'> | null | undefined): QuoteSendRecord[];
+/** The last time the quote was emailed, or null. */
+export declare function lastQuoteSend(quote: Pick<OrderQuote, 'sends'> | null | undefined): QuoteSendRecord | null;
+/**
+ * Whether emailing the quote now gives the customer a new pay link: they were
+ * emailed an earlier revision, and the link has not been replaced since.
+ */
+export declare function quoteSendReplacesLink(quote: Pick<OrderQuote, 'sends' | 'revision' | 'linkVersion'> | null | undefined): boolean;
+/** What the console's Send button says: `Send quote`, `Send again`, or `Send revision 2`. */
+export declare function quoteSendLabel(quote: Pick<OrderQuote, 'sends' | 'revision'> | null | undefined): string;
+/** Where the quote goes: what was typed in the dialog, else the customer's email. */
+export declare function quoteSendRecipient(order: Pick<HostOrder, 'quote'> | null | undefined, typed: string | null | undefined): string;
+export type QuoteSendRefusal = 'not-a-quote' | 'paid' | 'no-address' | 'bad-address';
+/** Why the quote cannot be emailed to `to` now, if it cannot. */
+export declare function quoteSendRefusal(order: Pick<HostOrder, 'channel' | 'status' | 'quote'> | null | undefined, to: string): QuoteSendRefusal | null;
+export declare function quoteSendRefusalMessage(reason: QuoteSendRefusal): string;
+/**
+ * The subject a send defaults to: the conversation's, so it stays one
+ * conversation, else `Quote #1042 from Acme Signs`.
+ */
+export declare function quoteEmailDefaultSubject(order: Pick<HostOrder, 'number' | 'quote'>, businessName: string, quoteId?: string): string;
+/** What the console sends: where, under what subject, and the business's message. */
+export interface QuoteSendInput {
+    to: string;
+    subject: string;
+    message: string;
+}
+/** A send as the route received it, trimmed, or what to fix. `to` and `subject` may be empty: the defaults fill them. */
+export declare function parseQuoteSendInput(raw: unknown): {
+    ok: true;
+    input: QuoteSendInput;
+} | {
+    ok: false;
+    error: string;
+};
+/**
+ * The quote once an email went out: the send on record, the conversation
+ * moved on, a line on the timeline, and the quote at Sent, unless the
+ * customer has already answered this revision (approved it, or asked for
+ * changes), which stays what it says.
+ */
+export declare function quoteAfterSend(order: HostOrder, send: QuoteSendRecord, thread: QuoteEmailThread): HostOrder;

package/src/lib/model/commerce-quote-email.js

@@ -0,0 +1,154 @@
+import { _ as _extends } from "@swc/helpers/_/_extends";
+/**
+ * @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 { appendOrderEvent } from "./commerce-orders.js";
+import { quoteLinkVersion } from "./commerce-quote-pay.js";
+import { latestQuoteResponse } from "./commerce-quote-proofs.js";
+import { formatQuoteNumber, isQuote, isUnpaidQuote } from "./commerce-quotes.js";
+/*==========================================
+ * EMAILING A QUOTE TO THE CUSTOMER (AGL-4097).
+ *
+ * The business sends the quote from the console: one email in the site's
+ * look with its message, the proof, the PDF and the pay button, in the
+ * customer's existing conversation when there is one. Each send is recorded
+ * on the quote (`quote.sends`) with the revision it carried and the pay link
+ * version it carried, and the conversation is kept as `quote.emailThread`.
+ *
+ * THE PAY LINK ON A NEW REVISION. When the customer was emailed an earlier
+ * revision, the first email of a new revision gives them a new pay link and
+ * retires the old one (slice 2's Replace link), so the link in the earlier
+ * email opens a page saying the quote was updated. A resend of the same
+ * revision keeps the link. "Was the link already replaced since that email"
+ * is read off the record (the link version it carried), which is also what
+ * keeps a send that failed after replacing the link from replacing it again
+ * when it is retried.
+ *
+ * Pure: the console's Send button and the server's send action read the
+ * same answers.
+ *=========================================*/ /** The most sends a quote keeps on record; the oldest go first. */ export const QUOTE_MAX_SENDS = 50;
+/** The longest message a send carries. */ export const QUOTE_MAX_SEND_MESSAGE = 5000;
+/** The longest subject a send carries. */ export const QUOTE_MAX_SEND_SUBJECT = 200;
+const EMAIL = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+/** The quote's sends on record, oldest first. */ export function quoteSends(quote) {
+    return Array.isArray(quote == null ? void 0 : quote.sends) ? quote.sends.filter((send)=>send && typeof send === 'object') : [];
+}
+/** The last time the quote was emailed, or null. */ export function lastQuoteSend(quote) {
+    const sends = quoteSends(quote);
+    return sends.length ? sends[sends.length - 1] : null;
+}
+/**
+ * Whether emailing the quote now gives the customer a new pay link: they were
+ * emailed an earlier revision, and the link has not been replaced since.
+ */ export function quoteSendReplacesLink(quote) {
+    var _ref;
+    const last = lastQuoteSend(quote);
+    if (!last) return false;
+    if (!(Number(last.revision) < Number((_ref = quote == null ? void 0 : quote.revision) != null ? _ref : 1))) return false;
+    return Number(last.linkVersion) === quoteLinkVersion(quote);
+}
+/** What the console's Send button says: `Send quote`, `Send again`, or `Send revision 2`. */ export function quoteSendLabel(quote) {
+    var _ref;
+    const last = lastQuoteSend(quote);
+    if (!last) return 'Send quote';
+    const revision = Number((_ref = quote == null ? void 0 : quote.revision) != null ? _ref : 1);
+    return Number(last.revision) < revision ? `Send revision ${revision}` : 'Send again';
+}
+/** Where the quote goes: what was typed in the dialog, else the customer's email. */ export function quoteSendRecipient(order, typed) {
+    var _ref;
+    var _order_quote_customer, _order_quote;
+    return String(typed != null ? typed : '').trim() || String((_ref = order == null ? void 0 : (_order_quote = order.quote) == null ? void 0 : (_order_quote_customer = _order_quote.customer) == null ? void 0 : _order_quote_customer.email) != null ? _ref : '').trim();
+}
+/** Why the quote cannot be emailed to `to` now, if it cannot. */ export function quoteSendRefusal(order, to) {
+    if (!order || !isQuote(order) || !order.quote) return 'not-a-quote';
+    if (!isUnpaidQuote(order)) return 'paid';
+    if (!to) return 'no-address';
+    if (to.length > 320 || !EMAIL.test(to)) return 'bad-address';
+    return null;
+}
+export function quoteSendRefusalMessage(reason) {
+    switch(reason){
+        case 'not-a-quote':
+            return 'Unknown quote';
+        case 'paid':
+            return 'This quote has been paid, so it is an order now and is not sent again.';
+        case 'no-address':
+            return 'This quote has no email for the customer. Add one to the quote, or type where to send it.';
+        case 'bad-address':
+            return 'Enter a valid email address to send the quote to.';
+    }
+}
+/**
+ * The subject a send defaults to: the conversation's, so it stays one
+ * conversation, else `Quote #1042 from Acme Signs`.
+ */ export function quoteEmailDefaultSubject(order, businessName, quoteId) {
+    var _ref;
+    var _order_quote_emailThread, _order_quote;
+    const thread = String((_ref = (_order_quote = order.quote) == null ? void 0 : (_order_quote_emailThread = _order_quote.emailThread) == null ? void 0 : _order_quote_emailThread.subject) != null ? _ref : '').trim();
+    if (thread) return thread;
+    const name = String(businessName != null ? businessName : '').trim();
+    const number = formatQuoteNumber(order, quoteId);
+    return name ? `${number} from ${name}` : number;
+}
+/** A send as the route received it, trimmed, or what to fix. `to` and `subject` may be empty: the defaults fill them. */ export function parseQuoteSendInput(raw) {
+    const source = raw && typeof raw === 'object' ? raw : {};
+    const text = (value)=>typeof value === 'string' ? value : '';
+    const to = text(source['to']).trim();
+    // A subject is one header line.
+    const subject = text(source['subject']).replace(/[\r\n]+/g, ' ').trim();
+    const message = text(source['message']).replace(/\r\n?/g, '\n').trim();
+    if (subject.length > QUOTE_MAX_SEND_SUBJECT) {
+        return {
+            ok: false,
+            error: `Keep the subject under ${QUOTE_MAX_SEND_SUBJECT} characters.`
+        };
+    }
+    if (message.length > QUOTE_MAX_SEND_MESSAGE) {
+        return {
+            ok: false,
+            error: `Keep the message under ${QUOTE_MAX_SEND_MESSAGE.toLocaleString('en-US')} characters.`
+        };
+    }
+    return {
+        ok: true,
+        input: {
+            to,
+            subject,
+            message
+        }
+    };
+}
+/**
+ * The quote once an email went out: the send on record, the conversation
+ * moved on, a line on the timeline, and the quote at Sent, unless the
+ * customer has already answered this revision (approved it, or asked for
+ * changes), which stays what it says.
+ */ export function quoteAfterSend(order, send, thread) {
+    const quote = order.quote;
+    const answered = latestQuoteResponse(quote) !== null;
+    return _extends({}, order, {
+        timeline: appendOrderEvent(order, 'quote-sent', `Revision ${send.revision} emailed to ${send.to} by ${send.by}`, send.atMs),
+        quote: _extends({}, quote, {
+            stage: answered ? quote.stage : 'sent',
+            sends: [
+                ...quoteSends(quote),
+                send
+            ].slice(-QUOTE_MAX_SENDS),
+            emailThread: thread
+        })
+    });
+}
+
+//# sourceMappingURL=commerce-quote-email.js.map

package/src/lib/model/commerce-quote-email.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/commerce/src/lib/model/commerce-quote-email.ts"],"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 { appendOrderEvent, type HostOrder } from './commerce-orders'\nimport { quoteLinkVersion } from './commerce-quote-pay'\nimport { latestQuoteResponse } from './commerce-quote-proofs'\nimport {\n  formatQuoteNumber,\n  isQuote,\n  isUnpaidQuote,\n  type OrderQuote,\n  type QuoteEmailThread,\n  type QuoteSendRecord,\n} from './commerce-quotes'\n\n/*==========================================\n * EMAILING A QUOTE TO THE CUSTOMER (AGL-4097).\n *\n * The business sends the quote from the console: one email in the site's\n * look with its message, the proof, the PDF and the pay button, in the\n * customer's existing conversation when there is one. Each send is recorded\n * on the quote (`quote.sends`) with the revision it carried and the pay link\n * version it carried, and the conversation is kept as `quote.emailThread`.\n *\n * THE PAY LINK ON A NEW REVISION. When the customer was emailed an earlier\n * revision, the first email of a new revision gives them a new pay link and\n * retires the old one (slice 2's Replace link), so the link in the earlier\n * email opens a page saying the quote was updated. A resend of the same\n * revision keeps the link. \"Was the link already replaced since that email\"\n * is read off the record (the link version it carried), which is also what\n * keeps a send that failed after replacing the link from replacing it again\n * when it is retried.\n *\n * Pure: the console's Send button and the server's send action read the\n * same answers.\n *=========================================*/\n\n/** The most sends a quote keeps on record; the oldest go first. */\nexport const QUOTE_MAX_SENDS = 50\n\n/** The longest message a send carries. */\nexport const QUOTE_MAX_SEND_MESSAGE = 5_000\n\n/** The longest subject a send carries. */\nexport const QUOTE_MAX_SEND_SUBJECT = 200\n\nconst EMAIL = /^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$/\n\n/** The quote's sends on record, oldest first. */\nexport function quoteSends(quote: Pick<OrderQuote, 'sends'> | null | undefined): QuoteSendRecord[] {\n  return Array.isArray(quote?.sends) ? quote.sends.filter((send) => send && typeof send === 'object') : []\n}\n\n/** The last time the quote was emailed, or null. */\nexport function lastQuoteSend(quote: Pick<OrderQuote, 'sends'> | null | undefined): QuoteSendRecord | null {\n  const sends = quoteSends(quote)\n  return sends.length ? sends[sends.length - 1] : null\n}\n\n/**\n * Whether emailing the quote now gives the customer a new pay link: they were\n * emailed an earlier revision, and the link has not been replaced since.\n */\nexport function quoteSendReplacesLink(\n  quote: Pick<OrderQuote, 'sends' | 'revision' | 'linkVersion'> | null | undefined,\n): boolean {\n  const last = lastQuoteSend(quote)\n  if (!last) return false\n  if (!(Number(last.revision) < Number(quote?.revision ?? 1))) return false\n  return Number(last.linkVersion) === quoteLinkVersion(quote)\n}\n\n/** What the console's Send button says: `Send quote`, `Send again`, or `Send revision 2`. */\nexport function quoteSendLabel(quote: Pick<OrderQuote, 'sends' | 'revision'> | null | undefined): string {\n  const last = lastQuoteSend(quote)\n  if (!last) return 'Send quote'\n  const revision = Number(quote?.revision ?? 1)\n  return Number(last.revision) < revision ? `Send revision ${revision}` : 'Send again'\n}\n\n/** Where the quote goes: what was typed in the dialog, else the customer's email. */\nexport function quoteSendRecipient(\n  order: Pick<HostOrder, 'quote'> | null | undefined,\n  typed: string | null | undefined,\n): string {\n  return String(typed ?? '').trim() || String(order?.quote?.customer?.email ?? '').trim()\n}\n\nexport type QuoteSendRefusal = 'not-a-quote' | 'paid' | 'no-address' | 'bad-address'\n\n/** Why the quote cannot be emailed to `to` now, if it cannot. */\nexport function quoteSendRefusal(\n  order: Pick<HostOrder, 'channel' | 'status' | 'quote'> | null | undefined,\n  to: string,\n): QuoteSendRefusal | null {\n  if (!order || !isQuote(order) || !order.quote) return 'not-a-quote'\n  if (!isUnpaidQuote(order)) return 'paid'\n  if (!to) return 'no-address'\n  if (to.length > 320 || !EMAIL.test(to)) return 'bad-address'\n  return null\n}\n\nexport function quoteSendRefusalMessage(reason: QuoteSendRefusal): string {\n  switch (reason) {\n    case 'not-a-quote':\n      return 'Unknown quote'\n    case 'paid':\n      return 'This quote has been paid, so it is an order now and is not sent again.'\n    case 'no-address':\n      return 'This quote has no email for the customer. Add one to the quote, or type where to send it.'\n    case 'bad-address':\n      return 'Enter a valid email address to send the quote to.'\n  }\n}\n\n/**\n * The subject a send defaults to: the conversation's, so it stays one\n * conversation, else `Quote #1042 from Acme Signs`.\n */\nexport function quoteEmailDefaultSubject(\n  order: Pick<HostOrder, 'number' | 'quote'>,\n  businessName: string,\n  quoteId?: string,\n): string {\n  const thread = String(order.quote?.emailThread?.subject ?? '').trim()\n  if (thread) return thread\n  const name = String(businessName ?? '').trim()\n  const number = formatQuoteNumber(order, quoteId)\n  return name ? `${number} from ${name}` : number\n}\n\n/** What the console sends: where, under what subject, and the business's message. */\nexport interface QuoteSendInput {\n  to: string\n  subject: string\n  message: string\n}\n\n/** A send as the route received it, trimmed, or what to fix. `to` and `subject` may be empty: the defaults fill them. */\nexport function parseQuoteSendInput(raw: unknown): { ok: true; input: QuoteSendInput } | { ok: false; error: string } {\n  const source = (raw && typeof raw === 'object' ? raw : {}) as Record<string, unknown>\n  const text = (value: unknown) => (typeof value === 'string' ? value : '')\n  const to = text(source['to']).trim()\n  // A subject is one header line.\n  const subject = text(source['subject']).replace(/[\\r\\n]+/g, ' ').trim()\n  const message = text(source['message']).replace(/\\r\\n?/g, '\\n').trim()\n  if (subject.length > QUOTE_MAX_SEND_SUBJECT) {\n    return { ok: false, error: `Keep the subject under ${QUOTE_MAX_SEND_SUBJECT} characters.` }\n  }\n  if (message.length > QUOTE_MAX_SEND_MESSAGE) {\n    return { ok: false, error: `Keep the message under ${QUOTE_MAX_SEND_MESSAGE.toLocaleString('en-US')} characters.` }\n  }\n  return { ok: true, input: { to, subject, message } }\n}\n\n/**\n * The quote once an email went out: the send on record, the conversation\n * moved on, a line on the timeline, and the quote at Sent, unless the\n * customer has already answered this revision (approved it, or asked for\n * changes), which stays what it says.\n */\nexport function quoteAfterSend(\n  order: HostOrder,\n  send: QuoteSendRecord,\n  thread: QuoteEmailThread,\n): HostOrder {\n  const quote = order.quote as OrderQuote\n  const answered = latestQuoteResponse(quote) !== null\n  return {\n    ...order,\n    timeline: appendOrderEvent(\n      order,\n      'quote-sent',\n      `Revision ${send.revision} emailed to ${send.to} by ${send.by}`,\n      send.atMs,\n    ),\n    quote: {\n      ...quote,\n      stage: answered ? quote.stage : 'sent',\n      sends: [...quoteSends(quote), send].slice(-QUOTE_MAX_SENDS),\n      emailThread: thread,\n    },\n  }\n}\n"],"names":["appendOrderEvent","quoteLinkVersion","latestQuoteResponse","formatQuoteNumber","isQuote","isUnpaidQuote","QUOTE_MAX_SENDS","QUOTE_MAX_SEND_MESSAGE","QUOTE_MAX_SEND_SUBJECT","EMAIL","quoteSends","quote","Array","isArray","sends","filter","send","lastQuoteSend","length","quoteSendReplacesLink","last","Number","revision","linkVersion","quoteSendLabel","quoteSendRecipient","order","typed","String","trim","customer","email","quoteSendRefusal","to","test","quoteSendRefusalMessage","reason","quoteEmailDefaultSubject","businessName","quoteId","thread","emailThread","subject","name","number","parseQuoteSendInput","raw","source","text","value","replace","message","ok","error","toLocaleString","input","quoteAfterSend","answered","timeline","by","atMs","stage","slice"],"mappings":";AAAA;;;;;;;;;;;;;;;CAeC,GAED,SAASA,gBAAgB,QAAwB,uBAAmB;AACpE,SAASC,gBAAgB,QAAQ,0BAAsB;AACvD,SAASC,mBAAmB,QAAQ,6BAAyB;AAC7D,SACEC,iBAAiB,EACjBC,OAAO,EACPC,aAAa,QAIR,uBAAmB;AAE1B;;;;;;;;;;;;;;;;;;;;2CAoB2C,GAE3C,iEAAiE,GACjE,OAAO,MAAMC,kBAAkB,GAAE;AAEjC,wCAAwC,GACxC,OAAO,MAAMC,yBAAyB,KAAK;AAE3C,wCAAwC,GACxC,OAAO,MAAMC,yBAAyB,IAAG;AAEzC,MAAMC,QAAQ;AAEd,+CAA+C,GAC/C,OAAO,SAASC,WAAWC,KAAmD;IAC5E,OAAOC,MAAMC,OAAO,CAACF,yBAAAA,MAAOG,KAAK,IAAIH,MAAMG,KAAK,CAACC,MAAM,CAAC,CAACC,OAASA,QAAQ,OAAOA,SAAS,YAAY,EAAE;AAC1G;AAEA,kDAAkD,GAClD,OAAO,SAASC,cAAcN,KAAmD;IAC/E,MAAMG,QAAQJ,WAAWC;IACzB,OAAOG,MAAMI,MAAM,GAAGJ,KAAK,CAACA,MAAMI,MAAM,GAAG,EAAE,GAAG;AAClD;AAEA;;;CAGC,GACD,OAAO,SAASC,sBACdR,KAAgF;;IAEhF,MAAMS,OAAOH,cAAcN;IAC3B,IAAI,CAACS,MAAM,OAAO;IAClB,IAAI,CAAEC,CAAAA,OAAOD,KAAKE,QAAQ,IAAID,eAAOV,yBAAAA,MAAOW,QAAQ,mBAAI,EAAC,GAAI,OAAO;IACpE,OAAOD,OAAOD,KAAKG,WAAW,MAAMtB,iBAAiBU;AACvD;AAEA,2FAA2F,GAC3F,OAAO,SAASa,eAAeb,KAAgE;;IAC7F,MAAMS,OAAOH,cAAcN;IAC3B,IAAI,CAACS,MAAM,OAAO;IAClB,MAAME,WAAWD,eAAOV,yBAAAA,MAAOW,QAAQ,mBAAI;IAC3C,OAAOD,OAAOD,KAAKE,QAAQ,IAAIA,WAAW,CAAC,cAAc,EAAEA,UAAU,GAAG;AAC1E;AAEA,mFAAmF,GACnF,OAAO,SAASG,mBACdC,KAAkD,EAClDC,KAAgC;;QAEYD,uBAAAA;IAA5C,OAAOE,OAAOD,gBAAAA,QAAS,IAAIE,IAAI,MAAMD,eAAOF,0BAAAA,eAAAA,MAAOf,KAAK,sBAAZe,wBAAAA,aAAcI,QAAQ,qBAAtBJ,sBAAwBK,KAAK,mBAAI,IAAIF,IAAI;AACvF;AAIA,+DAA+D,GAC/D,OAAO,SAASG,iBACdN,KAAyE,EACzEO,EAAU;IAEV,IAAI,CAACP,SAAS,CAACtB,QAAQsB,UAAU,CAACA,MAAMf,KAAK,EAAE,OAAO;IACtD,IAAI,CAACN,cAAcqB,QAAQ,OAAO;IAClC,IAAI,CAACO,IAAI,OAAO;IAChB,IAAIA,GAAGf,MAAM,GAAG,OAAO,CAACT,MAAMyB,IAAI,CAACD,KAAK,OAAO;IAC/C,OAAO;AACT;AAEA,OAAO,SAASE,wBAAwBC,MAAwB;IAC9D,OAAQA;QACN,KAAK;YACH,OAAO;QACT,KAAK;YACH,OAAO;QACT,KAAK;YACH,OAAO;QACT,KAAK;YACH,OAAO;IACX;AACF;AAEA;;;CAGC,GACD,OAAO,SAASC,yBACdX,KAA0C,EAC1CY,YAAoB,EACpBC,OAAgB;;QAEMb,0BAAAA;IAAtB,MAAMc,SAASZ,gBAAOF,eAAAA,MAAMf,KAAK,sBAAXe,2BAAAA,aAAae,WAAW,qBAAxBf,yBAA0BgB,OAAO,mBAAI,IAAIb,IAAI;IACnE,IAAIW,QAAQ,OAAOA;IACnB,MAAMG,OAAOf,OAAOU,uBAAAA,eAAgB,IAAIT,IAAI;IAC5C,MAAMe,SAASzC,kBAAkBuB,OAAOa;IACxC,OAAOI,OAAO,GAAGC,OAAO,MAAM,EAAED,MAAM,GAAGC;AAC3C;AASA,uHAAuH,GACvH,OAAO,SAASC,oBAAoBC,GAAY;IAC9C,MAAMC,SAAUD,OAAO,OAAOA,QAAQ,WAAWA,MAAM,CAAC;IACxD,MAAME,OAAO,CAACC,QAAoB,OAAOA,UAAU,WAAWA,QAAQ;IACtE,MAAMhB,KAAKe,KAAKD,MAAM,CAAC,KAAK,EAAElB,IAAI;IAClC,gCAAgC;IAChC,MAAMa,UAAUM,KAAKD,MAAM,CAAC,UAAU,EAAEG,OAAO,CAAC,YAAY,KAAKrB,IAAI;IACrE,MAAMsB,UAAUH,KAAKD,MAAM,CAAC,UAAU,EAAEG,OAAO,CAAC,UAAU,MAAMrB,IAAI;IACpE,IAAIa,QAAQxB,MAAM,GAAGV,wBAAwB;QAC3C,OAAO;YAAE4C,IAAI;YAAOC,OAAO,CAAC,uBAAuB,EAAE7C,uBAAuB,YAAY,CAAC;QAAC;IAC5F;IACA,IAAI2C,QAAQjC,MAAM,GAAGX,wBAAwB;QAC3C,OAAO;YAAE6C,IAAI;YAAOC,OAAO,CAAC,uBAAuB,EAAE9C,uBAAuB+C,cAAc,CAAC,SAAS,YAAY,CAAC;QAAC;IACpH;IACA,OAAO;QAAEF,IAAI;QAAMG,OAAO;YAAEtB;YAAIS;YAASS;QAAQ;IAAE;AACrD;AAEA;;;;;CAKC,GACD,OAAO,SAASK,eACd9B,KAAgB,EAChBV,IAAqB,EACrBwB,MAAwB;IAExB,MAAM7B,QAAQe,MAAMf,KAAK;IACzB,MAAM8C,WAAWvD,oBAAoBS,WAAW;IAChD,OAAO,aACFe;QACHgC,UAAU1D,iBACR0B,OACA,cACA,CAAC,SAAS,EAAEV,KAAKM,QAAQ,CAAC,YAAY,EAAEN,KAAKiB,EAAE,CAAC,IAAI,EAAEjB,KAAK2C,EAAE,EAAE,EAC/D3C,KAAK4C,IAAI;QAEXjD,OAAO,aACFA;YACHkD,OAAOJ,WAAW9C,MAAMkD,KAAK,GAAG;YAChC/C,OAAO;mBAAIJ,WAAWC;gBAAQK;aAAK,CAAC8C,KAAK,CAAC,CAACxD;YAC3CmC,aAAaD;;;AAGnB"}

package/src/lib/model/commerce-quote-pay.d.ts

@@ -15,14 +15,23 @@
  * limitations under the License.
  */
 import type { ProductType } from './commerce';
-import { type HostOrder, type OrderAddress } from './commerce-orders';
-import { type OrderQuote, type QuoteUnmatchedPayment } from './commerce-quotes';
+import { type HostOrder, type OrderAddress, type OrderLineItem, type OrderStatus } from './commerce-orders';
+import { type OrderQuote, type QuoteDiscount, type QuoteTaxBasis, type QuoteUnmatchedPayment } from './commerce-quotes';
 import type { StorefrontTaxMode } from './commerce-tax-decision';
 import { type OrderListFields } from './order-list-fields';
 /** Stripe's smallest card charge; a quote that totals less cannot be paid by card. */
 export declare const QUOTE_MIN_CHARGE_CENTS = 50;
 /** The pay link version a quote is on; absent reads as the first. */
 export declare function quoteLinkVersion(quote: Pick<OrderQuote, 'linkVersion'> | null | undefined): number;
+/**
+ * The pay link version any order is on (AGL-4099). A quote keeps its version
+ * where slice 2 put it, `quote.linkVersion`, so every link already sent keeps
+ * verifying; any other order keeps it as `payLink.version`. Absent reads as
+ * the first either way.
+ */
+export declare function orderPayLinkVersion(order: Partial<Pick<HostOrder, 'quote' | 'payLink'>> | null | undefined): number;
+/** Payments the order's pay link could not take: a quote's on the quote, any other order's on `payLink`. */
+export declare function orderPayLinkUnmatched(order: Partial<Pick<HostOrder, 'quote' | 'payLink'>> | null | undefined): QuoteUnmatchedPayment[];
 /** An address as the quote page prints it: no phone. */
 export interface QuotePageAddress {
     name: string | null;
@@ -48,6 +57,25 @@ export interface QuotePageLine {
 }
 /** Where the quote stands, as its customer sees it. */
 export type QuotePageStatus = 'unpaid' | 'paid' | 'canceled' | 'refunded';
+/** A proof as the quote page lists it: no storage path, nothing about who attached it. */
+export interface QuotePageProof {
+    id: string;
+    name: string;
+    contentType: string;
+    size: number;
+    /** Shown in the page as a picture; everything else is a download. */
+    inline: boolean;
+}
+/** The customer's latest answer to the revision the page shows. */
+export interface QuotePageResponse {
+    action: 'approve' | 'changes';
+    atMs: number;
+    /** With an approval: the name it was given under. */
+    name: string | null;
+    comment: string | null;
+    /** How many files came with it. */
+    files: number;
+}
 /**
  * What the quote page shows. Allow-listed, never spread: the order document
  * carries the customer's email and phone, Stripe ids, the business's own
@@ -56,8 +84,14 @@ export type QuotePageStatus = 'unpaid' | 'paid' | 'canceled' | 'refunded';
  */
 export interface QuotePageView {
     state: 'quote';
+    /**
+     * What the page shows (AGL-4099): a quote, or an invoice for an order the
+     * business sent one for. An invoice has no proofs and no approval, and the
+     * page says "invoice" where a quote's says "quote".
+     */
+    kind: 'quote' | 'invoice';
     storeName: string;
-    /** `Quote #1042`. */
+    /** `Quote #1042`, or `Invoice #1042`. */
     number: string;
     /** When the quote was last written, which is the date it carries. */
     dateMs: number | null;
@@ -85,6 +119,12 @@ export interface QuotePageView {
     taxLabel: string;
     /** Stripe Tax works the tax out when the customer pays; `taxCents` is 0 until then. */
     taxAtPayment: boolean;
+    /**
+     * The customer picks a shipping rate when they pay (an invoiced draft
+     * order, AGL-4099); `shippingCents` is 0 until then. A quote's shipping is
+     * priced on it, so this is false for every quote.
+     */
+    shippingAtPayment: boolean;
     notes: string | null;
     terms: string | null;
     status: QuotePageStatus;
@@ -96,12 +136,27 @@ export interface QuotePageView {
     approvalRequired: boolean;
     /** A Pay button belongs on the page. */
     payable: boolean;
+    /** The revision the page shows (AGL-4096). */
+    revision: number;
+    /** That revision's proofs. */
+    proofs: QuotePageProof[];
+    /** The customer's latest answer to it, if any. */
+    response: QuotePageResponse | null;
+    /** Approve and Request changes belong on the page. */
+    respondable: boolean;
 }
 /** What a signed link for an older version of the quote opens: nothing of the quote. */
 export interface QuotePageReplacedView {
     state: 'replaced';
     storeName: string;
 }
+/** An address as the pay link's page prints it, or null when it says nothing. */
+export declare function quotePageAddress(address: OrderAddress | null | undefined): QuotePageAddress | null;
+/** Where an order stands as the pay link's page says it. */
+export declare function quotePageStatus(status: OrderStatus | string | undefined): {
+    status: QuotePageStatus;
+    label: string;
+};
 /**
  * The quote page's view of an order document on the `quote` channel. Totals
  * are the stored lines' through {@link computeQuoteTotals} until the quote is
@@ -115,6 +170,8 @@ export declare function buildQuotePageView(input: {
     /** The order's status page, for a paid quote. */
     receiptUrl?: string | null;
 }): QuotePageView;
+/** Order lines as the pay link's page lists them: what each charges, nothing about stock or cost. */
+export declare function quotePageLines(lines: readonly OrderLineItem[]): QuotePageLine[];
 /** One line of a quote's Checkout Session. */
 export interface QuoteCheckoutLine {
     name: string;
@@ -160,6 +217,19 @@ export interface QuoteCheckoutCharge {
  * line it amounts to. Included lines charge nothing and are not sent.
  */
 export declare function quoteCheckoutCharge(order: Pick<HostOrder, 'number' | 'lineItems' | 'quote'>, orderId: string): QuoteCheckoutCharge;
+/**
+ * What a pay link's Checkout Session charges for stored lines, a discount,
+ * fixed shipping and a tax basis, under a label (`Quote #1042`,
+ * `Invoice #1042`): {@link quoteCheckoutCharge}'s pricing, shared with an
+ * invoiced order's (AGL-4099), so both are charged the same way.
+ */
+export declare function payLinkCheckoutCharge(input: {
+    lineItems: readonly OrderLineItem[];
+    tax: QuoteTaxBasis;
+    discount: QuoteDiscount | null;
+    shippingCents: number;
+    label: string;
+}): QuoteCheckoutCharge;
 export type QuotePayRefusal = 'paid' | 'closed' | 'approval-required' | 'tax-undecided' | 'nothing-to-pay';
 /** Why a quote cannot be paid now, or null when it can. */
 export declare function quotePayRefusal(order: Pick<HostOrder, 'number' | 'status' | 'lineItems' | 'quote'>, orderId: string): QuotePayRefusal | null;
@@ -202,11 +272,11 @@ export interface QuotePaymentFacts {
  * the business is told, so a payment is never fulfilled twice and never lost.
  */
 export type QuotePaymentDisposition = 'pay' | 'superseded' | 'already-paid' | 'redelivery';
-export declare function quotePaymentDisposition(order: Pick<HostOrder, 'status' | 'quote' | 'checkoutSessionId' | 'paymentIntentId'>, payment: Pick<QuotePaymentFacts, 'sessionId' | 'paymentIntentId' | 'linkVersion' | 'quoteUpdatedAtMs'>): QuotePaymentDisposition;
+export declare function quotePaymentDisposition(order: Pick<HostOrder, 'status' | 'quote' | 'checkoutSessionId' | 'paymentIntentId'> & Partial<Pick<HostOrder, 'payLink'>>, payment: Pick<QuotePaymentFacts, 'sessionId' | 'paymentIntentId' | 'linkVersion' | 'quoteUpdatedAtMs'>): QuotePaymentDisposition;
 /** A payment the quote could not take, as {@link QuoteUnmatchedPayment} records it. */
 export declare function quoteUnmatchedPayment(facts: Pick<QuotePaymentFacts, 'sessionId' | 'paymentIntentId' | 'amountTotalCents' | 'paidAtMs'>, reason: QuoteUnmatchedPayment['reason']): QuoteUnmatchedPayment;
-/** The timeline line for a payment the quote could not take. */
-export declare function quoteUnmatchedPaymentDetail(entry: QuoteUnmatchedPayment): string;
+/** The timeline line for a payment the quote (or an order's invoice, AGL-4099) could not take. */
+export declare function quoteUnmatchedPaymentDetail(entry: QuoteUnmatchedPayment, noun?: 'quote' | 'invoice'): string;
 /**
  * The order a paid quote becomes, the whole document as it will stand. A
  * quote carries none of the fields order lists read (`commerce-quotes.ts`);