@aglyn/plugins-commerce 1.0.0-beta.231 → 1.0.0-beta.233

package/src/lib/server/billing-webhook.js

@@ -36,6 +36,7 @@ import { alertLowStockCrossing } from "./low-stock.js";
 import { decrementVariantStock } from "./reserve-stock.js";
 import { giftCardSearchTokens } from "../model/gift-card-search.js";
 import { releaseStockHold } from "./stock-hold.js";
+import { orderLocalFulfillmentFromSession } from "./local-fulfillment.js";
 import { releasePromotionHold, settlePromotionSlot } from "./promotion-hold.js";
 import { flagOrderRestock } from "./restock-flag.js";
 import { storefrontTaxModeOf } from "./storefront-tax.js";
@@ -45,6 +46,7 @@ import { enqueueSupplierDelivery } from "./supplier-outbox.js";
 import { notifyOrderBuyer, onlineReceiptExtras } from "./order-notifications.js";
 import { ORDER_PAID_EVENT, ORDER_REFUNDED_EVENT } from "../model/order-events.js";
 import { checkoutExtrasCents, decodeCheckoutExtrasMetadata } from "@aglyn/aglyn/plugin-manager/plugin-checkout-extras";
+import { checkoutCreditProvider, checkoutCreditSold, decodeCheckoutCreditMetadata } from "@aglyn/aglyn/plugin-manager/plugin-checkout-credits";
 import { raiseOrderEvent } from "./order-events.js";
 import { handlePosStripeEvent } from "./pos-terminal.js";
 import { notifyPosSaleCompleted } from "./pos-sale.js";
@@ -1795,6 +1797,19 @@ async function findOrderForDispute(paymentIntentId) {
                 console.error('Gift card hold release failed', giftCardCode, error);
             });
         }
+        // Store credit another plugin held for the checkout (AGL-3640) goes back
+        // the same way: its provider lets the hold go.
+        const expiredCredit = decodeCheckoutCreditMetadata(object == null ? void 0 : object.metadata);
+        if (expiredCredit) {
+            var _checkoutCreditProvider;
+            await ((_checkoutCreditProvider = checkoutCreditProvider(expiredCredit.providerId)) == null ? void 0 : _checkoutCreditProvider.provider.release({
+                hostId: expiredHostId,
+                reference: expiredCredit.reference,
+                holdKey: expiredCredit.holdKey
+            }).catch((error)=>{
+                console.error('Checkout credit hold release failed', expiredCredit.providerId, error);
+            }));
+        }
         return;
     }
     // White-label brand per host (White-Label Phase 3): every storefront email
@@ -2814,8 +2829,8 @@ async function findOrderForDispute(paymentIntentId) {
         var _object_metadata19;
         const { hostId, cartId, feeCents, couponCode } = (_object_metadata19 = object.metadata) != null ? _object_metadata19 : {};
         if (hostId && cartId) {
-            var _cartSnapshot_data, _ref40, _ref41, _ref42, _ref43, _ref44, _ref45;
-            var _object_customer_details7, _object_metadata20, _object_customer_details8, _object_customer_details9, _object_customer_details10, _object_metadata21, _this2, _object_metadata22;
+            var _cartSnapshot_data, _ref40, _object_shipping_details_address_postal_code, _object_shipping_details_address_country, _ref41, _ref42, _ref43, _ref44, _ref45;
+            var _object_shipping_details, _object_customer_details7, _object_metadata20, _object_customer_details8, _object_customer_details9, _object_customer_details10, _object_metadata21, _this2, _object_metadata22;
             const firestore = firebaseAdmin.app().firestore();
             const hostRef = firestore.collection('hosts').doc(String(hostId));
             const cartRef = hostRef.collection('carts').doc(String(cartId));
@@ -2888,14 +2903,68 @@ async function findOrderForDispute(paymentIntentId) {
             // The optional lines the buyer took (AGL-3635), read back off the
             // session they were charged on; never re-quoted here.
             const cartExtras = decodeCheckoutExtrasMetadata(object == null ? void 0 : object.metadata);
+            // Store credit another plugin held for this checkout (AGL-3640): taken
+            // in THIS transaction, so the redemption and the order are written
+            // together or not at all. What Stripe discounted is the hold; what the
+            // provider gives now is what the order records.
+            const heldCredit = decodeCheckoutCreditMetadata(object == null ? void 0 : object.metadata);
+            const creditEntry = heldCredit ? checkoutCreditProvider(heldCredit.providerId) : null;
+            let creditShortCents = 0;
+            // Picked up or brought by the store's own driver (AGL-3624): where
+            // the buyer chose, read back off the session they paid. Never throws
+            // past here — a failed read records the order as shipped rather than
+            // losing it.
+            const cartLocalFulfillment = await orderLocalFulfillmentFromSession({
+                hostId: String(hostId),
+                hostRef,
+                metadata: object == null ? void 0 : object.metadata,
+                shippingAddress: (object == null ? void 0 : (_object_shipping_details = object.shipping_details) == null ? void 0 : _object_shipping_details.address) ? {
+                    postalCode: (_object_shipping_details_address_postal_code = object.shipping_details.address.postal_code) != null ? _object_shipping_details_address_postal_code : null,
+                    country: (_object_shipping_details_address_country = object.shipping_details.address.country) != null ? _object_shipping_details_address_country : null
+                } : null,
+                createdAtMs: Date.now()
+            }).catch((error)=>{
+                console.error('commerce cart local fulfillment unreadable', String(object.id), error);
+                return null;
+            });
             const created = await firestore.runTransaction(async (transaction)=>{
-                var _counter_get, _ref, _ref1, _ref2, _ref3, _ref4, _shipping_address_line1, _shipping_address_line2, _shipping_address_city, _shipping_address_state, _shipping_address_postal_code, _shipping_address_country, _ref5;
+                var _counter_get, _ref, _ref1, _ref2, _ref3, _ref4, _shipping_address_line1, _shipping_address_line2, _shipping_address_city, _shipping_address_state, _shipping_address_postal_code, _shipping_address_country, _ref5, _ref6;
                 var _object_metadata, _object_customer_details, _object_customer_details1;
                 const [existing, counter] = await Promise.all([
                     transaction.get(orderRef),
                     transaction.get(counterRef)
                 ]);
                 if (existing.exists) return false;
+                // The provider's reads, before this transaction writes anything.
+                let creditStage = null;
+                if (heldCredit && creditEntry) {
+                    creditStage = await creditEntry.provider.stage({
+                        transaction,
+                        hostId: String(hostId),
+                        reference: heldCredit.reference,
+                        orderId: orderRef.id,
+                        nowMs: Date.now(),
+                        holdKey: heldCredit.holdKey
+                    }).catch((error)=>{
+                        console.error('Checkout credit stage failed', heldCredit.providerId, error);
+                        return null;
+                    });
+                }
+                const creditTaken = heldCredit && creditStage ? Math.max(0, Math.min(heldCredit.amountCents, creditStage.debit({
+                    cents: heldCredit.amountCents,
+                    key: heldCredit.holdKey,
+                    orderId: orderRef.id,
+                    channel: 'online'
+                }))) : 0;
+                creditShortCents = heldCredit ? heldCredit.amountCents - creditTaken : 0;
+                const creditSold = heldCredit && creditTaken > 0 ? checkoutCreditSold({
+                    providerId: heldCredit.providerId,
+                    reference: heldCredit.reference,
+                    label: heldCredit.label,
+                    last4: heldCredit.last4,
+                    amountCents: creditTaken,
+                    appliedAs: 'discount'
+                }) : null;
                 const number = Number((_counter_get = counter.get('next')) != null ? _counter_get : 1);
                 cartOrderNumber = number;
                 transaction.set(counterRef, {
@@ -2919,6 +2988,10 @@ async function findOrderForDispute(paymentIntentId) {
                     totals
                 }, cartExtras.length ? {
                     extras: cartExtras
+                } : {}, creditSold ? {
+                    credits: [
+                        creditSold
+                    ]
                 } : {}, {
                     // WHICH TAX THIS SALE CARRIED (AGL-2451). `totals.taxCents` above
                     // says how much; this says who computed it, which is the fact that
@@ -2940,6 +3013,13 @@ async function findOrderForDispute(paymentIntentId) {
                                 event: 'line-unresolved',
                                 detail: `${unresolvedLines.length} paid ${unresolvedLines.length === 1 ? 'line' : 'lines'} could not be recorded because the product was ` + 'deleted during checkout, so this order is short of ' + 'what the shopper was charged. Refund the difference ' + 'or fulfill it by hand.'
                             }
+                        ] : [],
+                        ...heldCredit && creditShortCents > 0 ? [
+                            {
+                                atMs: Date.now(),
+                                event: 'credit-short',
+                                detail: `$${(heldCredit.amountCents / 100).toFixed(2)} of ${heldCredit.label} was taken off this ` + `order, but only $${((heldCredit.amountCents - creditShortCents) / 100).toFixed(2)} was ` + 'still in the account when it was paid.'
+                            }
                         ] : []
                     ]
                 }, unresolvedLines.length ? {
@@ -2952,7 +3032,7 @@ async function findOrderForDispute(paymentIntentId) {
                 } : {}, {
                     customerName: (_ref2 = object == null ? void 0 : (_object_customer_details = object.customer_details) == null ? void 0 : _object_customer_details.name) != null ? _ref2 : null,
                     customerEmail: (_ref3 = object == null ? void 0 : (_object_customer_details1 = object.customer_details) == null ? void 0 : _object_customer_details1.email) != null ? _ref3 : null
-                }, (shipping == null ? void 0 : shipping.address) ? {
+                }, (shipping == null ? void 0 : shipping.address) && (cartLocalFulfillment == null ? void 0 : cartLocalFulfillment.fields.fulfillmentMethod) !== 'pickup' ? {
                     shippingAddress: {
                         name: (_ref4 = shipping == null ? void 0 : shipping.name) != null ? _ref4 : undefined,
                         line1: (_shipping_address_line1 = shipping.address.line1) != null ? _shipping_address_line1 : undefined,
@@ -2962,10 +3042,10 @@ async function findOrderForDispute(paymentIntentId) {
                         postalCode: (_shipping_address_postal_code = shipping.address.postal_code) != null ? _shipping_address_postal_code : undefined,
                         country: (_shipping_address_country = shipping.address.country) != null ? _shipping_address_country : undefined
                     }
-                } : {}, couponCode ? {
+                } : {}, (_ref5 = cartLocalFulfillment == null ? void 0 : cartLocalFulfillment.fields) != null ? _ref5 : {}, couponCode ? {
                     couponCode
                 } : {}, {
-                    amountCents: Number((_ref5 = object == null ? void 0 : object.amount_total) != null ? _ref5 : 0),
+                    amountCents: Number((_ref6 = object == null ? void 0 : object.amount_total) != null ? _ref6 : 0),
                     feeCents: Number(feeCents != null ? feeCents : 0),
                     createdAtMs: Date.now(),
                     createdAt: firebaseAdmin.firestore.FieldValue.serverTimestamp()
@@ -2996,6 +3076,34 @@ async function findOrderForDispute(paymentIntentId) {
                     link: `/${hostId}/products`
                 });
             }
+            // A store-credit hold that no longer covered what Stripe discounted
+            // (AGL-3640): the buyer kept the discount, the account gave less. Said
+            // once, like a lost line, so the merchant can square it.
+            if (heldCredit && creditShortCents > 0) {
+                console.error('commerce cart order credit short', {
+                    hostId: String(hostId),
+                    orderId: String(object.id),
+                    providerId: heldCredit.providerId,
+                    shortCents: creditShortCents
+                });
+                void notifyHostManagers(String(hostId), {
+                    type: 'content.order',
+                    title: 'Store credit on an order came up short',
+                    body: `Order ${cartOrderLabel} on {site} was discounted ` + `$${(heldCredit.amountCents / 100).toFixed(2)} for ${heldCredit.label}, but the account ` + `had only $${((heldCredit.amountCents - creditShortCents) / 100).toFixed(2)} left when it was paid.`,
+                    link: `/${hostId}/products`
+                });
+            }
+            // The address typed at payment is outside every delivery zone the
+            // store has (AGL-3624): the fee was charged for the postal code the
+            // buyer declared, so the store decides — deliver, or refund.
+            if (cartLocalFulfillment == null ? void 0 : cartLocalFulfillment.outsideZone) {
+                void notifyHostManagers(String(hostId), {
+                    type: 'content.order',
+                    title: `Check the delivery address on order ${cartOrderLabel}`,
+                    body: `Order ${cartOrderLabel} on {site} was booked for local delivery, but the ` + 'address entered at payment is outside your delivery zones. Contact the ' + 'buyer, or refund the delivery.',
+                    link: `/${hostId}/products`
+                });
+            }
             await cartRef.delete().catch(()=>undefined);
             // Recoverable checkout closes (AGL-296) so recovery emails stop;
             // the doc also carries the marketing opt-in (AGL-301).
@@ -3058,7 +3166,7 @@ async function findOrderForDispute(paymentIntentId) {
             // The store's receipt switch and the status link (AGL-3610).
             const receiptExtras = await onlineReceiptExtras(String(hostId), String(object.id));
             if (isEmailConfigured() && buyerEmailForReceipt && receiptExtras.enabled) {
-                var _ref47, _ref48, _ref49, _ref50;
+                var _ref47, _ref48, _ref49, _ref50, _ref51;
                 const receiptSettings = await hostRef.collection('settings').doc('store').get().catch(()=>null);
                 const receiptFooter = String((_ref47 = receiptSettings == null ? void 0 : receiptSettings.get('receiptFooter')) != null ? _ref47 : '');
                 const linesText = lineItems.map((line)=>`${line.quantity}× ${line.name}${line.variantLabel ? ` (${line.variantLabel})` : ''} — $${(line.unitAmountCents * line.quantity / 100).toFixed(2)}`).concat(// Optional lines the buyer took (AGL-3635), as charged.
@@ -3078,12 +3186,15 @@ async function findOrderForDispute(paymentIntentId) {
                 const siteOrigin = String((_ref48 = object == null ? void 0 : object.success_url) != null ? _ref48 : '').replace(/\/\?.*$|\?.*$/, '');
                 const downloadLines = lineItems.filter((line)=>line.productType === 'digital').map((line)=>`Download ${line.name}: ${siteOrigin}/api/commerce/download` + `?hostId=${hostId}&orderId=${object.id}` + `&productId=${line.productId}&token=${downloadToken}`).join('\n');
                 const orderTotal = `$${(Number((_ref49 = object == null ? void 0 : object.amount_total) != null ? _ref49 : 0) / 100).toFixed(2)}`;
+                // Where to collect it, or when it is coming (AGL-3624).
+                const fulfillmentText = (_ref50 = cartLocalFulfillment == null ? void 0 : cartLocalFulfillment.summary) != null ? _ref50 : '';
                 const orderSummary = [
                     linesText,
                     licenseText,
-                    downloadLines
+                    downloadLines,
+                    fulfillmentText
                 ].filter(Boolean).join('\n\n');
-                const fallbackText = `Thanks for your purchase!\n\n${linesText}\n\n` + (licenseText ? `${licenseText}\n\n` : '') + (downloadLines ? `${downloadLines}\n\n` : '') + `Total: ${orderTotal}\n` + `Order reference: ${object.id}` + (receiptFooter ? `\n\n${receiptFooter}` : '');
+                const fallbackText = `Thanks for your purchase!\n\n${linesText}\n\n` + (licenseText ? `${licenseText}\n\n` : '') + (downloadLines ? `${downloadLines}\n\n` : '') + (fulfillmentText ? `${fulfillmentText}\n\n` : '') + `Total: ${orderTotal}\n` + `Order reference: ${object.id}` + (receiptFooter ? `\n\n${receiptFooter}` : '');
                 // Site-owner-designed template when published (AGL-771). The
                 // license keys and download links ride in {{order.summary}}.
                 const designed = await renderHostEmailWithTokens(firebaseAdmin.app().firestore(), String(hostId), 'order-receipt', _extends({
@@ -3097,7 +3208,7 @@ async function findOrderForDispute(paymentIntentId) {
                 }, receiptExtras.tokens));
                 await sendEmail(_extends({
                     to: buyerEmailForReceipt,
-                    subject: (_ref50 = designed == null ? void 0 : designed.subject) != null ? _ref50 : `Receipt for your order`,
+                    subject: (_ref51 = designed == null ? void 0 : designed.subject) != null ? _ref51 : `Receipt for your order`,
                     text: (designed == null ? void 0 : designed.text) || fallbackText
                 }, (designed == null ? void 0 : designed.html) ? {
                     html: designed.html
@@ -3145,7 +3256,10 @@ async function findOrderForDispute(paymentIntentId) {
                     ledger: {
                         reason: 'sale',
                         orderId: String(object.id)
-                    }
+                    },
+                    // Off the pickup location's shelf, or the one deliveries leave
+                    // from (AGL-3624); `order.locationId` says so for a cancellation.
+                    locationId: (cartLocalFulfillment == null ? void 0 : cartLocalFulfillment.fields.locationId) || undefined
                 });
                 if (!moved.before || !moved.after) continue;
                 productsById.set(line.productId, moved.after);
@@ -3204,12 +3318,12 @@ async function findOrderForDispute(paymentIntentId) {
                 }
             }));
             if (couponCode) {
-                var _ref51;
+                var _ref52;
                 var _object_metadata23;
                 await settleRedemption({
                     firestore,
                     ref: hostRef.collection('coupons').doc(String(couponCode)),
-                    holdKey: String((_ref51 = (_object_metadata23 = object.metadata) == null ? void 0 : _object_metadata23.couponHoldKey) != null ? _ref51 : ''),
+                    holdKey: String((_ref52 = (_object_metadata23 = object.metadata) == null ? void 0 : _object_metadata23.couponHoldKey) != null ? _ref52 : ''),
                     orderRef,
                     label: `coupon ${couponCode}`,
                     detail: `Coupon ${couponCode} was applied to this order but no longer ` + 'exists, so the redemption is uncounted against its limit.'
@@ -3217,10 +3331,10 @@ async function findOrderForDispute(paymentIntentId) {
             }
             // Gift card balance settlement (AGL-322, made a settlement by AGL-2449).
             if ((_object_metadata21 = object.metadata) == null ? void 0 : _object_metadata21.giftCardCode) {
-                var _ref52, _ref53;
+                var _ref53, _ref54;
                 var _object_metadata24, _object_metadata25;
-                const giftCardCents = Number((_ref52 = (_object_metadata24 = object.metadata) == null ? void 0 : _object_metadata24.giftCardCents) != null ? _ref52 : 0);
-                const holdKey = String((_ref53 = (_object_metadata25 = object.metadata) == null ? void 0 : _object_metadata25.giftCardHoldKey) != null ? _ref53 : '');
+                const giftCardCents = Number((_ref53 = (_object_metadata24 = object.metadata) == null ? void 0 : _object_metadata24.giftCardCents) != null ? _ref53 : 0);
+                const holdKey = String((_ref54 = (_object_metadata25 = object.metadata) == null ? void 0 : _object_metadata25.giftCardHoldKey) != null ? _ref54 : '');
                 const cardRef = hostRef.collection('giftCards').doc(String(object.metadata.giftCardCode));
                 const orphanNote = `$${(giftCardCents / 100).toFixed(2)} was applied from gift card ` + `${object.metadata.giftCardCode}, which no longer exists. The ` + 'balance was not deducted from any card.';
                 if (!holdKey) {
@@ -3300,7 +3414,7 @@ async function findOrderForDispute(paymentIntentId) {
                 const lineProduct = productsById.get(line.productId);
                 if (!(lineProduct == null ? void 0 : lineProduct.giftCard)) continue;
                 for(let unit = 0; unit < line.quantity; unit += 1){
-                    var _ref54, _ref55;
+                    var _ref55, _ref56;
                     var _object_customer_details12, _object_customer_details13, _object_customer_details14;
                     const code = `GC-${createHmac('sha256', String(object.id)).update(`${line.productId}:${unit}:${Date.now()}`).digest('hex').slice(0, 12).toUpperCase()}`;
                     // THE EMAIL IS GATED ON THE WRITE (AGL-2161). This `.set()` used
@@ -3319,13 +3433,13 @@ async function findOrderForDispute(paymentIntentId) {
                     const issued = await hostRef.collection('giftCards').doc(code).set({
                         initialCents: line.unitAmountCents,
                         balanceCents: line.unitAmountCents,
-                        recipientEmail: (_ref54 = object == null ? void 0 : (_object_customer_details12 = object.customer_details) == null ? void 0 : _object_customer_details12.email) != null ? _ref54 : null,
+                        recipientEmail: (_ref55 = object == null ? void 0 : (_object_customer_details12 = object.customer_details) == null ? void 0 : _object_customer_details12.email) != null ? _ref55 : null,
                         orderId: String(object.id),
                         // Which line bought it, so a refund that withdraws that line
                         // voids this card and no other (AGL-3363).
                         productId: line.productId,
                         // What the console's Gift cards search asks (AGL-3321).
-                        searchTokens: giftCardSearchTokens(code, (_ref55 = object == null ? void 0 : (_object_customer_details13 = object.customer_details) == null ? void 0 : _object_customer_details13.email) != null ? _ref55 : null),
+                        searchTokens: giftCardSearchTokens(code, (_ref56 = object == null ? void 0 : (_object_customer_details13 = object.customer_details) == null ? void 0 : _object_customer_details13.email) != null ? _ref56 : null),
                         createdAtMs: Date.now()
                     }).then(()=>true).catch((error)=>{
                         console.error('Gift card issuance failed', hostId, code, error);
@@ -3353,7 +3467,7 @@ async function findOrderForDispute(paymentIntentId) {
                     }
                     const giftTo = object == null ? void 0 : (_object_customer_details14 = object.customer_details) == null ? void 0 : _object_customer_details14.email;
                     if (giftTo) {
-                        var _ref56;
+                        var _ref57;
                         const giftValue = `$${(line.unitAmountCents / 100).toFixed(2)}`;
                         const fallbackText = `Gift card code: ${code}\n` + `Value: ${giftValue}\n\n` + 'Enter it at checkout to apply the balance.';
                         // Site-owner-designed template when published (AGL-771). A
@@ -3366,7 +3480,7 @@ async function findOrderForDispute(paymentIntentId) {
                         });
                         await sendEmail(_extends({
                             to: giftTo,
-                            subject: (_ref56 = designed == null ? void 0 : designed.subject) != null ? _ref56 : 'Your gift card',
+                            subject: (_ref57 = designed == null ? void 0 : designed.subject) != null ? _ref57 : 'Your gift card',
                             text: (designed == null ? void 0 : designed.text) || fallbackText
                         }, (designed == null ? void 0 : designed.html) ? {
                             html: designed.html
@@ -3387,12 +3501,12 @@ async function findOrderForDispute(paymentIntentId) {
             }
             // Discounts engine redemptions (AGL-305).
             if ((_object_metadata22 = object.metadata) == null ? void 0 : _object_metadata22.discountId) {
-                var _ref57;
+                var _ref58;
                 var _object_metadata26;
                 await settleRedemption({
                     firestore,
                     ref: hostRef.collection('discounts').doc(String(object.metadata.discountId)),
-                    holdKey: String((_ref57 = (_object_metadata26 = object.metadata) == null ? void 0 : _object_metadata26.discountHoldKey) != null ? _ref57 : ''),
+                    holdKey: String((_ref58 = (_object_metadata26 = object.metadata) == null ? void 0 : _object_metadata26.discountHoldKey) != null ? _ref58 : ''),
                     orderRef,
                     label: `discount ${object.metadata.discountId}`,
                     detail: `Discount ${object.metadata.discountId} was applied to this ` + 'order but no longer exists, so the redemption is uncounted ' + 'against its limit.'
@@ -3406,7 +3520,7 @@ async function findOrderForDispute(paymentIntentId) {
         var _object_metadata27;
         const { hostId, orderId, productId } = (_object_metadata27 = object.metadata) != null ? _object_metadata27 : {};
         if (hostId && orderId) {
-            var _ref58, _ref59, _ref60;
+            var _ref59, _ref60, _ref61;
             var _object_total_details, _object_total_details1;
             const firestore = firebaseAdmin.app().firestore();
             const hostRef = firestore.collection('hosts').doc(String(hostId));
@@ -3445,7 +3559,7 @@ async function findOrderForDispute(paymentIntentId) {
             //
             // The whole map is written rather than one field of it, so a
             // `merge`-set's nested-map merge and a plain replace agree.
-            const shippingCents = Math.max(0, Math.round(Number((_ref58 = object == null ? void 0 : (_object_total_details = object.total_details) == null ? void 0 : _object_total_details.amount_shipping) != null ? _ref58 : 0) || 0));
+            const shippingCents = Math.max(0, Math.round(Number((_ref59 = object == null ? void 0 : (_object_total_details = object.total_details) == null ? void 0 : _object_total_details.amount_shipping) != null ? _ref59 : 0) || 0));
             // Tax joins shipping in the fold (AGL-1953). `draft-order.ts` now
             // declares tax — a Stripe Tax Rate for a `manual` store, whose figure
             // it already froze into `totals`, or `automatic_tax` for a `stripe`
@@ -3458,8 +3572,8 @@ async function findOrderForDispute(paymentIntentId) {
             // `amount_tax` 0 here (its own figure stays on the order, and its
             // AGL-1953 witness is metadata, not this field), and a draft composed
             // by a store with no tax reports 0 too.
-            const stripeTaxCents = Math.max(0, Math.round(Number((_ref59 = object == null ? void 0 : (_object_total_details1 = object.total_details) == null ? void 0 : _object_total_details1.amount_tax) != null ? _ref59 : 0) || 0));
-            const chargedTotalCents = Number((_ref60 = object == null ? void 0 : object.amount_total) != null ? _ref60 : NaN);
+            const stripeTaxCents = Math.max(0, Math.round(Number((_ref60 = object == null ? void 0 : (_object_total_details1 = object.total_details) == null ? void 0 : _object_total_details1.amount_tax) != null ? _ref60 : 0) || 0));
+            const chargedTotalCents = Number((_ref61 = object == null ? void 0 : object.amount_total) != null ? _ref61 : NaN);
             // `shipping_details` ONLY, unlike the cart branch's
             // `?? customer_details` fallback: that address is the BILLING one, and
             // a card sale rung up at a register completes here too — it must not
@@ -3578,7 +3692,7 @@ async function findOrderForDispute(paymentIntentId) {
                 });
             }
             if (flipped) {
-                var _ref61, _ref62, _ref63, _ref64, _ref65, _ref66;
+                var _ref62, _ref63, _ref64, _ref65, _ref66, _ref67;
                 var _object_metadata28, _object_customer_details15, _order_totals, _object_customer_details16;
                 const order = paidOrder;
                 // A legacy register QR sale is a register sale completing (AGL-3607).
@@ -3604,20 +3718,20 @@ async function findOrderForDispute(paymentIntentId) {
                 // the hold existed, which Stripe's at-least-once delivery would run
                 // twice. The transition is what makes it once.
                 if ((_object_metadata28 = object.metadata) == null ? void 0 : _object_metadata28.discountId) {
-                    var _ref67;
+                    var _ref68;
                     var _object_metadata29;
                     await settleRedemption({
                         firestore,
                         ref: hostRef.collection('discounts').doc(String(object.metadata.discountId)),
-                        holdKey: String((_ref67 = (_object_metadata29 = object.metadata) == null ? void 0 : _object_metadata29.discountHoldKey) != null ? _ref67 : ''),
+                        holdKey: String((_ref68 = (_object_metadata29 = object.metadata) == null ? void 0 : _object_metadata29.discountHoldKey) != null ? _ref68 : ''),
                         orderRef,
                         label: `discount ${object.metadata.discountId}`,
                         detail: `Discount ${object.metadata.discountId} was applied to this ` + 'order but no longer exists, so the redemption is uncounted ' + 'against its limit.'
                     });
                 }
                 const draftLabel = CommerceModel.formatOrderNumber(order, String(orderId));
-                const draftPayer = (_ref61 = (_ref62 = object == null ? void 0 : (_object_customer_details15 = object.customer_details) == null ? void 0 : _object_customer_details15.email) != null ? _ref62 : order.customerEmail) != null ? _ref61 : null;
-                const draftPaidCents = Number((_ref63 = object == null ? void 0 : object.amount_total) != null ? _ref63 : 0) || Number((_ref64 = (_order_totals = order.totals) == null ? void 0 : _order_totals.totalCents) != null ? _ref64 : 0);
+                const draftPayer = (_ref62 = (_ref63 = object == null ? void 0 : (_object_customer_details15 = object.customer_details) == null ? void 0 : _object_customer_details15.email) != null ? _ref63 : order.customerEmail) != null ? _ref62 : null;
+                const draftPaidCents = Number((_ref64 = object == null ? void 0 : object.amount_total) != null ? _ref64 : 0) || Number((_ref65 = (_order_totals = order.totals) == null ? void 0 : _order_totals.totalCents) != null ? _ref65 : 0);
                 void notifyHostManagers(String(hostId), {
                     type: 'content.order',
                     title: `Draft order paid — ${draftLabel}`,
@@ -3637,17 +3751,17 @@ async function findOrderForDispute(paymentIntentId) {
                 // figure the draft was priced at, and the two agree by construction,
                 // but only one of them is the money that moved. Stored totals remain
                 // the fallback for a session shape that reports no total.
-                const draftEmail = (_ref65 = (_ref66 = object == null ? void 0 : (_object_customer_details16 = object.customer_details) == null ? void 0 : _object_customer_details16.email) != null ? _ref66 : order.customerEmail) != null ? _ref65 : null;
+                const draftEmail = (_ref66 = (_ref67 = object == null ? void 0 : (_object_customer_details16 = object.customer_details) == null ? void 0 : _object_customer_details16.email) != null ? _ref67 : order.customerEmail) != null ? _ref66 : null;
                 if (draftEmail) {
-                    var _ref68, _ref69, _ref70;
+                    var _ref69, _ref70, _ref71;
                     var _order_totals1, _object_customer_details17;
-                    const chargedCents = Number((_ref68 = object == null ? void 0 : object.amount_total) != null ? _ref68 : 0) || Number((_ref69 = (_order_totals1 = order.totals) == null ? void 0 : _order_totals1.totalCents) != null ? _ref69 : 0);
+                    const chargedCents = Number((_ref69 = object == null ? void 0 : object.amount_total) != null ? _ref69 : 0) || Number((_ref70 = (_order_totals1 = order.totals) == null ? void 0 : _order_totals1.totalCents) != null ? _ref70 : 0);
                     await recordCapturedContact(_extends({
                         orgId: '',
                         hostId: String(hostId),
                         identity: {
                             email: draftEmail,
-                            name: (_ref70 = object == null ? void 0 : (_object_customer_details17 = object.customer_details) == null ? void 0 : _object_customer_details17.name) != null ? _ref70 : null
+                            name: (_ref71 = object == null ? void 0 : (_object_customer_details17 = object.customer_details) == null ? void 0 : _object_customer_details17.name) != null ? _ref71 : null
                         },
                         surface: 'relationship',
                         lifecycleFloor: 'customer'
@@ -3674,15 +3788,15 @@ async function findOrderForDispute(paymentIntentId) {
                     key: 'paid'
                 });
                 if (productId) {
-                    var _productSnapshot_data, _ref71, _ref72;
+                    var _productSnapshot_data, _ref72, _ref73;
                     var _object_metadata30, _lifted_variants_, _order_lineItems_, _order_lineItems;
                     const productRef = hostRef.collection('products').doc(String(productId));
                     const productSnapshot = await productRef.get();
                     const lifted = CommerceModel.liftLegacyProduct((_productSnapshot_data = productSnapshot.data()) != null ? _productSnapshot_data : {
                         name: 'Product'
                     });
-                    const soldVariantId = String((_ref71 = (_object_metadata30 = object.metadata) == null ? void 0 : _object_metadata30.variantId) != null ? _ref71 : '') || ((_lifted_variants_ = lifted.variants[0]) == null ? void 0 : _lifted_variants_.id);
-                    const quantity = (_ref72 = (_order_lineItems = order.lineItems) == null ? void 0 : (_order_lineItems_ = _order_lineItems[0]) == null ? void 0 : _order_lineItems_.quantity) != null ? _ref72 : 1;
+                    const soldVariantId = String((_ref72 = (_object_metadata30 = object.metadata) == null ? void 0 : _object_metadata30.variantId) != null ? _ref72 : '') || ((_lifted_variants_ = lifted.variants[0]) == null ? void 0 : _lifted_variants_.id);
+                    const quantity = (_ref73 = (_order_lineItems = order.lineItems) == null ? void 0 : (_order_lineItems_ = _order_lineItems[0]) == null ? void 0 : _order_lineItems_.quantity) != null ? _ref73 : 1;
                     if (soldVariantId) {
                         // Atomic since AGL-2320.
                         const moved = await decrementVariantStock({
@@ -3734,10 +3848,10 @@ async function findOrderForDispute(paymentIntentId) {
                     // would decrement it twice.
                     const paidProducts = new Map();
                     for (const line of (_order_lineItems1 = order.lineItems) != null ? _order_lineItems1 : []){
-                        var _ref73, _ref74, _line_variantId1;
+                        var _ref74, _ref75, _line_variantId1;
                         var _lineProduct_variants_;
-                        const lineProductId = String((_ref73 = line == null ? void 0 : line.productId) != null ? _ref73 : '');
-                        const soldQty = Math.round(Number((_ref74 = line == null ? void 0 : line.quantity) != null ? _ref74 : 0));
+                        const lineProductId = String((_ref74 = line == null ? void 0 : line.productId) != null ? _ref74 : '');
+                        const soldQty = Math.round(Number((_ref75 = line == null ? void 0 : line.quantity) != null ? _ref75 : 0));
                         if (!lineProductId || !(soldQty > 0)) continue;
                         // Firestore reserves `__…__` ids and `.doc()` throws
                         // synchronously on one; a corrupt line must not fail the
@@ -3800,8 +3914,8 @@ async function findOrderForDispute(paymentIntentId) {
         var _object_metadata31;
         const { hostId, productId, feeCents, couponCode } = (_object_metadata31 = object.metadata) != null ? _object_metadata31 : {};
         if (hostId && productId) {
-            var _ref75, _productForSnapshot_get2, _productForSnapshot_data1, _ref76, _ref77, _ref78, _ref79, _ref80, _ref81, _ref82;
-            var _object_metadata32, _buyNowLineItems_, _object_customer_details18, _object_customer_details19, _object_customer_details20, _object_metadata33;
+            var _ref76, _productForSnapshot_get2, _productForSnapshot_data1, _ref77, _ref78, _object_shipping_details_address_postal_code1, _object_shipping_details_address_country1, _ref79, _ref80, _ref81, _ref82, _ref83;
+            var _object_metadata32, _buyNowLineItems_, _object_shipping_details1, _object_customer_details18, _object_customer_details19, _object_customer_details20, _object_metadata33;
             const firestore = firebaseAdmin.app().firestore();
             const hostRef = firestore.collection('hosts').doc(String(hostId));
             // Orders v1 (AGL-283): line-item snapshot + totals + timeline with
@@ -3811,7 +3925,7 @@ async function findOrderForDispute(paymentIntentId) {
             // is bounded to Stripe's at-least-once edge).
             const orderRef = hostRef.collection('orders').doc(String(object.id));
             const counterRef = hostRef.collection('counters').doc('orders');
-            const amountCents = Number((_ref75 = object == null ? void 0 : object.amount_total) != null ? _ref75 : 0);
+            const amountCents = Number((_ref76 = object == null ? void 0 : object.amount_total) != null ? _ref76 : 0);
             const productForSnapshot = await hostRef.collection('products').doc(String(productId)).get();
             const snapshotName = String((_productForSnapshot_get2 = productForSnapshot.get('name')) != null ? _productForSnapshot_get2 : 'Product');
             // AGL-1711: the line item and totals used to be fabricated from
@@ -3824,7 +3938,7 @@ async function findOrderForDispute(paymentIntentId) {
                 name: snapshotName
             });
             const soldVariant = ((_object_metadata32 = object.metadata) == null ? void 0 : _object_metadata32.variantId) ? liftedForSnapshot.variants.find((item)=>item.id === String(object.metadata.variantId)) : liftedForSnapshot.variants[0];
-            const variantOptions = Object.values((_ref76 = soldVariant == null ? void 0 : soldVariant.options) != null ? _ref76 : {});
+            const variantOptions = Object.values((_ref77 = soldVariant == null ? void 0 : soldVariant.options) != null ? _ref77 : {});
             const { lineItems: buyNowLineItems, totals: buyNowTotals } = CommerceModel.computeBuyNowOrder(object, _extends({
                 name: snapshotName
             }, variantOptions.length ? {
@@ -3836,13 +3950,28 @@ async function findOrderForDispute(paymentIntentId) {
             } : {}, liftedForSnapshot.supplierId ? {
                 supplierId: liftedForSnapshot.supplierId
             } : {}));
-            const soldQuantity = (_ref77 = (_buyNowLineItems_ = buyNowLineItems[0]) == null ? void 0 : _buyNowLineItems_.quantity) != null ? _ref77 : 1;
+            const soldQuantity = (_ref78 = (_buyNowLineItems_ = buyNowLineItems[0]) == null ? void 0 : _buyNowLineItems_.quantity) != null ? _ref78 : 1;
             // The number the merchant knows this order by, for the notices below
             // (AGL-3432).
             let buyNowOrderNumber;
+            // Picked up or brought by the store's own driver (AGL-3624), as the
+            // cart branch reads it.
+            const buyNowLocalFulfillment = await orderLocalFulfillmentFromSession({
+                hostId: String(hostId),
+                hostRef,
+                metadata: object == null ? void 0 : object.metadata,
+                shippingAddress: (object == null ? void 0 : (_object_shipping_details1 = object.shipping_details) == null ? void 0 : _object_shipping_details1.address) ? {
+                    postalCode: (_object_shipping_details_address_postal_code1 = object.shipping_details.address.postal_code) != null ? _object_shipping_details_address_postal_code1 : null,
+                    country: (_object_shipping_details_address_country1 = object.shipping_details.address.country) != null ? _object_shipping_details_address_country1 : null
+                } : null,
+                createdAtMs: Date.now()
+            }).catch((error)=>{
+                console.error('commerce buy-now local fulfillment unreadable', String(object.id), error);
+                return null;
+            });
             const created = await firestore.runTransaction(async (transaction)=>{
-                var _counter_get, _ref, _ref1, _ref2, _ref3;
-                var _object_metadata, _object_customer_details, _object_customer_details1;
+                var _counter_get, _ref, _ref1, _ref2, _object_shipping_details_name, _object_shipping_details_address_line1, _object_shipping_details_address_line2, _object_shipping_details_address_city, _object_shipping_details_address_state, _object_shipping_details_address_postal_code, _object_shipping_details_address_country, _ref3, _ref4;
+                var _object_metadata, _object_customer_details, _object_shipping_details, _object_customer_details1;
                 const [existing, counter] = await Promise.all([
                     transaction.get(orderRef),
                     transaction.get(counterRef)
@@ -3880,13 +4009,24 @@ async function findOrderForDispute(paymentIntentId) {
                 }, typeof (event == null ? void 0 : event.livemode) === 'boolean' ? {
                     livemode: event.livemode
                 } : {}, {
-                    customerName: (_ref2 = object == null ? void 0 : (_object_customer_details = object.customer_details) == null ? void 0 : _object_customer_details.name) != null ? _ref2 : null,
+                    customerName: (_ref2 = object == null ? void 0 : (_object_customer_details = object.customer_details) == null ? void 0 : _object_customer_details.name) != null ? _ref2 : null
+                }, (object == null ? void 0 : (_object_shipping_details = object.shipping_details) == null ? void 0 : _object_shipping_details.address) ? {
+                    shippingAddress: {
+                        name: (_object_shipping_details_name = object.shipping_details.name) != null ? _object_shipping_details_name : undefined,
+                        line1: (_object_shipping_details_address_line1 = object.shipping_details.address.line1) != null ? _object_shipping_details_address_line1 : undefined,
+                        line2: (_object_shipping_details_address_line2 = object.shipping_details.address.line2) != null ? _object_shipping_details_address_line2 : undefined,
+                        city: (_object_shipping_details_address_city = object.shipping_details.address.city) != null ? _object_shipping_details_address_city : undefined,
+                        state: (_object_shipping_details_address_state = object.shipping_details.address.state) != null ? _object_shipping_details_address_state : undefined,
+                        postalCode: (_object_shipping_details_address_postal_code = object.shipping_details.address.postal_code) != null ? _object_shipping_details_address_postal_code : undefined,
+                        country: (_object_shipping_details_address_country = object.shipping_details.address.country) != null ? _object_shipping_details_address_country : undefined
+                    }
+                } : {}, (_ref3 = buyNowLocalFulfillment == null ? void 0 : buyNowLocalFulfillment.fields) != null ? _ref3 : {}, {
                     createdAtMs: Date.now(),
                     // Legacy Commerce Starter fields (AGL-90).
                     productId,
                     amountCents,
                     feeCents: Number(feeCents != null ? feeCents : 0),
-                    customerEmail: (_ref3 = object == null ? void 0 : (_object_customer_details1 = object.customer_details) == null ? void 0 : _object_customer_details1.email) != null ? _ref3 : null
+                    customerEmail: (_ref4 = object == null ? void 0 : (_object_customer_details1 = object.customer_details) == null ? void 0 : _object_customer_details1.email) != null ? _ref4 : null
                 }, couponCode ? {
                     couponCode
                 } : {}, {
@@ -3900,10 +4040,18 @@ async function findOrderForDispute(paymentIntentId) {
             const buyNowOrderLabel = CommerceModel.formatOrderNumber({
                 number: buyNowOrderNumber
             }, String(object.id));
+            if (buyNowLocalFulfillment == null ? void 0 : buyNowLocalFulfillment.outsideZone) {
+                void notifyHostManagers(String(hostId), {
+                    type: 'content.order',
+                    title: `Check the delivery address on order ${buyNowOrderLabel}`,
+                    body: `Order ${buyNowOrderLabel} on {site} was booked for local delivery, but the ` + 'address entered at payment is outside your delivery zones. Contact the ' + 'buyer, or refund the delivery.',
+                    link: `/${hostId}/products`
+                });
+            }
             // In-app order notification (wave v6): host managers see sales
             // in the bell, not just the owner's email: what came in, from whom
             // and where (AGL-3432).
-            const buyNowTotal = `$${(Number((_ref78 = object == null ? void 0 : object.amount_total) != null ? _ref78 : 0) / 100).toFixed(2)}`;
+            const buyNowTotal = `$${(Number((_ref79 = object == null ? void 0 : object.amount_total) != null ? _ref79 : 0) / 100).toFixed(2)}`;
             void notifyHostManagers(String(hostId), {
                 type: 'content.order',
                 title: `New order on {site} — ${buyNowTotal}`,
@@ -4052,15 +4200,15 @@ async function findOrderForDispute(paymentIntentId) {
                 hostId: String(hostId),
                 identity: {
                     email: object == null ? void 0 : (_object_customer_details19 = object.customer_details) == null ? void 0 : _object_customer_details19.email,
-                    name: (_ref79 = object == null ? void 0 : (_object_customer_details20 = object.customer_details) == null ? void 0 : _object_customer_details20.name) != null ? _ref79 : null
+                    name: (_ref80 = object == null ? void 0 : (_object_customer_details20 = object.customer_details) == null ? void 0 : _object_customer_details20.name) != null ? _ref80 : null
                 },
                 surface: 'relationship',
                 lifecycleFloor: 'customer',
-                purchaseCents: Number((_ref80 = object == null ? void 0 : object.amount_total) != null ? _ref80 : 0),
+                purchaseCents: Number((_ref81 = object == null ? void 0 : object.amount_total) != null ? _ref81 : 0),
                 interaction: {
                     source: 'order',
                     refId: String(object.id),
-                    summary: `Placed an order ($${(Number((_ref81 = object == null ? void 0 : object.amount_total) != null ? _ref81 : 0) / 100).toFixed(2)})`
+                    summary: `Placed an order ($${(Number((_ref82 = object == null ? void 0 : object.amount_total) != null ? _ref82 : 0) / 100).toFixed(2)})`
                 }
             });
             const productRef = hostRef.collection('products').doc(String(productId));
@@ -4078,12 +4226,12 @@ async function findOrderForDispute(paymentIntentId) {
             // serialize; the snapshot above is still read, for the product NAME on
             // the receipt below, and no longer decides any count.
             {
-                var _productSnapshot_data2, _ref83;
+                var _productSnapshot_data2, _ref84;
                 var _object_metadata34, _lifted_variants_1;
                 const lifted = CommerceModel.liftLegacyProduct((_productSnapshot_data2 = productSnapshot.data()) != null ? _productSnapshot_data2 : {
                     name: 'Product'
                 });
-                const soldVariantId = String((_ref83 = (_object_metadata34 = object.metadata) == null ? void 0 : _object_metadata34.variantId) != null ? _ref83 : '') || ((_lifted_variants_1 = lifted.variants[0]) == null ? void 0 : _lifted_variants_1.id);
+                const soldVariantId = String((_ref84 = (_object_metadata34 = object.metadata) == null ? void 0 : _object_metadata34.variantId) != null ? _ref84 : '') || ((_lifted_variants_1 = lifted.variants[0]) == null ? void 0 : _lifted_variants_1.id);
                 if (soldVariantId) {
                     // AGL-1711: `-1` regardless of how many units were bought, so a
                     // 3-unit buy-now sale decremented stock by one and the difference
@@ -4099,7 +4247,9 @@ async function findOrderForDispute(paymentIntentId) {
                         ledger: {
                             reason: 'sale',
                             orderId: String(object.id)
-                        }
+                        },
+                        // Off the pickup or delivery location's shelf (AGL-3624).
+                        locationId: (buyNowLocalFulfillment == null ? void 0 : buyNowLocalFulfillment.fields.locationId) || undefined
                     });
                     if (moved.before && moved.after) {
                         // Low-stock alert (AGL-281): fires on the crossing sale only,
@@ -4114,14 +4264,14 @@ async function findOrderForDispute(paymentIntentId) {
             // Settlement, the same way round and for the same reason as the cart
             // branch above (AGL-2356): the decrement lands first, then the
             // reservation is dropped.
-            await releaseStockHold(hostRef, String((_ref82 = (_object_metadata33 = object.metadata) == null ? void 0 : _object_metadata33.stockHoldKey) != null ? _ref82 : ''));
+            await releaseStockHold(hostRef, String((_ref83 = (_object_metadata33 = object.metadata) == null ? void 0 : _object_metadata33.stockHoldKey) != null ? _ref83 : ''));
             if (couponCode) {
-                var _ref84;
+                var _ref85;
                 var _object_metadata35;
                 await settleRedemption({
                     firestore,
                     ref: hostRef.collection('coupons').doc(String(couponCode)),
-                    holdKey: String((_ref84 = (_object_metadata35 = object.metadata) == null ? void 0 : _object_metadata35.couponHoldKey) != null ? _ref84 : ''),
+                    holdKey: String((_ref85 = (_object_metadata35 = object.metadata) == null ? void 0 : _object_metadata35.couponHoldKey) != null ? _ref85 : ''),
                     orderRef,
                     label: `coupon ${couponCode}`,
                     detail: `Coupon ${couponCode} was applied to this order but no longer ` + 'exists, so the redemption is uncounted against its limit.'
@@ -4136,22 +4286,23 @@ async function findOrderForDispute(paymentIntentId) {
             // Receipt + seller notification (AGL-96): env-gated like every
             // other outbound email; failures never fail the webhook.
             if (isEmailConfigured()) {
-                var _productSnapshot_get, _ref85;
+                var _productSnapshot_get, _ref86;
                 var _object_customer_details21, _org, _this3;
                 const productName = String((_productSnapshot_get = productSnapshot.get('name')) != null ? _productSnapshot_get : 'your purchase');
-                const amount = (Number((_ref85 = object == null ? void 0 : object.amount_total) != null ? _ref85 : 0) / 100).toFixed(2);
+                const amount = (Number((_ref86 = object == null ? void 0 : object.amount_total) != null ? _ref86 : 0) / 100).toFixed(2);
                 const buyerEmail = object == null ? void 0 : (_object_customer_details21 = object.customer_details) == null ? void 0 : _object_customer_details21.email;
                 const orderTotal = `$${amount}`;
                 // The store's receipt switch and the status link (AGL-3610).
                 const receiptExtras = await onlineReceiptExtras(String(hostId), String(object.id));
                 if (buyerEmail && receiptExtras.enabled) {
-                    var _ref86, _ref87;
+                    var _ref87, _ref88;
                     // The store's own Receipt footer, as the cart receipt carries it
                     // (AGL-3432).
-                    const receiptFooter = String((_ref86 = await hostRef.collection('settings').doc('store').get().then((snapshot)=>snapshot.get('receiptFooter')).catch(()=>'')) != null ? _ref86 : '');
+                    const receiptFooter = String((_ref87 = await hostRef.collection('settings').doc('store').get().then((snapshot)=>snapshot.get('receiptFooter')).catch(()=>'')) != null ? _ref87 : '');
                     // The quantity with the name (AGL-3432), so a three-unit sale
                     // does not read as one item at the whole total.
-                    const receiptLine = `${soldQuantity}× ${productName}`;
+                    const receiptLine = `${soldQuantity}× ${productName}` + // Where to collect it, or when it is coming (AGL-3624).
+                    ((buyNowLocalFulfillment == null ? void 0 : buyNowLocalFulfillment.summary) ? `\n\n${buyNowLocalFulfillment.summary}` : '');
                     const fallbackText = `Thanks for your purchase!\n\n${receiptLine} — $${amount}` + `\nOrder reference: ${object.id}` + (receiptFooter ? `\n\n${receiptFooter}` : '');
                     // Site-owner-designed template when published (AGL-771).
                     const designed = await renderHostEmailWithTokens(firebaseAdmin.app().firestore(), String(hostId), 'order-receipt', _extends({
@@ -4162,7 +4313,7 @@ async function findOrderForDispute(paymentIntentId) {
                     }, receiptExtras.tokens));
                     await sendEmail(_extends({
                         to: String(buyerEmail),
-                        subject: (_ref87 = designed == null ? void 0 : designed.subject) != null ? _ref87 : `Receipt: ${productName}`,
+                        subject: (_ref88 = designed == null ? void 0 : designed.subject) != null ? _ref88 : `Receipt: ${productName}`,
                         text: (designed == null ? void 0 : designed.text) || fallbackText
                     }, (designed == null ? void 0 : designed.html) ? {
                         html: designed.html
@@ -4196,7 +4347,7 @@ async function findOrderForDispute(paymentIntentId) {
                     // SSO.
                     const seller = (_this4 = await findUserByUidAcrossPools(sellerUid).catch(()=>null)) == null ? void 0 : _this4.record;
                     if (seller == null ? void 0 : seller.email) {
-                        var _hostSnapshot_get, _ref88;
+                        var _hostSnapshot_get, _ref89;
                         const siteName = String((_hostSnapshot_get = hostSnapshot.get('displayName')) != null ? _hostSnapshot_get : hostId);
                         const fallbackText = `You made a sale on ${siteName}!\n\n${productName} — $${amount}` + (buyerEmail ? `\nBuyer: ${buyerEmail}` : '') + `\nOrder reference: ${object.id}`;
                         // Site-owner-designed template when published (AGL-771).
@@ -4209,7 +4360,7 @@ async function findOrderForDispute(paymentIntentId) {
                         });
                         await sendEmail(_extends({
                             to: seller.email,
-                            subject: (_ref88 = designed == null ? void 0 : designed.subject) != null ? _ref88 : `New order: ${productName}`,
+                            subject: (_ref89 = designed == null ? void 0 : designed.subject) != null ? _ref89 : `New order: ${productName}`,
                             text: (designed == null ? void 0 : designed.text) || fallbackText
                         }, (designed == null ? void 0 : designed.html) ? {
                             html: designed.html
@@ -4239,28 +4390,28 @@ async function findOrderForDispute(paymentIntentId) {
     // the refund is written on the order's timeline. Nothing else is moved: a
     // Dashboard refund is staff's act, and they chose its transfer reversal.
     if (type === 'charge.refunded') {
-        var _ref89, _ref90;
+        var _ref90, _ref91;
         var _object_payment_intent, _snapshot_ref_parent_parent;
-        const paymentIntentId = typeof (object == null ? void 0 : object.payment_intent) === 'string' ? object.payment_intent : String((_ref89 = object == null ? void 0 : (_object_payment_intent = object.payment_intent) == null ? void 0 : _object_payment_intent.id) != null ? _ref89 : '');
+        const paymentIntentId = typeof (object == null ? void 0 : object.payment_intent) === 'string' ? object.payment_intent : String((_ref90 = object == null ? void 0 : (_object_payment_intent = object.payment_intent) == null ? void 0 : _object_payment_intent.id) != null ? _ref90 : '');
         const lookup = paymentIntentId ? await findOrderForDispute(paymentIntentId) : {
             kind: 'not-ours'
         };
         if (lookup.kind !== 'order') return;
         const snapshot = lookup.snapshot;
-        const hostId = String((_ref90 = (_snapshot_ref_parent_parent = snapshot.ref.parent.parent) == null ? void 0 : _snapshot_ref_parent_parent.id) != null ? _ref90 : '');
+        const hostId = String((_ref91 = (_snapshot_ref_parent_parent = snapshot.ref.parent.parent) == null ? void 0 : _snapshot_ref_parent_parent.id) != null ? _ref91 : '');
         const external = await recordExternalRefund(snapshot.ref, object);
         if (external && hostId) {
-            var _ref91, _ref92, _ref93;
+            var _ref92, _ref93, _ref94;
             var _object_refunds;
             // A Stripe Dashboard refund is a refund to every subscriber too
             // (AGL-3645): accounting books it and the merchant's webhooks hear it,
             // as they do a console refund. Keyed by the charge's refunded total,
             // which the record above only ever advances once per amount.
-            const latestRefund = ((_ref91 = object == null ? void 0 : (_object_refunds = object.refunds) == null ? void 0 : _object_refunds.data) != null ? _ref91 : [])[0];
+            const latestRefund = ((_ref92 = object == null ? void 0 : (_object_refunds = object.refunds) == null ? void 0 : _object_refunds.data) != null ? _ref92 : [])[0];
             await raiseOrderEvent(ORDER_REFUNDED_EVENT, {
                 hostId,
                 orderId: snapshot.id,
-                key: `external-refund:${String((_ref92 = object == null ? void 0 : object.id) != null ? _ref92 : paymentIntentId)}:${Number((_ref93 = object == null ? void 0 : object.amount_refunded) != null ? _ref93 : 0)}`,
+                key: `external-refund:${String((_ref93 = object == null ? void 0 : object.id) != null ? _ref93 : paymentIntentId)}:${Number((_ref94 = object == null ? void 0 : object.amount_refunded) != null ? _ref94 : 0)}`,
                 extra: {
                     refund: {
                         id: (latestRefund == null ? void 0 : latestRefund.id) ? String(latestRefund.id) : null,
@@ -4310,16 +4461,16 @@ async function findOrderForDispute(paymentIntentId) {
     // merchant; both report the site so the seller's fraud ledger can name it.
     const risk = paymentRiskEventFrom(type, object);
     if (risk && risk.signal.kind !== 'dispute') {
-        var _ref94, _snapshot_data1, _ref95, _ref96;
+        var _ref95, _snapshot_data1, _ref96, _ref97;
         var _snapshot_ref_parent_parent1, _order_totals2;
         const lookup = risk.paymentIntentId ? await findOrderForDispute(risk.paymentIntentId) : {
             kind: 'not-ours'
         };
         if (lookup.kind !== 'order') return;
         const snapshot = lookup.snapshot;
-        const hostId = String((_ref94 = (_snapshot_ref_parent_parent1 = snapshot.ref.parent.parent) == null ? void 0 : _snapshot_ref_parent_parent1.id) != null ? _ref94 : '');
+        const hostId = String((_ref95 = (_snapshot_ref_parent_parent1 = snapshot.ref.parent.parent) == null ? void 0 : _snapshot_ref_parent_parent1.id) != null ? _ref95 : '');
         const order = CommerceModel.liftLegacyOrder((_snapshot_data1 = snapshot.data()) != null ? _snapshot_data1 : {});
-        const orderCents = Number((_ref95 = (_ref96 = (_order_totals2 = order.totals) == null ? void 0 : _order_totals2.totalCents) != null ? _ref96 : order.amountCents) != null ? _ref95 : 0);
+        const orderCents = Number((_ref96 = (_ref97 = (_order_totals2 = order.totals) == null ? void 0 : _order_totals2.totalCents) != null ? _ref97 : order.amountCents) != null ? _ref96 : 0);
         await recordPaymentRiskOnRecord({
             ref: snapshot.ref,
             signal: risk.signal,
@@ -4382,7 +4533,7 @@ async function findOrderForDispute(paymentIntentId) {
     // finds). AGL-1554 will add its own `closed` branch for the marketplace
     // side; the two coexist because each self-selects by finding its own record.
     if (type === 'charge.dispute.created' || type === 'charge.dispute.closed') {
-        var _dispute_payment_intent, _ref97;
+        var _dispute_payment_intent, _ref98;
         var _snapshot_ref_parent_parent2;
         const dispute = object != null ? object : {};
         const paymentIntentId = String((_dispute_payment_intent = dispute.payment_intent) != null ? _dispute_payment_intent : '');
@@ -4408,9 +4559,9 @@ async function findOrderForDispute(paymentIntentId) {
         const claimed = lookup.kind === 'order' || lookup.kind === 'unresolved';
         const snapshot = lookup.kind === 'order' ? lookup.snapshot : null;
         if (snapshot) {
-            var _ref98;
+            var _ref99;
             var _snapshot_ref_parent_parent3;
-            const hostId = String((_ref98 = (_snapshot_ref_parent_parent3 = snapshot.ref.parent.parent) == null ? void 0 : _snapshot_ref_parent_parent3.id) != null ? _ref98 : '');
+            const hostId = String((_ref99 = (_snapshot_ref_parent_parent3 = snapshot.ref.parent.parent) == null ? void 0 : _snapshot_ref_parent_parent3.id) != null ? _ref99 : '');
             if (type === 'charge.dispute.created') {
                 var _snapshot_data2;
                 // A chargeback's gift cards are frozen while it is open (AGL-3363).
@@ -4428,7 +4579,7 @@ async function findOrderForDispute(paymentIntentId) {
                 }, notifyRiskEvent);
                 const { opened, record } = await recordDisputeOpened(snapshot, dispute);
                 if (opened && hostId) {
-                    var _snapshot_data3, _record_evidenceDueByMs, _ref99;
+                    var _snapshot_data3, _record_evidenceDueByMs, _ref100;
                     // Time-critical — Stripe's evidence window is days, not weeks — so
                     // this is awaited rather than fired off with `void`: the handler is
                     // serverless and work left running past the response is work the
@@ -4447,16 +4598,16 @@ async function findOrderForDispute(paymentIntentId) {
                         },
                         amount: `$${(record.amountCents / 100).toFixed(2)}`,
                         evidenceDueByMs: (_record_evidenceDueByMs = record.evidenceDueByMs) != null ? _record_evidenceDueByMs : null,
-                        dedupeKey: `sale:${String((_ref99 = dispute == null ? void 0 : dispute.id) != null ? _ref99 : snapshot.id)}`,
+                        dedupeKey: `sale:${String((_ref100 = dispute == null ? void 0 : dispute.id) != null ? _ref100 : snapshot.id)}`,
                         staffEvidence: record.reason ? `Reason: ${record.reason.replace(/_/g, ' ')}.` : null
                     });
                 }
             } else {
-                var _ref100, _snapshot_data4, _ref101;
+                var _ref101, _snapshot_data4, _ref102;
                 // Lost: the money went back, so the cards it bought are voided. Won
                 // (or closed on a warning): the dispute's freeze lifts; a freeze a
                 // fraud warning or review put on stays for the merchant (AGL-3363).
-                await applyOrderGiftCardRisk(snapshot, String((_ref100 = dispute == null ? void 0 : dispute.status) != null ? _ref100 : '') === 'lost' ? {
+                await applyOrderGiftCardRisk(snapshot, String((_ref101 = dispute == null ? void 0 : dispute.status) != null ? _ref101 : '') === 'lost' ? {
                     kind: 'void',
                     reason: 'dispute-lost'
                 } : {
@@ -4527,7 +4678,7 @@ async function findOrderForDispute(paymentIntentId) {
                 // transiently-failed reversal gets its retry — and gated inside on
                 // the order's own `reversedTransferCents` marker, so it runs at most
                 // once per dispute however many times Stripe delivers.
-                if (String((_ref101 = dispute == null ? void 0 : dispute.status) != null ? _ref101 : '') === 'lost') {
+                if (String((_ref102 = dispute == null ? void 0 : dispute.status) != null ? _ref102 : '') === 'lost') {
                     const pulledBackCents = await reverseSellerShare(snapshot.ref, dispute);
                     // The merchant-experience half of the AGL-1794 decision, and not an
                     // optional extra: the reversal takes money out of the connected
@@ -4557,7 +4708,7 @@ async function findOrderForDispute(paymentIntentId) {
         return _extends({
             claimed
         }, snapshot ? {
-            hostId: String((_ref97 = (_snapshot_ref_parent_parent2 = snapshot.ref.parent.parent) == null ? void 0 : _snapshot_ref_parent_parent2.id) != null ? _ref97 : '')
+            hostId: String((_ref98 = (_snapshot_ref_parent_parent2 = snapshot.ref.parent.parent) == null ? void 0 : _snapshot_ref_parent_parent2.id) != null ? _ref98 : '')
         } : {});
     }
 };