@aglyn/plugins-commerce 1.0.0-beta.290 → 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":"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"}

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;
@@ -75,8 +84,14 @@ export interface QuotePageResponse {
  */
 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;
@@ -104,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;
@@ -129,6 +150,13 @@ 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
@@ -142,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;
@@ -187,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;
@@ -229,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`);

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

@@ -44,6 +44,22 @@ import { withOrderListFields } from "./order-list-fields.js";
     const version = Math.floor(Number(quote == null ? void 0 : quote.linkVersion));
     return Number.isFinite(version) && version >= 1 ? version : 1;
 }
+/**
+ * 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 function orderPayLinkVersion(order) {
+    var _order_payLink;
+    if (order == null ? void 0 : order.quote) return quoteLinkVersion(order.quote);
+    const version = Math.floor(Number(order == null ? void 0 : (_order_payLink = order.payLink) == null ? void 0 : _order_payLink.version));
+    return Number.isFinite(version) && version >= 1 ? version : 1;
+}
+/** Payments the order's pay link could not take: a quote's on the quote, any other order's on `payLink`. */ export function orderPayLinkUnmatched(order) {
+    var _order_payLink;
+    const list = (order == null ? void 0 : order.quote) ? order.quote.unmatchedPayments : order == null ? void 0 : (_order_payLink = order.payLink) == null ? void 0 : _order_payLink.unmatchedPayments;
+    return Array.isArray(list) ? list.filter((entry)=>entry && typeof entry === 'object') : [];
+}
 const text = (value)=>{
     const trimmed = typeof value === 'string' ? value.trim() : '';
     return trimmed ? trimmed : null;
@@ -52,7 +68,7 @@ const cents = (value)=>{
     const number = Math.round(Number(value));
     return Number.isFinite(number) ? number : 0;
 };
-function pageAddress(address) {
+/** An address as the pay link's page prints it, or null when it says nothing. */ export function quotePageAddress(address) {
     if (!address) return null;
     const view = {
         name: text(address.name),
@@ -65,7 +81,7 @@ function pageAddress(address) {
     };
     return Object.values(view).some(Boolean) ? view : null;
 }
-function pageStatus(status) {
+/** Where an order stands as the pay link's page says it. */ export function quotePageStatus(status) {
     if (status === 'pending') return {
         status: 'unpaid',
         label: 'Unpaid'
@@ -106,7 +122,7 @@ function discountLabel(discount) {
     const { order } = input;
     const quote = order.quote;
     const lines = (_order_lineItems = order.lineItems) != null ? _order_lineItems : [];
-    const status = pageStatus(order.status);
+    const status = quotePageStatus(order.status);
     const unpaid = status.status === 'unpaid';
     const charge = quoteCheckoutCharge(order, input.orderId);
     const stored = order.totals;
@@ -127,6 +143,7 @@ function discountLabel(discount) {
     const taxAtPayment = unpaid && (quote == null ? void 0 : (_quote_tax = quote.tax) == null ? void 0 : _quote_tax.kind) === 'at-payment';
     return {
         state: 'quote',
+        kind: 'quote',
         storeName: input.storeName,
         number: formatQuoteNumber(order, input.orderId),
         dateMs: Number((_ref = quote == null ? void 0 : quote.updatedAtMs) != null ? _ref : quote == null ? void 0 : quote.createdAtMs) || null,
@@ -134,29 +151,15 @@ function discountLabel(discount) {
         currency: input.currency || 'USD',
         customerName: (_text = text(quote == null ? void 0 : (_quote_customer = quote.customer) == null ? void 0 : _quote_customer.name)) != null ? _text : text(quote == null ? void 0 : (_quote_customer1 = quote.customer) == null ? void 0 : _quote_customer1.company),
         company: text(quote == null ? void 0 : (_quote_customer2 = quote.customer) == null ? void 0 : _quote_customer2.name) ? text(quote == null ? void 0 : (_quote_customer3 = quote.customer) == null ? void 0 : _quote_customer3.company) : null,
-        billTo: pageAddress(quote == null ? void 0 : quote.billTo),
-        shipTo: pageAddress(quote == null ? void 0 : quote.shipTo),
-        lines: lines.map((line)=>{
-            var _line_name;
-            const included = line.included === true;
-            const quantity = Math.max(0, cents(line.quantity));
-            const unitAmountCents = included ? 0 : Math.max(0, cents(line.unitAmountCents));
-            return {
-                name: String((_line_name = line.name) != null ? _line_name : ''),
-                variantLabel: text(line.variantLabel),
-                description: text(line.description),
-                sku: text(line.sku),
-                quantity,
-                unitAmountCents,
-                amountCents: unitAmountCents * quantity,
-                included
-            };
-        }),
+        billTo: quotePageAddress(quote == null ? void 0 : quote.billTo),
+        shipTo: quotePageAddress(quote == null ? void 0 : quote.shipTo),
+        lines: quotePageLines(lines),
         totals,
         discountLabel: discountLabel(quote == null ? void 0 : quote.discount),
         // Once paid, the tax is what was charged: Stripe's figure under Stripe Tax.
         taxLabel: unpaid || (quote == null ? void 0 : (_quote_tax1 = quote.tax) == null ? void 0 : _quote_tax1.kind) !== 'at-payment' ? describeQuoteTax(quote == null ? void 0 : quote.tax) : 'Tax',
         taxAtPayment,
+        shippingAtPayment: false,
         notes: text(quote == null ? void 0 : quote.notes),
         terms: text(quote == null ? void 0 : quote.terms),
         status: status.status,
@@ -185,6 +188,24 @@ function discountLabel(discount) {
         }) === null
     };
 }
+/** Order lines as the pay link's page lists them: what each charges, nothing about stock or cost. */ export function quotePageLines(lines) {
+    return lines.map((line)=>{
+        var _line_name;
+        const included = line.included === true;
+        const quantity = Math.max(0, cents(line.quantity));
+        const unitAmountCents = included ? 0 : Math.max(0, cents(line.unitAmountCents));
+        return {
+            name: String((_line_name = line.name) != null ? _line_name : ''),
+            variantLabel: text(line.variantLabel),
+            description: text(line.description),
+            sku: text(line.sku),
+            quantity,
+            unitAmountCents,
+            amountCents: unitAmountCents * quantity,
+            included
+        };
+    });
+}
 /** The latest answer, as the page may show it back to the link's holder: never the address or browser. */ function pageResponse(quote) {
     var _ref;
     var _latest_files;
@@ -230,13 +251,24 @@ function lineSummary(lines) {
  */ export function quoteCheckoutCharge(order, orderId) {
     var _order_lineItems, _ref, _ref1;
     var _order_quote, _order_quote1, _order_quote_shipping, _order_quote2;
-    const lineItems = (_order_lineItems = order.lineItems) != null ? _order_lineItems : [];
-    const tax = (_ref = (_order_quote = order.quote) == null ? void 0 : _order_quote.tax) != null ? _ref : {
-        kind: 'none',
-        reason: 'not-collected'
-    };
-    const discount = (_ref1 = (_order_quote1 = order.quote) == null ? void 0 : _order_quote1.discount) != null ? _ref1 : null;
-    const shippingCents = Math.max(0, cents((_order_quote2 = order.quote) == null ? void 0 : (_order_quote_shipping = _order_quote2.shipping) == null ? void 0 : _order_quote_shipping.amountCents));
+    return payLinkCheckoutCharge({
+        lineItems: (_order_lineItems = order.lineItems) != null ? _order_lineItems : [],
+        tax: (_ref = (_order_quote = order.quote) == null ? void 0 : _order_quote.tax) != null ? _ref : {
+            kind: 'none',
+            reason: 'not-collected'
+        },
+        discount: (_ref1 = (_order_quote1 = order.quote) == null ? void 0 : _order_quote1.discount) != null ? _ref1 : null,
+        shippingCents: Math.max(0, cents((_order_quote2 = order.quote) == null ? void 0 : (_order_quote_shipping = _order_quote2.shipping) == null ? void 0 : _order_quote_shipping.amountCents)),
+        label: formatQuoteNumber(order, orderId)
+    });
+}
+/**
+ * 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 function payLinkCheckoutCharge(input) {
+    const { lineItems, tax, discount, shippingCents, label } = input;
     const totals = computeQuoteTotals({
         lines: lineItems,
         discount,
@@ -244,7 +276,6 @@ function lineSummary(lines) {
         tax
     });
     const amounts = quoteLineAmounts(lineItems, discount);
-    const label = formatQuoteNumber(order, orderId);
     const groups = [
         true,
         false
@@ -323,20 +354,22 @@ function lineSummary(lines) {
     }
 }
 export function quotePaymentDisposition(order, payment) {
-    var _ref;
-    var _order_quote, _order_quote1;
-    const recorded = ((_ref = (_order_quote = order.quote) == null ? void 0 : _order_quote.unmatchedPayments) != null ? _ref : []).some((entry)=>(entry == null ? void 0 : entry.sessionId) === payment.sessionId);
+    var _order_quote;
+    // Any order's pay link answers the same way (AGL-4099): an invoiced order
+    // reads its version and its recorded payments off `payLink`, and its
+    // session carries no quote edit to compare.
+    const recorded = orderPayLinkUnmatched(order).some((entry)=>(entry == null ? void 0 : entry.sessionId) === payment.sessionId);
     if (recorded) return 'redelivery';
     if (order.status !== 'pending') {
         const same = order.checkoutSessionId && order.checkoutSessionId === payment.sessionId || payment.paymentIntentId && order.paymentIntentId === payment.paymentIntentId;
         return same ? 'redelivery' : 'already-paid';
     }
     const sentVersion = payment.linkVersion;
-    if (sentVersion != null && sentVersion !== '' && Number(sentVersion) !== quoteLinkVersion(order.quote)) {
+    if (sentVersion != null && sentVersion !== '' && Number(sentVersion) !== orderPayLinkVersion(order)) {
         return 'superseded';
     }
     const sentEdit = payment.quoteUpdatedAtMs;
-    if (sentEdit != null && sentEdit !== '' && Number(sentEdit) !== Number((_order_quote1 = order.quote) == null ? void 0 : _order_quote1.updatedAtMs)) {
+    if (sentEdit != null && sentEdit !== '' && Number(sentEdit) !== Number((_order_quote = order.quote) == null ? void 0 : _order_quote.updatedAtMs)) {
         return 'superseded';
     }
     return 'pay';
@@ -350,9 +383,9 @@ export function quotePaymentDisposition(order, payment) {
         reason
     };
 }
-/** The timeline line for a payment the quote could not take. */ export function quoteUnmatchedPaymentDetail(entry) {
+/** The timeline line for a payment the quote (or an order's invoice, AGL-4099) could not take. */ export function quoteUnmatchedPaymentDetail(entry, noun = 'quote') {
     const amount = `$${(entry.amountCents / 100).toFixed(2)}`;
-    return entry.reason === 'superseded' ? `A payment of ${amount} came through a pay link that was replaced, or for an earlier ` + 'version of this quote. The money is in Stripe and this quote records no sale for it; ' + 'refund it in Stripe, or reconcile it by hand.' : `A second payment of ${amount} came in after this quote was paid. The money is in Stripe ` + 'and no second sale was recorded; refund it in Stripe, or reconcile it by hand.';
+    return entry.reason === 'superseded' ? `A payment of ${amount} came through a pay link that was replaced, or for an earlier ` + `version of this ${noun}. The money is in Stripe and this ${noun} records no sale for it; ` + 'refund it in Stripe, or reconcile it by hand.' : `A second payment of ${amount} came in after this ${noun} was paid. The money is in Stripe ` + 'and no second sale was recorded; refund it in Stripe, or reconcile it by hand.';
 }
 /**
  * The order a paid quote becomes, the whole document as it will stand. A