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

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;
+    };
+};

package/src/lib/model/commerce-invoices.js

@@ -0,0 +1,332 @@
+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, formatOrderNumber, orderCreatedAtMs } from "./commerce-orders.js";
+import { QUOTE_MIN_CHARGE_CENTS, payLinkCheckoutCharge, quoteCheckoutCharge, quotePageAddress, quotePageLines, quotePageStatus, quotePayRefusal, quotePayRefusalMessage } from "./commerce-quote-pay.js";
+import { isQuote } from "./commerce-quotes.js";
+import { lineRequiresShipping } from "./order-fulfillment.js";
+/** The most invoice sends an order keeps on record; the oldest go first. */ export const INVOICE_MAX_SENDS = 50;
+const EMAIL = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+const cents = (value)=>{
+    const number = Math.round(Number(value));
+    return Number.isFinite(number) ? number : 0;
+};
+const text = (value)=>{
+    const trimmed = typeof value === 'string' ? value.trim() : '';
+    return trimmed ? trimmed : null;
+};
+/**
+ * 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 function orderPayLinkKind(order) {
+    if (!order) return null;
+    if (isQuote(order)) return order.quote ? 'quote' : null;
+    return order.channel === 'draft' ? 'invoice' : null;
+}
+/** `Invoice #1042`: the order's own number, which a paid quote keeps too. */ export function formatInvoiceNumber(order, orderId) {
+    return `Invoice ${formatOrderNumber(order, orderId)}`;
+}
+const PAID_STATUSES = new Set([
+    'paid',
+    'partially_fulfilled',
+    'fulfilled',
+    'delivered'
+]);
+/** The order is paid (and not refunded or canceled): its invoice is the record. */ export function invoiceIsPaid(order) {
+    var _ref;
+    return PAID_STATUSES.has(String((_ref = order == null ? void 0 : order.status) != null ? _ref : ''));
+}
+/**
+ * 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 function orderPaidAtMs(order) {
+    var _order_timeline;
+    var _order_quote;
+    if (!order || order.status === 'pending') return null;
+    const stamped = Number((_order_quote = order.quote) == null ? void 0 : _order_quote.paidAtMs);
+    if (Number.isFinite(stamped) && stamped > 0) return stamped;
+    const event = ((_order_timeline = order.timeline) != null ? _order_timeline : []).find((entry)=>(entry == null ? void 0 : entry.event) === 'paid');
+    if (event && Number(event.atMs) > 0) return Number(event.atMs);
+    const created = orderCreatedAtMs(order);
+    return created > 0 ? created : null;
+}
+/**
+ * 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 function invoiceTaxBasis(order) {
+    var _order_totals;
+    if (order.taxMode === 'stripe-automatic') return {
+        kind: 'at-payment'
+    };
+    const taxCents = Math.max(0, cents((_order_totals = order.totals) == null ? void 0 : _order_totals.taxCents));
+    if (taxCents > 0) return {
+        kind: 'service',
+        taxCents
+    };
+    return {
+        kind: 'none',
+        reason: 'not-collected'
+    };
+}
+/** A stored draft rate, as Stripe is given it, or null for one that is not a rate. */ function draftRate(option) {
+    var _source_rateId;
+    if (!option || typeof option !== 'object') return null;
+    const source = option;
+    const name = text(source['name']);
+    const amountCents = cents(source['amountCents']);
+    if (!name || amountCents < 0) return null;
+    return {
+        rateId: String((_source_rateId = source['rateId']) != null ? _source_rateId : '') || name,
+        name,
+        amountCents
+    };
+}
+/**
+ * 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 function invoiceCheckoutCharge(order, orderId) {
+    var _order_lineItems, _ref, _ref1;
+    var _order_totals, _order_draftShipping, _order_draftShipping1;
+    if (order.quote) return _extends({}, quoteCheckoutCharge(order, orderId), {
+        shippingOptions: [],
+        shippingCountries: []
+    });
+    const discountCents = Math.max(0, cents((_order_totals = order.totals) == null ? void 0 : _order_totals.discountCents));
+    const charge = payLinkCheckoutCharge({
+        lineItems: (_order_lineItems = order.lineItems) != null ? _order_lineItems : [],
+        tax: invoiceTaxBasis(order),
+        discount: discountCents > 0 ? {
+            kind: 'amount',
+            amountCents: discountCents
+        } : null,
+        shippingCents: 0,
+        label: formatInvoiceNumber(order, orderId)
+    });
+    const options = ((_ref = (_order_draftShipping = order.draftShipping) == null ? void 0 : _order_draftShipping.options) != null ? _ref : []).map(draftRate).filter((rate)=>rate !== null).slice(0, 5);
+    const countries = ((_ref1 = (_order_draftShipping1 = order.draftShipping) == null ? void 0 : _order_draftShipping1.countries) != null ? _ref1 : []).map((country)=>String(country != null ? country : '').trim().toUpperCase()).filter((country)=>/^[A-Z]{2}$/.test(country));
+    return _extends({}, charge, {
+        shippingOptions: options,
+        shippingCountries: options.length ? countries : []
+    });
+}
+export function invoicePayRefusal(order, orderId) {
+    var _order_lineItems;
+    const kind = orderPayLinkKind(order);
+    if (kind === 'quote') return quotePayRefusal(order, orderId);
+    if (order.status === 'cancelled' || order.status === 'refunded') return 'closed';
+    if (order.status !== 'pending') return 'paid';
+    if (kind !== 'invoice') return 'not-payable';
+    const ships = ((_order_lineItems = order.lineItems) != null ? _order_lineItems : []).some((line)=>line && !line.included && lineRequiresShipping(line));
+    if (ships && !order.draftShipping) return 'shipping-unknown';
+    if (invoiceCheckoutCharge(order, orderId).totalCents < QUOTE_MIN_CHARGE_CENTS) return 'nothing-to-pay';
+    return null;
+}
+/** What the customer is told for a refusal, in the page's words: "quote" or "invoice". */ export function invoicePayRefusalMessage(reason, storeName, kind) {
+    const business = storeName.trim() || 'the business';
+    if (kind === 'quote' && reason !== 'not-payable' && reason !== 'shipping-unknown') {
+        return quotePayRefusalMessage(reason, storeName);
+    }
+    switch(reason){
+        case 'paid':
+            return 'This invoice has been paid.';
+        case 'closed':
+            return `This invoice is closed. Contact ${business} with any questions.`;
+        case 'approval-required':
+            return `${business} asks you to approve the proof before you pay.`;
+        case 'tax-undecided':
+            return `${business} has not finished setting up payments. Contact them to pay this invoice.`;
+        case 'nothing-to-pay':
+            return `This invoice has nothing to pay by card. Contact ${business} with any questions.`;
+        case 'not-payable':
+        case 'shipping-unknown':
+            return `This invoice can’t be paid online. Contact ${business} to pay it.`;
+    }
+}
+/*==========================================
+ * THE CUSTOMER'S PAGE FOR AN INVOICE
+ *=========================================*/ /**
+ * 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 function buildInvoicePageView(input) {
+    var _order_lineItems, _input_receiptUrl;
+    const { order } = input;
+    const status = quotePageStatus(order.status);
+    const unpaid = status.status === 'unpaid';
+    const charge = invoiceCheckoutCharge(order, input.orderId);
+    const stored = order.totals;
+    const totals = unpaid || !stored ? {
+        itemsCents: charge.itemsCents,
+        discountCents: charge.discountCents,
+        shippingCents: charge.shippingCents,
+        taxCents: charge.taxCents,
+        totalCents: charge.totalCents
+    } : {
+        itemsCents: cents(stored.itemsCents),
+        discountCents: cents(stored.discountCents),
+        shippingCents: cents(stored.shippingCents),
+        taxCents: cents(stored.taxCents),
+        totalCents: cents(stored.totalCents)
+    };
+    const taxAtPayment = unpaid && charge.taxAtPayment;
+    const created = orderCreatedAtMs(order);
+    return {
+        state: 'quote',
+        kind: 'invoice',
+        storeName: input.storeName,
+        number: formatInvoiceNumber(order, input.orderId),
+        dateMs: created > 0 ? created : null,
+        // An invoice is not edited; the page has no version to send back.
+        version: 0,
+        currency: input.currency || 'USD',
+        customerName: text(order.customerName),
+        company: null,
+        billTo: quotePageAddress(order.billingAddress),
+        shipTo: quotePageAddress(order.shippingAddress),
+        lines: quotePageLines((_order_lineItems = order.lineItems) != null ? _order_lineItems : []),
+        totals,
+        discountLabel: null,
+        taxLabel: taxAtPayment ? 'Tax is added at payment' : 'Tax',
+        taxAtPayment,
+        shippingAtPayment: unpaid && charge.shippingOptions.length > 0,
+        notes: null,
+        terms: null,
+        status: status.status,
+        statusLabel: status.label,
+        paidAtMs: orderPaidAtMs(order),
+        receiptUrl: unpaid ? null : (_input_receiptUrl = input.receiptUrl) != null ? _input_receiptUrl : null,
+        approvalRequired: false,
+        payable: unpaid && invoicePayRefusal(order, input.orderId) === null,
+        revision: 1,
+        proofs: [],
+        response: null,
+        respondable: false
+    };
+}
+/*==========================================
+ * EMAILING AN INVOICE
+ *=========================================*/ /** The order's invoice sends on record, oldest first. */ export function invoiceSends(order) {
+    return Array.isArray(order == null ? void 0 : order.invoiceSends) ? order.invoiceSends.filter((send)=>send && typeof send === 'object') : [];
+}
+/** The last time the order's invoice was emailed, or null. */ export function lastInvoiceSend(order) {
+    const sends = invoiceSends(order);
+    return sends.length ? sends[sends.length - 1] : null;
+}
+/** Where the invoice goes: what was typed, else the order's customer, else a quote's. */ export function invoiceSendRecipient(order, typed) {
+    var _ref, _ref1;
+    var _order_quote_customer, _order_quote;
+    return String(typed != null ? typed : '').trim() || String((_ref = order == null ? void 0 : order.customerEmail) != null ? _ref : '').trim() || String((_ref1 = 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 ? _ref1 : '').trim();
+}
+/**
+ * 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 function invoiceEmailThread(order) {
+    var _order_quote_emailThread, _ref;
+    if (order == null ? void 0 : order.quote) return (_order_quote_emailThread = order.quote.emailThread) != null ? _order_quote_emailThread : null;
+    return (_ref = order == null ? void 0 : order.emailThread) != null ? _ref : 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 function invoiceEmailDefaultSubject(order, businessName, orderId) {
+    var _ref;
+    var _invoiceEmailThread;
+    const thread = String((_ref = (_invoiceEmailThread = invoiceEmailThread(order)) == null ? void 0 : _invoiceEmailThread.subject) != null ? _ref : '').trim();
+    if (thread) return thread;
+    const name = String(businessName != null ? businessName : '').trim();
+    const number = formatInvoiceNumber(order, orderId);
+    return name ? `${number} from ${name}` : number;
+}
+/**
+ * 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 function invoiceSendRefusal(order, orderId, to) {
+    var _order_lineItems;
+    var _order_totals;
+    if (!order) return 'unknown';
+    if (order.status === 'cancelled' || order.status === 'refunded') return 'closed';
+    const lines = ((_order_lineItems = order.lineItems) != null ? _order_lineItems : []).filter(Boolean);
+    if (!lines.length && cents((_order_totals = order.totals) == null ? void 0 : _order_totals.totalCents) <= 0) return 'empty';
+    if (!invoiceIsPaid(order)) {
+        const refused = invoicePayRefusal(order, orderId);
+        if (refused === 'closed') return 'closed';
+        if (refused && refused !== 'paid') return refused;
+    }
+    if (!to) return 'no-address';
+    if (to.length > 320 || !EMAIL.test(to)) return 'bad-address';
+    return null;
+}
+/** What the console says for a refused invoice send. */ export function invoiceSendRefusalMessage(reason) {
+    switch(reason){
+        case 'unknown':
+            return 'Unknown order';
+        case 'closed':
+            return 'This order was canceled or refunded, so it has no invoice to send.';
+        case 'empty':
+            return 'This order has no items and no total, so there is nothing to put on an invoice.';
+        case 'not-payable':
+            return 'This order isn’t paid yet, and it can’t be paid online from an invoice. Take its payment where the sale was made, then send the invoice.';
+        case 'approval-required':
+            return 'This quote asks your customer to approve the proof before they pay, and they haven’t yet. Send the quote so they can approve it, then send the invoice.';
+        case 'tax-undecided':
+            return 'Sales tax isn’t set up for this store yet, so the invoice can’t be paid online. Finish the tax settings, then send it.';
+        case 'nothing-to-pay':
+            return 'This invoice totals less than $0.50, so it can’t be paid by card.';
+        case 'shipping-unknown':
+            return 'This draft order was made before invoices could charge its shipping, so its invoice can’t be paid online. Make a new draft order and send its invoice.';
+        case 'no-address':
+            return 'This order has no email for the customer. Type where to send the invoice.';
+        case 'bad-address':
+            return 'Enter a valid email address to send the invoice to.';
+    }
+}
+/** The HTTP status a refused send answers with. */ export function invoiceSendRefusalStatus(reason) {
+    if (reason === 'unknown') return 404;
+    if (reason === 'no-address' || reason === 'bad-address') return 400;
+    return 409;
+}
+/**
+ * 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 function invoiceSendPatch(order, send, thread) {
+    return _extends({
+        timeline: appendOrderEvent(order, 'invoice-sent', // The address is on the send record, which erasure clears; the timeline keeps none.
+        `${send.paid ? 'Paid invoice' : 'Invoice'} emailed to the customer by ${send.by}`, send.atMs),
+        invoiceSends: [
+            ...invoiceSends(order),
+            send
+        ].slice(-INVOICE_MAX_SENDS)
+    }, order.quote ? {
+        quote: {
+            emailThread: thread
+        }
+    } : {
+        emailThread: thread
+    });
+}
+
+//# sourceMappingURL=commerce-invoices.js.map

package/src/lib/model/commerce-invoices.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/commerce/src/lib/model/commerce-invoices.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 {\n  appendOrderEvent,\n  formatOrderNumber,\n  orderCreatedAtMs,\n  type HostOrder,\n  type OrderStatus,\n  type OrderTimelineEvent,\n} from './commerce-orders'\nimport {\n  QUOTE_MIN_CHARGE_CENTS,\n  payLinkCheckoutCharge,\n  quoteCheckoutCharge,\n  quotePageAddress,\n  quotePageLines,\n  quotePageStatus,\n  quotePayRefusal,\n  quotePayRefusalMessage,\n  type QuoteCheckoutCharge,\n  type QuotePageView,\n  type QuotePayRefusal,\n} from './commerce-quote-pay'\nimport {\n  isQuote,\n  type OrderInvoiceSendRecord,\n  type QuoteEmailThread,\n  type QuoteTaxBasis,\n} from './commerce-quotes'\nimport type { ResolvedShippingRate } from './commerce-shipping'\nimport { lineRequiresShipping } from './order-fulfillment'\n\n/*==========================================\n * INVOICES FOR ORDERS AND QUOTES (AGL-4099).\n *\n * The business emails an invoice for an order or a quote: unpaid, it asks\n * for payment through ONE lasting pay link; paid, it is the record. The link\n * is slice 2's (`/pay-quote?q=&t=`, AGL-4094), generalized rather than made\n * twice:\n *\n * - THE TOKEN is unchanged: `<version>.<HMAC(quote-link:hostId:orderId:version)>`,\n *   no expiry. An order id names one document under `hosts/{hostId}/orders`\n *   whatever its channel, so the same signature serves any order.\n * - THE VERSION is the quote's `quote.linkVersion` for a quote, as before,\n *   so every link already sent keeps verifying; any other order keeps its own\n *   as `payLink.version` (`orderPayLinkVersion`). Absent reads as 1.\n * - WHICH ORDERS the link opens ({@link orderPayLinkKind}): a quote, and a\n *   draft order (`channel: 'draft'`), the two a business composes for a\n *   customer to pay online. A register sale still open takes its payment at\n *   the register, an online order was paid at checkout, and a marketplace\n *   order on its channel, so none of them is linked; their invoices go out\n *   paid, as the record.\n * - THE PAGE shows a non-quote order as \"Invoice #N\", with no proofs and no\n *   approval ({@link buildInvoicePageView}).\n * - THE CHARGE is priced from the stored lines and totals on every press\n *   ({@link invoiceCheckoutCharge}): the draft's discount, its frozen tax (or\n *   Stripe Tax at payment where the draft used it), and the shipping rates\n *   the draft offered when it was made (`draftShipping`).\n *\n * Pure: the console, the routes and the webhook read the same answers.\n *=========================================*/\n\n/** Which page a pay link opens for an order: a quote, an invoice, or none. */\nexport type OrderPayLinkKind = 'quote' | 'invoice'\n\n/** The most invoice sends an order keeps on record; the oldest go first. */\nexport const INVOICE_MAX_SENDS = 50\n\nconst EMAIL = /^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$/\n\nconst cents = (value: unknown): number => {\n  const number = Math.round(Number(value))\n  return Number.isFinite(number) ? number : 0\n}\n\nconst text = (value: unknown): string | null => {\n  const trimmed = typeof value === 'string' ? value.trim() : ''\n  return trimmed ? trimmed : null\n}\n\n/**\n * Which page the lasting pay link opens for an order, or null when it opens\n * none: a quote (with its quote section), or a draft order as an invoice.\n */\nexport function orderPayLinkKind(\n  order: Pick<HostOrder, 'channel'> & Partial<Pick<HostOrder, 'quote'>> | null | undefined,\n): OrderPayLinkKind | null {\n  if (!order) return null\n  if (isQuote(order)) return order.quote ? 'quote' : null\n  return order.channel === 'draft' ? 'invoice' : null\n}\n\n/** `Invoice #1042`: the order's own number, which a paid quote keeps too. */\nexport function formatInvoiceNumber(order: Pick<HostOrder, 'number'>, orderId?: string): string {\n  return `Invoice ${formatOrderNumber(order, orderId)}`\n}\n\nconst PAID_STATUSES: ReadonlySet<OrderStatus | string> = new Set([\n  'paid',\n  'partially_fulfilled',\n  'fulfilled',\n  'delivered',\n])\n\n/** The order is paid (and not refunded or canceled): its invoice is the record. */\nexport function invoiceIsPaid(order: Pick<HostOrder, 'status'> | null | undefined): boolean {\n  return PAID_STATUSES.has(String(order?.status ?? ''))\n}\n\n/**\n * When the order was paid: a quote's stamp, else the timeline's `paid`\n * event, else (an order created paid, as checkout's are) when it was made.\n * Null for an order not paid.\n */\nexport function orderPaidAtMs(\n  order: Pick<HostOrder, 'status' | 'quote' | 'timeline'> & { createdAtMs?: number } | null | undefined,\n): number | null {\n  if (!order || order.status === 'pending') return null\n  const stamped = Number(order.quote?.paidAtMs)\n  if (Number.isFinite(stamped) && stamped > 0) return stamped\n  const event = (order.timeline ?? []).find((entry) => entry?.event === 'paid')\n  if (event && Number(event.atMs) > 0) return Number(event.atMs)\n  const created = orderCreatedAtMs(order as never)\n  return created > 0 ? created : null\n}\n\n/*==========================================\n * WHAT AN INVOICE'S PAY LINK CHARGES\n *=========================================*/\n\n/** What an invoice's Checkout Session charges, with the rates a draft lets the buyer pick from. */\nexport interface InvoiceCheckoutCharge extends QuoteCheckoutCharge {\n  /** The draft's shipping rates, picked at payment; empty when shipping is fixed or there is none. */\n  shippingOptions: ResolvedShippingRate[]\n  /** Where those rates ship; empty with none. */\n  shippingCountries: string[]\n}\n\n/**\n * The tax basis an order's stored figures give its invoice: Stripe Tax at\n * payment where the order was composed under it, its frozen tax as a fixed\n * figure (charged as the rate that yields it on the taxed line, the way a tax\n * service's quote is), else none.\n */\nexport function invoiceTaxBasis(order: Pick<HostOrder, 'taxMode' | 'totals'>): QuoteTaxBasis {\n  if (order.taxMode === 'stripe-automatic') return { kind: 'at-payment' }\n  const taxCents = Math.max(0, cents(order.totals?.taxCents))\n  if (taxCents > 0) return { kind: 'service', taxCents }\n  return { kind: 'none', reason: 'not-collected' }\n}\n\n/** A stored draft rate, as Stripe is given it, or null for one that is not a rate. */\nfunction draftRate(option: unknown): ResolvedShippingRate | null {\n  if (!option || typeof option !== 'object') return null\n  const source = option as Record<string, unknown>\n  const name = text(source['name'])\n  const amountCents = cents(source['amountCents'])\n  if (!name || amountCents < 0) return null\n  return { rateId: String(source['rateId'] ?? '') || name, name, amountCents }\n}\n\n/**\n * What an invoice's pay link charges, from the stored order alone. A quote is\n * charged as slice 2 charges it; any other order from its lines, its\n * discount, its tax ({@link invoiceTaxBasis}) and, for a draft, the shipping\n * rates it offered when it was made (Stripe asks for the address and the\n * buyer picks one, as on the draft's first link).\n */\nexport function invoiceCheckoutCharge(\n  order: Pick<HostOrder, 'number' | 'lineItems' | 'quote' | 'totals' | 'taxMode'> &\n    Partial<Pick<HostOrder, 'draftShipping'>>,\n  orderId: string,\n): InvoiceCheckoutCharge {\n  if (order.quote) return { ...quoteCheckoutCharge(order, orderId), shippingOptions: [], shippingCountries: [] }\n  const discountCents = Math.max(0, cents(order.totals?.discountCents))\n  const charge = payLinkCheckoutCharge({\n    lineItems: order.lineItems ?? [],\n    tax: invoiceTaxBasis(order),\n    discount: discountCents > 0 ? { kind: 'amount', amountCents: discountCents } : null,\n    shippingCents: 0,\n    label: formatInvoiceNumber(order, orderId),\n  })\n  const options = (order.draftShipping?.options ?? [])\n    .map(draftRate)\n    .filter((rate): rate is ResolvedShippingRate => rate !== null)\n    .slice(0, 5)\n  const countries = (order.draftShipping?.countries ?? [])\n    .map((country) => String(country ?? '').trim().toUpperCase())\n    .filter((country) => /^[A-Z]{2}$/.test(country))\n  return { ...charge, shippingOptions: options, shippingCountries: options.length ? countries : [] }\n}\n\n/*==========================================\n * WHETHER AN INVOICE CAN BE PAID NOW\n *=========================================*/\n\n/**\n * Why an order cannot be paid through its pay link now: a quote's reasons,\n * and two of an invoice's own. `not-payable` is an order the link does not\n * open (a register sale still open, say); `shipping-unknown` is a draft made\n * before drafts kept their shipping rates, whose shipping cannot be charged.\n */\nexport type InvoicePayRefusal = QuotePayRefusal | 'not-payable' | 'shipping-unknown'\n\nexport function invoicePayRefusal(\n  order: Pick<HostOrder, 'number' | 'status' | 'lineItems' | 'quote' | 'totals' | 'taxMode' | 'channel'> &\n    Partial<Pick<HostOrder, 'draftShipping'>>,\n  orderId: string,\n): InvoicePayRefusal | null {\n  const kind = orderPayLinkKind(order)\n  if (kind === 'quote') return quotePayRefusal(order, orderId)\n  if (order.status === 'cancelled' || order.status === 'refunded') return 'closed'\n  if (order.status !== 'pending') return 'paid'\n  if (kind !== 'invoice') return 'not-payable'\n  const ships = (order.lineItems ?? []).some((line) => line && !line.included && lineRequiresShipping(line))\n  if (ships && !order.draftShipping) return 'shipping-unknown'\n  if (invoiceCheckoutCharge(order, orderId).totalCents < QUOTE_MIN_CHARGE_CENTS) return 'nothing-to-pay'\n  return null\n}\n\n/** What the customer is told for a refusal, in the page's words: \"quote\" or \"invoice\". */\nexport function invoicePayRefusalMessage(\n  reason: InvoicePayRefusal,\n  storeName: string,\n  kind: OrderPayLinkKind,\n): string {\n  const business = storeName.trim() || 'the business'\n  if (kind === 'quote' && reason !== 'not-payable' && reason !== 'shipping-unknown') {\n    return quotePayRefusalMessage(reason, storeName)\n  }\n  switch (reason) {\n    case 'paid':\n      return 'This invoice has been paid.'\n    case 'closed':\n      return `This invoice is closed. Contact ${business} with any questions.`\n    case 'approval-required':\n      return `${business} asks you to approve the proof before you pay.`\n    case 'tax-undecided':\n      return `${business} has not finished setting up payments. Contact them to pay this invoice.`\n    case 'nothing-to-pay':\n      return `This invoice has nothing to pay by card. Contact ${business} with any questions.`\n    case 'not-payable':\n    case 'shipping-unknown':\n      return `This invoice can’t be paid online. Contact ${business} to pay it.`\n  }\n}\n\n/*==========================================\n * THE CUSTOMER'S PAGE FOR AN INVOICE\n *=========================================*/\n\n/**\n * The pay link's page for an order that is not a quote: \"Invoice #N\", its\n * lines and totals, the customer's addresses, and Pay while it is unpaid. No\n * proofs, no approval, no notes or terms (an order carries none). Allow-listed\n * as the quote's view is: the order's email, phone, Stripe ids and timeline\n * never leave the server.\n */\nexport function buildInvoicePageView(input: {\n  order: Pick<\n    HostOrder,\n    | 'number'\n    | 'status'\n    | 'channel'\n    | 'lineItems'\n    | 'totals'\n    | 'quote'\n    | 'timeline'\n    | 'taxMode'\n    | 'customerName'\n    | 'billingAddress'\n    | 'shippingAddress'\n  > &\n    Partial<Pick<HostOrder, 'draftShipping'>> & { createdAtMs?: number }\n  orderId: string\n  storeName: string\n  currency: string\n  /** The order's status page, once paid. */\n  receiptUrl?: string | null\n}): QuotePageView {\n  const { order } = input\n  const status = quotePageStatus(order.status)\n  const unpaid = status.status === 'unpaid'\n  const charge = invoiceCheckoutCharge(order, input.orderId)\n  const stored = order.totals\n  const totals =\n    unpaid || !stored\n      ? {\n          itemsCents: charge.itemsCents,\n          discountCents: charge.discountCents,\n          shippingCents: charge.shippingCents,\n          taxCents: charge.taxCents,\n          totalCents: charge.totalCents,\n        }\n      : {\n          itemsCents: cents(stored.itemsCents),\n          discountCents: cents(stored.discountCents),\n          shippingCents: cents(stored.shippingCents),\n          taxCents: cents(stored.taxCents),\n          totalCents: cents(stored.totalCents),\n        }\n  const taxAtPayment = unpaid && charge.taxAtPayment\n  const created = orderCreatedAtMs(order as never)\n  return {\n    state: 'quote',\n    kind: 'invoice',\n    storeName: input.storeName,\n    number: formatInvoiceNumber(order, input.orderId),\n    dateMs: created > 0 ? created : null,\n    // An invoice is not edited; the page has no version to send back.\n    version: 0,\n    currency: input.currency || 'USD',\n    customerName: text(order.customerName),\n    company: null,\n    billTo: quotePageAddress(order.billingAddress),\n    shipTo: quotePageAddress(order.shippingAddress),\n    lines: quotePageLines(order.lineItems ?? []),\n    totals,\n    discountLabel: null,\n    taxLabel: taxAtPayment ? 'Tax is added at payment' : 'Tax',\n    taxAtPayment,\n    shippingAtPayment: unpaid && charge.shippingOptions.length > 0,\n    notes: null,\n    terms: null,\n    status: status.status,\n    statusLabel: status.label,\n    paidAtMs: orderPaidAtMs(order),\n    receiptUrl: unpaid ? null : (input.receiptUrl ?? null),\n    approvalRequired: false,\n    payable: unpaid && invoicePayRefusal(order, input.orderId) === null,\n    revision: 1,\n    proofs: [],\n    response: null,\n    respondable: false,\n  }\n}\n\n/*==========================================\n * EMAILING AN INVOICE\n *=========================================*/\n\n/** The order's invoice sends on record, oldest first. */\nexport function invoiceSends(order: Pick<HostOrder, 'invoiceSends'> | null | undefined): OrderInvoiceSendRecord[] {\n  return Array.isArray(order?.invoiceSends)\n    ? order.invoiceSends.filter((send) => send && typeof send === 'object')\n    : []\n}\n\n/** The last time the order's invoice was emailed, or null. */\nexport function lastInvoiceSend(order: Pick<HostOrder, 'invoiceSends'> | null | undefined): OrderInvoiceSendRecord | null {\n  const sends = invoiceSends(order)\n  return sends.length ? sends[sends.length - 1] : null\n}\n\n/** Where the invoice goes: what was typed, else the order's customer, else a quote's. */\nexport function invoiceSendRecipient(\n  order: Pick<HostOrder, 'customerEmail' | 'quote'> | null | undefined,\n  typed: string | null | undefined,\n): string {\n  return (\n    String(typed ?? '').trim() ||\n    String(order?.customerEmail ?? '').trim() ||\n    String(order?.quote?.customer?.email ?? '').trim()\n  )\n}\n\n/**\n * The conversation an invoice replies into: a quote's own (its emails, and a\n * request's confirmation before them), else the order's, which the first\n * invoice starts.\n */\nexport function invoiceEmailThread(\n  order: Pick<HostOrder, 'quote' | 'emailThread'> | null | undefined,\n): QuoteEmailThread | null {\n  if (order?.quote) return order.quote.emailThread ?? null\n  return order?.emailThread ?? null\n}\n\n/**\n * The subject an invoice defaults to: the conversation's, so it stays one\n * conversation in the customer's mailbox, else `Invoice #1042 from Acme Signs`.\n */\nexport function invoiceEmailDefaultSubject(\n  order: Pick<HostOrder, 'number' | 'quote' | 'emailThread'>,\n  businessName: string,\n  orderId?: string,\n): string {\n  const thread = String(invoiceEmailThread(order)?.subject ?? '').trim()\n  if (thread) return thread\n  const name = String(businessName ?? '').trim()\n  const number = formatInvoiceNumber(order, orderId)\n  return name ? `${number} from ${name}` : number\n}\n\n/** Why an invoice cannot be emailed now, and what the console says. */\nexport type InvoiceSendRefusal =\n  | 'unknown'\n  | 'closed'\n  | 'empty'\n  | 'not-payable'\n  | 'approval-required'\n  | 'tax-undecided'\n  | 'nothing-to-pay'\n  | 'shipping-unknown'\n  | 'no-address'\n  | 'bad-address'\n\n/**\n * Why the order's invoice cannot be emailed to `to` now, if it cannot:\n * a canceled or refunded order, one with nothing on it, an unpaid order its\n * pay link cannot take payment for (and why), and the address.\n */\nexport function invoiceSendRefusal(\n  order:\n    | (Pick<HostOrder, 'number' | 'status' | 'channel' | 'lineItems' | 'totals' | 'quote' | 'taxMode'> &\n        Partial<Pick<HostOrder, 'draftShipping'>>)\n    | null\n    | undefined,\n  orderId: string,\n  to: string,\n): InvoiceSendRefusal | null {\n  if (!order) return 'unknown'\n  if (order.status === 'cancelled' || order.status === 'refunded') return 'closed'\n  const lines = (order.lineItems ?? []).filter(Boolean)\n  if (!lines.length && cents(order.totals?.totalCents) <= 0) return 'empty'\n  if (!invoiceIsPaid(order)) {\n    const refused = invoicePayRefusal(order, orderId)\n    if (refused === 'closed') return 'closed'\n    if (refused && refused !== 'paid') return refused\n  }\n  if (!to) return 'no-address'\n  if (to.length > 320 || !EMAIL.test(to)) return 'bad-address'\n  return null\n}\n\n/** What the console says for a refused invoice send. */\nexport function invoiceSendRefusalMessage(reason: InvoiceSendRefusal): string {\n  switch (reason) {\n    case 'unknown':\n      return 'Unknown order'\n    case 'closed':\n      return 'This order was canceled or refunded, so it has no invoice to send.'\n    case 'empty':\n      return 'This order has no items and no total, so there is nothing to put on an invoice.'\n    case 'not-payable':\n      return 'This order isn’t paid yet, and it can’t be paid online from an invoice. Take its payment where the sale was made, then send the invoice.'\n    case 'approval-required':\n      return 'This quote asks your customer to approve the proof before they pay, and they haven’t yet. Send the quote so they can approve it, then send the invoice.'\n    case 'tax-undecided':\n      return 'Sales tax isn’t set up for this store yet, so the invoice can’t be paid online. Finish the tax settings, then send it.'\n    case 'nothing-to-pay':\n      return 'This invoice totals less than $0.50, so it can’t be paid by card.'\n    case 'shipping-unknown':\n      return 'This draft order was made before invoices could charge its shipping, so its invoice can’t be paid online. Make a new draft order and send its invoice.'\n    case 'no-address':\n      return 'This order has no email for the customer. Type where to send the invoice.'\n    case 'bad-address':\n      return 'Enter a valid email address to send the invoice to.'\n  }\n}\n\n/** The HTTP status a refused send answers with. */\nexport function invoiceSendRefusalStatus(reason: InvoiceSendRefusal): number {\n  if (reason === 'unknown') return 404\n  if (reason === 'no-address' || reason === 'bad-address') return 400\n  return 409\n}\n\n/**\n * What an invoice email changes on the order, as a merge: the send on\n * record, a line on the timeline, and the conversation moved on, on the\n * quote for a quote and on the order otherwise.\n */\nexport function invoiceSendPatch(\n  order: Pick<HostOrder, 'timeline' | 'invoiceSends' | 'quote'>,\n  send: OrderInvoiceSendRecord,\n  thread: QuoteEmailThread,\n): {\n  timeline: OrderTimelineEvent[]\n  invoiceSends: OrderInvoiceSendRecord[]\n  emailThread?: QuoteEmailThread\n  quote?: { emailThread: QuoteEmailThread }\n} {\n  return {\n    timeline: appendOrderEvent(\n      order,\n      'invoice-sent',\n      // The address is on the send record, which erasure clears; the timeline keeps none.\n      `${send.paid ? 'Paid invoice' : 'Invoice'} emailed to the customer by ${send.by}`,\n      send.atMs,\n    ),\n    invoiceSends: [...invoiceSends(order), send].slice(-INVOICE_MAX_SENDS),\n    ...(order.quote ? { quote: { emailThread: thread } } : { emailThread: thread }),\n  }\n}\n"],"names":["appendOrderEvent","formatOrderNumber","orderCreatedAtMs","QUOTE_MIN_CHARGE_CENTS","payLinkCheckoutCharge","quoteCheckoutCharge","quotePageAddress","quotePageLines","quotePageStatus","quotePayRefusal","quotePayRefusalMessage","isQuote","lineRequiresShipping","INVOICE_MAX_SENDS","EMAIL","cents","value","number","Math","round","Number","isFinite","text","trimmed","trim","orderPayLinkKind","order","quote","channel","formatInvoiceNumber","orderId","PAID_STATUSES","Set","invoiceIsPaid","has","String","status","orderPaidAtMs","stamped","paidAtMs","event","timeline","find","entry","atMs","created","invoiceTaxBasis","taxMode","kind","taxCents","max","totals","reason","draftRate","option","source","name","amountCents","rateId","invoiceCheckoutCharge","shippingOptions","shippingCountries","discountCents","charge","lineItems","tax","discount","shippingCents","label","options","draftShipping","map","filter","rate","slice","countries","country","toUpperCase","test","length","invoicePayRefusal","ships","some","line","included","totalCents","invoicePayRefusalMessage","storeName","business","buildInvoicePageView","input","unpaid","stored","itemsCents","taxAtPayment","state","dateMs","version","currency","customerName","company","billTo","billingAddress","shipTo","shippingAddress","lines","discountLabel","taxLabel","shippingAtPayment","notes","terms","statusLabel","receiptUrl","approvalRequired","payable","revision","proofs","response","respondable","invoiceSends","Array","isArray","send","lastInvoiceSend","sends","invoiceSendRecipient","typed","customerEmail","customer","email","invoiceEmailThread","emailThread","invoiceEmailDefaultSubject","businessName","thread","subject","invoiceSendRefusal","to","Boolean","refused","invoiceSendRefusalMessage","invoiceSendRefusalStatus","invoiceSendPatch","paid","by"],"mappings":"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"}

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

@@ -23,7 +23,7 @@
  * I/O here.
  */
 import type { OrderLineModifier } from './product-modifiers';
-import type { OrderQuote } from './commerce-quotes';
+import type { OrderDraftShipping, OrderInvoiceSendRecord, OrderPayLink, OrderQuote, QuoteEmailThread } from './commerce-quotes';
 import type { PaymentRisk } from '@aglyn/aglyn/app-utils/payment-risk';
 import type { ProductType } from './commerce';
 import type { StorefrontTaxMode } from './commerce-tax-decision';
@@ -636,8 +636,35 @@ export interface HostOrder {
      */
     subscriptionId?: string;
     invoiceId?: string;
-    /** Draft orders (AGL-287): the link sent to the buyer. */
+    /**
+     * Draft orders (AGL-287): the Stripe page the draft was first sent as. It
+     * lapses after a day; the order's invoice carries its lasting pay link
+     * instead (AGL-4099, `commerce-invoices.ts`).
+     */
     paymentLinkUrl?: string;
+    /**
+     * The shipping a draft order offered when it was made (AGL-4099): the
+     * countries it ships to and the rates the buyer picks from, so its pay link
+     * offers the same ones on any later day. Empty `options` when it ships
+     * nothing; absent on a draft made before invoices, and on every other order.
+     */
+    draftShipping?: OrderDraftShipping;
+    /** The promotion a draft order was priced with (AGL-4099), counted when its pay link is paid. */
+    discountId?: string;
+    /**
+     * The lasting pay link of an order that is not a quote (AGL-4099): its
+     * version and the payments it could not take. A quote keeps both in its
+     * `quote` section, where slice 2 put them.
+     */
+    payLink?: OrderPayLink;
+    /**
+     * The conversation an order's invoice emails keep in the customer's
+     * mailbox (AGL-4099), started by the first invoice. A quote's emails,
+     * invoices included, keep `quote.emailThread` instead.
+     */
+    emailThread?: QuoteEmailThread | null;
+    /** Every time the order's invoice was emailed (AGL-4099), oldest first. */
+    invoiceSends?: OrderInvoiceSendRecord[];
     /** What only a quote has (channel `quote`, AGL-4093); see `commerce-quotes.ts`. */
     quote?: OrderQuote;
     refundedCents?: number;