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

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

@@ -0,0 +1,229 @@
+/**
+ * @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 { ProductType } from './commerce';
+import { type HostOrder, type OrderAddress } from './commerce-orders';
+import { type OrderQuote, 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;
+/** An address as the quote page prints it: no phone. */
+export interface QuotePageAddress {
+    name: string | null;
+    line1: string | null;
+    line2: string | null;
+    city: string | null;
+    state: string | null;
+    postalCode: string | null;
+    country: string | null;
+}
+export interface QuotePageLine {
+    name: string;
+    /** The option and add-ons chosen, as order lines print them. */
+    variantLabel: string | null;
+    description: string | null;
+    sku: string | null;
+    quantity: number;
+    unitAmountCents: number;
+    /** What the line charges: 0 for an included line. */
+    amountCents: number;
+    /** Included at no charge. */
+    included: boolean;
+}
+/** Where the quote stands, as its customer sees it. */
+export type QuotePageStatus = 'unpaid' | 'paid' | 'canceled' | 'refunded';
+/**
+ * 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
+ * timeline and who wrote the quote, none of which a forwarded link may show.
+ * New fields are added here deliberately, or not at all.
+ */
+export interface QuotePageView {
+    state: 'quote';
+    storeName: string;
+    /** `Quote #1042`. */
+    number: string;
+    /** When the quote was last written, which is the date it carries. */
+    dateMs: number | null;
+    /**
+     * The edit of the quote this view shows. Pay sends it back, and a quote
+     * changed since is refused, so nobody pays for a version they have not seen.
+     */
+    version: number;
+    currency: string;
+    customerName: string | null;
+    company: string | null;
+    billTo: QuotePageAddress | null;
+    shipTo: QuotePageAddress | null;
+    lines: QuotePageLine[];
+    totals: {
+        itemsCents: number;
+        discountCents: number;
+        shippingCents: number;
+        taxCents: number;
+        totalCents: number;
+    };
+    /** `10% off`, or null for an amount or no discount. */
+    discountLabel: string | null;
+    /** The tax line's label, or `Tax is added at payment`. */
+    taxLabel: string;
+    /** Stripe Tax works the tax out when the customer pays; `taxCents` is 0 until then. */
+    taxAtPayment: boolean;
+    notes: string | null;
+    terms: string | null;
+    status: QuotePageStatus;
+    statusLabel: string;
+    paidAtMs: number | null;
+    /** The order's status page, once paid. */
+    receiptUrl: string | null;
+    /** The business asks the customer to approve the proof before paying. */
+    approvalRequired: boolean;
+    /** A Pay button belongs on the page. */
+    payable: boolean;
+}
+/** What a signed link for an older version of the quote opens: nothing of the quote. */
+export interface QuotePageReplacedView {
+    state: 'replaced';
+    storeName: 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
+ * paid, and the paid order's own totals (what Stripe charged) after.
+ */
+export declare function buildQuotePageView(input: {
+    order: Pick<HostOrder, 'number' | 'status' | 'lineItems' | 'totals' | 'quote' | 'timeline'>;
+    orderId: string;
+    storeName: string;
+    currency: string;
+    /** The order's status page, for a paid quote. */
+    receiptUrl?: string | null;
+}): QuotePageView;
+/** One line of a quote's Checkout Session. */
+export interface QuoteCheckoutLine {
+    name: string;
+    /** The quote's lines this one charges for, as the hosted page lists them. */
+    description: string;
+    amountCents: number;
+    /** False for tax-exempt products: no rate is applied and Stripe Tax is told it is nontaxable. */
+    taxable: boolean;
+}
+/** What a quote's Checkout Session charges, priced from the stored quote alone. */
+export interface QuoteCheckoutCharge {
+    /** The goods grouped by whether they are taxed, so one rate taxes exactly the quote's taxable amount. */
+    lines: QuoteCheckoutLine[];
+    itemsCents: number;
+    discountCents: number;
+    /** The goods after the discount: what the business is paid for them. */
+    goodsCents: number;
+    taxableCents: number;
+    shippingCents: number;
+    /** The quote's tax; 0 when Stripe Tax works it out at payment. */
+    taxCents: number;
+    /**
+     * The percentage applied to the taxed line as a Stripe tax rate, or null
+     * when no rate is applied (no tax, Stripe Tax, or tax charged as its own line).
+     */
+    taxPct: number | null;
+    taxAtPayment: boolean;
+    /** Goods, shipping and the quote's tax. Stripe Tax adds to it at payment. */
+    totalCents: number;
+    /** What the platform fee prices the goods as. */
+    feeProductType: ProductType;
+}
+/**
+ * The charge for a quote, from its stored lines, discount, shipping and tax
+ * basis through {@link computeQuoteTotals} — the same function that priced it
+ * when it was saved, so the page, the session and the stored quote agree.
+ *
+ * The goods are charged as at most two lines, the taxed and the tax-exempt,
+ * each after its share of the discount. A store rate is applied to the taxed
+ * line as one Stripe tax rate, so Stripe's tax is the rate on exactly the
+ * amount the quote taxed, and the quote's figure is what is collected. A tax
+ * service's figure is carried the same way, as the percentage of the taxed
+ * 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;
+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;
+/** What the customer is told for a {@link QuotePayRefusal}, naming the business. */
+export declare function quotePayRefusalMessage(reason: QuotePayRefusal, storeName: string): string;
+/** What a completed Checkout Session says about the quote it paid. */
+export interface QuotePaymentFacts {
+    sessionId: string;
+    paymentIntentId: string | null;
+    /** The link version and quote edit the session was minted for, from its metadata. */
+    linkVersion?: string | number | null;
+    quoteUpdatedAtMs?: string | number | null;
+    paidAtMs: number;
+    /** The payer, as Stripe collected them. */
+    email: string | null;
+    name: string | null;
+    /** What Stripe charged in all, and its shipping and tax parts. */
+    amountTotalCents: number | null;
+    shippingCents: number;
+    taxCents: number;
+    /** The platform fee the session was minted with. */
+    feeCents: number;
+    taxMode: StorefrontTaxMode;
+    /** The address Stripe collected, when the session asked for one. */
+    shippingAddress: OrderAddress | null;
+}
+/**
+ * What a completed payment does to a quote:
+ *
+ * - `pay`: the quote is unpaid and the payment is for it as it stands, so it
+ *   becomes the order.
+ * - `superseded`: the quote is unpaid, but the payment was made through a pay
+ *   link the business replaced, or for a version of the quote it has since
+ *   changed. Taking it would record a sale at a price or for a link the
+ *   business withdrew.
+ * - `already-paid`: another payment paid the quote first.
+ * - `redelivery`: Stripe sending this same payment again; nothing to do.
+ *
+ * The two refusals keep the money visible: they are recorded on the quote and
+ * 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;
+/** 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 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`);
+ * paying it writes them:
+ *
+ * - `createdAtMs` is the time it was paid, the moment it became an order, so
+ *   it lists and counts on the day the money came in.
+ * - The customer moves to the top-level fields every order reader asks
+ *   (`customerEmail`, `customerName`, `customerPhone`, `customerRecord`), the
+ *   payer's own email first, as a paid draft takes it.
+ * - The address Stripe collected ships it, else the quote's ship-to; the
+ *   quote's bill-to bills it.
+ * - The totals are what Stripe charged: its shipping and tax where it charged
+ *   any, the platform fee the session was minted with, and its total.
+ * - The list fields (`withOrderListFields`) are stamped from all of that.
+ */
+export declare function paidQuoteOrder(order: HostOrder, orderId: string, facts: QuotePaymentFacts): HostOrder & OrderListFields & {
+    updatedAtMs: number;
+    requiresShipping: boolean;
+};

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

@@ -0,0 +1,393 @@
+/**
+ * @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 { _ as _extends } from "@swc/helpers/_/_extends";
+import { appendOrderEvent, formatOrderNumber } from "./commerce-orders.js";
+import { computeQuoteTotals, describeQuoteTax, formatQuoteNumber, quoteLineAmounts, quotePaymentBlockedByApproval } from "./commerce-quotes.js";
+import { engineLineTaxPercentages } from "./commerce-tax-engine.js";
+import { withOrderListFields } from "./order-list-fields.js";
+/*==========================================
+ * PAYING A QUOTE (AGL-4094).
+ *
+ * The customer opens the quote on the business's own site from a signed pay
+ * link, sees it, and pays it. Everything here is pure, so the page's view,
+ * the pay route's charge and the webhook's paid order all come from one
+ * reading of the stored quote, and none of them from anything the browser
+ * sends:
+ *
+ * - {@link buildQuotePageView}: the ONE projection of a quote that leaves the
+ *   server for a visitor holding the link, allow-listed field by field.
+ * - {@link quoteCheckoutCharge}: what a Checkout Session charges, priced from
+ *   the stored lines, discount, shipping and tax basis.
+ * - {@link quotePayRefusal}: why a quote cannot be paid now, if it cannot.
+ * - {@link quotePaymentDisposition} and {@link paidQuoteOrder}: what a
+ *   completed payment does to the quote, and the order it becomes.
+ *
+ * The customer side has no expiry and no open or closed states: a quote and
+ * its link stay until the quote is paid or the business replaces the link.
+ *=========================================*/ /** Stripe's smallest card charge; a quote that totals less cannot be paid by card. */ export const QUOTE_MIN_CHARGE_CENTS = 50;
+/** The pay link version a quote is on; absent reads as the first. */ export function quoteLinkVersion(quote) {
+    const version = Math.floor(Number(quote == null ? void 0 : quote.linkVersion));
+    return Number.isFinite(version) && version >= 1 ? version : 1;
+}
+const text = (value)=>{
+    const trimmed = typeof value === 'string' ? value.trim() : '';
+    return trimmed ? trimmed : null;
+};
+const cents = (value)=>{
+    const number = Math.round(Number(value));
+    return Number.isFinite(number) ? number : 0;
+};
+function pageAddress(address) {
+    if (!address) return null;
+    const view = {
+        name: text(address.name),
+        line1: text(address.line1),
+        line2: text(address.line2),
+        city: text(address.city),
+        state: text(address.state),
+        postalCode: text(address.postalCode),
+        country: text(address.country)
+    };
+    return Object.values(view).some(Boolean) ? view : null;
+}
+function pageStatus(status) {
+    if (status === 'pending') return {
+        status: 'unpaid',
+        label: 'Unpaid'
+    };
+    if (status === 'cancelled') return {
+        status: 'canceled',
+        label: 'Canceled'
+    };
+    if (status === 'refunded') return {
+        status: 'refunded',
+        label: 'Refunded'
+    };
+    return {
+        status: 'paid',
+        label: 'Paid'
+    };
+}
+function discountLabel(discount) {
+    if ((discount == null ? void 0 : discount.kind) !== 'percent' || !(Number(discount.pct) > 0)) return null;
+    return `${Number(discount.pct)}% off`;
+}
+/** When the quote was paid: its stamp, else the timeline's `paid` event. */ function paidAt(order) {
+    var _order_timeline;
+    var _order_quote;
+    if (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');
+    return event ? Number(event.atMs) || null : null;
+}
+/**
+ * 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
+ * paid, and the paid order's own totals (what Stripe charged) after.
+ */ export function buildQuotePageView(input) {
+    var _order_lineItems, _ref, _text, _input_receiptUrl;
+    var _quote_tax, _quote_customer, _quote_customer1, _quote_customer2, _quote_customer3, _quote_tax1;
+    const { order } = input;
+    const quote = order.quote;
+    const lines = (_order_lineItems = order.lineItems) != null ? _order_lineItems : [];
+    const status = pageStatus(order.status);
+    const unpaid = status.status === 'unpaid';
+    const charge = quoteCheckoutCharge(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 approvalRequired = unpaid && quotePaymentBlockedByApproval(quote);
+    const taxAtPayment = unpaid && (quote == null ? void 0 : (_quote_tax = quote.tax) == null ? void 0 : _quote_tax.kind) === 'at-payment';
+    return {
+        state: '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,
+        version: Number(quote == null ? void 0 : quote.updatedAtMs) || 0,
+        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
+            };
+        }),
+        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,
+        notes: text(quote == null ? void 0 : quote.notes),
+        terms: text(quote == null ? void 0 : quote.terms),
+        status: status.status,
+        statusLabel: status.label,
+        paidAtMs: paidAt(order),
+        receiptUrl: unpaid ? null : (_input_receiptUrl = input.receiptUrl) != null ? _input_receiptUrl : null,
+        approvalRequired,
+        payable: unpaid && !approvalRequired && quotePayRefusal(order, input.orderId) === null
+    };
+}
+const LINE_DESCRIPTION_MAX = 500;
+function lineSummary(lines) {
+    const parts = lines.map((line)=>{
+        const label = line.variantLabel ? `${line.name} (${line.variantLabel})` : line.name;
+        return `${Math.max(1, cents(line.quantity))} × ${label}`;
+    });
+    const summary = parts.join(', ');
+    return summary.length > LINE_DESCRIPTION_MAX ? `${summary.slice(0, LINE_DESCRIPTION_MAX - 1)}…` : summary;
+}
+/** What the fee ladder prices the quote's charged goods as: physical when any line ships. */ function feeProductTypeOf(lines) {
+    const charged = lines.filter((line)=>!line.included);
+    const types = new Set(charged.map((line)=>{
+        var _line_productType;
+        return (_line_productType = line.productType) != null ? _line_productType : 'physical';
+    }));
+    if (types.has('physical') || types.size === 0) return 'physical';
+    return types.has('service') ? 'service' : 'digital';
+}
+/**
+ * The charge for a quote, from its stored lines, discount, shipping and tax
+ * basis through {@link computeQuoteTotals} — the same function that priced it
+ * when it was saved, so the page, the session and the stored quote agree.
+ *
+ * The goods are charged as at most two lines, the taxed and the tax-exempt,
+ * each after its share of the discount. A store rate is applied to the taxed
+ * line as one Stripe tax rate, so Stripe's tax is the rate on exactly the
+ * amount the quote taxed, and the quote's figure is what is collected. A tax
+ * service's figure is carried the same way, as the percentage of the taxed
+ * line it amounts to. Included lines charge nothing and are not sent.
+ */ 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));
+    const totals = computeQuoteTotals({
+        lines: lineItems,
+        discount,
+        shippingCents,
+        tax
+    });
+    const amounts = quoteLineAmounts(lineItems, discount);
+    const label = formatQuoteNumber(order, orderId);
+    const groups = [
+        true,
+        false
+    ].map((taxable)=>{
+        const members = lineItems.map((line, index)=>({
+                line,
+                net: amounts.netCents[index]
+            })).filter(({ line, net })=>net > 0 && line.taxExempt !== true === taxable);
+        return {
+            taxable,
+            amountCents: members.reduce((sum, { net })=>sum + net, 0),
+            description: lineSummary(members.map(({ line })=>line))
+        };
+    });
+    const charged = groups.filter((group)=>group.amountCents > 0);
+    const lines = charged.map((group)=>({
+            name: charged.length > 1 && !group.taxable ? `${label} (tax-exempt items)` : label,
+            description: group.description,
+            amountCents: group.amountCents,
+            taxable: group.taxable
+        }));
+    const taxableCents = groups[0].amountCents;
+    const taxPct = totals.taxCents > 0 && taxableCents > 0 ? tax.kind === 'rate' ? Number(tax.pct) : engineLineTaxPercentages([
+        {
+            amountCents: taxableCents,
+            taxCents: totals.taxCents
+        }
+    ], 0)[0] : null;
+    // A tax service can tax a quote whose goods are all exempt (on its
+    // shipping, say): with no taxed line to carry a rate, its figure is
+    // charged as a line of its own, so the customer still pays what the quote says.
+    if (totals.taxCents > 0 && taxPct === null) {
+        lines.push({
+            name: tax.providerLabel ? `Sales tax (${tax.providerLabel})` : 'Sales tax',
+            description: label,
+            amountCents: totals.taxCents,
+            taxable: false
+        });
+    }
+    return {
+        lines,
+        itemsCents: totals.itemsCents,
+        discountCents: totals.discountCents,
+        goodsCents: totals.itemsCents - totals.discountCents,
+        taxableCents,
+        shippingCents,
+        taxCents: totals.taxCents,
+        taxPct,
+        taxAtPayment: totals.taxAtPayment,
+        totalCents: totals.totalCents,
+        feeProductType: feeProductTypeOf(lineItems)
+    };
+}
+/** Why a quote cannot be paid now, or null when it can. */ export function quotePayRefusal(order, orderId) {
+    var _order_quote_tax, _order_quote;
+    if (order.status === 'cancelled' || order.status === 'refunded') return 'closed';
+    if (order.status !== 'pending') return 'paid';
+    if (quotePaymentBlockedByApproval(order.quote)) return 'approval-required';
+    if (((_order_quote = order.quote) == null ? void 0 : (_order_quote_tax = _order_quote.tax) == null ? void 0 : _order_quote_tax.kind) === 'none' && order.quote.tax.reason === 'undecided') return 'tax-undecided';
+    if (quoteCheckoutCharge(order, orderId).totalCents < QUOTE_MIN_CHARGE_CENTS) return 'nothing-to-pay';
+    return null;
+}
+/** What the customer is told for a {@link QuotePayRefusal}, naming the business. */ export function quotePayRefusalMessage(reason, storeName) {
+    const business = storeName.trim() || 'the business';
+    switch(reason){
+        case 'paid':
+            return 'This quote has been paid.';
+        case 'closed':
+            return `This quote 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 quote.`;
+        case 'nothing-to-pay':
+            return `This quote has nothing to pay by card. Contact ${business} with any questions.`;
+    }
+}
+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);
+    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)) {
+        return 'superseded';
+    }
+    const sentEdit = payment.quoteUpdatedAtMs;
+    if (sentEdit != null && sentEdit !== '' && Number(sentEdit) !== Number((_order_quote1 = order.quote) == null ? void 0 : _order_quote1.updatedAtMs)) {
+        return 'superseded';
+    }
+    return 'pay';
+}
+/** A payment the quote could not take, as {@link QuoteUnmatchedPayment} records it. */ export function quoteUnmatchedPayment(facts, reason) {
+    return {
+        sessionId: facts.sessionId,
+        paymentIntentId: facts.paymentIntentId,
+        amountCents: Math.max(0, cents(facts.amountTotalCents)),
+        atMs: facts.paidAtMs,
+        reason
+    };
+}
+/** The timeline line for a payment the quote could not take. */ export function quoteUnmatchedPaymentDetail(entry) {
+    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.';
+}
+/**
+ * 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`);
+ * paying it writes them:
+ *
+ * - `createdAtMs` is the time it was paid, the moment it became an order, so
+ *   it lists and counts on the day the money came in.
+ * - The customer moves to the top-level fields every order reader asks
+ *   (`customerEmail`, `customerName`, `customerPhone`, `customerRecord`), the
+ *   payer's own email first, as a paid draft takes it.
+ * - The address Stripe collected ships it, else the quote's ship-to; the
+ *   quote's bill-to bills it.
+ * - The totals are what Stripe charged: its shipping and tax where it charged
+ *   any, the platform fee the session was minted with, and its total.
+ * - The list fields (`withOrderListFields`) are stamped from all of that.
+ */ export function paidQuoteOrder(order, orderId, facts) {
+    var _ref, _order_totals, _ref1, _facts_shippingAddress, _text, _ref2, _text1, _facts_paymentIntentId;
+    var _customer_record, _customer_record1;
+    const quote = order.quote;
+    const customer = (_ref = quote == null ? void 0 : quote.customer) != null ? _ref : {};
+    const stored = (_order_totals = order.totals) != null ? _order_totals : {
+        itemsCents: 0,
+        discountCents: 0,
+        shippingCents: 0,
+        taxCents: 0,
+        feeCents: 0,
+        totalCents: 0
+    };
+    const shippingCents = facts.shippingCents > 0 ? facts.shippingCents : cents(stored.shippingCents);
+    const taxCents = facts.taxCents > 0 ? facts.taxCents : cents(stored.taxCents);
+    const totalCents = facts.amountTotalCents != null && Number.isFinite(facts.amountTotalCents) ? facts.amountTotalCents : cents(stored.itemsCents) - cents(stored.discountCents) + shippingCents + taxCents;
+    const shippingAddress = (_ref1 = (_facts_shippingAddress = facts.shippingAddress) != null ? _facts_shippingAddress : quote == null ? void 0 : quote.shipTo) != null ? _ref1 : null;
+    const label = formatOrderNumber(order, orderId);
+    const paid = _extends({}, order, {
+        status: 'paid',
+        createdAtMs: facts.paidAtMs,
+        customerEmail: (_text = text(facts.email)) != null ? _text : text(customer.email),
+        customerName: (_ref2 = (_text1 = text(customer.name)) != null ? _text1 : text(facts.name)) != null ? _ref2 : text(customer.company)
+    }, text(customer.phone) ? {
+        customerPhone: text(customer.phone)
+    } : {}, ((_customer_record = customer.record) == null ? void 0 : _customer_record.kind) && ((_customer_record1 = customer.record) == null ? void 0 : _customer_record1.id) ? {
+        customerRecord: _extends({}, customer.record)
+    } : {}, shippingAddress ? {
+        shippingAddress: _extends({}, shippingAddress)
+    } : {}, (quote == null ? void 0 : quote.billTo) ? {
+        billingAddress: _extends({}, quote.billTo)
+    } : {}, {
+        totals: {
+            itemsCents: cents(stored.itemsCents),
+            discountCents: cents(stored.discountCents),
+            shippingCents,
+            taxCents,
+            feeCents: Math.max(0, cents(facts.feeCents)),
+            totalCents
+        },
+        taxMode: facts.taxMode,
+        paymentIntentId: (_facts_paymentIntentId = facts.paymentIntentId) != null ? _facts_paymentIntentId : undefined,
+        checkoutSessionId: facts.sessionId,
+        timeline: appendOrderEvent(order, 'paid', `${label} paid through its pay link`, facts.paidAtMs),
+        quote: _extends({}, quote, {
+            paidAtMs: facts.paidAtMs
+        }),
+        // New to a shipping tool's feed from the moment it is paid.
+        updatedAtMs: facts.paidAtMs
+    });
+    if (!paid.paymentIntentId) delete paid.paymentIntentId;
+    return withOrderListFields(orderId, paid);
+}
+
+//# sourceMappingURL=commerce-quote-pay.js.map